rename(phase 1): CapaKraken → Nexus across code, UI, docs, CI (#61)
CI / Architecture Guardrails (push) Successful in 2m38s
CI / Assistant Split Regression (push) Successful in 3m33s
CI / Typecheck (push) Successful in 3m51s
CI / Lint (push) Successful in 5m2s
CI / E2E Tests (push) Has been cancelled
CI / Fresh-Linux Docker Deploy (push) Has been cancelled
CI / Release Images (push) Has been cancelled
CI / Build (push) Has been cancelled
CI / Unit Tests (push) Has been cancelled
CI / Architecture Guardrails (push) Successful in 2m38s
CI / Assistant Split Regression (push) Successful in 3m33s
CI / Typecheck (push) Successful in 3m51s
CI / Lint (push) Successful in 5m2s
CI / E2E Tests (push) Has been cancelled
CI / Fresh-Linux Docker Deploy (push) Has been cancelled
CI / Release Images (push) Has been cancelled
CI / Build (push) Has been cancelled
CI / Unit Tests (push) Has been cancelled
rename(phase 1): CapaKraken → Nexus across code, UI, docs, CI (#61) Co-authored-by: Hartmut Nörenberg <hn@hartmut-noerenberg.com> Co-committed-by: Hartmut Nörenberg <hn@hartmut-noerenberg.com>
This commit was merged in pull request #61.
This commit is contained in:
@@ -1,11 +1,11 @@
|
||||
# Dispo Import Implementation
|
||||
|
||||
**Date:** 2026-03-14
|
||||
**Purpose:** Canonical implementation document for replacing the current CapaKraken planning dataset with a clean-slate import from the Dispo v2 Excel workbooks.
|
||||
**Purpose:** Canonical implementation document for replacing the current Nexus planning dataset with a clean-slate import from the Dispo v2 Excel workbooks.
|
||||
|
||||
## Scope
|
||||
|
||||
This document defines how CapaKraken should ingest and normalize the following source workbooks:
|
||||
This document defines how Nexus 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 CapaKraken should ingest and normalize the following s
|
||||
- `/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 CapaKraken dataset that:
|
||||
The goal is not a raw workbook archive. The goal is a normalized Nexus 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 CapaKraken can derive them from normalized data.
|
||||
Do not treat PTD/MTD/YTD outputs as canonical source-of-truth records when Nexus 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/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)
|
||||
- [schema.prisma](/home/hartmut/Documents/Copilot/nexus/packages/db/prisma/schema.prisma#L178)
|
||||
- [schema.prisma](/home/hartmut/Documents/Copilot/nexus/packages/db/prisma/schema.prisma#L235)
|
||||
- [schema.prisma](/home/hartmut/Documents/Copilot/nexus/packages/db/prisma/schema.prisma#L334)
|
||||
- [schema.prisma](/home/hartmut/Documents/Copilot/nexus/packages/db/prisma/schema.prisma#L372)
|
||||
- [schema.prisma](/home/hartmut/Documents/Copilot/nexus/packages/db/prisma/schema.prisma#L460)
|
||||
- [schema.prisma](/home/hartmut/Documents/Copilot/nexus/packages/db/prisma/schema.prisma#L754)
|
||||
- [schema.prisma](/home/hartmut/Documents/Copilot/nexus/packages/db/prisma/schema.prisma#L780)
|
||||
- [schema.prisma](/home/hartmut/Documents/Copilot/nexus/packages/db/prisma/schema.prisma#L815)
|
||||
|
||||
## Required Implementation Changes
|
||||
|
||||
### 1. Canonical Person Identity
|
||||
|
||||
CapaKraken currently stores both `eid` and `enterpriseId` on `Resource`. The import should operate on a single canonical identity.
|
||||
Nexus 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/capakraken/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/nexus/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/capakraken/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/nexus/packages/api/src/router/chargeability-report.ts#L167)
|
||||
|
||||
Required follow-up:
|
||||
|
||||
@@ -546,11 +546,11 @@ Required checks:
|
||||
For the clean-slate import workflow, use dedicated DB scripts instead of ad-hoc SQL:
|
||||
|
||||
- reset and bootstrap a disposable environment:
|
||||
- `pnpm --filter @capakraken/db db:reset:dispo -- --force`
|
||||
- `pnpm --filter @nexus/db db:reset:dispo -- --force`
|
||||
- reset without `pg_dump` backup only in an intentionally disposable environment:
|
||||
- `pnpm --filter @capakraken/db db:reset:dispo -- --force --skip-backup`
|
||||
- `pnpm --filter @nexus/db db:reset:dispo -- --force --skip-backup`
|
||||
- seed Dispo v2 reference vocabulary after reset:
|
||||
- `pnpm --filter @capakraken/db db:seed:dispo-v2`
|
||||
- `pnpm --filter @nexus/db db:seed:dispo-v2`
|
||||
|
||||
The reset command:
|
||||
|
||||
|
||||
Reference in New Issue
Block a user