1.1 KiB
1.1 KiB
ADR 0022 — Dokumentenhierarchie und Single Source of Truth
Status
Accepted
Kurz erklärt
Single Source of Truth bedeutet:
Es gibt eine verbindliche Quelle,
wenn sich Dokumente widersprechen.
Kontext
Das Architekturreview hat kritisiert, dass mehrere Dokumente unterschiedliche Aussagen enthalten.
Beispiele:
- V1-Kundenzahl
- KI in V1 oder V2
- Customer Portal in V1 oder V2
- Module im Core oder Service-Modul
Entscheidung
Es gilt folgende Dokumentenhierarchie:
- ADRs
- Architektur-Dokumente
- Modulstruktur
- Roadmap
- Modul-Detaildokumente
- Brainstorming-/Ideendokumente
Konsequenz
Wenn sich Dokumente widersprechen, gilt die höhere Ebene.
Beispiel:
Wenn ADR 0019 sagt „KI ist V2“, aber ein altes Modul-Dokument KI als V1 beschreibt, gilt ADR 0019.
Pflege-Regel
Nach jeder größeren ADR-Serie müssen betroffene Dokumente aktualisiert werden.
Ziel
Architekturdrift verhindern.
Architekturdrift bedeutet:
Planung und tatsächliche Umsetzung entfernen sich schleichend voneinander.
Verwandte ADRs
- ADR 0019 — V1-Scope-Finalisierung
- ADR 0009 — Core-Grenzen