feat: Sprint 4 — scenario planner, report builder, comments, dashboard widgets

What-If Scenario Planner (G5): - New /projects/[id]/scenario page with side-by-side baseline vs scenario - simulate mutation: pure cost/hours/headcount/utilization computation - apply mutation: creates real PROPOSED assignments from scenario - Impact cards: cost delta, hours delta, headcount, skill coverage % - Per-resource utilization impact table with over-allocation warnings - "What-If" button added to project detail page Custom Report Builder (G7): - New /reports/builder page with full config panel - Entity selector (resource/project/assignment), column picker, filter builder - Dynamic Prisma query with eq/neq/gt/lt/contains/in operators - Sortable results table with pagination (50/page) - CSV export via exportReport mutation - Sidebar nav link under Analytics Collaboration Layer (G8): - Comment model in Prisma (entityType/entityId, replies, @mentions, resolved) - comment router: list, count, create, resolve, delete - @mention parsing with notification creation + SSE delivery - CommentInput with @mention autocomplete (arrow nav, Enter/Tab confirm) - CommentThread with avatar, timestamp, reply, resolve, delete - Integrated as "Comments" tab in estimate workspace with count badge Dashboard Widgets: - BudgetForecastWidget: progress bars per project, burn rate, exhaustion date - SkillGapWidget: supply vs demand per skill, shortage/surplus indicators - ProjectHealthWidget: 3-dimension health circles + composite score - 3 new application use-cases + dashboard router queries - All registered in widget-registry with lazy imports Co-Authored-By: claude-flow <ruv@ruv.net>
2026-03-19 21:47:47 +01:00
parent 6f34659587
commit e1368c7ef7
27 changed files with 3889 additions and 1 deletions
@@ -0,0 +1,89 @@
+import type { PrismaClient } from "@planarchy/db";
+
+export interface SkillGapRow {
+  skill: string;
+  demand: number;
+  supply: number;
+  gap: number;
+}
+
+interface SkillEntry {
+  name: string;
+  level?: number;
+}
+
+export async function getDashboardSkillGaps(
+  db: PrismaClient,
+): Promise<SkillGapRow[]> {
+  // Count open demand requirements grouped by required skill (from role name)
+  const openDemands = await db.demandRequirement.findMany({
+    where: {
+      status: { in: ["PROPOSED", "CONFIRMED"] },
+      project: { status: "ACTIVE" },
+    },
+    select: {
+      role: true,
+      roleId: true,
+      roleEntity: { select: { name: true } },
+      headcount: true,
+      metadata: true,
+    },
+  });
+
+  // Build demand map by skill/role name
+  const demandMap = new Map<string, number>();
+
+  for (const d of openDemands) {
+    // Try to extract required skills from metadata
+    const meta = d.metadata as Record<string, unknown> | null;
+    const requiredSkills = Array.isArray(meta?.requiredSkills)
+      ? (meta.requiredSkills as string[])
+      : [];
+
+    if (requiredSkills.length > 0) {
+      for (const skill of requiredSkills) {
+        const normalized = skill.trim();
+        if (normalized) {
+          demandMap.set(normalized, (demandMap.get(normalized) ?? 0) + d.headcount);
+        }
+      }
+    } else {
+      // Fall back to role name as the "skill"
+      const roleName = d.roleEntity?.name ?? d.role;
+      if (roleName) {
+        demandMap.set(roleName, (demandMap.get(roleName) ?? 0) + d.headcount);
+      }
+    }
+  }
+
+  if (demandMap.size === 0) return [];
+
+  // Count active resources with each skill at proficiency >= 3
+  const resources = await db.resource.findMany({
+    where: { isActive: true },
+    select: { skills: true },
+  });
+
+  const supplyMap = new Map<string, number>();
+  for (const r of resources) {
+    const skills = (r.skills ?? []) as unknown as SkillEntry[];
+    if (!Array.isArray(skills)) continue;
+    for (const skill of skills) {
+      if (!skill.name) continue;
+      if ((skill.level ?? 0) >= 3) {
+        supplyMap.set(skill.name, (supplyMap.get(skill.name) ?? 0) + 1);
+      }
+    }
+  }
+
+  // Build gap rows for demanded skills
+  const rows: SkillGapRow[] = [];
+  for (const [skill, demand] of demandMap) {
+    const supply = supplyMap.get(skill) ?? 0;
+    rows.push({ skill, demand, supply, gap: supply - demand });
+  }
+
+  // Sort by largest shortage first (most negative gap), take top 10
+  rows.sort((a, b) => a.gap - b.gap);
+  return rows.slice(0, 10);
+}