Kampagnen-Kachel aus einem TikTok-Link -- Etappe 2 bis 4

Der Auftrag ist damit fertig: Im Agentur-Bereich gibt es ein Feld, in
das die ganze Einladungsnachricht eingefuegt wird -- und daraus
entsteht eine Agentur-Event-Kachel mit Titel, Zeitraum, Banner,
Aufgaben zum Abhaken, Regeln, Ligen und Preisen. Gemessen 38 ms vom
Einfuegen bis zur Kachel.

ETAPPE 2 -- DER WEG NACH DRAUSSEN (helfer-tiktok.mjs)
  linkAusText holt die Adresse aus dem Fliesstext, damit niemand sie
  heraussuchen muss. folgeUmleitung geht Sprung fuer Sprung
  (redirect "manual", hoechstens fuenf) und schickt JEDE
  Zwischenadresse durch istTikTok -- bisher folgte holeMitFrist den
  Umleitungen selbst, und istTikTok hatte nur die EINGABE gesehen.
  Das ist die einzige Stelle im Haus, an der unser Server eine
  fremdbestimmte Adresse abruft.

  holeSeite zieht die Grenze von 3 MB BEIM LESEN, nicht hinterher: Wer
  arrayBuffer() abwartet und dann die Laenge ansieht, hat die 50 MB
  schon im Speicher. Frist 12 s statt 8 -- gemessen 750 ms allein beim
  Ursprungsserver, dazu 1,1 MB Uebertragung.

  bildAdresseErlaubt kam beim Bauen dazu, nicht aus dem Bauplan: Die
  Banneradresse steht in der Seite, die TikTok ausliefert, ist also
  FREMDBESTIMMT. Ohne Schranke wuerde unser Server abrufen, was dort
  steht -- auch http://127.0.0.1:4100/ oder 169.254.169.254. Elf
  Faelle durchgemessen.

ETAPPE 3 -- DIE ROUTE (workspace-kampagne.js, 5 Spalten, 1 Index)
  Rechte aus istLeitung, nicht neu erfunden. Bremse 20 je Stunde, VOR
  dem ersten Abruf nach draussen -- eine Bremse hinter dem Abruf
  bremst den fremden Server nicht. Dublettenpruefung zweimal: im Code
  (faengt den Normalfall) und als eindeutiger Index (faengt den
  Wettlauf zweier gleichzeitiger Aufrufe).

  'kampagne_schon_da' zaehlt bei der Bremse MIT (gefunden von der
  Pruefung): Zuerst zaehlten nur Erfolg und Fehlschlag -- wer denselben
  Link wieder und wieder einfuegt, bekommt jedes Mal "schon da" und
  loeste jedes Mal einen Abruf aus, ohne gezaehlt zu werden. Gemessen:
  21 Versuche, 0 gebremst.

  Der Regeltext wird SICHTBAR gekuerzt, an einer Abschnittsgrenze.
  Gipfelstuermer ergibt 7474 Zeichen, das Feld fasst 6000 (TEXT_MAX),
  und die PUT-Route lehnt mehr ab: Ungekuerzt entstuende eine Kachel,
  die DogFather OEFFNEN, aber nicht SPEICHERN kann -- er aendert ein
  Wort und bekommt eine Fehlermeldung ueber etwas, das er nie getippt
  hat. Verloren geht nichts: kampagne_daten traegt das Gelesene
  gegliedert.

ETAPPE 4 -- DIE OBERFLAECHE
  Ein Textbereich (die Einladung ist mehrzeilig), der Knopf gibt sich
  nach 15 s von selbst frei, die Meldung steht neben dem Feld und
  nennt den Grund im Klartext. Ob jemand darf, sagt der Server ueber
  darf_kampagne_einlesen in /api/ich -- keine Rollenliste im Browser.

  Gemessen auf 412 und 1280 px (bild-kampagne.mjs, 20 Messungen):
  Knopf 44 px, Kontrast 7,68:1, nichts liegt auf dem Knopf, kein
  Ueberlauf, keine Bewegung bei prefers-reduced-motion. Die
  Antwortzeile steht auf .9rem statt der hausweiten .76rem -- dort
  erscheint, was der Server geantwortet hat, und eine Fehlermeldung in
  12 px liest niemand zweimal. Die hausweite Klasse bleibt unberuehrt.

