Stadionzeitung, Veranstaltungen, News-Artikel, Lightbox und Anzeigen-Verteilung

Stadionzeitung: Live-Seiten (Tabellen, Ergebnisse, Vorschau, Termine, News,
Kontakt, Historie, Sportheim, Partner, Momente, Impressum), automatisches Cover,
Swipe-Viewer mit Vollbildmodus und die Druckfassung als Falt-Heft. Anzeigen
kommen jetzt aus dem Bestand und werden gleichmäßig verteilt, nie mehr als zwei
hintereinander (vorher vier Blöcke à fünf). Die Doppelseiten-Regel rechnet das
Skript selbst, statt sie von Hand zu prüfen.

Veranstaltungen: Bereich /veranstaltungen mit Detailseite pro Fest, Lebenszyklus
über das Datum (Ankündigung vor dem Fest, Rückblick danach), Galerie mit
Lightbox. veranstaltungen.json ist dritte Termin-Quelle, damit ein Fest nie
doppelt gepflegt wird.

News-Artikel als dritte dynamische Prefix-Route, gemeinsamer detail-head.

Behobene Fehler:
- Wappen-Kontexte setzten Zeilen-Layout auf .crest statt auf die Zeile; das
  Wappen wurde zum Grid, Vereinsname und Tore rutschten darunter zusammen
  (Ergebnis-Rückblick, Vorschau, Cover).
- --header-h (60px) unterschätzt die Kopfleiste um 32px (Logo 72px + 20px
  Versatz): neues abgeleitetes --header-space, sonst klebten Zurück-Links
  unter dem Logo.
- base_url in der Produktions-Config ohne www, während .htaccess auf www
  umleitet; preflight prüft das jetzt.
- .lightbox brauchte display:none mit (0,2,0), sonst lag das Overlay offen.

Neue Werkzeuge: bin/anzeige-add.php (Anzeigen-Bestand), bin/veranstaltung-bilder.php
(Plakate und Galerien, Alt-Texte folgen der Quelldatei), bin/qr.php (Druck-QR mit
Warnung, wenn base_url nicht auf die echte Domain zeigt).

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01NzeVVgMCrzCDJAKeLEdKr7

bin/stadionzeitung-publish.php

@@ -0,0 +1,92 @@
+<?php
+
+declare(strict_types=1);
+
+/**
+ * Stadionzeitung-Ausgabe veröffentlichen: friert die Live-Daten (Tabellen,
+ * Ergebnisse, Vorschau, News) als `snapshot`-Feld in der Ausgabe ein und
+ * setzt status auf 'veroeffentlicht' — ab jetzt taucht die Ausgabe in
+ * Archiv/Sitemap auf und ändert sich nie mehr (Interview-Beschluss
+ * 29.07.2026: „gedruckt = fixiert"). Die Berechnung ist dieselbe wie in der
+ * Entwurfs-Vorschau (stadionzeitung_build_snapshot(), app/helpers.php) —
+ * was Felix beim Prüfen gesehen hat, wird exakt so eingefroren.
+ *
+ * Aufruf: php bin/stadionzeitung-publish.php <slug>
+ *         php bin/stadionzeitung-publish.php <slug> --entwurf   (zurückziehen:
+ *         Status wieder auf Entwurf, Snapshot wird verworfen — die Seiten
+ *         rechnen wieder live)
+ *
+ * Sinnvoller Zeitpunkt: am Spieltagmorgen NACH dem letzten Matchcenter-Sync,
+ * dann steht der aktuelle Tabellenstand im Heft.
+ */
+if (PHP_SAPI !== 'cli') {
+    exit(1);
+}
+
+require dirname(__DIR__) . '/app/bootstrap.php';
+
+$slug = trim((string) ($argv[1] ?? ''));
+$unpublish = in_array('--entwurf', $argv, true);
+
+if ($slug === '' || str_starts_with($slug, '--')) {
+    fwrite(STDERR, "Nutzung: php bin/stadionzeitung-publish.php <slug> [--entwurf]\n");
+    exit(1);
+}
+
+$log = static function (string $msg, string $level = 'INFO'): void {
+    log_write('stadionzeitung', $level, $msg);
+    echo '[' . date('c') . "] {$level}  {$msg}\n";
+};
+
+$cacheFile = DATA_PATH . '/stadionzeitung.json';
+$data = is_file($cacheFile)
+    ? (json_decode((string) file_get_contents($cacheFile), true) ?: ['issues' => []])
+    : ['issues' => []];
+
+$found = false;
+foreach ($data['issues'] as &$issue) {
+    if (($issue['slug'] ?? '') !== $slug) {
+        continue;
+    }
+    $found = true;
+
+    if ($unpublish) {
+        $issue['status'] = 'entwurf';
+        unset($issue['snapshot']);
+        $log("Ausgabe '{$slug}' zurückgezogen — Status Entwurf, Snapshot verworfen (Live-Seiten rechnen wieder frisch).");
+        break;
+    }
+
+    if (($issue['status'] ?? 'veroeffentlicht') === 'veroeffentlicht' && isset($issue['snapshot'])) {
+        $log("Ausgabe '{$slug}' ist bereits veröffentlicht — nichts zu tun. Zum Neu-Einfrieren erst mit --entwurf zurückziehen.", 'WARN');
+        exit(0);
+    }
+
+    $snapshot = stadionzeitung_build_snapshot($issue);
+    $issue['snapshot'] = $snapshot;
+    $issue['status'] = 'veroeffentlicht';
+    $issue['published_at'] = date('c');
+
+    $tables = implode(', ', array_keys($snapshot['tabellen'] ?? []));
+    $log("Ausgabe '{$slug}' veröffentlicht — eingefroren: Tabellen [{$tables}], "
+        . count($snapshot['ergebnisse'] ?? []) . ' Ergebnis-Blöcke, '
+        . count($snapshot['vorschau'] ?? []) . ' Vorschau-Spiele, '
+        . count($snapshot['news'] ?? []) . ' News.');
+    break;
+}
+unset($issue);
+
+if (!$found) {
+    $known = implode(', ', array_column($data['issues'], 'slug'));
+    fwrite(STDERR, "Unbekannter Slug '{$slug}'. Bekannt: {$known}\n");
+    exit(1);
+}
+
+$payload = json_encode($data, JSON_PRETTY_PRINT | JSON_UNESCAPED_SLASHES | JSON_UNESCAPED_UNICODE);
+$tmp = $cacheFile . '.tmp';
+file_put_contents($tmp, $payload);
+rename($tmp, $cacheFile);
+
+echo $unpublish
+    ? "Fertig: /stadionzeitung/{$slug} ist wieder ein Entwurf.\n"
+    : "Fertig: /stadionzeitung/{$slug} ist veröffentlicht und eingefroren.\n";