Bürgerinnen-Perspektive: Was überfordert? Was muss erklärt werden? Profi-Infos hinter Klick verstecken #185

New Issue

tobias · 2026-05-07T09:35:34+02:00

tobias commented

2026-05-07 09:35:34 +02:00

Aufgabe

Die Antrag-Detail-Seite (und das Auswertungs-Dashboard) ist heute auf Profi-Niveau dicht: Score-Hero mit GWÖ-10-Skala, Matrix 5×5 mit kryptischen Codes (A1–E5), Stimm-Index in einem Diverging-Bar-Chart, Heuchelei-Quote mit Wahlprogramm-Score-Cutoff bei 7/10, Empfehlungs-Konsistenz-Kategorien, …

Persona-Test: Stell dir vor, du bist eine 45-jährige Lehrerin in Wuppertal, hast die Webseite über einen Tagesschau-Artikel über Kommunalpolitik gefunden und willst rausfinden, ob ein Antrag in deinem Stadtrat "gut" ist. Welche Begriffe blockieren dich beim ersten Scrollen?

Was vermutlich überfordert (Liste zur Validierung)

GWÖ-Matrix 5×5 Codes (A1, A2, …, E5): Ohne Kontext-Karten ein Code-Salat. Aktuell: Klick zeigt Erklärung, aber das Feld sieht nicht klickbar aus.
"Berührungsgruppe" als GWÖ-Begriff: jurastisch-soziologisch, nicht Alltagssprache.
"Wahlprogramm-Score 7/10": niemand weiß ohne Erklärung, wie der berechnet wurde. Ist 7 viel? Wenig?
"Heuchelei-Marker ⚠" und "Opportunismus-Marker !": Begriffe sind klar, aber die Schwellen (WP ≥ 7 / WP < 3) sind willkürlich-wirkend.
"Stimm-Index" auf /auswertungen: −10..+10-Skala, ohne Lesehilfe schwer zu interpretieren.
"Empfehlungs-Konsistenz": "Mehrheit kontra GWÖ-Empfehlung" — was ist eine GWÖ-Empfehlung? Wer empfiehlt da?
Drucksache-Nummer als Identifikator (z.B. "NRW · DRS. 18/18246"): Behörden-Sprache, für Bürger:innen kryptisch.
Fraktion vs. Partei: Wir verwenden beides, oft synonym, was inkorrekt ist (Fraktion ist die Gruppe im Parlament, Partei die Organisation außerhalb).
PDF-Bericht / JSON-Export / Permalink als drei nebeneinander stehende Aktions-Links: 80% der Bürgerinnen brauchen nur die PDF, der Rest verwirrt.
Matrix-Symbole ++ / + / ○ / − / −−: ohne Legende kryptisch (Legende ist da, aber sehr klein).

Was muss erklärt werden (Vorschläge)

Glossar-Tooltip auf Schlüsselbegriffen (Drucksache, Fraktion, Heuchelei-Marker, GWÖ-Matrix): Klick auf den Begriff öffnet einen kleinen Glossar-Pop-up mit Alltags-Definition.
"Erklär mir das"-Toggle oben rechts: schaltet zwischen "Profi-Modus" (heute = Default) und "Bürger:innen-Modus" um. Im Bürger:innen-Modus:
- Score-Hero zeigt "Gut für die Allgemeinheit / Gemischt / Problematisch" statt "7,3 / 10"
- Matrix 5×5 wird auf 5 Werte reduziert (Würde / Solidarität / Nachhaltigkeit / Gerechtigkeit / Demokratie), Berührungsgruppen ausgeblendet
- Heuchelei/Opportunismus-Marker mit Klartext-Tooltip beim Hover statt Symbol
- Wahlprogramm-Scores mit Wort-Etiketten: "passt sehr gut" / "passt teilweise" / "widerspricht"
Erste-Hilfe-Sektion auf jeder Seite (kollabierbar, default zu): "Wie lese ich diese Seite? "
Beispiel-Antrag mit Erklär-Tour: einmal beim ersten Besuch ein 5-Schritte-Walkthrough (z.B. mit intro.js oder eigenem CSS-Highlight).

Profi-Infos hinter Klick verstecken

Folgende Blöcke aktuell sofort sichtbar — vorschlagen, sie hinter <details> zu nehmen:

Verbesserungsvorschläge mit Redline-Diff (interessant für Antragsteller:innen, irrelevant für Erst-Leser:innen)
Kommentar-Widget (nur für Eingeloggte, daher schon halb-versteckt — könnte auf Bürgerinnen-Seite ganz weg)
JSON-Export-Link (technisch, gehört in Methodik-Seite)
Sub-Scores pro Berührungsgruppe in der GWÖ-Matrix (Profi-Tiefe — Default zeigt nur die 5 Werte)
Aktuelle News passend zum Antrag (cool, aber Sekundär-Info — als kollabierbar mit Auto-Open ab N≥3)

