dogfather-universe/server/manager-ziele-tabellen.js

/* =====================================================================
   MANAGER-ZIELE — die Tabellen (02.10.2026)
   =====================================================================

   Vier feste Monatsaufgaben für Scouts, Manager, DogFather und Spicy
   Media: Creator rekrutieren, Manager-Meeting, Schulung oder Community
   Talk, Werbung auf TikTok. Jede mit einer Zielzahl, einer Ampel und
   einem Monatsschnitt.

   WARUM EINE EIGENE DATEI: Die Tabellen hängen an `personen` (CASCADE)
   und an `leads`. Beide entstehen im Bauplan von workspace.js, und
   workspace-manager-ziele.js importiert AUS workspace.js — stünden die
   Tabellen dort, wäre das ein Importkreis. Über einen Kreis kommen
   Konstanten als `undefined` an, ohne dass irgendwo ein Fehler
   erscheint; hilfe-tabellen.js, support-tabellen.js und
   notiz-tabellen.js stehen aus demselben Grund getrennt.

   ---------------------------------------------------------------------
   DREI ENTSCHEIDUNGEN, DIE MAN SPÄTER NICHT MEHR BILLIG ÄNDERN KANN

   1. DAS ZIEL WIRD PRO MONAT EINGEFROREN, nicht als eine laufende
      Einstellung geführt.

      Filipe wollte die Zielzahlen änderbar haben, wirksam ab dem
      nächsten Monat. Läge nur EIN aktueller Wert in `einstellungen`,
      dann schriebe jede spätere Änderung rückwirkend den gesamten
      Verlauf um: Ein Monat, der mit 2/2 als „erreicht" abgeschlossen
      war, stünde nach einer Erhöhung auf 4 plötzlich als „nicht
      erreicht" da — ohne dass jemand etwas getan hätte. Ein Verlauf,
      der sich rückwirkend ändert, ist kein Verlauf.

      Deshalb: `mz_ziel` hat den Monat im Schlüssel. Beim ersten
      Zugriff auf einen Monat wird er festgeschrieben (siehe
      `monatSichern` im Fachmodul), und ab da steht er fest.

   2. DIE SPERRE VERGANGENER MONATE SITZT IN DER DATENBANK, nicht nur
      im Code.

      Dieselbe Überlegung wie bei workspace-schulung.js: „Ein Schutz,
      der nur im Code steht, ist beim nächsten neuen Weg zur Datenbank
      wieder weg." Drei Trigger lehnen jede Änderung an einem
      abgeschlossenen Monat ab.

      DIE AUSNAHME FÜR DOGFATHER LÄSST SICH IN SQLITE NICHT ÜBER DIE
      SITZUNG ABFRAGEN — es gibt keine Sitzungsvariablen. Deshalb
      `mz_freigabe`: eine einzige Zeile, die seine Route INNERHALB
      derselben Transaktion auf 1 setzt und danach wieder auf 0. Das
      ist ehrlicher als ein Trigger, den man mit einem Kommentar
      „gilt nicht für den Chef" einfach weglässt — die Ausnahme ist
      damit ein sichtbarer, zählbarer Vorgang und kein Loch.

      WARUM DIE FREIGABE NICHT VERGESSEN WERDEN KANN: Sie wird im
      `finally` einer synchronen Transaktion zurückgesetzt, und
      `mz_freigabe.bis` trägt zusätzlich einen Zeitpunkt. Was älter
      als zwei Minuten ist, gilt als nicht freigegeben — ein
      vergessenes Schloss wäre sonst dasselbe wie gar keines
      (dieselbe Erfahrung wie beim Arbeitsschloss in der Buchhaltung).

   3. DER AKTUELLE MONAT STEHT IN EINER TABELLE, nicht in `strftime`.

      Ein Trigger müsste sonst `strftime('%Y-%m','now','localtime')`
      rechnen — und `localtime` ist die Zeitzone des SERVERS. Steht der
      auf UTC, wäre am 1. eines Monats zwischen 00:00 und 02:00 Uhr
      deutscher Zeit noch der Vormonat „aktuell", und die Sperre
      griffe eine Stunde zu früh oder zu spät. `mz_lage` hält den
      Monat, den die Anwendung selbst in Europa/Berlin ausrechnet.
   ===================================================================== */

/** Die vier Aufgaben. Reihenfolge = Anzeigereihenfolge.
 *
 *  `feld` sagt, welche Zusatzangabe die Aufgabe braucht — daraus
 *  entstehen Formular, Prüfung und Dublettenschutz, damit die Liste
 *  nicht an vier Stellen getrennt gepflegt werden muss. Eine Liste,
 *  die niemand pflegt, kann nicht veralten. */
