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,71 @@
+import { prisma } from "@planarchy/db";
+
+type PrismaClient = typeof prisma;
+
+/**
+ * Resolve recipient user IDs for a broadcast target.
+ * Deduplicates results and optionally excludes the sender.
+ */
+export async function resolveRecipients(
+  targetType: string,
+  targetValue: string | null | undefined,
+  db: PrismaClient,
+  excludeUserId?: string,
+): Promise<string[]> {
+  let userIds: string[] = [];
+
+  switch (targetType) {
+    case "user":
+      if (targetValue) userIds = [targetValue];
+      break;
+
+    case "role": {
+      // Find all users with the given systemRole
+      const roleUsers = await db.user.findMany({
+        where: { systemRole: targetValue as "ADMIN" | "MANAGER" | "CONTROLLER" | "USER" | "VIEWER" },
+        select: { id: true },
+      });
+      userIds = roleUsers.map((u) => u.id);
+      break;
+    }
+
+    case "project": {
+      // Find all resources with assignments on this project, then their linked users
+      if (!targetValue) break;
+      const assignments = await db.assignment.findMany({
+        where: { projectId: targetValue, status: { not: "CANCELLED" } },
+        select: { resource: { select: { userId: true } } },
+      });
+      userIds = assignments
+        .map((a) => a.resource.userId)
+        .filter((id): id is string => !!id);
+      break;
+    }
+
+    case "orgUnit": {
+      // Find all resources in this orgUnit, then their linked users
+      if (!targetValue) break;
+      const resources = await db.resource.findMany({
+        where: { orgUnitId: targetValue, isActive: true },
+        select: { userId: true },
+      });
+      userIds = resources
+        .map((r) => r.userId)
+        .filter((id): id is string => !!id);
+      break;
+    }
+
+    case "all": {
+      // User model has no isActive — get all users
+      const allUsers = await db.user.findMany({
+        select: { id: true },
+      });
+      userIds = allUsers.map((u) => u.id);
+      break;
+    }
+  }
+
+  // Deduplicate and exclude sender
+  const unique = [...new Set(userIds)];
+  return excludeUserId ? unique.filter((id) => id !== excludeUserId) : unique;
+}