chore(repo): checkpoint current capakraken implementation state
This commit is contained in:
@@ -1,11 +1,11 @@
|
||||
# Dispo Import Implementation
|
||||
|
||||
**Date:** 2026-03-14
|
||||
**Purpose:** Canonical implementation document for replacing the current Planarchy planning dataset with a clean-slate import from the Dispo v2 Excel workbooks.
|
||||
**Purpose:** Canonical implementation document for replacing the current CapaKraken planning dataset with a clean-slate import from the Dispo v2 Excel workbooks.
|
||||
|
||||
## Scope
|
||||
|
||||
This document defines how Planarchy should ingest and normalize the following source workbooks:
|
||||
This document defines how CapaKraken should ingest and normalize the following source workbooks:
|
||||
|
||||
- `/samples/Dispov2/MandatoryDispoCategories_V3.xlsx`
|
||||
- `/samples/Dispov2/DISPO_2026.xlsx`
|
||||
@@ -13,7 +13,7 @@ This document defines how Planarchy should ingest and normalize the following so
|
||||
- `/samples/Dispov2/MV_DispoRoster.xlsx`
|
||||
- `/samples/Dispov2/Resource Roster_MASTER_FY26_CJ_20251201.xlsx`
|
||||
|
||||
The goal is not a raw workbook archive. The goal is a normalized Planarchy dataset that:
|
||||
The goal is not a raw workbook archive. The goal is a normalized CapaKraken dataset that:
|
||||
|
||||
- wipes existing database data and starts from a clean baseline
|
||||
- imports canonical reference data first
|
||||
@@ -79,7 +79,7 @@ Use as the source of:
|
||||
- resource enrichment when missing elsewhere
|
||||
- aggregate validation after commit
|
||||
|
||||
Do not treat PTD/MTD/YTD outputs as canonical source-of-truth records when Planarchy can derive them from normalized data.
|
||||
Do not treat PTD/MTD/YTD outputs as canonical source-of-truth records when CapaKraken can derive them from normalized data.
|
||||
|
||||
### 4. `MV_DispoRoster.xlsx`
|
||||
|
||||
@@ -151,20 +151,20 @@ The import commits into the existing planning model:
|
||||
|
||||
Relevant current schema anchors:
|
||||
|
||||
- [schema.prisma](/home/hartmut/Documents/Copilot/planarchy/packages/db/prisma/schema.prisma#L178)
|
||||
- [schema.prisma](/home/hartmut/Documents/Copilot/planarchy/packages/db/prisma/schema.prisma#L235)
|
||||
- [schema.prisma](/home/hartmut/Documents/Copilot/planarchy/packages/db/prisma/schema.prisma#L334)
|
||||
- [schema.prisma](/home/hartmut/Documents/Copilot/planarchy/packages/db/prisma/schema.prisma#L372)
|
||||
- [schema.prisma](/home/hartmut/Documents/Copilot/planarchy/packages/db/prisma/schema.prisma#L460)
|
||||
- [schema.prisma](/home/hartmut/Documents/Copilot/planarchy/packages/db/prisma/schema.prisma#L754)
|
||||
- [schema.prisma](/home/hartmut/Documents/Copilot/planarchy/packages/db/prisma/schema.prisma#L780)
|
||||
- [schema.prisma](/home/hartmut/Documents/Copilot/planarchy/packages/db/prisma/schema.prisma#L815)
|
||||
- [schema.prisma](/home/hartmut/Documents/Copilot/capakraken/packages/db/prisma/schema.prisma#L178)
|
||||
- [schema.prisma](/home/hartmut/Documents/Copilot/capakraken/packages/db/prisma/schema.prisma#L235)
|
||||
- [schema.prisma](/home/hartmut/Documents/Copilot/capakraken/packages/db/prisma/schema.prisma#L334)
|
||||
- [schema.prisma](/home/hartmut/Documents/Copilot/capakraken/packages/db/prisma/schema.prisma#L372)
|
||||
- [schema.prisma](/home/hartmut/Documents/Copilot/capakraken/packages/db/prisma/schema.prisma#L460)
|
||||
- [schema.prisma](/home/hartmut/Documents/Copilot/capakraken/packages/db/prisma/schema.prisma#L754)
|
||||
- [schema.prisma](/home/hartmut/Documents/Copilot/capakraken/packages/db/prisma/schema.prisma#L780)
|
||||
- [schema.prisma](/home/hartmut/Documents/Copilot/capakraken/packages/db/prisma/schema.prisma#L815)
|
||||
|
||||
## Required Implementation Changes
|
||||
|
||||
### 1. Canonical Person Identity
|
||||
|
||||
Planarchy currently stores both `eid` and `enterpriseId` on `Resource`. The import should operate on a single canonical identity.
|
||||
CapaKraken currently stores both `eid` and `enterpriseId` on `Resource`. The import should operate on a single canonical identity.
|
||||
|
||||
Recommendation:
|
||||
|
||||
@@ -392,7 +392,7 @@ Assignments should be written only when a project or internal bucket is resolved
|
||||
| `[_NA] Public Holiday ... {NA}` | `Vacation(type=PUBLIC_HOLIDAY)` | preferred source of truth is geography-driven generation |
|
||||
| `[_NA] Weekend {NA}` | no vacation row | derive from calendar |
|
||||
|
||||
Public holiday implementation should integrate with the existing vacation planner and batch holiday support in [vacation.ts](/home/hartmut/Documents/Copilot/planarchy/packages/api/src/router/vacation.ts#L425).
|
||||
Public holiday implementation should integrate with the existing vacation planner and batch holiday support in [vacation.ts](/home/hartmut/Documents/Copilot/capakraken/packages/api/src/router/vacation.ts#L425).
|
||||
|
||||
### Availability and Part-Time Mapping
|
||||
|
||||
@@ -506,7 +506,7 @@ Recommended approach:
|
||||
|
||||
Known implementation gap:
|
||||
|
||||
- the chargeability forecast currently passes an empty `publicHolidays` list into SAH calculation in [chargeability-report.ts](/home/hartmut/Documents/Copilot/planarchy/packages/api/src/router/chargeability-report.ts#L167)
|
||||
- the chargeability forecast currently passes an empty `publicHolidays` list into SAH calculation in [chargeability-report.ts](/home/hartmut/Documents/Copilot/capakraken/packages/api/src/router/chargeability-report.ts#L167)
|
||||
|
||||
Required follow-up:
|
||||
|
||||
|
||||
Reference in New Issue
Block a user