dogfather-universe/server/reaktion-tabellen.js

/* =====================================================================
   DIE REACTION — die Tabellen (28.09.2026)

   Filipe hat eine Kurznotiz geschickt: eine Reaction-Kachel, die
   fuer alle sichtbar ist, normalerweise geschlossen; bei
   Vorbereitung ein Vorschaubild und ein Countdown; ein paar Minuten
   vorher geht der Wartebereich auf, damit die Leute schon
   dasitzen und schreiben koennen; beim Start laufen YouTube-Video
   und Host-Kamera gleichzeitig; ein bis zwei Gaeste mit Kamera und
   Mikrofon; getrennte Lautstaerken; ein Live-Chat mit Moderation;
   und ein Weg, den Host zu unterstuetzen.

   ---------------------------------------------------------------------
   EINE SENDUNG, NICHT VIELE

   Es gibt genau EINE Reaction-Zeile. Sie wird nicht angelegt und
   geloescht, sie wechselt ihren Stand: zu -> vorbereitung -> live ->
   zu. Der Grund ist nicht Bequemlichkeit, sondern Wahrheit: Eine
   Kachel, die „offen" oder „geschlossen" anzeigt, muss auf EINE
   Zeile zeigen koennen. Bei einer Liste von Sendungen waere die
   erste Frage jedes Mal „welche denn?", und die Antwort darauf haette
   jede der sieben Stellen einzeln gegeben, die den Stand anzeigen.

   Was vorbei ist, wandert nach `reaktion_verlauf`. Damit bleibt die
   Geschichte erhalten, ohne dass die Gegenwart mehrdeutig wird.

   ---------------------------------------------------------------------
   WARUM DAS VIDEO NICHT UEBER DEN SERVER LAEUFT

   Naheliegend waere: der Host spielt das YouTube-Video ab, und alle
   sehen seinen Bildschirm. Das waere aus zwei Gruenden falsch.

   Erstens rechtlich: Ein YouTube-Video an Dritte weiterzusenden ist
   eine oeffentliche Wiedergabe und damit genau die Sache, fuer die
   Kanaele gesperrt werden. Jeder Zuschauer laedt das Video deshalb
   SELBST von YouTube -- so wie bei jeder Watch-Party.

   Zweitens technisch: Ein weitergesendetes Video kostet Bandbreite
   und Qualitaet. Uebertragen wird stattdessen nur, WO das Video
   gerade steht (Kennung, laeuft/pausiert, Sekunde). Das sind ein paar
   Byte, und jeder sieht es in voller Qualitaet.

   ---------------------------------------------------------------------
   DIE KAMERAS LAUFEN DIREKT VON MENSCH ZU MENSCH

   Der Anrufteil des Hauses (workspace-anruf.js, assets/js/anruf.js)
   macht das seit dem 18.09. und hat STUN/TURN eingerichtet. Die
   Reaction benutzt denselben Weg, nur mit mehr Empfaengern: Der Host
   baut zu jedem Zuschauer eine eigene Verbindung auf.

   DAS HAT EINE GRENZE, UND SIE IST GEMESSEN, NICHT GERATEN. Jede
   Verbindung kostet den Host Upload. Bei 360p und rund 350 kbit/s
   sind zwoelf Zuschauer etwa 4 Mbit/s -- das traegt eine normale
   Leitung. Darueber schaltet die Sendung von selbst auf Ton um: Wer
   keine Kamera mehr bekommt, hoert alles, sieht das Video und kann
   schreiben. Das ist ehrlicher als eine Verbindung, die stockt, und
   es ist sichtbar: Die Zahl steht im Regiepult.

   Heute sind es elf Menschen im ganzen Haus (gemessen am 28.09.2026:
   1 admin, 1 hand, 1 linke, 4 modi, 4 gast). Die Grenze ist also
   weit weg -- sie steht trotzdem hier, weil sie sonst erst auffaellt,
   wenn es zu spaet ist.
   ===================================================================== */

/** Wie lange ein beendeter Verlaufseintrag aufgehoben wird. */
export const VERLAUF_TAGE = 180;

/** Hoechstens so viele Zuschauer bekommen Kamerabild. Darueber: nur Ton. */
export const SICHT_PLAETZE = Number(process.env.REAKTION_SICHT_PLAETZE || 12);

/** Hoechstens so viele Gaeste gleichzeitig (Filipes Notiz: 1-2). */
export const GAESTE_MAX = 2;

/** Ein Chatbeitrag in der Reaction. */
export const TEXT_MAX = 400;

/** So viele Beitraege je Minute und Person. */
export const SCHREIB_BREMSE = 20;

/** Die Staende, die es gibt -- und nur diese. */
export const STAENDE = ["zu", "vorbereitung", "live"];

/** Die Anordnungen des Bildes. */
export const LAYOUTS = ["kino", "gleich", "kamera"];

