Hartmut
b41c1d2501
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>
2.1 KiB
2.1 KiB
Nexus
Ziel
Nexus 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
nexus/
├── 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:unitpnpm --filter @nexus/web exec tsc --noEmitpnpm lint
Dokumente
- Einstiegspunkt: docs/README.md
- Aktiver Backlog: docs/product-roadmap.md
- Estimating-Design: docs/estimating-extension-design.md
- Historische Entscheidungen: 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 festgehalten.