docs: add layer readmes for architecture boundaries

This commit is contained in:
2026-10-09 23:06:49 +02:00
parent ed06e460c3
commit 4fa57efca4
4 changed files with 155 additions and 0 deletions

View File

@@ -0,0 +1,33 @@
# DigitalData.TaskFlow.Domain
Dieses Projekt bildet den fachlichen Kern von `DigitalData.TaskFlow`.
## Zweck
Die Domain-Schicht enthaelt ausschließlich fachliche Modelle und Begriffe. Hier wird beschrieben, **was** das System fachlich darstellt, nicht **wie** Daten gelesen/geschrieben werden.
## Aktueller Inhalt
- `Common/`
- `ApiEnvelope<T>`: Standard-Response-Huelle mit `Meta` und `Data`.
- `MetaEntry`: Einzelner Meta-Eintrag (`Code`, `Message`).
- `Enums/`
- `MetaCode`: Fachliche Status-Codes (z. B. `Ok`, `NoAccess`, `AlreadyClosed`).
- `Workflows/`
- Modelle fuer den Endpoint `GET /workflows/{wisagid}`.
- Enthalten Quellblock-Struktur (`SourceBlock`, `FerdinandSourceBlock`, `ContractsSourceBlock`) und Untermodelle (`ProfileItem`, `WorkflowListingItem`, `ApprovalItem`, `DocumentReferenceItem`, `ClosingMethodItem`, `RejectionReasonItem`).
- `Closing/`
- Modelle fuer den Endpoint `POST /workflows/{wisagid}/{source}/{processid}/closing`.
- `CloseWorkflowDecision` (Eingabe), `CloseWorkflowResult` (Ergebnis).
- `Documents/`
- `DocumentBinaryResult` fuer den Endpoint `GET /documents/{id}`.
## Architektur-Regeln
- Keine EF-Core-, HTTP-, SQL- oder Infrastruktur-Abhaengigkeiten.
- Keine Controller- oder Middleware-Logik.
- Modelle bleiben in PascalCase; technische DB-Namensabweichungen werden spaeter in Infrastructure gemappt.
## Warum diese Schicht wichtig ist
Die Domain stellt eine stabile, technologieunabhaengige Sprache bereit. Dadurch koennen API, Application und Infrastructure getrennt entwickelt werden, ohne den fachlichen Vertrag zu verlieren.