Files
abdulive/apps/broadcaster
ZeasyAlexandClaude Opus 5 c4dc6ee04f Go-Live-Ping: Discord meldet den Streamstart
Der billigste Hebel im Repo, und bis jetzt nur Vorarbeit: die Webhooks lagen
seit der Discord-Einrichtung bereit, gepostet hat nie jemand.

Ablauf: neuer Stream erkannt, eine Minute warten (Twitch setzt Titel und
Kategorie erst kurz nach dem Start, wer sofort postet kuendigt den Titel des
letzten Streams an), Daten frisch holen, Webhook posten, Rolle Live-Ping
anpingen.

Der Ping funktioniert nur mit `allowed_mentions` im Nachrichtenkoerper. `<@&ID>`
allein faerbt die Erwaehnung lila ein und benachrichtigt niemanden - der
Fehler, den man erst nach drei leeren Streams bemerkt. Dagegen steht ein
eigener Test.

Gegen den doppelten Post stehen drei Dinge, denn wer zweimal in zehn Minuten
angepingt wird, nimmt sich die Rolle wieder ab und ist damit fuer immer stumm:

- Tabelle `posts` mit eindeutigem Index je Stream und Plattform. Nur
  *gesendete* Posts sperren; ein fehlgeschlagener Versuch darf wiederholt
  werden, sonst kostet ein Netzwerkaussetzer die ganze Ankuendigung.
- Abklingzeit von sechs Stunden, gegen die neue Stream-ID nach einem
  Verbindungsabbruch.
- Ausgeloest wird nur beim erkannten Neustart, nie im Fortsetzungszweig.

`stream_id` ist bewusst kein Fremdschluessel: ein Post ist die Quittung fuer
etwas, das den Rechner verlassen hat, und muss auch dann schreibbar sein,
wenn es die Sitzung nicht gibt - beim Probelauf etwa.

Dazu ein vierter Webhook in #technik-log. Der Entwurfsmodus postet dieselbe
Nachricht dorthin, ohne Ping und nur fuer Mods sichtbar. So sieht man das
Ergebnis, bevor es der Server sieht.

Die Rollenaufloesung aus selfroles.ts liegt jetzt in roles.ts, weil der Ping
sie auch braucht: ein Webhook kann eine Rolle nicht ueber ihren Namen
anpingen.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-09-18 00:12:35 +02:00
..

@abdulive/broadcaster

Die Go-Live-Ankuendigung auf Discord.

Wird von abdulive hub und von abdulive ingest benutzt: sobald ein neuer Stream erkannt wird, wartet der Ankuendiger eine Minute (Titel und Kategorie stehen bei Twitch erst kurz nach dem Start), holt die Daten frisch, und postet ueber den Webhook in #ankuendigungen - mit Ping an die Rolle Live-Ping.

Der teuerste Fehler hier ist der doppelte Post: wer zweimal in zehn Minuten angepingt wird, nimmt sich die Rolle wieder ab. Dagegen steht decide() in src/golive.ts, die Tabelle posts und eine Abklingzeit von sechs Stunden.

Probelauf, ohne auf einen Stream zu warten:

abdulive golive:test           # in #technik-log, ohne Ping
abdulive golive:test --echt    # in #ankuendigungen, mit Ping

Spezifikation: docs/projects/go-live-broadcaster.md

Noch nicht gebaut: Bluesky, Mastodon und das Instagram-Story-Bild.