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/matchcenter-sync.php

@@ -21,14 +21,18 @@ declare(strict_types=1);
  * Ohne Browser-typischen User-Agent antwortet der Host mit HTTP 418 — der $fetch-Helfer
  * setzt ihn (wie bin/instagram-sync.php).
  */
-if (PHP_SAPI !== 'cli') {
+// Nur CLI — oder der authentifizierte Cron-Endpoint public/cron.php, der CRON_HTTP
+// setzt (der Tarif kennt keine Cronjobs, siehe CLAUDE.md: Ausnahme zu Regel 3).
+if (PHP_SAPI !== 'cli' && !defined('CRON_HTTP')) {
     exit(1);
 }
 
-require dirname(__DIR__) . '/app/bootstrap.php';
+// require_once, weil cron.php den Bootstrap schon geladen hat: app/bootstrap.php
+// definiert Konstanten und lädt helpers.php, ein zweiter Durchlauf wäre ein Fatal.
+require_once dirname(__DIR__) . '/app/bootstrap.php';
 
-$verbose = in_array('-v', $argv, true);
-$dump    = in_array('--dump', $argv, true);
+$verbose = in_array('-v', $argv ?? [], true);
+$dump    = in_array('--dump', $argv ?? [], true);
 
 $apiHost   = 'https://widget-prod.bfv.de';
 $crestBase = 'https://app.bfv.de/export.media/-/action/getLogo/format/0/id/';
@@ -61,16 +65,17 @@ $competitionLabels = [
     'Hallenrunde'          => 'Halle',
 ];
 
-$log = static function (string $msg) use ($verbose): void {
-    $line = '[' . date('c') . "] {$msg}\n";
-    file_put_contents(STORAGE_PATH . '/logs/matchcenter.log', $line, FILE_APPEND);
+// Schreibt über die zentrale log_write() (helpers.php) nach storage/logs/matchcenter.log;
+// ERROR landet zusätzlich in error.log. Mit -v zusätzlich auf stdout.
+$log = static function (string $msg, string $level = 'INFO') use ($verbose): void {
+    log_write('matchcenter', $level, $msg);
     if ($verbose) {
-        echo $line;
+        echo '[' . date('c') . "] {$level}  {$msg}\n";
     }
 };
 
 $fail = static function (string $msg) use ($log): never {
-    $log("FEHLER: {$msg} — bestehender Cache bleibt unangetastet.");
+    $log("{$msg} — bestehender Cache bleibt unangetastet.", 'ERROR');
     exit(1);
 };
 
@@ -81,7 +86,9 @@ if ($teamsCfg === []) {
 // --- Lock gegen parallele Läufe ---
 $lock = fopen(STORAGE_PATH . '/cache/matchcenter.lock', 'c');
 if (!$lock || !flock($lock, LOCK_EX | LOCK_NB)) {
-    $fail('Läuft bereits (Lock belegt)');
+    // Kein ERROR: ein überlappender Cron-Lauf ist kein Ausfall, der nächste Takt holt es nach.
+    $log('Läuft bereits (Lock belegt) — Lauf übersprungen.', 'WARN');
+    exit(1);
 }
 
 // --- HTTP-Helfer mit Browser-typischen Headern (gegen HTTP 418) ---
@@ -115,7 +122,7 @@ $fetchJson = static function (string $url) use ($fetch, $dump, $log): ?array {
         return null;
     }
     if ($dump) {
-        $log("DUMP {$url}\n" . substr($body, 0, 4000));
+        echo "DUMP {$url}\n" . substr($body, 0, 4000) . "\n";
     }
     $data = json_decode($body, true);
     return is_array($data) ? $data : null;
@@ -139,12 +146,12 @@ $downloadCrest = static function (?string $clubId) use ($fetch, $crestBase, $cre
     }
     $bin = $fetch($crestBase . $clubId, false);
     if ($bin === false) {
-        $log("Wappen-Download fehlgeschlagen: {$clubId}");
+        $log("Wappen-Download fehlgeschlagen: {$clubId}", 'WARN');
         return null;
     }
     $src = @imagecreatefromstring($bin);
     if ($src === false) {
-        $log("Wappen unlesbar: {$clubId}");
+        $log("Wappen unlesbar: {$clubId}", 'WARN');
         return null;
     }
     $w = imagesx($src);
@@ -277,7 +284,7 @@ foreach ($teamsCfg as $cfg) {
     $teamCfgId = (string) ($cfg['team_id'] ?? '');
     $cfgCompoundId = (string) ($cfg['compound_id'] ?? '');
     if ($key === '' || $teamCfgId === '') {
-        $log("Team-Eintrag ohne key/team_id übersprungen");
+        $log("Team-Eintrag ohne key/team_id übersprungen", 'WARN');
         continue;
     }
     $prevTeam = $prevByKey[$key] ?? null;
@@ -325,6 +332,13 @@ foreach ($teamsCfg as $cfg) {
             $upcoming = [];
             $results = [];
             foreach ($matches as $m) {
+                // Spielfreie Runden führt der BFV als Pseudo-Begegnung gegen
+                // "SPIELFREI" — kein echtes Spiel, gehört weder in "Nächste
+                // Spiele" noch in Ergebnisse (tauchte sonst bis in den
+                // Startseiten-Hero und die Stadionzeitung durch).
+                if (($m['homeTeamName'] ?? '') === 'SPIELFREI' || ($m['guestTeamName'] ?? '') === 'SPIELFREI') {
+                    continue;
+                }
                 $hasResult = trim((string) ($m['result'] ?? '')) !== '';
                 $row = $mapMatch($m, $teamCfgId);
                 if ($hasResult) {
@@ -360,7 +374,7 @@ foreach ($teamsCfg as $cfg) {
             $cacheFallbackUsed = true;
             $keepCrests($upcoming);
             $keepCrests($results);
-            $log("Team {$key}: Spiele-Fetch fehlgeschlagen — alter Cache übernommen");
+            $log("Team {$key}: Spiele-Fetch fehlgeschlagen — alter Cache übernommen", 'WARN');
         }
 
         // --- Tabellen-Teil ---
@@ -406,7 +420,7 @@ foreach ($teamsCfg as $cfg) {
             $table = $prevTeam['table'] ?? [];
             $cacheFallbackUsed = true;
             $keepCrests($table);
-            $log("Team {$key}: Tabellen-Fetch fehlgeschlagen — alte Tabelle übernommen");
+            $log("Team {$key}: Tabellen-Fetch fehlgeschlagen — alte Tabelle übernommen", 'WARN');
         }
 
         // Aktuelle Saison immer zeigen, solange der Spiele-Fetch erfolgreich war (auch wenn
@@ -416,7 +430,7 @@ foreach ($teamsCfg as $cfg) {
         $hasPrevious = $previous !== null
             && (($previous['last_results'] ?? []) !== [] || ($previous['table'] ?? []) !== []);
         if (!$hasCurrent && $matchesData === null && !$hasPrevious) {
-            $log("Team {$key}: keine Daten (API leer, kein Cache) — übersprungen");
+            $log("Team {$key}: keine Daten (API leer, kein Cache) — übersprungen", 'WARN');
             continue;
         }
 
@@ -448,7 +462,7 @@ foreach ($teamsCfg as $cfg) {
             . ($hasPrevious ? ' (+ Vorsaison archiviert)' : ''));
     } catch (\Throwable $e) {
         // Ein fehlschlagendes Team darf die anderen nicht killen — alten Block behalten.
-        $log("Team {$key} übersprungen: " . $e->getMessage());
+        $log("Team {$key} übersprungen: " . $e->getMessage(), 'WARN');
         if ($prevTeam !== null) {
             $resultTeams[] = $prevTeam;
             $cacheFallbackUsed = true;