docs: restructure domain documentation and update references

Implemented a standardized folder structure for domain documentation to improve clarity and maintainability. Migrated existing files to the new structure, updated links in related documentation, and added README files for navigation and guidance.
This commit is contained in:
2026-01-15 13:44:49 +01:00
parent 7d71ca9a48
commit a454e6c97a
66 changed files with 881 additions and 693 deletions
+9 -7
View File
@@ -8,10 +8,11 @@ Die Dokumentation wird nach dem **"Docs-as-Code"**-Prinzip gepflegt: Sie liegt n
* **/01_Architecture**: Architektur (ADRs, C4/Diagramme, Architektur-Referenzen).
* **/02_Onboarding**: Einstieg & Entwickler-Workflow (lokales Setup, PR-Workflow, Style-Guides).
* **/03_Agents**: Agent Operating Model (AOM) + Playbooks für Junie/Gemini und weitere KI-Unterstützungen.
* **/04_Backend**: Backend-spezifische Dokumentation (Services, Datenmodelle, Integrationen).
* **/05_Frontend**: Frontend-spezifische Dokumentation (KMP/Compose, Offline/Synchronisierung).
* **/06_Infrastructure**: Betrieb & Infrastruktur (Docker, Keycloak, Observability, Ports/URLs, Runbooks).
* **/03_Domain**: Fachliche Domäne (Kern-Modell, Referenzen, Analyse).
* **/04_Agents**: Agent Operating Model (AOM) + Playbooks für KI-Unterstützung.
* **/05_Backend**: Backend-spezifische Dokumentation (Services, Datenmodelle, Integrationen).
* **/06_Frontend**: Frontend-spezifische Dokumentation (KMP/Compose, Offline/Synchronisierung).
* **/07_Infrastructure**: Betrieb & Infrastruktur (Docker, Keycloak, Observability, Runbooks).
* **/90_Reports**: Berichte/Analysen/Status-Reports (zeitlich geordnet, nicht zwingend „verbindliche Regeln“).
* **/99_Journal**: Kurzprotokolle pro Session (Anti-Wissensverlust, Nachvollziehbarkeit).
@@ -27,9 +28,10 @@ Jeder Entwickler und jeder KI-Agent ist dafür verantwortlich, die Dokumentation
### Wichtigste Einstiege
* Agenten/Arbeitsmodus: `docs/03_Agents/`
* Lokales Setup/Workflow: `docs/02_Onboarding/`
* Fachliches Modell: `docs/03_Domain/`
* Agenten/Arbeitsmodus: `docs/04_Agents/`
* Architekturentscheidungen: `docs/01_Architecture/adr/`
* Backend (pro Service): `docs/04_Backend/Services/`
* Ping-Service (Startpunkt): `docs/04_Backend/Services/ping-service.md`
* Backend (pro Service): `docs/05_Backend/Services/`
* Ping-Service (Startpunkt): `docs/05_Backend/Services/ping-service.md`
* Ping-Service Implementierungs-Report (Historie): `docs/90_Reports/Ping-Service_Impl_01-2026.md`