dogfather-universe/server/treff-tabellen.js

/* =====================================================================
   Die Tabellen des Treffs und die eine Frage, die überall gestellt wird
   (11.09.2026)
   =====================================================================

   DIESE DATEI IMPORTIERT NICHTS, und das ist ihr ganzer Zweck.

   Zwei Module brauchen dasselbe: workspace.js muss beim Anmelden und
   bei jeder Sitzung wissen, ob jemand gesperrt ist -- und
   workspace-treff.js muss es auch. Würde workspace.js dafür aus
   workspace-treff.js importieren, entstünde ein Kreis (treff importiert
   db, protokolliere und die Bretter aus workspace). ES-Module kommen
   damit zurecht, solange nur Funktionen über den Kreis laufen; sobald
   jemand eine Konstante beim Laden benutzt, bekommt er `undefined` --
   ohne Fehlermeldung, an einer Stelle, die mit dem Kreis nichts zu tun
   hat. Ein Blatt ohne Importe kann diesen Fehler nicht haben.

   Die Tabellen werden deshalb auch dort angelegt, wo alle anderen
   angelegt werden: im Bauplan in workspace.js. Ein verspätetes
   "CREATE TABLE IF NOT EXISTS" beim ersten Zugriff hätte bedeutet, dass
   die Sperrfrage beim allerersten Aufruf gegen eine Tabelle läuft, die
   es noch nicht gibt -- und eine Sperre, die bei einer Störung "darf"
   sagt, ist genau die, die im Ernstfall aufgeht.
   ===================================================================== */

