Veröffentlichen friert auch die Bilder ein

Der Snapshot fror die Daten ein, verwies aber weiter auf Ordner, die die
Sync-Skripte verwalten: matchcenter-sync räumt Wappen weg, die der BFV nicht mehr
führt (eine Saison), instagram-sync ältere Posts (Wochen). Am 31.07.2026
nachgewiesen — ein Lauf löschte 18 Wappen und 3 Bilder. Eine archivierte Ausgabe
wäre also mit der Zeit von selbst zerfallen, und "gedruckt = fixiert" war damit
nur die halbe Wahrheit.

bin/stadionzeitung-publish.php kopiert jetzt alles, worauf der Snapshot zeigt
(img/crests, img/instagram, img/news), als fix-* in den Ausgaben-Ordner und
schreibt die Pfade um. Varianten-Sets {base, widths} werden über alle Breiten
kopiert und nur umgeschrieben, wenn alle da sind — ein halbes srcset wäre
schlimmer als der alte Pfad; genau daran fiel img/news/neue-website beim ersten
Versuch auf. --entwurf löscht die fix-*-Dateien wieder, sie gehören zum Snapshot.
Flache Dateinamen statt Unterordner, weil die Aufräum-Logik in
stadionzeitung-add.php nur Dateien entfernt und ein Unterordner als Waise bliebe.

bin/preflight.php warnt, wenn eine veröffentlichte Ausgabe noch auf die
flüchtigen Ordner zeigt — sonst verfiele sie still.

Geprüft am Hutschdorf-Heft: 39 Dateien eingefroren, Snapshot verweist nur noch
auf den Ausgaben-Ordner, 88 Bilder in Viewer und Druckfassung erreichbar, keins
fehlt, preflight-Warnung verschwindet. Der Testlauf wurde danach zurückgenommen:
der lokale Matchcenter-Stand ist einen Tag alt, eingefroren wird auf dem Server
nach dem letzten Sync vor dem Druck.

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

bin/stadionzeitung-publish.php

@@ -38,6 +38,112 @@ $log = static function (string $msg, string $level = 'INFO'): void {
     echo '[' . date('c') . "] {$level}  {$msg}\n";
 };
 
