56 lines
1.1 KiB
Markdown
56 lines
1.1 KiB
Markdown
# ADR 0022 — Dokumentenhierarchie und Single Source of Truth
|
|
|
|
## Status
|
|
Accepted
|
|
|
|
## Kurz erklärt
|
|
Single Source of Truth bedeutet:
|
|
|
|
```text
|
|
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:
|
|
|
|
1. ADRs
|
|
2. Architektur-Dokumente
|
|
3. Modulstruktur
|
|
4. Roadmap
|
|
5. Modul-Detaildokumente
|
|
6. 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:
|
|
|
|
```text
|
|
Planung und tatsächliche Umsetzung entfernen sich schleichend voneinander.
|
|
```
|
|
|
|
## Verwandte ADRs
|
|
- ADR 0019 — V1-Scope-Finalisierung
|
|
- ADR 0009 — Core-Grenzen
|