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/PartialController.php

@@ -0,0 +1,206 @@
+<?php
+
+namespace App\Controller;
+
+use App\Content\DocumentValidator;
+use App\Content\MenuRepository;
+use App\Content\PartialRepository;
+use App\Content\StyleCompiler;
+use App\Content\Theme;
+use App\Domain\InvalidDocument;
+use App\Domain\InvalidPage;
+use App\Domain\StaleWrite;
+use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
+use Symfony\Component\HttpFoundation\JsonResponse;
+use Symfony\Component\HttpFoundation\Request;
+use Symfony\Component\HttpFoundation\Response;
+use Symfony\Component\Routing\Attribute\Route;
+use Symfony\Component\Security\Csrf\CsrfTokenManagerInterface;
+
+/**
+ * Header, footer and reusable sections in the same editor as a page.
+ *
+ * The editor front end takes its API base from a data attribute, so it works against pages and
+ * against areas without a second implementation. Areas have no draft and no publication: they are
+ * shared, so a saved change is live. The editor hides the publish button for them.
+ */
+#[Route('/admin/partials')]
+final class PartialController extends AbstractController
+{
+    public function __construct(
+        private PartialRepository $partials,
+        private DocumentValidator $validator,
+        private MenuRepository $menus,
+        private Theme $theme,
+        private StyleCompiler $styles,
+        private CsrfTokenManagerInterface $csrf,
+    ) {
+    }
+
+    #[Route('', name: 'admin_partials', methods: ['GET'])]
+    public function index(): Response
+    {
+        $partials = [];
+        foreach ($this->partials->all() as $partial) {
+            $partial['usedBy'] = 'section' === $partial['kind'] ? $this->partials->usedBy($partial['slug']) : [];
+            $partials[] = $partial;
+        }
+
+        return $this->render('admin/partials.html.twig', ['partials' => $partials, 'kinds' => PartialRepository::KINDS]);
+    }
+
+    #[Route('/new', name: 'admin_partial_create', methods: ['POST'])]
+    public function create(Request $request): Response
+    {
+        $this->denyAccessUnlessGranted('ROLE_EDITOR');
+        if (!$this->isCsrfTokenValid('partials', $request->request->getString('_csrf_token'))) {
+            return $this->back('Deine Sitzung ist abgelaufen. Bitte melde dich erneut an.');
+        }
+        $name = trim($request->request->getString('name'));
+        try {
+            $id = $this->partials->create(
+                $request->request->getString('kind', 'section'),
+                $request->request->getString('slug') ?: $this->slugify($name),
+                $name,
+                // A shared area starts with one empty section, so there is something to click on.
+                ['schemaVersion' => 11, 'title' => '' === $name ? 'Bereich' : $name, 'description' => 'Wird an jeder Stelle gezeigt, die ihn einbindet.', 'blocks' => [
+                    ['id' => 'b_'.bin2hex(random_bytes(8)), 'type' => 'section', 'layout' => ['tone' => 'paper', 'width' => 'normal'], 'children' => []],
+                ]],
+            );
+        } catch (InvalidPage|InvalidDocument $e) {
+            return $this->back($e->getMessage());
+        }
+
+        return $this->redirectToRoute('admin_partial_editor', ['id' => $id]);
+    }
+
+    #[Route('/{id}/delete', name: 'admin_partial_delete', requirements: ['id' => '[a-f0-9]{32}'], methods: ['POST'])]
+    public function delete(Request $request, string $id): Response
+    {
+        $this->denyAccessUnlessGranted('ROLE_EDITOR');
+        if (!$this->isCsrfTokenValid('partials', $request->request->getString('_csrf_token'))) {
+            return $this->back('Deine Sitzung ist abgelaufen. Bitte melde dich erneut an.');
+        }
+        try {
+            $this->partials->delete($id);
+        } catch (InvalidPage $e) {
+            return $this->back($e->getMessage());
+        }
+
+        return $this->back('Die Sektion wurde entfernt. Seiten, die sie einbinden, zeigen an dieser Stelle nichts mehr.', 'success');
+    }
+
+    #[Route('/{id}', name: 'admin_partial_editor', requirements: ['id' => '[a-f0-9]{32}'], methods: ['GET'])]
+    public function editor(string $id): Response
+    {
+        return $this->render('admin/editor.html.twig', ['partial' => $this->partial($id), 'kinds' => PartialRepository::KINDS]);
+    }
+
+    #[Route('/{id}/document', name: 'admin_partial_document', requirements: ['id' => '[a-f0-9]{32}'], methods: ['GET'])]
+    public function document(string $id): JsonResponse
+    {
+        return $this->json($this->payload($this->partial($id)));
+    }
+
+    #[Route('/{id}/draft', name: 'admin_partial_save', requirements: ['id' => '[a-f0-9]{32}'], methods: ['POST'])]
+    #[Route('/{id}/preview', name: 'admin_partial_preview', requirements: ['id' => '[a-f0-9]{32}'], methods: ['POST'])]
+    public function write(Request $request, string $id): Response
+    {
+        $this->denyAccessUnlessGranted('ROLE_EDITOR');
+        if (!$this->isCsrfTokenValid('editor', $request->headers->get('X-CSRF-Token'))) {
+            return $this->json(['error' => 'Deine Sitzung ist abgelaufen. Bitte melde dich erneut an.'], 403);
+        }
+        if (strlen($request->getContent()) > 270000) {
+            return $this->json(['error' => 'Der Bereich ist zu groß (maximal 256 KiB Inhalt).'], 413);
+        }
+        $partial = $this->partial($id);
+        try {
+            $body = json_decode($request->getContent(), true, 64, JSON_THROW_ON_ERROR);
+            $document = $body['document'] ?? null;
+            if (!is_array($body) || !is_array($document)) {
+                throw new \InvalidArgumentException();
+            }
+            if ('admin_partial_preview' === $request->attributes->get('_route')) {
+                $this->validator->validate($document, false);
+
+                return $this->renderPreview($partial, $document);
+            }
+            if (!isset($body['expectedVersion']) || !is_int($body['expectedVersion'])) {
+                throw new \InvalidArgumentException();
+            }
+            $this->partials->save($id, $document, $body['expectedVersion']);
+            $partial['document'] = $document;
+            $partial['version'] = $body['expectedVersion'] + 1;
+
+            return $this->json($this->payload($partial));
+        } catch (StaleWrite $e) {
+            return $this->json(['error' => $e->getMessage(), 'conflict' => true], 409);
+        } catch (InvalidDocument|InvalidPage $e) {
+            return $this->json(['error' => 'Bitte prüfe die Inhalte: '.$e->getMessage()], 422);
+        } catch (\JsonException|\InvalidArgumentException) {
+            return $this->json(['error' => 'Die Anfrage enthält kein gültiges Dokument.'], 422);
+        }
+    }
+
+    /** The area on its own, in the shell of a page, so the editor preview looks like the result. */
+    private function renderPreview(array $partial, array $document): Response
+    {
+        $theme = $this->theme->load();
+        $navigation = [];
+        foreach ($this->menus->all() as $slot => $menu) {
+            $navigation[$slot] = $this->menus->resolve($menu['items'], '');
+        }
+        $sections = [];
+        foreach ($this->partials->referencedSlugs($document) as $slug) {
+            $section = $this->partials->resolveSection($slug);
+            if (null !== $section) {
+                $sections[$slug] = $section['document'];
+            }
+        }
+
+        return $this->render('page.html.twig', [
+            'page' => ['locale' => 'de', 'path' => '', 'type' => 'page', 'slug' => '', 'document' => $document],
+            'canonical' => '',
+            'editing' => true,
+            'navigation' => $navigation,
+            'areas' => [],
+            'sections' => $sections,
+            'postLists' => [],
+            'postMeta' => null,
+            'needsTabs' => false,
+            'forms' => [],
+            'pageStyles' => $this->theme->css($theme).$this->styles->compileDocument($document),
+            'googleFonts' => $this->theme->googleFontsUrl($theme),
+        ]);
+    }
+
+    private function partial(string $id): array
+    {
+        return $this->partials->find($id) ?? throw $this->createNotFoundException('Bereich nicht gefunden.');
+    }
+
+    private function payload(array $partial): array
+    {
+        return [
+            'document' => $partial['document'],
+            'version' => $partial['version'],
+            'revisionId' => null,
+            'publishedRevisionId' => null,
+            'csrfToken' => $this->csrf->getToken('editor')->getValue(),
+        ];
+    }
+
+    private function slugify(string $name): string
+    {
+        $slug = strtr(mb_strtolower($name, 'UTF-8'), ['ä' => 'ae', 'ö' => 'oe', 'ü' => 'ue', 'ß' => 'ss']);
+
+        return substr(trim(preg_replace('/[^a-z0-9]+/', '-', $slug) ?? '', '-'), 0, 80);
+    }
+
+    private function back(string $message, string $type = 'error'): Response
+    {
+        $this->addFlash($type, $message);
+
+        return $this->redirectToRoute('admin_partials');
+    }
+}