+/**
+ * Bilder, auf die der Snapshot zeigt, in den Ausgaben-Ordner kopieren und die Pfade
+ * darin umschreiben. Damit ist eine veröffentlichte Ausgabe wirklich eingefroren.
+ *
+ * Warum das nötig ist: der Snapshot friert die DATEN ein, verwies aber weiter auf
+ * Ordner, die die Sync-Skripte verwalten. bin/matchcenter-sync.php räumt Wappen weg,
+ * die der BFV nicht mehr führt, bin/instagram-sync.php ältere Posts — am 31.07.2026
+ * nachgewiesen: ein Lauf löschte 18 Wappen und 3 Instagram-Bilder. Bei den Wappen
+ * dauert das eine Saison, bei Instagram Wochen. Danach zeigte eine archivierte
+ * Ausgabe Lücken, und „gedruckt = fixiert" wäre nur die halbe Wahrheit.
+ *
+ * img/news wird mit eingefroren, obwohl News-Bilder nicht maschinenverwaltet sind:
+ * ein Artikelbild kann im Chat ersetzt werden, und dann änderte sich nachträglich
+ * eine gedruckte Ausgabe. Dieselbe Begründung, derselbe Handgriff.
+ *
+ * Fehlt eine Quelldatei (schon weggeräumt), bleibt der Pfad stehen und es gibt eine
+ * WARN — die crest-Komponente fällt auf Initialen zurück, ein fehlendes Bild darf
+ * das Veröffentlichen nicht verhindern.
+ */
+$freezeAssets = static function (array $snapshot, string $slug, callable $log): array {
+    $quellen = ['img/crests/', 'img/instagram/', 'img/news/'];
+    // Präfix je Quellordner, damit zwei gleichnamige Dateien sich nicht überschreiben
+    // und man im Ausgaben-Ordner sofort sieht, woher eine Datei kommt.
+    $praefix = ['img/crests/' => 'fix-wappen-', 'img/instagram/' => 'fix-insta-', 'img/news/' => 'fix-news-'];
+    $zielDir = PUBLIC_PATH . '/assets/img/stadionzeitung/' . $slug;
+    if (!is_dir($zielDir)) {
+        mkdir($zielDir, 0755, true);
+    }
+
+    $kopiert = [];
+    $fehlend = [];
+
+    $walk = static function (&$node) use (&$walk, $quellen, $praefix, $zielDir, $slug, &$kopiert, &$fehlend): void {
+        if (is_array($node)) {
+            // Varianten-Set {base, widths, ext?} zuerst: `base` ist KEIN Dateipfad,
+            // sondern ein Stamm ohne Endung — jede Breite ist eine eigene Datei.
+            // Ohne diesen Zweig lief img/news/neue-website als „Quelldatei fehlt" auf.
+            if (isset($node['base'], $node['widths']) && is_string($node['base']) && is_array($node['widths'])) {
+                foreach ($quellen as $ordner) {
+                    if (!str_starts_with($node['base'], $ordner)) {
+                        continue;
+                    }
+                    $ext = strtolower((string) ($node['ext'] ?? 'jpg'));
+                    $neuStamm = $praefix[$ordner] . basename($node['base']);
+                    $alleDa = true;
+                    foreach ($node['widths'] as $w) {
+                        $von = PUBLIC_PATH . "/assets/{$node['base']}-{$w}.{$ext}";
+                        if (!is_file($von)) {
+                            $fehlend["{$node['base']}-{$w}.{$ext}"] = true;
+                            $alleDa = false;
+                            continue;
+                        }
+                        copy($von, "{$zielDir}/{$neuStamm}-{$w}.{$ext}");
+                        $kopiert["{$node['base']}-{$w}.{$ext}"] = true;
+                    }
+                    // Nur umschreiben, wenn ALLE Breiten kopiert sind — ein halbes
+                    // srcset wäre schlimmer als der alte Pfad.
+                    if ($alleDa) {
+                        $node['base'] = "img/stadionzeitung/{$slug}/{$neuStamm}";
+                    }
+                    return;
+                }
+            }
+            foreach ($node as &$wert) {
+                $walk($wert);
+            }
+            return;
+        }
+        if (!is_string($node)) {
+            return;
+        }
+        foreach ($quellen as $ordner) {
+            if (!str_starts_with($node, $ordner)) {
+                continue;
+            }
+            $datei = basename($node);
+            $neu = $praefix[$ordner] . $datei;
+            $ziel = "{$zielDir}/{$neu}";
+            if (!isset($kopiert[$node])) {
+                $von = PUBLIC_PATH . '/assets/' . $node;
+                if (!is_file($von)) {
+                    $fehlend[$node] = true;
+                    return; // Pfad unverändert lassen — besser ein Fallback als ein toter Link
+                }
+                copy($von, $ziel);
+                $kopiert[$node] = true;
+            }
+            $node = "img/stadionzeitung/{$slug}/{$neu}";
+            return;
+        }
+    };
+    $walk($snapshot);
+
+    $log(sprintf(
+        'Bilder eingefroren: %d Dateien in img/stadionzeitung/%s/ kopiert%s.',
+        count($kopiert),
+        $slug,
+        $fehlend === [] ? '' : ', ' . count($fehlend) . ' Quelldatei(en) fehlten schon'
+    ));
+    foreach (array_keys($fehlend) as $f) {
+        $log("Quelldatei für den Snapshot fehlt, Pfad unverändert: {$f}", 'WARN');
+    }
+
+    return $snapshot;
+};
+
 $cacheFile = DATA_PATH . '/stadionzeitung.json';
 $data = is_file($cacheFile)
     ? (json_decode((string) file_get_contents($cacheFile), true) ?: ['issues' => []])
@@ -53,7 +159,16 @@ foreach ($data['issues'] as &$issue) {
     if ($unpublish) {
         $issue['status'] = 'entwurf';
         unset($issue['snapshot']);
-        $log("Ausgabe '{$slug}' zurückgezogen — Status Entwurf, Snapshot verworfen (Live-Seiten rechnen wieder frisch).");
+        // Die eingefrorenen Bilder gehören zum Snapshot und gehen mit ihm. Sonst
+        // lägen sie als Waisen im Ausgaben-Ordner und ein erneutes Veröffentlichen
+        // legte daneben eine zweite Fassung ab.
+        $weg = 0;
+        foreach (glob(PUBLIC_PATH . "/assets/img/stadionzeitung/{$slug}/fix-*") ?: [] as $f) {
+            if (is_file($f) && unlink($f)) {
+                $weg++;
+            }
+        }
+        $log("Ausgabe '{$slug}' zurückgezogen — Status Entwurf, Snapshot verworfen, {$weg} eingefrorene Bilder entfernt (Live-Seiten rechnen wieder frisch).");
         break;
     }
 
@@ -63,6 +178,9 @@ foreach ($data['issues'] as &$issue) {
     }
 
     $snapshot = stadionzeitung_build_snapshot($issue);
+    // Erst die Bilder sichern, dann den Snapshot ablegen: die Pfade darin zeigen
+    // danach in den Ausgaben-Ordner und sind vom Sync unabhängig.
+    $snapshot = $freezeAssets($snapshot, $slug, $log);
     $issue['snapshot'] = $snapshot;
     $issue['status'] = 'veroeffentlicht';
     $issue['published_at'] = date('c');