Fassung 1.4.3: Update ohne Git, Verwaltung auf dem Telefon, eigene Symbole

Vier Wuensche und ein Fund beim Nachmessen.

- Farbwaehler im Designbereich. Das Textfeld bleibt massgeblich, damit
  "@akzent" ein Verweis auf die Palette bleibt und nicht beim ersten
  Klick zu einem festen Hexwert erstarrt (ADR 066).
- Die Verwaltung auf dem Telefon: das Menue klappt unter 760 px zu und
  nennt den Bereich, in dem man steht; Ziele 44 px, kein Skript.
- Eigene SVG-Symbole statt Unicode-Zeichen - ein Telefon ersetzt die
  sonst durch Emoji in fremdem Stil. Zwei Eintraege trugen dabei
  denselben Pfad; ein Test findet beides (ADR 067).
- Update aus dem Releasearchiv: der Weg fuer Installationen ohne Git.
  Zwei Schritte, weil ein Prozess, der sich selbst ausgetauscht hat,
  mit dem alten Code weiterarbeitet. var/, .env, hochgeladene
  Schriften und das erzeugte Buendel bleiben unberuehrt; public/ wird
  dazu Datei fuer Datei zusammengefuehrt. Geprueft ohne Netz gegen
  eine Releaseseite im Speicher (ADR 068).

Beim Nachmessen der echten Startseite statt einer Testseite: das
groesste Element ueber der Falz ist dort kein <img>, sondern der
Hintergrund des ersten Abschnitts - und der steht nur im Stylesheet.
Drei Vorabverweise mit denselben Geraetegrenzen wie der Compiler holen
genau die Variante, die die Regel auch nimmt. LCP 1,3 s -> 1,1 s.
Dabei gefunden: dasselbe Bild wurde je Geraeteregel neu abgefragt -
Startseite 19 -> 15 Abfragen (ADR 069).

Geprueft: 428 Tests auf PHP 8.2 und 8.4, Editor-, Browser- und
Linkpruefung, Lighthouse auf drei echten Seiten (alles ausser der
Leistung der Startseite 100).

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

src/Controller/PageController.php

@@ -106,6 +106,9 @@ final class PageController extends AbstractController
                 // im ersten Abschnitt des Inhalts: ein Bild weiter unten waere die falsche
                 // Eile, und das Logo im Kopfbereich ist klein und laedt ohnehin sofort.
                 'eagerImage' => $this->firstImage(['blocks' => array_slice($page['document']['blocks'] ?? [], 0, 1)]),
+                // Und das Gegenstueck fuer den haeufigeren Fall: Das grosse Bild ueber der Falz
+                // ist gar kein Bild, sondern der Hintergrund des ersten Abschnitts.
+                'heroBackground' => $this->heroBackground($areas['header'] ?? null, $page['document']),
                 'pageStyles' => $styles,
                 'googleFonts' => $googleFonts,
                 'localFonts' => $localFonts,
@@ -539,6 +542,49 @@ final class PageController extends AbstractController
      * That one must not be lazy: it is usually the largest thing above the fold, and deferring it
      * delays exactly the pixel a visitor waits for. Everything below it stays lazy.
      */
+    /**
+     * Das Hintergrundbild des ersten Abschnitts, um es vorab zu holen.
+     *
+     * Gemessen an der Startseite des Piloten: Das groesste Element ueber der Falz ist dort kein
+     * `<img>`, sondern der Hintergrund des Heros. Ein Hintergrundbild steht im Stylesheet, und
+     * das kommt nach dem HTML - der Browser erfaehrt also erst vom Bild, wenn er das CSS geparst
+     * hat. Lighthouse nennt das „LCP request discovery"; gemessen 1,3 s statt 0,9 s.
+     *
+     * Vorab geholt wird **genau die Variante, die das Stylesheet auch nimmt**: drei Verweise mit
+     * denselben Grenzen wie der Compiler, nicht ein `imagesrcset`. Ein `srcset` waehlt nach
+     * Breite, die Regeln waehlen nach Geraet; wo beide auseinanderlaufen, laedt der Browser zwei
+     * Bilder statt einem - und dann kostet das Vorabholen mehr, als es bringt.
+     *
+     * @return list<array{src: string, media: string}>
+     */
+    private function heroBackground(?array $header, array $document): array
+    {
+        // Steht ueber dem Inhalt ein Kopfbereich mit eigenem Hintergrundbild, ist dessen Bild das
+        // obere. Sonst der erste Abschnitt des Dokuments.
+        foreach ([$header, $document] as $kandidat) {
+            $block = ($kandidat['blocks'] ?? [])[0] ?? null;
+            $id = $block['style']['desktop']['backgroundImage'] ?? null;
+            if (!is_string($id) || '' === $id) {
+                continue;
+            }
+            $item = $this->media->find($id);
+            if (null === $item || [] === ($item['variants'] ?? [])) {
+                continue;
+            }
+            $verweise = [];
+            foreach (StyleCompiler::PRELOAD_DEVICES as $device => $media) {
+                $verweise[] = [
+                    'src' => StyleCompiler::variantFor($item['variants'], $device)['src'],
+                    'media' => $media,
+                ];
+            }
+
+            return $verweise;
+        }
+
+        return [];
+    }
+
     private function firstImage(array ...$documents): ?string
     {
         foreach ($documents as $document) {

src/Controller/SettingsController.php

@@ -8,6 +8,7 @@ use App\Content\MediaLibrary;
 use App\Content\PageRepository;
 use App\Content\RedirectRepository;
 use App\Content\SiteSettings;
+use App\Content\Theme;
 use App\Domain\InvalidPage;
 use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
 use Symfony\Component\HttpFoundation\Request;
@@ -16,7 +17,7 @@ use Symfony\Component\Routing\Attribute\Route;
 
 final class SettingsController extends AbstractController
 {
-    public function __construct(private SiteSettings $settings, private RedirectRepository $redirects, private PageRepository $pages, private MediaLibrary $media)
+    public function __construct(private SiteSettings $settings, private RedirectRepository $redirects, private PageRepository $pages, private MediaLibrary $media, private Theme $theme)
     {
     }
 
@@ -41,6 +42,8 @@ final class SettingsController extends AbstractController
             'consentGroupHelp' => Consent::GROUP_HELP,
             // Für das Symbol der Website: die Mediathek zur Auswahl, die neuesten zuerst.
             'images' => $this->media->page(1, false, 96)['items'],
+            // Fuer die Farbfelder: dieselbe Palette, die auch der Editor anbietet.
+            'palette' => $this->theme->load()['colors'],
         ]);
     }
 

