History

Dotty Dotter 176b7c5018 docs: Roadmap Programme/Legislaturen mit 11 Entscheidungen Strategische Klärungs-Runde im Anschluss an ADR 0013 — alle 11 offenen Fragen entschieden, in 5 Implementierungs-Blöcke strukturiert: Block 1 — Schema-Refactor (kurz): - gueltig_ab umstellen von Regierungsbildung auf Wahltag (B1+B2) - CSU als Alias auf CDU-BTW-Eintrag (B3) Block 2 — Daten-Beschaffung: - ~50 historische Wahlprogramme indizieren (A1) - BIW Bremen + BVB/FW Brandenburg historisch (A2) - BSW Manifest 2023 als parteiprogramm-Eintrag (B4) Block 3 — Infrastruktur: - Eigener PDF-Mirror auf Toppyr-Server (C3) - Monatlicher Cron: Parteiwebseiten-Update-Check (C1) - Täglicher Cron: inkrementelle Reindexierung (C2) Block 4 — Auswertungen + UI: - Eigene Detail-Views: Regierung-im-Detail, Wahlperiode (D2) - Programmwechsel-Diff, Treuequote-Zeitreihe, Koalitions-Shift (D1) Block 5 — Konsolidierung + Release: - WAHLPROGRAMME als View über programme.PROGRAMME (E2) - analyzer.py auf zeitpunktige Helper - v1.1.0 Production-Release (E1) Plus Detail-Gotchas und nächster konkreter Schritt (Block 1). Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>		2026-05-08 09:03:20 +02:00
..
adr	docs(adr): 0013 — Programme + Legislaturen mit zeitpunktiger Bewertung	2026-05-08 01:04:04 +02:00
analysen	docs+ops: ADRs 0006/0008, DDD-Bewertung, Zugriffsrechte, Smoke-Test, Cron-Scripts	2026-04-25 20:55:57 +02:00
archive	#62 : API-Reference + Datenmodelle + Embeddings-Pipeline (mkdocstrings)	2026-04-10 14:14:15 +02:00
how-to	Docs: Keycloak-Setup How-to + ADR-Index aktualisiert	2026-04-10 16:33:52 +02:00
reference	docs: API-Reference + mkdocs-Nav um Stimmverhalten/Aktuelle-Themen/Admin	2026-05-06 15:40:58 +02:00
index.md	#62 : API-Reference + Datenmodelle + Embeddings-Pipeline (mkdocstrings)	2026-04-10 14:14:15 +02:00
protokoll-parser-roadmap.md	feat(#149 ): BB-Parser produktiv — Brandenburger Plenarprotokolle (Status-Only)	2026-04-29 02:04:21 +02:00
README.md	#62 Phase 1+3: ADRs + Doku-Struktur in webapp/docs/	2026-04-10 01:38:03 +02:00
roadmap-programme-2026-05-08.md	docs: Roadmap Programme/Legislaturen mit 11 Entscheidungen	2026-05-08 09:03:20 +02:00

README.md

GWÖ-Antragsprüfer — Dokumentation

Diese Dokumentation folgt dem Diátaxis-Framework und ist nach Funktion (nicht nach Themen) organisiert. Drift-immun durch klare Trennung: Reference wird aus dem Code generiert, ADRs sind immutable, Tutorials/How-to sind manuell gepflegt aber knapp.

Struktur

docs/
├── README.md              ← du bist hier
├── adr/                   Architecture Decision Records (immutable)
│   ├── README.md          ADR-Index + Workflow
│   ├── template.md        Template für neue ADRs
│   └── NNNN-titel.md      Eine Datei pro Entscheidung
└── archive/               Historische Snapshots, nicht autoritativ

Geplant für später (siehe Issue #62):

docs/
├── reference/             ← mkdocs autodoc-Output (nicht eingecheckt)
├── tutorials/             ← Erst-Schritt-Anleitungen
├── how-to/                ← Aufgaben-orientiert, "wie deploye ich"
└── explanation/           ← Hintergründe, Konzepte

Nicht hier dokumentiert (bewusst)

Was	Wo
API-Reference (Endpoints, Models, Schemas)	Auto-generiert aus FastAPI/Pydantic, nicht in docs/ einchecken
Code-Reference (Klassen, Funktionen)	mkdocstrings aus den Docstrings (geplant Phase 2)
Aktueller Projekt-Stand / Issues	Gitea Issues — `repo.toppyr.de/tobias/gwoe-antragspruefer/issues`
Onboarding für KI-assisted Coder	`CLAUDE.md` im Repo-Root
Live-System-Status	`https://gwoe.toppyr.de/auswertungen` (dynamisches Dashboard)
Memory der KI-Sessions	`~/.claude/projects/<projekt>/memory/` (privat)

Gegen Drift

ADRs sind immutable: nie überschreiben, sondern bei Änderung mit einem neuen ADR superseden, der den alten in seinem Header referenziert.
Reference wird aus dem Code generiert, nie von Hand gepflegt.
docs/archive/ enthält historische Status-Files. Werden gelesen aber nicht aktualisiert. Wenn etwas davon noch wahr ist, gehört es in einen ADR oder in die generierte Reference, nicht in einen neuen Status-Snapshot.