new commits

Signed-off-by: Kenneth Obsequio <k80308392@gmail.com>

data/notifications.data.js

@@ -20,9 +20,10 @@
  *
  * Current types:
  *   Admin  : task_overdue, user_registration, nogrp_user_registered
- *   User   : user_task_overdue, achievement, course_unlocked,
+ *   User   : task_requirements_updated, user_task_overdue, achievement, course_unlocked,
  *            course_completed, certificate_issued, task_reminder, announcement,
  *            nogrp_welcome, tier_expired
+ *   Both   : broadcast (admin-composed, sent via notification_broadcasts CRUD)
  *
  * Author: Kenneth Obsequio (@lash0000)
  * Date Created: Jun. 19, 2026
@@ -87,6 +88,20 @@ const NOTIFICATION_REGISTRY = {
     // ─────────────────────────────────────────────────────────────────────────
 
     // ── Task ──────────────────────────────────────────────────────────────────
+    task_requirements_updated: {
+        type:    'task',
+        scope:   'user',
+        trigger: 'event',
+        build({ taskName, taskListId = null, groupId = null }) {
+            return {
+                type:    'task',
+                title:   'Task Updated',
+                message: `The requirements for "${taskName}" have been updated by your administrator.`,
+                data:    { taskName, taskListId, groupId },
+            };
+        },
+    },
+
     user_task_overdue: {
         type:    'task',
         scope:   'user',
@@ -106,12 +121,12 @@ const NOTIFICATION_REGISTRY = {
         type:    'task',
         scope:   'user',
         trigger: 'cron',
-        build({ taskName, deadline }) {
+        build({ taskName, deadline, taskListId = null, groupId = null }) {
             return {
                 type:    'task',
                 title:   'Task Deadline Approaching',
                 message: `"${taskName}" is due on ${fmtDate(deadline)}.`,
-                data:    { taskName, deadline },
+                data:    { taskName, deadline, taskListId, groupId },
             };
         },
     },
@@ -136,12 +151,12 @@ const NOTIFICATION_REGISTRY = {
         type:    'course',
         scope:   'user',
         trigger: 'event',
-        build({ courseTitle }) {
+        build({ courseTitle, courseUuid = null }) {
             return {
                 type:    'course',
                 title:   'New Course Available',
                 message: `"${courseTitle}" has been added to your learning library.`,
-                data:    { courseTitle },
+                data:    { courseTitle, courseUuid },
             };
         },
     },
@@ -150,12 +165,12 @@ const NOTIFICATION_REGISTRY = {
         type:    'course',
         scope:   'user',
         trigger: 'event',
-        build({ courseTitle }) {
+        build({ courseTitle, courseUuid = null }) {
             return {
                 type:    'course',
                 title:   'Course Completed',
                 message: `Great job! You've completed "${courseTitle}". Your certificate will be issued within the next hour.`,
-                data:    { courseTitle },
+                data:    { courseTitle, courseUuid },
             };
         },
     },
@@ -179,7 +194,7 @@ const NOTIFICATION_REGISTRY = {
         type:    'announcement',
         scope:   'user',
         trigger: 'event',
-        build({ groupName, groupCode, accType }) {
+        build({ groupName, groupCode, accType, groupId = null }) {
             const greeting = accType === 'admin'
                 ? 'Welcome, Administrator!'
                 : accType === 'staff'
@@ -189,7 +204,7 @@ const NOTIFICATION_REGISTRY = {
                 type:    'announcement',
                 title:   'Welcome to Philproperties',
                 message: groupName ? `${greeting} You have been added to ${groupName}.` : greeting,
-                data:    { groupName, groupCode, accType },
+                data:    { groupName, groupCode, accType, groupId },
             };
         },
     },
@@ -214,12 +229,12 @@ const NOTIFICATION_REGISTRY = {
         type:    'assessment',
         scope:   'user',
         trigger: 'event',
-        build({ assessmentTitle, courseTitle }) {
+        build({ assessmentTitle, courseTitle, courseUuid = null }) {
             return {
                 type:    'assessment',
                 title:   'Assessment Updated',
                 message: `The administrator has updated the "${assessmentTitle || 'Course Assessment'}" in "${courseTitle || 'your course'}". Your current session is still valid — continue where you left off.`,
-                data:    { assessmentTitle, courseTitle },
+                data:    { assessmentTitle, courseTitle, courseUuid },
             };
         },
     },
@@ -239,17 +254,32 @@ const NOTIFICATION_REGISTRY = {
         },
     },
 
+    // ── Broadcast (admin-composed, manual) ───────────────────────────────────
+    broadcast: {
+        type:    'announcement',
+        scope:   'both',
+        trigger: 'manual',
+        build({ title, message, targetType = null, targetId = null, groupId = null }) {
+            return {
+                type:    'announcement',
+                title,
+                message,
+                data:    { targetType, targetId, groupId },
+            };
+        },
+    },
+
     // ── Tier ──────────────────────────────────────────────────────────────────
     tier_expired: {
         type:    'tier_expired',
         scope:   'user',
         trigger: 'cron',
-        build({ tier, label }) {
+        build({ tier, label, planId = null }) {
             return {
                 type:    'tier_expired',
                 title:   'Subscription Expired',
                 message: `Your ${label ?? tier} plan has expired. Renew to keep access.`,
-                data:    { tier, label },
+                data:    { tier, label, planId },
             };
         },
     },