Demo-Umgebung¶

Der Befehl setup_demo_environment erstellt eine vollständige, klar als Demo erkennbare Musterumgebung über alle drei Portale hinweg. Alle Daten sind synthetisch und frei erfunden. Ideal, um mandari nach der Installation kennenzulernen oder vorzuführen.

python manage.py setup_demo_environment          # anlegen oder aktualisieren
python manage.py setup_demo_environment --reset  # restlos entfernen

Sitzungstermine liegen relativ zum Tag des Aufbaus, immer an einem Werktag um 17 Uhr Ortszeit (die Fraktionssitzung um 19 Uhr). Die kommende Ratssitzung liegt in Insight und Session am selben Tag.

Was angelegt wird¶

Insight¶

Fiktive Kommune „Musterstadt (Demo)“:

• 3 Gremien (Rat, Hauptausschuss, Ausschuss für Bauen und Verkehr) und 2 Fraktionen
• 8 fiktive Personen mit Mitgliedschaften
• 1 Wahlperiode, 6 Sitzungen, vergangene und kommende, mit Tagesordnungspunkten
• 12 Vorlagen verschiedener Typen (Beschlussvorlage, Antrag, Anfrage, Mitteilungsvorlage) mit Beratungen
• 5 kleine, selbst erzeugte PDF-Dateien mit bereits gesetztem Volltext, darunter die Unterlagen aller Vorlagen der kommenden Ratssitzung

Die Kommune ist nicht gelistet: Sie erscheint weder in der Kommunenauswahl noch in Übersichten, Sitemaps oder der OParl-Aggregations-API. Erreichbar ist sie nur über ihre direkte Adresse (/insight/kommune/<uuid>/). Überall steht „(Demo)“ im Namen.

Work¶

Organisation „Musterfraktion (Demo)“, verknüpft mit der Musterstadt und der Parteigruppe „Musterpartei (Demo)“:

• Standardrollen
• 5 Demo-Nutzer: Fraktionsvorsitz, Fraktionsmitglied, sachkundige Bürgerin, ein noch nicht vereidigtes Fraktionsmitglied und ein Gast mit lesender Ordnerfreigabe
• 2 Anträge (Entwurf und eingereicht), 1 Sitzungsvorbereitung mit Positionen und Notizen zur kommenden Ratssitzung, 3 Aufgaben
• das neue Design von Work, nur für die Demo-Organisation eingeschaltet
• Fraktionssitzungen mit Standard-Tagesordnung, einer vergangenen und einer kommenden Sitzung (öffentliche und nichtöffentliche TOPs, ein TOP-Vorschlag), eine Sitzungsreihe mit Ferienpause, Positionen mit Beratungsverlauf über zwei Gremien, Kommentare und Änderungsanträge
• eine Ankündigung „Was ist neu in Work“ für alle Mitglieder außer dem Gast

Session¶

Mandant „Stadtverwaltung Musterstadt (Demo)“:

• Standardrollen und 4 Verwaltungsnutzer, je einer für Administration, Sachbearbeitung, Protokollführung und Lesezugriff
• 3 Gremien und 8 Personen passend zur Kommune, Kontaktdaten verschlüsselt gespeichert; dazu das Amt „Kämmerei (Demo)“ mit einer Mitzeichnungsregel
• 3 Sitzungen mit Tagesordnung, 4 Vorlagen (eine mit vertraulichem Inhalt) und 2 Anträge der Musterfraktion; einer ist eingegangen, der andere schon in eine Vorlage für die kommende Ratssitzung umgewandelt
• Anwesenheit und genehmigtes Protokoll der vergangenen Sitzung des Hauptausschusses

Der Mandant veröffentlicht nicht im Bürgerportal. Die Musterstadt in Insight stammt aus der eigenen Demo-Quelle, nicht aus dem Session-Mandanten.

Zugangsdaten¶

Die Passwörter der Demo-Nutzer werden bei jedem Lauf neu erzeugt und ausschließlich auf der Konsole ausgegeben. Sie werden nirgendwo gespeichert. Ein erneuter Lauf rotiert die Passwörter, praktisch, wenn sie verloren gegangen sind.

Die Konten haben Adressen unter demo.mandari.de. Diese Domain ist über TWO_FACTOR_EXEMPT_EMAIL_DOMAINS (Standardwert) von der Pflicht zum zweiten Faktor ausgenommen, weil die Zugänge gemeinsam genutzt werden und keine echten Daten enthalten.

Öffentliche Demo-Instanz¶

Für einen öffentlichen Testzugang läuft die Demo als eigene Installation mit eigener Datenbank, in der nur die synthetischen Daten liegen. Der Schalter DEMO_INSTANCE=true macht aus einer normalen Installation diese Demo:

Ist zusätzlich DEMO_PASSWORD gesetzt, bekommen alle Demo-Konten dieses feste Passwort, damit es öffentlich genannt werden kann. Das gilt nur mit DEMO_INSTANCE; sonst ignoriert der Befehl die Variable. Setzen Sie DEMO_INSTANCE nie in einer Installation mit echten Daten.

Wer die Demo regelmäßig zurücksetzen will, verwirft die Demo-Datenbank, migriert neu und ruft setup_demo_environment erneut auf.

Wiederholbarkeit und Aufräumen¶

• Alle Objekte hängen an festen Demo-Kennungen (Slugs mit Endung -demo, OParl-IDs unter einer nicht auflösbaren Demo-Domain). Wiederholte Läufe aktualisieren statt zu duplizieren.
• Die Demo-Quelle ist inaktiv, damit der Ingestor sie nie abruft.
• --reset löscht ausschließlich die über diese Kennungen identifizierten Objekte: Session-Mandant, Work-Organisation, Parteigruppe, Demo-Nutzer, Quelle samt Kommune und die erzeugten PDF-Dateien.

Verifikation¶

Ein selbst enthaltener Test auf einer frischen SQLite-Instanz prüft doppelten Lauf ohne Duplikate, Demo-Logins, Darstellung der Insight-Seiten, Work-Dashboard inklusive Gastzugriff, Session-Dashboard und vollständiges Aufräumen:

python scripts/smoke_demo_environment.py