Kopf, Fuß und verknüpfte Sektionen als Blockdokumente (Paket G, Teil 1)

Migration 20260912001000 legt die Tabelle partial an: Blockdokumente,
die keine Seiten sind. Kopf- und Fußbereich je einmal,
wiederverwendbare Sektionen beliebig viele - im selben Editor
gestaltbar wie eine Seite, weil der Editor seine Schnittstelle aus
einem Datenattribut nimmt statt sie fest zu kennen.

Im Template steht keine Marke und keine Navigation mehr. Ein neuer
Block menu zeigt einen Menüplatz; die Einträge bleiben in der
Menüverwaltung.

Eine Seite braucht genau eine Hauptüberschrift, ein geteilter Bereich
keine - sonst hätte jede Seite, die ihn trägt, zwei. Geteilte
Bereiche haben keinen Entwurf und keine Veröffentlichung: sie sind
überall sichtbar, gespeichert heißt live.

Verknüpft statt kopiert: partialref speichert nur die Adresse, die
Blöcke bleiben im Bereich, und eine Änderung erreicht jede Seite, die
sie einbindet. Zyklen abgewiesen, Verschachtelung auf drei Ebenen
begrenzt, eine entfernte Sektion hinterlässt keine Lücke und der
Verweis bleibt erhalten. Die Abschnittsvorlagen kopieren weiterhin.

Ein echter Fehler kam dabei heraus, der jede dunkle Sektion mit
Spalten betraf: .block-column>.block-text:first-child setzt eine
Farbe für helle Hintergründe und gewinnt auf Spezifität gegen
.tone-ink - gemessen 1,87:1.

Geprüft: 165 PHP-Tests / 660 Assertions unter PHP 8.2.12 und 8.4.22,
15 JavaScript-Modelltests, Editortest mit axe ohne Verstöße,
öffentliche Browserprüfung, Migration nach Backup angewendet.

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

src/Controller/PageController.php

@@ -5,6 +5,7 @@ namespace App\Controller;
 use App\Content\FormRepository;
 use App\Content\MenuRepository;
 use App\Content\PageRepository;
+use App\Content\PartialRepository;
 use App\Content\PostRepository;
 use App\Content\RedirectRepository;
 use App\Content\SiteSettings;
@@ -17,7 +18,7 @@ use Symfony\Component\Routing\Attribute\Route;
 
 final class PageController extends AbstractController
 {
-    public function __construct(private PageRepository $pages, private MenuRepository $menus, private PostRepository $posts, private FormRepository $forms, private RedirectRepository $redirects, private SiteSettings $settings, private Theme $theme, private StyleCompiler $styles, private string $secret, private string $siteOrigin)
+    public function __construct(private PageRepository $pages, private MenuRepository $menus, private PostRepository $posts, private FormRepository $forms, private RedirectRepository $redirects, private SiteSettings $settings, private PartialRepository $partials, private Theme $theme, private StyleCompiler $styles, private string $secret, private string $siteOrigin)
     {
     }
 
@@ -38,10 +39,15 @@ final class PageController extends AbstractController
         $page = $this->pages->findPublished($path);
         $styles = '';
         $googleFonts = null;
+        $areas = $this->areas();
         if (null !== $page) {
             $theme = $this->theme->load();
             // Theme first, block styles after, so a block always wins over the site defaults.
+            $sections = $this->sections($page['document'], $areas);
             $styles = $this->theme->css($theme).$this->styles->compileDocument($page['document']);
+            foreach ([...array_values($areas), ...array_values($sections)] as $extra) {
+                $styles .= $this->styles->compileDocument($extra);
+            }
             $googleFonts = $this->theme->googleFontsUrl($theme);
         }
         if (null === $page) {
@@ -50,7 +56,7 @@ final class PageController extends AbstractController
             if (null !== $redirect && 301 === $redirect['status']) {
                 return $this->shell($this->redirect('/'.$redirect['to'], 301));
             }
-            $response = $this->render('not-found.html.twig', [], new Response(status: null !== $redirect ? 410 : 404));
+            $response = $this->render('not-found.html.twig', ['areas' => $areas], new Response(status: null !== $redirect ? 410 : 404));
         } else {
             $response = $this->render('page.html.twig', [
                 'page' => $page,
@@ -62,6 +68,8 @@ final class PageController extends AbstractController
                 'forms' => $this->formStates($page, $request->query->getString('gesendet')),
                 'breadcrumbs' => $this->breadcrumbs($page),
                 'structuredData' => $this->structuredData($page),
+                'areas' => $areas,
+                'sections' => $sections,
                 'pageStyles' => $styles,
                 'googleFonts' => $googleFonts,
             ]);
@@ -240,6 +248,8 @@ final class PageController extends AbstractController
         $base = null === $term ? '/beitraege' : '/'.PostRepository::ARCHIVE_PREFIX[$kind].'/'.$term['slug'];
 
         return $this->shell($this->render('archive.html.twig', [
+            'areas' => $this->areas(),
+            'navigation' => $this->navigation(''),
             'term' => $term,
             'heading' => null === $term ? 'Beiträge' : $term['name'],
             'result' => $result,
@@ -291,6 +301,58 @@ final class PageController extends AbstractController
         return $lists;
     }
 
+    /**
+     * The header and footer documents. Absent areas simply render nothing, so a site without a
+     * header is a valid site rather than a broken one.
+     *
+     * @return array<string, array>
+     */
+    private function areas(): array
+    {
+        $areas = [];
+        foreach (['header', 'footer'] as $kind) {
+            $partial = $this->partials->findByKind($kind);
+            if (null !== $partial) {
+                $areas[$kind] = $partial['document'];
+            }
+        }
+
+        return $areas;
+    }
+
+    /**
+     * Resolves every linked section a page or one of its areas refers to, including sections that
+     * link further sections. A missing section is left out; the renderer shows a placeholder only
+     * in the editor, so a visitor never sees a gap explained.
+     *
+     * @return array<string, array>
+     */
+    private function sections(array $document, array $areas): array
+    {
+        $resolved = [];
+        $pending = $this->partials->referencedSlugs($document);
+        foreach ($areas as $area) {
+            $pending = [...$pending, ...$this->partials->referencedSlugs($area)];
+        }
+        for ($depth = 0; $depth < PartialRepository::MAX_NESTING && [] !== $pending; ++$depth) {
+            $next = [];
+            foreach (array_unique($pending) as $slug) {
+                if (isset($resolved[$slug])) {
+                    continue;
+                }
+                $section = $this->partials->resolveSection($slug);
+                if (null === $section) {
+                    continue;
+                }
+                $resolved[$slug] = $section['document'];
+                $next = [...$next, ...$this->partials->referencedSlugs($section['document'])];
+            }
+            $pending = $next;
+        }
+
+        return $resolved;
+    }
+
     /**
      * @return array<string, list<array>>
      */