Änderungen an dieser Dokumentation¶

Größere Änderungen an Struktur und Inhalt, neueste zuerst. Einzelne Korrekturen finden Sie in der Commit-Historie.

Oktober 2026¶

• Aktualisiert (18.10.2026): Konto und Sicherheit nennt den erweiterten Kreis, für den die Zwei-Faktor-Anmeldung in Work Pflicht ist, die Empfehlung auf der Startseite und die Angabe in der Mitgliederliste; Was ist neu in Work mit einem Eintrag dazu.
• Umbenannt (18.10.2026): „Crawler und Opt-out“ heißt jetzt Ingestor und Opt-out, die Adresse /datenschutz/crawler/ leitet dauerhaft auf /datenschutz/ingestor/ weiter. Der Ingestor ist kein Crawler; die Infoseite im User-Agent heißt entsprechend https://mandari.de/ingestor/ statt /crawler/ (mandari#1061).
• Neu (16.10.2026): Fehlertypen der Schnittstellen mit allen Fehlertypen nach RFC 9457; die Adressen in den Fehlerantworten der Session-API führen jetzt dorthin. Release- und Support-Politik mit Abo der Sicherheitsmeldungen. Landesrecht und Landesprofil Niedersachsen mit den Fassungen ab 07.05.2026 und ab 01.11.2026.
• Korrigiert (16.10.2026): Die regelmäßigen Aufgaben laufen als Zeitpläne im Worker, nicht mehr per Crontab auf dem Host; Dokument-Cache, Betriebsmonitor, Löschkonzept und Fristen-Erinnerungen verweisen entsprechend. Self-Hosting nennt alle Dienste samt Worker und die Optionen des Installers, Updates und Backups beschreibt update.sh, backup.sh, restic und die Versions-Tags, Betrieb in Kubernetes Migrationen und Worker. Die Konfiguration nennt rund 180 weitere Variablen und für jede Gruppe, was docker-compose.yml durchreicht. Entwicklung arbeitet mit uv, die Demo-Umgebung ist auf dem aktuellen Stand.
• Überarbeitet (16.10.2026): Ingestor und Opt-out beschreibt den Abruf jetzt wie die Abrufregeln im Code: User-Agent mandari-ingestor, höchstens eine Anfrage pro Sekunde je Server, eine nicht erreichbare robots.txt gilt nicht mehr als Erlaubnis, dazu der Takt je Quelle nach Bedarf, Vollabgleiche im Zeitfenster der Quelle und in Zeitscheiben, ruhende langsame Listen, neue Quellen und Kommunen, Dokumente, Personenfotos, Schonung, die Abruf-Adresse und die Abrufe bei Streaming-Anbietern und Geodiensten. Die Konfigurationsreferenz nennt die Variablen für Takt, Vollabgleich und User-Agent und sagt, welche Variablen docker-compose.yml nicht an die Dienste durchreicht. Quellen anbinden nennt die Einstellungen für Takt und Vollabgleich je Quelle und beschreibt, wie man einen Abgleich anstößt und prüft.
• Neu (07.10.2026): Eine llms.txt fasst die Dokumentation für Sprachmodelle und KI-Assistenten zusammen. Alte Adressen des Bürgerportals und der OParl-API, die Suchmaschinen noch unter docs.mandari.de führten, leiten jetzt dauerhaft auf mandari.de weiter.
• Neu (06.10.2026): Was ist neu in Work mit den Neuerungen in Work, neueste zuerst. Die Work-Hilfe spricht Leserinnen und Leser jetzt mit „Sie“ an, wie Work selbst. Dokumente und Anträge beschreibt zusätzlich Anhänge, Änderungsanträge mit Bezug, den Import aus Word und PDF und die Einreichung per E-Mail.

September 2026¶

• Neue Dokumentationsplattform unter docs.mandari.de auf Basis von MkDocs Material: Volltextsuche, helles und dunkles Design, Bearbeiten-Links zu GitHub, keine externen Ressourcen.
• Die bisherigen Seiten unter mandari.de/docs/ wurden übernommen und neu gegliedert nach Insight, Work, Session, Betrieb, Datenschutz und Entwicklung. Alte Adressen leiten weiter.
• Aus dem Quellcode-Repository übernommen und für Leserinnen und Leser außerhalb des Projekts aufbereitet: OParl-Aggregations-API, Session-OParl-API, Fraktions-API, Beschlussverfolgung, Ratsfragen, digitale Antragseinreichung, Fristen-Erinnerungen, Quellen anbinden, Dokument-Cache, Betriebsmonitor, Demo-Umgebung, TOM, Löschkonzept, Muster-AVV.
• Neu geschrieben: Plattform-Überblick, Glossar, Konfigurationsreferenz, Übersicht der regelmäßigen Aufgaben, Updates und Backups, Crawler und Opt-out, Mitarbeit an der Dokumentation.
• Neu (09.09.2026): Betrieb in Kubernetes mit Helm-Chart und Installer, Session-API v1 mit OpenAPI und Fehlerformat nach RFC 9457, Logging und Tracing für den Betrieb, Qualitätsgates und Tests für Mitwirkende.
• Neu (30.09.2026): Anwenderhilfe für Work mit Ersten Schritten, Sitzungsvorbereitung, Dokumenten und Anträgen, Konto und Sicherheit und Häufigen Fragen. Die Inhalte ersetzen die bisherige Wissensdatenbank im Support-Bereich von Work und wurden dabei auf den aktuellen Stand gebracht.