export const AUFGABEN = [
  {
    schluessel: "creator",
    name: "Creator rekrutieren",
    kurz: "Creator",
    einheit: ["Creator", "Creator"],
    vorgabe: 3,
    feld: "name",
    hinweis: "TikTok-Name des Creators",
  },
  {
    schluessel: "meeting",
    name: "Manager Meeting über Discord",
    kurz: "Meeting",
    einheit: ["Manager Meeting", "Manager Meetings"],
    vorgabe: 2,
    feld: null,
    hinweis: "Nur Datum und auf Wunsch eine Notiz",
  },
  {
    schluessel: "schulung",
    name: "Schulung oder Community Talk",
    kurz: "Schulung",
    einheit: ["Schulung oder Talk", "Schulungen oder Talks"],
    vorgabe: 2,
    feld: "art",
    arten: [
      { wert: "schulung", name: "Schulung" },
      { wert: "talk", name: "Community Talk" },
    ],
    hinweis: "Über Discord",
  },
  {
    schluessel: "werbung",
    name: "Werbung auf TikTok hochladen",
    kurz: "Werbung",
    einheit: ["Werbe-Video", "Werbe-Videos"],
    vorgabe: 1,
    feld: "link",
    arten: [
      { wert: "agentur", name: "Für die Agentur" },
      { wert: "eigen", name: "Eigenwerbung" },
      { wert: "beides", name: "Beides" },
    ],
    hinweis: "Link zum Video",
  },
];

export const AUFGABEN_SCHLUESSEL = AUFGABEN.map((a) => a.schluessel);

/** Wer die vier Aufgaben erfüllen muss.
 *
 *  Filipe am 02.10.2026 auf die Frage, wer eigene Zähler hat: „Alle
 *  vier Rollen." Creator stehen bewusst NICHT dabei — sie bekommen
 *  weder die Kachel noch eine Erinnerung. Modis und die Community
 *  kommen hier gar nicht vor: Sie gehören zum Haus Team Dogi, und die
 *  beiden Häuser sind seit dem 24.09.2026 getrennt. */
export const PFLICHT_ROLLEN = ["spicy", "admin", "manager", "scout"];

/** Wer die Zielzahlen ändern darf.
 *
 *  Filipe: „dogfather und spicy rolle sollen aber gleichzeitig es
 *  immer ändern können für alle." Das ist dieselbe Menge wie
 *  `siehtAlles()` in workspace.js — sie wird dort abgefragt und nicht
 *  hier abgeschrieben, damit es nicht zwei Mengen gibt, die
 *  auseinanderlaufen. Diese Zeile steht nur als Erinnerung daran, dass
 *  es eine bewusste Entscheidung war und keine Nebenwirkung. */

/** Der erste Monat, den es überhaupt gibt.
 *
 *  Aus der Vorlage: „Der erste gültige Monat ist Oktober 2026; davor
 *  gibt es keine Daten und keine Warnungen." Steht hier und nicht
 *  dreimal im Fachmodul. */
export const ERSTER_MONAT = "2026-10";

/** Wie lange eine Freigabe für einen abgeschlossenen Monat gilt.
 *
 *  Zwei Minuten. Lang genug für jede Korrektur, kurz genug, dass ein
 *  vergessenes Zurücksetzen keine dauerhaft offene Tür ist. */
export const FREIGABE_SEKUNDEN = 120;

