Release 1.31.0

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

.htaccess

@@ -0,0 +1,24 @@
+# Schutz fuer den Fall, dass die Domain auf den Projektordner zeigt statt auf public/ (ADR 116).
+#
+# Bewusst kein "alles sperren": Apache wendet diese Datei auch auf public/ an, und dort soll alles
+# wie gewohnt laufen. Gesperrt werden nur Dateien, die es in public/ nicht gibt oder die
+# public/.htaccess ohnehin sperrt. Die Ordner var/, vendor/, config/, src/ usw. tragen eine eigene
+# Sperrdatei.
+<FilesMatch "^\.|\.(env|db|sqlite|sqlite3|lock|md|yaml|yml|dist|log|key)$">
+    <IfModule mod_authz_core.c>
+        Require all denied
+    </IfModule>
+    <IfModule !mod_authz_core.c>
+        Order deny,allow
+        Deny from all
+    </IfModule>
+</FilesMatch>
+<FilesMatch "^(composer\.json|VERSION|cli-config\.php|migrations\.php)$">
+    <IfModule mod_authz_core.c>
+        Require all denied
+    </IfModule>
+    <IfModule !mod_authz_core.c>
+        Order deny,allow
+        Deny from all
+    </IfModule>
+</FilesMatch>

README.md

@@ -186,7 +186,7 @@ Danach `http://127.0.0.1:8080/` öffnen. Der Routerskript-Parameter ist nicht op
 
 `bin/setup.php` erzeugt ein zufälliges Secret und `var/`. Die Konfiguration steht ausschließlich in der nicht versionierten `.env`; vorhandene Einstellungen und Secrets bleiben erhalten. Die Datenbank liegt in `var/cms.db`. Wiederholtes Seeding erhält existierende Seiten einschließlich ihrer Bearbeitungen. Standardzugangsdaten gibt es nicht.
 
-**Installation ohne Konsole** läuft über `/install`: Systemprüfung, Datenbank, Migration, Website, erstes Konto. Der Installer antwortet nur, solange keine Installation existiert – sobald ein Konto angelegt ist, liefert jede Adresse darunter 404, und die Sperre hängt am Zustand der Datenbank, nicht an einer Datei. Solange nichts installiert ist, führt jede Adresse dorthin. Davor genügt eine einzelne hochgeladene Datei: `install.php` aus einem Release lädt das Archiv von einer fest eingetragenen Adresse, vergleicht die SHA-256, entpackt es und löscht sich selbst. Ohne passende Prüfsumme wird nichts entpackt. Editor-Endpunkte benötigen Anmeldung, Berechtigung und bei POST einen CSRF-Token.
+**Installation ohne Konsole** läuft über `/install`: Systemprüfung, Datenbank, Migration, Website, erstes Konto. Der Installer antwortet nur, solange keine Installation existiert – sobald ein Konto angelegt ist, liefert jede Adresse darunter 404, und die Sperre hängt am Zustand der Datenbank, nicht an einer Datei. Solange nichts installiert ist, führt jede Adresse dorthin. Davor genügt eine einzelne hochgeladene Datei: `install.php` aus einem Release lädt das Archiv von einer fest eingetragenen Adresse, vergleicht die SHA-256, entpackt es und löscht sich selbst. Ohne passende Prüfsumme wird nichts entpackt. **Seit 1.30.0 öffnet sich der Installer nur mit dem Installationsschlüssel** (ADR 116): `install.php` legt ihn an und zeigt ihn mit einem fertigen Verweis auf seiner Abschlussseite; wer per FTP entpackt, findet ihn in `var/install.key`. Mit dem ersten Konto wird er gelöscht. Das Paket bringt Sperrdateien mit (`.htaccess` im Projektstamm und in `bin/`, `config/`, `migrations/`, `plugins/`, `src/`, `templates/`, `vendor/`; `var/.htaccess` legt die Website selbst an), damit auch bei einer Domain, die versehentlich auf den Projektordner zeigt, weder `.env` noch Datenbank oder Protokolle abrufbar sind. Editor-Endpunkte benötigen Anmeldung, Berechtigung und bei POST einen CSRF-Token.
 
 ## Eigene 404-Seite (ab 1.8.0)
 