Aufwand (AI-Zeit)

Persona-Audit + Liste validieren mit echten Bürger:innen (User-Test): Wochen; nicht Claude-Zeit
Glossar-Tooltips: kurz (10 Begriffe × 5 min)
Bürger:innen-Modus-Toggle: lang (eigener Render-Pfad pro Block)
Verbesserungsvorschläge / News etc. hinter <details>: kurz
Erklär-Tour (intro.js): mittel

Hängt zusammen mit

#184 (CD-Konformität) — Glossar-Tooltips müssen über Klassen sauber gestylt sein
Eventuelles v3-Frontend (separate Diskussion offen) — Bürgerinnen-Modus könnte das v3-Default werden, Profi-Modus optional zuschaltbar
Methodik-Seite (/methodik) — sollte als Link-Ziel der Glossar-Tooltips fungieren

## Aufgabe Die Antrag-Detail-Seite (und das Auswertungs-Dashboard) ist heute auf Profi-Niveau dicht: Score-Hero mit GWÖ-10-Skala, Matrix 5×5 mit kryptischen Codes (A1–E5), Stimm-Index in einem Diverging-Bar-Chart, Heuchelei-Quote mit Wahlprogramm-Score-Cutoff bei 7/10, Empfehlungs-Konsistenz-Kategorien, … **Persona-Test**: Stell dir vor, du bist eine 45-jährige Lehrerin in Wuppertal, hast die Webseite über einen Tagesschau-Artikel über Kommunalpolitik gefunden und willst rausfinden, ob ein Antrag in deinem Stadtrat "gut" ist. Welche Begriffe blockieren dich beim ersten Scrollen? ## Was vermutlich überfordert (Liste zur Validierung) 1. **GWÖ-Matrix 5×5 Codes** (A1, A2, …, E5): Ohne Kontext-Karten ein Code-Salat. Aktuell: Klick zeigt Erklärung, aber das Feld sieht nicht klickbar aus. 2. **"Berührungsgruppe"** als GWÖ-Begriff: jurastisch-soziologisch, nicht Alltagssprache. 3. **"Wahlprogramm-Score 7/10"**: niemand weiß ohne Erklärung, wie der berechnet wurde. Ist 7 viel? Wenig? 4. **"Heuchelei-Marker ⚠"** und **"Opportunismus-Marker !"**: Begriffe sind klar, aber die Schwellen (WP ≥ 7 / WP < 3) sind willkürlich-wirkend. 5. **"Stimm-Index"** auf /auswertungen: −10..+10-Skala, ohne Lesehilfe schwer zu interpretieren. 6. **"Empfehlungs-Konsistenz"**: "Mehrheit kontra GWÖ-Empfehlung" — was ist eine GWÖ-Empfehlung? Wer empfiehlt da? 7. **Drucksache-Nummer** als Identifikator (z.B. "NRW · DRS. 18/18246"): Behörden-Sprache, für Bürger:innen kryptisch. 8. **Fraktion vs. Partei**: Wir verwenden beides, oft synonym, was inkorrekt ist (Fraktion ist die Gruppe im Parlament, Partei die Organisation außerhalb). 9. **PDF-Bericht / JSON-Export / Permalink** als drei nebeneinander stehende Aktions-Links: 80% der Bürgerinnen brauchen nur die PDF, der Rest verwirrt. 10. **Matrix-Symbole ++ / + / ○ / − / −−**: ohne Legende kryptisch (Legende ist da, aber sehr klein). ## Was muss erklärt werden (Vorschläge) - **Glossar-Tooltip auf Schlüsselbegriffen** (Drucksache, Fraktion, Heuchelei-Marker, GWÖ-Matrix): Klick auf den Begriff öffnet einen kleinen Glossar-Pop-up mit Alltags-Definition. - **"Erklär mir das"-Toggle** oben rechts: schaltet zwischen "Profi-Modus" (heute = Default) und "Bürger:innen-Modus" um. Im Bürger:innen-Modus: - Score-Hero zeigt "Gut für die Allgemeinheit / Gemischt / Problematisch" statt "7,3 / 10" - Matrix 5×5 wird auf 5 Werte reduziert (Würde / Solidarität / Nachhaltigkeit / Gerechtigkeit / Demokratie), Berührungsgruppen ausgeblendet - Heuchelei/Opportunismus-Marker mit Klartext-Tooltip beim Hover statt Symbol - Wahlprogramm-Scores mit Wort-Etiketten: "passt sehr gut" / "passt teilweise" / "widerspricht" - **Erste-Hilfe-Sektion auf jeder Seite** (kollabierbar, default zu): "Wie lese ich diese Seite? " - **Beispiel-Antrag mit Erklär-Tour**: einmal beim ersten Besuch ein 5-Schritte-Walkthrough (z.B. mit `intro.js` oder eigenem CSS-Highlight). ## Profi-Infos hinter Klick verstecken Folgende Blöcke aktuell sofort sichtbar — vorschlagen, sie hinter `<details>` zu nehmen: - **Verbesserungsvorschläge** mit Redline-Diff (interessant für Antragsteller:innen, irrelevant für Erst-Leser:innen) - **Kommentar-Widget** (nur für Eingeloggte, daher schon halb-versteckt — könnte auf Bürgerinnen-Seite ganz weg) - **JSON-Export-Link** (technisch, gehört in Methodik-Seite) - **Sub-Scores pro Berührungsgruppe** in der GWÖ-Matrix (Profi-Tiefe — Default zeigt nur die 5 Werte) - **Aktuelle News passend zum Antrag** (cool, aber Sekundär-Info — als kollabierbar mit Auto-Open ab N≥3) ## Aufwand (AI-Zeit) - Persona-Audit + Liste validieren mit echten Bürger:innen (User-Test): Wochen; nicht Claude-Zeit - Glossar-Tooltips: kurz (10 Begriffe × 5 min) - Bürger:innen-Modus-Toggle: lang (eigener Render-Pfad pro Block) - Verbesserungsvorschläge / News etc. hinter `<details>`: kurz - Erklär-Tour (intro.js): mittel ## Hängt zusammen mit - #184 (CD-Konformität) — Glossar-Tooltips müssen über Klassen sauber gestylt sein - Eventuelles v3-Frontend (separate Diskussion offen) — Bürgerinnen-Modus könnte das v3-Default werden, Profi-Modus optional zuschaltbar - Methodik-Seite (`/methodik`) — sollte als Link-Ziel der Glossar-Tooltips fungieren

