45379a2639
Architektur-Entscheidung aus Issue #62: Diátaxis-Framework für Doku- Pflege ohne Drift. Pflege im Repo, ADRs immutable, Stale-Snapshots explizit als Archiv markiert. Phase 1 — Architecture Decision Records: - docs/README.md — Diátaxis-Index, Erklärung was wo dokumentiert wird - docs/adr/README.md — ADR-Workflow + Index - docs/adr/template.md — Vorlage für neue ADRs - docs/adr/0001-llm-citation-binding.md — Issue #60 Doppel-Fix-Story (A=ENUM-Anker, B=server-seitige Rekonstruktion, warum Option C verworfen) - docs/adr/0002-adapter-architecture.md — ParlamentAdapter-Basisklasse + Registry, Klassen vs. Strategy vs. Modul-pro-Adapter - docs/adr/0003-citation-property-tests.md — Sub-D Strategie, warum Property-Test gegen echte PDFs statt Schema-Tests oder Online-Verify - docs/adr/0004-deployment-workflow.md — Docker-Compose + Volumes Standard-Workflow + SN-XML-Sonderpfad + Container-UTC-Gotcha Phase 3 — Stale Doku archiviert: - DOKUMENTATION.md (24.März, Skript-Architektur vor Webapp-Migrate) → docs/archive/DOKUMENTATION-2026-03-24.md - STATUS-2026-03-28.md (Tagesstand-Snapshot) → docs/archive/STATUS-2026-03-28.md - README.md (28.März, listet nur NRW-Adapter, vor 16 weiteren BLs) → docs/archive/README-2026-03-28.md - docs/archive/README.md erklärt warum die Files da sind und warum niemand sie überschreiben oder ersetzen sollte Plus neue Top-Level-README.md im Project-Root (außerhalb git, da project-root kein Repo ist) als Folder-Index für den User. CLAUDE.md ergänzt um Doku-Sektion mit Verweis auf docs/adr/. Phase 2 (mkdocs Setup) folgt separat — braucht eine Docker-Image- Erweiterung, die ich nicht autark einrollen will ohne Decision. Tests: 194/194 grün (keine Code-Änderung). Refs: #62
27 lines
1.3 KiB
Markdown
27 lines
1.3 KiB
Markdown
# Archiv
|
|
|
|
Hier liegen historische Doku-Snapshots, die **nicht mehr autoritativ** sind.
|
|
Sie beschreiben jeweils einen Zustand zu einem bestimmten Zeitpunkt; vieles
|
|
davon ist heute überholt.
|
|
|
|
## Warum nicht löschen?
|
|
|
|
- Sie sind als historische Quelle nützlich, wenn man verstehen will, wie
|
|
das Projekt zu einem früheren Zeitpunkt strukturiert war.
|
|
- Manche Findings sind in die ADRs (`../adr/`) übernommen, andere bewusst
|
|
nicht — weil sie tagesaktueller Stand waren und nie ADR-würdig.
|
|
|
|
## Inhalt
|
|
|
|
| Datei | Stand | Beschreibung |
|
|
|---|---|---|
|
|
| `DOKUMENTATION-2026-03-24.md` | 2026-03-24 | Frühe Skript-basierte Architektur, vor dem Webapp-Migrate. Beschreibt `scripts/process_single.sh`-Workflow, der heute durch FastAPI-Backend ersetzt ist. |
|
|
| `STATUS-2026-03-28.md` | 2026-03-28 | Tagesstand-Snapshot. Beschreibt v5-Prompt, Persistenz-Volume, Security-Headers — alle drei sind heute Standard. |
|
|
| `README-2026-03-28.md` | 2026-03-28 | Erste Repo-README. Listet nur den NRW-Adapter (vor #2/#3/#4 und 13 weiteren BLs). Architektur-Diagramm ist veraltet. |
|
|
|
|
## Wenn etwas davon noch wahr ist…
|
|
|
|
…gehört es in einen ADR (`../adr/`) oder die generierte Reference (geplant
|
|
für #62 Phase 2). Bitte **nicht** in einen neuen Status-Snapshot ziehen.
|
|
Status-Snapshots sind die Drift-Falle, die wir hier vermeiden wollen.
|