@@ -397,7 +397,7 @@ Die Seite „Kantarci Markt – Neueröffnung“ (Wilhelm-Drapp-Straße, Baden-B
 
 ### Neunte lokale Referenzwebsite: Hüfner Gartenbau
 
-Die Website der Garten- und Landschaftsbau Hüfner GmbH (Iffezheim) liegt in `var/huefner.db` mit Medien in `var/huefner-media`; die Startkonfiguration `huefner` in `.claude/launch.json` nutzt Port 8102, `huefner-prod` denselben Bestand im Produktionsmodus auf Port 8103 zum Messen. `sh scripts/reset-huefner.sh [Entwurfsordner]` kopiert die Fotos aus dem gelieferten Entwurf nach `var/huefner-assets` und schneidet den Baum aus dem Logo als Seitensymbol (`scripts/build-huefner-assets.php`; ohne Argument nimmt es die schon vorbereiteten Bilder), wirft die Installation weg, baut mit `scripts/seed-huefner.php` Gestaltung, Kopf- und Fußbereich, Startseite, Impressum, Datenschutz, 404, Menü, Einstellungen und das Formular `anfrage` auf und holt Barlow und Barlow Condensed auf den eigenen Server. Gemessen mit `MSYS_NO_PATHCONV=1 CMS_URL=http://127.0.0.1:8103 CMS_PATHS=/,/impressum,/datenschutz npm run audit`. Die bewussten Abweichungen vom Entwurf stehen im Kopf des Skripts.
+Die Website der Garten- und Landschaftsbau Hüfner GmbH (Iffezheim) liegt in `var/huefner.db` mit Medien in `var/huefner-media`; die Startkonfiguration `huefner` in `.claude/launch.json` nutzt Port 8102, `huefner-prod` denselben Bestand im Produktionsmodus auf Port 8103 zum Messen. `sh scripts/reset-huefner.sh [Entwurfsordner Unterlagenordner]` kopiert die Fotos aus dem gelieferten Entwurf und Umuts Unterlagen (Alpaka-Fotos, PQ-Logo, Galabau-Signet, PQ-Bescheinigung und Freistellungsbescheinigungen als PDF, unter festen Namen) nach `var/huefner-assets` und schneidet den Baum aus dem Logo als Seitensymbol (`scripts/build-huefner-assets.php`; ohne Argumente nimmt es die schon vorbereiteten Dateien), wirft die Installation weg, baut mit `scripts/seed-huefner.php` Gestaltung, Kopf- und Fußbereich, Startseite, Alpakaseite, Impressum, Datenschutz, 404, Menü, Einstellungen und das Formular `anfrage` auf und holt Barlow und Barlow Condensed auf den eigenen Server. Gemessen mit `MSYS_NO_PATHCONV=1 CMS_URL=http://127.0.0.1:8103 CMS_PATHS=/,/alpakas CMS_AUDIT_DIR=reports/lighthouse-huefner-termin node scripts/audit.mjs`. Die Startseite liegt knapp unter dem HTML-Budget von 150 KB aus `test:browser`: wiederkehrende Bausteine tragen ihre Gestaltung deshalb am Behälter. Die bewussten Abweichungen vom Entwurf stehen im Kopf des Skripts.
 
 Zusätzliche Prüfung mit den lokalen Kant-IT-Inhalten: `node scripts/admin-quality-check.mjs` (PHP über `PHP_BINARY` wählbar). Das Skript benötigt `var/kantit.db` und `var/kantit-media`, erstellt eine eigene Datenbankkopie und ein zufälliges Testkonto darin; es ändert die Pilotdatenbank nicht. Screenshots und Bericht landen in `reports/admin-quality/`.
 

VERSION

@@ -1 +1 @@
-1.27.1
+1.31.0

bin/.htaccess

@@ -0,0 +1,9 @@
+# Dieser Ordner gehoert nicht ins Netz (ADR 116). Zeigt die Domain richtig auf public/, wird diese
+# Datei nie gelesen; zeigt sie versehentlich auf den Projektordner, sperrt sie hier alles.
+<IfModule mod_authz_core.c>
+    Require all denied
+</IfModule>
+<IfModule !mod_authz_core.c>
+    Order deny,allow
+    Deny from all
+</IfModule>

config/.htaccess

@@ -0,0 +1,9 @@
+# Dieser Ordner gehoert nicht ins Netz (ADR 116). Zeigt die Domain richtig auf public/, wird diese
+# Datei nie gelesen; zeigt sie versehentlich auf den Projektordner, sperrt sie hier alles.
+<IfModule mod_authz_core.c>
+    Require all denied
+</IfModule>
+<IfModule !mod_authz_core.c>
+    Order deny,allow
+    Deny from all
+</IfModule>

config/schutz/sperren.htaccess

@@ -0,0 +1,9 @@
+# Dieser Ordner gehoert nicht ins Netz (ADR 116). Zeigt die Domain richtig auf public/, wird diese
+# Datei nie gelesen; zeigt sie versehentlich auf den Projektordner, sperrt sie hier alles.
+<IfModule mod_authz_core.c>
+    Require all denied
+</IfModule>
+<IfModule !mod_authz_core.c>
+    Order deny,allow
+    Deny from all
+</IfModule>

config/schutz/stamm.htaccess

@@ -0,0 +1,24 @@
+# Schutz fuer den Fall, dass die Domain auf den Projektordner zeigt statt auf public/ (ADR 116).
+#
+# Bewusst kein "alles sperren": Apache wendet diese Datei auch auf public/ an, und dort soll alles
+# wie gewohnt laufen. Gesperrt werden nur Dateien, die es in public/ nicht gibt oder die
+# public/.htaccess ohnehin sperrt. Die Ordner var/, vendor/, config/, src/ usw. tragen eine eigene
+# Sperrdatei.
+<FilesMatch "^\.|\.(env|db|sqlite|sqlite3|lock|md|yaml|yml|dist|log|key)$">
+    <IfModule mod_authz_core.c>
+        Require all denied
+    </IfModule>
+    <IfModule !mod_authz_core.c>
+        Order deny,allow
+        Deny from all
+    </IfModule>
+</FilesMatch>
+<FilesMatch "^(composer\.json|VERSION|cli-config\.php|migrations\.php)$">
+    <IfModule mod_authz_core.c>
+        Require all denied
+    </IfModule>
+    <IfModule !mod_authz_core.c>
+        Order deny,allow
+        Deny from all
+    </IfModule>
+</FilesMatch>

config/services.yaml

@@ -63,6 +63,9 @@ services:
         arguments:
             $secret: '%kernel.secret%'
             $siteOrigin: '%env(SITE_ORIGIN)%'
+    App\EventSubscriber\ErrorLogSubscriber:
+        arguments:
+            $debug: '%kernel.debug%'
     App\Controller\SeoController:
         arguments:
             $siteOrigin: '%env(SITE_ORIGIN)%'

docs/ARCHITECTURE.md

@@ -1,6 +1,66 @@
 # Architekturentscheidungen
 
-Stand: 09.10.2026. Arbeitstitel KantSites; Produktname offen.
+Stand: 12.10.2026. Arbeitstitel KantSites; Produktname offen.
+
+## ADR 117 – Menü schließt beim Klick daneben, Netzwerk-Symbole, schlankere Symbole (12.10.2026)
+
+Anlass: Umut: „Bei Mobilmenü, wenn es aufgeklappt ist, schließt es nicht, wenn man irgendwo anders hinklickt.“ Und für Hüfner: Facebook, Instagram und „Angebot anfragen“ als Menü-Buttons statt eigener Knöpfe im Kopf.
+
+**Entscheidungen.**
+1. **Klick daneben schließt – ohne Skript.** Das Menü bleibt ein `details` (es soll auf jeder Seite ohne Skript aufgehen). Solange es offen ist, legt `summary::before` eine unsichtbare, feste Fläche über die Seite (`z-index:29`); sie gehört zum Knopf, ein Klick darauf schließt also. Die Menüfläche liegt darüber (`z-index:30`; außerhalb des Kopfbereichs per `:where()` mit niedriger Spezifität, damit die Platzierung im Kopf gewinnt). Der erste Klick daneben schließt nur und löst nichts darunter aus – wie bei jedem aufgeklappten Menü. Escape schließt weiterhin nicht (das bräuchte ein Skript). Grenze: Hat ein Vorfahr des Menüs `transform`/`filter`, deckt die feste Fläche nur diesen Vorfahren ab.
+2. **Facebook, Instagram, WhatsApp im Symbolsatz.** Dieselben Strichformen wie `social-icon.html.twig`, als Pfad in `icon.html.twig`, `icons.js` (Reiter „Soziale Netzwerke“) und `DocumentValidator::ICONS`. Damit sind sie an Menü-Buttons, Buttons, Symbolkarten und Symbolen wählbar. Keine Schemaänderung; ein Dokument mit diesen Symbolen braucht aber einen Kern ab 1.31.0.
+3. **Strichattribute ins Stylesheet.** Jedes Symbol trug `fill`, `stroke`, `stroke-width`, `stroke-linecap` und `stroke-linejoin` als Attribute, rund 105 Zeichen, bei etwa 40 Symbolen je Seite gut 4 KB HTML. Jetzt steht das einmal als `svg.block-icon{…}` in `site.css` und `admin.css`; `width`/`height` bleiben am Element, damit nichts ohne Stylesheet riesig wird. Anlass war die Hüfner-Startseite, die mit den Menü-Buttons das HTML-Budget von 150 KB riss.
+
+**Geprüft:** Eigene Browserprüfung auf iPad (quer) und iPhone: Menü öffnet, Menülinks liegen über der Fläche, Klick daneben schließt, kein waagerechtes Scrollen. `test:menu-buttons` (Menü-Buttons, axe), `test:editor` (Verwaltung mit Symbolen, axe), `npm test` (Symbolsatz in Twig, JS und Validator gleich). `test:responsive-navigation` scheitert im Editorteil am Klick auf den Strukturbaum – ebenso ohne diese Änderungen (Gegenprobe mit zurückgesetzten Dateien), also vorbestehend.
+
+## ADR 116 – Härtung nach dem Sicherheitscheck (12.10.2026)
+
+Anlass: Umut: „Kannst du mal einen Sicherheitscheck für KantSites machen? Das Ding muss bombensicher sein.“ Fünf getrennte Prüfungen (Anmeldung/Rollen, öffentliche Eingaben, XSS/Ausgabe, Uploads/Dateien, Installer/Updater/Betrieb) plus ein Blick von außen auf die Live-Seiten. Keine ausnutzbare Lücke ohne Anmeldung bei korrekt eingerichteter Installation; behoben wird, was übrig blieb.
+
+**Entscheidungen.**
+1. **Installationsschlüssel.** Der Installer war bis zum ersten Konto für jeden offen – wer eine frisch entpackte Installation zuerst aufrief, konnte sie übernehmen (und vorher über den MySQL-Host fremde Rechner abtasten). Jetzt öffnet sich kein Schritt ohne einen 128-Bit-Schlüssel in `var/install.key`. `install.php` legt ihn an und zeigt ihn nur auf seiner Abschlussseite mit fertigem Verweis (`/install/schluessel?schluessel=…`); wer per FTP entpackt, liest die Datei. Im Browser bleibt ein Cookie `kant_install` mit einem HMAC über den Schlüssel (HttpOnly, SameSite=Strict, Pfad `/install`), nie der Schlüssel selbst. Mit dem ersten Konto wird die Datei gelöscht; das Anlegen des ersten Kontos läuft in einer Transaktion. Restrisiko: Wer `install.php` vor dem Betreiber aufruft, sieht den Schlüssel – das Fenster ist die Zeit zwischen Hochladen und Aufrufen.
+2. **Sperrdateien.** Zeigte die Domain auf den Projektordner statt auf `public/`, waren `.env`, Datenbank, Sicherungen und Protokolle abrufbar; die Sperren standen nur in `public/.htaccess`. Jetzt sperren `.htaccess`-Dateien `bin/`, `config/`, `migrations/`, `plugins/`, `src/`, `templates/`, `vendor/` (Buildskript) und `var/` (legt die Website selbst an, `App\Ops\Protection`), dazu im Projektstamm gezielt Dotfiles, `env|db|sqlite|lock|md|yaml|yml|dist|log|key` und `composer.json`, `VERSION`, `cli-config.php`, `migrations.php`. Bewusst **kein** pauschales „alles sperren“ im Projektstamm: Apache wendet die Datei auch auf `public/` an, ein Update hätte jede Seite mit 403 lahmlegen können. Eine eigene `.htaccess` des Betreibers im Projektstamm bleibt unberührt; fehlende Dateien trägt die Website beim ersten Aufruf nach (auch nach einem Update von einer Fassung, deren Updater sie nicht kannte). Vorlagen: `config/schutz/`.
+3. **Sektionen nach ihrem eigenen Schema-Stand.** Eine verknüpfte Sektion wurde mit den Ausgabeflags der Seite gerendert. Eine Sektion mit Schema unter v12 (deren Text nicht gefiltert wird) gab so in einer neueren Seite ungefiltertes HTML aus – ein Publisher konnte `<meta refresh>` oder fremde Links setzen, was sonst nur der Admin darf. Jetzt rechnet die Vorlage mit `section.schemaVersion`; neue Sektionen beginnen im aktuellen Schema.
+4. **Redakteure ändern nichts Veröffentlichtes.** Adresse verschieben, Papierkorb (jeweils samt Unterseiten), Kopf/Fuß wählen und Beitragsdaten (robots, SEO-Titel, Datum …) wirkten sofort öffentlich und brauchten nur ROLE_EDITOR. Jetzt verlangen sie ROLE_PUBLISHER, sobald die Seite (bzw. eine Unterseite) veröffentlicht ist; Entwürfe bleiben frei.
+5. **Geplante Veröffentlichung mit fester Fassung.** Zum Termin ging der neueste Entwurf online, auch einer, den ein Redakteur nach dem Planen gespeichert hatte. Jetzt speichert `schedule()` die damalige Fassung in `page.publish_revision_id` (Migration `20261012000100`, eine Spalte); `publishDue()` veröffentlicht genau sie. Planungen ohne Fassung (aus älteren Versionen) veröffentlichen weiterhin den Entwurf.
+6. **Formulare.** Das Zeitsiegel ist an das Formular und den Zweck gebunden (`FormRepository::stamp`). Die Grenze je Absender zählt bei IPv6 das /64-Netz. Neu: höchstens 30 gespeicherte Anfragen je Formular und 120 insgesamt je Stunde; darüber wird nichts gespeichert und nichts verschickt – sichtbar mit Hinweis aufs Telefon statt still, damit kein echter Besucher glaubt, seine Anfrage sei angekommen.
+7. **Kleinere Härtungen.** Einwilligungs-Rücksprung ohne Steuerzeichen und Backslash (Tabulator machte aus `/<Tab>/fremd` eine offene Weiterleitung). Update-Ziel nur in der Form `1.2.3` bzw. `v1.2.3`, `git checkout` mit `--`. Eigenes CSS: keine Geschwister des Blocks selbst (`& ~`, `& +`), Anführungszeichen paarweise, keine Kommentarzeichen in Werten; bereits gespeichertes CSS, das das verletzt, entfällt beim Ausgeben still, statt die Seite zu brechen.
+
+**Nicht umgesetzt, mit Grund.** Signierte Releases (Umut: später); dann gehört ein Offline-Schlüssel dazu. Antwortzeit beim Login für unbekannte Benutzer, Trusted Proxies, Turnstile-Hostname, `%PDF-` ab Byte 0, archivierte PDFs, Statistik-Obergrenzen, MySQL-Passwort in der Prozessliste: niedrig, offen in STATUS.
+
+**Folgen.** Neuinstallationen brauchen den Schlüssel; die Doku sagt, wo er steht. Bestehende Installationen merken nur die Sperrdateien (keine Wirkung bei korrekter Einrichtung) und die engeren Rollen. Migration läuft mit dem Updater. Ausgeliefert mit 1.30.0.
+
+## ADR 115 – Einwilligung ohne Neuladen (12.10.2026)
+
+Anlass: Umut auf der Hüfner-Seite: „dieses Einwilligen, da lädt die Seite komplett neu. Bekommen wir das auch ohne hin?“ Hinweis und Knopf am eingebetteten Inhalt waren reine Formulare (ADR zur Einwilligung: kein Skript), der Server setzte das Cookie und leitete zurück.
+
+**Entscheidung.** Das Formular bleibt der Weg, ein kleines Skript `public/assets/consent.js` verbessert ihn. Es schickt dasselbe Formular im Hintergrund an `/einwilligung` mit der Kopfzeile `X-Kant-Consent: 1`; der Server antwortet dann mit 204 und dem Cookie statt mit der Weiterleitung (Herkunftsprüfung unverändert). Wurde etwas erlaubt, holt das Skript die Seite noch einmal und übernimmt daraus nur die eingebetteten Inhalte und die Zeile „Rechtliches“ (dort steht jetzt „Einwilligung ändern“); dann verschwindet der Hinweis. Der Fokus geht an den eingesetzten Rahmen bzw. an `#main`. Schlägt etwas fehl, sendet das Skript das Formular normal ab. Die Adresse eines Inhalts steht weiterhin erst nach der Einwilligung im HTML – kein `data-src` im Platzhalter.
+
+**Was sich dafür ändert.** (1) Die Sicherheitsrichtlinie nennt die Hosts aller eingebetteten Inhalte der Seite in `frame-src`, auch solange die Einwilligung fehlt: eine Richtlinie steht beim Laden fest, ein nachträglich eingesetzter Rahmen bräuchte sonst ein Neuladen. Die Erlaubnis lädt nichts. (2) Seiten mit offener Frage (Hinweis offen oder ein Inhalt wartet) senden `script-src 'self'` und laden `consent.js`; nach der Entscheidung ohne wartende Inhalte wieder `script-src 'none'`. (3) Das Skriptbudget von `test:browser` (3 je Seite) zählt `consent.js` nicht mit, weil es nur bis zur Entscheidung da ist.
+
+**Folgen.** Ohne JavaScript bleibt alles wie bisher. Andere Vorlagen als `PageController` (falls sie Einbettungen zeigen) laden das Skript nicht und bleiben beim Neuladen. Ausgeliefert mit 1.29.0.
+
+## ADR 114 – Die Umschreibregel fängt index.php selbst ab (12.10.2026)
+
+Anlass: huefner-gartenbau.de bei IONOS (PHP 8.4.26) antwortete auf `/`, `/install` und `/assets/` mit einem weißen 500er von Apache. Die Notfallschicht (ADR 113) griff nicht, weil PHP gar nicht erreicht wurde. `/index.php/install` lieferte dagegen 200, auch mit der `.htaccess` – die Datei wurde also gelesen, der Fehler lag in der Umschreibregel. Vermutete Ursache: `RewriteCond %{REQUEST_FILENAME} !-f` erkennt dort die bereits umgeschriebene `index.php` nicht als Datei, die Regel greift erneut, Apache bricht nach zehn internen Umleitungen ab.
+
+**Entscheidung.** `public/.htaccess` setzt `RewriteBase /` und beendet die Umschreibung für `index.php` selbst (`RewriteRule ^index\.php$ - [L]`), wie die `.htaccess` von WordPress. Auf dem Hosting von Umut mit beiden Zeilen bestätigt; welche der beiden allein genügt hätte, ist nicht geprüft. `CmsTest` sichert die Zeilen ab.
+
+**Folgen.** `RewriteBase /` setzt voraus, dass die Domain auf `public/` zeigt – das war schon Bedingung, eine Installation in einem Unterordner einer Domain ist nicht vorgesehen. Bestehende Installationen bekommen die Zeilen mit dem nächsten Archivupdate, weil der Updater die `.htaccess` des Releases übernimmt (nur eingeschaltete HTTPS-/HSTS-Zeilen werden erhalten). `Options -Indexes -MultiViews` verträgt IONOS: auf huefner-gartenbau.de wieder eingeschaltet, die Seite lädt weiter. Ausgeliefert mit 1.28.1.
+
+## ADR 113 – Kein leerer 500er mehr, Update mit einem Klick nach reiseSoft (09.10.2026)
+
+Anlass: Auf kantarci-reisen.de wurde die Datenbank per FTP ersetzt, ohne vorher den Code zu aktualisieren – danach antwortete jede Adresse mit einer leeren 500-Seite, und nirgends stand, warum. Umut: „Ich meine, dass es nicht Fehler 500 einfach so gibt.“ Und zum Updater: suchen, dann einspielen, dann migrieren soll *ein* Vorgang sein, den man beim Aufruf der Systemseite sieht – „mach es wie bei reiseSoft“.
+
+**Notfallschicht.** `src/Ops/Notfall.php` hängt an nichts außer PHP und wird in `public/index.php` vor dem Bootstrap geladen. Sie fängt Ausnahmen, die bis zum Front-Controller durchschlagen, und schwere Fehler (Shutdown-Handler: Parse-, Compile-, Speicherfehler), schreibt eine Zeile mit Zeit, Adresse, Fehler und bis zu drei Ursachen nach `var/log/notfall.log` (ab 1 MB nach `.1` rotiert) und gibt eine schlichte Wartungsseite mit 503 und `Retry-After: 300` aus. Damit ist die Datei per FTP lesbar, auch wenn Symfony gar nicht startet – das ist auf geteiltem Hosting oft der einzige Zugang. 503 statt 500, damit Suchmaschinen „gleich wieder da“ verstehen. Einzelheiten stehen nur im Protokoll, nie auf der Seite.
+
+**Fehler innerhalb des Frameworks.** `ErrorLogSubscriber` hört auf `kernel.exception` mit Priorität −64: nach der Sicherheitsschicht (sonst wird „Zugriff verweigert“ zur Wartungsseite statt zur Anmeldung – so schlug `CmsTest` an), vor der Fehlerseite des Frameworks (−128). Er übergeht HTTP-Fehler unter 500 sowie Anmelde-, Zugriffs- und Abmeldeausnahmen, protokolliert den Rest und setzt außerhalb des Debugmodus dieselbe Wartungsseite. Im Debugmodus bleibt die ausführliche Seite.
+
+**Update mit einem Klick.** Vorbild ist die Systemseite von reiseSoft: beim Öffnen fragt die Seite selbst nach einer neuen Fassung (`GET /admin/system/update/pruefen`) und zeigt Name, Datum und Hinweise des Release-Eintrags. Ein Knopf, ein Bestätigungsdialog, dann läuft alles durch: `POST …/update/starten` sichert, lädt und prüft das Archiv, schaltet um und endet mit reinem PHP (ADR 112); die Seite ruft danach `POST …/update/abschliessen` mit dem Einmalschlüssel auf – eine neue Anfrage mit dem neuen Code – und der migriert, prüft und schaltet die Wartung aus. Währenddessen fragt sie alle 1,5 s `GET …/update/status` ab und zeigt fünf Schritte: Daten sichern, Fassung laden und prüfen, Umschalten, Datenbank anpassen, Funktion prüfen. Der Fortschritt steht in `var/update/status.json` (Phase, Meldung, von/auf, `bei` = Schritt eines Fehlers; nach 30 Minuten ohne Änderung gilt ein Lauf als abgebrochen).
+
+**Automatisch zurück.** Die Prüfung ist eine Unteranfrage auf `/` mit dem neuen Code; erwartet wird ein Status unter 400, wenn eine Startseite veröffentlicht ist. Scheitern Migration oder Prüfung, kommt die alte Fassung zurück: Code aus `var/update/<lauf>/alt`, überschriebene Dateien in `public/` aus `alt-public` (neu hinzugekommene werden entfernt, Liste in `public.json`), Datenbank aus der Sicherung des Laufs (`Backup::restore`). Erst danach geht die Wartungsseite aus; der Status heißt `zurueckgerollt`, die Seite markiert den gescheiterten Schritt.
+
+**Folgen.** Die Endpunkte verlangen die Administratorrolle, schreibende zusätzlich CSRF (Kopfzeile `X-CSRF-Token`) bzw. den Einmalschlüssel. Ohne JavaScript bleiben die bisherigen Formulare unter „Weitere Möglichkeiten“. Wie ADR 112 wirkt der neue Ablauf erst bei Updates, die *von* einer Fassung mit diesem Code ausgehen; die Notfallschicht wirkt sofort nach dem Einspielen. Geprüft Ende zu Ende mit einer Installation aus dem Releasearchiv: Update 1.27.1 → Testfassung in etwa 8 s mit einem Klick; eine absichtlich kaputte Testfassung wurde vollständig zurückgeschaltet (VERSION, Vorlagen, Datenbank, Wartung aus, Startseite 200).
 
 ## ADR 112 – Das Archivupdate läuft in einem Zug durch (09.10.2026)
 

docs/STATUS.md

@@ -1,5 +1,81 @@
 # Projektstatus
 
+## Fassung 1.31.0: Menü schließt beim Klick daneben, Netzwerk-Symbole; Hüfner-Kopf (12.10.2026)
+
+**Anlass:** Umut: aufgeklapptes Mobilmenü schließt nicht beim Klick daneben; bei Hüfner wirkt der Kopf auf dem iPad verloren (Menü-Knopf mittig), und Facebook, Instagram und „Angebot anfragen“ sollen ins Menü.
+
+**Neu im Kern (ADR 117):** Klick neben das aufgeklappte Menü schließt es – reines CSS (unsichtbare Fläche am Menü-Knopf), kein Skript. Facebook, Instagram und WhatsApp im Symbolsatz (Menü-Buttons, Buttons, Symbole). Die Strichattribute der Symbole stehen jetzt als `svg.block-icon` in `site.css`/`admin.css` statt an jedem Symbol (rund 4 KB weniger HTML je Seite).
+
+**Hüfner (nur Inhalt):** Kopf aus Logo und rechtsbündigem Menü; „Angebot anfragen“, Facebook und Instagram als Menü-Buttons. Desktop zeigt in der Zeile nur „Angebot anfragen“ (F/I stehen in der Leiste darüber), im aufgeklappten Menü stehen alle drei, die Symbole nebeneinander. Menü-Knopf auf iPad und Telefon rechts; Abstand und Schrift schrumpfen knapp über 1024 px mit, damit die Zeile nicht umbricht. Upload-Paket neu (`var/huefner-upload.zip`, braucht 1.31.0).
+
+**Geprüft:** PHPUnit vollständig 657 grün; `npm test` 41; `lint:twig`; `test:menu-buttons` und `test:editor` grün inklusive axe; `test:browser` auf Hüfner grün (HTML Startseite rund 148 KB). Eigene Browserprüfung auf iPad quer und iPhone: öffnen, Menülinks bedienbar, Klick daneben schließt, kein waagerechtes Scrollen; Kopf bei 810, 1025, 1080, 1100, 1280 und 1366 px im Bild. **Bekannt:** `test:responsive-navigation` scheitert im Editorteil am Klick auf den Strukturbaum – auch ohne diese Änderungen (Gegenprobe), vorbestehend.
+
+## Fassung 1.30.0: Härtung nach dem Sicherheitscheck (12.10.2026)
+
+**Anlass:** Umut: „Sicherheitscheck für KantSites … das Ding muss bombensicher sein.“ Prüfung in fünf Bereichen plus Blick von außen auf huefner-gartenbau.de und kant-it.de; Ergebnis im Chat vom 12.10.2026, Umsetzung „1.30.0, Signatur später“.
+
+**Behoben (ADR 116):** Installationsschlüssel für den Installer (`var/install.key`, von `install.php` angelegt und angezeigt); Sperrdateien im Projektstamm und in allen internen Ordnern (`var/` legt die Website selbst an); verknüpfte Sektionen nach ihrem eigenen Schema-Stand gerendert (kein ungefiltertes HTML durch alte Sektionen); Redakteure ändern Adresse, Papierkorb, Bereiche und Beitragsdaten veröffentlichter Seiten nicht mehr; geplante Veröffentlichung mit fester Fassung (Migration `20261012000100`); Formular-Siegel je Formular, IPv6 je /64, Obergrenze je Formular und gesamt mit sichtbarem Hinweis; offene Weiterleitung per Tabulator beim Einwilligen; Update-Ziel nur `1.2.3`; eigenes CSS bleibt im Block.
+
+**Geprüft:** PHPUnit vollständig 657 Tests: im Gesamtlauf 656 grün, ein Fehlschlag (`ArchiveUpdateTest`: die neue `.htaccess` im Projektstamm stand weder in der Ersetzungsliste noch in den bewussten Ausnahmen – jetzt als Ausnahme eingetragen, weil sie dem Betreiber gehören kann), danach die betroffenen Dateien (ArchiveUpdate, Cms, Installation, InstallFlow, SingleFileInstaller, Translation; 436 Tests) erneut grün. Neu getestet: Installer nur mit Schlüssel (falscher Schlüssel, gefälschtes Cookie, Verweis aus install.php, Löschen nach dem ersten Konto), Sperrdateien, Sektion mit altem Schema, Redakteur vs. veröffentlichte Seite, geplante Fassung, Formular-Siegel je Formular, IPv6-/64, Flut-Grenze mit Hinweis, Einwilligungs-Rücksprung mit Tabulator/Umbruch/Backslash, CSS-Geschwister/Kommentare. Gegenprobe: der Sektionstest schlägt ohne den Fix an. `npm test` 41, `lint:twig`, php-cs-fixer; `test:browser` auf Hüfner grün; `test:editor` grün inklusive axe; im Browser ein echtes Absenden des Hüfner-Formulars mit neuem Siegel (Testeinsendung danach gelöscht). Hüfner-Upload-Paket mit migrierter Datenbank (`20261012000100`) neu gebaut.
+
+**Veröffentlicht:** Tag `v1.30.0`, Release-Eintrag mit Archiv (5,5 MB, gebaut aus `var/release-source-1.30.0`, enthält alle Sperrdateien inkl. `vendor/.htaccess`), `.sha256` und `install.php` (mit Installationsschlüssel); Prüfsumme nach dem Herunterladen bestätigt. Eine Migration (`20261012000100`), läuft mit dem Updater.
+
+**Nächster Schritt:** Installationen auf 1.30.0 aktualisieren (huefner-gartenbau.de, kant-it.de, weitere); bei Hüfner danach das Upload-Paket einspielen und die HTTPS-Zeilen einschalten.
+
+**Offen (niedrig):** signierte Releases; Login-Antwortzeit für unbekannte Benutzer; Trusted-Proxy-Einstellung für Hosting hinter CDN; Turnstile-Hostname; `%PDF-` ab Byte 0; archivierte PDFs bleiben abrufbar; Statistik ohne Obergrenze für erfundene Verweise; MySQL-Passwort in der Prozessliste bei Sicherungen; Theme-Vorlagen ohne Versionsprüfung. **Live:** huefner-gartenbau.de antwortet auch über `http://` ohne Umleitung und ohne HSTS – die HTTPS-Zeilen in `public/.htaccess` einschalten.
+
+## Fassung 1.29.0: Einwilligung ohne Neuladen (12.10.2026)
+
+**Anlass:** Umut auf der Hüfner-Seite: Beim Einwilligen ins YouTube-Video lädt die Seite komplett neu.
+
+**Neu im Kern (ADR 115):** `public/assets/consent.js` schickt Hinweis und Knopf am eingebetteten Inhalt im Hintergrund ab (`X-Kant-Consent: 1` → 204 mit Cookie statt Weiterleitung), holt die Seite neu und tauscht nur Einbettungen und „Rechtliches“ aus; Fokus an den Rahmen bzw. an den Seitenanfang. Ohne JavaScript und bei Fehlern bleibt das Formular mit Neuladen. `frame-src` nennt die Hosts aller Einbettungen der Seite auch vor der Einwilligung (die Adresse des Inhalts weiterhin erst danach im HTML). Das Skript lädt nur, solange eine Einwilligung offen ist; `test:browser` zählt es nicht zum Budget von drei Skripten.
+
+**Geprüft:** PHPUnit vollständig 644 grün (neu: 204-Antwort mit Cookie, kein Cookie von fremder Herkunft, Weiterleitung ohne Kopfzeile; angepasst: Skript bei offener Frage, `script-src 'none'` nach der Entscheidung, `frame-src` vor der Einwilligung), `npm test` 41, `lint:twig`, php-cs-fixer. Im Browser auf der Hüfner-Kopie: Knopf am Video, „Nur notwendige“ und „Alle akzeptieren“ ohne Neuladen, Fokus aufs Video, ohne JavaScript weiterhin mit Neuladen, keine Konsolenfehler. `test:browser` grün, Lighthouse Produktion Startseite mobil 96, Desktop 98, sonst 100. `test:editor` nicht gelaufen (Editor unverändert, Skript dort nicht eingebunden).
+
+**Veröffentlicht:** Tag `v1.29.0`, Release-Eintrag mit Archiv (3611 Dateien, 5,3 MB, gebaut aus `var/release-source-1.29.0`), `.sha256` und `install.php`; Prüfsumme nach dem Herunterladen bestätigt. Keine Migration.
+
+**Nächster Schritt:** Installationen mit Einwilligungshinweis (huefner-gartenbau.de, Immobilien DEEG) auf 1.29.0 aktualisieren.
+
+## Fassung 1.28.1: weißer 500er bei IONOS durch die Umschreibregel (12.10.2026)
+
+**Anlass:** huefner-gartenbau.de bei IONOS zeigte nach der Einrichtung auf jeder Adresse einen weißen 500er.
+
+**Ursache und Änderung (ADR 114):** PHP 8.4.26 lief (`test.php`), `/index.php/install` lieferte 200, nur umgeschriebene Adressen scheiterten – Umschreibschleife in `public/.htaccess`. Neu im Kern: `RewriteBase /` und `RewriteRule ^index\.php$ - [L]` vor der `!-f`-Regel; Test in `CmsTest::testEveryPublicAnswerCarriesItsProtectiveHeaders`.
+
+**Geprüft:** Umut hat beide Zeilen auf IONOS eingetragen, danach lädt `/install`; auch mit eingeschalteter `Options`-Zeile. PHPUnit vollständig: 643 Tests grün, eine Warnung aus `UpdaterTest` (fehlende `.env` im Testordner, unabhängig von dieser Änderung); php-cs-fixer sauber.
+
+**Veröffentlicht:** Tag `v1.28.1`, Release-Eintrag mit Archiv (3610 Dateien, 5,3 MB, gebaut aus `var/release-source-1.28.1`), `.sha256` und `install.php`; Prüfsumme nach dem Herunterladen bestätigt. Keine Migration.
+
+**Offen:** Der Installer auf huefner-gartenbau.de war bis zum Abschluss der Einrichtung öffentlich erreichbar.
+
+**Nächster Schritt:** Bestehende IONOS-Installationen auf 1.28.1 aktualisieren.
+
+## Hüfner: Änderungen aus dem Kundentermin (12.10.2026)
+
+**Anlass:** Umuts handschriftliche Notizen vom Hüfner-Termin plus Antworten auf Rückfragen. Nur Inhalt und Seed-Skript, kein Kerncode.
+
+**Erledigt (`scripts/seed-huefner.php`, `build-huefner-assets.php`, `reset-huefner.sh`):** Alle Grüntöne auf das Baumgrün des Logos (#067F30) gedreht, „Premium“ und Hervorhebungen in Baumgrün, kleine Schrift auf Dunkel weiß statt hellgrün (Kontrast). Das „💯“ als Umuts Emoji-Bild überall, wo „100“ steht, im Text (`<mark>100</mark>`: die Zahl bleibt lesbar für Vorleser und KI, sichtbar ist das Bild in Schriftgröße, geschütztes Leerzeichen vor „%“); Quelle `100-emoji.png` in den Unterlagen. „Miteinander. 💯 %.“-Abzeichen jetzt dunkel statt rot. Freistellungsbescheinigungen (§ 13b UStG, § 48b EStG) als PDF bei „Planung & Angebot“ und im Fuß, PQ-Bescheinigung unter „Über uns“ und im Fuß, Galabau-Signet und PQ-Logo. Imagevideo (YouTube, youtube-nocookie) als „Externer Inhalt“ – dafür jetzt Einwilligungshinweis (Ecke) und angepasste Datenschutzerklärung. Google-Bewertungen unter „100 % Qualität. 100 % Zufriedenheit.“ mit 4,9 / über 150 als Beleg, drei echte Rezensionen (gekürzt, Namen abgekürzt), Knopf zum Eintrag. 48-h-Angebotsgarantie in Ablauf und Kontakt, „Leistung“ aus dem Formular, Chips verlinken zum Formular, WhatsApp (0176 30387990) in Kontakt und Karriere, 25 Jahre / 7.000+ Projekte, „Bagger bis 15 t“ raus. Karriere: Facharbeiter und LKW-Fahrer C/CE (wie Instagram) als zwei gleich hohe, aufklappbare Karten (details/summary, SVG-Zeichnungen), „Ein Anruf genügt!“. Neue Seite `/alpakas` mit Umuts Text, Ergänzungen, Galerie und Plakat; „Alpakas“ im Menü, „Ablauf“ aus dem Menü raus. `browser-check.mjs`: PDFs zählen beim „erster interner Link“-Klick nicht mit.
+
+**Geprüft:** `test:browser` auf 8102 für `/`, `/alpakas`, `/datenschutz`, `/impressum` grün (HTML Startseite 148.905 B von 150.000 – knapp). Lighthouse Produktion (`reports/lighthouse-huefner-termin`): `/` mobil 96, Desktop 99; `/alpakas` mobil 95, Desktop 100; Barrierefreiheit, Best Practices, SEO, Agentic Browsing überall 100. Im Browser: Video lädt erst nach Einwilligung, Stellenkarten klappen auf, Telefonbreite ohne waagrechtes Scrollen.
+
+**Bekannt / offen:** Die Freistellungsbescheinigung § 13b gilt nur bis 31.12.2026 – dann neue Datei in die Unterlagen und neu aufbauen. Die Alpaka-Videos (mp4) sind nicht eingebunden (keine Videoablage im Kern). Offen von Umut: Logos der Sponsoren, „Über uns – mehr lesen“, ggf. Stellenbilder aus ChatGPT statt der SVG-Zeichnungen, genauer Verbandsname. Die Sprachtest-Kopie (`var/browser-tests/lang`) teilt `var/huefner-media` und hat nach dem Neuaufbau keine passenden Bilder mehr. Sicherung vorher: `var/backups/huefner-vor-termin-1210/`. Nebenbefund Kern: `CustomCode::parse` lehnt `url('…')` mit Anführungszeichen immer ab (optionales Anführungszeichen im regulären Ausdruck backtrackt).
+
+**Nächster Schritt:** Umuts Durchsicht; fehlende Punkte nachliefern lassen.
+
+## Fassung 1.28.0: Notfallseite, Fehlerprotokoll und Update mit einem Klick (09.10.2026)
+
+**Anlass:** kantarci-reisen.de zeigt nach einer per FTP ersetzten Datenbank auf jeder Adresse eine leere 500-Seite. Umut: „Fang mit 1 und 2 an und verbessere den Update-Prozess … mach es wie bei reiseSoft.“
+
+**Erledigt (ADR 113):** (1) Wartungsseite mit 503 statt leerem 500er, auch wenn Symfony nicht startet; (2) Fehlerprotokoll `var/log/notfall.log`, per FTP lesbar; (3) Update-Karte auf der Systemseite: sucht beim Öffnen selbst, zeigt die Release-Hinweise, ein Klick mit Bestätigung, Fortschritt in fünf Schritten live, Migration im selben Vorgang, bei Fehler automatisch zurück auf die alte Fassung samt Datenbank.
+
+**Geprüft:** PHPUnit vollständig 643 grün (neu: `NotfallTest`, Fortschrittsdatei und vollständiges Zurückschalten in `ArchiveUpdateTest`, Endpunkte nur für Administratoren in `SystemScreenTest`), php-cs-fixer. Im Browser mit einer Installation aus dem Releasearchiv 1.27.1: erfolgreiches Update in einem Klick, Zurückschalten bei einer kaputten Testfassung.
+
+**Veröffentlicht:** Tag `v1.28.0`, Release-Eintrag mit Archiv (3610 Dateien, 5,3 MB, gebaut aus `var/release-source-1.28.0`), `.sha256` und `install.php`; Prüfsumme nach dem Herunterladen bestätigt. Keine Migration.
+
+**Bekannt:** Der neue Ablauf greift erst bei Updates, die von 1.28.0 ausgehen. kantarci-reisen.de ist noch offline (Ursache unbekannt, Datenbank lokal mit 1.27.0 lauffähig).
+
+**Nächster Schritt:** kantarci-reisen.de wiederherstellen (Notfallschicht hochladen → Protokoll lesen, oder Sicherung zurück) und aktualisieren.
+
 ## Fassung 1.27.1: Update in einem Zug, Kantarci Reisen auf Türkisch (09.10.2026)
 
 **Anlass:** Umut: Update auf kantarci-reisen.de gab direkt danach einen 500er, nach „zurück“ ließ sich migrieren. „Können wir den Updater besser machen, dass alles automatisch abläuft, wie bei WordPress?“ Und: „Die DB hier komplett mit Übersetzung auf Türkisch fertig machen.“

migrations/.htaccess

@@ -0,0 +1,9 @@
+# Dieser Ordner gehoert nicht ins Netz (ADR 116). Zeigt die Domain richtig auf public/, wird diese
+# Datei nie gelesen; zeigt sie versehentlich auf den Projektordner, sperrt sie hier alles.
+<IfModule mod_authz_core.c>
+    Require all denied
+</IfModule>
+<IfModule !mod_authz_core.c>
+    Order deny,allow
+    Deny from all
+</IfModule>

migrations/Version20261012000100.php

@@ -0,0 +1,32 @@
+<?php
+
+namespace DoctrineMigrations;
+
+use Doctrine\DBAL\Schema\Schema;
+use Doctrine\Migrations\AbstractMigration;
+
+final class Version20261012000100 extends AbstractMigration
+{
+    public function getDescription(): string
+    {
+        return 'Geplante Veröffentlichung: welche Fassung zum Termin online geht (ADR 116).';
+    }
+
+    public function isTransactional(): bool
+    {
+        return false;
+    }
+
+    public function up(Schema $schema): void
+    {
+        // Bisher ging zum Termin der jeweils neueste Entwurf online - auch einer, den nach dem
+        // Planen jemand ohne Recht zum Veröffentlichen gespeichert hatte. Jetzt merkt sich die
+        // Planung die Fassung, die beim Planen vorlag. Eine Spalte, kein Tabellenneubau.
+        $schema->getTable('page')->addColumn('publish_revision_id', 'string', ['length' => 32, 'notnull' => false, 'default' => null]);
+    }
+
+    public function down(Schema $schema): void
+    {
+        $schema->getTable('page')->dropColumn('publish_revision_id');
+    }
+}

plugins/.htaccess

@@ -0,0 +1,9 @@
+# Dieser Ordner gehoert nicht ins Netz (ADR 116). Zeigt die Domain richtig auf public/, wird diese
+# Datei nie gelesen; zeigt sie versehentlich auf den Projektordner, sperrt sie hier alles.
+<IfModule mod_authz_core.c>
+    Require all denied
+</IfModule>
+<IfModule !mod_authz_core.c>
+    Order deny,allow
+    Deny from all
+</IfModule>

public/.htaccess

@@ -2,7 +2,14 @@ DirectoryIndex index.php
 Options -Indexes -MultiViews
 
 # Alles, was keine Datei ist, beantwortet PHP.
+#
+# Die Zeile fuer index.php selbst ist kein Zierrat: Bei IONOS erkennt !-f die bereits
+# umgeschriebene index.php nicht als Datei, die Regel greift wieder und wieder, und Apache bricht
+# nach zehn Runden mit einem weissen 500er ab (huefner-gartenbau.de, 12.10.2026). Dieselbe
+# Absicherung steht in der .htaccess von WordPress.
 RewriteEngine On
+RewriteBase /
+RewriteRule ^index\.php$ - [L]
 RewriteCond %{REQUEST_FILENAME} !-f
 RewriteRule ^ index.php [L]
 

public/assets/admin.css

@@ -1,3 +1,5 @@
+/* Der Strich aller Symbole aus icon.html.twig, wie auf der Website (site.css). */
+svg.block-icon{fill:none;stroke:currentColor;stroke-width:1.6;stroke-linecap:round;stroke-linejoin:round}
 /* Administration: shared foundation and the management screens.
    The editor has its own stylesheet (editor.css) that only the editor and the media page load. */
 
@@ -1049,3 +1051,34 @@ details.form-card > summary.form-card-summary::before, details.form-card[open] >
 .language-texts h3 { margin: 0 0 6px; font-size: 15px }
 .language-text-group { display: grid; gap: 6px; border: 1px solid #dfe5e1; border-radius: 8px; padding: 12px 16px; margin: 12px 0; min-width: 0 }
 .language-text-group legend { font-weight: 600; padding: 0 4px }
+/* ---- Update mit einem Klick (ADR 113), nach dem Vorbild von reiseSoft --------------------- */
+.update-wait, .update-aktuell { display: flex; align-items: center; gap: 10px; margin: 0 0 12px }
+.update-spinner { width: 16px; height: 16px; flex: none; border: 2px solid currentColor; border-right-color: transparent; border-radius: 50%; animation: update-dreh .8s linear infinite }
+@keyframes update-dreh { to { transform: rotate(360deg) } }
+@media (prefers-reduced-motion: reduce) { .update-spinner { animation-duration: 2.4s } }
+.update-neu { border: 1px solid #b9d7c2; background: #f1f8f2; border-radius: 10px; padding: 16px 18px; margin: 0 0 14px; display: grid; gap: 6px; justify-items: start }
+.update-neu h3 { margin: 0; font-size: 17px }
+.update-neu .muted { margin: 0 }
+.update-neu-label { margin: 0; font-size: 11px; font-weight: 700; letter-spacing: .08em; text-transform: uppercase; color: #1f6b45 }
+.update-notizen { max-height: 220px; overflow: auto; width: 100%; font-size: 13px; line-height: 1.55; color: #33413a; background: #fff; border: 1px solid #dfe5e1; border-radius: 8px; padding: 10px 12px; margin: 6px 0 10px }
+.update-lauf { background: #1f2d27; color: #e9efe9; border-radius: 12px; padding: 18px 20px; margin: 0 0 14px; display: grid; gap: 12px; justify-items: start }
+.update-lauf-kopf { display: flex; align-items: center; gap: 10px; margin: 0; font-weight: 650 }
+.update-schritte { list-style: none; margin: 0; padding: 0; display: grid; gap: 8px; width: 100% }
+.update-schritt { display: flex; align-items: center; gap: 10px; font-size: 14px }
+.update-marke { display: grid; place-items: center; width: 22px; height: 22px; flex: none; border-radius: 50%; border: 2px solid #5e6f66; font-size: 12px; font-weight: 700 }
+.update-schritt.is-erledigt .update-marke { background: #3fa46a; border-color: #3fa46a; color: #fff }
+.update-schritt.is-aktiv .update-marke { border-color: #f2c14e; box-shadow: 0 0 0 4px #f2c14e33; animation: update-puls 1.2s ease-in-out infinite }
+.update-schritt.is-offen { color: #8f9e96 }
+.update-schritt.is-fehler .update-marke { background: #d4553f; border-color: #d4553f; color: #fff }
+@keyframes update-puls { 50% { box-shadow: 0 0 0 8px #f2c14e11 } }
+@media (prefers-reduced-motion: reduce) { .update-schritt.is-aktiv .update-marke { animation: none } }
+.update-meldung { margin: 0; font-size: 13px; color: #c9d4cd }
+.update-meldung.is-ok { color: #9fdcb5 }
+.update-meldung.is-fehler { color: #ffb4a6 }
+.update-lauf .secondary { background: transparent; color: #fff; border-color: #ffffff66 }
+.update-letztes { margin: 0 0 12px }
+.update-manual { margin-top: 6px }
+.update-dialog { max-width: 460px; border: 0; border-radius: 12px; padding: 24px 26px; box-shadow: 0 18px 48px #0003 }
+.update-dialog::backdrop { background: #1f2d2766 }
+.update-dialog h2 { margin: 0 0 10px; font-size: 18px }
+.update-dialog .dialog-actions { display: flex; justify-content: flex-end; gap: 10px; margin-top: 18px }

public/assets/consent.js

@@ -0,0 +1,91 @@
+// Einwilligung ohne Neuladen (ADR 115).
+//
+// Ohne dieses Skript schicken der Hinweis und der Knopf am eingebetteten Inhalt ein Formular ab,
+// der Server setzt das Cookie und leitet auf dieselbe Seite zurück - die Seite lädt neu. Mit dem
+// Skript geht dasselbe Formular im Hintergrund an denselben Endpunkt; die Kopfzeile
+// X-Kant-Consent sagt dem Server, dass keine Weiterleitung nötig ist. Danach holt das Skript die
+// Seite noch einmal und übernimmt daraus nur, was sich durch die Entscheidung ändert: die
+// eingebetteten Inhalte und die Zeile „Rechtliches“. Die Adresse eines Inhalts steht so weiterhin
+// erst nach der Einwilligung im Dokument.
+//
+// Geht dabei etwas schief, schickt das Skript das Formular ganz normal ab: lieber einmal neu
+// laden als eine Entscheidung, die nicht ankommt.
+(() => {
+  const forms = document.querySelectorAll('.consent-bar form, .embed-blocked form');
+  if (forms.length === 0) {
+    return;
+  }
+
+  const replaceFrom = async () => {
+    const response = await fetch(location.href, { credentials: 'same-origin', headers: { Accept: 'text/html' } });
+    if (!response.ok) {
+      throw new Error('Seite nicht geladen');
+    }
+    const fresh = new DOMParser().parseFromString(await response.text(), 'text/html');
+    for (const blocked of document.querySelectorAll('.embed-blocked[id]')) {
+      const next = fresh.getElementById(blocked.id);
+      if (next && !next.classList.contains('embed-blocked')) {
+        blocked.replaceWith(document.importNode(next, true));
+      }
+    }
+    for (const legal of document.querySelectorAll('.block-legal[id]')) {
+      const next = fresh.getElementById(legal.id);
+      if (next) {
+        legal.replaceWith(document.importNode(next, true));
+      }
+    }
+  };
+
+  for (const form of forms) {
+    form.addEventListener('submit', async (event) => {
+      event.preventDefault();
+      const button = event.submitter;
+      const body = new FormData(form, button);
+      const placeholder = form.closest('.embed-blocked');
+      for (const control of form.querySelectorAll('button')) {
+        control.disabled = true;
+      }
+      try {
+        const saved = await fetch(form.action, { method: 'POST', body, credentials: 'same-origin', headers: { 'X-Kant-Consent': '1' } });
+        if (!saved.ok) {
+          throw new Error('Entscheidung nicht gespeichert');
+        }
+        // Wer etwas erlaubt hat, bekommt die Inhalte jetzt; wer abgelehnt hat, braucht keinen
+        // zweiten Abruf - es ändert sich nichts außer dem Hinweis.
+        if (body.get('choice') !== 'none' && document.querySelector('.embed-blocked')) {
+          await replaceFrom();
+        }
+        document.querySelector('.consent-bar')?.remove();
+        if (placeholder) {
+          // Der Knopf ist mit dem Platzhalter verschwunden; der Fokus geht an den Inhalt, der an
+          // seiner Stelle steht.
+          const frame = document.getElementById(placeholder.id)?.querySelector('iframe');
+          frame?.focus();
+        } else {
+          // Entschieden im Hinweis: der Fokus beginnt wieder am Seitenanfang, wie nach dem
+          // Neuladen - der nächste Tab führt zu „Zum Inhalt springen“.
+          document.getElementById('seitenanfang')?.focus({ preventScroll: true });
+        }
+      } catch {
+        // Rückfall: das Formular normal absenden, samt gedrücktem Knopf.
+        for (const control of form.querySelectorAll('button')) {
+          control.disabled = false;
+        }
+        withChoice(form, button).submit();
+      }
+    });
+  }
+
+  // form.submit() schickt den gedrückten Knopf nicht mit; sein Wert wandert als verstecktes Feld
+  // ins Formular, damit der Rückfall dieselbe Entscheidung sendet.
+  function withChoice(form, button) {
+    if (button?.name) {
+      const field = document.createElement('input');
+      field.type = 'hidden';
+      field.name = button.name;
+      field.value = button.value;
+      form.append(field);
+    }
+    return form;
+  }
+})();

public/assets/icons.js

@@ -107,6 +107,10 @@ export const ICON_PATHS = {
   hardware: 'M4 5h16v11H4Zm4 15h8m-4-4v4',
   network: 'M5 3h14v5H5Zm0 13h14v5H5Zm7-8v8M8 8v3h8V8',
   design: 'M4 20h16M6 16 18 4l3 3L9 19l-4 1Z',
+  // Soziale Netzwerke
+  facebook: 'M15.5 4h-2.2A3.8 3.8 0 0 0 9.5 7.8V10H7v3.2h2.5V20h3.3v-6.8h2.4l.5-3.2h-2.9V8.2c0-.6.3-.9.9-.9h2Z',
+  instagram: 'M8.1 3.5h7.8a4.6 4.6 0 0 1 4.6 4.6v7.8a4.6 4.6 0 0 1-4.6 4.6H8.1a4.6 4.6 0 0 1-4.6-4.6V8.1a4.6 4.6 0 0 1 4.6-4.6ZM12 8.1a3.9 3.9 0 1 0 0 7.8 3.9 3.9 0 0 0 0-7.8ZM17 7h.01',
+  whatsapp: 'M4 20l1.4-4A8.5 8.5 0 1 1 8.6 19.1ZM9.3 9.2c0 3 2.5 5.5 5.5 5.5l1.3-1.4-2-.9-.9.8a4.1 4.1 0 0 1-2.3-2.3l.8-.9-.9-2Z',
 };
 
 export const ICON_LABELS = {
@@ -130,6 +134,7 @@ export const ICON_LABELS = {
   check: 'Häkchen', 'check-circle': 'Häkchen im Kreis', info: 'Info', help: 'Frage', alert: 'Warnung',
   search: 'Suche', settings: 'Einstellungen', filter: 'Filter', grid: 'Raster', list: 'Liste', sparkle: 'Funkeln',
   coffee: 'Kaffee', utensils: 'Besteck', laptop: 'Laptop', hardware: 'Bildschirm', network: 'Netzwerk', design: 'Stift',
+  facebook: 'Facebook', instagram: 'Instagram', whatsapp: 'WhatsApp',
 };
 
 /** Die Kategorien des Auswahlfensters, in der Reihenfolge der Reiter. Jedes Symbol steht genau einmal. */
@@ -141,6 +146,7 @@ export const ICON_GROUPS = [
   ['Personen & Sicherheit', ['user', 'people', 'login', 'lock', 'key', 'shield', 'eye', 'thumbs-up', 'award', 'graduation', 'heart', 'star']],
   ['Haus & Handwerk', ['home', 'building', 'wrench', 'hammer', 'brush', 'ruler', 'leaf', 'tree', 'sun', 'droplet', 'flame', 'bolt', 'solar', 'thermometer', 'snowflake', 'car']],
   ['Allgemein', ['check', 'check-circle', 'info', 'help', 'alert', 'search', 'settings', 'filter', 'grid', 'list', 'sparkle', 'coffee', 'utensils', 'laptop', 'hardware', 'network', 'design']],
+  ['Soziale Netzwerke', ['facebook', 'instagram', 'whatsapp']],
 ];
 
 const svgNS = 'http://www.w3.org/2000/svg';

public/assets/site.css

@@ -264,6 +264,8 @@ body.consent-open{padding-bottom:320px}
 /* A single icon, sized by class because inline styles are forbidden by the policy. */
 .block-icon{display:inline-flex;align-items:center;justify-content:center;color:var(--accent);line-height:0}
 .block-icon svg{width:100%;height:100%;display:block}
+/* Der Strich aller Symbole (icon.html.twig) - einmal hier statt als Attribute an jedem einzelnen. */
+svg.block-icon{fill:none;stroke:currentColor;stroke-width:1.6;stroke-linecap:round;stroke-linejoin:round}
 /* Das eingebettete SVG traegt dieselbe Klasse wie seine Huelle und setzte deshalb die
    Akzentfarbe erneut - eine am Symbolblock eingestellte Farbe kam nie an. */
 .block-icon .block-icon{color:inherit}
@@ -475,6 +477,12 @@ body.consent-open{padding-bottom:320px}
   .menu-collapse-mobile>.menu-list{display:none}
 }
 .menu-burger>summary{min-height:44px;min-width:44px}
+/* Ein Klick neben das aufgeklappte Menue schliesst es - ohne Skript: Solange es offen ist, liegt
+   eine unsichtbare Flaeche ueber der Seite, die zum Menue-Knopf gehoert. Ein Klick darauf ist ein
+   Klick auf den Knopf, und der klappt zu. Die Flaeche des Menues liegt darueber und bleibt
+   bedienbar; :where() haelt die Regel schwaecher als die Platzierung im Kopfbereich. */
+.menu-burger[open]>summary::before{content:'';position:fixed;top:0;right:0;bottom:0;left:0;z-index:29;cursor:default}
+:where(.menu-burger[open])>.menu-burger-body{position:relative;z-index:30}
 .menu-burger-body{overflow-wrap:anywhere}
 /* Im Kopfbereich klappt das Menue als Flaeche unter dem Kopf auf, ueber die volle Breite.
    Inline geoeffnet stand es sonst in der schmalen Spalte neben der Marke und schob den

public/assets/system-update.js

@@ -0,0 +1,190 @@
+/*
+ * Update mit einem Klick (ADR 113), nach dem Vorbild von reiseSoft.
+ *
+ * Beim Öffnen der Systemseite fragt sie selbst, ob es eine neue Fassung gibt, und zeigt deren
+ * Hinweise und einen Knopf. Nach der Bestätigung startet eine Anfrage das Update (Sichern, Laden,
+ * Umschalten); diese Seite fragt währenddessen alle anderthalb Sekunden den Fortschritt ab. Ist
+ * der Tausch durch, ruft sie den Abschluss auf - eine neue Anfrage mit dem neuen Code:
+ * Datenbank anpassen, prüfen, Wartungsseite aus. Schlägt etwas fehl, schaltet der Server zurück
+ * und die Seite sagt es.
+ *
+ * Ohne Skript bleiben die Formulare unter „Weitere Möglichkeiten“.
+ */
+const karte = document.querySelector('[data-update]');
+if (karte) {
+  const live = karte.querySelector('[data-update-live]');
+  const dialog = document.getElementById('update-dialog');
+  const csrf = karte.dataset.csrf;
+  const SCHRITTE = [
+    ['sichern', 'Daten sichern'],
+    ['laden', 'Fassung laden und prüfen'],
+    ['umschalten', 'Umschalten'],
+    ['migrieren', 'Datenbank anpassen'],
+    ['pruefen', 'Funktion prüfen'],
+  ];
+  let ziel = null, timer = null, laeuft = false;
+
+  const el = (tag, className, text) => {
+    const node = document.createElement(tag);
+    if (className) node.className = className;
+    if (text !== undefined) node.textContent = text;
+    return node;
+  };
+  const datum = iso => iso ? new Date(iso + 'T00:00:00').toLocaleDateString('de-DE', { day: 'numeric', month: 'long', year: 'numeric' }) : '';
+  const abfragen = async url => {
+    const antwort = await fetch(url, { credentials: 'same-origin', cache: 'no-store', headers: { Accept: 'application/json' } });
+    if (!antwort.ok) throw new Error(String(antwort.status));
+    return antwort.json();
+  };
+  const senden = async (url, daten) => {
+    const antwort = await fetch(url, {
+      method: 'POST', credentials: 'same-origin', cache: 'no-store',
+      headers: { 'X-CSRF-Token': csrf, Accept: 'application/json' },
+      body: new URLSearchParams(daten),
+    });
+    const text = await antwort.text();
+    try { return JSON.parse(text); } catch { throw new Error(`Antwort ${antwort.status}`); }
+  };
+
+  // Die Hinweise der Releaseseite sind Markdown. Gezeigt wird Text mit Zeilen und **fett** -
+  // als Textknoten, nie als HTML: was dort steht, kommt von außen.
+  function notizen(text) {
+    const box = el('div', 'update-notizen');
+    text.split('\n').forEach((zeile, index) => {
+      if (index) box.append(document.createElement('br'));
+      zeile.replace(/^#+\s*/, '').split(/(\*\*[^*]+\*\*)/).forEach(teil => {
+        box.append(teil.startsWith('**') && teil.endsWith('**') && teil.length > 4 ? el('strong', '', teil.slice(2, -2)) : document.createTextNode(teil));
+      });
+    });
+    return box;
+  }
+
+  // ------------------------------------------------------------------ Ansicht: Prüfen
+  function warten(text) {
+    live.hidden = false;
+    live.replaceChildren(el('p', 'update-wait', text));
+    live.firstChild.prepend(el('span', 'update-spinner'));
+  }
+
+  function zeigeErgebnis(daten) {
+    live.hidden = false;
+    live.replaceChildren();
+    const letzter = daten.status;
+    if (letzter && !letzter.laeuft && ['fertig', 'fehler', 'zurueckgerollt'].includes(letzter.phase) && letzter.auf) {
+      const box = el('p', `notice ${letzter.phase === 'fertig' ? 'done' : 'error'} update-letztes`);
+      box.append(el('strong', '', letzter.phase === 'fertig' ? `Letztes Update auf ${letzter.auf} erfolgreich.` : `Letztes Update auf ${letzter.auf} nicht durchgelaufen.`));
+      if (letzter.phase !== 'fertig') box.append(' ', letzter.meldung || '');
+      live.append(box);
+    }
+    if (daten.fehler) {
+      const zeile = el('p', 'notice error', daten.fehler + ' ');
+      const nochmal = el('button', 'link-button', 'Erneut fragen'); nochmal.type = 'button';
+      nochmal.addEventListener('click', pruefen);
+      zeile.append(nochmal); live.append(zeile);
+      return;
+    }
+    if (!daten.neu) {
+      live.append(el('p', 'update-aktuell', `Du bist auf dem neuesten Stand (${daten.installiert}).`));
+      return;
+    }
+    ziel = daten.neu.version;
+    const box = el('div', 'update-neu');
+    box.append(el('p', 'update-neu-label', 'Neue Fassung verfügbar'));
+    box.append(el('h3', '', daten.neu.name || `KantSites ${ziel}`));
+    box.append(el('p', 'muted', [ziel, daten.neu.datum ? `veröffentlicht am ${datum(daten.neu.datum)}` : ''].filter(Boolean).join(' · ')));
+    if (daten.neu.notizen) box.append(notizen(daten.neu.notizen));
+    const knopf = el('button', 'primary', 'Jetzt aktualisieren'); knopf.type = 'button';
+    knopf.addEventListener('click', () => { dialog.querySelector('[data-update-ziel]').textContent = ziel; dialog.showModal(); });
+    box.append(knopf);
+    live.append(box);
+  }
+
+  async function pruefen() {
+    warten('Frage nach neuen Fassungen …');
+    try {
+      const daten = await abfragen(karte.dataset.pruefen);
+      if (daten.status?.laeuft) { zeigeLauf(daten.status); verfolgen(); return; }
+      zeigeErgebnis(daten);
+    } catch {
+      zeigeErgebnis({ fehler: 'Die Abfrage ist fehlgeschlagen.' });
+    }
+  }
+
+  // ------------------------------------------------------------------ Ansicht: Lauf
+  function zeigeLauf(status, server = true) {
+    live.hidden = false;
+    const box = el('div', 'update-lauf');
+    const kopf = el('p', 'update-lauf-kopf');
+    const ende = ['fertig', 'fehler', 'zurueckgerollt'].includes(status.phase);
+    if (!ende) kopf.append(el('span', 'update-spinner'));
+    kopf.append(ende
+      ? (status.phase === 'fertig' ? `Update auf ${status.auf} abgeschlossen` : `Update auf ${status.auf} nicht durchgelaufen`)
+      : `Update auf ${status.auf || ziel || ''} läuft`);
+    box.append(kopf);
+    // Bei einem Fehler oder beim Zurückschalten markiert die Liste den Schritt, in dem es passierte.
+    const gescheitert = ['fehler', 'zurueckgerollt', 'zurueckschalten'].includes(status.phase);
+    const aktuell = gescheitert
+      ? Math.max(0, SCHRITTE.findIndex(([phase]) => phase === status.bei))
+      : SCHRITTE.findIndex(([phase]) => phase === status.phase);
+    const liste = el('ol', 'update-schritte');
+    SCHRITTE.forEach(([phase, text], index) => {
+      let zustand = index < aktuell || status.phase === 'fertig' ? 'erledigt' : index === aktuell && !ende ? 'aktiv' : 'offen';
+      if (gescheitert && index === aktuell) zustand = 'fehler';
+      const punkt = el('li', `update-schritt is-${zustand}`);
+      punkt.append(el('span', 'update-marke', zustand === 'erledigt' ? '✓' : zustand === 'fehler' ? '!' : ''), el('span', '', text));
+      punkt.querySelector('.update-marke').setAttribute('aria-hidden', 'true');
+      punkt.append(el('span', 'visually-hidden', { erledigt: ' – erledigt', aktiv: ' – läuft', offen: '', fehler: ' – fehlgeschlagen' }[zustand]));
+      liste.append(punkt);
+    });
+    box.append(liste);
+    const meldung = el('p', `update-meldung${status.phase === 'fertig' ? ' is-ok' : ende ? ' is-fehler' : ''}`,
+      server ? (status.meldung || '') : 'Der Server tauscht gerade die Dateien – die Seite meldet sich gleich wieder.');
+    box.append(meldung);
+    if (ende) {
+      const weiter = el('button', 'secondary', status.phase === 'fertig' ? 'Seite neu laden' : 'Zur Übersicht'); weiter.type = 'button';
+      weiter.addEventListener('click', () => location.reload());
+      box.append(weiter);
+    }
+    live.replaceChildren(box);
+  }
+
+  async function tick() {
+    try {
+      const daten = await abfragen(karte.dataset.status);
+      if (daten.status) zeigeLauf(daten.status);
+      if (daten.installiert) karte.querySelector('[data-update-installiert]').textContent = daten.installiert;
+      if (daten.status && !daten.status.laeuft && !laeuft) stoppen();
+    } catch {
+      // Während des Tauschs kann eine Abfrage scheitern; die nächste klappt wieder.
+      const letzter = live.querySelector('.update-meldung');
+      if (letzter) letzter.textContent = 'Der Server tauscht gerade die Dateien – die Seite meldet sich gleich wieder.';
+    }
+  }
+  function verfolgen() { if (!timer) timer = setInterval(tick, 1500); }
+  function stoppen() { clearInterval(timer); timer = null; }
+
+  async function starten() {
+    dialog.close();
+    laeuft = true;
+    zeigeLauf({ phase: 'sichern', auf: ziel, meldung: 'Das Update beginnt …', laeuft: true });
+    verfolgen();
+    try {
+      const start = await senden(karte.dataset.starten, { version: ziel });
+      if (!start.ok) throw Object.assign(new Error(start.meldung || 'Das Update ist nicht durchgelaufen.'), { status: start.status });
+      const ende = await senden(karte.dataset.abschliessen, { token: start.token });
+      laeuft = false;
+      await tick();
+      stoppen();
+      if (ende.ok) setTimeout(() => location.reload(), 2500);
+    } catch (fehler) {
+      laeuft = false;
+      await tick();
+      stoppen();
+      if (!live.querySelector('.update-meldung.is-fehler')) zeigeLauf(fehler.status || { phase: 'fehler', auf: ziel, meldung: fehler.message });
+    }
+  }
+
+  dialog.querySelector('[data-update-abbrechen]').addEventListener('click', () => dialog.close());
+  dialog.querySelector('[data-update-los]').addEventListener('click', starten);
+  pruefen();
+}

public/index.php

@@ -1,6 +1,7 @@
 <?php
 
 use App\Kernel;
+use App\Ops\Notfall;
 use Symfony\Component\HttpFoundation\Request;
 
 // PHP nennt in jeder Antwort seine genaue Fassung („X-Powered-By: PHP/8.4.22"). Das nützt
@@ -8,9 +9,19 @@ use Symfony\Component\HttpFoundation\Request;
 // Hosting laesst sich expose_php nicht umstellen, dieser Aufruf wirkt trotzdem.
 header_remove('X-Powered-By');
 
-require dirname(__DIR__).'/config/bootstrap.php';
-$kernel = new Kernel($_SERVER['APP_ENV'], (bool) $_SERVER['APP_DEBUG']);
-$request = Request::createFromGlobals();
-$response = $kernel->handle($request);
-$response->send();
-$kernel->terminate($request, $response);
+// Die Notfallschicht zuerst und ohne Autoloader (ADR 113): Scheitert alles Weitere - fehlende
+// Abhängigkeiten, eine unlesbare Datenbank, ein Fehler beim Start -, sehen Besucher eine
+// Wartungsseite statt einer weißen Seite, und der Grund steht in var/log/notfall.log.
+require_once dirname(__DIR__).'/src/Ops/Notfall.php';
+Notfall::einschalten(dirname(__DIR__));
+
+try {
+    require dirname(__DIR__).'/config/bootstrap.php';
+    $kernel = new Kernel($_SERVER['APP_ENV'], (bool) $_SERVER['APP_DEBUG']);
+    $request = Request::createFromGlobals();
+    $response = $kernel->handle($request);
+    $response->send();
+    $kernel->terminate($request, $response);
+} catch (Throwable $fehler) {
+    Notfall::ausnahme($fehler, $_SERVER['REQUEST_URI'] ?? '');
+}

scripts/browser-check.mjs

@@ -69,7 +69,8 @@ try {
       const queries = Number(response.headers()['x-kant-queries'] ?? -1);
       const html = (await response.text()).length;
       const styles = [...transferred.values()].filter(entry => entry.type === 'text/css').reduce((sum, entry) => sum + entry.length, 0);
-      const scripts = [...transferred.values()].filter(entry => entry.type.includes('javascript')).length;
+      // consent.js zählt nicht: nur solange eine Einwilligung offen ist (ADR 115).
+      const scripts = [...transferred.entries()].filter(([url, entry]) => entry.type.includes('javascript') && !url.includes('/assets/consent.js')).length;
       const requests = transferred.size;
       // Bilder gehören zum Inhalt: eine bebilderte Startseite lädt zu Recht mehr Dateien als eine
       // Textseite. Gedeckelt wird deshalb das Beiwerk (Stile, Schriften, Skripte) und das
@@ -114,7 +115,9 @@ try {
       assert.equal(await page.locator('h1').count(), 1);
       // Strukturierte Daten stehen zwar in einem script-Element, führen aber nichts aus. Gezählt
       // wird, was laufen kann - und das nur, wenn die Seite es in ihrer eigenen Richtlinie erlaubt.
-      const laufend = await page.locator('script:not([type="application/ld+json"])').count();
+      // consent.js zählt nicht mit: Es steht nur auf der Seite, solange eine Einwilligung offen ist,
+      // und nach der Entscheidung nicht mehr (ADR 115).
+      const laufend = await page.locator('script:not([type="application/ld+json"]):not([src^="/assets/consent.js"])').count();
       const darfSkripte = !/script-src 'none'/.test(response.headers()['content-security-policy'] ?? '');
       assert.ok(darfSkripte ? laufend <= 3 : 0 === laufend, `${path}: ${laufend} Skript(e), erlaubt ${darfSkripte ? 3 : 0}`);
       // Einblendungen zu Ende spielen, bevor gemessen wird: mitten in einer Einblendung ist ein
@@ -162,7 +165,8 @@ try {
     const hinweis = page.locator('.consent-bar button[value="none"]');
     if (await hinweis.count()) {
         await hinweis.click();
-        await page.waitForLoadState('domcontentloaded');
+        // Mit consent.js ohne Neuladen (ADR 115): warten, bis der Hinweis weg ist.
+        await page.locator('.consent-bar').waitFor({ state: 'detached' });
     }
     await page.keyboard.press('Tab');
     assert.equal(await page.locator(':focus').innerText(), 'Zum Inhalt springen');
@@ -171,7 +175,8 @@ try {
     // Weiter mit der Tastatur: der erste Verweis im Inhalt muss anklickbar sein und tatsächlich
     // woandershin führen. Vorher standen hier die Linktexte der Demo - gegen jede andere
     // Installation lief die Prüfung damit ins Leere statt etwas zu prüfen.
-    const ersterLink = page.locator('main a[href^="/"]').first();
+    // Ein PDF zum Herunterladen ist keine Seite mit Überschrift; es zählt hier nicht mit.
+    const ersterLink = page.locator('main a[href^="/"]:not([href$=".pdf"])').first();
     const ziel = await ersterLink.getAttribute('href');
     await ersterLink.click();
     assert.equal(new URL(page.url()).pathname, ziel.split('#')[0] || '/');
@@ -189,7 +194,7 @@ try {
       await noJs.waitForLoadState('domcontentloaded');
   }
   assert.equal(await noJs.locator('h1').count(), 1);
-  const ohneJs = noJs.locator('main a[href^="/"]').first();
+  const ohneJs = noJs.locator('main a[href^="/"]:not([href$=".pdf"])').first();
   const zielOhneJs = await ohneJs.getAttribute('href');
   await ohneJs.click();
   assert.equal(new URL(noJs.url()).pathname, zielOhneJs.split('#')[0] || '/');

scripts/build-huefner-assets.php

@@ -4,10 +4,15 @@
  * Bereitet die Bilder des Hüfner-Entwurfs für die Mediathek vor.
  *
  * Kopiert die Fotos und das Logo aus dem gelieferten Ordner (images/) und schneidet aus dem Logo
- * den Baum mit den Steinen als quadratisches Seitensymbol (favicon.png) heraus. Der Baum ist im
+ * den Baum (ohne die Steine) als quadratisches Seitensymbol (favicon.png) heraus. Der Baum ist im
  * Logo links, der Schriftzug rechts; ein Favicon mit Schrift wäre in 32 px unlesbar.
  *
- * Aufruf: php scripts/build-huefner-assets.php <Quellordner mit images/> <Zielordner>
+ * Aufruf: php scripts/build-huefner-assets.php <Quellordner mit images/> <Zielordner> [<Unterlagen>]
+ *
+ * Das dritte Argument ist Umuts Ordner „unterlagenfrwebsite“ (12.10.2026): Alpaka-Fotos, PQ-Logo,
+ * Galabau-Signet und die drei PDFs. Sie bekommen hier feste, einfache Namen, damit das Seed-Skript
+ * nicht an „Freistellungsbescheinigung §48 … bis 11.05.2029.pdf“ hängt. Kommt eine neue
+ * Bescheinigung, genügt es, sie nach dem gleichen Muster benannt in den Ordner zu legen.
  */
 $quelle = rtrim($argv[1] ?? '', '/\\');
 $ziel = rtrim($argv[2] ?? '', '/\\');
@@ -24,22 +29,76 @@ foreach (glob($quelle.'/images/*.{jpg,png}', GLOB_BRACE) ?: [] as $datei) {
     copy($datei, $ziel.'/'.basename($datei));
 }
 
-// Baum und Steine: im 1600 x 607 px großen Logo etwa x 15–500, y 10–560.
+// Nur der Baum: Krone (grün) und Stamm (dunkel) aus dem linken Teil des Logos, ohne die grauen
+// Steine - die liefen bisher rechts aus dem Ausschnitt und sind in 32 px nur Rauschen (Umut,
+// 12.10.2026: „schneide bitte den Baum zurecht“). Der Stamm ist dunkler als die Steine.
 $logo = imagecreatefrompng($quelle.'/images/logo.png');
 if (false === $logo) {
     fwrite(STDERR, "logo.png lässt sich nicht lesen.\n");
     exit(1);
 }
+$punkte = [];
+[$bx0, $by0, $bx1, $by1] = [PHP_INT_MAX, PHP_INT_MAX, 0, 0];
+for ($y = 10; $y < 520; ++$y) {
+    for ($x = 10; $x < 500; ++$x) {
+        $c = imagecolorat($logo, $x, $y);
+        if ((($c >> 24) & 127) > 100) {
+            continue;
+        }
+        [$r, $g, $b] = [($c >> 16) & 255, ($c >> 8) & 255, $c & 255];
+        if ($g > $r + 30 || ($r + $g + $b) / 3 < 70) {
+            $punkte[] = [$x, $y, $c];
+            [$bx0, $by0, $bx1, $by1] = [min($bx0, $x), min($by0, $y), max($bx1, $x), max($by1, $y)];
+        }
+    }
+}
+$baum = imagecreatetruecolor($bx1 - $bx0 + 1, $by1 - $by0 + 1);
+imagesavealpha($baum, true);
+imagealphablending($baum, false);
+imagefill($baum, 0, 0, imagecolorallocatealpha($baum, 0, 0, 0, 127));
+foreach ($punkte as [$x, $y, $c]) {
+    imagesetpixel($baum, $x - $bx0, $y - $by0, $c);
+}
 $kante = 512;
 $symbol = imagecreatetruecolor($kante, $kante);
 imagesavealpha($symbol, true);
 imagealphablending($symbol, false);
 imagefill($symbol, 0, 0, imagecolorallocatealpha($symbol, 0, 0, 0, 127));
-imagealphablending($symbol, true);
-[$x, $y, $b, $h] = [15, 10, 490, 550];
-$massstab = min(($kante - 24) / $b, ($kante - 24) / $h);
+[$b, $h] = [imagesx($baum), imagesy($baum)];
+$massstab = min(($kante - 32) / $b, ($kante - 32) / $h);
 $zb = (int) round($b * $massstab);
 $zh = (int) round($h * $massstab);
-imagecopyresampled($symbol, $logo, (int) (($kante - $zb) / 2), (int) (($kante - $zh) / 2), $x, $y, $zb, $zh, $b, $h);
+imagecopyresampled($symbol, $baum, (int) (($kante - $zb) / 2), (int) (($kante - $zh) / 2), 0, 0, $zb, $zh, $b, $h);
 imagepng($symbol, $ziel.'/favicon.png');
 echo "Bilder kopiert, Seitensymbol geschnitten: $ziel\n";
+
+$unterlagen = rtrim($argv[3] ?? '', '/\\');
+if ('' === $unterlagen) {
+    exit(0);
+}
+// Muster im Ordner => fester Name. Bei mehreren Treffern gewinnt der letzte in Namensreihenfolge.
+$feste = [
+    'Alpaka (1).jpeg' => 'alpaka-plakat.jpg',
+    'Alpaka (2).jpeg' => 'alpaka-wiese.jpg',
+    'Alpaka (3).jpeg' => 'alpaka-stall.jpg',
+    'Alpaka (4).jpeg' => 'alpaka-blume.jpg',
+    'Alpaka (6).jpeg' => 'alpaka-zaunbau.jpg',
+    'Alpaka (9).jpeg' => 'alpaka-rasen.jpg',
+    'PQ-Logo*.png' => 'pq-logo.png',
+    'Signum*.png' => 'galabau-signet.png',
+    '100-emoji.png' => 'hundert.png',
+    'PQ-Bescheinigung*.pdf' => 'pq-bescheinigung.pdf',
+    'Freistellungsbescheinigung §13*.pdf' => 'freistellung-13b.pdf',
+    'Freistellungsbescheinigung §48*.pdf' => 'freistellung-48b.pdf',
+];
+$dateien = scandir($unterlagen) ?: [];
+foreach ($feste as $muster => $name) {
+    $treffer = array_values(array_filter($dateien, static fn (string $d): bool => fnmatch($muster, $d, FNM_NOESCAPE)));
+    if ([] === $treffer) {
+        fwrite(STDERR, "Fehlt in den Unterlagen: $muster\n");
+        exit(1);
+    }
+    sort($treffer);
+    copy($unterlagen.'/'.end($treffer), $ziel.'/'.$name);
+}
+echo 'Unterlagen übernommen: '.count($feste)." Dateien\n";

scripts/build-release.php

@@ -67,7 +67,7 @@ echo "Fassung {$version}\n";
 // migrations.php und cli-config.php gehoeren dazu: ohne die erste findet Doctrine beim
 // Einrichten keine Migrationsliste und bricht mit "configuration file does not exist" ab - genau
 // dort, wo eine frische Installation ihre Tabellen anlegen will.
-$include = ['bin', 'config', 'migrations', 'plugins', 'public', 'src', 'templates', 'composer.json', 'composer.lock', 'migrations.php', 'cli-config.php', 'VERSION', 'README.md', '.env.example'];
+$include = ['bin', 'config', 'migrations', 'plugins', 'public', 'src', 'templates', 'composer.json', 'composer.lock', 'migrations.php', 'cli-config.php', 'VERSION', 'README.md', '.env.example', '.htaccess'];
 $skip = ['.git', '.github', '.claude', '.gitattributes', '.gitignore', '.env.lock', '.php-cs-fixer.cache', 'node_modules', 'var', 'tests', 'scripts', 'reports', 'phpunit.xml.dist', '.php-cs-fixer.dist.php', 'package.json', 'package-lock.json', 'AGENTS.md', 'ENTWICKLUNGSPLAN.md', 'docs', 'composer.phar', '.venv', 'vendor', 'phpunit.cache', 'migrations.php.bak'];
 
 $copy = static function (string $from, string $to) use (&$copy, $skip): int {
@@ -116,6 +116,8 @@ if (!$ok) {
     exit(1);
 }
 echo 'vendor/ gebaut'.($flags ? ' ohne Entwicklungspakete' : ' MIT Entwicklungspaketen')."\n";
+// vendor/ gehört nicht ins Netz, auch wenn die Domain falsch zeigt (ADR 116).
+copy($root.'/config/schutz/sperren.htaccess', $staging.'/vendor/.htaccess');
 
 // The environment file is not part of a release: it holds the secret of one installation.
 foreach (['.env.local', '.env.prod.local'] as $secret) {

scripts/install.php

@@ -17,6 +17,9 @@
  *   Eintrag wie ../../.env landet nirgends.
  * - Sie arbeitet nur in ein leeres Verzeichnis. Eine bestehende Installation wird nicht
  *   überschrieben, auch nicht teilweise.
+ * - Nach dem Entpacken legt sie den Installationsschlüssel an (var/install.key, ADR 116) und
+ *   zeigt ihn nur auf ihrer Abschlussseite. Ohne ihn öffnet sich der Installer nicht - wer die
+ *   frische Installation zuerst aufruft, kann sie so nicht übernehmen.
  */
 
 // Vom Buildskript gesetzt: `php scripts/build-release.php` schreibt Adresse und Prüfsumme des
@@ -176,6 +179,27 @@ function kant_checks(string $target): array
     return $checks;
 }
 
+/** Legt den Installationsschlüssel an (oder liest einen vorhandenen) und gibt ihn zurück. */
+function kant_install_key(string $target): string
+{
+    $file = $target.'/var/install.key';
+    $key = is_file($file) ? trim((string) file_get_contents($file)) : '';
+    if (1 === preg_match('/^[a-f0-9]{32}$/D', $key)) {
+        return $key;
+    }
+    if (!is_dir($target.'/var')) {
+        mkdir($target.'/var', 0775, true);
+    }
+    $key = bin2hex(random_bytes(16));
+    if (false === file_put_contents($file, $key."
+")) {
+        throw new RuntimeException('Der Installationsschlüssel ließ sich nicht schreiben (var/install.key).');
+    }
+    @chmod($file, 0600);
+
+    return $key;
+}
+
 /** Der Ablauf, wenn der Knopf gedrückt wurde. Gibt [Erfolg, Meldung] zurück. */
 function kant_run(string $target): array
 {
@@ -192,6 +216,7 @@ function kant_run(string $target): array
             return [false, 'Die Prüfsumme des heruntergeladenen Archivs stimmt nicht. Erwartet: '.KANT_ARCHIVE_SHA256.', erhalten: '.$hash.'. Es wurde nichts entpackt.'];
         }
         $files = kant_unpack($archive, $target);
+        kant_install_key($target);
 
         return [true, 'Entpackt: '.$files.' Dateien.'];
     } catch (Throwable $e) {
@@ -259,7 +284,9 @@ header('X-Robots-Tag: noindex, nofollow');
     <h1>Die Dateien liegen.</h1>
     <p class="lead">Diese Datei hat sich selbst gelöscht. Weiter geht es mit der Einrichtung: Datenbank, Konto, Website.</p>
     <p class="notice done"><?= $e($message) ?></p>
-    <p><a href="install">Zur Einrichtung →</a></p>
+    <?php $key = kant_install_key($target); ?>
+    <p>Dein Installationsschlüssel: <code><?= $e($key) ?></code><br><span style="font-size:13px;color:#5d6b62">Nur diese Seite zeigt ihn an. Der Verweis unten trägt ihn schon; liegt er dir nicht mehr vor, steht er in <code>var/install.key</code>.</span></p>
+    <p><a href="install/schluessel?schluessel=<?= $e($key) ?>" rel="noreferrer">Zur Einrichtung →</a></p>
     <p style="font-size:13px;color:#5d6b62">Führt der Verweis ins Leere, zeigt die Domain nicht auf <code>public/</code>. Das muss beim Hoster eingestellt werden – ohne das wären auch <code>.env</code> und <code>var/</code> über das Netz erreichbar.</p>
 <?php } else { ?>
     <h1>KantSites installieren</h1>

scripts/reset-huefner.sh

@@ -1,6 +1,7 @@
 #!/bin/sh
 # Wirft die Hüfner-Installation weg und baut sie neu auf. Nur fuer den Aufbau gedacht.
 # Erstes Argument: der entpackte Entwurf (Ordner mit index.html und images/).
+# Zweites Argument: Umuts Unterlagen (Alpakas, PQ, Freistellungsbescheinigungen, Signet).
 set -e
 root="C:/Django Project/KantSites"
 php="${PHP_BINARY:-C:/php84/php.exe}"
@@ -8,10 +9,10 @@ export DATABASE_URL="sqlite:///$root/var/huefner.db"
 export MEDIA_DIRECTORY="$root/var/huefner-media"
 assets="$root/var/huefner-assets"
 if [ -n "$1" ]; then
-  "$php" scripts/build-huefner-assets.php "$1" "$assets"
+  "$php" scripts/build-huefner-assets.php "$1" "$assets" "$2"
 fi
-if [ ! -f "$assets/favicon.png" ]; then
-  echo "Bilder fehlen: erst mit dem Ordner des Entwurfs als Argument aufrufen." >&2
+if [ ! -f "$assets/favicon.png" ] || [ ! -f "$assets/pq-bescheinigung.pdf" ]; then
+  echo "Bilder fehlen: erst mit dem Ordner des Entwurfs und den Unterlagen als Argumente aufrufen." >&2
   exit 1
 fi
 rm -f "$root/var/huefner.db"

src/.htaccess

@@ -0,0 +1,9 @@
+# Dieser Ordner gehoert nicht ins Netz (ADR 116). Zeigt die Domain richtig auf public/, wird diese
+# Datei nie gelesen; zeigt sie versehentlich auf den Projektordner, sperrt sie hier alles.
+<IfModule mod_authz_core.c>
+    Require all denied
+</IfModule>
+<IfModule !mod_authz_core.c>
+    Order deny,allow
+    Deny from all
+</IfModule>

src/Content/CustomCode.php

@@ -141,8 +141,15 @@ final class CustomCode
         if (1 !== preg_match('/^[a-zA-Z0-9_-]{1,64}$/D', $blockId)) {
             return '';
         }
+        // Gespeichert wurde nur, was beim Speichern galt. Ist eine Regel inzwischen strenger
+        // (ADR 116), fällt das CSS dieses einen Blocks weg - die Seite selbst bleibt erreichbar.
+        try {
+            $rules = $this->parse($css);
+        } catch (InvalidDocument) {
+            return '';
+        }
         $out = '';
-        foreach ($this->parse($css) as $suffix => $declarations) {
+        foreach ($rules as $suffix => $declarations) {
             if ('' === $declarations) {
                 continue;
             }
@@ -193,6 +200,13 @@ final class CustomCode
             if (1 !== preg_match('/^[a-zA-Z0-9 .:>+~_\[\]="\'-]*$/D', $suffix)) {
                 throw new InvalidDocument(sprintf('„&%s“ ist als verschachtelter Selektor nicht erlaubt.', $suffix));
             }
+            // Geschwister des Elements selbst (`& ~ *`, `& + p`) liegen außerhalb des Blocks - damit
+            // ließe sich die ganze Seite umgestalten. Innerhalb des Blocks bleiben `~` und `+`
+            // erlaubt. Und Anführungszeichen paarweise: ein offener String verschluckte sonst
+            // alle folgenden Regeln der Seite (ADR 116).
+            if (1 === preg_match('/^\s*[~+]/', $suffix) || 0 !== substr_count($suffix, '"') % 2 || 0 !== substr_count($suffix, "'") % 2) {
+                throw new InvalidDocument(sprintf('„&%s“ reicht über den Block hinaus und ist deshalb nicht erlaubt.', $suffix));
+            }
             // Zusammenfuegen statt ersetzen: zweimal derselbe Selektor ist in CSS eine Kaskade,
             // nicht ein Widerruf. Vorher gewann die letzte Regel, und alles, was nur in der
             // ersten stand, verschwand ohne Meldung - gefunden am Projektraster von EB Solar,
@@ -247,7 +261,8 @@ final class CustomCode
                 $out[] = $property.':'.$value;
                 continue;
             }
-            if ('' === $value || 1 !== preg_match('/^[a-zA-Z0-9 ,.%#()\/:_+*-]{1,300}$/D', $value)) {
+            // Kein Kommentaranfang und -ende: ein offener Kommentar verschluckte die Regeln danach.
+            if ('' === $value || 1 !== preg_match('/^[a-zA-Z0-9 ,.%#()\/:_+*-]{1,300}$/D', $value) || str_contains($value, '/*') || str_contains($value, '*/')) {
                 throw new InvalidDocument(sprintf('Der Wert von „%s“ enthält Zeichen, die in eigenem CSS nicht vorgesehen sind.', $property));
             }
             $out[] = $property.':'.$value;

src/Content/DocumentValidator.php

@@ -16,7 +16,7 @@ final class DocumentValidator
     /** Blocks introduced with schema v6 for the sections a marketing page actually needs. */
     public const V6_TYPES = ['iconcard', 'stat', 'quote', 'logos', 'cta', 'contact', 'divider', 'spacer', 'accordion', 'accordionitem'];
     /** Icons ship as inline SVG from this fixed list; no icon font and no external request. */
-    public const ICONS = ['arrow-up-right', 'arrow-right', 'arrow-left', 'arrow-up', 'arrow-down', 'chevron-right', 'chevron-left', 'chevron-up', 'chevron-down', 'arrow-circle', 'external', 'refresh', 'menu', 'close', 'plus', 'minus', 'phone', 'app', 'mail', 'chat', 'send', 'calendar', 'clock', 'pin', 'map', 'navigation', 'web', 'wifi', 'support', 'shop', 'cart', 'tag', 'euro', 'credit-card', 'gift', 'percent', 'truck', 'package', 'briefcase', 'document', 'download', 'upload', 'print', 'link', 'share', 'image', 'camera', 'video', 'play', 'pause', 'music', 'mic', 'book', 'user', 'people', 'login', 'lock', 'key', 'shield', 'eye', 'thumbs-up', 'award', 'graduation', 'heart', 'star', 'home', 'building', 'wrench', 'hammer', 'brush', 'ruler', 'leaf', 'tree', 'sun', 'droplet', 'flame', 'bolt', 'solar', 'thermometer', 'snowflake', 'car', 'check', 'check-circle', 'info', 'help', 'alert', 'search', 'settings', 'filter', 'grid', 'list', 'sparkle', 'coffee', 'utensils', 'laptop', 'hardware', 'network', 'design'];
+    public const ICONS = ['arrow-up-right', 'arrow-right', 'arrow-left', 'arrow-up', 'arrow-down', 'chevron-right', 'chevron-left', 'chevron-up', 'chevron-down', 'arrow-circle', 'external', 'refresh', 'menu', 'close', 'plus', 'minus', 'phone', 'app', 'mail', 'chat', 'send', 'calendar', 'clock', 'pin', 'map', 'navigation', 'web', 'wifi', 'support', 'shop', 'cart', 'tag', 'euro', 'credit-card', 'gift', 'percent', 'truck', 'package', 'briefcase', 'document', 'download', 'upload', 'print', 'link', 'share', 'image', 'camera', 'video', 'play', 'pause', 'music', 'mic', 'book', 'user', 'people', 'login', 'lock', 'key', 'shield', 'eye', 'thumbs-up', 'award', 'graduation', 'heart', 'star', 'home', 'building', 'wrench', 'hammer', 'brush', 'ruler', 'leaf', 'tree', 'sun', 'droplet', 'flame', 'bolt', 'solar', 'thermometer', 'snowflake', 'car', 'check', 'check-circle', 'info', 'help', 'alert', 'search', 'settings', 'filter', 'grid', 'list', 'sparkle', 'coffee', 'utensils', 'laptop', 'hardware', 'network', 'design', 'facebook', 'instagram', 'whatsapp'];
     /** Das Symbol eines Buttons, wenn keins gewählt ist: der Pfeil, den jeder Button vor v25 hatte. */
     public const BUTTON_DEFAULT_ICON = 'arrow-up-right';
     public const SPACER_SIZES = ['small', 'medium', 'large', 'huge'];

src/Content/FormRepository.php

@@ -46,6 +46,47 @@ final class FormRepository
     /** A human needs longer than this to fill in a form; anything faster is a script. */
     public const MIN_SECONDS = 3;
     public const MAX_SECONDS = 86400;
+    /**
+     * Gespeicherte Anfragen je Formular und insgesamt je Stunde (ADR 116). Darüber hinaus wird
+     * nichts mehr gespeichert und nichts verschickt - eine Flut füllt sonst Postfach und
+     * Datenbank, und die Grenze je Absender hilft nicht gegen viele Absender.
+     */
+    public const FORM_RATE_LIMIT = 30;
+    public const GLOBAL_RATE_LIMIT = 120;
+
+    /**
+     * Das Siegel eines Formulars: gebunden an das Formular und an den Zweck, damit ein von einer
+     * Seite geholtes Siegel nicht für jedes Formular gilt (ADR 116).
+     */
+    public static function stamp(string $slug, int $issued, string $secret): string
+    {
+        return hash_hmac('sha256', 'formular|'.$slug.'|'.$issued, $secret);
+    }
+
+    /**
+     * Wer ein Absender ist, für die Grenze je Stunde. Bei IPv6 zählt das /64-Netz: ein einzelner
+     * Anschluss hat davon Milliarden Adressen, mit der vollen Adresse wäre die Grenze wirkungslos.
+     */
+    public static function senderKey(?string $ip, string $secret): string
+    {
+        $ip = (string) $ip;
+        if (str_contains($ip, ':') && false !== ($binary = @inet_pton($ip)) && 16 === \strlen($binary)) {
+            $ip = bin2hex(substr($binary, 0, 8)).'::/64';
+        }
+
+        return hash_hmac('sha256', 'absender|'.$ip, $secret);
+    }
+
+    /** Ob für dieses Formular oder insgesamt in der letzten Stunde schon zu viel ankam. */
+    public function flooded(string $formId): bool
+    {
+        $since = gmdate('Y-m-d H:i:s', time() - 3600);
+        if (self::FORM_RATE_LIMIT <= (int) $this->db->fetchOne('SELECT COUNT(*) FROM form_submission WHERE form_id = ? AND created_at >= ?', [$formId, $since])) {
+            return true;
+        }
+
+        return self::GLOBAL_RATE_LIMIT <= (int) $this->db->fetchOne('SELECT COUNT(*) FROM form_submission WHERE created_at >= ?', [$since]);
+    }
 
     public function __construct(private Connection $db)
     {

src/Content/PageRepository.php

@@ -169,6 +169,27 @@ final class PageRepository
      *
      * @return int the number of pages moved into the bin
      */
+    /**
+     * Ob die Seite - mit $subtree auch eine ihrer Unterseiten - öffentlich ist. Was eine solche
+     * Seite live verändert (Adresse, Papierkorb, Bereiche, Beitragsdaten), darf nur, wer auch
+     * veröffentlichen darf (ADR 116).
+     */
+    public function isLive(string $pageId, bool $subtree = false): bool
+    {
+        $page = $this->db->fetchAssociative('SELECT path, locale, published_revision_id FROM page WHERE id = ? AND website_id = ? AND deleted_at IS NULL', [$pageId, 'default']);
+        if (false === $page) {
+            return false;
+        }
+        if (null !== $page['published_revision_id'] || !$subtree) {
+            return null !== $page['published_revision_id'];
+        }
+
+        return false !== $this->db->fetchOne(
+            'SELECT id FROM page WHERE website_id = ? AND locale = ? AND path LIKE ? AND deleted_at IS NULL AND published_revision_id IS NOT NULL LIMIT 1',
+            ['default', $page['locale'], $page['path'].'/%'],
+        );
+    }
+
     public function trashPage(string $pageId, int $expectedVersion): int
     {
         return $this->db->transactional(function () use ($pageId, $expectedVersion): int {
@@ -279,11 +300,14 @@ final class PageRepository
     {
         $published = [];
         foreach ($this->db->fetchAllAssociative(
-            'SELECT id, path, draft_revision_id, version FROM page WHERE website_id = ? AND deleted_at IS NULL AND publish_at IS NOT NULL AND publish_at <= ? AND draft_revision_id IS NOT NULL AND (published_revision_id IS NULL OR published_revision_id <> draft_revision_id)',
+            // Online geht die Fassung, die beim Planen vorlag (ADR 116) - nicht ein Entwurf, den
+            // danach jemand ohne Recht zum Veröffentlichen gespeichert hat. Planungen aus der Zeit
+            // vor dieser Spalte tragen keine Fassung; für sie bleibt es beim Entwurf.
+            'SELECT id, path, COALESCE(publish_revision_id, draft_revision_id) AS revision, version FROM page WHERE website_id = ? AND deleted_at IS NULL AND publish_at IS NOT NULL AND publish_at <= ? AND COALESCE(publish_revision_id, draft_revision_id) IS NOT NULL AND (published_revision_id IS NULL OR published_revision_id <> COALESCE(publish_revision_id, draft_revision_id))',
             ['default', gmdate('Y-m-d H:i:s')],
         ) as $row) {
             try {
-                $this->publish($row['id'], $row['draft_revision_id'], (int) $row['version']);
+                $this->publish($row['id'], $row['revision'], (int) $row['version']);
             } catch (InvalidPage|InvalidDocument|StaleWrite|\InvalidArgumentException $e) {
                 // Eine Seite, deren Fassung heute nicht mehr gilt, bleibt Entwurf - und haelt die
                 // anderen nicht auf. Der Grund steht im Protokoll, die Seite behaelt ihren Termin.
@@ -291,7 +315,7 @@ final class PageRepository
 
                 continue;
             }
-            $this->db->executeStatement('UPDATE page SET publish_at = NULL WHERE id = ?', [$row['id']]);
+            $this->db->executeStatement('UPDATE page SET publish_at = NULL, publish_revision_id = NULL WHERE id = ?', [$row['id']]);
             $published[] = $row['path'];
         }
 
@@ -304,10 +328,13 @@ final class PageRepository
         if ('' !== $when && 1 !== preg_match('/^\d{4}-\d{2}-\d{2}[T ]\d{2}:\d{2}$/D', $when)) {
             throw new InvalidPage('Der Zeitpunkt braucht die Form JJJJ-MM-TT HH:MM.');
         }
-        $changed = $this->db->executeStatement(
-            'UPDATE page SET publish_at = ?, version = version + 1 WHERE id = ? AND version = ?',
-            ['' === $when ? null : str_replace('T', ' ', $when).':00', $pageId, $expectedVersion],
-        );
+        // Mit dem Termin wird der jetzige Entwurf festgehalten: genau er geht online.
+        $changed = '' === $when
+            ? $this->db->executeStatement('UPDATE page SET publish_at = NULL, publish_revision_id = NULL, version = version + 1 WHERE id = ? AND version = ?', [$pageId, $expectedVersion])
+            : $this->db->executeStatement(
+                'UPDATE page SET publish_at = ?, publish_revision_id = draft_revision_id, version = version + 1 WHERE id = ? AND version = ?',
+                [str_replace('T', ' ', $when).':00', $pageId, $expectedVersion],
+            );
         if (1 !== $changed) {
             throw new StaleWrite('Die Seite wurde inzwischen geändert. Lade die Übersicht neu.');
         }

src/Controller/ConsentController.php

@@ -33,7 +33,12 @@ final class ConsentController extends AbstractController
             'none' => [],
             default => array_map(static fn (mixed $group): string => (string) $group, (array) $request->request->all('groups')),
         };
-        $response = $this->redirect($this->backTo($request));
+        // consent.js schickt dasselbe Formular im Hintergrund und kennzeichnet das mit dieser
+        // Kopfzeile: dann keine Weiterleitung, nur das Cookie - die Seite bleibt stehen und das
+        // Skript tauscht aus, was jetzt geladen werden darf (ADR 115). Ein fremdes Formular kann
+        // die Kopfzeile nicht setzen; ein fremdes Skript bräuchte dafür eine CORS-Freigabe.
+        $response = '1' === $request->headers->get('X-Kant-Consent') ? new Response(status: Response::HTTP_NO_CONTENT) : $this->redirect($this->backTo($request));
+        $response->headers->set('Cache-Control', 'no-store');
         // Eine Entscheidung trifft nur der eigene Browser auf dieser Website. Ein fremdes Formular,
         // das hierher postet, darf keine Einwilligung eintragen - die Route hat keine Sitzung und
         // damit kein CSRF-Token, also entscheidet die Herkunft der Anfrage.
@@ -97,7 +102,9 @@ final class ConsentController extends AbstractController
         $target = $request->request->getString('back');
         // Nur ein Pfad dieser Website: `//fremd.example` ist protokollrelativ, und `/\fremd.example`
         // lesen Browser genauso.
-        if ('' === $target || 1 !== preg_match('#^/(?![/\\\\])#', $target)) {
+        // Steuerzeichen und Leerraum ebenfalls nicht: Browser entfernen Tabulator und Zeilenumbruch
+        // aus Adressen, aus `/<Tab>/fremd.example` würde so wieder `//fremd.example`.
+        if ('' === $target || 1 !== preg_match('#^/(?![/\\\\])#', $target) || 1 === preg_match('/[\x00-\x20\x7F\\\\]/', $target)) {
             return '/';
         }
 

src/Controller/EditorController.php

@@ -206,6 +206,9 @@ final class EditorController extends AbstractController
         if (!$this->isCsrfTokenValid('pages', $request->request->getString('_csrf_token'))) {
             return $this->back('Deine Sitzung ist abgelaufen. Bitte melde dich erneut an.');
         }
+        if ($blocked = $this->liveNeedsPublisher($id, false)) {
+            return $blocked;
+        }
         $terms = static function (string $raw): array {
             $names = array_filter(array_map(trim(...), explode(',', $raw)), static fn (string $n): bool => '' !== $n);
 
@@ -242,6 +245,9 @@ final class EditorController extends AbstractController
         if (!$this->isCsrfTokenValid('pages', $request->request->getString('_csrf_token'))) {
             return $this->back('Deine Sitzung ist abgelaufen. Bitte melde dich erneut an.');
         }
+        if ($blocked = $this->liveNeedsPublisher($id, false)) {
+            return $blocked;
+        }
         // An empty field means "the standard area"; that is stored as null, not as an address.
         $choice = static fn (string $value): ?string => '' === $value ? null : $value;
         try {
@@ -265,6 +271,9 @@ final class EditorController extends AbstractController
         if (!$this->isCsrfTokenValid('pages', $request->request->getString('_csrf_token'))) {
             return $this->back('Deine Sitzung ist abgelaufen. Bitte melde dich erneut an.');
         }
+        if ($blocked = $this->liveNeedsPublisher($id, true)) {
+            return $blocked;
+        }
         try {
             $moved = $this->pages->movePage(
                 $id,
@@ -282,6 +291,22 @@ final class EditorController extends AbstractController
             : sprintf('%d Adresse(n) geändert. Von den alten Adressen wird dauerhaft weitergeleitet.', $moved), 'success');
     }
 
+    /**
+     * Ein Redakteur bearbeitet Entwürfe; was eine veröffentlichte Seite sofort verändert, darf
+     * nur, wer veröffentlichen darf (ADR 116): Adresse, Papierkorb, Kopf- und Fußbereich,
+     * Beitragsdaten. Bei Seiten, die nie veröffentlicht waren, bleibt alles wie bisher.
+     */
+    private function liveNeedsPublisher(string $id, bool $subtree): ?Response
+    {
+        if ($this->isGranted('ROLE_PUBLISHER') || !$this->pages->isLive($id, $subtree)) {
+            return null;
+        }
+
+        return $this->back($subtree
+            ? 'Diese Seite oder eine ihrer Unterseiten ist veröffentlicht. Adresse und Papierkorb ändert, wer veröffentlichen darf.'
+            : 'Diese Seite ist veröffentlicht. Diese Angaben wirken sofort öffentlich und ändert deshalb, wer veröffentlichen darf.');
+    }
+
     #[Route('/pages/{id}/schedule', name: 'admin_schedule', methods: ['POST'])]
     public function schedule(Request $request, string $id): Response
     {
@@ -297,7 +322,7 @@ final class EditorController extends AbstractController
 
         return $this->back('' === trim($request->request->getString('publishAt'))
             ? 'Die geplante Veröffentlichung wurde entfernt.'
-            : 'Die Veröffentlichung ist geplant. Sie erfolgt beim ersten Aufruf der Website nach diesem Zeitpunkt – siehe „Aufgaben“.', 'success');
+            : 'Die Veröffentlichung ist geplant – mit dem Entwurf von jetzt. Spätere Änderungen gehen erst mit erneutem Planen oder Veröffentlichen online. Sie erfolgt beim ersten Aufruf der Website nach diesem Zeitpunkt – siehe „Aufgaben“.', 'success');
     }
 
     #[Route('/pages/{id}/restore', name: 'admin_restore_page', methods: ['POST'])]
@@ -357,6 +382,9 @@ final class EditorController extends AbstractController
         if (!$this->isCsrfTokenValid('pages', $request->request->getString('_csrf_token'))) {
             return $this->back('Deine Sitzung ist abgelaufen. Bitte melde dich erneut an.');
         }
+        if ($blocked = $this->liveNeedsPublisher($id, true)) {
+            return $blocked;
+        }
         try {
             $count = $this->pages->trashPage($id, $request->request->getInt('expectedVersion', -1));
         } catch (InvalidPage|StaleWrite $e) {

src/Controller/FormController.php

@@ -46,12 +46,12 @@ final class FormController extends AbstractController
         if (null === $form || null === $page) {
             throw $this->createNotFoundException('Formular oder Seite nicht gefunden.');
         }
-        $senderHash = hash_hmac('sha256', (string) $request->getClientIp(), $this->secret);
+        $senderHash = FormRepository::senderKey($request->getClientIp(), $this->secret);
 
         // Three quiet checks before the real validation. A caught bot is answered like a success
         // so it learns nothing, but nothing is stored and nothing is sent.
         $silentlyDropped = '' !== trim($request->request->getString('website'))
-            || !$this->timingIsPlausible($request)
+            || !$this->timingIsPlausible($request, $slug)
             || $this->forms->rateLimited($senderHash)
             // Die vierte, freiwillige Pruefung. Sie antwortet wie die drei anderen still mit
             // Erfolg: ein Absender, der erfaehrt, woran er gescheitert ist, versucht es gezielt
@@ -72,6 +72,11 @@ final class FormController extends AbstractController
             // Re-render the page the form sits on, with the entered values and the messages.
             return $this->renderPage($request, $page, $form, $checked, null === $language ? null : ($page['path'] === $this->settings->homePath() ? $language : $language.'/'.$translatedPath));
         }
+        // Kommt gerade für dieses Formular oder insgesamt zu viel an, wird nichts mehr gespeichert -
+        // aber sichtbar, nicht still: ein echter Besucher soll wissen, dass er anrufen muss.
+        if (!$silentlyDropped && $this->forms->flooded($form['id'])) {
+            return $this->renderPage($request, $page, $form, ['errors' => ['_form' => 'Gerade gehen sehr viele Anfragen ein. Bitte versuchen Sie es später erneut oder melden Sie sich telefonisch.'], 'values' => $checked['values']], null === $language ? null : ($page['path'] === $this->settings->homePath() ? $language : $language.'/'.$translatedPath));
+        }
         if (!$silentlyDropped) {
             $submission = $this->forms->store($form['id'], $checked['values'], $checked['consent'], $senderHash);
             if ($this->deliver($form, $checked['values'])) {
@@ -86,10 +91,10 @@ final class FormController extends AbstractController
     }
 
     /** The signed timestamp makes the age of the form checkable without storing anything. */
-    private function timingIsPlausible(Request $request): bool
+    private function timingIsPlausible(Request $request, string $slug): bool
     {
         $issued = $request->request->getInt('issued');
-        if (!hash_equals(hash_hmac('sha256', (string) $issued, $this->secret), $request->request->getString('issuedSignature'))) {
+        if (!hash_equals(FormRepository::stamp($slug, $issued, $this->secret), $request->request->getString('issuedSignature'))) {
             return false;
         }
         $age = time() - $issued;

src/Controller/InstallController.php

@@ -5,6 +5,8 @@ namespace App\Controller;
 use App\Domain\InvalidPage;
 use App\Ops\Installation;
 use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
+use Symfony\Component\HttpFoundation\Cookie;
+use Symfony\Component\HttpFoundation\RedirectResponse;
 use Symfony\Component\HttpFoundation\Request;
 use Symfony\Component\HttpFoundation\Response;
 use Symfony\Component\HttpKernel\Exception\NotFoundHttpException;
@@ -20,6 +22,10 @@ use Symfony\Component\Routing\Attribute\Route;
  *
  * After the first account exists, every route in this file answers 404 - not because a file was
  * deleted, but because the database says there is an installation.
+ *
+ * Vorher öffnet sich kein Schritt ohne den Installationsschlüssel (ADR 116): Er steht auf der
+ * Abschlussseite von install.php bzw. in var/install.key. Einmal eingegeben, bleibt im Browser
+ * ein Cookie mit einem Nachweis darüber, nur für /install.
  */
 final class InstallController extends AbstractController
 {
@@ -27,10 +33,46 @@ final class InstallController extends AbstractController
     {
     }
 
-    #[Route('/install', name: 'install', methods: ['GET'], priority: 10)]
-    public function check(): Response
+    /** Der Name des Cookies, das den Installationsschlüssel nachweist. */
+    public const KEY_COOKIE = 'kant_install';
+
+    #[Route('/install/schluessel', name: 'install_key', methods: ['GET', 'POST'], priority: 11)]
+    public function key(Request $request): Response
     {
-        $this->guard();
+        if ($this->installation->isInstalled()) {
+            throw new NotFoundHttpException('Diese Installation ist abgeschlossen.');
+        }
+        $error = null;
+        try {
+            $this->installation->installKey();
+            $given = $request->isMethod('POST') ? $request->request->getString('schluessel') : $request->query->getString('schluessel');
+            if ('' !== $given) {
+                if ($this->installation->acceptsKey($given)) {
+                    // Weiter ohne den Schlüssel in der Adresse: er soll weder im Verlauf noch in
+                    // einem Serverprotokoll als Verweis stehen bleiben.
+                    $response = $this->redirectToRoute('install');
+                    $response->headers->setCookie(Cookie::create(self::KEY_COOKIE, $this->installation->keyProof(), 0, '/install', null, $request->isSecure(), true, false, Cookie::SAMESITE_STRICT));
+
+                    return $response;
+                }
+                $error = 'Dieser Schlüssel passt nicht.';
+            }
+        } catch (\RuntimeException $e) {
+            $error = $e->getMessage();
+        }
+
+        $response = $this->render('install/key.html.twig', ['step' => 1, 'error' => $error, 'keyFile' => Installation::KEY_FILE]);
+        $response->headers->set('Referrer-Policy', 'no-referrer');
+
+        return $response;
+    }
+
+    #[Route('/install', name: 'install', methods: ['GET'], priority: 10)]
+    public function check(Request $request): Response
+    {
+        if ($blocked = $this->guard($request)) {
+            return $blocked;
+        }
         $checks = $this->installation->checks();
 
         return $this->render('install/check.html.twig', [
@@ -43,7 +85,9 @@ final class InstallController extends AbstractController
     #[Route('/install/datenbank', name: 'install_database', methods: ['GET', 'POST'], priority: 10)]
     public function database(Request $request): Response
     {
-        $this->guard();
+        if ($blocked = $this->guard($request)) {
+            return $blocked;
+        }
         $error = null;
         $driver = $request->request->getString('driver', 'sqlite');
         if ($request->isMethod('POST') && $this->signed($request, 'datenbank')) {
@@ -89,7 +133,9 @@ final class InstallController extends AbstractController
     #[Route('/install/migration', name: 'install_migration', methods: ['GET', 'POST'], priority: 10)]
     public function migration(Request $request): Response
     {
-        $this->guard();
+        if ($blocked = $this->guard($request)) {
+            return $blocked;
+        }
         if (!$this->installation->environmentWritten()) {
             return $this->redirectToRoute('install_database');
         }
@@ -118,7 +164,9 @@ final class InstallController extends AbstractController
     #[Route('/install/website', name: 'install_website', methods: ['GET', 'POST'], priority: 10)]
     public function website(Request $request): Response
     {
-        $this->guard();
+        if ($blocked = $this->guard($request)) {
+            return $blocked;
+        }
         if (!$this->installation->schemaReady()) {
             return $this->redirectToRoute('install_migration');
         }
@@ -150,7 +198,9 @@ final class InstallController extends AbstractController
     #[Route('/install/konto', name: 'install_account', methods: ['GET', 'POST'], priority: 10)]
     public function account(Request $request): Response
     {
-        $this->guard();
+        if ($blocked = $this->guard($request)) {
+            return $blocked;
+        }
         if (!$this->installation->siteReady()) {
             return $this->redirectToRoute('install_website');
         }
@@ -192,11 +242,21 @@ final class InstallController extends AbstractController
         }
     }
 
-    private function guard(): void
+    /** 404 nach der Installation; davor ohne Schlüsselnachweis zurück zur Eingabe des Schlüssels. */
+    private function guard(Request $request): ?Response
     {
         if ($this->installation->isInstalled()) {
             throw new NotFoundHttpException('Diese Installation ist abgeschlossen.');
         }
+        try {
+            if ($this->installation->acceptsProof($request->cookies->getString(self::KEY_COOKIE))) {
+                return null;
+            }
+        } catch (\RuntimeException) {
+            // Kein Schlüssel lesbar oder schreibbar: die Eingabeseite sagt, woran es liegt.
+        }
+
+        return new RedirectResponse($this->generateUrl('install_key'));
     }
 
     private function token(string $step): array

src/Controller/PageController.php

@@ -371,7 +371,13 @@ final class PageController extends AbstractController
         // Vorlage holt die Liste von hier, statt sie durch jede Einbindung zu reichen.
         $request->attributes->set('kant_alternates', $alternates);
         $canonical = null === $adresse ? null : $adresse.(null !== $blaettern && $blaettern['page'] > 1 ? '?seite='.$blaettern['page'] : '');
+        // Steht eine Einwilligung aus - Hinweis offen oder ein eingebetteter Inhalt wartet -, kommt
+        // consent.js dazu: Es speichert die Entscheidung ohne Neuladen. Ohne Skript bleibt das
+        // Formular mit Weiterleitung.
+        $embeds = $this->embedState($request, $page['document'], ...array_values($areas), ...array_values($sections));
+        $needsConsent = $embeds['blocked'] || $this->consent->needsBanner($request);
         $response = $this->render('page.html.twig', [
+            'needsConsent' => $needsConsent,
             'page' => $page,
             'canonical' => $canonical,
             'alternates' => $alternates,
@@ -429,8 +435,8 @@ final class PageController extends AbstractController
         // Die Pruefung braucht ein Skript von Cloudflare und einen Rahmen dafuer. Beides wird nur
         // dort erlaubt, wo tatsaechlich ein Formular steht - nicht auf jeder Seite der Website.
         $mitTurnstile = $this->turnstile->isActive() && (bool) array_filter($documents, fn (array $doc): bool => $this->hasType($doc, 'form'));
-        $wantsScript = ($mitTurnstile || $needsTabs || $needsFormScript || [] !== $pluginAssets['scripts'] || [] !== $areaScripts || $needsSlider || $needsMotion || $needsScrolled || $needsZoom || $needsDocument || [] !== $this->code->scriptsOf($page['document']));
-        $frames = $this->frameHosts($request, $page['document'], ...array_values($areas), ...array_values($sections));
+        $wantsScript = ($mitTurnstile || $needsTabs || $needsFormScript || [] !== $pluginAssets['scripts'] || [] !== $areaScripts || $needsSlider || $needsMotion || $needsScrolled || $needsZoom || $needsDocument || $needsConsent || [] !== $this->code->scriptsOf($page['document']));
+        $frames = $embeds['hosts'];
         if ($mitTurnstile) {
             $frames[] = 'challenges.cloudflare.com';
         }
@@ -453,9 +459,9 @@ final class PageController extends AbstractController
      * The generated stylesheet is inline for speed, so it is allowed by its own hash rather than
      * by 'unsafe-inline' – any other inline style, injected or not, stays blocked.
      *
-     * @param list<string> $frameHosts Hosts of embeds that are actually rendered on this response.
-     *                                 Nothing is added to the policy for an embed still waiting
-     *                                 for consent.
+     * @param list<string> $frameHosts Hosts of the embeds on this page, also of those still
+     *                                 waiting for consent (ADR 115: consent.js inserts them
+     *                                 without a reload, and a policy cannot change afterwards)
      * @param bool         $frameSelf  whether the page may frame its own PDFs (the viewer)
      */
     private function shell(Response $response, bool $allowScript = false, string $styles = '', array $frameHosts = [], bool $frameSelf = false): Response
@@ -526,7 +532,7 @@ final class PageController extends AbstractController
                         'errors' => [], 'values' => [],
                         'blockId' => $block['id'], 'page' => $page,
                         'issued' => $issued,
-                        'issuedSignature' => hash_hmac('sha256', (string) $issued, $this->secret),
+                        'issuedSignature' => FormRepository::stamp($slug, $issued, $this->secret),
                         // Leer, solange die Pruefung aus ist - dann steht auch kein Widget da.
                         'turnstileKey' => $this->turnstile->isActive() ? $this->turnstile->siteKey() : '',
                     ];
@@ -1079,23 +1085,27 @@ final class PageController extends AbstractController
     }
 
     /**
-     * The hosts of embeds that may load on this request.
+     * The hosts of all embeds on this page, and whether one of them still waits for consent.
      *
-     * An embed whose group is not granted contributes nothing: its host must not appear in the
-     * policy, because the frame is not rendered either.
+     * Seit ADR 115 steht der Host auch dann in frame-src, wenn die Gruppe noch nicht erlaubt ist:
+     * Die Richtlinie einer Seite steht beim Laden fest, und consent.js setzt den Rahmen nach der
+     * Einwilligung ohne Neuladen ein. Die Erlaubnis lädt nichts; die Adresse des Inhalts steht
+     * weiterhin erst nach der Einwilligung im HTML.
      *
-     * @return list<string>
+     * @return array{hosts: list<string>, blocked: bool}
      */
-    private function frameHosts(Request $request, array ...$documents): array
+    private function embedState(Request $request, array ...$documents): array
     {
         $hosts = [];
-        $walk = function (array $blocks) use (&$walk, &$hosts, $request): void {
+        $blocked = false;
+        $walk = function (array $blocks) use (&$walk, &$hosts, &$blocked, $request): void {
             foreach ($blocks as $block) {
-                if ('embed' === ($block['type'] ?? null) && $this->consent->granted($request, $block['props']['group'] ?? '')) {
+                if ('embed' === ($block['type'] ?? null) && '' !== ($block['props']['url'] ?? '')) {
                     $host = parse_url($block['props']['url'] ?? '', PHP_URL_HOST);
                     if (is_string($host)) {
                         $hosts[$host] = true;
                     }
+                    $blocked = $blocked || !$this->consent->granted($request, $block['props']['group'] ?? '');
                 }
                 $walk($block['children'] ?? []);
             }
@@ -1104,7 +1114,7 @@ final class PageController extends AbstractController
             $walk($document['blocks'] ?? []);
         }
 
-        return array_keys($hosts);
+        return ['hosts' => array_keys($hosts), 'blocked' => $blocked];
     }
 
     /**

src/Controller/PartialController.php

@@ -77,7 +77,7 @@ final class PartialController extends AbstractController
                 $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' => [
+                ['schemaVersion' => DocumentValidator::SCHEMA_VERSION, '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' => []],
                 ]],
             );

src/Controller/SystemController.php

@@ -3,6 +3,8 @@
 namespace App\Controller;
 
 use App\Command\SiteOriginCommand;
+use App\Content\PageRepository;
+use App\Content\SiteSettings;
 use App\Domain\InvalidPage;
 use App\Ops\ArchiveUpdate;
 use App\Ops\Backup;
@@ -11,8 +13,10 @@ use App\Ops\Installation;
 use App\Ops\OriginCheck;
 use App\Ops\Updater;
 use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
+use Symfony\Component\HttpFoundation\JsonResponse;
 use Symfony\Component\HttpFoundation\Request;
 use Symfony\Component\HttpFoundation\Response;
+use Symfony\Component\HttpKernel\HttpKernelInterface;
 use Symfony\Component\Routing\Attribute\Route;
 
 /**
@@ -24,7 +28,7 @@ use Symfony\Component\Routing\Attribute\Route;
  */
 final class SystemController extends AbstractController
 {
-    public function __construct(private Updater $updater, private Backup $backup, private ArchiveUpdate $archive, private Installation $installation, private string $adminPath, private string $databaseUrl, private string $mediaDirectory, private string $projectDir, private string $siteOrigin, private OriginCheck $originCheck)
+    public function __construct(private Updater $updater, private Backup $backup, private ArchiveUpdate $archive, private Installation $installation, private string $adminPath, private string $databaseUrl, private string $mediaDirectory, private string $projectDir, private string $siteOrigin, private OriginCheck $originCheck, private HttpKernelInterface $kernel, private PageRepository $pages, private SiteSettings $settings)
     {
     }
 
@@ -189,6 +193,113 @@ final class SystemController extends AbstractController
         return $this->redirectToRoute('admin_system');
     }
 
+    // -----------------------------------------------------------------------------------------
+    // Update mit einem Klick (ADR 113), nach dem Vorbild von reiseSoft: Die Systemseite fragt
+    // beim Öffnen selbst nach einer neuen Fassung, ein Knopf startet das Update, und die Seite
+    // zeigt Schritt für Schritt, was gerade passiert - bis „abgeschlossen“ oder „zurückgeschaltet“.
+    // -----------------------------------------------------------------------------------------
+
+    /** Gibt es eine neue Fassung? Für die Systemseite, die das beim Öffnen fragt. */
+    #[Route('/%kant.admin_path%/system/update/pruefen', name: 'admin_update_check', methods: ['GET'])]
+    public function updateCheck(): JsonResponse
+    {
+        $this->denyAccessUnlessGranted('ROLE_ADMIN');
+        $installiert = $this->updater->version();
+        $neueste = $this->archive->latest();
+        $antwort = ['installiert' => $installiert, 'status' => $this->archive->status(), 'offen' => null !== $this->archive->pending()];
+        if (null === $neueste) {
+            $antwort['fehler'] = 'Die Releaseseite antwortet gerade nicht. Später noch einmal versuchen.';
+        } elseif (version_compare($neueste['version'], $installiert, '>')) {
+            $antwort['neu'] = ['version' => $neueste['version'], 'name' => $neueste['name'], 'notizen' => $neueste['notes'], 'datum' => substr($neueste['published'], 0, 10)];
+        }
+
+        return new JsonResponse($antwort, 200, ['Cache-Control' => 'no-store']);
+    }
+
+    /** Der Fortschritt, alle zwei Sekunden abgefragt, solange das Update läuft. */
+    #[Route('/%kant.admin_path%/system/update/status', name: 'admin_update_status', methods: ['GET'])]
+    public function updateStatus(): JsonResponse
+    {
+        $this->denyAccessUnlessGranted('ROLE_ADMIN');
+
+        return new JsonResponse(['status' => $this->archive->status(), 'installiert' => $this->updater->version()], 200, ['Cache-Control' => 'no-store']);
+    }
+
+    /**
+     * Startet das Update: Sichern, Laden, Prüfen, Umschalten. Die Antwort kommt nach dem Tausch
+     * als reines JSON ohne Framework (siehe sendJsonAndStop); den Abschluss ruft die Seite
+     * danach selbst auf.
+     */
+    #[Route('/%kant.admin_path%/system/update/starten', name: 'admin_update_start', methods: ['POST'])]
+    public function updateStart(Request $request): JsonResponse
+    {
+        $this->denyAccessUnlessGranted('ROLE_ADMIN');
+        if (!$this->isCsrfTokenValid('system', $request->headers->get('X-CSRF-Token'))) {
+            return new JsonResponse(['ok' => false, 'meldung' => 'Deine Sitzung ist abgelaufen. Bitte die Seite neu laden.'], 403);
+        }
+        @set_time_limit(0);
+        $ergebnis = $this->archive->run($request->request->getString('version') ?: null);
+        if ($ergebnis['migrate'] ?? false) {
+            $this->sendJsonAndStop(['ok' => true, 'token' => $ergebnis['token'], 'fassung' => $ergebnis['fassung']]);
+        }
+        $letzter = end($ergebnis['steps']) ?: ['detail' => ''];
+
+        return new JsonResponse(['ok' => $ergebnis['ok'], 'meldung' => $letzter['detail'], 'status' => $this->archive->status()]);
+    }
+
+    /**
+     * Der Abschluss in einer frischen Anfrage mit dem neuen Code: Migrationen, Prüfung der
+     * Startseite, Wartung aus - oder Zurückschalten auf die vorherige Fassung. Die Antwort ist
+     * wieder reines JSON, denn nach einem Zurückschalten liegt erneut anderer Code auf der Platte.
+     */
+    #[Route('/%kant.admin_path%/system/update/abschliessen', name: 'admin_update_finish', methods: ['POST'])]
+    public function updateFinish(Request $request): JsonResponse
+    {
+        $this->denyAccessUnlessGranted('ROLE_ADMIN');
+        $offen = $this->archive->pending();
+        if (null === $offen) {
+            return new JsonResponse(['ok' => true, 'meldung' => 'Das Update ist bereits abgeschlossen.', 'status' => $this->archive->status()]);
+        }
+        if (!is_string($offen['token'] ?? null) || !hash_equals($offen['token'], $request->request->getString('token'))) {
+            return new JsonResponse(['ok' => false, 'meldung' => 'Dieser Abschluss gehört zu keinem offenen Update.'], 403);
+        }
+        @set_time_limit(0);
+        $ergebnis = $this->archive->finish($this->installation, $this->pruefen(...));
+        $this->sendJsonAndStop(['ok' => $ergebnis['ok'], 'status' => $this->archive->status()]);
+    }
+
+    /**
+     * Läuft die neue Fassung wirklich? Datenbank, Startseite in der Datenbank und die Startseite
+     * als Seite - als Unteranfrage, die an der Wartungsseite vorbeigeht. null heißt: alles gut.
+     */
+    private function pruefen(): ?string
+    {
+        $home = $this->settings->homePath();
+        if (null === $this->pages->findPublished($home)) {
+            return sprintf('Die Startseite /%s ist nicht lesbar.', $home);
+        }
+        $antwort = $this->kernel->handle(Request::create('/'), HttpKernelInterface::SUB_REQUEST, false);
+        if ($antwort->getStatusCode() >= 400) {
+            return sprintf('Die Startseite antwortet mit %d.', $antwort->getStatusCode());
+        }
+
+        return null;
+    }
+
+    /** Wie sendAndStop, nur als JSON für die Systemseite. */
+    private function sendJsonAndStop(array $daten): never
+    {
+        while (ob_get_level() > 0) {
+            ob_end_clean();
+        }
+        http_response_code(200);
+        header('Content-Type: application/json; charset=UTF-8');
+        header('Cache-Control: no-store');
+        header('X-Robots-Tag: noindex');
+        echo json_encode($daten, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES);
+        exit;
+    }
+
     /**
      * Der zweite Schritt des Archivupdates, aufgerufen von der Zwischenseite selbst (ADR 112).
      *

src/EventSubscriber/ErrorLogSubscriber.php

@@ -0,0 +1,50 @@
+<?php
+
+namespace App\EventSubscriber;
+
+use App\Ops\Notfall;
+use Symfony\Component\EventDispatcher\EventSubscriberInterface;
+use Symfony\Component\HttpFoundation\Response;
+use Symfony\Component\HttpKernel\Event\ExceptionEvent;
+use Symfony\Component\HttpKernel\Exception\HttpExceptionInterface;
+use Symfony\Component\HttpKernel\KernelEvents;
+use Symfony\Component\Security\Core\Exception\AccessDeniedException;
+use Symfony\Component\Security\Core\Exception\AuthenticationException;
+use Symfony\Component\Security\Core\Exception\LogoutException;
+
+/**
+ * Jeder Serverfehler, den das Framework abfängt, steht auch in var/log/notfall.log (ADR 113).
+ *
+ * Ohne das gab es auf dem Hosting kein eigenes Protokoll: Symfony schreibt nach stderr, und das
+ * landet - wenn überhaupt - im Fehlerlog des Hostings, das ein Betreiber erst suchen muss. 404 und
+ * andere gewollte Antworten gehören nicht hinein. Die Antwort selbst wird zur Wartungsseite.
+ */
+final class ErrorLogSubscriber implements EventSubscriberInterface
+{
+    public function __construct(private bool $debug = false)
+    {
+    }
+
+    public static function getSubscribedEvents(): array
+    {
+        // Nach der Sicherheitsschicht (Priorität 1): „Zugriff verweigert“ ist dort eine
+        // Weiterleitung zur Anmeldung, kein Notfall. Vor der Fehlerseite des Frameworks (-128),
+        // damit der Eintrag auch dann entsteht, wenn sie selbst scheitert.
+        return [KernelEvents::EXCEPTION => ['onException', -64]];
+    }
+
+    public function onException(ExceptionEvent $event): void
+    {
+        $fehler = $event->getThrowable();
+        if ($event->hasResponse() || $fehler instanceof AuthenticationException || $fehler instanceof AccessDeniedException || $fehler instanceof LogoutException
+            || ($fehler instanceof HttpExceptionInterface && $fehler->getStatusCode() < 500)) {
+            return;
+        }
+        Notfall::protokollieren($fehler, $event->getRequest()->getMethod().' '.$event->getRequest()->getRequestUri());
+        // Besucher sehen statt einer englischen „Oops“-Seite die Wartungsseite mit 503: für
+        // Suchmaschinen „gleich wieder da“. Im Entwicklungsmodus bleibt die ausführliche Seite.
+        if (!$this->debug) {
+            $event->setResponse(new Response(Notfall::html(), Response::HTTP_SERVICE_UNAVAILABLE, Notfall::KOPFZEILEN));
+        }
+    }
+}

src/EventSubscriber/InstallSubscriber.php

@@ -3,6 +3,7 @@
 namespace App\EventSubscriber;
 
 use App\Ops\Installation;
+use App\Ops\Protection;
 use Symfony\Component\EventDispatcher\EventSubscriberInterface;
 use Symfony\Component\HttpFoundation\RedirectResponse;
 use Symfony\Component\HttpKernel\Event\RequestEvent;
@@ -36,6 +37,8 @@ final class InstallSubscriber implements EventSubscriberInterface
 
     public function onRequest(RequestEvent $event): void
     {
+        // Fehlende Sperrdateien nachtragen (var/, vendor/, Projektstamm) - einmal je Prozess.
+        Protection::ensure($this->projectDir);
         if (!$event->isMainRequest() || is_file($this->projectDir.'/'.self::MARKER)) {
             return;
         }

src/Ops/ArchiveUpdate.php

@@ -51,6 +51,21 @@ final class ArchiveUpdate
     /** Das Protokoll - dieselbe Datei, in die auch der Updater über Git schreibt. */
     private const PROTOKOLL = 'var/updates.log';
 
+    /**
+     * Der Fortschritt für die Systemseite (ADR 113): Phase, Meldung, von welcher auf welche Fassung.
+     * Die Seite fragt ihn alle zwei Sekunden ab, während eine andere Anfrage das Update ausführt -
+     * das Vorbild ist reiseSoft.
+     */
+    public const STATUS = 'var/update/status.json';
+
+    /** Die Phasen, die die Systemseite als Schritte zeigt, in ihrer Reihenfolge. */
+    public const PHASEN = ['sichern', 'laden', 'umschalten', 'migrieren', 'pruefen'];
+
+    /** Was mergePublic() überschrieben oder neu angelegt hat - für das Zurückschalten. */
+    private array $publicAlt = [];
+    private array $publicNeu = [];
+    private ?string $publicSicherung = null;
+
     public function __construct(
         private string $root,
         private Updater $updater,
@@ -85,6 +100,10 @@ final class ArchiveUpdate
         $version = $treffer[1];
 
         return [
+            // Was die Releaseseite über die Fassung sagt - die Systemseite zeigt es vor dem Knopf.
+            'name' => (string) ($daten['name'] ?? ''),
+            'notes' => (string) ($daten['body'] ?? ''),
+            'published' => (string) ($daten['published_at'] ?? ''),
             'version' => $version,
             'url' => sprintf('%s/%s/kantsites-%s.zip', $this->releaseBase, $tag, $version),
             'checksum' => $this->checksumOf(sprintf('%s/%s/kantsites-%s.zip.sha256', $this->releaseBase, $tag, $version)),
@@ -118,6 +137,12 @@ final class ArchiveUpdate
         $melden = function (array &$schritte, string $schritt, bool $ok, string $detail = ''): bool {
             $schritte[] = ['step' => $schritt, 'ok' => $ok, 'detail' => $detail];
             $this->protokoll(sprintf('%s %s: %s', $ok ? 'ok    ' : 'FEHLER', $schritt, $detail));
+            // Ein gescheiterter Schritt vor dem Tausch: die bisherige Fassung läuft unverändert.
+            // Die Sperre meldet ein anderes, laufendes Update - dessen Fortschritt bleibt stehen.
+            // Ist die Releaseseite nicht erreichbar, hat nichts begonnen; dann bleibt alles, wie es ist.
+            if (!$ok && !in_array($schritt, ['Sperre', 'Fassung ermitteln'], true)) {
+                $this->phase('fehler', $detail.' Die bisherige Fassung läuft unverändert weiter.', ['laeuft' => false]);
+            }
 
             return $ok;
         };
@@ -130,12 +155,19 @@ final class ArchiveUpdate
             return ['ok' => false, 'steps' => $schritte];
         }
         $ziel = $version ?? $neueste['version'];
+        // Die Fassung landet in Adresse und Pfaden; nur die Form 1.2.3 ist zulässig (ADR 116).
+        if (1 !== preg_match('/^\d{1,4}\.\d{1,5}\.\d{1,6}$/D', $ziel)) {
+            $melden($schritte, 'Fassung ermitteln', false, 'Die gewünschte Fassung hat nicht die Form 1.2.3.');
+
+            return ['ok' => false, 'steps' => $schritte];
+        }
         $melden($schritte, 'Fassung ermitteln', true, sprintf('Installiert: %s, verfügbar: %s.', $this->updater->version(), $neueste['version']));
         if (version_compare($ziel, $this->updater->version(), '<=')) {
             $melden($schritte, 'Nichts zu tun', true, 'Diese Installation ist bereits auf dem neuesten Stand.');
 
             return ['ok' => true, 'steps' => $schritte];
         }
+        $this->phase('sichern', 'Datenbank und Medien werden gesichert …', ['laeuft' => true, 'von' => $this->updater->version(), 'auf' => $ziel, 'seit' => gmdate('c')], true);
 
         $lock = $this->updater->lock();
         if (null === $lock) {
@@ -165,6 +197,7 @@ final class ArchiveUpdate
         try {
             $sicherung = $this->backup->create('vor dem Update');
             $melden($schritte, 'Sicherung', true, sprintf('Datenbank und Medien liegen unter var/backups/%s.', (string) ($sicherung['name'] ?? 'sicherung')));
+            $this->phase('laden', sprintf('Fassung %s wird geladen …', $ziel));
         } catch (\Throwable $fehler) {
             $melden($schritte, 'Sicherung', false, 'Die Sicherung ist fehlgeschlagen: '.$fehler->getMessage().' Ohne sie wird nichts ersetzt.');
 
@@ -211,6 +244,7 @@ final class ArchiveUpdate
         }
         $melden($schritte, 'Entpacken', true, 'Vollständig: VERSION und vendor/ sind vorhanden.');
 
+        $this->phase('umschalten', 'Wartungsseite an, die neuen Dateien werden eingesetzt …');
         $this->updater->maintenance(true);
         $melden($schritte, 'Wartungszustand', true, 'Die Website antwortet währenddessen mit 503.');
 
@@ -229,11 +263,14 @@ final class ArchiveUpdate
                 ++$ersetzt;
             }
             // public/ wird Datei für Datei aktualisiert: Schriften und erzeugte Bündel gehören dem
-            // Betreiber und wären sonst weg.
+            // Betreiber und wären sonst weg. Was dabei überschrieben wird, kommt vorher beiseite,
+            // damit ein Zurückschalten auch public/ zurückbringt.
+            $this->publicSicherung = $arbeit.'/alt-public';
             $this->mergePublic($quelle.'/public', $this->root.'/public');
             // Ebenso plugins/: die mitgelieferten Plugins werden aktualisiert, ein vom Betreiber
             // installiertes Plugin bleibt, weil sein Ordner im Archiv nicht vorkommt.
             $this->mergePublic($quelle.'/plugins', $this->root.'/plugins');
+            @file_put_contents($arbeit.'/public.json', json_encode(['alt' => $this->publicAlt, 'neu' => $this->publicNeu], JSON_UNESCAPED_SLASHES));
         } catch (\Throwable $fehler) {
             foreach (self::ERSETZEN as $eintrag) {
                 if (is_dir($alt.'/'.$eintrag) || is_file($alt.'/'.$eintrag)) {
@@ -265,7 +302,11 @@ final class ArchiveUpdate
             'seit' => gmdate('c'),
             'alt' => basename($arbeit),
             'token' => $token,
+            // Für das Zurückschalten: von welcher Fassung, und welche Sicherung dazu gehört.
+            'von' => (string) ($this->status()['von'] ?? ''),
+            'sicherung' => (string) ($sicherung['name'] ?? ''),
         ], JSON_UNESCAPED_SLASHES));
+        $this->phase('migrieren', 'Die neuen Dateien sind da. Die Datenbank wird angepasst …');
         $melden($schritte, 'Dateien sind ersetzt', true, sprintf(
             'Fassung %s liegt bereit. Jetzt fehlen noch die Migrationen - sie laufen im nächsten Schritt mit dem neuen Code.',
             $ziel,
@@ -302,25 +343,49 @@ final class ArchiveUpdate
      *
      * @return array{ok: bool, steps: list<array{step: string, ok: bool, detail: string}>}
      */
-    public function finish(Installation $installation): array
+    /**
+     * @param (callable(): ?string)|null $pruefen prüft die neue Fassung nach den Migrationen und
+     *                                            gibt null zurück oder den Grund, warum sie nicht
+     *                                            läuft - dann wird zurückgeschaltet
+     */
+    public function finish(Installation $installation, ?callable $pruefen = null): array
     {
         $schritte = [];
+        $offen = $this->pending();
         $this->protokoll(sprintf('--- Migrationen nach dem Update, %s UTC', gmdate('Y-m-d H:i:s')));
+        $this->phase('migrieren', 'Die Datenbank wird angepasst …', ['laeuft' => true]);
         try {
             $namen = $installation->migrate();
             $schritte[] = ['step' => 'Migrationen', 'ok' => true, 'detail' => [] === $namen
                 ? 'Es stand keine an - die Datenbank war bereits auf dem Stand der neuen Fassung.'
                 : sprintf('%d ausgeführt: %s.', count($namen), implode(', ', $namen))];
         } catch (\Throwable $fehler) {
-            $schritte[] = ['step' => 'Migrationen', 'ok' => false, 'detail' => $fehler->getMessage().' Die Website bleibt im Wartungszustand, bis das geklärt ist.'];
+            $schritte[] = ['step' => 'Migrationen', 'ok' => false, 'detail' => $fehler->getMessage()];
             $this->protokoll('FEHLER Migrationen: '.$fehler->getMessage());
 
-            return ['ok' => false, 'steps' => $schritte];
+            return $this->zurueckschalten($offen, 'Die Datenbank ließ sich nicht anpassen: '.$fehler->getMessage(), $schritte);
+        }
+        $this->protokoll('ok     Migrationen: '.$schritte[0]['detail']);
+
+        if (null !== $pruefen) {
+            $this->phase('pruefen', 'Die neue Fassung wird geprüft …');
+            try {
+                $problem = $pruefen();
+            } catch (\Throwable $fehler) {
+                $problem = $fehler->getMessage();
+            }
+            if (null !== $problem) {
+                $schritte[] = ['step' => 'Funktion prüfen', 'ok' => false, 'detail' => $problem];
+                $this->protokoll('FEHLER Funktion prüfen: '.$problem);
+
+                return $this->zurueckschalten($offen, 'Die neue Fassung lief nicht: '.$problem, $schritte);
+            }
+            $schritte[] = ['step' => 'Funktion prüfen', 'ok' => true, 'detail' => 'Startseite und Datenbank antworten.'];
+            $this->protokoll('ok     Funktion prüfen: Startseite und Datenbank antworten.');
         }
 
         @unlink($this->root.'/'.self::MARKE);
         $this->updater->maintenance(false);
-        $this->protokoll('ok     Migrationen: '.$schritte[0]['detail']);
         foreach (self::ENTFALLEN_IN_PUBLIC as $eintrag) {
             @unlink($this->root.'/public/'.$eintrag);
         }
@@ -329,10 +394,109 @@ final class ArchiveUpdate
             'Fassung %s läuft. Der vorherige Stand liegt unter var/update/ (die zwei jüngsten bleiben).',
             $this->updater->version(),
         )];
+        $this->phase('fertig', sprintf('Fassung %s läuft.', $this->updater->version()), ['laeuft' => false]);
 
         return ['ok' => true, 'steps' => $schritte];
     }
 
+    /**
+     * Zurück auf die Fassung von vorher: Code aus var/update/<lauf>/alt, die überschriebenen
+     * Dateien in public/ und plugins/, dann die Datenbank aus der Sicherung vor dem Update.
+     * Erst danach geht die Wartungsseite aus - eine halb zurückgeschaltete Website darf niemand
+     * sehen.
+     */
+    private function zurueckschalten(?array $offen, string $grund, array $schritte): array
+    {
+        $bei = $this->status()['phase'] ?? null;
+        $this->phase('zurueckschalten', 'Etwas ist schiefgegangen – die bisherige Fassung wird wiederhergestellt …', ['bei' => in_array($bei, self::PHASEN, true) ? $bei : null]);
+        $arbeit = $this->root.'/var/update/'.basename((string) ($offen['alt'] ?? ''));
+        $fehler = [];
+        if (null === $offen || !is_dir($arbeit.'/alt')) {
+            $fehler[] = 'Der beiseitegelegte Stand fehlt.';
+        } else {
+            @mkdir($arbeit.'/verworfen', 0o775, true);
+            foreach (self::ERSETZEN as $eintrag) {
+                if (!file_exists($arbeit.'/alt/'.$eintrag)) {
+                    continue;
+                }
+                if (file_exists($this->root.'/'.$eintrag) && !@rename($this->root.'/'.$eintrag, $arbeit.'/verworfen/'.$eintrag)) {
+                    $fehler[] = $eintrag.' ließ sich nicht beiseitelegen.';
+                    continue;
+                }
+                if (!@rename($arbeit.'/alt/'.$eintrag, $this->root.'/'.$eintrag)) {
+                    $fehler[] = $eintrag.' ließ sich nicht zurücklegen.';
+                }
+            }
+            $liste = json_decode((string) @file_get_contents($arbeit.'/public.json'), true);
+            foreach ((array) ($liste['neu'] ?? []) as $relativ) {
+                @unlink($this->root.'/'.$relativ);
+            }
+            foreach ((array) ($liste['alt'] ?? []) as $relativ) {
+                if (!@copy($arbeit.'/alt-public/'.$relativ, $this->root.'/'.$relativ)) {
+                    $fehler[] = $relativ.' ließ sich nicht zurückkopieren.';
+                }
+            }
+        }
+        if ('' !== (string) ($offen['sicherung'] ?? '')) {
+            $wieder = $this->backup->restore((string) $offen['sicherung']);
+            if (!$wieder['ok']) {
+                $fehler[] = 'Die Datenbank ließ sich nicht aus der Sicherung zurückholen.';
+            }
+        }
+        $von = (string) ($offen['von'] ?? '');
+        if ([] === $fehler) {
+            @unlink($this->root.'/'.self::MARKE);
+            $this->updater->maintenance(false);
+            $meldung = sprintf('%s Zurückgeschaltet auf %s – die Website läuft wie vorher.', $grund, '' === $von ? 'die vorherige Fassung' : $von);
+            $schritte[] = ['step' => 'Zurückgeschaltet', 'ok' => true, 'detail' => $meldung];
+            $this->protokoll('ok     Zurückgeschaltet: '.$meldung);
+            $this->phase('zurueckgerollt', $meldung, ['laeuft' => false]);
+        } else {
+            // Bleibt die Wartungsseite an, sieht niemand eine halbe Website; der Rest ist Handarbeit.
+            $meldung = $grund.' Das Zurückschalten gelang nicht vollständig: '.implode(' ', $fehler).' Die Wartungsseite bleibt an.';
+            $schritte[] = ['step' => 'Zurückschalten', 'ok' => false, 'detail' => $meldung];
+            $this->protokoll('FEHLER Zurückschalten: '.$meldung);
+            $this->phase('fehler', $meldung, ['laeuft' => false]);
+        }
+
+        return ['ok' => false, 'steps' => $schritte, 'zurueckgeschaltet' => [] === $fehler];
+    }
+
+    /** Der letzte Fortschritt, oder null, wenn noch nie ein Update über diesen Weg lief. */
+    public function status(): ?array
+    {
+        $daten = json_decode((string) @file_get_contents($this->root.'/'.self::STATUS), true);
+        if (!is_array($daten)) {
+            return null;
+        }
+        // Ein Lauf, der seit einer halben Stunde nichts mehr meldet, ist abgebrochen - etwa weil
+        // das Hosting den Aufruf beendet hat. Dann soll die Seite nicht ewig „läuft“ zeigen.
+        if (($daten['laeuft'] ?? false) && strtotime((string) ($daten['aktualisiert'] ?? '')) < time() - 1800) {
+            $daten['laeuft'] = false;
+            $daten['phase'] = 'fehler';
+            $daten['meldung'] = 'Das Update hat seit einer halben Stunde nichts mehr gemeldet und gilt als abgebrochen. Den Stand zeigt das Protokoll unten.';
+        }
+
+        return $daten;
+    }
+
+    /** Schreibt den Fortschritt - in einem Zug, damit die Seite nie eine halbe Datei liest. */
+    private function phase(string $phase, string $meldung, array $mehr = [], bool $neu = false): void
+    {
+        $daten = $neu ? [] : ($this->status() ?? []);
+        // Bei einem Fehler zählt, in welchem Schritt er passierte - die Seite markiert genau den.
+        if (in_array($phase, ['fehler', 'zurueckgerollt'], true) && !array_key_exists('bei', $mehr)) {
+            $mehr['bei'] = in_array($daten['phase'] ?? null, self::PHASEN, true) ? $daten['phase'] : ($daten['bei'] ?? null);
+        }
+        $daten = [...$daten, ...$mehr, 'phase' => $phase, 'meldung' => $meldung, 'aktualisiert' => gmdate('c')];
+        $datei = $this->root.'/'.self::STATUS;
+        @mkdir(dirname($datei), 0o775, true);
+        $zwischen = $datei.'.'.bin2hex(random_bytes(4)).'.tmp';
+        if (false !== @file_put_contents($zwischen, json_encode($daten, JSON_UNESCAPED_SLASHES | JSON_UNESCAPED_UNICODE))) {
+            @rename($zwischen, $datei);
+        }
+    }
+
     /**
      * Eine Zeile ins Protokoll, und zwar sofort.
      *
@@ -366,6 +530,7 @@ final class ArchiveUpdate
 
                 continue;
             }
+            $this->merken($ziel);
             if ('.htaccess' === $eintrag && is_file($ziel)) {
                 $this->mergeHtaccess($quelle, $ziel);
 
@@ -375,6 +540,25 @@ final class ArchiveUpdate
         }
     }
 
+    /** Merkt sich eine Datei, bevor sie überschrieben oder neu angelegt wird. */
+    private function merken(string $ziel): void
+    {
+        if (null === $this->publicSicherung) {
+            return;
+        }
+        $relativ = ltrim(substr($ziel, strlen($this->root)), '/');
+        if (!is_file($ziel)) {
+            $this->publicNeu[] = $relativ;
+
+            return;
+        }
+        $kopie = $this->publicSicherung.'/'.$relativ;
+        @mkdir(dirname($kopie), 0o775, true);
+        if (@copy($ziel, $kopie)) {
+            $this->publicAlt[] = $relativ;
+        }
+    }
+
     /**
      * Die neue .htaccess uebernehmen, aber die Zeilen, die der Betreiber eingeschaltet hat,
      * eingeschaltet lassen: HTTPS-Zwang und HSTS. Vorher kam jedes Update mit den auskommentierten

src/Ops/Installation.php

@@ -37,6 +37,14 @@ final class Installation
     /** Longer than a person needs for a form, short enough that a stale tab stops working. */
     public const TOKEN_LIFETIME = 7200;
 
+    /**
+     * Der Installationsschlüssel (ADR 116). Ohne ihn öffnet sich kein Schritt des Installers: wer
+     * eine frisch entpackte Installation zuerst aufruft, soll sie nicht übernehmen können.
+     * install.php legt ihn an und zeigt ihn nur dem Browser, der entpackt hat; wer per FTP
+     * entpackt, findet ihn in dieser Datei. Mit dem ersten Konto wird er gelöscht.
+     */
+    public const KEY_FILE = 'var/install.key';
+
     public function __construct(
         private Connection $db,
         private PageRepository $pages,
@@ -357,16 +365,73 @@ final class Installation
         if (!hash_equals($password, $repeated)) {
             throw new InvalidPage('Die beiden Passwörter stimmen nicht überein.');
         }
-        if ($this->isInstalled()) {
-            throw new InvalidPage('Es gibt bereits ein Konto. Die Installation ist damit abgeschlossen.');
-        }
         $user = new CmsUser(bin2hex(random_bytes(16)), $username, '', ['ROLE_ADMIN']);
-        $this->db->insert('cms_user', [
-            'id' => $user->id,
-            'username' => $username,
-            'password_hash' => $this->hasher->hashPassword($user, $password),
-            'roles' => json_encode($user->getRoles(), JSON_THROW_ON_ERROR),
-        ]);
+        $hash = $this->hasher->hashPassword($user, $password);
+        // Prüfen und Anlegen in einer Transaktion: zwei gleichzeitige Absendungen sollen nicht zwei
+        // erste Konten ergeben.
+        $this->db->transactional(function () use ($user, $username, $hash): void {
+            if ($this->isInstalled()) {
+                throw new InvalidPage('Es gibt bereits ein Konto. Die Installation ist damit abgeschlossen.');
+            }
+            $this->db->insert('cms_user', [
+                'id' => $user->id,
+                'username' => $username,
+                'password_hash' => $hash,
+                'roles' => json_encode($user->getRoles(), JSON_THROW_ON_ERROR),
+            ]);
+        });
+        // Der Schlüssel hat seine Arbeit getan; liegen bleiben soll er nicht.
+        @unlink($this->root.'/'.self::KEY_FILE);
+    }
+
+    /**
+     * Der Schlüssel dieser Installation; beim ersten Aufruf angelegt, wenn install.php es nicht
+     * schon getan hat. 128 Bit aus random_bytes - raten lohnt nicht, eine Sperre braucht es nicht.
+     */
+    public function installKey(): string
+    {
+        $file = $this->root.'/'.self::KEY_FILE;
+        $key = is_file($file) ? trim((string) file_get_contents($file)) : '';
+        if (1 === preg_match('/^[a-f0-9]{32}$/D', $key)) {
+            return $key;
+        }
+        if (!is_dir(\dirname($file)) && !@mkdir(\dirname($file), 0o775, true) && !is_dir(\dirname($file))) {
+            throw new \RuntimeException('var/ ist nicht beschreibbar; ohne Installationsschlüssel geht es nicht weiter.');
+        }
+        $key = bin2hex(random_bytes(16));
+        // x: nur anlegen, wenn es die Datei noch nicht gibt - zwei gleichzeitige erste Aufrufe
+        // sollen sich nicht gegenseitig den Schlüssel überschreiben.
+        $handle = @fopen($file, 'x');
+        if (false === $handle) {
+            $existing = trim((string) @file_get_contents($file));
+            if (1 === preg_match('/^[a-f0-9]{32}$/D', $existing)) {
+                return $existing;
+            }
+            throw new \RuntimeException('Der Installationsschlüssel ließ sich nicht schreiben ('.self::KEY_FILE.').');
+        }
+        fwrite($handle, $key.'
+');
+        fclose($handle);
+        @chmod($file, 0o600);
+
+        return $key;
+    }
+
+    /** Ob die Eingabe der Schlüssel ist - Leerzeichen und Großbuchstaben aus dem Abtippen zählen nicht. */
+    public function acceptsKey(string $given): bool
+    {
+        return hash_equals($this->installKey(), strtolower(preg_replace('/\s+/', '', $given) ?? ''));
+    }
+
+    /** Was als Cookie im Browser bleibt: nicht der Schlüssel selbst, sondern ein Nachweis über ihn. */
+    public function keyProof(): string
+    {
+        return hash_hmac('sha256', 'installer', $this->installKey());
+    }
+
+    public function acceptsProof(string $proof): bool
+    {
+        return '' !== $proof && hash_equals($this->keyProof(), $proof);
     }
 
     /**
@@ -374,9 +439,8 @@ final class Installation
      *
      * The session cookie of this application is scoped to `/admin`, so the installer has no
      * session - and it should not get one for six screens. The signature ties a form to a step and
-     * to a point in time. It is not protection against somebody who can reach the installer: that
-     * protection is that the installer stops existing after the first account, which is why the
-     * last screen says to install right after uploading.
+     * to a point in time. Wer überhaupt an den Installer darf, entscheidet seit ADR 116 der
+     * Installationsschlüssel; die Unterschrift bindet nur das Formular an seinen Schritt.
      */
     public function sign(string $step, int $issued): string
     {

src/Ops/Notfall.php

@@ -0,0 +1,123 @@
+<?php
+
+namespace App\Ops;
+
+/**
+ * Die letzte Sicherung, wenn die Anwendung nicht einmal mehr eine Fehlerseite zustande bringt
+ * (ADR 113).
+ *
+ * Kantarci Reisen am 09.10.2026: Datenbank per FTP ersetzt, danach antwortete jede Adresse mit
+ * einem leeren 500er - für Besucher eine weiße Seite, für den Betreiber kein Hinweis, warum. Der
+ * Grund stand nur im Fehlerprotokoll des Hostings.
+ *
+ * Diese Klasse hängt an nichts aus dem Framework: kein Container, keine Datenbank, keine
+ * Vorlage. Sie schreibt den Grund nach var/log/notfall.log (per FTP lesbar, außerhalb von
+ * public/) und zeigt Besuchern eine schlichte Wartungsseite mit 503 - für Suchmaschinen heißt das
+ * „gleich wieder da“, nicht „kaputt“. Details stehen nie auf der Seite.
+ */
+final class Notfall
+{
+    public const PROTOKOLL = 'var/log/notfall.log';
+    /** Größer wird die Datei nicht; die ältere Hälfte wandert nach notfall.log.1. */
+    private const GRENZE = 1048576;
+    /** Fehlerarten, nach denen PHP abbricht - nur die gehören auf die Notfallseite. */
+    private const ABBRUCH = [E_ERROR, E_PARSE, E_CORE_ERROR, E_COMPILE_ERROR, E_USER_ERROR, E_RECOVERABLE_ERROR];
+
+    public const KOPFZEILEN = [
+        'Content-Type' => 'text/html; charset=UTF-8',
+        'Retry-After' => '300',
+        'Cache-Control' => 'no-store',
+        'X-Robots-Tag' => 'noindex',
+        'Content-Security-Policy' => "default-src 'none'; style-src 'unsafe-inline'; frame-ancestors 'none'; base-uri 'none'",
+    ];
+
+    private static ?string $wurzel = null;
+    private static bool $gezeigt = false;
+
+    /** Einmal ganz am Anfang von public/index.php. */
+    public static function einschalten(string $wurzel): void
+    {
+        self::$wurzel = $wurzel;
+        register_shutdown_function(static function (): void {
+            $fehler = error_get_last();
+            if (null === $fehler || !in_array($fehler['type'], self::ABBRUCH, true)) {
+                return;
+            }
+            self::melden(sprintf('PHP-Abbruch: %s in %s:%d', $fehler['message'], $fehler['file'], $fehler['line']));
+            self::seite();
+            // Danach soll nichts mehr ausgeben - auch nicht die Fehlerseite des Frameworks, das
+            // sich ebenfalls fürs Herunterfahren angemeldet hat. exit in einer Shutdown-Funktion
+            // beendet die übrigen.
+            exit;
+        });
+    }
+
+    /** Eine Ausnahme, die aus dem Framework herausgefallen ist. */
+    public static function ausnahme(\Throwable $fehler, string $adresse = ''): void
+    {
+        self::melden(self::beschreiben($fehler, $adresse));
+        self::seite();
+    }
+
+    /** Ein Fehler, den das Framework abgefangen und als 500 beantwortet hat - nur protokollieren. */
+    public static function protokollieren(\Throwable $fehler, string $adresse = ''): void
+    {
+        self::melden(self::beschreiben($fehler, $adresse));
+    }
+
+    public static function beschreiben(\Throwable $fehler, string $adresse = ''): string
+    {
+        $zeile = sprintf('%s: %s in %s:%d', $fehler::class, $fehler->getMessage(), $fehler->getFile(), $fehler->getLine());
+        // Die eigentliche Ursache steckt oft eine Ebene tiefer, etwa das SQLite-Problem unter
+        // einer Doctrine-Ausnahme.
+        for ($tiefer = $fehler->getPrevious(), $n = 0; null !== $tiefer && $n < 3; $tiefer = $tiefer->getPrevious(), ++$n) {
+            $zeile .= sprintf(' | Ursache: %s: %s', $tiefer::class, $tiefer->getMessage());
+        }
+
+        return ('' === $adresse ? '' : $adresse.' – ').$zeile;
+    }
+
+    private static function melden(string $text): void
+    {
+        $wurzel = self::$wurzel ?? dirname(__DIR__, 2);
+        $datei = $wurzel.'/'.self::PROTOKOLL;
+        if (!is_dir(dirname($datei))) {
+            @mkdir(dirname($datei), 0o775, true);
+        }
+        if (is_file($datei) && filesize($datei) > self::GRENZE) {
+            @rename($datei, $datei.'.1');
+        }
+        // Zeilenumbrüche aus Meldungen würden das Protokoll zerreißen; eine Zeile je Ereignis.
+        $text = str_replace(["\r", "\n"], ' ', $text);
+        @file_put_contents($datei, sprintf("[%s UTC] %s\n", gmdate('Y-m-d H:i:s'), mb_substr($text, 0, 4000)), FILE_APPEND | LOCK_EX);
+    }
+
+    /** Die Seite für Besucher. Ohne Details, ohne Abhängigkeiten, ohne fremde Quellen. */
+    private static function seite(): void
+    {
+        if (self::$gezeigt || PHP_SAPI === 'cli') {
+            return;
+        }
+        self::$gezeigt = true;
+        while (ob_get_level() > 0) {
+            @ob_end_clean();
+        }
+        if (!headers_sent()) {
+            http_response_code(503);
+            foreach (self::KOPFZEILEN as $name => $wert) {
+                header($name.': '.$wert);
+            }
+        }
+        echo self::html();
+    }
+
+    /** Die Wartungsseite als Text, auch für den Fehler-Listener im Framework. */
+    public static function html(): string
+    {
+        return '<!doctype html><html lang="de"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width, initial-scale=1">'
+            .'<title>Gleich wieder da</title><style>body{margin:0;min-height:100vh;display:grid;place-items:center;font:17px/1.6 system-ui,-apple-system,"Segoe UI",sans-serif;background:#f4f6f5;color:#1f2d27}'
+            .'main{max-width:460px;padding:32px;text-align:center}h1{font-size:26px;line-height:1.25;margin:0 0 12px}p{margin:0;color:#46514c}</style></head>'
+            .'<body><main><h1>Die Website ist gleich wieder da.</h1><p>Gerade wird etwas erneuert. Bitte versuche es in ein paar Minuten noch einmal.</p>'
+            .'<p lang="en" style="margin-top:14px;font-size:14px">This website will be back shortly.</p></main></body></html>';
+    }
+}

src/Ops/Protection.php

@@ -0,0 +1,39 @@
+<?php
+
+namespace App\Ops;
+
+/**
+ * Sperrdateien, die dafür sorgen, dass nichts außer public/ über das Netz erreichbar ist - auch
+ * wenn die Domain versehentlich auf den Projektordner zeigt (ADR 116).
+ *
+ * Die meisten liegen im Release (bin/, config/, src/ …, vendor/ und der Projektstamm). Zwei
+ * entstehen erst auf dem Server: var/ gibt es im Archiv nicht, und die Datei im Projektstamm soll
+ * auch eine Installation bekommen, die von einer Fassung vor 1.30.0 aktualisiert wurde - deren
+ * Updater kannte sie noch nicht. Angelegt wird nur, was fehlt; eine eigene .htaccess des Betreibers
+ * im Projektstamm bleibt unberührt.
+ */
+final class Protection
+{
+    private static bool $checked = false;
+
+    public static function ensure(string $root): void
+    {
+        if (self::$checked) {
+            return;
+        }
+        self::$checked = true;
+        $sperren = $root.'/config/schutz/sperren.htaccess';
+        $stamm = $root.'/config/schutz/stamm.htaccess';
+        foreach ([$root.'/var/.htaccess' => $sperren, $root.'/vendor/.htaccess' => $sperren, $root.'/.htaccess' => $stamm] as $ziel => $vorlage) {
+            if (!is_file($ziel) && is_dir(\dirname($ziel)) && is_file($vorlage)) {
+                @copy($vorlage, $ziel);
+            }
+        }
+    }
+
+    /** Für Tests: die nächste Anfrage prüft wieder. */
+    public static function reset(): void
+    {
+        self::$checked = false;
+    }
+}

src/Ops/Updater.php

@@ -231,6 +231,12 @@ final class Updater
         $step($steps, 'Vorprüfung', true, 'Alle Prüfungen bestanden.');
 
         $target ??= $this->availableVersion();
+        // Ein Tag der Form v1.2.3 und sonst nichts: der Wert geht an git checkout (ADR 116).
+        if (null !== $target && 1 !== preg_match('/^v\d{1,4}\.\d{1,5}\.\d{1,6}$/D', $target)) {
+            $step($steps, 'Ziel bestimmen', false, 'Das Ziel hat nicht die Form v1.2.3.');
+
+            return ['ok' => false, 'steps' => $steps, 'target' => $target];
+        }
         if (null === $target) {
             $step($steps, 'Ziel bestimmen', false, 'Die Herkunft bietet keinen Tag der Form v1.2.3 an.');
 
@@ -293,7 +299,7 @@ final class Updater
                     throw new \RuntimeException('Die alte Git-Konfiguration konnte nicht für den Updatewechsel vorbereitet werden.');
                 }
             }
-            $checkout = $this->git(['checkout', '--force', $target]);
+            $checkout = $this->git(['checkout', '--force', $target, '--']);
             $this->restoreEnvironment();
             if (!$step($steps, 'Code wechseln', $checkout['ok'], $checkout['ok'] ? 'Auf '.$target.' gewechselt.' : $checkout['output'])) {
                 throw new \RuntimeException('checkout');

src/Security/UserDirectory.php

@@ -33,7 +33,7 @@ final class UserDirectory
     public const ROLE_HELP = [
         'ROLE_ADMIN' => 'Darf alles, einschließlich Benutzer, Design, Einstellungen, eigene Skripte und endgültiges Löschen.',
         'ROLE_PUBLISHER' => 'Darf bearbeiten und veröffentlichen, dazu Bereiche, Menüs, Formulare, Weiterleitungen und die 404-Seite – aber keine Benutzer, kein Design, keine Unternehmensdaten und keine Skripte.',
-        'ROLE_EDITOR' => 'Darf Entwürfe von Seiten und Beiträgen bearbeiten, Medien hochladen und die Statistik sehen, aber nichts veröffentlichen.',
+        'ROLE_EDITOR' => 'Darf Entwürfe von Seiten und Beiträgen bearbeiten, Medien hochladen und die Statistik sehen, aber nichts veröffentlichen – auch nicht Adresse, Papierkorb, Bereiche oder Beitragsdaten einer veröffentlichten Seite.',
     ];
 
     /** Bcrypt silently ignores everything after 72 bytes, so that is the honest upper limit. */

templates/.htaccess

@@ -0,0 +1,9 @@
+# Dieser Ordner gehoert nicht ins Netz (ADR 116). Zeigt die Domain richtig auf public/, wird diese
+# Datei nie gelesen; zeigt sie versehentlich auf den Projektordner, sperrt sie hier alles.
+<IfModule mod_authz_core.c>
+    Require all denied
+</IfModule>
+<IfModule !mod_authz_core.c>
+    Order deny,allow
+    Deny from all
+</IfModule>

templates/admin/system.html.twig

@@ -1,6 +1,7 @@
 {% extends 'admin/shell.html.twig' %}
 {% set nav = 'system' %}
 {% block title %}System{% endblock %}
+{% block scripts %}<script type="module" src="/assets/system-update.js?v={{ kant_version() }}"></script>{% endblock %}
 {% block heading %}System und Update{% endblock %}
 {% block lead %}Fassung, Updateweg und Sicherungen dieser Installation.{% endblock %}
 {% block content %}
@@ -137,10 +138,17 @@
 </div>
 {% endif %}
 
-<div class="card">
+{# Update mit einem Klick (ADR 113), nach dem Vorbild von reiseSoft: Beim Öffnen fragt die Seite
+   selbst nach einer neuen Fassung, zeigt die Hinweise dazu und einen Knopf. Danach laufen die
+   Schritte sichtbar durch - bis „abgeschlossen“ oder „zurückgeschaltet“. Ohne Skript bleiben die
+   Formulare darunter. #}
+<div class="card update-card" id="update" data-update
+     data-installiert="{{ state.version }}" data-csrf="{{ csrf_token('system') }}"
+     data-pruefen="{{ path('admin_update_check') }}" data-status="{{ path('admin_update_status') }}"
+     data-starten="{{ path('admin_update_start') }}" data-abschliessen="{{ path('admin_update_finish') }}">
     <div class="card-head">
-        <h2>{{ state.worktree ? 'Update aus dem Releasearchiv' : 'Update einspielen' }}</h2>
-        <span class="muted">{{ state.worktree ? 'Alternative zum Weg über Git' : 'holt die neue Fassung' }}</span>
+        <h2>Update</h2>
+        <span class="muted">Installiert <strong data-update-installiert>{{ state.version }}</strong></span>
     </div>
     <div class="card-body">
         {% if archivePending %}
@@ -150,35 +158,30 @@
             <input type="hidden" name="finish" value="1">
             <button class="primary" type="submit">Migrationen ausführen und freigeben →</button>
         </form>
-        {% else %}
-        <p class="muted">Ohne Git: Archiv laden, Prüfsumme vergleichen, Datenbank und Medien sichern, Wartungszustand ein, Dateien tauschen. Der vorherige Stand wird beiseitegelegt, nicht gelöscht.</p>
-        {# Das Kleingedruckte steht zugeklappt: Wer aktualisiert, braucht zuerst den Knopf. #}
-        <details class="hint">
-            <summary>Was unberührt bleibt</summary>
-            <p class="field-help"><code>var/</code>, <code>.env</code>, <code>.env.local</code>, die geladenen Schriften und das erzeugte Stylesheet-Bündel.</p>
-            <p class="field-help">Danach folgt ein zweiter Knopf für die Migrationen. Das ist kein Umweg: Erst eine neue Anfrage startet mit dem Code der neuen Fassung.</p>
-        </details>
-        {% if archiveVersion %}
-        <p class="notice done">Verfügbar: <strong>{{ archiveVersion }}</strong> (installiert: {{ state.version }}).</p>
-        {% elseif asked %}
-        <p class="field-help">Die Releaseseite nennt nichts Neueres als {{ state.version }}.</p>
-        {% else %}
-        <p class="field-help"><a href="{{ path('admin_system', {pruefen: 1}) }}">Nachsehen, ob es etwas Neues gibt</a> – dauert einen Moment.</p>
         {% endif %}
-        <form action="{{ path('admin_system_archive') }}" method="post">
-            <input type="hidden" name="_csrf_token" value="{{ csrf_token('system') }}">
-            <div class="fields">
-                <div>
-                    <label for="archive-target">Fassung</label>
-                    <input id="archive-target" name="target" maxlength="20" placeholder="{{ archiveVersion ?: '1.4.2' }}" pattern="[0-9]+\.[0-9]+\.[0-9]+">
-                    <p class="field-help">Leer lassen für die neueste veröffentlichte Fassung.</p>
+        <div class="update-live" data-update-live role="status" aria-live="polite" hidden></div>
+        <details class="hint update-manual">
+            <summary>Weitere Möglichkeiten</summary>
+            <p class="field-help">Ohne Git: Archiv laden, Prüfsumme vergleichen, Datenbank und Medien sichern, Wartungsseite an, Dateien tauschen, Datenbank anpassen, prüfen. Unberührt bleiben <code>var/</code>, <code>.env</code>, die geladenen Schriften und das erzeugte Stylesheet-Bündel.</p>
+            <form action="{{ path('admin_system_archive') }}" method="post">
+                <input type="hidden" name="_csrf_token" value="{{ csrf_token('system') }}">
+                <div class="fields">
+                    <div>
+                        <label for="archive-target">Bestimmte Fassung</label>
+                        <input id="archive-target" name="target" maxlength="20" placeholder="1.4.2" pattern="[0-9]+\.[0-9]+\.[0-9]+">
+                        <p class="field-help">Leer lassen für die neueste veröffentlichte Fassung. Dieser Weg funktioniert auch ohne JavaScript.</p>
+                    </div>
                 </div>
-            </div>
-            <button class="primary" type="submit">Update aus dem Archiv einspielen →</button>
-        </form>
-        {% endif %}
+                <button class="secondary" type="submit">Update aus dem Archiv einspielen</button>
+            </form>
+        </details>
     </div>
 </div>
+<dialog id="update-dialog" class="update-dialog" aria-labelledby="update-dialog-title">
+    <h2 id="update-dialog-title">Auf <span data-update-ziel></span> aktualisieren?</h2>
+    <p>Vorher werden Datenbank und Medien automatisch gesichert. Die Website zeigt etwa eine Minute lang eine Wartungsseite. Schlägt etwas fehl, wird automatisch auf {{ state.version }} zurückgeschaltet.</p>
+    <div class="dialog-actions"><button type="button" class="secondary" data-update-abbrechen>Abbrechen</button><button type="button" class="primary" data-update-los>Update starten</button></div>
+</dialog>
 
 {% if state.worktree %}
 <div class="card">

templates/blocks/block.html.twig

@@ -138,7 +138,7 @@
         {% if editing|default(false) %}<p id="{{ block.id }}" class="block-unavailable{{ designClasses }}" role="note">Verknüpfte Sektion: unter Inhalt die Adresse einer Sektion eintragen.</p>{% endif %}
     {% elseif section %}
         <div id="{{ block.id }}" class="block-partialref{{ designClasses }}">
-            {% for child in section.blocks %}{% include 'blocks/block.html.twig' with {block: child, editing: editing|default(false), postLists: postLists|default({}), forms: forms|default({}), breadcrumbs: breadcrumbs|default([]), navigation: navigation|default({}), sections: sections|default({}), richText: richText|default(false), richHeadings: richHeadings|default(false), neighbours: neighbours|default({}), eagerImage: eagerImage|default(null), inHeader: inHeader|default(false)} only %}{% endfor %}
+            {# Die Sektion nach ihrem eigenen Schema-Stand: ihr Text wurde nach diesem gefiltert, nicht nach dem der Seite (ADR 116). #}{% for child in section.blocks %}{% include 'blocks/block.html.twig' with {block: child, editing: editing|default(false), postLists: postLists|default({}), forms: forms|default({}), breadcrumbs: breadcrumbs|default([]), navigation: navigation|default({}), sections: sections|default({}), richText: section.schemaVersion|default(1) >= 12, richHeadings: section.schemaVersion|default(1) >= 17, neighbours: neighbours|default({}), eagerImage: eagerImage|default(null), inHeader: inHeader|default(false)} only %}{% endfor %}
         </div>
     {% elseif editing|default(false) %}
         <p id="{{ block.id }}" class="block-unavailable{{ designClasses }}" role="note">Die verknüpfte Sektion „{{ props.partial }}“ gibt es nicht mehr. Der Verweis bleibt gespeichert.</p>

templates/blocks/form.html.twig

@@ -17,7 +17,9 @@
     {# Bait for automated senders. Hidden from view, from assistive technology and from tab order. #}
     <div class="form-trap" aria-hidden="true"><label for="website-{{ blockId }}">Website</label><input id="website-{{ blockId }}" name="website" type="text" tabindex="-1" autocomplete="off"></div>
 
-    {% if errors is not empty %}
+    {% if errors._form is defined %}
+    <p class="form-error-summary" role="alert">{{ errors._form|kant_t }}</p>
+    {% elseif errors is not empty %}
     <p class="form-error-summary" role="alert">{{ (errors|length == 1 ? 'Bitte prüfe 1 Eingabe. Die betroffenen Felder sind unten gekennzeichnet.' : 'Bitte prüfe %d Eingaben. Die betroffenen Felder sind unten gekennzeichnet.')|kant_t|format(errors|length) }}</p>
     {% endif %}
 

templates/blocks/icon.html.twig

@@ -1,4 +1,6 @@
-{# Inline SVG from a fixed allowlist. No icon font, no external request, no extra stylesheet. #}
+{# Inline SVG from a fixed allowlist. No icon font, no external request, no extra stylesheet.
+   Facebook, Instagram und WhatsApp am Ende: dieselben Formen wie social-icon.html.twig, damit sie
+   auch als Symbol eines Menü-Buttons oder Bausteins wählbar sind. #}
 {% set paths = {
     'arrow-up-right': 'M6.5 17.5 17.5 6.5M8.5 6.5h9v9',
     'arrow-right': 'M4 12h15.5m-6.5-6.5 6.5 6.5-6.5 6.5',
@@ -97,6 +99,9 @@
     laptop: 'M5 5h14v10H5Zm-2.5 10h19l-1 3.5h-17Z',
     hardware: 'M4 5h16v11H4Zm4 15h8m-4-4v4',
     network: 'M5 3h14v5H5Zm0 13h14v5H5Zm7-8v8M8 8v3h8V8',
-    design: 'M4 20h16M6 16 18 4l3 3L9 19l-4 1Z'
+    design: 'M4 20h16M6 16 18 4l3 3L9 19l-4 1Z',
+    facebook: 'M15.5 4h-2.2A3.8 3.8 0 0 0 9.5 7.8V10H7v3.2h2.5V20h3.3v-6.8h2.4l.5-3.2h-2.9V8.2c0-.6.3-.9.9-.9h2Z',
+    instagram: 'M8.1 3.5h7.8a4.6 4.6 0 0 1 4.6 4.6v7.8a4.6 4.6 0 0 1-4.6 4.6H8.1a4.6 4.6 0 0 1-4.6-4.6V8.1a4.6 4.6 0 0 1 4.6-4.6ZM12 8.1a3.9 3.9 0 1 0 0 7.8 3.9 3.9 0 0 0 0-7.8ZM17 7h.01',
+    whatsapp: 'M4 20l1.4-4A8.5 8.5 0 1 1 8.6 19.1ZM9.3 9.2c0 3 2.5 5.5 5.5 5.5l1.3-1.4-2-.9-.9.8a4.1 4.1 0 0 1-2.3-2.3l.8-.9-.9-2Z'
 } %}
-<svg class="block-icon" viewBox="0 0 24 24" width="32" height="32" fill="none" stroke="currentColor" stroke-width="1.6" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true" focusable="false"><path d="{{ paths[name] }}"/></svg>
+{# Strich, Farbe und Enden stehen als Regel für svg.block-icon in site.css und admin.css, nicht an jedem Symbol: eine Seite trägt um die 40 davon. #}<svg class="block-icon" viewBox="0 0 24 24" width="32" height="32" aria-hidden="true" focusable="false"><path d="{{ paths[name] }}"/></svg>

templates/install/key.html.twig

@@ -0,0 +1,15 @@
+{% extends 'install/base.html.twig' %}
+{% block heading %}Installationsschlüssel{% endblock %}
+{% block lead %}
+<p class="muted">Damit niemand anderes diese Installation zu Ende führt, öffnet sich der Installer nur mit dem Schlüssel dieser Installation. Er steht auf der Abschlussseite von <code>install.php</code>. Wer die Dateien per FTP hochgeladen hat, findet ihn in der Datei <code>{{ keyFile }}</code> – herunterladen und öffnen, er besteht aus 32 Zeichen.</p>
+{% endblock %}
+{% block content %}
+<form method="post" action="{{ path('install_key') }}">
+    <label for="schluessel">Schlüssel</label>
+    <input id="schluessel" name="schluessel" required maxlength="80" autocomplete="off" spellcheck="false" autofocus>
+    <p class="muted">Mit dem ersten Konto ist die Installation abgeschlossen; dann wird der Schlüssel gelöscht.</p>
+    <div class="sheet-actions">
+        <button class="primary" type="submit">Weiter <span aria-hidden="true">→</span></button>
+    </div>
+</form>
+{% endblock %}

templates/page.html.twig

@@ -70,6 +70,7 @@
     {% if needsMotion|default(false) %}<script type="module" src="/assets/motion.js?v={{ kant_version() }}"></script>{% endif %}
     {% if needsScrolled|default(false) %}<script type="module" src="/assets/scrolled.js?v={{ kant_version() }}"></script>{% endif %}
     {% if needsZoom|default(false) or needsDocument|default(false) %}<script src="/assets/lightbox.js?v={{ kant_version() }}" defer></script>{% endif %}
+    {% if needsConsent|default(false) and not editing|default(false) %}<script src="/assets/consent.js?v={{ kant_version() }}" defer></script>{% endif %}
     {% if not editing|default(false) %}{% for src in pluginScripts|default([]) %}<script src="{{ src }}" defer></script>{% endfor %}{% endif %}
     {# Own scripts of this page, as a file. Never rendered in the editor preview: the preview must
        show the layout, not run code that could change the page under the editor's hands. #}

tests/ArchiveUpdateTest.php

@@ -2,14 +2,24 @@
 
 namespace App\Tests;
 
+use App\Content\DocumentValidator;
+use App\Content\MediaLibrary;
+use App\Content\MenuRepository;
+use App\Content\PageRepository;
+use App\Content\PartialRepository;
+use App\Content\SiteSettings;
 use App\Infrastructure\ConnectionFactory;
 use App\Ops\ArchiveUpdate;
 use App\Ops\Backup;
 use App\Ops\CommandRunner;
 use App\Ops\Download;
+use App\Ops\Installation;
 use App\Ops\Updater;
+use App\Security\CmsUser;
 use Doctrine\DBAL\Connection;
 use PHPUnit\Framework\TestCase;
+use Symfony\Component\PasswordHasher\Hasher\PasswordHasherFactory;
+use Symfony\Component\PasswordHasher\Hasher\UserPasswordHasher;
 
 /**
  * Das Update über das Releasearchiv - der Weg für Installationen ohne Git.
@@ -262,7 +272,9 @@ final class ArchiveUpdateTest extends TestCase
         // Beiwerk, das eine laufende Installation nicht liest.
         // plugins/ ebenso Datei für Datei: mitgelieferte Plugins werden aktualisiert, ein vom
         // Betreiber installiertes bleibt stehen (ADR 102).
-        $anders = ['public', 'plugins', 'README.md', 'LICENSE', '.env.example'];
+        // Die .htaccess im Projektstamm ersetzt das Update nicht: sie kann dem Betreiber gehören.
+        // Fehlt sie, legt die Website sie selbst an (App\Ops\Protection, ADR 116).
+        $anders = ['public', 'plugins', 'README.md', 'LICENSE', '.env.example', '.htaccess'];
         foreach ($liste($mit[1]) as $eintrag) {
             self::assertContains(
                 $eintrag,
@@ -272,6 +284,77 @@ final class ArchiveUpdateTest extends TestCase
         }
     }
 
+    public function testTheProgressFileFollowsTheUpdateAndAFinishedOneSaysSo(): void
+    {
+        // Die Systemseite fragt diesen Fortschritt ab, während eine andere Anfrage das Update
+        // ausführt (ADR 113) - Phase, Meldung, von welcher auf welche Fassung.
+        $this->releases->release(self::BASE, self::API, '1.1.0', $this->archive('1.1.0'));
+        $updater = $this->updater();
+        self::assertNull($updater->status());
+        self::assertSame('Fortschritt live.', $updater->latest()['notes'] ?? null, 'Die Hinweise der Releaseseite gehören zur neuen Fassung.');
+
+        $ergebnis = $updater->run();
+        self::assertTrue($ergebnis['ok'], $this->explain($ergebnis));
+        $status = $updater->status();
+        self::assertSame(['migrieren', true, '1.0.0', '1.1.0'], [$status['phase'], $status['laeuft'], $status['von'], $status['auf']]);
+
+        $fertig = $this->updater()->finish($this->installation());
+        self::assertTrue($fertig['ok'], $this->explain($fertig));
+        self::assertSame(['fertig', false], [$this->updater()->status()['phase'], $this->updater()->status()['laeuft']]);
+        self::assertFileDoesNotExist($this->root.'/'.Updater::MAINTENANCE_FILE);
+    }
+
+    public function testANewVersionThatDoesNotRunIsSwitchedBackCompletely(): void
+    {
+        // Wie bei reiseSoft: Läuft die neue Fassung nach den Migrationen nicht, kommt die alte
+        // zurück - Code, public/ und Datenbank -, und erst dann geht die Wartungsseite aus.
+        $this->releases->release(self::BASE, self::API, '1.1.0', $this->archive('1.1.0'));
+        $this->db->insert('website', ['id' => 'default', 'name' => 'Vorher', 'default_locale' => 'de', 'theme' => '{}']);
+        $ergebnis = $this->updater()->run();
+        self::assertTrue($ergebnis['ok'], $this->explain($ergebnis));
+        self::assertSame('1.1.0', trim((string) file_get_contents($this->root.'/VERSION')));
+        // Etwas, das die neue Fassung in der Datenbank anrichtet, bevor die Prüfung scheitert.
+        $this->db->update('website', ['name' => 'Nachher'], ['id' => 'default']);
+
+        $ende = $this->updater()->finish($this->installation(), static fn (): string => 'Die Startseite antwortet mit 500.');
+
+        self::assertFalse($ende['ok']);
+        self::assertTrue($ende['zurueckgeschaltet'] ?? false, $this->explain($ende));
+        self::assertSame('1.0.0', trim((string) file_get_contents($this->root.'/VERSION')));
+        self::assertFileExists($this->root.'/src/Alt.php');
+        self::assertFileDoesNotExist($this->root.'/src/Neu.php');
+        self::assertSame("<?php // alt\n", file_get_contents($this->root.'/public/index.php'), 'Auch public/ kommt zurück.');
+        self::assertSame('body{color:alt}', file_get_contents($this->root.'/public/assets/site.css'));
+        self::assertSame('SCHRIFT', file_get_contents($this->root.'/public/assets/fonts/eigene.woff2'));
+        self::assertFileDoesNotExist($this->root.'/public/assets/fonts/andere.woff2');
+        $this->db->close();
+        $this->db = ConnectionFactory::create('sqlite:///'.$this->root.'/var/cms.db');
+        self::assertSame('Vorher', $this->db->fetchOne("SELECT name FROM website WHERE id = 'default'"), 'Die Datenbank kommt aus der Sicherung vor dem Update.');
+        self::assertFileDoesNotExist($this->root.'/'.Updater::MAINTENANCE_FILE, 'Zurückgeschaltet heißt: die Website läuft wieder.');
+        self::assertNull($this->updater()->pending());
+        $status = $this->updater()->status();
+        self::assertSame(['zurueckgerollt', 'pruefen', false], [$status['phase'], $status['bei'], $status['laeuft']], 'Gescheitert ist die Prüfung - genau dieser Schritt wird markiert.');
+        self::assertStringContainsString('Zurückgeschaltet auf 1.0.0', $status['meldung']);
+    }
+
+    private function installation(): Installation
+    {
+        $settings = new SiteSettings($this->db, new MediaLibrary($this->db, $this->root.'/var/media'));
+        $validator = new DocumentValidator();
+
+        return new Installation(
+            $this->db,
+            new PageRepository($this->db, $validator, $settings),
+            new PartialRepository($this->db, $validator),
+            new MenuRepository($this->db, $settings),
+            $settings,
+            new UserPasswordHasher(new PasswordHasherFactory([CmsUser::class => ['algorithm' => 'auto']])),
+            $this->root,
+            $this->root.'/var/media',
+            'test-secret',
+        );
+    }
+
     private function updater(): ArchiveUpdate
     {
         $runner = new CommandRunner();
@@ -303,7 +386,8 @@ final class ArchiveUpdateTest extends TestCase
             'bin/console' => "<?php // neu\n",
             'config/services.yaml' => "services:\n",
             'templates/base.html.twig' => 'neu',
-            'migrations.php' => "<?php return ['neu'];\n",
+            'migrations.php' => "<?php return ['table_storage' => ['table_name' => 'migration_versions'], 'migrations_paths' => ['DoctrineMigrations' => __DIR__.'/migrations'], 'all_or_nothing' => false];\n",
+            'migrations/.keep' => '',
             'cli-config.php' => "<?php // neu\n",
             'composer.json' => '{"name":"neu"}',
             'composer.lock' => '{"packages":["neu"]}',

tests/BacklogTest.php

@@ -158,7 +158,7 @@ final class BacklogTest extends TestCase
 
         // Abgeschickt ohne E-Mail: die Seite kommt mit Meldung zurück, am Formular im Fuß.
         $issued = time() - 10;
-        $antwort = $this->request('/formular/kontakt', 'POST', ['page' => 'home', 'block' => 'fuss-formular', 'issued' => (string) $issued, 'issuedSignature' => hash_hmac('sha256', (string) $issued, 'test-only'), 'email' => '', 'datenschutz' => 'ja']);
+        $antwort = $this->request('/formular/kontakt', 'POST', ['page' => 'home', 'block' => 'fuss-formular', 'issued' => (string) $issued, 'issuedSignature' => FormRepository::stamp('kontakt', $issued, 'test-only'), 'email' => '', 'datenschutz' => 'ja']);
         self::assertSame(422, $antwort->getStatusCode());
         self::assertStringContainsString('Dieses Feld wird benötigt.', $antwort->getContent());
     }

tests/CmsTest.php

@@ -311,7 +311,7 @@ final class CmsTest extends TestCase
     public static function rejectedButtonIcons(): iterable
     {
         yield 'Symbol vor v25' => ['icon', 'phone', 24];
-        yield 'unbekanntes Symbol' => ['icon', 'whatsapp', 25];
+        yield 'unbekanntes Symbol' => ['icon', 'telegram', 25];
         yield 'Symbol ist kein Text' => ['icon', ['phone'], 25];
         yield 'Stellung vor v25' => ['iconPosition', 'start', 24];
         yield 'unbekannte Stellung' => ['iconPosition', 'middle', 25];
@@ -1618,7 +1618,10 @@ final class CmsTest extends TestCase
         // Und der Vordereingang verrät nicht, welche PHP-Fassung hier läuft.
         $index = (string) file_get_contents(__DIR__.'/../public/index.php');
         self::assertStringContainsString("header_remove('X-Powered-By')", $index);
-        self::assertStringContainsString('Header always unset X-Powered-By', (string) file_get_contents(__DIR__.'/../public/.htaccess'));
+        $htaccess = (string) file_get_contents(__DIR__.'/../public/.htaccess');
+        self::assertStringContainsString('Header always unset X-Powered-By', $htaccess);
+        // Ohne diese Zeile schreibt IONOS index.php endlos auf sich selbst um: weißer 500er (ADR 114).
+        self::assertStringContainsString("RewriteBase /\nRewriteRule ^index\\.php$ - [L]\nRewriteCond %{REQUEST_FILENAME} !-f", $htaccess);
     }
 
     public function testABackgroundPictureShrinksForSmallScreensEvenWhenSetOnce(): void
@@ -3095,6 +3098,26 @@ final class CmsTest extends TestCase
         self::assertStringNotContainsString('Viele Möglichkeiten', $this->request('/')->getContent());
     }
 
+    public function testALinkedSectionIsRenderedByItsOwnSchemaVersion(): void
+    {
+        // Eine Sektion mit altem Schema-Stand: ihr Text lief nicht durch den Filter für
+        // formatierten Text. In einer neueren Seite darf er deshalb nicht roh erscheinen (ADR 116).
+        $this->partials->create('section', 'alt', 'Alte Sektion', [
+            'schemaVersion' => 11, 'title' => 'Alt', 'description' => 'Alte Sektion.',
+            'blocks' => [['id' => 'alt-section', 'type' => 'section', 'children' => [
+                ['id' => 'alt-text', 'type' => 'text', 'props' => ['text' => '<meta http-equiv="refresh" content="0;url=https://fremd.example"><a href="https://fremd.example">Hier</a>']],
+            ]]],
+        ]);
+        $document = DemoContent::starter('Neu');
+        $document['schemaVersion'] = DocumentValidator::SCHEMA_VERSION;
+        $document['blocks'][] = ['id' => 'ref', 'type' => 'partialref', 'props' => ['partial' => 'alt']];
+        $this->pages->publish('page-1', $this->pages->saveDraft('page-1', $document, 0), 1);
+
+        $html = (string) $this->request('/')->getContent();
+        self::assertStringNotContainsString('<meta http-equiv="refresh"', $html);
+        self::assertStringContainsString('&lt;meta http-equiv=', $html, 'Der Text erscheint als Text.');
+    }
+
     public function testALinkedSectionChangesOnEveryPageThatEmbedsIt(): void
     {
         $sectionId = $this->partials->create('section', 'aufruf', 'Aufruf-Band', [
@@ -3467,6 +3490,24 @@ display: flex', '#b1{display:flex;color:red}'];
         $this->pages->saveDraft('page-1', $document, 0);
     }
 
+    public function testOwnCssStaysInsideItsBlock(): void
+    {
+        $code = new CustomCode();
+        // Geschwister des Blocks selbst liegen außerhalb - die ganze Seite wäre umgestaltbar (ADR 116).
+        foreach (['& ~ *{display:none}', '&+p{color:red}', '&[a="x]{color:red}', 'color:red /*', 'width:10px*/'] as $css) {
+            try {
+                $code->checkCss($css);
+                self::fail('Angenommen: '.$css);
+            } catch (InvalidDocument) {
+                self::addToAssertionCount(1);
+            }
+            // Was schon gespeichert ist und heute nicht mehr gilt, fällt still weg statt die Seite zu brechen.
+            self::assertSame('', $code->compileCss('b1', $css));
+        }
+        // Innerhalb des Blocks bleiben ~ und + erlaubt.
+        self::assertSame('#b1 .a~.b{color:red}#b1 h3+p{margin:0}', $code->compileCss('b1', '& .a~.b{color:red}& h3+p{margin:0}'));
+    }
+
     public function testScriptChangesAreComparedAgainstWhatIsStored(): void
     {
         $code = new CustomCode();
@@ -4543,8 +4584,10 @@ Achern']);
         self::assertStringContainsString('value="all"', $html);
         self::assertStringContainsString('value="none"', $html);
         self::assertStringContainsString('/datenschutz', $html);
-        // No script anywhere: the strict policy stays as it is.
-        self::assertStringContainsString("script-src 'none'", (string) $response->headers->get('Content-Security-Policy'));
+        // Seit ADR 115 kommt consent.js dazu, solange die Frage offen ist - als Datei von hier,
+        // nie inline. Ohne Skript bleibt das Formular mit Weiterleitung.
+        self::assertStringContainsString('<script src="/assets/consent.js?v=', $html);
+        self::assertStringContainsString("script-src 'self'", (string) $response->headers->get('Content-Security-Policy'));
 
         $saved = $this->request('/einwilligung', 'POST', ['choice' => 'all', 'back' => '/']);
         self::assertSame(302, $saved->getStatusCode());
@@ -4558,6 +4601,9 @@ Achern']);
         // With a decision in hand the banner is gone, but the way back to it is not.
         $decided = $this->request('/', 'GET', [], [Consent::COOKIE => (string) $cookie->getValue()]);
         self::assertStringNotContainsString('consent-bar', $decided->getContent());
+        // Nichts mehr offen: kein Skript, die Richtlinie wieder streng.
+        self::assertStringNotContainsString('consent.js', $decided->getContent());
+        self::assertStringContainsString("script-src 'none'", (string) $decided->headers->get('Content-Security-Policy'));
         self::assertStringContainsString('/einwilligung', $decided->getContent());
         self::assertSame(200, $this->request('/einwilligung', 'GET', [], [Consent::COOKIE => (string) $cookie->getValue()])->getStatusCode());
     }
@@ -4598,10 +4644,45 @@ Achern']);
             self::assertStringNotContainsString('<iframe', $html);
             self::assertStringNotContainsString('karten.example/einbetten', $html);
             self::assertStringContainsString('OpenStreetMap', $html, 'The placeholder names the provider.');
-            self::assertStringContainsString("frame-src 'none'", $policy);
+            // Die Erlaubnis steht schon in der Richtlinie (ADR 115): consent.js setzt den Rahmen
+            // nach der Einwilligung ohne Neuladen ein, und eine Richtlinie ändert sich danach nicht
+            // mehr. Geladen wird dadurch nichts - es gibt keinen Rahmen und keine Adresse.
+            self::assertStringContainsString('frame-src https://karten.example', $policy);
+            self::assertStringContainsString('<script src="/assets/consent.js?v=', $html);
         }
     }
 
+    public function testTheConsentFormRedirectsOnlyWithinThisSite(): void
+    {
+        $this->askConsent();
+        // Browser entfernen Tabulator und Zeilenumbruch: aus /<Tab>/fremd würde //fremd (ADR 116).
+        foreach (["/\t/fremd.example", "/\n/fremd.example", '//fremd.example', '/\fremd.example', 'https://fremd.example', '/ /fremd.example'] as $back) {
+            self::assertSame('/', $this->request('/einwilligung', 'POST', ['choice' => 'none', 'back' => $back])->headers->get('Location'), json_encode($back));
+        }
+        self::assertSame('/kontakt?a=1#x', $this->request('/einwilligung', 'POST', ['choice' => 'none', 'back' => '/kontakt?a=1#x'])->headers->get('Location'));
+    }
+
+    public function testTheConsentScriptSavesWithoutARedirect(): void
+    {
+        $this->askConsent();
+
+        // consent.js kennzeichnet seine Anfrage; dann gibt es das Cookie ohne Weiterleitung.
+        $saved = $this->request('/einwilligung', 'POST', ['choice' => 'all', 'back' => '/'], [], ['HTTP_X_KANT_CONSENT' => '1']);
+        self::assertSame(204, $saved->getStatusCode());
+        self::assertNull($saved->headers->get('Location'));
+        self::assertSame('', $saved->getContent());
+        $cookie = $saved->headers->getCookies()[0];
+        self::assertSame(Consent::COOKIE, $cookie->getName());
+        self::assertStringContainsString('external', (string) $cookie->getValue());
+
+        // Von einer fremden Website bleibt es bei der Antwort ohne Cookie, wie beim Formular.
+        $fremd = $this->request('/einwilligung', 'POST', ['choice' => 'all'], [], ['HTTP_X_KANT_CONSENT' => '1', 'HTTP_SEC_FETCH_SITE' => 'cross-site']);
+        self::assertSame([], $fremd->headers->getCookies());
+
+        // Ohne die Kopfzeile bleibt alles beim Alten: Weiterleitung zurück.
+        self::assertSame(302, $this->request('/einwilligung', 'POST', ['choice' => 'none', 'back' => '/'])->getStatusCode());
+    }
+
     public function testTheEmbedButtonGrantsOnlyItsOwnGroupAndKeepsWhatWasGrantedBefore(): void
     {
         $document = DemoContent::starter('Mit Karte');
@@ -4710,7 +4791,7 @@ Achern']);
         }
     }
 
-    private function request(string $url, string $method = 'GET', array $body = [], array $cookies = []): Response
+    private function request(string $url, string $method = 'GET', array $body = [], array $cookies = [], array $server = []): Response
     {
         $previous = [];
         foreach (['APP_SECRET' => 'test-only', 'DATABASE_URL' => 'sqlite:///'.str_replace('\\', '/', $this->path), 'SITE_ORIGIN' => 'https://cms.test', 'MEDIA_DIRECTORY' => $this->path.'-media', 'FONT_DIRECTORY' => $this->path.'-fonts', 'ASSET_DIRECTORY' => $this->path.'-assets'] as $key => $value) {
@@ -4719,7 +4800,7 @@ Achern']);
         }
         $kernel = new Kernel('test', false);
         try {
-            $request = Request::create($url, $method, $body, $cookies);
+            $request = Request::create($url, $method, $body, $cookies, [], $server);
             $response = $kernel->handle($request);
             // Counting happens on kernel.terminate, so a test that does not terminate would
             // silently test a different application than the one that runs.

tests/EditorSecurityTest.php

@@ -356,6 +356,54 @@ final class EditorSecurityTest extends WebTestCase
         self::assertSame(1, (int) $this->db->fetchOne('SELECT COUNT(*) FROM page'));
     }
 
+    public function testEditorsChangeLivePagesOnlyThroughAPublisher(): void
+    {
+        // Eine veröffentlichte Unterseite und ein reiner Entwurf (ADR 116).
+        $pages = new PageRepository($this->db, new DocumentValidator(), new SiteSettings($this->db, new MediaLibrary($this->db, $this->path.'-media')));
+        $live = $pages->createPage('leistungen', null, 'page', DemoContent::starter('Leistungen'));
+        $seite = $pages->findForEditor($live);
+        $pages->publish($live, $seite['draft_revision_id'], $seite['version']);
+        $entwurf = $pages->createPage('entwurf', null, 'page', DemoContent::starter('Entwurf'));
+        $version = static fn (string $id): int => (int) $pages->findForEditor($id)['version'];
+
+        $client = $this->login('editor');
+        $token = $client->request('GET', '/admin')->filter('input[name="_csrf_token"]')->last()->attr('value');
+        foreach (['move' => ['slug' => 'umbenannt'], 'trash' => [], 'bereiche' => ['headerArea' => '', 'footerArea' => 'none'], 'meta' => ['robots' => 'noindex']] as $aktion => $felder) {
+            $client->request('POST', '/admin/pages/'.$live.'/'.$aktion, ['_csrf_token' => $token, 'expectedVersion' => $version($live), ...$felder]);
+            self::assertResponseRedirects();
+        }
+        $nachher = $this->db->fetchAssociative('SELECT path, deleted_at, footer_area, robots FROM page WHERE id = ?', [$live]);
+        self::assertSame('leistungen', $nachher['path'], 'Ein Redakteur verschiebt keine veröffentlichte Seite.');
+        self::assertNull($nachher['deleted_at'], 'Ein Redakteur legt keine veröffentlichte Seite in den Papierkorb.');
+        self::assertNull($nachher['footer_area']);
+        self::assertNotSame('noindex', $nachher['robots']);
+
+        // Einen Entwurf, der nie online war, bearbeitet er weiter frei.
+        $client->request('POST', '/admin/pages/'.$entwurf.'/move', ['_csrf_token' => $token, 'expectedVersion' => $version($entwurf), 'slug' => 'neuer-name']);
+        self::assertSame('neuer-name', $this->db->fetchOne('SELECT path FROM page WHERE id = ?', [$entwurf]));
+
+        // Wer veröffentlichen darf, darf auch das.
+        $client = $this->login('publisher', $client);
+        $token = $client->request('GET', '/admin')->filter('input[name="_csrf_token"]')->last()->attr('value');
+        $client->request('POST', '/admin/pages/'.$live.'/move', ['_csrf_token' => $token, 'expectedVersion' => $version($live), 'slug' => 'umbenannt']);
+        self::assertSame('umbenannt', $this->db->fetchOne('SELECT path FROM page WHERE id = ?', [$live]));
+    }
+
+    public function testAScheduledPublicationPublishesTheRevisionThatWasScheduled(): void
+    {
+        $pages = new PageRepository($this->db, new DocumentValidator(), new SiteSettings($this->db, new MediaLibrary($this->db, $this->path.'-media')));
+        $id = $pages->createPage('termin', null, 'page', DemoContent::starter('Geprüfter Stand'));
+        $geprueft = $pages->findForEditor($id)['draft_revision_id'];
+        $pages->schedule($id, '2026-01-01 08:00', (int) $pages->findForEditor($id)['version']);
+        // Nach dem Planen speichert jemand einen anderen Entwurf.
+        $pages->saveDraft($id, DemoContent::starter('Später gespeichert'), (int) $pages->findForEditor($id)['version']);
+        self::assertNotSame($geprueft, $pages->findForEditor($id)['draft_revision_id']);
+
+        self::assertSame(['termin'], $pages->publishDue());
+        self::assertSame($geprueft, $this->db->fetchOne('SELECT published_revision_id FROM page WHERE id = ?', [$id]), 'Online geht der geplante Stand, nicht der spätere Entwurf.');
+        self::assertNull($this->db->fetchOne('SELECT publish_revision_id FROM page WHERE id = ?', [$id]));
+    }
+
     public function testAdministratorsDeleteAPageWithAllRevisionsOnlyWithACsrfToken(): void
     {
         $client = $this->login('admin');
@@ -499,7 +547,7 @@ final class EditorSecurityTest extends WebTestCase
     {
         return [
             'page' => 'home', 'block' => 'formblock', 'website' => '',
-            'issued' => $issued, 'issuedSignature' => hash_hmac('sha256', $issued, 'isolated-test-secret'),
+            'issued' => $issued, 'issuedSignature' => FormRepository::stamp('kontakt', (int) $issued, 'isolated-test-secret'),
             'name' => 'Umut', 'email' => 'umut@example.com', 'thema' => 'Beratung',
             'nachricht' => 'Bitte um Rückruf.', 'datenschutz' => 'ja',
         ];
@@ -611,7 +659,7 @@ final class EditorSecurityTest extends WebTestCase
      */
     public static function droppedSubmissions(): iterable
     {
-        $sign = static fn (string $issued): string => hash_hmac('sha256', $issued, 'isolated-test-secret');
+        $sign = static fn (string $issued): string => FormRepository::stamp('kontakt', (int) $issued, 'isolated-test-secret');
         yield 'honeypot filled' => [static fn (array $body): array => [...$body, 'website' => 'https://spam.example']];
         yield 'submitted too fast' => [static fn (array $body): array => [...$body, 'issued' => (string) time(), 'issuedSignature' => $sign((string) time())]];
         yield 'timestamp forged' => [static fn (array $body): array => [...$body, 'issuedSignature' => 'nicht-signiert']];
@@ -650,7 +698,47 @@ final class EditorSecurityTest extends WebTestCase
         $client->request('POST', '/formular/kontakt', $this->validBody((string) (time() - 10)));
         self::assertResponseStatusCodeSame(303);
         self::assertSame(FormRepository::RATE_LIMIT, (int) $this->db->fetchOne('SELECT COUNT(*) FROM form_submission'));
-        self::assertTrue($forms->rateLimited(hash_hmac('sha256', '127.0.0.1', 'isolated-test-secret')));
+        self::assertTrue($forms->rateLimited(FormRepository::senderKey('127.0.0.1', 'isolated-test-secret')));
+    }
+
+    public function testSendersOfOneIpv6NetworkCountTogether(): void
+    {
+        // Ein Anschluss hat ein ganzes /64-Netz; jede Adresse daraus ist derselbe Absender (ADR 116).
+        $a = FormRepository::senderKey('2001:db8:1:2:aaaa::1', 's');
+        self::assertSame($a, FormRepository::senderKey('2001:db8:1:2:ffff:1:2:3', 's'));
+        self::assertNotSame($a, FormRepository::senderKey('2001:db8:1:3::1', 's'));
+        self::assertNotSame(FormRepository::senderKey('192.0.2.1', 's'), FormRepository::senderKey('192.0.2.2', 's'));
+    }
+
+    public function testAStampFromOneFormDoesNotOpenAnother(): void
+    {
+        // Das Siegel gilt für ein Formular; eines von einer anderen Seite lässt sich nicht
+        // wiederverwenden (ADR 116). Der Versand wird still verworfen wie bei jedem Bot.
+        $this->contactForm();
+        $this->pageWithForm();
+        $client = self::createClient();
+        $issued = (string) (time() - 10);
+        $client->request('POST', '/formular/kontakt', [...$this->validBody($issued), 'issuedSignature' => FormRepository::stamp('anderes', (int) $issued, 'isolated-test-secret')]);
+        self::assertResponseStatusCodeSame(303);
+        self::assertSame(0, (int) $this->db->fetchOne('SELECT COUNT(*) FROM form_submission'));
+    }
+
+    public function testAFloodStopsStoringAndTellsTheVisitor(): void
+    {
+        $forms = $this->contactForm();
+        $this->pageWithForm();
+        $form = $forms->findBySlug('kontakt');
+        // Viele verschiedene Absender in der letzten Stunde: die Grenze je Formular greift.
+        for ($i = 0; $i < FormRepository::FORM_RATE_LIMIT; ++$i) {
+            $forms->store($form['id'], ['name' => 'x'], true, 'absender-'.$i);
+        }
+        self::assertTrue($forms->flooded($form['id']));
+        $client = self::createClient();
+        $client->request('POST', '/formular/kontakt', $this->validBody((string) (time() - 10)));
+        // Sichtbar statt still: ein echter Besucher erfährt, dass er anrufen sollte.
+        self::assertResponseStatusCodeSame(422);
+        self::assertStringContainsString('Gerade gehen sehr viele Anfragen ein', (string) $client->getResponse()->getContent());
+        self::assertSame(FormRepository::FORM_RATE_LIMIT, (int) $this->db->fetchOne('SELECT COUNT(*) FROM form_submission'));
     }
 
     public function testAFormCarriesItsOwnColoursOntoThePageAndTheAdministrationRefusesBadOnes(): void

tests/FormStepsTest.php

@@ -291,7 +291,7 @@ final class FormStepsTest extends TestCase
 
         $issued = time() - 10;
         $grund = [
-            'page' => 'home', 'block' => 'preis', 'issued' => (string) $issued, 'issuedSignature' => hash_hmac('sha256', (string) $issued, 'test-only'),
+            'page' => 'home', 'block' => 'preis', 'issued' => (string) $issued, 'issuedSignature' => FormRepository::stamp('preisfinder', $issued, 'test-only'),
             'immobilienart' => 'Grundstück', 'wohnflaeche' => '99', 'ausstattung' => ['Balkon'], 'flaeche' => '640', 'email' => 'x@example.org', 'datenschutz' => 'ja',
         ];
         $antwort = $this->request('/formular/preisfinder', 'POST', $grund);

tests/InstallFlowTest.php

@@ -23,6 +23,8 @@ final class InstallFlowTest extends TestCase
 {
     private string $root;
     private string $database;
+    /** @var array<string, string> Cookies wie im Browser: der Nachweis des Installationsschlüssels. */
+    private array $cookies = [];
 
     protected function setUp(): void
     {
@@ -58,6 +60,11 @@ final class InstallFlowTest extends TestCase
         self::assertSame(302, $response->getStatusCode());
         self::assertSame('/install', $response->headers->get('Location'));
 
+        // 0b. Ohne Installationsschlüssel öffnet sich kein Schritt (ADR 116).
+        self::assertSame('/install/schluessel', $this->request('/install')->headers->get('Location'));
+        self::assertSame('/install/schluessel', $this->request('/install/datenbank')->headers->get('Location'));
+        $this->unlock();
+
         // 1. The system check.
         $check = $this->request('/install');
         self::assertSame(200, $check->getStatusCode());
@@ -92,6 +99,9 @@ final class InstallFlowTest extends TestCase
         self::assertStringContainsString('Fertig.', $done->getContent());
         self::assertStringContainsString('Impressum und Datenschutzerklärung ausfüllen', $done->getContent());
 
+        // Der Schlüssel hat seine Arbeit getan und liegt nicht mehr herum.
+        self::assertFileDoesNotExist($this->root.'/var/install.key');
+
         // 6. The installer is over, and the website answers.
         self::assertSame(404, $this->request('/install')->getStatusCode());
         self::assertSame(404, $this->request('/install/konto')->getStatusCode());
@@ -105,8 +115,41 @@ final class InstallFlowTest extends TestCase
         self::assertSame(200, $this->request('/admin/login')->getStatusCode());
     }
 
+    public function testTheInstallerOpensOnlyWithItsKey(): void
+    {
+        // Wer die frische Installation zuerst aufruft, bekommt nur die Frage nach dem Schlüssel.
+        $page = $this->request('/install/schluessel');
+        self::assertSame(200, $page->getStatusCode());
+        self::assertStringContainsString('Installationsschlüssel', (string) $page->getContent());
+        $key = trim((string) file_get_contents($this->root.'/var/install.key'));
+        self::assertMatchesRegularExpression('/^[a-f0-9]{32}$/', $key);
+
+        // Ein falscher Schlüssel öffnet nichts und setzt kein Cookie.
+        $wrong = $this->request('/install/schluessel', 'POST', ['schluessel' => str_repeat('0', 32)]);
+        self::assertSame(200, $wrong->getStatusCode());
+        self::assertStringContainsString('passt nicht', (string) $wrong->getContent());
+        self::assertSame([], $wrong->headers->getCookies());
+        // Auch ein selbst gebautes Cookie nicht.
+        $this->cookies = ['kant_install' => hash_hmac('sha256', 'installer', 'geraten')];
+        self::assertSame('/install/schluessel', $this->request('/install')->headers->get('Location'));
+
+        // Der Verweis von install.php trägt den Schlüssel in der Adresse; danach geht es ohne ihn weiter.
+        $this->cookies = [];
+        $open = $this->request('/install/schluessel?schluessel='.$key);
+        self::assertSame('/install', $open->headers->get('Location'));
+        $cookie = $open->headers->getCookies()[0];
+        self::assertSame('kant_install', $cookie->getName());
+        self::assertTrue($cookie->isHttpOnly());
+        self::assertSame('strict', $cookie->getSameSite());
+        self::assertSame('/install', $cookie->getPath());
+        self::assertNotSame($key, $cookie->getValue(), 'Im Cookie steht ein Nachweis, nicht der Schlüssel.');
+        $this->cookies = ['kant_install' => (string) $cookie->getValue()];
+        self::assertSame(200, $this->request('/install')->getStatusCode());
+    }
+
     public function testAStepWithoutItsRequirementSendsYouBack(): void
     {
+        $this->unlock();
         // Somebody who guesses the address of a later step does not get past the missing database.
         self::assertSame('/install/datenbank', $this->request('/install/migration')->headers->get('Location'));
         self::assertSame('/install/migration', $this->request('/install/website')->headers->get('Location'));
@@ -118,6 +161,15 @@ final class InstallFlowTest extends TestCase
         self::assertFileDoesNotExist($this->root.'/.env');
     }
 
+    /** Gibt den Installationsschlüssel ein, wie es der Betreiber tut, und behält das Cookie. */
+    private function unlock(): void
+    {
+        $this->request('/install/schluessel');
+        $response = $this->request('/install/schluessel', 'POST', ['schluessel' => trim((string) file_get_contents($this->root.'/var/install.key'))]);
+        self::assertSame('/install', $response->headers->get('Location'));
+        $this->cookies['kant_install'] = (string) $response->headers->getCookies()[0]->getValue();
+    }
+
     /** Posts a form with the signature the rendered page carries, the way a browser would. */
     private function submit(string $url, Response $page, array $fields): Response
     {
@@ -143,7 +195,7 @@ final class InstallFlowTest extends TestCase
         }
         $kernel = new InstallTestKernel($this->root);
         try {
-            $request = Request::create($url, $method, $body);
+            $request = Request::create($url, $method, $body, $this->cookies);
             $response = $kernel->handle($request);
             $kernel->terminate($request, $response);
 

tests/InstallationTest.php

@@ -12,6 +12,7 @@ use App\Domain\CmsUser;
 use App\Domain\InvalidPage;
 use App\Infrastructure\ConnectionFactory;
 use App\Ops\Installation;
+use App\Ops\Protection;
 use Doctrine\DBAL\Connection;
 use PHPUnit\Framework\Attributes\DataProvider;
 use PHPUnit\Framework\TestCase;
@@ -48,6 +49,38 @@ final class InstallationTest extends TestCase
         $this->installation = $this->make();
     }
 
+    public function testMissingLockFilesAreAddedButAnOwnRootFileStays(): void
+    {
+        // var/ gibt es nicht im Archiv, also legt die Website die Sperrdatei selbst an (ADR 116).
+        mkdir($this->root.'/config/schutz', 0o775, true);
+        mkdir($this->root.'/vendor', 0o775, true);
+        foreach (['sperren', 'stamm'] as $name) {
+            copy(\dirname(__DIR__).'/config/schutz/'.$name.'.htaccess', $this->root.'/config/schutz/'.$name.'.htaccess');
+        }
+        file_put_contents($this->root.'/.htaccess', '# eigene Regeln
+');
+        Protection::reset();
+        Protection::ensure($this->root);
+        self::assertStringContainsString('Require all denied', (string) file_get_contents($this->root.'/var/.htaccess'));
+        self::assertStringContainsString('Require all denied', (string) file_get_contents($this->root.'/vendor/.htaccess'));
+        self::assertSame('# eigene Regeln
+', file_get_contents($this->root.'/.htaccess'), 'Eine eigene Datei im Projektstamm bleibt.');
+        Protection::reset();
+    }
+
+    public function testTheInstallKeyIsCreatedOnceAndCheckedStrictly(): void
+    {
+        $key = $this->installation->installKey();
+        self::assertMatchesRegularExpression('/^[a-f0-9]{32}$/', $key);
+        self::assertSame($key, $this->installation->installKey(), 'Einmal angelegt, bleibt er.');
+        self::assertTrue($this->installation->acceptsKey(' '.strtoupper($key).' '), 'Abgetippt mit Leerzeichen und Großbuchstaben zählt.');
+        self::assertFalse($this->installation->acceptsKey(substr($key, 0, 31)));
+        self::assertFalse($this->installation->acceptsKey(''));
+        self::assertTrue($this->installation->acceptsProof($this->installation->keyProof()));
+        self::assertFalse($this->installation->acceptsProof(''));
+        self::assertFalse($this->installation->acceptsProof($key));
+    }
+
     protected function tearDown(): void
     {
         $this->db->close();

tests/NotfallTest.php

@@ -0,0 +1,91 @@
+<?php
+
+namespace App\Tests;
+
+use App\EventSubscriber\ErrorLogSubscriber;
+use App\Ops\Notfall;
+use PHPUnit\Framework\TestCase;
+use Symfony\Component\HttpFoundation\Request;
+use Symfony\Component\HttpKernel\Event\ExceptionEvent;
+use Symfony\Component\HttpKernel\Exception\NotFoundHttpException;
+use Symfony\Component\HttpKernel\HttpKernelInterface;
+
+/**
+ * Kein leerer 500er mehr (ADR 113).
+ *
+ * Kantarci Reisen am 09.10.2026: Datenbank per FTP ersetzt, danach eine weiße Seite auf jeder
+ * Adresse und kein Hinweis darauf, warum. Seitdem sehen Besucher eine Wartungsseite mit 503, und
+ * der Grund steht in var/log/notfall.log.
+ */
+final class NotfallTest extends TestCase
+{
+    private string $root;
+
+    protected function setUp(): void
+    {
+        $this->root = str_replace('\\', '/', sys_get_temp_dir()).'/kant-notfall-'.bin2hex(random_bytes(6));
+        mkdir($this->root, 0o775, true);
+        Notfall::einschalten($this->root);
+    }
+
+    protected function tearDown(): void
+    {
+        foreach (glob($this->root.'/var/log/*') ?: [] as $datei) {
+            unlink($datei);
+        }
+        @rmdir($this->root.'/var/log');
+        @rmdir($this->root.'/var');
+        @rmdir($this->root);
+    }
+
+    private function ereignis(\Throwable $fehler): ExceptionEvent
+    {
+        $kernel = $this->createStub(HttpKernelInterface::class);
+
+        return new ExceptionEvent($kernel, Request::create('/leistungen'), HttpKernelInterface::MAIN_REQUEST, $fehler);
+    }
+
+    public function testAServerErrorBecomesAMaintenancePageAndALogLine(): void
+    {
+        $ursache = new \PDOException('file is not a database');
+        $ereignis = $this->ereignis(new \RuntimeException('Abfrage fehlgeschlagen', 0, $ursache));
+
+        (new ErrorLogSubscriber(debug: false))->onException($ereignis);
+
+        $antwort = $ereignis->getResponse();
+        self::assertNotNull($antwort);
+        self::assertSame(503, $antwort->getStatusCode(), 'Für Suchmaschinen: gleich wieder da, nicht kaputt.');
+        self::assertSame('300', $antwort->headers->get('Retry-After'));
+        self::assertStringContainsString('Die Website ist gleich wieder da.', (string) $antwort->getContent());
+        self::assertStringNotContainsString('database', (string) $antwort->getContent(), 'Einzelheiten gehören ins Protokoll, nicht auf die Seite.');
+        $protokoll = (string) file_get_contents($this->root.'/'.Notfall::PROTOKOLL);
+        self::assertStringContainsString('GET /leistungen – RuntimeException: Abfrage fehlgeschlagen', $protokoll);
+        self::assertStringContainsString('Ursache: PDOException: file is not a database', $protokoll, 'Die eigentliche Ursache steckt eine Ebene tiefer.');
+    }
+
+    public function testANotFoundIsNoEmergencyAndDevelopmentKeepsItsDetailedPage(): void
+    {
+        $nichtGefunden = $this->ereignis(new NotFoundHttpException('Gibt es nicht'));
+        (new ErrorLogSubscriber(debug: false))->onException($nichtGefunden);
+        self::assertNull($nichtGefunden->getResponse());
+        self::assertFileDoesNotExist($this->root.'/'.Notfall::PROTOKOLL);
+
+        // „Zugriff verweigert“ führt zur Anmeldung - die Sicherheitsschicht entscheidet, nicht der Notfall.
+        $verweigert = $this->ereignis(new \Symfony\Component\Security\Core\Exception\AccessDeniedException());
+        (new ErrorLogSubscriber(debug: false))->onException($verweigert);
+        self::assertNull($verweigert->getResponse());
+        self::assertFileDoesNotExist($this->root.'/'.Notfall::PROTOKOLL);
+
+        $entwicklung = $this->ereignis(new \LogicException('Fehler beim Entwickeln'));
+        (new ErrorLogSubscriber(debug: true))->onException($entwicklung);
+        self::assertNull($entwicklung->getResponse(), 'Im Entwicklungsmodus bleibt die ausführliche Fehlerseite.');
+        self::assertStringContainsString('LogicException: Fehler beim Entwickeln', (string) file_get_contents($this->root.'/'.Notfall::PROTOKOLL));
+    }
+
+    public function testTheFrontControllerLoadsTheEmergencyLayerBeforeAnythingElse(): void
+    {
+        $einstieg = (string) file_get_contents(dirname(__DIR__).'/public/index.php');
+        self::assertLessThan(strpos($einstieg, 'config/bootstrap.php'), strpos($einstieg, 'Notfall::einschalten'), 'Scheitert schon der Start, muss die Notfallschicht stehen.');
+        self::assertStringContainsString('catch (Throwable $fehler)', $einstieg);
+    }
+}

tests/ReleaseOnDisk.php

@@ -28,7 +28,7 @@ final class ReleaseOnDisk extends Download
     /** Legt ein vollständiges Release ab: Releaseliste, Archiv und Prüfsumme. */
     public function release(string $base, string $api, string $version, string $archiv, ?string $checksum = null): void
     {
-        $this->serve($api.'/releases/latest', json_encode(['tag_name' => 'v'.$version], JSON_THROW_ON_ERROR));
+        $this->serve($api.'/releases/latest', json_encode(['tag_name' => 'v'.$version, 'name' => 'KantSites '.$version, 'body' => 'Fortschritt live.'], JSON_THROW_ON_ERROR));
         $this->serve(sprintf('%s/v%s/kantsites-%s.zip', $base, $version, $version), $archiv);
         $this->serve(sprintf('%s/v%s/kantsites-%s.zip.sha256', $base, $version, $version), sprintf(
             "%s  kantsites-%s.zip\n",

tests/SingleFileInstallerTest.php

@@ -85,6 +85,25 @@ final class SingleFileInstallerTest extends TestCase
         self::assertFileDoesNotExist(\dirname($this->target).'/entwischt.txt');
     }
 
+    public function testTheInstallerKeyIsWrittenForTheWebInstaller(): void
+    {
+        // install.php legt den Schlüssel dort an, wo der Installer ihn sucht (ADR 116).
+        $key = kant_install_key($this->target);
+        self::assertMatchesRegularExpression('/^[a-f0-9]{32}$/', $key);
+        self::assertSame($key, trim((string) file_get_contents($this->target.'/var/install.key')));
+        self::assertSame($key, kant_install_key($this->target), 'Ein zweiter Aufruf liest denselben Schlüssel.');
+    }
+
+    public function testTheReleaseCarriesItsLockFiles(): void
+    {
+        // Die Sperrdateien liegen im Repository und gleichen ihrer Vorlage (ADR 116).
+        $root = \dirname(__DIR__);
+        self::assertFileEquals($root.'/config/schutz/stamm.htaccess', $root.'/.htaccess');
+        foreach (['bin', 'config', 'migrations', 'plugins', 'src', 'templates'] as $ordner) {
+            self::assertFileEquals($root.'/config/schutz/sperren.htaccess', $root.'/'.$ordner.'/.htaccess', $ordner);
+        }
+    }
+
     public function testThePreflightNamesWhatIsMissing(): void
     {
         $checks = kant_checks($this->target);

tests/SystemScreenTest.php

@@ -306,6 +306,38 @@ final class SystemScreenTest extends WebTestCase
         }
     }
 
+    public function testTheOneClickUpdateEndpointsAreForAdministratorsOnly(): void
+    {
+        // Der Fortschritt für die Systemseite (ADR 113): Redakteure sehen ihn nicht, ein Start
+        // braucht das Token der Sitzung, ein Abschluss den Einmalschlüssel des laufenden Updates.
+        $redaktion = $this->login('editor');
+        $redaktion->request('GET', '/admin/system/update/status');
+        self::assertSame(403, $redaktion->getResponse()->getStatusCode());
+
+        $admin = $this->login();
+        $admin->request('GET', '/admin/system/update/status');
+        self::assertSame(200, $admin->getResponse()->getStatusCode());
+        self::assertArrayHasKey('installiert', json_decode((string) $admin->getResponse()->getContent(), true));
+
+        $admin->request('POST', '/admin/system/update/starten', [], [], ['HTTP_X_CSRF_TOKEN' => 'erfunden']);
+        self::assertSame(403, $admin->getResponse()->getStatusCode());
+        self::assertStringContainsString('Sitzung ist abgelaufen', (string) $admin->getResponse()->getContent());
+
+        $admin->request('POST', '/admin/system/update/abschliessen', ['token' => 'egal']);
+        self::assertStringContainsString('bereits abgeschlossen', (string) $admin->getResponse()->getContent(), 'Ohne offenes Update gibt es nichts abzuschließen.');
+
+        $marke = dirname(__DIR__).'/'.ArchiveUpdate::MARKE;
+        @mkdir(dirname($marke), 0o775, true);
+        file_put_contents($marke, json_encode(['fassung' => '9.9.9', 'seit' => gmdate('c'), 'alt' => 'x', 'token' => str_repeat('b', 32)]));
+        try {
+            $admin->request('POST', '/admin/system/update/abschliessen', ['token' => 'falsch']);
+            self::assertSame(403, $admin->getResponse()->getStatusCode());
+            self::assertFileExists($marke);
+        } finally {
+            @unlink($marke);
+        }
+    }
+
     public function testNobodyButAnAdministratorCanStartAMigration(): void
     {
         // Ein Knopf, der die Datenbank umbaut, ist das lohnendste Ziel auf diesem Bildschirm.

tests/TestSchema.php

@@ -23,6 +23,7 @@ use DoctrineMigrations\Version20260915000100;
 use DoctrineMigrations\Version20260916000100;
 use DoctrineMigrations\Version20260917000100;
 use DoctrineMigrations\Version20261009000100;
+use DoctrineMigrations\Version20261012000100;
 use Psr\Log\NullLogger;
 
 /**
@@ -57,6 +58,7 @@ final class TestSchema
             Version20260916000100::class,
             Version20260917000100::class,
             Version20261009000100::class,
+            Version20261012000100::class,
         ] as $migration) {
             (new $migration($db, new NullLogger()))->up($schema);
         }

tests/TranslationTest.php

@@ -4,6 +4,7 @@ namespace App\Tests;
 
 use App\Content\DemoContent;
 use App\Content\DocumentValidator;
+use App\Content\FormRepository;
 use App\Content\Languages;
 use App\Content\MediaLibrary;
 use App\Content\PageRepository;
@@ -312,7 +313,7 @@ final class TranslationTest extends TestCase
     public function testFormsSpeakTheLanguageOfThePageButSendInTheMainLanguage(): void
     {
         $this->languages->save(['en']);
-        $forms = new \App\Content\FormRepository($this->db);
+        $forms = new FormRepository($this->db);
         $translations = ['en' => ['buttonLabel' => 'Send request', 'success' => 'Thanks!', 'fields' => [
             'art' => ['label' => 'Type of enquiry', 'options' => ['Beratung' => 'Advice', 'Angebot' => 'Quote', 'Gibt es nicht' => 'x']],
             'email' => ['label' => 'Email', 'help' => ''],
@@ -352,7 +353,7 @@ final class TranslationTest extends TestCase
         self::assertStringNotContainsString('name="language"', $german);
 
         $issued = time() - 10;
-        $body = ['page' => 'kontakt', 'block' => 'f1', 'language' => 'en', 'issued' => (string) $issued, 'issuedSignature' => hash_hmac('sha256', (string) $issued, 'test-only'), 'art' => 'Beratung', 'email' => ''];
+        $body = ['page' => 'kontakt', 'block' => 'f1', 'language' => 'en', 'issued' => (string) $issued, 'issuedSignature' => FormRepository::stamp('anfrage', $issued, 'test-only'), 'art' => 'Beratung', 'email' => ''];
         $refused = $this->request('/formular/anfrage', 'POST', $body);
         self::assertSame(422, $refused->getStatusCode());
         self::assertStringContainsString('This field is required.', (string) $refused->getContent());