Files
CapaKraken/CLAUDE.md
T
Hartmut cd78f72f33 chore: full technical rename planarchy → capakraken
Complete rename of all technical identifiers across the codebase:

Package names (11 packages):
- @planarchy/* → @capakraken/* in all package.json, tsconfig, imports

Import statements: 277 files, 548 occurrences replaced

Database & Docker:
- PostgreSQL user/db: planarchy → capakraken
- Docker volumes: planarchy_pgdata → capakraken_pgdata
- Connection strings updated in docker-compose, .env, CI

CI/CD:
- GitHub Actions workflow: all filter commands updated
- Test database credentials updated

Infrastructure:
- Redis channel: planarchy:sse → capakraken:sse
- Logger service name: planarchy-api → capakraken-api
- Anonymization seed updated
- Start/stop/restart scripts updated

Test data:
- Seed emails: @planarchy.dev → @capakraken.dev
- E2E test credentials: all 11 spec files updated
- Email defaults: @planarchy.app → @capakraken.app
- localStorage keys: planarchy_* → capakraken_*

Documentation: 30+ .md files updated

Verification:
- pnpm install: workspace resolution works
- TypeScript: only pre-existing TS2589 (no new errors)
- Engine: 310/310 tests pass
- Staffing: 37/37 tests pass

Co-Authored-By: claude-flow <ruv@ruv.net>
2026-03-27 13:18:09 +01:00

76 lines
2.3 KiB
Markdown

# CapaKraken
## Ziel
CapaKraken ist ein Ressourcenplanungs- und Projektbesetzungs-Tool fuer eine 3D-Produktionsumgebung. Der aktuelle Produktkern umfasst Timeline-Planung, Kapazitaets- und Budgetsicht, Rollenmanagement, Blueprint-basierte dynamische Felder, Skill-Matrix-Workflows und einen AI-unterstuetzten Staffing-/Profilbereich.
## Tech Stack
- TypeScript mit strikten Compiler-Einstellungen
- Next.js 15 App Router
- tRPC v11
- PostgreSQL via Prisma
- Auth.js v5 mit Argon2-basierter Passwortlogik
- pnpm Workspaces + Turborepo
- Tailwind CSS v4
- SSE/Redis-basierte Realtime-Infrastruktur
- Vitest und Playwright
## Monorepo-Struktur
```text
planarchy/
├── apps/web
├── packages/shared
├── packages/db
├── packages/engine
├── packages/staffing
├── packages/application
├── packages/api
└── packages/ui
```
## Engineering-Regeln
- Geld immer als Integer-Cents speichern
- Prisma-Enums und JSONB-Felder an Paketgrenzen explizit casten
- Nullable FKs defensiv behandeln
- Nach Prisma-Schema-Aenderungen Client regenerieren und den Dev-Server sauber neu starten
- Keine spekulativen Abstraktionen
## Quality Gates
- `pnpm test:unit`
- `pnpm --filter @capakraken/web exec tsc --noEmit`
- `pnpm lint`
## Dokumente
- Einstiegspunkt: [docs/README.md](/home/hartmut/Documents/Copilot/planarchy/docs/README.md)
- Aktiver Backlog: [docs/product-roadmap.md](/home/hartmut/Documents/Copilot/planarchy/docs/product-roadmap.md)
- Estimating-Design: [docs/estimating-extension-design.md](/home/hartmut/Documents/Copilot/planarchy/docs/estimating-extension-design.md)
- Historische Entscheidungen: [LEARNINGS.md](/home/hartmut/Documents/Copilot/planarchy/LEARNINGS.md)
## Routing-Regeln Fuer Agenten
**Parallel dispatch** nur wenn alle Bedingungen gelten:
- 3+ unabhaengige Aufgaben oder Domaenen
- kein geteilter State
- klare Dateigrenzen ohne Ueberschneidung
**Sequential dispatch** sobald eine Bedingung gilt:
- Tasks haben Abhaengigkeiten
- gemeinsame Dateien erzeugen Merge-Konflikt-Risiko
- Scope ist noch unklar
**Background dispatch** fuer:
- Recherche oder Analyse ohne Datei-Aenderungen
- Aufgaben, deren Ergebnis den aktiven Implementierungsfluss nicht blockiert
## Learnings
Wichtige Entscheidungen und Problemloesungen werden zentral in [LEARNINGS.md](/home/hartmut/Documents/Copilot/planarchy/LEARNINGS.md) festgehalten.