Ratslotse — Technische Dokumentation

Diese Doku richtet sich an Entwicklerinnen und Betreiberinnen. Sie erklärt, wie das System gebaut ist und warum es so gebaut ist. Endnutzer-Hilfe steht direkt auf ratslotse.de.

Architektur

Ein Scraper (SessionNet/Ratsinfo) speist eine SQLite-DB. Das Web-Frontend sitzt darauf. → Architektur

KI-Pipeline

Wie Tagesordnungen und Beschlüsse per LLM (über OpenRouter) gegen Nutzerthemen gematcht werden — inkl. Eval-Harness. → KI-Pipeline

Produkt

Das Beschlüsse-Feature aus den Sitzungsprotokollen: Extraktion und Themenfeld-Klassifikation. → Beschlüsse

Bewertungs-Scores

Wie Beschlüsse gewichtet werden: nachrechenbare Heuristik, KI-Tragweite, Gesprächswert — und wie sie zusammenfließen. → Bewertungs-Scores

App & Konten

Die native iOS-App, Anmeldung (inkl. Sign in with Apple) und was alles am Konto hängt. → App & Konten

Betrieb

Deploy-Wege, Dev-Umgebung, Cronjobs, Backups, Kosten und die komplette Env-Referenz. → Betrieb

Entscheidungen

Architecture Decision Records: die wichtigen Technik-Weichen und warum sie so gestellt wurden. → ADRs

Für Entwickler*innen

Das Repo ist Open Source (AGPL-3.0) — Beiträge willkommen. Der Einstieg für Contributor*innen steht in der CLAUDE.md im Repo-Root; konkrete Hosts und Secrets liegen ausschließlich auf dem Server, nie im Git.