5000ratshuus.ch
Ein automatisierter, quellenverlinkter Blog zur Aarauer Kommunalpolitik. Aus jedem Newsletter der Stadt entsteht ohne manuellen Schritt ein Artikel.
- 1NewsletterE-Mail der Stadt
- 2Workerprüft Absender und Inhalt
- 3GitHub ActionArtikel mit Claude
- 4CloudflareBuild und Deploy
- Ausgangslage
- Beschlüsse und Mitteilungen der Stadt Aarau erscheinen im städtischen Newsletter, sind dort aber schwer nachzuverfolgen und nicht nach Thema auffindbar. Wer wissen will, was entschieden wurde, muss die amtlichen Quellen selbst zusammensuchen.
- Meine Rolle
- Idee, Konzept und Umsetzung allein. Datenmodell, Prüfregeln, Pipeline, Hosting und Betrieb. Der Code ist in Zusammenarbeit mit KI entstanden.
- Ergebnis
- Die Seite ist live. Jede Newsletter-Ausgabe durchläuft automatisch Eingang, Kategorisierung, Artikelerzeugung, Prüfungen und Deploy. Jeder Eintrag verlinkt auf die tiefstmögliche amtliche Quelle.
- Stack
Ablauf
Der Newsletter der Stadt kommt per Mail an eine Adresse der Domain. Ein Cloudflare Email Worker prüft den Absender und stösst eine GitHub Action an. Die Action kategorisiert die einzelnen Geschäfte, löst die Quellen auf und erzeugt mit der Claude API den Artikel. Das Ergebnis wird committet, und Cloudflare baut und deployt die Seite.
Datenqualität vor der Publikation
Weil kein Mensch jeden Artikel liest, bevor er erscheint, liegt die Qualitätssicherung in der Pipeline selbst:
- Jede Ausgabe ist ein eigener Ordner mit dem Artikel und den einzelnen Geschäften als strukturierte Daten. Zod prüft beim Einlesen die Struktur. Fehlt ein Pflichtfeld, bricht der Build ab.
- Vor der Publikation laufen eigene Prüfungen, unter anderem auf die Erreichbarkeit der verlinkten Quellen. Ein Fristdatum im Text blockiert die Publikation, weil hier ein Fehler besonders teuer wäre.
- Eine zweite GitHub Action schlägt Alarm, wenn eine erwartete Ausgabe ausbleibt. So fällt auf, wenn der Eingang still kaputtgeht.
- Für die Archivseiten nach Thema und Art entsteht bei jedem Build ein SQLite-Index aus denselben geprüften Daten.
Transparenz
Die Seite publiziert mit einem klaren KI-Hinweis statt mit manuellem Review und bietet einen Weg, Fehler zu melden. Architekturentscheide sind datiert im Repository dokumentiert.