/* ===================================================================== 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}`); } }