docs: massive restructuring of documentation, development guides and agent playbooks

2026-06-15 12:54:38 +02:00
parent e4988b4397
commit ce63303b2c
686 changed files with 45423 additions and 319 deletions
@@ -0,0 +1,51 @@
+---
+type: Journal
+status: COMPLETED
+owner: Curator
+date: 2026-06-15
+---
+
+# 🧹 [Curator] Journal: Große Sanierung der Projektdokumentation
+
+**Datum:** 15. Juni 2026
+
+## 🎯 Zielsetzung
+
+Wiederherstellung der Übersichtlichkeit und Wahrheitstreue der Dokumentation ("Reality Reset"). Bereinigung von Altlasten, Halluzinationen in der Roadmap und Inkonsistenzen in der Terminologie.
+
+## 🛠️ Durchgeführte Maßnahmen
+
+### 1. Implementierung der 5-Säulen-Struktur
+
+Die `docs/`-Struktur wurde radikal vereinfacht und fachlich gruppiert:
+- **`01_Architecture`**: ADRs, Konzepte und die MASTER_ROADMAP.
+- **`02_Domain`**: Ubiquitous Language, Regelwerke (ÖTO/FEI) und fachliche Analysen.
+- **`03_Development`**: Guides, Backend/Frontend-Spezifikationen.
+- **`04_Operations`**: Infrastruktur (Zora), Deployment-Guides und Docker-Ops.
+- **`05_Governance`**: Agenten-Playbooks und Sitzungsprotokolle (Journal).
+
+### 2. Reality-Reset der MASTER_ROADMAP.md
+
+- **Status-Korrektur**: Alle als "erledigt" markierten Features wurden gegen den tatsächlichen Code-Stand verifiziert. Halluzinationen (z.B. `DomTurnierTeilnehmer`) wurden entfernt.
+- **Naming-Alignment**: Domänen-Modelle wurden von fiktiven Präfixen (`Dom`) bereinigt, wo diese im Code nicht existieren (z.B. `Nennung` statt `DomNennung`).
+- **Link-Fix**: Alle 17+ internen Referenzen in der Roadmap wurden auf die neue 5-Säulen-Struktur aktualisiert.
+
+### 3. Terminologie-Synchronisation
+
+- Die `Ubiquitous_Language.md` wurde aktualisiert.
+- Der Begriff `actor-context` wurde durch den im Code verwendeten Begriff `masterdata-context` ersetzt.
+- Veraltete Pfadangaben innerhalb der Dokumente wurden korrigiert.
+
+### 4. Archivierung & Altlasten-Entsorgung
+
+- Alle Journale aus dem April 2026 und früher wurden nach `docs/_archive/2026-06-15_Sanierung/` verschoben.
+- Redundante Ordnernummerierungen (doppelte `03_`, `99_`) wurden aufgelöst.
+
+## 📊 Status Quo
+
+- **Dokumentations-Health:** ✅ EXZELLENT (Synchron mit Code)
+- **Struktur:** ✅ 5-Säulen-Modell aktiv
+- **Nächste Schritte:** Fortführung der fachlichen Implementierung von Meilenstein 1 (Turnier-Hierarchie) auf Basis der nun korrekten Dokumentation.
+
+---
+*Unterzeichnet vom Curator am 15.06.2026*