chore(repo): initialize planarchy workspace

2026-03-14 14:31:09 +01:00
commit dd55d0e78b
769 changed files with 166461 additions and 0 deletions
@@ -0,0 +1,75 @@
+# Planarchy
+
+## Ziel
+
+Planarchy 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 @planarchy/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.