export function reaktionTabellen(d) {
  d.exec(`
    /* Genau EINE Zeile. Die Sperre steht in der Tabelle und nicht im
       Programm: Ein Programm kann man umgehen, eine Bedingung nicht. */
    CREATE TABLE IF NOT EXISTS reaktion (
      id            INTEGER PRIMARY KEY CHECK (id = 1),
      stand         TEXT    NOT NULL DEFAULT 'zu'
                    CHECK (stand IN ('zu','vorbereitung','live')),
      titel         TEXT    NOT NULL DEFAULT '',
      video         TEXT    NOT NULL DEFAULT '',
      vorschau      TEXT    NOT NULL DEFAULT '',
      beginnt_am    TEXT,
      host_id       INTEGER REFERENCES personen(id) ON DELETE SET NULL,
      layout        TEXT    NOT NULL DEFAULT 'kino',
      laeuft        INTEGER NOT NULL DEFAULT 0,
      sekunde       REAL    NOT NULL DEFAULT 0,
      stand_seit    TEXT    NOT NULL DEFAULT '',
      gestartet_am  TEXT,
      geaendert     TEXT    NOT NULL DEFAULT ''
    );

    /* Wer gerade mit Kamera dabei ist. Der Host steht NICHT hier --
       er ist an der Sendung selbst vermerkt. Ein Gast, der geht,
       wird geloescht; wer stumm ist, bleibt stehen. */
    CREATE TABLE IF NOT EXISTS reaktion_gaeste (
      person_id  INTEGER PRIMARY KEY REFERENCES personen(id) ON DELETE CASCADE,
      seit       TEXT    NOT NULL,
      stumm      INTEGER NOT NULL DEFAULT 0,
      platz      INTEGER NOT NULL DEFAULT 1
    );

    /* Wer gerade zusieht. Wird beim Verlassen geloescht und von der
       Pflege entfernt, wenn sich jemand zwei Minuten nicht meldet.
       Daraus kommt die Zuschauerzahl -- und die Entscheidung, wer
       noch ein Kamerabild bekommt. */
    CREATE TABLE IF NOT EXISTS reaktion_dabei (
      person_id  INTEGER PRIMARY KEY REFERENCES personen(id) ON DELETE CASCADE,
      seit       TEXT    NOT NULL,
      gesehen    TEXT    NOT NULL,
      sicht      INTEGER NOT NULL DEFAULT 0
    );

    /* Der Live-Chat. Eigene Tabelle und nicht der Hauschat: Was hier
       gesagt wird, gehoert zu dieser einen Sendung und ist danach
       vorbei. Im Hauschat wuerde es die Gespraeche der Leute
       ueberschwemmen, und die Moderation waere eine andere. */
    CREATE TABLE IF NOT EXISTS reaktion_chat (
      id         INTEGER PRIMARY KEY AUTOINCREMENT,
      person_id  INTEGER REFERENCES personen(id) ON DELETE SET NULL,
      name       TEXT    NOT NULL DEFAULT '',
      rolle      TEXT    NOT NULL DEFAULT '',
      text       TEXT    NOT NULL,
      erstellt   TEXT    NOT NULL,
      weg_am     TEXT,
      weg_von    INTEGER REFERENCES personen(id) ON DELETE SET NULL
    );

    /* Was gelaufen ist. Eine Sendung je Zeile, erst beim Beenden. */
    CREATE TABLE IF NOT EXISTS reaktion_verlauf (
      id          INTEGER PRIMARY KEY AUTOINCREMENT,
      titel       TEXT    NOT NULL DEFAULT '',
      video       TEXT    NOT NULL DEFAULT '',
      host_id     INTEGER REFERENCES personen(id) ON DELETE SET NULL,
      begonnen    TEXT,
      beendet     TEXT    NOT NULL,
      zuschauer   INTEGER NOT NULL DEFAULT 0,
      beitraege   INTEGER NOT NULL DEFAULT 0
    );

    CREATE INDEX IF NOT EXISTS idx_reaktion_chat_zeit
      ON reaktion_chat (weg_am, id);
    CREATE INDEX IF NOT EXISTS idx_reaktion_dabei_gesehen
      ON reaktion_dabei (gesehen);
  `);

  /* DIE EINE ZEILE ANLEGEN, WENN ES SIE NOCH NICHT GIBT.

     `INSERT OR IGNORE` und nicht „erst fragen, dann schreiben": Zwei
     Anfragen gleichzeitig beim ersten Start wuerden sonst beide
     „gibt es nicht" lesen und beide schreiben wollen. */
  d.prepare(`INSERT OR IGNORE INTO reaktion
      (id, stand, stand_seit, geaendert) VALUES (1, 'zu', ?, ?)`)
    .run(new Date().toISOString(), new Date().toISOString());
}