tobias referenced this issue from a commit

2026-05-07 09:55:08 +02:00

feat(v3): Bürger:innen-Modus-Sandbox unter /v3/antrag/{drs}

tobias referenced this issue from a commit

2026-05-09 02:39:04 +02:00

feat(antrag-detail): geführte Tour mit Sprachausgabe (#185 Phase 1)

tobias commented

2026-05-09 02:40:00 +02:00

Phase 1 live (Commit 1c74cb8). Schaltfläche "🧭 Tour" in der userrow neben "Merken" — Klick öffnet ein Spotlight-Overlay mit vier Stationen:

Die Gemeinwohl-Note
Die GWÖ-Matrix (5 Werte × 5 Berührungsgruppen)
Programm-Treue pro Fraktion
Stimmverhalten und Marker (Heuchelei ⚠, Opportunismus !)

Audio: Web Speech API (Browser-eingebaute Stimme, de-DE, möglichst weiblich). "Stimme an / aus"-Toggle in der Bubble. ESC oder Klick auf Overlay-Hintergrund schließt die Tour, Audio stoppt.

Texte sind ermächtigend formuliert ("Was sagt die Zahl?", "Wie lese ich das Raster?"), nicht vereinfacht — der Profi-Modus bleibt erhalten.

Phase 2 (Folge-Iteration): Audio-Backend gegen ElevenLabs tauschen. Tour-Skript + UI bleiben gleich, nur speak() ruft dann einen Server-Endpoint, der eine pro-Station gecachte MP3 ausliefert. Dafür brauche ich von dir einen ElevenLabs-API-Key + Voice-ID-Auswahl (z.B. "Bella", "Rachel", "Domi" — weiblich, warm, seriös). Sobald die da sind, passe ich den Endpoint an.

**Phase 1 live** (Commit 1c74cb8). Schaltfläche "🧭 Tour" in der userrow neben "Merken" — Klick öffnet ein Spotlight-Overlay mit vier Stationen: 1. Die Gemeinwohl-Note 2. Die GWÖ-Matrix (5 Werte × 5 Berührungsgruppen) 3. Programm-Treue pro Fraktion 4. Stimmverhalten und Marker (Heuchelei ⚠, Opportunismus !) Audio: Web Speech API (Browser-eingebaute Stimme, de-DE, möglichst weiblich). "Stimme an / aus"-Toggle in der Bubble. ESC oder Klick auf Overlay-Hintergrund schließt die Tour, Audio stoppt. Texte sind ermächtigend formuliert ("Was sagt die Zahl?", "Wie lese ich das Raster?"), nicht vereinfacht — der Profi-Modus bleibt erhalten. **Phase 2 (Folge-Iteration):** Audio-Backend gegen ElevenLabs tauschen. Tour-Skript + UI bleiben gleich, nur speak() ruft dann einen Server-Endpoint, der eine pro-Station gecachte MP3 ausliefert. Dafür brauche ich von dir einen ElevenLabs-API-Key + Voice-ID-Auswahl (z.B. "Bella", "Rachel", "Domi" — weiblich, warm, seriös). Sobald die da sind, passe ich den Endpoint an.

tobias referenced this issue from a commit

2026-05-09 03:17:07 +02:00

feat(tour): ElevenLabs-Voice für die Tour (#185 Phase 2)

Sign in to join this conversation.