docs: add layer readmes for architecture boundaries
This commit is contained in:
33
src/core/DigitalData.TaskFlow.Domain/README.md
Normal file
33
src/core/DigitalData.TaskFlow.Domain/README.md
Normal 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.
|
||||
Reference in New Issue
Block a user