refactor(api): split dashboard detail shaping

packages/api/src/router/dashboard-procedure-support.ts

@@ -15,6 +15,11 @@ import { anonymizeResources, getAnonymizationDirectory } from "../lib/anonymizat
 import { cacheGet, cacheSet } from "../lib/cache.js";
 import { fmtEur } from "../lib/format-utils.js";
 import type { TRPCContext } from "../trpc.js";
+import {
+  type DashboardBudgetForecastDetail,
+  mapBudgetForecastDetailRows,
+  mapProjectHealthDetailRows,
+} from "./dashboard-detail-support.js";
 
 const DEFAULT_TTL = 60;
 
@@ -28,6 +33,7 @@ type TopValueResourceRow = {
   valueScore: number | null;
   lcrCents: number;
   countryCode: string | null;
+  countryName: string | null;
   federalState: string | null;
   metroCityName: string | null;
 };
@@ -67,123 +73,10 @@ type DashboardDemandInput = z.infer<typeof dashboardDemandInputSchema>;
 type DashboardDetailInput = z.infer<typeof dashboardDetailInputSchema>;
 type DashboardChargeabilityOverviewInput = z.infer<typeof dashboardChargeabilityOverviewInputSchema>;
 
-type DashboardBudgetForecastCalendarLocation = {
-  countryCode: string | null;
-  countryName: string | null;
-  federalState: string | null;
-  metroCityName: string | null;
-  activeAssignmentCount: number;
-  burnRateCents: number;
-};
-
-type DashboardBudgetForecastDerivation = {
-  periodStart: string;
-  periodEnd: string;
-  calendarContextCount: number;
-  holidayAwareAssignmentCount: number;
-  fallbackAssignmentCount: number;
-  baseBurnRateCents: number;
-  adjustedBurnRateCents: number;
-  publicHolidayDayEquivalent: number;
-  publicHolidayCostDeductionCents: number;
-  absenceDayEquivalent: number;
-  absenceCostDeductionCents: number;
-};
-
-type DashboardBudgetForecastDetail = {
-  forecasts: Array<{
-    projectId: string | null;
-    projectName: string;
-    shortCode: string;
-    clientId: string | null;
-    clientName: string | null;
-    budget: string;
-    budgetCents: number;
-    spent: string;
-    spentCents: number;
-    remaining: string;
-    remainingCents: number;
-    projected: string;
-    projectedCents: number;
-    burnRate: string;
-    burnRateCents: number;
-    utilization: string;
-    estimatedExhaustionDate: string | null;
-    activeAssignmentCount: number | null;
-    calendarLocations: DashboardBudgetForecastCalendarLocation[];
-    derivation: DashboardBudgetForecastDerivation | null;
-    burnStatus: "ahead" | "on_track" | "not_started";
-  }>;
-};
-
 function round1(value: number): number {
   return Math.round(value * 10) / 10;
 }
 
-function mapProjectHealthDetailRows(rows: Awaited<ReturnType<typeof getDashboardProjectHealth>>) {
-  const projects = rows
-    .map((project) => {
-      const overall = project.compositeScore;
-      return {
-        projectId: project.id,
-        projectName: project.projectName,
-        shortCode: project.shortCode,
-        status: project.status,
-        overall,
-        budget: project.budgetHealth,
-        staffing: project.staffingHealth,
-        timeline: project.timelineHealth,
-        rating: overall >= 80 ? "healthy" : overall >= 50 ? "at_risk" : "critical",
-      };
-    })
-    .sort((left, right) => left.overall - right.overall);
-
-  return {
-    projects,
-    summary: {
-      healthy: projects.filter((project) => project.rating === "healthy").length,
-      atRisk: projects.filter((project) => project.rating === "at_risk").length,
-      critical: projects.filter((project) => project.rating === "critical").length,
-    },
-  };
-}
-
-function mapBudgetForecastDetailRows(rows: BudgetForecastRow[]): DashboardBudgetForecastDetail {
-  return {
-    forecasts: rows.map((forecast) => ({
-      projectId: forecast.projectId ?? null,
-      projectName: forecast.projectName,
-      shortCode: forecast.shortCode,
-      clientId: forecast.clientId,
-      clientName: forecast.clientName,
-      budget: fmtEur(forecast.budgetCents),
-      budgetCents: forecast.budgetCents,
-      spent: fmtEur(forecast.spentCents),
-      spentCents: forecast.spentCents,
-      remaining: fmtEur(forecast.remainingCents ?? (forecast.budgetCents - forecast.spentCents)),
-      remainingCents: forecast.remainingCents ?? (forecast.budgetCents - forecast.spentCents),
-      projected: forecast.burnRate > 0
-        ? fmtEur(forecast.spentCents + Math.max(0, forecast.budgetCents - forecast.spentCents))
-        : fmtEur(forecast.spentCents),
-      projectedCents: forecast.burnRate > 0
-        ? Math.max(forecast.spentCents, forecast.budgetCents)
-        : forecast.spentCents,
-      burnRate: fmtEur(forecast.burnRate),
-      burnRateCents: forecast.burnRate,
-      utilization: `${forecast.pctUsed}%`,
-      estimatedExhaustionDate: forecast.estimatedExhaustionDate,
-      activeAssignmentCount: forecast.activeAssignmentCount ?? null,
-      calendarLocations: forecast.calendarLocations ?? [],
-      derivation: forecast.derivation ?? null,
-      burnStatus: forecast.pctUsed >= 100
-        ? "ahead"
-        : forecast.burnRate > 0
-          ? "on_track"
-          : "not_started",
-    })),
-  };
-}
-
 function mapStatisticsDetail(overview: Awaited<ReturnType<typeof getDashboardOverview>>) {
   return {
     activeResources: overview.activeResources,
@@ -357,6 +250,7 @@ export async function getDashboardDetail(ctx: DashboardProcedureContext, input:
       lcr: fmtEur(resource.lcrCents),
       valueScore: resource.valueScore ?? null,
       countryCode: resource.countryCode ?? null,
+      countryName: resource.countryName ?? null,
       federalState: resource.federalState ?? null,
       metroCityName: resource.metroCityName ?? null,
     }));