/** Legt die Tabellen des Treffs an. Wird aus dem Bauplan gerufen. */
export function treffTabellen(d) {
  d.exec(`
    /* „Will ich auch" — EINE Stimme je Person und Eintrag.

       Der zusammengesetzte Primärschlüssel ist die ganze Regel: Ein
       zweiter Klick kann gar nicht als zweite Stimme ankommen, auch
       nicht bei zwei gleichzeitigen Anfragen. Eine Zählspalte am
       Eintrag hätte dieselbe Zahl gehalten und dabei jede Stimme
       doppelt genommen, sobald jemand zweimal tippt. */
    CREATE TABLE IF NOT EXISTS treff_stimmen (
      eintrag_id INTEGER NOT NULL REFERENCES eintraege(id) ON DELETE CASCADE,
      person_id  INTEGER NOT NULL REFERENCES personen(id) ON DELETE CASCADE,
      zeitpunkt  TEXT NOT NULL,
      PRIMARY KEY (eintrag_id, person_id)
    );
    CREATE INDEX IF NOT EXISTS idx_treff_stimmen_person ON treff_stimmen (person_id);

    /* Angeheftet am Anschlagbrett. Höchstens drei — die Zahl steht im
       Code (ANSCHLAG_MAX), nicht hier: Eine CHECK-Regel kann nicht über
       Zeilen hinweg zählen, und eine, die es könnte, müsste man beim
       Ändern der Zahl umbauen (siehe checkListeErweitern). */
    CREATE TABLE IF NOT EXISTS treff_angeheftet (
      eintrag_id INTEGER PRIMARY KEY REFERENCES eintraege(id) ON DELETE CASCADE,
      seit       TEXT NOT NULL,
      von        INTEGER REFERENCES personen(id) ON DELETE SET NULL
    );

    /* Freigaben. Ein Eintrag auf einem Freigabe-Brett ist für die
       Community erst da, wenn hier eine Zeile steht.

       ABWESENHEIT IST DER RUHEZUSTAND, und das ist der Kern: Eine
       Spalte "freigegeben INTEGER DEFAULT 0" hätte dasselbe getan --
       bis jemand einen Eintrag auf einem anderen Weg anlegt und die
       Vorgabe vergisst. Eine fehlende Zeile kann man nicht vergessen. */
    CREATE TABLE IF NOT EXISTS treff_freigaben (
      eintrag_id INTEGER PRIMARY KEY REFERENCES eintraege(id) ON DELETE CASCADE,
      zeitpunkt  TEXT NOT NULL,
      von        INTEGER REFERENCES personen(id) ON DELETE SET NULL
    );

    /* Meldungen (DSA Art. 16). Der Grund ist NOT NULL -- eine Meldung
       ohne Grund ist keine Meldung, sondern ein Klick. */
    CREATE TABLE IF NOT EXISTS treff_meldungen (
      id              INTEGER PRIMARY KEY AUTOINCREMENT,
      eintrag_id      INTEGER NOT NULL REFERENCES eintraege(id) ON DELETE CASCADE,
      melder_id       INTEGER REFERENCES personen(id) ON DELETE SET NULL,
      grund           TEXT NOT NULL,
      zeitpunkt       TEXT NOT NULL,
      status          TEXT NOT NULL DEFAULT 'offen'
                      CHECK (status IN ('offen','erledigt','abgelehnt')),
      entscheid       TEXT,
      entschieden_von INTEGER REFERENCES personen(id) ON DELETE SET NULL,
      entschieden_am  TEXT
    );
    CREATE INDEX IF NOT EXISTS idx_treff_meldungen_status
      ON treff_meldungen (status, zeitpunkt);

    /* Was entfernt wurde, und warum (DSA Art. 17).

       DIESE TABELLE HÄNGT ABSICHTLICH NICHT AN eintraege. Der Eintrag
       ist weg; die Begründung muss bleiben. Ein Fremdschlüssel mit
       ON DELETE CASCADE hätte genau das Gegenteil bewirkt -- die
       Begründung wäre im selben Moment verschwunden wie das, was sie
       begründet. Deshalb stehen Titel und Verfasser hier als Text bzw.
       als lose Nummer noch einmal. */
    CREATE TABLE IF NOT EXISTS treff_entfernt (
      id         INTEGER PRIMARY KEY AUTOINCREMENT,
      eintrag_id INTEGER NOT NULL,
      bereich    TEXT NOT NULL,
      titel      TEXT NOT NULL,
      autor_id   INTEGER,
      autor_name TEXT,
      grund      TEXT NOT NULL,
      von        INTEGER REFERENCES personen(id) ON DELETE SET NULL,
      zeitpunkt  TEXT NOT NULL
    );

    /* Maßnahmen: Hinweis, Pause, Ausschluss.

       "bis" = NULL heißt DAUERHAFT. Wer das darf, steht in
       darfMassnahme() -- und es ist bewusst nicht dieselbe Menge wie
       für die befristete Fassung (Filipe, 11.09.2026: "Modis dürfen
       befristet ausschließen, dauerhaft nur ihr"). */
    CREATE TABLE IF NOT EXISTS treff_massnahmen (
      id             INTEGER PRIMARY KEY AUTOINCREMENT,
      person_id      INTEGER NOT NULL REFERENCES personen(id) ON DELETE CASCADE,
      art            TEXT NOT NULL CHECK (art IN ('hinweis','pause','ausschluss')),
      grund          TEXT NOT NULL,
      bis            TEXT,
      von            INTEGER REFERENCES personen(id) ON DELETE SET NULL,
      zeitpunkt      TEXT NOT NULL,
      aufgehoben_am  TEXT,
      aufgehoben_von INTEGER REFERENCES personen(id) ON DELETE SET NULL
    );
    CREATE INDEX IF NOT EXISTS idx_treff_massnahmen_person
      ON treff_massnahmen (person_id, art);
  `);
}

/**
 * Die wirksame Maßnahme gegen diese Person, oder null.
 *
 * NIMMT DIE DATENBANK ALS ARGUMENT, statt sie sich zu holen: So kann
 * sie aus workspace.js gerufen werden, ohne dass diese Datei etwas von
 * workspace.js wissen muss. Und in einer Prüfung kann man ihr eine
 * Kopie geben.
 *
 * DREI AUSGÄNGE, NICHT ZWEI: `null` heißt "nichts liegt vor". Kann die
 * Frage nicht beantwortet werden (Tabelle fehlt, Datenbank weg), wirft
 * die Funktion -- sie gibt NICHT `null` zurück.
 */
export function treffSperreLesen(d, personId) {
  const zeilen = d.prepare(`
    SELECT id, art, grund, bis, zeitpunkt FROM treff_massnahmen
     WHERE person_id = ? AND art IN ('pause','ausschluss')
       AND aufgehoben_am IS NULL
     ORDER BY CASE art WHEN 'ausschluss' THEN 0 ELSE 1 END, id DESC`).all(personId);
  const nun = Date.now();
  for (const z of zeilen) {
    /* bis = NULL heißt dauerhaft. Eine abgelaufene Frist läuft ab,
       ohne dass jemand etwas tun muss -- eine Sperre, die man von Hand
       aufheben muss, bleibt sonst Jahre stehen. */
    if (!z.bis) return z;
    const ende = Date.parse(z.bis);
    if (Number.isFinite(ende) && ende > nun) return z;
  }
  return null;
}