Zum Inhalt springen

Ratslotse — Technische Dokumentation

Wie der Ratslotse Oldenburger Lokalpolitik scrapt, per LLM klassifiziert und personalisiert ausliefert.

Diese Doku richtet sich an Entwickler:innen und Betreiber. 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