feat: enterprise notification & task management system

Phase N.1 — Data Model: - Extend Notification model with category, priority, task fields (status, action, assignee, dueDate, completedAt/By), reminder fields (remindAt, recurrence, nextRemindAt), and targeting metadata (sourceId, senderId, channel) - Add NotificationCategory, NotificationPriority, TaskStatus enums - Add NotificationBroadcast model for group notifications - Shared types with parseTaskAction()/buildTaskAction() helpers Phase N.2 — API: - Extend notification router: listTasks, taskCounts, updateTaskStatus, createReminder/update/delete/list, createBroadcast/listBroadcasts, createTask, assignTask, delete - Broadcast targeting: resolve recipients by user/role/project/orgUnit/all - Task-action registry: approve_vacation, reject_vacation, confirm_assignment - Reminder scheduler: 60s poll interval, recurring support, catch-up on start - SSE events: TASK_ASSIGNED, TASK_COMPLETED, TASK_STATUS_CHANGED, REMINDER_DUE, BROADCAST_SENT Phase N.3 — AI Assistant: - 7 new tools: list_tasks, get_task_detail, update_task_status, execute_task_action, create_reminder, create_task_for_user, send_broadcast - execute_task_action dispatches to task-action registry with per-action permission checks, marks tasks as completed by AI Phase N.4 — Frontend: - Enhanced NotificationBell with task badge, tabs (All/Tasks/Reminders) - TaskCard component with priority badges, due dates, action buttons - ReminderModal for creating/editing personal reminders - BroadcastModal for targeted group notifications (manager+) - NotificationCenter full-page with 5 tabs and bulk actions - TaskWidget dashboard widget showing open tasks - Admin broadcast management page - AppShell nav links for Notifications and Broadcasts - SSE hook handlers for task/reminder events Phase N.5 — Auto-Tasks: - Vacation create → APPROVAL tasks for all managers - Vacation approve/reject → mark approval tasks as DONE - Demand create → TASK for managers to fill staffing needs Co-Authored-By: claude-flow <ruv@ruv.net>
2026-03-18 11:51:49 +01:00
parent 093e13b88f
commit d0f04f13f8
26 changed files with 3404 additions and 54 deletions
@@ -0,0 +1,77 @@
+import { prisma } from "@planarchy/db";
+
+type PrismaClient = typeof prisma;
+
+export interface TaskActionResult {
+  success: boolean;
+  message: string;
+}
+
+export interface TaskActionHandler {
+  /** PermissionKey string value required to execute this action */
+  permission: string;
+  execute: (entityId: string, db: PrismaClient, executorId: string) => Promise<TaskActionResult>;
+}
+
+export const TASK_ACTION_REGISTRY: Record<string, TaskActionHandler> = {
+  approve_vacation: {
+    permission: "approveVacations",
+    execute: async (vacationId, db, _executorId) => {
+      const vacation = await db.vacation.findUnique({
+        where: { id: vacationId },
+        select: { id: true, status: true },
+      });
+      if (!vacation) return { success: false, message: "Vacation not found" };
+      if (vacation.status !== "PENDING") {
+        return { success: false, message: `Vacation is ${vacation.status}, not PENDING` };
+      }
+      await db.vacation.update({
+        where: { id: vacationId },
+        data: { status: "APPROVED" },
+      });
+      return { success: true, message: "Vacation approved" };
+    },
+  },
+
+  reject_vacation: {
+    permission: "approveVacations",
+    execute: async (vacationId, db, _executorId) => {
+      const vacation = await db.vacation.findUnique({
+        where: { id: vacationId },
+        select: { id: true, status: true },
+      });
+      if (!vacation) return { success: false, message: "Vacation not found" };
+      if (vacation.status !== "PENDING") {
+        return { success: false, message: `Vacation is ${vacation.status}, not PENDING` };
+      }
+      await db.vacation.update({
+        where: { id: vacationId },
+        data: { status: "REJECTED" },
+      });
+      return { success: true, message: "Vacation rejected" };
+    },
+  },
+
+  confirm_assignment: {
+    permission: "manageAllocations",
+    execute: async (assignmentId, db, _executorId) => {
+      const assignment = await db.assignment.findUnique({
+        where: { id: assignmentId },
+        select: { id: true, status: true },
+      });
+      if (!assignment) return { success: false, message: "Assignment not found" };
+      if (assignment.status === "CONFIRMED") {
+        return { success: false, message: "Assignment is already CONFIRMED" };
+      }
+      await db.assignment.update({
+        where: { id: assignmentId },
+        data: { status: "CONFIRMED" },
+      });
+      return { success: true, message: "Assignment confirmed" };
+    },
+  },
+};
+
+export function getTaskAction(actionName: string): TaskActionHandler | undefined {
+  return TASK_ACTION_REGISTRY[actionName];
+}