src/Controller/SystemController.php

@@ -3,7 +3,9 @@
 namespace App\Controller;
 
 use App\Domain\InvalidPage;
+use App\Ops\ArchiveUpdate;
 use App\Ops\Backup;
+use App\Ops\Installation;
 use App\Ops\Updater;
 use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
 use Symfony\Component\HttpFoundation\Request;
@@ -19,7 +21,7 @@ use Symfony\Component\Routing\Attribute\Route;
  */
 final class SystemController extends AbstractController
 {
-    public function __construct(private Updater $updater, private Backup $backup, private string $adminPath)
+    public function __construct(private Updater $updater, private Backup $backup, private ArchiveUpdate $archive, private Installation $installation, private string $adminPath)
     {
     }
 
@@ -39,9 +41,50 @@ final class SystemController extends AbstractController
             'steps' => $request->getSession()->remove('update_steps') ?: [],
             'backups' => $this->backup->all(),
             'adminPath' => $this->adminPath,
+            // Der Weg ohne Git: das Releasearchiv. Auf geteiltem Hosting ist das der einzige.
+            'archiveVersion' => $request->query->getBoolean('pruefen') ? $this->archive->updateAvailable() : null,
+            'archivePending' => $this->archive->pending(),
         ]);
     }
 
+    /**
+     * Update über das Releasearchiv - für Installationen, die kein Git kennen.
+     *
+     * Zwei Schritte, und zwar mit Absicht: Der erste ersetzt die Dateien, der zweite führt die
+     * Migrationen aus. Dazwischen liegt eine neue Anfrage, denn erst die startet mit dem Code der
+     * neuen Fassung; ein Prozess, der sich selbst ausgetauscht hat, arbeitet mit dem alten weiter.
+     */
+    #[Route('/%kant.admin_path%/system/archiv', name: 'admin_system_archive', methods: ['POST'])]
+    public function archive(Request $request): Response
+    {
+        $this->denyAccessUnlessGranted('ROLE_ADMIN');
+        if (!$this->isCsrfTokenValid('system', $request->request->getString('_csrf_token'))) {
+            return $this->back('Deine Sitzung ist abgelaufen. Bitte melde dich erneut an.');
+        }
+        @set_time_limit(0);
+        if ($request->request->getBoolean('finish')) {
+            $ergebnis = $this->archive->finish($this->installation);
+            $request->getSession()->set('update_steps', $ergebnis['steps']);
+            $this->addFlash($ergebnis['ok'] ? 'success' : 'error', $ergebnis['ok']
+                ? 'Das Update ist fertig. Die Website ist wieder erreichbar.'
+                : 'Die Migrationen sind fehlgeschlagen. Die Website bleibt im Wartungszustand.');
+
+            return $this->redirectToRoute('admin_system');
+        }
+        $ergebnis = $this->archive->run($request->request->getString('target') ?: null);
+        $request->getSession()->set('update_steps', $ergebnis['steps']);
+        if ($ergebnis['migrate'] ?? false) {
+            $this->addFlash('success', 'Die Dateien sind ersetzt. Jetzt noch die Migrationen - der Knopf steht oben.');
+
+            return $this->redirectToRoute('admin_system');
+        }
+        $this->addFlash($ergebnis['ok'] ? 'success' : 'error', $ergebnis['ok']
+            ? 'Es war nichts einzuspielen.'
+            : 'Das Update ist nicht durchgelaufen. Die Schritte stehen unten.');
+
+        return $this->redirectToRoute('admin_system');
+    }
+
     #[Route('/%kant.admin_path%/system/update', name: 'admin_system_update', methods: ['POST'])]
     public function update(Request $request): Response
     {