Community-Tagesimpulse: User koennen Sprueche via GitHub-Issue beisteuern

[MadGapun]

Idee: Nach dem Glueckskeks-Disclaimer in v1.6.2 (172 kuratierte Sprueche, mit selbstironischem Hinweis dass manche etwas orakelhaft daherkommen) ist die logische Erweiterung: Community-Sprueche.

User reichen ihre Bewerbungs-Mutmach-Sprueche via GitHub-Issue ein, Maintainer reviewt, freigegebene wandern in einen separaten Pool und werden mit Attribution im PBP-Dashboard angezeigt.

---

Mechanismus

Einreich-Flow

• Wo: GitHub-Issue mit Template (.github/ISSUE_TEMPLATE/impuls.yml)
• Felder:
  • text — der Spruch selbst (max ~200 Zeichen)
  • author_name — optional, Anzeigename oder „anonym"
  • github_handle_attribution — Checkbox „Mein @-Handle darf bei Anzeige verlinkt werden"
  • contexts — Multi-Select: default / wochenende / jobsuche / profil / bewerbung / nachfassen / absage / feiertag / onboarding
  • tone — Multi-Select: ermutigend / humor / ernst / ruhe / sarkastisch_leicht
  • Lizenz-Bestaetigung (Pflicht): „Mit Einreichung erlaube ich PBP unter MIT-Lizenz die Verwendung des Spruchs, optional attributiert mit meinem Namen/Handle."

Freigabe-Flow

• Maintainer (MadGapun + ggf. Co-Maintainer spaeter) reviewt:
  • thematisch passend, sprachlich okay, nicht doppelt
  • kein versteckter Werbe-Inhalt, kein Politik-Statement
• Bei Freigabe: Issue bekommt Label impuls-approved
• Optional: GitHub-Action zieht nightly alle approved Issues in community_impulse.json auf main. Alternativ manueller Sync beim Release-Sweep — geringerer Wartungsaufwand.

Auslese & Anzeige

• PBP-Dashboard fetcht community_impulse.json analog hints.json von GitHub raw, mit PBP_COMMUNITY_URL ENV-Override fuer Tests/Air-Gap-Setups.
• Datenstruktur:

  {
    "id": "comm_impuls_001",
    "text": "Spruch hier",
    "author": "Markus B.",
    "author_url": "https://github.com/issues/123",
    "tags": ["humor", "absage"],
    "contexts": ["default"]
  }

• Tagesimpuls-Box im Dashboard rendert Spruch + dezent — Markus B. darunter, Klick auf Namen oeffnet Original-Issue.
• Pool-Mischung: kuratierte (PBP-eigene) und Community-Sprueche werden mit gleicher Date-Hash-Logik (deterministisch nach Datum + Kontext) gemischt. Initial-Gewichtung 50/50, anpassbar.

---

Marketing-Aufhaenger

Schreib mir deinen Bewerbungs-Mutmach-Spruch — wenn er passt, bekommt
jeder PBP-Nutzer in zufaelligen Momenten DEIN Wisdom-Bit serviert. Mit
deinem Namen drunter, falls du willst.

Was muss er koennen: ehrlich sein, kein Pep-Talk-Quatsch, Bewerbungs-
alltag ernstnehmen. Lieber trocken-witzig als Wartezimmer-Plakat.

Einreichung: github.com/MadGapun/PBP/issues/new?template=impuls.yml

Plus organischer Footer-Link „Eigenen Spruch beisteuern →" unter der Tagesimpuls-Box im Dashboard selbst.

---

Aufwand

~1-2 Tage:

1. Issue-Template (.github/ISSUE_TEMPLATE/impuls.yml)
2. community_impulse.json Schema definieren + initial leeres File anlegen
3. Backend: Fetch-Logik in daily_impulse_service.py erweitern, Pool-Mischung implementieren
4. Frontend: Author-Attribution in Tagesimpuls-Box rendern
5. Optional GitHub-Action .github/workflows/sync-community-impulse.yml fuer Auto-Sync (nightly cron)
6. README + Wiki: Erwaehnung des Mitmach-Mechanismus
7. Roadmap-Eintrag in docs/ROADMAP_v1.7.0.md (bereits erledigt — siehe „Bonus-Idee" am Ende des Dokuments)

---

Akzeptanz-Kriterien

• Issue-Template ist online und valide
• Mindestens 5 Test-Sprueche von Maintainer eingereicht und approved (als Seed-Pool)
• community_impulse.json wird erfolgreich von Dashboard gefetcht (mit Cache + Fallback)
• Author-Attribution wird im Frontend gerendert mit klickbarem Link zum Issue
• Pool-Mischung mit kuratierten Spruechen funktioniert (Date-Hash bleibt deterministisch)
• PBP_COMMUNITY_URL=off deaktiviert Community-Pool (fuer Tests / Air-Gap)
• Lizenz-Hinweis im Issue-Template ist klar und MIT-konform
• README + Wiki dokumentieren den Mitmach-Mechanismus

---

Risiken & Mitigationen

Risiko	Mitigation
Spam/Trolling	Approval-Label noetig — manuelle Moderation
Niemand reicht ein	Eingebaute Sprueche bleiben als Fallback. Marketing-Push (Social Posts) bei Launch.
Urheberrecht-Ärger	Lizenz-Bestaetigung im Issue-Template als Pflichtfeld
Doppelte Sprueche	Beim Review pruefen, ggf. semantische Aehnlichkeit ueber Embeddings (kommt mit Local-LLM-Phase eh)
Politische / problematische Inhalte	Maintainer-Diskretion, Approval ist nicht garantiert

---

Offene Fragen

• Phase A oder spaeter? Local-LLM-Foundation hat Vorrang. Diese Idee passt eher in v1.7.x-Hotfix oder v1.8.0 als in den Foundation-Sprint. Entscheiden wir nach Phase A.
• Maintainer-Belastung? Bei <5 Einreichungen/Woche unkritisch. Bei >20 brauchen wir bessere Moderations-Tools (Bot, Co-Maintainer).
• Internationalisierung? Aktuell PBP nur deutsch. Sprueche bleiben deutsch. Bei Multi-Language-Roadmap entsprechend pro Sprache eigener Pool.

---

Dokumentation: siehe docs/ROADMAP_v1.7.0.md Abschnitt „Bonus-Idee: Community-Tagesimpulse".