export function managerZieleTabellen(d) {
  d.exec(`
    /* ---------- Ein Eintrag --------------------------------------- */
    CREATE TABLE IF NOT EXISTS mz_eintrag (
      id          INTEGER PRIMARY KEY AUTOINCREMENT,
      /* CASCADE und nicht SET NULL: Ein Eintrag ohne Person ist in
         dieser Tabelle sinnlos — gezählt wird je Person. Was bleiben
         soll, wenn jemand geht, ist die Pipeline und das Protokoll,
         nicht sein Monatszähler. */
      person_id   INTEGER NOT NULL REFERENCES personen(id) ON DELETE CASCADE,
      aufgabe     TEXT    NOT NULL
                  CHECK (aufgabe IN ('creator','meeting','schulung','werbung')),
      /* 'JJJJ-MM'. Der Monatsschnitt entsteht über diese Spalte und
         NICHT über das Löschen alter Zeilen -- aus der Vorlage:
         „Löse das über die Zuordnung der Einträge zu Monat/Jahr,
         nicht über das Löschen von Daten." */
      monat       TEXT    NOT NULL CHECK (length(monat) = 7),
      datum       TEXT    NOT NULL CHECK (length(datum) = 10),
      /* Der TikTok-Name bei 'creator'. Zusätzlich normalisiert in
         name_klein, damit der Dublettenschutz nicht an einem
         Großbuchstaben oder einem führenden @ scheitert. Zwei Spalten
         statt einer Rechnung beim Suchen: So kann ein Index darauf
         liegen. */
      name        TEXT,
      name_klein  TEXT,
      /* Der Link bei 'werbung', ebenfalls mit normalisierter Fassung.
         Filipe am 02.10.2026: jede gültige Internetadresse, nicht nur
         TikTok. */
      link        TEXT,
      link_klein  TEXT,
      /* schulung|talk  bzw.  agentur|eigen|beides */
      art         TEXT,
      notiz       TEXT,
      /* DIE BRÜCKE ZUR SCOUT-PIPELINE. Darf leer sein: Nicht jede
         Rekrutierung läuft über einen Lead, und ein Pflichtfeld hier
         würde den Weg von Hand unmöglich machen. SET NULL, weil ein
         gelöschter Lead den Monatseintrag nicht entwerten darf — die
         Rekrutierung hat ja stattgefunden. */
      lead_id     INTEGER REFERENCES leads(id) ON DELETE SET NULL,
      /* Ob jemand anders denselben Creator bzw. denselben Link in
         diesem Monat schon eingetragen hatte. Kein Grund abzulehnen
         (zwei Menschen können denselben Creator ansprechen), aber
         DogFather soll es in der Übersicht sehen können. */
      doppelt_bei INTEGER REFERENCES personen(id) ON DELETE SET NULL,
      erstellt    TEXT    NOT NULL,
      geaendert   TEXT,
      geaendert_von INTEGER REFERENCES personen(id) ON DELETE SET NULL
    );
    CREATE INDEX IF NOT EXISTS idx_mz_person_monat
      ON mz_eintrag (person_id, monat, aufgabe);
    CREATE INDEX IF NOT EXISTS idx_mz_monat    ON mz_eintrag (monat);
    CREATE INDEX IF NOT EXISTS idx_mz_name     ON mz_eintrag (monat, name_klein);
    CREATE INDEX IF NOT EXISTS idx_mz_link     ON mz_eintrag (monat, link_klein);
    CREATE INDEX IF NOT EXISTS idx_mz_lead     ON mz_eintrag (lead_id);

    /* ---------- Das Ziel, eingefroren je Monat und Rolle ----------- */
    CREATE TABLE IF NOT EXISTS mz_ziel (
      monat       TEXT    NOT NULL CHECK (length(monat) = 7),
      rolle       TEXT    NOT NULL,
      aufgabe     TEXT    NOT NULL
                  CHECK (aufgabe IN ('creator','meeting','schulung','werbung')),
      /* 0 heißt ausdrücklich „für diese Rolle nicht gefordert" und
         nicht „vergessen". Eine Zeile mit 0 erzeugt keine Warnung und
         zählt nicht in den Gesamtfortschritt. */
      ziel        INTEGER NOT NULL CHECK (ziel >= 0 AND ziel <= 99),
      gesetzt_von INTEGER REFERENCES personen(id) ON DELETE SET NULL,
      gesetzt_am  TEXT    NOT NULL,
      PRIMARY KEY (monat, rolle, aufgabe)
    );

    /* ---------- Ab wann jemand pflichtig ist ----------------------- */
    /* Aus der Vorlage: „Wer erst im Laufe des Monats eine der Rollen
       bekommt, erhält in diesem Monat keine Warnungen; die Pflicht
       beginnt im Folgemonat."

       EINMAL GEMESSEN UND GESPEICHERT statt bei jeder Abfrage aus dem
       Protokoll gerechnet. Das Protokoll ist ein Log: Es wird
       irgendwann aufgeräumt, und dann änderte sich rückwirkend, ab
       wann jemand pflichtig war. Ein Fundament darf nicht aus etwas
       bestehen, das ein Aufräumlauf kürzen darf. */
    CREATE TABLE IF NOT EXISTS mz_start (
      person_id    INTEGER PRIMARY KEY REFERENCES personen(id) ON DELETE CASCADE,
      erster_monat TEXT    NOT NULL CHECK (length(erster_monat) = 7),
      gesetzt_am   TEXT    NOT NULL,
      /* Woraus die Zahl entstanden ist — damit man es später
         nachvollziehen kann, ohne das Protokoll zu durchsuchen. */
      grund        TEXT
    );

    /* ---------- Welcher Monat gerade läuft ------------------------- */
    CREATE TABLE IF NOT EXISTS mz_lage (
      eins  INTEGER PRIMARY KEY CHECK (eins = 1),
      monat TEXT NOT NULL
    );
    INSERT OR IGNORE INTO mz_lage (eins, monat) VALUES (1, '0000-00');

    /* ---------- Die Freigabe für abgeschlossene Monate ------------- */
    CREATE TABLE IF NOT EXISTS mz_freigabe (
      eins  INTEGER PRIMARY KEY CHECK (eins = 1),
      offen INTEGER NOT NULL DEFAULT 0 CHECK (offen IN (0, 1)),
      bis   TEXT
    );
    INSERT OR IGNORE INTO mz_freigabe (eins, offen, bis) VALUES (1, 0, NULL);
  `);

  /* ---------- Die Sperre ------------------------------------------
     Drei Trigger, einer je Richtung. Sie stehen hier und nicht in
     einer Umstellung: Sie gehören zur Tabelle wie ihre Spalten.

     DIE BEDINGUNG IST DREITEILIG und jeder Teil hat einen Grund:
       * der Monat des Eintrags liegt vor dem laufenden
       * die Freigabe steht nicht auf 1
       * ODER die Freigabe ist abgelaufen (`bis` liegt in der
         Vergangenheit) -- eine vergessene Freigabe ist damit nach
         zwei Minuten von selbst wieder zu.

     `datetime('now')` ist hier unbedenklich, obwohl die Zeitzone des
     Servers unbekannt ist: Verglichen wird ein UTC-Zeitstempel mit
     einem UTC-Zeitstempel (die Anwendung schreibt `toISOString()`),
     und beide wandern gemeinsam. Beim MONAT wäre genau das nicht so --
     deshalb steht er in `mz_lage`.
     --------------------------------------------------------------- */
  d.exec(`
    CREATE TRIGGER IF NOT EXISTS mz_kein_alter_insert
    BEFORE INSERT ON mz_eintrag
    WHEN NEW.monat <> (SELECT monat FROM mz_lage WHERE eins = 1)
     AND NOT (SELECT offen FROM mz_freigabe WHERE eins = 1)
    BEGIN
      SELECT RAISE(ABORT, 'monat_gesperrt');
    END;

    CREATE TRIGGER IF NOT EXISTS mz_kein_alter_update
    BEFORE UPDATE ON mz_eintrag
    WHEN OLD.monat <> (SELECT monat FROM mz_lage WHERE eins = 1)
     AND NOT ((SELECT offen FROM mz_freigabe WHERE eins = 1)
              AND (SELECT bis FROM mz_freigabe WHERE eins = 1) > datetime('now'))
    BEGIN
      SELECT RAISE(ABORT, 'monat_gesperrt');
    END;

    CREATE TRIGGER IF NOT EXISTS mz_kein_alter_delete
    BEFORE DELETE ON mz_eintrag
    WHEN OLD.monat <> (SELECT monat FROM mz_lage WHERE eins = 1)
     AND NOT ((SELECT offen FROM mz_freigabe WHERE eins = 1)
              AND (SELECT bis FROM mz_freigabe WHERE eins = 1) > datetime('now'))
    BEGIN
      SELECT RAISE(ABORT, 'monat_gesperrt');
    END;
  `);

  /* ---------- Nachrüstung für Bestände ohne die neuen Spalten -------
     ABGELEITET, NICHT ABGESCHRIEBEN. Am 11.09.2026 hat im Creator
     Workspace eine von Hand gepflegte Spaltenliste beim Tabellenumbau
     drei Spalten mit Inhalt verloren -- ohne Fehlermeldung, bei
     unveränderter Zeilenzahl. Deshalb wird hier gefragt, was DA ist,
     statt eine Liste zu pflegen. */
  const da = new Set(d.prepare("PRAGMA table_info(mz_eintrag)").all().map((s) => s.name));
  const fehlt = [
    ["name_klein", "TEXT"], ["link_klein", "TEXT"],
    ["doppelt_bei", "INTEGER REFERENCES personen(id) ON DELETE SET NULL"],
  ].filter(([spalte]) => !da.has(spalte));
  for (const [spalte, typ] of fehlt) {
    d.exec(`ALTER TABLE mz_eintrag ADD COLUMN ${spalte} ${typ}`);
  }
}