Development Workflow

Development Workflow

Repository-Struktur

Pfad	Inhalt
modules/	Fachmodule (Modular Monolith)
api/routes/	HTTP-Routen, gruppiert nach Route-Gruppen
api/server/	Server-Bootstrap, Middleware, Auth
apps/web/	React-Frontend (Vite)
packages/shared	Geteilte Typen/Utilities
infra/	Docker-Compose, CI-Skripte, Deployment
docs-site/	End-User-Handbuch (Astro Starlight, generiert)
docs/dev-portal/	Diese Entwickler-Doku (Astro Starlight, generiert)
tests/	Root-Testsuite (Vitest)

Commands

pnpm typecheck    # TypeScript strict — alle Workspaces
pnpm lint         # ESLint
pnpm test         # Vitest Root-Suite
pnpm build        # Alle Builds (API + Web)
pnpm docs:generate     # End-User-Handbuch neu generieren
pnpm docs-dev:generate # Entwickler-Doku neu generieren
pnpm docs-dev:dev      # Entwickler-Doku lokal ansehen

Neue Features

1. Prüfen, welches Modul fachlich zuständig ist — Feature gehört in modules/<name>/.
2. HTTP-Endpunkte in api/routes/<group>/ ergänzen (mit Input-Validierung).
3. Öffentliche Symbole nur über index.ts exportieren.
4. Tests: Unit (InMemory-Repos) + Integration über den Route-Layer.
5. docs/compliance_log.md ergänzen und diese Doku neu generieren: pnpm docs-dev:generate.

Frontend-Konventionen

• Typed API-Wrapper in apps/web/src/lib/api/ — kein fetch in Komponenten.
• Status-abhängige Aktionen über EntityActions + modul-eigene *Actions.ts.
• UI-Texte auf Deutsch, Code und Kommentare auf Englisch.