rename(phase 1): CapaKraken → Nexus across code, UI, docs, CI

- @capakraken/* → @nexus/* across 12 packages (root + 11 workspaces), 1551 import lines migrated via codemod - User-visible brand strings renamed (emails, page titles, PWA manifest, mobile header, MFA backup-codes header, tooltips, signin page, invite page, weekly digest, install prompt) - TOTP issuer "CapaKraken" → "Nexus" (existing secrets still valid; re-enrollment relabels them in users' authenticator apps) - Function rename: assertCapaKrakenDbTarget → assertNexusDbTarget - LocalStorage migration shim in apps/web/src/app/layout.tsx copies capakraken_* → nexus_* on first load (guarded by nexus_migrated_v1 sentinel; runs once per browser, then never again) - Service-worker cache name capakraken-v2 → nexus-v2 with one-time caches.delete('capakraken-v2') from the same shim - Email-domain fixtures @capakraken.{dev,app} → @nexus.{dev,app} in seed data, e2e specs, SMTP default fallback - Dockerfile.dev / Dockerfile.prod / all .github/workflows/*.yml pnpm --filter @capakraken/* → @nexus/* - README, CLAUDE.md, LEARNINGS.md, all docs/*.md, .env.example, tooling/deploy/.env.production.example brand sweep Phase 1 deliberately leaves untouched (handled in Phase 3 cutover): - PostgreSQL DB name "capakraken" and POSTGRES_USER "capakraken" - Volume names capakraken_pgdata etc. - Compose project name "capakraken" / "capakraken-prod" - db-target-guard default expectedDatabase - env-var CAPAKRAKEN_EXPECTED_DB_NAME - Container DNS names in docker-compose.ci.yml Quality gates green: pnpm typecheck (7/7), pnpm test:unit (7/7), pnpm lint (0 errors), check:exports/imports/architecture all pass. Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2026-05-21 15:10:44 +02:00
parent d9a7ec0338
commit 4a5edeef3e
941 changed files with 24475 additions and 16760 deletions
@@ -1,4 +1,4 @@
-# CapaKraken v2 Refactoring Plan
+# Nexus v2 Refactoring Plan

 **Date:** 2026-03-14
 **Status:** Proposed
@@ -22,6 +22,7 @@
 **Problem:** 7 near-identical `formatMoney(cents, currency?)` implementations scattered across estimate and dashboard components.

 **Files affected:**
+
 - `apps/web/src/components/estimates/EstimateWorkspaceClient.tsx`
 - `apps/web/src/components/estimates/EstimateWorkspaceDraftEditor.tsx`
 - `apps/web/src/components/estimates/VersionCompare.tsx`
@@ -33,9 +34,10 @@
 **Target:** `apps/web/src/lib/format.ts` — add `formatMoney(cents: number, currency?: string): string`

 **Acceptance criteria:**
+
 - [x] `formatMoney` exported from `~/lib/format.ts`
 - [x] All 7 local copies removed, replaced by import from `~/lib/format.ts`
- [x] `pnpm --filter @capakraken/web exec tsc --noEmit` passes
+- [x] `pnpm --filter @nexus/web exec tsc --noEmit` passes
 - [x] Visual output unchanged (same `de-DE` locale, same `maximumFractionDigits: 0`)

 ---
@@ -62,10 +64,11 @@ export async function findUniqueOrThrow<T>(
 **Files affected:** All router files in `packages/api/src/router/` that use the pattern.

 **Acceptance criteria:**
+
 - [x] Helper exported from `packages/api/src/db/helpers.ts`
 - [x] At least 15 router files migrated to use the helper (19 files migrated)
- [x] `pnpm --filter @capakraken/api exec vitest run` passes (191 tests)
- [x] `pnpm --filter @capakraken/api exec tsc --noEmit` passes
+- [x] `pnpm --filter @nexus/api exec vitest run` passes (191 tests)
+- [x] `pnpm --filter @nexus/api exec tsc --noEmit` passes

 ---

@@ -77,11 +80,22 @@ export async function findUniqueOrThrow<T>(

 ```typescript
 export const ROLE_SELECT = { id: true, name: true, color: true } as const;
-export const PROJECT_BRIEF_SELECT = { id: true, name: true, shortCode: true, status: true } as const;
-export const RESOURCE_BRIEF_SELECT = { id: true, displayName: true, eid: true, chapter: true } as const;
+export const PROJECT_BRIEF_SELECT = {
+  id: true,
+  name: true,
+  shortCode: true,
+  status: true,
+} as const;
+export const RESOURCE_BRIEF_SELECT = {
+  id: true,
+  displayName: true,
+  eid: true,
+  chapter: true,
+} as const;
 ```

 **Acceptance criteria:**
+
 - [x] Select constants exported from `packages/api/src/db/selects.ts`
 - [x] All routers using inline `{ id: true, name: true, color: true }` for roles migrated
 - [x] TypeScript compiles, tests pass
@@ -93,6 +107,7 @@ export const RESOURCE_BRIEF_SELECT = { id: true, displayName: true, eid: true, c
 **Problem:** 3 modal components copy the same 8-line `invalidatePlanningViews()` block.

 **Files affected:**
+
 - `apps/web/src/components/allocations/AllocationModal.tsx`
 - `apps/web/src/components/resources/ResourceModal.tsx`
 - `apps/web/src/components/projects/ProjectModal.tsx`
@@ -100,6 +115,7 @@ export const RESOURCE_BRIEF_SELECT = { id: true, displayName: true, eid: true, c
 **Target:** `apps/web/src/hooks/useInvalidatePlanningViews.ts`

 **Acceptance criteria:**
+
 - [x] Hook exported from `~/hooks/useInvalidatePlanningViews.ts`
 - [x] AllocationModal uses the hook (ResourceModal/ProjectModal only have single-line invalidations — not candidates)
 - [x] TypeScript compiles, invalidation behavior unchanged
@@ -111,6 +127,7 @@ export const RESOURCE_BRIEF_SELECT = { id: true, displayName: true, eid: true, c
 **Problem:** 4+ components define their own `STATUS_BADGE: Record<string, string>` color maps.

 **Files affected:**
+
 - `apps/web/src/components/allocations/AllocationsClient.tsx`
 - `apps/web/src/components/vacations/VacationClient.tsx`
 - `apps/web/src/components/vacations/MyVacationsClient.tsx`
@@ -119,6 +136,7 @@ export const RESOURCE_BRIEF_SELECT = { id: true, displayName: true, eid: true, c
 **Target:** `apps/web/src/lib/status-styles.ts` (or `packages/ui/src/statusStyles.ts` if cross-package)

 **Acceptance criteria:**
+
 - [x] Typed status style maps exported from a single source (`~/lib/status-styles.ts`)
 - [x] All 4 consumers import from the shared module
 - [x] Dark mode classes preserved exactly
@@ -151,6 +169,7 @@ model Vacation {
 ```

 **Acceptance criteria:**
+
 - [x] Indexes added to schema
 - [x] `pnpm db:push` succeeds
 - [x] No existing queries broken (191 API tests pass, 254 engine tests pass)
@@ -184,6 +203,7 @@ interface TimelineContextValue {
 ```

 **Acceptance criteria:**
+
 - [x] `TimelineContext` created with `useTimelineContext()` hook
 - [x] All data-fetching and filter state lives in the context provider
 - [x] Child components access data via `useTimelineContext()` instead of props
@@ -201,6 +221,7 @@ interface TimelineContextValue {
 **Target:** `apps/web/src/components/timeline/TimelineResourcePanel.tsx`

 **Acceptance criteria:**
+
 - [x] Resource row rendering extracted into `TimelineResourcePanel`
 - [x] Uses `useTimelineContext()` for data access
 - [x] `TimelineView.tsx` reduced from 1,903 to 538 lines (72% reduction)
@@ -217,6 +238,7 @@ interface TimelineContextValue {
 **Target:** `apps/web/src/components/timeline/TimelineProjectPanel.tsx`

 **Acceptance criteria:**
+
 - [x] Project group rows and open-demand blocks extracted into `TimelineProjectPanel`
 - [x] Uses `useTimelineContext()` for data access
 - [x] `TimelineView.tsx` reduced to 538 lines (orchestrator + drag/tooltip/popover)
@@ -230,13 +252,14 @@ interface TimelineContextValue {

 **Target:** Replace with 3 smaller memos inside `TimelineResourcePanel`:

-| Memo | Dependencies | Responsibility |
-|---|---|---|
-| `resourceRows` | resources, filter, allocsByResource | Which rows to render |
-| `vacationBlocks` | vacationsByResource, viewStart, viewEnd, dayWidth | Vacation bar positions |
-| `assignmentBlocks` | allocsByResource, viewStart, viewEnd, dayWidth | Assignment bar positions |
+| Memo               | Dependencies                                      | Responsibility           |
+| ------------------ | ------------------------------------------------- | ------------------------ |
+| `resourceRows`     | resources, filter, allocsByResource               | Which rows to render     |
+| `vacationBlocks`   | vacationsByResource, viewStart, viewEnd, dayWidth | Vacation bar positions   |
+| `assignmentBlocks` | allocsByResource, viewStart, viewEnd, dayWidth    | Assignment bar positions |

 **Acceptance criteria:**
+
 - [x] No single `useMemo` has more than 10 dependencies (max 6)
 - [ ] React DevTools Profiler shows reduced re-render count on filter toggle (manual verification)
 - [x] Identical visual output
@@ -254,16 +277,19 @@ interface TimelineContextValue {
 **Target:** `packages/api/src/router/timeline.ts` — extend `getEntriesView` input:

 ```typescript
-getEntriesView.input(z.object({
-  startDate: z.coerce.date(),
-  endDate: z.coerce.date(),
-  resourceIds: z.array(z.string()).optional(),   // NEW
-  projectIds: z.array(z.string()).optional(),    // NEW
-  chapters: z.array(z.string()).optional(),      // NEW
-}))
+getEntriesView.input(
+  z.object({
+    startDate: z.coerce.date(),
+    endDate: z.coerce.date(),
+    resourceIds: z.array(z.string()).optional(), // NEW
+    projectIds: z.array(z.string()).optional(), // NEW
+    chapters: z.array(z.string()).optional(), // NEW
+  }),
+);
 ```

 **Acceptance criteria:**
+
 - [x] `getEntriesView` accepts optional filter arrays (resourceIds, projectIds, chapters, eids)
 - [x] Prisma `where` clause includes filters when provided
 - [x] Client passes active filters from `TimelineFilter` state
@@ -282,6 +308,7 @@ getEntriesView.input(z.object({
 Remove `availability` from `PROJECT_PLANNING_ASSIGNMENT_INCLUDE.resource.select`. Load it separately only in capacity-analysis queries.

 **Acceptance criteria:**
+
 - [x] `availability` removed from timeline resource select (new `TIMELINE_ASSIGNMENT_INCLUDE`)
 - [x] Staffing/capacity queries still load `availability` where needed (`PROJECT_PLANNING_ASSIGNMENT_INCLUDE`)
 - [x] Timeline rendering unchanged (availability was never used in rendering)
@@ -298,6 +325,7 @@ Remove `availability` from `PROJECT_PLANNING_ASSIGNMENT_INCLUDE.resource.select`
 Add a 50ms debounce buffer: batch events within the window, then emit a single aggregated event.

 **Acceptance criteria:**
+
 - [x] Batch operations emit 1 SSE event instead of N (50ms debounce buffer)
 - [x] Single-record operations still emit immediately (50ms imperceptible)
 - [x] Timeline re-fetches only once for batch operations
@@ -314,6 +342,7 @@ Add a 50ms debounce buffer: batch events within the window, then emit a single a
 **Problem:** 6 inline tab components (`OverviewTab`, `AssumptionsTab`, `ScopeTab`, `StaffingTab`, `FinancialsTab`, `VersionsTab`) are defined inside a single file.

 **Target:** Create individual files:
+
 - `apps/web/src/components/estimates/tabs/OverviewTab.tsx`
 - `apps/web/src/components/estimates/tabs/AssumptionsTab.tsx`
 - `apps/web/src/components/estimates/tabs/ScopeTab.tsx`
@@ -323,6 +352,7 @@ Add a 50ms debounce buffer: batch events within the window, then emit a single a
 - `apps/web/src/components/estimates/tabs/ExportsTab.tsx`

 **Acceptance criteria:**
+
 - [x] Each tab is a separate file with its own imports (7 tab files created)
 - [x] `EstimateWorkspaceClient.tsx` reduced to 306 lines (tab orchestrator + header + status bar)
 - [x] No behavioral change
@@ -335,11 +365,13 @@ Add a 50ms debounce buffer: batch events within the window, then emit a single a
 **Problem:** `EstimateWorkspaceDraftEditor.tsx` (1,205 lines) contains inline editors for assumptions, scope items, and demand lines.

 **Target:** Create individual editor components:
+
 - `apps/web/src/components/estimates/editors/AssumptionEditor.tsx`
 - `apps/web/src/components/estimates/editors/ScopeItemEditor.tsx`
 - `apps/web/src/components/estimates/editors/DemandLineEditor.tsx`

 **Acceptance criteria:**
+
 - [x] Each editor is a separate file (3 editor files created)
 - [x] `EstimateWorkspaceDraftEditor.tsx` reduced to 581 lines (orchestrator + save logic)
 - [x] Edit/save flow unchanged
@@ -356,6 +388,7 @@ Add a 50ms debounce buffer: batch events within the window, then emit a single a
 **Problem:** `update-blueprints.ts` (1,272 lines) and `seed.ts` (1,228 lines) live in `packages/application` but are database-specific operations.

 **Acceptance criteria:**
+
 - [x] Both files already in `packages/db/src/` (no move needed)
 - [x] Import paths correct
 - [x] `pnpm db:seed` works
@@ -368,12 +401,14 @@ Add a 50ms debounce buffer: batch events within the window, then emit a single a
 **Problem:** Single 1,112-line file doing validation, map building, placement, and persistence.

 **Target:** Split into:
+
 - `validate-dispo-batch.ts` — input validation and denormalization checks
 - `build-dispo-maps.ts` — chargeability and reference data map construction
 - `determine-placement.ts` — placement context and assignment logic
 - `commit-dispo-import-batch.ts` — orchestrator (300 lines max)

 **Acceptance criteria:**
+
 - [x] Each extracted module has a clear single responsibility (3 modules: validate, build-maps, determine-placement)
 - [x] `commit-dispo-import-batch.ts` orchestrates via function calls (1,112 → 573 lines)
 - [x] All 67 application tests pass
@@ -409,6 +444,7 @@ export async function paginate<T extends { id: string }>(
 ```

 **Acceptance criteria:**
+
 - [x] Pagination helper exported (`paginate` + `paginateCursor` in `packages/api/src/db/pagination.ts`)
 - [x] 2 router procedures migrated (project.list, project.listWithCosts — others use custom patterns)
 - [x] All 209 API tests pass (11 new pagination tests)
@@ -418,32 +454,32 @@ export async function paginate<T extends { id: string }>(

 ## Execution Constraints

-| Rule | Rationale |
-|---|---|
-| One phase at a time | Prevents merge conflicts across structural changes |
-| Green tests before moving to next phase | Each phase is independently safe to ship |
-| No feature additions during refactoring | Scope creep defeats the purpose |
-| Phase 2 and 3 may run in parallel | Timeline component split (frontend) is independent of query optimization (backend) |
-| Phase 4 and 5 may run in parallel | Estimate components and package boundaries don't overlap |
+| Rule                                    | Rationale                                                                          |
+| --------------------------------------- | ---------------------------------------------------------------------------------- |
+| One phase at a time                     | Prevents merge conflicts across structural changes                                 |
+| Green tests before moving to next phase | Each phase is independently safe to ship                                           |
+| No feature additions during refactoring | Scope creep defeats the purpose                                                    |
+| Phase 2 and 3 may run in parallel       | Timeline component split (frontend) is independent of query optimization (backend) |
+| Phase 4 and 5 may run in parallel       | Estimate components and package boundaries don't overlap                           |

 ## Verification Checklist (Per Phase)

- [ ] `pnpm --filter @capakraken/engine exec vitest run` — 254+ tests pass
- [ ] `pnpm --filter @capakraken/api exec vitest run` — 187+ tests pass
- [ ] `pnpm --filter @capakraken/application exec vitest run` — 67+ tests pass
- [ ] `pnpm --filter @capakraken/web exec tsc --noEmit` — zero errors
- [ ] `pnpm --filter @capakraken/api exec tsc --noEmit` — zero errors (excluding pre-existing dispo-import issues if Phase 5.2 not yet done)
+- [ ] `pnpm --filter @nexus/engine exec vitest run` — 254+ tests pass
+- [ ] `pnpm --filter @nexus/api exec vitest run` — 187+ tests pass
+- [ ] `pnpm --filter @nexus/application exec vitest run` — 67+ tests pass
+- [ ] `pnpm --filter @nexus/web exec tsc --noEmit` — zero errors
+- [ ] `pnpm --filter @nexus/api exec tsc --noEmit` — zero errors (excluding pre-existing dispo-import issues if Phase 5.2 not yet done)
 - [ ] Dev server starts and serves pages without 500 errors
 - [ ] Manual smoke test: timeline renders, estimate workspace tabs work, allocation CRUD works

 ## Metrics to Track

-| Metric | Current | Target (Post-Refactor) |
-|---|---|---|
-| `TimelineView.tsx` lines | 1,903 | < 350 |
-| `EstimateWorkspaceClient.tsx` lines | 1,298 | < 250 |
-| `formatMoney` copies | 7 | 1 |
-| Timeline payload size (filtered, 50 resources) | ~2 MB (estimated) | < 500 KB |
-| `useMemo` max dependency count | 28 | < 10 |
-| API test count | 187 | 200+ (add tests for new helpers) |
-| Total test count | 508 | 520+ |
+| Metric                                         | Current           | Target (Post-Refactor)           |
+| ---------------------------------------------- | ----------------- | -------------------------------- |
+| `TimelineView.tsx` lines                       | 1,903             | < 350                            |
+| `EstimateWorkspaceClient.tsx` lines            | 1,298             | < 250                            |
+| `formatMoney` copies                           | 7                 | 1                                |
+| Timeline payload size (filtered, 50 resources) | ~2 MB (estimated) | < 500 KB                         |
+| `useMemo` max dependency count                 | 28                | < 10                             |
+| API test count                                 | 187               | 200+ (add tests for new helpers) |
+| Total test count                               | 508               | 520+                             |