feat(platform): checkpoint current implementation state

2026-04-01 07:42:03 +02:00
parent 3e53471f05
commit 8c5be51251
125 changed files with 10269 additions and 17808 deletions
@@ -0,0 +1,134 @@
+import { z } from "zod";
+import {
+  reportEntitySchema,
+  ReportTemplateConfigSchema,
+  type EntityKey,
+} from "./report-query-config.js";
+
+export const ReportBlueprintSummarySchema = z.object({
+  id: z.string().min(1),
+  label: z.string().min(1),
+  description: z.string().min(1),
+  entity: reportEntitySchema,
+  templateName: z.string().min(1),
+  config: ReportTemplateConfigSchema,
+});
+
+export const ReportBlueprintCatalogSchema = z.array(ReportBlueprintSummarySchema);
+
+export type ReportBlueprintSummary = z.infer<typeof ReportBlueprintSummarySchema>;
+
+const REPORT_BLUEPRINTS = ReportBlueprintCatalogSchema.parse([
+  {
+    id: "resource-month-sah-transparency",
+    label: "SAH transparency",
+    description: "Explains how monthly SAH is reduced by holidays and absences per person.",
+    entity: "resource_month",
+    templateName: "Monthly SAH transparency",
+    config: {
+      entity: "resource_month",
+      columns: [
+        "monthKey",
+        "displayName",
+        "eid",
+        "chapter",
+        "countryName",
+        "federalState",
+        "metroCityName",
+        "orgUnitName",
+        "managementLevelGroupName",
+        "monthlyBaseWorkingDays",
+        "monthlyEffectiveWorkingDays",
+        "monthlyBaseAvailableHours",
+        "monthlyPublicHolidayCount",
+        "monthlyPublicHolidayWorkdayCount",
+        "monthlyPublicHolidayHoursDeduction",
+        "monthlyAbsenceDayEquivalent",
+        "monthlyAbsenceHoursDeduction",
+        "monthlySahHours",
+        "monthlyChargeabilityTargetPct",
+        "monthlyTargetHours",
+      ],
+      filters: [],
+      sortBy: "displayName",
+      sortDir: "asc",
+    },
+  },
+  {
+    id: "resource-month-chargeability-audit",
+    label: "Chargeability audit",
+    description: "Shows the full path from monthly SAH to booked, target and unassigned hours.",
+    entity: "resource_month",
+    templateName: "Monthly chargeability audit",
+    config: {
+      entity: "resource_month",
+      columns: [
+        "monthKey",
+        "displayName",
+        "eid",
+        "chapter",
+        "countryName",
+        "federalState",
+        "metroCityName",
+        "orgUnitName",
+        "managementLevelGroupName",
+        "monthlyBaseAvailableHours",
+        "monthlyPublicHolidayCount",
+        "monthlyPublicHolidayHoursDeduction",
+        "monthlyAbsenceDayEquivalent",
+        "monthlyAbsenceHoursDeduction",
+        "monthlySahHours",
+        "monthlyChargeabilityTargetPct",
+        "monthlyTargetHours",
+        "monthlyActualBookedHours",
+        "monthlyExpectedBookedHours",
+        "monthlyActualChargeabilityPct",
+        "monthlyExpectedChargeabilityPct",
+        "monthlyUnassignedHours",
+        "lcrCents",
+        "currency",
+      ],
+      filters: [],
+      sortBy: "monthlyActualChargeabilityPct",
+      sortDir: "desc",
+    },
+  },
+  {
+    id: "resource-month-location-comparison",
+    label: "Location comparison",
+    description: "Compares holiday impact across country, state and city contexts for the same month.",
+    entity: "resource_month",
+    templateName: "Monthly holiday comparison by location",
+    config: {
+      entity: "resource_month",
+      columns: [
+        "monthKey",
+        "displayName",
+        "chapter",
+        "countryName",
+        "federalState",
+        "metroCityName",
+        "orgUnitName",
+        "monthlyBaseWorkingDays",
+        "monthlyBaseAvailableHours",
+        "monthlyPublicHolidayCount",
+        "monthlyPublicHolidayWorkdayCount",
+        "monthlyPublicHolidayHoursDeduction",
+        "monthlyAbsenceDayEquivalent",
+        "monthlyAbsenceHoursDeduction",
+        "monthlySahHours",
+        "monthlyActualChargeabilityPct",
+      ],
+      filters: [],
+      groupBy: "federalState",
+      sortBy: "monthlyPublicHolidayHoursDeduction",
+      sortDir: "desc",
+    },
+  },
+]);
+
+export function listReportBlueprints(entity?: EntityKey): ReportBlueprintSummary[] {
+  return entity
+    ? REPORT_BLUEPRINTS.filter((blueprint) => blueprint.entity === entity)
+    : REPORT_BLUEPRINTS;
+}