VIERZEHN SABOTAGEN, VIERZEHN TREFFER
  Sieben an kampagne-lesen.mjs (Etappe 1) und sieben an Route und Weg:
  Umleitung ungeprueft folgen, Tag nach Serverzeit, Dublettenpruefung
  weglassen, dem fremden Server den Bildtyp glauben, Bremse
  abschalten, Bremse wieder blind fuer Dubletten, jeden einlesen
  lassen. Jede wurde bemerkt, jede im erwarteten Abschnitt.

  EINE BLIEB ZUERST BLIND, und das war lehrreich: Nimmt man die
  Dublettenpruefung aus dem Code, faengt der INDEX es auf -- die
  Antwort ist dieselbe, die Pruefung blieb gruen. Kein Schaden, aber
  ein blinder Fleck. Jetzt unterscheidet die Pruefung am
  Protokolltext, WELCHE der beiden Sicherungen gegriffen hat.

VIER VORBESTEHENDE BEFUNDE MIT ERLEDIGT
  willkommen.html hatte kein theme-color, kein Manifest, kein
  apple-touch-icon. Drei Zeilen sind billiger und haltbarer als eine
  Ausnahme in der Pruefung.

  workspace-anleitung.js bildete den Tag "ab wann geht mehr" aus UTC.
  Wer zwischen 00:00 und 02:00 beitritt, bekam einen Termin, der einen
  Tag zu frueh war. workspace.js hat dafuer jetzt tagLokalVon(zeitpunkt,
  versatz) -- und tagLokal ist nur noch ein Aufruf davon. Es gibt also
  WENIGER Rechenwege als vorher, nicht mehr.

  pruef-anleitung.mjs legte Testdaten auf den UTC-Tag und waere
  zwischen 00:00 und 02:00 rot gewesen, ohne dass etwas kaputt ist.

  mess-anleitung-crew.mjs rechnete seinen zweiten Port als PORT + 1.
  Das sieht aus wie eine Ableitung und ist keine: portNummer
  ueberspringt gesperrte Nummern, und dann gehoert PORT + 1 der
  naechsten DATEI.

  pruef-struktur ist damit zum ersten Mal vollstaendig gruen.

GEPRUEFT (alle gruen, keine Zahl gesunken)
  pruef-kampagne 96 (neu) · pruef-kampagne-lesen 108 · pruef-video 74 ·
  pruef-eventkarte 94 · pruef-agentur 62 · pruef-anleitung 196 ·
  pruef-portnummern 41 (war 40 mit einem Fehler) · pruef-struktur,
  pruef-zeichen 8, pruef-ports 10, pruef-buehnen-fest 13,
  pruef-css-klassen 39, pruef-haus-trennung 107, pruef-lesbarkeit,
  pruef-tippziele, pruef-deutsche-texte 12, pruef-formulare,
  pruef-fingermass 5, pruef-workspace-seiten, pruef-tempo-workspace

Co-Authored-By: Claude Opus 5 <[email protected]>

server/workspace.js

@@ -4548,6 +4548,39 @@ function umstellungen(d) {
        sichtbar (siehe hausWo). Eine woechentliche Serie haette die
        Trennung damit Woche fuer Woche neu unterlaufen. */
     ["termin_serien", "haus", "TEXT"],
+
+    /* ================================================================
+       EINE KAMPAGNE AUS EINEM TIKTOK-LINK (07.10.2026), Etappe 3
+
+       Fuenf Spalten an einer Tabelle, die es schon gibt -- KEINE neue
+       Tabelle. Eine 'kampagnen'-Tabelle neben 'eintraege' waere ein
+       zweiter Ort fuer dasselbe, und beim naechsten Umbau liefe einer
+       von beiden aus. Die Kachel IST ein Eintrag; was dazukommt, ist
+       nur ihre Herkunft.
+
+       ADD COLUMN und kein Tabellenneubau: Es aendert sich kein CHECK.
+       Der Neubau vom 06.09. war noetig, weil dort der erlaubte
+       Wertebereich von 'bereich' wuchs -- und er ist der Weg, bei dem
+       man Inhalte verlieren kann.
+
+       WARUM 'kampagne_daten' die Rohwerte mitnimmt: Wenn in drei
+       Monaten auffaellt, dass auch die Ligen gebraucht werden, steht
+       die Antwort schon da. Ohne diese Spalte muesste jede Kampagne
+       neu geholt werden -- und eine abgelaufene antwortet dann
+       vielleicht nicht mehr. Gemessen am 07.10.2026: Bei einer
+       beendeten Kampagne liefert TikTok das Interaktionsschema gar
+       nicht mehr. Gespeichert wird ein AUSZUG, nicht die 1,1 MB.
+
+       WARUM 'kampagne_zone' eine eigene Spalte ist und nicht gerechnet
+       wird: Der Kalendertag einer Kampagne haengt an IHRER Zone, nicht
+       an der des Servers. Wer sie nicht mitspeichert, kann spaeter
+       nicht mehr richtig rechnen -- und eine Zahl, die um eins
+       danebenliegt, sieht aus wie eine Zahl. */
+    ["eintraege", "kampagne_id", "TEXT"],         // activityId -- Dublettenschluessel
+    ["eintraege", "kampagne_quelle", "TEXT"],     // der eingefuegte Link, unveraendert
+    ["eintraege", "kampagne_geholt_am", "TEXT"],  // ISO-Zeitstempel
+    ["eintraege", "kampagne_zone", "TEXT"],       // tz_location_name, z.B. Europe/Berlin
+    ["eintraege", "kampagne_daten", "TEXT"],      // JSON-Auszug der Rohwerte
   ]) {
     try {
       const vorhanden = d.prepare(`PRAGMA table_info(${tabelle})`).all().map((s) => s.name);
@@ -4565,6 +4598,33 @@ function umstellungen(d) {
      Tabelle ohne Spalte und meldet einen Fehler, den niemand braucht. */
   haeuserNachtragen(d);
 
+  /* ================================================================
+     EINE KAMPAGNE NUR EINMAL (07.10.2026)
+
+     WARUM EIN EINDEUTIGER INDEX UND NICHT NUR DIE PRUEFUNG IM CODE:
+     Zwei gleichzeitige Aufrufe laufen BEIDE durch das SELECT, bevor
+     einer schreibt. Die Pruefung im Code faengt den Normalfall, der
+     Index faengt den Wettlauf. Beides, nicht eins davon.
+
+     Und WARUM auf kampagne_id und nicht auf der Adresse: Es gibt
+     MEHRERE Kurzlinks auf dieselbe Kampagne -- jeder Versand erzeugt
+     eine eigene campaign_traffic_id --, und dieselbe Kampagne laesst
+     sich auch ueber die lange Adresse oeffnen. Wer auf quelle_url
+     prueft (so macht es das Video, dort richtig), bekommt fuer zwei
+     Einladungen zur selben Kampagne zwei Kacheln.
+
+     WHERE kampagne_id IS NOT NULL: Alle anderen Eintraege -- Aufgaben,
+     Termine, Videos, Aushaenge -- haben dort NULL. Ohne diese
+     Bedingung waere nach dem ersten davon kein zweiter mehr moeglich.
+     Steht hier unten und nicht oben im Bauplan, weil die Spalte erst
+     durch die Schleife darueber entsteht. */
+  try {
+    d.exec("CREATE UNIQUE INDEX IF NOT EXISTS idx_eintraege_kampagne"
+      + " ON eintraege (kampagne_id) WHERE kampagne_id IS NOT NULL");
+  } catch (fehler) {
+    console.error("[workspace] Index idx_eintraege_kampagne:", fehler?.message);
+  }
+
   /* Der Nachfüller fragt bei jedem Lauf "welche Ausprägungen dieser
      Serie gibt es schon?". Ohne diesen Verbund-Index liest SQLite dafür
      die ganze Termintabelle. Er steht hier unten und nicht oben im
@@ -7608,6 +7668,19 @@ workspaceRouter.get("/workspace/api/ich", (req, res) => {
        `ich.rolle === 'admin'`, und dieselbe Zeile schaltete auch das
        Loeschen frei; die beiden gehoeren nicht zusammen. */
     darf_rollen_wechseln: darfRollenWechseln(person),
+    /* OB DER KASTEN "KAMPAGNE AUS EINER EINLADUNG" ERSCHEINT
+       (07.10.2026). Aus derselben Regel wie die Schranke dahinter
+       (istLeitung in workspace-kampagne.js) -- die Oberflaeche
+       vergleicht keine Rollennamen selbst.
+
+       WARUM NICHT ["admin","spicy","manager"] IM BROWSER: Das waere
+       die vierte abgeschriebene Liste in diesem Haus. Am 10.09.2026
+       standen zwei solche Listen drei Zeilen auseinander und
+       widersprachen einander -- Spicy Media sah einen Knopf nicht,
+       obwohl der Weg dahinter offen war. Und die umgekehrte Richtung
+       ist schlimmer: Ein Feld, das erscheint und dann 403 bekommt,
+       laesst den Menschen davor sich selbst fuer den Fehler halten. */
+    darf_kampagne_einlesen: istLeitung(person),
     /* ZWEI LISTEN STATT EINER RECHNUNG IM BROWSER (20.09.2026).
 
        Die Rollenwahl nahm bisher die Knoepfe des Anlege-Formulars --
@@ -7896,10 +7969,35 @@ export function heuteLokal() {
  *      schweigen -- sonst wandert der Unsinn in die Datenbank und in
  *      die Anzeige, und gefunden wird er Wochen später. */
 export function tagLokal(versatz = 0) {
+  return tagLokalVon(Date.now(), versatz);
+}
+
+/** Derselbe Kalendertag, aber von einem BELIEBIGEN Zeitpunkt aus.
+ *
+ *  WOZU (07.10.2026, gefunden von pruef-struktur): In
+ *  workspace-anleitung.js stand
+ *
+ *      new Date(t + tage * 86400_000).toISOString().slice(0, 10)
+ *
+ *  -- gerechnet wurde also ab dem Beitrittstag, der Tag aber in UTC
+ *  gebildet. Wer zwischen 00:00 und 02:00 deutscher Zeit beitritt,
+ *  liegt in UTC noch im Vortag: Die Seite nannte dann einen Termin,
+ *  der einen Tag zu frueh war. Ein Datum, das um eins danebenliegt,
+ *  sieht immer noch wie ein Datum aus -- es faellt niemandem auf.
+ *
+ *  WARUM HIER UND NICHT DORT: Es waere die DRITTE Abschrift
+ *  derselben drei Zeilen gewesen. `tagLokal` ist jetzt selbst nur
+ *  noch ein Aufruf dieser Funktion mit `Date.now()` -- es gibt
+ *  also WENIGER Rechenwege als vorher, nicht mehr. */
+export function tagLokalVon(zeitpunkt, versatz = 0) {
   if (!Number.isFinite(Number(versatz))) {
-    throw new TypeError(`tagLokal: "${versatz}" ist keine Zahl von Tagen.`);
+    throw new TypeError(`tagLokalVon: "${versatz}" ist keine Zahl von Tagen.`);
   }
-  const d = new Date(Date.now() + versatz * 86400_000);
+  const ms = Number(zeitpunkt);
+  if (!Number.isFinite(ms)) {
+    throw new TypeError(`tagLokalVon: "${zeitpunkt}" ist kein Zeitpunkt.`);
+  }
+  const d = new Date(ms + versatz * 86400_000);
   const p = (n) => String(n).padStart(2, "0");
   return `${d.getFullYear()}-${p(d.getMonth() + 1)}-${p(d.getDate())}`;
 }