diff --git a/.cursor/rules/luf-betrieb.mdc b/.cursor/rules/luf-betrieb.mdc new file mode 100644 index 0000000..f59416e --- /dev/null +++ b/.cursor/rules/luf-betrieb.mdc @@ -0,0 +1,15 @@ +--- +description: Verbindliche Betriebs- und Entwicklungsregeln für Lara & Felix. Die Quelle ist CLAUDE.md. +alwaysApply: true +--- + +# Lara & Felix – Betrieb + +Lies und befolge `CLAUDE.md` im Repository-Root. Diese Regel wiederholt die dortigen Vorgaben nicht. + +- Gearbeitet wird auf `develop` oder auf `feature/*`, die nach `develop` münden. Nie auf `main` committen, pushen oder mergen. +- Ein Push auf `develop` deployt auf Test. Ein Push auf `main` deployt auf Produktion und bleibt Lars vorbehalten. +- Kein Deploy von Hand (`docker compose`, `deploy.sh`, `systemctl` auf den Servern). +- Keine Secrets ins Repo, in Commits, Logs oder Chat. +- Tests vor dem Push auf `develop`. Fehlgeschlagene Tests werden behoben, nicht umgangen. +- Medien- und Prozessgrenzen aus `CLAUDE.md` nicht aufweichen: der Web-Prozess schreibt nicht nach `originals/` und liest `derived/` und `public/` nur. diff --git a/.cursor/rules/verwaltung-ux.mdc b/.cursor/rules/verwaltung-ux.mdc new file mode 100644 index 0000000..d7efd27 --- /dev/null +++ b/.cursor/rules/verwaltung-ux.mdc @@ -0,0 +1,19 @@ +--- +description: Gemeinsame verbindliche UX-Vorgaben für Verwaltungsänderungen bei Lara & Felix. Ergänzt die Betriebsregeln, ersetzt sie nicht. +alwaysApply: true +--- + +# Verwaltung – gemeinsame Designgrundlage + +Betriebsregeln in `CLAUDE.md` und `.cursor/rules/luf-betrieb.mdc` bleiben verbindlich. Diese Datei ergänzt sie für die Verwaltungsoberfläche. + +1. `CLAUDE.md`, vorhandene aktive Repository-Regeln und `docs/ux/verwaltung/README.md` lesen. +2. `docs/ux/verwaltung/14-verwaltungsstandard.md` ist die maßgebliche UX-Grundlage. `15-umbauauftrag.md` beschreibt Umsetzung und Nachweise. Keine erneute allgemeine Designfreigabe oder neue Mockups je Screen verlangen. +3. Gemeinsame Komponenten statt kopierter Masken: Rahmen, Listen, Picker, Redaktion, geordnete Zuordnung, Status/Aktionen und Vorschau. Fachlich zulässige Typen und Referenzen sind Kontext derselben Komponente. Vorhanden in `resources/views/filament/verwaltung/`: `kopf` (Objektkopf, Status, Aktionen, Weitere Aktionen), `redaktion` (Manager), `texte`/`textfeld`, `praesentation`/`zuordnung-menue`, `einordnung`, `varianten`, `picker` (auch Aufbau, Vorschaubild und CMS-Bilder; Logik im Trait `ChoosesMedia`), `bestand` (gemeinsame Bestandsliste mit Suche, Filtern, aktiven Filterchips, Zeilen/Kacheln, „Weitere anzeigen“ und Dialogbereich; Trait `ShowsBestand`), Komponente `` (Vorschau, Titel, Typzeile; Picker und Listen), `aufbau` (Struktur links, Detail rechts; auch Fassungen eines Mediums), `catalog/objekt` (Angebot, Paket, Rechteprofil), `cms/seite-kopf` (Seiteneditor mit Registern und Kontexten), Webpräsenz `cms/menues` mit `menue-zeile`, `menue-detail`, `ziel-auswahl` (Menüs als Arbeitsstand, breit Liste mit Detail, schmal ein aufgeklappter Eintrag), `bestaetigung` (statt `wire:confirm`), `abgang` (Warnung bei ungespeicherten Änderungen), `styles` (Tokens, einmal je Seite über den Panel-Hook). Logik im Trait `App\Filament\Support\ManagesEditorialSurface`; neue Objektarten liefern nur Feldliste, Einordnungsgruppen und Kopfangaben. +4. Eindeutigen Speicherumfang, Zustand und Vorschau-Datenstand anzeigen. Keine pauschale neue Genehmigungskette. Produktbeschreibung, Lehrinhalt, kommerzielle Daten und technische Verwaltung gezielt gliedern. +5. Redaktion für Medien einschließlich Filmen, Module, Programme und Lizenzartikel gemeinsam nutzen. Zentrale Medien referenzieren, mehrere Medien je Rolle und reine Präsentationsmedien ohne Lehrfassung erhalten. +6. Rückkehr mit offenen Eingaben sicherstellen; kein Pflichtspeichern vor dem Redaktionswechsel, kein heimliches Mitspeichern und kein veraltetes Zurückschreiben. +7. Bestehende Erwerbe, Rechte, Historie und fachliche Fassungsregeln erhalten. Offene Fragen in Dokument 04 nicht selbst durch neue Geschäftsregeln entscheiden; nur tatsächlich abhängige Teile gezielt klären. +8. Bestehende Tokens und freigegebene Assets nutzen. Verwaltungsmaße: `docs/ux/verwaltung/tokens.md`. Bilder sind räumliche Referenzen, keine autoritative Farbquelle oder auszuliefernde UI-Grafik. +9. Betroffene Abläufe funktional und visuell prüfen: Rückkehr, relevante Fehler-/Leer-/Ladezustände, Tastatur, breite/schmalere Fenster und fachliche Regressionen. Bestehende Betriebs- und Testregeln erfüllen. +10. Tatsächliche Komponentenwiederverwendung, Prüfergebnisse, gerenderte Screenshots und konkrete Abweichungen liefern; `docs/ux/verwaltung/regeln/ux-abnahme-vorlage.md` verwenden. Keine unbewiesene Abnahme behaupten. diff --git a/.dockerignore b/.dockerignore new file mode 100644 index 0000000..393917a --- /dev/null +++ b/.dockerignore @@ -0,0 +1,15 @@ +.git +.gitea +.env +.env.* +!.env.example +node_modules +vendor +storage/logs/* +storage/framework/cache/* +storage/framework/sessions/* +storage/framework/views/* +public/build +public/hot +docs +*.md diff --git a/.editorconfig b/.editorconfig new file mode 100644 index 0000000..6df8428 --- /dev/null +++ b/.editorconfig @@ -0,0 +1,18 @@ +root = true + +[*] +charset = utf-8 +end_of_line = lf +indent_size = 4 +indent_style = space +insert_final_newline = true +trim_trailing_whitespace = true + +[*.md] +trim_trailing_whitespace = false + +[*.{yml,yaml}] +indent_size = 2 + +[{compose,docker-compose}.{yml,yaml}] +indent_size = 4 diff --git a/.env.example b/.env.example new file mode 100644 index 0000000..f8df09f --- /dev/null +++ b/.env.example @@ -0,0 +1,72 @@ +APP_NAME="Lara und Felix" +APP_ENV=local +APP_KEY= +APP_DEBUG=true +APP_URL=http://localhost:8000 + +APP_LOCALE=de +APP_FALLBACK_LOCALE=de +APP_FAKER_LOCALE=de_DE + +APP_MAINTENANCE_DRIVER=file +# APP_MAINTENANCE_STORE=database + +# PHP_CLI_SERVER_WORKERS=4 + +BCRYPT_ROUNDS=12 + +LOG_CHANNEL=stack +LOG_STACK=single +LOG_DEPRECATIONS_CHANNEL=null +LOG_LEVEL=debug + +DB_CONNECTION=sqlite +# DB_HOST=127.0.0.1 +# DB_PORT=3306 +# DB_DATABASE=laravel +# DB_USERNAME=root +# DB_PASSWORD= + +SESSION_DRIVER=database +SESSION_LIFETIME=120 +SESSION_ENCRYPT=false +SESSION_PATH=/ +SESSION_DOMAIN=null + +BROADCAST_CONNECTION=log +FILESYSTEM_DISK=local +QUEUE_CONNECTION=database + +CACHE_STORE=database +# CACHE_PREFIX= + +MEMCACHED_HOST=127.0.0.1 + +REDIS_CLIENT=phpredis +REDIS_HOST=127.0.0.1 +REDIS_PASSWORD=null +REDIS_PORT=6379 + +MAIL_MAILER=log +MAIL_SCHEME=null +MAIL_HOST=127.0.0.1 +MAIL_PORT=2525 +MAIL_USERNAME=null +MAIL_PASSWORD=null +MAIL_FROM_ADDRESS="hello@example.com" +MAIL_FROM_NAME="${APP_NAME}" + +AWS_ACCESS_KEY_ID= +AWS_SECRET_ACCESS_KEY= +AWS_DEFAULT_REGION=us-east-1 +AWS_BUCKET= +AWS_USE_PATH_STYLE_ENDPOINT=false + +VITE_APP_NAME="${APP_NAME}" + +PAYMENT_DRIVER=test + +# Leer lassen. Lokal gilt dann storage/. Im Container setzt Compose den Host-Mount (/srv/luf//media/...). +MEDIA_PUBLIC_PATH= +MEDIA_DERIVED_PATH= +MEDIA_ORIGINALS_PATH= diff --git a/.gitattributes b/.gitattributes new file mode 100644 index 0000000..fcb21d3 --- /dev/null +++ b/.gitattributes @@ -0,0 +1,11 @@ +* text=auto eol=lf + +*.blade.php diff=html +*.css diff=css +*.html diff=html +*.md diff=markdown +*.php diff=php + +/.github export-ignore +CHANGELOG.md export-ignore +.styleci.yml export-ignore diff --git a/.gitea/workflows/ci-feature.yml b/.gitea/workflows/ci-feature.yml new file mode 100644 index 0000000..bf71bc2 --- /dev/null +++ b/.gitea/workflows/ci-feature.yml @@ -0,0 +1,28 @@ +name: CI Feature + +# Tests auf Feature-Branches, ohne Deployment. Läuft auf dem llm-node-Runner (Label linux_host). +on: + push: + branches: ['feature/**'] + +jobs: + test: + runs-on: linux_host + env: + REPO_URL: http://192.168.2.144:3000/Lars/laraundfelix.git + steps: + - name: Runner prüfen + shell: bash + run: | + set -euo pipefail + [ "$(hostname)" = "llm-node" ] && [ "$(uname -m)" = "x86_64" ] || { echo "✗ Falscher Runner: $(hostname)/$(uname -m)"; exit 1; } + + - name: Commit auschecken und testen + shell: bash + run: | + set -euo pipefail + WORK="$(mktemp -d)"; trap 'rm -rf "$WORK"' EXIT + git clone --quiet "$REPO_URL" "$WORK" + cd "$WORK" + git checkout --quiet "${{ github.sha }}" + bash scripts/ci-test.sh diff --git a/.gitea/workflows/deploy-prod.yml b/.gitea/workflows/deploy-prod.yml new file mode 100644 index 0000000..5eb2f36 --- /dev/null +++ b/.gitea/workflows/deploy-prod.yml @@ -0,0 +1,65 @@ +name: Deploy Production + +# main -> Tests auf genau diesem Commit -> Build -> Deploy (Prod) -> Health, bei Fehler Rollback. +# Deploy läuft nur, wenn der Testjob grün ist. Merge auf main nur per freigegebenem Pull Request aus develop +# (Branch-Schutz in Gitea, siehe docs/betrieb/DEPLOYMENT.md). +on: + push: + branches: [main] + +jobs: + test: + runs-on: linux_host + env: + REPO_URL: http://192.168.2.144:3000/Lars/laraundfelix.git + steps: + - name: Runner prüfen + shell: bash + run: | + set -euo pipefail + [ "$(hostname)" = "llm-node" ] && [ "$(uname -m)" = "x86_64" ] || { echo "✗ Falscher Runner: $(hostname)/$(uname -m)"; exit 1; } + + - name: Commit auschecken und testen + shell: bash + run: | + set -euo pipefail + WORK="$(mktemp -d)"; trap 'rm -rf "$WORK"' EXIT + git clone --quiet "$REPO_URL" "$WORK" + cd "$WORK" + git checkout --quiet "${{ github.sha }}" + bash scripts/ci-test.sh + + deploy: + needs: test + runs-on: linux_host + env: + LUF_ENV: prod + REPO_URL: http://192.168.2.144:3000/Lars/laraundfelix.git + APP_DIR: /home/llmadmin/docker/luf-prod + ENV_FILE: /etc/luf/prod.env + COMPOSE_PROJECT: luf-prod + WEB_PORT: '3010' + steps: + - name: Runner prüfen + shell: bash + run: | + set -euo pipefail + [ "$(hostname)" = "llm-node" ] && [ "$(uname -m)" = "x86_64" ] || { echo "✗ Falscher Runner: $(hostname)/$(uname -m)"; exit 1; } + + - name: Code aktualisieren (getesteter Commit) + shell: bash + run: | + set -euo pipefail + mkdir -p "$APP_DIR" + cd "$APP_DIR" + if [ ! -d .git ]; then + git init -q + git remote add origin "$REPO_URL" + fi + git fetch origin main + git reset --hard "${{ github.sha }}" + git log -1 --oneline + + - name: Deploy + shell: bash + run: bash "$APP_DIR/scripts/deploy.sh" diff --git a/.gitea/workflows/deploy-test.yml b/.gitea/workflows/deploy-test.yml new file mode 100644 index 0000000..60b2993 --- /dev/null +++ b/.gitea/workflows/deploy-test.yml @@ -0,0 +1,65 @@ +name: Deploy Test + +# develop -> Tests -> Build -> Deploy (Test) -> Health. Deploy läuft nur, wenn die Tests grün sind. +# Aktuell auf llm-node (Runner-Label linux_host). Ein Umzug auf den Raspberry Pi braucht nur geänderte +# Werte in env: (Label runs-on, Hostname/Architektur-Guard, APP_DIR, ENV_FILE, WEB_PORT). +on: + push: + branches: [develop] + +jobs: + test: + runs-on: linux_host + env: + REPO_URL: http://192.168.2.144:3000/Lars/laraundfelix.git + steps: + - name: Runner prüfen + shell: bash + run: | + set -euo pipefail + [ "$(hostname)" = "llm-node" ] && [ "$(uname -m)" = "x86_64" ] || { echo "✗ Falscher Runner: $(hostname)/$(uname -m)"; exit 1; } + + - name: Commit auschecken und testen + shell: bash + run: | + set -euo pipefail + WORK="$(mktemp -d)"; trap 'rm -rf "$WORK"' EXIT + git clone --quiet "$REPO_URL" "$WORK" + cd "$WORK" + git checkout --quiet "${{ github.sha }}" + bash scripts/ci-test.sh + + deploy: + needs: test + runs-on: linux_host + env: + LUF_ENV: test + REPO_URL: http://192.168.2.144:3000/Lars/laraundfelix.git + APP_DIR: /home/llmadmin/docker/luf-test + ENV_FILE: /etc/luf/test.env + COMPOSE_PROJECT: luf-test + WEB_PORT: '3011' + steps: + - name: Runner prüfen + shell: bash + run: | + set -euo pipefail + [ "$(hostname)" = "llm-node" ] && [ "$(uname -m)" = "x86_64" ] || { echo "✗ Falscher Runner: $(hostname)/$(uname -m)"; exit 1; } + + - name: Code aktualisieren (getesteter Commit) + shell: bash + run: | + set -euo pipefail + mkdir -p "$APP_DIR" + cd "$APP_DIR" + if [ ! -d .git ]; then + git init -q + git remote add origin "$REPO_URL" + fi + git fetch origin develop + git reset --hard "${{ github.sha }}" + git log -1 --oneline + + - name: Deploy + shell: bash + run: bash "$APP_DIR/scripts/deploy.sh" diff --git a/.gitignore b/.gitignore index ebef3f8..5c402c0 100644 --- a/.gitignore +++ b/.gitignore @@ -1,6 +1,35 @@ -node_modules/ +*.log +.DS_Store .env .env.* -dist/ -.DS_Store +!.env.example +.env.backup +.env.production +.phpactor.json +.phpunit.result.cache +/.codex +/.idea +/.nova +/.phpunit.cache +/.vscode +/.zed +/auth.json +/node_modules +/public/build +/public/css/filament +/public/fonts-manifest.dev.json +/public/fonts/filament +/public/hot +/public/js/filament +/public/storage +/storage/*.key +/storage/pail +/storage/logs/ +/vendor +/database/*.sqlite* +/tmp-laravel/ +/composer.phar +_ide_helper.php +Homestead.json +Homestead.yaml Thumbs.db diff --git a/.npmrc b/.npmrc new file mode 100644 index 0000000..495a6af --- /dev/null +++ b/.npmrc @@ -0,0 +1,2 @@ +ignore-scripts=true +audit=true diff --git a/AGENTS.md b/AGENTS.md new file mode 100644 index 0000000..237f2b4 --- /dev/null +++ b/AGENTS.md @@ -0,0 +1,13 @@ +# Einstieg für Coding-Agenten + +Betriebs-, Test-, Deployment- und Medienschutzregeln stehen in `CLAUDE.md` und in `.cursor/rules/luf-betrieb.mdc`. Sie gelten unverändert. + +Für die Verwaltung zusätzlich: + +- `docs/ux/verwaltung/14-verwaltungsstandard.md` ist die maßgebliche Designgrundlage, `docs/ux/verwaltung/15-umbauauftrag.md` der konkrete Auftrag. Keine neue allgemeine Designfreigabe oder Screenserie verlangen. +- `docs/ux/verwaltung/README.md` und Dokument 04 für Herkunft und offene Geschäftsfragen. Historische Entwürfe nach der Rangfolge in Dokument 14 lesen. +- Gleichartige Aufgaben mit den gemeinsamen Komponenten unter `resources/views/filament/verwaltung/` und `resources/views/filament/editorial/` lösen. Fachfunktionen, Datenbeziehungen, Rechte und Fassungsbindungen erhalten. +- Offene Eingaben beim Wechsel zur Redaktion und zurück erhalten. Speicherwirkung benennen. Maße in `docs/ux/verwaltung/tokens.md`. +- Hauptabläufe prüfen, bestehende Testpflichten erfüllen, Abweichungen konkret benennen. Keine ungeprüfte Abnahme behaupten. + +Diese Datei ergänzt die Betriebsregeln und löst kein Deployment aus. diff --git a/CLAUDE.md b/CLAUDE.md new file mode 100644 index 0000000..f6a9d3f --- /dev/null +++ b/CLAUDE.md @@ -0,0 +1,68 @@ +# Lara & Felix (LUF) – Arbeitsregeln für Claude + +Stack: Laravel 13, PHP 8.4, Filament 5, PostgreSQL, Docker Compose. Repository: Gitea `Lars/laraundfelix` (`git@192.168.2.144:Lars/laraundfelix.git`). +Dokumentation: `docs/` (Architektur, Spezifikation), Betrieb: `docs/betrieb/DEPLOYMENT.md` und `docs/betrieb/Bestandsaufnahme_Deployment_2026-11-15.md`. + +## Branches und Deployment (verbindlich) + +| Branch | Zweck | Wirkung eines Pushs | +|---|---|---| +| `feature/**` | Einzelne Änderungen | Nur Tests (`ci-feature.yml`) | +| `develop` | **Arbeits- und Integrationsbranch** | Tests, dann Deploy auf **Test** (`deploy-test.yml`, Port 3011) | +| `main` | **Produktion** | Tests, dann Deploy auf **Prod** (`deploy-prod.yml`, Port 3010) | + +1. **Gearbeitet wird auf `develop` oder auf `feature/*`-Branches, die in `develop` münden.** Nie direkt auf `main`. +2. **Nie auf `main` pushen, nie nach `main` mergen und keinen Pull Request nach `main` freigeben.** Ein Push auf `main` löst sofort ein Produktiv-Deployment aus. Der Merge `develop` → `main` ist ein **manueller Schritt von Lars** (Pull Request in Gitea, nach Prüfung des Teststands). Claude bereitet höchstens vor: Zusammenfassung der Änderungen seit dem letzten Merge, Stand der Tests, offene Migrationen. +3. Nie `--force`/`--force-with-lease` auf `develop` oder `main`. Kein `git reset --hard` auf geteilten Branches. +4. Vor einem Push auf `develop` prüfen, dass die Tests lokal bzw. im Feature-Branch grün waren. Fehlgeschlagene Tests blockieren das Deployment (`needs: test`); sie nicht umgehen oder deaktivieren. +5. **Claude deployt nie von Hand.** Keine `docker compose`-, `deploy.sh`- oder `systemctl`-Aufrufe auf den Servern. Deployments entstehen ausschließlich durch die Gitea-Workflows. +6. Ein roter Workflow wird behoben, nicht überbrückt. Der Rollback im Deploy-Skript setzt nur den Code zurück, nicht die Datenbank. + +## Tests + +- **Jede Änderung am Verhalten bringt Tests mit** (Feature-Tests für Abläufe, Berechtigungen und Lizenzlogik, Unit-Tests für reine Logik). Fehler werden erst durch einen fehlschlagenden Test reproduziert, dann behoben. +- Es gibt zwei Stufen, beide als eigene Gitea-Jobs: + 1. **Gate vor dem Deploy** (`scripts/ci-test.sh`, Wegwerf-Container, Pint und `php artisan test`). Gilt für `feature/**`, `develop` und `main` und blockiert jedes Deployment. + 2. **Suite auf der Test-Instanz** (wie bei Shinkan, eigener Workflow nach dem Deploy auf `develop`): Integrations- und Browser-Tests gegen die laufende Test-Instanz (`luf-test`). Eigener Workflow, nicht Teil von `deploy-test.yml`. Wird mit U0 angelegt. +- **Tests laufen nie gegen Prod** (`luf-prod`): nicht gegen deren Datenbank, Volumes oder Medien-Mounts, nicht in deren Containern, nicht gegen deren URL. Prod prüfen allein das Gate und die Health-Checks des Deploys. (Bei Shinkan hätten Integrationstests nach einem Prod-Deploy in die Prod-Datenbank geschrieben.) +- **Auf der Test-Instanz** dürfen Tests Daten in der Test-Datenbank anlegen, aber nie die Schemas zurücksetzen: kein `RefreshDatabase`, `migrate:fresh` oder `DatabaseTruncation` gegen `luf-test`, solange die Instanz nicht ausdrücklich dafür vorgesehen ist. Laravel-Env-Werte aus dem Container (`DB_CONNECTION=pgsql`) überschreiben die SQLite-Vorgabe der `phpunit.xml`. Ein Lauf von `php artisan test` im Test-Container würde sonst die Test-Datenbank leeren. Deshalb die Instanz-Suite über HTTP (Pest-Browser/Playwright) oder in einem eigenen Container mit eigener Wegwerf-Datenbank laufen lassen. +- Tests dürfen keine Netzwerkaufrufe an echte Dienste machen (Mail, Zahlung, externe APIs). Dafür Fakes verwenden (`Mail::fake()`, `Http::fake()`, `Storage::fake()`). +- **Ein roter Test wird behoben, nicht umgangen.** Kein `skip`, `markTestSkipped`, Löschen oder Abschwächen von Assertions und kein Deaktivieren von Pint, nur um grün zu werden. Ist ein Test fachlich überholt, wird er bewusst geändert und im Commit begründet. +- Tests sind deterministisch: keine Abhängigkeit von Reihenfolge, Uhrzeit oder Zufall ohne feste Werte (`Carbon::setTestNow`, Seeds). +- **Datenbank in der Suite:** Standard ist die SQLite-In-Memory-Konfiguration aus `phpunit.xml`. Tests, die PostgreSQL-spezifisches Verhalten brauchen (JSONB, Constraints, Migrationen), laufen gegen eine eigene Wegwerf-PostgreSQL-Instanz, nicht gegen `luf-test` oder `luf-prod`. Diese Instanz ist in `scripts/ci-test.sh` noch nicht eingebaut und wird mit U0 ergänzt. +- Ein Commit auf `develop` ohne grüne Suite ist nicht zulässig. Wer die Suite nicht lokal oder auf einem Feature-Branch laufen lassen kann, sagt das, statt trotzdem auf `develop` zu pushen. + +## Migrationen + +- Migrationen müssen **abwärtskompatibel** sein (erst ergänzen, später entfernen), weil der Rollback nur den Code zurücksetzt. +- Keine Migration, die Daten löscht oder umbenennt, ohne vorherige Freigabe von Lars und ein bestätigtes Backup. + +## Server und Umgebungen + +- Test und Prod laufen vorerst **beide auf `llm-node` (192.168.2.144)**, getrennt durch Compose-Projekt (`luf-test`, `luf-prod`), Verzeichnis, Env-Datei, Volumes und Zugangsdaten. Der Raspberry Pi ist als späteres Testsystem vorgesehen (Umzug über die Variablen in `deploy-test.yml`). +- Secrets liegen nur in `/etc/luf/test.env` und `/etc/luf/prod.env` auf dem Server. **Keine Secrets, Passwörter, Keys oder `.env`-Dateien ins Repo, in Commits, Logs oder Chat-Ausgaben.** +- **Auf Servern wird nur nach ausdrücklicher Freigabe geschrieben.** Rein lesende Abfragen über vorhandene SSH-Zugänge sind erlaubt. Keine SSH-Schlüssel, Benutzer, Firewall-, Proxy- oder Runner-Änderungen. Andere Anwendungen auf den Servern (Shinkan, Gitea, mindnet, qdrant, …) dürfen nicht verändert werden. +- Ports werden nicht geraten: Vor jedem neuen Host-Port die tatsächliche Belegung prüfen (`ss`, `docker ps`). Aktuell vorgesehen: Test 3011, Prod 3010 (Stand 2026-11-15). Datenbank und PHP-FPM veröffentlichen keine Host-Ports. +- Der Reverse Proxy (Synology NAS) wird von Lars verwaltet. +- Shell-Zugriff auf llm-node: `ssh -T llmadmin@192.168.2.144 '' `, den auch der Picker verwendet; Katalogobjekte die Seite `catalog/objekt`. CMS: Seitenkopf `cms/seite-kopf` (Register, Kontexte „Abschnitt gestalten“ und „Konfigurieren“); Seiten und Menüs in der Webpräsenz (`App\Filament\Pages\Webpraesenz`, Menüs als Arbeitsstand mit einer Speicherhandlung). Der Picker liegt im Trait `ChoosesMedia` (Redaktion über `ManagesEditorialSurface`, CMS-Bilder über `ChoosesWebsiteImages`); keine eigenen Auswahllisten für Medien bauen. Redaktionelle Auswahlwerte (Materialart, Einordnung) nur über `App\Domain\Catalog\EditorialVocabulary` anbieten und prüfen (aktiv, zulässiger Kontext, vorhandene Zuordnungen erhalten); gepflegt werden sie unter „Redaktionelle Stammdaten“. Ersetzt eine Seite die Filament-Tabelle, muss sie den Dialogbereich ausgeben (in `bestand` enthalten), sonst öffnen „… anlegen“-Dialoge nicht. Gestaltungswerte nur in `verwaltung/styles.blade.php` (Tokens `--vw-…`, dokumentiert in `docs/ux/verwaltung/tokens.md`). +- Die Redaktion ist ein Arbeitsstand: nur „Redaktion speichern“ schreibt Texte, Einordnung, Präsentationsmedien und Abweichungen. Kein verdecktes Mitspeichern aus anderen Dialogen, offene Eingaben bleiben beim Wechsel erhalten. +- Jede UI-Änderung in der echten Anwendung prüfen (luf-test, breite und schmale Fenster, Tastatur) und mit Screenshots in `docs/ux/verwaltung/abnahme/` belegen. Stand der Abnahme: `abnahme/teil-a.md`, `abnahme/teil-b.md`, `abnahme/teil-c.md`, `abnahme/stammdaten.md`. diff --git a/Dockerfile b/Dockerfile new file mode 100644 index 0000000..3d8df19 --- /dev/null +++ b/Dockerfile @@ -0,0 +1,55 @@ +# syntax=docker/dockerfile:1 +# LUF – Laravel 13 / PHP 8.4 / Filament 5 +# Targets: app (php-fpm, auch Queue und Scheduler), web (nginx mit statischen Assets), test (CI) +# Setzt eine Laravel-Anwendung im Repo-Root voraus (composer.json, composer.lock, package.json). Kommt mit U0. + +ARG PHP_VERSION=8.4 + +# ---- Basis: PHP mit den Erweiterungen für Laravel und Filament ------------------------------- +FROM php:${PHP_VERSION}-fpm-alpine AS base +RUN apk add --no-cache icu-libs libzip libpng libjpeg-turbo freetype libpq oniguruma su-exec ffmpeg \ + && apk add --no-cache --virtual .build-deps $PHPIZE_DEPS icu-dev libzip-dev libpng-dev libjpeg-turbo-dev freetype-dev postgresql-dev oniguruma-dev \ + && docker-php-ext-configure gd --with-freetype --with-jpeg \ + && docker-php-ext-install -j"$(nproc)" pdo_pgsql intl zip gd bcmath opcache pcntl exif \ + && apk del .build-deps +COPY --from=composer:2 /usr/bin/composer /usr/bin/composer +WORKDIR /var/www/html + +# ---- Produktions-Abhängigkeiten -------------------------------------------------------------- +FROM base AS vendor +COPY composer.json composer.lock ./ +RUN composer install --no-dev --no-scripts --no-autoloader --prefer-dist --no-interaction +COPY . . +RUN composer dump-autoload --no-dev --optimize --no-interaction \ + && APP_KEY=base64:MDEyMzQ1Njc4OWFiY2RlZjAxMjM0NTY3ODlhYmNkZWY= php artisan filament:assets --ansi --no-interaction + +# ---- Frontend-Assets (Filament-Theme braucht vendor/) ---------------------------------------- +FROM node:22-alpine AS assets +WORKDIR /app +COPY --from=vendor /var/www/html /app +RUN npm ci && npm run build + +# ---- Test-Image (CI): inkl. Dev-Abhängigkeiten, führt Pint und Tests aus --------------------- +FROM base AS test +COPY composer.json composer.lock ./ +RUN composer install --prefer-dist --no-scripts --no-autoloader --no-interaction +COPY . . +RUN composer dump-autoload --optimize --no-interaction +ENV APP_ENV=testing +CMD ["sh", "-ec", "if [ -x vendor/bin/pint ]; then vendor/bin/pint --test; fi; php artisan test --compact"] + +# ---- App (php-fpm; derselbe Tag dient für Queue und Scheduler) ------------------------------- +FROM base AS app +COPY --from=vendor /var/www/html /var/www/html +COPY --from=assets /app/public/build /var/www/html/public/build +COPY docker/entrypoint.sh /usr/local/bin/entrypoint +COPY docker/php.ini /usr/local/etc/php/conf.d/zz-luf.ini +RUN chmod +x /usr/local/bin/entrypoint +ENTRYPOINT ["entrypoint"] +CMD ["php-fpm"] + +# ---- Web (nginx, nur öffentliche Dateien) ---------------------------------------------------- +FROM nginx:1.27-alpine AS web +COPY docker/nginx/default.conf /etc/nginx/conf.d/default.conf +COPY --from=vendor /var/www/html/public /var/www/html/public +COPY --from=assets /app/public/build /var/www/html/public/build diff --git a/README.md b/README.md new file mode 100644 index 0000000..3325c2f --- /dev/null +++ b/README.md @@ -0,0 +1,7 @@ +# Lara & Felix – Stark im Alltag + +Laravel-13-Anwendung mit Filament 5 und PostgreSQL. + +Gearbeitet wird auf `develop`. Ein Push auf `develop` testet und deployt auf die Testumgebung. `main` ist Produktion und wird nicht direkt beschrieben. Die Betriebsregeln stehen in `CLAUDE.md`. + +Lokal: `composer install`, `.env` aus `.env.example`, `php artisan key:generate`, `php artisan migrate`, `npm install`, `npm run build`, `php artisan test`. diff --git a/app/Auth/StaffAuthenticatorName.php b/app/Auth/StaffAuthenticatorName.php new file mode 100644 index 0000000..ada9849 --- /dev/null +++ b/app/Auth/StaffAuthenticatorName.php @@ -0,0 +1,11 @@ +isProduction() ? 'Lara&Felix' : 'Lara&Felix (dev)'; + } +} diff --git a/app/Auth/TrustedStaffDevice.php b/app/Auth/TrustedStaffDevice.php new file mode 100644 index 0000000..e37c60f --- /dev/null +++ b/app/Auth/TrustedStaffDevice.php @@ -0,0 +1,73 @@ +token($user), + self::DAYS * 24 * 60, + '/', + null, + request()->isSecure(), + true, + false, + 'lax', + )); + } + + public function token(User $user): string + { + return Crypt::encryptString(json_encode([ + 'user' => $user->getKey(), + 'until' => now()->addDays(self::DAYS)->getTimestamp(), + 'secret' => $this->fingerprint($user), + ], JSON_THROW_ON_ERROR)); + } + + public function isTrusted(User $user, ?Request $request = null): bool + { + $request ??= request(); + $token = $request->cookies->get(self::COOKIE); + + if (! is_string($token) || $token === '') { + return false; + } + + try { + $payload = json_decode(Crypt::decryptString($token), true, 8, JSON_THROW_ON_ERROR); + } catch (\Throwable) { + return false; + } + + if (! is_array($payload)) { + return false; + } + + $until = $payload['until'] ?? null; + $fingerprint = $payload['secret'] ?? null; + + return (int) ($payload['user'] ?? 0) === (int) $user->getKey() + && is_int($until) + && $until >= now()->getTimestamp() + && is_string($fingerprint) + && hash_equals($this->fingerprint($user), $fingerprint); + } + + private function fingerprint(User $user): string + { + return hash('sha256', (string) $user->getAppAuthenticationSecret()); + } +} diff --git a/app/Console/Commands/CreateStaffUser.php b/app/Console/Commands/CreateStaffUser.php new file mode 100644 index 0000000..5342892 --- /dev/null +++ b/app/Console/Commands/CreateStaffUser.php @@ -0,0 +1,37 @@ +option('role')); + + if ($role === null) { + $this->error('Unbekannte Rolle.'); + + return self::FAILURE; + } + + $password = Str::password(20); + $user = $register->register((string) $this->option('name'), (string) $this->argument('email'), $password, true); + $user->markEmailAsVerified(); + $assign->sync($user, [$role->value], $user); + + $this->info('Konto angelegt. Passwort (nur diese Ausgabe):'); + $this->line($password); + + return self::SUCCESS; + } +} diff --git a/app/Console/Commands/RevertPublishedPages.php b/app/Console/Commands/RevertPublishedPages.php new file mode 100644 index 0000000..82f9797 --- /dev/null +++ b/app/Console/Commands/RevertPublishedPages.php @@ -0,0 +1,87 @@ +option('before')) ? null : CarbonImmutable::parse((string) $this->option('before')); + } catch (Throwable) { + $before = null; + } + + if ($before === null) { + $this->error('Bitte --before mit einem gültigen Zeitpunkt angeben.'); + + return self::FAILURE; + } + + $apply = (bool) $this->option('apply'); + $rows = []; + + foreach (Page::query()->whereNotNull('published_revision_id')->with('publishedRevision')->orderBy('path')->get() as $page) { + $current = $page->publishedRevision; + + if ($current === null || $current->created_at < $before) { + continue; + } + + $previous = PageRevision::query() + ->where('page_id', $page->id) + ->where('created_at', '<', $before) + ->latest('id') + ->first(); + + if ($previous === null) { + $rows[] = [$page->path, $current->id, '–', 'keine ältere Revision: Seite wird zurückgezogen']; + if ($apply) { + $page->published_revision_id = null; + $page->save(); + } + + continue; + } + + $rows[] = [$page->path, $current->id, $previous->id, $apply ? 'zurückgesetzt' : 'würde zurückgesetzt']; + if ($apply) { + $page->published_revision_id = $previous->id; + $page->save(); + } + } + + if ($rows === []) { + $this->info('Keine veröffentlichte Seite stammt aus der Zeit ab '.$before->format('d.m.Y H:i').'.'); + + return self::SUCCESS; + } + + $this->table(['Pfad', 'veröffentlicht', 'neu veröffentlicht', 'Ergebnis'], $rows); + + if (! $apply) { + $this->warn('Probelauf. Mit --apply ausführen.'); + } + + return self::SUCCESS; + } +} diff --git a/app/Console/Commands/SeedLibraryReview.php b/app/Console/Commands/SeedLibraryReview.php new file mode 100644 index 0000000..93408f0 --- /dev/null +++ b/app/Console/Commands/SeedLibraryReview.php @@ -0,0 +1,139 @@ +where('designation', 'Prüfprogramm Abstand')->first(); + + if ($existing === null) { + $created = $this->createFixture($content, $articles, $offers, $display); + + if ($created !== self::SUCCESS) { + return $created; + } + } else { + $existing->display_title = 'Prüfprogramm Abstand und ein bewusst langer Titel für die Kursraumansicht'; + $existing->summary = 'Gekennzeichneter Prüfbestand für die Testinstanz. Der Titel ist lang, damit die Karte im Kursraum prüfbar bleibt.'; + $existing->save(); + } + + $this->ensureTrainer(); + $this->info('Prüfbestand und Trainingskonto sind bereit.'); + + return self::SUCCESS; + } + + private function createFixture( + ContentService $content, + ArticleService $articles, + OfferService $offers, + CompositionDisplayRelease $display, + ): int { + + $actor = User::query()->find($this->option('actor')) ?? User::query()->orderBy('id')->first(); + + if ($actor === null) { + $this->error('Es gibt kein Konto, das die Anzeigefreigabe zeichnen kann.'); + + return self::FAILURE; + } + + $kind = EditorialContentKind::query()->where('slug', 'programm')->first(); + + if ($kind === null) { + $this->error('Die fachliche Materialart Programm fehlt.'); + + return self::FAILURE; + } + + $sheet = $content->publishElementVersion( + $content->createElement('text', 'document', 'Prüfblatt Abstand'), + 'Gekennzeichneter Prüftext. Kein Veröffentlichungstext.', + ); + $composition = $content->createComposition('Prüfprogramm Abstand'); + $composition->editorial_content_kind_id = $kind->id; + $composition->display_title = 'Prüfprogramm Abstand und ein bewusst langer Titel für die Kursraumansicht'; + $composition->summary = 'Gekennzeichneter Prüfbestand für die Testinstanz. Der Titel ist lang, damit die Karte im Kursraum prüfbar bleibt.'; + $composition->thumbnail_error = 'Prüfhinweis: kein Vorschaubild.'; + $composition->save(); + $version = $content->publishComposition($composition, [ + ['role' => 'Blatt', 'target' => $sheet], + ], $actor, 'Prüfbestand', [ + 'learning_goal' => 'Den Prüfaufbau in der Bibliothek sehen.', + 'duration_minutes' => 5, + 'material_note' => 'Nur der Prüftext.', + ]); + $article = $articles->create('pruef-abstand'); + $articles->publishRelease($article, $version, 'Prüffassung.'); + $rights = $offers->createRightsProfile('Prüfblatt ansehen', 'ehrenamtlich', [ + 'document' => ['ansehen', 'laden'], + ]); + $offer = $offers->create('Prüfprogramm Abstand'); + $offers->activate($offer, [ + ['target' => $article->fresh(), 'rights' => $rights], + ], ['grant_kind' => 'auf_abruf', 'composition_version_id' => $version->id]); + $display->release($version, $actor, 'Prüffreigabe'); + + return self::SUCCESS; + } + + private function ensureTrainer(): void + { + $trainer = User::query()->where('email', 'trainer-pruefung@example.test')->first(); + + if ($trainer === null) { + $party = Party::query()->create([ + 'type' => PartyType::Person, + 'display_name' => 'Trainer Prüfung', + ]); + Profile::query()->create([ + 'party_id' => $party->id, + 'display_name' => 'Trainer Prüfung', + 'visibility' => ['display_name' => 'private'], + ]); + $trainer = new User; + $trainer->forceFill([ + 'party_id' => $party->id, + 'name' => 'Trainer Prüfung', + 'email' => 'trainer-pruefung@example.test', + 'password' => 'Kursraum-Pruefung', + 'status' => AccountStatus::Aktiv, + 'confirmed_adult_at' => now(), + 'email_verified_at' => now(), + ]); + $trainer->save(); + } + + $offer = Offer::query()->where('name', 'Prüfprogramm Abstand')->first(); + + if ($offer !== null) { + app(GrantIssuer::class)->claim($trainer, $offer); + } + } +} diff --git a/app/Domain/Catalog/ArticleRelease.php b/app/Domain/Catalog/ArticleRelease.php new file mode 100644 index 0000000..e2b54dd --- /dev/null +++ b/app/Domain/Catalog/ArticleRelease.php @@ -0,0 +1,96 @@ + 'boolean', + 'status' => ReleaseStatus::class, + 'impact_report' => 'array', + ]; + } + + protected static function booted(): void + { + static::updating(function (ArticleRelease $release): void { + $original = StatusValue::of($release->getOriginal('status')); + $next = StatusValue::of($release->status); + $locked = [ + ReleaseStatus::Veroeffentlicht->value, + ReleaseStatus::AbgeloestVerfuegbar->value, + ReleaseStatus::Gesperrt->value, + ]; + + if (! in_array($original, $locked, true)) { + return; + } + + $allowedFields = ['status', 'updated_at']; + + if ($original === ReleaseStatus::Veroeffentlicht->value && $next === ReleaseStatus::Gesperrt->value) { + $allowedFields = ['status', 'updated_at', 'block_reason', 'fallback_release_id']; + } + + if (array_diff(array_keys($release->getDirty()), $allowedFields) !== []) { + throw new DomainRuleException('Ein veröffentlichter Artikel-Stand ist unveränderlich.'); + } + + $allowed = match ($original) { + ReleaseStatus::Veroeffentlicht->value => [ + ReleaseStatus::AbgeloestVerfuegbar->value, + ReleaseStatus::Gesperrt->value, + ], + ReleaseStatus::AbgeloestVerfuegbar->value => [ + ReleaseStatus::Veroeffentlicht->value, + ], + default => [], + }; + + if (! in_array($next, $allowed, true)) { + throw new DomainRuleException('Dieser Statuswechsel eines Artikel-Stands ist nicht zulässig.'); + } + }); + } + + public function article(): BelongsTo + { + return $this->belongsTo(LicenseArticle::class, 'license_article_id'); + } + + public function contents(): HasMany + { + return $this->hasMany(ReleaseContent::class)->orderBy('position'); + } + + public function rootElementVersion(): BelongsTo + { + return $this->belongsTo(ContentElementVersion::class, 'root_element_version_id'); + } + + public function rootCompositionVersion(): BelongsTo + { + return $this->belongsTo(CompositionVersion::class, 'root_composition_version_id'); + } +} diff --git a/app/Domain/Catalog/ArticleService.php b/app/Domain/Catalog/ArticleService.php new file mode 100644 index 0000000..4232704 --- /dev/null +++ b/app/Domain/Catalog/ArticleService.php @@ -0,0 +1,191 @@ +create([ + 'code' => $code, + 'product_line' => $productLine !== null && trim($productLine) !== '' ? trim($productLine) : null, + ]); + } + + public function publishRelease( + LicenseArticle $article, + ContentElementVersion|CompositionVersion $root, + string $classification, + ?string $changeNote = null, + ): ArticleRelease { + $classification = trim($classification); + + if ($classification === '') { + throw new DomainRuleException('Ein neuer Stand braucht eine Einordnung, warum er zum selben Artikel gehört.'); + } + + $this->checkedRows($root); + + return DB::transaction(function () use ($article, $root, $classification, $changeNote): ArticleRelease { + $rows = $this->checkedRows($root); + $impact = $this->impact($article, count($rows)); + $release = $article->releases()->create([ + 'number' => ((int) $article->releases()->max('number')) + 1, + 'classification_note' => $classification, + 'status' => ReleaseStatus::Entwurf, + 'change_note' => $changeNote, + 'impact_report' => $impact, + 'root_element_version_id' => $root instanceof ContentElementVersion ? $root->id : null, + 'root_composition_version_id' => $root instanceof CompositionVersion ? $root->id : null, + ]); + + foreach ($rows as $index => $row) { + $release->contents()->create([ + 'position' => $index + 1, + 'content_element_version_id' => $row['version_id'], + 'role' => $row['role'] !== '' ? $row['role'] : $row['path'], + 'path' => $row['path'], + ]); + } + + ArticleRelease::query() + ->where('license_article_id', $article->id) + ->where('status', ReleaseStatus::Veroeffentlicht) + ->whereKeyNot($release->id) + ->each(function (ArticleRelease $previous): void { + $previous->status = ReleaseStatus::AbgeloestVerfuegbar; + $previous->save(); + }); + + $release->status = ReleaseStatus::Veroeffentlicht; + $release->save(); + $article->current_release_id = $release->id; + $article->save(); + + return $release->load('contents'); + }); + } + + /** + * @return array{fallback_number: int|null, holders: list} + */ + public function withdraw(LicenseArticle $article, string $reason): array + { + $reason = trim($reason); + + if ($reason === '') { + throw new DomainRuleException('Ein Rückzug braucht eine Begründung.'); + } + + return DB::transaction(function () use ($article, $reason): array { + $article->refresh(); + $current = $article->currentRelease; + + if ($current === null || $current->status !== ReleaseStatus::Veroeffentlicht) { + throw new DomainRuleException('Zurückziehen lässt sich nur der aktuell veröffentlichte Stand.'); + } + + $fallback = ArticleRelease::query() + ->where('license_article_id', $article->id) + ->where('status', ReleaseStatus::AbgeloestVerfuegbar) + ->orderByDesc('number') + ->first(); + + $current->status = ReleaseStatus::Gesperrt; + $current->block_reason = $reason; + $current->fallback_release_id = $fallback?->id; + $current->save(); + + if ($fallback instanceof ArticleRelease) { + $fallback->status = ReleaseStatus::Veroeffentlicht; + $fallback->save(); + $article->current_release_id = $fallback->id; + } else { + $article->current_release_id = null; + } + + $article->save(); + + return [ + 'fallback_number' => $fallback?->number, + 'holders' => Acquisition::query() + ->whereHas('grants', fn ($query) => $query + ->where('license_article_id', $article->id) + ->where('status', GrantStatus::Aktiv)) + ->with('party') + ->get() + ->map(fn (Acquisition $acquisition): string => $acquisition->party->display_name) + ->unique() + ->values() + ->all(), + ]; + }); + } + + /** + * @return list + */ + private function checkedRows(ContentElementVersion|CompositionVersion $root): array + { + $root->refresh(); + + if ($root->status !== ContentVersionStatus::Bereit) { + throw new DomainRuleException('Ein Artikel-Stand kann nur eine bereitgestellte Fassung festschreiben.'); + } + + $rows = $this->resolver->expand($root); + + if ($rows === []) { + throw new DomainRuleException('Ein Artikel-Stand braucht mindestens eine Inhaltsfassung.'); + } + + $blocked = ContentElementVersion::query() + ->whereIn('id', array_column($rows, 'version_id')) + ->where('status', '!=', ContentVersionStatus::Bereit->value) + ->exists(); + + if ($blocked) { + throw new DomainRuleException('Eine gesperrte Inhaltsfassung kann nicht veröffentlicht werden.'); + } + + return $rows; + } + + /** + * @return array{holders: int, offers: list, contents: int, replaces_number: int|null} + */ + private function impact(LicenseArticle $article, int $contents): array + { + $article->loadMissing('currentRelease'); + + return [ + 'holders' => Acquisition::query() + ->whereHas('grants', fn ($query) => $query + ->where('license_article_id', $article->id) + ->where('status', GrantStatus::Aktiv)) + ->distinct() + ->count('party_id'), + 'offers' => Offer::query() + ->whereHas('versions', fn ($query) => $query + ->where('status', OfferStatus::Aktiv) + ->whereHas('resolvedScopes', fn ($scope) => $scope->where('license_article_id', $article->id))) + ->orderBy('name') + ->pluck('name') + ->all(), + 'contents' => $contents, + 'replaces_number' => $article->currentRelease?->number, + ]; + } +} diff --git a/app/Domain/Catalog/Bundle.php b/app/Domain/Catalog/Bundle.php new file mode 100644 index 0000000..ba61e91 --- /dev/null +++ b/app/Domain/Catalog/Bundle.php @@ -0,0 +1,26 @@ + 'datetime', + ]; + } + + public function versions(): HasMany + { + return $this->hasMany(BundleVersion::class); + } +} diff --git a/app/Domain/Catalog/BundleItem.php b/app/Domain/Catalog/BundleItem.php new file mode 100644 index 0000000..c6e6b63 --- /dev/null +++ b/app/Domain/Catalog/BundleItem.php @@ -0,0 +1,46 @@ +whereKey($item->bundle_version_id)->value('status'); + + if (StatusValue::of($status) === BundleStatus::Veroeffentlicht->value) { + throw new DomainRuleException('Eine veröffentlichte Paketfassung nimmt keine weiteren Bestandteile auf.'); + } + }); + + static::updating(function (): void { + throw new DomainRuleException('Bestandteile einer Paketfassung sind unveränderlich.'); + }); + } + + public function bundleVersion(): BelongsTo + { + return $this->belongsTo(BundleVersion::class); + } + + public function article(): BelongsTo + { + return $this->belongsTo(LicenseArticle::class, 'license_article_id'); + } + + public function nestedBundle(): BelongsTo + { + return $this->belongsTo(Bundle::class, 'nested_bundle_id'); + } +} diff --git a/app/Domain/Catalog/BundleService.php b/app/Domain/Catalog/BundleService.php new file mode 100644 index 0000000..4289f7a --- /dev/null +++ b/app/Domain/Catalog/BundleService.php @@ -0,0 +1,137 @@ +create([ + 'name' => $name, + ]); + } + + /** + * @param list $items + */ + public function publish(Bundle $bundle, array $items): BundleVersion + { + if ($items === []) { + throw new DomainRuleException('Ein Paket braucht mindestens einen Bestandteil.'); + } + + $this->assertItems($items); + $this->collectArticleIds($bundle->id, $items); + + return DB::transaction(function () use ($bundle, $items): BundleVersion { + $version = $bundle->versions()->create([ + 'number' => ((int) $bundle->versions()->max('number')) + 1, + 'status' => BundleStatus::Entwurf, + ]); + + foreach (array_values($items) as $index => $item) { + $version->items()->create([ + 'position' => $index + 1, + 'license_article_id' => $item instanceof LicenseArticle ? $item->id : null, + 'nested_bundle_id' => $item instanceof Bundle ? $item->id : null, + ]); + } + + $version->status = BundleStatus::Veroeffentlicht; + $version->save(); + + return $version->load('items'); + }); + } + + /** + * @return list + */ + public function articleIds(BundleVersion $version): array + { + return $this->collectArticleIds($version->bundle_id, $this->targetsOf($version)); + } + + /** + * @param list $items + */ + private function assertItems(array $items): void + { + foreach ($items as $item) { + if (! $item instanceof LicenseArticle && ! $item instanceof Bundle) { + throw new DomainRuleException('Ein Paket enthält nur Lizenzartikel oder andere Pakete.'); + } + } + } + + /** + * @param list $items + * @param list $stack + * @return list + */ + private function collectArticleIds(int $bundleId, array $items, array $stack = []): array + { + if (in_array($bundleId, $stack, true)) { + throw new DomainRuleException('Pakete dürfen keinen Zyklus bilden.'); + } + + $stack[] = $bundleId; + $articleIds = []; + + foreach ($items as $item) { + if ($item instanceof LicenseArticle) { + $articleIds[$item->id] = $item->id; + + continue; + } + + $published = $this->publishedVersion($item); + + if ($published === null) { + throw new DomainRuleException('Ein eingebettetes Paket braucht eine veröffentlichte Fassung.'); + } + + foreach ($this->collectArticleIds($item->id, $this->targetsOf($published), $stack) as $articleId) { + $articleIds[$articleId] = $articleId; + } + } + + return array_values($articleIds); + } + + private function publishedVersion(Bundle $bundle): ?BundleVersion + { + return $bundle->versions() + ->where('status', BundleStatus::Veroeffentlicht) + ->orderByDesc('number') + ->first(); + } + + /** + * @return list + */ + private function targetsOf(BundleVersion $version): array + { + $targets = []; + + foreach ($version->items()->orderBy('position')->get() as $item) { + $target = $item->article ?? $item->nestedBundle; + + if ($target === null) { + throw new DomainRuleException('Ein Paketbestandteil braucht genau ein Ziel.'); + } + + $targets[] = $target; + } + + return $targets; + } +} diff --git a/app/Domain/Catalog/BundleStatus.php b/app/Domain/Catalog/BundleStatus.php new file mode 100644 index 0000000..670004c --- /dev/null +++ b/app/Domain/Catalog/BundleStatus.php @@ -0,0 +1,9 @@ + BundleStatus::class, + ]; + } + + protected static function booted(): void + { + static::updating(function (BundleVersion $version): void { + if (StatusValue::of($version->getOriginal('status')) === BundleStatus::Veroeffentlicht->value) { + throw new DomainRuleException('Eine veröffentlichte Paketfassung ist unveränderlich.'); + } + }); + } + + public function bundle(): BelongsTo + { + return $this->belongsTo(Bundle::class); + } + + public function items(): HasMany + { + return $this->hasMany(BundleItem::class)->orderBy('position'); + } +} diff --git a/app/Domain/Catalog/CompatibilityAttestation.php b/app/Domain/Catalog/CompatibilityAttestation.php new file mode 100644 index 0000000..ebdb261 --- /dev/null +++ b/app/Domain/Catalog/CompatibilityAttestation.php @@ -0,0 +1,37 @@ + 'datetime', + ]; + } + + public function compositionVersion(): BelongsTo + { + return $this->belongsTo(CompositionVersion::class); + } + + public function confirmer(): BelongsTo + { + return $this->belongsTo(User::class, 'confirmed_by'); + } +} diff --git a/app/Domain/Catalog/Composition.php b/app/Domain/Catalog/Composition.php new file mode 100644 index 0000000..f5e881a --- /dev/null +++ b/app/Domain/Catalog/Composition.php @@ -0,0 +1,47 @@ + CompositionKind::class, + 'archived_at' => 'datetime', + 'working_draft' => 'array', + ]; + } + + public function editorialContentKind(): BelongsTo + { + return $this->belongsTo(EditorialContentKind::class); + } + + public function versions(): HasMany + { + return $this->hasMany(CompositionVersion::class); + } +} diff --git a/app/Domain/Catalog/CompositionDisplayRelease.php b/app/Domain/Catalog/CompositionDisplayRelease.php new file mode 100644 index 0000000..0993435 --- /dev/null +++ b/app/Domain/Catalog/CompositionDisplayRelease.php @@ -0,0 +1,67 @@ +latestEvent($version)?->event === CompositionVersionDisplayEvent::RELEASED; + } + + public function highestReleasedVersion(Composition $composition): ?CompositionVersion + { + return $composition->versions() + ->where('status', ContentVersionStatus::Bereit) + ->orderByDesc('number') + ->get() + ->first(fn (CompositionVersion $version): bool => $this->isReleased($version)); + } + + public function release(CompositionVersion $version, User $actor, ?string $note = null): CompositionVersionDisplayEvent + { + $this->assertBereit($version); + + return DB::transaction(function () use ($version, $actor, $note): CompositionVersionDisplayEvent { + return $version->displayEvents()->create([ + 'event' => CompositionVersionDisplayEvent::RELEASED, + 'actor_id' => $actor->id, + 'occurred_at' => now(), + 'note' => $note !== null && trim($note) !== '' ? trim($note) : null, + ]); + }); + } + + public function revoke(CompositionVersion $version, User $actor, ?string $note = null): CompositionVersionDisplayEvent + { + $this->assertBereit($version); + + if (! $this->isReleased($version)) { + throw new DomainRuleException('Diese Fassung ist nicht zur Anzeige freigegeben.'); + } + + return DB::transaction(function () use ($version, $actor, $note): CompositionVersionDisplayEvent { + return $version->displayEvents()->create([ + 'event' => CompositionVersionDisplayEvent::REVOKED, + 'actor_id' => $actor->id, + 'occurred_at' => now(), + 'note' => $note !== null && trim($note) !== '' ? trim($note) : null, + ]); + }); + } + + public function latestEvent(CompositionVersion $version): ?CompositionVersionDisplayEvent + { + return $version->displayEvents()->reorder()->orderByDesc('occurred_at')->orderByDesc('id')->first(); + } + + private function assertBereit(CompositionVersion $version): void + { + if ($version->status !== ContentVersionStatus::Bereit) { + throw new DomainRuleException('Nur eine bereitgestellte Kompositionsfassung kann freigegeben werden.'); + } + } +} diff --git a/app/Domain/Catalog/CompositionKind.php b/app/Domain/Catalog/CompositionKind.php new file mode 100644 index 0000000..b84b275 --- /dev/null +++ b/app/Domain/Catalog/CompositionKind.php @@ -0,0 +1,92 @@ + 'Fachliche Kombination', + self::Uebung => 'Übung', + self::Kurs => 'Kurs', + }; + } + + public function plural(): string + { + return match ($this) { + self::Kombination => 'Fachliche Kombinationen', + self::Uebung => 'Übungen', + self::Kurs => 'Kurse', + }; + } + + public function createLabel(): string + { + return match ($this) { + self::Kombination => 'Kombination anlegen', + self::Uebung => 'Übung anlegen', + self::Kurs => 'Kurs anlegen', + }; + } + + public function explanation(): string + { + return match ($this) { + self::Kombination => 'Didaktische oder thematische Zusammenstellung, zum Beispiel ein Materialsatz. Sie wird in Übungen und Kursen wiederverwendet und ist selbst kein Kurs.', + self::Uebung => 'Eine konkrete Lernsituation, zum Beispiel aus Film und Merkblatt. Dieselben Medien können in mehreren Übungen stecken.', + self::Kurs => 'Ein Ablauf für den Kursbetrieb aus Übungen, Kombinationen und Medien. Ein Kurs ist keine Übung.', + }; + } + + public function deskLabel(): string + { + return match ($this) { + self::Kombination => 'Fachliche Kombination', + self::Uebung => 'Modul', + self::Kurs => 'Programm', + }; + } + + public function deskExplanation(): string + { + return match ($this) { + self::Kombination => $this->explanation(), + self::Uebung => 'Ein Modul mit Lernziel, Zeit, Material und geordneten Bestandteilen. Dieselben Medien können in mehreren Modulen stecken.', + self::Kurs => 'Ein Programm aus Modulen und weiteren Inhalten.', + }; + } + + /** + * @return array + */ + public static function deskOptions(): array + { + $options = []; + + foreach (self::cases() as $case) { + $options[$case->value] = $case->deskLabel(); + } + + return $options; + } + + /** + * @return array + */ + public static function options(): array + { + $options = []; + + foreach (self::cases() as $case) { + $options[$case->value] = $case->label(); + } + + return $options; + } +} diff --git a/app/Domain/Catalog/CompositionMember.php b/app/Domain/Catalog/CompositionMember.php new file mode 100644 index 0000000..2555b61 --- /dev/null +++ b/app/Domain/Catalog/CompositionMember.php @@ -0,0 +1,48 @@ +whereKey($member->composition_version_id)->value('status'); + + if (StatusValue::of($status) === ContentVersionStatus::Bereit->value) { + throw new DomainRuleException('Eine bestätigte Kompositionsfassung nimmt keine weiteren Mitglieder auf.'); + } + }); + + static::updating(function (): void { + throw new DomainRuleException('Mitglieder einer Komposition werden nicht verändert, sondern durch eine neue Fassung ersetzt.'); + }); + } + + public function compositionVersion(): BelongsTo + { + return $this->belongsTo(CompositionVersion::class); + } + + public function contentElementVersion(): BelongsTo + { + return $this->belongsTo(ContentElementVersion::class); + } + + public function nestedCompositionVersion(): BelongsTo + { + return $this->belongsTo(CompositionVersion::class, 'nested_composition_version_id'); + } +} diff --git a/app/Domain/Catalog/CompositionRelease.php b/app/Domain/Catalog/CompositionRelease.php new file mode 100644 index 0000000..d44b2b6 --- /dev/null +++ b/app/Domain/Catalog/CompositionRelease.php @@ -0,0 +1,478 @@ + */ + private array $publishedDrafts = []; + + /** + * @param list> $members + * @return array{ + * host_label: string, + * title: string, + * next_label: string, + * ready: list, + * pending: list, + * blocked: list, + * needs_consent: bool, + * nested_draft: bool + * } + */ + public function review(Composition $host, array $members): array + { + $ready = []; + $pending = []; + $blocked = []; + $nestedDraft = false; + $this->inspectMembers($members, 0, [$host->id], false, $ready, $pending, $blocked, $nestedDraft); + + return [ + 'host_label' => $this->label($host), + 'title' => $this->title($host), + 'next_label' => 'Fassung '.(((int) $host->versions()->max('number')) + 1), + 'ready' => $ready, + 'pending' => $pending, + 'blocked' => $blocked, + 'needs_consent' => $pending !== [], + 'nested_draft' => $nestedDraft, + ]; + } + + /** + * @param list> $members + * @param array{learning_goal?: mixed, duration_minutes?: mixed, material_note?: mixed} $didactic + */ + public function publish( + Composition $host, + array $members, + ?User $actor, + ?string $note, + array $didactic, + bool $consent, + ): CompositionVersion { + $review = $this->review($host, $members); + + if ($review['blocked'] !== []) { + throw new DomainRuleException($review['blocked'][0]['detail']); + } + + if ($review['needs_consent'] && ! $consent) { + throw new DomainRuleException('Noch nicht freigegebene Bestandteile werden nur mit ausdrücklicher Zustimmung freigegeben.'); + } + + $this->publishedDrafts = []; + + return DB::transaction(function () use ($host, $members, $actor, $note, $didactic): CompositionVersion { + return $this->materialize($host, $members, $didactic, $actor, $note, []); + }); + } + + /** + * @param list> $members + * @param list $stack + * @param list $ready + * @param list $pending + * @param list $blocked + */ + private function inspectMembers( + array $members, + int $depth, + array $stack, + bool $frozen, + array &$ready, + array &$pending, + array &$blocked, + bool &$nestedDraft, + ): void { + foreach ($members as $member) { + if (! is_array($member)) { + continue; + } + + $role = trim((string) ($member['role'] ?? '')); + $target = (string) ($member['target'] ?? ''); + + if ($role === '' || $target === '') { + $blocked[] = $this->block('Bestandteil', 'Jeder Bestandteil braucht eine Rolle und eine vorhandene Fassung.', $depth, null); + + continue; + } + + $this->inspectTarget($target, $role, $depth, $stack, $frozen, $ready, $pending, $blocked, $nestedDraft); + } + } + + /** + * @param list $stack + * @param list $ready + * @param list $pending + * @param list $blocked + */ + private function inspectTarget( + string $target, + string $role, + int $depth, + array $stack, + bool $frozen, + array &$ready, + array &$pending, + array &$blocked, + bool &$nestedDraft, + ): void { + if (preg_match('/^element:(\d+)$/', $target, $match) === 1) { + $this->inspectElement((int) $match[1], $role, $depth, $frozen, $ready, $pending, $blocked); + + return; + } + + if (preg_match('/^composition:(\d+)$/', $target, $match) === 1) { + $this->inspectReleasedComposition((int) $match[1], $role, $depth, $stack, $ready, $pending, $blocked, $nestedDraft); + + return; + } + + if (preg_match('/^composition-draft:(\d+)$/', $target, $match) === 1) { + $this->inspectDraftComposition((int) $match[1], $role, $depth, $stack, $frozen, $ready, $pending, $blocked, $nestedDraft); + + return; + } + + $blocked[] = $this->block('Bestandteil', 'Ein Bestandteil ist nicht mehr vorhanden.', $depth, null); + } + + /** + * @param list $ready + * @param list $pending + * @param list $blocked + */ + private function inspectElement( + int $id, + string $role, + int $depth, + bool $frozen, + array &$ready, + array &$pending, + array &$blocked, + ): void { + $version = ContentElementVersion::query()->with('element')->find($id); + $title = $version?->element === null + ? 'Medium' + : (filled($version->element->display_title) ? $version->element->display_title : $version->element->working_title); + $edit = $version?->element === null ? null : ['type' => 'element', 'id' => $version->element->id]; + + if (! $version instanceof ContentElementVersion || $version->element === null) { + $blocked[] = $this->block($title, 'Ein Medium ist nicht mehr vorhanden.', $depth, null); + + return; + } + + $kind = $this->outputLabel((string) $version->element->output_class); + + if ($version->status === ContentVersionStatus::Bereit) { + $ready[] = $this->line($title, $this->kindAndRole($kind, $role).' · Fassung '.$version->number.', bleibt unverändert', $depth); + + return; + } + + if ($version->status === ContentVersionStatus::Gesperrt) { + $blocked[] = $this->block($title, $this->kindAndRole($kind, $role).'. Diese Fassung ist deaktiviert und kann nicht freigegeben werden.', $depth, $edit); + + return; + } + + $problem = app(ContentService::class)->elementReleaseProblem($version); + + if ($frozen) { + $blocked[] = $this->block($title, $this->kindAndRole($kind, $role).'. Eine bereits freigegebene Fassung verweist auf diesen Entwurf. Sie bleibt unverändert.', $depth, $edit); + + return; + } + + if ($problem !== null) { + $blocked[] = $this->block($title, $this->kindAndRole($kind, $role).'. '.$problem, $depth, $edit); + + return; + } + + $pending[] = $this->line($title, $this->kindAndRole($kind, $role).'. Der Entwurf wird freigegeben. Es entsteht keine weitere Fassung.', $depth); + } + + /** + * @param list $stack + * @param list $ready + * @param list $pending + * @param list $blocked + */ + private function inspectReleasedComposition( + int $id, + string $role, + int $depth, + array $stack, + array &$ready, + array &$pending, + array &$blocked, + bool &$nestedDraft, + ): void { + $version = CompositionVersion::query()->with('composition', 'members')->find($id); + + if (! $version instanceof CompositionVersion || $version->composition === null) { + $blocked[] = $this->block('Modul', 'Ein Bestandteil ist nicht mehr vorhanden.', $depth, null); + + return; + } + + $title = $this->title($version->composition); + $kind = $this->label($version->composition); + + if (in_array($version->composition_id, $stack, true)) { + $blocked[] = $this->block($title, $this->kindAndRole($kind, $role).'. Der Aufbau verweist auf sich selbst. So kann nichts freigegeben werden.', $depth, ['type' => 'composition', 'id' => $version->composition_id]); + + return; + } + + if ($version->status !== ContentVersionStatus::Bereit) { + $blocked[] = $this->block($title, $this->kindAndRole($kind, $role).'. Diese Fassung ist nicht freigegeben.', $depth, ['type' => 'composition', 'id' => $version->composition_id]); + + return; + } + + $ready[] = $this->line($title, $this->kindAndRole($kind, $role).' · Fassung '.$version->number.', bleibt unverändert', $depth); + $nested = []; + + foreach ($version->members()->orderBy('position')->get() as $member) { + $target = $member->content_element_version_id + ? 'element:'.$member->content_element_version_id + : 'composition:'.$member->nested_composition_version_id; + $nested[] = ['role' => (string) $member->role, 'target' => $target, 'note' => (string) ($member->placement_note ?? '')]; + } + + $this->inspectMembers($nested, $depth + 1, [...$stack, $version->composition_id], true, $ready, $pending, $blocked, $nestedDraft); + } + + /** + * @param list $stack + * @param list $ready + * @param list $pending + * @param list $blocked + */ + private function inspectDraftComposition( + int $id, + string $role, + int $depth, + array $stack, + bool $frozen, + array &$ready, + array &$pending, + array &$blocked, + bool &$nestedDraft, + ): void { + $composition = Composition::query()->find($id); + $edit = ['type' => 'composition', 'id' => $id]; + + if (! $composition instanceof Composition) { + $blocked[] = $this->block('Modul', 'Ein Modul ist nicht mehr vorhanden.', $depth, null); + + return; + } + + $title = $this->title($composition); + $kind = $this->label($composition); + + if ($frozen || in_array($id, $stack, true)) { + $blocked[] = $this->block($title, $this->kindAndRole($kind, $role).'. Der Aufbau verweist auf sich selbst. So kann nichts freigegeben werden.', $depth, $edit); + + return; + } + + $draft = is_array($composition->working_draft) ? $composition->working_draft : []; + $members = is_array($draft['members'] ?? null) ? $draft['members'] : []; + + if ($members === []) { + $blocked[] = $this->block($title, $this->kindAndRole($kind, $role).'. Der gespeicherte Entwurf hat keinen Bestandteil.', $depth, $edit); + + return; + } + + $minutes = $draft['duration_minutes'] ?? null; + + if ($minutes !== null && $minutes !== '' && ! is_int($minutes)) { + $blocked[] = $this->block($title, $this->kindAndRole($kind, $role).'. Der Zeitbedarf ist keine Zahl von Minuten.', $depth, $edit); + + return; + } + + $nestedDraft = true; + $number = ((int) $composition->versions()->max('number')) + 1; + $pending[] = $this->line($title, $this->kindAndRole($kind, $role).'. Es entsteht Fassung '.$number.'.', $depth); + $this->inspectMembers($members, $depth + 1, [...$stack, $id], false, $ready, $pending, $blocked, $nestedDraft); + } + + /** + * @param list> $members + * @param array{learning_goal?: mixed, duration_minutes?: mixed, material_note?: mixed} $didactic + * @param list $stack + */ + private function materialize( + Composition $composition, + array $members, + array $didactic, + ?User $actor, + ?string $note, + array $stack, + ): CompositionVersion { + if (isset($this->publishedDrafts[$composition->id])) { + return $this->publishedDrafts[$composition->id]; + } + + if (in_array($composition->id, $stack, true)) { + throw new DomainRuleException('Der Aufbau verweist auf sich selbst. So kann nichts freigegeben werden.'); + } + + $stack[] = $composition->id; + $payload = []; + + foreach (array_values($members) as $member) { + $payload[] = [ + 'role' => trim((string) ($member['role'] ?? '')), + 'note' => trim((string) ($member['note'] ?? '')), + 'target' => $this->resolveTarget((string) ($member['target'] ?? ''), $actor, $stack), + ]; + } + + $version = app(ContentService::class)->publishComposition( + $composition, + $payload, + $actor, + $note, + [ + 'learning_goal' => $didactic['learning_goal'] ?? null, + 'duration_minutes' => $didactic['duration_minutes'] ?? null, + 'material_note' => $didactic['material_note'] ?? null, + ], + ); + $this->publishedDrafts[$composition->id] = $version; + + return $version; + } + + /** + * @param list $stack + */ + private function resolveTarget(string $target, ?User $actor, array $stack): ContentElementVersion|CompositionVersion + { + if (preg_match('/^element:(\d+)$/', $target, $match) === 1) { + $version = ContentElementVersion::query()->find($match[1]); + + if (! $version instanceof ContentElementVersion) { + throw new DomainRuleException('Ein Medium ist nicht mehr vorhanden.'); + } + + if ($version->status === ContentVersionStatus::Entwurf) { + $version = app(ContentService::class)->releaseElementVersion($version); + } + + if ($version->status !== ContentVersionStatus::Bereit) { + throw new DomainRuleException('Eine deaktivierte Fassung lässt sich nicht freigeben.'); + } + + return $version; + } + + if (preg_match('/^composition:(\d+)$/', $target, $match) === 1) { + $version = CompositionVersion::query()->find($match[1]); + + if (! $version instanceof CompositionVersion || $version->status !== ContentVersionStatus::Bereit) { + throw new DomainRuleException('Eine bereits erwartete Fassung ist nicht mehr freigegeben.'); + } + + return $version; + } + + if (preg_match('/^composition-draft:(\d+)$/', $target, $match) !== 1) { + throw new DomainRuleException('Ein Bestandteil ist nicht mehr vorhanden.'); + } + + $composition = Composition::query()->find($match[1]); + + if (! $composition instanceof Composition) { + throw new DomainRuleException('Ein Modul ist nicht mehr vorhanden.'); + } + + if (isset($this->publishedDrafts[$composition->id])) { + return $this->publishedDrafts[$composition->id]; + } + + $draft = is_array($composition->working_draft) ? $composition->working_draft : []; + $version = $this->materialize( + $composition, + is_array($draft['members'] ?? null) ? $draft['members'] : [], + [ + 'learning_goal' => $draft['learning_goal'] ?? null, + 'duration_minutes' => $draft['duration_minutes'] ?? null, + 'material_note' => $draft['material_note'] ?? null, + ], + $actor, + is_string($draft['revision_note'] ?? null) ? $draft['revision_note'] : null, + $stack, + ); + app(EditorialWorkingDraft::class)->clear($composition); + + return $version; + } + + /** + * @return array{title: string, detail: string, depth: int} + */ + private function line(string $title, string $detail, int $depth): array + { + return ['title' => $title, 'detail' => $detail, 'depth' => $depth]; + } + + /** + * @param array{type: string, id: int}|null $edit + * @return array{title: string, detail: string, depth: int, edit: array{type: string, id: int}|null} + */ + private function block(string $title, string $detail, int $depth, ?array $edit): array + { + return ['title' => $title, 'detail' => $detail, 'depth' => $depth, 'edit' => $edit]; + } + + private function kindAndRole(string $kind, string $role): string + { + $role = trim($role); + + if ($role === '' || mb_strtolower($role) === mb_strtolower($kind)) { + return $kind; + } + + return $kind.' · '.$role; + } + + private function title(Composition $composition): string + { + return filled($composition->display_title) ? (string) $composition->display_title : (string) $composition->designation; + } + + private function outputLabel(string $outputClass): string + { + return match ($outputClass) { + 'film' => 'Film', + 'audio' => 'Hörstück', + 'bild' => 'Bild', + 'document', 'pdf' => 'Dokument', + default => 'Text', + }; + } + + private function label(Composition $composition): string + { + $kind = $composition->kind; + + return ($kind instanceof CompositionKind ? $kind : CompositionKind::from((string) $kind))->deskLabel(); + } +} diff --git a/app/Domain/Catalog/CompositionStructureReader.php b/app/Domain/Catalog/CompositionStructureReader.php new file mode 100644 index 0000000..d2ccf94 --- /dev/null +++ b/app/Domain/Catalog/CompositionStructureReader.php @@ -0,0 +1,82 @@ + + */ + public function tree(CompositionVersion $version): array + { + $version->loadMissing([ + 'members.contentElementVersion.element.editorialContentKind', + 'members.nestedCompositionVersion.composition.editorialContentKind', + ]); + + return $this->members($version); + } + + /** + * @return list + */ + private function members(CompositionVersion $version, array $stack = []): array + { + if (in_array($version->composition_id, $stack, true)) { + throw new DomainRuleException('Kompositionen dürfen keinen Zyklus bilden.'); + } + + $stack[] = $version->composition_id; + $nodes = []; + + foreach ($version->members as $member) { + if ($member->content_element_version_id !== null) { + $elementVersion = $member->contentElementVersion; + $elementVersion?->loadMissing('element.editorialContentKind'); + $element = $elementVersion?->element; + + $nodes[] = new StructureNode( + role: $member->role, + position: $member->position, + compositionVersionId: null, + compositionId: null, + contentElementVersionId: $elementVersion?->id, + contentElementId: $element?->id, + editorialKindLabel: $element?->editorialContentKind?->label, + technicalKindLabel: $element?->output_class, + outputClass: $element?->output_class, + title: $element?->working_title ?? $member->role, + ); + + continue; + } + + $nested = $member->nestedCompositionVersion; + + if ($nested === null) { + throw new DomainRuleException('Ein Kompositionsmitglied braucht genau ein Ziel.'); + } + + $nested->loadMissing('composition.editorialContentKind', 'composition'); + $composition = $nested->composition; + + $nodes[] = new StructureNode( + role: $member->role, + position: $member->position, + compositionVersionId: $nested->id, + compositionId: $composition->id, + contentElementVersionId: null, + contentElementId: null, + editorialKindLabel: $composition->editorialContentKind?->label, + technicalKindLabel: $composition->kind instanceof CompositionKind + ? $composition->kind->label() + : null, + outputClass: null, + title: $composition->designation, + children: $this->members($nested, $stack), + ); + } + + return $nodes; + } +} diff --git a/app/Domain/Catalog/CompositionVersion.php b/app/Domain/Catalog/CompositionVersion.php new file mode 100644 index 0000000..ab4e423 --- /dev/null +++ b/app/Domain/Catalog/CompositionVersion.php @@ -0,0 +1,72 @@ + ContentVersionStatus::class, + ]; + } + + protected static function booted(): void + { + static::updating(function (CompositionVersion $version): void { + $original = StatusValue::of($version->getOriginal('status')); + + if (! in_array($original, [ + ContentVersionStatus::Bereit->value, + ContentVersionStatus::Gesperrt->value, + ], true)) { + return; + } + + $dirty = array_diff(array_keys($version->getDirty()), ['status', 'updated_at']); + + if ($dirty !== [] || $original === ContentVersionStatus::Gesperrt->value) { + throw new DomainRuleException('Eine bestätigte Kompositionsfassung ist unveränderlich.'); + } + + if (StatusValue::of($version->status) !== ContentVersionStatus::Gesperrt->value) { + throw new DomainRuleException('Eine bestätigte Kompositionsfassung kann nur gesperrt werden.'); + } + }); + } + + public function composition(): BelongsTo + { + return $this->belongsTo(Composition::class); + } + + public function members(): HasMany + { + return $this->hasMany(CompositionMember::class)->orderBy('position'); + } + + public function attestations(): HasMany + { + return $this->hasMany(CompatibilityAttestation::class); + } + + public function displayEvents(): HasMany + { + return $this->hasMany(CompositionVersionDisplayEvent::class)->orderBy('occurred_at'); + } +} diff --git a/app/Domain/Catalog/CompositionVersionDisplayEvent.php b/app/Domain/Catalog/CompositionVersionDisplayEvent.php new file mode 100644 index 0000000..876d58e --- /dev/null +++ b/app/Domain/Catalog/CompositionVersionDisplayEvent.php @@ -0,0 +1,39 @@ + 'datetime', + ]; + } + + public function version(): BelongsTo + { + return $this->belongsTo(CompositionVersion::class, 'composition_version_id'); + } + + public function actor(): BelongsTo + { + return $this->belongsTo(User::class, 'actor_id'); + } +} diff --git a/app/Domain/Catalog/ContentElement.php b/app/Domain/Catalog/ContentElement.php new file mode 100644 index 0000000..d1aceef --- /dev/null +++ b/app/Domain/Catalog/ContentElement.php @@ -0,0 +1,58 @@ + 'datetime', + 'website_released_at' => 'datetime', + ]; + } + + public function editorialContentKind(): BelongsTo + { + return $this->belongsTo(EditorialContentKind::class); + } + + public function versions(): HasMany + { + return $this->hasMany(ContentElementVersion::class); + } + + public function pillars(): BelongsToMany + { + return $this->belongsToMany(Pillar::class)->orderBy('pillars.name'); + } +} diff --git a/app/Domain/Catalog/ContentElementVersion.php b/app/Domain/Catalog/ContentElementVersion.php new file mode 100644 index 0000000..983fabb --- /dev/null +++ b/app/Domain/Catalog/ContentElementVersion.php @@ -0,0 +1,78 @@ + ContentVersionStatus::class, + 'metadata' => 'array', + ]; + } + + protected static function booted(): void + { + static::updating(function (ContentElementVersion $version): void { + $original = StatusValue::of($version->getOriginal('status')); + + if (! in_array($original, [ + ContentVersionStatus::Bereit->value, + ContentVersionStatus::Gesperrt->value, + ], true)) { + return; + } + + if ( + $original === ContentVersionStatus::Bereit->value + && StatusValue::of($version->status) === ContentVersionStatus::Bereit->value + && ! app(ContentService::class)->isCommitted($version) + ) { + $contentFields = ['body', 'metadata', 'content_hash', 'change_note', 'updated_at']; + + if (array_diff(array_keys($version->getDirty()), $contentFields) === []) { + return; + } + } + + $allowed = ['status', 'updated_at']; + + if ( + $original === ContentVersionStatus::Bereit->value + && StatusValue::of($version->status) === ContentVersionStatus::Gesperrt->value + ) { + $allowed[] = 'block_reason'; + } + + $dirty = array_diff(array_keys($version->getDirty()), $allowed); + + if ($dirty !== [] || $original === ContentVersionStatus::Gesperrt->value) { + throw new DomainRuleException('Eine bereitgestellte Inhaltsfassung ist unveränderlich.'); + } + + if (StatusValue::of($version->status) !== ContentVersionStatus::Gesperrt->value) { + throw new DomainRuleException('Eine bereitgestellte Inhaltsfassung kann nur gesperrt werden.'); + } + }); + } + + public function element(): BelongsTo + { + return $this->belongsTo(ContentElement::class, 'content_element_id'); + } +} diff --git a/app/Domain/Catalog/ContentResolver.php b/app/Domain/Catalog/ContentResolver.php new file mode 100644 index 0000000..4ed1470 --- /dev/null +++ b/app/Domain/Catalog/ContentResolver.php @@ -0,0 +1,61 @@ + + */ + public function expand(ContentElementVersion|CompositionVersion $node, string $path = '', array $stack = []): array + { + if ($node instanceof ContentElementVersion) { + $node->loadMissing('element'); + + return [[ + 'version_id' => $node->id, + 'role' => $path, + 'path' => $path !== '' ? $path : $node->element->working_title, + ]]; + } + + if (in_array($node->composition_id, $stack, true)) { + throw new DomainRuleException('Kompositionen dürfen keinen Zyklus bilden.'); + } + + $stack[] = $node->composition_id; + $rows = []; + + foreach ($node->members()->orderBy('position')->get() as $member) { + $segment = $path === '' ? $member->role : $path.' / '.$member->role; + + if ($member->content_element_version_id !== null) { + $rows[] = [ + 'version_id' => $member->content_element_version_id, + 'role' => $member->role, + 'path' => $segment, + ]; + + continue; + } + + $nested = $member->nestedCompositionVersion; + + if ($nested === null) { + throw new DomainRuleException('Ein Kompositionsmitglied braucht genau ein Ziel.'); + } + + $rows = array_merge($rows, $this->expand($nested, $segment, $stack)); + } + + return $rows; + } + + public function resolvedHash(ContentElementVersion|CompositionVersion $node): string + { + $ids = array_values(array_unique(array_column($this->expand($node), 'version_id'))); + sort($ids); + + return hash('sha256', json_encode($ids, JSON_THROW_ON_ERROR)); + } +} diff --git a/app/Domain/Catalog/ContentService.php b/app/Domain/Catalog/ContentService.php new file mode 100644 index 0000000..e00e812 --- /dev/null +++ b/app/Domain/Catalog/ContentService.php @@ -0,0 +1,395 @@ +create([ + 'kind' => $this->required($kind, 'Die Art des Inhaltselements fehlt.'), + 'output_class' => $this->required($outputClass, 'Die Ausgabeklasse fehlt.'), + 'working_title' => $this->required($workingTitle, 'Der Arbeitstitel fehlt.'), + ]); + } + + public function block(ContentElementVersion|CompositionVersion $version, string $reason): void + { + if (trim($reason) === '') { + throw new DomainRuleException('Eine Sperre braucht eine Begründung.'); + } + + if ($version->status !== ContentVersionStatus::Bereit) { + throw new DomainRuleException('Nur eine bereitgestellte Fassung kann gesperrt werden.'); + } + + $version->status = ContentVersionStatus::Gesperrt; + + if ($version instanceof ContentElementVersion) { + $version->block_reason = trim($reason); + } + + $version->save(); + } + + public function describe(ContentElement $element, string $workingTitle, ?string $description): void + { + $element->working_title = $this->required($workingTitle, 'Der Arbeitstitel fehlt.'); + $description = trim((string) $description); + $element->description = $description === '' ? null : $description; + $element->save(); + } + + public function publishElementVersion( + ContentElement $element, + ?string $body = null, + array $metadata = [], + ?string $changeNote = null, + ): ContentElementVersion { + if (($body === null || $body === '') && $metadata === []) { + throw new DomainRuleException('Eine Inhaltsfassung braucht einen Inhalt.'); + } + + $number = ((int) $element->versions()->max('number')) + 1; + $incoming = $metadata['incoming'] ?? null; + $version = $element->versions()->create([ + 'number' => $number, + 'status' => is_string($incoming) && $incoming !== '' ? ContentVersionStatus::Entwurf : ContentVersionStatus::Bereit, + 'content_hash' => hash('sha256', json_encode([ + 'body' => $body, + 'metadata' => $metadata, + ], JSON_THROW_ON_ERROR | JSON_UNESCAPED_UNICODE)), + 'body' => $body, + 'metadata' => $metadata === [] ? null : $metadata, + 'change_note' => $changeNote, + ]); + + if (is_string($incoming) && $incoming !== '') { + StoreContentFile::dispatch($version->id, $incoming); + $version->refresh(); + } + + return $version; + } + + public function draftElementVersion( + ContentElement $element, + ?string $body = null, + array $metadata = [], + ): ContentElementVersion { + if (($body === null || $body === '') && $metadata === []) { + throw new DomainRuleException('Eine Inhaltsfassung braucht einen Inhalt.'); + } + + $number = ((int) $element->versions()->max('number')) + 1; + $version = $element->versions()->create([ + 'number' => $number, + 'status' => ContentVersionStatus::Entwurf, + 'content_hash' => hash('sha256', json_encode([ + 'body' => $body, + 'metadata' => $metadata, + ], JSON_THROW_ON_ERROR | JSON_UNESCAPED_UNICODE)), + 'body' => $body, + 'metadata' => $metadata === [] ? null : $metadata, + 'change_note' => null, + ]); + $incoming = $metadata['incoming'] ?? null; + + if (is_string($incoming) && $incoming !== '') { + StoreContentFile::dispatch($version->id, $incoming); + $version->refresh(); + } + + return $version; + } + + public function isCommitted(ContentElementVersion $version): bool + { + if ($version->status !== ContentVersionStatus::Bereit) { + return false; + } + + $usedByComposition = CompositionMember::query() + ->where('content_element_version_id', $version->id) + ->whereHas('compositionVersion', function ($query): void { + $query->where('status', ContentVersionStatus::Bereit); + }) + ->exists(); + + if ($usedByComposition) { + return true; + } + + return ReleaseContent::query() + ->where('content_element_version_id', $version->id) + ->exists(); + } + + public function reviseElementContent(ContentElementVersion $version, string $body): ContentElementVersion + { + $body = trim($body); + + if ($body === '') { + throw new DomainRuleException('Der Text braucht einen Inhalt.'); + } + + $version->loadMissing('element'); + + if ($version->status === ContentVersionStatus::Gesperrt) { + throw new DomainRuleException('Eine deaktivierte Fassung lässt sich nicht ändern.'); + } + + if (trim((string) $version->body) === $body) { + return $version; + } + + if ($this->isCommitted($version)) { + return $this->publishElementVersion($version->element, $body); + } + + $metadata = $version->metadata ?? []; + $version->body = $body; + $version->content_hash = hash('sha256', json_encode([ + 'body' => $body, + 'metadata' => $metadata, + ], JSON_THROW_ON_ERROR | JSON_UNESCAPED_UNICODE)); + $version->save(); + + return $version->refresh(); + } + + public function elementReleaseProblem(ContentElementVersion $version): ?string + { + $version->loadMissing('element'); + + if ($version->status === ContentVersionStatus::Gesperrt) { + return 'Diese Fassung ist deaktiviert und kann nicht freigegeben werden.'; + } + + if ($version->status === ContentVersionStatus::Bereit) { + return null; + } + + $meta = is_array($version->metadata) ? $version->metadata : []; + + if (isset($meta['incoming']) && ! isset($meta['file'])) { + return 'Die Datei ist noch nicht übernommen. Die Freigabe wartet, bis die Datei bereitsteht.'; + } + + if (isset($meta['error']) && is_string($meta['error']) && trim($meta['error']) !== '') { + return trim($meta['error']); + } + + if ($version->element?->output_class === 'text' && trim((string) $version->body) === '') { + return 'Der Text braucht einen Inhalt.'; + } + + return null; + } + + public function releaseElementVersion(ContentElementVersion $version): ContentElementVersion + { + $version->loadMissing('element'); + + if ($version->status === ContentVersionStatus::Bereit) { + return $version; + } + + if ($version->status !== ContentVersionStatus::Entwurf) { + throw new DomainRuleException('Eine deaktivierte Fassung lässt sich nicht freigeben.'); + } + + $problem = $this->elementReleaseProblem($version); + + if ($problem !== null) { + throw new DomainRuleException($problem); + } + + $meta = is_array($version->metadata) ? $version->metadata : []; + unset($meta['held']); + $version->metadata = $meta === [] ? null : $meta; + $version->content_hash = hash('sha256', json_encode([ + 'body' => $version->body, + 'metadata' => $meta, + ], JSON_THROW_ON_ERROR | JSON_UNESCAPED_UNICODE)); + $version->status = ContentVersionStatus::Bereit; + $version->save(); + + return $version->refresh(); + } + + /** + * @param list $members + */ + public function publishComposition( + Composition $composition, + array $members, + ?User $confirmedBy = null, + ?string $note = null, + array $didactic = [], + ): CompositionVersion { + if ($members === []) { + throw new DomainRuleException('Eine Komposition braucht mindestens ein Mitglied.'); + } + + $this->assertAcyclic($composition->id, $members); + + foreach ($members as $member) { + $this->assertReadyMember($member['target']); + } + + return DB::transaction(function () use ($composition, $members, $confirmedBy, $note, $didactic): CompositionVersion { + $number = ((int) $composition->versions()->max('number')) + 1; + $version = $composition->versions()->create([ + 'number' => $number, + 'status' => ContentVersionStatus::Entwurf, + 'members_hash' => $this->membersHash($members), + 'resolved_hash' => 'pending', + 'learning_goal' => $this->optionalText($didactic['learning_goal'] ?? null), + 'duration_minutes' => isset($didactic['duration_minutes']) ? (int) $didactic['duration_minutes'] : null, + 'material_note' => $this->optionalText($didactic['material_note'] ?? null), + ]); + + foreach (array_values($members) as $index => $member) { + $target = $member['target']; + $version->members()->create([ + 'position' => $index + 1, + 'role' => $this->required($member['role'], 'Die Rolle eines Mitglieds fehlt.'), + 'placement_note' => $this->optionalText($member['note'] ?? null), + 'content_element_version_id' => $target instanceof ContentElementVersion ? $target->id : null, + 'nested_composition_version_id' => $target instanceof CompositionVersion ? $target->id : null, + ]); + } + + $resolvedHash = $this->resolver->resolvedHash($version); + $version->attestations()->create([ + 'resolved_hash' => $resolvedHash, + 'confirmed_by' => $confirmedBy?->id, + 'confirmed_at' => now(), + 'note' => $note, + ]); + $version->resolved_hash = $resolvedHash; + $version->status = ContentVersionStatus::Bereit; + $version->save(); + + return $version->load('members'); + }); + } + + public function createComposition(string $designation, CompositionKind $kind = CompositionKind::Uebung): Composition + { + return Composition::query()->create([ + 'designation' => $this->required($designation, 'Die Bezeichnung fehlt.'), + 'kind' => $kind, + ]); + } + + /** + * @return list + */ + public function containingCompositionIds(ContentElementVersion $version): array + { + $ids = []; + + foreach (CompositionVersion::query()->where('status', ContentVersionStatus::Bereit)->get() as $compositionVersion) { + $contained = array_column($this->resolver->expand($compositionVersion), 'version_id'); + + if (in_array($version->id, $contained, true)) { + $ids[] = $compositionVersion->id; + } + } + + return $ids; + } + + /** + * @param list $members + * @param list $stack + */ + private function assertAcyclic(int $compositionId, array $members, array $stack = []): void + { + if (in_array($compositionId, $stack, true)) { + throw new DomainRuleException('Kompositionen dürfen keinen Zyklus bilden.'); + } + + $stack[] = $compositionId; + + foreach ($members as $member) { + $target = $member['target']; + + if (! $target instanceof CompositionVersion) { + continue; + } + + $nested = []; + + foreach ($target->members()->orderBy('position')->get() as $row) { + $child = $row->contentElementVersion ?? $row->nestedCompositionVersion; + + if ($child === null) { + throw new DomainRuleException('Ein Kompositionsmitglied braucht genau ein Ziel.'); + } + + $nested[] = ['role' => $row->role, 'target' => $child]; + } + + $this->assertAcyclic($target->composition_id, $nested, $stack); + } + } + + private function assertReadyMember(ContentElementVersion|CompositionVersion $target): void + { + if ($target->status !== ContentVersionStatus::Bereit) { + throw new DomainRuleException('Eine Komposition darf nur bereitgestellte Fassungen enthalten.'); + } + } + + /** + * @param list $members + */ + private function membersHash(array $members): string + { + $list = []; + + foreach (array_values($members) as $index => $member) { + $target = $member['target']; + $list[] = [ + 'position' => $index + 1, + 'role' => $member['role'], + 'note' => $this->optionalText($member['note'] ?? null), + 'element_version_id' => $target instanceof ContentElementVersion ? $target->id : null, + 'composition_version_id' => $target instanceof CompositionVersion ? $target->id : null, + ]; + } + + return hash('sha256', json_encode($list, JSON_THROW_ON_ERROR | JSON_UNESCAPED_UNICODE)); + } + + private function optionalText(mixed $value): ?string + { + if (! is_string($value)) { + return null; + } + + $value = trim($value); + + return $value === '' ? null : $value; + } + + private function required(string $value, string $message): string + { + $value = trim($value); + + if ($value === '') { + throw new DomainRuleException($message); + } + + return $value; + } +} diff --git a/app/Domain/Catalog/ContentVersionStatus.php b/app/Domain/Catalog/ContentVersionStatus.php new file mode 100644 index 0000000..e61b995 --- /dev/null +++ b/app/Domain/Catalog/ContentVersionStatus.php @@ -0,0 +1,10 @@ + 'Medium', + 'modul' => 'Modul', + 'programm' => 'Programm', + 'lizenzartikel' => 'Lizenzartikel', + ]; + + /** + * Kennungen, auf die der Code fachlich verweist: öffentliche Programmseiten und das Anlegen von Programmen und + * Modulen (programm, modul), Vertraulichkeit von Traineranleitungen (traineranleitung). Ihre Bezeichnung bleibt + * pflegbar; deaktivieren, Kontexte ändern und löschen sind gesperrt. + */ + public const SYSTEM_SLUGS = ['programm', 'modul', 'traineranleitung']; + + protected $fillable = [ + 'slug', + 'label', + 'sort_order', + 'is_active', + 'contexts', + ]; + + protected function casts(): array + { + return [ + 'is_active' => 'boolean', + 'contexts' => 'array', + 'sort_order' => 'integer', + ]; + } + + public function compositions(): HasMany + { + return $this->hasMany(Composition::class); + } + + public function contentElements(): HasMany + { + return $this->hasMany(ContentElement::class); + } + + public function licenseArticles(): HasMany + { + return $this->hasMany(LicenseArticle::class); + } + + /** + * @param Builder $query + */ + public function scopeActive(Builder $query): void + { + $query->where('is_active', true); + } + + public function allows(string $context): bool + { + return in_array($context, (array) ($this->contexts ?? []), true); + } + + public function isSystem(): bool + { + return in_array($this->slug, self::SYSTEM_SLUGS, true); + } + + /** + * Alle Materialarten in Pflegereihenfolge (ohne Kontext- oder Aktivfilter). Für Auswahlstellen gilt + * EditorialVocabulary. + * + * @return array + */ + public static function selectOptions(): array + { + return static::query()->orderBy('sort_order')->orderBy('id')->pluck('label', 'id')->all(); + } +} diff --git a/app/Domain/Catalog/EditorialDimension.php b/app/Domain/Catalog/EditorialDimension.php new file mode 100644 index 0000000..fe177f0 --- /dev/null +++ b/app/Domain/Catalog/EditorialDimension.php @@ -0,0 +1,49 @@ +hasMany(EditorialDimensionValue::class)->orderBy('sort_order')->orderBy('id'); + } + + /** + * Inhaltselemente pflegen Themen über die Säulen, nicht noch einmal über die Dimension. + * Module, Programme und Lizenzartikel haben keine Säulenauswahl und behalten die Dimension. + * + * @return Collection + */ + public static function forSubject(Model $subject): Collection + { + $query = static::query()->with('values')->orderBy('label'); + + if ($subject instanceof ContentElement) { + $query->where('slug', '!=', self::PILLAR_SLUG); + } + + return $query->get(); + } + + /** + * @return list + */ + public static function offeredValueIds(Model $subject): array + { + return static::forSubject($subject) + ->flatMap(fn (self $dimension) => $dimension->values->pluck('id')) + ->map(fn ($id): int => (int) $id) + ->all(); + } +} diff --git a/app/Domain/Catalog/EditorialDimensionValue.php b/app/Domain/Catalog/EditorialDimensionValue.php new file mode 100644 index 0000000..e646517 --- /dev/null +++ b/app/Domain/Catalog/EditorialDimensionValue.php @@ -0,0 +1,24 @@ + 'boolean', + 'sort_order' => 'integer', + ]; + } + + public function dimension(): BelongsTo + { + return $this->belongsTo(EditorialDimension::class, 'editorial_dimension_id'); + } +} diff --git a/app/Domain/Catalog/EditorialProfile.php b/app/Domain/Catalog/EditorialProfile.php new file mode 100644 index 0000000..a870b53 --- /dev/null +++ b/app/Domain/Catalog/EditorialProfile.php @@ -0,0 +1,51 @@ + $texts + */ + public function __construct( + public ?string $workingTitle, + public array $texts, + public ?string $searchTerms, + public string $searchOrigin, + public ?string $kindLabel, + public ?Model $source, + ) {} + + public function text(string $field): ResolvedText + { + return $this->texts[$field] ?? new ResolvedText(null, 'leer', null); + } + + public function value(string $field): ?string + { + return $this->text($field)->value; + } + + public function origin(string $field): string + { + return $this->text($field)->origin; + } + + public function originLabel(string $field): string + { + $text = $this->text($field); + + return match ($text->origin) { + 'eigen' => 'Eigene Angabe', + 'variante' => 'Abweichung für '.($text->label ?? 'diesen Kontext'), + 'quelle' => 'Übernommen von '.($text->label ?? 'der fachlichen Quelle'), + default => 'Keine Angabe', + }; + } +} diff --git a/app/Domain/Catalog/EditorialProfileReader.php b/app/Domain/Catalog/EditorialProfileReader.php new file mode 100644 index 0000000..aa5d44d --- /dev/null +++ b/app/Domain/Catalog/EditorialProfileReader.php @@ -0,0 +1,225 @@ + 'Öffentliche Kachel', + 'detail' => 'Öffentliche Detailvorstellung', + 'bibliothek' => 'Mitgliederbibliothek', + 'trainer' => 'Fachliche Traineransicht', + 'artikel' => 'Lizenzartikelpräsentation', + 'cms' => 'CMS-Teaser', + 'suche' => 'Suchergebnis', + ]; + + public const TEXT_FIELDS = ['display_title', 'teaser', 'summary', 'description']; + + public function read(Model $subject, ?string $audience = null): EditorialProfile + { + if ($audience !== null && ! array_key_exists($audience, self::AUDIENCES)) { + throw new DomainRuleException('Diese Zielgruppe ist nicht vorgesehen.'); + } + + $source = $subject instanceof LicenseArticle ? $this->sourceOf($subject) : null; + $texts = []; + + foreach (self::TEXT_FIELDS as $field) { + $texts[$field] = $this->resolve($subject, $field, $audience, $source); + } + + $search = $this->own($subject, 'search_terms'); + $searchOrigin = 'eigen'; + + if ($search === null && $source instanceof Model) { + $search = $this->own($source, 'search_terms'); + $searchOrigin = $search === null ? 'leer' : 'quelle'; + } + + if ($search === null) { + $searchOrigin = 'leer'; + } + + return new EditorialProfile( + workingTitle: $this->workingTitle($subject), + texts: $texts, + searchTerms: $search, + searchOrigin: $searchOrigin, + kindLabel: $subject->editorialContentKind?->label + ?? ($source?->editorialContentKind?->label), + source: $source, + ); + } + + public function sourceOf(LicenseArticle $article): ?Model + { + $release = $article->relationLoaded('currentRelease') + ? $article->currentRelease + : $article->currentRelease()->first(); + + if (! $release instanceof ArticleRelease) { + return null; + } + + $elementId = $release->root_element_version_id; + $compositionId = $release->root_composition_version_id; + + if (($elementId === null) === ($compositionId === null)) { + return null; + } + + if ($elementId !== null) { + return ContentElementVersion::query()->with('element.editorialContentKind')->find($elementId)?->element; + } + + return CompositionVersion::query()->with('composition.editorialContentKind')->find($compositionId)?->composition; + } + + public function putVariant(Model $subject, string $field, string $audience, ?string $body, ?User $actor = null): string + { + if (! in_array($field, self::TEXT_FIELDS, true) || ! array_key_exists($audience, self::AUDIENCES)) { + throw new DomainRuleException('Diese Abweichung ist nicht vorgesehen.'); + } + + $body = is_string($body) ? trim($body) : ''; + $existing = $this->variant($subject, $field, $audience); + + if ($body === '') { + if ($existing instanceof EditorialTextVariant) { + $this->record($subject, $audience, $field, $existing->body, null, $actor); + $existing->delete(); + } + + return 'Die abweichende Formulierung ist entfernt. Es gilt wieder die zentrale Angabe.'; + } + + if ($existing instanceof EditorialTextVariant && $existing->body === $body) { + return 'Die abweichende Formulierung ist unverändert.'; + } + + $this->record($subject, $audience, $field, $existing?->body, $body, $actor); + + EditorialTextVariant::query()->updateOrCreate( + [ + 'subject_type' => $subject->getMorphClass(), + 'subject_id' => $subject->getKey(), + 'field' => $field, + 'audience' => $audience, + ], + ['body' => $body], + ); + + return 'Die abweichende Formulierung gilt nur für '.self::AUDIENCES[$audience].'. Die zentrale Angabe bleibt.'; + } + + public function forgetVariant(Model $subject, EditorialTextVariant $variant, ?User $actor = null): void + { + if ($variant->subject_type !== $subject->getMorphClass() || (int) $variant->subject_id !== (int) $subject->getKey()) { + throw new DomainRuleException('Diese Abweichung gehört zu einem anderen Objekt.'); + } + + $this->record($subject, $variant->audience, $variant->field, $variant->body, null, $actor); + $variant->delete(); + } + + private function resolve(Model $subject, string $field, ?string $audience, ?Model $source): ResolvedText + { + if ($audience !== null) { + $variant = $this->variant($subject, $field, $audience); + + if ($variant instanceof EditorialTextVariant && trim($variant->body) !== '') { + return new ResolvedText(trim($variant->body), 'variante', self::AUDIENCES[$audience]); + } + } + + $own = $this->own($subject, $field); + + if ($own !== null) { + return new ResolvedText($own, 'eigen', null); + } + + if ($source instanceof Model) { + $fromSource = $this->resolve($source, $field, $audience, null); + + if ($fromSource->value !== null) { + return new ResolvedText($fromSource->value, 'quelle', $this->sourceLabel($source)); + } + } + + return new ResolvedText(null, 'leer', null); + } + + private function variant(Model $subject, string $field, string $audience): ?EditorialTextVariant + { + return EditorialTextVariant::query() + ->where('subject_type', $subject->getMorphClass()) + ->where('subject_id', $subject->getKey()) + ->where('field', $field) + ->where('audience', $audience) + ->first(); + } + + private function own(Model $subject, string $field): ?string + { + $value = $subject->getAttribute($field); + + if (! is_string($value)) { + return null; + } + + $value = trim($value); + + return $value === '' ? null : $value; + } + + private function workingTitle(Model $subject): ?string + { + if ($subject instanceof Composition) { + return $this->own($subject, 'designation'); + } + + if ($subject instanceof LicenseArticle) { + return $this->own($subject, 'working_title') ?? $this->own($subject, 'code'); + } + + return $this->own($subject, 'working_title'); + } + + private function sourceLabel(Model $source): string + { + if ($source instanceof Composition) { + return (string) ($source->display_title ?: $source->designation); + } + + if ($source instanceof ContentElement) { + return (string) ($source->display_title ?: $source->working_title); + } + + return 'der fachlichen Quelle'; + } + + private function record(Model $subject, string $audience, string $field, ?string $before, ?string $after, ?User $actor): void + { + IdentityChange::query()->create([ + 'subject_type' => $subject->getMorphClass(), + 'subject_id' => $subject->getKey(), + 'field' => 'variante:'.$audience.':'.$field, + 'before' => $before, + 'after' => $after, + 'actor_id' => $actor?->id, + 'occurred_at' => now(), + ]); + } +} diff --git a/app/Domain/Catalog/EditorialTextVariant.php b/app/Domain/Catalog/EditorialTextVariant.php new file mode 100644 index 0000000..a2f5332 --- /dev/null +++ b/app/Domain/Catalog/EditorialTextVariant.php @@ -0,0 +1,16 @@ +kind instanceof CompositionKind ? $subject->kind : CompositionKind::tryFrom((string) $subject->kind)); + } + + return null; + } + + public static function compositionContext(?CompositionKind $kind): ?string + { + return match ($kind) { + CompositionKind::Kurs => 'programm', + CompositionKind::Uebung => 'modul', + default => null, + }; + } + + /** + * Auswahl der Materialart in einem Editor: aktive, im Kontext zulässige Arten in Pflegereihenfolge, dazu die + * bereits zugeordnete Art mit Kennzeichnung, falls sie inaktiv oder hier nicht vorgesehen ist. + * + * @return array + */ + public function kindOptions(string $context, ?int $currentId = null): array + { + $options = []; + + foreach (EditorialContentKind::query()->orderBy('sort_order')->orderBy('id')->get() as $kind) { + $offered = $kind->is_active && $kind->allows($context); + + if ($offered) { + $options[$kind->id] = (string) $kind->label; + } elseif ($currentId !== null && $kind->id === $currentId) { + $options[$kind->id] = $this->kindLabel($kind, $context); + } + } + + return $options; + } + + /** + * Prüft eine neue Materialart serverseitig. Die bereits gespeicherte Art bleibt immer zulässig. + */ + public function kindError(string $context, ?int $newId, ?int $storedId): ?string + { + if ($newId === null || $newId === $storedId) { + return null; + } + + $kind = EditorialContentKind::query()->find($newId); + + if (! $kind instanceof EditorialContentKind) { + return 'Diese fachliche Materialart gibt es nicht mehr.'; + } + + if (! $kind->is_active) { + return 'Die fachliche Materialart „'.$kind->label.'“ ist deaktiviert und kann nicht neu gewählt werden.'; + } + + if (! $kind->allows($context)) { + return 'Die fachliche Materialart „'.$kind->label.'“ ist für '.(EditorialContentKind::CONTEXTS[$context] ?? $context).' nicht vorgesehen.'; + } + + return null; + } + + /** + * Filteroptionen der Materialart für einen Bestand: im Kontext zulässige Arten und Arten, die dort tatsächlich + * vorkommen (gekennzeichnet), dazu ein bereits gewählter Filter. + * + * @return array + */ + public function kindFilterOptions(string $context, string $selected = ''): array + { + $used = $this->usedKindIds($context); + $options = []; + + foreach (EditorialContentKind::query()->orderBy('sort_order')->orderBy('id')->get() as $kind) { + $show = ($kind->allows($context) && $kind->is_active) || in_array($kind->id, $used, true) || (string) $kind->id === $selected; + + if ($show) { + $options[(string) $kind->id] = $this->kindLabel($kind, $context); + } + } + + return $options; + } + + public function kindLabel(EditorialContentKind $kind, string $context): string + { + return (string) $kind->label + .(! $kind->is_active ? self::INACTIVE_SUFFIX : (! $kind->allows($context) ? self::OUT_OF_CONTEXT_SUFFIX : '')); + } + + /** + * @return list + */ + private function usedKindIds(string $context): array + { + $query = match ($context) { + 'medium' => DB::table('content_elements'), + 'lizenzartikel' => DB::table('license_articles'), + 'programm' => DB::table('compositions')->where('kind', CompositionKind::Kurs->value), + 'modul' => DB::table('compositions')->where('kind', CompositionKind::Uebung->value), + default => null, + }; + + return $query === null ? [] : $query->whereNotNull('editorial_content_kind_id')->distinct() + ->pluck('editorial_content_kind_id')->map(fn ($id): int => (int) $id)->all(); + } + + /** + * Einordnung im Editor: je angebotener Dimension aktive Werte und bereits zugeordnete inaktive Werte (gekennzeichnet). + * + * @param list $assignedIds + * @return list}> + */ + public function dimensionGroups(Model $subject, array $assignedIds): array + { + $groups = []; + + foreach (EditorialDimension::forSubject($subject) as $dimension) { + $values = []; + + foreach ($dimension->values as $value) { + if ($value->is_active || in_array((int) $value->id, $assignedIds, true)) { + $values[] = [ + 'id' => (int) $value->id, + 'label' => (string) $value->label.($value->is_active ? '' : self::INACTIVE_SUFFIX), + 'inactive' => ! $value->is_active, + ]; + } + } + + if ($values !== []) { + $groups[] = ['label' => (string) $dimension->label, 'values' => $values]; + } + } + + return $groups; + } + + /** + * Filtergruppen der Einordnung: aktive Werte, verwendete inaktive Werte (gekennzeichnet) und gewählte Filter. + * + * @param list $selectedIds + * @return list}> + */ + public function dimensionFilterGroups(array $selectedIds = [], bool $withPillars = true): array + { + $used = DB::table('identity_dimension_values')->distinct()->pluck('editorial_dimension_value_id')->map(fn ($id): int => (int) $id)->all(); + $groups = []; + + foreach (EditorialDimension::query()->with('values')->orderBy('label')->get() as $dimension) { + if (! $withPillars && $dimension->slug === EditorialDimension::PILLAR_SLUG) { + continue; + } + + $values = []; + + foreach ($dimension->values as $value) { + $id = (int) $value->id; + + if ($value->is_active || in_array($id, $used, true) || in_array($id, $selectedIds, true)) { + $values[] = ['id' => $id, 'label' => (string) $value->label.($value->is_active ? '' : self::INACTIVE_SUFFIX)]; + } + } + + if ($values !== []) { + $groups[] = ['label' => (string) $dimension->label, 'values' => $values]; + } + } + + return $groups; + } + + /** + * Öffentliche Filter der Mitgliederbibliothek: nur aktive Werte, ein bereits gewählter Wert bleibt sichtbar. + * + * @param list $selectedIds + * @return Collection + */ + public function memberFilterDimensions(array $selectedIds = []): Collection + { + $dimensions = EditorialDimension::query()->with('values')->orderBy('label')->get(); + + foreach ($dimensions as $dimension) { + $dimension->setRelation('values', $dimension->values + ->filter(fn (EditorialDimensionValue $value): bool => $value->is_active || in_array((int) $value->id, $selectedIds, true)) + ->values()); + } + + return $dimensions->filter(fn (EditorialDimension $dimension): bool => $dimension->values->isNotEmpty())->values(); + } + + /** + * Für replaceOffered: Werte, die bei diesem Fachobjekt gesetzt oder entfernt werden dürfen. Aktive Werte der + * angebotenen Dimensionen und die bereits zugeordneten inaktiven (der Editor zeigt sie gekennzeichnet an). + * + * @param list $assignedIds + * @return list + */ + public function editableValueIds(Model $subject, array $assignedIds): array + { + $ids = []; + + foreach (EditorialDimension::forSubject($subject) as $dimension) { + foreach ($dimension->values as $value) { + if ($value->is_active || in_array((int) $value->id, $assignedIds, true)) { + $ids[] = (int) $value->id; + } + } + } + + return $ids; + } +} diff --git a/app/Domain/Catalog/EditorialWorkingDraft.php b/app/Domain/Catalog/EditorialWorkingDraft.php new file mode 100644 index 0000000..e28542e --- /dev/null +++ b/app/Domain/Catalog/EditorialWorkingDraft.php @@ -0,0 +1,35 @@ +|null + */ + public function read(Composition $composition): ?array + { + $draft = $composition->working_draft; + + return is_array($draft) && $draft !== [] ? $draft : null; + } + + /** + * @param array $payload + */ + public function write(Composition $composition, array $payload): void + { + $composition->working_draft = $payload; + $composition->save(); + } + + public function clear(Composition $composition): void + { + if ($composition->working_draft === null) { + return; + } + + $composition->working_draft = null; + $composition->save(); + } +} diff --git a/app/Domain/Catalog/IdentityChange.php b/app/Domain/Catalog/IdentityChange.php new file mode 100644 index 0000000..8f24569 --- /dev/null +++ b/app/Domain/Catalog/IdentityChange.php @@ -0,0 +1,32 @@ + 'datetime', + ]; + } + + public function actor(): BelongsTo + { + return $this->belongsTo(User::class, 'actor_id'); + } +} diff --git a/app/Domain/Catalog/IdentityDimension.php b/app/Domain/Catalog/IdentityDimension.php new file mode 100644 index 0000000..43801f8 --- /dev/null +++ b/app/Domain/Catalog/IdentityDimension.php @@ -0,0 +1,95 @@ +updateOrCreate( + [ + 'subject_type' => $subject->getMorphClass(), + 'subject_id' => $subject->getKey(), + 'editorial_dimension_value_id' => $value->id, + ], + ['origin' => $origin], + ); + } + + /** + * @param list $valueIds + */ + public function matches(Model $subject, array $valueIds): bool + { + if ($valueIds === []) { + return true; + } + + $assigned = IdentityDimensionValue::query() + ->where('subject_type', $subject->getMorphClass()) + ->where('subject_id', $subject->getKey()) + ->pluck('editorial_dimension_value_id') + ->all(); + + $wanted = EditorialDimensionValue::query()->whereIn('id', $valueIds)->get()->groupBy('editorial_dimension_id'); + + if ($wanted->isEmpty()) { + return false; + } + + foreach ($wanted as $group) { + $ids = $group->pluck('id')->all(); + if (array_intersect($ids, $assigned) === []) { + return false; + } + } + + return true; + } + + /** + * Ersetzt nur die Werte der Dimensionen, die dieses Fachobjekt anbietet. + * Nicht angebotene Zuordnungen, etwa gespiegelte Säulen am Inhaltselement, bleiben. + * + * Inaktive Werte (Stammdatenpflege) sind nicht neu wählbar. Bereits zugeordnete inaktive Werte zeigt der Editor + * gekennzeichnet an; sie bleiben, solange sie mitgeschickt werden, und werden nur bei ausdrücklicher Abwahl entfernt. + * + * @param list $valueIds + */ + public function replaceOffered(Model $subject, array $valueIds): void + { + $assigned = IdentityDimensionValue::query() + ->where('subject_type', $subject->getMorphClass()) + ->where('subject_id', $subject->getKey()) + ->pluck('editorial_dimension_value_id') + ->map(fn ($id): int => (int) $id) + ->all(); + $offeredIds = app(EditorialVocabulary::class)->editableValueIds($subject, $assigned); + $ids = array_values(array_intersect( + array_values(array_unique(array_map(intval(...), $valueIds))), + $offeredIds, + )); + + $query = IdentityDimensionValue::query() + ->where('subject_type', $subject->getMorphClass()) + ->where('subject_id', $subject->getKey()) + ->where('origin', 'direkt') + ->whereIn('editorial_dimension_value_id', $offeredIds === [] ? [0] : $offeredIds); + + if ($ids !== []) { + $query->whereNotIn('editorial_dimension_value_id', $ids); + } + + $query->delete(); + + foreach (EditorialDimensionValue::query()->whereIn('id', $ids)->get() as $value) { + $this->assign($subject, $value, 'direkt'); + } + } +} diff --git a/app/Domain/Catalog/IdentityDimensionValue.php b/app/Domain/Catalog/IdentityDimensionValue.php new file mode 100644 index 0000000..ad216aa --- /dev/null +++ b/app/Domain/Catalog/IdentityDimensionValue.php @@ -0,0 +1,15 @@ + $fields + */ + public function fill(Model $subject, array $fields, ?User $actor = null): void + { + foreach ($fields as $field => $value) { + $next = is_string($value) ? trim($value) : $value; + $next = $next === '' ? null : $next; + $before = $subject->getAttribute($field); + $before = $before === '' ? null : $before; + + if ($before === $next) { + continue; + } + + $subject->setAttribute($field, $next); + IdentityChange::query()->create([ + 'subject_type' => $subject->getMorphClass(), + 'subject_id' => $subject->getKey(), + 'field' => $field, + 'before' => $before, + 'after' => $next, + 'actor_id' => $actor?->id, + 'occurred_at' => now(), + ]); + } + + $subject->save(); + } +} diff --git a/app/Domain/Catalog/LicenseArticle.php b/app/Domain/Catalog/LicenseArticle.php new file mode 100644 index 0000000..8116e63 --- /dev/null +++ b/app/Domain/Catalog/LicenseArticle.php @@ -0,0 +1,52 @@ + 'datetime', + ]; + } + + public function releases(): HasMany + { + return $this->hasMany(ArticleRelease::class); + } + + public function currentRelease(): BelongsTo + { + return $this->belongsTo(ArticleRelease::class, 'current_release_id'); + } + + public function successorOf(): BelongsTo + { + return $this->belongsTo(self::class, 'successor_of_id'); + } + + public function editorialContentKind(): BelongsTo + { + return $this->belongsTo(EditorialContentKind::class); + } +} diff --git a/app/Domain/Catalog/Offer.php b/app/Domain/Catalog/Offer.php new file mode 100644 index 0000000..41f38d8 --- /dev/null +++ b/app/Domain/Catalog/Offer.php @@ -0,0 +1,18 @@ +hasMany(OfferVersion::class); + } +} diff --git a/app/Domain/Catalog/OfferCoverage.php b/app/Domain/Catalog/OfferCoverage.php new file mode 100644 index 0000000..6711c6e --- /dev/null +++ b/app/Domain/Catalog/OfferCoverage.php @@ -0,0 +1,38 @@ + $articles + * @return list + */ + public function missingLeaves(CompositionVersion $version, array $articles): array + { + $covered = []; + + foreach ($articles as $article) { + $release = $article->currentRelease; + if ($release === null) { + continue; + } + + foreach ($release->contents()->pluck('content_element_version_id') as $id) { + $covered[(int) $id] = true; + } + } + + $missing = []; + + foreach ($this->resolver->expand($version) as $row) { + if (! isset($covered[$row['version_id']])) { + $missing[] = $row['path']; + } + } + + return $missing; + } +} diff --git a/app/Domain/Catalog/OfferLine.php b/app/Domain/Catalog/OfferLine.php new file mode 100644 index 0000000..0af23e6 --- /dev/null +++ b/app/Domain/Catalog/OfferLine.php @@ -0,0 +1,55 @@ +whereKey($line->offer_version_id)->value('status'); + + if (in_array(StatusValue::of($status), [ + OfferStatus::Aktiv->value, + OfferStatus::Beendet->value, + ], true)) { + throw new DomainRuleException('Eine aktivierte Angebotsfassung nimmt keine weiteren Positionen auf.'); + } + }); + + static::updating(function (): void { + throw new DomainRuleException('Positionen einer Angebotsfassung sind unveränderlich.'); + }); + } + + public function offerVersion(): BelongsTo + { + return $this->belongsTo(OfferVersion::class); + } + + public function article(): BelongsTo + { + return $this->belongsTo(LicenseArticle::class, 'license_article_id'); + } + + public function bundleVersion(): BelongsTo + { + return $this->belongsTo(BundleVersion::class); + } + + public function rights(): BelongsTo + { + return $this->belongsTo(RightsProfileVersion::class, 'rights_profile_version_id'); + } +} diff --git a/app/Domain/Catalog/OfferService.php b/app/Domain/Catalog/OfferService.php new file mode 100644 index 0000000..a8f913b --- /dev/null +++ b/app/Domain/Catalog/OfferService.php @@ -0,0 +1,232 @@ +versions() + ->where('status', OfferStatus::Aktiv) + ->orderByDesc('number') + ->first(); + + if ($version === null) { + throw new DomainRuleException('Das Angebot hat keine aktive Fassung.'); + } + + return $version; + } + + /** + * @param array $capabilities + * @param array $options + */ + public function createRightsProfile( + string $name, + string $purpose, + array $capabilities, + array $options = [], + ): RightsProfileVersion { + $purpose = trim($purpose); + + if (! in_array($purpose, ['ehrenamtlich', 'kommerziell', 'institutionell'], true)) { + throw new DomainRuleException('Der Nutzungszweck eines Rechteprofils ist ehrenamtlich, kommerziell oder institutionell.'); + } + + if ($capabilities === []) { + throw new DomainRuleException('Ein Rechteprofil braucht mindestens eine Fähigkeit.'); + } + + $profile = RightsProfile::query()->create([ + 'name' => trim($name) !== '' ? trim($name) : throw new DomainRuleException('Der Name des Rechteprofils fehlt.'), + ]); + + return $profile->versions()->create([ + 'number' => 1, + 'purpose' => $purpose, + 'capabilities' => $capabilities, + 'options' => $options, + ]); + } + + public function create(string $name): Offer + { + $name = trim($name); + + if ($name === '') { + throw new DomainRuleException('Der Name des Angebots fehlt.'); + } + + return Offer::query()->create([ + 'name' => $name, + ]); + } + + /** + * @param list $lines + * @param array $attributes + */ + public function activate(Offer $offer, array $lines, array $attributes = []): OfferVersion + { + if ($lines === []) { + throw new DomainRuleException('Eine Angebotsfassung braucht mindestens eine Position.'); + } + + $attributes = array_merge([ + 'price_cents' => null, + 'tax_class' => null, + 'term_rule' => 'dauerhaft', + 'update_promise' => 'alle_freigegebenen_fassungen', + 'dynamic' => false, + 'grant_kind' => 'kauf', + 'holder_kind' => 'person', + ], $attributes); + + $this->assertAttributes($attributes); + $scope = $this->scopeFor($lines); + $this->assertCoverage($lines, $attributes); + + return DB::transaction(function () use ($offer, $lines, $attributes, $scope): OfferVersion { + $offer = Offer::query()->lockForUpdate()->findOrFail($offer->id); + + OfferVersion::query() + ->where('offer_id', $offer->id) + ->where('status', OfferStatus::Aktiv) + ->update(['status' => OfferStatus::Beendet->value]); + + $version = $offer->versions()->create([ + 'number' => ((int) $offer->versions()->max('number')) + 1, + 'status' => OfferStatus::Entwurf, + 'price_cents' => $attributes['price_cents'], + 'tax_class' => $attributes['tax_class'], + 'term_rule' => $attributes['term_rule'], + 'update_promise' => $attributes['update_promise'], + 'dynamic' => $attributes['dynamic'], + 'grant_kind' => $attributes['grant_kind'], + 'holder_kind' => $attributes['holder_kind'], + ]); + + foreach (array_values($lines) as $index => $line) { + $target = $line['target']; + $version->lines()->create([ + 'position' => $index + 1, + 'license_article_id' => $target instanceof LicenseArticle ? $target->id : null, + 'bundle_version_id' => $target instanceof BundleVersion ? $target->id : null, + 'rights_profile_version_id' => $line['rights']->id, + ]); + } + + foreach ($scope as $entry) { + $version->resolvedScopes()->create($entry); + } + + RightsProfileVersion::query() + ->whereIn('id', array_column($scope, 'rights_profile_version_id')) + ->whereNull('locked_at') + ->update(['locked_at' => now()]); + + $version->status = OfferStatus::Aktiv; + $version->activated_at = now(); + $version->save(); + + return $version->load('resolvedScopes'); + }); + } + + /** + * @return list + */ + public function scopeArticleIds(OfferVersion $version): array + { + return $version->resolvedScopes()->orderBy('id')->pluck('license_article_id')->all(); + } + + /** + * @param array $attributes + */ + private function assertAttributes(array $attributes): void + { + if (! in_array($attributes['term_rule'], ['dauerhaft', 'befristet', 'solange_angebot_aktiv', 'periodisch'], true)) { + throw new DomainRuleException('Die Laufzeitregel der Angebotsfassung ist unbekannt.'); + } + + if (! in_array($attributes['grant_kind'], ['kauf', 'bei_registrierung', 'auf_abruf'], true)) { + throw new DomainRuleException('Die Vergabeart der Angebotsfassung ist unbekannt.'); + } + + if (! in_array($attributes['holder_kind'], ['person', 'organisation'], true)) { + throw new DomainRuleException('Die Inhaberart der Angebotsfassung ist Person oder Organisation.'); + } + + if ($attributes['update_promise'] !== 'alle_freigegebenen_fassungen') { + throw new DomainRuleException('Die Updatezusage umfasst alle später freigegebenen Fassungen des Artikels.'); + } + } + + /** + * @param list $lines + * @return list + */ + /** + * @param list $lines + * @param array $attributes + */ + private function assertCoverage(array $lines, array $attributes): void + { + $versionId = $attributes['composition_version_id'] ?? null; + + if ($versionId === null) { + return; + } + + $version = CompositionVersion::query()->findOrFail($versionId); + $articles = []; + + foreach ($lines as $line) { + if ($line['target'] instanceof LicenseArticle) { + $articles[] = $line['target']; + } + } + + $missing = app(OfferCoverage::class)->missingLeaves($version, $articles); + + if ($missing !== []) { + throw new DomainRuleException('Das Angebot deckt nicht alle Blätter: '.implode(', ', $missing)); + } + } + + private function scopeFor(array $lines): array + { + $scope = []; + + foreach ($lines as $line) { + $target = $line['target']; + $rights = $line['rights']; + + if ($target instanceof BundleVersion && $target->status !== BundleStatus::Veroeffentlicht) { + throw new DomainRuleException('Eine Angebotsfassung enthält nur veröffentlichte Paketfassungen.'); + } + + $articleIds = match (true) { + $target instanceof LicenseArticle => [$target->id], + $target instanceof BundleVersion => $this->bundles->articleIds($target), + default => throw new DomainRuleException('Eine Angebotsposition zeigt auf einen Lizenzartikel oder eine Paketfassung.'), + }; + + foreach ($articleIds as $articleId) { + $key = $articleId.'-'.$rights->id; + $scope[$key] = [ + 'license_article_id' => $articleId, + 'rights_profile_version_id' => $rights->id, + ]; + } + } + + return array_values($scope); + } +} diff --git a/app/Domain/Catalog/OfferStatus.php b/app/Domain/Catalog/OfferStatus.php new file mode 100644 index 0000000..65e7916 --- /dev/null +++ b/app/Domain/Catalog/OfferStatus.php @@ -0,0 +1,10 @@ + OfferStatus::class, + 'dynamic' => 'boolean', + 'activated_at' => 'datetime', + ]; + } + + protected static function booted(): void + { + static::updating(function (OfferVersion $version): void { + $original = StatusValue::of($version->getOriginal('status')); + $next = StatusValue::of($version->status); + + if ($original === OfferStatus::Beendet->value) { + throw new DomainRuleException('Eine beendete Angebotsfassung ist unveränderlich.'); + } + + if ($original === OfferStatus::Aktiv->value) { + if ($next !== OfferStatus::Beendet->value) { + throw new DomainRuleException('Eine aktive Angebotsfassung lässt sich nur durch Beendigung schließen.'); + } + + $dirty = $version->getDirty(); + unset($dirty['status'], $dirty['updated_at']); + + if ($dirty !== []) { + throw new DomainRuleException('Eine aktive Angebotsfassung lässt sich nur durch Beendigung schließen.'); + } + } + }); + } + + public function offer(): BelongsTo + { + return $this->belongsTo(Offer::class); + } + + public function lines(): HasMany + { + return $this->hasMany(OfferLine::class)->orderBy('position'); + } + + public function resolvedScopes(): HasMany + { + return $this->hasMany(ResolvedScope::class); + } +} diff --git a/app/Domain/Catalog/Pillar.php b/app/Domain/Catalog/Pillar.php new file mode 100644 index 0000000..91e4998 --- /dev/null +++ b/app/Domain/Catalog/Pillar.php @@ -0,0 +1,50 @@ + 'datetime', + ]; + } + + public function elements(): BelongsToMany + { + return $this->belongsToMany(ContentElement::class); + } + + public function pages(): BelongsToMany + { + return $this->belongsToMany(Page::class); + } + + /** + * @param Builder $query + * @return Builder + */ + public function scopePublished(Builder $query): Builder + { + return $query->whereNotNull('published_at')->orderBy('sort_order')->orderBy('name'); + } + + public function publicUrl(): string + { + return route('theme', ['slug' => $this->slug]); + } +} diff --git a/app/Domain/Catalog/PillarService.php b/app/Domain/Catalog/PillarService.php new file mode 100644 index 0000000..c8f14df --- /dev/null +++ b/app/Domain/Catalog/PillarService.php @@ -0,0 +1,126 @@ +name($name); + + if (Pillar::query()->where('name', $name)->exists()) { + throw new DomainRuleException('Diese fachliche Säule gibt es schon.'); + } + + return Pillar::query()->create([ + 'name' => $name, + 'slug' => $this->uniqueSlug(Str::slug($name, '-', 'de')), + ]); + } + + public function present(Pillar $pillar, string $name, string $slug, ?string $summary, bool $published, int $sortOrder): void + { + $name = $this->name($name); + + if (Pillar::query()->where('name', $name)->whereKeyNot($pillar->id)->exists()) { + throw new DomainRuleException('Diese fachliche Säule gibt es schon.'); + } + + $summary = trim((string) $summary); + $pillar->name = $name; + $pillar->slug = $this->slug($slug, $pillar->id); + $pillar->public_summary = $summary === '' ? null : $summary; + $pillar->sort_order = max(0, $sortOrder); + $pillar->published_at = $published ? ($pillar->published_at ?? now()) : null; + $pillar->save(); + } + + public function delete(Pillar $pillar): void + { + if ($pillar->elements()->exists() || $pillar->pages()->exists()) { + throw new DomainRuleException('Eine Säule mit zugeordneten Medien oder Seiten wird nicht gelöscht.'); + } + + $pillar->delete(); + } + + /** + * @param list $pillarIds + */ + public function assign(ContentElement $element, array $pillarIds): void + { + $element->pillars()->sync($this->ids($pillarIds)); + } + + /** + * @param list $pillarIds + */ + public function assignPages(Page $page, array $pillarIds): void + { + $page->pillars()->sync($this->ids($pillarIds)); + } + + /** + * @param list $pillarIds + * @return list + */ + private function ids(array $pillarIds): array + { + $ids = array_values(array_unique(array_map(intval(...), $pillarIds))); + + if (Pillar::query()->whereIn('id', $ids)->count() !== count($ids)) { + throw new DomainRuleException('Eine fachliche Säule fehlt.'); + } + + return $ids; + } + + private function slug(string $slug, ?int $ignoreId = null): string + { + $slug = Str::slug($slug, '-', 'de'); + + if ($slug === '') { + throw new DomainRuleException('Die öffentliche Adresse der Säule fehlt.'); + } + + $existing = Pillar::query()->where('slug', $slug); + + if ($ignoreId !== null) { + $existing->whereKeyNot($ignoreId); + } + + if ($existing->exists()) { + throw new DomainRuleException('Diese öffentliche Adresse ist schon vergeben.'); + } + + return $slug; + } + + private function uniqueSlug(string $base): string + { + $base = $base !== '' ? $base : 'saeule'; + $slug = $base; + $suffix = 2; + + while (Pillar::query()->where('slug', $slug)->exists()) { + $slug = $base.'-'.$suffix; + $suffix++; + } + + return $slug; + } + + private function name(string $name): string + { + $name = trim($name); + + if ($name === '') { + throw new DomainRuleException('Der Name der fachlichen Säule fehlt.'); + } + + return $name; + } +} diff --git a/app/Domain/Catalog/PresentationAssignment.php b/app/Domain/Catalog/PresentationAssignment.php new file mode 100644 index 0000000..3bdba06 --- /dev/null +++ b/app/Domain/Catalog/PresentationAssignment.php @@ -0,0 +1,33 @@ +belongsTo(PresentationRole::class, 'presentation_role_id'); + } + + public function element(): BelongsTo + { + return $this->belongsTo(ContentElement::class, 'content_element_id'); + } + + public function sourceVersion(): BelongsTo + { + return $this->belongsTo(ContentElementVersion::class, 'source_version_id'); + } +} diff --git a/app/Domain/Catalog/PresentationMedia.php b/app/Domain/Catalog/PresentationMedia.php new file mode 100644 index 0000000..cf2b33c --- /dev/null +++ b/app/Domain/Catalog/PresentationMedia.php @@ -0,0 +1,515 @@ +> + */ + public function rows(Model $subject): array + { + $assignments = PresentationAssignment::query() + ->with(['role', 'element.editorialContentKind', 'sourceVersion']) + ->where('subject_type', $subject->getMorphClass()) + ->where('subject_id', $subject->getKey()) + ->orderBy('position') + ->orderBy('id') + ->get(); + + $rows = []; + + foreach ($assignments as $assignment) { + $element = $assignment->element; + $released = $element instanceof ContentElement && $this->website->present($element) !== null; + $binding = $this->binding($assignment); + + $rows[] = [ + 'id' => $assignment->id, + 'role' => (string) $assignment->role?->slug, + 'role_label' => (string) ($assignment->role?->label ?? ''), + 'ordered' => (bool) $assignment->role?->ordered, + 'position' => (int) $assignment->position, + 'standard' => $assignment->role?->slug === 'titelbild', + 'element_id' => (int) $assignment->content_element_id, + 'title' => $element instanceof ContentElement + ? (string) ($element->display_title ?: $element->working_title) + : 'Medium fehlt', + 'image' => $element instanceof ContentElement + ? ThumbnailRef::url('editorial.card', 'element', $element->id, $element->thumbnail_path) + : null, + 'kind' => $element?->editorialContentKind?->label, + 'output' => $element instanceof ContentElement ? (string) $element->output_class : '', + 'released' => $released, + 'release_label' => $released ? 'Für die Website freigegeben' : 'Nicht für die Website freigegeben', + 'binding' => $binding, + ]; + } + + return $rows; + } + + /** + * Gespeicherte Zuordnungen als bearbeitbarer Arbeitsstand, nach Rolle und Position geordnet. + * + * @return list + */ + public function staged(Model $subject): array + { + $assignments = PresentationAssignment::query() + ->with('role') + ->where('subject_type', $subject->getMorphClass()) + ->where('subject_id', $subject->getKey()) + ->get() + ->sortBy(fn (PresentationAssignment $row): string => sprintf('%05d-%05d-%08d', (int) $row->role?->sort_order, (int) $row->position, (int) $row->id)) + ->values(); + + $rows = []; + + foreach ($assignments as $assignment) { + $rows[] = [ + 'key' => 'a'.$assignment->id, + 'id' => (int) $assignment->id, + 'role' => (string) $assignment->role?->slug, + 'element_id' => (int) $assignment->content_element_id, + 'source' => $assignment->source_version_id !== null ? (int) $assignment->source_version_id : null, + ]; + } + + return $rows; + } + + /** + * Anzeigezeilen für einen Arbeitsstand, gruppiert nach Rolle. Liest nur, schreibt nichts. + * + * @param list $staged + * @return list>}> + */ + public function describe(array $staged): array + { + $roles = PresentationRole::query()->orderBy('sort_order')->get()->keyBy('slug'); + $elements = ContentElement::query() + ->with('editorialContentKind') + ->whereIn('id', array_values(array_unique(array_map(fn (array $row): int => (int) $row['element_id'], $staged)))) + ->get() + ->keyBy('id'); + $sources = ContentElementVersion::query() + ->whereIn('id', array_values(array_filter(array_map(fn (array $row): ?int => $row['source'] ?? null, $staged)))) + ->get() + ->keyBy('id'); + $groups = []; + + foreach ($roles as $slug => $role) { + $rows = array_values(array_filter($staged, fn (array $row): bool => $row['role'] === $slug)); + + if ($rows === []) { + continue; + } + + $described = []; + + foreach ($rows as $row) { + $element = $elements->get((int) $row['element_id']); + $released = $element instanceof ContentElement && $this->website->present($element) !== null; + $source = $row['source'] !== null ? $sources->get((int) $row['source']) : null; + + $described[] = [ + 'key' => $row['key'], + 'id' => $row['id'], + 'element_id' => (int) $row['element_id'], + 'title' => $element instanceof ContentElement + ? (string) ($element->display_title ?: $element->working_title) + : 'Medium fehlt', + 'image' => $element instanceof ContentElement + ? ThumbnailRef::url('editorial.card', 'element', $element->id, $element->thumbnail_path) + : null, + 'kind' => $element?->editorialContentKind?->label, + 'output' => $element instanceof ContentElement ? (string) $element->output_class : '', + 'released' => $released, + 'release_label' => $released ? 'Für die Website freigegeben' : 'Nicht für die Website freigegeben', + 'binding' => $source instanceof ContentElementVersion ? $this->bindingFor($source) : null, + 'new' => $row['id'] === null, + ]; + } + + $groups[] = [ + 'role' => (string) $slug, + 'label' => PresentationRole::displayLabel((string) $slug, (string) $role->label), + 'multiple' => (bool) $role->multiple, + 'ordered' => (bool) $role->ordered, + 'rows' => $described, + ]; + } + + return $groups; + } + + /** + * Prüft, ob ein Medium im Arbeitsstand einer Rolle zugeordnet werden darf. Liefert den Ablehnungsgrund oder null. + */ + public function refusal(Model $subject, string $roleSlug, int $elementId): ?string + { + $role = PresentationRole::query()->where('slug', $roleSlug)->first(); + $element = ContentElement::query()->find($elementId); + + if (! $role instanceof PresentationRole || ! $element instanceof ContentElement) { + return 'Rolle oder Medium fehlt.'; + } + + if ($element->archived_at !== null) { + return 'Ein archiviertes Medium wird nicht zugeordnet.'; + } + + if ($subject instanceof ContentElement && (int) $subject->getKey() === (int) $element->id) { + return 'Ein Medium kann nicht seine eigene Präsentation sein.'; + } + + return null; + } + + /** + * Schreibt einen Arbeitsstand: entfernte Zuordnungen lösen, neue anlegen, Bindung und Reihenfolge je Rolle setzen. + * Medien, Fassungen und Website-Freigaben bleiben unberührt. + * + * Mit $baseline (dem beim Laden gelesenen Stand) werden nur Zuordnungen gelöst, die dort standen und im + * Arbeitsstand fehlen. Was inzwischen an anderer Stelle hinzugekommen ist, bleibt erhalten. + * + * @param list $staged + * @param list|null $baseline + */ + public function commit(Model $subject, array $staged, ?User $actor = null, ?array $baseline = null): void + { + $roles = PresentationRole::query()->get()->keyBy('slug'); + $seen = []; + + foreach ($staged as $row) { + $role = $roles->get($row['role']); + + if (! $role instanceof PresentationRole) { + throw new DomainRuleException('Diese Rolle gibt es nicht.'); + } + + $refusal = $this->refusal($subject, $row['role'], (int) $row['element_id']); + + if ($refusal !== null) { + throw new DomainRuleException($refusal); + } + + $pair = $row['role'].':'.$row['element_id']; + + if (isset($seen[$pair])) { + throw new DomainRuleException('Ein Medium steht in derselben Rolle nur einmal.'); + } + + $seen[$pair] = true; + $count = count(array_filter($staged, fn (array $other): bool => $other['role'] === $row['role'])); + + if (! $role->multiple && $count > 1) { + throw new DomainRuleException($role->label.' hat nur eine Zuordnung.'); + } + + $element = ContentElement::query()->findOrFail((int) $row['element_id']); + $this->checkedSource($subject, $element, $row['source']); + } + + DB::transaction(function () use ($subject, $staged, $roles, $actor, $baseline): void { + $existing = PresentationAssignment::query() + ->with(['role', 'element']) + ->where('subject_type', $subject->getMorphClass()) + ->where('subject_id', $subject->getKey()) + ->get() + ->keyBy('id'); + $kept = array_filter(array_map(fn (array $row): ?int => $row['id'], $staged)); + $known = $baseline === null ? null : array_filter(array_map(fn (array $row): ?int => $row['id'], $baseline)); + + foreach ($existing as $id => $assignment) { + $wasLoaded = $known === null || in_array((int) $id, $known, true); + $replacedSingle = ! (bool) $assignment->role?->multiple + && ! in_array((int) $id, $kept, true) + && array_filter($staged, fn (array $row): bool => $row['role'] === $assignment->role?->slug) !== []; + + if (! in_array((int) $id, $kept, true) && ($wasLoaded || $replacedSingle)) { + $this->record($subject, ($assignment->role?->label ?? 'Präsentation').': '.($assignment->element?->working_title ?? ''), null, $actor); + $assignment->delete(); + } + } + + $positions = []; + + foreach ($staged as $row) { + $role = $roles->get($row['role']); + $position = $positions[$row['role']] = ($positions[$row['role']] ?? 0) + 1; + $assignment = $row['id'] !== null ? $existing->get($row['id']) : null; + + if ($assignment instanceof PresentationAssignment) { + $changed = (int) $assignment->position !== $position + || (int) ($assignment->source_version_id ?? 0) !== (int) ($row['source'] ?? 0); + $assignment->position = $position; + $assignment->source_version_id = $row['source']; + + if ($changed) { + $assignment->save(); + } + + continue; + } + + $element = ContentElement::query()->findOrFail((int) $row['element_id']); + $same = PresentationAssignment::query() + ->where('subject_type', $subject->getMorphClass()) + ->where('subject_id', $subject->getKey()) + ->where('presentation_role_id', $role->id) + ->where('content_element_id', $element->id) + ->first(); + + if ($same instanceof PresentationAssignment) { + $same->position = $position; + $same->source_version_id = $row['source']; + $same->save(); + + continue; + } + + PresentationAssignment::query()->create([ + 'subject_type' => $subject->getMorphClass(), + 'subject_id' => $subject->getKey(), + 'content_element_id' => $element->id, + 'presentation_role_id' => $role->id, + 'position' => $position, + 'source_version_id' => $row['source'], + ]); + $this->record($subject, null, $role->label.': '.$element->working_title, $actor); + } + }); + } + + public function assign(Model $subject, string $roleSlug, int $elementId, ?int $sourceVersionId, ?User $actor = null): string + { + $role = PresentationRole::query()->where('slug', $roleSlug)->first(); + $element = ContentElement::query()->find($elementId); + + if (! $role instanceof PresentationRole || ! $element instanceof ContentElement) { + throw new DomainRuleException('Rolle oder Medium fehlt.'); + } + + if ($element->archived_at !== null) { + throw new DomainRuleException('Ein archiviertes Medium wird nicht zugeordnet.'); + } + + if ($subject instanceof ContentElement && (int) $subject->getKey() === (int) $element->id) { + throw new DomainRuleException('Ein Medium kann nicht seine eigene Präsentation sein.'); + } + + $source = $this->checkedSource($subject, $element, $sourceVersionId); + + $existing = PresentationAssignment::query() + ->where('subject_type', $subject->getMorphClass()) + ->where('subject_id', $subject->getKey()) + ->where('presentation_role_id', $role->id) + ->where('content_element_id', $element->id) + ->first(); + + if ($existing instanceof PresentationAssignment) { + if ((int) $existing->source_version_id !== (int) ($source?->id ?? 0) && ($source !== null || $existing->source_version_id !== null)) { + $existing->source_version_id = $source?->id; + $existing->save(); + $this->record($subject, null, $role->label.': '.$element->working_title, $actor); + } + + return $element->working_title.' ist in dieser Rolle bereits zugeordnet.'; + } + + if (! $role->multiple) { + PresentationAssignment::query() + ->where('subject_type', $subject->getMorphClass()) + ->where('subject_id', $subject->getKey()) + ->where('presentation_role_id', $role->id) + ->delete(); + } + + $position = (int) PresentationAssignment::query() + ->where('subject_type', $subject->getMorphClass()) + ->where('subject_id', $subject->getKey()) + ->where('presentation_role_id', $role->id) + ->max('position') + 1; + + PresentationAssignment::query()->create([ + 'subject_type' => $subject->getMorphClass(), + 'subject_id' => $subject->getKey(), + 'content_element_id' => $element->id, + 'presentation_role_id' => $role->id, + 'position' => max(1, $position), + 'source_version_id' => $source?->id, + ]); + + $this->record($subject, null, $role->label.': '.$element->working_title, $actor); + + return $element->working_title.' ist als '.$role->label.' zugeordnet. Es entsteht keine Fassung und keine Freigabe.'; + } + + public function detach(Model $subject, int $assignmentId, ?User $actor = null): string + { + $assignment = $this->owned($subject, $assignmentId); + $label = ($assignment->role?->label ?? 'Präsentation').': '.($assignment->element?->working_title ?? ''); + $assignment->delete(); + $this->record($subject, $label, null, $actor); + + return 'Die Zuordnung ist entfernt. Das Medium bleibt im Bestand.'; + } + + public function move(Model $subject, int $assignmentId, int $direction, ?User $actor = null): void + { + $assignment = $this->owned($subject, $assignmentId); + + if (! $assignment->role?->ordered || $direction === 0) { + return; + } + + $neighbors = PresentationAssignment::query() + ->where('subject_type', $subject->getMorphClass()) + ->where('subject_id', $subject->getKey()) + ->where('presentation_role_id', $assignment->presentation_role_id) + ->orderBy('position') + ->orderBy('id') + ->get() + ->values(); + + $index = $neighbors->search(fn (PresentationAssignment $row): bool => $row->id === $assignment->id); + + if ($index === false) { + return; + } + + $swap = $index + ($direction < 0 ? -1 : 1); + $other = $neighbors->get($swap); + + if (! $other instanceof PresentationAssignment) { + return; + } + + $position = $assignment->position; + $assignment->position = $other->position === $position ? $position + ($direction < 0 ? -1 : 1) : $other->position; + $other->position = $position; + $assignment->save(); + $other->save(); + $this->record($subject, null, 'Reihenfolge '.$assignment->role?->label, $actor); + } + + /** + * Kennung des ersten Titel- oder Galeriebildes. Ob es öffentlich erscheint, entscheidet WebsiteMedia. + */ + public function coverElementId(Model $subject): ?int + { + $assignments = PresentationAssignment::query() + ->with('role') + ->where('subject_type', $subject->getMorphClass()) + ->where('subject_id', $subject->getKey()) + ->orderBy('position') + ->get(); + + foreach (PresentationRole::COVER_ROLES as $slug) { + $match = $assignments->first(fn (PresentationAssignment $row): bool => $row->role?->slug === $slug); + + if ($match instanceof PresentationAssignment) { + return (int) $match->content_element_id; + } + } + + return null; + } + + private function owned(Model $subject, int $assignmentId): PresentationAssignment + { + $assignment = PresentationAssignment::query() + ->with(['role', 'element']) + ->where('subject_type', $subject->getMorphClass()) + ->where('subject_id', $subject->getKey()) + ->whereKey($assignmentId) + ->first(); + + if (! $assignment instanceof PresentationAssignment) { + throw new DomainRuleException('Diese Zuordnung gehört zu einem anderen Objekt.'); + } + + return $assignment; + } + + private function checkedSource(Model $subject, ContentElement $element, ?int $sourceVersionId): ?ContentElementVersion + { + if ($sourceVersionId === null) { + return null; + } + + $version = ContentElementVersion::query()->find($sourceVersionId); + + if (! $version instanceof ContentElementVersion) { + throw new DomainRuleException('Die gebundene Fassung fehlt.'); + } + + $ownsFilm = $subject instanceof ContentElement && (int) $version->content_element_id === (int) $subject->getKey(); + $ownsClip = (int) $version->content_element_id === (int) $element->id; + + if (! $ownsFilm && ! $ownsClip) { + throw new DomainRuleException('Die gebundene Fassung gehört weder zum Fachobjekt noch zum zugeordneten Medium.'); + } + + return $version; + } + + /** + * @return array{label: string, stale: bool}|null + */ + private function binding(PresentationAssignment $assignment): ?array + { + if ($assignment->source_version_id === null || ! $assignment->sourceVersion instanceof ContentElementVersion) { + return null; + } + + return $this->bindingFor($assignment->sourceVersion); + } + + /** + * @return array{label: string, stale: bool} + */ + private function bindingFor(ContentElementVersion $version): array + { + $latestId = ContentElementVersion::query() + ->where('content_element_id', $version->content_element_id) + ->where('status', ContentVersionStatus::Bereit) + ->orderByDesc('number') + ->value('id'); + $stale = $latestId !== null && (int) $latestId !== (int) $version->id; + + return [ + 'label' => $stale + ? 'Gebunden an Fassung '.$version->number.'. Die aktuelle Fassung ist eine andere. Der Clip wurde nicht neu erzeugt.' + : 'Gebunden an Fassung '.$version->number.'.', + 'stale' => $stale, + ]; + } + + private function record(Model $subject, ?string $before, ?string $after, ?User $actor): void + { + IdentityChange::query()->create([ + 'subject_type' => $subject->getMorphClass(), + 'subject_id' => $subject->getKey(), + 'field' => 'praesentation', + 'before' => $before, + 'after' => $after, + 'actor_id' => $actor?->id, + 'occurred_at' => now(), + ]); + } +} diff --git a/app/Domain/Catalog/PresentationRole.php b/app/Domain/Catalog/PresentationRole.php new file mode 100644 index 0000000..37638bf --- /dev/null +++ b/app/Domain/Catalog/PresentationRole.php @@ -0,0 +1,60 @@ + 'boolean', + 'ordered' => 'boolean', + ]; + } + + public function assignments(): HasMany + { + return $this->hasMany(PresentationAssignment::class); + } + + /** + * @return array + */ + public static function selectOptions(): array + { + return static::query()->orderBy('sort_order')->pluck('label', 'slug')->all(); + } + + /** + * Kurze Bezeichnung für Überschriften und Auswahl in der Verwaltung. + */ + public static function displayLabel(string $slug, string $label): string + { + return match ($slug) { + 'titelbild' => 'Titelbild', + 'titelbild_alternativ' => 'Alternative Titelbilder', + 'trailer' => 'Trailer', + 'vorschauclip' => 'Vorschauclips', + 'interview' => 'Interviews', + 'galerie' => 'Galerie', + default => $label, + }; + } +} diff --git a/app/Domain/Catalog/ReleaseContent.php b/app/Domain/Catalog/ReleaseContent.php new file mode 100644 index 0000000..bdb3a4c --- /dev/null +++ b/app/Domain/Catalog/ReleaseContent.php @@ -0,0 +1,42 @@ +whereKey($content->article_release_id)->value('status')); + + if ($status !== ReleaseStatus::Entwurf->value) { + throw new DomainRuleException('Der Inhalt eines Artikel-Stands wird nur im Entwurf festgeschrieben.'); + } + }); + + static::updating(function (): void { + throw new DomainRuleException('Der festgeschriebene Inhalt eines Artikel-Stands ist unveränderlich.'); + }); + } + + public function release(): BelongsTo + { + return $this->belongsTo(ArticleRelease::class, 'article_release_id'); + } + + public function elementVersion(): BelongsTo + { + return $this->belongsTo(ContentElementVersion::class, 'content_element_version_id'); + } +} diff --git a/app/Domain/Catalog/ReleaseStatus.php b/app/Domain/Catalog/ReleaseStatus.php new file mode 100644 index 0000000..dd3ad93 --- /dev/null +++ b/app/Domain/Catalog/ReleaseStatus.php @@ -0,0 +1,11 @@ +belongsTo(OfferVersion::class); + } + + public function article(): BelongsTo + { + return $this->belongsTo(LicenseArticle::class, 'license_article_id'); + } + + public function rights(): BelongsTo + { + return $this->belongsTo(RightsProfileVersion::class, 'rights_profile_version_id'); + } +} diff --git a/app/Domain/Catalog/ResolvedText.php b/app/Domain/Catalog/ResolvedText.php new file mode 100644 index 0000000..6aae73b --- /dev/null +++ b/app/Domain/Catalog/ResolvedText.php @@ -0,0 +1,17 @@ +hasMany(RightsProfileVersion::class); + } +} diff --git a/app/Domain/Catalog/RightsProfileVersion.php b/app/Domain/Catalog/RightsProfileVersion.php new file mode 100644 index 0000000..7828615 --- /dev/null +++ b/app/Domain/Catalog/RightsProfileVersion.php @@ -0,0 +1,41 @@ + 'array', + 'options' => 'array', + 'locked_at' => 'datetime', + ]; + } + + protected static function booted(): void + { + static::updating(function (RightsProfileVersion $version): void { + if ($version->getOriginal('locked_at') !== null) { + throw new DomainRuleException('Eine verwendete Rechteprofil-Fassung ist unveränderlich.'); + } + }); + } + + public function profile(): BelongsTo + { + return $this->belongsTo(RightsProfile::class, 'rights_profile_id'); + } +} diff --git a/app/Domain/Catalog/StatusValue.php b/app/Domain/Catalog/StatusValue.php new file mode 100644 index 0000000..aee0342 --- /dev/null +++ b/app/Domain/Catalog/StatusValue.php @@ -0,0 +1,13 @@ +value : $status; + } +} diff --git a/app/Domain/Catalog/StructureNode.php b/app/Domain/Catalog/StructureNode.php new file mode 100644 index 0000000..00efe01 --- /dev/null +++ b/app/Domain/Catalog/StructureNode.php @@ -0,0 +1,58 @@ + + * } + */ +readonly class StructureNode +{ + /** + * @param list $children + */ + public function __construct( + public string $role, + public int $position, + public ?int $compositionVersionId, + public ?int $compositionId, + public ?int $contentElementVersionId, + public ?int $contentElementId, + public ?string $editorialKindLabel, + public ?string $technicalKindLabel, + public ?string $outputClass, + public string $title, + public array $children = [], + ) {} + + /** + * @return array + */ + public function toArray(): array + { + return [ + 'role' => $this->role, + 'position' => $this->position, + 'composition_version_id' => $this->compositionVersionId, + 'composition_id' => $this->compositionId, + 'content_element_version_id' => $this->contentElementVersionId, + 'content_element_id' => $this->contentElementId, + 'editorial_kind' => $this->editorialKindLabel, + 'technical_kind' => $this->technicalKindLabel, + 'output_class' => $this->outputClass, + 'title' => $this->title, + 'children' => array_map(fn (StructureNode $child): array => $child->toArray(), $this->children), + ]; + } +} diff --git a/app/Domain/Cms/Catalog/CardSubject.php b/app/Domain/Cms/Catalog/CardSubject.php new file mode 100644 index 0000000..902a185 --- /dev/null +++ b/app/Domain/Cms/Catalog/CardSubject.php @@ -0,0 +1,59 @@ + $meta reine Anzeigetexte aus Fachdaten + * @param list $missing Hinweise für die Redaktion + */ + public function __construct( + public string $title, + public ?string $summary, + public string $kind, + public ?string $badge, + public array $meta, + public ?string $url, + public bool $public, + public ?string $notice = null, + public ?string $visual = null, + public ?string $visualLabel = null, + public ?string $previewImage = null, + public array $missing = [], + public ?string $style = null, + ) {} + + public function withText(?string $title, ?string $summary): self + { + return new self( + title: $title ?? $this->title, + summary: $summary ?? $this->summary, + kind: $this->kind, + badge: $this->badge, + meta: $this->meta, + url: $this->url, + public: $this->public, + notice: $this->notice, + visual: $this->visual, + visualLabel: $this->visualLabel, + previewImage: $this->previewImage, + missing: $this->missing, + style: $this->style, + ); + } +} diff --git a/app/Domain/Cms/Catalog/CatalogEntry.php b/app/Domain/Cms/Catalog/CatalogEntry.php new file mode 100644 index 0000000..a4051db --- /dev/null +++ b/app/Domain/Cms/Catalog/CatalogEntry.php @@ -0,0 +1,18 @@ + + */ + public function publicPrograms(): Collection + { + $kind = EditorialContentKind::query()->where('slug', 'programm')->first(); + + if ($kind === null) { + return collect(); + } + + return Composition::query() + ->where('editorial_content_kind_id', $kind->id) + ->orderBy('designation') + ->get() + ->filter(fn (Composition $composition): bool => $this->shownVersion($composition) !== null) + ->values(); + } + + /** + * Gezeigte Fassung einer öffentlich gezeigten Komposition, sonst null. + */ + public function shownVersion(Composition $composition): ?CompositionVersion + { + if (! in_array($composition->editorialContentKind?->slug, self::PUBLIC_KINDS, true)) { + return null; + } + + return $this->releases->highestReleasedVersion($composition); + } + + public function isPublic(Composition $composition): bool + { + return $this->shownVersion($composition) !== null; + } + + /** + * Wählbar sind Programme und Module mit zur Anzeige freigegebener Fassung, die nicht archiviert sind. + */ + public function isSelectable(Composition $composition): bool + { + return $composition->archived_at === null + && in_array($composition->editorialContentKind?->slug, self::SELECTABLE_KINDS, true) + && $this->releases->highestReleasedVersion($composition) !== null; + } + + /** + * Suchtreffer für die Auswahl im Editor: Kennung => Bezeichnung mit Sichtbarkeitshinweis. + * + * @return array + */ + public function search(?string $term, int $limit = 25): array + { + $term = trim((string) $term); + + $candidates = Composition::query() + ->with('editorialContentKind') + ->whereNull('archived_at') + ->whereHas('editorialContentKind', fn ($query) => $query->whereIn('slug', self::SELECTABLE_KINDS)) + ->when($term !== '', function ($query) use ($term): void { + $like = '%'.mb_strtolower($term).'%'; + $query->where(fn ($inner) => $inner + ->whereRaw('LOWER(designation) LIKE ?', [$like]) + ->orWhereRaw('LOWER(COALESCE(display_title, \'\')) LIKE ?', [$like]) + ->orWhereRaw('LOWER(COALESCE(teaser, \'\')) LIKE ?', [$like]) + ->orWhereRaw('LOWER(COALESCE(search_terms, \'\')) LIKE ?', [$like])); + }) + ->orderBy('designation') + ->limit($limit * 3) + ->get(); + + $options = []; + + foreach ($candidates as $composition) { + if (! $this->isSelectable($composition)) { + continue; + } + + $options[$composition->id] = $this->optionLabel($composition); + + if (count($options) >= $limit) { + break; + } + } + + return $options; + } + + public function labelFor(mixed $id): ?string + { + $composition = is_numeric($id) ? Composition::query()->with('editorialContentKind')->find((int) $id) : null; + + return $composition === null ? null : $this->optionLabel($composition); + } + + /** + * Löst Verweise in Anzeigeeinträge auf. Öffentlich entfallen nicht öffentliche Objekte stillschweigend. + * + * @param list $refs + * @return list + */ + public function entries(array $refs, bool $includeNonPublic): array + { + $ids = []; + foreach ($refs as $ref) { + if (is_array($ref) && ($ref['type'] ?? null) === 'composition' && is_numeric($ref['id'] ?? null)) { + $ids[] = (int) $ref['id']; + } + } + + if ($ids === []) { + return []; + } + + $compositions = Composition::query()->with('editorialContentKind')->whereIn('id', $ids)->get()->keyBy('id'); + $entries = []; + + foreach (array_unique($ids) as $id) { + $composition = $compositions->get($id); + + if ($composition === null || ! $this->isSelectable($composition)) { + continue; + } + + $public = $this->isPublic($composition); + + if (! $public && ! $includeNonPublic) { + continue; + } + + $entries[] = new CatalogEntry( + id: $composition->id, + title: $this->title($composition), + summary: filled($composition->summary) ? (string) $composition->summary : null, + kindLabel: (string) ($composition->editorialContentKind?->label ?? ''), + url: $public ? route('public.program', $composition) : null, + public: $public, + ); + } + + return $entries; + } + + /** + * Für die Programm- oder Modulkarte wählbar: Programm oder Modul, nicht archiviert, mit mindestens einer + * bereitgestellten Fassung. Anders als bei den Katalogkarten ist keine Anzeigefreigabe nötig, damit die Redaktion + * eine Karte vorbereiten kann; öffentlich gilt unverändert isPublic(). + */ + public function isCardSelectable(Composition $composition): bool + { + return $composition->archived_at === null + && in_array($composition->editorialContentKind?->slug, self::SELECTABLE_KINDS, true) + && $this->latestReadyVersion($composition) !== null; + } + + /** + * @return array + */ + public function cardSearch(?string $term, int $limit = 25): array + { + $term = trim((string) $term); + + $candidates = Composition::query() + ->with('editorialContentKind') + ->whereNull('archived_at') + ->whereHas('editorialContentKind', fn ($query) => $query->whereIn('slug', self::SELECTABLE_KINDS)) + ->when($term !== '', function ($query) use ($term): void { + $like = '%'.mb_strtolower($term).'%'; + $query->where(fn ($inner) => $inner + ->whereRaw('LOWER(designation) LIKE ?', [$like]) + ->orWhereRaw('LOWER(COALESCE(display_title, \'\')) LIKE ?', [$like]) + ->orWhereRaw('LOWER(COALESCE(teaser, \'\')) LIKE ?', [$like]) + ->orWhereRaw('LOWER(COALESCE(search_terms, \'\')) LIKE ?', [$like])); + }) + ->orderBy('designation') + ->limit($limit * 3) + ->get(); + + $options = []; + foreach ($candidates as $composition) { + if (! $this->isCardSelectable($composition)) { + continue; + } + + $options[$composition->id] = $this->cardOptionLabel($composition); + + if (count($options) >= $limit) { + break; + } + } + + return $options; + } + + public function cardLabelFor(mixed $id): ?string + { + $composition = is_numeric($id) ? Composition::query()->with('editorialContentKind')->find((int) $id) : null; + + return $composition === null ? null : $this->cardOptionLabel($composition); + } + + /** + * Anzeigedaten für eine Programm- oder Modulkarte (Premium-Karte). + * + * - Öffentlich nur Programme mit Anzeigefreigabe (dieselbe Regel wie /programme), mit Programmseite als Ziel. + * Module haben keine öffentliche Seitenart (ADR-29) und erscheinen nur in der Redaktionsvorschau, ohne Link. + * - Text: Kurzbeschreibung, sonst das Lernziel der gezeigten (öffentlich) bzw. neuesten bereitgestellten Fassung; + * das Lernziel steht auf der öffentlichen Programmseite bereits öffentlich. + * - Zusatzangaben: Zahl der Module, Dauer. Kein Preis, kein Angebot, keine Kaufaktion; eine Karte ist kein + * Lizenzartikel. Das Vorschaubild der Bibliothek erscheint nur in der Redaktionsvorschau. + */ + public function subject(mixed $id, bool $includeNonPublic): ?CardSubject + { + $composition = is_numeric($id) ? Composition::query()->with('editorialContentKind')->find((int) $id) : null; + + if ($composition === null || ! $this->isCardSelectable($composition)) { + return null; + } + + $shown = $this->shownVersion($composition); + $public = $shown !== null && $composition->archived_at === null; + + if (! $public && ! $includeNonPublic) { + return null; + } + + $version = $shown ?? $this->latestReadyVersion($composition); + $program = $composition->editorialContentKind?->slug === 'programm'; + $kind = (string) ($composition->editorialContentKind?->label ?? ($program ? 'Programm' : 'Modul')); + $profile = app(EditorialProfileReader::class)->read($composition, 'kachel'); + $summary = $profile->value('teaser') ?: $profile->value('summary'); + $goal = filled($version?->learning_goal) ? trim((string) $version->learning_goal) : null; + $missing = []; + + if ($summary === null) { + $missing[] = $goal !== null + ? 'Keine Kurzbeschreibung gepflegt; die Karte zeigt das Lernziel.' + : 'Weder Kurzbeschreibung noch Lernziel gepflegt.'; + } + + $meta = []; + if ($version !== null) { + $modules = $version->members() + ->whereNotNull('nested_composition_version_id') + ->with('nestedCompositionVersion.composition.editorialContentKind') + ->get() + ->filter(fn ($member): bool => $member->nestedCompositionVersion?->composition?->editorialContentKind?->slug === 'modul') + ->count(); + + if ($program && $modules > 0) { + $meta[] = $modules === 1 ? '1 Modul' : $modules.' Module'; + } + + if (is_numeric($version->duration_minutes) && (int) $version->duration_minutes > 0) { + $meta[] = 'Dauer '.(int) $version->duration_minutes.' Min.'; + } else { + $missing[] = 'Keine Dauer gepflegt.'; + } + } + + $notice = null; + if (! $public) { + $notice = 'Nur in der Redaktionsvorschau sichtbar: '.($program + ? 'Das Programm hat keine Anzeigefreigabe.' + : 'Für Module gibt es noch keine öffentliche Seitenart (öffentliches Profil, ADR-29); die Karte erhält deshalb keinen Link.'); + } + + return new CardSubject( + title: $profile->value('display_title') ?: $this->title($composition), + summary: $summary ?? $goal, + kind: $kind, + badge: null, + meta: $meta, + url: $public ? route('public.program', $composition) : null, + public: $public, + notice: $notice, + visual: 'catalog', + visualLabel: $kind, + previewImage: $includeNonPublic ? ThumbnailRef::url('editorial.card', 'komposition', (int) $composition->id, $composition->thumbnail_path) : null, + missing: $missing, + ); + } + + private function latestReadyVersion(Composition $composition): ?CompositionVersion + { + return $composition->versions() + ->where('status', ContentVersionStatus::Bereit->value) + ->orderByDesc('number') + ->first(); + } + + private function cardOptionLabel(Composition $composition): string + { + $visibility = match (true) { + $this->isPublic($composition) => 'öffentlich sichtbar', + $composition->editorialContentKind?->slug === 'modul' => 'Modul, nur Redaktionsvorschau', + default => 'ohne Anzeigefreigabe, nur Redaktionsvorschau', + }; + + return $this->title($composition).' · '.($composition->editorialContentKind?->label ?? '').' · '.$visibility; + } + + private function title(Composition $composition): string + { + return (string) ($composition->display_title ?: $composition->designation); + } + + private function optionLabel(Composition $composition): string + { + $visibility = $this->isPublic($composition) ? 'öffentlich sichtbar' : 'nur Redaktionsvorschau'; + + return $this->title($composition).' · '.($composition->editorialContentKind?->label ?? '').' · '.$visibility; + } +} diff --git a/app/Domain/Cms/Catalog/PublicMaterialReader.php b/app/Domain/Cms/Catalog/PublicMaterialReader.php new file mode 100644 index 0000000..4e6b8fc --- /dev/null +++ b/app/Domain/Cms/Catalog/PublicMaterialReader.php @@ -0,0 +1,286 @@ +|null Element-ID => erstes öffentliches Programm */ + private ?array $publicIndex = null; + + public function __construct( + private readonly PublicCatalogReader $catalog, + private readonly CompositionStructureReader $structure, + ) {} + + public function isSelectable(ContentElement $element): bool + { + return $element->archived_at === null + && $element->versions()->where('status', '!=', ContentVersionStatus::Gesperrt->value)->exists(); + } + + public function isReady(ContentElement $element): bool + { + return $element->versions()->where('status', ContentVersionStatus::Bereit->value)->exists(); + } + + /** + * Öffentliches Programm, in dessen gezeigter Fassung das Element vorkommt, sonst null. + * + * @return array{id: int, title: string}|null + */ + public function publicProgramFor(ContentElement $element): ?array + { + return $this->publicIndex()[$element->id] ?? null; + } + + public function isPublic(ContentElement $element): bool + { + return $this->isSelectable($element) + && $this->isReady($element) + && ! in_array($element->editorialContentKind?->slug, self::CONFIDENTIAL_KINDS, true) + && $this->publicProgramFor($element) !== null; + } + + /** + * @return array + */ + public function search(?string $term, int $limit = 25): array + { + $term = trim((string) $term); + + $candidates = ContentElement::query() + ->with('editorialContentKind') + ->whereNull('archived_at') + ->whereHas('versions', fn ($query) => $query->where('status', '!=', ContentVersionStatus::Gesperrt->value)) + ->when($term !== '', function ($query) use ($term): void { + $like = '%'.mb_strtolower($term).'%'; + $query->where(fn ($inner) => $inner + ->whereRaw('LOWER(working_title) LIKE ?', [$like]) + ->orWhereRaw('LOWER(COALESCE(display_title, \'\')) LIKE ?', [$like])); + }) + ->orderBy('working_title') + ->limit($limit) + ->get(); + + $options = []; + foreach ($candidates as $element) { + $options[$element->id] = $this->optionLabel($element); + } + + return $options; + } + + public function labelFor(mixed $id): ?string + { + $element = is_numeric($id) ? ContentElement::query()->with('editorialContentKind')->find((int) $id) : null; + + return $element === null ? null : $this->optionLabel($element); + } + + /** + * Anzeigedaten für eine Karte. Öffentlich null, wenn das Element nicht öffentlich genannt wird. + * + * @param array $draft ungespeicherte Anzeigedaten, nur für die Redaktionsvorschau + */ + public function subject(mixed $id, bool $includeNonPublic, array $draft = []): ?CardSubject + { + $element = is_numeric($id) ? ContentElement::query()->with('editorialContentKind')->find((int) $id) : null; + + if ($element === null || ! $this->isSelectable($element)) { + return null; + } + + $public = $this->isPublic($element); + + if (! $public && ! $includeNonPublic) { + return null; + } + + $shown = clone $element; + + foreach (['working_title', 'display_title', 'summary', 'thumbnail_path', 'thumbnail_alt'] as $field) { + if (! array_key_exists($field, $draft)) { + continue; + } + + $value = $draft[$field]; + $shown->setAttribute($field, is_string($value) && trim($value) === '' ? null : $value); + } + + $program = $this->publicProgramFor($element); + $output = self::outputLabel((string) $shown->output_class); + $film = $shown->output_class === 'film'; + $editorialKind = $element->editorialContentKind?->label; + $summary = filled($shown->summary) ? trim((string) $shown->summary) : null; + $profile = app(EditorialProfileReader::class)->read($shown, 'bibliothek'); + + if (! array_key_exists('summary', $draft) && $profile->origin('summary') === 'variante') { + $summary = $profile->value('summary'); + } elseif ($summary === null && filled($shown->teaser)) { + $summary = trim((string) $shown->teaser); + } + + $title = (string) ($shown->display_title ?: $shown->working_title); + + if (! array_key_exists('display_title', $draft) && $profile->origin('display_title') === 'variante') { + $title = (string) $profile->value('display_title'); + } + + $meta = [$output]; + if ($program !== null) { + $meta[] = 'Im Programm „'.$program['title'].'“'; + } + if ($film) { + $meta[] = 'Vollständiger Film nur mit Lizenz im Mitgliederbereich'; + } + + $missing = []; + if ($summary === null) { + $missing[] = 'Keine Kurzbeschreibung gepflegt (Medium bearbeiten → Kurzbeschreibung).'; + } + if (! filled($shown->display_title)) { + $missing[] = 'Kein Anzeigetitel gepflegt; die Karte zeigt den Arbeitstitel.'; + } + + $previewImage = $includeNonPublic ? ThumbnailRef::url('editorial.card', 'element', (int) $element->id, $shown->thumbnail_path) : null; + + return new CardSubject( + title: $title, + summary: $summary, + kind: filled($editorialKind) ? (string) $editorialKind : $output, + badge: $output, + meta: $meta, + url: $public && $program !== null ? route('public.program', $program['id']) : null, + public: $public, + notice: $public ? null : $this->notice($element, $program), + visual: $film ? 'film' : 'material', + visualLabel: $output, + previewImage: $previewImage, + missing: $missing, + style: $film ? 'media' : 'material', + ); + } + + /** Bezeichnung der Ausgabeart, wie in der Redaktionsstruktur (CompositionRelease::outputLabel). */ + public static function outputLabel(string $outputClass): string + { + return match ($outputClass) { + 'film' => 'Film', + 'audio' => 'Hörstück', + 'bild' => 'Bild', + 'document', 'pdf' => 'Dokument', + default => 'Text', + }; + } + + public function visibilityNote(ContentElement $element): string + { + if ($this->isPublic($element)) { + $program = $this->publicProgramFor($element); + + return 'Öffentlich nur als Teil der Programmseite „'.($program['title'] ?? '').'“. Die Mediendatei wird dabei nicht ausgeliefert.'; + } + + return $this->notice($element, $this->publicProgramFor($element)); + } + + /** + * @param array{id: int, title: string}|null $program + */ + private function notice(ContentElement $element, ?array $program): string + { + $reason = match (true) { + in_array($element->editorialContentKind?->slug, self::CONFIDENTIAL_KINDS, true) => 'Traineranleitungen erscheinen nie öffentlich.', + ! $this->isReady($element) => 'Das Medium hat noch keine bereitgestellte Fassung.', + $program === null => 'Das Medium gehört zu keinem öffentlich gezeigten Programm. Medien haben noch keine eigene öffentliche Freigabe (öffentliches Profil, ADR-29).', + default => 'Das Medium ist nicht öffentlich.', + }; + + return 'Nur in der Redaktionsvorschau sichtbar: '.$reason; + } + + private function optionLabel(ContentElement $element): string + { + $visibility = $this->isPublic($element) + ? 'öffentlich über Programmseite' + : ($this->isReady($element) ? 'nur Redaktionsvorschau' : 'Entwurf, nur Redaktionsvorschau'); + $kind = $element->editorialContentKind?->label ?: self::outputLabel((string) $element->output_class); + + return (string) ($element->display_title ?: $element->working_title).' · '.$kind.' · '.$visibility; + } + + /** + * Index aller Elemente, die in der gezeigten Fassung eines öffentlichen Programms vorkommen (auch verschachtelt). + * + * @return array + */ + private function publicIndex(): array + { + if ($this->publicIndex !== null) { + return $this->publicIndex; + } + + $index = []; + + foreach ($this->catalog->publicPrograms() as $program) { + $version = $this->catalog->shownVersion($program); + + if ($version === null) { + continue; + } + + $entry = ['id' => (int) $program->id, 'title' => (string) ($program->display_title ?: $program->designation)]; + + foreach ($this->elementIds($this->structure->tree($version)) as $elementId) { + $index[$elementId] ??= $entry; + } + } + + return $this->publicIndex = $index; + } + + /** + * @param list $nodes + * @return list + */ + private function elementIds(array $nodes): array + { + $ids = []; + + foreach ($nodes as $node) { + if ($node->contentElementId !== null) { + $ids[] = (int) $node->contentElementId; + } + + array_push($ids, ...$this->elementIds($node->children)); + } + + return $ids; + } +} diff --git a/app/Domain/Cms/NavigationItem.php b/app/Domain/Cms/NavigationItem.php new file mode 100644 index 0000000..80dd1b4 --- /dev/null +++ b/app/Domain/Cms/NavigationItem.php @@ -0,0 +1,114 @@ + 'Kopfzeile (Hauptnavigation)', + 'footer' => 'Fußbereich: Service', + 'footer_contact' => 'Fußbereich: Kontakt', + 'footer_legal' => 'Fußbereich: Rechtliches', + ]; + + /** Spaltenüberschriften im Fußbereich. */ + public const FOOTER_GROUPS = [ + 'footer' => 'Service', + 'footer_contact' => 'Kontakt', + 'footer_legal' => 'Rechtliches', + ]; + + protected $fillable = [ + 'label', + 'page_id', + 'url', + 'placement', + 'sort_order', + 'is_visible', + 'parent_id', + ]; + + protected static function booted(): void + { + // Untermenüs gibt es nur in der Hauptnavigation. + static::saving(function (NavigationItem $item): void { + if ($item->placement !== 'header' && $item->getAttribute('parent_id') !== null) { + $item->parent_id = null; + } + }); + } + + protected function casts(): array + { + return [ + 'is_visible' => 'boolean', + ]; + } + + public function page(): BelongsTo + { + return $this->belongsTo(Page::class); + } + + public function parent(): BelongsTo + { + return $this->belongsTo(self::class, 'parent_id'); + } + + public function children(): HasMany + { + return $this->hasMany(self::class, 'parent_id')->orderBy('sort_order')->orderBy('id'); + } + + /** + * @param Builder $query + */ + public function scopeVisible(Builder $query): void + { + $query->where('is_visible', true); + } + + public function href(): ?string + { + if ($this->page !== null) { + return $this->page->path === '/' ? url('/') : url($this->page->path); + } + + if ($this->url === null || $this->url === '' || ! SafeUrl::isSafe($this->url)) { + return null; + } + + if (str_starts_with($this->url, '/')) { + return url($this->url); + } + + return $this->url; + } + + /** + * Pfad des Ziels innerhalb der Website (für die Kennzeichnung des aktiven Eintrags); null bei externen Zielen. + */ + public function targetPath(): ?string + { + if ($this->page !== null) { + return $this->page->path; + } + + if (is_string($this->url) && str_starts_with($this->url, '/') && ! str_starts_with($this->url, '//')) { + $path = parse_url($this->url, PHP_URL_PATH); + + return is_string($path) ? '/'.trim($path, '/') : null; + } + + return null; + } +} diff --git a/app/Domain/Cms/NavigationItemPolicy.php b/app/Domain/Cms/NavigationItemPolicy.php new file mode 100644 index 0000000..27497dc --- /dev/null +++ b/app/Domain/Cms/NavigationItemPolicy.php @@ -0,0 +1,34 @@ +hasStaffRole(StaffRole::Redakteur); + } + + public function view(User $user, NavigationItem $item): bool + { + return $this->viewAny($user); + } + + public function create(User $user): bool + { + return $this->viewAny($user); + } + + public function update(User $user, NavigationItem $item): bool + { + return $this->viewAny($user); + } + + public function delete(User $user, NavigationItem $item): bool + { + return $this->viewAny($user); + } +} diff --git a/app/Domain/Cms/Page.php b/app/Domain/Cms/Page.php new file mode 100644 index 0000000..f902f44 --- /dev/null +++ b/app/Domain/Cms/Page.php @@ -0,0 +1,63 @@ +hasMany(PageRevision::class)->latest('id'); + } + + public function publishedRevision(): BelongsTo + { + return $this->belongsTo(PageRevision::class, 'published_revision_id'); + } + + public function latestRevision(): HasOne + { + return $this->hasOne(PageRevision::class)->latestOfMany(); + } + + public function navigationItems(): HasMany + { + return $this->hasMany(NavigationItem::class); + } + + public function isPublished(): bool + { + return $this->published_revision_id !== null; + } + + public function publicUrl(): string + { + return $this->path === '/' ? url('/') : url($this->path); + } + + public function publicTitle(): string + { + $revision = $this->publishedRevision; + + if (is_string($revision?->seo_title) && $revision->seo_title !== '') { + return $revision->seo_title; + } + + return $revision?->contentTitle() ?? $this->path; + } + + public function pillars(): BelongsToMany + { + return $this->belongsToMany(Pillar::class)->orderBy('pillars.name'); + } +} diff --git a/app/Domain/Cms/PagePolicy.php b/app/Domain/Cms/PagePolicy.php new file mode 100644 index 0000000..1067386 --- /dev/null +++ b/app/Domain/Cms/PagePolicy.php @@ -0,0 +1,39 @@ +hasStaffRole(StaffRole::Redakteur); + } + + public function view(User $user, Page $page): bool + { + return $this->viewAny($user); + } + + public function create(User $user): bool + { + return $this->viewAny($user); + } + + public function update(User $user, Page $page): bool + { + return $this->viewAny($user); + } + + public function publish(User $user, Page $page): bool + { + return $this->viewAny($user); + } + + public function delete(User $user, Page $page): bool + { + return false; + } +} diff --git a/app/Domain/Cms/PageRevision.php b/app/Domain/Cms/PageRevision.php new file mode 100644 index 0000000..ec1b34f --- /dev/null +++ b/app/Domain/Cms/PageRevision.php @@ -0,0 +1,70 @@ + 'array', + 'sections' => 'array', + 'created_at' => 'datetime', + ]; + } + + public function page(): BelongsTo + { + return $this->belongsTo(Page::class); + } + + public function author(): BelongsTo + { + return $this->belongsTo(User::class, 'created_by'); + } + + /** + * Abschnitte als aktuelle Hüllen. Revisionen ohne Abschnitte (vor Einführung des Rasters) werden als + * einspaltige Abschnitte gelesen. Die gespeicherten Daten bleiben unverändert. + * + * @return list> + */ + public function sections(): array + { + return app(PageSections::class)->read($this->sections, $this->blocks); + } + + /** + * Widgets in Lesereihenfolge als aktuelle Hüllen. + * + * @return list> + */ + public function widgets(): array + { + return app(PageSections::class)->flatten($this->sections()); + } + + /** + * Titel aus dem ersten Überschriften- oder Einstiegs-Widget. + */ + public function contentTitle(): ?string + { + return app(PageSections::class)->pageTitle($this->sections()); + } +} diff --git a/app/Domain/Cms/PageService.php b/app/Domain/Cms/PageService.php new file mode 100644 index 0000000..899dd8c --- /dev/null +++ b/app/Domain/Cms/PageService.php @@ -0,0 +1,160 @@ + $content Abschnitte mit Slots; flache Widgets (Altformat oder Hülle) + * werden als einspaltige Abschnitte übernommen + */ + public function saveRevision(Page $page, array $content, ?string $seoTitle, ?string $seoDescription, ?User $author): PageRevision + { + $sections = $this->sections->normalize($content); + $seoTitle = $seoTitle !== null && $seoTitle !== '' ? $seoTitle : null; + $seoDescription = $seoDescription !== null && $seoDescription !== '' ? $seoDescription : null; + + // Unveränderter Stand: keine weitere Revision (zum Beispiel „Veröffentlichen“ direkt nach dem Speichern). + $latest = $page->revisions()->first(); + if ($latest !== null && $latest->sections === $sections && $latest->seo_title === $seoTitle && $latest->seo_description === $seoDescription) { + return $latest; + } + + return $this->storeRevision($page, $this->sections->flatten($sections), $sections, $seoTitle, $seoDescription, $author); + } + + public function publish(Page $page, PageRevision $revision): void + { + if ($revision->page_id !== $page->id) { + throw ValidationException::withMessages([ + 'revision' => 'Die Revision gehört zu einer anderen Seite.', + ]); + } + + $page->published_revision_id = $revision->id; + $page->save(); + } + + /** + * Legt den Stand einer früheren Revision unverändert als neue Revision an. Abschnitte und Bausteine + * werden nicht umgeschrieben; ältere Formate werden erst beim Lesen angehoben. + */ + public function restore(Page $page, PageRevision $source, ?User $author): PageRevision + { + if ($source->page_id !== $page->id) { + throw ValidationException::withMessages([ + 'revision' => 'Die Revision gehört zu einer anderen Seite.', + ]); + } + + return $this->storeRevision( + $page, + $source->blocks ?? [], + $source->sections, + $source->seo_title, + $source->seo_description, + $author, + ); + } + + /** + * Legt eine neue, unveröffentlichte Seite mit dem zuletzt gespeicherten Stand einer vorhandenen Seite an. + * Die Vorlage bleibt unverändert; spätere Änderungen wirken nicht auf die Kopie. + */ + public function duplicate(Page $source, string $path, ?User $author): Page + { + $revision = $source->latestRevision ?? $source->publishedRevision; + $page = Page::query()->create(['path' => $this->availablePath($path)]); + + $this->saveRevision( + $page, + $revision?->sections() ?? [], + $revision?->seo_title, + $revision?->seo_description, + $author, + ); + + return $page; + } + + /** + * Normalisiert den Pfad und prüft, dass keine andere Seite ihn verwendet. + */ + public function availablePath(string $path, ?Page $except = null): string + { + $path = $this->normalizePath($path); + + $taken = Page::query() + ->where('path', $path) + ->when($except !== null, fn ($query) => $query->whereKeyNot($except->getKey())) + ->exists(); + + if ($taken) { + throw ValidationException::withMessages([ + 'path' => 'Diesen Pfad verwendet bereits eine andere Seite.', + ]); + } + + return $path; + } + + public function normalizePath(string $path): string + { + $path = '/'.trim($path, '/'); + + if ($path === '/') { + return '/'; + } + + $path = mb_strtolower($path); + + if (preg_match('#^/[a-z0-9]+(?:-[a-z0-9]+)*$#', $path) !== 1) { + throw ValidationException::withMessages([ + 'path' => 'Der Pfad darf nur Kleinbuchstaben, Ziffern und Bindestriche enthalten.', + ]); + } + + return $path; + } + + /** + * @param array $blocks flache Widget-Liste (Rollback-Fassung) + * @param array|null $sections Abschnitte; null bei Revisionen aus der Zeit vor dem Raster + */ + private function storeRevision(Page $page, array $blocks, ?array $sections, ?string $seoTitle, ?string $seoDescription, ?User $author): PageRevision + { + $attributes = [ + 'blocks' => array_values($blocks), + 'seo_title' => $seoTitle !== null && $seoTitle !== '' ? $seoTitle : null, + 'seo_description' => $seoDescription !== null && $seoDescription !== '' ? $seoDescription : null, + 'created_by' => $author?->id, + ]; + + // Die Erstbefüllung der Website läuft innerhalb einer frühen Migration, bevor die Spalte existiert. + // Solche Revisionen haben keine Abschnitte und werden beim Lesen als einspaltige Abschnitte gelesen. + if ($sections !== null && Schema::hasColumn('page_revisions', 'sections')) { + $attributes['sections'] = array_values($sections); + } + + $revision = $page->revisions()->create($attributes); + + // „Geändert“ in der Seitenliste zeigt die letzte Bearbeitung, nicht das Anlagedatum. + $page->touch(); + + foreach ($this->sections->mediaPaths($revision->sections()) as $path) { + PublishPublicMedia::dispatch($path); + } + + return $revision; + } +} diff --git a/app/Domain/Cms/PageTemplates.php b/app/Domain/Cms/PageTemplates.php new file mode 100644 index 0000000..57bfe98 --- /dev/null +++ b/app/Domain/Cms/PageTemplates.php @@ -0,0 +1,28 @@ + + */ + public function all(): array + { + return config('cms.templates', [self::DEFAULT => 'site.templates.standard']); + } + + public function viewFor(Page $page): string + { + $templates = $this->all(); + + return $templates[self::DEFAULT]; + } +} diff --git a/app/Domain/Cms/Sections/PageSections.php b/app/Domain/Cms/Sections/PageSections.php new file mode 100644 index 0000000..5fe2883 --- /dev/null +++ b/app/Domain/Cms/Sections/PageSections.php @@ -0,0 +1,360 @@ +|null $sections gespeicherte Abschnitte (Spalte sections) + * @param array|null $blocks flache Bausteinliste (Spalte blocks), nur ohne Abschnitte verwendet + * @return list, slots: list|null>}> + */ + public function read(?array $sections, ?array $blocks = null): array + { + if ($sections === null) { + return $this->wrapWidgets($blocks ?? []); + } + + $result = []; + + foreach (SectionStyle::migrateSpacing(array_values(array_filter($sections, 'is_array')), byVersion: true) as $section) { + $result[] = $this->upcastSection($section); + } + + return $result; + } + + /** + * Schreibpfad: prüft und bereinigt Abschnitte für eine neue Revision. Flache Widgets (ohne „slots“) werden + * als einspaltige Abschnitte übernommen. Alle Fehler der Seite werden gesammelt gemeldet; Schlüssel: + * „sections.N.layout“, „sections.N.style.image“, „sections.N.slots“, „sections.N.slots.M.data.feld“. + * + * @param array $content + * @return list, slots: list|null>}> + */ + public function normalize(array $content): array + { + $items = array_values($content); + + if (count($items) > self::MAX_SECTIONS) { + throw ValidationException::withMessages([ + 'sections' => 'Eine Seite hat höchstens '.self::MAX_SECTIONS.' Abschnitte.', + ]); + } + + $errors = []; + $sections = []; + $seenSectionIds = []; + $seenWidgetIds = []; + $widgetCount = 0; + + // Eingaben mit Abständen der Version 1 (zum Beispiel ältere Aufrufer) werden wie beim Lesen übersetzt. + $migrated = SectionStyle::migrateSpacing(array_map( + fn ($item) => is_array($item) && array_key_exists('slots', $item) ? $item : ['style' => [], 'slots' => [$item]], + $items, + )); + + foreach ($items as $index => $item) { + if (! is_array($item)) { + $errors["sections.$index"] = ['Ein Abschnitt ist unvollständig.']; + + continue; + } + + if (! array_key_exists('slots', $item)) { + $item = ['id' => null, 'layout' => SectionLayouts::DEFAULT, 'style' => [], 'slots' => [$item]]; + } else { + $item['style'] = $migrated[$index]['style'] ?? ($item['style'] ?? []); + } + + $sections[] = $this->normalizeSection($item, $index, $errors, $seenSectionIds, $seenWidgetIds, $widgetCount); + } + + if ($widgetCount > self::MAX_WIDGETS) { + $errors['sections'] = ['Eine Seite enthält höchstens '.self::MAX_WIDGETS.' Widgets.']; + } + + if ($errors !== []) { + throw ValidationException::withMessages($errors); + } + + return $sections; + } + + /** + * Widgets in Lesereihenfolge (Abschnitt für Abschnitt, Slot für Slot). Wird zusätzlich als flache + * Bausteinliste gespeichert, damit ein Code-Rollback auf die Fassung vor den Abschnitten die Inhalte + * weiterhin untereinander darstellt. + * + * @param list> $sections + * @return list> + */ + public function flatten(array $sections): array + { + $widgets = []; + + foreach ($sections as $section) { + $count = SectionLayouts::slotCount($section['layout']); + + foreach (array_slice($section['slots'], 0, $count) as $widget) { + if (is_array($widget)) { + $widgets[] = $widget; + } + } + } + + return $widgets; + } + + /** + * Öffentliche Medien der Seite: Widget-Bilder und Hintergrundbilder der Abschnitte. + * + * @param list> $sections + * @return list + */ + public function mediaPaths(array $sections): array + { + $paths = []; + + foreach ($sections as $section) { + $style = SectionStyle::fromStored($section['style'] ?? []); + if (is_string($style['image']) && PublicMedia::isPublicPath($style['image'])) { + $paths[] = $style['image']; + } + } + + foreach ($this->widgets->mediaPaths($this->flatten($sections)) as $path) { + $paths[] = $path; + } + + return array_values(array_unique($paths)); + } + + /** + * @param list> $sections + */ + public function pageTitle(array $sections): ?string + { + return $this->widgets->pageTitle($this->flatten($sections)); + } + + /** + * @param array $blocks + * @return list, slots: list|null>}> + */ + private function wrapWidgets(array $blocks): array + { + $sections = []; + + foreach ($this->widgets->read($blocks) as $position => $widget) { + $sections[] = [ + 'id' => null, + 'v' => self::VERSION, + 'layout' => SectionLayouts::DEFAULT, + // Bestand vor dem Raster stand in einem durchgehenden Blatt: kompakte Abstände, zwischen den Widgets + // nur einmal (oben kein Abstand ab dem zweiten), wie bisher. + 'style' => ['spacing_top' => $position === 0 ? 'compact' : 'none', 'spacing_bottom' => 'compact', 'gap' => 'normal'] + SectionStyle::DEFAULTS, + 'slots' => [$widget], + ]; + } + + return $sections; + } + + /** + * @param array $section + * @return array{id: ?string, v: int, layout: string, style: array, slots: list|null>} + */ + private function upcastSection(array $section): array + { + $layout = SectionLayouts::has($section['layout'] ?? null) ? $section['layout'] : SectionLayouts::DEFAULT; + $slots = []; + + foreach (array_values(is_array($section['slots'] ?? null) ? $section['slots'] : []) as $slot) { + $slots[] = is_array($slot) ? $this->widgets->upcast($slot) : null; + } + + while (count($slots) < SectionLayouts::slotCount($layout)) { + $slots[] = null; + } + + return [ + 'id' => is_string($section['id'] ?? null) ? $section['id'] : null, + 'v' => self::VERSION, + 'layout' => $layout, + 'style' => SectionStyle::fromStored($section['style'] ?? []), + 'slots' => $slots, + ]; + } + + /** + * @param array $section + * @param array> $errors + * @param array $seenSectionIds + * @param array $seenWidgetIds + * @return array{id: string, v: int, layout: string, style: array, slots: list|null>} + */ + private function normalizeSection(array $section, int $index, array &$errors, array &$seenSectionIds, array &$seenWidgetIds, int &$widgetCount): array + { + $prefix = "sections.$index"; + + $layout = $section['layout'] ?? SectionLayouts::DEFAULT; + if (! SectionLayouts::has($layout)) { + $errors["$prefix.layout"] = ['Dieses Abschnittsraster ist nicht freigegeben.']; + $layout = SectionLayouts::DEFAULT; + } + + $style = $this->normalizeStyle(is_array($section['style'] ?? null) ? $section['style'] : [], $prefix, $errors); + + $units = SectionLayouts::units($layout); + $rawSlots = array_values(is_array($section['slots'] ?? null) ? $section['slots'] : []); + $filled = count(array_filter($rawSlots, fn ($slot): bool => is_array($slot))); + + if ($filled > count($units)) { + $errors["$prefix.slots"] = [sprintf( + 'Das Raster „%s“ hat %d %s, der Abschnitt enthält aber %d Widgets. Entfernen Sie ein Widget oder wählen Sie ein Raster mit mehr Plätzen.', + SectionLayouts::short($layout), + count($units), + count($units) === 1 ? 'Platz' : 'Plätze', + $filled, + )]; + } elseif (count($rawSlots) > count($units)) { + // Überzählige Plätze sind leer: Widgets rücken in Reihenfolge nach vorn, leere Plätze entfallen. + $rawSlots = array_values(array_filter($rawSlots, fn ($slot): bool => is_array($slot))); + } + + $slots = []; + foreach ($units as $position => $slotUnits) { + $block = $rawSlots[$position] ?? null; + + if (! is_array($block)) { + $slots[] = null; + + continue; + } + + $widgetCount++; + + try { + $widget = $this->widgets->normalizeWidget($block, "$prefix.slots.$position", $seenWidgetIds); + } catch (ValidationException $exception) { + foreach ($exception->errors() as $key => $messages) { + $errors[$key] = $messages; + } + $slots[] = null; + + continue; + } + + $type = $this->widgets->get($widget['type']); + if (! $type->supportsUnits($slotUnits)) { + $errors["$prefix.slots.$position.units"] = [sprintf( + '„%s“ ist für Plätze mit %s Rastereinheiten vorgesehen; dieser Platz hat %d. Wählen Sie ein passendes Raster oder einen passenden Platz.', + $type->label(), + $type->unitsLabel(), + $slotUnits, + )]; + } + + $slots[] = $widget; + } + + $id = $section['id'] ?? null; + if (! is_string($id) || preg_match('/^[A-Za-z0-9-]{1,64}$/', $id) !== 1 || isset($seenSectionIds[$id])) { + $id = (string) Str::uuid(); + } + $seenSectionIds[$id] = true; + + return [ + 'id' => $id, + 'v' => self::VERSION, + 'layout' => $layout, + 'style' => $style, + 'slots' => $slots, + ]; + } + + /** + * @param array $style + * @param array> $errors + * @return array + */ + private function normalizeStyle(array $style, string $prefix, array &$errors): array + { + $result = SectionStyle::DEFAULTS; + $enums = SectionStyle::enums(); + + foreach ($style as $key => $value) { + if ($key === 'image' || str_starts_with((string) $key, '_')) { + continue; + } + + if (! isset($enums[$key])) { + $errors["$prefix.style.$key"] = ['Diese Gestaltungsoption ist nicht freigegeben.']; + + continue; + } + + if ($value === null || $value === '') { + continue; + } + + if (! is_string($value) || ! array_key_exists($value, $enums[$key])) { + $errors["$prefix.style.$key"] = ['Dieser Gestaltungswert ist nicht freigegeben.']; + + continue; + } + + $result[$key] = $value; + } + + if ($result['background'] === 'image') { + $widgetErrors = new WidgetErrors; + $refs = ImageRefFields::clean(['image' => $style['image'] ?? null, '_upload' => $style['_upload'] ?? null], $widgetErrors, errorKey: 'image'); + $image = $refs['image']; + + foreach ($widgetErrors->all() as $messages) { + $errors["$prefix.style.image"] = $messages; + } + + if ($image === null && ! isset($errors["$prefix.style.image"])) { + $errors["$prefix.style.image"] = ['Bitte ein Hintergrundbild aus dem Medienmanager wählen oder hochladen.']; + } + + $result['image'] = $image; + } else { + $result['image'] = null; + } + + return $result; + } +} diff --git a/app/Domain/Cms/Sections/SectionLayouts.php b/app/Domain/Cms/Sections/SectionLayouts.php new file mode 100644 index 0000000..03e2574 --- /dev/null +++ b/app/Domain/Cms/Sections/SectionLayouts.php @@ -0,0 +1,134 @@ +> */ + public const UNITS = [ + 'u4' => [4], + 'u2_2' => [2, 2], + 'u1_3' => [1, 3], + 'u3_1' => [3, 1], + 'u1_2_1' => [1, 2, 1], + 'u1_1_1_1' => [1, 1, 1, 1], + 'u1_1_2' => [1, 1, 2], + 'u2_1_1' => [2, 1, 1], + ]; + + /** @var array */ + public const LABELS = [ + 'u4' => 'Volle Breite', + 'u2_2' => 'Zwei gleich breit', + 'u1_3' => 'Schmal und breit', + 'u3_1' => 'Breit und schmal', + 'u1_2_1' => 'Mitte betont', + 'u1_1_1_1' => 'Vier gleich breit', + 'u1_1_2' => 'Zwei schmal, eins breit', + 'u2_1_1' => 'Eins breit, zwei schmal', + ]; + + public static function has(mixed $key): bool + { + return is_string($key) && isset(self::UNITS[$key]); + } + + /** + * @return list + */ + public static function units(string $key): array + { + return self::UNITS[$key] ?? self::UNITS[self::DEFAULT]; + } + + public static function slotCount(string $key): int + { + return count(self::units($key)); + } + + /** Kurzform wie „1 + 3“. */ + public static function short(string $key): string + { + return implode(' + ', self::units($key)); + } + + public static function label(string $key): string + { + return (self::LABELS[$key] ?? self::LABELS[self::DEFAULT]).' ('.self::short($key).')'; + } + + /** + * @return array + */ + public static function options(): array + { + $options = []; + foreach (array_keys(self::UNITS) as $key) { + $options[$key] = self::label($key); + } + + return $options; + } + + /** + * Spaltenvorlagen für die Slots, die tatsächlich etwas darstellen. + * + * - Desktop (Abschnitt ab 60rem): Verhältnis der Einheiten. + * - Tablet (ab 40rem): gleich breite Slots bleiben nebeneinander (zwei oder drei Spalten, vier Slots als 2 × 2); + * ungleiche Raster stapeln, damit kein Slot unter etwa 13rem fällt. + * - Smartphone: immer eine Spalte. Die Lese- und Fokusreihenfolge bleibt die Reihenfolge der Slots. + * + * @param list $units + * @return array{lg: string, md: string} + */ + public static function columns(array $units): array + { + $units = array_values(array_filter($units, fn ($unit): bool => is_int($unit) && $unit > 0)); + $count = count($units); + + if ($count <= 1) { + return ['lg' => 'minmax(0, 1fr)', 'md' => 'minmax(0, 1fr)']; + } + + $lg = implode(' ', array_map(fn (int $unit): string => "minmax(0, {$unit}fr)", $units)); + $equal = count(array_unique($units)) === 1; + + $md = match (true) { + ! $equal => 'minmax(0, 1fr)', + $count === 3 => 'repeat(3, minmax(0, 1fr))', + default => 'repeat(2, minmax(0, 1fr))', + }; + + return ['lg' => $lg, 'md' => $md]; + } + + /** + * Symbolbild des Rasters für die grafische Auswahl im Editor (rein dekorativ). + */ + public static function schematicSvg(string $key): string + { + $units = self::units($key); + $gap = 2; + $width = 56 - $gap * (count($units) - 1); + $x = 2; + $rects = ''; + + foreach ($units as $unit) { + $w = (int) round($width * $unit / 4); + $rects .= sprintf('', $x, $w); + $x += $w + $gap; + } + + return ''; + } +} diff --git a/app/Domain/Cms/Sections/SectionRenderer.php b/app/Domain/Cms/Sections/SectionRenderer.php new file mode 100644 index 0000000..727ea4e --- /dev/null +++ b/app/Domain/Cms/Sections/SectionRenderer.php @@ -0,0 +1,127 @@ +> $sections gelesene Abschnitte (PageSections::read) + */ + public function renderAll(array $sections, RenderContext $context): HtmlString + { + $rendered = []; + $first = true; + + foreach ($sections as $section) { + $cells = []; + $units = SectionLayouts::units($section['layout']); + + foreach ($units as $position => $slotUnits) { + $widget = $section['slots'][$position] ?? null; + + if (! is_array($widget)) { + continue; + } + + $html = $this->widgets->renderWidget($widget, $context, $first); + + if ($html !== '') { + $first = false; + $cells[] = ['units' => $slotUnits, 'html' => $html]; + } + } + + if ($cells !== []) { + $rendered[] = ['section' => $section, 'cells' => $cells]; + } + } + + $html = ''; + $last = count($rendered) - 1; + + foreach ($rendered as $index => $item) { + $html .= $this->renderSection($item['section'], $item['cells'], $index, $context); + + $divider = $item['section']['style']['divider'] ?? 'none'; + if ($index < $last && in_array($divider, ['line', 'accent'], true)) { + $html .= ''; + } + } + + return new HtmlString($html); + } + + /** + * @param array $section + * @param list $cells + */ + private function renderSection(array $section, array $cells, int $index, RenderContext $context): string + { + $style = SectionStyle::fromStored($section['style'] ?? []); + $columns = SectionLayouts::columns(array_column($cells, 'units')); + // Hintergrundbild aus dem Medienmanager: öffentlich nur mit Website-Freigabe (WebsiteImage → WebsiteMedia). + $imageUrl = $style['background'] === 'image' ? app(WebsiteImage::class)->url($style['image'], $context->preview) : null; + $hasImage = $imageUrl !== null; + + $classes = [ + 'page-section', + 'section-bg-'.($hasImage ? 'image' : ($style['background'] === 'image' ? 'default' : $style['background'])), + 'section-width-'.$style['width'], + 'section-space-top-'.$style['spacing_top'], + 'section-space-bottom-'.$style['spacing_bottom'], + 'section-gap-'.$style['gap'], + 'section-layout-'.str_replace('_', '-', $section['layout']), + ]; + + if ($hasImage) { + $classes[] = 'section-overlay-'.$style['overlay']; + } + + // Bedeutungswerte der Fläche (tokens.css): helle Schrift auf dunklen Flächen, gelber Fokus. + $scope = match (true) { + $hasImage && $style['overlay'] === 'dark' => 'scope-dark', + $hasImage => 'scope-light', + $style['background'] === 'dark' => 'scope-dark', + $style['background'] === 'accent' => 'scope-accent', + default => null, + }; + if ($scope !== null) { + $classes[] = $scope; + } + + $id = is_string($section['id'] ?? null) ? ' id="bereich-'.e($section['id']).'"' : ''; + $html = '
'; + + if ($hasImage) { + // Das Bild des ersten Abschnitts ist meist das größte sichtbare Element und wird nicht verzögert geladen. + $loading = $index === 0 ? 'loading="eager" fetchpriority="high"' : 'loading="lazy"'; + $html .= ''; + } + + $html .= '
'; + + foreach ($cells as $cell) { + $html .= '
'.$cell['html'].'
'; + } + + return $html.'
'; + } +} diff --git a/app/Domain/Cms/Sections/SectionStyle.php b/app/Domain/Cms/Sections/SectionStyle.php new file mode 100644 index 0000000..b968d80 --- /dev/null +++ b/app/Domain/Cms/Sections/SectionStyle.php @@ -0,0 +1,244 @@ + */ + public const BACKGROUNDS = [ + 'default' => 'Standard (ohne eigene Fläche)', + 'light' => 'Helle Markenfläche', + 'dark' => 'Dunkle Markenfläche', + 'accent' => 'Markenakzent', + 'image' => 'Hintergrundbild', + ]; + + /** @var array */ + public const WIDTHS = [ + 'narrow' => 'Lesebereich', + 'standard' => 'Standard', + 'wide' => 'Breit', + 'full' => 'Vollbreite', + ]; + + /** + * Gemeinsame Stufen der drei Abstände eines Abschnitts (Hülle Version 2): + * - spacing_top: Abstand vor dem Inhalt (oben), + * - spacing_bottom: Abstand nach dem Inhalt (unten), + * - gap: Abstand zwischen den Plätzen im Abschnittsraster, nebeneinander und gestapelt. + * Zwischen zwei Abschnitten addieren sich „unten“ des ersten und „oben“ des zweiten; es gibt keine weitere + * versteckte Vorgabe. Liegt eine eigene Fläche (Hintergrund) vor, liegen oben und unten innerhalb dieser Fläche. + * Werte: resources/css/tokens.css (--section-space-*, --section-gap-*). + * + * @var array + */ + public const SPACINGS = [ + 'none' => 'Kein Abstand', + 'compact' => 'Kompakt', + 'normal' => 'Normal', + 'large' => 'Großzügig', + ]; + + /** @var array */ + public const DIVIDERS = [ + 'none' => 'Kein Trenner', + 'line' => 'Dezente Linie', + 'accent' => 'Markenakzent', + ]; + + /** @var array */ + public const OVERLAYS = [ + 'light' => 'Helle Überlagerung (dunkle Schrift)', + 'dark' => 'Dunkle Überlagerung (helle Schrift)', + 'none' => 'Keine Überlagerung', + ]; + + /** @var array */ + public const FOCUS = [ + 'center' => 'Mitte', + 'top' => 'Oben', + 'bottom' => 'Unten', + 'left' => 'Links', + 'right' => 'Rechts', + 'top_left' => 'Oben links', + 'top_right' => 'Oben rechts', + 'bottom_left' => 'Unten links', + 'bottom_right' => 'Unten rechts', + ]; + + /** Fokuspunkt als Objektposition des Bildes; bestimmt den Zuschnitt auf schmalen Bildschirmen. */ + public const FOCUS_POSITIONS = [ + 'center' => '50% 50%', + 'top' => '50% 0%', + 'bottom' => '50% 100%', + 'left' => '0% 50%', + 'right' => '100% 50%', + 'top_left' => '0% 0%', + 'top_right' => '100% 0%', + 'bottom_left' => '0% 100%', + 'bottom_right' => '100% 100%', + ]; + + public const DEFAULTS = [ + 'background' => 'default', + 'image' => null, + 'focus' => 'center', + 'overlay' => 'light', + 'width' => 'standard', + 'spacing_top' => 'compact', + 'spacing_bottom' => 'compact', + 'gap' => 'normal', + 'divider' => 'none', + ]; + + /** + * Aufzählungsfelder und ihre zulässigen Werte. + * + * @return array> + */ + public static function enums(): array + { + return [ + 'background' => self::BACKGROUNDS, + 'focus' => self::FOCUS, + 'overlay' => self::OVERLAYS, + 'width' => self::WIDTHS, + 'spacing_top' => self::SPACINGS, + 'spacing_bottom' => self::SPACINGS, + 'gap' => self::SPACINGS, + 'divider' => self::DIVIDERS, + ]; + } + + /** + * Lesepfad: gespeicherte Werte; Unbekanntes fällt auf die Vorgabe zurück, damit alte oder fremde Daten + * nie eine Seite brechen. + * + * @return array{background: string, image: ?string, focus: string, overlay: string, width: string, spacing_top: string, spacing_bottom: string, gap: string, divider: string} + */ + public static function fromStored(mixed $style): array + { + $style = is_array($style) ? $style : []; + $result = self::DEFAULTS; + + foreach (self::enums() as $key => $options) { + $value = $style[$key] ?? null; + if (is_string($value) && array_key_exists($value, $options)) { + $result[$key] = $value; + } + } + + $result['image'] = $result['background'] === 'image' ? WebsiteImage::normalize($style['image'] ?? null) : null; + + return $result; + } + + /** + * Kurzbeschreibung für die Abschnittsliste im Editor. + * + * @param array $style + */ + public static function summary(array $style): string + { + $style = self::fromStored($style); + $parts = [self::BACKGROUNDS[$style['background']]]; + + if ($style['width'] !== 'standard') { + $parts[] = self::WIDTHS[$style['width']]; + } + + if ($style['spacing_top'] !== self::DEFAULTS['spacing_top'] || $style['spacing_bottom'] !== self::DEFAULTS['spacing_bottom']) { + $parts[] = 'Abstand oben '.mb_strtolower(self::SPACINGS[$style['spacing_top']]) + .', unten '.mb_strtolower(self::SPACINGS[$style['spacing_bottom']]); + } + + if ($style['gap'] !== 'normal') { + $parts[] = 'Widget-Abstand '.mb_strtolower(self::SPACINGS[$style['gap']]); + } + + if ($style['divider'] !== 'none') { + $parts[] = 'Trenner: '.self::DIVIDERS[$style['divider']]; + } + + return implode(' · ', $parts); + } + + /** + * Ob eine gespeicherte Gestaltung noch die Abstände der Hülle Version 1 trägt + * („Abstand oben und unten“ spacing, Abweichung „Abstand oben“ same/small/none). + * + * @param array $style + */ + public static function hasLegacySpacing(array $style): bool + { + return array_key_exists('spacing', $style) + || in_array($style['spacing_top'] ?? null, ['same', 'small'], true); + } + + /** + * Übersetzt die Abstände der Hülle Version 1 in die drei Werte der Version 2, ohne die Darstellung zu ändern. + * + * Version 1 rechnete so: jeder Abschnitt oben und unten „spacing“ (Vorgabe normal); die Abweichung + * „Abstand oben“ ersetzte nur oben (small/none); und eine versteckte Regel setzte oben auf null, wenn ein Abschnitt + * ohne eigene Fläche direkt auf einen Abschnitt ohne eigene Fläche folgte (ohne Linien- oder Akzenttrenner dazwischen). + * Diese Regel wird hier als „oben: kein Abstand“ ausgeschrieben. „Gering“ hat keine eigene Stufe mehr und wird + * „Kompakt“ (dokumentierte Abweichung). Der Widget-Abstand entspricht dem bisherigen festen Rasterabstand („normal“). + * + * @param list> $sections Abschnitte in Lesereihenfolge (mit style und slots) + * @param bool $byVersion true: jede Hülle mit v < 2 gilt als Version 1 (Lesepfad gespeicherter Revisionen); + * false: nur Gestaltungen mit alten Schlüsseln (Eingaben ohne Versionsangabe) + * @return list> dieselben Abschnitte mit übersetzter Gestaltung + */ + public static function migrateSpacing(array $sections, bool $byVersion = false): array + { + $previous = null; + + foreach ($sections as $index => $section) { + $style = is_array($section['style'] ?? null) ? $section['style'] : []; + $rendered = is_array($section['slots'] ?? null) && array_filter($section['slots'], 'is_array') !== []; + + $background = is_string($style['background'] ?? null) && isset(self::BACKGROUNDS[$style['background']]) ? $style['background'] : 'default'; + if ($background === 'image' && WebsiteImage::normalize($style['image'] ?? null) === null) { + $background = 'default'; + } + $divider = in_array($style['divider'] ?? null, ['line', 'accent'], true) ? $style['divider'] : 'none'; + + $legacy = $byVersion ? (int) ($section['v'] ?? 1) < 2 : self::hasLegacySpacing($style); + + if ($legacy) { + $level = in_array($style['spacing'] ?? null, ['compact', 'normal', 'large'], true) ? $style['spacing'] : 'normal'; + $override = $style['spacing_top'] ?? 'same'; + $collapsed = $background === 'default' && $previous !== null && $previous['background'] === 'default' && ! in_array($previous['divider'], ['line', 'accent'], true); + + $style['spacing_top'] = match (true) { + $override === 'none' => 'none', + $override === 'small' => 'compact', + $collapsed => 'none', + default => $level, + }; + $style['spacing_bottom'] = $level; + $style['gap'] = 'normal'; + + // Trenner „Zusätzlicher Abstand“ (Version 1) fügte unten noch einmal den Abschnittsabstand an. + if (($style['divider'] ?? null) === 'space') { + $style['spacing_bottom'] = ['compact' => 'normal', 'normal' => 'large', 'large' => 'large'][$level]; + $style['divider'] = 'none'; + } + unset($style['spacing']); + $sections[$index]['style'] = $style; + } + + if ($rendered) { + $previous = ['background' => $background, 'divider' => $divider]; + } + } + + return $sections; + } +} diff --git a/app/Domain/Cms/SiteNavigation.php b/app/Domain/Cms/SiteNavigation.php new file mode 100644 index 0000000..f7c4595 --- /dev/null +++ b/app/Domain/Cms/SiteNavigation.php @@ -0,0 +1,104 @@ + $items sichtbare Einträge, sortiert + */ + public function __construct(private readonly Collection $items, private readonly string $currentPath) {} + + /** + * @param Collection $items + */ + public static function forPath(Collection $items, string $path): self + { + return new self($items, '/'.trim($path, '/')); + } + + /** + * Hauptnavigation mit einer Ebene Untermenü. Untereinträge eines ausgeblendeten Eintrags sind ebenfalls verborgen. + * + * @return list}> + */ + public function header(): array + { + $topLevel = $this->items->where('placement', 'header')->whereNull('parent_id'); + $entries = []; + + foreach ($topLevel as $item) { + $children = []; + + foreach ($this->items->where('parent_id', $item->id) as $child) { + $href = $child->href(); + if ($href !== null) { + $children[] = [ + 'id' => $child->id, + 'label' => $child->label, + 'href' => $href, + 'current' => $this->isCurrent($child), + ]; + } + } + + $href = $item->href(); + if ($href === null && $children === []) { + continue; + } + + $current = $href !== null && $this->isCurrent($item); + + $entries[] = [ + 'id' => $item->id, + 'label' => $item->label, + 'href' => $href, + 'current' => $current, + 'activeTrail' => $current || in_array(true, array_column($children, 'current'), true), + 'children' => $children, + ]; + } + + return $entries; + } + + /** + * Spalten des Fußbereichs in fester Reihenfolge; Gruppen ohne Einträge entfallen. + * + * @return list}> + */ + public function footerGroups(): array + { + $groups = []; + + foreach (NavigationItem::FOOTER_GROUPS as $placement => $heading) { + $links = []; + + foreach ($this->items->where('placement', $placement) as $item) { + $href = $item->href(); + if ($href !== null) { + $links[] = ['label' => $item->label, 'href' => $href, 'current' => $this->isCurrent($item)]; + } + } + + if ($links !== []) { + $groups[] = ['key' => $placement, 'heading' => $heading, 'links' => $links]; + } + } + + return $groups; + } + + private function isCurrent(NavigationItem $item): bool + { + return $item->targetPath() === $this->currentPath; + } +} diff --git a/app/Domain/Cms/WebsiteImageUsage.php b/app/Domain/Cms/WebsiteImageUsage.php new file mode 100644 index 0000000..b9c9463 --- /dev/null +++ b/app/Domain/Cms/WebsiteImageUsage.php @@ -0,0 +1,56 @@ + + */ + public function pages(ContentElement $element): array + { + $legacy = WebsiteMediaAlias::query()->where('content_element_id', $element->id)->pluck('legacy_path')->all(); + $usages = []; + + foreach (Page::query()->with(['publishedRevision', 'latestRevision'])->orderBy('path')->get() as $page) { + $published = $page->publishedRevision !== null && $this->uses($page->publishedRevision->sections ?? [], $element->id, $legacy); + $draft = $page->latestRevision !== null && $page->latestRevision->id !== $page->published_revision_id + && $this->uses($page->latestRevision->sections ?? [], $element->id, $legacy); + + if ($published || $draft) { + $usages[] = ['path' => (string) $page->path, 'published' => $published, 'draft' => $draft]; + } + } + + return $usages; + } + + /** + * @param list $legacy + */ + private function uses(mixed $value, int $id, array $legacy): bool + { + if (! is_array($value)) { + return false; + } + + foreach ($value as $key => $item) { + if ($key === 'image' && (($item === $id || (is_string($item) && ($item === (string) $id || in_array($item, $legacy, true)))))) { + return true; + } + + if (is_array($item) && $this->uses($item, $id, $legacy)) { + return true; + } + } + + return false; + } +} diff --git a/app/Domain/Cms/Widgets/RenderContext.php b/app/Domain/Cms/Widgets/RenderContext.php new file mode 100644 index 0000000..f9412c8 --- /dev/null +++ b/app/Domain/Cms/Widgets/RenderContext.php @@ -0,0 +1,22 @@ + + */ + public static function fields(string $label = 'Bild', bool $live = false, string $key = 'image', ?string $altField = null): array + { + return [ + // Auswahl über den gemeinsamen visuellen Picker (Suche, Vorschau, Website-Freigabe im Detail). + ViewField::make($key) + ->live() + ->label($label.' aus dem Medienmanager') + ->view('filament.cms.bild-feld') + ->helperText('Öffentlich erscheint ein Bild nur mit Website-Freigabe; die Auswahl gibt es nicht frei.'), + FileUpload::make('_upload') + ->live() + ->label($label.': neues Bild hochladen') + ->image() + ->maxSize(8192) + ->acceptedFileTypes(['image/jpeg', 'image/png', 'image/webp']) + ->storeFiles(false) + ->afterStateUpdated(function (mixed $state, Set $set, Get $get) use ($key, $altField): void { + $file = is_array($state) ? (array_values($state)[0] ?? null) : $state; + + if (! $file instanceof TemporaryUploadedFile) { + return; + } + + $element = app(WebsiteImage::class)->accept($file, $altField !== null ? $get($altField) : null); + $set('_upload', null); + + if ($element === null) { + Notification::make()->danger()->title('Das Bild konnte nicht übernommen werden.')->send(); + + return; + } + + $set($key, $element->id); + Notification::make() + ->success() + ->title('Im Medienmanager angelegt: „'.($element->display_title ?: $element->working_title).'“') + ->body('Das Bild ist ausgewählt. Nach der Verarbeitung wird es automatisch für die Website freigegeben.') + ->send(); + }) + ->helperText('Das Bild wird im Medienmanager angelegt und hier ausgewählt. Nur Bilder mit geklärten Rechten hochladen.'), + Placeholder::make('_media_status') + ->label('Gewähltes Bild') + ->visible(fn (Get $get): bool => WebsiteImage::normalize($get($key)) !== null) + ->content(fn (Get $get): HtmlString => self::statusHtml($get($key))), + ]; + } + + /** + * @return array + */ + public static function rules(): array + { + return [ + 'image' => ['nullable'], + '_upload' => ['nullable'], + ]; + } + + /** + * Prüft das gewählte Bild. Ein früherer CMS-Pfad mit wirksamer Zuordnung wird zur Kennung des Mediums. + * Ein noch als Datei übergebener Upload (frühere Formulare) wird über den Medienmanager aufgenommen. + * + * @param array $refs + * @return array + */ + public static function clean(array $refs, WidgetErrors $errors, string $key = 'image', ?string $errorKey = null): array + { + $images = app(WebsiteImage::class); + $upload = $refs['_upload'] ?? null; + $upload = is_array($upload) ? (array_values($upload)[0] ?? null) : $upload; + + if ($upload instanceof TemporaryUploadedFile) { + $element = $images->accept($upload); + $refs[$key] = $element?->id ?? $refs[$key] ?? null; + } + + $refs[$key] = $images->clean($refs[$key] ?? null, $errors, $errorKey ?? "refs.$key"); + unset($refs['_upload']); + + return $refs; + } + + public static function statusHtml(mixed $value): HtmlString + { + $status = app(WebsiteImage::class)->status($value); + + if ($status === null) { + return new HtmlString(''); + } + + $thumb = $status['thumb'] !== null ? '' : ''; + $link = $status['manageUrl'] !== null + ? 'Im Medienmanager öffnen' + : ''; + + return new HtmlString('
'.$thumb + .'
'.e($status['title']).'

'.e($status['note']).'

'.$link.'
'); + } +} diff --git a/app/Domain/Cms/Widgets/Support/PremiumFields.php b/app/Domain/Cms/Widgets/Support/PremiumFields.php new file mode 100644 index 0000000..ca65e38 --- /dev/null +++ b/app/Domain/Cms/Widgets/Support/PremiumFields.php @@ -0,0 +1,196 @@ + 'Automatisch (Seiteneinstieg H1, sonst H2)', + 'h2' => 'H2', + 'h3' => 'H3', + ]; + + /** + * @return array + */ + public static function rules(): array + { + return [ + 'eyebrow' => ['nullable', 'string', 'max:80'], + 'cta_label' => ['nullable', 'string', 'max:80', 'required_with:data.cta_url'], + 'cta_url' => ['nullable', 'string', 'max:500', 'required_with:data.cta_label'], + 'cta2_label' => ['nullable', 'string', 'max:80', 'required_with:data.cta2_url'], + 'cta2_url' => ['nullable', 'string', 'max:500', 'required_with:data.cta2_label'], + 'alt' => ['nullable', 'string', 'max:300'], + 'focus_x' => ['nullable', 'numeric', 'between:0,100'], + 'focus_y' => ['nullable', 'numeric', 'between:0,100'], + ]; + } + + public static function eyebrowField(): TextInput + { + return TextInput::make('eyebrow') + ->label('Label über der Überschrift (optional)') + ->maxLength(80) + ->live(onBlur: true) + ->helperText('Kurzer Hinweis, zum Beispiel ein Themenbereich. Kein Pflichtfeld.'); + } + + public static function ctaFields(): Grid + { + $url = fn (string $name, string $label, string $pair) => TextInput::make($name) + ->label($label) + ->maxLength(500) + ->rule(SafeUrl::rule()) + ->requiredWith($pair) + ->live(onBlur: true) + ->placeholder('/programme'); + + return Grid::make(['default' => 1, 'md' => 2])->schema([ + TextInput::make('cta_label')->label('Hauptschaltfläche: Beschriftung')->maxLength(80)->live(onBlur: true), + $url('cta_url', 'Hauptschaltfläche: Linkziel', 'cta_label'), + TextInput::make('cta2_label')->label('Zweite Schaltfläche: Beschriftung')->maxLength(80)->live(onBlur: true), + $url('cta2_url', 'Zweite Schaltfläche: Linkziel', 'cta2_label'), + ]); + } + + /** + * @return list + */ + public static function focusFields(int $defaultX = 50, int $defaultY = 50): array + { + // Ohne gespeicherten Wert zeigt der Regler die Vorgabe der Widget-Art, die auch die Darstellung verwendet. + $slider = fn (string $name, string $label, int $default) => Slider::make($name) + ->label($label) + ->range(0, 100) + ->step(1) + ->required(false) + ->tooltips() + ->default($default) + ->afterStateHydrated(function (Slider $component, mixed $state) use ($default): void { + if (! is_numeric($state)) { + $component->state($default); + } + }) + ->live(); + + return [ + $slider('focus_x', 'Bildausschnitt waagerecht (0 = links, 100 = rechts)', $defaultX), + $slider('focus_y', 'Bildausschnitt senkrecht (0 = oben, 100 = unten)', $defaultY), + ]; + } + + public static function altField(): TextInput + { + return TextInput::make('alt') + ->label('Alternativtext (optional)') + ->maxLength(300) + ->live(onBlur: true) + ->helperText('Leer lassen, dann gilt der Alternativtext des Mediums aus dem Medienmanager. Nur ausfüllen, wenn das Bild hier etwas anderes aussagen soll.'); + } + + /** + * Bereinigt Label, Schaltflächen, Alternativtext und Fokus; meldet unsichere Linkziele. + * + * @param array $data + * @return array + */ + public static function clean(array $data, WidgetErrors $errors, bool $hasImage): array + { + foreach (['eyebrow', 'cta_label', 'cta_url', 'cta2_label', 'cta2_url', 'alt'] as $key) { + $data[$key] = filled($data[$key] ?? null) ? trim((string) $data[$key]) : null; + } + + foreach (['cta_url', 'cta2_url'] as $key) { + if ($data[$key] !== null && ! SafeUrl::isSafe($data[$key])) { + $errors->add("data.$key", SafeUrl::message()); + } + } + + foreach (['focus_x', 'focus_y'] as $key) { + $value = $data[$key] ?? null; + $data[$key] = is_numeric($value) ? (int) round(max(0, min(100, (float) $value))) : null; + } + + return $data; + } + + /** + * Schaltflächen mit sicherem Linkziel in Anzeigereihenfolge. + * + * @param array $data + * @return list + */ + public static function actions(array $data): array + { + $actions = []; + + foreach ([['cta_label', 'cta_url'], ['cta2_label', 'cta2_url']] as [$label, $url]) { + if (filled($data[$label] ?? null) && SafeUrl::isSafe($data[$url] ?? null)) { + $actions[] = ['label' => (string) $data[$label], 'url' => (string) $data[$url]]; + } + } + + return $actions; + } + + /** + * Bildfokus in Prozent; ohne Angabe die Vorgabe der Widget-Art. + * + * @param array $data + * @return array{x: int, y: int} + */ + public static function focus(array $data, int $defaultX = 50, int $defaultY = 50): array + { + $clamp = fn (mixed $value, int $default): int => is_numeric($value) ? (int) round(max(0, min(100, (float) $value))) : $default; + + return ['x' => $clamp($data['focus_x'] ?? null, $defaultX), 'y' => $clamp($data['focus_y'] ?? null, $defaultY)]; + } + + /** + * Übersetzt den früheren Fokuspunkt (Aufzählung wie beim Abschnittshintergrund) in Prozentwerte. + * + * @return array{focus_x: int|null, focus_y: int|null} + */ + public static function focusFromEnum(mixed $focus): array + { + if (! is_string($focus) || ! isset(SectionStyle::FOCUS_POSITIONS[$focus])) { + return ['focus_x' => null, 'focus_y' => null]; + } + + [$x, $y] = array_map(fn (string $part): int => (int) rtrim($part, '%'), explode(' ', SectionStyle::FOCUS_POSITIONS[$focus])); + + return ['focus_x' => $x, 'focus_y' => $y]; + } + + /** + * Überschriftenebene: „auto“ ergibt H1 für das erste Widget der Seite, sonst H2. Eine weitere H1 gibt es nicht. + * + * @param array $settings + */ + public static function headingTag(array $settings, bool $first): string + { + $level = $settings['heading_level'] ?? 'auto'; + + return match (true) { + $first => 'h1', + $level === 'h3' => 'h3', + default => 'h2', + }; + } +} diff --git a/app/Domain/Cms/Widgets/Support/PublicMedia.php b/app/Domain/Cms/Widgets/Support/PublicMedia.php new file mode 100644 index 0000000..b161b86 --- /dev/null +++ b/app/Domain/Cms/Widgets/Support/PublicMedia.php @@ -0,0 +1,37 @@ + $path]); + } + + /** + * Pfad aus dem Zustand eines Upload-Felds (Zeichenkette oder Liste). + */ + public static function fromUploadState(mixed $state): ?string + { + if (is_array($state)) { + $state = array_values($state)[0] ?? null; + } + + return is_string($state) && $state !== '' ? $state : null; + } +} diff --git a/app/Domain/Cms/Widgets/Support/RichText.php b/app/Domain/Cms/Widgets/Support/RichText.php new file mode 100644 index 0000000..152ebae --- /dev/null +++ b/app/Domain/Cms/Widgets/Support/RichText.php @@ -0,0 +1,79 @@ +sanitize($html)); + } + + /** + * Übernimmt Klartext aus dem Altbestand: Absätze an Leerzeilen, Zeichen maskiert. + */ + public static function fromPlainText(?string $text): string + { + $text = trim((string) $text); + + if ($text === '') { + return ''; + } + + $paragraphs = preg_split("/\n\s*\n/", $text) ?: []; + + return implode('', array_map( + fn (string $paragraph): string => '

'.e(trim($paragraph)).'

', + $paragraphs, + )); + } + + public static function isBlank(?string $html): bool + { + return trim(html_entity_decode(strip_tags((string) $html), ENT_QUOTES | ENT_HTML5, 'UTF-8')) === ''; + } + + public static function excerpt(?string $html, int $length = 80): string + { + $text = trim(preg_replace('/\s+/u', ' ', html_entity_decode(strip_tags(str_replace('<', ' <', (string) $html)), ENT_QUOTES | ENT_HTML5, 'UTF-8')) ?? ''); + + return mb_strlen($text) > $length ? rtrim(mb_substr($text, 0, $length - 1)).'…' : $text; + } + + private static function sanitizer(): HtmlSanitizer + { + return self::$sanitizer ??= new HtmlSanitizer( + (new HtmlSanitizerConfig) + ->allowElement('p') + ->allowElement('br') + ->allowElement('strong') + ->allowElement('b') + ->allowElement('em') + ->allowElement('i') + ->allowElement('ul') + ->allowElement('ol') + ->allowElement('li') + ->allowElement('a', ['href']) + ->allowLinkSchemes(['http', 'https', 'mailto']) + ->allowRelativeLinks() + ->forceAttribute('a', 'rel', 'noopener') + ->withMaxInputLength(40000), + ); + } +} diff --git a/app/Domain/Cms/Widgets/Support/SafeUrl.php b/app/Domain/Cms/Widgets/Support/SafeUrl.php new file mode 100644 index 0000000..a385792 --- /dev/null +++ b/app/Domain/Cms/Widgets/Support/SafeUrl.php @@ -0,0 +1,44 @@ + */ + private array $resolved = []; + + /** @var array */ + private array $presentations = []; + + public function __construct(private readonly WebsiteMedia $media) {} + + /** + * Gespeicherter oder eingegebener Wert → Kennung (int), früherer Pfad (string) oder null. + */ + public static function normalize(mixed $value): int|string|null + { + if (is_array($value)) { + $value = array_values($value)[0] ?? null; + } + + if (is_int($value) && $value > 0) { + return $value; + } + + if (is_string($value) && preg_match('/^[1-9][0-9]*$/', $value) === 1) { + return (int) $value; + } + + return PublicMedia::isPublicPath($value) ? $value : null; + } + + /** + * Kennung des Mediums: gespeicherte Kennung oder wirksam zugeordneter früherer Pfad; sonst null. + */ + public function elementId(mixed $value): ?int + { + $value = self::normalize($value); + + if (is_int($value)) { + return $value; + } + + if ($value === null) { + return null; + } + + if (! array_key_exists($value, $this->resolved)) { + $this->resolved[$value] = WebsiteMediaAlias::effectiveFor($value)?->content_element_id; + } + + $id = $this->resolved[$value]; + + return is_int($id) ? $id : null; + } + + public function presentation(mixed $value): ?WebsitePresentation + { + $id = $this->elementId($value); + + if ($id === null) { + return null; + } + + if (! array_key_exists($id, $this->presentations)) { + $this->presentations[$id] = $this->media->present($id) ?? false; + } + + return $this->presentations[$id] ?: null; + } + + /** + * Bildadresse für die Darstellung. Öffentlich nur freigegebene Medien (oder frühere CMS-Bilder ohne Zuordnung); + * in der Redaktionsvorschau zusätzlich das Vorschaubild eines nicht freigegebenen Mediums. + */ + public function url(mixed $value, bool $preview = false): ?string + { + $presentation = $this->presentation($value); + + if ($presentation !== null) { + return $presentation->kind === 'bild' ? $presentation->url : null; + } + + $id = $this->elementId($value); + + if ($id !== null) { + if (! $preview) { + return null; + } + + $element = ContentElement::query()->find($id); + + return $element === null ? null : ThumbnailRef::url('editorial.card', 'element', $element->id, $element->thumbnail_path); + } + + $legacy = self::normalize($value); + + return is_string($legacy) ? PublicMedia::url($legacy) : null; + } + + /** Alternativtext: Angabe im Widget, sonst der Alternativtext des Mediums. */ + public function alt(mixed $value, mixed $override = null): string + { + if (is_string($override) && trim($override) !== '') { + return trim($override); + } + + return $this->presentation($value)?->alt ?? ''; + } + + /** Öffentliche Quellenzeile des Mediums (nur solange es freigegeben ist). */ + public function credit(mixed $value): ?string + { + return $this->presentation($value)?->credit; + } + + /** + * Hinweis für die Redaktionsvorschau, wenn das gewählte Bild öffentlich nicht erscheint; sonst null. + */ + public function previewNotice(mixed $value, string $label = 'Das gewählte Bild'): ?string + { + $status = $this->status($value); + + if ($status === null || $status['public']) { + return null; + } + + return $label.' „'.$status['title'].'“ erscheint öffentlich nicht: '.$status['note']; + } + + /** + * Zustand für Editor und Vorschau. + * + * @return array{public: bool, state: string, title: string, note: string, thumb: ?string, manageUrl: ?string}|null + */ + public function status(mixed $value): ?array + { + $value = self::normalize($value); + + if ($value === null) { + return null; + } + + $id = $this->elementId($value); + + if ($id === null) { + return [ + 'public' => true, + 'state' => 'legacy', + 'title' => basename((string) $value), + 'note' => 'Früheres CMS-Bild, noch nicht in den Medienmanager übernommen.', + 'thumb' => PublicMedia::url((string) $value), + 'manageUrl' => null, + ]; + } + + $element = ContentElement::query()->with('editorialContentKind')->find($id); + + if ($element === null) { + return ['public' => false, 'state' => 'missing', 'title' => 'Medium '.$id, 'note' => 'Das Medium gibt es nicht mehr.', 'thumb' => null, 'manageUrl' => null]; + } + + $title = (string) ($element->display_title ?: $element->working_title); + $thumb = ThumbnailRef::url('editorial.card', 'element', $element->id, $element->thumbnail_path); + $manageUrl = ContentElementResource::getUrl('view', ['record' => $element]); + $public = $this->presentation($id) !== null; + + $note = match (true) { + $public => 'Für die Website freigegeben.', + $element->archived_at !== null => 'Das Medium ist archiviert.', + filled($element->thumbnail_error) => 'Die Datei ließ sich nicht verarbeiten: '.Str::limit((string) $element->thumbnail_error, 120), + $element->thumbnail_path === null => 'Wird gerade verarbeitet. Danach wird es automatisch für die Website freigegeben.', + default => 'Nicht für die Website freigegeben. Die Freigabe steht im Medienmanager beim Medium unter „Beschreibung“ (Website-Freigabe).', + }; + + return [ + 'public' => $public, + 'state' => $public ? 'released' : ($element->thumbnail_path === null && ! filled($element->thumbnail_error) ? 'pending' : 'unreleased'), + 'title' => $title, + 'note' => $note, + 'thumb' => $thumb, + 'manageUrl' => $manageUrl, + ]; + } + + /** + * Prüft einen Wert beim Speichern. Ein früherer Pfad mit wirksamer Zuordnung wird zur Kennung des Mediums. + */ + public function clean(mixed $value, WidgetErrors $errors, string $errorKey): int|string|null + { + $raw = is_array($value) ? (array_values($value)[0] ?? null) : $value; + $value = self::normalize($raw); + + if ($value === null) { + if ($raw !== null && $raw !== '') { + $errors->add($errorKey, 'Bitte ein Bild aus dem Medienmanager wählen.'); + } + + return null; + } + + if (is_string($value)) { + return $this->elementId($value) ?? $value; + } + + $element = ContentElement::query()->find($value); + + if ($element === null || ! self::isSelectable($element)) { + $errors->add($errorKey, 'Dieses Medium ist kein Bild für die Website (nur Bilder aus dem Medienmanager, keine Traineranleitungen).'); + + return null; + } + + return $element->id; + } + + public static function isSelectable(ContentElement $element): bool + { + if ($element->output_class !== 'bild' || $element->archived_at !== null) { + return false; + } + + $slug = $element->editorialContentKind?->slug + ?? ($element->editorial_content_kind_id !== null ? EditorialContentKind::query()->whereKey($element->editorial_content_kind_id)->value('slug') : null); + + return ! in_array($slug, PublicMaterialReader::CONFIDENTIAL_KINDS, true); + } + + /** + * Auswahl für den Medienpicker: Bilder aus dem Medienmanager mit Vorschaubild, Titel und Freigabestatus (HTML). + * + * @return array + */ + public function options(?string $search = null, int $limit = 60): array + { + $search = trim((string) $search); + + $elements = ContentElement::query() + ->with('editorialContentKind') + ->where('output_class', 'bild') + ->whereNull('archived_at') + ->when($search !== '', function ($query) use ($search): void { + $like = '%'.mb_strtolower($search).'%'; + $query->where(fn ($inner) => $inner + ->whereRaw('LOWER(working_title) LIKE ?', [$like]) + ->orWhereRaw('LOWER(COALESCE(display_title, \'\')) LIKE ?', [$like])); + }) + ->orderByDesc('id') + ->limit($limit) + ->get(); + + $options = []; + foreach ($elements as $element) { + if (self::isSelectable($element)) { + $options[$element->id] = $this->optionHtml($element->id); + } + } + + return $options; + } + + /** HTML-Bezeichnung einer Option oder des gewählten Werts (auch für frühere Pfade). */ + public function optionHtml(mixed $value): ?string + { + $status = $this->status($value); + + if ($status === null) { + return null; + } + + $badge = match ($status['state']) { + 'released' => ['ok', 'Website: freigegeben'], + 'pending' => ['wait', 'Wird verarbeitet'], + 'legacy' => ['quiet', 'Früheres CMS-Bild'], + default => ['warn', 'Website: nicht freigegeben'], + }; + $thumb = $status['thumb'] !== null + ? '' + : ''; + + return ''.$thumb + .''.e($status['title']).'' + .''.e($badge[1]).''; + } + + /** + * Neues Bild direkt aus dem CMS: Datei in den Eingang legen und über WebsiteIntake als Medium anlegen. + * Die Warteschlange leitet das Bild ab und gibt die Ableitung für die Website frei. + */ + public function accept(TemporaryUploadedFile $file, ?string $alt = null): ?ContentElement + { + $base = Str::slug(pathinfo($file->getClientOriginalName(), PATHINFO_FILENAME)) ?: 'bild'; + $name = $base.'-'.Str::lower(Str::random(6)).'.'.($file->guessExtension() ?: 'jpg'); + + try { + $path = $file->storeAs('cms', $name, 'cms_incoming'); + } catch (Throwable $exception) { + report($exception); + + return null; + } + + if (! is_string($path) || $path === '') { + return null; + } + + $actor = auth('staff')->user(); + + return app(WebsiteIntake::class)->acceptImage( + $path, + Str::title(str_replace(['-', '_'], ' ', $base)), + null, + filled($alt) ? trim((string) $alt) : null, + $actor instanceof User ? $actor : null, + ); + } +} diff --git a/app/Domain/Cms/Widgets/Types/CallToActionWidget.php b/app/Domain/Cms/Widgets/Types/CallToActionWidget.php new file mode 100644 index 0000000..3123704 --- /dev/null +++ b/app/Domain/Cms/Widgets/Types/CallToActionWidget.php @@ -0,0 +1,106 @@ + 'Automatisch (nach Inhalt)', + 'fill' => 'Abschnittshöhe füllen (gleich hoch wie Nachbarplätze)', + ]; + } + + public function preferredUnits(): int + { + return 2; + } + + public function stages(): array + { + return [ + 'fluid' => 'Text und Schaltfläche untereinander, Schaltfläche volle Breite unter 20rem', + ]; + } + + public function icon(): string + { + return 'heroicon-o-megaphone'; + } + + public function schematic(): array + { + return [[2, 4, 56, 28, 'ink'], [8, 9, 30, 4, 'line'], [8, 16, 40, 3, 'line'], [8, 23, 16, 5, 'accent']]; + } + + public function dataRules(): array + { + return [ + 'heading' => ['required', 'string', 'max:200'], + 'text' => ['nullable', 'string', 'max:1000'], + 'label' => ['required', 'string', 'max:80'], + 'url' => ['required', 'string', 'max:500'], + ]; + } + + public function dataFields(): array + { + return [ + TextInput::make('heading')->label('Überschrift')->required()->maxLength(200), + Textarea::make('text')->label('Text')->rows(3)->maxLength(1000), + TextInput::make('label')->label('Beschriftung der Schaltfläche')->required()->maxLength(80), + TextInput::make('url') + ->label('Linkziel') + ->required() + ->maxLength(500) + ->rule(SafeUrl::rule()) + ->helperText('Seitenpfad wie /angebote oder eine vollständige http(s)-Adresse.'), + ]; + } + + public function clean(array $data, array $refs, WidgetErrors $errors): array + { + if (! SafeUrl::isSafe($data['url'] ?? null)) { + $errors->add('data.url', SafeUrl::message()); + } + + return [$data, $refs]; + } + + public function summary(array $widget): string + { + return trim(($widget['data']['heading'] ?? '').' → '.($widget['data']['label'] ?? '')); + } +} diff --git a/app/Domain/Cms/Widgets/Types/CardsWidget.php b/app/Domain/Cms/Widgets/Types/CardsWidget.php new file mode 100644 index 0000000..0c54bea --- /dev/null +++ b/app/Domain/Cms/Widgets/Types/CardsWidget.php @@ -0,0 +1,187 @@ + 'eine Karte je Zeile', + 'wide' => 'so viele Karten nebeneinander, wie bei mindestens 15rem Kartenbreite passen; hervorgehobene Karte ab 44rem mit Bild neben dem Text', + ]; + } + + public function icon(): string + { + return 'heroicon-o-squares-2x2'; + } + + public function schematic(): array + { + return [[2, 6, 17, 24, 'line'], [21, 6, 17, 24, 'line'], [40, 6, 17, 24, 'line'], [2, 6, 17, 2, 'accent'], [21, 6, 17, 2, 'accent'], [40, 6, 17, 2, 'accent']]; + } + + public function variants(): array + { + return [ + 'standard' => 'Raster', + 'compact' => 'Kompakte Liste', + 'featured' => 'Erste Karte hervorgehoben', + ]; + } + + public function dataRules(): array + { + return [ + 'items' => ['required', 'array', 'min:1', 'max:12'], + 'items.*.title' => ['required', 'string', 'max:120'], + 'items.*.text' => ['nullable', 'string', 'max:500'], + 'items.*.url' => ['nullable', 'string', 'max:500'], + 'items.*.image' => ['nullable'], + 'items.*._upload' => ['nullable'], + ]; + } + + public function dataFields(): array + { + [$image, $upload, $status] = ImageRefFields::fields('Bild (optional)'); + + return [ + Repeater::make('items') + ->label('Karten') + ->schema([ + TextInput::make('title')->label('Titel')->required()->maxLength(120), + Textarea::make('text')->label('Beschreibung')->rows(2)->maxLength(500), + TextInput::make('url') + ->label('Linkziel') + ->maxLength(500) + ->rule(SafeUrl::rule()) + ->helperText('Seitenpfad wie /praevention oder eine http(s)-Adresse. Leer lassen für eine Karte ohne Link.'), + $image, + $upload, + $status, + ]) + ->minItems(1) + ->maxItems(12) + ->reorderableWithButtons() + ->collapsible() + ->cloneable() + ->itemLabel(fn (array $state): ?string => $state['title'] ?? null) + ->addActionLabel('Karte hinzufügen'), + ]; + } + + public function clean(array $data, array $refs, WidgetErrors $errors): array + { + foreach ($data['items'] as $index => $item) { + if (filled($item['url'] ?? null) && ! SafeUrl::isSafe($item['url'])) { + $errors->add("data.items.$index.url", SafeUrl::message()); + } + + $itemRefs = ImageRefFields::clean(['image' => $item['image'] ?? null, '_upload' => $item['_upload'] ?? null], $errors, errorKey: "data.items.$index.image"); + + $data['items'][$index] = [ + 'title' => $item['title'], + 'text' => filled($item['text'] ?? null) ? $item['text'] : null, + 'url' => filled($item['url'] ?? null) ? $item['url'] : null, + 'image' => $itemRefs['image'], + ]; + } + + return [$data, $refs]; + } + + public function resolve(array $widget, RenderContext $context): array + { + $images = app(WebsiteImage::class); + $items = []; + $notices = []; + + foreach ($widget['data']['items'] ?? [] as $item) { + if (! is_array($item) || ! filled($item['title'] ?? null)) { + continue; + } + + $items[] = [ + 'title' => $item['title'], + 'text' => $item['text'] ?? null, + 'url' => SafeUrl::isSafe($item['url'] ?? null) ? $item['url'] : null, + 'imageUrl' => $images->url($item['image'] ?? null, $context->preview), + ]; + + if ($context->preview && ($notice = $images->previewNotice($item['image'] ?? null, 'Das Bild der Karte „'.$item['title'].'“')) !== null) { + $notices[] = $notice; + } + } + + return ['items' => $items, 'imageNotice' => $notices === [] ? null : implode(' ', $notices)]; + } + + public function mediaPaths(array $widget): array + { + $paths = []; + + foreach ($widget['data']['items'] ?? [] as $item) { + if (is_array($item) && PublicMedia::isPublicPath($item['image'] ?? null)) { + $paths[] = $item['image']; + } + } + + return $paths; + } + + public function summary(array $widget): string + { + $titles = array_filter(array_map(fn ($item) => is_array($item) ? ($item['title'] ?? null) : null, $widget['data']['items'] ?? [])); + + return count($titles).' Karten: '.implode(', ', $titles); + } +} diff --git a/app/Domain/Cms/Widgets/Types/CatalogCardsWidget.php b/app/Domain/Cms/Widgets/Types/CatalogCardsWidget.php new file mode 100644 index 0000000..2a8e5a1 --- /dev/null +++ b/app/Domain/Cms/Widgets/Types/CatalogCardsWidget.php @@ -0,0 +1,180 @@ + 'eine Karte je Zeile, Symbolfläche über dem Text', + 'wide' => 'mehrere Karten nebeneinander ab 16rem Kartenbreite', + ]; + } + + public function icon(): string + { + return 'heroicon-o-rectangle-stack'; + } + + public function schematic(): array + { + return [[2, 4, 26, 28, 'line'], [32, 4, 26, 28, 'line'], [5, 7, 20, 9, 'image'], [35, 7, 20, 9, 'image'], [5, 19, 18, 3, 'ink'], [35, 19, 18, 3, 'ink'], [5, 25, 8, 3, 'accent'], [35, 25, 8, 3, 'accent']]; + } + + public function variants(): array + { + return [ + 'standard' => 'Karten mit Kurzbeschreibung', + 'compact' => 'Kompakte Liste', + ]; + } + + public function dataRules(): array + { + return [ + 'heading' => ['nullable', 'string', 'max:160'], + 'intro' => ['nullable', 'string', 'max:400'], + ]; + } + + public function refRules(): array + { + return [ + 'items' => ['required', 'array', 'min:1', 'max:12'], + 'items.*.type' => ['required', 'string', 'in:composition'], + 'items.*.id' => ['required', 'integer'], + ]; + } + + public function dataFields(): array + { + return [ + TextInput::make('heading')->label('Abschnittsüberschrift (optional)')->maxLength(160), + Textarea::make('intro')->label('Einleitung (optional)')->rows(2)->maxLength(400), + ]; + } + + public function refFields(): array + { + return [ + Repeater::make('items') + ->label('Programme und Module') + ->helperText('Nur zur Anzeige freigegebene Programme und Module sind wählbar. Öffentlich erscheinen derzeit nur Programme mit öffentlicher Programmseite; Module nur in der Redaktionsvorschau.') + ->schema([ + Hidden::make('type')->default('composition'), + Select::make('id') + ->label('Programm oder Modul') + ->required() + ->live() + ->searchable() + ->getSearchResultsUsing(fn (?string $search): array => app(PublicCatalogReader::class)->search($search)) + ->getOptionLabelUsing(fn (mixed $value): ?string => app(PublicCatalogReader::class)->labelFor($value)) + ->options(fn (): array => app(PublicCatalogReader::class)->search(null, 10)), + ]) + ->minItems(1) + ->maxItems(12) + ->reorderableWithButtons() + ->itemLabel(fn (array $state): ?string => filled($state['id'] ?? null) ? app(PublicCatalogReader::class)->labelFor($state['id']) : null) + ->addActionLabel('Programm oder Modul hinzufügen'), + ]; + } + + public function clean(array $data, array $refs, WidgetErrors $errors): array + { + $reader = app(PublicCatalogReader::class); + $items = []; + $seen = []; + + foreach ($refs['items'] as $index => $item) { + $id = (int) $item['id']; + $composition = Composition::query()->with('editorialContentKind')->find($id); + + if ($composition === null || ! $reader->isSelectable($composition)) { + $errors->add("refs.items.$index.id", 'Dieses Objekt ist kein zur Anzeige freigegebenes Programm oder Modul.'); + + continue; + } + + if (isset($seen[$id])) { + continue; + } + + $seen[$id] = true; + $items[] = ['type' => 'composition', 'id' => $id]; + } + + $refs['items'] = $items; + + foreach (['heading', 'intro'] as $key) { + $data[$key] = filled($data[$key] ?? null) ? trim($data[$key]) : null; + } + + return [$data, $refs]; + } + + public function resolve(array $widget, RenderContext $context): array + { + $refs = is_array($widget['refs']['items'] ?? null) ? array_values($widget['refs']['items']) : []; + + return [ + 'entries' => app(PublicCatalogReader::class)->entries($refs, includeNonPublic: $context->preview), + ]; + } + + public function summary(array $widget): string + { + $count = count($widget['refs']['items'] ?? []); + $heading = $widget['data']['heading'] ?? null; + + return trim(($heading ? $heading.' · ' : '').($count === 1 ? '1 Verweis' : $count.' Verweise')); + } +} diff --git a/app/Domain/Cms/Widgets/Types/FaqWidget.php b/app/Domain/Cms/Widgets/Types/FaqWidget.php new file mode 100644 index 0000000..ca92261 --- /dev/null +++ b/app/Domain/Cms/Widgets/Types/FaqWidget.php @@ -0,0 +1,92 @@ + 'Fragen untereinander; Antwortlänge auf Lesebreite begrenzt', + ]; + } + + public function icon(): string + { + return 'heroicon-o-question-mark-circle'; + } + + public function schematic(): array + { + return [[4, 5, 34, 3, 'ink'], [4, 10, 50, 3, 'line'], [4, 17, 30, 3, 'ink'], [4, 22, 46, 3, 'line'], [4, 29, 38, 3, 'ink']]; + } + + public function dataRules(): array + { + return [ + 'items' => ['required', 'array', 'min:1', 'max:20'], + 'items.*.question' => ['required', 'string', 'max:300'], + 'items.*.answer' => ['required', 'string', 'max:2000'], + ]; + } + + public function dataFields(): array + { + return [ + Repeater::make('items') + ->label('Fragen') + ->schema([ + TextInput::make('question')->label('Frage')->required()->maxLength(300), + Textarea::make('answer')->label('Antwort')->rows(3)->required()->maxLength(2000), + ]) + ->minItems(1) + ->maxItems(20) + ->reorderableWithButtons() + ->collapsible() + ->itemLabel(fn (array $state): ?string => $state['question'] ?? null) + ->addActionLabel('Frage hinzufügen'), + ]; + } + + public function summary(array $widget): string + { + $count = count($widget['data']['items'] ?? []); + + return $count === 1 ? '1 Frage' : $count.' Fragen'; + } +} diff --git a/app/Domain/Cms/Widgets/Types/HeadingWidget.php b/app/Domain/Cms/Widgets/Types/HeadingWidget.php new file mode 100644 index 0000000..1151a33 --- /dev/null +++ b/app/Domain/Cms/Widgets/Types/HeadingWidget.php @@ -0,0 +1,83 @@ + 'Überschriftgröße folgt der Slotbreite', + ]; + } + + public function icon(): string + { + return 'heroicon-o-h1'; + } + + public function schematic(): array + { + return [[4, 8, 40, 6, 'ink'], [4, 19, 50, 3, 'line'], [4, 25, 36, 3, 'line']]; + } + + public function dataRules(): array + { + return [ + 'heading' => ['required', 'string', 'max:200'], + 'intro' => ['nullable', 'string', 'max:1000'], + ]; + } + + public function dataFields(): array + { + return [ + TextInput::make('heading')->label('Überschrift')->required()->maxLength(200), + Textarea::make('intro')->label('Einleitung')->rows(3)->maxLength(1000), + ]; + } + + public function summary(array $widget): string + { + return (string) ($widget['data']['heading'] ?? ''); + } + + public function pageTitle(array $widget): ?string + { + return $widget['data']['heading'] ?? null; + } +} diff --git a/app/Domain/Cms/Widgets/Types/HeroWidget.php b/app/Domain/Cms/Widgets/Types/HeroWidget.php new file mode 100644 index 0000000..ad02d15 --- /dev/null +++ b/app/Domain/Cms/Widgets/Types/HeroWidget.php @@ -0,0 +1,236 @@ + 'ab 860 px Containerbreite: Foto über die ganze Fläche, Text links auf heller Fläche; Mindesthöhe nach Höheneinstellung', + 'safety' => 'unter 860 px nur technischer Sicherheitsumbruch: Foto 16:9 über dem Text, Schaltflächen ab 440 px untereinander', + ]; + } + + public function narrowBehavior(): string + { + return 'Für breite Plätze (3 oder 4 Einheiten). Unter 860 px Containerbreite steht das Foto über dem Text; die Höhe richtet sich dann nach dem Inhalt.'; + } + + public function heights(): array + { + return [ + 'compact' => 'Kompakt (mind. 400 px)', + 'normal' => 'Normal (mind. 512 px)', + 'large' => 'Groß (mind. 640 px)', + ]; + } + + public function defaultHeight(): ?string + { + return 'normal'; + } + + public function icon(): string + { + return 'heroicon-o-sparkles'; + } + + public function schematic(): array + { + return [[2, 3, 56, 30, 'image'], [6, 8, 24, 6, 'ink'], [6, 16, 10, 2, 'accent'], [6, 21, 22, 3, 'line'], [6, 27, 12, 4, 'accent']]; + } + + public function variants(): array + { + return [ + 'photo_split' => 'Foto mit Textfläche', + 'editorial_solid' => 'Markenfläche (ohne Foto)', + ]; + } + + public function optionIcons(): array + { + return [ + 'variant' => ['photo_split' => 'heroicon-o-photo', 'editorial_solid' => 'heroicon-o-swatch'], + 'height' => ['compact' => 'heroicon-o-bars-2', 'normal' => 'heroicon-o-bars-3', 'large' => 'heroicon-o-bars-4'], + ]; + } + + public function settings(): array + { + return [ + 'heading_level' => PremiumFields::HEADING_LEVELS, + 'accent' => ['underline' => 'Gelbe Unterstreichung', 'rays' => 'Unterstreichung und Signalstrahlen', 'none' => 'Ohne Akzent'], + ]; + } + + public function settingLabels(): array + { + return [ + 'heading_level' => ['Überschriftenebene', 'Der erste Einstieg einer Seite ist immer die Hauptüberschrift (H1).'], + 'accent' => ['Markenakzent', 'Freigegebene Akzente aus dem Brand-UI-Kit. Vorgabe: gelbe Unterstreichung.'], + ]; + } + + /** + * Version 1 (bis Designiteration 1) → 2: Varianten abbilden, früheren Fokuspunkt in Prozent umrechnen, + * nicht mehr vorhandene Einstellungen (focus, text_side) entfernen. Inhalte bleiben unverändert. + */ + public function upgrade(array $widget, int $from): array + { + if ($from !== 1) { + return parent::upgrade($widget, $from); + } + + $widget['variant'] = in_array($widget['variant'] ?? null, ['highlight', 'editorial'], true) ? 'editorial_solid' : 'photo_split'; + $settings = is_array($widget['settings'] ?? null) ? $widget['settings'] : []; + $data = is_array($widget['data'] ?? null) ? $widget['data'] : []; + + if (! isset($data['focus_x'], $data['focus_y'])) { + $data = PremiumFields::focusFromEnum($settings['focus'] ?? null) + $data; + } + + unset($settings['focus'], $settings['text_side']); + $widget['settings'] = $settings; + $widget['data'] = $data; + + return $widget; + } + + public function dataRules(): array + { + return [ + 'heading' => ['required', 'string', 'max:200'], + 'text' => ['nullable', 'string', 'max:600'], + ] + PremiumFields::rules(); + } + + public function refRules(): array + { + return ImageRefFields::rules(); + } + + public function dataFields(): array + { + return [ + PremiumFields::eyebrowField(), + TextInput::make('heading')->label('Überschrift')->required()->maxLength(200)->live(onBlur: true), + Textarea::make('text')->label('Beschreibung')->rows(3)->maxLength(600)->live(onBlur: true), + PremiumFields::ctaFields(), + PremiumFields::altField(), + ...PremiumFields::focusFields(68, 50), + ]; + } + + public function refFields(): array + { + return ImageRefFields::fields(live: true); + } + + public function editorSchema(): array + { + [$eyebrow, $heading, $text, $ctas] = $this->dataFields(); + + return [Group::make([$eyebrow, $heading, $text, $ctas])->statePath('data')]; + } + + public function mediaSchema(): array + { + [, , , , $alt, $focusX, $focusY] = $this->dataFields(); + + return [ + Group::make($this->refFields())->statePath('refs'), + Group::make([$alt, $focusX, $focusY])->statePath('data'), + ]; + } + + public function clean(array $data, array $refs, WidgetErrors $errors): array + { + $refs = ImageRefFields::clean($refs, $errors); + $data['heading'] = trim((string) ($data['heading'] ?? '')); + $data['text'] = filled($data['text'] ?? null) ? trim((string) $data['text']) : null; + $data = PremiumFields::clean($data, $errors, $refs['image'] !== null); + + return [$data, $refs]; + } + + public function resolve(array $widget, RenderContext $context): array + { + $actions = PremiumFields::actions($widget['data']); + + $images = app(WebsiteImage::class); + $image = $widget['refs']['image'] ?? null; + + return [ + 'imageUrl' => $images->url($image, $context->preview), + 'imageAlt' => $images->alt($image, $widget['data']['alt'] ?? null), + 'imageNotice' => $context->preview ? $images->previewNotice($image) : null, + 'actions' => $actions, + 'action' => $actions[0] ?? null, + 'focus' => PremiumFields::focus($widget['data'], 68, 50), + 'accent' => in_array($widget['settings']['accent'] ?? null, ['underline', 'rays', 'none'], true) ? $widget['settings']['accent'] : 'underline', + ]; + } + + public function mediaPaths(array $widget): array + { + $image = $widget['refs']['image'] ?? null; + + return PublicMedia::isPublicPath($image) ? [$image] : []; + } + + public function summary(array $widget): string + { + return (string) ($widget['data']['heading'] ?? ''); + } + + public function pageTitle(array $widget): ?string + { + return $widget['data']['heading'] ?? null; + } +} diff --git a/app/Domain/Cms/Widgets/Types/ImageTextWidget.php b/app/Domain/Cms/Widgets/Types/ImageTextWidget.php new file mode 100644 index 0000000..f26ef3f --- /dev/null +++ b/app/Domain/Cms/Widgets/Types/ImageTextWidget.php @@ -0,0 +1,260 @@ + 'unter 540 px Containerbreite: Bild über dem Text, Schaltflächen untereinander in voller Breite', + 'band' => '540 bis 899 px: flacher Bildstreifen über dem vollständigen Text (typisch zwei Einheiten)', + 'wide' => 'ab 900 px: Bild und Text nebeneinander, Bild links oder rechts nach Variante', + ]; + } + + public function narrowBehavior(): string + { + return 'Unter 900 px Containerbreite steht das Bild über dem Text, unabhängig von „Bild links/rechts“; die gespeicherte Seite bleibt erhalten. Text und Schaltflächen werden nie gekürzt.'; + } + + public function heights(): array + { + return [ + 'compact' => 'Kompakt (flacheres Bild, engere Abstände)', + 'normal' => 'Normal', + 'spacious' => 'Großzügig (höheres Bild, mehr Abstand)', + ]; + } + + public function defaultHeight(): ?string + { + return 'normal'; + } + + public function icon(): string + { + return 'heroicon-o-photo'; + } + + public function schematic(): array + { + return [[4, 6, 22, 24, 'image'], [30, 7, 10, 2, 'accent'], [30, 11, 24, 4, 'ink'], [30, 18, 26, 3, 'line'], [30, 24, 14, 4, 'accent']]; + } + + public function variants(): array + { + return [ + 'image_left' => 'Bild links', + 'image_right' => 'Bild rechts', + ]; + } + + public function optionIcons(): array + { + return [ + 'variant' => ['image_left' => 'heroicon-o-arrow-left', 'image_right' => 'heroicon-o-arrow-right'], + 'height' => ['compact' => 'heroicon-o-bars-2', 'normal' => 'heroicon-o-bars-3', 'spacious' => 'heroicon-o-bars-4'], + ]; + } + + public function settings(): array + { + return [ + 'surface' => ['cream' => 'Creme (Markenfläche)', 'clear' => 'Ohne eigene Fläche', 'navy' => 'Navy (dunkel)'], + 'heading_level' => PremiumFields::HEADING_LEVELS, + ]; + } + + public function settingLabels(): array + { + return [ + 'surface' => ['Hintergrund des Widgets', 'Unabhängig vom Abschnittshintergrund. „Ohne eigene Fläche“ übernimmt den Abschnitt.'], + 'heading_level' => ['Überschriftenebene', 'Steht das Widget als erstes auf der Seite, ist die Überschrift immer H1.'], + ]; + } + + public function upgrade(array $widget, int $from): array + { + if ($from === 1) { + $data = $widget['data']; + + $widget['data'] = [ + 'title' => null, + 'body' => RichText::fromPlainText(is_string($data['body'] ?? null) ? $data['body'] : ''), + 'alt' => $data['alt'] ?? null, + ]; + $widget['refs'] = [ + 'image' => PublicMedia::fromUploadState($data['image'] ?? null), + ]; + + return $widget; + } + + if ($from === 2) { + // Designiteration 1 → Premium: Fokus in Prozent, Bildformat entfällt (Proportion folgt der Höhe). + $settings = is_array($widget['settings'] ?? null) ? $widget['settings'] : []; + $data = is_array($widget['data'] ?? null) ? $widget['data'] : []; + + if (! isset($data['focus_x'], $data['focus_y'])) { + $data = PremiumFields::focusFromEnum($settings['focus'] ?? null) + $data; + } + + unset($settings['focus'], $settings['format']); + $widget['settings'] = $settings; + $widget['data'] = $data; + + return $widget; + } + + return parent::upgrade($widget, $from); + } + + public function dataRules(): array + { + return [ + 'title' => ['nullable', 'string', 'max:160'], + 'body' => ['required', 'string', 'max:40000'], + ] + PremiumFields::rules(); + } + + public function refRules(): array + { + return ImageRefFields::rules(); + } + + public function dataFields(): array + { + return [ + PremiumFields::eyebrowField(), + TextInput::make('title')->label('Überschrift')->maxLength(160)->live(onBlur: true), + RichEditor::make('body') + ->label('Text') + ->required() + ->live(onBlur: true) + ->toolbarButtons(RichText::TOOLBAR), + PremiumFields::ctaFields(), + PremiumFields::altField(), + ...PremiumFields::focusFields(64, 43), + ]; + } + + public function refFields(): array + { + return ImageRefFields::fields(live: true); + } + + public function editorSchema(): array + { + [$eyebrow, $title, $body, $ctas] = $this->dataFields(); + + return [Group::make([$eyebrow, $title, $body, $ctas])->statePath('data')]; + } + + public function mediaSchema(): array + { + [, , , , $alt, $focusX, $focusY] = $this->dataFields(); + + return [ + Group::make($this->refFields())->statePath('refs'), + Group::make([$alt, $focusX, $focusY])->statePath('data'), + ]; + } + + public function clean(array $data, array $refs, WidgetErrors $errors): array + { + $refs = ImageRefFields::clean($refs, $errors); + $data['body'] = RichText::sanitize($data['body'] ?? ''); + $data['title'] = filled($data['title'] ?? null) ? trim((string) $data['title']) : null; + $data = PremiumFields::clean($data, $errors, $refs['image'] !== null); + + if (RichText::isBlank($data['body'])) { + $errors->add('data.body', 'Bitte einen Text eingeben.'); + } + + return [$data, $refs]; + } + + public function resolve(array $widget, RenderContext $context): array + { + $surface = $widget['settings']['surface'] ?? 'cream'; + + $images = app(WebsiteImage::class); + $image = $widget['refs']['image'] ?? null; + + return [ + 'imageUrl' => $images->url($image, $context->preview), + 'imageAlt' => $images->alt($image, $widget['data']['alt'] ?? null), + 'imageNotice' => $context->preview ? $images->previewNotice($image) : null, + 'body' => RichText::sanitize(is_string($widget['data']['body'] ?? null) ? $widget['data']['body'] : ''), + 'actions' => PremiumFields::actions($widget['data']), + 'focus' => PremiumFields::focus($widget['data'], 64, 43), + 'surface' => in_array($surface, ['cream', 'clear', 'navy'], true) ? $surface : 'cream', + ]; + } + + public function mediaPaths(array $widget): array + { + $image = $widget['refs']['image'] ?? null; + + return PublicMedia::isPublicPath($image) ? [$image] : []; + } + + public function summary(array $widget): string + { + $title = $widget['data']['title'] ?? null; + + return filled($title) ? (string) $title : RichText::excerpt($widget['data']['body'] ?? ''); + } +} diff --git a/app/Domain/Cms/Widgets/Types/MediaCardWidget.php b/app/Domain/Cms/Widgets/Types/MediaCardWidget.php new file mode 100644 index 0000000..39851d6 --- /dev/null +++ b/app/Domain/Cms/Widgets/Types/MediaCardWidget.php @@ -0,0 +1,101 @@ +search($term); + } + + protected function subjectLabel(mixed $id): ?string + { + return app(PublicMaterialReader::class)->labelFor($id); + } + + protected function rejectSubject(int $id): ?string + { + $element = ContentElement::query()->find($id); + + return $element !== null && app(PublicMaterialReader::class)->isSelectable($element) + ? null + : 'Dieser Inhalt ist archiviert oder gesperrt.'; + } + + protected function subject(mixed $id, RenderContext $context): ?CardSubject + { + return app(PublicMaterialReader::class)->subject($id, includeNonPublic: $context->preview); + } + + protected function defaultActionLabel(): string + { + return 'Im Programm ansehen'; + } + + protected function cardStyle(): string + { + return 'media'; + } + + protected function centralCoverId(mixed $id): ?int + { + $element = is_numeric($id) ? ContentElement::query()->find((int) $id) : null; + + return $element instanceof ContentElement + ? app(PresentationMedia::class)->coverElementId($element) + : null; + } +} diff --git a/app/Domain/Cms/Widgets/Types/PremiumCardWidget.php b/app/Domain/Cms/Widgets/Types/PremiumCardWidget.php new file mode 100644 index 0000000..d6fc682 --- /dev/null +++ b/app/Domain/Cms/Widgets/Types/PremiumCardWidget.php @@ -0,0 +1,334 @@ + 'Anzeigen', 'no' => 'Ausblenden']; + + /** Schlüssel des Fachobjekts in refs, zum Beispiel 'pillar'. */ + abstract protected function refKey(): string; + + abstract protected function refLabel(): string; + + abstract protected function refHelp(): string; + + /** + * @return array + */ + abstract protected function searchSubjects(?string $term): array; + + abstract protected function subjectLabel(mixed $id): ?string; + + /** Prüft beim Speichern, ob das Objekt gewählt werden darf; liefert sonst die Fehlermeldung. */ + abstract protected function rejectSubject(int $id): ?string; + + abstract protected function subject(mixed $id, RenderContext $context): ?CardSubject; + + abstract protected function defaultActionLabel(): string; + + /** Gestaltungsvariante des Kits: editorial, media oder catalog. */ + abstract protected function cardStyle(): string; + + public function view(): string + { + return 'widgets.premium_card'; + } + + public function supportedUnits(): array + { + return [1, 2, 3, 4]; + } + + public function preferredUnits(): int + { + return 1; + } + + public function stages(): array + { + return [ + 'stacked' => 'unter 520 px Kartenbreite: Bild oder Tafel über dem Text', + 'side' => 'ab 520 px: Bild links (42 %), Text rechts (58 %); das gewählte Bildformat bleibt erhalten', + ]; + } + + public function narrowBehavior(): string + { + return 'Unter 520 px Kartenbreite steht das Bild über dem Text. Ab etwa 240 px nutzbar, empfohlen ab 280 px (eine Einheit ab Tablet). Texte werden nie gekürzt.'; + } + + public function heights(): array + { + return [ + 'auto' => 'Natürliche Höhe', + 'fill' => 'An die Zeile angleichen', + ]; + } + + public function variants(): array + { + return [ + 'adaptive' => 'Anpassend (ab 520 px Bild neben Text)', + 'stacked' => 'Bild immer über dem Text', + ]; + } + + public function optionIcons(): array + { + return [ + 'variant' => ['adaptive' => 'heroicon-o-view-columns', 'stacked' => 'heroicon-o-bars-3-bottom-left'], + 'height' => ['auto' => 'heroicon-o-arrows-pointing-in', 'fill' => 'heroicon-o-arrows-up-down'], + ]; + } + + public function settings(): array + { + return [ + 'format' => ['landscape' => 'Querformat 16:9', 'square' => 'Quadrat 1:1', 'portrait' => 'Hochformat 3:4'], + 'fit' => ['cover' => 'Ausschnitt füllt die Fläche', 'contain' => 'Ganzes Bild zeigen (Dokument, Poster)'], + 'heading_level' => ['h3' => 'H3', 'h2' => 'H2', 'h4' => 'H4'], + 'show_summary' => self::SHOW, + 'show_kind' => self::SHOW, + 'show_meta' => self::SHOW, + 'show_action' => self::SHOW, + ]; + } + + public function settingLabels(): array + { + return [ + 'format' => ['Bildformat', 'Vorgabe: Querformat 16:9. Gilt auch neben dem Text; das Motiv wird nicht nachträglich hochkant beschnitten.'], + 'fit' => ['Bilddarstellung', 'Vorgabe: Ausschnitt. „Ganzes Bild“ zeigt Dokumente und Poster vollständig auf ruhiger Fläche.'], + 'heading_level' => ['Überschriftenebene', 'Vorgabe: H3, passend unter einer Abschnittsüberschrift (H2).'], + 'show_summary' => ['Kurzbeschreibung', 'Aus den Fachdaten. Vorgabe: anzeigen.'], + 'show_kind' => ['Art oder Label', 'Zum Beispiel „Thema“ oder „Merkblatt“. Vorgabe: anzeigen.'], + 'show_meta' => ['Zusatzangaben', 'Aus den Fachdaten, zum Beispiel Ausgabeart oder Programmzugehörigkeit. Vorgabe: anzeigen.'], + 'show_action' => ['Aktion', 'Verweis auf die öffentliche Seite des Fachobjekts, falls es eine gibt. Vorgabe: anzeigen.'], + ]; + } + + public function dataRules(): array + { + return [ + 'action_label' => ['nullable', 'string', 'max:60'], + 'note' => ['nullable', 'string', 'max:200'], + 'heading' => ['nullable', 'string', 'max:200'], + 'summary' => ['nullable', 'string', 'max:500'], + 'alt' => ['nullable', 'string', 'max:300'], + 'focus_x' => ['nullable', 'numeric', 'between:0,100'], + 'focus_y' => ['nullable', 'numeric', 'between:0,100'], + ]; + } + + public function refRules(): array + { + return [$this->refKey() => ['required', 'integer']] + ImageRefFields::rules(); + } + + public function dataFields(): array + { + return [ + TextInput::make('action_label') + ->label('Beschriftung der Aktion (optional)') + ->maxLength(60) + ->placeholder($this->defaultActionLabel()) + ->live(onBlur: true) + ->helperText('Das Linkziel ist immer die öffentliche Seite des gewählten Objekts und kann nicht frei gesetzt werden.'), + TextInput::make('note') + ->label('Hinweis (optional)') + ->maxLength(200) + ->live(onBlur: true) + ->helperText('Kurzer redaktioneller Satz über der Aktion, zum Beispiel „Für die nächste Kursstunde“. Begründet keine Berechtigung.'), + PremiumFields::altField(), + ...PremiumFields::focusFields(66, 45), + ]; + } + + public function refFields(): array + { + return [$this->subjectField(), ...ImageRefFields::fields(live: true)]; + } + + public function editorSchema(): array + { + [$action, $note] = $this->dataFields(); + + return [ + Group::make([$this->subjectField()])->statePath('refs'), + Group::make([ + $action, + $note, + // Zentrale Angaben aus der Redaktion als Platzhalter; eine eigene Eintragung ist als solche markiert. + TextInput::make('heading') + ->label('Anzeigename nur für diese Karte') + ->maxLength(200) + ->live(onBlur: true) + ->placeholder(fn (Get $get): string => $this->centralText($get('../refs.'.$this->refKey()), 'title') ?? 'Zentraler Anzeigename') + ->hint(fn (?string $state): string => filled($state) ? 'Eigene Angabe für diese Karte' : 'Aus der Redaktion') + ->hintColor(fn (?string $state): string => filled($state) ? 'warning' : 'gray') + ->helperText('Leer übernimmt den Anzeigenamen des Fachobjekts. Eine Eintragung gilt nur für diese Karte und ändert die Quelle nicht.'), + TextInput::make('summary') + ->label('Teaser nur für diese Karte') + ->maxLength(500) + ->live(onBlur: true) + ->placeholder(fn (Get $get): string => $this->centralText($get('../refs.'.$this->refKey()), 'summary') ?? 'Zentraler Teaser oder Kurzbeschreibung') + ->hint(fn (?string $state): string => filled($state) ? 'Eigene Angabe für diese Karte' : 'Aus der Redaktion') + ->hintColor(fn (?string $state): string => filled($state) ? 'warning' : 'gray') + ->helperText('Leer übernimmt Teaser oder Kurzbeschreibung. Lehrinhalt, Rechte und Preise bleiben unberührt.'), + ])->statePath('data'), + ]; + } + + public function mediaSchema(): array + { + [, , $alt, $focusX, $focusY] = $this->dataFields(); + + return [ + Group::make(ImageRefFields::fields('Kartenbild', live: true))->statePath('refs'), + Group::make([$alt, $focusX, $focusY])->statePath('data'), + ]; + } + + public function clean(array $data, array $refs, WidgetErrors $errors): array + { + $key = $this->refKey(); + $id = (int) $refs[$key]; + $rejection = $this->rejectSubject($id); + + if ($rejection !== null) { + $errors->add("refs.$key", $rejection); + } + + $refs[$key] = $id; + $refs = ImageRefFields::clean($refs, $errors); + + foreach (['action_label', 'note', 'alt', 'heading', 'summary'] as $field) { + $data[$field] = filled($data[$field] ?? null) ? trim((string) $data[$field]) : null; + } + + foreach (['focus_x', 'focus_y'] as $field) { + $value = $data[$field] ?? null; + $data[$field] = is_numeric($value) ? (int) round(max(0, min(100, (float) $value))) : null; + } + + return [$data, $refs]; + } + + public function resolve(array $widget, RenderContext $context): array + { + $settings = $widget['settings']; + $option = fn (string $key, string $default): string => is_string($settings[$key] ?? null) && isset($this->settingOptions()[$key][$settings[$key]]) ? $settings[$key] : $default; + $data = $widget['data']; + + $subject = $this->subject($widget['refs'][$this->refKey()] ?? null, $context); + $heading = filled($data['heading'] ?? null) ? trim((string) $data['heading']) : null; + $lead = filled($data['summary'] ?? null) ? trim((string) $data['summary']) : null; + + if ($subject instanceof CardSubject && ($heading !== null || $lead !== null)) { + $subject = $subject->withText($heading, $lead); + } + + $storedImage = WebsiteImage::normalize($widget['refs']['image'] ?? null); + $imageRef = $storedImage ?? $this->centralCoverId($widget['refs'][$this->refKey()] ?? null); + + return [ + 'subject' => $subject, + 'cardStyle' => $subject?->style ?? $this->cardStyle(), + 'imageUrl' => app(WebsiteImage::class)->url($imageRef, $context->preview), + 'alt' => app(WebsiteImage::class)->alt($imageRef, $data['alt'] ?? null), + 'imageNotice' => $context->preview ? app(WebsiteImage::class)->previewNotice($imageRef, 'Das Kartenbild') : null, + 'focus' => PremiumFields::focus($data, 66, 45), + 'format' => $option('format', 'landscape'), + 'fit' => $option('fit', 'cover'), + 'headingTag' => $option('heading_level', 'h3'), + 'show' => [ + 'summary' => ! array_key_exists('show_summary', $this->settings()) || $option('show_summary', 'yes') === 'yes', + 'kind' => ! array_key_exists('show_kind', $this->settings()) || $option('show_kind', 'yes') === 'yes', + 'meta' => $option('show_meta', 'yes') === 'yes', + 'action' => $option('show_action', 'yes') === 'yes', + ], + 'actionLabel' => filled($data['action_label'] ?? null) ? (string) $data['action_label'] : $this->defaultActionLabel(), + 'note' => filled($data['note'] ?? null) ? (string) $data['note'] : null, + 'stacked' => $widget['variant'] === 'stacked', + ]; + } + + public function mediaPaths(array $widget): array + { + $image = $widget['refs']['image'] ?? null; + + return PublicMedia::isPublicPath($image) ? [$image] : []; + } + + public function summary(array $widget): string + { + $label = $this->subjectLabel($widget['refs'][$this->refKey()] ?? null); + + return $label ?? 'Kein Objekt gewählt'; + } + + protected function centralCoverId(mixed $id): ?int + { + return null; + } + + /** + * Zentraler Anzeigename oder Teaser des gewählten Objekts (Redaktionsstand) für Platzhalter im Editor. + */ + private function centralText(mixed $id, string $field): ?string + { + if (blank($id)) { + return null; + } + + try { + $subject = $this->subject($id, RenderContext::preview()); + } catch (\Throwable) { + return null; + } + + $text = $subject?->{$field}; + + return is_string($text) && trim($text) !== '' ? Str::limit(trim($text), 120) : null; + } + + private function subjectField(): Select + { + return Select::make($this->refKey()) + ->label($this->refLabel()) + ->helperText($this->refHelp()) + ->required() + ->live() + ->searchable() + ->getSearchResultsUsing(fn (?string $search): array => $this->searchSubjects($search)) + ->getOptionLabelUsing(fn (mixed $value): ?string => $this->subjectLabel($value)) + ->options(fn (): array => $this->searchSubjects(null)); + } +} diff --git a/app/Domain/Cms/Widgets/Types/ProgramCardWidget.php b/app/Domain/Cms/Widgets/Types/ProgramCardWidget.php new file mode 100644 index 0000000..89dd33c --- /dev/null +++ b/app/Domain/Cms/Widgets/Types/ProgramCardWidget.php @@ -0,0 +1,110 @@ +cardSearch($term); + } + + protected function subjectLabel(mixed $id): ?string + { + return app(PublicCatalogReader::class)->cardLabelFor($id); + } + + protected function rejectSubject(int $id): ?string + { + $composition = Composition::query()->with('editorialContentKind')->find($id); + + return $composition !== null && app(PublicCatalogReader::class)->isCardSelectable($composition) + ? null + : 'Dieses Objekt ist kein Programm oder Modul mit bereitgestellter Fassung.'; + } + + protected function subject(mixed $id, RenderContext $context): ?CardSubject + { + return app(PublicCatalogReader::class)->subject($id, includeNonPublic: $context->preview); + } + + protected function defaultActionLabel(): string + { + return 'Programm ansehen'; + } + + protected function cardStyle(): string + { + return 'catalog'; + } + + protected function centralCoverId(mixed $id): ?int + { + $composition = is_numeric($id) ? Composition::query()->find((int) $id) : null; + + return $composition instanceof Composition + ? app(PresentationMedia::class)->coverElementId($composition) + : null; + } +} diff --git a/app/Domain/Cms/Widgets/Types/ProseWidget.php b/app/Domain/Cms/Widgets/Types/ProseWidget.php new file mode 100644 index 0000000..d62a15c --- /dev/null +++ b/app/Domain/Cms/Widgets/Types/ProseWidget.php @@ -0,0 +1,76 @@ + 'Zeilenlänge höchstens etwa 70 Zeichen', + ]; + } + + public function icon(): string + { + return 'heroicon-o-bars-3-bottom-left'; + } + + public function dataRules(): array + { + return [ + 'body' => ['required', 'string', 'max:20000'], + ]; + } + + public function dataFields(): array + { + return [ + Textarea::make('body') + ->label('Text') + ->rows(10) + ->required() + ->maxLength(20000) + ->helperText('Eine Leerzeile beginnt einen neuen Absatz.'), + ]; + } + + public function summary(array $widget): string + { + return RichText::excerpt(e((string) ($widget['data']['body'] ?? ''))); + } +} diff --git a/app/Domain/Cms/Widgets/Types/TopicCardWidget.php b/app/Domain/Cms/Widgets/Types/TopicCardWidget.php new file mode 100644 index 0000000..e0a1079 --- /dev/null +++ b/app/Domain/Cms/Widgets/Types/TopicCardWidget.php @@ -0,0 +1,137 @@ +orderBy('sort_order') + ->orderBy('name') + ->when($term !== '', fn ($query) => $query->whereRaw('LOWER(name) LIKE ?', ['%'.mb_strtolower($term).'%'])) + ->limit(50) + ->get() + ->mapWithKeys(fn (Pillar $pillar): array => [$pillar->id => $this->optionLabel($pillar)]) + ->all(); + } + + protected function subjectLabel(mixed $id): ?string + { + $pillar = is_numeric($id) ? Pillar::query()->find((int) $id) : null; + + return $pillar === null ? null : $this->optionLabel($pillar); + } + + protected function rejectSubject(int $id): ?string + { + return Pillar::query()->whereKey($id)->exists() ? null : 'Dieses Thema gibt es nicht.'; + } + + protected function subject(mixed $id, RenderContext $context): ?CardSubject + { + $pillar = is_numeric($id) ? Pillar::query()->find((int) $id) : null; + + if ($pillar === null) { + return null; + } + + $public = self::isPublic($pillar); + + if (! $public && ! $context->preview) { + return null; + } + + $summary = filled($pillar->public_summary) ? trim((string) $pillar->public_summary) : null; + $pages = $pillar->pages()->whereNotNull('published_revision_id')->count(); + $missing = []; + + if ($summary === null) { + $missing[] = 'Kein Text für die Website gepflegt (Fachliche Säulen → Text für die Website).'; + } + + return new CardSubject( + title: (string) $pillar->name, + summary: $summary, + kind: 'Thema', + badge: null, + meta: $pages > 0 ? [$pages === 1 ? '1 Seite zum Thema' : $pages.' Seiten zum Thema'] : [], + url: $public ? $pillar->publicUrl() : null, + public: $public, + notice: $public ? null : 'Nur in der Redaktionsvorschau sichtbar: Das Thema ist nicht veröffentlicht (Fachliche Säulen → Öffentliche Adresse und „Auf der Website veröffentlichen“).', + missing: $missing, + ); + } + + /** Öffentlich ist ein Thema mit Veröffentlichung und öffentlicher Adresse (dieselbe Regel wie /themen). */ + public static function isPublic(Pillar $pillar): bool + { + return $pillar->published_at !== null && filled($pillar->slug); + } + + private function optionLabel(Pillar $pillar): string + { + return $pillar->name.' · Thema · '.(self::isPublic($pillar) ? 'veröffentlicht' : 'nicht veröffentlicht, nur Redaktionsvorschau'); + } + + protected function defaultActionLabel(): string + { + return 'Thema entdecken'; + } + + protected function cardStyle(): string + { + return 'editorial'; + } +} diff --git a/app/Domain/Cms/Widgets/WidgetErrors.php b/app/Domain/Cms/Widgets/WidgetErrors.php new file mode 100644 index 0000000..b262e98 --- /dev/null +++ b/app/Domain/Cms/Widgets/WidgetErrors.php @@ -0,0 +1,30 @@ +> */ + private array $messages = []; + + public function add(string $key, string $message): void + { + $this->messages[$key][] = $message; + } + + public function isEmpty(): bool + { + return $this->messages === []; + } + + /** + * @return array> + */ + public function all(): array + { + return $this->messages; + } +} diff --git a/app/Domain/Cms/Widgets/WidgetRegistry.php b/app/Domain/Cms/Widgets/WidgetRegistry.php new file mode 100644 index 0000000..f287097 --- /dev/null +++ b/app/Domain/Cms/Widgets/WidgetRegistry.php @@ -0,0 +1,405 @@ + */ + private array $types = []; + + /** + * @param iterable $types + */ + public function __construct(iterable $types = []) + { + foreach ($types as $type) { + $this->register($type); + } + } + + public function register(WidgetType $type): void + { + $key = $type->key(); + + if (preg_match('/^[a-z][a-z0-9_]{1,40}$/', $key) !== 1) { + throw new InvalidArgumentException("Ungültige Widget-Kennung „{$key}“."); + } + + if (isset($this->types[$key])) { + throw new InvalidArgumentException("Die Widget-Kennung „{$key}“ ist bereits registriert."); + } + + if ($type->version() < 1) { + throw new InvalidArgumentException("Widget „{$key}“ braucht eine Schemaversion ab 1."); + } + + // Gemeinsamer Layoutvertrag (ADR-38): Breiten, Vorzugsbreite und Höhen aus festen Wertebereichen. + $units = $type->supportedUnits(); + if ($units === [] || array_diff($units, [1, 2, 3, 4]) !== [] || $units !== array_values(array_unique($units)) || ! $type->supportsUnits($type->preferredUnits())) { + throw new InvalidArgumentException("Widget „{$key}“ braucht unterstützte Breiten zwischen 1 und 4 Rastereinheiten und eine darin enthaltene Vorzugsbreite."); + } + + if (array_diff(array_keys($type->heights()), array_keys(WidgetType::HEIGHTS)) !== []) { + throw new InvalidArgumentException("Widget „{$key}“ verwendet eine Höhe außerhalb des gemeinsamen Vokabulars."); + } + + if (array_key_exists('height', $type->settings())) { + throw new InvalidArgumentException("Widget „{$key}“ deklariert die Höhe über heights(), nicht über settings()."); + } + + if ($type->variants() === []) { + throw new InvalidArgumentException("Widget „{$key}“ braucht mindestens eine Darstellungsvariante."); + } + + foreach (array_keys($type->variants()) as $variant) { + if (preg_match('/^[a-z][a-z0-9_]*$/', (string) $variant) !== 1) { + throw new InvalidArgumentException("Widget „{$key}“ hat eine ungültige Variantenkennung."); + } + } + + $this->types[$key] = $type; + } + + public function has(mixed $key): bool + { + return is_string($key) && isset($this->types[$key]); + } + + public function get(string $key): WidgetType + { + return $this->types[$key] ?? throw new InvalidArgumentException("Unbekannte Widget-Art „{$key}“."); + } + + /** + * @return array + */ + public function all(): array + { + return $this->types; + } + + /** + * @return array + */ + public function labels(): array + { + return array_map(fn (WidgetType $type): string => $type->label(), $this->types); + } + + /** + * Hebt einen gespeicherten Baustein auf die aktuelle Hülle an. Unbekannte Arten liefern null. + * + * @param array $block + * @return array{id: ?string, type: string, v: int, variant: string, settings: array, data: array, refs: array}|null + */ + public function upcast(array $block): ?array + { + $key = $block['type'] ?? null; + + if (! $this->has($key)) { + return null; + } + + $type = $this->get($key); + + if (array_key_exists('v', $block)) { + $widget = [ + 'id' => is_string($block['id'] ?? null) ? $block['id'] : null, + 'type' => $key, + 'v' => max(1, (int) $block['v']), + 'variant' => is_string($block['variant'] ?? null) ? $block['variant'] : $type->defaultVariant(), + 'settings' => is_array($block['settings'] ?? null) ? $block['settings'] : [], + 'data' => is_array($block['data'] ?? null) ? $block['data'] : [], + 'refs' => is_array($block['refs'] ?? null) ? $block['refs'] : [], + ]; + } else { + $legacy = $type->fromLegacy($block); + $widget = [ + 'id' => null, + 'type' => $key, + 'v' => 1, + 'variant' => $legacy['variant'] ?? $type->defaultVariant(), + 'settings' => [], + 'data' => $legacy['data'], + 'refs' => $legacy['refs'], + ]; + } + + while ($widget['v'] < $type->version()) { + $from = $widget['v']; + $widget = $type->upgrade($widget, $from); + $widget['v'] = $from + 1; + } + + if (! array_key_exists($widget['variant'], $type->variants())) { + $widget['variant'] = $type->defaultVariant(); + } + + return $widget; + } + + /** + * Prüft und bereinigt eine flache Bausteinliste (Fehlerschlüssel "blocks.N…"). + * + * @param array $blocks + * @return list, data: array, refs: array}> + */ + public function normalize(array $blocks): array + { + $normalized = []; + $seenIds = []; + + foreach (array_values($blocks) as $index => $block) { + $normalized[] = $this->normalizeWidget($block, "blocks.$index", $seenIds); + } + + return $normalized; + } + + /** + * Prüft und bereinigt einen einzelnen Baustein für eine neue Revision. Der Aufrufer führt die Menge + * bereits vergebener Kennungen über die ganze Seite, damit kopierte Widgets neue Kennungen erhalten. + * + * @param array $seenIds + * @return array{id: string, type: string, v: int, variant: string, settings: array, data: array, refs: array} + */ + public function normalizeWidget(mixed $block, string $errorPrefix, array &$seenIds): array + { + if (! is_array($block)) { + throw ValidationException::withMessages([ + $errorPrefix => 'Ein Baustein ist unvollständig.', + ]); + } + + if (! $this->has($block['type'] ?? null)) { + throw ValidationException::withMessages([ + "$errorPrefix.type" => 'Dieser Bausteintyp ist nicht freigegeben.', + ]); + } + + $type = $this->get($block['type']); + + if (array_key_exists('v', $block) && (int) $block['v'] > $type->version()) { + throw ValidationException::withMessages([ + "$errorPrefix.v" => 'Dieser Baustein stammt aus einer neueren Programmfassung und kann hier nicht gespeichert werden.', + ]); + } + + $requested = $block['variant'] ?? null; + $isCurrent = array_key_exists('v', $block) && (int) $block['v'] === $type->version(); + + if ($isCurrent && is_string($requested) && $requested !== '' && ! array_key_exists($requested, $type->variants())) { + throw ValidationException::withMessages([ + "$errorPrefix.variant" => 'Diese Darstellungsvariante ist für den Baustein nicht freigegeben.', + ]); + } + + return $this->validateOne($type, $this->upcast($block), $errorPrefix, $seenIds); + } + + /** + * Gespeicherte Bausteine einer Revision als aktuelle Hüllen; unbekannte Arten entfallen. + * + * @param array|null $blocks + * @return list> + */ + public function read(?array $blocks): array + { + $widgets = []; + + foreach (array_values($blocks ?? []) as $block) { + if (is_array($block) && ($widget = $this->upcast($block)) !== null) { + $widgets[] = $widget; + } + } + + return $widgets; + } + + /** + * @param array|null $blocks + */ + public function pageTitle(?array $blocks): ?string + { + foreach ($this->read($blocks) as $widget) { + $title = $this->get($widget['type'])->pageTitle($widget); + + if (is_string($title) && trim($title) !== '') { + return $title; + } + } + + return null; + } + + /** + * @param array|null $blocks + * @return list + */ + public function mediaPaths(?array $blocks): array + { + $paths = []; + + foreach ($this->read($blocks) as $widget) { + foreach ($this->get($widget['type'])->mediaPaths($widget) as $path) { + $paths[] = $path; + } + } + + return array_values(array_unique($paths)); + } + + /** + * @param array $widget + * @param array $seenIds + * @return array{id: string, type: string, v: int, variant: string, settings: array, data: array, refs: array} + */ + private function validateOne(WidgetType $type, array $widget, string $errorPrefix, array &$seenIds): array + { + $errors = new WidgetErrors; + + $variant = $widget['variant']; + if (! array_key_exists($variant, $type->variants())) { + $errors->add('variant', 'Diese Darstellungsvariante ist für den Baustein nicht freigegeben.'); + } + + $settings = []; + $allowedSettings = $type->settingOptions(); + foreach ($widget['settings'] as $key => $value) { + if ($value === null || $value === '') { + continue; + } + + if (! isset($allowedSettings[$key]) || ! is_string($value) || ! array_key_exists($value, $allowedSettings[$key])) { + $errors->add("settings.$key", 'Diese Einstellung ist für den Baustein nicht freigegeben.'); + + continue; + } + + $settings[$key] = $value; + } + + $rules = []; + foreach ($type->dataRules() as $key => $rule) { + $rules["data.$key"] = $rule; + } + foreach ($type->refRules() as $key => $rule) { + $rules["refs.$key"] = $rule; + } + + $validator = Validator::make(['data' => $widget['data'], 'refs' => $widget['refs']], $rules); + + foreach ($validator->errors()->messages() as $key => $messages) { + foreach ($messages as $message) { + $errors->add($key, $message); + } + } + + $data = $this->onlyDeclared($widget['data'], $type->dataRules()); + $refs = $this->onlyDeclared($widget['refs'], $type->refRules()); + + if ($errors->isEmpty()) { + [$data, $refs] = $type->clean($data, $refs, $errors); + } + + if (! $errors->isEmpty()) { + $messages = []; + foreach ($errors->all() as $key => $list) { + $messages["$errorPrefix.$key"] = $list; + } + + throw ValidationException::withMessages($messages); + } + + $id = $widget['id']; + if (! is_string($id) || preg_match('/^[A-Za-z0-9-]{1,64}$/', $id) !== 1 || isset($seenIds[$id])) { + $id = (string) Str::uuid(); + } + $seenIds[$id] = true; + + return [ + 'id' => $id, + 'type' => $type->key(), + 'v' => $type->version(), + 'variant' => $variant, + 'settings' => $settings, + 'data' => $this->withoutTransient($data), + 'refs' => $this->withoutTransient($refs), + ]; + } + + /** + * Behält nur Schlüssel, für die Prüfregeln bestehen; Listen ('items.*.feld') werden je Eintrag gefiltert. + * + * @param array $values + * @param array $rules + * @return array + */ + private function onlyDeclared(array $values, array $rules): array + { + $top = []; + $nested = []; + + foreach (array_keys($rules) as $key) { + if (preg_match('/^([a-z_]+)\.\*\.([a-z_]+)$/', (string) $key, $match) === 1) { + $nested[$match[1]][] = $match[2]; + } elseif (! str_contains((string) $key, '.')) { + $top[] = (string) $key; + } + } + + $clean = []; + foreach ($top as $key) { + $value = $values[$key] ?? null; + + if (isset($nested[$key])) { + $items = []; + foreach (array_values(is_array($value) ? $value : []) as $item) { + if (! is_array($item)) { + continue; + } + + $entry = []; + foreach ($nested[$key] as $field) { + $entry[$field] = $item[$field] ?? null; + } + $items[] = $entry; + } + $value = $items; + } + + $clean[$key] = $value; + } + + return $clean; + } + + /** + * Felder mit führendem Unterstrich (zum Beispiel '_upload') sind reine Editorhilfen und werden nicht gespeichert. + * + * @param array $values + * @return array + */ + private function withoutTransient(array $values): array + { + foreach (array_keys($values) as $key) { + if (str_starts_with((string) $key, '_')) { + unset($values[$key]); + } + } + + return $values; + } +} diff --git a/app/Domain/Cms/Widgets/WidgetRenderer.php b/app/Domain/Cms/Widgets/WidgetRenderer.php new file mode 100644 index 0000000..c3d5840 --- /dev/null +++ b/app/Domain/Cms/Widgets/WidgetRenderer.php @@ -0,0 +1,83 @@ +|null $blocks gespeicherte Bausteine (Altformat oder Hülle) + */ + public function renderAll(?array $blocks, RenderContext $context): HtmlString + { + $html = ''; + $position = 0; + + foreach (array_values($blocks ?? []) as $block) { + if (! is_array($block)) { + continue; + } + + $widget = $this->registry->upcast($block); + + if ($widget === null) { + if ($context->preview) { + $html .= '

Unbekannter Baustein „'.e((string) ($block['type'] ?? '')).'“ wird öffentlich nicht angezeigt.

'; + } + + continue; + } + + $rendered = $this->renderWidget($widget, $context, $position === 0); + + if ($rendered !== '') { + $html .= $rendered; + $position++; + } + } + + return new HtmlString($html); + } + + /** + * Rendert eine Instanz samt Abschnittshülle. Liefert '' wenn das Widget nichts darzustellen hat. + * + * @param array $widget aktuelle Hülle + */ + public function renderWidget(array $widget, RenderContext $context, bool $first = false): string + { + $type = $this->registry->get($widget['type']); + + $inner = trim(view($type->view(), [ + 'widget' => $widget, + 'data' => $widget['data'], + 'refs' => $widget['refs'], + 'variant' => $widget['variant'], + 'settings' => $widget['settings'], + 'height' => $type->height($widget), + 'first' => $first, + 'context' => $context, + ] + $type->resolve($widget, $context))->render()); + + if ($inner === '') { + return ''; + } + + $id = is_string($widget['id'] ?? null) ? ' id="abschnitt-'.e($widget['id']).'"' : ''; + + // Gemeinsamer Layoutvertrag (ADR-38): Höhe als Klasse an der Hülle, nur wenn die Art Höhen anbietet. + $height = $type->height($widget); + $heightClass = $height !== null ? ' widget-height-'.e($height) : ''; + + return '
' + .$inner + .'
'; + } +} diff --git a/app/Domain/Cms/Widgets/WidgetType.php b/app/Domain/Cms/Widgets/WidgetType.php new file mode 100644 index 0000000..20bded9 --- /dev/null +++ b/app/Domain/Cms/Widgets/WidgetType.php @@ -0,0 +1,373 @@ + 'Automatisch', + 'compact' => 'Kompakt', + 'normal' => 'Normal', + 'large' => 'Groß', + 'spacious' => 'Großzügig', + 'fill' => 'Abschnittshöhe füllen', + ]; + + /** + * Gemeinsamer Layoutvertrag (ADR-38), Teil 1: zulässige Platzbreiten in logischen Rastereinheiten (1 bis 4). + * Ein Platz mit nicht unterstützter Breite wird beim Speichern abgewiesen. Auf Tablet und Smartphone stapeln die + * Plätze; dort bestimmt die tatsächliche Containerbreite die Darstellung (Container-Abfragen), nicht die Einheitenzahl. + * + * @return list + */ + public function supportedUnits(): array + { + return [1, 2, 3, 4]; + } + + public function supportsUnits(int $units): bool + { + return in_array($units, $this->supportedUnits(), true); + } + + /** Kleinste zulässige Platzbreite; abgeleitet aus supportedUnits(). */ + public function minUnits(): int + { + return min($this->supportedUnits()); + } + + /** Lesbare Angabe der zulässigen Platzbreiten, zum Beispiel „1 bis 4“ oder „3 oder 4“. */ + public function unitsLabel(): string + { + $units = $this->supportedUnits(); + + if (count($units) === 1) { + return (string) $units[0]; + } + + if ($units === range(min($units), max($units)) && count($units) > 2) { + return min($units).' bis '.max($units); + } + + $last = array_pop($units); + + return implode(', ', $units).' oder '.$last; + } + + /** Empfohlene Slotbreite in Rastereinheiten; Hinweis in der Widget-Auswahl. */ + public function preferredUnits(): int + { + return 4; + } + + /** + * Darstellungsstufen nach verfügbarer Breite (Container-Abfragen in der Widget-Ansicht): Kennung => Beschreibung. + * Dokumentiert, wie sich das Widget an schmale und breite Slots anpasst. + * + * @return array + */ + public function stages(): array + { + return ['fluid' => 'passt sich fließend an jede Slotbreite an']; + } + + /** + * Gemeinsamer Layoutvertrag, Teil 2: angebotene Höhen (Schlüssel aus HEIGHTS => Bezeichnung im Editor). + * Leer: keine Höhenwahl, die Höhe folgt dem Inhalt. Der erste Eintrag ist die Vorgabe. + * + * @return array + */ + public function heights(): array + { + return []; + } + + public function defaultHeight(): ?string + { + $key = array_key_first($this->heights()); + + return $key === null ? null : (string) $key; + } + + /** + * Wirksame Höhe einer Instanz (gespeicherte Einstellung oder Vorgabe). + * + * @param array $widget + */ + public function height(array $widget): ?string + { + $height = $widget['settings']['height'] ?? null; + + return is_string($height) && array_key_exists($height, $this->heights()) ? $height : $this->defaultHeight(); + } + + /** Gemeinsamer Layoutvertrag, Teil 3: Verhalten bei reduziertem Platzangebot (Hinweis im Editor und in der Dokumentation). */ + public function narrowBehavior(): string + { + return 'Text bricht um, nichts wird abgeschnitten.'; + } + + /** Heroicon-Name für Auswahl und Liste im Editor. */ + public function icon(): string + { + return 'heroicon-o-square-3-stack-3d'; + } + + /** + * Symbolische Vorschau für die Widget-Auswahl: Liste von Flächen [x, y, b, h, ton] in einem 60×36-Raster. + * Ton: 'ink', 'accent', 'line', 'image'. Kein redaktioneller Inhalt. + * + * @return list + */ + public function schematic(): array + { + return [[4, 6, 52, 4, 'ink'], [4, 14, 40, 3, 'line'], [4, 20, 44, 3, 'line'], [4, 26, 30, 3, 'line']]; + } + + /** + * Freigegebene Darstellungsvarianten: Kennung => Bezeichnung. Die erste ist die Vorgabe. + * + * @return array + */ + public function variants(): array + { + return ['standard' => 'Standard']; + } + + public function defaultVariant(): string + { + return (string) array_key_first($this->variants()); + } + + /** + * Zulässige Einstellungen: Schlüssel => [Wert => Bezeichnung]. Keine freien CSS-Klassen. + * + * @return array> + */ + public function settings(): array + { + return []; + } + + /** + * Bezeichnungen der Einstellungen im Editor: Schlüssel => [Bezeichnung, Hilfetext]. + * Ohne leere Auswahl gilt die Vorgabe der Darstellung. + * + * @return array + */ + public function settingLabels(): array + { + return []; + } + + /** + * Alle zulässigen Einstellungen einschließlich der gemeinsamen Höhe. Registry-Prüfung, Editor und Darstellung + * verwenden ausschließlich diese Zusammenführung. + * + * @return array> + */ + final public function settingOptions(): array + { + $options = $this->settings(); + + if ($this->heights() !== []) { + $options['height'] = $this->heights(); + } + + return $options; + } + + /** + * Symbole für die visuelle Auswahl im Editor: 'variant' oder Einstellungsschlüssel => [Wert => Heroicon]. + * + * @return array> + */ + public function optionIcons(): array + { + return []; + } + + /** + * Prüfregeln für data. Schlüssel relativ zu data (zum Beispiel 'heading', 'items.*.title'). + * + * @return array + */ + abstract public function dataRules(): array; + + /** + * Prüfregeln für refs, relativ zu refs. + * + * @return array + */ + public function refRules(): array + { + return []; + } + + /** + * Formularfelder für data. Sie werden im Editor unter dem Zustandspfad 'data' eingehängt. + * + * @return list + */ + abstract public function dataFields(): array; + + /** + * Formularfelder für refs, eingehängt unter 'refs'. + * + * @return list + */ + public function refFields(): array + { + return []; + } + + /** + * Anordnung der Felder im Bearbeitungsdialog. Vorgabe: Inhalte, dann Verweise. + * Eine Art kann die Reihenfolge ändern, solange Felder unter 'data' beziehungsweise 'refs' bleiben. + * + * @return list + */ + /** + * Felder der Gruppe „Medien“ im Bearbeitungsdialog (Bild, Bildausschnitt, Alternativtext). Leer: keine eigene Gruppe; + * Verweise stehen dann mit im Inhalt (editorSchema()). + * + * @return list + */ + public function mediaSchema(): array + { + return []; + } + + public function editorSchema(): array + { + $schema = []; + + if ($this->dataFields() !== []) { + $schema[] = Group::make($this->dataFields())->statePath('data'); + } + + if ($this->refFields() !== []) { + $schema[] = Group::make($this->refFields())->statePath('refs'); + } + + return $schema; + } + + /** Blade-Ansicht. Sie dient öffentlicher Seite, ganzseitiger Vorschau und Blockvorschau gleichermaßen. */ + public function view(): string + { + return 'widgets.'.$this->key(); + } + + /** + * Übersetzt einen Altbaustein ohne Hülle (Bestand vor der Registry) in data/refs/variant der Version 1. + * + * @param array $legacy + * @return array{data: array, refs: array, variant?: string} + */ + public function fromLegacy(array $legacy): array + { + unset($legacy['type']); + + return ['data' => $legacy, 'refs' => []]; + } + + /** + * Hebt eine Instanz von Version $from auf $from + 1. Alte Revisionen bleiben gespeichert, wie sie sind. + * + * @param array $widget + * @return array + */ + public function upgrade(array $widget, int $from): array + { + throw new \LogicException(sprintf('Widget %s kennt keinen Schritt von Version %d.', $this->key(), $from)); + } + + /** + * Bereinigt geprüfte Inhalte vor dem Speichern (Adressen, formatierter Text, Bildauswahl). + * + * @param array $data + * @param array $refs + * @return array{0: array, 1: array} + */ + public function clean(array $data, array $refs, WidgetErrors $errors): array + { + return [$data, $refs]; + } + + /** + * Löst Verweise für die Darstellung auf und liefert zusätzliche Ansichtsvariablen. + * + * @param array $widget + * @return array + */ + public function resolve(array $widget, RenderContext $context): array + { + return []; + } + + /** + * Öffentliche Medienpfade dieser Instanz (für Veröffentlichung und Verwendungsnachweis). + * + * @param array $widget + * @return list + */ + public function mediaPaths(array $widget): array + { + return []; + } + + /** + * Kurze Inhaltszusammenfassung für die Abschnittsliste im Editor. + * + * @param array $widget + */ + public function summary(array $widget): string + { + return ''; + } + + /** + * Titel, den eine Seite aus diesem Widget übernehmen kann, wenn kein SEO-Titel gesetzt ist. + * + * @param array $widget + */ + public function pageTitle(array $widget): ?string + { + return null; + } +} diff --git a/app/Domain/Commerce/Checkout.php b/app/Domain/Commerce/Checkout.php new file mode 100644 index 0000000..6084070 --- /dev/null +++ b/app/Domain/Commerce/Checkout.php @@ -0,0 +1,191 @@ +status !== AccountStatus::Aktiv || $user->party_id === null) { + throw new DomainRuleException('Nur ein aktives Mitglied kann kaufen.'); + } + + $version = $this->offers->currentActiveVersion($offer); + + if ($version->grant_kind !== 'kauf' || $version->holder_kind !== 'person') { + throw new DomainRuleException('Dieses Angebot kann nicht als persönlicher Kauf bestellt werden.'); + } + + if ($version->price_cents === null) { + throw new DomainRuleException('Der Kauf braucht einen Preis an der Angebotsfassung.'); + } + + return DB::transaction(function () use ($user, $offer, $version): Order { + $order = Order::query()->create([ + 'user_id' => $user->id, + 'party_id' => $user->party_id, + 'status' => 'offen', + 'holder_kind' => 'person', + ]); + $line = $order->lines()->create([ + 'offer_version_id' => $version->id, + 'offer_name' => $offer->name, + 'price_cents' => $version->price_cents, + 'term_rule' => $version->term_rule, + 'update_promise' => $version->update_promise, + 'holder_kind' => $version->holder_kind, + ]); + $version->load('resolvedScopes.rights'); + + foreach ($version->resolvedScopes as $scope) { + $line->scopeItems()->create([ + 'license_article_id' => $scope->license_article_id, + 'rights_profile_version_id' => $scope->rights_profile_version_id, + 'rights_snapshot' => [ + 'purpose' => $scope->rights->purpose, + 'capabilities' => $scope->rights->capabilities, + 'options' => $scope->rights->options ?? [], + ], + ]); + } + + return $order->load('lines.scopeItems'); + }); + } + + public function confirmTestPayment(Order $order, string $reference): Order + { + $this->assertTestDriver(); + $reference = trim($reference); + + if ($reference === '') { + throw new DomainRuleException('Die Zahlungsreferenz fehlt.'); + } + + $paidNow = false; + $order = DB::transaction(function () use ($order, $reference, &$paidNow): Order { + $order = Order::query()->lockForUpdate()->findOrFail($order->id); + + if ($order->status === 'bezahlt') { + return $order->load('lines', 'payments'); + } + + if ($order->status !== 'offen') { + throw new DomainRuleException('Diese Bestellung nimmt keine Zahlung mehr an.'); + } + + $order->payments()->create([ + 'provider' => 'test', + 'status' => 'bestaetigt', + 'provider_reference' => $reference, + ]); + $order->status = 'bezahlt'; + $order->save(); + $paidNow = true; + $line = $order->lines()->firstOrFail(); + $this->grants->issue( + $order->user, + $line->offerVersion, + AcquisitionType::Bestellposition, + 'order_line', + $line->id, + ); + + return $order->load('lines', 'payments'); + }); + + if ($paidNow) { + Mail::to($order->user)->send(new OrderConfirmed($order)); + } + + return $order; + } + + public function failTestPayment(Order $order, string $reference): Order + { + $this->assertTestDriver(); + + return DB::transaction(function () use ($order, $reference): Order { + $order = Order::query()->lockForUpdate()->findOrFail($order->id); + + if ($order->status !== 'offen') { + return $order; + } + + $order->payments()->create([ + 'provider' => 'test', + 'status' => 'fehlgeschlagen', + 'provider_reference' => $reference, + ]); + $order->status = 'fehlgeschlagen'; + $order->save(); + + return $order; + }); + } + + public function refund(Order $order, string $reason): Order + { + $reason = trim($reason); + + if ($reason === '') { + throw new DomainRuleException('Eine Erstattung braucht eine Begründung.'); + } + + return DB::transaction(function () use ($order, $reason): Order { + $order = Order::query()->lockForUpdate()->findOrFail($order->id); + + if ($order->status !== 'bezahlt') { + throw new DomainRuleException('Nur eine bezahlte Bestellung kann erstattet werden.'); + } + + $line = $order->lines()->firstOrFail(); + $acquisition = Acquisition::query()->where([ + 'type' => AcquisitionType::Bestellposition, + 'reference_type' => 'order_line', + 'reference_id' => $line->id, + ])->first(); + + if ($acquisition !== null) { + foreach ($acquisition->grants as $grant) { + if ($grant->status === GrantStatus::Aktiv) { + $grant->status = GrantStatus::Widerrufen; + $grant->status_reason = $reason; + $grant->save(); + } + } + } + + $order->payments()->where('status', 'bestaetigt')->update(['status' => 'erstattet']); + $order->status = 'erstattet'; + $order->save(); + + return $order->refresh(); + }); + } + + private function assertTestDriver(): void + { + if (app()->isProduction() || config('services.payment.driver') !== 'test') { + throw new DomainRuleException('Der Testzahlungsweg ist nicht aktiv.'); + } + } +} diff --git a/app/Domain/Commerce/Order.php b/app/Domain/Commerce/Order.php new file mode 100644 index 0000000..50d8254 --- /dev/null +++ b/app/Domain/Commerce/Order.php @@ -0,0 +1,39 @@ +belongsTo(User::class); + } + + public function party(): BelongsTo + { + return $this->belongsTo(Party::class); + } + + public function lines(): HasMany + { + return $this->hasMany(OrderLine::class); + } + + public function payments(): HasMany + { + return $this->hasMany(Payment::class); + } +} diff --git a/app/Domain/Commerce/OrderLine.php b/app/Domain/Commerce/OrderLine.php new file mode 100644 index 0000000..13e4a18 --- /dev/null +++ b/app/Domain/Commerce/OrderLine.php @@ -0,0 +1,36 @@ +belongsTo(Order::class); + } + + public function offerVersion(): BelongsTo + { + return $this->belongsTo(OfferVersion::class); + } + + public function scopeItems(): HasMany + { + return $this->hasMany(OrderScopeItem::class); + } +} diff --git a/app/Domain/Commerce/OrderScopeItem.php b/app/Domain/Commerce/OrderScopeItem.php new file mode 100644 index 0000000..3456231 --- /dev/null +++ b/app/Domain/Commerce/OrderScopeItem.php @@ -0,0 +1,34 @@ + 'array', + ]; + } + + public function line(): BelongsTo + { + return $this->belongsTo(OrderLine::class, 'order_line_id'); + } + + public function article(): BelongsTo + { + return $this->belongsTo(LicenseArticle::class, 'license_article_id'); + } +} diff --git a/app/Domain/Commerce/Payment.php b/app/Domain/Commerce/Payment.php new file mode 100644 index 0000000..782f04a --- /dev/null +++ b/app/Domain/Commerce/Payment.php @@ -0,0 +1,21 @@ +belongsTo(Order::class); + } +} diff --git a/app/Domain/Entitlement/AccessResult.php b/app/Domain/Entitlement/AccessResult.php new file mode 100644 index 0000000..5ad26bf --- /dev/null +++ b/app/Domain/Entitlement/AccessResult.php @@ -0,0 +1,12 @@ + AcquisitionType::class, + 'conditions' => 'array', + ]; + } + + public function party(): BelongsTo + { + return $this->belongsTo(Party::class); + } + + public function grants(): HasMany + { + return $this->hasMany(Grant::class); + } +} diff --git a/app/Domain/Entitlement/AcquisitionType.php b/app/Domain/Entitlement/AcquisitionType.php new file mode 100644 index 0000000..0726618 --- /dev/null +++ b/app/Domain/Entitlement/AcquisitionType.php @@ -0,0 +1,11 @@ +status !== AccountStatus::Aktiv) { + return new AccessResult(false, null, 'Das Konto ist nicht aktiv.'); + } + + if ($release->license_article_id !== $article->id) { + return new AccessResult(false, null, 'Der Stand gehört zu einem anderen Artikel.'); + } + + if (! in_array($release->status, [ReleaseStatus::Veroeffentlicht, ReleaseStatus::AbgeloestVerfuegbar], true)) { + return new AccessResult(false, null, 'Dieser Stand ist nicht freigegeben.'); + } + + $contained = $release->contents()->where('content_element_version_id', $version->id)->exists(); + + if (! $contained) { + return new AccessResult(false, null, 'Die Fassung gehört nicht zum fixierten Inhalt dieses Stands.'); + } + + if ($version->status === ContentVersionStatus::Gesperrt) { + return new AccessResult(false, null, 'Die Fassung ist gesperrt.'); + } + + $version->loadMissing('element'); + $outputClass = $version->element->output_class; + $now = now(); + $candidates = Grant::query() + ->where('license_article_id', $article->id) + ->where('status', GrantStatus::Aktiv) + ->whereHas('acquisition', fn ($query) => $query->where('party_id', $user->party_id)) + ->get() + ->filter(function (Grant $grant) use ($now): bool { + if ($grant->valid_from !== null && $grant->valid_from->greaterThan($now)) { + return false; + } + + return $grant->valid_until === null || $grant->valid_until->greaterThan($now); + }) + ->filter(function (Grant $grant) use ($outputClass, $action): bool { + $capabilities = $grant->rights_snapshot['capabilities'] ?? []; + $actions = $capabilities[$outputClass] ?? []; + + return in_array($action, $actions, true); + }) + ->sort(function (Grant $left, Grant $right): int { + $leftUntil = $left->valid_until?->getTimestamp() ?? PHP_INT_MAX; + $rightUntil = $right->valid_until?->getTimestamp() ?? PHP_INT_MAX; + + return $leftUntil === $rightUntil ? $right->id <=> $left->id : $leftUntil <=> $rightUntil; + }) + ->values(); + + $grant = $candidates->last(); + + if ($grant === null) { + return new AccessResult(false, null, 'Keine passende Berechtigung.'); + } + + return new AccessResult(true, $grant); + } +} diff --git a/app/Domain/Entitlement/Grant.php b/app/Domain/Entitlement/Grant.php new file mode 100644 index 0000000..18a418e --- /dev/null +++ b/app/Domain/Entitlement/Grant.php @@ -0,0 +1,54 @@ + 'array', + 'valid_from' => 'datetime', + 'valid_until' => 'datetime', + 'status' => GrantStatus::class, + ]; + } + + public function acquisition(): BelongsTo + { + return $this->belongsTo(Acquisition::class); + } + + public function article(): BelongsTo + { + return $this->belongsTo(LicenseArticle::class, 'license_article_id'); + } + + public function rights(): BelongsTo + { + return $this->belongsTo(RightsProfileVersion::class, 'rights_profile_version_id'); + } + + public function releaseAtGrant(): BelongsTo + { + return $this->belongsTo(ArticleRelease::class, 'release_at_grant_id'); + } +} diff --git a/app/Domain/Entitlement/GrantIssuer.php b/app/Domain/Entitlement/GrantIssuer.php new file mode 100644 index 0000000..46d6ff7 --- /dev/null +++ b/app/Domain/Entitlement/GrantIssuer.php @@ -0,0 +1,125 @@ +offers->currentActiveVersion($offer); + + if (! in_array($version->grant_kind, ['auf_abruf', 'bei_registrierung'], true)) { + throw new DomainRuleException('Dieses Angebot wird nicht frei vergeben.'); + } + + if ($version->holder_kind !== 'person') { + throw new DomainRuleException('Dieses Angebot richtet sich nicht an Personen.'); + } + + return $this->issue($user, $version, AcquisitionType::FreierAbruf, 'offer', $offer->id); + } + + public function grantRegistrationOffers(User $user): void + { + OfferVersion::query() + ->where('status', OfferStatus::Aktiv) + ->where('grant_kind', 'bei_registrierung') + ->where('holder_kind', 'person') + ->orderByDesc('number') + ->get() + ->unique('offer_id') + ->each(function (OfferVersion $version) use ($user): void { + $this->issue($user, $version, AcquisitionType::FreierAbruf, 'offer', $version->offer_id); + }); + } + + public function grantManually(User $user, Offer $offer, User $actor, string $reason): Acquisition + { + $reason = trim($reason); + + if ($reason === '') { + throw new DomainRuleException('Eine manuelle Vergabe braucht eine Begründung.'); + } + + $version = $this->offers->currentActiveVersion($offer); + + if ($version->holder_kind !== 'person') { + throw new DomainRuleException('Dieses Angebot richtet sich nicht an Personen.'); + } + + return DB::transaction(function () use ($user, $offer, $actor, $reason, $version): Acquisition { + $operation = ManualGrant::query()->create([ + 'actor_id' => $actor->id, + 'party_id' => $user->party_id, + 'offer_id' => $offer->id, + 'reason' => $reason, + ]); + + return $this->issue($user, $version, AcquisitionType::ManuelleVergabe, 'manual_grant', $operation->id); + }); + } + + public function issue( + User $user, + OfferVersion $version, + AcquisitionType $type, + string $referenceType, + int $referenceId, + ): Acquisition { + return DB::transaction(function () use ($user, $version, $type, $referenceType, $referenceId): Acquisition { + $existing = Acquisition::query()->where([ + 'party_id' => $user->party_id, + 'type' => $type, + 'reference_type' => $referenceType, + 'reference_id' => $referenceId, + ])->first(); + + if ($existing !== null) { + return $existing->load('grants'); + } + + $acquisition = Acquisition::query()->create([ + 'party_id' => $user->party_id, + 'type' => $type, + 'reference_type' => $referenceType, + 'reference_id' => $referenceId, + 'conditions' => [ + 'term_rule' => $version->term_rule, + 'update_promise' => $version->update_promise, + 'holder_kind' => $version->holder_kind, + 'offer_version_id' => $version->id, + ], + ]); + + $version->load('resolvedScopes.rights', 'resolvedScopes.article'); + + foreach ($version->resolvedScopes as $scope) { + $rights = $scope->rights; + $acquisition->grants()->create([ + 'license_article_id' => $scope->license_article_id, + 'rights_profile_version_id' => $rights->id, + 'rights_snapshot' => [ + 'purpose' => $rights->purpose, + 'capabilities' => $rights->capabilities, + 'options' => $rights->options ?? [], + ], + 'release_at_grant_id' => $scope->article->current_release_id, + 'status' => GrantStatus::Aktiv, + 'valid_from' => now(), + ]); + } + + return $acquisition->load('grants'); + }); + } +} diff --git a/app/Domain/Entitlement/GrantStatus.php b/app/Domain/Entitlement/GrantStatus.php new file mode 100644 index 0000000..1a45005 --- /dev/null +++ b/app/Domain/Entitlement/GrantStatus.php @@ -0,0 +1,11 @@ +belongsTo(User::class, 'actor_id'); + } + + public function party(): BelongsTo + { + return $this->belongsTo(Party::class); + } + + public function offer(): BelongsTo + { + return $this->belongsTo(Offer::class); + } +} diff --git a/app/Domain/Entitlement/MediaDelivery.php b/app/Domain/Entitlement/MediaDelivery.php new file mode 100644 index 0000000..5318898 --- /dev/null +++ b/app/Domain/Entitlement/MediaDelivery.php @@ -0,0 +1,28 @@ + 'datetime', + ]; + } +} diff --git a/app/Domain/Identity/AccountStatus.php b/app/Domain/Identity/AccountStatus.php new file mode 100644 index 0000000..7d82271 --- /dev/null +++ b/app/Domain/Identity/AccountStatus.php @@ -0,0 +1,19 @@ + 'Aktiv', + self::Gesperrt => 'Gesperrt', + self::Geloescht => 'Gelöscht', + }; + } +} diff --git a/app/Domain/Identity/AssignStaffRoles.php b/app/Domain/Identity/AssignStaffRoles.php new file mode 100644 index 0000000..1390e59 --- /dev/null +++ b/app/Domain/Identity/AssignStaffRoles.php @@ -0,0 +1,46 @@ + $roles + */ + public function sync(User $user, array $roles, User $actor): void + { + $roles = array_values(array_unique($roles)); + + foreach ($roles as $role) { + if (StaffRole::tryFrom($role) === null) { + throw ValidationException::withMessages([ + 'roles' => 'Unbekannte Personalrolle.', + ]); + } + } + + if ( + $actor->hasStaffRole(StaffRole::Systemverwalter) + && $user->is($actor) + && ! in_array(StaffRole::Systemverwalter->value, $roles, true) + ) { + throw ValidationException::withMessages([ + 'roles' => 'Das eigene Systemverwalter-Recht bleibt bestehen.', + ]); + } + + DB::transaction(function () use ($user, $roles): void { + $user->staffRoles()->delete(); + + foreach ($roles as $role) { + $user->staffRoles()->create(['role' => $role]); + } + }); + + $user->unsetRelation('staffRoles'); + } +} diff --git a/app/Domain/Identity/Party.php b/app/Domain/Identity/Party.php new file mode 100644 index 0000000..1b92e41 --- /dev/null +++ b/app/Domain/Identity/Party.php @@ -0,0 +1,32 @@ + PartyType::class, + ]; + } + + public function user(): HasOne + { + return $this->hasOne(User::class); + } + + public function profile(): HasOne + { + return $this->hasOne(Profile::class); + } +} diff --git a/app/Domain/Identity/PartyType.php b/app/Domain/Identity/PartyType.php new file mode 100644 index 0000000..643c33c --- /dev/null +++ b/app/Domain/Identity/PartyType.php @@ -0,0 +1,9 @@ + 'array', + ]; + } + + public function party(): BelongsTo + { + return $this->belongsTo(Party::class); + } +} diff --git a/app/Domain/Identity/RegisterAccount.php b/app/Domain/Identity/RegisterAccount.php new file mode 100644 index 0000000..734cfee --- /dev/null +++ b/app/Domain/Identity/RegisterAccount.php @@ -0,0 +1,41 @@ + 'Die Plattform richtet sich an Erwachsene. Ein Konto setzt die Bestätigung voraus.', + ]); + } + + return DB::transaction(function () use ($name, $email, $password): User { + $party = Party::query()->create([ + 'type' => PartyType::Person, + 'display_name' => $name, + ]); + + Profile::query()->create([ + 'party_id' => $party->id, + 'display_name' => $name, + 'visibility' => ['display_name' => 'private'], + ]); + + return User::query()->create([ + 'party_id' => $party->id, + 'name' => $name, + 'email' => $email, + 'password' => $password, + 'status' => AccountStatus::Aktiv, + 'confirmed_adult_at' => now(), + ]); + }); + } +} diff --git a/app/Domain/Identity/StaffRole.php b/app/Domain/Identity/StaffRole.php new file mode 100644 index 0000000..a1c1ce5 --- /dev/null +++ b/app/Domain/Identity/StaffRole.php @@ -0,0 +1,41 @@ + 'Redakteur', + self::Fachpruefer => 'Fachprüfer', + self::Katalogverwalter => 'Katalogverwalter', + self::Kundenbetreuung => 'Kundenbetreuung', + self::Verifikationspruefer => 'Verifikationsprüfer', + self::Moderator => 'Moderator', + self::Systemverwalter => 'Systemverwalter', + }; + } + + /** + * @return array + */ + public static function options(): array + { + $options = []; + + foreach (self::cases() as $role) { + $options[$role->value] = $role->label(); + } + + return $options; + } +} diff --git a/app/Domain/Identity/StaffRoleAssignment.php b/app/Domain/Identity/StaffRoleAssignment.php new file mode 100644 index 0000000..659a3fa --- /dev/null +++ b/app/Domain/Identity/StaffRoleAssignment.php @@ -0,0 +1,26 @@ + StaffRole::class, + ]; + } + + public function user(): BelongsTo + { + return $this->belongsTo(User::class); + } +} diff --git a/app/Domain/Media/DeliveryLog.php b/app/Domain/Media/DeliveryLog.php new file mode 100644 index 0000000..1f08038 --- /dev/null +++ b/app/Domain/Media/DeliveryLog.php @@ -0,0 +1,36 @@ +create([ + 'grant_id' => $grant->id, + 'license_article_id' => $article->id, + 'article_release_id' => $release->id, + 'content_element_version_id' => $version->id, + 'action' => $action, + 'format' => $format, + 'copy_id' => 'LK-'.strtoupper(bin2hex(random_bytes(6))), + 'checksum' => $checksum, + 'marking' => $marking, + 'delivered_at' => now(), + ]); + } +} diff --git a/app/Domain/Media/FfmpegFilmTranscoder.php b/app/Domain/Media/FfmpegFilmTranscoder.php new file mode 100644 index 0000000..562123c --- /dev/null +++ b/app/Domain/Media/FfmpegFilmTranscoder.php @@ -0,0 +1,81 @@ +find('ffmpeg') !== null; + } + + public function derive(int $versionId, string $sourceRelative): array + { + $binary = (new ExecutableFinder)->find('ffmpeg'); + + if ($binary === null) { + return []; + } + + $disk = Storage::disk('media_derived'); + $source = $disk->path($sourceRelative); + $base = 'ableitungen/'.$versionId; + $rows = []; + + foreach ([480, 720, 1080] as $height) { + $directory = $base.'/'.$height; + $disk->makeDirectory($directory); + $playlist = $disk->path($directory.'/index.m3u8'); + $segment = $disk->path($directory.'/segment_%03d.m4s'); + $process = new Process([ + $binary, + '-y', + '-i', + $source, + '-vf', + 'scale=-2:'.$height, + '-c:v', + 'libx264', + '-preset', + 'veryfast', + '-crf', + '23', + '-c:a', + 'aac', + '-hls_time', + '6', + '-hls_playlist_type', + 'vod', + '-hls_segment_filename', + $segment, + $playlist, + ]); + $process->setTimeout(3600); + $process->run(); + + if (! $process->isSuccessful()) { + throw new RuntimeException('Die Qualitätsstufe '.$height.' ließ sich nicht ableiten.'); + } + + $rows[] = [ + 'role' => 'variant', + 'label' => (string) $height, + 'path' => $directory.'/index.m3u8', + ]; + } + + $master = "#EXTM3U\n#EXT-X-VERSION:3\n" + ."#EXT-X-STREAM-INF:BANDWIDTH=800000,RESOLUTION=854x480\n480/index.m3u8\n" + ."#EXT-X-STREAM-INF:BANDWIDTH=2500000,RESOLUTION=1280x720\n720/index.m3u8\n" + ."#EXT-X-STREAM-INF:BANDWIDTH=5000000,RESOLUTION=1920x1080\n1080/index.m3u8\n"; + $disk->put($base.'/master.m3u8', $master); + $rows[] = ['role' => 'master', 'label' => 'master', 'path' => $base.'/master.m3u8']; + + return $rows; + } +} diff --git a/app/Domain/Media/FilmPlayback.php b/app/Domain/Media/FilmPlayback.php new file mode 100644 index 0000000..82e0432 --- /dev/null +++ b/app/Domain/Media/FilmPlayback.php @@ -0,0 +1,11 @@ + + */ + public function derive(int $versionId, string $sourceRelative): array; +} diff --git a/app/Domain/Media/HlsPlaylist.php b/app/Domain/Media/HlsPlaylist.php new file mode 100644 index 0000000..46ecc22 --- /dev/null +++ b/app/Domain/Media/HlsPlaylist.php @@ -0,0 +1,30 @@ +where('content_element_version_id', $versionId) + ->where('role', 'master') + ->value('path'); + + return is_string($path) && $path !== '' ? $path : null; + } +} diff --git a/app/Domain/Media/PresentationFile.php b/app/Domain/Media/PresentationFile.php new file mode 100644 index 0000000..8c5e592 --- /dev/null +++ b/app/Domain/Media/PresentationFile.php @@ -0,0 +1,71 @@ +output_class, ['bild', 'film', 'audio'], true)) { + throw new DomainRuleException('Eine Präsentationsdatei ist ein Bild, ein Film oder ein Hörstück.'); + } + + if ($element->versions()->exists()) { + throw new DomainRuleException('Dieses Medium hat bereits eine Inhaltsfassung. Die Präsentationsdatei ersetzt sie nicht.'); + } + + if (! $this->readable($incoming)) { + throw new DomainRuleException('Die Datei liegt nicht im Eingang.'); + } + + $extension = strtolower(pathinfo($incoming, PATHINFO_EXTENSION)); + $allowed = match ($element->output_class) { + 'bild' => ['jpg', 'jpeg', 'png', 'webp', 'gif'], + 'audio' => ['mp3', 'm4a', 'ogg'], + default => ['mp4', 'webm'], + }; + + if (! in_array($extension, $allowed, true)) { + throw new DomainRuleException('Diese Datei ist keine freigebbare Ableitung. Es wird keine Inhaltsfassung angelegt.'); + } + + $prefix = $element->output_class === 'bild' ? 'vorschau' : 'teaser'; + $target = $prefix.'/'.$element->id.'/datei.'.$extension; + $stream = Storage::disk('cms_incoming')->readStream($incoming); + + if (! is_resource($stream)) { + throw new DomainRuleException('Die Datei ließ sich nicht lesen.'); + } + + try { + Storage::disk('media_derived')->writeStream($target, $stream); + } finally { + fclose($stream); + } + + if ($element->output_class === 'bild') { + $element->thumbnail_path = $target; + $element->thumbnail_source = 'eigen'; + } else { + $element->preview_path = $target; + } + + $element->save(); + } + + private function readable(string $path): bool + { + return (str_starts_with($path, 'inhalte/') || str_starts_with($path, 'cms/') || str_starts_with($path, 'vorschau/')) + && ! str_contains($path, '..') + && preg_match('#^(inhalte|cms|vorschau)/[A-Za-z0-9._\-/]+$#', $path) === 1 + && Storage::disk('cms_incoming')->exists($path); + } +} diff --git a/app/Domain/Media/ThumbnailDeriver.php b/app/Domain/Media/ThumbnailDeriver.php new file mode 100644 index 0000000..6db8103 --- /dev/null +++ b/app/Domain/Media/ThumbnailDeriver.php @@ -0,0 +1,367 @@ +refresh(); + $chosen = $element->thumbnail_source; + + if ($chosen === 'eigen' || (is_string($chosen) && str_starts_with($chosen, 'frame:'))) { + return; + } + + $version = $element->versions()->orderByDesc('number')->first(); + $file = is_array($version?->metadata) ? ($version->metadata['file'] ?? null) : null; + + if (! $version instanceof ContentElementVersion || ! is_string($file) || $file === '') { + $this->fail($element, 'Für dieses Medium liegt noch keine Datei vor.'); + + return; + } + + if (in_array($element->output_class, ['film', 'audio'], true)) { + $this->frame($element, $version, $file); + + return; + } + + $this->still($element, Storage::disk('media_derived'), $file, 'element-'.$element->id); + $this->rememberElement($element, 'datei'); + } + + public function forElementUpload(ContentElement $element, string $incoming): void + { + if (! str_starts_with($incoming, 'vorschau/') || str_contains($incoming, '..')) { + $this->fail($element, 'Das Vorschaubild wurde nicht übernommen.'); + + return; + } + + $this->still($element, Storage::disk('cms_incoming'), $incoming, 'element-'.$element->id); + $this->rememberElement($element, 'eigen'); + } + + public function forWebsiteImage(ContentElement $element, string $incoming): void + { + if ($element->output_class !== 'bild' || ! $this->incomingIsSafe($incoming)) { + $this->fail($element, 'Das Bild für die Website wurde nicht übernommen.'); + + return; + } + + $this->still($element, Storage::disk('cms_incoming'), $incoming, 'element-'.$element->id); + $this->rememberElement($element, 'eigen'); + } + + public function forElementFrame(ContentElement $element, ContentElementVersion $version, float $seconds): void + { + if ($version->content_element_id !== $element->id || $element->output_class !== 'film') { + $this->fail($element, 'Aus dieser Filmstelle ließ sich kein Vorschaubild erzeugen.'); + + return; + } + + $bytes = $this->jpegAtVersion($version, $seconds); + + if (! is_string($bytes)) { + $this->fail($element, 'Aus dieser Filmstelle ließ sich kein Vorschaubild erzeugen.'); + + return; + } + + $name = 'element-'.$element->id; + $path = 'vorschau/'.$name.'.jpg'; + Storage::disk('media_derived')->put($path, $bytes); + $this->still($element, Storage::disk('media_derived'), $path, $name); + $this->rememberElement($element, 'frame:'.$version->id.'@'.$this->secondText($seconds)); + } + + public function forCompositionUpload(Composition $composition, string $incoming): void + { + if (! str_starts_with($incoming, 'vorschau/') || str_contains($incoming, '..')) { + $this->failComposition($composition, 'Das Vorschaubild wurde nicht übernommen.'); + + return; + } + + $this->still($composition, Storage::disk('cms_incoming'), $incoming, 'komposition-'.$composition->id); + $this->rememberChoice($composition, 'eigen'); + } + + public function forCompositionFromElement(Composition $composition, ContentElement $element): void + { + $path = $element->thumbnail_path; + + if (! is_string($path) || ! str_starts_with($path, 'vorschau/') || str_contains($path, '..')) { + $this->failComposition($composition, 'Für dieses Medium liegt noch kein Vorschaubild vor.'); + + return; + } + + $this->still($composition, Storage::disk('media_derived'), $path, 'komposition-'.$composition->id); + $this->rememberChoice($composition, 'element:'.$element->id); + } + + public function forCompositionFrame(Composition $composition, ContentElementVersion $version, float $seconds): void + { + $version->loadMissing('element'); + + if ($version->element?->output_class !== 'film') { + $this->failComposition($composition, 'Aus dieser Filmstelle ließ sich kein Titelbild erzeugen.'); + + return; + } + + $bytes = $this->jpegAtVersion($version, $seconds); + + if (! is_string($bytes)) { + $this->failComposition($composition, 'Aus dieser Filmstelle ließ sich kein Titelbild erzeugen.'); + + return; + } + + $name = 'komposition-'.$composition->id; + $path = 'vorschau/'.$name.'.jpg'; + Storage::disk('media_derived')->put($path, $bytes); + $this->still($composition, Storage::disk('media_derived'), $path, $name); + $this->rememberChoice($composition, 'frame:'.$version->id.'@'.$this->secondText($seconds)); + } + + public function frameInput(ContentElementVersion $version): ?string + { + $proxy = MediaRendition::query() + ->where('content_element_version_id', $version->id) + ->where('role', 'variant') + ->where('label', '480') + ->value('path'); + + if (is_string($proxy) && $this->readableDerived($proxy, 'ableitungen/')) { + return $proxy; + } + + $file = is_array($version->metadata) ? ($version->metadata['file'] ?? null) : null; + + return $this->readableDerived($file, 'inhalte/') ? $file : null; + } + + public function jpegAtVersion(ContentElementVersion $version, float $seconds): ?string + { + if ($seconds < 0 || $seconds > 7200) { + return null; + } + + $file = $this->frameInput($version); + + if ($file === null) { + return null; + } + + $disk = Storage::disk('media_derived'); + $binary = (new ExecutableFinder)->find('ffmpeg'); + + if ($binary === null) { + return null; + } + + $process = new Process([ + $binary, + '-hide_banner', + '-loglevel', + 'error', + '-ss', + $this->secondText($seconds), + '-i', + $disk->path($file), + '-frames:v', + '1', + '-vf', + 'scale=640:-2', + '-f', + 'image2pipe', + '-vcodec', + 'mjpeg', + 'pipe:1', + ]); + $process->setTimeout(15); + $process->run(); + $bytes = $process->getOutput(); + + if (! $process->isSuccessful() || ! str_starts_with($bytes, "\xFF\xD8")) { + return null; + } + + return $bytes; + } + + private function readableDerived(mixed $path, string $prefix): bool + { + if (! is_string($path) || $path === '' || str_contains($path, '..') || ! str_starts_with($path, $prefix)) { + return false; + } + + return Storage::disk('media_derived')->exists($path); + } + + private function incomingIsSafe(string $incoming): bool + { + return (str_starts_with($incoming, 'cms/') || str_starts_with($incoming, 'vorschau/')) + && ! str_contains($incoming, '..') + && preg_match('#^(cms|vorschau)/[A-Za-z0-9._\-/]+$#', $incoming) === 1 + && Storage::disk('cms_incoming')->exists($incoming); + } + + private function secondText(float $seconds): string + { + $seconds = max(0, min(7200, $seconds)); + $text = number_format($seconds, 3, '.', ''); + + return rtrim(rtrim($text, '0'), '.') ?: '0'; + } + + private function frame(ContentElement $element, ContentElementVersion $version, string $file): void + { + $binary = (new ExecutableFinder)->find('ffmpeg'); + $disk = Storage::disk('media_derived'); + + if ($binary === null || ! $disk->exists($file)) { + $this->fail($element, 'Für dieses Medium liegt noch kein abgeleitetes Vorschaubild vor.'); + + return; + } + + $target = 'vorschau/element-'.$element->id.'.jpg'; + $disk->makeDirectory('vorschau'); + $process = new Process([ + $binary, + '-y', + '-ss', + '0', + '-i', + $disk->path($file), + '-frames:v', + '1', + $disk->path($target), + ]); + $process->setTimeout(120); + $process->run(); + + if (! $process->isSuccessful() || ! $disk->exists($target)) { + $this->fail($element, 'Aus der Filmdatei ließ sich kein Vorschaubild erzeugen.'); + + return; + } + + $element->thumbnail_path = $target; + if (! filled($element->thumbnail_alt)) { + $element->thumbnail_alt = $element->working_title; + } + $element->thumbnail_error = null; + if ($element->output_class === 'film') { + $element->thumbnail_source = 'frame:'.$version->id.'@0'; + } + $element->save(); + } + + private function still(ContentElement|Composition $subject, Filesystem $disk, string $file, string $name): void + { + if (! $disk->exists($file)) { + $this->failSubject($subject, 'Die Bilddatei wurde nicht gefunden.'); + + return; + } + + $image = @imagecreatefromstring($disk->get($file)); + + if ($image === false) { + $this->failSubject($subject, 'Die Bilddatei ließ sich nicht lesen.'); + + return; + } + + $width = imagesx($image); + $height = imagesy($image); + // Bilder (Ausgabeart „bild“) dienen auch als Website-Ableitung für Einstieg und Hintergrund. 640 px wären dort + // sichtbar unscharf; deshalb bis 2400 px, nie vergrößert. Filmstandbilder und Modulvorschauen bleiben bei 640 px. + $targetWidth = $subject instanceof ContentElement && $subject->output_class === 'bild' + ? max(1, min(2400, $width)) + : 640; + $targetHeight = (int) max(1, round($height * ($targetWidth / max(1, $width)))); + $canvas = imagecreatetruecolor($targetWidth, $targetHeight); + // Transparente Flächen (PNG, GIF) werden im JPEG weiß statt schwarz. + imagefill($canvas, 0, 0, (int) imagecolorallocate($canvas, 255, 255, 255)); + imagecopyresampled($canvas, $image, 0, 0, 0, 0, $targetWidth, $targetHeight, $width, $height); + ob_start(); + imagejpeg($canvas, null, 82); + $bytes = ob_get_clean(); + imagedestroy($image); + imagedestroy($canvas); + + if (! is_string($bytes) || $bytes === '') { + $this->failSubject($subject, 'Das Vorschaubild ließ sich nicht schreiben.'); + + return; + } + + $path = 'vorschau/'.$name.'.jpg'; + Storage::disk('media_derived')->put($path, $bytes); + $subject->thumbnail_path = $path; + + if (! filled($subject->thumbnail_alt)) { + $subject->thumbnail_alt = $subject instanceof Composition ? $subject->designation : $subject->working_title; + } + + $subject->thumbnail_error = null; + $subject->save(); + } + + private function rememberElement(ContentElement $element, string $source): void + { + $element->refresh(); + + if ($element->thumbnail_error !== null || ! filled($element->thumbnail_path)) { + return; + } + + $element->thumbnail_source = $source; + $element->save(); + } + + private function rememberChoice(Composition $composition, string $source): void + { + $composition->refresh(); + + if ($composition->thumbnail_error !== null || ! filled($composition->thumbnail_path)) { + return; + } + + $composition->thumbnail_source = $source; + $composition->save(); + } + + private function fail(ContentElement $element, string $reason): void + { + $this->failSubject($element, $reason); + } + + private function failComposition(Composition $composition, string $reason): void + { + $this->failSubject($composition, $reason); + } + + private function failSubject(ContentElement|Composition $subject, string $reason): void + { + $subject->thumbnail_error = $reason; + $subject->save(); + } +} diff --git a/app/Domain/Media/ThumbnailRef.php b/app/Domain/Media/ThumbnailRef.php new file mode 100644 index 0000000..ba80801 --- /dev/null +++ b/app/Domain/Media/ThumbnailRef.php @@ -0,0 +1,15 @@ + $kind, 'subject' => $id]); + } +} diff --git a/app/Domain/Media/WebsiteIntake.php b/app/Domain/Media/WebsiteIntake.php new file mode 100644 index 0000000..55895d2 --- /dev/null +++ b/app/Domain/Media/WebsiteIntake.php @@ -0,0 +1,54 @@ +incomingIsReadable($incomingPath)) { + throw new DomainRuleException('Die Bilddatei liegt nicht im Eingang.'); + } + + $element = app(ContentService::class)->createElement('bild', 'bild', $title); + app(IdentityProfile::class)->fill($element, [ + 'display_title' => $title, + 'website_credit' => $credit, + 'website_alt' => $alt, + ], $actor); + AcceptWebsiteImage::dispatch($element->id, $incomingPath, $actor?->id); + + return $element->fresh(); + } + + private function incomingIsReadable(string $path): bool + { + return (str_starts_with($path, 'cms/') || str_starts_with($path, 'vorschau/')) + && ! str_contains($path, '..') + && preg_match('#^(cms|vorschau)/[A-Za-z0-9._\-/]+$#', $path) === 1 + && Storage::disk('cms_incoming')->exists($path); + } +} diff --git a/app/Domain/Media/WebsiteMedia.php b/app/Domain/Media/WebsiteMedia.php new file mode 100644 index 0000000..ba10478 --- /dev/null +++ b/app/Domain/Media/WebsiteMedia.php @@ -0,0 +1,76 @@ +find($element); + + if (! $element instanceof ContentElement || $element->website_released_at === null) { + return null; + } + + $path = $element->website_public_path; + $expected = '#^website/'.$element->id.'/datei\.[a-z0-9]+$#'; + + if (! is_string($path) || preg_match($expected, $path) !== 1) { + return null; + } + + if (! Storage::disk('media_public')->exists($path)) { + return null; + } + + $title = trim((string) ($element->display_title ?: $element->working_title)); + $alt = trim((string) ($element->website_alt ?? '')); + + return new WebsitePresentation( + elementId: $element->id, + title: $title, + alt: $alt !== '' ? $alt : $title, + credit: filled($element->website_credit) ? trim((string) $element->website_credit) : null, + kind: match ($element->output_class) { + 'film' => 'film', + 'audio' => 'audio', + default => 'bild', + }, + url: route('website.media', $element), + ); + } + + /** + * Slideshow: freigegebene Medien in der angegebenen Reihenfolge. Nicht freigegebene Einträge entfallen. + * + * @param list $ids + * @return list + */ + public function presentMany(array $ids): array + { + $presentations = []; + + foreach ($ids as $id) { + if (! is_numeric($id)) { + continue; + } + + $presentation = $this->present((int) $id); + + if ($presentation !== null) { + $presentations[] = $presentation; + } + } + + return $presentations; + } +} diff --git a/app/Domain/Media/WebsiteMediaAlias.php b/app/Domain/Media/WebsiteMediaAlias.php new file mode 100644 index 0000000..6d9adca --- /dev/null +++ b/app/Domain/Media/WebsiteMediaAlias.php @@ -0,0 +1,59 @@ +belongsTo(ContentElement::class, 'content_element_id'); + } + + /** + * Wirksame Zuordnung für einen früheren Pfad, sonst null. Zwischengespeichert wird im Aufrufer (WebsiteImage, je Anfrage). + */ + public static function effectiveFor(mixed $path): ?self + { + if (! is_string($path) || $path === '') { + return null; + } + + $alias = self::query()->with('element')->where('legacy_path', $path)->first(); + + return $alias instanceof self && $alias->everReleased() ? $alias : null; + } + + public function everReleased(): bool + { + $element = $this->element; + + if ($element === null) { + return false; + } + + if ($element->website_released_at !== null) { + return true; + } + + return IdentityChange::query() + ->where('subject_type', $element->getMorphClass()) + ->where('subject_id', $element->id) + ->where('field', 'website_released_at') + ->whereNotNull('after') + ->exists(); + } +} diff --git a/app/Domain/Media/WebsitePresentation.php b/app/Domain/Media/WebsitePresentation.php new file mode 100644 index 0000000..d93072b --- /dev/null +++ b/app/Domain/Media/WebsitePresentation.php @@ -0,0 +1,19 @@ +refusal($element); + + if ($refusal !== null) { + return $refusal; + } + + PublishWebsiteMedia::dispatch($element->id, 'release', $actor?->id); + + return 'Für die Website freigegeben. Öffentliche Seiten lesen nur diese Ableitung.'; + } + + public function withdraw(ContentElement $element, ?User $actor = null): string + { + PublishWebsiteMedia::dispatch($element->id, 'withdraw', $actor?->id); + + return 'Die Website-Freigabe ist zurückgenommen.'; + } + + public function refusal(ContentElement $element): ?string + { + if ($this->isConfidential($element)) { + return 'Traineranleitungen werden nicht für die Website freigegeben.'; + } + + if ($this->derivedPath($element) === null) { + return 'Für die Website fehlt eine freigebbare Ableitung. Beim Bild ist das das Vorschaubild. Film und Hörstück ohne Inhaltsfassung nutzen die Datei am Medium unter teaser/. Ein Film mit Inhaltsfassung nutzt die Teaserfassung seiner bereitgestellten Fassung. Die Originaldatei bleibt geschützt.'; + } + + return null; + } + + public function derivedPath(ContentElement $element): ?string + { + if ($this->isConfidential($element)) { + return null; + } + + if ($element->output_class === 'bild') { + return $this->allowedDerivedPath($element->thumbnail_path, 'vorschau/', ['jpg', 'jpeg', 'png', 'webp', 'gif']); + } + + if (in_array($element->output_class, ['film', 'audio'], true)) { + $extensions = $element->output_class === 'audio' + ? ['mp3', 'm4a', 'ogg'] + : ['mp4', 'webm']; + $own = $this->allowedDerivedPath($element->preview_path, 'teaser/', $extensions); + + if ($own !== null) { + return $own; + } + } + + if ($element->output_class !== 'film') { + return null; + } + + $version = $element->versions() + ->where('status', ContentVersionStatus::Bereit->value) + ->orderByDesc('number') + ->first(); + + if ($version === null) { + return null; + } + + $path = MediaRendition::query() + ->where('content_element_version_id', $version->id) + ->where('role', 'preview') + ->orderByDesc('id') + ->value('path'); + + return $this->allowedDerivedPath($path, 'teaser/', ['mp4', 'webm']); + } + + public function publicPath(ContentElement $element, string $derivedPath): string + { + $extension = strtolower(pathinfo($derivedPath, PATHINFO_EXTENSION)); + + return 'website/'.$element->id.'/datei.'.$extension; + } + + private function isConfidential(ContentElement $element): bool + { + $slug = $element->editorialContentKind?->slug; + + if ($slug === null && $element->editorial_content_kind_id !== null) { + $slug = EditorialContentKind::query()->whereKey($element->editorial_content_kind_id)->value('slug'); + } + + return in_array($slug, PublicMaterialReader::CONFIDENTIAL_KINDS, true); + } + + /** + * @param list $extensions + */ + private function allowedDerivedPath(mixed $path, string $prefix, array $extensions): ?string + { + if (! is_string($path) || ! str_starts_with($path, $prefix) || str_contains($path, '..')) { + return null; + } + + $extension = strtolower(pathinfo($path, PATHINFO_EXTENSION)); + + if (! in_array($extension, $extensions, true)) { + return null; + } + + if (! Storage::disk('media_derived')->exists($path)) { + return null; + } + + return $path; + } +} diff --git a/app/Filament/Auth/StaffLogin.php b/app/Filament/Auth/StaffLogin.php new file mode 100644 index 0000000..48ce69c --- /dev/null +++ b/app/Filament/Auth/StaffLogin.php @@ -0,0 +1,14 @@ +isTrusted($user)) { + return null; + } + + return parent::getFirstEnabledProvider($user); + } +} diff --git a/app/Filament/Pages/EditorialDesk.php b/app/Filament/Pages/EditorialDesk.php new file mode 100644 index 0000000..33e2b69 --- /dev/null +++ b/app/Filament/Pages/EditorialDesk.php @@ -0,0 +1,59 @@ +createCompositionAction(CompositionKind::Uebung), + $this->createCompositionAction(CompositionKind::Kurs), + ]; + } +} diff --git a/app/Filament/Pages/RedaktionelleStammdaten.php b/app/Filament/Pages/RedaktionelleStammdaten.php new file mode 100644 index 0000000..b6b033f --- /dev/null +++ b/app/Filament/Pages/RedaktionelleStammdaten.php @@ -0,0 +1,693 @@ +>|null */ + private ?array $verwendungCache = null; + + public static function canAccess(): bool + { + return self::darfPflegen(); + } + + public static function darfPflegen(): bool + { + return ContentElementResource::editor(); + } + + public function mount(): void + { + if (! array_key_exists($this->gruppe, $this->gruppen())) { + $this->gruppe = 'materialart'; + } + } + + public function getSubheading(): string|Htmlable|null + { + return 'Auswahlwerte für Redaktion, Filter und Picker. Bezeichnungen sind änderbar, Zuordnungen bleiben erhalten; verwendete Werte werden deaktiviert statt gelöscht.'; + } + + public function getMaxContentWidth(): Width|string|null + { + return Width::Full; + } + + /** + * @return array Schlüssel => Bezeichnung + */ + public function gruppen(): array + { + $gruppen = ['materialart' => 'Fachliche Materialarten']; + $dimensionen = EditorialDimension::query()->where('slug', '!=', EditorialDimension::PILLAR_SLUG)->get() + ->sortBy(fn (EditorialDimension $d): string => sprintf('%02d', array_search($d->slug, self::DIMENSION_ORDER, true) === false ? 99 : array_search($d->slug, self::DIMENSION_ORDER, true)).$d->label); + + foreach ($dimensionen as $dimension) { + $gruppen[$dimension->slug] = (string) $dimension->label; + } + + return $gruppen; + } + + public function zeigeGruppe(string $gruppe): void + { + if (array_key_exists($gruppe, $this->gruppen())) { + $this->gruppe = $gruppe; + $this->verwendungCache = null; + $this->resetTable(); + } + } + + public function saeulenUrl(): string + { + return PillarResource::getUrl('index'); + } + + private function istMaterialart(): bool + { + return $this->gruppe === 'materialart'; + } + + private function dimension(): ?EditorialDimension + { + return $this->istMaterialart() ? null : EditorialDimension::query()->where('slug', $this->gruppe)->first(); + } + + // --------------------------------------------------------------------------------------------------------------- + // Tabelle + // --------------------------------------------------------------------------------------------------------------- + + public function table(Table $table): Table + { + $materialart = $this->istMaterialart(); + + return $table + ->query(function (): Builder { + if ($this->istMaterialart()) { + return EditorialContentKind::query(); + } + + return EditorialDimensionValue::query()->where('editorial_dimension_id', $this->dimension()?->id ?? 0); + }) + ->defaultSort('sort_order') + ->reorderable('sort_order') + ->reorderRecordsTriggerAction(fn (Action $action, bool $isReordering): Action => $action + ->button() + ->label($isReordering ? 'Sortieren beenden' : 'Per Ziehen sortieren')) + ->paginated(false) + ->searchPlaceholder('Bezeichnung oder Kennung') + ->columns(array_values(array_filter([ + TextColumn::make('label') + ->label('Bezeichnung') + ->searchable(['label', 'slug']) + ->weight('semibold') + ->wrap() + ->description(fn (Model $record): string => 'Kennung: '.$record->slug + .($record instanceof EditorialContentKind && $record->isSystem() ? ' · vom System verwendet' : '')), + $materialart ? TextColumn::make('contexts') + ->label('Zulässig für') + ->state(fn (EditorialContentKind $record): array => array_values(array_map( + fn (string $context): string => EditorialContentKind::CONTEXTS[$context] ?? $context, + (array) ($record->contexts ?? []), + ))) + ->badge() + ->color('gray') + ->wrap() : null, + TextColumn::make('is_active') + ->label('Status') + ->formatStateUsing(fn (bool $state): string => $state ? 'Aktiv' : 'Inaktiv') + ->badge() + ->color(fn (bool $state): string => $state ? 'success' : 'gray'), + TextColumn::make('verwendung') + ->label('Verwendung') + ->state(fn (Model $record): string => $this->verwendungText($record)) + ->wrap() + ->action($this->verwendungAction()->name('verwendungZeigen')), + ]))) + ->filters([ + SelectFilter::make('is_active') + ->label('Status') + ->options(['1' => 'Aktiv', '0' => 'Inaktiv']), + ]) + ->recordActions([ + Action::make('hoch') + ->label('Nach oben') + ->icon('heroicon-m-arrow-up') + ->iconButton() + ->color('gray') + ->authorize(fn (): bool => self::darfPflegen()) + ->disabled(fn (Model $record): bool => $this->nachbar($record, -1) === null) + ->action(fn (Model $record) => $this->verschiebe($record, -1)), + Action::make('runter') + ->label('Nach unten') + ->icon('heroicon-m-arrow-down') + ->iconButton() + ->color('gray') + ->authorize(fn (): bool => self::darfPflegen()) + ->disabled(fn (Model $record): bool => $this->nachbar($record, 1) === null) + ->action(fn (Model $record) => $this->verschiebe($record, 1)), + $this->bearbeitenAction(), + ActionGroup::make([ + $this->verwendungAction(), + $this->umschaltenAction(), + $this->loeschenAction(), + ])->label('Weitere')->icon('heroicon-m-chevron-down')->button()->size('sm')->color('gray'), + ]) + ->emptyStateHeading('Noch keine Werte') + ->emptyStateDescription('Mit „Wert anlegen“ entsteht der erste Wert dieser Gruppe.'); + } + + protected function getHeaderActions(): array + { + return [ + Action::make('anlegen') + ->label('Wert anlegen') + ->icon('heroicon-o-plus') + ->authorize(fn (): bool => self::darfPflegen()) + ->modalHeading(fn (): string => 'Neuer Wert: '.($this->gruppen()[$this->gruppe] ?? '')) + ->schema(fn (): array => $this->formular(null)) + ->fillForm(fn (): array => ['contexts' => ['medium']]) + ->modalSubmitActionLabel('Anlegen') + ->action(function (array $data): void { + $this->anlegen($data); + }), + ]; + } + + // --------------------------------------------------------------------------------------------------------------- + // Formular, Anlegen, Bearbeiten + // --------------------------------------------------------------------------------------------------------------- + + /** + * @return list + */ + private function formular(?Model $record): array + { + $felder = [ + TextInput::make('label') + ->label('Bezeichnung') + ->required() + ->maxLength(120) + ->helperText($record !== null + ? 'Die Kennung „'.$record->slug.'“ bleibt; vorhandene Zuordnungen behalten den Wert und zeigen die neue Bezeichnung.' + : 'Die Kennung entsteht aus der Bezeichnung und bleibt danach fest.'), + ]; + + if ($this->istMaterialart()) { + $system = $record instanceof EditorialContentKind && $record->isSystem(); + $felder[] = CheckboxList::make('contexts') + ->label('Zulässig für') + ->options(EditorialContentKind::CONTEXTS) + ->required() + ->live() + ->columns(['default' => 2, 'md' => 4]) + ->disabled($system) + ->dehydrated(! $system) + ->helperText($system + ? 'Diese Materialart verwendet das System; ihre Kontexte bleiben fest.' + : 'Nur hier wird die Materialart neu angeboten. Programm und Modul gehören zu den Objektarten Programm und Modul, nicht zu Medien.'); + + if ($record instanceof EditorialContentKind) { + $felder[] = Placeholder::make('konflikt') + ->label('Bestehende Zuordnungen') + ->visible(fn (Get $get): bool => $this->kontextKonflikte($record, (array) $get('contexts')) !== []) + ->content(fn (Get $get): HtmlString => new HtmlString('' + .e(implode(' ', $this->kontextKonflikte($record, (array) $get('contexts')))) + .' Diese Zuordnungen bleiben erhalten und werden dort als „hier nicht vorgesehen“ gekennzeichnet; neu wählbar ist die Materialart dort nicht mehr.')); + $felder[] = Checkbox::make('konflikt_bestaetigt') + ->label('Ich habe die bestehenden Zuordnungen geprüft.') + ->accepted() + ->visible(fn (Get $get): bool => $this->kontextKonflikte($record, (array) $get('contexts')) !== []); + } + } + + return $felder; + } + + /** + * @return list Meldungen je entferntem Kontext mit Verwendung + */ + private function kontextKonflikte(EditorialContentKind $kind, array $neu): array + { + $verwendung = $this->verwendung($kind); + $meldungen = []; + $zeilen = null; + + foreach ((array) ($kind->contexts ?? []) as $context) { + if (! in_array($context, $neu, true) && ($verwendung[$context] ?? 0) > 0) { + $zeilen ??= $this->verwendungListe($kind)['zeilen']; + $titel = array_slice(array_column(array_filter($zeilen, fn (array $z): bool => $z['art'] === (EditorialContentKind::CONTEXTS[$context] ?? '')), 'titel'), 0, 5); + $meldungen[] = (EditorialContentKind::CONTEXTS[$context] ?? $context).': '.$verwendung[$context].' '.($verwendung[$context] === 1 ? 'Zuordnung' : 'Zuordnungen') + .($titel !== [] ? ' („'.implode('“, „', $titel).'“'.($verwendung[$context] > count($titel) ? ' und weitere' : '').')' : '').'.'; + } + } + + return $meldungen; + } + + private function bearbeitenAction(): Action + { + return Action::make('bearbeiten') + ->label('Bearbeiten') + ->icon('heroicon-o-pencil-square') + ->button() + ->size('sm') + ->color('gray') + ->authorize(fn (): bool => self::darfPflegen()) + ->modalHeading(fn (Model $record): string => '„'.$record->label.'“ bearbeiten') + ->schema(fn (Model $record): array => $this->formular($record)) + ->fillForm(fn (Model $record): array => [ + 'label' => $record->label, + 'contexts' => $record instanceof EditorialContentKind ? (array) ($record->contexts ?? []) : [], + ]) + ->modalSubmitActionLabel('Speichern') + ->action(function (Model $record, array $data): void { + $label = trim((string) $data['label']); + $this->pruefeBezeichnung($label, $record); + $record->label = $label; + + if ($record instanceof EditorialContentKind && ! $record->isSystem() && isset($data['contexts'])) { + $record->contexts = $this->kontexte((array) $data['contexts']); + } + + $record->save(); + Notification::make()->success()->title('Gespeichert')->body('Die neue Bezeichnung gilt sofort in Redaktion, Filtern und Picker.')->send(); + }); + } + + private function anlegen(array $data): void + { + $label = trim((string) $data['label']); + $this->pruefeBezeichnung($label, null); + + if ($this->istMaterialart()) { + EditorialContentKind::query()->create([ + 'label' => $label, + 'slug' => $this->freieKennung($label, EditorialContentKind::query()), + 'sort_order' => (int) EditorialContentKind::query()->max('sort_order') + 10, + 'is_active' => true, + 'contexts' => $this->kontexte((array) ($data['contexts'] ?? [])), + ]); + } else { + $dimension = $this->dimension(); + abort_if($dimension === null, 404); + $werte = EditorialDimensionValue::query()->where('editorial_dimension_id', $dimension->id); + EditorialDimensionValue::query()->create([ + 'editorial_dimension_id' => $dimension->id, + 'label' => $label, + 'slug' => $this->freieKennung($label, clone $werte), + 'sort_order' => (int) (clone $werte)->max('sort_order') + 10, + 'is_active' => true, + ]); + } + + $this->verwendungCache = null; + Notification::make()->success()->title('Angelegt: „'.$label.'“')->body('Der Wert ist sofort in der passenden Redaktion wählbar.')->send(); + } + + private function pruefeBezeichnung(string $label, ?Model $ausser): void + { + $query = $this->istMaterialart() + ? EditorialContentKind::query() + : EditorialDimensionValue::query()->where('editorial_dimension_id', $this->dimension()?->id ?? 0); + + $doppelt = $query->whereRaw('LOWER(label) = ?', [mb_strtolower($label)]) + ->when($ausser !== null, fn (Builder $q) => $q->whereKeyNot($ausser->getKey())) + ->exists(); + + if ($label === '' || $doppelt) { + Notification::make()->danger()->title($label === '' ? 'Die Bezeichnung fehlt.' : 'Diese Bezeichnung gibt es in der Gruppe schon.')->send(); + throw new Halt; + } + } + + /** + * @return list + */ + private function kontexte(array $kontexte): array + { + $erlaubt = array_keys(EditorialContentKind::CONTEXTS); + + return array_values(array_filter($erlaubt, fn (string $context): bool => in_array($context, $kontexte, true))); + } + + private function freieKennung(string $label, Builder $query): string + { + $basis = Str::slug($label) ?: 'wert'; + $kennung = $basis; + $nummer = 2; + + while ((clone $query)->where('slug', $kennung)->exists()) { + $kennung = $basis.'-'.$nummer++; + } + + return $kennung; + } + + // --------------------------------------------------------------------------------------------------------------- + // Aktiv, Löschen, Reihenfolge + // --------------------------------------------------------------------------------------------------------------- + + private function umschaltenAction(): Action + { + return Action::make('umschalten') + ->label(fn (Model $record): string => $record->is_active ? 'Deaktivieren' : 'Reaktivieren') + ->icon(fn (Model $record): string => $record->is_active ? 'heroicon-o-eye-slash' : 'heroicon-o-eye') + ->authorize(fn (): bool => self::darfPflegen()) + ->hidden(fn (Model $record): bool => $record instanceof EditorialContentKind && $record->isSystem()) + ->requiresConfirmation() + ->modalHeading(fn (Model $record): string => '„'.$record->label.'“ '.($record->is_active ? 'deaktivieren?' : 'reaktivieren?')) + ->modalDescription(fn (Model $record): string => $record->is_active + ? 'Der Wert wird für neue Zuordnungen nicht mehr angeboten. '.$this->verwendungSatz($record).' Filter finden diese Objekte weiterhin.' + : 'Der Wert wird wieder für neue Zuordnungen angeboten.') + ->modalSubmitActionLabel(fn (Model $record): string => $record->is_active ? 'Deaktivieren' : 'Reaktivieren') + ->action(function (Model $record): void { + abort_if($record instanceof EditorialContentKind && $record->isSystem(), 403); + $record->is_active = ! $record->is_active; + $record->save(); + }); + } + + private function loeschenAction(): Action + { + return Action::make('loeschen') + ->label('Löschen') + ->icon('heroicon-o-trash') + ->color('danger') + ->authorize(fn (): bool => self::darfPflegen()) + ->visible(fn (Model $record): bool => $this->loeschbar($record)) + ->requiresConfirmation() + ->modalHeading(fn (Model $record): string => '„'.$record->label.'“ löschen?') + ->modalDescription('Der Wert ist nirgends zugeordnet und wird endgültig entfernt.') + ->modalSubmitActionLabel('Löschen') + ->action(function (Model $record): void { + // Erneut prüfen: Zwischenzeitlich entstandene Zuordnungen würden die Datenbank sonst still lösen. + if (! $this->loeschbar($record)) { + Notification::make()->danger()->title('Nicht gelöscht: Der Wert ist inzwischen zugeordnet. Deaktivieren Sie ihn stattdessen.')->send(); + + return; + } + + $record->delete(); + $this->verwendungCache = null; + }); + } + + private function loeschbar(Model $record): bool + { + if ($record instanceof EditorialContentKind && $record->isSystem()) { + return false; + } + + return array_sum($this->verwendung($record, frisch: true)) === 0; + } + + private function nachbar(Model $record, int $richtung): ?Model + { + $liste = $this->geordnet(); + $index = $liste->search(fn (Model $m): bool => $m->is($record)); + + return $index === false ? null : $liste->get($index + $richtung); + } + + private function verschiebe(Model $record, int $richtung): void + { + $liste = $this->geordnet()->values(); + $index = $liste->search(fn (Model $m): bool => $m->is($record)); + + if ($index === false || $liste->get($index + $richtung) === null) { + return; + } + + $nachbar = $liste->get($index + $richtung); + + // Nur die beiden Einträge tauschen; neu nummeriert wird nur bei gleicher Reihenfolgezahl. + if ((int) $record->sort_order !== (int) $nachbar->sort_order) { + DB::transaction(function () use ($record, $nachbar): void { + [$a, $b] = [(int) $record->sort_order, (int) $nachbar->sort_order]; + $record->sort_order = $b; + $record->save(); + $nachbar->sort_order = $a; + $nachbar->save(); + }); + + return; + } + + $neu = $liste->all(); + [$neu[$index], $neu[$index + $richtung]] = [$neu[$index + $richtung], $neu[$index]]; + + DB::transaction(function () use ($neu): void { + foreach (array_values($neu) as $position => $eintrag) { + if ((int) $eintrag->sort_order !== ($position + 1) * 10) { + $eintrag->sort_order = ($position + 1) * 10; + $eintrag->save(); + } + } + }); + } + + /** + * @return Collection + */ + private function geordnet(): Collection + { + $query = $this->istMaterialart() + ? EditorialContentKind::query() + : EditorialDimensionValue::query()->where('editorial_dimension_id', $this->dimension()?->id ?? 0); + + return $query->orderBy('sort_order')->orderBy('id')->get()->values(); + } + + // --------------------------------------------------------------------------------------------------------------- + // Verwendung + // --------------------------------------------------------------------------------------------------------------- + + /** + * Zuordnungen je Objektkontext. + * + * @return array + */ + public function verwendung(Model $record, bool $frisch = false): array + { + if ($frisch || $this->verwendungCache === null) { + $this->verwendungCache = $this->istMaterialart() ? $this->materialartVerwendung() : $this->einordnungVerwendung(); + } + + return $this->verwendungCache[(int) $record->getKey()] ?? []; + } + + private function verwendungText(Model $record): string + { + $teile = []; + + foreach ($this->verwendung($record) as $context => $anzahl) { + if ($anzahl > 0) { + $teile[] = $anzahl.' '.$this->einheit($context, $anzahl); + } + } + + return $teile === [] ? 'Nicht verwendet' : implode(' · ', $teile); + } + + private function verwendungSatz(Model $record): string + { + $text = $this->verwendungText($record); + + return $text === 'Nicht verwendet' + ? 'Er ist derzeit nirgends zugeordnet.' + : 'Bestehende Zuordnungen ('.$text.') bleiben erhalten und sichtbar.'; + } + + private function einheit(string $context, int $anzahl): string + { + return match ($context) { + 'medium' => $anzahl === 1 ? 'Medium' : 'Medien', + 'modul' => $anzahl === 1 ? 'Modul' : 'Module', + 'programm' => $anzahl === 1 ? 'Programm' : 'Programme', + 'lizenzartikel' => 'Lizenzartikel', + default => $anzahl === 1 ? 'Kombination' : 'Kombinationen', + }; + } + + /** + * @return array> + */ + private function materialartVerwendung(): array + { + $ergebnis = []; + + foreach (DB::table('content_elements')->whereNotNull('editorial_content_kind_id')->groupBy('editorial_content_kind_id')->selectRaw('editorial_content_kind_id as id, count(*) as anzahl')->get() as $zeile) { + $ergebnis[(int) $zeile->id]['medium'] = (int) $zeile->anzahl; + } + + foreach (DB::table('compositions')->whereNotNull('editorial_content_kind_id')->groupBy('editorial_content_kind_id', 'kind')->selectRaw('editorial_content_kind_id as id, kind, count(*) as anzahl')->get() as $zeile) { + $context = EditorialVocabulary::compositionContext(CompositionKind::tryFrom((string) $zeile->kind)) ?? 'kombination'; + $ergebnis[(int) $zeile->id][$context] = ($ergebnis[(int) $zeile->id][$context] ?? 0) + (int) $zeile->anzahl; + } + + foreach (DB::table('license_articles')->whereNotNull('editorial_content_kind_id')->groupBy('editorial_content_kind_id')->selectRaw('editorial_content_kind_id as id, count(*) as anzahl')->get() as $zeile) { + $ergebnis[(int) $zeile->id]['lizenzartikel'] = (int) $zeile->anzahl; + } + + return $ergebnis; + } + + /** + * @return array> + */ + private function einordnungVerwendung(): array + { + $ergebnis = []; + $zeilen = DB::table('identity_dimension_values') + ->leftJoin('compositions', function ($join): void { + $join->on('compositions.id', '=', 'identity_dimension_values.subject_id') + ->where('identity_dimension_values.subject_type', (new Composition)->getMorphClass()); + }) + ->groupBy('identity_dimension_values.editorial_dimension_value_id', 'identity_dimension_values.subject_type', 'compositions.kind') + ->selectRaw('identity_dimension_values.editorial_dimension_value_id as id, identity_dimension_values.subject_type as typ, compositions.kind as kind, count(*) as anzahl') + ->get(); + + foreach ($zeilen as $zeile) { + $context = match ($zeile->typ) { + (new ContentElement)->getMorphClass() => 'medium', + (new LicenseArticle)->getMorphClass() => 'lizenzartikel', + default => EditorialVocabulary::compositionContext(CompositionKind::tryFrom((string) $zeile->kind)) ?? 'kombination', + }; + $ergebnis[(int) $zeile->id][$context] = ($ergebnis[(int) $zeile->id][$context] ?? 0) + (int) $zeile->anzahl; + } + + return $ergebnis; + } + + private function verwendungAction(): Action + { + return Action::make('verwendung') + ->label('Verwendung') + ->icon('heroicon-m-list-bullet') + ->authorize(fn (): bool => self::darfPflegen()) + ->modalHeading(fn (Model $record): string => 'Verwendung von „'.$record->label.'“') + ->modalContent(fn (Model $record) => view('filament.stammdaten-verwendung', $this->verwendungListe($record))) + ->modalSubmitAction(false) + ->modalCancelActionLabel('Schließen'); + } + + /** + * Zugeordnete Objekte mit Links in ihre Bearbeitung und gefilterte Bestandslisten. + * + * @return array{zeilen: list, mehr: int, filter: list} + */ + public function verwendungListe(Model $record): array + { + $grenze = 40; + $zeilen = []; + $filter = []; + + if ($record instanceof EditorialContentKind) { + $medien = ContentElement::query()->where('editorial_content_kind_id', $record->id); + $kompositionen = Composition::query()->where('editorial_content_kind_id', $record->id); + $artikel = LicenseArticle::query()->where('editorial_content_kind_id', $record->id); + if ((clone $medien)->exists()) { + $filter[] = ['label' => 'Im Medienmanager filtern', 'url' => ContentElementResource::getUrl('index', ['inhaltsart' => $record->id])]; + } + } else { + $zuordnung = fn (string $klasse) => DB::table('identity_dimension_values') + ->where('editorial_dimension_value_id', $record->getKey()) + ->where('subject_type', (new $klasse)->getMorphClass()) + ->pluck('subject_id'); + $medien = ContentElement::query()->whereKey($zuordnung(ContentElement::class)); + $kompositionen = Composition::query()->whereKey($zuordnung(Composition::class)); + $artikel = LicenseArticle::query()->whereKey($zuordnung(LicenseArticle::class)); + if ((clone $medien)->exists()) { + $filter[] = ['label' => 'Im Medienmanager filtern', 'url' => ContentElementResource::getUrl('index', ['einordnung' => $record->getKey()])]; + } + if ((clone $kompositionen)->exists()) { + $filter[] = ['label' => 'Programme und Module filtern', 'url' => EditorialDesk::getUrl(['pillar' => $record->getKey()])]; + } + } + + $gesamt = (clone $medien)->count() + (clone $kompositionen)->count() + (clone $artikel)->count(); + + foreach ($medien->orderBy('working_title')->limit($grenze)->get() as $element) { + $zeilen[] = ['art' => 'Medium', 'titel' => (string) ($element->display_title ?: $element->working_title), 'url' => ContentElementResource::getUrl('view', ['record' => $element])]; + } + + foreach ($kompositionen->orderBy('designation')->limit($grenze)->get() as $composition) { + $context = EditorialVocabulary::compositionContext($composition->kind instanceof CompositionKind ? $composition->kind : CompositionKind::tryFrom((string) $composition->kind)); + $zeilen[] = ['art' => EditorialContentKind::CONTEXTS[$context ?? ''] ?? 'Kombination', 'titel' => (string) ($composition->display_title ?: $composition->designation), 'url' => EditorialCatalog::editUrl($composition)]; + } + + foreach ($artikel->orderBy('code')->limit($grenze)->get() as $article) { + $zeilen[] = ['art' => 'Lizenzartikel', 'titel' => trim($article->code.' '.($article->display_title ?: $article->working_title)), 'url' => LicenseArticleResource::getUrl('view', ['record' => $article])]; + } + + return ['zeilen' => $zeilen, 'mehr' => max(0, $gesamt - count($zeilen)), 'filter' => $filter]; + } +} diff --git a/app/Filament/Pages/Webpraesenz.php b/app/Filament/Pages/Webpraesenz.php new file mode 100644 index 0000000..ae4a153 --- /dev/null +++ b/app/Filament/Pages/Webpraesenz.php @@ -0,0 +1,1069 @@ + 'Hauptmenü', + 'footer' => 'Fußbereich: Service', + 'footer_contact' => 'Fußbereich: Kontakt', + 'footer_legal' => 'Fußbereich: Rechtliches', + ]; + + protected static ?string $navigationLabel = 'Website'; + + protected static ?string $slug = 'webpraesenz'; + + protected static ?string $title = 'Webpräsenz'; + + protected static ?int $navigationSort = 20; + + protected string $view = 'filament.cms.webpraesenz'; + + #[Url(as: 'bereich', except: 'seiten')] + public string $register = 'seiten'; + + #[Url(as: 'suche', except: '')] + public string $suche = ''; + + #[Url(as: 'zustand', except: 'alle')] + public string $zustand = 'alle'; + + #[Url(as: 'im-menue', except: 'alle')] + public string $imMenue = 'alle'; + + #[Url(as: 'sortierung', except: 'bearbeitet')] + public string $sortierung = 'bearbeitet'; + + /** Angezeigter Menübereich. */ + #[Url(as: 'menue', except: 'header')] + public string $menue = 'header'; + + /** Ausgewählter Eintrag (Schlüssel „e{id}“ oder „n{zähler}“ für neue Einträge). */ + public ?string $auswahl = null; + + /** @var array */ + public array $eintraege = []; + + /** Globale Reihenfolge der Schlüssel; entspricht sort_order. @var list */ + public array $folge = []; + + /** Zu entfernende gespeicherte Einträge. @var list */ + public array $entfernt = []; + + /** Geladener Stand je Eintrag (id => updated_at) zur Erkennung zwischenzeitlicher Speicherungen. @var array */ + public array $stand = []; + + /** Fingerabdruck je Menübereich beim Laden. @var array */ + public array $geladen = []; + + public int $neu = 0; + + /** Schmale Anordnung (Entwurf 3) statt Liste mit festem Detailbereich (Entwurf 1); gesetzt nach verfügbarer Breite. */ + public bool $schmal = false; + + /** Die Menüs wurden seit dem Laden an anderer Stelle gespeichert. */ + public bool $konflikt = false; + + /** @var array{aktion: string, argument: int|string|null, titel: string, text: string, label: string, gefahr: bool}|null */ + public ?array $bestaetigung = null; + + /** Eintrag, dessen Ziel gerade gewählt wird. */ + public ?string $zielwahl = null; + + public string $zielSuche = ''; + + public static function canAccess(): bool + { + $user = auth()->user(); + + return $user !== null && $user->can('viewAny', CmsPage::class) && $user->can('viewAny', NavigationItem::class); + } + + public function mount(): void + { + $this->register = in_array($this->register, ['seiten', 'menues'], true) ? $this->register : 'seiten'; + $this->menue = array_key_exists($this->menue, self::BEREICHE) ? $this->menue : 'header'; + $this->ladeMenues(); + $this->auswahl = $this->ersterEintrag($this->menue); + } + + public function getMaxContentWidth(): Width|string|null + { + return Width::Full; + } + + public function getHeader(): ?View + { + return view('filament.cms.webpraesenz-kopf'); + } + + public function zeigeRegister(string $register): void + { + $this->register = in_array($register, ['seiten', 'menues'], true) ? $register : 'seiten'; + } + + // --------------------------------------------------------------------------------------------------------------- + // Seiten + // --------------------------------------------------------------------------------------------------------------- + + protected function bestandFilterEigenschaften(): array + { + return ['suche', 'zustand', 'imMenue', 'sortierung']; + } + + public function resetFilters(): void + { + $this->suche = ''; + $this->zustand = 'alle'; + $this->imMenue = 'alle'; + $this->bestandGrenze = Bestand::SCHRITT; + } + + /** + * @return array + */ + public function bestand(): array + { + $needle = mb_strtolower(trim($this->suche)); + $menues = NavigationItem::query()->with('page')->orderBy('sort_order')->orderBy('id')->get(); + $zeilen = []; + + $seiten = CmsPage::query()->with('latestRevision')->get(); + $seiten = match ($this->sortierung) { + 'bearbeitet_alt' => $seiten->sortBy([['updated_at', 'asc'], ['id', 'asc']]), + 'adresse' => $seiten->sortBy('path', SORT_NATURAL), + 'adresse_ab' => $seiten->sortByDesc('path', SORT_NATURAL), + default => $seiten->sortBy([['updated_at', 'desc'], ['id', 'desc']]), + }; + + foreach ($seiten as $seite) { + $zeile = $this->seitenZeile($seite, $menues); + + if ($this->zustand !== 'alle' && ! in_array($this->zustand, $zeile['zustand'], true)) { + continue; + } + if ($this->imMenue !== 'alle' && ! in_array($this->imMenue, $zeile['menue'], true)) { + continue; + } + if ($needle !== '' && ! str_contains(mb_strtolower($zeile['titel'].' '.$zeile['meta']), $needle)) { + continue; + } + + $zeilen[] = $zeile; + } + + return [ + 'suche' => ['eigenschaft' => 'suche', 'label' => 'Suche', 'platzhalter' => 'Titel oder Adresse'], + 'filter' => [ + ['eigenschaft' => 'zustand', 'label' => 'Veröffentlichung', 'vorgabe' => 'alle', 'optionen' => [ + 'alle' => 'Alle Seiten', + 'veroeffentlicht' => 'Veröffentlicht', + 'entwurf_neuer' => 'Entwurf neuer als öffentlich', + 'nur_entwurf' => 'Nur Entwurf, nicht veröffentlicht', + ]], + ['eigenschaft' => 'imMenue', 'label' => 'Menü', 'vorgabe' => 'alle', 'optionen' => [ + 'alle' => 'Alle Seiten', + 'hauptmenue' => 'Im Hauptmenü sichtbar', + 'nicht_hauptmenue' => 'Nicht im Hauptmenü', + 'ohne' => 'Ohne Menüeintrag', + ]], + ], + 'sortierung' => ['eigenschaft' => 'sortierung', 'label' => 'Sortierung', 'optionen' => [ + 'bearbeitet' => 'Zuletzt bearbeitet zuerst', + 'bearbeitet_alt' => 'Am längsten unbearbeitet zuerst', + 'adresse' => 'Adresse A–Z', + 'adresse_ab' => 'Adresse Z–A', + ]], + 'hinweis' => $this->menuesGeaendert() ? 'Im Register „Menüs“ gibt es ungespeicherte Änderungen. Die Menüzuordnungen hier zeigen den gespeicherten Stand.' : null, + 'zeilen' => $zeilen, + 'einheit' => ['Seite', 'Seiten'], + 'leer' => ['titel' => 'Noch keine Seiten', 'text' => 'Mit „Seite anlegen“ entsteht die erste Seite als Entwurf.'], + ]; + } + + /** + * @param Collection $menues + * @return array + */ + private function seitenZeile(CmsPage $seite, Collection $menues): array + { + $neueste = $seite->latestRevision; + $chips = []; + $zustand = []; + + if ($seite->published_revision_id === null) { + $chips[] = ['label' => 'Nur Entwurf, nicht veröffentlicht', 'ton' => 'offen']; + $zustand[] = 'nur_entwurf'; + } else { + $chips[] = ['label' => 'Veröffentlicht', 'ton' => 'gut']; + $zustand[] = 'veroeffentlicht'; + if ($neueste !== null && $neueste->id !== $seite->published_revision_id) { + $chips[] = ['label' => 'Entwurf neuer', 'ton' => 'offen']; + $zustand[] = 'entwurf_neuer'; + } + } + + $eintraege = $menues->filter(fn (NavigationItem $item): bool => $item->page_id === $seite->id + || ($item->page_id === null && $item->targetPath() === $seite->path)); + $sichtbarImKopf = false; + + foreach ($eintraege as $item) { + $bereich = self::BEREICHE[$item->placement] ?? $item->placement; + $chips[] = ['label' => $bereich.($item->is_visible ? '' : ' · ausgeblendet'), 'ton' => $item->is_visible ? 'neutral' : 'leise']; + $sichtbarImKopf = $sichtbarImKopf || ($item->placement === 'header' && $item->is_visible); + } + + if ($eintraege->isEmpty()) { + $chips[] = ['label' => 'Ohne Menüeintrag', 'ton' => 'leise']; + } + + $hinweise = ['Zuletzt bearbeitet '.$seite->updated_at?->timezone('Europe/Berlin')->format('d.m.Y H:i') + .($seite->published_revision_id !== null ? ' · öffentlich: Revision '.$seite->published_revision_id : '')]; + if ($seite->published_revision_id !== null && ! $eintraege->contains(fn (NavigationItem $item): bool => $item->is_visible)) { + $hinweise[] = 'Ohne sichtbaren Menüeintrag, aber öffentlich über die Adresse erreichbar und in der Sitemap.'; + } + + $aktionen = [['label' => 'Bearbeiten', 'href' => PageResource::getUrl('edit', ['record' => $seite]), 'icon' => 'stift']]; + if ($neueste !== null) { + $aktionen[] = ['label' => 'Vorschau', 'href' => route('pages.preview.devices', $neueste), 'icon' => 'auge', 'neu' => true]; + } + if (auth()->user()?->can('create', CmsPage::class)) { + $aktionen[] = ['label' => 'Duplizieren', 'wire' => "mountAction('duplicate', { page: {$seite->id} })"]; + } + + return [ + 'schluessel' => 'seite-'.$seite->id, + 'titel' => $neueste?->contentTitle() ?: $seite->path, + 'meta' => $seite->path, + 'symbol' => 'dokument', + 'url' => PageResource::getUrl('edit', ['record' => $seite]), + 'chips' => $chips, + 'hinweise' => $hinweise, + 'aktionen' => $aktionen, + 'zustand' => $zustand, + 'menue' => array_values(array_filter([ + $sichtbarImKopf ? 'hauptmenue' : 'nicht_hauptmenue', + $eintraege->isEmpty() ? 'ohne' : null, + ])), + ]; + } + + public function duplicateAction(): Action + { + return Action::make('duplicate') + ->label('Duplizieren') + ->authorize(fn (): bool => auth()->user()?->can('create', CmsPage::class) ?? false) + ->modalHeading(fn (array $arguments): string => 'Seite '.(CmsPage::query()->find($arguments['page'] ?? 0)?->path ?? '').' duplizieren') + ->modalDescription('Die Kopie ist ein Entwurf unter neuer Adresse. Die Vorlage bleibt unverändert; ein Menüeintrag entsteht nicht.') + ->schema([ + TextInput::make('path') + ->label('Pfad der neuen Seite') + ->required() + ->maxLength(255) + ->helperText('Zum Beispiel /neue-landingpage'), + ]) + ->modalSubmitActionLabel('Duplizieren') + ->action(function (array $arguments, array $data, PageService $service): void { + $source = CmsPage::query()->findOrFail($arguments['page'] ?? 0); + + try { + $copy = $service->duplicate($source, $data['path'], auth()->user()); + } catch (ValidationException $exception) { + throw ValidationException::withMessages(['mountedActions.0.data.path' => $exception->errors()['path'] ?? Arr::flatten($exception->errors())]); + } + + $this->redirect(PageResource::getUrl('edit', ['record' => $copy])); + }); + } + + // --------------------------------------------------------------------------------------------------------------- + // Menüs: Arbeitsstand + // --------------------------------------------------------------------------------------------------------------- + + public function ladeMenues(): void + { + $items = NavigationItem::query()->orderBy('sort_order')->orderBy('id')->get(); + $this->eintraege = []; + $this->folge = []; + $this->stand = []; + + foreach ($items as $item) { + $k = 'e'.$item->id; + $this->eintraege[$k] = [ + 'id' => $item->id, + 'label' => (string) $item->label, + 'page_id' => $item->page_id, + 'url' => (string) ($item->url ?? ''), + 'placement' => (string) $item->placement, + 'parent' => $item->parent_id !== null ? 'e'.$item->parent_id : null, + 'is_visible' => (bool) $item->is_visible, + ]; + $this->folge[] = $k; + $this->stand[$k] = (string) $item->getRawOriginal('updated_at'); + } + + foreach ($this->eintraege as $k => $eintrag) { + if ($eintrag['parent'] !== null && ! isset($this->eintraege[$eintrag['parent']])) { + $this->eintraege[$k]['parent'] = null; + } + } + + $this->entfernt = []; + $this->konflikt = false; + $this->resetErrorBag(); + $this->geladen = $this->bereichsStaende(); + } + + /** + * Fingerabdruck je Menübereich: Einträge in Anzeigefolge mit allen Eigenschaften. Unterschiede zeigen, welche + * Bereiche eine Speicherung tatsächlich verändert. + * + * @return array + */ + private function bereichsStaende(): array + { + $staende = []; + + foreach ($this->folge as $k) { + $e = $this->eintraege[$k]; + $staende[$e['placement']][] = [ + $e['id'] ?? $k, + trim($e['label']), + $e['page_id'] !== null ? (int) $e['page_id'] : null, + trim($e['url']), + (bool) $e['is_visible'], + $this->elternVon($k), + ]; + } + + return array_map(fn (array $zeilen): string => md5(json_encode($zeilen, JSON_UNESCAPED_UNICODE) ?: ''), $staende); + } + + /** + * Bereiche mit ungespeicherten Änderungen, in der festen Reihenfolge der Bereiche. + * + * @return list + */ + public function betroffeneBereiche(): array + { + $jetzt = $this->bereichsStaende(); + $bereiche = []; + + foreach (array_unique([...array_keys(self::BEREICHE), ...array_keys($jetzt), ...array_keys($this->geladen)]) as $bereich) { + if (($jetzt[$bereich] ?? null) !== ($this->geladen[$bereich] ?? null)) { + $bereiche[] = $bereich; + } + } + + return $bereiche; + } + + public function menuesGeaendert(): bool + { + return $this->betroffeneBereiche() !== []; + } + + public function bereichsName(string $bereich): string + { + return self::BEREICHE[$bereich] ?? $bereich; + } + + /** Wirksamer übergeordneter Eintrag: Untermenüs gibt es nur im Hauptmenü. */ + public function elternVon(string $k): ?string + { + $e = $this->eintraege[$k] ?? null; + + return $e !== null && $e['placement'] === 'header' && $e['parent'] !== null && isset($this->eintraege[$e['parent']]) ? $e['parent'] : null; + } + + /** + * @return list + */ + public function kinderVon(string $k): array + { + return array_values(array_filter($this->folge, fn (string $x): bool => $this->elternVon($x) === $k)); + } + + /** + * Einträge mit derselben Ebene im selben Bereich, in Anzeigefolge. + * + * @return list + */ + public function geschwister(string $k): array + { + $e = $this->eintraege[$k] ?? null; + if ($e === null) { + return []; + } + $eltern = $this->anzeigeElternVon($k); + + return array_values(array_filter($this->folge, fn (string $x): bool => $this->eintraege[$x]['placement'] === $e['placement'] && $this->anzeigeElternVon($x) === $eltern)); + } + + /** + * Eltern in der Anzeige: nur ein Eintrag der obersten Ebene des Hauptmenüs kann Untereinträge zeigen. + */ + private function anzeigeElternVon(string $k): ?string + { + $eltern = $this->elternVon($k); + + return $eltern !== null && $this->eintraege[$eltern]['placement'] === 'header' && $this->elternVon($eltern) === null ? $eltern : null; + } + + /** + * Menübaum eines Bereichs: oberste Ebene in Folge, darunter die Untereinträge. + * + * @return list}> + */ + public function baum(string $bereich): array + { + $baum = []; + + foreach ($this->folge as $k) { + if ($this->eintraege[$k]['placement'] !== $bereich || $this->anzeigeElternVon($k) !== null) { + continue; + } + $baum[] = ['k' => $k, 'kinder' => array_values(array_filter($this->folge, fn (string $x): bool => $this->anzeigeElternVon($x) === $k))]; + } + + return $baum; + } + + public function anzahl(string $bereich): int + { + return count(array_filter($this->eintraege, fn (array $e): bool => $e['placement'] === $bereich)); + } + + private function ersterEintrag(string $bereich): ?string + { + return $this->baum($bereich)[0]['k'] ?? null; + } + + public function zeigeMenue(string $bereich): void + { + if (! array_key_exists($bereich, self::BEREICHE)) { + return; + } + + $this->menue = $bereich; + if ($this->auswahl === null || ($this->eintraege[$this->auswahl]['placement'] ?? null) !== $bereich) { + $this->auswahl = $this->ersterEintrag($bereich); + } + } + + public function waehle(string $k): void + { + if (! isset($this->eintraege[$k])) { + return; + } + + $this->auswahl = $k; + $this->menue = array_key_exists($this->eintraege[$k]['placement'], self::BEREICHE) ? $this->eintraege[$k]['placement'] : $this->menue; + } + + public function nachbar(string $k, string $richtung): ?string + { + $geschwister = $this->geschwister($k); + $index = array_search($k, $geschwister, true); + + if ($index === false) { + return null; + } + + return $geschwister[$richtung === 'hoch' ? $index - 1 : $index + 1] ?? null; + } + + /** + * Tauscht den Eintrag mit seinem Nachbarn derselben Ebene. Ohne gültigen Nachbarn geschieht nichts; die Ebene + * wechselt nie (WEB-12). + */ + public function verschiebe(string $k, string $richtung, bool $fokusZeile = false): void + { + $nachbar = $this->nachbar($k, $richtung); + + if ($nachbar === null) { + return; + } + + $a = array_search($k, $this->folge, true); + $b = array_search($nachbar, $this->folge, true); + [$this->folge[$a], $this->folge[$b]] = [$this->folge[$b], $this->folge[$a]]; + $this->auswahl = $k; + + if ($fokusZeile) { + $this->js("requestAnimationFrame(() => document.querySelector('[data-menue=\"$k\"] .vw-menue-waehlen')?.focus())"); + } + } + + /** + * Neue Reihenfolge einer Ebene nach Ziehen. Nur genau dieselben Geschwister werden umgeordnet. + * + * @param list $schluessel + */ + public function sortiere(array $schluessel): void + { + $schluessel = array_values(array_filter($schluessel, fn ($k): bool => is_string($k) && isset($this->eintraege[$k]))); + + if ($schluessel === []) { + return; + } + + $geschwister = $this->geschwister($schluessel[0]); + if (count($geschwister) !== count($schluessel) || array_diff($geschwister, $schluessel) !== []) { + return; + } + + $positionen = array_map(fn (string $k): int => (int) array_search($k, $this->folge, true), $geschwister); + sort($positionen); + + foreach ($positionen as $i => $position) { + $this->folge[$position] = $schluessel[$i]; + } + } + + public function eintragHinzufuegen(): void + { + $k = 'n'.(++$this->neu); + $this->eintraege[$k] = [ + 'id' => null, + 'label' => '', + 'page_id' => null, + 'url' => '', + 'placement' => $this->menue, + 'parent' => null, + 'is_visible' => true, + ]; + $this->folge[] = $k; + $this->auswahl = $k; + $this->js("requestAnimationFrame(() => document.getElementById('menue-text')?.focus())"); + } + + public function umschalten(string $k): void + { + if (isset($this->eintraege[$k])) { + $this->eintraege[$k]['is_visible'] = ! $this->eintraege[$k]['is_visible']; + $this->auswahl = $k; + } + } + + /** + * Eingaben im Detailbereich: Folgen werden sofort im Arbeitsstand sichtbar. + */ + public function updatedEintraege(mixed $value, string $pfad): void + { + [$k, $feld] = array_pad(explode('.', $pfad, 2), 2, null); + + if ($k === null || ! isset($this->eintraege[$k])) { + return; + } + + $this->resetErrorBag("eintraege.$k.$feld"); + + match ($feld) { + 'placement' => $this->bereichGeaendert($k), + 'parent' => $this->elternGeaendert($k), + 'page_id' => $this->eintraege[$k]['page_id'] = blank($value) ? null : (int) $value, + 'is_visible' => $this->eintraege[$k]['is_visible'] = (bool) $value, + default => null, + }; + } + + private function bereichGeaendert(string $k): void + { + $bereich = $this->eintraege[$k]['placement']; + + if (! array_key_exists($bereich, self::BEREICHE)) { + $this->eintraege[$k]['placement'] = 'header'; + + return; + } + + // Untereinträge verschwänden öffentlich, wenn ihr Eintrag den Hauptmenü verließe (SiteNavigation::header()). + if ($bereich !== 'header' && $this->kinderVon($k) !== []) { + $this->eintraege[$k]['placement'] = 'header'; + $this->addError("eintraege.$k.placement", 'Dieser Eintrag öffnet ein Untermenü. Ordnen Sie zuerst seine Untereinträge anders ein.'); + + return; + } + + if ($bereich !== 'header') { + $this->eintraege[$k]['parent'] = null; + } + + $this->ansEnde($k); + $this->menue = $bereich; + } + + private function elternGeaendert(string $k): void + { + $eltern = blank($this->eintraege[$k]['parent']) ? null : (string) $this->eintraege[$k]['parent']; + $this->eintraege[$k]['parent'] = $eltern; + + if ($eltern !== null && ! $this->kannEltern($k, $eltern)) { + $this->eintraege[$k]['parent'] = null; + $this->addError("eintraege.$k.parent", 'Untermenüs sind nur unter einem Eintrag der obersten Ebene der Hauptnavigation möglich.'); + } + + $this->ansEnde($k); + } + + private function kannEltern(string $k, string $eltern): bool + { + return $eltern !== $k + && isset($this->eintraege[$eltern]) + && $this->eintraege[$eltern]['placement'] === 'header' + && $this->elternVon($eltern) === null + && $this->kinderVon($k) === []; + } + + /** + * Mögliche übergeordnete Einträge für den Eintrag: oberste Ebene des Hauptmenüs, nicht er selbst. + * + * @return array + */ + public function elternOptionen(string $k): array + { + $optionen = []; + + foreach ($this->baum('header') as $knoten) { + if ($knoten['k'] !== $k) { + $optionen[$knoten['k']] = trim($this->eintraege[$knoten['k']]['label']) ?: 'Ohne Menütext'; + } + } + + return $optionen; + } + + /** Nach einem Ebenen- oder Bereichswechsel steht der Eintrag am Ende seiner neuen Ebene. */ + private function ansEnde(string $k): void + { + $this->folge = [...array_values(array_filter($this->folge, fn (string $x): bool => $x !== $k)), $k]; + } + + public function zielAdresseNutzen(string $k): void + { + if (isset($this->eintraege[$k])) { + $this->eintraege[$k]['page_id'] = null; + $this->js("requestAnimationFrame(() => document.getElementById('menue-adresse')?.focus())"); + } + } + + public function oeffneZielwahl(string $k): void + { + if (isset($this->eintraege[$k])) { + $this->zielwahl = $k; + $this->zielSuche = ''; + } + } + + public function schliesseZielwahl(): void + { + $this->zielwahl = null; + } + + public function waehleZiel(int $seiteId): void + { + if ($this->zielwahl === null || ! isset($this->eintraege[$this->zielwahl]) || ! CmsPage::query()->whereKey($seiteId)->exists()) { + return; + } + + $this->eintraege[$this->zielwahl]['page_id'] = $seiteId; + $this->eintraege[$this->zielwahl]['url'] = ''; + $this->resetErrorBag("eintraege.{$this->zielwahl}.url"); + $this->zielwahl = null; + } + + /** + * Seiten für „Ziel ändern“: Titel, Adresse und Veröffentlichungszustand. + * + * @return list + */ + public function zielSeiten(): array + { + $needle = mb_strtolower(trim($this->zielSuche)); + + return CmsPage::query()->with('latestRevision')->orderBy('path')->get() + ->map(fn (CmsPage $seite): array => [ + 'id' => $seite->id, + 'titel' => $seite->latestRevision?->contentTitle() ?: $seite->path, + 'pfad' => $seite->path, + 'zustand' => $this->seitenZustand($seite), + ]) + ->filter(fn (array $s): bool => $needle === '' || str_contains(mb_strtolower($s['titel'].' '.$s['pfad']), $needle)) + ->values() + ->all(); + } + + /** + * @return array{label: string, ton: string} + */ + public function seitenZustand(CmsPage $seite): array + { + if ($seite->published_revision_id === null) { + return ['label' => 'Nur Entwurf, öffentlich nicht erreichbar', 'ton' => 'offen']; + } + + return $seite->latestRevision !== null && $seite->latestRevision->id !== $seite->published_revision_id + ? ['label' => 'Veröffentlicht · Entwurf neuer', 'ton' => 'gut'] + : ['label' => 'Veröffentlicht', 'ton' => 'gut']; + } + + /** + * Ziel eines Eintrags für Liste und Detailbereich. + * + * @return array{art: string, titel: ?string, pfad: ?string, zustand: ?array{label: string, ton: string}, seite: ?CmsPage} + */ + public function zielVon(string $k): array + { + $e = $this->eintraege[$k]; + + if ($e['page_id'] !== null) { + $seite = $this->seitenCache()->get((int) $e['page_id']); + + return $seite === null + ? ['art' => 'fehlt', 'titel' => null, 'pfad' => null, 'zustand' => ['label' => 'Zielseite nicht mehr vorhanden', 'ton' => 'achtung'], 'seite' => null] + : ['art' => 'seite', 'titel' => $seite->latestRevision?->contentTitle() ?: $seite->path, 'pfad' => $seite->path, 'zustand' => $this->seitenZustand($seite), 'seite' => $seite]; + } + + if (trim($e['url']) !== '') { + return ['art' => 'adresse', 'titel' => null, 'pfad' => trim($e['url']), 'zustand' => SafeUrl::isSafe(trim($e['url'])) ? null : ['label' => 'Adresse nicht zulässig', 'ton' => 'achtung'], 'seite' => null]; + } + + return ['art' => 'keins', 'titel' => null, 'pfad' => null, 'zustand' => null, 'seite' => null]; + } + + /** @var Collection|null */ + private ?Collection $seiten = null; + + /** + * @return Collection + */ + private function seitenCache(): Collection + { + return $this->seiten ??= CmsPage::query()->with('latestRevision')->get()->keyBy('id'); + } + + // --------------------------------------------------------------------------------------------------------------- + // Bestätigungen (gemeinsamer Dialog filament.verwaltung.bestaetigung) + // --------------------------------------------------------------------------------------------------------------- + + public function askConfirmation(string $aktion, int|string|null $argument = null): void + { + if ($aktion === 'entfernen' && is_string($argument) && isset($this->eintraege[$argument])) { + $e = $this->eintraege[$argument]; + $name = trim($e['label']) ?: 'Ohne Menütext'; + $kinder = array_map(fn (string $k): string => '„'.(trim($this->eintraege[$k]['label']) ?: 'Ohne Menütext').'“', $this->kinderVon($argument)); + $text = '„'.$name.'“ wird aus '.$this->bereichsName($e['placement']).' entfernt. Die Zielseite bleibt bestehen; ihre Veröffentlichung ändert sich nicht.'; + if ($kinder !== []) { + $text .= ' '.(count($kinder) === 1 ? 'Der Untereintrag '.$kinder[0].' rückt' : 'Die Untereinträge '.implode(', ', $kinder).' rücken').' in die oberste Ebene des Hauptmenüs.'; + } + $text .= ' Wirksam wird das erst mit „Menüänderungen speichern“.'; + $this->bestaetigung = ['aktion' => 'entfernen', 'argument' => $argument, 'titel' => '„'.$name.'“ aus dem Menü entfernen?', 'text' => $text, 'label' => 'Aus Menü entfernen', 'gefahr' => true]; + + return; + } + + $this->bestaetigung = match ($aktion) { + 'verwerfen' => ['aktion' => 'verwerfen', 'argument' => null, 'titel' => 'Menüänderungen verwerfen?', 'text' => 'Alle Menüs kehren zum gespeicherten Stand zurück. Betroffen: '.implode(', ', array_map($this->bereichsName(...), $this->betroffeneBereiche())).'.', 'label' => 'Verwerfen', 'gefahr' => true], + 'neuLaden' => ['aktion' => 'neuLaden', 'argument' => null, 'titel' => 'Gespeicherten Stand laden?', 'text' => 'Die Menüs wurden inzwischen an anderer Stelle gespeichert. Laden zeigt diesen Stand; Ihre ungespeicherten Menüänderungen gehen dabei verloren.', 'label' => 'Gespeicherten Stand laden', 'gefahr' => true], + default => null, + }; + } + + public function confirmConfirmation(): void + { + $frage = $this->bestaetigung; + $this->bestaetigung = null; + + match ($frage['aktion'] ?? null) { + 'entfernen' => $this->entferne((string) $frage['argument']), + 'verwerfen', 'neuLaden' => $this->neuLaden(), + default => null, + }; + } + + public function cancelConfirmation(): void + { + $this->bestaetigung = null; + } + + private function neuLaden(): void + { + $auswahl = $this->auswahl; + $this->ladeMenues(); + $this->auswahl = $auswahl !== null && isset($this->eintraege[$auswahl]) ? $auswahl : $this->ersterEintrag($this->menue); + } + + /** + * Entfernt den Eintrag aus dem Arbeitsstand. Untereinträge rücken in die oberste Ebene, wie es die Datenbank beim + * Löschen tut (parent_id nullOnDelete). + */ + private function entferne(string $k): void + { + if (! isset($this->eintraege[$k])) { + return; + } + + $geschwister = $this->geschwister($k); + $index = (int) array_search($k, $geschwister, true); + + foreach ($this->kinderVon($k) as $kind) { + $this->eintraege[$kind]['parent'] = null; + } + + if ($this->eintraege[$k]['id'] !== null) { + $this->entfernt[] = (int) $this->eintraege[$k]['id']; + } + + unset($this->eintraege[$k]); + $this->folge = array_values(array_filter($this->folge, fn (string $x): bool => $x !== $k)); + $rest = array_values(array_filter($geschwister, fn (string $x): bool => $x !== $k)); + $this->auswahl = $rest[min($index, count($rest) - 1)] ?? $this->ersterEintrag($this->menue); + } + + // --------------------------------------------------------------------------------------------------------------- + // Speichern + // --------------------------------------------------------------------------------------------------------------- + + public function speichern(): void + { + $bereiche = $this->betroffeneBereiche(); + + if ($bereiche === []) { + Notification::make()->title('Keine Menüänderungen zu speichern')->send(); + + return; + } + + $geaendert = $this->pruefen(); + + try { + $ids = DB::transaction(fn (): array => $this->schreiben($geaendert)); + } catch (RuntimeException $exception) { + if ($exception->getMessage() !== 'veraltet') { + throw $exception; + } + $this->konflikt = true; + Notification::make()->title('Nicht gespeichert: Die Menüs wurden inzwischen an anderer Stelle geändert') + ->body('Ihre Änderungen sind noch offen. „Gespeicherten Stand laden“ zeigt den neuen Stand.') + ->danger()->persistent()->send(); + + return; + } + + $auswahl = $this->auswahl; + $this->ladeMenues(); + $this->auswahl = $auswahl !== null && isset($ids[$auswahl]) ? 'e'.$ids[$auswahl] : $this->ersterEintrag($this->menue); + + Notification::make() + ->title('Menüänderungen gespeichert') + ->body('Die öffentliche Navigation zeigt jetzt den neuen Stand: '.implode(', ', array_map($this->bereichsName(...), $bereiche)).'.') + ->success() + ->send(); + } + + /** + * Regeln der bisherigen Navigationsverwaltung für jeden neuen oder geänderten Eintrag sowie für Einträge, deren + * Untereinträge sich geändert haben. Beim ersten Fehler wird der Eintrag ausgewählt und sein Bereich gezeigt. + * + * @return list Schlüssel der neuen oder geänderten Einträge + */ + private function pruefen(): array + { + $gespeichert = NavigationItem::query()->get()->keyBy('id'); + $kinderVorher = $gespeichert->groupBy('parent_id')->map(fn (Collection $c): array => $c->pluck('id')->sort()->values()->all()); + $fehler = []; + $erster = null; + $alleGeaendert = []; + + foreach ($this->folge as $k) { + $e = $this->eintraege[$k]; + $alt = $e['id'] !== null ? $gespeichert->get($e['id']) : null; + $kinder = $this->kinderVon($k); + $kinderIds = collect($kinder)->map(fn (string $x): ?int => $this->eintraege[$x]['id'])->filter()->sort()->values()->all(); + + $geaendert = $alt === null + || $alt->label !== $e['label'] + || $alt->page_id !== ($e['page_id'] !== null ? (int) $e['page_id'] : null) + || (string) ($alt->url ?? '') !== $e['url'] + || $alt->placement !== $e['placement'] + || ($alt->parent_id !== null ? 'e'.$alt->parent_id : null) !== $this->elternVon($k) + || (bool) $alt->is_visible !== (bool) $e['is_visible'] + || count($kinder) !== count($kinderIds) + || ($kinderVorher->get($e['id']) ?? []) !== $kinderIds; + + if (! $geaendert) { + continue; + } + $alleGeaendert[] = $k; + + $eltern = $this->elternVon($k); + $validator = Validator::make([ + 'label' => trim($e['label']), + 'placement' => $e['placement'], + 'page_id' => $e['page_id'], + 'url' => trim($e['url']) === '' ? null : trim($e['url']), + ], [ + 'label' => ['required', 'string', 'max:80'], + 'placement' => ['required', 'in:'.implode(',', array_keys(self::BEREICHE))], + 'page_id' => ['nullable', 'integer', 'exists:pages,id'], + 'url' => ['nullable', 'string', 'max:500', SafeUrl::rule()], + ], [ + 'label.required' => 'Bitte einen Menütext eingeben.', + 'label.max' => 'Der Menütext hat höchstens 80 Zeichen.', + 'url.max' => 'Die Adresse hat höchstens 500 Zeichen.', + 'page_id.exists' => 'Diese Seite gibt es nicht mehr.', + ]); + + $meldungen = $validator->errors()->toArray(); + + if ($eltern !== null && ! $this->kannEltern($k, $eltern)) { + $meldungen['parent'][] = 'Untermenüs sind nur unter einem Eintrag der obersten Ebene der Hauptnavigation möglich.'; + } + if ($e['placement'] !== 'header' && $kinder !== []) { + $meldungen['placement'][] = 'Dieser Eintrag öffnet ein Untermenü. Ordnen Sie zuerst seine Untereinträge anders ein.'; + } + // Ein Eintrag mit Untereinträgen darf ohne eigenes Ziel nur das Untermenü öffnen. + if ($e['page_id'] === null && trim($e['url']) === '' && $kinder === []) { + $meldungen['url'][] = 'Wählen Sie eine Seite oder eine Adresse.'; + } + + foreach ($meldungen as $feld => $texte) { + $fehler["eintraege.$k.$feld"] = array_values(array_unique($texte)); + } + if ($meldungen !== [] && $erster === null) { + $erster = $k; + } + } + + if ($erster !== null) { + $this->register = 'menues'; + $this->waehle($erster); + + throw ValidationException::withMessages($fehler); + } + + return $alleGeaendert; + } + + /** + * Schreibt den Arbeitsstand. Geänderte Einträge werden vollständig geschrieben, unveränderte höchstens mit neuer + * Reihenfolge. sort_order bleibt erhalten, wo die Folge es zulässt (verglichen wie die Datenbank ordnet: Reihenfolge, + * dann Kennung); sonst rückt der Eintrag unmittelbar hinter seinen Vorgänger. + * + * @param list $geaendert + * @return array Schlüssel => gespeicherte Kennung + */ + private function schreiben(array $geaendert): array + { + $aktuell = NavigationItem::query()->lockForUpdate()->get()->keyBy('id'); + $standJetzt = $aktuell->mapWithKeys(fn (NavigationItem $item): array => ['e'.$item->id => (string) $item->getRawOriginal('updated_at')])->all(); + ksort($standJetzt); + $standGeladen = $this->stand; + ksort($standGeladen); + + if ($standJetzt !== $standGeladen) { + throw new RuntimeException('veraltet'); + } + + $user = auth()->user(); + $reihe = [ + ...array_values(array_filter($this->folge, fn (string $k): bool => $this->elternVon($k) === null)), + ...array_values(array_filter($this->folge, fn (string $k): bool => $this->elternVon($k) !== null)), + ]; + // Öffentlich zählt die Folge nur innerhalb eines Bereichs (SiteNavigation filtert nach Bereich). Deshalb wird je + // Bereich nummeriert: Eine Umordnung im Hauptmenü schreibt keinen Eintrag des Fußbereichs. + $sortierung = []; + $letzte = []; + + foreach ($this->folge as $k) { + $bereich = $this->eintraege[$k]['placement']; + $id = $this->eintraege[$k]['id']; + $bisher = $id !== null ? $aktuell->get($id)?->sort_order : null; + [$vorher, $vorherId] = $letzte[$bereich] ?? [-1, -1]; + // Neue Einträge erhalten die größte Kennung; sie stehen bei gleicher Reihenfolge also hinten. + $vergleichsId = $id ?? PHP_INT_MAX; + $wert = $bisher !== null && ([(int) $bisher, $vergleichsId] <=> [$vorher, $vorherId]) > 0 ? (int) $bisher : $vorher + 1; + $letzte[$bereich] = [$wert, $vergleichsId]; + $sortierung[$k] = $wert; + } + + $ids = []; + + foreach ($reihe as $k) { + $e = $this->eintraege[$k]; + $item = $e['id'] !== null ? $aktuell->get($e['id']) : new NavigationItem; + abort_if($item === null, 409); + abort_unless($user?->can($item->exists ? 'update' : 'create', $item->exists ? $item : NavigationItem::class), 403); + + if ($item->exists && ! in_array($k, $geaendert, true)) { + if ((int) $item->sort_order !== $sortierung[$k]) { + $item->sort_order = $sortierung[$k]; + $item->save(); + } + $ids[$k] = $item->id; + + continue; + } + + $eltern = $this->elternVon($k); + $item->fill([ + 'label' => trim($e['label']), + 'page_id' => $e['page_id'] !== null ? (int) $e['page_id'] : null, + 'url' => trim($e['url']) === '' ? null : trim($e['url']), + 'placement' => $e['placement'], + 'parent_id' => $eltern !== null ? ($ids[$eltern] ?? $this->eintraege[$eltern]['id']) : null, + 'is_visible' => (bool) $e['is_visible'], + 'sort_order' => $sortierung[$k], + ]); + + if ($item->isDirty()) { + $item->save(); + } + $ids[$k] = $item->id; + } + + foreach ($this->entfernt as $id) { + $item = $aktuell->get($id); + if ($item !== null) { + abort_unless($user?->can('delete', $item), 403); + $item->delete(); + } + } + + return $ids; + } +} diff --git a/app/Filament/Resources/Bundles/BundleResource.php b/app/Filament/Resources/Bundles/BundleResource.php new file mode 100644 index 0000000..977ef02 --- /dev/null +++ b/app/Filament/Resources/Bundles/BundleResource.php @@ -0,0 +1,79 @@ +components([ + Section::make('Bestandteile')->description('Was diese Fassung direkt enthält.')->schema([ + TextEntry::make('parts')->hiddenLabel()->listWithLineBreaks() + ->state(fn (Bundle $record): array => app(CatalogReading::class)->bundleParts($record)), + ]), + Section::make('Aufgelöste Lizenzartikel')->description('Darauf werden beim Erwerb die Berechtigungen vergeben.')->schema([ + TextEntry::make('articles')->hiddenLabel()->listWithLineBreaks() + ->state(fn (Bundle $record): array => app(CatalogReading::class)->bundleArticles($record)), + ]), + ]); + } + + public static function form(Schema $schema): Schema + { + return $schema; + } + + public static function table(Table $table): Table + { + return $table->columns([ + TextColumn::make('name')->label('Name')->searchable(), + TextColumn::make('versions_count')->counts('versions')->label('Fassungen'), + ]); + } + + public static function getPages(): array + { + return [ + 'index' => ListBundles::route('/'), + 'view' => ViewBundle::route('/{record}'), + ]; + } +} diff --git a/app/Filament/Resources/Bundles/Pages/ListBundles.php b/app/Filament/Resources/Bundles/Pages/ListBundles.php new file mode 100644 index 0000000..9f1667f --- /dev/null +++ b/app/Filament/Resources/Bundles/Pages/ListBundles.php @@ -0,0 +1,111 @@ +label('Paket anlegen') + ->modalHeading('Neues Paket') + ->modalDescription('Der Name genügt. Bestandteile stellst du danach am Paket zusammen.') + ->modalSubmitActionLabel('Paket anlegen') + ->schema([ + TextInput::make('name')->label('Name')->required(), + ])->action(function (array $data): void { + $bundle = null; + $this->report(function () use ($data, &$bundle): void { + $bundle = app(BundleService::class)->create($data['name']); + }, 'Das Paket ist angelegt.'); + + if ($bundle instanceof Bundle) { + $this->redirect(BundleResource::getUrl('view', ['record' => $bundle])); + } + }), + ]; + } + + protected function catalogRows(): array + { + $rows = []; + + foreach (Bundle::query()->with(['versions.items'])->orderBy('name')->get() as $bundle) { + $versions = $bundle->versions->sortByDesc('number'); + $published = $versions->first(fn ($version): bool => StatusValue::of($version->status) === BundleStatus::Veroeffentlicht->value); + $draft = $versions->first(fn ($version): bool => StatusValue::of($version->status) === BundleStatus::Entwurf->value); + $chips = []; + $zustand = []; + + if ($published !== null) { + $chips[] = ['label' => 'Fassung '.$published->number.' veröffentlicht', 'ton' => 'gut']; + $chips[] = ['label' => $published->items->count() === 1 ? '1 Bestandteil' : $published->items->count().' Bestandteile', 'ton' => 'leise']; + $zustand[] = 'veroeffentlicht'; + } else { + $chips[] = ['label' => $versions->isEmpty() ? 'Noch keine Fassung' : 'Noch nicht veröffentlicht', 'ton' => 'offen']; + $zustand[] = 'ohne'; + } + + if ($draft !== null) { + $chips[] = ['label' => 'Fassung '.$draft->number.' in Arbeit', 'ton' => 'offen']; + $zustand[] = 'entwurf'; + } + + if ($bundle->archived_at !== null) { + $chips[] = ['label' => 'Archiviert', 'ton' => 'leise']; + $zustand[] = 'archiviert'; + } + + $url = BundleResource::getUrl('view', ['record' => $bundle]); + $rows[] = [ + 'schluessel' => 'p'.$bundle->id, + 'titel' => $bundle->name, + 'meta' => 'Paket', + 'symbol' => 'modul', + 'url' => $url, + 'chips' => $chips, + 'zustand' => $zustand, + 'aktionen' => [['label' => 'Öffnen', 'href' => $url]], + ]; + } + + return $rows; + } + + protected function zustandOptionen(): array + { + return ['alle' => 'Jeder Zustand', 'veroeffentlicht' => 'Veröffentlicht', 'ohne' => 'Noch nicht veröffentlicht', 'entwurf' => 'Fassung in Arbeit', 'archiviert' => 'Archiviert']; + } + + protected function einheit(): array + { + return ['Paket', 'Pakete']; + } + + protected function leer(): array + { + return ['titel' => 'Noch keine Pakete', 'text' => 'Mit „Paket anlegen“ oben entsteht das erste Paket.']; + } +} diff --git a/app/Filament/Resources/Bundles/Pages/ViewBundle.php b/app/Filament/Resources/Bundles/Pages/ViewBundle.php new file mode 100644 index 0000000..1a4100e --- /dev/null +++ b/app/Filament/Resources/Bundles/Pages/ViewBundle.php @@ -0,0 +1,197 @@ +getRecord()->name; + } + + public function getHeading(): string|Htmlable + { + return ''; + } + + /** + * @return array + */ + public function getBreadcrumbs(): array + { + return []; + } + + public function getMaxContentWidth(): Width|string|null + { + return Width::Full; + } + + protected function getHeaderActions(): array + { + return []; + } + + public function infolist(Schema $schema): Schema + { + return $schema->components([ + View::make('filament.catalog.objekt')->viewData(fn (): array => $this->paketDaten())->columnSpanFull(), + ])->columns(1); + } + + public function publishedVersion(): ?BundleVersion + { + /** @var Bundle $bundle */ + $bundle = $this->getRecord(); + + return $bundle->versions() + ->where('status', BundleStatus::Veroeffentlicht) + ->orderByDesc('number') + ->with(['items.article', 'items.nestedBundle']) + ->first(); + } + + public function publishAction(): Action + { + return Action::make('publish') + ->label(fn (): string => $this->publishedVersion() !== null ? 'Geänderte Fassung veröffentlichen' : 'Fassung veröffentlichen') + ->modalHeading(fn (): string => $this->publishedVersion() !== null + ? 'Paket ändern: Fassung '.$this->nextNumber().' veröffentlichen' + : 'Erste Fassung veröffentlichen') + ->modalDescription(fn (): string => ($published = $this->publishedVersion()) !== null + ? 'Die Maske ist mit Fassung '.$published->number.' vorbelegt. Fassung '.$published->number.' bleibt veröffentlicht und unverändert; Angebote verweisen weiter auf die Paketfassung, die sie nennen.' + : 'Die gewählten Lizenzartikel und Pakete bilden die erste Fassung. Sie ist danach unveränderlich.') + ->modalSubmitActionLabel(fn (): string => 'Fassung '.$this->nextNumber().' veröffentlichen') + ->fillForm(fn (): array => $this->formFromPublished()) + ->schema([ + CheckboxList::make('articles')->label('Lizenzartikel')->options(fn (): array => CatalogOptions::articles()), + CheckboxList::make('bundles')->label('Enthaltene Pakete') + ->options(function (): array { + $options = CatalogOptions::bundles(); + unset($options[$this->getRecord()->getKey()]); + + return $options; + }), + ]) + ->action(function (array $data): void { + $this->report(function () use ($data): string { + /** @var Bundle $bundle */ + $bundle = $this->getRecord(); + $items = []; + + foreach ($data['articles'] ?? [] as $id) { + $items[] = LicenseArticle::query()->findOrFail($id); + } + + foreach ($data['bundles'] ?? [] as $id) { + $items[] = Bundle::query()->findOrFail($id); + } + + $version = app(BundleService::class)->publish($bundle, $items); + + return 'Fassung '.$version->number.' ist veröffentlicht.'; + }, 'Die Paketfassung ist veröffentlicht.'); + $this->getRecord()->unsetRelations(); + $this->getRecord()->refresh(); + }); + } + + /** + * @return array{articles: list, bundles: list} + */ + private function formFromPublished(): array + { + $published = $this->publishedVersion(); + + return [ + 'articles' => $published?->items->pluck('license_article_id')->filter()->values()->all() ?? [], + 'bundles' => $published?->items->pluck('nested_bundle_id')->filter()->values()->all() ?? [], + ]; + } + + private function nextNumber(): int + { + return ((int) $this->getRecord()->versions()->max('number')) + 1; + } + + /** + * @return array + */ + private function paketDaten(): array + { + /** @var Bundle $bundle */ + $bundle = $this->getRecord(); + $published = $this->publishedVersion(); + $articles = $published !== null ? app(CatalogReading::class)->bundleArticles($bundle) : []; + + return [ + 'kopf' => [ + 'brot' => [['label' => 'Pakete', 'href' => BundleResource::getUrl('index')], $bundle->name], + 'titel' => $bundle->name, + 'typ' => 'Paket', + 'status' => $published !== null + ? ['text' => 'Fassung '.$published->number.' veröffentlicht', 'ton' => 'gut'] + : ['text' => 'Noch keine veröffentlichte Fassung. Bestandteile werden mit der Fassung festgeschrieben.', 'ton' => 'offen'], + 'aktionen' => [[ + 'label' => $published !== null ? 'Geänderte Fassung veröffentlichen' : 'Fassung veröffentlichen', + 'wire' => "mountAction('publish')", + 'art' => 'primary', + ]], + ], + 'haupt' => [ + [ + 'titel' => 'Bestandteile', + 'zusatz' => $published !== null ? 'Fassung '.$published->number : null, + 'hilfe' => 'Was diese Fassung direkt enthält.', + 'zeilen' => $published === null ? [] : $published->items->sortBy('position')->map(fn ($item): array => [ + 'text' => $item->article !== null ? 'Lizenzartikel '.$item->article->code : 'Paket '.($item->nestedBundle?->name ?? 'fehlt'), + ])->values()->all(), + 'leer' => ['titel' => 'Noch keine Bestandteile', 'text' => 'Mit „Fassung veröffentlichen“ wählst du Lizenzartikel und andere Pakete.'], + ], + ...($published !== null ? [[ + 'titel' => 'Aufgelöste Lizenzartikel', + 'hilfe' => 'Darauf werden beim Erwerb die Berechtigungen vergeben.', + 'zeilen' => array_map(fn (string $code): array => ['text' => $code], $articles), + ]] : []), + ], + 'seite' => [[ + 'titel' => 'Fassungen', + 'zeilen' => $bundle->versions()->withCount('items')->orderByDesc('number')->get()->map(fn (BundleVersion $version): array => [ + 'text' => 'Fassung '.$version->number, + 'zustand' => StatusValue::of($version->status) === BundleStatus::Veroeffentlicht->value + ? ['label' => 'Veröffentlicht', 'ton' => 'gut'] + : ['label' => 'Entwurf', 'ton' => 'offen'], + 'neben' => $version->items_count === 1 ? '1 Bestandteil' : $version->items_count.' Bestandteile', + ])->all(), + 'leer' => 'Noch keine Fassung.', + 'hilfe' => 'Veröffentlichte Fassungen bleiben unverändert; ein Angebot nennt die Paketfassung, auf die es sich bezieht.', + ]], + ]; + } +} diff --git a/app/Filament/Resources/Combinations/CombinationResource.php b/app/Filament/Resources/Combinations/CombinationResource.php new file mode 100644 index 0000000..3225278 --- /dev/null +++ b/app/Filament/Resources/Combinations/CombinationResource.php @@ -0,0 +1,34 @@ + ListCombinations::route('/'), + 'edit' => EditCombination::route('/{record}'), + ]; + } +} diff --git a/app/Filament/Resources/Combinations/Pages/EditCombination.php b/app/Filament/Resources/Combinations/Pages/EditCombination.php new file mode 100644 index 0000000..f726b6f --- /dev/null +++ b/app/Filament/Resources/Combinations/Pages/EditCombination.php @@ -0,0 +1,11 @@ +columns([ + TextColumn::make('designation') + ->label('Name') + ->formatStateUsing(fn (Composition $record): string => app(EditorialCatalog::class)->compositionTitle($record)) + ->description(fn (Composition $record): ?string => filled($record->display_title) && $record->display_title !== $record->designation ? $record->designation : null) + ->searchable(['designation', 'display_title', 'summary']), + TextColumn::make('stand') + ->label('Stand') + ->state(fn (Composition $record): string => app(EditorialCatalog::class)->stand($record)['text']), + TextColumn::make('versions_count')->counts('versions')->label('Fassungen'), + ]); + } + + public static function getEloquentQuery(): Builder + { + return parent::getEloquentQuery()->where('kind', static::kind())->with('versions'); + } +} diff --git a/app/Filament/Resources/Compositions/Pages/EditComposition.php b/app/Filament/Resources/Compositions/Pages/EditComposition.php new file mode 100644 index 0000000..5fe04cf --- /dev/null +++ b/app/Filament/Resources/Compositions/Pages/EditComposition.php @@ -0,0 +1,2192 @@ + */ + public array $frameFilmChoices = []; + + public string $panel = 'angaben'; + + public bool $textOpen = false; + + public bool $releaseArmed = false; + + public bool $releaseConsent = false; + + public bool $returnAfterRelease = false; + + public string $returnUrl = ''; + + public ?int $templateNumber = null; + + public string $feedback = ''; + + public string $newTextTitle = ''; + + public string $newTextBody = ''; + + public string $partTitle = ''; + + public string $partBody = ''; + + public string $newModuleName = ''; + + public mixed $previewUpload = null; + + public ?string $thumbnailPath = null; + + public string $thumbnailAlt = ''; + + public ?string $thumbnailError = null; + + /** Bereich des Aufbauarbeitsplatzes: aufbau, angaben oder verlauf. */ + public string $aufbauTab = 'aufbau'; + + /** Ansicht der ausgewählten Verwendung: stelle, quelle oder vorschau. */ + public string $detailTab = 'stelle'; + + /** @var list aufgeklappte Bestandteile (Ziel der Verwendung), unabhängig von ihrer Position */ + public array $expanded = []; + + public string $imageMode = 'film'; + + public ?int $frameVersionId = null; + + public string $frameSecond = ''; + + /** @var list> */ + public array $members = []; + + /** @var list */ + public array $dimensionIds = []; + + public function mount(int|string $record): void + { + parent::mount($record); + + $this->loadEditor(); + $this->selectFirstPart(); + $this->returnUrl = $this->safeReturn(request()->query('zurueck')); + $adopt = request()->query('uebernehmen'); + + // Ausdrücklich gewählte Rückkehr „Zurück und einbinden“: frisch geladen, daher keine anderen offenen Eingaben. + if (is_string($adopt) && $this->includePart($adopt, true) && $this->persistDraft()) { + $title = (string) ($this->members[array_key_last($this->members)]['title'] ?? 'Der Bestandteil'); + $this->feedback = $title.' ist in den Aufbau übernommen. Der Entwurf ist gespeichert; es entsteht keine neue Fassung.'; + } + + $flashed = session('redaktion'); + + if (is_string($flashed) && $flashed !== '' && $this->feedback === '') { + $this->feedback = $flashed; + } + } + + public function getTitle(): string|Htmlable + { + $title = trim((string) $this->getRecord()->display_title) !== '' ? (string) $this->getRecord()->display_title : (string) $this->getRecord()->designation; + + return $title !== '' ? $title : $this->hostLabel(); + } + + public function getMaxContentWidth(): Width|string|null + { + return Width::Full; + } + + protected function mutateFormDataBeforeFill(array $data): array + { + return []; + } + + protected function getHeaderActions(): array + { + return []; + } + + public function displayReleaseAction(): Action + { + return Action::make('displayRelease') + ->label('In Mitgliederbibliothek anzeigen') + ->requiresConfirmation() + ->modalHeading('In der Mitgliederbibliothek anzeigen') + ->modalDescription('Sichtbar wird die zuletzt übernommene Fassung. Das ist keine Website-Veröffentlichung und kein aktives Angebot. Eine frühere Fassung bleibt unverändert. Ungespeicherte Änderungen am Aufbau sind nicht Teil dieser Freigabe.') + ->visible(function (): bool { + $version = $this->currentReadyVersion(); + + return $version !== null && ! app(CompositionDisplayRelease::class)->isReleased($version); + }) + ->action(function (): void { + $this->releaseDisplay(); + }); + } + + public function displayRevokeAction(): Action + { + return Action::make('displayRevoke') + ->label('Aus Mitgliederbibliothek ausblenden') + ->color('danger') + ->requiresConfirmation() + ->modalHeading('Aus der Mitgliederbibliothek ausblenden') + ->modalDescription('Die Fassung verschwindet aus der Mitgliederbibliothek. Der fachliche Inhalt bleibt gespeichert. Website und Angebot sind davon unabhängig.') + ->visible(function (): bool { + $version = $this->currentReadyVersion(); + + return $version !== null && app(CompositionDisplayRelease::class)->isReleased($version); + }) + ->action(function (): void { + $version = $this->currentReadyVersion(); + $actor = $this->actor(); + abort_unless($version !== null && $actor instanceof User, 403); + app(CompositionDisplayRelease::class)->revoke($version, $actor); + $this->feedback = 'Die Fassung ist aus der Mitgliederbibliothek ausgeblendet. Der Inhalt bleibt gespeichert.'; + }); + } + + public function isInLibrary(): bool + { + $version = $this->currentReadyVersion(); + + return $version !== null && app(CompositionDisplayRelease::class)->isReleased($version); + } + + public function hostKind(): CompositionKind + { + /** @var Composition $composition */ + $composition = $this->getRecord(); + $kind = $composition->kind; + + return $kind instanceof CompositionKind ? $kind : CompositionKind::from((string) $kind); + } + + public function hostLabel(): string + { + return $this->hostKind()->deskLabel(); + } + + public function isProgram(): bool + { + return $this->hostKind() === CompositionKind::Kurs; + } + + public function selfUrl(): string + { + return $this->safeReturn(static::getResource()::getUrl('edit', ['record' => $this->getRecord()])); + } + + public function previewUrl(): ?string + { + /** @var Composition $composition */ + $composition = $this->getRecord(); + + if (is_array($composition->working_draft) && $composition->working_draft !== []) { + return route('editorial.draft-preview', ['composition' => $composition]); + } + + $version = $this->currentReadyVersion(); + + if ($version === null) { + return null; + } + + return route('editorial.preview', ['composition' => $composition, 'version' => $version]); + } + + public function previewUrlFor(int $versionId): ?string + { + $version = $this->ownedVersion($versionId); + + if ($version === null || $version->status !== ContentVersionStatus::Bereit) { + return null; + } + + return route('editorial.preview', ['composition' => $this->getRecord(), 'version' => $version]); + } + + /** + * @return list> + */ + public function hits(): array + { + if (trim($this->search) === '' && ! $this->listCatalog) { + return []; + } + + return app(EditorialCatalog::class)->search( + $this->search, + $this->catalogScope, + (int) $this->getRecord()->getKey(), + ); + } + + public function openPicker(): void + { + $this->commitRoleDraft(); + $this->textOpen = false; + $this->resetPicker('aufbau'); + $this->pickerKind = 'alle'; + } + + /** + * Schließt die Dialoge des Aufbaus, ohne deren offene Eingaben zu verwerfen. + */ + protected function redaktionWillOpen(): void + { + $this->commitRoleDraft(); + $this->textOpen = false; + $this->releaseArmed = false; + } + + protected function saveRedaktionTexte(): bool + { + $this->guardEditorial(); + + if (trim($this->designation) === '') { + $this->deskFeedback = 'Der Name fehlt. Er bezeichnet den Eintrag in der Verwaltung.'; + $this->redaktionFehlerFeld = 'designation'; + + return false; + } + + return $this->persistRedaktion(); + } + + protected function redaktionSavedMessage(): string + { + $this->feedback = 'Die Redaktion ist gespeichert. Aufbau, Lernziel, Zeit und Fassungen bleiben unverändert.'; + + return $this->feedback; + } + + protected function resetRedaktionTexte(): void + { + $this->fillRedaktion(); + } + + /** + * @return array{art: string, fuer: string, liste: string, zurueck: string, typ: ?string, umfang: string} + */ + public function redaktionKopf(): array + { + $program = $this->isProgram(); + + return [ + 'art' => $this->hostLabel(), + 'fuer' => $program ? 'das Programm' : 'das Modul', + 'liste' => $program ? 'Programme' : 'Module', + 'zurueck' => 'Zurück zum Aufbau', + 'typ' => null, + 'umfang' => '„Redaktion speichern“ sichert Name, Texte, Präsentationsmedien und Einordnung. Aufbau, Lernziel, Zeit und Fassungen bleiben unverändert; offene Änderungen am Aufbau bleiben offen.', + ]; + } + + public function redaktionTitel(): string + { + $title = trim($this->displayTitle) !== '' ? trim($this->displayTitle) : trim($this->designation); + + return $title !== '' ? $title : $this->hostLabel(); + } + + /** + * @return list> + */ + public function redaktionFelder(): array + { + /** @var Composition $record */ + $record = $this->getRecord(); + $stored = fn (string $column): string => (string) ($record->getAttribute($column) ?? ''); + + return [ + ['id' => 'name', 'label' => 'Name in der Verwaltung', 'model' => 'designation', 'kind' => 'text', 'stored' => $stored('designation'), 'required' => true, 'hilfe' => 'Pflichtangabe. Erscheint in Listen der Verwaltung.'], + ['id' => 'titel', 'label' => 'Titel', 'model' => 'displayTitle', 'kind' => 'text', 'stored' => $stored('display_title'), 'hilfe' => 'Erscheint auf Karten und in der Bibliothek. Leer zeigt den Namen.'], + ['id' => 'teaser', 'label' => 'Teaser', 'model' => 'teaser', 'kind' => 'textarea', 'rows' => 2, 'stored' => $stored('teaser')], + ['id' => 'kurz', 'label' => 'Kurzbeschreibung', 'model' => 'summary', 'kind' => 'textarea', 'rows' => 3, 'stored' => $stored('summary')], + ['id' => 'beschreibung', 'label' => 'Ausführliche Beschreibung', 'model' => 'description', 'kind' => 'textarea', 'rows' => 8, 'stored' => $stored('description'), 'hilfe' => 'Beschreibt das Angebot. Kein Lehrtext und kein Lernziel.'], + ['id' => 'suche', 'label' => 'Suchbegriffe', 'model' => 'searchTerms', 'kind' => 'text', 'gruppe' => 'weitere', 'stored' => $stored('search_terms'), 'placeholder' => 'Begriffe, durch Komma getrennt'], + ]; + } + + public function redaktionTexteHinweis(): string + { + return 'Lernziel, Zeit und Material gehören zum fachlichen Stand. Sie stehen im Aufbau unter „Didaktik und Katalogbild“ und entstehen mit der nächsten Fassung.'; + } + + /** + * @return list}> + */ + public function einordnungGruppen(): array + { + return array_map(fn (array $group): array => [ + 'legend' => $group['label'], + 'model' => 'dimensionIds', + 'values' => $group['values'], + ], $this->dimensionGroups()); + } + + /** + * @return array{html: string, stand: string}|null + */ + public function redaktionAusgabe(): ?array + { + $subject = app(PublicCatalogReader::class)->subject($this->getRecord()->getKey(), true); + + if ($subject === null) { + return null; + } + + $card = view('widgets.premium_card', [ + 'subject' => $subject, + 'context' => RenderContext::preview(), + 'cardStyle' => $subject->style ?? 'program', + 'imageUrl' => null, + 'alt' => '', + 'focus' => ['x' => 50, 'y' => 45], + 'format' => 'landscape', + 'fit' => 'cover', + 'headingTag' => 'h3', + 'show' => ['summary' => true, 'kind' => true, 'meta' => true, 'action' => true], + 'actionLabel' => 'Ansehen', + 'note' => null, + 'stacked' => false, + ])->render(); + + return [ + 'html' => view('filament.cms.widget-live-preview', [ + 'html' => $card, + 'stylesheets' => WidgetEditor::previewStylesheets(), + 'width' => 640, + 'bodyClass' => '', + 'caption' => 'Website-Karte bei 640 px, wie im öffentlichen Auftritt.', + ])->render(), + 'stand' => $this->redaktionOffen() + ? 'Gezeigt wird der gespeicherte Stand. Deine ungespeicherten Änderungen erscheinen erst nach „Redaktion speichern“.' + : 'Gezeigt wird der gespeicherte Stand der Redaktion.', + ]; + } + + protected function pickerExceptId(): int + { + return (int) $this->getRecord()->getKey(); + } + + public function einordnungUnsaved(): bool + { + /** @var Composition $record */ + $record = $this->getRecord()->fresh() ?? $this->getRecord(); + $stored = IdentityDimensionValue::query() + ->where('subject_type', $record->getMorphClass()) + ->where('subject_id', $record->getKey()) + ->where('origin', 'direkt') + ->pluck('editorial_dimension_value_id') + ->map(fn ($id): int => (int) $id) + ->all(); + $current = array_map(intval(...), $this->dimensionIds); + sort($stored); + sort($current); + + return $stored !== $current; + } + + public function openText(): void + { + $this->feedback = ''; + $this->pickerOpen = false; + $this->textOpen = true; + } + + public function cancelText(): void + { + $this->textOpen = false; + $this->newTextTitle = ''; + $this->newTextBody = ''; + } + + public function saveDraft(): void + { + $this->commitRoleDraft(); + $minutes = $this->minutes($this->durationMinutes); + + if ($minutes === false) { + $this->feedback = 'Der Zeitbedarf ist eine Zahl von Minuten oder bleibt leer.'; + + return; + } + + /** @var Composition $record */ + $record = $this->getRecord(); + app(EditorialWorkingDraft::class)->write($record, $this->payload()); + $this->feedback = 'Der Entwurf ist gespeichert. Es entsteht keine neue Fassung.'; + } + + public function armRelease(): void + { + $this->commitRoleDraft(); + + if ($this->members === []) { + $this->releaseArmed = false; + $this->feedback = 'Eine Fassung braucht mindestens einen Bestandteil. Anzeige und Entwurf kannst du schon speichern.'; + + return; + } + + if (! $this->needsRevision()) { + $this->releaseArmed = false; + $this->feedback = 'Die freigegebene Fassung ist unverändert. Es entsteht keine neue Fassung.'; + + return; + } + + $this->releaseConsent = false; + $this->releaseArmed = true; + } + + public function cancelRelease(): void + { + $this->releaseArmed = false; + $this->releaseConsent = false; + $this->returnAfterRelease = false; + } + + /** + * @return array + */ + public function releaseReview(): array + { + /** @var Composition $composition */ + $composition = $this->getRecord(); + $review = app(CompositionRelease::class)->review($composition, $this->members); + + foreach ($review['blocked'] as $index => $item) { + $review['blocked'][$index]['edit_url'] = $this->releaseEditUrl($item['edit'] ?? null); + } + + return $review; + } + + public function releaseFollowUp(): string + { + $version = $this->currentReadyVersion(); + + if ($version === null) { + return ''; + } + + /** @var Composition $composition */ + $composition = $this->getRecord(); + $releases = app(CompositionDisplayRelease::class); + $shown = $releases->highestReleasedVersion($composition); + $library = match (true) { + $releases->isReleased($version) => 'In der Mitgliederbibliothek ist Fassung '.$version->number.' sichtbar.', + $shown !== null => 'In der Mitgliederbibliothek ist Fassung '.$shown->number.' sichtbar, die neuere Fassung '.$version->number.' noch nicht. „In Mitgliederbibliothek anzeigen“ zeigt Fassung '.$version->number.'. Das veröffentlicht weder die Website noch ein Angebot.', + default => 'In der Mitgliederbibliothek ist noch keine Fassung sichtbar. „In Mitgliederbibliothek anzeigen“ wählt die letzte freigegebene Fassung. Das veröffentlicht weder die Website noch ein Angebot.', + }; + $draft = is_array($composition->working_draft) && $composition->working_draft !== [] + ? ' Es gibt einen gespeicherten Entwurf neben der freigegebenen Fassung.' + : ' Es gibt keinen offenen Entwurf. Änderungen hältst du mit „Entwurf speichern“ fest.'; + + return $library.$draft; + } + + protected function selectFirstPart(): void + { + if ($this->members !== [] && ($this->selected === null || ! isset($this->members[$this->selected]))) { + $this->selected = 0; + $this->syncRoleDraft(); + } + } + + public function discardDraft(): void + { + /** @var Composition $record */ + $record = $this->getRecord(); + app(EditorialWorkingDraft::class)->clear($record); + $this->releaseArmed = false; + $this->loadAufbau(); + $this->selected = null; + $this->selectFirstPart(); + $this->feedback = 'Der Entwurf ist verworfen. Eine freigegebene Fassung bleibt unverändert. Offene Eingaben der Redaktion bleiben erhalten.'; + } + + public function editorStatus(): string + { + $current = $this->fingerprint($this->payload()); + $stored = $this->storedPayload(); + $ready = $this->fingerprint($this->readyPayload()); + $version = $this->currentReadyVersion(); + $display = $version === null + ? '' + : (app(CompositionDisplayRelease::class)->isReleased($version) + ? ' Sie ist in der Mitgliederbibliothek sichtbar.' + : ' Sie ist nicht in der Mitgliederbibliothek.'); + $unsaved = $stored === null + ? $current !== $ready + : $current !== $this->fingerprint($stored); + + if ($unsaved) { + return 'Es gibt ungespeicherte Änderungen. Speichern hält den Entwurf fest und legt keine Fassung an.'; + } + + if ($stored !== null && $this->fingerprint($stored) !== $ready) { + return $version === null + ? 'Der Entwurf ist gespeichert. Noch keine freigegebene Fassung.' + : 'Der Entwurf ist gespeichert. Fassung '.$version->number.' bleibt unverändert.'.$display; + } + + if ($version === null) { + return 'Noch keine freigegebene Fassung. Speichern hält einen Entwurf fest.'; + } + + return 'Fassung '.$version->number.' ist der letzte freigegebene Stand.'.$display.' Kein offener Entwurf.'; + } + + public function includeNeedsRelease(): bool + { + return $this->needsRevision(); + } + + public function moveTo(int $from, int $to): void + { + $this->commitRoleDraft(); + $count = count($this->members); + + if (! isset($this->members[$from]) || $to < 0 || $to >= $count) { + $this->feedback = 'An dieser Stelle kann der Bestandteil nicht abgelegt werden. Die Reihenfolge gilt nur innerhalb dieses Aufbaus.'; + + return; + } + + if ($from === $to) { + $this->feedback = 'Der Bestandteil bleibt an seiner Stelle.'; + + return; + } + + $selectedTarget = $this->selected !== null ? ($this->members[$this->selected]['target'] ?? null) : null; + $item = $this->members[$from]; + array_splice($this->members, $from, 1); + array_splice($this->members, $to, 0, [$item]); + $this->members = array_values($this->members); + $this->selected = null; + + foreach ($this->members as $index => $member) { + if ($selectedTarget !== null && ($member['target'] ?? null) === $selectedTarget) { + $this->selected = $index; + break; + } + } + + $this->syncRoleDraft(); + $this->feedback = $item['title'].' steht jetzt an Stelle '.($to + 1).'. Gespeichert ist das erst mit „Entwurf speichern“.'; + } + + /** + * @return list + */ + public function versionChoices(): array + { + /** @var Composition $composition */ + $composition = $this->getRecord(); + $release = app(CompositionDisplayRelease::class); + $latest = $this->currentReadyVersion(); + $rows = []; + + foreach ($composition->versions()->orderByDesc('number')->get() as $version) { + if ($version->status !== ContentVersionStatus::Bereit) { + continue; + } + + $released = $release->isReleased($version); + $rows[] = [ + 'id' => $version->id, + 'number' => $version->number, + 'text' => 'Fassung '.$version->number.($released ? ', in der Mitgliederbibliothek' : ', nicht in der Mitgliederbibliothek'), + 'current' => $latest !== null && $latest->id === $version->id, + ]; + } + + return $rows; + } + + /** + * @return list + */ + public function usageLines(): array + { + $version = $this->currentReadyVersion(); + + if ($version === null) { + return []; + } + + return app(EditorialCatalog::class)->usage($version); + } + + /** + * @return list}> + */ + public function dimensionGroups(): array + { + return app(EditorialVocabulary::class)->dimensionGroups($this->getRecord(), IdentityDimensionValue::query() + ->where('subject_type', $this->getRecord()->getMorphClass()) + ->where('subject_id', $this->getRecord()->getKey()) + ->pluck('editorial_dimension_value_id')->map(fn ($id): int => (int) $id)->all()); + } + + /** + * @return list + */ + public function selectedAlternatives(): array + { + $member = $this->selectedMember(); + + if ($member === null) { + return []; + } + + return app(EditorialCatalog::class)->alternatives( + (string) ($member['identity'] ?? ''), + (int) $this->getRecord()->getKey(), + ); + } + + public function childrenOf(string $target): string + { + if (preg_match('/^composition-draft:(\d+)$/', $target, $match) === 1) { + $composition = Composition::query()->find($match[1]); + $draft = $composition instanceof Composition && is_array($composition->working_draft) ? $composition->working_draft : []; + $lines = []; + + foreach ($draft['members'] ?? [] as $member) { + if (! is_array($member)) { + continue; + } + + $row = app(EditorialCatalog::class)->rowForTarget((string) ($member['target'] ?? ''), (int) $this->getRecord()->getKey(), allowSelf: true, allowDraft: true, allowBlocked: true); + $lines[] = trim((string) ($member['role'] ?? '')).': '.($row['title'] ?? 'Bestandteil'); + } + + return implode(' · ', $lines); + } + + if (preg_match('/^composition:(\d+)$/', $target, $match) !== 1) { + return ''; + } + + $version = CompositionVersion::query()->find($match[1]); + + if (! $version instanceof CompositionVersion) { + return ''; + } + + $lines = []; + $this->childLines(app(CompositionStructureReader::class)->tree($version), $lines); + + return implode(' · ', $lines); + } + + /** + * @param list $nodes + * @param list $lines + */ + protected function childLines(array $nodes, array &$lines): void + { + foreach ($nodes as $node) { + $lines[] = $node->role.': '.$node->title; + $this->childLines($node->children, $lines); + } + } + + public function publishHint(): string + { + if ($this->members === []) { + return 'Eine Fassung braucht mindestens einen Bestandteil. Anzeige und Kurzbeschreibung kannst du schon speichern. Ein Film ist dafür nicht nötig.'; + } + + if (! $this->needsRevision()) { + return 'Lernziel, Zeit, Material und Aufbau sind unverändert. Es entsteht keine neue Fassung.'; + } + + return 'Freigeben legt eine neue unveränderliche Fassung an. Speichern schreibt nur den Entwurf und lässt freigegebene Fassungen unverändert.'; + } + + public function selectPart(int $index): void + { + if (! isset($this->members[$index])) { + return; + } + + $this->commitRoleDraft(); + $this->selected = $index; + $this->panel = 'bestandteil'; + $this->aufbauTab = 'aufbau'; + $this->syncRoleDraft(); + } + + /** + * Früherer Einstieg „Bestandteil bearbeiten“: wählt die Verwendung im Detailbereich. + */ + public function openPart(int $index): void + { + $this->selectPart($index); + $this->detailTab = 'stelle'; + } + + public function toggleExpanded(int $index): void + { + $target = (string) ($this->members[$index]['target'] ?? ''); + + if ($target === '') { + return; + } + + $this->expanded = in_array($target, $this->expanded, true) + ? array_values(array_diff($this->expanded, [$target])) + : [...$this->expanded, $target]; + } + + public function showAufbauTab(string $tab): void + { + $this->commitRoleDraft(); + + if (in_array($tab, ['aufbau', 'angaben', 'verlauf'], true)) { + $this->aufbauTab = $tab; + } + } + + public function updatedNoteDraft(): void + { + $this->commitRoleDraft(); + } + + public function updatedMembers(): void + { + $this->syncRoleDraft(); + } + + /** + * Inhalt der referenzierten Komposition zur Ansicht (eine Ebene). + * + * @return list + */ + public function childrenRows(string $target): array + { + $catalog = app(EditorialCatalog::class); + $exceptId = (int) $this->getRecord()->getKey(); + $rows = []; + + if (preg_match('/^composition-draft:(\d+)$/', $target, $match) === 1) { + $composition = Composition::query()->find($match[1]); + $draft = $composition instanceof Composition && is_array($composition->working_draft) ? $composition->working_draft : []; + + foreach ($draft['members'] ?? [] as $member) { + if (! is_array($member)) { + continue; + } + + $row = $catalog->rowForTarget((string) ($member['target'] ?? ''), $exceptId, allowSelf: true, allowDraft: true, allowBlocked: true); + $rows[] = [ + 'title' => (string) ($row['title'] ?? 'Bestandteil'), + 'kind' => (string) ($row['kind'] ?? ''), + 'image' => $row['image'] ?? null, + 'tone' => (string) ($row['tone'] ?? 'text'), + 'role' => trim((string) ($member['role'] ?? '')), + ]; + } + + return $rows; + } + + if (preg_match('/^composition:(\d+)$/', $target, $match) !== 1) { + return []; + } + + $version = CompositionVersion::query()->find($match[1]); + + if (! $version instanceof CompositionVersion) { + return []; + } + + foreach (app(CompositionStructureReader::class)->tree($version) as $node) { + $childTarget = $node->contentElementVersionId !== null + ? 'element:'.$node->contentElementVersionId + : ($node->compositionVersionId !== null ? 'composition:'.$node->compositionVersionId : ''); + $row = $childTarget !== '' ? $catalog->rowForTarget($childTarget, $exceptId, allowSelf: true, allowDraft: true, allowBlocked: true) : null; + $rows[] = [ + 'title' => $node->title, + 'kind' => (string) ($row['kind'] ?? $node->editorialKindLabel ?? $node->technicalKindLabel ?? ''), + 'image' => $row['image'] ?? null, + 'tone' => (string) ($row['tone'] ?? 'text'), + 'role' => $node->role, + ]; + } + + return $rows; + } + + public function addPart(string $target): void + { + $this->includePart($target, true); + } + + private function includePart(string $target, bool $allowDraft): bool + { + if (preg_match('/^(element:\d+|composition:\d+|composition-draft:\d+)$/', $target) !== 1) { + $this->feedback = 'Dieser Bestandteil ist nicht verfügbar.'; + + return false; + } + + foreach ($this->members as $index => $member) { + if (($member['target'] ?? '') === $target) { + $this->selected = $index; + $this->panel = 'bestandteil'; + $this->feedback = 'Diese Fassung ist schon enthalten.'; + + return false; + } + } + + $row = app(EditorialCatalog::class)->rowForTarget($target, (int) $this->getRecord()->getKey(), allowDraft: $allowDraft); + + if ($row === null) { + $this->feedback = 'Diese Fassung ist nicht bereit oder gehört zu diesem Eintrag.'; + + return false; + } + + $row['role'] = app(EditorialCatalog::class)->defaultRole((string) $row['kind']); + $row['note'] = ''; + $this->members[] = $row; + $this->members = array_values($this->members); + $this->selected = array_key_last($this->members); + $this->panel = 'bestandteil'; + $this->syncRoleDraft(); + $this->search = ''; + $this->pickerOpen = false; + $this->pickerSelected = ''; + $this->detailTab = 'stelle'; + $this->feedback = $row['title'].' steht jetzt an Stelle '.count($this->members).' im Aufbau. Es wird nur verwiesen, nichts kopiert. Gespeichert wird mit „Entwurf speichern“.'; + + return true; + } + + public function removePart(int $index): void + { + if (! isset($this->members[$index])) { + return; + } + + $title = (string) ($this->members[$index]['title'] ?? 'Der Bestandteil'); + unset($this->members[$index]); + $this->members = array_values($this->members); + $this->selected = $this->members === [] ? null : min($index, count($this->members) - 1); + $this->syncRoleDraft(); + $this->feedback = '„'.$title.'“ ist aus diesem Aufbau genommen. Das Quellobjekt bleibt im Bestand. Gespeichert ist das erst mit „Entwurf speichern“; eine freigegebene Fassung bleibt unverändert.'; + } + + /** + * @return array{aktion: string, argument: int|string|null, titel: string, text: string, label: string, gefahr: bool}|null + */ + protected function extraConfirmation(string $aktion, int|string|null $argument): ?array + { + if ($aktion !== 'removePart' || ! isset($this->members[(int) $argument])) { + return null; + } + + $title = (string) ($this->members[(int) $argument]['title'] ?? 'Bestandteil'); + + return [ + 'aktion' => $aktion, + 'argument' => (int) $argument, + 'titel' => '„'.$title.'“ aus diesem Aufbau entfernen?', + 'text' => 'Nur diese Verwendung wird entfernt. Das Medium oder Modul bleibt im Bestand und in anderen Aufbauten. Gespeichert wird das mit „Entwurf speichern“.', + 'label' => 'Aus dem Aufbau entfernen', + 'gefahr' => true, + ]; + } + + protected function runExtraConfirmation(string $aktion, int|string|null $argument): void + { + if ($aktion === 'removePart') { + $this->removePart((int) $argument); + } + } + + public function movePart(int $index, int $direction): void + { + $this->commitRoleDraft(); + $target = $index + $direction; + + if (! isset($this->members[$index], $this->members[$target])) { + return; + } + + $current = $this->members[$index]; + $this->members[$index] = $this->members[$target]; + $this->members[$target] = $current; + $this->members = array_values($this->members); + $this->selected = $target; + $this->syncRoleDraft(); + } + + public function useVersion(int $index, string $target): void + { + if (! isset($this->members[$index])) { + return; + } + + $row = app(EditorialCatalog::class)->rowForTarget($target, (int) $this->getRecord()->getKey(), allowSelf: true); + + if ($row === null || ($row['identity'] ?? '') !== ($this->members[$index]['identity'] ?? '')) { + $this->feedback = 'Diese Fassung passt nicht zu dem ausgewählten Bestandteil.'; + + return; + } + + $this->commitRoleDraft(); + $row['role'] = $this->members[$index]['role'] ?? $row['kind']; + $row['note'] = $this->members[$index]['note'] ?? ''; + $this->members[$index] = $row; + $this->syncRoleDraft(); + $this->feedback = $row['version_label'].' ist für diese Stelle ausgewählt. Der Entwurf speichert das. Eine freigegebene Fassung bleibt unverändert.'; + } + + public function loadTemplate(int $versionId): void + { + $version = $this->ownedVersion($versionId); + + if ($version === null || $version->status !== ContentVersionStatus::Bereit) { + $this->feedback = 'Diese Fassung kann nicht als Vorlage geladen werden.'; + + return; + } + + $this->applyVersion($version); + $this->templateNumber = $version->number; + $this->feedback = 'Fassung '.$version->number.' ist als Arbeitsstand geladen. Die geladene Fassung bleibt unverändert.'; + } + + public function addText(): void + { + $title = trim($this->newTextTitle); + $body = trim($this->newTextBody); + + if ($title === '' || $body === '') { + $this->feedback = 'Der Text braucht einen Titel und einen Inhalt.'; + + return; + } + + try { + $service = app(ContentService::class); + $element = $service->createElement('text', 'text', $title); + $version = $service->draftElementVersion($element, $body); + } catch (DomainRuleException $exception) { + $this->feedback = $exception->getMessage(); + + return; + } + + $this->newTextTitle = ''; + $this->newTextBody = ''; + $this->textOpen = false; + + if (! $this->includePart('element:'.$version->id, true)) { + return; + } + + $this->feedback = $title.' ist angelegt und in den Aufbau übernommen. Der Text bleibt bearbeitbar, solange diese Fassung nicht freigegeben und verwendet wird. Es entsteht keine neue Fassung dieses Eintrags.'; + } + + /** + * Schließt erst den Picker und öffnet danach den Dialog, damit beide nicht übereinander liegen. + */ + public function startCreateMedium(): void + { + $this->closePicker(); + $this->js("\$wire.mountAction('createMedium')"); + } + + private function revealMediumForm(): void + { + $this->pickerOpen = false; + $this->textOpen = false; + } + + public function createMediumAction(): Action + { + return Action::make('createMedium') + ->label('Medium anlegen') + ->modalHeading('Medium anlegen') + ->modalDescription('Dieselbe Maske gilt im Medienbestand, im Modul und im Programm. Der Upload zeigt seinen Fortschritt. Beschreibung, Hinweise und Vorschaubild trägst du danach in dieser Maske ein.') + ->modalSubmitActionLabel('Anlegen und übernehmen') + ->modalWidth(Width::Large) + ->beforeFormFilled(fn () => $this->revealMediumForm()) + ->schema(fn (): array => MediumForm::fields(creating: true)) + ->action(function (array $data): void { + try { + $element = MediumForm::create($data, hold: true); + } catch (DomainRuleException $exception) { + Notification::make()->title($exception->getMessage())->danger()->send(); + + throw new Halt; + } + + $version = $element->versions()->orderByDesc('number')->first(); + + if (! $version instanceof ContentElementVersion || ! $this->includePart('element:'.$version->id, true)) { + return; + } + + $this->feedback = $element->working_title.' ist angelegt und in den Aufbau übernommen. Die Datei liegt bei den Medien. Beschreibung und Vorschaubild sind gespeichert.'; + }); + } + + public function startModule(): void + { + $name = trim($this->newModuleName); + + if ($name === '') { + $this->feedback = 'Das neue Modul braucht einen Namen.'; + + return; + } + + $composition = app(EditorialCatalog::class)->create($name, CompositionKind::Uebung); + $this->newModuleName = ''; + $url = EditorialCatalog::editUrl($composition).'?zurueck='.urlencode($this->selfUrl()); + $this->redirect($url, navigate: false); + } + + public function saveDisplay(): void + { + if (! $this->persistRedaktion()) { + return; + } + + $this->feedback = 'Die Anzeige ist gespeichert. Die Fassung bleibt unverändert.'; + } + + /** + * Früherer Dialog „Didaktik und Katalogbild“: öffnet den Bereich „Angaben“. + */ + public function openModule(): void + { + $this->commitRoleDraft(); + $this->aufbauTab = 'angaben'; + $this->frameFilmChoices = $this->frameFilms(); + + if ($this->frameFilmChoices !== [] && $this->frameVersionId === null) { + $this->frameVersionId = $this->frameFilmChoices[0]['version_id']; + } + + if ($this->frameFilmChoices === [] && $this->imageMode === 'film') { + $this->imageMode = 'upload'; + } + } + + public function openCatalogImagePicker(): void + { + $this->guardEditorial(); + $this->resetPicker('vorschaubild'); + $this->pickerKind = 'bild'; + } + + protected function adoptThumbnailFromPicker(string $target): void + { + $elementId = $this->elementIdOf($target); + + if ($elementId !== null) { + $this->adoptPicture($elementId); + } + } + + /** + * Übernimmt Alternativtext und gewähltes Katalogbild (Filmstelle oder Upload) sofort. + * Didaktik und Aufbau speichert „Entwurf speichern“; Texte und Einordnung die Redaktion. + */ + public function saveCatalogImage(): void + { + /** @var Composition $record */ + $record = $this->getRecord(); + app(IdentityProfile::class)->fill($record, ['thumbnail_alt' => trim($this->thumbnailAlt)], $this->actor()); + $record->refresh(); + $image = $this->applyChosenImage(); + + if ($image === false) { + return; + } + + $this->previewUpload = null; + $this->feedback = trim('Das Katalogbild ist übernommen. Es entsteht keine neue Fassung.'.($image === '' ? '' : ' '.$image)); + } + + /** + * Speichert den Wortlaut eines Textbausteins an seiner Quelle. Wird die Fassung schon verwendet, entsteht eine neue + * Fassung; der Aufbau verweist dann im Arbeitsstand darauf und speichert das mit „Entwurf speichern“. + */ + public function saveSourceText(): void + { + $this->commitRoleDraft(); + $note = $this->writePartText(); + + if ($note === false || $note === '') { + if ($note === '') { + $this->feedback = 'Der Text ist unverändert.'; + } + + return; + } + + $this->syncRoleDraft(); + $this->feedback = $note.' Die Zuordnung im Aufbau speichert „Entwurf speichern“.'; + } + + /** + * @return list + */ + public function frameFilms(): array + { + $preview = app(ContentPreviewController::class); + $films = []; + + foreach ($this->members as $member) { + if (preg_match('/^element:(\d+)$/', (string) ($member['target'] ?? ''), $match) !== 1) { + continue; + } + + $version = ContentElementVersion::query()->with('element')->find($match[1]); + + if (! $version instanceof ContentElementVersion || $version->element?->output_class !== 'film') { + continue; + } + + $films[] = [ + 'version_id' => $version->id, + 'title' => (string) ($member['title'] ?? $version->element->working_title), + 'label' => 'Fassung '.$version->number, + 'file_url' => $preview->fileUrl($version), + ]; + } + + return $films; + } + + public function framePreviewUrl(): ?string + { + if ($this->frameVersionId === null || ! is_numeric($this->frameSecond) || trim($this->frameSecond) === '') { + return null; + } + + return route('editorial.frame', [ + 'version' => $this->frameVersionId, + 'sekunde' => $this->frameSecond, + ]); + } + + public function imageCaption(): ?string + { + return $this->imageCaptionText !== '' ? $this->imageCaptionText : null; + } + + protected function captionFor(mixed $source): string + { + if (! is_string($source) || $source === '') { + return ''; + } + + if (preg_match('/^frame:(\d+)@([\d.]+)$/', $source, $match) === 1) { + $title = null; + + foreach ($this->members as $member) { + if (($member['target'] ?? '') === 'element:'.$match[1]) { + $title = $member['title'] ?? null; + break; + } + } + + if ($title === null) { + $version = ContentElementVersion::query()->with('element')->find($match[1]); + $title = $version?->element?->working_title; + } + + return 'Titelbild aus '.($title ?: 'dem Film').' bei '.$match[2].' Sekunden.'; + } + + if ($source === 'eigen') { + return 'Eigenes Titelbild.'; + } + + if (str_starts_with($source, 'element:')) { + return 'Titelbild aus einem vorhandenen Bild.'; + } + + return ''; + } + + protected function rememberCaption(Composition $record): void + { + $this->thumbnailSource = $record->thumbnail_source; + $this->imageCaptionText = $this->captionFor($record->thumbnail_source); + } + + public function savePreview(): void + { + if (! $this->previewUpload instanceof TemporaryUploadedFile) { + $this->feedback = 'Wähle zuerst eine Bilddatei.'; + + return; + } + + $extension = strtolower($this->previewUpload->getClientOriginalExtension()); + + if (! in_array($extension, ['png', 'jpg', 'jpeg', 'webp'], true)) { + $this->feedback = 'Das Vorschaubild muss eine Bilddatei sein.'; + + return; + } + + $path = $this->previewUpload->storeAs( + 'vorschau', + 'karte-'.bin2hex(random_bytes(4)).'.'.$extension, + 'cms_incoming', + ); + $this->previewUpload = null; + + if (! is_string($path)) { + $this->feedback = 'Das Vorschaubild wurde nicht übernommen.'; + + return; + } + + $this->storePreview($path); + } + + public function savePreviewImage(string $storedPath): void + { + $this->storePreview($storedPath); + } + + public function adoptPicture(int $elementId): void + { + $element = ContentElement::query()->find($elementId); + $path = $element?->thumbnail_path; + + if (! $element instanceof ContentElement || ! is_string($path) || ! str_starts_with($path, 'vorschau/') || str_contains($path, '..')) { + $this->feedback = 'Für dieses Medium liegt noch kein Vorschaubild vor.'; + + return; + } + + /** @var Composition $record */ + $record = $this->getRecord(); + $before = $record->versions()->count(); + DeriveThumbnail::dispatch('komposition', $record->id, null, $element->id); + $record->refresh(); + $this->thumbnailPath = $record->thumbnail_path; + $this->thumbnailError = $record->thumbnail_error; + $this->rememberCaption($record); + $this->feedback = $this->previewFeedback($record, $before); + } + + private function writePartText(): string|false + { + $index = $this->selected; + $member = $this->selectedMember(); + + if ($index === null || $member === null || ($member['output'] ?? '') !== 'text') { + return ''; + } + + $title = trim($this->partTitle); + $body = trim($this->partBody); + + if ($title === '' || $body === '') { + $this->feedback = 'Der Text braucht einen Titel und einen Inhalt.'; + + return false; + } + + if (preg_match('/^element:(\d+)$/', (string) ($member['target'] ?? ''), $match) !== 1) { + return ''; + } + + $version = ContentElementVersion::query()->with('element')->find($match[1]); + + if (! $version instanceof ContentElementVersion || $version->element === null) { + $this->feedback = 'Dieser Text ist nicht mehr vorhanden.'; + + return false; + } + + $changed = $title !== (string) ($member['title'] ?? '') || $body !== trim((string) $version->body); + + if (! $changed) { + return ''; + } + + try { + $service = app(ContentService::class); + $service->describe($version->element, $title, $version->element->description); + $updated = $service->reviseElementContent($version, $body); + } catch (DomainRuleException $exception) { + $this->feedback = $exception->getMessage(); + + return false; + } + + if ($updated->id === $version->id) { + $this->members[$index]['title'] = $title; + $this->members[$index]['body'] = $body; + + return 'Der Text ist in derselben Fassung geändert. Eine neue Fassung entsteht, sobald diese Fassung freigegeben und verwendet wird.'; + } + + $row = app(EditorialCatalog::class)->rowForTarget( + 'element:'.$updated->id, + (int) $this->getRecord()->getKey(), + allowSelf: true, + allowDraft: true, + ); + + if ($row === null) { + $this->feedback = 'Die neue Fassung ließ sich nicht in den Aufbau übernehmen.'; + + return false; + } + + $row['role'] = (string) ($this->members[$index]['role'] ?? $row['kind']); + $row['note'] = (string) ($this->members[$index]['note'] ?? ''); + $this->members[$index] = $row; + + return 'Die Änderung liegt in einer neuen Fassung. Die bisherige Fassung bleibt in den freigegebenen Aufbauten.'; + } + + /** + * @param array{type: string, id: int}|null $edit + */ + private function releaseEditUrl(?array $edit): ?string + { + if ($edit === null) { + return null; + } + + if ($edit['type'] === 'element') { + $element = ContentElement::query()->find($edit['id']); + + return $element instanceof ContentElement + ? ContentElementResource::getUrl('view', ['record' => $element]) + : null; + } + + $composition = Composition::query()->find($edit['id']); + + return $composition instanceof Composition ? EditorialCatalog::editUrl($composition) : null; + } + + /** + * @return array{url: ?string, note: ?string, own: bool} + */ + public function coverPicture(): array + { + /** @var Composition $composition */ + $composition = $this->getRecord(); + + return app(EditorialCatalog::class)->cover($composition, $this->members); + } + + /** + * @return list + */ + public function filmChoices(): array + { + $films = app(EditorialCatalog::class)->filmPictures($this->members); + + return count($films) > 1 ? $films : []; + } + + /** + * @return array{id: int, title: string, image: string}|null + */ + public function suggestedFilm(): ?array + { + if (filled($this->thumbnailPath)) { + return null; + } + + $films = app(EditorialCatalog::class)->filmPictures($this->members); + + return count($films) === 1 ? $films[0] : null; + } + + /** + * @return list + */ + public function presentationChips(): array + { + /** @var Composition $composition */ + $composition = $this->getRecord(); + $offered = in_array($composition->id, app(EditorialCatalog::class)->offeredCompositionIds(), true); + + return app(EditorialCatalog::class)->statusChips($composition, $offered); + } + + public function publishRevision(): bool + { + $this->commitRoleDraft(); + + if ($this->members === []) { + $this->feedback = 'Eine Fassung braucht mindestens einen Bestandteil. Anzeige und Kurzbeschreibung kannst du schon speichern.'; + + return false; + } + + if (! $this->needsRevision()) { + /** @var Composition $unchanged */ + $unchanged = $this->getRecord(); + app(EditorialWorkingDraft::class)->clear($unchanged); + $this->releaseArmed = false; + $this->feedback = 'Die freigegebene Fassung ist unverändert. Es entsteht keine neue Fassung.'; + + return false; + } + + $minutes = $this->minutes($this->durationMinutes); + + if ($minutes === false) { + $this->feedback = 'Der Zeitbedarf ist eine Zahl von Minuten oder bleibt leer.'; + + return false; + } + + /** @var Composition $record */ + $record = $this->getRecord(); + $note = trim($this->revisionNote); + + try { + app(CompositionRelease::class)->publish( + $record, + $this->members, + $this->actor(), + $note !== '' ? $note : null, + [ + 'learning_goal' => $this->blank($this->learningGoal), + 'duration_minutes' => $minutes, + 'material_note' => $this->blank($this->materialNote), + ], + $this->releaseConsent, + ); + } catch (DomainRuleException $exception) { + $this->feedback = $exception->getMessage(); + $this->releaseArmed = true; + + return false; + } + + $this->revisionNote = ''; + $this->templateNumber = null; + $this->releaseArmed = false; + $this->releaseConsent = false; + app(EditorialWorkingDraft::class)->clear($record); + $this->loadEditor(); + $released = $this->currentReadyVersion(); + $number = $released instanceof CompositionVersion ? $released->number : ''; + $this->feedback = 'Fassung '.$number.' ist freigegeben. Der Entwurf ist geschlossen und die bisherige Fassung bleibt erhalten. Die Mitgliederbibliothek ändert sich dadurch nicht.'; + + if ($this->returnAfterRelease) { + $this->returnAfterRelease = false; + $this->finishReturn(); + } + + return true; + } + + public function returnAndInclude(): void + { + if ($this->returnUrl === '') { + return; + } + + if ($this->needsRevision()) { + $this->returnAfterRelease = true; + $this->armRelease(); + + return; + } + + $this->finishReturn(); + } + + private function finishReturn(): void + { + $version = $this->currentReadyVersion(); + $url = $this->returnUrl; + + if ($version === null) { + session()->flash('redaktion', 'Es gibt noch keine Fassung, deshalb wurde nichts eingebunden.'); + $this->redirect($url, navigate: false); + + return; + } + + $join = str_contains($url, '?') ? '&' : '?'; + $this->redirect($url.$join.'uebernehmen=composition:'.$version->id, navigate: false); + } + + /** + * @return array|null + */ + public function selectedMember(): ?array + { + if ($this->selected === null) { + return null; + } + + return $this->members[$this->selected] ?? null; + } + + protected function loadEditor(): void + { + $this->fillRedaktion(); + $this->loadAufbau(); + } + + /** + * Liest die Angaben der Redaktion (Name, Texte, Einordnung) aus dem gespeicherten Stand. + */ + protected function fillRedaktion(): void + { + /** @var Composition $composition */ + $composition = $this->getRecord(); + $composition->refresh(); + $this->designation = $composition->designation; + $this->displayTitle = (string) ($composition->display_title ?? ''); + $this->teaser = (string) ($composition->teaser ?? ''); + $this->summary = (string) ($composition->summary ?? ''); + $this->searchTerms = (string) ($composition->search_terms ?? ''); + $this->description = (string) ($composition->description ?? ''); + $this->dimensionIds = IdentityDimensionValue::query() + ->where('subject_type', $composition->getMorphClass()) + ->where('subject_id', $composition->id) + ->where('origin', 'direkt') + ->pluck('editorial_dimension_value_id') + ->map(fn (mixed $id): string => (string) (int) $id) + ->all(); + } + + /** + * Liest Aufbau, Didaktik und Katalogbild aus Entwurf oder letzter freigegebener Fassung. + */ + protected function loadAufbau(): void + { + /** @var Composition $composition */ + $composition = $this->getRecord(); + $composition->refresh(); + $version = $this->currentReadyVersion(); + $this->thumbnailPath = $composition->thumbnail_path; + $this->thumbnailAlt = (string) ($composition->thumbnail_alt ?? ''); + $this->thumbnailError = $composition->thumbnail_error; + $this->thumbnailSource = $composition->thumbnail_source; + $this->imageCaptionText = $this->captionFor($composition->thumbnail_source); + $this->catalogScope = match ($this->hostKind()) { + CompositionKind::Kurs => 'module', + CompositionKind::Uebung => 'medien', + default => 'alles', + }; + + $draft = app(EditorialWorkingDraft::class)->read($composition); + + if ($draft !== null) { + $this->applyDraft($draft); + + return; + } + + if ($version === null) { + $this->members = []; + $this->learningGoal = ''; + $this->durationMinutes = ''; + $this->materialNote = ''; + + return; + } + + $this->applyVersion($version); + } + + /** + * @param array $draft + */ + protected function applyDraft(array $draft): void + { + $catalog = app(EditorialCatalog::class); + $rows = []; + $requested = 0; + + foreach ($draft['members'] ?? [] as $member) { + if (! is_array($member)) { + continue; + } + + $requested++; + $row = $catalog->rowForTarget((string) ($member['target'] ?? ''), (int) $this->getRecord()->getKey(), allowSelf: true, allowDraft: true, allowBlocked: true); + + if ($row === null) { + continue; + } + + $row['role'] = (string) ($member['role'] ?? $row['kind']); + $row['note'] = trim((string) ($member['note'] ?? '')); + $rows[] = $row; + } + + $this->members = $rows; + $this->learningGoal = (string) ($draft['learning_goal'] ?? ''); + $this->durationMinutes = ($draft['duration_minutes'] ?? null) === null ? '' : (string) $draft['duration_minutes']; + $this->materialNote = (string) ($draft['material_note'] ?? ''); + $this->revisionNote = (string) ($draft['revision_note'] ?? ''); + $this->selected = null; + $this->roleDraft = ''; + $this->noteDraft = ''; + $this->panel = 'angaben'; + + if ($requested > count($rows) && $this->feedback === '') { + $this->feedback = 'Ein Bestandteil des Entwurfs ist nicht mehr bereit und wurde nicht geladen.'; + } + } + + protected function applyVersion(CompositionVersion $version): void + { + $this->members = app(EditorialCatalog::class)->rows($version, (int) $this->getRecord()->getKey()); + $this->learningGoal = (string) ($version->learning_goal ?? ''); + $this->durationMinutes = $version->duration_minutes === null ? '' : (string) $version->duration_minutes; + $this->materialNote = (string) ($version->material_note ?? ''); + $this->selected = null; + $this->roleDraft = ''; + $this->noteDraft = ''; + $this->panel = 'angaben'; + } + + public function updatedRoleDraft(string $value): void + { + $this->commitRoleDraft($value); + } + + protected function commitRoleDraft(?string $value = null): void + { + if ($this->selected === null || ! isset($this->members[$this->selected])) { + return; + } + + $this->members[$this->selected]['role'] = trim($value ?? $this->roleDraft); + $this->members[$this->selected]['note'] = trim($this->noteDraft); + } + + protected function syncRoleDraft(): void + { + $member = $this->selected !== null ? ($this->members[$this->selected] ?? null) : null; + $this->roleDraft = is_array($member) ? (string) ($member['role'] ?? '') : ''; + $this->noteDraft = is_array($member) ? (string) ($member['note'] ?? '') : ''; + $this->partTitle = is_array($member) ? (string) ($member['title'] ?? '') : ''; + $this->partBody = is_array($member) ? (string) ($member['body'] ?? '') : ''; + } + + public function releaseDisplay(): void + { + $this->releaseCurrent(); + } + + protected function releaseCurrent(): void + { + $version = $this->currentReadyVersion(); + $actor = $this->actor(); + abort_unless($version !== null && $actor instanceof User, 403); + + if ($this->needsRevision()) { + $this->feedback = 'Übernimm zuerst die Änderungen. Freigegeben wird nur eine bereits übernommene Fassung.'; + + return; + } + + app(CompositionDisplayRelease::class)->release($version, $actor); + $this->feedback = 'Fassung '.$version->number.' ist in der Mitgliederbibliothek sichtbar. Frühere Fassungen bleiben erhalten.'; + } + + protected function currentReadyVersion(): ?CompositionVersion + { + /** @var Composition $composition */ + $composition = $this->getRecord(); + + return $composition->versions() + ->where('status', ContentVersionStatus::Bereit) + ->orderByDesc('number') + ->first(); + } + + protected function ownedVersion(int $versionId): ?CompositionVersion + { + /** @var Composition $composition */ + $composition = $this->getRecord(); + + return $composition->versions()->whereKey($versionId)->first(); + } + + protected function needsRevision(): bool + { + $current = $this->currentReadyVersion(); + + if ($current === null) { + return $this->members !== []; + } + + return ! $this->sameMembers($current) || $this->didacticChanged($current); + } + + protected function sameMembers(CompositionVersion $version): bool + { + $version->loadMissing('members'); + $current = $version->members->map(function ($member): string { + $target = $member->content_element_version_id + ? 'element:'.$member->content_element_version_id + : 'composition:'.$member->nested_composition_version_id; + + return $member->role.'|'.$target.'|'.trim((string) ($member->placement_note ?? '')); + })->all(); + $next = array_values(array_map( + fn (array $member): string => trim((string) ($member['role'] ?? '')).'|'.($member['target'] ?? '').'|'.trim((string) ($member['note'] ?? '')), + $this->members, + )); + + return $current === $next; + } + + protected function didacticChanged(CompositionVersion $version): bool + { + $minutes = $this->minutes($this->durationMinutes); + + if ($minutes === false) { + return true; + } + + $storedMinutes = $version->duration_minutes === null ? null : (int) $version->duration_minutes; + + return $version->learning_goal !== $this->blank($this->learningGoal) + || $version->material_note !== $this->blank($this->materialNote) + || $storedMinutes !== $minutes; + } + + protected function minutes(string $value): int|false|null + { + $value = trim($value); + + if ($value === '') { + return null; + } + + if (preg_match('/^\d+$/', $value) !== 1) { + return false; + } + + $minutes = (int) $value; + + return $minutes > 0 ? $minutes : false; + } + + protected function blank(string $value): ?string + { + $value = trim($value); + + return $value === '' ? null : $value; + } + + /** + * @param list $ids + */ + protected function syncDimensions(Composition $composition, array $ids): void + { + app(IdentityDimension::class)->replaceOffered($composition, $ids); + } + + /** + * Schreibt Name, Texte und Einordnung. Aufbau, Didaktik, Katalogbild und Fassungen bleiben unberührt. + */ + protected function persistRedaktion(): bool + { + /** @var Composition $record */ + $record = $this->getRecord(); + $name = trim($this->designation); + + if ($name === '') { + $this->feedback = 'Der Name fehlt.'; + + return false; + } + + $record->designation = $name; + app(IdentityProfile::class)->fill($record, [ + 'display_title' => $this->displayTitle, + 'teaser' => $this->teaser, + 'summary' => $this->summary, + 'search_terms' => $this->searchTerms, + 'description' => $this->description, + ], $this->actor()); + $this->syncDimensions($record, array_map(intval(...), $this->dimensionIds)); + $record->refresh(); + $this->getRecord()->setRawAttributes($record->getAttributes()); + + return true; + } + + protected function persistDraft(): bool + { + if ($this->minutes($this->durationMinutes) === false) { + $this->feedback = 'Der Zeitbedarf ist eine Zahl von Minuten oder bleibt leer.'; + + return false; + } + + /** @var Composition $record */ + $record = $this->getRecord(); + app(EditorialWorkingDraft::class)->write($record, $this->payload()); + + return true; + } + + protected function applyChosenImage(): string|false + { + if ($this->imageMode === 'upload' && $this->previewUpload instanceof TemporaryUploadedFile) { + $extension = strtolower($this->previewUpload->getClientOriginalExtension()); + + if (! in_array($extension, ['png', 'jpg', 'jpeg', 'webp'], true)) { + $this->feedback = 'Das Vorschaubild muss eine Bilddatei sein.'; + + return false; + } + + $path = $this->previewUpload->storeAs( + 'vorschau', + 'karte-'.bin2hex(random_bytes(4)).'.'.$extension, + 'cms_incoming', + ); + $this->previewUpload = null; + + if (! is_string($path)) { + $this->feedback = 'Das Vorschaubild wurde nicht übernommen.'; + + return false; + } + + $this->storePreview($path); + + return str_contains($this->feedback, 'unverändert') ? $this->feedback : false; + } + + if ($this->imageMode === 'film' && $this->frameVersionId !== null && trim($this->frameSecond) !== '') { + if (! is_numeric($this->frameSecond) || (float) $this->frameSecond < 0 || (float) $this->frameSecond > 7200) { + $this->feedback = 'Die Zeitposition muss eine Zahl in Sekunden sein.'; + + return false; + } + + $version = ContentElementVersion::query()->with('element')->find($this->frameVersionId); + $target = 'element:'.(int) $this->frameVersionId; + $known = array_map(fn (array $member): string => (string) ($member['target'] ?? ''), $this->members); + + if (! $version instanceof ContentElementVersion || $version->element?->output_class !== 'film' || ! in_array($target, $known, true)) { + $this->feedback = 'Die Filmfassung gehört nicht zu diesem Aufbau.'; + + return false; + } + + /** @var Composition $record */ + $record = $this->getRecord(); + $before = $record->versions()->count(); + DeriveCompositionFrame::dispatch($record->id, $version->id, (float) $this->frameSecond); + $record->refresh(); + $this->thumbnailPath = $record->thumbnail_path; + $this->thumbnailError = $record->thumbnail_error; + $this->rememberCaption($record); + $note = $this->previewFeedback($record, $before); + + if (! str_contains($note, 'unverändert')) { + $this->feedback = $note; + + return false; + } + + return $note; + } + + return ''; + } + + protected function storePreview(string $path): void + { + if (! str_starts_with($path, 'vorschau/') || str_contains($path, '..')) { + $this->feedback = 'Das Vorschaubild wurde nicht übernommen.'; + + return; + } + + /** @var Composition $record */ + $record = $this->getRecord(); + $before = $record->versions()->count(); + DeriveThumbnail::dispatch('komposition', $record->id, $path); + $record->refresh(); + $this->thumbnailPath = $record->thumbnail_path; + $this->thumbnailError = $record->thumbnail_error; + $this->rememberCaption($record); + $this->feedback = $this->previewFeedback($record, $before); + } + + protected function previewFeedback(Composition $record, int $versionsBefore): string + { + if ($record->versions()->count() !== $versionsBefore) { + return 'Das Vorschaubild wurde nicht übernommen.'; + } + + if (filled($record->thumbnail_path) && $record->thumbnail_error === null) { + return 'Das Vorschaubild ist gespeichert. Die Fassung bleibt unverändert.'; + } + + if (config('queue.default') !== 'sync') { + return 'Das Titelbild wird vorbereitet. Die Fassung bleibt unverändert.'; + } + + return $record->thumbnail_error ?: 'Das Vorschaubild wurde nicht übernommen.'; + } + + protected function statusSentence(): string + { + return $this->editorStatus(); + } + + /** + * @return array{learning_goal: ?string, duration_minutes: int|string|null, material_note: ?string, revision_note: ?string, members: list} + */ + protected function payload(): array + { + // Rolle und Hinweis stehen bereits in $members (commitRoleDraft bei jeder Änderung und vor jedem Speichern). + $members = $this->members; + + $minutes = $this->minutes($this->durationMinutes); + + return [ + 'learning_goal' => $this->blank($this->learningGoal), + 'duration_minutes' => $minutes === false ? $this->durationMinutes : $minutes, + 'material_note' => $this->blank($this->materialNote), + 'revision_note' => $this->blank($this->revisionNote), + 'members' => array_values(array_map( + fn (array $member): array => [ + 'role' => trim((string) ($member['role'] ?? '')), + 'target' => (string) ($member['target'] ?? ''), + 'note' => trim((string) ($member['note'] ?? '')), + ], + $members, + )), + ]; + } + + /** + * @return array{learning_goal: ?string, duration_minutes: int|null, material_note: ?string, revision_note: ?string, members: list}|null + */ + protected function storedPayload(): ?array + { + /** @var Composition $composition */ + $composition = $this->getRecord(); + $draft = $composition->working_draft; + + if (! is_array($draft) || $draft === []) { + return null; + } + + return $this->normalizePayload($draft); + } + + /** + * @return array{learning_goal: ?string, duration_minutes: int|null, material_note: ?string, revision_note: ?string, members: list} + */ + protected function readyPayload(): array + { + $version = $this->currentReadyVersion(); + + if ($version === null) { + return [ + 'learning_goal' => null, + 'duration_minutes' => null, + 'material_note' => null, + 'revision_note' => null, + 'members' => [], + ]; + } + + $rows = app(EditorialCatalog::class)->rows($version, (int) $this->getRecord()->getKey()); + + return [ + 'learning_goal' => $version->learning_goal, + 'duration_minutes' => $version->duration_minutes === null ? null : (int) $version->duration_minutes, + 'material_note' => $version->material_note, + 'revision_note' => null, + 'members' => array_values(array_map( + fn (array $row): array => [ + 'role' => trim((string) ($row['role'] ?? '')), + 'target' => (string) ($row['target'] ?? ''), + 'note' => trim((string) ($row['note'] ?? '')), + ], + $rows, + )), + ]; + } + + /** + * @param array $payload + * @return array{learning_goal: ?string, duration_minutes: int|string|null, material_note: ?string, revision_note: ?string, members: list} + */ + protected function normalizePayload(array $payload): array + { + $members = []; + + foreach ($payload['members'] ?? [] as $member) { + if (! is_array($member)) { + continue; + } + + $members[] = [ + 'role' => trim((string) ($member['role'] ?? '')), + 'target' => (string) ($member['target'] ?? ''), + 'note' => trim((string) ($member['note'] ?? '')), + ]; + } + + return [ + 'learning_goal' => $payload['learning_goal'] ?? null, + 'duration_minutes' => $payload['duration_minutes'] ?? null, + 'material_note' => $payload['material_note'] ?? null, + 'revision_note' => $payload['revision_note'] ?? null, + 'members' => $members, + ]; + } + + /** + * @param array $payload + */ + protected function fingerprint(array $payload): string + { + return json_encode($this->normalizePayload($payload), JSON_THROW_ON_ERROR | JSON_UNESCAPED_UNICODE); + } + + protected function actor(): ?User + { + $actor = Filament::auth()->user(); + + return $actor instanceof User ? $actor : null; + } + + protected function safeReturn(mixed $url): string + { + if (! is_string($url) || $url === '') { + return ''; + } + + $parts = parse_url($url); + $path = is_array($parts) ? ($parts['path'] ?? '') : ''; + + if (! is_string($path) || ! str_starts_with($path, '/verwaltung/') || str_contains($path, '..')) { + return ''; + } + + $query = is_array($parts) ? ($parts['query'] ?? '') : ''; + + return $path.(is_string($query) && $query !== '' ? '?'.$query : ''); + } + + /** + * @param array $data + */ + protected function handleRecordUpdate(Model $record, array $data): Model + { + return $record; + } +} diff --git a/app/Filament/Resources/Compositions/Pages/ListCompositionKind.php b/app/Filament/Resources/Compositions/Pages/ListCompositionKind.php new file mode 100644 index 0000000..6bb179e --- /dev/null +++ b/app/Filament/Resources/Compositions/Pages/ListCompositionKind.php @@ -0,0 +1,83 @@ +kind(); + } + + private function onDesk(): bool + { + return in_array($this->kind(), [CompositionKind::Kurs, CompositionKind::Uebung], true); + } + + public function getSubheading(): string|Htmlable|null + { + $desk = $this->onDesk() ? ' Programme und Module stehen gemeinsam auch auf dem Arbeitsplatz.' : ''; + + return $this->kind()->deskExplanation().$desk; + } + + public function getMaxContentWidth(): Width|string|null + { + return Width::Full; + } + + public function content(Schema $schema): Schema + { + return $schema->components([View::make('filament.verwaltung.bestand')]); + } + + protected function getHeaderActions(): array + { + if ($this->onDesk()) { + return [$this->createCompositionAction($this->kind())]; + } + + return [ + Action::make('create') + ->label($this->kind()->createLabel()) + ->modalHeading('Neue '.lcfirst($this->kind()->label())) + ->modalSubmitActionLabel($this->kind()->createLabel()) + ->visible(fn (): bool => ContentElementResource::editor()) + ->schema([ + TextInput::make('designation')->label('Bezeichnung')->required(), + ]) + ->action(function (array $data): void { + $composition = null; + $this->report(function () use ($data, &$composition): void { + $composition = app(ContentService::class)->createComposition($data['designation'], $this->kind()); + }, $this->kind()->label().' ist angelegt.'); + + if ($composition !== null) { + $this->redirect(static::getResource()::getUrl('edit', ['record' => $composition])); + } + }), + ]; + } +} diff --git a/app/Filament/Resources/ContentElements/ContentElementResource.php b/app/Filament/Resources/ContentElements/ContentElementResource.php new file mode 100644 index 0000000..6789020 --- /dev/null +++ b/app/Filament/Resources/ContentElements/ContentElementResource.php @@ -0,0 +1,111 @@ +user(); + + return $user instanceof User && ( + $user->hasStaffRole(StaffRole::Redakteur) || $user->hasStaffRole(StaffRole::Katalogverwalter) + ); + } + + public static function editor(): bool + { + $user = Filament::auth()->user(); + + return $user instanceof User && $user->hasStaffRole(StaffRole::Redakteur); + } + + public static function getViewAuthorizationResponse(Model $record): Response + { + return self::canViewAny() ? Response::allow() : Response::deny(); + } + + public static function getEditAuthorizationResponse(Model $record): Response + { + return self::editor() ? Response::allow() : Response::deny(); + } + + public static function form(Schema $schema): Schema + { + return $schema; + } + + public static function table(Table $table): Table + { + return $table->recordUrl( + fn (ContentElement $record): string => static::getUrl('view', ['record' => $record]) + )->columns([ + TextColumn::make('working_title')->label('Arbeitstitel')->searchable(), + TextColumn::make('summary')->label('Kurzbeschreibung')->limit(80), + TextColumn::make('usage_note')->label('Einsatzhinweis')->limit(80), + TextColumn::make('license_note')->label('Lizenzvermerk')->limit(40), + TextColumn::make('kind')->label('Art'), + TextColumn::make('pillar_names')->label('Säulen')->state( + fn (ContentElement $record): string => $record->pillars->pluck('name')->join(', ') ?: '—' + ), + TextColumn::make('stand')->label('Aktuelle Fassung')->state(function (ContentElement $record): string { + $version = $record->versions->sortByDesc('number')->first(); + + if ($version === null) { + return 'noch keine Fassung'; + } + + $file = is_array($version->metadata) ? ($version->metadata['file'] ?? null) : null; + $label = $version->status === ContentVersionStatus::Entwurf + ? 'Entwurf' + : 'Fassung '.$version->number; + + return $label.(is_string($file) && $file !== '' ? ' · mit Datei' : ' · ohne Datei'); + }), + ]); + } + + public static function getEloquentQuery(): Builder + { + return parent::getEloquentQuery()->with(['versions', 'pillars']); + } + + public static function getPages(): array + { + return [ + 'index' => ListContentElements::route('/'), + 'view' => ViewContentElement::route('/{record}'), + 'edit' => EditContentElement::route('/{record}/bearbeiten'), + ]; + } +} diff --git a/app/Filament/Resources/ContentElements/Pages/EditContentElement.php b/app/Filament/Resources/ContentElements/Pages/EditContentElement.php new file mode 100644 index 0000000..d062061 --- /dev/null +++ b/app/Filament/Resources/ContentElements/Pages/EditContentElement.php @@ -0,0 +1,259 @@ +redirect(ContentElementResource::getUrl('view', ['record' => $this->getRecord(), 'redaktion' => 1])); + } + + public function getSubheading(): string|Htmlable|null + { + return 'Titel, Beschreibung, Hinweise und Vorschaubild gehören zum Medium. Ein Text bleibt dieselbe Fassung, solange er nicht freigegeben und verwendet wird.'; + } + + public function form(Schema $schema): Schema + { + /** @var ContentElement $element */ + $element = $this->getRecord(); + + return $schema->columns(1)->components([ + Placeholder::make('open')->label('Medium')->content(function (): HtmlString { + $url = ContentElementResource::getUrl('view', ['record' => $this->getRecord()]); + + return new HtmlString('Medium und Fassungen ansehen'); + }), + ...MediumForm::fields(creating: false, element: $element), + TextInput::make('display_title')->label('Anzeigetitel') + ->helperText('Erscheint in der Bibliothek. Leer lässt den Arbeitstitel stehen. Speichern legt keine Fassung an.'), + Textarea::make('summary')->label('Kurzbeschreibung')->rows(3), + Select::make('editorial_content_kind_id') + ->label('Fachliche Materialart') + ->options(fn (): array => app(EditorialVocabulary::class)->kindOptions('medium', $this->getRecord()->editorial_content_kind_id !== null ? (int) $this->getRecord()->editorial_content_kind_id : null)) + ->nullable() + ->helperText('Optional für Bibliothek und Website. Ändert weder die Ausgabeart noch eine Fassung.'), + Placeholder::make('usage')->label('Verwendung')->content(function (): HtmlString { + /** @var ContentElement $element */ + $element = $this->getRecord(); + $versionIds = $element->versions()->pluck('id'); + $compositionIds = []; + + foreach ($element->versions as $version) { + $compositionIds = [...$compositionIds, ...app(ContentService::class)->containingCompositionIds($version)]; + } + + $names = Composition::query()->whereIn('id', array_unique($compositionIds))->orderBy('designation')->pluck('designation')->all(); + $articles = ReleaseContent::query() + ->whereIn('content_element_version_id', $versionIds) + ->with('release.article') + ->get() + ->map(fn (ReleaseContent $content): string => 'Lizenzartikel '.($content->release->article->code ?? '')) + ->unique() + ->all(); + $lines = [...array_map(fn (string $name): string => 'Enthalten in '.$name, $names), ...$articles]; + + return new HtmlString($lines === [] ? 'Noch in keinem Modul, Programm oder Lizenzartikel.' : implode('
', array_map(e(...), $lines))); + }), + CheckboxList::make('dimension_ids')->label('Fachliche Einordnung') + ->options(function (): array { + $options = []; + foreach (app(EditorialVocabulary::class)->dimensionGroups($this->getRecord(), IdentityDimensionValue::query() + ->where('subject_type', $this->getRecord()->getMorphClass()) + ->where('subject_id', $this->getRecord()->getKey()) + ->pluck('editorial_dimension_value_id')->map(fn ($id): int => (int) $id)->all()) as $dimension) { + foreach ($dimension['values'] as $value) { + $options[$value['id']] = $dimension['label'].': '.$value['label']; + } + } + + return $options; + }) + ->helperText('Wirkt auf die Suche und legt keine neue Fassung an.'), + Placeholder::make('thumbnail_current')->label('Aktuelles Vorschaubild')->content(function (): HtmlString { + /** @var ContentElement $element */ + $element = $this->getRecord(); + $url = ThumbnailRef::url('editorial.card', 'element', $element->id, $element->thumbnail_path); + $caption = match ($element->thumbnail_source) { + 'eigen' => 'Eigenes Vorschaubild.', + 'datei' => 'Vorschaubild aus der Datei des Mediums.', + default => '', + }; + if (is_string($element->thumbnail_source) && preg_match('/^frame:\d+@([\d.]+)$/', $element->thumbnail_source, $match) === 1) { + $caption = 'Vorschaubild aus dem Film bei '.$match[1].' Sekunden.'; + } + if ($url === null) { + return new HtmlString('Noch kein Vorschaubild. Eine Filmstelle wählst du beim Ansehen des Mediums.'); + } + + return new HtmlString(''.($caption !== '' ? '

'.e($caption).'

' : '')); + }), + CheckboxList::make('pillars') + ->label('Fachliche Säulen') + ->options(fn (): array => Pillar::query()->orderBy('name')->pluck('name', 'id')->all()) + ->helperText('Ein Medium kann mehreren Säulen zugeordnet sein. Weitere Säulen legst du unter Fachliche Säulen an.') + ->columns(1), + ]); + } + + public static function uploadField(): FileUpload + { + return MediumForm::fileField(); + } + + protected function getHeaderActions(): array + { + return [ + Action::make('view') + ->label('Ansehen') + ->url(fn (): string => ContentElementResource::getUrl('view', ['record' => $this->getRecord()])), + Action::make('revise') + ->label('Neue Fassung anlegen') + ->schema(fn (): array => ElementRevision::fields($this->getRecord())) + ->action(function (array $data): void { + $this->report(function () use ($data): string { + /** @var ContentElement $element */ + $element = $this->getRecord(); + + return ElementRevision::publish($element, $data); + }, 'Die neue Fassung ist angelegt.'); + $this->getRecord()->unsetRelation('versions'); + }), + Action::make('delete') + ->label('Löschen') + ->color('danger') + ->requiresConfirmation() + ->visible(fn (): bool => $this->getRecord()->versions()->doesntExist()) + ->action(function (): void { + $this->getRecord()->delete(); + $this->redirect(ContentElementResource::getUrl('index')); + }), + ]; + } + + protected function getSaveFormAction(): Action + { + return parent::getSaveFormAction()->label('Speichern'); + } + + protected function getSavedNotificationTitle(): ?string + { + return 'Gespeichert. Es gibt keine neue Fassung.'; + } + + /** + * @param array $data + * @return array + */ + protected function mutateFormDataBeforeFill(array $data): array + { + return [ + 'working_title' => $this->getRecord()->working_title, + 'thumbnail_alt' => $this->getRecord()->thumbnail_alt, + 'body' => $this->getRecord()->versions()->orderByDesc('number')->first()?->body, + 'display_title' => $this->getRecord()->display_title, + 'description' => $this->getRecord()->description, + 'usage_note' => $this->getRecord()->usage_note, + 'license_note' => $this->getRecord()->license_note, + 'summary' => $this->getRecord()->summary, + 'editorial_content_kind_id' => $this->getRecord()->editorial_content_kind_id, + 'dimension_ids' => IdentityDimensionValue::query() + ->where('subject_type', $this->getRecord()->getMorphClass()) + ->where('subject_id', $this->getRecord()->id) + ->where('origin', 'direkt') + ->pluck('editorial_dimension_value_id') + ->all(), + 'pillars' => $this->getRecord()->pillars()->pluck('pillars.id')->all(), + ]; + } + + /** + * @param array $data + */ + protected function handleRecordUpdate(Model $record, array $data): Model + { + /** @var ContentElement $record */ + try { + app(ContentService::class)->describe($record, (string) $data['working_title'], $data['description'] ?? null); + app(IdentityProfile::class)->fill($record, [ + 'display_title' => $data['display_title'] ?? null, + 'summary' => $data['summary'] ?? null, + 'usage_note' => $data['usage_note'] ?? null, + 'license_note' => $data['license_note'] ?? null, + 'thumbnail_alt' => $data['thumbnail_alt'] ?? null, + ], auth()->user()); + if ($record->output_class === 'text' && is_string($data['body'] ?? null)) { + $latest = $record->versions()->orderByDesc('number')->first(); + + if ($latest instanceof ContentElementVersion) { + app(ContentService::class)->reviseElementContent($latest, $data['body']); + } + } + if (array_key_exists('editorial_content_kind_id', $data)) { + $record->editorial_content_kind_id = filled($data['editorial_content_kind_id'] ?? null) + ? (int) $data['editorial_content_kind_id'] + : null; + $record->save(); + } + if (is_string($data['thumbnail_upload'] ?? null) && $data['thumbnail_upload'] !== '') { + $record->thumbnail_error = null; + $record->save(); + DeriveThumbnail::dispatch('element', $record->id, $data['thumbnail_upload']); + } + if (array_key_exists('dimension_ids', $data)) { + app(IdentityDimension::class)->replaceOffered($record, array_map(intval(...), $data['dimension_ids'] ?? [])); + } + app(PillarService::class)->assign($record, array_map(intval(...), $data['pillars'] ?? [])); + } catch (DomainRuleException $exception) { + Notification::make()->title($exception->getMessage())->danger()->send(); + + throw new Halt; + } + + return $record; + } +} diff --git a/app/Filament/Resources/ContentElements/Pages/ListContentElements.php b/app/Filament/Resources/ContentElements/Pages/ListContentElements.php new file mode 100644 index 0000000..4cbde8c --- /dev/null +++ b/app/Filament/Resources/ContentElements/Pages/ListContentElements.php @@ -0,0 +1,301 @@ +components([ + RenderHook::make(PanelsRenderHook::RESOURCE_PAGES_LIST_RECORDS_TABLE_BEFORE), + View::make('filament.verwaltung.bestand'), + RenderHook::make(PanelsRenderHook::RESOURCE_PAGES_LIST_RECORDS_TABLE_AFTER), + ]); + } + + protected function bestandFilterEigenschaften(): array + { + return ['suche', 'art', 'freigabe', 'entwurf', 'fassung', 'nutzung', 'saeule', 'inhaltsart', 'einordnung', 'verarbeitung', 'archiv']; + } + + public function showingList(): bool + { + return $this->ansicht === 'liste'; + } + + /** + * @return list> + */ + public function cards(): array + { + return app(MediaLibrary::class)->cards($this->libraryFilters(), ContentElementResource::editor()); + } + + /** + * @return list + */ + public function typeOptions(): array + { + return app(MediaLibrary::class)->types(); + } + + /** + * @return list + */ + public function pillarOptions(): array + { + return app(MediaLibrary::class)->pillars(); + } + + /** + * @return list + */ + public function classificationOptions(): array + { + return app(MediaLibrary::class)->classifications(ctype_digit($this->einordnung) ? [(int) $this->einordnung] : []); + } + + /** + * @return array + */ + public function contentKindOptions(): array + { + return app(EditorialVocabulary::class)->kindFilterOptions('medium', $this->inhaltsart); + } + + public function filtersActive(): bool + { + return trim($this->suche) !== '' + || $this->art !== '' + || $this->freigabe !== '' + || $this->entwurf !== '' + || $this->fassung !== '' + || $this->nutzung !== '' + || $this->saeule !== '' + || $this->einordnung !== '' + || $this->inhaltsart !== '' + || $this->verarbeitung !== '' + || $this->archiv !== 'aktiv'; + } + + public function resetFilters(): void + { + $this->suche = ''; + $this->art = ''; + $this->freigabe = ''; + $this->entwurf = ''; + $this->fassung = ''; + $this->nutzung = ''; + $this->saeule = ''; + $this->einordnung = ''; + $this->inhaltsart = ''; + $this->verarbeitung = ''; + $this->archiv = 'aktiv'; + $this->bestandGrenze = Bestand::SCHRITT; + } + + /** + * Gemeinsame Bestandsliste: Suche und häufige Filter sichtbar, die übrigen unter „Weitere Filter“. + * + * @return array + */ + public function bestand(): array + { + $optionen = fn (array $liste, string $wert, string $label): array => collect($liste) + ->mapWithKeys(fn (array $eintrag): array => [(string) $eintrag[$wert] => $eintrag[$label]]) + ->all(); + $weitere = [ + ['eigenschaft' => 'inhaltsart', 'label' => 'Fachliche Materialart', 'vorgabe' => '', 'alle' => 'Alle Materialarten', 'optionen' => $this->contentKindOptions()], + ['eigenschaft' => 'entwurf', 'label' => 'Entwurf', 'vorgabe' => '', 'alle' => 'Entwurf egal', 'optionen' => ['offen' => 'Offener Entwurf', 'keiner' => 'Kein offener Entwurf']], + ['eigenschaft' => 'fassung', 'label' => 'Deaktivierte Fassungen', 'vorgabe' => '', 'alle' => 'Regulärer Bestand', 'optionen' => ['mit' => 'Mit deaktivierter Fassung', 'nur' => 'Nur deaktivierte Fassungen']], + ]; + + if (($pillars = $this->pillarOptions()) !== []) { + $weitere[] = ['eigenschaft' => 'saeule', 'label' => 'Fachliche Säule', 'vorgabe' => '', 'alle' => 'Alle Säulen', 'optionen' => $optionen($pillars, 'id', 'name')]; + } + + if (($classes = $this->classificationOptions()) !== []) { + $weitere[] = ['eigenschaft' => 'einordnung', 'label' => 'Einordnung', 'vorgabe' => '', 'alle' => 'Alle Einordnungen', 'optionen' => $optionen($classes, 'id', 'label')]; + } + + $weitere[] = ['eigenschaft' => 'verarbeitung', 'label' => 'Verarbeitung', 'vorgabe' => '', 'alle' => 'Verarbeitung egal', 'optionen' => ['fehler' => 'Verarbeitungsfehler', 'uebernahme' => 'Datei wird übernommen']]; + $weitere[] = ['eigenschaft' => 'archiv', 'label' => 'Archiv', 'vorgabe' => 'aktiv', 'optionen' => ['aktiv' => 'Aktive Medien', 'archiviert' => 'Archivierte Medien', 'alle' => 'Auch archivierte']]; + + return [ + 'suche' => ['eigenschaft' => 'suche', 'label' => 'Suche', 'platzhalter' => 'Titel, Beschreibung oder Suchbegriff'], + 'filter' => [ + ['eigenschaft' => 'art', 'label' => 'Technische Art', 'vorgabe' => '', 'alle' => 'Alle Arten', 'optionen' => $optionen($this->typeOptions(), 'value', 'label')], + ['eigenschaft' => 'freigabe', 'label' => 'Freigabe', 'vorgabe' => '', 'alle' => 'Alle Freigaben', 'optionen' => ['freigegeben' => 'Freigegebene Fassung', 'entwurf' => 'Nur offener Entwurf', 'ohne' => 'Keine freigegebene Fassung']], + ['eigenschaft' => 'nutzung', 'label' => 'Verwendung', 'vorgabe' => '', 'alle' => 'Verwendung egal', 'optionen' => ['verwendet' => 'Verwendet', 'unbenutzt' => 'Nicht verwendet']], + ], + 'weitere' => $weitere, + 'hinweis' => 'Freigabe meint die Fassung des Mediums, nicht die Website und keinen Zugriff. Materialart und Einordnung sind die redaktionelle Klassifikation; Verwendung zeigt, wo das Medium tatsächlich eingebunden ist. Deaktivierte und archivierte Medien bleiben über „Weitere Filter“ auffindbar.', + 'zeilen' => array_map($this->zeile(...), $this->cards()), + 'einheit' => ['Medium', 'Medien'], + 'leer' => ['titel' => 'Noch keine Medien', 'text' => 'Mit „Medium anlegen“ oben lädst du eine Datei hoch oder schreibst einen Text.'], + 'ansicht' => 'ansicht', + ]; + } + + /** + * @param array $card + * @return array + */ + private function zeile(array $card): array + { + $chips = [['label' => $card['stand'], 'ton' => match ($card['standTone']) { + 'ready' => 'gut', + 'draft' => 'offen', + 'blocked' => 'achtung', + default => 'leise', + }]]; + + foreach ([['draftNote', 'offen'], ['blockedNote', 'achtung'], ['processing', 'offen'], ['versionLabel', 'leise']] as [$feld, $ton]) { + if (filled($card[$feld] ?? null)) { + $chips[] = ['label' => (string) $card[$feld], 'ton' => $ton]; + } + } + + if ($card['archived']) { + $chips[] = ['label' => 'Archiviert', 'ton' => 'leise']; + } + + return [ + 'schluessel' => 'm'.$card['id'], + 'titel' => $card['title'], + 'meta' => $card['type'].(filled($card['editorialKind'] ?? null) ? ' · '.$card['editorialKind'] : ''), + 'text' => $card['description'], + 'bild' => $card['image'], + 'bildAlt' => $card['imageAlt'], + 'symbol' => match ($card['typeKey']) { + 'film' => 'film', + 'bild' => 'bild', + 'audio' => 'audio', + default => 'dokument', + }, + 'url' => $card['url'], + 'chips' => $chips, + 'hinweise' => array_values(array_filter([ + $card['imageNote'] ? 'Vorschaubild: '.$card['imageNote'] : null, + $card['usageNote'] ? 'Einsatz: '.$card['usageNote'] : null, + $card['licenseNote'] ? 'Interner Lizenzvermerk: '.$card['licenseNote'] : null, + ])), + 'zusatz' => ['view' => 'filament.media.usages', 'daten' => ['card' => $card]], + 'aktionen' => array_values(array_filter([ + ['label' => 'Ansehen', 'href' => $card['url'], 'icon' => 'auge'], + $card['editUrl'] ? ['label' => 'Redaktion', 'href' => $card['editUrl'], 'icon' => 'stift'] : null, + ])), + ]; + } + + /** + * @return array + */ + private function libraryFilters(): array + { + return [ + 'suche' => $this->suche, + 'art' => $this->art, + 'freigabe' => $this->freigabe, + 'entwurf' => $this->entwurf, + 'fassung' => $this->fassung, + 'nutzung' => $this->nutzung, + 'saeule' => $this->saeule, + 'einordnung' => $this->einordnung, + 'inhaltsart' => $this->inhaltsart, + 'verarbeitung' => $this->verarbeitung, + 'archiv' => $this->archiv, + ]; + } + + protected function getHeaderActions(): array + { + return [ + Action::make('create') + ->label('Medium anlegen') + ->modalSubmitActionLabel('Medium anlegen') + ->visible(fn (): bool => ContentElementResource::editor()) + ->modalDescription('Dieselbe Maske gilt im Medienbestand, im Modul und im Programm. Der Upload zeigt seinen Fortschritt. Beschreibung, Hinweise und Vorschaubild gehören dazu.') + ->schema(fn (): array => MediumForm::fields(creating: true)) + ->action(function (array $data): void { + $element = null; + $this->report(function () use ($data, &$element): void { + $element = MediumForm::create($data, hold: false); + }, 'Das Medium ist angelegt.'); + + if ($element !== null) { + $this->redirect(ContentElementResource::getUrl('view', ['record' => $element])); + } + }), + ]; + } +} diff --git a/app/Filament/Resources/ContentElements/Pages/ViewContentElement.php b/app/Filament/Resources/ContentElements/Pages/ViewContentElement.php new file mode 100644 index 0000000..1d648a5 --- /dev/null +++ b/app/Filament/Resources/ContentElements/Pages/ViewContentElement.php @@ -0,0 +1,1083 @@ + */ + public array $pillarIds = []; + + /** @var list */ + public array $dimensionIds = []; + + public string $editorialFeedback = ''; + + public int $versionsBeforeSave = 0; + + public string $previewWidth = '640'; + + public string $previewSurface = 'website'; + + public string $pickerContext = 'modul'; + + public string $pickerLayout = 'kacheln'; + + public function mount(int|string $record): void + { + parent::mount($record); + + $requested = request()->integer('fassung'); + + if ($requested > 0) { + $this->fassung = $requested; + } + + $bereich = (string) request()->query('bereich', 'inhalt'); + $this->bereich = $this->normalBereich($bereich); + $this->thumbnailAlt = (string) ($this->getRecord()->thumbnail_alt ?? ''); + $this->bildQuelle = $this->getRecord()->output_class === 'film' ? 'film' : 'upload'; + $this->fillEditorial(); + // Die gezeigte Fassung wird festgehalten. Sonst wechselte die Anzeige still auf eine andere Fassung, sobald + // eine Freigabe oder neue Fassung die Vorgabe „neueste freigegebene“ ändert, während das Textfeld noch den + // Wortlaut der bisherigen enthält. Eine fremde oder ungültige Angabe in der Adresse wird dabei ersetzt. + $this->fassung = $this->shownVersion()?->id; + $this->syncBodyDraft(); + + if (in_array($bereich, ['praesentation', 'redaktion'], true) && $this->canEditEditorial()) { + $this->openRedaktion($bereich === 'praesentation' ? 'medien' : 'texte'); + } + } + + public function updatedBereich(string $value): void + { + $this->bereich = $this->normalBereich($value); + } + + /** + * Bereiche des Medieneditors. Fassungen und Inhalt bilden einen Bereich (Fassungen links, ausgewählte Fassung rechts); + * „fassungen“ bleibt als Adresse gültig. Die früheren Werte „beschreibung“ und „praesentation“ führen zur + * Website-Ansicht, weil Texte und Präsentationsmedien in der gemeinsamen Redaktion bearbeitet werden. + */ + public function normalBereich(string $value): string + { + return match ($value) { + 'inhalt', 'vorschaubild', 'verwendung', 'vorschau', 'website' => $value, + 'fassungen' => 'inhalt', + 'beschreibung', 'praesentation', 'redaktion' => 'website', + default => 'inhalt', + }; + } + + public function getTitle(): string|Htmlable + { + return (string) $this->getRecord()->working_title; + } + + public function getMaxContentWidth(): Width|string|null + { + return Width::Full; + } + + public function infolist(Schema $schema): Schema + { + return $schema->components([ + View::make('filament.media.viewer')->viewData(fn (): array => $this->viewerData())->columnSpanFull(), + ])->columns(1); + } + + /** + * Wählt eine Fassung. Ein geänderter, noch nicht gespeicherter Text geht dabei nicht stillschweigend verloren. + */ + public function showVersion(int $version): void + { + abort_unless($this->ownedVersion($version) instanceof ContentElementVersion, 404); + $this->bereich = 'inhalt'; + + if ($this->shownVersion()?->id === $version) { + return; + } + + if ($this->textUnsaved()) { + $this->askConfirmation('showVersion', $version); + + return; + } + + $this->selectVersion($version); + } + + /** + * Der Text der gezeigten Fassung weicht vom gespeicherten Stand ab. + */ + public function textUnsaved(): bool + { + $shown = $this->shownVersion(); + + return $shown instanceof ContentElementVersion + && $this->getRecord()->output_class === 'text' + && $shown->status !== ContentVersionStatus::Gesperrt + && trim($this->bodyDraft) !== trim((string) $shown->body); + } + + public function discardShownText(): void + { + $this->syncBodyDraft(); + $this->fassungFeedback = ''; + } + + private function selectVersion(int $version): void + { + $this->fassung = $version; + $this->fassungFeedback = ''; + $this->syncBodyDraft(); + } + + public function saveShownText(): void + { + $shown = $this->shownVersion(); + + if (! ContentElementResource::editor() || ! $shown instanceof ContentElementVersion || $shown->element?->output_class !== 'text') { + return; + } + + if (! $this->textUnsaved()) { + $this->fassungFeedback = 'Der Text ist unverändert. Es gibt nichts zu speichern.'; + $this->fassungFeedbackError = false; + + return; + } + + try { + $saved = app(ContentService::class)->reviseElementContent($shown, $this->bodyDraft); + } catch (DomainRuleException $exception) { + $this->fassungFeedback = $exception->getMessage(); + $this->fassungFeedbackError = true; + + return; + } + + // Eine freigegebene Fassung bleibt unverändert; die Auswahl folgt der neu angelegten Fassung. + $this->fassungFeedback = $saved->id !== $shown->id + ? 'Fassung '.$saved->number.' ist angelegt. Fassung '.$shown->number.' bleibt erhalten.' + : 'Der Text ist in Fassung '.$saved->number.' gespeichert. Es entsteht keine neue Fassung.'; + $this->fassungFeedbackError = false; + $this->fassung = $saved->id; + $this->getRecord()->unsetRelation('versions'); + $this->syncBodyDraft(); + } + + public function adoptFrame(): void + { + abort_unless(ContentElementResource::editor(), 403); + /** @var ContentElement $element */ + $element = $this->getRecord(); + $shown = $this->shownVersion(); + + if (! $shown instanceof ContentElementVersion || $element->output_class !== 'film') { + $this->pictureFeedback = 'Für dieses Medium gibt es keine Filmstelle.'; + + return; + } + + if (! is_numeric($this->frameSecond) || trim($this->frameSecond) === '') { + $this->pictureFeedback = 'Wähle zuerst eine Zeitposition.'; + + return; + } + + $seconds = (float) $this->frameSecond; + + if ($seconds < 0 || $seconds > 7200) { + $this->pictureFeedback = 'Die Zeitposition liegt außerhalb des Films.'; + + return; + } + + $this->keepAlt($element); + $element->thumbnail_error = null; + $element->save(); + DeriveThumbnail::dispatch('element', $element->id, null, null, $shown->id, $seconds); + $element->refresh(); + $this->pictureFeedback = $element->thumbnail_error + ?: 'Das Vorschaubild ist gespeichert. Die Fassung bleibt unverändert.'; + } + + public function storePreview(): void + { + abort_unless(ContentElementResource::editor(), 403); + + if (! $this->previewUpload instanceof TemporaryUploadedFile) { + $this->pictureFeedback = 'Wähle zuerst eine Bilddatei.'; + + return; + } + + $extension = strtolower($this->previewUpload->getClientOriginalExtension()); + + if (! in_array($extension, ['png', 'jpg', 'jpeg', 'webp'], true)) { + $this->pictureFeedback = 'Das Vorschaubild muss eine Bilddatei sein.'; + + return; + } + + $path = $this->previewUpload->storeAs( + 'vorschau', + 'karte-'.bin2hex(random_bytes(4)).'.'.$extension, + 'cms_incoming', + ); + $this->previewUpload = null; + + if (! is_string($path)) { + $this->pictureFeedback = 'Das Vorschaubild wurde nicht übernommen.'; + + return; + } + + $this->savePreviewImage($path); + } + + public function savePreviewImage(string $path): void + { + abort_unless(ContentElementResource::editor(), 403); + /** @var ContentElement $element */ + $element = $this->getRecord(); + $this->keepAlt($element); + $element->thumbnail_error = null; + $element->save(); + DeriveThumbnail::dispatch('element', $element->id, $path); + $element->refresh(); + $this->pictureFeedback = $element->thumbnail_error + ?: 'Das Vorschaubild ist gespeichert. Die Fassung bleibt unverändert.'; + } + + public function useOwnImage(): void + { + abort_unless(ContentElementResource::editor(), 403); + /** @var ContentElement $element */ + $element = $this->getRecord(); + + if ($element->output_class !== 'bild') { + $this->pictureFeedback = 'Die Datei dieses Mediums ist kein Bild. Lade ein Vorschaubild hoch.'; + + return; + } + + $this->keepAlt($element); + $element->thumbnail_error = null; + $element->save(); + DeriveThumbnail::dispatch('element', $element->id); + $element->refresh(); + $this->pictureFeedback = $element->thumbnail_error + ?: 'Das Vorschaubild ist gespeichert. Die Fassung bleibt unverändert.'; + } + + public function framePreviewUrl(): ?string + { + $shown = $this->shownVersion(); + + if (! $shown instanceof ContentElementVersion || ! is_numeric($this->frameSecond) || trim($this->frameSecond) === '') { + return null; + } + + return route('editorial.frame', [ + 'version' => $shown->id, + 'sekunde' => $this->frameSecond, + ]); + } + + public function deactivateAction(): Action + { + return Action::make('deactivate') + ->label('Deaktivieren') + ->modalHeading(fn (array $arguments): string => 'Fassung '.($this->ownedVersion((int) ($arguments['version'] ?? 0))?->number ?? '').' deaktivieren') + ->modalDescription('Die Fassung bleibt hier einsehbar. Sie wird nicht mehr ausgeliefert und kann nicht in eine neue Übung oder einen neuen Kurs übernommen werden.') + ->modalSubmitActionLabel('Deaktivieren') + ->visible(fn (): bool => ContentElementResource::editor()) + ->schema([ + Textarea::make('reason')->label('Begründung')->required(), + ]) + ->action(function (array $data, array $arguments): void { + abort_unless(ContentElementResource::editor(), 403); + $this->report(function () use ($data, $arguments): void { + $version = $this->ownedVersion((int) ($arguments['version'] ?? 0)); + abort_unless($version instanceof ContentElementVersion, 404); + app(ContentService::class)->block($version, (string) $data['reason']); + }, 'Die Fassung ist deaktiviert.'); + $this->getRecord()->unsetRelation('versions'); + }); + } + + protected function getHeaderActions(): array + { + return []; + } + + public function releaseVersionAction(): Action + { + return Action::make('releaseVersion') + ->label('Fassung freigeben') + ->modalHeading(function (array $arguments): string { + $versionId = (int) ($arguments['version'] ?? 0); + $version = $versionId > 0 + ? $this->ownedVersion($versionId) + : $this->getRecord()->versions()->where('status', ContentVersionStatus::Entwurf)->orderByDesc('number')->first(); + + return $version instanceof ContentElementVersion ? 'Fassung '.$version->number.' freigeben' : 'Fassung freigeben'; + }) + ->modalDescription('Diese Fassung wird freigegeben. Sie erscheint dadurch nicht in der Mitgliederbibliothek, nicht auf der Website und nicht in einem Angebot. Eine deaktivierte Fassung bleibt unverändert.') + ->modalSubmitActionLabel('Freigeben') + ->visible(function (): bool { + /** @var ContentElement $element */ + $element = $this->getRecord(); + + return ContentElementResource::editor() + && $element->versions()->where('status', ContentVersionStatus::Entwurf)->exists(); + }) + ->action(function (array $arguments): void { + abort_unless(ContentElementResource::editor(), 403); + $this->report(function () use ($arguments): string { + /** @var ContentElement $element */ + $element = $this->getRecord(); + $versionId = (int) ($arguments['version'] ?? 0); + $version = $versionId > 0 + ? $this->ownedVersion($versionId) + : $element->versions()->where('status', ContentVersionStatus::Entwurf)->orderByDesc('number')->first(); + abort_unless($version instanceof ContentElementVersion, 404); + $released = app(ContentService::class)->releaseElementVersion($version); + + return 'Fassung '.$released->number.' ist freigegeben.'; + }, 'Die Fassung ist freigegeben.'); + $this->getRecord()->unsetRelation('versions'); + }); + } + + public function reviseAction(): Action + { + return Action::make('revise') + ->label('Neue Fassung anlegen') + ->modalHeading('Neue Fassung anlegen') + ->modalDescription('Für eine neue Datei oder einen geänderten Lehrtext. Die bisherigen Fassungen bleiben unverändert. Redaktion, Vorschaubild und Website-Angaben gehören nicht zur Fassung.') + ->modalSubmitActionLabel('Fassung anlegen') + ->visible(fn (): bool => ContentElementResource::editor()) + ->schema(fn (): array => ElementRevision::fields($this->getRecord())) + ->action(function (array $data): void { + // Vor dem Anlegen prüfen: danach gäbe es eine andere neueste Fassung. + $textOffen = $this->textUnsaved(); + $this->report(function () use ($data): string { + /** @var ContentElement $element */ + $element = $this->getRecord(); + + return ElementRevision::publish($element, $data); + }, 'Die neue Fassung ist angelegt.'); + $this->getRecord()->unsetRelation('versions'); + + // Die neue Fassung wird gezeigt, sofern dabei kein offener Text verloren geht. + if (! $textOffen) { + $neueste = $this->getRecord()->versions()->orderByDesc('number')->value('id'); + $this->fassung = $neueste !== null ? (int) $neueste : $this->fassung; + $this->fassungFeedback = ''; + $this->syncBodyDraft(); + } + }); + } + + /** + * Löschen bleibt Medien ohne Fassung vorbehalten. Bisher nur im separaten Formular, jetzt unter „Weitere Aktionen“. + */ + public function deleteAction(): Action + { + return Action::make('delete') + ->label('Medium löschen') + ->color('danger') + ->requiresConfirmation() + ->modalHeading('Medium löschen') + ->modalDescription('Das Medium hat keine Fassung und wird endgültig gelöscht. Zuordnungen als Präsentationsmedium entfallen.') + ->modalSubmitActionLabel('Löschen') + ->visible(fn (): bool => ContentElementResource::editor() && $this->getRecord()->versions()->doesntExist()) + ->action(function (): void { + abort_unless(ContentElementResource::editor() && $this->getRecord()->versions()->doesntExist(), 403); + $this->getRecord()->delete(); + $this->redirect(ContentElementResource::getUrl('index')); + }); + } + + public function openThumbnailPicker(): void + { + abort_unless(ContentElementResource::editor(), 403); + $this->resetPicker('vorschaubild'); + $this->pickerKind = 'bild'; + } + + protected function adoptThumbnailFromPicker(string $target): void + { + $this->pickerSelected = $target; + $this->adoptLibraryImage(); + $this->pickerSelected = ''; + } + + /** + * @return array{aktion: string, argument: int|string|null, titel: string, text: string, label: string, gefahr: bool}|null + */ + protected function extraConfirmation(string $aktion, int|string|null $argument): ?array + { + $gezeigt = $this->shownVersion(); + + return match ($aktion) { + 'withdrawWebsite' => ['aktion' => $aktion, 'argument' => null, 'titel' => 'Website-Freigabe zurücknehmen?', 'text' => 'Das Medium verschwindet sofort von allen öffentlichen Seiten. Zuordnungen und Fassungen bleiben erhalten.', 'label' => 'Freigabe zurücknehmen', 'gefahr' => true], + 'showVersion' => ['aktion' => $aktion, 'argument' => $argument, 'titel' => 'Ungespeicherten Text verwerfen?', 'text' => 'Der geänderte Text von Fassung '.($gezeigt?->number ?? '').' ist noch nicht gespeichert und geht beim Wechsel verloren. Gespeicherte Fassungen bleiben unverändert.', 'label' => 'Verwerfen und wechseln', 'gefahr' => true], + default => null, + }; + } + + protected function runExtraConfirmation(string $aktion, int|string|null $argument): void + { + match ($aktion) { + 'withdrawWebsite' => $this->withdrawWebsite(), + 'showVersion' => $this->ownedVersion((int) $argument) instanceof ContentElementVersion ? $this->selectVersion((int) $argument) : null, + default => null, + }; + } + + public function hasDraftVersion(): bool + { + /** @var ContentElement $element */ + $element = $this->getRecord(); + + return $element->versions()->where('status', ContentVersionStatus::Entwurf)->exists(); + } + + /** + * @return array{element: ContentElement, versions: Collection, shown: ?ContentElementVersion, fileUrl: ?string, pending: bool, pillars: list, usage: list, canRevise: bool} + */ + private function viewerData(): array + { + /** @var ContentElement $element */ + $element = $this->getRecord(); + $versions = $element->versions()->orderByDesc('number')->get(); + $shown = $versions->firstWhere('id', $this->fassung) + ?? $versions->first(fn (ContentElementVersion $version): bool => $version->status === ContentVersionStatus::Bereit) + ?? $versions->first(); + $preview = app(ContentPreviewController::class); + $committed = $shown instanceof ContentElementVersion && app(ContentService::class)->isCommitted($shown); + + return [ + 'element' => $element, + 'versions' => $versions, + 'shown' => $shown, + 'fileUrl' => $shown === null ? null : $preview->fileUrl($shown), + 'pending' => $shown !== null && $preview->isPending($shown), + 'pillars' => $element->pillars->pluck('name')->all(), + 'usage' => app(CatalogReading::class)->elementUsage($element), + 'canRevise' => ContentElementResource::editor(), + 'canEditBody' => ContentElementResource::editor() + && $shown instanceof ContentElementVersion + && $element->output_class === 'text' + && $shown->status !== ContentVersionStatus::Gesperrt, + 'bodyCommitted' => $committed, + 'pictureUrl' => ThumbnailRef::url('editorial.card', 'element', $element->id, $element->thumbnail_path), + 'pictureCaption' => $this->pictureCaption($element), + ]; + } + + private function syncBodyDraft(): void + { + $this->bodyDraft = (string) ($this->shownVersion()?->body ?? ''); + } + + private function shownVersion(): ?ContentElementVersion + { + /** @var ContentElement $element */ + $element = $this->getRecord(); + $versions = $element->versions()->orderByDesc('number')->get(); + + return $versions->firstWhere('id', $this->fassung) + ?? $versions->first(fn (ContentElementVersion $version): bool => $version->status === ContentVersionStatus::Bereit) + ?? $versions->first(); + } + + private function keepAlt(ContentElement $element): void + { + $alt = trim($this->thumbnailAlt); + + if ($alt === '') { + return; + } + + $element->thumbnail_alt = $alt; + } + + private function pictureCaption(ContentElement $element): string + { + $source = $element->thumbnail_source; + + if (! is_string($source) || $source === '') { + return ''; + } + + if (preg_match('/^frame:\d+@([\d.]+)$/', $source, $match) === 1) { + return 'Vorschaubild aus dem Film bei '.$match[1].' Sekunden.'; + } + + return match ($source) { + 'eigen' => 'Eigenes Vorschaubild.', + 'datei' => 'Vorschaubild aus der Datei des Mediums.', + 'bestand' => 'Vorschaubild aus einem Bild im Bestand. Es ist damit nicht für die Website freigegeben.', + default => '', + }; + } + + private function ownedVersion(int $id): ?ContentElementVersion + { + /** @var ContentElement $element */ + $element = $this->getRecord(); + + return $element->versions()->whereKey($id)->first(); + } + + /** + * Speichert die Redaktion: Texte, Einordnung, Präsentationsmedien und Abweichungen. Datei und Fassungen bleiben. + */ + public function saveEditorial(): void + { + $this->saveRedaktion(); + } + + protected function saveRedaktionTexte(): bool + { + abort_unless(ContentElementResource::editor(), 403); + + /** @var ContentElement $element */ + $element = $this->getRecord(); + $title = trim($this->workingTitle); + + if ($title === '') { + $this->deskFeedback = 'Der Arbeitstitel fehlt. Er bezeichnet das Medium in der Verwaltung.'; + $this->redaktionFehlerFeld = 'workingTitle'; + + return false; + } + + $kindError = app(EditorialVocabulary::class)->kindError( + 'medium', + filled($this->kindId) ? (int) $this->kindId : null, + $element->editorial_content_kind_id !== null ? (int) $element->editorial_content_kind_id : null, + ); + + if ($kindError !== null) { + $this->deskFeedback = $kindError; + $this->redaktionFehlerFeld = 'kindId'; + + return false; + } + + $this->versionsBeforeSave = $element->versions()->count(); + app(IdentityProfile::class)->fill($element, [ + 'working_title' => $title, + 'display_title' => $this->displayTitle, + 'teaser' => $this->teaser, + 'summary' => $this->summary, + 'search_terms' => $this->searchTerms, + 'description' => $this->descriptionText, + 'usage_note' => $this->usageNote, + 'license_note' => $this->licenseNote, + 'website_credit' => $this->websiteCredit, + 'website_alt' => $this->websiteAlt, + 'editorial_content_kind_id' => filled($this->kindId) ? (int) $this->kindId : null, + ], auth()->user()); + app(PillarService::class)->assign($element, array_map(intval(...), $this->pillarIds)); + app(IdentityDimension::class)->replaceOffered($element, array_map(intval(...), $this->dimensionIds)); + + $element->refresh(); + $this->fillEditorial(); + + return true; + } + + protected function redaktionSavedMessage(): string + { + /** @var ContentElement $element */ + $element = $this->getRecord(); + $this->editorialFeedback = $element->versions()->count() === $this->versionsBeforeSave + ? 'Gespeichert. Es gibt keine neue Fassung.' + : 'Gespeichert. Prüfe die Fassungen, ihre Zahl hat sich geändert.'; + + return $this->editorialFeedback.' Datei, Inhaltsfassung und Website-Freigabe bleiben unverändert.'; + } + + protected function resetRedaktionTexte(): void + { + $this->fillEditorial(); + } + + public function einordnungUnsaved(): bool + { + /** @var ContentElement $element */ + $element = $this->getRecord()->fresh() ?? $this->getRecord(); + $kind = filled($this->kindId) ? (int) $this->kindId : null; + $storedKind = $element->editorial_content_kind_id !== null ? (int) $element->editorial_content_kind_id : null; + + if ($kind !== $storedKind) { + return true; + } + + $pillars = $element->pillars()->pluck('pillars.id')->map(fn ($id): int => (int) $id)->all(); + $currentPillars = array_map(intval(...), $this->pillarIds); + sort($pillars); + sort($currentPillars); + + if ($pillars !== $currentPillars) { + return true; + } + + $stored = IdentityDimensionValue::query() + ->where('subject_type', $element->getMorphClass()) + ->where('subject_id', $element->getKey()) + ->where('origin', 'direkt') + ->pluck('editorial_dimension_value_id') + ->map(fn ($id): int => (int) $id) + ->all(); + $current = array_map(intval(...), $this->dimensionIds); + sort($stored); + sort($current); + + return $stored !== $current; + } + + /** + * @return array{art: string, fuer: string, liste: string, zurueck: string, typ: ?string, umfang: string} + */ + public function redaktionKopf(): array + { + /** @var ContentElement $element */ + $element = $this->getRecord(); + + return [ + 'art' => 'Medium', + 'fuer' => 'das Medium', + 'liste' => 'Medien', + 'zurueck' => 'Zurück zur Medienbearbeitung', + 'typ' => $element->editorialContentKind?->label ?? PublicMaterialReader::outputLabel((string) $element->output_class), + 'umfang' => '„Redaktion speichern“ sichert Texte, Präsentationsmedien und Einordnung dieses Mediums. Verwendende Ansichten übernehmen die Angaben. Datei, Inhaltsfassung und Website-Freigabe bleiben unverändert.', + ]; + } + + public function redaktionTitel(): string + { + $title = trim($this->displayTitle) !== '' ? trim($this->displayTitle) : trim($this->workingTitle); + + return $title !== '' ? $title : (string) $this->getRecord()->working_title; + } + + /** + * @return list> + */ + public function redaktionFelder(): array + { + /** @var ContentElement $element */ + $element = $this->getRecord(); + $stored = fn (string $column): string => (string) ($element->getAttribute($column) ?? ''); + + return [ + ['id' => 'arbeitstitel', 'label' => 'Arbeitstitel', 'model' => 'workingTitle', 'kind' => 'text', 'stored' => $stored('working_title'), 'required' => true, 'hilfe' => 'Bezeichnung in der Verwaltung. Pflichtangabe.'], + ['id' => 'anzeigename', 'label' => 'Anzeigename', 'model' => 'displayTitle', 'kind' => 'text', 'stored' => $stored('display_title'), 'hilfe' => 'Erscheint auf Karten und in der Bibliothek. Leer zeigt den Arbeitstitel.'], + ['id' => 'teaser', 'label' => 'Teaser', 'model' => 'teaser', 'kind' => 'textarea', 'rows' => 2, 'stored' => $stored('teaser')], + ['id' => 'kurz', 'label' => 'Kurzbeschreibung', 'model' => 'summary', 'kind' => 'textarea', 'rows' => 3, 'stored' => $stored('summary'), 'hilfe' => 'Erscheint auf Website- und Bibliothekskarten.'], + ['id' => 'beschreibung', 'label' => 'Ausführliche Beschreibung', 'model' => 'descriptionText', 'kind' => 'textarea', 'rows' => 8, 'stored' => $stored('description'), 'hilfe' => 'Bleibt in der Verwaltung und in Detailansichten. Kein Lehrtext.'], + ['id' => 'suche', 'label' => 'Suchbegriffe', 'model' => 'searchTerms', 'kind' => 'text', 'gruppe' => 'weitere', 'stored' => $stored('search_terms'), 'placeholder' => 'Begriffe, durch Komma getrennt'], + ['id' => 'einsatz', 'label' => 'Hinweise für den Einsatz', 'model' => 'usageNote', 'kind' => 'textarea', 'rows' => 3, 'gruppe' => 'weitere', 'stored' => $stored('usage_note')], + ['id' => 'lizenz', 'label' => 'Interner Lizenzvermerk', 'model' => 'licenseNote', 'kind' => 'textarea', 'rows' => 3, 'gruppe' => 'weitere', 'stored' => $stored('license_note'), 'hilfe' => 'Nur intern sichtbar.'], + ['id' => 'quelle', 'label' => 'Quellenzeile für die Website', 'model' => 'websiteCredit', 'kind' => 'textarea', 'rows' => 2, 'gruppe' => 'weitere', 'stored' => $stored('website_credit')], + ['id' => 'alt', 'label' => 'Alternativtext für die Website', 'model' => 'websiteAlt', 'kind' => 'text', 'gruppe' => 'weitere', 'stored' => $stored('website_alt'), 'hilfe' => 'Beschreibt das Bild für Menschen, die es nicht sehen.'], + ]; + } + + /** + * @return array{model: string, options: array, hilfe: string} + */ + public function einordnungArt(): array + { + return [ + 'model' => 'kindId', + 'options' => app(EditorialVocabulary::class)->kindOptions('medium', $this->getRecord()->editorial_content_kind_id !== null ? (int) $this->getRecord()->editorial_content_kind_id : null), + 'hilfe' => 'Fachliche Materialart, unabhängig von der technischen Medienart.', + ]; + } + + /** + * @return list}> + */ + public function einordnungGruppen(): array + { + $groups = [[ + 'legend' => 'Fachliche Säulen', + 'model' => 'pillarIds', + 'values' => Pillar::query()->orderBy('name')->get(['id', 'name']) + ->map(fn (Pillar $pillar): array => ['id' => (int) $pillar->id, 'label' => (string) $pillar->name])->all(), + ]]; + + foreach (app(EditorialVocabulary::class)->dimensionGroups($this->getRecord(), IdentityDimensionValue::query() + ->where('subject_type', $this->getRecord()->getMorphClass()) + ->where('subject_id', $this->getRecord()->getKey()) + ->pluck('editorial_dimension_value_id')->map(fn ($id): int => (int) $id)->all()) as $dimension) { + $groups[] = [ + 'legend' => $dimension['label'], + 'model' => 'dimensionIds', + 'values' => $dimension['values'], + ]; + } + + return array_values(array_filter($groups, fn (array $group): bool => $group['values'] !== [])); + } + + /** + * @return array{view: string, stand: string} + */ + public function redaktionAusgabe(): ?array + { + return [ + 'view' => 'filament.media.preview-frame', + 'stand' => 'Arbeitstitel, Anzeigename und Kurzbeschreibung zeigen deine aktuellen Eingaben, auch ungespeicherte. Bild und übrige Angaben zeigen den gespeicherten Stand.', + ]; + } + + /** + * Gibt das Medium für die Website frei. Quellenzeile und Alternativtext gelten im gespeicherten Stand der Redaktion; + * offene Eingaben in der Redaktion werden dabei weder gespeichert noch zurückgesetzt. + */ + public function releaseForWebsite(): void + { + abort_unless(ContentElementResource::editor(), 403); + + /** @var ContentElement $element */ + $element = $this->getRecord(); + $this->websiteFeedback = app(WebsiteRelease::class)->release($element, auth()->user()); + $element->refresh(); + } + + public function withdrawWebsite(): void + { + abort_unless(ContentElementResource::editor(), 403); + + /** @var ContentElement $element */ + $element = $this->getRecord(); + $this->websiteFeedback = app(WebsiteRelease::class)->withdraw($element, auth()->user()); + $element->refresh(); + } + + public function saveThumbnailAlt(): void + { + abort_unless(ContentElementResource::editor(), 403); + + /** @var ContentElement $element */ + $element = $this->getRecord(); + app(IdentityProfile::class)->fill($element, ['thumbnail_alt' => trim($this->thumbnailAlt)], auth()->user()); + $element->refresh(); + $this->thumbnailAlt = (string) ($element->thumbnail_alt ?? ''); + $this->pictureFeedback = 'Der Alternativtext des Vorschaubilds ist gespeichert. Die Fassung bleibt unverändert.'; + } + + /** + * Website-Seiten, die dieses Medium als Bild verwenden (CMS-Widgets und Abschnittshintergründe). + * + * @return list + */ + public function websitePages(): array + { + /** @var ContentElement $element */ + $element = $this->getRecord(); + + return app(WebsiteImageUsage::class)->pages($element); + } + + public function websiteIsPublic(): bool + { + /** @var ContentElement $element */ + $element = $this->getRecord(); + + return app(WebsiteMedia::class)->present($element->fresh()) !== null; + } + + public function adoptLibraryImage(): void + { + abort_unless(ContentElementResource::editor(), 403); + + /** @var ContentElement $element */ + $element = $this->getRecord(); + $detail = $this->selectionDetail(); + $sourceId = (int) ($detail['element_id'] ?? 0); + $source = $sourceId > 0 ? ContentElement::query()->find($sourceId) : null; + $path = $source?->thumbnail_path; + + if (! $source instanceof ContentElement || $source->output_class !== 'bild' || ! is_string($path) || ! str_starts_with($path, 'vorschau/') || str_contains($path, '..')) { + $this->pictureFeedback = 'Dieses Bild hat noch kein übernehmbares Vorschaubild.'; + + return; + } + + $versions = $element->versions()->count(); + app(IdentityProfile::class)->fill($element, [ + 'thumbnail_path' => $path, + 'thumbnail_alt' => filled($source->thumbnail_alt) ? $source->thumbnail_alt : $source->working_title, + 'thumbnail_source' => 'bestand', + 'thumbnail_error' => null, + ], auth()->user()); + $element->refresh(); + $this->thumbnailAlt = (string) ($element->thumbnail_alt ?? ''); + $this->pictureFeedback = $element->versions()->count() === $versions + ? 'Vorschaubild übernommen. Es gibt keine neue Fassung. Für die Website ist es damit nicht freigegeben.' + : 'Vorschaubild übernommen. Prüfe die Fassungen.'; + } + + /** + * @return array{items: list>, more: bool} + */ + public function selection(): array + { + return app(EditorialCatalog::class)->browse( + $this->pickerQuery, + $this->pickerContext === 'bild' ? 'bild' : 'alle', + '', + 0, + elementsOnly: $this->pickerContext !== 'modul', + ); + } + + /** + * @return array|null + */ + public function selectionDetail(): ?array + { + if ($this->pickerSelected === '') { + return null; + } + + $row = app(EditorialCatalog::class)->rowForTarget($this->pickerSelected, 0, allowDraft: true); + + if ($row === null || ! isset($row['element_id'])) { + return $row; + } + + $element = ContentElement::query()->with('editorialContentKind')->find((int) $row['element_id']); + + if ($element instanceof ContentElement) { + $row['visibility'] = app(PublicMaterialReader::class)->visibilityNote($element); + } + + return $row; + } + + public function previewHtml(): string + { + /** @var ContentElement $element */ + $element = $this->getRecord(); + $draft = [ + 'working_title' => $this->workingTitle, + 'display_title' => $this->displayTitle, + 'summary' => $this->summary, + 'thumbnail_alt' => $this->thumbnailAlt, + ]; + + if ($this->previewSurface === 'bibliothek') { + $title = trim($this->displayTitle) !== '' ? trim($this->displayTitle) : trim($this->workingTitle); + + return view('member.partials.card', [ + 'href' => '#vorschau', + 'card' => [ + 'title' => $title !== '' ? $title : $element->working_title, + 'summary' => trim($this->summary) !== '' ? trim($this->summary) : null, + 'kind' => PublicMaterialReader::outputLabel((string) $element->output_class), + 'coverage' => 'offen', + 'image' => trim($this->thumbnailAlt) !== '' ? trim($this->thumbnailAlt) : $title, + 'image_url' => ThumbnailRef::url('editorial.card', 'element', $element->id, $element->thumbnail_path), + 'error' => 'Vorschau der Kartenform. Ob jemand sie öffnen darf, entscheidet die Lizenz.', + ], + ])->render(); + } + + $subject = app(PublicMaterialReader::class)->subject($element->id, true, $draft); + + if ($subject === null) { + return '

Für dieses Medium liegt noch keine anzeigbare Fassung vor. Die Karte erscheint deshalb auch in der Vorschau nicht.

'; + } + + return view('widgets.premium_card', [ + 'subject' => $subject, + 'context' => RenderContext::preview(), + 'cardStyle' => $subject->style ?? 'media', + 'imageUrl' => null, + 'alt' => '', + 'focus' => ['x' => 50, 'y' => 45], + 'format' => 'landscape', + 'fit' => 'cover', + 'headingTag' => 'h3', + 'show' => ['summary' => true, 'kind' => true, 'meta' => true, 'action' => true], + 'actionLabel' => 'Ansehen', + 'note' => null, + 'stacked' => $this->previewWidth === '390', + ])->render(); + } + + /** + * @return list + */ + public function editorialHistory(): array + { + /** @var ContentElement $element */ + $element = $this->getRecord(); + $labels = [ + 'working_title' => 'Arbeitstitel', + 'display_title' => 'Anzeigename', + 'teaser' => 'Teaser', + 'description' => 'Beschreibung', + 'summary' => 'Kurzbeschreibung', + 'search_terms' => 'Suchbegriffe', + 'usage_note' => 'Einsatzhinweis', + 'license_note' => 'Interner Lizenzvermerk', + 'website_credit' => 'Quellenzeile', + 'website_alt' => 'Alternativtext der Website', + 'website_released_at' => 'Website-Freigabe', + 'thumbnail_alt' => 'Alternativtext', + 'thumbnail_path' => 'Vorschaubild', + 'thumbnail_source' => 'Herkunft des Vorschaubilds', + 'editorial_content_kind_id' => 'Fachliche Materialart', + ]; + + return IdentityChange::query() + ->where('subject_type', $element->getMorphClass()) + ->where('subject_id', $element->id) + ->latest('occurred_at') + ->limit(8) + ->get() + ->map(fn (IdentityChange $change): array => [ + 'field' => $labels[$change->field] ?? $change->field, + 'after' => is_scalar($change->after) ? (string) $change->after : '', + 'when' => $change->occurred_at?->timezone(config('app.timezone'))->format('d.m.Y H:i') ?? '', + ]) + ->all(); + } + + /** + * @return array + */ + public function usageCard(): array + { + /** @var ContentElement $element */ + $element = $this->getRecord(); + + return app(MediaLibrary::class)->cardFor($element, ContentElementResource::editor()); + } + + private function fillEditorial(): void + { + /** @var ContentElement $element */ + $element = $this->getRecord(); + $this->workingTitle = (string) $element->working_title; + $this->displayTitle = (string) ($element->display_title ?? ''); + $this->teaser = (string) ($element->teaser ?? ''); + $this->summary = (string) ($element->summary ?? ''); + $this->searchTerms = (string) ($element->search_terms ?? ''); + $this->descriptionText = (string) ($element->description ?? ''); + $this->usageNote = (string) ($element->usage_note ?? ''); + $this->licenseNote = (string) ($element->license_note ?? ''); + $this->websiteCredit = (string) ($element->website_credit ?? ''); + $this->websiteAlt = (string) ($element->website_alt ?? ''); + $this->kindId = $element->editorial_content_kind_id; + $this->pillarIds = $element->pillars()->pluck('pillars.id')->all(); + $this->dimensionIds = IdentityDimensionValue::query() + ->where('subject_type', $element->getMorphClass()) + ->where('subject_id', $element->id) + ->where('origin', 'direkt') + ->pluck('editorial_dimension_value_id') + ->all(); + } +} diff --git a/app/Filament/Resources/Courses/CourseResource.php b/app/Filament/Resources/Courses/CourseResource.php new file mode 100644 index 0000000..4e66f11 --- /dev/null +++ b/app/Filament/Resources/Courses/CourseResource.php @@ -0,0 +1,34 @@ + ListCourses::route('/'), + 'edit' => EditCourse::route('/{record}'), + ]; + } +} diff --git a/app/Filament/Resources/Courses/Pages/EditCourse.php b/app/Filament/Resources/Courses/Pages/EditCourse.php new file mode 100644 index 0000000..51e2165 --- /dev/null +++ b/app/Filament/Resources/Courses/Pages/EditCourse.php @@ -0,0 +1,11 @@ + ListExercises::route('/'), + 'edit' => EditExercise::route('/{record}'), + ]; + } +} diff --git a/app/Filament/Resources/Exercises/Pages/EditExercise.php b/app/Filament/Resources/Exercises/Pages/EditExercise.php new file mode 100644 index 0000000..c8ac861 --- /dev/null +++ b/app/Filament/Resources/Exercises/Pages/EditExercise.php @@ -0,0 +1,11 @@ +user(); + + return $user instanceof User && $user->hasStaffRole(StaffRole::Katalogverwalter); + } + + public static function getViewAuthorizationResponse(Model $record): Response + { + return self::keeper() ? Response::allow() : Response::deny(); + } + + public static function infolist(Schema $schema): Schema + { + return $schema->columns(1)->components([ + View::make('filament.editorial.license-desk') + ->viewData(fn (LicenseArticle $record): array => [ + 'stand' => app(CatalogReading::class)->articleStand($record), + 'kontext' => app(CatalogReading::class)->articleContext($record), + ]) + ->columnSpanFull(), + ]); + } + + public static function form(Schema $schema): Schema + { + return $schema; + } + + public static function table(Table $table): Table + { + return $table->columns([ + TextColumn::make('code')->label('Kennung')->searchable(), + TextColumn::make('product_line')->label('Produktlinie'), + TextColumn::make('currentRelease.number')->label('Aktueller Stand'), + ]); + } + + public static function getPages(): array + { + return [ + 'index' => ListLicenseArticles::route('/'), + 'view' => ViewLicenseArticle::route('/{record}'), + ]; + } +} diff --git a/app/Filament/Resources/LicenseArticles/Pages/ListLicenseArticles.php b/app/Filament/Resources/LicenseArticles/Pages/ListLicenseArticles.php new file mode 100644 index 0000000..a8af291 --- /dev/null +++ b/app/Filament/Resources/LicenseArticles/Pages/ListLicenseArticles.php @@ -0,0 +1,152 @@ +label('Artikel anlegen') + ->modalHeading('Neuer Lizenzartikel') + ->modalDescription('Kennung und Produktlinie genügen. Titel, Texte und Stand pflegst du danach am Artikel.') + ->modalSubmitActionLabel('Artikel anlegen') + ->schema([ + TextInput::make('code')->label('Kennung')->required(), + TextInput::make('product_line')->label('Produktlinie'), + ]) + ->action(function (array $data): void { + $article = null; + $this->report(function () use ($data, &$article): void { + $article = app(ArticleService::class)->create($data['code'], $data['product_line'] ?? null); + }, 'Der Lizenzartikel ist angelegt.'); + + if ($article instanceof LicenseArticle) { + $this->redirect(LicenseArticleResource::getUrl('view', ['record' => $article])); + } + }), + ]; + } + + protected function catalogRows(): array + { + $offered = DB::table('resolved_scopes') + ->join('offer_versions', 'offer_versions.id', '=', 'resolved_scopes.offer_version_id') + ->where('offer_versions.status', 'aktiv') + ->distinct() + ->pluck('resolved_scopes.license_article_id') + ->map(fn (mixed $id): int => (int) $id) + ->all(); + $presentation = app(PresentationMedia::class); + $rows = []; + + foreach (LicenseArticle::query()->with(['currentRelease', 'releases'])->orderBy('code')->get() as $article) { + $current = $article->currentRelease; + $currentStatus = $current !== null ? StatusValue::of($current->status) : null; + $draft = $article->releases->first(fn ($release): bool => StatusValue::of($release->status) === ReleaseStatus::Entwurf->value); + $chips = []; + $zustand = []; + + if ($current === null) { + $chips[] = ['label' => 'Noch kein Stand', 'ton' => 'offen']; + $zustand[] = 'ohne'; + } elseif ($currentStatus === ReleaseStatus::Gesperrt->value) { + $chips[] = ['label' => 'Stand '.$current->number.' gesperrt', 'ton' => 'achtung']; + $zustand[] = 'gesperrt'; + } else { + $chips[] = ['label' => 'Stand '.$current->number.' veröffentlicht', 'ton' => 'gut']; + $zustand[] = 'stand'; + } + + if ($draft !== null) { + $chips[] = ['label' => 'Stand '.$draft->number.' in Arbeit', 'ton' => 'offen']; + $zustand[] = 'entwurf'; + } + + $inOffer = in_array($article->id, $offered, true); + $chips[] = $inOffer ? ['label' => 'In einem aktiven Angebot', 'ton' => 'gut'] : ['label' => 'In keinem aktiven Angebot', 'ton' => 'leise']; + $zustand[] = $inOffer ? 'angebot' : 'ohne-angebot'; + + if ($article->archived_at !== null) { + $chips[] = ['label' => 'Archiviert', 'ton' => 'leise']; + $zustand[] = 'archiviert'; + } + + $coverId = $presentation->coverElementId($article); + $cover = $coverId !== null ? ContentElement::query()->find($coverId) : null; + $title = trim((string) ($article->display_title ?: $article->working_title)) ?: $article->code; + $url = LicenseArticleResource::getUrl('view', ['record' => $article]); + $rows[] = [ + 'schluessel' => 'a'.$article->id, + 'titel' => $title, + 'meta' => 'Lizenzartikel · '.$article->code.(filled($article->product_line) ? ' · '.$article->product_line : ''), + 'text' => trim((string) ($article->teaser ?: $article->summary)), + 'bild' => $cover !== null ? ThumbnailRef::url('editorial.card', 'element', $cover->id, $cover->thumbnail_path) : null, + 'symbol' => 'dokument', + 'url' => $url, + 'chips' => $chips, + 'zustand' => $zustand, + 'suchtext' => implode(' ', array_filter([$article->code, $article->working_title, $article->display_title, $article->summary, $article->product_line, $article->search_terms])), + 'aktionen' => [['label' => 'Öffnen', 'href' => $url]], + ]; + } + + return $rows; + } + + protected function zustandOptionen(): array + { + return [ + 'alle' => 'Jeder Zustand', + 'stand' => 'Mit veröffentlichtem Stand', + 'ohne' => 'Noch ohne Stand', + 'entwurf' => 'Stand in Arbeit', + 'gesperrt' => 'Gesperrter Stand', + 'angebot' => 'In einem aktiven Angebot', + 'ohne-angebot' => 'In keinem aktiven Angebot', + 'archiviert' => 'Archiviert', + ]; + } + + protected function einheit(): array + { + return ['Lizenzartikel', 'Lizenzartikel']; + } + + protected function leer(): array + { + return ['titel' => 'Noch keine Lizenzartikel', 'text' => 'Mit „Artikel anlegen“ oben entsteht der erste Artikel.']; + } + + protected function suchPlatzhalter(): string + { + return 'Kennung, Titel oder Produktlinie'; + } +} diff --git a/app/Filament/Resources/LicenseArticles/Pages/ViewLicenseArticle.php b/app/Filament/Resources/LicenseArticles/Pages/ViewLicenseArticle.php new file mode 100644 index 0000000..9c17df4 --- /dev/null +++ b/app/Filament/Resources/LicenseArticles/Pages/ViewLicenseArticle.php @@ -0,0 +1,383 @@ + */ + public array $dimensionIds = []; + + public function mount(int|string $record): void + { + parent::mount($record); + $this->fillLicenseEditorial(); + } + + public function canEditEditorial(): bool + { + return LicenseArticleResource::keeper(); + } + + public function canViewEditorial(): bool + { + return LicenseArticleResource::keeper(); + } + + public function getTitle(): string|Htmlable + { + return $this->redaktionTitel(); + } + + public function saveLicenseEditorial(): void + { + $this->saveRedaktion(); + } + + protected function saveRedaktionTexte(): bool + { + $this->guardEditorial(); + + /** @var LicenseArticle $article */ + $article = $this->getRecord(); + $this->releaseBeforeSave = $article->current_release_id; + $this->releaseCountBeforeSave = $article->releases()->count(); + + $kindError = app(EditorialVocabulary::class)->kindError( + 'lizenzartikel', + filled($this->kindId) ? (int) $this->kindId : null, + $article->editorial_content_kind_id !== null ? (int) $article->editorial_content_kind_id : null, + ); + + if ($kindError !== null) { + $this->deskFeedback = $kindError; + $this->redaktionFehlerFeld = 'kindId'; + + return false; + } + + app(IdentityProfile::class)->fill($article, [ + 'working_title' => $this->workingTitle, + 'display_title' => $this->displayTitle, + 'teaser' => $this->teaser, + 'summary' => $this->summary, + 'description' => $this->descriptionText, + 'search_terms' => $this->searchTerms, + 'editorial_content_kind_id' => filled($this->kindId) ? (int) $this->kindId : null, + ], auth()->user()); + + app(IdentityDimension::class)->replaceOffered($article, array_map(intval(...), $this->dimensionIds)); + + $article->refresh(); + $this->fillLicenseEditorial(); + + return true; + } + + protected function redaktionSavedMessage(): string + { + /** @var LicenseArticle $article */ + $article = $this->getRecord(); + + return $article->current_release_id === $this->releaseBeforeSave && $article->releases()->count() === $this->releaseCountBeforeSave + ? 'Gespeichert. Stand, Preis und Rechte bleiben unverändert.' + : 'Gespeichert. Prüfe den Artikelstand, er hat sich geändert.'; + } + + protected function resetRedaktionTexte(): void + { + $this->fillLicenseEditorial(); + } + + public function einordnungUnsaved(): bool + { + /** @var LicenseArticle $article */ + $article = $this->getRecord()->fresh() ?? $this->getRecord(); + $kind = filled($this->kindId) ? (int) $this->kindId : null; + $storedKind = $article->editorial_content_kind_id !== null ? (int) $article->editorial_content_kind_id : null; + + if ($kind !== $storedKind) { + return true; + } + + $stored = IdentityDimensionValue::query() + ->where('subject_type', $article->getMorphClass()) + ->where('subject_id', $article->getKey()) + ->where('origin', 'direkt') + ->pluck('editorial_dimension_value_id') + ->map(fn ($id): int => (int) $id) + ->all(); + $current = array_map(intval(...), $this->dimensionIds); + sort($stored); + sort($current); + + return $stored !== $current; + } + + /** + * @return array{art: string, fuer: string, liste: string, zurueck: string, typ: ?string, umfang: string} + */ + public function redaktionKopf(): array + { + return [ + 'art' => 'Lizenzartikel', + 'fuer' => 'den Lizenzartikel', + 'liste' => 'Lizenzartikel', + 'zurueck' => 'Zurück zum Lizenzartikel', + 'typ' => null, + 'umfang' => '„Redaktion speichern“ sichert die eigenen Texte, Präsentationsmedien und Einordnung dieses Lizenzartikels. Leere Angaben übernehmen weiter die fachliche Quelle. Stand, Preis und Rechte bleiben unverändert.', + ]; + } + + public function redaktionTitel(): string + { + foreach ([$this->displayTitle, $this->workingTitle] as $title) { + if (trim($title) !== '') { + return trim($title); + } + } + + $profile = $this->editorialProfile('artikel'); + + if ($profile->value('display_title') !== null) { + return (string) $profile->value('display_title'); + } + + $source = $profile->source; + + return $source !== null ? $this->sourceTitle($source) : (string) $this->getRecord()->code; + } + + /** + * @return list> + */ + public function redaktionFelder(): array + { + /** @var LicenseArticle $article */ + $article = $this->getRecord(); + $source = app(EditorialProfileReader::class)->sourceOf($article); + $sourceTitle = $source !== null ? $this->sourceTitle($source) : null; + $stored = fn (string $column): string => (string) ($article->getAttribute($column) ?? ''); + $quelle = fn (string $column): ?array => $sourceTitle === null ? null : [ + 'titel' => $sourceTitle, + 'wert' => (string) ($source->getAttribute($column) ?? ''), + ]; + + return [ + ['id' => 'arbeitstitel', 'label' => 'Interner Arbeitstitel', 'model' => 'workingTitle', 'kind' => 'text', 'stored' => $stored('working_title'), 'hilfe' => 'Nur in der Verwaltung sichtbar.'], + ['id' => 'anzeigename', 'label' => 'Name', 'model' => 'displayTitle', 'kind' => 'text', 'stored' => $stored('display_title'), 'quelle' => $quelle('display_title')], + ['id' => 'teaser', 'label' => 'Teaser', 'model' => 'teaser', 'kind' => 'textarea', 'rows' => 2, 'stored' => $stored('teaser'), 'quelle' => $quelle('teaser')], + ['id' => 'kurz', 'label' => 'Kurzbeschreibung', 'model' => 'summary', 'kind' => 'textarea', 'rows' => 4, 'stored' => $stored('summary'), 'quelle' => $quelle('summary')], + ['id' => 'beschreibung', 'label' => 'Beschreibung', 'model' => 'descriptionText', 'kind' => 'textarea', 'rows' => 6, 'stored' => $stored('description'), 'quelle' => $quelle('description')], + ['id' => 'suche', 'label' => 'Suchbegriffe', 'model' => 'searchTerms', 'kind' => 'text', 'gruppe' => 'weitere', 'stored' => $stored('search_terms'), 'quelle' => $quelle('search_terms')], + ]; + } + + /** + * @return array{titel: string, art: string, fuer: string, url: ?string}|null + */ + public function redaktionQuelle(): ?array + { + /** @var LicenseArticle $article */ + $article = $this->getRecord(); + $source = app(EditorialProfileReader::class)->sourceOf($article); + + if ($source === null) { + return null; + } + + $url = match (true) { + $source instanceof Composition => EditorialCatalog::editUrl($source), + $source instanceof ContentElement => ContentElementResource::getUrl('view', ['record' => $source]), + default => null, + }; + + return [ + 'titel' => $this->sourceTitle($source), + 'art' => $source instanceof ContentElement ? 'Medium' : ($source instanceof Composition && $source->kind === CompositionKind::Kurs ? 'Programm' : 'Modul'), + 'fuer' => 'diesen Lizenzartikel', + 'url' => $url, + ]; + } + + public function redaktionOhneQuelle(): string + { + return 'Keine eindeutige fachliche Quelle. Es wird nichts aus einem Modul, Programm oder Medium übernommen.'; + } + + /** + * @return array{model: string, options: array, hilfe: string} + */ + public function einordnungArt(): array + { + return [ + 'model' => 'kindId', + 'options' => app(EditorialVocabulary::class)->kindOptions('lizenzartikel', $this->getRecord()->editorial_content_kind_id !== null ? (int) $this->getRecord()->editorial_content_kind_id : null), + 'hilfe' => 'Die Einordnung des Artikels ändert weder die Quelle noch den Preis.', + ]; + } + + /** + * @return list}> + */ + public function einordnungGruppen(): array + { + return array_map(fn (array $group): array => [ + 'legend' => $group['label'], + 'model' => 'dimensionIds', + 'values' => $group['values'], + ], $this->licenseDimensionGroups()); + } + + private function sourceTitle(Model $source): string + { + $title = $source->getAttribute('display_title') ?: ($source->getAttribute('working_title') ?? $source->getAttribute('designation')); + + return (string) $title; + } + + /** + * @return list}> + */ + public function licenseDimensionGroups(): array + { + return app(EditorialVocabulary::class)->dimensionGroups($this->getRecord(), IdentityDimensionValue::query() + ->where('subject_type', $this->getRecord()->getMorphClass()) + ->where('subject_id', $this->getRecord()->getKey()) + ->pluck('editorial_dimension_value_id')->map(fn ($id): int => (int) $id)->all()); + } + + private function fillLicenseEditorial(): void + { + /** @var LicenseArticle $article */ + $article = $this->getRecord(); + $this->workingTitle = (string) ($article->working_title ?? ''); + $this->displayTitle = (string) ($article->display_title ?? ''); + $this->teaser = (string) ($article->teaser ?? ''); + $this->summary = (string) ($article->summary ?? ''); + $this->descriptionText = (string) ($article->description ?? ''); + $this->searchTerms = (string) ($article->search_terms ?? ''); + $this->kindId = $article->editorial_content_kind_id; + $this->dimensionIds = IdentityDimensionValue::query() + ->where('subject_type', $article->getMorphClass()) + ->where('subject_id', $article->id) + ->where('origin', 'direkt') + ->pluck('editorial_dimension_value_id') + ->all(); + } + + protected function getHeaderActions(): array + { + return []; + } + + public function releaseAction(): Action + { + return Action::make('release') + ->label('Stand veröffentlichen') + ->schema([ + Select::make('root')->label('Wurzel')->options(fn (): array => CatalogOptions::readyTargets())->required(), + Textarea::make('classification')->label('Einordnung')->required() + ->helperText('Warum dies derselbe Lizenzartikel bleibt und kein neues Produkt ist.'), + TextInput::make('change_note')->label('Änderungshinweis'), + ]) + ->action(function (array $data): void { + $this->report(function () use ($data): string { + /** @var LicenseArticle $article */ + $article = $this->getRecord(); + [$type, $id] = explode(':', $data['root'], 2); + $root = $type === 'composition' + ? CompositionVersion::query()->findOrFail($id) + : ContentElementVersion::query()->findOrFail($id); + $release = app(ArticleService::class)->publishRelease( + $article, + $root, + $data['classification'], + $data['change_note'] ?? null, + ); + $report = $release->impact_report ?? []; + $offers = $report['offers'] ?? []; + + return 'Stand '.$release->number.' ist veröffentlicht. Inhalte: '.($report['contents'] ?? 0) + .', Inhaber: '.($report['holders'] ?? 0) + .', Angebote: '.(implode(', ', $offers) !== '' ? implode(', ', $offers) : 'keins').'.'; + }, 'Der Artikel-Stand ist veröffentlicht.'); + $this->refreshRecord(); + }); + } + + public function withdrawAction(): Action + { + return Action::make('withdraw') + ->label('Stand zurückziehen') + ->schema([ + Textarea::make('reason')->label('Begründung')->required(), + ]) + ->action(function (array $data): void { + $this->report(function () use ($data): string { + $result = app(ArticleService::class)->withdraw($this->getRecord(), $data['reason']); + $current = $result['fallback_number'] === null + ? 'Es gibt keinen früheren Stand.' + : 'Aktuell ist wieder Stand '.$result['fallback_number'].'.'; + $holders = $result['holders'] === [] ? 'niemand' : implode(', ', $result['holders']); + + return 'Der Stand ist zurückgezogen. '.$current.' Betroffen: '.$holders.'.'; + }, 'Der Stand ist zurückgezogen.'); + $this->refreshRecord(); + }); + } + + private function refreshRecord(): void + { + $this->getRecord()->unsetRelations(); + $this->getRecord()->refresh(); + } +} diff --git a/app/Filament/Resources/NavigationItems/NavigationItemResource.php b/app/Filament/Resources/NavigationItems/NavigationItemResource.php new file mode 100644 index 0000000..fdb23a6 --- /dev/null +++ b/app/Filament/Resources/NavigationItems/NavigationItemResource.php @@ -0,0 +1,155 @@ +components([ + TextInput::make('label')->label('Beschriftung')->required()->maxLength(80), + Select::make('placement') + ->label('Platz') + ->options(NavigationItem::PLACEMENTS) + ->default('header') + ->required() + ->live() + ->helperText('Kopfzeile: Hauptnavigation. Fußbereich: drei Spalten „Service“, „Kontakt“ und „Rechtliches“.'), + Select::make('parent_id') + ->label('Untermenü von') + ->placeholder('Oberste Ebene') + ->options(fn (?NavigationItem $record): array => NavigationItem::query() + ->where('placement', 'header') + ->whereNull('parent_id') + ->when($record !== null, fn ($query) => $query->whereKeyNot($record->getKey())) + ->orderBy('sort_order') + ->pluck('label', 'id') + ->all()) + ->visible(fn (Get $get): bool => $get('placement') === 'header') + ->disabled(fn (?NavigationItem $record): bool => $record !== null && $record->children()->exists()) + ->helperText('Eine Ebene Untermenü in der Hauptnavigation. Ein Eintrag mit eigenen Untereinträgen bleibt oberste Ebene.') + ->rule(fn (?NavigationItem $record): Closure => function (string $attribute, mixed $value, Closure $fail) use ($record): void { + if (blank($value)) { + return; + } + $parent = NavigationItem::query()->find($value); + if ($parent === null || $parent->placement !== 'header' || $parent->parent_id !== null || ($record !== null && $parent->is($record))) { + $fail('Untermenüs sind nur unter einem Eintrag der obersten Ebene der Hauptnavigation möglich.'); + } + }), + Select::make('page_id') + ->label('Interne Seite') + ->options(fn (): array => Page::query()->orderBy('path')->pluck('path', 'id')->all()) + ->searchable() + ->helperText('Bevorzugt: eine CMS-Seite wählen. Dann folgt der Link automatisch einer Pfadänderung.'), + TextInput::make('url') + ->label('Oder Adresse') + ->maxLength(500) + ->helperText('Nur wenn keine Seite gewählt ist: Pfad wie /anmelden oder eine vollständige http(s)-Adresse.') + ->rule(SafeUrl::rule()) + ->rule(function (Get $get, ?NavigationItem $record): Closure { + return function (string $attribute, mixed $value, Closure $fail) use ($get, $record): void { + // Ein Eintrag mit Untereinträgen darf ohne eigenes Ziel nur das Untermenü öffnen. + if (blank($get('page_id')) && blank($value) && ! ($record?->children()->exists() ?? false)) { + $fail('Wählen Sie eine Seite oder eine Adresse.'); + } + }; + }), + Toggle::make('is_visible') + ->label('Auf der Website anzeigen') + ->default(true), + TextInput::make('sort_order') + ->label('Reihenfolge') + ->numeric() + ->minValue(0) + ->default(fn (): int => (int) NavigationItem::query()->max('sort_order') + 1) + ->helperText('Kleinere Zahlen stehen weiter vorn. In der Liste lässt sich die Reihenfolge auch per Ziehen ändern.') + ->required(), + ]); + } + + public static function table(Table $table): Table + { + return $table + ->columns([ + TextColumn::make('label') + ->label('Beschriftung') + ->searchable() + ->formatStateUsing(fn (string $state, NavigationItem $record): string => $record->parent_id !== null ? '↳ '.$state : $state) + ->description(fn (NavigationItem $record): ?string => $record->parent !== null ? 'Untermenü von „'.$record->parent->label.'“' : null), + TextColumn::make('target') + ->label('Ziel') + ->state(fn (NavigationItem $record): string => $record->page?->path ?? (string) $record->url), + IconColumn::make('is_visible') + ->label('Sichtbar') + ->boolean(), + TextColumn::make('sort_order')->label('Reihenfolge'), + ]) + ->defaultGroup( + Group::make('placement') + ->label('Platz') + ->getTitleFromRecordUsing(fn (NavigationItem $record): string => NavigationItem::PLACEMENTS[$record->placement] ?? $record->placement) + ->orderQueryUsing(fn ($query, string $direction) => $query->orderByRaw("CASE placement WHEN 'header' THEN 0 WHEN 'footer' THEN 1 WHEN 'footer_contact' THEN 2 WHEN 'footer_legal' THEN 3 ELSE 4 END")) + ->collapsible(), + ) + ->paginated([50, 100]) + ->defaultPaginationPageOption(50) + ->filters([ + SelectFilter::make('placement')->label('Platz')->options(NavigationItem::PLACEMENTS), + ]) + ->reorderable('sort_order') + ->reorderRecordsTriggerAction(fn (Action $action, bool $isReordering): Action => $action + ->button() + ->label($isReordering ? 'Sortieren beenden' : 'Reihenfolge ändern')) + ->defaultSort('sort_order') + ->recordActions([ + Action::make('toggleVisibility') + ->label(fn (NavigationItem $record): string => $record->is_visible ? 'Ausblenden' : 'Einblenden') + ->icon(fn (NavigationItem $record): string => $record->is_visible ? 'heroicon-o-eye-slash' : 'heroicon-o-eye') + ->color('gray') + ->authorize(fn (NavigationItem $record): bool => auth()->user()?->can('update', $record) ?? false) + ->action(fn (NavigationItem $record) => $record->update(['is_visible' => ! $record->is_visible])), + EditAction::make(), + DeleteAction::make() + ->modalDescription('Der Eintrag wird aus der Navigation entfernt. Die verlinkte Seite bleibt bestehen; Untereinträge rücken in die oberste Ebene.'), + ]); + } + + public static function getPages(): array + { + return [ + 'index' => ManageNavigationItems::route('/'), + ]; + } +} diff --git a/app/Filament/Resources/NavigationItems/Pages/ManageNavigationItems.php b/app/Filament/Resources/NavigationItems/Pages/ManageNavigationItems.php new file mode 100644 index 0000000..68544cc --- /dev/null +++ b/app/Filament/Resources/NavigationItems/Pages/ManageNavigationItems.php @@ -0,0 +1,23 @@ +redirect(Webpraesenz::getUrl(['bereich' => 'menues'])); + } +} diff --git a/app/Filament/Resources/Offers/OfferResource.php b/app/Filament/Resources/Offers/OfferResource.php new file mode 100644 index 0000000..c68cd4d --- /dev/null +++ b/app/Filament/Resources/Offers/OfferResource.php @@ -0,0 +1,79 @@ +components([ + Section::make('Positionen')->description('Was angeboten wird, mit welchem Rechteprofil.')->schema([ + TextEntry::make('positions')->hiddenLabel()->listWithLineBreaks() + ->state(fn (Offer $record): array => app(CatalogReading::class)->offerPositions($record)), + ]), + Section::make('Aufgelöste Berechtigungen')->description('Diese Artikel-Rechte entstehen beim Erwerb.')->schema([ + TextEntry::make('grants')->hiddenLabel()->listWithLineBreaks() + ->state(fn (Offer $record): array => app(CatalogReading::class)->offerGrants($record)), + ]), + ]); + } + + public static function form(Schema $schema): Schema + { + return $schema; + } + + public static function table(Table $table): Table + { + return $table->columns([ + TextColumn::make('name')->label('Name')->searchable(), + TextColumn::make('versions.status')->label('Fassungen')->badge(), + ]); + } + + public static function getPages(): array + { + return [ + 'index' => ListOffers::route('/'), + 'view' => ViewOffer::route('/{record}'), + ]; + } +} diff --git a/app/Filament/Resources/Offers/Pages/ListOffers.php b/app/Filament/Resources/Offers/Pages/ListOffers.php new file mode 100644 index 0000000..59bd3df --- /dev/null +++ b/app/Filament/Resources/Offers/Pages/ListOffers.php @@ -0,0 +1,111 @@ +label('Angebot anlegen') + ->modalHeading('Neues Angebot') + ->modalDescription('Der Name genügt. Positionen, Vergabe und Preis legst du danach am Angebot fest.') + ->modalSubmitActionLabel('Angebot anlegen') + ->schema([ + TextInput::make('name')->label('Name')->required(), + ])->action(function (array $data): void { + $offer = null; + $this->report(function () use ($data, &$offer): void { + $offer = app(OfferService::class)->create($data['name']); + }, 'Das Angebot ist angelegt.'); + + if ($offer instanceof Offer) { + $this->redirect(OfferResource::getUrl('view', ['record' => $offer])); + } + }), + ]; + } + + protected function catalogRows(): array + { + $rows = []; + + foreach (Offer::query()->with(['versions.lines.article', 'versions.lines.bundleVersion.bundle', 'versions.lines.rights.profile'])->orderBy('name')->get() as $offer) { + $versions = $offer->versions->sortByDesc('number'); + $active = $versions->first(fn ($version): bool => StatusValue::of($version->status) === OfferStatus::Aktiv->value); + $ended = $versions->filter(fn ($version): bool => StatusValue::of($version->status) === OfferStatus::Beendet->value)->count(); + $chips = []; + $zustand = []; + $text = ''; + + if ($active !== null) { + $chips[] = ['label' => 'Fassung '.$active->number.' aktiv', 'ton' => 'gut']; + $chips[] = ['label' => CatalogLabels::vergabe($active), 'ton' => 'neutral']; + $zustand[] = 'aktiv'; + $text = $active->lines->map(fn ($line): string => ($line->article !== null + ? 'Lizenzartikel '.$line->article->code + : 'Paket '.($line->bundleVersion?->bundle?->name ?? '–')).' · '.($line->rights?->profile?->name ?? ''))->implode('; '); + } else { + $chips[] = ['label' => 'Keine aktive Fassung', 'ton' => 'offen']; + $zustand[] = 'ohne'; + } + + if ($ended > 0) { + $chips[] = ['label' => $ended === 1 ? '1 beendete Fassung' : $ended.' beendete Fassungen', 'ton' => 'leise']; + } + + $url = OfferResource::getUrl('view', ['record' => $offer]); + $rows[] = [ + 'schluessel' => 'o'.$offer->id, + 'titel' => $offer->name, + 'meta' => 'Angebot', + 'text' => $text, + 'symbol' => 'etikett', + 'url' => $url, + 'chips' => $chips, + 'zustand' => $zustand, + 'aktionen' => [['label' => 'Öffnen', 'href' => $url]], + ]; + } + + return $rows; + } + + protected function zustandOptionen(): array + { + return ['alle' => 'Jeder Zustand', 'aktiv' => 'Mit aktiver Fassung', 'ohne' => 'Ohne aktive Fassung']; + } + + protected function einheit(): array + { + return ['Angebot', 'Angebote']; + } + + protected function leer(): array + { + return ['titel' => 'Noch keine Angebote', 'text' => 'Mit „Angebot anlegen“ oben entsteht das erste Angebot.']; + } +} diff --git a/app/Filament/Resources/Offers/Pages/ViewOffer.php b/app/Filament/Resources/Offers/Pages/ViewOffer.php new file mode 100644 index 0000000..4c39779 --- /dev/null +++ b/app/Filament/Resources/Offers/Pages/ViewOffer.php @@ -0,0 +1,283 @@ +getRecord()->name; + } + + public function getHeading(): string|Htmlable + { + return ''; + } + + public function getMaxContentWidth(): Width|string|null + { + return Width::Full; + } + + protected function getHeaderActions(): array + { + return []; + } + + /** + * Der gemeinsame Objektkopf zeigt den Pfad; Filaments eigener Pfad entfällt wie bei Medien und Aufbau. + * + * @return array + */ + public function getBreadcrumbs(): array + { + return []; + } + + public function infolist(Schema $schema): Schema + { + return $schema->components([ + View::make('filament.catalog.objekt')->viewData(fn (): array => $this->angebotDaten())->columnSpanFull(), + ])->columns(1); + } + + public function activeVersion(): ?OfferVersion + { + /** @var Offer $offer */ + $offer = $this->getRecord(); + + return $offer->versions() + ->where('status', OfferStatus::Aktiv) + ->orderByDesc('number') + ->with(['lines.article', 'lines.bundleVersion.bundle', 'lines.rights.profile']) + ->first(); + } + + public function activateAction(): Action + { + return Action::make('activate') + ->label(fn (): string => $this->activeVersion() !== null ? 'Geänderte Fassung aktivieren' : 'Fassung aktivieren') + ->modalHeading(fn (): string => $this->activeVersion() !== null + ? 'Angebot ändern: Fassung '.$this->nextNumber().' aktivieren' + : 'Erste Fassung aktivieren') + ->modalDescription(fn (): string => ($active = $this->activeVersion()) !== null + ? 'Die Maske ist mit Fassung '.$active->number.' vorbelegt; Inhaberart, Laufzeitregel und Steuerklasse werden übernommen. Beim Aktivieren wird Fassung '.$active->number.' beendet und bleibt unverändert gespeichert; neue Erwerbe nutzen Fassung '.$this->nextNumber().'. Bereits begründete Berechtigungen ändern sich dadurch nicht.' + : 'Positionen, Vergabe und Preis bilden die erste Fassung. Nach dem Aktivieren ist sie unveränderlich; Änderungen ergeben eine weitere Fassung.') + ->modalSubmitActionLabel(fn (): string => 'Fassung '.$this->nextNumber().' aktivieren') + ->modalWidth('4xl') + ->fillForm(fn (): array => $this->formFromActive()) + ->schema([ + Select::make('grant_kind')->label('Vergabe')->options([ + 'kauf' => 'Kauf', + 'auf_abruf' => 'Auf Abruf', + 'bei_registrierung' => 'Bei Registrierung', + ])->required(), + TextInput::make('price_cents')->label('Preis in Cent')->numeric() + ->helperText('Nur bei einem Kauf. 500 bedeutet 5,00 €.'), + Select::make('composition_version_id')->label('Programmfassung, die abgedeckt sein muss') + ->options(function (): array { + return CompositionVersion::query() + ->where('status', 'bereit') + ->with('composition.editorialContentKind') + ->orderByDesc('id') + ->get() + ->mapWithKeys(fn (CompositionVersion $version): array => [$version->id => CatalogOptions::compositionLabel($version)]) + ->all(); + }) + ->searchable() + ->helperText('Wenn gewählt, lässt sich die Fassung nur aktivieren, wenn jeder Bestandteil in den Artikeln enthalten ist.'), + Repeater::make('lines')->label('Positionen')->schema([ + Select::make('kind')->label('Ziel')->options([ + 'article' => 'Lizenzartikel', + 'bundle' => 'Paketfassung', + ])->required()->live(), + Select::make('article_id')->label('Artikel')->options(fn (): array => CatalogOptions::articles()) + ->visible(fn (Get $get): bool => $get('kind') === 'article'), + Select::make('bundle_version_id')->label('Paketfassung')->options(fn (): array => CatalogOptions::bundleVersions()) + ->visible(fn (Get $get): bool => $get('kind') === 'bundle'), + Select::make('rights_id')->label('Rechte')->options(fn (): array => CatalogOptions::rights())->required(), + ])->minItems(1)->addActionLabel('Position hinzufügen'), + ]) + ->action(function (array $data): void { + $this->report(function () use ($data): string { + /** @var Offer $offer */ + $offer = $this->getRecord(); + $lines = []; + + foreach ($data['lines'] as $line) { + $target = $line['kind'] === 'bundle' + ? BundleVersion::query()->findOrFail($line['bundle_version_id']) + : LicenseArticle::query()->findOrFail($line['article_id']); + $lines[] = [ + 'target' => $target, + 'rights' => RightsProfileVersion::query()->findOrFail($line['rights_id']), + ]; + } + + // Bedingungen, die die Maske nicht zeigt, bleiben bei einer Änderung die der aktiven Fassung; ohne + // aktive Fassung gilt wie bisher die Vorgabe (Personen, dauerhaft). + $active = $this->activeVersion(); + $kept = $active === null ? ['holder_kind' => 'person'] : [ + 'holder_kind' => $active->holder_kind, + 'term_rule' => $active->term_rule, + 'tax_class' => $active->tax_class, + 'dynamic' => (bool) $active->dynamic, + ]; + $version = app(OfferService::class)->activate($offer, $lines, [ + ...$kept, + 'grant_kind' => $data['grant_kind'], + 'price_cents' => $data['price_cents'] === null || $data['price_cents'] === '' ? null : (int) $data['price_cents'], + 'composition_version_id' => filled($data['composition_version_id'] ?? null) ? (int) $data['composition_version_id'] : null, + ]); + + return 'Fassung '.$version->number.' ist aktiv.'; + }, 'Die Angebotsfassung ist aktiv.'); + $this->getRecord()->unsetRelations(); + $this->getRecord()->refresh(); + }); + } + + /** + * Vorbelegung aus der aktiven Fassung; ohne aktive Fassung eine leere Position. + * + * @return array + */ + private function formFromActive(): array + { + $active = $this->activeVersion(); + + if ($active === null) { + return ['grant_kind' => 'kauf', 'lines' => [['kind' => 'article']]]; + } + + return [ + 'grant_kind' => $active->grant_kind, + 'price_cents' => $active->price_cents, + 'lines' => $active->lines->sortBy('position')->map(fn ($line): array => [ + 'kind' => $line->license_article_id !== null ? 'article' : 'bundle', + 'article_id' => $line->license_article_id, + 'bundle_version_id' => $line->bundle_version_id, + 'rights_id' => $line->rights_profile_version_id, + ])->values()->all(), + ]; + } + + private function nextNumber(): int + { + return ((int) $this->getRecord()->versions()->max('number')) + 1; + } + + /** + * Daten der gemeinsamen Katalog-Objektseite. + * + * @return array + */ + private function angebotDaten(): array + { + /** @var Offer $offer */ + $offer = $this->getRecord(); + $active = $this->activeVersion(); + $vergabe = $active !== null ? CatalogLabels::vergabe($active) : null; + + return [ + 'kopf' => [ + 'brot' => [['label' => 'Angebote', 'href' => OfferResource::getUrl('index')], $offer->name], + 'titel' => $offer->name, + 'typ' => 'Angebot', + 'status' => $active !== null + ? ['text' => 'Fassung '.$active->number.' aktiv · '.$vergabe, 'ton' => 'gut'] + : ['text' => 'Noch keine aktive Fassung. Ein Angebot ohne aktive Fassung kann niemand erwerben.', 'ton' => 'offen'], + 'aktionen' => [[ + 'label' => $active !== null ? 'Geänderte Fassung aktivieren' : 'Fassung aktivieren', + 'wire' => "mountAction('activate')", + 'art' => 'primary', + ]], + ], + 'haupt' => [ + [ + 'titel' => 'Positionen', + 'zusatz' => $active !== null ? 'Fassung '.$active->number : null, + 'hilfe' => $active !== null ? 'Vergabe: '.$vergabe.'. Diese Fassung ist unveränderlich; eine Änderung aktiviert die nächste Fassung.' : null, + 'zeilen' => $active === null ? [] : $active->lines->sortBy('position')->map(fn ($line): array => [ + 'text' => $line->article !== null ? 'Lizenzartikel '.$line->article->code : 'Paket '.($line->bundleVersion?->bundle?->name ?? '–').' · Fassung '.($line->bundleVersion?->number ?? '–'), + 'neben' => 'Rechte: '.($line->rights?->profile?->name ?? '–'), + ])->values()->all(), + 'leer' => ['titel' => 'Noch keine Positionen', 'text' => 'Mit „Fassung aktivieren“ legst du fest, welche Lizenzartikel oder Paketfassungen mit welchem Rechteprofil angeboten werden, wie vergeben wird und zu welchem Preis.'], + ], + ...($active !== null ? [[ + 'titel' => 'Aufgelöster Leistungsumfang', + 'hilfe' => 'Diese Artikel-Rechte entstehen beim Erwerb dieser Fassung.', + 'zeilen' => $this->leistungsumfang($active), + 'leer' => ['titel' => 'Kein Leistungsumfang', 'text' => 'Diese Fassung hat keinen aufgelösten Leistungsumfang.'], + ]] : []), + ], + 'seite' => [[ + 'titel' => 'Fassungen', + 'zeilen' => $offer->versions()->orderByDesc('number')->get()->map(fn (OfferVersion $version): array => [ + 'text' => 'Fassung '.$version->number, + 'zustand' => match (StatusValue::of($version->status)) { + 'aktiv' => ['label' => 'Aktiv', 'ton' => 'gut'], + 'beendet' => ['label' => 'Beendet', 'ton' => 'leise'], + default => ['label' => 'Entwurf', 'ton' => 'offen'], + }, + 'neben' => CatalogLabels::vergabe($version).($version->activated_at ? ' · aktiviert am '.$version->activated_at->format('d.m.Y') : ''), + ])->all(), + 'leer' => 'Noch keine Fassung.', + 'hilfe' => 'Beendete Fassungen bleiben gespeichert; Erwerbe verweisen auf ihre Fassung. Ob ein Angebot künftig auch als Vorlage für ein weiteres dienen soll, ist fachlich noch offen (OFF-04).', + ]], + ]; + } + + /** + * Aufgelöster Leistungsumfang in lesbaren Fähigkeiten (dieselben Bezeichnungen wie beim Rechteprofil). + * + * @return list + */ + private function leistungsumfang(OfferVersion $version): array + { + $zeilen = []; + + foreach ($version->resolvedScopes()->with(['article', 'rights.profile'])->get() as $scope) { + $faehigkeiten = CatalogLabels::faehigkeiten($scope->rights?->capabilities); + $zeilen[] = [ + 'text' => 'Lizenzartikel '.$scope->article?->code, + 'neben' => ($scope->rights?->profile?->name ?? '–').': '.($faehigkeiten === [] ? 'keine Fähigkeiten' : implode(', ', $faehigkeiten)), + ]; + } + + return $zeilen; + } +} diff --git a/app/Filament/Resources/Pages/PageResource.php b/app/Filament/Resources/Pages/PageResource.php new file mode 100644 index 0000000..5ca772e --- /dev/null +++ b/app/Filament/Resources/Pages/PageResource.php @@ -0,0 +1,149 @@ +components([ + Section::make('Seite und Suchmaschinen') + ->description('Adresse, Titel für Suchmaschinen und Zuordnung zu Themenbereichen.') + ->columns(2) + ->columnSpanFull() + ->extraAttributes(fn ($livewire): array => ['class' => self::registerClass($livewire, 'einstellungen')]) + ->schema([ + TextInput::make('path') + ->label('Pfad') + ->required() + ->maxLength(255) + ->helperText('Zum Beispiel / oder /praevention'), + TextInput::make('seo_title') + ->label('SEO-Titel') + ->maxLength(255), + Textarea::make('seo_description') + ->label('SEO-Beschreibung') + ->maxLength(500) + ->columnSpanFull(), + CheckboxList::make('pillars') + ->label('Fachliche Säulen') + ->options(fn (): array => Pillar::query()->orderBy('name')->pluck('name', 'id')->all()) + ->helperText('Eine veröffentlichte Seite erscheint auf den gewählten Themenbereichen der Website. Eine Seite kann mehreren Säulen zugeordnet sein.') + ->columns(['default' => 1, 'lg' => 2]), + ]), + Section::make('Inhalt der Seite') + ->description(fn ($livewire): string => is_object($livewire) && method_exists($livewire, 'openAbschnitt') + ? 'Seitenaufbau: Plätze und Bausteine im Rasterverhältnis der Website. „Abschnitt gestalten“ öffnet Raster, Breite, Hintergrund, Abstände und Trenner; ein Klick auf einen Baustein öffnet seine Konfiguration. Gesichert wird mit „Entwurf speichern“, veröffentlicht erst über „Veröffentlichen …“.' + : 'Abschnitt hinzufügen, Raster wählen, Widgets in die Plätze einsetzen. Ein Klick auf die Vorschau eines Widgets öffnet seinen Dialog; Hintergrund, Breite, Abstand und Trenner stehen unter „Gestaltung des Abschnitts“. Speichern legt einen Entwurf an; veröffentlicht wird erst über „Veröffentlichen“.') + ->columnSpanFull() + ->extraAttributes(fn ($livewire): array => ['class' => 'luf-page-content '.self::registerClass($livewire, 'inhalt')]) + ->schema([ + SectionEditor::repeater('sections'), + ]), + ]); + } + + /** + * Im Seiten-Arbeitsplatz (EditPage) zeigt jedes Register nur seinen Teil; ausgeblendete Felder bleiben im + * Formularzustand und werden mitgespeichert. Beim Anlegen ist alles sichtbar. + */ + public static function registerClass(mixed $livewire, string $register): string + { + return is_object($livewire) && property_exists($livewire, 'register') && $livewire->register !== $register ? 'vw-ausgeblendet' : ''; + } + + public static function table(Table $table): Table + { + return $table + // Zuletzt bearbeitete Seiten zuerst; jede Seite ist ohne Suche auffindbar (Spalten sortierbar, bis 100 je Seite). + ->columns([ + TextColumn::make('path')->label('Pfad')->searchable()->sortable(), + TextColumn::make('published_revision_id') + ->label('Veröffentlicht') + ->formatStateUsing(fn ($state): string => $state ? 'Ja' : 'Entwurf'), + TextColumn::make('updated_at') + ->label('Zuletzt bearbeitet') + ->dateTime('d.m.Y H:i', timezone: 'Europe/Berlin') + ->sortable(), + ]) + ->defaultSort('updated_at', 'desc') + ->paginated([25, 50, 100]) + ->defaultPaginationPageOption(25) + ->recordUrl(fn (Page $record): string => static::getUrl('edit', ['record' => $record])) + ->recordActions([ + Action::make('duplicate') + ->label('Duplizieren') + ->icon('heroicon-o-document-duplicate') + ->color('gray') + ->tooltip('Neue, unveröffentlichte Seite mit dem zuletzt gespeicherten Stand dieser Seite anlegen') + ->authorize(fn (): bool => auth()->user()?->can('create', Page::class) ?? false) + ->modalHeading(fn (Page $record): string => 'Seite '.$record->path.' duplizieren') + ->modalDescription('Die Kopie ist ein Entwurf unter neuer Adresse. Die Vorlage bleibt unverändert.') + ->schema([ + TextInput::make('path') + ->label('Pfad der neuen Seite') + ->required() + ->maxLength(255) + ->helperText('Zum Beispiel /neue-landingpage'), + ]) + ->modalSubmitActionLabel('Duplizieren') + ->action(function (Page $record, array $data, PageService $service) { + try { + $copy = $service->duplicate($record, $data['path'], auth()->user()); + } catch (ValidationException $exception) { + throw ValidationException::withMessages(['mountedActions.0.data.path' => $exception->errors()['path'] ?? $exception->errors()]); + } + + return redirect(static::getUrl('edit', ['record' => $copy])); + }), + ]); + } + + public static function getRelations(): array + { + return [ + RevisionsRelationManager::class, + ]; + } + + public static function getPages(): array + { + return [ + 'index' => ListPages::route('/'), + 'create' => CreatePage::route('/create'), + 'edit' => EditPage::route('/{record}/edit'), + ]; + } +} diff --git a/app/Filament/Resources/Pages/Pages/CreatePage.php b/app/Filament/Resources/Pages/Pages/CreatePage.php new file mode 100644 index 0000000..e1bc637 --- /dev/null +++ b/app/Filament/Resources/Pages/Pages/CreatePage.php @@ -0,0 +1,79 @@ + $data + */ + protected function handleRecordCreation(array $data): Model + { + $service = app(PageService::class); + $content = SectionEditor::fromEditorState($data['sections'] ?? []); + + try { + return DB::transaction(function () use ($service, $data, $content): Page { + $page = Page::query()->create([ + 'path' => $service->availablePath($data['path']), + ]); + + $service->saveRevision( + $page, + $content, + $data['seo_title'] ?? null, + $data['seo_description'] ?? null, + auth()->user(), + ); + + app(PillarService::class)->assignPages($page, array_map(intval(...), $data['pillars'] ?? [])); + + return $page; + }); + } catch (ValidationException $exception) { + SectionEditor::notifyErrors($exception->errors(), $this->data['sections'] ?? []); + + throw ValidationException::withMessages( + SectionEditor::mapErrors($exception->errors(), $this->data['sections'] ?? []), + ); + } + } + + protected function getRedirectUrl(): string + { + return static::getResource()::getUrl('edit', ['record' => $this->getRecord()]); + } +} diff --git a/app/Filament/Resources/Pages/Pages/EditPage.php b/app/Filament/Resources/Pages/Pages/EditPage.php new file mode 100644 index 0000000..a480415 --- /dev/null +++ b/app/Filament/Resources/Pages/Pages/EditPage.php @@ -0,0 +1,328 @@ +register = in_array($register, ['inhalt', 'einstellungen', 'verlauf'], true) ? $register : 'inhalt'; + $this->abschnitt = null; + } + + public function openAbschnitt(string $key): void + { + $index = array_search($key, array_map('strval', array_keys($this->data['sections'] ?? [])), true); + + if ($index === false) { + return; + } + + $this->register = 'inhalt'; + $this->abschnitt = (int) $index; + $this->js('window.scrollTo({ top: 0 })'); + } + + /** + * Zurück zum Seitenaufbau, an die Stelle des gestalteten Abschnitts (Fokus auf „Abschnitt gestalten“). + */ + public function closeAbschnitt(): void + { + $key = $this->abschnittSchluessel(); + $this->abschnitt = null; + + if ($key !== null) { + $selector = json_encode('.luf-sections [x-sortable-item="'.$key.'"]'); + $this->js("requestAnimationFrame(() => requestAnimationFrame(() => { const el = document.querySelector($selector); if (! el) return; window.scrollTo({ top: el.getBoundingClientRect().top + window.scrollY - 96 }); [...el.querySelectorAll('button')].find((b) => b.textContent.includes('Abschnitt gestalten'))?.focus({ preventScroll: true }); }))"); + } + } + + /** + * Repeater-Schlüssel des gestalteten Abschnitts, aufgelöst zur Laufzeit. + */ + public function abschnittSchluessel(): ?string + { + if ($this->abschnitt === null) { + return null; + } + + $keys = array_map('strval', array_keys($this->data['sections'] ?? [])); + + return $keys[$this->abschnitt] ?? null; + } + + /** + * Gemeinsamer Objektkopf statt Filaments Titel, Pfad und Kopfaktionen. + */ + public function getHeader(): ?View + { + return view('filament.cms.seite-kopf', ['seite' => $this->record, 'ungespeichert' => $this->hasUnsavedEditorChanges()]); + } + + /** + * Weicht der Editorstand vom geladenen oder gespeicherten Stand ab? Verglichen wird derselbe normalisierte + * Zustand, der auch gespeichert würde; Vorschaubreiten zählen nicht. + */ + public function hasUnsavedEditorChanges(): bool + { + return $this->gespeicherterStand !== '' && $this->editorFingerprint() !== $this->gespeicherterStand; + } + + protected function afterFill(): void + { + $this->gespeicherterStand = $this->editorFingerprint(); + } + + private function editorFingerprint(): string + { + $data = is_array($this->data ?? null) ? $this->data : []; + $pillars = array_map('intval', (array) ($data['pillars'] ?? [])); + sort($pillars); + + return md5(json_encode([ + self::withoutPreviewKeys(SectionEditor::fromEditorState(is_array($data['sections'] ?? null) ? $data['sections'] : [])), + (string) ($data['path'] ?? ''), + (string) ($data['seo_title'] ?? ''), + (string) ($data['seo_description'] ?? ''), + $pillars, + ], JSON_UNESCAPED_UNICODE) ?: ''); + } + + private static function withoutPreviewKeys(mixed $value): mixed + { + if (! is_array($value)) { + return $value; + } + + unset($value['_preview_width']); + + return array_map(self::withoutPreviewKeys(...), $value); + } + + /** + * Formular und Verlauf (Revisionen) als Register; ausgeblendete Teile bleiben im Formularzustand. + */ + public function content(Schema $schema): Schema + { + return $schema->components([ + $this->getFormContentComponent(), + Group::make([$this->getRelationManagersContentComponent()]) + ->extraAttributes(fn (): array => ['class' => $this->register === 'verlauf' ? '' : 'vw-ausgeblendet']), + ]); + } + + /** + * Speichern steht im Kopf; die Leiste unter dem Formular entfällt. + */ + protected function getFormActions(): array + { + return []; + } + + /** + * Ein Fehler in einem gerade ausgeblendeten Register oder Abschnittsteil wird sichtbar gemacht (CMS-12). + */ + public function save(bool $shouldRedirect = true, bool $shouldSendSavedNotification = true): void + { + try { + parent::save($shouldRedirect, $shouldSendSavedNotification); + } catch (ValidationException $exception) { + $keys = implode(' ', array_keys($exception->errors())); + $this->register = str_contains($keys, 'data.sections') ? 'inhalt' : (preg_match('/data\.(path|seo_|pillars)/', $keys) === 1 ? 'einstellungen' : $this->register); + $this->showFailingSection(array_keys($exception->errors())); + + throw $exception; + } + } + + /** + * Raster und Gestaltung stehen nur im Kontext „Abschnitt gestalten“, andere Abschnitte sind dort ausgeblendet. + * Liegt der Fehler im gestalteten Abschnitt, bleibt der Kontext. Ein Raster- oder Gestaltungsfehler öffnet den + * betroffenen Abschnitt; jeder andere Abschnittsfehler (etwa die Platzübersicht) steht im Seitenaufbau. + * + * @param list $errorKeys + */ + private function showFailingSection(array $errorKeys): void + { + $sectionKeys = array_map('strval', array_keys($this->data['sections'] ?? [])); + $failing = []; + $design = null; + + foreach ($errorKeys as $key) { + if (preg_match('/^data\.sections\.([^.]+)(?:\.(.*))?$/', $key, $match) !== 1) { + continue; + } + + $index = array_search($match[1], $sectionKeys, true); + if ($index === false) { + continue; + } + + $failing[] = $index; + if ($design === null && preg_match('/^(layout|style)(\.|$)/', $match[2] ?? '') === 1) { + $design = $index; + } + } + + if ($failing === [] || ($this->abschnitt !== null && in_array($this->abschnitt, $failing, true))) { + return; + } + + $this->abschnitt = $design; + } + + /** + * „Entwurf speichern“ aus dem Bausteindialog: Der Baustein ist bereits übernommen, der Dialog schließt. Ein Fehler + * wird wie beim Speichern im Kopf gezeigt (Register, Abschnitt, Meldung), ohne den Baustein erneut zu öffnen. + */ + public function saveFromBlock(): void + { + // Nach einer Dialogaktion rendert Filament sonst nur den Dialog neu; der Kopf zeigte den alten Speicherstand. + $this->forceRender(); + + try { + $this->save(shouldRedirect: false); + } catch (ValidationException $exception) { + foreach ($exception->errors() as $key => $messages) { + foreach ((array) $messages as $message) { + $this->addError($key, $message); + } + } + } + } + + protected function getHeaderActions(): array + { + return []; + } + + public function publishAction(): Action + { + return Action::make('publish') + ->label('Veröffentlichen') + ->icon('heroicon-o-globe-alt') + ->requiresConfirmation() + ->modalHeading('Seite veröffentlichen?') + ->modalDescription('Der aktuelle Stand im Editor wird als Entwurf gespeichert und genau dieser Stand wird veröffentlicht. Enthält er Fehler, wird nichts veröffentlicht.') + ->modalSubmitActionLabel('Speichern und veröffentlichen') + ->visible(fn (): bool => auth()->user()?->can('publish', $this->record) ?? false) + ->action(function (PageService $service): void { + // Ungespeicherte Änderungen (zum Beispiel ein eben gewähltes Bild) gingen sonst beim Veröffentlichen verloren. + $this->save(shouldRedirect: false, shouldSendSavedNotification: false); + + $this->record->unsetRelation('latestRevision'); + $revision = $this->record->latestRevision; + abort_if($revision === null, 404); + $service->publish($this->record, $revision); + $this->record->refresh(); + + Notification::make()->title('Seite veröffentlicht')->success()->send(); + }); + } + + protected function getSaveFormAction(): Action + { + return parent::getSaveFormAction()->label('Entwurf speichern'); + } + + protected function getSavedNotificationTitle(): ?string + { + return 'Entwurf gespeichert. Die Live-Seite bleibt unverändert, bis Sie veröffentlichen.'; + } + + /** + * Nach dem Speichern den Editor aus der gespeicherten Revision neu befüllen, damit duplizierte + * Abschnitte ihre beim Speichern vergebene Kennung behalten. + */ + protected function afterSave(): void + { + $this->record->unsetRelation('latestRevision'); + $this->fillForm(); + } + + /** + * @param array $data + * @return array + */ + protected function mutateFormDataBeforeFill(array $data): array + { + $revision = $this->record->latestRevision ?? $this->record->publishedRevision; + $data['sections'] = SectionEditor::toEditorState($revision?->sections() ?? []); + $data['seo_title'] = $revision?->seo_title; + $data['seo_description'] = $revision?->seo_description; + $data['pillars'] = $this->record->pillars()->pluck('pillars.id')->all(); + + return $data; + } + + /** + * @param array $data + */ + protected function handleRecordUpdate(Model $record, array $data): Model + { + /** @var Page $record */ + $service = app(PageService::class); + $content = SectionEditor::fromEditorState($data['sections'] ?? []); + + try { + $path = $service->availablePath($data['path'], $record); + $service->saveRevision($record, $content, $data['seo_title'] ?? null, $data['seo_description'] ?? null, auth()->user()); + } catch (ValidationException $exception) { + SectionEditor::notifyErrors($exception->errors(), $this->data['sections'] ?? []); + + throw ValidationException::withMessages( + SectionEditor::mapErrors($exception->errors(), $this->data['sections'] ?? []), + ); + } + + $record->update([ + 'path' => $path, + ]); + app(PillarService::class)->assignPages($record, array_map(intval(...), $data['pillars'] ?? [])); + + return $record; + } +} diff --git a/app/Filament/Resources/Pages/Pages/ListPages.php b/app/Filament/Resources/Pages/Pages/ListPages.php new file mode 100644 index 0000000..f077d61 --- /dev/null +++ b/app/Filament/Resources/Pages/Pages/ListPages.php @@ -0,0 +1,23 @@ +redirect(Webpraesenz::getUrl()); + } +} diff --git a/app/Filament/Resources/Pages/RelationManagers/RevisionsRelationManager.php b/app/Filament/Resources/Pages/RelationManagers/RevisionsRelationManager.php new file mode 100644 index 0000000..6be0f39 --- /dev/null +++ b/app/Filament/Resources/Pages/RelationManagers/RevisionsRelationManager.php @@ -0,0 +1,70 @@ +columns([ + TextColumn::make('id')->label('Nr.'), + TextColumn::make('created_at')->label('Gespeichert')->dateTime('d.m.Y H:i'), + TextColumn::make('author.name')->label('Von'), + TextColumn::make('section_count') + ->label('Abschnitte') + ->state(fn (PageRevision $record): int => count($record->sections())), + TextColumn::make('widget_count') + ->label('Widgets') + ->state(fn (PageRevision $record): int => count($record->widgets())), + TextColumn::make('published') + ->label('Live') + ->badge() + ->color(fn (string $state): string => $state === 'Ja' ? 'success' : 'gray') + ->state(fn (PageRevision $record): string => $record->id === $this->getOwnerRecord()->published_revision_id ? 'Ja' : 'Nein'), + ]) + ->recordActions([ + Action::make('preview') + ->label('Vorschau') + ->icon('heroicon-o-eye') + ->color('gray') + ->url(fn (PageRevision $record): string => route('pages.preview.devices', $record)) + ->openUrlInNewTab(), + Action::make('publish') + ->label('Veröffentlichen') + ->requiresConfirmation() + ->visible(fn (): bool => auth()->user()?->can('publish', $this->getOwnerRecord()) ?? false) + ->action(function (PageRevision $record, PageService $service): void { + $service->publish($this->getOwnerRecord(), $record); + $this->getOwnerRecord()->refresh(); + Notification::make()->title('Revision '.$record->id.' ist jetzt live.')->success()->send(); + }), + Action::make('restore') + ->label('Wiederherstellen') + ->requiresConfirmation() + ->modalDescription('Es entsteht eine neue Revision mit diesem Stand. Die Live-Seite bleibt unverändert, bis sie veröffentlicht wird.') + ->action(function (PageRevision $record, PageService $service): void { + $restored = $service->restore($this->getOwnerRecord(), $record, auth()->user()); + Notification::make()->title('Als neue Revision '.$restored->id.' wiederhergestellt.')->success()->send(); + $this->redirect(PageResource::getUrl('edit', ['record' => $this->getOwnerRecord()])); + }), + ]) + ->defaultSort('id', 'desc'); + } +} diff --git a/app/Filament/Resources/Pillars/Pages/EditPillar.php b/app/Filament/Resources/Pillars/Pages/EditPillar.php new file mode 100644 index 0000000..3c14556 --- /dev/null +++ b/app/Filament/Resources/Pillars/Pages/EditPillar.php @@ -0,0 +1,72 @@ +label('Löschen') + ->color('danger') + ->requiresConfirmation() + ->action(function (): void { + /** @var Pillar $pillar */ + $pillar = $this->getRecord(); + $deleted = false; + $this->report(function () use ($pillar, &$deleted): void { + app(PillarService::class)->delete($pillar); + $deleted = true; + }, 'Die Säule ist gelöscht.'); + + if ($deleted) { + $this->redirect(PillarResource::getUrl('index')); + } + }), + ]; + } + + protected function mutateFormDataBeforeFill(array $data): array + { + $data['published'] = $this->getRecord()->published_at !== null; + + return $data; + } + + protected function handleRecordUpdate(Model $record, array $data): Model + { + /** @var Pillar $record */ + try { + app(PillarService::class)->present( + $record, + (string) $data['name'], + (string) ($data['slug'] ?? ''), + $data['public_summary'] ?? null, + (bool) ($data['published'] ?? false), + (int) ($data['sort_order'] ?? 0), + ); + } catch (DomainRuleException $exception) { + Notification::make()->title($exception->getMessage())->danger()->send(); + + throw new Halt; + } + + return $record; + } +} diff --git a/app/Filament/Resources/Pillars/Pages/ListPillars.php b/app/Filament/Resources/Pillars/Pages/ListPillars.php new file mode 100644 index 0000000..80122d7 --- /dev/null +++ b/app/Filament/Resources/Pillars/Pages/ListPillars.php @@ -0,0 +1,93 @@ +label('Säule anlegen') + ->modalHeading('Neue fachliche Säule') + ->modalDescription('Der Name genügt. Website-Text, Adresse und Veröffentlichung legst du danach fest.') + ->modalSubmitActionLabel('Säule anlegen') + ->visible(fn (): bool => ContentElementResource::editor()) + ->schema([ + TextInput::make('name')->label('Name')->required(), + ]) + ->action(function (array $data): void { + $pillar = null; + $this->report(function () use ($data, &$pillar): void { + $pillar = app(PillarService::class)->create($data['name']); + }, 'Die Säule ist angelegt.'); + + if ($pillar !== null) { + $this->redirect(PillarResource::getUrl('edit', ['record' => $pillar])); + } + }), + ]; + } + + protected function catalogRows(): array + { + $rows = []; + + foreach (Pillar::query()->withCount('elements')->orderBy('sort_order')->orderBy('name')->get() as $pillar) { + $public = $pillar->published_at !== null; + $url = PillarResource::getUrl('edit', ['record' => $pillar]); + $rows[] = [ + 'schluessel' => 's'.$pillar->id, + 'titel' => $pillar->name, + 'meta' => 'Fachliche Säule'.(filled($pillar->slug) ? ' · /themen/'.$pillar->slug : ''), + 'text' => (string) ($pillar->public_summary ?? ''), + 'symbol' => 'modul', + 'url' => $url, + 'chips' => [ + $public ? ['label' => 'Auf der Website veröffentlicht', 'ton' => 'gut'] : ['label' => 'Intern', 'ton' => 'leise'], + ['label' => $pillar->elements_count === 1 ? '1 Medium' : $pillar->elements_count.' Medien', 'ton' => 'neutral'], + ], + 'zustand' => [$public ? 'oeffentlich' : 'intern'], + 'aktionen' => [['label' => 'Bearbeiten', 'href' => $url, 'icon' => 'stift']], + ]; + } + + return $rows; + } + + protected function zustandOptionen(): array + { + return ['alle' => 'Jeder Zustand', 'oeffentlich' => 'Auf der Website veröffentlicht', 'intern' => 'Intern']; + } + + protected function einheit(): array + { + return ['Fachliche Säule', 'Fachliche Säulen']; + } + + protected function leer(): array + { + return ['titel' => 'Noch keine Säulen', 'text' => 'Mit „Säule anlegen“ oben entsteht die erste Säule.']; + } +} diff --git a/app/Filament/Resources/Pillars/PillarResource.php b/app/Filament/Resources/Pillars/PillarResource.php new file mode 100644 index 0000000..c7c0e16 --- /dev/null +++ b/app/Filament/Resources/Pillars/PillarResource.php @@ -0,0 +1,78 @@ +components([ + TextInput::make('name')->label('Name')->required(), + TextInput::make('slug')->label('Öffentliche Adresse')->required() + ->helperText('Ergibt die Seite /themen/adresse. Eine Änderung verschiebt die öffentliche Adresse.'), + Textarea::make('public_summary')->label('Text für die Website')->rows(5) + ->helperText('Dieser Text erscheint auf der Website. Die zugeordneten Medien bleiben privat.'), + TextInput::make('sort_order')->label('Reihenfolge')->numeric()->minValue(0)->required()->default(0), + Toggle::make('published')->label('Auf der Website veröffentlichen'), + ]); + } + + public static function table(Table $table): Table + { + return $table->columns([ + TextColumn::make('name')->label('Name')->searchable(), + TextColumn::make('public_state')->label('Website')->state( + fn (Pillar $record): string => $record->published_at === null ? 'intern' : 'veröffentlicht' + ), + TextColumn::make('elements_count')->counts('elements')->label('Medien'), + ]); + } + + public static function getPages(): array + { + return [ + 'index' => ListPillars::route('/'), + 'edit' => EditPillar::route('/{record}'), + ]; + } +} diff --git a/app/Filament/Resources/RightsProfiles/Pages/ListRightsProfiles.php b/app/Filament/Resources/RightsProfiles/Pages/ListRightsProfiles.php new file mode 100644 index 0000000..b06f580 --- /dev/null +++ b/app/Filament/Resources/RightsProfiles/Pages/ListRightsProfiles.php @@ -0,0 +1,107 @@ +label('Rechteprofil anlegen') + ->modalHeading('Neues Rechteprofil') + ->modalDescription('Zweck und erlaubte Handlungen. Ein Angebot verbindet das Profil später mit Artikeln.') + ->modalSubmitActionLabel('Rechteprofil anlegen') + ->schema([ + TextInput::make('name')->label('Name')->required(), + Select::make('purpose')->label('Zweck')->options([ + 'ehrenamtlich' => 'Ehrenamtlich', + 'kommerziell' => 'Kommerziell', + 'institutionell' => 'Institutionell', + ])->required(), + CheckboxList::make('capabilities')->label('Fähigkeiten')->options(CatalogLabels::FAEHIGKEITEN)->required(), + ])->action(function (array $data): void { + $this->report(function () use ($data): void { + $capabilities = []; + + foreach ($data['capabilities'] as $entry) { + [$class, $action] = explode(':', $entry, 2); + $capabilities[$class][] = $action; + } + + app(OfferService::class)->createRightsProfile($data['name'], $data['purpose'], $capabilities); + }, 'Das Rechteprofil ist angelegt.'); + }), + ]; + } + + protected function catalogRows(): array + { + $rows = []; + + foreach (RightsProfile::query()->with('versions')->orderBy('name')->get() as $profile) { + $version = $profile->versions->sortByDesc('number')->first(); + $faehigkeiten = CatalogLabels::faehigkeiten($version?->capabilities); + $purpose = CatalogLabels::zweck($version?->purpose); + $chips = $version === null + ? [['label' => 'Noch keine Fassung', 'ton' => 'offen']] + : [['label' => 'Fassung '.$version->number, 'ton' => 'neutral'], ['label' => $purpose, 'ton' => 'leise']]; + + if ($version?->locked_at !== null) { + $chips[] = ['label' => 'Festgeschrieben', 'ton' => 'leise']; + } + + $url = RightsProfileResource::getUrl('view', ['record' => $profile]); + $rows[] = [ + 'schluessel' => 'r'.$profile->id, + 'titel' => $profile->name, + 'meta' => 'Rechteprofil', + 'text' => $faehigkeiten === [] ? 'Keine Fähigkeiten' : implode(', ', $faehigkeiten), + 'symbol' => 'schluessel', + 'url' => $url, + 'chips' => $chips, + 'zustand' => [(string) $version?->purpose], + 'aktionen' => [['label' => 'Öffnen', 'href' => $url]], + ]; + } + + return $rows; + } + + protected function zustandOptionen(): array + { + return ['alle' => 'Jeder Zweck', 'ehrenamtlich' => 'Ehrenamtlich', 'kommerziell' => 'Kommerziell', 'institutionell' => 'Institutionell']; + } + + protected function einheit(): array + { + return ['Rechteprofil', 'Rechteprofile']; + } + + protected function leer(): array + { + return ['titel' => 'Noch keine Rechteprofile', 'text' => 'Mit „Rechteprofil anlegen“ oben entsteht das erste Profil.']; + } +} diff --git a/app/Filament/Resources/RightsProfiles/Pages/ViewRightsProfile.php b/app/Filament/Resources/RightsProfiles/Pages/ViewRightsProfile.php new file mode 100644 index 0000000..e127138 --- /dev/null +++ b/app/Filament/Resources/RightsProfiles/Pages/ViewRightsProfile.php @@ -0,0 +1,120 @@ +getRecord()->name; + } + + public function getHeading(): string|Htmlable + { + return ''; + } + + /** + * @return array + */ + public function getBreadcrumbs(): array + { + return []; + } + + public function getMaxContentWidth(): Width|string|null + { + return Width::Full; + } + + public function infolist(Schema $schema): Schema + { + return $schema->components([ + View::make('filament.catalog.objekt')->viewData(fn (): array => $this->profilDaten())->columnSpanFull(), + ])->columns(1); + } + + /** + * @return array + */ + private function profilDaten(): array + { + /** @var RightsProfile $profile */ + $profile = $this->getRecord(); + $versions = $profile->versions()->orderByDesc('number')->get(); + $current = $versions->first(); + $faehigkeiten = CatalogLabels::faehigkeiten($current?->capabilities); + $optionen = collect($current?->options ?? [])->map(fn (mixed $wert, string $schluessel): array => [ + 'text' => $schluessel, + 'neben' => is_scalar($wert) ? (string) $wert : json_encode($wert, JSON_UNESCAPED_UNICODE), + ])->values()->all(); + $verwendung = OfferLine::query() + ->whereIn('rights_profile_version_id', $versions->pluck('id')) + ->with(['offerVersion.offer', 'article', 'bundleVersion.bundle']) + ->get() + ->map(fn (OfferLine $line): array => [ + 'text' => ($line->offerVersion?->offer?->name ?? 'Angebot').' · Fassung '.($line->offerVersion?->number ?? '–'), + 'zustand' => StatusValue::of($line->offerVersion?->status) === OfferStatus::Aktiv->value + ? ['label' => 'Aktiv', 'ton' => 'gut'] + : ['label' => StatusValue::of($line->offerVersion?->status) === OfferStatus::Beendet->value ? 'Beendet' : 'Entwurf', 'ton' => 'leise'], + 'neben' => $line->article !== null ? 'Lizenzartikel '.$line->article->code : 'Paket '.($line->bundleVersion?->bundle?->name ?? '–'), + ])->all(); + + return [ + 'kopf' => [ + 'brot' => [['label' => 'Rechteprofile', 'href' => RightsProfileResource::getUrl('index')], $profile->name], + 'titel' => $profile->name, + 'typ' => 'Rechteprofil', + 'status' => $current === null + ? ['text' => 'Noch keine Fassung', 'ton' => 'offen'] + : ['text' => 'Fassung '.$current->number.' · '.CatalogLabels::zweck($current->purpose).($current->locked_at !== null ? ' · festgeschrieben seit '.$current->locked_at->format('d.m.Y') : ''), 'ton' => 'neutral'], + ], + 'haupt' => [ + [ + 'titel' => 'Erlaubte Handlungen', + 'zusatz' => $current !== null ? 'Fassung '.$current->number : null, + 'hilfe' => $current?->locked_at !== null + ? 'Diese Fassung wird in einem aktiven Angebot verwendet und ist deshalb unveränderlich.' + : 'Zweck und erlaubte Handlungen. Angebote verbinden das Profil mit Lizenzartikeln.', + 'zeilen' => array_map(fn (string $label): array => ['text' => $label], $faehigkeiten), + 'leer' => ['titel' => 'Keine Handlungen', 'text' => 'Diese Fassung erlaubt keine Handlung.'], + ], + ...($optionen !== [] ? [['titel' => 'Optionen', 'zeilen' => $optionen]] : []), + ], + 'seite' => [ + [ + 'titel' => 'In Angeboten', + 'zeilen' => $verwendung, + 'leer' => 'In keinem Angebot verwendet.', + ], + [ + 'titel' => 'Fassungen', + 'zeilen' => $versions->map(fn (RightsProfileVersion $version): array => [ + 'text' => 'Fassung '.$version->number, + 'zustand' => $version->locked_at !== null ? ['label' => 'Festgeschrieben', 'ton' => 'leise'] : null, + 'neben' => CatalogLabels::zweck($version->purpose), + ])->all(), + ], + ], + ]; + } +} diff --git a/app/Filament/Resources/RightsProfiles/RightsProfileResource.php b/app/Filament/Resources/RightsProfiles/RightsProfileResource.php new file mode 100644 index 0000000..0e35701 --- /dev/null +++ b/app/Filament/Resources/RightsProfiles/RightsProfileResource.php @@ -0,0 +1,75 @@ +components([ + Section::make('Fähigkeiten')->description('Zweck und erlaubte Handlungen. Angebote verwenden diese Fassung.')->schema([ + TextEntry::make('rights')->hiddenLabel()->listWithLineBreaks() + ->state(fn (RightsProfile $record): array => app(CatalogReading::class)->rights($record)), + ]), + ]); + } + + public static function form(Schema $schema): Schema + { + return $schema; + } + + public static function table(Table $table): Table + { + return $table->columns([ + TextColumn::make('name')->label('Name')->searchable(), + TextColumn::make('versions.purpose')->label('Zwecke')->badge(), + ]); + } + + public static function getPages(): array + { + return [ + 'index' => ListRightsProfiles::route('/'), + 'view' => ViewRightsProfile::route('/{record}'), + ]; + } +} diff --git a/app/Filament/Resources/Users/Pages/CreateUser.php b/app/Filament/Resources/Users/Pages/CreateUser.php new file mode 100644 index 0000000..ab9c5eb --- /dev/null +++ b/app/Filament/Resources/Users/Pages/CreateUser.php @@ -0,0 +1,20 @@ + $data + */ + protected function handleRecordCreation(array $data): Model + { + return UserResource::persist(new ($this->getModel()), $data, true); + } +} diff --git a/app/Filament/Resources/Users/Pages/EditUser.php b/app/Filament/Resources/Users/Pages/EditUser.php new file mode 100644 index 0000000..873e28e --- /dev/null +++ b/app/Filament/Resources/Users/Pages/EditUser.php @@ -0,0 +1,71 @@ +label('Berechtigung vergeben') + ->visible(function (): bool { + $actor = Filament::auth()->user(); + + return $actor instanceof User && $actor->hasStaffRole(StaffRole::Kundenbetreuung); + }) + ->schema([ + Select::make('offer_id')->label('Angebot')->options(fn (): array => CatalogOptions::offers())->required(), + Textarea::make('reason')->label('Begründung')->required(), + ]) + ->action(function (array $data): void { + $this->report(function () use ($data): void { + app(GrantIssuer::class)->grantManually( + $this->record, + Offer::query()->findOrFail($data['offer_id']), + Filament::auth()->user(), + $data['reason'], + ); + }, 'Die Berechtigung ist vergeben.'); + }), + ]; + } + + /** + * @param array $data + * @return array + */ + protected function mutateFormDataBeforeFill(array $data): array + { + $data['roles'] = $this->record->staffRoles->map(fn ($assignment) => $assignment->role->value)->all(); + $data['status'] = $this->record->status->value; + + return $data; + } + + /** + * @param array $data + */ + protected function handleRecordUpdate(Model $record, array $data): Model + { + return UserResource::persist($record, $data, false); + } +} diff --git a/app/Filament/Resources/Users/Pages/ListUsers.php b/app/Filament/Resources/Users/Pages/ListUsers.php new file mode 100644 index 0000000..0569352 --- /dev/null +++ b/app/Filament/Resources/Users/Pages/ListUsers.php @@ -0,0 +1,71 @@ +label('Benutzer anlegen'), + ]; + } + + protected function catalogRows(): array + { + $rows = []; + + foreach (User::query()->with('staffRoles')->orderBy('name')->get() as $user) { + $status = $user->status instanceof AccountStatus ? $user->status->label() : (string) $user->status; + $rollen = $user->staffRoles->map(fn ($role): string => $role->role instanceof StaffRole ? $role->role->label() : StaffRole::from((string) $role->role)->label())->all(); + $url = UserResource::getUrl('edit', ['record' => $user]); + $rows[] = [ + 'schluessel' => 'u'.$user->id, + 'titel' => (string) $user->name, + 'meta' => (string) $user->email, + 'symbol' => 'schluessel', + 'url' => $url, + 'chips' => [ + ['label' => $status !== '' ? $status : 'Ohne Status', 'ton' => 'neutral'], + ...array_map(fn (string $rolle): array => ['label' => $rolle, 'ton' => 'gut'], $rollen), + ], + 'zustand' => $rollen === [] ? ['ohne-rolle'] : ['mit-rolle'], + 'aktionen' => [['label' => 'Bearbeiten', 'href' => $url, 'icon' => 'stift']], + ]; + } + + return $rows; + } + + protected function zustandOptionen(): array + { + return ['alle' => 'Alle Konten', 'mit-rolle' => 'Mit Verwaltungsrolle', 'ohne-rolle' => 'Ohne Verwaltungsrolle']; + } + + protected function einheit(): array + { + return ['Konto', 'Konten']; + } + + protected function leer(): array + { + return ['titel' => 'Noch keine Konten', 'text' => 'Mit „Benutzer anlegen“ oben entsteht das erste Konto.']; + } + + protected function suchPlatzhalter(): string + { + return 'Name oder E-Mail'; + } +} diff --git a/app/Filament/Resources/Users/UserResource.php b/app/Filament/Resources/Users/UserResource.php new file mode 100644 index 0000000..02d72cf --- /dev/null +++ b/app/Filament/Resources/Users/UserResource.php @@ -0,0 +1,127 @@ +components([ + TextInput::make('name')->label('Name')->required()->maxLength(120), + TextInput::make('email')->label('E-Mail')->email()->required()->maxLength(255), + TextInput::make('password') + ->label('Passwort') + ->password() + ->revealable() + ->required(fn (string $operation): bool => $operation === 'create') + ->dehydrated(fn (?string $state): bool => filled($state)) + ->minLength(8), + Select::make('status') + ->label('Status') + ->options(collect(AccountStatus::cases())->mapWithKeys( + fn (AccountStatus $status): array => [$status->value => $status->label()], + )->all()) + ->required() + ->default(AccountStatus::Aktiv->value), + CheckboxList::make('roles') + ->label('Personalrollen') + ->options(StaffRole::options()) + ->columns(2), + ]); + } + + public static function table(Table $table): Table + { + return $table + ->columns([ + TextColumn::make('name')->label('Name')->searchable(), + TextColumn::make('email')->label('E-Mail')->searchable(), + TextColumn::make('status')->label('Status')->formatStateUsing( + fn (AccountStatus|string|null $state): string => $state instanceof AccountStatus ? $state->label() : (string) $state, + ), + TextColumn::make('staffRoles.role') + ->label('Rollen') + ->badge() + ->formatStateUsing(fn (StaffRole|string $state): string => $state instanceof StaffRole ? $state->label() : StaffRole::from($state)->label()), + ]); + } + + public static function getPages(): array + { + return [ + 'index' => ListUsers::route('/'), + 'create' => CreateUser::route('/create'), + 'edit' => EditUser::route('/{record}/edit'), + ]; + } + + /** + * @param array $data + */ + public static function persist(User $user, array $data, bool $creating): User + { + $roles = $data['roles'] ?? []; + unset($data['roles']); + + if ($creating) { + $user = app(RegisterAccount::class)->register( + $data['name'], + $data['email'], + $data['password'], + true, + ); + $user->forceFill([ + 'status' => $data['status'], + 'email_verified_at' => now(), + ])->save(); + } else { + if (blank($data['password'] ?? null)) { + unset($data['password']); + } + + $user->update($data); + + $actor = Filament::auth()->user(); + + if ($actor instanceof User && $actor->is($user) && array_key_exists('password', $data)) { + $actor->refresh(); + session()->put([ + 'password_hash_staff' => $actor->getAuthPassword(), + ]); + } + } + + $actor = Filament::auth()->user() ?? auth()->user(); + + app(AssignStaffRoles::class)->sync($user, $roles, $actor); + + return $user; + } +} diff --git a/app/Filament/Support/Bestand.php b/app/Filament/Support/Bestand.php new file mode 100644 index 0000000..0f61546 --- /dev/null +++ b/app/Filament/Support/Bestand.php @@ -0,0 +1,12 @@ + 'Film ansehen', + 'film:laden' => 'Film herunterladen', + 'audio:streamen' => 'Hörstück ansehen', + 'document:ansehen' => 'Dokument ansehen', + 'document:laden' => 'Dokument herunterladen', + 'pdf:ansehen' => 'PDF ansehen', + 'pdf:laden' => 'PDF herunterladen', + 'text:ansehen' => 'Text ansehen', + 'bild:ansehen' => 'Bild ansehen', + ]; + + /** + * @param array|null $capabilities ['film' => ['streamen'], …] + * @return list + */ + public static function faehigkeiten(?array $capabilities): array + { + $labels = []; + + foreach ($capabilities ?? [] as $class => $actions) { + foreach ((array) $actions as $action) { + $labels[] = self::FAEHIGKEITEN[$class.':'.$action] ?? $class.': '.$action; + } + } + + return $labels; + } + + public static function zweck(?string $purpose): string + { + return match ((string) $purpose) { + 'ehrenamtlich' => 'Ehrenamtlich', + 'kommerziell' => 'Kommerziell', + 'institutionell' => 'Institutionell', + default => (string) $purpose, + }; + } + + public static function vergabe(OfferVersion $version): string + { + $kind = match ($version->grant_kind) { + 'kauf' => 'Kauf', + 'auf_abruf' => 'Auf Abruf', + 'bei_registrierung' => 'Bei Registrierung', + default => (string) $version->grant_kind, + }; + + return $version->price_cents === null ? $kind : $kind.' · '.number_format($version->price_cents / 100, 2, ',', '.').' €'; + } +} diff --git a/app/Filament/Support/CatalogOptions.php b/app/Filament/Support/CatalogOptions.php new file mode 100644 index 0000000..6c0a9f8 --- /dev/null +++ b/app/Filament/Support/CatalogOptions.php @@ -0,0 +1,159 @@ + + */ + public static function elements(): array + { + return ContentElement::query()->orderBy('working_title')->pluck('working_title', 'id')->all(); + } + + /** + * @return array + */ + public static function assignmentTargets(?int $exceptCompositionId = null): array + { + $media = []; + $structures = []; + + foreach (ContentElementVersion::query()->where('status', ContentVersionStatus::Bereit)->with('element.editorialContentKind')->orderBy('id')->get() as $version) { + $media['element:'.$version->id] = self::elementLabel($version); + } + + foreach (CompositionVersion::query()->where('status', ContentVersionStatus::Bereit)->with('composition.editorialContentKind')->orderBy('id')->get() as $version) { + if ($exceptCompositionId !== null && (int) $version->composition_id === $exceptCompositionId) { + continue; + } + + $structures['composition:'.$version->id] = self::compositionLabel($version); + } + + return array_filter([ + 'Medien und Dokumente' => $media, + 'Module und Programme' => $structures, + ]); + } + + public static function elementLabel(ContentElementVersion $version): string + { + $kind = $version->element->editorialContentKind?->label; + $kind = $kind ?: self::outputLabel((string) $version->element->output_class); + + return $version->element->working_title.', '.$kind.', Fassung '.$version->number; + } + + public static function compositionLabel(CompositionVersion $version): string + { + $editorial = $version->composition->editorialContentKind?->label; + $technical = $version->composition->kind; + $kind = $editorial ?: ($technical instanceof CompositionKind ? $technical->label() : 'Zusammenstellung'); + $title = filled($version->composition->display_title) + ? $version->composition->display_title + : $version->composition->designation; + + return $title.', '.$kind.', Fassung '.$version->number; + } + + private static function outputLabel(string $outputClass): string + { + return match ($outputClass) { + 'film' => 'Film', + 'audio' => 'Hörstück', + 'bild' => 'Bild', + 'document', 'pdf' => 'Dokument', + 'text' => 'Text', + default => 'Medium', + }; + } + + /** + * @return array + */ + public static function readyTargets(): array + { + $options = []; + + foreach (ContentElementVersion::query()->where('status', ContentVersionStatus::Bereit)->with('element.editorialContentKind')->orderBy('id')->get() as $version) { + $options['element:'.$version->id] = self::elementLabel($version); + } + + foreach (CompositionVersion::query()->where('status', ContentVersionStatus::Bereit)->with('composition.editorialContentKind')->orderBy('id')->get() as $version) { + $options['composition:'.$version->id] = self::compositionLabel($version); + } + + return $options; + } + + /** + * @return array + */ + public static function compositions(): array + { + return Composition::query()->orderBy('designation')->pluck('designation', 'id')->all(); + } + + /** + * @return array + */ + public static function articles(): array + { + return LicenseArticle::query()->orderBy('code')->pluck('code', 'id')->all(); + } + + /** + * @return array + */ + public static function bundles(): array + { + return Bundle::query()->orderBy('name')->pluck('name', 'id')->all(); + } + + /** + * @return array + */ + public static function bundleVersions(): array + { + return BundleVersion::query() + ->where('status', BundleStatus::Veroeffentlicht) + ->with('bundle') + ->orderBy('id') + ->get() + ->mapWithKeys(fn (BundleVersion $version): array => [$version->id => $version->bundle->name.' · Fassung '.$version->number]) + ->all(); + } + + /** + * @return array + */ + public static function rights(): array + { + return RightsProfileVersion::query()->with('profile')->orderBy('id')->get() + ->mapWithKeys(fn (RightsProfileVersion $version): array => [$version->id => $version->profile->name.' · '.$version->purpose]) + ->all(); + } + + /** + * @return array + */ + public static function offers(): array + { + return Offer::query()->orderBy('name')->pluck('name', 'id')->all(); + } +} diff --git a/app/Filament/Support/CatalogReading.php b/app/Filament/Support/CatalogReading.php new file mode 100644 index 0000000..d9ca6f1 --- /dev/null +++ b/app/Filament/Support/CatalogReading.php @@ -0,0 +1,472 @@ + + */ + public function articleStand(LicenseArticle $article): array + { + $release = $article->currentRelease()->with(['contents.elementVersion.element'])->first(); + + if ($release === null) { + return ['Noch kein Stand veröffentlicht. Ein Lizenzartikel ohne Stand vergibt keine Inhalte.']; + } + + $lines = [ + 'Stand '.$release->number.' · '.$this->status($release->status).' · '.$release->classification_note, + ]; + + foreach ($release->contents as $content) { + $title = $content->elementVersion?->element?->working_title ?? 'Inhalt fehlt'; + $lines[] = $content->path.' — '.$title; + } + + if ($release->contents->isEmpty()) { + $lines[] = 'Dieser Stand hat keine festgeschriebenen Inhalte.'; + } + + return $lines; + } + + /** + * @return list + */ + public function articleContext(LicenseArticle $article): array + { + $lines = []; + + foreach (BundleVersion::query()->where('status', BundleStatus::Veroeffentlicht)->with('bundle')->orderBy('id')->get() as $version) { + try { + $ids = app(BundleService::class)->articleIds($version); + } catch (DomainRuleException $exception) { + continue; + } + + if (in_array($article->id, $ids, true)) { + $lines[] = 'Paket '.$version->bundle->name.' · Fassung '.$version->number; + } + } + + $scopes = ResolvedScope::query() + ->where('license_article_id', $article->id) + ->with(['offerVersion.offer', 'rights.profile']) + ->orderBy('id') + ->get(); + + foreach ($scopes as $scope) { + $version = $scope->offerVersion; + $lines[] = 'Angebot '.$version->offer->name + .' · Fassung '.$version->number + .' · '.$this->status($version->status) + .' · '.$this->grant($version) + .' · '.$scope->rights->profile->name + .' ('.$this->capabilities($scope->rights).')'; + } + + return $lines === [] + ? ['Dieser Artikel ist noch in keinem veröffentlichten Paket und in keiner Angebotsfassung aufgelöst.'] + : $lines; + } + + /** + * @return list + */ + public function bundleParts(Bundle $bundle): array + { + $version = $this->publishedBundle($bundle); + + if ($version === null) { + return ['Noch keine veröffentlichte Fassung. Bestandteile werden mit der Fassung festgeschrieben.']; + } + + $lines = ['Fassung '.$version->number]; + + foreach ($version->items as $item) { + if ($item->article !== null) { + $lines[] = 'Lizenzartikel '.$item->article->code; + + continue; + } + + $lines[] = 'Paket '.($item->nestedBundle->name ?? 'fehlt'); + } + + $older = $bundle->versions()->where('status', BundleStatus::Veroeffentlicht)->count() - 1; + + if ($older > 0) { + $lines[] = $older.' ältere Fassung'.($older === 1 ? '' : 'en').' bleibt unverändert.'; + } + + return $lines; + } + + /** + * @return list + */ + public function bundleArticles(Bundle $bundle): array + { + $version = $this->publishedBundle($bundle); + + if ($version === null) { + return ['Ohne Fassung gibt es nichts aufzulösen.']; + } + + try { + $ids = app(BundleService::class)->articleIds($version); + } catch (DomainRuleException $exception) { + return [$exception->getMessage()]; + } + + $codes = LicenseArticle::query()->whereIn('id', $ids)->orderBy('code')->pluck('code')->all(); + + return $codes === [] + ? ['Die Fassung löst keinen Lizenzartikel auf.'] + : $codes; + } + + /** + * @return list + */ + public function offerPositions(Offer $offer): array + { + $version = $this->activeOffer($offer); + + if ($version === null) { + return ['Noch keine aktive Fassung. Ein Angebot ohne Fassung kann niemand erwerben.']; + } + + $lines = [ + 'Fassung '.$version->number.' · '.$this->status($version->status).' · '.$this->grant($version), + ]; + + foreach ($version->lines as $line) { + $target = $line->article !== null + ? 'Lizenzartikel '.$line->article->code + : 'Paket '.($line->bundleVersion->bundle->name ?? 'fehlt').' · Fassung '.($line->bundleVersion->number ?? '–'); + $lines[] = $target.' · Rechte '.$line->rights->profile->name; + } + + return $lines; + } + + /** + * @return list + */ + public function offerGrants(Offer $offer): array + { + $version = $this->activeOffer($offer); + + if ($version === null) { + return ['Der Leistungsumfang wird erst beim Aktivieren aufgelöst.']; + } + + $lines = []; + + foreach ($version->resolvedScopes as $scope) { + $lines[] = $scope->article->code.' · '.$scope->rights->profile->name.' · '.$this->capabilities($scope->rights); + } + + return $lines === [] + ? ['Diese Fassung hat keinen aufgelösten Leistungsumfang.'] + : $lines; + } + + /** + * @return list + */ + public function rights(RightsProfile $profile): array + { + $version = $profile->versions()->orderByDesc('number')->first(); + + if ($version === null) { + return ['Noch keine Fassung.']; + } + + return [ + 'Fassung '.$version->number.' · '.$this->purpose($version->purpose), + $this->capabilities($version), + ]; + } + + /** + * @return list + */ + public function elementVersions(ContentElement $element): array + { + $versions = $element->versions()->orderByDesc('number')->get(); + + if ($versions->isEmpty()) { + return ['Noch keine Fassung.']; + } + + return $versions->flatMap(function ($version): array { + $note = filled($version->change_note) ? ' · '.$version->change_note : ''; + $lines = ['Fassung '.$version->number.' · '.$this->status($version->status).$note]; + $metadata = is_array($version->metadata) ? $version->metadata : []; + + if (filled($version->body)) { + $lines[] = $version->body; + } + + if (is_string($metadata['file'] ?? null) && $metadata['file'] !== '') { + $lines[] = 'Datei: '.basename($metadata['file']); + } elseif (is_string($metadata['incoming'] ?? null) || is_array($metadata['incoming'] ?? null)) { + $lines[] = 'Die Datei wird noch übernommen.'; + } + + if (is_numeric($metadata['decision_seconds'] ?? null)) { + $lines[] = 'Entscheidungsmarke bei '.(int) $metadata['decision_seconds'].' Sekunden'; + } + + if (is_string($metadata['error'] ?? null) && $metadata['error'] !== '') { + $lines[] = $metadata['error']; + } + + return $lines; + })->all(); + } + + /** + * @return list + */ + public function elementUsage(ContentElement $element): array + { + $versionIds = $element->versions()->pluck('id'); + $lines = []; + + $members = CompositionMember::query() + ->whereIn('content_element_version_id', $versionIds) + ->with(['compositionVersion.composition', 'contentElementVersion']) + ->orderBy('id') + ->get(); + + foreach ($members as $member) { + $lines[] = self::compositionLabel($member->compositionVersion->composition) + .' · Fassung '.$member->compositionVersion->number + .' · Rolle '.$member->role; + } + + $contents = ReleaseContent::query() + ->whereIn('content_element_version_id', $versionIds) + ->with(['release.article', 'elementVersion']) + ->orderBy('id') + ->get(); + + foreach ($contents as $content) { + $lines[] = 'Lizenzartikel '.$content->release->article->code + .' · Stand '.$content->release->number + .' · '.$content->path; + } + + return $lines === [] + ? ['Noch in keiner Komposition und in keinem Artikel-Stand verwendet.'] + : $lines; + } + + /** + * @return list + */ + public function compositionMembers(Composition $composition): array + { + $version = $composition->versions() + ->where('status', ContentVersionStatus::Bereit) + ->orderByDesc('number') + ->with(['members.contentElementVersion.element', 'members.nestedCompositionVersion.composition']) + ->first(); + + if ($version === null) { + return ['Noch keine bestätigte Fassung.']; + } + + $lines = ['Fassung '.$version->number]; + + foreach ($version->members as $member) { + if ($member->contentElementVersion !== null) { + $lines[] = $member->role.' — '.$member->contentElementVersion->element->working_title; + + continue; + } + + $nested = $member->nestedCompositionVersion; + $lines[] = $member->role.' — '.($nested === null ? 'fehlt' : self::compositionLabel($nested->composition)); + } + + return $lines; + } + + /** + * @return list + */ + public function memberPillars(Composition $composition): array + { + $version = $composition->versions() + ->where('status', ContentVersionStatus::Bereit) + ->orderByDesc('number') + ->first(); + + if ($version === null) { + return ['Noch keine Fassung, deshalb keine Säulen.']; + } + + $rows = app(ContentResolver::class)->expand($version); + $versions = ContentElementVersion::query() + ->whereIn('id', array_column($rows, 'version_id')) + ->with('element.pillars') + ->get() + ->keyBy('id'); + $lines = []; + + foreach ($rows as $row) { + $element = $versions[$row['version_id']]->element; + $names = $element->pillars->pluck('name'); + $lines[] = $element->working_title.' — '.($names->isEmpty() ? 'keiner Säule zugeordnet' : $names->join(', ')); + } + + return $lines === [] ? ['Diese Fassung enthält keine Medien.'] : $lines; + } + + /** + * @return list + */ + public function compositionUsage(Composition $composition): array + { + $versionIds = $composition->versions()->pluck('id'); + $lines = []; + + $parents = CompositionMember::query() + ->whereIn('nested_composition_version_id', $versionIds) + ->with('compositionVersion.composition') + ->orderBy('id') + ->get(); + + foreach ($parents as $member) { + $lines[] = self::compositionLabel($member->compositionVersion->composition) + .' · Fassung '.$member->compositionVersion->number + .' · Rolle '.$member->role; + } + + $articles = LicenseArticle::query() + ->whereHas('releases', function ($query) use ($versionIds): void { + $query->whereIn('root_composition_version_id', $versionIds); + }) + ->orderBy('code') + ->pluck('code'); + + foreach ($articles as $code) { + $lines[] = 'Wurzel des Lizenzartikels '.$code; + } + + return $lines === [] + ? ['Noch nicht in einer anderen Komposition und nicht als Wurzel eines Artikels verwendet.'] + : $lines; + } + + private function publishedBundle(Bundle $bundle): ?BundleVersion + { + return $bundle->versions() + ->where('status', BundleStatus::Veroeffentlicht) + ->orderByDesc('number') + ->with(['items.article', 'items.nestedBundle']) + ->first(); + } + + private function activeOffer(Offer $offer): ?OfferVersion + { + return $offer->versions() + ->where('status', OfferStatus::Aktiv) + ->orderByDesc('number') + ->with([ + 'lines.article', + 'lines.bundleVersion.bundle', + 'lines.rights.profile', + 'resolvedScopes.article', + 'resolvedScopes.rights.profile', + ]) + ->first(); + } + + private function grant(OfferVersion $version): string + { + $kind = match ($version->grant_kind) { + 'kauf' => 'Kauf', + 'auf_abruf' => 'Auf Abruf', + 'bei_registrierung' => 'Bei Registrierung', + default => (string) $version->grant_kind, + }; + + if ($version->price_cents === null) { + return $kind; + } + + return $kind.' · '.number_format($version->price_cents / 100, 2, ',', '.').' €'; + } + + private function capabilities(RightsProfileVersion $version): string + { + $parts = []; + + foreach ($version->capabilities ?? [] as $class => $actions) { + $actions = is_array($actions) ? implode(', ', $actions) : (string) $actions; + $parts[] = $class.': '.$actions; + } + + return $parts === [] ? 'keine Fähigkeiten' : implode('; ', $parts); + } + + private function purpose(string $purpose): string + { + return match ($purpose) { + 'ehrenamtlich' => 'Ehrenamtlich', + 'kommerziell' => 'Kommerziell', + 'institutionell' => 'Institutionell', + default => $purpose, + }; + } + + private static function compositionLabel(Composition $composition): string + { + $kind = $composition->kind; + $label = $kind instanceof CompositionKind ? $kind->label() : 'Zusammenstellung'; + + return $label.': '.$composition->designation; + } + + private function status(mixed $status): string + { + return match (StatusValue::of($status)) { + 'veroeffentlicht' => 'veröffentlicht', + 'abgeloest_verfuegbar' => 'abgelöst, weiterhin verfügbar', + 'gesperrt' => 'gesperrt', + 'bereit' => 'bereit', + 'entwurf' => 'Entwurf', + 'aktiv' => 'aktiv', + 'beendet' => 'beendet', + default => StatusValue::of($status) ?? 'unbekannt', + }; + } +} diff --git a/app/Filament/Support/ChoosesMedia.php b/app/Filament/Support/ChoosesMedia.php new file mode 100644 index 0000000..c8c0820 --- /dev/null +++ b/app/Filament/Support/ChoosesMedia.php @@ -0,0 +1,252 @@ + Ziel => Titel; bleibt bei Suche und Filter erhalten */ + public array $pickerMarked = []; + + public string $presentationRole = 'titelbild'; + + public bool $bindToVersion = false; + + public ?string $replacingKey = null; + + abstract public function pickerAllowsMany(): bool; + + abstract public function closePicker(): void; + + abstract public function confirmPicker(): void; + + public function inspectPicker(string $target, bool $mark = false): void + { + $this->pickerInspected = $target; + + if ($mark) { + $this->markPicker($target, true); + } + } + + public function togglePick(string $target): void + { + $this->markPicker($target, ! isset($this->pickerMarked[$target])); + } + + public function markPicker(string $target, bool $on): void + { + if (! $on) { + unset($this->pickerMarked[$target]); + + if ($this->pickerSelected === $target) { + $this->pickerSelected = ''; + } + + return; + } + + $row = app(EditorialCatalog::class)->rowForTarget($target, $this->pickerExceptId(), allowDraft: true); + + if ($row === null) { + return; + } + + if (! $this->pickerAllowsMany()) { + $this->pickerMarked = []; + $this->pickerSelected = $target; + } + + $this->pickerMarked[$target] = (string) $row['title']; + + if ($this->pickerInspected === '') { + $this->pickerInspected = $target; + } + } + + /** + * @return array{items: list>, more: bool} + */ + public function pickerResult(): array + { + if (! $this->pickerOpen) { + return ['items' => [], 'more' => false]; + } + + if ($this->pickerPurpose === 'aufbau') { + return $this->filterByMaterialart(app(EditorialCatalog::class)->browse( + $this->pickerQuery, + $this->pickerKind, + $this->pickerDimension, + $this->pickerExceptId(), + )); + } + + $result = app(EditorialCatalog::class)->presentationBrowse($this->pickerQuery, $this->pickerKind); + $result = $this->filterByMaterialart($result); + + // CMS: nur Bilder, die als Website-Bild wählbar sind (keine vertraulichen Arten, nicht archiviert). + if ($this->pickerPurpose === 'website-bild') { + $ids = array_values(array_filter(array_map(fn (array $item): int => (int) ($item['element_id'] ?? 0), $result['items']))); + $elements = ContentElement::query()->with('editorialContentKind')->whereKey($ids)->get()->keyBy('id'); + $result['items'] = array_values(array_filter($result['items'], function (array $item) use ($elements): bool { + $element = $elements->get((int) ($item['element_id'] ?? 0)); + + return $element !== null && WebsiteImage::isSelectable($element); + })); + } + + return $result; + } + + /** + * @return array|null + */ + public function pickerDetail(): ?array + { + $target = $this->pickerInspected !== '' ? $this->pickerInspected : $this->pickerSelected; + + if ($target === '') { + return null; + } + + $row = app(EditorialCatalog::class)->rowForTarget($target, $this->pickerExceptId(), allowDraft: true); + + if ($row === null) { + return null; + } + + $row['playback'] = null; + $row['file_url'] = null; + $elementId = isset($row['element_id']) ? (int) $row['element_id'] : 0; + + if (preg_match('/^element:(\d+)$/', (string) $row['target'], $match) === 1) { + $version = ContentElementVersion::query()->with('element.editorialContentKind')->find($match[1]); + + if ($version instanceof ContentElementVersion) { + $row['playback'] = app(ContentPreviewController::class)->playback($version); + } + } + + $element = $elementId > 0 ? ContentElement::query()->with(['editorialContentKind', 'pillars'])->find($elementId) : null; + + if ($element instanceof ContentElement) { + $row['visibility'] = app(PublicMaterialReader::class)->visibilityNote($element); + $row['released'] = $element->website_released_at !== null; + $row['output_label'] = PublicMaterialReader::outputLabel((string) $element->output_class); + $row['pillars'] = $element->pillars->pluck('name')->all(); + $row['material'] = $element->editorialContentKind?->label; + $row['usage'] = app(CatalogReading::class)->elementUsage($element); + } + + return $row; + } + + /** + * @return list + */ + public function pickerVersions(): array + { + $detail = $this->pickerDetail(); + + if ($detail === null) { + return []; + } + + $options = app(EditorialCatalog::class)->alternatives((string) ($detail['identity'] ?? ''), $this->pickerExceptId()); + + if ($options === []) { + return []; + } + + $current = $options[array_key_last($options)]['target']; + + return array_map(fn (array $option): array => $option + ['current' => $option['target'] === $current], $options); + } + + protected function pickerExceptId(): int + { + return 0; + } + + protected function resetPicker(string $purpose): void + { + $this->pickerPurpose = $purpose; + $this->pickerOpen = true; + $this->pickerQuery = ''; + $this->pickerDimension = ''; + $this->pickerMaterialart = ''; + $this->pickerInspected = ''; + $this->pickerSelected = ''; + $this->pickerMarked = []; + $this->replacingKey = null; + $this->bindToVersion = false; + } + + /** + * Fachliche Materialarten, nach denen der Picker Medien eingrenzen kann (Kontext Medium). + * + * @return array + */ + public function pickerMaterialarten(): array + { + return app(EditorialVocabulary::class)->kindFilterOptions('medium', $this->pickerMaterialart); + } + + /** + * @param array{items: list>, more: bool} $result + * @return array{items: list>, more: bool} + */ + private function filterByMaterialart(array $result): array + { + if (! ctype_digit($this->pickerMaterialart)) { + return $result; + } + + $ids = array_values(array_filter(array_map(fn (array $item): int => (int) ($item['element_id'] ?? 0), $result['items']))); + $passend = ContentElement::query()->whereKey($ids)->where('editorial_content_kind_id', (int) $this->pickerMaterialart)->pluck('id')->map(fn ($id): int => (int) $id)->all(); + $result['items'] = array_values(array_filter($result['items'], fn (array $item): bool => in_array((int) ($item['element_id'] ?? 0), $passend, true))); + + return $result; + } + + /** + * Einordnungsfilter des Pickers: dieselbe Filterregel wie Medien- und Kompositionslisten (verwendete inaktive Werte + * bleiben auffindbar, ein gewählter Filter bleibt sichtbar). + * + * @return list}> + */ + public function pickerDimensionGroups(): array + { + return app(EditorialVocabulary::class)->dimensionFilterGroups(ctype_digit($this->pickerDimension) ? [(int) $this->pickerDimension] : []); + } +} diff --git a/app/Filament/Support/ChoosesWebsiteImages.php b/app/Filament/Support/ChoosesWebsiteImages.php new file mode 100644 index 0000000..790f088 --- /dev/null +++ b/app/Filament/Support/ChoosesWebsiteImages.php @@ -0,0 +1,132 @@ +resetPicker('website-bild'); + $this->pickerKind = 'bild'; + $this->bildZiel = $pfad; + $this->forceRenderForPicker(); + } + + /** + * Filament rendert bei offenen Aktionsdialogen nur den Dialogteil neu; der Picker liegt darüber und braucht die + * ganze Seite. + */ + public function hydrateChoosesWebsiteImages(): void + { + if ($this->pickerOpen) { + $this->forceRenderForPicker(); + } + } + + public function pickerAllowsMany(): bool + { + return false; + } + + public function closePicker(): void + { + $this->pickerOpen = false; + $this->pickerSelected = ''; + $this->pickerInspected = ''; + $this->pickerMarked = []; + $this->bildZiel = null; + $this->forceRenderForPicker(); + } + + public function confirmPicker(): void + { + $target = array_key_first($this->pickerMarked); + $ziel = $this->bildZiel; + + if ($target === null || $ziel === null) { + return; + } + + $row = app(EditorialCatalog::class)->rowForTarget((string) $target, 0, allowDraft: true); + $element = isset($row['element_id']) ? ContentElement::query()->find((int) $row['element_id']) : null; + + if (! $element instanceof ContentElement || ! WebsiteImage::isSelectable($element)) { + Notification::make()->danger()->title('Dieses Medium kann nicht als Website-Bild gewählt werden.')->send(); + + return; + } + + data_set($this, $ziel, $element->id); + $this->closePicker(); + } + + /** + * @return array + */ + public function pickerKinds(): array + { + return ['bild' => 'Bilder']; + } + + public function pickerTitle(): string + { + return 'Bild aus dem Medienmanager'; + } + + public function pickerConfirmLabel(): string + { + return 'Bild übernehmen'; + } + + /** + * @return array{art: string, titel: string} + */ + public function pickerKontext(): array + { + $pfad = property_exists($this, 'record') && is_object($this->record ?? null) ? (string) ($this->record->path ?? '') : ''; + + return ['art' => 'die Seite', 'titel' => $pfad !== '' ? $pfad : 'neue Seite']; + } + + /** + * @return array + */ + public function presentationRoleOptions(): array + { + return []; + } + + /** + * @return array|null + */ + public function pickerReplacing(): ?array + { + return null; + } + + private function forceRenderForPicker(): void + { + if (method_exists($this, 'forceRender')) { + $this->forceRender(); + } + } +} diff --git a/app/Filament/Support/EditorialCatalog.php b/app/Filament/Support/EditorialCatalog.php new file mode 100644 index 0000000..a01872a --- /dev/null +++ b/app/Filament/Support/EditorialCatalog.php @@ -0,0 +1,1079 @@ +> + */ + public function rows(CompositionVersion $version, int $exceptCompositionId): array + { + $version->loadMissing([ + 'members.contentElementVersion.element.editorialContentKind', + 'members.nestedCompositionVersion.composition.editorialContentKind', + ]); + $rows = []; + + foreach ($version->members as $member) { + $target = $member->content_element_version_id + ? 'element:'.$member->content_element_version_id + : 'composition:'.$member->nested_composition_version_id; + $row = $this->rowForTarget($target, $exceptCompositionId, allowSelf: true, allowDraft: true, allowBlocked: true); + + if ($row === null) { + continue; + } + + $row['role'] = $member->role; + $row['note'] = trim((string) ($member->placement_note ?? '')); + $rows[] = $row; + } + + return $rows; + } + + /** + * @return array|null + */ + public function rowForTarget(string $target, int $exceptCompositionId, bool $allowSelf = false, bool $allowDraft = false, bool $allowBlocked = false): ?array + { + if (preg_match('/^composition-draft:(\d+)$/', $target, $draftMatch) === 1) { + return $this->draftCompositionRow((int) $draftMatch[1], $exceptCompositionId, $allowSelf); + } + + if (preg_match('/^medium:(\d+)$/', $target, $mediumMatch) === 1) { + return $this->rowForPresentationMedium((int) $mediumMatch[1]); + } + + if (preg_match('/^(element|composition):(\d+)$/', $target, $match) !== 1) { + return null; + } + + if ($match[1] === 'element') { + $version = ContentElementVersion::query() + ->with('element.editorialContentKind') + ->find($match[2]); + $acceptable = [ContentVersionStatus::Bereit]; + + if ($allowDraft) { + $acceptable[] = ContentVersionStatus::Entwurf; + } + + if ($allowBlocked) { + $acceptable[] = ContentVersionStatus::Gesperrt; + } + + if (! $version instanceof ContentElementVersion || ! in_array($version->status, $acceptable, true)) { + return null; + } + + $element = $version->element; + $kind = $element->editorialContentKind?->label ?: $this->outputLabel((string) $element->output_class); + $title = filled($element->display_title) ? $element->display_title : $element->working_title; + + return [ + 'target' => 'element:'.$version->id, + 'element_id' => (string) $element->id, + 'title' => $title, + 'kind' => $kind, + 'output' => (string) $element->output_class, + 'body' => (string) ($version->body ?? ''), + 'summary' => (string) ($element->summary ?: $element->description ?: ''), + 'medium_description' => (string) ($element->description ?? ''), + 'usage_note' => (string) ($element->usage_note ?? ''), + 'license_note' => (string) ($element->license_note ?? ''), + 'tone' => $this->tone((string) $element->output_class, $kind), + 'image' => $this->cardUrl('element', $element->id, $element->thumbnail_path), + 'version_label' => match ($version->status) { + ContentVersionStatus::Entwurf => 'Entwurf', + ContentVersionStatus::Gesperrt => 'deaktiviert', + default => 'Fassung '.$version->number, + }, + 'committed' => app(ContentService::class)->isCommitted($version), + 'identity' => 'medium:'.$element->id, + 'open_url' => route('content.preview', $version), + 'open_label' => 'Medium ansehen', + 'edit_url' => ContentElementResource::getUrl('view', ['record' => $element]), + ]; + } + + $version = CompositionVersion::query() + ->with('composition.editorialContentKind') + ->find($match[2]); + + $acceptable = [ContentVersionStatus::Bereit]; + + if ($allowBlocked) { + $acceptable[] = ContentVersionStatus::Gesperrt; + } + + if (! $version instanceof CompositionVersion || ! in_array($version->status, $acceptable, true)) { + return null; + } + + if (! $allowSelf && (int) $version->composition_id === $exceptCompositionId) { + return null; + } + + $composition = $version->composition; + $kind = $composition->editorialContentKind?->label + ?: ($composition->kind instanceof CompositionKind ? $composition->kind->deskLabel() : 'Zusammenstellung'); + + return [ + 'target' => 'composition:'.$version->id, + 'title' => $this->compositionTitle($composition), + 'kind' => $kind, + 'summary' => (string) ($composition->summary ?? ''), + 'tone' => $this->tone('', $kind), + 'image' => $this->cardUrl('komposition', $composition->id, $composition->thumbnail_path), + 'version_label' => $version->status === ContentVersionStatus::Gesperrt + ? 'deaktiviert' + : 'Fassung '.$version->number, + 'identity' => 'zusammenstellung:'.$composition->id, + 'open_url' => route('editorial.preview', ['composition' => $composition, 'version' => $version]), + 'open_label' => 'Aufbau ansehen', + 'edit_url' => self::editUrl($composition), + ]; + } + + /** + * @return array|null + */ + private function draftCompositionRow(int $compositionId, int $exceptCompositionId, bool $allowSelf): ?array + { + if (! $allowSelf && $compositionId === $exceptCompositionId) { + return null; + } + + $composition = Composition::query()->with('editorialContentKind')->find($compositionId); + + if (! $composition instanceof Composition) { + return null; + } + + $kind = $composition->editorialContentKind?->label + ?: ($composition->kind instanceof CompositionKind ? $composition->kind->deskLabel() : 'Zusammenstellung'); + + return [ + 'target' => 'composition-draft:'.$composition->id, + 'title' => $this->compositionTitle($composition), + 'kind' => $kind, + 'summary' => (string) ($composition->summary ?? ''), + 'tone' => $this->tone('', $kind), + 'image' => $this->cardUrl('komposition', $composition->id, $composition->thumbnail_path), + 'version_label' => 'Entwurf', + 'identity' => 'zusammenstellung:'.$composition->id, + 'open_url' => route('editorial.draft-preview', ['composition' => $composition]), + 'open_label' => 'Entwurf ansehen', + 'edit_url' => self::editUrl($composition), + ]; + } + + /** + * @return list> + */ + public function search(string $query, string $scope, int $exceptCompositionId): array + { + $query = trim($query); + $like = '%'.str_replace(['%', '_'], ['', ''], $query).'%'; + $limit = $scope === 'alles' ? 20 : 40; + $rows = []; + + if ($scope !== 'module') { + $elements = ContentElementVersion::query() + ->where('status', ContentVersionStatus::Bereit) + ->with('element.editorialContentKind') + ->whereHas('element', function ($builder) use ($query, $like): void { + if ($query === '') { + return; + } + + $builder->where('working_title', 'like', $like) + ->orWhere('display_title', 'like', $like) + ->orWhere('teaser', 'like', $like) + ->orWhere('search_terms', 'like', $like) + ->orWhere('summary', 'like', $like); + }) + ->orderByDesc('id') + ->limit($limit) + ->get(); + + foreach ($elements as $version) { + $row = $this->rowForTarget('element:'.$version->id, $exceptCompositionId); + + if ($row !== null) { + $rows[] = $row; + } + } + } + + if ($scope !== 'medien') { + $versions = CompositionVersion::query() + ->where('status', ContentVersionStatus::Bereit) + ->where('composition_id', '!=', $exceptCompositionId) + ->with('composition.editorialContentKind') + ->whereHas('composition', function ($builder) use ($scope, $query, $like): void { + if ($scope === 'module') { + $builder->where('kind', CompositionKind::Uebung); + } + + if ($query === '') { + return; + } + + $builder->where(function ($inner) use ($like): void { + $inner->where('designation', 'like', $like) + ->orWhere('display_title', 'like', $like) + ->orWhere('teaser', 'like', $like) + ->orWhere('search_terms', 'like', $like) + ->orWhere('summary', 'like', $like); + }); + }) + ->orderByDesc('id') + ->limit($limit) + ->get(); + + foreach ($versions as $version) { + $row = $this->rowForTarget('composition:'.$version->id, $exceptCompositionId); + + if ($row !== null) { + $rows[] = $row; + } + } + } + + return array_slice($rows, 0, 40); + } + + /** + * @return array{items: list>, more: bool} + */ + public function browse(string $query, string $kind, string $dimension, int $exceptCompositionId, bool $elementsOnly = false): array + { + $query = trim($query); + $like = '%'.str_replace(['%', '_'], ['', ''], $query).'%'; + $limit = 48; + $rows = []; + $dimensionId = ctype_digit($dimension) ? (int) $dimension : 0; + + if ($kind !== 'modul') { + $latestElements = ContentElementVersion::query() + ->selectRaw('MAX(id)') + ->whereIn('status', [ContentVersionStatus::Bereit, ContentVersionStatus::Entwurf]) + ->whereHas('element', function ($builder) use ($query, $like, $kind, $dimensionId): void { + $this->constrainElement($builder, $query, $like, $kind, $dimensionId); + }) + ->groupBy('content_element_id'); + $elements = ContentElementVersion::query() + ->with('element.editorialContentKind') + ->whereIn('id', $latestElements) + ->orderByDesc('id') + ->limit($limit + 1) + ->get(); + + foreach ($elements as $version) { + $row = $this->rowForTarget('element:'.$version->id, $exceptCompositionId, allowDraft: true); + + if ($row !== null) { + $rows[] = $row; + } + } + } + + if (! $elementsOnly && in_array($kind, ['alle', 'modul'], true)) { + $latestCompositions = CompositionVersion::query() + ->selectRaw('MAX(id)') + ->where('status', ContentVersionStatus::Bereit) + ->where('composition_id', '!=', $exceptCompositionId) + ->whereHas('composition', function ($builder) use ($query, $like, $kind, $dimensionId): void { + if ($kind === 'modul') { + $builder->where('kind', CompositionKind::Uebung); + } + + if ($dimensionId > 0) { + $builder->whereIn('id', $this->dimensionSubjectIds(Composition::class, $dimensionId)); + } + + if ($query === '') { + return; + } + + $builder->where(function ($inner) use ($like): void { + $inner->where('designation', 'like', $like) + ->orWhere('display_title', 'like', $like) + ->orWhere('teaser', 'like', $like) + ->orWhere('search_terms', 'like', $like) + ->orWhere('summary', 'like', $like); + }); + }) + ->groupBy('composition_id'); + $versions = CompositionVersion::query() + ->with('composition.editorialContentKind') + ->whereIn('id', $latestCompositions) + ->orderByDesc('id') + ->limit($limit + 1) + ->get(); + + foreach ($versions as $version) { + $row = $this->rowForTarget('composition:'.$version->id, $exceptCompositionId); + + if ($row !== null) { + $rows[] = $row; + } + } + + $unreleased = Composition::query() + ->where('id', '!=', $exceptCompositionId) + ->whereNotNull('working_draft') + ->whereDoesntHave('versions', function ($builder): void { + $builder->where('status', ContentVersionStatus::Bereit); + }) + ->when($kind === 'modul', function ($builder): void { + $builder->where('kind', CompositionKind::Uebung); + }) + ->orderByDesc('id') + ->get(); + + foreach ($unreleased as $composition) { + $draft = is_array($composition->working_draft) ? $composition->working_draft : []; + $draftMembers = is_array($draft['members'] ?? null) ? $draft['members'] : []; + + if ($draftMembers === []) { + continue; + } + + if ($dimensionId > 0 && ! in_array($composition->id, $this->dimensionSubjectIds(Composition::class, $dimensionId), true)) { + continue; + } + + $title = $this->compositionTitle($composition); + + if ($query !== '' && ! str_contains(mb_strtolower($title.' '.(string) ($composition->summary ?? '')), mb_strtolower($query))) { + continue; + } + + $row = $this->rowForTarget('composition-draft:'.$composition->id, $exceptCompositionId); + + if ($row !== null) { + $rows[] = $row; + } + } + } + + $rows = $this->withVisibility($rows); + + return [ + 'items' => array_slice($rows, 0, $limit), + 'more' => count($rows) > $limit, + ]; + } + + /** + * Bestandssuche für Präsentationsmedien. + * Fassungen bleiben im didaktischen Aufbau. Bilder, Filme und Hörstücke ohne Inhaltsfassung kommen dazu. + * + * @return array{items: list>, more: bool} + */ + public function presentationBrowse(string $query, string $kind = 'alle'): array + { + $catalog = $this->browse($query, $kind, '', 0, elementsOnly: true); + $outputs = match ($kind) { + 'bild' => ['bild'], + 'film' => ['film'], + 'audio' => ['audio'], + 'dokument' => [], + default => ['bild', 'film', 'audio'], + }; + // Reine Texte sind Lehrinhalt oder Beschreibung, keine Präsentationsmedien. + $catalog['items'] = array_values(array_filter( + $catalog['items'], + fn (array $item): bool => ($item['output'] ?? '') !== 'text', + )); + $seen = []; + + foreach ($catalog['items'] as $item) { + if (isset($item['element_id'])) { + $seen[(int) $item['element_id']] = true; + } + } + + $query = trim($query); + $like = '%'.str_replace(['%', '_'], ['', ''], $query).'%'; + $elements = ContentElement::query() + ->with('editorialContentKind') + ->whereIn('output_class', $outputs) + ->whereNull('archived_at') + ->whereDoesntHave('versions') + ->where(function ($builder): void { + $builder->whereNull('editorial_content_kind_id') + ->orWhereDoesntHave('editorialContentKind', function ($kind): void { + $kind->where('slug', 'traineranleitung'); + }); + }) + ->when($query !== '', function ($builder) use ($like): void { + $builder->where(function ($inner) use ($like): void { + $inner->where('working_title', 'like', $like) + ->orWhere('display_title', 'like', $like) + ->orWhere('teaser', 'like', $like) + ->orWhere('search_terms', 'like', $like) + ->orWhere('summary', 'like', $like); + }); + }) + ->orderBy('working_title') + ->limit(48) + ->get(); + + foreach ($elements as $element) { + if (isset($seen[$element->id])) { + continue; + } + + $row = $this->rowForPresentationMedium($element->id); + + if ($row !== null) { + $catalog['items'][] = $row; + } + } + + return $catalog; + } + + /** + * @return array|null + */ + private function rowForPresentationMedium(int $id): ?array + { + $element = ContentElement::query()->with('editorialContentKind')->find($id); + + if (! $element instanceof ContentElement + || $element->archived_at !== null + || ! in_array($element->output_class, ['bild', 'film', 'audio'], true) + || $element->editorialContentKind?->slug === 'traineranleitung') { + return null; + } + + $kind = $element->editorialContentKind?->label ?: $this->outputLabel((string) $element->output_class); + $title = filled($element->display_title) ? $element->display_title : $element->working_title; + + return [ + 'target' => 'medium:'.$element->id, + 'element_id' => (string) $element->id, + 'title' => $title, + 'kind' => $kind, + 'output' => (string) $element->output_class, + 'body' => '', + 'summary' => (string) ($element->summary ?: $element->description ?: ''), + 'medium_description' => (string) ($element->description ?? ''), + 'usage_note' => (string) ($element->usage_note ?? ''), + 'license_note' => (string) ($element->license_note ?? ''), + 'tone' => $this->tone((string) $element->output_class, $kind), + 'image' => $element->output_class === 'bild' + ? $this->cardUrl('element', $element->id, $element->thumbnail_path) + : null, + 'version_label' => 'Ohne Inhaltsfassung', + 'committed' => false, + 'identity' => 'medium:'.$element->id, + 'open_url' => ContentElementResource::getUrl('view', ['record' => $element]), + 'open_label' => 'Medium ansehen', + 'edit_url' => ContentElementResource::getUrl('view', ['record' => $element]), + ]; + } + + public function tone(string $outputClass, string $kindLabel): string + { + $value = mb_strtolower($outputClass.' '.$kindLabel); + + return match (true) { + str_contains($value, 'film') => 'film', + str_contains($value, 'hör'), str_contains($value, 'audio') => 'audio', + str_contains($value, 'dokument'), str_contains($value, 'pdf') => 'dokument', + str_contains($value, 'modul'), str_contains($value, 'programm') => 'modul', + default => 'text', + }; + } + + public function cardUrl(string $kind, int $id, ?string $path): ?string + { + if (! is_string($path) || ! str_starts_with($path, 'vorschau/') || str_contains($path, '..')) { + return null; + } + + return route('editorial.card', ['kind' => $kind, 'subject' => $id]); + } + + /** + * @param list> $rows + * @return list> + */ + private function withVisibility(array $rows): array + { + $ids = []; + + foreach ($rows as $row) { + if (isset($row['element_id'])) { + $ids[] = (int) $row['element_id']; + } + } + + if ($ids === []) { + return $rows; + } + + $reader = app(PublicMaterialReader::class); + $elements = ContentElement::query() + ->with('editorialContentKind') + ->whereIn('id', array_values(array_unique($ids))) + ->get() + ->keyBy('id'); + + foreach ($rows as $index => $row) { + $element = $elements->get((int) ($row['element_id'] ?? 0)); + + if ($element instanceof ContentElement) { + $rows[$index]['visibility'] = $reader->visibilityNote($element); + } + } + + return $rows; + } + + /** + * @param Builder $builder + */ + private function constrainElement($builder, string $query, string $like, string $kind, int $dimensionId): void + { + $outputs = match ($kind) { + 'film' => ['film'], + 'text' => ['text'], + 'bild' => ['bild'], + 'audio' => ['audio'], + 'dokument' => ['pdf', 'document'], + default => null, + }; + + if ($outputs !== null) { + $builder->whereIn('output_class', $outputs); + } + + if ($dimensionId > 0) { + $builder->whereIn('id', $this->dimensionSubjectIds(ContentElement::class, $dimensionId)); + } + + if ($query === '') { + return; + } + + $builder->where(function ($inner) use ($like): void { + $inner->where('working_title', 'like', $like) + ->orWhere('display_title', 'like', $like) + ->orWhere('teaser', 'like', $like) + ->orWhere('search_terms', 'like', $like) + ->orWhere('summary', 'like', $like) + ->orWhere('description', 'like', $like); + }); + } + + /** + * @param class-string $class + * @return list + */ + private function dimensionSubjectIds(string $class, int $dimensionId): array + { + return IdentityDimensionValue::query() + ->where('subject_type', (new $class)->getMorphClass()) + ->where('editorial_dimension_value_id', $dimensionId) + ->where('origin', 'direkt') + ->pluck('subject_id') + ->map(fn (mixed $id): int => (int) $id) + ->all(); + } + + /** + * @return list + */ + public function alternatives(string $identity, int $exceptCompositionId): array + { + if (preg_match('/^(medium|zusammenstellung):(\d+)$/', $identity, $match) !== 1) { + return []; + } + + $options = []; + + if ($match[1] === 'medium') { + $versions = ContentElementVersion::query() + ->where('content_element_id', $match[2]) + ->whereIn('status', [ContentVersionStatus::Bereit, ContentVersionStatus::Entwurf]) + ->orderBy('number') + ->get(); + + foreach ($versions as $version) { + $options[] = [ + 'target' => 'element:'.$version->id, + 'label' => $version->status === ContentVersionStatus::Entwurf ? 'Entwurf' : 'Fassung '.$version->number, + ]; + } + + return $options; + } + + if ((int) $match[2] === $exceptCompositionId) { + return []; + } + + $versions = CompositionVersion::query() + ->where('composition_id', $match[2]) + ->where('status', ContentVersionStatus::Bereit) + ->orderBy('number') + ->get(); + + foreach ($versions as $version) { + $options[] = [ + 'target' => 'composition:'.$version->id, + 'label' => 'Fassung '.$version->number, + ]; + } + + return $options; + } + + public function defaultRole(string $kind): string + { + $kind = mb_strtolower($kind); + + return match (true) { + str_contains($kind, 'film') => 'Film', + str_contains($kind, 'hör') || str_contains($kind, 'audio') => 'Hörstück', + str_contains($kind, 'modul') => 'Modul', + str_contains($kind, 'programm') => 'Programm', + str_contains($kind, 'text'), str_contains($kind, 'dokument'), str_contains($kind, 'merkblatt'), str_contains($kind, 'unterlage') => 'Unterlage', + default => 'Bestandteil', + }; + } + + /** + * @return list + */ + public function usage(CompositionVersion $version): array + { + $lines = []; + $parents = CompositionMember::query() + ->where('nested_composition_version_id', $version->id) + ->with('compositionVersion.composition') + ->get(); + + foreach ($parents as $member) { + $parent = $member->compositionVersion?->composition; + $name = $parent instanceof Composition ? $this->compositionTitle($parent) : 'Zusammenstellung'; + $lines[] = $name.', Rolle '.$member->role; + } + + $articles = ArticleRelease::query() + ->where('root_composition_version_id', $version->id) + ->with('article') + ->get(); + + foreach ($articles as $release) { + $lines[] = 'Lizenzartikel '.$release->article->code.', Stand '.$release->number; + } + + return $lines; + } + + /** + * @return array{text: string, number: int|null, released_number: int|null} + */ + public function stand(Composition $composition): array + { + $ready = $composition->versions + ->filter(fn (CompositionVersion $version): bool => $version->status === ContentVersionStatus::Bereit) + ->sortByDesc('number') + ->values(); + $latest = $ready->first(); + $release = app(CompositionDisplayRelease::class); + $released = $ready->first(fn (CompositionVersion $version): bool => $release->isReleased($version)); + + $draft = is_array($composition->working_draft) && $composition->working_draft !== []; + + if (! $latest instanceof CompositionVersion) { + return [ + 'text' => $draft ? 'Entwurf gespeichert' : 'Noch ohne Fassung', + 'number' => null, + 'released_number' => $released instanceof CompositionVersion ? $released->number : null, + ]; + } + + $visible = $released instanceof CompositionVersion; + $text = 'Fassung '.$latest->number.($visible ? ', in der Mitgliederbibliothek' : ', nicht in der Mitgliederbibliothek'); + $text = ($draft ? 'Entwurf gespeichert. ' : '').$text; + + if ($visible && $released->number !== $latest->number) { + $text .= '. Angezeigt wird Fassung '.$released->number; + } + + return [ + 'text' => $text, + 'number' => $latest->number, + 'released_number' => $visible ? $released->number : null, + ]; + } + + /** + * @return list + */ + public function statusChips(Composition $composition, bool $offered): array + { + $stand = $this->stand($composition); + $chips = []; + + if ($stand['number'] === null) { + $chips[] = [ + 'label' => str_contains($stand['text'], 'Entwurf') ? 'Entwurf gespeichert' : 'Noch ohne Fassung', + 'tone' => 'yellow', + ]; + } else { + $chips[] = ['label' => 'Fassung '.$stand['number'], 'tone' => 'ink']; + + if (str_starts_with($stand['text'], 'Entwurf gespeichert')) { + $chips[] = ['label' => 'Entwurf offen', 'tone' => 'yellow']; + } + + // Zeigt die Bibliothek eine ältere Fassung, nennt der Chip sie; „In der Mitgliederbibliothek“ neben + // „Fassung 2“ läse sich sonst, als wäre Fassung 2 sichtbar. + $chips[] = match (true) { + $stand['released_number'] === null => ['label' => 'Nicht in der Mitgliederbibliothek', 'tone' => 'quiet'], + $stand['released_number'] === $stand['number'] => ['label' => 'In der Mitgliederbibliothek', 'tone' => 'pine'], + default => ['label' => 'Bibliothek zeigt Fassung '.$stand['released_number'], 'tone' => 'pine'], + }; + } + + $chips[] = ['label' => 'Nicht auf der Website', 'tone' => 'quiet']; + $chips[] = $offered + ? ['label' => 'Angebot aktiv', 'tone' => 'pine'] + : ['label' => 'Kein aktives Angebot', 'tone' => 'quiet']; + + return $chips; + } + + /** + * @return list + */ + public function offeredCompositionIds(): array + { + $articleIds = DB::table('resolved_scopes') + ->join('offer_versions', 'offer_versions.id', '=', 'resolved_scopes.offer_version_id') + ->where('offer_versions.status', OfferStatus::Aktiv->value) + ->pluck('resolved_scopes.license_article_id'); + + if ($articleIds->isEmpty()) { + return []; + } + + $releaseIds = LicenseArticle::query() + ->whereIn('id', $articleIds) + ->whereNotNull('current_release_id') + ->pluck('current_release_id'); + $versionIds = ArticleRelease::query() + ->whereIn('id', $releaseIds) + ->whereNotNull('root_composition_version_id') + ->pluck('root_composition_version_id'); + + return CompositionVersion::query() + ->whereIn('id', $versionIds) + ->pluck('composition_id') + ->map(fn (mixed $id): int => (int) $id) + ->unique() + ->values() + ->all(); + } + + /** + * @param list> $members + * @return list + */ + public function filmPictures(array $members): array + { + $versionIds = []; + + foreach ($members as $member) { + $target = (string) ($member['target'] ?? ''); + + if (preg_match('/^element:(\d+)$/', $target, $match) === 1) { + $versionIds[] = (int) $match[1]; + } + } + + if ($versionIds === []) { + return []; + } + + $pictures = []; + + foreach (ContentElementVersion::query()->with('element')->whereIn('id', $versionIds)->get() as $version) { + $element = $version->element; + + if (! $element instanceof ContentElement || $element->output_class !== 'film') { + continue; + } + + $image = $this->cardUrl('element', $element->id, $element->thumbnail_path); + + if ($image === null || isset($pictures[$element->id])) { + continue; + } + + $pictures[$element->id] = [ + 'id' => $element->id, + 'title' => filled($element->display_title) ? $element->display_title : $element->working_title, + 'image' => $image, + ]; + } + + return array_values($pictures); + } + + /** + * @return list + */ + public function mediaPictures(string $query): array + { + $query = trim($query); + + if (mb_strlen($query) < 2) { + return []; + } + + $like = '%'.str_replace(['%', '_'], ['', ''], $query).'%'; + + return ContentElement::query() + ->where('thumbnail_path', 'like', 'vorschau/%') + ->where(function ($builder) use ($like): void { + $builder->where('working_title', 'like', $like) + ->orWhere('display_title', 'like', $like) + ->orWhere('teaser', 'like', $like) + ->orWhere('search_terms', 'like', $like) + ->orWhere('summary', 'like', $like); + }) + ->orderBy('working_title') + ->limit(12) + ->get() + ->map(function (ContentElement $element): ?array { + $image = $this->cardUrl('element', $element->id, $element->thumbnail_path); + + if ($image === null) { + return null; + } + + return [ + 'id' => $element->id, + 'title' => filled($element->display_title) ? $element->display_title : $element->working_title, + 'image' => $image, + 'kind' => $element->editorialContentKind?->label ?: $this->outputLabel((string) $element->output_class), + ]; + }) + ->filter() + ->values() + ->all(); + } + + /** + * @param list> $members + * @return array{url: ?string, note: ?string, own: bool} + */ + public function cover(Composition $composition, array $members): array + { + $own = $this->cardUrl('komposition', $composition->id, $composition->thumbnail_path); + + if ($own !== null) { + return ['url' => $own, 'note' => null, 'own' => true]; + } + + $picture = $this->suggestPicture($members); + + if ($picture === null) { + return ['url' => null, 'note' => null, 'own' => false]; + } + + return [ + 'url' => $this->cardUrl($picture['kind'], $picture['subject'], 'vorschau/gesetzt'), + 'note' => $picture['note'], + 'own' => false, + ]; + } + + /** + * Das eigene Titelbild, sonst das erste Vorschaubild aus dem freigegebenen Aufbau. + * + * @return array{kind: string, subject: int, alt: string, note: string}|null + */ + public function visiblePicture(Composition $composition, ?CompositionVersion $version): ?array + { + if ($this->cardUrl('komposition', $composition->id, $composition->thumbnail_path) !== null) { + return [ + 'kind' => 'komposition', + 'subject' => $composition->id, + 'alt' => filled($composition->thumbnail_alt) ? (string) $composition->thumbnail_alt : $this->compositionTitle($composition), + 'note' => '', + ]; + } + + if ($version === null) { + return null; + } + + $version->loadMissing('members'); + $members = []; + + foreach ($version->members as $member) { + $members[] = [ + 'target' => $member->content_element_version_id + ? 'element:'.$member->content_element_version_id + : 'composition:'.$member->nested_composition_version_id, + ]; + } + + return $this->suggestPicture($members); + } + + /** + * @param list> $members + * @param list $seen + * @return array{kind: string, subject: int, alt: string, note: string}|null + */ + private function suggestPicture(array $members, array $seen = []): ?array + { + foreach ($members as $member) { + $target = (string) ($member['target'] ?? ''); + + if (preg_match('/^element:(\d+)$/', $target, $match) === 1) { + $version = ContentElementVersion::query()->with('element')->find((int) $match[1]); + $element = $version?->element; + + if (! $element instanceof ContentElement || $this->cardUrl('element', $element->id, $element->thumbnail_path) === null) { + continue; + } + + $title = filled($element->display_title) ? $element->display_title : $element->working_title; + + return [ + 'kind' => 'element', + 'subject' => $element->id, + 'alt' => filled($element->thumbnail_alt) ? (string) $element->thumbnail_alt : $title, + 'note' => $element->output_class === 'film' + ? 'Vorschlag aus dem Film '.$title + : 'Vorschlag aus '.$title, + ]; + } + + if (preg_match('/^composition:(\d+)$/', $target, $match) !== 1 || in_array((int) $match[1], $seen, true)) { + continue; + } + + $version = CompositionVersion::query()->with('composition', 'members')->find((int) $match[1]); + + if (! $version instanceof CompositionVersion) { + continue; + } + + $nested = $version->composition; + + if ($this->cardUrl('komposition', $nested->id, $nested->thumbnail_path) !== null) { + return [ + 'kind' => 'komposition', + 'subject' => $nested->id, + 'alt' => filled($nested->thumbnail_alt) ? (string) $nested->thumbnail_alt : $this->compositionTitle($nested), + 'note' => 'Vorschlag aus '.$this->compositionTitle($nested), + ]; + } + + $children = []; + + foreach ($version->members as $child) { + $children[] = [ + 'target' => $child->content_element_version_id + ? 'element:'.$child->content_element_version_id + : 'composition:'.$child->nested_composition_version_id, + ]; + } + + $picture = $this->suggestPicture($children, [...$seen, $version->id]); + + if ($picture !== null) { + return $picture; + } + } + + return null; + } + + public function create(string $designation, CompositionKind $kind): Composition + { + $composition = app(ContentService::class)->createComposition($designation, $kind); + $slug = match ($kind) { + CompositionKind::Kurs => 'programm', + CompositionKind::Uebung => 'modul', + default => null, + }; + $editorial = $slug === null ? null : EditorialContentKind::query()->where('slug', $slug)->first(); + + if ($editorial !== null) { + $composition->editorial_content_kind_id = $editorial->id; + $composition->save(); + } + + return $composition; + } + + public static function editUrl(Composition $composition): string + { + $kind = $composition->kind instanceof CompositionKind + ? $composition->kind + : CompositionKind::from((string) $composition->kind); + $resource = match ($kind) { + CompositionKind::Kurs => CourseResource::class, + CompositionKind::Kombination => CombinationResource::class, + CompositionKind::Uebung => ExerciseResource::class, + }; + + return $resource::getUrl('edit', ['record' => $composition]); + } + + public function compositionTitle(Composition $composition): string + { + return filled($composition->display_title) ? $composition->display_title : $composition->designation; + } + + public function outputLabel(string $outputClass): string + { + return match ($outputClass) { + 'film' => 'Film', + 'audio' => 'Hörstück', + 'bild' => 'Bild', + 'document', 'pdf' => 'Dokument', + default => 'Text', + }; + } +} diff --git a/app/Filament/Support/ElementRevision.php b/app/Filament/Support/ElementRevision.php new file mode 100644 index 0000000..c253142 --- /dev/null +++ b/app/Filament/Support/ElementRevision.php @@ -0,0 +1,103 @@ + $data + */ + public static function publish(ContentElement $record, array $data): string + { + $latest = $record->versions()->orderByDesc('number')->first(); + $metadata = []; + $incoming = IncomingFile::store($data['incoming'] ?? null); + $dropFile = (bool) ($data['drop_file'] ?? false); + $previousFile = is_array($latest?->metadata) ? ($latest->metadata['file'] ?? null) : null; + + if (is_string($incoming) && $incoming !== '') { + $metadata['incoming'] = $incoming; + } elseif (! $dropFile && is_string($previousFile) && $previousFile !== '') { + $metadata['file'] = $previousFile; + } + + $decision = is_numeric($data['decision_seconds'] ?? null) ? (int) $data['decision_seconds'] : null; + + if ($decision !== null) { + $metadata['decision_seconds'] = $decision; + } + + $body = is_string($data['body'] ?? null) ? $data['body'] : null; + $note = is_string($data['change_note'] ?? null) ? $data['change_note'] : null; + $previousDecision = is_array($latest?->metadata) && is_numeric($latest->metadata['decision_seconds'] ?? null) + ? (int) $latest->metadata['decision_seconds'] + : null; + $changed = $incoming !== null + || $dropFile + || trim((string) $body) !== trim((string) $latest?->body) + || $decision !== $previousDecision + || (is_string($note) && trim($note) !== ''); + + if (! $changed) { + return 'Text und Datei sind gleich geblieben, deshalb gibt es keine neue Fassung.'; + } + + if (trim((string) $body) === '' && $metadata === []) { + throw new DomainRuleException('Eine neue Fassung braucht einen Text oder eine Datei.'); + } + + app(ContentService::class)->publishElementVersion($record, $body, $metadata, $note); + + return $incoming !== null + ? 'Die neue Fassung ist angelegt. Die Datei wird übernommen; die bisherige Fassung bleibt.' + : 'Die neue Fassung ist angelegt. Die bisherige Fassung bleibt erhalten.'; + } + + /** + * @return list + */ + public static function fields(ContentElement $element): array + { + $latest = $element->versions()->orderByDesc('number')->first(); + + return [ + Textarea::make('body')->label('Text')->rows(8)->default($latest?->body), + EditContentElement::uploadField(), + Toggle::make('drop_file') + ->label('Datei in der neuen Fassung nicht mehr verwenden') + ->visible(fn (): bool => is_string(self::fileOf($element))), + TextInput::make('decision_seconds') + ->label('Entscheidungsmarke in Sekunden') + ->numeric() + ->minValue(0) + ->default(self::decisionOf($latest)), + TextInput::make('change_note')->label('Änderungsnotiz'), + ]; + } + + private static function fileOf(ContentElement $element): mixed + { + $latest = $element->versions()->orderByDesc('number')->first(); + + return is_array($latest?->metadata) ? ($latest->metadata['file'] ?? null) : null; + } + + private static function decisionOf(?ContentElementVersion $version): ?int + { + if (! is_array($version?->metadata) || ! is_numeric($version->metadata['decision_seconds'] ?? null)) { + return null; + } + + return (int) $version->metadata['decision_seconds']; + } +} diff --git a/app/Filament/Support/IncomingFile.php b/app/Filament/Support/IncomingFile.php new file mode 100644 index 0000000..514a27f --- /dev/null +++ b/app/Filament/Support/IncomingFile.php @@ -0,0 +1,46 @@ +getClientOriginalExtension()); + $stem = preg_replace('/[^A-Za-z0-9_-]+/', '-', pathinfo($value->getClientOriginalName(), PATHINFO_FILENAME)) ?? ''; + $stem = trim($stem, '-'); + $stem = ($stem !== '' ? $stem : 'datei').'-'.bin2hex(random_bytes(4)); + + if (preg_match('/^[a-z0-9]{1,8}$/', $extension) !== 1) { + return null; + } + + $path = $value->storeAs('inhalte', $stem.'.'.$extension, 'cms_incoming'); + + return is_string($path) && $path !== '' ? $path : null; + } + + if (! is_string($value) || $value === '' || str_contains($value, '..') || ! str_starts_with($value, 'inhalte/')) { + return null; + } + + return Storage::disk('cms_incoming')->exists($value) ? $value : null; + } +} diff --git a/app/Filament/Support/ListsCatalog.php b/app/Filament/Support/ListsCatalog.php new file mode 100644 index 0000000..c641d4e --- /dev/null +++ b/app/Filament/Support/ListsCatalog.php @@ -0,0 +1,95 @@ +> + */ + abstract protected function catalogRows(): array; + + /** + * @return array Zustandsschlüssel => Bezeichnung, beginnend mit 'alle' + */ + abstract protected function zustandOptionen(): array; + + /** + * @return array{0: string, 1: string} + */ + abstract protected function einheit(): array; + + /** + * @return array{titel: string, text: string} + */ + abstract protected function leer(): array; + + protected function bestandFilterEigenschaften(): array + { + return ['suche', 'zustand']; + } + + protected function suchPlatzhalter(): string + { + return 'Name oder Beschreibung'; + } + + public function getMaxContentWidth(): Width|string|null + { + return Width::Full; + } + + public function content(Schema $schema): Schema + { + return $schema->components([View::make('filament.verwaltung.bestand')]); + } + + public function resetFilters(): void + { + $this->suche = ''; + $this->zustand = 'alle'; + $this->bestandGrenze = Bestand::SCHRITT; + } + + /** + * @return array + */ + public function bestand(): array + { + $needle = mb_strtolower(trim($this->suche)); + $rows = array_values(array_filter($this->catalogRows(), function (array $row) use ($needle): bool { + if ($this->zustand !== 'alle' && ! in_array($this->zustand, $row['zustand'] ?? [], true)) { + return false; + } + + return $needle === '' || str_contains(mb_strtolower(implode(' ', array_filter([ + $row['titel'], $row['meta'] ?? '', $row['text'] ?? '', $row['suchtext'] ?? '', + ]))), $needle); + })); + + return [ + 'suche' => ['eigenschaft' => 'suche', 'label' => 'Suche', 'platzhalter' => $this->suchPlatzhalter()], + 'filter' => [['eigenschaft' => 'zustand', 'label' => 'Zustand', 'vorgabe' => 'alle', 'optionen' => $this->zustandOptionen()]], + 'zeilen' => $rows, + 'einheit' => $this->einheit(), + 'leer' => $this->leer(), + ]; + } +} diff --git a/app/Filament/Support/ListsCompositions.php b/app/Filament/Support/ListsCompositions.php new file mode 100644 index 0000000..bf4345c --- /dev/null +++ b/app/Filament/Support/ListsCompositions.php @@ -0,0 +1,277 @@ +query = ''; + $this->kindFilter = 'alle'; + $this->pillar = ''; + $this->visibility = 'alle'; + $this->bestandGrenze = Bestand::SCHRITT; + } + + public function hasActiveFilters(): bool + { + return trim($this->query) !== '' || $this->kindFilter !== 'alle' || $this->pillar !== '' || $this->visibility !== 'alle'; + } + + /** + * @return array + */ + public function bestand(): array + { + $fixed = $this->fixedKind(); + $einheit = match ($fixed) { + CompositionKind::Kurs => ['Programm', 'Programme'], + CompositionKind::Uebung => ['Modul', 'Module'], + CompositionKind::Kombination => ['Fachliche Kombination', 'Fachliche Kombinationen'], + default => ['Programm oder Modul', 'Programme und Module'], + }; + $gruppen = []; + + foreach ($this->dimensionFilters() as $gruppe) { + $optionen = []; + + foreach ($gruppe['values'] as $value) { + $optionen[(string) $value['id']] = $value['label']; + } + + $gruppen[] = ['label' => $gruppe['label'], 'optionen' => $optionen]; + } + + return [ + 'suche' => ['eigenschaft' => 'query', 'label' => 'Suche', 'platzhalter' => 'Titel oder Kurzbeschreibung'], + 'segmente' => $fixed === null ? [[ + 'eigenschaft' => 'kindFilter', 'label' => 'Art', 'vorgabe' => 'alle', + 'optionen' => ['alle' => 'Alle', 'programm' => 'Programme', 'modul' => 'Module'], + ]] : [], + 'filter' => [[ + 'eigenschaft' => 'visibility', 'label' => 'Stand', 'vorgabe' => 'alle', + 'optionen' => ['alle' => 'Jeder Stand', 'bibliothek' => 'In der Mitgliederbibliothek', 'verborgen' => 'Nicht in der Mitgliederbibliothek', 'entwurf' => 'Noch ohne Fassung'], + ]], + 'weitere' => $gruppen === [] ? [] : [[ + 'eigenschaft' => 'pillar', 'label' => 'Fachliche Einordnung', 'vorgabe' => '', 'alle' => 'Alle Einordnungen', 'gruppen' => $gruppen, + ]], + 'zeilen' => $this->entries(), + 'einheit' => $einheit, + 'leer' => [ + 'titel' => $fixed === CompositionKind::Kombination ? 'Noch keine fachlichen Kombinationen' : 'Noch keine '.$einheit[1], + 'text' => 'Mit „'.match ($fixed) { + CompositionKind::Kurs => 'Programm anlegen', + CompositionKind::Kombination => CompositionKind::Kombination->createLabel(), + default => 'Modul anlegen', + }.'“ oben entsteht der erste Eintrag. Der Name genügt.', + ], + ]; + } + + /** + * @return list}> + */ + public function dimensionFilters(): array + { + return app(EditorialVocabulary::class)->dimensionFilterGroups(ctype_digit($this->pillar) ? [(int) $this->pillar] : []); + } + + /** + * Zeilen der gemeinsamen Bestandsliste. + * + * @return list> + */ + public function entries(): array + { + $needle = mb_strtolower(trim($this->query)); + $catalog = app(EditorialCatalog::class); + $offered = $catalog->offeredCompositionIds(); + $pillarIds = $this->pillar === '' ? null : $this->pillarSubjects((int) $this->pillar); + $fixed = $this->fixedKind(); + $kinds = $fixed !== null ? [$fixed] : match ($this->kindFilter) { + 'programm' => [CompositionKind::Kurs], + 'modul' => [CompositionKind::Uebung], + default => [CompositionKind::Kurs, CompositionKind::Uebung], + }; + $canEdit = ContentElementResource::editor(); + $rows = []; + + $compositions = Composition::query() + ->whereIn('kind', $kinds) + ->with(['editorialContentKind', 'versions.members.contentElementVersion.element']) + ->orderBy('designation') + ->get(); + + foreach ($compositions as $composition) { + $kind = $composition->kind instanceof CompositionKind + ? $composition->kind + : CompositionKind::from((string) $composition->kind); + + if ($pillarIds !== null && ! in_array($composition->id, $pillarIds, true)) { + continue; + } + + $stand = $catalog->stand($composition); + + if (! $this->matchesVisibility($stand)) { + continue; + } + + $title = $catalog->compositionTitle($composition); + $summary = trim((string) ($composition->summary ?? '')); + $haystack = mb_strtolower($title.' '.$composition->designation.' '.$summary.' '.(string) $composition->description); + + if ($needle !== '' && ! str_contains($haystack, $needle)) { + continue; + } + + $cover = $catalog->cover($composition, $this->coverMembers($composition)); + $url = EditorialCatalog::editUrl($composition); + $rows[] = [ + 'schluessel' => 'c'.$composition->id, + 'titel' => $title, + 'meta' => $kind->deskLabel().($title !== $composition->designation ? ' · '.$composition->designation : ''), + 'text' => $summary, + 'bild' => $cover['url'], + 'bildFehlt' => 'Kein Titelbild', + 'hinweise' => filled($cover['note']) ? ['Bild: '.$cover['note']] : [], + 'symbol' => 'modul', + 'url' => $url, + 'chips' => array_map(fn (array $chip): array => [ + 'label' => $chip['label'], + 'ton' => match ($chip['tone']) { + 'pine' => 'gut', + 'yellow' => 'offen', + 'quiet' => 'leise', + default => 'neutral', + }, + ], $catalog->statusChips($composition, in_array($composition->id, $offered, true))), + 'aktionen' => array_values(array_filter([ + ['label' => 'Aufbau', 'href' => $url, 'icon' => 'modul'], + $canEdit ? ['label' => 'Redaktion', 'href' => $url.'?redaktion=1', 'icon' => 'stift'] : null, + ])), + ]; + } + + return $rows; + } + + /** + * Anlegedialog für Module und Programme; derselbe auf dem Arbeitsplatz und in den Listen. + */ + protected function createCompositionAction(CompositionKind $kind): Action + { + $label = $kind === CompositionKind::Kurs ? 'Programm' : 'Modul'; + + return Action::make($kind === CompositionKind::Kurs ? 'createProgram' : 'createModule') + ->label($label.' anlegen') + ->modalHeading('Neues '.$label) + ->modalDescription('Der Name genügt. Danach öffnet sich der Aufbau; Texte, Bilder und Einordnung folgen dort und in der Redaktion.') + ->modalSubmitActionLabel($label.' anlegen') + ->modalWidth('lg') + ->visible(fn (): bool => ContentElementResource::editor()) + ->schema([ + TextInput::make('designation')->label('Name')->required()->maxLength(255), + ]) + ->action(function (array $data) use ($kind): void { + abort_unless(ContentElementResource::editor(), 403); + $composition = app(EditorialCatalog::class)->create(trim((string) $data['designation']), $kind); + $this->redirect(EditorialCatalog::editUrl($composition), navigate: false); + }); + } + + /** + * @return list + */ + private function coverMembers(Composition $composition): array + { + $draft = $composition->working_draft; + + if (is_array($draft) && is_array($draft['members'] ?? null) && $draft['members'] !== []) { + return $draft['members']; + } + + $version = $composition->versions + ->filter(fn ($item): bool => $item->status === ContentVersionStatus::Bereit) + ->sortByDesc('number') + ->first(); + + if ($version === null) { + return []; + } + + $members = []; + + foreach ($version->members as $member) { + $members[] = ['target' => $member->content_element_version_id + ? 'element:'.$member->content_element_version_id + : 'composition:'.$member->nested_composition_version_id]; + } + + return $members; + } + + /** + * @return list + */ + private function pillarSubjects(int $valueId): array + { + return IdentityDimensionValue::query() + ->where('subject_type', (new Composition)->getMorphClass()) + ->where('editorial_dimension_value_id', $valueId) + ->pluck('subject_id') + ->map(fn (mixed $id): int => (int) $id) + ->all(); + } + + /** + * @param array{text: string, number: int|null, released_number: int|null} $stand + */ + private function matchesVisibility(array $stand): bool + { + return match ($this->visibility) { + 'bibliothek' => $stand['released_number'] !== null, + 'verborgen' => $stand['number'] !== null && $stand['released_number'] === null, + 'entwurf' => $stand['number'] === null, + default => true, + }; + } +} diff --git a/app/Filament/Support/ManagesEditorialSurface.php b/app/Filament/Support/ManagesEditorialSurface.php new file mode 100644 index 0000000..5746522 --- /dev/null +++ b/app/Filament/Support/ManagesEditorialSurface.php @@ -0,0 +1,1127 @@ + */ + public array $praesentation = []; + + /** @var list|null */ + public ?array $praesentationGespeichert = null; + + public ?string $praesentationFokus = null; + + /** @var list */ + public array $varianten = []; + + /** @var list|null */ + public ?array $variantenGespeichert = null; + + public string $variantAudience = 'kachel'; + + public string $variantField = 'teaser'; + + public string $variantBody = ''; + + public bool $ausgabeOpen = false; + + /** @var array{aktion: string, argument: int|string|null, titel: string, text: string, label: string, gefahr: bool}|null */ + public ?array $bestaetigung = null; + + public function getBreadcrumbs(): array + { + return []; + } + + public function getHeading(): string + { + return ''; + } + + public function getSubheading(): ?string + { + return null; + } + + /** + * Wer die Redaktion über die Adresse öffnet, braucht dieselben Rechte wie über den Knopf. + */ + public function mountManagesEditorialSurface(): void + { + if ($this->redaktionOpen && ! $this->canViewEditorial()) { + $this->redaktionOpen = false; + } + } + + /** + * Fragt eine folgenreiche Handlung im gemeinsamen Dialog nach. Nur die hier genannten Handlungen sind erlaubt. + */ + public function askConfirmation(string $aktion, int|string|null $argument = null): void + { + $title = null; + + if ($argument !== null && in_array($aktion, ['releaseAssigned', 'withdrawAssigned'], true)) { + $element = ContentElement::query()->find((int) $argument); + $title = $element instanceof ContentElement ? (string) ($element->display_title ?: $element->working_title) : null; + } + + $this->bestaetigung = match ($aktion) { + 'discardRedaktion' => ['aktion' => $aktion, 'argument' => null, 'titel' => 'Änderungen der Redaktion verwerfen?', 'text' => 'Texte, Präsentationsmedien und Einordnung kehren zum gespeicherten Stand zurück. Offene Eingaben im '.(($this->redaktionKopf()['zurueck'] ?? '') !== '' ? 'Ausgangseditor' : 'Editor').' bleiben erhalten.', 'label' => 'Verwerfen', 'gefahr' => true], + 'releaseAssigned' => ['aktion' => $aktion, 'argument' => $argument, 'titel' => '„'.($title ?? 'Medium').'“ für die Website freigeben?', 'text' => 'Die Freigabe gilt sofort für alle Verwendungen dieses Mediums, nicht nur hier. Gespeichert wird sie unabhängig von „Redaktion speichern“.', 'label' => 'Für die Website freigeben', 'gefahr' => false], + 'withdrawAssigned' => ['aktion' => $aktion, 'argument' => $argument, 'titel' => 'Website-Freigabe von „'.($title ?? 'Medium').'“ zurücknehmen?', 'text' => 'Das Medium verschwindet sofort aus allen öffentlichen Verwendungen. Zuordnungen und übrige Inhalte bleiben erhalten.', 'label' => 'Freigabe zurücknehmen', 'gefahr' => true], + default => $this->extraConfirmation($aktion, $argument), + }; + } + + public function confirmConfirmation(): void + { + $frage = $this->bestaetigung; + $this->bestaetigung = null; + + if ($frage === null) { + return; + } + + match ($frage['aktion']) { + 'discardRedaktion' => $this->discardRedaktion(), + 'releaseAssigned' => $this->releaseAssigned((int) $frage['argument']), + 'withdrawAssigned' => $this->withdrawAssigned((int) $frage['argument']), + default => $this->runExtraConfirmation($frage['aktion'], $frage['argument']), + }; + } + + public function cancelConfirmation(): void + { + $this->bestaetigung = null; + } + + /** + * Seiten können weitere bestätigte Handlungen ergänzen. + * + * @return array{aktion: string, argument: int|string|null, titel: string, text: string, label: string, gefahr: bool}|null + */ + protected function extraConfirmation(string $aktion, int|string|null $argument): ?array + { + return null; + } + + protected function runExtraConfirmation(string $aktion, int|string|null $argument): void {} + + public function editorialSubject(): Model + { + return $this->getRecord(); + } + + public function editorialProfile(?string $audience = null): EditorialProfile + { + return app(EditorialProfileReader::class)->read($this->editorialSubject(), $audience); + } + + public function canEditEditorial(): bool + { + return ContentElementResource::editor(); + } + + public function canReleasePresentation(): bool + { + return ContentElementResource::editor(); + } + + // ---------------------------------------------------------------- Wechsel, Status und Speichern + + public function openRedaktion(string $tab = 'texte'): void + { + abort_unless($this->canViewEditorial(), 403); + $this->redaktionWillOpen(); + $this->loadRedaktionStaging(); + $this->redaktionOpen = true; + $this->redaktionTab = in_array($tab, ['texte', 'medien', 'einordnung'], true) ? $tab : 'texte'; + $this->ausgabeOpen = false; + $this->deskFeedback = ''; + } + + /** + * Für Seiten, die beim Wechsel eigene Dialoge schließen. Offene Eingaben bleiben dabei erhalten. + */ + protected function redaktionWillOpen(): void {} + + public function closeRedaktion(): void + { + $this->redaktionOpen = false; + $this->ausgabeOpen = false; + $this->closePicker(); + $this->deskFeedback = ''; + } + + /** + * Browser-Zurück und -Vor setzen den Wert über die Adresse. Dann gelten dieselben Regeln wie beim Knopf. + */ + public function updatedRedaktionOpen(bool $value): void + { + if ($value) { + abort_unless($this->canViewEditorial(), 403); + $this->redaktionWillOpen(); + $this->loadRedaktionStaging(); + + return; + } + + $this->ausgabeOpen = false; + $this->closePicker(); + $this->deskFeedback = ''; + } + + public function showRedaktionTab(string $tab): void + { + if (in_array($tab, ['texte', 'medien', 'einordnung'], true)) { + $this->redaktionTab = $tab; + } + } + + public function canViewEditorial(): bool + { + return $this->canEditEditorial() || ContentElementResource::editor(); + } + + public function saveRedaktion(): void + { + $this->guardEditorial(); + $this->loadRedaktionStaging(); + $this->deskFeedbackError = false; + $this->redaktionFehlerFeld = ''; + + if (! $this->saveRedaktionTexte()) { + $this->deskFeedbackError = true; + $this->redaktionTab = $this->redaktionFehlerFeld === 'kindId' ? 'einordnung' : 'texte'; + + return; + } + + try { + if ($this->presentationUnsaved()) { + app(PresentationMedia::class)->commit($this->editorialSubject(), $this->praesentation, $this->deskActor(), $this->praesentationGespeichert); + } + + if ($this->variantsUnsaved()) { + $this->commitVariants(); + } + } catch (DomainRuleException $exception) { + $this->deskFeedback = 'Die Texte sind gespeichert. '.$exception->getMessage(); + $this->deskFeedbackError = true; + + return; + } + + $this->praesentationGespeichert = null; + $this->variantenGespeichert = null; + $this->praesentationFokus = null; + $this->loadRedaktionStaging(); + $this->deskFeedback = $this->redaktionSavedMessage(); + } + + public function discardRedaktion(): void + { + $this->resetRedaktionTexte(); + $this->praesentationGespeichert = null; + $this->variantenGespeichert = null; + $this->praesentationFokus = null; + $this->loadRedaktionStaging(); + $this->closePicker(); + $this->deskFeedbackError = false; + $this->deskFeedback = 'Die ungespeicherten Änderungen der Redaktion sind verworfen. Die übrige Bearbeitung bleibt unverändert.'; + } + + public function redaktionOffen(): bool + { + return $this->redaktionUnsaved() || $this->presentationUnsaved() || $this->variantsUnsaved(); + } + + /** + * Welche Register ungespeicherte Änderungen enthalten. + * + * @return array{texte: bool, medien: bool, einordnung: bool} + */ + public function redaktionOffeneRegister(): array + { + $texte = $this->variantsUnsaved(); + + foreach ($this->redaktionFelder() as $feld) { + if ($this->feldGeaendert($feld)) { + $texte = true; + } + } + + return [ + 'texte' => $texte, + 'medien' => $this->presentationUnsaved(), + 'einordnung' => $this->einordnungUnsaved(), + ]; + } + + public function redaktionUnsaved(): bool + { + return $this->textFieldsChanged() || $this->einordnungUnsaved(); + } + + /** + * @param array $feld + */ + public function feldGeaendert(array $feld): bool + { + $model = (string) $feld['model']; + + return trim((string) $this->{$model}) !== trim((string) ($feld['stored'] ?? '')); + } + + public function textFieldsChanged(): bool + { + foreach ($this->redaktionFelder() as $feld) { + if ($this->feldGeaendert($feld)) { + return true; + } + } + + return false; + } + + protected function redaktionSavedMessage(): string + { + return 'Die Redaktion ist gespeichert. Es entsteht keine neue Fassung.'; + } + + protected function loadRedaktionStaging(): void + { + if ($this->praesentationGespeichert === null) { + $this->praesentation = app(PresentationMedia::class)->staged($this->editorialSubject()); + $this->praesentationGespeichert = $this->praesentation; + } + + if ($this->variantenGespeichert === null) { + $this->varianten = $this->storedVariants(); + $this->variantenGespeichert = $this->varianten; + } + } + + // ---------------------------------------------------------------- Ausgabe prüfen + + public function openAusgabe(): void + { + $this->ausgabeOpen = $this->redaktionAusgabe() !== null; + } + + public function closeAusgabe(): void + { + $this->ausgabeOpen = false; + } + + /** + * Ausgabe des Objekts für „Ausgabe prüfen“. Null, wenn es für diese Objektart keine Ausgabe gibt. + * + * @return array{html?: string, view?: string, stand: string}|null + */ + public function redaktionAusgabe(): ?array + { + return null; + } + + // ---------------------------------------------------------------- Präsentationsmedien (Arbeitsstand) + + public function presentationUnsaved(): bool + { + if ($this->praesentationGespeichert === null) { + return false; + } + + return $this->stagingFingerprint($this->praesentation) !== $this->stagingFingerprint($this->praesentationGespeichert); + } + + /** + * @return list>}> + */ + public function presentationGroups(): array + { + $this->loadRedaktionStaging(); + + return app(PresentationMedia::class)->describe($this->praesentation); + } + + /** + * @return array + */ + public function presentationRoleOptions(): array + { + $options = []; + + foreach (PresentationRole::selectOptions() as $slug => $label) { + $options[$slug] = PresentationRole::displayLabel((string) $slug, (string) $label); + } + + return $options; + } + + public function removePresentation(string $key): void + { + $this->guardEditorial(); + $before = count($this->praesentation); + $this->praesentation = array_values(array_filter($this->praesentation, fn (array $row): bool => $row['key'] !== $key)); + + if (count($this->praesentation) === $before) { + $this->feedback('Diese Zuordnung gibt es nicht mehr.', true); + + return; + } + + $this->praesentationFokus = null; + $this->feedback('Die Zuordnung ist entfernt. Das Medium bleibt im Bestand. Wirksam wird das mit „Redaktion speichern“.'); + } + + public function movePresentation(string $key, int $direction): void + { + $this->guardEditorial(); + $index = $this->stagingIndex($key); + + if ($index === null || $direction === 0) { + return; + } + + $role = $this->praesentation[$index]['role']; + + if (! $this->roleIsOrdered($role)) { + $this->feedback('Diese Rolle hat eine einzelne Zuordnung und wird nicht sortiert.', true); + + return; + } + + $siblings = $this->stagingIndexesOfRole($role); + $position = array_search($index, $siblings, true); + $target = $position + ($direction < 0 ? -1 : 1); + + if ($position === false || ! isset($siblings[$target])) { + return; + } + + $other = $siblings[$target]; + [$this->praesentation[$index], $this->praesentation[$other]] = [$this->praesentation[$other], $this->praesentation[$index]]; + $this->praesentationFokus = $key; + $this->deskFeedback = ''; + } + + public function placePresentation(string $key, string $beforeKey): void + { + $this->guardEditorial(); + $from = $this->stagingIndex($key); + $to = $this->stagingIndex($beforeKey); + + if ($from === null || $to === null || $from === $to) { + return; + } + + $role = $this->praesentation[$from]['role']; + + if ($this->praesentation[$to]['role'] !== $role || ! $this->roleIsOrdered($role)) { + $this->feedback('Die Reihenfolge gilt nur innerhalb einer Rolle.', true); + + return; + } + + $siblings = $this->stagingIndexesOfRole($role); + $fromPosition = array_search($from, $siblings, true); + $toPosition = array_search($to, $siblings, true); + $direction = $toPosition < $fromPosition ? -1 : 1; + + for ($step = 0; $step < abs($toPosition - $fromPosition); $step++) { + $this->movePresentation($key, $direction); + } + } + + public function releaseAssigned(int $elementId): void + { + abort_unless($this->canReleasePresentation(), 403); + $element = ContentElement::query()->find($elementId); + + if (! $element instanceof ContentElement) { + $this->feedback('Das Medium fehlt.', true); + + return; + } + + $this->feedback(app(WebsiteRelease::class)->release($element, $this->deskActor())); + } + + public function withdrawAssigned(int $elementId): void + { + abort_unless($this->canReleasePresentation(), 403); + $element = ContentElement::query()->find($elementId); + + if (! $element instanceof ContentElement) { + $this->feedback('Das Medium fehlt.', true); + + return; + } + + $this->feedback(app(WebsiteRelease::class)->withdraw($element, $this->deskActor())); + } + + // ---------------------------------------------------------------- Gemeinsamer Picker + + public function openPresentationPicker(?string $role = null): void + { + $this->guardEditorial(); + $this->loadRedaktionStaging(); + $roles = $this->presentationRoleOptions(); + $this->presentationRole = $role !== null && isset($roles[$role]) ? $role : $this->defaultRole(); + $this->resetPicker('praesentation'); + $this->pickerKind = $this->defaultKindForRole($this->presentationRole); + $this->replacingKey = $this->occupiedSingleRoleKey($this->presentationRole); + } + + /** + * Erste freie Rolle für „Medien zuordnen“: das Titelbild, solange es fehlt, sonst die Galerie. + */ + protected function defaultRole(): string + { + $roles = $this->presentationRoleOptions(); + + if (isset($roles['titelbild']) && $this->stagingIndexesOfRole('titelbild') === []) { + return 'titelbild'; + } + + return isset($roles['galerie']) ? 'galerie' : (string) array_key_first($roles); + } + + /** + * Schlüssel der vorhandenen Zuordnung, wenn eine Rolle nur ein Medium erlaubt und schon belegt ist. + */ + protected function occupiedSingleRoleKey(string $role): ?string + { + if ($this->roleAllowsMany($role)) { + return null; + } + + $indexes = $this->stagingIndexesOfRole($role); + + return $indexes === [] ? null : $this->praesentation[$indexes[0]]['key']; + } + + public function beginExchange(string $key): void + { + $this->guardEditorial(); + $index = $this->stagingIndex($key); + + if ($index === null) { + $this->feedback('Diese Zuordnung gibt es nicht mehr.', true); + + return; + } + + $this->presentationRole = $this->praesentation[$index]['role']; + $this->resetPicker('austausch'); + $this->replacingKey = $key; + $this->pickerKind = $this->defaultKindForRole($this->presentationRole); + } + + public function updatedPresentationRole(string $value): void + { + if ($this->pickerPurpose === 'praesentation') { + $this->pickerKind = $this->defaultKindForRole($value); + $this->replacingKey = $this->occupiedSingleRoleKey($value); + } + + if (! in_array($value, PresentationRole::BOUND_ROLES, true)) { + $this->bindToVersion = false; + } + + if (! $this->pickerAllowsMany() && count($this->pickerMarked) > 1) { + $first = array_key_first($this->pickerMarked); + $this->pickerMarked = [$first => $this->pickerMarked[$first]]; + } + } + + public function closePicker(): void + { + $wasExchange = $this->pickerPurpose === 'austausch' && $this->pickerOpen; + $this->pickerOpen = false; + $this->pickerSelected = ''; + $this->pickerInspected = ''; + $this->pickerMarked = []; + $this->replacingKey = null; + + if ($wasExchange) { + $this->feedback('Die vorhandene Zuordnung bleibt unverändert.'); + } + } + + public function pickerAllowsMany(): bool + { + return $this->pickerPurpose === 'praesentation' && $this->roleAllowsMany($this->presentationRole); + } + + /** + * Für Seiten mit eigenem Vorschaubild: ein vorhandenes Bild als Vorschaubild übernehmen. + */ + protected function adoptThumbnailFromPicker(string $target): void {} + + public function confirmPicker(): void + { + $marked = array_keys($this->pickerMarked); + + if ($marked === []) { + return; + } + + if ($this->pickerPurpose === 'aufbau') { + $target = $marked[0]; + $this->closePicker(); + + if (method_exists($this, 'addPart')) { + $this->addPart($target); + } + + return; + } + + $this->guardEditorial(); + + if ($this->pickerPurpose === 'austausch' || ($this->pickerPurpose === 'praesentation' && $this->replacingKey !== null)) { + $this->exchangeStaged($marked[0]); + + return; + } + + if ($this->pickerPurpose === 'vorschaubild') { + $this->closePicker(); + $this->adoptThumbnailFromPicker($marked[0]); + + return; + } + + $added = []; + $notes = []; + + foreach ($marked as $target) { + $result = $this->stageTarget($target); + + if ($result === true) { + $added[] = $this->pickerMarked[$target]; + } else { + $notes[] = $result; + } + } + + $this->pickerOpen = false; + $this->pickerMarked = []; + $this->pickerSelected = ''; + $this->pickerInspected = ''; + $this->redaktionTab = 'medien'; + $label = $this->presentationRoleOptions()[$this->presentationRole] ?? 'Rolle'; + $message = $added === [] + ? '' + : (count($added) === 1 ? '„'.$added[0].'“ ist' : count($added).' Medien sind').' als '.$label.' vorgemerkt. Wirksam wird das mit „Redaktion speichern“.'; + $this->feedback(trim($message.' '.implode(' ', $notes)), $added === []); + } + + /** + * Einzelnes Ziel direkt übernehmen (Tastatur- und Testpfad für den Picker). + */ + public function assignFromPicker(string $target): void + { + if (! $this->pickerOpen) { + $this->openPresentationPicker($this->presentationRole); + } + + $this->pickerMarked = []; + $this->markPicker($target, true); + $this->confirmPicker(); + } + + /** + * @return array + */ + public function pickerKinds(): array + { + if ($this->pickerPurpose === 'vorschaubild') { + return ['bild' => 'Bilder']; + } + + if ($this->pickerPurpose === 'aufbau') { + return ['alle' => 'Alle Inhalte', 'film' => 'Filme', 'bild' => 'Bilder', 'audio' => 'Hörstücke', 'dokument' => 'Dokumente', 'text' => 'Texte', 'modul' => 'Module']; + } + + return ['alle' => 'Alle Medien', 'bild' => 'Bilder', 'film' => 'Filme', 'audio' => 'Hörstücke', 'dokument' => 'Dokumente']; + } + + /** + * @return array{art: string, titel: string} + */ + public function pickerKontext(): array + { + return ['art' => (string) ($this->redaktionKopf()['fuer'] ?? 'das Objekt'), 'titel' => $this->redaktionTitel()]; + } + + public function pickerTitle(): string + { + return match ($this->pickerPurpose) { + 'aufbau' => 'Bestandteil auswählen', + 'austausch' => 'Medium austauschen', + 'vorschaubild' => 'Vorschaubild aus dem Bestand', + default => 'Medien auswählen', + }; + } + + public function pickerConfirmLabel(): string + { + $count = count($this->pickerMarked); + + if ($this->pickerPurpose === 'praesentation' && $this->replacingKey !== null) { + return 'Austauschen'; + } + + return match ($this->pickerPurpose) { + 'aufbau' => 'In den Aufbau übernehmen', + 'austausch' => 'Austauschen', + 'vorschaubild' => 'Als Vorschaubild übernehmen', + default => $count === 1 ? '1 Medium übernehmen' : ($count === 0 ? 'Medien übernehmen' : $count.' Medien übernehmen'), + }; + } + + public function pickerReplacing(): ?array + { + if ($this->replacingKey === null) { + return null; + } + + foreach ($this->presentationGroups() as $group) { + foreach ($group['rows'] as $row) { + if ($row['key'] === $this->replacingKey) { + return $row + ['role_label' => $group['label']]; + } + } + } + + return null; + } + + protected function defaultKindForRole(string $role): string + { + return match ($role) { + 'titelbild', 'titelbild_alternativ', 'hero', 'hover', 'galerie' => 'bild', + 'trailer', 'vorschauclip', 'interview' => 'film', + 'audiovorschau' => 'audio', + default => 'alle', + }; + } + + /** + * Ein Ziel in den Arbeitsstand der gewählten Rolle aufnehmen. + */ + protected function stageTarget(string $target): true|string + { + $elementId = $this->elementIdOf($target); + + if ($elementId === null) { + return 'Präsentationsmedien sind Medien aus dem Bestand.'; + } + + $refusal = app(PresentationMedia::class)->refusal($this->editorialSubject(), $this->presentationRole, $elementId); + + if ($refusal !== null) { + return $refusal; + } + + foreach ($this->praesentation as $row) { + if ($row['role'] === $this->presentationRole && $row['element_id'] === $elementId) { + return '„'.($this->pickerMarked[$target] ?? 'Dieses Medium').'“ ist in dieser Rolle bereits zugeordnet.'; + } + } + + $row = [ + 'key' => 'n'.bin2hex(random_bytes(4)), + 'id' => null, + 'role' => $this->presentationRole, + 'element_id' => $elementId, + 'source' => $this->sourceFor($target), + ]; + + if (! $this->roleAllowsMany($this->presentationRole)) { + $existing = $this->stagingIndexesOfRole($this->presentationRole); + + if ($existing !== []) { + $this->praesentation[$existing[0]] = $row; + $this->praesentationFokus = $row['key']; + + return true; + } + } + + $this->insertStaged($row); + $this->praesentationFokus = $row['key']; + + return true; + } + + protected function exchangeStaged(string $target): void + { + $index = $this->replacingKey !== null ? $this->stagingIndex($this->replacingKey) : null; + $elementId = $this->elementIdOf($target); + + if ($index === null || $elementId === null) { + $this->closePicker(); + $this->feedback('Diese Zuordnung gibt es nicht mehr.', true); + + return; + } + + $old = $this->praesentation[$index]; + $refusal = app(PresentationMedia::class)->refusal($this->editorialSubject(), $old['role'], $elementId); + + foreach ($this->praesentation as $other) { + if ($other['key'] !== $old['key'] && $other['role'] === $old['role'] && $other['element_id'] === $elementId) { + $refusal = 'Dieses Medium ist in dieser Rolle bereits zugeordnet.'; + } + } + + if ($refusal !== null) { + $this->feedback($refusal, true); + + return; + } + + $title = $this->pickerMarked[$target] ?? 'Das neue Medium'; + $oldTitle = ContentElement::query()->whereKey($old['element_id'])->value('working_title'); + $this->praesentation[$index] = [ + 'key' => $old['element_id'] === $elementId ? $old['key'] : 'n'.bin2hex(random_bytes(4)), + 'id' => $old['element_id'] === $elementId ? $old['id'] : null, + 'role' => $old['role'], + 'element_id' => $elementId, + 'source' => $old['element_id'] === $elementId ? $old['source'] : $this->sourceFor($target, $old['role']), + ]; + $this->praesentationFokus = $this->praesentation[$index]['key']; + $this->pickerOpen = false; + $this->pickerMarked = []; + $this->pickerSelected = ''; + $this->pickerInspected = ''; + $this->replacingKey = null; + $this->feedback('„'.$title.'“ ersetzt „'.($oldTitle ?? 'die bisherige Zuordnung').'“ an derselben Stelle. Wirksam wird das mit „Redaktion speichern“.'); + } + + protected function insertStaged(array $row): void + { + $order = array_keys($this->presentationRoleOptions()); + $rank = array_search($row['role'], $order, true); + $insertAt = count($this->praesentation); + + foreach ($this->praesentation as $index => $existing) { + $existingRank = array_search($existing['role'], $order, true); + + if ($existingRank !== false && $rank !== false && $existingRank > $rank) { + $insertAt = $index; + + break; + } + } + + array_splice($this->praesentation, $insertAt, 0, [$row]); + $this->praesentation = array_values($this->praesentation); + } + + protected function elementIdOf(string $target): ?int + { + if (preg_match('/^medium:(\d+)$/', $target, $match) === 1) { + return (int) $match[1]; + } + + if (preg_match('/^element:(\d+)$/', $target, $match) === 1) { + $id = ContentElementVersion::query()->whereKey((int) $match[1])->value('content_element_id'); + + return $id !== null ? (int) $id : null; + } + + return null; + } + + protected function sourceFor(string $target, ?string $role = null): ?int + { + $role ??= $this->presentationRole; + + if (! $this->bindToVersion || ! in_array($role, PresentationRole::BOUND_ROLES, true)) { + return null; + } + + $subject = $this->editorialSubject(); + + if ($subject instanceof ContentElement) { + $id = $subject->versions()->where('status', ContentVersionStatus::Bereit)->orderByDesc('number')->value('id'); + + return $id !== null ? (int) $id : null; + } + + return preg_match('/^element:(\d+)$/', $target, $match) === 1 ? (int) $match[1] : null; + } + + protected function stagingIndex(string $key): ?int + { + foreach ($this->praesentation as $index => $row) { + if ($row['key'] === $key) { + return $index; + } + } + + return null; + } + + /** + * @return list + */ + protected function stagingIndexesOfRole(string $role): array + { + $indexes = []; + + foreach ($this->praesentation as $index => $row) { + if ($row['role'] === $role) { + $indexes[] = $index; + } + } + + return $indexes; + } + + protected function roleIsOrdered(string $role): bool + { + return (bool) PresentationRole::query()->where('slug', $role)->value('ordered'); + } + + protected function roleAllowsMany(string $role): bool + { + return (bool) PresentationRole::query()->where('slug', $role)->value('multiple'); + } + + /** + * @param list> $rows + */ + protected function stagingFingerprint(array $rows): string + { + return json_encode(array_map( + fn (array $row): array => [$row['id'], $row['role'], (int) $row['element_id'], $row['source']], + $rows, + ), JSON_THROW_ON_ERROR); + } + + // ---------------------------------------------------------------- Abweichende Formulierungen (Arbeitsstand) + + /** + * @return list + */ + public function variantRows(): array + { + $this->loadRedaktionStaging(); + + return $this->varianten; + } + + public function variantsUnsaved(): bool + { + if ($this->variantenGespeichert === null) { + return false; + } + + return $this->variantFingerprint($this->varianten) !== $this->variantFingerprint($this->variantenGespeichert); + } + + public function saveVariant(): void + { + $this->guardEditorial(); + $this->loadRedaktionStaging(); + $body = trim($this->variantBody); + + if (! in_array($this->variantField, EditorialProfileReader::TEXT_FIELDS, true) || ! array_key_exists($this->variantAudience, EditorialProfileReader::AUDIENCES)) { + $this->feedback('Diese Abweichung ist nicht vorgesehen.', true); + + return; + } + + $this->varianten = array_values(array_filter( + $this->varianten, + fn (array $row): bool => ! ($row['field'] === $this->variantField && $row['audience'] === $this->variantAudience), + )); + + if ($body !== '') { + $this->varianten[] = ['field' => $this->variantField, 'audience' => $this->variantAudience, 'body' => $body]; + } + + $this->variantBody = ''; + $this->deskFeedback = ''; + } + + public function editVariant(string $field, string $audience): void + { + foreach ($this->varianten as $row) { + if ($row['field'] === $field && $row['audience'] === $audience) { + $this->variantField = $field; + $this->variantAudience = $audience; + $this->variantBody = $row['body']; + } + } + } + + public function forgetVariant(string $field, string $audience): void + { + $this->guardEditorial(); + $this->loadRedaktionStaging(); + $this->varianten = array_values(array_filter( + $this->varianten, + fn (array $row): bool => ! ($row['field'] === $field && $row['audience'] === $audience), + )); + } + + public function variantFieldLabel(string $field): string + { + return match ($field) { + 'display_title' => 'Anzeigename', + 'teaser' => 'Teaser', + 'summary' => 'Kurzbeschreibung', + 'description' => 'Ausführliche Beschreibung', + default => $field, + }; + } + + /** + * @return list + */ + protected function storedVariants(): array + { + $subject = $this->editorialSubject(); + + return EditorialTextVariant::query() + ->where('subject_type', $subject->getMorphClass()) + ->where('subject_id', $subject->getKey()) + ->orderBy('audience') + ->orderBy('field') + ->get() + ->map(fn (EditorialTextVariant $variant): array => [ + 'field' => (string) $variant->field, + 'audience' => (string) $variant->audience, + 'body' => (string) $variant->body, + ]) + ->all(); + } + + protected function commitVariants(): void + { + $reader = app(EditorialProfileReader::class); + $subject = $this->editorialSubject(); + $wanted = []; + + foreach ($this->varianten as $row) { + $wanted[$row['field'].'|'.$row['audience']] = $row; + } + + foreach ($this->variantenGespeichert ?? [] as $row) { + if (! isset($wanted[$row['field'].'|'.$row['audience']])) { + $reader->putVariant($subject, $row['field'], $row['audience'], null, $this->deskActor()); + } + } + + foreach ($wanted as $row) { + $reader->putVariant($subject, $row['field'], $row['audience'], $row['body'], $this->deskActor()); + } + } + + /** + * @param list $rows + */ + protected function variantFingerprint(array $rows): string + { + $keys = array_map(fn (array $row): string => $row['field'].'|'.$row['audience'].'|'.trim($row['body']), $rows); + sort($keys); + + return implode("\n", $keys); + } + + // ---------------------------------------------------------------- Hilfen + + /** + * Fehlende zentrale Texte, für den Hinweis im Register Texte. + * + * @return list + */ + public function editorialGaps(): array + { + $profile = $this->editorialProfile(); + $gaps = []; + + foreach (['display_title' => 'Anzeigename', 'teaser' => 'Teaser', 'summary' => 'Kurzbeschreibung', 'description' => 'Ausführliche Beschreibung'] as $field => $label) { + if ($profile->value($field) === null) { + $gaps[] = $label; + } + } + + return $gaps; + } + + public function clearFeedback(): void + { + $this->deskFeedback = ''; + + if (property_exists($this, 'feedback')) { + $this->feedback = ''; + } + } + + protected function feedback(string $message, bool $error = false): void + { + $this->deskFeedback = $message; + $this->deskFeedbackError = $error; + } + + protected function guardEditorial(): void + { + abort_unless($this->canEditEditorial(), 403); + } + + protected function deskActor(): ?User + { + $user = auth()->user(); + + return $user instanceof User ? $user : null; + } +} diff --git a/app/Filament/Support/MediaLibrary.php b/app/Filament/Support/MediaLibrary.php new file mode 100644 index 0000000..044645b --- /dev/null +++ b/app/Filament/Support/MediaLibrary.php @@ -0,0 +1,580 @@ + + */ + public function types(): array + { + return [ + ['value' => 'film', 'label' => 'Film'], + ['value' => 'text', 'label' => 'Text'], + ['value' => 'document', 'label' => 'Dokument'], + ['value' => 'bild', 'label' => 'Bild'], + ['value' => 'audio', 'label' => 'Hörstück'], + ]; + } + + /** + * @return list + */ + public function pillars(): array + { + return Pillar::query() + ->orderBy('name') + ->get(['id', 'name']) + ->map(fn (Pillar $pillar): array => ['id' => $pillar->id, 'name' => $pillar->name]) + ->all(); + } + + /** + * @return list + */ + public function classifications(array $selectedIds = []): array + { + $options = []; + + // Gleiche Regel wie Editor und Picker; verwendete inaktive Werte und gewählte Filter bleiben auffindbar. + foreach (app(EditorialVocabulary::class)->dimensionFilterGroups($selectedIds) as $dimension) { + foreach ($dimension['values'] as $value) { + $options[] = [ + 'id' => $value['id'], + 'label' => $dimension['label'].': '.$value['label'], + ]; + } + } + + return $options; + } + + /** + * @param array $filters + * @return list> + */ + /** + * @return array + */ + public function cardFor(ContentElement $element, bool $canEdit): array + { + $element->loadMissing(['versions', 'pillars', 'editorialContentKind']); + $versionIds = $element->versions->pluck('id')->all(); + + return $this->card( + $element, + $this->portrait($element), + $this->placements($versionIds)[$element->id] ?? [], + $this->licenses($versionIds)[$element->id] ?? [], + $canEdit, + ); + } + + /** + * @param array $filters + * @return list> + */ + public function cards(array $filters, bool $canEdit): array + { + $filters = $this->normalize($filters); + $elements = ContentElement::query() + ->with(['versions', 'pillars', 'editorialContentKind']) + ->orderBy('working_title') + ->get(); + $versionIds = $elements->flatMap(fn (ContentElement $element) => $element->versions->pluck('id'))->all(); + $placements = $this->placements($versionIds); + $licenses = $this->licenses($versionIds); + $classified = $this->classifiedIds(); + $needle = mb_strtolower($filters['suche']); + $cards = []; + + foreach ($elements as $element) { + $portrait = $this->portrait($element); + $uses = $placements[$element->id] ?? []; + $codes = $licenses[$element->id] ?? []; + + if (! $this->matches($element, $portrait, $uses, $filters, $needle, $classified)) { + continue; + } + + $cards[] = $this->card($element, $portrait, $uses, $codes, $canEdit); + } + + usort($cards, fn (array $left, array $right): int => strcasecmp( + mb_strtolower($left['title']), + mb_strtolower($right['title']), + )); + + return $cards; + } + + /** + * @param array $filters + * @return array + */ + private function normalize(array $filters): array + { + return [ + 'suche' => trim($filters['suche'] ?? ''), + 'art' => $this->choice($filters['art'] ?? '', ['film', 'text', 'document', 'bild', 'audio']), + 'freigabe' => $this->choice($filters['freigabe'] ?? '', ['freigegeben', 'entwurf', 'ohne']), + 'entwurf' => $this->choice($filters['entwurf'] ?? '', ['offen', 'keiner']), + 'fassung' => $this->choice($filters['fassung'] ?? '', ['mit', 'nur']), + 'nutzung' => $this->choice($filters['nutzung'] ?? '', ['verwendet', 'unbenutzt']), + 'saeule' => ctype_digit($filters['saeule'] ?? '') ? $filters['saeule'] : '', + 'einordnung' => ctype_digit($filters['einordnung'] ?? '') ? $filters['einordnung'] : '', + 'inhaltsart' => ctype_digit($filters['inhaltsart'] ?? '') ? $filters['inhaltsart'] : '', + 'verarbeitung' => $this->choice($filters['verarbeitung'] ?? '', ['fehler', 'uebernahme']), + 'archiv' => $this->choice($filters['archiv'] ?? '', ['aktiv', 'archiviert', 'alle'], 'aktiv'), + ]; + } + + /** + * @param list $allowed + */ + private function choice(string $value, array $allowed, string $fallback = ''): string + { + return in_array($value, $allowed, true) ? $value : $fallback; + } + + /** + * @param list $versionIds + * @return array>> + */ + private function placements(array $versionIds): array + { + if ($versionIds === []) { + return []; + } + + $grouped = []; + $members = CompositionMember::query() + ->whereIn('content_element_version_id', $versionIds) + ->with(['compositionVersion.composition', 'contentElementVersion']) + ->orderBy('id') + ->get(); + + foreach ($members as $member) { + $version = $member->contentElementVersion; + $compositionVersion = $member->compositionVersion; + $composition = $compositionVersion?->composition; + + if (! $version instanceof ContentElementVersion || $compositionVersion === null || ! $composition instanceof Composition) { + continue; + } + + $elementId = $version->content_element_id; + $key = $composition->id.'-'.$compositionVersion->id.'-'.$version->id; + $role = trim((string) $member->role); + + if (! isset($grouped[$elementId][$key])) { + $grouped[$elementId][$key] = [ + 'compositionId' => $composition->id, + 'name' => $this->catalog->compositionTitle($composition), + 'type' => $this->kindLabel($composition), + 'mediumVersion' => $this->versionLabel($version), + 'mediumVersionId' => $version->id, + 'hostVersion' => 'Fassung '.$compositionVersion->number, + 'url' => EditorialCatalog::editUrl($composition), + 'roles' => [], + ]; + } + + if ($role !== '' && ! in_array($role, $grouped[$elementId][$key]['roles'], true)) { + $grouped[$elementId][$key]['roles'][] = $role; + } + } + + $placements = []; + + foreach ($grouped as $elementId => $rows) { + $list = array_values($rows); + usort($list, fn (array $left, array $right): int => [$left['type'], $left['name'], $left['hostVersion']] + <=> [$right['type'], $right['name'], $right['hostVersion']]); + $placements[$elementId] = $list; + } + + return $placements; + } + + /** + * @param list $versionIds + * @return array> + */ + private function licenses(array $versionIds): array + { + if ($versionIds === []) { + return []; + } + + $codes = []; + $contents = ReleaseContent::query() + ->whereIn('content_element_version_id', $versionIds) + ->with(['release.article', 'elementVersion']) + ->orderBy('id') + ->get(); + + foreach ($contents as $content) { + $version = $content->elementVersion; + $code = $content->release?->article?->code; + + if (! $version instanceof ContentElementVersion || ! is_string($code) || $code === '') { + continue; + } + + $codes[$version->content_element_id][$code] = $code; + } + + return array_map(fn (array $row): array => array_values($row), $codes); + } + + /** + * @return array> + */ + private function classifiedIds(): array + { + $map = []; + $rows = IdentityDimensionValue::query() + ->where('subject_type', (new ContentElement)->getMorphClass()) + ->where('origin', 'direkt') + ->get(['subject_id', 'editorial_dimension_value_id']); + + foreach ($rows as $row) { + $map[(int) $row->subject_id][] = (int) $row->editorial_dimension_value_id; + } + + return $map; + } + + /** + * @return array{ + * ready: ?ContentElementVersion, + * draft: ?ContentElementVersion, + * blocked: ?ContentElementVersion, + * versionCount: int, + * archived: bool, + * processing: ?string, + * stand: string, + * standTone: string, + * draftNote: ?string, + * blockedNote: ?string + * } + */ + private function portrait(ContentElement $element): array + { + /** @var Collection $versions */ + $versions = $element->versions->sortByDesc('number')->values(); + $ready = $versions->first(fn (ContentElementVersion $version): bool => $version->status === ContentVersionStatus::Bereit); + $draft = $versions->first(fn (ContentElementVersion $version): bool => $version->status === ContentVersionStatus::Entwurf); + $blocked = $versions->first(fn (ContentElementVersion $version): bool => $version->status === ContentVersionStatus::Gesperrt); + $processing = $this->processing($versions); + + if ($ready instanceof ContentElementVersion) { + $stand = 'Fassung '.$ready->number.' freigegeben'; + $tone = 'ready'; + } elseif ($draft instanceof ContentElementVersion) { + $stand = 'Entwurf, noch nicht freigegeben'; + $tone = 'draft'; + } elseif ($blocked instanceof ContentElementVersion) { + $stand = 'Fassung '.$blocked->number.' deaktiviert'; + $tone = 'blocked'; + } else { + $stand = 'Noch keine Fassung'; + $tone = 'quiet'; + } + + return [ + 'ready' => $ready instanceof ContentElementVersion ? $ready : null, + 'draft' => $draft instanceof ContentElementVersion ? $draft : null, + 'blocked' => $blocked instanceof ContentElementVersion ? $blocked : null, + 'versionCount' => $versions->count(), + 'archived' => $element->archived_at !== null, + 'processing' => $processing, + 'stand' => $stand, + 'standTone' => $tone, + 'draftNote' => $ready instanceof ContentElementVersion && $draft instanceof ContentElementVersion + ? 'Entwurf offen' + : null, + 'blockedNote' => $blocked instanceof ContentElementVersion && ($ready instanceof ContentElementVersion || $draft instanceof ContentElementVersion) + ? 'Fassung '.$blocked->number.' deaktiviert' + : null, + ]; + } + + /** + * @param Collection $versions + */ + private function processing(Collection $versions): ?string + { + foreach ($versions as $version) { + $meta = is_array($version->metadata) ? $version->metadata : []; + + if (is_string($meta['error'] ?? null) && trim($meta['error']) !== '') { + return 'Verarbeitungsfehler'; + } + } + + foreach ($versions as $version) { + $meta = is_array($version->metadata) ? $version->metadata : []; + $incoming = $meta['incoming'] ?? null; + $hasIncoming = (is_string($incoming) && $incoming !== '') || (is_array($incoming) && $incoming !== []); + + if ($hasIncoming && ! is_string($meta['file'] ?? null)) { + return 'Datei wird übernommen'; + } + } + + return null; + } + + /** + * @param array $portrait + * @param list> $uses + * @param array $filters + * @param array> $classified + */ + private function matches(ContentElement $element, array $portrait, array $uses, array $filters, string $needle, array $classified): bool + { + if ($needle !== '' && ! str_contains($this->haystack($element), $needle)) { + return false; + } + + if (! $this->matchesArt($element, $filters['art'])) { + return false; + } + + $onlyBlocked = $portrait['ready'] === null && $portrait['draft'] === null && $portrait['blocked'] !== null; + + if ($onlyBlocked && $filters['fassung'] === '' && $filters['archiv'] === 'aktiv') { + return false; + } + + if ($filters['archiv'] === 'aktiv' && $portrait['archived']) { + return false; + } + + if ($filters['archiv'] === 'archiviert' && ! $portrait['archived']) { + return false; + } + + if ($filters['freigabe'] === 'freigegeben' && $portrait['ready'] === null) { + return false; + } + + if ($filters['freigabe'] === 'entwurf' && ($portrait['draft'] === null || $portrait['ready'] !== null)) { + return false; + } + + if ($filters['freigabe'] === 'ohne' && $portrait['ready'] !== null) { + return false; + } + + if ($filters['entwurf'] === 'offen' && $portrait['draft'] === null) { + return false; + } + + if ($filters['entwurf'] === 'keiner' && $portrait['draft'] !== null) { + return false; + } + + if ($filters['fassung'] === 'mit' && $portrait['blocked'] === null) { + return false; + } + + if ($filters['fassung'] === 'nur' && ($portrait['blocked'] === null || $portrait['ready'] !== null || $portrait['draft'] !== null)) { + return false; + } + + $used = $this->usageCount($uses) > 0; + + if ($filters['nutzung'] === 'verwendet' && ! $used) { + return false; + } + + if ($filters['nutzung'] === 'unbenutzt' && $used) { + return false; + } + + if ($filters['saeule'] !== '' && ! $element->pillars->contains('id', (int) $filters['saeule'])) { + return false; + } + + if ($filters['einordnung'] !== '' && ! in_array((int) $filters['einordnung'], $classified[$element->id] ?? [], true)) { + return false; + } + + if ($filters['inhaltsart'] !== '' && (int) $element->editorial_content_kind_id !== (int) $filters['inhaltsart']) { + return false; + } + + if ($filters['verarbeitung'] === 'fehler' && $portrait['processing'] !== 'Verarbeitungsfehler') { + return false; + } + + if ($filters['verarbeitung'] === 'uebernahme' && $portrait['processing'] !== 'Datei wird übernommen') { + return false; + } + + return true; + } + + private function matchesArt(ContentElement $element, string $art): bool + { + if ($art === '') { + return true; + } + + $class = (string) $element->output_class; + + if ($art === 'document') { + return in_array($class, ['document', 'pdf'], true); + } + + return $class === $art; + } + + private function haystack(ContentElement $element): string + { + return mb_strtolower(implode("\n", array_filter([ + $element->working_title, + $element->display_title, + $element->description, + $element->summary, + $element->teaser, + $element->search_terms, + $element->usage_note, + ], fn (mixed $value): bool => is_string($value) && trim($value) !== ''))); + } + + /** + * @param array $portrait + * @param list> $uses + * @param list $codes + * @return array + */ + private function card(ContentElement $element, array $portrait, array $uses, array $codes, bool $canEdit): array + { + $description = trim((string) ($element->description ?: $element->summary ?: '')); + $usageNote = trim((string) $element->usage_note); + $licenseNote = trim((string) $element->license_note); + $typeKey = $this->typeKey((string) $element->output_class); + $count = $this->usageCount($uses); + + return [ + 'id' => $element->id, + 'title' => $element->working_title, + 'type' => $this->catalog->outputLabel((string) $element->output_class), + 'editorialKind' => $element->editorialContentKind?->label, + 'typeKey' => $typeKey, + 'description' => $description === '' ? null : $description, + 'usageNote' => $usageNote === '' ? null : $usageNote, + 'licenseNote' => $licenseNote === '' ? null : $licenseNote, + 'image' => ThumbnailRef::url('editorial.card', 'element', $element->id, $element->thumbnail_path), + 'imageAlt' => trim((string) ($element->thumbnail_alt ?: $element->working_title)), + 'imageNote' => $this->imageNote($element), + 'stand' => $portrait['stand'], + 'standTone' => $portrait['standTone'], + 'draftNote' => $portrait['draftNote'], + 'blockedNote' => $portrait['blockedNote'], + 'processing' => $portrait['processing'], + 'archived' => $portrait['archived'], + 'versionCount' => $portrait['versionCount'], + 'versionLabel' => $this->versionCountLabel($portrait['versionCount']), + 'usageCount' => $count, + 'usageLabel' => $count === 0 + ? 'In keinem Modul oder Programm verwendet' + : ($count === 1 ? '1 Verwendung' : $count.' Verwendungen'), + 'usages' => $uses, + 'licenseText' => $this->licenseText($codes), + 'url' => ContentElementResource::getUrl('view', ['record' => $element]), + 'editUrl' => $canEdit ? ContentElementResource::getUrl('view', ['record' => $element, 'redaktion' => 1]) : null, + ]; + } + + /** + * @param list> $uses + */ + private function usageCount(array $uses): int + { + return count(array_unique(array_column($uses, 'compositionId'))); + } + + private function versionCountLabel(int $count): ?string + { + return match ($count) { + 0 => null, + 1 => '1 Fassung', + default => $count.' Fassungen', + }; + } + + /** + * @param list $codes + */ + private function licenseText(array $codes): ?string + { + if ($codes === []) { + return null; + } + + $named = count($codes) === 1 + ? 'Im Lizenzartikel '.$codes[0].' genannt.' + : 'In den Lizenzartikeln '.implode(', ', $codes).' genannt.'; + + return $named.' Das belegt keinen Zugriff in der Bibliothek.'; + } + + private function imageNote(ContentElement $element): ?string + { + if (is_string($element->thumbnail_error) && trim($element->thumbnail_error) !== '') { + return Str::limit(trim($element->thumbnail_error), 180); + } + + return null; + } + + private function typeKey(string $outputClass): string + { + return match ($outputClass) { + 'film' => 'film', + 'audio' => 'audio', + 'bild' => 'bild', + 'document', 'pdf' => 'document', + default => 'text', + }; + } + + private function kindLabel(Composition $composition): string + { + $kind = $composition->kind; + + return ($kind instanceof CompositionKind ? $kind : CompositionKind::from((string) $kind))->deskLabel(); + } + + private function versionLabel(ContentElementVersion $version): string + { + return match ($version->status) { + ContentVersionStatus::Entwurf => 'Entwurf', + ContentVersionStatus::Gesperrt => 'Fassung '.$version->number.', deaktiviert', + default => 'Fassung '.$version->number, + }; + } +} diff --git a/app/Filament/Support/MediaUploadLimit.php b/app/Filament/Support/MediaUploadLimit.php new file mode 100644 index 0000000..1df06b6 --- /dev/null +++ b/app/Filament/Support/MediaUploadLimit.php @@ -0,0 +1,16 @@ + + */ + public static function rules(): array + { + return ['required', 'file', 'max:'.self::KILOBYTES]; + } +} diff --git a/app/Filament/Support/MediumForm.php b/app/Filament/Support/MediumForm.php new file mode 100644 index 0000000..1d9581d --- /dev/null +++ b/app/Filament/Support/MediumForm.php @@ -0,0 +1,251 @@ + + */ + public static function fields(bool $creating, ?ContentElement $element = null): array + { + $fields = [ + TextInput::make('working_title')->label('Titel')->required(), + ]; + + if ($creating) { + $fields[] = Select::make('shape')->label('Was ist das?')->options([ + 'film' => 'Film', + 'audio' => 'Hörstück', + 'bild' => 'Bild', + 'document' => 'Dokument', + 'text' => 'Text', + ])->required()->live(); + $fields[] = Textarea::make('body')->label('Text')->rows(8) + ->visible(fn ($get): bool => $get('shape') === 'text') + ->required(fn ($get): bool => $get('shape') === 'text'); + $fields[] = self::fileField() + ->visible(fn ($get): bool => filled($get('shape')) && $get('shape') !== 'text') + ->required(fn ($get): bool => filled($get('shape')) && $get('shape') !== 'text'); + $fields[] = Checkbox::make('without_version') + ->label('Eigenständiges Präsentationsmedium') + ->helperText('Bild, Film oder Hörstück ohne fachliche Inhaltsfassung. Die Datei bleibt eine technische Ableitung am Medium. Sie wird nicht lizenziert und nicht automatisch für die Website freigegeben.') + ->visible(fn ($get): bool => in_array($get('shape'), ['film', 'audio', 'bild'], true)); + } elseif ($element?->output_class === 'text') { + $fields[] = Textarea::make('body')->label('Text')->rows(8)->required(); + } + + return [ + ...$fields, + Textarea::make('description')->label('Beschreibung')->rows(4) + ->helperText('Gilt für das Medium, nicht nur für diese eine Stelle.'), + Textarea::make('usage_note')->label('Hinweise für den Einsatz')->rows(3), + Textarea::make('license_note')->label('Interner Lizenzvermerk')->rows(3) + ->helperText('Nur in der Verwaltung. Nicht in der Bibliothek und nicht auf der Website.'), + TextInput::make('thumbnail_alt')->label('Alternativtext zum Vorschaubild'), + self::thumbnailField(), + ]; + } + + public static function fileField(): FileUpload + { + return FileUpload::make('incoming') + ->label('Datei') + ->disk('cms_incoming') + ->directory('inhalte') + ->visibility('private') + ->maxSize(MediaUploadLimit::KILOBYTES) + ->panelLayout('integrated') + ->uploadProgressIndicatorPosition('center') + ->helperText('Der Balken zeigt den Upload. Film, Hörstück, Bild oder PDF. Die Übernahme läuft danach im Hintergrund.'); + } + + public static function thumbnailField(): FileUpload + { + return FileUpload::make('thumbnail_upload') + ->label('Vorschaubild') + ->disk('cms_incoming') + ->directory('vorschau') + ->visibility('private') + ->image() + ->panelLayout('integrated') + ->uploadProgressIndicatorPosition('center') + ->helperText('Erscheint in der Anzeige und als Vorschlag in Modulen und Programmen. Eine Filmstelle wählst du beim Ansehen des Mediums. Speichern legt keine Fassung an.'); + } + + /** + * @param array $data + */ + public static function create(array $data, bool $hold): ContentElement + { + $service = app(ContentService::class); + [$kind, $output] = self::shape($data['shape'] ?? null); + $element = $service->createElement($kind, $output, (string) $data['working_title']); + self::remember($element, $data); + + if ($output === 'text') { + $body = trim((string) ($data['body'] ?? '')); + + if ($body === '') { + throw new DomainRuleException('Der Text braucht einen Inhalt.'); + } + + $hold + ? $service->draftElementVersion($element, $body) + : $service->publishElementVersion($element, $body); + } else { + $incoming = IncomingFile::store($data['incoming'] ?? null); + + if ($incoming === null) { + throw new DomainRuleException('Das Medium braucht eine Datei.'); + } + + $extension = strtolower(pathinfo($incoming, PATHINFO_EXTENSION)); + $allowed = match ($data['shape'] ?? '') { + 'audio' => ['mp3', 'm4a', 'wav', 'ogg'], + 'bild' => ['png', 'jpg', 'jpeg', 'webp', 'gif'], + 'document' => ['pdf'], + default => ['mp4', 'webm', 'mov', 'm4v'], + }; + + if (! in_array($extension, $allowed, true)) { + throw new DomainRuleException('Diese Datei passt nicht zur gewählten Art.'); + } + + if (! empty($data['without_version']) && in_array($output, ['bild', 'film', 'audio'], true)) { + app(PresentationFile::class)->store($element, $incoming); + } else { + $metadata = ['incoming' => $incoming]; + + if ($hold) { + $metadata['hold'] = true; + $service->draftElementVersion($element, null, $metadata); + } else { + $service->publishElementVersion($element, null, $metadata); + } + } + } + + self::queuePreview($element, $data); + + return $element->fresh() ?? $element; + } + + /** + * @param array $data + */ + public static function update(ContentElement $element, array $data): ?ContentElementVersion + { + self::remember($element, $data); + $revised = null; + + if ($element->output_class === 'text') { + $latest = $element->versions()->orderByDesc('number')->first(); + $body = trim((string) ($data['body'] ?? '')); + + if ($latest instanceof ContentElementVersion && $body !== '') { + $revised = app(ContentService::class)->reviseElementContent($latest, $body); + } + } + + self::queuePreview($element, $data); + + return $revised; + } + + /** + * @return array + */ + public static function fill(ContentElement $element): array + { + $latest = $element->versions()->orderByDesc('number')->first(); + + return [ + 'working_title' => $element->working_title, + 'description' => $element->description, + 'usage_note' => $element->usage_note, + 'license_note' => $element->license_note, + 'thumbnail_alt' => $element->thumbnail_alt, + 'body' => $latest?->body, + ]; + } + + /** + * @param array $data + */ + public static function remember(ContentElement $element, array $data): void + { + app(ContentService::class)->describe($element, (string) $data['working_title'], $data['description'] ?? null); + app(IdentityProfile::class)->fill($element, [ + 'usage_note' => $data['usage_note'] ?? null, + 'license_note' => $data['license_note'] ?? null, + 'thumbnail_alt' => $data['thumbnail_alt'] ?? null, + ], auth()->user()); + } + + /** + * @param array $data + */ + public static function queuePreview(ContentElement $element, array $data): void + { + $path = self::previewPath($data['thumbnail_upload'] ?? null); + + if ($path === null) { + return; + } + + $element->thumbnail_error = null; + $element->save(); + DeriveThumbnail::dispatch('element', $element->id, $path); + } + + /** + * @return array{0: string, 1: string} + */ + private static function shape(mixed $shape): array + { + return match ($shape) { + 'audio' => ['audio', 'audio'], + 'bild' => ['bild', 'bild'], + 'document' => ['dokument', 'document'], + 'text' => ['text', 'text'], + 'film' => ['film', 'film'], + default => throw new DomainRuleException('Die Art des Mediums fehlt.'), + }; + } + + private static function previewPath(mixed $value): ?string + { + if (is_array($value)) { + foreach ($value as $item) { + $stored = self::previewPath($item); + + if ($stored !== null) { + return $stored; + } + } + + return null; + } + + if (! is_string($value) || $value === '' || str_contains($value, '..') || ! str_starts_with($value, 'vorschau/')) { + return null; + } + + return Storage::disk('cms_incoming')->exists($value) ? $value : null; + } +} diff --git a/app/Filament/Support/ReportsDomainRules.php b/app/Filament/Support/ReportsDomainRules.php new file mode 100644 index 0000000..161b3ca --- /dev/null +++ b/app/Filament/Support/ReportsDomainRules.php @@ -0,0 +1,19 @@ +title(is_string($detail) && $detail !== '' ? $detail : $success)->success()->send(); + } catch (DomainRuleException $exception) { + Notification::make()->title($exception->getMessage())->danger()->send(); + } + } +} diff --git a/app/Filament/Support/ReportsSectionErrors.php b/app/Filament/Support/ReportsSectionErrors.php new file mode 100644 index 0000000..8da85e3 --- /dev/null +++ b/app/Filament/Support/ReportsSectionErrors.php @@ -0,0 +1,35 @@ +data['sections'] ?? null) ? $this->data['sections'] : []; + $sectionErrors = SectionEditor::sectionErrorsFromForm($exception->errors(), $state); + + if ($sectionErrors === []) { + return; + } + + SectionEditor::notifyErrors($sectionErrors, $state); + + foreach (SectionEditor::mapErrors($sectionErrors, $state) as $key => $messages) { + if (str_ends_with($key, '.slots')) { + foreach ((array) $messages as $message) { + $exception->validator->errors()->add($key, $message); + } + } + } + } +} diff --git a/app/Filament/Support/SectionEditor.php b/app/Filament/Support/SectionEditor.php new file mode 100644 index 0000000..baf1ee2 --- /dev/null +++ b/app/Filament/Support/SectionEditor.php @@ -0,0 +1,626 @@ +label('Abschnitte') + ->hiddenLabel() + ->schema(self::sectionSchema()) + ->columns(['default' => 1, 'xl' => 2]) + ->itemLabel(fn (array $state, ?int $index): HtmlString => self::sectionLabel($state, $index)) + ->addActionLabel('Abschnitt hinzufügen') + ->addBetweenActionLabel('Abschnitt hier einfügen') + ->defaultItems(0) + ->reorderableWithButtons() + ->reorderableWithDragAndDrop() + ->cloneable() + ->collapsible() + ->deletable() + ->maxItems(PageSections::MAX_SECTIONS) + ->cloneAction(fn (Action $action): Action => $action + ->label('Abschnitt duplizieren') + ->tooltip('Abschnitt duplizieren') + ->action(function (array $arguments, Repeater $component): void { + // Die Kopie steht direkt hinter dem Original (Filament hängt sie sonst ans Seitenende). + $component->rawState(self::insertCopyAfter($component->getRawState() ?? [], (string) $arguments['item'], (string) $component->generateUuid())); + $component->callAfterStateUpdated(); + $component->shouldPartiallyRenderAfterActionsCalled() ? $component->partiallyRender() : null; + })) + ->deleteAction(fn (Action $action): Action => $action + ->label('Abschnitt löschen') + ->tooltip('Abschnitt löschen') + ->requiresConfirmation() + ->modalHeading('Abschnitt löschen?') + ->modalDescription('Der Abschnitt und die Widgets darin werden aus dem Entwurf entfernt. Bereits gespeicherte Revisionen bleiben erhalten.') + ->modalSubmitActionLabel('Löschen')) + ->moveUpAction(fn (Action $action): Action => $action->label('Abschnitt nach oben')->tooltip('Abschnitt nach oben')) + ->moveDownAction(fn (Action $action): Action => $action->label('Abschnitt nach unten')->tooltip('Abschnitt nach unten')) + ->reorderAction(fn (Action $action): Action => $action->label('Abschnitt ziehen')->tooltip('Abschnitt ziehen')) + ->extraItemActions([ + // Seiten-Arbeitsplatz (EditPage): Raster und Gestaltung im eigenen Kontext statt an jedem Abschnitt. + Action::make('gestalten') + ->label('Abschnitt gestalten') + ->icon('heroicon-o-swatch') + ->button() + ->size('sm') + ->color('gray') + ->visible(fn ($livewire): bool => is_object($livewire) && method_exists($livewire, 'openAbschnitt')) + ->action(fn (array $arguments, Repeater $component) => $component->getLivewire()->openAbschnitt((string) $arguments['item'])), + ]) + ->collapseAction(fn (Action $action): Action => $action->label('Abschnitt einklappen')->tooltip('Abschnitt einklappen')) + ->expandAction(fn (Action $action): Action => $action->label('Abschnitt aufklappen')->tooltip('Abschnitt aufklappen')) + ->extraAttributes(['class' => 'luf-sections']) + ->columnSpanFull(); + } + + /** + * @return list + */ + private static function sectionSchema(): array + { + return [ + Hidden::make('id'), + // Abschnittsgestaltung in drei Gruppen. Im Seiten-Arbeitsplatz nur im Kontext „Abschnitt gestalten“ + // sichtbar und dort offen; beim Anlegen einer Seite an jedem Abschnitt, eingeklappt. + Section::make('Raster und Breite') + ->columnSpanFull() + ->extraAttributes(['class' => 'luf-nur-gestalten luf-gestaltung']) + ->collapsible(fn ($livewire): bool => ! self::onWorkplace($livewire)) + ->collapsed(fn ($livewire): bool => ! self::onWorkplace($livewire)) + ->compact() + ->schema([ + ToggleButtons::make('layout') + ->label('Raster') + ->options(self::layoutOptions()) + ->default(SectionLayouts::DEFAULT) + ->required() + ->inline() + ->live() + ->disableOptionWhen(fn (string $value, Get $get): bool => self::filledCount($get('slots')) > SectionLayouts::slotCount($value)) + ->helperText(fn (Get $get): ?string => self::filledCount($get('slots')) > 1 + ? 'Raster mit weniger Plätzen als eingesetzten Widgets sind gesperrt. Entfernen oder verschieben Sie zuerst ein Widget; beim Wechsel geht kein Widget verloren.' + : null) + ->afterStateUpdated(function (?string $state, Get $get, Set $set): void { + $set('slots', self::arrangeSlots($get('slots'), $state ?? SectionLayouts::DEFAULT)); + }) + ->extraAttributes(['class' => 'luf-layout-picker']), + Group::make([self::widthField()])->statePath('style')->columns(['default' => 1, 'md' => 2]), + ]), + Section::make('Hintergrund') + ->extraAttributes(['class' => 'luf-nur-gestalten luf-gestaltung']) + ->collapsible(fn ($livewire): bool => ! self::onWorkplace($livewire)) + ->collapsed(fn ($livewire): bool => ! self::onWorkplace($livewire)) + ->compact() + ->schema([ + Group::make(self::backgroundFields())->statePath('style')->columns(['default' => 1, 'md' => 2]), + ]), + Section::make('Abstände und Trenner') + ->extraAttributes(['class' => 'luf-nur-gestalten luf-gestaltung']) + ->collapsible(fn ($livewire): bool => ! self::onWorkplace($livewire)) + ->collapsed(fn ($livewire): bool => ! self::onWorkplace($livewire)) + ->compact() + ->schema([ + Group::make(self::spacingFields())->statePath('style')->columns(['default' => 1, 'md' => 2]), + ]), + Repeater::make('slots') + ->columnSpanFull() + ->label('Plätze im Raster') + ->hiddenLabel() + ->schema([ + WidgetEditor::slotBuilder('widget'), + ]) + ->addable(false) + ->deletable(false) + ->reorderableWithDragAndDrop() + ->reorderableWithButtons(false) + ->reorderAction(fn (Action $action): Action => $action->label('Baustein auf einen anderen Platz ziehen')->tooltip('Baustein auf einen anderen Platz ziehen')) + ->itemLabel(fn (array $state, ?int $index, Get $get): HtmlString => self::slotLabel($state, $index, $get('layout'))) + ->default(fn (): array => self::arrangeSlots([], SectionLayouts::DEFAULT)) + ->extraAttributes(fn (Get $get): array => [ + 'class' => 'luf-slots', + 'style' => '--luf-slot-cols: '.self::editorColumns($get('layout')), + ]), + ]; + } + + private static function onWorkplace(mixed $livewire): bool + { + return is_object($livewire) && method_exists($livewire, 'openAbschnitt'); + } + + private static function widthField(): Select + { + return Select::make('width') + ->label('Inhaltsbreite') + ->options(SectionStyle::WIDTHS) + ->default('standard') + ->selectablePlaceholder(false) + ->hintIcon('heroicon-o-question-mark-circle', 'Ein Hintergrund reicht immer über die ganze Bildschirmbreite.'); + } + + /** + * Hintergrund; Bild, Ausschnitt und Überlagerung nur beim Hintergrund „Bild“. + * + * @return list + */ + private static function backgroundFields(): array + { + return [ + Select::make('background') + ->label('Hintergrund') + ->options(SectionStyle::BACKGROUNDS) + ->default('default') + ->selectablePlaceholder(false) + ->live(), + ...array_map( + fn ($field) => $field->visible(fn (Get $get): bool => $get('background') === 'image')->columnSpan(['default' => 1, 'md' => 2]), + ImageRefFields::fields('Hintergrundbild'), + ), + Select::make('focus') + ->label('Bildausschnitt (Fokuspunkt)') + ->options(SectionStyle::FOCUS) + ->default('center') + ->selectablePlaceholder(false) + ->hintIcon('heroicon-o-question-mark-circle', 'Dieser Bereich bleibt auf schmalen Bildschirmen sichtbar.') + ->visible(fn (Get $get): bool => $get('background') === 'image'), + Select::make('overlay') + ->label('Überlagerung') + ->options(SectionStyle::OVERLAYS) + ->default('light') + ->selectablePlaceholder(false) + ->hintIcon('heroicon-o-question-mark-circle', 'Sorgt für lesbaren Text auf dem Bild.') + ->visible(fn (Get $get): bool => $get('background') === 'image'), + ]; + } + + /** + * @return list + */ + private static function spacingFields(): array + { + return [ + Select::make('spacing_top') + ->label('Abstand oben') + ->options(SectionStyle::SPACINGS) + ->default(SectionStyle::DEFAULTS['spacing_top']) + ->selectablePlaceholder(false) + ->hintIcon('heroicon-o-question-mark-circle', 'Vor dem Inhalt. Zwischen zwei Abschnitten addieren sich „unten“ und „oben“; „Kein Abstand“ lässt einen Einstieg direkt unter der Kopfzeile beginnen.'), + Select::make('spacing_bottom') + ->label('Abstand unten') + ->options(SectionStyle::SPACINGS) + ->default(SectionStyle::DEFAULTS['spacing_bottom']) + ->selectablePlaceholder(false) + ->hintIcon('heroicon-o-question-mark-circle', 'Nach dem Inhalt. Bei eigener Fläche liegen beide Abstände innerhalb der Fläche.'), + Select::make('gap') + ->label('Widget-Abstand') + ->options(SectionStyle::SPACINGS) + ->default(SectionStyle::DEFAULTS['gap']) + ->selectablePlaceholder(false) + ->hintIcon('heroicon-o-question-mark-circle', 'Zwischen den Plätzen dieses Abschnitts, nebeneinander und gestapelt. Abstände innerhalb eines Widgets bleiben Sache des Widgets.'), + Select::make('divider') + ->label('Trenner zum nächsten Abschnitt') + ->options(SectionStyle::DIVIDERS) + ->default('none') + ->selectablePlaceholder(false), + ]; + } + + /** + * Gespeicherte Abschnitte (PageSections::read) als Formularzustand. + * + * @param list> $sections + * @return list> + */ + public static function toEditorState(array $sections): array + { + $state = []; + + foreach ($sections as $section) { + $slots = []; + + foreach ($section['slots'] as $widget) { + $slots[(string) Str::uuid()] = [ + 'widget' => is_array($widget) ? self::keyed(WidgetEditor::toBuilderState([$widget])) : [], + ]; + } + + $state[] = [ + 'id' => $section['id'] ?? (string) Str::uuid(), + 'layout' => $section['layout'], + 'style' => SectionStyle::fromStored($section['style'] ?? []), + 'slots' => $slots, + ]; + } + + return $state; + } + + /** + * Formularzustand als Abschnitte für PageService::saveRevision(). + * + * @param array|null $state + * @return list> + */ + public static function fromEditorState(?array $state): array + { + $sections = []; + + foreach (array_values($state ?? []) as $section) { + if (! is_array($section)) { + continue; + } + + $slots = []; + foreach (array_values(is_array($section['slots'] ?? null) ? $section['slots'] : []) as $slot) { + $items = is_array($slot['widget'] ?? null) ? $slot['widget'] : []; + $slots[] = $items === [] ? null : (WidgetEditor::fromBuilderState($items)[0] ?? null); + } + + $sections[] = [ + 'id' => $section['id'] ?? null, + 'layout' => $section['layout'] ?? SectionLayouts::DEFAULT, + 'style' => is_array($section['style'] ?? null) ? $section['style'] : [], + 'slots' => $slots, + ]; + } + + return $sections; + } + + /** + * Übersetzt Fehlerschlüssel aus PageSections ("sections.2.slots.1.data.heading") in Formularpfade. + * Widget-Fehler stehen zusätzlich als Zusammenfassung am Platzraster des Abschnitts, weil die Widget-Felder + * nach dem Schließen des Dialogs nicht sichtbar sind. + * + * @param array $errors + * @param array $state roher Formularzustand der Abschnitte + * @return array + */ + public static function mapErrors(array $errors, array $state, string $statePath = 'data.sections'): array + { + $registry = app(WidgetRegistry::class); + $sectionKeys = array_keys($state); + $mapped = []; + + foreach ($errors as $key => $messages) { + $messages = (array) $messages; + + if (preg_match('/^sections\.(\d+)(?:\.(.*))?$/', (string) $key, $match) !== 1 || ! isset($sectionKeys[(int) $match[1]])) { + $mapped[$key === 'sections' ? $statePath : 'data.'.$key] = $messages; + + continue; + } + + $sectionKey = $sectionKeys[(int) $match[1]]; + $sectionPath = "$statePath.$sectionKey"; + $rest = $match[2] ?? ''; + + if (preg_match('/^slots\.(\d+)(?:\.(.*))?$/', $rest, $slotMatch) === 1) { + $slotKeys = array_keys(is_array($state[$sectionKey]['slots'] ?? null) ? $state[$sectionKey]['slots'] : []); + $slotKey = $slotKeys[(int) $slotMatch[1]] ?? null; + $field = $slotMatch[2] ?? ''; + $position = (int) $slotMatch[1] + 1; + $widgetItems = $slotKey !== null ? ($state[$sectionKey]['slots'][$slotKey]['widget'] ?? []) : []; + $widgetKey = is_array($widgetItems) ? array_key_first($widgetItems) : null; + $type = $widgetKey !== null ? ($widgetItems[$widgetKey]['type'] ?? null) : null; + $label = $registry->has($type) ? $registry->get($type)->label() : 'Widget'; + + $summary = $mapped["$sectionPath.slots"] ?? []; + foreach ($messages as $message) { + $summary[] = "Platz $position ($label): $message"; + } + $mapped["$sectionPath.slots"] = array_values(array_unique($summary)); + + if ($slotKey !== null && $widgetKey !== null && $field !== '' && $field !== 'units') { + $field = preg_replace('/\.\d+\..*$/', '', $field); + $mapped["$sectionPath.slots.$slotKey.widget.$widgetKey.data.$field"] = $messages; + } + + continue; + } + + $mapped[$rest === '' ? $sectionPath : "$sectionPath.$rest"] = $messages; + } + + return $mapped; + } + + /** + * Formularfehler aus Widget-Dialogen ("data.sections.{uuid}.slots.{uuid}.widget.{uuid}.data.data.feld") in + * Schlüssel des Abschnittsmodells ("sections.N.slots.M.data.feld") übersetzen. + * + * @param array $errors + * @param array $state + * @return array> + */ + public static function sectionErrorsFromForm(array $errors, array $state, string $statePath = 'data.sections'): array + { + $sectionKeys = array_flip(array_map('strval', array_keys($state))); + $translated = []; + $pattern = '/^'.preg_quote($statePath, '/').'\.([^.]+)\.slots\.([^.]+)\.widget\.[^.]+\.data\.(.+)$/'; + + foreach ($errors as $key => $messages) { + if (preg_match($pattern, (string) $key, $match) !== 1 || ! isset($sectionKeys[$match[1]])) { + continue; + } + + $slotKeys = array_flip(array_map('strval', array_keys(is_array($state[$match[1]]['slots'] ?? null) ? $state[$match[1]]['slots'] : []))); + if (! isset($slotKeys[$match[2]])) { + continue; + } + + $translated['sections.'.$sectionKeys[$match[1]].'.slots.'.$slotKeys[$match[2]].'.'.$match[3]] = array_values((array) $messages); + } + + return $translated; + } + + /** + * Sichtbare Meldung mit Abschnittsnummer, Platz und Widget-Art. + * + * @param array> $errors + * @param array $state + */ + public static function notifyErrors(array $errors, array $state): void + { + $registry = app(WidgetRegistry::class); + $sections = array_values($state); + $lines = []; + + foreach ($errors as $key => $messages) { + $text = implode(' ', (array) $messages); + + if (preg_match('/^sections\.(\d+)(?:\.slots\.(\d+))?/', (string) $key, $match) === 1) { + $line = 'Abschnitt '.((int) $match[1] + 1); + + if (isset($match[2])) { + $slots = array_values(is_array($sections[(int) $match[1]]['slots'] ?? null) ? $sections[(int) $match[1]]['slots'] : []); + $items = $slots[(int) $match[2]]['widget'] ?? []; + $type = is_array($items) && $items !== [] ? (array_values($items)[0]['type'] ?? null) : null; + $line .= ', Platz '.((int) $match[2] + 1).($registry->has($type) ? ' ('.$registry->get($type)->label().')' : ''); + } + + $lines[] = $line.': '.$text; + } else { + $lines[] = $text; + } + } + + Notification::make() + ->title('Nicht gespeichert') + ->body(implode("\n", array_unique($lines))) + ->danger() + ->persistent() + ->send(); + } + + /** + * Ordnet Plätze für ein neues Raster: Widgets behalten ihre Reihenfolge, leere Plätze entfallen zuerst. + * Es wird nie ein Widget entfernt; passen nicht alle Widgets, bleiben überzählige Plätze bestehen + * (die Auswahl solcher Raster ist im Editor gesperrt, das Speichern weist sie ab). + * + * @param mixed $slots roher Zustand {uuid: {widget: {...}}} + * @return array}> + */ + public static function arrangeSlots(mixed $slots, string $layout): array + { + $slots = is_array($slots) ? $slots : []; + $count = SectionLayouts::slotCount(SectionLayouts::has($layout) ? $layout : SectionLayouts::DEFAULT); + + if (count($slots) === $count) { + return $slots; + } + + $filled = array_filter($slots, fn ($slot): bool => self::slotHasWidget($slot)); + + if (count($slots) < $count) { + $arranged = $slots; + } else { + // Leere Plätze am Ende zuerst entfernen, dann übrige leere Plätze, bis die Zahl passt. + $arranged = $slots; + foreach (array_reverse(array_keys($slots)) as $key) { + if (count($arranged) <= $count) { + break; + } + if (! self::slotHasWidget($slots[$key])) { + unset($arranged[$key]); + } + } + $arranged = count($arranged) > $count ? $filled : $arranged; + } + + while (count($arranged) < $count) { + $arranged[(string) Str::uuid()] = ['widget' => []]; + } + + return $arranged; + } + + /** + * Fügt die Kopie eines Abschnitts direkt hinter dem Original ein. Kennungen bleiben gleich; beim Speichern + * behält das Original seine Kennungen und die Kopie erhält neue. + * + * @param array $items + * @return array + */ + public static function insertCopyAfter(array $items, string $key, string $newKey): array + { + if (! array_key_exists($key, $items)) { + return $items; + } + + $result = []; + foreach ($items as $itemKey => $item) { + $result[$itemKey] = $item; + if ((string) $itemKey === $key) { + $result[$newKey] = $item; + } + } + + return $result; + } + + public static function filledCount(mixed $slots): int + { + return count(array_filter(is_array($slots) ? $slots : [], fn ($slot): bool => self::slotHasWidget($slot))); + } + + private static function slotHasWidget(mixed $slot): bool + { + return is_array($slot) && is_array($slot['widget'] ?? null) && $slot['widget'] !== []; + } + + /** + * @return array + */ + private static function layoutOptions(): array + { + $options = []; + + foreach (SectionLayouts::UNITS as $key => $units) { + $options[$key] = new HtmlString( + ''.SectionLayouts::schematicSvg($key) + .''.e(SectionLayouts::short($key)).'' + .''.e(SectionLayouts::LABELS[$key]).'' + ); + } + + return $options; + } + + /** + * Spaltenverhältnis der Plätze im Editor; entspricht dem Desktop-Raster der Website. + */ + private static function editorColumns(mixed $layout): string + { + $units = SectionLayouts::units(SectionLayouts::has($layout) ? $layout : SectionLayouts::DEFAULT); + + return implode(' ', array_map(fn (int $unit): string => "minmax(0, {$unit}fr)", $units)); + } + + /** + * @param array $state + */ + private static function sectionLabel(array $state, ?int $index): HtmlString + { + $layout = SectionLayouts::has($state['layout'] ?? null) ? $state['layout'] : SectionLayouts::DEFAULT; + $registry = app(WidgetRegistry::class); + $names = []; + + foreach (is_array($state['slots'] ?? null) ? $state['slots'] : [] as $slot) { + $items = is_array($slot['widget'] ?? null) ? $slot['widget'] : []; + $type = $items !== [] ? (array_values($items)[0]['type'] ?? null) : null; + if ($registry->has($type)) { + $names[] = $registry->get($type)->label(); + } + } + + // Kurz sichtbar: Nummer, Raster und nur abweichende Gestaltung. Vollständig im Titel und für Screenreader. + $style = SectionStyle::fromStored(is_array($state['style'] ?? null) ? $state['style'] : []); + $meta = ['Raster '.SectionLayouts::short($layout)]; + if ($style['background'] !== 'default') { + $meta[] = SectionStyle::BACKGROUNDS[$style['background']] ?? $style['background']; + } + if ($style['width'] !== 'standard') { + $meta[] = SectionStyle::WIDTHS[$style['width']] ?? $style['width']; + } + if ($style['divider'] !== 'none') { + $meta[] = 'Trenner'; + } + if ($names === []) { + $meta[] = 'noch leer'; + } + + $name = 'Abschnitt '.(($index ?? 0) + 1); + $full = 'Raster '.SectionLayouts::short($layout).' · '.SectionStyle::summary($style) + .($names === [] ? ' · noch leer' : ' · '.implode(', ', $names)); + + return new HtmlString(''.e($name).'' + .'' + .': '.e($full).''); + } + + /** + * @param array $state + */ + private static function slotLabel(array $state, ?int $index, mixed $layout): HtmlString + { + $text = self::slotText($state, $index, $layout); + + // Plätze zeigen sich über Lage und Breite; benannt werden sie nur für Screenreader oder bei einem Problem. + return str_contains($text, 'passt nicht') || str_contains($text, 'außerhalb') + ? new HtmlString(''.e($text).'') + : new HtmlString(''.e($text).''); + } + + /** + * @param array $state + */ + private static function slotText(array $state, ?int $index, mixed $layout): string + { + $layout = SectionLayouts::has($layout) ? $layout : SectionLayouts::DEFAULT; + $units = SectionLayouts::units($layout); + $position = $index ?? 0; + $slotUnits = $units[$position] ?? null; + + if ($slotUnits === null) { + return 'Platz '.($position + 1).' · außerhalb des Rasters: Widget entfernen oder Raster mit mehr Plätzen wählen'; + } + + $label = 'Platz '.($position + 1).' · '.$slotUnits.' '.($slotUnits === 1 ? 'Einheit' : 'Einheiten'); + $items = is_array($state['widget'] ?? null) ? $state['widget'] : []; + $type = $items !== [] ? (array_values($items)[0]['type'] ?? null) : null; + $registry = app(WidgetRegistry::class); + + if ($registry->has($type) && ! $registry->get($type)->supportsUnits($slotUnits)) { + $label .= ' · passt nicht: „'.$registry->get($type)->label().'“ ist für '.$registry->get($type)->unitsLabel().' Einheiten vorgesehen'; + } + + return $label; + } + + /** + * @param list> $items + * @return array> + */ + private static function keyed(array $items): array + { + $keyed = []; + foreach ($items as $item) { + $keyed[(string) Str::uuid()] = $item; + } + + return $keyed; + } +} diff --git a/app/Filament/Support/ShowsBestand.php b/app/Filament/Support/ShowsBestand.php new file mode 100644 index 0000000..5e821b6 --- /dev/null +++ b/app/Filament/Support/ShowsBestand.php @@ -0,0 +1,40 @@ + + */ + abstract public function bestand(): array; + + abstract public function resetFilters(): void; + + public function mehrAnzeigen(): void + { + $this->bestandGrenze += Bestand::SCHRITT; + } + + /** + * Eigenschaften, deren Änderung die Liste wieder oben beginnen lässt (Suche und Filter). Andere Änderungen, + * etwa Eingaben in einem geöffneten Anlegedialog, lassen die angezeigte Menge unverändert. + * + * @return list + */ + abstract protected function bestandFilterEigenschaften(): array; + + public function updatedShowsBestand(string $name): void + { + if (in_array($name, $this->bestandFilterEigenschaften(), true)) { + $this->bestandGrenze = Bestand::SCHRITT; + } + } +} diff --git a/app/Filament/Support/WidgetBlock.php b/app/Filament/Support/WidgetBlock.php new file mode 100644 index 0000000..83242fc --- /dev/null +++ b/app/Filament/Support/WidgetBlock.php @@ -0,0 +1,23 @@ + $data + */ + public function renderPreview(array $data): View + { + return view('filament.cms.widget-preview', [ + 'html' => WidgetEditor::renderPreview($this->getName(), $data), + 'stylesheets' => WidgetEditor::previewStylesheets(), + ]); + } +} diff --git a/app/Filament/Support/WidgetEditor.php b/app/Filament/Support/WidgetEditor.php new file mode 100644 index 0000000..7254bf4 --- /dev/null +++ b/app/Filament/Support/WidgetEditor.php @@ -0,0 +1,558 @@ +label('Abschnitte') + ->blocks(array_values(array_map(self::block(...), $registry->all()))) + ->blockPreviews() + ->blockPickerColumns(['default' => 1, 'md' => 2]) + ->blockPickerWidth('3xl') + ->addActionLabel('Abschnitt hinzufügen') + ->addBetweenActionLabel('Hier einfügen') + ->reorderableWithButtons() + ->reorderableWithDragAndDrop() + ->cloneable() + ->deletable() + ->maxItems(self::MAX_WIDGETS) + ->addAction(fn ($action) => $action->modalHeading('Neuen Abschnitt einrichten')->modalWidth('4xl')) + ->addBetweenAction(fn ($action) => $action->modalHeading('Neuen Abschnitt einrichten')->modalWidth('4xl')) + ->editAction(fn ($action) => $action->modalHeading('Abschnitt bearbeiten')->modalWidth('4xl')->modalSubmitActionLabel('Übernehmen')) + ->columnSpanFull(); + } + + /** + * Ein Platz im Abschnittsraster: höchstens ein Widget. Hinzufügen öffnet die Widget-Auswahl und danach den + * Bearbeitungsdialog; die Vorschau zeigt das Widget in der tatsächlichen Platzbreite. + */ + public static function slotBuilder(string $name = 'widget'): Builder + { + $registry = app(WidgetRegistry::class); + + return Builder::make($name) + ->label('Widget') + ->hiddenLabel() + ->blocks(array_values(array_map(self::block(...), $registry->all()))) + ->blockPreviews() + ->blockPickerColumns(['default' => 1, 'md' => 2]) + ->blockPickerWidth('3xl') + ->addActionLabel('Widget einsetzen') + ->maxItems(1) + ->blockNumbers(false) + ->reorderable(false) + ->cloneable(false) + ->deletable() + ->collapsible(false) + ->addAction(fn ($action) => $action->modalHeading('Widget einrichten')->modalWidth('4xl')->icon('heroicon-o-plus')) + // Baustein konfigurieren (Dokument 12, CMS-R03/R11): großer Kontext mit Vorschau. „Zur Seite“ übernimmt die + // Eingaben in den Seitenentwurf; Verwerfen ist eine ausdrückliche Handlung, Esc und Klick daneben verwerfen + // nichts still. Eine Bearbeitung direkt in der Seite war gemessen deutlich langsamer (Abnahme Teil C). + ->editAction(fn (Action $action) => $action + ->label('Konfigurieren') + ->icon('heroicon-o-adjustments-horizontal') + ->button() + ->size('sm') + ->color('gray') + ->modalHeading(fn (Builder $component, array $arguments): string => self::configureHeading($component, (string) ($arguments['item'] ?? ''))) + ->modalDescription(fn ($livewire): string => method_exists($livewire, 'openAbschnitt') + ? 'Eingaben gelten im Seitenentwurf. „Zum Seitenaufbau“ kehrt an diese Stelle zurück, „Entwurf speichern“ sichert zusätzlich die Seite.' + : 'Eingaben gelten im Entwurf der neuen Seite.') + ->modalWidth(Width::Screen) + ->modalSubmitActionLabel('Zum Seitenaufbau') + // Kein Zwischenschritt: Speichern geht direkt aus dem Baustein (übernimmt und speichert den Entwurf). + ->extraModalFooterActions(fn (Action $action, $livewire): array => method_exists($livewire, 'saveFromBlock') + ? [$action->makeModalSubmitAction('entwurfSpeichern', arguments: ['speichern' => true])->label('Entwurf speichern')->color('gray')] + : []) + ->after(function (array $arguments, $livewire): void { + if (($arguments['speichern'] ?? false) && method_exists($livewire, 'saveFromBlock')) { + $livewire->saveFromBlock(); + } + }) + ->modalCancelActionLabel('Änderungen verwerfen') + ->closeModalByClickingAway(false) + ->closeModalByEscaping(false) + ->modalCloseButton(false) + // Eigener Scrollbereich: Sonst wächst der Inhalt über das Fenster und der Dialogfuß ist bei schmalen + // Fenstern (Vorschau unter dem Formular) nicht erreichbar. + ->extraModalWindowAttributes(['class' => 'luf-baustein-dialog'])) + ->deleteAction(fn ($action) => $action->label('Baustein entfernen')->tooltip('Baustein aus diesem Platz entfernen')->requiresConfirmation()->modalHeading('Widget entfernen?')->modalDescription('Das Widget wird aus dem Entwurf entfernt. Gespeicherte Revisionen bleiben erhalten.')->modalSubmitActionLabel('Entfernen')) + ->columnSpanFull(); + } + + public static function block(WidgetType $type): Block + { + $icons = $type->optionIcons(); + $display = []; + + if (count($type->variants()) > 1) { + $display[] = ToggleButtons::make('variant') + ->label('Darstellung') + ->options($type->variants()) + ->icons($icons['variant'] ?? []) + ->default($type->defaultVariant()) + ->inline() + ->required() + ->live(); + } + + $settings = []; + $labels = $type->settingLabels(); + foreach ($type->settingOptions() as $key => $options) { + // Gemeinsame Höhe (ADR-38): immer als sichtbare Auswahl mit Vorgabe, nie als freie Eingabe. + $settings[] = $key === 'height' + ? ToggleButtons::make('height') + ->label('Höhe') + ->helperText('Gestaltungsparameter, keine Begrenzung: Längere Inhalte erhalten immer den nötigen Platz.') + ->options($options) + ->icons($icons['height'] ?? []) + ->default($type->defaultHeight()) + ->inline() + ->live() + : Select::make($key) + ->label($labels[$key][0] ?? Str::headline($key)) + ->helperText($labels[$key][1] ?? null) + ->placeholder('Vorgabe der Darstellung') + ->options($options) + ->live(); + } + + if ($settings !== []) { + $display[] = Grid::make(['default' => 1, 'md' => 2])->schema($settings)->statePath('settings'); + } + + $variantField = count($type->variants()) > 1 ? [] : [Hidden::make('variant')->default($type->defaultVariant())]; + $content = $type->editorSchema(); + $media = $type->mediaSchema(); + + if ($display === [] && $media === []) { + $schema = [Hidden::make('id'), ...$variantField, ...$content]; + } else { + $tabs = [Tab::make('Inhalt')->icon('heroicon-o-pencil-square')->schema($content)]; + if ($media !== []) { + $tabs[] = Tab::make('Medien')->icon('heroicon-o-photo')->schema($media); + } + if ($display !== []) { + $tabs[] = Tab::make('Darstellung')->icon('heroicon-o-adjustments-horizontal')->schema([ + ...$display, + Text::make('Platzbreiten: '.$type->unitsLabel().' Rastereinheiten. '.$type->narrowBehavior()), + ]); + } + + // Auf breiten Schirmen stehen Inhalt/Medien/Darstellung und die Bausteinvorschau nebeneinander. + $schema = [ + Hidden::make('id'), + ...$variantField, + Grid::make(['default' => 1, 'xl' => 5])->schema([ + Tabs::make('Widget')->tabs($tabs)->contained(false)->columnSpan(['default' => 1, 'xl' => 3]), + self::livePreview($type)->columnSpan(['default' => 1, 'xl' => 2]), + ]), + ]; + } + + return WidgetBlock::make($type->key()) + ->label(function (?array $state) use ($type): string|HtmlString { + if ($state === null) { + return self::pickerLabel($type); + } + + return self::itemLabel($type, $state); + }) + ->icon($type->icon()) + ->schema($schema) + ->preview('filament.cms.widget-preview'); + } + + /** + * „Programmkarte konfigurieren · Abschnitt 2 · Platz 2 · 1 Einheit“ aus dem Zustandspfad des Platzes. + */ + public static function configureHeading(Builder $component, string $itemKey): string + { + $registry = app(WidgetRegistry::class); + $type = $component->getRawState()[$itemKey]['type'] ?? null; + $heading = ($registry->has($type) ? $registry->get($type)->label() : 'Baustein').' konfigurieren'; + + if (preg_match('/sections\.([^.]+)\.slots\.([^.]+)\.widget$/', (string) $component->getStatePath(), $match) !== 1) { + return $heading; + } + + $sections = $component->getLivewire()->data['sections'] ?? []; + $sectionIndex = array_search($match[1], array_map('strval', array_keys(is_array($sections) ? $sections : [])), true); + $slots = is_array($sections[$match[1]]['slots'] ?? null) ? $sections[$match[1]]['slots'] : []; + $slotIndex = array_search($match[2], array_map('strval', array_keys($slots)), true); + + if ($sectionIndex === false || $slotIndex === false) { + return $heading; + } + + $layout = $sections[$match[1]]['layout'] ?? SectionLayouts::DEFAULT; + $units = SectionLayouts::units(SectionLayouts::has($layout) ? $layout : SectionLayouts::DEFAULT)[$slotIndex] ?? null; + + return $heading.' · Abschnitt '.($sectionIndex + 1).' · Platz '.($slotIndex + 1) + .($units !== null ? ' · '.$units.' '.($units === 1 ? 'Einheit' : 'Einheiten') : ''); + } + + /** + * Gespeicherte Bausteine (Altformat oder Hülle) als Builder-Zustand. + * + * @param array|null $blocks + * @return list}> + */ + public static function toBuilderState(?array $blocks): array + { + $state = []; + + foreach (app(WidgetRegistry::class)->read($blocks) as $widget) { + $state[] = [ + 'type' => $widget['type'], + 'data' => [ + 'id' => $widget['id'] ?? (string) Str::uuid(), + 'variant' => $widget['variant'], + 'settings' => $widget['settings'], + 'data' => $widget['data'], + 'refs' => $widget['refs'], + ], + ]; + } + + return $state; + } + + /** + * Builder-Zustand als Hüllen für PageService::saveRevision(). + * + * @param array|null $state + * @return list> + */ + public static function fromBuilderState(?array $state): array + { + $registry = app(WidgetRegistry::class); + $blocks = []; + + foreach (array_values($state ?? []) as $item) { + $key = $item['type'] ?? null; + $data = is_array($item['data'] ?? null) ? $item['data'] : []; + + $blocks[] = [ + 'id' => $data['id'] ?? null, + 'type' => $key, + 'v' => $registry->has($key) ? $registry->get($key)->version() : 1, + 'variant' => $data['variant'] ?? null, + 'settings' => is_array($data['settings'] ?? null) ? $data['settings'] : [], + 'data' => self::listValues(is_array($data['data'] ?? null) ? $data['data'] : []), + 'refs' => self::listValues(is_array($data['refs'] ?? null) ? $data['refs'] : []), + ]; + } + + return $blocks; + } + + /** + * Übersetzt Fehlerschlüssel des Registers ("blocks.3.data.url") in Formularpfade des Builders. + * + * @param array $errors + * @param list $itemKeys Builder-Schlüssel in Anzeigereihenfolge + * @return array + */ + public static function mapErrors(array $errors, array $itemKeys, string $statePath = 'data.blocks'): array + { + $mapped = []; + + foreach ($errors as $key => $messages) { + if (preg_match('/^blocks\.(\d+)(?:\.(.*))?$/', (string) $key, $match) === 1 && isset($itemKeys[(int) $match[1]])) { + // Verschachtelte Listen (items.2.url) tragen im Formular UUID-Schlüssel; die Meldung steht dann am Listenfeld. + $suffix = preg_replace('/\.\d+\..*$/', '', $match[2] ?? ''); + $mapped[$statePath.'.'.$itemKeys[(int) $match[1]].'.data'.($suffix !== '' ? '.'.$suffix : '')] = $messages; + + continue; + } + + $mapped['data.'.$key] = $messages; + } + + return $mapped; + } + + /** + * Fehler aus der Registry als sichtbare Meldung: Die Felder eines Abschnitts liegen im Bearbeitungsdialog + * und sind nach dem Speichern nicht auf der Seite sichtbar. Die Meldung nennt Abschnittsnummer und Art. + * + * @param array> $errors + * @param array $blocks Bausteine in Anzeigereihenfolge + */ + public static function notifyErrors(array $errors, array $blocks): void + { + $registry = app(WidgetRegistry::class); + $blocks = array_values($blocks); + $lines = []; + + foreach ($errors as $key => $messages) { + if (preg_match('/^blocks\.(\d+)/', (string) $key, $match) === 1) { + $type = $blocks[(int) $match[1]]['type'] ?? null; + $label = $registry->has($type) ? $registry->get($type)->label() : 'Abschnitt'; + $lines[] = 'Abschnitt '.((int) $match[1] + 1).' ('.$label.'): '.implode(' ', (array) $messages); + } else { + $lines[] = implode(' ', (array) $messages); + } + } + + Notification::make() + ->title('Nicht gespeichert') + ->body(implode("\n", array_unique($lines))) + ->danger() + ->persistent() + ->send(); + } + + /** Logische Vorschaubreiten in px: tatsächliche Platzbreiten im Standardabschnitt bei 1440 px Fensterbreite. */ + public const PREVIEW_UNIT_WIDTHS = [1 => 310, 2 => 640, 3 => 960, 4 => 1300]; + + public const PREVIEW_PHONE_WIDTH = 390; + + /** + * Live-Vorschau im Bearbeitungsdialog: rendert den ungespeicherten Zustand mit derselben Ansicht wie die Website + * in einer wählbaren Platzbreite. Die Breitenwahl (_preview_width) wird nicht gespeichert. + */ + private static function livePreview(WidgetType $type): Section + { + $default = (string) self::PREVIEW_UNIT_WIDTHS[$type->preferredUnits()]; + $widths = [(string) self::PREVIEW_PHONE_WIDTH => 'Smartphone']; + foreach ($type->supportedUnits() as $units) { + $widths[(string) self::PREVIEW_UNIT_WIDTHS[$units]] = $units.' '.($units === 1 ? 'Einheit' : 'Einheiten'); + } + + return Section::make('Vorschau') + ->description('Änderungen erscheinen sofort. Unter 860 px zeigt der Einstieg den Sicherheitsumbruch, Bild und Text ab 900 px zwei Spalten.') + ->collapsible() + ->compact() + ->schema([ + ToggleButtons::make('_preview_width') + ->hiddenLabel() + ->options($widths) + ->default($default) + // Beim Bearbeiten fehlt der Wert (er wird nicht gespeichert); ohne ihn zeigte die Vorschau die + // Vorgabe, ohne dass ein Knopf als gewählt markiert war. + ->afterStateHydrated(fn (ToggleButtons $component, mixed $state) => filled($state) ? null : $component->state($default)) + ->inline() + ->live() + ->dehydrated(false) + ->extraAttributes(['class' => 'luf-preview-width']), + View::make('filament.cms.widget-live-preview') + ->viewData(fn (Get $get): array => [ + 'html' => self::renderPreview($type->key(), [ + 'variant' => $get('variant'), + 'settings' => $get('settings'), + 'data' => $get('data'), + 'refs' => $get('refs'), + ]), + 'stylesheets' => self::previewStylesheets(), + 'width' => (int) ($get('_preview_width') ?: $default), + ]), + ]); + } + + /** + * Blockvorschau: dieselbe Widget-Ansicht wie öffentlich, aus dem ungespeicherten Zustand. + * + * @param array $state roher Zustand eines Builder-Eintrags + */ + public static function renderPreview(string $type, array $state): string + { + $registry = app(WidgetRegistry::class); + + if (! $registry->has($type)) { + return ''; + } + + $widget = $registry->upcast([ + 'id' => null, + 'type' => $type, + 'v' => $registry->get($type)->version(), + 'variant' => $state['variant'] ?? null, + 'settings' => is_array($state['settings'] ?? null) ? $state['settings'] : [], + 'data' => self::plainState(is_array($state['data'] ?? null) ? $state['data'] : []), + 'refs' => self::plainState(is_array($state['refs'] ?? null) ? $state['refs'] : []), + ]); + + try { + return app(WidgetRenderer::class)->renderWidget($widget, RenderContext::preview()); + } catch (Throwable $exception) { + report($exception); + + return '

Die Vorschau dieses Abschnitts ist noch unvollständig.

'; + } + } + + public static function previewStylesheets(): string + { + try { + return app(Vite::class)(['resources/css/app.css'])->toHtml(); + } catch (Throwable) { + return ''; + } + } + + private static function pickerLabel(WidgetType $type): HtmlString + { + return new HtmlString( + '' + .self::schematicSvg($type) + .''.e($type->label()).'' + .''.e($type->description()).'' + .''.e(self::unitsHint($type)).'' + ); + } + + private static function unitsHint(WidgetType $type): string + { + return $type->supportedUnits() === [1, 2, 3, 4] + ? 'Passt in jeden Platz (1 bis 4 Einheiten)' + : 'Für Plätze mit '.$type->unitsLabel().' Rastereinheiten'; + } + + /** + * @param array $state + */ + private static function itemLabel(WidgetType $type, array $state): HtmlString + { + $variant = $state['variant'] ?? $type->defaultVariant(); + $variantLabel = $type->variants()[$variant] ?? null; + + try { + $summary = $type->summary([ + 'type' => $type->key(), + 'variant' => $variant, + 'data' => self::plainState(is_array($state['data'] ?? null) ? $state['data'] : []), + 'refs' => self::plainState(is_array($state['refs'] ?? null) ? $state['refs'] : []), + 'settings' => [], + ]); + } catch (Throwable) { + $summary = ''; + } + + $parts = [$type->label()]; + if (count($type->variants()) > 1 && $variantLabel !== null) { + $parts[] = $variantLabel; + } + + $label = implode(' · ', $parts); + + // Kurzer Name des Bausteins und eine knappe Inhaltsangabe; vollständig im Titel. + return new HtmlString('' + .''.e($type->label()).'' + .($summary !== '' ? ''.e(Str::limit($summary, 60)).'' : '') + .''); + } + + private static function schematicSvg(WidgetType $type): string + { + $fills = ['ink' => '#1b2838', 'accent' => '#0f6e56', 'line' => '#c5d2cb', 'image' => '#9fb8ab']; + $rects = ''; + + foreach ($type->schematic() as [$x, $y, $w, $h, $tone]) { + $rects .= sprintf('', $x, $y, $w, $h, $fills[$tone] ?? $fills['line']); + } + + return ''; + } + + /** + * Roh-Zustand des Formulars (Repeater mit UUID-Schlüsseln, Texteditor als Dokument) in einfache Werte. + * + * @param array $state + * @return array + */ + private static function plainState(array $state): array + { + foreach ($state as $key => $value) { + if (is_array($value) && ($value['type'] ?? null) === 'doc') { + try { + $state[$key] = RichContentRenderer::make($value)->toHtml(); + } catch (Throwable) { + $state[$key] = ''; + } + + continue; + } + + if (is_array($value) && ! str_starts_with((string) $key, '_')) { + $state[$key] = self::plainState(array_is_list($value) || ! self::isUuidKeyed($value) ? $value : array_values($value)); + } + } + + return $state; + } + + /** + * @param array $values + * @return array + */ + private static function listValues(array $values): array + { + foreach ($values as $key => $value) { + if (is_array($value) && ! str_starts_with((string) $key, '_')) { + $values[$key] = self::isUuidKeyed($value) ? array_values(array_map(fn ($item) => is_array($item) ? self::listValues($item) : $item, $value)) : self::listValues($value); + } + } + + return $values; + } + + /** + * @param array $value + */ + private static function isUuidKeyed(array $value): bool + { + if ($value === []) { + return false; + } + + foreach (array_keys($value) as $key) { + if (! is_string($key) || ! Str::isUuid($key)) { + return false; + } + } + + return true; + } +} diff --git a/app/Http/Controllers/Auth/EmailVerificationController.php b/app/Http/Controllers/Auth/EmailVerificationController.php new file mode 100644 index 0000000..8e6e93e --- /dev/null +++ b/app/Http/Controllers/Auth/EmailVerificationController.php @@ -0,0 +1,41 @@ +user()->hasVerifiedEmail()) { + return redirect()->route('member.dashboard'); + } + + return view('auth.verify-email'); + } + + public function verify(EmailVerificationRequest $request): RedirectResponse + { + $request->fulfill(); + app(GrantIssuer::class)->grantRegistrationOffers($request->user()); + + return redirect()->route('member.dashboard'); + } + + public function send(Request $request): RedirectResponse + { + if ($request->user()->hasVerifiedEmail()) { + return redirect()->route('member.dashboard'); + } + + $request->user()->sendEmailVerificationNotification(); + + return back()->with('status', 'Die Nachricht ist erneut unterwegs.'); + } +} diff --git a/app/Http/Controllers/Auth/PasswordResetController.php b/app/Http/Controllers/Auth/PasswordResetController.php new file mode 100644 index 0000000..59305a8 --- /dev/null +++ b/app/Http/Controllers/Auth/PasswordResetController.php @@ -0,0 +1,61 @@ +validate(['email' => ['required', 'email']]); + + $status = Password::sendResetLink($request->only('email')); + + return $status === Password::RESET_LINK_SENT + ? back()->with('status', 'Wenn ein Konto zu dieser Adresse besteht, ist die Nachricht unterwegs.') + : back()->withErrors(['email' => 'Die Nachricht konnte nicht gesendet werden.']); + } + + public function resetForm(string $token): View + { + return view('auth.reset-password', ['token' => $token, 'email' => request('email')]); + } + + public function reset(Request $request): RedirectResponse + { + $request->validate([ + 'token' => ['required'], + 'email' => ['required', 'email'], + 'password' => ['required', 'confirmed', PasswordRule::defaults()], + ]); + + $status = Password::reset( + $request->only('email', 'password', 'password_confirmation', 'token'), + function ($user, string $password): void { + $user->forceFill([ + 'password' => $password, + 'remember_token' => Str::random(60), + ])->save(); + + event(new PasswordReset($user)); + }, + ); + + return $status === Password::PASSWORD_RESET + ? redirect()->route('login')->with('status', 'Das Passwort ist geändert. Sie können sich anmelden.') + : back()->withErrors(['email' => 'Der Link ist ungültig oder abgelaufen.']); + } +} diff --git a/app/Http/Controllers/Auth/RegistrationController.php b/app/Http/Controllers/Auth/RegistrationController.php new file mode 100644 index 0000000..fe82e68 --- /dev/null +++ b/app/Http/Controllers/Auth/RegistrationController.php @@ -0,0 +1,39 @@ +validate([ + 'name' => ['required', 'string', 'max:120'], + 'email' => ['required', 'string', 'email', 'max:255', 'unique:users,email'], + 'password' => ['required', 'confirmed', Password::defaults()], + 'adult' => ['accepted'], + ], [ + 'adult.accepted' => 'Die Plattform richtet sich an Erwachsene. Bitte bestätigen Sie das.', + ]); + + $user = $register->register($data['name'], $data['email'], $data['password'], true); + + event(new Registered($user)); + + auth()->login($user); + + return redirect()->route('verification.notice'); + } +} diff --git a/app/Http/Controllers/Auth/SessionController.php b/app/Http/Controllers/Auth/SessionController.php new file mode 100644 index 0000000..a94bfd7 --- /dev/null +++ b/app/Http/Controllers/Auth/SessionController.php @@ -0,0 +1,56 @@ +validate([ + 'email' => ['required', 'email'], + 'password' => ['required', 'string'], + ]); + + $user = User::query()->where('email', $credentials['email'])->first(); + + if ($user !== null && $user->status !== AccountStatus::Aktiv) { + throw ValidationException::withMessages([ + 'email' => 'Dieses Konto ist nicht aktiv.', + ]); + } + + if (! Auth::attempt($credentials, $request->boolean('remember'))) { + throw ValidationException::withMessages([ + 'email' => 'E-Mail oder Passwort stimmt nicht.', + ]); + } + + $request->session()->regenerate(); + + return redirect()->intended(route('member.dashboard')); + } + + public function destroy(Request $request): RedirectResponse + { + Auth::guard('web')->logout(); + + $request->session()->invalidate(); + $request->session()->regenerateToken(); + + return redirect()->route('home'); + } +} diff --git a/app/Http/Controllers/ContentPreviewController.php b/app/Http/Controllers/ContentPreviewController.php new file mode 100644 index 0000000..913e219 --- /dev/null +++ b/app/Http/Controllers/ContentPreviewController.php @@ -0,0 +1,133 @@ +authorizeStaff(); + $version->loadMissing('element'); + + return view('content.preview', [ + 'version' => $version, + 'fileUrl' => $this->fileUrl($version), + 'pending' => $this->isPending($version), + ]); + } + + public function file(ContentElementVersion $version): StreamedResponse + { + $this->authorizeStaff(); + $path = $this->storedPath($version); + abort_unless(is_string($path), 404); + + return Storage::disk('media_derived')->response($path, basename($path), [ + 'Content-Disposition' => 'inline', + ]); + } + + public function fileUrl(ContentElementVersion $version): ?string + { + return $this->storedPath($version) === null ? null : route('content.file', $version); + } + + /** + * @return array{mode: string, url: string}|null + */ + public function playback(ContentElementVersion $version): ?array + { + $version->loadMissing('element'); + + if ($version->element?->output_class !== 'film') { + return null; + } + + $mode = app(FilmPlayback::class)->mode($version->id); + $master = MediaRendition::masterPath($version->id); + + if ($mode === 'hls' && is_string($master)) { + return [ + 'mode' => 'hls', + 'url' => route('content.rendition', ['version' => $version, 'datei' => $master]), + ]; + } + + $file = $this->fileUrl($version); + + return $file === null ? null : ['mode' => 'file', 'url' => $file]; + } + + public function rendition(ContentElementVersion $version, string $datei): Response|StreamedResponse + { + $this->authorizeStaff(); + abort_unless($this->renditionBelongsTo($version->id, $datei), 404); + $disk = Storage::disk('media_derived'); + abort_unless($disk->exists($datei), 404); + + if (str_ends_with($datei, '.m3u8')) { + $body = app(HlsPlaylist::class)->rewrite( + $disk->get($datei), + $datei, + fn (string $target): string => route('content.rendition', ['version' => $version, 'datei' => $target]), + ); + + return response($body, 200, [ + 'Content-Type' => 'application/vnd.apple.mpegurl', + 'Cache-Control' => 'private, no-store', + ]); + } + + return $disk->response($datei, basename($datei), ['Content-Disposition' => 'inline']); + } + + public function isPending(ContentElementVersion $version): bool + { + if ($this->storedPath($version) !== null) { + return false; + } + + $metadata = is_array($version->metadata) ? $version->metadata : []; + $incoming = $metadata['incoming'] ?? null; + + return (is_string($incoming) && $incoming !== '') || is_array($incoming); + } + + private function storedPath(ContentElementVersion $version): ?string + { + $file = is_array($version->metadata) ? ($version->metadata['file'] ?? null) : null; + + if (! is_string($file) || $file === '' || str_contains($file, '..') || ! str_starts_with($file, 'inhalte/')) { + return null; + } + + return Storage::disk('media_derived')->exists($file) ? $file : null; + } + + private function renditionBelongsTo(int $versionId, string $path): bool + { + $prefix = 'ableitungen/'.$versionId; + + return ($path === $prefix || str_starts_with($path, $prefix.'/')) && ! str_contains($path, '..'); + } + + private function authorizeStaff(): void + { + $user = auth('staff')->user(); + abort_unless( + $user instanceof User && ($user->hasStaffRole(StaffRole::Redakteur) || $user->hasStaffRole(StaffRole::Katalogverwalter)), + 403, + ); + } +} diff --git a/app/Http/Controllers/Controller.php b/app/Http/Controllers/Controller.php new file mode 100644 index 0000000..8677cd5 --- /dev/null +++ b/app/Http/Controllers/Controller.php @@ -0,0 +1,8 @@ +authorizeStaff(); + + if ($version === null) { + $version = $composition->versions() + ->where('status', ContentVersionStatus::Bereit) + ->orderByDesc('number') + ->first(); + } + + abort_unless($version instanceof CompositionVersion, 404); + abort_unless((int) $version->composition_id === (int) $composition->id, 404); + abort_unless($version->status === ContentVersionStatus::Bereit, 404); + + return $this->render( + $composition, + $version->learning_goal, + $version->duration_minutes, + $version->material_note, + $version->number, + false, + array_map( + fn (StructureNode $node): array => $this->present($node, app(EditorialCatalog::class)), + app(CompositionStructureReader::class)->tree($version), + ), + ); + } + + public function draft(Composition $composition): View + { + $this->authorizeStaff(); + $draft = $composition->working_draft; + abort_unless(is_array($draft) && ($draft['members'] ?? null) !== null, 404); + + $catalog = app(EditorialCatalog::class); + $nodes = []; + + foreach ($draft['members'] as $member) { + if (! is_array($member)) { + continue; + } + + $row = $catalog->rowForTarget((string) ($member['target'] ?? ''), (int) $composition->id, allowSelf: true); + + if ($row === null) { + continue; + } + + $children = []; + + if (preg_match('/^composition:(\d+)$/', (string) $row['target'], $match) === 1) { + $nested = CompositionVersion::query()->find($match[1]); + + if ($nested instanceof CompositionVersion) { + $children = array_map( + fn (StructureNode $node): array => $this->present($node, $catalog), + app(CompositionStructureReader::class)->tree($nested), + ); + } + } + + $nodes[] = [ + 'role' => (string) ($member['role'] ?? $row['kind']), + 'title' => $row['title'], + 'kind' => $row['kind'], + 'version' => $row['version_label'], + 'open_url' => $row['open_url'], + 'children' => $children, + ]; + } + + return $this->render( + $composition, + $draft['learning_goal'] ?? null, + $draft['duration_minutes'] ?? null, + $draft['material_note'] ?? null, + null, + true, + $nodes, + ); + } + + public function card(string $kind, int $subject): StreamedResponse + { + $this->authorizeStaff(); + abort_unless(in_array($kind, ['element', 'komposition'], true), 404); + $model = $kind === 'komposition' + ? Composition::query()->findOrFail($subject) + : ContentElement::query()->findOrFail($subject); + $path = $model->thumbnail_path; + abort_unless(is_string($path) && str_starts_with($path, 'vorschau/') && ! str_contains($path, '..'), 404); + $disk = Storage::disk('media_derived'); + abort_unless($disk->exists($path), 404); + + return $disk->response($path); + } + + /** + * @param list> $nodes + */ + private function render( + Composition $composition, + mixed $learningGoal, + mixed $durationMinutes, + mixed $materialNote, + mixed $number, + bool $draft, + array $nodes, + ): View { + $catalog = app(EditorialCatalog::class); + + return view('filament.editorial.preview', [ + 'title' => $catalog->compositionTitle($composition), + 'summary' => $composition->summary, + 'description' => $composition->description, + 'kind' => $composition->editorialContentKind?->label + ?? ($composition->kind?->deskLabel()), + 'learningGoal' => $learningGoal, + 'durationMinutes' => $durationMinutes, + 'materialNote' => $materialNote, + 'number' => $number, + 'draft' => $draft, + 'backUrl' => $catalog->editUrl($composition), + 'nodes' => $nodes, + ]); + } + + public function frame(ContentElementVersion $version, Request $request): Response + { + $this->authorizeStaff(); + $version->loadMissing('element'); + abort_unless($version->element?->output_class === 'film', 404); + $seconds = $request->query('sekunde'); + abort_unless(is_numeric($seconds), 404); + + $bytes = app(ThumbnailDeriver::class)->jpegAtVersion($version, (float) $seconds); + abort_unless(is_string($bytes), 404); + + return response($bytes, 200, [ + 'Content-Type' => 'image/jpeg', + 'Cache-Control' => 'private, no-store', + ]); + } + + /** + * @return array + */ + private function present(StructureNode $node, EditorialCatalog $catalog): array + { + $versionLabel = null; + $openUrl = null; + + if ($node->contentElementVersionId !== null) { + $version = ContentElementVersion::query()->find($node->contentElementVersionId); + $versionLabel = $version instanceof ContentElementVersion ? 'Fassung '.$version->number : null; + $openUrl = $version instanceof ContentElementVersion ? route('content.preview', $version) : null; + } + + if ($node->compositionVersionId !== null) { + $version = CompositionVersion::query()->find($node->compositionVersionId); + $versionLabel = $version instanceof CompositionVersion ? 'Fassung '.$version->number : $versionLabel; + } + + return [ + 'role' => $node->role, + 'title' => $node->title, + 'kind' => $node->editorialKindLabel ?: ($node->outputClass !== null ? $catalog->outputLabel($node->outputClass) : $node->technicalKindLabel), + 'version' => $versionLabel, + 'open_url' => $openUrl, + 'children' => array_map( + fn (StructureNode $child): array => $this->present($child, $catalog), + $node->children, + ), + ]; + } + + private function authorizeStaff(): void + { + $user = auth('staff')->user(); + abort_unless( + $user instanceof User && ($user->hasStaffRole(StaffRole::Redakteur) || $user->hasStaffRole(StaffRole::Katalogverwalter)), + 403, + ); + } +} diff --git a/app/Http/Controllers/Member/CheckoutController.php b/app/Http/Controllers/Member/CheckoutController.php new file mode 100644 index 0000000..fa70926 --- /dev/null +++ b/app/Http/Controllers/Member/CheckoutController.php @@ -0,0 +1,100 @@ +whereHas('versions', fn ($query) => $query->where('status', OfferStatus::Aktiv)->where('holder_kind', 'person')) + ->with(['versions' => fn ($query) => $query->where('status', OfferStatus::Aktiv)]) + ->orderBy('name') + ->get(); + + return view('member.offers', ['offers' => $offers]); + } + + public function claim(Request $request, Offer $offer, GrantIssuer $issuer): RedirectResponse + { + try { + $issuer->claim($request->user(), $offer); + } catch (DomainRuleException $exception) { + return back()->withErrors(['offer' => $exception->getMessage()]); + } + + return redirect()->route('member.library')->with('status', 'Das Angebot liegt in Ihrer Bibliothek.'); + } + + public function place(Request $request, Offer $offer, Checkout $checkout): RedirectResponse + { + try { + $order = $checkout->place($request->user(), $offer); + } catch (DomainRuleException $exception) { + return back()->withErrors(['offer' => $exception->getMessage()]); + } + + return redirect()->route('member.order', $order); + } + + public function show(Request $request, Order $order): View + { + abort_unless($order->user_id === $request->user()->id, 403); + $order->load('lines.offerVersion.offer', 'payments'); + + return view('member.order', [ + 'order' => $order, + 'testPayment' => ! app()->isProduction() && config('services.payment.driver') === 'test', + ]); + } + + public function confirm(Request $request, Order $order, Checkout $checkout): RedirectResponse + { + abort_unless($order->user_id === $request->user()->id, 403); + + try { + $checkout->confirmTestPayment($order, 'test-'.$order->id); + } catch (DomainRuleException $exception) { + return back()->withErrors(['payment' => $exception->getMessage()]); + } + + return redirect()->route('member.library')->with('status', 'Die Testzahlung ist bestätigt. Die Inhalte sind in der Bibliothek.'); + } + + public function fail(Request $request, Order $order, Checkout $checkout): RedirectResponse + { + abort_unless($order->user_id === $request->user()->id, 403); + + try { + $checkout->failTestPayment($order, 'test-fail-'.$order->id); + } catch (DomainRuleException $exception) { + return back()->withErrors(['payment' => $exception->getMessage()]); + } + + return redirect()->route('member.order', $order)->with('status', 'Die Testzahlung wurde abgelehnt. Es wurde keine Berechtigung vergeben.'); + } + + public function refund(Request $request, Order $order, Checkout $checkout): RedirectResponse + { + abort_unless($order->user_id === $request->user()->id, 403); + + try { + $checkout->refund($order, 'Widerruf durch das Mitglied im Testmodus'); + } catch (DomainRuleException $exception) { + return back()->withErrors(['payment' => $exception->getMessage()]); + } + + return redirect()->route('member.order', $order)->with('status', 'Die Bestellung ist erstattet. Die Berechtigungen sind widerrufen.'); + } +} diff --git a/app/Http/Controllers/Member/LibraryController.php b/app/Http/Controllers/Member/LibraryController.php new file mode 100644 index 0000000..147fe63 --- /dev/null +++ b/app/Http/Controllers/Member/LibraryController.php @@ -0,0 +1,389 @@ +index($request->user()); + $untouched = $catalog['programs'] === [] && $catalog['modules'] === [] && $catalog['materials'] === []; + $query = trim((string) $request->query('q', '')); + $nutzung = (string) $request->query('nutzung', ''); + $dimensionIds = array_values(array_filter(array_map(intval(...), (array) $request->query('dimension', [])))); + $dimensions = app(IdentityDimension::class); + + foreach (['programs', 'modules'] as $shelf) { + if ($query !== '') { + $catalog[$shelf] = array_values(array_filter( + $catalog[$shelf], + fn (array $card): bool => $this->matches($card, $query), + )); + } + if ($dimensionIds !== []) { + $catalog[$shelf] = array_values(array_filter( + $catalog[$shelf], + fn (array $card): bool => $dimensions->matches($card['composition'], $dimensionIds), + )); + } + if (in_array($nutzung, ['nutzbar', 'teilweise', 'nicht enthalten'], true)) { + $catalog[$shelf] = array_values(array_filter( + $catalog[$shelf], + fn (array $card): bool => ($card['coverage'] ?? '') === $nutzung, + )); + } + } + + if ($query !== '') { + $catalog['materials'] = array_values(array_filter( + $catalog['materials'], + fn (array $card): bool => $this->matches($card, $query), + )); + } + + if ($dimensionIds !== []) { + $catalog['materials'] = array_values(array_filter( + $catalog['materials'], + function (array $card) use ($dimensions, $dimensionIds): bool { + $release = $card['article']->currentRelease; + $subject = $release?->rootCompositionVersion?->composition + ?? $release?->rootElementVersion?->element + ?? $card['article']; + + return $dimensions->matches($subject, $dimensionIds); + }, + )); + } + + if ($nutzung === 'teilweise' || $nutzung === 'nicht enthalten') { + $catalog['materials'] = []; + } + + return view('member.library', [ + ...$catalog, + 'query' => $query, + 'sicht' => $sicht, + 'nutzung' => $nutzung, + 'dimensionIds' => $dimensionIds, + 'filterDimensions' => app(EditorialVocabulary::class)->memberFilterDimensions(array_map(intval(...), $dimensionIds)), + 'libraryEmpty' => $untouched, + ]); + } + + public function programs(Request $request): View + { + return $this->index($request, 'programme'); + } + + public function modules(Request $request): View + { + return $this->index($request, 'module'); + } + + public function program(Request $request, Composition $composition): View + { + return view('member.program', app(LibraryCatalog::class)->program($request->user(), $composition)); + } + + public function materials(Request $request): View + { + return view('member.materials', [ + 'grants' => $this->grantQuery($request)->with('article.currentRelease.contents.elementVersion.element')->get(), + ]); + } + + public function grants(Request $request): View + { + return view('member.grants', [ + 'grants' => $this->grantQuery($request)->get(), + ]); + } + + public function show(Request $request, LicenseArticle $article): View + { + $release = $article->currentRelease()->with('contents.elementVersion.element.pillars')->first(); + $entries = []; + + if ($release !== null) { + foreach ($release->contents as $content) { + $version = $content->elementVersion; + $class = $version->element->output_class; + $metadata = is_array($version->metadata) ? $version->metadata : []; + $action = $class === 'film' || $class === 'audio' ? 'streamen' : 'ansehen'; + $decision = app(DecideAccess::class)($request->user(), $article, $release, $version, $action); + $file = $metadata['file'] ?? null; + $entries[] = [ + 'content' => $content, + 'version' => $version, + 'role' => $content->role, + 'action' => $action, + 'allowed' => $decision->allowed, + 'reason' => $decision->reason, + 'decision' => is_numeric($metadata['decision_seconds'] ?? null) + ? (int) $metadata['decision_seconds'] + : null, + 'playable' => $decision->allowed && is_string($file) && $file !== '' && ($class === 'film' || $class === 'audio'), + 'playback' => app(FilmPlayback::class)->mode($version->id), + 'pillars' => $version->element->pillars->pluck('name')->all(), + 'url' => $decision->allowed + ? SignedLink::temporary('member.media', now()->addMinutes(10), [ + 'article' => $article->id, + 'release' => $release->id, + 'version' => $version->id, + 'action' => $action, + 'reader' => $request->user()->id, + ]) + : null, + ]; + } + } + + return view('member.article', [ + 'article' => $article, + 'release' => $release, + 'entries' => $entries, + 'title' => app(CourseOutline::class)->title($article), + 'kind' => app(CourseOutline::class)->kindLabel($article), + ]); + } + + public function media( + Request $request, + LicenseArticle $article, + ArticleRelease $release, + ContentElementVersion $version, + string $action, + ): View|StreamedResponse|Response { + abort_unless(in_array($action, ['ansehen', 'streamen', 'laden'], true), 404); + abort_unless((int) $request->query('reader') === $request->user()->id, 403); + + $decision = app(DecideAccess::class)($request->user(), $article, $release, $version, $action); + abort_unless($decision->allowed && $decision->grant !== null, 403, $decision->reason); + + $version->loadMissing('element'); + $master = $action === 'streamen' ? MediaRendition::masterPath($version->id) : null; + + if (is_string($master)) { + return $this->playlist($request, $article, $release, $version, $decision->grant, $master); + } + + $file = $version->metadata['file'] ?? null; + + if (! is_string($file) || $file === '' || str_contains($file, '..')) { + $delivery = app(DeliveryLog::class)->write( + $decision->grant, + $article, + $release, + $version, + $action, + 'text', + hash('sha256', (string) $version->body), + 'k2', + ); + + return view('member.read', [ + 'article' => $article, + 'version' => $version, + 'license' => $decision->grant->rights_snapshot['purpose'] ?? null, + 'reader' => $request->user()->name, + 'copy' => $delivery->copy_id, + ]); + } + + return $this->fileResponse($decision->grant, $article, $release, $version, $action, $file, 'bestand'); + } + + public function rendition( + Request $request, + LicenseArticle $article, + ArticleRelease $release, + ContentElementVersion $version, + string $datei, + ): Response|StreamedResponse { + abort_unless((int) $request->query('reader') === $request->user()->id, 403); + abort_unless($this->renditionBelongsTo($version->id, $datei), 404); + + $decision = app(DecideAccess::class)($request->user(), $article, $release, $version, 'streamen'); + abort_unless($decision->allowed && $decision->grant !== null, 403, $decision->reason); + + if (str_ends_with($datei, '.m3u8')) { + return $this->playlist( + $request, + $article, + $release, + $version, + $decision->grant, + $datei, + str_ends_with($datei, 'master.m3u8'), + ); + } + + $disk = Storage::disk('media_derived'); + abort_unless($disk->exists($datei), 404); + + return $disk->response($datei, basename($datei), ['Content-Disposition' => 'inline']); + } + + public function thumbnail(Request $request, string $kind, int $subject): StreamedResponse + { + abort_unless(in_array($kind, ['komposition', 'element'], true), 404); + $model = $kind === 'komposition' + ? Composition::query()->findOrFail($subject) + : ContentElement::query()->findOrFail($subject); + $path = $model->thumbnail_path; + abort_unless(is_string($path) && str_starts_with($path, 'vorschau/') && ! str_contains($path, '..'), 404); + abort_unless($this->maySeeThumbnail($request, $kind, $subject), 403); + $disk = Storage::disk('media_derived'); + abort_unless($disk->exists($path), 404); + + return $disk->response($path); + } + + /** + * @param array $card + */ + private function matches(array $card, string $query): bool + { + $haystack = mb_strtolower(($card['title'] ?? '').' '.($card['summary'] ?? '')); + + return str_contains($haystack, mb_strtolower($query)); + } + + private function playlist( + Request $request, + LicenseArticle $article, + ArticleRelease $release, + ContentElementVersion $version, + Grant $grant, + string $path, + bool $record = true, + ): Response { + abort_unless($this->renditionBelongsTo($version->id, $path), 404); + $disk = Storage::disk('media_derived'); + abort_unless($disk->exists($path), 404); + $rewritten = app(HlsPlaylist::class)->rewrite( + $disk->get($path), + $path, + fn (string $target): string => SignedLink::temporary('member.rendition', now()->addMinutes(10), [ + 'article' => $article->id, + 'release' => $release->id, + 'version' => $version->id, + 'datei' => $target, + 'reader' => $request->user()->id, + ]), + ); + $copy = ''; + + if ($record) { + $delivery = app(DeliveryLog::class)->write( + $grant, + $article, + $release, + $version, + 'streamen', + 'hls', + hash('sha256', $rewritten), + 'k0', + ); + $copy = $delivery->copy_id; + } + + return response($rewritten, 200, [ + 'Content-Type' => 'application/vnd.apple.mpegurl', + 'X-License-Copy' => $copy, + ]); + } + + private function fileResponse( + Grant $grant, + LicenseArticle $article, + ArticleRelease $release, + ContentElementVersion $version, + string $action, + string $file, + string $format, + ): StreamedResponse { + $disk = Storage::disk('media_derived'); + abort_unless($disk->exists($file) && ! str_contains($file, '..'), 404); + $delivery = app(DeliveryLog::class)->write( + $grant, + $article, + $release, + $version, + $action, + $format, + hash_file('sha256', $disk->path($file)) ?: null, + 'k0', + ); + + return $disk->response($file, basename($file), [ + 'Content-Disposition' => $action === 'laden' ? 'attachment' : 'inline', + 'X-License-Copy' => $delivery->copy_id, + ]); + } + + private function renditionBelongsTo(int $versionId, string $path): bool + { + $prefix = 'ableitungen/'.$versionId; + + return ($path === $prefix || str_starts_with($path, $prefix.'/')) && ! str_contains($path, '..'); + } + + private function maySeeThumbnail(Request $request, string $kind, int $subject): bool + { + $grants = $this->grantQuery($request)->with('article.currentRelease.contents.elementVersion', 'article.currentRelease.rootCompositionVersion')->get(); + + foreach ($grants as $grant) { + $release = $grant->article->currentRelease; + + if ($release === null) { + continue; + } + + if ($kind === 'komposition' && $release->rootCompositionVersion?->composition_id === $subject) { + return true; + } + + if ($kind === 'element' && $release->contents->contains( + fn ($content): bool => $content->elementVersion?->content_element_id === $subject, + )) { + return true; + } + } + + return false; + } + + private function grantQuery(Request $request) + { + return Grant::query() + ->where('status', GrantStatus::Aktiv) + ->whereHas('acquisition', fn ($query) => $query->where('party_id', $request->user()->party_id)) + ->with('article.currentRelease') + ->orderBy('id'); + } +} diff --git a/app/Http/Controllers/Member/MemberController.php b/app/Http/Controllers/Member/MemberController.php new file mode 100644 index 0000000..ee7d33a --- /dev/null +++ b/app/Http/Controllers/Member/MemberController.php @@ -0,0 +1,48 @@ +index($request->user()); + + return view('member.dashboard', [ + 'programCount' => count($catalog['programs']), + 'moduleCount' => count($catalog['modules']), + 'materialCount' => count($catalog['materials']), + ]); + } + + public function profile(): View + { + return view('member.profile'); + } + + public function updateProfile(Request $request): RedirectResponse + { + $user = $request->user(); + + abort_if($user->status !== AccountStatus::Aktiv, 403); + + $data = $request->validate([ + 'name' => ['required', 'string', 'max:120'], + ]); + + $user->name = $data['name']; + $user->save(); + + $user->party?->update(['display_name' => $data['name']]); + $user->party?->profile?->update(['display_name' => $data['name']]); + + return redirect()->route('member.profile')->with('status', 'Der Name ist gespeichert. Er ist nicht öffentlich.'); + } +} diff --git a/app/Http/Controllers/PageController.php b/app/Http/Controllers/PageController.php new file mode 100644 index 0000000..d63cfe0 --- /dev/null +++ b/app/Http/Controllers/PageController.php @@ -0,0 +1,79 @@ +render(Page::query()->where('path', '/')->firstOrFail(), preview: false); + } + + public function show(string $path): View + { + return $this->render(Page::query()->where('path', '/'.$path)->firstOrFail(), preview: false); + } + + public function preview(PageRevision $revision): View + { + $page = $revision->page; + Gate::forUser(auth('staff')->user())->authorize('view', $page); + + return $this->render($page, preview: true, revision: $revision); + } + + /** + * Rahmen für die Vorschau einer Revision in den Breiten Smartphone, Tablet und Desktop. + */ + public function devices(PageRevision $revision): View + { + $page = $revision->page; + Gate::forUser(auth('staff')->user())->authorize('view', $page); + + return view('public.preview-devices', [ + 'page' => $page, + 'revision' => $revision, + 'isLive' => $page->published_revision_id === $revision->id, + ]); + } + + public function sitemap(): Response + { + $pages = Page::query()->whereNotNull('published_revision_id')->orderBy('path')->get(); + $themes = Pillar::query()->published()->get(); + + return response() + ->view('public.sitemap', ['pages' => $pages, 'themes' => $themes]) + ->header('Content-Type', 'application/xml'); + } + + private function render(Page $page, bool $preview, ?PageRevision $revision = null): View + { + $revision ??= $page->publishedRevision; + abort_if($revision === null, 404); + + $context = $preview ? RenderContext::preview() : RenderContext::publicPage(); + + return view('public.page', [ + 'page' => $page, + 'revision' => $revision, + 'preview' => $preview, + 'template' => app(PageTemplates::class)->viewFor($page), + 'content' => app(SectionRenderer::class)->renderAll($revision->sections(), $context), + 'documentTitle' => $revision->seo_title ?: ($revision->contentTitle() ?? config('app.name')), + 'documentDescription' => $revision->seo_description, + 'themes' => $page->path === '/' ? Pillar::query()->published()->get() : collect(), + 'activePath' => $page->path, + ]); + } +} diff --git a/app/Http/Controllers/PublicCatalogController.php b/app/Http/Controllers/PublicCatalogController.php new file mode 100644 index 0000000..5cd36b4 --- /dev/null +++ b/app/Http/Controllers/PublicCatalogController.php @@ -0,0 +1,28 @@ + $catalog->publicPrograms()]); + } + + public function program(Composition $composition, PublicCatalogReader $catalog): View + { + $version = $catalog->shownVersion($composition); + abort_if($version === null, 404); + + return view('public.program', [ + 'composition' => $composition, + 'version' => $version, + 'nodes' => app(CompositionStructureReader::class)->tree($version), + ]); + } +} diff --git a/app/Http/Controllers/PublicMediaController.php b/app/Http/Controllers/PublicMediaController.php new file mode 100644 index 0000000..7004511 --- /dev/null +++ b/app/Http/Controllers/PublicMediaController.php @@ -0,0 +1,28 @@ +present($alias->content_element_id) === null, 404); + + foreach (['media_public', 'cms_incoming'] as $disk) { + if (Storage::disk($disk)->exists($path)) { + return Storage::disk($disk)->response($path); + } + } + + abort(404); + } +} diff --git a/app/Http/Controllers/ThemeController.php b/app/Http/Controllers/ThemeController.php new file mode 100644 index 0000000..8a4ca03 --- /dev/null +++ b/app/Http/Controllers/ThemeController.php @@ -0,0 +1,44 @@ + Pillar::query()->published()->get(), + ]); + } + + public function show(string $slug): View + { + $theme = Pillar::query()->published()->where('slug', $slug)->firstOrFail(); + $pages = $theme->pages() + ->whereNotNull('published_revision_id') + ->with('publishedRevision') + ->orderBy('path') + ->get(); + + return view('public.themes.show', [ + 'theme' => $theme, + 'pages' => $pages, + 'documentDescription' => $this->description($theme), + ]); + } + + private function description(Pillar $theme): string + { + $summary = trim((string) $theme->public_summary); + $summary = preg_replace('/\s+/', ' ', $summary) ?? ''; + + if (mb_strlen($summary) <= 160) { + return $summary; + } + + return rtrim(mb_substr($summary, 0, 157)).'…'; + } +} diff --git a/app/Http/Controllers/WebsiteMediaController.php b/app/Http/Controllers/WebsiteMediaController.php new file mode 100644 index 0000000..2cbb199 --- /dev/null +++ b/app/Http/Controllers/WebsiteMediaController.php @@ -0,0 +1,25 @@ +present($element); + abort_if($presentation === null, 404); + + $path = $element->website_public_path; + abort_if(! is_string($path), 404); + + return Storage::disk('media_public')->response($path, null, [ + 'Content-Disposition' => 'inline', + 'X-Content-Type-Options' => 'nosniff', + ]); + } +} diff --git a/app/Http/CourseOutline.php b/app/Http/CourseOutline.php new file mode 100644 index 0000000..2c4df90 --- /dev/null +++ b/app/Http/CourseOutline.php @@ -0,0 +1,58 @@ +currentRelease; + + if ($release === null) { + return $article->code; + } + + $release->loadMissing([ + 'rootCompositionVersion.composition', + 'rootElementVersion.element', + ]); + + $composition = $release->rootCompositionVersion?->composition; + $element = $release->rootElementVersion?->element; + + return (filled($composition?->display_title) ? $composition->display_title : null) + ?? $composition?->designation + ?? (filled($element?->display_title) ? $element->display_title : null) + ?? $element?->working_title + ?? $release->classification_note + ?? $article->code; + } + + public function kindLabel(LicenseArticle $article): ?string + { + $release = $article->currentRelease; + + if ($release === null) { + return null; + } + + $release->loadMissing([ + 'rootCompositionVersion.composition.editorialContentKind', + 'rootElementVersion.element.editorialContentKind', + ]); + + $editorial = $release->rootCompositionVersion?->composition?->editorialContentKind?->label + ?? $release->rootElementVersion?->element?->editorialContentKind?->label; + + if ($editorial !== null) { + return $editorial; + } + + $kind = $release->rootCompositionVersion?->composition?->kind; + + return $kind instanceof CompositionKind ? $kind->label() : null; + } +} diff --git a/app/Http/LibraryCatalog.php b/app/Http/LibraryCatalog.php new file mode 100644 index 0000000..c7e7163 --- /dev/null +++ b/app/Http/LibraryCatalog.php @@ -0,0 +1,277 @@ +>, modules: list>, materials: list>} + */ + public function index(User $user): array + { + $programs = []; + $modules = []; + $materials = []; + + foreach ($this->grants($user) as $grant) { + $article = $grant->article; + $release = $article->currentRelease; + $composition = $release?->rootCompositionVersion?->composition; + $version = $release?->rootCompositionVersion; + + if ($composition !== null && $version !== null && $this->display->isReleased($version)) { + $picture = app(EditorialCatalog::class)->visiblePicture($composition, $version); + $card = [ + 'composition' => $composition, + 'version' => $version, + 'title' => filled($composition->display_title) ? $composition->display_title : $composition->designation, + 'summary' => $composition->summary, + 'kind' => $composition->editorialContentKind?->label + ?? ($composition->kind?->label()), + 'coverage' => $this->coverageLabel($user, $composition), + 'image' => $picture['alt'] ?? null, + 'image_url' => $picture === null ? null : route('member.thumbnail', [ + 'kind' => $picture['kind'], + 'subject' => $picture['subject'], + ]), + ]; + $shelf = $composition->editorialContentKind?->slug === 'modul' ? 'modules' : 'programs'; + if ($shelf === 'modules') { + $modules[$composition->id] = $card; + } else { + $programs[$composition->id] = $card; + } + + continue; + } + + $element = $release?->rootElementVersion?->element; + $elementId = $element?->id; + $key = $composition !== null + ? 'komposition-'.$composition->id + : ($elementId !== null ? 'element-'.$elementId : 'artikel-'.$article->id); + $imageUrl = $element === null ? null : ThumbnailRef::url('member.thumbnail', 'element', $element->id, $element->thumbnail_path); + $materials[$key] = [ + 'article' => $article, + 'title' => app(CourseOutline::class)->title($article), + 'summary' => $element?->summary ?? $composition?->summary, + 'kind' => app(CourseOutline::class)->kindLabel($article), + 'coverage' => 'nutzbar', + 'image' => $imageUrl === null ? null : ($element->thumbnail_alt ?: $element->working_title), + 'image_url' => $imageUrl, + ]; + } + + return [ + 'programs' => array_values($programs), + 'modules' => array_values($modules), + 'materials' => array_values($materials), + ]; + } + + /** + * @return array{composition: Composition, title: string, kind: ?string, nodes: list>} + */ + public function program(User $user, Composition $composition): array + { + $version = $this->display->highestReleasedVersion($composition); + abort_if($version === null, 404); + + $nodes = array_map( + fn (StructureNode $node): array => $this->present($user, $node), + $this->structure->tree($version), + ); + $leaves = $this->leaves($nodes); + $open = count(array_filter($leaves, fn (array $leaf): bool => $leaf['view_url'] !== null)); + + return [ + 'composition' => $composition, + 'picture' => app(EditorialCatalog::class)->visiblePicture($composition, $version), + 'title' => filled($composition->display_title) ? $composition->display_title : $composition->designation, + 'summary' => $composition->summary, + 'kind' => $composition->editorialContentKind?->label + ?? ($composition->kind?->label()), + 'learning_goal' => $version->learning_goal, + 'duration_minutes' => $version->duration_minutes, + 'material_note' => $version->material_note, + 'coverage' => $leaves === [] ? 'nicht enthalten' : ($open === count($leaves) ? 'nutzbar' : ($open === 0 ? 'nicht enthalten' : 'teilweise')), + 'nodes' => $nodes, + ]; + } + + /** + * @return array + */ + private function present(User $user, StructureNode $node): array + { + $view = null; + $download = null; + + $playback = 'file'; + + $poster = null; + + if ($node->contentElementVersionId !== null) { + $view = $this->open($user, $node->contentElementVersionId, $this->viewAction($node->outputClass)); + $download = $this->open($user, $node->contentElementVersionId, 'laden'); + $playback = app(FilmPlayback::class)->mode($node->contentElementVersionId); + if ($view !== null && $node->contentElementId !== null) { + $path = ContentElement::query()->whereKey($node->contentElementId)->value('thumbnail_path'); + $poster = ThumbnailRef::url('member.thumbnail', 'element', $node->contentElementId, $path); + } + } + + return [ + 'role' => $node->role, + 'title' => $node->title, + 'kind' => $node->editorialKindLabel ?? $node->technicalKindLabel, + 'output_class' => $node->outputClass, + 'playback' => $playback, + 'view_url' => $view, + 'poster_url' => $poster, + 'download_url' => $download, + 'program_url' => $this->programUrl($node), + 'children' => array_map( + fn (StructureNode $child): array => $this->present($user, $child), + $node->children, + ), + ]; + } + + /** + * @param list> $nodes + * @return list> + */ + private function leaves(array $nodes): array + { + $leaves = []; + + foreach ($nodes as $node) { + if ($node['children'] === []) { + $leaves[] = $node; + + continue; + } + + $leaves = [...$leaves, ...$this->leaves($node['children'])]; + } + + return $leaves; + } + + private function coverageLabel(User $user, Composition $composition): string + { + $version = $this->display->highestReleasedVersion($composition); + + if ($version === null) { + return 'nicht enthalten'; + } + + $nodes = array_map( + fn (StructureNode $node): array => $this->present($user, $node), + $this->structure->tree($version), + ); + $leaves = $this->leaves($nodes); + $open = count(array_filter($leaves, fn (array $leaf): bool => $leaf['view_url'] !== null)); + + if ($leaves === [] || $open === 0) { + return 'nicht enthalten'; + } + + return $open === count($leaves) ? 'nutzbar' : 'teilweise'; + } + + private function programUrl(StructureNode $node): ?string + { + if ($node->compositionId === null || $node->compositionVersionId === null) { + return null; + } + + $version = CompositionVersion::query()->find($node->compositionVersionId); + + if ($version === null || ! $this->display->isReleased($version)) { + return null; + } + + return route('member.program', $node->compositionId); + } + + private function viewAction(?string $outputClass): string + { + return in_array($outputClass, ['film', 'audio'], true) ? 'streamen' : 'ansehen'; + } + + private function open(User $user, int $versionId, string $action): ?string + { + $version = ContentElementVersion::query()->with('element')->find($versionId); + + if ($version === null) { + return null; + } + + $releases = ArticleRelease::query() + ->whereIn('status', [ReleaseStatus::Veroeffentlicht, ReleaseStatus::AbgeloestVerfuegbar]) + ->whereHas('contents', fn ($query) => $query->where('content_element_version_id', $versionId)) + ->with('article') + ->orderByDesc('id') + ->get(); + + foreach ($releases as $release) { + $decision = ($this->access)($user, $release->article, $release, $version, $action); + + if (! $decision->allowed) { + continue; + } + + return SignedLink::temporary('member.media', now()->addMinutes(10), [ + 'article' => $release->article->id, + 'release' => $release->id, + 'version' => $version->id, + 'action' => $action, + 'reader' => $user->id, + ]); + } + + return null; + } + + /** + * @return Collection + */ + private function grants(User $user): Collection + { + return Grant::query() + ->where('status', GrantStatus::Aktiv) + ->whereHas('acquisition', fn ($query) => $query->where('party_id', $user->party_id)) + ->with([ + 'article.currentRelease.rootCompositionVersion.composition.editorialContentKind', + 'article.currentRelease.rootElementVersion.element.editorialContentKind', + ]) + ->orderBy('id') + ->get(); + } +} diff --git a/app/Http/Middleware/IgnoreEmptyForwardedHeaders.php b/app/Http/Middleware/IgnoreEmptyForwardedHeaders.php new file mode 100644 index 0000000..51f8294 --- /dev/null +++ b/app/Http/Middleware/IgnoreEmptyForwardedHeaders.php @@ -0,0 +1,31 @@ +headers->has($header)) { + continue; + } + + if (trim((string) $request->headers->get($header)) === '') { + $request->headers->remove($header); + } + } + + return $next($request); + } +} diff --git a/app/Http/Middleware/SanitizeIntendedUrl.php b/app/Http/Middleware/SanitizeIntendedUrl.php new file mode 100644 index 0000000..90e50d7 --- /dev/null +++ b/app/Http/Middleware/SanitizeIntendedUrl.php @@ -0,0 +1,43 @@ +session()->get('url.intended'); + + if (is_string($intended) && ! $this->matchesOpenedHost($intended, $request)) { + $request->session()->forget('url.intended'); + } + + return $next($request); + } + + private function matchesOpenedHost(string $url, Request $request): bool + { + if ($url === '' || filter_var($url, FILTER_VALIDATE_URL) === false) { + return str_starts_with($url, '/'); + } + + $host = parse_url($url, PHP_URL_HOST); + + if (! is_string($host) || strcasecmp($host, $request->getHost()) !== 0) { + return false; + } + + $port = parse_url($url, PHP_URL_PORT); + $requestPort = (int) $request->getPort(); + + if ($port !== null) { + return (int) $port === $requestPort; + } + + return in_array($requestPort, [80, 443], true); + } +} diff --git a/app/Http/Middleware/UseRequestRootUrl.php b/app/Http/Middleware/UseRequestRootUrl.php new file mode 100644 index 0000000..62f8494 --- /dev/null +++ b/app/Http/Middleware/UseRequestRootUrl.php @@ -0,0 +1,22 @@ +getHost() !== '') { + URL::forceRootUrl($request->getSchemeAndHttpHost()); + } + + return $next($request); + } +} diff --git a/app/Http/Middleware/UseStaffSessionCookie.php b/app/Http/Middleware/UseStaffSessionCookie.php new file mode 100644 index 0000000..7e8eede --- /dev/null +++ b/app/Http/Middleware/UseStaffSessionCookie.php @@ -0,0 +1,23 @@ +headers->get('referer', ''); + $staffRequest = $request->is('verwaltung', 'verwaltung/*', 'redaktion', 'redaktion/*') + || str_contains($referer, '/verwaltung'); + + if ($staffRequest) { + config(['session.cookie' => 'luf_staff_session']); + } + + return $next($request); + } +} diff --git a/app/Http/Responses/StaffLoginResponse.php b/app/Http/Responses/StaffLoginResponse.php new file mode 100644 index 0000000..4b7d1b2 --- /dev/null +++ b/app/Http/Responses/StaffLoginResponse.php @@ -0,0 +1,24 @@ +user(); + + if ($user instanceof User && filled($user->getAppAuthenticationSecret())) { + app(TrustedStaffDevice::class)->remember($user); + } + + return redirect()->intended(Filament::getUrl()); + } +} diff --git a/app/Http/SignedLink.php b/app/Http/SignedLink.php new file mode 100644 index 0000000..f987bb3 --- /dev/null +++ b/app/Http/SignedLink.php @@ -0,0 +1,20 @@ + $parameters + */ + public static function temporary(string $name, DateTimeInterface $expiration, array $parameters): string + { + return url(URL::temporarySignedRoute($name, $expiration, $parameters, false)); + } +} diff --git a/app/Jobs/AcceptWebsiteImage.php b/app/Jobs/AcceptWebsiteImage.php new file mode 100644 index 0000000..fcecc0e --- /dev/null +++ b/app/Jobs/AcceptWebsiteImage.php @@ -0,0 +1,49 @@ +find($this->elementId); + + if (! $element instanceof ContentElement) { + return; + } + + $deriver->forWebsiteImage($element, $this->incoming); + $element->refresh(); + + if ($release->derivedPath($element) === null) { + return; + } + + if ($this->incomingIsDisposable()) { + Storage::disk('cms_incoming')->delete($this->incoming); + } + + PublishWebsiteMedia::dispatch($element->id, 'release', $this->actorId); + } + + private function incomingIsDisposable(): bool + { + return (str_starts_with($this->incoming, 'cms/') || str_starts_with($this->incoming, 'vorschau/')) + && ! str_contains($this->incoming, '..'); + } +} diff --git a/app/Jobs/DeriveCompositionFrame.php b/app/Jobs/DeriveCompositionFrame.php new file mode 100644 index 0000000..f8d3d98 --- /dev/null +++ b/app/Jobs/DeriveCompositionFrame.php @@ -0,0 +1,32 @@ +find($this->compositionId); + $version = ContentElementVersion::query()->find($this->versionId); + + if (! $composition instanceof Composition || ! $version instanceof ContentElementVersion) { + return; + } + + $deriver->forCompositionFrame($composition, $version, $this->atSecond); + } +} diff --git a/app/Jobs/DeriveFilmRenditions.php b/app/Jobs/DeriveFilmRenditions.php new file mode 100644 index 0000000..e79d226 --- /dev/null +++ b/app/Jobs/DeriveFilmRenditions.php @@ -0,0 +1,52 @@ +with('element')->find($this->versionId); + $file = is_array($version?->metadata) ? ($version->metadata['file'] ?? null) : null; + + if ($version === null || $version->element->output_class !== 'film' || ! is_string($file) || $file === '') { + return; + } + + if (! $transcoder->available()) { + return; + } + + try { + $rows = $transcoder->derive($version->id, $file); + } catch (Throwable) { + return; + } + + foreach ($rows as $row) { + MediaRendition::query()->updateOrCreate( + [ + 'content_element_version_id' => $version->id, + 'label' => $row['label'], + ], + [ + 'role' => $row['role'], + 'path' => $row['path'], + ], + ); + } + } +} diff --git a/app/Jobs/DeriveThumbnail.php b/app/Jobs/DeriveThumbnail.php new file mode 100644 index 0000000..60a3c09 --- /dev/null +++ b/app/Jobs/DeriveThumbnail.php @@ -0,0 +1,75 @@ +subject === 'komposition') { + $composition = Composition::query()->find($this->subjectId); + + if ($composition === null) { + return; + } + + if ($this->fromElement !== null) { + $element = ContentElement::query()->find($this->fromElement); + + if ($element !== null) { + $deriver->forCompositionFromElement($composition, $element); + } + + return; + } + + if (is_string($this->incoming)) { + $deriver->forCompositionUpload($composition, $this->incoming); + } + + return; + } + + $element = ContentElement::query()->find($this->subjectId); + + if ($element === null) { + return; + } + + if ($this->versionId !== null && $this->atSecond !== null) { + $version = ContentElementVersion::query()->find($this->versionId); + + if ($version instanceof ContentElementVersion) { + $deriver->forElementFrame($element, $version, $this->atSecond); + } + + return; + } + + if (is_string($this->incoming)) { + $deriver->forElementUpload($element, $this->incoming); + + return; + } + + $deriver->forElement($element); + } +} diff --git a/app/Jobs/ImportCmsImages.php b/app/Jobs/ImportCmsImages.php new file mode 100644 index 0000000..724b7ad --- /dev/null +++ b/app/Jobs/ImportCmsImages.php @@ -0,0 +1,83 @@ +allFiles('cms'); + } catch (Throwable) { + return; + } + + sort($files); + + foreach ($files as $path) { + if (! $this->isImage($path) || WebsiteMediaAlias::query()->where('legacy_path', $path)->exists()) { + continue; + } + + $bytes = $public->get($path); + + if (! is_string($bytes) || $bytes === '') { + continue; + } + + $hash = hash('sha256', $bytes); + $twin = WebsiteMediaAlias::query()->where('sha256', $hash)->first(); + + if ($twin instanceof WebsiteMediaAlias) { + WebsiteMediaAlias::query()->create(['legacy_path' => $path, 'content_element_id' => $twin->content_element_id, 'sha256' => $hash]); + + continue; + } + + Storage::disk('cms_incoming')->put($path, $bytes); + $element = $intake->acceptImage($path, self::titleFor($path)); + WebsiteMediaAlias::query()->create(['legacy_path' => $path, 'content_element_id' => $element->id, 'sha256' => $hash]); + } + } + + /** „cms/platzhalter-karte-1-liyjqa.jpg“ → „Platzhalter Karte 1“ (ohne die angehängte Zufallskennung). */ + public static function titleFor(string $path): string + { + $name = pathinfo($path, PATHINFO_FILENAME); + $name = preg_replace('/-[a-z0-9]{6}$/', '', $name) ?? $name; + $title = trim(str_replace(['-', '_'], ' ', $name)); + + return $title === '' ? 'Website-Bild' : Str::title($title); + } + + private function isImage(string $path): bool + { + return str_starts_with($path, 'cms/') + && ! str_contains($path, '..') + && preg_match('#^cms/[A-Za-z0-9._\-/]+$#', $path) === 1 + && in_array(strtolower(pathinfo($path, PATHINFO_EXTENSION)), self::EXTENSIONS, true); + } +} diff --git a/app/Jobs/PublishPublicMedia.php b/app/Jobs/PublishPublicMedia.php new file mode 100644 index 0000000..c5b2f2a --- /dev/null +++ b/app/Jobs/PublishPublicMedia.php @@ -0,0 +1,30 @@ +path, '..') || ! str_starts_with($this->path, 'cms/')) { + return; + } + + $incoming = Storage::disk('cms_incoming'); + + if (! $incoming->exists($this->path)) { + return; + } + + Storage::disk('media_public')->put($this->path, $incoming->get($this->path)); + $incoming->delete($this->path); + } +} diff --git a/app/Jobs/PublishWebsiteMedia.php b/app/Jobs/PublishWebsiteMedia.php new file mode 100644 index 0000000..7b28b38 --- /dev/null +++ b/app/Jobs/PublishWebsiteMedia.php @@ -0,0 +1,90 @@ +find($this->elementId); + + if (! $element instanceof ContentElement || ! in_array($this->action, ['release', 'withdraw'], true)) { + return; + } + + if ($this->action === 'withdraw') { + $this->deletePublicFile($element); + $this->mark($element, $element->website_released_at?->toIso8601String(), null); + $element->forceFill([ + 'website_released_at' => null, + 'website_public_path' => null, + ])->save(); + + return; + } + + $derived = $release->derivedPath($element); + + if ($derived === null) { + return; + } + + $target = $release->publicPath($element, $derived); + $previous = $element->website_public_path; + + Storage::disk('media_public')->put($target, Storage::disk('media_derived')->get($derived)); + + if (is_string($previous) && $previous !== $target && str_starts_with($previous, 'website/'.$element->id.'/')) { + Storage::disk('media_public')->delete($previous); + } + + $this->mark($element, $element->website_released_at?->toIso8601String(), now()->toIso8601String()); + $element->forceFill([ + 'website_released_at' => now(), + 'website_public_path' => $target, + ])->save(); + } + + private function deletePublicFile(ContentElement $element): void + { + $path = $element->website_public_path; + + if (! is_string($path) || ! str_starts_with($path, 'website/'.$element->id.'/') || str_contains($path, '..')) { + return; + } + + Storage::disk('media_public')->delete($path); + } + + private function mark(ContentElement $element, ?string $before, ?string $after): void + { + if ($before === $after) { + return; + } + + IdentityChange::query()->create([ + 'subject_type' => $element->getMorphClass(), + 'subject_id' => $element->id, + 'field' => 'website_released_at', + 'before' => $before, + 'after' => $after, + 'actor_id' => $this->actorId, + 'occurred_at' => now(), + ]); + } +} diff --git a/app/Jobs/StoreContentFile.php b/app/Jobs/StoreContentFile.php new file mode 100644 index 0000000..dc0ab93 --- /dev/null +++ b/app/Jobs/StoreContentFile.php @@ -0,0 +1,110 @@ +source, 'inhalte/') || str_contains($this->source, '..')) { + return; + } + + $version = ContentElementVersion::query()->find($this->versionId); + + if ($version === null || $version->status !== ContentVersionStatus::Entwurf) { + return; + } + + $targetName = $this->storedName(basename($this->source)); + + if ($targetName === null) { + $this->markFailed($version, 'Der Dateityp wird nicht übernommen.'); + + return; + } + + $target = 'inhalte/'.$version->id.'/'.$targetName; + $incoming = Storage::disk('cms_incoming'); + + if (! $incoming->exists($this->source)) { + $this->markFailed($version, 'Die hochgeladene Datei wurde nicht gefunden.'); + + return; + } + + $stream = $incoming->readStream($this->source); + + if (! is_resource($stream)) { + $this->markFailed($version, 'Die hochgeladene Datei ließ sich nicht lesen.'); + + return; + } + + try { + Storage::disk('media_derived')->writeStream($target, $stream); + } finally { + fclose($stream); + } + + $metadata = $version->metadata ?? []; + $hold = ($metadata['hold'] ?? false) === true; + unset($metadata['incoming'], $metadata['hold']); + $metadata['file'] = $target; + + if ($hold) { + $metadata['held'] = true; + } + + $version->metadata = $metadata; + $version->content_hash = hash('sha256', json_encode([ + 'body' => $version->body, + 'metadata' => $metadata, + ], JSON_THROW_ON_ERROR | JSON_UNESCAPED_UNICODE)); + + if (! $hold) { + $version->status = ContentVersionStatus::Bereit; + } + + $version->save(); + DeriveThumbnail::dispatch('element', $version->content_element_id); + DeriveFilmRenditions::dispatch($version->id); + } + + private function storedName(string $name): ?string + { + $extension = strtolower(pathinfo($name, PATHINFO_EXTENSION)); + $stem = preg_replace('/[^A-Za-z0-9_-]+/', '-', pathinfo($name, PATHINFO_FILENAME)) ?? ''; + $stem = trim($stem, '-'); + + if (preg_match('/^[a-z0-9]{1,8}$/', $extension) !== 1) { + return null; + } + + return ($stem !== '' ? $stem : 'datei').'.'.$extension; + } + + private function markFailed(ContentElementVersion $version, string $reason): void + { + $metadata = $version->metadata ?? []; + unset($metadata['incoming']); + $metadata['error'] = $reason; + $version->metadata = $metadata; + $version->save(); + } +} diff --git a/app/Mail/OrderConfirmed.php b/app/Mail/OrderConfirmed.php new file mode 100644 index 0000000..500caf0 --- /dev/null +++ b/app/Mail/OrderConfirmed.php @@ -0,0 +1,27 @@ + */ + use HasFactory, Notifiable; + + use InteractsWithAppAuthentication; + use InteractsWithAppAuthenticationRecovery; + + protected function casts(): array + { + return [ + 'email_verified_at' => 'datetime', + 'password' => 'hashed', + 'confirmed_adult_at' => 'datetime', + 'status' => AccountStatus::class, + ]; + } + + public function sendEmailVerificationNotification(): void + { + $this->notify(new VerifyEmailAddress); + } + + public function party(): BelongsTo + { + return $this->belongsTo(Party::class); + } + + public function staffRoles(): HasMany + { + return $this->hasMany(StaffRoleAssignment::class); + } + + public function hasStaffRole(StaffRole $role): bool + { + if ($this->relationLoaded('staffRoles')) { + return $this->staffRoles->contains(fn (StaffRoleAssignment $assignment): bool => $assignment->role === $role); + } + + return $this->staffRoles()->where('role', $role->value)->exists(); + } + + public function canAccessPanel(Panel $panel): bool + { + return $this->status === AccountStatus::Aktiv + && $this->hasVerifiedEmail() + && $this->staffRoles()->exists(); + } +} diff --git a/app/Notifications/VerifyEmailAddress.php b/app/Notifications/VerifyEmailAddress.php new file mode 100644 index 0000000..cf6d960 --- /dev/null +++ b/app/Notifications/VerifyEmailAddress.php @@ -0,0 +1,23 @@ +addMinutes((int) Config::get('auth.verification.expire', 60)), + [ + 'id' => $notifiable->getKey(), + 'hash' => sha1($notifiable->getEmailForVerification()), + ], + ); + } +} diff --git a/app/Policies/UserPolicy.php b/app/Policies/UserPolicy.php new file mode 100644 index 0000000..3d0e185 --- /dev/null +++ b/app/Policies/UserPolicy.php @@ -0,0 +1,34 @@ +hasStaffRole(StaffRole::Systemverwalter); + } + + public function view(User $user, User $model): bool + { + return $this->viewAny($user); + } + + public function create(User $user): bool + { + return $this->viewAny($user); + } + + public function update(User $user, User $model): bool + { + return $this->viewAny($user); + } + + public function delete(User $user, User $model): bool + { + return false; + } +} diff --git a/app/Providers/AppServiceProvider.php b/app/Providers/AppServiceProvider.php new file mode 100644 index 0000000..8403dd0 --- /dev/null +++ b/app/Providers/AppServiceProvider.php @@ -0,0 +1,54 @@ +app->bind(FilmTranscoder::class, FfmpegFilmTranscoder::class); + // Je Anfrage einmal den Index der öffentlich genannten Medien bilden, nicht je Karte. + $this->app->scoped(PublicMaterialReader::class); + $this->app->scoped(WebsiteImage::class); + $this->app->singleton(WidgetRegistry::class, fn ($app): WidgetRegistry => new WidgetRegistry( + array_map(fn (string $class) => $app->make($class), config('cms.widgets', [])), + )); + } + + public function boot(): void + { + config([ + 'livewire.temporary_file_upload.rules' => MediaUploadLimit::rules(), + 'livewire.temporary_file_upload.max_upload_time' => 60, + ]); + + $this->app->bind(LoginResponseContract::class, StaffLoginResponse::class); + Gate::policy(Page::class, PagePolicy::class); + Gate::policy(NavigationItem::class, NavigationItemPolicy::class); + Gate::policy(User::class, UserPolicy::class); + + View::composer('layouts.site', function ($view): void { + if (! array_key_exists('navigation', $view->getData())) { + $view->with('navigation', NavigationItem::query()->visible()->with('page')->orderBy('sort_order')->orderBy('id')->get()); + } + }); + } +} diff --git a/app/Providers/Filament/AdminPanelProvider.php b/app/Providers/Filament/AdminPanelProvider.php new file mode 100644 index 0000000..89f9729 --- /dev/null +++ b/app/Providers/Filament/AdminPanelProvider.php @@ -0,0 +1,79 @@ +default() + ->id('verwaltung') + ->path('verwaltung') + ->login(StaffLogin::class) + ->brandName('Verwaltung') + ->authGuard('staff') + ->colors([ + 'primary' => Color::hex('#3b7b09'), + ]) + ->multiFactorAuthentication([ + AppAuthentication::make() + ->recoverable() + ->brandName(StaffAuthenticatorName::current()), + ], isRequired: true) + ->discoverResources(in: app_path('Filament/Resources'), for: 'App\Filament\Resources') + ->discoverPages(in: app_path('Filament/Pages'), for: 'App\Filament\Pages') + ->pages([ + Dashboard::class, + ]) + ->discoverWidgets(in: app_path('Filament/Widgets'), for: 'App\Filament\Widgets') + ->widgets([ + AccountWidget::class, + ]) + ->middleware([ + EncryptCookies::class, + AddQueuedCookiesToResponse::class, + StartSession::class, + SanitizeIntendedUrl::class, + AuthenticateSession::class, + ShareErrorsFromSession::class, + PreventRequestForgery::class, + SubstituteBindings::class, + DisableBladeIconComponents::class, + DispatchServingFilamentEvent::class, + ]) + ->authMiddleware([ + Authenticate::class, + ]) + ->renderHook( + PanelsRenderHook::STYLES_AFTER, + fn (): string => view('filament.cms.styles')->render().view('filament.verwaltung.styles')->render(), + ) + ->renderHook( + PanelsRenderHook::BODY_END, + fn (): string => app()->environment('testing') ? '' : Blade::render("@vite('resources/js/app.js')"), + ); + } +} diff --git a/artisan b/artisan new file mode 100644 index 0000000..c35e31d --- /dev/null +++ b/artisan @@ -0,0 +1,18 @@ +#!/usr/bin/env php +handleCommand(new ArgvInput); + +exit($status); diff --git a/bootstrap/app.php b/bootstrap/app.php new file mode 100644 index 0000000..82e1084 --- /dev/null +++ b/bootstrap/app.php @@ -0,0 +1,43 @@ +withRouting( + web: __DIR__.'/../routes/web.php', + commands: __DIR__.'/../routes/console.php', + health: '/up', + ) + ->withMiddleware(function (Middleware $middleware): void { + $middleware->trustProxies(at: '*'); + $middleware->prepend(UseStaffSessionCookie::class); + $middleware->prepend(UseRequestRootUrl::class); + $middleware->prepend(IgnoreEmptyForwardedHeaders::class); + $middleware->web(append: SanitizeIntendedUrl::class); + $middleware->redirectGuestsTo(function (Request $request) { + if ($request->is('verwaltung', 'verwaltung/*')) { + return '/verwaltung/login'; + } + + return '/anmelden'; + }); + $middleware->redirectUsersTo(function (Request $request) { + if ($request->is('verwaltung', 'verwaltung/*')) { + return '/verwaltung'; + } + + return '/bereich'; + }); + }) + ->withExceptions(function (Exceptions $exceptions): void { + $exceptions->shouldRenderJsonWhen( + fn (Request $request) => $request->is('api/*') || $request->expectsJson(), + ); + })->create(); diff --git a/bootstrap/cache/.gitignore b/bootstrap/cache/.gitignore new file mode 100644 index 0000000..d6b7ef3 --- /dev/null +++ b/bootstrap/cache/.gitignore @@ -0,0 +1,2 @@ +* +!.gitignore diff --git a/bootstrap/providers.php b/bootstrap/providers.php new file mode 100644 index 0000000..ec5248a --- /dev/null +++ b/bootstrap/providers.php @@ -0,0 +1,9 @@ +=5.0.0" + }, + "require-dev": { + "doctrine/dbal": "^4.0.0", + "nesbot/carbon": "^2.71.0 || ^3.0.0", + "phpunit/phpunit": "^10.3" + }, + "type": "library", + "extra": { + "branch-alias": { + "dev-main": "3.x-dev" + } + }, + "autoload": { + "psr-4": { + "Carbon\\Doctrine\\": "src/Carbon/Doctrine/" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "KyleKatarn", + "email": "kylekatarnls@gmail.com" + } + ], + "description": "Types to use Carbon in Doctrine", + "keywords": [ + "carbon", + "date", + "datetime", + "doctrine", + "time" + ], + "support": { + "issues": "https://github.com/CarbonPHP/carbon-doctrine-types/issues", + "source": "https://github.com/CarbonPHP/carbon-doctrine-types/tree/3.2.1" + }, + "funding": [ + { + "url": "https://github.com/kylekatarnls", + "type": "github" + }, + { + "url": "https://opencollective.com/Carbon", + "type": "open_collective" + }, + { + "url": "https://tidelift.com/funding/github/packagist/nesbot/carbon", + "type": "tidelift" + } + ], + "time": "2026-09-06T14:11:38+00:00", + "published-time": "2026-09-06T14:15:00+00:00" + }, + { + "name": "chillerlan/php-qrcode", + "version": "5.0.5", + "source": { + "type": "git", + "url": "https://github.com/chillerlan/php-qrcode.git", + "reference": "7b66282572fc14075c0507d74d9837dab25b38d6" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/chillerlan/php-qrcode/zipball/7b66282572fc14075c0507d74d9837dab25b38d6", + "reference": "7b66282572fc14075c0507d74d9837dab25b38d6", + "shasum": "" + }, + "require": { + "chillerlan/php-settings-container": "^2.1.6 || ^3.2.1", + "ext-mbstring": "*", + "php": "^7.4 || ^8.0" + }, + "require-dev": { + "chillerlan/php-authenticator": "^4.3.1 || ^5.2.1", + "ext-fileinfo": "*", + "phan/phan": "^5.5.2", + "phpcompatibility/php-compatibility": "10.x-dev", + "phpmd/phpmd": "^2.15", + "phpunit/phpunit": "^9.6", + "setasign/fpdf": "^1.8.2", + "slevomat/coding-standard": "^8.23.0", + "squizlabs/php_codesniffer": "^4.0.0" + }, + "suggest": { + "chillerlan/php-authenticator": "Yet another Google authenticator! Also creates URIs for mobile apps.", + "setasign/fpdf": "Required to use the QR FPDF output.", + "simple-icons/simple-icons": "SVG icons that you can use to embed as logos in the QR Code" + }, + "type": "library", + "autoload": { + "psr-4": { + "chillerlan\\QRCode\\": "src" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT", + "Apache-2.0" + ], + "authors": [ + { + "name": "Kazuhiko Arase", + "homepage": "https://github.com/kazuhikoarase/qrcode-generator" + }, + { + "name": "ZXing Authors", + "homepage": "https://github.com/zxing/zxing" + }, + { + "name": "Ashot Khanamiryan", + "homepage": "https://github.com/khanamiryan/php-qrcode-detector-decoder" + }, + { + "name": "Smiley", + "email": "smiley@chillerlan.net", + "homepage": "https://github.com/codemasher" + }, + { + "name": "Contributors", + "homepage": "https://github.com/chillerlan/php-qrcode/graphs/contributors" + } + ], + "description": "A QR Code generator and reader with a user-friendly API. PHP 7.4+", + "homepage": "https://github.com/chillerlan/php-qrcode", + "keywords": [ + "phpqrcode", + "qr", + "qr code", + "qr-reader", + "qrcode", + "qrcode-generator", + "qrcode-reader" + ], + "support": { + "docs": "https://php-qrcode.readthedocs.io", + "issues": "https://github.com/chillerlan/php-qrcode/issues", + "source": "https://github.com/chillerlan/php-qrcode" + }, + "funding": [ + { + "url": "https://ko-fi.com/codemasher", + "type": "Ko-Fi" + } + ], + "time": "2025-11-23T23:51:44+00:00", + "published-time": "2025-11-24T13:05:56+00:00" + }, + { + "name": "chillerlan/php-settings-container", + "version": "3.3.0", + "source": { + "type": "git", + "url": "https://github.com/chillerlan/php-settings-container.git", + "reference": "a0a487cbf5344f721eb504bf0f59bada40c381b7" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/chillerlan/php-settings-container/zipball/a0a487cbf5344f721eb504bf0f59bada40c381b7", + "reference": "a0a487cbf5344f721eb504bf0f59bada40c381b7", + "shasum": "" + }, + "require": { + "ext-json": "*", + "php": "^8.1" + }, + "require-dev": { + "phan/phan": "^5.5.2", + "phpmd/phpmd": "^2.15", + "phpstan/phpstan": "^2.1.31", + "phpstan/phpstan-deprecation-rules": "^2.0.3", + "phpunit/phpunit": "^10.5", + "slevomat/coding-standard": "^8.22", + "squizlabs/php_codesniffer": "^4.0" + }, + "type": "library", + "autoload": { + "psr-4": { + "chillerlan\\Settings\\": "src" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "Smiley", + "email": "smiley@chillerlan.net", + "homepage": "https://github.com/codemasher" + } + ], + "description": "A container class for immutable settings objects. Not a DI container.", + "homepage": "https://github.com/chillerlan/php-settings-container", + "keywords": [ + "Settings", + "configuration", + "container", + "helper", + "property hook" + ], + "support": { + "issues": "https://github.com/chillerlan/php-settings-container/issues", + "source": "https://github.com/chillerlan/php-settings-container" + }, + "funding": [ + { + "url": "https://www.paypal.com/donate?hosted_button_id=WLYUNAT9ZTJZ4", + "type": "custom" + }, + { + "url": "https://ko-fi.com/codemasher", + "type": "ko_fi" + } + ], + "time": "2026-03-20T21:10:52+00:00", + "published-time": "2026-03-20T21:26:09+00:00" + }, + { + "name": "composer/class-map-generator", + "version": "1.9.0", + "source": { + "type": "git", + "url": "https://github.com/composer/class-map-generator.git", + "reference": "5fa48e0e1992ea8a786df3ceca80625c9a643b75" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/composer/class-map-generator/zipball/5fa48e0e1992ea8a786df3ceca80625c9a643b75", + "reference": "5fa48e0e1992ea8a786df3ceca80625c9a643b75", + "shasum": "" + }, + "require": { + "composer/pcre": "^2.1 || ^3.1", + "php": "^7.2 || ^8.0", + "symfony/finder": "^4.4 || ^5.3 || ^6 || ^7 || ^8" + }, + "require-dev": { + "phpstan/phpstan": "^1.12 || ^2", + "phpstan/phpstan-deprecation-rules": "^1 || ^2", + "phpstan/phpstan-phpunit": "^1 || ^2", + "phpstan/phpstan-strict-rules": "^1.1 || ^2", + "phpunit/phpunit": "^8", + "symfony/filesystem": "^5.4 || ^6 || ^7 || ^8" + }, + "type": "library", + "extra": { + "branch-alias": { + "dev-main": "1.x-dev" + } + }, + "autoload": { + "psr-4": { + "Composer\\ClassMapGenerator\\": "src" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "Jordi Boggiano", + "email": "j.boggiano@seld.be", + "homepage": "https://seld.be" + } + ], + "description": "Utilities to scan PHP code and generate class maps.", + "keywords": [ + "classmap" + ], + "support": { + "issues": "https://github.com/composer/class-map-generator/issues", + "source": "https://github.com/composer/class-map-generator/tree/1.9.0" + }, + "funding": [ + { + "url": "https://packagist.com", + "type": "custom" + }, + { + "url": "https://github.com/composer", + "type": "github" + } + ], + "time": "2026-11-03T10:10:19+00:00", + "published-time": "2026-11-03T10:12:49+00:00" + }, + { + "name": "composer/pcre", + "version": "3.4.0", + "source": { + "type": "git", + "url": "https://github.com/composer/pcre.git", + "reference": "d5a341b3fb61f3001970940afb1d332968a183ed" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/composer/pcre/zipball/d5a341b3fb61f3001970940afb1d332968a183ed", + "reference": "d5a341b3fb61f3001970940afb1d332968a183ed", + "shasum": "" + }, + "require": { + "php": "^7.4 || ^8.0" + }, + "conflict": { + "phpstan/phpstan": "<2.2.2" + }, + "require-dev": { + "phpstan/phpstan": "^2", + "phpstan/phpstan-deprecation-rules": "^2", + "phpstan/phpstan-strict-rules": "^2", + "phpunit/phpunit": "^9" + }, + "type": "library", + "extra": { + "phpstan": { + "includes": [ + "extension.neon" + ] + }, + "branch-alias": { + "dev-main": "3.x-dev" + } + }, + "autoload": { + "psr-4": { + "Composer\\Pcre\\": "src" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "Jordi Boggiano", + "email": "j.boggiano@seld.be", + "homepage": "http://seld.be" + } + ], + "description": "PCRE wrapping library that offers type-safe preg_* replacements.", + "keywords": [ + "PCRE", + "preg", + "regex", + "regular expression" + ], + "support": { + "issues": "https://github.com/composer/pcre/issues", + "source": "https://github.com/composer/pcre/tree/3.4.0" + }, + "funding": [ + { + "url": "https://packagist.com", + "type": "custom" + }, + { + "url": "https://github.com/composer", + "type": "github" + } + ], + "time": "2026-06-07T11:47:49+00:00", + "published-time": "2026-06-11T12:12:37+00:00" + }, + { + "name": "danharrin/date-format-converter", + "version": "v0.3.1", + "source": { + "type": "git", + "url": "https://github.com/danharrin/date-format-converter.git", + "reference": "7c31171bc981e48726729a5f3a05a2d2b63f0b1e" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/danharrin/date-format-converter/zipball/7c31171bc981e48726729a5f3a05a2d2b63f0b1e", + "reference": "7c31171bc981e48726729a5f3a05a2d2b63f0b1e", + "shasum": "" + }, + "require": { + "php": "^7.2|^8.0" + }, + "type": "library", + "autoload": { + "files": [ + "src/helpers.php", + "src/standards.php" + ], + "psr-4": { + "DanHarrin\\DateFormatConverter\\": "src/" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "Dan Harrin", + "email": "dan@danharrin.com" + } + ], + "description": "Convert token-based date formats between standards.", + "homepage": "https://github.com/danharrin/date-format-converter", + "support": { + "issues": "https://github.com/danharrin/date-format-converter/issues", + "source": "https://github.com/danharrin/date-format-converter" + }, + "funding": [ + { + "url": "https://github.com/danharrin", + "type": "github" + } + ], + "time": "2024-06-13T09:38:44+00:00", + "published-time": "2024-06-13T09:39:48+00:00" + }, + { + "name": "danharrin/livewire-rate-limiting", + "version": "v2.3.0", + "source": { + "type": "git", + "url": "https://github.com/danharrin/livewire-rate-limiting.git", + "reference": "46c4ceaf7997c713c79afe7c507a39649f6c9d6f" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/danharrin/livewire-rate-limiting/zipball/46c4ceaf7997c713c79afe7c507a39649f6c9d6f", + "reference": "46c4ceaf7997c713c79afe7c507a39649f6c9d6f", + "shasum": "" + }, + "require": { + "illuminate/support": "^9.0|^10.0|^11.0|^12.0|^13.0", + "php": "^8.0" + }, + "require-dev": { + "livewire/livewire": "^3.0|^4.0", + "livewire/volt": "^1.3", + "orchestra/testbench": "^7.0|^8.0|^9.0|^10.0|^11.0", + "phpunit/phpunit": "^9.0|^10.0|^11.5.3|^12.5.12" + }, + "type": "library", + "autoload": { + "psr-4": { + "DanHarrin\\LivewireRateLimiting\\": "src" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "Dan Harrin", + "email": "dan@danharrin.com" + } + ], + "description": "Apply rate limiters to Laravel Livewire actions.", + "homepage": "https://github.com/danharrin/livewire-rate-limiting", + "support": { + "issues": "https://github.com/danharrin/livewire-rate-limiting/issues", + "source": "https://github.com/danharrin/livewire-rate-limiting" + }, + "funding": [ + { + "url": "https://github.com/danharrin", + "type": "github" + } + ], + "time": "2026-09-18T07:38:01+00:00", + "published-time": "2026-09-18T08:03:27+00:00" + }, + { + "name": "dflydev/dot-access-data", + "version": "v3.0.3", + "source": { + "type": "git", + "url": "https://github.com/dflydev/dflydev-dot-access-data.git", + "reference": "a23a2bf4f31d3518f3ecb38660c95715dfead60f" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/dflydev/dflydev-dot-access-data/zipball/a23a2bf4f31d3518f3ecb38660c95715dfead60f", + "reference": "a23a2bf4f31d3518f3ecb38660c95715dfead60f", + "shasum": "" + }, + "require": { + "php": "^7.1 || ^8.0" + }, + "require-dev": { + "phpstan/phpstan": "^0.12.42", + "phpunit/phpunit": "^7.5 || ^8.5 || ^9.3", + "scrutinizer/ocular": "1.6.0", + "squizlabs/php_codesniffer": "^3.5", + "vimeo/psalm": "^4.0.0" + }, + "type": "library", + "extra": { + "branch-alias": { + "dev-main": "3.x-dev" + } + }, + "autoload": { + "psr-4": { + "Dflydev\\DotAccessData\\": "src/" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "Dragonfly Development Inc.", + "email": "info@dflydev.com", + "homepage": "http://dflydev.com" + }, + { + "name": "Beau Simensen", + "email": "beau@dflydev.com", + "homepage": "http://beausimensen.com" + }, + { + "name": "Carlos Frutos", + "email": "carlos@kiwing.it", + "homepage": "https://github.com/cfrutos" + }, + { + "name": "Colin O'Dell", + "email": "colinodell@gmail.com", + "homepage": "https://www.colinodell.com" + } + ], + "description": "Given a deep data structure, access data by dot notation.", + "homepage": "https://github.com/dflydev/dflydev-dot-access-data", + "keywords": [ + "access", + "data", + "dot", + "notation" + ], + "support": { + "issues": "https://github.com/dflydev/dflydev-dot-access-data/issues", + "source": "https://github.com/dflydev/dflydev-dot-access-data/tree/v3.0.3" + }, + "time": "2024-07-08T12:26:09+00:00", + "published-time": "2024-07-08T12:27:13+00:00" + }, + { + "name": "doctrine/inflector", + "version": "2.1.1", + "source": { + "type": "git", + "url": "https://github.com/doctrine/inflector.git", + "reference": "46351b6812b7b6d52b82c3efa5dfb786a198ec88" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/doctrine/inflector/zipball/46351b6812b7b6d52b82c3efa5dfb786a198ec88", + "reference": "46351b6812b7b6d52b82c3efa5dfb786a198ec88", + "shasum": "" + }, + "require": { + "php": "^7.2 || ^8.0" + }, + "require-dev": { + "doctrine/coding-standard": "^12.0 || ^14.0", + "phpstan/phpstan": "^1.12 || ^2.0", + "phpstan/phpstan-phpunit": "^1.4 || ^2.0", + "phpstan/phpstan-strict-rules": "^1.6 || ^2.0", + "phpunit/phpunit": "^8.5 || ^12.2" + }, + "type": "library", + "autoload": { + "psr-4": { + "Doctrine\\Inflector\\": "src" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "Guilherme Blanco", + "email": "guilhermeblanco@gmail.com" + }, + { + "name": "Roman Borschel", + "email": "roman@code-factory.org" + }, + { + "name": "Benjamin Eberlei", + "email": "kontakt@beberlei.de" + }, + { + "name": "Jonathan Wage", + "email": "jonwage@gmail.com" + }, + { + "name": "Johannes Schmitt", + "email": "schmittjoh@gmail.com" + } + ], + "description": "PHP Doctrine Inflector is a small library that can perform string manipulations with regard to upper/lowercase and singular/plural forms of words.", + "homepage": "https://www.doctrine-project.org/projects/inflector.html", + "keywords": [ + "inflection", + "inflector", + "lowercase", + "manipulation", + "php", + "plural", + "singular", + "strings", + "uppercase", + "words" + ], + "support": { + "issues": "https://github.com/doctrine/inflector/issues", + "source": "https://github.com/doctrine/inflector/tree/2.1.1" + }, + "funding": [ + { + "url": "https://www.doctrine-project.org/sponsorship.html", + "type": "custom" + }, + { + "url": "https://www.patreon.com/phpdoctrine", + "type": "patreon" + }, + { + "url": "https://tidelift.com/funding/github/packagist/doctrine%2Finflector", + "type": "tidelift" + } + ], + "time": "2026-10-26T08:14:14+00:00", + "published-time": "2026-10-26T20:06:59+00:00" + }, + { + "name": "doctrine/lexer", + "version": "3.0.3", + "source": { + "type": "git", + "url": "https://github.com/doctrine/lexer.git", + "reference": "71d305eaa6480d3d3460c7d053d1da7749fa9cca" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/doctrine/lexer/zipball/71d305eaa6480d3d3460c7d053d1da7749fa9cca", + "reference": "71d305eaa6480d3d3460c7d053d1da7749fa9cca", + "shasum": "" + }, + "require": { + "php": "^8.1" + }, + "require-dev": { + "doctrine/coding-standard": "^14", + "phpstan/phpstan": "^2", + "phpunit/phpunit": "^10.5.58 || ^12.5.4" + }, + "type": "library", + "autoload": { + "psr-4": { + "Doctrine\\Common\\Lexer\\": "src" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "Guilherme Blanco", + "email": "guilhermeblanco@gmail.com" + }, + { + "name": "Roman Borschel", + "email": "roman@code-factory.org" + }, + { + "name": "Johannes Schmitt", + "email": "schmittjoh@gmail.com" + } + ], + "description": "PHP Doctrine Lexer parser library that can be used in Top-Down, Recursive Descent Parsers.", + "homepage": "https://www.doctrine-project.org/projects/lexer.html", + "keywords": [ + "annotations", + "docblock", + "lexer", + "parser", + "php" + ], + "support": { + "issues": "https://github.com/doctrine/lexer/issues", + "source": "https://github.com/doctrine/lexer/tree/3.0.3" + }, + "funding": [ + { + "url": "https://www.doctrine-project.org/sponsorship.html", + "type": "custom" + }, + { + "url": "https://www.patreon.com/phpdoctrine", + "type": "patreon" + }, + { + "url": "https://tidelift.com/funding/github/packagist/doctrine%2Flexer", + "type": "tidelift" + } + ], + "time": "2026-10-01T06:59:29+00:00", + "published-time": "2026-10-01T07:01:28+00:00" + }, + { + "name": "dragonmantank/cron-expression", + "version": "v3.6.1", + "source": { + "type": "git", + "url": "https://github.com/dragonmantank/cron-expression.git", + "reference": "4189372ffeff09bf14f731f67a9de90c7b413ebe" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/dragonmantank/cron-expression/zipball/4189372ffeff09bf14f731f67a9de90c7b413ebe", + "reference": "4189372ffeff09bf14f731f67a9de90c7b413ebe", + "shasum": "" + }, + "require": { + "php": "^8.2|^8.3|^8.4|^8.5" + }, + "replace": { + "mtdowling/cron-expression": "^1.0" + }, + "require-dev": { + "phpstan/extension-installer": "^1.4.3", + "phpstan/phpstan": "^2.1.31", + "phpunit/phpunit": "^11.5.43 || ^12.4" + }, + "type": "library", + "extra": { + "branch-alias": { + "dev-master": "3.x-dev" + } + }, + "autoload": { + "psr-4": { + "Cron\\": "src/Cron/" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "Chris Tankersley", + "email": "chris@ctankersley.com", + "homepage": "https://github.com/dragonmantank" + } + ], + "description": "CRON for PHP: Calculate the next or previous run date and determine if a CRON expression is due", + "keywords": [ + "cron", + "schedule" + ], + "support": { + "issues": "https://github.com/dragonmantank/cron-expression/issues", + "source": "https://github.com/dragonmantank/cron-expression/tree/v3.6.1" + }, + "funding": [ + { + "url": "https://github.com/dragonmantank", + "type": "github" + } + ], + "time": "2026-10-19T17:53:57+00:00", + "published-time": "2026-10-19T17:54:31+00:00" + }, + { + "name": "egulias/email-validator", + "version": "4.0.4", + "source": { + "type": "git", + "url": "https://github.com/egulias/EmailValidator.git", + "reference": "d42c8731f0624ad6bdc8d3e5e9a4524f68801cfa" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/egulias/EmailValidator/zipball/d42c8731f0624ad6bdc8d3e5e9a4524f68801cfa", + "reference": "d42c8731f0624ad6bdc8d3e5e9a4524f68801cfa", + "shasum": "" + }, + "require": { + "doctrine/lexer": "^2.0 || ^3.0", + "php": ">=8.1", + "symfony/polyfill-intl-idn": "^1.26" + }, + "require-dev": { + "phpunit/phpunit": "^10.2", + "vimeo/psalm": "^5.12" + }, + "suggest": { + "ext-intl": "PHP Internationalization Libraries are required to use the SpoofChecking validation" + }, + "type": "library", + "extra": { + "branch-alias": { + "dev-master": "4.0.x-dev" + } + }, + "autoload": { + "psr-4": { + "Egulias\\EmailValidator\\": "src" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "Eduardo Gulias Davis" + } + ], + "description": "A library for validating emails against several RFCs", + "homepage": "https://github.com/egulias/EmailValidator", + "keywords": [ + "email", + "emailvalidation", + "emailvalidator", + "validation", + "validator" + ], + "support": { + "issues": "https://github.com/egulias/EmailValidator/issues", + "source": "https://github.com/egulias/EmailValidator/tree/4.0.4" + }, + "funding": [ + { + "url": "https://github.com/egulias", + "type": "github" + } + ], + "time": "2025-03-06T22:45:56+00:00", + "published-time": "2025-03-20T21:39:03+00:00" + }, + { + "name": "filament/actions", + "version": "v5.11.3", + "source": { + "type": "git", + "url": "https://github.com/filamentphp/actions.git", + "reference": "c9179d3f618dd8a308c24e6b16ff213ff9a87552" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/filamentphp/actions/zipball/c9179d3f618dd8a308c24e6b16ff213ff9a87552", + "reference": "c9179d3f618dd8a308c24e6b16ff213ff9a87552", + "shasum": "" + }, + "require": { + "anourvalar/eloquent-serialize": "^1.3.6", + "filament/forms": "self.version", + "filament/infolists": "self.version", + "filament/notifications": "self.version", + "filament/support": "self.version", + "league/csv": "^9.27", + "openspout/openspout": "^4.23", + "php": "^8.2" + }, + "type": "library", + "extra": { + "laravel": { + "providers": [ + "Filament\\Actions\\ActionsServiceProvider" + ] + } + }, + "autoload": { + "psr-4": { + "Filament\\Actions\\": "src" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "description": "Encapsulate user interactions and business logic in reusable actions for Livewire.", + "homepage": "https://github.com/filamentphp/filament", + "support": { + "issues": "https://github.com/filamentphp/filament/issues", + "source": "https://github.com/filamentphp/filament" + }, + "time": "2026-11-13T13:11:09+00:00", + "published-time": "2026-11-13T13:11:16+00:00" + }, + { + "name": "filament/filament", + "version": "v5.11.3", + "source": { + "type": "git", + "url": "https://github.com/filamentphp/panels.git", + "reference": "d04964a2ae6d18664280be4ba67db26a0192a808" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/filamentphp/panels/zipball/d04964a2ae6d18664280be4ba67db26a0192a808", + "reference": "d04964a2ae6d18664280be4ba67db26a0192a808", + "shasum": "" + }, + "require": { + "chillerlan/php-qrcode": "^5.0", + "composer-runtime-api": "^2.1", + "filament/actions": "self.version", + "filament/forms": "self.version", + "filament/infolists": "self.version", + "filament/notifications": "self.version", + "filament/schemas": "self.version", + "filament/support": "self.version", + "filament/tables": "self.version", + "filament/widgets": "self.version", + "php": "^8.2", + "pragmarx/google2fa": "^8.0|^9.0", + "pragmarx/google2fa-qrcode": "^3.0|^4.0" + }, + "type": "library", + "extra": { + "laravel": { + "providers": [ + "Filament\\FilamentServiceProvider" + ] + } + }, + "autoload": { + "files": [ + "src/global_helpers.php", + "src/helpers.php" + ], + "psr-4": { + "Filament\\": "src" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "description": "An open-source framework for building polished, maintainable business software with Laravel.", + "homepage": "https://github.com/filamentphp/filament", + "support": { + "issues": "https://github.com/filamentphp/filament/issues", + "source": "https://github.com/filamentphp/filament" + }, + "time": "2026-11-13T13:04:11+00:00", + "published-time": "2026-11-13T13:04:21+00:00" + }, + { + "name": "filament/forms", + "version": "v5.11.3", + "source": { + "type": "git", + "url": "https://github.com/filamentphp/forms.git", + "reference": "a995e283a0828d73c786602739b8808d2ff90da4" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/filamentphp/forms/zipball/a995e283a0828d73c786602739b8808d2ff90da4", + "reference": "a995e283a0828d73c786602739b8808d2ff90da4", + "shasum": "" + }, + "require": { + "danharrin/date-format-converter": "^0.3", + "filament/actions": "self.version", + "filament/schemas": "self.version", + "filament/support": "self.version", + "php": "^8.2", + "ueberdosis/tiptap-php": "^2.0" + }, + "suggest": { + "fakerphp/faker": "Required to generate fake rich content and Markdown." + }, + "type": "library", + "extra": { + "laravel": { + "providers": [ + "Filament\\Forms\\FormsServiceProvider" + ] + } + }, + "autoload": { + "files": [ + "src/helpers.php" + ], + "psr-4": { + "Filament\\Forms\\": "src" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "description": "Build reactive forms with reusable fields and validation for Livewire.", + "homepage": "https://github.com/filamentphp/filament", + "support": { + "issues": "https://github.com/filamentphp/filament/issues", + "source": "https://github.com/filamentphp/filament" + }, + "time": "2026-11-13T12:59:39+00:00", + "published-time": "2026-11-13T12:59:51+00:00" + }, + { + "name": "filament/infolists", + "version": "v5.11.3", + "source": { + "type": "git", + "url": "https://github.com/filamentphp/infolists.git", + "reference": "139c17f78b6d7487549e313c1e020f0ca7f4da86" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/filamentphp/infolists/zipball/139c17f78b6d7487549e313c1e020f0ca7f4da86", + "reference": "139c17f78b6d7487549e313c1e020f0ca7f4da86", + "shasum": "" + }, + "require": { + "filament/actions": "self.version", + "filament/schemas": "self.version", + "filament/support": "self.version", + "php": "^8.2" + }, + "type": "library", + "extra": { + "laravel": { + "providers": [ + "Filament\\Infolists\\InfolistsServiceProvider" + ] + } + }, + "autoload": { + "psr-4": { + "Filament\\Infolists\\": "src" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "description": "Display read-only information with reusable entries and layouts for Livewire.", + "homepage": "https://github.com/filamentphp/filament", + "support": { + "issues": "https://github.com/filamentphp/filament/issues", + "source": "https://github.com/filamentphp/filament" + }, + "time": "2026-11-13T12:51:20+00:00", + "published-time": "2026-11-13T12:51:29+00:00" + }, + { + "name": "filament/notifications", + "version": "v5.11.3", + "source": { + "type": "git", + "url": "https://github.com/filamentphp/notifications.git", + "reference": "3927f0ec6cf4fb1e09a02383c7b5ed7fecdf14c6" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/filamentphp/notifications/zipball/3927f0ec6cf4fb1e09a02383c7b5ed7fecdf14c6", + "reference": "3927f0ec6cf4fb1e09a02383c7b5ed7fecdf14c6", + "shasum": "" + }, + "require": { + "filament/actions": "self.version", + "filament/support": "self.version", + "php": "^8.2" + }, + "type": "library", + "extra": { + "laravel": { + "providers": [ + "Filament\\Notifications\\NotificationsServiceProvider" + ] + } + }, + "autoload": { + "files": [ + "src/Testing/helpers.php" + ], + "psr-4": { + "Filament\\Notifications\\": "src" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "description": "Send in-app, database, and broadcast notifications with Livewire.", + "homepage": "https://github.com/filamentphp/filament", + "support": { + "issues": "https://github.com/filamentphp/filament/issues", + "source": "https://github.com/filamentphp/filament" + }, + "time": "2026-11-13T13:01:40+00:00", + "published-time": "2026-11-13T13:01:50+00:00" + }, + { + "name": "filament/query-builder", + "version": "v5.11.3", + "source": { + "type": "git", + "url": "https://github.com/filamentphp/query-builder.git", + "reference": "e75f020c16202716fc7c84e60a7d4d9eb7164184" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/filamentphp/query-builder/zipball/e75f020c16202716fc7c84e60a7d4d9eb7164184", + "reference": "e75f020c16202716fc7c84e60a7d4d9eb7164184", + "shasum": "" + }, + "require": { + "filament/actions": "self.version", + "filament/forms": "self.version", + "filament/schemas": "self.version", + "filament/support": "self.version", + "php": "^8.2" + }, + "type": "library", + "extra": { + "laravel": { + "providers": [ + "Filament\\QueryBuilder\\QueryBuilderServiceProvider" + ] + } + }, + "autoload": { + "psr-4": { + "Filament\\QueryBuilder\\": "src" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "description": "A powerful query builder component for Filament.", + "homepage": "https://github.com/filamentphp/filament", + "support": { + "issues": "https://github.com/filamentphp/filament/issues", + "source": "https://github.com/filamentphp/filament" + }, + "time": "2026-11-13T13:10:30+00:00", + "published-time": "2026-11-13T13:10:36+00:00" + }, + { + "name": "filament/schemas", + "version": "v5.11.3", + "source": { + "type": "git", + "url": "https://github.com/filamentphp/schemas.git", + "reference": "b82ac6e5314c2c987cfa163032618784404f0f59" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/filamentphp/schemas/zipball/b82ac6e5314c2c987cfa163032618784404f0f59", + "reference": "b82ac6e5314c2c987cfa163032618784404f0f59", + "shasum": "" + }, + "require": { + "danharrin/date-format-converter": "^0.3", + "filament/actions": "self.version", + "filament/support": "self.version", + "php": "^8.2" + }, + "type": "library", + "extra": { + "laravel": { + "providers": [ + "Filament\\Schemas\\SchemasServiceProvider" + ] + } + }, + "autoload": { + "psr-4": { + "Filament\\Schemas\\": "src" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "description": "Compose interfaces with reusable schema and layout components for Livewire.", + "homepage": "https://github.com/filamentphp/filament", + "support": { + "issues": "https://github.com/filamentphp/filament/issues", + "source": "https://github.com/filamentphp/filament" + }, + "time": "2026-11-13T13:06:00+00:00", + "published-time": "2026-11-13T13:06:07+00:00" + }, + { + "name": "filament/support", + "version": "v5.11.3", + "source": { + "type": "git", + "url": "https://github.com/filamentphp/support.git", + "reference": "dc2cb8659b75bf2ce6b1ffe230e0eba2b6324f8d" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/filamentphp/support/zipball/dc2cb8659b75bf2ce6b1ffe230e0eba2b6324f8d", + "reference": "dc2cb8659b75bf2ce6b1ffe230e0eba2b6324f8d", + "shasum": "" + }, + "require": { + "blade-ui-kit/blade-heroicons": "^2.5", + "composer-runtime-api": "^2.1", + "composer/class-map-generator": "^1.6", + "danharrin/livewire-rate-limiting": "^2.0", + "ext-intl": "*", + "illuminate/contracts": "^11.28|^12.0|^13.0", + "kirschbaum-development/eloquent-power-joins": "^4.0", + "league/uri-components": "^7.0", + "livewire/livewire": "^4.4.8", + "nette/php-generator": "^4.0", + "php": "^8.2", + "ryangjchandler/blade-capture-directive": "^1.0", + "spatie/invade": "^2.0", + "spatie/laravel-package-tools": "^1.9", + "symfony/console": "^7.0|^8.0", + "symfony/html-sanitizer": "^7.0|^8.0" + }, + "type": "library", + "extra": { + "laravel": { + "providers": [ + "Filament\\Support\\SupportServiceProvider" + ] + } + }, + "autoload": { + "files": [ + "src/helpers.php" + ], + "psr-4": { + "Filament\\Support\\": "src" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "description": "Core helper methods and foundation code for all Filament packages.", + "homepage": "https://github.com/filamentphp/filament", + "support": { + "issues": "https://github.com/filamentphp/filament/issues", + "source": "https://github.com/filamentphp/filament" + }, + "time": "2026-11-13T13:10:45+00:00", + "published-time": "2026-11-13T13:10:53+00:00" + }, + { + "name": "filament/tables", + "version": "v5.11.3", + "source": { + "type": "git", + "url": "https://github.com/filamentphp/tables.git", + "reference": "7baa9297f7a713151baa5bf8f5e84ee73169c545" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/filamentphp/tables/zipball/7baa9297f7a713151baa5bf8f5e84ee73169c545", + "reference": "7baa9297f7a713151baa5bf8f5e84ee73169c545", + "shasum": "" + }, + "require": { + "filament/actions": "self.version", + "filament/forms": "self.version", + "filament/query-builder": "self.version", + "filament/support": "self.version", + "php": "^8.2" + }, + "type": "library", + "extra": { + "laravel": { + "providers": [ + "Filament\\Tables\\TablesServiceProvider" + ] + } + }, + "autoload": { + "psr-4": { + "Filament\\Tables\\": "src" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "description": "Build interactive tables with filtering, sorting, actions, and pagination for Livewire.", + "homepage": "https://github.com/filamentphp/filament", + "support": { + "issues": "https://github.com/filamentphp/filament/issues", + "source": "https://github.com/filamentphp/filament" + }, + "time": "2026-11-13T13:22:10+00:00", + "published-time": "2026-11-13T13:22:19+00:00" + }, + { + "name": "filament/widgets", + "version": "v5.11.3", + "source": { + "type": "git", + "url": "https://github.com/filamentphp/widgets.git", + "reference": "d2fc5ec7decb0e2d948d45130cd1cd25f6100381" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/filamentphp/widgets/zipball/d2fc5ec7decb0e2d948d45130cd1cd25f6100381", + "reference": "d2fc5ec7decb0e2d948d45130cd1cd25f6100381", + "shasum": "" + }, + "require": { + "filament/schemas": "self.version", + "filament/support": "self.version", + "php": "^8.2" + }, + "type": "library", + "extra": { + "laravel": { + "providers": [ + "Filament\\Widgets\\WidgetsServiceProvider" + ] + } + }, + "autoload": { + "psr-4": { + "Filament\\Widgets\\": "src" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "description": "Build dashboards with charts, statistics, tables, and custom Livewire widgets.", + "homepage": "https://github.com/filamentphp/filament", + "support": { + "issues": "https://github.com/filamentphp/filament/issues", + "source": "https://github.com/filamentphp/filament" + }, + "time": "2026-11-13T12:59:18+00:00", + "published-time": "2026-11-13T12:59:26+00:00" + }, + { + "name": "fruitcake/php-cors", + "version": "v1.4.0", + "source": { + "type": "git", + "url": "https://github.com/fruitcake/php-cors.git", + "reference": "38aaa6c3fd4c157ffe2a4d10aa8b9b16ba8de379" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/fruitcake/php-cors/zipball/38aaa6c3fd4c157ffe2a4d10aa8b9b16ba8de379", + "reference": "38aaa6c3fd4c157ffe2a4d10aa8b9b16ba8de379", + "shasum": "" + }, + "require": { + "php": "^8.1", + "symfony/http-foundation": "^5.4|^6.4|^7.3|^8" + }, + "require-dev": { + "phpstan/phpstan": "^2", + "phpunit/phpunit": "^9", + "squizlabs/php_codesniffer": "^4" + }, + "type": "library", + "extra": { + "branch-alias": { + "dev-master": "1.3-dev" + } + }, + "autoload": { + "psr-4": { + "Fruitcake\\Cors\\": "src/" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "Fruitcake", + "homepage": "https://fruitcake.nl" + }, + { + "name": "Barryvdh", + "email": "barryvdh@gmail.com" + } + ], + "description": "Cross-origin resource sharing library for the Symfony HttpFoundation", + "homepage": "https://github.com/fruitcake/php-cors", + "keywords": [ + "cors", + "laravel", + "symfony" + ], + "support": { + "issues": "https://github.com/fruitcake/php-cors/issues", + "source": "https://github.com/fruitcake/php-cors/tree/v1.4.0" + }, + "funding": [ + { + "url": "https://fruitcake.nl", + "type": "custom" + }, + { + "url": "https://github.com/barryvdh", + "type": "github" + } + ], + "time": "2025-12-03T09:33:47+00:00", + "published-time": "2025-12-03T09:37:01+00:00" + }, + { + "name": "graham-campbell/result-type", + "version": "v1.2.0", + "source": { + "type": "git", + "url": "https://github.com/GrahamCampbell/Result-Type.git", + "reference": "adccca3324eece92ca35463648c12b9e6293c05b" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/GrahamCampbell/Result-Type/zipball/adccca3324eece92ca35463648c12b9e6293c05b", + "reference": "adccca3324eece92ca35463648c12b9e6293c05b", + "shasum": "" + }, + "require": { + "php": "^7.2.5 || ^8.0", + "phpoption/phpoption": "^1.10" + }, + "require-dev": { + "phpunit/phpunit": "^8.5.52 || ^9.6.34 || ^10.5.63 || ^11.5.55 || ^12.5.14" + }, + "type": "library", + "autoload": { + "psr-4": { + "GrahamCampbell\\ResultType\\": "src/" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "Graham Campbell", + "email": "hello@gjcampbell.co.uk", + "homepage": "https://github.com/GrahamCampbell" + } + ], + "description": "An Implementation Of The Result Type", + "keywords": [ + "Graham Campbell", + "GrahamCampbell", + "Result Type", + "Result-Type", + "result" + ], + "support": { + "issues": "https://github.com/GrahamCampbell/Result-Type/issues", + "source": "https://github.com/GrahamCampbell/Result-Type/tree/v1.2.0" + }, + "funding": [ + { + "url": "https://github.com/GrahamCampbell", + "type": "github" + }, + { + "url": "https://tidelift.com/funding/github/packagist/graham-campbell/result-type", + "type": "tidelift" + } + ], + "time": "2026-08-24T09:06:52+00:00", + "published-time": "2026-08-24T09:07:57+00:00" + }, + { + "name": "guzzlehttp/guzzle", + "version": "8.5.0", + "source": { + "type": "git", + "url": "https://github.com/guzzle/guzzle.git", + "reference": "f8aca40edffeae0ec508b92f4594766083c6e203" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/guzzle/guzzle/zipball/f8aca40edffeae0ec508b92f4594766083c6e203", + "reference": "f8aca40edffeae0ec508b92f4594766083c6e203", + "shasum": "" + }, + "require": { + "ext-json": "*", + "guzzlehttp/promises": "^3.1", + "guzzlehttp/psr7": "^3.4", + "php": "^7.4 || ^8.0", + "psr/http-client": "^1.0", + "psr/http-factory": "^1.0", + "symfony/deprecation-contracts": "^2.5 || ^3.0", + "symfony/polyfill-php80": "^1.25", + "symfony/polyfill-php82": "^1.27" + }, + "provide": { + "psr/http-client-implementation": "1.0" + }, + "require-dev": { + "bamarni/composer-bin-plugin": "^1.8.2", + "ext-curl": "*", + "guzzle/client-integration-tests": "4.0.1", + "guzzlehttp/test-server": "^1.1", + "php-http/message-factory": "^1.1", + "phpunit/phpunit": "^9.6.34", + "psr/log": "^1.1 || ^2.0 || ^3.0" + }, + "suggest": { + "ext-curl": "Required for CURL handler support", + "ext-intl": "Required for Internationalized Domain Name (IDN) support", + "psr/log": "Required for using the Log middleware" + }, + "type": "library", + "extra": { + "bamarni-bin": { + "bin-links": true, + "forward-command": false + } + }, + "autoload": { + "psr-4": { + "GuzzleHttp\\": "src/" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "Graham Campbell", + "email": "hello@gjcampbell.co.uk", + "homepage": "https://github.com/GrahamCampbell" + }, + { + "name": "Michael Dowling", + "email": "mtdowling@gmail.com", + "homepage": "https://github.com/mtdowling" + }, + { + "name": "Jeremy Lindblom", + "email": "jeremeamia@gmail.com", + "homepage": "https://github.com/jeremeamia" + }, + { + "name": "George Mponos", + "email": "gmponos@gmail.com", + "homepage": "https://github.com/gmponos" + }, + { + "name": "Tobias Nyholm", + "email": "tobias.nyholm@gmail.com", + "homepage": "https://github.com/Nyholm" + }, + { + "name": "Márk Sági-Kazár", + "email": "mark.sagikazar@gmail.com", + "homepage": "https://github.com/sagikazarmark" + }, + { + "name": "Tobias Schultze", + "email": "webmaster@tubo-world.de", + "homepage": "https://github.com/Tobion" + } + ], + "description": "Guzzle is a PHP HTTP client library", + "keywords": [ + "client", + "curl", + "framework", + "http", + "http client", + "psr-18", + "psr-7", + "rest", + "web service" + ], + "support": { + "issues": "https://github.com/guzzle/guzzle/issues", + "source": "https://github.com/guzzle/guzzle/tree/8.5.0" + }, + "funding": [ + { + "url": "https://github.com/GrahamCampbell", + "type": "github" + }, + { + "url": "https://github.com/Nyholm", + "type": "github" + }, + { + "url": "https://tidelift.com/funding/github/packagist/guzzlehttp/guzzle", + "type": "tidelift" + } + ], + "time": "2026-11-13T03:12:32+00:00", + "published-time": "2026-11-13T03:13:04+00:00" + }, + { + "name": "guzzlehttp/promises", + "version": "3.1.0", + "source": { + "type": "git", + "url": "https://github.com/guzzle/promises.git", + "reference": "094d0ec418eb3b1411ea271a180ec95cae6ae933" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/guzzle/promises/zipball/094d0ec418eb3b1411ea271a180ec95cae6ae933", + "reference": "094d0ec418eb3b1411ea271a180ec95cae6ae933", + "shasum": "" + }, + "require": { + "php": "^7.4 || ^8.0", + "symfony/deprecation-contracts": "^2.5 || ^3.0" + }, + "require-dev": { + "bamarni/composer-bin-plugin": "^1.8.2", + "phpunit/phpunit": "^9.6.34" + }, + "type": "library", + "extra": { + "bamarni-bin": { + "bin-links": true, + "forward-command": false + } + }, + "autoload": { + "psr-4": { + "GuzzleHttp\\Promise\\": "src/" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "Graham Campbell", + "email": "hello@gjcampbell.co.uk", + "homepage": "https://github.com/GrahamCampbell" + }, + { + "name": "Michael Dowling", + "email": "mtdowling@gmail.com", + "homepage": "https://github.com/mtdowling" + }, + { + "name": "Tobias Nyholm", + "email": "tobias.nyholm@gmail.com", + "homepage": "https://github.com/Nyholm" + }, + { + "name": "Tobias Schultze", + "email": "webmaster@tubo-world.de", + "homepage": "https://github.com/Tobion" + } + ], + "description": "Guzzle promises library", + "keywords": [ + "promise" + ], + "support": { + "issues": "https://github.com/guzzle/promises/issues", + "source": "https://github.com/guzzle/promises/tree/3.1.0" + }, + "funding": [ + { + "url": "https://github.com/GrahamCampbell", + "type": "github" + }, + { + "url": "https://github.com/Nyholm", + "type": "github" + }, + { + "url": "https://tidelift.com/funding/github/packagist/guzzlehttp/promises", + "type": "tidelift" + } + ], + "time": "2026-10-18T12:48:16+00:00", + "published-time": "2026-10-18T12:48:47+00:00" + }, + { + "name": "guzzlehttp/psr7", + "version": "3.4.0", + "source": { + "type": "git", + "url": "https://github.com/guzzle/psr7.git", + "reference": "180bd6fcebd1dc289cbec5c576135f4b6f576e02" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/guzzle/psr7/zipball/180bd6fcebd1dc289cbec5c576135f4b6f576e02", + "reference": "180bd6fcebd1dc289cbec5c576135f4b6f576e02", + "shasum": "" + }, + "require": { + "php": "^7.4 || ^8.0", + "psr/http-factory": "^1.1", + "psr/http-message": "^2.0", + "symfony/deprecation-contracts": "^2.5 || ^3.0", + "symfony/polyfill-php80": "^1.25", + "symfony/polyfill-php82": "^1.27" + }, + "provide": { + "psr/http-factory-implementation": "1.1", + "psr/http-message-implementation": "2.0" + }, + "require-dev": { + "bamarni/composer-bin-plugin": "^1.8.2", + "http-interop/http-factory-tests": "1.1.0", + "jshttp/mime-db": "1.54.0.1", + "php-http/psr7-integration-tests": "^1.5.1", + "phpunit/phpunit": "^9.6.34" + }, + "suggest": { + "laminas/laminas-httphandlerrunner": "Emit PSR-7 responses" + }, + "type": "library", + "extra": { + "bamarni-bin": { + "bin-links": true, + "forward-command": false + } + }, + "autoload": { + "psr-4": { + "GuzzleHttp\\Psr7\\": "src/" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "Graham Campbell", + "email": "hello@gjcampbell.co.uk", + "homepage": "https://github.com/GrahamCampbell" + }, + { + "name": "Michael Dowling", + "email": "mtdowling@gmail.com", + "homepage": "https://github.com/mtdowling" + }, + { + "name": "George Mponos", + "email": "gmponos@gmail.com", + "homepage": "https://github.com/gmponos" + }, + { + "name": "Tobias Nyholm", + "email": "tobias.nyholm@gmail.com", + "homepage": "https://github.com/Nyholm" + }, + { + "name": "Márk Sági-Kazár", + "email": "mark.sagikazar@gmail.com", + "homepage": "https://github.com/sagikazarmark" + }, + { + "name": "Tobias Schultze", + "email": "webmaster@tubo-world.de", + "homepage": "https://github.com/Tobion" + }, + { + "name": "Márk Sági-Kazár", + "email": "mark.sagikazar@gmail.com", + "homepage": "https://sagikazarmark.hu" + } + ], + "description": "PSR-7 message implementation that also provides common utility methods", + "keywords": [ + "http", + "message", + "psr-7", + "request", + "response", + "stream", + "uri", + "url" + ], + "support": { + "issues": "https://github.com/guzzle/psr7/issues", + "source": "https://github.com/guzzle/psr7/tree/3.4.0" + }, + "funding": [ + { + "url": "https://github.com/GrahamCampbell", + "type": "github" + }, + { + "url": "https://github.com/Nyholm", + "type": "github" + }, + { + "url": "https://tidelift.com/funding/github/packagist/guzzlehttp/psr7", + "type": "tidelift" + } + ], + "time": "2026-11-13T03:03:24+00:00", + "published-time": "2026-11-13T03:06:05+00:00" + }, + { + "name": "guzzlehttp/uri-template", + "version": "v2.0.1", + "source": { + "type": "git", + "url": "https://github.com/guzzle/uri-template.git", + "reference": "7a466ad606491eb6528c717482f7cca77f1851f3" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/guzzle/uri-template/zipball/7a466ad606491eb6528c717482f7cca77f1851f3", + "reference": "7a466ad606491eb6528c717482f7cca77f1851f3", + "shasum": "" + }, + "require": { + "php": "^7.4 || ^8.0", + "symfony/polyfill-php80": "^1.25" + }, + "require-dev": { + "bamarni/composer-bin-plugin": "^1.8.2", + "phpunit/phpunit": "^9.6.34", + "uri-template/tests": "1.0.2" + }, + "type": "library", + "extra": { + "bamarni-bin": { + "bin-links": true, + "forward-command": false + } + }, + "autoload": { + "psr-4": { + "GuzzleHttp\\UriTemplate\\": "src" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "Graham Campbell", + "email": "hello@gjcampbell.co.uk", + "homepage": "https://github.com/GrahamCampbell" + }, + { + "name": "Michael Dowling", + "email": "mtdowling@gmail.com", + "homepage": "https://github.com/mtdowling" + }, + { + "name": "George Mponos", + "email": "gmponos@gmail.com", + "homepage": "https://github.com/gmponos" + }, + { + "name": "Tobias Nyholm", + "email": "tobias.nyholm@gmail.com", + "homepage": "https://github.com/Nyholm" + } + ], + "description": "A polyfill class for uri_template of PHP", + "keywords": [ + "guzzlehttp", + "uri-template" + ], + "support": { + "issues": "https://github.com/guzzle/uri-template/issues", + "source": "https://github.com/guzzle/uri-template/tree/v2.0.1" + }, + "funding": [ + { + "url": "https://github.com/GrahamCampbell", + "type": "github" + }, + { + "url": "https://github.com/Nyholm", + "type": "github" + }, + { + "url": "https://tidelift.com/funding/github/packagist/guzzlehttp/uri-template", + "type": "tidelift" + } + ], + "time": "2026-08-24T17:13:02+00:00", + "published-time": "2026-08-24T17:13:22+00:00" + }, + { + "name": "kirschbaum-development/eloquent-power-joins", + "version": "4.3.6", + "source": { + "type": "git", + "url": "https://github.com/kirschbaum-development/eloquent-power-joins.git", + "reference": "549b642c027719b34787246f2c0121cff10adf42" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/kirschbaum-development/eloquent-power-joins/zipball/549b642c027719b34787246f2c0121cff10adf42", + "reference": "549b642c027719b34787246f2c0121cff10adf42", + "shasum": "" + }, + "require": { + "illuminate/database": "^11.42|^12.0|^13.0", + "illuminate/support": "^11.42|^12.0|^13.0", + "php": "^8.2" + }, + "require-dev": { + "friendsofphp/php-cs-fixer": "dev-master", + "laravel/legacy-factories": "^1.0@dev|dev-master", + "orchestra/testbench": "^9.0|^10.0|^11.0", + "phpunit/phpunit": "^10.0|^11.0|^12.0" + }, + "type": "library", + "extra": { + "laravel": { + "providers": [ + "Kirschbaum\\PowerJoins\\PowerJoinsServiceProvider" + ] + } + }, + "autoload": { + "psr-4": { + "Kirschbaum\\PowerJoins\\": "src" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "Luis Dalmolin", + "email": "luis.nh@gmail.com", + "role": "Developer" + } + ], + "description": "The Laravel magic applied to joins.", + "homepage": "https://github.com/kirschbaum-development/eloquent-power-joins", + "keywords": [ + "eloquent", + "join", + "laravel", + "mysql" + ], + "support": { + "issues": "https://github.com/kirschbaum-development/eloquent-power-joins/issues", + "source": "https://github.com/kirschbaum-development/eloquent-power-joins/tree/4.3.6" + }, + "time": "2026-10-24T14:38:24+00:00", + "published-time": "2026-10-24T14:38:47+00:00" + }, + { + "name": "laravel/framework", + "version": "v13.42.0", + "source": { + "type": "git", + "url": "https://github.com/laravel/framework.git", + "reference": "f5c01f6b63803f16f38ebb31622c4fea412bd022" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/laravel/framework/zipball/f5c01f6b63803f16f38ebb31622c4fea412bd022", + "reference": "f5c01f6b63803f16f38ebb31622c4fea412bd022", + "shasum": "" + }, + "require": { + "brick/math": "^0.14.2 || ^0.15 || ^0.16 || ^0.17 || ^0.18 || ^0.19 || ^0.20 || ^1.0", + "composer-runtime-api": "^2.2", + "doctrine/inflector": "^2.0.5", + "dragonmantank/cron-expression": "^3.4", + "egulias/email-validator": "^4.0", + "ext-ctype": "*", + "ext-filter": "*", + "ext-hash": "*", + "ext-mbstring": "*", + "ext-openssl": "*", + "ext-session": "*", + "ext-tokenizer": "*", + "fruitcake/php-cors": "^1.3", + "guzzlehttp/guzzle": "^7.8.2 || ^8.0", + "guzzlehttp/promises": "^2.0.3 || ^3.0", + "guzzlehttp/psr7": "^2.9 || ^3.0", + "guzzlehttp/uri-template": "^1.0 || ^2.0", + "laravel/prompts": "^0.3.25", + "laravel/serializable-closure": "^2.0.10", + "league/commonmark": "^2.8.1", + "league/flysystem": "^3.25.1", + "league/flysystem-local": "^3.25.1", + "league/uri": "^7.6", + "monolog/monolog": "^3.10", + "nesbot/carbon": "^3.8.4", + "nunomaduro/termwind": "^2.0", + "php": "^8.3", + "psr/container": "^1.1.1 || ^2.0.1", + "psr/http-message": "^1.0 || ^2.0", + "psr/log": "^1.0 || ^2.0 || ^3.0", + "psr/simple-cache": "^1.0 || ^2.0 || ^3.0", + "ramsey/uuid": "^4.7", + "symfony/console": "^7.4.0 || ^8.0.0", + "symfony/error-handler": "^7.4.0 || ^8.0.0", + "symfony/finder": "^7.4.0 || ^8.0.0", + "symfony/http-foundation": "^7.4.0 || ^8.0.0", + "symfony/http-kernel": "^7.4.0 || ^8.0.0", + "symfony/mailer": "^7.4.0 || ^8.0.0", + "symfony/mime": "^7.4.0 || ^8.0.0", + "symfony/polyfill-php84": "^1.36", + "symfony/polyfill-php85": "^1.36", + "symfony/polyfill-php86": "^1.36", + "symfony/process": "^7.4.5 || ^8.0.5", + "symfony/routing": "^7.4.0 || ^8.0.0", + "symfony/uid": "^7.4.0 || ^8.0.0", + "symfony/var-dumper": "^7.4.0 || ^8.0.0", + "tijsverkoyen/css-to-inline-styles": "^2.2.5", + "vlucas/phpdotenv": "^5.6.1", + "voku/portable-ascii": "^2.0.2" + }, + "conflict": { + "tightenco/collect": "<5.5.33" + }, + "provide": { + "psr/container-implementation": "1.1 || 2.0", + "psr/log-implementation": "1.0 || 2.0 || 3.0", + "psr/simple-cache-implementation": "1.0 || 2.0 || 3.0" + }, + "replace": { + "illuminate/auth": "self.version", + "illuminate/broadcasting": "self.version", + "illuminate/bus": "self.version", + "illuminate/cache": "self.version", + "illuminate/collections": "self.version", + "illuminate/concurrency": "self.version", + "illuminate/conditionable": "self.version", + "illuminate/config": "self.version", + "illuminate/console": "self.version", + "illuminate/container": "self.version", + "illuminate/contracts": "self.version", + "illuminate/cookie": "self.version", + "illuminate/database": "self.version", + "illuminate/encryption": "self.version", + "illuminate/events": "self.version", + "illuminate/filesystem": "self.version", + "illuminate/hashing": "self.version", + "illuminate/http": "self.version", + "illuminate/image": "self.version", + "illuminate/json-schema": "self.version", + "illuminate/log": "self.version", + "illuminate/macroable": "self.version", + "illuminate/mail": "self.version", + "illuminate/notifications": "self.version", + "illuminate/pagination": "self.version", + "illuminate/pipeline": "self.version", + "illuminate/process": "self.version", + "illuminate/queue": "self.version", + "illuminate/redis": "self.version", + "illuminate/reflection": "self.version", + "illuminate/routing": "self.version", + "illuminate/session": "self.version", + "illuminate/support": "self.version", + "illuminate/testing": "self.version", + "illuminate/translation": "self.version", + "illuminate/validation": "self.version", + "illuminate/view": "self.version", + "spatie/once": "*" + }, + "require-dev": { + "ably/pubsub-server": "^1.0|^2.0", + "aws/aws-sdk-php": "^3.322.9", + "ext-gmp": "*", + "fakerphp/faker": "^1.24", + "intervention/image": "^4.2", + "jasonmccreary/double": "^1.1", + "laravel/pint": "^1.18", + "league/flysystem-aws-s3-v3": "^3.25.1", + "league/flysystem-ftp": "^3.25.1", + "league/flysystem-path-prefixing": "^3.25.1", + "league/flysystem-read-only": "^3.25.1", + "league/flysystem-sftp-v3": "^3.25.1", + "mockery/mockery": "^1.6.10", + "opis/json-schema": "^2.4.1", + "orchestra/testbench-core": "^11.6.0", + "pda/pheanstalk": "^7.0.0 || ^8.0.0", + "php-http/discovery": "^1.15", + "phpstan/phpstan": "2.3.5", + "phpunit/phpunit": "^11.5.50 || ^12.5.8 || ^13.0.3", + "predis/predis": "^2.3 || ^3.0", + "rector/rector": "2.6.3", + "resend/resend-php": "^1.0", + "symfony/cache": "^7.4.0 || ^8.0.0", + "symfony/http-client": "^7.4.0 || ^8.0.0", + "symfony/mercure": "^0.8.0", + "symfony/psr-http-message-bridge": "^7.4.0 || ^8.0.0", + "symfony/translation": "^7.4.0 || ^8.0.0", + "web-token/jwt-library": "^4.1" + }, + "suggest": { + "ably/pubsub-server": "Required to use the Ably broadcast driver (^1.0|^2.0).", + "aws/aws-sdk-php": "Required to use the SQS queue driver, DynamoDb failed job storage, and SES mail driver (^3.322.9).", + "brianium/paratest": "Required to run tests in parallel (^7.0 || ^8.0).", + "ext-apcu": "Required to use the APC cache driver.", + "ext-fileinfo": "Required to use the Filesystem class.", + "ext-ftp": "Required to use the Flysystem FTP driver.", + "ext-gd": "Required to use Illuminate\\Http\\Testing\\FileFactory::image().", + "ext-memcached": "Required to use the memcache cache driver.", + "ext-pcntl": "Required to use all features of the queue worker and console signal trapping.", + "ext-pdo": "Required to use all database features.", + "ext-posix": "Required to use all features of the queue worker.", + "ext-redis": "Required to use the Redis cache and queue drivers (^4.0 || ^5.0 || ^6.0).", + "fakerphp/faker": "Required to generate fake data using the fake() helper (^1.23).", + "filp/whoops": "Required for friendly error pages in development (^2.14.3).", + "intervention/image": "Required to use the image processing features (^4.2).", + "laravel/tinker": "Required to use the tinker console command (^2.0).", + "league/flysystem-aws-s3-v3": "Required to use the Flysystem S3 driver (^3.25.1).", + "league/flysystem-ftp": "Required to use the Flysystem FTP driver (^3.25.1).", + "league/flysystem-path-prefixing": "Required to use the scoped driver (^3.25.1).", + "league/flysystem-read-only": "Required to use read-only disks (^3.25.1)", + "league/flysystem-sftp-v3": "Required to use the Flysystem SFTP driver (^3.25.1).", + "mockery/mockery": "Required to use mocking (^1.6).", + "pda/pheanstalk": "Required to use the beanstalk queue driver (^7.0 || ^8.0).", + "php-http/discovery": "Required to use PSR-7 bridging features (^1.15).", + "phpunit/phpunit": "Required to use assertions and run tests (^11.5.50 || ^12.5.8 || ^13.0.3).", + "predis/predis": "Required to use the predis connector (^2.3 || ^3.0).", + "pusher/pusher-php-server": "Required to use the Pusher broadcast driver (^6.0 || ^7.0).", + "resend/resend-php": "Required to enable support for the Resend mail transport (^0.10.0 || ^1.0).", + "spatie/fork": "Required to use the 'fork' concurrency driver (^1.2).", + "symfony/cache": "Required to PSR-6 cache bridge (^7.4 || ^8.0).", + "symfony/filesystem": "Required to enable support for relative symbolic links (^7.4 || ^8.0).", + "symfony/http-client": "Required to enable support for the Symfony API mail transports (^7.4 || ^8.0).", + "symfony/mailgun-mailer": "Required to enable support for the Mailgun mail transport (^7.4 || ^8.0).", + "symfony/mercure": "Required to use the Mercure broadcast driver (^0.8).", + "symfony/postmark-mailer": "Required to enable support for the Postmark mail transport (^7.4 || ^8.0).", + "symfony/psr-http-message-bridge": "Required to use PSR-7 bridging features (^7.4 || ^8.0).", + "web-token/jwt-library": "Required to sign Mercure JWTs and use end-to-end encrypted channels (^4.1)." + }, + "type": "library", + "extra": { + "branch-alias": { + "dev-master": "13.0.x-dev" + } + }, + "autoload": { + "files": [ + "src/Illuminate/Collections/functions.php", + "src/Illuminate/Collections/helpers.php", + "src/Illuminate/Events/functions.php", + "src/Illuminate/Filesystem/functions.php", + "src/Illuminate/Foundation/helpers.php", + "src/Illuminate/Log/functions.php", + "src/Illuminate/Reflection/helpers.php", + "src/Illuminate/Support/functions.php", + "src/Illuminate/Support/helpers.php" + ], + "psr-4": { + "Illuminate\\": "src/Illuminate/", + "Illuminate\\Support\\": [ + "src/Illuminate/Macroable/", + "src/Illuminate/Collections/", + "src/Illuminate/Conditionable/", + "src/Illuminate/Reflection/" + ] + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "Taylor Otwell", + "email": "taylor@laravel.com" + } + ], + "description": "The Laravel Framework.", + "homepage": "https://laravel.com", + "keywords": [ + "framework", + "laravel" + ], + "support": { + "issues": "https://github.com/laravel/framework/issues", + "source": "https://github.com/laravel/framework" + }, + "time": "2026-11-10T15:54:30+00:00", + "published-time": "2026-11-10T15:55:04+00:00" + }, + { + "name": "laravel/prompts", + "version": "v0.3.27", + "source": { + "type": "git", + "url": "https://github.com/laravel/prompts.git", + "reference": "abdfc75a1ae6c6f21522daed50da7124cbff09d2" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/laravel/prompts/zipball/abdfc75a1ae6c6f21522daed50da7124cbff09d2", + "reference": "abdfc75a1ae6c6f21522daed50da7124cbff09d2", + "shasum": "" + }, + "require": { + "composer-runtime-api": "^2.2", + "ext-mbstring": "*", + "php": "^8.1", + "symfony/console": "^6.2|^7.0|^8.0" + }, + "conflict": { + "illuminate/console": ">=10.17.0 <10.25.0", + "laravel/framework": ">=10.17.0 <10.25.0" + }, + "require-dev": { + "illuminate/collections": "^10.0|^11.0|^12.0|^13.0", + "mockery/mockery": "^1.5", + "pestphp/pest": "^2.3|^3.4|^4.0", + "phpstan/phpstan": "^1.12.28", + "phpstan/phpstan-mockery": "^1.1.3" + }, + "suggest": { + "ext-pcntl": "Required for the spinner to be animated." + }, + "type": "library", + "extra": { + "branch-alias": { + "dev-main": "0.3.x-dev" + } + }, + "autoload": { + "files": [ + "src/helpers.php" + ], + "psr-4": { + "Laravel\\Prompts\\": "src/" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "description": "Add beautiful and user-friendly forms to your command-line applications.", + "support": { + "source": "https://github.com/laravel/prompts/tree/v0.3.27" + }, + "time": "2026-11-09T16:07:10+00:00", + "published-time": "2026-11-09T16:09:07+00:00" + }, + { + "name": "laravel/serializable-closure", + "version": "v2.2.0", + "source": { + "type": "git", + "url": "https://github.com/laravel/serializable-closure.git", + "reference": "2bfb44e8af009b553ed2c060c94b0bc3c67b4769" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/laravel/serializable-closure/zipball/2bfb44e8af009b553ed2c060c94b0bc3c67b4769", + "reference": "2bfb44e8af009b553ed2c060c94b0bc3c67b4769", + "shasum": "" + }, + "require": { + "php": "^8.1" + }, + "require-dev": { + "illuminate/support": "^10.0|^11.0|^12.0|^13.0", + "nesbot/carbon": "^2.67|^3.0", + "pestphp/pest": "^2.36|^3.0|^4.0", + "phpstan/phpstan": "^2.0", + "symfony/var-dumper": "^6.2.0|^7.0.0|^8.0.0" + }, + "type": "library", + "extra": { + "branch-alias": { + "dev-master": "2.x-dev" + } + }, + "autoload": { + "psr-4": { + "Laravel\\SerializableClosure\\": "src/" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "Taylor Otwell", + "email": "taylor@laravel.com" + }, + { + "name": "Nuno Maduro", + "email": "nuno@laravel.com" + } + ], + "description": "Laravel Serializable Closure provides an easy and secure way to serialize closures in PHP.", + "keywords": [ + "closure", + "laravel", + "serializable" + ], + "support": { + "issues": "https://github.com/laravel/serializable-closure/issues", + "source": "https://github.com/laravel/serializable-closure" + }, + "time": "2026-10-14T21:20:29+00:00", + "published-time": "2026-11-10T16:11:08+00:00" + }, + { + "name": "laravel/tinker", + "version": "v3.1.0", + "source": { + "type": "git", + "url": "https://github.com/laravel/tinker.git", + "reference": "5fab2518167975b302e10d1fdf9a8c8113849201" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/laravel/tinker/zipball/5fab2518167975b302e10d1fdf9a8c8113849201", + "reference": "5fab2518167975b302e10d1fdf9a8c8113849201", + "shasum": "" + }, + "require": { + "illuminate/console": "^8.0|^9.0|^10.0|^11.0|^12.0|^13.0", + "illuminate/contracts": "^8.0|^9.0|^10.0|^11.0|^12.0|^13.0", + "illuminate/support": "^8.0|^9.0|^10.0|^11.0|^12.0|^13.0", + "php": "^8.1", + "psy/psysh": "^0.12.19", + "symfony/var-dumper": "^5.4|^6.0|^7.0|^8.0" + }, + "require-dev": { + "phpstan/phpstan": "^1.10", + "phpunit/phpunit": "^10.5|^11.5|^12.5|^13.4" + }, + "suggest": { + "illuminate/database": "The Illuminate Database package (^8.0|^9.0|^10.0|^11.0|^12.0|^13.0)." + }, + "type": "library", + "extra": { + "laravel": { + "providers": [ + "Laravel\\Tinker\\TinkerServiceProvider" + ] + }, + "branch-alias": { + "dev-master": "3.x-dev" + } + }, + "autoload": { + "psr-4": { + "Laravel\\Tinker\\": "src/" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "Taylor Otwell", + "email": "taylor@laravel.com" + } + ], + "description": "Powerful REPL for the Laravel framework.", + "keywords": [ + "REPL", + "Tinker", + "laravel", + "psysh" + ], + "support": { + "issues": "https://github.com/laravel/tinker/issues", + "source": "https://github.com/laravel/tinker/tree/v3.1.0" + }, + "time": "2026-10-16T11:13:33+00:00", + "published-time": "2026-11-10T16:12:15+00:00" + }, + { + "name": "league/commonmark", + "version": "2.10.7", + "source": { + "type": "git", + "url": "https://github.com/thephpleague/commonmark.git", + "reference": "8eb53e906fd60c67038d22f1f1cab420ed58b8be" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/thephpleague/commonmark/zipball/8eb53e906fd60c67038d22f1f1cab420ed58b8be", + "reference": "8eb53e906fd60c67038d22f1f1cab420ed58b8be", + "shasum": "" + }, + "require": { + "ext-mbstring": "*", + "league/config": "^1.1.1", + "php": "^7.4 || ^8.0", + "psr/event-dispatcher": "^1.0", + "symfony/deprecation-contracts": "^2.1 || ^3.0", + "symfony/polyfill-php80": "^1.16" + }, + "require-dev": { + "cebe/markdown": "^1.0", + "commonmark/cmark": "0.31.1", + "commonmark/commonmark.js": "0.31.1", + "composer/package-versions-deprecated": "^1.8", + "embed/embed": "^4.4", + "erusev/parsedown": "^1.0", + "ext-json": "*", + "github/gfm": "0.29.0", + "michelf/php-markdown": "^1.4 || ^2.0", + "nyholm/psr7": "^1.5", + "phpstan/phpstan": "^2.0.0", + "phpunit/phpunit": "^9.5.21 || ^10.5.9 || ^11.0.0 || ^12.0.0 || ^13.0.0", + "scrutinizer/ocular": "^1.8.1", + "symfony/finder": "^5.3 | ^6.0 | ^7.0 || ^8.0", + "symfony/process": "^5.4 | ^6.0 | ^7.0 || ^8.0", + "symfony/yaml": "^2.3 | ^3.0 | ^4.0 | ^5.0 | ^6.0 | ^7.0 || ^8.0", + "unleashedtech/php-coding-standard": "^3.1.1", + "vimeo/psalm": "^4.24.0 || ^5.0.0 || ^6.0.0" + }, + "suggest": { + "symfony/yaml": "v2.3+ required if using the Front Matter extension" + }, + "type": "library", + "extra": { + "branch-alias": { + "dev-main": "2.11-dev" + } + }, + "autoload": { + "psr-4": { + "League\\CommonMark\\": "src" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "BSD-3-Clause" + ], + "authors": [ + { + "name": "Colin O'Dell", + "email": "colinodell@gmail.com", + "homepage": "https://www.colinodell.com", + "role": "Lead Developer" + } + ], + "description": "Highly-extensible PHP Markdown parser which fully supports the CommonMark spec and GitHub-Flavored Markdown (GFM)", + "homepage": "https://commonmark.thephpleague.com", + "keywords": [ + "commonmark", + "flavored", + "gfm", + "github", + "github-flavored", + "markdown", + "md", + "parser" + ], + "support": { + "docs": "https://commonmark.thephpleague.com/", + "forum": "https://github.com/thephpleague/commonmark/discussions", + "issues": "https://github.com/thephpleague/commonmark/issues", + "rss": "https://github.com/thephpleague/commonmark/releases.atom", + "source": "https://github.com/thephpleague/commonmark" + }, + "funding": [ + { + "url": "https://www.colinodell.com/sponsor", + "type": "custom" + }, + { + "url": "https://www.paypal.me/colinpodell/10.00", + "type": "custom" + }, + { + "url": "https://github.com/colinodell", + "type": "github" + }, + { + "url": "https://tidelift.com/funding/github/packagist/league/commonmark", + "type": "tidelift" + } + ], + "time": "2026-10-31T13:35:37+00:00", + "published-time": "2026-10-31T13:35:57+00:00" + }, + { + "name": "league/config", + "version": "v1.2.0", + "source": { + "type": "git", + "url": "https://github.com/thephpleague/config.git", + "reference": "754b3604fb2984c71f4af4a9cbe7b57f346ec1f3" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/thephpleague/config/zipball/754b3604fb2984c71f4af4a9cbe7b57f346ec1f3", + "reference": "754b3604fb2984c71f4af4a9cbe7b57f346ec1f3", + "shasum": "" + }, + "require": { + "dflydev/dot-access-data": "^3.0.1", + "nette/schema": "^1.2", + "php": "^7.4 || ^8.0" + }, + "require-dev": { + "phpstan/phpstan": "^1.8.2", + "phpunit/phpunit": "^9.5.5", + "scrutinizer/ocular": "^1.8.1", + "unleashedtech/php-coding-standard": "^3.1", + "vimeo/psalm": "^4.7.3" + }, + "type": "library", + "extra": { + "branch-alias": { + "dev-main": "1.2-dev" + } + }, + "autoload": { + "psr-4": { + "League\\Config\\": "src" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "BSD-3-Clause" + ], + "authors": [ + { + "name": "Colin O'Dell", + "email": "colinodell@gmail.com", + "homepage": "https://www.colinodell.com", + "role": "Lead Developer" + } + ], + "description": "Define configuration arrays with strict schemas and access values with dot notation", + "homepage": "https://config.thephpleague.com", + "keywords": [ + "array", + "config", + "configuration", + "dot", + "dot-access", + "nested", + "schema" + ], + "support": { + "docs": "https://config.thephpleague.com/", + "issues": "https://github.com/thephpleague/config/issues", + "rss": "https://github.com/thephpleague/config/releases.atom", + "source": "https://github.com/thephpleague/config" + }, + "funding": [ + { + "url": "https://www.colinodell.com/sponsor", + "type": "custom" + }, + { + "url": "https://www.paypal.me/colinpodell/10.00", + "type": "custom" + }, + { + "url": "https://github.com/colinodell", + "type": "github" + } + ], + "time": "2022-12-11T20:36:23+00:00", + "published-time": "2022-12-11T20:36:45+00:00" + }, + { + "name": "league/csv", + "version": "9.29.0", + "source": { + "type": "git", + "url": "https://github.com/thephpleague/csv.git", + "reference": "13d5600d2c935c8785707e7d1d44ca1f2a22d6f4" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/thephpleague/csv/zipball/13d5600d2c935c8785707e7d1d44ca1f2a22d6f4", + "reference": "13d5600d2c935c8785707e7d1d44ca1f2a22d6f4", + "shasum": "" + }, + "require": { + "ext-filter": "*", + "php": "^8.2.0" + }, + "require-dev": { + "ext-dom": "*", + "ext-xdebug": "*", + "friendsofphp/php-cs-fixer": "^3.92.3", + "phpbench/phpbench": "^1.4.3", + "phpstan/phpstan": "^2.2.8", + "phpstan/phpstan-deprecation-rules": "^2.0.5", + "phpstan/phpstan-phpunit": "^2.0.18", + "phpstan/phpstan-strict-rules": "^2.0.12", + "phpunit/phpunit": "^11.5.22 || ^12.5.4 || ^13.3.1", + "rector/rector": "^2.6.3", + "symfony/var-dumper": "^6.4.8 || ^7.4.0 || ^8.0" + }, + "suggest": { + "ext-dom": "Required to use the XMLConverter and the HTMLConverter classes", + "ext-iconv": "Needed to ease transcoding CSV using iconv stream filters", + "ext-mbstring": "Needed to ease transcoding CSV using mb stream filters", + "ext-mysqli": "Requiered to use the package with the MySQLi extension", + "ext-pdo": "Required to use the package with the PDO extension", + "ext-pgsql": "Requiered to use the package with the PgSQL extension", + "ext-sqlite3": "Required to use the package with the SQLite3 extension" + }, + "type": "library", + "extra": { + "branch-alias": { + "dev-master": "9.x-dev" + } + }, + "autoload": { + "files": [ + "src/functions_include.php" + ], + "psr-4": { + "League\\Csv\\": "src" + }, + "classmap": [ + "polyfill" + ] + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "Ignace Nyamagana Butera", + "email": "nyamsprod@gmail.com", + "homepage": "https://github.com/nyamsprod/", + "role": "Developer" + } + ], + "description": "CSV data manipulation made easy in PHP", + "homepage": "https://csv.thephpleague.com", + "keywords": [ + "convert", + "csv", + "export", + "filter", + "import", + "read", + "transform", + "write" + ], + "support": { + "docs": "https://csv.thephpleague.com", + "issues": "https://github.com/thephpleague/csv/issues", + "rss": "https://github.com/thephpleague/csv/releases.atom", + "source": "https://github.com/thephpleague/csv" + }, + "funding": [ + { + "url": "https://github.com/sponsors/nyamsprod", + "type": "github" + } + ], + "time": "2026-10-28T08:56:24+00:00", + "published-time": "2026-10-28T08:59:25+00:00" + }, + { + "name": "league/flysystem", + "version": "3.36.0", + "source": { + "type": "git", + "url": "https://github.com/thephpleague/flysystem.git", + "reference": "f7fb152932f30072d573510cbd4dd657d6475b25" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/thephpleague/flysystem/zipball/f7fb152932f30072d573510cbd4dd657d6475b25", + "reference": "f7fb152932f30072d573510cbd4dd657d6475b25", + "shasum": "" + }, + "require": { + "league/flysystem-local": "^3.0.0", + "league/mime-type-detection": "^1.0.0", + "php": "^8.0.2" + }, + "conflict": { + "async-aws/core": "<1.19.0", + "async-aws/s3": "<1.14.0", + "aws/aws-sdk-php": "3.209.31 || 3.210.0", + "guzzlehttp/guzzle": "<7.0", + "guzzlehttp/ringphp": "<1.1.1", + "phpseclib/phpseclib": "3.0.15", + "symfony/http-client": "<5.2" + }, + "require-dev": { + "async-aws/s3": "^1.5 || ^2.0", + "async-aws/simple-s3": "^1.1 || ^2.0", + "aws/aws-sdk-php": "^3.295.10", + "composer/semver": "^3.0", + "ext-fileinfo": "*", + "ext-ftp": "*", + "ext-mongodb": "^1.3|^2", + "ext-zip": "*", + "friendsofphp/php-cs-fixer": "^3.5", + "google/cloud-storage": "^1.23", + "guzzlehttp/psr7": "^2.6", + "microsoft/azure-storage-blob": "^1.1", + "mongodb/mongodb": "^1.2|^2", + "phpseclib/phpseclib": "^3.0.36", + "phpstan/phpstan": "^1.10", + "phpunit/phpunit": "^9.5.11|^10.0", + "sabre/dav": "^4.6.0" + }, + "type": "library", + "autoload": { + "psr-4": { + "League\\Flysystem\\": "src" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "Frank de Jonge", + "email": "info@frankdejonge.nl" + } + ], + "description": "File storage abstraction for PHP", + "keywords": [ + "WebDAV", + "aws", + "cloud", + "file", + "files", + "filesystem", + "filesystems", + "ftp", + "s3", + "sftp", + "storage" + ], + "support": { + "issues": "https://github.com/thephpleague/flysystem/issues", + "source": "https://github.com/thephpleague/flysystem/tree/3.36.0" + }, + "time": "2026-09-02T08:00:27+00:00", + "published-time": "2026-09-02T08:01:40+00:00" + }, + { + "name": "league/flysystem-local", + "version": "3.35.3", + "source": { + "type": "git", + "url": "https://github.com/thephpleague/flysystem-local.git", + "reference": "a099b24dce160f3b2239043d13d47c4a1a214ea4" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/thephpleague/flysystem-local/zipball/a099b24dce160f3b2239043d13d47c4a1a214ea4", + "reference": "a099b24dce160f3b2239043d13d47c4a1a214ea4", + "shasum": "" + }, + "require": { + "ext-fileinfo": "*", + "league/flysystem": "^3.0.0", + "league/mime-type-detection": "^1.0.0", + "php": "^8.0.2" + }, + "type": "library", + "autoload": { + "psr-4": { + "League\\Flysystem\\Local\\": "" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "Frank de Jonge", + "email": "info@frankdejonge.nl" + } + ], + "description": "Local filesystem adapter for Flysystem.", + "keywords": [ + "Flysystem", + "file", + "files", + "filesystem", + "local" + ], + "support": { + "source": "https://github.com/thephpleague/flysystem-local/tree/3.35.3" + }, + "time": "2026-08-12T13:29:21+00:00", + "published-time": "2026-08-22T12:57:18+00:00" + }, + { + "name": "league/mime-type-detection", + "version": "1.17.0", + "source": { + "type": "git", + "url": "https://github.com/thephpleague/mime-type-detection.git", + "reference": "f5f47eff7c48ed1003069a2ca67f316fb4021c76" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/thephpleague/mime-type-detection/zipball/f5f47eff7c48ed1003069a2ca67f316fb4021c76", + "reference": "f5f47eff7c48ed1003069a2ca67f316fb4021c76", + "shasum": "" + }, + "require": { + "ext-fileinfo": "*", + "php": "^7.4 || ^8.0" + }, + "require-dev": { + "friendsofphp/php-cs-fixer": "^3.2", + "phpstan/phpstan": "^0.12.68", + "phpunit/phpunit": "^8.5.8 || ^9.3 || ^10.0 || ^11.0 || ^12.0" + }, + "type": "library", + "autoload": { + "psr-4": { + "League\\MimeTypeDetection\\": "src" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "Frank de Jonge", + "email": "info@frankdejonge.nl" + } + ], + "description": "Mime-type detection for Flysystem", + "support": { + "issues": "https://github.com/thephpleague/mime-type-detection/issues", + "source": "https://github.com/thephpleague/mime-type-detection/tree/1.17.0" + }, + "funding": [ + { + "url": "https://github.com/frankdejonge", + "type": "github" + }, + { + "url": "https://tidelift.com/funding/github/packagist/league/flysystem", + "type": "tidelift" + } + ], + "time": "2026-07-09T11:49:27+00:00", + "published-time": "2026-07-09T11:50:09+00:00" + }, + { + "name": "league/uri", + "version": "7.10.0", + "source": { + "type": "git", + "url": "https://github.com/thephpleague/uri.git", + "reference": "be89e2382e37acdef232259071ade5180821397b" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/thephpleague/uri/zipball/be89e2382e37acdef232259071ade5180821397b", + "reference": "be89e2382e37acdef232259071ade5180821397b", + "shasum": "" + }, + "require": { + "ext-mbstring": "*", + "league/uri-interfaces": "^7.10.0", + "php": "^8.1", + "psr/http-factory": "^1" + }, + "conflict": { + "league/uri-schemes": "^1.0" + }, + "suggest": { + "ext-bcmath": "to improve IPV4 host parsing", + "ext-dom": "to convert the URI into an HTML anchor tag", + "ext-fileinfo": "to create Data URI from file contennts", + "ext-gmp": "to improve IPV4 host parsing", + "ext-intl": "to handle IDN host with the best performance", + "ext-uri": "to use the PHP native URI class", + "jeremykendall/php-domain-parser": "to further parse the URI host and resolve its Public Suffix and Top Level Domain", + "league/uri-components": "to provide additional tools to manipulate URI objects components", + "league/uri-polyfill": "to backport the PHP URI extension for older versions of PHP", + "php-64bit": "to improve IPV4 host parsing", + "rowbot/url": "to handle URLs using the WHATWG URL Living Standard specification", + "symfony/polyfill-intl-idn": "to handle IDN host via the Symfony polyfill if ext-intl is not present" + }, + "type": "library", + "extra": { + "branch-alias": { + "dev-master": "7.x-dev" + } + }, + "autoload": { + "psr-4": { + "League\\Uri\\": "" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "Ignace Nyamagana Butera", + "email": "nyamsprod@gmail.com", + "homepage": "https://nyamsprod.com" + } + ], + "description": "URI manipulation library", + "homepage": "https://uri.thephpleague.com", + "keywords": [ + "URN", + "data-uri", + "file-uri", + "ftp", + "hostname", + "http", + "https", + "middleware", + "parse_str", + "parse_url", + "psr-7", + "query-string", + "querystring", + "rfc2141", + "rfc3986", + "rfc3987", + "rfc6570", + "rfc8141", + "uri", + "uri-template", + "url", + "ws" + ], + "support": { + "docs": "https://uri.thephpleague.com", + "forum": "https://thephpleague.slack.com", + "issues": "https://github.com/thephpleague/uri-src/issues", + "source": "https://github.com/thephpleague/uri/tree/7.10.0" + }, + "funding": [ + { + "url": "https://github.com/sponsors/nyamsprod", + "type": "github" + } + ], + "time": "2026-11-04T12:45:07+00:00", + "published-time": "2026-11-04T13:02:21+00:00" + }, + { + "name": "league/uri-components", + "version": "7.10.0", + "source": { + "type": "git", + "url": "https://github.com/thephpleague/uri-components.git", + "reference": "2a790e66948d3504a2f2cd42b80d4b8874601540" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/thephpleague/uri-components/zipball/2a790e66948d3504a2f2cd42b80d4b8874601540", + "reference": "2a790e66948d3504a2f2cd42b80d4b8874601540", + "shasum": "" + }, + "require": { + "league/uri": "^7.10.0", + "php": "^8.1" + }, + "suggest": { + "ext-bcmath": "to improve IPV4 host parsing", + "ext-fileinfo": "to create Data URI from file contennts", + "ext-gmp": "to improve IPV4 host parsing", + "ext-intl": "to handle IDN host with the best performance", + "ext-mbstring": "to use the sorting algorithm for Query parameter", + "jeremykendall/php-domain-parser": "to further parse the URI host and resolve its Public Suffix and Top Level Domain", + "league/uri-polyfill": "to backport the PHP URI extension for older versions of PHP", + "php-64bit": "to improve IPV4 host parsing", + "rowbot/url": "to handle URLs using the WHATWG URL Living Standard specification", + "symfony/polyfill-intl-idn": "to handle IDN host via the Symfony polyfill if ext-intl is not present", + "symfony/polyfill-mbstring": "to handle query sorting if ext-mbstring is not present" + }, + "type": "library", + "extra": { + "branch-alias": { + "dev-master": "7.x-dev" + } + }, + "autoload": { + "psr-4": { + "League\\Uri\\": "" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "Ignace Nyamagana Butera", + "email": "nyamsprod@gmail.com", + "homepage": "https://nyamsprod.com" + } + ], + "description": "URI components manipulation library", + "homepage": "http://uri.thephpleague.com", + "keywords": [ + "authority", + "components", + "fragment", + "host", + "middleware", + "modifier", + "path", + "port", + "query", + "rfc3986", + "scheme", + "uri", + "url", + "userinfo" + ], + "support": { + "docs": "https://uri.thephpleague.com", + "forum": "https://thephpleague.slack.com", + "issues": "https://github.com/thephpleague/uri-src/issues", + "source": "https://github.com/thephpleague/uri-components/tree/7.10.0" + }, + "funding": [ + { + "url": "https://github.com/nyamsprod", + "type": "github" + } + ], + "time": "2026-11-04T12:45:07+00:00", + "published-time": "2026-11-04T13:02:25+00:00" + }, + { + "name": "league/uri-interfaces", + "version": "7.10.0", + "source": { + "type": "git", + "url": "https://github.com/thephpleague/uri-interfaces.git", + "reference": "ea66240cff4ae9a56ce85d577a04d038b771e51c" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/thephpleague/uri-interfaces/zipball/ea66240cff4ae9a56ce85d577a04d038b771e51c", + "reference": "ea66240cff4ae9a56ce85d577a04d038b771e51c", + "shasum": "" + }, + "require": { + "ext-filter": "*", + "php": "^8.1", + "psr/http-message": "^1.1 || ^2.0" + }, + "suggest": { + "ext-bcmath": "to improve IPV4 host parsing", + "ext-gmp": "to improve IPV4 host parsing", + "ext-intl": "to handle IDN host with the best performance", + "php-64bit": "to improve IPV4 host parsing", + "rowbot/url": "to handle URLs using the WHATWG URL Living Standard specification", + "symfony/polyfill-intl-idn": "to handle IDN host via the Symfony polyfill if ext-intl is not present" + }, + "type": "library", + "extra": { + "branch-alias": { + "dev-master": "7.x-dev" + } + }, + "autoload": { + "psr-4": { + "League\\Uri\\": "" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "Ignace Nyamagana Butera", + "email": "nyamsprod@gmail.com", + "homepage": "https://nyamsprod.com" + } + ], + "description": "Common tools for parsing and resolving RFC3987/RFC3986 URI", + "homepage": "https://uri.thephpleague.com", + "keywords": [ + "data-uri", + "file-uri", + "ftp", + "hostname", + "http", + "https", + "parse_str", + "parse_url", + "psr-7", + "query-string", + "querystring", + "rfc3986", + "rfc3987", + "rfc6570", + "uri", + "url", + "ws" + ], + "support": { + "docs": "https://uri.thephpleague.com", + "forum": "https://thephpleague.slack.com", + "issues": "https://github.com/thephpleague/uri-src/issues", + "source": "https://github.com/thephpleague/uri-interfaces/tree/7.10.0" + }, + "funding": [ + { + "url": "https://github.com/sponsors/nyamsprod", + "type": "github" + } + ], + "time": "2026-11-04T12:45:07+00:00", + "published-time": "2026-11-04T13:02:27+00:00" + }, + { + "name": "livewire/livewire", + "version": "v4.4.8", + "source": { + "type": "git", + "url": "https://github.com/livewire/livewire.git", + "reference": "8d7f8fc6138274a2f3384c9db354ca012215a259" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/livewire/livewire/zipball/8d7f8fc6138274a2f3384c9db354ca012215a259", + "reference": "8d7f8fc6138274a2f3384c9db354ca012215a259", + "shasum": "" + }, + "require": { + "illuminate/database": "^10.0|^11.0|^12.0|^13.0", + "illuminate/routing": "^10.0|^11.0|^12.0|^13.0", + "illuminate/support": "^10.0|^11.0|^12.0|^13.0", + "illuminate/validation": "^10.0|^11.0|^12.0|^13.0", + "laravel/prompts": "^0.1.24|^0.2|^0.3", + "league/mime-type-detection": "^1.9", + "php": "^8.1", + "symfony/console": "^6.0|^7.0|^8.0", + "symfony/http-kernel": "^6.2|^7.0|^8.0" + }, + "require-dev": { + "calebporzio/sushi": "^2.1", + "laravel/framework": "^10.15.0|^11.0|^12.0|^13.0", + "mockery/mockery": "^1.3.1", + "orchestra/testbench": "^8.21.0|^9.0|^10.0|^11.0", + "orchestra/testbench-dusk": "^8.24|^9.1|^10.0|^11.0", + "phpunit/phpunit": "^10.4|^11.5|^12.5", + "psy/psysh": "^0.11.22|^0.12" + }, + "type": "library", + "extra": { + "laravel": { + "aliases": { + "Livewire": "Livewire\\Livewire" + }, + "providers": [ + "Livewire\\LivewireServiceProvider" + ] + } + }, + "autoload": { + "files": [ + "src/helpers.php" + ], + "psr-4": { + "Livewire\\": "src/" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "Caleb Porzio", + "email": "calebporzio@gmail.com" + } + ], + "description": "A front-end framework for Laravel.", + "support": { + "issues": "https://github.com/livewire/livewire/issues", + "source": "https://github.com/livewire/livewire/tree/v4.4.8" + }, + "funding": [ + { + "url": "https://github.com/livewire", + "type": "github" + } + ], + "time": "2026-10-21T12:53:46+00:00", + "published-time": "2026-10-21T14:02:22+00:00" + }, + { + "name": "monolog/monolog", + "version": "3.12.1", + "source": { + "type": "git", + "url": "https://github.com/Seldaek/monolog.git", + "reference": "d7059e4c691d05ea1222b5124bed0f961be46e15" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/Seldaek/monolog/zipball/d7059e4c691d05ea1222b5124bed0f961be46e15", + "reference": "d7059e4c691d05ea1222b5124bed0f961be46e15", + "shasum": "" + }, + "require": { + "php": ">=8.1", + "psr/log": "^2.0 || ^3.0" + }, + "provide": { + "psr/log-implementation": "3.0.0" + }, + "require-dev": { + "aws/aws-sdk-php": "^3.0", + "doctrine/couchdb": "~1.0@dev", + "elasticsearch/elasticsearch": "^7 || ^8", + "ext-json": "*", + "graylog2/gelf-php": "^1.4.2 || ^2.0", + "guzzlehttp/guzzle": "^7.4.5", + "guzzlehttp/psr7": "^2.2", + "mongodb/mongodb": "^1.8 || ^2.0", + "php-amqplib/php-amqplib": "~2.4 || ^3", + "php-console/php-console": "^3.1.8", + "phpstan/phpstan": "^2", + "phpstan/phpstan-deprecation-rules": "^2", + "phpstan/phpstan-strict-rules": "^2", + "phpunit/phpunit": "^10.5.17 || ^11.0.7", + "predis/predis": "^1.1 || ^2", + "psr/clock": "^1.0", + "rollbar/rollbar": "^4.0", + "ruflin/elastica": "^7 || ^8", + "symfony/mailer": "^5.4 || ^6", + "symfony/mime": "^5.4 || ^6" + }, + "suggest": { + "aws/aws-sdk-php": "Allow sending log messages to AWS services like DynamoDB", + "doctrine/couchdb": "Allow sending log messages to a CouchDB server", + "elasticsearch/elasticsearch": "Allow sending log messages to an Elasticsearch server via official client", + "ext-amqp": "Allow sending log messages to an AMQP server (1.0+ required)", + "ext-curl": "Required to send log messages using the IFTTTHandler, the LogglyHandler, the SendGridHandler, the SlackWebhookHandler or the TelegramBotHandler", + "ext-mbstring": "Allow to work properly with unicode symbols", + "ext-mongodb": "Allow sending log messages to a MongoDB server (via driver)", + "ext-openssl": "Required to send log messages using SSL", + "ext-sockets": "Allow sending log messages to a Syslog server (via UDP driver)", + "graylog2/gelf-php": "Allow sending log messages to a GrayLog2 server", + "mongodb/mongodb": "Allow sending log messages to a MongoDB server (via library)", + "php-amqplib/php-amqplib": "Allow sending log messages to an AMQP server using php-amqplib", + "psr/clock": "Required to pass a clock to the Logger and control the timestamp of log records", + "rollbar/rollbar": "Allow sending log messages to Rollbar", + "ruflin/elastica": "Allow sending log messages to an Elastic Search server" + }, + "type": "library", + "extra": { + "branch-alias": { + "dev-main": "3.x-dev" + } + }, + "autoload": { + "psr-4": { + "Monolog\\": "src/Monolog" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "Jordi Boggiano", + "email": "j.boggiano@seld.be", + "homepage": "https://seld.be" + } + ], + "description": "Sends your logs to files, sockets, inboxes, databases and various web services", + "homepage": "https://github.com/Seldaek/monolog", + "keywords": [ + "log", + "logging", + "psr-3" + ], + "support": { + "issues": "https://github.com/Seldaek/monolog/issues", + "source": "https://github.com/Seldaek/monolog/tree/3.12.1" + }, + "funding": [ + { + "url": "https://github.com/Seldaek", + "type": "github" + }, + { + "url": "https://tidelift.com/funding/github/packagist/monolog/monolog", + "type": "tidelift" + } + ], + "time": "2026-09-29T19:21:12+00:00", + "published-time": "2026-09-29T19:21:44+00:00" + }, + { + "name": "nesbot/carbon", + "version": "3.15.1", + "source": { + "type": "git", + "url": "https://github.com/CarbonPHP/carbon.git", + "reference": "ce0e5636fae7d1e99856eb70cae4c719a284aa08" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/CarbonPHP/carbon/zipball/ce0e5636fae7d1e99856eb70cae4c719a284aa08", + "reference": "ce0e5636fae7d1e99856eb70cae4c719a284aa08", + "shasum": "" + }, + "require": { + "carbonphp/carbon-doctrine-types": "<100.0", + "ext-json": "*", + "php": "^8.1", + "psr/clock": "^1.0", + "symfony/clock": "^6.3.12 || ^7.0 || ^8.0", + "symfony/polyfill-mbstring": "^1.0", + "symfony/polyfill-time": "^1.0", + "symfony/translation": "^4.4.18 || ^5.2.1 || ^6.0 || ^7.0 || ^8.0" + }, + "provide": { + "psr/clock-implementation": "1.0" + }, + "require-dev": { + "doctrine/dbal": "^3.6.3 || ^4.0", + "doctrine/orm": "^2.15.2 || ^3.0", + "friendsofphp/php-cs-fixer": "^v3.87.1", + "kylekatarnls/multi-tester": "^2.5.3", + "phpmd/phpmd": "^3.0@dev", + "phpstan/extension-installer": "^1.4.3", + "phpstan/phpstan": "^2.1.22", + "phpunit/phpunit": "^10.5.53", + "squizlabs/php_codesniffer": "^3.13.4 || ^4.0.0" + }, + "bin": [ + "bin/carbon" + ], + "type": "library", + "extra": { + "laravel": { + "providers": [ + "Carbon\\Laravel\\ServiceProvider" + ] + }, + "phpstan": { + "includes": [ + "extension.neon" + ] + }, + "branch-alias": { + "dev-2.x": "2.x-dev", + "dev-master": "3.x-dev" + } + }, + "autoload": { + "psr-4": { + "Carbon\\": "src/Carbon/" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "Brian Nesbitt", + "email": "brian@nesbot.com", + "homepage": "https://markido.com" + }, + { + "name": "kylekatarnls", + "homepage": "https://github.com/kylekatarnls" + } + ], + "description": "An API extension for DateTime that supports 281 different languages.", + "homepage": "https://carbonphp.github.io/carbon/", + "keywords": [ + "date", + "datetime", + "time" + ], + "support": { + "docs": "https://carbonphp.github.io/carbon/guide/getting-started/introduction.html", + "issues": "https://github.com/CarbonPHP/carbon/issues", + "source": "https://github.com/CarbonPHP/carbon" + }, + "funding": [ + { + "url": "https://github.com/sponsors/kylekatarnls", + "type": "github" + }, + { + "url": "https://opencollective.com/Carbon#sponsor", + "type": "opencollective" + }, + { + "url": "https://tidelift.com/subscription/pkg/packagist-nesbot-carbon?utm_source=packagist-nesbot-carbon&utm_medium=referral&utm_campaign=readme", + "type": "tidelift" + } + ], + "time": "2026-10-25T14:32:48+00:00", + "published-time": "2026-10-25T14:41:05+00:00" + }, + { + "name": "nette/php-generator", + "version": "v4.2.4", + "source": { + "type": "git", + "url": "https://github.com/nette/php-generator.git", + "reference": "19818e4924f9620d016b874e5b7518e78dbb3b24" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/nette/php-generator/zipball/19818e4924f9620d016b874e5b7518e78dbb3b24", + "reference": "19818e4924f9620d016b874e5b7518e78dbb3b24", + "shasum": "" + }, + "require": { + "nette/utils": "^4.0.6", + "php": "8.1 - 8.6" + }, + "require-dev": { + "jetbrains/phpstorm-attributes": "^1.2", + "nette/phpstan-rules": "^1.0", + "nette/tester": "^2.6", + "nikic/php-parser": "^5.0", + "phpstan/extension-installer": "^1.4@stable", + "phpstan/phpstan": "^2.1.40@stable", + "tracy/tracy": "^2.8" + }, + "suggest": { + "nikic/php-parser": "to use ClassType::from(withBodies: true) & ClassType::fromCode()" + }, + "type": "library", + "extra": { + "branch-alias": { + "dev-master": "4.2-dev" + } + }, + "autoload": { + "psr-4": { + "Nette\\": "src" + }, + "classmap": [ + "src/" + ] + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "BSD-3-Clause", + "GPL-2.0-only", + "GPL-3.0-only" + ], + "authors": [ + { + "name": "David Grudl", + "homepage": "https://davidgrudl.com" + } + ], + "description": "🐘 Nette PHP Generator: generates PHP code from objects. Classes, enums, functions and whole files, with namespaces resolved for you, and always up to date with the latest PHP.", + "homepage": "https://doc.nette.org/php-generator", + "keywords": [ + "code generation", + "code generator", + "codegen", + "nette", + "scaffolding" + ], + "support": { + "issues": "https://github.com/nette/php-generator/issues", + "source": "https://github.com/nette/php-generator/tree/v4.2.4" + }, + "time": "2026-10-26T22:16:39+00:00", + "published-time": "2026-10-26T22:17:59+00:00" + }, + { + "name": "nette/schema", + "version": "v1.4.0", + "source": { + "type": "git", + "url": "https://github.com/nette/schema.git", + "reference": "af9fa8a86bfca9b02b10346220db26e62ef942ec" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/nette/schema/zipball/af9fa8a86bfca9b02b10346220db26e62ef942ec", + "reference": "af9fa8a86bfca9b02b10346220db26e62ef942ec", + "shasum": "" + }, + "require": { + "nette/utils": "^4.0", + "php": "8.1 - 8.6" + }, + "require-dev": { + "nette/phpstan-rules": "^1.0.7", + "nette/tester": "^2.6", + "phpstan/extension-installer": "^1.4@stable", + "phpstan/phpstan": "^2.3@stable", + "tracy/tracy": "^2.8" + }, + "type": "library", + "extra": { + "branch-alias": { + "dev-master": "1.4-dev" + } + }, + "autoload": { + "psr-4": { + "Nette\\": "src" + }, + "classmap": [ + "src/" + ] + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "BSD-3-Clause", + "GPL-2.0-only", + "GPL-3.0-only" + ], + "authors": [ + { + "name": "David Grudl", + "homepage": "https://davidgrudl.com" + } + ], + "description": "📐 Nette Schema: validates and normalizes data such as configuration or API input against a schema described in a few readable lines of PHP, with precise error messages.", + "homepage": "https://doc.nette.org/schema", + "keywords": [ + "configuration", + "data validation", + "nette", + "normalization", + "schema", + "validation" + ], + "support": { + "issues": "https://github.com/nette/schema/issues", + "source": "https://github.com/nette/schema/tree/v1.4.0" + }, + "time": "2026-10-22T02:12:50+00:00", + "published-time": "2026-10-22T02:14:45+00:00" + }, + { + "name": "nette/utils", + "version": "v4.1.6", + "source": { + "type": "git", + "url": "https://github.com/nette/utils.git", + "reference": "6bf24518accf32cf845bca305e0b92078700fd01" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/nette/utils/zipball/6bf24518accf32cf845bca305e0b92078700fd01", + "reference": "6bf24518accf32cf845bca305e0b92078700fd01", + "shasum": "" + }, + "require": { + "php": "8.2 - 8.6" + }, + "conflict": { + "nette/finder": "<3", + "nette/schema": "<1.2.2" + }, + "require-dev": { + "jetbrains/phpstorm-attributes": "^1.2", + "nette/phpstan-rules": "^1.0", + "nette/tester": "^2.5", + "phpstan/extension-installer": "^1.4@stable", + "phpstan/phpstan": "^2.1@stable", + "tracy/tracy": "^2.9" + }, + "suggest": { + "ext-gd": "to use Image", + "ext-iconv": "to use Strings::chr(), ord() and reverse()", + "ext-intl": "to use Strings::webalize(), toAscii(), normalize() and compare()", + "ext-json": "to use Nette\\Utils\\Json", + "ext-mbstring": "to use Strings::lower() etc...", + "ext-tokenizer": "to use Nette\\Utils\\Reflection::getUseStatements()" + }, + "type": "library", + "extra": { + "branch-alias": { + "dev-master": "4.1-dev" + } + }, + "autoload": { + "psr-4": { + "Nette\\": "src" + }, + "classmap": [ + "src/" + ] + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "BSD-3-Clause", + "GPL-2.0-only", + "GPL-3.0-only" + ], + "authors": [ + { + "name": "David Grudl", + "homepage": "https://davidgrudl.com" + }, + { + "name": "Nette Community", + "homepage": "https://nette.org/contributors" + } + ], + "description": "🛠 Nette Utils: lightweight utilities for string & array manipulation, image handling, safe JSON encoding/decoding, validation, slug or strong password generating etc.", + "homepage": "https://nette.org", + "keywords": [ + "array", + "core", + "datetime", + "images", + "json", + "nette", + "paginator", + "password", + "slugify", + "string", + "unicode", + "utf-8", + "utility", + "validation" + ], + "support": { + "issues": "https://github.com/nette/utils/issues", + "source": "https://github.com/nette/utils/tree/v4.1.6" + }, + "time": "2026-10-20T17:07:56+00:00", + "published-time": "2026-10-20T17:48:30+00:00" + }, + { + "name": "nikic/php-parser", + "version": "v5.9.0", + "source": { + "type": "git", + "url": "https://github.com/nikic/PHP-Parser.git", + "reference": "9e33da9553fe7786f0962b35f4e4ecf01be89def" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/nikic/PHP-Parser/zipball/9e33da9553fe7786f0962b35f4e4ecf01be89def", + "reference": "9e33da9553fe7786f0962b35f4e4ecf01be89def", + "shasum": "" + }, + "require": { + "ext-json": "*", + "ext-tokenizer": "*", + "php": ">=7.4" + }, + "require-dev": { + "ircmaxell/php-yacc": "^0.0.7", + "phpunit/phpunit": "^9.0" + }, + "bin": [ + "bin/php-parse" + ], + "type": "library", + "extra": { + "branch-alias": { + "dev-master": "5.x-dev" + } + }, + "autoload": { + "psr-4": { + "PhpParser\\": "lib/PhpParser" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "BSD-3-Clause" + ], + "authors": [ + { + "name": "Nikita Popov" + } + ], + "description": "A PHP parser written in PHP", + "keywords": [ + "parser", + "php" + ], + "support": { + "issues": "https://github.com/nikic/PHP-Parser/issues", + "source": "https://github.com/nikic/PHP-Parser/tree/v5.9.0" + }, + "time": "2026-09-13T18:51:52+00:00", + "published-time": "2026-09-13T18:53:16+00:00" + }, + { + "name": "nunomaduro/termwind", + "version": "v2.4.1", + "source": { + "type": "git", + "url": "https://github.com/nunomaduro/termwind.git", + "reference": "9b85ae4d802403bfc004ea633ce542bc262ee5c3" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/nunomaduro/termwind/zipball/9b85ae4d802403bfc004ea633ce542bc262ee5c3", + "reference": "9b85ae4d802403bfc004ea633ce542bc262ee5c3", + "shasum": "" + }, + "require": { + "ext-mbstring": "*", + "php": "^8.2", + "symfony/console": "^7.4.23 || ^8.1.11" + }, + "require-dev": { + "illuminate/console": "^11.51 || ^12.70 || ^13.40", + "laravel/pint": "^1.30.4", + "mockery/mockery": "^1.6.15", + "pestphp/pest": "^2.36.1 || ^3.8.7 || ^4.7.8 || ^5.3.5", + "phpstan/phpstan": "^1.12.34", + "phpstan/phpstan-strict-rules": "^1.6.2", + "symfony/var-dumper": "^7.4.22 || ^8.1.10", + "thecodingmachine/phpstan-strict-rules": "^1.0.0" + }, + "type": "library", + "extra": { + "laravel": { + "providers": [ + "Termwind\\Laravel\\TermwindServiceProvider" + ] + }, + "branch-alias": { + "dev-2.x": "2.x-dev" + } + }, + "autoload": { + "files": [ + "src/Functions.php" + ], + "psr-4": { + "Termwind\\": "src/" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "Nuno Maduro", + "email": "enunomaduro@gmail.com" + } + ], + "description": "It's like Tailwind CSS, but for the console.", + "keywords": [ + "cli", + "console", + "css", + "package", + "php", + "style" + ], + "support": { + "issues": "https://github.com/nunomaduro/termwind/issues", + "source": "https://github.com/nunomaduro/termwind/tree/v2.4.1" + }, + "funding": [ + { + "url": "https://www.paypal.com/paypalme/enunomaduro", + "type": "custom" + }, + { + "url": "https://github.com/nunomaduro", + "type": "github" + }, + { + "url": "https://github.com/xiCO2k", + "type": "github" + } + ], + "time": "2026-11-07T03:57:16+00:00", + "published-time": "2026-11-07T04:01:24+00:00" + }, + { + "name": "openspout/openspout", + "version": "v4.32.0", + "source": { + "type": "git", + "url": "https://github.com/openspout/openspout.git", + "reference": "41f045c1f632e1474e15d4c7bc3abcb4a153563d" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/openspout/openspout/zipball/41f045c1f632e1474e15d4c7bc3abcb4a153563d", + "reference": "41f045c1f632e1474e15d4c7bc3abcb4a153563d", + "shasum": "" + }, + "require": { + "ext-dom": "*", + "ext-fileinfo": "*", + "ext-filter": "*", + "ext-libxml": "*", + "ext-xmlreader": "*", + "ext-zip": "*", + "php": "~8.3.0 || ~8.4.0 || ~8.5.0" + }, + "require-dev": { + "ext-zlib": "*", + "friendsofphp/php-cs-fixer": "^3.86.0", + "infection/infection": "^0.31.2", + "phpbench/phpbench": "^1.4.1", + "phpstan/phpstan": "^2.1.22", + "phpstan/phpstan-phpunit": "^2.0.7", + "phpstan/phpstan-strict-rules": "^2.0.6", + "phpunit/phpunit": "^12.3.7" + }, + "suggest": { + "ext-iconv": "To handle non UTF-8 CSV files (if \"php-mbstring\" is not already installed or is too limited)", + "ext-mbstring": "To handle non UTF-8 CSV files (if \"iconv\" is not already installed)" + }, + "type": "library", + "extra": { + "branch-alias": { + "dev-master": "3.3.x-dev" + } + }, + "autoload": { + "psr-4": { + "OpenSpout\\": "src/" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "Adrien Loison", + "email": "adrien@box.com" + } + ], + "description": "PHP Library to read and write spreadsheet files (CSV, XLSX and ODS), in a fast and scalable way", + "homepage": "https://github.com/openspout/openspout", + "keywords": [ + "OOXML", + "csv", + "excel", + "memory", + "odf", + "ods", + "office", + "open", + "php", + "read", + "scale", + "spreadsheet", + "stream", + "write", + "xlsx" + ], + "support": { + "issues": "https://github.com/openspout/openspout/issues", + "source": "https://github.com/openspout/openspout/tree/v4.32.0" + }, + "funding": [ + { + "url": "https://paypal.me/filippotessarotto", + "type": "custom" + }, + { + "url": "https://github.com/Slamdunk", + "type": "github" + } + ], + "time": "2025-09-03T16:03:54+00:00", + "published-time": "2025-09-03T16:17:36+00:00" + }, + { + "name": "paragonie/constant_time_encoding", + "version": "v3.1.4", + "source": { + "type": "git", + "url": "https://github.com/paragonie/constant_time_encoding.git", + "reference": "5efef6e6cb43e088ccab7d0c1e2f2ab25b9e8b54" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/paragonie/constant_time_encoding/zipball/5efef6e6cb43e088ccab7d0c1e2f2ab25b9e8b54", + "reference": "5efef6e6cb43e088ccab7d0c1e2f2ab25b9e8b54", + "shasum": "" + }, + "require": { + "php": "^8" + }, + "require-dev": { + "infection/infection": "^0", + "nikic/php-fuzzer": "^0", + "phpunit/phpunit": "^9|^10|^11", + "vimeo/psalm": "^4|^5|^6" + }, + "type": "library", + "autoload": { + "psr-4": { + "ParagonIE\\ConstantTime\\": "src/" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "Paragon Initiative Enterprises", + "email": "security@paragonie.com", + "homepage": "https://paragonie.com", + "role": "Maintainer" + }, + { + "name": "Steve 'Sc00bz' Thomas", + "email": "steve@tobtu.com", + "homepage": "https://www.tobtu.com", + "role": "Original Developer" + } + ], + "description": "Constant-time Implementations of RFC 4648 Encoding (Base-64, Base-32, Base-16)", + "keywords": [ + "base16", + "base32", + "base32_decode", + "base32_encode", + "base64", + "base64_decode", + "base64_encode", + "bin2hex", + "encoding", + "hex", + "hex2bin", + "rfc4648" + ], + "support": { + "email": "info@paragonie.com", + "issues": "https://github.com/paragonie/constant_time_encoding/issues", + "source": "https://github.com/paragonie/constant_time_encoding" + }, + "time": "2026-11-06T20:31:19+00:00", + "published-time": "2026-11-06T20:39:39+00:00" + }, + { + "name": "phpoption/phpoption", + "version": "1.10.0", + "source": { + "type": "git", + "url": "https://github.com/schmittjoh/php-option.git", + "reference": "67b192b6a42ec03944b972d6e633ddec78ad2c6d" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/schmittjoh/php-option/zipball/67b192b6a42ec03944b972d6e633ddec78ad2c6d", + "reference": "67b192b6a42ec03944b972d6e633ddec78ad2c6d", + "shasum": "" + }, + "require": { + "php": "^7.2.5 || ^8.0" + }, + "require-dev": { + "bamarni/composer-bin-plugin": "^1.8.2", + "phpunit/phpunit": "^8.5.54 || ^9.6.36 || ^10.5.64 || ^11.5.56 || ^12.5.33" + }, + "type": "library", + "extra": { + "bamarni-bin": { + "bin-links": true, + "forward-command": false + }, + "branch-alias": { + "dev-master": "1.9-dev" + } + }, + "autoload": { + "psr-4": { + "PhpOption\\": "src/PhpOption/" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "Apache-2.0" + ], + "authors": [ + { + "name": "Johannes M. Schmitt", + "email": "schmittjoh@gmail.com", + "homepage": "https://github.com/schmittjoh" + }, + { + "name": "Graham Campbell", + "email": "hello@gjcampbell.co.uk", + "homepage": "https://github.com/GrahamCampbell" + } + ], + "description": "Option Type for PHP", + "keywords": [ + "language", + "option", + "php", + "type" + ], + "support": { + "issues": "https://github.com/schmittjoh/php-option/issues", + "source": "https://github.com/schmittjoh/php-option/tree/1.10.0" + }, + "funding": [ + { + "url": "https://github.com/GrahamCampbell", + "type": "github" + }, + { + "url": "https://tidelift.com/funding/github/packagist/phpoption/phpoption", + "type": "tidelift" + } + ], + "time": "2026-08-24T00:54:40+00:00", + "published-time": "2026-08-24T01:09:05+00:00" + }, + { + "name": "pragmarx/google2fa", + "version": "v9.1.0", + "source": { + "type": "git", + "url": "https://github.com/antonioribeiro/google2fa.git", + "reference": "f00bc788c555adfb6765c437ff3538e59cd88af1" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/antonioribeiro/google2fa/zipball/f00bc788c555adfb6765c437ff3538e59cd88af1", + "reference": "f00bc788c555adfb6765c437ff3538e59cd88af1", + "shasum": "" + }, + "require": { + "paragonie/constant_time_encoding": "^1.0|^2.0|^3.0", + "php": "^7.1|^8.0" + }, + "require-dev": { + "phpstan/phpstan": "^1.0|^2.0", + "phpstan/phpstan-phpunit": "^1.0|^2.0", + "phpunit/phpunit": "~9|~10|~11|~12|~13", + "psalm/plugin-phpunit": "^0.19|^0.20", + "vimeo/psalm": "^5.26|^6.13" + }, + "type": "library", + "autoload": { + "psr-4": { + "PragmaRX\\Google2FA\\": "src/" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "Antonio Carlos Ribeiro", + "email": "acr@antoniocarlosribeiro.com", + "role": "Creator & Designer" + } + ], + "description": "A One Time Password Authentication package, compatible with Google Authenticator.", + "keywords": [ + "2fa", + "Authentication", + "MFA", + "Two Factor Authentication", + "google-authenticator", + "google2fa", + "hotp", + "otp", + "rfc4226", + "rfc6238", + "totp" + ], + "support": { + "docs": "https://github.com/antonioribeiro/google2fa#readme", + "issues": "https://github.com/antonioribeiro/google2fa/issues", + "security": "https://github.com/antonioribeiro/google2fa/security/policy", + "source": "https://github.com/antonioribeiro/google2fa" + }, + "time": "2026-08-15T13:22:01+00:00", + "published-time": "2026-08-15T13:28:13+00:00" + }, + { + "name": "pragmarx/google2fa-qrcode", + "version": "v4.0.0", + "source": { + "type": "git", + "url": "https://github.com/antonioribeiro/google2fa-qrcode.git", + "reference": "16159f84fa0838c276f35d46de57fd90dfbb385c" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/antonioribeiro/google2fa-qrcode/zipball/16159f84fa0838c276f35d46de57fd90dfbb385c", + "reference": "16159f84fa0838c276f35d46de57fd90dfbb385c", + "shasum": "" + }, + "require": { + "php": "^8.1", + "pragmarx/google2fa": "^8.0|^9.0" + }, + "require-dev": { + "bacon/bacon-qr-code": "^2.0|^3.0", + "chillerlan/php-qrcode": "^5.0|^6.0", + "khanamiryan/qrcode-detector-decoder": "^1.0", + "phpstan/phpstan": "^2.0", + "phpunit/phpunit": "~9|~10|~11|~12|~13" + }, + "suggest": { + "bacon/bacon-qr-code": "For QR Code generation, requires imagick", + "chillerlan/php-qrcode": "For QR Code generation" + }, + "type": "library", + "extra": { + "component": "package", + "branch-alias": { + "dev-master": "1.0-dev" + } + }, + "autoload": { + "psr-4": { + "PragmaRX\\Google2FAQRCode\\": "src/", + "PragmaRX\\Google2FAQRCode\\Tests\\": "tests/" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "Antonio Carlos Ribeiro", + "email": "acr@antoniocarlosribeiro.com", + "role": "Creator & Designer" + } + ], + "description": "QR Code package for Google2FA", + "keywords": [ + "2fa", + "Authentication", + "Two Factor Authentication", + "google2fa", + "qr code", + "qrcode" + ], + "support": { + "issues": "https://github.com/antonioribeiro/google2fa-qrcode/issues", + "source": "https://github.com/antonioribeiro/google2fa-qrcode/tree/v4.0.0" + }, + "time": "2026-05-08T19:24:44+00:00", + "published-time": "2026-05-08T19:32:27+00:00" + }, + { + "name": "psr/clock", + "version": "1.0.0", + "source": { + "type": "git", + "url": "https://github.com/php-fig/clock.git", + "reference": "e41a24703d4560fd0acb709162f73b8adfc3aa0d" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/php-fig/clock/zipball/e41a24703d4560fd0acb709162f73b8adfc3aa0d", + "reference": "e41a24703d4560fd0acb709162f73b8adfc3aa0d", + "shasum": "" + }, + "require": { + "php": "^7.0 || ^8.0" + }, + "type": "library", + "autoload": { + "psr-4": { + "Psr\\Clock\\": "src/" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "PHP-FIG", + "homepage": "https://www.php-fig.org/" + } + ], + "description": "Common interface for reading the clock.", + "homepage": "https://github.com/php-fig/clock", + "keywords": [ + "clock", + "now", + "psr", + "psr-20", + "time" + ], + "support": { + "issues": "https://github.com/php-fig/clock/issues", + "source": "https://github.com/php-fig/clock/tree/1.0.0" + }, + "time": "2022-11-25T14:36:26+00:00", + "published-time": "2022-11-25T14:59:22+00:00" + }, + { + "name": "psr/container", + "version": "2.0.2", + "source": { + "type": "git", + "url": "https://github.com/php-fig/container.git", + "reference": "c71ecc56dfe541dbd90c5360474fbc405f8d5963" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/php-fig/container/zipball/c71ecc56dfe541dbd90c5360474fbc405f8d5963", + "reference": "c71ecc56dfe541dbd90c5360474fbc405f8d5963", + "shasum": "" + }, + "require": { + "php": ">=7.4.0" + }, + "type": "library", + "extra": { + "branch-alias": { + "dev-master": "2.0.x-dev" + } + }, + "autoload": { + "psr-4": { + "Psr\\Container\\": "src/" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "PHP-FIG", + "homepage": "https://www.php-fig.org/" + } + ], + "description": "Common Container Interface (PHP FIG PSR-11)", + "homepage": "https://github.com/php-fig/container", + "keywords": [ + "PSR-11", + "container", + "container-interface", + "container-interop", + "psr" + ], + "support": { + "issues": "https://github.com/php-fig/container/issues", + "source": "https://github.com/php-fig/container/tree/2.0.2" + }, + "time": "2021-11-05T16:47:00+00:00", + "published-time": "2021-11-05T16:53:27+00:00" + }, + { + "name": "psr/event-dispatcher", + "version": "1.0.0", + "source": { + "type": "git", + "url": "https://github.com/php-fig/event-dispatcher.git", + "reference": "dbefd12671e8a14ec7f180cab83036ed26714bb0" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/php-fig/event-dispatcher/zipball/dbefd12671e8a14ec7f180cab83036ed26714bb0", + "reference": "dbefd12671e8a14ec7f180cab83036ed26714bb0", + "shasum": "" + }, + "require": { + "php": ">=7.2.0" + }, + "type": "library", + "extra": { + "branch-alias": { + "dev-master": "1.0.x-dev" + } + }, + "autoload": { + "psr-4": { + "Psr\\EventDispatcher\\": "src/" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "PHP-FIG", + "homepage": "http://www.php-fig.org/" + } + ], + "description": "Standard interfaces for event handling.", + "keywords": [ + "events", + "psr", + "psr-14" + ], + "support": { + "issues": "https://github.com/php-fig/event-dispatcher/issues", + "source": "https://github.com/php-fig/event-dispatcher/tree/1.0.0" + }, + "time": "2019-01-08T18:20:26+00:00", + "published-time": "2019-03-25T15:31:44+00:00" + }, + { + "name": "psr/http-client", + "version": "1.0.3", + "source": { + "type": "git", + "url": "https://github.com/php-fig/http-client.git", + "reference": "bb5906edc1c324c9a05aa0873d40117941e5fa90" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/php-fig/http-client/zipball/bb5906edc1c324c9a05aa0873d40117941e5fa90", + "reference": "bb5906edc1c324c9a05aa0873d40117941e5fa90", + "shasum": "" + }, + "require": { + "php": "^7.0 || ^8.0", + "psr/http-message": "^1.0 || ^2.0" + }, + "type": "library", + "extra": { + "branch-alias": { + "dev-master": "1.0.x-dev" + } + }, + "autoload": { + "psr-4": { + "Psr\\Http\\Client\\": "src/" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "PHP-FIG", + "homepage": "https://www.php-fig.org/" + } + ], + "description": "Common interface for HTTP clients", + "homepage": "https://github.com/php-fig/http-client", + "keywords": [ + "http", + "http-client", + "psr", + "psr-18" + ], + "support": { + "source": "https://github.com/php-fig/http-client" + }, + "time": "2023-09-23T14:17:50+00:00", + "published-time": "2023-09-23T14:18:12+00:00" + }, + { + "name": "psr/http-factory", + "version": "1.1.0", + "source": { + "type": "git", + "url": "https://github.com/php-fig/http-factory.git", + "reference": "2b4765fddfe3b508ac62f829e852b1501d3f6e8a" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/php-fig/http-factory/zipball/2b4765fddfe3b508ac62f829e852b1501d3f6e8a", + "reference": "2b4765fddfe3b508ac62f829e852b1501d3f6e8a", + "shasum": "" + }, + "require": { + "php": ">=7.1", + "psr/http-message": "^1.0 || ^2.0" + }, + "type": "library", + "extra": { + "branch-alias": { + "dev-master": "1.0.x-dev" + } + }, + "autoload": { + "psr-4": { + "Psr\\Http\\Message\\": "src/" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "PHP-FIG", + "homepage": "https://www.php-fig.org/" + } + ], + "description": "PSR-17: Common interfaces for PSR-7 HTTP message factories", + "keywords": [ + "factory", + "http", + "message", + "psr", + "psr-17", + "psr-7", + "request", + "response" + ], + "support": { + "source": "https://github.com/php-fig/http-factory" + }, + "time": "2024-04-15T12:06:14+00:00", + "published-time": "2024-05-10T07:32:19+00:00" + }, + { + "name": "psr/http-message", + "version": "2.0", + "source": { + "type": "git", + "url": "https://github.com/php-fig/http-message.git", + "reference": "402d35bcb92c70c026d1a6a9883f06b2ead23d71" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/php-fig/http-message/zipball/402d35bcb92c70c026d1a6a9883f06b2ead23d71", + "reference": "402d35bcb92c70c026d1a6a9883f06b2ead23d71", + "shasum": "" + }, + "require": { + "php": "^7.2 || ^8.0" + }, + "type": "library", + "extra": { + "branch-alias": { + "dev-master": "2.0.x-dev" + } + }, + "autoload": { + "psr-4": { + "Psr\\Http\\Message\\": "src/" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "PHP-FIG", + "homepage": "https://www.php-fig.org/" + } + ], + "description": "Common interface for HTTP messages", + "homepage": "https://github.com/php-fig/http-message", + "keywords": [ + "http", + "http-message", + "psr", + "psr-7", + "request", + "response" + ], + "support": { + "source": "https://github.com/php-fig/http-message/tree/2.0" + }, + "time": "2023-04-04T09:54:51+00:00", + "published-time": "2023-04-04T09:55:35+00:00" + }, + { + "name": "psr/log", + "version": "3.0.2", + "source": { + "type": "git", + "url": "https://github.com/php-fig/log.git", + "reference": "f16e1d5863e37f8d8c2a01719f5b34baa2b714d3" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/php-fig/log/zipball/f16e1d5863e37f8d8c2a01719f5b34baa2b714d3", + "reference": "f16e1d5863e37f8d8c2a01719f5b34baa2b714d3", + "shasum": "" + }, + "require": { + "php": ">=8.0.0" + }, + "type": "library", + "extra": { + "branch-alias": { + "dev-master": "3.x-dev" + } + }, + "autoload": { + "psr-4": { + "Psr\\Log\\": "src" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "PHP-FIG", + "homepage": "https://www.php-fig.org/" + } + ], + "description": "Common interface for logging libraries", + "homepage": "https://github.com/php-fig/log", + "keywords": [ + "log", + "psr", + "psr-3" + ], + "support": { + "source": "https://github.com/php-fig/log/tree/3.0.2" + }, + "time": "2024-09-11T13:17:53+00:00", + "published-time": "2024-09-11T13:21:14+00:00" + }, + { + "name": "psr/simple-cache", + "version": "3.0.0", + "source": { + "type": "git", + "url": "https://github.com/php-fig/simple-cache.git", + "reference": "764e0b3939f5ca87cb904f570ef9be2d78a07865" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/php-fig/simple-cache/zipball/764e0b3939f5ca87cb904f570ef9be2d78a07865", + "reference": "764e0b3939f5ca87cb904f570ef9be2d78a07865", + "shasum": "" + }, + "require": { + "php": ">=8.0.0" + }, + "type": "library", + "extra": { + "branch-alias": { + "dev-master": "3.0.x-dev" + } + }, + "autoload": { + "psr-4": { + "Psr\\SimpleCache\\": "src/" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "PHP-FIG", + "homepage": "https://www.php-fig.org/" + } + ], + "description": "Common interfaces for simple caching", + "keywords": [ + "cache", + "caching", + "psr", + "psr-16", + "simple-cache" + ], + "support": { + "source": "https://github.com/php-fig/simple-cache/tree/3.0.0" + }, + "time": "2021-10-29T13:26:27+00:00", + "published-time": "2021-10-29T13:27:19+00:00" + }, + { + "name": "psy/psysh", + "version": "v0.12.24", + "source": { + "type": "git", + "url": "https://github.com/bobthecow/psysh.git", + "reference": "ca0fdcf8a7617afa3adfdf1b5fef573dffb69ca1" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/bobthecow/psysh/zipball/ca0fdcf8a7617afa3adfdf1b5fef573dffb69ca1", + "reference": "ca0fdcf8a7617afa3adfdf1b5fef573dffb69ca1", + "shasum": "" + }, + "require": { + "ext-json": "*", + "ext-tokenizer": "*", + "nikic/php-parser": "^5.0 || ^4.0", + "php": "^8.0 || ^7.4", + "symfony/console": "^8.0 || ^7.0 || ^6.0 || ^5.0 || ^4.0 || ^3.4", + "symfony/var-dumper": "^8.0 || ^7.0 || ^6.0 || ^5.0 || ^4.0 || ^3.4" + }, + "conflict": { + "symfony/console": "4.4.37 || 5.3.14 || 5.3.15 || 5.4.3 || 5.4.4 || 6.0.3 || 6.0.4" + }, + "require-dev": { + "bamarni/composer-bin-plugin": "^1.2", + "composer/class-map-generator": "^1.6" + }, + "suggest": { + "composer/class-map-generator": "Improved tab completion performance with better class discovery.", + "ext-pcntl": "Enabling the PCNTL extension makes PsySH a lot happier :)", + "ext-posix": "If you have PCNTL, you'll want the POSIX extension as well." + }, + "bin": [ + "bin/psysh" + ], + "type": "library", + "extra": { + "bamarni-bin": { + "bin-links": false, + "forward-command": false + }, + "branch-alias": { + "dev-main": "0.12.x-dev" + } + }, + "autoload": { + "files": [ + "src/functions.php" + ], + "psr-4": { + "Psy\\": "src/" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "Justin Hileman", + "email": "justin@justinhileman.info" + } + ], + "description": "An interactive shell for modern PHP.", + "homepage": "https://psysh.org", + "keywords": [ + "REPL", + "console", + "interactive", + "shell" + ], + "support": { + "issues": "https://github.com/bobthecow/psysh/issues", + "source": "https://github.com/bobthecow/psysh/tree/v0.12.24" + }, + "time": "2026-06-29T15:41:09+00:00", + "published-time": "2026-06-29T15:41:53+00:00" + }, + { + "name": "ramsey/collection", + "version": "2.1.1", + "source": { + "type": "git", + "url": "https://github.com/ramsey/collection.git", + "reference": "344572933ad0181accbf4ba763e85a0306a8c5e2" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/ramsey/collection/zipball/344572933ad0181accbf4ba763e85a0306a8c5e2", + "reference": "344572933ad0181accbf4ba763e85a0306a8c5e2", + "shasum": "" + }, + "require": { + "php": "^8.1" + }, + "require-dev": { + "captainhook/plugin-composer": "^5.3", + "ergebnis/composer-normalize": "^2.45", + "fakerphp/faker": "^1.24", + "hamcrest/hamcrest-php": "^2.0", + "jangregor/phpstan-prophecy": "^2.1", + "mockery/mockery": "^1.6", + "php-parallel-lint/php-console-highlighter": "^1.0", + "php-parallel-lint/php-parallel-lint": "^1.4", + "phpspec/prophecy-phpunit": "^2.3", + "phpstan/extension-installer": "^1.4", + "phpstan/phpstan": "^2.1", + "phpstan/phpstan-mockery": "^2.0", + "phpstan/phpstan-phpunit": "^2.0", + "phpunit/phpunit": "^10.5", + "ramsey/coding-standard": "^2.3", + "ramsey/conventional-commits": "^1.6", + "roave/security-advisories": "dev-latest" + }, + "type": "library", + "extra": { + "captainhook": { + "force-install": true + }, + "ramsey/conventional-commits": { + "configFile": "conventional-commits.json" + } + }, + "autoload": { + "psr-4": { + "Ramsey\\Collection\\": "src/" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "Ben Ramsey", + "email": "ben@benramsey.com", + "homepage": "https://benramsey.com" + } + ], + "description": "A PHP library for representing and manipulating collections.", + "keywords": [ + "array", + "collection", + "hash", + "map", + "queue", + "set" + ], + "support": { + "issues": "https://github.com/ramsey/collection/issues", + "source": "https://github.com/ramsey/collection/tree/2.1.1" + }, + "time": "2025-03-22T05:38:12+00:00", + "published-time": "2025-03-22T05:39:22+00:00" + }, + { + "name": "ramsey/uuid", + "version": "4.10.0", + "source": { + "type": "git", + "url": "https://github.com/ramsey/uuid.git", + "reference": "f9aa3efc8015fcbc013d84d699583b268ccb593a" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/ramsey/uuid/zipball/f9aa3efc8015fcbc013d84d699583b268ccb593a", + "reference": "f9aa3efc8015fcbc013d84d699583b268ccb593a", + "shasum": "" + }, + "require": { + "brick/math": "^0.8.16 || ^0.9 || ^0.10 || ^0.11 || ^0.12 || ^0.13 || ^0.14 || ^0.15 || ^0.16 || ^0.17 || ^0.18 || ^0.19 || ^0.20 || ^1.0", + "php": "^8.0", + "ramsey/collection": "^1.2 || ^2.0" + }, + "replace": { + "rhumsaa/uuid": "self.version" + }, + "require-dev": { + "captainhook/captainhook": "^5.29.3", + "captainhook/plugin-composer": "^5.3.3", + "dealerdirect/phpcodesniffer-composer-installer": "^1.2.1", + "mockery/mockery": "^1.6.15", + "paragonie/random-lib": "^2.0.3", + "php-mock/php-mock": "^2.7.0", + "php-mock/php-mock-mockery": "^1.5.0", + "php-parallel-lint/php-parallel-lint": "^1.4.0", + "phpbench/phpbench": "^1.2.14", + "phpstan/extension-installer": "^1.4.3", + "phpstan/phpstan": "^2.3.5", + "phpstan/phpstan-mockery": "^2.0.0", + "phpstan/phpstan-phpunit": "^2.1.2", + "phpunit/phpunit": "^9.6.39", + "slevomat/coding-standard": "^8.31.3", + "squizlabs/php_codesniffer": "^4.0.4" + }, + "suggest": { + "ext-bcmath": "Enables faster math with arbitrary-precision integers using BCMath.", + "ext-gmp": "Enables faster math with arbitrary-precision integers using GMP.", + "ext-uuid": "Enables the use of PeclUuidTimeGenerator and PeclUuidRandomGenerator.", + "paragonie/random-lib": "Provides RandomLib for use with the RandomLibAdapter", + "ramsey/uuid-doctrine": "Allows the use of Ramsey\\Uuid\\Uuid as Doctrine field type." + }, + "type": "library", + "extra": { + "captainhook": { + "force-install": true + } + }, + "autoload": { + "files": [ + "src/functions.php" + ], + "psr-4": { + "Ramsey\\Uuid\\": "src/" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "description": "A PHP library for generating and working with universally unique identifiers (UUIDs).", + "keywords": [ + "guid", + "identifier", + "uuid" + ], + "support": { + "issues": "https://github.com/ramsey/uuid/issues", + "source": "https://github.com/ramsey/uuid/tree/4.10.0" + }, + "time": "2026-11-14T23:23:20+00:00", + "published-time": "2026-11-14T23:35:39+00:00" + }, + { + "name": "ryangjchandler/blade-capture-directive", + "version": "v1.1.1", + "source": { + "type": "git", + "url": "https://github.com/ryangjchandler/blade-capture-directive.git", + "reference": "3f9e80b56ff60b78755ef320e3e16d88850101d6" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/ryangjchandler/blade-capture-directive/zipball/3f9e80b56ff60b78755ef320e3e16d88850101d6", + "reference": "3f9e80b56ff60b78755ef320e3e16d88850101d6", + "shasum": "" + }, + "require": { + "illuminate/contracts": "^10.0|^11.0|^12.0|^13.0", + "php": "^8.1", + "spatie/laravel-package-tools": "^1.9.2" + }, + "require-dev": { + "nunomaduro/collision": "^7.0|^8.0", + "nunomaduro/larastan": "^2.0|^3.0", + "orchestra/testbench": "^8.0|^9.0|^10.0|^11.0", + "pestphp/pest": "^2.0|^3.7|^4.1", + "pestphp/pest-plugin-laravel": "^2.0|^3.1|^v4.1.0", + "phpstan/extension-installer": "^1.1", + "phpstan/phpstan-deprecation-rules": "^1.0|^2.0", + "phpstan/phpstan-phpunit": "^1.0|^2.0", + "phpunit/phpunit": "^10.0|^11.5.3|^12.0", + "spatie/laravel-ray": "^1.26" + }, + "type": "library", + "extra": { + "laravel": { + "aliases": { + "BladeCaptureDirective": "RyanChandler\\BladeCaptureDirective\\Facades\\BladeCaptureDirective" + }, + "providers": [ + "RyanChandler\\BladeCaptureDirective\\BladeCaptureDirectiveServiceProvider" + ] + } + }, + "autoload": { + "psr-4": { + "RyanChandler\\BladeCaptureDirective\\": "src", + "RyanChandler\\BladeCaptureDirective\\Database\\Factories\\": "database/factories" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "Ryan Chandler", + "email": "support@ryangjchandler.co.uk", + "role": "Developer" + } + ], + "description": "Create inline partials in your Blade templates with ease.", + "homepage": "https://github.com/ryangjchandler/blade-capture-directive", + "keywords": [ + "blade-capture-directive", + "laravel", + "ryangjchandler" + ], + "support": { + "issues": "https://github.com/ryangjchandler/blade-capture-directive/issues", + "source": "https://github.com/ryangjchandler/blade-capture-directive/tree/v1.1.1" + }, + "funding": [ + { + "url": "https://github.com/ryangjchandler", + "type": "github" + } + ], + "time": "2026-03-19T10:36:26+00:00", + "published-time": "2026-03-19T10:36:44+00:00" + }, + { + "name": "scrivo/highlight.php", + "version": "v9.18.1.10", + "source": { + "type": "git", + "url": "https://github.com/scrivo/highlight.php.git", + "reference": "850f4b44697a2552e892ffe71490ba2733c2fc6e" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/scrivo/highlight.php/zipball/850f4b44697a2552e892ffe71490ba2733c2fc6e", + "reference": "850f4b44697a2552e892ffe71490ba2733c2fc6e", + "shasum": "" + }, + "require": { + "ext-json": "*", + "php": ">=5.4" + }, + "require-dev": { + "phpunit/phpunit": "^4.8|^5.7", + "sabberworm/php-css-parser": "^8.3", + "symfony/finder": "^2.8|^3.4|^5.4", + "symfony/var-dumper": "^2.8|^3.4|^5.4" + }, + "suggest": { + "ext-mbstring": "Allows highlighting code with unicode characters and supports language with unicode keywords" + }, + "type": "library", + "autoload": { + "files": [ + "HighlightUtilities/functions.php" + ], + "psr-0": { + "Highlight\\": "", + "HighlightUtilities\\": "" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "BSD-3-Clause" + ], + "authors": [ + { + "name": "Geert Bergman", + "homepage": "http://www.scrivo.org/", + "role": "Project Author" + }, + { + "name": "Vladimir Jimenez", + "homepage": "https://allejo.io", + "role": "Maintainer" + }, + { + "name": "Martin Folkers", + "homepage": "https://twobrain.io", + "role": "Contributor" + } + ], + "description": "Server side syntax highlighter that supports 185 languages. It's a PHP port of highlight.js", + "keywords": [ + "code", + "highlight", + "highlight.js", + "highlight.php", + "syntax" + ], + "support": { + "issues": "https://github.com/scrivo/highlight.php/issues", + "source": "https://github.com/scrivo/highlight.php" + }, + "funding": [ + { + "url": "https://github.com/allejo", + "type": "github" + } + ], + "time": "2022-12-17T21:53:22+00:00", + "published-time": "2022-12-17T21:54:17+00:00" + }, + { + "name": "spatie/invade", + "version": "2.2.0", + "source": { + "type": "git", + "url": "https://github.com/spatie/invade.git", + "reference": "10eb682c480bc5f677a6f9f5c5a64da12590dd97" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/spatie/invade/zipball/10eb682c480bc5f677a6f9f5c5a64da12590dd97", + "reference": "10eb682c480bc5f677a6f9f5c5a64da12590dd97", + "shasum": "" + }, + "require": { + "php": "^8.2" + }, + "require-dev": { + "friendsofphp/php-cs-fixer": "^3.0", + "pestphp/pest": "^3.8 || ^4.0", + "phpstan/phpstan": "^1.12 || ^2.0", + "spatie/ray": "^1.28" + }, + "type": "library", + "extra": { + "phpstan": { + "includes": [ + "phpstan-extension.neon" + ] + } + }, + "autoload": { + "files": [ + "src/functions.php" + ], + "psr-4": { + "Spatie\\Invade\\": "src" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "Freek Van der Herten", + "email": "freek@spatie.be", + "role": "Developer" + } + ], + "description": "A PHP function to work with private properties and methods", + "homepage": "https://github.com/spatie/invade", + "keywords": [ + "invade", + "spatie" + ], + "support": { + "source": "https://github.com/spatie/invade/tree/2.2.0" + }, + "funding": [ + { + "url": "https://github.com/spatie", + "type": "github" + } + ], + "time": "2026-10-19T16:16:47+00:00", + "published-time": "2026-10-19T16:17:14+00:00" + }, + { + "name": "spatie/laravel-package-tools", + "version": "1.93.3", + "source": { + "type": "git", + "url": "https://github.com/spatie/laravel-package-tools.git", + "reference": "7aeef26bd8d4909bec744dbf47aee7d1395588c1" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/spatie/laravel-package-tools/zipball/7aeef26bd8d4909bec744dbf47aee7d1395588c1", + "reference": "7aeef26bd8d4909bec744dbf47aee7d1395588c1", + "shasum": "" + }, + "require": { + "illuminate/contracts": "^10.0|^11.0|^12.0|^13.0", + "php": "^8.1" + }, + "require-dev": { + "mockery/mockery": "^1.5", + "orchestra/testbench": "^8.0|^9.2|^10.0|^11.0", + "pestphp/pest": "^2.1|^3.1|^4.0", + "phpunit/php-code-coverage": "^10.0|^11.0|^12.0", + "phpunit/phpunit": "^10.5|^11.5|^12.5", + "spatie/pest-plugin-test-time": "^2.2|^3.0" + }, + "type": "library", + "autoload": { + "psr-4": { + "Spatie\\LaravelPackageTools\\": "src" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "Freek Van der Herten", + "email": "freek@spatie.be", + "role": "Developer" + } + ], + "description": "Tools for creating Laravel packages", + "homepage": "https://github.com/spatie/laravel-package-tools", + "keywords": [ + "laravel-package-tools", + "spatie" + ], + "support": { + "issues": "https://github.com/spatie/laravel-package-tools/issues", + "source": "https://github.com/spatie/laravel-package-tools/tree/1.93.3" + }, + "funding": [ + { + "url": "https://github.com/spatie", + "type": "github" + } + ], + "time": "2026-09-28T07:16:50+00:00", + "published-time": "2026-09-28T07:17:01+00:00" + }, + { + "name": "spatie/shiki-php", + "version": "2.4.0", + "source": { + "type": "git", + "url": "https://github.com/spatie/shiki-php.git", + "reference": "b8b0ca32d3a82bc5c533e68ffab96c5d4ec1b9ba" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/spatie/shiki-php/zipball/b8b0ca32d3a82bc5c533e68ffab96c5d4ec1b9ba", + "reference": "b8b0ca32d3a82bc5c533e68ffab96c5d4ec1b9ba", + "shasum": "" + }, + "require": { + "ext-json": "*", + "php": "^8.0", + "symfony/process": "^5.4|^6.4|^7.1|^8.0" + }, + "require-dev": { + "friendsofphp/php-cs-fixer": "^v3.0", + "pestphp/pest": "^1.8", + "phpunit/phpunit": "^9.5", + "spatie/pest-plugin-snapshots": "^1.1", + "spatie/ray": "^1.10" + }, + "type": "library", + "autoload": { + "psr-4": { + "Spatie\\ShikiPhp\\": "src" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "Rias Van der Veken", + "email": "rias@spatie.be", + "role": "Developer" + }, + { + "name": "Freek Van der Herten", + "email": "freek@spatie.be", + "role": "Developer" + } + ], + "description": "Highlight code using Shiki in PHP", + "homepage": "https://github.com/spatie/shiki-php", + "keywords": [ + "shiki", + "spatie" + ], + "support": { + "source": "https://github.com/spatie/shiki-php/tree/2.4.0" + }, + "funding": [ + { + "url": "https://github.com/spatie", + "type": "github" + } + ], + "time": "2026-04-27T14:27:52+00:00", + "published-time": "2026-04-27T14:28:22+00:00" + }, + { + "name": "symfony/clock", + "version": "v8.1.9", + "source": { + "type": "git", + "url": "https://github.com/symfony/clock.git", + "reference": "945ea3b64d6da9c1c2c354fe5c07b27455df6442" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/symfony/clock/zipball/945ea3b64d6da9c1c2c354fe5c07b27455df6442", + "reference": "945ea3b64d6da9c1c2c354fe5c07b27455df6442", + "shasum": "" + }, + "require": { + "php": ">=8.4.1", + "psr/clock": "^1.0" + }, + "provide": { + "psr/clock-implementation": "1.0" + }, + "type": "library", + "autoload": { + "files": [ + "Resources/now.php" + ], + "psr-4": { + "Symfony\\Component\\Clock\\": "" + }, + "exclude-from-classmap": [ + "/Tests/" + ] + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "Nicolas Grekas", + "email": "p@tchwork.com" + }, + { + "name": "Symfony Community", + "homepage": "https://symfony.com/contributors" + } + ], + "description": "Decouples applications from the system clock", + "homepage": "https://symfony.com", + "keywords": [ + "clock", + "psr20", + "time" + ], + "support": { + "source": "https://github.com/symfony/clock/tree/v8.1.9" + }, + "funding": [ + { + "url": "https://symfony.com/sponsor", + "type": "custom" + }, + { + "url": "https://github.com/fabpot", + "type": "github" + }, + { + "url": "https://github.com/nicolas-grekas", + "type": "github" + }, + { + "url": "https://tidelift.com/funding/github/packagist/symfony/symfony", + "type": "tidelift" + } + ], + "time": "2026-10-12T14:32:04+00:00", + "published-time": "2026-10-14T06:48:32+00:00" + }, + { + "name": "symfony/console", + "version": "v8.1.11", + "source": { + "type": "git", + "url": "https://github.com/symfony/console.git", + "reference": "5a315b092b81f3e920e9daea1a2ae4c66ed298b9" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/symfony/console/zipball/5a315b092b81f3e920e9daea1a2ae4c66ed298b9", + "reference": "5a315b092b81f3e920e9daea1a2ae4c66ed298b9", + "shasum": "" + }, + "require": { + "php": ">=8.4.1", + "symfony/deprecation-contracts": "^2.5|^3", + "symfony/polyfill-mbstring": "^1.0", + "symfony/polyfill-php85": "^1.32", + "symfony/service-contracts": "^2.5|^3", + "symfony/string": "^7.4.6|^8.0.6" + }, + "conflict": { + "symfony/dependency-injection": "<8.1", + "symfony/event-dispatcher": "<8.1" + }, + "provide": { + "psr/log-implementation": "1.0|2.0|3.0" + }, + "require-dev": { + "psr/log": "^1|^2|^3", + "symfony/config": "^7.4|^8.0", + "symfony/dependency-injection": "^8.1", + "symfony/event-dispatcher": "^8.1", + "symfony/filesystem": "^7.4|^8.0", + "symfony/http-foundation": "^7.4|^8.0", + "symfony/http-kernel": "^7.4|^8.0", + "symfony/lock": "^7.4|^8.0", + "symfony/messenger": "^7.4|^8.0", + "symfony/mime": "^7.4|^8.0", + "symfony/process": "^7.4|^8.0", + "symfony/stopwatch": "^7.4|^8.0", + "symfony/uid": "^7.4|^8.0", + "symfony/validator": "^7.4|^8.0", + "symfony/var-dumper": "^7.4|^8.0" + }, + "type": "library", + "autoload": { + "psr-4": { + "Symfony\\Component\\Console\\": "" + }, + "exclude-from-classmap": [ + "/Tests/" + ] + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "Fabien Potencier", + "email": "fabien@symfony.com" + }, + { + "name": "Symfony Community", + "homepage": "https://symfony.com/contributors" + } + ], + "description": "Eases the creation of beautiful and testable command line interfaces", + "homepage": "https://symfony.com", + "keywords": [ + "cli", + "command-line", + "console", + "terminal" + ], + "support": { + "source": "https://github.com/symfony/console/tree/v8.1.11" + }, + "funding": [ + { + "url": "https://symfony.com/sponsor", + "type": "custom" + }, + { + "url": "https://github.com/fabpot", + "type": "github" + }, + { + "url": "https://github.com/nicolas-grekas", + "type": "github" + }, + { + "url": "https://tidelift.com/funding/github/packagist/symfony/symfony", + "type": "tidelift" + } + ], + "time": "2026-11-04T07:07:11+00:00", + "published-time": "2026-11-04T11:31:39+00:00" + }, + { + "name": "symfony/css-selector", + "version": "v8.1.10", + "source": { + "type": "git", + "url": "https://github.com/symfony/css-selector.git", + "reference": "9cfd588b8b07cf83e3426b030dbafd2291c132d9" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/symfony/css-selector/zipball/9cfd588b8b07cf83e3426b030dbafd2291c132d9", + "reference": "9cfd588b8b07cf83e3426b030dbafd2291c132d9", + "shasum": "" + }, + "require": { + "php": ">=8.4.1" + }, + "type": "library", + "autoload": { + "psr-4": { + "Symfony\\Component\\CssSelector\\": "" + }, + "exclude-from-classmap": [ + "/Tests/" + ] + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "Fabien Potencier", + "email": "fabien@symfony.com" + }, + { + "name": "Jean-François Simon", + "email": "jeanfrancois.simon@sensiolabs.com" + }, + { + "name": "Symfony Community", + "homepage": "https://symfony.com/contributors" + } + ], + "description": "Converts CSS selectors to XPath expressions", + "homepage": "https://symfony.com", + "support": { + "source": "https://github.com/symfony/css-selector/tree/v8.1.10" + }, + "funding": [ + { + "url": "https://symfony.com/sponsor", + "type": "custom" + }, + { + "url": "https://github.com/fabpot", + "type": "github" + }, + { + "url": "https://github.com/nicolas-grekas", + "type": "github" + }, + { + "url": "https://tidelift.com/funding/github/packagist/symfony/symfony", + "type": "tidelift" + } + ], + "time": "2026-10-18T14:56:39+00:00", + "published-time": "2026-10-28T18:24:46+00:00" + }, + { + "name": "symfony/deprecation-contracts", + "version": "v3.8.1", + "source": { + "type": "git", + "url": "https://github.com/symfony/deprecation-contracts.git", + "reference": "feb1edf4e546af3b85c5caebe8359a20db230ca3" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/symfony/deprecation-contracts/zipball/feb1edf4e546af3b85c5caebe8359a20db230ca3", + "reference": "feb1edf4e546af3b85c5caebe8359a20db230ca3", + "shasum": "" + }, + "require": { + "php": ">=8.1" + }, + "type": "library", + "extra": { + "thanks": { + "url": "https://github.com/symfony/contracts", + "name": "symfony/contracts" + }, + "branch-alias": { + "dev-main": "3.8-dev" + } + }, + "autoload": { + "files": [ + "function.php" + ] + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "Nicolas Grekas", + "email": "p@tchwork.com" + }, + { + "name": "Symfony Community", + "homepage": "https://symfony.com/contributors" + } + ], + "description": "A generic function and convention to trigger deprecation notices", + "homepage": "https://symfony.com", + "support": { + "source": "https://github.com/symfony/deprecation-contracts/tree/v3.8.1" + }, + "funding": [ + { + "url": "https://symfony.com/sponsor", + "type": "custom" + }, + { + "url": "https://github.com/fabpot", + "type": "github" + }, + { + "url": "https://github.com/nicolas-grekas", + "type": "github" + }, + { + "url": "https://tidelift.com/funding/github/packagist/symfony/symfony", + "type": "tidelift" + } + ], + "time": "2026-09-16T14:15:10+00:00", + "published-time": "2026-11-04T11:25:34+00:00" + }, + { + "name": "symfony/error-handler", + "version": "v8.1.10", + "source": { + "type": "git", + "url": "https://github.com/symfony/error-handler.git", + "reference": "84c6d73f990ae22dbd45625c056d7ff99ca6810d" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/symfony/error-handler/zipball/84c6d73f990ae22dbd45625c056d7ff99ca6810d", + "reference": "84c6d73f990ae22dbd45625c056d7ff99ca6810d", + "shasum": "" + }, + "require": { + "php": ">=8.4.1", + "psr/log": "^1|^2|^3", + "symfony/polyfill-php85": "^1.32", + "symfony/var-dumper": "^7.4|^8.0" + }, + "conflict": { + "symfony/deprecation-contracts": "<2.5" + }, + "require-dev": { + "symfony/console": "^7.4|^8.0", + "symfony/deprecation-contracts": "^2.5|^3", + "symfony/http-kernel": "^7.4|^8.0", + "symfony/serializer": "^7.4|^8.0", + "symfony/webpack-encore-bundle": "^1.0|^2.0" + }, + "bin": [ + "Resources/bin/patch-type-declarations" + ], + "type": "library", + "autoload": { + "psr-4": { + "Symfony\\Component\\ErrorHandler\\": "" + }, + "exclude-from-classmap": [ + "/Tests/" + ] + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "Fabien Potencier", + "email": "fabien@symfony.com" + }, + { + "name": "Symfony Community", + "homepage": "https://symfony.com/contributors" + } + ], + "description": "Provides tools to manage errors and ease debugging PHP code", + "homepage": "https://symfony.com", + "support": { + "source": "https://github.com/symfony/error-handler/tree/v8.1.10" + }, + "funding": [ + { + "url": "https://symfony.com/sponsor", + "type": "custom" + }, + { + "url": "https://github.com/fabpot", + "type": "github" + }, + { + "url": "https://github.com/nicolas-grekas", + "type": "github" + }, + { + "url": "https://tidelift.com/funding/github/packagist/symfony/symfony", + "type": "tidelift" + } + ], + "time": "2026-10-25T14:40:25+00:00", + "published-time": "2026-10-28T18:24:13+00:00" + }, + { + "name": "symfony/event-dispatcher", + "version": "v8.1.5", + "source": { + "type": "git", + "url": "https://github.com/symfony/event-dispatcher.git", + "reference": "7458da64220376b2e0dc2d8451bf43382c1ad297" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/symfony/event-dispatcher/zipball/7458da64220376b2e0dc2d8451bf43382c1ad297", + "reference": "7458da64220376b2e0dc2d8451bf43382c1ad297", + "shasum": "" + }, + "require": { + "php": ">=8.4.1", + "symfony/deprecation-contracts": "^2.5|^3", + "symfony/event-dispatcher-contracts": "^2.5|^3" + }, + "conflict": { + "symfony/security-http": "<7.4", + "symfony/service-contracts": "<2.5" + }, + "provide": { + "psr/event-dispatcher-implementation": "1.0", + "symfony/event-dispatcher-implementation": "2.0|3.0" + }, + "require-dev": { + "psr/log": "^1|^2|^3", + "symfony/config": "^7.4|^8.0", + "symfony/dependency-injection": "^7.4|^8.0", + "symfony/error-handler": "^7.4|^8.0", + "symfony/expression-language": "^7.4|^8.0", + "symfony/framework-bundle": "^7.4|^8.0", + "symfony/http-foundation": "^7.4|^8.0", + "symfony/service-contracts": "^2.5|^3", + "symfony/stopwatch": "^7.4|^8.0" + }, + "type": "library", + "autoload": { + "psr-4": { + "Symfony\\Component\\EventDispatcher\\": "" + }, + "exclude-from-classmap": [ + "/Tests/" + ] + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "Fabien Potencier", + "email": "fabien@symfony.com" + }, + { + "name": "Symfony Community", + "homepage": "https://symfony.com/contributors" + } + ], + "description": "Provides tools that allow your application components to communicate with each other by dispatching events and listening to them", + "homepage": "https://symfony.com", + "support": { + "source": "https://github.com/symfony/event-dispatcher/tree/v8.1.5" + }, + "funding": [ + { + "url": "https://symfony.com/sponsor", + "type": "custom" + }, + { + "url": "https://github.com/fabpot", + "type": "github" + }, + { + "url": "https://github.com/nicolas-grekas", + "type": "github" + }, + { + "url": "https://tidelift.com/funding/github/packagist/symfony/symfony", + "type": "tidelift" + } + ], + "time": "2026-08-21T17:47:34+00:00", + "published-time": "2026-08-22T13:46:58+00:00" + }, + { + "name": "symfony/event-dispatcher-contracts", + "version": "v3.8.1", + "source": { + "type": "git", + "url": "https://github.com/symfony/event-dispatcher-contracts.git", + "reference": "658e29751424da3ef4758c60f769e59d1b2981eb" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/symfony/event-dispatcher-contracts/zipball/658e29751424da3ef4758c60f769e59d1b2981eb", + "reference": "658e29751424da3ef4758c60f769e59d1b2981eb", + "shasum": "" + }, + "require": { + "php": ">=8.1", + "psr/event-dispatcher": "^1" + }, + "type": "library", + "extra": { + "thanks": { + "url": "https://github.com/symfony/contracts", + "name": "symfony/contracts" + }, + "branch-alias": { + "dev-main": "3.8-dev" + } + }, + "autoload": { + "psr-4": { + "Symfony\\Contracts\\EventDispatcher\\": "" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "Nicolas Grekas", + "email": "p@tchwork.com" + }, + { + "name": "Symfony Community", + "homepage": "https://symfony.com/contributors" + } + ], + "description": "Generic abstractions related to dispatching event", + "homepage": "https://symfony.com", + "keywords": [ + "abstractions", + "contracts", + "decoupling", + "interfaces", + "interoperability", + "standards" + ], + "support": { + "source": "https://github.com/symfony/event-dispatcher-contracts/tree/v3.8.1" + }, + "funding": [ + { + "url": "https://symfony.com/sponsor", + "type": "custom" + }, + { + "url": "https://github.com/fabpot", + "type": "github" + }, + { + "url": "https://github.com/nicolas-grekas", + "type": "github" + }, + { + "url": "https://tidelift.com/funding/github/packagist/symfony/symfony", + "type": "tidelift" + } + ], + "time": "2026-09-16T14:15:10+00:00", + "published-time": "2026-11-04T11:25:36+00:00" + }, + { + "name": "symfony/finder", + "version": "v8.1.11", + "source": { + "type": "git", + "url": "https://github.com/symfony/finder.git", + "reference": "a2902e479ba5691d20d51d100a715ea19ad2c837" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/symfony/finder/zipball/a2902e479ba5691d20d51d100a715ea19ad2c837", + "reference": "a2902e479ba5691d20d51d100a715ea19ad2c837", + "shasum": "" + }, + "require": { + "php": ">=8.4.1" + }, + "require-dev": { + "symfony/filesystem": "^7.4|^8.0" + }, + "type": "library", + "autoload": { + "psr-4": { + "Symfony\\Component\\Finder\\": "" + }, + "exclude-from-classmap": [ + "/Tests/" + ] + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "Fabien Potencier", + "email": "fabien@symfony.com" + }, + { + "name": "Symfony Community", + "homepage": "https://symfony.com/contributors" + } + ], + "description": "Finds files and directories via an intuitive fluent interface", + "homepage": "https://symfony.com", + "support": { + "source": "https://github.com/symfony/finder/tree/v8.1.11" + }, + "funding": [ + { + "url": "https://symfony.com/sponsor", + "type": "custom" + }, + { + "url": "https://github.com/fabpot", + "type": "github" + }, + { + "url": "https://github.com/nicolas-grekas", + "type": "github" + }, + { + "url": "https://tidelift.com/funding/github/packagist/symfony/symfony", + "type": "tidelift" + } + ], + "time": "2026-11-02T10:58:30+00:00", + "published-time": "2026-11-04T11:31:20+00:00" + }, + { + "name": "symfony/html-sanitizer", + "version": "v8.1.11", + "source": { + "type": "git", + "url": "https://github.com/symfony/html-sanitizer.git", + "reference": "1ecf13d98b75f5d8a2dcc1ffecde7184d29506ef" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/symfony/html-sanitizer/zipball/1ecf13d98b75f5d8a2dcc1ffecde7184d29506ef", + "reference": "1ecf13d98b75f5d8a2dcc1ffecde7184d29506ef", + "shasum": "" + }, + "require": { + "ext-dom": "*", + "league/uri": "^6.5|^7.0", + "php": ">=8.4.1" + }, + "type": "library", + "autoload": { + "psr-4": { + "Symfony\\Component\\HtmlSanitizer\\": "" + }, + "exclude-from-classmap": [ + "/Tests/" + ] + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "Titouan Galopin", + "email": "galopintitouan@gmail.com" + }, + { + "name": "Symfony Community", + "homepage": "https://symfony.com/contributors" + } + ], + "description": "Provides an object-oriented API to sanitize untrusted HTML input for safe insertion into a document's DOM.", + "homepage": "https://symfony.com", + "keywords": [ + "Purifier", + "html", + "sanitizer" + ], + "support": { + "source": "https://github.com/symfony/html-sanitizer/tree/v8.1.11" + }, + "funding": [ + { + "url": "https://symfony.com/sponsor", + "type": "custom" + }, + { + "url": "https://github.com/fabpot", + "type": "github" + }, + { + "url": "https://github.com/nicolas-grekas", + "type": "github" + }, + { + "url": "https://tidelift.com/funding/github/packagist/symfony/symfony", + "type": "tidelift" + } + ], + "time": "2026-11-04T08:39:20+00:00", + "published-time": "2026-11-04T11:31:16+00:00" + }, + { + "name": "symfony/http-foundation", + "version": "v8.1.11", + "source": { + "type": "git", + "url": "https://github.com/symfony/http-foundation.git", + "reference": "30fa3efe6e736b0d06f5331cc6abe813582c0a26" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/symfony/http-foundation/zipball/30fa3efe6e736b0d06f5331cc6abe813582c0a26", + "reference": "30fa3efe6e736b0d06f5331cc6abe813582c0a26", + "shasum": "" + }, + "require": { + "php": ">=8.4.1", + "symfony/deprecation-contracts": "^2.5|^3", + "symfony/polyfill-mbstring": "^1.1" + }, + "conflict": { + "doctrine/dbal": "<4.3" + }, + "require-dev": { + "doctrine/dbal": "^4.3", + "predis/predis": "^1.1|^2.0", + "symfony/cache": "^7.4|^8.0", + "symfony/clock": "^7.4|^8.0", + "symfony/dependency-injection": "^7.4|^8.0", + "symfony/expression-language": "^7.4|^8.0", + "symfony/http-kernel": "^7.4|^8.0", + "symfony/mime": "^7.4|^8.0", + "symfony/rate-limiter": "^7.4|^8.0" + }, + "type": "library", + "autoload": { + "psr-4": { + "Symfony\\Component\\HttpFoundation\\": "" + }, + "exclude-from-classmap": [ + "/Tests/" + ] + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "Fabien Potencier", + "email": "fabien@symfony.com" + }, + { + "name": "Symfony Community", + "homepage": "https://symfony.com/contributors" + } + ], + "description": "Defines an object-oriented layer for the HTTP specification", + "homepage": "https://symfony.com", + "support": { + "source": "https://github.com/symfony/http-foundation/tree/v8.1.11" + }, + "funding": [ + { + "url": "https://symfony.com/sponsor", + "type": "custom" + }, + { + "url": "https://github.com/fabpot", + "type": "github" + }, + { + "url": "https://github.com/nicolas-grekas", + "type": "github" + }, + { + "url": "https://tidelift.com/funding/github/packagist/symfony/symfony", + "type": "tidelift" + } + ], + "time": "2026-11-04T08:39:20+00:00", + "published-time": "2026-11-04T11:31:54+00:00" + }, + { + "name": "symfony/http-kernel", + "version": "v8.1.11", + "source": { + "type": "git", + "url": "https://github.com/symfony/http-kernel.git", + "reference": "460658504e26a2794aa614b4fbe6cf9bac2076fe" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/symfony/http-kernel/zipball/460658504e26a2794aa614b4fbe6cf9bac2076fe", + "reference": "460658504e26a2794aa614b4fbe6cf9bac2076fe", + "shasum": "" + }, + "require": { + "php": ">=8.4.1", + "psr/log": "^1|^2|^3", + "symfony/deprecation-contracts": "^2.5|^3", + "symfony/error-handler": "^7.4|^8.0", + "symfony/event-dispatcher": "^7.4|^8.0", + "symfony/http-foundation": "^7.4|^8.0", + "symfony/polyfill-ctype": "^1.8" + }, + "conflict": { + "symfony/dependency-injection": "<8.1", + "symfony/flex": "<2.10", + "symfony/http-client-contracts": "<2.5", + "symfony/serializer": "<7.4.15|>=8.0,<8.0.15|>=8.1,<8.1.2", + "symfony/translation-contracts": "<2.5", + "symfony/var-dumper": "<8.1", + "symfony/web-profiler-bundle": "<8.1", + "twig/twig": "<3.21" + }, + "provide": { + "psr/log-implementation": "1.0|2.0|3.0" + }, + "require-dev": { + "psr/cache": "^1.0|^2.0|^3.0", + "symfony/browser-kit": "^7.4|^8.0", + "symfony/clock": "^7.4|^8.0", + "symfony/config": "^7.4|^8.0", + "symfony/console": "^7.4|^8.0", + "symfony/css-selector": "^7.4|^8.0", + "symfony/dependency-injection": "^8.1", + "symfony/dom-crawler": "^7.4|^8.0", + "symfony/expression-language": "^7.4|^8.0", + "symfony/finder": "^7.4|^8.0", + "symfony/http-client-contracts": "^2.5|^3", + "symfony/process": "^7.4|^8.0", + "symfony/property-access": "^7.4|^8.0", + "symfony/rate-limiter": "^7.4|^8.0", + "symfony/routing": "^7.4|^8.0", + "symfony/serializer": "^7.4|^8.0", + "symfony/stopwatch": "^7.4|^8.0", + "symfony/translation": "^7.4|^8.0", + "symfony/translation-contracts": "^2.5|^3", + "symfony/uid": "^7.4|^8.0", + "symfony/validator": "^7.4|^8.0", + "symfony/var-dumper": "^8.1", + "symfony/var-exporter": "^7.4|^8.0", + "twig/twig": "^3.21|^4.0" + }, + "type": "library", + "autoload": { + "psr-4": { + "Symfony\\Component\\HttpKernel\\": "" + }, + "exclude-from-classmap": [ + "/Tests/" + ] + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "Fabien Potencier", + "email": "fabien@symfony.com" + }, + { + "name": "Symfony Community", + "homepage": "https://symfony.com/contributors" + } + ], + "description": "Provides a structured process for converting a Request into a Response", + "homepage": "https://symfony.com", + "support": { + "source": "https://github.com/symfony/http-kernel/tree/v8.1.11" + }, + "funding": [ + { + "url": "https://symfony.com/sponsor", + "type": "custom" + }, + { + "url": "https://github.com/fabpot", + "type": "github" + }, + { + "url": "https://github.com/nicolas-grekas", + "type": "github" + }, + { + "url": "https://tidelift.com/funding/github/packagist/symfony/symfony", + "type": "tidelift" + } + ], + "time": "2026-11-04T11:29:46+00:00", + "published-time": "2026-11-04T11:32:19+00:00" + }, + { + "name": "symfony/mailer", + "version": "v8.1.10", + "source": { + "type": "git", + "url": "https://github.com/symfony/mailer.git", + "reference": "4ba81a8f04fbf0bb1691f7bff760b301f1956fd7" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/symfony/mailer/zipball/4ba81a8f04fbf0bb1691f7bff760b301f1956fd7", + "reference": "4ba81a8f04fbf0bb1691f7bff760b301f1956fd7", + "shasum": "" + }, + "require": { + "egulias/email-validator": "^2.1.10|^3|^4", + "php": ">=8.4.1", + "psr/event-dispatcher": "^1", + "psr/log": "^1|^2|^3", + "symfony/event-dispatcher": "^7.4|^8.0", + "symfony/mime": "^7.4|^8.0", + "symfony/service-contracts": "^2.5|^3" + }, + "conflict": { + "symfony/http-client-contracts": "<2.5" + }, + "require-dev": { + "symfony/console": "^7.4|^8.0", + "symfony/http-client": "^7.4|^8.0", + "symfony/messenger": "^7.4|^8.0", + "symfony/twig-bridge": "^7.4|^8.0" + }, + "type": "library", + "autoload": { + "psr-4": { + "Symfony\\Component\\Mailer\\": "" + }, + "exclude-from-classmap": [ + "/Tests/" + ] + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "Fabien Potencier", + "email": "fabien@symfony.com" + }, + { + "name": "Symfony Community", + "homepage": "https://symfony.com/contributors" + } + ], + "description": "Helps sending emails", + "homepage": "https://symfony.com", + "support": { + "source": "https://github.com/symfony/mailer/tree/v8.1.10" + }, + "funding": [ + { + "url": "https://symfony.com/sponsor", + "type": "custom" + }, + { + "url": "https://github.com/fabpot", + "type": "github" + }, + { + "url": "https://github.com/nicolas-grekas", + "type": "github" + }, + { + "url": "https://tidelift.com/funding/github/packagist/symfony/symfony", + "type": "tidelift" + } + ], + "time": "2026-10-23T17:06:53+00:00", + "published-time": "2026-10-28T18:23:52+00:00" + }, + { + "name": "symfony/mime", + "version": "v8.1.10", + "source": { + "type": "git", + "url": "https://github.com/symfony/mime.git", + "reference": "8d1232052c9cdef170ed9608b3147bca4f61ff69" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/symfony/mime/zipball/8d1232052c9cdef170ed9608b3147bca4f61ff69", + "reference": "8d1232052c9cdef170ed9608b3147bca4f61ff69", + "shasum": "" + }, + "require": { + "php": ">=8.4.1", + "symfony/polyfill-intl-idn": "^1.10", + "symfony/polyfill-mbstring": "^1.0" + }, + "conflict": { + "egulias/email-validator": "~3.0.0", + "phpdocumentor/reflection-docblock": "<5.2|>=7", + "phpdocumentor/type-resolver": "<1.5.1" + }, + "require-dev": { + "egulias/email-validator": "^2.1.10|^3.1|^4", + "league/html-to-markdown": "^5.0", + "phpdocumentor/reflection-docblock": "^5.2|^6.0", + "symfony/dependency-injection": "^7.4|^8.0", + "symfony/process": "^7.4|^8.0", + "symfony/property-access": "^7.4|^8.0", + "symfony/property-info": "^7.4|^8.0", + "symfony/serializer": "^7.4.17|^8.1.5" + }, + "type": "library", + "autoload": { + "psr-4": { + "Symfony\\Component\\Mime\\": "" + }, + "exclude-from-classmap": [ + "/Tests/" + ] + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "Fabien Potencier", + "email": "fabien@symfony.com" + }, + { + "name": "Symfony Community", + "homepage": "https://symfony.com/contributors" + } + ], + "description": "Allows manipulating MIME messages", + "homepage": "https://symfony.com", + "keywords": [ + "mime", + "mime-type" + ], + "support": { + "source": "https://github.com/symfony/mime/tree/v8.1.10" + }, + "funding": [ + { + "url": "https://symfony.com/sponsor", + "type": "custom" + }, + { + "url": "https://github.com/fabpot", + "type": "github" + }, + { + "url": "https://github.com/nicolas-grekas", + "type": "github" + }, + { + "url": "https://tidelift.com/funding/github/packagist/symfony/symfony", + "type": "tidelift" + } + ], + "time": "2026-10-28T17:58:38+00:00", + "published-time": "2026-10-28T18:23:55+00:00" + }, + { + "name": "symfony/polyfill-ctype", + "version": "v1.37.0", + "source": { + "type": "git", + "url": "https://github.com/symfony/polyfill-ctype.git", + "reference": "141046a8f9477948ff284fa65be2095baafb94f2" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/symfony/polyfill-ctype/zipball/141046a8f9477948ff284fa65be2095baafb94f2", + "reference": "141046a8f9477948ff284fa65be2095baafb94f2", + "shasum": "" + }, + "require": { + "php": ">=7.2" + }, + "provide": { + "ext-ctype": "*" + }, + "suggest": { + "ext-ctype": "For best performance" + }, + "type": "library", + "extra": { + "thanks": { + "url": "https://github.com/symfony/polyfill", + "name": "symfony/polyfill" + } + }, + "autoload": { + "files": [ + "bootstrap.php" + ], + "psr-4": { + "Symfony\\Polyfill\\Ctype\\": "" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "Gert de Pagter", + "email": "BackEndTea@gmail.com" + }, + { + "name": "Symfony Community", + "homepage": "https://symfony.com/contributors" + } + ], + "description": "Symfony polyfill for ctype functions", + "homepage": "https://symfony.com", + "keywords": [ + "compatibility", + "ctype", + "polyfill", + "portable" + ], + "support": { + "source": "https://github.com/symfony/polyfill-ctype/tree/v1.37.0" + }, + "funding": [ + { + "url": "https://symfony.com/sponsor", + "type": "custom" + }, + { + "url": "https://github.com/fabpot", + "type": "github" + }, + { + "url": "https://github.com/nicolas-grekas", + "type": "github" + }, + { + "url": "https://tidelift.com/funding/github/packagist/symfony/symfony", + "type": "tidelift" + } + ], + "time": "2026-04-10T16:19:22+00:00", + "published-time": "2026-04-26T14:44:50+00:00" + }, + { + "name": "symfony/polyfill-intl-grapheme", + "version": "v1.43.3", + "source": { + "type": "git", + "url": "https://github.com/symfony/polyfill-intl-grapheme.git", + "reference": "5a8f33c87aeecffce24e721b5064fab05f4becf8" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/symfony/polyfill-intl-grapheme/zipball/5a8f33c87aeecffce24e721b5064fab05f4becf8", + "reference": "5a8f33c87aeecffce24e721b5064fab05f4becf8", + "shasum": "" + }, + "require": { + "php": ">=7.2" + }, + "suggest": { + "ext-intl": "For best performance" + }, + "type": "library", + "extra": { + "thanks": { + "url": "https://github.com/symfony/polyfill", + "name": "symfony/polyfill" + } + }, + "autoload": { + "files": [ + "bootstrap.php" + ], + "psr-4": { + "Symfony\\Polyfill\\Intl\\Grapheme\\": "" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "Nicolas Grekas", + "email": "p@tchwork.com" + }, + { + "name": "Symfony Community", + "homepage": "https://symfony.com/contributors" + } + ], + "description": "Symfony polyfill for intl's grapheme_* functions", + "homepage": "https://symfony.com", + "keywords": [ + "compatibility", + "grapheme", + "intl", + "polyfill", + "portable", + "shim" + ], + "support": { + "source": "https://github.com/symfony/polyfill-intl-grapheme/tree/v1.43.3" + }, + "funding": [ + { + "url": "https://symfony.com/sponsor", + "type": "custom" + }, + { + "url": "https://github.com/fabpot", + "type": "github" + }, + { + "url": "https://github.com/nicolas-grekas", + "type": "github" + }, + { + "url": "https://tidelift.com/funding/github/packagist/symfony/symfony", + "type": "tidelift" + } + ], + "time": "2026-10-15T09:18:53+00:00", + "published-time": "2026-10-28T10:07:44+00:00" + }, + { + "name": "symfony/polyfill-intl-idn", + "version": "v1.43.0", + "source": { + "type": "git", + "url": "https://github.com/symfony/polyfill-intl-idn.git", + "reference": "533d68cf99c8f8ee2e8893c59ed59192e92cfd74" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/symfony/polyfill-intl-idn/zipball/533d68cf99c8f8ee2e8893c59ed59192e92cfd74", + "reference": "533d68cf99c8f8ee2e8893c59ed59192e92cfd74", + "shasum": "" + }, + "require": { + "php": ">=7.2", + "symfony/polyfill-intl-normalizer": "^1.10" + }, + "suggest": { + "ext-intl": "For best performance" + }, + "type": "library", + "extra": { + "thanks": { + "url": "https://github.com/symfony/polyfill", + "name": "symfony/polyfill" + } + }, + "autoload": { + "files": [ + "bootstrap.php" + ], + "psr-4": { + "Symfony\\Polyfill\\Intl\\Idn\\": "" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "Laurent Bassin", + "email": "laurent@bassin.info" + }, + { + "name": "Trevor Rowbotham", + "email": "trevor.rowbotham@pm.me" + }, + { + "name": "Symfony Community", + "homepage": "https://symfony.com/contributors" + } + ], + "description": "Symfony polyfill for intl's idn_to_ascii and idn_to_utf8 functions", + "homepage": "https://symfony.com", + "keywords": [ + "compatibility", + "idn", + "intl", + "polyfill", + "portable", + "shim" + ], + "support": { + "source": "https://github.com/symfony/polyfill-intl-idn/tree/v1.43.0" + }, + "funding": [ + { + "url": "https://symfony.com/sponsor", + "type": "custom" + }, + { + "url": "https://github.com/fabpot", + "type": "github" + }, + { + "url": "https://github.com/nicolas-grekas", + "type": "github" + }, + { + "url": "https://tidelift.com/funding/github/packagist/symfony/symfony", + "type": "tidelift" + } + ], + "time": "2026-09-23T14:40:04+00:00", + "published-time": "2026-09-30T10:23:39+00:00" + }, + { + "name": "symfony/polyfill-intl-normalizer", + "version": "v1.43.0", + "source": { + "type": "git", + "url": "https://github.com/symfony/polyfill-intl-normalizer.git", + "reference": "ebd57ccc7edb93d632e184efbe7693d2517bab3b" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/symfony/polyfill-intl-normalizer/zipball/ebd57ccc7edb93d632e184efbe7693d2517bab3b", + "reference": "ebd57ccc7edb93d632e184efbe7693d2517bab3b", + "shasum": "" + }, + "require": { + "php": ">=7.2" + }, + "suggest": { + "ext-intl": "For best performance" + }, + "type": "library", + "extra": { + "thanks": { + "url": "https://github.com/symfony/polyfill", + "name": "symfony/polyfill" + } + }, + "autoload": { + "files": [ + "bootstrap.php" + ], + "psr-4": { + "Symfony\\Polyfill\\Intl\\Normalizer\\": "" + }, + "classmap": [ + "Resources/stubs" + ] + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "Nicolas Grekas", + "email": "p@tchwork.com" + }, + { + "name": "Symfony Community", + "homepage": "https://symfony.com/contributors" + } + ], + "description": "Symfony polyfill for intl's Normalizer class and related functions", + "homepage": "https://symfony.com", + "keywords": [ + "compatibility", + "intl", + "normalizer", + "polyfill", + "portable", + "shim" + ], + "support": { + "source": "https://github.com/symfony/polyfill-intl-normalizer/tree/v1.43.0" + }, + "funding": [ + { + "url": "https://symfony.com/sponsor", + "type": "custom" + }, + { + "url": "https://github.com/fabpot", + "type": "github" + }, + { + "url": "https://github.com/nicolas-grekas", + "type": "github" + }, + { + "url": "https://tidelift.com/funding/github/packagist/symfony/symfony", + "type": "tidelift" + } + ], + "time": "2026-09-23T22:02:09+00:00", + "published-time": "2026-09-30T10:23:47+00:00" + }, + { + "name": "symfony/polyfill-mbstring", + "version": "v1.43.3", + "source": { + "type": "git", + "url": "https://github.com/symfony/polyfill-mbstring.git", + "reference": "122889ed24dc000165bcbfd77ec412f15cbdfc6a" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/symfony/polyfill-mbstring/zipball/122889ed24dc000165bcbfd77ec412f15cbdfc6a", + "reference": "122889ed24dc000165bcbfd77ec412f15cbdfc6a", + "shasum": "" + }, + "require": { + "ext-iconv": "*", + "php": ">=7.2" + }, + "provide": { + "ext-mbstring": "*" + }, + "suggest": { + "ext-mbstring": "For best performance" + }, + "type": "library", + "extra": { + "thanks": { + "url": "https://github.com/symfony/polyfill", + "name": "symfony/polyfill" + } + }, + "autoload": { + "files": [ + "bootstrap.php" + ], + "psr-4": { + "Symfony\\Polyfill\\Mbstring\\": "" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "Nicolas Grekas", + "email": "p@tchwork.com" + }, + { + "name": "Symfony Community", + "homepage": "https://symfony.com/contributors" + } + ], + "description": "Symfony polyfill for the Mbstring extension", + "homepage": "https://symfony.com", + "keywords": [ + "compatibility", + "mbstring", + "polyfill", + "portable", + "shim" + ], + "support": { + "source": "https://github.com/symfony/polyfill-mbstring/tree/v1.43.3" + }, + "funding": [ + { + "url": "https://symfony.com/sponsor", + "type": "custom" + }, + { + "url": "https://github.com/fabpot", + "type": "github" + }, + { + "url": "https://github.com/nicolas-grekas", + "type": "github" + }, + { + "url": "https://tidelift.com/funding/github/packagist/symfony/symfony", + "type": "tidelift" + } + ], + "time": "2026-10-28T09:35:49+00:00", + "published-time": "2026-10-28T10:07:45+00:00" + }, + { + "name": "symfony/polyfill-php80", + "version": "v1.43.0", + "source": { + "type": "git", + "url": "https://github.com/symfony/polyfill-php80.git", + "reference": "9c6a5d6b01ca51d486c813e9a9c0ed55f208bb74" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/symfony/polyfill-php80/zipball/9c6a5d6b01ca51d486c813e9a9c0ed55f208bb74", + "reference": "9c6a5d6b01ca51d486c813e9a9c0ed55f208bb74", + "shasum": "" + }, + "require": { + "php": ">=7.2" + }, + "type": "library", + "extra": { + "thanks": { + "url": "https://github.com/symfony/polyfill", + "name": "symfony/polyfill" + } + }, + "autoload": { + "files": [ + "bootstrap.php" + ], + "psr-4": { + "Symfony\\Polyfill\\Php80\\": "" + }, + "classmap": [ + "Resources/stubs" + ] + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "Ion Bazan", + "email": "ion.bazan@gmail.com" + }, + { + "name": "Nicolas Grekas", + "email": "p@tchwork.com" + }, + { + "name": "Symfony Community", + "homepage": "https://symfony.com/contributors" + } + ], + "description": "Symfony polyfill backporting some PHP 8.0+ features to lower PHP versions", + "homepage": "https://symfony.com", + "keywords": [ + "compatibility", + "polyfill", + "portable", + "shim" + ], + "support": { + "source": "https://github.com/symfony/polyfill-php80/tree/v1.43.0" + }, + "funding": [ + { + "url": "https://symfony.com/sponsor", + "type": "custom" + }, + { + "url": "https://github.com/fabpot", + "type": "github" + }, + { + "url": "https://github.com/nicolas-grekas", + "type": "github" + }, + { + "url": "https://tidelift.com/funding/github/packagist/symfony/symfony", + "type": "tidelift" + } + ], + "time": "2026-09-25T15:50:05+00:00", + "published-time": "2026-09-30T10:23:35+00:00" + }, + { + "name": "symfony/polyfill-php82", + "version": "v1.43.0", + "source": { + "type": "git", + "url": "https://github.com/symfony/polyfill-php82.git", + "reference": "843bbe8b2a7934307b749751eede0f111f5d1cfc" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/symfony/polyfill-php82/zipball/843bbe8b2a7934307b749751eede0f111f5d1cfc", + "reference": "843bbe8b2a7934307b749751eede0f111f5d1cfc", + "shasum": "" + }, + "require": { + "php": ">=7.2" + }, + "type": "library", + "extra": { + "thanks": { + "url": "https://github.com/symfony/polyfill", + "name": "symfony/polyfill" + } + }, + "autoload": { + "files": [ + "bootstrap.php" + ], + "psr-4": { + "Symfony\\Polyfill\\Php82\\": "" + }, + "classmap": [ + "Resources/stubs" + ] + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "Nicolas Grekas", + "email": "p@tchwork.com" + }, + { + "name": "Symfony Community", + "homepage": "https://symfony.com/contributors" + } + ], + "description": "Symfony polyfill backporting some PHP 8.2+ features to lower PHP versions", + "homepage": "https://symfony.com", + "keywords": [ + "compatibility", + "polyfill", + "portable", + "shim" + ], + "support": { + "source": "https://github.com/symfony/polyfill-php82/tree/v1.43.0" + }, + "funding": [ + { + "url": "https://symfony.com/sponsor", + "type": "custom" + }, + { + "url": "https://github.com/fabpot", + "type": "github" + }, + { + "url": "https://github.com/nicolas-grekas", + "type": "github" + }, + { + "url": "https://tidelift.com/funding/github/packagist/symfony/symfony", + "type": "tidelift" + } + ], + "time": "2026-09-25T15:50:05+00:00", + "published-time": "2026-09-30T10:23:32+00:00" + }, + { + "name": "symfony/polyfill-php84", + "version": "v1.43.0", + "source": { + "type": "git", + "url": "https://github.com/symfony/polyfill-php84.git", + "reference": "22c6548499cbe5c5bb072fc0c42312dff062a015" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/symfony/polyfill-php84/zipball/22c6548499cbe5c5bb072fc0c42312dff062a015", + "reference": "22c6548499cbe5c5bb072fc0c42312dff062a015", + "shasum": "" + }, + "require": { + "php": ">=7.2" + }, + "type": "library", + "extra": { + "thanks": { + "url": "https://github.com/symfony/polyfill", + "name": "symfony/polyfill" + } + }, + "autoload": { + "files": [ + "bootstrap.php" + ], + "psr-4": { + "Symfony\\Polyfill\\Php84\\": "" + }, + "classmap": [ + "Resources/stubs" + ] + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "Nicolas Grekas", + "email": "p@tchwork.com" + }, + { + "name": "Symfony Community", + "homepage": "https://symfony.com/contributors" + } + ], + "description": "Symfony polyfill backporting some PHP 8.4+ features to lower PHP versions", + "homepage": "https://symfony.com", + "keywords": [ + "compatibility", + "polyfill", + "portable", + "shim" + ], + "support": { + "source": "https://github.com/symfony/polyfill-php84/tree/v1.43.0" + }, + "funding": [ + { + "url": "https://symfony.com/sponsor", + "type": "custom" + }, + { + "url": "https://github.com/fabpot", + "type": "github" + }, + { + "url": "https://github.com/nicolas-grekas", + "type": "github" + }, + { + "url": "https://tidelift.com/funding/github/packagist/symfony/symfony", + "type": "tidelift" + } + ], + "time": "2026-09-23T22:01:09+00:00", + "published-time": "2026-09-30T10:23:33+00:00" + }, + { + "name": "symfony/polyfill-php85", + "version": "v1.43.0", + "source": { + "type": "git", + "url": "https://github.com/symfony/polyfill-php85.git", + "reference": "86a42cbcc07adc331481a5ab310a4024bfc227f6" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/symfony/polyfill-php85/zipball/86a42cbcc07adc331481a5ab310a4024bfc227f6", + "reference": "86a42cbcc07adc331481a5ab310a4024bfc227f6", + "shasum": "" + }, + "require": { + "php": ">=7.2" + }, + "type": "library", + "extra": { + "thanks": { + "url": "https://github.com/symfony/polyfill", + "name": "symfony/polyfill" + } + }, + "autoload": { + "files": [ + "bootstrap.php" + ], + "psr-4": { + "Symfony\\Polyfill\\Php85\\": "" + }, + "classmap": [ + "Resources/stubs" + ] + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "Nicolas Grekas", + "email": "p@tchwork.com" + }, + { + "name": "Symfony Community", + "homepage": "https://symfony.com/contributors" + } + ], + "description": "Symfony polyfill backporting some PHP 8.5+ features to lower PHP versions", + "homepage": "https://symfony.com", + "keywords": [ + "compatibility", + "polyfill", + "portable", + "shim" + ], + "support": { + "source": "https://github.com/symfony/polyfill-php85/tree/v1.43.0" + }, + "funding": [ + { + "url": "https://symfony.com/sponsor", + "type": "custom" + }, + { + "url": "https://github.com/fabpot", + "type": "github" + }, + { + "url": "https://github.com/nicolas-grekas", + "type": "github" + }, + { + "url": "https://tidelift.com/funding/github/packagist/symfony/symfony", + "type": "tidelift" + } + ], + "time": "2026-09-25T15:46:47+00:00", + "published-time": "2026-09-30T10:23:32+00:00" + }, + { + "name": "symfony/polyfill-php86", + "version": "v1.43.0", + "source": { + "type": "git", + "url": "https://github.com/symfony/polyfill-php86.git", + "reference": "8840df45b24f33a49dc419fa18dc0057231ae1d8" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/symfony/polyfill-php86/zipball/8840df45b24f33a49dc419fa18dc0057231ae1d8", + "reference": "8840df45b24f33a49dc419fa18dc0057231ae1d8", + "shasum": "" + }, + "require": { + "php": ">=7.2" + }, + "type": "library", + "extra": { + "thanks": { + "url": "https://github.com/symfony/polyfill", + "name": "symfony/polyfill" + } + }, + "autoload": { + "files": [ + "bootstrap.php" + ], + "psr-4": { + "Symfony\\Polyfill\\Php86\\": "" + }, + "classmap": [ + "Resources/stubs" + ] + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "Nicolas Grekas", + "email": "p@tchwork.com" + }, + { + "name": "Symfony Community", + "homepage": "https://symfony.com/contributors" + } + ], + "description": "Symfony polyfill backporting some PHP 8.6+ features to lower PHP versions", + "homepage": "https://symfony.com", + "keywords": [ + "compatibility", + "polyfill", + "portable", + "shim" + ], + "support": { + "source": "https://github.com/symfony/polyfill-php86/tree/v1.43.0" + }, + "funding": [ + { + "url": "https://symfony.com/sponsor", + "type": "custom" + }, + { + "url": "https://github.com/fabpot", + "type": "github" + }, + { + "url": "https://github.com/nicolas-grekas", + "type": "github" + }, + { + "url": "https://tidelift.com/funding/github/packagist/symfony/symfony", + "type": "tidelift" + } + ], + "time": "2026-09-25T15:46:47+00:00", + "published-time": "2026-09-30T10:23:43+00:00" + }, + { + "name": "symfony/polyfill-time", + "version": "v1.42.0", + "source": { + "type": "git", + "url": "https://github.com/symfony/polyfill-time.git", + "reference": "ac9f1ed802dd58f37e720388130c088434aa09fc" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/symfony/polyfill-time/zipball/ac9f1ed802dd58f37e720388130c088434aa09fc", + "reference": "ac9f1ed802dd58f37e720388130c088434aa09fc", + "shasum": "" + }, + "require": { + "php": ">=8.1" + }, + "type": "library", + "extra": { + "thanks": { + "url": "https://github.com/symfony/polyfill", + "name": "symfony/polyfill" + } + }, + "autoload": { + "psr-4": { + "Symfony\\Polyfill\\Time\\": "" + }, + "classmap": [ + "Resources/stubs" + ] + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "Ignace Philippe Nyamagana Butera", + "email": "nyamsprod@gmail.com" + }, + { + "name": "Tim Düsterhus", + "email": "tim@tideways-gmbh.com" + }, + { + "name": "Symfony Community", + "homepage": "https://symfony.com/contributors" + } + ], + "description": "Symfony polyfill for the Time API added to PHP 8.6", + "homepage": "https://symfony.com", + "keywords": [ + "compatibility", + "duration", + "polyfill", + "portable", + "shim", + "time" + ], + "support": { + "source": "https://github.com/symfony/polyfill-time/tree/v1.42.0" + }, + "funding": [ + { + "url": "https://symfony.com/sponsor", + "type": "custom" + }, + { + "url": "https://github.com/fabpot", + "type": "github" + }, + { + "url": "https://github.com/nicolas-grekas", + "type": "github" + }, + { + "url": "https://tidelift.com/funding/github/packagist/symfony/symfony", + "type": "tidelift" + } + ], + "time": "2026-08-07T13:08:13+00:00", + "published-time": "2026-08-24T11:45:15+00:00" + }, + { + "name": "symfony/polyfill-uuid", + "version": "v1.43.0", + "source": { + "type": "git", + "url": "https://github.com/symfony/polyfill-uuid.git", + "reference": "b23ff8245cc5c4479ea2be3d0132d2e6dd433993" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/symfony/polyfill-uuid/zipball/b23ff8245cc5c4479ea2be3d0132d2e6dd433993", + "reference": "b23ff8245cc5c4479ea2be3d0132d2e6dd433993", + "shasum": "" + }, + "require": { + "php": ">=7.2" + }, + "provide": { + "ext-uuid": "*" + }, + "suggest": { + "ext-uuid": "For best performance" + }, + "type": "library", + "extra": { + "thanks": { + "url": "https://github.com/symfony/polyfill", + "name": "symfony/polyfill" + } + }, + "autoload": { + "files": [ + "bootstrap.php" + ], + "psr-4": { + "Symfony\\Polyfill\\Uuid\\": "" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "Grégoire Pineau", + "email": "lyrixx@lyrixx.info" + }, + { + "name": "Symfony Community", + "homepage": "https://symfony.com/contributors" + } + ], + "description": "Symfony polyfill for uuid functions", + "homepage": "https://symfony.com", + "keywords": [ + "compatibility", + "polyfill", + "portable", + "uuid" + ], + "support": { + "source": "https://github.com/symfony/polyfill-uuid/tree/v1.43.0" + }, + "funding": [ + { + "url": "https://symfony.com/sponsor", + "type": "custom" + }, + { + "url": "https://github.com/fabpot", + "type": "github" + }, + { + "url": "https://github.com/nicolas-grekas", + "type": "github" + }, + { + "url": "https://tidelift.com/funding/github/packagist/symfony/symfony", + "type": "tidelift" + } + ], + "time": "2026-09-24T05:20:52+00:00", + "published-time": "2026-09-30T10:23:49+00:00" + }, + { + "name": "symfony/process", + "version": "v8.1.10", + "source": { + "type": "git", + "url": "https://github.com/symfony/process.git", + "reference": "08aa69fa0998bb65a089f9e148a2c0f8b391398e" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/symfony/process/zipball/08aa69fa0998bb65a089f9e148a2c0f8b391398e", + "reference": "08aa69fa0998bb65a089f9e148a2c0f8b391398e", + "shasum": "" + }, + "require": { + "php": ">=8.4.1" + }, + "type": "library", + "autoload": { + "psr-4": { + "Symfony\\Component\\Process\\": "" + }, + "exclude-from-classmap": [ + "/Tests/" + ] + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "Fabien Potencier", + "email": "fabien@symfony.com" + }, + { + "name": "Symfony Community", + "homepage": "https://symfony.com/contributors" + } + ], + "description": "Executes commands in sub-processes", + "homepage": "https://symfony.com", + "support": { + "source": "https://github.com/symfony/process/tree/v8.1.10" + }, + "funding": [ + { + "url": "https://symfony.com/sponsor", + "type": "custom" + }, + { + "url": "https://github.com/fabpot", + "type": "github" + }, + { + "url": "https://github.com/nicolas-grekas", + "type": "github" + }, + { + "url": "https://tidelift.com/funding/github/packagist/symfony/symfony", + "type": "tidelift" + } + ], + "time": "2026-10-25T14:40:25+00:00", + "published-time": "2026-10-28T18:25:20+00:00" + }, + { + "name": "symfony/routing", + "version": "v8.1.11", + "source": { + "type": "git", + "url": "https://github.com/symfony/routing.git", + "reference": "f3fefc6cad3748d538be970ca81b71f06d7aa8b3" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/symfony/routing/zipball/f3fefc6cad3748d538be970ca81b71f06d7aa8b3", + "reference": "f3fefc6cad3748d538be970ca81b71f06d7aa8b3", + "shasum": "" + }, + "require": { + "php": ">=8.4.1", + "symfony/deprecation-contracts": "^2.5|^3" + }, + "require-dev": { + "psr/log": "^1|^2|^3", + "symfony/config": "^7.4|^8.0", + "symfony/dependency-injection": "^7.4|^8.0", + "symfony/expression-language": "^7.4|^8.0", + "symfony/http-foundation": "^7.4|^8.0", + "symfony/yaml": "^7.4|^8.0" + }, + "type": "library", + "autoload": { + "psr-4": { + "Symfony\\Component\\Routing\\": "" + }, + "exclude-from-classmap": [ + "/Tests/" + ] + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "Fabien Potencier", + "email": "fabien@symfony.com" + }, + { + "name": "Symfony Community", + "homepage": "https://symfony.com/contributors" + } + ], + "description": "Maps an HTTP request to a set of configuration variables", + "homepage": "https://symfony.com", + "keywords": [ + "router", + "routing", + "uri", + "url" + ], + "support": { + "source": "https://github.com/symfony/routing/tree/v8.1.11" + }, + "funding": [ + { + "url": "https://symfony.com/sponsor", + "type": "custom" + }, + { + "url": "https://github.com/fabpot", + "type": "github" + }, + { + "url": "https://github.com/nicolas-grekas", + "type": "github" + }, + { + "url": "https://tidelift.com/funding/github/packagist/symfony/symfony", + "type": "tidelift" + } + ], + "time": "2026-11-04T08:39:20+00:00", + "published-time": "2026-11-04T11:30:59+00:00" + }, + { + "name": "symfony/service-contracts", + "version": "v3.8.1", + "source": { + "type": "git", + "url": "https://github.com/symfony/service-contracts.git", + "reference": "052852a96fd5e5ebdb617dba22031e41a3300fb5" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/symfony/service-contracts/zipball/052852a96fd5e5ebdb617dba22031e41a3300fb5", + "reference": "052852a96fd5e5ebdb617dba22031e41a3300fb5", + "shasum": "" + }, + "require": { + "php": ">=8.1", + "psr/container": "^1.1|^2.0", + "symfony/deprecation-contracts": "^2.5|^3" + }, + "conflict": { + "ext-psr": "<1.1|>=2" + }, + "type": "library", + "extra": { + "thanks": { + "url": "https://github.com/symfony/contracts", + "name": "symfony/contracts" + }, + "branch-alias": { + "dev-main": "3.8-dev" + } + }, + "autoload": { + "psr-4": { + "Symfony\\Contracts\\Service\\": "" + }, + "exclude-from-classmap": [ + "/Test/" + ] + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "Nicolas Grekas", + "email": "p@tchwork.com" + }, + { + "name": "Symfony Community", + "homepage": "https://symfony.com/contributors" + } + ], + "description": "Generic abstractions related to writing services", + "homepage": "https://symfony.com", + "keywords": [ + "abstractions", + "contracts", + "decoupling", + "interfaces", + "interoperability", + "standards" + ], + "support": { + "source": "https://github.com/symfony/service-contracts/tree/v3.8.1" + }, + "funding": [ + { + "url": "https://symfony.com/sponsor", + "type": "custom" + }, + { + "url": "https://github.com/fabpot", + "type": "github" + }, + { + "url": "https://github.com/nicolas-grekas", + "type": "github" + }, + { + "url": "https://tidelift.com/funding/github/packagist/symfony/symfony", + "type": "tidelift" + } + ], + "time": "2026-10-20T17:38:25+00:00", + "published-time": "2026-11-04T11:25:33+00:00" + }, + { + "name": "symfony/string", + "version": "v8.1.10", + "source": { + "type": "git", + "url": "https://github.com/symfony/string.git", + "reference": "6c6110979c0150393bbb336170e286d51ab4d76c" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/symfony/string/zipball/6c6110979c0150393bbb336170e286d51ab4d76c", + "reference": "6c6110979c0150393bbb336170e286d51ab4d76c", + "shasum": "" + }, + "require": { + "php": ">=8.4.1", + "symfony/polyfill-ctype": "^1.8", + "symfony/polyfill-intl-grapheme": "^1.33", + "symfony/polyfill-intl-normalizer": "^1.0", + "symfony/polyfill-mbstring": "^1.0" + }, + "conflict": { + "symfony/translation-contracts": "<2.5" + }, + "require-dev": { + "symfony/emoji": "^7.4|^8.0", + "symfony/http-client": "^7.4|^8.0", + "symfony/intl": "^7.4|^8.0", + "symfony/translation-contracts": "^2.5|^3.0", + "symfony/var-exporter": "^7.4|^8.0" + }, + "type": "library", + "autoload": { + "files": [ + "Resources/functions.php" + ], + "psr-4": { + "Symfony\\Component\\String\\": "" + }, + "exclude-from-classmap": [ + "/Tests/" + ] + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "Nicolas Grekas", + "email": "p@tchwork.com" + }, + { + "name": "Symfony Community", + "homepage": "https://symfony.com/contributors" + } + ], + "description": "Provides an object-oriented API to strings and deals with bytes, UTF-8 code points and grapheme clusters in a unified way", + "homepage": "https://symfony.com", + "keywords": [ + "grapheme", + "i18n", + "string", + "unicode", + "utf-8", + "utf8" + ], + "support": { + "source": "https://github.com/symfony/string/tree/v8.1.10" + }, + "funding": [ + { + "url": "https://symfony.com/sponsor", + "type": "custom" + }, + { + "url": "https://github.com/fabpot", + "type": "github" + }, + { + "url": "https://github.com/nicolas-grekas", + "type": "github" + }, + { + "url": "https://tidelift.com/funding/github/packagist/symfony/symfony", + "type": "tidelift" + } + ], + "time": "2026-10-23T17:06:53+00:00", + "published-time": "2026-10-28T18:24:27+00:00" + }, + { + "name": "symfony/translation", + "version": "v8.1.11", + "source": { + "type": "git", + "url": "https://github.com/symfony/translation.git", + "reference": "d065adf56e5508293e80d7c140b0a9e043b63e9c" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/symfony/translation/zipball/d065adf56e5508293e80d7c140b0a9e043b63e9c", + "reference": "d065adf56e5508293e80d7c140b0a9e043b63e9c", + "shasum": "" + }, + "require": { + "php": ">=8.4.1", + "symfony/polyfill-mbstring": "^1.0", + "symfony/translation-contracts": "^3.6.1" + }, + "conflict": { + "nikic/php-parser": "<5.0", + "symfony/http-client-contracts": "<2.5", + "symfony/service-contracts": "<2.5" + }, + "provide": { + "symfony/translation-implementation": "2.3|3.0" + }, + "require-dev": { + "nikic/php-parser": "^5.0", + "psr/log": "^1|^2|^3", + "symfony/config": "^7.4|^8.0", + "symfony/console": "^7.4|^8.0", + "symfony/dependency-injection": "^7.4|^8.0", + "symfony/finder": "^7.4|^8.0", + "symfony/http-client-contracts": "^2.5|^3.0", + "symfony/http-kernel": "^7.4|^8.0", + "symfony/intl": "^7.4|^8.0", + "symfony/polyfill-intl-icu": "^1.21", + "symfony/routing": "^7.4|^8.0", + "symfony/service-contracts": "^2.5|^3", + "symfony/yaml": "^7.4|^8.0" + }, + "type": "library", + "autoload": { + "files": [ + "Resources/functions.php" + ], + "psr-4": { + "Symfony\\Component\\Translation\\": "" + }, + "exclude-from-classmap": [ + "/Tests/" + ] + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "Fabien Potencier", + "email": "fabien@symfony.com" + }, + { + "name": "Symfony Community", + "homepage": "https://symfony.com/contributors" + } + ], + "description": "Provides tools to internationalize your application", + "homepage": "https://symfony.com", + "support": { + "source": "https://github.com/symfony/translation/tree/v8.1.11" + }, + "funding": [ + { + "url": "https://symfony.com/sponsor", + "type": "custom" + }, + { + "url": "https://github.com/fabpot", + "type": "github" + }, + { + "url": "https://github.com/nicolas-grekas", + "type": "github" + }, + { + "url": "https://tidelift.com/funding/github/packagist/symfony/symfony", + "type": "tidelift" + } + ], + "time": "2026-11-01T22:27:46+00:00", + "published-time": "2026-11-04T11:31:54+00:00" + }, + { + "name": "symfony/translation-contracts", + "version": "v3.8.1", + "source": { + "type": "git", + "url": "https://github.com/symfony/translation-contracts.git", + "reference": "0a3ae917402632fcba2aeddae9c98332f3d7dd05" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/symfony/translation-contracts/zipball/0a3ae917402632fcba2aeddae9c98332f3d7dd05", + "reference": "0a3ae917402632fcba2aeddae9c98332f3d7dd05", + "shasum": "" + }, + "require": { + "php": ">=8.1" + }, + "type": "library", + "extra": { + "thanks": { + "url": "https://github.com/symfony/contracts", + "name": "symfony/contracts" + }, + "branch-alias": { + "dev-main": "3.8-dev" + } + }, + "autoload": { + "psr-4": { + "Symfony\\Contracts\\Translation\\": "" + }, + "exclude-from-classmap": [ + "/Test/" + ] + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "Nicolas Grekas", + "email": "p@tchwork.com" + }, + { + "name": "Symfony Community", + "homepage": "https://symfony.com/contributors" + } + ], + "description": "Generic abstractions related to translation", + "homepage": "https://symfony.com", + "keywords": [ + "abstractions", + "contracts", + "decoupling", + "interfaces", + "interoperability", + "standards" + ], + "support": { + "source": "https://github.com/symfony/translation-contracts/tree/v3.8.1" + }, + "funding": [ + { + "url": "https://symfony.com/sponsor", + "type": "custom" + }, + { + "url": "https://github.com/fabpot", + "type": "github" + }, + { + "url": "https://github.com/nicolas-grekas", + "type": "github" + }, + { + "url": "https://tidelift.com/funding/github/packagist/symfony/symfony", + "type": "tidelift" + } + ], + "time": "2026-10-03T08:17:19+00:00", + "published-time": "2026-11-04T11:25:31+00:00" + }, + { + "name": "symfony/uid", + "version": "v8.1.9", + "source": { + "type": "git", + "url": "https://github.com/symfony/uid.git", + "reference": "cb487cf30380f0b0b090973bb9c0588193c06685" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/symfony/uid/zipball/cb487cf30380f0b0b090973bb9c0588193c06685", + "reference": "cb487cf30380f0b0b090973bb9c0588193c06685", + "shasum": "" + }, + "require": { + "php": ">=8.4.1", + "symfony/polyfill-uuid": "^1.15" + }, + "require-dev": { + "symfony/console": "^7.4|^8.0" + }, + "type": "library", + "autoload": { + "psr-4": { + "Symfony\\Component\\Uid\\": "" + }, + "exclude-from-classmap": [ + "/Tests/" + ] + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "Grégoire Pineau", + "email": "lyrixx@lyrixx.info" + }, + { + "name": "Nicolas Grekas", + "email": "p@tchwork.com" + }, + { + "name": "Symfony Community", + "homepage": "https://symfony.com/contributors" + } + ], + "description": "Provides an object-oriented API to generate and represent UIDs", + "homepage": "https://symfony.com", + "keywords": [ + "UID", + "ulid", + "uuid" + ], + "support": { + "source": "https://github.com/symfony/uid/tree/v8.1.9" + }, + "funding": [ + { + "url": "https://symfony.com/sponsor", + "type": "custom" + }, + { + "url": "https://github.com/fabpot", + "type": "github" + }, + { + "url": "https://github.com/nicolas-grekas", + "type": "github" + }, + { + "url": "https://tidelift.com/funding/github/packagist/symfony/symfony", + "type": "tidelift" + } + ], + "time": "2026-10-12T14:32:04+00:00", + "published-time": "2026-10-14T06:48:53+00:00" + }, + { + "name": "symfony/var-dumper", + "version": "v8.1.10", + "source": { + "type": "git", + "url": "https://github.com/symfony/var-dumper.git", + "reference": "3412a5af7d34a19515a77890fc804fe8e50d1a4f" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/symfony/var-dumper/zipball/3412a5af7d34a19515a77890fc804fe8e50d1a4f", + "reference": "3412a5af7d34a19515a77890fc804fe8e50d1a4f", + "shasum": "" + }, + "require": { + "php": ">=8.4.1", + "symfony/polyfill-mbstring": "^1.0" + }, + "conflict": { + "symfony/console": "<7.4", + "symfony/error-handler": "<7.4" + }, + "require-dev": { + "symfony/console": "^7.4|^8.0", + "symfony/http-kernel": "^7.4|^8.0", + "symfony/process": "^7.4|^8.0", + "symfony/uid": "^7.4|^8.0", + "twig/twig": "^3.12|^4.0" + }, + "bin": [ + "Resources/bin/var-dump-server" + ], + "type": "library", + "autoload": { + "files": [ + "Resources/functions/dump.php" + ], + "psr-4": { + "Symfony\\Component\\VarDumper\\": "" + }, + "exclude-from-classmap": [ + "/Tests/" + ] + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "Nicolas Grekas", + "email": "p@tchwork.com" + }, + { + "name": "Symfony Community", + "homepage": "https://symfony.com/contributors" + } + ], + "description": "Provides mechanisms for walking through any arbitrary PHP variable", + "homepage": "https://symfony.com", + "keywords": [ + "debug", + "dump" + ], + "support": { + "source": "https://github.com/symfony/var-dumper/tree/v8.1.10" + }, + "funding": [ + { + "url": "https://symfony.com/sponsor", + "type": "custom" + }, + { + "url": "https://github.com/fabpot", + "type": "github" + }, + { + "url": "https://github.com/nicolas-grekas", + "type": "github" + }, + { + "url": "https://tidelift.com/funding/github/packagist/symfony/symfony", + "type": "tidelift" + } + ], + "time": "2026-10-26T21:55:04+00:00", + "published-time": "2026-10-28T18:25:26+00:00" + }, + { + "name": "tijsverkoyen/css-to-inline-styles", + "version": "v2.4.0", + "source": { + "type": "git", + "url": "https://github.com/tijsverkoyen/CssToInlineStyles.git", + "reference": "f0292ccf0ec75843d65027214426b6b163b48b41" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/tijsverkoyen/CssToInlineStyles/zipball/f0292ccf0ec75843d65027214426b6b163b48b41", + "reference": "f0292ccf0ec75843d65027214426b6b163b48b41", + "shasum": "" + }, + "require": { + "ext-dom": "*", + "ext-libxml": "*", + "php": "^7.4 || ^8.0", + "symfony/css-selector": "^5.4 || ^6.0 || ^7.0 || ^8.0" + }, + "require-dev": { + "phpstan/phpstan": "^2.0", + "phpstan/phpstan-phpunit": "^2.0", + "phpunit/phpunit": "^8.5.21 || ^9.5.10" + }, + "type": "library", + "extra": { + "branch-alias": { + "dev-master": "2.x-dev" + } + }, + "autoload": { + "psr-4": { + "TijsVerkoyen\\CssToInlineStyles\\": "src" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "BSD-3-Clause" + ], + "authors": [ + { + "name": "Tijs Verkoyen", + "email": "css_to_inline_styles@verkoyen.eu", + "role": "Developer" + } + ], + "description": "CssToInlineStyles is a class that enables you to convert HTML-pages/files into HTML-pages/files with inline styles. This is very useful when you're sending emails.", + "homepage": "https://github.com/tijsverkoyen/CssToInlineStyles", + "support": { + "issues": "https://github.com/tijsverkoyen/CssToInlineStyles/issues", + "source": "https://github.com/tijsverkoyen/CssToInlineStyles/tree/v2.4.0" + }, + "time": "2025-12-02T11:56:42+00:00", + "published-time": "2025-12-11T21:29:16+00:00" + }, + { + "name": "ueberdosis/tiptap-php", + "version": "2.2.1", + "source": { + "type": "git", + "url": "https://github.com/ueberdosis/tiptap-php.git", + "reference": "242a7a150c1233a01622e050152699382fb20bea" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/ueberdosis/tiptap-php/zipball/242a7a150c1233a01622e050152699382fb20bea", + "reference": "242a7a150c1233a01622e050152699382fb20bea", + "shasum": "" + }, + "require": { + "php": "^8.0", + "scrivo/highlight.php": "^9.18", + "spatie/shiki-php": "^2.0" + }, + "require-dev": { + "friendsofphp/php-cs-fixer": "^3.5", + "pestphp/pest": "^1.21", + "phpunit/phpunit": "^9.5", + "vimeo/psalm": "^4.3" + }, + "type": "library", + "autoload": { + "psr-4": { + "Tiptap\\": "src" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "Hans Pagel", + "email": "humans@tiptap.dev", + "role": "Developer" + } + ], + "description": "A PHP package to work with Tiptap output", + "homepage": "https://github.com/ueberdosis/tiptap-php", + "keywords": [ + "prosemirror", + "tiptap", + "ueberdosis" + ], + "support": { + "issues": "https://github.com/ueberdosis/tiptap-php/issues", + "source": "https://github.com/ueberdosis/tiptap-php/tree/2.2.1" + }, + "funding": [ + { + "url": "https://tiptap.dev/pricing", + "type": "custom" + }, + { + "url": "https://github.com/ueberdosis", + "type": "github" + }, + { + "url": "https://opencollective.com/tiptap", + "type": "open_collective" + } + ], + "time": "2026-10-19T10:48:00+00:00", + "published-time": "2026-10-19T11:01:15+00:00" + }, + { + "name": "vlucas/phpdotenv", + "version": "v5.8.0", + "source": { + "type": "git", + "url": "https://github.com/phpdotenv/phpdotenv.git", + "reference": "96149103e62ac67e915f6d2ef59b72dee2e011e0" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/phpdotenv/phpdotenv/zipball/96149103e62ac67e915f6d2ef59b72dee2e011e0", + "reference": "96149103e62ac67e915f6d2ef59b72dee2e011e0", + "shasum": "" + }, + "require": { + "ext-pcre": "*", + "graham-campbell/result-type": "^1.2", + "php": "^7.2.5 || ^8.0", + "phpoption/phpoption": "^1.10", + "symfony/polyfill-ctype": "^1.26", + "symfony/polyfill-mbstring": "^1.26", + "symfony/polyfill-php80": "^1.26" + }, + "require-dev": { + "bamarni/composer-bin-plugin": "^1.8.2", + "ext-filter": "*", + "phpunit/phpunit": "^8.5.34 || ^9.6.13 || ^10.4.2" + }, + "suggest": { + "ext-filter": "Required to use the boolean validator." + }, + "type": "library", + "extra": { + "bamarni-bin": { + "bin-links": true, + "forward-command": false + }, + "branch-alias": { + "dev-master": "5.8-dev" + } + }, + "autoload": { + "psr-4": { + "Dotenv\\": "src/" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "BSD-3-Clause" + ], + "authors": [ + { + "name": "Graham Campbell", + "email": "hello@gjcampbell.co.uk", + "homepage": "https://github.com/GrahamCampbell" + }, + { + "name": "Vance Lucas", + "email": "vance@vancelucas.com", + "homepage": "https://github.com/vlucas" + } + ], + "description": "Loads environment variables from `.env` to `$_ENV` and `$_SERVER` automagically, and optionally to `getenv()`.", + "keywords": [ + "dotenv", + "env", + "environment" + ], + "support": { + "issues": "https://github.com/phpdotenv/phpdotenv/issues", + "source": "https://github.com/phpdotenv/phpdotenv/tree/v5.8.0" + }, + "funding": [ + { + "url": "https://github.com/GrahamCampbell", + "type": "github" + }, + { + "url": "https://tidelift.com/funding/github/packagist/vlucas/phpdotenv", + "type": "tidelift" + } + ], + "time": "2026-10-25T16:26:19+00:00", + "published-time": "2026-10-25T16:26:50+00:00" + }, + { + "name": "voku/portable-ascii", + "version": "2.1.1", + "source": { + "type": "git", + "url": "https://github.com/voku/portable-ascii.git", + "reference": "8e1051fe39379367aecf014f41744ce7539a856f" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/voku/portable-ascii/zipball/8e1051fe39379367aecf014f41744ce7539a856f", + "reference": "8e1051fe39379367aecf014f41744ce7539a856f", + "shasum": "" + }, + "require": { + "php": ">=7.1.0" + }, + "require-dev": { + "phpunit/phpunit": "~8.5 || ~9.6 || ~10.5 || ~11.5" + }, + "suggest": { + "ext-intl": "Use Intl for transliterator_transliterate() support" + }, + "type": "library", + "autoload": { + "psr-4": { + "voku\\": "src/voku/" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "Lars Moelleken", + "homepage": "https://www.moelleken.org/" + } + ], + "description": "Portable ASCII library - performance optimized (ascii) string functions for php.", + "homepage": "https://github.com/voku/portable-ascii", + "keywords": [ + "ascii", + "clean", + "php" + ], + "support": { + "issues": "https://github.com/voku/portable-ascii/issues", + "source": "https://github.com/voku/portable-ascii/tree/2.1.1" + }, + "funding": [ + { + "url": "https://www.paypal.me/moelleken", + "type": "custom" + }, + { + "url": "https://github.com/voku", + "type": "github" + }, + { + "url": "https://opencollective.com/portable-ascii", + "type": "open_collective" + }, + { + "url": "https://www.patreon.com/voku", + "type": "patreon" + }, + { + "url": "https://tidelift.com/funding/github/packagist/voku/portable-ascii", + "type": "tidelift" + } + ], + "time": "2026-04-26T05:33:54+00:00", + "published-time": "2026-04-26T05:43:38+00:00" + } + ], + "packages-dev": [ + { + "name": "fakerphp/faker", + "version": "v1.24.1", + "source": { + "type": "git", + "url": "https://github.com/FakerPHP/Faker.git", + "reference": "e0ee18eb1e6dc3cda3ce9fd97e5a0689a88a64b5" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/FakerPHP/Faker/zipball/e0ee18eb1e6dc3cda3ce9fd97e5a0689a88a64b5", + "reference": "e0ee18eb1e6dc3cda3ce9fd97e5a0689a88a64b5", + "shasum": "" + }, + "require": { + "php": "^7.4 || ^8.0", + "psr/container": "^1.0 || ^2.0", + "symfony/deprecation-contracts": "^2.2 || ^3.0" + }, + "conflict": { + "fzaninotto/faker": "*" + }, + "require-dev": { + "bamarni/composer-bin-plugin": "^1.4.1", + "doctrine/persistence": "^1.3 || ^2.0", + "ext-intl": "*", + "phpunit/phpunit": "^9.5.26", + "symfony/phpunit-bridge": "^5.4.16" + }, + "suggest": { + "doctrine/orm": "Required to use Faker\\ORM\\Doctrine", + "ext-curl": "Required by Faker\\Provider\\Image to download images.", + "ext-dom": "Required by Faker\\Provider\\HtmlLorem for generating random HTML.", + "ext-iconv": "Required by Faker\\Provider\\ru_RU\\Text::realText() for generating real Russian text.", + "ext-mbstring": "Required for multibyte Unicode string functionality." + }, + "type": "library", + "autoload": { + "psr-4": { + "Faker\\": "src/Faker/" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "François Zaninotto" + } + ], + "description": "Faker is a PHP library that generates fake data for you.", + "keywords": [ + "data", + "faker", + "fixtures" + ], + "support": { + "issues": "https://github.com/FakerPHP/Faker/issues", + "source": "https://github.com/FakerPHP/Faker/tree/v1.24.1" + }, + "time": "2024-11-21T13:46:39+00:00", + "published-time": "2024-11-21T13:47:18+00:00" + }, + { + "name": "filp/whoops", + "version": "2.19.3", + "source": { + "type": "git", + "url": "https://github.com/filp/whoops.git", + "reference": "d5480d53f10069dc4620a39f87e38e8945d47322" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/filp/whoops/zipball/d5480d53f10069dc4620a39f87e38e8945d47322", + "reference": "d5480d53f10069dc4620a39f87e38e8945d47322", + "shasum": "" + }, + "require": { + "php": "^7.1 || ^8.0", + "psr/log": "^1.0.1 || ^2.0 || ^3.0" + }, + "require-dev": { + "mockery/mockery": "^1.0", + "phpunit/phpunit": "^7.5.20 || ^8.5.8 || ^9.3.3 || ^10.5.58", + "symfony/var-dumper": "^4.0 || ^5.0 || ^6.0 || ^7.0 || ^8.0" + }, + "suggest": { + "symfony/var-dumper": "Pretty print complex values better with var-dumper available", + "whoops/soap": "Formats errors as SOAP responses" + }, + "type": "library", + "extra": { + "branch-alias": { + "dev-master": "2.7-dev" + } + }, + "autoload": { + "psr-4": { + "Whoops\\": "src/Whoops/" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "Filipe Dobreira", + "homepage": "https://github.com/filp", + "role": "Developer" + } + ], + "description": "php error handling for cool kids", + "homepage": "https://filp.github.io/whoops/", + "keywords": [ + "error", + "exception", + "handling", + "library", + "throwable", + "whoops" + ], + "support": { + "issues": "https://github.com/filp/whoops/issues", + "source": "https://github.com/filp/whoops/tree/2.19.3" + }, + "funding": [ + { + "url": "https://github.com/denis-sokolov", + "type": "github" + } + ], + "time": "2026-11-09T23:30:17+00:00", + "published-time": "2026-11-09T23:32:45+00:00" + }, + { + "name": "hamcrest/hamcrest-php", + "version": "v3.0.0", + "source": { + "type": "git", + "url": "https://github.com/hamcrest/hamcrest-php.git", + "reference": "b61cd040da1a4925bc90a51c074f5297e7c0fa52" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/hamcrest/hamcrest-php/zipball/b61cd040da1a4925bc90a51c074f5297e7c0fa52", + "reference": "b61cd040da1a4925bc90a51c074f5297e7c0fa52", + "shasum": "" + }, + "require": { + "ext-ctype": "*", + "ext-dom": "*", + "php": "^7.4|^8.0" + }, + "replace": { + "cordoval/hamcrest-php": "*", + "davedevelopment/hamcrest-php": "*", + "kodova/hamcrest-php": "*" + }, + "require-dev": { + "phpstan/phpstan": "^2.1", + "phpstan/phpstan-phpunit": "^2.0", + "phpunit/php-file-iterator": "^1.4 || ^2.0 || ^3.0", + "phpunit/phpunit": "^4.8.36 || ^5.7 || ^6.5 || ^7.0 || ^8.0 || ^9.0" + }, + "type": "library", + "extra": { + "branch-alias": { + "dev-master": "3.0-dev" + } + }, + "autoload": { + "classmap": [ + "hamcrest" + ] + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "BSD-3-Clause" + ], + "description": "This is the PHP port of Hamcrest Matchers", + "keywords": [ + "test" + ], + "support": { + "issues": "https://github.com/hamcrest/hamcrest-php/issues", + "source": "https://github.com/hamcrest/hamcrest-php/tree/v3.0.0" + }, + "time": "2026-03-17T11:56:53+00:00", + "published-time": "2026-06-16T10:52:40+00:00" + }, + { + "name": "laravel/agent-detector", + "version": "v2.0.5", + "source": { + "type": "git", + "url": "https://github.com/laravel/agent-detector.git", + "reference": "9e0d78ab6848d34f3ce5a438ca99ae082afd910a" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/laravel/agent-detector/zipball/9e0d78ab6848d34f3ce5a438ca99ae082afd910a", + "reference": "9e0d78ab6848d34f3ce5a438ca99ae082afd910a", + "shasum": "" + }, + "require": { + "php": "^8.2.0" + }, + "require-dev": { + "laravel/pint": "^1.24.0", + "pestphp/pest": "^3.8.5|^4.1.0", + "pestphp/pest-plugin-type-coverage": "^3.0|^4.0.2", + "phpstan/phpstan": "^2.1.26", + "rector/rector": "^2.1.7", + "symfony/var-dumper": "^7.3.3" + }, + "type": "library", + "autoload": { + "files": [ + "src/functions.php" + ], + "psr-4": { + "Laravel\\AgentDetector\\": "src/" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "Taylor Otwell", + "email": "taylor@laravel.com" + } + ], + "description": "Detect if code is running in an AI agent or automated development environment", + "homepage": "https://github.com/laravel/agent-detector", + "keywords": [ + "Agent", + "ai", + "automation", + "claude", + "cursor", + "detection", + "devin", + "php" + ], + "support": { + "issues": "https://github.com/laravel/agent-detector/issues", + "source": "https://github.com/laravel/agent-detector" + }, + "time": "2026-10-20T16:40:29+00:00", + "published-time": "2026-10-20T16:41:46+00:00" + }, + { + "name": "laravel/pail", + "version": "v1.3.0", + "source": { + "type": "git", + "url": "https://github.com/laravel/pail.git", + "reference": "72d615ff1104717c1317c6d5d7eab679e43a0408" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/laravel/pail/zipball/72d615ff1104717c1317c6d5d7eab679e43a0408", + "reference": "72d615ff1104717c1317c6d5d7eab679e43a0408", + "shasum": "" + }, + "require": { + "ext-mbstring": "*", + "illuminate/console": "^12.0|^13.0", + "illuminate/contracts": "^12.0|^13.0", + "illuminate/log": "^12.0|^13.0", + "illuminate/process": "^12.0|^13.0", + "illuminate/support": "^12.0|^13.0", + "nunomaduro/termwind": "^2.0", + "php": "^8.2", + "symfony/console": "^7.0|^8.0" + }, + "require-dev": { + "laravel/framework": "^12.69|^13.30", + "laravel/pint": "^1.13", + "orchestra/testbench-core": "^10.8|^11.0", + "pestphp/pest": "^3.0|^4.0", + "pestphp/pest-plugin-type-coverage": "^3.0|^4.0", + "phpstan/phpstan": "^1.12.27", + "symfony/var-dumper": "^7.0|^8.0", + "symfony/yaml": "^7.0|^8.0" + }, + "type": "library", + "extra": { + "laravel": { + "providers": [ + "Laravel\\Pail\\PailServiceProvider" + ] + }, + "branch-alias": { + "dev-main": "1.x-dev" + } + }, + "autoload": { + "psr-4": { + "Laravel\\Pail\\": "src/" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "Taylor Otwell", + "email": "taylor@laravel.com" + }, + { + "name": "Nuno Maduro", + "email": "enunomaduro@gmail.com" + } + ], + "description": "Easily delve into your Laravel application's log files directly from the command line.", + "homepage": "https://github.com/laravel/pail", + "keywords": [ + "dev", + "laravel", + "logs", + "php", + "tail" + ], + "support": { + "issues": "https://github.com/laravel/pail/issues", + "source": "https://github.com/laravel/pail" + }, + "time": "2026-11-09T14:56:19+00:00", + "published-time": "2026-11-10T16:07:50+00:00" + }, + { + "name": "laravel/pao", + "version": "v1.1.5", + "source": { + "type": "git", + "url": "https://github.com/laravel/pao.git", + "reference": "620424f1ce744d96937fb6be60a94793e79b67ad" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/laravel/pao/zipball/620424f1ce744d96937fb6be60a94793e79b67ad", + "reference": "620424f1ce744d96937fb6be60a94793e79b67ad", + "shasum": "" + }, + "require": { + "laravel/agent-detector": "^2.0.2", + "php": "^8.3" + }, + "conflict": { + "laravel/framework": "<12.0.0", + "nunomaduro/collision": "<8.9.3", + "pestphp/pest": "<4.6.3 || >=6.0.0", + "phpunit/phpunit": "<12.5.23 || >=13.0.0 <13.1.7 || >=14.0.0" + }, + "require-dev": { + "brianium/paratest": "^7.20.0", + "laravel/pint": "^1.30.5", + "orchestra/testbench": "^10.11.0 || ^11.2.0", + "pestphp/pest": "^4.7.8 || ^5.1.4", + "pestphp/pest-plugin-type-coverage": "^4.0.4 || ^5.0.2", + "phpstan/phpstan": "^2.2.13", + "rector/rector": "^2.6.6", + "symfony/process": "^7.4.13 || ^8.1.6", + "symfony/var-dumper": "^7.4.15 || ^8.1.6" + }, + "type": "library", + "extra": { + "pest": { + "plugins": [ + "Laravel\\Pao\\Drivers\\Pest\\Plugin" + ] + }, + "laravel": { + "providers": [ + "Laravel\\Pao\\Laravel\\ServiceProvider" + ] + } + }, + "autoload": { + "files": [ + "src/Autoload.php" + ], + "psr-4": { + "Laravel\\Pao\\": "src/" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "Taylor Otwell", + "email": "taylor@laravel.com" + } + ], + "description": "Agent-optimized output for PHP testing tools", + "keywords": [ + "Agent", + "PHPStan", + "ai", + "dev", + "paratest", + "pest", + "php", + "phpunit", + "rector", + "testing" + ], + "support": { + "issues": "https://github.com/laravel/pao/issues", + "source": "https://github.com/laravel/pao" + }, + "time": "2026-09-07T14:48:06+00:00", + "published-time": "2026-09-07T14:51:37+00:00" + }, + { + "name": "laravel/pint", + "version": "v1.32.3", + "source": { + "type": "git", + "url": "https://github.com/laravel/pint.git", + "reference": "1cf8e0320bed4b3c6e51df92039a5636c3887728" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/laravel/pint/zipball/1cf8e0320bed4b3c6e51df92039a5636c3887728", + "reference": "1cf8e0320bed4b3c6e51df92039a5636c3887728", + "shasum": "" + }, + "require": { + "ext-json": "*", + "ext-mbstring": "*", + "ext-tokenizer": "*", + "ext-xml": "*", + "php": "^8.3.0" + }, + "require-dev": { + "composer/semver": "^3.6.0", + "friendsofphp/php-cs-fixer": "^3.95.30", + "illuminate/view": "^13.42.0", + "larastan/larastan": "^3.15.0", + "laravel-zero/framework": "^13.0.0", + "laravel/agent-detector": "^2.0.5", + "laravel/prompts": "^0.3.27", + "mockery/mockery": "^1.6.15", + "nunomaduro/termwind": "^2.4.1", + "pestphp/pest": "^4.7.8" + }, + "bin": [ + "builds/pint" + ], + "type": "project", + "autoload": { + "psr-4": { + "App\\": "app/", + "Database\\Seeders\\": "database/seeders/", + "Database\\Factories\\": "database/factories/" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "Nuno Maduro", + "email": "enunomaduro@gmail.com" + } + ], + "description": "An opinionated code formatter for PHP.", + "homepage": "https://laravel.com", + "keywords": [ + "dev", + "format", + "formatter", + "lint", + "linter", + "php" + ], + "support": { + "issues": "https://github.com/laravel/pint/issues", + "source": "https://github.com/laravel/pint" + }, + "time": "2026-11-11T16:45:13+00:00", + "published-time": "2026-11-11T16:45:39+00:00" + }, + { + "name": "mockery/mockery", + "version": "1.6.15", + "source": { + "type": "git", + "url": "https://github.com/mockery/mockery.git", + "reference": "967a801bd188989a5669bd280f252d51c0fdc9ee" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/mockery/mockery/zipball/967a801bd188989a5669bd280f252d51c0fdc9ee", + "reference": "967a801bd188989a5669bd280f252d51c0fdc9ee", + "shasum": "" + }, + "require": { + "hamcrest/hamcrest-php": "^2.0 || ^3.0", + "php": ">=7.3" + }, + "conflict": { + "phpunit/phpunit": "<8.0" + }, + "require-dev": { + "phpunit/phpunit": "^9.6.36", + "symplify/easy-coding-standard": "^13.2.17" + }, + "type": "library", + "autoload": { + "files": [ + "library/helpers.php", + "library/Mockery.php" + ], + "psr-4": { + "Mockery\\": "library/Mockery" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "BSD-3-Clause" + ], + "authors": [ + { + "name": "Pádraic Brady", + "email": "padraic.brady@gmail.com", + "homepage": "https://github.com/padraic", + "role": "Author" + }, + { + "name": "Dave Marshall", + "email": "dave.marshall@atstsolutions.co.uk", + "homepage": "https://davedevelopment.co.uk", + "role": "Developer" + }, + { + "name": "Nathanael Esayeas", + "email": "nathanael.esayeas@protonmail.com", + "homepage": "https://github.com/ghostwriter", + "role": "Lead Developer" + } + ], + "description": "Mockery is a simple yet flexible PHP mock object framework", + "homepage": "https://github.com/mockery/mockery", + "keywords": [ + "BDD", + "TDD", + "library", + "mock", + "mock objects", + "mockery", + "stub", + "test", + "test double", + "testing" + ], + "support": { + "docs": "https://docs.mockery.io/", + "issues": "https://github.com/mockery/mockery/issues", + "rss": "https://github.com/mockery/mockery/releases.atom", + "security": "https://github.com/mockery/mockery/security/advisories", + "source": "https://github.com/mockery/mockery" + }, + "time": "2026-08-19T19:37:52+00:00", + "published-time": "2026-08-19T19:38:57+00:00" + }, + { + "name": "myclabs/deep-copy", + "version": "1.14.0", + "source": { + "type": "git", + "url": "https://github.com/myclabs/DeepCopy.git", + "reference": "8680aa248f8e07bc8fb43f56f0f5fc77a0c96aae" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/myclabs/DeepCopy/zipball/8680aa248f8e07bc8fb43f56f0f5fc77a0c96aae", + "reference": "8680aa248f8e07bc8fb43f56f0f5fc77a0c96aae", + "shasum": "" + }, + "require": { + "php": "^8.0" + }, + "conflict": { + "doctrine/collections": "<1.6.8", + "doctrine/common": "<2.13.3 || >=3 <3.2.2" + }, + "require-dev": { + "doctrine/collections": "^1.6.8", + "doctrine/common": "^2.13.3 || ^3.2.2", + "phpspec/prophecy": "^1.10", + "phpunit/phpunit": "^7.5.20 || ^8.5.23 || ^9.5.13" + }, + "type": "library", + "autoload": { + "files": [ + "src/DeepCopy/deep_copy.php" + ], + "psr-4": { + "DeepCopy\\": "src/DeepCopy/" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "description": "Create deep copies (clones) of your objects", + "keywords": [ + "clone", + "copy", + "duplicate", + "object", + "object graph" + ], + "support": { + "issues": "https://github.com/myclabs/DeepCopy/issues", + "source": "https://github.com/myclabs/DeepCopy/tree/1.14.0" + }, + "funding": [ + { + "url": "https://github.com/mnapoli", + "type": "github" + } + ], + "time": "2026-08-11T10:17:44+00:00", + "published-time": "2026-08-11T10:29:20+00:00" + }, + { + "name": "nunomaduro/collision", + "version": "v8.9.6", + "source": { + "type": "git", + "url": "https://github.com/nunomaduro/collision.git", + "reference": "68806f9257968f23775bee62970cb90925b79d51" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/nunomaduro/collision/zipball/68806f9257968f23775bee62970cb90925b79d51", + "reference": "68806f9257968f23775bee62970cb90925b79d51", + "shasum": "" + }, + "require": { + "filp/whoops": "^2.19.3", + "nunomaduro/termwind": "^2.4.1", + "php": "^8.2.0", + "symfony/console": "^7.4.23 || ^8.1.11" + }, + "conflict": { + "laravel/framework": "<11.48.0 || >=14.0.0", + "phpunit/phpunit": "<11.5.50 || >=14.0.0" + }, + "require-dev": { + "brianium/paratest": "^7.8.6", + "larastan/larastan": "^3.14.0", + "laravel/framework": "^11.57.1 || ^12.72.0 || ^13.40.0", + "laravel/pint": "^1.30.4", + "orchestra/testbench-core": "^9.24.0 || ^10.16.0 || ^11.6.0", + "pestphp/pest": "^3.8.7 || ^4.7.8 || ^5.3.5", + "sebastian/environment": "^7.2.1 || ^8.1.2 || ^9.3.3" + }, + "type": "library", + "extra": { + "laravel": { + "providers": [ + "NunoMaduro\\Collision\\Adapters\\Laravel\\CollisionServiceProvider" + ] + }, + "branch-alias": { + "dev-8.x": "8.x-dev" + } + }, + "autoload": { + "files": [ + "./src/Adapters/Phpunit/Autoload.php" + ], + "psr-4": { + "NunoMaduro\\Collision\\": "src/" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "Nuno Maduro", + "email": "enunomaduro@gmail.com" + } + ], + "description": "Cli error handling for console/command-line PHP applications.", + "keywords": [ + "artisan", + "cli", + "command-line", + "console", + "dev", + "error", + "handling", + "laravel", + "laravel-zero", + "php", + "symfony" + ], + "support": { + "issues": "https://github.com/nunomaduro/collision/issues", + "source": "https://github.com/nunomaduro/collision" + }, + "funding": [ + { + "url": "https://www.paypal.com/paypalme/enunomaduro", + "type": "custom" + }, + { + "url": "https://github.com/nunomaduro", + "type": "github" + }, + { + "url": "https://www.patreon.com/nunomaduro", + "type": "patreon" + } + ], + "time": "2026-11-10T17:06:52+00:00", + "published-time": "2026-11-10T17:23:22+00:00" + }, + { + "name": "phar-io/manifest", + "version": "2.0.4", + "source": { + "type": "git", + "url": "https://github.com/phar-io/manifest.git", + "reference": "54750ef60c58e43759730615a392c31c80e23176" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/phar-io/manifest/zipball/54750ef60c58e43759730615a392c31c80e23176", + "reference": "54750ef60c58e43759730615a392c31c80e23176", + "shasum": "" + }, + "require": { + "ext-dom": "*", + "ext-libxml": "*", + "ext-phar": "*", + "ext-xmlwriter": "*", + "phar-io/version": "^3.0.1", + "php": "^7.2 || ^8.0" + }, + "type": "library", + "extra": { + "branch-alias": { + "dev-master": "2.0.x-dev" + } + }, + "autoload": { + "classmap": [ + "src/" + ] + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "BSD-3-Clause" + ], + "authors": [ + { + "name": "Arne Blankerts", + "email": "arne@blankerts.de", + "role": "Developer" + }, + { + "name": "Sebastian Heuer", + "email": "sebastian@phpeople.de", + "role": "Developer" + }, + { + "name": "Sebastian Bergmann", + "email": "sebastian@phpunit.de", + "role": "Developer" + } + ], + "description": "Component for reading phar.io manifest information from a PHP Archive (PHAR)", + "support": { + "issues": "https://github.com/phar-io/manifest/issues", + "source": "https://github.com/phar-io/manifest/tree/2.0.4" + }, + "funding": [ + { + "url": "https://github.com/theseer", + "type": "github" + } + ], + "time": "2024-03-03T12:33:53+00:00", + "published-time": "2024-03-03T12:39:44+00:00" + }, + { + "name": "phar-io/version", + "version": "3.2.1", + "source": { + "type": "git", + "url": "https://github.com/phar-io/version.git", + "reference": "4f7fd7836c6f332bb2933569e566a0d6c4cbed74" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/phar-io/version/zipball/4f7fd7836c6f332bb2933569e566a0d6c4cbed74", + "reference": "4f7fd7836c6f332bb2933569e566a0d6c4cbed74", + "shasum": "" + }, + "require": { + "php": "^7.2 || ^8.0" + }, + "type": "library", + "autoload": { + "classmap": [ + "src/" + ] + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "BSD-3-Clause" + ], + "authors": [ + { + "name": "Arne Blankerts", + "email": "arne@blankerts.de", + "role": "Developer" + }, + { + "name": "Sebastian Heuer", + "email": "sebastian@phpeople.de", + "role": "Developer" + }, + { + "name": "Sebastian Bergmann", + "email": "sebastian@phpunit.de", + "role": "Developer" + } + ], + "description": "Library for handling version information and constraints", + "support": { + "issues": "https://github.com/phar-io/version/issues", + "source": "https://github.com/phar-io/version/tree/3.2.1" + }, + "time": "2022-02-21T01:04:05+00:00", + "published-time": "2022-02-21T01:04:30+00:00" + }, + { + "name": "phpunit/php-code-coverage", + "version": "12.5.8", + "source": { + "type": "git", + "url": "https://github.com/sebastianbergmann/php-code-coverage.git", + "reference": "7440368d94738d54f2c1de24dbd3871793bbb0dd" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/sebastianbergmann/php-code-coverage/zipball/7440368d94738d54f2c1de24dbd3871793bbb0dd", + "reference": "7440368d94738d54f2c1de24dbd3871793bbb0dd", + "shasum": "" + }, + "require": { + "ext-dom": "*", + "ext-libxml": "*", + "ext-xmlwriter": "*", + "nikic/php-parser": "^5.9.0", + "php": ">=8.3", + "phpunit/php-text-template": "^5.0.1", + "sebastian/complexity": "^5.0", + "sebastian/environment": "^8.1.2", + "sebastian/lines-of-code": "^4.0.1", + "sebastian/version": "^6.0", + "theseer/tokenizer": "^2.0.1" + }, + "require-dev": { + "phpunit/phpunit": "^12.5.37" + }, + "suggest": { + "ext-pcov": "PHP extension that provides line coverage", + "ext-xdebug": "PHP extension that provides line coverage as well as branch and path coverage" + }, + "type": "library", + "extra": { + "branch-alias": { + "dev-main": "12.5.x-dev" + } + }, + "autoload": { + "classmap": [ + "src/" + ] + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "BSD-3-Clause" + ], + "authors": [ + { + "name": "Sebastian Bergmann", + "email": "sebastian@phpunit.de", + "role": "lead" + } + ], + "description": "Library that provides collection, processing, and rendering functionality for PHP code coverage information.", + "homepage": "https://github.com/sebastianbergmann/php-code-coverage", + "keywords": [ + "coverage", + "testing", + "xunit" + ], + "support": { + "issues": "https://github.com/sebastianbergmann/php-code-coverage/issues", + "security": "https://github.com/sebastianbergmann/php-code-coverage/security/policy", + "source": "https://github.com/sebastianbergmann/php-code-coverage/tree/12.5.8" + }, + "funding": [ + { + "url": "https://github.com/sebastianbergmann", + "type": "github" + }, + { + "url": "https://liberapay.com/sebastianbergmann", + "type": "liberapay" + }, + { + "url": "https://thanks.dev/u/gh/sebastianbergmann", + "type": "thanks_dev" + }, + { + "url": "https://tidelift.com/funding/github/packagist/phpunit/php-code-coverage", + "type": "tidelift" + } + ], + "time": "2026-10-03T14:03:50+00:00", + "published-time": "2026-10-03T14:04:33+00:00" + }, + { + "name": "phpunit/php-file-iterator", + "version": "6.0.2", + "source": { + "type": "git", + "url": "https://github.com/sebastianbergmann/php-file-iterator.git", + "reference": "a248d1640ab059b075f53a2ef0f9856e864e06b5" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/sebastianbergmann/php-file-iterator/zipball/a248d1640ab059b075f53a2ef0f9856e864e06b5", + "reference": "a248d1640ab059b075f53a2ef0f9856e864e06b5", + "shasum": "" + }, + "require": { + "php": ">=8.3" + }, + "require-dev": { + "phpunit/phpunit": "^12.5.33" + }, + "type": "library", + "extra": { + "branch-alias": { + "dev-main": "6.0-dev" + } + }, + "autoload": { + "classmap": [ + "src/" + ] + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "BSD-3-Clause" + ], + "authors": [ + { + "name": "Sebastian Bergmann", + "email": "sebastian@phpunit.de", + "role": "lead" + } + ], + "description": "FilterIterator implementation that filters files based on a list of suffixes.", + "homepage": "https://github.com/sebastianbergmann/php-file-iterator/", + "keywords": [ + "filesystem", + "iterator" + ], + "support": { + "issues": "https://github.com/sebastianbergmann/php-file-iterator/issues", + "security": "https://github.com/sebastianbergmann/php-file-iterator/security/policy", + "source": "https://github.com/sebastianbergmann/php-file-iterator/tree/6.0.2" + }, + "funding": [ + { + "url": "https://github.com/sebastianbergmann", + "type": "github" + }, + { + "url": "https://liberapay.com/sebastianbergmann", + "type": "liberapay" + }, + { + "url": "https://thanks.dev/u/gh/sebastianbergmann", + "type": "thanks_dev" + }, + { + "url": "https://tidelift.com/funding/github/packagist/phpunit/php-file-iterator", + "type": "tidelift" + } + ], + "time": "2026-08-25T14:40:53+00:00", + "published-time": "2026-08-25T14:41:57+00:00" + }, + { + "name": "phpunit/php-invoker", + "version": "6.0.0", + "source": { + "type": "git", + "url": "https://github.com/sebastianbergmann/php-invoker.git", + "reference": "12b54e689b07a25a9b41e57736dfab6ec9ae5406" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/sebastianbergmann/php-invoker/zipball/12b54e689b07a25a9b41e57736dfab6ec9ae5406", + "reference": "12b54e689b07a25a9b41e57736dfab6ec9ae5406", + "shasum": "" + }, + "require": { + "php": ">=8.3" + }, + "require-dev": { + "ext-pcntl": "*", + "phpunit/phpunit": "^12.0" + }, + "suggest": { + "ext-pcntl": "*" + }, + "type": "library", + "extra": { + "branch-alias": { + "dev-main": "6.0-dev" + } + }, + "autoload": { + "classmap": [ + "src/" + ] + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "BSD-3-Clause" + ], + "authors": [ + { + "name": "Sebastian Bergmann", + "email": "sebastian@phpunit.de", + "role": "lead" + } + ], + "description": "Invoke callables with a timeout", + "homepage": "https://github.com/sebastianbergmann/php-invoker/", + "keywords": [ + "process" + ], + "support": { + "issues": "https://github.com/sebastianbergmann/php-invoker/issues", + "security": "https://github.com/sebastianbergmann/php-invoker/security/policy", + "source": "https://github.com/sebastianbergmann/php-invoker/tree/6.0.0" + }, + "funding": [ + { + "url": "https://github.com/sebastianbergmann", + "type": "github" + } + ], + "time": "2025-02-07T04:58:58+00:00", + "published-time": "2025-02-07T04:59:09+00:00" + }, + { + "name": "phpunit/php-text-template", + "version": "5.0.1", + "source": { + "type": "git", + "url": "https://github.com/sebastianbergmann/php-text-template.git", + "reference": "babab73b7ef9fae406f2eb3ee11323a61caa63d5" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/sebastianbergmann/php-text-template/zipball/babab73b7ef9fae406f2eb3ee11323a61caa63d5", + "reference": "babab73b7ef9fae406f2eb3ee11323a61caa63d5", + "shasum": "" + }, + "require": { + "php": ">=8.3" + }, + "require-dev": { + "phpunit/phpunit": "^12.5.37" + }, + "type": "library", + "extra": { + "branch-alias": { + "dev-main": "5.0-dev" + } + }, + "autoload": { + "classmap": [ + "src/" + ] + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "BSD-3-Clause" + ], + "authors": [ + { + "name": "Sebastian Bergmann", + "email": "sebastian@phpunit.de", + "role": "lead" + } + ], + "description": "Simple template engine.", + "homepage": "https://github.com/sebastianbergmann/php-text-template/", + "keywords": [ + "template" + ], + "support": { + "issues": "https://github.com/sebastianbergmann/php-text-template/issues", + "security": "https://github.com/sebastianbergmann/php-text-template/security/policy", + "source": "https://github.com/sebastianbergmann/php-text-template/tree/5.0.1" + }, + "funding": [ + { + "url": "https://github.com/sebastianbergmann", + "type": "github" + }, + { + "url": "https://liberapay.com/sebastianbergmann", + "type": "liberapay" + }, + { + "url": "https://thanks.dev/u/gh/sebastianbergmann", + "type": "thanks_dev" + }, + { + "url": "https://tidelift.com/funding/github/packagist/phpunit/php-text-template", + "type": "tidelift" + } + ], + "time": "2026-10-03T04:51:29+00:00", + "published-time": "2026-10-03T04:54:39+00:00" + }, + { + "name": "phpunit/php-timer", + "version": "8.0.0", + "source": { + "type": "git", + "url": "https://github.com/sebastianbergmann/php-timer.git", + "reference": "f258ce36aa457f3aa3339f9ed4c81fc66dc8c2cc" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/sebastianbergmann/php-timer/zipball/f258ce36aa457f3aa3339f9ed4c81fc66dc8c2cc", + "reference": "f258ce36aa457f3aa3339f9ed4c81fc66dc8c2cc", + "shasum": "" + }, + "require": { + "php": ">=8.3" + }, + "require-dev": { + "phpunit/phpunit": "^12.0" + }, + "type": "library", + "extra": { + "branch-alias": { + "dev-main": "8.0-dev" + } + }, + "autoload": { + "classmap": [ + "src/" + ] + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "BSD-3-Clause" + ], + "authors": [ + { + "name": "Sebastian Bergmann", + "email": "sebastian@phpunit.de", + "role": "lead" + } + ], + "description": "Utility class for timing", + "homepage": "https://github.com/sebastianbergmann/php-timer/", + "keywords": [ + "timer" + ], + "support": { + "issues": "https://github.com/sebastianbergmann/php-timer/issues", + "security": "https://github.com/sebastianbergmann/php-timer/security/policy", + "source": "https://github.com/sebastianbergmann/php-timer/tree/8.0.0" + }, + "funding": [ + { + "url": "https://github.com/sebastianbergmann", + "type": "github" + } + ], + "time": "2025-02-07T04:59:38+00:00", + "published-time": "2025-02-07T04:59:52+00:00" + }, + { + "name": "phpunit/phpunit", + "version": "12.5.44", + "source": { + "type": "git", + "url": "https://github.com/sebastianbergmann/phpunit.git", + "reference": "47d052b58672b016b512974c1139346306c8ca24" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/sebastianbergmann/phpunit/zipball/47d052b58672b016b512974c1139346306c8ca24", + "reference": "47d052b58672b016b512974c1139346306c8ca24", + "shasum": "" + }, + "require": { + "ext-dom": "*", + "ext-filter": "*", + "ext-json": "*", + "ext-libxml": "*", + "ext-mbstring": "*", + "ext-xmlwriter": "*", + "myclabs/deep-copy": "^1.14.0", + "phar-io/manifest": "^2.0.4", + "phar-io/version": "^3.2.1", + "php": ">=8.3", + "phpunit/php-code-coverage": "^12.5.8", + "phpunit/php-file-iterator": "^6.0.2", + "phpunit/php-invoker": "^6.0.0", + "phpunit/php-text-template": "^5.0.1", + "phpunit/php-timer": "^8.0.0", + "sebastian/cli-parser": "^4.2.1", + "sebastian/comparator": "^7.1.8", + "sebastian/diff": "^7.0.1", + "sebastian/environment": "^8.1.2", + "sebastian/exporter": "^7.0.3", + "sebastian/global-state": "^8.0.3", + "sebastian/object-enumerator": "^7.0.0", + "sebastian/recursion-context": "^7.0.1", + "sebastian/type": "^6.0.4", + "sebastian/version": "^6.0.2", + "staabm/side-effects-detector": "^1.0.5" + }, + "bin": [ + "phpunit" + ], + "type": "library", + "extra": { + "branch-alias": { + "dev-main": "12.5-dev" + } + }, + "autoload": { + "files": [ + "src/Framework/Assert/Functions.php" + ], + "classmap": [ + "src/" + ] + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "BSD-3-Clause" + ], + "authors": [ + { + "name": "Sebastian Bergmann", + "email": "sebastian@phpunit.de", + "role": "lead" + } + ], + "description": "The PHP Unit Testing framework.", + "homepage": "https://phpunit.de/", + "keywords": [ + "phpunit", + "testing", + "xunit" + ], + "support": { + "issues": "https://github.com/sebastianbergmann/phpunit/issues", + "security": "https://github.com/sebastianbergmann/phpunit/security/policy", + "source": "https://github.com/sebastianbergmann/phpunit/tree/12.5.44" + }, + "funding": [ + { + "url": "https://phpunit.de/sponsoring.html", + "type": "other" + } + ], + "time": "2026-11-13T11:09:06+00:00", + "published-time": "2026-11-13T11:09:57+00:00" + }, + { + "name": "sebastian/cli-parser", + "version": "4.2.1", + "source": { + "type": "git", + "url": "https://github.com/sebastianbergmann/cli-parser.git", + "reference": "7d05781b13f7dec9043a629a21d086ed74582a15" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/sebastianbergmann/cli-parser/zipball/7d05781b13f7dec9043a629a21d086ed74582a15", + "reference": "7d05781b13f7dec9043a629a21d086ed74582a15", + "shasum": "" + }, + "require": { + "php": ">=8.3" + }, + "require-dev": { + "phpunit/phpunit": "^12.5.25" + }, + "type": "library", + "extra": { + "branch-alias": { + "dev-main": "4.2-dev" + } + }, + "autoload": { + "classmap": [ + "src/" + ] + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "BSD-3-Clause" + ], + "authors": [ + { + "name": "Sebastian Bergmann", + "email": "sebastian@phpunit.de", + "role": "lead" + } + ], + "description": "Library for parsing CLI options", + "homepage": "https://github.com/sebastianbergmann/cli-parser", + "support": { + "issues": "https://github.com/sebastianbergmann/cli-parser/issues", + "security": "https://github.com/sebastianbergmann/cli-parser/security/policy", + "source": "https://github.com/sebastianbergmann/cli-parser/tree/4.2.1" + }, + "funding": [ + { + "url": "https://github.com/sebastianbergmann", + "type": "github" + }, + { + "url": "https://liberapay.com/sebastianbergmann", + "type": "liberapay" + }, + { + "url": "https://thanks.dev/u/gh/sebastianbergmann", + "type": "thanks_dev" + }, + { + "url": "https://tidelift.com/funding/github/packagist/sebastian/cli-parser", + "type": "tidelift" + } + ], + "time": "2026-05-17T05:29:34+00:00", + "published-time": "2026-05-17T05:30:34+00:00" + }, + { + "name": "sebastian/comparator", + "version": "7.1.8", + "source": { + "type": "git", + "url": "https://github.com/sebastianbergmann/comparator.git", + "reference": "7c65c1e79836812819705b473a90c12399542485" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/sebastianbergmann/comparator/zipball/7c65c1e79836812819705b473a90c12399542485", + "reference": "7c65c1e79836812819705b473a90c12399542485", + "shasum": "" + }, + "require": { + "ext-dom": "*", + "ext-mbstring": "*", + "php": ">=8.3", + "sebastian/diff": "^7.0", + "sebastian/exporter": "^7.0.3" + }, + "require-dev": { + "phpunit/phpunit": "^12.5.25" + }, + "suggest": { + "ext-bcmath": "For comparing BcMath\\Number objects" + }, + "type": "library", + "extra": { + "branch-alias": { + "dev-main": "7.1-dev" + } + }, + "autoload": { + "classmap": [ + "src/" + ] + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "BSD-3-Clause" + ], + "authors": [ + { + "name": "Sebastian Bergmann", + "email": "sebastian@phpunit.de" + }, + { + "name": "Jeff Welch", + "email": "whatthejeff@gmail.com" + }, + { + "name": "Volker Dusch", + "email": "github@wallbash.com" + }, + { + "name": "Bernhard Schussek", + "email": "bschussek@2bepublished.at" + } + ], + "description": "Provides the functionality to compare PHP values for equality", + "homepage": "https://github.com/sebastianbergmann/comparator", + "keywords": [ + "comparator", + "compare", + "equality" + ], + "support": { + "issues": "https://github.com/sebastianbergmann/comparator/issues", + "security": "https://github.com/sebastianbergmann/comparator/security/policy", + "source": "https://github.com/sebastianbergmann/comparator/tree/7.1.8" + }, + "funding": [ + { + "url": "https://github.com/sebastianbergmann", + "type": "github" + }, + { + "url": "https://liberapay.com/sebastianbergmann", + "type": "liberapay" + }, + { + "url": "https://thanks.dev/u/gh/sebastianbergmann", + "type": "thanks_dev" + }, + { + "url": "https://tidelift.com/funding/github/packagist/sebastian/comparator", + "type": "tidelift" + } + ], + "time": "2026-05-21T04:45:25+00:00", + "published-time": "2026-05-21T04:45:36+00:00" + }, + { + "name": "sebastian/complexity", + "version": "5.0.0", + "source": { + "type": "git", + "url": "https://github.com/sebastianbergmann/complexity.git", + "reference": "bad4316aba5303d0221f43f8cee37eb58d384bbb" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/sebastianbergmann/complexity/zipball/bad4316aba5303d0221f43f8cee37eb58d384bbb", + "reference": "bad4316aba5303d0221f43f8cee37eb58d384bbb", + "shasum": "" + }, + "require": { + "nikic/php-parser": "^5.0", + "php": ">=8.3" + }, + "require-dev": { + "phpunit/phpunit": "^12.0" + }, + "type": "library", + "extra": { + "branch-alias": { + "dev-main": "5.0-dev" + } + }, + "autoload": { + "classmap": [ + "src/" + ] + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "BSD-3-Clause" + ], + "authors": [ + { + "name": "Sebastian Bergmann", + "email": "sebastian@phpunit.de", + "role": "lead" + } + ], + "description": "Library for calculating the complexity of PHP code units", + "homepage": "https://github.com/sebastianbergmann/complexity", + "support": { + "issues": "https://github.com/sebastianbergmann/complexity/issues", + "security": "https://github.com/sebastianbergmann/complexity/security/policy", + "source": "https://github.com/sebastianbergmann/complexity/tree/5.0.0" + }, + "funding": [ + { + "url": "https://github.com/sebastianbergmann", + "type": "github" + } + ], + "time": "2025-02-07T04:55:25+00:00", + "published-time": "2025-02-07T04:55:36+00:00" + }, + { + "name": "sebastian/diff", + "version": "7.0.1", + "source": { + "type": "git", + "url": "https://github.com/sebastianbergmann/diff.git", + "reference": "cd4cabe39f8a4e8ee6818ba99f10a05561ea4ad6" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/sebastianbergmann/diff/zipball/cd4cabe39f8a4e8ee6818ba99f10a05561ea4ad6", + "reference": "cd4cabe39f8a4e8ee6818ba99f10a05561ea4ad6", + "shasum": "" + }, + "require": { + "php": ">=8.3" + }, + "require-dev": { + "phpunit/phpunit": "^12.5.33", + "symfony/process": "^7.4.17" + }, + "type": "library", + "extra": { + "branch-alias": { + "dev-main": "7.0-dev" + } + }, + "autoload": { + "classmap": [ + "src/" + ] + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "BSD-3-Clause" + ], + "authors": [ + { + "name": "Sebastian Bergmann", + "email": "sebastian@phpunit.de" + }, + { + "name": "Kore Nordmann", + "email": "mail@kore-nordmann.de" + } + ], + "description": "Diff implementation", + "homepage": "https://github.com/sebastianbergmann/diff", + "keywords": [ + "diff", + "udiff", + "unidiff", + "unified diff" + ], + "support": { + "issues": "https://github.com/sebastianbergmann/diff/issues", + "security": "https://github.com/sebastianbergmann/diff/security/policy", + "source": "https://github.com/sebastianbergmann/diff/tree/7.0.1" + }, + "funding": [ + { + "url": "https://github.com/sebastianbergmann", + "type": "github" + }, + { + "url": "https://liberapay.com/sebastianbergmann", + "type": "liberapay" + }, + { + "url": "https://thanks.dev/u/gh/sebastianbergmann", + "type": "thanks_dev" + }, + { + "url": "https://tidelift.com/funding/github/packagist/sebastian/diff", + "type": "tidelift" + } + ], + "time": "2026-08-25T15:35:54+00:00", + "published-time": "2026-08-25T15:37:16+00:00" + }, + { + "name": "sebastian/environment", + "version": "8.1.2", + "source": { + "type": "git", + "url": "https://github.com/sebastianbergmann/environment.git", + "reference": "9d32c685773823b1983e256ae4ecd48a10d6e439" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/sebastianbergmann/environment/zipball/9d32c685773823b1983e256ae4ecd48a10d6e439", + "reference": "9d32c685773823b1983e256ae4ecd48a10d6e439", + "shasum": "" + }, + "require": { + "php": ">=8.3" + }, + "require-dev": { + "phpunit/phpunit": "^12.5.26" + }, + "suggest": { + "ext-posix": "*" + }, + "type": "library", + "extra": { + "branch-alias": { + "dev-main": "8.1-dev" + } + }, + "autoload": { + "classmap": [ + "src/" + ] + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "BSD-3-Clause" + ], + "authors": [ + { + "name": "Sebastian Bergmann", + "email": "sebastian@phpunit.de" + } + ], + "description": "Provides functionality to handle HHVM/PHP environments", + "homepage": "https://github.com/sebastianbergmann/environment", + "keywords": [ + "Xdebug", + "environment", + "hhvm" + ], + "support": { + "issues": "https://github.com/sebastianbergmann/environment/issues", + "security": "https://github.com/sebastianbergmann/environment/security/policy", + "source": "https://github.com/sebastianbergmann/environment/tree/8.1.2" + }, + "funding": [ + { + "url": "https://github.com/sebastianbergmann", + "type": "github" + }, + { + "url": "https://liberapay.com/sebastianbergmann", + "type": "liberapay" + }, + { + "url": "https://thanks.dev/u/gh/sebastianbergmann", + "type": "thanks_dev" + }, + { + "url": "https://tidelift.com/funding/github/packagist/sebastian/environment", + "type": "tidelift" + } + ], + "time": "2026-05-25T13:40:20+00:00", + "published-time": "2026-05-25T13:40:39+00:00" + }, + { + "name": "sebastian/exporter", + "version": "7.0.3", + "source": { + "type": "git", + "url": "https://github.com/sebastianbergmann/exporter.git", + "reference": "c5e21b5de653ce0a769fb36f5cdfcb5e7a32cf23" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/sebastianbergmann/exporter/zipball/c5e21b5de653ce0a769fb36f5cdfcb5e7a32cf23", + "reference": "c5e21b5de653ce0a769fb36f5cdfcb5e7a32cf23", + "shasum": "" + }, + "require": { + "ext-mbstring": "*", + "php": ">=8.3", + "sebastian/recursion-context": "^7.0.1" + }, + "require-dev": { + "phpunit/phpunit": "^12.5.25" + }, + "type": "library", + "extra": { + "branch-alias": { + "dev-main": "7.0-dev" + } + }, + "autoload": { + "classmap": [ + "src/" + ] + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "BSD-3-Clause" + ], + "authors": [ + { + "name": "Sebastian Bergmann", + "email": "sebastian@phpunit.de" + }, + { + "name": "Jeff Welch", + "email": "whatthejeff@gmail.com" + }, + { + "name": "Volker Dusch", + "email": "github@wallbash.com" + }, + { + "name": "Adam Harvey", + "email": "aharvey@php.net" + }, + { + "name": "Bernhard Schussek", + "email": "bschussek@gmail.com" + } + ], + "description": "Provides the functionality to export PHP variables for visualization", + "homepage": "https://www.github.com/sebastianbergmann/exporter", + "keywords": [ + "export", + "exporter" + ], + "support": { + "issues": "https://github.com/sebastianbergmann/exporter/issues", + "security": "https://github.com/sebastianbergmann/exporter/security/policy", + "source": "https://github.com/sebastianbergmann/exporter/tree/7.0.3" + }, + "funding": [ + { + "url": "https://github.com/sebastianbergmann", + "type": "github" + }, + { + "url": "https://liberapay.com/sebastianbergmann", + "type": "liberapay" + }, + { + "url": "https://thanks.dev/u/gh/sebastianbergmann", + "type": "thanks_dev" + }, + { + "url": "https://tidelift.com/funding/github/packagist/sebastian/exporter", + "type": "tidelift" + } + ], + "time": "2026-05-20T04:37:17+00:00", + "published-time": "2026-05-20T04:37:31+00:00" + }, + { + "name": "sebastian/global-state", + "version": "8.0.3", + "source": { + "type": "git", + "url": "https://github.com/sebastianbergmann/global-state.git", + "reference": "b164d3274d6537ab462591c5755f76a8f5b1aae9" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/sebastianbergmann/global-state/zipball/b164d3274d6537ab462591c5755f76a8f5b1aae9", + "reference": "b164d3274d6537ab462591c5755f76a8f5b1aae9", + "shasum": "" + }, + "require": { + "php": ">=8.3", + "sebastian/object-reflector": "^5.0", + "sebastian/recursion-context": "^7.0.1" + }, + "require-dev": { + "ext-dom": "*", + "phpunit/phpunit": "^12.5.28" + }, + "type": "library", + "extra": { + "branch-alias": { + "dev-main": "8.0-dev" + } + }, + "autoload": { + "classmap": [ + "src/" + ] + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "BSD-3-Clause" + ], + "authors": [ + { + "name": "Sebastian Bergmann", + "email": "sebastian@phpunit.de" + } + ], + "description": "Snapshotting of global state", + "homepage": "https://www.github.com/sebastianbergmann/global-state", + "keywords": [ + "global state" + ], + "support": { + "issues": "https://github.com/sebastianbergmann/global-state/issues", + "security": "https://github.com/sebastianbergmann/global-state/security/policy", + "source": "https://github.com/sebastianbergmann/global-state/tree/8.0.3" + }, + "funding": [ + { + "url": "https://github.com/sebastianbergmann", + "type": "github" + }, + { + "url": "https://liberapay.com/sebastianbergmann", + "type": "liberapay" + }, + { + "url": "https://thanks.dev/u/gh/sebastianbergmann", + "type": "thanks_dev" + }, + { + "url": "https://tidelift.com/funding/github/packagist/sebastian/global-state", + "type": "tidelift" + } + ], + "time": "2026-06-01T15:10:33+00:00", + "published-time": "2026-06-01T15:20:45+00:00" + }, + { + "name": "sebastian/lines-of-code", + "version": "4.0.1", + "source": { + "type": "git", + "url": "https://github.com/sebastianbergmann/lines-of-code.git", + "reference": "d543b8ef219dcd8da262cbb958639a96bedba10e" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/sebastianbergmann/lines-of-code/zipball/d543b8ef219dcd8da262cbb958639a96bedba10e", + "reference": "d543b8ef219dcd8da262cbb958639a96bedba10e", + "shasum": "" + }, + "require": { + "nikic/php-parser": "^5.7.0", + "php": ">=8.3" + }, + "require-dev": { + "phpunit/phpunit": "^12.5.25" + }, + "type": "library", + "extra": { + "branch-alias": { + "dev-main": "4.0-dev" + } + }, + "autoload": { + "classmap": [ + "src/" + ] + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "BSD-3-Clause" + ], + "authors": [ + { + "name": "Sebastian Bergmann", + "email": "sebastian@phpunit.de", + "role": "lead" + } + ], + "description": "Library for counting the lines of code in PHP source code", + "homepage": "https://github.com/sebastianbergmann/lines-of-code", + "support": { + "issues": "https://github.com/sebastianbergmann/lines-of-code/issues", + "security": "https://github.com/sebastianbergmann/lines-of-code/security/policy", + "source": "https://github.com/sebastianbergmann/lines-of-code/tree/4.0.1" + }, + "funding": [ + { + "url": "https://github.com/sebastianbergmann", + "type": "github" + }, + { + "url": "https://liberapay.com/sebastianbergmann", + "type": "liberapay" + }, + { + "url": "https://thanks.dev/u/gh/sebastianbergmann", + "type": "thanks_dev" + }, + { + "url": "https://tidelift.com/funding/github/packagist/sebastian/lines-of-code", + "type": "tidelift" + } + ], + "time": "2026-05-19T16:22:07+00:00", + "published-time": "2026-05-19T16:22:47+00:00" + }, + { + "name": "sebastian/object-enumerator", + "version": "7.0.0", + "source": { + "type": "git", + "url": "https://github.com/sebastianbergmann/object-enumerator.git", + "reference": "1effe8e9b8e068e9ae228e542d5d11b5d16db894" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/sebastianbergmann/object-enumerator/zipball/1effe8e9b8e068e9ae228e542d5d11b5d16db894", + "reference": "1effe8e9b8e068e9ae228e542d5d11b5d16db894", + "shasum": "" + }, + "require": { + "php": ">=8.3", + "sebastian/object-reflector": "^5.0", + "sebastian/recursion-context": "^7.0" + }, + "require-dev": { + "phpunit/phpunit": "^12.0" + }, + "type": "library", + "extra": { + "branch-alias": { + "dev-main": "7.0-dev" + } + }, + "autoload": { + "classmap": [ + "src/" + ] + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "BSD-3-Clause" + ], + "authors": [ + { + "name": "Sebastian Bergmann", + "email": "sebastian@phpunit.de" + } + ], + "description": "Traverses array structures and object graphs to enumerate all referenced objects", + "homepage": "https://github.com/sebastianbergmann/object-enumerator/", + "support": { + "issues": "https://github.com/sebastianbergmann/object-enumerator/issues", + "security": "https://github.com/sebastianbergmann/object-enumerator/security/policy", + "source": "https://github.com/sebastianbergmann/object-enumerator/tree/7.0.0" + }, + "funding": [ + { + "url": "https://github.com/sebastianbergmann", + "type": "github" + } + ], + "time": "2025-02-07T04:57:48+00:00", + "published-time": "2025-02-07T04:58:08+00:00" + }, + { + "name": "sebastian/object-reflector", + "version": "5.0.0", + "source": { + "type": "git", + "url": "https://github.com/sebastianbergmann/object-reflector.git", + "reference": "4bfa827c969c98be1e527abd576533293c634f6a" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/sebastianbergmann/object-reflector/zipball/4bfa827c969c98be1e527abd576533293c634f6a", + "reference": "4bfa827c969c98be1e527abd576533293c634f6a", + "shasum": "" + }, + "require": { + "php": ">=8.3" + }, + "require-dev": { + "phpunit/phpunit": "^12.0" + }, + "type": "library", + "extra": { + "branch-alias": { + "dev-main": "5.0-dev" + } + }, + "autoload": { + "classmap": [ + "src/" + ] + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "BSD-3-Clause" + ], + "authors": [ + { + "name": "Sebastian Bergmann", + "email": "sebastian@phpunit.de" + } + ], + "description": "Allows reflection of object attributes, including inherited and non-public ones", + "homepage": "https://github.com/sebastianbergmann/object-reflector/", + "support": { + "issues": "https://github.com/sebastianbergmann/object-reflector/issues", + "security": "https://github.com/sebastianbergmann/object-reflector/security/policy", + "source": "https://github.com/sebastianbergmann/object-reflector/tree/5.0.0" + }, + "funding": [ + { + "url": "https://github.com/sebastianbergmann", + "type": "github" + } + ], + "time": "2025-02-07T04:58:17+00:00", + "published-time": "2025-02-07T04:58:28+00:00" + }, + { + "name": "sebastian/recursion-context", + "version": "7.0.1", + "source": { + "type": "git", + "url": "https://github.com/sebastianbergmann/recursion-context.git", + "reference": "0b01998a7d5b1f122911a66bebcb8d46f0c82d8c" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/sebastianbergmann/recursion-context/zipball/0b01998a7d5b1f122911a66bebcb8d46f0c82d8c", + "reference": "0b01998a7d5b1f122911a66bebcb8d46f0c82d8c", + "shasum": "" + }, + "require": { + "php": ">=8.3" + }, + "require-dev": { + "phpunit/phpunit": "^12.0" + }, + "type": "library", + "extra": { + "branch-alias": { + "dev-main": "7.0-dev" + } + }, + "autoload": { + "classmap": [ + "src/" + ] + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "BSD-3-Clause" + ], + "authors": [ + { + "name": "Sebastian Bergmann", + "email": "sebastian@phpunit.de" + }, + { + "name": "Jeff Welch", + "email": "whatthejeff@gmail.com" + }, + { + "name": "Adam Harvey", + "email": "aharvey@php.net" + } + ], + "description": "Provides functionality to recursively process PHP variables", + "homepage": "https://github.com/sebastianbergmann/recursion-context", + "support": { + "issues": "https://github.com/sebastianbergmann/recursion-context/issues", + "security": "https://github.com/sebastianbergmann/recursion-context/security/policy", + "source": "https://github.com/sebastianbergmann/recursion-context/tree/7.0.1" + }, + "funding": [ + { + "url": "https://github.com/sebastianbergmann", + "type": "github" + }, + { + "url": "https://liberapay.com/sebastianbergmann", + "type": "liberapay" + }, + { + "url": "https://thanks.dev/u/gh/sebastianbergmann", + "type": "thanks_dev" + }, + { + "url": "https://tidelift.com/funding/github/packagist/sebastian/recursion-context", + "type": "tidelift" + } + ], + "time": "2025-08-13T04:44:59+00:00", + "published-time": "2025-08-13T04:45:10+00:00" + }, + { + "name": "sebastian/type", + "version": "6.0.4", + "source": { + "type": "git", + "url": "https://github.com/sebastianbergmann/type.git", + "reference": "82ff822c2edc46724be9f7411d3163021f602773" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/sebastianbergmann/type/zipball/82ff822c2edc46724be9f7411d3163021f602773", + "reference": "82ff822c2edc46724be9f7411d3163021f602773", + "shasum": "" + }, + "require": { + "php": ">=8.3" + }, + "require-dev": { + "phpunit/phpunit": "^12.5.25" + }, + "type": "library", + "extra": { + "branch-alias": { + "dev-main": "6.0-dev" + } + }, + "autoload": { + "classmap": [ + "src/" + ] + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "BSD-3-Clause" + ], + "authors": [ + { + "name": "Sebastian Bergmann", + "email": "sebastian@phpunit.de", + "role": "lead" + } + ], + "description": "Collection of value objects that represent the types of the PHP type system", + "homepage": "https://github.com/sebastianbergmann/type", + "support": { + "issues": "https://github.com/sebastianbergmann/type/issues", + "security": "https://github.com/sebastianbergmann/type/security/policy", + "source": "https://github.com/sebastianbergmann/type/tree/6.0.4" + }, + "funding": [ + { + "url": "https://github.com/sebastianbergmann", + "type": "github" + }, + { + "url": "https://liberapay.com/sebastianbergmann", + "type": "liberapay" + }, + { + "url": "https://thanks.dev/u/gh/sebastianbergmann", + "type": "thanks_dev" + }, + { + "url": "https://tidelift.com/funding/github/packagist/sebastian/type", + "type": "tidelift" + } + ], + "time": "2026-05-20T06:45:45+00:00", + "published-time": "2026-05-20T06:50:13+00:00" + }, + { + "name": "sebastian/version", + "version": "6.0.2", + "source": { + "type": "git", + "url": "https://github.com/sebastianbergmann/version.git", + "reference": "a8b6643a19ba6c8125a473623e45fb8cbb0e4159" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/sebastianbergmann/version/zipball/a8b6643a19ba6c8125a473623e45fb8cbb0e4159", + "reference": "a8b6643a19ba6c8125a473623e45fb8cbb0e4159", + "shasum": "" + }, + "require": { + "php": ">=8.3" + }, + "type": "library", + "extra": { + "branch-alias": { + "dev-main": "6.0-dev" + } + }, + "autoload": { + "classmap": [ + "src/" + ] + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "BSD-3-Clause" + ], + "authors": [ + { + "name": "Sebastian Bergmann", + "email": "sebastian@phpunit.de", + "role": "lead" + } + ], + "description": "Library that helps with managing the version number of Git-hosted PHP projects", + "homepage": "https://github.com/sebastianbergmann/version", + "support": { + "issues": "https://github.com/sebastianbergmann/version/issues", + "security": "https://github.com/sebastianbergmann/version/security/policy", + "source": "https://github.com/sebastianbergmann/version/tree/6.0.2" + }, + "funding": [ + { + "url": "https://github.com/sebastianbergmann", + "type": "github" + }, + { + "url": "https://liberapay.com/sebastianbergmann", + "type": "liberapay" + }, + { + "url": "https://thanks.dev/u/gh/sebastianbergmann", + "type": "thanks_dev" + }, + { + "url": "https://tidelift.com/funding/github/packagist/sebastian/version", + "type": "tidelift" + } + ], + "time": "2026-11-09T06:30:55+00:00", + "published-time": "2026-11-09T06:31:20+00:00" + }, + { + "name": "staabm/side-effects-detector", + "version": "1.0.5", + "source": { + "type": "git", + "url": "https://github.com/staabm/side-effects-detector.git", + "reference": "d8334211a140ce329c13726d4a715adbddd0a163" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/staabm/side-effects-detector/zipball/d8334211a140ce329c13726d4a715adbddd0a163", + "reference": "d8334211a140ce329c13726d4a715adbddd0a163", + "shasum": "" + }, + "require": { + "ext-tokenizer": "*", + "php": "^7.4 || ^8.0" + }, + "require-dev": { + "phpstan/extension-installer": "^1.4.3", + "phpstan/phpstan": "^1.12.6", + "phpunit/phpunit": "^9.6.21", + "symfony/var-dumper": "^5.4.43", + "tomasvotruba/type-coverage": "1.0.0", + "tomasvotruba/unused-public": "1.0.0" + }, + "type": "library", + "autoload": { + "classmap": [ + "lib/" + ] + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "description": "A static analysis tool to detect side effects in PHP code", + "keywords": [ + "static analysis" + ], + "support": { + "issues": "https://github.com/staabm/side-effects-detector/issues", + "source": "https://github.com/staabm/side-effects-detector/tree/1.0.5" + }, + "funding": [ + { + "url": "https://github.com/staabm", + "type": "github" + } + ], + "time": "2024-10-20T05:08:20+00:00", + "published-time": "2024-10-20T05:09:39+00:00" + }, + { + "name": "theseer/tokenizer", + "version": "2.0.1", + "source": { + "type": "git", + "url": "https://github.com/theseer/tokenizer.git", + "reference": "7989e43bf381af0eac72e4f0ca5bcbfa81658be4" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/theseer/tokenizer/zipball/7989e43bf381af0eac72e4f0ca5bcbfa81658be4", + "reference": "7989e43bf381af0eac72e4f0ca5bcbfa81658be4", + "shasum": "" + }, + "require": { + "ext-dom": "*", + "ext-tokenizer": "*", + "ext-xmlwriter": "*", + "php": "^8.1" + }, + "type": "library", + "autoload": { + "classmap": [ + "src/" + ] + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "BSD-3-Clause" + ], + "authors": [ + { + "name": "Arne Blankerts", + "email": "arne@blankerts.de", + "role": "Developer" + } + ], + "description": "A small library for converting tokenized PHP source code into XML and potentially other formats", + "support": { + "issues": "https://github.com/theseer/tokenizer/issues", + "source": "https://github.com/theseer/tokenizer/tree/2.0.1" + }, + "funding": [ + { + "url": "https://github.com/theseer", + "type": "github" + } + ], + "time": "2025-12-08T11:19:18+00:00", + "published-time": "2025-12-08T11:19:39+00:00" + } + ], + "aliases": [], + "minimum-stability": "stable", + "stability-flags": {}, + "prefer-stable": true, + "prefer-lowest": false, + "platform": { + "php": "^8.4" + }, + "platform-dev": {}, + "plugin-api-version": "2.11.0" +} diff --git a/config/app.php b/config/app.php new file mode 100644 index 0000000..b091f3c --- /dev/null +++ b/config/app.php @@ -0,0 +1,126 @@ + env('APP_NAME', 'Laravel'), + + /* + |-------------------------------------------------------------------------- + | Application Environment + |-------------------------------------------------------------------------- + | + | This value determines the "environment" your application is currently + | running in. This may determine how you prefer to configure various + | services the application utilizes. Set this in your ".env" file. + | + */ + + 'env' => env('APP_ENV', 'production'), + + /* + |-------------------------------------------------------------------------- + | Application Debug Mode + |-------------------------------------------------------------------------- + | + | When your application is in debug mode, detailed error messages with + | stack traces will be shown on every error that occurs within your + | application. If disabled, a simple generic error page is shown. + | + */ + + 'debug' => (bool) env('APP_DEBUG', false), + + /* + |-------------------------------------------------------------------------- + | Application URL + |-------------------------------------------------------------------------- + | + | This URL is used by the console to properly generate URLs when using + | the Artisan command line tool. You should set this to the root of + | the application so that it's available within Artisan commands. + | + */ + + 'url' => env('APP_URL', 'http://localhost'), + + /* + |-------------------------------------------------------------------------- + | Application Timezone + |-------------------------------------------------------------------------- + | + | Here you may specify the default timezone for your application, which + | will be used by the PHP date and date-time functions. The timezone + | is set to "UTC" by default as it is suitable for most use cases. + | + */ + + 'timezone' => 'UTC', + + /* + |-------------------------------------------------------------------------- + | Application Locale Configuration + |-------------------------------------------------------------------------- + | + | The application locale determines the default locale that will be used + | by Laravel's translation / localization methods. This option can be + | set to any locale for which you plan to have translation strings. + | + */ + + 'locale' => env('APP_LOCALE', 'de'), + + 'fallback_locale' => env('APP_FALLBACK_LOCALE', 'en'), + + 'faker_locale' => env('APP_FAKER_LOCALE', 'en_US'), + + /* + |-------------------------------------------------------------------------- + | Encryption Key + |-------------------------------------------------------------------------- + | + | This key is utilized by Laravel's encryption services and should be set + | to a random, 32 character string to ensure that all encrypted values + | are secure. You should do this prior to deploying the application. + | + */ + + 'cipher' => 'AES-256-CBC', + + 'key' => env('APP_KEY'), + + 'previous_keys' => [ + ...array_filter( + explode(',', (string) env('APP_PREVIOUS_KEYS', '')) + ), + ], + + /* + |-------------------------------------------------------------------------- + | Maintenance Mode Driver + |-------------------------------------------------------------------------- + | + | These configuration options determine the driver used to determine and + | manage Laravel's "maintenance mode" status. The "cache" driver will + | allow maintenance mode to be controlled across multiple machines. + | + | Supported drivers: "file", "cache", "array" + | + */ + + 'maintenance' => [ + 'driver' => env('APP_MAINTENANCE_DRIVER', 'file'), + 'store' => env('APP_MAINTENANCE_STORE', 'database'), + ], + +]; diff --git a/config/auth.php b/config/auth.php new file mode 100644 index 0000000..ceb9d9e --- /dev/null +++ b/config/auth.php @@ -0,0 +1,122 @@ + [ + 'guard' => env('AUTH_GUARD', 'web'), + 'passwords' => env('AUTH_PASSWORD_BROKER', 'users'), + ], + + /* + |-------------------------------------------------------------------------- + | Authentication Guards + |-------------------------------------------------------------------------- + | + | Next, you may define every authentication guard for your application. + | Of course, a great default configuration has been defined for you + | which utilizes session storage plus the Eloquent user provider. + | + | All authentication guards have a user provider, which defines how the + | users are actually retrieved out of your database or other storage + | system used by the application. Typically, Eloquent is utilized. + | + | Supported: "session" + | + */ + + 'guards' => [ + 'web' => [ + 'driver' => 'session', + 'provider' => 'users', + ], + + 'staff' => [ + 'driver' => 'session', + 'provider' => 'users', + ], + ], + + /* + |-------------------------------------------------------------------------- + | User Providers + |-------------------------------------------------------------------------- + | + | All authentication guards have a user provider, which defines how the + | users are actually retrieved out of your database or other storage + | system used by the application. Typically, Eloquent is utilized. + | + | If you have multiple user tables or models you may configure multiple + | providers to represent the model / table. These providers may then + | be assigned to any extra authentication guards you have defined. + | + | Supported: "database", "eloquent" + | + */ + + 'providers' => [ + 'users' => [ + 'driver' => 'eloquent', + 'model' => env('AUTH_MODEL', User::class), + ], + + // 'users' => [ + // 'driver' => 'database', + // 'table' => 'users', + // ], + ], + + /* + |-------------------------------------------------------------------------- + | Resetting Passwords + |-------------------------------------------------------------------------- + | + | These configuration options specify the behavior of Laravel's password + | reset functionality, including the table utilized for token storage + | and the user provider that is invoked to actually retrieve users. + | + | The expiry time is the number of minutes that each reset token will be + | considered valid. This security feature keeps tokens short-lived so + | they have less time to be guessed. You may change this as needed. + | + | The throttle setting is the number of seconds a user must wait before + | generating more password reset tokens. This prevents the user from + | quickly generating a very large amount of password reset tokens. + | + */ + + 'passwords' => [ + 'users' => [ + 'provider' => 'users', + 'table' => env('AUTH_PASSWORD_RESET_TOKEN_TABLE', 'password_reset_tokens'), + 'expire' => 60, + 'throttle' => 60, + ], + ], + + /* + |-------------------------------------------------------------------------- + | Password Confirmation Timeout + |-------------------------------------------------------------------------- + | + | Here you may define the number of seconds before a password confirmation + | window expires and users are asked to re-enter their password via the + | confirmation screen. By default, the timeout lasts for three hours. + | + */ + + 'password_timeout' => env('AUTH_PASSWORD_TIMEOUT', 10800), + +]; diff --git a/config/cache.php b/config/cache.php new file mode 100644 index 0000000..d88a596 --- /dev/null +++ b/config/cache.php @@ -0,0 +1,136 @@ + env('CACHE_STORE', 'database'), + + /* + |-------------------------------------------------------------------------- + | Cache Stores + |-------------------------------------------------------------------------- + | + | Here you may define all of the cache "stores" for your application as + | well as their drivers. You may even define multiple stores for the + | same cache driver to group types of items stored in your caches. + | + | Supported drivers: "array", "database", "file", "memcached", + | "redis", "dynamodb", "storage", "octane", + | "session", "failover", "null" + | + */ + + 'stores' => [ + + 'array' => [ + 'driver' => 'array', + 'serialize' => false, + ], + + 'database' => [ + 'driver' => 'database', + 'connection' => env('DB_CACHE_CONNECTION'), + 'table' => env('DB_CACHE_TABLE', 'cache'), + 'lock_connection' => env('DB_CACHE_LOCK_CONNECTION'), + 'lock_table' => env('DB_CACHE_LOCK_TABLE'), + ], + + 'file' => [ + 'driver' => 'file', + 'path' => storage_path('framework/cache/data'), + 'lock_path' => storage_path('framework/cache/locks'), + ], + + 'storage' => [ + 'driver' => 'storage', + 'disk' => env('CACHE_STORAGE_DISK'), + 'path' => env('CACHE_STORAGE_PATH', 'framework/cache/data'), + ], + + 'memcached' => [ + 'driver' => 'memcached', + 'persistent_id' => env('MEMCACHED_PERSISTENT_ID'), + 'sasl' => [ + env('MEMCACHED_USERNAME'), + env('MEMCACHED_PASSWORD'), + ], + 'options' => [ + // Memcached::OPT_CONNECT_TIMEOUT => 2000, + ], + 'servers' => [ + [ + 'host' => env('MEMCACHED_HOST', '127.0.0.1'), + 'port' => env('MEMCACHED_PORT', 11211), + 'weight' => 100, + ], + ], + ], + + 'redis' => [ + 'driver' => 'redis', + 'connection' => env('REDIS_CACHE_CONNECTION', 'cache'), + 'lock_connection' => env('REDIS_CACHE_LOCK_CONNECTION', 'default'), + ], + + 'dynamodb' => [ + 'driver' => 'dynamodb', + 'key' => env('AWS_ACCESS_KEY_ID'), + 'secret' => env('AWS_SECRET_ACCESS_KEY'), + 'region' => env('AWS_DEFAULT_REGION', 'us-east-1'), + 'table' => env('DYNAMODB_CACHE_TABLE', 'cache'), + 'endpoint' => env('DYNAMODB_ENDPOINT'), + ], + + 'octane' => [ + 'driver' => 'octane', + ], + + 'failover' => [ + 'driver' => 'failover', + 'stores' => [ + 'database', + 'array', + ], + ], + + ], + + /* + |-------------------------------------------------------------------------- + | Cache Key Prefix + |-------------------------------------------------------------------------- + | + | When utilizing the APC, database, memcached, Redis, and DynamoDB cache + | stores, there might be other applications using the same cache. For + | that reason, you may prefix every cache key to avoid collisions. + | + */ + + 'prefix' => env('CACHE_PREFIX', Str::slug((string) env('APP_NAME', 'laravel')).'-cache-'), + + /* + |-------------------------------------------------------------------------- + | Serializable Classes + |-------------------------------------------------------------------------- + | + | This value determines the classes that can be unserialized from cache + | storage. By default, no PHP classes will be unserialized from your + | cache to prevent gadget chain attacks if your APP_KEY is leaked. + | + */ + + 'serializable_classes' => false, + +]; diff --git a/config/cms.php b/config/cms.php new file mode 100644 index 0000000..937e1a0 --- /dev/null +++ b/config/cms.php @@ -0,0 +1,53 @@ +.blade.php, hier eintragen. Siehe docs/architektur/cms-widget-registry.md. + | Eine einmal verwendete Kennung wird nie entfernt, solange Revisionen sie enthalten. + */ + 'widgets' => [ + HeroWidget::class, + HeadingWidget::class, + ProseWidget::class, + ImageTextWidget::class, + CardsWidget::class, + CatalogCardsWidget::class, + TopicCardWidget::class, + MediaCardWidget::class, + ProgramCardWidget::class, + CallToActionWidget::class, + FaqWidget::class, + ], + + /* + | Seitenvorlagen. Für diesen Ausbau gibt es eine Vorlage; weitere werden hier ergänzt. + */ + 'templates' => [ + 'standard' => 'site.templates.standard', + ], + + /* + | Vorbereiteter Warenkorbzugang in der Kopfzeile. Der Warenkorb ist Teil des kommerziellen Anwendungssystems + | und noch nicht umgesetzt; solange enabled false ist, erscheint kein Warenkorbsymbol. + */ + 'cart' => [ + 'enabled' => (bool) env('LUF_CART_ENABLED', false), + 'url' => env('LUF_CART_URL'), + ], + +]; diff --git a/config/database.php b/config/database.php new file mode 100644 index 0000000..abbb88e --- /dev/null +++ b/config/database.php @@ -0,0 +1,184 @@ + env('DB_CONNECTION', 'sqlite'), + + /* + |-------------------------------------------------------------------------- + | Database Connections + |-------------------------------------------------------------------------- + | + | Below are all of the database connections defined for your application. + | An example configuration is provided for each database system which + | is supported by Laravel. You're free to add / remove connections. + | + */ + + 'connections' => [ + + 'sqlite' => [ + 'driver' => 'sqlite', + 'url' => env('DB_URL'), + 'database' => env('DB_DATABASE', database_path('database.sqlite')), + 'prefix' => '', + 'foreign_key_constraints' => env('DB_FOREIGN_KEYS', true), + 'busy_timeout' => null, + 'journal_mode' => null, + 'synchronous' => null, + 'transaction_mode' => 'DEFERRED', + ], + + 'mysql' => [ + 'driver' => 'mysql', + 'url' => env('DB_URL'), + 'host' => env('DB_HOST', '127.0.0.1'), + 'port' => env('DB_PORT', '3306'), + 'database' => env('DB_DATABASE', 'laravel'), + 'username' => env('DB_USERNAME', 'root'), + 'password' => env('DB_PASSWORD', ''), + 'unix_socket' => env('DB_SOCKET', ''), + 'charset' => env('DB_CHARSET', 'utf8mb4'), + 'collation' => env('DB_COLLATION', 'utf8mb4_unicode_ci'), + 'prefix' => '', + 'prefix_indexes' => true, + 'strict' => true, + 'engine' => null, + 'options' => extension_loaded('pdo_mysql') ? array_filter([ + Mysql::ATTR_SSL_CA => env('MYSQL_ATTR_SSL_CA'), + ]) : [], + ], + + 'mariadb' => [ + 'driver' => 'mariadb', + 'url' => env('DB_URL'), + 'host' => env('DB_HOST', '127.0.0.1'), + 'port' => env('DB_PORT', '3306'), + 'database' => env('DB_DATABASE', 'laravel'), + 'username' => env('DB_USERNAME', 'root'), + 'password' => env('DB_PASSWORD', ''), + 'unix_socket' => env('DB_SOCKET', ''), + 'charset' => env('DB_CHARSET', 'utf8mb4'), + 'collation' => env('DB_COLLATION', 'utf8mb4_unicode_ci'), + 'prefix' => '', + 'prefix_indexes' => true, + 'strict' => true, + 'engine' => null, + 'options' => extension_loaded('pdo_mysql') ? array_filter([ + Mysql::ATTR_SSL_CA => env('MYSQL_ATTR_SSL_CA'), + ]) : [], + ], + + 'pgsql' => [ + 'driver' => 'pgsql', + 'url' => env('DB_URL'), + 'host' => env('DB_HOST', '127.0.0.1'), + 'port' => env('DB_PORT', '5432'), + 'database' => env('DB_DATABASE', 'laravel'), + 'username' => env('DB_USERNAME', 'root'), + 'password' => env('DB_PASSWORD', ''), + 'charset' => env('DB_CHARSET', 'utf8'), + 'prefix' => '', + 'prefix_indexes' => true, + 'search_path' => 'public', + 'sslmode' => env('DB_SSLMODE', 'prefer'), + ], + + 'sqlsrv' => [ + 'driver' => 'sqlsrv', + 'url' => env('DB_URL'), + 'host' => env('DB_HOST', 'localhost'), + 'port' => env('DB_PORT', '1433'), + 'database' => env('DB_DATABASE', 'laravel'), + 'username' => env('DB_USERNAME', 'root'), + 'password' => env('DB_PASSWORD', ''), + 'charset' => env('DB_CHARSET', 'utf8'), + 'prefix' => '', + 'prefix_indexes' => true, + // 'encrypt' => env('DB_ENCRYPT', 'yes'), + // 'trust_server_certificate' => env('DB_TRUST_SERVER_CERTIFICATE', 'false'), + ], + + ], + + /* + |-------------------------------------------------------------------------- + | Migration Repository Table + |-------------------------------------------------------------------------- + | + | This table keeps track of all the migrations that have already run for + | your application. Using this information, we can determine which of + | the migrations on disk haven't actually been run on the database. + | + */ + + 'migrations' => [ + 'table' => 'migrations', + 'update_date_on_publish' => true, + ], + + /* + |-------------------------------------------------------------------------- + | Redis Databases + |-------------------------------------------------------------------------- + | + | Redis is an open source, fast, and advanced key-value store that also + | provides a richer body of commands than a typical key-value system + | such as Memcached. You may define your connection settings here. + | + */ + + 'redis' => [ + + 'client' => env('REDIS_CLIENT', 'phpredis'), + + 'options' => [ + 'cluster' => env('REDIS_CLUSTER', 'redis'), + 'prefix' => env('REDIS_PREFIX', Str::slug((string) env('APP_NAME', 'laravel')).'-database-'), + 'persistent' => env('REDIS_PERSISTENT', false), + ], + + 'default' => [ + 'url' => env('REDIS_URL'), + 'host' => env('REDIS_HOST', '127.0.0.1'), + 'username' => env('REDIS_USERNAME'), + 'password' => env('REDIS_PASSWORD'), + 'port' => env('REDIS_PORT', '6379'), + 'database' => env('REDIS_DB', '0'), + 'max_retries' => env('REDIS_MAX_RETRIES', 3), + 'backoff_algorithm' => env('REDIS_BACKOFF_ALGORITHM', 'decorrelated_jitter'), + 'backoff_base' => env('REDIS_BACKOFF_BASE', 100), + 'backoff_cap' => env('REDIS_BACKOFF_CAP', 1000), + ], + + 'cache' => [ + 'url' => env('REDIS_URL'), + 'host' => env('REDIS_HOST', '127.0.0.1'), + 'username' => env('REDIS_USERNAME'), + 'password' => env('REDIS_PASSWORD'), + 'port' => env('REDIS_PORT', '6379'), + 'database' => env('REDIS_CACHE_DB', '1'), + 'max_retries' => env('REDIS_MAX_RETRIES', 3), + 'backoff_algorithm' => env('REDIS_BACKOFF_ALGORITHM', 'decorrelated_jitter'), + 'backoff_base' => env('REDIS_BACKOFF_BASE', 100), + 'backoff_cap' => env('REDIS_BACKOFF_CAP', 1000), + ], + + ], + +]; diff --git a/config/filesystems.php b/config/filesystems.php new file mode 100644 index 0000000..e36fcc9 --- /dev/null +++ b/config/filesystems.php @@ -0,0 +1,108 @@ + env('FILESYSTEM_DISK', 'local'), + + /* + |-------------------------------------------------------------------------- + | Filesystem Disks + |-------------------------------------------------------------------------- + | + | Below you may configure as many filesystem disks as necessary, and you + | may even configure multiple disks for the same driver. Examples for + | most supported storage drivers are configured here for reference. + | + | Supported drivers: "local", "ftp", "sftp", "s3" + | + */ + + 'disks' => [ + + 'local' => [ + 'driver' => 'local', + 'root' => storage_path('app/private'), + 'serve' => true, + 'throw' => false, + 'report' => false, + ], + + 'public' => [ + 'driver' => 'local', + 'root' => storage_path('app/public'), + 'url' => rtrim(env('APP_URL', 'http://localhost'), '/').'/storage', + 'visibility' => 'public', + 'throw' => false, + 'report' => false, + ], + + 'cms_incoming' => [ + 'driver' => 'local', + 'root' => storage_path('app/private/cms-incoming'), + 'throw' => false, + 'report' => false, + ], + + 'media_public' => [ + 'driver' => 'local', + 'root' => env('MEDIA_PUBLIC_PATH') ?: storage_path('app/media-public'), + 'throw' => false, + 'report' => false, + ], + + 'media_derived' => [ + 'driver' => 'local', + 'root' => env('MEDIA_DERIVED_PATH') ?: storage_path('app/media-derived'), + 'throw' => false, + 'report' => false, + ], + + 'media_originals' => [ + 'driver' => 'local', + 'root' => env('MEDIA_ORIGINALS_PATH') ?: storage_path('app/media-originals'), + 'throw' => false, + 'report' => false, + ], + + 's3' => [ + 'driver' => 's3', + 'key' => env('AWS_ACCESS_KEY_ID'), + 'secret' => env('AWS_SECRET_ACCESS_KEY'), + 'region' => env('AWS_DEFAULT_REGION'), + 'bucket' => env('AWS_BUCKET'), + 'url' => env('AWS_URL'), + 'endpoint' => env('AWS_ENDPOINT'), + 'use_path_style_endpoint' => env('AWS_USE_PATH_STYLE_ENDPOINT', false), + 'throw' => false, + 'report' => false, + ], + + ], + + /* + |-------------------------------------------------------------------------- + | Symbolic Links + |-------------------------------------------------------------------------- + | + | Here you may configure the symbolic links that will be created when the + | `storage:link` Artisan command is executed. The array keys should be + | the locations of the links and the values should be their targets. + | + */ + + 'links' => [ + public_path('storage') => storage_path('app/public'), + ], + +]; diff --git a/config/logging.php b/config/logging.php new file mode 100644 index 0000000..97bdc03 --- /dev/null +++ b/config/logging.php @@ -0,0 +1,140 @@ + env('LOG_CHANNEL', 'stack'), + + /* + |-------------------------------------------------------------------------- + | Deprecations Log Channel + |-------------------------------------------------------------------------- + | + | This option controls the log channel that should be used to log warnings + | regarding deprecated PHP and library features. This allows you to get + | your application ready for upcoming major versions of dependencies. + | + */ + + 'deprecations' => [ + 'channel' => env('LOG_DEPRECATIONS_CHANNEL', 'null'), + 'trace' => env('LOG_DEPRECATIONS_TRACE', false), + ], + + /* + |-------------------------------------------------------------------------- + | Log Channels + |-------------------------------------------------------------------------- + | + | Here you may configure the log channels for your application. Laravel + | utilizes the Monolog PHP logging library, which includes a variety + | of powerful log handlers and formatters that you're free to use. + | + | Available drivers: "single", "daily", "monthly", "slack", "syslog", + | "errorlog", "monolog", "custom", "stack" + | + */ + + 'channels' => [ + + 'stack' => [ + 'driver' => 'stack', + 'channels' => explode(',', (string) env('LOG_STACK', 'single')), + 'ignore_exceptions' => false, + ], + + 'single' => [ + 'driver' => 'single', + 'path' => storage_path('logs/laravel.log'), + 'level' => env('LOG_LEVEL', 'debug'), + 'replace_placeholders' => true, + ], + + 'daily' => [ + 'driver' => 'daily', + 'path' => storage_path('logs/laravel.log'), + 'level' => env('LOG_LEVEL', 'debug'), + 'max_files' => env('LOG_DAILY_DAYS', 14), + 'replace_placeholders' => true, + ], + + 'monthly' => [ + 'driver' => 'monthly', + 'path' => storage_path('logs/laravel.log'), + 'level' => env('LOG_LEVEL', 'debug'), + 'max_files' => 3, + 'replace_placeholders' => true, + ], + + 'slack' => [ + 'driver' => 'slack', + 'url' => env('LOG_SLACK_WEBHOOK_URL'), + 'username' => env('LOG_SLACK_USERNAME', env('APP_NAME', 'Laravel')), + 'emoji' => env('LOG_SLACK_EMOJI', ':boom:'), + 'level' => env('LOG_LEVEL', 'critical'), + 'replace_placeholders' => true, + ], + + 'papertrail' => [ + 'driver' => 'monolog', + 'level' => env('LOG_LEVEL', 'debug'), + 'handler' => env('LOG_PAPERTRAIL_HANDLER', SyslogUdpHandler::class), + 'handler_with' => [ + 'host' => env('PAPERTRAIL_URL'), + 'port' => env('PAPERTRAIL_PORT'), + 'connectionString' => 'tls://'.env('PAPERTRAIL_URL').':'.env('PAPERTRAIL_PORT'), + ], + 'processors' => [PsrLogMessageProcessor::class], + ], + + 'stderr' => [ + 'driver' => 'monolog', + 'level' => env('LOG_LEVEL', 'debug'), + 'handler' => StreamHandler::class, + 'handler_with' => [ + 'stream' => 'php://stderr', + ], + 'formatter' => env('LOG_STDERR_FORMATTER'), + 'processors' => [PsrLogMessageProcessor::class], + ], + + 'syslog' => [ + 'driver' => 'syslog', + 'level' => env('LOG_LEVEL', 'debug'), + 'facility' => env('LOG_SYSLOG_FACILITY', LOG_USER), + 'replace_placeholders' => true, + ], + + 'errorlog' => [ + 'driver' => 'errorlog', + 'level' => env('LOG_LEVEL', 'debug'), + 'replace_placeholders' => true, + ], + + 'null' => [ + 'driver' => 'monolog', + 'handler' => NullHandler::class, + ], + + 'emergency' => [ + 'path' => storage_path('logs/laravel.log'), + ], + + ], + +]; diff --git a/config/mail.php b/config/mail.php new file mode 100644 index 0000000..e32e88d --- /dev/null +++ b/config/mail.php @@ -0,0 +1,118 @@ + env('MAIL_MAILER', 'log'), + + /* + |-------------------------------------------------------------------------- + | Mailer Configurations + |-------------------------------------------------------------------------- + | + | Here you may configure all of the mailers used by your application plus + | their respective settings. Several examples have been configured for + | you and you are free to add your own as your application requires. + | + | Laravel supports a variety of mail "transport" drivers that can be used + | when delivering an email. You may specify which one you're using for + | your mailers below. You may also add additional mailers if needed. + | + | Supported: "smtp", "sendmail", "mailgun", "ses", "ses-v2", + | "postmark", "resend", "log", "array", + | "failover", "roundrobin" + | + */ + + 'mailers' => [ + + 'smtp' => [ + 'transport' => 'smtp', + 'scheme' => env('MAIL_SCHEME'), + 'url' => env('MAIL_URL'), + 'host' => env('MAIL_HOST', '127.0.0.1'), + 'port' => env('MAIL_PORT', 2525), + 'username' => env('MAIL_USERNAME'), + 'password' => env('MAIL_PASSWORD'), + 'timeout' => null, + 'local_domain' => env('MAIL_EHLO_DOMAIN', parse_url((string) env('APP_URL', 'http://localhost'), PHP_URL_HOST)), + ], + + 'ses' => [ + 'transport' => 'ses', + ], + + 'postmark' => [ + 'transport' => 'postmark', + // 'message_stream_id' => env('POSTMARK_MESSAGE_STREAM_ID'), + // 'client' => [ + // 'timeout' => 5, + // ], + ], + + 'resend' => [ + 'transport' => 'resend', + ], + + 'sendmail' => [ + 'transport' => 'sendmail', + 'path' => env('MAIL_SENDMAIL_PATH', '/usr/sbin/sendmail -bs -i'), + ], + + 'log' => [ + 'transport' => 'log', + 'channel' => env('MAIL_LOG_CHANNEL'), + ], + + 'array' => [ + 'transport' => 'array', + ], + + 'failover' => [ + 'transport' => 'failover', + 'mailers' => [ + 'smtp', + 'log', + ], + 'retry_after' => 60, + ], + + 'roundrobin' => [ + 'transport' => 'roundrobin', + 'mailers' => [ + 'ses', + 'postmark', + ], + 'retry_after' => 60, + ], + + ], + + /* + |-------------------------------------------------------------------------- + | Global "From" Address + |-------------------------------------------------------------------------- + | + | You may wish for all emails sent by your application to be sent from + | the same address. Here you may specify a name and address that is + | used globally for all emails that are sent by your application. + | + */ + + 'from' => [ + 'address' => env('MAIL_FROM_ADDRESS', 'hello@example.com'), + 'name' => env('MAIL_FROM_NAME', env('APP_NAME', 'Laravel')), + ], + +]; diff --git a/config/queue.php b/config/queue.php new file mode 100644 index 0000000..59ad6b8 --- /dev/null +++ b/config/queue.php @@ -0,0 +1,129 @@ + env('QUEUE_CONNECTION', 'database'), + + /* + |-------------------------------------------------------------------------- + | Queue Connections + |-------------------------------------------------------------------------- + | + | Here you may configure the connection options for every queue backend + | used by your application. An example configuration is provided for + | each backend supported by Laravel. You're also free to add more. + | + | Drivers: "sync", "database", "beanstalkd", "sqs", "redis", + | "deferred", "background", "failover", "null" + | + */ + + 'connections' => [ + + 'sync' => [ + 'driver' => 'sync', + ], + + 'database' => [ + 'driver' => 'database', + 'connection' => env('DB_QUEUE_CONNECTION'), + 'table' => env('DB_QUEUE_TABLE', 'jobs'), + 'queue' => env('DB_QUEUE', 'default'), + 'retry_after' => (int) env('DB_QUEUE_RETRY_AFTER', 3660), + 'after_commit' => false, + ], + + 'beanstalkd' => [ + 'driver' => 'beanstalkd', + 'host' => env('BEANSTALKD_QUEUE_HOST', 'localhost'), + 'queue' => env('BEANSTALKD_QUEUE', 'default'), + 'retry_after' => (int) env('BEANSTALKD_QUEUE_RETRY_AFTER', 90), + 'block_for' => 0, + 'after_commit' => false, + ], + + 'sqs' => [ + 'driver' => 'sqs', + 'key' => env('AWS_ACCESS_KEY_ID'), + 'secret' => env('AWS_SECRET_ACCESS_KEY'), + 'prefix' => env('SQS_PREFIX', 'https://sqs.us-east-1.amazonaws.com/your-account-id'), + 'queue' => env('SQS_QUEUE', 'default'), + 'suffix' => env('SQS_SUFFIX'), + 'region' => env('AWS_DEFAULT_REGION', 'us-east-1'), + 'after_commit' => false, + ], + + 'redis' => [ + 'driver' => 'redis', + 'connection' => env('REDIS_QUEUE_CONNECTION', 'default'), + 'queue' => env('REDIS_QUEUE', 'default'), + 'retry_after' => (int) env('REDIS_QUEUE_RETRY_AFTER', 90), + 'block_for' => null, + 'after_commit' => false, + ], + + 'deferred' => [ + 'driver' => 'deferred', + ], + + 'background' => [ + 'driver' => 'background', + ], + + 'failover' => [ + 'driver' => 'failover', + 'connections' => [ + 'database', + 'deferred', + ], + ], + + ], + + /* + |-------------------------------------------------------------------------- + | Job Batching + |-------------------------------------------------------------------------- + | + | The following options configure the database and table that store job + | batching information. These options can be updated to any database + | connection and table which has been defined by your application. + | + */ + + 'batching' => [ + 'database' => env('DB_CONNECTION', 'sqlite'), + 'table' => 'job_batches', + ], + + /* + |-------------------------------------------------------------------------- + | Failed Queue Jobs + |-------------------------------------------------------------------------- + | + | These options configure the behavior of failed queue job logging so you + | can control how and where failed jobs are stored. Laravel ships with + | support for storing failed jobs in a simple file or in a database. + | + | Supported drivers: "database-uuids", "dynamodb", "file", "null" + | + */ + + 'failed' => [ + 'driver' => env('QUEUE_FAILED_DRIVER', 'database-uuids'), + 'database' => env('DB_CONNECTION', 'sqlite'), + 'table' => 'failed_jobs', + ], + +]; diff --git a/config/services.php b/config/services.php new file mode 100644 index 0000000..1346f70 --- /dev/null +++ b/config/services.php @@ -0,0 +1,42 @@ + [ + 'key' => env('POSTMARK_API_KEY'), + ], + + 'resend' => [ + 'key' => env('RESEND_API_KEY'), + ], + + 'ses' => [ + 'key' => env('AWS_ACCESS_KEY_ID'), + 'secret' => env('AWS_SECRET_ACCESS_KEY'), + 'region' => env('AWS_DEFAULT_REGION', 'us-east-1'), + ], + + 'payment' => [ + 'driver' => env('PAYMENT_DRIVER', 'test'), + ], + + 'slack' => [ + 'notifications' => [ + 'bot_user_oauth_token' => env('SLACK_BOT_USER_OAUTH_TOKEN'), + 'channel' => env('SLACK_BOT_USER_DEFAULT_CHANNEL'), + ], + ], + +]; diff --git a/config/session.php b/config/session.php new file mode 100644 index 0000000..f574482 --- /dev/null +++ b/config/session.php @@ -0,0 +1,233 @@ + env('SESSION_DRIVER', 'database'), + + /* + |-------------------------------------------------------------------------- + | Session Lifetime + |-------------------------------------------------------------------------- + | + | Here you may specify the number of minutes that you wish the session + | to be allowed to remain idle before it expires. If you want them + | to expire immediately when the browser is closed then you may + | indicate that via the expire_on_close configuration option. + | + */ + + 'lifetime' => (int) env('SESSION_LIFETIME', 120), + + 'expire_on_close' => env('SESSION_EXPIRE_ON_CLOSE', false), + + /* + |-------------------------------------------------------------------------- + | Session Encryption + |-------------------------------------------------------------------------- + | + | This option allows you to easily specify that all of your session data + | should be encrypted before it's stored. All encryption is performed + | automatically by Laravel and you may use the session like normal. + | + */ + + 'encrypt' => env('SESSION_ENCRYPT', false), + + /* + |-------------------------------------------------------------------------- + | Session File Location + |-------------------------------------------------------------------------- + | + | When utilizing the "file" session driver, the session files are placed + | on disk. The default storage location is defined here; however, you + | are free to provide another location where they should be stored. + | + */ + + 'files' => storage_path('framework/sessions'), + + /* + |-------------------------------------------------------------------------- + | Session Database Connection + |-------------------------------------------------------------------------- + | + | When using the "database" or "redis" session drivers, you may specify a + | connection that should be used to manage these sessions. This should + | correspond to a connection in your database configuration options. + | + */ + + 'connection' => env('SESSION_CONNECTION'), + + /* + |-------------------------------------------------------------------------- + | Session Database Table + |-------------------------------------------------------------------------- + | + | When using the "database" session driver, you may specify the table to + | be used to store sessions. Of course, a sensible default is defined + | for you; however, you're welcome to change this to another table. + | + */ + + 'table' => env('SESSION_TABLE', 'sessions'), + + /* + |-------------------------------------------------------------------------- + | Session Cache Store + |-------------------------------------------------------------------------- + | + | When using one of the framework's cache driven session backends, you may + | define the cache store which should be used to store the session data + | between requests. This must match one of your defined cache stores. + | + | Affects: "dynamodb", "memcached", "redis" + | + */ + + 'store' => env('SESSION_STORE'), + + /* + |-------------------------------------------------------------------------- + | Session Sweeping Lottery + |-------------------------------------------------------------------------- + | + | Some session drivers must manually sweep their storage location to get + | rid of old sessions from storage. Here are the chances that it will + | happen on a given request. By default, the odds are 2 out of 100. + | + */ + + 'lottery' => [2, 100], + + /* + |-------------------------------------------------------------------------- + | Session Cookie Name + |-------------------------------------------------------------------------- + | + | Here you may change the name of the session cookie that is created by + | the framework. Typically, you should not need to change this value + | since doing so does not grant a meaningful security improvement. + | + */ + + 'cookie' => env( + 'SESSION_COOKIE', + Str::slug((string) env('APP_NAME', 'laravel')).'-session' + ), + + /* + |-------------------------------------------------------------------------- + | Session Cookie Path + |-------------------------------------------------------------------------- + | + | The session cookie path determines the path for which the cookie will + | be regarded as available. Typically, this will be the root path of + | your application, but you're free to change this when necessary. + | + */ + + 'path' => env('SESSION_PATH', '/'), + + /* + |-------------------------------------------------------------------------- + | Session Cookie Domain + |-------------------------------------------------------------------------- + | + | This value determines the domain and subdomains the session cookie is + | available to. By default, the cookie will be available to the root + | domain without subdomains. Typically, this shouldn't be changed. + | + */ + + 'domain' => env('SESSION_DOMAIN'), + + /* + |-------------------------------------------------------------------------- + | HTTPS Only Cookies + |-------------------------------------------------------------------------- + | + | By setting this option to true, session cookies will only be sent back + | to the server if the browser has a HTTPS connection. This will keep + | the cookie from being sent to you when it can't be done securely. + | + */ + + 'secure' => env('SESSION_SECURE_COOKIE'), + + /* + |-------------------------------------------------------------------------- + | HTTP Access Only + |-------------------------------------------------------------------------- + | + | Setting this value to true will prevent JavaScript from accessing the + | value of the cookie and the cookie will only be accessible through + | the HTTP protocol. It's unlikely you should disable this option. + | + */ + + 'http_only' => env('SESSION_HTTP_ONLY', true), + + /* + |-------------------------------------------------------------------------- + | Same-Site Cookies + |-------------------------------------------------------------------------- + | + | This option determines how your cookies behave when cross-site requests + | take place, and can be used to mitigate CSRF attacks. By default, we + | will set this value to "lax" to permit secure cross-site requests. + | + | See: https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Set-Cookie#samesitesamesite-value + | + | Supported: "lax", "strict", "none", null + | + */ + + 'same_site' => env('SESSION_SAME_SITE', 'lax'), + + /* + |-------------------------------------------------------------------------- + | Partitioned Cookies + |-------------------------------------------------------------------------- + | + | Setting this value to true will tie the cookie to the top-level site for + | a cross-site context. Partitioned cookies are accepted by the browser + | when flagged "secure" and the Same-Site attribute is set to "none". + | + */ + + 'partitioned' => env('SESSION_PARTITIONED_COOKIE', false), + + /* + |-------------------------------------------------------------------------- + | Session Serialization + |-------------------------------------------------------------------------- + | + | This value controls the serialization strategy for session data, which + | is JSON by default. Setting this to "php" allows the storage of PHP + | objects in the session but can make an application vulnerable to + | "gadget chain" serialization attacks if the APP_KEY is leaked. + | + | Supported: "json", "php" + | + */ + + 'serialization' => 'json', + +]; diff --git a/database/.gitignore b/database/.gitignore new file mode 100644 index 0000000..9b19b93 --- /dev/null +++ b/database/.gitignore @@ -0,0 +1 @@ +*.sqlite* diff --git a/database/factories/UserFactory.php b/database/factories/UserFactory.php new file mode 100644 index 0000000..66090b9 --- /dev/null +++ b/database/factories/UserFactory.php @@ -0,0 +1,86 @@ + + */ +class UserFactory extends Factory +{ + protected static ?string $password; + + public function definition(): array + { + return [ + 'name' => fake()->name(), + 'email' => fake()->unique()->safeEmail(), + 'email_verified_at' => now(), + 'password' => static::$password ??= Hash::make('password'), + 'status' => AccountStatus::Aktiv, + 'confirmed_adult_at' => now(), + 'remember_token' => Str::random(10), + ]; + } + + public function configure(): static + { + return $this->afterMaking(function (User $user): void { + if ($user->party_id !== null) { + return; + } + + $party = Party::query()->create([ + 'type' => PartyType::Person, + 'display_name' => $user->name, + ]); + + $user->party_id = $party->id; + })->afterCreating(function (User $user): void { + Profile::query()->firstOrCreate( + ['party_id' => $user->party_id], + [ + 'display_name' => $user->name, + 'visibility' => ['display_name' => 'private'], + ], + ); + }); + } + + public function unverified(): static + { + return $this->state(fn (array $attributes) => [ + 'email_verified_at' => null, + ]); + } + + public function katalogverwalter(): static + { + return $this->afterCreating(function (User $user): void { + $user->staffRoles()->create(['role' => StaffRole::Katalogverwalter]); + }); + } + + public function redakteur(): static + { + return $this->afterCreating(function (User $user): void { + $user->staffRoles()->create(['role' => StaffRole::Redakteur]); + }); + } + + public function systemverwalter(): static + { + return $this->afterCreating(function (User $user): void { + $user->staffRoles()->create(['role' => StaffRole::Systemverwalter]); + }); + } +} diff --git a/database/migrations/0001_01_01_000000_create_users_table.php b/database/migrations/0001_01_01_000000_create_users_table.php new file mode 100644 index 0000000..50d98d1 --- /dev/null +++ b/database/migrations/0001_01_01_000000_create_users_table.php @@ -0,0 +1,75 @@ +id(); + $table->string('type'); + $table->string('display_name'); + $table->timestamps(); + }); + + Schema::create('users', function (Blueprint $table) { + $table->id(); + $table->foreignId('party_id')->nullable()->constrained('parties')->nullOnDelete(); + $table->string('name'); + $table->string('email')->unique(); + $table->timestamp('email_verified_at')->nullable(); + $table->string('password'); + $table->string('status')->default('aktiv'); + $table->timestamp('confirmed_adult_at')->nullable(); + $table->text('app_authentication_secret')->nullable(); + $table->text('app_authentication_recovery_codes')->nullable(); + $table->rememberToken(); + $table->timestamps(); + }); + + Schema::create('profiles', function (Blueprint $table) { + $table->id(); + $table->foreignId('party_id')->unique()->constrained('parties')->cascadeOnDelete(); + $table->string('display_name')->nullable(); + $table->json('visibility'); + $table->timestamps(); + }); + + Schema::create('staff_role_assignments', function (Blueprint $table) { + $table->id(); + $table->foreignId('user_id')->constrained()->cascadeOnDelete(); + $table->string('role'); + $table->timestamps(); + + $table->unique(['user_id', 'role']); + }); + + Schema::create('password_reset_tokens', function (Blueprint $table) { + $table->string('email')->primary(); + $table->string('token'); + $table->timestamp('created_at')->nullable(); + }); + + Schema::create('sessions', function (Blueprint $table) { + $table->string('id')->primary(); + $table->foreignId('user_id')->nullable()->index(); + $table->string('ip_address', 45)->nullable(); + $table->text('user_agent')->nullable(); + $table->longText('payload'); + $table->integer('last_activity')->index(); + }); + } + + public function down(): void + { + Schema::dropIfExists('sessions'); + Schema::dropIfExists('password_reset_tokens'); + Schema::dropIfExists('staff_role_assignments'); + Schema::dropIfExists('profiles'); + Schema::dropIfExists('users'); + Schema::dropIfExists('parties'); + } +}; diff --git a/database/migrations/0001_01_01_000001_create_cache_table.php b/database/migrations/0001_01_01_000001_create_cache_table.php new file mode 100644 index 0000000..06dc7a5 --- /dev/null +++ b/database/migrations/0001_01_01_000001_create_cache_table.php @@ -0,0 +1,35 @@ +string('key')->primary(); + $table->mediumText('value'); + $table->bigInteger('expiration')->index(); + }); + + Schema::create('cache_locks', function (Blueprint $table) { + $table->string('key')->primary(); + $table->string('owner'); + $table->bigInteger('expiration')->index(); + }); + } + + /** + * Reverse the migrations. + */ + public function down(): void + { + Schema::dropIfExists('cache'); + Schema::dropIfExists('cache_locks'); + } +}; diff --git a/database/migrations/0001_01_01_000002_create_jobs_table.php b/database/migrations/0001_01_01_000002_create_jobs_table.php new file mode 100644 index 0000000..edac6fe --- /dev/null +++ b/database/migrations/0001_01_01_000002_create_jobs_table.php @@ -0,0 +1,59 @@ +id(); + $table->string('queue')->index(); + $table->longText('payload'); + $table->unsignedSmallInteger('attempts'); + $table->unsignedInteger('reserved_at')->nullable(); + $table->unsignedInteger('available_at'); + $table->unsignedInteger('created_at'); + }); + + Schema::create('job_batches', function (Blueprint $table) { + $table->string('id')->primary(); + $table->string('name'); + $table->integer('total_jobs'); + $table->integer('pending_jobs'); + $table->integer('failed_jobs'); + $table->longText('failed_job_ids'); + $table->mediumText('options')->nullable(); + $table->integer('cancelled_at')->nullable(); + $table->integer('created_at'); + $table->integer('finished_at')->nullable(); + }); + + Schema::create('failed_jobs', function (Blueprint $table) { + $table->id(); + $table->string('uuid')->unique(); + $table->string('connection'); + $table->string('queue'); + $table->longText('payload'); + $table->longText('exception'); + $table->timestamp('failed_at')->useCurrent(); + + $table->index(['connection', 'queue', 'failed_at']); + }); + } + + /** + * Reverse the migrations. + */ + public function down(): void + { + Schema::dropIfExists('jobs'); + Schema::dropIfExists('job_batches'); + Schema::dropIfExists('failed_jobs'); + } +}; diff --git a/database/migrations/2026_11_15_100000_create_cms_tables.php b/database/migrations/2026_11_15_100000_create_cms_tables.php new file mode 100644 index 0000000..20ad41e --- /dev/null +++ b/database/migrations/2026_11_15_100000_create_cms_tables.php @@ -0,0 +1,58 @@ +id(); + $table->string('path')->unique(); + $table->unsignedBigInteger('published_revision_id')->nullable(); + $table->timestamps(); + }); + + Schema::create('page_revisions', function (Blueprint $table) { + $table->id(); + $table->foreignId('page_id')->constrained()->cascadeOnDelete(); + $table->json('blocks'); + $table->string('seo_title')->nullable(); + $table->string('seo_description', 500)->nullable(); + $table->foreignId('created_by')->nullable()->constrained('users')->nullOnDelete(); + $table->timestamp('created_at')->useCurrent(); + }); + + Schema::table('pages', function (Blueprint $table) { + $table->foreign('published_revision_id') + ->references('id') + ->on('page_revisions') + ->nullOnDelete(); + }); + + Schema::create('navigation_items', function (Blueprint $table) { + $table->id(); + $table->string('label'); + $table->foreignId('page_id')->nullable()->constrained()->nullOnDelete(); + $table->string('url')->nullable(); + $table->string('placement')->default('header'); + $table->unsignedInteger('sort_order')->default(0); + $table->timestamps(); + }); + + (new CmsSeeder)->run(); + } + + public function down(): void + { + Schema::dropIfExists('navigation_items'); + Schema::table('pages', function (Blueprint $table) { + $table->dropForeign(['published_revision_id']); + }); + Schema::dropIfExists('page_revisions'); + Schema::dropIfExists('pages'); + } +}; diff --git a/database/migrations/2026_11_15_110000_create_catalog_tables.php b/database/migrations/2026_11_15_110000_create_catalog_tables.php new file mode 100644 index 0000000..a0ee511 --- /dev/null +++ b/database/migrations/2026_11_15_110000_create_catalog_tables.php @@ -0,0 +1,268 @@ +id(); + $table->string('kind'); + $table->string('output_class'); + $table->string('working_title'); + $table->timestamp('archived_at')->nullable(); + $table->timestamps(); + }); + + Schema::create('content_element_versions', function (Blueprint $table) { + $table->id(); + $table->foreignId('content_element_id')->constrained()->cascadeOnDelete(); + $table->unsignedInteger('number'); + $table->string('status'); + $table->string('content_hash'); + $table->text('body')->nullable(); + $table->json('metadata')->nullable(); + $table->text('change_note')->nullable(); + $table->timestamps(); + + $table->unique(['content_element_id', 'number']); + }); + + Schema::create('compositions', function (Blueprint $table) { + $table->id(); + $table->string('designation'); + $table->timestamp('archived_at')->nullable(); + $table->timestamps(); + }); + + Schema::create('composition_versions', function (Blueprint $table) { + $table->id(); + $table->foreignId('composition_id')->constrained()->cascadeOnDelete(); + $table->unsignedInteger('number'); + $table->string('status'); + $table->string('members_hash'); + $table->string('resolved_hash'); + $table->timestamps(); + + $table->unique(['composition_id', 'number']); + }); + + Schema::create('composition_members', function (Blueprint $table) { + $table->id(); + $table->foreignId('composition_version_id')->constrained()->cascadeOnDelete(); + $table->unsignedInteger('position'); + $table->string('role'); + $table->foreignId('content_element_version_id')->nullable()->constrained()->restrictOnDelete(); + $table->foreignId('nested_composition_version_id')->nullable()->constrained('composition_versions')->restrictOnDelete(); + $table->timestamps(); + + $table->unique(['composition_version_id', 'position']); + }); + + Schema::create('compatibility_attestations', function (Blueprint $table) { + $table->id(); + $table->foreignId('composition_version_id')->constrained()->cascadeOnDelete(); + $table->string('resolved_hash'); + $table->foreignId('confirmed_by')->nullable()->constrained('users')->nullOnDelete(); + $table->timestamp('confirmed_at'); + $table->text('note')->nullable(); + }); + + Schema::create('license_articles', function (Blueprint $table) { + $table->id(); + $table->string('code')->unique(); + $table->string('product_line')->nullable(); + $table->foreignId('successor_of_id')->nullable()->constrained('license_articles')->nullOnDelete(); + $table->timestamp('archived_at')->nullable(); + $table->timestamps(); + }); + + Schema::create('article_releases', function (Blueprint $table) { + $table->id(); + $table->foreignId('license_article_id')->constrained()->cascadeOnDelete(); + $table->unsignedInteger('number'); + $table->string('change_kind')->nullable(); + $table->boolean('important')->default(false); + $table->text('classification_note'); + $table->string('status'); + $table->text('block_reason')->nullable(); + $table->foreignId('fallback_release_id')->nullable()->constrained('article_releases')->nullOnDelete(); + $table->text('change_note')->nullable(); + $table->foreignId('root_element_version_id')->nullable()->constrained('content_element_versions')->restrictOnDelete(); + $table->foreignId('root_composition_version_id')->nullable()->constrained('composition_versions')->restrictOnDelete(); + $table->timestamps(); + + $table->unique(['license_article_id', 'number']); + }); + + Schema::create('release_contents', function (Blueprint $table) { + $table->id(); + $table->foreignId('article_release_id')->constrained()->cascadeOnDelete(); + $table->unsignedInteger('position'); + $table->foreignId('content_element_version_id')->constrained()->restrictOnDelete(); + $table->string('role'); + $table->string('path'); + $table->timestamps(); + + $table->unique(['article_release_id', 'position']); + }); + + Schema::table('license_articles', function (Blueprint $table) { + $table->foreignId('current_release_id')->nullable()->constrained('article_releases')->nullOnDelete(); + }); + + Schema::create('bundles', function (Blueprint $table) { + $table->id(); + $table->string('name'); + $table->timestamp('archived_at')->nullable(); + $table->timestamps(); + }); + + Schema::create('bundle_versions', function (Blueprint $table) { + $table->id(); + $table->foreignId('bundle_id')->constrained()->cascadeOnDelete(); + $table->unsignedInteger('number'); + $table->string('status'); + $table->timestamps(); + + $table->unique(['bundle_id', 'number']); + }); + + Schema::create('bundle_items', function (Blueprint $table) { + $table->id(); + $table->foreignId('bundle_version_id')->constrained()->cascadeOnDelete(); + $table->unsignedInteger('position'); + $table->foreignId('license_article_id')->nullable()->constrained()->restrictOnDelete(); + $table->foreignId('nested_bundle_id')->nullable()->constrained('bundles')->restrictOnDelete(); + $table->timestamps(); + + $table->unique(['bundle_version_id', 'position']); + }); + + Schema::create('rights_profiles', function (Blueprint $table) { + $table->id(); + $table->string('name'); + $table->timestamps(); + }); + + Schema::create('rights_profile_versions', function (Blueprint $table) { + $table->id(); + $table->foreignId('rights_profile_id')->constrained()->cascadeOnDelete(); + $table->unsignedInteger('number'); + $table->string('purpose'); + $table->json('capabilities'); + $table->json('options'); + $table->timestamp('locked_at')->nullable(); + $table->timestamps(); + + $table->unique(['rights_profile_id', 'number']); + }); + + Schema::create('offers', function (Blueprint $table) { + $table->id(); + $table->string('name'); + $table->timestamps(); + }); + + Schema::create('offer_versions', function (Blueprint $table) { + $table->id(); + $table->foreignId('offer_id')->constrained()->cascadeOnDelete(); + $table->unsignedInteger('number'); + $table->string('status'); + $table->unsignedInteger('price_cents')->nullable(); + $table->string('tax_class')->nullable(); + $table->string('term_rule'); + $table->string('update_promise'); + $table->boolean('dynamic')->default(false); + $table->string('grant_kind'); + $table->string('holder_kind'); + $table->timestamp('activated_at')->nullable(); + $table->timestamps(); + + $table->unique(['offer_id', 'number']); + }); + + Schema::create('offer_lines', function (Blueprint $table) { + $table->id(); + $table->foreignId('offer_version_id')->constrained()->cascadeOnDelete(); + $table->unsignedInteger('position'); + $table->foreignId('license_article_id')->nullable()->constrained()->restrictOnDelete(); + $table->foreignId('bundle_version_id')->nullable()->constrained()->restrictOnDelete(); + $table->foreignId('rights_profile_version_id')->constrained()->restrictOnDelete(); + $table->timestamps(); + + $table->unique(['offer_version_id', 'position']); + }); + + Schema::create('resolved_scopes', function (Blueprint $table) { + $table->id(); + $table->foreignId('offer_version_id')->constrained()->cascadeOnDelete(); + $table->foreignId('license_article_id')->constrained()->restrictOnDelete(); + $table->foreignId('rights_profile_version_id')->constrained()->restrictOnDelete(); + $table->timestamps(); + + $table->unique(['offer_version_id', 'license_article_id', 'rights_profile_version_id'], 'resolved_scopes_unique'); + }); + + Schema::create('acquisitions', function (Blueprint $table) { + $table->id(); + $table->foreignId('party_id')->constrained()->restrictOnDelete(); + $table->string('type'); + $table->string('reference_type'); + $table->unsignedBigInteger('reference_id'); + $table->json('conditions')->nullable(); + $table->timestamps(); + + $table->unique(['party_id', 'type', 'reference_type', 'reference_id'], 'acquisitions_holder_source_unique'); + }); + + Schema::create('grants', function (Blueprint $table) { + $table->id(); + $table->foreignId('acquisition_id')->constrained()->cascadeOnDelete(); + $table->foreignId('license_article_id')->constrained()->restrictOnDelete(); + $table->foreignId('rights_profile_version_id')->constrained()->restrictOnDelete(); + $table->json('rights_snapshot'); + $table->timestamp('valid_from')->nullable(); + $table->timestamp('valid_until')->nullable(); + $table->foreignId('release_at_grant_id')->nullable()->constrained('article_releases')->nullOnDelete(); + $table->string('status'); + $table->text('status_reason')->nullable(); + $table->timestamps(); + + $table->unique( + ['acquisition_id', 'license_article_id', 'rights_profile_version_id'], + 'grants_acquisition_article_rights_unique', + ); + }); + } + + public function down(): void + { + Schema::dropIfExists('grants'); + Schema::dropIfExists('acquisitions'); + Schema::dropIfExists('resolved_scopes'); + Schema::dropIfExists('offer_lines'); + Schema::dropIfExists('offer_versions'); + Schema::dropIfExists('offers'); + Schema::dropIfExists('rights_profile_versions'); + Schema::dropIfExists('rights_profiles'); + Schema::dropIfExists('bundle_items'); + Schema::dropIfExists('bundle_versions'); + Schema::dropIfExists('bundles'); + Schema::table('license_articles', function (Blueprint $table) { + $table->dropConstrainedForeignId('current_release_id'); + }); + Schema::dropIfExists('release_contents'); + Schema::dropIfExists('article_releases'); + Schema::dropIfExists('license_articles'); + Schema::dropIfExists('compatibility_attestations'); + Schema::dropIfExists('composition_members'); + Schema::dropIfExists('composition_versions'); + Schema::dropIfExists('compositions'); + Schema::dropIfExists('content_element_versions'); + Schema::dropIfExists('content_elements'); + } +}; diff --git a/database/migrations/2026_11_15_120000_create_commerce_tables.php b/database/migrations/2026_11_15_120000_create_commerce_tables.php new file mode 100644 index 0000000..d418c36 --- /dev/null +++ b/database/migrations/2026_11_15_120000_create_commerce_tables.php @@ -0,0 +1,71 @@ +id(); + $table->foreignId('actor_id')->constrained('users')->restrictOnDelete(); + $table->foreignId('party_id')->constrained()->restrictOnDelete(); + $table->foreignId('offer_id')->constrained()->restrictOnDelete(); + $table->text('reason'); + $table->timestamps(); + }); + + Schema::create('orders', function (Blueprint $table) { + $table->id(); + $table->foreignId('user_id')->constrained()->restrictOnDelete(); + $table->foreignId('party_id')->constrained()->restrictOnDelete(); + $table->string('status'); + $table->string('holder_kind'); + $table->timestamps(); + }); + + Schema::create('order_lines', function (Blueprint $table) { + $table->id(); + $table->foreignId('order_id')->constrained()->cascadeOnDelete(); + $table->foreignId('offer_version_id')->constrained()->restrictOnDelete(); + $table->unsignedInteger('price_cents'); + $table->string('term_rule'); + $table->string('update_promise'); + $table->string('holder_kind'); + $table->timestamps(); + + $table->unique(['order_id', 'offer_version_id']); + }); + + Schema::create('order_scope_items', function (Blueprint $table) { + $table->id(); + $table->foreignId('order_line_id')->constrained()->cascadeOnDelete(); + $table->foreignId('license_article_id')->constrained()->restrictOnDelete(); + $table->foreignId('rights_profile_version_id')->constrained()->restrictOnDelete(); + $table->json('rights_snapshot'); + $table->timestamps(); + + $table->unique(['order_line_id', 'license_article_id', 'rights_profile_version_id'], 'order_scope_unique'); + }); + + Schema::create('payments', function (Blueprint $table) { + $table->id(); + $table->foreignId('order_id')->constrained()->cascadeOnDelete(); + $table->string('provider'); + $table->string('status'); + $table->string('provider_reference')->unique(); + $table->timestamps(); + }); + } + + public function down(): void + { + Schema::dropIfExists('payments'); + Schema::dropIfExists('order_scope_items'); + Schema::dropIfExists('order_lines'); + Schema::dropIfExists('orders'); + Schema::dropIfExists('manual_grants'); + } +}; diff --git a/database/migrations/2026_11_15_130000_add_impact_report_to_article_releases.php b/database/migrations/2026_11_15_130000_add_impact_report_to_article_releases.php new file mode 100644 index 0000000..9373ff5 --- /dev/null +++ b/database/migrations/2026_11_15_130000_add_impact_report_to_article_releases.php @@ -0,0 +1,22 @@ +json('impact_report')->nullable(); + }); + } + + public function down(): void + { + Schema::table('article_releases', function (Blueprint $table) { + $table->dropColumn('impact_report'); + }); + } +}; diff --git a/database/migrations/2026_11_15_140000_add_kind_to_compositions.php b/database/migrations/2026_11_15_140000_add_kind_to_compositions.php new file mode 100644 index 0000000..9e5a52e --- /dev/null +++ b/database/migrations/2026_11_15_140000_add_kind_to_compositions.php @@ -0,0 +1,25 @@ +string('kind')->default('uebung'); + }); + + DB::table('compositions')->where('designation', 'like', '%Materialsatz%')->update(['kind' => 'kombination']); + } + + public function down(): void + { + Schema::table('compositions', function (Blueprint $table) { + $table->dropColumn('kind'); + }); + } +}; diff --git a/database/migrations/2026_11_15_150000_create_pillars.php b/database/migrations/2026_11_15_150000_create_pillars.php new file mode 100644 index 0000000..4034280 --- /dev/null +++ b/database/migrations/2026_11_15_150000_create_pillars.php @@ -0,0 +1,29 @@ +id(); + $table->string('name')->unique(); + $table->timestamps(); + }); + + Schema::create('content_element_pillar', function (Blueprint $table) { + $table->foreignId('content_element_id')->constrained()->cascadeOnDelete(); + $table->foreignId('pillar_id')->constrained()->restrictOnDelete(); + $table->primary(['content_element_id', 'pillar_id']); + }); + } + + public function down(): void + { + Schema::dropIfExists('content_element_pillar'); + Schema::dropIfExists('pillars'); + } +}; diff --git a/database/migrations/2026_11_15_160000_add_media_description.php b/database/migrations/2026_11_15_160000_add_media_description.php new file mode 100644 index 0000000..9af019f --- /dev/null +++ b/database/migrations/2026_11_15_160000_add_media_description.php @@ -0,0 +1,30 @@ +text('description')->nullable(); + }); + + Schema::table('content_element_versions', function (Blueprint $table) { + $table->text('block_reason')->nullable(); + }); + } + + public function down(): void + { + Schema::table('content_elements', function (Blueprint $table) { + $table->dropColumn('description'); + }); + + Schema::table('content_element_versions', function (Blueprint $table) { + $table->dropColumn('block_reason'); + }); + } +}; diff --git a/database/migrations/2026_11_15_170000_publish_pillars_to_the_site.php b/database/migrations/2026_11_15_170000_publish_pillars_to_the_site.php new file mode 100644 index 0000000..6cac7c1 --- /dev/null +++ b/database/migrations/2026_11_15_170000_publish_pillars_to_the_site.php @@ -0,0 +1,33 @@ +string('slug')->nullable()->unique(); + $table->text('public_summary')->nullable(); + $table->unsignedInteger('sort_order')->default(0); + $table->timestamp('published_at')->nullable(); + }); + + Schema::create('page_pillar', function (Blueprint $table) { + $table->foreignId('page_id')->constrained()->cascadeOnDelete(); + $table->foreignId('pillar_id')->constrained()->restrictOnDelete(); + $table->primary(['page_id', 'pillar_id']); + }); + } + + public function down(): void + { + Schema::dropIfExists('page_pillar'); + + Schema::table('pillars', function (Blueprint $table) { + $table->dropColumn(['slug', 'public_summary', 'sort_order', 'published_at']); + }); + } +}; diff --git a/database/migrations/2026_11_16_100000_add_offer_name_to_order_lines.php b/database/migrations/2026_11_16_100000_add_offer_name_to_order_lines.php new file mode 100644 index 0000000..05dd386 --- /dev/null +++ b/database/migrations/2026_11_16_100000_add_offer_name_to_order_lines.php @@ -0,0 +1,22 @@ +string('offer_name')->nullable()->after('offer_version_id'); + }); + } + + public function down(): void + { + Schema::table('order_lines', function (Blueprint $table) { + $table->dropColumn('offer_name'); + }); + } +}; diff --git a/database/migrations/2026_11_16_110000_editorial_content_kinds.php b/database/migrations/2026_11_16_110000_editorial_content_kinds.php new file mode 100644 index 0000000..2c36285 --- /dev/null +++ b/database/migrations/2026_11_16_110000_editorial_content_kinds.php @@ -0,0 +1,63 @@ +id(); + $table->string('slug')->unique(); + $table->string('label'); + $table->unsignedInteger('sort_order')->default(0); + $table->timestamps(); + }); + + $now = now(); + foreach ([ + ['slug' => 'programm', 'label' => 'Programm', 'sort_order' => 10], + ['slug' => 'modul', 'label' => 'Modul', 'sort_order' => 20], + ['slug' => 'merkblatt', 'label' => 'Merkblatt', 'sort_order' => 30], + ['slug' => 'traineranleitung', 'label' => 'Traineranleitung', 'sort_order' => 40], + ] as $row) { + DB::table('editorial_content_kinds')->insert([ + ...$row, + 'created_at' => $now, + 'updated_at' => $now, + ]); + } + + Schema::table('compositions', function (Blueprint $table) { + $table->foreignId('editorial_content_kind_id') + ->nullable() + ->after('kind') + ->constrained('editorial_content_kinds') + ->nullOnDelete(); + }); + + Schema::table('content_elements', function (Blueprint $table) { + $table->foreignId('editorial_content_kind_id') + ->nullable() + ->after('output_class') + ->constrained('editorial_content_kinds') + ->nullOnDelete(); + }); + } + + public function down(): void + { + Schema::table('content_elements', function (Blueprint $table) { + $table->dropConstrainedForeignId('editorial_content_kind_id'); + }); + + Schema::table('compositions', function (Blueprint $table) { + $table->dropConstrainedForeignId('editorial_content_kind_id'); + }); + + Schema::dropIfExists('editorial_content_kinds'); + } +}; diff --git a/database/migrations/2026_11_16_120000_composition_version_display_events.php b/database/migrations/2026_11_16_120000_composition_version_display_events.php new file mode 100644 index 0000000..f55419d --- /dev/null +++ b/database/migrations/2026_11_16_120000_composition_version_display_events.php @@ -0,0 +1,28 @@ +id(); + $table->foreignId('composition_version_id')->constrained()->cascadeOnDelete(); + $table->string('event'); + $table->foreignId('actor_id')->nullable()->constrained('users')->nullOnDelete(); + $table->timestamp('occurred_at'); + $table->text('note')->nullable(); + $table->timestamps(); + + $table->index(['composition_version_id', 'occurred_at']); + }); + } + + public function down(): void + { + Schema::dropIfExists('composition_version_display_events'); + } +}; diff --git a/database/migrations/2026_11_16_130000_identity_display_fields.php b/database/migrations/2026_11_16_130000_identity_display_fields.php new file mode 100644 index 0000000..7498a53 --- /dev/null +++ b/database/migrations/2026_11_16_130000_identity_display_fields.php @@ -0,0 +1,45 @@ +string('display_title')->nullable()->after('working_title'); + $table->text('summary')->nullable()->after('description'); + }); + + Schema::table('compositions', function (Blueprint $table) { + $table->string('display_title')->nullable()->after('designation'); + $table->text('summary')->nullable()->after('display_title'); + }); + + Schema::create('identity_changes', function (Blueprint $table) { + $table->id(); + $table->string('subject_type'); + $table->unsignedBigInteger('subject_id'); + $table->string('field'); + $table->text('before')->nullable(); + $table->text('after')->nullable(); + $table->foreignId('actor_id')->nullable()->constrained('users')->nullOnDelete(); + $table->timestamp('occurred_at'); + $table->timestamps(); + $table->index(['subject_type', 'subject_id']); + }); + } + + public function down(): void + { + Schema::dropIfExists('identity_changes'); + Schema::table('compositions', function (Blueprint $table) { + $table->dropColumn(['display_title', 'summary']); + }); + Schema::table('content_elements', function (Blueprint $table) { + $table->dropColumn(['display_title', 'summary']); + }); + } +}; diff --git a/database/migrations/2026_11_16_140000_editorial_dimensions.php b/database/migrations/2026_11_16_140000_editorial_dimensions.php new file mode 100644 index 0000000..26009fe --- /dev/null +++ b/database/migrations/2026_11_16_140000_editorial_dimensions.php @@ -0,0 +1,75 @@ +id(); + $table->string('slug')->unique(); + $table->string('label'); + $table->timestamps(); + }); + + Schema::create('editorial_dimension_values', function (Blueprint $table) { + $table->id(); + $table->foreignId('editorial_dimension_id')->constrained()->cascadeOnDelete(); + $table->string('slug'); + $table->string('label'); + $table->timestamps(); + $table->unique(['editorial_dimension_id', 'slug']); + }); + + Schema::create('identity_dimension_values', function (Blueprint $table) { + $table->id(); + $table->string('subject_type'); + $table->unsignedBigInteger('subject_id'); + $table->foreignId('editorial_dimension_value_id')->constrained()->cascadeOnDelete(); + $table->string('origin'); + $table->timestamps(); + $table->unique(['subject_type', 'subject_id', 'editorial_dimension_value_id'], 'identity_dimension_unique'); + }); + + $now = now(); + $dimensionId = DB::table('editorial_dimensions')->insertGetId([ + 'slug' => 'saeule', + 'label' => 'Fachliche Säule', + 'created_at' => $now, + 'updated_at' => $now, + ]); + + foreach (DB::table('pillars')->orderBy('id')->get() as $pillar) { + $slug = 'pfeiler-'.$pillar->id; + $valueId = DB::table('editorial_dimension_values')->insertGetId([ + 'editorial_dimension_id' => $dimensionId, + 'slug' => $slug, + 'label' => $pillar->name, + 'created_at' => $now, + 'updated_at' => $now, + ]); + + foreach (DB::table('content_element_pillar')->where('pillar_id', $pillar->id)->get() as $link) { + DB::table('identity_dimension_values')->insert([ + 'subject_type' => 'App\\Domain\\Catalog\\ContentElement', + 'subject_id' => $link->content_element_id, + 'editorial_dimension_value_id' => $valueId, + 'origin' => 'direkt', + 'created_at' => $now, + 'updated_at' => $now, + ]); + } + } + } + + public function down(): void + { + Schema::dropIfExists('identity_dimension_values'); + Schema::dropIfExists('editorial_dimension_values'); + Schema::dropIfExists('editorial_dimensions'); + } +}; diff --git a/database/migrations/2026_11_16_150000_media_deliveries.php b/database/migrations/2026_11_16_150000_media_deliveries.php new file mode 100644 index 0000000..f54c497 --- /dev/null +++ b/database/migrations/2026_11_16_150000_media_deliveries.php @@ -0,0 +1,28 @@ +id(); + $table->foreignId('grant_id')->constrained()->restrictOnDelete(); + $table->foreignId('license_article_id')->constrained()->restrictOnDelete(); + $table->foreignId('article_release_id')->constrained()->restrictOnDelete(); + $table->foreignId('content_element_version_id')->constrained()->restrictOnDelete(); + $table->string('action'); + $table->string('format'); + $table->timestamp('delivered_at'); + $table->timestamps(); + }); + } + + public function down(): void + { + Schema::dropIfExists('media_deliveries'); + } +}; diff --git a/database/migrations/2026_11_16_160000_library_completion.php b/database/migrations/2026_11_16_160000_library_completion.php new file mode 100644 index 0000000..4c609bf --- /dev/null +++ b/database/migrations/2026_11_16_160000_library_completion.php @@ -0,0 +1,42 @@ +string('thumbnail_path')->nullable(); + $table->string('thumbnail_alt')->nullable(); + $table->string('thumbnail_error')->nullable(); + }); + } + + Schema::table('compositions', function (Blueprint $table) { + $table->string('public_slug')->nullable()->unique(); + }); + + Schema::table('composition_versions', function (Blueprint $table) { + $table->text('learning_goal')->nullable(); + $table->unsignedSmallInteger('duration_minutes')->nullable(); + $table->text('material_note')->nullable(); + }); + } + + public function down(): void + { + Schema::table('composition_versions', function (Blueprint $table) { + $table->dropColumn(['learning_goal', 'duration_minutes', 'material_note']); + }); + Schema::table('compositions', function (Blueprint $table) { + $table->dropColumn(['thumbnail_path', 'thumbnail_alt', 'thumbnail_error', 'public_slug']); + }); + Schema::table('content_elements', function (Blueprint $table) { + $table->dropColumn(['thumbnail_path', 'thumbnail_alt', 'thumbnail_error']); + }); + } +}; diff --git a/database/migrations/2026_11_16_170000_media_renditions_and_delivery_marking.php b/database/migrations/2026_11_16_170000_media_renditions_and_delivery_marking.php new file mode 100644 index 0000000..ffac828 --- /dev/null +++ b/database/migrations/2026_11_16_170000_media_renditions_and_delivery_marking.php @@ -0,0 +1,35 @@ +id(); + $table->foreignId('content_element_version_id')->constrained()->restrictOnDelete(); + $table->string('role'); + $table->string('label'); + $table->string('path'); + $table->timestamps(); + $table->unique(['content_element_version_id', 'label']); + }); + + Schema::table('media_deliveries', function (Blueprint $table) { + $table->string('copy_id')->nullable(); + $table->string('checksum')->nullable(); + $table->string('marking')->nullable(); + }); + } + + public function down(): void + { + Schema::table('media_deliveries', function (Blueprint $table) { + $table->dropColumn(['copy_id', 'checksum', 'marking']); + }); + Schema::dropIfExists('media_renditions'); + } +}; diff --git a/database/migrations/2026_11_16_180000_add_working_draft_to_compositions.php b/database/migrations/2026_11_16_180000_add_working_draft_to_compositions.php new file mode 100644 index 0000000..a754053 --- /dev/null +++ b/database/migrations/2026_11_16_180000_add_working_draft_to_compositions.php @@ -0,0 +1,22 @@ +json('working_draft')->nullable(); + }); + } + + public function down(): void + { + Schema::table('compositions', function (Blueprint $table) { + $table->dropColumn('working_draft'); + }); + } +}; diff --git a/database/migrations/2026_11_16_190000_add_presentation_text_to_compositions.php b/database/migrations/2026_11_16_190000_add_presentation_text_to_compositions.php new file mode 100644 index 0000000..a207989 --- /dev/null +++ b/database/migrations/2026_11_16_190000_add_presentation_text_to_compositions.php @@ -0,0 +1,23 @@ +text('description')->nullable()->after('summary'); + $table->string('thumbnail_source')->nullable()->after('thumbnail_alt'); + }); + } + + public function down(): void + { + Schema::table('compositions', function (Blueprint $table) { + $table->dropColumn(['description', 'thumbnail_source']); + }); + } +}; diff --git a/database/migrations/2026_11_16_210000_add_editorial_notes.php b/database/migrations/2026_11_16_210000_add_editorial_notes.php new file mode 100644 index 0000000..0144bf8 --- /dev/null +++ b/database/migrations/2026_11_16_210000_add_editorial_notes.php @@ -0,0 +1,31 @@ +text('usage_note')->nullable()->after('description'); + $table->text('license_note')->nullable()->after('usage_note'); + }); + + Schema::table('composition_members', function (Blueprint $table) { + $table->text('placement_note')->nullable()->after('role'); + }); + } + + public function down(): void + { + Schema::table('content_elements', function (Blueprint $table) { + $table->dropColumn(['usage_note', 'license_note']); + }); + + Schema::table('composition_members', function (Blueprint $table) { + $table->dropColumn('placement_note'); + }); + } +}; diff --git a/database/migrations/2026_11_16_220000_add_thumbnail_source_to_content_elements.php b/database/migrations/2026_11_16_220000_add_thumbnail_source_to_content_elements.php new file mode 100644 index 0000000..1a01299 --- /dev/null +++ b/database/migrations/2026_11_16_220000_add_thumbnail_source_to_content_elements.php @@ -0,0 +1,22 @@ +string('thumbnail_source')->nullable()->after('thumbnail_alt'); + }); + } + + public function down(): void + { + Schema::table('content_elements', function (Blueprint $table) { + $table->dropColumn('thumbnail_source'); + }); + } +}; diff --git a/database/migrations/2026_11_17_100000_add_visibility_to_navigation_items.php b/database/migrations/2026_11_17_100000_add_visibility_to_navigation_items.php new file mode 100644 index 0000000..6aae70c --- /dev/null +++ b/database/migrations/2026_11_17_100000_add_visibility_to_navigation_items.php @@ -0,0 +1,25 @@ +boolean('is_visible')->default(true); + }); + } + + public function down(): void + { + Schema::table('navigation_items', function (Blueprint $table) { + $table->dropColumn('is_visible'); + }); + } +}; diff --git a/database/migrations/2026_11_17_110000_add_sections_to_page_revisions.php b/database/migrations/2026_11_17_110000_add_sections_to_page_revisions.php new file mode 100644 index 0000000..269f758 --- /dev/null +++ b/database/migrations/2026_11_17_110000_add_sections_to_page_revisions.php @@ -0,0 +1,27 @@ +json('sections')->nullable(); + }); + } + + public function down(): void + { + Schema::table('page_revisions', function (Blueprint $table) { + $table->dropColumn('sections'); + }); + } +}; diff --git a/database/migrations/2026_11_17_120000_add_parent_to_navigation_items.php b/database/migrations/2026_11_17_120000_add_parent_to_navigation_items.php new file mode 100644 index 0000000..7c139c2 --- /dev/null +++ b/database/migrations/2026_11_17_120000_add_parent_to_navigation_items.php @@ -0,0 +1,27 @@ +foreignId('parent_id')->nullable()->constrained('navigation_items')->nullOnDelete(); + }); + } + + public function down(): void + { + Schema::table('navigation_items', function (Blueprint $table) { + $table->dropConstrainedForeignId('parent_id'); + }); + } +}; diff --git a/database/migrations/2026_11_18_210000_website_release_on_content_elements.php b/database/migrations/2026_11_18_210000_website_release_on_content_elements.php new file mode 100644 index 0000000..63723ef --- /dev/null +++ b/database/migrations/2026_11_18_210000_website_release_on_content_elements.php @@ -0,0 +1,30 @@ +text('website_credit')->nullable()->after('license_note'); + $table->string('website_alt')->nullable()->after('website_credit'); + $table->timestamp('website_released_at')->nullable()->after('website_alt'); + $table->string('website_public_path')->nullable()->after('website_released_at'); + }); + } + + public function down(): void + { + Schema::table('content_elements', function (Blueprint $table) { + $table->dropColumn([ + 'website_credit', + 'website_alt', + 'website_released_at', + 'website_public_path', + ]); + }); + } +}; diff --git a/database/migrations/2026_11_19_090000_create_website_media_aliases.php b/database/migrations/2026_11_19_090000_create_website_media_aliases.php new file mode 100644 index 0000000..6e1269b --- /dev/null +++ b/database/migrations/2026_11_19_090000_create_website_media_aliases.php @@ -0,0 +1,28 @@ +id(); + $table->string('legacy_path')->unique(); + $table->foreignId('content_element_id')->constrained()->restrictOnDelete(); + $table->string('sha256', 64)->index(); + $table->timestamps(); + }); + } + + public function down(): void + { + Schema::dropIfExists('website_media_aliases'); + } +}; diff --git a/database/migrations/2026_11_19_090100_import_cms_images_into_media_manager.php b/database/migrations/2026_11_19_090100_import_cms_images_into_media_manager.php new file mode 100644 index 0000000..c8ce0d3 --- /dev/null +++ b/database/migrations/2026_11_19_090100_import_cms_images_into_media_manager.php @@ -0,0 +1,27 @@ +runningUnitTests()) { + return; + } + + ImportCmsImages::dispatch(); + } + + public function down(): void + { + // Nichts zurückzunehmen: Die übernommenen Medien und Zuordnungen bleiben; die Tabelle entfernt die vorige Migration. + } +}; diff --git a/database/migrations/2026_11_19_120000_editorial_profile_and_presentation.php b/database/migrations/2026_11_19_120000_editorial_profile_and_presentation.php new file mode 100644 index 0000000..5034935 --- /dev/null +++ b/database/migrations/2026_11_19_120000_editorial_profile_and_presentation.php @@ -0,0 +1,191 @@ +text('teaser')->nullable()->after('display_title'); + $table->text('search_terms')->nullable()->after('summary'); + }); + + Schema::table('compositions', function (Blueprint $table) { + $table->text('teaser')->nullable()->after('display_title'); + $table->text('search_terms')->nullable()->after('description'); + }); + + Schema::table('license_articles', function (Blueprint $table) { + $table->string('working_title')->nullable()->after('code'); + $table->string('display_title')->nullable()->after('working_title'); + $table->text('teaser')->nullable()->after('display_title'); + $table->text('summary')->nullable()->after('teaser'); + $table->text('description')->nullable()->after('summary'); + $table->text('search_terms')->nullable()->after('description'); + $table->foreignId('editorial_content_kind_id') + ->nullable() + ->after('search_terms') + ->constrained('editorial_content_kinds') + ->nullOnDelete(); + }); + + Schema::create('editorial_text_variants', function (Blueprint $table) { + $table->id(); + $table->string('subject_type'); + $table->unsignedBigInteger('subject_id'); + $table->string('field'); + $table->string('audience'); + $table->text('body'); + $table->timestamps(); + $table->unique(['subject_type', 'subject_id', 'field', 'audience'], 'editorial_text_variant_unique'); + }); + + Schema::create('presentation_roles', function (Blueprint $table) { + $table->id(); + $table->string('slug')->unique(); + $table->string('label'); + $table->boolean('multiple')->default(false); + $table->boolean('ordered')->default(false); + $table->unsignedInteger('sort_order')->default(0); + $table->timestamps(); + }); + + Schema::create('presentation_assignments', function (Blueprint $table) { + $table->id(); + $table->string('subject_type'); + $table->unsignedBigInteger('subject_id'); + $table->foreignId('content_element_id')->constrained('content_elements')->cascadeOnDelete(); + $table->foreignId('presentation_role_id')->constrained('presentation_roles')->cascadeOnDelete(); + $table->unsignedInteger('position')->default(1); + $table->foreignId('source_version_id')->nullable()->constrained('content_element_versions')->nullOnDelete(); + $table->timestamps(); + $table->unique( + ['subject_type', 'subject_id', 'presentation_role_id', 'content_element_id'], + 'presentation_assignment_unique', + ); + $table->index(['subject_type', 'subject_id'], 'presentation_assignment_subject'); + }); + + $now = now(); + + foreach ([ + ['slug' => 'unterrichtsfilm', 'label' => 'Unterrichtsfilm', 'sort_order' => 50], + ['slug' => 'kurzfilm', 'label' => 'Kurzfilm / Filmbeispiel', 'sort_order' => 60], + ['slug' => 'trailer', 'label' => 'Trailer / Teaserfilm', 'sort_order' => 70], + ['slug' => 'interview', 'label' => 'Interview', 'sort_order' => 80], + ['slug' => 'arbeitsblatt', 'label' => 'Arbeitsblatt', 'sort_order' => 90], + ['slug' => 'uebungsbeschreibung', 'label' => 'Übungsbeschreibung', 'sort_order' => 100], + ['slug' => 'titelbild', 'label' => 'Titelbild / Keyvisual', 'sort_order' => 110], + ['slug' => 'hintergrundbild', 'label' => 'Hintergrundbild', 'sort_order' => 120], + ['slug' => 'praesentationsbild', 'label' => 'Sonstiges Präsentationsbild', 'sort_order' => 130], + ['slug' => 'audioanleitung', 'label' => 'Audioanleitung', 'sort_order' => 140], + ] as $row) { + DB::table('editorial_content_kinds')->insert($row + ['created_at' => $now, 'updated_at' => $now]); + } + + $dimensions = [ + 'verwendungszweck' => [ + 'label' => 'Redaktioneller Verwendungszweck', + 'values' => [ + 'training' => 'Training / Lehrinhalt', + 'begleitmaterial' => 'Trainer- und Begleitmaterial', + 'website' => 'Website / Marketing', + 'marke' => 'Markenpräsentation', + 'intern' => 'Interne redaktionelle Ressource', + ], + ], + 'zielgruppe' => [ + 'label' => 'Altersbereich und Zielgruppe', + 'values' => [ + 'kinder' => 'Kinder', + 'jugendliche' => 'Jugendliche', + 'erwachsene' => 'Erwachsene', + 'eltern' => 'Eltern', + 'fachkraefte' => 'Fachkräfte', + ], + ], + 'einsatzbereich' => [ + 'label' => 'Einsatzbereich', + 'values' => [ + 'kita' => 'Kita', + 'schule' => 'Schule', + 'familie' => 'Familie', + 'fortbildung' => 'Fortbildung', + ], + ], + ]; + + foreach ($dimensions as $slug => $dimension) { + $dimensionId = DB::table('editorial_dimensions')->insertGetId([ + 'slug' => $slug, + 'label' => $dimension['label'], + 'created_at' => $now, + 'updated_at' => $now, + ]); + + foreach ($dimension['values'] as $valueSlug => $label) { + DB::table('editorial_dimension_values')->insert([ + 'editorial_dimension_id' => $dimensionId, + 'slug' => $valueSlug, + 'label' => $label, + 'created_at' => $now, + 'updated_at' => $now, + ]); + } + } + + foreach ([ + ['slug' => 'titelbild', 'label' => 'Titelbild / Standard-Thumbnail', 'multiple' => false, 'ordered' => false, 'sort_order' => 10], + ['slug' => 'titelbild_alternativ', 'label' => 'Alternatives Titelbild', 'multiple' => true, 'ordered' => true, 'sort_order' => 20], + ['slug' => 'hero', 'label' => 'Hero-Bild', 'multiple' => false, 'ordered' => false, 'sort_order' => 30], + ['slug' => 'hover', 'label' => 'Hoverbild', 'multiple' => false, 'ordered' => false, 'sort_order' => 40], + ['slug' => 'trailer', 'label' => 'Trailer / Teaserfilm', 'multiple' => true, 'ordered' => true, 'sort_order' => 50], + ['slug' => 'vorschauclip', 'label' => 'Vorschauclip', 'multiple' => true, 'ordered' => true, 'sort_order' => 60], + ['slug' => 'audiovorschau', 'label' => 'Audiovorschau', 'multiple' => true, 'ordered' => true, 'sort_order' => 70], + ['slug' => 'interview', 'label' => 'Interview', 'multiple' => true, 'ordered' => true, 'sort_order' => 80], + ['slug' => 'galerie', 'label' => 'Galerieelement', 'multiple' => true, 'ordered' => true, 'sort_order' => 90], + ] as $role) { + DB::table('presentation_roles')->insert($role + ['created_at' => $now, 'updated_at' => $now]); + } + } + + public function down(): void + { + Schema::dropIfExists('presentation_assignments'); + Schema::dropIfExists('presentation_roles'); + Schema::dropIfExists('editorial_text_variants'); + + Schema::table('license_articles', function (Blueprint $table) { + $table->dropConstrainedForeignId('editorial_content_kind_id'); + $table->dropColumn(['working_title', 'display_title', 'teaser', 'summary', 'description', 'search_terms']); + }); + + Schema::table('compositions', function (Blueprint $table) { + $table->dropColumn(['teaser', 'search_terms']); + }); + + Schema::table('content_elements', function (Blueprint $table) { + $table->dropColumn(['teaser', 'search_terms']); + }); + + $dimensionIds = DB::table('editorial_dimensions') + ->whereIn('slug', ['verwendungszweck', 'zielgruppe', 'einsatzbereich']) + ->pluck('id'); + + DB::table('identity_dimension_values')->whereIn( + 'editorial_dimension_value_id', + DB::table('editorial_dimension_values')->whereIn('editorial_dimension_id', $dimensionIds)->pluck('id'), + )->delete(); + DB::table('editorial_dimension_values')->whereIn('editorial_dimension_id', $dimensionIds)->delete(); + DB::table('editorial_dimensions')->whereIn('id', $dimensionIds)->delete(); + + DB::table('editorial_content_kinds')->whereIn('slug', [ + 'unterrichtsfilm', 'kurzfilm', 'trailer', 'interview', 'arbeitsblatt', 'uebungsbeschreibung', + 'titelbild', 'hintergrundbild', 'praesentationsbild', 'audioanleitung', + ])->delete(); + } +}; diff --git a/database/migrations/2026_11_19_180000_presentation_preview_path.php b/database/migrations/2026_11_19_180000_presentation_preview_path.php new file mode 100644 index 0000000..57164d0 --- /dev/null +++ b/database/migrations/2026_11_19_180000_presentation_preview_path.php @@ -0,0 +1,22 @@ +string('preview_path')->nullable()->after('thumbnail_error'); + }); + } + + public function down(): void + { + Schema::table('content_elements', function (Blueprint $table) { + $table->dropColumn('preview_path'); + }); + } +}; diff --git a/database/migrations/2026_11_20_200000_editorial_master_data_management.php b/database/migrations/2026_11_20_200000_editorial_master_data_management.php new file mode 100644 index 0000000..7cb2699 --- /dev/null +++ b/database/migrations/2026_11_20_200000_editorial_master_data_management.php @@ -0,0 +1,72 @@ +boolean('is_active')->default(true)->after('sort_order'); + $table->json('contexts')->nullable()->after('is_active'); + }); + + Schema::table('editorial_dimension_values', function (Blueprint $table) { + $table->unsignedInteger('sort_order')->default(0)->after('label'); + $table->boolean('is_active')->default(true)->after('sort_order'); + }); + + foreach (DB::table('editorial_dimension_values')->orderBy('editorial_dimension_id')->orderBy('id')->get(['id', 'editorial_dimension_id']) as $index => $value) { + DB::table('editorial_dimension_values')->where('id', $value->id)->update(['sort_order' => ($index + 1) * 10]); + } + + $compositionContexts = ['kurs' => 'programm', 'uebung' => 'modul']; + + foreach (DB::table('editorial_content_kinds')->get(['id', 'slug']) as $kind) { + $contexts = match ($kind->slug) { + 'programm' => ['programm', 'lizenzartikel'], + 'modul' => ['modul', 'lizenzartikel'], + default => ['medium', 'lizenzartikel'], + }; + + if (DB::table('content_elements')->where('editorial_content_kind_id', $kind->id)->exists()) { + $contexts[] = 'medium'; + } + + foreach (DB::table('compositions')->where('editorial_content_kind_id', $kind->id)->distinct()->pluck('kind') as $compositionKind) { + if (isset($compositionContexts[$compositionKind])) { + $contexts[] = $compositionContexts[$compositionKind]; + } + } + + $order = ['medium', 'modul', 'programm', 'lizenzartikel']; + $contexts = array_values(array_filter($order, fn (string $context): bool => in_array($context, $contexts, true))); + + DB::table('editorial_content_kinds')->where('id', $kind->id)->update(['contexts' => json_encode($contexts)]); + } + } + + public function down(): void + { + Schema::table('editorial_dimension_values', function (Blueprint $table) { + $table->dropColumn(['sort_order', 'is_active']); + }); + + Schema::table('editorial_content_kinds', function (Blueprint $table) { + $table->dropColumn(['is_active', 'contexts']); + }); + } +}; diff --git a/database/seeders/CmsSeeder.php b/database/seeders/CmsSeeder.php new file mode 100644 index 0000000..5f3167a --- /dev/null +++ b/database/seeders/CmsSeeder.php @@ -0,0 +1,202 @@ +exists()) { + return; + } + + $service = app(PageService::class); + $pages = []; + + foreach ($this->pages() as $path => $page) { + $record = Page::query()->create(['path' => $path]); + $revision = $service->saveRevision($record, $page['blocks'], $page['seo_title'], $page['seo_description'], null); + $service->publish($record, $revision); + $pages[$path] = $record; + } + + $order = 0; + + foreach ($this->navigation() as $item) { + NavigationItem::query()->create([ + 'label' => $item['label'], + 'page_id' => isset($item['path']) ? $pages[$item['path']]->id : null, + 'url' => $item['url'] ?? null, + 'placement' => $item['placement'], + 'sort_order' => $order++, + ]); + } + } + + /** + * @return array>}> + */ + private function pages(): array + { + return [ + '/' => [ + 'seo_title' => 'Lara & Felix – Stark im Alltag', + 'seo_description' => 'Plattform für Gewaltprävention, Selbstbehauptung und gewaltpräventive Bildungsarbeit.', + 'blocks' => [ + [ + 'type' => 'heading', + 'heading' => 'Stark im Alltag', + 'intro' => 'Lara & Felix ist eine Plattform für Gewaltprävention, Selbstbehauptung und gewaltpräventive Bildungsarbeit. Sie unterstützt Erwachsene, die solche Angebote vorbereiten und durchführen.', + ], + [ + 'type' => 'prose', + 'body' => "Die Lerninhalte richten sich unter anderem an Kinder. Kinder sind keine Benutzerinnen und Benutzer der Plattform und brauchen kein eigenes Konto.\n\nDie Filme „Lara & Felix“ sind die erste Produktreihe. Übungen, Programme und weitere Materialien lassen sich in derselben Struktur verwalten, ohne die Plattform auf eine einzelne Episode festzulegen.", + ], + [ + 'type' => 'cards', + 'items' => [ + ['title' => 'Prävention', 'text' => 'Worum es in der Bildungsarbeit geht.', 'url' => '/praevention'], + ['title' => 'Materialien', 'text' => 'Filme und Begleitmaterial, sobald sie veröffentlicht sind.', 'url' => '/materialien'], + ['title' => 'Für Trainer und Einrichtungen', 'text' => 'Wer die Plattform nutzt.', 'url' => '/trainer'], + ], + ], + [ + 'type' => 'call_to_action', + 'heading' => 'Mitgliederbereich', + 'text' => 'Nach der Anmeldung sehen Sie die Materialien, für die eine Berechtigung vorliegt.', + 'label' => 'Anmelden', + 'url' => '/anmelden', + ], + ], + ], + '/praevention' => [ + 'seo_title' => 'Präventionskonzept', + 'seo_description' => 'Gewaltprävention und Selbstbehauptung in der Bildungsarbeit mit Kindern.', + 'blocks' => [ + [ + 'type' => 'heading', + 'heading' => 'Prävention im Alltag', + 'intro' => 'Die Plattform stellt Materialien bereit, mit denen Trainerinnen, Trainer und pädagogische Fachkräfte Präventionsangebote durchführen.', + ], + [ + 'type' => 'prose', + 'body' => "Es geht um Selbstbehauptung, das Erkennen von Grenzverletzungen und um Handlungsfähigkeit in konkreten Situationen. Die Durchführung bleibt bei den Erwachsenen vor Ort.\n\nEine Entscheidungspause in einem Film ist eine Markierung für den Präsenzkurs. Daraus wird kein digitales Quiz und keine eigenständige Lernanwendung für Kinder.", + ], + ], + ], + '/materialien' => [ + 'seo_title' => 'Filme und Lernmaterialien', + 'seo_description' => 'Veröffentlichte Filme, Übungen und Begleitmaterialien.', + 'blocks' => [ + [ + 'type' => 'heading', + 'heading' => 'Filme und Lernmaterialien', + 'intro' => 'Hier erscheinen veröffentlichte Inhalte aus dem Katalog. Die Seite kopiert keine Produkttexte und nennt keine Preise.', + ], + [ + 'type' => 'prose', + 'body' => 'Solange noch kein Lizenzartikel veröffentlicht ist, bleibt diese Übersicht leer. Dieselbe Stelle zeigt später Filme, Übungen und Begleitmaterial aus den maßgeblichen Datensätzen.', + ], + ], + ], + '/angebote' => [ + 'seo_title' => 'Angebote', + 'seo_description' => 'Lizenzangebote werden aus dem Katalog gelesen, nicht als freier Text gepflegt.', + 'blocks' => [ + [ + 'type' => 'heading', + 'heading' => 'Angebote', + 'intro' => 'Umfang, Rechte und Preise eines Angebots kommen aus dem Katalog. Sie werden hier nicht als freier Text ersetzt.', + ], + [ + 'type' => 'prose', + 'body' => 'Es sind noch keine Angebote veröffentlicht. Sobald ein Angebot aktiv ist, zeigt diese Seite seinen Umfang aus dem gespeicherten Stand.', + ], + ], + ], + '/trainer' => [ + 'seo_title' => 'Für Trainer und Einrichtungen', + 'seo_description' => 'Informationen für Gewaltschutztrainer, Übungsleiter, Fachkräfte, Vereine und Bildungseinrichtungen.', + 'blocks' => [ + [ + 'type' => 'heading', + 'heading' => 'Für Trainer und Einrichtungen', + 'intro' => 'Die Plattform ist für Erwachsene, die geeignete Präventionsangebote durchführen.', + ], + [ + 'type' => 'prose', + 'body' => "Dazu gehören Gewaltschutztrainer, Trainer und Übungsleiter, pädagogische Fachkräfte sowie Vereine und Bildungseinrichtungen.\n\nEin Konto allein öffnet keine Materialien. Sichtbar wird, was eine konkrete Berechtigung erlaubt. Organisationen können später eigene Lizenzen halten. Eine persönliche Freischaltung ist keine Organisationslizenz.", + ], + ], + ], + '/ueber' => [ + 'seo_title' => 'Über das Projekt', + 'seo_description' => 'Lara & Felix – Stark im Alltag.', + 'blocks' => [ + [ + 'type' => 'heading', + 'heading' => 'Über das Projekt', + 'intro' => 'Lara & Felix – Stark im Alltag ist eine eigenständige Plattform für Gewaltprävention, Selbstbehauptung und gewaltpräventive Bildungsarbeit.', + ], + [ + 'type' => 'prose', + 'body' => 'Die erste Produktreihe sind die vorhandenen Filme. Das Fachmodell bleibt offen für weitere Medienarten, Übungen und Programme.', + ], + ], + ], + '/impressum' => [ + 'seo_title' => 'Impressum', + 'seo_description' => 'Impressum der Plattform Lara & Felix.', + 'blocks' => [ + [ + 'type' => 'heading', + 'heading' => 'Impressum', + 'intro' => 'Die gesetzlich erforderlichen Angaben werden hier veröffentlicht, sobald sie feststehen.', + ], + [ + 'type' => 'prose', + 'body' => 'Diese Seite ist redaktionell pflegbar. Sie enthält noch keine Angaben zu einer verantwortlichen Stelle.', + ], + ], + ], + '/datenschutz' => [ + 'seo_title' => 'Datenschutz', + 'seo_description' => 'Datenschutzhinweise der Plattform Lara & Felix.', + 'blocks' => [ + [ + 'type' => 'heading', + 'heading' => 'Datenschutz', + 'intro' => 'Die Datenschutzerklärung wird hier gepflegt und ist noch nicht eingesetzt.', + ], + [ + 'type' => 'prose', + 'body' => 'Profilangaben sind standardmäßig nicht öffentlich. Geschützte Medien werden nicht über einen öffentlichen Dateipfad ausgeliefert.', + ], + ], + ], + ]; + } + + /** + * @return list + */ + private function navigation(): array + { + return [ + ['label' => 'Start', 'path' => '/', 'placement' => 'header'], + ['label' => 'Prävention', 'path' => '/praevention', 'placement' => 'header'], + ['label' => 'Materialien', 'path' => '/materialien', 'placement' => 'header'], + ['label' => 'Angebote', 'path' => '/angebote', 'placement' => 'header'], + ['label' => 'Trainer und Einrichtungen', 'path' => '/trainer', 'placement' => 'header'], + ['label' => 'Über das Projekt', 'path' => '/ueber', 'placement' => 'header'], + ['label' => 'Anmelden', 'url' => '/anmelden', 'placement' => 'header'], + ['label' => 'Impressum', 'path' => '/impressum', 'placement' => 'footer'], + ['label' => 'Datenschutz', 'path' => '/datenschutz', 'placement' => 'footer'], + ]; + } +} diff --git a/database/seeders/DatabaseSeeder.php b/database/seeders/DatabaseSeeder.php new file mode 100644 index 0000000..1eccae2 --- /dev/null +++ b/database/seeders/DatabaseSeeder.php @@ -0,0 +1,13 @@ +call(CmsSeeder::class); + } +} diff --git a/database/seeders/DemoCatalogSeeder.php b/database/seeders/DemoCatalogSeeder.php new file mode 100644 index 0000000..6fd393a --- /dev/null +++ b/database/seeders/DemoCatalogSeeder.php @@ -0,0 +1,71 @@ +where('code', 'demo-merkblatt')->exists()) { + return; + } + + $content = app(ContentService::class); + $articles = app(ArticleService::class); + $bundles = app(BundleService::class); + $offers = app(OfferService::class); + + $sheet = $content->publishElementVersion( + $content->createElement('pdf', 'pdf', 'Merkblatt Alltag'), + 'Kurzer Hinweis für die Erprobung. Kein echtes Kursmaterial.', + ); + $film = $content->publishElementVersion( + $content->createElement('film', 'film', 'Übungsfilm Alltag'), + 'Für die geschützte Wiedergabe in der Verwaltung eine Filmdatei als weitere Fassung hochladen.', + ['decision_seconds' => 42], + ); + $inner = $content->publishComposition( + $content->createComposition('Materialsatz Alltag', CompositionKind::Kombination), + [['role' => 'Merkblatt', 'target' => $sheet]], + ); + $exercise = $content->publishComposition( + $content->createComposition('Übung Alltag'), + [ + ['role' => 'Film', 'target' => $film], + ['role' => 'Materialsatz', 'target' => $inner], + ], + ); + + $sheetArticle = $articles->create('demo-merkblatt', 'Erprobung'); + $articles->publishRelease($sheetArticle, $sheet, 'Eigenständiges Merkblatt für die Erprobung.'); + $exerciseArticle = $articles->create('demo-uebung', 'Erprobung'); + $articles->publishRelease($exerciseArticle, $exercise, 'Übung aus Film und Materialsatz, zur Erprobung.'); + + $basis = $bundles->create('Demo Basis'); + $bundles->publish($basis, [$sheetArticle->fresh()]); + $program = $bundles->create('Demo Programm'); + $programVersion = $bundles->publish($program, [$basis, $exerciseArticle->fresh()]); + + $rights = $offers->createRightsProfile('Erprobung lesen und ansehen', 'ehrenamtlich', [ + 'pdf' => ['ansehen', 'laden'], + 'film' => ['streamen', 'ansehen'], + 'text' => ['ansehen'], + ]); + $free = $offers->create('Kostenloses Merkblatt'); + $offers->activate($free, [ + ['target' => $sheetArticle->fresh(), 'rights' => $rights], + ], ['grant_kind' => 'auf_abruf']); + $paid = $offers->create('Testkauf Programm'); + $offers->activate($paid, [ + ['target' => $programVersion, 'rights' => $rights], + ], ['grant_kind' => 'kauf', 'price_cents' => 500]); + } +} diff --git a/deploy/luf.env.example b/deploy/luf.env.example new file mode 100644 index 0000000..7ed4df9 --- /dev/null +++ b/deploy/luf.env.example @@ -0,0 +1,33 @@ +# Vorlage für /etc/luf/test.env bzw. /etc/luf/prod.env auf dem Zielserver. NICHT mit echten Werten einchecken. +# Test und Prod brauchen je eigene Datei, eigenen APP_KEY und eigene DB-Zugangsdaten. +# Leserechte nur für den Runner-Benutzer (chmod 640, Besitzer llmadmin). + +# Prod: production; Test: staging (das Deploy-Skript lehnt APP_ENV=production auf Test ab) +APP_ENV=staging +APP_DEBUG=false +APP_NAME="Lara und Felix" +# erzeugen mit: php artisan key:generate --show +APP_KEY= +# Adresse, unter der diese Instanz im Browser erreichbar ist. +# Test derzeit: http://192.168.2.144:3011. Steht hier der Platzhalter, +# nutzt die App für Anfragen die Adresse des Browsers. +APP_URL=https://CHANGE-ME.example + +DB_CONNECTION=pgsql +DB_DATABASE=luf_test +DB_USERNAME=luf_test +DB_PASSWORD= + +SESSION_DRIVER=database +CACHE_STORE=database +QUEUE_CONNECTION=database +LOG_CHANNEL=stderr + +MAIL_MAILER=log +MAIL_FROM_ADDRESS="noreply@example.invalid" +MAIL_FROM_NAME="${APP_NAME}" + +# test bleibt der lokale Testweg. Ein echter Zahlungsdienst ist noch nicht festgelegt. +PAYMENT_DRIVER=test + +# Medienpfade setzt Compose auf den Host-Mount (/srv/luf//media/...). Hier nichts eintragen. diff --git a/docker-compose.yml b/docker-compose.yml new file mode 100644 index 0000000..a405203 --- /dev/null +++ b/docker-compose.yml @@ -0,0 +1,129 @@ +# LUF – Compose für Test und Produktion. Der Unterschied liegt nur in Projektname, Env-Datei und Web-Port, +# die das Deploy-Skript setzt (scripts/deploy.sh). Es gibt keine festen Host-Ports außer dem Web-Port. +# +# Pflicht-Variablen (vom Skript exportiert): LUF_ENV (test|prod), LUF_TAG, LUF_ENV_FILE, LUF_WEB_PORT +# Medien: LUF_MEDIA_HOST (setzt das Deploy-Skript auf /srv/luf//media, NFS-Mount vom NAS). +# Im Container gilt derselbe Pfad wie auf dem Host. Unterordner: +# originals/ nur queue (lesen+schreiben); der Web-Prozess (app) hat KEINEN Zugriff (Architektur 03/08) +# derived/ queue schreibt, app liest nur (private Ableitungen, Auslieferung nur über Signatur) +# public/ queue schreibt, app liest nur (bewusst öffentliche Medien) +# Pflicht in der Env-Datei: DB_DATABASE, DB_USERNAME, DB_PASSWORD (siehe deploy/luf.env.example) + +x-logging: &logging + driver: json-file + options: + max-size: "10m" + max-file: "3" + +services: + db: + image: postgres:17-alpine + restart: unless-stopped + environment: + POSTGRES_DB: ${DB_DATABASE:?DB_DATABASE fehlt} + POSTGRES_USER: ${DB_USERNAME:?DB_USERNAME fehlt} + POSTGRES_PASSWORD: ${DB_PASSWORD:?DB_PASSWORD fehlt} + volumes: + - db-data:/var/lib/postgresql/data + healthcheck: + test: ["CMD-SHELL", "pg_isready -U $${POSTGRES_USER} -d $${POSTGRES_DB}"] + interval: 5s + timeout: 5s + retries: 20 + logging: *logging + + app: + build: + context: . + target: app + image: luf-app-${LUF_ENV:?}:${LUF_TAG:?} + restart: unless-stopped + env_file: ${LUF_ENV_FILE:?} + environment: + DB_HOST: db + DB_PORT: "5432" + MEDIA_PUBLIC_PATH: ${LUF_MEDIA_HOST:?}/public + MEDIA_DERIVED_PATH: ${LUF_MEDIA_HOST:?}/derived + MEDIA_ORIGINALS_PATH: ${LUF_MEDIA_HOST:?}/originals + volumes: + - storage-data:/var/www/html/storage + - type: bind + source: ${LUF_MEDIA_HOST:?}/derived + target: ${LUF_MEDIA_HOST:?}/derived + read_only: true + bind: + create_host_path: false + - type: bind + source: ${LUF_MEDIA_HOST:?}/public + target: ${LUF_MEDIA_HOST:?}/public + read_only: true + bind: + create_host_path: false + depends_on: + db: + condition: service_healthy + logging: *logging + + web: + build: + context: . + target: web + image: luf-web-${LUF_ENV:?}:${LUF_TAG:?} + restart: unless-stopped + ports: + - "${LUF_WEB_PORT:?}:80" + depends_on: + - app + logging: *logging + + queue: + image: luf-app-${LUF_ENV:?}:${LUF_TAG:?} + restart: unless-stopped + command: ["php", "artisan", "queue:work", "--tries=3", "--timeout=3600", "--max-time=3600"] + env_file: ${LUF_ENV_FILE:?} + environment: + DB_HOST: db + DB_PORT: "5432" + MEDIA_PUBLIC_PATH: ${LUF_MEDIA_HOST:?}/public + MEDIA_DERIVED_PATH: ${LUF_MEDIA_HOST:?}/derived + MEDIA_ORIGINALS_PATH: ${LUF_MEDIA_HOST:?}/originals + volumes: + - storage-data:/var/www/html/storage + - type: bind + source: ${LUF_MEDIA_HOST:?}/originals + target: ${LUF_MEDIA_HOST:?}/originals + bind: + create_host_path: false + - type: bind + source: ${LUF_MEDIA_HOST:?}/derived + target: ${LUF_MEDIA_HOST:?}/derived + bind: + create_host_path: false + - type: bind + source: ${LUF_MEDIA_HOST:?}/public + target: ${LUF_MEDIA_HOST:?}/public + bind: + create_host_path: false + depends_on: + db: + condition: service_healthy + logging: *logging + + scheduler: + image: luf-app-${LUF_ENV:?}:${LUF_TAG:?} + restart: unless-stopped + command: ["php", "artisan", "schedule:work"] + env_file: ${LUF_ENV_FILE:?} + environment: + DB_HOST: db + DB_PORT: "5432" + volumes: + - storage-data:/var/www/html/storage + depends_on: + db: + condition: service_healthy + logging: *logging + +volumes: + db-data: + storage-data: diff --git a/docker/entrypoint.sh b/docker/entrypoint.sh new file mode 100644 index 0000000..636dfd4 --- /dev/null +++ b/docker/entrypoint.sh @@ -0,0 +1,17 @@ +#!/bin/sh +# Container-Start: Schreibrechte für storage, Laravel-Caches (nur php-fpm), dann Dienst als www-data. +set -e +cd /var/www/html + +mkdir -p storage/framework/cache/data storage/framework/sessions storage/framework/views storage/logs bootstrap/cache +chown -R www-data:www-data storage bootstrap/cache + +if [ "$1" = "php-fpm" ]; then + su-exec www-data php artisan config:cache + su-exec www-data php artisan route:cache + su-exec www-data php artisan view:cache + su-exec www-data php artisan event:cache + exec "$@" +fi + +exec su-exec www-data "$@" diff --git a/docker/nginx/default.conf b/docker/nginx/default.conf new file mode 100644 index 0000000..1028c37 --- /dev/null +++ b/docker/nginx/default.conf @@ -0,0 +1,34 @@ +server { + listen 80; + server_name _; + root /var/www/html/public; + index index.php; + + client_max_body_size 2048m; + client_body_timeout 3600s; + send_timeout 3600s; + + location / { + try_files $uri $uri/ /index.php?$query_string; + } + + location ~ \.php$ { + fastcgi_pass app:9000; + fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name; + include fastcgi_params; + set $forwarded_proto $http_x_forwarded_proto; + if ($forwarded_proto = "") { + set $forwarded_proto $scheme; + } + fastcgi_param HTTP_X_FORWARDED_PROTO $forwarded_proto; + fastcgi_param HTTP_X_FORWARDED_HOST $http_x_forwarded_host if_not_empty; + fastcgi_param HTTP_X_FORWARDED_PORT $http_x_forwarded_port if_not_empty; + fastcgi_param HTTP_X_FORWARDED_FOR $proxy_add_x_forwarded_for; + fastcgi_read_timeout 3600s; + fastcgi_send_timeout 3600s; + } + + location ~ /\.(?!well-known) { + deny all; + } +} diff --git a/docker/php.ini b/docker/php.ini new file mode 100644 index 0000000..c71e7c4 --- /dev/null +++ b/docker/php.ini @@ -0,0 +1,9 @@ +memory_limit = 512M +upload_max_filesize = 2048M +post_max_size = 2048M +max_execution_time = 3600 +max_input_time = 3600 +expose_php = Off +opcache.enable = 1 +opcache.validate_timestamps = 0 +opcache.max_accelerated_files = 20000 diff --git a/docs/Brand-UI-Kit/04_visuelle_entwuerfe/brand_ui_uebersicht_entwurf.png b/docs/Brand-UI-Kit/04_visuelle_entwuerfe/brand_ui_uebersicht_entwurf.png new file mode 100644 index 0000000..edd4328 Binary files /dev/null and b/docs/Brand-UI-Kit/04_visuelle_entwuerfe/brand_ui_uebersicht_entwurf.png differ diff --git a/docs/Brand-UI-Kit/04_visuelle_entwuerfe/homepage_entwurf.png b/docs/Brand-UI-Kit/04_visuelle_entwuerfe/homepage_entwurf.png new file mode 100644 index 0000000..4a25726 Binary files /dev/null and b/docs/Brand-UI-Kit/04_visuelle_entwuerfe/homepage_entwurf.png differ diff --git a/docs/Brand-UI-Kit/05_web_preview/assets/denkpause_original.webp b/docs/Brand-UI-Kit/05_web_preview/assets/denkpause_original.webp new file mode 100644 index 0000000..91f0c12 Binary files /dev/null and b/docs/Brand-UI-Kit/05_web_preview/assets/denkpause_original.webp differ diff --git a/docs/Brand-UI-Kit/05_web_preview/assets/outro_original.webp b/docs/Brand-UI-Kit/05_web_preview/assets/outro_original.webp new file mode 100644 index 0000000..92d90d7 Binary files /dev/null and b/docs/Brand-UI-Kit/05_web_preview/assets/outro_original.webp differ diff --git a/docs/Brand-UI-Kit/05_web_preview/assets/titel_original.webp b/docs/Brand-UI-Kit/05_web_preview/assets/titel_original.webp new file mode 100644 index 0000000..324a56f Binary files /dev/null and b/docs/Brand-UI-Kit/05_web_preview/assets/titel_original.webp differ diff --git a/docs/Brand-UI-Kit/05_web_preview/bibliothek.html b/docs/Brand-UI-Kit/05_web_preview/bibliothek.html new file mode 100644 index 0000000..b2ded49 --- /dev/null +++ b/docs/Brand-UI-Kit/05_web_preview/bibliothek.html @@ -0,0 +1 @@ +Lara & Felix – Designkonzept Bibliothek
Mitgliederbereich · Layoutentwurf

Meine Bibliothek

Alles für die nächste Kursstunde an einem Ort.

Alle InhalteFilmeÜbungenMaterialienProgramme
Film
DEMO · kein echter Artikel

Film zur Erprobung

Ein Film kann mit Übungen und Materialien verbunden sein.

○ Zugang aus Berechtigung
Übung
DEMO · kein echter Artikel

Nachdenken und sprechen

Das Material kann in mehreren Kompositionen genutzt werden.

○ Zugang aus Berechtigung
Dokument
DEMO · kein echter Artikel

Begleitmaterial

Trainerunterlagen erscheinen als eigenständige Medientypen.

○ Zugang aus Berechtigung
Hinweis zur LizenzansichtEin Lizenzartikel soll einmal sichtbar sein, auch wenn mehrere Erwerbsquellen vorhanden sind. Einzelne Rechte bleiben getrennt prüfbar.
\ No newline at end of file diff --git a/docs/Brand-UI-Kit/05_web_preview/index.html b/docs/Brand-UI-Kit/05_web_preview/index.html new file mode 100644 index 0000000..4d21149 --- /dev/null +++ b/docs/Brand-UI-Kit/05_web_preview/index.html @@ -0,0 +1 @@ +Lara & Felix – Designkonzept Startseite
Für Trainer und pädagogische Fachkräfte

Geschichten, die Kinder stärken.

Filme und praxisnahe Materialien für Gewaltprävention, Selbstbehauptung und gemeinsame Gespräche.

Gestaltungsvorschau – funktionale Angebote und Aussagen vor Veröffentlichung prüfen.

Unser Ansatz

Aus dem Alltag. Für den Alltag.

Die Filme schaffen Gesprächsanlässe. Trainer gestalten daraus Übungen, Reflexion und gemeinsames Lernen.

▣

Geschichten erleben

Anschauliche Situationen aus einer vertrauten Lebenswelt als Einstieg in den Kurs.

?

Gemeinsam nachdenken

Bewusste Denkpausen geben Raum für Fragen, Gespräche und eigene Ideen.

✓

Handeln üben

Begleitmaterial und Aufgaben helfen, das Gespräch praktisch fortzuführen.

Einblicke

Filme und Materialien

Beispielhafte Darstellung möglicher Medientypen; keine realen Katalogangebote.

Film · Beispiel

Alltagssituation

Videogestützte Einstiege in das gemeinsame Training.

Didaktik · Beispiel

Denkpause

Ein bewusstes Innehalten für Fragen und Austausch.

Material · Beispiel

Trainermaterial

Praktische Materialien können Filme ergänzen und verbinden.

Lara & FelixStark im Alltag · Designkonzept, keine Live-Webseite

Dieses UI-Kit verwendet konzeptionelle Texte und keine tatsächlichen Preise, Angebote oder Kundenangaben.

\ No newline at end of file diff --git a/docs/Brand-UI-Kit/05_web_preview/player.html b/docs/Brand-UI-Kit/05_web_preview/player.html new file mode 100644 index 0000000..1374845 --- /dev/null +++ b/docs/Brand-UI-Kit/05_web_preview/player.html @@ -0,0 +1 @@ +Lara & Felix – Designkonzept Kursplayer
Meine Bibliothek / Film / Kursplayer

Denkpause: Was würdet ihr tun?

Gestaltungsvorschau · der Player ist nicht mit echten Medien oder Rechten verbunden.

Didaktischer Moment

Gespräch in der Gruppe

Die Denkpause bietet einen natürlichen Moment, um mit den Kindern über Handlungsoptionen zu sprechen. Die tatsächliche Fortsetzung wird später im funktionalen Player eingebunden.

Zur Bibliothek
Trainermaterial

Begleitende Unterlagen

Trainerhinweise, Übungen und Arbeitsblätter werden an dieser Stelle aus der wirklichen Artikelkomposition geladen.

Layoutentwurf
Lara & FelixStark im Alltag · Designkonzept, keine Live-Webseite

Dieses UI-Kit verwendet konzeptionelle Texte und keine tatsächlichen Preise, Angebote oder Kundenangaben.

\ No newline at end of file diff --git a/docs/Brand-UI-Kit/05_web_preview/screenshots/bibliothek_desktop.png b/docs/Brand-UI-Kit/05_web_preview/screenshots/bibliothek_desktop.png new file mode 100644 index 0000000..d4f7050 Binary files /dev/null and b/docs/Brand-UI-Kit/05_web_preview/screenshots/bibliothek_desktop.png differ diff --git a/docs/Brand-UI-Kit/05_web_preview/screenshots/bibliothek_mobil.png b/docs/Brand-UI-Kit/05_web_preview/screenshots/bibliothek_mobil.png new file mode 100644 index 0000000..5909a1c Binary files /dev/null and b/docs/Brand-UI-Kit/05_web_preview/screenshots/bibliothek_mobil.png differ diff --git a/docs/Brand-UI-Kit/05_web_preview/screenshots/index_desktop.png b/docs/Brand-UI-Kit/05_web_preview/screenshots/index_desktop.png new file mode 100644 index 0000000..ec62a44 Binary files /dev/null and b/docs/Brand-UI-Kit/05_web_preview/screenshots/index_desktop.png differ diff --git a/docs/Brand-UI-Kit/05_web_preview/screenshots/index_mobil.png b/docs/Brand-UI-Kit/05_web_preview/screenshots/index_mobil.png new file mode 100644 index 0000000..29ed5b7 Binary files /dev/null and b/docs/Brand-UI-Kit/05_web_preview/screenshots/index_mobil.png differ diff --git a/docs/Brand-UI-Kit/05_web_preview/screenshots/player_desktop.png b/docs/Brand-UI-Kit/05_web_preview/screenshots/player_desktop.png new file mode 100644 index 0000000..3580bc6 Binary files /dev/null and b/docs/Brand-UI-Kit/05_web_preview/screenshots/player_desktop.png differ diff --git a/docs/Brand-UI-Kit/05_web_preview/screenshots/player_mobil.png b/docs/Brand-UI-Kit/05_web_preview/screenshots/player_mobil.png new file mode 100644 index 0000000..665c729 Binary files /dev/null and b/docs/Brand-UI-Kit/05_web_preview/screenshots/player_mobil.png differ diff --git a/docs/Brand-UI-Kit/05_web_preview/site.css b/docs/Brand-UI-Kit/05_web_preview/site.css new file mode 100644 index 0000000..5fb5f93 --- /dev/null +++ b/docs/Brand-UI-Kit/05_web_preview/site.css @@ -0,0 +1,10 @@ +@import url('https://fonts.googleapis.com/css2?family=Nunito:wght@500;600;700;800;900&family=Nunito+Sans:wght@400;500;600;700;800&display=swap'); +:root {--navy:#032551;--navy2:#01244c;--green:#5B8625;--yellow:#FCD10A;--cream:#F7F6F2;--paper:#FBFBF7;--muted:#5D6A78;--line:#E0E9E0;--shadow:0 18px 45px rgba(3,37,81,.07)} +*,*:before,*:after{box-sizing:border-box}body{margin:0;background:#FBFBF7;color:#162b45;font:16px/1.55 'Nunito Sans','Segoe UI',sans-serif}button,a{font:inherit}a{color:inherit;text-decoration:none}img{max-width:100%}h1,h2,h3{font-family:'Nunito','Trebuchet MS',sans-serif;line-height:1.15;letter-spacing:-.035em;color:var(--navy)}h1{font-size:clamp(34px,4vw,60px)}h2{font-size:clamp(25px,2.5vw,36px)}p{margin:0 0 1rem}.wrap{width:min(1180px,calc(100% - 56px));margin:auto} +.top{background:white;border-bottom:1px solid #eef1eb;position:relative;z-index:10}.nav{height:82px;display:flex;align-items:center;justify-content:space-between;gap:28px}.brand{line-height:.92;color:var(--navy);font-family:'Nunito',sans-serif;font-weight:900;letter-spacing:-.05em;font-size:25px;transform:rotate(-1deg)}.brand>small{display:block;width:max-content;background:var(--green);font-size:11px;letter-spacing:0;color:white;padding:5px 11px;border-radius:20px;margin-top:5px}.brand:after{content:'';display:block;width:82%;height:5px;border-radius:90%;background:var(--yellow);transform:rotate(-2deg);margin-top:-25px;position:relative;top:-1px;z-index:-1}.links{display:flex;gap:28px;align-items:center;font-size:14px;font-weight:800;color:#19334c}.links a:focus-visible,.btn:focus-visible{outline:3px solid #1676ac;outline-offset:3px}.links a:not(.btn):hover{color:var(--green)}.btn{display:inline-flex;gap:8px;justify-content:center;align-items:center;border-radius:999px;padding:12px 21px;font-size:14px;font-weight:900;white-space:nowrap;border:1px solid transparent;transition:transform .18s,box-shadow .18s}.btn:hover{transform:translateY(-2px);box-shadow:0 8px 22px rgba(3,37,81,.15)}.btn.primary{background:var(--navy);color:white}.btn.green{background:var(--green);color:white}.btn.outline{background:white;color:var(--navy);border-color:#c8d5d6}.btn.yellow{background:var(--yellow);color:var(--navy)} +.flag{font-size:11px;letter-spacing:.11em;text-transform:uppercase;font-weight:900;color:var(--green);display:inline-flex;align-items:center;gap:9px}.flag:before{content:'';width:26px;height:4px;background:var(--yellow);border-radius:4px}.hero{background:#f0f2e8;overflow:hidden}.hero-picture{position:relative;min-height:560px;background-image:url('assets/outro_original.webp');background-position:center;background-size:cover}.hero-text{position:absolute;left:52%;top:24%;max-width:520px;padding:10px}.hero-text h1{font-size:clamp(33px,4vw,61px);margin:10px 0 22px;letter-spacing:-.045em}.hero-text p{font-size:17px;max-width:420px}.hero-actions{display:flex;gap:12px;flex-wrap:wrap;margin-top:24px}.hero-note{font-size:12px;color:var(--muted);margin-top:20px}.section{padding:80px 0}.intro-head{display:flex;align-items:flex-end;justify-content:space-between;gap:30px;margin-bottom:29px}.intro-head h2{margin:8px 0 0}.intro-head>p{max-width:420px;color:var(--muted)}.features{display:grid;grid-template-columns:repeat(3,1fr);gap:16px}.feature{background:white;border:1px solid var(--line);border-radius:22px;padding:28px;min-height:178px;box-shadow:var(--shadow)}.feature .sym{height:46px;width:46px;background:#e6f0dc;border-radius:14px;display:grid;place-items:center;font-size:23px}.feature h3{font-size:21px;margin:18px 0 7px}.feature p{color:var(--muted);font-size:14px}.offwhite{background:#F2F5ED}.card-grid{display:grid;grid-template-columns:repeat(3,1fr);gap:18px}.media-card{background:white;border-radius:20px;overflow:hidden;box-shadow:var(--shadow);border:1px solid var(--line)}.media-card .photo{height:190px;background-size:cover;background-position:center;position:relative}.photo .type{position:absolute;bottom:13px;left:13px;background:#fff;border-radius:20px;padding:5px 10px;color:var(--navy);font-size:12px;font-weight:900}.media-card .body{padding:20px}.media-card h3{margin:0 0 10px;font-size:20px}.media-card p{font-size:14px;color:var(--muted);margin:0}.pill{display:inline-block;background:#eaf1e3;color:#365e1d;padding:6px 11px;border-radius:25px;font-size:12px;font-weight:900}.foot{background:var(--navy);color:#d3e2ed;padding:45px 0}.foot .wrap{display:flex;justify-content:space-between;gap:25px;align-items:center}.foot p{font-size:13px;margin:0}.foot strong{font-family:Nunito,sans-serif;color:white;font-size:21px}.foot small{display:block;color:#c0d7e3} +/* library */.app-bg{background:#f4f7f4;min-height:100vh}.apphead{background:white;border-bottom:1px solid #e4e8e6}.appwrap{max-width:1260px;margin:auto;display:grid;grid-template-columns:210px 1fr;min-height:calc(100vh - 82px)}.side{padding:36px 18px 30px;border-right:1px solid #e1e9e8}.side a{display:block;margin:7px 0;padding:11px 14px;border-radius:12px;font-weight:800;font-size:14px}.side a.active{background:#e4efe4;color:var(--green)}.main{padding:37px 40px 70px}.dash-head{display:flex;align-items:flex-end;justify-content:space-between;gap:20px}.dash-head h1{font-size:39px;margin:8px 0}.dash-head p{color:var(--muted)}.search{background:white;border:1px solid #d7e2e0;border-radius:100px;min-width:280px;padding:12px 18px;color:#8995a0;font-size:14px}.filters{display:flex;gap:8px;margin:26px 0 24px;flex-wrap:wrap}.filter{background:white;border:1px solid #dde7e3;border-radius:20px;padding:8px 15px;font-weight:800;font-size:12px}.filter.on{background:var(--navy);color:white}.library-grid{display:grid;grid-template-columns:repeat(3,1fr);gap:18px}.library-grid .photo{height:158px}.media-card .small{color:#55707d;font-weight:700;font-size:12px}.media-card .status{margin-top:15px;display:inline-block;color:#376f1c;background:#edf5e8;padding:6px 10px;border-radius:20px;font-size:12px;font-weight:900}.notice{margin-top:30px;padding:19px 23px;border-radius:18px;background:#e8f0de;display:flex;gap:15px;align-items:center;font-size:14px;color:#35532a}.notice strong{color:#254316} +/* player */.player-wrap{max-width:1060px;margin:50px auto 100px;padding:0 28px}.crumb{font-size:13px;font-weight:800;color:#6b7d86}.player-wrap h1{font-size:38px;margin:16px 0 10px}.player-wrap .sub{color:var(--muted);margin-bottom:25px}.player{position:relative;aspect-ratio:16/9;background:var(--navy);border-radius:24px;overflow:hidden;box-shadow:0 20px 56px rgba(3,37,81,.15)}.player .still{position:absolute;inset:0;background:url('assets/denkpause_original.webp') center/cover}.player:after{content:'';position:absolute;inset:65% 0 0;background:linear-gradient(transparent,rgba(3,37,81,.45));pointer-events:none}.player-controls{position:absolute;bottom:18px;left:25px;right:25px;display:flex;align-items:center;gap:15px;z-index:1;color:white;font-weight:800}.progress{height:6px;background:#ffffff78;border-radius:6px;flex:1}.progress:before{content:'';display:block;width:41%;height:100%;background:var(--yellow);border-radius:6px}.under-player{display:grid;grid-template-columns:1.5fr 1fr;gap:18px;margin-top:22px}.panel{padding:28px;background:white;border:1px solid var(--line);border-radius:20px}.panel h3{margin:0 0 12px;font-size:20px}.panel p{font-size:14px;color:var(--muted)} +@media (max-width:980px){.nav{height:74px}.links a:not(.btn){display:none}.hero-picture{min-height:500px;background-position:40% center}.hero-text{left:52%;top:19%;max-width:400px}.hero-text h1{font-size:39px}.features,.card-grid,.library-grid{grid-template-columns:repeat(2,1fr)}.appwrap{grid-template-columns:170px 1fr}.main{padding:24px}.under-player{grid-template-columns:1fr}} +@media (max-width:680px){.wrap{width:min(100% - 32px,560px)}.brand{font-size:22px}.brand>small{font-size:10px}.links{gap:7px}.links a.btn:first-of-type{display:none}.links a.btn{padding:9px 13px;font-size:12px}.hero-picture{min-height:0;aspect-ratio:1.4/1;background-size:cover;background-position:17% center}.hero-text{position:static;background:#fbfbf7;padding:27px 18px 40px;max-width:none}.hero-text h1{font-size:36px}.hero-text p{font-size:15px}.hero-actions{gap:9px}.hero-note{margin-top:15px}.section{padding:48px 0}.intro-head{display:block}.features,.card-grid,.library-grid{grid-template-columns:1fr}.feature{min-height:auto}.media-card .photo{height:210px}.foot .wrap{display:block}.foot p{margin-top:10px}.appwrap{display:block}.side{display:flex;overflow:auto;padding:10px 16px;gap:5px;border-right:0;border-bottom:1px solid #e1e9e8}.side a{white-space:nowrap}.main{padding:30px 16px}.dash-head{display:block}.dash-head h1{font-size:32px}.search{width:100%;margin-top:18px}.library-grid .photo{height:190px}.player-wrap{margin:25px auto 70px;padding:0 16px}.player-wrap h1{font-size:28px}.player{border-radius:14px}.player-controls{bottom:10px;left:10px;right:10px;font-size:10px;gap:5px}.panel{padding:20px}} +@media(prefers-reduced-motion: reduce){*,*:before,*:after{scroll-behavior:auto!important;transition:none!important;animation:none!important}} diff --git a/docs/analysen/abschlussbericht-mvp-2026-11-16.md b/docs/analysen/abschlussbericht-mvp-2026-11-16.md new file mode 100644 index 0000000..3aba06b --- /dev/null +++ b/docs/analysen/abschlussbericht-mvp-2026-11-16.md @@ -0,0 +1,165 @@ +# Abschlussbericht: MVP-Beauftragung Mitgliederbibliothek + +**Stand:** 16.11.2026 +**Branch:** `develop`, Commit `30833f6` +**Testinstanz:** `luf-test` auf `llm-node`, Port 3011, Image `luf-app-test:30833f62a1e1` und `luf-web-test:30833f62a1e1` +**Grundlage:** `docs/analysen/umsetzungsplan-mitgliederbibliothek.md`, Verträge G1–G9, Ergänzung E-W12, die beiden Zusatzaufträge UX/UI des Mitgliederbereichs und fachliche Inhaltsverwaltung + +Dieser Bericht schließt die Beauftragung ab. Er ist keine kommerzielle Freigabe. Der Plan macht Tor B zur Abnahme der Pakete 1 bis 8. Dieser Lauf ist nicht ausgeführt. + +`docs/betrieb/MVP-Stand.md` beschreibt eine frühere Scheibe und ist durch diesen Bericht überholt. + +## Auftrag + +Umgesetzt werden sollten die Pakete 1 bis 9 des Umsetzungsplans, die Verträge G1 bis G9 und die didaktischen Metadaten E-W12. Gearbeitet wurde auf `develop`. Ein Push dorthin deployt die Testinstanz. Produktion und `main` wurden nicht angefasst. + +Zwei Zusatzaufträge gehören dazu: + +1. **Mitgliederbereich.** Der Kursraum für erwachsene Trainer folgt der vorgesehenen Gliederung und den vorhandenen Gestaltungsprinzipien. Nicht freigegebene Markenwerte bleiben austauschbare Tokens. Die Fläche darf nicht wie ein umbenanntes Filament aussehen. Geprüft wird in den Breiten 390, 768 und 1440 Pixel. +2. **Fachliche Inhaltsverwaltung.** Eine Person ohne technischen Hintergrund legt in der vorhandenen Verwaltung Medien und Dokumente an, beschreibt und ordnet sie, führt Fassungen, baut Module und Programme mit Lernziel, Zeit, Material und geordneten Bestandteilen, sucht vorhandene Inhalte einschließlich einer konkreten Fassung, ändert Rolle, Reihenfolge und Verschachtelung, sieht die Verwendung, unterscheidet Entwurf, technische Bereitschaft, Anzeigefreigabe und historische Fassungen, prüft die Struktur und gibt sie frei, hängt Lizenzartikel und Angebote an und nutzt die Abdeckungsprüfung. Die Beschriftung ist fachlich. Der Nachweis läuft durch die Oberfläche, nicht durch Seeder oder SQL. + +Bewusst außerhalb bleiben Denkpause, Ablaufsteuerung, Präsentationsmodus, Fortschritt, zweites Gerät, Community, echter Zahlungsdienst, Organisationslizenzen, konkrete Preise, die Marketingstrecke M1–M3, ein Neubau der öffentlichen Website und der Editor-Prototyp W-P als zweites CMS. W-P bleibt der dokumentierte Wegwerfstand auf `feature/w-p-editor-prototype` (`docs/analysen/wp-editor-prototyp-2026-03-15.md`). + +## Ergebnis in einem Satz + +Die Pakete 1 bis 8, E-W12 und beide Zusatzaufträge sind im Code, in der Suite und auf der Testinstanz vorhanden und am Trainingsprogramm **Programm Abstand** durch die Oberfläche benutzbar. Die geplante Abschlussprüfung Tor B und drei eng umrissene Paketpunkte sind offen. + +## Prüfstand + +| | | +|---|---| +| Suite vor dem letzten Push | 76 Tests, 406 Zusicherungen, grün | +| Gate | `scripts/ci-test.sh`: Pint und `php artisan test` in einem Wegwerf-Container | +| Instanz | `http://192.168.2.144:3011/up` antwortet 200 | +| Medien | NFS `/srv/luf/test/media`. Der Web-Prozess schreibt die Ableitungen nicht. Die Queue schreibt Vorschaubilder und HLS nach `derived/`. | +| Demokatalog | Der Deploy legt ihn nicht mehr an. Der vorherige grüne Deploy hatte ihn einmal neu erzeugt. Diese Zeilen sind auf der Testinstanz wieder entfernt. | + +Der erste Push der Medienableitung (`c997eb5`) ist am Image-Bau gescheitert, weil die Lockdatei mit einer neueren npm-Version geschrieben war als im Image. `295f784` gleicht die Lockdatei mit npm 10.9.9 ab. Danach sind die Images durchgelaufen. + +## Pakete + +| Paket | Stand | Was vorliegt | +|---|---|---| +| 0 Befund | erledigt, historisch | `docs/analysen/befund-paket-0-testinstanz-2026-03-15.md`. Zum Zeitpunkt des Befunds keine doppelte aktive Angebotsfassung. Der heutige Testbestand ist der Abstand-Graph nach der freigegebenen Löschung der alten Testzeilen. Produktion wurde nicht gelesen. | +| 1 Angebotsfassung | umgesetzt | Eine Aktivierung beendet die bisher aktive Fassung desselben Angebots. Registrierung und Kauf lesen eine aktive Fassung. Neue Bestellzeilen speichern die Bezeichnung. Parallelität ist durch einen Test abgedeckt. | +| 2 Inhaltsart | umgesetzt | `CompositionKind` bleibt `kurs`, `uebung`, `kombination`. Die Inhaltsart ist eine eigene Achse mit den Werten Programm, Modul, Merkblatt und Traineranleitung. Die Erklärung des Enums enthält weiterhin „Ein Kurs ist keine Übung“. | +| 3 Bibliothek | umgesetzt | G1 liest eine ausdrücklich angegebene Fassung unabhängig von der Anzeigefreigabe. G2 gibt Fassungen zur Anzeige frei und nimmt sie zurück. Die Bibliothek zeigt Programme, Module und Material. Teilrechte bleiben sichtbar, nicht getragene Blätter haben keine Datei. `DecideAccess` entscheidet je Abruf. Zwei Grants werden nicht vereinigt. | +| 4 Stammdaten | umgesetzt | Anzeigetitel und Kurzbeschreibung liegen an der Identität, mit Protokoll. Sie erzeugen keine neue Lehrfassung. Die Bibliothek liest sie, sobald sie gefüllt sind. | +| 5 Dimensionen und Filter | umgesetzt | Dimensionen sind pflegbar. Die fünf Säulen sind Startwerte und bleiben als Spalten erhalten. Direkte Zuordnung an Kompositionen ist von abgeleiteten Themen getrennt. Die Bibliothek sucht und filtert. Eine Säule vergibt keine Berechtigung. | +| 6 Vorschaubilder | umgesetzt, mit einer Lücke | Bild an Medium und Zusammenstellung, Alternativtext, Platzhalter, keine öffentliche Route, keine neue Inhaltsfassung. Ein Film liefert ein Bild aus dem ersten Frame. Eine wählbare Zeitposition fehlt. | +| 7 Vorschau und Abdeckung | umgesetzt | Die Maske zeigt die Verwendung. Die Redaktion sieht denselben Baum wie das Mitglied. Eine Aktivierung nennt fehlende Blätter und nimmt ein ungedecktes Programm nicht still auf. | +| 8 Medienausgabe | umgesetzt, in der vereinbarten Ehrlichkeit | Drei HLS-Stufen, signierte Playlists und Segmente, Nachweis je Ausgabe mit Kopiennummer, Prüfsumme und Kennzeichnung. Ohne Streamrecht keine Variante, ohne Laderecht keine Quelldatei. Eine schon gespeicherte Datei bleibt lesbar, bis eine Ableitung existiert. Texte im Leser tragen die sichtbare Lizenzzeile. Dateibytes von Film und PDF werden nicht gestempelt. | +| 9 Tor A / Tor B | nicht bestanden | Die lokale Suite und ein Durchlauf des Abstand-Programms ersetzen den verlangten HTTP-Lauf gegen die Testinstanz nicht. Eine wiederholbare Instanz-Suite (G9) ist nicht angelegt. | + +## Verträge + +| Vertrag | Stand | +|---|---| +| G1 Strukturleser | eine Klasse neben `ContentResolver`, ohne Person und ohne Berechtigung | +| G2 Anzeigefreigabe | je Kompositionsfassung, mit Bearbeiter und Zeitpunkt, unabhängig von `bereit` | +| G3 Inhaltsart | konfigurierbare Werte, setzen ändert `kind` und `output_class` nicht | +| G4 Anzeigefelder | ein Titel und eine Kurzbeschreibung für die Bibliothek, mit Protokoll | +| G5 Dimensionen | stabile Kennungen, Säulen behalten ihre Identität, direkt und abgeleitet bleiben unterscheidbar | +| G6 Bildableitung | ein Queue-Auftrag, geschützte Ablage unter `vorschau/` | +| G7 Abdeckungsbefund | lesbar vor der Aktivierung | +| G8 aktive Angebotsfassung | eine aktive Fassung, bei Alt-Dubletten die höchste Nummer | +| G9 Instanz-Suite | nicht gebaut | +| E-W12 | Lernziel, Zeitbedarf und Materialbedarf an der Kompositionsfassung; eine Änderung erzeugt eine neue Fassung | + +## Zusatz 1: Mitgliederbereich + +Der Kursraum ist eine eigene Oberfläche, nicht die Verwaltungsoptik. Überschriften, Suche, Säulenfilter, Verfügbarkeit und die Karten sprechen von Programmen, Modulen und Material. Die untere Navigation führt zu Bibliothek, Programmen, Modulen, Material und Lizenzen. + +Die Gestaltung wurde auf der Testinstanz in 390, 768 und 1440 Pixel geprüft. Nach dem Player-Fix wurde die Seite von Programm Abstand erneut bei 390 Pixel geprüft: kein horizontaler Überlauf, der Film lädt. Markenwerte, die nicht freigegeben sind, wurden nicht erfunden. Die Programmkarte zeigt den Platzhalter, weil für dieses Programm kein eigenes Vorschaubild hochgeladen wurde. Das abgeleitete Bild von „Lara im Park“ liegt am Medium. + +## Zusatz 2: Fachliche Inhaltsverwaltung + +Die Redaktion arbeitet weiter unter `/verwaltung`. Die Navigation heißt Medien, Fachliche Kombinationen, Module, Programme, Fachliche Säulen, Lizenzartikel, Pakete, Rechteprofile und Angebote. Die Programmliste erklärt: „Ein Programm aus Modulen und weiteren Inhalten.“ Die gespeicherte Art bleibt Kurs, Übung oder Kombination. Die Maske nennt das Feld Zusammenstellung. + +Auf der Testinstanz wurde der folgende Weg durch die Oberfläche angelegt und danach erneut geöffnet: + +| Schritt | Ergebnis | +|---|---| +| Trainerunterlage Abstand | Text, Fassung 1: „Im Kurs zuerst den Abstand ansprechen, dann das Blatt austeilen.“ | +| Modul Abstand | Unterlage plus Film „Lara im Park“, Fassung 1, Lernziel, 15 Minuten, zur Anzeige freigegeben | +| Modul Hilfe | dieselbe Unterlage, Fassung 1, Lernziel, 10 Minuten, freigegeben | +| Programm Abstand | beide Module in dieser Reihenfolge, Lernziel, 25 Minuten, Gliederung sichtbar, freigegeben | +| Lizenzartikel | `abstand-trainer`, Stand 1, Wurzel ist die Programmfassung | +| Rechteprofil | „Abstand ansehen“: Film streamen, Dokument ansehen, Text ansehen | +| Angebot | Testangebot Abstand, auf Abruf, Abdeckung gegen die Programmfassung | +| Trainer | Abruf in die Bibliothek, Programm nutzbar | + +Ein neues Vorschaubild an einer Zusammenstellung geht über die Queue nach `derived/vorschau/` und erzeugt keine neue Fassung. + +## Was auf der Testinstanz geprüft wurde + +Angemeldet als Prüftrainer: + +- Die Bibliothek zeigt nur Programm Abstand, Status Nutzbar. +- Die Programmseite zeigt Lernziel, beide Module, die Unterlage und den Film. +- Der Film spielt über hls.js. Bild 854×480, Wiedergabe bereit. Die Master-Playlist verweist auf die Stufen 480, 720 und 1080. Die Signatur gilt für diese Ausgabe. +- Die Unterlage zeigt den Text, die Zeile „Lizenziert für …“ mit Lizenzkopie und die Kennzeichnung „ehrenamtlich“. + +Angemeldet in der Verwaltung: + +- Die Programmliste enthält nur Programm Abstand und den fachlichen Erklärungssatz. + +Die Ableitung von „Lara im Park“ wurde nach dem Deploy in die Queue gegeben. Vorschaubild und die vier Playlist-Zeilen (480, 720, 1080, Master) liegen vor. Der Auftrag ist ohne Fehlereintrag durchgelaufen. Die Quelldatei bleibt unter `derived/` liegen. + +## Offen gegenüber dem Plan + +Tor B ist nicht bestanden. Der Plan verlangt auf der Testinstanz, vollständig und nicht nur soweit die Suite es an Wegwerfdaten zeigt: + +- zwei freigegebene Programme, gemeinsamer Film, gemeinsames PDF, unterschiedliche Rollen +- eine nur bereite Programmfassung mit demselben Film bleibt unsichtbar +- eine Person mit nur einem Modul, eine mit allen Teilen über getrennte Artikel, eine ohne Grant +- Stream nur für die berechtigte Person; Laden des Films scheitert ohne dieses Recht +- Ansehen und Laden eines PDF sind getrennt +- das teilweise Programm ist gekennzeichnet; das vollständige Programm erzeugt keinen zusätzlichen Erwerb +- die Materialliste zeigt das gemeinsame PDF einmal +- Umbenennung ohne neue Fassung, die gespeicherte Bestellbezeichnung bleibt +- Filter und direkte Themen an Modul und Programm +- Thumbnail nicht über die öffentliche Route +- Abdeckungsverweigerung und dieselbe Struktur in der Vorschau +- genau eine aktive Angebotsfassung, auch im Parallelfall + +Diese Fälle sind in der lokalen Suite einzeln vorhanden. Auf der Instanz liegt ein Programm, eine Textunterlage und ein Film. Eine PDF-Datei im Testmedienbestand fehlt. Eine wiederholbare HTTP-Suite gegen `luf-test` fehlt. + +Weitere Lücken im Pakettext: + +- Vorschaubild eines Films: erstes Bild, keine wählbare Zeitposition und keine Vorschau genau dieser Position. +- Originale liegen nicht getrennt unter `originals/`. Neue und vorhandene Dateien bleiben in `derived/`. Die Kennzeichnung hängt daran nicht. + +## Zurückgestellt + +Automatische Denkpause, Ablaufsteuerung, Präsentationsmodus, Fortschritt, zweites Gerät. `decision_seconds` bleibt gespeichert und steuert die Bibliothek nicht. + +Organisationslizenzen, Community, echter Zahlungsdienst, kundeneigene Paketkonfiguratoren, konkrete Preise und Tarife. Der Testkaufpreis aus dem früheren Demokatalog ist keine Preisentscheidung; dieser Katalog ist auf der Testinstanz entfernt. + +Designsystem, öffentliche Objektseiten und der Neubau des CMS. Die vorhandenen öffentlichen Seiten und die veröffentlichten Säulen unter `/themen` bleiben. W-P wird nicht in die Verwaltung übernommen. + +## Zugang zur Prüfung + +Nur die Testinstanz, Adresse `http://192.168.2.144:3011`. + +- Trainer: `/anmelden`, Konto `trainer-pruefung@example.test`, das bereits mitgeteilte Prüfkennwort. Bibliothek, Programm Abstand, Film und Unterlage. +- Redaktion: `/verwaltung`, Konto `redaktion-pruefung@example.test`, das bereits mitgeteilte Prüfkennwort und der bestehende Authenticator. Rollen Redaktion und Katalog. + +## Commits auf `develop`, die diesen Stand tragen + +| Commit | Inhalt | +|---|---| +| `7820bec` | Paket 1 | +| `1a2b129` | Paket 2 | +| `5ed01b9`, `fc08e6d`, `7b54c38` | Paket 3, Bibliothek, Anzeigefreigabe | +| `5e763d1` | Pakete 4 bis 7 und der Ausgabenachweis | +| `c99a957` | Nutzbarkeit, Didaktik, öffentliche Programmfassung | +| `1d8315c`, `9b52181` | Kursraum | +| `d6ff881` | fachliche Inhaltsverwaltung | +| `c997eb5`, `295f784` | geschützte Vorschaubilder und Filmstufen | +| `57802df` | Programmvorschau über die Queue, kein erneutes Seeden | +| `30833f6` | HLS über hls.js, wenn der Browser die Fähigkeit nur behauptet | + +## Empfehlung + +Die fachliche Erprobung des Abstand-Programms kann sofort auf der Testinstanz stattfinden. Eine Aussage „MVP abgenommen“ oder „kommerziell freigegeben“ setzt den fehlenden Tor-B-Lauf voraus, einschließlich einer echten PDF-Datei und der zweiten Programmfassung mit getrennten Personen. diff --git a/docs/analysen/adaptive-widgets-bericht-2026-11-18.md b/docs/analysen/adaptive-widgets-bericht-2026-11-18.md new file mode 100644 index 0000000..e7339dd --- /dev/null +++ b/docs/analysen/adaptive-widgets-bericht-2026-11-18.md @@ -0,0 +1,315 @@ +# Abschlussbericht: Adaptive Widgets und Premium-Design v1.6 + +Stand: 18.11.2026. +- Branch: `feature/adaptive-widgets`, abgezweigt vom Stand `feature/design-iteration-1` einschließlich der beiden Doku-Commits von Lars. +- Per Fast-Forward auf `develop` übernommen und über `deploy-test.yml` auf der Testinstanz bereitgestellt. +- **Kein Merge nach `main`.** `develop` liegt 73 Commits vor `main`. + +| Schritt | Stand | +|---|---| +| Commit Umsetzung | `0bfb534` | +| CI Feature-Branch | Lauf 4834 grün | +| Deploy Testinstanz | Lauf 4835 erfolgreich, `/up` 200 | +| Bericht | dieser Commit | + +Entscheidung: ADR-38 im zentralen Protokoll. Technische Dokumentation: +- `docs/architektur/cms-widget-registry.md` §§2–4, 8, 9, 12 +- `docs/architektur/designsystem.md` §13 + +## 1. Grundlage und Abweichungen vom Kit + +Grundlage war der Repository-Stand `docs/Brand-UI-Kit/12_premium_widgets_adaptiv_v1.6`: Komponenten, CSS, `layout-profiles.json`, Registry-Hinweise, Beispiele und Referenzscreenshots. Die Ordner 07–12 sind im Repository nicht versioniert (untracked). Übernommen wurden Code und CSS, angepasst an die tatsächliche Struktur. Die Kit-Ordner selbst wurden nicht eingecheckt. + +| Kit v1.6 | Umsetzung | Grund | +|---|---|---| +| Kennungen `lf-brand-hero`, `lf-editorial-bild-text` | bestehende Kennungen `hero` und `image_text` als kompatible Weiterentwicklung | Kennungen und Revisionen bleiben erhalten | +| Varianten `photo-split`, `editorial-solid` | `photo_split`, `editorial_solid` | Variantenkennungen der Registry: `^[a-z][a-z0-9_]*$` | +| `settings.image_side` | Variante `image_left` / `image_right` | keine doppelte Einstellung | +| `settings.image_focus {x,y}` | `data.focus_x`, `data.focus_y` (0–100) | `settings` trägt nur Aufzählungswerte | +| Überschriftenebene H1/H2/H3 frei | „Automatisch“ (erstes Widget der Seite = H1), H2, H3 | Regel „genau eine H1 je Seite“; Widerspruch nicht still aufgelöst, sondern dokumentiert | +| Linkziele nur `https`, Pfad, Anker | bestehende `SafeUrl`-Regel (zusätzlich `http`) | Repository-Regel gilt | +| Einstiegsbild immer sofort laden | nur das erste Widget der Seite sofort, alle anderen verzögert | bestehende Ladeprioritäten | +| CSS v1.6 | übernommen nach `resources/css/components/lf-hero.css` und `lf-bild-text.css` | zusätzlich: Überschriften erben Farbe (globale h1–h3-Regeln), Unterstreichung als Block, Fläche „clear“ übernimmt die Farben dunkler Abschnitte, Strahlen-Akzent, Fokusfarbe aus den Tokens | + +Das frühere Hero- und Bild-und-Text-CSS sowie der Randlos-Mechanismus der Designiteration 1 sind entfernt. Es laden keine alten und neuen Stylesheets parallel. + +## 2. Gemeinsamer Layoutmechanismus (ADR-38) + +In der bestehenden Registry (`WidgetType`) erklärt jede Art: +- **zulässige Rasterbreiten** (`supportedUnits()`); die Mindestbreite ist daraus abgeleitet; +- **Höhen** aus einem gemeinsamen Vokabular (`auto`, `compact`, `normal`, `large`, `spacious`, `fill`). Sie werden als `settings.height` gespeichert und wie jede Einstellung geprüft; +- **Darstellungsmodi** (`stages()`) und das **Verhalten bei wenig Platz** (`narrowBehavior()`). + +Wirkung: +- Ein Platz mit nicht unterstützter Breite wird beim Speichern abgewiesen: „… ist für Plätze mit 3 oder 4 Rastereinheiten vorgesehen; dieser Platz hat 2“. +- Der Platzkopf im Editor warnt vorher, und die Widget-Auswahl nennt die zulässigen Breiten. +- Die Höhe erscheint als Klasse `widget-height-*` an der Hülle. +- Die Ansichten reagieren über Container-Abfragen auf die tatsächliche Breite. +- Es gibt keine zweite Registry, kein zweites Abschnittsmodell und keine Migration. + +| Widget | Breiten | Höhen | +|---|---|---| +| Einstieg (Hero) | 3, 4 | compact (mind. 400 px), normal (512 px), large (640 px) | +| Bild und Text | 1–4 | compact, normal, spacious | +| Handlungsaufruf | 1–4 | auto, fill (gleich hoch wie die Nachbarplätze) | +| Überschrift, Fließtext, Karten, Programmkarten | 1–4 | – (nach Inhalt) | +| FAQ | 2–4 | – | + +Die Gestaltung der Bestandswidgets bleibt unverändert. Für schmale Plätze kamen hinzu: +- Umbruch langer Wörter und Adressen; +- Schaltflächen mit `overflow-wrap`, `max-width: 100 %` und mittig ausgerichtetem Text. + +## 3. Premium-Widgets + +**Einstieg (`hero` Version 2):** +- Varianten „Foto mit Textfläche“ und „Markenfläche“. +- Drei Höhen, Label, Überschrift und Ebene, Beschreibung, Bild aus dem öffentlichen Medienbereich (Auswahl oder Hochladen). +- Bildfokus (zwei Schieberegler) und Alternativtext. +- Zwei Schaltflächen und ein Akzent: Unterstreichung, Unterstreichung mit Signalstrahlen oder keiner. +- Ab 860 px Containerbreite die Komposition aus dem Kit, darunter der technische Sicherheitsumbruch (Foto 16:9 über dem Text). + +**Bild und Text (`image_text` Version 3):** +- Fläche creme, ohne eigene Fläche oder navy. +- Bild links oder rechts, drei Höhen, Label, Überschrift und Ebene. +- Formatierter Text (bereinigt), Bild, Fokus, Alternativtext, zwei Schaltflächen. +- Darstellung nach Containerbreite: + +| Containerbreite | Darstellung | +|---|---| +| unter 540 px | gestapelt | +| 540–899 px | flacher Bildstreifen | +| ab 900 px | zweispaltig | + +Die Grenzwerte aus dem Kit haben sich im CMS bewährt und sind unverändert. + +**Bestehende Daten:** +- `hero` Version 1 wird beim Lesen angehoben: `standard`/`stage` → `photo_split`, `highlight`/`editorial` → `editorial_solid`. Der Fokuspunkt wird in Prozent umgerechnet, und nicht mehr vorhandene Einstellungen entfallen. +- `image_text` Version 2 wird ebenso angehoben: Bildformat entfällt, Fokus in Prozent. +- Gespeicherte Revisionen bleiben unverändert. Die data-Schlüssel sind gleich geblieben, damit ein Code-Rollback darstellbar bleibt (siehe `cms-widget-registry.md` §9). + +## 4. Editor + +- **Bearbeitungsdialog:** Reiter **Inhalt**, **Medien** und **Darstellung**, generisch aus der Registry. + - Varianten und Höhen sind Auswahlknöpfe mit Symbol. + - Der Bildfokus wird mit Schiebereglern eingestellt. + - Weitere Darstellungsparameter sind Auswahllisten mit dem Hinweis „Vorgabe der Darstellung“. + - Der Reiter Darstellung nennt die zulässigen Platzbreiten und das Verhalten bei wenig Platz. +- **Live-Vorschau im Dialog:** + - Derselbe Renderer wie die Website, in wählbarer Platzbreite: Smartphone 390 px oder die zulässigen Einheiten mit 310, 640, 960 bzw. 1300 px. + - Verkleinert auf die Dialogbreite; Änderungen erscheinen sofort. +- **Abschnitts- und Widget-Einstellungen sind getrennt:** + - Abschnitt: Raster, Hintergrund, Breite, Abstand, Trenner. + - Widget: Anordnung, Fläche, Höhe, Bild, Fokus, Texte, Schaltflächen, Akzent. + +## 5. Tests und praktische Abnahme + +| Prüfung | Ergebnis | +|---|---| +| `php artisan test` | 199 Tests grün | +| Pint (Code-Pfade) | sauber | +| Build | erfolgreich (Nunito 900 zusätzlich lokal ausgeliefert) | +| CI | 4834 grün | +| Deploy | 4835 erfolgreich | +| 12 bestehende öffentliche Seiten (Status, Titel, Text) vor und nach dem Deploy | unverändert | +| Szenario 1: `/designreferenz`, `/praevention-im-alltag`, `/referenz-abschnitte`, `/t1-landingpage` im Editor geöffnet und unverändert gespeichert | 4/4 ohne Fehler | +| Redaktionsablauf auf Test (`/premium-referenz`, über die Oberfläche) | 16 von 18 Prüfungen im Skript bestanden; die beiden Abweichungen sind Prüffehler, nicht Anwendungsfehler (siehe unten) | +| Matrix lokal (`/pruefmatrix`, mit Kit-Motiven) und auf Test (`/premium-referenz`), 390/768/1200/1440/1920 px | kein seitlicher Überlauf, kein abgeschnittener Text oder Button, genau eine H1 | +| Rahmen (Kopfzeile, Menü, Tastatur, CLS, Bewegung reduzieren) auf Test | 18/18 | + +**Neue Tests in der Suite:** +- `CmsPremiumWidgetsTest`: Upgrades, Varianten, Höhen, Akzente, Fläche, Sanitizing, unsichere Links, Fokusgrenzen, alle Widgets in jeder zulässigen bzw. unzulässigen Breite, Höhe „fill“. +- Editortest: Premium-Einstieg mit Höhe, Ebene, Akzent, Fokus und zwei Schaltflächen speichern und veröffentlichen; Dialogfelder und Live-Vorschau. +- Registry-Tests zum Layoutvertrag. + +**Bewusst angepasste Tests:** +- Einstieg braucht 3 oder 4 statt mindestens 2 Einheiten. +- `image_text` ist Version 3. +- Klassen der neuen Ansichten. +- Die Hero- und Bild-Tests der Designiteration 1 sind ersetzt. + +**Redaktionsablauf auf der Testinstanz (Szenarien 2–11):** +- Angelegt über die Oberfläche: Einstieg in 4/4 (groß, normal) und 3/4 (kompakt, Markenfläche, H3, lange Überschrift und Schaltfläche), Aufruf mit voller Höhe, Bild und Text in 4/4, 3/4, 2/4 und 1/4 mit allen Höhen und Flächen, gemischt mit Überschrift, Fließtext und Karten. +- Danach im Editor geändert: Überschrift, Beschriftung, Höhe und Fokus. + - Die Live-Vorschau zeigt Höhe, Fokus (80/30 %) und Text sofort. + - Die Smartphone-Breite zeigt den Sicherheitsumbruch. +- Veröffentlicht; die öffentliche Seite zeigt alle Änderungen. + +**Die zwei Abweichungen im Skript:** +- Es erwartete 15 Widgets; angelegt waren 13. Die Zahl im Skript war falsch. +- Der Vergleich Vorschau gegen öffentliche Seite meldete einen Unterschied. Das genaue Diff zeigt als einzigen Unterschied den beabsichtigten Vorschauhinweis „Vorschau einer unveröffentlichten Revision“. Das Markup der Widgets ist identisch. + +**Bilder:** +- Lokal wurden die Kit-Motive (`09_hero_widget/assets/lara-felix-park-hero.webp`, `10_bild_text_widget/assets/lara-felix-park.webp`) für den Sichtvergleich mit den Kit-Screenshots verwendet; die Darstellung entspricht ihnen. +- Auf der Testinstanz stehen gekennzeichnete Platzhalter. Begründung: Alles, was im Editor gespeichert wird, ist über `/medien/cms/…` öffentlich abrufbar, und die öffentliche Bildverwendung ist laut Kit nicht freigegeben. + +**Screenshots** (Testinstanz, Platzhalter) unter `docs/analysen/adaptive-widgets-screenshots/`: +- Referenzseite bei 1440, 768 und 390 px +- Dialog „Darstellung“ +- Live-Vorschau bei 390 und 1300 px + +## 6. Verbleibende Einschränkungen + +- **Kit-Dateien verändert (mein Fehler):** + - Ein Pint-Lauf ohne Pfadangabe hat vier untracked PHP-Beispieldateien im Kit umformatiert (nur Leerraum und Klammern): + - `11_bild_text_widget_v1.5/laravel/app/Support/LfBildTextPayload.php` + - `11_bild_text_widget_v1.5/laravel/examples/registry-adapter.example.php` + - `11_bild_text_widget_v1.5/laravel/tests/LfBildTextPayloadTest.php` + - `12_premium_widgets_adaptiv_v1.6/laravel/app/Support/LfBildTextPayload.php` + - Die übrigen 112 Kit-Dateien sind bytegleich mit dem Archiv. + - Das Zurückschreiben aus `Downloads/Lara_Felix_Brand_UI_Kit_v1.6_Adaptive_Premium_Widgets.zip` wurde von der Rechteprüfung blockiert. Bitte diese vier Dateien aus dem Archiv wiederherstellen. +- **Freigaben:** Die öffentliche Verwendung der Lara-&-Felix-Motive ist nicht freigegeben. Die Testseiten zeigen deshalb Platzhalter. +- **Validierungsmeldungen auf Englisch:** Es gibt kein deutsches Sprachpaket (`lang/de` fehlt), zum Beispiel „The … field is required when … is present“. Das betrifft die ganze Anwendung. +- **Livewire-Timing:** Werden Felder schneller ausgefüllt, als die Live-Aktualisierung zurückkommt (unter etwa 0,5 s, nur bei automatischer Eingabe beobachtet), kann ein gerade verlassenes Feld überschrieben werden. Bei menschlichem Tempo trat das nicht auf. +- **Eingeklappter Abschnitt bei der Neuanlage:** „Seite und Suchmaschinen“ bleibt nach dem Bearbeiten einer Seite auch beim Anlegen eingeklappt, weil Filament den Zustand merkt. Das Verhalten stammt aus Iteration 2. +- **Vorschau im Platz:** Sie ist über 28 rem gekürzt; der Einstieg wird dort beschnitten. Vollständig zeigen ihn die Live-Vorschau im Dialog und die Seitenvorschau. +- **Keine responsiven Bildvarianten:** `srcset` fehlt; die Ableitungen gehören in die Hintergrundverarbeitung. +- **Code-Rollback auf die Designiteration:** Ältere Software stellt `hero` v2 und `image_text` v3 „bestmöglich“ dar, kann sie aber nicht speichern (§9 der Registry-Dokumentation). +- **Größe der Repository-Historie:** Mit dem Fast-Forward sind Lars' Commits `5dccbbc` und `3cdb36e` auf `develop` gelandet. Sie enthalten die Kit-Originalbilder und das Kit-ZIP (27,7 MB) in der Historie. Das ZIP ist in `3cdb36e` wieder entfernt, bleibt aber in der Historie. +- **UX-Abnahme:** Die Bedienung durch den Betreiber steht aus (ADR-38 „UX-Abnahme offen“). + +## 7. Auf der Testinstanz angelegt + +- Seite `/premium-referenz` (veröffentlicht), mit Platzhalterbildern `cms/platzhalter-*` (Dateinamen mit Zufallssuffix). +- Neue Entwurfsrevisionen (nicht veröffentlicht) auf `/designreferenz`, `/praevention-im-alltag`, `/referenz-abschnitte` und `/t1-landingpage` aus dem Speichertest. Die veröffentlichten Stände sind unverändert. + +## 8. Nachprüfung vom 18.11.2026 (Seitenliste, Abstand oben, Wortmarke) + +Branch `feature/cms-liste-logo-abstand`, Commit `89fd95b`; CI 4838, Deploy 4839 auf der Testinstanz. Gearbeitet wurde in einem separaten Worktree; der offene Branch `designkit` und das Arbeitsverzeichnis wurden nicht verändert. + +### Befund zu `/premium-referenz` + +`/premium-referenz` war und ist ein **regulärer CMS-Seitendatensatz**: + +| Merkmal | Wert | +|---|---| +| Tabelle und Kennung | `pages`, Kennung 17 | +| Bearbeitungsadresse | `/verwaltung/pages/17/edit` | +| Inhalt | 7 Abschnitte, 13 Widgets, mehrere Revisionen | +| Öffentliche Auslieferung | über die normale Seitenroute (`PageController`) | + +Es gibt keine Sonderroute, keine Testimplementierung und keine andere Datenquelle. Angelegt wurde die Seite tatsächlich über die Editoroberfläche; diese Aussage des Berichts stimmt. Unvollständig war sie in einem Punkt: Ohne Suche war die Seite nicht zu finden. + +**Ursache:** +- Die Seitenliste hatte keine Sortierung und zeigte 10 Einträge je Seite in Anlagereihenfolge. +- Die zuletzt angelegte Seite stand deshalb auf Listenseite 2 von 2. +- Die Spalte „Geändert“ zeigte das Anlagedatum in UTC, weil gespeicherte Revisionen die Seite nicht als geändert markierten. +- Filter, Status, Berechtigungen, Seitentyp oder eine Bereichszuordnung spielten keine Rolle; die Liste hat keine Filter. + +**Behoben:** +- Die Liste zeigt die zuletzt bearbeiteten Seiten zuerst; Pfad und Datum sind sortierbar. +- Je Seite stehen 25, 50 oder 100 Einträge. +- Die Spalte heißt „Zuletzt bearbeitet“ und zeigt deutsche Zeit. +- Jede gespeicherte Revision und jede Veröffentlichung aktualisiert die Seite. + +**Geprüfter Weg auf der Testinstanz** (Skript über die normale Oberfläche, ohne direkte Datenbankänderung und ohne Hilfsrouten): +1. Anmeldung mit dem Prüfkonto. +2. Verwaltung → Seitenleiste „Seiten“. `/premium-referenz` steht in Zeile 1, ohne Suche. +3. Klick auf die Zeile → `/verwaltung/pages/17/edit`. +4. Alle 13 Widgets nacheinander über „Bearbeiten“ geöffnet und ein Textfeld geändert: Einstieg (3), Handlungsaufruf, Bild und Text (6), Fließtext, Überschrift und Einleitung, Redaktionelle Karten. +5. Erster Abschnitt: „Gestaltung des Abschnitts“ → „Abstand oben: Kein Abstand“. +6. „Entwurf speichern“ → Meldung „Entwurf gespeichert“. +7. „Vorschau“ zeigt alle 13 Änderungen und den Abstand. +8. „Veröffentlichen“ → die öffentliche Seite zeigt alle 13 Änderungen und den Abstand. +9. Dasselbe Vorgehen für `/praevention-im-alltag` (Zeile 3, `/verwaltung/pages/9/edit`), dort „Abstand oben: Gering“. + +Ergebnis: 22 von 22 Prüfungen, keine Konsolenfehler. Ein zweiter Durchlauf hat die Prüfmarken in den Texten über die Oberfläche wieder entfernt (ebenfalls 22/22). + +### Abstand zwischen Kopfzeile und erstem Abschnitt + +- Bisher ließ sich der Abstand oben nur über „Abstand oben und unten“ verkleinern, und zwar auf höchstens „Kompakt“ (etwa 24–48 px), nie auf null. +- Neu ist in der Abschnittsgestaltung „Abstand oben“ mit drei Werten: + - „Wie ‚Abstand oben und unten‘“ (Vorgabe) + - „Gering“ (etwa 12–20 px) + - „Kein Abstand“ +- Gespeichert wird der Wert als `style.spacing_top`. Er wirkt nur auf den gewählten Abschnitt und nur oben. +- Der Abstand unten und alle anderen Abschnitte bleiben unverändert. Es gibt keine globale Regel und keine Änderung an bestehenden Seiten, solange niemand die Einstellung wählt. + +### Wortmarke in Kopfzeile und Fußbereich + +- **Quelle:** `docs/Brand-UI-Kit/08_freigegebene_logovarianten/logo_lara_felix_kompakt.png`, gelesen aus Lars' lokalem Commit `1223dc8` (Branch `designkit`), weil die Kit-Ordner im Arbeitsverzeichnis fehlen. +- **Freistellung:** Die Datei hat entgegen der Kit-README einen transparenten Hintergrund. Auf Weiß und auf Navy wirkt sie sauber, das ist im Browser geprüft. Die Standardfassung ist größtenteils halbtransparent und wird nicht verwendet. +- **Eingebunden:** zugeschnittene WebP-Ableitungen `public/images/brand/lara-felix-logo-kompakt-128.webp` und `-256.webp` (1x/2x). Die Originaldatei bleibt unverändert. +- **Größen:** + +| Ort | Logohöhe | +|---|---| +| Kopfzeile, Ausgangszustand | etwa 80 px (Box unverändert 104 px) | +| Kopfzeile, kompakt beim Scrollen | 60 px in der 72-px-Leiste | +| Smartphone | 48 px | +| Fußbereich | 72 px | + +- **Stabilität:** Breite und Höhe stehen im Markup; die Navigation misst dadurch schon vor dem Laden des Bildes richtig. +- **Mitgliederbereich:** unverändert (Schriftzug). +- **Prüfung auf der Testinstanz:** + - Kopfzeile 18/18. + - Fünf Seiten bei 1920/1440/1366/1280/390 px: je Breite eine Höhe sowie eine Wortmarken- und Navigationsposition. + - Erster Frame ohne Layoutverschiebung (CLS 0). + +**Abnahme-Screenshots** (Testinstanz) unter `docs/analysen/adaptive-widgets-screenshots/`: +- `07`–`09`: `/premium-referenz` bei 1440 px (Ausgangszustand und kompakt) und bei 390 px +- `10`, `11`: `/praevention-im-alltag` bei 1440 und 390 px +- `12`, `13`: `/praevention` bei 1440 und 390 px +- `14`: Seitenkonfigurator, Seite 17 +- `15`: Abschnittsgestaltung mit „Abstand oben“ + +**Tests:** +- 203 grün; neu ist `CmsPageListAndSpacingTest` (Sortierung der Liste, Bearbeitungsdatum, Abstand oben, Aufzählungsprüfung). +- Bewusst angepasst: Erwartung an die Wortmarke (`brand-logo` statt `brand-lockup`). + +**Offen:** +- Eine Vektorfassung der Wortmarke fehlt; die Rasterfassung ist für die gezeigten Größen scharf (2x-Ableitung). +- Bitte die Wortmarke in Kopf- und Fußbereich visuell abnehmen. + +## 9. Korrektur: Abschnittsabstände vereinfacht (18.11.2026) + +Branch `feature/abschnittsabstaende`, Commit `f511ad1`; CI 4842, Deploy 4843 auf `develop`, gearbeitet in einem separaten Worktree. Kein Merge nach `main`. + +**Ersetzt** wurden: +- „Abstand oben und unten“, +- die Abweichung „Abstand oben“, +- die versteckte Regel, die oben zwischen zwei Abschnitten ohne Fläche auf null setzte, +- der Trenner „Zusätzlicher Abstand“. + +**Neu** sind genau drei unabhängige Einstellungen: **Abstand oben**, **Abstand unten** und **Widget-Abstand**, jeweils mit den Stufen Kein Abstand, Kompakt, Normal und Großzügig. Gespeichert werden sie in der Abschnittshülle Version 2; Einzelheiten stehen in `cms-widget-registry.md` §11. + +**Bestehende Seiten:** Hüllen der Version 1 werden beim Lesen übersetzt. + +| Seite | Breiten | Ergebnis vor und nach dem Deploy | +|---|---|---| +| `/`, `/praevention`, `/designreferenz`, `/referenz-abschnitte`, `/premium-referenz`, `/t1-landingpage` | 1440 und 390 px | pixelgleich: Seitenhöhe, Lage jedes Abschnitts und Rasters, Innenabstände, Rasterabstände, Platzpositionen | +| `/praevention-im-alltag` | 1440 und 390 px | erster Abschnitt oben +24,5 px bzw. +12 px, weil „Gering“ jetzt „Kompakt“ ist (gewollte Folge der vier Stufen) | + +**Prüfung über den regulären Seitenkonfigurator:** +- Angelegt wurde `/abstand-pruefung` (Seite 18) mit aufeinanderfolgenden Abschnitten: + +| Abschnitt | Raster | oben / unten / Widget-Abstand | +|---|---|---| +| 1 | 4/4 | 0 / 0 / 0 | +| 2 | 3:1 | 0 / 0 / 0 | +| 3 | 4/4 | Kompakt / Normal / Normal | +| 4 | 3:1 | Großzügig / 0 / Großzügig | +| 5 | 3:1 | 0 / Kompakt / Kompakt | + +- Die Gestaltung zeigt genau die drei Felder, „Abstand oben und unten“ gibt es nicht mehr. +- Berechnete CSS-Werte (26 von 26 Prüfungen): + +| Prüfung | 1440 px | 390 px | +|---|---|---| +| Stufen oben/unten (Kompakt / Normal / Großzügig) | 44,8 / 89,6 / 120 px | 24 / 48 / 72 px | +| Stufen Widget-Abstand (Kompakt / Normal / Großzügig) | 18 / 36 / 56 px | 12 / 20 / 32 px | +| Innenabstände und Rasterabstand je Abschnitt | wie eingestellt, Außenabstand jeweils 0 | wie eingestellt, Außenabstand jeweils 0 | +| Inhalt 1 → 2 (0 + 0) | 0,0 px | 0,0 px | +| Inhalt 2 → 3 (0 + Kompakt) | 44,8 px | 24 px | +| Inhalt 3 → 4 (Normal + Großzügig) | 209,6 px | 120 px | +| Inhalt 4 → 5 (0 + 0) | 0,0 px | 0,0 px | +| Widget-Abstand 3:1 | nebeneinander 0 / 56 / 18 px | gestapelt 0 / 32 / 12 px | + +**Tests:** 204 grün. +- Neu: + - Addition und Vorgaben, + - Übersetzung aller Fälle der Version 1 (Abweichung, versteckte Regel, eigene Fläche, Linientrenner, leerer Abschnitt, Zusatzabstand), + - Abweisung freier Werte für alle drei Felder. +- Bewusst angepasst: Hüllenversion 2, neue Klassen, Prüfung freier Werte über die neuen Schlüssel. + +**Vorgabe für neue Abschnitte:** oben und unten Kompakt, Widget-Abstand Normal. Damit bleibt der Abstand zwischen zwei neuen Abschnitten so groß wie bisher, und ein neuer erster Abschnitt beginnt näher an der Kopfzeile als vorher. + diff --git a/docs/analysen/adaptive-widgets-screenshots/01-1440-premium-referenz.jpg b/docs/analysen/adaptive-widgets-screenshots/01-1440-premium-referenz.jpg new file mode 100644 index 0000000..e2bd70d Binary files /dev/null and b/docs/analysen/adaptive-widgets-screenshots/01-1440-premium-referenz.jpg differ diff --git a/docs/analysen/adaptive-widgets-screenshots/02-768-premium-referenz.jpg b/docs/analysen/adaptive-widgets-screenshots/02-768-premium-referenz.jpg new file mode 100644 index 0000000..68412fa Binary files /dev/null and b/docs/analysen/adaptive-widgets-screenshots/02-768-premium-referenz.jpg differ diff --git a/docs/analysen/adaptive-widgets-screenshots/03-390-premium-referenz.jpg b/docs/analysen/adaptive-widgets-screenshots/03-390-premium-referenz.jpg new file mode 100644 index 0000000..d497260 Binary files /dev/null and b/docs/analysen/adaptive-widgets-screenshots/03-390-premium-referenz.jpg differ diff --git a/docs/analysen/adaptive-widgets-screenshots/04-editor-dialog-darstellung.jpg b/docs/analysen/adaptive-widgets-screenshots/04-editor-dialog-darstellung.jpg new file mode 100644 index 0000000..c3beae4 Binary files /dev/null and b/docs/analysen/adaptive-widgets-screenshots/04-editor-dialog-darstellung.jpg differ diff --git a/docs/analysen/adaptive-widgets-screenshots/05-editor-live-vorschau-390.jpg b/docs/analysen/adaptive-widgets-screenshots/05-editor-live-vorschau-390.jpg new file mode 100644 index 0000000..370614f Binary files /dev/null and b/docs/analysen/adaptive-widgets-screenshots/05-editor-live-vorschau-390.jpg differ diff --git a/docs/analysen/adaptive-widgets-screenshots/06-editor-live-vorschau-1300.jpg b/docs/analysen/adaptive-widgets-screenshots/06-editor-live-vorschau-1300.jpg new file mode 100644 index 0000000..057c077 Binary files /dev/null and b/docs/analysen/adaptive-widgets-screenshots/06-editor-live-vorschau-1300.jpg differ diff --git a/docs/analysen/adaptive-widgets-screenshots/07-nachpruefung-premium-referenz-1440.jpg b/docs/analysen/adaptive-widgets-screenshots/07-nachpruefung-premium-referenz-1440.jpg new file mode 100644 index 0000000..8fda8e3 Binary files /dev/null and b/docs/analysen/adaptive-widgets-screenshots/07-nachpruefung-premium-referenz-1440.jpg differ diff --git a/docs/analysen/adaptive-widgets-screenshots/08-nachpruefung-premium-referenz-1440-kompakt.jpg b/docs/analysen/adaptive-widgets-screenshots/08-nachpruefung-premium-referenz-1440-kompakt.jpg new file mode 100644 index 0000000..311bb2c Binary files /dev/null and b/docs/analysen/adaptive-widgets-screenshots/08-nachpruefung-premium-referenz-1440-kompakt.jpg differ diff --git a/docs/analysen/adaptive-widgets-screenshots/09-nachpruefung-premium-referenz-390.jpg b/docs/analysen/adaptive-widgets-screenshots/09-nachpruefung-premium-referenz-390.jpg new file mode 100644 index 0000000..b0abd47 Binary files /dev/null and b/docs/analysen/adaptive-widgets-screenshots/09-nachpruefung-premium-referenz-390.jpg differ diff --git a/docs/analysen/adaptive-widgets-screenshots/10-nachpruefung-praevention-im-alltag-1440.jpg b/docs/analysen/adaptive-widgets-screenshots/10-nachpruefung-praevention-im-alltag-1440.jpg new file mode 100644 index 0000000..6a32375 Binary files /dev/null and b/docs/analysen/adaptive-widgets-screenshots/10-nachpruefung-praevention-im-alltag-1440.jpg differ diff --git a/docs/analysen/adaptive-widgets-screenshots/11-nachpruefung-praevention-im-alltag-390.jpg b/docs/analysen/adaptive-widgets-screenshots/11-nachpruefung-praevention-im-alltag-390.jpg new file mode 100644 index 0000000..674a1a2 Binary files /dev/null and b/docs/analysen/adaptive-widgets-screenshots/11-nachpruefung-praevention-im-alltag-390.jpg differ diff --git a/docs/analysen/adaptive-widgets-screenshots/12-nachpruefung-praevention-1440.jpg b/docs/analysen/adaptive-widgets-screenshots/12-nachpruefung-praevention-1440.jpg new file mode 100644 index 0000000..59a1cfb Binary files /dev/null and b/docs/analysen/adaptive-widgets-screenshots/12-nachpruefung-praevention-1440.jpg differ diff --git a/docs/analysen/adaptive-widgets-screenshots/13-nachpruefung-praevention-390.jpg b/docs/analysen/adaptive-widgets-screenshots/13-nachpruefung-praevention-390.jpg new file mode 100644 index 0000000..9e5b28b Binary files /dev/null and b/docs/analysen/adaptive-widgets-screenshots/13-nachpruefung-praevention-390.jpg differ diff --git a/docs/analysen/adaptive-widgets-screenshots/14-nachpruefung-editor-seite-17.jpg b/docs/analysen/adaptive-widgets-screenshots/14-nachpruefung-editor-seite-17.jpg new file mode 100644 index 0000000..d8835b7 Binary files /dev/null and b/docs/analysen/adaptive-widgets-screenshots/14-nachpruefung-editor-seite-17.jpg differ diff --git a/docs/analysen/adaptive-widgets-screenshots/15-nachpruefung-abstand-oben.jpg b/docs/analysen/adaptive-widgets-screenshots/15-nachpruefung-abstand-oben.jpg new file mode 100644 index 0000000..9e31a76 Binary files /dev/null and b/docs/analysen/adaptive-widgets-screenshots/15-nachpruefung-abstand-oben.jpg differ diff --git a/docs/analysen/befund-paket-0-testinstanz-2026-03-15.md b/docs/analysen/befund-paket-0-testinstanz-2026-03-15.md new file mode 100644 index 0000000..34e346c --- /dev/null +++ b/docs/analysen/befund-paket-0-testinstanz-2026-03-15.md @@ -0,0 +1,55 @@ +# Paket 0 — Lesender Befund (Testinstanz `luf-test`) + +Stand: 2026-03-15. Quelle: nur lesende SQL-Abfragen gegen PostgreSQL im Container `luf-test-db-1` (`luf_test` / `luf_test`). Keine Schreibzugriffe, keine Produktion. + +## Angebote mit mehr als einer aktiven Fassung + +Kein Treffer. Jedes Angebot hat höchstens eine Fassung im Status `aktiv`. + +| offer_id | offer_name (fachlich) | aktive Fassungen | Nummern | Vergabearten | +|---:|---|---:|---|---| +| — | — | 0 | — | — | + +## Aktive Fassungen (Überblick) + +| offer_id | Bezeichnung | Nummer | grant_kind | price_cents | +|---:|---|---:|---|---:| +| 1 | Kostenloses Merkblatt | 1 | auf_abruf | — | +| 2 | Testkauf Programm | 1 | kauf | 500 | + +## Registrierung heute + +Aktive Fassungen mit `grant_kind = bei_registrierung` und `holder_kind = person`: **0**. + +Die heutige Implementierung vergäbe bei Registrierung **keine** Angebote aus dieser Kategorie. Dubletten wären relevant, sobald Registrierungsangebote aktiv sind; aktuell nicht messbar. + +Hinweis zum künftigen Codepfad (Paket 1, G8): Nach Freigabe liest die Registrierung je Angebot nur die **höchste** aktive Nummer — nicht mehr alle parallelen Fassungen. + +## Bestellzeilen ohne Bezeichnungskopie + +Spalte `offer_name` auf `order_lines`: **fehlt** (noch nicht migriert auf Test). + +| Kennzahl | Wert | +|---|---:| +| Bestellzeilen gesamt | 3 | +| Zeilen ohne Kopie (Spalte fehlt) | 3 | + +Eine nachträgliche Befüllung alter Zeilen ist nicht vorgesehen (Paket 1). + +## Grants bei Dubletten-Angeboten + +Keine Dubletten → keine grant-spezifische Auswertung je paralleler Fassung. + +Überblick Grants je Angebot (`reference_type = offer`): + +| offer_id | Anzahl Grants | +|---:|---:| +| 1 | 2 | + +## Freigabe zur Bereinigung + +**Nicht erforderlich** auf Test: es gibt keine überzähligen aktiven Fassungen. Die Bereinigung wartet auf künftige Befunde oder andere Umgebungen. + +## Wiederverwendbare Abfragen + +`scripts/paket0-readonly.sql` und `scripts/paket0-readonly-extra.sql` (nur lesend). \ No newline at end of file diff --git a/docs/analysen/cms-abschnitte-bericht-2026-11-17.md b/docs/analysen/cms-abschnitte-bericht-2026-11-17.md new file mode 100644 index 0000000..8c05c67 --- /dev/null +++ b/docs/analysen/cms-abschnitte-bericht-2026-11-17.md @@ -0,0 +1,163 @@ +# Abschlussbericht CMS-Iteration 2: Website-Gerüst, Abschnittsraster, Seiteneditor + +Stand: 17.11.2026. Branch `feature/cms-sections`, auf `develop` übernommen (Fast-Forward) und über `deploy-test.yml` auf der Testinstanz (Port 3011) bereitgestellt. **Kein Merge nach `main`, keine Produktivsetzung.** Entwicklerdokumentation: `docs/architektur/cms-widget-registry.md` (Abschnitte, Editor, Rollback), `docs/architektur/designsystem.md` (Tokens, Komponenten, Marke). + +Commits: `480d559` (Umsetzung), `2ac2923` (Dokumentation), `4cad602` (Speicherlimit der Testsuite), `6152451` (Duplizieren direkt hinter dem Original), `dc33f0e` (Bericht), `c6186fb` (Veröffentlichen speichert zuerst, Warnung bei ungespeicherten Änderungen), dazu diese Berichtskorrektur. + +## Ausgangslage und Grundlagen + +Geprüft: Implementierung der Iteration 1 (Widget-Registry, acht Widget-Arten, Editor, Vorschau, Revisionen, Navigation, Katalogverweise) im Code; ADR-22, -28, -29, -30, -32, -36 (`12_Entscheidungsprotokoll_ADR.md`, Arbeitsstand mit lokalen Änderungen, nicht verändert); `design-prinzipien.md`; Website-Zielkonzept (§§5–8, Designanalyse und Designsystem); Website-Zielarchitektur (§§4.5, 5.2–5.6); `trainingskonzept-und-produktstruktur.md`; `produktkonfiguration-und-mitgliederbereich.md`; Fachkonzept v1.1; Brand-UI-Kit mit Quellenmanifest. **`00_LUF_Projektkompass.md` ist im Repository nicht vorhanden** (auch nicht unter anderem Pfad). + +## 1. Umgesetzte Funktionen + +- **Abschnittsmodell**: Seite → Abschnitte → Plätze → je Platz höchstens ein Widget aus dem bestehenden Register. Sechs Raster (4, 2+2, 1+3, 3+1, 1+2+1, 1+1+1+1), Abschnittsgestaltung über Aufzählungswerte, stabile Kennungen, versionierte Hülle. +- **Adaptive Widgets**: Mindest- und Vorzugsbreite je Widget-Art im Register; Widget-Ansichten mit Container-Abfragen; Prüfung „zu schmal“ beim Speichern und Hinweis im Editor. +- **Abschnittsgestaltung**: Hintergrund (Standard, helle Markenfläche, dunkle Markenfläche, Markenakzent, Hintergrundbild mit Fokuspunkt und Überlagerung), Breite (schmal, Standard, breit, volle Breite), Abstand (kompakt, normal, großzügig), Trenner (Abstand, Linie, Markenakzent). +- **Editor**: volle Arbeitsbreite; Abschnitte mit grafischer Rasterauswahl, Plätzen im Rasterverhältnis, Widget-Vorschau in echter Platzbreite ohne Bildlaufleiste; Hinzufügen, Duplizieren (direkt hinter dem Original), Verschieben (Pfeile und Ziehen), Löschen mit Rückfrage; Rasterwechsel ohne Widget-Verlust; Fehlermeldungen mit Abschnitt, Platz und Widget-Art; Seite duplizieren. +- **Globales Website-Gerüst**: klebende kompakte Kopfzeile mit vorläufiger Wortmarke, CMS-Hauptnavigation mit aktivem Eintrag und einer Ebene Untermenü, Kontozugang „Mitgliederbereich“, vorbereiteter (abgeschalteter) Warenkorbzugang, mobile Navigation ohne untere Leiste; Fußbereich mit Themenbereichen und den CMS-Gruppen Service, Kontakt, Rechtliches. +- **Gemeinsames Designsystem**: zweistufige Tokens, Grundkomponenten, lokal ausgelieferte Schriften; Mitgliederbereich nutzt dieselben Tokens und dieselbe Wortmarke. +- **Wiederherstellungsweg**: flache Rollback-Fassung je Revision und Befehl `cms:revert-published`. + +## 2. Verwendete und erweiterte Komponenten + +| Bestand | Erweiterung | +|---|---| +| `WidgetRegistry`, `WidgetType`, acht Widget-Arten | `normalizeWidget()` für seitenweite Prüfung; `minUnits()`, `preferredUnits()`, `stages()` | +| `WidgetRenderer`, Widget-Ansichten | unverändert als Renderweg je Widget; Handlungsaufruf nutzt die gemeinsame Schaltfläche | +| `PageService`, `PageRevision` | speichert Abschnitte und Rollback-Fassung; `sections()`, `duplicate()` | +| `PageController`, Vorschaurouten | rendern über `SectionRenderer` | +| `WidgetEditor`, `WidgetBlock` | `slotBuilder()` für Plätze, Mindestbreite in der Auswahl | +| `NavigationItem`, `NavigationItemResource` | Fußbereichsgruppen als Platzwerte, `parent_id` für Untermenüs | +| Layouts `site`/`member`, `components/site/*` | Kopfzeile, Fußbereich, Wortmarke, Warenkorbzugang neu gefasst | +| `resources/css/app.css` | aufgeteilt in Tokens, Grundelemente, Komponenten, Gerüst, Abschnitte, Widgets | +| Neu | `PageSections`, `SectionLayouts`, `SectionStyle`, `SectionRenderer`, `SiteNavigation`, `SectionEditor`, `ReportsSectionErrors`, `RevertPublishedPages`, `site-nav.js` | + +Zwei ergänzende Migrationen: `page_revisions.sections` (JSON, nullable) und `navigation_items.parent_id` (nullable, beim Löschen des Elterneintrags `null`). Keine Daten werden geändert oder gelöscht. + +## 3. Abschnitts- und Slot-Modell + +Siehe `cms-widget-registry.md` §11. Kurz: Ein Abschnitt hat Kennung, Version, Raster, Gestaltung und genau so viele Plätze, wie das Raster Einheiten-Gruppen hat. Ein Platz enthält eine Widget-Hülle oder ist leer. Leere Plätze gibt es im Editor; öffentlich entfallen sie, die übrigen Plätze teilen sich die Breite im Verhältnis ihrer Einheiten; Abschnitte ohne Inhalt entfallen ganz. Mehr Widgets als Plätze werden beim Speichern abgewiesen, nie abgeschnitten. Keine Verschachtelung. + +## 4. Responsive Widget-Regeln + +Siehe `cms-widget-registry.md` §§11–12. Abschnitte stapeln unter 40 rem Abschnittsbreite immer, ab 40 rem bleiben gleich breite Plätze nebeneinander (4 Plätze als 2 × 2), ab 60 rem gilt das Rasterverhältnis. Gestapelt wird in Platzreihenfolge, die Lese- und Fokusreihenfolge bleibt gleich. Mindestbreiten: Einstieg und Bild-und-Text sowie FAQ 2 Einheiten, alle übrigen 1 Einheit (abgeleitet aus rund 276 px je Einheit auf dem Desktop). + +## 5. Gemeinsames Designsystem + +Siehe `designsystem.md`. Markenwerte (Navy `#032551`, Grün `#5b8625`/`#3b7b09`, Gelb `#fcd10a`, Creme `#f7f6f2`, Tinte `#15243a`) aus dem Brand-UI-Kit, ausdrücklich **vorläufig**. Bedeutungswerte für Text, Flächen, Linien, Fokus, Aktion, Erfolg, Warnung, Fehler, Information, Deaktiviert; Flächen setzen sie neu. Alle Textpaare erreichen mindestens 4,5 : 1 (gerechnet); Fokus mindestens 3 : 1. + +## 6. Kopfzeile, Navigation, Fußbereich + +- Kopfzeile 64/72 px, klebend mit Schatten beim Scrollen; Hauptnavigation ab 75 rem in einer Zeile, darunter Menü-Schaltfläche. +- Kontozugang und Kopfzeile sind für Gäste und Mitglieder **identisch** (vorher zeigte die Kopfzeile je nach Anmeldestatus „Registrieren“ oder „Mitgliederbereich“). Gäste gelangen über den Zugang zur Anmeldung. Eine Registrierung ist weiterhin über die Anmeldeseite erreichbar. +- Mobile Navigation: Fläche unter der Kopfzeile, 48 px hohe Einträge, Untermenü eingerückt, Fokusführung und Escape; ohne JavaScript bleibt die Liste sichtbar. Keine feste untere Leiste auf der Website. +- Warenkorb: `config/cms.php` → `cart.enabled` (Vorgabe aus). Solange aus, erscheint nichts. +- Fußbereich: Wortmarke, „Themenbereiche“ (veröffentlichte Säulen), Gruppen aus der CMS-Navigation. Keine erfundenen Kontakt- oder Rechtstexte; bisher gibt es nur die Gruppe „Service“ mit Impressum und Datenschutz. + +## 7. Schnittstellen zum Mitgliederbereich + +Gemeinsam: Tokens (über die bisherigen Variablennamen des Mitgliederbereichs, Werte unverändert), Schriften, Fokusregeln, Wortmarke, Schaltflächen, Formulare, Statusanzeigen. Unverändert: Layout, Seitenleiste, Bibliotheksnavigation, bestehende untere Leiste `member-dock`, Berechtigungen, Suche, Kursplayer. Sichtbare Änderung: Überschriften in Nunito statt Source Serif 4; Zusatz „Mitgliederbereich“ in der dunklen Seitenleiste jetzt kontraststark (vorher dunkle Schrift auf Navy). Geprüft: alle Mitglieder-Tests grün, Sichtprüfung lokal bei 390 und 1440 px ohne horizontalen Überlauf. Auf der Testinstanz stand kein Mitgliedskonto zur Verfügung. + +## 8. Automatisierte Tests + +| Prüfung | Ergebnis | +|---|---| +| Suite lokal | 185 Tests grün (Iteration 1: 145); neu `PageSectionsTest` (17), `CmsSectionRenderingTest` (13), `CmsRollbackCommandTest` (2), erweitert `CmsEditorTest`, `WidgetRegistryTest` | +| Pint | sauber | +| CI Feature-Branch | Läufe 4808/4809 rot, 4810/4811/4813/4815 grün | +| Deploy Testinstanz | Läufe 4812, 4814, 4816 erfolgreich, `/up` 200 | + +Abgedeckt: Registrierung und Mindestbreiten, Abschnitte und Plätze, Rastervalidierung, Layoutwechsel ohne Datenverlust (Editor und Speicherpfad), Abschnittshintergründe und öffentliche Medienfreigabe, freie Werte abgewiesen, Revisionen, Wiederherstellen und Rollback-Fassung, Navigation (Untermenü, Fußgruppen, ausgeblendete Eltern, Löschen), identische Ausgabe für Gäste und Mitglieder, keine Fremd-Schriftserver, Zugriffsschutz der Vorschau, Kompatibilität mit Altbestand (Text der Startseite unverändert nach Speichern im neuen Format). + +**Ursache der roten CI-Läufe:** Das Test-Image läuft mit dem PHP-Standardlimit von 128 MB; die gesamte Suite überschritt es kumulativ (Fatal Error). `phpunit.xml` setzt nun 512 MB wie `docker/php.ini` der Anwendung. Messung: Eine Bearbeitung einer Seite mit 20 Abschnitten à 2 Plätzen braucht rund 74 MB zusätzlich. Keine Prüfung wurde abgeschwächt. + +## 9. Browserprüfung auf der Testinstanz + +Mit dem Prüfkonto über die Oberfläche (Playwright, Chromium), nicht gegen Prod. Die Durchläufe dieses Abschnitts (25/25, 8/8, T1–T9) liefen auf Stand `6152451`, also vor der Änderung an „Veröffentlichen“ (`c6186fb`). Danach geprüft: die Suite, der gemeldete Ablauf (direkt veröffentlichen mit neuem Bild) und dass die Warnung bei ungespeicherten Änderungen ohne Änderung nicht erscheint (Neuladen, nach Speichern, Wiederherstellen, Navigation). Die Prüfskripte erwarten im Bestätigungsdialog noch die alte Schaltflächenbeschriftung und müssen für eine Wiederholung angepasst werden (neu: „Speichern und veröffentlichen“). + +| Prüfung | Ergebnis | +|---|---| +| Bestehende 12 öffentliche Seiten vor/nach Deploy (Status, Titel, Haupttext) | 12/12 unverändert | +| Referenzseite `/referenz-abschnitte` anlegen, gestalten, Layoutwechsel, Duplizieren, Reihenfolge, Löschen, Vorschau 390/768/1440, Veröffentlichen, Ändern, Revision wiederherstellen, mobile Navigation, Übergang zur Anmeldung | 25/25 | +| Untermenü über die Navigationsverwaltung, Tastatur (Enter, Tab, Escape), mobil, wieder entfernt | 8/8 | +| Kein horizontaler Überlauf bei 1440/768/390 px; genau eine H1 | ja | + +Die Referenzseite enthält: Einstieg über volle Breite auf Hintergrundbild (gekennzeichneter Testplatzhalter, dunkle Überlagerung), 2 + 2 auf heller Fläche, 1 + 3 auf dunkler Fläche, 1 + 1 + 1 + 1 auf Markenakzent, 3 + 1 mit dynamischer Programmreferenz; Trenner Markenakzent und Linie; Varianten Kompakte Liste, Bild rechts, Standard. + +**ADR-28, neun Bedienaufgaben** (automatisiert mit Zeitmessung; ersetzt nicht die Abnahme durch den Betreiber): + +| Nr. | Ergebnis | Zeit | Hinweis | +|---|---|---|---| +| T1 Landingpage aus Vorlage | bestanden | 19 s | „Vorlage“ = vorhandene Seite über „Duplizieren“; Vorlage unverändert | +| T2 Bild und Text, Bild, Alternativtext, Variante | bestanden | 10 s | Widget-Vorschau zeigt „Bild rechts“ vor dem Speichern | +| T3 umsortieren, duplizieren | bestanden | 2 s | erster Durchlauf scheiterte am Messskript (Aktionen ohne Warten auf Livewire), Wiederholung bestanden | +| T4 zwei Programme wählen, tauschen | bestanden | 15 s | Titel aus den Fachdaten | +| T5 zu langer Titel bei 390 px | bestanden (eingeschränkt) | – | kein Überlauf, Silbentrennung greift; „Erkennen ohne Hinweis“ ist nur mit Menschen prüfbar | +| T6 globalen Abschnitt ändern | **nicht bestanden** | – | globale Abschnitte sind nicht umgesetzt | +| T7 frühere Revision wiederherstellen | bestanden | 5 s | | +| T8 20 Abschnitte öffnen, ändern, speichern | bestanden | 2,0 / 0,3 / 1,4 / 2,3 s | Öffnen/Dialog/Übernehmen/Speichern; erste Messung 4,0 s enthielt Wartezeiten des Skripts. Mehrspaltige Seite (6 Abschnitte, 12 Plätze): 1,4 / 1,6 s | +| T9 Pflichtfeld leer | bestanden | 6 s | Dialog bleibt offen; Speicherfehler „Abschnitt 1, Platz 1 (Einstieg): braucht mindestens 2 Rastereinheiten“ als Meldung und am Abschnitt | + +Ergebnis: 8 von 9 Aufgaben technisch bestanden, darunter T1, T4, T8. Die Entscheidungsregel verlangt zusätzlich die Durchführung durch den Betreiber und dessen Aussage „so würde ich wöchentlich arbeiten“; das steht aus. + +Weitere Beobachtungen: Eine Konsolenmeldung 403 während der Bearbeitung (vermutlich Upload-Vorschau, nicht eingegrenzt); alle Bilder der veröffentlichten Seite liefern 200. Bildschirmleser und echte Mobilgeräte wurden nicht geprüft. + +**Rückmeldung des Auftraggebers während der Prüfung:** „Bild im Widget gewählt oder hochgeladen, im Editor sichtbar, nach Veröffentlichen nicht auf der Website und nach Neuladen im Editor weg.“ Auswahl, Upload, neue und vorhandene Widgets (Einstieg, Bild und Text, Karten) speicherten auf der Testinstanz jeweils korrekt, sobald „Entwurf speichern“ geklickt wurde. Ein Verlust ließ sich in keinem Ablauf mit „Entwurf speichern“ reproduzieren. Reproduzierbar war nur der Ablauf *Übernehmen → Veröffentlichen ohne Speichern*: „Veröffentlichen“ stellte die zuletzt gespeicherte Revision live, die ungespeicherte Änderung ging beim Neuladen verloren (Hinweis nur im Bestätigungsdialog). Das ist die wahrscheinliche Ursache, nicht nachgewiesen. Vor Deploy 4812 lief auf der Testinstanz noch der Code der Iteration 1. Behoben: „Veröffentlichen“ speichert zuerst und veröffentlicht genau diesen Stand; unveränderte Stände erzeugen keine weitere Revision; der Editor warnt beim Verlassen oder Neuladen mit ungespeicherten Änderungen. Tests: zwei neue Editor-Tests (zuerst rot, dann grün), Browserprüfung des gemeldeten Ablaufs auf der Testinstanz. + +## 10. Bekannte Einschränkungen + +- Keine globalen Abschnitte (T6), keine Seitentypen oder echten Vorlagen; „Duplizieren“ deckt den Vorlagenfall teilweise ab. +- Widget-Vorschauen im Editor zeigen die Abschnittsfläche nicht (heller Grund); die Seitenvorschau zeigt sie. +- Hintergrundbilder werden in Originalgröße ausgeliefert (kein `srcset`, keine abgeleiteten Zuschnitte); Fokuspunkt nur in neun Stufen. +- Mindestbreite gilt je Platz auf dem Desktop; die Widget-Auswahl bietet auch zu breite Widgets an und warnt erst im Platzkopf und beim Speichern. +- Raster mit weniger Plätzen sind gesperrt, solange mehr Widgets eingesetzt sind; ein automatisches „überzählige Widgets in neuen Abschnitt verschieben“ gibt es nicht. +- Öffentliche Seiten werden noch nicht zwischengespeichert (ADR-32 offen); sie sind aber anmeldeunabhängig gerendert. +- Seitenliste der Verwaltung zeigt 10 Einträge je Seite (Bestand). + +## 11. Marken- und Assetfreigaben + +| Asset / Wert | Verwendet | Status | +|---|---|---| +| Markenfarben aus Brand-UI-Kit (`tokens.json`) | ja | **vorläufig**, Freigabe fehlt | +| Nunito (Auszeichnung), Source Sans 3 (Lesen) | ja, lokal ausgeliefert | **vorläufig** (Zielkonzept 7.2, offen); Lizenz als frei angenommen, nicht geprüft | +| Wortmarke als Weblogo | **nein**, fehlt | vorläufiger Schriftzug, gekennzeichnet `data-brand-status="vorlaeufig"` | +| Titel-, Denkpause-, Outro-Motiv | nein | Originale vorhanden, öffentliche Nutzung laut Quellenmanifest nicht freigegeben | +| Figurenreferenzen | nein | nur intern | +| SVG-Entwürfe, KI-Konzeptgrafiken | nein | nicht freigegeben | +| Themensignaturen (5) | Platz vorbereitet (Nummer + Name, neutrale Tönung) | Symbole und Tönungen nicht entworfen | +| Hintergrundbild Referenzseite | gekennzeichneter Testplatzhalter | nur Testinstanz | + +## 12. Rollback- und Wiederherstellungsweg + +Siehe `cms-widget-registry.md` §9. Zusammengefasst: Ein reiner Code-Rollback ist nach Änderungen im neuen Editor **nicht sicher**. Auf Iteration 1 zeigt er alle Inhalte ohne Raster und Flächen; auf den heutigen Prod-Stand (vor der Registry) scheitert er an den neu gespeicherten Seiten. Vor jedem Rollback: `php artisan cms:revert-published --before=""` (Probelauf), dann `--apply`; der Befehl setzt nur Veröffentlichungszeiger zurück. SQL-Gegenstück für den Fall, dass der neue Code nicht mehr läuft, ist dokumentiert. Migrationen müssen nicht zurückgenommen werden. + +Für den späteren Merge nach `main`: `main` liegt jetzt 62 Commits hinter `develop` (einschließlich dieser Berichtskorrektur 63) (Iteration 1 und 2 sowie die früheren Bibliothekspakete). Nach dem Prod-Deploy sollte vor der ersten Bearbeitung im Editor der Deploy-Zeitpunkt notiert werden. + +## 13. Empfehlungen für die visuelle Veredelung + +1. Freigaben einholen: Wortmarke als SVG, Farbwerte (mit gemessenem Kontrast), Schriften, Bildmotive mit Rechten und textfreien Zuschnitten. +2. Dann nur `tokens.css` und `components/site/brand.blade.php` ändern; Sichtprüfung 390/768/1440. +3. Widgets einzeln mit Design-Skills veredeln (Ansicht + `widgets.css`), Daten und Klassen bleiben stabil; zuerst Einstieg, Programmkarten (mit Themensignaturen statt Inhaltsart-Fläche), Bild und Text. +4. Themensignaturen-Familie entwerfen und je Säule pflegbar machen. +5. Abgeleitete Bildgrößen für Abschnittshintergründe über die Hintergrundverarbeitung. +6. UX-Abnahme T1–T9 mit dem Betreiber; anschließend über ADR-28 entscheiden. + +## Auswirkungen auf ADR-28, ADR-30, ADR-36 + +| ADR | Auswirkung | Status | +|---|---|---| +| ADR-28 Ausbau des Eigen-CMS | Abschnittsraster, Gestaltung und Seiten-Duplikat mit Filament-Bordmitteln ohne Zusatzpaket umgesetzt; 8 von 9 Bedienaufgaben technisch bestanden, T6 (globale Abschnitte) offen | **technisch gestützt, UX-Abnahme durch den Betreiber offen**; keine Freigabe durch diesen Bericht | +| ADR-30 Widget-Register | Vertrag unverändert, um Breitenmetadaten ergänzt; Abschnitte als zweite versionierte Hülle über dem Register, kein zweites Register; Editor und Vorschau nutzen weiterhin dieselbe Darstellung | bestätigt im umgesetzten Umfang | +| ADR-36 Designsystem | zweistufige Tokens im Repository, gemeinsame Basis für Website und Mitgliederbereich | Struktur umgesetzt; **Markenwerte und Schriften weiterhin unter Freigabevorbehalt** | +| ADR-32 (berührt) | öffentliche Ausgabe anmeldeunabhängig, Test belegt identisches HTML | Zwischenspeicher weiterhin offen | + +## Auf der Testinstanz angelegt oder geändert + +- Seite `/referenz-abschnitte` (veröffentlicht, Prüftexte, Testplatzhalter als Hintergrund `cms/testplatzhalter-hintergrund-*.jpg`). +- Seiten `/t1-landingpage` und `/t1-landingpage-b` (veröffentlicht, aus den Bedienaufgaben T1/T7). +- Neue Revision der Messseite `/pruefung-zwanzig-abschnitte` (weiterhin unveröffentlicht). +- Seiten `/bildpruefung-select` und `/bildpruefung-upload` (veröffentlicht, Bildprüfung zur Rückmeldung), mehrere Revisionen darin; auf `/bildpruefung-select` zuletzt eine wiederhergestellte, unveröffentlichte Revision. +- `/referenz-abschnitte`: Abschnitt 3 („Bild und Text“) hat nachträglich ein Bild erhalten und wurde neu veröffentlicht. +- Mehrere Testbilder `cms/testplatzhalter-hintergrund-*.jpg` im öffentlichen Medienbereich der Testinstanz. +- Ein Navigations-Prüfeintrag wurde angelegt und wieder gelöscht. Keine sonstigen Navigationsänderungen. +- Keine Bereinigung bestehender Testinhalte: Die vorhandenen Seiten werden unverändert dargestellt und sind im neuen Editor bearbeitbar; eine Bereinigung war nicht nötig. diff --git a/docs/analysen/cms-medienverwaltung-bericht-2026-11-19.md b/docs/analysen/cms-medienverwaltung-bericht-2026-11-19.md new file mode 100644 index 0000000..d851558 --- /dev/null +++ b/docs/analysen/cms-medienverwaltung-bericht-2026-11-19.md @@ -0,0 +1,77 @@ +# Einheitliche Medienverwaltung im CMS – Bericht + +Branch `feature/cms-medienverwaltung`, Commits `7c63424` (Website-Ableitung) und `053a8d4` (Umstellung). Gearbeitet wurde in einem separaten Worktree, der Deploy lief über `develop` (CI 4859, Deploy 4860). Kein Merge nach `main`. + +- Entscheidung: ADR-40. +- Technik: `docs/architektur/medienzugriff-fuer-komponenten.md`, Abschnitt „Umsetzung im CMS“, und `cms-widget-registry.md` §§ 7 und 9. + +## 1. Ergebnis + +**Bildstellen:** +- Alle Bildstellen des CMS verwenden den zentralen Medienbestand: Einstieg (Hero), Bild und Text, redaktionelle Karten, Premium-Karten (Kartenbild) und Abschnittshintergrund. +- Gespeichert wird die Kennung des Mediums, nicht ein Pfad. +- Öffentlich erscheint ein Bild nur mit Website-Freigabe (`WebsiteMedia`, Route `website.media`). +- Die CMS-eigene Bildauswahl entfällt. + +**Im Widget-Dialog** (Reiter „Medien“, beim Abschnitt „Gestaltung“): + +| Funktion | Verhalten | +|---|---| +| Auswahl | Alle Bilder des Medienmanagers, durchsuchbar, mit Vorschaubild, Titel und Website-Status (freigegeben, nicht freigegeben, wird verarbeitet) | +| Neues Bild hochladen | Das Bild wird sofort im Medienmanager angelegt (`WebsiteIntake`) und ausgewählt. Nach der Verarbeitung gibt die Warteschlange es automatisch für die Website frei. | +| Gewähltes Bild | Vorschaubild, Status mit Begründung und „Im Medienmanager öffnen“ (dort steht die Website-Freigabe) | +| Austauschen | Ein anderes Bild in der Auswahl wählen; Bildausschnitt und Darstellung bleiben im Widget | +| Alternativtext | Kommt aus dem Medium. Das Feld im Widget ist eine optionale Abweichung. | + +**Medienmanager:** Die Medienansicht nennt jetzt die Website-Seiten, die das Bild verwenden. Beim Zurücknehmen der Freigabe weist sie darauf hin, dass das Bild dort verschwindet. + +**Nicht freigegeben:** Öffentlich entfällt nur das Bild; Überschrift, Text und Schaltflächen des Widgets bleiben. Die Redaktionsvorschau zeigt das Vorschaubild mit dem Hinweis, warum es öffentlich nicht erscheint und wo die Freigabe steht. + +**Website-Ableitung:** Bilder werden bis 2400 px breit abgeleitet statt in 640 px Vorschaugröße und nie vergrößert. Transparente Flächen werden weiß. Filmstandbilder bleiben bei 640 px. Diese Änderung betrifft Lars' `ThumbnailDeriver` und liegt deshalb in einem eigenen Commit. + +## 2. Übernahme der Bestandsmedien (Testinstanz) + +Der Job `ImportCmsImages` wurde beim Deploy von einer Migration angestoßen und von der Warteschlange ausgeführt. Ergebnis, lesend geprüft: + +- **21 frühere Bilddateien** unter `cms/`, bytegleich zusammengefasst zu **9 Medien**: Felix und die Einkäufe (Intro), Lara Felix Park (Original), Platzhalter Bild Text, Platzhalter Karte 1, 2 und 3, Platzhalter Markenbühne, Prüfbild, Testplatzhalter Hintergrund. +- Alle 9 Medien sind abgeleitet und freigegeben. Es gibt keine offenen und keine fehlgeschlagenen Jobs. +- Gelöscht wurde nichts. Die Dateien unter `cms/` und alle Revisionen bleiben unverändert. +- Frühere Pfade gelten über `website_media_aliases` als das jeweilige Medium. Beim nächsten Speichern wird die Kennung eingetragen. + +## 3. Prüfung + +| Prüfung | Ergebnis | +|---|---| +| Testsuite | 245 grün, davon neu: 8 Tests für die Medienanbindung und 2 für die Ableitungsgröße. Bewusst geändert: Die Alt-Text-Pflicht im Widget entfällt, weil der Alternativtext zum Medium gehört. | +| Bestehende Seiten vor und nach Deploy und Übernahme | Geometrie unverändert (16 Messungen: 8 Seiten bei 1440 und 390 px), Texte unverändert (12 Seiten). Alle 16 Bilder auf 5 Seiten kommen jetzt über `/website-medien/`, sind geladen und haben dieselben Maße und Alternativtexte (zuvor `/medien/cms/`). Frühere Revisionen werden damit korrekt dargestellt. | +| Browser auf der Testinstanz, Redaktionsablauf (13 von 13) | siehe Liste darunter | +| Browser auf der Testinstanz, Freigabe zurücknehmen (8 von 8) | siehe Liste darunter | +| Slideshow | Im CMS gibt es keine Slideshow. Neue Widget-Arten waren nicht Teil des Auftrags. `WebsiteMedia::presentMany` ist vorbereitet, aber noch unbenutzt. | + +**Redaktionsablauf, Prüfkonto, regulärer Seitenkonfigurator, Entwurfsseite, nichts veröffentlicht:** +- Vorhandenes Bild aus dem Medienmanager im Einstieg gewählt; Picker und Statusanzeige mit Vorschaubild und Verweis. +- Übernommene Platzhaltergrafik („Platzhalter Markenbühne“) durch „Platzhalter Bild Text“ ersetzt. +- Neues Bild direkt im Dialog hochgeladen: Es war sofort ausgewählt, zuerst mit „Wird gerade verarbeitet“, danach freigegeben. Im Medienmanager per Suche auffindbar; dessen Ansicht nennt die verwendende Seite. +- Dasselbe Medium in Einstieg und Karte verwendet. +- Gespeichert, wieder geöffnet, Vorschau: alle Bilder über `/website-medien/`, geladen, 1200 bis 1600 px breit. + +**Freigabe zurücknehmen, auf `/premium-referenz`, danach wiederhergestellt:** +- Die Medienansicht nennt die Seite. +- Nach dem Zurücknehmen fehlt das Bild öffentlich; die übrigen 6 Bilder bleiben. +- `/website-medien/15` und die frühere Adresse `/medien/cms/…` liefern 404. +- Nach der erneuten Freigabe ist der Ausgangszustand wieder da; Geometrie und Bilder entsprechen dem Stand vorher. + +**Auf der Testinstanz neu angelegt:** +- das Medium „Platzhalter Upload Medienpruefung“ (gekennzeichneter Platzhalter), +- die Entwurfsseite `/medien-pruefung-entwurf`. + +Beides lässt sich über den Medienmanager bzw. die Seitenverwaltung entfernen. + +## 4. Offene Punkte für Lars + +1. **Bild entfällt oder Widget entfällt?** Entschieden am 19.11.2026: Das Medium wird nicht öffentlich ausgeliefert. Texte und übrige Widget-Inhalte bleiben. Ein Widget ohne verbleibenden Inhalt entfällt. Siehe ADR-40. +2. **Bildschlüssel:** Gespeichert wird im bisherigen Schlüssel `image` (`refs.image`, `style.image`, `data.items[].image`), nicht in `refs.element`. Grund: Die Medienkarte nutzt `refs.element` für ihr Fachobjekt. Das Dokument ist entsprechend ergänzt. +3. **Originalmotiv freigegeben:** „Lara Felix Park Original“ (`cms/lara-felix-park-original-…png`) lag bereits öffentlich unter `cms/` und ist durch die Übernahme ein freigegebenes Medium. Ist die Veröffentlichung nicht geklärt, im Medienmanager zurücknehmen; `/premium-referenz` zeigt es dann nicht mehr. +4. **Titel und Quellenzeilen der übernommenen Medien** kommen aus den Dateinamen, ohne Quellenzeile, zum Beispiel „Platzhalter Markenbuehne“ ohne Umlaut. Beides lässt sich im Medienmanager pflegen. +5. **Rollback:** Eine Code-Fassung vor der Umstellung zeigt Bilder nicht, die danach gespeichert wurden (Kennung statt Pfad). Texte bleiben, die Dateien unter `cms/` bleiben (Registry §9). +6. **Bedienmuster:** Die Bildauswahl des Modul- und Programmeditors ist an dessen Seite gebunden und ließ sich nicht als Formularfeld wiederverwenden. Das Bedienmuster (Suche, Vorschaubild, Auswahl) ist übernommen, die Abfrage greift auf denselben Bestand zu. diff --git a/docs/analysen/cms-widget-registry-bericht-2026-11-17.md b/docs/analysen/cms-widget-registry-bericht-2026-11-17.md new file mode 100644 index 0000000..03276c1 --- /dev/null +++ b/docs/analysen/cms-widget-registry-bericht-2026-11-17.md @@ -0,0 +1,136 @@ +# Abschlussbericht: CMS-Grundsystem, Widget-Registry und Seiteneditor + +Stand: 17.11.2026 · Branch `feature/cms-widget-registry` (Commits `9d936bf`, `2dc479a`), auf `develop` gemergt und auf die Testinstanz deployt. **Nicht** auf `main`/Produktion. +Technische Details: `docs/architektur/cms-widget-registry.md`. + +> Eine erfolgreiche technische Umsetzung ist keine fachliche Freigabe von ADR-28/ADR-30. Die UX-Abnahme erfolgt durch den Auftraggeber. + +## Ist-Befund vor der Umsetzung + +| Bereich | Befund im Code (vor `9d936bf`) | +|---|---| +| Seiten/Revisionen | `pages` mit Zeiger auf veröffentlichte Revision, `page_revisions` mit Bausteinen als JSON; Speichern = neue Revision, Veröffentlichen = Zeiger, Wiederherstellen = neue Revision. Bestätigt. | +| Bausteine | sechs Arten in einer Klasse `BlockRegistry` (Regeln per `match`), flaches JSON ohne Version, Variante oder Kennung. Bestätigt wie beobachtet: Karten = wiederholbare Einträge Titel/Text/Adresse; Bild und Text = Text, Upload, Alternativtext. | +| Editor | ein Repeater, alle Felder aller Arten im selben Formular, per Sichtbarkeitsbedingung ein-/ausgeblendet. Keine Vorschau im Editor. | +| Vorschau | Route vorhanden, aber unter dem Mitglieder-Guard; ein nur in der Verwaltung angemeldeter Redakteur wurde zur Mitgliederanmeldung umgeleitet. Keine Breitenumschaltung. | +| Navigation | Anlegen möglich; Tabelle ohne Bearbeiten-, Löschen- oder Sortieraktion. Adressen ohne Schemaprüfung (`javascript:` wurde angenommen und ausgegeben). | +| Medien | Upload nach `cms_incoming`, Übertragung nach `media_public` in der Queue; nur `image_text`. | +| Programme/Module | öffentliche Programmliste `/programme` zeigt Kompositionen der Inhaltsart „programm“ mit Anzeigefreigabe. Öffentliche Profile (ADR-29) existieren nicht; für Module gibt es keine öffentliche Seitenart. | +| W-P-Prototyp | Die Analyse `wp-editor-prototyp-2026-03-15.md` beschreibt Code, der im Repository nicht existiert (Branch ohne eigene Commits). | + +Keine grundlegende Unvereinbarkeit mit dem Auftrag; daher ohne Vorabentscheidung umgesetzt. + +## 1. Wiederverwendete Bestandteile + +Seiten-/Revisionsmodell und Tabellen (unverändert), `PageService` (Entwurf/Veröffentlichen/Wiederherstellen), Vorschauroute, Navigationsverwaltung (`NavigationItemResource`), öffentlicher Medienweg (`cms_incoming` → `PublishPublicMedia` → `media_public`, `/medien/cms/…`), Anzeigefreigabe der Bibliothek (`CompositionDisplayRelease`), Stylesheet und Markenwerte, Textwortmarke, Filament-Builder/Repeater/Modal, Policies (`PagePolicy`, `NavigationItemPolicy`). + +## 2. Neu implementierte Komponenten + +| Komponente | Datei(en) | +|---|---| +| Widget-Vertrag und Register | `app/Domain/Cms/Widgets/WidgetType.php`, `WidgetRegistry.php`, `config/cms.php` | +| Gemeinsamer Renderer | `app/Domain/Cms/Widgets/WidgetRenderer.php`, `resources/views/widgets/*` | +| 8 Widget-Arten | `app/Domain/Cms/Widgets/Types/*` | +| Hilfen (sichere Links, bereinigter Text, öffentliche Medien, Bildauswahl) | `app/Domain/Cms/Widgets/Support/*` | +| Katalog-Lesesicht | `app/Domain/Cms/Catalog/PublicCatalogReader.php` (auch von `/programme` genutzt) | +| Editor-Adapter | `app/Filament/Support/WidgetEditor.php`, `WidgetBlock.php` | +| Geräte-Vorschau | `/redaktion/vorschau/{revision}/geraete`, `resources/views/public/preview-devices.blade.php` | +| Basislayout | `resources/views/components/site/{brand,header,footer}`, `site/templates/standard`, `PageTemplates` | +| Navigation | Bearbeiten, Aus-/Einblenden, Löschen, Ziehen zum Sortieren, Gruppen Kopf/Fuß; Migration `is_visible` (ergänzend) | + +## 3. Registry und Erweiterungsschnittstelle + +Jede Widget-Art ist eine Klasse mit Typkennung, Name, Beschreibung, Schemaversion, Prüfregeln für `data`/`refs`, freigegebenen Varianten, optionalen Aufzählungs-Einstellungen, Editorfeldern, Blade-Ansicht, Verweisauflösung, Medienliste und Zusammenfassung. Gespeichert wird die Hülle `{id, type, v, variant, settings, data, refs}` aus dem Architekturentwurf. Editor, Speicherung, Vorschau und öffentliche Seite lesen alles aus dem Register; der Editor enthält keine Sonderfälle je Art. Altbestand wird beim Lesen angehoben, gespeicherte Revisionen bleiben unverändert. + +## 4. Widget-Arten und Varianten + +| Art | Varianten | Bemerkung | +|---|---|---| +| Einstieg (Hero) – neu | Standard (Bild neben Text), Hervorgehoben (Markenfläche) | optionales Bild und Handlungsaufruf | +| Bild und Text – erweitert (v2) | Bild links, Bild rechts | optionaler Titel, formatierter Text (fett, kursiv, Link, Listen), Bild aus vorhandenen Website-Bildern oder neu, Alternativtext; mobil untereinander | +| Redaktionelle Karten – erweitert | Raster, Kompakte Liste | Titel, Beschreibung, Linkziel, optionales Bild, sortierbar | +| Programm- und Modulkarten – neu | Karten mit Kurzbeschreibung, Kompakte Liste | nur Verweise; Inhalte aus den Fachdaten | +| Überschrift und Einleitung, Fließtext, Handlungsaufruf, FAQ | Standard | unverändert übernommen (v1) | + +## 5. Weiteres Widget hinzufügen + +Klasse in `app/Domain/Cms/Widgets/Types/` (von `WidgetType` ableiten), Ansicht `resources/views/widgets/.blade.php`, Eintrag in `config/cms.php`, Tests. Ablauf und Regeln: `docs/architektur/cms-widget-registry.md`, Abschnitt 5. + +## 6. Testergebnisse + +- Lokal: 145 Tests, 996 Assertions grün; Pint sauber. Neu: `tests/Unit/WidgetRegistryTest.php` (Registrierung, Validierung, Varianten, Einstellungen, Bereinigung, Versionierung, Altformat, Kennungen, neues Widget allein über den Vertrag), `tests/Feature/CmsWidgetRenderingTest.php` (Bestandsseiten im **flachen Altformat** textgleich zum Stand vor der Umstellung, Rundlauf durch den Editor, Varianten, Medienveröffentlichung, Katalogregeln inkl. Rücknahme der Freigabe), `tests/Feature/CmsEditorTest.php` (Anlegen, Bearbeiten, Sortieren, Duplizieren, Fehleranzeige, Vorschauzugriff, Navigation). +- CI-Gate `ci-feature.yml` (Pint, Suite, Migrationen gegen Wegwerf-Postgres): Läufe #53 und #54 erfolgreich. +- `deploy-test.yml`: siehe Abschnitt 7. +- Entfernt: `tests/Unit/BlockRegistryTest.php`; beide Prüfungen (Alternativtext, `javascript:`-Links) stecken erweitert in `WidgetRegistryTest`. + +## 7. Browserprüfungen + +### Lokal (Playwright, Kopie der Anwendung mit Prüfbestand) + +| Szenario | Ergebnis | +|---|---| +| Neue Seite anlegen; Widgets aus der Auswahl (Name, Beschreibung, Schema) wählen und konfigurieren | bestanden | +| Bild hochladen, formatierter Text, Variante „Bild rechts“ | bestanden | +| Programm und Modul per Suche referenzieren | bestanden (Programm öffentlich, Modul nur in der Vorschau mit Hinweis) | +| Variante wechseln, Blockvorschau ohne Speichern | bestanden | +| Abschnitte sortieren (Pfeile), duplizieren | bestanden | +| Vorschau 390/768/1440 px | bestanden | +| Vor Veröffentlichung nicht öffentlich (404), danach sichtbar; keine horizontale Scrollbar in allen drei Breiten | bestanden | +| Redaktionelle Änderung: Entwurf ändert Live-Seite nicht; nach Veröffentlichen geändert | bestanden | +| Frühere Revision wiederherstellen und veröffentlichen | bestanden | +| Navigation: anlegen mit interner Seite, bearbeiten, ausblenden/einblenden, per Ziehen sortieren | bestanden | +| Acht Bestandsseiten bei 390 px erreichbar | bestanden | +| T9: Bild ohne Alternativtext → Meldung „Abschnitt 5 (Einstieg (Hero)): …“, nichts gespeichert; leeres Pflichtfeld hält den Dialog offen | bestanden (nach Nachbesserung) | + +Im Browser gefundene und behobene Fehler: Pfadfehler wurden nicht angezeigt (Speichern blieb wirkungslos), doppelter Pfad hätte einen Serverfehler ausgelöst, Kopfzeile der Vorschau zeigte die Personal- statt der Besucheransicht, Registry-Fehler waren bei geschlossenen Dialogen unsichtbar, „Seite anlegen“ verwarf gewählte Säulen. + +### Testinstanz (`http://192.168.2.144:3011`, nach `deploy-test.yml` #4805, erfolgreich) + +| Prüfung | Ergebnis | +|---|---| +| Bestandsseiten vor/nach dem Deploy (`/`, `/angebote`, `/datenschutz`, `/impressum`, `/materialien`, `/praevention`, `/trainer`, `/ueber`, `/programme`, `/themen`): Status, Seitentitel und Text des Inhaltsbereichs | **10/10 identisch** (Daten im Altformat aus der Testdatenbank) | +| Referenzseite `/praevention-im-alltag` anlegen mit Hero, Bild und Text, redaktionellen Karten, Programm-/Modulkarten (Programm „Programm Abstand“, Modul „Modul Abstand“), Säule „Sicher handeln im Alltag“ | bestanden | +| Variante wechseln, sortieren, Vorschau 390/768/1440, Veröffentlichen, Änderung, Wiederherstellen | **22/22** bestanden | +| Öffentlich: Programmkarte aus den Fachdaten mit Link auf die Programmseite, Modul ausgeblendet, Bild aus `/medien/cms/`, keine horizontale Scrollbar in drei Breiten | bestanden | +| Navigation: Eintrag „Themenseite Prävention“ angelegt, bearbeitet (und zurückgesetzt), aus-/eingeblendet, per Ziehen an Position 2 sortiert; Bestandsseiten bei 390 px | **14/14** bestanden | +| T8: Seite mit 20 Abschnitten öffnen, einen Text ändern, übernehmen, speichern | Öffnen 1,3 s · Dialog 0,3 s · Übernehmen 1,1 s · Speichern 1,0 s (Grenze 3 s je Vorgang) | + +**Auf der Testinstanz angelegte bzw. geänderte Daten:** veröffentlichte Seite `/praevention-im-alltag` (Bild: neutrales Platzhalterbild mit entsprechendem Alternativtext, da kein Bildmaterial freigegeben ist), unveröffentlichte Messseite `/pruefung-zwanzig-abschnitte`, Navigationseintrag „Themenseite Prävention“ (Kopfzeile, Position 2), Zwei-Faktor-Einrichtung für das Prüfkonto `vibecoder@example.de`. Auf Test ist noch kein Themenbereich veröffentlicht; die Zuordnung zur Säule wird erst mit dessen Veröffentlichung unter `/themen` sichtbar. + +Nicht automatisiert geprüft: die Bedienaufgaben T1–T9 mit dem Betreiber und Zeitmessung (UX-Abnahme), Bildschirmleser, echte Mobilgeräte. + +## 8. Bekannte Einschränkungen + +- **Rollback:** Nach dem Deploy im Editor gespeicherte Seiten liegen im neuen Format; ein reiner Code-Rollback stellt sie nicht dar (Fehler 500 auf diesen Seiten). Abhilfe: Revision aus der Zeit vor dem Deploy veröffentlichen oder wieder vorwärts deployen. Vor dem Merge nach `main` beachten. +- **Module öffentlich:** erst mit öffentlichen Profilen (ADR-29). Bis dahin nur Redaktionsvorschau. +- **Vorschaubilder von Programmen/Modulen** werden öffentlich nicht gezeigt (geschützt, Paket 6); die Karte zeigt eine Inhaltsart-Fläche. +- **Archivierte Programme** erscheinen in der Liste `/programme` weiterhin (Bestandsverhalten), im Katalog-Widget nicht. +- **Verwaiste Uploads:** Wird ein Dialog mit neuem Bild verworfen oder die Seite nicht gespeichert, bleibt die Datei in `cms_incoming` liegen (kein Aufräumen). +- **Kartenbilder** gelten als dekorativ (`alt=""`). +- **Bildauswahl** zeigt Dateinamen, keine Miniaturen; die Blockvorschau zeigt das gewählte Bild sofort. +- **Unbekannte Widget-Arten** (zum Beispiel nach einem Code-Rollback) entfallen beim nächsten Speichern im Editor. +- **Markenzeichen:** Textwortmarke; laut Brand-UI-Kit gibt es keine freigegebene Logodatei und ungeklärte Bildrechte. Es wurden keine Kit-Dateien übernommen. +- **Settings** (Flächenton, Breite, Abstand) sind im Vertrag vorgesehen und geprüft, aber von keiner Art genutzt. +- In der Automatisierung musste nach einer Auswahl im Katalog-Widget kurz gewartet werden, bevor der nächste Eintrag hinzugefügt wurde; bei menschlicher Bedienung nicht beobachtet, aber in der UX-Abnahme zu beachten. + +## 9. Offene fachliche Entscheidungen + +1. Öffentliche Fachobjektprofile (ADR-29): Listungsentscheidung, gezeigte Fassung, öffentlich freigegebenes Bild – Voraussetzung für öffentliche Modulkarten und Bilder auf Programmkarten. +2. Soll eine Anzeigefreigabe für Programme weiterhin automatisch öffentliche Sichtbarkeit bedeuten (heutiges Verhalten von `/programme`, im Widget übernommen), bis ADR-29 umgesetzt ist? +3. Freigabe einer Logodatei und von Bildmaterial (Brand-UI-Kit) für die öffentliche Website. +4. Seitentypen/Vorlagen und globale Abschnitte (ADR-28 Variante D): technisch vorbereitet (`PageTemplates`), fachlich nicht entschieden. +5. Sollen archivierte Programme aus `/programme` verschwinden? +6. Medienbibliothek für Website-Bilder mit Alternativtext je Bild statt je Verwendung. + +## ADR-28 / ADR-30: bestätigt bzw. widerlegt + +| Vorschlag | Ergebnis der Umsetzung und Prüfung | +|---|---| +| ADR-30: codebasiertes Register mit Hülle `{id, type, v, variant, settings, data, refs}` | **bestätigt.** Umgesetzt; eine nur im Test definierte Art läuft ohne Änderung an Editor oder Darstellung. | +| ADR-30: alte Revisionen über Schema-Aufwärtsfunktion lesbar | **bestätigt.** Flache Altrevisionen und `image_text` v1→v2 werden beim Lesen angehoben; textgleich zur alten Darstellung. | +| ADR-30: Vorschau und öffentliche Darstellung mit derselben Rendererlogik | **bestätigt.** Ein Renderer; die Blockvorschau braucht dafür ein isoliertes `iframe`, weil Website- und Verwaltungsstile kollidieren. | +| ADR-30: Katalogbausteine speichern nur Kennungen; nicht öffentliche Objekte erscheinen nicht | **bestätigt** mit Übergangsregel (Abschnitt 8 und 9). | +| ADR-28: Ausbau des Eigen-CMS mit Filament-Bordmitteln ist bedienbar | **technisch bestätigt, UX-Abnahme offen.** Builder mit Vorschau, Dialog, Sortieren, Duplizieren funktioniert ohne Zusatzpaket (K4). Die neun Bedienaufgaben mit dem Betreiber (Zeitmessung T1–T9) stehen aus; T8 siehe Abschnitt 7. | +| ADR-28: Vorlagen und globale Abschnitte | **nicht geprüft** (nicht beauftragt). | +| Zielarchitektur 5.4: `blockPreviews()` rendert die öffentliche Blade-Ansicht | **mit Einschränkung bestätigt:** Stilisolation per `iframe` nötig; Felder im Dialog erfordern eine zusätzliche Fehlermeldung beim Speichern. | +| Zielarchitektur 5.4: Auswahl nur öffentlich geschalteter Objekte | **teilweise widerlegt** für den Übergang: Damit Module überhaupt kuratiert werden können, bietet der Editor auch nur zur Anzeige freigegebene Module an und kennzeichnet sie „nur Redaktionsvorschau“. | diff --git a/docs/analysen/designiteration-1-bericht-2026-11-18.md b/docs/analysen/designiteration-1-bericht-2026-11-18.md new file mode 100644 index 0000000..8fa5016 --- /dev/null +++ b/docs/analysen/designiteration-1-bericht-2026-11-18.md @@ -0,0 +1,167 @@ +# Abschlussbericht Designiteration 1: Markenintegration, Website-Gerüst, Premium-Widgets + +Stand: 18.11.2026. Branch `feature/design-iteration-1` (von `develop`), per Fast-Forward auf `develop` übernommen und über `deploy-test.yml` auf der Testinstanz (Port 3011) bereitgestellt, zuletzt Lauf 4829. **Kein Merge nach `main`.** Commits: `33aaf64` (Umsetzung), `8390dcd` und `7c1caec` (Breitenmessung der Navigation), `d89d4bd` (Markenstrich), `8387cc9` (Bericht), `656f999` (Breitenstufen vor dem ersten Zeichnen, Vorschau, Fußbereichslinie), dazu diese Berichtskorrektur. + +Fachliche Dokumentation: `docs/architektur/designsystem.md` (Tokens, Breitenmodell, Kopfzeile, Markenassets) und `docs/architektur/cms-widget-registry.md` (Varianten, Einstellungen, Randlos-Darstellung, Rollback). + +## 1. Quellen + +Geprüft: `docs/prinzipien/design-prinzipien.md` (mit Vorrang), `docs/strategie/website-cms-seo-marketing-zielkonzept.md`, `docs/architektur/website-cms-marketing-zielarchitektur.md`, `docs/architektur/12_Entscheidungsprotokoll_ADR.md` (lokaler Arbeitsstand, nicht verändert), `docs/architektur/cms-widget-registry.md`, das Brand-UI-Kit unter `docs/Brand-UI-Kit/` (ZIP und entpackte Ordner `01`–`06`, README, Quellenmanifest, Cursor-Übergabe). + +**`00_LUF_Projektkompass.md` liegt weiterhin nicht im Repository.** + +## 2. Ist-Befund vor der Umsetzung + +Gemessen mit echten Scrollbalken (Chromium, lokale Kopie und Testinstanz): + +| Beobachtung | Ursache im Code | +|---|---| +| Kopfzeile wechselt zwischen 73 und 93 px Höhe | Die Navigation brach mit `flex-wrap: wrap` zwischen etwa 1200 und 1410 px in zwei Zeilen um. Ob sie umbrach, hing davon ab, ob die Seite einen Scrollbalken hatte: Bei 1400 px war die Kopfzeile auf langen Seiten 93 px, auf kurzen 73 px hoch. | +| Wortmarke und Inhalt springen waagerecht | Kein `scrollbar-gutter`: Lange Seiten waren 15 px schmaler, der zentrierte Inhalt verschob sich um 7,5 px. | +| Wortmarke fluchtet nicht mit dem Inhalt | Kopfzeile im breiten Container (90 rem), Inhalt im Standardcontainer (75 rem): bei 1440 px 32 px gegenüber 112 px Abstand vom Rand. | +| Große Bildschirme kaum genutzt | Keine randlosen Bildflächen; die Widgets waren gleichförmige Grundmuster. | +| Farben und Schriften | Bereits aus dem Kit übernommen (Iteration 2) und zentral in `tokens.css`; kein zweites Token-System. | +| Widgets | Acht Arten mit schlichter Darstellung; nur `hero`, `cards`, `image_text`, `catalog_cards` hatten Varianten. | +| Assets | Alle Originale laut Quellenmanifest „public usage not independently verified“. Keine freigegebene Logodatei. SVG-Entwürfe sind neue Vorschläge. | + +Brand-Kit-Ansichten: Der Homepage-Entwurf (`04_visuelle_entwuerfe`) zeigt weiße Kopfzeile mit Wortmarke, große Bildbühne mit Text rechts, gelbe Hauptschaltfläche, Navy-Fußbereich mit grünem Bogen. Die Web-Vorschau (`05_web_preview`) zeigt die Textmarke mit grünem Schild. Die Mobilansicht der Web-Vorschau zeigt das Bild oben und den Text darunter auf heller Fläche; so verhält sich die Markenbühne in schmalen Plätzen. Beide Entwürfe sind laut README nicht freigegeben und enthalten teils erfundene Inhalte; übernommen wurden nur Gestaltungsprinzipien, keine Texte, Preise oder Motive. + +## 3. Aus dem Brand-Kit übernommen + +| Element | Herkunft | Umsetzung | +|---|---|---| +| Markenfarben Navy, Grün, Grün dunkel, Gelb, Creme | `02_design_tokens` | unverändert in `tokens.css` (seit Iteration 2); Kontraste neu nachgerechnet | +| Schriften | Kit-Vorschlag Nunito, Lesetext Source Sans 3 | Nunito 700/800 und Source Sans 3 400/600, beim Build lokal abgelegt, keine Anfrage an Fremdserver | +| Textmarke mit grünem Schild „Stark im Alltag“ | `05_web_preview` | Wortmarken-Variante `lockup` für Kopf- und Fußbereich, gekennzeichnet `data-brand-status="vorlaeufig"` | +| Gelbe Unterstreichung | `03_svg_entwuerfe/yellow-underline.svg` | Komponente `x-brand.underline`: Markenstrich unter Einstiegs- und Abschnittsüberschriften, aktiver Navigationseintrag | +| Signalstrahlen | `03_svg_entwuerfe/yellow-rays.svg` | Komponente `x-brand.rays`: an Bild- und Tafelecken, auf Programmtafeln | +| Grüner Bogen | Homepage-Entwurf | Komponente `x-brand.arc`: Abschluss des Fußbereichs | +| Bildbühne mit Text auf einer Seite, gelbe Hauptschaltfläche, Outline-Nebenschaltfläche | Homepage-Entwurf | Hero-Variante „Markenbühne“, `.button-brand` | + +Bewusst nicht übernommen: Monogramm (kein Logo, auch nicht als Favicon), Denkblase und Hand (didaktische Symbole der Denkpause, kein Dekor), KI-Konzeptgrafiken und deren Texte, Preise und Produktnamen, eine Nachzeichnung der Filmwortmarke. + +## 4. Verwendete Originalassets + +**Keine.** Die Originalmotive sind nicht zur Veröffentlichung freigegeben. Die Referenzseite auf der Testinstanz verwendet ausschließlich selbst erzeugte, sichtbar beschriftete Platzhalter („PLATZHALTER – Originalmotiv noch nicht freigegeben“, Format und Fokus im Bild). + +Eine lokale Designvorschau mit den verkleinerten Kopien aus `05_web_preview/assets` war vorgesehen. Sie wurde nicht erstellt: Das Kopieren der Motive in den lokalen öffentlichen Medienordner wurde von der Sicherheitsprüfung der Arbeitsumgebung blockiert. Die Wirkung mit echten Motiven ist daher nicht geprüft. + +## 5. Vorläufig oder nicht freigegeben + +| Entscheidung | Status | Freigabe durch | +|---|---|---| +| Wortmarke (Textmarke mit grünem Schild) | vorläufig; keine Logodatei vorhanden | Lars: finale SVG-/PNG-Wortmarke | +| Farbwerte | vorläufig (aus Motiven abgeleitet) | Lars | +| Schriften Nunito und Source Sans 3 | vorläufig, Lizenz OFL, lokal ausgeliefert | Lars | +| Unterstreichung, Strahlen, Bogen | Kit-Entwürfe, nicht freigegeben | Lars | +| Bildmotive für Markenbühne, Bild und Text, Karten | nicht freigegeben; Nutzungsrechte offen | Lars (Rechte, Auswahl, Zuschnitte) | +| Themensignaturen der fünf Bereiche | nicht entworfen | Gestaltung und Freigabe offen | +| Breitenstufen (44/82/96 rem) und Kopfzeilenhöhen (104/72/64 px) | technische Festlegung dieser Iteration | Abnahme durch Lars | + +## 6. Änderungen am globalen Layout + +- **Konstante Kopfzeile.** Die Box ist immer gleich hoch (104 px ab 75 rem, sonst 64 px) und klebt mit negativem Abstand; die innere Leiste (72 px) klebt oben. Beim Scrollen bleibt nur die kompakte Leiste sichtbar, die Wortmarke wird per `transform` von 1,16-facher auf normale Größe verkleinert. Der Seitenfluss ändert sich nie. Unter `prefers-reduced-motion` gibt es keinen Übergang. Ohne JavaScript klebt die Kopfzeile genauso. +- **Navigation bricht nie um.** Stufen: Navigation und Kontozugang mit Beschriftung; sonst Kontozugang nur als Symbol; sonst und immer unter 75 rem Menümodus. Gemessen wird die Desktop-Darstellung an der echten Navigation, und zwar inline direkt nach der Kopfzeile (`window.lufHeaderMode`, nach dem Stylesheet, vor dem Zeichnen). Schon der erste Frame zeigt deshalb die richtige Stufe; `site-nav.js` wiederholt die Messung bei Größenänderungen und nach dem Laden der Schriften. Eine erste Fassung setzte die Stufe erst im Modul; bei 1280 bis 1920 px zeigten die ersten Frames dann kurz die überlaufende Navigation. Das ist behoben. +- **Stabile Breite.** `scrollbar-gutter: stable`; ein gemeinsames Breitenmodell (Lesebereich 44 rem, Standard 82 rem, Breit 96 rem, Vollbreite). Kopfzeile, Fußbereich und Inhalt fluchten im Standardraster. `--frame-inset` richtet Inhalte in randlosen Flächen am Raster aus, ohne `100vw`. Die Breitenschlüssel des Editors bleiben, die Bezeichnungen lauten jetzt Lesebereich, Standard, Breit, Vollbreite. +- **Menümodus.** Die Fläche beginnt unter dem sichtbaren Teil der Kopfzeile; keine untere Navigationsleiste. Behoben wurde ein schon vorher vorhandener Fehler: Vom Knopf „Schließen“ sprang der Tabulator in den Seiteninhalt. Jetzt läuft der Fokus im Kreis. +- **Fußbereich.** Navy-Fläche, Textmarke, Gruppen aus der CMS-Navigation, „Rechtliches“ in einer Grundzeile, grüner Bogen. Endet die Seite mit einer dunklen Fläche, trennt eine feine Linie sie vom Fußbereich. Keine zweite Inhaltsverwaltung, keine erfundenen Texte. +- **Widget-Vorschau im Editor.** Ohne Scrollbalken-Reserve (`scrollbar-gutter: auto`); in Chromium war ohnehin kein Rand reserviert, die Angabe sichert andere Browser ab. +- **Mitgliederbereich.** Unverändert: schlichte Wortmarke, eigene Navigation. Die Tokens bleiben gemeinsam. + +## 7. Änderungen an den Widgets + +Alle Änderungen sind additiv. Es gibt keine neue Schemaversion und keine Migration, und gespeicherte Widgets bleiben gültig. + +| Widget | Neu | +|---|---| +| Einstieg (Hero) | **Markenbühne**: Bild über die volle Breite, randlos wenn allein im Abschnitt. Der Text steht auf einer hellen Tafel (Kontrast 14:1 unabhängig vom Motiv), wahlweise links oder rechts. Schmal: Bild 4:3 mit überlappender Tafel. **Editorial**: große Überschrift, Beschreibung und Schaltflächen nebeneinander, optional ein Bildband 21:9. Für alle Varianten: zweite Schaltfläche, Bildausschnitt. Die erste Schaltfläche ist die gelbe Markenschaltfläche. Das Bild des ersten Widgets lädt sofort mit hoher Priorität, alle anderen verzögert. | +| Bild und Text | Bildformat (Quer-, Hochformat, Quadrat, Original) und Bildausschnitt; versetzte Markenfläche hinter dem Bild; ab 56 rem Bild betont (7:5); Markenstrich unter dem Titel | +| Redaktionelle Karten | Variante **erste Karte hervorgehoben**: ganze Zeile, ab 44 rem Bild neben dem Text. Raster mit großen Bildflächen; Karten ohne Bild bekommen eine gelbe Kante. Kompakte Liste mit kleinem Bild. Die ganze Karte ist über den Titellink klickbar (ein Tabstopp). | +| Programm- und Modulkarten | Markentafel statt erfundener Bilder (Navy, auf dunklen Flächen Grün dunkel). Eine einzelne Karte ist ab 40 rem breit, mit Tafel neben dem Text. Unverändert: Fachdaten zur Laufzeit, keine Kopie im CMS, Freigabelogik (ADR-29), keine öffentlichen Modulprofile. | + +Einstellungen sind nur Aufzählungswerte; freie Werte werden abgewiesen. Der Editor zeigt sie mit deutschen Bezeichnungen und dem Hinweis „Vorgabe der Darstellung“. + +**Rollback:** Ein Code-Rollback auf Iteration 2 stellt die neuen Varianten mit der Vorgabe dar; Daten gehen nicht verloren. Der Wiederherstellungsweg aus `cms-widget-registry.md` §9 bleibt für einen Rollback hinter Iteration 2 nötig. + +## 8. Design-Referenzseite + +`/designreferenz` auf der Testinstanz, über die Editoroberfläche angelegt und veröffentlicht. Die Texte stammen aus den Design-Prinzipien (Themenbereiche, Methode, Zielgruppe). Keine Produkte, Preise, Kurse oder Filmfreigaben; Bilder sind gekennzeichnete Platzhalter. + +| Abschnitt | Zeigt | +|---|---| +| 1 | Markenbühne randlos, zwei Schaltflächen, Bildausschnitt links | +| 2 | Bild und Text (breit), Trenner Markenakzent | +| 3 | Raster 1 + 3 auf heller Fläche: Überschrift und hervorgehobene Karten (fünf Themenbereiche) | +| 4 | Programmkarte aus den Fachdaten auf dunkler Fläche | +| 5 | Editorial-Einstieg, großzügiger Abstand, Trenner Linie | +| 6 | Raster 2 + 2 auf Markenakzent: Text und kompakte Karten | +| Rahmen | Markenkopfzeile, Fußbereich mit Bogen | + +## 9. Tests und Prüfungen + +| Prüfung | Ergebnis | +|---|---| +| Testsuite lokal (`php artisan test`) | 194 Tests grün, davon 9 neu (`CmsDesignIterationTest` 8, Editortest Markenbühne 1). Bewusst angepasst: zwei Erwartungen an Klassen (`brand brand-lockup`, `button button-brand`). | +| Pint | sauber | +| CI Feature-Branch | Läufe 4819, 4821, 4823, 4825, 4827, 4828 grün | +| Deploy Testinstanz | Läufe 4820, 4822, 4824, 4826, 4829 erfolgreich, `/up` 200 | +| Bestehende Seiten (12, Status, Titel, Haupttext) | vor und nach dem Deploy unverändert | +| Referenzseite über die Oberfläche (Testinstanz) | 11/11 | +| Browser-QA (Testinstanz und lokal) | 18/18 | +| Untermenü mit Maus und Tastatur (Testinstanz) | 8/8; der Prüfeintrag ist wieder entfernt | +| Geometrie über 5 Seiten bei 1920/1440/1400/1366/1280/1200/390 px (Testinstanz, Lauf 4829) | je Breite genau eine Kopfzeilenhöhe, eine Wortmarken- und eine Navigationsposition | +| Erster gezeichneter Frame bei 1280/1366/1440/1920 px, CPU vierfach gedrosselt (Testinstanz) | richtige Stufe ab dem ersten Frame, kein Überlauf, CLS 0 | +| Schmale Plätze (lokal): Markenbühne und Bild und Text in 2 + 2, Programmkarten in 1 + 3, kompakte Listen in 1 + 1 + 1 + 1 | sichtbar geprüft bei 1440 und 768 px, ohne Befund; ein Einstieg in einem Platz mit einer Einheit wird beim Speichern abgewiesen | +| Fenstergröße ändern 1280 → 1440 → 1100 → 1920 → 390 → 1440 | Moduswechsel korrekt, keine Konsolenfehler, eine Navigation im DOM | + +Die Browser-QA umfasst: +- Layoutverschiebung beim Kaltstart und Scrollen (CLS 0 bei 1440 und 390 px) +- Ausgangszustand und kompakten Zustand der Kopfzeile bei unverändertem Seitenfluss +- Reduced Motion +- Mobilmenü mit Fokusfalle und Escape +- Tabulatorreihenfolge und sichtbaren Fokus +- Ladeverhalten der Bilder (erstes eager/high, Rest lazy) +- kein horizontales Scrollen bei 390, 768, 1440 und 2560 px + +Kontraste (berechnet): Navy auf Gelb 10,3:1, Navy auf Creme 14:1, Weiß auf Grün dunkel 5,2:1, Grün dunkel auf Weiß 5,2:1, Fußbereichslinks auf Navy 11:1. Die Grundzeilen-Links erreichen auch auf dem grünen Bogen 4,8:1. + +## 10. Screenshots + +Alle von der Testinstanz mit Platzhaltern, unter `docs/analysen/designiteration-1-screenshots/`: + +1. `01-1440-kopfzeile-markenbuehne.jpg`: Ausgangszustand der Kopfzeile, Markenbühne +2. `02-1440-kopfzeile-kompakt.jpg`: kompakte Kopfzeile beim Scrollen +3. `03-1440-referenzseite-gesamt.jpg`: ganze Referenzseite, Desktop +4. `04-2560-breiter-bildschirm.jpg`: breiter Bildschirm, Bühne randlos, Tafel im Standardraster +5. `05-768-referenzseite-gesamt.jpg`: Tablet +6. `06-390-referenzseite-gesamt.jpg`: Smartphone +7. `07-390-mobilmenue.jpg`: geöffnetes Mobilmenü +8. `08-1440-kurze-seite.jpg`: kurze Seite, gleiche Kopfzeile + +## 11. Bekannte Einschränkungen + +- **Navigation der Testinstanz.** Sie hat acht teils lange Einträge. Damit zeigt die Kopfzeile den Kontozugang als Symbol und schaltet zwischen 1280 und 1366 px in den Menümodus. Mit fünf bis sechs kurzen Einträgen wie im Kit-Entwurf bleibt die Navigation bis 75 rem in der Zeile. +- **Schriften nachgeladen.** Die Stufe wird vor dem Laden der Webschriften gemessen und danach erneut geprüft. Weicht die Breite der Ersatzschrift stark ab, kann die Stufe einmal wechseln; in den Messungen trat das nicht auf. +- **Kopfzeilenverhalten nicht in der Testsuite.** Breitenstufen, Fokusfalle, kompakter Zustand und erster Frame sind nur durch Browser-Skripte geprüft (Playwright, außerhalb des Repositorys). Empfehlung: diese Skripte als Ausgangspunkt der Instanz-Suite (U0) übernehmen, mit Zugangsdaten aus der Umgebung statt aus einer Datei. +- **Keine echten Motive.** Wirkung und Zuschnitte mit echten Motiven sind nicht geprüft (siehe Abschnitt 4). +- **Keine responsiven Bildvarianten.** Es gibt noch kein `srcset`; Bilder werden in Originalgröße ausgeliefert. Feste Formate verhindern Verschiebungen, nicht aber die Ladegröße. Die Ableitungen gehören in die Hintergrundverarbeitung, weil der Webprozess keine Medien schreibt. +- **Programmkarten.** Sie zeigen nur Titel, Kurzbeschreibung und Art. Zuordnung zu Themenbereichen und Umfang stehen nicht im `CatalogEntry` und wären eine Erweiterung des Fachlesers. +- **Karten-Raster.** Bei vier Karten neben einer hervorgehobenen ergibt sich je nach Breite eine einzelne Karte in der letzten Zeile. +- **Vorschau im Editor.** Die Markenbühne ist höher als die Vorschaufläche (22 rem) und wird dort beschnitten (mit Hinweis). Die Gerätevorschau zeigt sie vollständig. +- **Build-Warnung.** `npm run build` meldet „Some chunks are larger than 500 kB“. Ob die Warnung schon vor dieser Iteration auftrat, ist nicht geprüft; diese Iteration ergänzt nur wenige Kilobyte Skript. + +## 12. Empfehlungen für die nächste Designiteration + +1. **Freigaben einholen:** Wortmarke als SVG, Farbwerte, Schriften, drei bis fünf Motive mit geklärten Rechten (Titel und Outro eignen sich für die Markenbühne, das Outro mit freier rechter Fläche besonders). Dann nur `tokens.css`, `components/site/brand.blade.php` und die Medien austauschen. +2. **Bildableitungen in der Hintergrundverarbeitung:** WebP/AVIF in 3–4 Breiten mit `srcset`/`sizes` und Fokuspunkt; Einstieg mit `preload`. +3. **Themensignaturen:** fünf Symbole und Tönungen gestalten, dann in Karten, Programmtafeln und Themenseiten einsetzen. +4. **Programmkarten erweitern:** Themenbereiche und Umfang aus dem veröffentlichten Fachstand im Leser ergänzen; Test, dass nichts Unveröffentlichtes durchsickert. +5. **Navigation redaktionell auf fünf bis sechs Hauptpunkte straffen** (Design-Prinzipien §7: Konzept, Themenbereiche, Programme, Anwendung, Angebote, Mitgliederbereich). +6. **Startseite** aus der Referenz ableiten (redaktionelle Entscheidung, keine technische). +7. Messung mit Prüfwerkzeug (axe, Lighthouse) an der gerenderten Seite vor der Farbfreigabe. + +## 13. Auf der Testinstanz angelegt + +- Seite `/designreferenz` (veröffentlicht, eine Revision). +- Platzhalterbilder im öffentlichen Medienbereich: `cms/platzhalter-markenbuehne-*`, `cms/platzhalter-bild-text-*`, `cms/platzhalter-karte-1/2/3-*` (Dateinamen mit Zufallssuffix). +- Prüfeintrag „Referenz Abschnitte (Prüfeintrag)“ in der Navigation: zweimal angelegt und jeweils wieder gelöscht. Ein Durchlauf brach ab und hinterließ den Eintrag kurzzeitig; der nächste Durchlauf hat ihn entfernt. diff --git a/docs/analysen/designiteration-1-screenshots/01-1440-kopfzeile-markenbuehne.jpg b/docs/analysen/designiteration-1-screenshots/01-1440-kopfzeile-markenbuehne.jpg new file mode 100644 index 0000000..821a874 Binary files /dev/null and b/docs/analysen/designiteration-1-screenshots/01-1440-kopfzeile-markenbuehne.jpg differ diff --git a/docs/analysen/designiteration-1-screenshots/02-1440-kopfzeile-kompakt.jpg b/docs/analysen/designiteration-1-screenshots/02-1440-kopfzeile-kompakt.jpg new file mode 100644 index 0000000..39a9da7 Binary files /dev/null and b/docs/analysen/designiteration-1-screenshots/02-1440-kopfzeile-kompakt.jpg differ diff --git a/docs/analysen/designiteration-1-screenshots/03-1440-referenzseite-gesamt.jpg b/docs/analysen/designiteration-1-screenshots/03-1440-referenzseite-gesamt.jpg new file mode 100644 index 0000000..b9279fd Binary files /dev/null and b/docs/analysen/designiteration-1-screenshots/03-1440-referenzseite-gesamt.jpg differ diff --git a/docs/analysen/designiteration-1-screenshots/04-2560-breiter-bildschirm.jpg b/docs/analysen/designiteration-1-screenshots/04-2560-breiter-bildschirm.jpg new file mode 100644 index 0000000..b36a948 Binary files /dev/null and b/docs/analysen/designiteration-1-screenshots/04-2560-breiter-bildschirm.jpg differ diff --git a/docs/analysen/designiteration-1-screenshots/05-768-referenzseite-gesamt.jpg b/docs/analysen/designiteration-1-screenshots/05-768-referenzseite-gesamt.jpg new file mode 100644 index 0000000..825e186 Binary files /dev/null and b/docs/analysen/designiteration-1-screenshots/05-768-referenzseite-gesamt.jpg differ diff --git a/docs/analysen/designiteration-1-screenshots/06-390-referenzseite-gesamt.jpg b/docs/analysen/designiteration-1-screenshots/06-390-referenzseite-gesamt.jpg new file mode 100644 index 0000000..af6b7f6 Binary files /dev/null and b/docs/analysen/designiteration-1-screenshots/06-390-referenzseite-gesamt.jpg differ diff --git a/docs/analysen/designiteration-1-screenshots/07-390-mobilmenue.jpg b/docs/analysen/designiteration-1-screenshots/07-390-mobilmenue.jpg new file mode 100644 index 0000000..45a9b7a Binary files /dev/null and b/docs/analysen/designiteration-1-screenshots/07-390-mobilmenue.jpg differ diff --git a/docs/analysen/designiteration-1-screenshots/08-1440-kurze-seite.jpg b/docs/analysen/designiteration-1-screenshots/08-1440-kurze-seite.jpg new file mode 100644 index 0000000..727cc64 Binary files /dev/null and b/docs/analysen/designiteration-1-screenshots/08-1440-kurze-seite.jpg differ diff --git a/docs/analysen/ist-soll-abgleich-mitgliederbibliothek.md b/docs/analysen/ist-soll-abgleich-mitgliederbibliothek.md new file mode 100644 index 0000000..926b404 --- /dev/null +++ b/docs/analysen/ist-soll-abgleich-mitgliederbibliothek.md @@ -0,0 +1,354 @@ +# Ist-Soll-Abgleich: Mitgliederbibliothek und Produktkonfiguration + +**Stand:** 15.11.2026, nach Review des Umsetzungsplans ergänzt +**Art:** Lesende Codeprüfung. Keine Änderung an Anwendung, Daten oder bestehenden Fachspezifikationen. +**Nachtrag:** Abschnitt „Architekturentscheidungen nach der Review“. Die Befunde A-01 bis E-02 bleiben die nachgewiesene Ist-Aufnahme. Neue Entscheidungen sind dort gekennzeichnet und ändern den Status eines Befunds nicht. +**Soll:** `docs/fachkonzept/produktkonfiguration-und-mitgliederbereich.md` (konsolidierte Fassung vom 15.11.2026), eingeordnet mit `docs/fachkonzept/abgleich-produktkonfiguration-und-mitgliederbereich.md` und `docs/fachkonzept/trainingskonzept-und-produktstruktur.md`. + +Der im Auftrag genannte Pfad `docs/architektur/abgleich-produktkonfiguration-und-mitgliederbereich.md` ist im Repository nicht vorhanden. Die inhaltlich entsprechende Datei liegt unter `docs/fachkonzept/abgleich-produktkonfiguration-und-mitgliederbereich.md`. Sie prüft Dokumente, nicht den Code, und verweist in Abschnitt 5 auf genau diese Bestandserhebung. + +Priorität dieser Prüfung: Die Mitgliederbibliothek ist MVP-Pflicht. Ein didaktischer Kursplayer mit automatischer Denkpause ist ein späteres Add-on. Ein normaler geschützter Videoplayer gehört zum MVP. + +## Nachweisgrenze + +Nachgewiesen ist, was im Quelltext, in Migrationen, Blade-Ansichten, Routen und automatisierten Tests steht. Die Testinstanz wurde nicht geöffnet. Es wurde kein Film hochgeladen, keine Datenbank abgefragt und die Testsuite nicht ausgeführt. + +Annahmen sind unten ausdrücklich als Annahme gekennzeichnet. Wo ein Laufzeitverhalten nur aus dem Quelltext folgt, gilt es als am Code nachgewiesen, nicht als auf der Testinstanz beobachtet. + +Die frühere Audit-Sichtung vom selben Tag ist durch diese Datei ersetzt, soweit die neue Soll-Fassung die Bewertung ändert. Insbesondere ist der spezialisierte Kursplayer kein Mangel des MVP mehr, sondern ein zurückzustellendes Add-on. + +## Kurzbefund + +| Bereich | Ergebnis | +|---|---| +| Stabile Identitäten, versionierte Mitgliedschaft, getrennte Lizenzobjekte | Im Modell und in der Verwaltung vorhanden und belastbar | +| Fachdimensionen an Modul und Programm, Thumbnails, Suche, Filter | Nicht vorhanden | +| Mitgliederbibliothek als fachliche Struktur | Nicht erfüllt. Sie listet Berechtigungen und nennt sie Kurse | +| Mehrfachanzeige je Programm und Deduplizierung nur in der Einzelmaterialliste | Nicht erfüllt, weil es keine Programm- und keine Identitätsliste gibt | +| Rechteprüfung je Medienaktion, unveränderliche Fassungen und Schnappschüsse | Für Stream und Ansehen vorhanden. Download ist serverseitig vorgesehen und in der Bibliothek nicht ausgelöst | +| Normaler Player gegenüber didaktischem Player | Der HTML5-Player ist da. Dieselbe Mitgliedsseite hängt zusätzlich eine Entscheidungsmarke daran | + +Die Bibliothek kann auf dem vorhandenen Kompositions- und Berechtigungsmodell neu gelesen werden. Dafür müssen weder Artikel-Stände noch Grants umgebaut werden. + +--- + +## A. Fachliches Inhaltsmodell + +### A-01 Stabile, wiederverwendbare Identitäten + +- **Anforderung:** Produktkonfiguration §2. Ein Asset und eine Komposition behalten ihre Identität. Wiederverwendung verlinkt diese Identität und eine konkrete Fassung, statt eine Mediendatei zu kopieren. +- **Ist-Zustand:** `content_elements` und `compositions` sind die Identitäten. Fassungen hängen als `content_element_versions` und `composition_versions` daran. `composition_members` verweist auf eine Inhaltsfassung oder eine verschachtelte Kompositionsfassung. `ContentService::publishElementVersion` und `publishComposition` legen neue Nummern an. `CatalogOptions::assignmentTargets` bietet vorhandene bereite Fassungen an. +- **Status:** erfüllt +- **Abweichung und Auswirkung:** Keine für die Identität. Die Mitgliederseite benutzt diese Identität nicht als Bibliotheksgegenstand, siehe C-01. +- **Empfohlene Maßnahme:** bestehende Funktion nutzen. +- **Risiko:** Ein Neubau der Tabellen würde veröffentlichte `release_contents` und Grants von ihren Fassungen lösen. Die Identitäten bleiben. + +### A-02 Programme und Module frei zusammenstellen + +- **Anforderung:** Produktkonfiguration §2 und §6. Keine Pflicht-Hierarchie Film → Übung → Modul → Programm → Paket. Ein Modul muss keinen festen Bestandteilstyp enthalten. Programme bestehen aus Modulen und weiteren Inhalten. Zyklen sind ausgeschlossen. +- **Ist-Zustand:** `CompositionKind` ist ein geschlossener Code-Enum mit `uebung`, `kurs` und `kombination`. `EditComposition` lässt jede bereite Inhalts- oder Kompositionsfassung als Baustein zu, unabhängig von der Art. `ContentService::assertAcyclic` und `ContentResolver::expand` lehnen Zyklen ab. `DemoCatalogSeeder` legt eine Kombination und eine Übung an, keinen Kurs. „Demo Programm“ ist ein `Bundle`, kein Kurs. +- **Status:** teilweise erfüllt +- **Abweichung und Auswirkung:** Verschachteln und Wiederverwenden geht in der Verwaltung. Eine neue Zusammenstellungsart oder die im Soll genannten Typen Modul und Programm sind nicht ohne Codeänderung pflegbar. Kurs und Übung sind fest beschriftete Arten, kein frei konfigurierbarer Fachtyp. Der Demo-Bestand bildet das Soll-Programm nicht ab. +- **Empfohlene Maßnahme:** Die vorhandene Komposition ergänzen. Die drei gespeicherten Arten nicht als Verkaufsstruktur und nicht still als Programm oder Modul lesen. Technische Struktur und redaktionelle Inhaltsart sind in E-T getrennt. +- **Risiko:** Vorhandene Zeilen mit `kind = uebung` oder `kombination` bleiben gültige Kompositionen. Ein stilles Umbenennen von `kurs` in „Programm“ in der Datenbank ist unnötig, solange die Anzeige den fachlichen Typ aus den Stammdaten bezieht. + +### A-03 Fachdimensionen an Medien, Modulen und Programmen + +- **Anforderung:** Produktkonfiguration §3. Dimensionen und Werte ohne Programmierung. Direkte Zuordnung an Assets, Übungen, Module und Programme. Abgeleitete Zuordnungen bleiben davon unterscheidbar. Dimensionen vergeben keine Rechte. Die fünf Säulen sind Startwerte. +- **Ist-Zustand:** Es gibt genau eine feste Dimension: `pillars`, plus `content_element_pillar` und `page_pillar` (`2026_11_15_150000_create_pillars.php`, `2026_11_15_170000_publish_pillars_to_the_site.php`). `PillarService::assign` hängt Säulen an Inhaltselemente. `Pillar::elements` und `pages` haben keine Beziehung zu `compositions`. `CatalogReading::memberPillars` leitet Säulen nur aus enthaltenen Medien ab und kennzeichnet diese Ableitung nicht als solche. Weitere Dimensionen, Altersbereich, Einsatzbereich und Schlagwörter haben keine Tabellen. `DecideAccess` liest Säulen nicht. +- **Status:** nicht erfüllt +- **Abweichung und Auswirkung:** Ein Medium kann mehreren Säulen gehören. Ein Modul oder Programm kann nicht selbst einem Thema zugeordnet werden. Abnahmekriterium B06 ist nicht erfüllbar. Filter in der Bibliothek haben keine Datenquelle. Die öffentlichen Themen unter `/themen` zeigen CMS-Seiten, keine Trainingszusammenstellungen. +- **Empfohlene Maßnahme:** ergänzen. Die vorhandenen Säulen als erste Dimension und ihre Medien-Zuordnungen übernehmen. Keine zweite, parallele Themenliste danebenstellen. +- **Risiko:** `content_element_pillar` enthält die einzigen echten Themenzuordnungen. Sie dürfen beim Einführen allgemeiner Dimensionen nicht gelöscht werden, bevor sie übernommen sind. Veröffentlichte CMS-Themen bleiben ein eigener Seitenmechanismus. + +### A-04 Rolle je Verwendung + +- **Anforderung:** Produktkonfiguration §3. Die Rolle eines Mediums ist Eigenschaft der konkreten Verwendung. Dieselbe Datei darf in zwei Modulen verschiedene Rollen haben. +- **Ist-Zustand:** `composition_members.role` ist ein Pflichttext je Baustein (`EditComposition`, Feld „Rolle“). Dieselbe `content_element_version_id` kann in mehreren Zeilen mit unterschiedlichem Rollentext stehen. `ArticleService::publishRelease` übernimmt beim Auflösen die Rolle der jeweiligen Mitgliedszeile nach `ContentResolver::expand`. Die Mitgliedsseite zeigt diese Rolle neben dem Arbeitstitel, aber nur in der flachen Liste des Artikel-Stands. +- **Status:** teilweise erfüllt +- **Abweichung und Auswirkung:** Die Redaktion kann unterschiedliche Rollen setzen. Die Bibliothek zeigt sie nicht im Zusammenhang eines Moduls oder Programms. Bei Verschachtelung bleibt im Artikel-Stand die Rolle der Blattzeile erhalten, der Pfad liegt in `release_contents.path` und wird in `member/article.blade.php` nicht angezeigt. +- **Empfohlene Maßnahme:** bestehende Mitgliedszeile nutzen. Die Anzeige am Kompositionsbaum korrigieren, nicht eine zweite Rollentabelle anlegen. +- **Risiko:** Rollen bereits gespeicherter Mitglieder bleiben gültig. Eine Normalisierung freier Texte ist eine redaktionelle Entscheidung, keine Migration, die Fassungen ändern darf. + +### A-05 Versionsarchitektur + +- **Anforderung:** Produktkonfiguration §2 und §4 Klasse B und C. Veröffentlichte Inhalts-, Kompositions- und Angebotsfassungen sowie der aufgelöste Artikel-Stand bleiben unveränderlich. Eine neue Datei, Mitgliedschaft oder Reihenfolge erzeugt eine neue Fassung. +- **Ist-Zustand:** `ContentElementVersion`, `CompositionVersion`, `CompositionMember`, `ArticleRelease`, `ReleaseContent`, `BundleVersion`, `OfferVersion`, `OfferLine`, `ResolvedScope` und `RightsProfileVersion` weisen Änderungen an bereitgestellten oder aktivierten Zeilen über `updating` zurück. `ContentService::publishComposition` schreibt Mitglieder nur in eine neue Fassung. `ArticleService::publishRelease` schreibt `release_contents` neu und löst den vorherigen Stand ab, ohne ihn zu überschreiben. `CatalogRulesTest` prüft, dass eine neue Medienfassung eine veröffentlichte Komposition nicht ändert und eine Paketänderung eine aktivierte Angebotsfassung nicht ändert. +- **Status:** erfüllt +- **Abweichung und Auswirkung:** Die Architektur bleibt fachlich korrekt. Klasse-A-Daten liegen teilweise schon außerhalb der Fassung, siehe B-01. `OfferService::activate` legt eine neue Fassung an, beendet die vorherige aktive Fassung aber nicht, siehe D-02. +- **Empfohlene Maßnahme:** bestehende Funktion nutzen. Neue Stammdaten nicht in die Fassungstabellen legen. +- **Risiko:** Jede Migration, die `body`, `metadata`, `members_hash` oder `release_contents` bestehender veröffentlichter Zeilen fortschreibt, verletzt die vorhandene Invariante. `StoreContentFile` darf eine Fassung nur im Status Entwurf fortschreiben und tut das auch. + +--- + +## B. Redaktionelle Verwaltung + +### B-01 Anzeigedaten ohne neuen Inhaltsrelease + +- **Anforderung:** Produktkonfiguration §4 und Abnahme B02, B24. Titel, Kurzbeschreibung, Suchattribute und Themen sind Klasse A: sofort wirksam, kein Asset-, Kompositions- oder Artikel-Release, mit Bearbeiter, Zeit und Änderung. Normative Lehranweisungen bleiben Klasse B. Ein geänderter Anzeigetitel schreibt Kauf und Bestellung nicht um. +- **Ist-Zustand:** `ContentService::describe` speichert `working_title` und `description` auf `content_elements`. `PillarService::assign` ändert nur die Zuordnung. Beides legt keine `content_element_versions`-Zeile an. `EditComposition` speichert `designation` und `kind`, ohne eine neue Kompositionsfassung, solange die Bausteine gleich bleiben. Es gibt keine Tabelle für Änderungsprotokoll, Kurzbeschreibung, Schlagwörter oder getrennte Lehranweisung. Der Lehrtext steht in `content_element_versions.body` und ist nach Bereitstellung gesperrt. Die Bestellseite liest `offerVersion->offer->name` live und `order_lines.price_cents` als Kopie (`resources/views/member/order.blade.php`). +- **Status:** teilweise erfüllt +- **Abweichung und Auswirkung:** Arbeitstitel, Beschreibung und Säulen eines Mediums sowie die Bezeichnung einer Komposition ändern sich ohne neue Inhaltsfassung. Es fehlt die Auditspur. Es fehlt die sichtbare Trennung von Anzeigetext und Lehranweisung. Eine Umbenennung des Angebots ändert die sichtbare Bestellbezeichnung, obwohl der Preis stehen bleibt. Kompositionen haben keine Beschreibung. +- **Empfohlene Maßnahme:** ergänzen, auf den vorhandenen Identitätstabellen. Lehrtext und Datei in der Fassung lassen. +- **Risiko:** Ein Protokoll darf keine alte Fassung nachträglich beschreiben. Die Bestellbezeichnung braucht eine eigene Kopie, sonst erfüllt B24 nur den Preis, nicht den Namen. Bestehende `description`-Texte sind nicht danach getrennt, ob sie Anzeige oder Lehrinhalt sind. Das ist eine redaktionelle Sichtung, keine automatische Umschreibung. + +### B-02 Thumbnails für alle darstellbaren Typen + +- **Anforderung:** Produktkonfiguration §5. Eigenes Vorschaubild für Asset, Übung, Modul, Programm und bei Bedarf Lizenzartikel. Fallback, Alternativtext, optimierte Größen. Änderung ohne neue Filmfassung. Öffentliche und geschützte Verwendung sind getrennt. +- **Ist-Zustand:** Im Anwendungscode, in den Views und in den Migrationen gibt es kein Vorschaubild, kein Poster und keinen Alternativtext für Inhalte. Suche nach `thumbnail`, `poster` und `vorschaubild` bleibt ohne Treffer. +- **Status:** nicht erfüllt +- **Abweichung und Auswirkung:** Karten können das Soll nicht erfüllen. Ein fehlendes Bild kann heute nicht auf eine definierte Fallback-Grafik ausweichen, weil es keine Karten dieses Typs gibt. +- **Empfohlene Maßnahme:** ergänzen, als Klasse-A-Ableitung an der Identität, nicht als neue Inhaltsfassung. +- **Risiko:** Thumbnail-Dateien gehören nach `derived/` oder einer eigenen Ableitung, nicht nach `originals/` als Ersatz des Films. Ein extrahierter Frame darf nicht in `media_public` gelangen, siehe B-03. + +### B-03 Frame eines Videos als Thumbnail + +- **Anforderung:** Produktkonfiguration §5 und Abnahme B03, B04. Zeitpunkt in der konkreten Filmfassung wählen, Frame übernehmen, Film und Prüfsumme unverändert. Keine automatische öffentliche Marketingfreigabe. +- **Ist-Zustand:** Kein ffmpeg, keine Frame-Extraktion, keine Zeitposition für Bilder. `decision_seconds` in den Fassungsmetadaten ist eine didaktische Marke und wird beim Ändern als neue Inhaltsfassung behandelt (`ElementRevision`). `StoreContentFile` kopiert die hochgeladene Datei unverändert nach `media_derived`. +- **Status:** nicht erfüllt +- **Abweichung und Auswirkung:** B03 und B04 sind nicht ausführbar. Die vorhandene Marke darf nicht zweckentfremdet als Thumbnail-Zeitpunkt dienen, weil ihre Änderung eine neue Lehrfassung erzwingt. +- **Empfohlene Maßnahme:** ergänzen, mit eigener Bildableitung und eigener Sichtbarkeit. Den Film dabei nicht anfassen. +- **Risiko:** Die einzige Filmkopie liegt heute unter `derived/`, nicht unter `originals/`. Eine Extraktion kann diese Kopie lesen. Sie darf die Datei und `content_hash` nicht neu schreiben. Ob große Dateien bei der Extraktion an `memory_limit = 512M` scheitern, ist nicht ausgeführt worden. Das ist eine Annahme über das Betriebsverhalten, kein beobachteter Fehler. + +### B-04 Kompositionseditor verwendet vorhandene Inhalte wieder + +- **Anforderung:** Produktkonfiguration §12 Schritte 3 und 4. Vorhandene Assets und Unterkompositionen suchen, referenzieren, Rolle und Reihenfolge setzen. +- **Ist-Zustand:** `ListCompositionKind` legt eine leere Komposition an. `EditComposition` füllt ein Wiederholfeld aus der letzten bereiten Fassung. `CatalogOptions::assignmentTargets` listet bereite Medien- und Kompositionsfassungen und lässt nur die gerade bearbeitete Komposition aus. Speichern ruft `ContentService::publishComposition` auf, wenn Rolle oder Ziel sich ändern. `MediaAdministrationTest` tauscht einen Baustein über die Übungsseite. `CatalogRulesTest::test_c_one_element_version_can_be_reused` zeigt dieselbe Fassung in zwei Kompositionen auf Dienstebene. +- **Status:** erfüllt +- **Abweichung und Auswirkung:** Die Wiederverwendung funktioniert in der Verwaltung. Es gibt keinen Test, der denselben Film über die Oberfläche in zwei Übungen mit unterschiedlichen Rollen einbaut. Die Auswahl ist eine lange Liste bereiter Fassungen, keine Suche nach der stabilen Identität mit anschließender Fassungswahl. +- **Empfohlene Maßnahme:** bestehende Funktion nutzen. Die Auswahl später auf Identität und Suche erweitern, ohne die Mitgliedszeile zu ersetzen. +- **Risiko:** Gering, solange weiter konkrete Fassungs-IDs gespeichert werden. Ein Speichern nur der Identität würde die Versionsinvariante aufgeben. + +### B-05 Verwendung in Modulen und Programmen nachvollziehen + +- **Anforderung:** Produktkonfiguration §6 und §12. „Verwendet in“ zeigt Module und Programme. Die Bearbeitungsmaske macht Verwendung und Versionen auffindbar. +- **Ist-Zustand:** `CatalogReading::elementUsage` wird in `ViewContentElement` angezeigt und nennt Kompositionen mit Art, Bezeichnung, Fassungsnummer und Rolle sowie Lizenzartikel. `CatalogReading::compositionUsage` ermittelt Elternkompositionen und Artikel, wird von keiner Seite aufgerufen. Die Übungs- und Kursmaske zeigt die eigenen Bausteine und abgeleitete Säulen, nicht die Verwendung dieser Übung in anderen Kursen. +- **Status:** teilweise erfüllt +- **Abweichung und Auswirkung:** Für ein Medium ist die Rückwärtsverwendung in der Verwaltung sichtbar. Für eine Übung oder einen Kurs ist dieselbe Auskunft im Code vorhanden und in der Maske nicht erreichbar. Die Mitgliederansicht hat kein „Verwendet in“. +- **Empfohlene Maßnahme:** die vorhandene Methode `compositionUsage` in der Bearbeitungsmaske anzeigen. Für Mitglieder erst mit der Bibliothek ausgeben. +- **Risiko:** Keine Datenänderung. Die Methode liest nur. + +--- + +## C. Mitgliederbibliothek + +Routen unter `bereich`, alle hinter `auth` und `verified`: `/bibliothek`, `/bibliothek/{article}`, `/materialien`, `/berechtigungen`, `/ausgabe/{article}/{release}/{version}/{action}`. Controller: `LibraryController`. + +### C-01 Fachliche Darstellung von Programmen, Modulen, Filmen, Übungen und Materialien + +- **Anforderung:** Produktkonfiguration §1, §8 und §9. Programme, Module, Übungen, Filme und Materialien sind unterscheidbar. Ein PDF wird nicht wegen seiner Lizenzierbarkeit zum Kurs. Die Bibliothek richtet sich an Trainer. Administrative Lizenzstruktur ersetzt den pädagogischen Inhalt nicht. +- **Ist-Zustand:** `resources/views/member/library.blade.php` setzt Titel und Überschrift auf „Kurse“ und listet jede aktive Berechtigung. `CourseOutline::title` nimmt die Bezeichnung der Wurzelkomposition, sonst den Arbeitstitel, sonst die Kennung. `kindLabel` ist nur gesetzt, wenn die Wurzel eine Komposition ist. `DemoCatalogSeeder` veröffentlicht `demo-merkblatt` als Artikel auf einer PDF-Fassung ohne Komposition. Diese Berechtigung erscheint in derselben Kursliste. `member/article.blade.php` sagt im leeren Zustand „Dieser Kurs hat noch keinen veröffentlichten Stand“ und zeigt unten `Artikel {{ $article->code }}`. `member/materials.blade.php` heißt „Filme und Materialien“ und lässt nur Artikel mit Ausgabeklasse `film` oder `audio` zu. `CoursePlayerTest` erwartet die Überschrift „Kurse“ für eine Übung namens „Alltag üben“. +- **Status:** nicht erfüllt +- **Abweichung und Auswirkung:** Ein Merkblatt, eine Übung und ein späterer Kurs sind nicht als Typen getrennt. Der Trainer sieht Lizenzartikel. Abnahme B01 scheitert an dieser Darstellung, auch wenn die Anlage des Films in der Verwaltung gelingt. +- **Empfohlene Maßnahme:** ersetzen. Die Seite neu aus Programmen, Modulen und Materialien aufbauen. `DecideAccess` und die Artikel-Stände bleiben die Freigabe, nicht die Gliederung. +- **Risiko:** Vorhandene Grants bleiben die Rechtequelle. Eine neue Gliederung darf keinen Grant anlegen, nur weil eine Komposition einen Film enthält. Der Test `CoursePlayerTest` schreibt die falsche Überschrift fest und muss bei der Umsetzung geändert werden, nicht die Oberfläche an den Test angepasst werden. + +### C-02 Suche und kombinierbare Filter + +- **Anforderung:** Produktkonfiguration §8. Suche über Titel, Kurzbeschreibung, Schlagwörter und Suchattribute. Filter nach Typ, Säule, Alter, Einsatzbereich, weiteren Dimensionen und Verfügbarkeit. Mehrere Werte einer Dimension mit ODER, verschiedene Dimensionen mit UND. Leere Ergebnisse, Fehler, mobiles Filter und Zurücksetzen. +- **Ist-Zustand:** `LibraryController` nimmt keinen Suchbegriff und keinen Filter entgegen. Die Mitgliedsviews enthalten kein Suchfeld. `searchable()` kommt nur in Filament-Tabellen vor. Es gibt keine Schlagwort- oder Altersdaten, siehe A-03. +- **Status:** nicht erfüllt +- **Abweichung und Auswirkung:** Die Bibliothek ist nicht durchsuchbar. B05, B06 und B22 sind für Suche und Filter nicht erfüllbar. Filament-Suche ist keine Mitgliedersuche. +- **Empfohlene Maßnahme:** ergänzen, nachdem Typen und Dimensionen eine Datenquelle haben. Vorher eine Suche nur über Arbeitstitel bauen würde die Soll-Filter nicht tragen. +- **Risiko:** Ein eigener Suchindex darf Klasse-A-Änderungen sofort übernehmen und keine Rechte vergeben. Ob die spätere Suche PostgreSQL oder einen externen Index nutzt, ist nicht entschieden und hier nicht festgelegt. + +### C-03 Vollständige Modul- und Programmstruktur + +- **Anforderung:** Produktkonfiguration §9 und §10, Abnahme B07. Kopf, Überblick, geordnete Bestandteile mit Rolle und Fachtyp, Untergruppen. Verschachtelung fällt nicht zu einer Dateiliste zusammen. +- **Ist-Zustand:** `LibraryController::show` lädt `article.currentRelease.contents` und gibt eine flache Liste aus. `ContentResolver::expand` löst verschachtelte Kompositionen in Blattfassungen auf. `ArticleService` speichert dabei `path`, die View verwendet `role` und den Arbeitstitel. Lernziele, Zeit- und Materialbedarf haben keine Spalten. Eine Komposition ohne Lizenzartikel hat keine Mitgliedsroute. +- **Status:** nicht erfüllt +- **Abweichung und Auswirkung:** Ein Kurs aus einer Übung aus Film und Merkblatt wird eine Liste von Dateien. Reihenfolge der Blätter bleibt erhalten, die Zwischenstufen nicht. Der Trainer kann die Trainingseinheit daran nicht verstehen. +- **Empfohlene Maßnahme:** ersetzen, durch einen Leser, der die veröffentlichte Kompositionsfassung als Baum anzeigt und je Blatt `DecideAccess` fragt. `release_contents` bleibt die Prüfung, ob die Fassung zum Artikel-Stand gehört. +- **Risiko:** Der Baum muss die in `composition_members` fixierten Fassungen zeigen, nicht still die jeweils neueste Fassung der Identität. Sonst vermischen sich historische Stände, entgegen B13. + +### C-04 Mehrfachanzeige innerhalb jedes Programms + +- **Anforderung:** Produktkonfiguration §6 und §10, Abnahme B09 und B10. Ein gemeinsam genutzter Film, ein PDF oder ein Modul erscheint in jedem Programm an seiner dortigen Position. Die Anzeige in einem Programm entfällt nicht, weil der Inhalt woanders schon vorkommt. +- **Ist-Zustand:** Es gibt keine Programmansicht. Zwei Artikel, die dieselbe Fassung enthalten, erscheinen als zwei Berechtigungen. Öffnet man beide Artikel, sieht man die Fassung in jedem Artikel erneut. Das folgt aus je eigenem `release_contents`-Satz, nicht aus einer Programmregel. Ein Modul, das in zwei Programmen liegt, wird nicht als Modul in beiden Programmen gezeigt. +- **Status:** nicht erfüllt +- **Abweichung und Auswirkung:** Die neue Mehrfachregel ist nicht umgesetzt. Die ältere Formulierung im Trainingskonzept, gemeinsame Inhalte müssten in der Bibliothek nicht mehrfach erscheinen, ist durch die Produktkonfiguration §6 für den Programmkontext ersetzt. Der Code erfüllt keine der beiden Lesarten als Programmregel. +- **Empfohlene Maßnahme:** im neuen Programmdetail jede Mitgliedszeile anzeigen, auch wenn die Identität woanders vorkommt. +- **Risiko:** Mehrfachanzeige darf keine zweite Berechtigung und keinen zweiten Kauf erzeugen. Die Auslieferung bleibt an der einen Identität und der einen Fassung hängen. + +### C-05 Deduplizierung nur in programmübergreifenden Einzelinhaltslisten + +- **Anforderung:** Produktkonfiguration §6 und §8, Abnahme B11 und B12. In der übergreifenden Materialliste eine Karte je stabiler Identität, mit Verweisen auf die Programme. Gleiche Titel verschiedener Identitäten bleiben getrennt. Verschiedene Fassungen derselben Identität werden nicht verschwiegen. +- **Ist-Zustand:** `materials` filtert Grants und verlinkt wieder den Artikel. Es gibt keine Gruppierung nach `content_element_id`. Zwei Artikel mit demselben Film ergeben zwei Listeneinträge. Zwei verschiedene Medien mit gleichem Arbeitstitel wären ebenfalls zwei Einträge, aber nicht wegen einer Identitätsregel, sondern weil es zwei Artikel sind. +- **Status:** nicht erfüllt +- **Abweichung und Auswirkung:** B11 ist nicht erfüllbar. Eine Deduplizierung nach Titel wäre zusätzlich falsch und ist nicht eingebaut. B12 ist damit nicht durch eine vorhandene Deduplizierung gefährdet, aber auch nicht durch eine korrekte Identitätsliste erfüllt. +- **Empfohlene Maßnahme:** ergänzen, als eigene Materialsicht auf Identitäten, gespeist aus den berechtigten Vorkommen. +- **Risiko:** Deduplizierung nach Dateipfad oder Titel würde verschiedene Identitäten oder Fassungen zusammenziehen. Schlüssel ist die Identität, die Fassung bleibt am Vorkommen sichtbar. + +### C-06 Teilweise verfügbare Programme + +- **Anforderung:** Produktkonfiguration §8 und §10, Abnahme B14 und B15. Vollständig nutzbar, teilweise nutzbar, nicht nutzbar und gesperrt sind unterscheidbar. Ein Programm kann vollständig nutzbar sein, ohne als Programm gekauft worden zu sein. Gesperrte Dateien bleiben im Zusammenhang sichtbar und werden nicht ausgeliefert. +- **Ist-Zustand:** Die Bibliothek kennt nur aktive Grants. In der Artikelliste setzt `show` je Blatt `allowed` und zeigt sonst „Für diesen Teil liegt keine Freigabe vor.“ Ein gesperrter Stand oder eine gesperrte Fassung scheitert in `DecideAccess`. Es gibt keinen Programmstatus und keine Ansicht, die getrennte Artikel zu einem Programm zusammenzieht. +- **Status:** nicht erfüllt +- **Abweichung und Auswirkung:** B14 und B15 sind nicht darstellbar. Der Satz auf der Artikelseite ist ein brauchbares Verhalten für ein einzelnes Blatt, aber kein Programmstatus. +- **Empfohlene Maßnahme:** ergänzen, als Ableitung aus den vorhandenen Grants je Blatt. Keinen Grant für das Programm erzeugen, nur weil alle Teile anderweitig lizenziert sind. +- **Risiko:** Ein abgeleiteter Status „vollständig nutzbar“ darf nicht als Kauferwerb in `acquisitions` erscheinen. Sonst wird B15 zu einem fingierten Programmkauf. + +### C-07 Medienanzeige, Streaming und Download + +- **Anforderung:** Produktkonfiguration §11, Abnahme B16 und B21. Berechtigtes Streaming im normalen Player. Ansehen und Laden sind getrennte Dokumentaktionen. Vor jeder Auslieferung: Artikel, Stand, Fassung, Aktion, genau eine tragende Berechtigung. Signierte URLs ersetzen die Entscheidung nicht. +- **Ist-Zustand:** `LibraryController::show` verlangt für Film und Audio `streamen`, sonst `ansehen`. Die Aktion `laden` wird in der Bibliothek nie gesetzt. `media` akzeptiert `ansehen`, `streamen` und `laden`, prüft die Leser-ID und ruft `DecideAccess` erneut auf. Die Antwort ist `Storage::disk('media_derived')->response` mit `inline` oder, nur bei `laden`, `attachment`. Das Video-Element hat `controls`, `preload="metadata"` und `playsinline`. Es gibt kein `` für Untertitel. `CoursePlayerTest` prüft die Seite, nicht den Dateiabruf. +- **Status:** teilweise erfüllt +- **Abweichung und Auswirkung:** Stream und Ansehen werden serverseitig entschieden, wenn die Rechte die Aktion enthalten. Ein PDF mit nur `laden` bleibt in der Oberfläche gesperrt, obwohl der Endpunkt Laden könnte. B16 ist im Code angelegt und nicht mit einer echten Datei nachgewiesen. B21 ist in der Oberfläche nicht erfüllt. Adaptive Auslieferung ist nicht vorhanden; die Soll-Spannung dazu steht in E-02. +- **Empfohlene Maßnahme:** korrigieren. Getrennte Aktionen anbieten, beide über denselben Endpunkt. Den normalen Player behalten. +- **Risiko:** Die Signatur darf weiterhin nur der Transport sein. Ein neuer Download-Knopf ohne erneutes `DecideAccess` würde die vorhandene Prüfung umgehen. Kennzeichnung und Ausgabenachweis sind nicht implementiert. Ob sie für das Bibliotheks-MVP noch denselben Rang haben wie im Architektur-Schnitt 16, ist in der neuen Prioritätenliste nicht als zurückgestellt markiert. Das ist eine offene Einordnung, keine Codeaussage. Siehe E-02. + +--- + +## D. Produkt- und Lizenzmodell + +### D-01 Trennung von Medien, Kompositionen, Lizenzartikeln und Angeboten + +- **Anforderung:** Produktkonfiguration §2 und §7. Die Artikelgrenze setzt der Betreiber. Ein Programm kann ein Artikel oder ein Paket aus Modul-Artikeln sein. Der Preis gehört zur Angebotsfassung. +- **Ist-Zustand:** Getrennte Tabellen und Dienste: `ContentElement`, `Composition`, `LicenseArticle`, `Bundle`, `Offer`, `Grant`. Filament-Gruppen „Inhalte“ und „Katalog“. `ArticleService::publishRelease` bindet eine konkrete Wurzel. `BundleService` und `OfferService::scopeFor` lösen Pakete in Artikel auf. `GrantIssuer` legt je aufgelöstem Artikel einen Grant mit eigenem Schnappschuss an. +- **Status:** erfüllt +- **Abweichung und Auswirkung:** Die Trennung im Modell ist korrekt. Darstellung und Demodaten ziehen sie wieder zusammen: das Paket heißt „Demo Programm“, die Bibliothek heißt „Kurse“. Eine Abdeckungsprüfung, ob die beworbenen Kompositionen durch die Artikel tatsächlich lizenziert sind, gibt es in `OfferService::activate` nicht. +- **Empfohlene Maßnahme:** das Modell nutzen. Die fehlende Abdeckungsprüfung ergänzen. Die Bibliothek nicht aus Paketnamen gliedern. +- **Risiko:** Eine Abdeckungsprüfung darf eine bereits aktivierte Fassung nicht nachträglich verengen. Sie gilt für die nächste Angebotsfassung. + +### D-02 Konfigurierbare bepreiste Angebotsfassungen + +- **Anforderung:** Produktkonfiguration §7, Abnahme B20. Preise, Rechteprofile und Laufzeiten je Angebotsfassung. Eine Änderung erzeugt eine neue Fassung. Frühere Erwerbe bleiben historisch korrekt. +- **Ist-Zustand:** `ViewOffer` aktiviert eine Fassung mit Vergabeart, Preis in Cent und Positionen aus Artikel oder Paketfassung plus Rechteprofil. `OfferService::activate` legt die nächste Nummer an, schreibt `resolved_scopes` und sperrt verwendete Rechtefassungen über `locked_at`. `OfferVersion::updating` verbietet Änderungen an einer aktiven oder beendeten Fassung. `Checkout::place` kopiert Preis, Laufzeit und Recht in `order_lines` und `order_scope_items`. Die vorherige Fassung mit Status `aktiv` wird nicht beendet. `Checkout` und `GrantIssuer::activeVersion` nehmen die höchste aktive Nummer. `GrantIssuer::grantRegistrationOffers` liest alle aktiven Fassungen mit Vergabe „bei Registrierung“, ohne Sortierung je Angebot. +- **Status:** teilweise erfüllt +- **Abweichung und Auswirkung:** Neue Fassungen und Preise sind pflegbar und danach unveränderlich. Mehrere Fassungen desselben Angebots können gleichzeitig `aktiv` bleiben. Neue Käufe und der Abruf nutzen die höchste Nummer. Die Registrierungsvergabe kann bei zwei aktiven Fassungen desselben Angebots an der ersten bereits angelegten Erwerbszeile stehen bleiben, weil `issue` einen vorhandenen Erwerb unverändert zurückgibt. Ob solche Doppel-Aktivierungen in einer laufenden Datenbank existieren, ist nicht geprüft. +- **Empfohlene Maßnahme:** korrigieren, und zwar vor der Bibliothek. Die Bestandserhebung und die enge Ausnahme am Unveränderlichkeitshaken stehen in der Architekturentscheidung E-L. +- **Risiko:** `OfferVersion::updating` weist heute jede Änderung einer aktiven Fassung ab, auch einen reinen Statuswechsel nach `beendet`. Ein ungeprüftes Umschreiben von Preis oder Umfang bleibt verboten. Ob auf Test oder Produktion bereits mehrere aktive Fassungen desselben Angebots liegen, ist nicht nachgewiesen. Eine Bereinigung setzt die lesende Bestandsaufnahme voraus. + +### D-03 Unveränderliche Vertrags- und Berechtigungsdaten + +- **Anforderung:** Produktkonfiguration §4 Klasse C und §7. Kaufumfang, Bedingungen und Berechtigung bleiben an der Erwerbsquelle fixiert. Anzeigedaten dürfen sich ändern, ohne diese Kopien umzuschreiben. +- **Ist-Zustand:** `grants.rights_snapshot`, `release_at_grant_id`, `order_lines.price_cents` und `order_scope_items.rights_snapshot` werden beim Erwerb geschrieben. `DecideAccess` liest den Schnappschuss, nicht das live bearbeitbare Rechteprofil. Die sichtbare Bestellzeile nutzt dennoch den aktuellen `offers.name`. Didaktische Titel liegen auf der Identität und sind absichtlich nicht in der Bestellung kopiert. +- **Status:** teilweise erfüllt +- **Abweichung und Auswirkung:** Preis, Recht und Artikel des Kaufs bleiben stehen. Die sichtbare Angebotsbezeichnung nicht. Ein späterer Leser der Bestellung sieht den heutigen Namen. +- **Empfohlene Maßnahme:** ergänzen, eine Bezeichnungskopie an der Bestellzeile. Vorhandene Schnappschüsse nicht migrieren, außer um die damals gültige Bezeichnung einmalig zu sichern, und nur nach gesonderter Freigabe. +- **Risiko:** Ein nachträgliches Füllen alter Bestellnamen aus dem heutigen `offers.name` würde die Historie verfälschen, wenn das Angebot schon umbenannt wurde. Ob das in den Daten vorkommt, ist nicht nachgewiesen. + +### D-04 Rechteprüfung bei jeder tatsächlichen Medienaktion + +- **Anforderung:** Produktkonfiguration §11. Prüfung von Artikel, veröffentlichtem Stand, enthaltener Fassung und Aktion. Genau eine tragende Berechtigung. Themen, Thumbnails und Kompositionszugehörigkeit vergeben keine Rechte. +- **Ist-Zustand:** `DecideAccess` prüft Konto, Artikel des Stands, Freigabestatus, Vorkommen in `release_contents`, Sperre der Fassung, Gültigkeit und ob der Schnappschuss die Aktion für die Ausgabeklasse enthält. Bei mehreren passenden Grants wird eine ausgewählt, die Fähigkeiten werden nicht vereinigt. `LibraryController::media` ruft dieselbe Prüfung nach der Signatur erneut auf. Säulen und die nicht vorhandenen Thumbnails kommen in der Entscheidung nicht vor. Die Vorschau `content.preview` ist an `auth:staff` gebunden, nicht an einen Grant. +- **Status:** erfüllt +- **Abweichung und Auswirkung:** Die Prüfung tut das Verlangte für die Aktionen, die sie erreicht. Die Bibliothek ruft Laden nicht auf, siehe C-07. Ein Test, der eine echte Datei nur mit `streamen` holt und `laden` abweist, fehlt. +- **Empfohlene Maßnahme:** bestehende Funktion nutzen und für Laden denselben Weg erzwingen. +- **Risiko:** Eine Bibliothek, die Dateien bereits beim Rendern der Seite ohne diese Prüfung ausliefert, würde die Invariante aufgeben. Signierte Links müssen kurz bleiben und die Aktion enthalten. + +### D-05 Keine Vermischung zu einem stärkeren Nutzungsrecht + +- **Anforderung:** Produktkonfiguration §7, Abnahme B17. Kommerzielles Streaming und ehrenamtlicher Download ergeben keinen kommerziellen Download. Quellen bleiben getrennt. Die Bibliothek darf sie verständlich zusammenfassen. +- **Ist-Zustand:** `DecideAccess` filtert Grants einzeln. Ein Grant muss Zweck nicht mit einem anderen Grant kombinieren, weil der Zweck im Schnappschuss liegt und die Aktion nur gegen diesen einen Schnappschuss geprüft wird. Die Bibliothek fasst Grants nicht zusammen. Sie zeigt sie unter Berechtigungen als Artikelschlüssel, Zweck und Datum. Ein Test, der zwei Grants mit verschiedenen Zwecken gegeneinander stellt, ist nicht vorhanden. `CatalogRulesTest` legt einzelne Grants an. +- **Status:** erfüllt +- **Abweichung und Auswirkung:** Die Entscheidung vermischt Rechte nicht. Die fehlende Zusammenfassung ist eine Darstellungslücke, kein zu starkes Recht. B17 ist am Code nachvollziehbar und nicht durch einen Negativtest festgehalten. +- **Empfohlene Maßnahme:** die Entscheidung unverändert lassen. Einen Negativtest ergänzen. Eine spätere Zusammenfassung darf nur anzeigen, nicht die Schnappschüsse mergen. +- **Risiko:** Hoch, wenn eine „wirksame Rechte“-Menge als Vereinigung aller Grants gebaut wird. Das wäre ein neues, nicht erworbenes Recht. + +--- + +## E. MVP-Abgrenzung des Players + +### E-01 Normaler Player und didaktisches Add-on + +- **Anforderung:** Produktkonfiguration §1, §11 und §14 sowie Architekturabgleich A06. Play, Pause, Zeitsuche, Vollbild und Lautstärke sind MVP. Automatische Denkpause, Ablaufsteuerung, Präsentationsmodus, Fortschritt und zweites Gerät sind Add-on. Felder für spätere Zeitmarken dürfen bleiben. +- **Ist-Zustand:** `resources/views/content/player.blade.php` und das Video auf der Mitgliedsseite nutzen das Browser-Element mit `controls`. Das liefert die üblichen Bedienfunktionen des Browsers. `resources/js/app.js` reagiert auf `data-course-decision` und `data-course-restart`: Sprung zur Marke und Pause, sowie Neustart. Es gibt kein `timeupdate`, also keine automatische Pause beim Erreichen der Marke. Kein Präsentationsmodus, kein Fortschritt, kein zweites Gerät. `decision_seconds` liegt in den Fassungsmetadaten und erzwingt beim Ändern eine neue Inhaltsfassung. `LibraryController` und `member/article.blade.php` reichen die Marke an den Player. Die Verwaltungsvorschau zeigt die Marke nicht als Knopf. `CoursePlayerTest` verlangt den Knopftext „Zur Entscheidungsmarke“. +- **Status:** widersprüchlich +- **Abweichung und Auswirkung:** Der normale Player ist vorhanden und an dieselbe Seite gebunden wie ein früher didaktischer Knopf. Der Knopf ist kein automatischer Kursplayer, blockiert die Trennung aber, weil Test und Mitgliedsansicht ihn zum erwarteten Verhalten machen. Die Marke als Datenfeld ist mit dem Add-on vereinbar. Ihre Kopplung an einen neuen Inhaltsrelease ist Klasse B und darf bleiben, solange sie Lehrinhalt ist und kein Thumbnail. +- **Empfohlene Maßnahme:** korrigieren, klein und abgegrenzt. In der Bibliothek den Browser-Player ohne Entscheidungsmarke ausliefern. Den Knopf und den Test aus dem MVP-Pfad nehmen. Das Metadatenfeld nicht löschen. +- **Risiko:** Gering für Daten. Ein Entfernen von `decision_seconds` aus vorhandenen Fassungen wäre eine verbotene Änderung bereitgestellter Versionen. Die Abhängigkeit ist auf drei Stellen begrenzt: `LibraryController`, `member/article.blade.php`, `resources/js/app.js`, plus der Test. Es gibt keine Player-Bibliothek, keinen Fortschrittsspeicher und keine zweite Route, die eine Trennung erschweren würde. + +### E-02 Soll-Spannung bei Streaming, Kennzeichnung und Nachweis + +- **Anforderung:** Produktkonfiguration §1 nennt einfaches geschütztes Videostreaming als P0. §11 verlangt zusätzlich „adaptive und geschützte Medienausgabe gemäß bestehendem Medienkonzept“ sowie Kennzeichnung und Ausgabenachweis, soweit das bestehende Modell das verlangt. Der Architekturabgleich A06 stellt nur den didaktischen Player zurück, nicht ausdrücklich das adaptive Streaming. +- **Ist-Zustand:** Die Auslieferung ist eine signierte Dateiantwort aus `media_derived`, kein HLS und keine Varianten. `docs/betrieb/MVP-Stand.md` sagt, adaptives Streaming, persönliche PDF-Kennzeichnung und Ausgabenachweis seien noch nicht der Zielschnitt. Originaldateien unter `/srv/luf/test/media/originals` und `/srv/luf/prod/media/originals` werden von PHP nicht geschrieben. +- **Status:** widersprüchlich +- **Abweichung und Auswirkung:** Gegen die neue P0-Zeile fehlt ein einfacher geschützter Player nur noch in der fachlich richtigen Bibliothek, nicht ein kompletter Streaming-Stapel. Gegen §11 und den Architektur-Schnitt 16 fehlen Adaptivität, Kennzeichnung und Nachweis. Der Ist-Stand bleibt widersprüchlich. Die Einordnung in zwei Stufen ist die Entscheidung E-M, kein neuer Codebefund. +- **Empfohlene Maßnahme:** nicht streichen. Die Architekturentscheidung E-M trennt eine intern testbare Bibliothek von der kommerziell freigabefähigen Medienausgabe und nimmt adaptives Streaming, Kennzeichnung und Ausgabenachweis als eigenes Paket auf. +- **Risiko:** Ein Umbau der Dateiablage, der vorhandene `derived`-Pfade in Artikel-Ständen ungültig macht, würde bereits hochgeladene Fassungen unlesbar machen. Ob auf der Testinstanz solche Dateien liegen, ist nicht geprüft. + +--- + +## Was nicht nachgewiesen ist + +- Ob auf Test oder Produktion bereits Filme, Artikel oder mehrere aktive Angebotsfassungen liegen. +- Ob ein Upload von 2 GB bei `memory_limit = 512M` in PHP tatsächlich scheitert. Die Grenzen stehen in `docker/php.ini` und `docker/nginx/default.conf`. Ein Lauf fehlt. +- Ob die Queue auf der Testinstanz Dateien nach `derived/` übernimmt. +- Bedienbarkeit auf Smartphone, Tablet und Desktop. Es gibt keine responsive Prüfung und keine PWA-Prüfung in dieser Sichtung. +- Ob `compositionUsage` in einer alten Oberfläche sichtbar war. Im aktuellen Code gibt es keinen Aufruf. + +## Folgerung für die Umsetzung + +Erhalten bleiben Identität, Fassung, Mitgliedschaft, Artikel-Stand, Angebotsfassung, Grant und `DecideAccess`. + +Ersetzt werden die Mitgliedsansichten, die Berechtigungen als Kurse und Dateien als flache Liste zeigen. + +Die Review vom 15.11.2026 ändert die Reihenfolge und schließt die vorher offenen Punkte zu Typ, Angebotsfassung, Medienabgrenzung und Frontend-Umfang. Das steht in den folgenden Entscheidungen. Der priorisierte Plan steht in `docs/analysen/umsetzungsplan-mitgliederbibliothek.md`. + +## Architekturentscheidungen nach der Review + +Diese Entscheidungen sind neu. Sie sind keine zusätzlichen Codebefunde. Ist-Zustand und Status der Abschnitte A bis E bleiben bestehen. + +### E-A Auflösung von Programm und Berechtigung + +**Entscheidung.** Die Mitgliederbibliothek liest die Struktur aus redaktionell zur Anzeige freigegebenen Kompositionsfassungen. Kommerziell veröffentlicht ist daran nicht beteiligt. Ein Paket, ein Angebot oder ein Grant ist kein Elternknoten. + +Technische Bereitschaft und Anzeigefreigabe sind zwei Schritte. Status `bereit` bedeutet nur, dass die Fassung vollständig und nicht gesperrt ist. Sie erscheint deshalb noch nicht in der Bibliothek. Die redaktionelle Freigabe zur Anzeige bezieht sich auf genau diese Fassung, ändert ihre Mitglieder nicht und legt keinen Lizenzartikel an. Eine neuere bereite Fassung ohne eigene Freigabe ersetzt eine freigegebene Fassung nicht. + +Gezeigt wird genau die freigegebene Fassung, mit den in `composition_members` gespeicherten Kindesfassungen und Rollen. Mitglieder aus einer älteren und einer neueren Fassung werden nicht in einem Baum gemischt. Die Kinder sind Teil dieser einen freigegebenen Struktur. Eine eigenständige Modulansicht braucht eine eigene Freigabe der Kindesfassung. + +**Präzisierung aus dem Website-Zielkonzept, ohne zweiten Freigabemechanismus.** Dieselbe Anzeigefreigabe (G2) und derselbe Strukturleser (G1) gelten für Bibliothek und öffentliche Seite. Öffentlich gelistet ist eine weitere Entscheidung an der Identität und keine zweite Freigabe der Struktur. Sie verweist nur auf eine bereits zur Anzeige freigegebene Fassung. + +Eine öffentlich gezeigte Programmfassung stellt jedes enthaltene Modul an seiner Position als Strukturzeile dar: Anzeigetitel, gesetzte Inhaltsart, Rolle und die Materialien dieser Kindesfassung. Dafür braucht das Modul weder eine eigene Anzeigefreigabe noch eine eigene öffentliche Seite. Ein Verweis auf eine Modulseite entsteht nur, wenn diese Seite dieselbe Kindesfassung zeigt. Zeigt sie eine andere Fassung, bleibt die Zeile ohne Verweis. Die Modulseite beschreibt dann nicht Lernziele oder Bestandteile, die das Programm nicht enthält. + +Historische Fassungen bleiben ganze Stände. Struktur, Rollen, Reihenfolge und didaktische Lehrtexte kommen aus der gezeigten Fassung. Der Anzeigetitel der Identität ist Klasse A und ist auf allen Ständen derselbe. Eine neuere, nur bereite Fassung ersetzt weder in der Bibliothek noch öffentlich die bisher gezeigte Fassung. Weicht der aktuelle Artikel-Stand von der gezeigten Fassung ab, bleibt die gezeigte Fassung stehen, und es entsteht ein Befund statt einer gemischten Ansicht. + +Ein Programm gelangt in die persönliche Bibliothek nur, wenn diese Programmfassung zur Anzeige freigegeben ist und die Person an mindestens einem Blatt genau dieser Fassung eine gültige Berechtigung hat, oder wenn ein berechtigter Artikel-Stand diese freigegebene Fassung als Wurzel hat. Der Zugriff auf einen enthaltenen Film reicht nicht. Liegt der Film in einer nur bereiten, nicht freigegebenen Programmfassung, erscheint er über seinen eigenen Artikel als Material, ohne Programmbaum, ohne Pfad und ohne Hinweis auf diese Fassung. Die Verwaltung darf die Verwendung weiter sehen. Die Mitgliederansicht nicht. + +Alle übrigen Programme bleiben außerhalb dieser Bibliothek. Ihre öffentliche Vorstellung gehört zum separaten Auftrag für Design, Website und CMS. + +Jedes Blatt wird einzeln zurückgeführt: + +1. Kandidat ist ein Artikel-Stand mit Status veröffentlicht oder abgelöst-verfügbar, dessen `release_contents` genau diese Inhaltsfassung enthält, und zu dessen Artikel die Person mindestens einen zeitlich gültigen, aktiven Grant hat. +2. Für die angeforderte Aktion gilt das vorhandene `DecideAccess`. Es trägt genau ein Grant. Schnappschüsse werden nicht vereinigt. +3. Mehrere Erwerbsquellen dürfen genannt werden. Die Auslieferung nennt die eine tragende Quelle. Entfällt sie, wird neu entschieden. +4. Der Blattstatus ist nutzbar, wenn für die angebotene Aktion ein Kandidat trägt; gesperrt, wenn Fassung oder Stand gesperrt ist oder kein Schnappschuss die Aktion erlaubt; sonst nicht nutzbar. Der Knoten bleibt sichtbar. Eine Datei-URL gibt es nur bei nutzbar, und die Ausgabe prüft erneut. + +Der Programmstatus wird nur aus den Blättern der angezeigten Fassung abgeleitet: vollständig nutzbar, teilweise nutzbar, nicht nutzbar oder gesperrt. Vollständig nutzbar schreibt keinen Erwerb. Die Kennzeichnung „als Programm erworben“ steht nur, wenn ein Grant auf einem Artikel liegt, dessen Stand diese Kompositionsfassung als Wurzel hat. + +Die vorausgewählte Fassung ist der Wurzelstand des berechtigten aktuellen Artikel-Releases, falls diese Fassung zur Anzeige freigegeben ist. Sonst die höchste zur Anzeige freigegebene Programmfassung, die mindestens ein berechtiges Blatt enthält. Eine höhere nur bereite Fassung wird nicht gewählt. Ältere freigegebene Fassungen, deren eigene Blätter berechtigt sind, bleiben als ganze Stände erreichbar. Nur bereite ältere Fassungen nicht. + +Dieselbe Inhaltsidentität erscheint in jedem Programm an der dort gespeicherten Position. Die programmübergreifende Materialliste gruppiert nach `content_elements.id`. Verschiedene Fassungen derselben Identität bleiben an den Vorkommen sichtbar und werden nicht zu einer fassungslosen Karte. + +### E-T Fachliche Typen + +**Entscheidung.** Technische Struktur und redaktionelle Inhaltsart sind getrennt. Fachliche Typen werden nicht dauerhaft auf `CompositionKind` beschränkt und vorhandene Zeilen nicht automatisch umgedeutet. + +Die technische Struktur bleibt der vorhandene Enum mit den gespeicherten Werten `kurs`, `uebung` und `kombination`. Er trägt Verschachtelung, Zyklenprüfung und die bestehenden Verwaltungsmasken. Es kommt dafür kein Wert `modul` oder `programm` hinzu. Gespeicherte Werte werden nicht umbenannt und nicht still als Programm oder Modul angezeigt. Ohne gesetzte Inhaltsart zeigt die Bibliothek die bisherige Bezeichnung des gespeicherten Werts: Kurs, Übung, fachliche Kombination. + +Die redaktionelle Inhaltsart ist konfigurierbar, mit stabiler Kennung, und wird je Identität ausdrücklich gesetzt. Programm, Modul, Merkblatt und Traineranleitung sind Werte dieser Art, keine neuen Code-Enums. Bestehende Zeilen bleiben ohne Zuordnung, bis jemand sie setzt. Eine Zuordnung ändert `kind` und `output_class` nicht und erzeugt keine neue Fassung. + +Die erste Bibliothek liest diese eine Inhaltsart bereits. Weitere Dimensionen wie Säule, Alter und Einsatzbereich folgen später und legen keine zweite Inhaltsartenliste an. Weichen gesetzte Inhaltsart und technischer Strukturtyp voneinander ab, zeigt die Karte die Inhaltsart und behandelt den Enum nur als technische Herkunft. + +Blätter ohne Inhaltsart zeigen den gespeicherten `kind` und die `output_class` sowie die Rolle der Verwendung. Ein einzelnes PDF wird durch eine gesetzte Art Merkblatt zum Merkblatt. Ohne diese Zuordnung bleibt es ein PDF und wird nicht zum Programm. + +### E-L Lizenz- und Bestellkorrektur + +**Entscheidung.** Die Aktivierung genau einer aktuellen Angebotsfassung, die Registrierungsvergabe nur dieser Fassung und die Bezeichnungskopie neuer Bestellungen liegen vor der Bibliothek. + +Der Unveränderlichkeitshaken an `OfferVersion` erlaubt heute keinen Übergang von `aktiv` nach `beendet`. Die Umsetzung darf nur diesen einen Feldwechsel zulassen. Preis, Umfang und Recht bleiben gesperrt. + +Bestehende Daten werden vor jeder Bereinigung nur gelesen. Solange Dubletten nicht freigegeben bereinigt sind, vergibt die Registrierung trotzdem nur die höchste aktive Nummer je Angebot. Alte Grants bleiben. Alte Bestellungen ohne Bezeichnungskopie werden nicht aus dem heutigen Angebotsnamen gefüllt. + +### E-M Zwei Stufen der Medienausgabe + +**Entscheidung.** Die intern testbare Bibliothek liefert die berechtigte Datei signiert an den normalen Browser-Player und trennt Ansehen und Laden. Adaptives Streaming, Kennzeichnung und Ausgabenachweis werden nicht gestrichen. Sie bleiben Pflichtpaket. Eine kommerzielle Freigabe setzt dieses Paket und alle übrigen MVP-Pflichtpakete voraus, nicht nur die Medienausgabe und nicht einen früheren Zwischenstand. Die technische Zwischenabnahme wartet nicht auf die Medienausgabe. + +### E-W12 Didaktische Metadaten + +**Entscheidung, abgegrenzt.** Lernziele, Zeitbedarf und Materialbedarf sind Lehrinhalt der Klasse B an der Kompositionsfassung. Sie fehlen im Code und in den Paketen 0 bis 9. Sie werden einmalig ergänzt, bevor Programm- und Modulseiten öffentlich vollständig erscheinen. Der Strukturleser G1 liest sie aus derselben Fassung. Ein zweites Feld, eine zweite Fassungstabelle oder ein zweiter Leser entsteht nicht. Vorhandene Fassungen bleiben leer. Eine Änderung legt eine neue Kompositionsfassung an und schreibt die bisherige nicht um. + +### E-D Design, Website und CMS + +**Entscheidung.** Designsystem, öffentliche Website und CMS-Neubau sind ein separater Auftrag. Dieser Plan verwendet das vorhandene Seitenlayout, funktionale Listen und den Browser-Player. Einfache Thumbnails, als geschütztes Bild oder neutraler Platzhalter, gehören dazu. Keine neue Komponentenbibliothek, keine öffentlichen Themenseiten und keine CMS-Bausteine werden dafür neu gebaut. diff --git a/docs/analysen/premium-karten-v1.7-bericht-2026-11-18.md b/docs/analysen/premium-karten-v1.7-bericht-2026-11-18.md new file mode 100644 index 0000000..0d1d3f1 --- /dev/null +++ b/docs/analysen/premium-karten-v1.7-bericht-2026-11-18.md @@ -0,0 +1,170 @@ +# Premium-Karten v1.7 im CMS – Bericht (18.11.2026) + +Branch `feature/premium-karten`, gearbeitet in einem separaten Worktree. Deploy ausschließlich über `develop` (Testinstanz, Port 3011). **Kein Merge nach `main`.** Entscheidung: ADR-39; Technik: `docs/architektur/cms-widget-registry.md` §13. + +Grundlage: `docs/Brand-UI-Kit/13_premium_karten_v1.7_entwurf`. Das Kit ist ein **Entwurf zur visuellen Freigabe**. `FREIGABE.md` führt alle drei Varianten als „zur visuellen Freigabe“. Aus der Integration folgt keine Freigabe. + +## 1. Ergebnis + +Redakteure können die drei Kartenarten in regulären Abschnitten einsetzen, mit bestehenden Fachobjekten verbinden und gestalten, ohne Code zu ändern: + +| Widget | Fachobjekt | Öffentlich sichtbar | Aktion | +|---|---|---|---| +| Themenkarte | veröffentlichtes Thema (Säule) | ja | „Thema entdecken“ → `/themen/{slug}` | +| Medien- und Materialkarte | Inhaltselement mit bereitgestellter Fassung | nur als Bestandteil eines öffentlichen Programms, sonst nur in der Redaktionsvorschau | „Im Programm ansehen“ → Programmseite | +| Programm- oder Modulkarte | Programm oder Modul mit Anzeigefreigabe | Programme ja, Module nur in der Redaktionsvorschau | „Programm ansehen“ → `/programme/{id}`; Module ohne Aktion | + +- **Gespeichert** werden nur Kennungen, Bild, Alternativtext, Bildausschnitt, die Beschriftung der Aktion und ein kurzer Hinweis. Titel, Beschreibung, Art und Linkziel liest die Karte bei jeder Darstellung aus den Fachdaten. Eine Änderung am Thema oder Programm erscheint deshalb ohne Seitenbearbeitung. +- **Gestaltung:** + - Variante: Anpassend (ab 520 px Bild neben Text) oder Bild immer oben. + - Höhe: Natürlich oder An die Zeile angleichen. + - Bildformat: 16:9, 1:1 oder 3:4. + - Bilddarstellung: Ausschnitt oder ganzes Bild. + - Bildausschnitt in Prozent. + - Überschriftenebene: H2, H3 oder H4. + - Ein- und Ausblenden von Kurzbeschreibung, Art, Zusatzangaben und Aktion. +- **Raster:** + - Eine Karte je Platz im bestehenden Abschnittsraster; es gibt kein zweites Kartenraster. + - Neu sind die Raster 1 + 1 + 2 und 2 + 1 + 1. Bestehende Raster und Kennungen sind unverändert. +- **Keine Freigabe geschützter Inhalte:** + - keine Vorschaubilder der Bibliothek + - keine Adressen unter `/bereich/` oder `/redaktion/` + - kein Abspielen, kein Download + - kein Preis, keine Kaufaktion + +## 2. Prüfungen + +| Prüfung | Ergebnis | +|---|---| +| Testsuite (`php artisan test`) | 212 grün, davon 8 neu in `CmsPremiumCardsTest` | +| CI Feature-Branch / Deploy Testinstanz | 4846 / 4847 erfolgreich (Code); Folgecommits siehe Git-Verlauf | +| Bestehende Seiten vor und nach dem Deploy | unverändert: 16 Messungen (8 Seiten × 1440/390 px), Lage und Maße aller Abschnitte und Plätze; 12 Textschnappschüsse des Hauptbereichs | +| Lokale Probe des Redaktionsablaufs (Wegwerfdatenbank) | 114 von 114 Prüfungen. Abläufe: Thema veröffentlichen; Entwurfsseite anlegen mit 1 + 1 + 2, 2 + 2, 4/4, 1 + 1 + 1 + 1 und 1 + 3; Karte wieder öffnen und bearbeiten; speichern; Redaktionsvorschau; veröffentlichen. Messung bei 1440, 1024, 768 und 390 px: gleiche Höhe je Zeile, Bild neben Text genau ab 520 px Kartenbreite, keine Karte schmaler als 240 px, kein Überlauf, keine geschützten Adressen. **Gilt nicht als Abnahme auf der Testinstanz.** | +| Redaktionsablauf auf der Testinstanz | **offen.** Das Skript ist fertig, in dieser Sitzung fehlten die Zugangsdaten des Prüfkontos. | + +**Feature-Tests** (`tests/Feature/CmsPremiumCardsTest.php`): +- Fachbezug ohne Kopie: Die Revision enthält nur Kennungen; Namensänderungen erscheinen sofort. +- Rückzug: Wird ein Thema zurückgezogen oder ein Element archiviert, verschwindet die Karte. +- Programmkarten benennen ihre Art, ohne Bild über die Navy-Tafel. Module erscheinen nur in der Vorschau, mit Hinweis. Kein Preis, keine Kaufbegriffe. +- Medienkarten: + - erscheinen öffentlich nur über ein öffentliches Programm, mit Link auf die Programmseite; + - geben keine Bibliotheksvorschau, keine geschützte Adresse, kein Video und keinen Inhalt aus; + - zeigen keine Kurzbeschreibung. +- Abweisung: + - nicht veröffentlichter oder nicht freigegebener Objekte; + - eines Bildes ohne Alternativtext; + - freier Einstellungswerte. +- Gemischte Raster (1 + 1 + 2, 2 + 2): gleiche Höhe, Bildformat, Bildausschnitt, Variante, Optionen, lange Texte ungekürzt. +- Redaktionsablauf über den Editor (Livewire): + - alle drei Karten anlegen; als Entwurf gespeichert; + - wieder öffnen; Dialog mit den Reitern Inhalt, Medien und Darstellung; + - Live-Vorschau; erneut speichern; veröffentlichen. + +## 3. Grenzen und offene Punkte + +1. **Öffentliche Felder der Medienkarte (Entscheidung von Lars).** Heute nennt nur die Programmseite Bestandteile, und zwar nur mit Titel. + - Die Karte zeigt öffentlich den Titel (Anzeigetitel, sonst Arbeitstitel), die Inhalts- und Ausgabeart und die Programmzugehörigkeit. + - Die Kurzbeschreibung bleibt aus. + - Zu prüfen: ob bei Traineranleitungen schon der Titel öffentlich sein darf. +2. **ADR-29 (öffentliche Profile).** Bis dahin sind Module und Medien ohne öffentliches Programm nur in der Redaktionsvorschau sichtbar. Profile ersetzen später die Übergangsregeln in `PublicCatalogReader` und `PublicMaterialReader`; gespeicherte Karten bleiben gültig. +3. **Gestalterische Freigabe v1.7** und freigegebene Motive. Auf der Testinstanz stehen nur gekennzeichnete Platzhalterbilder. +4. **Zusatzangaben** gibt es nur, soweit die Fachdaten sie hergeben: Ausgabeart, Programmzugehörigkeit, Modulanzahl. Laufzeit, Altersangabe oder Seitenzahl fehlen in den Fachdaten. +5. **Gleiche Höhe** wird je Karte eingestellt, nicht je Abschnitt. Alle Karten einer Zeile müssen „An die Zeile angleichen“ tragen. +6. **Entfallende Plätze.** Eine öffentlich nicht sichtbare Karte (Modul) lässt ihren Platz entfallen; die übrigen Plätze teilen sich die Breite. Hinweis für die Redaktion in §13 der Registry-Dokumentation. +7. **Kaufbare Angebotskarte: offener Bedarf.** Die Karten tragen bewusst keinen Preis und keine Kaufaktion. Eine Angebotskarte braucht ein eigenes Fachobjekt „Angebot“ mit Umfang, Zweck, Lizenzbedingungen und Preisquelle aus dem kommerziellen System. Sie ist gesondert zu konzipieren (Zielkonzept: „Angebotskarte … Neu konzipieren“, Lizenzvergleich). +8. **Validierungsmeldungen** sind teils englisch, weil `lang/de` fehlt. Das ist bekannt und unverändert. + +## 4. Abweichungen vom Kit + +- Kein Beispielraster (`.lf-pc-grid`) und keine Spannweitenklassen; das Abschnittsraster ist das einzige Raster. +- Umschaltung bei 520 px über den Platz-Container. +- Keine H1. +- Gelber Akzent als SVG-Komponente. +- Schriftgewicht 600 statt 750, weil nur vorhandene Schnitte verwendet werden. +- Bildhöhe höchstens min(70vh, 640 px). +- Karten, die nur in der Vorschau erscheinen, mit gestricheltem Rand. + +## 5. Fachliche Nachbesserung nach der Betreiberprüfung (18.11.2026) + +Branch `feature/premium-karten-nachbesserung`, separater Worktree, Deploy nur über `develop`. Keine neue Widget-Art, keine neuen Fachobjekte, keine Migration, keine Änderung an Lizenz- oder Kaufrechten. + +**Ursache „keine Themen“.** Die Themenkarte bot nur veröffentlichte Säulen an. Auf der Testinstanz gibt es fünf Säulen (lesende Abfrage am 18.11.2026), keine ist veröffentlicht, keine hat eine öffentliche Adresse oder einen Text für die Website. Jetzt sind alle Säulen wählbar; öffentlich gilt unverändert die Regel der Themenseiten (veröffentlicht und mit Adresse). + +**Datenstand der Testinstanz (lesend geprüft):** +- 5 Säulen, unveröffentlicht, ohne Website-Text; Säule 1 hat ein zugeordnetes Medium, Säule 2 eine veröffentlichte Seite. +- Film „Lara im Park“: bereitgestellte Fassung, Filmstandbild (aus dem Film bei 41,5 s), Beschreibung vorhanden, **keine Kurzbeschreibung und kein Anzeigetitel**; Bestandteil von „Programm Abstand“ (über Modul Abstand) und der UX-Prüfung, beide öffentlich. +- Zwei weitere Filme nur als Entwurf; Textmaterialien ohne Inhaltsart; eine gesperrte Traineranleitung. +- Module mit Lernziel, Dauer und Materialhinweis; zwei Module mit Vorschaubild; keine Kurzbeschreibungen außer einem Entwurfsmodul. +- Keine Laufzeiten in den Mediendaten (Metadaten nur `file`, `held`). + +### Themenkarte + +| | | +|---|---| +| Verfügbare Fachdaten | Name, öffentliche Adresse, Text für die Website, Veröffentlichung, zugeordnete Seiten und Medien | +| Dargestellt | Name, Text für die Website, „N Seiten zum Thema“ (veröffentlichte Seiten), Aktion auf `/themen/{slug}` | +| Redaktion | alle Säulen wählbar, mit Status „veröffentlicht“ / „nicht veröffentlicht, nur Redaktionsvorschau“; Vorschau mit Hinweisen auf fehlenden Text und fehlendes Kartenbild | +| Fehlt | auf der Testinstanz: Veröffentlichung, Adresse und Text aller Säulen (Pflege unter „Fachliche Säulen“) | +| Bewusst | kein Themenbild aus Medien des Themas (geschützt); Bild nur als Kartenbild aus dem öffentlichen Website-Bereich | + +### Medien- und Materialkarte + +| | | +|---|---| +| Verfügbare Fachdaten | Arbeits- und Anzeigetitel, Kurzbeschreibung, Beschreibung, Einsatzhinweis, Lizenzvermerk, Inhaltsart, Ausgabeart, Fassungsstatus, Vorschaubild (Filmstandbild, geschützt), Programmzugehörigkeit | +| Dargestellt | **Film:** Titel, Kurzbeschreibung, Inhalts- und Ausgabeart, „Im Programm …“, „Vollständiger Film nur mit Lizenz im Mitgliederbereich“, Filmtafel; Aktion auf die öffentliche Programmseite. **Material:** eigene Darstellung mit Materialsymbol, Titel, Kurzbeschreibung, Art. **Vorschau:** Filmstandbild der Bibliothek mit Marke „Bibliotheksbild · nur Vorschau“ | +| Unterschieden | öffentliche Filmvorschau: **gibt es fachlich noch nicht** (keine eigene Ausgabe, keine Freigabe); geschützter vollständiger Film: nie über die Karte, nur Hinweis; Film ohne freigegebenes Vorschaumaterial: öffentlich Filmtafel oder redaktionelles Kartenbild | +| Redaktion | Filme und Materialien mit Entwurfs- oder bereitgestellter Fassung wählbar (gesperrte nicht), Sichtbarkeit in der Auswahl; Hinweise auf fehlende Kurzbeschreibung, Anzeigetitel, freigegebenes Bild | +| Fehlt | Kurzbeschreibungen und Anzeigetitel in den Medien; Laufzeit in den Mediendaten; Freigabe von Vorschaubildern für die Website; öffentliche Filmvorschau (Erweiterungsbedarf: `cms-widget-registry.md` §13) | +| Bewusst | Traineranleitungen nie öffentlich; nie öffentlich: Beschreibung, Einsatzhinweis, Lizenzvermerk, Dateien; kein Abspielen, kein Download | + +### Programm- und Modulkarte + +| | | +|---|---| +| Verfügbare Fachdaten | Bezeichnung, Anzeigetitel, Kurzbeschreibung, Inhaltsart, Fassungen mit Lernziel, Dauer, Materialhinweis, Anzeigefreigabe, Vorschaubild (geschützt), Bestandteile | +| Dargestellt | Titel, Kurzbeschreibung (sonst Lernziel; auf der Programmseite bereits öffentlich), Art „Programm“/„Modul“, Zahl der Module, Dauer, Navy-Tafel; Aktion nur für Programme mit Anzeigefreigabe; Vorschau: Vorschaubild der Bibliothek, markiert | +| Redaktion | Programme und Module mit bereitgestellter Fassung wählbar, auch ohne Anzeigefreigabe (nur Vorschau); Hinweise auf fehlende Kurzbeschreibung und Dauer | +| Fehlt | Kurzbeschreibungen; öffentliche Modulseite (ADR-29, nicht Teil dieses Auftrags); Freigabe von Vorschaubildern | +| Bewusst | kein künstlicher Link für Module; kein Materialhinweis öffentlich; kein Preis, keine Kaufaktion | + +### Prüfungen der Nachbesserung + +| Prüfung | Ergebnis | +|---|---| +| Testsuite | 214 grün (Kartentests 10, davon neu: Entwurf/ohne Freigabe nur in der Vorschau, unveröffentlichte Themen; erweitert: Film/Material, Traineranleitung, keine internen Felder, Bibliotheksbild nur in der Vorschau) | +| Lokaler Redaktionsablauf mit nachgebildetem Datenstand der Testinstanz | 32 von 32: vorhandene Säule, Film, Material, Modul, Programm in 1 + 1 + 2, 2 + 2, 4/4, 1 + 1 + 1 + 1; speichern, wieder öffnen, bearbeiten, speichern; Vorschau bei 1440/1024/768/390 px (alle Karten mindestens 240 px, kein Überlauf, gleiche Höhe je Zeile); Entwurfsseite öffentlich nicht erreichbar. **Gilt nicht als Abnahme auf der Testinstanz.** | +| Redaktionsablauf auf der Testinstanz (Prüfkonto, regulärer Seitenkonfigurator) | **32 von 32.** Die Auswahl bietet alle fünf Säulen und alle Filme und Materialien mit Sichtbarkeit an. Gewählt wurden „Meine Grenzen“, „Lara im Park“, ein Textmaterial, die Module „Freigabe mit Anleitung“ und „Modul Abstand“ sowie „Programm Abstand“, verteilt auf 1 + 1 + 2, 2 + 2, 4/4 und 1 + 1 + 1 + 1. Danach: Entwurf angelegt, wieder geöffnet, bearbeitet, gespeichert. Vorschau bei 1440/1024/768/390 px: alle 10 Karten, mindestens 240 px breit, kein Überlauf, gleiche Höhe je Zeile. Das Filmstandbild erscheint nur in der Vorschau, markiert. Die Entwurfsseite `/karten-nachbesserung-entwurf` (Seite 19) ist öffentlich nicht erreichbar (404). Es wurde nichts veröffentlicht. | + +### Was die Karten mit den heutigen Daten der Testinstanz zeigen + +- **Programmkarte „Programm Abstand“** (öffentlich): Titel, Lernziel als Text, „2 Module“, „Dauer 25 Min.“, Navy-Tafel, Aktion auf die Programmseite. Die vollständigste Karte. +- **Filmkarte „Lara im Park“** (öffentlich über „Programm Abstand“): Titel, Filmtafel, „Film“, „Im Programm …“, Hinweis auf den geschützten Film, Aktion auf die Programmseite. **Kein Text, weil das Medium keine Kurzbeschreibung hat**; in der Vorschau zusätzlich das Filmstandbild, als nicht öffentlich markiert. +- **Materialkarte „Trainerunterlage Abstand“** (öffentlich über „Programm Abstand“): Titel, Materialsymbol, „Text“, Programmbezug. +- **Modulkarten**: nur in der Vorschau, mit Lernziel und Dauer; „Mod - eigene Grenzen erkennen“ mit Vorschaubild der Bibliothek (markiert). +- **Themenkarten**: nur in der Vorschau, weil keine Säule veröffentlicht ist und keine einen Website-Text hat. + +Die verbleibenden Lücken sind **fehlende Fachdaten, nicht fehlender Code**: + +| Fehlt | Gepflegt unter | +|---|---| +| Kurzbeschreibung und Anzeigetitel der Medien | Medium bearbeiten → Anzeigetitel, Kurzbeschreibung | +| Veröffentlichung, Adresse und Text der Themen | Fachliche Säulen → Öffentliche Adresse, Text für die Website, „Auf der Website veröffentlichen“ | +| Kurzbeschreibung der Programme und Module | Programm/Modul → Kurzbeschreibung | +| öffentliches Bild | Kartenbild im Reiter „Medien“ (freigegebenes Motiv), später Freigabe von Vorschaubildern (§13 der Registry) | + +### Neu öffentlich und bewusst entschieden + +- **Kurzbeschreibung von Medien** (Betreibervorgabe) und **Dauer von Programmen** („Dauer N Min.“): beide stehen bisher auf keiner öffentlichen Seite. Die Programmseite zeigt das Lernziel, nicht die Dauer. +- **Vertraulichkeit hängt an der Inhaltsart.** Nie öffentlich sind Elemente mit der Inhaltsart „Traineranleitung“. „Trainerunterlage Abstand“ hat auf der Testinstanz keine Inhaltsart und gehört zu einem öffentlichen Programm. Die Karte ist deshalb öffentlich zulässig. Heute zeigt sie nur den Titel, der auf der Programmseite ohnehin steht. Eine später gepflegte Kurzbeschreibung würde öffentlich. **Vor dem Pflegen von Kurzbeschreibungen den Trainermaterialien die Inhaltsart „Traineranleitung“ zuordnen.** + +### Offene Fragen an Lars + +1. Soll die vorhandene „Beschreibung“ eines Mediums (zum Beispiel 215 Zeichen bei „Lara im Park“) öffentlich als Ersatz dienen, wenn keine Kurzbeschreibung gepflegt ist? Derzeit nein: Die Beschreibung ist Bibliothekstext. +2. Freigabe von Vorschaubildern für die Website und öffentliche Filmvorschauen: minimaler Erweiterungsbedarf in `cms-widget-registry.md` §13. +3. Öffentliche Sichtbarkeit auf der Testinstanz ist nicht live gezeigt, weil keine Hilfsseite veröffentlicht werden darf. Die Regeln belegen die Feature-Tests. Alternative: eine echte Seite mit Karten veröffentlichen. +4. Die Entwurfsseite `/karten-nachbesserung-entwurf` (Seite 19) bleibt zur Ansicht in der Redaktionsvorschau stehen; danach über die Seitenverwaltung löschen. + +### Prüfskript für die Testinstanz + +Das Prüfskript ist `e2e_karten2.py` (im Arbeitsordner der Sitzung, nicht im Repository). Es veröffentlicht nichts und legt die Entwurfsseite `/karten-nachbesserung-entwurf` an. Diese Seite nach der Prüfung über die Seitenverwaltung löschen. diff --git a/docs/analysen/umsetzungsplan-mitgliederbibliothek.md b/docs/analysen/umsetzungsplan-mitgliederbibliothek.md new file mode 100644 index 0000000..2f6dd41 --- /dev/null +++ b/docs/analysen/umsetzungsplan-mitgliederbibliothek.md @@ -0,0 +1,463 @@ +# Umsetzungsplan: Mitgliederbibliothek + +**Stand:** 15.11.2026, nach Review überarbeitet +**Status:** Vorschlag zur Freigabe. Kein Auftrag zur Umsetzung. +**Grundlage:** `docs/analysen/ist-soll-abgleich-mitgliederbibliothek.md`, insbesondere die Architekturentscheidungen E-A, E-T, E-L, E-M und E-D +**Soll:** `docs/fachkonzept/produktkonfiguration-und-mitgliederbereich.md` + +Es wird nichts implementiert, nichts migriert und nichts deployt, solange dieser Plan nicht freigegeben ist. + +Die Befunde A-01 bis E-02 bleiben gültig. Dieser Plan ändert ihre Beschreibung nicht. Neu sind die Entscheidungen der Review und die Paketfolge. + +## Paketfolge + +| Nr. | Paket | Wofür es dasteht | +|---|---|---| +| 0 | Lesende Bestandsaufnahme | Wissen, ob Dubletten und Bestellungen ohne Bezeichnungskopie existieren, bevor etwas bereinigt wird | +| 1 | Angebotsfassung, Registrierung, Bestellbezeichnung | Lizenz- und Bestellfehler, bevor die Bibliothek darauf aufbaut | +| 2 | Technische Struktur und redaktionelle Inhaltsart | Die Bibliothek kann eine gesetzte Art lesen, ohne vorhandene Zeilen umzudeuten | +| 3 | Bibliothek und interne Medienaktionen | Fachliche Struktur, Auflösung, normaler Player, getrennte Dokumentaktionen | +| 4 | Klasse-A-Stammdaten | Titel und Protokoll ohne neuen Inhaltsrelease | +| 5 | Fachdimensionen, Suche, Filter | Themen an Kompositionen und kombinierbare Filter | +| 6 | Einfache Thumbnails | Karte mit Bild oder Platzhalter, ohne Designsystem | +| 7 | Redaktionelle Vorschau und Angebotabdeckung | Dieselbe Struktur wie in der Bibliothek, Ausschlüsse vor der Aktivierung | +| 8 | Kommerziell freigabefähige Medienausgabe | Adaptives Streaming, Kennzeichnung, Ausgabenachweis | +| 9 | E2E-Abnahme auf der Testinstanz | Tor A ist Zwischenstand. Die kommerzielle Freigabe prüft alle MVP-Pflichtpakete | + +Der didaktische Kursplayer bleibt kein Paket. + +## Abhängigkeiten + +```text +0 Bestandsaufnahme + │ + ▼ +1 Lizenz und Bestellung ─────────────┐ + │ │ + ▼ │ +2 Strukturtypen │ + │ │ + ▼ │ +3 Bibliothek, intern testbar ◄───────┘ + │ + ├──► 4 Stammdaten ──► 5 Suche und Filter + │ + ├──► 6 Einfache Thumbnails + │ + └──► 7 Vorschau und Abdeckung + +3 ist intern abnahmefähig. +8 hängt an 3 und ist notwendig, aber allein nicht hinreichend für die kommerzielle Freigabe. +9 Tor A prüft 1, 2 und 3 technisch auf der Testinstanz und gibt nichts frei. +9 Tor B prüft die vollständig umgesetzten Pakete 1 bis 8. +``` + +Paket 4, 5, 6 und 7 warten auf Paket 3, nicht aufeinander, außer Paket 5 auf Paket 4 wegen der durchsuchbaren Kurztexte. Paket 8 wartet nicht auf Thumbnails oder das Designsystem. Paket 0 blockiert nur die Bereinigung vorhandener Zeilen, nicht den Codepfad von Paket 1. + +## Leitgrenzen + +Diese Bestände bleiben in Funktion und Bedeutung erhalten: + +- Identitäten, Fassungen, `composition_members` und die Unveränderlichkeit bereitgestellter Lehrfassungen +- Artikel-Stände, `release_contents`, Grants und `DecideAccess` ohne Vereinigung von Schnappschüssen +- Bestellpreis und `order_scope_items` +- CMS-Entwurf und CMS-Veröffentlichung +- Der Web-Prozess schreibt nicht nach `originals/` und liest `derived/` und `public/` nur +- Signierte URLs ersetzen die Berechtigungsentscheidung nicht + +Neue Anzeigedaten werden nicht in veröffentlichte Fassungen zurückgeschrieben. Die Bibliothek legt keine Grants und keine Erwerbe an. + +Designsystem, öffentliche Website und CMS werden nicht neu gebaut. Die Bibliothek nutzt das vorhandene Layout, funktionale Überschriften und Listen sowie das Browser-Video. + +Automatisierte Tests eines Pakets laufen in der vorhandenen Suite mit Wegwerfdaten. Sie sind keine Abnahme auf der Testinstanz. Die Testinstanz wird nicht mit `RefreshDatabase`, `migrate:fresh` oder `DatabaseTruncation` gegen `luf-test` geprüft. Produktion wird nicht beschrieben. + +## Auflösung, die Paket 3 umsetzt + +Verbindlich ist E-A. Für die Umsetzung in Kurzform: + +- Der Baum kommt nur aus einer zur Anzeige freigegebenen Kompositionsfassung. Status `bereit` genügt nicht. Paket, Angebot und Grant sind keine Knoten. +- Ein berechtigter Film in einer nicht freigegebenen Programmfassung erscheint als Material und zeigt diese Programmstruktur nicht. +- Jede Mitgliedszeile behält ihre Kindesfassung und ihre Rolle. Eine neuere Fassung derselben Identität ersetzt sie nicht. +- Ein Blatt ist nur auslieferbar, wenn genau diese Inhaltsfassung in einem veröffentlichten oder abgelöst verfügbaren Artikel-Stand steht und genau ein Grant die angeforderte Aktion trägt. +- Teilweise lizenzierte Programme bleiben als Baum sichtbar. Nicht getragene Blätter haben keine Datei-URL. +- Vollständig nutzbar ist ein abgeleiteter Status und kein Programmkauf. +- Dieselbe Identität steht in jedem betroffenen Programm. Die Materialliste dedupliziert nur nach der Identität und verschweigt abweichende Fassungen nicht. +- Ein einzelnes berechtigtes PDF ist ein Material, kein Programm. + +## Paket 0 — Lesende Bestandsaufnahme + +**Ziel.** Vor jeder Bereinigung liegt ein Befund über die tatsächlichen Test- und, nur lesend und nur nach Freigabe, Produktionsdaten. + +**Ergebnisse.** Eine Aufstellung, kein Schreibvorgang: + +- Angebote mit mehr als einer Fassung im Status aktiv, mit Nummern und Vergabeart +- Registrierungsangebote und welche Fassung `grantRegistrationOffers` heute träfe +- Bestellzeilen, deren sichtbarer Name aus `offers.name` kommt +- Ob Angebote seit der Bestellung umbenannt wurden, soweit die Daten das hergeben +- Anzahl der Grants je betroffener Angebotsfassung, ohne ihre Schnappschüsse zu ändern + +**Betroffene Komponenten.** Keine Anwendung. Lesende Abfrage. Kein Deploy. + +**Abhängigkeiten.** Keine. + +**Zu erhalten.** Alle Zeilen. Der Befund autorisiert noch keine Bereinigung. + +**Automatisierte Tests.** Keine. Der Befund ist eine Prüfung vorhandener Daten, kein Fixture. + +**Abnahme.** Der Befund nennt je Punkt eine Zahl oder „nicht geprüft, weil kein lesender Zugang“. Eine Bereinigung ohne diesen Befund ist nicht freigegeben. + +## Paket 1 — Angebotsfassung, Registrierung, Bestellbezeichnung + +**Ziel.** Neue Aktivierungen hinterlassen genau eine aktive Fassung je Angebot. Die Registrierung vergibt nur diese Fassung. Neue Bestellungen speichern ihre Bezeichnung. Vorhandene Schnappschüsse bleiben. + +**Ergebnisse.** + +- `OfferService::activate` legt die neue Fassung an und beendet die bisher aktive Fassung desselben Angebots in derselben Transaktion. +- Der Haken an `OfferVersion` lässt dafür nur den Übergang `aktiv` nach `beendet` zu. Jede andere Änderung einer aktiven oder beendeten Fassung bleibt abgewiesen. Das ist die Entscheidung E-L. +- `GrantIssuer::grantRegistrationOffers` und der Kauf lesen je Angebot nur die höchste aktive Nummer. Das gilt auch, solange alte Dubletten noch nicht bereinigt sind. +- Neue `order_lines` speichern die Angebotsbezeichnung zum Bestellzeitpunkt. Die Bestellansicht liest diese Kopie. +- Alte Bestellzeilen werden nicht aus dem heutigen Namen gefüllt. +- Eine Bereinigung schon aktiver Dubletten ist ein eigener Schritt nach Paket 0 und einer ausdrücklichen Freigabe des Befunds. Sie setzt nur überzählige Fassungen auf `beendet` und schreibt Preis, Umfang und Grants nicht um. + +**Betroffene Komponenten.** `OfferVersion`, `OfferService`, `GrantIssuer`, `Checkout`, `resources/views/member/order.blade.php`. + +**Abhängigkeiten.** Paket 0 vor der Bereinigung. Der Codepfad darf vorher entstehen. + +**Zu erhalten.** Historische Preise, Rechtsschnappschüsse, `locked_at`, bereits erteilte Grants. + +**Automatisierte Tests.** + +- Eine zweite Aktivierung lässt genau eine aktive Fassung übrig. Preis und Positionen der ersten Fassung sind unverändert. +- Ein Versuch, an einer aktiven Fassung den Preis zu ändern, scheitert. +- Zwei künstlich aktive Fassungen: die Registrierung legt nur Grants der höheren Nummer an und legt keinen zweiten Erwerb für die niedrigere an. +- Nach dem Kauf ändert ein neuer Angebotsname die gespeicherte Bestellbezeichnung nicht. +- Ein vorhandener Grant behält `rights_snapshot` und `release_at_grant_id`. +- Zwei überlappende Aktivierungen desselben Angebots hinterlassen genau eine aktive Fassung. Beide Fassungen bleiben vollständig gespeichert. Preis und Positionen keiner der beiden werden vermischt oder überschrieben. Die unterlegene Fassung endet auf `beendet`, oder die zweite Transaktion scheitert sauber, ohne eine zweite aktive Fassung zu hinterlassen. Der Test sperrt die Angebotszeile und läuft nicht nur nacheinander. + +## Paket 2 — Technische Struktur und redaktionelle Inhaltsart + +**Ziel.** Die erste Bibliothek kann eine ausdrücklich gesetzte Inhaltsart zeigen. Vorhandene Zeilen behalten ihren technischen Wert und werden nicht umgedeutet. Entscheidung E-T. + +**Ergebnisse.** + +- `CompositionKind` bleibt `kurs`, `uebung` und `kombination`. Kein neuer Enum-Wert und keine Umschreibung vorhandener Zeilen. +- Eine konfigurierbare Inhaltsart mit stabiler Kennung, zunächst nur diese eine Achse. Programm, Modul, Merkblatt und Traineranleitung werden als Werte angelegt und nicht vergeben. +- Die Zuordnung ist je Identität ausdrücklich. Sie ändert `kind` und `output_class` nicht und erzeugt keine Fassung. +- Ohne Zuordnung zeigt die Bibliothek die bisherige technische Bezeichnung. Mit Zuordnung zeigt sie die Inhaltsart. +- Paket 5 übernimmt diese Achse und legt keine zweite Liste an. + +**Betroffene Komponenten.** Neue Zuordnung neben `CompositionKind`, Filament-Feld an Medium und Komposition, Anzeige in der Bibliothek. Der Enum und die drei bestehenden Masken bleiben. + +**Abhängigkeiten.** Keine fachliche Abhängigkeit von Paket 1. Die Bibliothek in Paket 3 hängt von diesem Paket ab. + +**Zu erhalten.** Verschachtelung, Zyklenprüfung, gespeicherte Arten, Bezeichnungen und Mitgliedsrollen. + +**Automatisierte Tests.** + +- Eine vorhandene Komposition `kurs` wird weiterhin als Kurs angezeigt, solange keine Inhaltsart gesetzt ist. `kind` bleibt `kurs`. +- Das Setzen der Inhaltsart Programm ändert die Anzeige und nicht die gespeicherte Art, keine Fassung und keine Mitgliedschaft. +- Ein neuer Wert Modul entsteht ohne Codeänderung und lässt sich einer bestehenden Übung zuweisen. +- Eine Übung ohne Inhaltsart wird nicht als Programm angezeigt. +- Ein PDF ohne Inhaltsart bleibt ein PDF. Nach gesetzter Art Merkblatt bleibt `output_class` unverändert. +- Kein Test und kein Seeder schreibt vorhandenen Zeilen automatisch eine Inhaltsart zu. + +## Paket 3 — Bibliothek und interne Medienaktionen + +**Ziel.** Die persönliche Bibliothek folgt E-A. Sie ist intern testbar: Struktur, Teilrechte und ein normaler Player mit getrennten Dokumentaktionen. Sie ist noch nicht die kommerzielle Medienfreigabe. + +**Ergebnisse.** + +- Programm-, Modul- und Materialansicht auf dem vorhandenen Layout. Die Überschrift „Kurse“ für jede Berechtigung entfällt. +- Baum nur aus zur Anzeige freigegebenen Fassungen, mit Rolle, Reihenfolge und fixierter Kindesfassung. Eine bloß bereite Fassung bleibt unsichtbar. `ContentResolver::expand` bleibt der Abgleich für den Artikel-Stand und wird nicht die Ansicht. +- Ein berechtigter Film, der nur in einer nicht freigegebenen Programmfassung liegt, erscheint als Material ohne Programm, Pfad oder Verwendungshinweis. +- Status vollständig, teilweise, nicht nutzbar und gesperrt, ohne neuen Erwerb. +- Mehrfachanzeige in jedem Programm, Deduplizierung nach Identität nur in der Materialliste, Fassungen bleiben sichtbar. +- Film über den Browser-Player mit Play, Pause, Zeitsuche, Vollbild und Lautstärke, soweit das Element `controls` das hergibt. Keine Entscheidungsmarke, kein Präsentationsmodus. +- Ansehen und Laden sind getrennte Aktionen und laufen beide durch die vorhandene, erneute Prüfung. +- Dateien kommen weiter als signierte Antwort aus `derived/`. Kein HLS, keine Kennzeichnung und kein Ausgabenachweis in diesem Paket. +- `decision_seconds` bleibt gespeichert und steuert diese Ansicht nicht. + +**Betroffene Komponenten.** `LibraryController`, `CourseOutline`, Mitgliedsviews, `routes/web.php`, `resources/js/app.js` nur für das Entfernen des Entscheidungsknopfs, neuer Leser neben `ContentResolver`. `DecideAccess` bleibt. + +**Abhängigkeiten.** Paket 2. Paket 1, damit neue Registrierungen und Käufe nicht auf doppelten aktiven Fassungen entstehen, während die Bibliothek geprüft wird. + +**Zu erhalten.** Grants, Artikel-Stände, Signatur, Leserbindung, keine Vereinigung von Rechten. + +**Automatisierte Tests.** + +- B07 Rolle und Reihenfolge einer Verschachtelung bleiben im Baum. +- B09 und B10 Modul und PDF erscheinen in Programm A und Programm B an ihrer Position. +- B11 Die Materialliste zeigt die Identität einmal und nennt beide Programme. +- B12 Gleicher Titel, andere Identität: zwei Karten. +- B13 Zwei Programmfassungen zeigen je die gespeicherte Filmfassung. +- B14 Ein nur teilweise getragenes Programm ist gekennzeichnet. Die nicht getragene Datei liefert 403. +- B15 Alle Blätter über getrennte Artikel nutzbar, Zahl der Erwerbe bleibt gleich. +- B01 und das Demo-Merkblatt: Film und PDF sind nicht als Programm beschriftet, solange niemand diese Inhaltsart gesetzt hat. +- Ein Grant nur auf einen Film zeigt den Film. Eine bereite Programmfassung, die diesen Film enthält und nicht zur Anzeige freigegeben ist, erscheint weder als Baum noch als Pfad noch unter „verwendet in“. +- Eine freigegebene Programmfassung zeigt das enthaltene Modul auch ohne dessen eigene Freigabe. Ein Verweis auf eine eigene Modulansicht entsteht nur, wenn dort dieselbe Kindesfassung freigegeben ist. +- B16 Stream gelingt an einer Fixture-Datei. Laden derselben Datei ohne Recht liefert 403. +- B21 Ansehen und Laden eines PDF werden getrennt entschieden. +- B17 Zwei Grants mit verschiedenen Zwecken ergeben keine Aktion, die keiner allein erlaubt. +- Der Test erwartet nicht mehr „Zur Entscheidungsmarke“. +- Das Rendern der Bibliothek legt keine Grants an. + +## Paket 4 — Klasse-A-Stammdaten + +**Ziel.** Anzeigetitel und Kurzbeschreibung ändern die Bibliothek ohne neue Lehrfassung. Die Änderung ist protokolliert. Lehrtext und Datei bleiben versioniert. + +**Ergebnisse.** + +- Anzeigefelder an Asset und Komposition. Vorhandene `description`-Texte werden vor dem ersten Schreiben redaktionell eingeordnet, nicht automatisch umetikettiert. +- Speichern ruft keine neue Inhalts- oder Kompositionsfassung auf. +- Protokoll mit Bearbeiter, Zeit und Änderung. +- Die Bibliothek liest diese Felder, sobald sie gefüllt sind, und sonst den bisherigen Arbeitstitel oder die Bezeichnung. + +**Betroffene Komponenten.** `ContentElement`, `Composition`, `ContentService::describe`, Bearbeitungsmasken, Protokolltabelle. Keine Spalte an den Fassungstabellen. + +**Abhängigkeiten.** Paket 3 als Leser. Die Bestellbezeichnung ist bereits Paket 1 und wird hier nicht erneut gebaut. + +**Zu erhalten.** `body`, `metadata`, `classification_note`, CMS-Revisionen, Bestellpreis und Bezeichnungskopie. + +**Automatisierte Tests.** + +- B02 Titel und Kurzbeschreibung erscheinen in der Bibliothek und erzeugen keine neue Fassung und keinen neuen Artikel-Stand. Das Protokoll enthält Bearbeiter und Zeit. +- B18 und B19 Reihenfolge und Datei erzeugen weiterhin neue Fassungen. Die alte Fassung bleibt. +- B24 Die redaktionelle Umbenennung ändert die Bibliothek und nicht die gespeicherte Bestellbezeichnung. +- Eine Änderung von `body` an einer bereiten Fassung scheitert. + +## Paket 5 — Fachdimensionen, Suche und Filter + +**Ziel.** Dimensionen sind pflegbar und an Medien, Module und Programme direkt setzbar. Die Bibliothek sucht und filtert. Die Inhaltsart aus Paket 2 bleibt dieselbe Achse. Sie wird nicht ein zweites Mal angelegt und deutet den technischen Enum nicht um. + +**Ergebnisse.** + +- Dimension und Werte mit stabiler Kennung, ohne die fünf Säulen im Code festzuschreiben. +- Die Inhaltsart aus Paket 2 bleibt diese Achse. Säulen kommen als weitere Dimension dazu. +- Übernahme der vorhandenen `pillars` und `content_element_pillar`. Alte Spalten werden in diesem Paket nicht gelöscht. +- Direkte Zuordnung an Kompositionen. Abgeleitete Themen bleiben als abgeleitet markiert. +- Suche über Titel und Kurzbeschreibung. Filter mit ODER innerhalb einer Dimension und UND zwischen Dimensionen. +- Filament-Formulare, keine neuen CMS-Blöcke und keine neuen öffentlichen Themenseiten. + +**Betroffene Komponenten.** Neue Fachdimension, `PillarService` nur als Quelle der Übernahme, Kompositionsmasken, `LibraryController`. `DecideAccess` liest keine Dimension. + +**Abhängigkeiten.** Paket 3 und Paket 4. + +**Zu erhalten.** Öffentliche Themen, Medien-Säulen, die Regel, dass eine Säule keine Berechtigung erzeugt, `CompositionKind` als Strukturtyp. + +**Automatisierte Tests.** + +- B05 Ein neuer Wert ist Medien, Modul und Programm zuweisbar und filtert die Bibliothek. +- B06 Ein Thema nur am Modul findet das Modul ohne Tag am Film. +- Direktes und abgeleitetes Thema sind im Ergebnis unterscheidbar. +- Leere Suche und Zurücksetzen. Ein Filter liefert keine Datei, deren Aktion `DecideAccess` verneint. +- Weichen gesetzte Inhaltsart und `CompositionKind` voneinander ab, zeigt die Karte die Inhaltsart. Der Enum bleibt unverändert. + +## Paket 6 — Einfache Thumbnails + +**Ziel.** Karten zeigen ein eigenes geschütztes Bild oder einen neutralen Platzhalter. Ein Videoframe kann als Bild übernommen werden. Der Film bleibt unverändert. Das ist keine Gestaltungsvorlage für die öffentliche Website. + +**Ergebnisse.** + +- Klasse-A-Bild und Alternativtext an Asset, Modul und Programm. +- Upload eines Bildes. Für Video: Zeitposition, erzeugtes Bild, Vorschau, die zur Position passt. +- Fehler zeigen den Platzhalter und einen kurzen Fehlertext. +- Das Bild ist nicht über die öffentliche Medienroute abrufbar. +- Keine Bildsprache, keine Marketingfreigabe und kein CMS-Baustein. + +**Betroffene Komponenten.** Identitätstabellen, ein Ableitungsjob neben `StoreContentFile`, Filament-Felder, die Karte aus Paket 3. Ablage unter der geschützten Ableitung, nicht als Ersatz der Filmdatei. + +**Abhängigkeiten.** Paket 3 und Paket 4. Die Frame-Extraktion liest die vorhandene Datei und schreibt `content_hash` nicht neu. + +**Zu erhalten.** Filmdaten, bereitgestellte Fassungen, öffentliche Medien der CMS-Seiten. + +**Automatisierte Tests.** + +- B02 Ein neues Vorschaubild erzeugt keine Inhaltsfassung. +- B03 Die Filmdatei und ihr Hash bleiben nach der Frame-Übernahme gleich. Das Bild liegt vor. +- B04 Die öffentliche Medienroute liefert das Bild nicht. +- Ein fehlgeschlagenes Bild lässt die Karte mit Platzhalter ausliefern. +- Eine gesetzte Bildwahl der Komposition bleibt vor einem Vorschlag aus enthaltenen Medien. + +## Paket 7 — Redaktionelle Vorschau und Angebotabdeckung + +**Ziel.** Die Redaktion sieht die Verwendung einer Komposition und dieselbe Struktur wie das Mitglied. Eine Angebotsfassung nennt Ausschlüsse, bevor sie aktiv wird. + +**Ergebnisse.** + +- `compositionUsage` in der Maske von Modul, Übung und Programm. +- Vorschau des Baums aus Paket 3, getrennt von der Liste des kaufbaren Artikelumfangs. +- Vor `activate` ein Befund, welche Blätter der beworbenen Kompositionsfassung in keinem gewählten Artikel-Stand liegen. Stille Aufnahme eines Ausschlusses unterbleibt. +- Die Aktivierung selbst bleibt die Transaktion aus Paket 1. + +**Betroffene Komponenten.** `EditComposition`, `CatalogReading`, `OfferService`, `ViewOffer`. + +**Abhängigkeiten.** Paket 1 und Paket 3. + +**Zu erhalten.** Historische Angebotsfassungen, Grants, Zyklenprüfung der Pakete. + +**Automatisierte Tests.** + +- B23 Vorschau und Mitgliedsansicht zeigen für dieselbe Fassung dieselben Knoten, Rollen und Fassungsnummern. +- B20 bleibt aus Paket 1 grün. +- Ein Angebot, das ein Programm nicht deckt, wird nicht aktiviert und nennt die fehlenden Blätter. +- Eine Übung, die in einem Programm steckt, zeigt diese Verwendung in der Maske. + +## Paket 8 — Kommerziell freigabefähige Medienausgabe + +**Ziel.** Die in §11 der Produktkonfiguration und im Medienkonzept verlangte Ausgabe ist umgesetzt und nicht still entfallen. Entscheidung E-M. Dieses Paket ist eine notwendige Bedingung der kommerziellen Freigabe. Hinreichend wird sie erst, wenn Tor B alle MVP-Pflichtpakete abgenommen hat. Die interne Testbibliothek aus Paket 3 bleibt bis dahin der technische Stand. + +**Ergebnisse.** + +- Adaptive, geschützte Videoausgabe nach dem bestehenden Medienkonzept. Die Berechtigung bleibt `DecideAccess` je Aktion. Eine Signatur gilt für das entschiedene Ausgabeformat, nicht für eine beliebige Datei. +- Dokumente tragen die vorgesehene Lizenzkennzeichnung auch bei der Anzeige im Browser. +- Jede tatsächliche Ausgabe erzeugt einen Ausgabenachweis zur tragenden Berechtigung, ohne eine zweite Berechtigung zu schaffen. +- Vorhandene Pfade in `derived/` bleiben für bereits gespeicherte Fassungen lesbar. Neue Ableitungen ersetzen diese Pfade nicht rückwirkend. +- Originaldateien werden nicht öffentlich ausgeliefert. Ob die fehlende Ablage nach `originals/` in diesem Paket nachgezogen wird, ist Teil der technischen Umsetzung, nicht eine Streichung der Kennzeichnung. + +**Betroffene Komponenten.** Auslieferung neben `LibraryController::media`, Queue, Nachweisdaten. Nicht der didaktische Player und nicht das Designsystem. + +**Abhängigkeiten.** Paket 3. Paket 1, weil kommerzielle Käufe eine eindeutige Angebotsfassung brauchen. + +**Zu erhalten.** Artikel-Stände, Grants, die Trennung der Aktionen, die Unveränderlichkeit der Filmfassung beim Erzeugen einer Ableitung. + +**Automatisierte Tests.** + +- B16 gilt weiter für die adaptive Ausgabe: ohne Streamrecht keine Variante, ohne Laderecht kein Download der Quelldatei. +- Eine Dokumentausgabe enthält die Kennzeichnung und einen Nachweis. Dieselbe Datei ohne passenden Grant erzeugt keinen erfolgreichen Nachweis. +- Zwei Grants werden im Nachweis nicht zu einem dritten Recht zusammengezogen. +- Eine bereits gespeicherte, nicht adaptive Datei bleibt über den bisherigen berechtigten Abruf lesbar, bis ihre Fassung eine neue Ableitung erhält. + +## Paket 9 — E2E-Abnahme auf der Testinstanz + +**Ziel.** Die Suite mit Fixtures wird durch einen Lauf gegen die laufende Testinstanz ergänzt. Es werden echte Dateien und echte Berechtigungsfälle verwendet. Tor A ist ein technischer Zwischenstand. Eine kommerzielle Freigabe setzt die vollständige Umsetzung und die bestandene Abnahme aller MVP-Pflichtpakete voraus. + +MVP-Pflichtpakete sind 1, 2, 3, 4, 5, 6, 7 und 8. Paket 0 ist die Bestandsaufnahme vor einer Bereinigung und kein Produktpaket. Ein Paket, das zur Abnahme zufällig noch nicht fertig ist, gilt nicht als erfüllt. + +**Ergebnisse.** Zwei Tore, beide nur gegen Test, nie gegen Produktion und nie mit Leeren der Testdatenbank. + +**Tor A, technischer Zwischenstand nach Paket 1, 2 und 3.** Auf der Testinstanz: + +- ein Film und ein PDF, die als Dateien unter dem Testmedienbestand liegen und nicht nur als `Storage::fake` +- zwei zur Anzeige freigegebene Programme, gemeinsamer Film, gemeinsames PDF, unterschiedliche Rollen +- eine nur bereite Programmfassung mit demselben Film bleibt für das Mitglied unsichtbar +- eine Person mit nur einem Modul, eine Person mit allen Teilen über getrennte Artikel, eine Person ohne Grant +- Stream gelingt nur für die berechtigte Person. Laden des Films scheitert, wenn es nicht im Schnappschuss steht +- Ansehen und Laden des PDF sind getrennt +- das teilweise Programm ist gekennzeichnet, das vollständige Programm hat keinen zusätzlichen Erwerb erzeugt +- die Materialliste zeigt das gemeinsame PDF einmal +- vorhandene Kompositionen ohne gesetzte Inhaltsart tragen weiterhin ihre technische Bezeichnung + +Tor A gibt die Bibliothek nicht für zahlende Trainer frei und ersetzt kein späteres Paket. + +**Tor B, kommerzielle Abnahme.** Erst wenn die Pakete 1 bis 8 umgesetzt sind und ihre automatisierten Tests bestehen. Der Lauf wiederholt Tor A und prüft zusätzlich, vollständig und nicht nur soweit schon deployt: + +- adaptive Ausgabe, Kennzeichnung und Ausgabenachweis aus Paket 8 +- Umbenennung ohne neue Fassung und unveränderte Bestellbezeichnung aus Paket 4 +- Filter und direkte Themen an Modul und Programm aus Paket 5 +- Thumbnail ohne öffentliche Route aus Paket 6 +- Abdeckungsverweigerung und dieselbe Struktur in der Vorschau aus Paket 7 +- genau eine aktive Angebotsfassung, auch nach dem Parallelitätstest aus Paket 1 + +Fehlt eines dieser Ergebnisse, ist Tor B nicht bestanden. + +**Betroffene Komponenten.** Testinstanz `luf-test`, Testdaten, die sich wiederfinden lassen und Produktionsmedien nicht berühren. Der Demo-Seeder legt keine Inhaltsarten auf vorhandene Zeilen. Ein zweiter Lauf legt dieselben Kennungen nicht erneut an. + +**Abhängigkeiten.** Tor A: Pakete 1, 2 und 3. Paket 0 muss den Befund geliefert haben, wenn eine Dublette bereinigt werden soll. Tor B: Pakete 1 bis 8 vollständig. + +**Zu erhalten.** Produktionsdaten, der Medienbestand von `luf-prod`, fremde Anwendungen auf dem Host. + +**Automatisierte Tests.** Der Lauf ist ein HTTP-Lauf gegen die Testinstanz oder ein eigener Wegwerf-Container mit eigener Datenbank und einer echten Datei. Er ist kein `php artisan test` im Container von `luf-test`. Ein Test, der nur die Überschrift „Kurse“ erwartet, ist keine Abnahme. Tor A ist kein Ersatz für Tor B. + +## Zurückgestellt + +Automatische Denkpause, Ablaufsteuerung, Präsentationsmodus, Fortschritt und zweites Gerät. `decision_seconds` bleibt in den Fassungen und wird nicht zum Thumbnail. + +Die Bibliothekspakete bauen kein Designsystem, keine öffentlichen Objektseiten und kein CMS. Diese Arbeit liegt in der Spur W und beginnt nicht mit diesem Plan. Einzige Ausnahme im ersten Schritt ist der wegwerfbare Editor-Prototyp W-P. Einfache Thumbnails und die funktionale Bibliothek bleiben in den Paketen 3 und 6. + +Organisationslizenzen, Community, echter Zahlungsdienst, kundeneigene Paketkonfiguratoren, konkrete Preise und Tarife. + +## Verbleibende Entscheidungen zur Freigabe + +Entschieden mit dieser Präzisierung: Eine nur bereite Programmfassung wird nicht durch einen Filmzugriff sichtbar. Fachliche Typen sind konfigurierbare Inhaltsarten. Bestehende Enum-Werte werden nicht umgedeutet. Tor A ist kein Freigabetor. Kommerziell freigegeben wird nur nach bestandener Abnahme der Pakete 1 bis 8. + +Offen bleibt nach der Übernahme des Website-Zielkonzepts: + +1. **Bereinigung.** Nach dem Befund aus Paket 0: Welche konkret genannten Dubletten dürfen auf `beendet` gesetzt werden? Ohne diese Freigabe bleibt der Codepfad aus Paket 1, und die alten Zeilen bleiben stehen. +2. **Ort der Teilprogramme.** E-A legt fest, wann ein zur Anzeige freigegebenes und nur teilweise nutzbares Programm in der persönlichen Bibliothek erscheint. Die Position in der Navigation bleibt eine spätere UX-Entscheidung und blockiert Paket 3 nicht. +3. **Bereinigung nach Paket 0** bleibt die einzige Freigabe, die den Code von Paket 1 nicht blockiert. Öffentliche Listung, W2 und der Verkaufsstart sind nicht Teil der ersten Schritte. + +## Gemeinsame Verträge mit Website und CMS + +Übernommen aus `docs/architektur/website-cms-marketing-zielarchitektur.md`, Kapitel 14.1, und dem strategischen Zielkonzept. Die Pakete 0 bis 9 behalten Inhalt und Reihenfolge. Es entsteht kein zweites Datenmodell, kein zweiter Strukturleser und kein zweiter Freigabemechanismus. + +| Vertrag | Was einmal gebaut wird | Implementierungsort | Hängt ab von | Genutzt von | +|---|---|---|---|---| +| **G1** Strukturleser | Löst eine **ausdrücklich angegebene** Kompositionsfassung auf — **unabhängig** von ihrer Anzeigefreigabe. Baum: Identität, fixierte Kindesfassung, Rolle, Reihenfolge, Inhaltsart, Klasse-A-Daten, ab E-W12 auch Lernziel, Zeit und Material der Fassung. Kennt keine Person und keine Berechtigung. | Paket 3, eine Klasse neben `ContentResolver`. `expand` bleibt der Abgleich des Artikel-Stands. | G2, G3. Klasse-A-Felder dürfen leer sein, bis G4 steht. Didaktische Felder bleiben leer, bis E-W12 steht. | Paket 3 legt die Berechtigung je Blatt darüber (G2). Paket 7 zeigt denselben Baum. Redaktionelle Vorschau darf auch noch nicht freigegebene Fassungen lesen. Die öffentliche Lesesicht projiziert denselben Baum ohne geschützte Felder. | +| **G2** Anzeigefreigabe | Prüft Freigabe für Mitglieder und Öffentlichkeit. Zustand je Kompositionsfassung mit Bearbeiter und Zeitpunkt; Freigabe und Rücknahme **versionsgebunden** und nachvollziehbar, ohne unveränderliche Fassungsinhalte oder Mitgliedschaften nachträglich zu verändern. Unabhängig von `bereit` und vom Artikel-Stand. Abfragen: ist diese Fassung freigegeben, und welches ist die höchste freigegebene Fassung der Identität. | Paket 3, an `composition_versions`, nicht an Seiten und nicht am Artikel-Stand. | Paket 3 | Paket 3, Paket 7, öffentliches Profil. Die Listung verweist nur auf eine hier freigegebene Fassung. | +| **G3** Inhaltsart | Konfigurierbare Werte mit stabiler Kennung. Startwerte `programm`, `modul`, `merkblatt`, `traineranleitung`, zunächst unvergeben. Setzen ändert weder `kind` noch `output_class`. | Paket 2 | keine | Paket 3, Paket 5 übernimmt dieselbe Achse, W3 bestimmt daraus Seitentyp und Adresse. | +| **G4** Klasse-A-Anzeigefelder | Anzeigetitel und Kurzbeschreibung an der Identität, ein Protokoll, ein Titel für Bibliothek und Website. | Paket 4 | Paket 3 als Leser | Paket 3, Paket 5, W3, SEO-Vorbelegung | +| **G5** Dimensionswerte | Stabile Kennung je Wert. Säulen behalten ihre Identität. Direkte und abgeleitete Zuordnung bleiben unterscheidbar. `/themen` bleibt erreichbar. | Paket 5 | Paket 4 | Paket 5, Themenseiten, spätere Signaturen, öffentliches Profil der Säulen | +| **G6** Bildableitung | Ein Auftrag in der Queue erzeugt geschützte Ableitungen aus Bild oder Videoframe. Öffentlich oder geschützt ist eine Eigenschaft der Verwendung, kein zweiter Auftrag. | Paket 6 | Paket 4 | Paket 6, W2, W3 gibt eine Ableitung ausdrücklich öffentlich frei | +| **G7** Abdeckungsbefund | Lesedienst: welche Blätter dieser Kompositionsfassung liegen in keinem Artikel-Stand des genannten Angebotsumfangs. Aufrufbar außerhalb der Aktivierung. | Paket 7 | G1 | Paket 7, W3 für „nicht enthalten“ | +| **G8** Aktuelle Angebotsfassung | Eine Lesefunktion: die eine aktive Fassung des Angebots. Bei noch nicht bereinigten Dubletten die höchste aktive Nummer. | Paket 1, `OfferService` | Paket 1 | Registrierung, Kauf, W3 | +| **G9** Instanz-Suite | Browser-Lauf über HTTP gegen die Testinstanz oder einen Wegwerf-Container. Nie Produktion. Nie Leeren der Testdatenbank. | Paket 9, oder W1, falls die Spur W zuerst eine Sichtprüfung braucht. Eine Suite, nicht zwei. | die jeweils geprüften Pakete | Tor A, Tor B, W1 bis W4 | + +Verträge G1 bis G8 werden festgehalten, bevor Paket 3 beginnt. Paket 0, Paket 1 und W-P warten darauf nicht. + +## Sichtbarkeit und historische Fassungen + +Gilt für Bibliothek und öffentliche Seite über G1 und G2. + +- Eine zur Anzeige freigegebene Programmfassung zeigt jedes enthaltene Modul als Bestandteil dieser Fassung. Die eigene Anzeigefreigabe des Moduls ist dafür nicht nötig. +- Eine öffentliche Programmseite tut dasselbe. Zusätzlich verlinkt sie ein Modul nur, wenn die gelistete Modulseite dieselbe Kindesfassung zeigt. Sonst bleibt die Zeile ohne Link, mit Befund. +- Die öffentliche Listung gibt die Moduldatei nicht frei und macht eine nur bereite Programmfassung nicht sichtbar. +- Jede Ansicht zeigt genau eine Fassung. Bestände werden nicht gemischt. Lehrtexte und Struktur stammen aus dieser Fassung. Der Anzeigetitel stammt aus der Identität. +- Folgt eine öffentliche Seite einem Artikel-Stand, übernimmt sie dessen Wurzelfassung nur, wenn diese zur Anzeige freigegeben ist. Sonst bleibt die bisher gezeigte Fassung, und der neue Stand wird als Befund gemeldet. +- Hat kein Artikel die Programmfassung als Wurzel, bestätigt die Redaktion eine freigegebene Fassung. Vorschlag ist die höchste freigegebene, nicht die höchste bloß bereite. +- In der Bibliothek bleibt ein Stand mit eigener Anzeigefreigabe als ganzer Stand erreichbar. Eine neuere unfreigegebene Fassung ersetzt ihn nicht. + +## Ergänzung E-W12 — didaktische Metadaten + +**Ziel.** Lernziele, Zeitbedarf und Materialbedarf liegen an der Kompositionsfassung und sind vor der vollständigen öffentlichen Programm- und Moduldarstellung lesbar. Entscheidung E-W12 im Abgleich. + +**Zuschnitt.** Ein Schreibweg über die vorhandene neue Kompositionsfassung. Keine Änderung an einer bereits bereiten Fassung, keine zweite Tabelle, kein eigener Leser. G1 gibt die drei Felder am Versionsknoten aus. Sind sie leer, zeigen Bibliothek und spätere öffentliche Seite Kurzbeschreibung und Struktur und nicht eine erfundenen Lernzielblock. + +**Ort in der Folge.** Nach Paket 3, unabhängig von den Paketen 4, 5, 6 und 7, zwingend vor W3a. W3a beginnt nicht mit einer Programmseite, der diese Felder fehlen. + +**Tests.** Eine Änderung der Lernziele erzeugt eine neue Fassung und lässt die bisherige unverändert. G1 liefert am alten und am neuen Stand jeweils den zugehörigen Text. Eine Fassung ohne diese Felder bleibt lesbar. Es wird kein vorhandener Datensatz gefüllt. + +## Erste Schritte, noch nicht begonnen + +Bibliothek und Website werden nicht umgesetzt. Freigegeben zum Vorbereiten sind nur die folgenden drei Arbeiten. Jede weitere Arbeit wartet auf ihre explizite Freigabe. + +### Paket 0 — Befund, nur lesend + +Auf der Testinstanz, ohne Schreibzugriff und ohne Deploy, zählen und auflisten: + +- Angebote mit mehr als einer Fassung im Status aktiv: Angebotskennung, Fassungsnummern, Vergabeart +- welche dieser Fassungen die Registrierung heute träfe, wenn sie alle aktiven Fassungen läse +- Bestellzeilen ohne gespeicherte Bezeichnungskopie: Anzahl, nicht die Namen von Personen +- Grants je solcher Angebotsfassung: Anzahl, nicht Namen und nicht Schnappschüsse + +Personenbezogene Werte kommen nicht in das Repository. Der Befund nennt Zahlen und fachliche Kennungen. Eine Bereinigung folgt erst nach Freigabe genau dieser Zeilen. Produktion wird nicht abgefragt, solange das nicht eigens freigegeben ist. + +### Paket 1 — Codepfad, ohne Datenbereinigung + +Auf einem Feature-Branch, nicht auf `main`: + +- `OfferService::activate` sperrt das Angebot und beendet in derselben Transaktion die bisher aktive Fassung nur durch den Status `beendet` +- `OfferVersion` lässt ausschließlich diesen Übergang zu +- Registrierung und Kauf lesen G8, also eine aktive Fassung, bei Alt-Dubletten die höchste Nummer +- neue Bestellzeilen speichern die Bezeichnung +- Tests aus dem Paket, einschließlich des Parallelitätstests mit zwei überlappenden Aktivierungen +- keine Änderung bestehender Bestellungen und keine Statusänderung bereits vorhandener Dubletten + +Der Branch wird nicht deployt, solange die Tests nicht grün sind und die Freigabe zum Test-Deploy fehlt. + +### W-P — Editor-Prototyp, unabhängig + +Wegwerfcode auf einem eigenen Feature-Branch. Keine Migration. Nur Seiteneditor, Bausteinregister und Bausteinansichten. Keine Mitgliedsansichten, keine Kataloglogik, kein Designsystem. Daten bleiben auf `pages` und `page_revisions`. + +Umfang und Abnahme stehen in der Zielarchitektur, Abschnitt 4.5: Aufgaben T1 bis T9, Kriterien K1 bis K5. Programmkarten speichern nur Kennungen und lesen die vorhandene Bezeichnung. Der Prototyp wird nicht in W2 übernommen. W2 startet nicht, bevor das Ergebnis von W-P festgehalten ist. + +W-P kann gleichzeitig mit Paket 0 und dem Codepfad von Paket 1 laufen, weil es dieselben Dateien nicht berührt. diff --git a/docs/analysen/wp-editor-prototyp-2026-03-15.md b/docs/analysen/wp-editor-prototyp-2026-03-15.md new file mode 100644 index 0000000..7c1820b --- /dev/null +++ b/docs/analysen/wp-editor-prototyp-2026-03-15.md @@ -0,0 +1,37 @@ +# W-P — Editor-Prototyp (Wegwerf-Branch `feature/w-p-editor-prototype`) + +Stand: 2026-03-15. Zielarchitektur §4.5. Keine Migration, nur `pages` / `page_revisions`. + +## Umgesetzt + +| Bereich | Inhalt | +|---|---| +| Bausteinregister | Heldenbereich (`hero`, Varianten `split` / `centered`), Bild-Text-Varianten, `program_cards`, `global_reference`; Bestandsbausteine unverändert nutzbar | +| Blockvorschau | Live-Vorschau je Repeater-Eintrag über dieselben `public.blocks.*`-Blades (K1) | +| Ganzseitige Vorschau | Breiten-Umschalter 390 / 768 / 1440 px an der Vorschauroute | +| Vorlage | „Aus Vorlage“ in der Listenansicht; „Als Vorlage duplizieren“ im Editor | +| Globaler Abschnitt | Baustein `global_reference` mit Pfad; Auflösung bei Darstellung über `BlockExpander` | +| Programmkarten | Nur `composition_id` in den Daten; Bezeichnung zur Laufzeit aus `compositions.designation` | + +## Bedienprüfung (vorbereitet) + +Lokal oder auf Test, Redaktion unter `/redaktion`, Rolle mit Seiten-Recht. + +1. **T1 / Vorlage:** Seiten → „Aus Vorlage“ → Vorlage `/praevention` → neuer Pfad → drei Texte ändern → speichern → veröffentlichen → öffentliche URL prüfen; Vorlage unverändert. +2. **T2:** Baustein Bild-Text, Variante wechseln → Blockvorschau ohne Speichern. +3. **T3:** Abschnitte umsortieren / duplizieren → Ganzseitenvorschau. +4. **T4:** Programmkarten: zwei Kompositionen suchen, Reihenfolge tauschen → Bezeichnungen aus Fachdaten. +5. **T5:** Vorschau 390 px → langer Titel korrigieren. +6. **T6:** Globale Seite z. B. `/global/w-p-footer` pflegen, auf Landing per `global_reference` einbinden, veröffentlichen. +7. **T7:** Revisionen-Tab → frühere Revision wiederherstellen. +8. **T8 / T9:** Viele Bausteine / Pflichtfeld leer — wie in §4.5. + +Zeiten und Stockungen sind beim Durchlauf durch den Betreiber zu notieren. + +## Nicht enthalten (bewusst) + +Seitentypen, Schemaversion, Medienbibliothek, öffentliches Profil, Kataloglogik, Designsystem. Code wird nicht nach W2 übernommen. + +## Technische Tests + +`tests/Feature/WpEditorPrototypeTest.php` (Registry, Renderer, Abwärtskompatibilität `image_text`). \ No newline at end of file diff --git a/docs/architektur/00_README.md b/docs/architektur/00_README.md index e13361d..5166c76 100644 --- a/docs/architektur/00_README.md +++ b/docs/architektur/00_README.md @@ -17,8 +17,8 @@ ## 0. Was die Challenger-Prüfung ergeben hat | Was hielt | die Gesamtarchitektur „Kern plus Community-Satellit“, das Vier-Ebenen-Modell, die Paketauflösung, die eingefrorene Bestellkopie, die unveränderlichen Fassungen, das Verbot der Rechtekombination, der Verzicht auf DRM | | Was nicht hielt | die Berechtigungsquelle (ein kostenloses Angebot hätte nur ein Mitglied bedient); die Berechtigungsentscheidung (Zugriff auf Medien nicht erworbener Artikel war nicht ausgeschlossen); die Upgrade-Mechanik (verschlechterte erworbene Rechte); mehrere Abläufe bei Gleichzeitigkeit und falscher Meldungsreihenfolge; die Sicherungs- und Wiederanlaufziele; die fehlende Schadensbegrenzung nach Überwindung einer Komponente; die Abgrenzung von Organisationslizenzen im ersten Schnitt | | Was sich durch neue Beschlüsse geändert hat | Die Updatepolitik ist entschieden (alle später freigegebenen Fassungen desselben Artikels); das konfigurierbare Versionsanspruchsmodell ist entfallen | -| Technologie | Die Empfehlung „Django + Wagtail, knapp“ ist nicht bestätigt. Die Stapelwahl ist offen; ein abgegrenzter Machbarkeitsnachweis entscheidet (`10`, Abschnitt 2.1) | -| Review-Gate | Die korrigierte Architektur reicht als Grundlage der Implementierungsplanung, mit **einer** blockierenden Voraussetzung: der Stapelwahl (`13`, Abschnitt 10) | +| Technologie | **Beschlossen am 15.11.2026:** Laravel 13, Filament 5, PHP 8.4, PostgreSQL (ADR-02). Die frühere Empfehlung „Django + Wagtail, knapp“ gilt nicht | +| Review-Gate | Die Stapelwahl blockiert die Umsetzung nicht mehr. Offen bleiben die Geschäftsentscheidungen in `13`, die den Verkaufsstart betreffen | --- @@ -133,7 +133,7 @@ ## 7. Entscheidungen, die als Nächstes anstehen |---|---|---| | 1 | Die Korrekturen der Challenger-Prüfung bestätigen oder zurückweisen, insbesondere die ersetzten ADR-02, ADR-09, ADR-10, die neuen ADR-23 bis ADR-27 und die Annahme A-14 | `13`, Abschnitte 9 und 10; `12` | | 2 | Gesamtarchitektur mit den beiden Auflagen bestätigen oder verwerfen | ADR-01, `02`, Abschnitt 7 | -| 3 | **Machbarkeitsnachweis zur Stapelwahl beauftragen, danach Kernstapel entscheiden** – die einzige Voraussetzung, die die Implementierungsplanung blockiert | E-18; `10`, Abschnitt 2.1 | +| 3 | Kernstapel ist entschieden (ADR-02, 15.11.2026). Kein weiterer Machbarkeitsnachweis | E-18 erledigt | | 4 | Freigabe einer rein lesenden Bestandsprüfung am Server | A-05 bis A-08 | | 5 | Ziele für Datenverlust und Wiederanlauf festlegen; Außer-Haus-Sicherungsziel wählen | E-22, A-15 | | 6 | Steuerstatus, Kundenkreis, Zahlungs- und Rechnungsweg | OPEN-06, E-09 | diff --git a/docs/architektur/02_Architekturvarianten_und_Entscheidung.md b/docs/architektur/02_Architekturvarianten_und_Entscheidung.md index d450aa1..17d5e5c 100644 --- a/docs/architektur/02_Architekturvarianten_und_Entscheidung.md +++ b/docs/architektur/02_Architekturvarianten_und_Entscheidung.md @@ -176,7 +176,7 @@ ### 8.1 Einschätzung für den Kern nach der Challenger-Prüfung **Was gegen S2 spricht:** Entwurf, Vorschau, Revisionen und Wiederherstellung für Seiten sind Eigenbau oder Zukauf. Das vorhandene Sektionssystem des FewoPortals bietet dafür laut dessen Projektbeschreibung keine Grundlage über die Bausteinidee hinaus. Dieser Aufwand wird leicht unterschätzt. -**Einschätzung:** Die Wahl ist **offen**. Keine Fachanforderung entscheidet sie; beide Stapel tragen die Zielarchitektur aus `03` bis `09`, die deshalb weiterhin stapelneutral formuliert ist. Unter dem gegebenen Betriebsrahmen spricht mehr für S2, **sofern** die Redaktionsanforderung WEB-005 dort mit vertretbarem Aufwand erfüllbar ist. S1 ist vorzuziehen, wenn redaktionelle Freiheit und Freigabeabläufe für Seiten hoch gewichtet werden oder der Nachweis für S2 scheitert. +**Einschätzung:** **Seit dem 15.11.2026 entschieden: Laravel 13, Filament 5, PostgreSQL (ADR-02).** Der Vergleich davor: Keine Fachanforderung entscheidet sie; beide Stapel tragen die Zielarchitektur aus `03` bis `09`, die deshalb weiterhin stapelneutral formuliert ist. Unter dem gegebenen Betriebsrahmen spricht mehr für S2, **sofern** die Redaktionsanforderung WEB-005 dort mit vertretbarem Aufwand erfüllbar ist. S1 ist vorzuziehen, wenn redaktionelle Freiheit und Freigabeabläufe für Seiten hoch gewichtet werden oder der Nachweis für S2 scheitert. **Nicht empfohlen** bleiben S4 (entspricht Variante B) und S3 (anstehender Hauptversionswechsel, kein erkennbarer Vorteil für dieses Vorhaben). diff --git a/docs/architektur/10_Technologiebewertung.md b/docs/architektur/10_Technologiebewertung.md index bbd977a..c0af452 100644 --- a/docs/architektur/10_Technologiebewertung.md +++ b/docs/architektur/10_Technologiebewertung.md @@ -29,6 +29,8 @@ ## 1. Bestandsumgebung (lesende Sichtung) ## 2. Kernanwendung: Framework und CMS +**Beschlossen am 15.11.2026 (ADR-02):** Laravel 13, Filament 5, PHP 8.4, PostgreSQL, server-gerendert. Die Tabelle bleibt der Vergleich, der zu dieser Entscheidung geführt hat. Die Urteile „Entscheidung offen“ sind damit überholt. + | Kandidat | Stand und Lizenz | Redaktion | Eignung für den Lizenzkern | Betrieb | Urteil | |---|---|---|---|---|---| | **Django + Wagtail** | Wagtail 7.4 ist LTS (05.05.2026), verlangt Django 5.2 oder neuer, Sicherheitskorrekturen bis 02.11.2027; die Linie 8.x ist erschienen (stabile Dokumentation 8.1), nächste LTS 8.3 für Mai 2027 geplant [B][1][61]. Django 5.2 LTS wird bis April 2028 gepflegt, 6.2 LTS ist für April 2027 angekündigt; ab 2028 jährliche Veröffentlichungen mit je drei Jahren Unterstützung [B][4][60]. BSD-Lizenz [E]. | Für **Seiten**: Seitenbaum, Bausteinfelder, Entwurf, Vorschau, Revisionen mit Vergleich, Freigabe-Workflows, zeitgesteuerte Veröffentlichung. Für andere Objekte sind Entwurf, Revision, Vorschau und Workflow einzeln zuschaltbar [B][55]. | relationales ORM mit Transaktionen und Datenbank-Constraints. Der Aufgabenrahmen des Frameworks liefert **keine ausführende Komponente**; eine dauerhafte Warteschlange braucht ein Zusatzpaket [B][57]. | ein Prozess plus Worker; Container | **Kandidat A** – Entscheidung offen, siehe 2.1 | diff --git a/docs/architektur/12_Entscheidungsprotokoll_ADR.md b/docs/architektur/12_Entscheidungsprotokoll_ADR.md index d431703..d9a4213 100644 --- a/docs/architektur/12_Entscheidungsprotokoll_ADR.md +++ b/docs/architektur/12_Entscheidungsprotokoll_ADR.md @@ -1,43 +1,76 @@ # 12 – Entscheidungsprotokoll (ADR) -Status aller Einträge: **vorgeschlagen**. Die Entscheidung liegt beim Auftraggeber. Kein Eintrag gibt eine Technologie als vorgegeben aus. ADRs sind Architekturvorschläge, keine Fachregeln. +**Abgleichstand:** 17.11.2026 +**Dokumentenstatus:** Konsolidiertes bestehendes ADR-Protokoll; übergreifender Abgleich mit dem Fachkonzept v1.1, den konsolidierten Fach-/Designkonzepten, den Website-/CMS-Entwürfen vom 15.11.2026 und dem dokumentierten MVP-Teststand vom 16.11.2026. **Keine neue formale Freigabe** durch diesen redaktionellen Abgleich. -**Stand nach der Challenger-Prüfung vom 14.11.2026** (`13`, Abschnitte 8 und 9): ADR-02, ADR-09 und ADR-10 sind **ersetzt**; ADR-01, ADR-11, ADR-12, ADR-14, ADR-18 und ADR-20 sind **ergänzt**; ADR-23 bis ADR-27 sind **neu**. Die übrigen wurden geprüft und unverändert beibehalten. Die frühere Fassung der ersetzten Einträge ist jeweils unter „Abgelöst“ in einem Satz festgehalten. +## Leseregel und Quellenrangfolge -| Nr. | Thema | Empfehlung in einem Satz | -|---|---|---| -| ADR-01 | Gesamtarchitektur | Integrierter modularer Kern mit Community als Satellit, mit getrennten Rechten im Innern | -| ADR-02 | Stapel des Kerns | **Offen:** Laravel + Filament oder Django + Wagtail auf PostgreSQL; Entscheidung nach abgegrenztem Machbarkeitsnachweis | -| ADR-03 | Vier Ebenen des Produktmodells | Inhalt, Lizenzartikel, Angebot, Berechtigung mit je eigener Identität | -| ADR-04 | Artikelgrenze | ausdrückliche Deklaration, keine Ableitung aus dem Inhaltsgraphen | -| ADR-05 | Berechtigung als unteilbares Bündel | Entscheidung je einzelner Berechtigung, nie Vereinigung | -| ADR-06 | Eingefrorener Bestellumfang | Kopie des aufgelösten Umfangs in der Bestellposition | -| ADR-07 | Versionierung der Lernprodukte | unveränderliche Fassungen, exakte Verweise, Kompatibilitätsbestätigung | -| ADR-08 | Veröffentlichung | Vorgang mit Vorabprüfung und atomarer Zeigerumschaltung | -| ADR-09 | Aktualisierungen | jede gültige Berechtigung deckt alle freigegebenen Fassungen ihres Artikels; keine wählbaren Anspruchsregeln | -| ADR-10 | Upgrade | zusätzlicher Erwerb mit neuer vollständiger Berechtigung; die vorhandene bleibt unverändert | -| ADR-11 | Inhaber | Person oder Organisation von Beginn an | -| ADR-12 | Community | ausgereiftes Fremdprodukt; Kern ist Identitätsgeber und führt Gruppen | -| ADR-13 | Trainerverzeichnis | im Kern, nicht in der Forensoftware | -| ADR-14 | Zahlung | Adapter; Freischaltung nur auf geprüftes Ereignis oder aktive Abfrage; aktiver Abgleich | -| ADR-15 | Streamingschutz | signierte Sitzungsadressen, kein DRM | -| ADR-16 | Medienauslieferung | austauschbarer Adapter; lokal beginnen, Auslieferungsnetz nach Schwellen | -| ADR-17 | Kennzeichnung | Stufenmodell; unsichtbares Videowasserzeichen erst nach Erprobung | -| ADR-18 | Ausgabenachweis | vor Erzeugung angelegt, für jede individuelle Ausgabe | -| ADR-19 | Hintergrundverarbeitung | datenbankgestützte Warteschlange und Postausgang | -| ADR-20 | Betrieb | Container auf einem Server; identische Anwendung in allen Stufen | -| ADR-21 | Rechnung | externer Dienst hinter Adapter | -| ADR-22 | Seiten und Katalogdarstellung | Seiten aus Bausteinen; Katalogbausteine zeigen auf Identitäten | -| ADR-23 | Berechtigungsquelle | Erwerb als individuelle Quelle je Inhaber; das allgemeine Angebot ist keine Quelle | -| ADR-24 | Medienausgabe | Gegenstand vor Recht: Ausgabe nur im Zusammenhang eines Stands; Freigabe je Datei | -| ADR-25 | Schadensbegrenzung | getrennte Rechte je Prozess, getrennte Herkunftsadressen, Verwaltung ohne Alleskönner | -| ADR-26 | Sicherung und Wiederanlauf | fortlaufend außer Haus und nur anfügbar; Sicherheitsjournal; Ziele je Schadensfall | -| ADR-27 | Ereignis und Abgleich | Ereignisse für Schnelligkeit, wiederholbarer Soll-Ist-Abgleich für Richtigkeit | +Dieses Protokoll trennt **fachlich verbindliche Regeln**, **tatsächlich belegten Iststand**, **Architekturvorschläge** und **bewusst offene Entscheidungen**. Die Formulierungen „Entscheidung“ in den historischen ADR-Abschnitten bezeichnen vielfach den ursprünglich vorgeschlagenen Lösungsweg, **nicht** automatisch eine bestätigte Betreiberentscheidung. Maßgeblich ist der jeweils vorangestellte Status. + +1. Bestätigte Fachregeln aus `01_LUF_Zielbild_und_Fachkonzept_v1.1.md`, `trainingskonzept-und-produktstruktur.md` und `produktkonfiguration-und-mitgliederbereich.md` haben Vorrang vor älteren technischen Vorschlägen. +2. `design-prinzipien.md` ist für Gestaltungsziele verbindlich. Konkrete Markenwerte, Schriften und Assets sind nur dann verbindlich, wenn freigegeben. +3. `website-cms-seo-marketing-zielkonzept.md` und `website-cms-marketing-zielarchitektur.md` vom 15.11.2026 sind **Entwürfe**, keine Implementierungsnachweise; die darin beschriebenen ADR-28 bis ADR-37 werden hier ausdrücklich nur als Vorschläge geführt. +4. `abschlussbericht-mvp-2026-11-16.md` ist ein zeitgebundener Beleg für implementierte Teile auf `develop`/`luf-test`, **keine** erfolgreiche Tor-B- oder G9-Abnahme. Spätere UX-Iterationen aus Chat/Screenshots sind nicht automatisch durch diese Datei belegt. +5. Neuere dokumentierte Tatsachen korrigieren veraltete Istbehauptungen aus älteren Architekturstudien, ohne frühere Fachentscheidungen zu überschreiben. Offene Entscheidungen bleiben offen, wenn keine ausdrückliche Bestätigung nachweisbar ist. + +**Wichtige Abgrenzungen:** Die Wahl Laravel/Filament ist im realen Bestand vollzogen (ADR-02), aber die Website-CMS-Richtung „Eigenkern mit erweitertem Builder“ steht weiterhin unter einem UX-/Prototyp-Vorbehalt (ADR-28). Die Facharten **Medien, Module, Programme, Lizenzartikel und Angebote** sind nicht gleichzusetzen. Öffentliche Listung ist nicht dasselbe wie Mitglieder-Anzeigefreigabe oder kommerzielle Angebotsaktivierung (ADR-22/29). Die Referenzen im Website-Entwurf, dass Lernziel-, Zeit- und Materialfelder noch fehlen, sind gegenüber dem MVP-Abschlussbericht vom 16.11.2026 **veraltet** (dort E-W12 als implementiert dokumentiert). + +## Übersicht der Architekturentscheidungen + +Die Statusspalte ist ein **Prüfstand**, kein Automatismus zur formalen Annahme technischer Optionen. „Fachlich fest“ bezieht sich auf die zugehörige verbindliche Fachanforderung; der konkrete technische ADR-Weg kann dennoch in Teilen vorgeschlagen sein. + +| ADR | Thema | Prüfstand (17.11.2026) | Kernaussage | +|---|---|---|---| +| ADR-01 | Gesamtarchitektur | Grundrichtung fachlich gedeckt; Community-Teil offen | Modularer Kern belegt; Community-Integration weiter geplant | +| ADR-02 | Technologiestapel | Ist-Entscheidung durch Umsetzung; Produktivabnahme offen | Laravel 13/Filament 5 realisiert; frühere offene Technologieauswahl historisch | +| ADR-03 | Produktmodell | Fachlich verbindlich; Grundstruktur implementiert | Inhalt, Komposition, Lizenzartikel, Angebot, Berechtigung strikt getrennt | +| ADR-04 | Artikelgrenze | Fachlich verbindlich; Abdeckungsprüfung implementiert | Lizenzartikelgrenze vom Betreiber; Abdeckung kontrolliert | +| ADR-05 | Rechteprüfung | Fachlich verbindlich; im Kern umgesetzt, G9 offen | Aktionen aus genau einer tragenden Berechtigung, keine Rechtevereinigung | +| ADR-06 | Kaufsnapshot | Fachlich verbindlich; technische Details nicht vollständig abgenommen | Historischen Kaufumfang und Konditionen fixieren | +| ADR-07 | Versionierung | Fachlich verbindlich; Fassungsmodell implementiert, UX in Arbeit | Freigabefassungen unveränderlich; redaktioneller Entwurfsworkflow weiter verbessern | +| ADR-08 | Veröffentlichung | Fachliche Sicherheitsanforderung; technische Atomarität nicht vollständig nachgewiesen | Neue Freigaben beschädigen keine bestehende Veröffentlichung | +| ADR-09 | Updates | Fachlich beschlossen; Produktregel verbindlich | Aktualisierungen desselben Artikels grundsätzlich enthalten; neue Artikel nicht | +| ADR-10 | Upgrade | Fachliche Schutzregel verbindlich; Upgrade-Technik nur vorgeschlagen | Kein Rechteverlust durch Upgrade; Erwerbsmechanismus noch nicht abgenommen | +| ADR-11 | Inhaber | Zielbild fachlich fest; institutioneller Betrieb später | Organisationen als Zielbild, Einzelpersonen im ersten Verkaufsschnitt | +| ADR-12 | Community | Architekturvorschlag; Community nicht umgesetzt | Community als späterer Satellit vorgeschlagen; Discourse Kandidat | +| ADR-13 | Trainerverzeichnis | Fachliches Zielbild, technische Zuordnung vorgeschlagen | Trainerverzeichnis mit geschützter Privatsphäre; Realisierung später | +| ADR-14 | Zahlung | Verbindliche Zahlungsprinzipien; Adapter nicht umgesetzt | Externer Zahlungsdienst, konkreter Adapter noch nicht gebaut | +| ADR-15 | Streaming | MVP-Teilbeleg: signiertes HLS; weitergehender Schutz offen | Signiertes HLS im Test belegt; kein DRM-Versprechen | +| ADR-16 | Auslieferung | Lokale Ausgabe belegt; austauschbares CDN/Adaptermodell nicht abgenommen | Lokale Medienausgabe vorhanden; CDN-Wechsel später | +| ADR-17 | Kennzeichnung | Teilimplementierung; forensisches Wasserzeichen offen | Kennzeichnung stufenweise; unsichtbares Wasserzeichen nicht belegt | +| ADR-18 | Ausgabenachweis | Nachweisfunktion implementiert; Manipulationsschutz nicht belegt | Ausgabenachweis im Test; Manipulationsschutz zusätzlich prüfen | +| ADR-19 | Hintergrundjobs | Queue belegt; Outbox-Garantie offen | Queue für Ableitungen vorhanden; transaktionales Outbox-Modell offen | +| ADR-20 | Betrieb | Container-Testbetrieb belegt; Produktivbetrieb offen | Container-Testbetrieb belegt; noch keine Produktivabnahme | +| ADR-21 | Rechnung | Architekturvorschlag; geschäftlich und technisch offen | Rechnungsadapter vorgeschlagen; Dienstwahl offen | +| ADR-22 | CMS/Katalog | Gemeinsames Fachprinzip verbindlich; konkrete CMS-Lösung unter Vorbehalt | CMS-Bausteine und Katalogverweise; komfortabler CMS-Ausbau noch zu erproben | +| ADR-23 | Berechtigungsquelle | Erwerbs-/Quellenprinzip fachlich gedeckt; Abo später | Erwerb als Nachweisquelle; Abo-Typ kein MVP-Fakt | +| ADR-24 | Ausgaberecht | Fachlich verbindlich; Kernprüfungen belegt, G9 offen | Geschützte Ausgabe nur mit Artikelstand, konkreter Fassung und Recht | +| ADR-25 | Schadensbegrenzung | Verbindliches Sicherheitsziel; detaillierte technische Maßnahmen vorgeschlagen | Schadensbegrenzung verbindlich; konkrete Isolation unbewiesen | +| ADR-26 | Backup/Wiederanlauf | Technischer Sicherheits- und Betriebsentwurf; Umsetzung nicht belegt | Ausfallsicherung vorgeschlagen; Wiederherstellungsnachweis offen | +| ADR-27 | Abgleich | Architekturvorschlag; teils zukünftig | Soll-Ist-Abgleich als Ergänzung zu Ereignissen vorgeschlagen | +| ADR-28 | CMS-Ausbau | Präferenz unter Vorbehalt | Eigen-CMS als bevorzugte Variante unter Editor-Prototyp-Vorbehalt | +| ADR-29 | Öffentliches Profil | Entwurf / nicht umgesetzt | Öffentliches Profil je Fachobjekt und bewusst gewählte Fassung | +| ADR-30 | Widget-Register | Entwurf / nicht vollständig umgesetzt | Registrierte Widget-Arten mit Schemaversion, Varianten und Referenzen | +| ADR-31 | Adressen/SEO | Entwurf | Anwendungsseitige Adressen, Weiterleitungen, SEO-Regeln | +| ADR-32 | Seiten-Cache | Entwurf / ungeprüft | Öffentliche Seiten ohne Sitzung und mit sicherem Cache | +| ADR-33 | Marketing | Zukunftskonzept | Marketing-Cockpit im Kern mit personenarmen Messdaten | +| ADR-34 | KI | Zukunftskonzept | KI nur als protokollierter Vorschlags-/Entwurfsschritt | +| ADR-35 | Messung | Entwurf / Rechtsprüfung offen | Reichweitenmessung ohne Cookies als Vorschlag; Prüfung offen | +| ADR-36 | Designsystem | Designprinzip fest; Tokens offen | Gemeinsame Design-Tokens für Website und Mitgliederbereich | +| ADR-37 | n8n-Anbindung | Option / nicht beschlossen | n8n allenfalls für externe Kanäle, ohne direkten Datenbankzugang | +| ADR-38 | Layoutvertrag der Widgets | Umgesetzt auf Test (18.11.2026); UX-Abnahme offen | Zulässige Rasterbreiten, Höhen und Verhalten bei wenig Platz je Widget-Art in der bestehenden Registry; Darstellung nach realer Containerbreite | +| ADR-39 | Premium-Karten mit Fachbezug | Umgesetzt auf Test (18.11.2026); gestalterische Freigabe v1.7 offen | Eine Karte je Platz im Abschnittsraster; Inhalte und Linkziel aus Thema, Medium oder Programm/Modul; keine Preise, keine Freigabe geschützter Medien | +| ADR-40 | Zentrale Medienverwaltung im CMS | Umgesetzt auf Test (19.11.2026); Abnahme offen | CMS-Bilder sind Medien des Medienmanagers (Kennung statt Pfad), öffentlich nur mit Website-Freigabe; frühere CMS-Bilder übernommen | +| ADR-41 | Gemeinsame Redaktionsbasis | Auf Test (19.11.2026, `develop` `f29ea58`); Betreiberabnahme offen. Technische Abbildung ist eine Arbeitsannahme, keine neue fachliche Freigabe | Klasse-A-Texte, Fachdimensionen und Präsentationsreferenzen an den bestehenden Fachobjekten; keine zweite Inhalts- oder Produktverwaltung | --- ## ADR-01 – Integrierter modularer Kern mit Community-Satellit +**Status am 17.11.2026:** Grundrichtung fachlich gedeckt; Community-Teil offen. +**Abgleich mit dem aktuellen Projektstand:** Der modulare Laravel-Kern ist für die Testinstanz belegt; eine Community-Integration ist weder durch den MVP-Bericht nachgewiesen noch als konkretes Forum freigegeben. Die technische Trennung von Vertrauensbereichen bleibt ein zu prüfendes Sicherheitsziel. +**Belege:** Fachkonzept VIS-004/VIS-006; Abschlussbericht 16.11., § Pakete; ADR-25. + **Kontext.** Das Zielbild verbindet Website, Katalog, Lizenzen, Kauf, Medien, Organisationen und Community. Ein kleiner Anbieter betreibt die Plattform (VIS-006). **Entscheidung.** Eine in Module gegliederte Kernanwendung mit einer Datenbank; Community als eigenständiges Produkt, schmal angebunden. **Alternativen.** Kopfloses, komponiertes System; Komposition aus Standardsoftware; vollständiger Eigenbau einschließlich Community (`02`). @@ -47,15 +80,23 @@ ## ADR-01 – Integrierter modularer Kern mit Community-Satellit ## ADR-02 – Technologiestapel des Kerns (ersetzt) +**Status am 17.11.2026:** Ist-Entscheidung durch Umsetzung; Produktivabnahme offen. +**Abgleich mit dem aktuellen Projektstand:** Der reale Kern wurde mit Laravel 13, Filament 5, PHP 8.4 und Tailwind 4 implementiert. Der frühere Technologievergleich Laravel versus Django ist damit für **den bestehenden Code** überholt; das Projekt soll nicht als technologieoffen dargestellt werden. Die Datenbankwahl PostgreSQL aus dem früheren Vorschlag ist durch die hier geprüften Belege nicht als Ist-Befund bestätigt. Es gibt nur eine Testinstanz, kein abgenommenes Produktivsystem. +**Belege:** Website-Zielarchitektur, §2 [BELEGT]; Abschlussbericht 16.11., Einleitung und Ergebnis. + **Kontext.** Redaktionsarbeitsplatz (WEB-005), Lizenzkern mit umfangreicher Verwaltung, Hintergrundverarbeitung, Medienverarbeitung; ein Betreiber mit begrenzter Wartungszeit, der Laravel/Filament aktuell betreibt und Python/PostgreSQL/Docker kennt. -**Entscheidung.** **Noch keine.** Zwei tragfähige Kandidaten: Laravel + Filament oder Django + Wagtail, jeweils auf PostgreSQL, server-gerendert. Unter dem gegebenen Betriebsrahmen spricht mehr für Laravel + Filament, sofern die Redaktionsanforderung für Seiten dort mit vertretbarem Aufwand erfüllbar ist. Das entscheidet ein abgegrenzter Machbarkeitsnachweis mit festem Abbruchkriterium (`10`, Abschnitt 2.1). +**Stand und technische Wahl.** Der frühere Kandidatenvergleich ist für das inzwischen bestehende System abgeschlossen **durch die realisierte Implementierung**: Laravel 13, Filament 5, PHP 8.4 und Tailwind 4 sind im Code dokumentiert. Das bezeichnet den Iststand, nicht eine nachträglich fingierte formale ADR-Freigabe. Django + Wagtail ist historische Alternative, nicht parallele aktuelle Umsetzung. Die konkrete Datenbanktechnologie ist mit den hier geprüften Nachweisen nicht gesichert; PostgreSQL war Teil des älteren Vorschlags. Das CMS-Erweiterungskonzept bleibt unter einem eigenen, noch zu prüfenden Editor-Prototyp-Vorbehalt (ADR-28). **Alternativen.** Next.js + Payload; FastAPI + React + Headless CMS (beide weiterhin nicht empfohlen). **Begründung.** Keine Fachanforderung entscheidet zwischen den beiden Kandidaten. Django + Wagtail bringt die Redaktion öffentlicher Seiten fertig mit und hat längere Pflegezeiträume. Laravel + Filament bringt die Verwaltungsoberflächen des Lizenzkerns (größter Einzelaufwand), die Hintergrundverarbeitung und die vorhandene Betriebserfahrung mit und vermeidet einen dritten Stapel. -**Folgen.** Stufe A0 enthält den Machbarkeitsnachweis. Die Zielarchitektur bleibt stapelneutral. Die Entscheidung ist umkehrbar bis zum Beginn der Umsetzung, danach nicht mehr mit vertretbarem Aufwand. -**Abgelöst.** Frühere Fassung: „Django + Wagtail, knapp, wegen fertiger Redaktion und Medienwerkzeugen im selben Sprachraum“. Das Medienargument hielt der Prüfung nicht stand, das Redaktionsargument nur für öffentliche Seiten (Befunde CH-52, CH-53). +**Folgen.** Für bestehende Module gelten Laravel-/Filament-Schnittstellen als realer Bestand. Eine Grundsatz-Neuentscheidung zum Stack wäre ein Migrationsprojekt, keine offene Kleinentscheidung. Kein Rückschluss auf ein abgenommenes Produktivsystem. +**Historie (abgelöst).** Ursprüngliche Empfehlung: Django + Wagtail; danach offener Vergleich mit Laravel + Filament. Die spätere tatsächliche Laravel-/Filament-Implementierung ersetzt den offenen Stackvergleich für den Bestandskern. Der redaktionelle CMS-Komfort wird gesondert nachgewiesen (ADR-28). ## ADR-03 – Vier Ebenen des Produktmodells +**Status am 17.11.2026:** Fachlich verbindlich; Grundstruktur implementiert. +**Abgleich mit dem aktuellen Projektstand:** Die Trennung von Asset, didaktischer Komposition, Lizenzartikel, Angebot und Berechtigung ist fachlich festgelegt; der MVP-Bericht dokumentiert die entsprechenden Verwaltungs- und Katalogbereiche. „Modul“ und „Programm“ sind fachliche Inhaltsarten, nicht automatisch Artikel oder Pakete. +**Belege:** Fachkonzept PROD-001–008; Produktkonfiguration §2; Abschlussbericht, Pakete 2–7. + **Kontext.** PROD-001 verbietet eine starre Hierarchie; PROD-008 verlangt eigene Rollen für Medien, Inhalte, Artikel, Pakete, Angebote. **Entscheidung.** Inhalt, Lizenzartikel, Angebot und Berechtigung sind getrennte Ebenen mit eigenen Identitäten und eigenen Lebenszyklen. **Alternativen.** Ein „Produkt“-Objekt mit Typfeld und Eltern-Kind-Beziehung. @@ -64,6 +105,10 @@ ## ADR-03 – Vier Ebenen des Produktmodells ## ADR-04 – Artikelgrenze durch ausdrückliche Deklaration +**Status am 17.11.2026:** Fachlich verbindlich; Abdeckungsprüfung implementiert. +**Abgleich mit dem aktuellen Projektstand:** Die Artikelgrenze ist eine ausdrückliche Entscheidung des Betreibers. Paket 7 der Mitgliederbibliothek enthält eine Abdeckungsprüfung; Tor B ist damit noch nicht bestanden. +**Belege:** Fachkonzept PROD-003–005; Produktkonfiguration §7; Abschlussbericht, Paket 7/Tor B. + **Kontext.** PROD-005 verlangt Auflösung auf die „kleinsten enthaltenen lizenzierbaren Artikel“. Im freien Inhaltsgraphen ist „kleinste“ nicht eindeutig, sobald sich Artikel überschneiden oder Material keinem kleineren Artikel angehört. **Entscheidung.** Lizenzartikel sind die Blätter des Paketgraphen und werden nie weiter zerlegt. Der Betreiber deklariert sie. Eine Abdeckungsprüfung meldet Material, das von keinem Artikel erfasst ist. **Alternativen.** Automatische Ableitung durch Abstieg im Inhaltsgraphen. @@ -72,6 +117,10 @@ ## ADR-04 – Artikelgrenze durch ausdrückliche Deklaration ## ADR-05 – Berechtigung als unteilbares Bündel +**Status am 17.11.2026:** Fachlich verbindlich; im Kern umgesetzt, G9 offen. +**Abgleich mit dem aktuellen Projektstand:** Berechtigungen dürfen niemals aus Teilrechten verschiedener Erwerbsquellen kombiniert werden. Der MVP implementiert getrennte Rechteprüfungen, aber der vollständige HTTP-End-to-End-Nachweis G9 steht aus. +**Belege:** Fachkonzept LIC-005/LIC-006; Produktkonfiguration §7/§11; Abschlussbericht, Pakete 3/8/9. + **Kontext.** LIC-006: keine Vermischung zu nicht erworbenen Kombinationen. **Entscheidung.** Jede Berechtigung trägt ein vollständiges Rechtebündel. Die Entscheidungsfunktion prüft jede Bedingung an **derselben** Berechtigung. Eine Vereinigung über Berechtigungen existiert im Code nicht. **Alternativen.** Wirksame Rechte als Vereinigung aller Fähigkeiten mit nachträglichen Ausschlussregeln. @@ -80,6 +129,10 @@ ## ADR-05 – Berechtigung als unteilbares Bündel ## ADR-06 – Eingefrorener Bestellumfang +**Status am 17.11.2026:** Fachlich verbindlich; technische Details nicht vollständig abgenommen. +**Abgleich mit dem aktuellen Projektstand:** Unveränderliche Kauf-/Lizenznachweise und eine historische Bestellbezeichnung sind verbindlich. Paket 1 sichert nach Bericht die Bestellbezeichnung; vollständige technische Prüfung sämtlicher Rechte-, Laufzeit- und Snapshot-Daten ist damit nicht belegt. +**Belege:** Fachkonzept PROD-006, PAY-005; Abschlussbericht, Paket 1/G8 und Tor B. + **Kontext.** PROD-006, PAY-005: Angebote und Pakete ändern sich; frühere Käufe müssen rekonstruierbar bleiben. **Entscheidung.** Die Bestellposition verweist auf die Angebotsfassung **und** trägt eine eigene Kopie des aufgelösten Umfangs einschließlich einer Kopie der Rechte, der Laufzeit und der Updatezusage. **Alternativen.** Nur Verweis auf die unveränderliche Angebotsfassung. @@ -88,6 +141,10 @@ ## ADR-06 – Eingefrorener Bestellumfang ## ADR-07 – Versionierung der Lernprodukte +**Status am 17.11.2026:** Fachlich verbindlich; Fassungsmodell implementiert, UX in Arbeit. +**Abgleich mit dem aktuellen Projektstand:** Freigegebene Fassungen und Referenzen bleiben historisch fixiert. Ein dauerhafter Bearbeitungsentwurf mit beliebig vielen Speicherungen vor einer Freigabe wurde im UX-Chat als Ziel konkretisiert; seine Umsetzung ist aus den geprüften Dateien nicht nachgewiesen. Ein Speichern im Editor darf nicht ohne Prüfung als fachlicher Release gelten. +**Belege:** Fachkonzept VER-001–010; Produktkonfiguration §4/§12; Abschlussbericht, Redaktion. + **Kontext.** VER-001 bis VER-006. **Entscheidung.** Unveränderliche Fassungen für Inhalte und Kompositionen; Kompositionen verweisen auf exakte Mitgliedsfassungen; Kompatibilitätsbestätigung ist an die Prüfsumme der Mitgliedermenge gebunden. **Alternativen.** „Aktuelle Fassung“ als gleitender Verweis; gemeinsame Versionsnummer für alle Bestandteile. @@ -96,6 +153,10 @@ ## ADR-07 – Versionierung der Lernprodukte ## ADR-08 – Veröffentlichung als Vorgang mit atomarer Umschaltung +**Status am 17.11.2026:** Fachliche Sicherheitsanforderung; technische Atomarität nicht vollständig nachgewiesen. +**Abgleich mit dem aktuellen Projektstand:** Unfertige oder fehlerhafte neue Fassungen dürfen veröffentlichte Stände nicht beschädigen. Die genaue technische Transaktionsgrenze und vollständige atomare Veröffentlichung sind in den verfügbaren MVP-Nachweisen nicht unabhängig abgenommen. +**Belege:** Fachkonzept VER-003/VER-005, ADM-003; Abschlussbericht, Tor B offen. + **Kontext.** VER-005, ADM-003, SC-18: kein halb veröffentlichter Stand. **Entscheidung.** Alle Medien liegen vor der Freigabe vollständig und unveränderlich adressiert vor; die Veröffentlichung ändert in einer Transaktion nur Zeiger und Status. **Alternativen.** Schrittweises Aktivieren einzelner Objekte. @@ -104,6 +165,10 @@ ## ADR-08 – Veröffentlichung als Vorgang mit atomarer Umschaltung ## ADR-09 – Aktualisierungen: alle freigegebenen Fassungen des Artikels (ersetzt) +**Status am 17.11.2026:** Fachlich beschlossen; Produktregel verbindlich. +**Abgleich mit dem aktuellen Projektstand:** Die Beschlüsse F-NEU-01/02 sind ausdrücklich verbindlich: Neue freigegebene Fassungen **desselben Lizenzartikels** sind während der Gültigkeit grundsätzlich enthalten; ältere zulässige Fassungen bleiben grundsätzlich verfügbar. **Neue Artikel** kommen dadurch nicht automatisch hinzu. Verfügbarkeit einzelner historischer Stände im gesamten E2E-Betrieb bleibt zu prüfen. +**Belege:** Fachkonzept VER-008/VER-010/§15; Produktkonfiguration §14; Abschlussbericht. + **Kontext.** VER-008 und VER-010 in der Fassung vom 14.11.2026 (Beschlüsse F-NEU-01, F-NEU-02): Die Updatepolitik ist entschieden. **Entscheidung.** Eine gültige Berechtigung deckt jeden freigegebenen, nicht gesperrten Stand ihres Lizenzartikels (INV-18). Es gibt keine wählbaren Anspruchsregeln. Abgelöste Stände bleiben im Regelfall verfügbar; Sperre und Rückzug sind begründungspflichtige Einzelentscheidungen. Die Updatezusage wird als fester Wert in Angebotsfassung und Bestellung festgehalten. Die Einordnung „neue Fassung“ oder „neues Produkt“ ist eine festgehaltene Betreiberentscheidung mit Begründung; der Auswirkungsbericht zeigt ihre Folgen (`06`, Abschnitt 7). **Alternativen.** (a) Wählbare Regeln je Angebot (frühere Fassung); (b) Regel nur im Code ohne festgehaltene Zusage; (c) technische Kriterien für die Produktgrenze. @@ -113,6 +178,10 @@ ## ADR-09 – Aktualisierungen: alle freigegebenen Fassungen des Artikels (erset ## ADR-10 – Upgrade als zusätzlicher Erwerb (ersetzt) +**Status am 17.11.2026:** Fachliche Schutzregel verbindlich; Upgrade-Technik nur vorgeschlagen. +**Abgleich mit dem aktuellen Projektstand:** LIC-012 verbietet unbeabsichtigte Verschlechterung erworbener Rechte. Die hier skizzierte technische Umsetzung als **zusätzlicher Erwerb mit vollständiger Berechtigung** und Abhängigkeitskennzeichen ist ein Architekturvorschlag; Preisformel, Abhängigkeit und Upgrade-Betriebsablauf sind nicht freigegeben bzw. nicht als MVP umgesetzt. +**Belege:** Fachkonzept LIC-012/LIC-011; Zukunftskonzept 16.11.; Abschlussbericht, Zurückgestellt. + **Kontext.** LIC-007, LIC-012 (Beschluss F-NEU-03), SC-09. **Entscheidung.** Ein Upgrade ist eine Bestellposition und wird zu einem eigenen Erwerb mit einer neuen, vollständigen Berechtigung. Die vorhandene Berechtigung bleibt **unverändert aktiv** (INV-19). Die Bestellposition hält fest, auf welche Berechtigung sich das Upgrade bezieht und ob es von deren Fortbestand abhängt („abhängig“ oder „eigenständig“). Fällt die Bezugsberechtigung eines abhängigen Upgrades durch Erstattung, Rückbuchung oder Widerruf weg, wird das Upgrade ausgesetzt und ein Klärungsfall angelegt (`05`, Abschnitt 8). **Alternativen.** (a) Zusatzrecht, das eine vorhandene Berechtigung ergänzt; (b) Ersetzung der Ausgangsberechtigung mit Zustand „aufgegangen“ (frühere Fassung). @@ -122,6 +191,10 @@ ## ADR-10 – Upgrade als zusätzlicher Erwerb (ersetzt) ## ADR-11 – Inhaber ist Person oder Organisation +**Status am 17.11.2026:** Zielbild fachlich fest; institutioneller Betrieb später. +**Abgleich mit dem aktuellen Projektstand:** Organisationen als eigenständige Lizenzinhaber sind Teil des Zielbilds. Der erste kommerzielle Slice darf sich auf Einzelpersonen beschränken; er darf persönliche Freischaltungen **nicht** als Organisationslizenzen ausgeben. Technische Sitzpool-/Zuweisungsdetails sind nicht als MVP-Implementierung nachgewiesen. +**Belege:** Fachkonzept ID-003/ID-004 und §15 F-NEU-04; Abschlussbericht, Zurückgestellt. + **Kontext.** ID-003, ID-004, SCOPE-003. **Entscheidung.** Berechtigungen zeigen von Beginn an auf einen abstrakten Inhaber. Sitzpool und Sitzzuweisung sind Teil des Grundmodells, auch wenn die Oberfläche später kommt. **Alternativen.** Berechtigung am Konto; Organisationen später nachrüsten. @@ -131,8 +204,12 @@ ## ADR-11 – Inhaber ist Person oder Organisation ## ADR-12 – Community als Fremdprodukt, Kern führt +**Status am 17.11.2026:** Architekturvorschlag; Community nicht umgesetzt. +**Abgleich mit dem aktuellen Projektstand:** Eine Fachcommunity ist fachlich vorgesehen; Discourse und die skizzierte Foren-Synchronisation sind Kandidaten, keine getroffene Softwarewahl. Kein Community-Betrieb wurde im MVP-Bericht nachgewiesen. +**Belege:** Fachkonzept COM-001–007; Abschlussbericht, Zurückgestellt. + **Kontext.** COM-001 bis COM-007. -**Entscheidung.** Selbst betriebene Forensoftware (Kandidat: Discourse); der Kern ist Identitätsgeber, steuert Gruppen aktiv und legt Themen je Artikel an. Kein Zustand der Community verändert Rechte im Kern. +**Architekturvorschlag.** Selbst betriebene Forensoftware (Discourse ist **Kandidat**, nicht ausgewählt); der Kern wäre Identitätsgeber und würde Gruppen steuern. Kein Zustand der Community darf die Produktrechte im Kern verändern. **Alternativen.** Eigenbau; gehostetes Produkt; anderes Forenprodukt. **Begründung.** Reife Moderations- und Kommunikationsfunktionen; schmale Kopplung; Ausfall ohne Wirkung auf Kernwege. **Folgen.** Zweiter Technologiestapel mit eigenem Aktualisierungsrhythmus; Mailversand zwingend. @@ -140,14 +217,22 @@ ## ADR-12 – Community als Fremdprodukt, Kern führt ## ADR-13 – Trainerverzeichnis im Kern +**Status am 17.11.2026:** Fachliches Zielbild, technische Zuordnung vorgeschlagen. +**Abgleich mit dem aktuellen Projektstand:** Privatsphäre und fachliche Trainerverifikation sind verbindliche Anforderungen; die konkrete Verzeichnisimplementierung im Kern ist noch Zukunftsarchitektur. +**Belege:** Fachkonzept ID-002, COM-003/COM-005; Abschlussbericht, Zurückgestellt. + **Kontext.** COM-003, COM-005, SC-22: Sichtbarkeit je Angabe, Suche darf Verborgenes nicht verraten. -**Entscheidung.** Profil, Sichtbarkeit, Verzeichnis, Suche und Kontaktanfrage liegen im Kern. +**Architekturvorschlag.** Profil, Sichtbarkeit, Verzeichnis, Suche und Kontaktanfrage liegen im Kern; genaue Ausgestaltung und Freigabe für eine öffentliche Auflistung erfordern eine spätere Implementierungsentscheidung. **Alternativen.** Nutzerverzeichnis und Standorterweiterung der Forensoftware. **Begründung.** Feines Privatsphäremodell; Verknüpfung mit dem Trainerstatus; Darstellung auch auf der Website; die geprüfte Erweiterung bietet das nicht in der nötigen Feinheit. **Folgen.** Eigenentwicklung überschaubaren Umfangs. ## ADR-14 – Zahlung hinter Adapter mit aktivem Abgleich +**Status am 17.11.2026:** Verbindliche Zahlungsprinzipien; Adapter nicht umgesetzt. +**Abgleich mit dem aktuellen Projektstand:** Ein externer Zahlungsdienst und belastbare Freischaltung sind vorgesehen. Konkreter Zahlungsanbieter, Zahlungsarten und die vollständige Adapterarchitektur sind weiterhin offen; der Bericht schließt echten Zahlungsdienst aus dem MVP aus. +**Belege:** Fachkonzept PAY-001–006; Abschlussbericht, Zurückgestellt. + **Kontext.** PAY-001, PAY-004, OPS-003, SC-24; Anbieter offen (PAY-006). **Entscheidung.** Adapter mit vier Operationen. Freischaltung nur nach signiertem Ereignis oder aktiver Statusabfrage. Eingangskorb mit eindeutiger Ereignis-ID. Regelmäßiger Abgleich der Ereignisliste und aller offenen Bestellungen. **Alternativen.** Freischaltung beim Rücksprung des Browsers; Vertrauen allein auf Wiederholungen des Dienstes. @@ -157,6 +242,10 @@ ## ADR-14 – Zahlung hinter Adapter mit aktivem Abgleich ## ADR-15 – Streamingschutz ohne DRM +**Status am 17.11.2026:** MVP-Teilbeleg: signiertes HLS; weitergehender Schutz offen. +**Abgleich mit dem aktuellen Projektstand:** Die Testinstanz spielt HLS mit signierten Playlists und Segmenten ab. Eine durchgehend sitzungsgebundene Adressvergabe oder optionale Segmentverschlüsselung ist hier nicht unabhängig nachgewiesen. Kein DRM zu versprechen. +**Belege:** Fachkonzept MED-001/MED-003; Abschlussbericht, Paket 8 und Medientest. + **Kontext.** MED-001, MED-003; MED-002 verlangt keine absolute Kopierverhinderung. **Entscheidung.** Segmentiertes Streaming über kurzlebig signierte, an eine Sitzung gebundene Adressen; optional Abschnittsverschlüsselung. **Alternativen.** Kommerzielles DRM. @@ -165,6 +254,10 @@ ## ADR-15 – Streamingschutz ohne DRM ## ADR-16 – Medienauslieferung als Adapter +**Status am 17.11.2026:** Lokale Ausgabe belegt; austauschbares CDN/Adaptermodell nicht abgenommen. +**Abgleich mit dem aktuellen Projektstand:** Die lokale geschützte Medienausgabe wird im MVP-Test beschrieben. Austauschbarkeit des Lieferadapters und Umschaltung auf ein CDN sind Zielarchitektur, nicht gegenwärtige Produktfunktion. +**Belege:** Fachkonzept MED-003/MED-006; Abschlussbericht, Pakete 6/8. + **Kontext.** OPS-001 verlangt Start auf eigenem Server; MED-006 verlangt verlässliche Wiedergabe im Kurs. **Entscheidung.** Ausgabe stellt signierte Adressen aus; wer sie bedient, ist konfigurierbar. Start lokal; Wechsel auf ein Auslieferungsnetz bei definierten Schwellen. **Alternativen.** Von Beginn an Auslieferungsnetz; dauerhaft lokal; vollständiger Videodienst. @@ -173,6 +266,10 @@ ## ADR-16 – Medienauslieferung als Adapter ## ADR-17 – Stufenmodell der Kennzeichnung +**Status am 17.11.2026:** Teilimplementierung; forensisches Wasserzeichen offen. +**Abgleich mit dem aktuellen Projektstand:** Der MVP-Bericht bestätigt Ausgabenachweis und sichtbare Lizenzzeile für Text. Ein forensisch wirksames unsichtbares Videowasserzeichen ist ausdrücklich **nicht nachgewiesen** und darf nicht vermarktet werden. +**Belege:** Fachkonzept MED-002/MED-005; Abschlussbericht, Paket 8. + **Kontext.** MED-002, MED-005, OPEN-05. **Entscheidung.** Nachweis, eingebettete Kennung und sichtbare Lizenzzeile als feste Stufen; unauffällige Dokumentmerkmale als Ergänzung; forensisches Videowasserzeichen als Option nach bestandenem Versuch. **Alternativen.** Sofortige Zusage eines unsichtbaren Videowasserzeichens; Verzicht auf individuelle Kennzeichnung. @@ -181,6 +278,10 @@ ## ADR-17 – Stufenmodell der Kennzeichnung ## ADR-18 – Ausgabenachweis vor Erzeugung +**Status am 17.11.2026:** Nachweisfunktion implementiert; Manipulationsschutz nicht belegt. +**Abgleich mit dem aktuellen Projektstand:** Der Bericht dokumentiert individuelle Ausgabenachweise. Datenbankseitige Append-only-Garantien, externe Audit-Anker sowie Wiederherstellungsbeweise sind damit nicht automatisch erfüllt. +**Belege:** Fachkonzept VER-009, SEC-003; Abschlussbericht, Paket 8; ADR-25/26. + **Kontext.** VER-009, INV-10. **Entscheidung.** Der Nachweis wird beim Anfordern angelegt und begleitet die Datei durch Erzeugung und Auslieferung. **Alternativen.** Protokollierung nach erfolgreichem Download. @@ -190,6 +291,10 @@ ## ADR-18 – Ausgabenachweis vor Erzeugung ## ADR-19 – Datenbankgestützte Hintergrundverarbeitung +**Status am 17.11.2026:** Queue belegt; Outbox-Garantie offen. +**Abgleich mit dem aktuellen Projektstand:** Eine Queue für Vorschaubild-/HLS-Ableitungen ist technisch belegt. Ob **alle** fachlichen Ereignisse transaktional und ausfallsicher in einem Outbox-Modell verarbeitet werden, ist durch die vorliegenden Quellen nicht belegt. +**Belege:** Abschlussbericht, Paket 6/Deployment; ADR-27. + **Kontext.** Medienverarbeitung, Individualisierung, Abgleich, Benachrichtigung, Community-Abgleich; OPS-003 verlangt verlustfreien Umzug offener Aufträge. **Entscheidung.** Aufträge und fachliche Ereignisse liegen in der Kerndatenbank und werden in derselben Transaktion wie die auslösende Änderung geschrieben. **Alternativen.** Eigener Warteschlangendienst. @@ -198,6 +303,10 @@ ## ADR-19 – Datenbankgestützte Hintergrundverarbeitung ## ADR-20 – Containerbetrieb auf einem Server +**Status am 17.11.2026:** Container-Testbetrieb belegt; Produktivbetrieb offen. +**Abgleich mit dem aktuellen Projektstand:** Die Testinstanz läuft als Container auf dem beschriebenen Server; ein Produktivsystem ist im Bericht nicht vorhanden. Standortausfall, Wiederanlauf und belastbare RPO/RTO sind nicht abgenommen. +**Belege:** Fachkonzept OPS-001–004; Abschlussbericht, Einleitung; ADR-26. + **Kontext.** OPS-001 bis OPS-004. **Entscheidung.** Alle Bausteine als Container mit einer Compose-Beschreibung; gesamter Zustand in Datenbank, Medienspeicher und Community-Sicherung. **Alternativen.** Direktinstallation; Orchestrierer. @@ -207,30 +316,46 @@ ## ADR-20 – Containerbetrieb auf einem Server ## ADR-21 – Rechnung über externen Dienst +**Status am 17.11.2026:** Architekturvorschlag; geschäftlich und technisch offen. +**Abgleich mit dem aktuellen Projektstand:** Die externe Rechnungs-/Zahlungsdienstwahl ist ausdrücklich noch offen. Diese Adapter-Empfehlung ist kein ausgewähltes Produkt und keine freigegebene Rechnungslösung. +**Belege:** Fachkonzept PAY-005/PAY-006; Abschlussbericht, Zurückgestellt. + **Kontext.** PAY-005; E-Rechnung zwischen Unternehmen wird verpflichtend. -**Entscheidung.** Rechnungsadapter; der Kern hält Nummer und unveränderliche Kopie. +**Architekturvorschlag.** Rechnungsadapter; der Kern hält Nummer und unveränderliche Kopie. Auswahl des externen Dienstes und konkreter Rechnungsprozess sind offen. **Alternativen.** Erzeugung im Kern; Rechnungsfunktion des Zahlungsdienstes. **Begründung.** Formatpflichten, Nummernkreise, Korrekturen und Übergabe an die Steuerberatung sind nicht Kernkompetenz der Plattform. **Folgen.** Laufende Kosten; Produktwahl mit der Steuerberatung. ## ADR-22 – Seiten aus Bausteinen, Katalogdarstellung über Verweise +**Status am 17.11.2026:** Gemeinsames Fachprinzip verbindlich; konkrete CMS-Lösung unter Vorbehalt. +**Abgleich mit dem aktuellen Projektstand:** Keine doppelte Produktdatenpflege und geprüfte Katalogverweise sind verbindlich. Bestehendes Seitensystem mit sechs Blockarten, Revision und Vorschau ist belegt; **Varianten, öffentliche Objektprofile und komfortabler Seiteneditor sind nicht allein dadurch umgesetzt**. Ausbau des Eigen-CMS ist bevorzugte Architektur **unter Vorbehalt des Editor-Prototyps**, keine ungeprüft endgültige CMS-Wahl. +**Belege:** Fachkonzept WEB-001/WEB-004; Website-Zielarchitektur §§2, 4.4–4.5, 5.3; Website-Zielkonzept §10. + **Kontext.** WEB-004, WEB-005. -**Entscheidung.** Freier Seitenbaum mit geprüfter Bausteinbibliothek; Katalogbausteine zeigen auf Identitäten und stellen den aktuell veröffentlichten Stand dar; Preise und Rechte sind auf Seiten nicht frei eintippbar. +**Fachliche Regel und Zielarchitektur.** Seiten bestehen aus geprüften Bausteinen; Katalogbausteine sollen auf Fachidentitäten zeigen und nur die öffentlich zulässige Fassung aus maßgeblichen Daten anzeigen. Preise und Rechte dürfen auf Seiten nicht als frei gepflegte Ersatzdaten geführt werden. Ein vollständig freier mehrstufiger Seitenbaum und dynamische Katalogbausteine sind **Zielumfang**, nicht als fertig belegt; die vorhandenen sechs CMS-Bausteine und Seitenrevisionen sind Istbestand. **Alternativen.** Freier Layout-Editor; feste Seitenvorlagen ohne Baukasten. **Begründung.** Konsistenz zwischen Seite, Angebot und Freischaltung; Zugänglichkeit bleibt prüfbar; Redaktion bleibt beweglich. **Folgen.** Neue Bausteintypen sind Entwicklungsarbeit. ## ADR-23 – Erwerb als individuelle Berechtigungsquelle (neu) +**Status am 17.11.2026:** Erwerbs-/Quellenprinzip fachlich gedeckt; Abo später. +**Abgleich mit dem aktuellen Projektstand:** Berechtigungsquelle und Inhaber müssen nachvollziehbar bleiben. Kostenloser Abruf und manuelle Vergabe sind im Kern angelegt; der technische „Erwerb“ aus dem ursprünglichen Architekturvorschlag darf nicht ohne Codeprüfung als exakt so implementiert gelten. **Abonnements sind offen**, kein bestehender vierter MVP-Erwerbstyp. +**Belege:** Fachkonzept LIC-001/LIC-005; Produktkonfiguration §2/§7; Abschlussbericht, Testangebot und Zurückgestellt. + **Kontext.** LIC-001, LIC-005, PAY-004; Befunde CH-01, CH-02: Die frühere „Quelle“ war je nach Fundstelle ein Angebot, eine Bestellposition oder eine Inhaberart, und ihre Eindeutigkeitsregel ließ entweder nur ein Mitglied je kostenlosem Angebot zu oder gar keine Sicherung gegen Doppelvergabe. -**Entscheidung.** Jede Berechtigung gehört zu genau einem **Erwerb** mit genau einem Inhaber. Vier Erwerbstypen: Bestellposition, freier Abruf, manuelle Vergabe, Abonnement. Eindeutig ist der Erwerb je Bestellposition bzw. je (Inhaber, kostenloses Angebot) und die Berechtigung je (Erwerb, Artikel, Rechteprofil-Fassung). Das allgemeine Angebot und die Organisation sind keine Quellen; „über Organisation X“ ist ein Zugriffsweg. +**Architekturvorschlag.** Jede Berechtigung gehört zu genau einem **Erwerb** mit genau einem Inhaber. Vorgesehen sind Bestellposition, freier Abruf und manuelle Vergabe; Abonnement bleibt eine spätere, nicht beschlossene Geschäftsoption und ist kein nachgewiesener MVP-Erwerbstyp. Eindeutig ist der Erwerb je Bestellposition bzw. je (Inhaber, kostenloses Angebot) und die Berechtigung je (Erwerb, Artikel, Rechteprofil-Fassung). Das allgemeine Angebot und die Organisation sind keine Quellen; „über Organisation X“ ist ein Zugriffsweg. **Alternativen.** (a) Inhaber in den Eindeutigkeitsschlüssel der Berechtigung aufnehmen und die Quelle beim Angebot belassen; (b) je Vergabe eine namenlose Quellenzeile ohne eigene Eindeutigkeit. **Begründung.** (a) behebt die Kollision, lässt aber die Vermengung von Angebot und Herkunft bestehen und trägt Upgrade-Bezug, Sitzpool und eingefrorene Bedingungen nicht. (b) verliert die Idempotenz. Der Erwerb ist der natürliche Träger für alles, was beim Erwerb vereinbart wurde. **Folgen.** Ein zusätzliches Objekt in der zentralen Struktur; gehört zu den nicht verhandelbaren Vorleistungen der ersten Stufe. ## ADR-24 – Gegenstand vor Recht: Ausgabe nur im Zusammenhang eines Stands (neu) +**Status am 17.11.2026:** Fachlich verbindlich; Kernprüfungen belegt, G9 offen. +**Abgleich mit dem aktuellen Projektstand:** Ausgabe nur bei zutreffendem Artikel-Stand, enthaltenem Medium und passender Berechtigung je Aktion ist fachlich verbindlich. Die lokale Testsuite deckt diese Logik nach Bericht ab; die wiederholbare HTTP-Instanzsuite und Tor B fehlen. +**Belege:** Fachkonzept MED-003, LIC-006; Produktkonfiguration §11; Abschlussbericht, Paket 8/G9. + **Kontext.** MED-003, VER-008 Nr. 4; Befunde CH-03, CH-14: Die Entscheidung prüfte das Recht, aber nicht, ob das angefragte Medium zu dem Artikel und Stand gehört, für den das Recht besteht. **Entscheidung.** Jeder Stand hält bei der Freigabe seinen fixierten Inhalt als flache, unveränderliche Liste fest. Die Entscheidung lehnt ab, wenn der Stand nicht zum Artikel oder die Inhaltsfassung nicht zu diesem Inhalt gehört. Eine Zugriffsfreigabe gilt für genau eine Datei bzw. ein Stream-Format der entschiedenen Inhaltsfassung, mit passendem Zweck (INV-17). **Alternativen.** (a) Zugehörigkeit bei jeder Anfrage durch Durchlaufen des Kompositionsgraphen ermitteln; (b) Schutz allein durch nicht erratbare Dateipfade; (c) Verschlüsselung je Artikel. @@ -239,6 +364,10 @@ ## ADR-24 – Gegenstand vor Recht: Ausgabe nur im Zusammenhang eines Stands (ne ## ADR-25 – Schadensbegrenzung innerhalb des Kerns (neu) +**Status am 17.11.2026:** Verbindliches Sicherheitsziel; detaillierte technische Maßnahmen vorgeschlagen. +**Abgleich mit dem aktuellen Projektstand:** SEC-003 verpflichtet zu begrenztem Schaden nach Kompromittierung. Zwei Datenbankrollen, getrennte administrative Herkunftsadressen, append-only auf Datenbankebene und Unterprozess-Isolation sind konkrete Architekturvorschläge; die verfügbaren Unterlagen belegen **keine vollständige Umsetzung**. +**Belege:** Fachkonzept SEC-001–004; Website-Zielarchitektur §2 (nicht geprüfte Sicherheitsfragen); Abschlussbericht. + **Kontext.** SEC-003 (Beschluss F-NEU-05); Befunde CH-37, CH-44, CH-46, CH-47: ein Prozess, ein Datenbankzugang, eine Rolle „alles“; „unveränderlich“ nur als Konvention. **Entscheidung.** Der Kern bleibt eine ausrollbare Einheit, läuft aber in getrennten Betriebsarten mit verschiedenen Rechten: Die Web-Betriebsart hat eine eingeschränkte Datenbankrolle (Auditprotokoll und Ausgabenachweis nur anfügbar, freigegebene Fassungen nicht änderbar, keine Schemaänderung) und keinen Zugriff auf Originale. Fremde Dateien werden in einem abgeschotteten Unterprozess gelesen. Website, Forum und Verwaltung haben getrennte Herkunftsadressen. In der Verwaltung gibt es keine Rolle „alles“; Rollenvergabe liegt bei einem eigenen Systemkonto; wirkungsstarke Vorgänge haben Mengengrenzen und eine Meldung außerhalb der Plattform. **Alternativen.** (a) Aufteilung des Kerns in getrennte Dienste (Variante B); (b) Verzicht auf innere Grenzen und Verlass auf Aktualisierungen und Mehrfaktor; (c) erzwungenes Vier-Augen-Prinzip. @@ -247,6 +376,10 @@ ## ADR-25 – Schadensbegrenzung innerhalb des Kerns (neu) ## ADR-26 – Sicherung außer Reichweite, Sicherheitsjournal, Ziele je Schadensfall (neu) +**Status am 17.11.2026:** Technischer Sicherheits- und Betriebsentwurf; Umsetzung nicht belegt. +**Abgleich mit dem aktuellen Projektstand:** Gesicherter Betrieb, Backups und Wiederherstellung sind Ziele, aber fortlaufende externe WAL-Protokolle, anfügebare Sicherung, Sicherheitsjournal und gemessene Wiederanlaufzeiten sind durch den geprüften MVP-Bericht nicht nachgewiesen. Keine Aussage „umgesetzt“ oder „RTO erreicht“. +**Belege:** Fachkonzept OPS-002/OPS-003, SEC-002; Abschlussbericht. + **Kontext.** OPS-002, OPS-003, SEC-002; Befunde CH-41 bis CH-45: Die Zielwerte waren für Standortverlust und Kompromittierung nicht getragen; Sicherungen waren vom Server aus zerstörbar; eine Wiederherstellung hob Sicherheitsentscheidungen auf. **Entscheidung.** (1) Ziele je Schadensfall statt eines Pauschalwerts; sie gelten erst nach einer Übung mit Zeitmessung als belegt. (2) Fortlaufendes Änderungsprotokoll der Datenbank an zwei Ziele, eines außer Haus. (3) Das Außer-Haus-Ziel ist aus Sicht des Servers nur anfügbar. (4) Eine Inhaltsfassung wird erst „bereit“, wenn ihr Original an zwei Orten bestätigt vorliegt. (5) Ein Sicherheitsjournal außerhalb des Servers hält Rückzüge, Sperren, Entzüge und Löschungen fest und wird nach jedem Zurückspielen erneut angewendet, bevor die Plattform öffnet. (6) Anker der Audit-Kette außerhalb des Servers. (7) Fehlbedienung und Kontomissbrauch werden vorwärts korrigiert, nicht zurückgespielt. **Alternativen.** (a) Zweiter, laufend gespiegelter Standort; (b) tägliche Sicherung außer Haus ohne Änderungsprotokoll; (c) sofortiger Umzug auf einen Mietserver. @@ -255,8 +388,159 @@ ## ADR-26 – Sicherung außer Reichweite, Sicherheitsjournal, Ziele je Schadens ## ADR-27 – Ereignisse für Schnelligkeit, Abgleich für Richtigkeit (neu) +**Status am 17.11.2026:** Architekturvorschlag; teils zukünftig. +**Abgleich mit dem aktuellen Projektstand:** Ereignis plus idempotenter Soll-Ist-Abgleich ist ein plausibles Muster. Für Payment- und Community-Synchronisation besteht nach dem MVP-Bericht noch keine abgeschlossene Integration; daher nicht als vorhandenes System deklarieren. +**Belege:** Fachkonzept PAY-004, COM-002; Abschlussbericht, Zurückgestellt. + **Kontext.** PAY-004, PROD-005, COM-002; Befunde CH-18, CH-21, CH-30: Mehrere Zusicherungen hingen an genau einem Ereignis und gingen verloren, wenn es fehlte, doppelt kam oder in falscher Reihenfolge eintraf. **Entscheidung.** Wo ein Anspruch aus einer Regel folgt (kostenloses Angebot, dynamische Angebotsfassung) oder ein Zustand in einem fremden System nachzuführen ist (Zahlungszustand, Gruppen und Sperren im Forum), gibt es neben dem Ereignis einen wiederholbaren, idempotenten Soll-Ist-Abgleich. **Alternativen.** Verlass auf garantierte Zustellung der Ereignisse. **Begründung.** Zustellung ist zwischen getrennten Systemen und über Ausfälle hinweg nicht garantierbar; ein Abgleich ist bei den erwarteten Mengen billig und macht Fehler selbstheilend. **Folgen.** Jede abgeglichene Operation muss idempotent sein (ADR-23 sichert das für Vergaben). Abweichungen werden behoben **und** gemeldet, nie stillschweigend. + +--- + +## ADR-28 – Ausbaurichtung des bestehenden CMS + +**Status am 17.11.2026:** Bevorzugter Architekturentwurf, **nicht abschließend freigegeben**. +**Kontext.** Das Laravel-/Filament-Seitensystem besitzt Seitenrevisionen, Vorschau und sechs Bausteinarten; Vorlagen, Abschnittsvarianten und Katalogbezug fehlen laut Code-Sichtung vom 15.11.2026. +**Vorschlag.** Den vorhandenen CMS-Kern mit Seitentypen, Vorlagen, Varianten und globalen Abschnitten erweitern (Variante D). Vor verbindlicher Entscheidung den dokumentierten kleinen Editor-Prototyp W-P mit neun Bedienaufgaben prüfen. +**Alternativen.** Statamic, Twill, freier Builder, Headless-CMS. +**Folgen und offene Prüfung.** Nur bei bestandener praktischer UX-Abnahme wird D bestätigt. Die ursprüngliche Architektur erlaubt bei Bedienproblemen einen anderen Editor unter demselben Bausteinvertrag. +**Quelle.** Website-CMS-Zielarchitektur §§4.4–4.5, 12, 14; Website-Zielkonzept §10. + +## ADR-29 – Öffentliche Fachobjektprofile + +**Status am 17.11.2026:** Architekturentwurf, **öffentliche Katalogintegration nicht nachgewiesen**. +**Kontext.** Die Bibliothek unterscheidet technische Bereitschaft, Freigabe für Mitglieder und kommerzielle Berechtigung. Öffentliche Listung ist eine zusätzliche redaktionelle Entscheidung. +**Vorschlag.** Ein schmales öffentliches Profil je Fachidentität speichert Listungszustand, Adresse, Fassungsauswahl, freigegebenes Marketingbild und SEO-Überschreibungen; Darstellung liest Fachdaten ohne Kopien. Nur ausdrücklich freigegebene und geeignete Fassungen sind öffentlich sichtbar. +**Alternativen.** Je Fachobjekt kopierte CMS-Seite; automatische öffentliche Anzeige aufgrund einer Mitgliederfreigabe. +**Folgen und offene Prüfung.** Geschützte Dateien, Lehrtexte, Trainerfragen und interne Medienadressen dürfen die öffentliche Lesesicht nicht passieren; Freigabe und Fassungswechsel benötigen Nachweise. +**Quelle.** Fachkonzept WEB-004; Produktkonfiguration §§4–5; Website-CMS-Zielarchitektur §6.2 und ADR-29-Tabelle. + +## ADR-30 – Erweiterbares Baustein-/Widget-Register + +**Status am 17.11.2026:** Technisch konkretisierter **Vorschlag**; vollständige Umsetzung nicht belegt. +**Kontext.** Ein Seiteneditor muss statische Inhalte, kuratierte Katalogbezüge und später regelbasierte Listen tragen, ohne ein zweites Produktdatenmodell einzuführen. +**Vorschlag.** Codebasiertes Register mit `id`, `type`, `v`, `variant`, `settings`, `data`, `refs`; jeder Widget-Typ liefert eigenes Bearbeitungsschema, Validierung, freigegebene Darstellungsvarianten, Blade-Ansicht und sichere Auflösung von Verweisen. Eine neue Widget-Art ist Entwicklungsarbeit; Redaktion konfiguriert Instanzen und wählt bestehende Varianten. +**Alternativen.** Jede Widget-Art direkt in den zentralen Editor verdrahten; frei installierbare Laufzeit-Plugins; frei eingebbares HTML/JavaScript. +**Folgen und offene Prüfung.** Alte CMS-Revisionen bleiben lesbar (Schema-Aufwärtsfunktion), Vorschaubild und öffentliche Darstellung verwenden dieselbe Rendererlogik; Editor-UX ist praktisch nachzuweisen. Keine beliebige Ausführung von Code durch Redakteure. +**Quelle.** Website-CMS-Zielarchitektur §§5.3–5.4 und ADR-30-Tabelle; Website-Zielkonzept §10.3–10.5. Die weitere UX-Präferenz aus der laufenden Fachabstimmung ist **keine** Freigabe eines beliebigen Plugin-Systems. + +## ADR-31 – Öffentliche Adressen, Weiterleitungen und Indexierung + +**Status am 17.11.2026:** Architekturentwurf, Umsetzung nicht abgenommen. +**Kontext.** Die vorhandene öffentliche Seitenauflösung kann laut Sichtung nur ein Pfadsegment auflösen; fachliche Objektseiten benötigen konsistente Adressen. +**Vorschlag.** Anwendungsgesteuerte Adressauflösung mit reservierten Präfixen, Weiterleitungen und `robots`-/Indexierungsregeln je Seitentyp und Umgebung. +**Alternativen.** Manuelle Proxy-Regeln; feste Seitenadressen ohne Weiterleitungsverwaltung. +**Folgen und offene Prüfung.** Keine versehentliche Indexierung geschützter/Testseiten; SEO-Regeln und Pfadänderungen sind zu testen. +**Quelle.** Website-CMS-Zielarchitektur §7, ADR-31-Tabelle. + +## ADR-32 – Sitzungsfreie öffentliche Seitenauslieferung + +**Status am 17.11.2026:** Architekturentwurf; Sitzungsfreiheit und Cache-Entwertung nicht nachgewiesen. +**Kontext.** Öffentliche Seiten sollen unabhängig vom jeweiligen Mitgliedszustand auslieferbar sein; geschützte Bibliotheksausgaben nicht. +**Vorschlag.** Öffentliche Seiten serverseitig ohne Sitzung und für Gäste/Mitglieder identisch rendern, zwischenspeichern und bei relevanten redaktionellen oder Katalogereignissen gezielt entwerten. Anfragen/Formulare laufen getrennt. +**Alternativen.** Personalisierte öffentliche Seiten; Proxy-Cache als einzige Ebene. +**Folgen und offene Prüfung.** Die Freigabeänderung muss die öffentliche Sicht sofort wirksam machen; keine Mitglieder- oder Lizenzdaten in öffentlichen Caches. +**Quelle.** Website-CMS-Zielarchitektur §§5.5–5.6 und ADR-32-Tabelle. + +## ADR-33 – Marketingsteuerung als Modul des Kerns + +**Status am 17.11.2026:** Zukunftskonzept, kein MVP-Implementierungsauftrag. +**Kontext.** Marketingauswertung benötigt konsistente Fachbezüge, sollte aber keine zusätzliche personenbezogene Schattenverwaltung erzeugen. +**Vorschlag.** Marketing-Cockpit mit aggregierten Such- und Seitenwerten, Befunden, Maßnahmen und Wirkungsnotizen im Kern. +**Alternativen.** n8n als führende Steuerung; separates Marketing-System. +**Folgen und offene Prüfung.** Messbedarf und Datenschutz vor Implementierung entscheiden; es werden keine abgeschlossenen Marketingfunktionen behauptet. +**Quelle.** Website-Zielkonzept §12; Website-CMS-Zielarchitektur §§8–9, ADR-33-Tabelle; Abschlussbericht, Zurückgestellt. + +## ADR-34 – Kontrollierter KI-Einsatz in der Redaktion + +**Status am 17.11.2026:** Zukunftskonzept, kein MVP-Implementierungsauftrag. +**Kontext.** KI-generierte Texte und Recherchen dürfen keine ungeprüften fachlichen oder rechtlichen Aussagen veröffentlichen. +**Vorschlag.** Abgegrenzte, protokollierte KI-Arbeitsschritte mit Modelladapter; die Ausgabe bleibt Vorschlag oder redaktioneller Entwurf bis zur menschlichen Prüfung. +**Alternativen.** Selbstständig publizierender Agentenverbund; unprotokollierte KI-Texterzeugung. +**Folgen und offene Prüfung.** Anbieter, zulässige Aussagen, Quellenprozess, Datenschutz und redaktionelle Freigabe gesondert festlegen. +**Quelle.** Website-Zielkonzept §12; Website-CMS-Zielarchitektur §9, ADR-34-Tabelle. + +## ADR-35 – Messung der Website-Nutzung + +**Status am 17.11.2026:** Messkonzept vorgeschlagen; rechtliche Bewertung und Realisierung offen. +**Kontext.** Der Plattformbetreiber benötigt belastbare Hinweise auf Nutzung und Nachfrage, ohne unnötig personenbezogene Daten zu sammeln. +**Vorschlag.** Aggregierte, möglichst cookielose eigene Ereigniszählung; für Suchdaten externe Schnittstellen, soweit tatsächlich verfügbar. +**Alternativen.** Selbst betriebenes Analysewerkzeug; Drittanbieter. +**Folgen und offene Prüfung.** Keine pauschale Rechtsbehauptung „ohne Cookies = immer einwilligungsfrei“. Datenschutz und technische Parameter vor Aktivierung prüfen. +**Quelle.** Website-Zielkonzept §§11–12; Website-CMS-Zielarchitektur §8, ADR-35-Tabelle. + +## ADR-36 – Gemeinsames Designsystem + +**Status am 17.11.2026:** Gestaltungsgrundsätze verbindlich; konkrete Tokens und Schriften nur nach Markenfreigabe. +**Kontext.** Website, Mitgliederbibliothek und Inhaltsverwaltung sollen keine widersprüchlichen Marken- und Inhaltsdarstellungen entwickeln. +**Vorschlag.** Gemeinsame zweistufige Design-Tokens (Markenwerte und semantische Werte) im Repository; dieselbe zugelassene Farb-/Typografiebasis und abgestimmte Karten-/Dialogmuster für öffentliche und geschützte Ansichten. Markenwerte werden erst nach Prüfung der Originalassets freigegeben. +**Alternativen.** Je Bereich eigene Styles; frei pflegbare Werte im CMS bereits im MVP. +**Folgen und offene Prüfung.** Änderungen an Markenwerten brauchen bewusstes Review, Kontrastprüfung und Sichtprüfung in 390/768/1440 px. Die konkrete Verwaltungs-UX darf funktional anders ausfallen als die Marketingseite, aber Fachbegriffe und Präsentationsdaten bleiben konsistent. +**Quelle.** Designprinzipien §§5–13; Website-Zielkonzept §7; Website-CMS-Zielarchitektur §5.5, ADR-36-Tabelle. + +## ADR-37 – Optionale externe Workflow-Anbindung + +**Status am 17.11.2026:** Option für spätere externe Kanäle, keine beschlossene Umsetzung. +**Kontext.** Externe Kanäle können Integrationen benötigen, dürfen aber weder Fach- noch Katalogregeln übergehen. +**Vorschlag.** n8n allenfalls für Anbindungen fremder Kanäle über eine eng begrenzte, geprüfte Schnittstelle, ohne direkten Datenbankzugang und ohne führende Produktlogik. +**Alternativen.** Keine externe Workflow-Engine; n8n als allgemeine Produktsteuerung. +**Folgen und offene Prüfung.** Umsetzung erst bei konkret nachgewiesenem Kanalbedarf. +**Quelle.** Website-Zielkonzept §12; Website-CMS-Zielarchitektur §9, ADR-37-Tabelle. + +## ADR-38 – Gemeinsamer Layoutvertrag für Widget-Arten + +**Status am 18.11.2026:** Umgesetzt auf `develop`/Testinstanz (Branch `feature/adaptive-widgets`); **UX-Abnahme durch den Betreiber offen**. Ergänzt ADR-30, ersetzt es nicht. +**Kontext.** Das Abschnittsraster (vier logische Einheiten, ein Widget je Platz) verteilte Widgets bisher nur mit einer Mindestbreite. Das Brand-UI-Kit v1.6 (`12_premium_widgets_adaptiv_v1.6`) verlangt für die Premium-Widgets bestimmte Rasterbreiten (Einstieg 3–4, Bild und Text 1–4), Höhenvarianten und eine Darstellung nach realer Containerbreite. +**Entscheidung.** Jede Widget-Art erklärt in der bestehenden Registry (`WidgetType`) einen gemeinsamen Layoutvertrag: +- `supportedUnits()`: zulässige Platzbreiten aus 1–4; ein Platz mit anderer Breite wird beim Speichern mit verständlicher Meldung abgewiesen; `minUnits()` ist daraus abgeleitet. +- `heights()`: angebotene Höhen aus einem gemeinsamen Vokabular (`auto`, `compact`, `normal`, `large`, `spacious`, `fill`), gespeichert als `settings.height`, geprüft wie jede Einstellung; Höhen sind Mindestwerte oder Proportionen, nie Begrenzungen. +- `stages()` und `narrowBehavior()`: Darstellungsmodi und Verhalten bei reduziertem Platz, im Editor angezeigt. +Die Widget-Ansichten entscheiden über Container-Abfragen nach der tatsächlichen Breite, nicht nach der Einheitenzahl. Keine zweite Registry, kein zweites Abschnittsmodell, keine freien CSS-Werte. +**Alternativen.** Je Widget eigene Breitenlogik im Editor; feste Pixelhöhen; Höhe als Abschnittseinstellung (verworfen: doppelte, widersprüchliche Einstellmöglichkeit neben Abstand und Raster). +**Folgen und offene Prüfung.** Premium-Einstieg (`hero` Version 2) und Bild und Text (`image_text` Version 3) heben ältere Instanzen beim Lesen an; gespeicherte Revisionen bleiben unverändert. Ein Einstieg in einem Platz mit 2 Einheiten ist nicht mehr zulässig (vorher Mindestbreite 2; auf der Testinstanz kein Bestand betroffen). Bewusste Abweichungen vom Kit: Bildfokus als `data.focus_x/focus_y` (Einstellungen tragen nur Aufzählungswerte), Überschriftenebene „Automatisch/H2/H3“ statt freier H1 (genau eine H1 je Seite), Linkziele über die bestehende `SafeUrl`-Regel. Praktische Redaktionsabnahme (Bedienung, Bildzuschnitte mit freigegebenen Motiven) steht aus. +**Quelle.** Brand-UI-Kit v1.6 (`docs/Brand-UI-Kit/12_premium_widgets_adaptiv_v1.6`, `docs/layout-profiles.json`); `docs/architektur/cms-widget-registry.md` §§2, 4, 12; ADR-30, ADR-36. + +## ADR-39 – Premium-Karten mit Fachbezug + +**Status am 18.11.2026:** Umgesetzt auf `develop`/Testinstanz (Branch `feature/premium-karten`). **Gestalterische Freigabe des Kits v1.7 offen** (`13_premium_karten_v1.7_entwurf/docs/FREIGABE.md`: alle drei Varianten „zur visuellen Freigabe“). Ergänzt ADR-30 und ADR-38. +**Kontext.** Das Brand-UI-Kit v1.7 liefert drei Kartenvarianten (redaktionelle Themenkarte, Medien- und Materialkarte, Modul- und Programmkarte) als reine Darstellungskomponente mit eigenem Beispielraster. Im CMS sollen Redakteure diese Karten in regulären Abschnitten einsetzen, mit bestehenden Fachobjekten verbinden und gestalten, ohne Titel, Medienangaben, Programme oder Module zu kopieren und ohne geschützte Inhalte freizugeben. +**Entscheidung.** +- Drei Widget-Arten in der bestehenden Registry (`topic_card`, `media_card`, `program_card`) auf einer gemeinsamen Basis (`PremiumCardWidget`) mit einer Ansicht (`widgets/premium_card.blade.php`). Eine Karte je Widget, ein Widget je Platz; Spalten und Abstände bestimmt das Abschnittsraster. Das Beispielraster des Kits wird nicht übernommen. +- `refs` speichert genau eine Kennung (Thema `pillar`, Inhaltselement `element`, Komposition `composition`) und optional ein Bild aus dem öffentlichen Website-Bereich. Titel, Kurzbeschreibung, Art, Zusatzangaben und Linkziel werden bei jeder Darstellung aus den Fachdaten gelesen. Redaktionell sind nur Bild, Alternativtext, Bildausschnitt, Beschriftung der Aktion und ein kurzer Hinweis. +- Linkziel nur aus dem Fachobjekt: Themenseite eines veröffentlichten Themas, Programmseite eines öffentlichen Programms. Kein freies Linkziel, kein Download, kein Abspielen, kein Preis, keine Kaufaktion. +- Sichtbarkeit (Übergangsregel bis ADR-29): Themen nur veröffentlicht; Programme nach `PublicCatalogReader`; Module nur in der Redaktionsvorschau; Medien und Materialien öffentlich nur, wenn sie zur gezeigten Fassung eines öffentlichen Programms gehören (dort sind sie heute schon öffentlich genannt), sonst nur in der Redaktionsvorschau (`PublicMaterialReader`). Von Medien wird keine Kurzbeschreibung gezeigt. +- Gleiche Höhe je Zeile über die gemeinsame Höhe `fill` (ADR-38). Für gemischte Raster sind die Abschnittsraster 1 + 1 + 2 und 2 + 1 + 1 ergänzt (additiv, bestehende Kennungen unverändert). +**Alternativen.** Ein Widget mit mehreren Karten und eigenem Spannweitenraster (verworfen: zweites Kartenraster neben dem Abschnittsraster); eine Widget-Art mit Variante je Fachobjekt (verworfen: Verweisschema hinge von der Variante ab); redaktionell gepflegte Kartentexte (verworfen: Kopien von Fachdaten); Vorschaubilder der Bibliothek als Kartenbild (verworfen: geschützt, Paket 6). +**Nachbesserung (18.11.2026, nach Betreiberprüfung).** Themenkarten bieten alle Säulen an (nicht veröffentlichte nur für die Redaktionsvorschau). Medienkarten zeigen die Kurzbeschreibung des Mediums (auf ausdrücklichen Wunsch), unterscheiden Film (Filmtafel) und Material (Materialsymbol) und zeigen das geschützte Vorschaubild der Bibliothek nur in der Redaktionsvorschau. Traineranleitungen erscheinen nie öffentlich. Programm-/Modulkarten nutzen Lernziel und Dauer und lassen Programme/Module ohne Anzeigefreigabe für die Vorschau zu. Fehlende Inhalte erscheinen nur in der Vorschau als Hinweise. +**Offene Entscheidungen.** (1) Freigabe von Vorschaubildern für die Website und öffentliche Filmvorschauen (minimaler Erweiterungsbedarf in `cms-widget-registry.md` §13). (2) Ob bei Traineranleitungen schon der Titel auf der Programmseite öffentlich sein soll (Programmseite, nicht Karte). +**Folgen und offene Prüfung.** Keine Migration; bestehende Seiten und Widgets unverändert (gemessen). Mit ADR-29 ersetzen öffentliche Profile die Übergangsregeln in `PublicCatalogReader` und `PublicMaterialReader`; die gespeicherten Karten ändern sich dadurch nicht. Offen: gestalterische Freigabe v1.7, freigegebene Motive statt Platzhaltern, eine kaufbare Angebotskarte (eigenes Fachobjekt „Angebot“ mit Umfang, Zweck und Lizenzbedingungen, nicht Teil dieser Karten). +**Quelle.** Brand-UI-Kit v1.7 (`docs/Brand-UI-Kit/13_premium_karten_v1.7_entwurf`, README, `docs/design-config.json`); `docs/architektur/cms-widget-registry.md` §§4, 6, 11, 13; ADR-29, ADR-30, ADR-38. + +## ADR-40 – Zentrale Medienverwaltung im CMS + +**Status am 19.11.2026:** Umgesetzt auf `develop`/Testinstanz (Branch `feature/cms-medienverwaltung`); Abnahme durch den Betreiber offen. Baut auf der Website-Freigabe des Medienmanagers auf (`medienzugriff-fuer-komponenten.md`). +**Kontext.** Das CMS hatte eine eigene Bildablage (`cms/`, `PublishPublicMedia`). Redakteure sollen Bilder im Medienmanager, im Modul-/Programmeditor und in CMS-Widgets aus demselben Bestand verwenden; öffentlich darf nur erscheinen, was für die Website freigegeben ist. +**Entscheidung.** Alle Bildstellen (Einstieg, Bild und Text, redaktionelle Karten, Premium-Karten, Abschnittshintergrund) speichern die Kennung des Inhaltselements im bisherigen Bildschlüssel `image` und lesen über `WebsiteMedia`. Uploads im Widget-Dialog laufen über `WebsiteIntake`. Frühere CMS-Bilder werden per Warteschlangen-Job übernommen (dedupliziert, nichts gelöscht) und über `website_media_aliases` zugeordnet; die Zuordnung wird erst nach der ersten Website-Freigabe wirksam. Ein nicht freigegebenes Bild entfällt öffentlich, das Widget bleibt. +**Alternativen.** Schlüssel `refs.element` wie im Dokument (verworfen: kollidiert mit dem Fachobjekt der Medienkarte); Revisionen per Migration umschreiben (verworfen: Revisionen bleiben unverändert, Rollback); jedes Widget bei fehlender Freigabe ausblenden (verworfen: entfernt Überschriften und H1). +**Entscheidung zur fehlenden Freigabe (19.11.2026).** Wird die Website-Freigabe zurückgenommen, wird das Medium nicht mehr öffentlich ausgeliefert. Überschriften, Texte und übrige Widget-Inhalte bleiben. Ein Widget, das danach keinen darstellbaren Inhalt mehr hat, entfällt. Ein reines Medienwidget ohne Medium gehört dazu. Die Redaktionsvorschau darf das nicht freigegebene Bild weiter mit Hinweis zeigen. +**Folgen und offene Prüfung.** Rollback zeigt nach der Umstellung gespeicherte Bilder nicht (Registry §9). Website-Bilder werden bis 2400 px abgeleitet. Offen bleiben: übernommene Medien tragen Dateinamen als Titel und keine Quellenzeile; ein unter `cms/` liegendes Originalmotiv (`lara-felix-park-original`) wurde mit übernommen und ist damit ein freigegebenes Medium – prüfen und gegebenenfalls zurücknehmen. +**Quelle.** `docs/architektur/medienzugriff-fuer-komponenten.md`; `cms-widget-registry.md` §§7, 9; ADR-30, ADR-38, ADR-39. + +## ADR-41 – Gemeinsame redaktionelle Informationsbasis + +**Status am 19.11.2026:** Auf der Testinstanz (`develop` `7b325f0`, Deploy-Lauf 4868). `PresentationMediaTest` und `EditorialDeskTest` sind grün. **Keine formale Freigabe** durch diesen Eintrag. Die technische Abbildung ist eine Arbeitsannahme aus dem vorhandenen Bestand, soweit unten nicht als Entscheidung gekennzeichnet. +**Kontext.** Redaktionelle Texte, fachliche Auffindbarkeit und Präsentationsmedien sollen an Medium, Modul, Programm und Lizenzartikel gepflegt und von Website, CMS und Verwaltung aus derselben Quelle gelesen werden. Medien, Module, Programme, Lizenzartikel und Angebote bleiben getrennte Fachobjekte (ADR-03, ADR-04). Öffentliche Profile (ADR-29) sind nicht entschieden. Die Website-Freigabe bleibt die von ADR-40. +**Entscheidung (Arbeitsannahme, am Bestand geprüft).** +- Klasse A bleibt an den vorhandenen Feldern: Arbeitstitel bzw. Bezeichnung, Anzeigename, Kurzbeschreibung (`summary`), ausführliche Beschreibung. Neu und leer nachrüstbar sind `teaser` und `search_terms`. Ein Lizenzartikel trägt dieselben Felder als eigene Abweichung. Leer heißt: der Wert wird nicht kopiert, sondern über die eindeutige Wurzel des aktuellen Artikelstands gelesen (`EditorialProfileReader`). Zwei Wurzeln oder keine Wurzel ergeben keine Ableitung. +- Abweichende Formulierungen stehen nur als einzelne Variante (`editorial_text_variants`: Feld und Kontext). Es gibt keine zweite Stammdatenkopie je Zielgruppe. +- Die fachliche Materialart bleibt `editorial_content_kinds`. Ergänzt wurden Unterrichtsfilm, Kurzfilm, Trailer, Interview, Arbeitsblatt, Übungsbeschreibung, Titelbild, Hintergrundbild, Präsentationsbild und Audioanleitung. Der redaktionelle Verwendungszweck, Altersbereiche und Einsatzbereiche sind Werte der vorhandenen Dimensionen und mehrfach zuordenbar. Sie geben nichts frei. +- Präsentationsmedien sind Referenzen (`presentation_assignments`) auf die Medienidentität, nicht auf eine Inhaltsfassung. Bilder, Filme und Hörstücke können ohne fachliche Fassung im Medienmanager liegen. `preview_path` hält bei Film und Hörstück die technische Ableitung unter `teaser/`. Eine Zuordnung speichert die Kennung des Mediums. `source_version_id` bleibt leer, solange niemand ausdrücklich eine Inhaltsfassung hinterlegt. Eine neuere Fassung markiert eine solche Bindung als veraltet und erzeugt keinen neuen Clip. Die Zuordnung legt keine Fassung an, erteilt kein Recht und nimmt das Medium nicht in einen Aufbau auf. +- **Bisherige Abhängigkeit der Website-Videoauslieferung.** `WebsiteRelease` hat einen Film nur freigegeben, wenn eine bereitgestellte Inhaltsfassung eine `MediaRendition` der Rolle `preview` unter `teaser/` trug. Ein Teaser ohne Fassung blieb damit unfreigebbar. Bilder waren davon unabhängig und nutzen das Vorschaubild am Medium. **Anpassung:** Liegt `preview_path` am Medium, gibt die Website-Freigabe diese Ableitung frei, ohne eine Inhaltsfassung zu erzeugen oder vorauszusetzen. Hat ein Film keine solche Datei, bleibt der bisherige Weg über die bereitgestellte Fassung bestehen. Zurücknehmen löscht nur die öffentliche Kopie. Originale, Master und Traineranleitungen bleiben gesperrt. +- Programm- und Medienkarten lesen Teaser oder Kurzbeschreibung zur Laufzeit. `data.heading` und `data.summary` einer Karte sind eine lokale Abweichung. Ein leeres Kartenbild nimmt das zugeordnete Titelbild, öffentlich nur über `WebsiteImage`. +**Nicht entschieden.** Eine verwaltbare Liste zulässiger Objekttypen je Dimension (die Tabelle führt sie nicht; Inhaltselemente blenden nur die Dimension „Fachliche Säule“ aus, weil Themen dort über die Säulen gepflegt werden). Ob ein öffentliches Profil (ADR-29) die Kartenregeln ersetzt. Ob freie Suchbegriffe später eine verwaltete Schlagwortdimension werden. Die Frage, ob bei zurückgenommener Freigabe das ganze Widget entfällt, ist entschieden, siehe ADR-40. +**Folgen.** Klasse B (Fassungen, Lernziele, Mitglieder) und Klasse C (Angebote, Rechte, Bestellstände) werden von dieser Pflege nicht geschrieben. Bestehende Thumbnails, CMS-Kennungen und Revisionen bleiben. Ein Code-Rollback vor dieser Migration lässt die neuen Spalten liegen; die Anwendung davor kennt sie nicht. +**Quelle.** Auftrag gemeinsame Redaktionsverwaltung; `medienzugriff-fuer-komponenten.md`; `cms-widget-registry.md`; ADR-03, ADR-07, ADR-22, ADR-29, ADR-39, ADR-40. + diff --git a/docs/architektur/13_Risiken_Annahmen_offene_Entscheidungen.md b/docs/architektur/13_Risiken_Annahmen_offene_Entscheidungen.md index d353982..2d4c692 100644 --- a/docs/architektur/13_Risiken_Annahmen_offene_Entscheidungen.md +++ b/docs/architektur/13_Risiken_Annahmen_offene_Entscheidungen.md @@ -105,7 +105,7 @@ ## 4. Offene fachliche Entscheidungen | OPEN-05 | Co-Branding- und Kennzeichnungsverfahren | Stufen K0–K4; Tiefe des Video-Brandings | Stufenmodell | K0–K2 vor A2; K4 nach Versuch | | OPEN-06 | Zahlungs-, Rechnungs-, Steuerweg | direkter Zahlungsdienst mit eigener Rechnungsstellung / Verkäufermodell (`10`, Abschnitt 6 und 7) | Adapter | **früh**: vor Beginn der Umsetzung von A1, nach Steuerberatung | | OPEN-07 | Community-Sichtbarkeit, Kontakt, Moderation | öffentlich lesbar oder nur Mitglieder; Kontaktwege; Moderationsteam | Konfiguration je Bereich und je Profilangabe | vor A3 | -| OPEN-08 | Konkrete Technologien | `10` | ADR-02, ADR-12, ADR-14, ADR-16 | Kernstapel vor A0-Abschluss | +| OPEN-08 | Konkrete Technologien | `10` | ADR-12, ADR-14, ADR-16 bleiben offen. **ADR-02 ist am 15.11.2026 beschlossen** (Laravel 13, Filament 5, PostgreSQL) | Kernstapel erledigt | | E-09 | Dürfen Verbraucher kaufen? | ja mit Widerrufsablauf / nur Unternehmer | Kundenart an der Bestellung | vor A1 | | E-10 | Verhalten kostenloser Berechtigungen bei Angebotsende (L-04) | dauerhaft / solange aktiv / befristet | Laufzeitregel | vor dem ersten kostenlosen Angebot | | E-11 | Teilerstattung von Paketen (L-06) | Positionswahl / Kulanz ohne Rechteänderung | geführter Vorgang | vor A2 | @@ -115,7 +115,7 @@ ## 4. Offene fachliche Entscheidungen | E-15 | Umgang mit geladenen Dateien nach Ablauf oder Erstattung (L-13) | Weiternutzung / Löschpflicht | Vertragstext; Nachweis | vor A2 | | E-16 | Aufbewahrungsfristen für Nachweise und Protokolle | `11`, Abschnitt 8.3 | Konfiguration | vor A1 | | E-17 | Vier-Augen-Prinzip für Freigabe und manuelle Vergabe | aus / an | Konfiguration | jederzeit änderbar | -| E-18 | Kernstapel: Laravel + Filament oder Django + Wagtail | Entscheidung nach dem Machbarkeitsnachweis mit Abbruchkriterium (`10`, Abschnitt 2.1; `02`, Abschnitt 8) | ADR-02 | vor Beginn von A1 | +| E-18 | Kernstapel | **Entschieden am 15.11.2026:** Laravel 13, Filament 5, PHP 8.4, PostgreSQL | ADR-02 | erledigt | | E-19 | Kriterien des Betreibers für „neue Fassung desselben Artikels“ gegen „eigenständiges neues Produkt“ (VER-010) | eigene Kriterienliste; Orientierung in `06`, Abschnitt 7.2 | Einordnungspflicht mit Begründung; Auswirkungsbericht | vor der ersten Überarbeitung eines verkauften Artikels | | E-20 | Sind auch Stände zugänglich, die vor dem Erwerb abgelöst wurden (Annahme A-14)? In welchen Fällen wird bei der Sperre einer Altfassung aktiv informiert? | ja / nur ab Erwerb; je Vorgang entschieden | eine Bedingung; Benachrichtigung je Vorgang | vor der ersten Überarbeitung eines verkauften Artikels | | E-21 | Upgrades: Preisformel; abhängig oder eigenständig je Upgrade-Angebot; Laufzeit im Verhältnis zur Ausgangslizenz (LIC-012 lässt das offen) | Differenzpreis mit Abhängigkeit / Vollpreis eigenständig | Bedingung in Angebotsfassung und Bestellung (`05`, Abschnitt 8.2) | vor A2 | @@ -123,7 +123,7 @@ ## 4. Offene fachliche Entscheidungen | E-23 | Sollen Institutionen schon vor Stufe A4 bedient werden? | (a) nein, bis A4 warten; (b) A4 vorziehen; (c) Institution bezahlt klar so benannte **persönliche** Lizenzen namentlich bestimmter Trainer, die beim Trainer bleiben | Angebotsfassung trägt die Inhaberart; keine Organisationsangebote im ersten Schnitt | vor dem ersten Anliegen einer Institution | | E-24 | Community-Produkt und Betriebsform (selbst betrieben oder gehostet) | `10`, Abschnitt 4 | ADR-12 | vor A3, nach dem kleinen Nachweis aus `10`, Abschnitt 11 Nr. 2 | -**Früh nötige Geschäftsentscheidungen** (LIC-011 verlangt deren Benennung): OPEN-06 mit Steuerstatus, E-09 Kundenkreis, OPEN-03 Lizenztypen und Preise der ersten Angebote, E-22 Wiederherstellungsziele, E-18 Kernstapel. Die Updatepolitik (früher OPEN-01) ist entschieden und steht nicht mehr auf dieser Liste. +**Früh nötige Geschäftsentscheidungen** (LIC-011 verlangt deren Benennung): OPEN-06 mit Steuerstatus, E-09 Kundenkreis, OPEN-03 Lizenztypen und Preise der ersten Angebote, E-22 Wiederherstellungsziele. Die Updatepolitik (früher OPEN-01) und der Kernstapel (E-18, 15.11.2026) sind entschieden und stehen nicht mehr auf dieser Liste. ## 5. Wie weit trägt die technische Planung ohne die Geschäftsentscheidungen? @@ -139,7 +139,7 @@ ## 5. Wie weit trägt die technische Planung ohne die Geschäftsentscheidungen? | Betrieb | vollständig nach Bestandsprüfung | Zielhöhe der Wiederherstellung (E-22) | | Sicherheit | Grenzen, Rollen, Negativtests vollständig | – | -Keine offene Geschäftsregel verhindert den Beginn der Umsetzung. Mehrere verhindern den **Verkaufsstart**. Vor dem Beginn von Stufe A1 steht allein die Wahl des Kernstapels (E-18). +Keine offene Geschäftsregel verhindert den Beginn der Umsetzung. Mehrere verhindern den **Verkaufsstart**. Die Wahl des Kernstapels (E-18) ist am 15.11.2026 getroffen. ## 6. Ehrliche Aufwandseinordnung diff --git a/docs/architektur/15_Roadmap.md b/docs/architektur/15_Roadmap.md index 1e77c24..ab51b07 100644 --- a/docs/architektur/15_Roadmap.md +++ b/docs/architektur/15_Roadmap.md @@ -35,8 +35,8 @@ ### A0 – Fundament und Nachweise | Arbeitspaket | Ergebnis | |---|---| | Bestandsprüfung am Server (lesend): Ressourcen, Anbindung, Erreichbarkeit, Reverse Proxy, NAS, Gitea, Netztrennung zum privaten Netz | Annahmen A-05 bis A-08 bestätigt oder korrigiert | -| **Machbarkeitsnachweis Kernstapel** mit vier Punkten und Abbruchkriterium (`10`, Abschnitt 2.1) | Grundlage für E-18 | -| Entscheidung Kernstapel (E-18) | ADR-02 beschlossen; **einzige Voraussetzung, die die Implementierungsplanung blockiert** (`13`, Abschnitt 10) | +| **Machbarkeitsnachweis Kernstapel** | durch die Umsetzung ab dem 15.11.2026 ersetzt, nicht als eigene Studie wiederholt | +| Entscheidung Kernstapel (E-18) | **erledigt am 15.11.2026:** Laravel 13, Filament 5, PHP 8.4, PostgreSQL (ADR-02) | | **Sicherheitsbasis:** drei Herkunftsadressen; getrennte Datenbankrollen und Einhängepunkte je Betriebsart; Alltags- und Systemkonto; Alarmkanal außerhalb der Plattform | Grenzen aus `03`, Abschnitt 6 stehen, bevor Fachcode entsteht | | **Sicherungsbasis:** Außer-Haus-Ziel mit nur anfügbarem Zugang ausgewählt (A-15); fortlaufendes Änderungsprotokoll an beide Ziele; Spiegel von Quellcode und Abbildern; Sicherheitsjournal und Audit-Anker; Entscheidung über die Ziele (E-22) | `11`, Abschnitt 3 eingerichtet; erste Standortausfall-Übung mit Zeitmessung | | Steuer- und Rechtsberatung: Steuerstatus, Kundenkreis, Zahlungs- und Rechnungsweg, Bestellablauf, Lizenzbedingungen | OPEN-06, E-09 entschieden; Textaufträge erteilt | diff --git a/docs/architektur/16_MVP_Slice.md b/docs/architektur/16_MVP_Slice.md index 99c0441..ccc64b1 100644 --- a/docs/architektur/16_MVP_Slice.md +++ b/docs/architektur/16_MVP_Slice.md @@ -128,7 +128,7 @@ ### 6.1 Entscheidungen, die vorliegen müssen | Entscheidung | Verweis | |---|---| -| Kernstapel, nach dem Machbarkeitsnachweis | E-18 | +| Kernstapel | E-18, **entschieden am 15.11.2026:** Laravel 13, Filament 5, PostgreSQL | | Steuerstatus, Kundenkreis, Zahlungs- und Rechnungsweg | OPEN-06, E-09 | | Lizenztypen, Preise und Bedingungen der Startangebote | OPEN-03 | | Ziele für Datenverlust und Wiederanlauf | E-22 | diff --git a/docs/architektur/cms-widget-registry.md b/docs/architektur/cms-widget-registry.md new file mode 100644 index 0000000..f93bcd0 --- /dev/null +++ b/docs/architektur/cms-widget-registry.md @@ -0,0 +1,334 @@ +# CMS: Widget-Registry, Abschnitte, Seiteneditor und Website-Gerüst + +Stand: 17.11.2026, Iteration 2 (Branch `feature/cms-sections`, baut auf Iteration 1 `feature/cms-widget-registry` auf). Bezug: ADR-22, ADR-28, ADR-29, ADR-30, ADR-32, ADR-36 (`12_Entscheidungsprotokoll_ADR.md`), Website-CMS-Zielarchitektur §§5.3–5.6, 6.2. Designsystem: `docs/architektur/designsystem.md`. + +Dieses Dokument beschreibt den **umgesetzten** Stand für Entwickler. Es ist keine fachliche Freigabe der ADRs. + +## 1. Überblick + +``` +Seite → Abschnitte (Raster, Gestaltung) → Plätze → je Platz höchstens ein Widget aus dem Register + +config/cms.php ──► WidgetRegistry ──► PageSections (Lesen, Prüfen, Rollback-Fassung) + │ │ + │ ▼ + │ SectionRenderer ──► WidgetRenderer ──► widgets/.blade.php + │ ▲ ▲ + │ │ └── Widget-Vorschau im Editor (WidgetBlock) + │ ├── öffentliche Seite (PageController::show) + │ └── Vorschau einer Revision (PageController::preview) + └──► SectionEditor + WidgetEditor (Filament: Abschnitte, Raster, Plätze, Widget-Dialoge) +``` + +| Baustein | Datei | Aufgabe | +|---|---|---| +| Vertrag | `app/Domain/Cms/Widgets/WidgetType.php` | abstrakte Basisklasse jeder Widget-Art, einschließlich Mindestbreite | +| Register | `app/Domain/Cms/Widgets/WidgetRegistry.php` | Registrierung, Lesen (Anheben älterer Fassungen), Prüfen und Bereinigen je Widget | +| Abschnitte | `app/Domain/Cms/Sections/PageSections.php` | Abschnitts- und Platzmodell: Lesen, Prüfen, flache Rollback-Fassung, Medien | +| Raster und Gestaltung | `app/Domain/Cms/Sections/SectionLayouts.php`, `SectionStyle.php` | freigegebene Raster und Gestaltungswerte (Aufzählungen) | +| Darstellung | `app/Domain/Cms/Sections/SectionRenderer.php`, `Widgets/WidgetRenderer.php` | einziger Renderweg für Seite, Vorschau und Editor | +| Editor-Adapter | `app/Filament/Support/SectionEditor.php`, `WidgetEditor.php`, `WidgetBlock.php`, `ReportsSectionErrors.php` | Abschnitte, Rasterauswahl, Plätze, Widget-Dialoge, Fehlermeldungen | +| Navigation | `app/Domain/Cms/SiteNavigation.php` | Kopf- und Fußnavigation aus dem CMS-Navigationsmodell | +| Katalog-Lesesicht | `app/Domain/Cms/Catalog/PublicCatalogReader.php` | einzige Stelle, die entscheidet, welche Programme/Module öffentlich erscheinen | +| Hilfen | `app/Domain/Cms/Widgets/Support/*` | sichere Links, bereinigter formatierter Text, öffentlicher Medienbereich, Bildauswahl | +| Seitenvorlagen | `app/Domain/Cms/PageTemplates.php`, `resources/views/site/templates/` | derzeit nur `standard` (Abschnitte untereinander) | +| Layout | `resources/views/layouts/site.blade.php`, `resources/views/components/site/*` | Kopfzeile, Wortmarke, Navigation, Inhaltsfläche, Fußbereich | +| Designsystem | `resources/css/{tokens,base,components,site,sections,widgets}.css` | Tokens, Grundkomponenten, Gerüst, Abschnitte, Widgets | +| Wiederherstellung | `app/Console/Commands/RevertPublishedPages.php` | `cms:revert-published` vor einem Code-Rollback (Abschnitt 9) | + +## 2. Widget-Vertrag + +Jede Widget-Instanz (in einem Platz von `page_revisions.sections` und in der flachen Liste `page_revisions.blocks`) hat dieselbe Hülle: + +| Feld | Inhalt | +|---|---| +| `id` | stabile Kennung (UUID), bleibt beim Bearbeiten erhalten; Duplikate erhalten beim Speichern eine neue (seitenweit geprüft) | +| `type` | Typkennung aus dem Register; ändert sich nie | +| `v` | Schemaversion der Art | +| `variant` | eine der für die Art registrierten Varianten | +| `settings` | nur registrierte Aufzählungswerte (`WidgetType::settingOptions()`, einschließlich der gemeinsamen Höhe `height`); freie Werte werden abgewiesen. Fehlt ein Wert, gilt die Vorgabe der Darstellung | +| `data` | redaktionelle Inhalte | +| `refs` | Verweise auf Fachobjekte oder Medien, nur Kennungen bzw. Pfade im öffentlichen Bereich `cms/` | + +Gespeichert werden nur Schlüssel, für die die Art Prüfregeln deklariert. Felder mit führendem `_` (zum Beispiel `_upload`) sind Editorhilfen und werden nie gespeichert. + +## 3. Versionierung und Altbestand + +- **Altformat** (vor der Registry: `{type, heading, intro, …}` ohne `v`) wird beim Lesen als Version 1 interpretiert (`WidgetType::fromLegacy`). +- Liegt `v` unter der aktuellen Version, hebt `WidgetType::upgrade($widget, $from)` schrittweise an. +- **Revisionen ohne Abschnitte** (`sections = null`, alles vor Iteration 2) werden als einspaltige Abschnitte mit kompaktem Abstand gelesen (`PageSections::read`). +- Gespeicherte Revisionen werden **nicht** umgeschrieben. Erst eine neue Revision aus dem Editor speichert Abschnitte und aktuelle Hüllen. +- „Wiederherstellen“ kopiert Abschnitte und flache Liste einer Revision unverändert. +- Unbekannte Widget-Arten werden ausgelassen; unbekannte Raster- oder Gestaltungswerte fallen beim Lesen auf Vorgaben zurück. Eine Hülle mit höherer Version als im Code wird bestmöglich dargestellt, aber nicht gespeichert. +- Regel: Optionale neue Felder brauchen keine neue Version. Umbenennen, Umdeuten oder Verschieben von Feldern braucht eine neue Version mit `upgrade()` und einen Test. Gleiches gilt für die Abschnittshülle (`PageSections::VERSION`). + +Beispiele: +- `image_text` Version 1 `{image, alt, body (Klartext)}` → Version 2 `data {title, body (bereinigtes HTML), alt}`, `refs {image}`, Variante `image_left` → Version 3 (Kit v1.6): `settings.format` entfällt, `settings.focus` wird zu `data.focus_x/focus_y` (Prozent). +- `hero` Version 1 → Version 2 (Kit v1.6): Varianten `standard`/`stage` → `photo_split`, `highlight`/`editorial` → `editorial_solid`; `settings.focus` wird zu `data.focus_x/focus_y`, `settings.text_side` entfällt. Die data-Schlüssel (`heading`, `text`, `cta_*`, `alt`) bleiben, damit ein Code-Rollback darstellbar bleibt. + +## 4. Registrierte Widget-Arten + +| Kennung | Name | Version | Varianten | Breiten (Einheiten) | Höhen | Verweise | +|---|---|---|---|---|---|---| +| `hero` | Einstieg (Hero), Premium nach Kit v1.6 | 2 | `photo_split` (Foto mit Textfläche), `editorial_solid` (Navy-Markenfläche) | 3, 4 | `compact` (mind. 400 px), `normal` (512 px, Vorgabe), `large` (640 px) | `refs.image` | +| `heading` | Überschrift und Einleitung | 1 | `standard` | 1–4 | – | – | +| `prose` | Fließtext | 1 | `standard` | 1–4 | – | – | +| `image_text` | Bild und Text, Premium nach Kit v1.6 | 3 | `image_left`, `image_right` (Bildseite) | 1–4 | `compact`, `normal` (Vorgabe), `spacious` | `refs.image` | +| `cards` | Redaktionelle Karten | 1 | `standard` (Raster), `compact` (Liste), `featured` (erste Karte hervorgehoben) | 1–4 | – | Bild je Karte in `data.items[].image` | +| `catalog_cards` | Programm- und Modulkarten | 1 | `standard`, `compact` | 1–4 | – | `refs.items[] = {type: composition, id}` | +| `topic_card` | Themenkarte, Premium-Karte nach Kit v1.7 | 1 | `adaptive`, `stacked` | 1–4 | `auto` (Vorgabe), `fill` | `refs.pillar`, `refs.image` | +| `media_card` | Medien- und Materialkarte, Kit v1.7 | 1 | `adaptive`, `stacked` | 1–4 | `auto` (Vorgabe), `fill` | `refs.element`, `refs.image` | +| `program_card` | Programm- oder Modulkarte, Kit v1.7 | 1 | `adaptive`, `stacked` | 1–4 | `auto` (Vorgabe), `fill` | `refs.composition`, `refs.image` | +| `call_to_action` | Handlungsaufruf | 1 | `standard` | 1–4 | `auto` (Vorgabe), `fill` (Abschnittshöhe füllen) | – | +| `faq` | FAQ | 1 | `standard` | 2–4 | – | – | + +Darstellungsklassen an der Widget-Hülle: `widget widget- widget-variant-` und, wenn die Art Höhen anbietet, `widget-height-`. Premium-Ansichten: `lf-hero lf-hero--{photo-split|editorial-solid} lf-hero--height- lf-hero--accent-` und `lf-bt lf-bt--{cream|clear|navy} lf-bt--image-{left|right} lf-bt--height-`. + +**Premium-Widgets (Kit v1.6).** Ansichten `resources/views/widgets/hero.blade.php` und `image_text.blade.php`, Stylesheets `resources/css/components/lf-hero.css` und `lf-bild-text.css` (aus `12_premium_widgets_adaptiv_v1.6/components/*.v1.6.css` übernommen und angepasst; sie ersetzen das frühere Hero- und Bild-und-Text-CSS und werden nicht parallel geladen). Gemeinsame Felder in `App\Domain\Cms\Widgets\Support\PremiumFields`: + +| Feld | Gespeichert als | Hinweis | +|---|---|---| +| Label | `data.eyebrow` | höchstens 80 Zeichen | +| Überschrift | `data.heading` (Einstieg), `data.title` (Bild und Text) | | +| Beschreibung | `data.text` (Klartext, Einstieg), `data.body` (bereinigter formatierter Text, Bild und Text) | | +| Schaltflächen | `data.cta_label/cta_url`, `data.cta2_label/cta2_url` | Linkziele über `SafeUrl` | +| Bild, Alternativtext | `refs.image`, `data.alt` | öffentlicher Bereich `cms/`; Alternativtext Pflicht bei Bild | +| Bildfokus | `data.focus_x`, `data.focus_y` | ganze Zahlen 0–100; Vorgabe Einstieg 68/50, Bild und Text 64/43 | +| Überschriftenebene | `settings.heading_level` | `auto` (Vorgabe), `h2`, `h3`; das erste Widget der Seite ist immer H1 | +| Akzent (Einstieg) | `settings.accent` | `underline` (Vorgabe), `rays`, `none` | +| Fläche (Bild und Text) | `settings.surface` | `cream` (Vorgabe), `clear` (übernimmt den Abschnitt), `navy` | +| Höhe | `settings.height` | gemeinsamer Layoutvertrag (§12) | + +**Abweichungen vom Kit (bewusst):** +- Kennungen bleiben `hero` und `image_text`, nicht `lf-brand-hero`/`lf-editorial-bild-text`; Varianten `photo_split`/`editorial_solid` mit Unterstrich, weil Variantenkennungen `^[a-z][a-z0-9_]*$` folgen. +- Bildseite von Bild und Text bleibt die Variante (`image_left/right`), nicht zusätzlich `settings.image_side`, damit es keine doppelte Einstellung gibt. +- Bildfokus in `data` statt `settings.image_focus`, weil Einstellungen nur Aufzählungswerte tragen. +- Überschriftenebene ohne frei wählbare H1 (Regel: genau eine H1 je Seite, erstes Widget). +- Linkziele: Seitenpfad, `#Anker`, `http` und `https` (bestehende `SafeUrl`-Regel); das Kit erlaubt nur `https`. +- Das Kit lädt das Einstiegsbild immer sofort; hier nur beim ersten Widget der Seite, alle anderen verzögert. +- Kit-CSS ergänzt: Überschriften erben Farbe (globale h1–h3-Regeln), Unterstreichung als Block, Fläche `clear` übernimmt die Farben dunkler Abschnitte, Strahlen-Akzent aus `components/brand/rays.blade.php`, Fokusfarbe aus den Tokens. + +## 5. Neues Widget hinzufügen + +1. Klasse unter `app/Domain/Cms/Widgets/Types/` anlegen, von `WidgetType` ableiten. Pflicht: `key()`, `label()`, `description()`, `dataRules()`, `dataFields()`. Je nach Bedarf: `variants()`, Layoutvertrag `supportedUnits()`/`preferredUnits()`/`heights()`/`stages()`/`narrowBehavior()` (Abschnitt 12), `settings()`/`settingLabels()`/`optionIcons()`, `mediaSchema()` für den Reiter „Medien“, `refRules()`, `refFields()`, `clean()` (Links mit `SafeUrl`, Text mit `RichText::sanitize`, Bilder mit `ImageRefFields::clean`), `resolve()`, `mediaPaths()`, `summary()`, `schematic()`, `icon()`. +2. Ansicht `resources/views/widgets/.blade.php` anlegen. Verfügbar: `$data`, `$refs`, `$variant`, `$settings`, `$first`, `$context` (Vorschau ja/nein) und die Rückgabe von `resolve()`. Kein `{!! !!}` außer für mit `RichText::sanitize` bereinigten Text. Breitenabhängige Regeln als Container-Abfrage `@container slot (…)`, nicht als Fenster-Medienabfrage; Farben nur über Bedeutungs-Tokens. +3. Klasse in `config/cms.php` unter `widgets` eintragen. +4. Tests ergänzen (Registrierung und Prüfregeln in `tests/Unit/WidgetRegistryTest.php`, Darstellung in `tests/Feature/CmsWidgetRenderingTest.php` bzw. `CmsSectionRenderingTest.php`). + +Editor, Plätze, Vorschau, Speicherung und öffentliche Darstellung brauchen keine Änderung. `WidgetRegistryTest::test_a_new_widget_type_works_through_the_contract_alone` belegt das mit einer nur im Test definierten Art. + +**Fachobjekt-Widgets** (künftig Angebote, Lizenzartikel, Kampagnen) speichern ausschließlich Kennungen in `refs` und lesen Anzeigeinhalte über eine Lesesicht wie `PublicCatalogReader`. Preise, Rechte und Angebotsbedingungen werden nie in `data` kopiert. + +## 6. Öffentliche Freigabe von Programmen und Modulen (Übergangsregel) + +ADR-29 (öffentliche Fachobjektprofile) ist nicht umgesetzt. Deshalb gilt in `PublicCatalogReader`: + +| Objekt | Im Editor wählbar | Öffentlich sichtbar | Redaktionsvorschau | +|---|---|---|---| +| Thema (Säule), veröffentlicht mit öffentlicher Adresse | ja (Themenkarte) | ja, mit Link auf `/themen/{slug}` | ja | +| Thema, nicht veröffentlicht | ja (Themenkarte) | nein | ja, mit Hinweis „Nur Redaktionsvorschau“ | +| Medium/Material, nicht archiviert, mit bereitgestellter Fassung, Bestandteil der gezeigten Fassung eines öffentlichen Programms, keine Traineranleitung | ja (Medienkarte) | ja, mit Link auf die Programmseite (dort ist es bereits öffentlich genannt) | ja | +| Medium/Material ohne öffentliches Programm, nur mit Entwurfsfassung oder Traineranleitung | ja (nicht gesperrt) | **nein** | ja, mit Hinweis | +| Programm oder Modul mit bereitgestellter Fassung, ohne Anzeigefreigabe | ja (nur Programm-/Modulkarte, nicht Katalogkarten) | nein | ja, mit Hinweis | +| Programm mit Anzeigefreigabe, nicht archiviert | ja | ja, mit Link auf `/programme/{id}` (dieselbe Regel wie die bestehende Programmliste) | ja | +| Modul mit Anzeigefreigabe, nicht archiviert | ja | **nein** | ja, mit Hinweis „Nur in der Redaktionsvorschau sichtbar“ | +| Fassung ohne Anzeigefreigabe, Entwurf, archiviert, ohne Inhaltsart | nein (Speichern wird abgewiesen) | nein | nein | + +Die Prüfung erfolgt bei jeder Darstellung, nicht nur beim Speichern: Wird eine Anzeigefreigabe zurückgenommen, verschwindet die Karte ohne Seitenänderung. Vorschaubilder der Bibliothek sind geschützt (Paket 6) und werden nicht gezeigt; die Karte zeigt eine Inhaltsart-Fläche. + +**Offener Integrationsschritt:** Mit ADR-29 ersetzt die Profilprüfung (Status „gelistet“, gezeigte Fassung, freigegebenes Bild) die Übergangsregel in `PublicCatalogReader::isPublic()`/`entries()`. Daten der Widgets ändern sich dadurch nicht. + +## 7. Medien + +Alle Bilder kommen aus dem zentralen Medienmanager (`docs/architektur/medienzugriff-fuer-komponenten.md`, Abschnitt +„Umsetzung im CMS“). Gespeichert wird die Kennung des Mediums in `refs.image`, `data.items[].image` bzw. +`style.image`; öffentlich erscheint ein Bild nur mit Website-Freigabe (`WebsiteMedia`, Route `website.media`). +Gemeinsame Felder: `ImageRefFields` (Auswahl mit Vorschaubild und Status, Upload über `WebsiteIntake`, Anzeige des +gewählten Mediums). Frühere Pfade unter `cms/` gelten über `WebsiteMediaAlias` als das übernommene Medium, ohne +Zuordnung weiter als öffentliches CMS-Bild. Bibliotheksmedien ohne Website-Freigabe erscheinen öffentlich nie. + +## 8. Editor und Vorschau + +- Arbeitsfläche in voller Breite (`maxContentWidth = Full`); „Seite und Suchmaschinen“ ist beim Bearbeiten eingeklappt. +- **Abschnitte** (Repeater): Kopfzeile „Abschnitt N · Raster 1 + 3 · Fläche · Widgets“; Aktionen Ziehen, nach oben/unten, Duplizieren, Löschen (mit Rückfrage), Einklappen, jeweils mit Tooltip. +- **Raster**: grafische Auswahl mit sechs Kacheln. Raster mit weniger Plätzen als eingesetzten Widgets sind gesperrt. Beim Wechsel entfallen zuerst leere Plätze; Widgets behalten ihre Reihenfolge (`SectionEditor::arrangeSlots`). Kein Wechsel entfernt ein Widget. +- **Gestaltung des Abschnitts** (eingeklappt, Zusammenfassung im Kopf): Hintergrund, Breite, **Abstand oben**, **Abstand unten**, **Widget-Abstand** (je Kein Abstand / Kompakt / Normal / Großzügig, siehe §11), Trenner; bei Hintergrundbild zusätzlich Bild (Auswahl oder Upload), Fokuspunkt und Überlagerung. Abschnitts- und Widget-Einstellungen sind getrennt. +- **Plätze** stehen im Verhältnis des Desktop-Rasters nebeneinander; Widgets lassen sich per Ziehen zwischen Plätzen tauschen. Der Platzkopf nennt Breite und warnt, wenn das Widget breiter sein müsste. Ein freier Platz bietet „Widget einsetzen“ (Auswahl mit Name, Beschreibung, Symbolbild, Mindestbreite), danach öffnet der Widget-Dialog. Ein Klick auf die Vorschau öffnet denselben Dialog: eine Dialogebene. +- **Widget-Dialog**: Arten mit Darstellungsoptionen oder Medien gliedern den Dialog in die Reiter **Inhalt**, **Medien** und **Darstellung** (generisch aus der Registry: `editorSchema()`, `mediaSchema()`, Varianten und `settingOptions()`); andere Arten zeigen ihre Felder direkt. Varianten und Höhen sind sichtbare Auswahlknöpfe mit Symbol, Bildfokus zwei Schieberegler (0–100). „Darstellung“ nennt die zulässigen Platzbreiten und das Verhalten bei wenig Platz. +- **Live-Vorschau im Dialog**: rendert den ungespeicherten Zustand mit derselben Ansicht wie die Website (`WidgetEditor::renderPreview`) in einer wählbaren logischen Platzbreite (Smartphone 390 px und die zulässigen Einheiten: 310/640/960/1300 px, entsprechend dem Standardabschnitt bei 1440 px Fensterbreite) und verkleinert sie auf die Dialogbreite. Die Breitenwahl wird nicht gespeichert. +- **Widget-Vorschau im Platz**: dieselbe Ansicht im isolierten `iframe` in der Breite des Platzes im Editor; über 28 rem gekürzt mit Hinweis „vollständig in der Seitenvorschau“. +- „Entwurf speichern“ erzeugt eine Revision (bei unverändertem Stand keine weitere). „Veröffentlichen“ speichert zuerst den aktuellen Stand im Editor und veröffentlicht genau diesen; enthält er Fehler, wird nichts veröffentlicht. Vorher veröffentlichte „Veröffentlichen“ nur die zuletzt gespeicherte Revision, sodass übernommene, aber ungespeicherte Änderungen (etwa ein gewähltes Bild) verloren gingen. +- Verlassen oder Neuladen mit ungespeicherten Änderungen löst eine Warnung des Browsers aus. +- Ganzseitige Vorschau: `/redaktion/vorschau/{revision}/geraete` mit Umschaltern 390/768/1440 px; zeigt Kopfzeile, Navigation, Abschnitte, Flächen, Trenner und Fußbereich mit demselben Renderer wie die öffentliche Seite; `noindex`. +- Revisionen: Vorschau, Veröffentlichen, Wiederherstellen (legt eine neue Revision an). +- Seitenliste: zuletzt bearbeitete Seiten zuerst (Spalte „Zuletzt bearbeitet“, deutsche Zeit; jede gespeicherte Revision und jede Veröffentlichung zählt), Pfad und Datum sortierbar, 25/50/100 Einträge je Seite, Suche nach Pfad. „Duplizieren“ legt eine unveröffentlichte Kopie des zuletzt gespeicherten Stands unter neuer Adresse an; die Vorlage bleibt unverändert. + +Fehler beim Speichern erscheinen als Meldung „Abschnitt N, Platz M (Widget-Art): …“ und als Zusammenfassung am Platzraster des Abschnitts, auch wenn das Feld im geschlossenen Widget-Dialog liegt (Registry-Fehler über `SectionEditor::mapErrors`, Formularfehler über `ReportsSectionErrors`). + +## 9. Rollback und Datenformat (wichtig vor dem Merge nach `main`) + +**Medien aus dem Medienmanager (ADR-40).** Revisionen, die nach der Umstellung gespeichert werden, enthalten im +Bildschlüssel eine Kennung (Zahl) statt eines Pfads. Ein Code-Rollback auf eine Fassung davor zeigt diese Bilder nicht +(die ältere Fassung kennt nur `cms/`-Pfade); Texte und Gestaltung bleiben. Die Dateien unter `cms/` und frühere +Revisionen bleiben unverändert, die Zuordnungstabelle `website_media_aliases` ist additiv. + +**Speicherung.** Jede neue Revision schreibt zwei Spalten: + +| Spalte | Inhalt | Wer liest sie | +|---|---|---| +| `page_revisions.sections` (neu, ergänzend, nullable) | Abschnitte mit Raster, Gestaltung und Plätzen | Code ab Iteration 2 | +| `page_revisions.blocks` (bestehend) | alle Widgets in Lesereihenfolge als flache Hüllenliste | Code der Iteration 1; Iteration 2 nur bei `sections = null` | + +**Was ein reiner Code-Rollback bewirkt** (`scripts/deploy.sh` setzt nur den Code zurück): + +| Rollback auf | Seiten, die nach dem Deploy gespeichert wurden | Sicher? | +|---|---|---| +| Iteration 1 (Widget-Registry ohne Abschnitte) | zeigen alle Widgets untereinander; Raster, Flächen, Hintergrundbilder, Trenner und Untermenüs entfallen | darstellbar, aber **nicht gleichwertig** | +| Stand vor der Widget-Registry (derzeitiger Stand `main`/Prod) | `blocks` liegt im Hüllenformat vor, das dieser Code nicht lesen kann: Fehler auf genau diesen Seiten | **nicht sicher** | + +**Wiederherstellungsweg** (vor dem Code-Rollback, solange der neue Code läuft): + +1. Probelauf: `php artisan cms:revert-published --before=""` listet jede veröffentlichte Seite, deren Revision danach entstand, und die Revision, auf die zurückgesetzt würde. +2. Ausführen mit `--apply`: Nur der Veröffentlichungszeiger wechselt auf die letzte Revision vor dem Zeitpunkt (Altformat). Seiten ohne ältere Revision werden zurückgezogen, nicht gelöscht. Keine Revision wird geändert oder gelöscht. +3. Danach den Code zurückrollen. Nach einem erneuten Vorwärts-Deploy lassen sich die neueren Revisionen in der Revisionsliste wieder veröffentlichen. + +Ist der neue Code nicht mehr lauffähig, entspricht Schritt 2 dieser Anweisung (nur nach bestätigtem Backup, PostgreSQL; `:deploy` ersetzen): + +```sql +UPDATE pages p SET published_revision_id = ( + SELECT r.id FROM page_revisions r + WHERE r.page_id = p.id AND r.created_at < :deploy ORDER BY r.id DESC LIMIT 1) +WHERE p.published_revision_id IN (SELECT id FROM page_revisions WHERE created_at >= :deploy); +``` + +Die Migrationen (`sections`, `parent_id`) sind ergänzend und müssen beim Rollback nicht zurückgenommen werden; älterer Code ignoriert beide Spalten. + +**Abschnittshülle Version 2 (Abstände)** bringt keine Migration der Datenbank; ältere Hüllen werden beim Lesen übersetzt. Ein Code-Rollback auf eine Fassung vor Version 2 zeigt neue Hüllen mit den alten Vorgaben (Abstand normal), weil sie `spacing_bottom` und `gap` nicht kennt; Speichern im alten Editor weist diese Schlüssel ab. Der Wiederherstellungsweg oben gilt. + +**Adaptive Widgets (ADR-38)** bringen keine Migration. Gespeichert werden ab jetzt `hero` Version 2 und `image_text` Version 3. Ein Code-Rollback auf Designiteration 1 stellt diese Hüllen „bestmöglich“ dar (höhere Version als im Code): unbekannte Varianten fallen auf die Vorgabe zurück, die data-Schlüssel sind unverändert; Höhe, Fläche, Label und Fokus werden nicht dargestellt, aber nicht gelöscht. Speichern im alten Editor ist für diese Hüllen nicht möglich, bis der neue Code wieder läuft. + +**Designiteration 1** bringt keine Migration. Bei einem Code-Rollback auf Iteration 2 fallen die neuen Varianten beim Lesen auf die Vorgabe zurück (`stage`/`editorial` → `standard`, `featured` → `standard`); die neuen Einstellungen und `cta2_*` werden nicht dargestellt, aber nicht gelöscht. Seiten bleiben darstellbar; der Wiederherstellungsweg oben ist dafür nicht nötig. Ein reiner Code-Rollback ist nach redaktionellen Änderungen im neuen Editor **nicht** als sicher anzusehen; der Weg oben ist Teil jedes Rollbacks. + +## 10. Navigation + +`NavigationItemResource`: Einträge bearbeiten, aus-/einblenden (`is_visible`), löschen, Reihenfolge per Ziehen („Reihenfolge ändern“), interne Seite oder geprüfte Adresse. + +- **Plätze**: `header` (Hauptnavigation), `footer` (Fußbereich: Service), `footer_contact` (Kontakt), `footer_legal` (Rechtliches). Die Fußbereichsgruppen sind Werte derselben Spalte, keine zweite Verwaltung. Leere Gruppen erscheinen nicht. +- **Untermenü**: eine Ebene über `parent_id` (ergänzende Migration), nur in der Hauptnavigation und nur unter Einträgen der obersten Ebene. Ist der übergeordnete Eintrag ausgeblendet, sind seine Untereinträge es auch; wird er gelöscht, rücken sie nach oben. Ein Eintrag mit Untereinträgen darf ohne eigenes Ziel nur das Untermenü öffnen. +- **Aktiver Eintrag**: aus dem angefragten Pfad (`aria-current="page"`; der übergeordnete Eintrag wird als aktiver Pfad markiert). +- Die Ausgabe hängt nie vom Anmeldestatus ab (ADR-32). Der Kontozugang „Mitgliederbereich“ ist für alle gleich und leitet Gäste zur Anmeldung. + +## 11. Abschnitte und Plätze + +Gespeicherte Hülle eines Abschnitts (`sections[]`, Version 2): + +```json +{"id": "uuid", "v": 2, "layout": "u1_3", + "style": {"background": "dark", "image": null, "focus": "center", "overlay": "light", "width": "standard", + "spacing_top": "compact", "spacing_bottom": "compact", "gap": "normal", "divider": "line"}, + "slots": [{"id": "…", "type": "cards", "v": 1, "…": "…"}, null]} +``` + +| Raster | Einheiten | Desktop (Abschnitt ab 60 rem) | Tablet (40–60 rem) | Smartphone | +|---|---|---|---|---| +| `u4` | 4 | volle Breite | volle Breite | volle Breite | +| `u2_2` | 2 + 2 | 1 : 1 | zwei Spalten | gestapelt | +| `u1_3` / `u3_1` | 1 + 3 / 3 + 1 | 1 : 3 / 3 : 1 | gestapelt | gestapelt | +| `u1_2_1` | 1 + 2 + 1 | 1 : 2 : 1 | gestapelt | gestapelt | +| `u1_1_1_1` | 1 + 1 + 1 + 1 | vier Spalten | 2 × 2 | gestapelt | +| `u1_1_2` / `u2_1_1` | 1 + 1 + 2 / 2 + 1 + 1 | 1 : 1 : 2 / 2 : 1 : 1 | gestapelt | gestapelt | + +- Die Einheiten werden als Spaltenverhältnis (`fr`) umgesetzt, nicht als zweites CSS-Grundraster. Der Umbruch richtet sich nach der Breite des Abschnitts (Container-Abfrage `section`); ein schmaler Abschnitt stapelt deshalb früher. +- Gestapelt wird immer in Platzreihenfolge; Lese- und Fokusreihenfolge bleiben gleich (keine visuelle Umordnung). +- **Leere Plätze** gibt es im Editor. Öffentlich entfallen sie; die übrigen Plätze teilen sich die Breite im Verhältnis ihrer Einheiten. Ein Abschnitt ohne darstellbares Widget entfällt samt Fläche und Trenner. +- **Gestaltung**: nur Aufzählungswerte (`SectionStyle`), abgebildet auf Tokens. Freie Werte (Farbcodes, CSS, unbekannte Schlüssel) werden abgewiesen. + - Hintergrund: Standard, helle Markenfläche, dunkle Markenfläche, Markenakzent, Hintergrundbild. Jede Fläche setzt die Bedeutungs-Tokens neu (`scope-dark`, `scope-accent`, `scope-light`). + - Breite: schmal (45 rem), Standard (75 rem), breit (90 rem), volle Breite. Der Hintergrund reicht immer über die ganze Bildschirmbreite. + - **Abstände (Version 2): genau drei unabhängige Werte**, je Kein Abstand / Kompakt / Normal / Großzügig: + + | Wert | Bedeutung | Stufen (390 px → 1440 px) | + |---|---|---| + | `spacing_top` | Abstand oben (vor dem Inhalt) | 0 / 24 → 45 / 48 → 90 / 72 → 120 px (`--section-space-*`) | + | `spacing_bottom` | Abstand unten (nach dem Inhalt) | wie oben | + | `gap` | Widget-Abstand zwischen den Plätzen des Rasters, nebeneinander und gestapelt | 0 / 12 → 18 / 20 → 36 / 32 → 56 px (`--section-gap-*`) | + + - Zwischen zwei Abschnitten addieren sich „unten“ des ersten und „oben“ des zweiten; 0 + 0 = 0. Es gibt keine weitere Vorgabe aus Seiten- oder Rasterhüllen (geprüft: kein Außenabstand der Abschnitte, `main` ohne Innenabstand). + - Oben und unten sind der Innenabstand des Abschnitts. Bei eigener Fläche (dunkel, Akzent, Bild) liegen sie innerhalb der Fläche, damit Hintergründe nahtlos anschließen. + - Vorgabe neuer Abschnitte: oben und unten Kompakt, Widget-Abstand Normal. Damit entspricht der Abstand zwischen zwei neuen Abschnitten dem bisherigen Normalabstand. + - Abstände innerhalb eines Widgets (zum Beispiel zwischen Karten, `--grid-gap`) bleiben Sache des Widgets. + - Trenner „Linie“ und „Markenakzent“ sind sichtbare Elemente zwischen zwei Abschnitten und bringen ihren eigenen kleinen Rand um die Linie mit (24 bzw. 8 px oben und unten). + - **Version 1 → 2** (`SectionStyle::migrateSpacing`, beim Lesen; gespeicherte Revisionen bleiben): + - „Abstand oben und unten“ wird zu oben und unten mit demselben Wert. + - Die Abweichung „Abstand oben“ ersetzt nur oben: „kein“ → Kein Abstand, „gering“ → Kompakt. Die Stufe „gering“ gibt es nicht mehr; das ist die einzige sichtbare Änderung, auf der Testinstanz nur bei `/praevention-im-alltag`, +24 px. + - Die frühere versteckte Regel „Abschnitt ohne Fläche direkt nach Abschnitt ohne Fläche: oben 0“ (ohne Linien- oder Akzenttrenner dazwischen, leere Abschnitte zählen nicht) wird als „oben: Kein Abstand“ ausgeschrieben. + - Der Trenner „Zusätzlicher Abstand“ entfällt; er wird zu „Abstand unten“ eine Stufe höher. + - Der Widget-Abstand wird Normal (der bisher feste Rasterabstand). + - Messung auf der Testinstanz: sieben Seiten bei 1440 und 390 px vor und nach dem Deploy pixelgleich, außer der genannten Stelle. + - Hintergrundbild: nur aus `cms/`, Fokuspunkt als `object-position` (neun Positionen), Überlagerung hell (84 % Weiß) oder dunkel (78 % Navy) oder keine. Das Bild des ersten Abschnitts lädt sofort, alle übrigen verzögert. +- **Trenner** stehen zwischen Abschnitten, nie nach dem letzten: dezente Linie, Markenakzent (kurzer gelber Balken). +- **Erstes Widget** der Seite ist der Seiteneinstieg (Überschrift erster Ordnung); seitenweit genau eine. +- **Grenzen**: höchstens 30 Abschnitte und 60 Widgets je Seite; keine Verschachtelung. + +## 12. Responsive Widget-Regeln und gemeinsamer Layoutvertrag (ADR-38) + +Jede Widget-Art erklärt in `WidgetType`: +- `supportedUnits()`: zulässige Platzbreiten (1–4); `minUnits()` ist daraus abgeleitet. Ein Platz mit anderer Breite wird beim Speichern abgewiesen („… ist für Plätze mit 3 oder 4 Rastereinheiten vorgesehen“); der Platzkopf im Editor warnt vorher („passt nicht“), die Widget-Auswahl nennt die zulässigen Breiten. +- `heights()`: angebotene Höhen aus `WidgetType::HEIGHTS` (`auto`, `compact`, `normal`, `large`, `spacious`, `fill`), gespeichert als `settings.height`; `defaultHeight()` gilt ohne Angabe. Höhen sind Mindesthöhen oder Proportionen, nie Begrenzungen. `fill` streckt das Widget auf die Höhe der Abschnittszeile, wenn Plätze nebeneinander stehen. +- `stages()` und `narrowBehavior()`: Darstellungsmodi nach Containerbreite und Verhalten bei wenig Platz. + +Jeder Platz ist ein Container (`slot`); die Premium-Widgets haben zusätzlich eigene Container (`lf-hero`, `lf-bt`). Entscheidend ist die tatsächliche Breite, nicht die Einheitenzahl. + +| Widget | Breiten | Höhen | Darstellung nach Containerbreite | +|---|---|---|---| +| Einstieg (Hero) | 3, 4 | compact/normal/large | ab 860 px Foto über die Fläche, Text links, Mindesthöhe 400/512/640 px; darunter Sicherheitsumbruch: Foto 16:9 über dem Text, Höhe nach Inhalt; unter 440 px Schaltflächen untereinander | +| Bild und Text | 1–4 | compact/normal/spacious | unter 540 px gestapelt, Schaltflächen in voller Breite; 540–899 px flacher Bildstreifen (2,5 : 1 / 2,15 : 1 / 1,8 : 1) über dem Text; ab 900 px zweispaltig, Bild links oder rechts | +| Überschrift | 1–4 | – | Größe folgt der Platzbreite, lange Wörter werden getrennt | +| Fließtext | 1–4 | – | Zeilenlänge höchstens etwa 70 Zeichen, lange Adressen brechen um | +| Redaktionelle Karten | 1–4 | – | so viele Karten nebeneinander, wie bei 15 rem Kartenbreite passen; hervorgehobene Karte ab 44 rem mit Bild neben dem Text | +| Programm- und Modulkarten | 1–4 | – | ab 17 rem Kartenbreite mehrspaltig; eine einzelne Karte ab 40 rem mit Tafel neben dem Text | +| Premium-Karten (Thema, Medium, Programm) | 1–4 | auto/fill | unter 520 px Platzbreite Bild oder Tafel über dem Text; ab 520 px Bild links (42 %), Text rechts (58 %), außer Variante „Bild immer über dem Text“; nutzbar ab etwa 240 px, empfohlen ab 280 px | +| Handlungsaufruf | 1–4 | auto/fill | unter 20 rem Schaltfläche in voller Breite; Beschriftungen brechen um | +| FAQ | 2–4 | – | Fragen untereinander, Antworten auf Lesebreite | + +Gemessene Platzbreiten im Standardabschnitt (82 rem) bei 1440 px Fensterbreite: 1 Einheit etwa 301–319 px, 2 Einheiten 638 px, 3 Einheiten 957 px, 4 Einheiten 1312 px. Bei 1200 px Fensterbreite hat ein Platz mit 3 Einheiten 807 px; der Einstieg zeigt dort den Sicherheitsumbruch. + +Ableitung: Bild und Text funktioniert dank gestapelter Darstellung auch in einer Einheit; der Einstieg braucht für seine Komposition mindestens etwa 860 px und ist deshalb nur für 3 oder 4 Einheiten freigegeben. Auf Tablet und Smartphone stapeln die Plätze; dort gelten die Breitenregeln nicht, die Widgets reagieren auf ihre Containerbreite. + +## 13. Premium-Karten (Brand-UI-Kit v1.7, ADR-39) + +Drei Widget-Arten auf der gemeinsamen Basis `App\Domain\Cms\Widgets\Types\PremiumCardWidget`, Ansicht `resources/views/widgets/premium_card.blade.php`, Stylesheet `resources/css/components/lf-premium-card.css` (aus `13_premium_karten_v1.7_entwurf/components/lf-premium-card.css` übernommen und angepasst). Das Kit ist ein **Entwurf zur visuellen Freigabe**; die Freigabe steht aus. Stand nach der fachlichen Nachbesserung vom 18.11.2026. + +| Art | Fachobjekt (Lesesicht) | Wählbar | Gelesen | Bildbereich ohne Kartenbild | Aktion | +|---|---|---|---|---|---| +| Themenkarte `topic_card` | Säule (`Pillar`) | alle Säulen | Name, Text für die Website, Zahl veröffentlichter Seiten zum Thema | keiner | „Thema entdecken“ → `/themen/{slug}`, nur veröffentlicht | +| Medien- und Materialkarte `media_card` | Inhaltselement (`PublicMaterialReader`) | nicht archiviert, mindestens eine nicht gesperrte Fassung | Anzeigetitel (sonst Arbeitstitel), Kurzbeschreibung, Inhaltsart, Ausgabeart, Programmzugehörigkeit; Film: Hinweis auf den geschützten vollständigen Film | Film: Filmtafel (Navy, Filmstreifen, kein Abspielsymbol); Material: Materialsymbol (Creme); Redaktionsvorschau: Vorschaubild der Bibliothek, markiert | „Im Programm ansehen“ → Programmseite, nur öffentlich | +| Programm- oder Modulkarte `program_card` | Komposition (`PublicCatalogReader::subject`) | Programm/Modul, nicht archiviert, bereitgestellte Fassung | Anzeigetitel, Kurzbeschreibung (sonst Lernziel), Art, Zahl der Module, Dauer | Navy-Tafel mit Art; Redaktionsvorschau: Vorschaubild der Bibliothek, markiert | „Programm ansehen“ → `/programme/{id}`, nur Programme mit Anzeigefreigabe; Module ohne Link | + +**Darstellung der Medienkarte nach Ausgabeart:** Film → Variante `lf-pc--media` (grüne Aktion, Metadatenband, Filmtafel); Dokument, Text, Hörstück, Bild → `lf-pc--material` (Materialsymbol). Die Unterscheidung folgt `output_class`, nicht einer redaktionellen Einstellung. + +**Gespeichert** (Hülle wie jedes Widget): `refs.{pillar|element|composition}` (Kennung), `refs.image` (Kennung eines Medienmanager-Bildes, früher ein Pfad unter `cms/`), `data.action_label`, `data.note`, `data.alt` (Abweichung vom Alternativtext des Mediums), `data.heading` und `data.summary` (optionale Abweichung nur für diese Karte; leer übernimmt den zentralen Anzeigenamen bzw. Teaser oder Kurzbeschreibung), `data.focus_x/focus_y` (0–100, Vorgabe 66/45). Kein kopierter Lehrtext, kein Linkziel, kein Preis. + +Ist `refs.image` leer, verwendet die Programm- und die Medienkarte das zentral zugeordnete Titelbild des Fachobjekts (`PresentationMedia`, zuerst Titelbild, dann Hero, Hover, alternatives Titelbild, Galerie). Gelesen wird es über `WebsiteImage`. Ohne Website-Freigabe erscheint öffentlich kein Bild; die Texte bleiben. Hat ein Widget danach keinen darstellbaren Inhalt, entfällt es. Eine eingetragene Bildkennung hat Vorrang vor dem zentralen Titelbild. Öffentliche Fachobjektprofile nach ADR-29 bleiben offen. Ein Titelbild kann ein Bild ohne Inhaltsfassung sein. + +**Darstellung** (Reiter „Darstellung“): Variante `adaptive` (ab 520 px Bild neben Text) oder `stacked` (Bild immer oben); Höhe `auto` oder `fill` („An die Zeile angleichen“); `settings.format` (`landscape` 16:9 Vorgabe, `square`, `portrait` 3:4); `settings.fit` (`cover` Vorgabe, `contain` für Dokumente und Poster); `settings.heading_level` (`h3` Vorgabe, `h2`, `h4`); Anzeigen/Ausblenden von Kurzbeschreibung, Art (nicht bei Programm/Modul), Zusatzangaben und Aktion. Bildhöhe höchstens min(70vh, 640 px). + +**Redaktionsvorschau.** Nicht öffentliche Karten tragen die Marke „Nur Redaktionsvorschau“. Fehlende Inhalte (Kurzbeschreibung, Text für die Website, Anzeigetitel, Dauer, Laufzeit, Kartenbild) stehen eingeklappt unter „Hinweise für die Redaktion“, mit dem Ort, an dem sie gepflegt werden. Öffentlich erscheinen weder Marke noch Hinweise noch Bibliotheksbilder. + +**Raster.** Eine Karte je Platz. Gemischte Raster entstehen über die Abschnittsraster, zum Beispiel 1 + 1 + 2 (`u1_1_2`), 2 + 2, 1 + 1 + 1 + 1. Gleiche Höhe: alle Karten einer Zeile auf „An die Zeile angleichen“ stellen; die Aktion steht dann am unteren Rand. Eine öffentlich nicht sichtbare Karte lässt ihren Platz entfallen; die übrigen Plätze teilen sich die Breite. Solche Karten daher in einen eigenen Abschnitt setzen oder mit einem Platz kombinieren, der allein gut aussieht. + +**Sicherheit.** Der einzuhaltende Weg steht in `medienzugriff-fuer-komponenten.md`. Vorschaubilder der Bibliothek (Filmstandbilder, Modulvorschau) nur über `editorial.card` (Redaktionsanmeldung) und nur in der Redaktionsvorschau; öffentlich nie. Keine Adressen unter `/bereich/` oder `/redaktion/` auf öffentlichen Seiten, kein Abspielen, kein Download, kein Preis, keine Kaufaktion. Nie öffentlich: Beschreibung, Einsatzhinweis, Lizenzvermerk, Lehrtexte, Traineranleitungen. Eine Karte begründet keine Berechtigung (Tests `CmsPremiumCardsTest`). + +**Erweiterungsbedarf für öffentliche Vorschaubilder und Filmvorschauen (nicht umgesetzt, minimal):** +1. *Vorschaubild für die Website freigeben:* je `ContentElement` und `Composition` ein Freigabevermerk (`thumbnail_public_at`, `thumbnail_public_by`, Bezug auf `thumbnail_source`), gesetzt nur durch eine ausdrückliche Aktion „Vorschaubild für die Website freigeben“ in der Medien- bzw. Modulbearbeitung. Die Hintergrundverarbeitung kopiert das freigegebene Standbild nach `media_public` (eigener Pfad, zum Beispiel `katalog/`), Zurücknehmen löscht die Kopie. Die Karte nimmt dieses Bild, wenn kein Kartenbild gewählt ist. Der Web-Prozess schreibt weiterhin nicht in den Medienbestand. +2. *Öffentliche Filmvorschau (Trailer, Ausschnitt):* eine eigene Ausgabe (`MediaRendition` mit Rolle `preview`) und eine eigene Freigabe je Fassung, getrennt vom lizenzpflichtigen Film; ausgeliefert ohne Signatur nur nach dieser Freigabe. Bis dahin hat die Karte keine Abspielfunktion. +3. *Laufzeit:* ein Feld in den Mediendaten der Fassung (zum Beispiel `metadata.duration_seconds`, beim Transkodieren mit ffprobe ermittelt). +Alle drei Erweiterungen hängen mit ADR-29 (öffentliche Profile) zusammen und brauchen eine Entscheidung von Lars. + +**Abweichungen vom Kit (bewusst):** +- Kein `.lf-pc-grid`/`.lf-pc-section`/Spannweitenklassen: Das Abschnittsraster ist das einzige Raster. +- Umschaltung bei 520 px über den Platz-Container `slot` statt eines eigenen Kartencontainers. +- Überschriftenebene ohne H1 (Karten sind nie Seiteneinstieg). +- Gelber Akzent der Tafel als `components/brand/underline` (SVG); Schriftgewichte 600 statt 750 (vorhandene Schnitte). +- Zusätzlich Filmtafel und Materialsymbol für Medien ohne freigegebenes Bild; Tafel neben dem Text mittig statt gestreckt. + +**Grenzen.** Module haben keine öffentliche Seite (ADR-29) und erscheinen nur in der Vorschau. Medien öffentlich nur über ein öffentliches Programm. Keine öffentlichen Vorschaubilder ohne die oben beschriebene Freigabe. Eine **kaufbare Angebotskarte** gibt es nicht; sie braucht ein eigenes Fachobjekt „Angebot“ mit Umfang, Zweck und Lizenzbedingungen und wird gesondert konzipiert. diff --git a/docs/architektur/designsystem.md b/docs/architektur/designsystem.md new file mode 100644 index 0000000..d5b238f --- /dev/null +++ b/docs/architektur/designsystem.md @@ -0,0 +1,174 @@ +# Gemeinsames Designsystem (ADR-36) – umgesetzter Stand + +Stand: 18.11.2026, Designiteration 1 (Branch `feature/design-iteration-1`; Vorstand 17.11.2026 `feature/cms-sections`). Gilt für öffentliche Website, Anmeldung, Mitgliederbereich und Mitgliederbibliothek; später für Warenkorb und Checkout. Die Verwaltung nutzt dieselben Markenfarben und Schriftrollen. Ihre Maße und der Arbeitsplatzrahmen stehen in [Verwaltungstokens](../ux/verwaltung/tokens.md) und folgen dem [Verwaltungsstandard](../ux/verwaltung/14-verwaltungsstandard.md). Öffentliche Website und fachliche Verträge bleiben davon unberührt. + +**Status der Werte:** Alle Markenwerte, Schriften und die Wortmarke sind **vorläufig**. Sie stammen aus `docs/Brand-UI-Kit/02_design_tokens` (Entwurf vom 15.11.2026, aus den Originalmotiven abgeleitet, laut Kit nicht freigegeben) und aus der Empfehlung im Website-Zielkonzept §7.2. Diese Datei ist keine Markenfreigabe. Eine Freigabe ändert ausschließlich `resources/css/tokens.css` (und für die Wortmarke `resources/views/components/site/brand.blade.php`, für die Markenakzente `resources/views/components/brand/`). + +## 1. Dateien + +| Datei | Inhalt | +|---|---| +| `resources/css/tokens.css` | Ebene 1 Markenwerte (`--lf-*`), Ebene 2 Bedeutungswerte (`--color-*`), Typografie, Abstände, Rundungen, Layoutmaße, Flächen-Gültigkeitsbereiche `.scope-dark`, `.scope-accent`, `.scope-light` | +| `resources/css/base.css` | Grundelemente, Überschriften, Links, Fokus, Sprunglink, `prefers-reduced-motion` | +| `resources/css/components.css` | Grundkomponenten: Container, Schaltflächen, Formulare, Statusanzeigen, Karte, Dialog, Kennzeile, Themensignatur, Redaktionshinweise | +| `resources/css/site.css` | Website-Gerüst: Wortmarke, Kopfzeile (zwei Zustände), Hauptnavigation, Menümodus, Inhaltsfläche, Fußbereich, Markenakzente | +| `resources/views/components/brand/` | Markenakzente als Blade-Komponenten: `underline` (Unterstreichung), `rays` (Signalstrahlen), `arc` (grüner Bogen); dekorativ, `aria-hidden`, Farbe über Tokens | +| `resources/js/site-nav.js` | Menü, Fokusfalle, Untermenüs, kompakter Zustand, Wiederholung der Breitenmessung (die Messung selbst steht inline in `components/site/header.blade.php`) | +| `resources/css/sections.css` | Abschnitte, Raster, Flächen, Hintergrundbilder, Trenner | +| `resources/css/widgets.css` | Widget-Ansichten (Container-Abfragen) | +| `resources/css/app.css` | bindet alles ein; Mitgliederbereich über seine bisherigen Variablennamen, die auf die gemeinsamen Tokens zeigen | +| `vite.config.js` | Schriften Nunito (700, 800) und Source Sans 3 (400, 600), beim Build lokal abgelegt; keine Anfrage an Fremdserver zur Laufzeit | + +## 2. Markenwerte (Ebene 1, vorläufig) + +| Token | Wert | Herkunft | Verwendung | +|---|---|---|---| +| `--lf-navy` | `#032551` | Brand-UI-Kit, Titelmotiv | Überschriften, Navigation, dunkle Flächen, Fußbereich | +| `--lf-navy-deep` | `#01244c` | Brand-UI-Kit | Reserve | +| `--lf-green` | `#5b8625` | Brand-UI-Kit | nur Flächen ohne Text (Weiß darauf nur 4,3:1) | +| `--lf-green-deep` | `#3b7b09` | Brand-UI-Kit | Aktionsfläche, Markenakzent, Link-Hover | +| `--lf-yellow` | `#fcd10a` | Brand-UI-Kit | Akzentlinien, Trenner, aktive Navigation, Fokus auf dunklen Flächen; nie Textfarbe auf hellem Grund | +| `--lf-cream` | `#f7f6f2` | Brand-UI-Kit | helle Markenfläche | +| `--lf-white` | `#ffffff` | Brand-UI-Kit | Seitenfläche, Karten | +| `--lf-ink` | `#15243a` | Brand-UI-Kit | Fließtext | +| `--lf-ink-muted` | `#3e4c5c` | bisheriger Mitgliederbereich | leiser Text | +| `--lf-line` | `#d5ddd6` | bisheriger Mitgliederbereich | Linien | +| `--lf-focus` | `#1769aa` | Brand-UI-Kit | Fokusrahmen auf hellem Grund | + +Nicht übernommen: Farbwerte der KI-Konzeptgrafiken (`04_visuelle_entwuerfe`) und die nur in der HTML-Vorschau verwendeten Zwischentöne. + +## 3. Bedeutungswerte (Ebene 2) + +`--color-text`, `--color-text-muted`, `--color-heading`, `--color-link`, `--color-link-hover`, `--color-surface`, `--color-surface-subtle`, `--color-surface-raised`, `--color-border`, `--color-border-strong`, `--color-focus`, `--color-accent`, `--color-action`, `--color-action-hover`, `--color-action-text`, `--color-action-secondary-text`, `--color-success(-surface)`, `--color-warning(-surface)`, `--color-danger(-surface)`, `--color-info(-surface)`, `--color-disabled(-surface)`, `--color-theme-1` bis `--color-theme-5`. + +Komponenten und Widgets verwenden nur diese Werte. Dunkle Flächen, Markenakzent und Hintergrundbilder setzen sie über `.scope-dark`, `.scope-accent` und `.scope-light` neu; Karten mit eigener heller Fläche setzen sie lokal zurück. Dadurch funktionieren alle Widgets auf allen Abschnittsflächen ohne Sonderregeln. + +## 4. Kontraste (berechnet nach WCAG-Formel) + +| Paar | Kontrast | Anforderung | +|---|---|---| +| Fließtext `#15243a` auf Weiß / Creme | 15,61 / 14,43 : 1 | Text 4,5 | +| Leiser Text `#3e4c5c` auf Weiß / Creme | 8,78 / 8,11 : 1 | Text 4,5 | +| Navy (Überschrift, Link) auf Weiß | 15,14 : 1 | Text 4,5 | +| Weiß auf Aktionsgrün `#3b7b09` (Schaltfläche, Markenakzent, Wortmarken-Schild, Programmtafel auf dunkler Fläche) | 5,22 : 1 | Text 4,5 | +| Grün dunkel auf Weiß (Art „Programm“/„Modul“ in Listen) | 5,22 : 1 | Text 4,5 | +| Navy auf Gelb (Markenschaltfläche `.button-brand`) / Hover `#ffe05c` | 10,28 / 11,58 : 1 | Text 4,5 | +| Navy auf Creme (Tafel der Markenbühne) | 14,00 : 1 | Text 4,5 | +| Fußbereich Grundzeile `#f4f6f8` auf Grün dunkel (falls der Bogen Links berührt) | 4,82 : 1 | Text 4,5 | +| Text `#f4f6f8` / leise `#d3dde8` auf Navy | 13,97 / 11,01 : 1 | Text 4,5 | +| Navy auf Gelb (Schaltfläche auf dunkler Fläche) | 10,28 : 1 | Text 4,5 | +| Leiser Text `#eef4e8` auf Aktionsgrün | 4,66 : 1 | Text 4,5 | +| Fokus `#1769aa` auf Weiß; Gelb auf Navy; Gelb auf Grün | 5,77 / 10,28 / 3,55 : 1 | Nicht-Text 3 | +| Warnung, Fehler, Erfolg auf ihrer Fläche | 7,36 / 7,69 / 6,86 : 1 | Text 4,5 | +| Deaktiviert `#6b7682` auf `#eceeec` | 3,97 : 1 | deaktivierte Bedienelemente sind ausgenommen | +| Text auf heller Bildüberlagerung (ungünstigster Bildpunkt schwarz) | 10,74 : 1 | Text 4,5 | +| Text auf dunkler Bildüberlagerung (ungünstigster Bildpunkt weiß) | 7,06 : 1 | Text 4,5 | + +Die Werte sind gerechnet; eine Messung mit Prüfwerkzeug an der gerenderten Seite steht vor der Farbfreigabe aus (Website-Zielkonzept §5.3). + +## 5. Typografie, Abstände, Maße + +| Bereich | Wert | +|---|---| +| Auszeichnung (H1–H3, Wortmarke) | Nunito 700/800, vorläufig | +| Lesen und Bedienen | Source Sans 3 400/600 (bereits bisher verwendet) | +| Skala | Fließtext 17 → 18 px, Zeilenhöhe 1,6; H3 20 → 22; H2 26 → 34; H1 34 → 52; Lesebreite 70 Zeichen | +| Abstände | Grundmaß 4 px: 4, 8, 12, 16, 24, 32, 48, 64, 96 px | +| Rundungen | 8 (klein), 14 (Karte), 22 (Fläche), Pille | +| Breiten | Lesebereich 44 rem, Standard 82 rem, Breit 96 rem, Vollbreite; Randabstand 16–40 px (siehe Abschnitt 12) | +| Abschnittsabstände | `--section-space-{none,compact,normal,large}` (oben/unten) und `--section-gap-{none,compact,normal,large}` (Widget-Abstand); Bedeutung in `cms-widget-registry.md` §11 | +| Trefferfläche | mindestens 44 × 44 px | +| Fokus | 3 px Rahmen in `--color-focus`, 3 px Abstand, auf jeder Fläche sichtbar | + +Source Serif 4 wird nicht mehr ausgeliefert; die interne Redaktionsvorschau der Bibliothek fällt dort auf Georgia zurück. + +## 6. Grundkomponenten + +| Komponente | Klassen | Hinweis | +|---|---|---| +| Container | `.ui-container`, `.ui-container-wide` | Standard- bzw. breite Inhaltsbreite mit Randabstand | +| Schaltfläche | `.button` / `.ui-button`, `-secondary`, `-quiet`, `[disabled]`; `.button-brand` | Haupt-, Neben-, Textaktion; Farben aus der jeweiligen Fläche. `.button-brand` (Gelb, Navy-Schrift) nur für die erste Handlung im Seiteneinstieg | +| Formular | `.form`, `.ui-field`, `.ui-input`, `.ui-field-error`, `.check` | sichtbare Beschriftung, Fehlerzustand über `aria-invalid` | +| Statusanzeige | `.status`, `.errors`, `.ui-notice-{success,warning,danger,info}` | Farbe, Randlinie und Text, nie Farbe allein | +| Karte | `.ui-card`, `.empty` | helle Fläche mit Linie | +| Dialog | `.ui-dialog` (natives `dialog`) | Hintergrund abgedunkelt | +| Kennzeile | `.ui-flag` | gelbe Linie vor Großbuchstaben-Kennzeile | +| Themensignatur | `.ui-theme-signature[data-theme=1…5]`, `.ui-theme-signature-mark` | siehe Abschnitt 8 | + +Die bestehenden Klassen des Mitgliederbereichs (`body.member …`) bleiben; ihre Variablen (`--text`, `--aktion`, `--fokus`, …) zeigen jetzt auf die gemeinsamen Tokens. Werte sind gleich geblieben, nur die Auszeichnungsschrift wechselt von Source Serif 4 zu Nunito. + +## 7. Wortmarke und Markenassets + +| Asset | Status | Verwendung | +|---|---|---| +| Wortmarke als Weblogo | **freigegebene Gestaltung** (Brand-UI-Kit `08_freigegebene_logovarianten`, 18.11.2026), als Rasterbild mit transparentem Hintergrund; eine Vektorfassung fehlt | Website-Kopfzeile und Fußbereich (``, `data-brand-status="freigegeben"`): Kompaktfassung, zugeschnitten als `public/images/brand/lara-felix-logo-kompakt-128.webp` und `-256.webp` (1x/2x); Originaldatei unverändert. Höhe: Kopfzeile 60 px (Ausgangszustand 1,32-fach ≈ 80 px, kompakt 60 px), Smartphone 48 px, Fußbereich 72 px. Mitgliederbereich weiterhin mit Schriftzug (`variant="plain"`) | +| Titel-, Denkpause-, Outro-Motiv (`01_originale`) | Original vorhanden, **öffentliche Nutzung nicht freigegeben** (Quellenmanifest) | nicht verwendet; nicht in `public/` oder den Medienbestand kopiert | +| Figurenreferenzen Lara, Felix, Oma | nur interne Referenz | nicht verwendet | +| SVG-Entwürfe Unterstreichung und Signalstrahlen (`03_svg_entwuerfe`) | neue, nicht freigegebene Vorschläge | **seit Designiteration 1 verwendet** als Akzente: Unterstreichung unter Einstiegs- und Abschnittsüberschriften, Strahlen an Bild- und Tafelecken; nie an der Wortmarke | +| Grüner Bogen | eigene Ableitung nach dem Homepage-Entwurf des Kits | Abschluss des Fußbereichs | +| SVG-Entwürfe Denkblase und Hand | didaktische Symbole der Denkpause | bewusst nicht als Dekor verwendet; gehören in Kursplayer und Lernansichten | +| SVG-Entwurf Monogramm | kein freigegebenes Logo | nicht verwendet, auch nicht als Favicon | +| KI-Konzeptgrafiken (`04_visuelle_entwuerfe`) | erfundene Inhalte, nicht freigegeben | nicht verwendet | +| Themensymbole der fünf Bereiche | nicht entworfen | nicht verwendet; Platz vorbereitet | + +Austausch nach Freigabe: Logodatei unter `public/` ablegen und ausschließlich in `components/site/brand.blade.php` einsetzen; Kopfzeile, Fußbereich und Mitgliederbereich verwenden diese eine Komponente. + +## 8. Themensignaturen (vorbereitet) + +`.ui-theme-signature` trägt Nummer (1–5) und Name des Themenbereichs; `--color-theme-1` bis `--color-theme-5` sind Platzhalter, die bis zur Freigabe alle auf die neutrale helle Fläche zeigen. Unterscheidung erfolgt damit ohne Farbe (Design-Prinzipien §3). Nach Freigabe werden Tönungen in `tokens.css` und Symbole als SVG je Säule ergänzt; Mehrfachzuordnung ist als Reihe von Marken vorgesehen. + +## 9. Website-Gerüst (Designiteration 1) + +- **Wortmarke**: freigegebene Lara-&-Felix-Wortmarke (Kompaktfassung) als Bild mit festen Maßen im Markup; die Breitenmessung der Navigation stimmt dadurch schon vor dem Laden des Bildes. +- **Kopfzeile, zwei Zustände ohne Layoutsprung.** Die Box ist immer `--header-height-initial` hoch (104 px ab 75 rem, sonst 64 px) und klebt mit negativem Abstand (`top: kompakt − initial`). Die innere Leiste (`.site-header-bar`, 72 px) klebt oben. Beim Scrollen wandert sie 16 px nach oben und bleibt dann stehen; der Seitenfluss ändert sich nie. Ein Beobachter (`data-site-header-sentinel`) setzt `.is-compact`: Wortmarke von 1,16-facher auf normale Größe (nur `transform`) und Schatten. Unter `prefers-reduced-motion` ohne Übergang. Ohne JavaScript klebt die Kopfzeile genauso; nur die Wortmarke bleibt groß. +- **Breitenstufen der Navigation** (`site-nav.js`, Messung an einer unsichtbaren Kopie): 1. Navigation und Kontozugang mit Beschriftung in einer Zeile; 2. sonst Kontozugang nur als Symbol (`.is-account-compact`); 3. sonst und immer unter 75 rem Menümodus (`.is-menu-mode`). Die Navigation bricht nie um; deshalb ist die Kopfzeile auf allen Seiten gleich hoch, unabhängig von Anzahl und Länge der CMS-Einträge. Die Messung steht inline direkt nach der Kopfzeile (`window.lufHeaderMode`) und setzt die Stufe vor dem ersten Zeichnen; `site-nav.js` wiederholt sie bei Größenänderungen und nach dem Laden der Schriften. +- **Hauptnavigation**: aus `navigation_items` (`header`), aktiver Eintrag mit gelber Markenunterstreichung und `aria-current`, eine Ebene Untermenü als Aufklappliste (Schaltfläche mit `aria-expanded`, Escape schließt, Klick außerhalb schließt). +- **Menümodus**: Menü-Schaltfläche (Symbol und Text) öffnet eine Fläche direkt unter dem sichtbaren Teil der Kopfzeile, 48 px hohe Einträge, Untermenüs eingerückt; Fokus springt in das Menü, Tabulator läuft im Kreis zwischen Schaltfläche und Einträgen, Escape schließt und gibt den Fokus zurück. Keine untere Navigationsleiste auf der Website. Ohne JavaScript bleibt die Navigation unter 75 rem als umbrechende Liste sichtbar. +- **Kontozugang** „Mitgliederbereich“ (für alle Besucher gleich; Gäste werden zur Anmeldung geleitet) und vorbereiteter Warenkorbzugang (`config/cms.php` → `cart.enabled`, Vorgabe aus: es wird nichts ausgegeben). +- **Fußbereich** (dunkle Fläche): Wortmarke, „Themenbereiche“ aus den veröffentlichten Säulen, Gruppen „Service“ und „Kontakt“ aus der CMS-Navigation; „Rechtliches“ in einer eigenen Grundzeile. Grüner Bogen als Abschluss. Leere Gruppen entfallen; es werden keine Kontakt- oder Rechtstexte erfunden. +- **Stabile Geometrie**: `scrollbar-gutter: stable` auf `html` (kurze und lange Seiten gleich breit), `scroll-padding-top` für Sprungziele. Wortmarke, Navigation und Seiteninhalt fluchten im Standardraster. + +## 10. Schnittstellen zum Mitgliederbereich + +Gemeinsam: Tokens, Schriften, Fokusregeln, Wortmarke (`` mit Zusatz „Mitgliederbereich“), Schaltflächen-, Formular- und Statusklassen. Nicht verändert: Layout, Seitenleiste, Bibliotheksnavigation, die bestehende untere Leiste `member-dock` (fünf Einträge, bereits vor dieser Iteration vorhanden), Berechtigungs- und Suchlogik, Kursplayer. Eine Überarbeitung der mobilen Mitgliedernavigation (höchstens vier bis fünf Funktionen) braucht eine eigene UX-Abnahme; die Tokens und Komponenten sind dafür vorbereitet. + +## 11. Veredelung mit Design-Skills (Empfehlung) + +1. Erst Freigaben einholen (Wortmarke als SVG, Farbwerte, Schriften, Bildmotive mit Rechten); dann nur `tokens.css` und `brand.blade.php` anpassen. +2. Widgets einzeln veredeln: nur `resources/views/widgets/.blade.php` und `widgets.css`, Klassen und Daten bleiben stabil; Container-Abfragen beibehalten. +3. Themensignaturen als Symbolfamilie entwerfen (Design-Prinzipien §3, Zielkonzept §7.4), dann `--color-theme-*` und Symbole je Säule ergänzen. +4. Hintergrundbilder: textfreie Zuschnitte der Originalmotive mit Fokuspunkt erzeugen (Hintergrundverarbeitung, `srcset`), sobald freigegeben. +5. Sichtprüfung 390/768/1440 px und Kontrastmessung mit Prüfwerkzeug nach jeder Änderung an Markenwerten. + +## 12. Breitenmodell (Designiteration 1) + +| Stufe | Token | Wert | Abschnittsbreite im Editor | Einsatz | +|---|---|---|---|---| +| Lesebereich | `--width-reading` | 44 rem | `narrow` | lange Texte, Formulare | +| Standard | `--width-standard` | 82 rem | `standard` | Grundraster; Kopfzeile, Fußbereich und Inhalt fluchten hier | +| Breit | `--width-wide` | 96 rem | `wide` | bildstarke Kompositionen | +| Vollbreite | – | 100 % abzüglich Randabstand | `full` | Inhalt bis an den Rand | + +Hintergründe reichen immer über die ganze Fensterbreite. `--frame-inset` = `max(Randabstand, (100 % − Standard) / 2)` steht für Inhalte in fensterbreiten Flächen bereit, ohne `100vw` (kein Scrollbalkenfehler). Die randlose Markenbühne der Designiteration 1 ist mit Kit v1.6 entfallen; der Premium-Einstieg ist eine Karte im Abschnitt. Die Schlüssel der Abschnittsbreiten sind gespeicherte Daten und bleiben unverändert; nur die Werte wurden angepasst (vorher 45/75/90 rem). + +## 13. Premium-Widgets (Brand-UI-Kit v1.6, ADR-38) + +Einstieg und Bild und Text verwenden die Komponenten aus `docs/Brand-UI-Kit/12_premium_widgets_adaptiv_v1.6`, übernommen nach `resources/css/components/lf-hero.css` und `lf-bild-text.css` (über `app.css` geladen; das frühere Hero- und Bild-und-Text-CSS ist entfernt). Die Kit-Variablen `--lf-font-display`, `--lf-font-ui` und `--lf-muted` zeigen in `tokens.css` auf die gemeinsamen Werte. Nunito wird zusätzlich in Stärke 900 lokal ausgeliefert (Überschrift des Einstiegs). + +| Paar | Kontrast | +|---|---| +| Label `#17370b` auf `#dff0c0` (Einstieg) | 10,9 : 1 | +| Weiß auf Grün dunkel (Schaltflächen) | 5,22 : 1 | +| Navy auf Creme / Weiß auf Navy (Flächen) | 14,0 / 15,1 : 1 | +| Fließtext `#46556b` auf Creme (Bild und Text) | 7,0 : 1 | +| Label `#295b08` auf Creme; `#fff2b0` auf Navy | 7,5 / 13,4 : 1 | + +Bildmotive des Kits (`09_hero_widget/assets`, `10_bild_text_widget/assets`) sind für die öffentliche Verwendung nicht freigegeben; sie wurden nur lokal für die Sichtprüfung verwendet. + +## 14. Premium-Karten (Brand-UI-Kit v1.7, Entwurf, ADR-39) + +- Komponente `lf-pc` mit Varianten `lf-pc--editorial` (ruhige Textaktion mit gelber Unterstreichung), `lf-pc--media` (Metadatenband, grüne Aktion `--lf-green-deep`), `lf-pc--catalog` (Navy-Tafel ohne Foto, Navy-Aktion). +- Eigene helle Fläche (`--lf-white`, Rand `--lf-line`, Radius `--radius-panel`, Schatten `--shadow-raised`), auch in dunklen Abschnitten; Bildradius `--radius-card`. +- Schriften: Titel `--font-display` 800, Text `--font-reading`; keine neuen Schriften. +- Ab 520 px Platzbreite Bild 42 % neben Text 58 %; Bildformat 16:9, 1:1 oder 3:4 bleibt erhalten; kein line-clamp. +- Status: Entwurf zur visuellen Freigabe; auf der Testinstanz nur mit gekennzeichneten Platzhalterbildern. diff --git a/docs/architektur/medienzugriff-fuer-komponenten.md b/docs/architektur/medienzugriff-fuer-komponenten.md new file mode 100644 index 0000000..12188e0 --- /dev/null +++ b/docs/architektur/medienzugriff-fuer-komponenten.md @@ -0,0 +1,140 @@ +# Medienzugriff für CMS-Komponenten + +**Stand:** 18.11.2026. Beschreibt den vorhandenen Weg. Keine neue Freigabe, kein zweites Rechtesystem. + +Eine CMS-Komponente, die im Medienmanager liegt, ist ein Inhaltselement (`ContentElement`). Sie entscheidet den Zugriff nicht selbst. Sie ruft eine der drei vorhandenen Stellen auf, je nachdem, was sie tut. + +## Drei getrennte Stellen + +| Was die Komponente tut | Stelle | Was sie nicht tut | +|---|---|---| +| Anzeigedaten auf der Website lesen | `PublicMaterialReader` | keine Datei, keine Ausgabeadresse | +| Datei an ein Mitglied ausliefern | `DecideAccess`, erneut bei jedem Abruf | keine eigene Erlaubnis, keine Vereinigung von Berechtigungen | +| Ein öffentliches Bild zeigen, das kein Bestandsmedium ist | `PublicMedia` | keinen Pfad aus `originals/` oder `derived/` | + +Die Pflege im Medienmanager ist eine vierte, nur redaktionelle Tür: Ansehen dürfen Redaktion und Katalogverwaltung, Ändern nur die Redaktion (`ContentElementResource`). Diese Tür gibt nichts auf der Website und nichts im Mitgliederbereich frei. + +## Anzeige auf der Website + +`PublicMaterialReader` ist die einzige Lesesicht für ein Medium auf einer öffentlichen Seite. Die Medienkarte nutzt sie bereits. + +Öffentlich genannt wird ein Medium nur, wenn alle Punkte zutreffen: + +- es ist nicht archiviert und hat mindestens eine nicht gesperrte Fassung, +- es hat eine bereitgestellte Fassung, +- die Inhaltsart ist nicht `traineranleitung`, +- es gehört zur gezeigten Fassung eines öffentlich gezeigten Programms. + +Solange öffentliche Profile (ADR-29) fehlen, ist das die Übergangsregel. Ein Medium hat keine eigene öffentliche Seite. Die Karte verweist dann auf die Programmseite. + +Gelesen werden Anzeigename (sonst Arbeitstitel), Kurzbeschreibung, Inhaltsart und Ausgabeart. Nicht gelesen und nicht ausgegeben werden Beschreibung, Einsatzhinweis, Lizenzvermerk, Lehrtext und jede Datei. + +Das Vorschaubild der Bibliothek erscheint nur in der Redaktionsvorschau, über die Route `editorial.card`, und nur für angemeldete Redaktion. Auf einer öffentlichen Seite hat dieses Bild keine Adresse. + +## Auslieferung an Mitglieder + +`DecideAccess` ist die einzige Entscheidung über eine Datei. Sie prüft an genau einer Berechtigung: aktives Konto, passender Artikel-Stand, Fassung im fixierten Inhalt dieses Stands, Fassung nicht gesperrt, Aktion im Rechte-Schnappschuss für die Ausgabeart. Zwei Berechtigungen werden nicht zu einer zusammengefügt. + +Die Bibliothek ruft dieselbe Prüfung beim Aufbau der Seite und erneut beim Abruf auf (`LibraryController::media`, signierte Adresse, Leser gebunden). Eine Signatur, eine Karte oder eine gespeicherte Komponente ersetzen diesen zweiten Aufruf nicht. + +Komponenten liefern Dateien nicht selbst aus. Sie bauen keine Adresse auf `content.file`, `content.preview`, `content.rendition` oder `/bereich/`. + +## Öffentliche Bilder außerhalb des Bestands + +Heute liegen Bilder, die nur zur Website gehören, unter dem Präfix `cms/` und laufen über `PublicMedia` und die Route `media.public`. Der Controller liefert nur Pfade, die mit `cms/` beginnen, von den Platten `media_public` und `cms_incoming`. + +Dieser Pfad ist kein Zugang zum Medienmanager. Ein Inhaltselement wird darüber nicht ausgeliefert. Umgekehrt wird eine geschützte Bestandsdatei nicht in `cms/` gelegt, um sie öffentlich zu machen. + +## Website-Medien für Hero, Teaser und Slideshow + +Hero-Grafiken, Teaserfilme und Slideshows liegen im Medienmanager. Sie werden nicht verkauft. Lizenzartikel, Angebot, Grant und `DecideAccess` bleiben dafür unbenutzt. + +Die Website-Freigabe ist eine eigene Entscheidung am Inhaltselement. Sie hängt nicht daran, dass eine Fassung bereit ist, und nicht daran, dass das Medium in einem öffentlichen Programm liegt. `PublicMaterialReader` bleibt die Lesesicht der Programmkarte. Widgets für Hero, Bild und Slideshow lesen `WebsiteMedia`. + +| Aufruf | Klasse | Ergebnis | +|---|---|---| +| Ein Medium | `WebsiteMedia::present($elementOderId)` | `WebsitePresentation` oder `null` | +| Slideshow, Reihenfolge bleibt | `WebsiteMedia::presentMany([$id, ...])` | nur freigegebene Einträge | + +`WebsitePresentation` enthält `elementId`, `title`, `alt`, `credit`, `kind` (`bild` oder `film`) und `url`. `url` ist die einzige Dateiadresse, Route `website.media`. `credit` ist die öffentliche Quellenzeile. `license_note` steht dort nicht. + +Ein Widget speichert die Kennung des Inhaltselements (`refs.element` oder bei einer Slideshow `refs.elements`), nicht einen kopierten Dateipfad. Ist `present` leer, gibt das Widget nichts aus. Vorhandene Bilder unter `cms/` bleiben gültig, bis das jeweilige Widget umgestellt ist. + +### Neues Bild aus dem CMS + +`WebsiteIntake::acceptImage($pfad, $titel, $quellenzeile, $alternativtext, $redakteur)` legt das Medium an und gibt seine Kennung sofort zurück. `$pfad` ist die bereits hochgeladene Datei auf `cms_incoming` und beginnt mit `cms/` oder `vorschau/`. Titel, Quellenzeile und Alternativtext werden am Medium gespeichert. Eine Inhaltsfassung entsteht dabei nicht. + +Die Warteschlange liest die Datei, schreibt das JPEG nach `vorschau/element-{id}.jpg` und gibt danach genau diese Ableitung frei. `present` bleibt leer, bis das abgeschlossen ist. Eine unlesbare Datei bleibt im Eingang, das Medium trägt `thumbnail_error` und wird nicht freigegeben. Fehlt die Datei, liegt sie außerhalb des Eingangs oder fehlt der Titel, entsteht kein Medium. + +Das CMS ruft dafür nicht `DeriveThumbnail` und nicht `WebsiteRelease` auf. + +Freigeben und Zurücknehmen eines schon abgelegten Mediums stehen in der Medienansicht, Bereich Beschreibung (`WebsiteRelease`). Die Warteschlange kopiert die Ableitung nach `media_public` unter `website/{id}/datei.{endung}` und setzt `website_released_at`. Der Web-Prozess schreibt diese Datei nicht. Zurücknehmen löscht nur diese Kopie. + +Was freigegeben werden kann: + +- Bild: Vorschaubild unter `vorschau/` auf `media_derived`, Endung jpg, jpeg, png, webp oder gif. Eine Inhaltsfassung ist dafür nicht nötig. +- Film oder Hörstück ohne Inhaltsfassung: `preview_path` am Medium, unter `teaser/`, Film mp4 oder webm, Hörstück mp3, m4a oder ogg. +- Film mit Inhaltsfassung: an der höchsten bereitgestellten Fassung eine Ausgabe mit Rolle `preview` und Pfad unter `teaser/`, Endung mp4 oder webm. Das gilt, wenn am Medium kein `preview_path` liegt. + +Originaldatei, Master-Fassung und Traineranleitungen werden abgelehnt. Eine Quellenzeile (`website_credit`) und ein Alternativtext (`website_alt`) gehören zu den Anzeigedaten und erzeugen keine neue Fassung. Die Quellenzeile erscheint nur, solange die Freigabe besteht. Der interne Vermerk bleibt intern. + +Ein neues Website-Bild nimmt `WebsiteIntake` auf und gibt es nach der Ableitung frei. Ein eigenständiges Präsentationsmedium legt `PresentationFile` ohne Inhaltsfassung an und gibt es nicht von selbst frei. Öffentliche Profile nach ADR-29 sind damit nicht umgesetzt. + +## Was eine Komponente einhält + +1. Identität und Anzeigedaten bleiben am Inhaltselement. Die Komponente speichert die Kennung, nicht eine Kopie von Titel, Text oder Datei. +2. Eine Programmkarte liest das Fachobjekt über `PublicMaterialReader` und ein Bild über `WebsiteImage`. Hero, Bild und Text sowie Karten lesen `WebsiteMedia`. Ist das Medium nicht freigegeben, wird es nicht ausgeliefert. Texte und übrige Inhalte des Widgets bleiben. Ein Widget ohne verbleibenden Inhalt entfällt. +3. Öffentliche Seiten enthalten keine Adresse unter `/redaktion/` oder `/bereich/` und kein Bibliotheksbild. +4. Die Mitgliedsdatei entsteht nur über den Mitgliederabruf, der `DecideAccess` erneut aufruft. Die Website-Ableitung läuft ausschließlich über `website.media`. +5. Der Web-Prozess schreibt nicht nach `originals/` und nicht nach `derived/` oder `public/`. + +Eine Karte oder eine Komponente begründet keine Berechtigung. + +## Umsetzung im CMS (19.11.2026, ADR-40) + +Alle Bildstellen des CMS lesen den zentralen Medienbestand: Einstieg (Hero), Bild und Text, redaktionelle Karten, +Premium-Karten (Kartenbild) und Abschnittshintergrund. Das CMS hat keine eigene Medienverwaltung mehr. + +- **Gespeichert** wird die Kennung des Inhaltselements im jeweiligen Bildschlüssel: `refs.image` (Einstieg, Bild und + Text, Premium-Karten), `data.items[].image` (redaktionelle Karten), `style.image` (Abschnittshintergrund). + **Abweichung von `refs.element`:** Die Medienkarte verwendet `refs.element` bereits für ihr Fachobjekt; ein + gemeinsamer Bildschlüssel `image` hält alle Widgets gleich und ändert die gespeicherte Struktur nicht. +- **Lesen:** `App\Domain\Cms\Widgets\Support\WebsiteImage` ruft `WebsiteMedia::present` auf. Öffentlich erscheint + ein Bild nur über `website.media`. In der Redaktionsvorschau erscheint ein nicht freigegebenes Bild als + Vorschaubild über `editorial.card` mit Hinweis; öffentlich nie. +- **Nicht freigegeben:** Das Medium wird nicht öffentlich ausgeliefert. Überschrift, Text und Schaltflächen bleiben. + Ein Widget, das danach keinen Inhalt mehr hat, entfällt. Die Redaktionsvorschau zeigt ein nicht freigegebenes Bild + weiter mit Hinweis. Entschieden am 19.11.2026, siehe ADR-40. +- **Neu hochladen im Widget-Dialog:** Die Datei geht über `WebsiteIntake::acceptImage` sofort in den Medienmanager + und wird ausgewählt. Titel aus dem Dateinamen, ohne Quellenzeile; beides ist im Medienmanager änderbar. Die + Warteschlange leitet ab und gibt frei (wie dokumentiert). +- **Auswahl:** alle Bilder (`output_class = bild`, nicht archiviert, keine Traineranleitung) mit Vorschaubild, Titel + und Website-Status; das gewählte Medium mit Status und Verweis auf den Medienmanager. Die Bildauswahl des + Modul-/Programmeditors ist an dessen Livewire-Seite gebunden und lässt sich nicht als Formularfeld einhängen; das + Bedienmuster (Suche, Vorschaubild, Auswahl) ist übernommen. +- **Alternativtext:** aus dem Medium (`website_alt`, sonst Titel). Das Feld im Widget ist eine optionale Abweichung. +- **Website-Ableitung:** Bilder werden bis 2400 px breit abgeleitet (vorher 640 px), nie vergrößert. +- **Medienmanager:** Die Medienansicht nennt die Website-Seiten, auf denen ein Bild verwendet wird + (`WebsiteImageUsage`), damit vor dem Zurücknehmen sichtbar ist, welche Seiten das Bild verlieren. + +### Übernahme der früheren CMS-Bilder + +- Der Job `ImportCmsImages` (angestoßen von einer Migration, ausgeführt von der Warteschlange) nimmt jede Bilddatei + unter `media_public/cms/` über `WebsiteIntake` auf. Bytegleiche Dateien werden ein Medium (SHA-256). Der Titel + kommt aus dem Dateinamen ohne Zufallskennung. Nichts wird gelöscht; der Job ist wiederholbar. +- `website_media_aliases` ordnet jeden früheren Pfad seinem Medium zu. **Wirksam** wird die Zuordnung erst, wenn das + Medium einmal für die Website freigegeben war; bis dahin (oder wenn die Ableitung scheitert) gilt der frühere Pfad + weiter, damit keine Seite ihr Bild verliert. +- Danach entscheidet die Website-Freigabe des Mediums allein, auch über die frühere Adresse `/medien/cms/…` + (404, wenn zurückgenommen). +- Gespeicherte Revisionen bleiben unverändert; frühere Pfade werden beim Darstellen zugeordnet und beim nächsten + Speichern durch die Kennung ersetzt. Frühere Pfade ohne Zuordnung bleiben über `PublicMedia` gültig. +- Eine Slideshow gibt es im CMS nicht; `WebsiteMedia::presentMany` ist für sie vorbereitet und noch unbenutzt. + +## Präsentationszuordnungen (19.11.2026, ADR-41) + +Ein Titelbild, Trailer oder Galerieelement an einem Film, Modul, Programm oder Lizenzartikel ist eine Referenz (`presentation_assignments`) auf die Medienidentität. Eine Inhaltsfassung ist dafür nicht erforderlich. `source_version_id` hält nur eine ausdrücklich hinterlegte Fassung fest. Die Rolle ist keine Verwendung im Aufbau, keine Inhaltsart und keine Website-Freigabe. Die Zuordnung macht das Medium nicht lizenzierbar. + +Öffentliche Seiten lesen ein Bild nur über `WebsiteImage` und damit über `WebsiteMedia`. Ein freigegebener Film oder ein Hörstück wird über `website.media` ausgeliefert. Geschützte Originaldateien und Vorschaubilder der Bibliothek bleiben auf diesem Weg geschlossen. Wird die Freigabe zurückgenommen, endet die öffentliche Ausgabe; Überschriften und Texte bleiben. Ein Widget ohne verbleibenden Inhalt entfällt. + +Die ausführliche Beschreibung, Einsatzhinweise, Lizenzvermerke und Lehrtexte bleiben außerhalb der öffentlichen Karte. `PublicMaterialReader` und `PublicCatalogReader` lesen dafür die Klasse-A-Angaben (`EditorialProfileReader`) und keine Datei. diff --git a/docs/architektur/redaktionelle-informationsbasis.md b/docs/architektur/redaktionelle-informationsbasis.md new file mode 100644 index 0000000..f27a9a7 --- /dev/null +++ b/docs/architektur/redaktionelle-informationsbasis.md @@ -0,0 +1,53 @@ +# Redaktionelle Informationsbasis + +**Stand:** 19.11.2026, Testinstanz `develop` `7b325f0` (Deploy-Lauf 4868). Arbeitsannahme, keine formale Freigabe. ADR-41. + +Die Pflege bleibt an den bestehenden Fachobjekten. Es gibt keine zweite Medienverwaltung, keine Textmedien für gewöhnliche Beschreibungen und keine neue Produkthierarchie. + +## Vorhanden und weiterverwendet + +| Bedarf | Bestand | +|---|---| +| Arbeitstitel, Anzeigename, Kurz- und Langbeschreibung | `content_elements` und `compositions`; Änderung über `IdentityProfile`, protokolliert in `identity_changes`, ohne neue Fassung | +| Fachliche Materialart | `editorial_content_kinds` | +| Themen, Zielgruppen, Einsatz, Verwendungszweck | `editorial_dimensions` und `identity_dimension_values`, mehrere Werte je Dimension | +| Vorschaubild der Bibliothek | `thumbnail_path`, Route `editorial.card`, nur Redaktion | +| Website-Ausgabe | `WebsiteRelease`, `WebsiteMedia`, `WebsiteImage` (ADR-40) | +| Lehrinhalt und Aufbau | Fassungen, Lernziel, Mitglieder | +| Kommerz | Artikelstand, Angebot, Rechte | +| Auswahl eines Mediums | `EditorialCatalog`. Der Aufbau sucht Fassungen. Die Präsentation sucht zusätzlich Bilder, Filme und Hörstücke ohne Inhaltsfassung | + +## Ergänzt + +- `teaser` und `search_terms` an Inhaltselement, Komposition und, als eigene Abweichung, am Lizenzartikel. +- `editorial_text_variants` nur für eine abweichende Formulierung eines Feldes in einem Kontext (`kachel`, `detail`, `bibliothek`, `trainer`, `artikel`, `cms`, `suche`). +- Materialarten: Unterrichtsfilm, Kurzfilm, Trailer, Interview, Arbeitsblatt, Übungsbeschreibung, Titelbild, Hintergrundbild, Präsentationsbild, Audioanleitung. +- Dimensionen: Redaktioneller Verwendungszweck, Altersbereich und Zielgruppe, Einsatzbereich. +- `presentation_roles` und `presentation_assignments`. Rollen: Titelbild, alternatives Titelbild, Hero, Hover, Trailer, Vorschauclip, Audiovorschau, Interview, Galerie. Galerie und mehrfach belegte Rollen haben eine Reihenfolge. Die Zuordnung verweist auf das Medium. `source_version_id` wird nur gesetzt, wenn eine Inhaltsfassung ausdrücklich festgehalten wird, und danach nicht automatisch nachgezogen. +- Lesen: `EditorialProfileReader`, `PresentationMedia`. Programm- und Medienkarten sowie die Medienübersicht nutzen das. +- Oberfläche: Beschreibung und Präsentation am Medium, Angaben und Präsentation an Modul und Programm, Abschnitt Redaktion am Lizenzartikel. Im Modul und Programm öffnet „Medium aus dem Bestand auswählen“ denselben Picker wie der Aufbau. Die Übernahme als Präsentation sucht auch Medien ohne Inhaltsfassung und legt keine Fassung an. +- `preview_path` an der Medienidentität für die technische Film- oder Audioableitung. Die Website-Freigabe liest sie, ohne eine Inhaltsfassung zu verlangen. Der bisherige Weg über eine `preview`-Rendition der bereitgestellten Fassung bleibt für Unterrichtsfilme. + +## Auflösung + +1. Variante für den Kontext, wenn sie einen Text enthält. +2. Sonst die eigene Angabe am Objekt. +3. Beim Lizenzartikel sonst die Angabe der eindeutigen Quelle. Quelle ist die eine Wurzel des aktuellen Artikelstands, also entweder eine Inhaltsfassung oder eine Kompositionsfassung. Beides oder keins: keine Ableitung. +4. Sonst leer. + +Eigene Angaben des Lizenzartikels gehen vor. Nicht überschriebene Angaben bleiben an der Quelle. Preise, Rechte und der Artikelstand werden nicht gelesen und nicht geschrieben. + +## Öffentliche Karte + +`PublicCatalogReader` liest für die Kachel den Teaser, sonst die Kurzbeschreibung, sonst das Lernziel. `data.heading` und `data.summary` einer Premium-Karte ersetzen nur diese Karte. Ein leeres Kartenbild nimmt das zugeordnete Titelbild und gibt es nur über `WebsiteImage` aus. Ohne Freigabe entfällt das Bild, der Text bleibt. Ein Widget ohne verbleibenden Inhalt entfällt. Bibliotheksvorschaubilder und Originaldateien bleiben geschlossen. Ein freigegebener Teaserfilm wird über `website.media` ausgeliefert und nach dem Zurücknehmen nicht mehr. + +Die Medienübersicht filtert technische Art, Materialart und Einordnung gemeinsam. „Verwendung“ zählt Aufbauten, nicht die Klassifikation und nicht die Präsentationsrolle. + +## Grenzen + +- ADR-29, öffentliche Profile, ist nicht umgesetzt. Die bisherigen Sichtbarkeitsregeln der Karten gelten. +- Inhaltselemente bieten die Dimension „Fachliche Säule“ nicht an. Themen liegen dort bei den Säulen. Module, Programme und Lizenzartikel sehen diese Dimension, weil sie keine Säulenauswahl haben. Eine zweite Klassifikation oder eine verwaltbare Objektartenliste gibt es nicht. +- Es gibt keine neue Schlagwortverwaltung. Freie Suchbegriffe stehen in `search_terms`. Kontrollierte Werte bleiben Dimensionen. +- Kein Videoschnitt und keine neue Transcodierung. Ein gebundener Ausschnitt wird bei einer neueren Fassung nur als veraltet gekennzeichnet. +- Der Medienpicker ist nicht neu gestaltet. Am Medium und am Lizenzartikel liegt dieselbe Bestandssuche als kurze Liste, weil der Picker des Aufbaus an dessen Seite hängt (ADR-40). +- Klasse B und Klasse C sind unverändert. diff --git a/docs/architektur/website-cms-marketing-zielarchitektur.md b/docs/architektur/website-cms-marketing-zielarchitektur.md new file mode 100644 index 0000000..3037108 --- /dev/null +++ b/docs/architektur/website-cms-marketing-zielarchitektur.md @@ -0,0 +1,1189 @@ +# Lara & Felix – Technische Zielarchitektur für Website, CMS, SEO und Marketing + +**Stand:** 15.11.2026 +**Status:** Entwurf zur gemeinsamen Prüfung. Nichts hiervon ist gebaut oder erprobt. Kein Implementierungsauftrag; bestehende Dokumente, Code und Daten sind unverändert. +**Schwesterdokument:** `docs/strategie/website-cms-seo-marketing-zielkonzept.md` (im Folgenden „Zielkonzept“). Dort stehen Positionierung, Designbewertung, Informationsarchitektur, Seitentypen, Funktionsanforderungen, Roadmap und die Quellenliste (Q01 bis Q28). Dieses Dokument beschreibt die technischen Varianten, die empfohlene Lösung und die Folgen für die bestehende Architektur. +**Einordnung:** Ergänzt `03_Zielarchitektur.md`, `04_Domaenenmodell.md` und `09_CMS_Administration_Community.md`, ersetzt sie nicht. Bezeichner in Diagrammen sind Arbeitstitel. +**Änderungsstand:** Am 15.11.2026 konsolidiert mit der Fassung nach Review von `docs/analysen/ist-soll-abgleich-mitgliederbibliothek.md` (Entscheidungen E-A, E-T, E-L, E-M, E-D) und `docs/analysen/umsetzungsplan-mitgliederbibliothek.md` (Pakete 0 bis 9). Geändert: 4.4 und neu 4.5 (Eigen-CMS unter Vorbehalt, Editor-Prototyp), 6.2 (drei Zustände, Inhaltsart, Fassungswahl, Sichtbarkeit von Modulen), 6.4 (neue Paketnummern), Kapitel 14 (gemeinsame Reihenfolge, Einstufung der Pakete), dazu Folgestellen in 1, 6.3, 7, 8.5, 11, 12, 13 und 15. + +Kennzeichnung wie im Zielkonzept: **[FEST]**, **[ENTWURF]**, **[BELEGT]**, **[EMPF]**, **[ANNAHME]**, **[OFFEN]**. + +--- + +## 1. Kurzfassung + +| Thema | Empfehlung | +|---|---| +| CMS | Bevorzugt, **unter Vorbehalt**: Das vorhandene Seitensystem wird zum Vorlagen- und Abschnittssystem ausgebaut (Variante D). Entschieden wird nach einem Editor-Prototyp mit neun Bedienaufgaben (4.5). | +| Editor | Filament-Builder mit Blockvorschau aus denselben Blade-Ansichten wie die öffentliche Seite; vorhandene Vorschauroute mit Breitenumschalter. | +| Frontend | Servergerendertes Blade, Tailwind 4 mit zweistufigen Tokens, gezieltes JavaScript. Öffentliche Seiten ohne Sitzung und zwischenspeicherbar. | +| Öffentlicher Katalog | Ein **öffentliches Profil** je Fachobjekt hält nur Veröffentlichungsentscheidungen. Gezeigt wird nur eine zur Anzeige freigegebene Fassung; Seitentyp und Adresse folgen der redaktionellen Inhaltsart. Inhalte werden zur Laufzeit aus den maßgeblichen Fachdaten gelesen. | +| Gemeinsame Reihenfolge | Bibliothekspakete 0 bis 9 bleiben inhaltlich unverändert. Sechs sind unverändert umsetzbar, vier hängen an gemeinsamen Komponenten, deren Vertrag vorher feststeht (Kapitel 14). | +| SEO | Adressauflösung mit Weiterleitungstabelle, Indexierungsrichtlinie je Seitentyp und Umgebung, erzeugte Sitemap, erzeugtes Markup, Prüfungen vor Veröffentlichung. | +| Marketing | Neues Modul „Marketing“ im Kern mit eigener, personenfreier Datenhaltung, Regeln, Maßnahmen und Wirkungsmessung (Variante E). | +| KI | Einzelne, protokollierte Arbeitsschritte hinter einem Modelladapter; Ergebnis ist immer ein Vorschlag oder ein Entwurf. | +| Workflow-Werkzeug | n8n nur optional und nur für fremde Kanäle, mit eng begrenztem Zugang. | +| Reichweitenmessung | Eigenzählung ohne Cookies; selbst betriebenes Werkzeug als Ausbauweg. | + +--- + +## 2. Ausgangslage im Code [BELEGT] + +Gesichtet wurden die für die Entscheidung nötigen Stellen, kein vollständiger Audit. + +| Bereich | Befund | Fundstelle | +|---|---|---| +| Stapel | Laravel 13, Filament 5, PHP 8.4, Tailwind 4, Vite 8, PHPUnit | `composer.json`, `package.json` | +| Seiten | `pages` (eindeutiger Pfad, Zeiger auf veröffentlichte Revision), `page_revisions` (Bausteine als JSON, SEO-Titel, SEO-Beschreibung, Bearbeiter), `navigation_items` (Kopf- und Fußbereich) | `database/migrations/2026_11_15_100000_create_cms_tables.php` | +| Bausteine | sechs Arten in einer Klasse mit Regeln je Art; Bildpfade nur aus dem öffentlichen Bereich `cms/`; Linkprüfung | `app/Domain/Cms/Blocks/BlockRegistry.php` | +| Redaktion | Speichern erzeugt Revision, Veröffentlichung setzt den Zeiger, Wiederherstellung erzeugt neue Revision, Vorschau für Personal | `app/Domain/Cms/PageService.php`, `PageController::preview` | +| Routen | feste Routen für Start, Sitemap, Themen, Medien, Anmeldung, Mitgliederbereich; Auffangroute für Seiten mit **einem** Pfadteil | `routes/web.php` | +| Themen | veröffentlichte Säulen als `/themen` und `/themen/{slug}` mit zugeordneten Seiten | `ThemeController`, Migration `publish_pillars_to_the_site` | +| Kopfbereich | Titel, Beschreibung, kanonische Adresse; keine Social-Angaben, kein strukturiertes Markup; Navigation unterscheidet angemeldet und nicht angemeldet | `resources/views/layouts/site.blade.php` | +| Sitemap | Seiten und Themen, ohne Änderungsdatum | `resources/views/public/sitemap.blade.php` | +| `robots.txt` | statische Datei, erlaubt alles | `public/robots.txt` | +| Gestaltung | eigenes Stylesheet mit fünf Farbwerten, Source Sans 3 und Source Serif 4 | `resources/css/app.css` | +| Öffentliche Medien | Auftrag zum Veröffentlichen öffentlicher Medien vorhanden | `app/Jobs/PublishPublicMedia.php` | + +**Nicht geprüft:** Format und Bereinigung des Fließtexts; Erzeugung von Bildgrößen; Stand der Trennung der drei Herkunftsadressen aus `03`, Abschnitt 6; Schutz der Testinstanz am Reverse Proxy; ob öffentliche Routen eine Sitzung öffnen. + +**Bewertung:** Der in `10`, Abschnitt 2.1 als Hauptrisiko benannte Teil (Entwurf, Vorschau, Revision, Wiederherstellung für Seiten) besteht. Es fehlen Struktur (Seitentypen, Unterpfade, Vorlagen), Gestaltungsspielraum (Varianten), Katalogbezug und die SEO-Mechanik. + +--- + +## 3. Architekturtreiber, Kriterien und Gewichtung + +### 3.1 Treiber + +| Treiber | Herkunft | +|---|---| +| Redaktionelle Änderungen ohne Entwickler und ohne Release | WEB-001 [FEST] | +| Keine widersprüchlichen, mehrfach gepflegten Datenbestände | WEB-004 [FEST] | +| Eine Verwaltung, eine Anmeldung, getrennte Herkunftsadressen | `09`, B.1, C.8 [ENTWURF] | +| Unveränderliche Fassungen, eine Stelle entscheidet über Zugriff | `03`, Abschnitt 8 [FEST] | +| Web-Prozess ohne Schreibrecht auf Medien, ohne Zugriff auf Originale | Projektregel [FEST] | +| Betrieb durch eine Person auf einem Server | VIS-006 [FEST] | +| Migrationen abwärtskompatibel; Deployments nur über Workflows | Projektregel [FEST] | +| Tests ohne Netzwerkaufrufe; nie gegen Produktion | Projektregel [FEST] | + +### 3.2 Kriterien und Gewichte **[EMPF, eigene Gewichtung]** + +| Kriterium | Gewicht | Begründung | +|---|---|---| +| Fachlicher Nutzen | 15 | Beitrag zur Darstellung des Trainingskonzepts | +| Konfigurierbarkeit | 15 | Kernforderung des Auftrags | +| UX-Qualität | 10 | Besucher, Mitglieder, Redaktion | +| Entwicklungsaufwand | 10 | einmalig, durch Agenten gut leistbar; deshalb nicht höher | +| Betriebskosten | 5 | Unterschiede zwischen den Varianten sind klein | +| Wartbarkeit | 15 | ein Betreiber über Jahre | +| Integrationsfähigkeit | 15 | Katalog, Lizenzen, Rollen, Audit | +| Sicherheit | 5 | Grundniveau ist in allen Varianten erreichbar; Unterschiede in der Angriffsfläche | +| Erweiterbarkeit | 5 | weitere Linien und Zielgruppen | +| Migrationsrisiko | 5 | geringe Bestandsmenge | + +Bewertung von 1 (schwach) bis 5 (stark); bei Aufwand, Kosten und Risiko bedeutet 5 „gering“. + +--- + +## 4. CMS-Varianten und Bewertung + +### 4.1 Untersuchte Varianten + +| Variante | Beschreibung | Belegte Eckdaten | +|---|---|---| +| **A – Eigenes Seitensystem linear erweitern** | weitere Bausteine und Felder im heutigen Aufbau | Bestand, Kapitel 2 | +| **B1 – Statamic im selben Laravel** | Laravel-CMS mit eigener Verwaltung, Inhalte als Dateien oder in der Datenbank | Version 6.42 vom 13.11.2026, verlangt Laravel 12.40 oder 13, Lizenzangabe „proprietary“ (Q14); Pro 349 USD je Site, danach 99 USD jährlich; Pro bringt mehrere Nutzer, Rollen, Revisionen, Schnittstellen (Q13) | +| **B2 – freier Page Builder als Filament-Plugin** | Zeilen-, Spalten- oder Canvas-Editor in der vorhandenen Verwaltung | mehrere Pakete für Filament 5, etwa Layup mit Zeilen und Spalten (Q12) und GrapesJS-Einbindungen; alle jung | +| **B3 – Twill** | Laravel-CMS mit Blockeditor und eigener Verwaltung | Version 3.6 vom 19.07.2026, Laravel 9 bis 13, Apache-2.0 (Q15) | +| **C1 – Headless-Dienst mit visuellem Editor** | Inhalte beim Dienst, Darstellung durch Laravel über Schnittstelle | Storyblok: kostenlos für einen Platz, 99 USD monatlich für fünf Plätze (Q16) | +| **C2 – Payload mit eigenem Frontend** | Node-CMS innerhalb von Next.js | MIT, „Next.js native“ (Q17); in `10` bereits nicht empfohlen | +| **D – Hybrid: Eigenkern mit Vorlagen, Varianten, Katalogbausteinen, Vorschau-Editor** | Ausbau des Bestands; Filament-Bordmittel für die Bearbeitung | Filament-Builder mit Blockvorschau aus Blade-Ansichten, auch interaktiv (Q08); eigene Blöcke im Texteditor (Q09); Vorschau-Plugin für Filament 5 verfügbar (Q10); Blockeditor-Feld Mason für Filament 4 und 5, MIT (Q11) | + +WordPress mit Erweiterungen und reine Headless-Dienste ohne visuellen Editor (Directus, Strapi) sind in `10`, Abschnitt 2 bewertet und verworfen; die Gründe gelten fort. + +### 4.2 Entscheidungsmatrix + +| Kriterium | Gewicht | A | B1 | B2 | B3 | C1 | C2 | **D** | +|---|---|---|---|---|---|---|---|---| +| Fachlicher Nutzen | 15 | 4 | 4 | 3 | 4 | 3 | 3 | **5** | +| Konfigurierbarkeit | 15 | 3 | 5 | 5 | 4 | 5 | 4 | **4** | +| UX-Qualität | 10 | 3 | 4 | 3 | 4 | 5 | 4 | **4** | +| Entwicklungsaufwand | 10 | 3 | 3 | 4 | 3 | 2 | 1 | **3** | +| Betriebskosten | 5 | 5 | 4 | 5 | 5 | 3 | 3 | **5** | +| Wartbarkeit | 15 | 4 | 3 | 2 | 3 | 3 | 2 | **4** | +| Integrationsfähigkeit | 15 | 5 | 3 | 3 | 3 | 2 | 2 | **5** | +| Sicherheit | 5 | 5 | 3 | 3 | 3 | 3 | 3 | **5** | +| Erweiterbarkeit | 5 | 4 | 4 | 3 | 4 | 4 | 4 | **4** | +| Migrationsrisiko | 5 | 5 | 3 | 3 | 3 | 2 | 1 | **5** | +| **Gewichtet (von 5)** | | 3,95 | 3,65 | 3,35 | 3,55 | 3,25 | 2,70 | **4,35** | + +**Empfindlichkeit:** Wird Konfigurierbarkeit auf 30 und UX auf 20 angehoben (zulasten von Nutzen, Wartbarkeit und Integration), liegt D bei 4,20, Statamic bei 4,00, der Headless-Dienst bei 3,85. Die Reihenfolge bleibt, der Abstand schrumpft. Die Empfehlung hängt also daran, dass Integration und Wartbarkeit für dieses Vorhaben mindestens so wichtig sind wie Bearbeitungskomfort. + +### 4.3 Begründung der Bewertungen + +| Variante | Entscheidende Vorteile | Nachteile und Risiken | +|---|---|---| +| A | kein neues Teil; volle Integration | ohne Vorlagen und Varianten entsteht für jede neue Seitenform ein Auftrag; verfehlt die Konfigurierbarkeit | +| B1 Statamic | ausgereifte Redaktion mit Live-Vorschau, Revisionen, Blueprints | zweite Verwaltung neben Filament mit eigenem Nutzer- und Rechtemodell; widerspricht „eine Verwaltung“ und der Trennung von Alltags- und Systemkonto; Katalogbausteine wären eigene Feldtypen und damit dieselbe Eigenentwicklung; proprietäre Lizenz | +| B2 freier Builder | sofort sehr hohe Freiheit | genau die im Zielkonzept, 10.4 ausgeschlossenen Folgen (uneinheitlich, nicht prüfbar barrierearm); junge Pakete mit ungewisser Pflege; Inhalte im Format des Pakets | +| B3 Twill | bewährter Blockeditor | zweite Verwaltung wie B1; eigene Medienbibliothek; Katalogbezug Eigenbau | +| C1 Headless-Dienst | beste visuelle Bearbeitung | Inhalte außerhalb des Kerns; Katalogdaten müssten kopiert oder bei jedem Aufruf zusammengeführt werden (verletzt WEB-004 oder kostet Laufzeit und Verfügbarkeit); laufende Kosten; weiterer Auftragsverarbeiter | +| C2 Payload | moderne Redaktion | dritter Stapel (Node), zweite Darstellungsschicht, höchster Aufwand und höchstes Risiko | +| D Hybrid | Katalogbausteine ohne Datenkopie; eine Verwaltung, ein Rollen- und Auditmodell; baut auf Erprobtem auf; schrittweise lieferbar | Eigenentwicklung bleibt Pflegeaufwand; Bearbeitungskomfort unter dem eines Spezialprodukts; Disziplin bei Varianten nötig | + +### 4.4 Empfehlung unter Vorbehalt und Wechselkriterien + +**[EMPF] Variante D ist die bevorzugte Variante unter Vorbehalt.** Die Matrix bewertet Bearbeitungskomfort und Aufwand von D nach Dokumentation, nicht nach Erprobung. Entschieden wird nach dem Editor-Prototyp aus 4.5. Bis dahin beginnt kein Paket der Stufe W2. + +**Wann eine Alternative vorzuziehen wäre:** + +- **Mason als Editorfläche innerhalb von D**, wenn der Prototyp an der Bedienung über Formular und Vorschau scheitert, die Technik aber trägt. Der Bausteinvertrag aus 5.3 ist so gewählt, dass die Editorfläche austauschbar bleibt. +- **B1 (Statamic)**, wenn auch die zweite Runde scheitert, oder wenn mehrere nichttechnische Redakteure täglich arbeiten und die Marketingseiten kaum Katalogbezug haben. +- **C1 (Headless-Dienst)**, wenn eine Agentur die Marketingseiten gestaltet und betreibt. + +**Rückweg:** Bausteindaten sind strukturiertes JSON mit festem Vertrag und lassen sich in jedes blockorientierte System überführen. Die Entscheidung bindet nicht dauerhaft. + +### 4.5 Editor-Prototyp als Entscheidungskriterium + +**Zweck:** nachweisen, dass der Betreiber mit Filament-Bordmitteln alltägliche Seitenarbeit ohne Hilfe erledigt, und dass Editor und öffentliche Darstellung dieselben Ansichten und dieselben Daten verwenden. + +**Rahmen:** + +| | | +|---|---| +| Bauzeit | höchstens drei Arbeitstage; Erprobung ein halber Tag | +| Art | Wegwerfcode auf einem Feature-Branch; lokal oder auf der Testinstanz erprobt; nie Produktion | +| Datenbank | **keine Migration.** Der Prototyp arbeitet auf den vorhandenen Tabellen `pages` und `page_revisions`. | +| Gestaltung | vorhandenes Stylesheet; kein Designsystem | +| Berührte Dateien | nur Seiteneditor, Bausteinregister und Bausteinansichten; keine Mitgliedsansichten, keine Kataloglogik | +| Verhältnis zur Bibliothek | unabhängig von den Paketen 0 bis 9; kann parallel zu Paket 1 und 2 laufen | + +**Umfang:** + +| Teil | Im Prototyp | +|---|---| +| Bausteine | vier Arten: Heldenbereich mit zwei Varianten; Bild und Text mit zwei Varianten; FAQ aus dem Bestand; Programmkarten als Katalogbaustein | +| Katalogbaustein | wählt zwei vorhandene Kompositionen über ein Suchfeld und zeigt deren gespeicherte Bezeichnung; speichert nur Kennungen | +| Bearbeitung | Filament-Builder mit Blockvorschau aus den öffentlichen Blade-Ansichten | +| Ganzseitige Vorschau | vorhandene Vorschauroute mit Umschalter für 390, 768 und 1440 px | +| Vorlage | eine vorhandene Seite wird dupliziert | +| Globaler Abschnitt | eine eigene Seite, deren Bausteine über einen Verweis-Baustein eingebunden werden | +| Nicht enthalten | Seitentypen, Schemaversion, Medienbibliothek, Prüfungen, Zeitsteuerung, öffentliches Profil | + +**Bedienaufgaben.** Der Betreiber löst sie allein, nach einer Einweisung von höchstens zehn Minuten, ohne Rückfrage. Gemessen wird mit der Uhr; eine zweite Person notiert Stockungen. + +| Nr. | Aufgabe | Zeitgrenze | Bestanden, wenn | +|---|---|---|---| +| T1 | Neue Landingpage aus der Vorlage anlegen, drei Texte ändern, veröffentlichen | 10 min | die Seite ist unter eigener Adresse öffentlich und die Vorlage unverändert | +| T2 | Abschnitt „Bild und Text“ hinzufügen, Bild wählen, Alternativtext setzen, Variante wechseln | 3 min | die Blockvorschau zeigt die gewählte Variante ohne Speichern | +| T3 | Zwei Abschnitte umsortieren, einen duplizieren | 1 min | die Reihenfolge stimmt in der ganzseitigen Vorschau | +| T4 | Programmkarten: zwei Programme auswählen und ihre Reihenfolge tauschen | 2 min | die Karten zeigen die Bezeichnungen aus den Fachdaten; kein Titel wurde getippt | +| T5 | In der Vorschau bei 390 px einen zu langen Titel erkennen und beheben | 3 min | der Fehler wird ohne Hinweis gefunden und in derselben Sitzung korrigiert | +| T6 | Globalen Abschnitt ändern | 3 min | die Änderung erscheint nach Veröffentlichung auf beiden einbindenden Seiten | +| T7 | Frühere Revision wiederherstellen | 1 min | die Live-Seite zeigt den früheren Stand | +| T8 | Seite mit zwanzig Abschnitten öffnen, einen Text ändern, speichern | je Vorgang 3 s auf der Testinstanz | keine verlorene Eingabe, kein Abbruch | +| T9 | Pflichtfeld leer lassen und speichern | 30 s bis zum Auffinden | die Meldung steht am betroffenen Abschnitt | + +**Technische Kriterien:** + +| Nr. | Kriterium | +|---|---| +| K1 | Blockvorschau und öffentliche Seite verwenden je Baustein dieselbe Blade-Ansicht; es gibt keinen doppelten Darstellungscode. | +| K2 | Die vom Editor gespeicherten Daten entsprechen der Hülle aus 5.3 und werden von der öffentlichen Darstellung unverändert gelesen. | +| K3 | Vorhandene Seiten mit den sechs Bestandsbausteinen bleiben bearbeitbar und werden unverändert dargestellt. | +| K4 | Kein zusätzliches Paket ist nötig, oder es ist genau eines benannt und begründet. | +| K5 | Die Bauzeit von drei Tagen wird eingehalten. | + +**Entscheidungsregel:** + +| Ergebnis | Folge | +|---|---| +| T1, T4 und T8 bestanden, insgesamt mindestens acht von neun Aufgaben, K1 bis K5 erfüllt, und der Betreiber bejaht „so würde ich wöchentlich arbeiten“ | Der Vorbehalt entfällt. ADR-28 wird Entscheidung; W2 beginnt. | +| K1 bis K3 erfüllt, aber T2, T3 oder T5 scheitern an der Bedienung | Zweite Runde von höchstens zwei Tagen mit Mason als Editorfläche auf demselben Bausteinvertrag, dieselben neun Aufgaben. | +| Zweite Runde scheitert, oder K1, K2 oder K5 sind verfehlt | Gegenprobe mit Statamic an denselben neun Aufgaben, bevor W2 beginnt. Katalogbausteine und öffentliches Profil (Kapitel 6) bleiben davon unberührt; sie wären in jeder Variante Eigenentwicklung. | + +Das Ergebnis wird mit Zeiten je Aufgabe und den beobachteten Stockungen festgehalten. Der Prototyp-Code wird nicht übernommen; W2 baut auf dem Vertrag, nicht auf dem Wegwerfcode. + +--- + +## 5. Empfohlene CMS- und Frontend-Architektur + +### 5.1 Bausteinsicht + +```mermaid +flowchart TB + subgraph Verw["Verwaltung (Filament)"] + ED["Seiteneditor: Builder, Vorschau"] + VL["Vorlagen und globale Abschnitte"] + MB["Medienbibliothek Website"] + OP["Öffentliche Profile"] + PR["Prüfungen vor Veröffentlichung"] + end + subgraph Web["Modul Web und CMS"] + PG["Seiten, Revisionen, Weiterleitungen"] + BR["Bausteinregister"] + RS["Adressauflösung"] + RD["Darstellung: Blade-Komponenten, Tokens"] + SE["SEO-Dienste: Sitemap, Markup, Kopfangaben"] + PC["Lesesicht Öffentlicher Katalog"] + end + subgraph Fach["Fachmodule (unverändert)"] + INH["Inhalte und Versionen"] + KAT["Katalog"] + VER["Veröffentlichung"] + end + ED --> PG + VL --> PG + OP --> PC + PR --> PG + RS --> PG + RS --> PC + RD --> BR + BR --> PC + PC -->|"nur lesen"| INH + PC -->|"nur lesen"| KAT + PC -->|"nur lesen"| VER + SE --> PG + SE --> PC +``` + +Die Leserichtung bleibt wie in `03`, Abschnitt 3: Web und CMS darf Katalog und Veröffentlichung aufrufen; Inhalte und Katalog kennen das CMS nicht. + +### 5.2 Datenmodell des Seitensystems + +```mermaid +erDiagram + PAGE ||--o{ PAGE_REVISION : "hat Revisionen" + PAGE ||--o{ REDIRECT : "frühere Pfade" + PAGE }o--o| TOPIC_CLUSTER : "gehört zu" + PAGE_REVISION }o--o{ SHARED_SECTION : "bindet ein, per Verweis" + SHARED_SECTION ||--o{ SHARED_SECTION_REVISION : "hat Revisionen" + PAGE_REVISION }o--o{ WEB_MEDIA : "verwendet" + PAGE }o--o| PUBLIC_LISTING : "Rahmen für Objektseite" + + PAGE { + id id PK + string path "mehrteilig, eindeutig" + string type "standard, thema, landing, beitrag, hilfe, recht, kampagne" + string status "entwurf, veroeffentlicht, zurueckgezogen, archiviert" + bool is_template "nie routbar" + id published_revision_id + id scheduled_revision_id + datetime scheduled_at + } + PAGE_REVISION { + id id PK + json blocks "Bausteinvertrag 5.3" + string seo_title + string seo_description + string robots "richtlinie, index, noindex" + string canonical_override + id social_image_id + id author_id "bei Beitrag" + id reviewed_by + date content_date "Stand" + json sources "Quellenliste" + string origin "mensch, ki" + id ai_run_id + } + REDIRECT { + string from_path PK + string to_path + int status "301 oder 410" + string cause "automatisch, manuell" + } + SHARED_SECTION { + id id PK + string key + id published_revision_id + } + WEB_MEDIA { + id id PK + string path "öffentlicher Bereich" + string alt + bool decorative + json focal_point + string release_status "Asset-Katalog" + string source_note + } +``` + +**Regeln:** + +- **Vorlage = Seite mit Kennzeichen.** Sie nutzt Editor, Revision und Vorschau und ist nie routbar. „Seite aus Vorlage“ kopiert die veröffentlichte Revision der Vorlage in eine neue Seite. Spätere Änderungen der Vorlage wirken nicht auf bestehende Seiten. +- **Globaler Abschnitt = Verweis, keine Kopie.** Die Darstellung löst zur Laufzeit auf die veröffentlichte Revision des Abschnitts auf. Eine ältere Seitenrevision zeigt deshalb den heutigen globalen Abschnitt. Das ist zulässig, weil Seitenrevisionen Bearbeitungshilfe und kein Vertragsbestandteil sind (`04`, 5.1). +- **SEO-Felder bleiben an der Revision** und sind damit versioniert und gemeinsam mit dem Inhalt veröffentlichbar (`seo-prinzipien`, §5). +- **Zeitsteuerung:** Ein geplanter Zeiger und ein Zeitpunkt an der Seite; die vorhandene Zeitsteuerung des Frameworks setzt den Zeiger. Kein eigener Mechanismus. +- **Zurückziehen** setzt den Status und trägt den Pfad mit Status 410 in die Weiterleitungstabelle ein. +- **Migration:** alle Ergänzungen als neue Spalten und Tabellen mit Vorgabewerten. Bestehende Seiten erhalten Typ „standard“. + +### 5.3 Bausteinvertrag + +Jeder Baustein in `blocks` hat dieselbe Hülle: + +| Feld | Bedeutung | +|---|---| +| `id` | stabile Kennung, bleibt über Revisionen erhalten; dient als Sprungmarke und als Quelle für Aufrufzählung | +| `type` | Bausteinart aus dem Register | +| `v` | Schemaversion der Art | +| `variant` | benannte Variante der Art | +| `settings` | Aufzählungswerte: Flächenton, Breite, Abstand, Themenakzent | +| `data` | redaktionelle Inhalte | +| `refs` | Verweise auf Fachobjekte oder Medien, nur Kennungen | + +Jede Bausteinart ist eine Klasse mit: Formularschema für die Verwaltung, Prüfregeln, Liste der Varianten, Blade-Ansicht, Funktion zum Auflösen der Verweise, Funktion „Links und Medien dieses Bausteins“ (für Prüfungen und Verwendungsnachweis) und optional einem Beitrag zum strukturierten Markup. + +**Schemaversion statt Datenmigration:** Ändert sich das Schema einer Art, hebt eine Aufwärtsfunktion ältere Daten beim Lesen an. Alte Revisionen bleiben unangetastet. Die sechs vorhandenen Arten werden als Version 1 übernommen. + +**Katalogbausteine** speichern ausschließlich Verweise und Anzeigeoptionen. Ist ein verwiesenes Objekt nicht öffentlich, stellt der Baustein nichts dar und die Prüfung meldet es; der Besucher sieht keinen Fehler. + +**Grenze:** Kein Baustein nimmt freies HTML oder Skripte an. Fließtext wird beim Speichern bereinigt. + +### 5.4 Editor und Vorschau + +| Teil | Lösung | Beleg | +|---|---|---| +| Bearbeitung | Filament-Builder: Blöcke in Gruppen, Suche, Duplizieren, Sortieren, Einklappen | Q08 | +| Vorschau im Formular | `blockPreviews()` rendert je Block die Blade-Ansicht mit den Blockdaten; es ist dieselbe Ansicht wie öffentlich | Q08 | +| Ganzseitige Vorschau | vorhandene Route für Revisionen, ergänzt um einen Rahmen mit drei Breiten (390, 768, 1440 px) | Bestand | +| Vorschau vor dem Speichern | optional über das Vorschau-Plugin | Q10 | +| Text innerhalb von Bausteinen | Filament-Texteditor mit eingeschränkter Werkzeugleiste | Q09 | +| Schutz großer Seiten | Obergrenze je Seite über `maxItemsForProcessing()` | Q08 | + +Die Auswahl der Fachobjekte in Katalogbausteinen erfolgt über Suchfelder, die nur öffentlich geschaltete Objekte anbieten. + +### 5.5 Frontend-Stapel + +| Thema | Festlegung | Begründung | +|---|---|---| +| Darstellung | Blade, servergerendert | bereits beschlossen (`10`, Abschnitt 2.1); crawlbar ohne JavaScript | +| Komponenten | Blade-Komponenten in zwei Familien: Grundelemente und Bausteine | Wiederverwendung in Website und Mitgliederbereich | +| Stil | Tailwind 4; Tokens als `@theme`-Variablen | vorhanden | +| Tokens | eine Quelldatei im Repository mit Markenwerten und Bedeutungswerten; daraus die Variablen | Zielkonzept, 7.1; Änderungen sind selten und laufen über das Deployment | +| JavaScript | kleine Module für Navigation, Aufklappen, Filterauszug, Player | keine Einzelseiten-Anwendung | +| Livewire | nur in der Verwaltung und, wo es Bedienung spart, im Mitgliederbereich; **nicht** auf öffentlichen Seiten | Zwischenspeicherbarkeit | +| Schriften | lokal ausgeliefert, zwei Familien, mit `font-display: swap` und Vorabladen der Auszeichnungsschrift | Datenschutz, Ladezeit | +| Bilder | abgeleitete Größen und Formate über die Hintergrundverarbeitung; `srcset`, feste Abmessungen, Fokuspunkt als Objektposition | der Web-Prozess schreibt nicht in den Medienbestand | +| Symbole | eigene SVG-Familie als Sprite | Zielkonzept, Kapitel 6 | +| Druck | eigenes Druckstylesheet für Programm- und Angebotsseiten | Kurzunterlage für Institutionen | + +**Markenwerte in der Datenbank** (Stufe 3 des Konfigurationsmodells) sind Zielbild und nicht Teil des MVP: Die Quelldatei im Repository genügt, solange sich Markenwerte seltener als einmal im Jahr ändern. + +### 5.6 Auslieferung und Zwischenspeicher + +**[EMPF]** + +- Öffentliche Seiten werden für alle Besucher identisch gerendert. Die Kopfzeile zeigt einen neutralen Eintrag „Anmelden“ beziehungsweise „Mein Bereich“, der zum Mitgliederbereich führt; die heutige Unterscheidung im Layout entfällt. +- Öffentliche Routen laufen ohne Sitzung. Formulare (Anfrage, Newsletter) liegen auf eigenen Routen mit Mengenbegrenzung und Schutzfeld. +- Die fertige Antwort wird in der Anwendung zwischengespeichert, mit dem vorhandenen Speicher (Datei oder Datenbank; kein weiterer Dienst, `10`, Abschnitt 3). +- Entwertet wird ereignisgesteuert: Seite veröffentlicht oder zurückgezogen, globaler Abschnitt veröffentlicht, öffentliches Profil geändert, Artikel-Stand veröffentlicht oder zurückgezogen, Angebotsfassung aktiviert oder beendet, Säule geändert. Zusätzlich eine kurze Höchstdauer als Sicherheitsnetz. +- Angemeldete Bereiche werden nie zwischengespeichert (`09`, A.6). + +**Zielkonflikt:** Ereignisgesteuerte Entwertung ist fehleranfällig. Ausweg für den Start: gesamten Seitenspeicher bei jedem der genannten Ereignisse leeren. Bei dieser Seitengröße ist das unkritisch. + +--- + +## 6. Öffentlicher Katalog + +### 6.1 Fünf Datenklassen und ihre Hoheit + +| Klasse | Beispiele | Führend | Änderungsweg | Öffentlich sichtbar durch | +|---|---|---|---|---| +| **1 Fachliche Inhaltsdaten** | Medium, Fassung, Datei, Lehrtext | Inhalte und Versionen | neue Fassung | nie die Datei; nur freigegebene Vorschau | +| **2 Didaktische Kompositionen** | Modul, Programm, Reihenfolge, Rollen, Lernziele | Inhalte und Versionen | neue Kompositionsfassung | öffentliches Profil | +| **3 Kommerzielle Daten** | Artikel, Paket, Angebotsfassung, Rechte, Preis | Katalog, Veröffentlichung | neue Fassung, neuer Stand | Angebotsseite und Angebotsbausteine | +| **4 Redaktionelle Präsentation** | Seiten, Bausteine, Vorlagen, Navigation, SEO-Felder, öffentliche Profile | Web und CMS | Revision, Veröffentlichung | selbst | +| **5 Marketing- und Analysedaten** | Suchwerte, Zählwerte, Befunde, Maßnahmen, KI-Läufe | Marketing (neu) | Abruf, Regeln, Entscheidungen | nie | + +Zusätzlich die aktuellen Anzeigedaten der Klasse A aus `produktkonfiguration`, §4 (Titel, Kurzbeschreibung, Vorschaubild, Dimensionen): Sie liegen an der stabilen Identität und gelten für Bibliothek **und** Website. Es gibt keinen zweiten öffentlichen Titel. + +**Keine Kopien:** Klasse 4 speichert Verweise auf Klasse 2 und 3, nie deren Inhalte. Klasse 5 speichert Adressen und verdichtete Zahlen, keine Konten. + +### 6.2 Drei Zustände und das öffentliche Profil + +Der Ist-Soll-Abgleich der Bibliothek trennt technische Bereitschaft und Anzeigefreigabe (Entscheidung E-A) und verweist die öffentliche Vorstellung von Programmen an dieses Konzept. Daraus ergeben sich drei aufeinander aufbauende Zustände. + +| Zustand | Ebene | Bedeutung | Herkunft | Wirkung | +|---|---|---|---|---| +| **technisch bereit** | Inhalts- oder Kompositionsfassung | vollständig, unveränderlich, nicht gesperrt | Bestand | als Baustein und als Wurzel eines Artikel-Stands wählbar; **für sich nirgends sichtbar** | +| **zur Anzeige freigegeben** | genau eine Kompositionsfassung | redaktionelle Freigabe für Mitglieder; ändert keine Mitglieder, legt keinen Artikel an | E-A, Paket 3 [FEST] | Struktur erscheint in der Bibliothek berechtigter Personen und in der redaktionellen Vorschau | +| **öffentlich gelistet** | Identität mit einer gezeigten Fassung | öffentliche Objektseite | dieses Konzept, Stufe W3 [EMPF] | Objektseite, Katalogbausteine, Sitemap | + +Davon unabhängig bleibt die kommerzielle Veröffentlichung im Artikel-Stand. Sie entscheidet, ob ein Blatt ausgeliefert und ob etwas gekauft werden kann, nicht ob eine Struktur gezeigt wird. + +**Regeln [EMPF]:** + +1. **Teilmenge.** Öffentlich gezeigt wird nur eine Fassung, die zur Anzeige freigegeben ist. Eine nur bereite Fassung erscheint auf keiner öffentlichen Seite, auch nicht als Bestandteil. +2. **Eigene Entscheidung.** Die Anzeigefreigabe macht nichts öffentlich. Die Listung ist eine zweite, ausdrückliche Entscheidung an der Identität. +3. **Rücknahme.** Die Anzeigefreigabe einer öffentlich gezeigten Fassung lässt sich erst zurücknehmen, wenn das Profil auf eine andere freigegebene Fassung zeigt oder verborgen ist. +4. **Eine Quelle für Titel.** Anzeigetitel und Kurzbeschreibung kommen aus den Klasse-A-Feldern der Identität (Paket 4) und gelten für Bibliothek und Website. +5. **Keine Rückwirkung.** Die Bibliothek liest das öffentliche Profil nicht. Das Profil vergibt keine Rechte und ändert keine Mitgliedersicht. +6. **Nachweis.** Listen, Entlisten und Wechsel der gezeigten Fassung werden protokolliert. + +```mermaid +erDiagram + PUBLIC_LISTING }o--|| SUBJECT : "zeigt ein Fachobjekt" + PUBLIC_LISTING }o--o| COMPOSITION_VERSION : "gezeigte Fassung" + COMPOSITION_VERSION ||--o| DISPLAY_RELEASE : "Anzeigefreigabe (Paket 3)" + PUBLIC_LISTING }o--o| LICENSE_ARTICLE : "führender Artikel, nur bei folgt_stand" + PUBLIC_LISTING }o--o| WEB_MEDIA : "öffentlich freigegebenes Bild" + PUBLIC_LISTING }o--o| PAGE : "redaktioneller Rahmen" + + PUBLIC_LISTING { + id id PK + string subject_type "saeule, komposition, inhaltselement, angebot" + uuid subject_id + string slug "eindeutig je Seitentyp" + string status "verborgen, gelistet" + string version_mode "folgt_stand, fest" + uuid shown_version_id "muss zur Anzeige freigegeben sein" + string robots "richtlinie, index, noindex" + string seo_title "optional, sonst aus Klasse A" + string seo_description + datetime listed_at + } +``` + +Das Profil enthält nur **Veröffentlichungsentscheidungen**: sichtbar oder nicht, Adresse, gezeigte Fassung, öffentlich freigegebenes Bild, SEO-Überschreibung, optional eine redaktionelle Rahmenseite. Die vorhandene Veröffentlichung der Säulen als Themen ist der erste Fall dieses Musters. + +#### Inhaltsart bestimmt Seitentyp und Adresse + +**[FEST]** Technische Struktur (`CompositionKind` mit `kurs`, `uebung`, `kombination`) und redaktionelle Inhaltsart sind getrennt. Programm, Modul, Merkblatt und Traineranleitung sind Werte der konfigurierbaren Inhaltsart mit stabiler Kennung; sie werden je Identität ausdrücklich gesetzt (Entscheidung E-T, Paket 2). + +**[EMPF]** Für die Website folgt daraus: + +- Öffentlich gelistet werden kann nur eine Identität **mit gesetzter Inhaltsart**. Die technische Bezeichnung des Strukturtyps erscheint öffentlich nie. +- Eine Zuordnungstabelle verbindet die stabile Kennung der Inhaltsart mit Seitentyp und Adresspräfix: `programm` → `/programme`, `modul` → `/module`. Alle übrigen Werte und einzelne Medien können nur als Materialbeispiel unter `/beispiele` erscheinen. +- Ein neuer Wert der Inhaltsart braucht keine Codeänderung, um in Strukturen und Filtern zu erscheinen. Eine eigene öffentliche Seitenart erhält er erst durch einen Eintrag in der Zuordnung (Konfigurationsstufe 3) und, falls die Darstellung abweicht, durch Entwicklung. +- Wird die Inhaltsart eines gelisteten Objekts geändert, wechselt seine Adresse; die Weiterleitung entsteht wie bei jeder Pfadänderung. + +#### Welche Fassung zeigt die öffentliche Seite + +Es wird immer genau eine Fassung gezeigt. + +| Fall | Merkmal | Modus | Gezeigte Fassung | Bei Abweichung | +|---|---|---|---|---| +| **A – Programm ist Wurzel eines Lizenzartikels** | ein Artikel, dessen Stand die Komposition als Wurzel fixiert, ist als führend benannt | `folgt_stand` | Wurzelfassung des aktuellen veröffentlichten Stands, **sofern zur Anzeige freigegeben**; andernfalls bleibt die bisher gezeigte Fassung stehen | Befund „neuer Stand ohne Anzeigefreigabe“ | +| **B – Programm nur über mehrere Artikel abgedeckt** | kein Artikel-Stand hat eine Programmfassung als Wurzel; die Module sind eigene Artikel | `fest` | von der Redaktion bestätigte Fassung. Vorschlag des Systems: die höchste zur Anzeige freigegebene Fassung | Befund, wenn eine höhere freigegebene Fassung existiert oder die Abdeckung der gezeigten Fassung sinkt | +| **C – beides** | führender Programm-Artikel und zusätzlich Einzelartikel für Module | `folgt_stand` | wie A | wie A; Einzelangebote erscheinen als „deckt teilweise“ | +| **D – noch nicht verkauft** | kein Stand, kein aktives Angebot | `fest` | bestätigte freigegebene Fassung; die Seite hat keinen Angebotsbereich | — | + +**Begründung für Fall B.** Ohne Programm-Wurzel gibt es keinen Stand, dem die Seite folgen könnte. Eine neu freigegebene Programmfassung kann Kindesfassungen nennen, die noch in keinem veröffentlichten Stand der Modul-Artikel liegen; die Seite würde dann Inhalte beschreiben, die kein Angebot liefert. Deshalb bestätigt die Redaktion die Fassung, und der Abdeckungsbefund (Paket 7) wird gegen genau diese Fassung gerechnet. + +**Übereinstimmung mit der Bibliothek.** Nach E-A sieht ein Mitglied mit Programm-Artikel die Wurzelfassung seines berechtigten aktuellen Stands, ein Mitglied mit einzelnen Modul-Artikeln die höchste zur Anzeige freigegebene Programmfassung mit mindestens einem berechtigten Blatt. Im Fall A ist das dieselbe Fassung wie öffentlich. Im Fall B ist es dieselbe, solange die Redaktion dem Vorschlag folgt; andernfalls weist der Befund darauf hin. + +**Abdeckung je Angebot.** Für jedes Blatt der gezeigten Fassung gilt: gedeckt, wenn genau diese Inhaltsfassung im aktuellen veröffentlichten Stand eines Artikels liegt, der zum aufgelösten Umfang der aktiven Angebotsfassung gehört. Daraus folgt je Angebot „deckt vollständig“, „deckt teilweise“ oder „deckt nicht“; nicht gedeckte Blätter werden als „nicht enthalten“ ausgewiesen. Gelesen wird je Angebot genau eine aktive Fassung, bei Dubletten die höchste aktive Nummer (Paket 1). + +#### Sichtbarkeit enthaltener Module und Materialien + +| Gegenstand | Auf der Programmseite | Eigene öffentliche Seite | +|---|---|---| +| **Modul oder andere enthaltene Komposition** | erscheint an ihrer Position als Strukturzeile mit Anzeigetitel, Inhaltsart, Rolle der Verwendung sowie Zahl und Art der enthaltenen Materialien. Das gehört zur freigegebenen Programmstruktur und braucht keine eigene Freigabe des Moduls. | nur mit eigenem Profil. Voraussetzung ist eine **eigene Anzeigefreigabe einer Modulfassung** (E-A) und eine gesetzte Inhaltsart. | +| **Verlinkung Programm → Modul** | nur, wenn die öffentlich gezeigte Modulfassung dieselbe ist wie die in der gezeigten Programmfassung fixierte Kindesfassung | andernfalls Zeile ohne Link und Befund „Modulseite zeigt andere Fassung als das Programm“ | +| **Film, Dokument, Übungstext** | Zeile mit Anzeigetitel, Inhaltsart und Rolle | nur als Materialbeispiel mit ausdrücklicher öffentlicher Freigabe; nie die Datei | +| **Enthaltenes Element ohne Inhaltsart** | Zeile mit Anzeigetitel und Rolle, ohne Typangabe; Warnung in den Prüfungen | keine | + +Die Verlinkungsregel verhindert, dass eine Modulseite Lernziele einer neueren Fassung beschreibt, während das verlinkende Programm eine ältere enthält und liefert. Der Abschnitt „Enthalten in“ der Modulseite nennt nur öffentlich gelistete Programme, deren gezeigte Fassung dieses Modul enthält. + +#### Was die öffentliche Seite liest + +Klasse-A-Daten der Identität; die Inhaltsart; aus der gezeigten Fassung Reihenfolge, Rollen und Verschachtelung; Zahl und Art der Materialien. **Nie:** Dateien, Lehrtexte, Trainerfragen, Abrufadressen. + +**Lücke:** Lernziele, Zeit- und Materialbedarf haben heute keine Felder (Ist-Soll-Abgleich, C-03) und sind in keinem Bibliothekspaket vorgesehen. Sie sind nach `produktkonfiguration`, §4 Lehrinhalt der Klasse B und gehören an die Kompositionsfassung. Bis sie bestehen, zeigen Programm- und Modulseite Kurzbeschreibung und Struktur; siehe Kapitel 15, Nr. 7. + +**Vorschaubilder.** Paket 6 erzeugt ein geschütztes Bild oder einen Platzhalter und schließt die öffentliche Verwendung ausdrücklich aus. Die öffentliche Freigabe ist ein eigener Schritt der Stufe W3: Sie übernimmt eine Ableitung des Bildes in den öffentlichen Medienbereich und trägt sie im Profil ein (Abnahmefall B04). Ohne Freigabe erscheint die Themen-Signatur. + +### 6.3 Datenfluss einer Programmseite + +```mermaid +sequenceDiagram + participant B as Besucher + participant R as Adressauflösung + participant C as Lesesicht Öffentlicher Katalog + participant I as Inhalte + participant K as Katalog und Veröffentlichung + participant D as Darstellung + B->>R: /programme/{slug} + R->>C: Profil zu Art und Slug + C-->>R: gelistet, Fassungsmodus + C->>K: aktueller Stand des führenden Artikels + K-->>C: fixierte Kompositionsfassung + C->>I: Anzeigefreigabe prüfen, Struktur über den Strukturleser, Inhaltsart, Klasse-A-Daten + C->>K: aktive Angebotsfassungen mit Abdeckung + C-->>D: öffentliche Sicht ohne geschützte Felder + D-->>B: HTML mit Markup und Kopfangaben +``` + +Die Lesesicht ist der einzige Weg, auf dem öffentliche Seiten Fachdaten erhalten. Sie gibt ein eigenes, schmales Datenobjekt zurück, das geschützte Felder nicht enthält. Damit ist „öffentlich zeigt nichts Geschütztes“ an einer Stelle prüfbar. Die Lesesicht nutzt den Strukturleser der Bibliothek (G1, Kapitel 14.1) und baut keinen eigenen. Das Diagramm zeigt den Modus `folgt_stand`; im Modus `fest` entfällt die Abfrage des Stands. + +### 6.4 Bezug zu den Bibliothekspaketen 0 bis 9 + +Grundlage ist `docs/analysen/umsetzungsplan-mitgliederbibliothek.md` in der Fassung nach Review. Die gemeinsamen Komponenten G1 bis G9 sind in Kapitel 14.1 beschrieben. + +| Der öffentliche Katalog braucht | Aus Paket | Gemeinsame Komponente | +|---|---|---| +| genau eine aktive Angebotsfassung je Angebot | 1 | G8 | +| Inhaltsart mit stabilen Kennungen | 2 | G3 | +| Anzeigefreigabe je Kompositionsfassung | 3 | G2 | +| Leser der freigegebenen Fassung als Baum | 3 | G1 | +| Klasse-A-Anzeigefelder mit Protokoll | 4 | G4 | +| direkte Themen an Kompositionen, Kennzeichen „abgeleitet“ | 5 | G5 | +| geschütztes Vorschaubild und Ableitungsauftrag | 6 | G6 | +| Abdeckungsbefund je Angebotsfassung | 7 | G7 | +| — | 8 | keine Abhängigkeit. Öffentliche Filmvorschauen sind eigene öffentliche Medien und nutzen die Mitgliederausgabe nicht. | +| Browser-Lauf gegen die Testinstanz | 9 | G9 | + +Die Bibliothek baut nach E-D bewusst kein Designsystem, keine CMS-Bausteine und keine öffentlichen Themenseiten. Diese Teile entstehen ausschließlich in den Stufen W1 bis W3. + +--- + +## 7. SEO-Implementierungsmechanismen + +### 7.1 Adressauflösung + +Reihenfolge je Anfrage: + +1. feste Anwendungsrouten (Anmeldung, Mitgliederbereich, Medien, Sitemap, `robots.txt`); +2. Objektrouten mit festem Präfix (`/themen`, `/programme`, `/module`, `/angebote`, `/beispiele`) über das öffentliche Profil; bei Kompositionen und Medien ergibt sich der Präfix aus der Inhaltsart (6.2), nicht aus `CompositionKind`; +3. Seiten über den vollständigen, mehrteiligen Pfad; +4. Weiterleitungstabelle; +5. 404. + +Reservierte Präfixe können nicht als Seitenpfad vergeben werden. Die heutige Auffangroute mit einem Pfadteil wird durch Schritt 3 ersetzt. + +### 7.2 Mechanismen im Vergleich + +| Aufgabe | Empfohlen | Alternative | Abwägung | +|---|---|---|---| +| Objektseiten | zur Laufzeit aus Fachdaten, zwischengespeichert | je Objekt eine CMS-Seite erzeugen | Laufzeit: immer aktuell, keine Kopie; erzeugte Seiten: frei gestaltbar, aber veralten. Der Rahmen aus 6.2 gibt die Freiheit ohne Kopie. | +| Weiterleitungen | Tabelle in der Anwendung, automatisch bei Pfadänderung in derselben Transaktion | Regeln am Reverse Proxy | Tabelle ist redaktionell pflegbar und testbar; der Proxy wird von Lars verwaltet und bleibt unberührt | +| Ketten und Schleifen | beim Speichern auflösen und ablehnen | zur Laufzeit folgen | einmal prüfen statt bei jedem Aufruf | +| Kanonische Adresse | Regel je Seitentyp, Überschreibung je Seite | nur manuell | Regel verhindert Vergessen | +| Sitemap | erzeugt, getrennt nach Seiten und Objekten, mit Änderungsdatum | Paket `spatie/laravel-sitemap` (Q20) | die eigene Ansicht besteht und ist klein; ein Paket bringt hier keinen Vorteil | +| Strukturiertes Markup | Erzeuger je Seitentyp aus Daten | Eingabefeld für Markup | Eingabefeld erzeugt Widersprüche zu sichtbaren Inhalten | +| Interne Verlinkung | Bausteine aus Fachbezügen; Vorschläge für Links im Text | automatisches Verlinken von Begriffen im Text | automatische Textlinks sind unkontrolliert und wirken künstlich | +| Titel und Beschreibung | Vorbelegung aus Klasse A, Überschreibung | Erzeugung durch KI ohne Bestätigung | Vorschlag mit Bestätigung (Zielkonzept, 12.6) | +| Indexierung | Richtlinie je Typ, Überschreibung je Seite, harte Übersteuerung je Umgebung | nur je Seite | Umgebung darf nie von Redaktionsentscheidungen abhängen | + +### 7.3 Indexierungsrichtlinie + +| Ebene | Regel | +|---|---| +| Umgebung | Jede Umgebung außer Produktion sendet für alle Antworten `X-Robots-Tag: noindex` und liefert eine sperrende `robots.txt`. Das ersetzt nicht den Zugangsschutz (`seo-prinzipien`, §10). | +| Seitentyp | Vorgabe laut Zielkonzept, 8.2 | +| Seite oder Profil | Überschreibung „indexieren“ oder „nicht indexieren“ | +| Mindestinhalt | Objektseiten ohne Kurzbeschreibung und Struktur werden nicht indexiert, auch wenn sie gelistet sind. Lernziele kommen als Bedingung hinzu, sobald das Feld besteht (Kapitel 15, Nr. 7). | +| Ansichten | Adressen mit Filter- oder Sortierparametern nennen die Übersicht als kanonisch und stehen nicht in der Sitemap | + +`robots.txt` wird von der Anwendung erzeugt; die statische Datei entfällt. Inhalt in Produktion: Sperre der Anwendungspfade, Verweis auf die Sitemap, je nach Entscheidung E-M2 Regeln für einzelne Crawler. + +### 7.4 Strukturiertes Markup und Kopfangaben + +| Seitentyp | Erzeugt aus | Typ | +|---|---|---| +| alle | Seitenbaum, Profil | BreadcrumbList | +| Start | Einstellungen | Organization, WebSite | +| Beitrag | Revision: Autor, Stand, Titel, Bild | Article | +| Angebot | aktive Angebotsfassung | Product mit Offer, nur bei sichtbarem Preis | +| Seiten mit öffentlicher Filmvorschau | öffentliches Medium | VideoObject | +| Programm, Modul | Profil und Fassung | optional LearningResource; kein Ergebnis in der Suche zu erwarten (Zielkonzept, 11.7) | + +Social-Angaben: Titel, Beschreibung, Bild in 1200 × 630 px als eigene Ableitung, mit Markenbild als Rückfall. + +**Prüfung:** Tests vergleichen das erzeugte Markup je Seitentyp mit erwarteten Strukturen und stellen sicher, dass jeder Wert auch sichtbar auf der Seite steht. Vor einem Start zusätzlich einmalige Sichtprüfung mit dem Prüfwerkzeug des Suchdienstes. + +### 7.5 Prüfungen vor Veröffentlichung + +| Prüfung | Wirkung | +|---|---| +| defekter interner Link, Verweis auf nicht öffentliches Objekt | blockiert | +| Bild ohne Alternativtext und ohne Kennzeichen „dekorativ“ | blockiert | +| keine oder mehrere H1; Sprung in der Überschriftenfolge | blockiert | +| Pfad kollidiert mit reserviertem Präfix oder bestehender Weiterleitung | blockiert | +| Beitrag ohne Autor, Stand, Cluster oder verlinktes Modul | blockiert | +| KI-Entwurf mit offener Markierung „Quelle nötig“ | blockiert | +| Titel oder Beschreibung fehlt oder ist doppelt vergeben | Warnung | +| Titel oder Beschreibung außerhalb sinnvoller Länge | Warnung | +| Seite ohne eingehende interne Links | Warnung | +| Social-Bild fehlt | Warnung | +| Preis oder Rechte als Text im Baustein erkannt | Warnung | + +Dieselben Prüfungen laufen regelmäßig über den Bestand und speisen die Maßnahmenliste (Kapitel 8). + +### 7.6 Zuordnung der Anforderungen + +| Anforderung (Zielkonzept, 11.8) | CMS | Frontend | Deployment und Betrieb | +|---|---|---|---| +| Servergerendert | Bausteine als Blade | kein Nachladen von Inhalt per Skript | — | +| Statuscodes | Seitenstatus, Weiterleitungstabelle | Fehlerseiten | — | +| Kanonisch, Indexierung | Regeln und Felder | Kopfangaben | Umgebungsvariable steuert Übersteuerung | +| Sitemap, `robots.txt` | Erzeugung | — | Zugangsschutz der Testinstanz am Proxy (durch Lars) | +| Leistung | Bildableitungen, Obergrenzen je Seite | Budget je Seitentyp, Schriften, kein blockierendes Skript | Kompression und Zwischenspeicherkopf; Messung in der Suite auf der Testinstanz | +| Barrierefreiheit | Pflichtfelder, Prüfungen | geprüfte Komponenten | automatische Prüfung in der Suite auf der Testinstanz | +| PWA | — | Service Worker ohne Zugriff auf angemeldete Seiten | — | + +**Messung und Tests:** Leistungs-, Barrierefreiheits- und Sichtprüfungen laufen als Browser-Tests gegen die Testinstanz über HTTP, nie gegen Produktion und nie mit `php artisan test` im Test-Container (Projektregel). Feldwerte der Web Vitals liefert die Search Console, sobald genügend Besuche vorliegen. + +--- + +## 8. Marketing-Intelligence-Architektur + +### 8.1 Variantenvergleich + +| Kriterium | Gewicht | A im Kern | B n8n steuert | C eigenes System | D KI-Agenten | **E Hybrid** | +|---|---|---|---|---|---|---| +| Fachlicher Nutzen | 15 | 4 | 3 | 4 | 3 | **5** | +| Konfigurierbarkeit | 15 | 3 | 4 | 3 | 4 | **4** | +| UX-Qualität | 10 | 4 | 2 | 3 | 3 | **4** | +| Entwicklungsaufwand | 10 | 3 | 4 | 1 | 3 | **3** | +| Betriebskosten | 5 | 5 | 4 | 3 | 3 | **4** | +| Wartbarkeit | 15 | 5 | 2 | 2 | 2 | **4** | +| Integrationsfähigkeit | 15 | 5 | 2 | 3 | 3 | **5** | +| Sicherheit | 5 | 5 | 2 | 3 | 2 | **4** | +| Erweiterbarkeit | 5 | 3 | 4 | 4 | 4 | **5** | +| Migrationsrisiko | 5 | 5 | 4 | 4 | 4 | **5** | +| **Gewichtet (von 5)** | | 4,15 | 2,95 | 2,90 | 3,05 | **4,30** | + +| Ansatz | Stärken | Schwächen | +|---|---|---| +| **A – im Kern** | Zeitsteuerung, Warteschlange, Rollen, Audit, Tests und Sicherung sind vorhanden; Maßnahmen liegen neben den Seiten | ohne KI bleiben Sprachaufgaben liegen; Fremdkanäle sind Eigenbau | +| **B – n8n als Steuerung** | viele fertige Verbindungen; schnelle Änderung; menschliche Prüfung von Werkzeugaufrufen über Chat, E-Mail und Messenger (Q19); Nutzung für eigene Geschäftszwecke ist erlaubt (Q18) | Logik liegt außerhalb von Versionsverwaltung, Tests und Deploymentweg; weiteres System mit Zugangsdaten; Freigaben außerhalb der Verwaltung; Fehlerbehandlung je Ablauf von Hand | +| **C – eigenes System** | saubere Trennung, eigene Skalierung | weiterer Dienst, eigene Datenbank, eigene Anmeldung; für diese Größe ohne Gegenwert | +| **D – KI-Agenten** | flexibel bei offenen Aufgaben | nicht vorhersagbar, schwer testbar, höheres Risiko bei Schreibrechten; deterministische Abläufe lösen die meisten Aufgaben zuverlässiger | +| **E – Hybrid** | Daten, Regeln, Maßnahmen und Freigaben im Kern; KI als austauschbare Einzelschritte; Fremdkanäle über ein Werkzeug mit engem Zugang | zwei Mechanismen (Kern, optional n8n), die sauber getrennt bleiben müssen | + +**[EMPF] E**, in dieser Aufteilung: Der Kern ist führend für alles, was Zahlen, Entscheidungen und Veröffentlichung betrifft. KI liefert Text. n8n verbindet, falls nötig, nach außen. + +### 8.2 Modul „Marketing“ + +Neues Modul des Kerns (Ergänzung zu `03`, Abschnitt 3): + +| | | +|---|---| +| **Verantwortung** | Abruf und Verdichtung von Such- und Zählwerten; Themencluster; Regeln; Befunde; Maßnahmen mit Entscheidung; Wirkungsmessung; Protokoll der KI-Läufe; Berichte | +| **Besitzt** | Datenquelle, Tageswert Suche, Tageswert Seite, Zuordnung Anfrage → Cluster, Befund, Maßnahme, Wirkungsnotiz, KI-Lauf, Schwellenwert | +| **Darf aufrufen** | Web und CMS (lesend; schreibend nur „Entwurfsrevision anlegen“), Katalog und Veröffentlichung (lesend), Bestellung und Lizenzen (**nur verdichtete Zählungen** über eine eigene Lesesicht) | +| **Wird aufgerufen von** | Administration; Ereignisse „Seite veröffentlicht“, „Stand veröffentlicht“, „Angebotsfassung aktiviert“ | +| **Kennt nicht** | Konten, E-Mail-Adressen, Bestellungen, Berechtigungen im Einzelnen | + +### 8.3 Datenmodell + +```mermaid +erDiagram + DATA_SOURCE ||--o{ IMPORT_RUN : "wird abgerufen" + SEARCH_DAILY }o--|| DATA_SOURCE : "aus" + SEARCH_DAILY }o--o| TOPIC_CLUSTER : "Anfrage zugeordnet" + PAGE_DAILY }o--o| TOPIC_CLUSTER : "Seite zugeordnet" + FINDING }o--|| RULE : "ausgelöst durch" + ACTION ||--o{ FINDING : "fasst zusammen" + ACTION ||--o| EFFECT_NOTE : "Wirkung" + ACTION }o--o| AI_RUN : "Entwurf aus" + AI_RUN }o--o| PAGE_REVISION : "ergab Revision" + + SEARCH_DAILY { + date day + string source "google, bing" + string url + string query + int impressions + int clicks + float position + } + PAGE_DAILY { + date day + string url + string channel "suche, direkt, verweis, kampagne, antwortdienst" + int views + int cta_clicks + int registrations + int free_claims + int purchases + } + RULE { + string key + int version + string needs "bestand, verkehr" + json thresholds + } + FINDING { + string subject "Seite oder Profil" + json evidence "Zahlen und Zeitraum" + string status "offen, erledigt, entfallen" + } + ACTION { + string kind + string impact "gemessene Größe" + string certainty "eindeutig, vermutung" + string effort "klein, mittel, gross" + string status "vorgeschlagen, geplant, in_arbeit, erledigt, verworfen" + string decision_note + date done_on + } + EFFECT_NOTE { + date before_from + date after_to + json metrics + string verdict "besser, gleich, schlechter, nicht_beurteilbar" + } + AI_RUN { + string task + string model + string prompt_version + string input_ref + int tokens_in + int tokens_out + string status "ok, abgelehnt, fehler" + } +``` + +Alle Tabellen tragen ein gemeinsames Präfix und liegen in der Kerndatenbank. Es gibt keinen Fremdschlüssel auf Konten. + +### 8.4 Abruf der Daten + +| Quelle | Adapter | Rhythmus | Besonderheit | +|---|---|---|---| +| Google Search Console | Suchanalyse je Tag, Seite, Anfrage | täglich; die letzten Tage werden jeweils neu geholt und überschrieben, weil die Werte nachlaufen **[ANNAHME]** | Zugang über ein Dienstkonto mit Leserecht; Grenzen laut Q06 sind für diese Größe unkritisch | +| Bing Webmaster | Suchwerte je Tag | täglich | Schnittstelle nicht in dieser Sitzung geprüft **[ANNAHME]** | +| KI-Berichte beider Dienste | kein Adapter; Einlesen einer exportierten Datei | monatlich, von Hand | keine belegte Schnittstelle (Q04, Q07) | +| Reichweite | Eigenzählung (Kapitel 10) oder Adapter des Werkzeugs | laufend | — | +| Kern | Lesesicht mit Zählungen je Tag und Quelle | täglich | keine Einzeldatensätze | +| Keyword-Daten | optionaler Adapter | bei Bedarf | Werte als Schätzung gekennzeichnet | + +**Regeln für alle Adapter:** hinter einer gemeinsamen Schnittstelle; laufen ausschließlich in der Hintergrundverarbeitung; schreiben idempotent je Tag; protokollieren jeden Lauf; ein Fehler erzeugt eine sichtbare Lücke, keinen geschätzten Wert. Abrufe laufen nur in Produktion. Tests verwenden nachgebildete Antworten (`Http::fake()`). + +**Herkunft von Registrierungen ohne Cookie:** Handlungsaufrufe tragen die Kennung der auslösenden Seite und des Bausteins als Parameter; die Registrierung speichert diese Angabe und einen vorhandenen Kampagnenparameter am Konto. Das Marketingmodul liest davon nur Zählungen. Damit entsteht eine Zuordnung „von welcher Seite kam die Registrierung“, ohne Speicherung im Browser. + +### 8.5 Regeln + +Jede Regel ist eine Klasse mit Schlüssel, Version, Datenbedarf und Schwellen aus einer pflegbaren Tabelle. Sie ist mit festen Testdaten prüfbar und liefert Befunde mit den Zahlen, auf denen sie beruht. + +| Regel | Bedarf | Befund | +|---|---|---| +| R01 Titel oder Beschreibung fehlt oder doppelt | Bestand | Metaangaben ergänzen | +| R02 Bild ohne Alternativtext | Bestand | Text ergänzen | +| R03 defekter interner Link | Bestand | Link berichtigen | +| R04 verwaiste Seite | Bestand | verlinken | +| R05 Objekt gelistet, aber ohne Mindestinhalt | Bestand | Stammdaten ergänzen | +| R06 Thema ohne gelistetes Modul oder Programm | Bestand | Katalog prüfen | +| R07 Programm oder Modul ohne passendes aktives Angebot | Bestand | Angebot prüfen | +| R08 gezeigte Fassung weicht ab: neuer Stand ohne Anzeigefreigabe, höhere freigegebene Fassung vorhanden, Abdeckung gesunken, Modulseite zeigt andere Fassung als das Programm | Bestand | Profil oder Freigabe prüfen | +| R09 neuer Artikel-Stand oder neues gelistetes Objekt ohne Ankündigung | Ereignis | Vermarktungsliste abarbeiten | +| R10 Beitrag älter als Prüfdatum | Bestand | Wiedervorlage | +| R11 Cluster mit weniger als zwei Beiträgen | Bestand | Themenlücke | +| R12 Position 8 bis 20 bei nennenswerten Impressionen | Verkehr | Inhalt ausbauen, verlinken | +| R13 Klickrate deutlich unter dem Vergleichswert gleicher Position | Verkehr | Titel und Beschreibung prüfen | +| R14 Anfragen mit Impressionen ohne passende Seite im Cluster | Verkehr und Zuordnung | Thema vorschlagen | +| R15 Rückgang gegenüber der Vorperiode über Schwelle | Verkehr | Ursache prüfen | +| R16 Seite mit Besuchen, aber ohne Klick auf den Handlungsaufruf | Verkehr | Aufruf oder Angebot prüfen | + +Regeln mit Bedarf „Verkehr“ ruhen sichtbar, bis die Mindestmenge erreicht ist. + +### 8.6 Wirkungsmessung + +Beim Erledigen einer Maßnahme wird das Datum festgehalten. Nach Ablauf des Vergleichszeitraums stellt ein Auftrag gleich lange Zeiträume davor und danach gegenüber und schreibt eine Wirkungsnotiz. Liegen zu wenige Daten vor oder fallen mehrere Änderungen an derselben Seite in den Zeitraum, lautet das Urteil „nicht beurteilbar“. Ein Ursachennachweis wird nicht behauptet. + +### 8.7 Oberfläche + +Ein Bereich „Marketing“ in der Verwaltung mit vier Ansichten: Übersicht (Kennzahlen mit Quelle, Zeitraum, Abrufzeit), Maßnahmen (Liste mit Herleitung und Entscheidung), Themen (Cluster mit Seiten und Anfragen), Protokoll (Abrufe, KI-Läufe). Eine Maßnahme führt mit einem Klick zur betroffenen Seite; ein Entwurf ist eine Revision dieser Seite. + +--- + +## 9. KI- und Workflow-Orchestrierung + +### 9.1 Grundsätze + +1. **Ein KI-Schritt ist ein Auftrag mit festem Zweck**, festen Eingaben, festem Ausgabeschema und festem Freigabegrad. Er ist kein Gespräch und hat keine Werkzeuge außer denen, die sein Zweck verlangt. +2. **Zahlen kommen nie aus dem Modell.** Berichte erhalten die Zahlen vom System und formulieren nur. +3. **Ergebnis ist ein Vorschlag oder eine Entwurfsrevision.** Kein Schritt kann veröffentlichen, versenden oder Fachdaten ändern. +4. **Eingaben sind eine Positivliste:** öffentliche Seiteninhalte, öffentlich gelistete Fachdaten, verdichtete Zahlen, bereinigte Suchanfragen, die Liste zulässiger Aussagen. Keine Kontodaten. +5. **Alles ist protokolliert:** Aufgabe, Modell, Fassung der Anweisung, Verweis auf die Eingabe, Mengen, Ergebniszustand. + +### 9.2 Aufbau + +```mermaid +flowchart LR + M["Maßnahme oder Zeitplan"] --> A["KI-Auftrag in der Warteschlange"] + A --> E["Eingaben nach Positivliste"] + E --> AD["Modelladapter"] + AD --> X["KI-Dienst"] + X --> AD + AD --> P["Prüfung des Ausgabeschemas"] + P --> L["KI-Lauf protokolliert"] + L --> V["Vorschlag Stufe 1"] + L --> R["Entwurfsrevision Stufe 2, markiert"] + V --> H["Redakteur übernimmt oder verwirft"] + R --> H2["Redaktionelle und fachliche Prüfung"] + H2 --> PUB["Veröffentlichung über das Seitensystem"] +``` + +| Teil | Festlegung | +|---|---| +| Auftragsdefinition | im Repository: Schlüssel, Zweck, Eingabebauer, Anweisung mit Versionsnummer, Ausgabeschema, Modellstufe, Freigabegrad | +| Modelladapter | eine Schnittstelle „Text nach Schema erzeugen“; eine Umsetzung für den gewählten Dienst, eine Nachbildung für Tests | +| Modellstufen | drei benannte Stufen (klein, mittel, groß); die Zuordnung zu konkreten Modellen ist Konfiguration | +| Ausführung | nur in der Hintergrundverarbeitung; Zeitlimit; ein Wiederholungsversuch bei technischem Fehler | +| Ablehnung durch den Dienst | eigener Ergebniszustand ohne Wiederholung. Bei Themen wie sexualisierter Gewalt ist mit Ablehnungen durch Schutzfilter zu rechnen **[ANNAHME]**; solche Texte schreibt ein Mensch. | +| Ausfall des Dienstes | Maßnahmenliste, Regeln und Website sind nicht betroffen | +| Fremdinhalte | Suchanfragen und abgerufene Webseiten sind nicht vertrauenswürdige Eingaben; Ausgaben werden nur gespeichert, nie ausgeführt; HTML wird bereinigt; Links werden geprüft | + +### 9.3 Modellstufen und Kosten + +Preise laut Q25 (Stand 03.11.2026, je Million Token Eingabe und Ausgabe): kleines Modell 0,10 und 0,50 USD; mittleres 2 und 10 USD; großes 4 und 20 USD. Stapelverarbeitung kostet nach derselben Quelle die Hälfte; wiederverwendete Eingaben aus dem Zwischenspeicher etwa ein Zehntel. + +| Aufgabe | Menge je Monat **[ANNAHME]** | Stufe | Eingabe und Ausgabe | Kosten | +|---|---|---|---|---| +| Anfragen einem Cluster zuordnen | 2.000 Anfragen | klein | 1,0 Mio. und 0,2 Mio. | etwa 0,20 USD | +| Titel, Beschreibung, Alternativtext | 40 Seiten | klein | 0,12 Mio. und 0,012 Mio. | etwa 0,02 USD | +| Briefings | 20 | mittel | 0,2 Mio. und 0,04 Mio. | etwa 0,80 USD | +| Beitragsentwürfe | 8 | groß | 0,24 Mio. und 0,048 Mio. | etwa 1,90 USD | +| Berichte | 4 | mittel | 0,2 Mio. und 0,012 Mio. | etwa 0,50 USD | +| **Summe** | | | | **etwa 3,50 USD** | + +Zum Vergleich: alle Aufgaben mit dem großen Modell etwa 13 USD; mit dreifacher Ausgabemenge durch Denkanteile unter 30 USD. **Folgerung:** Die Stufung ist eine Frage von Geschwindigkeit und Angemessenheit, nicht des Budgets. Für Entwürfe und fachlich heikle Zusammenfassungen ist die höchste verfügbare Qualität zu wählen. Die tatsächlichen Mengen sind nach den ersten Wochen aus dem Protokoll abzulesen. + +**Modellunabhängigkeit:** Anweisungen und Schemata sind dienstneutral formuliert; der Adapter kapselt den Aufruf. Ein Wechsel des Anbieters ist eine neue Adapterumsetzung plus Neubewertung der Anweisungen an einer festen Beispielsammlung. + +### 9.4 Rolle von n8n + +| Einsatz | Urteil | +|---|---| +| Träger der Marketinglogik (Abruf, Regeln, Freigaben) | **nein** | +| Verbindung zu fremden Kanälen (soziale Netze, Newsletter-Dienst, Kalender) | **optional ab M3** | +| Prototyp eines neuen Ablaufs vor der Übernahme in den Kern | sinnvoll | + +Bedingungen für den Einsatz: eigener Zugang zum Kern über eine schmale Schnittstelle mit drei Rechten (verdichtete Kennzahlen lesen, veröffentlichte Neuigkeiten lesen, Maßnahme als Vorschlag anlegen); kein Datenbankzugang; keine Veröffentlichung; Abläufe als Dateien im Repository gesichert; eigene Zugangsdaten je Kanal. Ob auf dem Server bereits eine n8n-Instanz läuft, wurde nicht geprüft; andere Anwendungen dort dürfen nicht verändert werden (Projektregel). + +**Vor dem Einsatz zu prüfen:** ob der Freigabeschritt in der Community-Ausgabe verfügbar ist (Q19 sagt dazu nichts). + +### 9.5 Agenten + +Ein einzelner Auftrag mit Websuche („Rechercheauftrag zu einem Thema mit Quellenliste“) ist ab M3 denkbar: nur lesend, Ergebnis ist ein Briefing mit Quellen. Ein Verbund mehrerer Agenten mit Schreibrechten im CMS wird nicht empfohlen; kein beschriebener Ablauf braucht ihn. + +--- + +## 10. Reichweitenmessung + +| Variante | Betrieb | Aussagekraft | Datenschutz | Urteil | +|---|---|---|---|---| +| **Eigenzählung im Kern** | kein weiterer Dienst | Aufrufe je Seite, Herkunftsklasse, Kampagne, Klick auf Handlungsaufruf; keine Sitzungen, keine Wiederkehrer | keine Speicherung im Browser, keine IP, nur Tageszähler | **Empfehlung für den Start** | +| Umami, selbst betrieben | weiterer Container mit PostgreSQL **[ANNAHME]** | zusätzlich Sitzungen, Geräte, Verläufe | ohne Cookies; Konfiguration zu prüfen | Ausbauweg | +| Matomo, selbst betrieben | weiterer Container, eigene MySQL-Datenbank **[ANNAHME]** | umfangreich | ohne Cookies einstellbar; Standard protokolliert mehr | nur bei deutlich höherem Bedarf | +| Plausible, selbst betrieben | zwei weitere Dienste **[ANNAHME]** | wie Umami | ohne Cookies | für einen Betreiber zu viel Betrieb | +| Analysedienst eines Drittanbieters | keiner | hoch | Einwilligung nötig, Drittlandfragen | nicht empfohlen | + +**Eigenzählung im Einzelnen [EMPF]:** Ein Zählaufruf aus dem Browser an die eigene Adresse übermittelt Pfad und Herkunftsklasse; der Server erhöht Tageszähler. Dadurch zählen nur Browser, die Skripte ausführen, was automatische Abrufe weitgehend ausschließt. Es wird nichts im Browser gespeichert und keine Kennung gebildet. Ob das Auslesen der Herkunft als Zugriff auf das Endgerät zu werten ist, gehört zur rechtlichen Prüfung (Zielkonzept, Kapitel 13). + +**Grenze:** keine Besucherzahlen, keine Verweildauer, keine Pfade. Für die Leitkennzahl und den Trichter genügen Aufrufe und die Ereignisse des Kerns. Ein Werkzeug wird erst eingeführt, wenn eine konkrete Frage damit nicht zu beantworten ist; das wäre eine Änderung an `docker-compose.yml` und am Server. + +--- + +## 11. Sicherheit, Rollen und Datenschutz (technisch) + +| Thema | Regel | +|---|---| +| Ausgehende Verbindungen | Suchdienste, KI-Dienst und optional Keyword-Dienst werden nur von der Hintergrundverarbeitung angesprochen. Der Web-Prozess kennt diese Zugangsdaten nicht (`03`, Abschnitt 6, Geheimnisse je Prozess). | +| Zugangsdaten | nur in der Umgebungsdatei der Produktion auf dem Server; in Test keine echten Zugänge | +| Datenbankrechte | Marketingtabellen: Hintergrundverarbeitung schreibt, Verwaltung liest und schreibt Entscheidungen, Web-Betriebsart nur die Tageszähler | +| Personendaten | keine im Marketingmodul; Zählungen aus dem Kern über eine eigene Lesesicht ohne Kennungen | +| Rollen | keine neue Sammelrolle. Redakteur: Übersicht, Maßnahmen, KI-Aufträge anfordern, Entwürfe prüfen. Fachprüfer: Freigabe von Fachaussagen. Systemverwalter: Datenquellen, Schwellen, Modellzuordnung. | +| Audit | Listen und Entlisten öffentlicher Profile, Änderungen an Schwellen und Modellzuordnung, Veröffentlichungen. KI-Läufe stehen im eigenen Protokoll. | +| Öffentliche Lesesicht | einziger Weg von Fachdaten auf öffentliche Seiten; gibt ein Datenobjekt ohne geschützte Felder zurück | +| Formulare | Mengenbegrenzung, Schutzfeld, minimale Pflichtangaben, Löschfrist | +| Schnittstelle für n8n | eigener Schlüssel mit drei Rechten; widerrufbar; Zugriffe protokolliert | +| Herkunftsadressen | Marketing liegt in der Verwaltung und damit auf deren Adresse | +| Test und Produktion | Abrufe und KI-Aufrufe nur in Produktion; Tests mit Nachbildungen; die Suite auf der Testinstanz ruft keine Fremddienste | + +**Negativtests für die Umsetzung** (in der Art von `11`, Abschnitt 7.6): + +| Nr. | Test | +|---|---| +| NT-W1 | Eine öffentliche Objektseite enthält keine Abrufadresse und keinen Lehrtext einer geschützten Fassung. | +| NT-W2 | Ein nicht gelistetes Objekt ist weder über seine Adresse noch über einen Katalogbaustein noch über die Sitemap erreichbar. | +| NT-W3 | Ein Vorschaubild ohne öffentliche Freigabe ist über keine öffentliche Route abrufbar. | +| NT-W4 | Angebotsseite, Programmseite und Landingpage zeigen nach Aktivierung einer neuen Angebotsfassung denselben Preis. | +| NT-W5 | In einer Umgebung außer Produktion trägt jede Antwort die Sperrkennzeichnung. | +| NT-W6 | Ein Baustein mit Skript oder fremdem HTML wird beim Speichern abgewiesen. | +| NT-W7 | Eine nur bereite, nicht zur Anzeige freigegebene Fassung erscheint auf keiner öffentlichen Seite, auch nicht als Bestandteil, Pfad oder Verwendungshinweis. | +| NT-W8 | Eine Identität ohne gesetzte Inhaltsart lässt sich nicht listen; die technische Bezeichnung des Strukturtyps erscheint auf keiner öffentlichen Seite. | +| NT-M1 | Kein Datensatz des Marketingmoduls enthält eine Kontokennung oder E-Mail-Adresse. | +| NT-M2 | Ein KI-Auftrag kann den Veröffentlichungszeiger einer Seite nicht setzen. | +| NT-M3 | Die an den KI-Dienst übergebene Eingabe enthält nur Felder der Positivliste. | +| NT-M4 | Der Schlüssel der n8n-Schnittstelle kann keine Seite veröffentlichen und keine Fachdaten lesen. | + +--- + +## 12. Architekturentscheidungen (Entwürfe) + +Zur Übernahme in `12_Entscheidungsprotokoll_ADR.md` nach Annahme. Nummern sind Vorschläge. + +| Nr. | Entscheidung | Alternativen | Vorteile | Nachteile und Risiken | Voraussetzung | Alternative vorziehen, wenn | +|---|---|---|---|---|---|---| +| **ADR-28** (bevorzugt, unter Vorbehalt) | Seitensystem bleibt Eigenkern und erhält Seitentypen, Vorlagen, Abschnittsvarianten und globale Abschnitte (ergänzt ADR-22) | Statamic, Twill, freier Builder, Headless-Dienst, Payload | eine Verwaltung; Katalogbezug ohne Kopie; Bestand genutzt | Pflegeaufwand; Komfortgrenze | bestandener Editor-Prototyp (4.5); vorher keine Entscheidung | der Prototyp scheitert auch in der zweiten Runde; mehrere tägliche Redakteure ohne Katalogbezug | +| **ADR-29** | Öffentliches Profil je Fachobjekt mit Fassungsmodus „folgt Stand“ oder „fest“. Gezeigt wird nur eine zur Anzeige freigegebene Fassung. Seitentyp und Adresse folgen der Inhaltsart. Enthaltene Module erscheinen als Struktur; eine eigene Seite braucht eine eigene Freigabe. | je Objekt eine CMS-Seite; öffentliche Felder an der Identität; Seitentyp aus `CompositionKind` | keine Kopie; öffentlich kann weder dem verkauften noch dem freigegebenen Stand vorauseilen | weiteres Objekt; bei Programmen über mehrere Artikel bestätigt die Redaktion die Fassung | Bibliothek Pakete 2, 3, 4; für Angebote 1 und 7 | — | +| **ADR-30** | Bausteinvertrag mit Hülle, Varianten, Verweisen und Schemaversion | freie Felder je Baustein; Format eines Fremdeditors | Editorfläche austauschbar; keine Migration alter Revisionen | Aufwärtsfunktionen sind zu pflegen | — | ein Fremdeditor wird führend | +| **ADR-31** | Adressauflösung in der Anwendung mit Weiterleitungstabelle und Indexierungsrichtlinie je Typ und Umgebung | Regeln am Proxy; nur manuelle Einstellungen | redaktionell pflegbar, testbar; Umgebung nicht übersteuerbar | zusätzliche Abfrage bei unbekannter Adresse | Entscheidung zur kanonischen Hauptadresse | — | +| **ADR-32** | Öffentliche Seiten ohne Sitzung, identisch für alle, in der Anwendung zwischengespeichert | Sitzung überall; Zwischenspeicher am Proxy | schnell; einfacher Schutz; Proxy bleibt unberührt | Entwertung muss stimmen; Formulare getrennt | — | Personalisierung öffentlicher Seiten gewünscht | +| **ADR-33** | Marketing als Modul des Kerns mit personenfreier Datenhaltung | n8n als Steuerung; eigenes System | Tests, Rollen, Audit, Sicherung vorhanden | Kern wächst | — | Marketing wird von einem eigenen Team mit eigenen Werkzeugen betrieben | +| **ADR-34** | KI als einzelne protokollierte Aufträge hinter einem Modelladapter, Ergebnis nie öffentlich ohne Mensch | Agentenverbund; KI-Funktionen eines Fremd-CMS | vorhersagbar, prüfbar, anbieterunabhängig | weniger „selbstständig“ | Entscheidung KI-Dienst; Liste zulässiger Aussagen | — | +| **ADR-35** | Reichweitenmessung als Eigenzählung ohne Cookies | selbst betriebenes Werkzeug; Drittanbieter | kein Betriebsteil, keine Einwilligung nach heutiger Einschätzung | geringe Aussagetiefe | rechtliche Prüfung | Fragen zu Sitzungen und Pfaden werden geschäftsrelevant | +| **ADR-36** | Design-Tokens zweistufig im Repository; Website und Mitgliederbereich teilen Komponenten | Markenwerte in der Datenbank; getrennte Stile | eine Quelle; Änderungen nachvollziehbar | Markenänderung braucht Deployment | Markenfreigabe | häufige Markenänderungen | +| **ADR-37** | n8n nur für fremde Kanäle über eine schmale Schnittstelle | n8n mit Datenbankzugang; ganz ohne n8n | Schaden begrenzt; Logik bleibt testbar | zweiter Mechanismus | Bedarf an einem konkreten Kanal | kein Fremdkanal nötig: dann ganz ohne | + +--- + +## 13. Änderungen an bestehenden Architekturkomponenten und Dokumenten + +### 13.1 Komponenten + +| Komponente | Änderung | Art | +|---|---|---| +| Modul Web und CMS | Seitentypen, Vorlagen, globale Abschnitte, Weiterleitungen, Medienbibliothek, öffentliche Profile, Lesesicht, SEO-Dienste, Prüfungen | Erweiterung | +| Bausteinregister | von einer Klasse mit Fallunterscheidung zu einer Klasse je Art mit gemeinsamem Vertrag | Umbau ohne Datenänderung | +| Routen | mehrteilige Pfade, Objektrouten, erzeugte `robots.txt` | Erweiterung; statische Datei entfällt | +| Layout | neutrale Kopfzeile, Kopfangaben, Markup, Tokens | Umbau | +| Säulen als Themen | werden erster Fall des öffentlichen Profils, nachdem Bibliothekspaket 5 die Säulen als Dimension übernommen hat | Einordnung, abwärtskompatibel | +| Mitgliederbereich | fachlicher Neuaufbau durch die Bibliothekspakete 3 bis 7 auf dem vorhandenen Layout; erst danach Umstellung auf Tokens und Grundkomponenten (W1b) | getrennte Schritte, siehe 14.3 | +| Strukturleser, Anzeigefreigabe, Abdeckungsbefund | entstehen in den Bibliothekspaketen 3 und 7 nach den Verträgen G1, G2, G7 und werden vom öffentlichen Katalog mitgenutzt | gemeinsame Komponenten, einmal gebaut | +| Modul Marketing | neu | neu | +| Ereignisverarbeitung | drei bestehende Ereignisarten erhalten einen weiteren Abnehmer | Erweiterung | +| Hintergrundverarbeitung | Abrufe, KI-Aufträge, Bildableitungen für die Website | Erweiterung | +| Fachmodule (Inhalte, Katalog, Veröffentlichung, Lizenzen, Bestellung) | **keine Änderung** an Tabellen, Invarianten oder Schnittstellen | — | +| Deployment-Dateien | keine für W1 bis M2; nur bei Einführung eines Messwerkzeugs oder von n8n | — | + +### 13.2 Dokumente + +| Dokument | Abschnitt | Änderung | +|---|---|---| +| `03_Zielarchitektur.md` | 2, 3 | Modul Marketing; Erweiterung von Web und CMS; Lesesicht | +| | 4 | Datenhoheit: öffentliches Profil, Marketingdaten | +| | 5.1 | externe Schnittstellen: Suchdienste, KI-Dienst, optional Keyword-Dienst | +| | 6 | öffentliche Seiten ohne Sitzung; Zugangsdaten nur in der Hintergrundverarbeitung | +| `04_Domaenenmodell.md` | neu | Seitensystem und öffentliches Profil als fünftes Diagramm; Abgrenzung zu Klasse A | +| `09_CMS_Administration_Community.md` | A.2 | Seitentypen nach Zielkonzept, Kapitel 9; „Episode“ durch Programm und Modul ersetzen | +| | A.3 | Bausteinbibliothek, Varianten, globale Abschnitte | +| | A.4 | Verweis auf Klasse A, B, C und öffentliches Profil (deckt Abgleich A01 und A09) | +| | A.5 | Vorlagen, Zeitsteuerung, Prüfungen | +| | A.6 | Zuordnung nach Kapitel 7.6 | +| | B.1, B.2 | Bereich Marketing; Rollen | +| `10_Technologiebewertung.md` | 2 | Ergebnis des CMS-Vergleichs; Editorbausteine von Filament | +| | neu | Reichweitenmessung, KI-Dienst, n8n | +| `11_Betrieb_Sicherheit_Datenschutz.md` | 7.6 | Negativtests NT-W und NT-M | +| | 8.1, 8.3 | Verarbeitungen und Empfänger: Suchdienste, KI-Dienst, Messung, Newsletter; Fristen | +| | 9 | Betriebskosten | +| `12_Entscheidungsprotokoll_ADR.md` | — | ADR-28 bis ADR-37; Vermerk an ADR-22 | +| `13_Risiken_Annahmen_offene_Entscheidungen.md` | 3, 4 | Risiken und Entscheidungen aus dem Zielkonzept, Kapitel 16 und 17 | +| `15_Roadmap.md` | 1, 2 | Spuren W und M; Einordnung in A1 | +| `16_MVP_Slice.md` | 3.1 | Website und CMS: Umfang nach W0 bis W3; Player nach Abgleich A06 | +| `design-prinzipien.md` | 5, 3, 8 | Verweis auf freigegebene Tokens und Signaturen; Kursplayer als Add-on | +| `seo-und-content-prinzipien.md` | 8, 9, 13 | Stand der Ergebnisarten; Aussagen von Google zu KI-Funktionen; Berichte | +| `produktkonfiguration-und-mitgliederbereich.md` | 5, 8 | öffentliche Sichtbarkeit über das Profil | +| `analysen/umsetzungsplan-mitgliederbibliothek.md` | Pakete 3, 5, 7, 9 | Vertragsvermerke zu G1, G2, G5, G7, G9; Verweis auf die gemeinsame Reihenfolge. Inhalt und Folge der Pakete bleiben. | +| `analysen/ist-soll-abgleich-mitgliederbibliothek.md` | E-A, E-D | Verweis: Die öffentliche Vorstellung von Programmen ist in Kapitel 6.2 dieses Dokuments geregelt. | +| `betrieb/DEPLOYMENT.md` | — | Umgebungssteuerung der Indexierung; neue Umgebungswerte für Datenquellen und KI-Dienst | +| `tasks/SEO-Marketing.md` | — | Vermerk „durch Zielkonzept abgelöst“ | +| `Brand-UI-Kit/README.md` | — | Status nach W0 | + +Es entsteht kein weiteres Spezifikationsdokument. Nach der Übernahme der angenommenen Teile können beide neuen Dokumente als Entscheidungsgrundlage archiviert werden. + +--- + +## 14. Gemeinsame Implementierungsreihenfolge für Bibliothek, Website und CMS + +Dieses Kapitel führt die Bibliothekspakete 0 bis 9 (`docs/analysen/umsetzungsplan-mitgliederbibliothek.md`, Fassung nach Review) und die Stufen W und M dieses Konzepts in eine Reihenfolge. Die Paketinhalte der Bibliothek werden nicht geändert. Jedes Paket bringt Tests mit; Migrationen sind ergänzend. + +### 14.1 Gemeinsame Architekturkomponenten + +Diese Teile werden von Bibliothek **und** Website gebraucht. Sie entstehen jeweils einmal, in dem Paket, das sie zuerst braucht, und nach einem Vertrag, der vor Beginn dieses Pakets feststeht. + +| Nr. | Komponente | Vertrag | Entsteht in | Genutzt von | +|---|---|---|---|---| +| **G1** | Strukturleser | Liest eine zur Anzeige freigegebene Kompositionsfassung als Baum mit Identität, fixierter Kindesfassung, Rolle, Reihenfolge, Inhaltsart und Klasse-A-Daten. **Kennt keine Person und keine Berechtigung.** Die Mitgliederansicht legt die Berechtigung je Blatt als zweite Schicht darüber; die öffentliche Seite legt eine Projektion ohne geschützte Felder darüber. | Paket 3 | Paket 3, Paket 7, W3 | +| **G2** | Anzeigefreigabe | Eigener Zustand je Kompositionsfassung mit Bearbeiter und Zeitpunkt; unabhängig vom Status `bereit` und vom Artikel-Stand; abfragbar „ist diese Fassung freigegeben“ und „höchste freigegebene Fassung dieser Identität“. | Paket 3 | Paket 3, Paket 7, W3 | +| **G3** | Inhaltsart | Konfigurierbare Werte mit stabiler Kennung; Startwerte `programm`, `modul`, `merkblatt`, `traineranleitung`; je Identität ausdrücklich gesetzt; ändert weder `kind` noch `output_class`. | Paket 2 | Paket 3, Paket 5, W3 (Seitentyp und Adresse) | +| **G4** | Klasse-A-Anzeigefelder | Anzeigetitel und Kurzbeschreibung an der Identität, mit Protokoll; ein Titel für Bibliothek und Website. | Paket 4 | Paket 3, Paket 5, W3, SEO-Vorbelegung | +| **G5** | Dimensionswerte | Stabile Kennung je Wert; die Säulen behalten ihre Identität; direkte und abgeleitete Zuordnung sind unterscheidbar; öffentliche Themen bleiben funktionsfähig. | Paket 5 | Paket 5, Themenseiten, Signaturen, öffentliches Profil der Säulen | +| **G6** | Bildableitung | Auftrag in der Hintergrundverarbeitung, der aus einem Bild oder Videoframe geschützte Ableitungen erzeugt; Freigabeklasse „geschützt“ oder „öffentlich“ als Eigenschaft der Verwendung. | Paket 6 | Paket 6, W2 (Medienbibliothek), W3 (öffentliche Freigabe) | +| **G7** | Abdeckungsbefund | Lesedienst „welche Blätter dieser Kompositionsfassung liegen in keinem Artikel-Stand dieses Angebotsumfangs“, aufrufbar auch außerhalb der Aktivierung. | Paket 7 | Paket 7, W3 (Angebots- und Programmseite) | +| **G8** | Aktuelle Angebotsfassung | Eine Lesefunktion „die eine aktive Fassung dieses Angebots“, bei Dubletten die höchste aktive Nummer. | Paket 1 | Paket 1, Registrierung, Kauf, W3 | +| **G9** | Instanz-Suite | Browser-Lauf über HTTP gegen die Testinstanz oder Wegwerf-Container; nie gegen Produktion; nie mit Leeren der Testdatenbank. | Paket 9 oder W1, je nachdem, was zuerst beginnt | Paket 9 (Tor A, Tor B), W1 bis W4 (Sicht-, Leistungs- und Barrierefreiheitsprüfung) | + +### 14.2 Einstufung der Bibliothekspakete + +| Paket | Einstufung | Bezug | Vor Beginn festzulegen | +|---|---|---|---| +| **0** Bestandsaufnahme | **unverändert umsetzbar** | keiner | — | +| **1** Angebotsfassung, Registrierung, Bestellbezeichnung | **unverändert umsetzbar** | liefert G8 | — | +| **2** Technische Struktur und Inhaltsart | **unverändert umsetzbar** | liefert G3 | die vier Startkennungen werden als stabil festgehalten | +| **3** Bibliothek und interne Medienaktionen | **abhängig von gemeinsamen Komponenten** | baut G1 und G2; ändert gemeinsam berührte Dateien (14.4) | Schnitt des Lesers in Struktur und Berechtigungsschicht; Anzeigefreigabe als eigener Zustand | +| **4** Klasse-A-Stammdaten | **unverändert umsetzbar** | liefert G4 | Feldnamen werden als gemeinsamer Vertrag festgehalten | +| **5** Fachdimensionen, Suche, Filter | **abhängig von gemeinsamen Komponenten** | baut G5; berührt die Säulen, auf denen die öffentlichen Themen beruhen | Kennungen der Säulenwerte bleiben; `/themen` bleibt während und nach der Übernahme erreichbar | +| **6** Einfache Thumbnails | **unverändert umsetzbar** | liefert G6 | — (öffentliche Freigabe ist ein Schritt von W3, nicht dieses Pakets) | +| **7** Redaktionelle Vorschau und Angebotsabdeckung | **abhängig von gemeinsamen Komponenten** | nutzt G1, G2; baut G7 | Abdeckungsbefund als Lesedienst, nicht nur als Prüfung in der Aktivierungsmaske | +| **8** Kommerzielle Medienausgabe | **unverändert umsetzbar** | keiner zur Website | — | +| **9** E2E-Abnahme, Tor A und Tor B | **abhängig von gemeinsamen Komponenten** | nutzt G9 | eine gemeinsame Instanz-Suite für Bibliothek und Website | + +„Abhängig“ heißt nicht, dass ein Paket warten muss oder anders zugeschnitten wird. Es heißt: Der genannte Vertrag wird vorher abgestimmt, damit W3 keinen zweiten Leser, keine zweite Freigabe und keinen zweiten Abdeckungsbefund baut. + +### 14.3 Gemeinsame Reihenfolge + +```mermaid +flowchart TB + subgraph S0["Schritt 0: sofort, parallel"] + P0["Paket 0 Bestandsaufnahme"] + W0["W0 Markenbasis"] + V["Verträge G1 bis G8 festhalten"] + WP["W-P Editor-Prototyp"] + end + subgraph S1["Schritt 1"] + P1["Paket 1 Lizenz und Bestellung"] + P2["Paket 2 Inhaltsart"] + W1["W1 Designsystem, Adressen, SEO-Technik"] + M0["M0 Messbasis"] + end + subgraph S2["Schritt 2"] + P3["Paket 3 Bibliothek mit G1, G2"] + TA["Paket 9, Tor A"] + W2["W2 Seitensystem"] + end + subgraph S3["Schritt 3"] + P4["Paket 4 Klasse A"] + P5["Paket 5 Dimensionen, Filter"] + P6["Paket 6 Thumbnails"] + P7["Paket 7 Vorschau, Abdeckung"] + W1B["W1b Mitgliederbereich im Designsystem"] + end + subgraph S4["Schritt 4"] + W3["W3 Öffentlicher Katalog"] + P8["Paket 8 Medienausgabe"] + end + subgraph S5["Schritt 5"] + TB["Paket 9, Tor B"] + VS["Verkaufsstart"] + W4["W4 Wissen und Landingpages"] + end + V --> P3 + WP --> W2 + W0 --> W1 + P1 --> P3 + P2 --> P3 + P3 --> TA + P3 --> P4 + P4 --> P5 + P3 --> P6 + P3 --> P7 + P3 --> W1B + W1 --> W1B + W1 --> W2 + W2 --> W3 + P4 --> W3 + P7 --> W3 + P3 --> P8 + P5 --> TB + P6 --> TB + P7 --> TB + P8 --> TB + TB --> VS + W3 --> VS + W3 --> W4 +``` + +| Schritt | Bibliothek | Website und CMS | Warum konfliktfrei | Übergang | +|---|---|---|---|---| +| **0** | Paket 0 | W0; Verträge G1 bis G8; W-P | Paket 0 liest nur; W0 ist Gestaltung und Entscheidung; W-P berührt nur den Seiteneditor und braucht keine Migration | Verträge liegen vor; Ergebnis von W-P steht fest | +| **1** | Paket 1, Paket 2 | W1 **ohne Mitgliedsansichten**; M0 | Pakete 1 und 2 liegen in Katalog und Verwaltung; W1 in Layout, Tokens, öffentlichen Ansichten und Adressauflösung | Tests grün; W1 mit Sichtprüfung abgenommen | +| **2** | Paket 3, danach Tor A | W2 | Paket 3 ersetzt die Mitgliedsansichten und die Routen unter `bereich`; W2 liegt im Seitensystem | Tor A bestanden | +| **3** | Pakete 4 und 5 nacheinander; 6 und 7 parallel dazu | W1b; W2 läuft weiter | W1b beginnt erst, wenn Paket 3 die Mitgliedsansichten neu aufgebaut hat, und fasst deren Struktur nicht an | Pakete 4 und 7 fertig | +| **4** | Paket 8 | W3 in drei Teilen (unten) | Paket 8 liegt in der Auslieferung; W3 liest nur | W3 abgenommen; Pakete 1 bis 8 fertig | +| **5** | Tor B | W4; danach M1, M2 | — | Verkaufsstart nach Tor B und W3 | + +**W3 in drei Teilen**, damit früh etwas sichtbar wird: + +| Teil | Inhalt | Braucht | +|---|---|---| +| W3a | öffentliches Profil, Lesesicht, Programm- und Modulseite | Pakete 2, 3, 4 (G1 bis G4) | +| W3b | Angebotsseite, Angebotsbausteine, Lizenzvergleich, „nicht enthalten“ | Pakete 1, 7 (G7, G8) | +| W3c | Module je Thema, Katalogfilter, öffentlich freigegebene Vorschaubilder | Pakete 5, 6 (G5, G6) | + +**Kaufaufrufe** auf öffentlichen Seiten werden erst nach Tor B geschaltet. Tor A gibt nichts frei und ist auch für die Website kein Starttor. + +**Was sich gegenüber dem Bibliotheksplan ändert:** nichts an Inhalt und Reihenfolge der Pakete 0 bis 9. Hinzu kommen die Vertragsabstimmung vor Paket 3, 5 und 7 und die Regel für gemeinsam berührte Dateien. + +### 14.4 Gemeinsam berührte Dateien + +| Datei oder Bereich | Geändert von | Regel | +|---|---|---| +| `resources/views/member/*`, `CourseOutline`, `LibraryController` | Paket 3 (neu aufgebaut), Pakete 4 bis 7 (ergänzt), W1b (Gestaltung) | W1 fasst diese Dateien nicht an. W1b folgt nach Paket 3 und ändert Klassen und Komponenten, nicht Struktur und Logik. | +| `routes/web.php` | Paket 3 (Gruppe `bereich`), W1 (öffentliche Routen, Auffangroute, `robots.txt`), W3 (Objektrouten) | getrennte Abschnitte der Datei; Änderungen nacheinander zusammenführen, nicht in parallelen langlebigen Zweigen | +| `resources/views/layouts/site.blade.php` | W1 (Kopfzeile, Kopfangaben) | Die Bibliothekspakete nutzen das Layout unverändert (E-D). Die neutrale Kopfzeile aus 5.6 muss den Einstieg in den Mitgliederbereich erhalten. | +| `resources/css/app.css` | W1 (Tokens), W1b | Bibliothekspakete fügen keine neuen Gestaltungsregeln hinzu; funktionale Listen genügen (E-D). | +| `resources/js/app.js` | Paket 3 (entfernt den Entscheidungsknopf), W1 (Navigation) | Paket 3 zuerst; W1 ergänzt eigene Module | +| Säulen: `pillars`, `content_element_pillar`, `page_pillar`, `ThemeController` | Paket 5 (Übernahme in Dimensionen), W3 (Säulen als öffentliches Profil) | Paket 5 löscht keine Spalten und erhält die Kennungen. Die Einordnung der Themen in das öffentliche Profil folgt erst nach Paket 5. | +| Ableitungsauftrag neben `StoreContentFile` | Paket 6, W2, W3 | ein Auftrag mit Parametern, kein zweiter | +| `DemoCatalogSeeder` | Paket 9 | Der Seeder setzt keine Inhaltsart auf vorhandene Zeilen (Bibliotheksplan). Öffentliche Profile werden vom Seeder nur in der Testumgebung und nur für eigene Demokennungen angelegt. | + +### 14.5 Arbeitspakete der Spuren W und M + +Stufen wie im Zielkonzept, Kapitel 14. + +| Stufe | Paket | Hängt ab von | Tests (Auswahl) | +|---|---|---|---| +| **W-P** | Editor-Prototyp nach 4.5 | — | Bedienaufgaben T1 bis T9, Kriterien K1 bis K5 | +| **W1** | Tokens und Grundkomponenten | W0 | Darstellungstests je Komponente; Sichtprüfung | +| | mehrteilige Pfade, reservierte Präfixe | — | Auflösung, Kollision | +| | Weiterleitungen und Statuscodes | Pfade | Pfadänderung, Kette, Schleife, 410 | +| | Kopfangaben, Markup, Sitemap, `robots.txt` je Umgebung | — | je Seitentyp; NT-W5 | +| | neutrale Kopfzeile, öffentliche Routen ohne Sitzung, Seitenspeicher | — | gleiche Antwort für Gast und Mitglied; Entwertung | +| **W1b** | Mitgliederbereich auf Tokens und Grundkomponenten | W1, Paket 3 | Tests der Pakete 3 bis 7 bleiben grün; Sichtprüfung in drei Breiten | +| **M0** | Zählaufruf und Tageszähler | W1 | Zählung, keine Speicherung im Browser | +| | Herkunft an der Registrierung | — | Parameter wird gespeichert, Zählung ohne Kennung | +| **W2** | Bausteinvertrag, Klasse je Art, Schemaversion | W-P bestanden | Altbestand wird unverändert dargestellt | +| | Varianten und Abschnittseinstellungen | Vertrag | je Variante | +| | Vorlagen, Duplizieren | Vertrag | Kopie ist unabhängig | +| | globale Abschnitte | Vertrag | Änderung wirkt nach Veröffentlichung | +| | Medienbibliothek mit Ableitungen | G6 oder eigener Vorgriff nach demselben Vertrag | Web-Prozess schreibt nicht | +| | Builder mit Blockvorschau, Vorschau in drei Breiten | W-P bestanden | Bedienaufgaben aus 4.5 als Abnahme | +| | Prüfungen vor Veröffentlichung | Vertrag | je Prüfung | +| **W3a** | öffentliches Profil, Zuordnung Inhaltsart → Seitentyp, Lesesicht | Pakete 2, 3, 4 | NT-W1 bis NT-W3, NT-W7 | +| | Programm- und Modulseite, Fassungswahl, Verlinkungsregel | Profil | Fälle A bis D aus 6.2; Modul mit abweichender Fassung wird nicht verlinkt | +| **W3b** | Angebotsseite, Katalog- und Angebotsbausteine, Lizenzvergleich | Pakete 1, 7 | NT-W4; „nicht enthalten“ | +| | Anfrageformular | — | Mengenbegrenzung | +| **W3c** | Module je Thema, Katalogfilter | Paket 5 | direkte und abgeleitete Themen unterscheidbar | +| | öffentliche Freigabe eines Vorschaubilds | Paket 6 | NT-W3 | +| **W4** | Seitentyp Beitrag, Autorenangaben | W2 | Pflichtangaben | +| | Zeitsteuerung | W2 | Termin wird wirksam | +| | Themencluster | — | Zuordnung | +| **M1** | Adapter für Suchdaten | M0 | nachgebildete Antworten; Lücke bei Fehler | +| | Regeln R01 bis R11 | W3 | je Regel mit Testdaten | +| | Maßnahmen, Entscheidung, Wirkungsnotiz | Regeln | Urteil „nicht beurteilbar“ | +| | Regeln R12 bis R16 | Datenmenge | Ruhen unter Mindestmenge | +| **M2** | Modelladapter, Auftragsdefinitionen, Protokoll | M1 | NT-M2, NT-M3; Ablehnung; Ausfall | +| | Vorschläge Stufe 1, Entwurfsrevision Stufe 2 | Adapter | Markierung; Sperre bei offener Quelle | +| **M3** | Schnittstelle für n8n | M2 | NT-M4 | + +**Reihenfolge innerhalb von W2:** zuerst Vertrag und Altbestand, dann Varianten, dann Vorlagen. So bleibt jede Zwischenstufe auslieferbar. + +--- + +## 15. Offene technische Punkte und Nachweise + +| Nr. | Punkt | Art | Vor | +|---|---|---|---| +| 1 | Editor-Prototyp nach 4.5 mit neun Bedienaufgaben und fünf technischen Kriterien | Prototyp, höchstens drei Tage Bau und ein halber Tag Erprobung | W2 | +| 2 | Öffnen öffentliche Routen heute eine Sitzung, und wie verhält sich der Seitenspeicher mit dem vorhandenen Proxy | lesende Prüfung | W1 | +| 3 | Stand der drei Herkunftsadressen und Schutz der Testinstanz | lesende Prüfung am Server (erlaubt), Änderung durch Lars | W1 | +| 4 | Erzeugung von Bildableitungen unter der Trennung von Web-Prozess und Hintergrundverarbeitung | lesende Codeprüfung | W2 | +| 5 | Format und Bereinigung des vorhandenen Fließtexts | lesende Codeprüfung | W2 | +| 6 | Fassungswahl nach 6.2, Fälle A bis D, an einem echten Programm mit Modul-Artikeln durchspielen und bestätigen | fachliche Bestätigung mit Beispiel | W3a | +| 7 | Lernziele, Zeit- und Materialbedarf als Lehrinhalt an der Kompositionsfassung: heute ohne Felder und in keinem Bibliothekspaket enthalten. Zuschnitt und Zeitpunkt festlegen. | Entscheidung; kleines eigenes Paket | W3a, spätestens W4 | +| 8 | Zugang zur Search Console über ein Dienstkonto; Schnittstelle von Bing | Erprobung mit echtem Zugang | M1 | +| 9 | Verhalten des KI-Dienstes bei sensiblen Präventionsthemen | Erprobung mit zehn Beispielaufträgen | M2 | +| 10 | Verarbeitungsort und Aufbewahrung beim KI-Dienst | Vertragsprüfung | M2 | +| 11 | Verfügbarkeit des Freigabeschritts in der Community-Ausgabe von n8n; vorhandene Instanz | Prüfung | M3 | +| 12 | Kanonische Hauptadresse und Weiterleitung der Nebenform | Entscheidung, Einrichtung am Proxy durch Lars | W1 | +| 13 | Verträge G1 bis G8 aus 14.1 als kurze Festlegung, bevor die Bibliothekspakete 3, 5 und 7 beginnen | Abstimmung, etwa ein halber Tag | Bibliothek Paket 3 | + +--- + +## 16. Quellen + +Die Quellenliste mit Links, Prüfdatum und Einstufung steht im Zielkonzept, Kapitel 20. In diesem Dokument verwendet: Q04, Q06 bis Q20, Q25. Aussagen zum Code beruhen auf lesender Sichtung der in Kapitel 2 genannten Dateien am 15.11.2026. Mit **[ANNAHME]** gekennzeichnete technische Angaben (Datenbankbedarf der Messwerkzeuge, Nachlauf der Suchdaten, Schnittstelle von Bing) sind Erfahrungswissen ohne aktuelle Prüfung. diff --git a/docs/betrieb/Bestandsaufnahme_Deployment_2026-11-15.md b/docs/betrieb/Bestandsaufnahme_Deployment_2026-11-15.md new file mode 100644 index 0000000..f45c340 --- /dev/null +++ b/docs/betrieb/Bestandsaufnahme_Deployment_2026-11-15.md @@ -0,0 +1,113 @@ +# LUF – Bestandsaufnahme Deployment und Server (Stand 2026-11-15) + +Rein lesende Untersuchung über vorhandene SSH-Zugänge. Es wurde nichts geändert, installiert oder deployt. +Kennzeichnung: **[V]** = am System verifiziert, **[D]** = nur dokumentiert (Shinkan-Repo), **[?]** = nicht verifiziert. + +## 1. SSH-Bestandsaufnahme + +| Ziel | Zugang | Ergebnis | +|---|---|---| +| Pi (`raspberrypi5`, 192.168.2.49) | Alias `pi`, User `lars`, Key `id_ed25519` | [V] Login ok. Gruppen `sudo`, `docker`, `adm`. | +| llm-node (192.168.2.144) | **Kein Alias in `~/.ssh/config`.** Adresse und User `llmadmin` stammen aus `shinkan-jinkendo/.claude/docs/technical/PROD_DEPLOYMENTS.md`, nicht geraten. | [V] Key-Login als `llmadmin` ok. Funktioniert nur mit `ssh -T … `. ARM64/AMD64 ergibt sich daraus automatisch. | [V] Workflows | +| Runner-Guard | Hostname und `uname -m` werden geprüft | [V] Workflows | +| Secrets/Env | Prod: `/etc/shinkan/prod.env` (Existenz [V], Inhalt nicht gelesen), Pflichtvariable `DB_PASSWORD`; Dev: `.env` im Deploy-Verzeichnis. Gitea-Secrets nur für E2E. | [V]/[D] | +| Migration | Beim Container-Start des Backends, Health prüft `schema_complete` | [D] | +| Health | Prod: Wiederholungen bis ca. 3 min, `/api/health/ready` mit `status/database/schema_complete`. Dev: einmalig nach `sleep 5`. | [V] Datei | +| Rollback | **Kein automatischer.** Rückfall nur manuell (Pi-Workflow per `workflow_dispatch`). Fehlschlag lässt den neuen Stand laufen. | [V] Datei | +| Backup | `RECOVERY_CONTRACT.md` im Shinkan-Repo, nicht gelesen. Medien auf NAS. | [D], nicht verifiziert | +| Proxy/TLS | siehe Abschnitt 3 | [?] | + +Hinweis: `test.yml` und `deploy-dev.yml` hängen an der festen Umgebung `shinkan-dev`. Der Runner arbeitet im Host-Modus ohne Container-Isolation. + +## 5. Übernahmeplan + +**Unverändert übernehmen** +- Gitea Actions im Host-Modus, Runner pro Host mit eindeutigem Label und Runner-Guard. +- Branch-Modell `develop`/`main`, `git reset --hard`-Deploy in ein festes Verzeichnis je Umgebung. +- Eigenes Compose-Projekt (`-p`), Konfiguration aus Env-Datei außerhalb des Repos mit Vorabprüfung (Datei lesbar, Pflichtvariablen gesetzt, keine Werte ausgeben). +- Health-Schleife mit Wiederholung und aussagekräftigem Ready-Endpunkt. + +**Anpassen** +- **Tests als Gate:** Test-Job muss vor dem Deploy laufen (`needs:`) und im Test-Workflow selbst auf einem frischen Build laufen, nicht gegen die Dev-Umgebung. Für Prod: Merge auf `main` startet erst nach grünem `develop`-Lauf. Mit Gitea umsetzbar, indem der Prod-Workflow denselben Commit zuerst testet (Tests im Workflow wiederholen) oder per Branch-Schutz mit Pflichtstatus. Entscheidung nötig. +- **Rollback:** Vor dem Deploy vorherigen Commit/Image-Tag merken. Bei rotem Health den alten Stand wiederherstellen. Shinkan hat das nicht. +- **Laravel statt FastAPI:** Health-Endpunkt (`/up` oder eigener `/health/ready` mit DB-Check) statt `/api/health/ready`. Migration als expliziter Schritt `php artisan migrate --force` vor dem Umschalten, nicht beim Container-Start. Dazu `config:cache`, `queue:restart`. +- **Ressourcen Pi:** Mit 266 MiB frei und vollem Swap ist der Pi für einen zusätzlichen Stack mit PostgreSQL grenzwertig. Build mit Composer/npm (`--no-cache`) braucht kurzfristig mehrere hundert MiB. **Risiko hoch, bevor U0 startet mit dem Besitzer klären.** +- **Betriebssystem:** Der Pi läuft Debian 12, nicht Ubuntu. Für Docker-Images ohne Folgen, in der Dokumentation korrigieren. +- **Test und Prod strikt trennen:** eigene Compose-Projekte (`luf-test`, `luf-prod`), eigene Volumes, eigene Env-Dateien (`/etc/luf/test.env` und `/etc/luf/prod.env`), eigene DB-Passwörter, eigene Medienbereiche (Prod nicht auf dem NAS-Pfad von Shinkan). +- Eigene Runner-Labels sind nicht nötig: `ubuntu-latest` (Pi) und `linux_host` (llm-node) wiederverwenden. Beide Runner bedienen dann zusätzlich LUF [V: Runner laufen]. + +## 6. U0-Implementierungsgrundlage + +Reihenfolge: +1. **Klären (blockierend):** Reverse Proxy/TLS und Domains für LUF (Test und Prod). Freigabe der Ressourcenlage auf dem Pi. Bestätigung, dass llm-node (nicht ein anderer Mini-PC) die Produktion ist. +2. Gitea-Repository `Lars/laraundfelix` [V: besteht, `main` gepusht]. Branch `develop` anlegen, Branch-Schutz auf `main`. +3. Repo-Gerüst: Laravel 13, PHP 8.4, Filament 5, `docker-compose.yml` (app/php-fpm, nginx, postgres, ohne Host-Port außer nginx), `docker-compose.test.yml`/`docker-compose.prod.yml` als Override. +4. Env-Dateien außerhalb des Repos anlegen (`/etc/luf/test.env` auf dem Pi, `/etc/luf/prod.env` auf llm-node). Das ist eine Serveränderung und braucht eine ausdrückliche Freigabe. +5. Workflow `deploy-test.yml` (push `develop`): Tests → Build → Deploy → Health, nach Shinkan-Vorbild mit Rollback. +6. Workflow `deploy-prod.yml` (push `main`, Label `linux_host`): Guard, Tests auf dem Commit, Build, Migrate, Health, Rollback. +7. Ports: Test 3095/tcp (Pi), Prod 3010/tcp (llm-node), nach erneuter Konfliktprüfung unmittelbar vor der Reservierung. + +## Nicht verifiziert +Reverse-Proxy-Konfiguration und TLS, Firewall (kein sudo), vollständige systemd-Dienste auf llm-node (Abfrage Timeout), Compose-Dateien anderer Projekte auf dem Pi (Reservierungen), Inhalt von `RECOVERY_CONTRACT.md` und tatsächliche Backup-Läufe, Ergebnisse früherer Workflow-Läufe in Gitea, Runner-Labels (nur Shinkan-Doku), Erreichbarkeit/Zugang zum NAS 192.168.2.63. diff --git a/docs/betrieb/DEPLOYMENT.md b/docs/betrieb/DEPLOYMENT.md new file mode 100644 index 0000000..9c1e035 --- /dev/null +++ b/docs/betrieb/DEPLOYMENT.md @@ -0,0 +1,76 @@ +# LUF – Deployment (Stand 2026-11-15) + +Abgeleitet aus dem Shinkan-Verfahren, siehe [Bestandsaufnahme_Deployment_2026-11-15.md](Bestandsaufnahme_Deployment_2026-11-15.md). +**Status: Anwendung U0 liegt im Repo. Ein Deploy ist erst gelaufen, wenn ein Push auf `develop` den Workflow grün durchlaufen hat.** Lokal gibt es PHP 8.4 und Node. Docker liegt auf dem Runner, nicht auf dem Entwicklungsrechner. + +## Ablauf + +| Auslöser | Workflow | Schritte | +|---|---|---| +| Push auf `feature/**` | `ci-feature.yml` | Commit klonen, Test-Image bauen, Pint und `php artisan test` im Wegwerf-Container | +| Push auf `develop` | `deploy-test.yml` | Tests, dann Deploy Test (`luf-test`, Port 3011) | +| Push auf `main` | `deploy-prod.yml` | Tests auf genau diesem Commit, dann Deploy Prod (`luf-prod`, Port 3010) | + +- Der Deploy-Job hat `needs: test`. Sind die Tests rot, läuft kein Deploy. +- Deployt wird der getestete Commit (`github.sha`), nicht der jeweils neueste Stand des Branches. +- `scripts/deploy.sh`: Konfigurationsprüfung, Portkonflikt-Prüfung, Build, DB starten, `migrate --force`, Start, Health (`/up` und Datenbankzugriff). Bei Fehler Rollback auf den letzten erfolgreichen Image-Tag (`.last_good_tag`). Der Deploy legt keinen Demokatalog an. `DemoCatalogSeeder` bleibt für die Testsuite; der Bestand der Testinstanz wird in der Verwaltung gepflegt. +- Ein Deploy gleichzeitig pro Host (`flock`), alte Images werden bis auf die letzten Tags entfernt. +- **Rollback betrifft nur den Code.** Migrationen werden nicht zurückgenommen. Migrationen müssen daher abwärtskompatibel sein (erst ergänzen, später entfernen). + +## Trennung Test und Prod (beide auf llm-node) + +| | Test | Prod | +|---|---|---| +| Branch | `develop` | `main` | +| Compose-Projekt | `luf-test` | `luf-prod` | +| Deploy-Verzeichnis | `/home/llmadmin/docker/luf-test` | `/home/llmadmin/docker/luf-prod` | +| Env-Datei | `/etc/luf/test.env` | `/etc/luf/prod.env` | +| Web-Port | 3011/tcp | 3010/tcp | +| Volumes, Netz, DB | eigene (Projekt-Präfix) | eigene (Projekt-Präfix) | + +Ports aus der Momentaufnahme vom 2026-11-15 (frei laut `ss` und `docker ps`). Das Skript bricht ab, wenn der Port von einem fremden Dienst belegt ist. DB, PHP-FPM, Queue und Scheduler veröffentlichen keine Host-Ports. + +## Medien-Ablage auf dem NAS + +| | Test | Prod | +|---|---|---| +| NAS-Ordner [?] | `/volume1/luf_media_dev` | `/volume1/luf_media` | +| Mountpunkt auf llm-node | `/srv/luf/test/media` | `/srv/luf/prod/media` | + +Der Pfad auf dem NAS ist aus den Ordnernamen abgeleitet und **nicht verifiziert**: Beide Ordner standen am 2026-11-15 nicht in der NFS-Exportliste des NAS (`showmount -e`). + +Aufbau je Umgebung, nach `03_Zielarchitektur.md` (Zeilen 241/242) und `08_Medien_Streaming_Kennzeichnung.md` (Abschnitt 1): + +| Ordner | `queue` (Hintergrundverarbeitung) | `app` (Web-Prozess) | +|---|---|---| +| `originals/` | lesen und schreiben | **kein Zugriff** (nicht gemountet) | +| `derived/` (privat) | lesen und schreiben | nur lesen | +| `public/` | lesen und schreiben | nur lesen | + +- Die Trennung geschieht über getrennte Bind-Mounts im Compose. Das NAS selbst unterscheidet nicht zwischen den Containern. +- Bind-Mounts mit `create_host_path: false`: Fehlt der NFS-Mount, startet der Container nicht, statt Medien auf die lokale Platte zu schreiben (wie bei Shinkan). +- Der Host-Pfad ist in `scripts/deploy.sh` fest an die Umgebung gebunden (`/srv/luf/$LUF_ENV/media`). Test kann nicht auf den Prod-Bestand zeigen. Das Skript prüft vor dem Build, dass der Pfad ein NFS-Mount ist, legt fehlende Unterordner an und macht nach dem Build eine Schreibprobe als `www-data`. +- Im Container ist der Pfad derselbe wie auf dem Host. Compose hängt die Unterordner an genau diese Stelle und setzt `MEDIA_PUBLIC_PATH`, `MEDIA_DERIVED_PATH` und `MEDIA_ORIGINALS_PATH` darauf. Ein abweichender Wert in der Env-Datei wird damit überstimmt. +- Die CI-Tests mounten keine Medien (`Storage::fake()`). +- Datensicherung: Originale sind laut `11_Betrieb_Sicherheit_Datenschutz.md` kritisch (NAS und außer Haus). Snapshots und Replikation für `luf_media` sind Sache des NAS und noch nicht eingerichtet. + +## Einmalig auf llm-node vorzubereiten (nicht automatisiert, braucht `sudo`) + +1. `sudo mkdir -p /etc/luf && sudo chown llmadmin:llmadmin /etc/luf && sudo chmod 750 /etc/luf` +2. `/etc/luf/test.env` und `/etc/luf/prod.env` aus [deploy/luf.env.example](../../deploy/luf.env.example) anlegen, `chmod 640`. Je eigener `APP_KEY` (`php artisan key:generate --show`) und eigenes DB-Passwort. Prod: `APP_ENV=production`, `APP_DEBUG=false`. +3. Auf dem Synology zwei Proxy-Einträge: Prod nach `192.168.2.144:3010`, Test nach `192.168.2.144:3011`. +4. In Gitea: Branch-Schutz für `main` (nur Pull Request, Freigabe nötig) und `develop`. Repository-Sichtbarkeit prüfen (siehe unten). +5. Backup (`borgmatic`) wieder grün, bevor produktiv deployt wird. + +## Annahmen und offene Punkte + +- **Repository-Zugriff der Runner [?]:** Die Workflows klonen `http://192.168.2.144:3000/Lars/laraundfelix.git` ohne Zugangsdaten, wie Shinkan. Ist das Repository privat und der Runner nicht angemeldet, schlägt der Clone fehl. +- **Gitea-Actions-Syntax [?]:** `needs:` und `github.sha` sind Standard, wurden aber auf dieser Gitea-Version nicht ausprobiert. `actions/checkout` wird bewusst nicht benutzt. +- **Laravel-Gerüst:** `composer.json`, `composer.lock`, `package.json` und `package-lock.json` liegen im Root. Die Health-Route ist `/up`. Das Image veröffentlicht die Filament-Assets beim Bau (`php artisan filament:assets`) und baut das Frontend mit `npm run build`. +- **Zeilenenden:** `.gitattributes` erzwingt LF für Skripte, weil lokal `core.autocrlf=true` gesetzt ist. +- **Öffentliche CMS-Bilder:** Der Web-Prozess schreibt nicht nach `public/`. Ein Upload liegt zuerst auf dem beschreibbaren Storage-Volume (`cms_incoming`). Die Queue kopiert nach `public/` auf dem Medienpfad. Ausgeliefert wird die Datei über die Anwendung unter `/medien/…`, zuerst aus dem öffentlichen Medienpfad, ersatzweise aus dem Eingang. `storage:link` wird dafür nicht gebraucht. +- **Reverse Proxy:** Die Anwendung vertraut weitergeleiteten Proxy-Kopfzeilen. Nginx reicht `X-Forwarded-Proto`, `X-Forwarded-Host`, `X-Forwarded-Port` und `X-Forwarded-For` an PHP weiter. Der Proxy vor dem Container muss `X-Forwarded-Proto` setzen, damit Adressen `https` bleiben. +- **Upload:** Filme bis 2 GB. Dieselbe Grenze gilt in Livewire (Zwischendatei, sonst 12 MB), im Formular, in PHP (`upload_max_filesize`, `post_max_size`) und in Nginx (`client_max_body_size`). Die signierte Upload-Adresse gilt 60 Minuten. Die Queue kopiert die Datei als Strom nach `derived/` und behält den Auftrag bis zu einer Stunde; `retry_after` der Datenbank-Queue liegt darüber. +- **Queue:** Datenbank-Queue (`QUEUE_CONNECTION=database`), kein Redis. Reicht für den Start. Der Worker erlaubt einem Auftrag bis zu einer Stunde (`--timeout=3600`). Das App-Image enthält `ffmpeg`. Die Queue leitet daraus Vorschaubilder und, wenn die Datei lesbar ist, drei HLS-Qualitätsstufen nach `derived/` ab. Fehlt die Ableitung, bleibt die gespeicherte Datei über den bisherigen berechtigten Abruf lesbar. Der Web-Prozess schreibt diese Ableitungen nicht. +- **Gate vor Prod:** Merge-Schutz ist eine Gitea-Einstellung und gehört nicht in die Workflows. +- **Umzug Test auf den Pi:** Werte oben in `deploy-test.yml` ändern (Label `ubuntu-latest`, Guard auf `raspberrypi5`/`aarch64`, Pfade, Port). Das Dockerfile baut auch für ARM64. Vorher Speicherlage auf dem Pi klären. diff --git a/docs/betrieb/MVP-Stand.md b/docs/betrieb/MVP-Stand.md new file mode 100644 index 0000000..9899a40 --- /dev/null +++ b/docs/betrieb/MVP-Stand.md @@ -0,0 +1,30 @@ +# MVP-Stand + +Fortschritt für die fachliche Erprobung auf `develop`. Kein Ersatz für die Spezifikation. + +## Bedienbar + +- Öffentliche Seiten unter `/verwaltung` als Redakteur: Entwurf, Veröffentlichung, Wiederherstellung. +- Inhaltselemente, Fassungen und Kompositionen als Redakteur. Eine Datei wird von der Queue nach `derived/` kopiert. +- Lizenzartikel, verschachtelte Pakete, Rechteprofile und Angebote als Katalogverwalter. Die jeweilige Seite zeigt den Stand, die Bestandteile, die aufgelösten Artikel und die daraus entstehenden Berechtigungen. Ein neuer Stand zeigt Inhaber, Angebote und Inhaltszahl; ein Rückzug stellt den vorherigen Stand wieder her und nennt die Betroffenen. +- Manuelle Vergabe als Kundenbetreuung, am Benutzer in der Verwaltung. +- Registrierung, Anmeldung, kostenloser Abruf, Testkauf, Ablehnung und Widerruf im Mitgliederbereich. Die Verwaltung fragt den Authenticator-Code auf demselben Browser 30 Tage lang nicht erneut ab. In der Authenticator-App heißt der Eintrag „Lara&Felix“, außerhalb der Produktion „Lara&Felix (dev)“. Ein bestehender Eintrag übernimmt den Namen erst bei erneuter Einrichtung. +- Medien werden in der Verwaltung angelegt und geöffnet: die Datei oder der Text der gewählten Fassung ist dort sichtbar. Jede Fassung hat eine eigene Nummer. Beschreibung, Arbeitstitel und Säulen gehören zum Medium und ändern keine Fassung. Eine deaktivierte Fassung bleibt einsehbar, wird nicht mehr ausgeliefert und lässt sich nicht neu einbauen. Eine Datei darf bis 2 GB groß sein. Ein Medium kann mehreren fachlichen Säulen zugeordnet sein; weitere Säulen lassen sich anlegen. Übungen, Kurse und fachliche Kombinationen sind getrennte Zusammenstellungen; ihre Bausteine lassen sich hinzufügen, tauschen und aus der neuen Fassung nehmen. +- Eine veröffentlichte fachliche Säule ist ein Themenbereich der Website unter `/themen` und auf der Startseite. Seiten können mehreren Säulen zugeordnet sein. Die Medien selbst bleiben privat. +- Kurse im Mitgliederbereich zeigen den Namen der Übung, die Bausteine in Reihenfolge und einen Player. Ein Film mit Entscheidungsmarke lässt sich an dieser Stelle pausieren und von vorn starten. Die Verwaltung zeigt den Text einer Fassung und, sobald die Datei übernommen ist, die Datei selbst. +- Bibliothek entscheidet je Abruf erneut. Filme mit Datei werden im Player geladen, Texte und PDF über einen kurz signierten Abruf. + +Der Systemverwalter vergibt diese Rollen und kann sie dem eigenen Konto geben. Ein Konto darf mehrere Rollen tragen. + +Auf der Testinstanz steht `APP_URL` noch auf dem Platzhalter. Solange das so ist, baut die Anwendung Links aus der Adresse, die der Browser tatsächlich geöffnet hat. Ein Zugriff direkt über die IP, ohne Reverse Proxy, bleibt dabei auf dieser Adresse; die Anmeldung springt nicht auf `verwaltung/` als Host. + +## Testdaten + +`DemoCatalogSeeder` legt auf der Testumgebung Merkblatt, verschachtelte Übung, zwei Pakete, ein kostenloses Angebot und den Testkauf „Testkauf Programm“ für 5,00 € an. Der Betrag ist eine Erprobungsmarke, keine Preisentscheidung. Der Seeder läuft nur bei `LUF_ENV=test` und legt nichts ein zweites Mal an. + +## Noch nicht der Zielschnitt + +- Kein adaptives Streaming, keine persönliche PDF-Kennzeichnung, kein Ausgabenachweis. +- Zahlungsdienst ist der Testweg (`PAYMENT_DRIVER=test`). Ein Anbieter ist nicht festgelegt. In Produktion ist die Testbestätigung abgewiesen. +- Organisationen, Sitzplätze, Community, Rechnungen und Erstattungen über einen Zahlungsdienst fehlen. +- Echte NAS-Dateien werden nicht automatisch eingebunden. Eine Filmdatei wird in der Verwaltung als Fassung hochgeladen. diff --git a/docs/fachkonzept/LUF_Zukunftskonzept_Trainingsplanung_Methodik_Freemium_2026-11-16.md b/docs/fachkonzept/LUF_Zukunftskonzept_Trainingsplanung_Methodik_Freemium_2026-11-16.md new file mode 100644 index 0000000..9078ef0 --- /dev/null +++ b/docs/fachkonzept/LUF_Zukunftskonzept_Trainingsplanung_Methodik_Freemium_2026-11-16.md @@ -0,0 +1,201 @@ +# Lara & Felix – Ideen- und Entscheidungsstand zu Übungen, Trainingsplanung und Vermarktung + +**Stand:** 16.11.2026 +**Status:** Diskussionsstand / Zukunftskonzept – **kein** Implementierungsauftrag, **keine** Änderung des bestehenden MVP-Scope +**Zweck:** Die in der UX-/Prozessdiskussion neu entstandenen Ideen bewahren, ohne die unmittelbar anstehende Verbesserung der bereits implementierten Benutzeroberflächen zu verzögern. + +> **Wichtig:** Dieses Dokument ersetzt weder `01_LUF_Zielbild_und_Fachkonzept_v1.1.md` noch `produktkonfiguration-und-mitgliederbereich.md` oder `trainingskonzept-und-produktstruktur.md`. Bestehende verbindliche Regeln behalten Vorrang. Neue Ideen sind ausdrücklich nach Entscheidungsstand gekennzeichnet. Vor einer späteren Implementierung werden nur die tatsächlich erforderlichen Änderungen am Fach- und Datenmodell geprüft. + +## 1. Abgrenzung: Was ist jetzt zu tun – und was nicht? + +### Unmittelbare Priorität: UX/UI für den vorhandenen MVP + +Die nächste Iteration soll die **bereits implementierten Elemente** in einen verständlichen, zusammenhängenden Benutzerprozess überführen, statt neue Fachfunktionen vorzuziehen. Zu den vorhandenen Elementen zählen laut Abschlussbericht vom 16.11.2026 insbesondere: + +- Medien und fachliche Inhalte sowie deren Fassungen; +- redaktionelle Stammdaten, Dimensionen und Vorschaubilder; +- fachliche Kompositionen, Module und Programme mit Versionierung und Freigaben; +- Lizenzartikel, Pakete, Rechteprofile und Angebote; +- geschützte Mitgliederbibliothek mit Programmen, Modulen, Material und Medienausgabe. + +**UX-Ziel:** Ein fachlicher Betreiber kann vorhandene Inhalte suchen, anlegen, zu Modulen/Programmen kombinieren, strukturiert prüfen, freigeben und den Bezug zu Lizenzartikeln und Angeboten verstehen – ohne das zugrunde liegende Datenmodell kennen zu müssen. Als erster Referenzfall dient das bestehende **„Programm Abstand“**. + +Der bestehende MVP ist technisch noch nicht vollständig abgenommen: Der Abschlussbericht dokumentiert unter anderem fehlendes Tor B und G9. Diese technische Restabnahme ist von der UX-Erprobung zu unterscheiden. + +**Nicht Bestandteil der ersten UX-Iteration:** neuer Übungsarbeitsplatz, eigenständige Trainingsplan-Verwaltung, persönlicher Kursplaner, vollständiger Kursplayer mit Ablaufsteuerung, neues Freemium-/Abo-Modell und nicht vorhandene Shop-/CMS-Funktionen. Diese Ideen gehören in die spätere Produktentwicklung und dürfen nicht als stillschweigende MVP-Pflicht in den aktuellen Auftrag geraten. + +### Vorgehensprinzip + +Kleine, **durchgängig benutzbare vertikale Iterationen**: bereits vorhandene Fachregeln heranziehen → konkrete Aufgabe und Bedienweg knapp definieren → auf der Testinstanz umsetzen → durch den Betreiber selbst testen → gezielt verbessern. Keine erneute monatelange Gesamtplanung oder offene UX-Gates. + +## 2. Bestand: Verbindliche fachliche Grundlage + +Die folgenden Regeln sind bereits dokumentiert und dürfen nicht durch die neue Begriffsdiskussion versehentlich ersetzt werden: + +| Gegenstand | Bisheriger Fachstand | Quelle | +|---|---|---| +| **Inhaltselement** | Film, PDF, Audio, Text, Anleitung usw.; stabile Identität und versionierte Inhalte | Zielbild `PROD-002`; Produktkonfiguration §2 | +| **Übung / Modul / Programm** | Frei komponierbare didaktische Einheiten ohne technisch erzwungene starre Hierarchie | Zielbild `PROD-001`; Trainingskonzept §4–6 | +| **Modul** | Eigenständig nutzbare didaktische Einheit mit möglichen Lernzielen, Medien, Übungen und Materialien | Produktkonfiguration §6 | +| **Programm** | Wiederverwendbare didaktische Zusammenstellung von Modulen und ggf. weiteren Inhalten; kein automatisch identisches Verkaufspaket | Trainingskonzept §4 und §6 | +| **Lizenzartikel** | Kleinste vom Betreiber ausdrücklich als eigenständig lizenzierbar definierte Einheit; kann einzelner Inhalt oder Komposition sein | Zielbild `PROD-003`; Produktkonfiguration §2/7 | +| **Bundle / Angebot** | Kommerzielle Zusammenstellung von Artikeln mit Preis, Rechten und Konditionen; unabhängig von der didaktischen Struktur | Zielbild `PROD-004` bis `PROD-008`; Produktkonfiguration §7 | +| **Wiederverwendung und Versionierung** | Keine Medienkopien je Verwendung; veröffentlichte, aufeinander abgestimmte Fassungen historisch stabil | Zielbild `VER-001` bis `VER-010` | +| **Persönliche Trainingsplanung** | Gespeicherte persönliche Kurssammlungen und didaktischer Spezialplayer ausdrücklich nicht als MVP entschieden | Produktkonfiguration §1, §7, §14 | + +**Terminologischer Hinweis:** Der vorhandene technische `CompositionKind` mit dem Wert `uebung` darf nicht unbesehen mit dem hier neu präzisierten fachlichen Übungsobjekt gleichgesetzt werden. Ebenso bedeutet „Modul“ nicht automatisch „Lizenzartikel“. + +## 3. Neu präzisiertes didaktisches Modell + +**Status: Arbeitshypothese / fachliche Richtung; noch nicht als Änderung des normativen Fachkonzepts umgesetzt.** + +### 3.1 Modul: kuratierter Werkzeugkasten + +Aus Betreibersicht ist ein Modul typischerweise ein zusammengehöriger, professionell ausgearbeiteter Baukasten: Filme/Medien, Begleitmaterialien, Trainerinformationen, Methodenhinweise und ggf. Übungen. **Module sollen bevorzugt kommerziell vermarktbare Einheiten sein**, ohne dass jedes Modul zwingend ein Lizenzartikel wird. + +Für einen erfahrenen Trainer kann eine kompakte Übersicht über Thema, Ziele, Inhalte und Materialien genügen. Ein anderer Trainer kann ausführliche Hinweise benötigen. Die UX sollte deshalb **Überblick und Vertiefung** ermöglichen, nicht eine starre Schritt-für-Schritt-Durchführung erzwingen. + +### 3.2 Übung: konkrete, wiederverwendbare Methodik + +Eine Übung beschreibt eine tatsächlich durchführbare Aktivität, etwa mit: + +- Lernziel(en), Zielgruppe und Voraussetzungen; +- Einstieg und Durchführung; +- Moderations-/Reflexionshinweisen und typischen Schwierigkeiten; +- möglichen Varianten und Alternativen; +- erforderlichen oder optionalen Medien und Materialien; +- ggf. Zeitbedarf und Vorbereitung. + +Übungen werden redaktionell vorbereitet, gespeichert und in unterschiedlichen Modulen bzw. Trainingsplan-Vorlagen wiederverwendet. Derselbe Film kann je nach Ziel als Einstieg, Fragestellung oder Reflexionsimpuls dienen; die Methodik ist nicht zwingend identisch. + +**Illustratives Beispiel:** „Persönliche Grenzen erkennen“ + +- **Variante A – mit Medium:** Film „Lara im Park“ als Impuls, Denkpause, Gespräch und anschließendes Rollenspiel; geschützte Medienaktion nur mit entsprechender Berechtigung. +- **Variante B – ohne Medium:** geschilderte Alltagssituation, Gespräch oder Rollenspiel und Reflexion; kein Zugriff auf den kostenpflichtigen Film erforderlich. + +Varianten sind alternative **gleichzeitig mögliche Durchführungen**, nicht automatisch verschiedene Fassungen einer Übung. Eine fachliche Überarbeitung der Übung selbst unterliegt hingegen der bestehenden Versionierungslogik. + +**Offen:** Wie eine Übung im Detail gespeichert und freigegeben wird, wie frei bzw. geschützt einzelne Übungsinhalte sind und wie Varianten auf konkrete Medien-/Kompositionsfassungen verweisen. Dies **nicht** in der laufenden MVP-UX-Iteration neu implementieren. + +### 3.3 Programm: didaktische Vorlage + +Ein Programm stellt einen wiederverwendbaren didaktischen Zusammenhang und übergeordnete Ziele dar. Es kann mehrere Module oder andere Inhalte bündeln, ist **nicht gleichbedeutend mit einem kommerziellen Bundle** und muss auch nicht einer konkreten Durchführung entsprechen. + +### 3.4 Redaktionelle Trainingsplan-Vorlage + +Eine Trainingsplan-Vorlage zeigt einen **möglichen konkreten Einsatz** von Übungen und Modulen – z. B. eine 60-minütige Einheit für eine bestimmte Zielgruppe mit Reihenfolge, Zeitbedarf, Materialien, Alternativen und methodischen Hinweisen. + +Sie kann auf einem Programm basieren oder unabhängig davon zusammengestellt werden. Die Vorlage ist weder die persönliche Durchführung noch notwendigerweise ein selbstständiger Verkaufsartikel. Sie kann dem Trainer als Orientierung dienen und auf die zur Umsetzung benötigten lizenzierten Module verweisen. + +### 3.5 Persönlicher Trainingsplan und tatsächliches Training + +- **Persönlicher Trainingsplan:** Ein Trainer übernimmt eine Vorlage oder stellt einen Ablauf für seine konkrete Gruppe selbst zusammen, passt Zeiten, Übungen und Materialien an und kann eigene Notizen hinterlegen. +- **Training / Durchführung:** Die reale Durchführung dieser Planung mit einer Gruppe. Eine mögliche spätere Dokumentation ist davon getrennt und braucht nicht automatisch personenbezogene Kinderdaten. + +Der **persönliche Planer** und ein weitergehender didaktischer **Kursplayer** (z. B. automatische Denkpause, Ablauf-/Präsentationssteuerung) gehören zur späteren Ausbaustufe, nicht zum bestehenden MVP. + +## 4. Website, Nutzerreise und Vermarktungsfunktion + +**Fachlich angestrebte Richtung:** Trainingsplan-Vorlagen und authentische Erfahrungsberichte können auf der öffentlichen Website demonstrieren, wie die Methode in der Praxis eingesetzt wird. Eine „kleine Reise durch die Nutzung“ führt vom Trainingsanlass über beispielhafte Übungen und Materialien zu den tatsächlich benötigten Modulen und Angeboten. + +Mögliche öffentliche Darstellung: + +1. Problem/Anlass und Lernziele verständlich vorstellen; +2. ausgewählte Ablaufabschnitte, Film-Teaser oder Methodenausschnitte zeigen; +3. echte Praxisbeispiele und Erfahrungsberichte mit Zustimmung der Beteiligten darstellen; +4. benötigte Module und Materialien transparent nennen; +5. passende Lizenzangebote und alternativ die persönlichen Gewaltschutzkurse des Betreibers aufzeigen. + +**Leitplanke:** Eine öffentlich gezeigte Trainingsplan-Vorschau schaltet keine geschützten Medien, vollständigen Trainerunterlagen oder anderen Premiuminhalte frei. Marketingdarstellung, didaktische Zusammenstellung, Lizenzartikel und konkrete Nutzungsrechte bleiben getrennt – mit gemeinsamer Datenbasis, damit Informationen nicht mehrfach inkonsistent gepflegt werden. + +## 5. Kostenloser Einstieg: 60-Minuten-Demo + +**Status: konkret befürwortete Angebotsidee, aber nicht Teil des aktuellen MVP-UX-Auftrags.** + +Ein kostenlos registriertes Mitglied soll perspektivisch mit einem **vollständig durchführbaren, etwa einstündigen Demo-Trainingsplan** beginnen können. Die benötigten ausgewählten Demo-Module werden dazu in einem passenden kostenfreien Angebot zugänglich gemacht. + +- Filme grundsätzlich **nur geschützt streambar**, ohne allgemeines Film-Downloadrecht; +- Vorführung im Kurs muss zum tatsächlich gewährten Nutzungszweck passen; +- notwendige Ausdrucke/Begleitmaterialien müssen entweder entbehrlich oder ausdrücklich passend freigegeben sein; +- der Kurs muss fachlich vollständig und sinnvoll sein, nicht eine künstlich beschnittene Demonstration; +- vertiefende Module, Programme und zusätzliche Nutzungsrechte bieten weiterführenden Mehrwert. + +Die Website soll den Demo-Plan verständlich vorstellen und zur kostenlosen Registrierung sowie später zu passenden Zusatzmodulen führen. + +**Noch zu klären, bevor dieses Angebot wirklich veröffentlicht wird:** konkreter Umfang, zulässige Nutzungszwecke (auch kommerzielle Kurse?), etwaige Gültigkeit und welche Begleitmaterialien heruntergeladen werden dürfen. Das technische Grundprinzip kostenloser Grants und differenzierter Medienrechte ist bereits fachlich vorgesehen. + +## 6. Know-how-Schutz und Geschäftsmodell – noch nicht abschließend entschieden + +**Wichtige neue strategische Erkenntnis:** Der Betreiber bietet selbst persönlich durchgeführte Gewaltschutzkurse an und möchte sich als Gewaltschutztrainer positionieren. Andere Trainer sind daher zugleich Kunden und mögliche Wettbewerber. + +Das wertvolle eigene Know-how liegt **nicht nur in Filmen und PDFs**, sondern auch in Übungen, Moderation, methodischen Varianten, konkreten Ablaufplänen, Best Practices und ausgearbeiteten Gesamtkonzepten. Ein vollständiges kostenloses Ausrollen aller Pläne und Anleitungen könnte das eigene Dienstleistungsgeschäft schwächen. + +### Entwicklung der Diskussion – keine fälschliche Endentscheidung + +1. **Frühe Idee:** Trainingsplan-Vorlagen und Übungen grundsätzlich frei; Vermarktung vorrangig über Medien und Module. +2. **Erweiterte Überlegung:** Ein echter kostenloser Demokurs mit ausgewählten Streamingmodulen als niedrigschwelliger Einstieg. +3. **Jüngste Gegenüberlegung:** Nicht der gesamte Methoden- und Planungsfundus sollte kostenlos verfügbar sein. Umfangreiche Durchführungspläne, Trainer-Best-Practices und professionelle Materialien könnten nur innerhalb erworbener Module/Programme zugänglich sein. Eine übergreifende Fachbibliotheks-Lizenz ist eine denkbare spätere Option. + +**Aktueller Entscheidungsstand:** Die Frage **„Welche Übungen, Pläne und Methodendetails sind öffentlich, für kostenlose Mitglieder bzw. nur mit erworbenen Rechten verfügbar?“ ist noch offen.** Die frühere Aussage „alle Übungen und Trainingspläne kostenlos“ ist **keine verbindliche aktuelle Festlegung**. Auch eine eigenständige Pflichtlizenz für alle Trainingspläne ist **nicht** beschlossen. + +Als **Arbeitshypothese**, nicht als Regel: + +| Ebene | Möglicher Zugang | Mögliche Rolle | +|---|---|---| +| Öffentliche Website | Teaser, Methode, ausgewählte Planabschnitte, Beispiele, echte Erfahrungsberichte | Vertrauen, Auffindbarkeit, eigener Kursvertrieb und digitale Vermarktung | +| Kostenlose Mitgliedschaft | Vollständig nutzbarer Demo-Plan, ausgewählte kostenlose Übungen und notwendige Demo-Medienrechte | Praxisnutzen erlebbar machen | +| Erworbene Module/Programme | Erweiterte Medien, vollständige Anleitungen, passende Ausführungspläne und Methoden | Kommerzieller Kern | +| Optionaler umfassender Zugang | Breitere Fachbibliothek mit vielen Plänen/Methoden | Spätere zu prüfende Produktvariante | + +Rechtliche Schutzfähigkeit von konkreten Werken, Methoden und Know-how sowie angemessene Nutzungsbedingungen sind **separat zu prüfen**; die bloße Zugangssperre erzeugt kein allgemeines Ausschließlichkeitsrecht an pädagogischen Methoden. + +## 7. Spätere UX-/UI-Anforderungen aus diesen Ideen + +Dies sind **Hinweise für spätere Iterationen**, keine sofort zu implementierende Oberfläche: + +| Anwender | Aufgabe | Mögliche UX-Anforderung | +|---|---|---| +| Redaktion | Übung erstellen und in mehreren Kontexten nutzen | Wiederverwendbare Übung, gemeinsame Hinweise, alternative Methoden und referenzierte Materialien einfach pflegen | +| Redaktion | Trainingsplan-Vorlage aufbauen | Zeitlicher Ablauf, Übungen/Varianten, benötigte Medien, Alternativen und Trainerhinweise verständlich zusammenstellen | +| Redaktion/Marketing | Öffentliche Vorschau gestalten | Offen zugängliche Teaser vs. geschützte fachliche Details eindeutig unterscheiden | +| Betreiber | Free-/Premium-Zugang steuern | Zugangsregeln am realen Inhalt verständlich darstellen, nicht technische Grant-Tabellen im Vordergrund | +| Mitglied | Geeignete Übungsvariante finden | Verfügbarkeit und notwendige Rechte je Alternative verstehen; ohne Berechtigung sinnvolle Wege erkennen | +| Trainer | Trainingsplan für eigene Gruppe übernehmen | Vorlage adaptieren, ohne Original oder erworbene Rechte zu verändern | +| Interessent | Vom Praxisbeispiel zum passenden Inhalt gelangen | Tatsächlich benötigte Module und Nutzen des Erwerbs im Zusammenhang sehen | + +**UX-Prinzip:** Professionelle Trainer brauchen einen schnellen kompakten Überblick; detaillierte methodische Hinweise sollen bei Bedarf zugänglich sein. Ein starres Pflichtschema „Einstieg → Film → Gespräch → Übung → Abschluss“ wird nicht vorausgesetzt. + +## 8. Konsequenzen für Datenmodell und Architektur – ausdrücklich vertagt + +Aus den neuen Überlegungen könnten später zusätzliche Fachobjekte oder Beziehungen folgen, beispielsweise: + +- explizite Übung mit Durchführungsvarianten; +- redaktionelle Trainingsplan-Vorlage mit konkreter zeitlicher Struktur; +- persönlicher Trainingsplan als Kopie/Ableitung einer Vorlage; +- abweichende Zugangstiefen für öffentliche Vorschau, kostenlose Inhalte und vollständige Fachanleitungen; +- Transparenz darüber, welche Module/Medien eine Variante benötigt. + +**Noch keine Entscheidung**, ob hierfür Tabellen/Modelle ergänzt oder bestehende Kompositionen, Inhaltsfassungen und Lizenzregeln genutzt werden. Das wird erst bei der passenden späteren Implementierungsiteration gezielt geprüft. Es darf nicht rückwirkend die aktuelle UX-Verbesserung des bestehenden MVP blockieren. + +## 9. Fokus und nächster umsetzbarer Schritt + +**Jetzt:** Die bestehenden Elemente (Medien, Module, Programme, Fachliche Kombinationen, Freigaben, Lizenzartikel, Pakete, Rechteprofile, Angebote und Mitgliederbibliothek) auf einen **klaren redaktionellen und kommerziellen Workflow** abbilden. Benutzerbegriffe, Kontext, Suche, Zusammenstellung, Vorschau, Freigaben und Übergänge so gestalten, dass das bestehende Testprogramm „Abstand“ ohne Spezialwissen aufgebaut, verstanden und administriert werden kann. + +**Erster praxisnaher Prüffall:** Der Betreiber öffnet „Programm Abstand“, versteht die Struktur, kann enthaltene Module und Medien finden, sinnvoll bearbeiten oder neu zuordnen, Vorschau/Freigabe nachvollziehen und anschließend erkennen, wie das Programm mit einem Lizenzartikel und einem Angebot zusammenhängt. Die Benutzbarkeit wird **durch den Betreiber auf der Testinstanz** beurteilt, nicht allein durch Code- oder UI-Snapshot-Tests. + +**Später:** Übungsvarianten, Trainingsplan-Vorlagen, Demoangebot, eigene Trainingsplanung und abgestufte Veröffentlichung nach den dann ausdrücklich getroffenen Entscheidungen iterativ entwickeln. + +--- + +## 10. Quell- und Nachweisbasis + +Die bestehenden fachlichen Regeln und der aktuelle Implementierungsstand wurden gegen die vorliegenden Projektunterlagen abgegrenzt: + +- `01_LUF_Zielbild_und_Fachkonzept_v1.1.md` (fortgeschrieben 14.11.2026), insbesondere `VIS-004`, `WEB-001` bis `WEB-005`, `PROD-001` bis `PROD-008`, `LIC-001` bis `LIC-003`, `VER-001` bis `VER-010`. +- `trainingskonzept-und-produktstruktur.md`, insbesondere §§4–9 zur Begrifflichkeit, flexiblen Trainingsstruktur und Vermarktung. +- `produktkonfiguration-und-mitgliederbereich.md` (15.11.2026), insbesondere §§1–2, 6–7, 12–14. +- `03_LUF_Pruefszenarien_v1.1.md`, insbesondere SC-01 bis SC-11 und SC-16 bis SC-20. +- `abschlussbericht-mvp-2026-11-16.md`, insbesondere implementierte Pakete und zurückgestellte Funktionen. +- Fachliche Diskussion vom 16.11.2026 zu Übung, Modul, Programm, Trainingsplan, kostenfreier Demo und Schutz des eigenen Methoden-Know-hows. Die neuen Aussagen sind **als solche** gekennzeichnet und nicht nachträglich den alten Dokumenten zugeschrieben. + +**Dokumentenpflege:** Dieses Papier kann später als Entscheidungs- und Ideenbasis in `docs/fachkonzept/` oder `docs/strategie/` des Repositories übernommen werden. Es ist gegenwärtig ausschließlich eine separate Notiz und wurde nicht im Repository eingepflegt. diff --git a/docs/fachkonzept/abgleich-produktkonfiguration-und-mitgliederbereich.md b/docs/fachkonzept/abgleich-produktkonfiguration-und-mitgliederbereich.md new file mode 100644 index 0000000..84c534c --- /dev/null +++ b/docs/fachkonzept/abgleich-produktkonfiguration-und-mitgliederbereich.md @@ -0,0 +1,70 @@ +# Lara & Felix – Architekturabgleich Produktkonfiguration und Mitgliederbereich + +**Stand:** 15.11.2026 +**Status:** Gezielter Abgleich der vorhandenen *fachlichen und konzeptionellen Dokumente*. **Keine** Codeprüfung und kein E2E-Test. + +## 1. Geprüfte Ausgangsdokumente + +- `01_LUF_Zielbild_und_Fachkonzept_v1.1.md`, insbesondere PROD-001 bis PROD-008 und LIC-001 bis LIC-007 +- `04_Domaenenmodell(2).md`, insbesondere §§1–5 +- `05_Lizenz_und_Berechtigungslogik(2).md`, insbesondere §§1–4 +- `08_Medien_Streaming_Kennzeichnung.md`, §§1 und 3 +- `09_CMS_Administration_Community(2).md`, A.3–A.5 +- `16_MVP_Slice(1).md`, §§2–3 +- `trainingskonzept-und-produktstruktur.md`, §§4–10 +- `design-prinzipien.md`, insbesondere UX/Player + +Die frühere mündlich zusammengefasste Code-Audit-Sichtung reicht nicht aus, um aktuelle Repository-Dateien zu verifizieren. Aus diesem Bericht folgt keine Aussage, dass eine Änderung bereits implementiert wurde. + +## 2. Konkrete Abweichungen + +| ID | Befund | Quelle und Fundstelle | Erforderliche Anpassung | +|---|---|---|---| +| **A01 – Konflikt** | Artikel-Titel, Kurzbeschreibung, Zielgruppe und Lernziele sind in der bisherigen Zuordnung pauschal am Artikel-Stand verortet; redaktionelle Änderung wird mit Artikel-Veröffentlichung gekoppelt. | `09`, A.4 „Wo liegt welcher Text?“ | Redaktionelle **Anzeige- und Suchdaten** an stabilen fachlichen Identitäten führen und ohne neuen Inhaltsrelease aktualisieren. **Lehrinhalt und Lernzieltexte** weiterhin fachlich versionieren. Vertragsrelevante Daten und Kaufkopie fixiert lassen. | +| **A02 – Erweiterung** | `ASSET_VERSION.metadaten` umfasst heterogene Beispiele (Dauer, Sprungmarken, Lernziele). Konfigurierbare Dimensionen und direkte Zuordnung zu Programmen/Modulen sind in der Modellskizze nicht ausreichend ausgedrückt. | `04`, §2 | Feldverantwortung trennen: aktuelle redaktionelle Metadaten, fassungsspezifische technische Daten und didaktische Inhaltsdaten. Konfigurierbare Dimensionen mit direkter Zuordnung zu Assets **und** Kompositionen vorsehen. | +| **A03 – Erweiterung** | Vorschaubilder entstehen grundsätzlich als Medienableitung, aber gezielte Videoframe-Auswahl, eigenständige Pflege aller fachlichen Objektarten und öffentliche Freigabe sind nicht ausformuliert. | `08`, §1 | Frame-Auswahl mit Filmvorschau und Zeitposition, Upload/Override, Bildformate, Alt-Text und öffentliche/geschützte Sichtbarkeit ergänzen; ohne Filmneuversion. | +| **A04 – Konflikt zur neuen Priorisierung** | MVP-Bibliothek wird vornehmlich als „Materialien je Lizenzartikel“ beschrieben. | `16`, §3.1 Bibliothek | Zugängliche **fachliche Bibliothek** mit Programmen, Modulen, Einzelmaterialien, Suche und konfigurierbaren Filtern zum MVP-Pflichtumfang machen. Lizenzartikel im Backend für Berechtigungen beibehalten. | +| **A05 – Präzisierung** | Bestehende Regeln zu Wiederverwendung und „nicht mehrfach in der Bibliothek“ sind zu allgemein. | `trainingskonzept-und-produktstruktur.md`, §§5 und 9; `04`, §2 | Mehrfaches Vorkommen innerhalb **jedes** Programms ausdrücklich fordern. Deduplizierung nur übergreifend für dieselbe stabile Einzelidentität; unterschiedliche Fassungen korrekt kenntlich machen. | +| **A06 – Prioritätskonflikt** | Automatische Denkpause, Sprungmarkensteuerung und weitergehender Player erscheinen im ursprünglichen MVP-Schnitt bzw. Medienzielbild als früh verfügbare Funktionen. | `08`, §3.3; `16`, §§2–3; `design-prinzipien.md` | Einfache geschützte Medienwiedergabe P0; spezialisierter Kursplayer mit automatischer Denkpause, didaktischer Ablaufsteuerung und Präsentationsmodus **Add-on**. Felder für künftige Zeitmarken dürfen bestehen bleiben. | +| **A07 – Funktionslücke** | CMS-Artikelkarten und Katalogbausteine existieren konzeptionell; vollständige Modul-/Programmdetails mit verschachtelter Struktur, Kontextrollen und partiellen Zugriffen sind nicht hinreichend konkret. | `09`, A.3; `trainingskonzept`, §§6/9 | Verschachtelte Detailansichten, Modulrollen, Rechtezustände und klare fachliche Typen spezifizieren und E2E prüfen; PDF nicht als „Kurs“ darstellen. | +| **A08 – Bedienlücke** | Der Kompositions-/Angebotszusammenhang kennt die Abdeckungsprüfung und „Paket aus Komposition vorschlagen“, aber der redaktionelle Gesamtablauf ist nicht ausreichend prüfbar. | `04`, §3.1 | Geführte Bearbeitung von Asset → Komposition → Artikel/Bundle → Offer; getrennte Vorschau von Mitgliederdarstellung, didaktischem Inhalt und lizenziertem Angebotsumfang. | +| **A09 – Abgrenzung** | CMS-Seiten brauchen Revision und Publikationsprozess; neue redaktionelle Inhaltsstammdaten sollen unmittelbar wirksam werden. | `09`, A.5; neue Fachspezifikation §4 | Beide Prozesse getrennt halten: CMS-Entwurf/Veröffentlichung beibehalten; reine Inhaltsstammdaten speichern + Audit, ohne Asset-/Artikel-Release. | +| **A10 – Beibehalten** | Veröffentlichung fixiert konkrete Fassungen, Rechte werden quellengebunden je Aktion geprüft, Angebotsfassungen bleiben unveränderlich. | `04`, §§2–5; `05`, §§1–4 | **Kein Rückbau.** Neue redaktionelle Stammdaten dürfen niemals die `ARTICLE_RELEASE`-/`RELEASE_CONTENT`-/`ORDER_SCOPE_ITEM`-Historie oder serverseitige Zugriffsentscheidung umgehen. | +| **A11 – Prüfung weiterer Dokumente** | Die P0-/Add-on-Grenze könnte auch in Versions-, Test- und Roadmap-Dokumenten referenziert werden. | Querverweise aus `04`, `08`, `16` auf `06`, `03`, `15` | Vor Implementierungsauftrag die einschlägigen Abschnitte dieser Dokumente zusätzlich gezielt lesen und nur tatsächliche Widersprüche ändern. Für sie wird hier **keine vollständige Prüfung behauptet**. | + +## 3. Reihenfolge der Dokumentanpassungen + +1. **`04_Domaenenmodell(2).md`:** Redaktionsstammdaten, Facetten und Thumbnail-Beziehungen im konzeptionellen Modell präzisieren. Freigabe-/Rechteinvarianten unverändert. +2. **`09_CMS_Administration_Community(2).md`:** Herkunft und Publikationsregeln für aktuelle redaktionelle Titel/Beschreibungen/Thumbnails von versionierten fachlichen Lernzielen und verbindlichen Angebots-/Bestelltexten trennen. +3. **`08_Medien_Streaming_Kennzeichnung.md`:** Video-Frame als Thumbnail und seine Zugriffsklasse ergänzen; didaktische Playerfunktionen als Add-on kennzeichnen, normale Wiedergabe erhalten. +4. **`16_MVP_Slice(1).md`:** Mitgliederbibliothek als eigenständig nutzbares P0-Produkt mit Suche/Filtern, Modul-/Programmansichten, korrekter Mehrfachverwendung und einfachen Medienaktionen beschreiben. +5. **`trainingskonzept-und-produktstruktur.md`:** Deduplizierungsregel kontextbezogen präzisieren und technische Player-Priorität aktualisieren; pädagogische Methode nicht ändern. +6. **`design-prinzipien.md`:** Terminologie und zeitliche Priorisierung des optionalen Players angleichen; die verbindlichen qualitativen UX-Anforderungen beibehalten. +7. **Weitere Referenzdokumente:** `06` Veröffentlichung, `03` Tests und Roadmap `15` auf dieselben Widersprüche prüfen, bevor ein verbindlicher Entwicklungsauftrag formuliert wird. + +## 4. Unverzichtbare Architekturgrenzen + +- **„Metadaten ohne Versionierung“ bedeutet keine Überschreibung des Lehrinhalts.** Ändert sich die Filmdatei, Übungsanleitung oder die Mitgliedschaft/Reihenfolge einer Komposition, wird weiterhin neu versioniert. +- **Deduplizierung der Einzelbibliothek bedeutet nicht Auslassung im Programm.** Programm A und B zeigen beide dieselbe ihnen zugeordnete Datei; die Materialübersicht zeigt eine stabile Einzelidentität. +- **Vollständig nutzbares Programm bedeutet nicht Programmkauf.** Es können mehrere getrennte, kompatible Berechtigungen sämtliche Bestandteile abdecken; die Kaufhistorie bleibt korrekt. +- **Direkte Säulen am Programm sind keine automatisch aggregierten Film-Tags.** Beide Informationen bleiben unterscheidbar. +- **Thumbnail aus Film ist kein öffentlicher Film- oder Bildfreigabeautomatismus.** +- **Kursplayer als Add-on entbindet nicht von sicherem Streaming und einem üblichen Player.** +- **Preise und Rechte sind keine frei veränderlichen CMS-Texte.** Der Bestell-/Vertragssnapshot darf nicht indirekt überschrieben werden. +- **Einzelne Berechtigungen dürfen nicht zu stärkeren Gesamtberechtigungen kombiniert werden.** + +## 5. Erforderliche lesende Codeprüfung vor Umsetzung + +Vor Codeänderungen soll der Coding-Agent Folgendes am tatsächlichen Repository nachweisen: + +- Modell-/Tabellenverantwortung für Titel, Beschreibungen, Thumbnails, Säulen und fassungsspezifische Daten. +- Direkte Zuordnung von Fachdimensionen zu Asset **und** Komposition; Herkunft abgeleiteter Facetten. +- Reale Kompositionsauflösung bis zu beliebigen Unterebenen, mit Kontextrolle und Reihenfolge. +- Zwei Programme mit gemeinsamem Film und PDF; Deduplizierung in der Einzelbibliothek, nicht innerhalb der Programme. +- Rechteprüfung für Stream, Browser-Dokumentanzeige und Download an echten Dateien statt nur UI-Buttons. +- Medienablage/Thumbnail-Ableitungsprozess und öffentliche/geschützte Sichtbarkeit. +- Aktuelle Publikationsgates für reine redaktionelle Änderungen. +- Tatsächliche Funktionen und Kosten des bisherigen Players, damit nur die didaktischen Add-ons zurückgestellt werden. +- E2E-Tests für komplexe Programme, partielle Rechte und historische Fassungen; keine Scheintests durch reines Überschriftenrendering. + +**Ergebnis dieses Dokuments:** Fachliche Soll-Abweichungen sind benannt. Der technische Änderungsumfang und konkrete Migrationen können erst nach dieser lesenden Bestandserhebung seriös festgelegt werden. diff --git a/docs/fachkonzept/produktkonfiguration-und-mitgliederbereich.md b/docs/fachkonzept/produktkonfiguration-und-mitgliederbereich.md new file mode 100644 index 0000000..a6b91e2 --- /dev/null +++ b/docs/fachkonzept/produktkonfiguration-und-mitgliederbereich.md @@ -0,0 +1,218 @@ +# Lara & Felix – Produktkonfiguration und Mitgliederbereich + +**Stand:** 15.11.2026 +**Status:** Konsolidierte fachliche Soll-Spezifikation; vor Implementierung mit bestehender Architektur abzugleichen +**Zielpfad:** `docs/fachkonzept/produktkonfiguration-und-mitgliederbereich.md` + +## 1. Zielbild und Priorität + +Die Plattform „Lara & Felix – Stark im Alltag“ unterstützt erwachsene Trainer und pädagogische Fachkräfte beim Auffinden, Vorbereiten und Verwenden von didaktischen Trainingsmaterialien. Fachliche Struktur, technische Medien und kommerzieller Lizenzumfang sind unabhängig voneinander zu verwalten. + +**MVP-Pflicht ist eine professionelle, vollständig nutzbare Mitgliederbibliothek.** Programme, Module, Übungen, Filme, Traineranleitungen, Merkblätter und sonstige Materialien müssen durchsuchbar, filterbar, fachlich unterscheidbar und innerhalb ihrer jeweiligen Zusammenhänge nutzbar sein. Eine flache Liste von Lizenzartikeln oder Dateinamen ist kein gleichwertiger Ersatz. + +**P0/MVP:** konfigurierbare Fachdimensionen; fachliche Stammdaten; Thumbnails; Einbindung wiederverwendbarer Materialien in Modulen und Programmen; konfigurierbare Lizenzartikel/Pakete/Angebotsvarianten mit Preisen; Mitgliederbibliothek; Suche/Filter; Modul-/Programmdetails; berechtigtes Dokumentansehen und -laden; einfaches geschütztes Videostreaming; Redaktionsvorschau und Auditierung. + +**Späteres Add-on:** spezialisierter Kursplayer mit automatischer Denkpause, vorgegebener Ablaufsteuerung, Präsentations-/Trainermodus, Fortschrittsverfolgung oder synchronisiertem Zweitgerät. Übliche Videofunktionen wie Abspielen, Pause, Zeitsuche und Vollbild bleiben Bestandteil des MVP. Eine didaktische Denkpause ist als **Methode** weiterhin relevant, aber nicht als zwingende automatische Playerfunktion. + +## 2. Fachliches Objektmodell + +| Ebene | Objekt | Fachliche Aufgabe | +|---|---|---| +| Inhalt | Asset/Inhaltselement | Stabile Identität von Film, PDF, Audio, Text, Aufgabe usw. | +| Versionierter Inhalt | Asset-Version | Konkrete unveränderliche Datei bzw. Lehrinhaltsfassung | +| Didaktik | Komposition | Stabile Identität einer Übung, eines Moduls, Programms oder einer anderen frei definierten Zusammenstellung | +| Didaktische Fassung | Kompositionsversion | Geordnete Verweise auf konkrete Fassungen anderer Inhalte und Kompositionen; Rolle je Verwendung | +| Redaktion | Fachdimensionen und Stammdaten | Beschreibung, Auffindbarkeit und visuelle Darstellung stabiler Identitäten | +| Lizenzierung | Lizenzartikel / Artikel-Stand | Vom Betreiber festgelegte kleinste Lizenzierungseinheit / freigegebener, fixierter Leistungsstand | +| Kommerzielles Angebot | Paket, Angebot, Angebotsfassung, Rechteprofil | Artikelumfang, Preise, Laufzeiten, Nutzungsrechte, Bedingungen | +| Berechtigung | Erwerb und Grant | Individuelle Rechtequelle, zugehöriger Artikel und wirksame Aktionen | + +**Es gibt keine technische Pflicht-Hierarchie** „Film → Übung → Modul → Programm → Paket“. Ein einzelner Film kann eigenständig lizenziert sein, ein Modul eine kommerziell unteilbare Einheit bilden, oder mehrere Module können als getrennte Lizenzartikel in einem Programmangebot verkauft werden. Die Artikelgrenze wird ausdrücklich vom Betreiber definiert. Der Preis gehört zur **Angebotsfassung**, nicht zum Inhalt oder Themenbereich. + +Wiederverwendung bedeutet Verlinkung derselben stabilen Identität und gegebenenfalls derselben fachlichen Fassung, **nicht** das Anlegen neuer Medienkopien. Zirkuläre Kompositionen und Pakete sind auszuschließen. Veröffentlichte Fassungen und die aufgelösten Inhalte eines Artikel-Stands bleiben unveränderlich. + +## 3. Konfigurierbare, mehrdimensionale Fachklassifikation + +Der Betreiber kann Fachdimensionen und ihre Werte ohne Programmierung pflegen: stabile Kennung, Name, Beschreibung, Aktivierung/Archivierung, Reihenfolge, zugelassene Objekttypen, Einfach- oder Mehrfachauswahl und Verwendung als Suchfilter. Das Umbenennen eines Werts ändert nicht seine Identität. Ein noch verwendeter Wert darf nicht folgenlos gelöscht werden. + +Initiale Dimensionen: **fachliche Säulen/Themenbereiche**, Altersbereich/Zielgruppe, fachliche Inhaltsart (z. B. Film, Merkblatt, Traineranleitung, Übung, Modul, Programm), Einsatzbereich und Schlagwörter. Erweiterungen müssen ohne Codeänderung möglich sein. Die fünf gegenwärtigen Säulen sind konfigurierbare Startwerte, keine fünf technisch fest codierten Verkaufssparten: + +1. Meine Grenzen – Ich darf Nein sagen +2. Sicher handeln im Alltag +3. Geheimnisse, Vertrauen und Hilfe holen +4. Freundschaft, Selbstbehauptung und Zivilcourage +5. Streit, Bedrängung und Konflikte bewältigen + +**Zuordnung muss an Assets, Übungen, Modulen und Programmen unmittelbar möglich sein.** Eine Zuordnung nur auf Medienebene genügt nicht. Direkte redaktionelle Zuordnungen und für die Suche aus enthaltenen Elementen abgeleitete Zuordnungen sind voneinander unterscheidbar. Eine Ableitung ersetzt die direkten Tags nicht. Fachdimensionen erzeugen **niemals** Zugriffsrechte. + +Die Rolle eines Mediums innerhalb eines Moduls (z. B. „Gesprächseinstieg“ oder „Reflexionsbeispiel“) ist Eigenschaft seiner **konkreten Verwendung in der Komposition**, nicht ein globales Attribut des Mediums. Dasselbe Video darf in unterschiedlichen Modulen verschiedene Rollen haben. + +## 4. Redaktionelle Stammdaten ohne unnötige Inhaltsversionen + +Die Daten werden in drei strikt getrennte Klassen aufgeteilt: + +| Klasse | Beispiele | Änderungsregel | +|---|---|---| +| **A – Aktuelle Anzeigedaten** | Anzeige-Titel, Kurzbeschreibung, redaktionelle Beschreibung, Thumbnail und Alternativtext, Säulen, Tags, informative Alterszuordnung, Suchattribute | Direkt speichern und sofort aktualisieren; **kein** neuer Asset-, Kompositions- oder Artikel-Release; nachvollziehbares Änderungsprotokoll | +| **B – Fachlicher Lehrinhalt** | Film-/Dokumentdatei, eigentliche Übungsanweisung, didaktische Lernzieltexte, Unterrichtsfragen, verbindliche Kompositionsmitglieder, Reihenfolge, kontextuelle Rollen, fassungsgebundene Zeitmarken | Neue Inhalts- oder Kompositionsfassung mit vorhandener Prüfung und Veröffentlichung | +| **C – Kommerziell/verbindlich** | Preis, Rechteprofil, Vertrags-/Angebotsversprechen, Laufzeit, Bedingungen, aufgelöster Kaufumfang, Bestellbezeichnung | Neue Angebotsfassung; frühere Angebots- und Bestell-Snapshots bleiben fixiert | + +Insbesondere muss die Verwaltung **freie Beschreibungsfelder** von **normativen Lehranweisungen** unterscheiden. Eine Änderung der Kurzbeschreibung ist Klasse A, eine neue fachliche Anweisung Klasse B. Eine korrigierte allgemeine Altersempfehlung kann A sein; eine Änderung, die ein verbindliches Leistungsversprechen berührt, erfordert zusätzlich Klasse C. Der zuständige Datenbereich muss für die Redaktion erkennbar sein. + +Das Ändern eines gegenwärtigen Anzeigetitels darf **nicht** einen historischen Kauf, Rechnungs- oder Ausgabenachweis rückwirkend umbenennen. Auditinformationen für Klasse A enthalten Bearbeiter, Zeit und Änderung; UI-Caches und Suchindizes sind zu aktualisieren. Das eigenständige Entwurfs-/Publikationsmodell für CMS-Seiten bleibt davon unberührt. + +## 5. Thumbnails für alle darstellbaren Inhalte + +Jedes Asset, jede Übung, jedes Modul und jedes Programm kann ein **eigenes Vorschaubild** erhalten. Falls ein eigenständiger Lizenzartikel redaktionell anders präsentiert werden muss, kann auch dieser eine geeignete Bildzuordnung besitzen. Bei fehlender Zuordnung wird eine neutrale, passende Fallback-Grafik verwendet. + +**Bearbeitungsoptionen:** +- Eigenes Bild hochladen bzw. vorhandenes geeignetes Bild wählen. +- Bei Videos: konkrete Filmfassung öffnen, gewünschten Zeitpunkt visuell auswählen, Frame extrahieren und als Thumbnail übernehmen. Zeitposition und Vorschau müssen zusammenpassen. +- Bei Kompositionen: optional ein Bild aus enthaltenen Medien als Vorschlag übernehmen; eine explizit gesetzte Bildwahl hat Vorrang. +- Alternativtext pflegen; Vorschaubild in echten Kartenformaten prüfen; optimierte Größen erzeugen. + +Thumbnails sind eigenständige redaktionelle Bildableitungen und können ohne neue Film-/Inhaltsfassung geändert werden. Der Originalfilm und seine Prüfsumme bleiben unverändert. Bildverarbeitungsfehler führen zu einem erklärten Fehlerzustand und einem Fallback statt zu einer kaputten Karte. + +**Öffentliche Sichtbarkeit ist gesondert zu regeln:** Ein aus einem geschützten Film extrahierter Frame ist nicht automatisch als frei sichtbares Marketingbild freigegeben. Interne und öffentliche Vorschaubildverwendungen sind zu unterscheiden. + +## 6. Fachliche Module und Programme + +### Module + +Ein Modul ist eine eigenständig verwendbare didaktische Einheit mit eigenen Stammdaten und optional Lernzielen, Vorbereitung, Materialbedarf, Zeitbedarf sowie zusammengehörenden Materialien. Es kann Film, Text, Übung, Traineranleitung, Reflexion und Merkblatt enthalten, muss aber **keinen** bestimmten Typ enthalten. Die veröffentlichten Mitglieder und ihre konkrete Reihenfolge werden in einer Kompositionsfassung fixiert. + +### Programme + +Ein Programm besitzt eigene Metadaten, ein übergeordnetes Trainingsziel und eine strukturierte Zusammenstellung von Modulen, Unterkompositionen und gegebenenfalls programmspezifischen Materialien. Es kann mehrere Säulen umfassen und dieselben Module wie andere Programme nutzen. Reihenfolge und fachliche Mitgliedschaft sind versioniert; rein beschreibende Stammdaten nicht. + +### Verbindliche Regel zur Mehrfachverwendung + +**Ein Inhalt, der zu mehreren Programmen eines Nutzers gehört, wird innerhalb *jedes* dieser Programme und an seiner dort definierten Position angezeigt.** Dies gilt gleichermaßen für Filme, Merkblätter, Übungen und komplette Module. Die Anzeige in einem Programm darf nicht verschwinden, weil derselbe Inhalt bereits an anderer Stelle verwendet wird. + +**Nur in programmübergreifenden Einzelinhaltslisten** wird derselbe fachliche Inhalt nach **stabiler Identität** dedupliziert: ein Merkblatt, das in drei Programmen vorkommt, hat dort eine eigene Karte, innerhalb der drei Programme aber drei kontextuelle Vorkommen. Gleichlautende Titel unterschiedlicher Identitäten bleiben getrennt. Bei verschiedenen historischen Fassungen derselben Identität darf die Darstellung deren Unterschiede nicht verschweigen; die Verwendungsstellen behalten die jeweils referenzierte Fassung. + +„Verwendet in“ zeigt rückwärts die betroffenen Module und Programme. Mehrfache Anzeige begründet weder weitere Käufe noch neue Berechtigungen. + +## 7. Konfigurierbare kommerzielle Produkte + +Der Betreiber kann ohne Programmierung lizenzierbare Einheiten bilden aus einzelnen Medien, Texten, Übungen, Modulen oder ganzen Programmen; ein Programm kann alternativ durch mehrere separate Artikel gedeckt sein. Aus Artikeln und verschachtelten Paketen werden Angebote mit unterschiedlichen Rechteprofilen, Preisen und Laufzeiten gebildet. + +Ein Angebot muss vor Aktivierung prüfen, ob die beworbene fachliche Zusammenstellung tatsächlich durch die enthaltenen Lizenzartikel abgedeckt ist. Ausschlüsse werden ausdrücklich kenntlich gemacht. Die Rechteprofile unterscheiden Nutzungszweck und technische Aktionen **je Ausgabeklasse**; zum Beispiel darf ein Film nur streambar sein, während ein zugehöriges PDF angesehen und geladen werden darf. + +**Eine Berechtigung wird nicht aus mehreren unvollständigen Grants zu einem neuen Tarif zusammengesetzt.** Kommerzielles Streaming und nichtkommerzieller Download ergeben keinen kommerziellen Download. Berechtigungen aus verschiedenen Erwerbsquellen bleiben unabhängig; die Bibliothek kann sie verständlich zusammenfassen, aber ihre Rechte nicht neu kombinieren. + +**Referenzfälle ohne Preis- oder Tarifentscheidung:** kostenloses Merkblatt; Einzelmodul als ein Artikel; Programm als ein Artikel; Programm als Paket eigenständiger Module; themenübergreifendes Paket; mehrere Lizenzangebote mit unterschiedlich erlaubten Medienaktionen für denselben Artikel. + +Individuelle **betreiberseitige** Pakete müssen modellierbar sein. Kundenseitige freie Paketkonfiguratoren und persönlich gespeicherte Kurssammlungen sind noch nicht als MVP entschieden. + +## 8. Mitgliederbibliothek: allgemeine Anforderungen + +Die Benutzeroberfläche richtet sich an Trainer, nicht an Katalogadministratoren. Fachlicher Typ und **technisches Dateiformat** bleiben unterscheidbar: Eine Übungsbeschreibung kann als PDF oder Text vorliegen, bleibt fachlich aber eine Übung. Ein PDF wird nicht aufgrund seiner Lizenzierbarkeit als „Kurs“ etikettiert. + +**Vorgeschlagene Nutzersichten:** Meine Bibliothek (zentrale Suche), Programme, Module, Materialien, Meine Lizenzen sowie gegebenenfalls Entdecken. Die genauen Menünamen sind UX-Entwurfsdetails; verbindlich sind die Funktionen und die Trennung von fachlicher Navigation und Lizenzübersicht. + +### Suche und Filter + +- Suche über Titel, Kurzbeschreibung, Schlagwörter und geeignete Suchattribute. +- Kombinierbare Filter nach fachlichem Typ, Säulen, Altersbereich, Einsatzbereich, weiteren aktivierten Dimensionen und tatsächlicher Verfügbarkeit. +- Filterkonfiguration und Werte stammen aus Betreiber-Fachdimensionen; keine Festcodierung der fünf Säulen. +- Ein Programm muss über direkt gepflegte Themen **und** passend abgeleitete Themen seiner enthaltenen Module auffindbar sein; Herkunft intern nachvollziehbar. +- Übergreifende Suchergebnisse deduplizieren stabile Identitäten, nicht bloß Dateinamen oder Titel. +- Standardkombination: ODER bei mehreren Werten derselben Dimension, UND zwischen verschiedenen Dimensionen; bei UX-Abnahme testen. +- Leere Ergebnisse, Berechtigungsfehler, Ladefehler, mobile Filter und Zurücksetzen sind fachlich vorgesehen. + +### Karten + +Eine Karte enthält Thumbnail/Platzhalter, fachlichen Typ, Titel, kurze Beschreibung, gegebenenfalls Altersbereich/Themen und einen wahrheitsgemäßen Verfügbarkeitsstatus. Angebots-/Rechteangaben stammen aus dem dafür zuständigen Katalog, nicht aus frei getippten Kopien. + +### Status + +Unterscheide vollständig nutzbare, teilweise nutzbare, nicht nutzbare und gesperrte Inhalte. Nicht verfügbare Bestandteile dürfen im fachlichen Kontext erklärend sichtbar sein, ohne dass die geschützte Datei ausgeliefert wird. + +## 9. Moduldetail + +Ein Modul zeigt: + +1. **Kopf:** eigenes Thumbnail, Titel, Kurzbeschreibung, Alters-/Themenangaben und tatsächliche Verfügbarkeit. +2. **Überblick:** inhaltliche Beschreibung, Lernziele und ggf. Zeit- und Materialbedarf. +3. **Inhalte:** strukturierte, geordnete Kompositionsbestandteile mit Rolle, Fachtyp und vorhandenen Untergruppen. Verschachtelung darf nicht zu einer flachen Dateiliste zusammenfallen. +4. **Zusammenhänge:** Verwendung in anderen Modulen und Programmen. +5. **Aktionen:** je Film geschütztes Streaming; je Dokument berechtigtes Ansehen und/oder Laden; je Übung sinnvolle Anzeige. + +Die Darstellung soll dem Trainer das Verständnis der Trainingseinheit ermöglichen, ohne ihn in eine vorgegebene Player-Sequenz zu zwingen. + +## 10. Programmdetail + +Ein Programm zeigt eigene Metadaten und eine vollständige Struktur aller enthaltenen Module und programmspezifischen Materialien in redaktioneller Reihenfolge. Gemeinsame Materialien werden **in jedem betroffenen Programm** angezeigt. Eine Veränderung einer Programmansicht darf keine andere Programmreferenz entfernen. + +Der Status „**inhaltlich vollständig nutzbar**“ ist nicht gleichbedeutend mit „**als Programm gekauft**“. Ein Nutzer kann alle Bestandteile über separate Artikel und mehrere gültige Erwerbsquellen nutzen. Das tatsächliche Zugriffsrecht bleibt je angeforderter Aktion maßgeblich. + +Teilweise verfügbare Programme sind klar zu kennzeichnen und können getrennt von vollständig nutzbaren Programmen entdeckt werden. Die genaue Position dieser Ansicht in der Navigation kann anhand eines UX-Tests entschieden werden; unvollständige Programme dürfen nicht fälschlich als vollständig besessen erscheinen. + +## 11. Standard-Medienaktionen und Zugriff im MVP + +**Video:** Authentifizierte, berechtigte Wiedergabe im normalen Player (Play, Pause, Zeitsuche, Vollbild, Lautstärke, vorhandene Untertitel). Adaptive und geschützte Medienausgabe gemäß bestehendem Medienkonzept. **Keine** verpflichtende automatische Denkpause oder dedizierte Kursablaufsteuerung. + +**Dokumente:** Ansehen im Browser und Download sind getrennte Berechtigungsaktionen. Kennzeichnung und Ausgabenachweis bleiben erhalten, soweit das bestehende Rechte-/Medienmodell dies verlangt. + +**Sicherheit:** Vor jeder Auslieferung prüfen: Artikel, veröffentlichter Stand, darin enthaltene Inhaltsfassung, angeforderte Aktion, genau eine tragende Berechtigung. Keine Rechtevergabe durch Thumbnail, Filter, Kompositionszuordnung oder bloßes UI-Anzeigen. Originalmedien werden nicht direkt öffentlich geliefert. Signierte URLs dürfen die Berechtigungsentscheidung nicht ersetzen. + +**Geräte:** Desktop, Tablet und Smartphone. Eine installierbare PWA bedeutet keine automatische Berechtigung, geschützte Medien offline zu speichern. + +## 12. Redaktionsverwaltung und Arbeitsablauf + +Die Verwaltung bildet praktische Aufgaben ab, nicht nur Tabellen: **Inhalte**, **Module/Programme und Fachdimensionen**, **Lizenzartikel/Pakete/Angebote**, **Prüfung/Veröffentlichung**. + +1. **Medium anlegen:** Typ wählen, Film/PDF/Text hochladen bzw. erstellen, Verarbeitung und Fehlerstatus sehen. +2. **Stammdaten pflegen:** Titel, Beschreibungen, Säulen, weitere Dimensionen, Altersbereich und Thumbnail jederzeit ändern; Auditspur ohne Inhaltsrelease. +3. **Modul erstellen:** bestehende Assets und Unterkompositionen suchen, referenzieren, Rollen je Verwendung festlegen und Reihenfolge bestimmen. +4. **Programm erstellen:** bestehende Module und programmspezifische Inhalte wiederverwenden, eigene Metadaten pflegen, Struktur prüfen. +5. **Produkt konfigurieren:** Lizenzartikelgrenze ausdrücklich festlegen, Artikel/Pakete zusammenstellen, Rechteprofil, Preis und Laufzeit in einer Angebotsfassung bestimmen. +6. **Drei getrennte Vorschauen:** tatsächliche Mitgliederansicht, didaktische Kompositionsstruktur, kaufbarer Umfang samt Berechtigungen. +7. **Veröffentlichen:** fachlich neuen Stand nach bestehender Prüfung freigeben; eigenständige Angebotsfassung gesondert aktivieren. +8. **Nachbearbeiten:** Klasse-A-Stammdaten sofort wirksam; Klasse-B- und Klasse-C-Änderungen kontrolliert als neue Fassungen. + +„Verwendet in“ und „Versionen“ müssen in den Bearbeitungsmasken auffindbar sein. In der Mitgliederansicht werden keine administrativen Lizenzstrukturdetails als Ersatz für pädagogische Inhalte gezeigt. + +## 13. Abnahmefälle + +| ID | Prüffall | Erwartetes Ergebnis | +|---|---|---| +| B01 | Film hochladen | Als Film erfasst, nicht als Kurs oder bloßer Lizenzartikel dargestellt | +| B02 | Titel, Kurzbeschreibung, Thumbnail ändern | Direkt sichtbar, kein neuer Inhalts-/Artikel-Release; Änderung protokolliert | +| B03 | Videoframe als Thumbnail auswählen | Beliebige geeignete Zeitposition visuell wählbar; Film unverändert | +| B04 | Geschützten Filmframe auswählen | Keine implizite öffentliche Marketingfreigabe | +| B05 | Neue Fachsäule administrieren | An Asset, Modul und Programm zuweisbar und filterbar | +| B06 | Thema nur am Modul setzen | Modul selbst darüber auffindbar; kein Tag am Film erforderlich | +| B07 | Verschachtelte Komposition | Unterstrukturen, Rollen und Reihenfolge vollständig erhalten | +| B08 | Film in zwei Modulen | Ein Asset; unterschiedliche Kontextrollen möglich | +| B09 | Dasselbe Modul in Programm A und B | Modul wird **in beiden** Programmen angezeigt | +| B10 | Dasselbe PDF in Programm A und B | PDF wird **in beiden** Programmen angezeigt | +| B11 | Übergreifende Materialliste | PDF als **ein** Eintrag, mit Verweisen auf A und B | +| B12 | Gleicher Titel, andere Identität | Keine falsche Deduplizierung | +| B13 | Verschiedene historische Fassungen eines Assets | Je Programm richtige Fassung; keine stille Versionsmischung | +| B14 | Nur einzelne Module lizenziert | Programm als teilweise nutzbar kenntlich; geschützte Teile bleiben gesperrt | +| B15 | Alle Programmteile über separate Artikel lizenziert | Inhalte vollständig nutzbar, ohne fingierten Programmkauf | +| B16 | Film streambar, nicht downloadbar | Stream funktioniert; Download serverseitig verweigert | +| B17 | Grants mit abweichenden Nutzungszwecken | Keine künstlich kombinierten Rechte | +| B18 | Kompositionsreihenfolge ändern | Neue Kompositionsfassung; früherer Stand unverändert | +| B19 | Filmdatei austauschen | Neue Asset-Fassung, ursprüngliche Datei und Referenzen erhalten | +| B20 | Angebots-Preis oder -Rechte ändern | Neue Angebotsfassung; alter Erwerb historisch korrekt | +| B21 | PDF-Ansehen und PDF-Download | Je Aktion getrennt und serverseitig korrekt entschieden | +| B22 | Responsive Bibliothek | Desktop, Tablet, Smartphone mit funktionsfähiger Suche und Filtern | +| B23 | Programm-/Modulvorschau im Editor | Dieselbe fachliche Struktur wie später bei Mitgliedern | +| B24 | Redaktionelle Änderung nach Kauf | Neue Anzeige sichtbar; Vertrags-/Bestell-Snapshot unverändert | + +Erforderlich sind reale Ende-zu-Ende-Tests mit zwei Programmen, gemeinsam genutzten Inhalten, mehreren Erwerbsquellen und tatsächlichen Medienaktionen. Ein Screenshot und ein Test auf die Überschrift „Kurs“ sind keine hinreichende Abnahme. + +## 14. Abgestimmte Regeln und noch offene Optionen + +**Verbindlich abgestimmt:** Zentrale Mitgliederbibliothek vor spezialisiertem Kursplayer; frei konfigurierbare Fachdimensionen auch für Kompositionen; Beschreibung, Thumbnail und reine Such-/Anzeigedaten ohne neuen fachlichen Release; gewünschter Videoframe als Thumbnail; vollständige Wiederholung aller Verwendungen innerhalb **jedes** Programms und Deduplizierung **nur** in übergreifenden Einzelinhaltslisten; einfache Streaming-/Dokumentfunktionen; getrennte didaktische und kommerzielle Struktur; historische Versions- und Lizenzintegrität. + +**Nicht stillschweigend für das MVP entscheiden:** von Kunden selbst konfigurierbare Pakete; gespeicherte persönliche Kursabläufe; automatische Denkpausen-/Präsentationssteuerung; geräteübergreifende Synchronisation; konkrete Tarife, Preise und Honorargrenzen; genaue Navigationsposition teilweise verfügbarer Programme; Frage, ob spezifische Altersvarianten eigene Produkte oder Versionen sind. + +## 15. Quellenbasis und Architekturabgleich + +Diese fachliche Fassung baut auf folgenden Projektquellen auf: `trainingskonzept-und-produktstruktur.md`, `01_LUF_Zielbild_und_Fachkonzept_v1.1.md`, `04_Domaenenmodell(2).md`, `05_Lizenz_und_Berechtigungslogik(2).md`, `08_Medien_Streaming_Kennzeichnung.md`, `09_CMS_Administration_Community(2).md`, `16_MVP_Slice(1).md` und `design-prinzipien.md`. + +Die dazu notwendigen **gezielten** Anpassungen sind in `docs/architektur/abgleich-produktkonfiguration-und-mitgliederbereich.md` dokumentiert. Bestehende Sicherheits-, Berechtigungs- und Veröffentlichungsinvarianten bleiben gültig, soweit nicht ausdrücklich und fachlich begründet angepasst. Diese Spezifikation ist **noch kein Auftrag zur ungeprüften Codeumsetzung**. diff --git a/docs/fachkonzept/trainingskonzept-und-produktstruktur.md b/docs/fachkonzept/trainingskonzept-und-produktstruktur.md new file mode 100644 index 0000000..d6fefcc --- /dev/null +++ b/docs/fachkonzept/trainingskonzept-und-produktstruktur.md @@ -0,0 +1,246 @@ +# Lara & Felix – Trainingskonzept und fachliche Produktstruktur + +**Geltungsbereich:** Pädagogisches Gesamtkonzept, Themenbereiche, Lernziele, Übungen, Filme, Module, Programme sowie deren fachliche und kommerzielle Darstellung. + +## 1. Positionierung und Zweck + +**„Lara & Felix – Stark im Alltag“ ist ein strukturiertes Konzept für Gewaltprävention, Selbstbehauptung und die Förderung sicherer Handlungsentscheidungen bei Kindern.** Es unterstützt erwachsene Trainer und pädagogische Fachkräfte bei der Durchführung von Gruppen- und Präsenzkursen. + +Im Mittelpunkt stehen **praktische Übungen und angeleitete Lernprozesse**. Alltagsszenen in Filmen helfen beim Einstieg, bei der Reflexion und bei der Besprechung von Handlungsalternativen. Traineranleitungen, Merkzettel, Arbeitsblätter und weitere Materialien unterstützen die Durchführung. + +Die gegenwärtige Film- und Materialreihe richtet sich insbesondere an Kinder im Alter von ungefähr sechs bis sieben Jahren. Die Plattform darf grundsätzlich auch altersdifferenzierte Programme und andere Produktlinien unterstützen. + +Die Öffentlichkeit soll Lara & Felix als **Gesamtkonzept mit Programmen und Modulen** wahrnehmen – nicht als Shop für isolierte Einzelfilme. Das schließt eine fachlich begründete Einzellizenzierung geeigneter Materialien nicht aus. + +### Leitgedanke + +**Geschichten zum Mitdenken und Mitmachen: Alltagssituationen verstehen, Handlungsmöglichkeiten besprechen und praktisch erproben.** + +Das Konzept vermittelt Handlungsmöglichkeiten; es behauptet keine garantierte Verhinderung von Gewalt oder einen automatisch eintretenden Lernerfolg. + +## 2. Die fünf wesentlichen Themenbereiche + +Die fünf Bereiche bilden die gegenwärtige fachliche Klammer des Lara-&-Felix-Konzepts. Sie sind **keine fünf zwangsläufig getrennten Produkte oder Lizenzpakete**. + +### 2.1 Meine Grenzen – Ich darf Nein sagen + +**Lernschwerpunkt:** Eigene Grenzen wahrnehmen und ausdrücken; Grenzen anderer erkennen und respektieren. + +**Beispiele praktischer Übungen:** + +- Sicherer Stand und selbstbewusste Körperhaltung. +- Stimme bewusst einsetzen. +- Deutlich „Stopp“ beziehungsweise „Nein“ sagen. +- Persönliche Distanz wahrnehmen. +- Grenzen anderer respektieren. + +**Ergänzende Filmbeispiele:** „Lara im Park“, „Felix bei Oma“. + +### 2.2 Sicher handeln im Alltag + +**Lernschwerpunkt:** Situationen aufmerksam wahrnehmen, angemessenen Abstand halten und sichere Entscheidungen im Alltag besprechen und üben. + +**Beispiele praktischer Übungen:** + +- Umgebung und Veränderungen wahrnehmen. +- Abstand halten und persönliche Sicherheit berücksichtigen. +- Verschiedene Handlungsoptionen vergleichen. +- Verhalten an der Haustür praktisch erproben. +- Telefonsituationen nachspielen. + +**Ergänzende Filmbeispiele beziehungsweise Situationen:** „Lara und Mia“, „Autofahrer“, „Einkäufe“, „Postbote“, „Telefon“. + +### 2.3 Geheimnisse, Vertrauen und Hilfe holen + +**Lernschwerpunkt:** Vertrauenspersonen erkennen, über belastende Situationen sprechen und Unterstützung holen. + +**Beispiele praktischer Übungen:** + +- Vertrauenspersonen im eigenen Umfeld benennen. +- Hilfe ansprechen und um Unterstützung bitten. +- Gute Überraschungen und belastende Geheimnisse unterscheiden. + +**Ergänzende Filmbeispiele:** „Felix beim Onkel“, „Lara und Paul“. + +### 2.4 Freundschaft, Selbstbehauptung und Zivilcourage + +**Lernschwerpunkt:** Eigene Meinungen vertreten, sozialem Druck begegnen und anderen verantwortungsvoll helfen. + +**Beispiele praktischer Übungen:** + +- Eigene Meinung vertreten. +- Gruppendruck widerstehen. +- Selbstsicher auftreten. +- Hilfsbereitschaft und Zivilcourage in altersgerechten Situationen üben. + +**Ergänzendes Filmbeispiel:** „Lara und Paul“. + +### 2.5 Streit, Bedrängung und Konflikte bewältigen + +**Lernschwerpunkt:** Konflikte möglichst früh erkennen, angemessen kommunizieren, Distanz schaffen und eine belastende Situation verlassen. + +**Beispiele praktischer Übungen:** + +- Konfliktgespräche führen. +- Körpersprache wahrnehmen und einsetzen. +- Einfache Ausweichbewegungen. +- Abstand schaffen. +- Laut um Hilfe rufen. +- Sich aus unangenehmen oder bedrängenden Situationen entfernen. + +**Ergänzende Filme:** Passende zusätzliche Filme können zugeordnet werden. + +### 2.6 Status der Beispiele + +Die genannten Filme und Situationen beschreiben **fachlich vorgesehene Zuordnungen**. Aus einer Nennung folgt nicht automatisch, dass eine verwendbare Datei bereits freigegeben, veröffentlicht oder Bestandteil eines bestimmten Kaufangebots ist. Der Inhalt und die Verfügbarkeit ergeben sich aus den tatsächlichen Veröffentlichungs- und Katalogdaten. + +## 3. Pädagogische Methode + +Das Konzept verbindet Beobachtung, Reflexion und praktische Anwendung. Ein typischer Kursabschnitt kann folgende Schritte umfassen: + +1. Eine alltagsnahe Situation vorstellen – beispielsweise mit einem Film, einer Erzählung oder einem Rollenspiel. +2. An einer geeigneten Stelle innehalten und eine **Denkpause** ermöglichen. +3. Mit Kindern verschiedene Handlungsmöglichkeiten besprechen. +4. Eine oder mehrere Reaktionen in kindgerechten praktischen Übungen ausprobieren. +5. Erfahrungen zusammenfassen, einen Merksatz ableiten und auf ähnliche Situationen übertragen. + +Dieser Ablauf ist **kein technisch erzwungenes Schema**: Ein Modul kann auch ohne Film funktionieren oder einzelne Schritte anders kombinieren. Die Denkpause ist eine didaktische Funktion, kein obligatorisches Quiz. + +Trainerhinweise sollen kurz, praktisch und unmittelbar einsetzbar sein. Sie unterstützen die Durchführung, ersetzen aber keine qualifizierte Gewaltschutztrainer-Ausbildung. + +Die konkrete Durchführung berücksichtigt Alter, Gruppensituation, Erfahrungen und mögliche Belastungsreaktionen der Kinder. Übungen sollen Handlungsfähigkeit fördern, ohne Kinder unter Druck zu setzen oder gefährliche Situationen nachzustellen. + +## 4. Fachliche Begriffe und Abgrenzungen + +| Begriff | Bedeutung | Verhältnis zu anderen Objekten | +| --- | --- | --- | +| **Gesamtkonzept** | Übergreifende Methode und Marke „Lara & Felix – Stark im Alltag“ | Kein automatisch einheitliches Verkaufsprodukt | +| **Themenbereich** | Einer der fünf fachlichen Lernschwerpunkte | Kann zahlreiche Module, Programme und Materialien umfassen; Mehrfachzuordnungen möglich | +| **Modul** | Eigenständig sinnvoll einsetzbare didaktische Trainingseinheit mit Lernzielen und passenden Bestandteilen | Kann in mehreren Programmen vorkommen und mehreren Themenbereichen zugeordnet werden | +| **Programm** | Didaktisch strukturierte Kombination von Modulen und gegebenenfalls weiteren Bestandteilen für einen Trainingszweck | Kann mehrere Themenbereiche abdecken; muss keinem kommerziellen Paket entsprechen | +| **Inhaltselement** | Film, Text, PDF, Bild, Ton, Übungsbeschreibung, Traineranleitung usw. | Wiederverwendbar in mehreren Modulen und Programmen, versionierbar | +| **Didaktische Komposition** | Geordnete Zusammenstellung von konkreten Fassungen beliebiger Inhalte oder weiterer Kompositionen | Technische Grundlage für unterschiedliche Modul-/Programmstrukturen ohne starre Hierarchie | +| **Lizenzartikel** | Vom Betreiber definierte kleinste eigenständig lizenzierbare Einheit | Kann einzelnes Inhaltselement oder eine Komposition repräsentieren | +| **Kommerzielles Paket** | Zusammenfassung lizenzierbarer Artikel | Fachlich unabhängig von Modulen und Programmen | +| **Angebot** | Lizenzumfang, Rechte, Konditionen und gegebenenfalls Preis | Bestimmt, welche Artikel und Rechte ein Käufer tatsächlich erwirbt | +| **Berechtigung** | Individuell zugeordnete Nutzungsberechtigung aus einer konkreten Erwerbsquelle | Kontrolliert Zugriff auf veröffentlichte Artikel und ihre Inhalte | + +**Fachliche Begriffe dürfen nicht stillschweigend mit kommerziellen Objekten gleichgesetzt werden.** Ein Programm kann als Lizenzartikel angeboten oder über mehrere Artikel kommerziell abgebildet werden; diese Wahl ist ausdrücklich zu treffen. + +## 5. Wiederverwendung und Zuordnung + +Die fachliche Struktur ist **mehrdimensional**, nicht ein einziger fester Baum. + +- Ein Film kann in mehreren Modulen und Programmen verwendet werden. +- Ein Modul kann mehreren Themenbereichen angehören. +- Ein Modul kann Bestandteil mehrerer Programme sein. +- Ein Programm kann mehrere Themenbereiche behandeln. +- Ein Themenbereich kann unterschiedliche, unabhängig veröffentlichbare Module enthalten. +- Dieselbe didaktische Zusammenstellung kann bei unterschiedlichen kommerziellen Angeboten auf verschiedene Weise lizenziert werden, soweit die Lizenzartikelgrenzen das erlauben. + +Beispiel: „Lara und Paul“ kann in den Themenbereichen **Geheimnisse, Vertrauen und Hilfe holen** sowie **Freundschaft, Selbstbehauptung und Zivilcourage** als didaktischer Einstieg genutzt werden, ohne dass der Film doppelt gespeichert werden muss. + +Fachliche Zuordnungen, Reihenfolgen und Präsentationen schaffen **keine Berechtigung** für das zugrunde liegende Medium. Maßgeblich bleibt die erworbene Lizenz. + +## 6. Programme und Module in der Kursdurchführung + +### Modul + +Ein Modul kann – je nach pädagogischer Aufgabe – unter anderem folgende Informationen beziehungsweise Bestandteile besitzen: + +- Titel und fachliche Beschreibung; +- einen oder mehrere Themenbereiche; +- Zielgruppe beziehungsweise Altersbereich; +- Lernziele und Vorbereitung; +- benötigte Materialien und Raum-/Technikhinweise; +- praktischen Ablauf mit geeigneten Übungen und Trainerfragen; +- optional Film, Denkpause, Reflexionsfragen und Merksatz; +- zugehörige Traineranleitungen, Merkzettel oder Arbeitsblätter. + +Nicht alle Bestandteile sind in jedem Modul zwingend erforderlich. Ein Modul bleibt fachlich verwendbar, auch wenn es keinen Film enthält. + +### Programm + +Ein Programm bündelt geeignete Module zu einem nachvollziehbaren Trainingsziel. Reihenfolge, Schwerpunkt und Umfang können je nach Zielgruppe variieren. Ein Programm darf Module aus unterschiedlichen Bereichen kombinieren. Eine pädagogische Programmstruktur ist unabhängig davon, ob ein Anbieter sie als ein Lizenzartikel, mehrere Lizenzartikel oder ein Paket kommerziell anbietet. + +### Praktische Nutzbarkeit + +Die Nutzeroberfläche soll nachvollziehbar zeigen, **wie** ein Trainer mit einem Programm oder Modul arbeitet: Einstieg, Material, Übungen, Reflexion und Durchführungshinweise. Eine reine Auflistung enthaltenen Dateien reicht dafür nicht aus. + +## 7. Vermarktbare Produkte und Rechteumfang + +Das öffentliche Leistungsversprechen ist ein **didaktisch einsetzbares Trainingsangebot**. Die Vermarktung priorisiert deshalb Konzept, Themenbereiche, Programme und Module vor Einzelfilmen. + +Der konkret kaufbare Gegenstand ist jedoch eindeutig zu bestimmen: + +- **Pädagogischer Nutzen:** Was lernt beziehungsweise übt die Zielgruppe? +- **Enthaltene Inhalte:** Welche Module, Filme, Unterlagen und Übungen gehören zur beworbenen Zusammenstellung? +- **Lizenzumfang:** Welche Lizenzartikel werden tatsächlich erworben? +- **Nutzungsrechte:** Was darf ein Trainer mit diesen Materialien tun, für welchen Zweck und wie lange? +- **Konditionen:** Welche Preis- und Vertragsbedingungen gelten? + +Eine Programmbeschreibung darf pädagogisch zusammengehörige Inhalte erläutern, aber nur **tatsächlich enthaltene oder ausdrücklich als optional bezeichnete** Materialien als Leistungsumfang darstellen. Freigaben und Zugriffe folgen den gültigen Berechtigungen, nicht der grafischen Nähe oder Themenzuordnung. + +Kostenlose Beispiele, freie Einstiegsmaterialien, Einzelmodule, Programme und themenübergreifende Pakete können koexistieren. Ihre konkrete kommerzielle Verfügbarkeit ist jeweils eine Betreiberentscheidung, keine automatische Ableitung der pädagogischen Gliederung. + +## 8. Darstellung auf der öffentlichen Webseite + +Die öffentliche Darstellung soll diesen Aufbau verständlich machen: + +1. **Gesamtkonzept und Methodik** – wofür Lara & Felix steht und wie die Trainingsmaterialien eingesetzt werden. +2. **Fünf Themenbereiche** – die wesentlichen pädagogischen Lernschwerpunkte. +3. **Programme und Module** – konkrete Durchführungseinheiten mit Zielgruppen, Lernzielen und Zusammensetzung. +4. **Film- und Materialbeispiele** – anschauliche didaktische Bestandteile und Vorschauen. +5. **Angebote und Lizenzen** – tatsächlich kaufbare Zusammenstellungen mit korrektem Rechteumfang. + +Die fünf Themenbereiche erhalten wiedererkennbare gestalterische Signaturen. Einzelfilme dürfen auffindbare Detailseiten besitzen, bilden aber nicht die dominante Handels- und Navigationsebene. + +Fachliche Seitentexte bleiben mit den aktuell veröffentlichten Produkt- und Angebotsdaten konsistent. Regeln zur visuellen Umsetzung und Suchmaschinenauffindbarkeit stehen in den beiden Prinzipiendokumenten. + +## 9. Mitgliederbereich und Trainingsnutzung + +Die Mitgliederbibliothek unterstützt die Arbeit mit **Programmen, Modulen und ihren Materialien**. Nutzer sollen berechtigte Zusammenstellungen erkennen, Inhalte nach Themenbereich finden, Lernziele sehen und zur konkreten Durchführung gelangen können. + +Wichtige fachliche Regeln: + +- Berechtigungen hängen an Lizenzartikeln und Erwerbsquellen, nicht an einer bloßen thematischen Zuordnung. +- Mehrere Berechtigungen für denselben Artikel dürfen in der Darstellung zusammengefasst, aber **nicht zu neuen, stärkeren Rechten vereinigt** werden. +- Gemeinsame Inhalte müssen nicht mehrfach in der Bibliothek erscheinen, nur weil sie aus verschiedenen Programmen oder Paketen stammen. +- Vor der Ausgabe einer Datei wird geprüft, ob sie Bestandteil des konkreten berechtigten veröffentlichten Artikel-Stands ist und die gewünschte Aktion erlaubt ist. +- Traineranleitungen, Filme und Begleitmaterial bleiben in der Oberfläche als zusammengehörige didaktische Einheit erkennbar. + +## 10. Mobile Nutzung und PWA + +Die öffentliche Präsentation und die Kursdurchführung sollen auch auf Smartphones und Tablets gut nutzbar sein. Besondere Bedeutung haben die Auffindbarkeit eines Programms, das Öffnen von Trainerunterlagen und die einfache Bedienung des Filmplayers mit Denkpause. + +Die Plattform wird als installierbare PWA genutzt, ohne dass dadurch automatisch ein Offline-Nutzungsrecht für geschützte Materialien entsteht. Mobiler Zugang und Lizenzumfang bleiben voneinander getrennt. + +## 11. Fachliche Prüfkriterien für die Software + +Die fachliche Konformität ist anhand zusammenhängender Nutzungsszenarien zu prüfen. Die folgenden Anforderungen gelten unabhängig von einer konkreten Tabellen- oder Klassenstruktur: + +1. Ein einzelnes Material kann in mehreren Modulen verwendet werden. +2. Ein Modul kann mehreren Themenbereichen zugeordnet werden. +3. Ein Modul kann in mehreren Programmen auftreten. +4. Ein Programm kann mehrere der fünf Themenbereiche behandeln. +5. Module und Programme können didaktisch dargestellt werden, ohne zugleich kommerzielle Pakete sein zu müssen. +6. Ein einzelnes Material, Modul oder Programm kann nach ausdrücklicher Entscheidung als Lizenzartikel definiert werden. +7. Ein kommerzielles Paket kann mehrere Lizenzartikel verschiedener Themen oder Programme umfassen. +8. Der Kauf beziehungsweise die freie Freischaltung gewährt ausschließlich die im Angebot festgelegten Rechte. +9. Änderungen an gemeinsam genutzten Medien verändern bestehende veröffentlichte, versionierte Zusammenstellungen nicht stillschweigend. +10. Die Mitgliederbibliothek zeigt Mehrfachzuordnungen und unterschiedliche Erwerbsquellen korrekt, ohne Dubletten oder unzulässige Rechtekombination. +11. Die tatsächliche Durchführung eines Moduls mit Film, Denkpause und Begleitmaterial ist im Mitgliederbereich praktisch möglich. +12. Mobile Nutzung und PWA-Funktionen verändern weder die fachlichen Freigaben noch den Lizenzschutz. + +Diese Kriterien beschreiben **fachliches Verhalten**. Ob vorhandene Tabellen oder Dienste erweitert werden müssen, ergibt sich aus der Prüfung der tatsächlichen Implementierung; das Konzept schreibt keine neue starre Produktdatenhierarchie vor. + +## Normative Bezüge + +- `docs/prinzipien/design-prinzipien.md` +- `docs/prinzipien/seo-und-content-prinzipien.md` +- `docs/architektur/04_Domaenenmodell.md` +- `docs/architektur/05_Lizenz_und_Berechtigungslogik.md` +- `docs/architektur/06_Versionierung_und_Veroeffentlichung.md` +- `docs/architektur/09_CMS_Administration_Community.md` + +**Verbindlicher Leitsatz:** Das Gesamtkonzept ist der pädagogische Wert, Programme und Module organisieren die praktische Nutzung, Filme und Materialien unterstützen die Durchführung, und lizenzierbare Artikel beziehungsweise Angebote definieren unabhängig davon die tatsächlichen Nutzungsrechte. diff --git a/docs/prinzipien/design-prinzipien.md b/docs/prinzipien/design-prinzipien.md new file mode 100644 index 0000000..435b812 --- /dev/null +++ b/docs/prinzipien/design-prinzipien.md @@ -0,0 +1,178 @@ +# Lara & Felix – Verbindliche Design- und UX-Prinzipien + +**Geltungsbereich:** Öffentliche Webseite, CMS-Bausteine, Katalog, Anmeldung, Mitgliederbereich, Bibliothek, Angebots- und Kaufprozess, Kursplayer sowie installierbare Progressive Web App (PWA). + +## 1. Gestalterisches Ziel + +„Lara & Felix – Stark im Alltag“ ist eine professionelle digitale Plattform für pädagogisch angeleitete Gewaltprävention und Selbstbehauptung. Die Oberfläche verbindet eine eigenständige, aus den vorhandenen Filmen entwickelte Markenwelt mit der Klarheit und Bedienbarkeit eines hochwertigen digitalen Produkts. + +Gestaltung, Funktionalität, Zugänglichkeit, Sicherheit und Wartbarkeit sind gleichrangige Qualitätsanforderungen. Ein austauschbares, offensichtlich aus Standardbausteinen zusammengesetztes KI-Webdesign erfüllt die Anforderungen nicht. + +Die öffentliche Webseite verkauft in erster Linie **das Trainingskonzept sowie Programme und Module**. Filme, Übungen und Unterlagen werden als Bestandteile eines pädagogisch zusammenhängenden Angebots präsentiert, nicht als isolierte Videothek. + +## 2. Markenpersönlichkeit und Zielgruppen + +Die Marke vermittelt Selbstwirksamkeit, Mut, Vertrauen, Sicherheit, Respekt, Freundlichkeit und pädagogische Glaubwürdigkeit. Sie ist positiv und zugewandt, ohne Gefahren zu dramatisieren oder eine nachweislose Schutzgarantie zu suggerieren. + +Die Plattform richtet sich an **erwachsene Trainer, Lehrkräfte, pädagogische Fachkräfte und Einrichtungen**. Die Lerninhalte richten sich gegenwärtig insbesondere an Kinder im Grundschulalter. Daraus ergeben sich zwei miteinander verbundene visuelle Ausdrucksweisen: + +- **Plattform und Vermarktung:** hochwertig, ruhig, klar, erwachsenengerecht, orientierungsstark und professionell. +- **Filmwelt und Didaktik:** emotionaler, bildstärker, freundlich, leicht verständlich und mit prägnanten grafischen Lernsignalen. + +Beide verwenden dieselbe grundlegende Markenidentität. Die Filmästhetik darf die funktionalen Seiten nicht überladen; umgekehrt soll die Produktoberfläche nicht beliebig oder steril wirken. + +## 3. Die fünf fachlichen Themenbereiche als Markensystem + +Die fünf Bereiche sind die wiederkehrende öffentliche Gliederung des Trainingskonzepts: + +| Nr. | Themenbereich | Grafische Leitidee | +| --- | --- | --- | +| 1 | **Meine Grenzen – Ich darf Nein sagen** | Stopp, persönliche Grenze, Selbstbestimmung | +| 2 | **Sicher handeln im Alltag** | Wahrnehmung, Abstand, überlegtes Handeln | +| 3 | **Geheimnisse, Vertrauen und Hilfe holen** | Vertrauenspersonen, Zuhören, Unterstützung | +| 4 | **Freundschaft, Selbstbehauptung und Zivilcourage** | Zugehörigkeit, Standpunkt, gegenseitige Hilfe | +| 5 | **Streit, Bedrängung und Konflikte bewältigen** | Kommunikation, Distanz, Deeskalation | + +Es ist eine zusammengehörige **Familie von fünf Signaturen** aus Symbol, Bezeichnung und gegebenenfalls unterstützendem Farbakzent zu gestalten. Die Bereiche müssen auch ohne Farbwahrnehmung unterscheidbar sein. Sie sind keine fünf unabhängigen Submarken und legen keine starre technische Produktstruktur fest. + +Die Bereichssignaturen erscheinen konsistent auf Themen-, Programm- und Modulseiten, in geeigneten Bibliotheksansichten und in Trainerunterlagen. Ein Modul, eine Komposition oder ein Film darf fachlich mehreren Bereichen zugeordnet sein; die visuelle Kennzeichnung muss Mehrfachzuordnungen unterstützen. + +## 4. Markenassets und Bildsprache + +Die vorhandene Lara-&-Felix-Markenwelt ist die maßgebliche visuelle Ausgangsbasis. Zu ihren sichtbaren Elementen gehören: + +- das **Titelmotiv** mit Lara, Felix, Wortmarke und dem Zusatz „Stark im Alltag“; +- das **Denkpause-Motiv** mit Fragewolke, Fragezeichen und grüner Kennzeichnung; +- das **Outro-/Freiflächenmotiv** als Vorlage für grafische Kompositionen; +- bestehende **Figurenreferenzen** und authentisch wirkende Alltagsszenen aus dem Filmprojekt. + +Bevorzugte Bildwirkung: fotorealistische Charaktere, natürliches Licht, freundliche Alltagssituationen, warme Grüntöne im Hintergrund, glaubwürdige Mimik und ruhige Tiefenschärfe. Die Filmfiguren sollen über freigegebene Darstellungen hinweg wiedererkennbar bleiben. + +### 4.1 Asset-Verbindlichkeit + +Ein Bild ist nicht allein wegen seiner Existenz im Medienbestand freigegeben. Für den produktiven Markeneinsatz müssen Motiv, Logo-Variante, Charakterkonsistenz, Bildauflösung, Nutzungsrechte und Verwendungskontext geklärt sein. Dazu dient ein kuratierter Asset-Katalog mit Kennung, Quelle, Zweck, Freigabestatus und geeigneten Formatvarianten. + +**Originaldateien bleiben unverändert.** Aus ihnen können geeignete Zuschnitte und optimierte Ableitungen erzeugt werden. Figuren oder Wortmarken dürfen nicht ungeprüft durch KI neu interpretiert werden. Das Markenlogo ist als eigenständige, möglichst skalierbare Ressource vorzusehen; ein vollständiges Filmbild ist kein Ersatz für ein korrektes Weblogo. + +### 4.2 Visuelle Rollen + +- **Titel-/Keyvisual:** markenprägender Einstieg auf Kampagnen- und Konzeptseiten. +- **Denkpause:** didaktisches Funktionsmotiv innerhalb der Lern- und Kursdarstellung, nicht universeller Seitenhintergrund. +- **Filmbilder:** anschauliche Belege für die Einsatzmöglichkeiten der Methode. +- **Figurenreferenzen:** Grundlage für Konsistenzprüfung neuer Darstellungen, nicht automatisch öffentliches Bildmaterial. +- **Ruhige Freiflächenbilder:** Hintergrund für gut lesbare Texte, sofern technisch und barrierefrei geeignet. + +Texte in Filmplakaten und Titelmotiven bleiben Bestandteil der Grafik. Wesentliche Seitentitel, Leistungsbeschreibungen und Handlungsaufforderungen müssen **zusätzlich als echte HTML-Texte** bereitstehen. + +## 5. Farb- und Typografiesystem + +Die identitätsstiftende Farbwelt nutzt **Dunkelblau, Grün, Gelb sowie Weiß und helle warme Neutralfarben**. + +| Rolle | Einsatz | +| --- | --- | +| Dunkelblau | Haupttext, Überschriften, Navigation, tragende Markenflächen | +| Grün | positive Markenakzente, „Stark im Alltag“, geeignete Handlungsflächen | +| Gelb | sparsame Denk- und Aufmerksamkeitsakzente, Unterstreichungen, Signalstrahlen | +| Helle Neutralfarben | Inhaltsflächen, großzügige Abstände, ruhige Hintergründe | + +Verbindliche numerische Farb-Tokens werden aus den **ausgewählten Originalassets** abgeleitet und auf Kontrast geprüft; Näherungswerte aus KI-Mockups sind keine autoritative Farbquelle. Markenfarben und semantische UI-Zustandsfarben (Fehler, Warnung, Erfolg, Information) sind getrennt zu definieren. + +Die Wortmarke besitzt eine charakteristische, freundlich gerundete Schriftanmutung. Für längere Inhalte, Formulare und Navigation ist eine hochgradig lesbare Webtypografie mit klarer Hierarchie zu verwenden. Marken-/Kampagnenschrift und Leseschrift dürfen unterschiedliche Aufgaben erfüllen. Schriftwahl berücksichtigt Darstellungsqualität, Ladezeiten und Nutzungsrechte. + +## 6. Layout- und Kompositionsprinzipien + +- Präzises Raster und wiederverwendbares Abstands- und Größenmaßsystem. +- Bewusste visuelle Hierarchie; ausreichend Ruhe und Weißraum. +- Hochwertige Editorial-Komposition für öffentliche Konzept- und Themenseiten. +- Klarheit, Orientierung und Informationsdichte nach Nutzungszweck für Katalog, Bibliothek und Konto. +- Differenzierte Bildschirmkomposition statt identischer Reihen gleichförmiger Karten. +- Bild-Text-Verhältnisse und Zuschnitte für verschiedene Bildschirmgrößen gezielt gestalten. +- Keine bedeutungslosen Dekorelemente, Überanimationen oder Effekte, die wichtige Inhalte überlagern. + +Asymmetrische Layouts sind eine mögliche Qualität der öffentlichen Kommunikation, aber kein Zwang für transaktionale oder funktionale Ansichten. + +## 7. Öffentliche Seiten und Angebotsdarstellung + +Die Hauptnavigation und die Seitenarchitektur sollen sich am Nutzerversprechen orientieren: **Konzept, fünf Themenbereiche, Programme und Module, Anwendung für Trainer, Angebote und Mitgliederbereich**. Die genaue Informationsarchitektur ist im CMS pflegbar. + +Die Startseite erklärt klar: + +1. welches Problem das Trainingskonzept adressiert; +2. wie die Methode Alltagssituationen, Reflexion und praktische Übungen verbindet; +3. welche fünf Themenbereiche behandelt werden; +4. wie Programme und Module im Unterricht beziehungsweise Kurs eingesetzt werden; +5. welche Materialien, Angebote und Nutzungsrechte tatsächlich verfügbar sind. + +**Programme und Module stehen visuell vor Einzelfilmen.** Ein Programm erhält eine übersichtliche Darstellung seiner Lernziele, Zielgruppen, enthaltenen Module, Materialien und methodischen Verwendung. Filme erscheinen im didaktischen Kontext. Angebotskarten erläutern den konkreten lizenzierten Umfang; sie dürfen ihn nicht mit dem pädagogisch zugehörigen, aber nicht enthaltenen Material verwechseln. + +Die Seiten verwenden Katalogdaten aus der maßgeblichen Veröffentlichung statt abweichender Kopien. Keine erfundenen Referenzen, Kundenbewertungen, Preise, Zertifikate, Qualifikationen oder Wirksamkeitsversprechen. + +## 8. Mitgliederbereich und Kursplayer + +Der Mitgliederbereich ist ein eigenständiges, professionelles Produkt und **keine umbenannte Filament-Administration**. + +Er bietet eine verständliche Navigation nach verfügbaren Programmen, Modulen, Themen und Materialien. Suche, Filter, Fortschritts- und Berechtigungsinformationen müssen bei wachsenden Katalogen übersichtlich bleiben. Derselbe Lizenzartikel soll bei mehreren Erwerbsquellen nicht als irreführende Mehrfachkopie erscheinen; Rechtequellen bleiben separat nachvollziehbar und dürfen fachlich nicht unzulässig vereinigt werden. + +Der Kursplayer unterstützt die reale Kursdurchführung. Besonders wichtig sind einfache Bedienung, gut lesbare Steuerelemente, Vollbild, Untertitel, Wiederholung und kontrollierbare **Denkpausen**. Die Denkpause ist eine echte didaktische Funktion, keine dekorative Unterbrechung. Der Kursplayer muss auch auf Tablets und mobilen Geräten zuverlässig bedienbar sein. + +## 9. Komponenten und Zustände + +Ein einheitliches Designsystem enthält mindestens folgende Familien: + +- **Plattformkomponenten:** Header, Navigation, Buttons, Suche, Filter, Formulare, Dialoge, Statusanzeigen, Kaufprozess, Benutzerkonto. +- **Inhaltskomponenten:** Programm- und Modulkarten, Lernzielansichten, Filmvorschauen, Traineranleitungen, Dokumente, Materiallisten, Lizenzinformationen. +- **Didaktische Komponenten:** Denkpause, Reflexionsfrage, Merksatz, Trainerhinweis, Übungsfolge. + +Für jede relevante Komponente sind Normal-, Hover-, Fokus-, Lade-, Leer-, Fehler-, Erfolgs- und gegebenenfalls deaktivierte Zustände konsistent zu gestalten. Die Komponenten dürfen das generische Inhalts-/Kompositionsmodell nicht auf einzelne Filmepisoden reduzieren. + +## 10. Interaktionen und Animationen + +Interaktionen sollen unmittelbar verständlich sein. Geeignete Mikroanimationen unterstützen Orientierung, Zustandswechsel und Rückmeldung. Hover- und Fokuszustände, Eingabevalidierung, Navigation, Ladeanzeigen und Fehlermeldungen sind sorgfältig gestaltet. + +Animationen dürfen weder ablenken noch die Bedienung verzögern. `prefers-reduced-motion` muss respektiert werden. Die Anwendung vermeidet vermeidbare Layoutsprünge, animierte Pflichtinformationen und rein dekorative Bewegung. + +## 11. Mobile First und PWA + +Die gesamte öffentliche Webseite sowie Anmeldung, Mitgliederbibliothek, Angebote, Checkout und Kursplayer werden **Mobile First** umgesetzt. Mobile ist eine vollwertige Nutzungssituation und keine verkleinerte Desktopversion. + +Die Plattform ist als **installierbare Progressive Web App** konzipiert. Dazu gehören: + +- gültiges Web-App-Manifest, Name, Markenicons und geeigneter Startpunkt; +- responsives, touchfreundliches Bedienkonzept einschließlich Tablets; +- Service Worker mit dokumentierter, sicherer Cache-Strategie; +- sinnvolle Offline-/Verbindungsfehleransicht für nicht verfügbare Netzwerkinhalte; +- geprüfte Aktualisierung und Navigation in der installierten App; +- Installation und Service-Worker-Funktionen in einem sicheren Ursprung (HTTPS beziehungsweise geeignete lokale Entwicklungsumgebung). + +Die PWA ersetzt nicht die öffentliche, servergerenderte Website. Installation gewährt **keine zusätzlichen Nutzungsrechte**. Authentifizierte Seiten, personenbezogene Daten, signierte Medien-URLs, individuelle PDF-Ausgaben und geschützte Videos dürfen nicht unbeabsichtigt dauerhaft offline gespeichert oder über gemeinsam genutzte Caches bereitgestellt werden. Ein Offline-Modus für lizenzierte Inhalte erfordert eine gesonderte fachliche und technische Festlegung. + +## 12. Zugänglichkeit und Performance + +Die Plattform orientiert sich an **WCAG 2.2 AA** und den **Core Web Vitals**. + +Relevant sind insbesondere semantische HTML-Struktur, ausreichende Kontraste, Tastaturbedienung, sichtbare Fokusindikatoren, verständliche Formulare, passende Alternativtexte, Untertitel und zugängliche Player-Bedienelemente. Die Seitentypografie bleibt auch bei Zoom und kleinen Ansichten nutzbar. + +Bilder und Medien werden größen- und formatgerecht ausgeliefert. Große Hero-Bilder dürfen die Ladezeit nicht unnötig beeinträchtigen. Unnötiges JavaScript, Layoutverschiebungen und übermäßige Animationslast sind zu vermeiden. + +**Gemeinsame Anforderungen an öffentliche Inhalte, Indexierbarkeit und Struktur** stehen in `seo-und-content-prinzipien.md`. Die Designprinzipien bestimmen die Darstellung und Bedienung; die SEO-Prinzipien bestimmen die Auffindbarkeit und Content-Regeln. + +## 13. Visuelle Qualitätssicherung + +Funktionierende Tests ersetzen keine visuelle Prüfung. Wesentliche Ansichten sind in der **tatsächlich gerenderten Anwendung** mindestens auf Desktop (ca. 1440 px), Tablet (ca. 768 px) und Smartphone (ca. 390 px) zu prüfen. Zusätzlich sind echte Interaktions- und Fehlersituationen einzubeziehen. + +Zu kontrollieren sind Typografie, Proportionen, Bildzuschnitte, visuelle Hierarchie, Navigationsverhalten, Formularzustände, Touch-Bedienbarkeit, Lesbarkeit, Farbkontrast, Konsistenz mit den freigegebenen Markenassets und fachliche Verständlichkeit der Programm-/Modulangebote. + +Ein Entwurf oder Mockup ist keine geprüfte Produktansicht. Eine Prüfung darf nur als durchgeführt gemeldet werden, wenn die jeweilige Ansicht tatsächlich betrachtet wurde. + +## 14. Externe Designwerkzeuge und Anti-Patterns + +Design-Skills und Komponentenbibliotheken sind unterstützende Werkzeuge. Maßgeblich sind die freigegebene Lara-&-Felix-Markenidentität, dieses Regelwerk und die tatsächlichen Nutzeraufgaben. Externe Skills dürfen kein eigenständiges Designsystem ohne Bezug zur vorhandenen Bildwelt erzwingen. + +Zu vermeiden sind insbesondere generische Blau-Violett-Verläufe, beliebige Stockfotos, austauschbare SaaS-Heros, identische Kartenwüsten, dekoratives Glassmorphism ohne Funktion, übertriebene Schatten, inflationäre Icons, unnötige Bewegung und eine durchgängig kindliche Posterästhetik. + +## Normative Bezüge + +- `docs/prinzipien/seo-und-content-prinzipien.md` +- `docs/fachkonzept/trainingskonzept-und-produktstruktur.md` +- [WCAG 2.2 (W3C)](https://www.w3.org/TR/WCAG22/) +- [Core Web Vitals](https://web.dev/articles/vitals) diff --git a/docs/prinzipien/seo-und-content-prinzipien.md b/docs/prinzipien/seo-und-content-prinzipien.md new file mode 100644 index 0000000..aefa3a7 --- /dev/null +++ b/docs/prinzipien/seo-und-content-prinzipien.md @@ -0,0 +1,192 @@ +# Lara & Felix – Verbindliche SEO-, Content- und Marketing-Prinzipien + +**Geltungsbereich:** Öffentliche Website, CMS, Konzept- und Themenseiten, Programme, Module, Katalog- und Angebotsseiten, Suchmaschinen, KI-gestützte Suche und datenbasierte Marketingsteuerung. + +## 1. Positionierung und Marketingziel + +„Lara & Felix – Stark im Alltag“ wird als **pädagogisches Gesamtkonzept für Gewaltprävention und Selbstbehauptung** vermarktet. Der zentrale Nutzen liegt in der Kombination aus strukturierten Trainingsprogrammen, flexibel einsetzbaren Modulen, praktischen Übungen, didaktischen Filmen und begleitenden Trainer- und Unterrichtsmaterialien. + +Die Vermarktung richtet sich besonders an Trainer, Lehrkräfte, pädagogische Fachkräfte und Einrichtungen. Der öffentliche Auftritt ist **keine vorrangige Film-Verkaufsplattform**. Einzelfilme dürfen beschrieben und gegebenenfalls separat lizenziert werden, stehen kommunikativ aber hinter dem didaktischen Gesamtkonzept. + +Ziele sind organische Sichtbarkeit bei relevanten Suchanfragen, qualifizierte Besuche, Auffindbarkeit in geeigneten KI-Suchdiensten, Registrierungen, sinnvolle Nutzung kostenfreier Inhalte und Erwerb passender Angebote. Eine bestimmte Rankingposition oder KI-Zitation wird **nicht garantiert**. + +## 2. Die fünf Themenbereiche als zentrale Informationsstruktur + +Die öffentliche Website bildet die fünf fachlichen Schwerpunkte deutlich ab: + +1. **Meine Grenzen – Ich darf Nein sagen** +2. **Sicher handeln im Alltag** +3. **Geheimnisse, Vertrauen und Hilfe holen** +4. **Freundschaft, Selbstbehauptung und Zivilcourage** +5. **Streit, Bedrängung und Konflikte bewältigen** + +Jeder Bereich kann eine redaktionell gepflegte Themenseite mit verständlicher fachlicher Einordnung, Lernzielen, Übungen, geeigneten Filmbeispielen, zugehörigen Modulen/Programmen und tatsächlich verfügbaren Angeboten erhalten. + +Die fünf Bereiche sind **inhaltliche Einstiege**, nicht automatisch eigenständige Verkaufsprodukte. Eine Übung, ein Film, ein Modul oder ein Programm darf mehreren Bereichen zugeordnet sein; doppelte Inhalte und nahezu identische indexierbare URLs sind zu vermeiden. + +Die konkrete pädagogische Zuordnung wird in `docs/fachkonzept/trainingskonzept-und-produktstruktur.md` festgelegt. + +## 3. Nutzungsorientierte Informationsarchitektur + +Die öffentlich zugängliche Site-Struktur unterscheidet: + +| Seitengruppe | Primärer Zweck | +| --- | --- | +| Konzept- und Methodikseiten | Trainingsidee, pädagogische Vorgehensweise, Einsatzmöglichkeiten verstehen | +| Fünf Themenseiten | Lernschwerpunkte und praktische Übungen erschließen | +| Programm- und Modulseiten | Lernziele, Aufbau, Inhalte und Zielgruppen verständlich machen | +| Katalog- und Angebotsseiten | Lizenzierbaren Umfang, Nutzungsrechte und Konditionen korrekt darstellen | +| Fachbeiträge und Hilfeseiten | Konkrete Fragen von Trainern und Pädagogen beantworten | +| Mitgliederbereich | Persönlich berechtigte Materialien nutzen; nicht öffentlich indexierbar | + +Wichtige Informationen sollen über nachvollziehbare Navigation und interne Links erreichbar sein. Die öffentliche Darstellung der pädagogischen Zusammenhänge ist von der kommerziellen Bündelung und Berechtigung strikt getrennt. + +## 4. Menschenorientierter, fachlich belastbarer Content + +Inhalte müssen reale Fragen der Zielgruppen beantworten. Eigene Filme, Trainingsmaterialien, methodische Erläuterungen und nachweisbare Praxiserfahrungen sind die Grundlage eigenständiger Inhalte. + +Fachliche Aussagen werden hinsichtlich Richtigkeit, Nachvollziehbarkeit und bei Bedarf Quellenlage geprüft. Angaben zu Wirksamkeit, Sicherheit und Schutz dürfen nicht über vorhandene Evidenz hinausgehen. Autorenschaft, Herausgeber und fachliche Qualifikationen werden korrekt und transparent dargestellt. + +Automatisierte Textproduktion dient der Unterstützung, nicht der Erzeugung großer Mengen austauschbarer Suchmaschinenseiten. Keine erfundenen Bewertungen, Testimonials, Partner, Qualifikationen oder Ergebnisse. + +### Methodische Kommunikation + +Die Vermittlung kann die Struktur **„Alltagssituation erleben – gemeinsam nachdenken – praktisch ausprobieren – Handlungsmöglichkeiten reflektieren“** verwenden. Dies ist ein Kommunikationsrahmen, keine zwingende Schrittfolge jedes Moduls. + +Die öffentliche Kommunikation soll erklären, **wie** Trainer mit den Materialien arbeiten und welchen pädagogischen Zweck ein Angebot verfolgt, statt nur Medienzahlen aufzulisten. + +## 5. Technische SEO-Anforderungen + +Öffentliche Seiten verwenden semantisch sinnvolles, möglichst servergerendertes HTML. Folgende Funktionen gehören zur Plattform: + +- individuelle Seitentitel und sinnvolle Meta-Beschreibungen; +- eindeutige kanonische URLs und stabile, lesbare Pfade; +- funktionierende Weiterleitungen bei URL-Änderungen; +- automatisch aus geeigneten veröffentlichten URLs erzeugte XML-Sitemap; +- definierte `robots.txt`- und `noindex`-Regeln; +- Breadcrumb-Navigation und nachvollziehbare interne Verlinkung; +- Open-Graph- und andere geeignete Social-Preview-Metadaten; +- strukturierte Daten nur für passende, öffentlich belegbare Seitentypen; +- responsive, zugängliche und performante Auslieferung; +- gültige HTTP-Statuscodes und korrekte Behandlung nicht vorhandener Inhalte. + +Die CMS-Verwaltung ermöglicht die Bearbeitung von SEO-Titel, Beschreibung, URL-Pfad, Vorschau, Indexierungsstatus und redaktionellen Metadaten. SEO-Inhalte sind versionier- und veröffentlichbar wie andere Seiteninhalte. + +## 6. Dynamische Seiten aus Katalogdaten + +Programm-, Modul-, Artikel-, Paket- und Angebotsseiten lesen verbindliche Informationen aus den **veröffentlichten** maßgeblichen Fachobjekten. Das umfasst beispielsweise Titel, Zielgruppe, Lernziele, Inhalte, Preis, Lizenzrechte und Laufzeit. + +Redaktionelle Seitentexte dürfen ergänzen, aber keine abweichenden Produktversprechen erzeugen. Ein pädagogisch zugeordnetes Material wird nicht automatisch als Bestandteil eines kommerziellen Angebots angegeben. + +Nicht jede Kombination aus Inhalt, Thema, Schlagwort und Paket muss eine eigene indexierbare URL erhalten. Indexierbare Seiten brauchen einen eigenständigen Informationsnutzen. Bei Überschneidungen sind geeignete kanonische URLs, Zusammenführung oder kontrollierte Nichtindexierung vorzusehen. + +## 7. Bilder, Videos und textliche Erschließung + +Die vorhandene Lara-&-Felix-Bildwelt wird konsistent genutzt; Freigaben und Rechte bleiben Voraussetzung. + +- Bilder erhalten geeignete Beschreibungen beziehungsweise funktionsbezogene Alt-Texte, responsive Größen und optimierte Dateiformate. +- Wesentliche Überschriften, Leistungsbeschreibungen, Lernziele, Fragen und CTAs müssen als **echter HTML-Text** vorliegen, auch wenn Titelgrafiken Schrift enthalten. +- Öffentlich freigegebene Filmvorschauen dürfen mit zutreffenden Titeln, Standbildern, Beschreibungen und gegebenenfalls geeigneten Video-Metadaten präsentiert werden. +- Zusammenfassungen oder Transkriptauszüge werden nur veröffentlicht, wenn sie dafür bestimmt sind; geschützte Volltexte und Originalmedien bleiben privat. +- Große Medien dürfen die Ladezeiten der Einstiegsseiten nicht unnötig belasten. + +Gestaltung und Markenelemente richten sich nach `docs/prinzipien/design-prinzipien.md`. + +## 8. Strukturierte Daten + +Strukturierte Daten dürfen nur vorhandene, sichtbare und korrekte Sachverhalte beschreiben. Geeignet können je nach Seitentyp Angaben zu Herausgeber, Website, Breadcrumbs, Fachbeiträgen, Videos oder kommerziellen Angeboten sein. + +Die aktuelle Unterstützung des jeweiligen Suchdienstes ist zu prüfen. Nicht passende `schema.org`-Typen, erfundene Preise, Bewertungen oder Wirkungsangaben sind unzulässig. Validierung ist Teil der Veröffentlichungskontrolle. + +## 9. KI-gestützte Suche (GEO/AEO) + +Auffindbarkeit und Zitierbarkeit in KI-gestützten Suchsystemen werden durch **klar strukturierte, verlässliche und öffentlich zugängliche Fachinhalte** unterstützt: + +- präzise Antworten auf tatsächlich gestellte Fragen; +- eindeutige Begriffe und nachvollziehbare Überschriften; +- benannte Autoren und Herausgeber; +- fachliche Quellen bei überprüfungsbedürftigen Behauptungen; +- konsistente Angaben zu Methode, Programm, Modul und Angebot; +- stabile, intern verlinkte öffentliche Seiten; +- zugängliche Textbeschreibungen für visuelle Medien. + +Es werden keine unbelegten Spezialtricks, angeblich garantierten KI-Markups oder Rankingversprechen eingesetzt. Mögliche Zitationen durch KI-Systeme sind externe Ergebnisse, keine vom System kontrollierbaren Eigenschaften. + +## 10. Indexierung, Datenschutz und Zugangsschutz + +Indexierung ist ausschließlich für geeignete veröffentlichte öffentliche Seiten vorgesehen. Entwürfe, zurückgezogene oder nicht freigegebene Inhalte, Verwaltungsansichten, personenbezogene Profile, Bestellungen, geschützte Medien und Mitgliederbibliotheken dürfen nicht unkontrolliert öffentlich sichtbar werden. + +Die Testumgebung muss zuverlässig gegen öffentliche Indexierung und unerwünschten Zugriff abgesichert sein. **`robots.txt` und `noindex` sind keine Authentifizierung und kein Schutz für vertrauliche Daten.** Geschützte Medien und Seiten benötigen unabhängig davon serverseitige Zugriffsentscheidungen. + +Sitemaps und strukturierte Daten dürfen keine nicht veröffentlichten oder sensiblen Informationen preisgeben. + +## 11. Mobile Web und PWA + +Die Website bleibt **ohne Installation** öffentlich zugänglich und indexierbar. Die installierbare PWA ist ein zusätzlicher Nutzungsweg für Mitglieder und Trainer. + +Service Worker, clientseitige Navigation und Caches dürfen weder stabile öffentliche URLs noch serverseitig ausgelieferte Inhalte, kanonische Angaben, Metadaten und strukturierte Daten beeinträchtigen. Geschützte Inhalte dürfen nicht über PWA-Caches öffentlich oder nutzerübergreifend verfügbar werden. + +Mobile Performance, Zugänglichkeit und Core Web Vitals sind gemeinsame Anforderungen der Design- und SEO-Prinzipien. + +## 12. Inhaltliche Themen- und Suchstrategie + +Themen werden aus den fünf Bereichen, der tatsächlichen Trainingspraxis und dem Informationsbedarf der Zielgruppen entwickelt. Mögliche Themenfelder sind persönliche Grenzen, Nein-Sagen, sichere Entscheidungen, Vertrauenspersonen, Hilfeholen, Freundschaft, Zivilcourage und Konfliktbewältigung. + +Suchvolumen, Konkurrenz und Suchintention sind **zu messen beziehungsweise zu recherchieren**, nicht zu erfinden. Themencluster bestehen aus wenigen eigenständigen, hilfreichen Beiträgen mit sinnvoller Verbindung zu Programmen und Modulen. Keine massenhaft erzeugten Keyword-Variationen oder künstlich aufgeblähten Landingpages. + +## 13. Messung und Marketing-Intelligence + +Die Marketingsteuerung soll tatsächliche Datenquellen nutzen, sobald autorisierte Zugänge vorliegen, insbesondere: + +- Google Search Console; +- Bing Webmaster Tools und verfügbare KI-Suchleistungsdaten; +- datenschutzkonforme Webanalyse; +- interne Registrierungs-, Nutzungs- und Kaufkennzahlen. + +Messbar sind abhängig von der Datenquelle organische Impressionen, Klicks, Suchanfragen, Landingpage-Leistung, Indexierungsprobleme, Registrierungen, Nutzung kostenloser Inhalte, Käufe und Conversion-Raten. Kennzahlen zur Zitation in KI-Antworten werden nur dargestellt, soweit der jeweilige Anbieter entsprechende Daten tatsächlich liefert. + +Jede Kennzahl enthält nach Möglichkeit Quelle, Zeitraum und Definition. **Messwerte, Schätzungen, Analysen und KI-Empfehlungen dürfen nicht verwechselt werden.** Fehlende Daten werden als fehlend dargestellt. + +## 14. Kontinuierliche Marketingsteuerung + +Die Marketingfunktionen arbeiten mit drei klar unterscheidbaren Automatisierungsstufen: + +**Datenerhebung und technische Überwachung:** regelmäßige Abfragen vorhandener Schnittstellen, Erkennung auffälliger Veränderungen und Meldung technischer Probleme. + +**Analyse und Maßnahmenvorschläge:** Erkennen unvollständiger Seiten, thematischer Chancen, schwacher Landingpages, fehlender interner Links und veralteter Inhalte; Priorisierung anhand nachvollziehbarer Daten. + +**Redaktionelle Unterstützung:** Erstellung von Briefings, Themenplänen, Textentwürfen, alternativen Überschriften, Meta-Beschreibungen und Verbesserungsvorschlägen. + +KI-generierte Vorschläge werden als solche markiert und im bestehenden CMS als prüfbare Entwürfe behandelt. Neue fachliche Aussagen, öffentliche Kampagnen, externe Kommunikation und bezahlte Werbebudgets benötigen geeignete menschliche Freigaben. Automatische Routinearbeiten können innerhalb definierter Berechtigungen ohne manuelle Einzelfreigabe laufen. + +Die automatisierte Vermarktung darf nicht zu einem unkontrollierten SEO-Content-Generator werden. Fachliche Verantwortung und Wahrheitstreue stehen über Veröffentlichungsfrequenz. + +## 15. Qualitätssicherung + +Für öffentliche Seiten sind insbesondere zu prüfen: + +- korrekte Metadaten, kanonische URLs und Statuscodes; +- Sitemap ohne Entwürfe, geschützte oder irrelevante Seiten; +- konsistente Anzeige von Angeboten und Lizenzumfang; +- gültige und sichtbare strukturierte Daten; +- funktionierende Verlinkung zwischen Themen, Modulen, Programmen und Angeboten; +- richtige Bildbeschreibungen und zugängliche Textstruktur; +- keine unerlaubte Veröffentlichung oder Indexierung geschützter Medien; +- mobile Bedienbarkeit, Ladeleistung und Zugänglichkeit; +- korrekte Zuordnung und Definition erhobener Marketingkennzahlen. + +**Technische SEO-Korrektheit garantiert keine bestimmte Suchposition.** Die tatsächliche Wirkung ist anhand späterer realer Suchdaten zu beurteilen. + +## Normative Bezüge und Fachquellen + +- `docs/prinzipien/design-prinzipien.md` +- `docs/fachkonzept/trainingskonzept-und-produktstruktur.md` +- [Google: SEO Starter Guide](https://developers.google.com/search/docs/fundamentals/seo-starter-guide) +- [Google: Helpful, reliable, people-first content](https://developers.google.com/search/docs/fundamentals/creating-helpful-content) +- [Google: AI features and your website](https://developers.google.com/search/docs/appearance/ai-features) +- [Google: Structured data](https://developers.google.com/search/docs/appearance/structured-data/intro-structured-data) +- [Google: Sitemaps](https://developers.google.com/search/docs/crawling-indexing/sitemaps/build-sitemap) +- [Google: Prevent indexing with noindex](https://developers.google.com/search/docs/crawling-indexing/block-indexing) +- [Bing Webmaster Blog](https://blogs.bing.com/webmaster) +- [WCAG 2.2](https://www.w3.org/TR/WCAG22/) +- [Core Web Vitals](https://web.dev/articles/vitals) diff --git a/docs/strategie/website-cms-seo-marketing-zielkonzept.md b/docs/strategie/website-cms-seo-marketing-zielkonzept.md new file mode 100644 index 0000000..04b58f2 --- /dev/null +++ b/docs/strategie/website-cms-seo-marketing-zielkonzept.md @@ -0,0 +1,1296 @@ +# Lara & Felix – Strategisches Zielkonzept für Website, CMS, SEO und Marketing + +**Stand:** 15.11.2026 +**Status:** Entwurf zur gemeinsamen Prüfung. Kein Implementierungsauftrag, keine Änderung an bestehenden Dokumenten, am Code oder an Daten. +**Schwesterdokument:** `docs/architektur/website-cms-marketing-zielarchitektur.md` (technische Varianten, Datenmodelle, Mechanismen). Dieses Dokument begründet das *Was und Warum*, das Schwesterdokument das *Wie*. +**Auftrag:** `docs/tasks/Strategieentwicklung.md` +**Änderungsstand:** Am 15.11.2026 konsolidiert mit der Fassung nach Review von `docs/analysen/ist-soll-abgleich-mitgliederbibliothek.md` und `docs/analysen/umsetzungsplan-mitgliederbibliothek.md` (Pakete 0 bis 9). Geändert: Inhaltsart statt `CompositionKind` als fachlicher Typ (8.2, 9.1, 9.2); Abstimmung von Bereitschaft, Anzeigefreigabe und öffentlichem Profil (9.1); Eigen-CMS als bevorzugte Variante unter Vorbehalt mit Editor-Prototyp (10.6, 10.7); Paketnummern, Stufen W-P und W1b, gemeinsame Reihenfolge (14.2, 14.5); Folgestellen in 1, 2, 15, 16, 17, 18 und 19. + +--- + +## 1. Executive Summary + +**Die Kernaussage:** Die Plattform hat ein ungewöhnlich starkes Fundament (Inhalts-, Versions-, Lizenzmodell) und eine schwache Schauseite. Der nächste Wertzuwachs entsteht nicht durch ein neues CMS-Produkt und nicht durch KI, sondern durch drei Dinge in dieser Reihenfolge: eine freigegebene Markenbasis, einen öffentlichen Katalog, der Programme und Module direkt aus den Fachdaten zeigt, und ein Seitensystem mit Vorlagen, das neue Seiten ohne Entwickler erlaubt. Messung beginnt am ersten Tag, Automatisierung erst, wenn Daten da sind. + +| Nr. | Ergebnis | Kapitel | +|---|---|---| +| 1 | **Positionierung:** „Trainingskonzept mit Unterrichtsmaterial für Fachleute“, nicht Videothek und nicht Kursanbieter für Eltern. Das Lizenzmerkmal *Nutzungszweck* (ehrenamtlich, kommerziell, institutionell) ist zugleich die Zielgruppengliederung der Website. | 3, 4 | +| 2 | **Vertrauen ist die eigentliche Währung des Marktes.** Öffentliche Stellen kritisieren unqualifizierte Anbieter und verkaufte Kurzkonzepte. Lara & Felix muss deshalb offen zeigen: wer fachlich verantwortet, was das Material leistet und was nicht. Das ist bereits Festlegung im Fachkonzept und wird zum sichtbaren Differenzierungsmerkmal. | 3.3 | +| 3 | **Die Designstudie trägt als Markenbasis, nicht als Seitenkonzept.** Farbwelt, Bildwelt, Denkpause-Symbol und die ruhige Editorial-Anmutung der HTML-Vorschau bleiben. Navigation, Startseite, Angebotskarte und Bibliothek sind filmzentriert und werden ersetzt. Es fehlen vollständig: die fünf Themen-Signaturen, Programm-, Modul-, Landing- und Lizenzvergleichsseiten, Formulare und Zustände. | 5, 6 | +| 4 | **Zwei messbare Mängel der Studie:** Weiß auf Markengrün und der grüne Kleintext erreichen nach eigener Berechnung etwa 4,1 bis 4,3:1 und damit nicht WCAG AA für Fließtextgröße. Die Schriften werden von einem Google-Server geladen. Beides ist vor Übernahme zu beheben. | 5.3 | +| 5 | **Informationsarchitektur:** sechs Einstiege (Konzept, Themen, Programme, Für wen, Angebote, Wissen). Jedes Programm hat genau eine fachliche Adresse; Landingpages und Angebotsseiten zeigen dieselben Daten in anderer Argumentation. | 8, 9 | +| 6 | **CMS:** Der Ausbau des Eigenkerns ist die bevorzugte Variante unter Vorbehalt. Das vorhandene Seitensystem (Entwurf, Vorschau, Revision, Wiederherstellung funktionieren) wird zu einem Vorlagen- und Abschnittssystem mit Katalogbausteinen ausgebaut. Statamic, Twill, ein freier Page Builder und Headless-Varianten wurden bewertet und unterliegen in der Bewertung, vor allem wegen der zweiten Verwaltungsoberfläche und der Datenkopien. Entschieden wird nach einem kleinen Editor-Prototyp mit neun Bedienaufgaben. | 10, Architektur 4 | +| 7 | **SEO:** automatisiert werden die Seiten echter Fachobjekte (Thema, Programm, Modul, Angebot) und die gesamte Technik. Nicht automatisiert werden Schlagwort-Kombinationen. Google unterstützt 2026 weder FAQ- noch Kursinfo-Ergebnisse mehr; der Aufwand für strukturierte Daten wird entsprechend klein gehalten. | 11 | +| 8 | **KI-Suche:** Google verlangt ausdrücklich keine Sonderdateien und kein Sondermarkup. Messbar sind inzwischen Impressionen in Googles KI-Funktionen und Zitationen bei Bing; beide Berichte haben nach heutigem Stand keine belegte Programmierschnittstelle. | 11.6 | +| 9 | **Marketingsteuerung:** ein Modul im Kern mit Regeln, Maßnahmenliste und Freigaben. KI als einzelne, protokollierte Arbeitsschritte hinter einem Adapter, kein Agentenverbund. Erwartete Modellkosten im einstelligen Euro-Bereich pro Monat; der Engpass ist die Prüfzeit des Betreibers, nicht das Budget. n8n nur optional für die Anbindung fremder Kanäle. | 12, Architektur 8–9 | +| 10 | **Roadmap:** die vorgeschlagene Phase 1 ist zu groß und misst zu spät. Empfohlen sind kleinere Stufen W0 bis W4 (Website) und M0 bis M3 (Marketing), die sich in die bestehende Roadmap `15` einfügen. Mit den Bibliothekspaketen 0 bis 9 gibt es eine gemeinsame Reihenfolge: Sechs Pakete sind unverändert umsetzbar, vier hängen an gemeinsamen Komponenten. | 14, Architektur 14 | + +**Die Entscheidungen, die als Nächstes gebraucht werden** (Details in Kapitel 17): + +1. Freigabe der Wortmarke, der Farbwerte und der Schriften. +2. Herkunft und Rechte der Figurenbilder; Regel für öffentliche Verwendung. +3. Zielgruppe für den Start (Empfehlung: Einzeltrainer, weil der erste Schnitt nur an Einzelpersonen verkauft). +4. Das kostenlose Einstiegsangebot (Empfehlung: ein vollständiges Modul). +5. Wer fachlich namentlich verantwortet und welche Qualifikation öffentlich genannt wird. +6. CMS-Richtung nach dem Editor-Prototyp (bevorzugt: Ausbau des Eigenkerns). +7. Reichweitenmessung, KI-Dienst und Umgang mit KI-Crawlern. + +--- + +## 2. Grundlagen und Lesart + +### 2.1 Kennzeichnung des Entscheidungsstands + +| Kennzeichen | Bedeutung | +|---|---| +| **[FEST]** | Verbindliche Bestandsentscheidung aus Fachkonzept, Prinzipien oder beschlossener Architektur | +| **[ENTWURF]** | In einem Bestandsdokument beschrieben, aber keine endgültige Festlegung | +| **[BELEGT]** | Durch Quelle (Kapitel 20) oder durch den tatsächlichen Code nachgewiesen | +| **[EMPF]** | Empfehlung dieses Konzepts | +| **[ANNAHME]** | Nicht geprüfte Annahme oder Hypothese | +| **[OFFEN]** | Entscheidung des Auftraggebers erforderlich | + +### 2.2 Geprüfte Unterlagen (tatsächliche Pfade) + +| Unterlage | Pfad | Rolle | +|---|---|---| +| Trainingskonzept und Produktstruktur | `docs/fachkonzept/trainingskonzept-und-produktstruktur.md` | fachlich verbindlich | +| Produktkonfiguration und Mitgliederbereich | `docs/fachkonzept/produktkonfiguration-und-mitgliederbereich.md` | fachlich verbindlich (Soll) | +| Architekturabgleich dazu | `docs/fachkonzept/abgleich-produktkonfiguration-und-mitgliederbereich.md` | liegt unter `fachkonzept/`, nicht unter `architektur/` wie im Auftrag genannt | +| Design-Prinzipien | `docs/prinzipien/design-prinzipien.md` | verbindlich | +| SEO- und Content-Prinzipien | `docs/prinzipien/seo-und-content-prinzipien.md` | verbindlich | +| CMS-, Verwaltungs- und Communitykonzept | `docs/architektur/09_CMS_Administration_Community.md` | Entwurf nach Challenger-Prüfung | +| Zielarchitektur, Domänenmodell | `docs/architektur/03_Zielarchitektur.md`, `04_Domaenenmodell.md` | Entwurf; Kernstapel beschlossen (ADR-02) | +| Technologiebewertung, Roadmap, MVP-Schnitt | `docs/architektur/10_…`, `15_…`, `16_…` | Entwurf | +| Ist-Soll-Abgleich Mitgliederbibliothek | `docs/analysen/ist-soll-abgleich-mitgliederbibliothek.md` (Fassung nach Review) | Ist-Aufnahme am Code; Entscheidungen E-A, E-T, E-L, E-M, E-D | +| Umsetzungsplan Mitgliederbibliothek | `docs/analysen/umsetzungsplan-mitgliederbibliothek.md` (Fassung nach Review, Pakete 0 bis 9) | Vorschlag zur Freigabe | +| Früherer Marketingauftrag | `docs/tasks/SEO-Marketing.md` | Auftragstext, in Teilen filmzentriert | +| Brand & UI Kit v1.0 | `docs/Brand-UI-Kit/` (im Auftrag als „Brans-UI-Kit“ genannt) | gestalterische Referenz | +| Stand der Umsetzung | `docs/betrieb/MVP-Stand.md`, Code unter `app/Domain/Cms`, `routes/web.php`, `resources/` | Ist-Zustand | + +**Designstudie, tatsächlich betrachtet:** `README.md`, `QUELLENMANIFEST.json`, `tokens.css`, `tokens.json`, `ANWEISUNG.md`; die drei Originalmotive Titel, Denkpause, Outro; beide KI-Konzeptgrafiken (`brand_ui_uebersicht_entwurf.png`, `homepage_entwurf.png`); die drei HTML-Vorlagen und `site.css` vollständig; die Bildschirmfotos Startseite (Desktop, mobil), Bibliothek (Desktop, mobil) und Player (Desktop). +**Nicht betrachtet:** die drei Figurenreferenzen (laut README nur intern), `player_mobil.png`, die fünf SVG-Entwürfe im Einzelnen und `design-prinzipien_vorlage_nutzer_2026-11-15.md`. Aussagen zu diesen Dateien enthält dieses Konzept nicht. + +### 2.3 Ausgangslage in Kürze [BELEGT] + +- Das öffentliche Seitensystem kennt sechs Bausteine (Überschrift, Fließtext, Bild und Text, Handlungsaufruf, Karten, FAQ), Entwurf, Vorschau, Veröffentlichung und Wiederherstellung. Es gibt keine Seitentypen, keine Vorlagen, keine Katalogbausteine, keine Unterpfade, keine Weiterleitungen, keine zeitgesteuerte Veröffentlichung, keine Social-Vorschau und keine strukturierten Daten. +- Veröffentlichte fachliche Säulen erscheinen als Themenbereiche unter `/themen`. Programme, Module und Angebote haben keine öffentlichen Seiten; Angebote sind nur im Mitgliederbereich sichtbar. +- Die laufende Oberfläche verwendet ein eigenes Erscheinungsbild (Source Sans 3, Source Serif 4, Kieferngrün `#0f6e56`). Das Brand-Kit ist nicht umgesetzt. +- `public/robots.txt` erlaubt alles. Ob die Testinstanz zusätzlich durch den Reverse Proxy geschützt ist, wurde nicht geprüft. +- Die Mitgliederbibliothek ist noch nach Lizenzartikeln gegliedert; der Umbau ist in den Paketen 0 bis 9 geplant und liegt zur Freigabe vor. + +--- + +## 3. Strategisches Zielbild und Positionierung + +### 3.1 Positionierung + +**[FEST]** Lara & Felix ist ein strukturiertes Konzept für Gewaltprävention und Selbstbehauptung, das erwachsene Trainer und pädagogische Fachkräfte bei Gruppenkursen unterstützt. Praktische Übungen stehen im Mittelpunkt, Filme sind Einstieg und Gesprächsanlass. Keine Schutzgarantie, kein automatischer Lernerfolg (`trainingskonzept`, §1). + +**[EMPF] Positionierungssatz für die Website:** + +> Lara & Felix ist das Trainingskonzept, mit dem Fachleute Selbstbehauptung und Gewaltprävention für Kinder vorbereiten und durchführen: Programme, Module, Übungen, Alltagsfilme und Trainerunterlagen, die zusammenpassen. + +**Abgrenzungen, die die Website sichtbar machen muss:** + +| Lara & Felix ist | Lara & Felix ist nicht | +|---|---| +| Material und Methode für Fachleute | ein Kursangebot, das Eltern für ihr Kind buchen | +| ein zusammenhängendes Konzept aus fünf Themenbereichen | eine Sammlung einzeln zu kaufender Filme | +| Unterstützung der Durchführung | Ersatz für eine Trainerausbildung (`trainingskonzept`, §3) | +| Handlungsmöglichkeiten üben | ein Sicherheitsversprechen | + +### 3.2 Was die Marke leisten muss + +Drei Nutzenversprechen tragen die gesamte Argumentation. Sie sind bewusst prüfbar formuliert und kommen ohne Wirkungsbehauptung aus: + +1. **Vorbereitungszeit sparen:** Ein Modul bringt Lernziel, Ablauf, Übungen, Film und Unterlagen mit. +2. **Fachlich sicher auftreten:** Methode und Grenzen sind erklärt; Trainerhinweise sind kurz und praktisch. +3. **Rechtlich sauber einsetzen:** Der Lizenzumfang ist je Angebot eindeutig, auch für kommerzielle Kurse. + +### 3.3 Vertrauen als Differenzierung [BELEGT, Sekundärquellen] + +Jugendring, Unfallversicherungsträger und Verbraucherpublikationen weisen darauf hin, dass es für Selbstbehauptungskurse keine geschützte Ausbildung gibt, dass Anbieter ohne pädagogische Vorbildung auftreten und dass Kurskonzepte als Kurzfortbildung verkauft werden (Q24). Diese Aussagen stammen aus Suchauszügen; die Originalpapiere sind vor einer öffentlichen Bezugnahme vollständig zu lesen. + +**[EMPF]** Daraus folgt für Lara & Felix: + +- Eine Seite **„Qualitätsverständnis“** im Bereich Konzept, die die eigenen Grundsätze nennt (keine Angstpädagogik, keine Garantie, Einbindung der Erwachsenen, Material ersetzt keine Qualifikation) und, soweit nach Lektüre zutreffend, auf veröffentlichte Qualitätskriterien verweist. +- **Benannte fachliche Verantwortung** auf jeder Fachseite: Autor, fachliche Prüfung, Stand. Qualifikationen nur, soweit sie belegbar sind (`design-prinzipien`, §7; `seo-prinzipien`, §4). +- **Zeigen statt behaupten:** ein vollständiges Modul kostenlos, statt eines Filmausschnitts. +- **Keine Bewertungssterne, keine Kundenzitate**, solange es keine echten und freigegebenen gibt. Der Baustein „Stimme“ bleibt gesperrt, bis ein Nachweisfeld gefüllt ist. + +### 3.4 Geschäftslogik hinter der Website + +| Hebel | Mechanismus | Stand | +|---|---|---| +| Einstieg | kostenloses Angebot mit eigenem Erwerb je Mitglied | [FEST] im Modell vorhanden (`04`, B8) | +| Erstkauf | Einzelmodul oder Programm je Nutzungszweck | Modell vorhanden; Preise und Lizenztypen **[OFFEN]** (OPEN-03) | +| Erweiterung | weitere Module, Programme, später gezielte Upgrades | Upgrades Stufe A2 | +| Bindung | jede spätere Fassung eines gekauften Artikels ist enthalten (VER-008) | [FEST]; als Verkaufsargument bisher ungenutzt | +| Institutionen | Organisationslizenz mit Sitzen, Kauf auf Rechnung | [FEST] erst ab Stufe A4 | +| Empfehlung | Trainerverzeichnis und Community | Stufe A3; siehe 4.3 | + +**[EMPF]** Die Updatezusage gehört prominent auf jede Angebotsseite. Sie ist ein belegbares, im System verankertes Versprechen und unterscheidet das Angebot von einem Dateikauf. + +### 3.5 Weitere Altersgruppen und Produktlinien + +**[FEST]** Altersbereich ist eine Fachdimension, Produktlinie ein Katalogmerkmal (`produktkonfiguration`, §3; `03`, 7.5). **[OFFEN]** ist, ob Altersvarianten eigene Produkte oder Fassungen sind (`produktkonfiguration`, §14). +**[EMPF]** Die Website behandelt das Alter als Filter und als Angabe auf Karten, nicht als Navigationsebene. Eine Navigationsebene „Altersstufe“ lohnt erst ab einer zweiten vollständigen Reihe; dann genügt ein Umschalter im Katalog. Eine zweite Produktlinie erhält einen eigenen Seitenbaum unter derselben Marke. + +--- + +## 4. Zielgruppen und Customer Journeys + +### 4.1 Zielgruppen + +Die Gliederung folgt dem Nutzungszweck des Rechteprofils (`04`, §3). Damit sprechen Website, Angebot und Lizenz dieselbe Sprache. + +| Gruppe | Entscheider und Geldquelle | Was überzeugt | Was hindert | Kaufweg heute möglich? | +|---|---|---|---|---| +| **Selbstständige Trainer** (Gewaltschutz, Selbstbehauptung; kommerziell) | selbst, eigenes Geld, schnelle Entscheidung | Zeitersparnis, professioneller Auftritt, klare kommerzielle Rechte | Sorge vor Abhängigkeit, unklare Lizenz | ja, als Einzelperson | +| **Vereinstrainer** (Karate, Kampfsport; meist ehrenamtlich) | Trainer regt an, Vorstand bezahlt | fertige Stundenbilder, Passung zur Hallensituation, niedriger Preis | Budget, Vereinsbeschluss | als Einzelperson ja; als Verein erst ab A4 | +| **Lehrkräfte, Schulsozialarbeit, pädagogische Fachkräfte** | Schulleitung, Förderverein, Träger | Einsatz in 45 oder 90 Minuten, Elterninformation, wenig Vorbereitung | Beschaffung auf Rechnung, Datenschutzfragen | privat ja; als Schule erst ab A4 | +| **Träger und Institutionen** | Leitung, Beschaffung | Verlässlichkeit, Rechnung, mehrere Nutzer, Ansprechpartner | fehlende Organisationslizenz | **nein**, erst ab A4 | + +**Nicht Zielgruppe der Plattform**, aber vermutlich die größte suchende Gruppe **[ANNAHME]:** Eltern. Sie kaufen nichts, sind aber Auftraggeber der Trainer und Publikum der Schule. Empfehlung in 4.3. + +**Unterschied ehrenamtlich und kommerziell [EMPF]:** Beide erhalten dieselbe fachliche Darstellung. Der Unterschied gehört ausschließlich in den Lizenzvergleich (Zweck, erlaubte Aktionen, Preis). Eine getrennte „Profi-“ und „Ehrenamt-Website“ würde Inhalte verdoppeln und suggerieren, das Material sei verschieden. + +### 4.2 Konsequenz aus dem ersten Verkaufsschnitt + +**[FEST]** Der erste Schnitt verkauft nur an Einzelpersonen; persönliche Lizenzen werden nicht als Organisationslizenz ausgegeben (`16`, ID-004). + +**[EMPF]** Die Website darf Institutionen bis Stufe A4 nichts versprechen, was nicht kaufbar ist. Sie erhält stattdessen eine ehrliche Seite „Für Schulen und Vereine“ mit Einsatzbeschreibung und einem Formular „Interesse an einer Einrichtungslizenz“. Die Zahl der Anfragen ist der Messwert, mit dem über das Vorziehen von A4 entschieden wird (`13`, E-23). + +### 4.3 Eltern und Trainerverzeichnis **[OFFEN]** + +Zwei Wege, beide vertretbar: + +- **Zurückhaltend (Empfehlung für den Start):** eine einzige Elternseite „Woran erkenne ich einen guten Kurs?“ als Vertrauens- und Verweisinhalt, keine eigene Navigation. +- **Ausbau mit Stufe A3:** Das im Kern geplante Trainerverzeichnis wird öffentlich auffindbar für Trainer, die das wünschen. Eltern und Schulen finden Trainer, die mit Lara & Felix arbeiten. Das wäre der stärkste Bindungshebel, weil die Plattform ihren Kunden Nachfrage bringt. Es setzt die Einwilligung je Angabe voraus (`09`, C.4) und erzeugt Erwartungen an die Qualität der gelisteten Trainer. Deshalb nicht im MVP. + +### 4.4 Customer Journeys (geprüft und geändert) + +**Journey A – Fachliche Frage** +Suchanfrage → Fachbeitrag oder Themenseite → passendes Modul → **kostenloses Modul abrufen** (Registrierung ist dabei Mittel, nicht Ziel) → Bibliothek → Angebot. +*Änderung gegenüber dem Auftrag:* Das Ziel ist der Abruf eines vollständigen Moduls, nicht die Registrierung. Jeder Fachbeitrag endet mit genau einem passenden Modul, nicht mit einer allgemeinen Angebotsliste. + +**Journey B – Konkreter Bedarf** +Landingpage je Einsatz („Kurs im Verein“, „Projektwoche in der Grundschule“) → Programmseite → enthaltene Module und Beispielmaterial → Lizenzvergleich → Kauf → Bibliothek öffnet das gekaufte Programm. +*Änderung:* Der Lizenzvergleich steht auf der Programmseite selbst (Baustein), nicht nur auf einer getrennten Preisseite. Nach dem Kauf landet der Nutzer im gekauften Programm, nicht auf einer Bestellübersicht. + +**Journey C – Bestandstrainer** +Bibliothek → Hinweis „Neue Fassung“ oder „Passt zu Ihrem Programm“ → Moduldetail mit ehrlichem Status (nutzbar, teilweise, nicht enthalten) → Angebot. +*Änderung:* Erweiterungshinweise stehen im fachlichen Zusammenhang (im Programm, an der fehlenden Stelle), nie als Werbefläche über der Bibliothek. Grundlage ist der Status „teilweise nutzbar“ (`produktkonfiguration`, §10). + +**Journey D – Institution** +Seite „Für Schulen und Vereine“ → Einsatzmöglichkeiten → **Unterlage zum Weitergeben** (eine Seite für Leitung oder Vorstand) → Anfrageformular. Ab A4: Organisationsangebot, Kauf auf Rechnung. +*Änderung:* Bis A4 endet die Journey in einer Anfrage, nicht in einem Kauf. Die druckbare Kurzunterlage ist der wichtigste Baustein, weil in Institutionen nicht die suchende Person entscheidet. + +**Journey E – Empfehlung (neu)** +Trainer erzählt Kollegin vom Material → Kurzadresse eines Programms → Programmseite → kostenloses Modul. +*Anforderung:* kurze, stabile Adressen und eine Seite, die ohne Vorwissen in 30 Sekunden erklärt, was das Programm ist. + +**Journey F – Wiederkehr (neu)** +Mitteilung „Neue Fassung Ihres Moduls“ (VER-008) → Bibliothek → Änderungshinweis. +*Anforderung:* Die Mitteilung ist Service aus dem Vertragsverhältnis, kein Newsletter; die Unterscheidung ist rechtlich zu prüfen (Kapitel 13). + +### 4.5 Abgeleitete Anforderungen + +| Anforderung | Quelle | Betrifft | +|---|---|---| +| Ein Modul als kostenloser Einstieg, abrufbar in zwei Schritten | A, E | Angebot, Registrierung | +| Lizenzvergleich als einbettbarer Baustein | B | CMS, Katalog | +| Einstieg nach dem Kauf im gekauften Programm | B | Mitgliederbereich | +| Status „teilweise nutzbar“ mit Verweis auf das passende Angebot | C | Bibliothek | +| Anfrageformular mit Auswertung nach Art der Einrichtung | D | CMS, Marketingdaten | +| Druckbare Kurzunterlage je Programm | D | Seitentyp, Druckansicht | +| Kurze stabile Adressen, Weiterleitungen bei Umbenennung | E | SEO-Technik | +| Herkunft des ersten Besuchs am Konto festhalten (Landingpage, Kampagne) | alle | Marketingdaten, Datenschutz | + +--- + +## 5. Bewertung der Designstudie + +### 5.1 Einordnung + +**[BELEGT]** Das Kit bezeichnet sich selbst als Arbeitsstand ohne Markenfreigabe: Farbwerte sind aus Bildern abgeleitete Vorschläge, das Logo liegt in voneinander abweichenden Varianten vor, die Konzeptgrafiken sind KI-erzeugt und enthalten erfundene Titel, Preise und Texte (`Brand-UI-Kit/README.md`). + +Das Kit besteht aus zwei sehr unterschiedlichen Teilen: + +- **Die HTML-Vorschau** (`05_web_preview`): ruhig, erwachsen, mit viel heller Fläche, klarer Hierarchie und sparsamen Akzenten. Sie entspricht dem Ton, den die Design-Prinzipien für Plattform und Vermarktung verlangen. +- **Die KI-Konzeptgrafiken** (`04_visuelle_entwuerfe`): bunter, dichter, mit großen Kindergesichtern, Filmkarten mit Laufzeit, „Beliebte Filme“, Warenkorb und Preis. Sie entsprechen der überholten Lesart als Filmshop und der Posterästhetik, die die Prinzipien ausdrücklich ausschließen (§14). + +**[EMPF]** Maßstab für die Weiterentwicklung ist die HTML-Vorschau. Die Konzeptgrafiken dienen nur noch als Beleg für die Markenelemente (Wortmarke, Strahlen, Denkblase), nicht für Layout oder Inhalt. + +### 5.2 Was trägt + +| Element | Begründung | +|---|---| +| Farbdreiklang Dunkelblau, Grün, Gelb auf hellen warmen Flächen | stammt aus den Originalmotiven, ist eigenständig und deckt sich mit `design-prinzipien`, §5 | +| Fotografische, sonnige Bildwelt | einziges Markenelement, das Wettbewerber nicht kopieren können | +| Denkpause als didaktisches Symbol | benennt den methodischen Kern; richtig als Funktionsmotiv, nicht als Dekor | +| Gelbe Unterstreichung und Strahlen als sparsamer Akzent | wiedererkennbar und leicht | +| Kennzeile über Überschriften („Flag“), Pillen-Schaltflächen, runde Karten | konsistente, ruhige Grundformen | +| Token-Datei mit Abständen und Radien | brauchbarer Anfang eines Systems | +| Hinweis „Demo, kein echter Artikel“ und `noindex` in den Vorlagen | richtige Haltung zu erfundenen Inhalten | + +### 5.3 Was nicht trägt + +**Fachlich (Produktstrategie):** + +1. Hauptnavigation „Filme & Materialien“, Startseitenaufruf „Filme entdecken“, Abschnitt „Filme und Materialien“: Der Medientyp ist die Ordnung, nicht das Trainingsziel. Widerspricht `trainingskonzept`, §8 und `design-prinzipien`, §7. +2. Angebotskarte „Filmprogramm, 29,90 €, In den Warenkorb“: Shop-Muster mit erfundenem Preis; es gibt keinen Warenkorb (`16`, 3.3) und keine Preisentscheidung. +3. Bibliothek mit Filter nach Dateiart und Karten je Lizenzartikel: genau die flache Sicht, die `produktkonfiguration`, §1 als unzureichend bezeichnet. +4. Player als eigener Seitentyp mit Denkpause als Titel: Der didaktische Kursplayer ist Add-on (`produktkonfiguration`, §1). +5. Die fünf Themenbereiche kommen in der gesamten Studie nicht vor, obwohl sie die verbindliche öffentliche Gliederung sind (`design-prinzipien`, §3). + +**Gestalterisch und technisch (prüfbar):** + +| Befund | Nachweis | Folge | +|---|---|---| +| Weiße Schrift auf Markengrün `#5B8625` | Kontrast etwa 4,3:1 (eigene Berechnung nach WCAG-Formel); verlangt sind 4,5:1 für Text unter etwa 18,7 px fett | Schaltflächen mit 14 px Schrift verfehlen AA. `#3B7B09` erreicht etwa 5,2:1. | +| Grüner Kleintext der Kennzeile auf hellem Grund | etwa 4,1:1 bei 11 px | für Text das dunklere Grün verwenden | +| Gelb `#FCD10A` | auf Weiß etwa 1,5:1, mit Dunkelblau als Schrift etwa 10:1 | Gelb nie als Textfarbe und nie als alleiniger Zustandsträger | +| Schriften per `@import` von Google | `site.css`, Zeile 1 | lokal ausliefern; bekanntes Datenschutzrisiko in Deutschland | +| Die Bildschirmfotos zeigen sichtbar eine Ersatzschrift statt Nunito | Beobachtung am Bild; Ursache nicht geprüft | die Studie ist typografisch nie in ihrer Zielschrift beurteilt worden | +| Schriftangaben widersprechen sich | Token: Nunito und Nunito Sans; Übersichtsgrafik: Nunito/Baloo 2 und Inter/Source Sans 3; laufende Anwendung: Source Sans 3 und Source Serif 4 | Entscheidung nötig (7.2) | +| Wortmarke als gedrehter CSS-Text | `site.css`, `.brand` | kein Logo; eine SVG-Wortmarke fehlt | +| Titelmotiv mit eingebettetem Logo als Heldenbild unter einer Kopfzeile mit Logo | Bildschirmfoto Startseite | doppelte Marke, angeschnittener Schriftzug; Heldenbilder brauchen textfreie Zuschnitte | +| Dasselbe Motiv auf allen Karten | Bibliothek, Startseite | zeigt, dass das Bildmaterial für einen Katalog nicht reicht; Fallback-Grafiken und Themen-Signaturen sind Pflicht | +| Zwei Umbruchpunkte (980, 680 px), keine Typografieskala, keine Zustände, keine Formulare | `site.css` | kein Designsystem, sondern drei Einzelseiten | + +Die Kontrastwerte sind eine Rechnung, keine Messung an der gerenderten Seite. Sie sind vor der Farbfreigabe mit einem Prüfwerkzeug zu bestätigen. + +### 5.4 Was vollständig fehlt + +Themen-Signaturen (fünf Symbole mit Mehrfachzuordnung); Programm- und Modulkarte; Programm-, Modul-, Themen-, Landing-, Angebots- und Artikelseite; Lizenzvergleich als Tabelle mit mobiler Form; Lernziel- und Ablaufdarstellung; Materialliste nach Rolle; Statusanzeigen für nutzbar, teilweise, gesperrt; Formulare mit Fehlerzuständen; Suche und Filter mit mobilem Verhalten; Leer-, Lade- und Fehlerzustände; Breadcrumb; Fußbereich mit Rechtstexten; Druckansicht; Vorgaben für Bildzuschnitte; semantische Zustandsfarben außer Fehler und Fokus. + +### 5.5 Weiterentwicklung ohne Neustart + +Die Marke bleibt, die Grammatik wird ergänzt: + +1. **Wortmarke** als freigegebene SVG in drei Fassungen (voll, kompakt, Monogramm). Keine Drehung, keine KI-Nachzeichnung. +2. **Farben** aus den Originalmotiven bestätigen, um eine dunklere Textvariante des Grüns und um Zustandsfarben ergänzen. +3. **Fünf Themen-Signaturen** als neue, tragende Ebene zwischen Marke und Inhalt. +4. **Bildsprache in drei Rollen:** Keyvisual (selten, nur Start und Kampagne), Szenenbild (belegt Einsatz), Signatur und Fallback (überall dort, wo kein freigegebenes Bild existiert). +5. **Denkpause** bleibt, wandert aber aus dem Player in die Erklärung der Methode und in die didaktischen Bausteine. + +--- + +## 6. Design-Transformationsmatrix + +| Bestehendes Element | Ursprünglicher Zweck | Fachliche Eignung | Empfehlung | Zielverwendung | +|---|---|---|---|---| +| Farbdreiklang Dunkelblau, Grün, Gelb | Markenfarben aus Filmmotiven | hoch | **Beibehalten**, Werte freigeben | Markenebene der Tokens | +| Markengrün `#5B8625` als Schaltflächenfläche mit weißer Schrift | Hauptaktion | Kontrast unzureichend | **Weiterentwickeln** | Fläche in `#3B7B09` oder gleichwertig; helleres Grün nur für Flächen ohne Text | +| Gelb als Akzent (Unterstreichung, Strahlen, Fortschritt) | Aufmerksamkeit | hoch, wenn sparsam | **Beibehalten** | Auszeichnung von Kernaussagen, nie Text | +| Creme- und Papierflächen | Ruhe | hoch | **Beibehalten** | Flächenebenen der Seite | +| Wortmarke in drei Bildvarianten, CSS-Schriftzug | Logo | uneinheitlich, nicht skalierbar | **Ersetzen** | freigegebene SVG-Wortmarke | +| Monogramm-Entwurf | Favicon | geeignet nach Prüfung | **Weiterentwickeln** | Favicon, PWA-Symbol | +| Titelmotiv mit Schrift | Filmtitel | als Webbild ungeeignet (Text im Bild) | **Weiterentwickeln** | textfreie Zuschnitte als Keyvisual; Original nur im Filmzusammenhang | +| Outro-Motiv mit Freifläche | Abspann | gut als Hintergrund, wenn Logo entfernt | **Weiterentwickeln** | Heldenbild mit HTML-Text | +| Denkpause-Motiv und Denkblase | Filmpause | hoch als Methodensymbol | **Beibehalten**, Einsatz verengen | Methodik, didaktische Bausteine, späterer Kursplayer | +| Hand-Symbol | Pause | passt auch zu „Meine Grenzen“ | **Weiterentwickeln** | Ausgangspunkt der Signaturfamilie | +| Kennzeile („Flag“) | Abschnittsmarke | hoch | **Beibehalten**, Textfarbe anpassen | Abschnitts- und Typkennzeichnung | +| Pillen-Schaltflächen | Aktionen | hoch | **Beibehalten** | drei Ränge: Haupt, Neben, Text | +| Dreispaltige Merkmalskarten (erleben, nachdenken, üben) | Ansatz erklären | hoch, entspricht der Methodenkommunikation | **Weiterentwickeln** | Baustein „Methode in Schritten“, vier Schritte laut `seo-prinzipien`, §4 | +| Medienkarte mit Foto und Typmarke | Film- und Materialkarte | Grundform gut, Inhalt falsch | **Weiterentwickeln** | Programm-, Modul- und Materialkarte mit Signaturen, Altersangabe und Status | +| Filmkarte mit Laufzeit und Abspielsymbol (Konzeptgrafik) | Film verkaufen | filmzentriert | **Ersetzen** | Materialbeispiel im Zusammenhang eines Moduls | +| Abschnitt „Beliebte Filme & Programme“ | Verkaufsanreiz | erfundene Beliebtheit, falsche Ordnung | **Ersetzen** | Programme nach Trainingsziel, Themenübersicht | +| Angebotskarte mit Preis und Warenkorb | Shop | Muster passt nicht zu Lizenzen | **Neu konzipieren** | Angebotskarte mit Umfang und Zweck, Lizenzvergleich | +| Hauptnavigation Start, Filme & Materialien, Methodik | Einstieg | filmzentriert | **Ersetzen** | Navigation nach Kapitel 8 | +| Heldenbereich mit Text rechts über Bild | Einstieg | Aufbau gut, Aussage falsch | **Weiterentwickeln** | drei Heldenvarianten mit konzeptbezogener Aussage | +| Bibliothek mit Seitenleiste und Typfilter | Mitgliederbereich | Aufbau brauchbar, Gliederung überholt | **Weiterentwickeln** | Sichten Programme, Module, Materialien, Lizenzen (`produktkonfiguration`, §8) | +| Statusmarke „Zugang aus Berechtigung“ | Rechtehinweis | zu technisch | **Ersetzen** | Verfügbarkeit in Trainersprache: nutzbar, teilweise, nicht enthalten | +| Hinweiskasten zur Lizenzansicht | Entwicklerhinweis | kein Nutzerinhalt | **Ersetzen** | Sicht „Meine Lizenzen“ | +| Playerseite mit Denkpause-Titel | Kursdurchführung | Add-on | **Zurückstellen**, Gestaltung aufbewahren | einfacher Player im Moduldetail; Kursplayer später | +| Fortschrittsbalken in Gelb | Player | gut | **Beibehalten** | Standardplayer | +| Dunkelblauer Fußbereich | Abschluss | gut, inhaltlich leer | **Weiterentwickeln** | Fußbereich mit Rechtstexten, Kontakt, Themen | +| Token-Dateien (CSS, JSON) | Übergabe | Anfang, unvollständig | **Weiterentwickeln** | zweistufige Tokens nach Kapitel 7 | +| Schriftwahl Nunito und Nunito Sans über Google | Anmutung | Anmutung passend, Einbindung nicht | **Weiterentwickeln** | lokale Auslieferung; Entscheidung 7.2 | +| Symbolzeichen als Unicode-Zeichen (▣, ?, ✓, ⌂) | Platzhalter | nicht barrierearm, uneinheitlich | **Ersetzen** | eigene Symbolfamilie als SVG | +| Kinderporträts als große Flächen | Emotion | Posterästhetik, Rechte ungeklärt | **Weiterentwickeln** | Szenenbilder im Einsatzzusammenhang, sparsam | +| — | — | — | **Neu konzipieren** | Themen-Signaturen, Lizenzvergleich, Lernziele, Ablauf, Materialliste, Formulare, Zustände, Druckansicht, Artikelvorlage | + +--- + +## 7. Empfohlenes Designsystem + +Alle Angaben in diesem Kapitel sind **[EMPF]**, soweit nicht anders gekennzeichnet. Zahlenwerte sind Ausgangswerte für den Entwurf, keine Freigabe. + +### 7.1 Aufbau in zwei Tokenebenen + +| Ebene | Inhalt | Wer ändert | +|---|---|---| +| **Markenwerte** | die freigegebenen Farbtöne, Schriftfamilien, Radien, Grundabstand | selten, mit Freigabe | +| **Bedeutungswerte** | `text`, `text-leise`, `fläche`, `fläche-abgesetzt`, `linie`, `aktion`, `aktion-text`, `akzent`, `fokus`, `erfolg`, `hinweis`, `warnung`, `fehler` und je Themenbereich `thema-n` | Entwicklung; verweisen auf Markenwerte | + +Bausteine verwenden ausschließlich Bedeutungswerte. Dadurch bleibt eine spätere Farbkorrektur eine Änderung an einer Stelle. **[FEST]** Marken- und Zustandsfarben sind getrennt zu definieren (`design-prinzipien`, §5). + +**Farbregeln:** + +- Text und Navigation in Dunkelblau; Fließtext in einem leicht aufgehellten Dunkelton. +- Aktion: dunkles Grün mit weißer Schrift, Mindestkontrast 4,5:1 nachgewiesen. +- Gelb nur als Fläche oder Linie, immer mit dunkler Schrift. +- Zustandsfarben tragen immer zusätzlich Symbol und Text. +- Jede Farbkombination, die Text trägt, steht mit gemessenem Kontrast in einer Tabelle des Systems. + +### 7.2 Typografie + +| Rolle | Vorschlag | Begründung | +|---|---|---| +| Auszeichnung (H1, H2, Kennzahlen) | Nunito, lokal ausgeliefert | rund und freundlich, nah an der Wortmarke; nur in großen Graden | +| Lesen und Bedienen (Fließtext, Formulare, Navigation, Tabellen) | Source Sans 3 | bereits lokal in der Anwendung vorhanden, sehr gut lesbar, ruhiger als Nunito Sans | +| Serifenschrift | entfällt | zwei Familien genügen | + +Lizenz und Dateien beider Schriften sind vor der Übernahme zu prüfen **[ANNAHME: freie Lizenz]**. **[OFFEN]:** Alternativ beide Rollen mit Nunito Sans (einheitlicher, etwas kindlicher). + +**Skala** (mobil → Desktop, fließend): Fließtext 17 → 18 px, Zeilenhöhe 1,6; klein 14 → 15 px; H3 20 → 22; H2 26 → 34; H1 34 → 52; Zeilenlänge für Lesetext höchstens etwa 70 Zeichen. Überschriften mit leicht negativer Laufweite nur in der Auszeichnungsschrift. + +### 7.3 Raster, Abstände, Umbruchpunkte + +| Thema | Festlegung | +|---|---| +| Grundabstand | 4 px; Abstufungen 4, 8, 12, 16, 24, 32, 48, 64, 96 | +| Abschnittsabstand | 48 px mobil, 96 px Desktop | +| Container | Lesebreite etwa 720 px, Inhaltsbreite etwa 1200 px | +| Raster | 4 Spalten mobil, 8 Tablet, 12 Desktop | +| Umbruchpunkte | 640, 1024, 1280 px; Prüfbreiten 390, 768, 1440 px (`design-prinzipien`, §13) | +| Radien | 8, 14, 22 px, Pille; Karten 14, große Flächen 22 | +| Schatten | eine einzige weiche Stufe für anhebbare Flächen; sonst Linie | + +Bausteine richten sich nach der Breite ihres Containers, nicht nach der Fensterbreite, damit sie in ein-, zwei- und dreispaltigen Abschnitten funktionieren. + +### 7.4 Die fünf Themen-Signaturen + +**[FEST]** Verlangt ist eine zusammengehörige Familie aus Symbol, Bezeichnung und gegebenenfalls Farbakzent; ohne Farbwahrnehmung unterscheidbar; Mehrfachzuordnung möglich (`design-prinzipien`, §3). + +**[EMPF] Anforderungen an den Entwurf:** + +- Symbol und Nummer tragen die Unterscheidung, die Farbe unterstützt nur. Fünf laute Farben würden die Marke zerlegen. +- Farbakzente als fünf gedämpfte Tönungen aus einer abgestimmten Reihe, jede mit dunkler Schrift lesbar. +- Drei Größen: Marke (Symbol 20 px in Karten), Kennzeile (Symbol und Name), Bühne (Symbol groß auf Themenseite). +- Mehrfachzuordnung als Reihe von bis zu drei Marken, danach „+2“. +- Die Signaturen ersetzen Fotos überall dort, wo kein freigegebenes Bild existiert. Sie sind damit zugleich die Lösung für das dünne Bildmaterial. +- Die Symbole sind im CMS je Säule gepflegt (Datei, Tönung), weil Säulen konfigurierbare Werte sind (`produktkonfiguration`, §3). Eine sechste Säule braucht ein sechstes Symbol, keinen Programmierauftrag. + +Leitideen je Bereich stehen in `design-prinzipien`, §3. Der Entwurf selbst ist eine Gestaltungsaufgabe für Stufe W0. + +### 7.5 Komponenten: markenspezifisch oder Standard + +| Familie | Komponenten | Gestaltung | +|---|---|---| +| Marke | Wortmarke, Themen-Signatur, Heldenbereich, Methoden-Schritte, Denkpause, Merksatz, gelbe Auszeichnung | **eigen**, hier entsteht die Wiedererkennung | +| Inhalt | Programmkarte, Modulkarte, Materialzeile, Lernziele, Ablauf, Bestandteile nach Rolle, Angebotskarte, Lizenzvergleich, Artikelkopf mit Autor und Stand | **eigen**, weil sie das Produktmodell abbilden | +| Navigation | Kopfzeile, mobile Navigation, Breadcrumb, Fußbereich, Seitenleiste des Mitgliederbereichs, Registerleiste | eigen im Aussehen, übliches Verhalten | +| Bedienung | Schaltfläche, Link, Eingabefeld, Auswahl, Kontrollkästchen, Suchfeld, Filterleiste mit mobilem Auszug, Dialog, Hinweis, Aufklappbereich, Tabelle, Seitenwechsel | **Standardmuster**, nur mit Tokens eingefärbt | +| Rückmeldung | Statusmarke, Hinweisband, Leerzustand, Ladezustand, Fehlerzustand | Standardmuster mit eigener Sprache | +| Medien | Bild mit Zuschnittsregel, öffentliche Filmvorschau, einfacher Player, Dokumentzeile | Standardplayer des Browsers mit eigener Rahmung | + +Die Verwaltung bleibt Filament in Standardgestaltung. **[FEST]** Der Mitgliederbereich ist keine umbenannte Verwaltung (`design-prinzipien`, §8). + +### 7.6 Zustände und barrierearme Muster + +- Jede bedienbare Komponente hat Normal, Hover, Fokus, Aktiv, Deaktiviert; Daten tragende Komponenten zusätzlich Laden, Leer, Fehler. +- Sichtbarer Fokusrahmen in eigener Farbe, mindestens 3 px, auf allen Flächen sichtbar. +- Trefferfläche mindestens 44 × 44 px. +- Tabellen werden mobil zu gestapelten Karten mit wiederholter Zeilenbeschriftung, nicht zu waagerechtem Rollen. +- Aufklappbereiche und Dialoge mit den üblichen Rollen und Tastaturwegen; Bewegung nur mit `prefers-reduced-motion`-Rücksicht. +- Formulare: sichtbare Beschriftung, Fehlertext am Feld, Zusammenfassung oben, keine Platzhalter als Beschriftung. +- Bilder: Alternativtext ist Pflichtfeld oder ausdrücklich „dekorativ“. + +### 7.7 Bildregeln + +- Heldenbilder ohne eingebetteten Text, mit festgelegtem Fokuspunkt für mobile Zuschnitte. +- Drei Seitenverhältnisse im System: 16:9 (Bühne), 4:3 (Karte), 1:1 (Marke). +- Jedes öffentlich verwendete Bild hat einen Eintrag im Asset-Katalog mit Freigabestatus (`design-prinzipien`, §4.1). Ein Standbild aus einem geschützten Film ist nicht automatisch öffentlich (`produktkonfiguration`, §5). + +--- + +## 8. Neue Informationsarchitektur + +### 8.1 Hauptnavigation + +**[FEST]** Die Navigation folgt dem Nutzerversprechen: Konzept, fünf Themenbereiche, Programme und Module, Anwendung für Trainer, Angebote, Mitgliederbereich (`design-prinzipien`, §7). + +**[EMPF]** + +``` +Konzept · Themen · Programme · Für wen · Angebote · Wissen [Anmelden] [Kostenlos starten] +``` + +| Eintrag | Inhalt | Art | +|---|---|---| +| **Konzept** | Idee, Methode in Schritten, Qualitätsverständnis, Einsatz im Kurs | redaktionelle Seiten | +| **Themen** | Übersicht der fünf Bereiche, je Bereich eine Themenseite | dynamisch aus Säulen, redaktionell gerahmt | +| **Programme** | Programme und Module, umschaltbar, mit Filter | dynamischer Katalog | +| **Für wen** | Trainer, Vereine, Schulen, Einrichtungen | Landingpages aus Vorlage | +| **Angebote** | kaufbare Zusammenstellungen, Lizenzvergleich, kostenloses Angebot | dynamisch aus Angebotsfassungen | +| **Wissen** | Fachbeiträge, Hilfe und häufige Fragen | redaktionell; **erst in der Navigation, wenn mindestens sechs Beiträge veröffentlicht sind**, bis dahin im Fußbereich | + +Mobil: dieselben sechs Einträge im Auszug, „Kostenlos starten“ bleibt in der Kopfzeile sichtbar. Fußbereich: Über uns, Kontakt, Hilfe, Rechtstexte, die fünf Themen als Liste. + +**Bewusst kein eigener Einstieg:** Filme, Übungen, Materialien. Sie erscheinen im Zusammenhang von Modul und Programm. Ein Katalogfilter „enthält Film“ genügt. + +### 8.2 Seitenbaum und Adressen + +| Bereich | Adresse | Quelle | Indexierbar | +|---|---|---|---| +| Start | `/` | Seite | ja | +| Konzept | `/konzept`, `/konzept/methode`, `/konzept/qualitaet` | Seite | ja | +| Themenübersicht | `/themen` | Säulen | ja | +| Themenseite | `/themen/{thema}` | Säule und Seite | ja | +| Programmkatalog | `/programme` | Katalog | ja (ohne Filterparameter) | +| Programm | `/programme/{programm}` | öffentliches Profil der Komposition | ja | +| Modulkatalog | `/module` | Katalog | ja (ohne Filterparameter) | +| Modul | `/module/{modul}` | öffentliches Profil | ja, wenn Mindestinhalt erfüllt | +| Materialbeispiel | `/beispiele/{material}` | öffentliches Profil eines freigegebenen Materials | nur bei eigenem Informationswert | +| Zielgruppe | `/fuer/{gruppe}` | Seite aus Vorlage | ja | +| Angebotsübersicht | `/angebote` | Angebotsfassungen | ja | +| Angebot | `/angebote/{angebot}` | Angebotsfassung | ja | +| Kostenlos | `/kostenlos` | kostenloses Angebot | ja | +| Wissen | `/wissen`, `/wissen/{beitrag}` | Seite Typ Beitrag | ja | +| Hilfe | `/hilfe`, `/hilfe/{frage}` | Seite | ja | +| Über uns, Kontakt | `/ueber-uns`, `/kontakt` | Seite | ja | +| Rechtstexte | `/impressum`, `/datenschutz`, `/agb`, … | Seite, Wortlaut der Vertragstexte aus dem Kern | ja, ohne Sitemap-Priorität | +| Kampagnenseite | `/aktion/{name}` | Seite aus Vorlage | je Seite wählbar, Voreinstellung nein | +| Filteransichten | `/programme?thema=…` | Katalog | nein, kanonisch auf die Übersicht | +| Anmeldung, Registrierung | `/anmelden`, `/registrieren` | Anwendung | nein | +| Mitgliederbereich | `/bereich/…` | Anwendung | nein, zusätzlich geschützt | + +**Regeln:** + +- Ein Fachobjekt hat genau eine öffentliche Adresse. Dieselbe Übung in zwei Programmen hat eine Modulseite, auf die beide Programme verweisen. +- Höchstens zwei Ebenen. Adressen ändern sich bei Umbenennung nur bewusst und erzeugen eine Weiterleitung. +- **[FEST]** „Programm“ und „Modul“ sind Werte der konfigurierbaren redaktionellen Inhaltsart, die je Identität ausdrücklich gesetzt wird. Der technische Strukturtyp `CompositionKind` (`kurs`, `uebung`, `kombination`) bleibt unverändert und wird nicht umgedeutet (Ist-Soll-Abgleich, Entscheidung E-T). +- **[EMPF]** Seitentyp und Adresspräfix folgen der stabilen Kennung der Inhaltsart: `programm` → `/programme`, `modul` → `/module`. Ohne gesetzte Inhaltsart gibt es keine öffentliche Seite; die technische Bezeichnung erscheint öffentlich nie. Weitere Inhaltsarten können als Materialbeispiel erscheinen. + +### 8.3 Verlinkungsmodell + +```mermaid +flowchart LR + B["Fachbeitrag"] --> T["Themenseite"] + B --> M["Modul"] + T --> M + T --> P["Programm"] + P --> M + M --> P + P --> A["Angebot"] + M --> A + Z["Zielgruppenseite"] --> P + Z --> A + A --> P + M --> F["Kostenloses Modul"] + K["Konzept"] --> T +``` + +Jede Kante ist ein Baustein, der seine Ziele aus den Fachdaten liest: „Module dieses Themas“, „Enthalten in“, „Passende Angebote“, „Mehr zum Thema“. Redaktionelle Links im Fließtext kommen hinzu, ersetzen diese Bausteine aber nicht. + +--- + +## 9. Zentrale Seitentypen und UX-Konzepte + +### 9.1 Ein Fachobjekt, drei Darstellungen + +**[FEST]** Seiten lesen verbindliche Angaben aus den veröffentlichten Fachobjekten; redaktionelle Texte ergänzen, widersprechen aber nicht (`seo-prinzipien`, §6; `09`, A.3). + +| Darstellung | Frage des Besuchers | Maßgebliche Daten | Redaktioneller Anteil | Kanonische Adresse | +|---|---|---|---|---| +| **Fachliche Programmseite** | Was ist das, wie ist es aufgebaut? | Komposition: Stammdaten, Lernziele, Module, Rollen | Einleitung, Bild, Einsatzhinweise | `/programme/{programm}` | +| **Landingpage** | Passt das zu meiner Lage? | dieselbe Komposition über Katalogbausteine | Ansprache, Problem, Nutzen, Beispiele | `/fuer/…` oder `/aktion/…` | +| **Angebotsseite** | Was genau kaufe ich? | Angebotsfassung: aufgelöster Umfang, Rechte, Preis, Laufzeit | kurze Erläuterung, keine Leistungsangaben | `/angebote/{angebot}` | + +Die Landingpage ist kein Duplikat der Programmseite: Sie enthält eigene Argumentation und verweist auf die Programmseite als fachliche Quelle. Preise und Rechte sind auf keiner Seite frei eintippbar. + +**Was öffentlich werden kann.** Der Bibliotheksplan trennt technische Bereitschaft und Anzeigefreigabe einer Fassung (Entscheidung E-A). Die Website setzt darauf auf: + +| Zustand | Bedeutung | Sichtbar für | +|---|---|---| +| technisch bereit | Fassung ist vollständig und unveränderlich | niemanden | +| zur Anzeige freigegeben | redaktionelle Freigabe genau dieser Fassung | berechtigte Mitglieder in der Bibliothek | +| öffentlich gelistet | eigene Entscheidung an der Identität | alle, auf der Objektseite | + +Öffentlich gezeigt wird nur eine Fassung, die zur Anzeige freigegeben ist. Ein Programm, das als eigener Lizenzartikel verkauft wird, zeigt die Fassung seines aktuellen Stands. Ein Programm, das nur über mehrere Modul-Artikel abgedeckt ist, zeigt eine von der Redaktion bestätigte freigegebene Fassung; das System schlägt die höchste vor. Enthaltene Module erscheinen auf der Programmseite immer als Struktur. Eine eigene Modulseite gibt es nur mit eigener Anzeigefreigabe, und verlinkt wird sie nur, wenn sie dieselbe Fassung zeigt wie das Programm. Einzelheiten: Zielarchitektur, 6.2. + +**Lücke:** Lernziele, Zeit- und Materialbedarf haben heute keine Felder und stehen in keinem Bibliothekspaket. Bis sie bestehen, zeigen Programm- und Modulseite Kurzbeschreibung und Struktur (Entscheidung E-W12). + +### 9.2 Wireframe-Konzepte + +Schreibweise: Abschnitte von oben nach unten. **K** = Katalogdaten, **R** = redaktionell, **G** = globaler Abschnitt. + +#### 1. Startseite + +*Aufgabe:* in zehn Sekunden klären, was Lara & Felix ist, für wen, und den nächsten Schritt anbieten. + +| Nr. | Abschnitt | Inhalt | Quelle | +|---|---|---|---| +| 1 | Bühne | Kennzeile „Für Trainer und pädagogische Fachkräfte“; Aussage zum Konzept; zwei Aktionen: „Kostenloses Modul ansehen“, „So funktioniert das Konzept“; textfreies Keyvisual | R | +| 2 | Wofür | drei Sätze: Problem, Ansatz, was der Trainer erhält | R | +| 3 | Methode in Schritten | Situation erleben, nachdenken, ausprobieren, übertragen; Denkpause-Symbol am zweiten Schritt | G | +| 4 | Fünf Themenbereiche | fünf Signaturen mit Lernschwerpunkt in einem Satz | K | +| 5 | Programme | zwei bis drei Programmkarten mit Ziel, Umfang, Alter | K | +| 6 | So sieht ein Modul aus | ein aufgeklapptes Beispielmodul: Lernziel, Ablauf, Materialien | K und R | +| 7 | Für wen | drei Einstiege: Trainer, Vereine, Schulen | R | +| 8 | Vertrauen | fachliche Verantwortung, Qualitätsverständnis, Updatezusage | G | +| 9 | Abschluss | kostenloses Modul | G | + +*Navigation:* Hauptnavigation, Fußbereich. *Aktionen:* kostenloses Modul, Konzept, Programm öffnen. +*Mobil:* Bild über dem Text, eine Hauptaktion; Themen als waagerecht wischbare Reihe mit sichtbarem Anschnitt; Abschnitt 6 eingeklappt. + +#### 2. Themenseite + +*Aufgabe:* einen Lernschwerpunkt fachlich erschließen und zu den passenden Modulen führen. Zugleich die wichtigste Zielseite für Suchanfragen. + +| Nr. | Abschnitt | Quelle | +|---|---|---| +| 1 | Bühne mit Signatur, Name, Lernschwerpunkt | K | +| 2 | Einordnung: worum es geht, warum in diesem Alter | R | +| 3 | Was Kinder üben: Übungsbeispiele | R, optional K | +| 4 | Module dieses Themas, mit Kennzeichen direkt oder über enthaltene Inhalte zugeordnet | K | +| 5 | Programme, die das Thema behandeln | K | +| 6 | Beispielmaterial: freigegebene Vorschau | K | +| 7 | Häufige Fragen von Trainern | R | +| 8 | Weiterlesen: Fachbeiträge | K | +| 9 | Abschluss: kostenloses Modul oder passendes Angebot | G | + +*Besonderheit:* Mehrfachzuordnung zeigt Nachbarthemen als kleine Signaturen an der Modulkarte. *Mobil:* Sprungmarken als waagerechte Leiste unter der Bühne. + +#### 3. Programmseite + +*Aufgabe:* zeigen, wie ein Trainer mit dem Programm arbeitet (`trainingskonzept`, §6). + +| Nr. | Abschnitt | Quelle | +|---|---|---| +| 1 | Kopf: Titel, Kurzbeschreibung, Themen-Signaturen, Alter, Umfang (Zahl der Module, Zeitbedarf) | K | +| 2 | Trainingsziel und Lernziele | K | +| 3 | Aufbau: Module in Reihenfolge, je Modul Titel, Ziel, Dauer, enthaltene Materialarten; aufklappbar | K | +| 4 | Durchführung: Raum, Gruppengröße, Technik, Varianten | K und R | +| 5 | Einblick: ein Modul vollständig oder Beispielmaterial | K | +| 6 | Lizenz: Lizenzvergleich für die Angebote, die dieses Programm abdecken; ausdrücklich „nicht enthalten“ | K | +| 7 | Häufige Fragen | R | +| 8 | Verwandte Programme und Module | K | + +*Aktionen:* Angebot wählen, kostenloses Modul, Kurzunterlage drucken. *Mobil:* Aufbau als Akkordeon; Aktion „Angebote ansehen“ als feste Leiste am unteren Rand, sobald der Kopf verlassen ist. +*Besonderheit:* Die Struktur ist dieselbe wie in der Mitgliederansicht (B23), ohne geschützte Dateien. Beide lesen dieselbe zur Anzeige freigegebene Fassung über denselben Strukturleser. + +#### 4. Modulseite + +*Aufgabe:* eine Trainingseinheit so beschreiben, dass ein Trainer sie sich vorstellen kann. + +| Nr. | Abschnitt | Quelle | +|---|---|---| +| 1 | Kopf: Titel, Kurzbeschreibung, Signaturen, Alter, Dauer | K | +| 2 | Lernziele | K | +| 3 | Ablauf in Schritten mit Rolle der Bestandteile (Gesprächseinstieg, Übung, Reflexion, Merksatz) | K | +| 4 | Materialien nach fachlichem Typ, nicht nach Dateiformat | K | +| 5 | Vorbereitung und Materialbedarf | K | +| 6 | Vorschau: freigegebenes Standbild oder Filmausschnitt, Auszug aus der Traineranleitung | K | +| 7 | Enthalten in: Programme | K | +| 8 | So erhalten Sie das Modul: Angebote | K | + +*Besonderheit:* Ein Modul ohne Film zeigt keinen leeren Filmbereich. Fehlt der Mindestinhalt (Kurzbeschreibung und Ablauf, später auch Lernziele), wird die Seite nicht indexiert. Eine Modulseite setzt eine eigene Anzeigefreigabe einer Modulfassung und die gesetzte Inhaltsart voraus. *Mobil:* Ablauf als nummerierte Liste; Materialien als kompakte Zeilen. + +#### 5. Zielgruppenspezifische Landingpage + +*Aufgabe:* eine bestimmte Lage ansprechen und zu einem Programm oder Angebot führen. + +| Nr. | Abschnitt | Quelle | +|---|---|---| +| 1 | Bühne: Ansprache der Gruppe, eine Aktion | R | +| 2 | Ausgangslage aus Sicht der Gruppe | R | +| 3 | So setzen Sie es ein: Beispielablauf für diese Lage | R | +| 4 | Passende Programme | K | +| 5 | Was Sie erhalten: Bestandteile | K | +| 6 | Lizenz für diesen Zweck | K | +| 7 | Organisatorisches: Rechnung, Datenschutz, Elterninformation | R | +| 8 | Abschluss: je nach Gruppe Kauf, kostenloses Modul oder Anfrage | G oder Formular | + +*Besonderheit:* entsteht aus einer Vorlage; die Redaktion ersetzt Texte und wählt Programme. Für Institutionen bis A4 endet die Seite im Anfrageformular. *Mobil:* keine Tabellen im sichtbaren Erstbereich; eine Aktion. + +#### 6. Angebots- und Lizenzvergleichsseite + +*Aufgabe:* den kaufbaren Umfang und die Rechte unmissverständlich darstellen. + +| Nr. | Abschnitt | Quelle | +|---|---|---| +| 1 | Kopf: Bezeichnung, für wen, Preis, Laufzeit | K | +| 2 | Enthalten: aufgelöster Umfang, verlinkt auf Programm- und Modulseiten | K | +| 3 | Nicht enthalten, wenn pädagogisch naheliegend | K | +| 4 | Lizenzvergleich: Spalten je Angebot oder Zweck, Zeilen je Materialart und Aktion (ansehen, streamen, laden), Preis, Laufzeit, Updatezusage | K | +| 5 | Bedingungen in Kürze, Verweis auf den gültigen Wortlaut | K | +| 6 | Kauf oder Abruf, zustandsabhängig: kaufen, bereits vorhanden, erweitern | K | +| 7 | Fragen zu Lizenz und Rechnung | R | + +*Mobil:* Vergleich als Karten je Angebot mit denselben Zeilen; Umschalter zwischen zwei Angeboten statt waagerechtem Rollen. +*Besonderheit:* Die Seite liest dieselben Datensätze, aus denen die Bestellkopie entsteht (INV-15). + +#### 7. Mitgliederbibliothek + +*Aufgabe:* berechtigte Programme, Module und Materialien finden und im Kurs nutzen. Die fachlichen Anforderungen stehen in `produktkonfiguration`, §§8–11; hier nur das UX-Konzept. + +| Bereich | Inhalt | +|---|---| +| Navigation | Bibliothek (Suche), Programme, Module, Materialien, Meine Lizenzen; mobil als Leiste am unteren Rand | +| Einstieg | Suchfeld; darunter „Meine Programme“ als große Karten, dann zuletzt hinzugekommene Module | +| Filter | Typ, Thema, Alter, Einsatz, Verfügbarkeit; Desktop als Leiste, mobil als Auszug mit Trefferzahl und „Zurücksetzen“ | +| Karte | Bild oder Platzhalter, Inhaltsart (ohne gesetzte Inhaltsart die bisherige technische Bezeichnung), Titel, Kurzbeschreibung, Alter, Themen, Verfügbarkeit | +| Umfang | nur Programme mit zur Anzeige freigegebener Fassung und mindestens einem berechtigten Blatt (E-A); alle übrigen Programme werden auf der öffentlichen Website entdeckt | +| Programmdetail | Kopf, Überblick, Struktur mit allen Modulen an ihrer Position, Aktionen je Blatt | +| Moduldetail | Kopf, Lernziele, Ablauf, Materialien mit Aktionen, „Verwendet in“ | +| Lizenzen | Erwerbe mit Zweck, Rechten, Herkunft; getrennt von der fachlichen Navigation | +| Hinweise | „teilweise nutzbar“ führt an der betreffenden Stelle zum passenden Angebot | + +*Mobil und Tablet:* Kursraum ist der Hauptfall. Große Trefferflächen, Film im Vollbild mit einem Tipp, Dokumente im Browser. +*Nicht im MVP:* Fortschritt, gespeicherte Abläufe, Präsentationsmodus. + +--- + +## 10. CMS-Funktionsmodell und Konfigurierbarkeit + +### 10.1 Zielbild der Redaktion + +Der Betreiber soll ohne Entwickler: eine Landingpage aus einer Vorlage in unter 30 Minuten anlegen; ein neues Programm öffentlich zeigen, indem er es freischaltet; einen Fachbeitrag schreiben, prüfen, planen; Navigation und Fußbereich ändern; eine Adresse ändern, ohne Links zu brechen; vor jeder Veröffentlichung sehen, was fehlt. + +### 10.2 Funktionsumfang nach Priorität + +| Bereich | Funktion | Stand heute | Priorität | +|---|---|---|---| +| **Seiten** | Anlage, Entwurf, Vorschau, Veröffentlichung, Revisionen, Wiederherstellung | vorhanden | — | +| | Seitentypen (Standard, Thema, Landing, Beitrag, Hilfe, Recht, Kampagne) | fehlt | MVP | +| | Vorlagen: vorbelegte Abschnittsfolgen, kopierbar | fehlt | MVP | +| | Unterpfade und Seitenbaum | fehlt (nur ein Pfadteil) | MVP | +| | Weiterleitungen bei Pfadänderung, manuelle Weiterleitungen | fehlt | MVP | +| | Zurückziehen und Archivieren mit Statuscode | fehlt | MVP | +| | Zeitgesteuerte Veröffentlichung | fehlt | früher Ausbau | +| | Revisionsvergleich | fehlt | früher Ausbau | +| | Seite duplizieren | fehlt | MVP (Teil der Vorlagen) | +| **Layout** | Abschnitte mit benannten Varianten | fehlt | MVP | +| | Abschnittseinstellungen: Flächenton, Breite, Abstand, Themenakzent | fehlt | MVP | +| | Globale Abschnitte (einmal pflegen, mehrfach einbinden) | fehlt | MVP | +| | Vorschau in drei Breiten | Vorschau vorhanden, Breiten fehlen | MVP | +| | Markenwerte als Einstellung mit Kontrastprüfung | fehlt | Zielbild, selten gebraucht | +| | Freie Spaltenlayouts | fehlt | **nicht empfohlen**, siehe 10.4 | +| **Dynamische Bausteine** | Themenliste, Programmkarten, Modulliste, Bestandteile, Lernziele, Angebotskarten, Lizenzvergleich, Beispielmaterial, verwandte Inhalte, Beitragsliste | fehlen | MVP (Kern), früher Ausbau (Rest) | +| **Medien** | zentrale Medienbibliothek der Website mit Alternativtext, Fokuspunkt, Verwendungsnachweis | Bildfeld vorhanden, Bibliothek fehlt | MVP | +| | automatische Größen und Formate | nicht geprüft | MVP | +| | Übernahme eines freigegebenen Vorschaubilds aus dem Katalog | fehlt | mit öffentlichem Katalog | +| **SEO** | Titel, Beschreibung | vorhanden | — | +| | Indexierung je Seite, Social-Bild, kanonische Adresse | fehlt | MVP | +| | Prüfliste vor Veröffentlichung | fehlt | MVP | +| **Qualität** | defekte interne Links, fehlende Alternativtexte, Überschriftenfolge, verwaiste Seiten | fehlt | MVP (blockierend: defekte Links, fehlender Alternativtext), früher Ausbau (Rest) | +| **Redaktion** | Autor und fachliche Prüfung je Beitrag, Stand, Quellenliste | fehlt | mit Wissen | +| | Redaktionsplan (geplante Beiträge, Status) | fehlt | früher Ausbau | + +### 10.3 Abgestuftes Konfigurationsmodell + +Die im Auftrag vorgeschlagene Vierteilung ist richtig, lässt aber zwei Dinge offen: was grundsätzlich niemand einstellen darf, und wo Vorlagen stehen. Empfohlen sind fünf Stufen. + +| Stufe | Wer | Was | Beispiele | Schutz | +|---|---|---|---|---| +| **0 Fest** | niemand über die Oberfläche | Sicherheits- und Vertragsgrenzen | Preise und Rechte nur aus dem Katalog; Wortlaut von AGB und Lizenzbedingungen aus dem Kern; Mitgliederbereich nie indexierbar; geschützte Medien nie als öffentliches Bild | Code und Datenbank | +| **1 Inhalt** | Redakteur | Texte, Bilder, Links, Reihenfolge der Abschnitte, SEO-Felder, Auswahl von Fachobjekten in Bausteinen | Abschnitt verschieben, Programm für eine Karte wählen | Revision, Prüfliste | +| **2 Komposition** | Redakteur | Auswahl aus benannten Varianten | Heldenvariante, Flächenton, Kartenzahl, Themenakzent, Vorlage wählen | nur Aufzählungswerte, keine freien Zahlen | +| **3 Marke und Struktur** | Systemverwalter, selten | Markenwerte, Signaturen der Säulen, Navigation, globale Abschnitte, Vorlagenpflege | neue Vorlage aus einer Seite ableiten | Vorschau, Kontrastprüfung, Auditeintrag | +| **4 Entwicklung** | Entwicklung | neue Bausteinarten, neue Varianten, Integrationen | Baustein „Terminliste“ | Test, Sichtprüfung, Deployment | + +**Entscheidend ist Stufe 2:** Die Redaktion wählt Bedeutungen („ruhig“, „betont“, „Thema Grenzen“), keine Werte („#5B8625“, „24 px“). Damit bleiben Barrierefreiheit und responsives Verhalten Eigenschaft des Bausteins und sind einmal geprüft. + +### 10.4 Grenzen: was bewusst nicht konfigurierbar wird + +| Nicht vorgesehen | Grund | +|---|---| +| freie Spalten und Raster je Seite | bricht auf kleinen Bildschirmen, nicht prüfbar; Abschnittsvarianten decken die tatsächlichen Fälle | +| freie Farben und Schriftgrößen je Baustein | Kontrast und Hierarchie gehen verloren | +| eigenes HTML oder Skripte in Seiten | Sicherheitsrisiko; Verwaltung und Website sind bewusst getrennt (`09`, C.8) | +| mehrere Themes zur Auswahl | eine Marke; saisonale Erscheinungsbilder haben keinen Nutzen für dieses Produkt | +| Preise, Rechte, Umfang als Text | Widerspruch zur Bestellkopie | +| A/B-Varianten im MVP | zu wenig Verkehr für belastbare Ergebnisse | + +**Wann die Grenze verschoben werden sollte:** Wenn in einem Quartal mehr als drei Wünsche auftreten, die nur an einer fehlenden Variante scheitern, wird die Variante ergänzt (Stufe 4), nicht die Freiheit erhöht. + +### 10.5 Bausteinbibliothek (Zielumfang) + +| Gruppe | Bausteine | Stufe | +|---|---|---| +| Bühne | Heldenbereich in drei Varianten (Bild rechts, Bild als Fläche, nur Text) | W2 | +| Text | Überschrift mit Einleitung, Fließtext, Bild und Text, Hinweis, Zitat (nur mit Nachweis), Schritte, Aufzählung mit Symbolen, FAQ | W2 (teilweise vorhanden) | +| Marke | Methode in Schritten, Themen-Signaturen, Vertrauensleiste, Merksatz | W2 | +| Katalog | Themenliste, Programmkarten, Modulliste, Bestandteile, Lernziele, Beispielmaterial, Verwandtes | W3 | +| Angebot | Angebotskarten, Lizenzvergleich, kostenloser Abruf, Kauf- oder Registrierungsaufruf | W3 | +| Redaktion | Beitragsliste, Autorenkasten, Quellen | W4 | +| Kontakt | Anfrageformular mit festen Feldern, Download öffentlicher Datei, öffentliche Filmvorschau | W3 bis W4 | + +### 10.6 Variantenvergleich in Kürze + +Die vollständige Bewertung mit Gewichtung steht in der Zielarchitektur, Kapitel 4. + +| Variante | Kurzurteil | +|---|---| +| **A – Eigenes Seitensystem linear erweitern** | trägt, bleibt aber ohne Vorlagen und Vorschaukomfort hinter dem Bedarf | +| **B1 – Statamic im selben Laravel** | beste Redaktionserfahrung unter den Laravel-Produkten, aber zweite Verwaltung, zweites Rechtemodell, 349 USD je Site und 99 USD jährlich (Q13) | +| **B2 – freier Page Builder als Filament-Plugin** | maximale Freiheit, genau die in 10.4 ausgeschlossenen Risiken; junge Pakete | +| **B3 – Twill** | ausgereifter Blockeditor, aber ebenfalls eigene Verwaltung | +| **C1 – Headless-Dienst mit visuellem Editor (z. B. Storyblok)** | sehr gute Bearbeitung, aber Katalogdaten müssten kopiert oder zur Laufzeit zusammengeführt werden; laufende Kosten ab 99 USD monatlich für mehr als einen Platz (Q16) | +| **C2 – Payload mit eigenem Frontend** | zweiter Technologiestapel; bereits in `10` verworfen | +| **D – Hybrid: Eigenkern mit Vorlagen, Abschnittsvarianten, Katalogbausteinen und Vorschau-Editor** | **bevorzugt, unter Vorbehalt des Editor-Prototyps** | + +### 10.7 Empfohlene CMS-Richtung + +**[EMPF]** Variante D ist die bevorzugte Variante **unter Vorbehalt**. Begründung: + +1. Der in `10` als größtes Risiko benannte Teil (Entwurf, Vorschau, Revision, Wiederherstellung) ist gebaut und bedienbar. +2. Der eigentliche Mehrwert, Katalogbausteine ohne Datenkopie, ist in jeder Variante Eigenentwicklung. Ein Fremdprodukt nimmt diese Arbeit nicht ab. +3. Eine Verwaltung, eine Anmeldung, ein Rollen- und Auditmodell bleiben erhalten (`09`, B.1). +4. Die fehlenden Teile sind überschaubar und einzeln lieferbar. + +**Der Vorbehalt.** Bearbeitungskomfort und Aufwand von D sind nach Dokumentation bewertet, nicht erprobt. Vor Beginn von W2 entscheidet ein kleiner Editor-Prototyp (Stufe W-P): + +- **Umfang:** vier Bausteine, darunter ein Katalogbaustein; Blockvorschau aus den öffentlichen Ansichten; Vorschau in drei Breiten; Vorlage und globaler Abschnitt. Höchstens drei Tage Bau, keine Migration, Wegwerfcode. +- **Prüfung:** Der Betreiber löst neun Bedienaufgaben allein und gegen die Uhr, etwa „Landingpage aus Vorlage anlegen und veröffentlichen in zehn Minuten“ oder „zwei Programme in einem Kartenbaustein wählen, ohne einen Titel zu tippen“. Dazu fünf technische Kriterien. +- **Regel:** Bestanden, wenn mindestens acht von neun Aufgaben einschließlich dreier Pflichtaufgaben gelingen und die technischen Kriterien erfüllt sind. Scheitert die Bedienung bei tragender Technik, folgt eine zweite Runde mit dem Blockeditor Mason. Scheitert auch sie, folgt eine Gegenprobe mit Statamic an denselben Aufgaben. + +Aufgaben, Zeitgrenzen und Entscheidungsregel im Einzelnen: Zielarchitektur, 4.5. Katalogbausteine und öffentliches Profil sind vom Ausgang unabhängig; sie wären in jeder Variante Eigenentwicklung. + +**Wann eine Alternative vorzuziehen wäre:** Mason als Editorfläche, wenn der Prototyp nur an der Bedienung scheitert. Statamic, wenn künftig mehrere nichttechnische Redakteure täglich Inhalte pflegen und der Katalogbezug gering bleibt. Ein Headless-Dienst, wenn eine Agentur die Marketingseiten betreibt und visuelle Bearbeitung wichtiger ist als Datenkonsistenz. Beides ist heute nicht der Fall. + +--- + +## 11. SEO-, GEO- und Content-Strategie + +### 11.1 Grundsatz + +**[FEST]** Themen entstehen aus den fünf Bereichen, der Trainingspraxis und dem Informationsbedarf; Suchvolumen wird gemessen, nicht erfunden; wenige eigenständige Beiträge statt Keyword-Variationen (`seo-prinzipien`, §12). + +**[EMPF]** Die Strategie unterscheidet drei Seitenklassen: + +| Klasse | Entsteht durch | Beispiele | Menge | +|---|---|---|---| +| **Objektseiten** | Freischaltung eines Fachobjekts | Thema, Programm, Modul, Angebot | so viele wie Objekte | +| **Redaktionsseiten** | bewusste redaktionelle Arbeit | Konzept, Zielgruppen, Fachbeiträge, Hilfe | wenige, gepflegt | +| **Ansichten** | Filter und Sortierung | Katalog nach Thema und Alter | beliebig, nie indexiert | + +Programmatische SEO im üblichen Sinn (Seiten aus Kombinationen) wird nicht betrieben. Automatisiert wird die Veröffentlichung echter Objekte. + +### 11.2 Themencluster + +Sieben Cluster: die fünf Themenbereiche, dazu „Methode und Kursgestaltung“ und „Einsatz und Organisation“. + +| Cluster | Mittelpunkt | Mögliche Beiträge (Auswahl, nicht gemessen) | Führt zu | +|---|---|---|---| +| Meine Grenzen | `/themen/meine-grenzen` | Nein-Sagen üben; Stimme und Stand; Grenzen anderer achten | Module des Themas | +| Sicher handeln im Alltag | Themenseite | Verhalten an der Haustür üben; Situationen einschätzen | Module | +| Geheimnisse, Vertrauen, Hilfe | Themenseite | gute und belastende Geheimnisse erklären; Vertrauenspersonen benennen | Module | +| Freundschaft, Selbstbehauptung, Zivilcourage | Themenseite | Gruppendruck im Kurs thematisieren | Module | +| Streit und Konflikte | Themenseite | Abstand schaffen; Hilfe rufen | Module | +| Methode und Kursgestaltung | `/konzept/methode` | Denkpause moderieren; eine Kursstunde aufbauen; mit Belastungsreaktionen umgehen | Programme | +| Einsatz und Organisation | `/fuer/…` | Elterninformation; Kurs im Verein; Projekttag in der Grundschule; Lizenzfragen | Angebote | + +**Suchintentionen [ANNAHME, vor Redaktionsbeginn zu messen]:** + +- *Information, Fachleute:* „Übungen Selbstbehauptung Grundschule“, „Nein sagen üben Kinder“, „gute und schlechte Geheimnisse Kinder erklären“, „Gewaltprävention Grundschule Unterrichtsmaterial“. +- *Lösung und Kauf, Fachleute:* „Kurskonzept Selbstbehauptung Kinder“, „Material Selbstbehauptungskurs Trainer“, „Gewaltprävention 1. Klasse Programm“. +- *Eltern:* „Selbstbehauptungskurs Kinder“ mit Ortsangabe. Vermutlich das größte Volumen, aber keine Käufer. Nicht Ziel der Optimierung; eine Elternseite fängt die Besucher auf. + +Messweg: Search Console ab dem ersten Tag; eine einmalige Volumenprüfung der Startliste über Keyword Planner oder einen Datendienst (Q26, Preis vor Nutzung prüfen). + +### 11.3 Wettbewerbsvorteil + +Eigene Filme, eigene Übungen, eigene Trainerunterlagen und Praxiserfahrung sind Inhalte, die niemand sonst hat. Daraus folgen drei Inhaltsformen, die schwer zu kopieren sind: + +1. **Vollständig gezeigte Übung** mit Ablauf, Trainerfrage und Merksatz, je Themenbereich eine, öffentlich. +2. **Szenenbild mit didaktischer Einordnung:** was die Szene zeigt, an welcher Stelle innegehalten wird, welche Fragen sich eignen. Ohne den geschützten Film offenzulegen. +3. **Erfahrungsnotizen aus Kursen**, namentlich gezeichnet. + +Rein suchgetriebene Texte ohne eigenen Anteil werden nicht veröffentlicht. + +### 11.4 Mengengerüst und Qualität + +**[EMPF]** Für das erste Jahr: fünf Themenseiten, drei bis vier Konzeptseiten, drei Zielgruppenseiten, zwölf bis achtzehn Fachbeiträge. Ein Beitrag je zwei bis drei Wochen ist für einen kleinen Betreiber mit fachlicher Prüfung realistisch **[ANNAHME]**. + +Jeder Fachbeitrag hat: eine Frage als Anlass, eine Antwort im ersten Absatz, Autor und fachliche Prüfung, Stand, Quellen für überprüfungsbedürftige Aussagen, genau ein verlinktes Modul und eine Themenseite, ein Prüfdatum für die Wiedervorlage. + +**Indexierungsregel:** Eine Seite wird nur indexiert, wenn sie eigenen Hauptinhalt hat, von mindestens zwei anderen Seiten verlinkt ist und einem Cluster zugeordnet ist. Die Regel wird beim Veröffentlichen geprüft. + +### 11.5 Automatisierung und redaktionelle Kontrolle + +| Mechanismus | Automatisch | Redaktionell | +|---|---|---| +| Objektseiten für Thema, Programm, Modul, Angebot | Erzeugung und Aktualisierung aus Fachdaten | Freischaltung je Objekt, Einleitung, Bild | +| XML-Sitemap | vollständig | — | +| Kanonische Adressen | vollständig, Regeln je Seitentyp | Ausnahme je Seite | +| Weiterleitungen | bei Pfadänderung automatisch | manuelle Einträge, Auflösung von Ketten | +| Breadcrumbs | aus dem Seitenbaum | — | +| Strukturierte Daten | aus Seitentyp und Fachdaten | — | +| Social-Vorschau | Vorbelegung aus Titel, Beschreibung, Bild | Überschreiben | +| Titel und Beschreibung | Vorbelegung aus Fachdaten | Überschreiben; KI-Vorschläge nur mit Bestätigung | +| Fehlende Angaben, defekte Links, verwaiste Seiten | Erkennung und Maßnahme | Behebung | +| Interne Verlinkung | Bausteine aus Fachbezügen | Links im Text; Vorschläge mit Bestätigung | +| Doppelte Inhalte | Erkennung ähnlicher Titel und Beschreibungen | Zusammenführen | +| Inhaltsübersichten | vollständig | — | + +Vor- und Nachteile der Mechanismen und ihre Umsetzung: Zielarchitektur, Kapitel 7. + +### 11.6 GEO und AEO + +**[BELEGT]** Google nennt für KI-Übersichten und den KI-Modus keine zusätzlichen technischen Anforderungen: Eine Seite muss indexiert und für ein Snippet geeignet sein. Sonderdateien, KI-Textdateien oder besonderes Markup sind ausdrücklich nicht nötig; es gibt auch keine besonderen strukturierten Daten dafür. Steuerbar ist die Darstellung über `nosnippet`, `data-nosnippet`, `max-snippet` und `noindex` (Q01). + +**Konsequenzen [EMPF]:** + +- Keine „GEO-Tricks“. Die Anforderungen aus `seo-prinzipien`, §9 genügen: Antwort zuerst, eindeutige Begriffe, benannte Verantwortung, Quellen, konsistente Angaben, Text statt Bild. +- **Einheitliche Begriffsseite:** Methode, Themenbereich, Modul, Programm, Angebot je einmal definiert und überall gleich verwendet. Das hilft Menschen, Suchmaschinen und Antwortsystemen gleichermaßen. +- **`llms.txt`:** kein Bestandteil des MVP. Google Search verwendet solche Dateien nach eigener Aussage nicht; ein Nutzen bei anderen Diensten ist nicht belegt (Q01, Q27). Später als erzeugte Liste der öffentlichen Seiten ohne Aufwand nachrüstbar. +- **KI-Crawler [OFFEN]:** Öffentliche Seiten sollen gefunden und zitiert werden können; geschützte Inhalte liegen ohnehin hinter der Anmeldung. Ob Crawler, die ausschließlich dem Training dienen, zugelassen werden, ist eine Haltungsfrage des Betreibers. Technisch ist beides über `robots.txt` je Crawler steuerbar. + +**Messung:** + +| Quelle | Was sie zeigt | Einschränkung | +|---|---|---| +| Search Console, Bericht zu generativer KI | Impressionen in KI-Übersichten, KI-Modus und Discover, je Seite, Land, Gerät, Datum; seit 31.08.2026 für alle Websites (Q04) | Klicks werden im Beitrag nicht genannt; eine Programmierschnittstelle ist nicht belegt | +| Bing Webmaster Tools, AI Performance | Zitationen, zitierte Seiten, Grundierungsanfragen (Stichprobe), Verlauf; öffentliche Vorschau seit 10.02.2026 (Q07) | nur Microsoft-Dienste; Schnittstelle nicht belegt | +| Eigene Reichweitenmessung | Besuche mit Herkunft von Antwortdiensten | nur, wenn der Dienst einen Verweis mitsendet **[ANNAHME]** | + +Zitationen bleiben externe Ergebnisse ohne Garantie (`seo-prinzipien`, §9). + +### 11.7 Strukturierte Daten nach heutigem Stand + +**[BELEGT]** Googles Galerie der unterstützten Typen enthält am 15.11.2026 unter anderem Article, Breadcrumb, Organization, Product, Profile page, Video und Course list; **FAQ ist nicht mehr aufgeführt**, „Course info“ wurde 2025 eingestellt (Q02, Q03). + +| Seitentyp | Markup | Erwartung | +|---|---|---| +| alle | Breadcrumb | Darstellung des Pfads | +| Start, Über uns | Organization | Name, Logo, Kontakt | +| Fachbeitrag | Article mit Autor und Datum | Autorenzeile | +| Seiten mit öffentlicher Filmvorschau | VideoObject | Videoergebnis, nur bei tatsächlich öffentlichem Video | +| Angebot | Product mit Offer | Preisangabe; nur mit echtem, sichtbarem Preis | +| Programm, Modul | optional `LearningResource` oder `Course` als beschreibendes Markup | **kein** Suchergebnis-Effekt zu erwarten; nur, wenn ohne Pflegeaufwand erzeugbar | +| FAQ-Baustein | kein Pflichtmarkup | Nutzen für Leser, nicht für Suchergebnisse | + +Folge für `seo-prinzipien`, §8: Die Aufzählung bleibt gültig, sollte aber um den Hinweis auf entfallene Ergebnisarten ergänzt werden (Kapitel 19). + +### 11.8 Technische SEO-Anforderungen (prüfbar) + +| Anforderung | Kriterium | +|---|---| +| Auslieferung | öffentliche Seiten vollständig servergerendert; Inhalt ohne JavaScript lesbar | +| Statuscodes | 200 nur für veröffentlichte Seiten; 301 bei Pfadänderung; 404 für unbekannte, 410 für zurückgezogene Seiten; keine „weichen“ 404 | +| Kanonisch | jede indexierbare Seite nennt sich selbst; Filteransichten nennen die Übersicht | +| Sitemap | nur indexierbare, veröffentlichte Adressen; mit Änderungsdatum; in `robots.txt` genannt | +| `robots.txt` | je Umgebung erzeugt; Produktion sperrt Anwendungspfade; Test sperrt alles **und** ist zugangsgeschützt | +| Indexierung | `noindex` für Anmeldung, Registrierung, Mitgliederbereich, Vorschau, Kampagnen nach Wahl | +| Leistung | LCP höchstens 2,5 s, INP höchstens 200 ms, CLS höchstens 0,1 am 75. Perzentil mobil **[ANNAHME: Schwellen unverändert]** | +| Bilder | passende Größen, modernes Format, feste Abmessungen, Nachladen außerhalb des ersten Bildschirms | +| Video | Vorschaubild statt eingebettetem Player beim Laden; Beschreibung als Text | +| Barrierefreiheit | WCAG 2.2 AA als Ziel; automatische Prüfung ohne schwere Befunde, dazu Tastatur- und Sichtprüfung | +| Struktur | genau eine H1, lückenlose Überschriftenfolge, Sprunglink, Landmarken | +| PWA | Service Worker speichert keine angemeldeten Seiten und verändert keine öffentlichen Adressen (`seo-prinzipien`, §11) | + +Zuordnung zu CMS, Frontend und Deployment: Zielarchitektur, Kapitel 7. + +--- + +## 12. Marketing Intelligence und Automatisierung + +### 12.1 Zielbild + +Ein Betreiber soll montags in zehn Minuten sehen: was sich verändert hat, welche drei Maßnahmen den größten Nutzen versprechen, und welche Entwürfe zur Prüfung bereitliegen. Nichts wird ohne Freigabe öffentlich, das eine fachliche Aussage enthält. + +**[FEST]** Drei Automatisierungsstufen (Erhebung und Überwachung, Analyse und Vorschläge, redaktionelle Unterstützung); KI-Vorschläge sind markiert und prüfbare Entwürfe; Messwerte, Schätzungen und Empfehlungen werden nicht vermischt (`seo-prinzipien`, §§13–14). + +### 12.2 Kennzahlen + +| Stufe | Kennzahl | Quelle | Ab wann | +|---|---|---|---| +| Sichtbarkeit | Impressionen, Klicks, Klickrate, Position je Seite und Anfrage | Search Console, Bing | M0 | +| | Impressionen in KI-Funktionen, Zitationen | Search Console, Bing (Oberfläche, Export) | M1, manuell | +| Besuch | Besuche je Seite, Herkunft, Einstiegsseite | Reichweitenmessung | M0 | +| Interesse | Aufrufe von Programm-, Modul-, Angebotsseiten; Klick auf Abruf oder Kauf | Reichweitenmessung | M0 | +| Gewinnung | Registrierungen, bestätigte Konten | Kern | M0 | +| Aktivierung | Abruf des kostenlosen Angebots; erstes geöffnetes Modul | Kern | M0 | +| Umsatz | Erstkäufe, Wiederkäufe, Erweiterungen | Kern | M0 | +| Bindung | Konten, die im Monat mindestens ein Modul öffnen | Kern, verdichtet | M1 | +| Nachfrage Institutionen | Anfragen nach Art der Einrichtung | Formular | W3 | + +**Leitkennzahl [EMPF]:** aktive lizenzierte Trainer je Monat. Sie misst den tatsächlichen Nutzen und nicht den Verkehr. + +Jede Kennzahl trägt Quelle, Zeitraum und Definition. Fehlende Daten werden als fehlend angezeigt. + +### 12.3 Datenquellen + +| Quelle | Zugang | Kosten | Qualität und Grenzen | +|---|---|---|---| +| Google Search Console | Schnittstelle für Suchanalyse und URL-Prüfung; Grenzen laut Google unter anderem 1.200 Abfragen je Minute und 2.000 URL-Prüfungen je Tag und Website (Q06) | keine | echte eigene Daten; seltene Anfragen werden nicht ausgewiesen; etwa 16 Monate Historie **[ANNAHME]** | +| Bing Webmaster Tools | Schnittstelle für Suchdaten **[ANNAHME]**; KI-Bericht nur Oberfläche und Export | keine | geringes Volumen im deutschen Markt **[ANNAHME]** | +| Reichweitenmessung | selbst betrieben, ohne Cookies | Serverressourcen | keine Rückschau; nur ab Einbau | +| Kern | Registrierung, Abruf, Kauf, Nutzung | keine | maßgeblich; nur verdichtet in das Marketingmodul | +| CMS | Seiten, Stand, Verlinkung, Cluster | keine | vollständig | +| Keyword-Daten | Keyword Planner oder Datendienst | Planner ohne Werbeausgaben nur in Spannen **[ANNAHME]**; Datendienst nutzungsabhängig im Cent-Bereich je Abfrage (Q26, nicht an der Originalpreisliste geprüft) | Schätzwerte, nie als Messwert anzeigen | +| Newsletter | Öffnungen, Klicks | je Werkzeug | Öffnungsmessung ist einwilligungsrelevant; Empfehlung: nur Klicks auf eigene Seiten | + +Wettbewerbsdaten und bezahlte SEO-Suiten werden nicht empfohlen: Kosten und Datenmenge stehen in keinem Verhältnis zur Größe der Website. + +### 12.4 Erkennung von Chancen: Verfahren im Vergleich + +| Verfahren | Eignung | Beispiele | Urteil | +|---|---|---|---| +| **Regeln** | alles, was sich als Bedingung über vorhandene Daten ausdrücken lässt | fehlende Beschreibung, defekter Link, verwaiste Seite, Position 8 bis 20 mit Impressionen, Klickrate unter Vergleichswert, kein Programm zum Thema verlinkt, neuer Artikel-Stand ohne Ankündigung | **Grundlage**; erklärbar, kostenlos, testbar | +| **Statistik** | Veränderungen gegen Vorperiode | Rückgang um mehr als 30 % gegenüber den vier Wochen davor; Vergleich mit dem Vorjahr, sobald vorhanden | sparsam; bei kleinen Zahlen Mindestmengen statt Signifikanztests | +| **KI** | Sprache verstehen und erzeugen | Suchanfragen einem Cluster zuordnen, Absicht einschätzen, Lücke benennen, Briefing und Entwurf schreiben, Bericht formulieren | **nur dort**; nie für Zahlen | +| **Kombination** | Regel findet, KI erklärt und entwirft | „Anfragen ohne passende Seite“: Regel liefert die Liste, KI gruppiert und schlägt ein Thema vor | **Zielbild** | + +**Wichtige Einschränkung:** In den ersten Monaten liegen kaum Suchdaten vor. Regeln, die Verkehr voraussetzen, bleiben dann stumm. Deshalb beginnt M1 mit Prüfungen, die keinen Verkehr brauchen (Vollständigkeit, Verlinkung, Aktualität, neue Objekte), und schaltet verkehrsabhängige Regeln erst ab einer Mindestmenge frei, etwa 1.000 Impressionen in 28 Tagen **[EMPF, Schwelle anzupassen]**. + +**Priorisierung:** Jede Maßnahme zeigt Wirkung (gemessene Größe, etwa Impressionen der betroffenen Seite), Sicherheit (Regel eindeutig oder Vermutung) und Aufwand (klein, mittel, groß). Die Reihenfolge ergibt sich daraus; die Bestandteile bleiben sichtbar. Eine Punktzahl ohne Herleitung wird nicht angezeigt. + +### 12.5 Der Steuerungsprozess + +| Phase | Eingang | Verarbeitung | Ergebnis | Automatisierung | Freigabe | Fehlerfall | Protokoll | Kennzahl | +|---|---|---|---|---|---|---|---|---| +| **1 Erfassung** | Schnittstellen, Kern, CMS | täglicher Abruf, Verdichtung | Tageswerte je Seite und Anfrage | voll | keine | Wiederholung; Lücke wird als Lücke gezeigt | Abrufprotokoll | Vollständigkeit der Tage | +| **2 Analyse** | Tageswerte, Seitenbestand | Regeln, Periodenvergleich | Befunde | voll | keine | Regel ohne Daten ruht | Regel, Version, Datenstand | Befunde je Woche | +| **3 Bewertung** | Befunde | Zusammenfassen, Wirkung, Sicherheit, Aufwand | Chancen | voll; Texterklärung optional durch KI | keine | ohne KI nur Kurzform | Herleitung je Chance | Anteil angenommener Chancen | +| **4 Planung** | Chancen | Betreiber wählt, verwirft, plant | Maßnahmen mit Termin | Vorschlag | **Betreiber** | — | Entscheidung mit Grund | Durchlaufzeit | +| **5 Entwurf** | Maßnahme, Fachdaten, Seitenbestand | Briefing, Textentwurf, Varianten | Entwurf als markierte Seitenrevision | KI auf Anforderung | keine Veröffentlichung | Abbruch ohne Folgen | Modell, Anweisungsfassung, Eingaben | Entwürfe je Monat | +| **6 Prüfung** | Entwurf | Prüfliste: Fakten, Quellen, Ton, Versprechen, SEO, Barrierefreiheit | geprüfte Revision | Prüfliste automatisch, Urteil menschlich | **Redakteur**, bei Fachaussagen **Fachprüfer** | zurück an 5 | Prüfer, Zeitpunkt | Überarbeitungsquote | +| **7 Veröffentlichung** | geprüfte Revision | vorhandene Veröffentlichung, optional geplant | Live-Seite | Technik voll | **Redakteur** | Rücknahme über Revision | Seitenrevision | — | +| **8 Wirkung** | Maßnahme mit Datum, Tageswerte | Vorher-Nachher-Vergleich über gleiche Zeiträume | Wirkungsnotiz | voll | keine | zu wenig Daten: „nicht beurteilbar“ | Zeiträume, Werte | Anteil wirksamer Maßnahmen | +| **9 Optimierung** | Wirkungsnotizen | Schwellen und Regeln anpassen | geänderte Regeln | Vorschlag | **Betreiber** | — | Regeländerung | — | + +**Das CMS als Arbeitsoberfläche:** Befunde, Chancen und Maßnahmen erscheinen als eigener Bereich „Marketing“ in der Verwaltung. Eine Maßnahme verweist auf die betroffene Seite; ein Entwurf ist eine Revision dieser Seite. Es entsteht kein zweites System mit eigenen Inhalten (`tasks/SEO-Marketing.md`, §5). + +### 12.6 KI-gestützte Arbeitsabläufe + +| Ablauf | Auslöser | KI-Anteil | Freigabestufe | +|---|---|---|---| +| Suchanfragen einem Cluster zuordnen | täglich | Klassifikation | 0, automatisch, stichprobenweise prüfbar | +| Titel und Beschreibung vorschlagen | Befund oder Knopf | zwei bis drei Varianten aus dem Seiteninhalt | 1, Übernahme mit einem Klick | +| Alternativtext vorschlagen | Bild ohne Text | Beschreibung | 1 | +| Interne Links vorschlagen | neue Seite, verwaiste Seite | Stellen und Linktexte | 1 | +| Briefing für einen Fachbeitrag | Maßnahme | Frage, Gliederung, benötigte Quellen, verlinkbare Objekte | 2 | +| Entwurf eines Fachbeitrags | Briefing | Rohfassung mit markierten Stellen „Quelle nötig“ | 2 mit Fachprüfung | +| Landingpage-Variante | Vorlage und Zielgruppe | Textvorschläge je Abschnitt | 2 | +| Ankündigung eines neuen Moduls | Ereignis „Stand veröffentlicht“ | Entwürfe für Seite, Mitteilung, Kurzbeitrag | 2 | +| Erweiterungshinweis für Bestandskunden | neues Modul passt zu vorhandenem Programm | Textvorschlag | 2; Versand rechtlich zu prüfen | +| Newsletter-Entwurf | Termin | Zusammenstellung aus Veröffentlichungen | 2 | +| Beiträge für fremde Kanäle | Veröffentlichung | Kurzfassungen | 3 | +| Wochen- und Monatsbericht | Termin | Formulierung aus Zahlen, die das System liefert | 0, als Bericht gekennzeichnet | +| Bezahlte Werbung | — | keine Automatisierung vorgesehen | 3 | + +**Freigabestufen:** + +| Stufe | Bedeutung | +|---|---| +| **0** | läuft ohne Einzelfreigabe; verändert nichts Öffentliches außer technischen Angaben (Sitemap, Weiterleitung) | +| **1** | Vorschlag, Übernahme durch einen Klick des Redakteurs; betrifft Metaangaben und Verlinkung | +| **2** | Entwurf als Revision; Veröffentlichung nur nach redaktioneller Prüfung, bei Fachaussagen zusätzlich fachliche Prüfung | +| **3** | wirkt außerhalb der eigenen Website oder kostet Geld; ausdrückliche Freigabe je Vorgang mit Prüfliste | + +**Regeln für sensible Inhalte:** Kein KI-Text enthält Qualifikationen, Stimmen, Bewertungen, Studienergebnisse oder Wirkungsaussagen, die nicht aus hinterlegten, geprüften Angaben stammen. Der Entwurfsschritt erhält als Wissensgrundlage nur Fachdaten, veröffentlichte Seiten und eine gepflegte Liste zulässiger Aussagen mit Quelle. Stellen ohne Beleg werden markiert, nicht geglättet. Google weist ausdrücklich darauf hin, dass KI-Inhalte einschließlich Titel, Beschreibungen, strukturierter Daten und Alternativtexte von Menschen zu prüfen sind und dass Massenerzeugung ohne Mehrwert gegen die Spam-Richtlinien verstoßen kann (Q05). + +### 12.7 Architekturvarianten in Kürze + +Vollständiger Vergleich: Zielarchitektur, Kapitel 8. + +| Ansatz | Kurzurteil | +|---|---| +| A – im Kern | trägt Erfassung, Regeln, Maßnahmen und Freigaben am besten: vorhandene Zeitsteuerung, Warteschlange, Rollen, Audit, Tests | +| B – n8n als Steuerung | schnell für Verbindungen zu Fremddiensten; als Träger der Logik ungeeignet: Abläufe außerhalb von Tests und Versionsverwaltung, weiteres System mit Zugangsdaten | +| C – eigenes System | Überarchitektur für diese Größe | +| D – KI-Agenten mit Zugriff | für abgegrenzte Recherche später denkbar; als Steuerung zu wenig vorhersagbar | +| **E – Hybrid** | **Empfehlung:** Kern trägt Daten, Regeln, Maßnahmen, Freigaben; KI als einzelne Schritte hinter einem Adapter; n8n optional für fremde Kanäle mit eng begrenztem Zugang | + +**Kosten der Modelle:** Bei dem in der Zielarchitektur gerechneten Mengengerüst (einige tausend Klassifikationen, etwa zwanzig Briefings, acht Entwürfe, vier Berichte je Monat) liegen die Kosten nach aktueller Preisliste bei wenigen Euro im Monat (Q25). Die Wahl des Modells ist damit eine Qualitäts- und keine Kostenfrage; kleine Modelle für Zuordnung und Metaangaben, ein großes für Entwürfe. + +--- + +## 13. Datenschutz und rechtliche Prüfbedarfe + +Dieses Kapitel benennt Prüfbedarfe. Es ersetzt keine Rechtsberatung. + +| Thema | Sachverhalt | Empfehlung | Zu prüfen | +|---|---|---|---| +| Reichweitenmessung | Zugriff auf Endgeräte ist ohne Einwilligung nur zulässig, wenn unbedingt erforderlich (§ 25 TDDDG, Q23) | Messung ohne Cookies und ohne Gerätekennung, selbst betrieben, IP gekürzt | Rechtsgrundlage und Konfiguration; Text der Datenschutzerklärung | +| Herkunft am Konto | Einstiegsseite und Kampagne werden bei Registrierung gespeichert | nur diese zwei Angaben, zweckgebunden, mit Löschfrist | Zweckbindung, Informationspflicht | +| Kauf- und Nutzungsdaten im Marketing | personenbezogene Daten im Kern | nur verdichtete Zahlen im Marketingmodul; keine Personenlisten | Schwelle für Kleinstmengen | +| Newsletter | Werbung per E-Mail braucht Einwilligung mit Bestätigung; Ausnahme für Bestandskunden unter engen Bedingungen **[ANNAHME]** | getrennte Einwilligung, Nachweis, Abmeldung in jeder Mail | Bestandskundenausnahme; Abgrenzung zur Vertragsmitteilung „neue Fassung“ | +| Öffnungsmessung | Zählpixel | verzichten; Klicks auf eigene Seiten genügen | — | +| KI-Dienste | Übermittlung an einen Auftragsverarbeiter | keine personenbezogenen Daten übermitteln; nur öffentliche Inhalte, Fachdaten, verdichtete Zahlen, bereinigte Suchanfragen | Vertrag, Verarbeitungsort, Aufbewahrung beim Anbieter | +| Kennzeichnung von KI-Texten | Art. 50 Abs. 4 der KI-Verordnung verlangt Offenlegung für veröffentlichte Texte zu Angelegenheiten von öffentlichem Interesse, außer bei menschlicher Prüfung und redaktioneller Verantwortung; anwendbar seit 02.08.2026 (Q21) | der Prozess in 12.5 sieht Prüfung und benannte Verantwortung vor; Herkunft wird intern immer festgehalten | ob die Ausnahme greift; ob freiwillige Kennzeichnung sinnvoll ist | +| KI-erzeugte Bilder | falls Figurenbilder oder Filmszenen KI-erzeugt sind (aus den Unterlagen nicht eindeutig ersichtlich) | Herkunft im Asset-Katalog festhalten | Kennzeichnungspflichten, Rechte an Figuren und Wortmarke | +| Barrierefreiheit | Barrierefreiheitsstärkungsgesetz seit 28.06.2025; Ausnahme für Kleinstunternehmen bei Dienstleistungen; Reichweite bei Angeboten an Unternehmer strittig (Q22) | WCAG 2.2 AA als Qualitätsziel unabhängig von der Pflicht | ob eine Pflicht besteht | +| Schriften | Laden von fremden Servern | lokal ausliefern | Lizenz der Schriftdateien | +| Formulare | Anfragen von Einrichtungen | Pflichtfelder minimal, Löschfrist | Aufbewahrung | +| Test und Produktion | getrennte Bestände | keine Echtdaten in Test; Test nicht öffentlich erreichbar; Marketingabrufe nur für die Produktionsadresse | — | +| Automatisierte Prozesse | Transparenz | Abschnitt in der Datenschutzerklärung; keine automatisierten Entscheidungen über Personen | — | +| Werbeaussagen | Wirkungs- und Sicherheitsversprechen | Liste zulässiger Aussagen | wettbewerbsrechtliche Prüfung der Kernaussagen | + +--- + +## 14. Priorisierte Entwicklungsroadmap + +### 14.1 Bewertung der Ausgangshypothese + +| Punkt der Hypothese | Bewertung | +|---|---| +| Phase 1 bündelt Designsystem, Website, Informationsarchitektur, Bibliothek, CMS, SEO-Basis und Produktdarstellung | zu groß für eine abnehmbare Stufe; die Bibliothek hat bereits einen eigenen Plan mit sieben Paketen | +| Landingpage-Vorlagen und Seitenbaukasten erst in Phase 2 | zu spät: Zielgruppenseiten gehören zum Start; Vorlagen sind der günstigste Weg dorthin | +| Marketingdaten erst in Phase 2 | zu spät: Reichweitenmessung hat keine Rückschau; Search Console sammelt erst ab Einrichtung. Die Erfassung gehört in die erste Stufe, die Auswertung später | +| KI in Phase 3 | richtig eingeordnet | +| Reihenfolge nach Technik | der kritische Pfad ist nicht Technik, sondern Markenfreigabe, Bildrechte, echte Inhalte, Preise und Rechtstexte | + +### 14.2 Empfohlene Stufen + +Zwei Spuren, die sich in die bestehende Roadmap `15` einfügen: **W** (Website) als Ausgestaltung des Bereichs „Website und CMS“ der Stufe A1, **M** (Marketing) als neue Spur neben A2 und A3. Die Bibliothekspakete 0 bis 9 laufen in einer gemeinsamen Reihenfolge mit (14.5). + +```mermaid +flowchart LR + W0["W0 Markenbasis und Entscheidungen"] --> W1["W1 Designsystem und technische Basis"] + W1 --> W2["W2 Seitensystem mit Vorlagen"] + W2 --> W3["W3 Öffentlicher Katalog"] + W3 --> W4["W4 Wissen und Landingpages"] + W1 --> M0["M0 Messbasis"] + M0 --> M1["M1 Marketing-Cockpit, regelbasiert"] + W4 --> M1 + M1 --> M2["M2 KI-Assistenz"] + M2 --> M3["M3 Kanäle und Ausbau, optional"] + WP["W-P Editor-Prototyp"] --> W2 + W1 --> W1B["W1b Mitgliederbereich im Designsystem"] + B3["Bibliothek Paket 3"] -.-> W1B + BIB["Bibliothek Pakete 1 bis 4 und 7"] -.-> W3 + TB["Bibliothek Tor B"] -.-> VS["Verkaufsstart"] + W3 --> VS +``` + +Aufwand in Arbeitstagen fokussierter Umsetzung mit Coding-Agent und Prüfung durch den Betreiber; **eigene grobe Schätzung ohne Erprobung**, ohne Inhalte, Gestaltungsleistung und Rechtsberatung. + +| Stufe | Einordnung | Nutzen | Liefergegenstände | Voraussetzungen | Aufwand | +|---|---|---|---|---|---| +| **W0 Markenbasis** | MVP | alles Weitere baut auf freigegebenen Werten statt auf Vorschlägen | Wortmarke als SVG; Farbwerte mit Kontrasttabelle; Schriften lokal; fünf Signaturen; textfreie Zuschnitte; Asset-Katalog mit Freigaben; Entscheidungen aus Kapitel 17 | Gestaltungsleistung, Rechteklärung | 3 bis 6 Tage Gestaltung und Entscheidung, kaum Entwicklung | +| **W-P Editor-Prototyp** | Entscheidungsgrundlage | die CMS-Richtung wird an Bedienaufgaben entschieden, nicht an Annahmen | Wegwerf-Prototyp mit vier Bausteinen, Blockvorschau, Vorlage, globalem Abschnitt; Protokoll der neun Bedienaufgaben und fünf technischen Kriterien (Zielarchitektur, 4.5) | keine; unabhängig von den Bibliothekspaketen; keine Migration | 3 Tage Bau, ein halber Tag Erprobung; bei zweiter Runde 2 Tage mehr | +| **W1 Designsystem und technische Basis** | MVP | die laufende Website sieht nach Marke aus und ist technisch sauber auffindbar | Tokens, Grundkomponenten, Kopf- und Fußbereich, Umstellung der vorhandenen öffentlichen Seiten (die Mitgliedsansichten bleiben bis W1b unberührt); Unterpfade, Weiterleitungen, Statuscodes, kanonische Adressen, Sitemap, `robots.txt` je Umgebung, Social-Vorschau, Breadcrumb, Grundmarkup; Sichtprüfung in drei Breiten | W0 | 10 bis 15 | +| **W1b Mitgliederbereich im Designsystem** | MVP | Bibliothek und Website wirken wie ein Produkt | Mitgliedsansichten auf Tokens und Grundkomponenten; Themen-Signaturen als Platzhalter; keine Änderung an Struktur und Logik | W1; Bibliothek Paket 3, sinnvoll nach Paket 5 und 6 | 3 bis 5 | +| **M0 Messbasis** | MVP | Daten ab dem ersten öffentlichen Tag | Search Console und Bing eingerichtet; Reichweitenmessung; Ereignisse Registrierung, Abruf, Kauf; Herkunft am Konto | W1, Produktionsadresse, Entscheidung Messwerkzeug | 3 bis 5 | +| **W2 Seitensystem** | MVP | neue Seiten ohne Entwickler | Seitentypen, Vorlagen, Abschnittsvarianten, globale Abschnitte, redaktionelle Bausteine, Medienbibliothek, Vorschau in drei Breiten, Prüfliste vor Veröffentlichung, Duplizieren | W1; bestandener Editor-Prototyp | 12 bis 18 | +| **W3 Öffentlicher Katalog** | MVP | Programme, Module und Angebote sind öffentlich sichtbar und konsistent | öffentliches Profil je Fachobjekt; Programm-, Modul-, Angebots-, Kostenlos-Seite; Katalogbausteine; Lizenzvergleich; Anfrageformular | W2; Bibliothek Pakete 1, 2, 3, 4 und 7, für den Themenbezug 5, für Bilder 6; Angebote und Preise entschieden; Kaufaufrufe erst nach Tor B | 12 bis 18 | +| **W4 Wissen und Landingpages** | früher Ausbau | Sichtbarkeit bei Fachfragen, Ansprache je Zielgruppe | Seitentyp Beitrag mit Autor, Prüfung, Quellen; Zielgruppenvorlagen; zeitgesteuerte Veröffentlichung; Redaktionsplan; Newsletter-Anmeldung | W3; redaktionelle Kapazität | 8 bis 12, dazu laufend Inhalte | +| **M1 Marketing-Cockpit** | früher Ausbau | wöchentliche Steuerung aus echten Daten | Abruf der Suchdaten; Marketingtabellen; Übersicht; Regeln; Maßnahmenliste; Wirkungsnotiz | M0; W4 begonnen; für verkehrsabhängige Regeln einige Wochen Daten | 10 bis 15 | +| **M2 KI-Assistenz** | Zielarchitektur | weniger Routinearbeit bei gleichbleibender Kontrolle | Modelladapter; Zuordnung von Anfragen; Vorschläge Stufe 1; Briefing und Entwurf als Revision; Bericht; Protokoll | M1; Entscheidung KI-Dienst; Liste zulässiger Aussagen | 8 bis 12 | +| **M3 Kanäle und Ausbau** | optional | Reichweite über die Website hinaus | Anbindung fremder Kanäle über n8n; Rechercheauftrag mit Websuche; Varianten von Landingpages; `llms.txt` | M2; Bedarf | je Teil 2 bis 6 | +| **Später, außerhalb dieser Spuren** | optional | — | didaktischer Kursplayer; öffentliches Trainerverzeichnis (A3); Organisationsangebote (A4); gespeicherte Kursabläufe | bestehende Roadmap | — | + +**Summe W-P bis M2:** etwa 70 bis 105 Arbeitstage, einschließlich Prototyp und W1b. Die Bibliothekspakete 0 bis 9 sind darin nicht enthalten. **Laufende Kosten** der empfohlenen Lösung: keine Lizenzkosten für CMS und Messung; KI wenige Euro im Monat; Datendienst für Suchvolumen bei Bedarf einstellig; Newsletter-Dienst je nach Wahl **[ANNAHME]**. + +### 14.3 Abhängigkeiten, Risiken und Migration je Stufe + +| Stufe | Wiederverwendeter Bestand | Architekturänderung | Migration | Hauptrisiko | +|---|---|---|---|---| +| W0 | Originalmotive, Token-Entwurf | keine | keine | Freigaben verzögern sich; Bildrechte ungeklärt | +| W1 | Layout, Blade-Vorlagen, Tailwind 4 | Pfadmodell der Seiten; Umgebungsabhängigkeit von `robots.txt` | Pfade bestehender Seiten bleiben; neue Spalten ergänzend | Sichtprüfung wird übersprungen | +| M0 | Ereignistabelle des Kerns | neuer Container für die Messung oder Eigenlösung | keine | Rechtsprüfung der Messung fehlt | +| W2 | Seiten, Revisionen, Bausteinprüfung, Vorschau | Bausteinvertrag mit Varianten; Vorlagen; globale Abschnitte | vorhandene Bausteindaten bleiben lesbar; neue Felder mit Vorgabewert | zu viele Varianten | +| W3 | Säulen als Themen; aus der Bibliothek: Inhaltsart (Paket 2), Strukturleser und Anzeigefreigabe (Paket 3), Klasse-A-Felder (Paket 4), Abdeckungsbefund (Paket 7) | öffentliches Profil; Leserichtung CMS → Katalog | keine Änderung an Fassungen, Ständen, Bestellungen | öffentliche Seite zeigt mehr, als ein Angebot deckt | +| W4 | Seitensystem | Autorenangaben | keine | Inhalte entstehen nicht | +| M1 | Zeitsteuerung, Warteschlange, Rollen | neues Modul Marketing | keine | zu wenig Daten; Schnittstellenänderungen | +| M2 | Seitenrevisionen als Entwurfsträger | Modelladapter, Protokoll | keine | ungeprüfte Aussagen; Abhängigkeit von einem Anbieter | + +Migrationen sind in allen Stufen ergänzend und abwärtskompatibel (Projektregel). Keine Stufe verändert Lizenz-, Versions- oder Bestelldaten. + +### 14.4 Was Coding-Agenten selbstständig bearbeiten können + +| Selbstständig nach Freigabe des Pakets | Erst nach gemeinsamer Entscheidung | +|---|---| +| Tokens und Grundkomponenten nach freigegebenen Werten | Farb-, Schrift- und Logofreigabe | +| Unterpfade, Weiterleitungen, Statuscodes, Sitemap, `robots.txt`, Social-Vorschau, Grundmarkup, jeweils mit Tests | Indexierungsregeln je Seitentyp | +| Bausteine nach festgelegtem Vertrag | Umfang der Bausteinbibliothek und der Varianten | +| Prüfliste vor Veröffentlichung | welche Prüfungen blockieren | +| Katalogbausteine als Lesesicht | Modell des öffentlichen Profils; Fassungswahl; Verträge der gemeinsamen Komponenten mit der Bibliothek | +| Editor-Prototyp bauen | Auswertung der Bedienaufgaben und Entscheidung über die CMS-Richtung | +| Abruf der Suchdaten mit nachgebildeter Schnittstelle in Tests | Messwerkzeug, Zugangsdaten, Datenschutzprüfung | +| Regeln mit Testdaten | Schwellen und Prioritäten | +| Modelladapter mit Testdouble | KI-Dienst, zulässige Aussagen, Freigabestufen | +| — | alles an `.gitea/workflows`, `Dockerfile`, `docker-compose.yml`, Server und Proxy (Projektregel) | + +Agenten veröffentlichen keine Inhalte und führen keine Kampagnen aus. Sichtprüfungen werden nur als durchgeführt gemeldet, wenn die Ansicht tatsächlich betrachtet wurde (`design-prinzipien`, §13). + +### 14.5 Gemeinsame Reihenfolge mit der Mitgliederbibliothek + +Grundlage ist der Umsetzungsplan der Bibliothek in der Fassung nach Review (Pakete 0 bis 9). Inhalt und Folge dieser Pakete bleiben unverändert. Diagramm, Verträge und Dateiregeln: Zielarchitektur, Kapitel 14. + +| Schritt | Bibliothek | Website und CMS | +|---|---|---| +| 0 | Paket 0 Bestandsaufnahme | W0 Markenbasis; W-P Editor-Prototyp; Verträge der gemeinsamen Komponenten festhalten | +| 1 | Paket 1 Lizenz und Bestellung; Paket 2 Inhaltsart | W1 ohne Mitgliedsansichten; M0 | +| 2 | Paket 3 Bibliothek; danach Tor A | W2 Seitensystem | +| 3 | Pakete 4 und 5 nacheinander; 6 und 7 parallel dazu | W1b Mitgliederbereich im Designsystem; W2 läuft weiter | +| 4 | Paket 8 Medienausgabe | W3 Öffentlicher Katalog in drei Teilen | +| 5 | Tor B | W4; danach M1 und M2 | + +**Einstufung der Bibliothekspakete:** + +| Einstufung | Pakete | Bedeutung | +|---|---|---| +| unverändert umsetzbar | 0, 1, 2, 4, 6, 8 | kein Abstimmungsbedarf; bei 2 und 4 werden Kennungen und Feldnamen als gemeinsamer Vertrag festgehalten | +| abhängig von gemeinsamen Komponenten | 3 | baut Strukturleser und Anzeigefreigabe, die auch die öffentlichen Objektseiten nutzen | +| | 5 | übernimmt die Säulen, auf denen die öffentlichen Themen beruhen | +| | 7 | baut den Abdeckungsbefund, den auch Angebots- und Programmseite lesen | +| | 9 | nutzt dieselbe Instanz-Suite wie die Sicht- und Leistungsprüfungen der Website | + +„Abhängig“ heißt: Der Vertrag der gemeinsamen Komponente steht vor Beginn des Pakets fest. Zuschnitt und Reihenfolge der Pakete ändern sich nicht. + +**Drei Regeln halten die Arbeit konfliktfrei:** + +1. Der Strukturleser kennt keine Person und keine Berechtigung; die Mitgliederansicht legt die Berechtigung als eigene Schicht darüber. So braucht die Website keinen zweiten Leser. +2. W1 fasst die Mitgliedsansichten nicht an. Sie werden von Paket 3 fachlich neu aufgebaut und erst danach in W1b gestalterisch umgestellt. +3. Tor A ist kein Starttor. Kaufaufrufe auf öffentlichen Seiten werden erst nach Tor B geschaltet. + +--- + +## 15. Fachliche und technische Abnahmekriterien + +| Stufe | Abnahme | +|---|---| +| **W0** | Wortmarke, Farben und Schriften sind schriftlich freigegeben. Die Kontrasttabelle weist für jede Textkombination mindestens 4,5:1 aus. Für jedes öffentlich vorgesehene Bild steht der Freigabestatus im Asset-Katalog. Fünf Signaturen sind in Graustufen unterscheidbar. | +| **W-P** | Die neun Bedienaufgaben und fünf technischen Kriterien aus der Zielarchitektur, 4.5 sind mit Zeiten protokolliert. Bestanden bei mindestens acht von neun Aufgaben einschließlich der drei Pflichtaufgaben, erfüllten technischen Kriterien und dem Urteil des Betreibers „so würde ich wöchentlich arbeiten“. Das Ergebnis ist als Entscheidung über die CMS-Richtung festgehalten. | +| **W1** | Alle öffentlichen Seiten verwenden ausschließlich Bedeutungswerte. Die Mitgliedsansichten sind unverändert und funktionsfähig. Keine Schrift wird von fremden Servern geladen. Eine Pfadänderung erzeugt eine 301-Weiterleitung; eine zurückgezogene Seite liefert 410; eine unbekannte 404. Die Sitemap enthält keinen Entwurf und keine Anwendungsadresse. Die Testumgebung liefert `noindex` und ist ohne Zugang nicht erreichbar. Sichtprüfung bei 390, 768 und 1440 px ist dokumentiert. Automatische Barrierefreiheitsprüfung ohne schwere Befunde. Gate und Tests grün. | +| **M0** | Search Console und Bing zeigen die Produktionsadresse als bestätigt. Ein Besuch, eine Registrierung, ein Abruf und ein Testkauf erscheinen als Ereignisse. Die Messung setzt kein Cookie und speichert keine Kennung im Browser. Die Datenschutzerklärung beschreibt die Messung. | +| **W1b** | Alle Mitgliedsansichten verwenden ausschließlich Bedeutungswerte und Grundkomponenten. Die automatisierten Tests der Bibliothekspakete 3 bis 7 bleiben ohne Änderung ihrer Erwartungen grün. Sichtprüfung bei 390, 768 und 1440 px ist dokumentiert. | +| **W2** | Der Betreiber legt ohne Hilfe aus einer Vorlage eine Landingpage an, ändert die Variante zweier Abschnitte, bindet einen globalen Abschnitt ein, sieht die Vorschau in drei Breiten und veröffentlicht. Eine Seite mit Bild ohne Alternativtext oder mit defektem internem Link lässt sich nicht veröffentlichen. Eine Änderung am globalen Abschnitt wirkt auf allen einbindenden Seiten nach dessen Veröffentlichung. Bestehende Seiten werden unverändert dargestellt. | +| **W3** | Ein gelistetes Programm mit gesetzter Inhaltsart erscheint ohne redaktionelle Seite unter seiner Adresse mit Kurzbeschreibung und Modulen in der Reihenfolge der gezeigten, zur Anzeige freigegebenen Fassung. Eine nur bereite Fassung und eine Identität ohne Inhaltsart erscheinen nirgends öffentlich. Ein enthaltenes Modul ist nur verlinkt, wenn seine öffentlich gezeigte Fassung der im Programm fixierten entspricht. Die Fassungswahl ist für ein Programm mit eigenem Artikel und für ein Programm aus Modul-Artikeln je einmal durchgespielt. Die Programmseite zeigt dieselbe Struktur wie die Mitgliederansicht. Preis und Rechte auf Angebots-, Programm- und Landingpage stimmen mit der aktiven Angebotsfassung überein; eine neue Fassung ändert alle drei ohne Bearbeitung. Kein geschütztes Medium ist über eine öffentliche Seite abrufbar; ein nicht freigegebenes Vorschaubild erscheint nicht (B04). Ein Material, das das Angebot nicht deckt, ist als „nicht enthalten“ gekennzeichnet. Filteransichten sind nicht indexierbar. | +| **W4** | Ein Beitrag ohne Autor, Stand oder verlinktes Modul lässt sich nicht veröffentlichen. Eine geplante Veröffentlichung wird zum Termin wirksam. Jede Zielgruppenseite führt zu genau einer Hauptaktion. | +| **M1** | Die Übersicht zeigt für jeden Wert Quelle, Zeitraum und Abrufzeitpunkt; fehlende Tage sind als fehlend markiert. Jede Maßnahme nennt die auslösende Regel und die zugrunde liegenden Zahlen. Eine erledigte Maßnahme erhält nach Ablauf des Vergleichszeitraums eine Wirkungsnotiz oder den Vermerk „nicht beurteilbar“. Das Marketingmodul enthält keine Personendaten. Tests laufen ohne Netzwerkzugriff. | +| **M2** | Jeder KI-Entwurf ist in der Verwaltung als solcher erkennbar und trägt Modell, Fassung der Anweisung und Zeitpunkt. Kein KI-Schritt kann veröffentlichen. Ein Entwurf mit markierter Stelle „Quelle nötig“ lässt sich nicht freigeben. Der Dienst erhält nachweislich keine Personendaten. Ein Ausfall des Dienstes beeinträchtigt weder Website noch Maßnahmenliste. Das Modell ist je Aufgabe ohne Codeänderung umstellbar. | + +Übergreifend gelten die Prüfkriterien aus `seo-prinzipien`, §15 und `design-prinzipien`, §13. + +--- + +## 16. Risiken und Abhängigkeiten + +| Nr. | Risiko | Wirkung | Gegenmaßnahme | +|---|---|---|---| +| 1 | Markenfreigabe und Bildrechte bleiben offen | W1 baut auf Vorschlägen; späterer Umbau | W0 als eigene Stufe mit Abnahme; Tokens zweistufig | +| 2 | Zu wenig freigegebenes Bildmaterial | gleichförmige Karten, schwache Seiten | Signaturen als Fallback; Bildbedarf je Seitentyp in W0 benennen | +| 3 | Inhalte entstehen langsamer als die Technik | leere Bereiche, dünne Seiten | „Wissen“ erst ab sechs Beiträgen in der Navigation; Indexierungsregel | +| 4 | Öffentliche Seite verspricht mehr als das Angebot | Vertrauens- und Rechtsrisiko | Katalogbausteine statt Text; Abdeckungsprüfung; Kennzeichnung „nicht enthalten“ | +| 5 | Institutionen werden angesprochen, können aber nicht kaufen | Enttäuschung, verlorene Nachfrage | Anfrageformular; A4 nach gemessener Nachfrage vorziehen | +| 6 | Variantenwildwuchs im Seitensystem | Pflegeaufwand, uneinheitliches Bild | Varianten sind Entwicklungsarbeit mit Sichtprüfung; Regel aus 10.4 | +| 7 | Marketingregeln feuern nicht wegen geringer Datenmenge | Cockpit wirkt leer | verkehrsunabhängige Prüfungen zuerst; Mindestmengen sichtbar | +| 8 | KI-Texte mit unbelegten Aussagen | Schaden für die Glaubwürdigkeit in einem sensiblen Feld | Freigabestufen; Liste zulässiger Aussagen; Markierung statt Glättung | +| 9 | Abhängigkeit von Schnittstellen Dritter | Ausfall von Zahlen | Adapter; Lücken als Lücken; kein Betriebsteil hängt davon ab | +| 10 | KI-Berichte von Google und Bing ohne Schnittstelle | manuelle Erfassung | monatlicher Export; keine Zusage im Konzept | +| 11 | Rechtliche Einordnung von Messung, Newsletter, KI-Kennzeichnung | Nacharbeit | Prüfbedarfe aus Kapitel 13 vor M0 und M2 klären | +| 12 | A1 wird durch W und M noch größer (`15`, R-24) | Verzug beim Verkaufsstart | W0 bis W3 sind der Website-Anteil von A1; M1 und M2 liegen ausdrücklich danach | +| 13 | Eltern als größte Besuchergruppe verfälschen die Zahlen | falsche Schlüsse | Leitkennzahl ist Nutzung, nicht Verkehr; Elternseite getrennt auswerten | +| 14 | Ein Betreiber, viele Rollen | Prüfung wird Formsache | wenige, klare Freigabestufen; Prüflisten kurz halten | +| 15 | Bibliothek und Website bauen Leser, Freigabe oder Abdeckungsbefund doppelt | zwei Wahrheiten über dieselbe Struktur; öffentliche Seite und Mitgliederansicht weichen ab | Verträge der gemeinsamen Komponenten vor Paket 3, 5 und 7; Abnahme B23 gilt auch für die öffentliche Seite | +| 16 | Gleichzeitige Arbeit an Mitgliedsansichten, Routen und Layout | Zusammenführungskonflikte, gebrochene Tests | W1 ohne Mitgliedsansichten; W1b nach Paket 3; Dateiregeln in der Zielarchitektur, 14.4 | +| 17 | Der Editor-Prototyp wird übersprungen oder nur von Entwicklern bedient | CMS-Richtung bleibt Annahme | W2 beginnt erst nach protokollierter Erprobung durch den Betreiber | +| 18 | Öffentliche Seite zeigt eine andere Fassung als die Bibliothek | Käufer erhält nicht, was die Seite beschreibt | nur zur Anzeige freigegebene Fassungen; Regel „folgt Stand“; Befund bei Abweichung | + +--- + +## 17. Offene Entscheidungen + +| Nr. | Entscheidung | Empfehlung | Blockiert | +|---|---|---|---| +| E-W1 | Wortmarke, Farbwerte, Schriften | Kapitel 7; dunkleres Grün für Text und Aktion | W1 | +| E-W2 | Herkunft und Rechte der Figurenbilder; Regel für öffentliche Verwendung | Asset-Katalog mit Freigabe je Bild | W0 | +| E-W3 | Zielgruppe für den Start | Einzeltrainer; Institutionen über Anfrage | W3, W4 | +| E-W4 | Kostenloses Einstiegsangebot | ein vollständiges Modul | W3 | +| E-W5 | Namentliche fachliche Verantwortung und genannte Qualifikation | auf jeder Fachseite | W4 | +| E-W6 | Elternansprache | eine Elternseite; Verzeichnis erst mit A3 | W4 | +| E-W7 | CMS-Richtung | Variante D als bevorzugte Variante unter Vorbehalt; Entscheidung nach dem Editor-Prototyp W-P | W2 | +| E-W8 | Modul und Programm als fachlicher Typ | **entschieden** im Ist-Soll-Abgleich (E-T): Werte der konfigurierbaren Inhaltsart; `CompositionKind` bleibt technischer Strukturtyp. Offen ist nur noch die Bestätigung der Zuordnung Inhaltsart → Seitentyp und Adresse (8.2). | W3 | +| E-W9 | Öffentliche Materialbeispiele: welche Filme und Unterlagen | je Themenbereich eines | W3 | +| E-W10 | „Wissen“ ab Start oder später | ab sechs Beiträgen | W4 | +| E-W11 | Fassungswahl öffentlicher Programmseiten | „folgt Stand“ bei eigenem Programm-Artikel; bestätigte freigegebene Fassung bei Programmen aus Modul-Artikeln (Zielarchitektur, 6.2) | W3 | +| E-W12 | Lernziele, Zeit- und Materialbedarf: Felder fehlen und stehen in keinem Bibliothekspaket | kleines eigenes Paket als Lehrinhalt an der Kompositionsfassung, vor oder mit W3 | W3, spätestens W4 | +| E-W13 | Verträge der gemeinsamen Komponenten mit der Bibliothek | vor Paket 3 festhalten (Zielarchitektur, 14.1) | Bibliothek Paket 3 | +| E-M1 | Werkzeug der Reichweitenmessung | Zielarchitektur, Kapitel 10 | M0 | +| E-M2 | Umgang mit KI-Crawlern | Antwort- und Suchcrawler zulassen; Trainingscrawler nach Haltung | W1 | +| E-M3 | KI-Dienst und Verarbeitungsort | Adapter; Start mit einem Anbieter mit Auftragsverarbeitung | M2 | +| E-M4 | Newsletter: ja oder nein, Werkzeug | zunächst nur Vertragsmitteilungen; Newsletter mit W4 | W4 | +| E-M5 | n8n: Einsatz und Standort | erst mit M3, nur für fremde Kanäle | M3 | +| E-M6 | Kanonische Adresse der Website (mit oder ohne `www`) | eine Form, die andere leitet weiter | W1 | +| — | Preise, Lizenztypen, Bedingungen (OPEN-03) | außerhalb dieses Konzepts, aber Voraussetzung für Angebotsseiten | W3 | + +--- + +## 18. Kritische Eigenprüfung + +**Perspektive 1 – Produktentwicklung.** Die Positionierung als Konzept ist in Navigation, Seitentypen und Katalog durchgehalten; Einzelfilme haben keine Verkaufsebene. Differenzierung entsteht durch Vertrauen und gezeigtes Material. Wachstum ist über Altersdimension und Produktlinie angelegt. *Schwäche:* Der größte Wachstumshebel, Institutionen, ist bis A4 nicht kaufbar. + +**Perspektive 2 – Architektur.** Keine neue Laufzeit, kein zweites CMS, keine Datenkopie; Marketing als Modul mit eigener Datenhaltung ohne Personenbezug. *Schwäche:* Das Seitensystem bleibt Eigenentwicklung und damit Pflegeaufwand; die Vorschaubearbeitung wird nie den Komfort eines spezialisierten Produkts erreichen. + +**Perspektive 3 – Betreiber und Anwender.** Vorlagen und Varianten decken die alltäglichen Fälle; Trainer finden über Themen, Programme und Zielgruppen. *Schwäche:* Die Menge an Entscheidungen und Inhalten, die der Betreiber vor dem Start liefern muss, ist groß. + +**Erkannte Zielkonflikte und ihre Auflösung:** + +| Konflikt | Auflösung | +|---|---| +| Strategie will viele Landingpages und Beiträge, der Betreiber hat wenig Zeit | Vorlagen senken die Kosten je Seite; Mengengerüst ist bewusst klein; Qualität vor Frequenz | +| Maximale Konfigurierbarkeit gegen Markenkonsistenz | Varianten als Bedeutungen; neue Variante ist bewusste Entwicklung | +| Automatisierung gegen Vertrauen | vier Freigabestufen; nichts mit Fachaussage ohne Mensch | +| Transparenter öffentlicher Katalog gegen Schutz der Inhalte | öffentliches Profil zeigt Struktur und Ziele, nie Dateien; Vorschaubilder nur nach Freigabe | +| Datengetriebenes Marketing gegen geringe Datenmenge am Anfang | Regeln ohne Verkehrsbedarf zuerst; Mindestmengen | +| Institutionen als Zielgruppe gegen Verkauf nur an Einzelpersonen | ehrliche Anfrage statt Scheinangebot; Nachfrage messen | +| Komfort eines fertigen CMS gegen Einheit der Verwaltung | Eigenkern bevorzugt; ein Prototyp mit Bedienaufgaben entscheidet; Wechselkriterien benannt (10.7) | +| Bibliothek soll schnell und ohne Designsystem entstehen, die Website braucht dieselben Bausteine | gemeinsame Komponenten einmal bauen, nach abgestimmtem Vertrag; Gestaltung der Bibliothek als eigener späterer Schritt (W1b) | +| Früher Start gegen vollständige Markenbasis | W0 ist klein gehalten und blockiert nur W1 | + +--- + +## 19. Folgeänderungen an bestehenden Dokumenten + +Nach Annahme dieses Konzepts sind anzupassen. Die vollständige Liste mit Abschnitten steht in der Zielarchitektur, Kapitel 13. + +| Dokument | Anlass | +|---|---| +| `docs/prinzipien/design-prinzipien.md` | Verweis auf freigegebene Tokens und Signaturen; Kursplayer als Add-on (bereits im Abgleich als A06 benannt) | +| `docs/prinzipien/seo-und-content-prinzipien.md` | Stand der unterstützten Ergebnisarten; Berichte zu KI-Funktionen; Indexierungsregel | +| `docs/architektur/09_CMS_Administration_Community.md` | Seitentypen und Bausteine sprechen noch von Episoden und Artikeln; Vorlagen, Varianten, globale Abschnitte, öffentliches Profil | +| `docs/architektur/03`, `04`, `10`, `11`, `12`, `13`, `15`, `16` | Modul Marketing, Schnittstellen, Entscheidungen, Risiken, Spuren W und M | +| `docs/fachkonzept/produktkonfiguration-und-mitgliederbereich.md` | öffentliche Sichtbarkeit von Fachobjekten und Vorschaubildern | +| `docs/Brand-UI-Kit/README.md` | Status der Studie nach W0 | +| `docs/tasks/SEO-Marketing.md` | als durch dieses Konzept abgelöst kennzeichnen | +| `docs/analysen/umsetzungsplan-mitgliederbibliothek.md` | Vertragsvermerke an den Paketen 3, 5, 7 und 9; Verweis auf die gemeinsame Reihenfolge. Inhalt und Folge der Pakete bleiben. | +| `docs/analysen/ist-soll-abgleich-mitgliederbibliothek.md` | Verweis bei E-A und E-D auf die Regelung der öffentlichen Programmseiten | + +--- + +## 20. Quellen und Recherchegrundlagen + +**Prüfdatum aller Abrufe: 15.11.2026.** Einstufung wie in `10_Technologiebewertung.md`: **[B]** Hersteller- oder Primärquelle, selbst abgerufen · **[D]** Drittquelle oder nur über Suchauszug · **[E]** Erfahrungswissen ohne aktuelle Prüfung. + +| Nr. | Quelle | Verwendet für | Einstufung | +|---|---|---|---| +| Q01 | Google Search Central, „AI features and your website“ — https://developers.google.com/search/docs/appearance/ai-features | keine Sonderanforderungen, Steuerung, Berichtswesen | B | +| Q02 | Google Search Central, Galerie strukturierter Daten — https://developers.google.com/search/docs/appearance/structured-data/search-gallery | unterstützte Typen; FAQ nicht aufgeführt | B | +| Q03 | Google Search Central Blog, 12.06.2025, „Simplifying search results“ — https://developers.google.com/search/blog/2025/06/simplifying-search-results | Einstellung von „Course info“ | D (Suchauszug) | +| Q04 | Google Search Central Blog, 03.06.2026, Berichte zu generativer KI — https://developers.google.com/search/blog/2026/06/gen-ai-performance-reports | Umfang des Berichts, weltweite Verfügbarkeit | B | +| Q05 | Google Search Central, Leitfaden zu KI-erzeugten Inhalten — https://developers.google.com/search/docs/fundamentals/using-gen-ai-content | Prüfpflicht, Massenerzeugung | B | +| Q06 | Google, Nutzungsgrenzen der Search-Console-Schnittstelle — https://developers.google.com/webmaster-tools/limits | Abfragegrenzen | D (Suchauszug der Herstellerseite) | +| Q07 | Bing Webmaster Blog, 10.02.2026, AI Performance — https://blogs.bing.com/webmaster/February-2026/Introducing-AI-Performance-in-Bing-Webmaster-Tools-Public-Preview | Kennzahlen des Berichts | B | +| Q08 | Filament 5, Builder — https://filamentphp.com/docs/5.x/forms/builder | Blöcke, Vorschau, Grenzen | B | +| Q09 | Filament 5, Rich Editor — https://filamentphp.com/docs/5.x/forms/rich-editor | eigene Blöcke im Text | B | +| Q10 | Packagist, `pboivin/filament-peek` — https://packagist.org/packages/pboivin/filament-peek | Vorschau-Plugin, Filament 5 | B | +| Q11 | Packagist, `awcodes/mason` — https://packagist.org/packages/awcodes/mason | Blockeditor-Feld | B | +| Q12 | Packagist, `crumbls/layup` — https://packagist.org/packages/crumbls/layup | freier Page Builder | D (Suchauszug) | +| Q13 | Statamic, Preise — https://statamic.com/pricing | Lizenzkosten, Umfang Pro | B | +| Q14 | Packagist, `statamic/cms` — https://packagist.org/packages/statamic/cms | Version 6.42, Laravel 12.40 oder 13, Lizenz „proprietary“ | B | +| Q15 | Packagist, `area17/twill` — https://packagist.org/packages/area17/twill | Version 3.6, Laravel 13, Apache-2.0 | B | +| Q16 | Storyblok, Preise — https://www.storyblok.com/pricing | Tarife | B | +| Q17 | Payload, Quellcodeverzeichnis — https://github.com/payloadcms/payload ; Berichte zur Übernahme durch Figma mit widersprüchlichen Daten | Lizenz MIT, Next.js-Bindung | B / D | +| Q18 | n8n, Lizenztext — https://raw.githubusercontent.com/n8n-io/n8n/master/LICENSE.md | Nutzung für eigene Geschäftszwecke | B | +| Q19 | n8n, menschliche Prüfung von Werkzeugaufrufen — https://docs.n8n.io/advanced-ai/human-in-the-loop-tools/ | Freigabeschritt; Verfügbarkeit in der Community-Ausgabe nicht bestätigt | B | +| Q20 | Packagist, `spatie/laravel-sitemap` — https://packagist.org/packages/spatie/laravel-sitemap | Laravel 13, MIT | B | +| Q21 | KI-Verordnung, Art. 50 (nichtamtliche Fassung) — https://artificialintelligenceact.eu/article/50/ ; Kanzleibeiträge zur Änderungsverordnung 2026 | Kennzeichnung, Ausnahme, Geltungsbeginn | D | +| Q22 | Beiträge von Händlerbund und IHK zum Barrierefreiheitsstärkungsgesetz, z. B. https://ohn.haendlerbund.de/recht/rechtsfragen/kleinstunternehmen-bfsg-ausnahme | Kleinstunternehmen, Geltung | D | +| Q23 | Fachbeiträge zu § 25 TDDDG und Messung ohne Cookies, z. B. https://www.dr-datenschutz.de/cookieless-tracking-ohne-einwilligung-und-google-analytics/ | Einwilligungserfordernis | D | +| Q24 | Bayerischer Jugendring, Information Selbstbehauptung — https://www.bjr.de/fileadmin/redaktion/5._Handlungsfelder/Praevention_und_Jugendschutz/Material_Praevention/2023-03-29_Info_Selbstbehauptung_BJR-CD_final.pdf ; DGUV — https://publikationen.dguv.de/widgets/pdf/download/article/4663 ; Ökotest — https://www.oekotest.de/kinder-familie/Ratgeber-Selbstbehauptungskurse_95632_1.html | Qualitätskritik am Markt | D (nur Suchauszüge; Originale nicht gelesen) | +| Q25 | Anthropic, Modellpreise laut API-Referenz, Stand 03.11.2026 — https://platform.claude.com/docs | Kostenrechnung | B (zwischengespeicherte Referenz; vor Budgetierung an der Preisseite prüfen) | +| Q26 | DataForSEO, Preisangaben — https://dataforseo.com/pricing/keywords-data/clickstream-api-pricing | Größenordnung der Kosten | D (widersprüchliche Auszüge) | +| Q27 | Search Engine Land, Leitfaden zu `llms.txt` — https://searchengineland.com/guide/llms-txt | keine bestätigte Nutzung durch große Anbieter | D | +| Q28 | WCAG 2.2 — https://www.w3.org/TR/WCAG22/ ; Core Web Vitals — https://web.dev/articles/vitals | Ziele | E (Schwellen aus Kenntnis, in dieser Sitzung nicht erneut abgerufen) | + +**Nicht belegt oder nicht geprüft:** tatsächliches Suchvolumen aller genannten Anfragen; Marktanteile und Preise vergleichbarer Angebote; Schnittstellen für die KI-Berichte von Google und Bing; Verfügbarkeit des n8n-Freigabeschritts in der Community-Ausgabe; Lizenzen und Datenbankanforderungen der Messwerkzeuge (Erfahrungswissen); Rechtslage in allen Punkten des Kapitels 13; Zustand von Server, Proxy und Testschutz; Rechte an den Bildern. Die Kontrastwerte in 5.3 sind eigene Berechnungen. diff --git a/docs/tasks/SEO-Marketing.md b/docs/tasks/SEO-Marketing.md new file mode 100644 index 0000000..a783cbb --- /dev/null +++ b/docs/tasks/SEO-Marketing.md @@ -0,0 +1,396 @@ +\# Lara \& Felix – SEO, KI-Suche und autonomes Marketing + + + +Diese Anforderungen ergänzen den bestehenden Cursor-Entwicklungsauftrag. + + + +Marketing und Auffindbarkeit sind integrale Bestandteile der Plattform und müssen bereits bei der Entwicklung der öffentlichen Webseite und des CMS berücksichtigt werden. + + + +\## 1. Strategisches Ziel + + + +Die Plattform soll kontinuierlich qualifizierte Interessenten erreichen, insbesondere Gewaltschutztrainer, Lehrkräfte, pädagogische Fachkräfte und Vereine. + + + +Ziel ist eine nachhaltige Steigerung von: + + + +\- Organischer Sichtbarkeit + +\- Qualifizierten Webseitenbesuchen + +\- Sichtbarkeit als Quelle in KI-Suchsystemen + +\- Registrierungen + +\- Nutzung kostenloser Materialien + +\- Verkäufen und wiederkehrenden Kunden + + + +Ein bestimmtes Suchmaschinenranking darf nicht garantiert werden. + + + +\## 2. Technische SEO- und GEO-Grundlage + + + +Implementiere für alle geeigneten öffentlichen Seiten: + + + +\- Servergerendertes, semantisches HTML + +\- Individuelle Seitentitel und Meta-Beschreibungen + +\- Konfigurierbare kanonische URLs + +\- XML-Sitemap, automatisch aus veröffentlichten Seiten und Katalogobjekten + +\- Korrekte robots.txt-Steuerung + +\- Indexierungsregeln für Entwürfe, Archive und geschützte Inhalte + +\- Open-Graph-Metadaten und Vorschaubilder + +\- Strukturierte Daten nach schema.org, sofern für den konkreten Inhalt sinnvoll und von Suchmaschinen unterstützt + +\- Interne Verlinkungen zwischen Themen, Inhalten, Lizenzartikeln und Angeboten + +\- Lesbare, stabile URL-Strukturen + +\- Weiterleitungen bei Änderung veröffentlichter URL-Pfade + +\- Optimierte Bilder und Ladezeiten + +\- Mobile-First- und barrierearme Darstellung + + + +Die Testumgebung darf nicht öffentlich indexiert werden. + + + +Private Mitgliederseiten, Bestellungen, personenbezogene Daten und geschützte Medien dürfen niemals über SEO-Funktionen öffentlich zugänglich werden. + + + +\## 3. Dynamische SEO-Seiten aus dem Katalog + + + +Nutze das bestehende flexible Inhalts- und Produktmodell. + + + +Ermögliche automatisch erzeugte beziehungsweise aktualisierte öffentliche Seiten für: + + + +\- Lizenzartikel + +\- Filme + +\- Übungen + +\- Trainingsprogramme + +\- Themen + +\- Pakete und Angebote + + + +Die Seiten sollen ihre fachlich maßgeblichen Daten aus veröffentlichten Artikel- und Angebotsfassungen beziehen. + + + +Zusätzliche redaktionelle Texte dürfen diese Daten ergänzen. + + + +Es dürfen keine widersprüchlichen Preise, Lizenzrechte oder Leistungszusagen entstehen. + + + +Bereits veröffentlichte Inhalte sollen durch neue Versionen aktualisierbar sein, ohne die bestehenden Versionsregeln zu umgehen. + + + +Nicht jede Kombination von Artikeln, Kategorien oder Schlagwörtern darf automatisch zu einer eigenen indexierbaren Seite führen. Vermeide dünne, doppelte oder ausschließlich für Suchmaschinen erzeugte Seiten. + + + +\## 4. Optimierung für KI-basierte Suche + + + +Gestalte öffentliche Inhalte so, dass Such- und KI-Systeme sie nachvollziehen können: + + + +\- Klare Themenstruktur + +\- Verständliche Überschriften + +\- Präzise Antworten auf häufige fachliche Fragen + +\- Fachlich nachvollziehbare Erklärungen + +\- Eindeutige Angaben zu Autoren, Herausgebern und Qualifikationen + +\- Belegte Aussagen mit Quellenangaben + +\- Strukturierte, konsistente Beschreibung der Inhalte + +\- Gut zugängliche Textinformationen zu vorhandenen Filmen + +\- Stabile URLs und öffentliche Verlinkbarkeit + + + +Nutze öffentliche Vorschautexte und gegebenenfalls freigegebene Transkriptauszüge, ohne kostenpflichtige oder vertrauliche Inhalte offenzulegen. + + + +Erfinde keine Fachqualifikationen, wissenschaftlichen Belege oder Erfolgsaussagen. + + + +Implementiere keine angeblichen GEO-Tricks ohne belastbare Grundlage. + + + +\## 5. Marketing- und Redaktionsfunktionen + + + +Erweitere das bestehende CMS schrittweise um einen Marketingbereich. + + + +Dieser soll ermöglichen: + + + +\- Verwaltung von Zielgruppen und Themenschwerpunkten + +\- Anlage von Themenclustern + +\- Planung von Beiträgen und Kampagnen + +\- Redaktionelle Landingpages + +\- SEO-Prüfung vor Veröffentlichung + +\- Vorschläge für interne Verlinkung + +\- Identifikation veralteter Inhalte + +\- Übersicht geplanter und veröffentlichter Maßnahmen + + + +Marketinginhalte nutzen die vorhandenen Entwurfs-, Revisions- und Veröffentlichungsmechanismen. + + + +Es entsteht kein zweites unabhängiges CMS. + + + +\## 6. Kontinuierliche Marketing Intelligence + + + +Bereite die Integration folgender Datenquellen vor: + + + +\- Google Search Console + +\- Bing Webmaster Tools + +\- Datenschutzkonforme Webanalyse + +\- Interne Registrierung- und Verkaufskennzahlen + + + +Die Anbindung erfolgt über klar getrennte Adapter. + + + +Sobald die erforderlichen Zugänge vorhanden sind, soll das System periodisch: + + + +1\. Suchleistung und Veränderungen analysieren. + +2\. Erfolgreiche und schwache Seiten identifizieren. + +3\. Relevante Suchanfragen und Themenchancen erkennen. + +4\. Fehlende oder unvollständige Inhalte feststellen. + +5\. Konkrete Verbesserungsmaßnahmen vorschlagen. + +6\. Priorisierte Marketingaufgaben erzeugen. + +7\. Die Wirkung durchgeführter Maßnahmen verfolgen. + + + +Unterscheide gemessene Kennzahlen, geschätzte Chancen und KI-generierte Empfehlungen. + + + +\## 7. KI-gestützte Marketingautomatisierung + + + +Plane einen konfigurierbaren Marketingassistenten innerhalb der vorhandenen Plattformarchitektur. + + + +Er soll langfristig: + + + +\- Themen recherchieren + +\- Themencluster vorschlagen + +\- Content-Briefings erstellen + +\- Fachartikelentwürfe vorbereiten + +\- Titel und Beschreibungen optimieren + +\- Bestehende Seiten auf Verbesserungsmöglichkeiten untersuchen + +\- Interne Verlinkungen vorschlagen + +\- Marketingmaßnahmen priorisieren + +\- Regelmäßige Erfolgsberichte erzeugen + + + +Verwende austauschbare KI-Modelle und konfigurierbare API-Zugänge. + + + +Trenne Vorschlag, fachliche Prüfung, Freigabe und Veröffentlichung. + + + +Technische Routineaufgaben dürfen automatisiert erfolgen. Neue fachliche Aussagen, Wirkungsversprechen, externe Kampagnen und Veröffentlichungen müssen standardmäßig durch einen berechtigten Benutzer freigegeben werden. + + + +Keine unkontrollierte Massenproduktion von SEO-Texten. + + + +\## 8. Marketing-Dashboard + + + +Das Administrationssystem soll schrittweise ein Dashboard erhalten mit: + + + +\- Organischen Impressionen und Klicks + +\- Suchanfragen und Landingpages + +\- Klickrate und Rankingentwicklung, soweit tatsächlich messbar + +\- Registrierungs- und Conversion-Raten + +\- Nutzung kostenloser Inhalte + +\- Kaufabschlüssen + +\- Sichtbarkeit beziehungsweise Quellenzitaten in KI-Suchsystemen, soweit entsprechende Daten bereitgestellt werden + +\- Erkannten Problemen und priorisierten Empfehlungen + + + +Kennzeichne nicht vorhandene Daten ausdrücklich. Keine erfundenen Marketingkennzahlen. + + + +\## 9. Entwicklungspriorisierung + + + +\### Sofort in U0 und den ersten CMS-Funktionen + + + +Implementiere die technischen Grundlagen für SEO, strukturierte Seiten, Metadaten, Sitemap, Indexierungssteuerung und ein suchmaschinenfreundliches Design. + + + +\### Während des MVP-Ausbaus + + + +Ergänze dynamische Katalogseiten, Themen- und Landingpages, redaktionelle SEO-Funktionen sowie die Messbarkeit wichtiger Nutzerwege. + + + +\### Danach als kontinuierliche Funktion + + + +Implementiere die Datenintegration, automatisierte Marketinganalysen, KI-gestützte Empfehlungen und die wiederkehrende Marketingsteuerung. + + + +Die automatisierten Marketingfunktionen dürfen den Entwicklungsstart oder die Fertigstellung des funktionsfähigen MVP nicht blockieren. + + + +\## 10. Qualitätssicherung + + + +Prüfe: + + + +\- Öffentliche Seiten enthalten sinnvolle Metadaten. + +\- Nicht veröffentlichte und geschützte Inhalte erscheinen nicht in der Sitemap. + +\- Mitgliederbereiche bleiben von Suchmaschinen und unberechtigten Nutzern abgeschirmt. + +\- Strukturierte Daten stimmen mit sichtbaren Inhalten überein. + +\- Geänderte URL-Pfade erzeugen passende Weiterleitungen. + +\- Neue Katalogeinträge erzeugen keine unerwünschten Duplikate. + +\- Die Webseite erfüllt die festgelegten Performance- und Zugänglichkeitsziele. + + + +\*\*Ziel ist eine technisch hervorragend auffindbare Plattform mit einem dauerhaft messbaren, zunehmend automatisierten Marketingprozess – keine vermeintliche Garantie für Suchmaschinenplatzierungen.\*\* + + + +Setze die Grundlagen im laufenden Entwicklungsauftrag unmittelbar um. Keine neue Architekturstudie und kein zusätzlicher Freigabe-Stopp. + diff --git a/docs/tasks/Strategieentwicklung.md b/docs/tasks/Strategieentwicklung.md new file mode 100644 index 0000000..74c74e2 --- /dev/null +++ b/docs/tasks/Strategieentwicklung.md @@ -0,0 +1,1048 @@ +# Lara & Felix – Strategische, fachliche und technische Weiterentwicklung der Plattform + +## 0. Rolle und Zielsetzung + +Du agierst als interdisziplinäres Expertenteam unter Leitung eines erfahrenen **Digital Product Strategist und Principal Software Architect**. + +Deine fachlichen Kompetenzbereiche umfassen: + +- Digitale Produkt- und Plattformstrategie +- Geschäftsmodelle für digitale Bildungsprodukte +- Markenstrategie und Positionierung +- UX/UI-Design und professionelle Designsysteme +- Content-Management-Systeme und konfigurierbare Webplattformen +- SEO, Content-Marketing und Sichtbarkeit in KI-gestützter Suche +- Marketing Intelligence und Marketingautomatisierung +- KI-gestützte Workflows und Agentenarchitekturen +- Laravel, Filament und Integrationsarchitekturen +- Datenmodellierung, Lizenzsysteme und Medienverwaltung +- Technische Roadmap- und Implementierungsplanung + +### Dein übergeordnetes Ziel + +Entwickle eine fundierte, langfristig tragfähige **strategische, fachliche und technische Gesamtplanung** für die Plattform: + +**„Lara & Felix – Stark im Alltag“** + +Die Planung soll uns in die Lage versetzen, die Plattform schrittweise zu einem professionellen, skalierbaren digitalen Bildungs- und Vermarktungsangebot auszubauen. + +Dabei sollen vorhandene Investitionen und Implementierungen möglichst sinnvoll weiterverwendet werden. + +**Wichtig: Dies ist ausdrücklich kein primärer Code-Review oder Fehlerbehebungsauftrag.** + +Deine Aufgabe besteht darin, ein überzeugendes Zukunftskonzept zu entwickeln, unterschiedliche Lösungsansätze systematisch zu untersuchen und fundierte Empfehlungen für die strategische und technische Weiterentwicklung auszuarbeiten. + +Vorhandene Technologien und Konzepte sind wichtige Rahmenbedingungen, dürfen aber innovative oder geeignetere Lösungen nicht von vornherein ausschließen. + +--- + +# Teil A – Bestehendes Projektverständnis und Grundlagen + +## 1. Das Produkt Lara & Felix + +„Lara & Felix – Stark im Alltag“ ist ein digitales Bildungsangebot zur Gewaltprävention, Selbstbehauptung und Förderung sicherer Handlungsentscheidungen bei Kindern. + +Die Plattform richtet sich insbesondere an: + +- Gewaltschutz- und Selbstbehauptungstrainer +- Karate- und andere Kampfsporttrainer mit Präventionsangeboten +- Lehrkräfte und pädagogische Fachkräfte +- Vereine und Bildungseinrichtungen +- Perspektivisch weitere institutionelle Anbieter + +Das Produkt besteht nicht primär aus Filmen. + +Sein fachlicher Wert entsteht aus dem Zusammenwirken von: + +1. Strukturierten Trainingsprogrammen +2. Flexibel einsetzbaren Trainingsmodulen +3. Praktischen Übungen und Selbstbehauptungsmethoden +4. Didaktischen Kurzfilmen und Alltagsszenen +5. Traineranleitungen und methodischen Hinweisen +6. Merkblättern, Arbeitsblättern und weiteren Begleitmaterialien + +Die Filme unterstützen die pädagogische Arbeit, sind jedoch nicht zwingend Bestandteil jedes Moduls. + +Die Inhalte werden fachlich klassifiziert, können mehrfach verwendet und zu unterschiedlichen Programmen und kommerziellen Angeboten zusammengestellt werden. + +Die erste Produktreihe richtet sich insbesondere an Kinder von etwa sechs bis sieben Jahren. Die Plattformarchitektur soll weitere Altersgruppen und Produktlinien ermöglichen. + +## 2. Strategische Ausgangssituation + +Eine erste Version der Plattform wurde bereits implementiert. + +Sie verfügt über Teile eines differenzierten Inhalts-, Produkt-, Lizenz- und Versionsmodells. + +Die bestehende Anwendung entspricht jedoch noch nicht dem gewünschten professionellen Produktniveau. + +Insbesondere folgende Bereiche benötigen eine umfassende strategische und konzeptionelle Weiterentwicklung: + +- Öffentliche Website und Markenpräsentation +- Gesamtheitliches UX/UI-Design +- Konfigurierbare CMS-Funktionen +- Professionelle Darstellung von Programmen und Modulen +- SEO- und Content-Architektur +- Redaktionelle und marketingbezogene Workflows +- Datengestützte Marketingsteuerung +- Automatisierbare Marketingprozesse + +Für den Mitgliederbereich existiert inzwischen eine konkretisierte Fachspezifikation. + +**Die Mitgliederbibliothek hat Vorrang vor einem spezialisierten didaktischen Kursplayer.** Geschütztes Streaming und die einfache Nutzung berechtigter Materialien bleiben erforderlich. Ein Kursplayer mit automatischer Denkpause, Ablaufsteuerung oder Präsentationsmodus ist ein späteres Add-on. + +## 3. Verbindliche Projektunterlagen + +Lies zunächst die vorhandenen Projektunterlagen und ermittle bei Bedarf deren tatsächliche Speicherorte. + +Besonders wichtig sind: + +### Fachliche Grundlagen + +- `docs/fachkonzept/trainingskonzept-und-produktstruktur.md` +- `docs/fachkonzept/produktkonfiguration-und-mitgliederbereich.md` +- `docs/architektur/abgleich-produktkonfiguration-und-mitgliederbereich.md` + +### Design und Marketing + +- `docs/prinzipien/design-prinzipien.md` +- `docs/prinzipien/seo-und-content-prinzipien.md` + +### Technische Grundlagen + +- Bestehendes Domänenmodell +- Zielarchitektur +- CMS- und Administrationskonzept +- Medien- und Streamingarchitektur +- Lizenz- und Berechtigungsmodell +- MVP-Definition und Roadmap + +Untersuche außerdem die tatsächliche Projektstruktur und relevante Teile der bestehenden Implementierung, soweit dies für die strategischen Entscheidungen erforderlich ist. + +Ein vollständiger Code-Audit ist nicht Gegenstand dieses Auftrags. + +### Umgang mit dem Entscheidungsstand + +Unterscheide konsequent: + +- **Verbindlich beschlossen:** Bereits festgelegte fachliche Anforderungen +- **Bestehender Entwurf:** Dokumentierte Lösung, aber nicht zwingend endgültige Architekturentscheidung +- **Nachgewiesen:** Durch Quellen oder tatsächliche Implementierung belegte Erkenntnis +- **Empfehlung:** Dein begründeter Vorschlag +- **Offene Entscheidung:** Erfordert noch eine Entscheidung des Auftraggebers + +Übernimm keine technischen Entwurfsentscheidungen allein deshalb als verbindlich, weil sie in einem vorhandenen Dokument stehen. + +Bereits bestätigte fachliche Produktanforderungen dürfen dagegen nicht stillschweigend aufgehoben werden. + +--- + +# Teil B – Bestehende Designstudie und strategische Neuausrichtung + +## 4. Designstudie als Ausgangsbasis + +Untersuche die bestehende Designstudie: + +**„Lara & Felix – Brand & UI Kit v1.0“** +du findest die Dateien unter docs/Brans-UI-Kit + +Berücksichtige sämtliche tatsächlich verfügbaren Bestandteile, insbesondere: + +- Gestaltungsprinzipien +- Marken- und Logovarianten +- Farbpalette und Design-Tokens +- Typografievorgaben +- Komponenten und UI-Elemente +- Bildsprache und Illustrationen +- Website-Mockups +- Katalog- und Angebotsansichten +- Mitglieder- und Playeransichten +- Mobile und responsive Varianten +- Etwaige HTML-/CSS-Prototypen und technische Assets + +Suche die Studie in den bereitgestellten Projektdateien beziehungsweise im Repository. Falls sie als ZIP vorliegt, untersuche den Inhalt einschließlich vorhandener visueller Dateien. + +Sollten Teile fehlen oder nicht lesbar sein, dokumentiere dies konkret. Erfinde keine angeblich gesehenen Entwurfsdetails. + +## 5. Kritische Einordnung der bisherigen Designstudie + +Die Studie entstand zu einem Zeitpunkt, an dem die Plattform wesentlich stärker als **Film-Verkaufsplattform** konzipiert war. + +Die fachliche und kommerzielle Produktstrategie hat sich inzwischen weiterentwickelt. + +Die künftige Plattform soll vorrangig als **professionelles Trainings- und Präventionskonzept** wahrgenommen werden. + +Daher gilt: + +**Die vorhandene Designstudie ist eine wichtige gestalterische Referenz, aber keine verbindliche fachliche Vorgabe für die zukünftige Informationsarchitektur oder Benutzerführung.** + +Bewerte systematisch: + +1. Welche Markenelemente sollten wir erhalten? +2. Welche Design-Tokens und Komponenten sind bereits geeignet? +3. Welche visuellen Muster lassen sich für Programme, Module und Trainingsmaterialien wiederverwenden? +4. Welche Seitentypen sind zu stark auf Einzelvideos und deren Verkauf ausgerichtet? +5. Welche Darstellungsformen fehlen vollständig? +6. Wie lässt sich die vorhandene Markenidentität weiterentwickeln, ohne einen unnötigen gestalterischen Neustart vorzunehmen? + +Erstelle dazu eine **Design-Transformationsmatrix**: + +| Bestehendes Element | Ursprünglicher Zweck | Fachliche Eignung | Empfehlung | Zielverwendung | +|---|---|---|---|---| + +Unterscheide ausdrücklich zwischen: + +- Beibehalten +- Weiterentwickeln +- Ersetzen +- Neu konzipieren + +Arbeite nicht nur mit subjektiven Designurteilen, sondern begründe deine Bewertung anhand der Produktstrategie, der Nutzungsziele und professioneller UX-Prinzipien. + +--- + +# Teil C – Produkt-, Marken- und Vermarktungsstrategie + +## 6. Zielgruppen und Positionierung + +Entwickle eine differenzierte Strategie für die zukünftige Marktpositionierung. + +Untersuche insbesondere: + +- Unterschiede zwischen ehrenamtlichen und kommerziellen Trainern +- Anforderungen von Lehrkräften und pädagogischen Einrichtungen +- Anforderungen von Vereinen und institutionellen Lizenznehmern +- Typische Entscheidungs- und Kaufprozesse +- Vertrauensbildung bei pädagogischen Präventionsangeboten +- Fachliche Kompetenz als Differenzierungsmerkmal +- Möglichkeiten der Kundenbindung +- Kostenlose Einstiegsangebote +- Produkt- und Lizenzvarianten +- Langfristige Erweiterung auf weitere Altersgruppen + +Berücksichtige, dass die Plattform zunächst von einem kleinen Betreiberteam geführt wird. + +Die Strategie muss deshalb nicht nur professionell, sondern auch mit vertretbarem Personal- und Betriebsaufwand realisierbar sein. + +## 7. Customer Journeys + +Entwickle die wesentlichen Nutzerreisen. + +Beispielsweise: + +**Journey A – Fachliche Informationssuche** + +Suchanfrage → Fachbeitrag → Themenseite → Trainingsmodul → kostenloses Beispiel → Registrierung + +**Journey B – Konkreter Trainingsbedarf** + +Zielgruppenbezogene Landingpage → Programmübersicht → Leistungsumfang → Lizenzvergleich → Kauf → Mitgliederbibliothek + +**Journey C – Bestehender Trainer** + +Mitgliederbibliothek → neues Modul entdecken → passende Programmerweiterung → zusätzliches Angebot + +**Journey D – Institutioneller Interessent** + +Informationsseite → Einsatzmöglichkeiten → Lizenzmodell → Kontakt oder institutioneller Beschaffungsprozess + +Prüfe und verbessere diese beispielhaften Journeys. + +Leite daraus Anforderungen an die Website, Navigation, Angebotspräsentation und Marketingsteuerung ab. + +--- + +# Teil D – Website- und UX-Zielkonzept + +## 8. Informationsarchitektur + +Entwickle eine neue Informationsarchitektur für die öffentliche Website. + +Der Schwerpunkt muss auf dem pädagogischen Gesamtkonzept liegen. + +Untersuche insbesondere folgende Inhaltsbereiche: + +- Startseite und Markenpositionierung +- Konzept und pädagogische Methodik +- Fachliche Themenbereiche +- Trainingsprogramme +- Trainingsmodule +- Übungen und Unterrichtsmaterialien +- Didaktische Filme als unterstützende Medien +- Angebote und Lizenzmodelle +- Kostenlose Inhalte +- Zielgruppenspezifische Seiten +- Fachwissen, Ratgeber und methodische Beiträge +- Informationen über den Anbieter und fachliche Qualifikation +- Registrierung und Mitgliederbereich + +Prüfe, welche Bereiche Hauptnavigation, Unterseiten, Filteransichten oder dynamisch erzeugte Katalogseiten benötigen. + +Vermeide eine unnötig komplexe Navigation. + +## 9. Professionelles Designsystem + +Leite aus der bestehenden Designstudie ein weiterentwickeltes Designsystem ab. + +Es soll insbesondere enthalten: + +- Markenfarben und semantische Farbvariablen +- Typografie und Schriftgrößenhierarchie +- Abstände und Layout-Raster +- Responsive Breakpoints +- Navigationskomponenten +- Karten und Inhaltsvorschauen +- Buttons und Handlungsaufrufe +- Formular- und Eingabekomponenten +- Bild- und Medienpräsentation +- Statusanzeigen und Rückmeldungen +- Inhalts- und Abschnittsvorlagen +- Tabellen und Lizenzvergleiche +- Barrierearme Interaktionsmuster + +Bewerte, welche Komponenten markenspezifisch gestaltet werden sollten und wo Standardkomponenten sinnvoll sind. + +Die sichtbare Plattform darf nicht wie ein generisches CMS-, Shop- oder SaaS-Template wirken. + +Die Gestaltung richtet sich an erwachsene Trainer und pädagogische Fachkräfte. + +Sie soll professionell, modern, vertrauenswürdig und zugänglich sein, ohne unnötig kindlich oder dramatisierend zu wirken. + +## 10. Seitentypen und Darstellungsvarianten + +Entwickle fachliche Layoutkonzepte für die wichtigsten Seitentypen. + +Eine zentrale Anforderung ist die **Trennung zwischen fachlichem Datenobjekt und seiner redaktionellen Präsentation**. + +Beispiel: Ein Trainingsprogramm kann in unterschiedlichen Kontexten dargestellt werden. + +### Fachliche Programmseite + +- Lernziele +- Zielgruppe +- Themenbereiche +- Enthaltene Module +- Durchführungsmöglichkeiten +- Benötigte Materialien + +### Marketing-Landingpage + +- Zielgruppenspezifische Ansprache +- Problemstellung und Nutzen +- Hochwertige Bildwelt +- Methodische Vorteile +- Geeignete Beispiele +- Handlungsaufrufe + +### Kommerzielle Angebotsseite + +- Tatsächlich lizenzierter Umfang +- Lizenzvarianten +- Nutzungsrechte +- Preise +- Laufzeiten +- Kaufmöglichkeit + +Alle Darstellungen müssen gemeinsame maßgebliche Produktdaten verwenden, dürfen sich aber in Gestaltung und redaktioneller Argumentation unterscheiden. + +Erstelle strukturierte Wireframe-Konzepte für mindestens: + +1. Startseite +2. Themenseite +3. Programmseite +4. Modulseite +5. Zielgruppenspezifische Landingpage +6. Angebots- und Lizenzvergleichsseite +7. Mitgliederbibliothek + +Beschreibe für jede Seite ihre Aufgabe, Inhaltsblöcke, Navigation, relevante Aktionen und Besonderheiten auf Mobilgeräten. + +**Es werden zunächst Konzepte und Layoutstrukturen erwartet, keine fertige Frontend-Implementierung.** + +--- + +# Teil E – CMS-Strategie und maximale sinnvolle Konfigurierbarkeit + +## 11. Strategische CMS-Anforderungen + +Die Plattform benötigt ein leistungsfähiges, dauerhaft wartbares CMS. + +Der Betreiber soll neue Seiten, Inhalte, Kampagnen und viele Layoutvarianten ohne Programmierarbeiten erstellen und verändern können. + +Gleichzeitig müssen Designqualität, Markenkonsistenz, fachliche Richtigkeit und Sicherheit gewährleistet bleiben. + +Entwickle eine CMS-Strategie, die diese Anforderungen ausbalanciert. + +## 12. CMS-Funktionsmodell + +Untersuche insbesondere: + +### Seitenmanagement + +- Freie Anlage und Verwaltung von Seiten +- Seitenhierarchien und Navigation +- Unterschiedliche Seitentypen +- Wiederverwendbare Seitenvorlagen +- Entwürfe, Vorschau und Veröffentlichung +- Zeitgesteuerte Veröffentlichungen +- Änderungsverlauf und Wiederherstellung +- Archivierung und Weiterleitungen + +### Layout und Gestaltung + +- Seitenaufbau aus wiederverwendbaren Komponenten +- Konfigurierbare Komponentenvarianten +- Unterschiedliche Container- und Spaltenlayouts +- Globale Design-Tokens +- Themes und gestalterische Varianten +- Unterschiedliche Hero-Bereiche +- Wiederverwendbare Inhaltsabschnitte +- Responsive Gestaltung +- Visuelle Vorschau in unterschiedlichen Bildschirmgrößen + +### Dynamische Inhaltsbausteine + +- Themenlisten +- Programmkarten +- Modulübersichten +- Mediengalerien +- Fachartikel +- Angebotskarten +- Lizenzvergleiche +- Zielgruppenspezifische Zusammenstellungen +- Ähnliche oder ergänzende Inhalte +- Automatische interne Verlinkung + +Die Daten sollen dabei aus den vorhandenen fachlichen Objektidentitäten stammen. + +### Redaktions- und Medienfunktionen + +- Zentrale Medienverwaltung +- Individuelle Thumbnails +- Videoframe-Auswahl +- Alt-Texte und Bildbeschreibungen +- Kategorien und Fachdimensionen +- Suchfunktionen +- Referenz- und Verwendungsnachweise +- SEO-Metadaten +- Social-Media-Vorschaubilder +- Freigabe- und Qualitätsprüfungen + +## 13. Grenzen der Konfigurierbarkeit + +Untersuche kritisch, welche Freiheiten sinnvoll sind. + +Ein vollständig frei gestaltbarer Page Builder kann hohe Flexibilität bieten, aber auch Probleme verursachen: + +- Uneinheitliche Gestaltung +- Eingeschränkte Barrierefreiheit +- Hoher Pflegeaufwand +- Fehlerhafte responsive Layouts +- Schlechte Performance +- Unkontrollierte Komponentenvarianten + +Ein zu stark eingeschränktes CMS kann dagegen ständig neue Entwicklungsaufträge auslösen. + +Entwickle deshalb ein abgestuftes Konfigurationsmodell. + +Beispielsweise: + +1. **Redaktionell frei:** Texte, Bilder, Inhalte, Reihenfolge, Verlinkungen +2. **Konfigurierbar:** Komponentenvarianten, Layouts, Farbakzente, Seitentypen +3. **Designsystem-gesteuert:** Typografie, responsive Regeln, Barrierefreiheit, Komponentenverhalten +4. **Entwicklungsabhängig:** Neue technische Komponenten und Integrationen + +Bewerte, ob diese Aufteilung sinnvoll ist, und verbessere sie gegebenenfalls. + +## 14. Vergleich möglicher CMS-Architekturen + +Untersuche mindestens: + +**Variante A – Eigenentwickelter CMS-Seitenbaukasten innerhalb von Laravel/Filament** + +**Variante B – Integration eines etablierten CMS oder Page Builders in Laravel** + +**Variante C – Headless CMS mit bestehendem Laravel-Produkt- und Lizenzkern** + +**Variante D – Weitere geeignete hybride oder integrierte Lösungen** + +Recherchiere konkrete Technologien und Produkte. + +Vergleiche: + +- Fachliche Leistungsfähigkeit +- Redaktionelle Bedienbarkeit +- Gestaltungsmöglichkeiten +- Entwicklungsaufwand +- Betriebskosten +- Lizenzkosten +- Wartungsaufwand +- Integrationsfähigkeit +- SEO-Fähigkeit +- Automatisierbarkeit +- Sicherheit +- Skalierbarkeit +- Herstellerabhängigkeit +- Migrationsaufwand aus dem bestehenden System + +Begründe deine Empfehlung. + +Die vorhandene Laravel-/Filament-Implementierung ist eine wichtige Randbedingung, aber keine unantastbare Festlegung für sämtliche zukünftigen CMS-Funktionen. + +Ein vollständiger Technologie-Neustart ist jedoch nur dann zu empfehlen, wenn der Nutzen die zusätzlichen Risiken und Kosten eindeutig rechtfertigt. + +--- + +# Teil F – SEO, Content-Strategie und KI-Sichtbarkeit + +## 15. Strategische SEO-Architektur + +Nutze `seo-und-content-prinzipien.md` als Ausgangspunkt. + +Entwickle daraus eine umsetzbare SEO- und Content-Strategie. + +Untersuche: + +- Fachliche Themencluster +- Zielgruppenbezogene Suchintentionen +- Informationsorientierte Suchanfragen +- Kauf- und lösungsorientierte Suchanfragen +- Evergreen-Inhalte +- Themen- und Programmseiten +- Methodische Fachbeiträge +- Interne Verlinkung +- Conversion-Pfade +- Content-Lücken +- Potenzielle Wettbewerbsvorteile durch eigenes Fachwissen und eigene Trainingsmedien + +Die strategische Empfehlung muss zwischen **fachlich sinnvoller Content-Architektur** und rein suchmaschinengetriebener Seitenerzeugung unterscheiden. + +Nicht jede mögliche Kombination aus Schlagwort, Fachsäule und Altersgruppe benötigt eine eigenständig indexierbare Seite. + +## 16. Dynamische und programmatische SEO + +Untersuche, welche SEO-Funktionen sinnvoll automatisiert werden können. + +Beispiele: + +- Generierung geeigneter Programm- und Modulseiten +- Automatische XML-Sitemaps +- Canonical-URL-Verwaltung +- Redirect-Management +- Breadcrumbs +- Strukturierte Daten +- Open-Graph-Metadaten +- SEO-Prüfungen beim Veröffentlichen +- Erkennung fehlender Metadaten +- Erkennung fehlerhafter interner Links +- Erkennung redundanter Inhalte +- Empfehlungen zur internen Verlinkung +- Aktualisierung von Inhaltsübersichten + +Bewerte die Vor- und Nachteile verschiedener Mechanismen. + +Die öffentliche Website soll für Suchmaschinen gut erschließbar sein. Der geschützte Mitgliederbereich und nicht freigegebene Materialien dürfen dabei nicht unkontrolliert indexiert werden. + +## 17. GEO und AEO + +Untersuche die Chancen und Grenzen der Auffindbarkeit in KI-gestützten Such- und Antwortsystemen. + +Betrachte insbesondere: + +- Zitierfähige fachliche Informationen +- Klare Quellen und Autorenschaft +- Strukturierte Wissensartikel +- Präzise Fragen und Antworten +- Semantisch verständliche HTML-Inhalte +- Öffentlich zugängliche Fachinformationen +- Eindeutige Produkt- und Methodenbeschreibungen +- Geeignete strukturierte Daten +- Möglichkeiten zur Erfolgsmessung + +Vermeide unbelegte Behauptungen über spezielle KI-Rankingfaktoren. + +**Zitationen durch KI-Systeme oder bestimmte Rankings dürfen nicht als garantiert dargestellt werden.** + +## 18. Technische SEO-Qualität + +Definiere ein prüfbares technisches SEO-Konzept. + +Berücksichtige: + +- Server-rendered beziehungsweise zuverlässig crawlbare Inhalte +- HTTP-Statuscodes +- Canonical URLs +- Sitemap und robots.txt +- Indexierungsregeln +- Strukturierte Daten +- Mobile Performance +- Core Web Vitals +- Bildoptimierung +- Video-Metadaten +- Barrierefreiheit +- Seitenstruktur +- Automatisierte Qualitätsprüfungen + +Prüfe die aktuellen offiziellen Richtlinien und Standards. + +Erstelle daraus konkrete Anforderungen für CMS, Frontend und Deployment. + +--- + +# Teil G – Datenbasierte und KI-gestützte Marketingautomatisierung + +## 19. Strategisches Ziel + +Entwickle eine Architektur für eine kontinuierliche, datenbasierte Marketingsteuerung. + +Der langfristige Anspruch ist, dass die Plattform geeignete Marketingmaßnahmen **selbstständig vorbereitet, priorisiert und teilweise automatisiert ausführt**, ohne dass der Betreiber sämtliche Analysen und Routinetätigkeiten manuell durchführen muss. + +Das System darf dabei keine unkontrollierte Content-Fabrik werden. + +Fachliche Qualität, Verlässlichkeit, Datenschutz und nachvollziehbare Entscheidungen haben Vorrang. + +## 20. Marketingdaten und Integrationen + +Untersuche geeignete Datenquellen und ihre technischen Schnittstellen. + +Insbesondere: + +- Google Search Console +- Bing Webmaster Tools +- Datenschutzkonforme Webanalyse +- Interne Registrierungen +- Nutzung kostenloser Angebote +- Kauf- und Lizenzdaten in zulässiger, zweckgebundener Form +- CMS- und Veröffentlichungsdaten +- Geeignete Keyword- und Wettbewerbsdaten +- Newsletter- und Kampagnendaten, soweit zulässig +- Weitere wirtschaftlich sinnvolle Datenquellen + +Vergleiche verfügbare APIs, Integrationsaufwand, Kosten, Datenqualität und Einschränkungen. + +Erfinde keine verfügbaren Daten oder Kennzahlen. + +## 21. Automatische Erkennung von Marketingpotenzialen + +Untersuche Mechanismen zur Identifikation von: + +- Wachsenden Suchanfragen +- Thematischen Content-Lücken +- Seiten mit hoher Sichtbarkeit und geringer Klickrate +- Schwachen Conversion-Pfaden +- Fehlenden internen Links +- Veralteten Inhalten +- Technischen SEO-Problemen +- Fehlenden Landingpages +- Geeigneten neuen Fachbeiträgen +- Vermarktungsmöglichkeiten neu veröffentlichter Trainingsmodule +- Zielgruppenbezogenen Kampagnenchancen + +Vergleiche ausdrücklich: + +1. Regelbasierte Analysen +2. Statistische Verfahren +3. KI-gestützte Analysen +4. Kombinierte Ansätze + +Empfiehl KI nur dort, wo sie einen nachvollziehbaren Zusatznutzen bietet. + +## 22. Marketing-Intelligence-Prozess + +Konzipiere einen geschlossenen Steuerungsprozess: + +**Datenerfassung → Analyse → Chancenbewertung → Maßnahmenplanung → Redaktioneller Entwurf → Qualitätsprüfung → Veröffentlichung → Wirkungsmessung → Optimierung** + +Beschreibe für jede Phase: + +- Eingangsdaten +- Verarbeitung +- Ergebnisse +- Automatisierungsgrad +- Benötigte Schnittstellen +- Fachliche Freigaben +- Fehlerbehandlung +- Protokollierung +- Relevante Erfolgskennzahlen + +Untersuche insbesondere, wie das CMS als zentrale Arbeitsoberfläche für solche Prozesse dienen kann. + +## 23. KI-unterstützte Content- und Kampagnenplanung + +Entwickle mögliche Workflows für: + +- Automatische Themen- und Content-Vorschläge +- Keyword- und Suchintentionsanalysen +- Erstellung redaktioneller Briefings +- Entwürfe für Fachartikel +- SEO-Titel und Meta-Beschreibungen +- Landingpage-Varianten +- Newsletter-Entwürfe +- Social-Media-Beiträge +- Produktbezogene Kampagnen +- Cross-Selling- und Erweiterungsangebote +- Periodische Marketingberichte +- Erkennung von Optimierungsbedarf + +Berücksichtige, dass Lara & Felix mit pädagogisch sensiblen Themen arbeitet. + +Fachliche Aussagen müssen überprüfbar sein. + +Keine erfundenen Qualifikationen, Testimonials, Bewertungen, Wirksamkeitsversprechen oder Studienergebnisse. + +Rechtlich relevante Kommunikation, externe Kampagnen und fachliche Neuveröffentlichungen benötigen angemessene Freigaben. + +## 24. Marketing-Automatisierungsarchitektur + +Vergleiche mindestens folgende Ansätze: + +**A. Marketingautomatisierung direkt innerhalb des CMS** + +**B. Externe Orchestrierung mit n8n oder vergleichbaren Workflow-Systemen** + +**C. Eigenständiges Marketing-Intelligence-Modul** + +**D. KI-Agenten mit kontrollierter CMS- und Datenanbindung** + +**E. Hybride Architektur aus Datenerfassung, Regeln, KI-Unterstützung und CMS-Freigabe** + +Berücksichtige dabei die vorhandene technische Infrastruktur und die Erfahrung mit Docker und n8n. + +Untersuche: + +- Integrationsfähigkeit +- Datensicherheit +- API-Berechtigungen +- Mandanten- beziehungsweise Rollenabgrenzung +- Menschliche Freigaben +- Fehlerfälle und Wiederholbarkeit +- Protokollierung und Nachvollziehbarkeit +- Kosten von KI-Modellen +- Modellunabhängigkeit +- Betriebskosten +- Wartbarkeit + +Bewerte auch die Verwendung unterschiedlicher KI-Modelle für einfache und komplexe Aufgaben. + +Entwickle keine unnötig komplexe Multi-Agentenarchitektur, wenn deterministische Workflows dieselbe Aufgabe zuverlässiger lösen. + +## 25. Datenschutz und rechtliche Rahmenbedingungen + +Prüfe, welche Anforderungen bei Marketinganalysen, Kontaktverwaltung, Tracking und automatisierter Kommunikation relevant werden. + +Berücksichtige insbesondere: + +- Datenschutz und Zweckbindung +- Einwilligungen, soweit erforderlich +- Zugriff auf personenbezogene Informationen +- Newsletter- und Werbekommunikation +- Datenminimierung +- Aufbewahrung und Löschung +- Transparenz automatisierter Prozesse +- Trennung von Test- und Produktivdaten +- Sichere Nutzung externer KI-Dienste + +Kennzeichne rechtlich zu prüfende Fragen und ersetze keine erforderliche juristische Prüfung durch bloße Annahmen. + +--- + +# Teil H – Integrierte technische Zielarchitektur + +## 26. Zusammenführung der Teilkonzepte + +Entwickle eine konsistente Zielarchitektur für: + +- Öffentliches Frontend +- Designsystem +- CMS und Page Builder +- Fachkatalog +- Inhalte und Medien +- Programme und Module +- Angebote und Lizenzen +- Mitgliederbibliothek +- SEO-Dienste +- Marketingdaten +- Workflow-Orchestrierung +- KI-Funktionen +- Analyse und Reporting + +Beschreibe die fachlichen Verantwortlichkeiten und Datenflüsse. + +Achte insbesondere auf eine klare Trennung zwischen: + +1. Fachlichen Inhaltsdaten +2. Didaktischen Kompositionen +3. Kommerziellen Produkt- und Lizenzdaten +4. Redaktionellen Präsentationsdaten +5. Marketing- und Analysedaten + +Vermeide unnötige Datenkopien. + +Berücksichtige bestehende Veröffentlichungs- und Lizenzinvarianten. + +## 27. Architekturentscheidungen und Variantenvergleich + +Bewerte die zentralen Optionen systematisch. + +Verwende eine nachvollziehbare Entscheidungsmatrix mit mindestens: + +| Kriterium | Bedeutung | +|---|---| +| Fachlicher Nutzen | Beitrag zum Plattformziel | +| Konfigurierbarkeit | Selbstständige Nutzung ohne Entwickler | +| UX-Qualität | Qualität für Besucher, Mitglieder und Redaktion | +| Entwicklungsaufwand | Einmalige technische Umsetzung | +| Betriebskosten | Laufender Ressourcen- und Lizenzbedarf | +| Wartbarkeit | Langfristiger Pflegeaufwand | +| Integrationsfähigkeit | Eignung für bestehende Produkt- und Lizenzarchitektur | +| Sicherheit | Schutz der Daten und Zugriffsrechte | +| Erweiterbarkeit | Zusätzliche Produkte, Zielgruppen und Funktionen | +| Migrationsrisiko | Risiken für vorhandene Daten und Funktionen | + +Gewichte die Kriterien begründet. + +Kennzeichne Gewichtungen, die du selbst vorschlägst. + +Erkläre bei jeder wesentlichen Entscheidung: + +- Bevorzugte Lösung +- Alternativen +- Entscheidende Vorteile +- Nachteile und Risiken +- Voraussetzungen +- Wann eine Alternative vorzuziehen wäre + +Wähle nicht automatisch die technologisch aufwendigste Lösung. + +**Das System muss von einem kleinen Betreiberteam dauerhaft beherrschbar bleiben.** + +--- + +# Teil I – Strategische Roadmap und Umsetzungskonzept + +## 28. Entwicklungsphasen + +Erstelle eine priorisierte Roadmap, die fachlichen Nutzen, technische Abhängigkeiten und Kosten berücksichtigt. + +Prüfe die folgende Ausgangshypothese und verbessere sie bei Bedarf. + +### Phase 1 – Professionelles Produktfundament + +- Konsistentes Designsystem +- Professionelle öffentliche Website +- Überarbeitete Informationsarchitektur +- Nutzbare Mitgliederbibliothek +- Konfigurierbare fachliche Standardseiten +- Solide CMS-Grundfunktionen +- Technische SEO-Basis +- Dynamische Produkt- und Angebotsdarstellung + +### Phase 2 – Erweiterte CMS- und Marketingfähigkeiten + +- Komfortabler Seitenbaukasten +- Mehr Layout- und Komponentenvarianten +- Landingpage-Vorlagen +- SEO-Redaktionswerkzeuge +- Content-Planung +- Marketingdaten-Integration +- Analyse-Dashboard +- Maßnahmenvorschläge + +### Phase 3 – Teilautomatisierte Marketingorganisation + +- Kontinuierliche Marketingdatenanalyse +- Automatische Chancenidentifikation +- KI-Unterstützung bei Content und Kampagnen +- CMS-integrierte Freigabeprozesse +- Automatisierte technische SEO-Überwachung +- Wirkungsmessung und Optimierung + +### Phase 4 – Optionale fortgeschrittene Funktionen + +- Erweiterter didaktischer Kursplayer +- Zusätzliche personalisierte Trainingsfunktionen +- Weitere Vermarktungskanäle +- Erweiterte institutionelle Funktionen +- Fortgeschrittene Marketingautomatisierung + +Diese Phasen sind **keine bereits beschlossene Roadmap**. + +Analysiere kritisch, ob eine andere Reihenfolge oder eine Aufteilung in kleinere, früher nutzbare Ausbaustufen sinnvoller ist. + +## 29. Umsetzungsplanung + +Definiere für jede Phase: + +- Geschäftlichen und fachlichen Nutzen +- Konkrete Liefergegenstände +- Technische Voraussetzungen +- Wiederverwendbare Bestandskomponenten +- Notwendige Architekturänderungen +- Abhängigkeiten +- Risiken +- Migrationsbedarf +- Funktions- und Qualitätsprüfungen +- Abnahmekriterien + +Unterscheide zwischen: + +- Unverzichtbarem MVP +- Sinnvollem frühen Ausbau +- Strategischer Zielarchitektur +- Optionalen späteren Funktionen + +Entwickle außerdem Empfehlungen dazu, welche Arbeitspakete eigenständig durch Coding-Agenten bearbeitet werden können und welche gemeinsame Architekturentscheidungen voraussetzen. + +Noch keinen konkreten Implementierungsauftrag ausführen. + +--- + +# Teil J – Erwartete Ergebnisse und Arbeitsweise + +## 30. Ergebnisdokument + +Erstelle ein vollständiges, eigenständig verständliches strategisches Zielkonzept unter: + +`docs/strategie/website-cms-seo-marketing-zielkonzept.md` + +Das Dokument soll mindestens folgende Kapitel enthalten: + +1. Executive Summary +2. Strategisches Zielbild und Produktpositionierung +3. Zielgruppen und Customer Journeys +4. Bewertung und Weiterentwicklung der bestehenden Designstudie +5. Design-Transformationsmatrix +6. Empfohlenes Designsystem +7. Neue Informationsarchitektur der Website +8. Zentrale Seitentypen und UX-Konzepte +9. CMS-Funktionsmodell und Konfigurationsmöglichkeiten +10. Vergleich der CMS-Architekturen +11. Empfohlene CMS-Zielarchitektur +12. SEO-, GEO- und Content-Strategie +13. Technische SEO-Architektur +14. Marketingdaten und Marketing Intelligence +15. KI-gestützte Marketingautomatisierung +16. Vergleich alternativer Automatisierungsarchitekturen +17. Integrierte technische Gesamtarchitektur +18. Architektur- und Strategieentscheidungen +19. Priorisierte Entwicklungsroadmap +20. Fachliche und technische Abnahmekriterien +21. Risiken und Abhängigkeiten +22. Noch offene Entscheidungen +23. Quellen und Recherchegrundlagen + +Der Bericht soll **konkrete Empfehlungen und Entscheidungen vorbereiten**, nicht nur allgemeine Möglichkeiten aufzählen. + +## 31. Umfang und Aufbereitung + +Die Untersuchung darf umfangreich sein, soll aber präzise und entscheidungsorientiert bleiben. + +Vermeide: + +- Wiederholungen +- Allgemeine Marketingfloskeln +- Unbegründete Technologiepräferenzen +- Rein subjektive Designbewertungen +- Nicht belegte SEO-Versprechen +- Unnötige Überarchitektur +- Unkonkrete Empfehlungen +- Umfangreiche Featurelisten ohne Priorisierung + +Bevorzuge: + +- Vergleichsmatrizen +- Konkrete Funktionsmodelle +- Architekturdiagramme +- Informationsarchitekturen +- Datenflussbeschreibungen +- Strukturierte Wireframes +- Nachvollziehbare Variantenentscheidungen +- Abgestufte Roadmaps +- Überprüfbare Erfolgskriterien + +## 32. Rechercheanforderungen + +Nutze aktuelle, belastbare Quellen. + +Bevorzuge: + +- Offizielle Herstellerdokumentation +- Google Search Central +- Bing Webmaster-Dokumentation +- Webstandards und W3C +- Offizielle CMS-Dokumentationen +- Relevante technische Standards +- Belastbare UX-Forschung +- Seriöse Branchen- und Marktuntersuchungen + +Verifiziere insbesondere aktuelle CMS-Funktionen, Integrationen, Kostenmodelle und technische Einschränkungen. + +Dokumentiere Quellen mit Links und Prüfdatum. + +Falls Internetrecherche oder der Zugriff auf bestimmte Quellen nicht möglich ist, kennzeichne die fehlende Verifikation ausdrücklich. + +Unterscheide immer zwischen belegten Tatsachen, eigenen Bewertungen und offenen Hypothesen. + +## 33. Kritische Eigenprüfung + +Prüfe dein Zielkonzept vor Fertigstellung aus drei Perspektiven. + +### Perspektive 1 – Strategische Produktentwicklung + +Ermöglicht die vorgeschlagene Plattform eine professionelle Positionierung, differenzierbare Produkte und nachhaltiges Wachstum? + +### Perspektive 2 – Technische Architektur + +Sind die Lösungen konsistent, wartbar, sicher, wirtschaftlich und mit vertretbarem Aufwand implementierbar? + +### Perspektive 3 – Betreiber und Anwender + +Kann ein kleiner Betreiber die Plattform tatsächlich pflegen, konfigurieren und vermarkten, ohne für jede alltägliche Änderung einen Entwickler zu benötigen? + +Können Trainer die angebotenen Programme und Materialien intuitiv finden und nutzen? + +Identifiziere Widersprüche zwischen diesen Perspektiven und löse sie mit begründeten Empfehlungen. + +## 34. Arbeitsgrenzen + +Erlaubt sind: + +- Lesen vorhandener Dokumente +- Analyse der Designstudie +- Untersuchung relevanter Codebereiche +- Technologierecherche +- Variantenbewertung +- Strategische und technische Konzeption +- Erstellung des neuen Zielkonzepts + +Nicht erlaubt sind: + +- Implementierung neuer Funktionen +- Änderungen am Anwendungscode +- Datenbankmigrationen +- Deployment +- Unbeauftragte Änderung bestehender Fach- oder Architekturdokumente +- Veröffentlichung von Marketinginhalten +- Ausführung von Kampagnen +- Veränderung von Produktivdaten + +Bestehende Dokumente dürfen als notwendige Änderungsziele benannt werden. Ihre tatsächliche Überarbeitung erfolgt erst nach Annahme des Zielkonzepts. + +## 35. Abschließender Anspruch + +Dein Ergebnis muss uns in die Lage versetzen, die nächsten wesentlichen Plattformentscheidungen fundiert zu treffen. + +Untersuche Alternativen, stelle bisherige technische Annahmen infrage und entwickle ein integriertes Zielbild. + +Die vorhandene Designstudie soll sinnvoll weiterentwickelt werden. + +Die bestehende Produktarchitektur soll ihren fachlichen Wert behalten. + +Die Website soll sich von einer videofokussierten Verkaufsdarstellung zu einer hochwertigen Präsentation eines umfassenden Trainingskonzepts entwickeln. + +Das CMS soll eine weitreichende, aber kontrollierte redaktionelle und gestalterische Konfiguration ermöglichen. + +SEO und Marketing sollen von Anfang an strukturell berücksichtigt werden. + +Die spätere Marketingautomatisierung soll auf echten Daten, nachvollziehbaren Mechanismen und kontrollierten KI-Workflows beruhen. + +**Liefere eine strategisch überzeugende, fachlich konkretisierte und technisch belastbare Gesamtplanung – keinen allgemeinen Auditbericht und noch keinen Coding-Auftrag.** \ No newline at end of file diff --git a/docs/ux/verwaltung/02-designentscheidungen.md b/docs/ux/verwaltung/02-designentscheidungen.md new file mode 100644 index 0000000..732e0e6 --- /dev/null +++ b/docs/ux/verwaltung/02-designentscheidungen.md @@ -0,0 +1,115 @@ +# Abgestimmte Designrichtung und offene Details + +> **Aktualisierung 19.11.2026:** Die gemeinsame Designrichtung reicht für den Umbau aus. Maßgeblich ist jetzt [Dokument 14 – verbindlicher Verwaltungsstandard](14-verwaltungsstandard.md), ergänzt durch den [konkreten Umbauauftrag](15-umbauauftrag.md). Frühere allgemeine Hinweise auf ausstehende Detailabstimmungen sind unten als Arbeitsverlauf erhalten; sie sind keine weitere pauschale Startbedingung. Offene Geschäftsfragen bleiben abgegrenzt. Die Anwendung wurde durch diese Dokumentation nicht verändert. + +Stand: 19.11.2026. Quelle: gemeinsame Diskussion nach dem UX-Audit. + +## Statusbegriffe + +- **Bestätigt:** vom Auftraggeber ausdrücklich befürwortete Richtung oder Anforderung. +- **Entwurf:** vorgeschlagene Konkretisierung, noch zu prüfen und abzustimmen. +- **Offen:** bewusste Lücke; keine automatische Implementierungsvorgabe. +- **Zurückgestellt:** für den aktuellen Zweck nicht weiterverfolgt; gegebenenfalls später relevant. + +## Bestätigte Richtung + +| ID | Entscheidung | Wirkung auf das Design | +|---|---|---| +| UX-D01 | Ein gemeinsames Verwaltungssystem für alle Bereiche | Navigation, Auswahl, Bearbeitung, Rückmeldung und Aktionshierarchie wiederverwenden | +| UX-D02 | Arbeitsfläche mit Kontext für tägliche, nichtlineare Arbeit | Bestand, bearbeitetes Objekt und ausgewählter Kontext bleiben räumlich verständlich | +| UX-D03 | Geführter Ablauf für lineare Prozesse | Zusammenhang und nächste Handlung zeigen; bei späterer Bearbeitung Bereiche direkt aufrufbar halten | +| UX-D04 | Anlegen und Bearbeiten nutzen dieselbe Grundmaske | Keine zweite konkurrierende Bearbeitungsoberfläche für dasselbe Objekt; relevante Bereiche oben direkt erreichbar | +| UX-D05 | Präsentation als eigener nachgelagerter Arbeitskontext | Angebotszusammenstellung enthält keine dauerhaft eingebettete Shopdarstellung | +| UX-D06 | Unterschiedliche Ausgabeansichten unterstützen | Kachel, Detailseite und weitere Darstellungen gesondert prüfbar; keine einzelne Vorschau als Stellvertreter für alle Ausgaben | +| UX-D07 | Beschreibungen aus dem jeweiligen Produkt nutzen und überarbeitbar halten | Herkunft und eigene Abweichungen nachvollziehbar machen; Details der Auflösung bleiben fachlich abzugleichen | +| UX-D08 | Fachliche Offenheit erhalten | Keine Angebots- oder Lizenzhierarchie durch Navigation, Schritte oder Bildtexte festlegen | +| UX-D09 | Bestehende fachliche Modelle, Beziehungen, Rechte und Versionierung erhalten | Visuelles Konzept ist kein Auftrag zum Umbau des Domänenmodells | +| UX-D10 | Laravel, Filament und Livewire bleiben Grundlage | Entwürfe müssen innerhalb des vorhandenen Systems umsetzbar sein | +| UX-D11 | Visuelle Abstimmung vor Implementierung | Audit, Entwürfe und Entscheidungsdokumentation; kein vorgezogener Anwendungsumbau | +| UX-D12 | Ein wiederverwendbares Auswahl- und Zuordnungsmuster ausarbeiten | Gemeinsame Bedienregeln; fachlich zulässige Objekte und Referenzen je Aufgabe | +| UX-D13 | Auswahl als Liste mit visuellen Vorschauen und einer Detailansicht für das betrachtete Element | Bevorzugte Grundlage ist Auswahlentwurf 1; keine dauerhaft große separate Liste der gewählten Objekte | +| UX-D14 | Fachliche Inhaltstypen und Dateitypen sowie Nutzung und Verwertung berücksichtigen | Informationen klar gliedern und in der Detailprüfung zugänglich halten; keine fachlichen Regeln oder neue Typenhierarchie aus dem Design ableiten | +| UX-D15 | Aufbau mit kompakter Struktur links und großem Detailbereich rechts; klare Rahmen und Gruppierung | Arbeitsaufteilung aus Aufbauentwurf 2 mit Strukturgruppierung aus Entwurf 1 bestätigt. Ein fester Bearbeitungsort unterstützt den Wechsel zwischen konkreten Verwendungen | +| UX-D16 | Den tatsächlichen kleinen Betrieb zum Maßstab nehmen: überschaubarer Produktumfang, in der Regel eine bearbeitende Person | Aufgaben mit wenigen verständlichen Handlungen; kein allgemeines skalierbares Shopsystem als Gestaltungsziel. Bestehende technische Zustände sind keine Vorgabe für ebenso viele manuelle Freigaben | +| UX-D17 | Das künftige Kursbuchsystem muss in dieselbe Plattform integrierbar bleiben | Gemeinsame Arbeitsbereiche und Komponenten anschlussfähig halten. Konkrete Kursbuchfunktionen sind damit noch nicht festgelegt oder zur sofortigen Umsetzung beauftragt | +| UX-D18 | Bestehende Erwerbe und vereinbarte Nutzungsrechte vor unbeabsichtigten Folgen normaler Änderungen schützen | Produktbearbeitung, neue Fassungen, Angebotsänderung oder Ausblenden auf der Website dürfen bestehende Berechtigungen nicht still verändern. Vereinbarter Umfang, Bedingungen, Gültigkeit und vorhandene Updatezusagen bleiben maßgeblich | +| UX-D19 | Rechtlich notwendigen Rückzug mit sofortiger Wirkung ermöglichen | Eigene ausdrücklich benannte Handlung mit nachvollziehbarem Gegenstand, Grund, Auswirkungen und Ergebnis; Erwerbs- und Rechtehistorie erhalten. Konkrete Bedienung bleibt Entwurf | +| UX-D20 | Ein gemeinsamer visueller Redaktionsbaustein am jeweiligen Fachobjekt | Einheitliche Beschreibung, Einordnung, Textvarianten und Präsentation bei Medien, Modulen, Programmen und Lizenzartikeln; für Trainingspläne anschlussfähig. Zentral bedeutet gemeinsame Daten und Bedienung, keine zweite losgelöste Pflichtverwaltung | +| UX-D21 | Präsentationsmedien aus dem zentralen Bestand referenzieren; mehrere Medien derselben Rolle erlauben | Gemeinsamer visueller Picker, Rollen und Reihenfolge; keine Dateikopien oder verpflichtende Lehrinhaltsfassung für reine Präsentationsmedien. Eigene und übernommene Angaben verständlich unterscheiden | +| UX-D22 | Redaktionsentwurf 1 als aufgeräumte Grundlage weiterführen; Texte und Medien dürfen getrennte Register nutzen | Keine Pflicht zur gleichzeitigen Darstellung auf einer Seite. Gleichartige Masken und Interaktionen für alle relevanten Fachobjekte, ausdrücklich auch für die Präsentationszuordnungen eines Films; Registerbenennung und konkrete Ausgestaltung bleiben Entwurf | +| UX-D23 | Eigener Redaktionsmanager ist zulässig; verlustfreie Rückkehr in die normale Objektbearbeitung ist erforderlich | Ausgangsobjekt, offene Eingaben und Bearbeitungskontext erhalten. Der Wechsel erzwingt weder Speicherung noch Veröffentlichung. Die genaue Einbettung und technische Zustandsbewahrung bleiben Umsetzungsthema; die Abbildung zeigt noch nicht den vollständigen Fachobjekteditor | + +## Entscheidung zur Auswahlkomponente + +Entwurf 1 wurde als praktischere Grundlage bevorzugt. Kleine Vorschauen erhalten die visuelle Erkennbarkeit in der Ergebnisliste; eine größere Vorschau dient der Prüfung des jeweils betrachteten Elements. Die zusätzliche Bestands-/Auswahlliste aus Entwurf 3 wird zurückgestellt, weil Raum für Einordnung, Nutzung, Verwertung und fachlich definierte Inhaltstypen benötigt wird. + +Die Verfeinerung v2 konkretisiert diese Richtung. Die neuen Detailgruppen und ihre genaue Belegung bleiben Entwurf. Ein optionaler Rasterwechsel ist nicht abschließend entschieden. Das Häkchen für die Übernahme bleibt von der Betrachtung eines Elements unterscheidbar. + +## Gemeinsame räumliche Rollen – Entwurf + +| Zone | Aufgabe | Zu vermeiden | +|---|---|---| +| Navigation | Arbeitskontext und Rückweg zeigen | Eine lange unstrukturierte Liste aller Fachobjekte | +| Objektkopf | Name, Objekttyp und verständlicher Zustand | Viele konkurrierende Statusaussagen ohne Bezug | +| Bereichsnavigation | Direktzugriff und bei Bedarf Prozessfolge | Erneutes Durchlaufen erledigter Schritte für eine Einzeländerung | +| Arbeitsfläche | Relevante Inhalte und Eingaben der aktuellen Aufgabe | Lange Feldlisten aus allen Themen gleichzeitig | +| Kontextbereich | Details des gerade betrachteten Elements, Quelle und Verwendung | Produktpräsentation, Bearbeitung und technische Verwaltung ungegliedert vermischen | +| Aktionsbereich | Eine erkennbare Haupthandlung und passende Nebenhandlungen | Gleiche visuelle Gewichtung für Speichern, Veröffentlichen und Rückzug | +| Präsentationsarbeitsplatz | Ausgabeansichten und beschreibende Inhalte prüfen | Aus Gestaltung der Shopansicht die kommerzielle Konfiguration ableiten | + +Die konkrete Ausgestaltung und Belegung dieser Zonen wird je Aufgabenfamilie erarbeitet. Sie sind kein Zwang, auf jedem Bildschirm alle Zonen gleichzeitig zu zeigen. + +## Einordnung der Angebotsbilder + +Die ersten beiden Richtungen wurden positiv bewertet: Kontextarbeitsplatz für laufende Arbeit, Schrittführung für lineare Prozesse. Der kombinierte Entwurf wurde als gemeinsame Richtung bestätigt. + +Die vier dort gezeigten Angebotsstationen sind Anschauungsmaterial. Anzahl, Beschriftung und Reihenfolge der Angebotsbereiche sowie Fassungs- und Aktivierungslogik sind nicht abschließend fachlich freigegeben. Gleiches gilt für Varianten innerhalb eines Angebots und mehrere parallele Angebote. Die spätere Oberfläche muss die fachlich beschlossene Lösung aufnehmen können. + +Die dritte ursprüngliche Richtung wird für die Angebotszusammenstellung zurückgestellt, weil sie Verwaltung und Shopdarstellung zu eng verknüpft. Ihre Idee einer Darstellungsvorschau bleibt für einen eigenen Präsentationsarbeitsplatz relevant. + +## Bestätigte Arbeitsaufteilung: Aufbauarbeitsplatz + +Für [Dokument 06](06-aufbau-arbeitsplatz-entwurf.md) ist die Kombination aus Arbeitsaufteilung von Aufbauentwurf 2 und Rahmen/Gruppierung aus Entwurf 1 bestätigt. Die Struktur bleibt links, die gezielte Bearbeitung rechts an einem festen Ort. Referenzierte Module und eingeblendete Quelleninhalte bilden erkennbare Gruppen. + +Die kombinierte Abbildung konkretisiert diese Entscheidung. Exakte Breiten, Detailfelder und Speicher-/Vorschauzustände bleiben weiter abzustimmen. Die vorgeschlagenen Regeln trennen lokale Angaben einer Verwendung, referenzierte Quelle und Reihenfolge. Bestehende Modelle und Änderungsklassen bleiben erhalten. + +Der Aufbauarbeitsplatz für Programme und Module ist bereits gewählt. Die spätere Ergänzung des Redaktionseinstiegs und des verlustfreien Rückwegs nach UX-D23 begründet keinen neuen Grundentwurf. Bei Medien werden derselbe Verwaltungsrahmen und dieselben Bedienregeln mit den tatsächlichen Datei-/Fassungsbereichen genutzt. + +## Neuer Detailentwurf: Speichern, Vorschau und Freigabe + +[Dokument 07](07-speichern-vorschau-freigabe-entwurf.md) konkretisiert die drei Aussagen Speicherrückmeldung, fachlicher Zustand und tatsächliche Verfügbarkeit. Es schlägt einen benannten Speicherumfang, eine Vorschau des aktuellen Arbeitsstands und kontextgerechte Prüfabläufe vor. Der ergänzte Quellenabgleich berücksichtigt die eigene Anzeigefreigabe je Kompositionsfassung, die öffentliche Listung als noch offenes Zielkonzept sowie die getrennten kommerziellen, CMS- und Website-Medienwege. Das neue Bild setzt die bestätigte Anordnung fort. Diese zusätzlichen Regeln und STATE-Prüffälle sind **Entwurf**; eine neue bestätigte UX-D-Entscheidung ist damit nicht erfolgt. + +Direkt wirksame redaktionelle Angaben, fachliche Fassungen und CMS-Revisionen behalten ihre unterschiedlichen Regeln. Angebotsfassungen und Aktivierungsfolgen bleiben fachlich offen. + +## Maßstab für die weitere Ausarbeitung + +[Dokument 08](08-einfacher-redaktionsalltag-entwurf.md) übersetzt die vom Auftraggeber ausdrücklich genannte Betriebsgröße und die spätere Kursbuchintegration in einen vereinfachten Bedienentwurf. Die Arbeit bleibt am Produkt; notwendige Übernahmeprüfungen sollen zusammenhängend statt als getrennte technische Verwaltungsstrecke zugänglich sein. Diese konkrete Bündelung ist noch abzustimmen. + +Die Auflistung bestehender Freigabeebenen in Dokument 07 dient dem fachlichen Abgleich. Weder sieben Freigaben noch die zuletzt vorgeschlagenen drei Handlungsfamilien sind als allgemeiner Pflichtprozess beschlossen. Welche manuellen Entscheidungen entfallen oder zusammengeführt werden können, wird gezielt geprüft; keine stillschweigende Modellmigration. + +## Gemeinsame Redaktion + +Der Auftraggeber hat den zentralen Redaktionsbaustein mit dem [Planungstext](quellen/redaktionsmodul-planungschat-2026-11-19.md) als erforderlichen nächsten Arbeitsbereich bekräftigt. Fachliche Grundlage ist teilweise dokumentiert; die aktuelle UX ist ausdrücklich nicht abgenommen. [Dokument 09](09-redaktionsarbeitsplatz-entwurf.md) enthält die gewählte Basis Redaktionsentwurf 1, den Vorschlag gemeinsamer Register und Regeln sowie RED-Prüffälle. Der neue Registerentwurf wird am Unterrichtsfilm gezeigt. Die ursprünglichen Alternativen bleiben als Vergleich erhalten; genaue Register und Details sind weiter abzustimmen. Zielgruppenvarianten, Übernahmedetails und Slideshow-Ausgabe sind unter OFF-19 bis OFF-21 abgegrenzt. + +## Konsolidierung und dauerhafte Anwendung – Vorschlag + +[Dokument 10](10-verwaltungsstandard-entwurf.md) schlägt repräsentative Arbeitsplatzfamilien, gemeinsam gepflegte Komponenten und eine auftragsbezogene Abnahme vor. Es empfiehlt keinen eigenen Entwurf für jeden Screen. Die fünf Familien, die Umsetzungsreihenfolge und die vorbereiteten Coding-Regeln sind noch Vorschläge, keine zusätzliche bestätigte UX-D-Entscheidung. + +[Dokument 11](11-cms-pruefbedarf.md) bewahrt die bisher belegten CMS-Schwächen und dokumentierten Korrekturen. Die neue Zugriffskontrolle war durch die abgelaufene Sitzung begrenzt; es liegt kein erneuter abgeschlossener CMS-Audit vor. + +## CMS-Seiteneditor – neuer Vergleich + +[Dokument 12](12-cms-seiteneditor-entwurf.md) bewahrt den ersten CMS-Vergleich und konkretisiert nach der Rückmeldung einen zusammenhängenden Vorschlag: breite Seitenarbeitsfläche mit sichtbarem Vierer-Raster und eigenen großen Konfigurationskontexten für Abschnitt und Baustein. Zentrale Redaktionsdaten bleiben Quelle. Die neue Aufteilung ist noch Vorschlag, keine zusätzliche bestätigte UX-D-Entscheidung. Vorhandenes Seiten-/Abschnitts-/Platzmodell bleibt Grundlage; kein erneuter Grundentwurf für Programme und Module. + +## Übergeordnete Webpräsenz-Verwaltung – Umfang ergänzt + +Der Auftraggeber hat die fehlende Ebene für Seitenreihenfolge, Menüs und versteckte Seiten benannt. [Dokument 13](13-webpraesenz-verwaltung-entwurf.md) beschreibt den vorgeschlagenen Arbeitsplatz oberhalb der Einzel-Seitenbearbeitung. Seitenbestand, Menüstruktur und globaler Rahmen nutzen gemeinsame Komponenten; eine beliebige neue Seitenhierarchie oder generische Website-Konfigurationsplattform ist damit nicht beschlossen. Drei alternative Anordnungen sind nun in Dokument 13 gegenübergestellt: Register mit festem Menüeditor, Seitenbestand und Menü nebeneinander sowie direkte Bearbeitung in der breiten Menüliste. Der Auftraggeber bevorzugt 1 und 3 und nennt Scrollbedarf sowie kleinere Monitore als Abwägung. Vorgeschlagen ist Entwurf 1 bei genügend Fensterbreite und dieselbe Bearbeitung inline nach Entwurf 3 bei schmaleren Fenstern. Diese Kombination und ihre Detailregeln sind noch nicht bestätigt. Die gemeinsamen WEB-R-Regeln und WEB-Prüffälle bleiben Vorschläge; offene fachliche Bedeutungen werden nicht durch Bilddetails entschieden. + +## Noch abzustimmen + +- Feinschliff der gewählten Listenbasis, Filter und Detailgruppen des Auswahlbausteins. +- Globale Navigation und vollständige Aufgabenfamilien einschließlich späterem Shop-, Kunden- und Lizenzmanagement. +- Feinschliff des gewählten kombinierten Aufbauarbeitsplatzes; größere Zusammenstellungen, Reihenfolge und tiefere Strukturen an realen Beispielen prüfen. +- Den vereinfachten Alltag aus Dokument 08 an einem Programm prüfen und danach den Status-, Speicher-, Vorschau- und Freigabeentwurf aus Dokument 07 überarbeiten; kein technischer Status wird allein wegen seiner Existenz zur manuellen Freigabestation. +- Eigenständige redaktionelle Bearbeitung und Präsentationsansichten. +- Vollständige Komponentenbibliothek, Zustände, Abnahmekriterien und endgültige Coding-Regeln. diff --git a/docs/ux/verwaltung/03-auswahl-und-zuordnung-entwurf.md b/docs/ux/verwaltung/03-auswahl-und-zuordnung-entwurf.md new file mode 100644 index 0000000..99f39f4 --- /dev/null +++ b/docs/ux/verwaltung/03-auswahl-und-zuordnung-entwurf.md @@ -0,0 +1,149 @@ +# Wiederverwendbare Auswahl und Zuordnung + +**Status: Listenbasis bestätigt; Detailausgestaltung zur Abstimmung.** Stand: 19.11.2026. Der Auftraggeber bevorzugt Entwurf 1 mit visuellen Vorschauen und individueller Detailprüfung. Noch keine Implementierungsfreigabe. + +## Ziel + +Bestehende Objekte schnell finden, inhaltlich prüfen, auswählen und mit einer klaren Handlung für den aktuellen Zweck übernehmen. Dasselbe Bedienmuster soll Medien, Module, Programme und Lizenzartikel unterstützen. Der fachliche Kontext bestimmt zulässige Typen, Referenzen und erforderliche Fassungen. + +## Abgestimmte Grundlage und Verfeinerung + +Die Liste mit kleinen visuellen Vorschauen ist die bevorzugte Grundansicht. Einzelne Elemente lassen sich in der Detailansicht prüfen. Die große eigenständige Auswahlliste aus Entwurf 3 wird zurückgestellt; kompakte Auswahlanzeige und Zähler bleiben der Arbeitsansatz. + +**Begründung aus dem Gespräch:** Zusätzlich zur Vorschau werden definierte fachliche Inhaltstypen, Nutzung und Verwertung benötigt. Eine feste Aufteilung in Bestand und große Auswahlliste würde den Raum für diese Informationen einschränken. + +![Verfeinerte Listenbasis mit fachlichen Informationsgruppen](bilder/auswahl-01-liste-detail-v2.png) + +Die Verfeinerung v2 ist eine visuelle Konkretisierung, noch keine abschließende Freigabe aller Beschriftungen, Gruppen und Eingabemöglichkeiten. + +## Bisherige visuelle Anordnungen + +| Gesprächsnummer | Anordnung | Stärke | Grenze | +|---|---|---|---| +| 1 | Liste mit Detailprüfung | Hohe Vergleichbarkeit gemischter Bestände, feste Detailansicht | Bildvergleich erfolgt stärker nacheinander | +| 2 | Bildraster mit Detailprüfung | Motive und Filmvorschauen schnell wiedererkennen | Weniger Einträge gleichzeitig, Textbestände benötigen kompakte passende Vorschauen | +| 3 | Bestand und Auswahl nebeneinander | Gewählter Umfang bleibt als eigene Liste sichtbar | Auswahl und Detailvorschau teilen sich Platz | + +Die Anordnungen sind Varianten desselben Komponentenvertrags. Daraus dürfen keine drei unabhängig entwickelten Picker mit abweichender Suche, Auswahl oder Bestätigung entstehen. Die Listenbasis ist gewählt. Die große separate Auswahlliste wird zurückgestellt. Ein optionaler Rasterwechsel bleibt offen und darf keine zweite Auswahl- oder Bestätigungslogik erzeugen. + +### Entwurf 1 + +![Liste und Detailprüfung](bilder/auswahl-01-liste-detail.png) + +### Entwurf 2 + +![Bildraster und Detailprüfung](bilder/auswahl-02-raster-detail.png) + +### Entwurf 3 + +![Bestand und Auswahl](bilder/auswahl-03-bestand-auswahl.png) + +## Komponentenvertrag – Vorschlag + +### Informationshierarchie der gewählten Liste – Entwurf + +| Bereich | Inhalt | Abgrenzung | +|---|---|---| +| Ergebniszeile | Kleines Vorschaubild oder passendes Typzeichen, Titel, fachlicher Inhaltstyp und knapper Fassungs-/Entwurfsstand | Keine zusätzlichen Spalten für sämtliche Verwaltungsinformationen | +| Detailvorschau | Größere Medienansicht beziehungsweise Text-/Dokumentvorschau und kurze Beschreibung | Öffnet für das betrachtete Element; verändert nicht automatisch dessen Auswahl | +| Einordnung | Fachlicher Inhaltstyp und weitere passende Klassifikation | Medienart und tatsächliches Dateiformat getrennt benennen; kein fachlicher Typ allein aus der Dateiendung ableiten | +| Verwendung | Tatsächliche Referenzen beziehungsweise Verwendungsstellen im vorhandenen System | Redaktioneller Verwendungszweck ist eine andere Aussage als eine tatsächliche Verwendung | +| Nutzung und Verwertung | Die vom Auftraggeber genannten weiteren fachlichen Angaben, soweit vorhanden und für die Auswahl relevant | Konkrete Begriffe, Felder und Rechtewirkung bleiben abzugleichen; keine Nutzungsberechtigung aus Klassifikation ableiten | +| Kompakte Auswahl | Zähler und identifizierbare gewählte Einträge | Keine dauerhaft große zweite Bestandsliste als Grundlayout | + +Diese Gruppen gliedern die Oberfläche. Sie verlangen keine neuen Datenmodelle. Anzahl und genaue Darstellung der Gruppen sind noch zu prüfen. Informationen werden bedarfsgerecht aufgeklappt oder über eine kleine Bereichsnavigation zugänglich gemacht; daraus entsteht keine lange Pflichtfeldliste. + +Suche und häufige Filter orientieren sich an der Aufgabe. Fachlicher Inhaltstyp, technische Medienart und tatsächliches Dateiformat müssen unterscheidbar bleiben, auch wenn nicht jeder Filter ständig sichtbar ist. + +### A. Anlass und Geltungsbereich + +- Überschrift benennt die auswählbaren Objekte: etwa „Medien auswählen“ oder „Lizenzartikel auswählen“. +- Ein kurzer Kontext benennt das Ziel und den Zweck, beispielsweise ein bestimmtes Modul oder die Wahl eines Titelbilds. +- Anhand des Aufrufs ist klar, ob hinzugefügt, ersetzt oder eine vorhandene Auswahl überarbeitet wird. Diese Vorgänge dürfen nicht dieselbe unbestimmte Bestätigung erhalten. +- Einzeln oder mehrfach auswählbare Objekte verwenden dieselbe Gestaltungsfamilie. Die Auswahlgrenze wird sichtbar erklärt. +- Die Auswahl erzeugt keine Medienkopien und keine zusätzlichen fachlichen Fassungen. Bestehende Referenz- und Versionsregeln bleiben wirksam. + +### B. Finden + +- Suche prominent; wenige häufige Filter direkt sichtbar, weitere Filter bedarfsgerecht erreichbar. +- Aktive Einschränkungen und Trefferzahl verständlich anzeigen; Einschränkungen gezielt zurücksetzen können. +- Auswahl bleibt beim Suchen, Filtern, Blättern und Wechsel der Darstellung erhalten. +- Der Auswahlzähler zählt auch momentan ausgefilterte gewählte Einträge. Diese bleiben über die Auswahlansicht auffindbar. +- Bei großen Beständen Ergebnisnavigation und Nachladen vorsehen; nicht die gesamte Datenmenge als lange Checkboxliste rendern. +- Fachlich unzulässige oder nicht nutzbare Objekte entsprechend bestehender Regeln behandeln. Wird ein Objekt angezeigt, erklärt eine verständliche Kennzeichnung die Einschränkung. Keine neue Berechtigungsregel in der Komponente definieren. + +### C. Betrachten und auswählen + +- **Betrachten** öffnet die Detailinformation zum Objekt, ohne seine Auswahl zu verändern. +- **Auswählen** setzt beziehungsweise entfernt die Zuordnung innerhalb des laufenden Auswahlvorgangs. +- Betrachtetes Objekt und gewählte Objekte sind unterschiedlich gekennzeichnet; die aktuelle Tastaturposition besitzt zusätzlich einen sichtbaren Fokus. +- Ein Objekt wird innerhalb einer gewählten Menge nur einmal gezählt. Fachlich erlaubte mehrfache Verwendungen an unterschiedlichen Stellen im Ziel werden dadurch nicht aufgehoben. +- Vorschau und Kurzbeschreibung helfen bei der Entscheidung; technische und weitere Verwaltungsangaben bleiben separat zugänglich. +- Fassung, Entwurf, Website-Sichtbarkeit und individuelles Zugriffsrecht sind unterschiedliche Aussagen. Die Komponente darf sie nicht durch ein pauschales grünes „freigegeben“ gleichsetzen. + +### D. Übernehmen und abbrechen + +- Ein sichtbarer Zähler und passende Beschriftung benennen die Bestätigung, etwa „2 Medien übernehmen“ oder „Dieses Bild verwenden“. +- Bestätigung übernimmt die für den erklärten Zweck gewählten Referenzen. Ein zusätzlicher allgemeiner Bestätigungsdialog ist im Normalfall nicht nötig. +- Abbrechen und Schließen lassen die vor dem Öffnen bestehende Zuordnung unverändert. +- Nach Übernahme zeigt der aufrufende Arbeitsplatz die geänderte Zuordnung und ihren tatsächlichen Speicherzustand. +- Der Picker veröffentlicht oder aktiviert keine Inhalte. Ob die übernommene Änderung direkt gespeichert wird oder zu einem fachlichen Entwurf gehört, richtet sich nach dem betroffenen Bereich; die Rückmeldung muss das eindeutig zeigen. +- Ergänzen, Ersetzen und Änderung einer bestehenden Menge müssen als eigene Aufrufabsicht beschrieben werden. Keine verdeckte Löschung bereits zugeordneter Einträge. + +### E. Reihenfolge und Kontextrollen + +- Das Auswählen von Objekten und das fachliche Ordnen der Verwendung sind getrennt nachvollziehbare Handlungen. +- Keine nur per Drag-and-drop erreichbare Auswahlhandlung. +- Fachlich erforderliche Reihenfolge und Rollen je Verwendung werden am Ziel oder in einer gezielten Anschlussbearbeitung geführt. Keine Kopie globaler Medienangaben als Ersatz für eine lokale Rolle. +- Ein späterer Reihenfolgebaustein unterstützt Ziehen sowie verständliche Alternativen über Tastatur und Auf-/Ab-Aktionen. + +### F. Tastatur und Rückmeldung + +- Beim Öffnen Fokus in die Auswahlfläche setzen; bei einem Dialog Fokus dort halten und Hintergrundbedienung verhindern. +- Schließen stellt den Fokus sinnvoll beim Auslöser wieder her. +- Suche, Filter, Ergebnisdetails, Auswahl, Entfernen und Übernehmen sind per Tastatur erreichbar. +- Trefferänderungen, Auswahlzahl, Fehler und deaktivierte Handlungen verständlich vermitteln; Farbe allein genügt nicht. +- Escape schließt bei einer Dialogvariante entsprechend Abbrechen. Sucheingabe, Auswahl und Rückweg dürfen keine unklaren Nebenwirkungen haben. + +## Erforderliche Zustände + +| Zustand | Erwartete Rückmeldung | +|---|---| +| Lädt | Ergebnisbereich zeigt Fortschritt; vorhandene Auswahl bleibt verständlich | +| Bestand leer | Erklärung und für die Rolle möglicher nächster Weg; kein leeres Dropdown | +| Suche ohne Treffer | Such- oder Filterkorrektur direkt möglich | +| Keine Auswahl | Keine irreführend ausführbare Übernahme; passende Beschriftung | +| Ein oder mehrere gewählte Objekte | Anzahl, Namen und Entfernung nachvollziehbar | +| Objekt nicht zulässig oder inzwischen verändert | Grund nennen und Korrektur anbieten; keine stille Entfernung | +| Übernahme fehlgeschlagen | Auswahl und Kontext erhalten; verständliche Wiederholung ermöglichen | +| Übernahme abgeschlossen | Ziel zeigt Ergebnis sowie tatsächlichen Speicherzustand | + +## Vorgeschlagene UX-Abnahmefälle + +Diese Fälle sind Prüfziele für eine spätere Implementierung, keine bereits bestandenen Tests. + +| ID | Beispiel | Erwartung | +|---|---|---| +| PICK-01 | Zwei Objekte wählen, anschließend Suche ändern | Beide bleiben gewählt; Anzahl bleibt korrekt | +| PICK-02 | Anderes Objekt zur Detailprüfung anklicken | Vorhandene Auswahl bleibt unverändert | +| PICK-03 | Eine Darstellung wechseln, sofern ein zusätzlicher Ansichtsmodus vorgesehen wird | Dieselben Identitäten bleiben gewählt; die bestätigte Grundansicht bleibt die Liste | +| PICK-04 | Objekt in der Auswahl entfernen | Auswahlanzeige und Ergebniskennzeichnung stimmen überein | +| PICK-05 | Dialog mit geänderter Auswahl abbrechen | Vorherige Zuordnung im Ziel bleibt erhalten | +| PICK-06 | Auswahl bestätigen | Richtige Referenzen erscheinen im erklärten Ziel; Ergebnis wird nicht öffentlich aktiviert | +| PICK-07 | Ein einzelnes Titelbild wählen | Klarer Einzelmodus und eindeutiger Ersetzungshinweis | +| PICK-08 | Fokus durch gesamten Dialog bewegen | Kein Fokus hinter dem Dialog; sinnvoller Rücksprung beim Schließen | +| PICK-09 | Ausgewähltes Objekt wird vor Übernahme unzulässig | Verständliche Rückmeldung; übrige Auswahl bleibt erhalten | +| PICK-10 | Große Ergebnisliste mit mehreren Seiten nutzen | Auswahl bleibt über alle Seiten stabil | +| PICK-11 | Bereits verwendetes Medium für andere erlaubte Stelle wählen | Zulässige Wiederverwendung bleibt möglich, kein erzwungenes Kopieren | +| PICK-12 | Ein Medium im CMS und eines im fachlichen Aufbau wählen | Gemeinsame Bedienregeln, jeweils korrekte fachliche Zulässigkeit | +| PICK-13 | Fachlichen Inhaltstyp und technische Medienart beziehungsweise Dateiformat prüfen | Angaben bleiben unterscheidbar; fachliche Einordnung wird nicht allein aus dem Format abgeleitet | +| PICK-14 | Verwendung sowie Angaben zu Nutzung und Verwertung prüfen | Quelle und Bedeutung werden erkennbar; Klassifikation erzeugt keine neue Lizenz oder Rechtezusage | + +## Grenzen der erzeugten Bilder + +- Die im Bild v2 gezeigten Werte wie „Hinweistext“, „Filmbeispiel“ oder „Trainerunterlage“ sind illustrative Beispielklassifikationen und keine neu freigegebenen Katalogwerte. +- Bilder zeigen exemplarische Namen und Vorschaumotive. Bei der Umsetzung reale Objektidentitäten, Fassungen und freigegebene Medien korrekt verbinden. +- Einzelne Miniaturen der erzeugten Bilder sind nicht zuverlässig den echten Medien zugeordnet und dürfen nicht als neue Produktassets übernommen werden. +- Beim dritten Bild ist der abgedunkelte Hintergrundpfad „Angebote / … / Modul“ unzutreffend. Er gehört nicht zum vorgeschlagenen Muster; der Rückweg muss zum tatsächlichen Ausgangsobjekt führen. +- Fokus-, Auswahl- und Betrachtungskennzeichnung müssen in der Umsetzung getrennt geprüft werden. Die blaue Markierung in den Bildern ist allein kein Nachweis korrekter Tastaturführung. +- Suche, Filter, Medienplayer und Schaltflächen der Bilder sind nicht funktionsfähig. Alle obigen Interaktions- und Fehlerfälle bedürfen realer Tests. diff --git a/docs/ux/verwaltung/04-fachliche-anforderungen.md b/docs/ux/verwaltung/04-fachliche-anforderungen.md new file mode 100644 index 0000000..9014747 --- /dev/null +++ b/docs/ux/verwaltung/04-fachliche-anforderungen.md @@ -0,0 +1,132 @@ +# Fachliche Anforderungen, Alternativen und offene Fragen + +Stand: 19.11.2026. Quellen: Diskussion des Auftraggebers während UX-Audit und Designabstimmung sowie ausdrücklich gekennzeichneter Abgleich mit vorhandenen Fachkonzepten. + +## Zweck und Geltung + +Diese Liste bewahrt fachliche Hinweise für die spätere Coder-Übergabe. Sie definiert die Fachlichkeit nicht vollständig und ersetzt die bestehenden Spezifikationen nicht. + +**Bedeutung der Statusangaben:** „Bedarf bestätigt“ heißt, dass der Auftraggeber den Anwendungsfall benötigt. Das legt dessen Datenmodell, Geschäftsregel oder konkrete Implementierung noch nicht fest. „Offen“ bezeichnet eine ausdrücklich noch nicht entschiedene Alternative. „Bestandsschutz“ bezeichnet eine aus dem ursprünglichen Auftrag und den vorhandenen Dokumenten fortgeltende Grenze. + +## Kontext und Anforderungen + +| ID | Anforderung / Hinweis | Status | Konsequenz für Design und spätere Übergabe | +|---|---|---|---| +| FACH-01 | In der Regel arbeitet eine Person an den Inhalten und wechselt zwischen mehreren Verwaltungsaufgaben | Kontext bestätigt | Schneller Aufgabenwechsel, klare Rückwege; keine zusätzliche personelle Freigabeschleife allein aus dem Design erfinden. Bestehende Rechte und erforderliche Prüfungen bleiben erhalten | +| FACH-02 | CMS baut den öffentlichen Auftritt auf und stellt die visuelle Identität her | Bedarf bestätigt | Eigener Arbeitskontext für Websiteaufbau und Ausgabeprüfung | +| FACH-03 | Medienverwaltung dient allen Bereichen | Bedarf bestätigt | Gemeinsamer Bestand und wiederverwendbare Suche/Auswahl; keine zweite Medienverwaltung pro Fachbereich | +| FACH-04 | Module, Programme und Trainingspläne gehören zu den kaufbaren beziehungsweise lizenzierbaren Lernangeboten | Bedarf bestätigt | In Gesamtnavigation und Zielkonzept berücksichtigen; genaue Abbildung auf bestehende Lizenzartikel und Angebote gesondert prüfen | +| FACH-05 | Laufend neue Elemente, Angebote und Bundles zusammenstellen | Bedarf bestätigt | Auswahl, Zuordnung und Zusammenstellung sind zentrale alltägliche Arbeitsabläufe | +| FACH-06 | Shop-, Lizenz-, Mitgliederverwaltung und Sonderrabatte gehören zu häufigen Aufgaben des erwarteten Gesamtsystems | Bedarf bestätigt; vollständige Arbeitsplätze laut Auftraggeber noch nicht gebaut | Im Gesamtkonzept Platz vorsehen; vorhandene Basisfunktionen nicht mit vollständigen Arbeitsplätzen gleichsetzen | +| FACH-07 | Kombinationen und Pakete konnten bisher nicht sinnvoll konfiguriert und genutzt werden | Nutzerbericht, nicht durch erfolgreiche Konfiguration widerlegt | Leere Bestände nicht nur als fehlende Testdaten behandeln; später einen realen Beispielablauf prüfen | +| FACH-08 | Ein bereits aktiviertes Angebot muss geändert werden können | Bedarf bestätigt; Wirksamkeits- und Fassungsregeln offen | Zugang „Bearbeiten“ im selben Arbeitsplatz; Wirkung und betroffene Gegenstände klar zeigen. Keine vollständige Neuerfassung erzwingen | +| FACH-09 | Ein bestehendes oder altes Angebot soll als Schablone für ein weiteres dienen können | Bedarf bestätigt; Übernahmeregeln offen | Eigenständige Handlung „Als Vorlage verwenden“ vorsehen. Welche Texte, Varianten, Zeiträume und Rabattregeln übernommen oder zurückgesetzt werden, ist noch festzulegen | +| FACH-10 | Parallele Angebote müssen möglich sein | Bedarf bestätigt; Detailregeln offen | Mehrere eigenständige Angebote mit überlappendem Inhalt oder abweichenden Konditionen verständlich verwaltbar halten | +| FACH-11 | Varianten nach der zu erwerbenden Lizenz können innerhalb eines Angebots liegen | Fachliche Möglichkeit ausdrücklich genannt | Design muss Varianten verständlich darstellen können; keine Festlegung auf eine einzige Variante pro Angebot | +| FACH-12 | Alternativ können Lizenzvarianten als parallele Angebote geführt werden, etwa bei anderen Laufzeiten oder Beschreibungen | Alternative ausdrücklich offen | Nicht durch Navigation oder Auswahlmaske ausschließen; keine automatische Entscheidung zwischen Variante und eigenständigem Angebot | +| FACH-13 | Angebote können Laufzeiten haben | Bedarf bestätigt; genaue Regeln offen | Lizenzdauer, Verkaufs-/Angebotszeitraum und gegebenenfalls Aktionszeitraum begrifflich unterscheidbar halten; vorhandenes Modell abgleichen | +| FACH-14 | Rabattierungslogiken und Sonderrabatte müssen berücksichtigt werden | Bedarf bestätigt; Mechanik offen | Platz und verständliche Bearbeitung vorsehen. Preisformeln, Gültigkeit, Zielgruppen, Kombinierbarkeit und Vorrang von Regeln bleiben offen | +| FACH-15 | Mehrere Präsentationsformen: ausführliche Produktseite, Kacheln mit Kurzangaben und weitere Ansichten | Bedarf bestätigt | Präsentation eigenständig, ausgabespezifisch prüfbar; keine einzelne Shopvorschau zum zentralen Angebotseditor machen | +| FACH-16 | Präsentation speist sich hauptsächlich aus Beschreibungen des jeweiligen Einzelprodukts, etwa Programm, Modul oder Sammlung | Bedarf bestätigt; Detailauflösung abzugleichen | Quelle und wirksamen Text erkennbar machen. Bei mehreren Produkten keine automatische gemeinsame Beschreibung unterstellen | +| FACH-17 | Beschreibungen sollen überarbeitbar bleiben | Bedarf bestätigt; Geltungsbereich je Änderung prüfen | Eigene Abweichung, Produktangabe und ausgabespezifische Formulierung verständlich unterscheiden; Rückkehr zur Quelle gestalterisch berücksichtigen | +| FACH-18 | Fachliche Modelle, Beziehungen, Versionierung und Rechte bleiben erhalten | Bestandsschutz aus ursprünglichem Auftrag | Änderungen daran benötigen gesonderte fachliche Entscheidung und eigenen Umsetzungsauftrag | +| FACH-19 | Fachliche Diskussion darf das Designprojekt nicht zu einer vollständigen Fachneukonzeption ausweiten | Vom Auftraggeber ausdrücklich begrenzt | Anforderungen und offene Fragen bewahren; UI-Gestaltung mit offenen fachlichen Stellen weiterführen | +| FACH-20 | Neue und bestehende Angebote über dieselbe Grundmaske bearbeiten; Bereiche direkt anklicken und korrigieren | Bestätigte Bedienanforderung | Gemeinsamer Arbeitsplatz und Direktzugriff; genaue Fachlogik hinter den Bereichen gesondert definieren | +| FACH-21 | Definierte fachliche Inhaltstypen weichen von Dateitypen ab | Bedarf ausdrücklich bestätigt | Auswahl und Detailprüfung müssen fachlichen Inhaltstyp, technische Medienart und gegebenenfalls Dateiformat unterscheidbar darstellen; keine Klassifikation allein aus einer Dateiendung ableiten | +| FACH-22 | Nutzung und Verwertung werden zusätzlich für die Auswahlprüfung benötigt | Bedarf ausdrücklich genannt; genaue Bedeutung offen | In der Detailprüfung Raum und Zugriff vorsehen; keine festgelegte Taxonomie, Rechtewirkung oder neue Datenstruktur unterstellen | +| FACH-23 | Rolle und Reihenfolge beziehen sich auf eine konkrete Verwendung innerhalb einer Komposition | Vorhandener Fachkonzeptstand, keine neue Geschäftsentscheidung | Lokale Rolle, Hinweis und Position von globalen Objektangaben unterscheidbar bearbeiten; spätere Umsetzung mit bestehenden Feldern und Fassungsregeln abgleichen | +| FACH-24 | Kompositionen können Medien und andere Kompositionen mehrfach und verschachtelt referenzieren | Vorhandener Fachkonzeptstand und Bestandsschutz | Konkrete Vorkommen unabhängig anzeigen; keine neue feste Produkthierarchie, automatische Quellenkopie oder stille Aktualisierung auf neueste Fassung einführen | +| FACH-25 | Bereite Inhaltsfassungen und freigegebene Artikelstände sind noch nicht automatisch veröffentlicht | Vorhandener Dokumentationsstand, keine neue Geschäftsentscheidung | Fassung, Artikel-Stand, Vorgang und tatsächliche Verfügbarkeit am richtigen Gegenstand anzeigen; genaue Zustandsabbildung siehe OFF-14 | +| FACH-26 | Dieselbe Person kann erstellen, prüfen und freigeben; Handlungen bleiben getrennt und protokolliert | Vorhandener Dokumentationsstand, passend zum Einpersonenbetrieb | Keine pauschale neue Vier-Augen-Pflicht einführen; bestehende Rechte und Konfiguration erhalten | +| FACH-27 | CMS-Seiten haben eigene Revisionen und einen gesonderten Veröffentlichungsablauf mit optionaler Freigabe | Vorhandener Dokumentationsstand | Kein formales Lernproduktverfahren für jede Seitenänderung erzwingen | +| FACH-28 | Aktuelle Anzeigedaten können ohne neue Inhaltsfassung direkt wirksam geändert werden | Vorhandene Änderungsklasse A; keine erneute fachliche Freigabe | Speichern und Wirkung unterscheiden; Meldung unveränderter Artikelstände darf keine Wirkungslosigkeit redaktioneller Änderungen vortäuschen | +| FACH-29 | Anzeigefreigabe G2 gilt für genau eine Kompositionsfassung, unabhängig von Bereitschaft und Artikel-Stand | E-A/G2; im MVP-Abschlussbericht vom 16.11.2026 als umgesetzt dokumentiert | Eigene Statusinformation und Handlung im Kompositionsarbeitsplatz. Eine Elternstruktur zeigt fixierte Kinder ohne zusätzliche Einzel-Freigabeschleife; eigenständige Modulansicht benötigt eigene Freigabe | +| FACH-30 | Öffentliche Listung ist eine zusätzliche Entscheidung gegenüber Anzeigefreigabe und kommerzieller Aktivierung | ADR-29/Website-Zielkonzept §6.2: Architekturentwurf; laut ADR-41 vom 19.11.2026 nicht entschieden | Als getrennten Bedarf berücksichtigen. Keine allgemeine Umsetzung oder neue Betreiberfreigabe behaupten; aktuell dokumentierte öffentliche Übergangsregeln beachten | +| FACH-31 | Medienfreigabe für die Website und Veröffentlichung einer CMS-Seitenrevision sind getrennt | ADR-40/41, Medienzugriff für Komponenten | Verwendende Seite und freigegebene Medienableitung gesondert anzeigen; CMS-Bildupload kann nach erfolgreicher Ableitung automatisch die Website-Medienfreigabe erhalten | +| FACH-32 | Der Produktumfang bleibt überschaubar; es werden nicht tausende Produkte angeboten | Vom Auftraggeber ausdrücklich genannter Maßstab | Kleine Redaktion und direkte alltägliche Aufgaben priorisieren. Keine zusätzlichen Betriebsabläufe allein für hypothetische Shopskalierung | +| FACH-33 | Module, Programme und Trainingspläne sind lizenzierbare Produkte; daneben gibt es öffentliche Produktanteile und veröffentlichte Webseiten | Vom Auftraggeber ausdrücklich bekräftigt; technische Artikelabbildung bleibt bestehendem Fachmodell vorbehalten | Produktpflege, öffentliche Darstellung und CMS verständlich verbinden; unterschiedliche Wirkungen erhalten, ohne sie als viele isolierte Freigabeverwaltungen darzustellen | +| FACH-34 | Aktuelle und historische Versionen müssen handhabbar bleiben | Vom Auftraggeber ausdrücklich bekräftigt | Aktuell genutzte Fassung, Bearbeitungsentwurf und Verlauf klar unterscheiden; Versionierung nicht bei jedem Arbeitsschritt zur Zusatzaufgabe machen | +| FACH-35 | Das Kursbuchsystem ist noch nicht begonnen und muss integriert werden | Vom Auftraggeber ausdrücklich genannt; konkrete Funktionen offen | Eigener künftiger Arbeitskontext innerhalb derselben Plattform. Keine Gleichsetzung mit Kursplaner, Fortschrittskontrolle oder einem bereits definierten Funktionspaket | +| FACH-36 | Bereits erworbene Nutzungsrechte dürfen durch unbedachte normale Änderungen nicht entzogen oder verändert werden | Vom Auftraggeber ausdrücklich bestätigt | Bestehende Erwerbe und vereinbarte Bedingungen erhalten; Angebotsänderung und öffentliches Ausblenden nicht mit Rechteentzug gleichsetzen. Gültigkeitsregeln und vorhandene Updatezusagen bleiben bestehen | +| FACH-37 | Einzelne Elemente müssen aus Lizenz- oder anderen rechtlich notwendigen Gründen mit sofortiger Wirkung zurückgezogen werden können | Vom Auftraggeber ausdrücklich bestätigt | Eigener verständlicher Rückzugsweg. Betroffener Gegenstand und Verwendungen nachvollziehbar; weitere Bereitstellung im nötigen Umfang sperren, ohne eine normale Veröffentlichungsschleife abzuwarten | +| FACH-38 | Rückzug eines Inhalts und Bestand eines Erwerbs sind getrennte Sachverhalte | Dokumentierter Bestand, passend zur bestätigten Leitplanke | Erwerbe, Berechtigungen, Bestellungen und Ausgabenachweise erhalten; Rückzugsgrund und Zeitpunkt nachvollziehbar. Ein gesperrter Inhalt kann trotz fortbestehender Berechtigung nicht verfügbar sein; keine automatische Erstattung oder pauschale Lizenzaufhebung aus dem UX-Muster ableiten | +| FACH-39 | Gemeinsame zentrale Redaktion für Medien, Module, Programme und Lizenzartikel; später weitere Objekte einschließlich Trainingsplänen | Vom Auftraggeber ausdrücklich bekräftigt; Planungstext als Quelle abgelegt | Eine gemeinsame Datenbasis und derselbe visuelle Bedienbaustein am Fachobjekt. Bereits dokumentierte technische Grundlage wiederverwenden; keine vier unabhängigen Einzelmasken oder zweiter Datenbestand | +| FACH-40 | Jedes Objekt besitzt eigene Titel, Teaser, Kurz-/Langbeschreibung, Einordnung, Zielgruppenvarianten und Suchbegriffe | Vom Auftraggeber ausdrücklich bestätigt | Gezielte Bearbeitung mit erkennbarem Geltungsbereich. Gewöhnliche Angaben nicht automatisch als Medien anlegen; verbindliche Lehrtexte und Lernziele nach vorhandener Fachlogik behandeln. Zielgruppen- und Ausgabevarianten nicht gleichsetzen (OFF-19) | +| FACH-41 | Technische Medienart, fachliche Materialart, Verwendungszweck, Themen und Zielgruppen getrennt einordnen | Vom Auftraggeber ausdrücklich bestätigt; ergänzt FACH-21/22 | Klassifikation dient der Suche; sie ist weder tatsächliche Verwendung noch Freigabe oder Nutzungsrecht. Vorhandene Dimensionen nutzen | +| FACH-42 | Mehrere Präsentationsmedien je Rolle; reine Präsentationsmedien auch als Film ohne fachliche Inhaltsfassung | Vom Auftraggeber ausdrücklich bestätigt | Rollen wie Titelbild, Trailer, Interview, Vorschau und Galerie visuell mit Mehrfachzuordnung bedienen; nur Referenzen auf den zentralen Medienbestand, keine Kopien oder Pflicht-Lehrfassungen | +| FACH-43 | Lizenzartikel kann Texte und Präsentationsmedien der Quelle übernehmen oder eigene Angaben führen | Vom Auftraggeber ausdrücklich bestätigt | Herkunft und eigene Abweichung je Information zeigen. Preise, Nutzungsrechte und Vertragsbedingungen bleiben getrennt; genaue Rückfall-/Medienübernahmeregeln unter OFF-20 klären | +| FACH-44 | CMS verwendet zentrale Angaben standardmäßig und kann einzelne Felder lokal überschreiben | Vom Auftraggeber ausdrücklich bestätigt | Eigene Widgetabweichung und Rückkehr zur Quelle erkennbar; keine unbemerkte Bearbeitung des globalen Fachobjekts | +| FACH-45 | Visuelle Übersicht, gezielte Bearbeitung und gemeinsamer Medienpicker statt langer Formulare und textbasierter Radio-/Checkbox-Auswahl | Vom Auftraggeber ausdrücklich gefordert; aktuelle UX ausdrücklich nicht abgenommen | Einheitliche Zuordnung, Austausch, Entfernung und Reihenfolge einschließlich Drag-and-drop und Tastaturalternative. Bestehende technische Tests sind keine UX-Abnahme | +| FACH-46 | Öffentliche Präsentation mit Bildern, Teaservideos, Galerien/Slideshows und geeigneten Ausgabevorschauen | Vom Auftraggeber ausdrücklich gefordert; Website-Medienfreigabe gilt weiter | Ausgabe nur mit gültiger Website-Freigabe; Rücknahme entfernt das Medium, übrige Inhalte bleiben. Gewünschte Slideshow nicht mit einem bereits vorhandenen CMS-Widget gleichsetzen (OFF-21) | +| FACH-47 | Ein Unterrichtsfilm oder anderes Medium kann selbst eigene Texte und zugeordnete Präsentationsmedien besitzen | Vom Auftraggeber ausdrücklich präzisiert; ergänzt FACH-39/42 | Dieselben Redaktionsmasken wie bei Modul, Programm oder Lizenzartikel. Präsentationszuordnung nicht mit Austausch der Originaldatei oder verbindlichem Lehrinhalt verwechseln; keine übergeordnete Produktquelle erzwingen | +| FACH-48 | Texte und Medien müssen nicht gleichzeitig auf einer Redaktionsseite stehen | Vom Auftraggeber ausdrücklich als sinnvolle Möglichkeit genannt; Entwurf 1 als Grundlage bevorzugt | Gemeinsame Register für Texte, Präsentationsmedien und gegebenenfalls Einordnung konkretisieren. Benennung und Anordnung sind Entwurf; über Fachobjekte hinweg gleichartige Bedienung sicherstellen | +| FACH-49 | Aus Medium, Modul, Programm oder anderem Fachobjekt in einen gemeinsamen Redaktionsmanager wechseln und zur normalen Bearbeitung ohne Eingabeverlust zurückkehren | Vom Auftraggeber ausdrücklich verlangt; separater Redaktionsmanager als Möglichkeit akzeptiert | Ungespeicherte Ausgangseingaben und Bearbeitungsstelle erhalten. Kein vorgeschaltetes Pflichtspeichern und kein verdeckter Gesamtspeichervorgang. Aktueller Entwurf zeigt den Redaktionsbereich, nicht den vollständigen ursprünglichen Editor | +| FACH-50 | Grundsätzliche Designvorgaben müssen beim Umbau und bei künftigen Erweiterungen eingehalten werden | Vom Auftraggeber ausdrücklich als Ziel bekräftigt | Gemeinsame Komponenten, ein gepflegter Standard und überprüfbare Abnahme; keine Annahme, dass Regeldateien oder Bilder allein korrekte Umsetzung garantieren. Konkreter Vorschlag in Dokument 10 | +| FACH-51 | CMS-Raster mit höchstens vier logischen Einheiten; mehrere Bausteine nebeneinander mit unterschiedlichen Breiten und Höhen | Vom Auftraggeber ausdrücklich bekräftigt; gegen vorhandenen Layoutvertrag abgeglichen | Rasteranteile wie 1+1+2, 2+2 und 1+1+1+1 erkennbar. Höhe folgt Bausteintyp, Inhalt und zulässigen Optionen; kein neues freies Pixel-/Zeilenraster oder erzwungene gleiche Höhe | +| FACH-52 | Sämtliche bestehenden Abschnittsformatierungen und bausteinspezifischen Konfigurationen müssen angemessenen Platz haben | Vom Auftraggeber als fehlende Beurteilungsgrundlage der bisherigen Entwürfe benannt | Abschnittsgestaltung und Bausteinkonfiguration vollständig erreichbar halten; keine Pflicht, alles in eine schmale rechte Spalte zu pressen. Eigene große Konfigurationskontexte sind in Dokument 12 vorgeschlagen, noch nicht abschließend gewählt | +| FACH-53 | Informationen eines Fachobjekts für CMS-Bausteine stammen gegebenenfalls aus dem gemeinsamen Redaktionsmanager | Vom Auftraggeber ausdrücklich hervorgehoben; ergänzt FACH-43/44 | Fachobjektgebundene Bausteine referenzieren zentrale Daten; lokale Abweichungen bewusst kennzeichnen. Reine Seitenbausteine dürfen eigene Seiteninhalte besitzen; keine obligatorische neue Produktquelle für jeden Text | +| FACH-54 | Die gesamte Webpräsenz mit Seitenreihenfolge, Menüs, versteckten Seiten und übergreifenden Einstellungen verwalten | Vom Auftraggeber als bisher fehlende UX-Ebene ausdrücklich benannt | Gemeinsamer Arbeitsplatz oberhalb des einzelnen Seiteneditors. Vorhandene Seiten- und Navigationsverwaltung zusammenführen; genaue Aufteilung und visuelle Referenz bleiben Entwurf | +| FACH-55 | Veröffentlichungszustand einer Seite und Eigenschaften ihrer Menüeinträge sind unabhängig | Dokumentierter und rein lesend geprüfter Bestand | Menübeschriftung, Bereich, Reihenfolge, Unterpunkte und Sichtbarkeit nicht mit Seiteninhalt, Seitenveröffentlichung oder Suchmaschinenauffindbarkeit gleichsetzen. Eine Seite kann in mehreren oder keinem Menü vorkommen | + +## Bewusst offene Entscheidungen + +| ID | Frage | Bisherige Aussage | +|---|---|---| +| OFF-01 | Was ist in der künftigen Bedienung ein Angebot, eine Variante und eine eigene parallele Vermarktung? | Varianten innerhalb eines Angebots und parallele Angebote werden beide als mögliche Lösungen genannt | +| OFF-02 | Wie funktionieren Angebotsfassungen, Bearbeitung aktiver Angebote, Historie und Wirksamkeitswechsel genau? | Bestehende Dokumentation sieht feste aktive Fassungen vor; UX-Aussage einer zwingenden neuen Fassung bei jeder Bearbeitung wurde ausdrücklich wieder geöffnet | +| OFF-03 | Wie werden Änderungen für zukünftige Erwerbe und mögliche Wirkungen auf bestehende Berechtigungen unterschieden? | Historische Vereinbarungen und bereits festgelegte Aktualisierungsregeln erhalten; keine neue allgemeine Rückwirkungsregel beschlossen | +| OFF-04 | Was übernimmt eine Vorlage, was wird zurückgesetzt und bleibt eine Verbindung zur Vorlage bestehen? | Wiederverwendung alter und aktueller Angebote erforderlich; Details offen | +| OFF-05 | Wie werden Laufzeiten und unterschiedliche Zeiträume fachlich bestimmt? | Bedarf vorhanden; keine konkreten Dauern, Verlängerungs- oder Beendigungsregeln beschlossen | +| OFF-06 | Wann ist eine Aktion ein neues Angebot, wann eine Rabattregel? | Die Frage wurde gestellt, aber nicht entschieden; Diskussion zugunsten des Designs begrenzt | +| OFF-07 | Welche Rabattregeln gibt es und wie werden sie kombiniert? | Keine Preise, Formeln, Rangfolgen oder Kombinationsregeln beschlossen | +| OFF-08 | Wie leiten sich Beschreibung und Darstellung bei mehreren Produkten ab? | Einzelproduktdaten sind Hauptquelle; nicht eindeutig ableitbare Gesamttexte und Überschreibungen müssen gesondert geregelt werden | +| OFF-09 | Welche Stellung haben Trainingspläne und Sammlungen im bestehenden Modell? | Im erwarteten Arbeitsalltag genannt; keine neue technische Objekthierarchie entschieden | +| OFF-10 | Welche Angaben sind mit Nutzung und Verwertung gemeint und wie grenzen sie sich von Verwendungszweck, tatsächlichen Referenzen und Nutzungsrechten ab? | Der zusätzliche Informationsbedarf ist bestätigt. Vorhandene Begriffe und Daten abgleichen; im Design keine neue fachliche Bedeutung oder Zugriffserlaubnis festlegen | +| OFF-11 | Was geschieht mit lokalen Angaben, wenn die referenzierte Quelle oder Fassung ausgetauscht wird? | Der Aufbauentwurf verlangt nachvollziehbare Auswirkungen; Übernahme, Zurücksetzen oder Abgleich lokaler Angaben ist noch nicht entschieden | +| OFF-12 | Kann die Vorschau offene Eingaben darstellen, und welcher Datenstand wird andernfalls gezeigt? | Dokument 07 bevorzugt den aktuellen Arbeitsstand ohne dauerhafte Speicherung. Technische Machbarkeit und ausdrücklicher Rückfall auf gespeicherte Daten sind zu prüfen | +| OFF-13 | Welcher Speicherumfang gilt beim Wechsel zwischen Aufbau und direkt wirksamen Angaben? | Eingaben im laufenden Arbeitskontext erhalten; keine verdeckte sofortige Wirkung anderer Bereiche. Bereichsbezogenes Speichern ist ein UX-Vorschlag, noch nicht bestätigt | +| OFF-14 | Welche Zustände und Abschlussaktionen bestehen genau je Inhalts- und Kompositionsfassung? | Dokumentierte Lebenszyklen erhalten; Typen und Implementierungsstand abgleichen. Die neue Prüfung-Registerkarte definiert keinen universellen Statusautomaten | +| OFF-15 | Wie wird die öffentliche Listung nach ADR-29 fachlich bestätigt und gegenüber heutigen Übergangsregeln eingeführt? | Als Architekturentwurf beschrieben, am 19.11.2026 laut ADR-41 nicht entschieden. Fassungsauswahl und Folgen einer Rücknahme sind nicht durch das Verwaltungsmockup beschlossen | +| OFF-16 | Welche manuellen Freigaben sind eigenständige Entscheidungen, welche können entfallen oder in einer Nutzerhandlung koordiniert werden? | Der Auftraggeber hält die bisherige Komplexität für überhöht. Dokument 08 eröffnet ausdrücklich diese Prüfung. Weder die sieben Ebenen noch drei pauschale Handlungsfamilien sind als Pflichtstrecke bestätigt; bestehende Modelle bleiben bis zu gesonderter Entscheidung erhalten | +| OFF-17 | Welche konkreten Aufgaben und Schnittstellen umfasst das künftige Kursbuchsystem? | Integration ist erforderlich; Bedeutung und Abgrenzung zu redaktionellen Trainingsplan-Vorlagen, persönlicher Planung und Durchführung sind noch zu klären. Keine zusätzlichen Funktionen aus dem Begriff ableiten | +| OFF-18 | Wie erfasst eine verständliche Sofort-Rückzugshandlung alle betroffenen öffentlichen und geschützten Ausgabewege? | Sofortiger rechtlich notwendiger Rückzug ist bestätigt. Zielumfang, einzelne gegenüber sämtlichen Fassungen, verschachtelte Verwendungen, Website-Kopien, Zwischenspeicher, laufende Zugriffe und möglicher Ersatzstand sind am Bestand abzugleichen. Dokumentierte Sperre neuer Zugriffe nach Transaktionsende nicht mit dem Rückholen lokaler Dateien oder sofortigem Abbruch bereits ausgestellter Streams gleichsetzen | +| OFF-19 | Wie kombinieren sich Zielgruppen- und Ausgabevarianten, und welcher Text hat Vorrang? | Zielgruppenvarianten sind gefordert. Dokumentierter Bestand nennt vor allem Ausgabekontexte. Standard, Zielgruppe, Ausgabe und Rückfall sind vor abhängiger Implementierung zu klären | +| OFF-20 | Was bedeutet ein leerer eigener Text, und wie übernehmen Lizenzartikel geordnete Medienrollen? | Eigene/übernommene Angaben sind gefordert. Bewusst leer gegenüber Rückfall sowie Ersetzen/Ergänzen geordneter Quellmedien und eigene Reihenfolge sind nicht abschließend entschieden | +| OFF-21 | Wie werden Galerien und Slideshows je Ausgabe dargestellt und welche Einstellungen sind wirklich erforderlich? | Geordnete Präsentationsmedien sind gefordert; laut dokumentiertem CMS-Stand ist noch kein Slideshow-Widget eingesetzt. Rollenverwaltung ist keine Entscheidung über automatische Wiedergabe, Zeitsteuerung oder einen neuen Player | +| OFF-22 | Wie bleiben Eingaben und Rücksprungkontext zwischen Fachobjekteditor und Redaktionsmanager technisch erhalten? | Verlustfreie Rückkehr ist eine bestätigte Anforderung. Vor Umsetzung mit bestehenden Livewire-/Filament-Flüssen prüfen, einschließlich noch nicht angelegter Objekte, offener Uploads, Browser-Zurück und paralleler Bearbeitung überlappender Felder. Kein neuer Datenbestand oder automatisches Speichern durch diese Frage beschlossen | +| OFF-23 | Ist zusätzlich zur Menüreihenfolge eine eigene redaktionelle Seitenhierarchie oder interne Gruppierung gewünscht? | Im gelesenen Seitenmodell keine eigene Eltern-/Sortierhierarchie belegt. Organisation, URL-Struktur und automatische Navigation nicht als dieselbe neue Regel behandeln; keine stille Modellmigration | +| OFF-24 | Welche konkrete Wirkung sollen „versteckte Seiten“ erhalten? | Menüausblendung, Seite ohne öffentliche Revision und Suchmaschinenauffindbarkeit sind zu unterscheiden. Die vorhandenen Zustände verständlich anbieten; keine unscharfe neue Gesamtfreigabe oder vermeintlichen Zugriffsschutz erfinden | +| OFF-25 | Welche übergreifenden Website-Einstellungen gehören tatsächlich in den neuen Arbeitsplatz? | Kopf-/Fußnavigation ist vorhanden; freie Startseitenzuweisung, globale Abschnitte, gemeinsame Darstellungs- und weitere Grundeinstellungen sind nicht durch den Namen eines Konfigurators als umgesetzt oder beschlossen anzunehmen | + +## Gegenprüfung mit vorhandenen Projektquellen + +| Quelle | Bereits dokumentierte Aussage | Umgang damit | +|---|---|---| +| [Domänenmodell §6](../../architektur/04_Domaenenmodell.md) | Angebotsidentität bleibt bei Preis-/Umfangsänderung erhalten, neue Fassung; anderes Vermarktungsobjekt erhält andere Identität | Vorhandener Stand, keine neue Entscheidung dieses Designprojekts | +| [Produktkonfiguration §4 und §12](../../fachkonzept/produktkonfiguration-und-mitgliederbereich.md) | Klasse A Anzeigedaten, B Lehrinhalt, C kommerzielle Angaben; unterschiedliche Änderungsregeln | Bei Gestaltung erhalten; kein einheitlicher pauschaler Freigabezwang für alle Felder | +| [Redaktionelle Informationsbasis](../../architektur/redaktionelle-informationsbasis.md) | Eigene Objektangaben, Kontextvarianten und bei eindeutiger Quelle Ableitung am Lizenzartikel | Vorhandener Ansatz für Herkunft und Überschreibung; nicht ungeprüft auf alle Angebotsbeschreibungen erweitern | +| [Lizenz- und Berechtigungslogik](../../architektur/05_Lizenz_und_Berechtigungslogik.md) | Eigenständige Erwerbsquellen und Berechtigungen, gespeicherte Konditionen, Ausnahmen und dynamische Regeln | Historische Integrität und bestehende Regeln erhalten; keine neue Zusammenführung von Rechten aus UI vereinfachen | + +Zusätzlicher Bezug für FACH-25 bis FACH-27: [Versionierung und Veröffentlichung §§2–5 und §9](../../architektur/06_Versionierung_und_Veroeffentlichung.md). Die fachlichen Aussagen werden als Dokumentationsbestand bewahrt; die vorgeschlagene Bedienung steht in [Dokument 07](07-speichern-vorschau-freigabe-entwurf.md). + +FACH-29 bis FACH-31 sind in [Dokument 07](07-speichern-vorschau-freigabe-entwurf.md) mit Quellen und deren Status abgeglichen: E-A/G2 und MVP-Abschlussbericht, Website-Zielarchitektur §6.2/ADR-29, ADR-40/41 und Medienzugriff. + +Die offenen Fragen dokumentieren Prüfbedarf. Sie erlauben einem Coding-Agenten nicht, bisherige Regeln stillschweigend zu ändern. Ebenso darf aus dem alten Dokumentationsstand keine angebliche erneute Freigabe im Designgespräch abgeleitet werden. + +FACH-39 bis FACH-46 beziehen sich unmittelbar auf den [Planungstext zum Redaktionsmodul](quellen/redaktionsmodul-planungschat-2026-11-19.md). [Dokument 09](09-redaktionsarbeitsplatz-entwurf.md) trennt bestätigten Bedarf, dokumentierten Bestand und vorgeschlagene Bedienung. + +## Beispielszenarien für spätere fachliche Klärung + +Diese Szenarien sind zu prüfende Fälle, keine bereits vollständig festgelegten Abnahmebedingungen. + +1. Ein aktives Angebot wird für weitere Verkäufe überarbeitet; bisheriger Zustand und betroffene Erwerbe sind nachvollziehbar. +2. Ein altes Angebot wird als Ausgangspunkt einer neuen Vermarktung verwendet; Dateien und Produkte werden dafür nicht unnötig kopiert. +3. Zwei Angebote beziehen sich auf dasselbe Lernprodukt und haben unterschiedliche Lizenzbedingungen oder Laufzeiten. +4. Zwei Lizenzvarianten werden innerhalb eines Angebots dargestellt und verwaltet; ihre Unterschiede bleiben erkennbar. +5. Ein zeitlich begrenzter Vorteil wird gewährt; ob eigenes Angebot oder Rabattregel bleibt Gegenstand der Fachentscheidung. +6. Ein Programm erscheint als Kachel mit Kurztext und auf einer ausführlichen Produktseite; Quelle, Ausgabevariante und eigene redaktionelle Abweichung bleiben nachvollziehbar. +7. Ein Bundle wird aus vorhandenen Artikeln zusammengestellt und hinsichtlich tatsächlichem Umfang und Rechten geprüft. + +## Fortschreibung + +Bei jeder fachlichen Ergänzung: bestehende Kennung ergänzen oder neue Kennung anlegen, Status benennen, Bezug zur Quelle notieren und Auswirkungen auf die UX markieren. Offene Alternativen erst nach ausdrücklicher Entscheidung schließen. Bilder und generierte Beispieldaten begründen keine Geschäftsregel. diff --git a/docs/ux/verwaltung/05-coder-uebergabe-arbeitsstand.md b/docs/ux/verwaltung/05-coder-uebergabe-arbeitsstand.md new file mode 100644 index 0000000..c2a1fe7 --- /dev/null +++ b/docs/ux/verwaltung/05-coder-uebergabe-arbeitsstand.md @@ -0,0 +1,72 @@ +# Übergabe an Cursor und Claude Code – Arbeitsstand + +> **Aktualisierung 19.11.2026:** Die gemeinsame Designrichtung reicht für den Umbau aus. Maßgeblich ist jetzt [Dokument 14 – verbindlicher Verwaltungsstandard](14-verwaltungsstandard.md), ergänzt durch den [konkreten Umbauauftrag](15-umbauauftrag.md). Frühere allgemeine Hinweise auf ausstehende Detailabstimmungen sind unten als Arbeitsverlauf erhalten; sie sind keine weitere pauschale Startbedingung. Offene Geschäftsfragen bleiben abgegrenzt. Die Anwendung wurde durch diese Dokumentation nicht verändert. + +Historischer Arbeitsstand bis zur Konsolidierung am 19.11.2026. Der aktuelle Standard und der vorbereitete Auftrag stehen in Dokument 14/15; hier bleiben Herkunft und damalige Abgrenzungen nachvollziehbar. + +## Zweck + +Diese Ablage macht den bisherigen Audit- und Abstimmungsstand dauerhaft überprüfbar. Coding-Agenten sollen bestätigte Designentscheidungen, vorgeschlagene Muster und offene fachliche Fragen unterscheiden können. + +## Reihenfolge für die spätere Bearbeitung + +1. README und Geltungsstatus lesen. +2. Bestätigte Designrichtung in Dokument 02 prüfen. +3. Fachliche Anforderungen und offene Fragen in Dokument 04 lesen. +4. Für den beauftragten Teil das konkrete Interaktionsmuster sowie die passenden aktuellen Auditbelege heranziehen. +5. Erst einen ausdrücklich beauftragten und visuell abgestimmten Teil implementieren. + +## Vorrang für die weitere Bedienausarbeitung + +Dokument 08 und UX-D16/17 legen den tatsächlichen kleinen Betrieb und die spätere Kursbuchintegration als Maßstab fest. Dokument 07 ist ein Abgleich vorhandener Freigabeebenen mit noch offenen Bedienvorschlägen, kein Auftrag zu sieben manuellen Freigabestrecken. Zuerst einen durchgängigen normalen Produktablauf abstimmen; Ausnahmefälle danach einordnen. OFF-16 erlaubt die gezielte Prüfung einer Vereinfachung, aber noch keine Änderung fachlicher Regeln oder Datenmodelle. + +## Konsolidierung und Regelvorlagen + +Dokument 10 bündelt den Vorschlag für gemeinsame Arbeitsplatzfamilien und Komponenten. Vor einem Umbau die dort genannten Referenzlücken und den Status des beauftragten Teils beachten. Nicht für jeden Fachobjekttyp einen unabhängigen Screen entwerfen. Dokument 11 ist eine Zusammenfassung vorhandener CMS-Belege mit erneuter Zugriffsgrenze, keine aktuelle umfassende Fehlerbestätigung. + +Die Dateien unter `docs/ux/verwaltung/regeln/` sind ausschließlich vorbereitete Regel- und Abnahmevorlagen. Keine aktive `.cursor/rules/`, `CLAUDE.md` oder `AGENTS.md` wurde ersetzt. Erst nach Abstimmung den passenden aktiven Einstieg auf denselben Standard ausrichten; Betriebs- und Testregeln bleiben erhalten. + +## CMS-Ausarbeitung und vorhandene Programm-/Modulbearbeitung + +Dokument 12 führt nach Rückmeldung zu Vierer-Raster, Abschnittsgestaltung und Konfigurationstiefe einen zusammenhängenden Vorschlag mit drei Arbeitszuständen weiter. Die ersten drei Anordnungen bleiben Vergleich; CMS-01 bis CMS-23 sind vorgeschlagene Prüfziele. Die neue Aufteilung ist noch nicht abschließend bestätigt. Keine Pflicht zur gesamten Konfiguration in einer schmalen rechten Spalte. Alle vorhandenen Abschnitts- und typabhängigen Bausteinoptionen sowie zentrale Redaktionsquellen berücksichtigen; Registry, Raster und Revisionen erhalten. + +Der Programm-/Modulaufbau ist bereits räumlich abgestimmt. Dort werden nur Redaktionseinstieg, Rückweg und gemeinsame Komponenten ergänzt; die frühere Aussage eines vollständig fehlenden Bearbeitungsarbeitsplatzes ist damit korrigiert. Dokument 06 beschreibt die Ergänzung. + +## Webpräsenz als übergeordnete Ebene + +Dokument 13 ergänzt den fehlenden Gesamtarbeitsplatz für Seitenbestand, Menüs und Sichtbarkeit. Die aktuelle CMS-Bildserie betrifft nur die Einzel-Seitenbearbeitung. Vorhandene Seiten- und Navigationsmodelle wiederverwenden; keine automatische Gleichsetzung von Menüreihenfolge, Seitenbaum, Seitenveröffentlichung und Suchmaschinenauffindbarkeit. FACH-54/55 und OFF-23 bis OFF-25 beachten. Die Rückmeldung bevorzugt Entwurf 1 und 3. Eine Kombination abhängig von verfügbarer Fensterbreite ist vorgeschlagen, aber noch nicht bestätigt. Gleiche Felder, Aktionen und Erhalt offener Änderungen sowie Begrenzung des Inline-Scrollaufwands sind dabei zu konkretisieren; keine feste Umschaltbreite aus den Bildern ableiten. WEB-R01 bis WEB-R07 und WEB-01 bis WEB-13 sind vorgeschlagene Bedienregeln und Abnahmefälle. Bilddetails sind kein Auftrag für neue Seitenhierarchien, Website-Einstellungen oder Navigationsversionierung. + +## Grenzen + +- Bestehende Modelle, Datenbeziehungen, Rechte und Versionierung bleiben erhalten. Offene Alternativen sind kein Auftrag zur Migration oder fachlichen Neuordnung. +- Laravel, Filament und Livewire bleiben Grundlage. +- Keine separate Lösung pro Fachobjekttyp. Gemeinsame Komponenten dürfen kontextspezifische zulässige Typen und Referenzregeln erhalten. +- Keine pauschale neue Versions- oder Freigabeschleife für jede Eingabe. Bereits dokumentierte Änderungsklassen und CMS-Revisionen beachten. +- Auswahlentwurf 1 ist als bevorzugte Listenbasis bestätigt (UX-D13). Das Bild v2 konkretisiert zusätzliche Informationsgruppen. Die genaue Feldbelegung, Filter und Interaktionsdetails bleiben Entwurf; daraus folgt noch kein Implementierungsauftrag. Entwurf 3 mit großer separater Auswahlliste wird zurückgestellt. +- Angebotsvarianten, Vorlagen, parallele Angebote, Laufzeiten, Rabattregeln und Beschreibungsableitung sind in Dokument 04 mit Status erfasst. Offene Punkte nicht selbst zu neuen Geschäftsregeln vervollständigen. +- Für den Modul-/Programmaufbau ist die Kombination aus Arbeitsaufteilung von Entwurf 2 und Rahmen/Gruppierung aus Entwurf 1 bestätigt (UX-D15). Die kombinierte Referenz und Dokument 06 sind maßgeblich für diese räumliche Richtung. Genaue Felder, Zustände und BUILD-Prüffälle sind noch weiter abzustimmen. Lokale Verwendung und Quellenbearbeitung dürfen nicht unbemerkt zusammenfallen. +- Dokument 07 ergänzt vorgeschlagene Speicher-, Vorschau- und Freigaberegeln sowie STATE-01 bis STATE-29. Sie sind noch nicht bestätigt. Das Bild verfeinert den gewählten Aufbauarbeitsplatz; direkte Anzeigedaten, fachliche Fassungen und CMS-Revisionen nicht zu einem neuen generischen Freigabeprozess vereinheitlichen. OFF-12 bis OFF-14 vor dem jeweils abhängigen Umsetzungsteil klären. +- Anzeigefreigabe G2 einer Kompositionsfassung ist ein eigener fachlicher Weg. Sie darf nicht durch Artikelveröffentlichung ersetzt werden. Öffentliche Listung nach ADR-29 ist zusätzlich und noch als Zielkonzept/offene Entscheidung zu führen (OFF-15); heutige öffentliche Übergangsregeln, CMS-Seitenveröffentlichung und Website-Medienfreigabe erhalten. Quellenabgleich und STATE-24 bis STATE-29 stehen in Dokument 07. +- UX-D18/19 schützen bestehende Erwerbe und ermöglichen ausdrücklich rechtlich notwendige Sofort-Rückzüge. Normale Bearbeitung, Beenden eines Angebots und öffentliches Verbergen dürfen keinen beiläufigen Rechteentzug auslösen. Rückzug sperrt betroffene Inhalte bei erhaltener Erwerbs-/Rechtehistorie. Die koordinierte Wirkung über geschützte Ausgaben, historische Verwendungen und Website-Medien ist nach OFF-18 gesondert zu prüfen; keine vollständige aktuelle Sperrwirkung als schon abgenommen behaupten. +- UX-D20/21 und Dokument 09 beschreiben die gemeinsame Redaktion. Der vollständige Planungstext ist als Quelle abgelegt. Bestehende gemeinsame Daten/Leser wiederverwenden; die aktuelle UX ist nicht abgenommen. Redaktionsentwurf 1 ist als Grundlage gewählt (UX-D22); gemeinsame Register werden am Unterrichtsfilm konkretisiert. Keine Pflicht zu einer gleichzeitigen Text-/Medienspalte. Die gleichen Masken müssen auch die redaktionellen Zuordnungen von Filmen und anderen Medien bedienen; eine Lizenzartikelquelle nicht voraussetzen. Mehrere Medien pro Rolle und Präsentationsmedien ohne Lehrfassung erhalten; nur den gemeinsamen visuellen Picker einsetzen. Zielgruppenvarianten, Medienübernahme und Slideshow-Ausgabe bleiben unter OFF-19 bis OFF-21 offen. +- UX-D23/FACH-49: Ein eigener Redaktionsmanager ist zulässig; der verlustfreie Rückweg zur tatsächlichen Fachobjektbearbeitung ist Pflicht. Ungespeicherte Eingaben erhalten, keine vorgeschaltete Gesamtspeicherung und kein veraltetes Zurückschreiben redaktioneller Werte. Die aktuelle Abbildung zeigt nur die Redaktion. Hin-/Rückweg, neue Objekte, Uploadzustand und Browser-Zurück sind unter OFF-22 sowie RED-22 bis RED-26 zu prüfen. +- Die generierten Bilder sind visuelle Referenzen. Echte Komponenten, korrekte Daten und reale Produktbilder verwenden; Bildfehler nicht nachbauen. + +## Späterer komponentenbezogener Umsetzungsauftrag + +Ein konkreter Auftrag sollte mindestens nennen: + +- betroffenen Arbeitsplatz und Nutzeraufgabe; +- ausgewählte Bildreferenz und schriftlich bestätigte Regeln; +- wiederzuverwendende vorhandene Funktionen und Komponenten; +- fachliche Fragen, die für diesen Teil bereits entschieden sein müssen; +- Geltungsbereich der Änderung und ausdrücklich offene Folgeaufgaben; +- relevante UX-Abnahmefälle und reale Testdaten; +- zu prüfende Tastatur-, Leer-, Lade-, Fehler- und Erfolgszustände; +- visuelle Prüfung an der tatsächlichen Anwendung. + +## Verifikation + +Auditbilder belegen ausschließlich die geprüften Zustände vom 19.11.2026. Neue Implementierungen sind erneut in der echten Anwendung zu prüfen. Mockups belegen weder Bedienbarkeit noch korrektes Speichern oder Berechtigungsverhalten. + +Für Auswahl/Zuordnung sind PICK-01 bis PICK-14 in Dokument 03 vorgeschlagene Abnahmefälle. Für den Aufbau sind BUILD-01 bis BUILD-16 in Dokument 06 vorgeschlagene Prüfziele. Für Speichern, Vorschau und Freigabe ergänzt Dokument 07 die vorgeschlagenen Fälle STATE-01 bis STATE-29. Dokument 08 ergänzt SIMPLE-01 bis SIMPLE-11 als vorgeschlagene Ziele für den vereinfachten Alltag; ihre genaue Bedienfolge ist noch abzustimmen. Für die gemeinsame Redaktion ergänzt Dokument 09 RED-01 bis RED-26 als vorgeschlagene Fälle; die gewählte Basis wird in gemeinsamen Registern weiter ausgearbeitet. Für das Gesamtsystem entsteht später eine konsolidierte Abnahmeliste. Es wurden bislang keine aktiven Cursor-Regeln oder Agentenanweisungen im Repository ersetzt. diff --git a/docs/ux/verwaltung/06-aufbau-arbeitsplatz-entwurf.md b/docs/ux/verwaltung/06-aufbau-arbeitsplatz-entwurf.md new file mode 100644 index 0000000..040f362 --- /dev/null +++ b/docs/ux/verwaltung/06-aufbau-arbeitsplatz-entwurf.md @@ -0,0 +1,205 @@ +# Aufbauarbeitsplatz für Module und Programme + +**Status: kombinierte räumliche Grundlage bestätigt.** Stand: 19.11.2026. Arbeitsaufteilung aus Entwurf 2 mit Rahmen und Gruppierung aus Entwurf 1. Detailausgestaltung und Interaktionsregeln bleiben teilweise Entwurf; kein Implementierungsauftrag. + +## Aufgabe + +Eine vorhandene Zusammenstellung überblicken, Bestandteile hinzufügen, eine konkrete Verwendung auswählen, ihre lokalen Angaben bearbeiten und die Reihenfolge ändern. Der Arbeitsplatz nutzt die bestätigte gemeinsame Gestaltungsrichtung und den bereits gewählten Auswahlbaustein. + +Die Beispiele zeigen ein Programm mit Modulen und einem direkten Textbaustein. Das ist keine vorgeschriebene Produkthierarchie: Die bestehenden Kompositionen können Medien und weitere Kompositionen referenzieren. Nicht jeder Objekttyp erhält eine unabhängig entworfene Bearbeitungsoberfläche. + +## Gewählte Kombination + +Der Auftraggeber hat nach der Erklärung der Arbeitsunterschiede die kompakte Struktur links und den größeren Detailbereich rechts aus Entwurf 2 zusammen mit Rahmen und Gruppierung aus Entwurf 1 bestätigt. + +![Kombinierter Aufbauarbeitsplatz](bilder/aufbau-kombiniert-v1.png) + +### Bestätigte räumliche Aufgaben + +| Bereich | Aufgabe | +|---|---| +| Linke Struktur | Geordnete Verwendungen überblicken, aufklappen und zwischen ihnen wechseln | +| Gruppenrahmen | Referenziertes Modul mit eingeblendeten Quelleninhalten zusammenhalten; hierarchische Zugehörigkeit klar zeigen | +| Markierung | Die gerade bearbeitete konkrete Verwendung erkennen lassen | +| Rechter Detailbereich | Lokale Angaben an einem stabilen Ort prüfen und ändern | +| Quellen-/Vorschaubereich | Quelleninformationen und Vorschau gezielt zugänglich machen; lokale Wirkung verständlich abgrenzen | + +Die Gruppierung darf nicht dazu führen, dass alle Kinder als gemeinsam bearbeitet erscheinen. Eine einzelne Verwendung bleibt der eindeutige Bearbeitungsgegenstand. Lange Titel müssen lesbar bleiben; exakte Spaltenbreiten werden an größeren realen Aufbauten geprüft. + +### Beispielhafte Bedienfolge zur weiteren Prüfung + +1. Links die gewünschte Verwendung anklicken. +2. Rechts ihre lokalen Angaben prüfen oder ändern. +3. Links einen weiteren Eintrag öffnen; die bisherige Änderung bleibt im aktuellen Arbeitsstand erhalten. +4. Bei Bedarf eine referenzierte Komposition aufklappen und die Herkunft ihrer Inhalte erkennen. +5. Reihenfolge durch die für den Kontext zulässige Bewegung ändern. + +Die Abbildung zeigt die bestätigte Richtung. Sie gibt nicht automatisch sämtliche Feldwerte, Tabnamen, Speicherabläufe oder Freigabeschritte verbindlich vor. + +## Ergänzung: gemeinsame Redaktion öffnen und zurückkehren + +Dieser Arbeitsplatz ist bereits gestaltet und als räumliche Grundlage gewählt. Er wird nicht wegen des gemeinsamen Redaktionsmanagers neu entworfen. Ergänzt wird ein eindeutiger Einstieg in „Beschreibung und Präsentation bearbeiten“ für das aktuell bearbeitete Programm beziehungsweise Modul. Die genaue Position dieses Einstiegs bleibt Detailausgestaltung. + +Der Einstieg am Objektkopf betrifft die Redaktion dieses Programms oder Moduls. Eine ausdrücklich aufgerufene Quellenredaktion eines ausgewählten Bestandteils muss davon durch ihre Beschriftung und ihren Gegenstand unterscheidbar sein. Die lokalen Rollen und Hinweise einer Verwendung werden nicht versehentlich zu globalen redaktionellen Angaben. + +Der Rückweg nach UX-D23/RED-R12 erhält offene Aufbauänderungen, Reihenfolge, Auswahl und Arbeitsstelle. Die Speicherung der Redaktion darf den Aufbau nicht heimlich sichern oder überschreiben. Ein späteres Speichern des Aufbaus darf aktualisierte Redaktion nicht durch alte Formularwerte ersetzen. Details und Abnahmefälle stehen in [Dokument 09](09-redaktionsarbeitsplatz-entwurf.md). Die vorhandene Abbildung zeigt diesen Einstieg noch nicht vollständig. + +## Frühere Anordnungen und ihre Einordnung + +Die Nummern gehören zum Aufbauvergleich und sind unabhängig von den früheren Angebots- und Auswahlbildern. + +| Nummer | Anordnung | Stärke | Abzuwägende Grenze | +|---|---|---|---| +| 1 | Strukturliste mit Kontexteditor | Aufbau und lokale Bearbeitung nebeneinander; größere Listenfläche | Der feste Kontextbereich begrenzt die Breite langer oder tiefer Strukturen | +| 2 | Kompakte Struktur mit großem Detailbereich | Schneller Wechsel zwischen Verwendungen, viel Raum für die Einzelbearbeitung | Die Strukturspalte muss lange Titel und Verschachtelung gut bewältigen | +| 3 | Direkte Bearbeitung im Aufbau | Änderung geschieht unmittelbar an der betroffenen Stelle | Aufgeklappte Bearbeitung verändert Listenhöhe und kann bei vielen Elementen Scrollwege erzeugen | + +Die früheren Bilder bleiben als Vergleich und Herkunft der Kombination erhalten. Sie haben denselben Beispielinhalt und dieselben Geltungsbereiche. Die Arbeitsaufteilung aus Bild 2 und die Gruppierung aus Bild 1 sind übernommen; Bild 3 wird als Grundanordnung zurückgestellt. Nicht sämtliche Feldbezeichnungen, Metadaten und Freigabeabläufe sind damit entschieden. + +### Entwurf 1 + +![Strukturliste mit Kontexteditor](bilder/aufbau-01-strukturliste-kontext.png) + +### Entwurf 2 + +![Kompakte Struktur mit großem Detailbereich](bilder/aufbau-02-struktur-detailbereich.png) + +### Entwurf 3 + +![Direkte Bearbeitung im Aufbau](bilder/aufbau-03-inline-bearbeitung.png) + +## Einheitliche räumliche Rollen – Detailentwurf + +| Bereich | Inhalt | +|---|---| +| Objektkopf | Programm oder Modul, klarer Arbeitszustand, eine erkennbare Speicherhandlung | +| Bereichsnavigation | Direktzugriff auf Aufbau und weitere Themen; keine Pflichtschrittfolge für nichtlineare Aufbauarbeit | +| Aufbau | Geordnete konkrete Verwendungen mit kleinen Vorschauen, fachlichem Typ und referenzierter Fassung | +| Lokale Bearbeitung | Rolle und gegebenenfalls Hinweis nur für die ausgewählte Verwendung | +| Quelle und Vorschau | Referenziertes Objekt, konkrete Fassung und erkennbare Herkunft; Quellenbearbeitung ausdrücklich getrennt | +| Reihenfolge | Position, Ziehgriff und bedienbare Alternative ohne Ziehen | + +## Was im Beispiel bearbeitet wird + +Das Beispielprogramm „Programm Abstand“ besitzt vier direkte Bestandteile: + +1. Modul Abstand, Fassung 1, an dieser Stelle mit der Rolle „Einstieg“. +2. Modul Hilfe, Fassung 1. +3. Eigene Grenzen erkennen, Fassung 1. +4. Nur ein allgemeiner Hinweis, Text, Fassung 1. + +Beim ersten Modul sind zusätzlich zwei Inhalte aus der Quelle sichtbar: Trainerunterlage Abstand und Lara im Park. **Diese Einblendung dient im gezeigten Programmkontext zur Ansicht.** Eine lokale Änderung der Rolle des Moduls im Programm ändert weder die Modulquelle noch die darin referenzierten Medien. + +Die Beispielwerte und Namen sind Anschauungsmaterial. Insbesondere „Einstieg“ ist keine neue verbindliche Rollenliste. Ein Programm kann dieselbe Quelle an mehreren Stellen referenzieren; eine Darstellung darf solche Vorkommen nicht zusammenfassen oder miteinander verwechseln. + +## Interaktionsregeln – Entwurf + +### AUF-R01 · Bestandteile hinzufügen + +„Bestandteil hinzufügen“ öffnet den gemeinsamen Auswahlbaustein. Der Kontext bestimmt, welche Medien und Kompositionen auswählbar sind. Nach Übernahme sind die neuen Verwendungen im Aufbau erkennbar. Die bestehende fachliche Zulässigkeit, Referenz- und Versionslogik bleibt erhalten. + +Die Einfügeposition muss nachvollziehbar sein, etwa am Ende oder an einer ausdrücklich gewählten Stelle. Auswahlbestätigung darf nicht gleichzeitig unbemerkt bestehende Verwendungen ersetzen oder Quellen kopieren. Die konkrete Einfügebedienung ist weiter abzustimmen. + +### AUF-R02 · Eine Verwendung auswählen + +Ein Klick auf einen Eintrag öffnet dessen lokalen Bearbeitungskontext. Die Markierung bezeichnet die gerade bearbeitete Verwendung. Sie ist keine Checkbox-Auswahl mehrerer Elemente zur Aufnahme in die Zusammenstellung. + +Beim Wechsel zu einem anderen Bestandteil bleiben noch nicht gespeicherte Eingaben innerhalb des aktuellen Arbeitsstands erhalten. Eine Detailansicht oder Vorschau verändert weder Auswahl zur Zuordnung noch fachliche Reihenfolge. + +### AUF-R03 · Quelle und lokale Angaben unterscheiden + +Quellenname und referenzierte Fassung werden lesbar angezeigt. Lokal editierbare Angaben tragen einen eindeutigen Geltungsbereich, im Beispiel „An dieser Stelle im Programm“. + +Die lokale Rolle und der lokale Hinweis sind keine Bearbeitung des globalen Anzeigenamens oder der allgemeinen Beschreibung. Eine Quellenbearbeitung wird ausdrücklich als solche aufgerufen. Auswirkungen, Rückweg und Umgang mit dem aktuellen Arbeitsstand müssen verständlich bleiben. + +Die Abbildung einer Quellenbeschreibung folgt weiterhin den vorhandenen redaktionellen Regeln. Aus dem lokalen Geltungsbereich darf nicht geschlossen werden, dass globale Anzeigedaten niemals andere Ansichten aktualisieren dürfen. + +### AUF-R04 · Reihenfolge ändern + +- Die aktuelle Position ist verständlich erkennbar. +- Ziehen zeigt das betroffene Vorkommen und zulässige Zielpositionen. +- Eine Alternative über Auf-/Ab-Aktionen und Tastatur ermöglicht dieselbe fachlich zulässige Änderung. +- Am Anfang und Ende sind nicht ausführbare Bewegungen eindeutig deaktiviert. +- Nach einer Bewegung bleiben bearbeitete Verwendung und Fokus nachvollziehbar; Position und angezeigte Reihenfolge stimmen überein. +- Das Verschieben eines direkten Bestandteils verschiebt nicht unbemerkt ein Kind aus der referenzierten Quelle. +- Eine reine Umsortierung erzeugt keine Medienkopien und zieht keine Quellen automatisch auf eine neuere Fassung. + +Ob zusätzlich eine gezielte Positionswahl benötigt wird, ist anhand langer realer Zusammenstellungen zu prüfen. Geschäftsregeln und Prüfungen bestehender Fassungen bleiben erhalten. + +### AUF-R05 · Verschachtelte Quellen ansehen + +Ausklappen zeigt den Inhalt der referenzierten Komposition mit klarer Einrückung und Herkunft. Im Beispiel ist der Modulinhalt innerhalb des Programms schreibgeschützt eingeblendet; die Quelle kann über einen ausdrücklichen Absprung bearbeitet werden. + +Es wird keine allgemeine neue Einschränkung eingeführt, wie Quellen künftig überall bearbeitet werden dürfen. Maßgeblich ist, dass die Person den Gegenstand und die Wirkung einer Änderung erkennt. Ein globales Verschieben oder Ändern über Kontextgrenzen hinweg darf nicht als harmlose lokale Aktion erscheinen. + +### AUF-R06 · Entfernen und Ersetzen + +Die Handlung benennt die Zuordnung, beispielsweise „Aus diesem Aufbau entfernen“. Sie ist vom Löschen eines Mediums oder Moduls aus dem Bestand unterscheidbar. + +Bei einem Austausch sind neue Quelle und Fassung sowie betroffene lokale Angaben nachvollziehbar. Die Übernahme oder Rücksetzung lokaler Angaben beim Austausch ist noch nicht fachlich entschieden; der Entwurf schreibt keine verdeckte Regel dafür vor. + +### AUF-R07 · Speichern und Vorschau + +Die Bilder fokussieren die Bearbeitung fachlicher Aufbauangaben. Eine primäre Handlung „Entwurf speichern“ sichert den entsprechenden Arbeitsstand gemäß vorhandener Fachlogik. Sie veröffentlicht oder aktiviert nichts durch ihre Beschriftung allein. + +Die übrigen Bereiche desselben Objekts können anderen Änderungsregeln folgen. Redaktionelle Anzeigedaten dürfen nicht allein wegen dieses Entwurfs eine zusätzliche Inhaltsfassung oder Freigabeschleife erhalten. + +„Vorschau“ muss erkennbar machen, ob sie den aktuellen Bearbeitungsstand oder den zuletzt gespeicherten Stand zeigt. Eine Abweichung vom sichtbaren Aufbau darf nicht ohne Erklärung bleiben. Die vorgeschlagene Vorschauintegration sowie Speicher- und Prüfzustände sind in [Dokument 07](07-speichern-vorschau-freigabe-entwurf.md) ausgearbeitet; sie bleiben zur Abstimmung markiert. + +Ungespeicherte Änderungen müssen eindeutig sichtbar sein. Beim Verlassen des Arbeitskontexts ist ihr Erhalt beziehungsweise ein mögliches Verwerfen verständlich zu behandeln; ein stiller Verlust ist kein zulässiger Normalablauf. Automatische Speicherung ist damit nicht fachlich festgelegt. + +### AUF-R08 · Weitere Informationen zugänglich halten + +Fachlicher Inhaltstyp, technische Medienart, Einordnung, tatsächliche Verwendung sowie Angaben zu Nutzung und Verwertung bleiben unterscheidbar. Die Aufbauzeile zeigt nur das für Reihenfolge und Orientierung Nötige. Weiterführende Informationen werden bei Bedarf im Quellen- oder Detailkontext zugänglich. + +Aus der Zusammenstellung, einer Klassifikation oder einem Vorschaubild entstehen keine zusätzlichen Rechte. Kommerzielle Konfiguration und Shopdarstellung gehören nicht in diesen Aufbauarbeitsplatz. + +## Vorgeschlagene UX-Abnahmefälle + +Die folgenden Fälle sind Prüfziele für eine spätere Implementierung. Die Bilder sind kein Testnachweis. + +| ID | Fall | Erwartete Beobachtung | +|---|---|---| +| BUILD-01 | Mehrere Bestandteile über den gemeinsamen Picker übernehmen | Richtige Referenzen erscheinen an einer nachvollziehbaren Stelle; keine Quellenkopien | +| BUILD-02 | Ein Vorkommen per Ziehen bewegen | Richtige Verwendung und zulässiges Ziel erkennbar; Position wird korrekt aktualisiert | +| BUILD-03 | Dasselbe Vorkommen ohne Ziehen bewegen | Tastatur beziehungsweise Auf-/Ab-Aktion erzielt dieselbe fachliche Reihenfolge | +| BUILD-04 | Ersten oder letzten Bestandteil wählen | Nicht ausführbare Bewegungen sind eindeutig deaktiviert | +| BUILD-05 | Lokale Rolle und Hinweis ändern | Nur die konkrete Verwendung ändert sich; Quelle und andere Verwendungen bleiben unverändert | +| BUILD-06 | Dieselbe Quelle zweimal im Aufbau verwenden | Beide Vorkommen sind unabhängig auswählbar; keine Verwechslung anhand gleichen Titels | +| BUILD-07 | Referenziertes Modul im Programm ausklappen | Herkunft, referenzierte Fassung und Geltungsbereich der Ansicht sind erkennbar | +| BUILD-08 | Quellenbearbeitung aus dem Programm öffnen | Ausdrücklicher Kontextwechsel mit nachvollziehbarem Rückweg und Umgang mit ungespeicherten Eingaben | +| BUILD-09 | Verwendung entfernen | Nur die gemeinte Zuordnung wird entfernt; das Quellobjekt bleibt im Bestand | +| BUILD-10 | Bestandteil durch andere Quelle ersetzen | Neue Referenz und Wirkung auf lokale Angaben werden nachvollziehbar; keine stille Versionsaktualisierung | +| BUILD-11 | Zwischen mehreren Bestandteilen wechseln | Lokale Eingaben bleiben im aktuellen Arbeitsstand erhalten; Auswahl und Bearbeitungskontext stimmen überein | +| BUILD-12 | Entwurf speichern | Verständliche Rückmeldung zum gespeicherten Aufbau, keine ungewollte Veröffentlichung | +| BUILD-13 | Vorschau öffnen | Dargestellter Datenstand ist benannt; fehlende oder nicht nutzbare Teile werden nachvollziehbar behandelt | +| BUILD-14 | Lange Titel, viele Bestandteile und tiefere Quellen prüfen | Hierarchie, Auswahl, Referenz und Aktionen bleiben nutzbar; keine dauerhafte horizontale Suche nach Kernaktionen | +| BUILD-15 | Früheren freigegebenen Stand ansehen | Vorhandene Versionsregeln und referenzierte Quellen bleiben erhalten | +| BUILD-16 | Nur per Tastatur bearbeiten und umordnen | Sichtbarer Fokus, erreichbare Aktionen und nachvollziehbarer Zustand nach jeder Bewegung | + +## Noch abzustimmen + +- Feinschliff der gewählten Kombination: lesbare Titel, Spaltenbreiten und kompakte Gruppenrahmen. +- Welche Quellinformationen sind direkt neben den lokalen Angaben nötig? +- Wie tief werden referenzierte Inhalte im Alltag aufgeklappt? +- Welche Einfüge- und Austauschbedienung ist für lange Aufbauten sinnvoll? +- Wie werden Quellenbearbeitung, Rückweg und nicht gespeicherter Arbeitsstand zusammengeführt? +- Den weiterführenden Entwurf zu Speicher-, Prüf- und Vorschauzuständen in [Dokument 07](07-speichern-vorschau-freigabe-entwurf.md) abstimmen. + +## Grenzen und sichtbare Bildkorrekturen + +- Im ersten Bild ist der grüne Punkt vor „Änderungen noch nicht gespeichert“ unpassend. Die Aussage muss neutral oder als offener Arbeitszustand gekennzeichnet sein; Grün darf keine erfolgreiche Speicherung vortäuschen. +- Im ersten Bild besitzen die Zeilen mehr Rahmen und Abstand als ursprünglich beabsichtigt. Dichte und Trennung sind an größeren Beständen zu prüfen. +- Im dritten Bild werden Auf-/Ab-Aktionen an mehreren Zeilen gleichzeitig gezeigt. Das ist eine offene Dichteentscheidung; die gemeinsame Regel verlangt bedienbare Alternativen, nicht zwingend diese dauerhafte Wiederholung. +- Schreibweisen, Rollenwerte und kleine Typbilder sind Beispiele. Diese Bilder definieren keine Rollenliste, keine neue Inhaltsart und keine neue verbindliche Struktur. +- Markierungen belegen keine tatsächlich implementierte Fokusführung oder korrekte Bedienung mit assistiven Technologien. +- Der Entwurf behandelt die Strukturarbeitsfläche. Eine vollständige Programm-/Modulverwaltung mit allen Angaben und Veröffentlichungsvorgängen ist damit noch nicht gestaltet. + +## Herkunft und Bezug + +- [Gewählte Gestaltungsrichtung](02-designentscheidungen.md) +- [Gemeinsame Auswahl und Zuordnung](03-auswahl-und-zuordnung-entwurf.md) +- [Fachliche Anforderungen und offene Fragen](04-fachliche-anforderungen.md) +- [Vorhandenes Fachkonzept: Produktkonfiguration und Mitgliederbereich](../../fachkonzept/produktkonfiguration-und-mitgliederbereich.md) +- [Prompts der ursprünglichen Vergleiche](generierung/aufbau-prompts.md) +- [Prompt der kombinierten Konkretisierung](generierung/aufbau-kombination.md) diff --git a/docs/ux/verwaltung/07-speichern-vorschau-freigabe-entwurf.md b/docs/ux/verwaltung/07-speichern-vorschau-freigabe-entwurf.md new file mode 100644 index 0000000..9166441 --- /dev/null +++ b/docs/ux/verwaltung/07-speichern-vorschau-freigabe-entwurf.md @@ -0,0 +1,236 @@ +# Speichern, Vorschau und Freigabe + +**Status: UX-Entwurf zur gemeinsamen Abstimmung.** Stand: 19.11.2026. Fortführung des bestätigten Aufbauarbeitsplatzes UX-D15. Die nachfolgenden Regeln sind vorgeschlagen; daraus entstehen weder neue fachliche Lebenszyklen noch ein Implementierungsauftrag. + +**Einordnung nach der Vereinfachungsanforderung:** [Dokument 08](08-einfacher-redaktionsalltag-entwurf.md) ist der Ausgangspunkt für die nächste Bedienabstimmung. Die hier aufgeführten fachlichen Ebenen sind Analyse und Bestandserfassung. Sie sind keine sieben manuellen Freigabestationen. Die konkreten Bedienvorschläge und STATE-Prüffälle sind im Licht von UX-D16/17 und OFF-16 erneut zu prüfen; insbesondere die Bündelung oder der Entfall manueller Handlungen ist offen. + +## Die drei Fragen des Arbeitsplatzes + +1. **Ist meine Arbeit gespeichert?** Rückmeldung zum aktuellen Eingabestand und seinem Speicherumfang. +2. **Welchen Gegenstand bearbeite oder prüfe ich?** Identität, Fassung beziehungsweise Revision und zugehöriger fachlicher Zustand. +3. **Was ist für wen bereits verfügbar?** Tatsächliche Wirkung im jeweiligen Ausgabe- oder Nutzungskontext. + +Diese Antworten gehören zusammen, werden aber nicht zu einem einzigen Status „Aktiv“ zusammengezogen. „Gespeichert“ beschreibt keine fachliche Freigabe. „Bereit“ bedeutet keine Veröffentlichung. Ein veröffentlichtes Angebot und die Website-Erlaubnis für ein Medium sind unterschiedliche Gegenstände. + +## Dokumentierte Freigabewege und ihre Abhängigkeiten + +Die fachlichen Quellen unterscheiden mehrere Freigaben mit eigenen Gegenständen und Wirkungen. Die technische Bereitschaft, die Anzeigefreigabe einer Struktur, die kommerzielle Veröffentlichung und die öffentliche Darstellung bilden keine allgemeine Schrittfolge für jedes Objekt. + +| Ebene | Gegenstand und Wirkung | Dokumentationsstatus und Quelle | +|---|---|---| +| Technische Bereitschaft | Konkrete Inhalts- oder Kompositionsfassung ist vollständig, unveränderlich und nicht gesperrt. Sie wird dadurch noch nicht in einer Mitglieder- oder öffentlichen Strukturansicht sichtbar | Bestehendes Modell; Domänenmodell §2, Versionierung §2, Bibliotheksentscheidung E-A | +| Anzeigefreigabe G2 | Genau eine Kompositionsfassung wird redaktionell zur Anzeige freigegeben. Sie kann unter den Bibliotheksregeln als Struktur erscheinen. Sie erzeugt keinen Artikel und keine Dateiabrufrechte | E-A und Vertrag G2; im MVP-Abschlussbericht vom 16.11.2026 als umgesetzt dokumentiert. Keine neue aktuelle Instanzprüfung in diesem Abgleich | +| Öffentliche Listung | Zusätzliche Entscheidung an einer Fachidentität mit einer ausdrücklich gezeigten Fassung. Im Zielkonzept ist die Anzeigefreigabe Voraussetzung; die Listung macht keine Datei zugänglich | Öffentliche Profile nach ADR-29 und Website-Zielarchitektur §6.2 sind Architekturentwurf; laut ADR-41 vom 19.11.2026 nicht entschieden und nicht als allgemeine Katalogintegration nachgewiesen | +| Kommerzielle Veröffentlichung | Ein Artikel-Stand fixiert die konkrete Inhalts-/Kompositionsfassung und wird nach vorhandener Prüfung veröffentlicht. Die tatsächliche Nutzung eines Blatts benötigt zusätzlich eine passende Berechtigung und erneute Zugriffsentscheidung | Versionierung §§2–5, Domänenmodell §3 und E-A. Strukturfreigabe und Artikel-Stand sind unabhängig zu verwalten | +| Angebotsaktivierung | Eine Angebotsfassung legt die kommerziellen Konditionen und den aufgelösten Umfang fest. Artikel im aktiven Umfang benötigen veröffentlichte Stände. Ein Vorgang kann zusammengehörige Änderungen koordinieren | Bestand und MVP-Abschlussbericht Paket 1; die im Designgespräch wieder geöffneten Angebotsfragen OFF-01 bis OFF-08 bleiben offen | +| CMS-Veröffentlichung | Die konkrete Seitenrevision wird öffentlich. Referenzierte Fachobjekte und Medien folgen weiterhin ihren eigenen Ausgabe- und Freigaberegeln | Versionierung §9; Seitenrevisionen sind nicht Teil des Veröffentlichungsvorgangs für Lernprodukte | +| Website-Medienfreigabe | Eine dafür geeignete Ableitung eines Mediums darf öffentlich ausgegeben werden. Das ersetzt weder die Anzeigefreigabe einer Komposition noch einen Mitglieder-Dateizugriff | ADR-40/41 und Medienzugriff für Komponenten; als eigener Weg auf der Testinstanz dokumentiert | + +### Die Beziehungen + +```mermaid +flowchart TB + K["Bereite Kompositionsfassung"] --> A["Anzeigefreigabe dieser Fassung · G2"] + A --> B["Struktur in der Mitgliederbibliothek · nach Bibliotheksregeln"] + A --> L["Öffentliche Listung mit gezeigter Fassung · Zielkonzept ADR-29"] + K --> R["Artikel-Stand · eigene Prüfung und Veröffentlichung"] + R --> O["Artikel im Umfang einer aktiven Angebotsfassung"] + R --> N["Dateinutzung · passende Berechtigung und erneute Zugriffsprüfung"] + C["CMS-Seitenrevision"] --> W["Seite veröffentlicht"] + M["Geeignete Medienableitung"] --> F["Website-Medienfreigabe"] +``` + +Die Pfeile zeigen ausgewählte Voraussetzungen und Verwendungsbeziehungen. Sie behaupten weder automatische Folgeschritte noch eine vollständige Darstellung sämtlicher Berechtigungsregeln. Die öffentliche Listung bleibt als Zielkonzept gekennzeichnet. Ein Angebot ist keine Voraussetzung für bereits bestehende Berechtigungen aus anderen Erwerbsquellen. + +### Hierarchie innerhalb einer freigegebenen Struktur + +- Eine zur Anzeige freigegebene Programmfassung zeigt ihre enthaltenen Module an der fixierten Position mit der fixierten Kindesfassung. Für diese Darstellung als Bestandteil braucht nicht jedes Modul eine zusätzliche eigene Anzeigefreigabe. +- Eine **eigenständige Modulansicht** benötigt eine eigene Anzeigefreigabe der betreffenden Modulfassung. Eine eigene öffentliche Modulseite benötigt nach dem Zielkonzept zusätzlich ihre eigene Listung. +- Eine öffentliche Verlinkung von Programm zu Modul ist im Zielkonzept nur vorgesehen, wenn die eigenständige Modulseite dieselbe Kindesfassung zeigt. Andernfalls bleibt die Strukturzeile ohne Link und die Redaktion erhält einen Befund. +- Eine neuere bereite oder zur Anzeige freigegebene Fassung ersetzt nicht verdeckt die fixierten Kindesfassungen eines bestehenden Programm- oder Artikel-Stands. Ansichten mischen keine Fassungen. + +### Welche Fassung eine öffentliche Darstellung zeigen würde + +Das Zielkonzept unterscheidet ausdrücklich zwei Fälle. Hat ein Programm einen führenden Lizenzartikel als Wurzel, kann die öffentliche Darstellung dessen aktuellem Stand folgen, übernimmt aber nur eine zur Anzeige freigegebene Fassung. Sonst bleibt die bisher gezeigte Fassung mit Befund. Wird das Programm durch mehrere selbstständige Modul-Artikel abgedeckt oder noch gar nicht verkauft, bestätigt die Redaktion eine feste gezeigte Fassung. Die Abdeckung eines Angebots wird gegen genau diese Fassung geprüft. Diese Profilregeln sind **Zielkonzept, keine neue Designentscheidung**. + +Heute bestehen laut Medienzugriffs- und ADR-Dokumentation Übergangsregeln in den öffentlichen Lesesichten. Diese dürfen nicht als bereits umgesetztes allgemeines Profilsystem beschrieben werden. Die auf der Website gezeigte Seite, die dort genannte Struktur und die öffentlich ausgelieferten Bild-/Teaserdateien können daher unterschiedlichen Freigaben unterliegen. + +## Folgen für den vorgeschlagenen Arbeitsplatz + +Die Aussagen zu Speicherung, fachlichem Zustand und Verfügbarkeit bleiben Orientierungsfragen. Die Anzeige beantwortet die dritte Frage konkret: **Struktur zur Anzeige freigegeben? Öffentlich gelistet? Artikel-Stand veröffentlicht? Website-Medium freigegeben?** Je nach Gegenstand erscheinen nur die passenden Informationen und Aktionen. + +Eine Kompositionsfassung braucht einen zugänglichen Bereich für die **Anzeigefreigabe dieser Fassung**. Dieser darf nicht hinter der Veröffentlichung eines Lizenzartikels verschwinden. Ob er als eigener Bereich oder im vorgeschlagenen Prüfbereich liegt, wird noch visuell abgestimmt. Fachliche Kompatibilitätsbestätigung und Anzeigefreigabe bleiben unterscheidbare Handlungen. + +Die Bearbeitung eines Aufbaus, seine redaktionelle Vorschau und seine spätere Anzeigefreigabe müssen ohne erzwungenes Anlegen eines Lizenzartikels möglich bleiben. Eine Vorschau der Mitgliederstruktur benennt, ob sie nur redaktionell geprüft wird oder tatsächlich für Mitglieder zur Anzeige freigegeben ist. Nutzbare Dateien werden zusätzlich nach den vorhandenen Zugriffsregeln behandelt. + +Die Abbildung unten zeigt ausschließlich die Entwurfsbearbeitung. Sie ist keine vollständige Darstellung der benötigten Freigabebereiche. Das vorgeschlagene Register „Prüfung“ und seine Belegung sind angesichts dieser Ebenen weiter abzustimmen. + +## Visuelle Fortführung + +![Aufbau mit eindeutigem Arbeitszustand](bilder/aufbau-zustaende-v1.png) + +Der Objektkopf benennt Aufbau, Fassung und Entwurf. Darunter steht die Speicherrückmeldung. „Entwurf speichern“ sichert den Aufbau einschließlich lokaler Rollen und Hinweise. Eine zweite Speicherung pro ausgewähltem Bestandteil entfällt. Die Quellenfassung im Detailbereich bleibt eigenständig benannt. + +Die Meldung „Bereits verfügbare Artikelstände bleiben unverändert“ gilt für die gezeigte Bearbeitung des **fachlichen Aufbaus**. Sie darf nicht pauschal auch bei direkt wirksamen Anzeigedaten erscheinen. Die zusätzliche Bereichsnavigation „Prüfung“ ist ein Vorschlag; sie ist kein weiterer Pflichtschritt beim Speichern. + +Die Referenz zeigt einen ungespeicherten Bearbeitungszustand. Lade-, Fehler-, Vorschau- und Freigabeansichten werden durch die folgenden Regeln beschrieben und sind noch nicht als vollständige visuelle Referenzserie ausgearbeitet. Namen und Fassungsnummern sind Beispieldaten. + +## ZUST-R01 · Zustände am richtigen Gegenstand anzeigen + +| Ebene | Typische Aussage | Ort und Bedeutung | +|---|---|---| +| Eingaben | Änderungen nicht gespeichert / Wird gespeichert / Gespeichert / Speichern fehlgeschlagen | Beständig im Objektkopf des betroffenen Arbeitsbereichs; nach Erfolg gegebenenfalls mit Uhrzeit | +| Inhalts- oder Kompositionsfassung | Entwurf / Verarbeitung / Bereit / Gesperrt, soweit der jeweilige Typ diese Zustände besitzt | Bei genau dieser Fassung; kein generischer Statusautomat für alle Objekttypen | +| Anzeigefreigabe der Struktur | Zur Anzeige freigegeben / Nicht zur Anzeige freigegeben | An genau dieser Kompositionsfassung; getrennt von Bereitschaft und Artikel-Stand | +| Öffentliche Listung | Gelistet / Verborgen, mit gezeigter Fassung | An der Fachidentität im Zielkonzept ADR-29; aktuelle Übergangsregeln und offenen Entscheidungsstatus benennen | +| Artikel-Stand | Entwurf / In Prüfung / Freigegeben / Veröffentlicht / Abgelöst / Zurückgezogen | Am Artikel-Stand beziehungsweise seinem Veröffentlichungsvorgang; keine Übertragung auf die Kompositionsidentität | +| CMS-Seite | Entwurf / veröffentlichte Revision; optional redaktionelle Freigabe | Im Seitenarbeitsplatz; Entwurf und tatsächlich öffentliche Revision bleiben unterscheidbar | +| Öffentliche Mediennutzung | Für Website freigegeben beziehungsweise nicht freigegeben | Am konkreten Medium und Nutzungskontext; aus einer Inhaltsprüfung ergibt sich keine Website-Erlaubnis | + +Nicht jeder Bildschirm zeigt sämtliche Ebenen. Beim Aufbau werden Bereitschaft und Anzeigefreigabe der eigenen Fassung unterschieden; veröffentlichte Artikel-Verwendungen und eine öffentliche Darstellung sind gesondert erreichbar, soweit vorhanden. Eine Übersicht „Veröffentlicht in …“ muss konkrete Artikelstände nennen. Aus einer neuen Kompositionsfassung folgt kein automatischer Austausch in bestehenden Verwendungen. + +Status ist lesbarer Text mit gegebenenfalls unterstützendem Symbol. Farbe ergänzt die Aussage. Grün darf keine noch ausstehende Speicherung oder lediglich angeklickte Auswahl als Erfolg darstellen. Erwartbare Zustände und Rückmeldungen bleiben auch ohne kurzlebige Meldungsfenster zugänglich. + +## ZUST-R02 · Speicherumfang und Wirkung benennen + +| Arbeitsbereich | Vorgeschlagene Handlung | Wirkung und Rückmeldung | +|---|---|---| +| Aktuelle Anzeigedaten, Klasse A | Angaben speichern | Speichert die aktuellen Objektangaben; verwendende Ansichten können sie unmittelbar übernehmen. Keine neue Inhaltsfassung oder allgemeine Freigabeschleife | +| Lehrinhalt oder Aufbau, Klasse B | Entwurf speichern | Sichert den bearbeitbaren Arbeitsstand gemäß bestehender Fassungslogik; macht ihn weder bereit noch veröffentlicht | +| CMS-Seite | Entwurf speichern | Sichert die Seitenrevision. Die bestehende öffentliche Revision bleibt bis zur ausdrücklichen Veröffentlichung bestehen | +| Kommerzielle Angaben, Klasse C | Kontextabhängig, noch fachlich abzugleichen | Vorhandene Historienintegrität bleibt erhalten; OFF-02 und OFF-03 werden durch dieses UX-Muster nicht geschlossen | + +Der Kopf und gegebenenfalls ein kurzer Wirkungshinweis benennen den Speicherumfang. „Entwurf speichern“ im Aufbau darf nicht verdeckt zusätzlich geänderte Klasse-A-Beschreibungen öffentlich wirksam machen. Werden mehrere Bereiche gemeinsam gespeichert, müssen Umfang und unterschiedliche Wirkungen **vorher** verständlich sein. Als Grundmuster wird ein klar abgegrenzter Speicherumfang je Arbeitsbereich vorgeschlagen; ein allgemeines „Alles speichern“ ist nicht beschlossen. + +Beim Wechsel zwischen Bestandteilen oder Bereichen bleiben Eingaben im laufenden Arbeitskontext erhalten. Noch ungespeicherte Bereiche sind erkennbar. Die Oberfläche darf dafür keine Speicherung einzelner Rollen oder Hinweise erzwingen. Technische Persistenz über Neuladen oder Sitzungsausfall hinaus wird ohne tatsächlich vorhandene Wiederherstellung nicht zugesichert. + +## ZUST-R03 · Speichern ist eine nachvollziehbare Handlung + +| Auslöser oder Zustand | Verhalten | +|---|---| +| Erste wirksame Eingabe | „Änderungen nicht gespeichert“ anzeigen; reine Auswahl, Aufklappen und Vorschau gelten nicht als Änderung | +| Speichern ausgelöst | „Wird gespeichert …“; wiederholte Auslösung derselben Operation verhindern | +| Speicherung bestätigt | „Gespeichert“ mit passendem Umfang; nur der bestätigte Eingabestand gilt als gesichert | +| Während des Speicherns weiter geändert | Neuere Eingaben bleiben als ungespeichert erkennbar; eine verspätete Erfolgsantwort darf sie nicht als gespeichert ausweisen | +| Validierung fehlgeschlagen | Eingaben erhalten; konkrete Fehler am Feld beziehungsweise Bestandteil und eine erreichbare Zusammenfassung anzeigen | +| Verbindung oder Serverfehler | „Speichern fehlgeschlagen – Änderungen sind noch nicht gespeichert“; erneuter Versuch am selben Arbeitsplatz | +| Arbeitsstand zwischenzeitlich anderweitig geändert | Konflikt erklären und Vergleich beziehungsweise Wiederaufnahme ermöglichen; nicht still überschreiben. Auch eine Person kann mehrere Fenster verwenden | + +Eine vollständige Speicherung ist nur bei tatsächlich vollständigem Erfolg zu melden. Gibt es mehrere getrennte Speicheroperationen und einen Teilfehler, werden gesicherte und ungesicherte Teile benannt. Detailansicht, Reihenfolge und Auswahlkontext bleiben nach der Rückmeldung bestehen. + +Beim Verlassen eines Arbeitskontexts mit offenen Eingaben wird deren Verlust verständlich abgefangen. Innerhalb kontrollierbarer Navigation: „Änderungen speichern und weiter“, „Änderungen verwerfen“ und „Weiter bearbeiten“. Die erste Handlung muss denselben Wirkungshinweis wie das normale Speichern haben. Bei Tab-Schließen oder Neuladen ist gegebenenfalls nur die Warnung des Browsers möglich; kein eigener Dialog wird dort zugesichert. Automatische Speicherung ist mit diesem Entwurf nicht eingeführt. + +## ZUST-R04 · Vorschau zeigt einen ausdrücklich benannten Datenstand + +Bevorzugtes Verhalten: „Aufbau-Vorschau“ zeigt den aktuellen Arbeitsstand einschließlich offener Eingaben, ohne ihn dauerhaft zu speichern oder einen fachlichen Zustand zu wechseln. Die Vorschau trägt dann sichtbar „Aktueller Arbeitsstand · Nicht gespeichert“. Die konkrete technische Machbarkeit ist vor Implementierung zu prüfen. + +Falls die Vorschau nur gespeicherte Daten darstellen kann, muss die Oberfläche dies **vor dem Öffnen** erklären. Einmalige Auswahl: „Speichern und Vorschau öffnen“, „Gespeicherten Stand ansehen“ oder zurück zur Bearbeitung. Keine automatische Veröffentlichung. Bei Klasse A ist die direkte Wirkung einer zum Vorschauzweck angebotenen Speicherung mitzubenennen; eine isolierte Vorschau darf dort nicht eine Wirkungslosigkeit vortäuschen. + +| Vorschauart | Muss erkennbar sein | +|---|---| +| Aufbau-Vorschau | Welcher Programm-/Modulaufbau und welche Fassung; aktueller Arbeitsstand oder gespeicherte Fassung | +| Inhaltsvorschau einer Verwendung | Welche konkrete Quelle und Fassung; ob lokale Rolle und Hinweis dargestellt werden | +| CMS-Entwurf | Welche Seitenrevision im echten Layout und in welcher Breite; eingebettete Kataloginhalte folgen ihren tatsächlichen Auflösungsregeln | +| Veröffentlichte Ansicht | Welche tatsächlich öffentliche Revision beziehungsweise welcher verfügbare Artikel-Stand; kein Entwurf als bereits verfügbar ausgegeben | +| Präsentationsvorschau | Welche Ausgabe, etwa Kachel oder Detailseite, und welche Textquelle oder eigene Abweichung | + +Eine offene Vorschau bezeichnet ihren Stand beim Öffnen. Spätere Änderungen im Editor führen zu einem sichtbaren Hinweis „Vorschau nicht aktuell“ und einer Handlung „Aktualisieren“, sofern sie nicht nachweisbar live übernommen werden. Rückkehr erhält Eingaben, Auswahl und Arbeitskontext. + +Fehlende, gesperrte, nicht verarbeitete oder nicht für die gewählte Ausgabe erlaubte Inhalte verschwinden in der Verwaltungsvorschau nicht kommentarlos. Die Prüfansicht nennt den Grund und den betroffenen Bestandteil. Eine wirklichkeitsgetreue öffentliche Vorschau darf das tatsächliche Ausblenden zeigen, ergänzt durch einen getrennten Redaktionshinweis. Interne Vorschau und veröffentlichbare Medienfreigabe sind keine gegenseitigen Zugriffserlaubnisse. + +## ZUST-R05 · Fachliche Prüfung bleibt ein eigener Arbeitsplatz + +„Prüfung“ ist direkt erreichbar. Das bloße Öffnen verändert keinen Status. Der Prüfbereich kann ungespeicherte Änderungen anzeigen; eine verbindliche Bestätigung muss sich jedoch auf einen eindeutig gesicherten und prüfbaren Gegenstand beziehen. Vor einer solchen Handlung wird nötiges Speichern ausdrücklich angeboten. Der Rückweg führt zur betroffenen Stelle statt an den Beginn eines langen Formulars. + +Für eine Komposition zeigt der Prüfbereich die vorhandenen fachlichen Anforderungen: konkrete Mitgliedsfassungen, Änderungen gegenüber der letzten Bestätigung, die aufgelösten verschachtelten Inhalte samt Weg, notwendige Einzelbestätigungen und Prüfnotiz. Ein allgemeines Häkchen „Alles geprüft“ ersetzt diese Vorgaben nicht. Automatische technische Prüfungen und menschliche fachliche Bestätigung sind getrennt benannt. + +Ergebnisse unterscheiden „Blockiert“, „Hinweis“ und „Erfüllt“ mit konkretem Grund und nächster Handlung. Eine fehlende Medienableitung bekommt beispielsweise „Verarbeitung ansehen“, ein unklarer inhaltlicher Zusammenhang „Kompatibilität prüfen“. Nicht anwendbare Freigabehandlungen werden mit Begründung erklärt; sie dürfen nicht wie eine ausgeführte Aktion aussehen. + +„Bereit“ an einer Inhaltsfassung bedeutet gemäß Bestand: abgeschlossen, unveränderlich und technisch auslieferbar. Die genaue Abschlussaktion und die Zustandsbezeichnungen für Kompositionsfassungen sind am bestehenden Typ abzugleichen. Die Oberfläche führt dafür keinen universellen neuen Zustand ein. Spätere Änderungen nach einer Bestätigung sind nach vorhandener Logik neu zu prüfen; eine Bestätigung darf nicht unbemerkt auf eine andere Mitgliedermenge übertragen werden. + +## ZUST-R06 · Kommerzielle Veröffentlichung benennt Umfang, Zeitpunkt und Wirkung + +Die Veröffentlichung von Lernprodukten findet am vorhandenen Artikel-Stand beziehungsweise Veröffentlichungsvorgang statt. Der Kompositionseditor besitzt daneben den eigenen Weg zur Anzeigefreigabe seiner Fassung. Ein universeller Knopf „Programm veröffentlichen“ darf diese unterschiedlichen Wirkungen nicht vermischen. + +| Station im vorhandenen Veröffentlichungsvorgang | Inhalt des Arbeitsplatzes | +|---|---| +| Vorbereitung | Zugeordnete Artikelstände und weitere betroffene Gegenstände; gespeicherte und noch offene Bestandteile | +| Prüfungen und Auswirkungen | Automatische Prüfungen, fachliche Bestätigungen, Versionsbezüge, betroffene Angebote und Seiten, Folgen für bestehende Berechtigungen nach vorhandenen Regeln | +| Fachliche Freigabe | Explizite protokollierte Handlung am benannten Umfang; offene Pflichtpunkte sind erreichbar | +| Veröffentlichung | Zusammenfassung des freigegebenen Umfangs, Zeitpunkt, Umgang mit bisherigen Ständen und konkrete Auslösehandlung | +| Ergebnis | Tatsächlich umgeschaltete Gegenstände und Zeitpunkt oder konkreter Fehler; öffentliches Ergebnis beziehungsweise verfügbare Stände erreichbar | + +Diese Stationen gliedern den schon dokumentierten Vorgang; sie sind kein neu beschlossener Angebotsprozess. Bearbeitbare Vorbereitungsbereiche bleiben direkt anklickbar. Dieselbe Person darf die vorhandenen getrennten Prüf- und Freigabehandlungen ausführen. Ein zusätzliches Vier-Augen-Prinzip entsteht durch die Gestaltung nicht. + +Wird zeitgesteuert veröffentlicht, bezeichnet „Geplant“ die Terminierung des Vorgangs und keine bereits erfolgte Veröffentlichung. Die erneuten Prüfungen zur Umschaltung bleiben erhalten. Ein fehlgeschlagener Vorgang zeigt seinen tatsächlichen Zustand und den nächsten möglichen Schritt. Die dokumentierte atomare Umschaltung bleibt Grundlage: kein Erfolg bei nur teilweise gewechseltem Inhalt. Fehler nachgelagerter Benachrichtigungen sind getrennt vom Erfolg der Veröffentlichung anzuzeigen. + +Die Freigabe einer Website-Mediendatei bleibt ebenfalls getrennt. Ein neues Bild aus dem CMS-Upload wird nach dem dokumentierten `WebsiteIntake`-Weg nach erfolgreicher Ableitung automatisch für die Website freigegeben; eine eigenständig angelegte Präsentationsdatei erhält diese Freigabe nicht automatisch. Das ist keine Veröffentlichung der verwendenden Seitenrevision. Auswahl, Upload-Verarbeitung und Freigabestatus sind deshalb beim Einfügen erkennbar zu machen. + +Für CMS-Seiten bleibt der kürzere Ablauf erhalten: Entwurf sichern, aktuelle Revision prüfen, ausdrücklich veröffentlichen. Eine optionale Seitenfreigabe wird nur angezeigt, wenn sie eingerichtet ist. CMS-Revisionen werden nicht in die formale Lernproduktfreigabe hineingezwungen. + +## ZUST-R07 · Nach der Wirkung ist der tatsächliche Zustand sichtbar + +Nach erfolgreicher Veröffentlichung steht nicht nur „Erfolgreich“, sondern beispielsweise „Revision … veröffentlicht“ oder „Artikel-Stand … veröffentlicht“, mit dem konkreten Zeitpunkt. Die verfügbare Ausgabe lässt sich öffnen. Ein alter weiter verfügbarer Stand ist vom aktuellen Stand unterscheidbar. + +Sperren und Rückzug sind deutlich benannte eigene Handlungen mit Auswirkungsinformation und den vorhandenen Begründungspflichten. „Rückgängig“ wird nur angeboten, wenn seine konkrete fachliche Wirkung stimmt. Das Wiederherstellen einer CMS-Revision, eine neue Inhaltsfassung und der Rückzug eines Artikel-Stands sind keine austauschbaren Rückgängig-Aktionen. + +## Vorgeschlagene UX-Abnahmefälle + +Diese Fälle dienen späterer Überprüfung. Es wurden keine schreibenden Abläufe in der Testinstanz oder Anwendungstests dafür ausgeführt. + +| ID | Prüffall | Erwartetes Ergebnis | +|---|---|---| +| STATE-01 | Rolle oder Reihenfolge im Aufbau ändern | Ungespeicherter Zustand; klare Benennung von Fassung und Speicherumfang | +| STATE-02 | Nur Eintrag auswählen oder Quelle aufklappen | Kein falscher Änderungs- oder Erfolgsstatus | +| STATE-03 | Zwischen Verwendungen und Bereichen wechseln | Eingaben und zugehörige Änderungsmarkierungen bleiben im laufenden Arbeitskontext erhalten | +| STATE-04 | Aufbau speichern | Lokale Angaben werden im benannten Umfang gesichert; keine unerwartete Veröffentlichung | +| STATE-05 | Direkt wirksame Beschreibung speichern | Wirkung auf verwendende Ansichten erkennbar; keine zusätzliche Inhaltsfreigabe oder historische Umbenennung von Käufen | +| STATE-06 | Während laufender Speicherung weiter schreiben | Bestätigung sichert nur den tatsächlich übermittelten Stand; spätere Eingaben bleiben offen | +| STATE-07 | Validierung, Verbindungsfehler oder Teilfehler erzeugen | Eingaben erhalten; Fehler und gesicherter Umfang stimmen mit dem tatsächlichen Ergebnis überein | +| STATE-08 | Zweites Fenster ändert denselben Stand | Keine stille Überschreibung; nachvollziehbarer Konfliktweg | +| STATE-09 | Mit offenen Eingaben Arbeitskontext verlassen | Verlustwarnung mit passendem Speicherumfang; Browsergrenzen werden berücksichtigt | +| STATE-10 | Vorschau bei offenen Eingaben öffnen | Gezeigter Datenstand ausdrücklich benannt; keine stille Speicherung oder Wirkung | +| STATE-11 | Nur gespeicherte Vorschau technisch möglich | Wahl und Folgen vor dem Öffnen verständlich; Rückkehr ohne Eingabeverlust | +| STATE-12 | Nach geöffneter Vorschau weiter ändern | Aktualität nachvollziehbar; gezieltes Aktualisieren oder tatsächlich nachvollziehbare Live-Übernahme | +| STATE-13 | Fehlende oder nicht erlaubte Bestandteile in Vorschau | Grund und Quelle sichtbar; keine unbemerkte Differenz wie beim Auditfall sechs gegenüber drei Bestandteilen | +| STATE-14 | Aufbau-, Inhalts-, CMS- und Präsentationsvorschau aufrufen | Gegenstand, Fassung/Revision, Ausgabe und Geltungsbereich unterscheidbar | +| STATE-15 | Fachliche Prüfung öffnen | Kein Statuswechsel durch bloße Navigation; direkte Korrektur und Rückkehr möglich | +| STATE-16 | Verschachtelte Komposition bestätigen | Genaue Mitgliedermenge, Wege, erforderliche Einzelbestätigungen und Prüfnotiz gemäß vorhandener Fachlogik | +| STATE-17 | Bereite Fassung beziehungsweise freigegebenen Artikel-Stand ansehen | Noch fehlende Veröffentlichung erkennbar; keine falsche Verfügbarkeitsaussage | +| STATE-18 | Als Einzelperson prüfen und freigeben | Vorhandene getrennte Handlungen nutzbar; kein unbegründet erzwungener zweiter Bearbeiter | +| STATE-19 | CMS-Seitenentwurf veröffentlichen | Kurzer CMS-Ablauf mit tatsächlicher öffentlicher Revision; optionale Freigabe nur bei Einrichtung | +| STATE-20 | Veröffentlichung auslösen oder terminieren | Gegenstände, Auswirkungen und Zeitpunkt eindeutig; geplant und veröffentlicht unterscheidbar | +| STATE-21 | Prüfung bei Umschaltung scheitert | Kein falscher Veröffentlichungserfolg; alter Stand gemäß vorhandener Transaktionslogik erhalten | +| STATE-22 | Veröffentlichung erfolgreich, Benachrichtigung fehlerhaft | Veröffentlichungsergebnis und nachgelagerte Betreiberaufgabe getrennt sichtbar | +| STATE-23 | Rückzug oder Wiederherstellung aufrufen | Genaue Handlung, Gründe und Folgen erkennbar; keine fachlich falsche universelle Rückgängig-Aktion | +| STATE-24 | Nur technisch bereite Kompositionsfassung ansehen | Keine automatische Anzeigefreigabe, Mitgliederstruktur oder öffentliche Listung | +| STATE-25 | Kompositionsfassung zur Anzeige freigeben | Eigene Handlung am benannten Gegenstand; kein neuer Artikel, keine automatische Angebotsaktivierung und keine Dateiabrufrechte | +| STATE-26 | Enthaltenes Modul und eigenständige Modulansicht prüfen | Bestandteil nach der freigegebenen Elternstruktur sichtbar; eigenständige Ansicht prüft die eigene Anzeigefreigabe | +| STATE-27 | Öffentliche Listung gegenüber Anzeigefreigabe prüfen | Entscheidungsebenen und gezeigte Fassung unterscheidbar; ADR-29 nicht als bereits generell umgesetzt darstellen | +| STATE-28 | Artikel-Stand aktualisiert, gezeigte Fassung weicht ab | Kein verdeckter Fassungsmix; jeweils geltende Profil-/Übergangsregel und Befund nachvollziehbar | +| STATE-29 | Website-Bild über CMS neu hochladen beziehungsweise Präsentationsdatei anlegen | Dokumentierte unterschiedliche Freigabefolgen erkennbar; Upload und Medienfreigabe veröffentlichen keine Seitenrevision | + +## Noch zu bestätigen oder zu prüfen + +- Zustimmung zur vorgeschlagenen Trennung der Statusinformationen und zur kontextbezogenen Speicherwirkung. +- Technische Unterstützung der Vorschau ungespeicherter Eingaben; andernfalls die ausdrücklich benannte Vorschau gespeicherter Daten (OFF-12). +- Genaue Speichergrenzen zwischen Aufbau und direkt wirksamen Angaben sowie Erhalt offener Eingaben beim Bereichswechsel (OFF-13). +- Vorhandene Zustandsbezeichnungen und Abschlussaktionen je Inhalts-/Kompositionstyp; keine Ableitung aus generischen Mockupbezeichnungen (OFF-14). +- Einordnung der Anzeigefreigabe in den Kompositionsarbeitsplatz und getrennte Darstellung einer öffentlichen Listung; keinen Freigabeweg zusammenziehen. +- Vollständige visuelle Zustände für Fehler, Prüfung, Auswirkungen und Ergebnis sowie Platznutzung bei langen Vergleichen. +- Angebotsfassungen, Aktivierung und Wirkungen auf bestehende Erwerbe bleiben unter OFF-01 bis OFF-08 offen. + +## Herkunft + +- [Bestätigter Aufbauarbeitsplatz](06-aufbau-arbeitsplatz-entwurf.md), insbesondere AUF-R07. +- [Fachliche Anforderungen und offene Fragen](04-fachliche-anforderungen.md). +- [Änderungsklassen, Produktkonfiguration §4](../../fachkonzept/produktkonfiguration-und-mitgliederbereich.md). +- [Versionierung und Veröffentlichung §§1–6 und §9](../../architektur/06_Versionierung_und_Veroeffentlichung.md). +- [Redaktionelle Informationsbasis](../../architektur/redaktionelle-informationsbasis.md). +- [Bibliotheksentscheidung E-A](../../analysen/ist-soll-abgleich-mitgliederbibliothek.md), [G1/G2 und historische Sichtbarkeit](../../analysen/umsetzungsplan-mitgliederbibliothek.md). +- [MVP-Abschlussbericht vom 16.11.2026](../../analysen/abschlussbericht-mvp-2026-11-16.md), insbesondere Paket 3/G2. +- [Website-Zielarchitektur §6.2](../../architektur/website-cms-marketing-zielarchitektur.md) als Entwurf, abgeglichen mit [Quellenrangfolge, ADR-29 und ADR-41](../../architektur/12_Entscheidungsprotokoll_ADR.md). +- [Medienzugriff für Komponenten](../../architektur/medienzugriff-fuer-komponenten.md), Website-Freigabe und CMS-Upload. +- [Exakter Bildprompt und Referenz](generierung/speichern-vorschau-freigabe.md). + +Die fachlichen Quellen beschreiben den vorhandenen Dokumentationsstand; damit ist weder dessen vollständige Implementierung noch eine erneute fachliche Freigabe im Designgespräch behauptet. diff --git a/docs/ux/verwaltung/08-einfacher-redaktionsalltag-entwurf.md b/docs/ux/verwaltung/08-einfacher-redaktionsalltag-entwurf.md new file mode 100644 index 0000000..b3395fc --- /dev/null +++ b/docs/ux/verwaltung/08-einfacher-redaktionsalltag-entwurf.md @@ -0,0 +1,121 @@ +# Einfacher Redaktionsalltag und überschaubares Angebot + +**Stand: 19.11.2026.** Die Ausrichtung auf einen überschaubaren Produktumfang, meist eine bearbeitende Person und die spätere Integration des Kursbuchsystems stammt ausdrücklich vom Auftraggeber. Die folgenden Bedienabläufe sind ein Entwurf zur Abstimmung. Sie legen keine neuen fachlichen Zustandsautomaten oder Modelländerungen fest. + +## Maßstab + +Die Verwaltung unterstützt die Redaktion und den Betrieb von Lara & Felix. Lizenzierung und Verkauf unterstützen die Nutzung der Inhalte. Ein umfangreiches allgemeines Shopsystem ist kein Gestaltungsziel dieses Auftrags. Die Datenmodelle dürfen differenziert sein; die täglichen Aufgaben sollen mit wenigen verständlichen Handlungen auskommen. + +Die in Dokument 07 aufgelisteten Freigabeebenen dienen dem fachlichen Abgleich. Sie sind **keine Vorgabe für sieben sichtbare Freigabeprozesse, Statusanzeigen oder Navigationseinträge**. Auch die zuletzt vorgeschlagenen drei Handlungsfamilien sind noch kein beschlossener allgemeiner Prozess für jeden Objekttyp. + +## Vorgeschlagenes Arbeitsbild + +Die Redaktion öffnet beispielsweise „Programm Abstand“ und arbeitet in einem zusammenhängenden Arbeitsplatz. Der bereits gewählte Aufbau mit Struktur links und Bearbeitung rechts bleibt Grundlage. Angaben, Aufbau, öffentliche Darstellung und Verlauf sind von dort direkt erreichbar. Lizenzartikel und verwendende Angebote sind im Kontext zugänglich; gewöhnliche Inhaltsänderungen verlangen keinen Rundgang durch technische Objektverwaltungen. + +Im Kopf stehen der bearbeitete Gegenstand und sein Arbeitsstand. Beim Bearbeiten einer neuen Fassung bleibt erkennbar, welche Fassung aktuell genutzt wird. Die genaue Bezeichnung richtet sich nach dem Gegenstand: ein aktueller Artikel-Stand, eine zur Anzeige freigegebene Struktur und eine öffentliche Seitenrevision werden nicht durch einen neuen gemeinsamen Datenbankstatus „aktiv“ ersetzt. + +| Frage im Alltag | Vorgeschlagene Antwort der Oberfläche | +|---|---| +| Wo arbeite ich gerade? | Produktname, gegebenenfalls bearbeitete Fassung und klare Änderungsmarkierung | +| Ist meine Änderung gesichert? | Eine verständliche Speicherrückmeldung im Arbeitsplatz | +| Was wird derzeit genutzt? | Konkrete aktuelle Fassung beziehungsweise Revision, bei Bedarf mit Link zur Ansicht | +| Was sieht man öffentlich? | Eigener Bereich für öffentliche Texte, Bilder und Ausgabevorschau; geschützte Inhalte bleiben unterscheidbar | +| Was ist früher gewesen? | Verlauf mit historischen Fassungen und vorhandenen Nachweisen; keine Vermischung mit der normalen Bearbeitung | + +## Beispiel: Ein bestehendes Programm ändern + +1. Das Programm öffnen. Die aktuell genutzte Fassung und ein vorhandener Bearbeitungsentwurf sind erkennbar. +2. Inhalte, Reihenfolge oder lokale Hinweise im selben Arbeitsplatz bearbeiten. Es wird keine Kopie des ganzen Produkts zur Neuerfassung verlangt. +3. Den Arbeitsstand speichern und bei Bedarf die passende Vorschau öffnen. Speichern allein darf keine unbenannte Wirkung in einem anderen Bereich auslösen. +4. Wenn die Änderung wirksam werden soll, **eine zusammenhängende Übernahmeprüfung** aufrufen. Sie nennt die tatsächlichen Änderungen, betroffene Verwendungen und notwendige fachliche Bestätigungen an einem Ort. +5. Die beabsichtigte Wirkung ausdrücklich auslösen. Die Oberfläche zeigt danach den tatsächlichen Stand; die bisherige Fassung bleibt nach den vorhandenen Regeln im Verlauf erhalten. + +Die genaue Beschriftung der abschließenden Handlung – etwa „Fassung bereitstellen“ oder „Änderungen übernehmen“ – ist noch abzustimmen. Eine solche Handlung darf mehrere vorhandene Operationen nur koordinieren, wenn deren Umfang, Reihenfolge und Wirkung fachlich geklärt sind. Pflichtbestätigungen werden dabei nicht automatisch für die Redaktion abgegeben. Mehrere betroffene Artikel oder öffentliche Darstellungen dürfen nicht verdeckt gemeinsam umgeschaltet werden. + +Eine reine Beschreibungskorrektur der Klasse A erhält weiterhin ihren kurzen, direkt wirksamen Speicherweg. Dafür wird keine zusätzliche Inhaltsfassung oder Übernahmeprüfung eingeführt. Ein Programm ohne eigenen Lizenzartikel muss als Struktur gepflegt und gegebenenfalls zur Anzeige freigegeben werden können. + +## Verkauf und öffentliche Website im Kontext + +Ein neues Angebot oder geänderte Konditionen haben einen verständlichen eigenen Arbeitsablauf. Eine Änderung der didaktischen Reihenfolge soll nicht allein deshalb zur erneuten Einrichtung von Preisen, Lizenzvarianten oder Rabatten führen. Die offenen Angebotsregeln werden dadurch nicht entschieden. + +Öffentliche Produktanteile werden aus den vorhandenen Angaben und Präsentationszuordnungen gepflegt und gezielt in ihrer Ausgabe geprüft. Eine normale CMS-Seite behält ihren kurzen Entwurfs- und Veröffentlichungsablauf. Die Redaktion soll erkennen, ob sie einen öffentlichen Beschreibungstext, ein freigegebenes Präsentationsmedium oder einen geschützten Lehrinhalt verändert. Sie soll dafür keine technische Freigabehierarchie auswendig kennen müssen. + +## Was automatisch oder im Hintergrund behandelt werden soll + +- Technische Vollständigkeit und Medienverarbeitung werden vom System ermittelt. Nur offene Aufgaben oder Fehler verlangen Aufmerksamkeit. +- Historische Fassungen und Nachweise bleiben erhalten, ohne bei jedem Speichern manuelle Verwaltungsarbeit zu erzeugen. +- Bereits erfüllte Voraussetzungen werden übernommen, soweit die bestehende Fachlogik sie weiterhin als gültig anerkennt. Eine unveränderte Mitgliedermenge braucht keine künstlich wiederholte Bestätigung. +- Zusätzliche Aktionen erscheinen bei einem tatsächlichen Anlass. Ausnahmefälle bestimmen nicht die Grundanordnung des täglichen Arbeitsplatzes. + +## Bestehende Rechte schützen und notwendige Rückzüge ermöglichen + +**Bestätigte Leitplanke:** Normale Bearbeitung darf bereits erworbene Nutzungsrechte nicht unbeabsichtigt entziehen oder verändern. Maßgeblich bleiben der vereinbarte Umfang, die Bedingungen und Gültigkeit des Erwerbs sowie bestehende Updatezusagen. Das ist keine neue Zusage unbegrenzter Laufzeit und kein Einfrieren aller Inhalte auf den Erwerbszeitpunkt. + +Die Verwaltung muss die Folgen konkret unterscheiden: + +| Handlung | Wirkung auf bestehende Erwerbe | +|---|---| +| Inhalt oder Aufbau regulär überarbeiten | Vorhandene Fassungs- und Updatepolitik anwenden; vereinbarte Rechte nicht durch Bearbeitung einer Quelle oder Zuordnung still überschreiben | +| Angebot ändern oder für weitere Erwerbe beenden | Bestehende Erwerbe und ihre festgehaltenen Konditionen bleiben gemäß ihren Regeln erhalten; kein beiläufiger Rechteentzug | +| Öffentliche Produktdarstellung verbergen oder eine CMS-Seite zurücknehmen | Öffentliche Präsentation ändern; dadurch keine Berechtigung im Mitgliederbereich löschen oder verändern | +| Inhalt aus rechtlich notwendigem Grund zurückziehen | Weitere Bereitstellung des konkret betroffenen Inhalts sperren; Erwerbe und Nachweise bleiben erhalten, auch wenn ein betroffener Inhalt nicht mehr nutzbar ist | + +### Vorgeschlagene Handlung: „Sofort zurückziehen“ + +Diese Ausnahmehandlung ist am betroffenen Gegenstand gezielt erreichbar und von normalem Speichern, Löschen einer Zuordnung oder Beenden eines Angebots unterscheidbar. Sie verlangt keine vollständige erneute Produktkonfiguration. + +Vor der Auslösung zeigt ein kompakter Bestätigungsschritt den Gegenstand, die betroffenen Fassungen und Verwendungen sowie den Umfang der Sperre. Der Betreiber gibt Grund und kurze Begründung an und bestätigt die ausdrücklich benannte Wirkung. Der Entwurf führt dafür keine zusätzliche allgemeine Vier-Augen-Pflicht oder lange Freigabekette ein. + +Nach Auslösung müssen der tatsächliche Sperrstatus, Zeitpunkt und noch offene Folgeaufgaben erkennbar sein. Betroffene Personen werden ermittelt; Hinweise und erforderliche Benachrichtigungen sind nachvollziehbar. Diese Folgeaufgaben dürfen die eigentliche Sperre nicht verzögern. Ob und wie ein zulässiger Ersatzstand angeboten wird, folgt dem vorhandenen Modell und der konkreten Entscheidung. Eine neue Zusammenstellung wird nicht als bereits freigegebener Ersatz ausgegeben. + +Der gewählte Rückzugsumfang muss alle betroffenen Ausgabewege berücksichtigen: direkte und verschachtelte Verwendung, aktuelle und historische Artikelstände sowie gegebenenfalls Website-Ableitungen und öffentliche Einbindungen. Eine nur ausgeblendete Karte ist keine Zugriffssperre. Die konkrete koordinierte Umsetzung dieses Umfangs bleibt unter OFF-18 zu prüfen; ein einzelner vorhandener Rückzugsknopf ist dafür noch kein Nachweis. + +### Vorhandene Grundlage und tatsächliche Grenzen + +[Versionierung §6](../../architektur/06_Versionierung_und_Veroeffentlichung.md) beschreibt die Sperre einer Inhaltsfassung und den Rückzug aller betroffenen Artikelstände einschließlich verschachtelter und historischer Verwendungen. Berechtigungen und Erwerbsnachweise bleiben bestehen. Die Sperre neuer Zugriffe wirkt mit Abschluss der Transaktion. Bereits ausgestellte Zugriffe können entsprechend ihrer Laufzeit noch auslaufen; heruntergeladene lokale Kopien lassen sich nicht zurückholen. Das darf die Oberfläche nicht als bereits erfolgte vollständige Rückholung darstellen. + +Website-Medien besitzen nach [Medienzugriff für Komponenten](../../architektur/medienzugriff-fuer-komponenten.md) einen eigenen Ausgabepfad und eine eigene Rücknahme. Dieser muss bei einem umfassenden rechtlich notwendigen Rückzug ausdrücklich mitbetrachtet werden. Die Dokumentation ist Grundlage für die Umsetzung und keine aktuelle Abnahme sämtlicher Sperrwirkungen. + +Bestellungen, Rechte, Fassungen und Ausgabenachweise werden für den Nachweis erhalten. Automatische Erstattung, Vertragsaufhebung oder Entzug anderer unbetroffener Inhalte sind durch diese Bedienentscheidung nicht beschlossen. + +## Kursbuchsystem als künftiger Teil derselben Plattform + +Das Kursbuchsystem ist laut Auftraggeber noch nicht begonnen und muss später integrierbar sein. Es ist ein eigener künftiger Arbeitskontext; es darf nicht zwischen Shopverwaltung und Veröffentlichungsschritten untergehen. Die gemeinsame Navigation, Medienauswahl, Quellenkennzeichnung und Unterscheidung von Original und Verwendung müssen dort anschlussfähig bleiben. + +Mit „Kursbuchsystem“ wird in diesem Dokument **kein** bereits definierter Kursplaner, Fortschrittsnachweis, Teilnehmerverwaltung oder Player gleichgesetzt. Die konkreten Aufgaben und die Abgrenzung zu Trainingsplan-Vorlagen, persönlicher Planung und Durchführung sind noch zu klären. Das [Zukunftskonzept zu Trainingsplanung](../../fachkonzept/LUF_Zukunftskonzept_Trainingsplanung_Methodik_Freemium_2026-11-16.md) enthält dazu angrenzende Ideen mit eigenem Status. Diese werden nicht zu zusätzlichen Pflichten des laufenden UX-Auftrags gemacht. + +## Gezielter Prüfauftrag an das Fachkonzept + +Für jede sichtbare Freigabe ist zu beantworten: + +1. Welche eigenständige Entscheidung trifft die Redaktion hier? +2. Ist ihre Wirkung bereits durch eine andere Entscheidung eindeutig abgedeckt? +3. Kann dieselbe Nutzerhandlung notwendige bestehende Operationen nachvollziehbar koordinieren? +4. Handelt es sich um eine automatische Prüfung, einen historischen Nachweis oder tatsächlich eine gesonderte Betreiberentscheidung? + +Anzeigefreigabe, öffentliche Listung und kommerzielle Veröffentlichung dürfen dabei ausdrücklich auf Zusammenlegung oder Entfall einer manuellen Handlung geprüft werden. Bestehende Fassungsbindungen, Rechte und historische Nachweise werden bis zu einer gesonderten Entscheidung erhalten. Dieser Prüfauftrag ist keine Erlaubnis zum sofortigen Umbau des Fachmodells. + +## Vorgeschlagene Abnahmeziele für die Vereinfachung + +| ID | Alltagsszenario | Prüfziel | +|---|---|---| +| SIMPLE-01 | Bestehendes Programm inhaltlich überarbeiten | Zusammenhängender Arbeitsplatz; keine wiederholte Pflege bereits vorhandener Produkt-, Lizenz- oder Angebotsdaten | +| SIMPLE-02 | Reihenfolge oder lokale Rolle ändern | Speichern, Vorschau und nötige Übernahmeprüfung verständlich; keine sieben getrennten Freigabestationen | +| SIMPLE-03 | Beschreibung korrigieren | Kurzer Speicherweg mit klarer Wirkung; keine unnötige neue Lehrfassung | +| SIMPLE-04 | Aktuelle und historische Fassungen prüfen | Aktueller Gegenstand, Bearbeitungsentwurf und Verlauf unterscheidbar; keine gemischte Fassung | +| SIMPLE-05 | Öffentliche Darstellung prüfen | Öffentliche Produktinformationen, CMS-Seitenrevision und tatsächlich ausgegebene Medien verständlich, ohne Fachmodellwissen vorauszusetzen | +| SIMPLE-06 | Neues Angebot für vorhandene Produkte erstellen | Gemeinsame Auswahl und vorhandene Produktangaben nutzen; kommerzielle Angaben gezielt bearbeiten | +| SIMPLE-07 | Einen zusätzlichen Arbeitsbereich für das Kursbuchsystem einordnen | Gemeinsame Verwaltungsstruktur und Auswahlmuster anschlussfähig; keine neue Pflichtstrecke im Verkaufsablauf | +| SIMPLE-08 | Angebot, Produkt oder öffentliche Darstellung regulär ändern | Keine stille Änderung bestehender Erwerbe, vereinbarter Rechte oder historischer Nachweise | +| SIMPLE-09 | Rechtlich notwendigen Rückzug auslösen | Grund, Gegenstand und Wirkung verständlich; weitere Bereitstellung im bestätigten Umfang gesperrt, ohne Veröffentlichungsschleife | +| SIMPLE-10 | Rückzug bei mehreren aktuellen und historischen Verwendungen | Betroffene Ausgabewege und Stände berücksichtigt; tatsächlicher Sperrstatus und Folgeaufgaben nachvollziehbar | +| SIMPLE-11 | Betroffene Bibliothek nach Rückzug öffnen | Erwerb und Nachweise bleiben erhalten; fehlende Verfügbarkeit und gegebenenfalls zulässiger Ersatz verständlich | + +Diese Ziele sind Entwurf. Konkrete Klickzahlen werden erst am abgestimmten Ablauf und einem realen Beispiel ermittelt; es gibt bislang keinen Implementierungs- oder Nutzungsnachweis für diesen vereinfachten Ablauf. + +## Bezug + +- [Bestätigte Richtung](02-designentscheidungen.md), insbesondere UX-D16 bis UX-D19. +- [Fachliche Anforderungen und offene Fragen](04-fachliche-anforderungen.md), insbesondere FACH-32 bis FACH-38 sowie OFF-16 bis OFF-18. +- [Aufbauarbeitsplatz](06-aufbau-arbeitsplatz-entwurf.md). +- [Dokumentierte Freigabewege und bisheriger Detailentwurf](07-speichern-vorschau-freigabe-entwurf.md). Dessen Bedienvorschläge sind im Licht dieser Vereinfachung erneut abzustimmen. diff --git a/docs/ux/verwaltung/09-redaktionsarbeitsplatz-entwurf.md b/docs/ux/verwaltung/09-redaktionsarbeitsplatz-entwurf.md new file mode 100644 index 0000000..44f85af --- /dev/null +++ b/docs/ux/verwaltung/09-redaktionsarbeitsplatz-entwurf.md @@ -0,0 +1,223 @@ +# Gemeinsamer Redaktionsarbeitsplatz + +**Stand: 19.11.2026.** Die Anforderungen an die gemeinsame Redaktion stammen ausdrücklich vom Auftraggeber. Redaktionsentwurf 1 ist als aufgeräumte Grundlage gewählt (UX-D22). Die Redaktion wird mit gemeinsamen Registern weiter ausgearbeitet; Registerbenennung und genaue Aufteilung sind noch Entwurf. Die konkreten Interaktionsregeln und RED-Prüffälle sind Entwurf. Kein Implementierungsauftrag und keine UX-Abnahme der aktuellen Anwendung. + +## Zweck und Geltung + +Ein Fachobjekt öffnen, seine Beschreibung und Präsentationsmedien unmittelbar überblicken, gezielt ändern und die passende Ausgabe prüfen. Derselbe Redaktionsbaustein wird bei Medien, Modulen, Programmen und Lizenzartikeln verwendet. Trainingspläne und weitere Fachobjekte müssen anschließbar bleiben; ihr konkretes Fachmodell wird dadurch nicht festgelegt. + +**Zentral** bedeutet eine gemeinsame Datenbasis, gemeinsame Regeln und eine wiederverwendbare Bedienung vom jeweiligen Fachobjekt aus. Der Baustein kann eingebettet sein oder als gemeinsamer Redaktionsmanager geöffnet werden. Ein solcher Manager bleibt an das Ausgangsobjekt gebunden und benötigt eine verlustfreie Rückkehr; es entsteht keine zweite unabhängige Objektverwaltung. Jedes Fachobjekt behält seine eigenen Angaben. Der gemeinsame Baustein ersetzt nicht den Aufbaueditor, die fachliche Fassungsverwaltung, die Lizenzierung oder das CMS-Seitenlayout. + +Der [Planungstext des Auftraggebers](quellen/redaktionsmodul-planungschat-2026-11-19.md) ist als Quelle erhalten. [Redaktionelle Informationsbasis](../../architektur/redaktionelle-informationsbasis.md) und ADR-41 dokumentieren bereits gemeinsame Daten und Leser. Das belegt Teile der technischen Grundlage, keine einheitliche oder abgenommene Bedienoberfläche. Die erneuerte Anforderung rechtfertigt keinen ungeprüften zweiten Datenbestand. + +## Gewählte Basis und gemeinsame Register + +Der Auftraggeber bevorzugt Entwurf 1 wegen seiner aufgeräumten Darstellung. Texte und Präsentationsmedien müssen dafür nicht gleichzeitig nebeneinander stehen. Die wiederverwendbare Bearbeitung ist ausdrücklich auch für Filme und andere Medien erforderlich, nicht nur für Lizenzartikel. + +Vorgeschlagene gemeinsame Register: + +| Register | Gemeinsame Aufgabe | +|---|---| +| Texte | Titel/Anzeigename, Teaser, Kurz-/Langbeschreibung und gezielt erreichbare Varianten; kompakte Inhalte mit abschnittsweiser Bearbeitung | +| Präsentationsmedien | Sichtbare Zuordnungen nach Rolle; gemeinsamer Picker, Austausch, Entfernen und Reihenfolge | +| Einordnung | Fachliche Materialart, Themen, Zielgruppen, Verwendungszwecke und Suchbegriffe kompakt pflegen | + +Die exakten Bezeichnungen und die Einordnung in die jeweilige Objektumgebung bleiben Entwurf. Die Register ersetzen nicht die fachlichen Bereiche für Originaldatei, Aufbau, Fassungen oder kommerzielle Angaben. Der gemeinsame Redaktionsbaustein darf nicht parallel an anderer Stelle dieselben Felder mit anderer Bedienung anbieten. + +![Gemeinsame Präsentationsmedien-Registerkarte am Unterrichtsfilm](bilder/redaktion-register-medium-v1.png) + +Die neue Ansicht zeigt den Unterrichtsfilm „Lara im Park“ als bearbeitetes Fachobjekt. Titelbild, zwei Trailer und eine Galerie sind **seine Präsentationszuordnungen**. Ein Trailer-Austausch ersetzt nicht die Originaldatei des Unterrichtsfilms. Die Statusangabe „Für Website freigegeben“ gehört zum jeweils referenzierten Präsentationsmedium. + +Dasselbe Register muss bei einem Modul, Programm und Lizenzartikel dieselben Gruppen, Aktionen und Auswahlregeln verwenden. Trainingspläne bleiben anschließbar. Unterschiedlich sind die eigenen Daten, tatsächlich zulässige Rollen und gegebenenfalls die Herkunft; daraus werden keine unabhängig gestalteten Masken. + +Quellen-/Übernahmebedienung erscheint nur, wenn eine solche Herkunft fachlich besteht. Das Filmbeispiel hat eigene Zuordnungen. Ein Lizenzartikel kann entsprechend RED-R03 übernommene und eigene Angaben zeigen. Für ein gewöhnliches Medium wird keine fiktive übergeordnete Produktquelle eingeführt. + +Ein Registerwechsel erhält offene redaktionelle Eingaben und ihren Änderungsstatus im selben Arbeitskontext. Die gemeinsame Speicherung benennt ihren Umfang; es werden keine versteckten Änderungen an Lehrinhalt oder Rechten mitgespeichert. Ein sichtbarer Wechsel von Kontext oder Objekt muss den tatsächlich bearbeiteten Gegenstand klar zeigen. + +Die neue Abbildung konkretisiert zunächst das Medienregister. Ein vollständiger neuer visueller Nachweis der Text- und Einordnungsregister steht noch aus; ihre Grundbedienung wird aus der gewählten Übersicht fortgeführt, ohne alle Felder gleichzeitig aufzuspannen. + +## Wechsel zum Redaktionsmanager und Rückkehr + +Der Auftraggeber hat präzisiert: Die bisherige Abbildung zeigt den Redaktionsmanager, nicht den vollständigen Medieneditor. Ein eigener Redaktionsmanager ist zulässig, wenn die Rückkehr in die normale Bearbeitung des Mediums, Moduls, Programms oder anderen Fachobjekts **keine dortigen Eingaben verliert** (UX-D23). + +Vorgeschlagener Übergang: + +```mermaid +flowchart LR + A["Normale Objektbearbeitung · offene Eingaben"] -->|"Redaktion bearbeiten"| B["Redaktionsmanager · dasselbe Objekt"] + B -->|"Zurück zur Bearbeitung"| C["Ursprünglicher Editor · Eingaben und Arbeitsstelle erhalten"] +``` + +„Zurück zur Medienbearbeitung“, „Zurück zum Modul“ beziehungsweise der passende konkrete Rückweg ist im Redaktionsmanager gut sichtbar. Objektname und -art benennen, wessen Redaktion bearbeitet wird. Der Rückweg führt zum ursprünglichen Bearbeitungskontext; ein bloßer Link auf eine frisch geladene Standardmaske reicht nicht. + +| Handlung | Vorgeschlagenes Verhalten | +|---|---| +| Redaktion aus einem noch ungespeicherten Editor öffnen | Eingaben einschließlich Auswahl, Reihenfolge und gültig erhaltbarer Upload-/Rich-Text-Zustände im laufenden Arbeitskontext bewahren. Kein erzwungenes Speichern oder Validieren der ganzen Ausgangsmaske | +| Im Manager nur ansehen | Rückkehr erhält die ursprüngliche Bearbeitung unverändert | +| Redaktion speichern | Nur den benannten redaktionellen Umfang sichern. Noch offene Eingaben im Ausgangseditor bleiben offen und erhalten; kein heimliches Speichern des gesamten Fachobjekts | +| Mit offenen Redaktionsänderungen zurückkehren | Als bevorzugtes Verhalten auch diesen Arbeitsstand im laufenden Kontext erhalten und im Ausgangseditor als ungespeichert erkennbar halten. Erneutes Öffnen setzt dort fort; Zurückkehren bedeutet nicht Verwerfen | +| Bewusst verwerfen | Nur den ausdrücklich benannten Umfang verwerfen; niemals dadurch die offenen Eingaben des Ausgangseditors löschen | + +Die bestätigte Anforderung betrifft den verlustfreien Hin- und Rückweg. Das Verhalten bei noch ungespeicherter Redaktion ist eine vorgeschlagene Konkretisierung. Neuladen, Sitzungsende und dauerhafte Wiederherstellung sind gesondert zu prüfen; die bloße Navigation darf keine falsche Erfolgsmeldung „Gespeichert“ auslösen. + +Nach der Rückkehr bleiben aktives Register, ausgewählter Bestandteil und sinnvollerweise Scroll-/Fokusposition erhalten. Bereits gespeicherte redaktionelle Änderungen können in Zusammenfassungen aktualisiert werden, ohne die übrigen offenen Eingaben durch ein vollständiges Neuladen zu überschreiben. + +Für dieselben redaktionellen Felder darf es keine unkoordinierten konkurrierenden Werte im ursprünglichen Editor und im Redaktionsmanager geben. Ein späteres Speichern des Ausgangseditors darf neu gespeicherte Redaktionsangaben nicht wieder durch alte Formularwerte ersetzen. Der genaue Zustandsmechanismus wird vor Umsetzung am Bestand geprüft; das UX-Konzept schreibt dafür kein neues Datenmodell vor. + +Die normale Objektbearbeitung mit Einstieg „Redaktion bearbeiten“ und der konkrete Rücksprung sind noch als zusammengehörige Ansichten auszuarbeiten und später in der tatsächlichen Anwendung zu prüfen. Die vorhandene Registerabbildung allein belegt diese Navigation und Zustandsbewahrung nicht. + +## Ursprünglicher Vergleich der drei Anordnungen + +Die folgenden Nummern gehören zum ursprünglichen Vergleich; Entwurf 1 wurde danach als Grundlage ausgewählt. Die Nummern entsprechen der tatsächlichen Bildanzeige im Gespräch. Sie sind unabhängig von den älteren Angebots-, Auswahl- und Aufbauvergleichen. Alle drei zeigen denselben beispielhaften Lizenzartikel „Programm Abstand“, damit übernommene Texte und eigene Angaben sichtbar werden. Das zugrunde liegende Programm bleibt ein eigenständiges Fachobjekt. Globale Navigation und Objekttabs sind illustrative Belegungen. + +| Entwurf | Bedienprinzip | Stärke | Abzuwägende Grenze | +|---|---|---|---| +| 1 | Übersicht mit Texten links, Präsentationsmedien rechts; gezielte Bearbeitung im jeweiligen Abschnitt | Beschreibung und Medien gleichzeitig gut überblickbar; unmittelbarer Einstieg | Lange Texte und umfangreiche Medienrollen konkurrieren um Höhe und Spaltenbreite | +| 2 | Kurzer Redaktionsnavigator links, fester Bearbeitungsbereich rechts | Stabiler Bearbeitungsort; gezielter Wechsel zwischen Informationen und Medienrollen | Wiederholung von Zusammenfassungen und zweiter Navigation kann Platz kosten | +| 3 | Lesbare Redaktionsfläche mit direkter Bearbeitung und Quellenkontext rechts | Änderung nahe am Inhalt; Herkunft und Wirkung im Kontext | Kontextspalte reduziert Breite; bei vielen Abschnitten können Scrollwege entstehen | + +### Entwurf 1 + +![Redaktionsübersicht mit gezielter Bearbeitung](bilder/redaktion-01-uebersicht.png) + +### Entwurf 2 + +![Redaktionsnavigator mit festem Detailbereich](bilder/redaktion-02-navigator-detail.png) + +### Entwurf 3 + +![Direkt bearbeitbare Redaktionsfläche mit Quellenkontext](bilder/redaktion-03-direkt-kontext.png) + +## RED-R01 · Beschreibung am richtigen Gegenstand + +Anzeigename/Titel, Teaser, Kurzbeschreibung, ausführliche Beschreibung, Suchbegriffe und Einordnung sind direkt am jeweiligen Fachobjekt zugänglich. Die Übersicht zeigt vorhandenen Inhalt, leere Angaben und ihre Herkunft. Bearbeitung öffnet den betroffenen Abschnitt statt einer langen Gesamtmaske. + +Gewöhnliche Beschreibungen werden nicht automatisch als eigene Medien angelegt. Lernziele und Trainerhinweise werden gemäß ihrer Bedeutung am vorgesehenen Objekt beziehungsweise seiner Fassung gepflegt. Verbindlicher Lehrinhalt bleibt von direkt veränderbaren redaktionellen Angaben getrennt. Ein Feld wird nicht allein durch die Bezeichnung „Text“ der Änderungsklasse A zugeordnet. + +## RED-R02 · Textvarianten mit erkennbarem Geltungsbereich + +Standardangabe, zielgruppenbezogene Variante und ausgabebezogene Variante sind begrifflich unterscheidbar. Vor einer Änderung muss erkennbar sein, welcher Text für welchen Kontext geändert wird. Die Übersicht muss Varianten gezielt zugänglich machen, ohne alle Textfelder für alle Kombinationen gleichzeitig anzuzeigen. + +Die vorhandene Dokumentation nennt Kontextvarianten wie Kachel, Detail oder Bibliothek. Diese sind kein Nachweis für bereits umgesetzte **Zielgruppenvarianten**. Vorrang, Kombination und Rückfall bei Zielgruppe plus Ausgabe bleiben unter OFF-19 zu klären. Die drei Bilder zeigen den Standardfall mit einer eigenen Kurzbeschreibung; sie sind kein vollständiger Varianteneditor. + +## RED-R03 · Übernommen und eigen pro Information unterscheiden + +Ein Lizenzartikel kann Texte und Präsentationsmedien aus seinem zugrunde liegenden Fachobjekt verwenden oder eigene Angaben besitzen. Die Oberfläche zeigt die tatsächliche Quelle und den wirksamen Inhalt. „Eigene Angabe“ bearbeitet den Lizenzartikel; sie ändert nicht die Quelle. Eine bewusst aufgerufene Quellenbearbeitung muss dies eindeutig benennen. + +Die vorhandene Textauflösung nennt Kontextvariante, eigene Objektangabe und bei eindeutiger Quelle die Ableitung. Eine nicht eindeutige Quelle wird nicht durch willkürliche Auswahl ersetzt. Das Design führt keine neue feste Produkthierarchie ein. + +„Wieder übernehmen“ zeigt die ersetzte eigene Angabe und den übernommenen Wert nachvollziehbar und erlaubt vor dem Speichern eine Korrektur. Ob eine leere eigene Angabe bewusst leer bedeutet oder zur Quelle zurückfällt, ist fachlich zu klären. Für geordnete Medienrollen bleibt offen, ob eine eigene Rolle die übernommene Sammlung vollständig ersetzt oder ergänzen darf (OFF-20). + +## RED-R04 · Klassifikation ist keine Zuordnung und keine Erlaubnis + +Technische Art beziehungsweise Dateiformat, fachliche Materialart, Themen, Zielgruppen und Verwendungszwecke werden getrennt verständlich. Die fachlichen Beispiele Unterrichtsfilm, Trailer, Interview, Titelbild oder Traineranleitung dürfen nicht allein aus einer Dateiendung abgeleitet werden. + +Kompakte Werte zeigen die Einordnung; Suche und gezielte Auswahl ersetzen lange ungegliederte Checkboxlisten. Freie Suchbegriffe und kontrollierte Klassifikationen sind zu unterscheiden. Vorhandene Dimensionen werden wiederverwendet. Tatsächliche Verwendung im Aufbau, Präsentationsrolle und Website-Freigabe bleiben eigene Informationen. Das Setzen von „Website/Marketing“ gibt keine Datei frei. + +## RED-R05 · Präsentationsmedien als sichtbare Referenzen + +Titelbilder, alternative Bilder, Trailer, Teaserfilme, Vorschauclips, Interviews, Audio, Galerien und weitere Ressourcen werden nach ihrer Rolle übersichtlich dargestellt. Jede Zuordnung besitzt eine sichtbare Vorschau und einen verständlichen Namen. **Mehrere Zuordnungen derselben Rolle sind möglich**, etwa zwei Trailer. Die Bildbeispiele zeigen dies ausdrücklich. + +Alle Medien stammen aus dem gemeinsamen Medienmanager. Die Zuordnung speichert Referenzen; sie kopiert keine Dateien und erzeugt keinen zweiten Medienbestand. Reine Präsentationsmedien benötigen keine fachliche Inhaltsfassung, auch bei Film oder Audio. Eine ausdrücklich festgehaltene Quellfassung wird nach bestehender Regel benannt und nicht automatisch nachgezogen. + +## RED-R06 · Gemeinsamen Picker kontextgerecht nutzen + +„Medien zuordnen“ und „Austauschen“ öffnen den gewählten gemeinsamen Auswahlbaustein aus Dokument 03. Der Auswahlkontext Präsentation muss auch geeignete Medien ohne Inhaltsfassung finden. Die fachliche Aufbauauswahl mit konkreter Fassung bleibt als eigener Kontext desselben Bausteins erhalten. + +Keine zweite Radio-/Checkbox-Textliste als Ersatz für den visuellen Picker. Checkboxen innerhalb der abgestimmten visuellen Mehrfachauswahl bleiben möglich. Bestehende Upload- und Medienanlagewege werden genutzt, ohne bei jedem Fachobjekt eine neue Medienverwaltung zu bauen. + +## RED-R07 · Hinzufügen, Austauschen, Entfernen und Sortieren + +- Hinzufügen ordnet nach ausdrücklicher Übernahme die gewählten Referenzen der benannten Rolle zu. Das Ergebnis bleibt im redaktionellen Arbeitsstand erkennbar. +- Austausch benennt die betroffene Zuordnung. Die Wirkung auf Reihenfolge und lokale Darstellungseinstellungen muss nachvollziehbar sein; Übernahmeregeln nicht aus Bilddetails erfinden. +- „Aus Rolle entfernen“ beziehungsweise „Zuordnung entfernen“ löst nur die betreffende Referenz. Das Medium bleibt im Bestand und in anderen Verwendungen erhalten. Seine Website-Freigabe wird dadurch nicht global zurückgenommen. +- Geordnete Listen besitzen Drag-and-drop und eine bedienbare Alternative ohne Ziehen. Sortiert wird innerhalb des benannten Geltungsbereichs. Die Bilder beschließen keine Verschiebung zwischen Rollen oder Sortierung der Rollen selbst. +- Der erste Eintrag hat keine aktive Aufwärtsbewegung, der letzte keine aktive Abwärtsbewegung. Eine Auswahl bleibt nach einer Bewegung nachvollziehbar. + +Ein Medium kann mehrere Rollen haben; welche Doppelzuordnung innerhalb derselben Rolle zulässig oder sinnvoll ist, bleibt gesondert abzugleichen. Galerien und die gewünschte Slideshow-Präsentation brauchen nachvollziehbare Reihenfolge. Die aktuelle CMS-Dokumentation nennt noch kein eingesetztes Slideshow-Widget; ein vorhandener Abspieler wird nicht behauptet (OFF-21). + +## RED-R08 · Redaktion speichern und Wirkung verstehen + +Eine erkennbare Speicherhandlung sichert den benannten Redaktionsumfang. Bei den direkt wirksamen Angaben ist erkennbar, dass verwendende Ansichten Änderungen übernehmen können. Eine weitere Freigabe aller Beschreibungstexte wird nicht eingeführt. Einzelne Abschnitte erhalten keine widersprüchlichen konkurrierenden Speicherknöpfe. + +Ungespeicherte Änderungen, Validierung, Fehler und Rückkehr zur Bearbeitung folgen dem gemeinsamen Zustandsentwurf. Noch offene Eingaben bleiben beim Wechsel zwischen redaktionellen Informationen erhalten. Verbindliche Lehrinhalte und kommerzielle Daten werden nicht heimlich mitgespeichert. Preis, Rechteprofil und Vertragsbedingungen stehen außerhalb des Redaktionsbausteins. + +## RED-R09 · Ausgabe prüfen und lokale Abweichungen erkennen + +Die Kontrolle unterscheidet etwa Kachel, Detailansicht und Mitgliederbibliothek. Gegenstand, Datenstand und Quelle des gezeigten Textes bleiben erkennbar. Eine redaktionelle Kontrollansicht ist kein Nachweis öffentlicher Verfügbarkeit und erteilt keine zusätzlichen Nutzungsrechte. + +CMS-Widgets nutzen standardmäßig die zentralen Angaben und können einzelne Informationen lokal überschreiben. Ein lokaler Text muss als Abweichung dieses Widgets erkennbar sein. Rückkehr zu zentralen Angaben verändert nicht die Quelle. Öffentlich wirksame zentrale Änderungen können durch bestehende lokale Abweichungen verdeckt sein; die Prüfansicht soll dies erklären statt widersprüchliche Texte als Fehler der Speicherung erscheinen zu lassen. + +Das Redaktionsmodul gestaltet die Inhalte und Zuordnungen. CMS-Seitenlayout und ausgabespezifische Darstellung bleiben ihre eigenen Arbeitskontexte; eine einzelne Shopansicht wird nicht zum allgemeinen Editor. + +## RED-R10 · Website-Status am jeweiligen Medium + +Ein zugeordnetes Bild, Video oder Hörstück kann intern vorhanden sein, ohne öffentlich ausgeliefert werden zu dürfen. Die Zuordnung zeigt den Website-Status mit verständlicher Begründung und gezieltem Weg zur Medienverwaltung. Der Status bezieht sich auf die Ausgabeerlaubnis des Mediums, nicht auf eine neue Lehrinhaltsfassung. + +Bei Rücknahme der Website-Freigabe entfällt das Medium öffentlich. Andere Texte, Schaltflächen und Inhalte bleiben erhalten; ein danach inhaltsleeres Widget entfällt nach bestehender Regel. Die Redaktionsvorschau darf den internen Zustand mit Hinweis zeigen. Ein rechtlich notwendiger umfassender Rückzug nach Dokument 08 bleibt davon als eigener Ausnahmefall unterscheidbar. + +## RED-R11 · Gleichartige Register an allen Fachobjekten + +Texte, Präsentationsmedien und Einordnung werden mit denselben Bausteinen, Begriffen, Speicher- und Rückmeldemustern bedient. Das gilt ausdrücklich für die Zuordnung von Titelbildern, Trailern oder Galerien an einem Film. Objektspezifische Daten und zulässige Kontexte werden übergeben; Auswahl, Austausch und Reihenfolge werden nicht pro Objekttyp neu erfunden. Die gemeinsame Registerbenennung und -anordnung ist weiter abzustimmen. + +## RED-R12 · Verlustfreier Aufruf und Rückweg + +Der gemeinsame Redaktionsmanager übernimmt den Objektkontext und den Rücksprung zum tatsächlichen Ausgangseditor. Dessen noch ungespeicherte Eingaben bleiben erhalten, unabhängig davon, ob die Redaktion nur angesehen, bearbeitet oder gespeichert wird. Keine vorgeschaltete Gesamtspeicherung. Der Speicherumfang im Manager und der Umgang mit dort offenen Eingaben sind sichtbar. Browser-Zurück und der angebotene Rückweg müssen am späteren konkreten Navigationsmodell überprüft werden. Auch bei einem neuen, noch nicht angelegten Objekt darf die Bedienung keine unsichtbare Anlage oder Veröffentlichung voraussetzen. + +## Abgleich mit der bestehenden Grundlage + +Die dokumentierten `EditorialProfileReader`, `PresentationMedia`, `presentation_assignments`, Klassifikationen und Kontextvarianten sind vor Wiederverwendung am konkreten Umsetzungsteil zu prüfen. Ihre Existenz ersetzt keine visuelle UX-Abnahme. Aktuelle Module, Programme, Medien und Lizenzartikel benötigen denselben Bedienbaustein statt vier neuer Einzelmasken. + +Es gibt in dieser Iteration keinen neuen Nachweis an der laufenden Anwendung. Grundlage sind der bereitgestellte Planungstext, die Projektdokumentation, die zuvor erfassten Auditbelege und die bereits gewählte Gestaltungsrichtung. Aktuelle Schreib-, Sortier-, Varianten- und Freigabeabläufe sind später durch die Oberfläche zu prüfen. + +## Vorgeschlagene UX-Abnahmefälle + +| ID | Aufgabe | Erwartetes Ergebnis | +|---|---|---| +| RED-01 | Medium, Modul, Programm und Lizenzartikel öffnen | Gleiche redaktionelle Grundbedienung; eigene Angaben und Medien sofort überblickbar | +| RED-02 | Eine Kurzbeschreibung korrigieren | Gezielter Einstieg und Speicherung am richtigen Objekt; kein automatisch erzeugtes Textmedium | +| RED-03 | Verbindlichen Lehrtext oder ein Lernziel bearbeiten | Richtiger fachlicher und fassungsgebundener Bearbeitungsweg; nicht still als Beschreibung gespeichert | +| RED-04 | Zielgruppen- und Ausgabevariante wählen | Geltungsbereich, wirksamer Text und Quelle sichtbar; bestätigte Auflösungsregel anwenden | +| RED-05 | Eigenen Lizenzartikeltext verwenden und zurück zur Quelle wechseln | Quelle unverändert; eigene Abweichung und Rückfall nachvollziehbar | +| RED-06 | Nicht eindeutige oder fehlende Quelle | Keine willkürliche Ableitung oder versteckte Gesamtbeschreibung | +| RED-07 | Technische Art, Materialart, Zweck und Themen prüfen | Unterscheidbare Informationen; Klassifikation erteilt keine Zugriffserlaubnis | +| RED-08 | Zwei Trailer derselben Rolle zuordnen | Beide Zuordnungen sichtbar und unabhängig bearbeitbar; keine künstliche Einzelauswahl | +| RED-09 | Präsentationsfilm oder Bild ohne Lehrinhaltsfassung auswählen | Gemeinsamer visueller Picker bietet es im Präsentationskontext an; keine Pflicht-Lehrfassung | +| RED-10 | Präsentationsmedium austauschen | Gemeinte Zuordnung, verbleibende Reihenfolge und lokale Einstellungen nachvollziehbar | +| RED-11 | Zuordnung entfernen | Bestandsmedium, andere Verwendungen und globale Website-Freigabe bleiben erhalten | +| RED-12 | Medien einer Rolle sortieren | Richtige Reihenfolge mit Ziehen und Tastaturalternative; passende Randzustände | +| RED-13 | Galerie/Slideshow zusammenstellen | Mehrere Medien und Reihenfolge erhalten; verfügbare Ausgabe von noch fehlender Darstellung unterscheiden | +| RED-14 | Redaktion speichern, fehlerhaft speichern oder Bereich wechseln | Speicherumfang und direkte Wirkung klar; keine unbemerkten Eingabeverluste oder zusätzlichen Genehmigungsschleifen | +| RED-15 | CMS-Widget lokal überschreiben und wieder zentrale Angabe verwenden | Lokale Abweichung und Quelle erkennbar; Fachobjekt unverändert | +| RED-16 | Öffentliche Medienfreigabe zurücknehmen | Medium öffentlich nicht ausgegeben; übrige Inhalte erhalten; interne Vorschau erklärt Abweichung | +| RED-17 | Kachel, Detail und Bibliothek prüfen | Passende Ausgabe, benannter Datenstand und wirksame Varianten/Abweichungen nachvollziehbar | +| RED-18 | Bestehende Erwerbe und kommerzielle Angaben nach Redaktionseingriff prüfen | Keine unbeabsichtigte Änderung an Rechten, Vertragsdaten oder Kaufumfang | +| RED-19 | Dasselbe Register bei Film, Modul, Programm und Lizenzartikel öffnen | Gleiche Masken, Begriffe und Aktionen; eigene Daten und tatsächliche Quellen klar, keine Lizenzartikelpflicht | +| RED-20 | Präsentationsfilm an einem Unterrichtsfilm austauschen | Nur die gemeinte Zuordnung geändert; Originaldatei und Lehrinhalt des bearbeiteten Unterrichtsfilms bleiben erhalten | +| RED-21 | Zwischen Texten, Präsentationsmedien und Einordnung wechseln | Eingaben und Änderungsstatus bleiben im Arbeitskontext erhalten; Speicherumfang nachvollziehbar | +| RED-22 | Ausgangseditor mit offenen Eingaben verlassen, Redaktion ansehen und zurückkehren | Ursprüngliche Eingaben, aktives Register und Arbeitsstelle erhalten; keine erzwungene Speicherung | +| RED-23 | Redaktion speichern, während Ausgangseditor ungespeicherte Eingaben enthält | Nur Redaktion im benannten Umfang gesichert; andere Eingaben unverändert offen | +| RED-24 | Mit offenen Redaktionsänderungen zurückkehren und erneut öffnen | Vereinbartes Erhaltungs-/Verwerfverhalten nachvollziehbar; kein stiller Verlust in einem der beiden Kontexte | +| RED-25 | Nach Rückkehr Ausgangseditor speichern | Keine Überschreibung neuer Redaktionsangaben durch alte Formularwerte; Speicherumfang eindeutig | +| RED-26 | Rückweg bei neuem Objekt, offenem Upload und Browser-Zurück prüfen | Unterstützte Zustände tatsächlich erhalten; keine unbemerkte Anlage/Veröffentlichung und keine unbelegte Wiederherstellungszusage | + +## Bildgrenzen und noch offene Details + +- Entwurf 1 ist als Basis gewählt. Die neue Registeransicht konkretisiert sie; exakte Register, Feldwerte, Navigation und Rollenwerte sind keine vollständige Fachkonfiguration. Die drei älteren Vergleichsbilder bleiben zur Herkunft erhalten. +- Im zweiten Bild steht teilweise nur „Entfernen“. Die echte Handlung muss „Zuordnung entfernen“ oder ihren Geltungsbereich gleich eindeutig benennen. +- Die ersten beiden Bilder zeigen an einzelnen Stellen Ziehgriffe an Rollen und unpassende Auf-/Ab-Zustände. Diese Details nicht übernehmen: Reihenfolge gilt nur im zulässigen Bereich; Randaktionen korrekt deaktivieren. +- Die dritte Abbildung zeigt bei Galerie nur gemeinsame Aktionen. Die spätere Interaktion muss auch jedes einzelne Bild gezielt austauschen, entfernen und sortieren können. +- Der vollständige Fachobjekteditor, sein Redaktionseinstieg und der Rücksprung mit offenen Eingaben sind noch nicht visualisiert oder in der Anwendung nachgewiesen (OFF-22). +- Langtexte, weitere Medienrollen, Zielgruppenvarianten, Leerzustände sowie Fehler- und Vorschauansichten sind nicht vollständig visualisiert. Bildgenerierte Medien und Symbole sind Beispiele, keine freigegebenen Produktassets. +- OFF-19: Zielgruppe und Ausgabekontext; OFF-20: leere eigene Werte und Übernahme geordneter Medien; OFF-21: Galerie-/Slideshow-Ausgabe und Darstellungsoptionen. Diese Punkte nicht als still entschiedene Regeln implementieren. + +## Quellen + +- [Originaler Planungstext](quellen/redaktionsmodul-planungschat-2026-11-19.md). +- [Redaktionelle Informationsbasis](../../architektur/redaktionelle-informationsbasis.md). +- [Medienzugriff, Website-Freigabe und Präsentationszuordnungen](../../architektur/medienzugriff-fuer-komponenten.md). +- [Änderungsklassen](../../fachkonzept/produktkonfiguration-und-mitgliederbereich.md). +- [Gemeinsamer Auswahlbaustein](03-auswahl-und-zuordnung-entwurf.md). +- [Einfacher Redaktionsalltag](08-einfacher-redaktionsalltag-entwurf.md). +- [Bildprompts des ursprünglichen Vergleichs](generierung/redaktion-prompts.md). +- [Prompt der gemeinsamen Register am Unterrichtsfilm](generierung/redaktion-register.md). diff --git a/docs/ux/verwaltung/10-verwaltungsstandard-entwurf.md b/docs/ux/verwaltung/10-verwaltungsstandard-entwurf.md new file mode 100644 index 0000000..51f1548 --- /dev/null +++ b/docs/ux/verwaltung/10-verwaltungsstandard-entwurf.md @@ -0,0 +1,80 @@ +# Verwaltungsstandard – Konsolidierung und Umsetzung + +> **Aktualisierung 19.11.2026:** Die gemeinsame Designrichtung reicht für den Umbau aus. Maßgeblich ist jetzt [Dokument 14 – verbindlicher Verwaltungsstandard](14-verwaltungsstandard.md), ergänzt durch den [konkreten Umbauauftrag](15-umbauauftrag.md). Frühere allgemeine Hinweise auf ausstehende Detailabstimmungen sind unten als Arbeitsverlauf erhalten; sie sind keine weitere pauschale Startbedingung. Offene Geschäftsfragen bleiben abgegrenzt. Die Anwendung wurde durch diese Dokumentation nicht verändert. + +**Stand: 19.11.2026. Status: Vorschlag zur Abstimmung.** Dieses Dokument bündelt die bisher bestätigten Richtungen und schlägt ihre Überführung in wiederverwendbare Komponenten und überprüfbare Umsetzungsregeln vor. Es ist keine vollständige Freigabe aller Detailentwürfe und kein Implementierungsauftrag. + +## Ziel und Quellenrangfolge + +Die Verwaltung soll heute mit überschaubarem Bestand und meist einer bearbeitenden Person gut funktionieren. Zukünftige Bereiche einschließlich Kursbuchsystem schließen an dieselben Muster an. Fachliche Unterschiede bleiben erhalten; gleichartige Aufgaben erhalten dieselbe Bedienung. + +Verbindlich bestätigte Entscheidungen stehen in [Dokument 02](02-designentscheidungen.md). [Dokument 04](04-fachliche-anforderungen.md) bewahrt Anforderungen und offene Fragen. Die detaillierten Komponenten- und Ablaufdokumente enthalten zusätzlich **Entwürfe**. Ein Bild oder ein noch nicht bestätigter Prüffall wird durch dieses Dokument nicht nachträglich freigegeben. + +Die bestehenden Betriebsregeln in `CLAUDE.md` und `.cursor/rules/luf-betrieb.mdc` bleiben maßgeblich. [Designprinzipien](../../prinzipien/design-prinzipien.md) und freigegebene Markenwerte sind zu beachten. [Designsystem](../../architektur/designsystem.md) dokumentiert noch den früheren Umsetzungsstand „Verwaltung bleibt in Standardgestaltung“; die neue Verwaltungsrichtung ist damit nicht bereits technisch integriert. Die spätere Umsetzung muss den Geltungsbereich bewusst nachführen und gemeinsame Tokens anbinden. Zahlenwerte oder Produktbilder aus generierten Mockups sind keine neue Markenfreigabe. + +## Keine Einzelgestaltung jedes Screens + +Es wird je Arbeitsplatzfamilie eine repräsentative Referenz abgestimmt. Weitere Objekttypen verwenden dieselben Bausteine mit ihren jeweiligen Daten und zulässigen Aktionen. Zusätzliche Referenzansichten entstehen bei einem neuen Interaktionsmuster oder wesentlich anderem Risiko, nicht bloß wegen eines anderen Objektnamens. + +| Familie | Gemeinsame Aufgabe | Stand und nächste Lücke | +|---|---|---| +| Objektübersicht | Finden, Filtern, Vergleichen, Öffnen und passende Bestandsaktionen | Medien und andere Bestände nutzen gemeinsame Listenregeln; eine vollständige kompakte Übersichtsreferenz ist noch abzustimmen | +| Objektarbeitsplatz | Objekt bearbeiten, bei Bedarf Inhalte zusammenstellen und Quellen prüfen | Aufbauarbeitsplatz für Programme und Module bereits gewählt. Redaktionseinstieg und Rückweg ergänzen; Medien mit tatsächlichen Datei-/Fassungsbereichen in denselben Rahmen einordnen. Kein neuer Grundentwurf pro Typ | +| Redaktionsmanager | Texte, Varianten, Einordnung und Präsentationsmedien pflegen | Übersicht als Grundlage gewählt; gemeinsame Register am Film konkretisiert. Text-/Einordnungsdetails und Rücksprung weiter abstimmen | +| Website-/CMS-Arbeitsplatz | Gesamte Webpräsenz überblicken, Seiten und Menüs verwalten; einzelne Seite aufbauen und veröffentlichen | Einzel-Seitenbearbeitung in Dokument 12; übergeordneter Webpräsenz-Arbeitsplatz in Dokument 13 ergänzt. Beide verwenden gemeinsame Übersichts-, Auswahl- und Bearbeitungskomponenten | +| Prüfen und Wirksamwerden | Änderungen, Auswirkungen und notwendige Entscheidungen zusammenhängend kontrollieren | Gemeinsames Grundmuster; konkrete Wirkung bleibt objektspezifisch. Keine pauschale Freigabekette für jedes Objekt | + +Auswahl, Medienzuordnung, Dialoge, Sortierung und Vorschau sind gemeinsame Komponenten innerhalb dieser Familien, keine jeweils neue Bildschirmgestaltung. Auch Leer-, Lade-, Fehler- und Rückkehrzustände gehören zur Referenz; sie brauchen nicht sämtlich ein neues großes Mockup. + +## Vorgeschlagene gemeinsame Komponenten + +| Baustein | Verbindlich zu klärendes Verhalten | +|---|---| +| Verwaltungsrahmen | Navigation, Seitenbreite, Objektkopf, Bereichs-/Registernavigation und Rückweg | +| Aktions- und Statusbereich | Aktuelle Hauptaufgabe, Speicherumfang und tatsächlicher Zustand; Rückzug gezielt und ausdrücklich | +| Bestandsliste | Suche, aktive Filter, Vorschau, lesbare Zeilen, passende Aktionen und Leerzustand | +| Gemeinsamer Picker | Suchen, betrachten, mehrfach auswählen, gezielt bestätigen; kontextgerechte Typen und Fassungsregeln | +| Redaktion | Dieselben Text-, Einordnungs- und Medienrollenmasken mit tatsächlicher Herkunft und eigenen Abweichungen | +| Geordnete Zusammenstellung | Konkrete Verwendungen, Quelle, Reihenfolge, Ziehen und Tastaturalternative; keine ungewollte Quellenbearbeitung | +| Vorschau und Wirkungsprüfung | Gegenstand, Datenstand, Ausgabe und betroffene Verwendungen nachvollziehbar | +| Wechsel und Rückkehr | Eingaben, Auswahl und Arbeitsstelle erhalten; kein heimliches Speichern und kein veraltetes Zurückschreiben | + +Bei der späteren Implementierung wird vor jeder Neuanlage geprüft, welcher bestehende Baustein bereits geeignet ist. Die Komponenten werden an einer Stelle gepflegt und von mehreren Arbeitsplätzen genutzt. Ein gemeinsamer Datenleser allein macht noch keine gemeinsame UX; vier ähnlich aussehende kopierte Formulare sind ebenso wenig ein dauerhaft gemeinsamer Baustein. + +## Vorgeschlagene Gestaltungs- und Interaktionsregeln + +1. Den bearbeiteten Gegenstand und Geltungsbereich jeder Änderung erkennbar halten. +2. Hauptaktionen nach Aufgabe und Zustand gewichten; die tatsächliche Speicher- oder Veröffentlichungswirkung benennen. +3. Normale Arbeit nicht durch technische Statusmechanik, lange Gesamtformulare oder unnötige Konfigurationsschritte überladen. +4. Gleiche Aufgaben über dieselben Komponenten, Begriffe, Abstände, Feldzustände und Auswahlregeln bedienen. Typabhängige Daten rechtfertigen keine unabhängige Neuinterpretation der Interaktion. +5. Herkunft, eigene Abweichung, tatsächliche Verwendung und Freigabe unterscheiden. Redaktionelle Angaben, Lehrinhalt und kommerzielle Daten nicht vermischen. +6. Datenstand der Vorschau zeigen. Fehlende oder nicht erlaubte Bestandteile erklären und Rückkehr ohne Eingabeverlust ermöglichen. +7. Tastaturfokus, Dialogschließen, Auswahlübernahme und Reihenfolge konsistent behandeln. Farbe allein trägt keine Zustandsinformation. +8. Bestehende Erwerbe und vereinbarte Rechte schützen. Rechtlich notwendiger Rückzug bleibt ein gezielter Ausnahmeweg mit nachvollziehbarem Umfang und tatsächlicher Sperrwirkung. +9. Gemeinsame Tokens und freigegebene Assets nutzen; keine separaten Farb-, Button- oder Dialogsysteme pro Feature. Numerische Verwaltungsmaße sind noch konkret festzulegen. +10. Neue Bereiche einschließlich Kursbuchsystem nach diesen Mustern einordnen. Nur tatsächlich neue Aufgaben benötigen eine ergänzende Designentscheidung. + +## So wird ein Umbau überprüfbar + +Ein späterer Umsetzungsauftrag nennt Arbeitsplatzfamilie, Nutzeraufgabe, bestätigte Regeln, gewählte Referenz und betroffene gemeinsame Komponenten. Der Agent liefert dazu den tatsächlichen Ablauf, passende automatisierte Prüfungen sowie Screenshots aus der gerenderten Anwendung. Ein grüner Testlauf allein ist keine visuelle Abnahme; ein schönes Screenshot allein ist kein Nachweis des Speicher- oder Rechteverhaltens. + +Besonders aussagekräftig sind Aufgaben wie: vorhandenen Inhalt ändern; Medium visuell zuordnen und sortieren; Redaktion mit ungespeicherten Ausgangseingaben öffnen und zurückkehren; Fehler korrigieren; Entwurf und tatsächlich verwendete Fassung prüfen. Für den jeweiligen Auftrag wird nur die betroffene Auswahl dieser Fälle geprüft, ergänzt um erforderliche Regressionen und bestehende Repository-Prüfungen. + +Sichtprüfung auf der vorgesehenen Desktopbreite, sinnvoller schmalerer Darstellung und mit Zoom; Tastaturprüfung der betroffenen Interaktionen. CMS-Ausgaben zusätzlich in den unterstützten Gerätevorschauen. Die im Repository bereits festgelegten weitergehenden Prüfpflichten bleiben bestehen. Aussagen über Barrierefreiheit oder Tests werden auf den tatsächlich geprüften Umfang begrenzt. + +Jede Übergabe dokumentiert bekannte Abweichungen, offene Fachfragen und konkret nicht geprüfte Zustände. Die [Abnahmevorlage](regeln/ux-abnahme-vorlage.md) ist dafür vorbereitet. Abnahme bedeutet eine ausdrückliche Bewertung des beauftragten Umfangs; Screenshots oder Agentenmeldungen erteilen sie nicht automatisch. + +## Coding-Regeln vorbereiten und später aktivieren + +Die [Cursor-Vorlage](regeln/cursor-verwaltung-entwurf.mdc) und die [gemeinsame Agentenanweisung](regeln/AGENTS-verwaltung-entwurf.md) liegen zunächst unter `docs/ux/verwaltung/regeln/`. Sie sind **nicht aktiv** und überschreiben weder `.cursor/rules/` noch `CLAUDE.md` oder eine aktive `AGENTS.md`. + +Nach Abstimmung des Standards können aktive Cursor-Regeln sowie die Einstiegshinweise für Claude Code und andere Agenten auf denselben Standard verweisen. Die bestehenden Betriebsregeln werden ergänzt statt ersetzt. Ein einziger gepflegter Standard, gemeinsam genutzte Komponenten und wiederholbare Abnahmefälle sichern Konsistenz besser als unabhängig kopierte Regeltexte. Regeldateien allein garantieren keine korrekte Umsetzung. + +## Empfohlene nächste Reihenfolge + +1. Den CMS-Seiteneditor anhand der Weiterentwicklung in Dokument 12 abstimmen, den übergeordneten Webpräsenz-Arbeitsplatz aus Dokument 13 ausarbeiten und die kompakte Bestandsübersicht aus der gewählten Listenbasis weiterführen. Den bestehenden Programm-/Modularbeitsplatz um Redaktionseinstieg und Rückweg ergänzen; kein erneuter Grundentwurf. +2. Den kompakten Standard und die Komponentenregeln auf diese Beispiele anwenden und abstimmen. Keine Designserie für jeden Fachobjekttyp. +3. Danach einen ausdrücklich beauftragten Pilotumbau an einem durchgängigen Medien-/Redaktionsablauf umsetzen und in der Anwendung abnehmen. Aus diesem Pilot werden die wiederverwendbaren Komponenten gewonnen. +4. Weitere Bereiche schrittweise auf diese Bausteine umstellen; nach jedem Teil Auftrag, Verhalten, Darstellung und Regressionen prüfen. Keine parallelen dauerhaften Alt- und Neu-Editoren für denselben Zweck. + +Diese Reihenfolge ist eine Empfehlung. In diesem Schritt werden ausschließlich Dokumentation und Regelvorlagen erstellt, keine Anwendung oder aktiven Agentenregeln umgebaut. diff --git a/docs/ux/verwaltung/11-cms-pruefbedarf.md b/docs/ux/verwaltung/11-cms-pruefbedarf.md new file mode 100644 index 0000000..b162379 --- /dev/null +++ b/docs/ux/verwaltung/11-cms-pruefbedarf.md @@ -0,0 +1,46 @@ +# CMS – vorhandene Stärken und weiterer Prüfbedarf + +**Stand: 19.11.2026.** Zusammenfassung des bereits vorgelegten Audits und gezielter Abgleich mit Projektberichten. Kein neuer abgeschlossener CMS-Audit und kein Nachweis, dass frühere Befunde unverändert bestehen. + +## Grenze des erneuten Zugriffs + +Bei dem Versuch, aus der vorhandenen Verwaltungssitzung „Seiten“ zu öffnen, wurde auf die Anmeldung umgeleitet. Die Sitzung ist abgelaufen. Es wurden keine Anmeldedaten eingegeben, keine Inhalte geändert und keine Schreibabläufe geprüft. Die gespeicherte [Zugriffsaufnahme](audit/cms-nachpruefung/01-anmeldung-erforderlich.png) zeigt ausschließlich diese Grenze, keine aktuelle CMS-Oberfläche. + +## Was erhalten bleiben sollte + +Der bisherige Audit zeigte echte Widgetdarstellung, visuelle Abschnittsstruktur, Drag-and-drop, eine kompakte eingeklappte Struktur, suchfähige Bildwahl mit Website-Status sowie Gerätevorschau und Revisionen. Das sind geeignete Grundlagen für den weiteren Umbau. CMS muss dafür nicht durch ein neues Framework ersetzt werden. + +## Priorisierte Befunde und Prüffragen + +| Thema | Bisheriger Beleg und Einordnung | Konsequenz für den Entwurf | +|---|---|---| +| Zu viel Strukturmechanik | Audit UX-09, B15/B19: Abschnitt, Raster, Platz, Gestaltung und Widgetrahmen sind tief verschachtelt; der eingeklappte Zustand ist wesentlich kompakter | Strukturübersicht als Orientierung nutzen; nur den gewählten Inhalt und dazu passende Einstellungen vertieft bearbeiten | +| Lange Widgetdialoge | B16: Inhalt, Medien und Darstellung sinnvoll getrennt, aber lange Dialoginhalte und zusätzliche Vorschau weiter unten | Bearbeitungsfläche und Vorschau gezielt organisieren; unnötiges Scrollen und konkurrierende Vorschauflächen reduzieren | +| Noch keine gemeinsame Auswahlinteraktion | UX-06, B13/B17/B38: visuelle CMS-Bildwahl ist besser als reine Radioliste, verhält sich aber anders als andere Medienpicker | Den vereinbarten gemeinsamen Picker mit dem zulässigen CMS-Kontext wiederverwenden; Website-Status erhalten | +| Übernommene und lokale Angaben | Redaktionelle Informationsbasis und Nutzeranforderung: CMS darf zentrale Angaben lokal überschreiben. Keine neue aktuelle Bedienprüfung | Quelle, wirksamer Wert und Widgetabweichung gezielt prüfen und verständlich gestalten; keine Aussage, dies sei im CMS erneut als konkreter Fehler beobachtet | +| Entwurf, Vorschau und öffentliche Revision | B18/B19 zeigten bereits benannte Revision und unveröffentlichten Zustand. Aktuelle Übergänge wurden nicht erneut geprüft | Gute Kennzeichnung erhalten; Rückmeldungen und Handlungen auf den tatsächlich gezeigten beziehungsweise veröffentlichten Stand beziehen | + +### Dokumentierte Korrektur nicht als aktuellen Fehler wiederholen + +Der [Abschnittsbericht vom 17.11.2026](../../analysen/cms-abschnitte-bericht-2026-11-17.md) beschreibt einen früheren Ablauf, bei dem „Übernehmen → Veröffentlichen“ ohne vorheriges Speichern die zuletzt gespeicherte Revision veröffentlichte. **Derselbe Bericht dokumentiert die Korrektur:** Veröffentlichen speichert zuerst den aktuellen Stand und veröffentlicht diesen; Verlassen mit offenen Eingaben wird gewarnt. Dieser frühere Fehler wird hier nicht als weiterhin bestehend behauptet. Der spätere reale Ablauf ist bei der Umsetzung erneut zu prüfen. + +Der Bericht nennt außerdem Vorschauunterschiede bei Abschnittsflächen und Einschränkungen der Widgetbreiten. Spätere adaptive Widgets und Medienanbindung haben den Stand weiter verändert. Diese Angaben bleiben gezielte Nachprüffragen, keine ungeprüfte aktuelle Mängelliste. Fehlende globale Abschnitte oder Vorlagen sind separate Funktionsfragen und werden nicht allein für einen UX-Umbau als zusätzliche Pflichtfunktionen eingeführt. + +## Nächster repräsentativer CMS-Ablauf + +Nach erneutem Zugang: eine bestehende Seite öffnen, Struktur überblicken, einen Text ändern, ein Präsentationsmedium über die gemeinsame Auswahl zuordnen, Reihenfolge ändern, Vorschau prüfen und den Veröffentlichungsumfang verstehen. Vor schreibender Umsetzung wird der konkrete Testumfang festgelegt. Die Gestaltung wird an diesem Ablauf entwickelt, statt für jeden Widgettyp einen unabhängigen Editor zu entwerfen. + +Dabei erhalten alle Widgettypen denselben Bearbeitungsrahmen; ihre wirklich unterschiedlichen Inhalte werden innerhalb dieses Rahmens bedient. Abschnittsgestaltung, Inhaltsbearbeitung und Seitenmetadaten sind gezielt erreichbar. Die öffentliche Darstellung bleibt ausgabegerecht und wird nicht durch ein Verwaltungsraster ersetzt. + +## Weiterführung im Design + +[Dokument 12](12-cms-seiteneditor-entwurf.md) bewahrt den ersten Vergleich und enthält die darauf aufbauende Weiterentwicklung mit breitem Seitenaufbau und großen Abschnitts-/Bausteinkonfiguratoren, Bildreferenzen und vorgeschlagenen CMS-Abnahmefällen. Die Entwürfe verwenden vorhandene Auditbilder und Dokumentation. Die bekannte Zugriffsgrenze bleibt bestehen; neue Schreibabläufe oder ein aktueller vollständiger CMS-Audit sind dadurch nicht nachgewiesen. + +## Quellen und Status + +- [Vorliegender Auditbericht](audit/UX-Audit.md), insbesondere UX-06, UX-09 und UX-14. +- [B14–B19 im Belegkatalog](audit/Belege.md), damalige CMS-Aufnahmen, keine neuen Aufnahmen dieser Nachprüfung. +- [Redaktionelle Informationsbasis](../../architektur/redaktionelle-informationsbasis.md). +- [CMS-Abschnitte, Bericht vom 17.11.2026](../../analysen/cms-abschnitte-bericht-2026-11-17.md). +- [Zentrale CMS-Medienverwaltung, Bericht vom 19.11.2026](../../analysen/cms-medienverwaltung-bericht-2026-11-19.md). +- [Vorschlag zum gemeinsamen Verwaltungsstandard](10-verwaltungsstandard-entwurf.md). diff --git a/docs/ux/verwaltung/12-cms-seiteneditor-entwurf.md b/docs/ux/verwaltung/12-cms-seiteneditor-entwurf.md new file mode 100644 index 0000000..1c37530 --- /dev/null +++ b/docs/ux/verwaltung/12-cms-seiteneditor-entwurf.md @@ -0,0 +1,222 @@ +# CMS-Seiteneditor – Anordnungen und gemeinsame Bedienregeln + +> **Aktualisierung 19.11.2026:** Die gemeinsame Designrichtung reicht für den Umbau aus. Maßgeblich ist jetzt [Dokument 14 – verbindlicher Verwaltungsstandard](14-verwaltungsstandard.md), ergänzt durch den [konkreten Umbauauftrag](15-umbauauftrag.md). Frühere allgemeine Hinweise auf ausstehende Detailabstimmungen sind unten als Arbeitsverlauf erhalten; sie sind keine weitere pauschale Startbedingung. Offene Geschäftsfragen bleiben abgegrenzt. Die Anwendung wurde durch diese Dokumentation nicht verändert. + +**Stand: 19.11.2026. Status: weiterentwickelter Vorschlag mit drei zusammengehörigen Arbeitszuständen, noch abzustimmen.** Die ersten drei Anordnungen bleiben als ursprünglicher Vergleich erhalten; die Einzelbearbeitung allein bildet den Seitenaufbau nicht ausreichend ab. Kein neuer Live-Audit, kein Implementierungsauftrag und keine Abnahme der aktuellen CMS-Oberfläche. Die bekannten Stärken bleiben Grundlage; Regeln und CMS-Prüffälle sind vorgeschlagene Konkretisierungen. + +## Geltung: Bearbeitung einer einzelnen Seite + +Dieses Dokument gestaltet den Aufbau und die Konfiguration einer einzelnen CMS-Seite. Der übergeordnete Arbeitsplatz für gesamten Seitenbestand, Menübereiche, Reihenfolge und Sichtbarkeit steht in [Dokument 13](13-webpraesenz-verwaltung-entwurf.md). Die vier zuletzt sichtbaren Bildausgaben sind drei Arbeitszustände plus Korrektur der Abschnittsskizze, keine vier unterschiedlichen Konfigurationsbereiche. + +## Aufgabe und Grundlage + +Eine vorhandene Seite überblicken, einen Baustein auswählen, seinen Inhalt ändern, Medien zuordnen, die Anordnung kontrollieren und gezielt eine Seitenrevision veröffentlichen. Die Redaktion soll dazu nicht ständig Abschnitt, Raster, Platz, Widgetrahmen und Konfigurationsdialoge gleichzeitig bearbeiten müssen. + +Grundlage sind die bestehenden CMS-Funktionen, die zuvor aufgenommenen Auditbilder B15, B16, B18 und B19 und der bereits gewählte Verwaltungsrahmen. Der erneute Zugriff erforderte Anmeldung; diese Grenze ist in [Dokument 11](11-cms-pruefbedarf.md) erhalten. Die folgende Entwurfsarbeit ist keine Behauptung eines erneut geprüften Iststands. + +Das vorhandene Modell **Seite → Abschnitte → Plätze → Baustein** sowie Registry, zugelassene Raster, Revisionen, zentrale Medienreferenzen und Renderwege bleiben erhalten. Kein neues CMS, kein freier Zeicheneditor und kein neuer allgemeiner Freigabeprozess. + +## Weiterentwicklung nach der Raster- und Konfigurationsrückmeldung + +Der Auftraggeber hat auf die fehlende Erkennbarkeit des Vierer-Rasters, nebeneinanderliegender Karten mit unterschiedlichen Größen sowie den Platzbedarf der Abschnitts- und Bausteineinstellungen hingewiesen. Die alleinige Einzelbearbeitung aus dem früheren Entwurf 3 reicht deshalb als CMS-Gesamtreferenz nicht aus. Die rechte Spalte ist keine Vorgabe für die gesamte Konfiguration. + +Der neue Vorschlag verbindet eine breite Seitenarbeitsfläche mit zwei großzügigen Konfigurationskontexten. Die folgenden Bilder sind **zusammengehörige Zustände eines Vorschlags**, keine drei Alternativen zur Einzelwahl. Die Arbeitsaufteilung ist vorgeschlagen, noch nicht abschließend bestätigt. + +### Seitenaufbau + +![Seitenaufbau mit sichtbaren Anteilen 1+1+2](bilder/cms-weiterentwicklung-seitenaufbau-v1.png) + +Die Seite nutzt die verfügbare Arbeitsbreite. Im Beispiel belegen Themenkarte und Programmkarte je eine Einheit, Bild und Text zwei Einheiten. Natürliche Höhen bleiben im Zusammenhang sichtbar. „Abschnitt gestalten“ öffnet die Gestaltung des umgebenden Abschnitts. „Konfigurieren“ am Baustein öffnet dessen eigenen Konfigurationskontext. Eine Strukturansicht kann zusätzlich der Navigation dienen; sie ersetzt die sichtbare Anordnung nicht. + +### Abschnitt gestalten + +![Großzügige Abschnittskonfiguration mit Raster und Abständen](bilder/cms-weiterentwicklung-abschnitt-v1.png) + +Der Abschnitt erhält ausreichend Fläche für seine Gestaltung und eine verkleinerte Vorschau. Der Kontext gehört zum laufenden Seitenentwurf. Eine schmale dauerhafte Seitenleiste ist dafür nicht erforderlich. + +| Abschnittsangabe | Ort und Bedeutung | +|---|---| +| Raster | Grafische Wahl der vorhandenen Muster 4, 2+2, 1+3, 3+1, 1+2+1, 1+1+1+1, 1+1+2, 2+1+1; belegte Plätze und gültige Breiten erhalten | +| Inhaltsbreite | Lesebereich, Standard, Breit oder Vollbreite nach bestehender Vorgabe; nicht mit der Zahl der Rastereinheiten verwechseln | +| Hintergrund | Standard, helle/dunkle Markenfläche, Markenakzent oder Hintergrundbild | +| Bildbezogene Abschnittsgestaltung | Bei Hintergrundbild: gemeinsamer Medienbestand, Fokus und Überlagerung; nur bei Bedarf eingeblendet | +| Abstand oben | Eigenständiger vorhandener Wert | +| Abstand unten | Eigenständiger vorhandener Wert | +| Widget-Abstand | Eigenständiger Abstand zwischen den Plätzen, nebeneinander und gestapelt | +| Trenner | Vorhandene Auswahl für den Abschluss beziehungsweise Übergang des Abschnitts | + +Die drei Abstände besitzen die Stufen Kein Abstand, Kompakt, Normal und Großzügig. Die frühere kombinierte Einstellung „oben und unten“ samt zusätzlicher Überschreibung wird nicht wieder eingeführt. Die erste generierte Rasterskizze für „4“ war falsch und wurde korrigiert: **4 bedeutet ein einziger Platz voller Breite; 1+1+1+1 bedeutet vier getrennte Plätze.** Nur die korrigierte Aufnahme ist gültige Referenz. + +### Baustein konfigurieren + +![Großer Bausteinkonfigurator mit zentraler Quelle](bilder/cms-weiterentwicklung-baustein-v1.png) + +Der Bausteinkonfigurator nutzt dieselbe großzügige Grundbedienung für die registrierten Bausteintypen. Die Inhalte stammen aus deren vorhandenen Schemata; es wird nicht pro Typ eine neue Editorarchitektur entwickelt. Einfache Angaben können kompakt bleiben. Umfangreiche Medien-, Darstellungs- und Inhaltsangaben müssen nicht in der Übersicht oder einer schmalen rechten Spalte gleichzeitig Platz finden. + +| Bereich | Aufgabe | +|---|---| +| Quelle und Inhalt | Bei Fachobjektbezug Quelle auswählen, wirksame zentrale Angaben anzeigen, vorhandene lokale Abweichungen gezielt bearbeiten. Reine Seitenbausteine besitzen gegebenenfalls ihre eigenen Inhalte | +| Medien | Zentrale Präsentationsmedien und gegebenenfalls eine zulässige lokale Medienabweichung; gemeinsamer Picker, Website-Status und vorhandene Bild-/Ausschnittsoptionen | +| Darstellung | Nur die tatsächlich für den Bausteintyp verfügbaren Varianten, Höhen, Bildformate, Anzeigeoptionen und weitere bestehende Einstellungen | + +Die Abbildung zeigt bewusst „Darstellung“. Die Programmkarte bietet im gelesenen Bestand natürliche Höhe oder Angleichen an die Zeile, Anpassend oder Bild immer über dem Text, Bildformat/-darstellung, Überschriftenebene und weitere Anzeigeoptionen. Diese Werte sind kein universeller Konfigurationsumfang aller Bausteine. + +**Datenfluss:** Fachobjekt → gemeinsame redaktionelle Angaben/Präsentationsmedien → referenzierender CMS-Baustein → seine Darstellung im Abschnitt. Die Auswahl der Quelle erzeugt keine Kopie ihrer Beschreibung. „Redaktionsmanager öffnen“ bearbeitet die Quelle; eine lokale Kartenabweichung bearbeitet nur diese Verwendung. Die Rückkehr hält offene CMS-Eingaben und Arbeitsstelle. Eine Quellenänderung kann außerhalb des aktuellen Seitenentwurfs bereits direkt wirksam sein und muss so benannt bleiben. + +Beide Konfiguratoren führen über „Zur Seite“ zum Seitenaufbau zurück. Die aktuellen Eingaben bleiben im Seitenarbeitsstand. Es entsteht kein zusätzlicher fachlicher Freigabeweg; „Entwurf speichern“ benennt die ausdrückliche Speicherung des Seitenentwurfs. Das genaue Umgangsmodell mit offenem Konfigurator und Teilfehlern bleibt vor Umsetzung am bestehenden Editor zu prüfen. + +### Raster, Höhe und Vorschau korrekt verstehen + +Der vorhandene Vertrag hat höchstens vier **logische Einheiten** pro Abschnitt und bis zu vier Plätze. Platzbreiten entstehen aus dem gewählten Verhältnis, nicht aus einem freien Breitenfeld an jeder Karte. Die tatsächliche Containerbreite entscheidet über die responsive Darstellung. + +Höhen sind abhängig von Typ und Inhalt. Vorhandene Höhenoptionen sind Mindesthöhen, Proportionen oder Angleichung an die Abschnittszeile; Inhalte erhalten den notwendigen Platz. Daraus entsteht kein neues frei skalierbares Zeilen-/Masonry-System und kein Abschneiden langer Texte. Verschiedene Höhen bleiben möglich, solange nicht ausdrücklich eine vorhandene Angleichung gewählt wird. + +Eine verkleinerte Abschnitts-/Bausteinvorschau soll den vorgesehenen logischen Platzkontext darstellen und ihre Skalierung kenntlich machen. Ein bloß kleiner gemachter Vorschaucontainer darf nicht unerkannt einen anderen responsiven Zustand zeigen. Die neuen Bilder sind illustrative Arbeitszustände, kein Nachweis exakter Breiten, Breakpoints oder tatsächlicher Live-Vorschau. + +## Ursprünglicher Vergleich: gleiche Aufgabe in drei Anordnungen + +Alle Bilder zeigen die beispielhafte Seite „Prävention im Alltag“ mit drei Abschnitten: Einstieg; Training im Alltag mit Bild/Text und einer Programmkarte; Häufige Fragen. Bearbeitet wird die Programmkarte im zweiten Platz des zweiten Abschnitts. Die Überschrift stammt aus „Programm Abstand“, der Kurztext ist eine lokale Abweichung nur für diese Karte. + +Seitenname, Revision 12, Texte und Bilder sind Anschauungsmaterial. Sie beschreiben keinen tatsächlich festgestellten Datensatz der Testinstanz. Die Nummern entsprechen der Bildanzeige in diesem CMS-Vergleich und sind unabhängig von den früheren Vergleichen. + +| Entwurf | Arbeitsprinzip | Vorteil | Abzuwägende Grenze | +|---|---|---|---| +| 1 | Kompakte Struktur links, ausgewählter Baustein rechts | Überblick und fester Bearbeitungsort; folgt dem vertrauten Aufbauprinzip | Die sichtbare Seitenwirkung wird zusätzlich in einer Baustein- oder Seitenvorschau geprüft | +| 2 | Visuelle Seitenfläche mit Kontextinspektor | Baustein direkt auf der sichtbaren Seite auswählen und Änderung im Zusammenhang beurteilen | Weniger Raum für Einstellungen; lange Seiten benötigen weiterhin Navigation und Scrollen | +| 3 | Großzügige Einzelbearbeitung mit Rückweg zur Struktur | Viel Platz für Inhalt und Bausteinvorschau; weniger gleichzeitige Bedienelemente | Übersicht ist während der Einzelbearbeitung nicht dauerhaft sichtbar; verlässlicher Rückweg erforderlich | + +### Entwurf 1 + +![Kompakte Seitenstruktur mit festem Bearbeitungsbereich](bilder/cms-01-struktur-bearbeitung.png) + +### Entwurf 2 + +![Visuelle Seitenfläche mit Kontextinspektor](bilder/cms-02-seitenflaeche-inspektor.png) + +### Entwurf 3 + +![Einzelbearbeitung mit Bausteinvorschau und Rückweg](bilder/cms-03-einzelbearbeitung.png) + +Die folgenden ersten drei Bilder zeigen den ursprünglichen Vergleich. Sie sind keine vollständige Darstellung der nun vorgeschlagenen Aufteilung; insbesondere die frühere Einzelbearbeitung ist nur ein möglicher Teil des Gesamtarbeitsplatzes. + +## CMS-R01 · Seite, Arbeitsstand und öffentliche Revision + +Der Seitenkopf zeigt die bearbeitete Seite, ihren Speicherzustand und eine vorhandene öffentliche Revision als getrennte Aussagen. Eine ungespeicherte Eingabe ist noch keine gespeicherte Revision. Ein gesicherter Entwurf ist noch keine Veröffentlichung. + +Eine erkennbare Hauptaktion „Entwurf speichern“ sichert den benannten Seitenarbeitsstand. „Seitenvorschau“ und „Veröffentlichen …“ sind gezielt erreichbar. Die Gewichtung richtet sich nach der aktuellen Aufgabe; nicht alle Handlungen konkurrieren als gleich starke Schaltflächen. Seiteneinstellungen wie Adresse und SEO sowie Verlauf müssen direkt erreichbar bleiben, ohne den gesamten Seitenaufbau nach unten zu verdrängen. + +## CMS-R02 · Genau einen Bearbeitungsgegenstand erkennen + +Auswahl und Position des Bausteins sind klar. Abschnittsauswahl öffnet Abschnittseinstellungen, Bausteinauswahl dessen Inhalt, Medien und Darstellung. Der Fokus auf einen Baustein darf nicht wie eine gleichzeitige Bearbeitung aller Kinder des Abschnitts wirken. + +Auswählen, Aufklappen und Vorschau verändern den Seiteninhalt nicht. Abschnitts- und Bausteinidentitäten bleiben beim Bearbeiten und Verschieben erhalten; Kopieren erzeugt nach bestehender Regel eine neue Instanz, keine neue Kopie des referenzierten Fachobjekts. + +## CMS-R03 · Inhalt, Medien und Darstellung gezielt bearbeiten + +Der gemeinsame Bausteineditor zeigt die für den gewählten Typ relevanten Bereiche. Nicht jedes Widget erhält eine unabhängig entworfene Gesamtoberfläche. Gleichartige Felder, Medienauswahl, Herkunftshinweise und Darstellungsoptionen nutzen dieselben Komponenten. + +Die Varianten schlagen vor, Eingaben unmittelbar im laufenden Seitenentwurf zu halten. Ein Wechsel zwischen Bausteinen oder zurück zur Struktur verwirft sie nicht. Ein weiterer Pflichtschritt „Übernehmen“ pro Baustein soll entfallen, soweit dies innerhalb der vorhandenen Prüfregeln sinnvoll umsetzbar ist. Vorhandene Inhaltsvalidierung wird nicht abgeschwächt; Fehler werden am richtigen Baustein erklärt und Eingaben bleiben erhalten. Diese Änderung am Bearbeitungsablauf ist Entwurf, keine Behauptung über den jetzigen Editor. + +## CMS-R04 · Raster und Reihenfolge kontextbezogen behandeln + +Raster, Abschnittsfläche, Breite und Abstände erscheinen beim gewählten Abschnitt statt dauerhaft an jedem Abschnitt. Bereits belegte Plätze und gültige Widgetbreiten werden berücksichtigt. Ein Rasterwechsel darf keine Inhalte still entfernen. + +Abschnitt und Baustein haben unterscheidbare Bewegungsziele. Ziehen zeigt zulässige Ziele; eine Tastaturalternative ermöglicht dieselbe zulässige Änderung. Ein belegter Zielplatz darf nicht still überschrieben werden. Unzulässige Ziele werden verständlich erklärt, statt erst nach einer langen Folge weiterer Eingaben zu scheitern. Ob zusätzliche Austauschhandlungen benötigt werden, ist am Bestand abzugleichen; das Bild führt keine neue automatische Umverteilung ein. + +## CMS-R05 · Zentrale Angaben und lokale Abweichung + +Bei referenzierten Programmen, Modulen oder Medien zeigt die Bearbeitung das konkrete Quellobjekt und die wirksamen Werte. „Hier anpassen“ legt eine eigene Angabe für genau diese Bausteinverwendung an. „Wieder übernehmen“ macht die Rückkehr zum zentralen Wert nachvollziehbar. Quellenwerte und eigene Angaben dürfen nicht wie dieselbe ungeklärte Eingabe aussehen. + +„Redaktion öffnen“ bearbeitet dagegen das Quellobjekt im gemeinsamen Redaktionsmanager. Dessen direkt wirksame redaktionelle Speicherung kann auch bereits bestehende öffentliche Verwendungen aktualisieren. Der Hinweis „Lokale Änderungen gelten nur für diese Karte“ gilt ausschließlich für die lokalen Kartenfelder und darf keine Wirkungslosigkeit einer Quellenänderung vortäuschen. Preis, Kaufumfang und Rechte werden durch den Karteneditor nicht verändert. + +## CMS-R06 · Medien aus derselben gemeinsamen Auswahl + +Der Bereich Medien verwendet den vereinbarten visuellen Picker mit dem passenden CMS-Kontext. Referenzen bleiben erhalten; es entsteht keine weitere Bildablage pro Widget. Vorgaben aus der zentralen Präsentation und eine lokale Bildabweichung sind erkennbar, soweit der jeweilige Baustein dies unterstützt. + +Ein Medium ohne Website-Freigabe kann intern ausgewählt und mit Hinweis dargestellt werden, bleibt öffentlich aber nicht auslieferbar. Andere Widgetinhalte bleiben nach bestehender Regel erhalten. Verarbeitung, fehlende Ableitungen und Rücknahme der Freigabe erhalten konkrete Hinweise. Ein ungeeignetes Bild führt nicht zu einer künstlichen allgemeinen Freigabekette für sämtliche Seitentexte. + +## CMS-R07 · Bausteinvorschau, Arbeitsansicht und Seitenvorschau + +Die Bausteinvorschau prüft die konkrete Verwendung und ihren Abschnittskontext. Eine visuelle Arbeitsfläche ist eine Bearbeitungsansicht in verfügbarer Breite; sie ist keine ungekennzeichnete Zusage einer vollständigen 1440-Pixel-Ausgabe. Die Seitenvorschau verwendet den vorhandenen Seitenrenderer und die unterstützten Gerätegrößen. + +Jede Vorschau benennt ihren Datenstand. Gegebenenfalls sichtbare Abweichungen zwischen offenen Eingaben und gespeicherter Revision werden erklärt. Lokale Überschreibungen, fehlende Quellen und öffentlich nicht erlaubte Medien dürfen in der redaktionellen Kontrolle nicht kommentarlos verschwinden. Die Bilder belegen keine funktionale Live-Aktualisierung. + +## CMS-R08 · Veröffentlichen und Verlauf + +Es bleibt der kurze CMS-Veröffentlichungsweg. Der dokumentierte korrigierte Ablauf kann den aktuellen Seitenstand speichern und genau diesen veröffentlichen. Der Entwurf führt kein zwingendes zusätzliches Vorschalt-Speichern ein. Die auslösende Handlung und ihre Rückmeldung benennen den tatsächlich veröffentlichten Stand. + +Schlägt Speichern oder Veröffentlichen fehl, zeigt die Oberfläche den tatsächlichen Zustand, erhält die Eingaben und behauptet keinen Erfolg. Eine ältere Revision kann nach bestehenden Regeln geprüft und wiederhergestellt werden. Historische Revisionen werden nicht durch das bloße Öffnen umgeschrieben. Optionale Freigabeschritte erscheinen nur, wenn sie tatsächlich eingerichtet sind. + +## CMS-R09 · Rückkehr aus Redaktion und Einzelbearbeitung + +Beim Öffnen der Quellenredaktion bleiben offene CMS-Eingaben, ausgewählter Abschnitt/Baustein und Arbeitsstelle erhalten. Zurückkehren lädt nicht einfach die letzte gespeicherte Seite neu. Die Prinzipien UX-D23 und RED-R12 gelten entsprechend. + +Eine gespeicherte Quellenänderung darf nach Rückkehr in den relevanten Zusammenfassungen erscheinen. Der Seiteneditor darf sie später nicht durch alte Quellwerte überschreiben. Bestehende lokale Überschreibungen bleiben als solche erkennbar. Die seiteneigenen Eingaben werden durch Speichern der Quellenredaktion nicht heimlich mitgespeichert. + +Dasselbe gilt in Entwurf 3 für „Zur Seitenstruktur“: Der Rückweg hält den aktuellen Seitenarbeitsstand und die Auswahl. Er bedeutet weder Verwerfen noch Veröffentlichung. + +## CMS-R10 · Ein gemeinsamer Rahmen statt Einzelmasken + +Widgets behalten ihre fachlich unterschiedlichen Inhalte, verwenden aber denselben Auswahl-, Bearbeitungs-, Fehler- und Vorschau-Rahmen. Ein neues Widget benötigt seine registrierten Felder und Darstellung, nicht automatisch eine neue Editorarchitektur. Der vorhandene Registry-/Renderer-Vertrag wird vor einer Umsetzung geprüft und wiederverwendet. + +Die CMS-Anordnungen sind Teil des gemeinsamen Verwaltungsstandards. Programm-/Modulaufbau wird dafür nicht neu gestaltet; dort werden nur Redaktionseinstieg, Rückweg und gemeinsame Komponenten ergänzt. + +## CMS-R11 · Übersicht und Konfiguration haben unterschiedliche Platzbedürfnisse + +Der Seitenaufbau muss Rasteranteile, Nachbarschaft und die Wirkung unterschiedlicher Bausteinhöhen erkennen lassen. Abschnittsgestaltung und Bausteinkonfiguration erhalten bei Bedarf einen eigenen großen Arbeitskontext mit demselben Rückkehr- und Speichermodell. Keine dauerhafte rechte Spalte wird als universelle Pflicht für alle Felder festgelegt. Eine einzelne isolierte Karte genügt nicht als Referenz für den vollständigen Seitenaufbau. + +## CMS-R12 · Zentrale Daten und bausteinspezifischer Umfang + +Fachobjektgebundene Bausteine verwenden die gemeinsame Redaktion als Quelle. Lokale Inhalts-/Medienabweichungen bleiben ausdrücklich benannt. Reine Seitenelemente werden nicht künstlich zu Lizenzartikeln oder anderen Fachobjekten gemacht. Der Konfigurator zeigt die vorhandenen typabhängigen Optionen aus dem Registry-Vertrag. Neue Typen nutzen diesen Rahmen; bestehende Einstellungen dürfen bei der Vereinfachung weder verschwinden noch durch allgemeine Felder anderer Typen ersetzt werden. + +## Vorgeschlagene CMS-Abnahmefälle + +| ID | Aufgabe | Erwartetes Ergebnis | +|---|---|---| +| CMS-01 | Bestehende Seite öffnen | Speicherzustand und öffentliche Revision unterscheidbar; relevante Seitenstruktur erfassbar | +| CMS-02 | Abschnitt und enthaltenen Baustein auswählen | Gegenstand und Position klar; passende Einstellungen statt gleichzeitiger Konfiguration aller Ebenen | +| CMS-03 | Lokalen Kurztext ändern und zwischen Bausteinen wechseln | Eingaben im laufenden Seitenentwurf erhalten; Quelle unverändert | +| CMS-04 | Zentralen Wert ansehen, lokal überschreiben und wieder übernehmen | Wirksamer Wert und Geltungsbereich verständlich; keine willkürliche Auflösung | +| CMS-05 | Zentrale Redaktion öffnen und mit offenen CMS-Eingaben zurückkehren | Auswahl, Eingaben und Arbeitsstelle erhalten; Speicherung im richtigen Umfang | +| CMS-06 | Nach gespeicherter Quellenänderung den Seitenentwurf sichern | Keine veraltete Quellenüberschreibung; lokale Abweichungen bleiben nachvollziehbar | +| CMS-07 | Bild über den gemeinsamen Picker zuordnen oder austauschen | Richtiger Kontext, Referenz und Website-Status; kein zusätzlicher Medienbestand | +| CMS-08 | Öffentlich nicht erlaubtes oder noch verarbeitetes Medium verwenden | Konkreter Hinweis in der Redaktion; tatsächliche öffentliche Ausgabe korrekt erklärt | +| CMS-09 | Abschnittsraster ändern | Bestehende Inhalte erhalten oder eindeutige zulässige Folgehandlung; kein stiller Verlust | +| CMS-10 | Abschnitt/Baustein ziehen und per Tastatur bewegen | Zulässige Ziele, richtige Reihenfolge und nachvollziehbare Auswahl; kein stilles Überschreiben | +| CMS-11 | Vorschau und Gerätegröße wechseln | Datenstand, Ausgabe und Abschnittskontext benannt; Arbeitsansicht nicht mit echter Gerätevorschau verwechselt | +| CMS-12 | Validierungs- oder Speicherfehler bearbeiten | Fehler am betroffenen Gegenstand, Eingaben erhalten; tatsächlicher Speicherumfang und Zustand klar | +| CMS-13 | Aus dem aktuellen Editorstand veröffentlichen | Tatsächlich beabsichtigter Stand gespeichert/veröffentlicht; kein irreführender Erfolg und keine zusätzliche neue Freigabekette | +| CMS-14 | Eine ältere Revision prüfen und wiederherstellen | Bestehende Historie und Revisionen erhalten; Wirkung eindeutig | +| CMS-15 | Dialog/Picker schließen und Editor per Tastatur bedienen | Fokus und Rückkehr korrekt; keine unerreichbaren Kernaktionen | +| CMS-16 | Einzelbearbeitung verlassen oder Quellenredaktion erneut öffnen | Laufender Arbeitsstand erhalten; kein erzwungenes Verwerfen, keine heimliche Speicherung | +| CMS-17 | Raster 4 und 1+1+1+1 vergleichen | Ein breiter Platz gegenüber vier schmalen Plätzen klar; keine verwechselten Symbole oder neue Rasterbedeutung | +| CMS-18 | Abschnitt mit 1+1+2 und verschiedenen Bausteinhöhen bearbeiten | Nachbarn, Platzanteile und natürliche/gewählte Höhen im Seitenzusammenhang erkennbar | +| CMS-19 | Abschnitt gestalten | Sämtliche vorhandenen Abschnittsoptionen erreichbar; drei unabhängige Abstände, Bildoptionen kontextbezogen | +| CMS-20 | Umfangreichen Baustein konfigurieren | Großzügiger gemeinsamer Konfigurator; vollständige vorhandene typabhängige Inhalte, Medien und Darstellung erreichbar | +| CMS-21 | Programmkarte mit zentralen Angaben verwenden | Referenzen und wirksame Werte statt unnötiger Kopien; lokale Abweichung und Quellenbearbeitung getrennt | +| CMS-22 | Vorschau bei unterschiedlicher Platz-/Abschnittsbreite prüfen | Richtiger logischer und responsiver Kontext; Skalierung und tatsächliche Ausgabe nicht verwechselt | +| CMS-23 | Konfigurator wechseln, zurückkehren und Entwurf speichern | Seiteneingaben und Auswahl erhalten; keine zusätzliche Freigabestrecke oder versteckter Datenverlust | + +Die Fälle sind Prüfziele für eine spätere beauftragte Umsetzung. Es wurden keine neuen schreibenden CMS-Abläufe oder Anwendungstests ausgeführt. + +## Grenzen der Bilder und offene Details + +- Die Weiterentwicklung mit Seitenaufbau und großen Konfiguratoren ist vorgeschlagen, noch nicht abschließend bestätigt. Die ersten drei Richtungen sind historische Vergleichsbilder. Seiteninhalt, Bildmotive und Revisionsnummern sind Beispiele; keine neuen öffentlichen Produktassets oder verbindlichen Texte. +- In Entwurf 1 ist auch der umgebende Abschnitt blau gerahmt. Die spätere Auswahlkennzeichnung muss eindeutig einen aktiven Gegenstand erkennen lassen. +- Übernommene Überschriften sehen in den Bildern teilweise wie gewöhnliche Eingabefelder aus. Eine tatsächliche Implementierung muss Lesen, lokale Übernahme und direkte Quellenbearbeitung klar trennen. +- Entwurf 3 wiederholt Hinweise zur lokalen Wirkung und bietet zwei Zugänge zur Seitenvorschau. Dies ist bei Auswahl zu straffen; nicht als verbindliche Wiederholung nachbauen. +- Bewegungsalternativen liegen teilweise nur in Aktionsmenüs beziehungsweise sind nicht visualisiert. Die Bedienregeln verlangen ihre tatsächliche Nutzbarkeit, nicht eine bestimmte dauerhafte Buttonmenge. +- Exakte Auswahlkennzeichnung, Spaltenbreiten, schmale Fenster, längere Seiten, Medien-/Darstellungsregister und Veröffentlichungsrückmeldung sind nach Wahl weiter auszuarbeiten. +- Die Darstellung der Register, Direkteingabe ohne zusätzlichen Übernahmeschritt und Vorschauaktualisierung ist am vorhandenen Editor technisch zu prüfen. Keine Änderung des Fachmodells ist dadurch freigegeben. + +## Quellen und Bezug + +- [CMS-Prüfbedarf und Zugriffsgrenze](11-cms-pruefbedarf.md). +- [CMS-Auditbelege](audit/Belege.md), B15/B16/B18/B19. +- [Vorhandener CMS-Vertrag](../../architektur/cms-widget-registry.md). +- [Dokumentierter CMS-Abschnittseditor](../../analysen/cms-abschnitte-bericht-2026-11-17.md). +- [Gemeinsame Redaktion](09-redaktionsarbeitsplatz-entwurf.md). +- [Verwaltungsstandard](10-verwaltungsstandard-entwurf.md). +- [Prompts des ersten Vergleichs](generierung/cms-prompts.md). +- [Prompts und Rasterkorrektur der Weiterentwicklung](generierung/cms-konfiguration-weiterentwicklung.md). +- [Bestehender Layoutvertrag](../../architektur/cms-widget-registry.md), §§11–13; zusätzlich rein lesender Abgleich mit SectionLayouts, SectionStyle, WidgetType, ProgramCardWidget und PremiumCardWidget im vorhandenen Code. diff --git a/docs/ux/verwaltung/13-webpraesenz-verwaltung-entwurf.md b/docs/ux/verwaltung/13-webpraesenz-verwaltung-entwurf.md new file mode 100644 index 0000000..66e1380 --- /dev/null +++ b/docs/ux/verwaltung/13-webpraesenz-verwaltung-entwurf.md @@ -0,0 +1,170 @@ +# Webpräsenz verwalten – Seiten, Menüs und übergreifender Rahmen + +> **Aktualisierung 19.11.2026:** Die gemeinsame Designrichtung reicht für den Umbau aus. Maßgeblich ist jetzt [Dokument 14 – verbindlicher Verwaltungsstandard](14-verwaltungsstandard.md), ergänzt durch den [konkreten Umbauauftrag](15-umbauauftrag.md). Frühere allgemeine Hinweise auf ausstehende Detailabstimmungen sind unten als Arbeitsverlauf erhalten; sie sind keine weitere pauschale Startbedingung. Offene Geschäftsfragen bleiben abgegrenzt. Die Anwendung wurde durch diese Dokumentation nicht verändert. + +**Stand: 19.11.2026. Status: Präferenz für Entwurf 1 und 3 erfasst; Kombination vorgeschlagen, noch nicht bestätigt; keine Implementierung.** Der Auftraggeber hat die fehlende Ebene oberhalb des einzelnen Seiteneditors benannt: Seitenreihenfolge, Menüs, versteckte Seiten und die Verwaltung der gesamten Webpräsenz. Diese Anforderungen werden hier bewahrt; die vorgeschlagene Aufteilung ist anhand der drei neuen Alternativen noch abzustimmen. + +## Einordnung der bisherigen Ansichten + +Die jüngste CMS-Serie zeigt drei zusammengehörige Arbeitszustände: Seitenaufbau, Abschnitt gestalten und Baustein konfigurieren. Die Abschnittskonfiguration wurde wegen einer falschen Rasterskizze ein zweites Mal angezeigt. Daher waren vier Bildausgaben sichtbar; die korrigierte Aufnahme ersetzt die erste Abschnittsaufnahme. + +Diese Serie beschreibt die Bearbeitung **einer Seite**. Sie ist kein vollständiger Konfigurator der Webpräsenz. Die neue übergeordnete Aufgabe nutzt die gemeinsamen Übersichts-, Auswahl-, Sortier- und Bearbeitungsmuster und benötigt kein zweites CMS. + +```mermaid +flowchart TB + W["Webpräsenz verwalten"] --> P["Seiten · Bestand, Adressen, öffentlicher Stand"] + W --> N["Menüs · Reihenfolge, Unterpunkte, Sichtbarkeit"] + P --> E["Einzelne Seite bearbeiten"] + E --> A["Abschnitt gestalten / Baustein konfigurieren"] + A --> R["Bei Fachobjektbezug: zentrale Redaktion"] +``` + +## Vorhandene Grundlage und Prüfgrenze + +Rein lesend abgeglichen wurden `Page`, `PageResource`, `NavigationItem`, `NavigationItemResource`, `SiteNavigation` und `PageController` sowie der CMS-Vertrag §10. Das ist kein neuer UI-Audit und kein Test der tatsächlich gespeicherten Änderungen. + +- **Seiten:** Pfad, Revisionen, eine veröffentlichte Revision und Zuordnungen zu Navigationspunkten. Die gelesene Seitenverwaltung sortiert nach letzter Bearbeitung; eine eigene redaktionelle Eltern-/Sortierhierarchie der Seiten ist in diesen Modellen nicht belegt. +- **Navigation:** eigene Beschriftung, interne Seitenreferenz oder Adresse, Platzierung, Sortierung, Sichtbarkeit und übergeordneter Menüpunkt. +- **Menübereiche:** Hauptnavigation, Fußbereich Service, Kontakt und Rechtliches. Eine Untermenüebene ist im Hauptmenü vorhanden; daraus folgt kein beliebig tiefer Seitenbaum. +- **Startseite:** Der vorhandene öffentliche Controller liest die Seite unter `/`. Eine frei konfigurierbare Startseitenzuweisung ist durch diesen Abgleich nicht belegt. +- **Sitemap:** Der gelesene Controller berücksichtigt veröffentlichte Seiten unabhängig von Menüeinträgen. Ausblenden im Menü allein nimmt eine Seite daher nicht aus dieser Auswahl. + +Der vorhandene Audit enthält B35/B36 zur bisherigen Navigationsverwaltung. Er belegt getrennte Ansichten, keinen bereits abgenommenen gemeinsamen Webpräsenz-Arbeitsplatz. Die bekannte abgelaufene Anmeldung bleibt Grenze einer erneuten Live-Prüfung. + +## Drei Anordnungen zur Auswahl + +Diese Bilder sind **drei alternative Bedienmodelle desselben Webpräsenz-Arbeitsplatzes**. Anders als die jüngste Serie zur Einzel-Seitenbearbeitung zeigen sie keine aufeinanderfolgenden Konfigurationszustände. Die Nummern entsprechen der tatsächlichen Anzeigereihenfolge im Gespräch. Der Auftraggeber bevorzugt Entwurf 1 und 3. Eine alleinige Variante oder deren genaue Kombination ist noch nicht abschließend gewählt. + +Alle verwenden denselben Verwaltungsrahmen und dieselbe illustrative Aufgabe: Im Hauptmenü den Unterpunkt „Prävention“ bearbeiten, dessen Ziel die veröffentlichte Seite „Prävention im Alltag“ ist. Der Bestand umfasst zehn Beispielseiten, das Hauptmenü sechs Einträge einschließlich eines Unterpunkts und eines ausgeblendeten Eintrags. Die Beispielseite „Neues Angebot“ hat nur einen Entwurf. Dies sind keine neu erhobenen Instanzdaten. + +| Variante | Bedienung und Stärke | Abwägung | +|---|---|---| +| 1 – Register und fester Menüeditor | Seiten und Menüs als getrennte Aufgaben; Menüstruktur links, ausgewählter Eintrag rechts. Ruhiger, ortsfester Detailbereich beim Wechsel zwischen Einträgen | Für den vollständigen Seitenbestand ist ein Registerwechsel nötig; ein breiter Detailbereich bleibt auch bei wenigen Eigenschaften belegt | +| 2 – Seitenbestand und Menü nebeneinander | Seitenzustände und Menüzuordnungen bleiben gleichzeitig sichtbar; direkte Zuordnung und Prüfung ohne Wechsel in die Seitenübersicht | Höhere Informationsdichte und weniger Breite pro Bereich; ein Eintrag wird innerhalb der rechten Liste aufgeklappt | +| 3 – Breite Menüliste mit direkter Bearbeitung | Ganze Breite für Reihenfolge, Ziele und Sichtbarkeit; Bearbeitung unmittelbar am ausgewählten Eintrag. Wenig dauerhaftes Rahmengerüst | Aufklappen verändert die Listenhöhe; beim Wechsel kann sich die Position verschieben. Vollständiger Seitenbestand liegt im eigenen Register | + +### 1 – Getrennte Register mit festem Menüeditor + +![Webpräsenz: Register und fester Menüeditor](bilder/webpraesenz-01-register-menueeditor.png) + +### 2 – Seitenbestand und Menü nebeneinander + +![Webpräsenz: Seiten und Menü nebeneinander](bilder/webpraesenz-02-seiten-menues.png) + +### 3 – Breite Menüliste mit direkter Zeilenbearbeitung + +![Webpräsenz: direkte Bearbeitung in der Menüliste](bilder/webpraesenz-03-direkt-menue.png) + +### Aussagekraft und Grenzen + +- Generierte Zielbilder, keine implementierten Screens oder neuen Live-Auditbelege. [Prompts und Referenzen](generierung/webpraesenz-prompts.md) sind nachvollziehbar abgelegt. +- In Variante 1 und 2 erscheinen Auf-/Ab-Aktionen beim einzigen Unterpunkt aktiv. In der Umsetzung sind Bewegungen ohne gültiges Ergebnis zu deaktivieren; sie dürfen nicht unbemerkt eine Ebene wechseln. Variante 3 zeigt die deaktivierte Darstellung. +- Eine zusätzliche Bereichsauswahl am Eintrag wie in Variante 1 ist kein zweiter unabhängiger Speicherbereich. Ein Wechsel ins Fußmenü muss die Folgen für einen vorhandenen Unterpunkt erklären; die genaue Anordnung bleibt abzustimmen. +- „Website-Rahmen“ markiert eine noch zu klärende Aufgabe. Das Register beweist keine vorhandene freie Theme-, Startseiten- oder globale Abschnittskonfiguration. OFF-25 bleibt offen. +- Zielwechsel, Rückwege, Vorschau und offene Änderungen sind Bedienabsichten. Die Bilder belegen weder funktionierende Zustandserhaltung noch Tastaturbedienung, Rechteprüfung oder eine geprüfte öffentliche Ausgabe. + +## Rückmeldung und vorgeschlagene Weiterführung + +**Rückmeldung des Auftraggebers:** Entwurf 1 und 3 gefallen. Bei Entwurf 3 wird zusätzlicher Scrollaufwand durch die Inline-Konfiguration bei vielen Seiten gesehen; zugleich erscheint er für kleinere Monitore gut geeignet. Entwurf 2 wurde nicht als bevorzugte Richtung genannt. Daraus wird weder eine formale Ablehnung noch eine bestätigte Kombination abgeleitet. + +**Empfehlung zur Abstimmung:** denselben Menüeditor abhängig von der tatsächlich verfügbaren Fensterbreite anordnen. Bei genügend Platz kompakte Menüliste links und ortsfester Detailbereich rechts nach Entwurf 1. Bei schmalerem Fenster dieselben Felder und Aktionen innerhalb genau eines aufgeklappten Eintrags nach Entwurf 3; dort bei Bedarf untereinander statt nebeneinander. Die Bildschirmdiagonale allein entscheidet nicht über den Wechsel. Eine feste Pixelgrenze wird erst anhand der lesbaren Inhalte und realer Fenstergrößen festgelegt. + +Zur Begrenzung des Scrollaufwands werden folgende Detailregeln vorgeschlagen: + +- Höchstens ein Eintrag ist aufgeklappt. Das Öffnen eines anderen Eintrags erhält alle offenen Änderungen des bisherigen Eintrags. +- Zugeklappte Zeilen bleiben kompakt. Menübereich, Suche und Speicheraktion sind gut erreichbar; eine Suche bewahrt die erforderliche Elternzuordnung und erzeugt keine irreführende neue Reihenfolge. +- Beim Wechsel der Anordnung bleiben ausgewählter Eintrag, offene Eingaben und Orientierung erhalten. Beim Öffnen, Schließen und Zurückkehren bleibt der bearbeitete Eintrag im Blick, ohne überraschende Sprünge oder pauschales Scrollen zum Seitenanfang. +- Umordnen bleibt auf die vollständige Reihenfolge des gewählten Menüs bezogen. Bei einer gefilterten Teilliste wird es gesperrt oder in eine eindeutige vollständige Sortieransicht geführt; ausgeblendete Treffer werden nicht still übersprungen. + +Die Länge der Menüliste hängt von den Einträgen des gewählten Menübereichs ab. Der gesamte Seitenbestand bleibt im eigenen Register; Seiten ohne Menüeintrag verlängern die Menüliste nicht. Das beseitigt den vom Auftraggeber benannten Scrollbedarf nicht, grenzt aber die betroffene Liste ein. + +**Status:** Präferenz ist dokumentiert. Anpassung an die Fensterbreite, Verhalten beim Aufklappen und Scrollregeln sind Empfehlungen zur weiteren Abstimmung, kein bereits freigegebener Verwaltungsstandard oder Implementierungsauftrag. Zu prüfen sind insbesondere ein längeres Menü, ein kleineres Desktop-Fenster und der Fensterwechsel während einer offenen Änderung. + +## Vorschlag: ein Arbeitsplatz mit gezielten Bereichen + +### Seiten + +Eine kompakte vollständige Übersicht der verwalteten CMS-Seiten mit Suche und verständlichen Filtern. Pro Seite sind Name beziehungsweise Adresse, Veröffentlichungszustand und Menüzuordnungen erkennbar. „Seite bearbeiten“ führt in den bereits beschriebenen Seiteneditor; Vorschau und Seiteneinstellungen sind gezielt erreichbar. + +Filter wie „Entwürfe“, „Veröffentlicht“, „Nicht im Hauptmenü“ und „Ohne Menüeintrag“ haben eine eindeutige Bedeutung. Eine Seite wird nicht aus der Verwaltungsübersicht entfernt, nur weil sie öffentlich nicht im Menü steht. Eine globale Seitenreihenfolge wird nicht aus der Tabellen-Sortierung oder dem Datum abgeleitet. + +### Menüs + +Hauptnavigation und die vorhandenen Fußbereichsgruppen werden über denselben geordneten Bearbeitungsbaustein verwaltet. Gewählten Bereich anzeigen, Einträge umordnen, bei zulässiger Hierarchie einordnen und ihre Ziele bearbeiten. Ziehen erhält eine bedienbare Alternative ohne Ziehen. + +Menübeschriftung, Zielseite, Reihenfolge, Menübereich und Sichtbarkeit sind Eigenschaften des Menüeintrags. Sie sind keine zweite Kopie der Seite. Dieselbe Seite kann in mehreren Menüs vorkommen; deren Reihenfolge ist unabhängig. Ein Eintrag kann auch auf ein zulässiges anderes Ziel zeigen oder als vorhandener Untermenüöffner dienen. + +Ausblenden betrifft den Menüeintrag. Entfernen eines Menüeintrags löscht die Seite nicht. Wird ein übergeordneter Menüpunkt ausgeblendet, sind seine Unterpunkte nach bestehender Regel ebenfalls ausgeblendet. Folgen einer Löschung oder Umordnung werden vor der Handlung verständlich; bestehende Hierarchieregeln werden nicht still geändert. + +Eine verständliche Speicherhandlung soll den tatsächlich betroffenen Menübereich und die Wirkung auf die öffentliche Navigation benennen. Dafür wird keine zusätzliche Navigationsversionierung oder allgemeine Freigabekette eingeführt. Der genaue Umgang mit mehreren offenen Änderungen ist am vorhandenen Speichermodell abzugleichen. + +### Übergreifender Website-Rahmen + +Kopf-/Fußbereich und die bereits vorhandenen Menügruppen gehören zum Gesamtzusammenhang. Der Umfang weiterer globaler Einstellungen – etwa Startseitenzuweisung, globale Abschnitte oder bearbeitbare gemeinsame Darstellungsangaben – wird vor Gestaltung und Umsetzung am Bestand geprüft. Ein Tab „Website-Einstellungen“ ist keine Zusage, dass solche Funktionen bereits vorhanden oder vollständig fachlich entschieden sind. Es entsteht keine neue Pflichtkonfiguration für bereits funktionierende Seiten. + +## „Versteckt“ eindeutig benennen + +| Sachverhalt | Bedeutung für die Bedienung | +|---|---| +| Nicht im Hauptmenü | Kein sichtbarer Eintrag dort; die Seite kann im Fußmenü, über andere Links oder ihre Adresse erreichbar bleiben | +| Ohne Menüeintrag | Keine Menüzuordnung in den berücksichtigten Bereichen; keine Aussage über ihre Veröffentlichung oder sonstige Verlinkung | +| Entwurf ohne öffentliche Revision | Nicht als öffentliche CMS-Seite auslieferbar; redaktionelle Vorschau bleibt ihr eigener Zugang | +| Nicht für Suchmaschinen vorgesehen | Eigene Auffindbarkeitsentscheidung, kein Zugriffsschutz. Der konkrete Umfang solcher Seiteneinstellungen ist im gelesenen Formular nicht nachgewiesen | + +Die Oberfläche verwendet keine einzelne unklare Checkbox „Seite verstecken“ für diese unterschiedlichen Wirkungen. Für den Normalfall stehen Veröffentlichung und Menüzuordnung verständlich beieinander. Zusätzliche Funktionen werden nur bei tatsächlichem Bedarf ergänzt. + +Die Rücknahme einer bereits veröffentlichten Seite ist vom bloßen Ausblenden eines Links zu unterscheiden und vor Implementierung am vorhandenen Aktionsweg zu prüfen. Beides verändert keine bestehenden Erwerbsrechte an Lernprodukten. Ein rechtlich notwendiger umfassender Inhaltsrückzug bleibt der gezielte Ausnahmeweg nach Dokument 08. + +## Seitenorganisation und Menüreihenfolge + +Die öffentlich sichtbare Reihenfolge wird im jeweiligen Menü gepflegt. Ein interner Seitenbestand besitzt nicht automatisch genau dieselbe Ordnung. Ein Menü kann Seiten, externe Ziele und Untermenüöffner enthalten; eine Seite kann in verschiedenen Menübereichen unterschiedlich erscheinen. + +Falls zusätzlich eine redaktionelle Seitenhierarchie oder interne Gruppierung gewünscht ist, wird ihre Bedeutung gesondert abgestimmt: reine Organisation, URL-Struktur oder automatische Navigation sind unterschiedliche Möglichkeiten. Das Design führt nicht still `parent_id`, automatische Pfadänderungen oder eine neue feste Seitenhierarchie ein. + +## Gemeinsame Rückwege und Prüfung + +Vom Webpräsenz-Arbeitsplatz in die einzelne Seite wechseln und wieder zurückkehren muss Such-/Filterkontext und offene Eingaben nachvollziehbar behandeln. Innerhalb des Seiteneditors bleiben dessen bereits festgehaltene Erhaltungs- und Rücksprungregeln gültig. Das Öffnen einer Seite oder der zentralen Redaktion darf nicht unbemerkt eine Menüänderung mitveröffentlichen. + +Ein Menüeintrag auf eine Seite ohne öffentliche Revision oder ein nicht mehr verfügbares Ziel wird erklärt. Das Auswählen einer Zielseite veröffentlicht sie nicht automatisch. Eine Navigationsvorschau muss den gewählten Menübereich und ihren gespeicherten beziehungsweise offenen Datenstand benennen. Sie ist getrennt von der tatsächlichen öffentlichen Ausgabe zu prüfen. + +## Gemeinsame Bedienregeln – Vorschlag + +| ID | Regel | +|---|---| +| WEB-R01 | Die Sortierung des Seitenbestands ordnet die Übersicht. Nur die explizite Umordnung eines Menübereichs ändert dessen Navigation | +| WEB-R02 | Auswahl öffnet Informationen. Ziehen oder eine eindeutig benannte Bewegungsaktion ändert die Reihenfolge; gültige Tiefe und Elternbeziehung bleiben nachvollziehbar | +| WEB-R03 | Menütext, Seitentitel und Zielreferenz bleiben getrennt. „Ziel ändern“ verwendet die gemeinsame visuelle Auswahl mit Seitensuche und Zustandsinformation | +| WEB-R04 | Ausblenden und Entfernen wirken auf den Menüeintrag. Die Seite wird dadurch weder gelöscht noch unveröffentlicht; betroffene Unterpunkte werden vor der Handlung erklärt | +| WEB-R05 | Die Speicheraktion benennt den Menüumfang und die Wirkung auf die öffentliche Navigation. Offene Änderungen bleiben als Arbeitszustand erhalten; eine neue fachliche Navigationsversionierung ist damit nicht beschlossen | +| WEB-R06 | „Seite bearbeiten“ erhält offene Menüeingaben und den Rückkehrkontext. Seitenbearbeitung speichert oder veröffentlicht keine fremden Menüänderungen; Rückkehr überschreibt keine zwischenzeitlich gespeicherten Daten | +| WEB-R07 | Menüvorschau benennt Bereich und verwendeten offenen beziehungsweise gespeicherten Stand. Sie veröffentlicht weder Zielseiten noch Menüänderungen; die tatsächliche Ausgabe wird separat geprüft | + +## Vorgeschlagene Abnahmefälle + +| ID | Aufgabe | Erwartetes Ergebnis | +|---|---|---| +| WEB-01 | Seitenbestand mit veröffentlichten und unveröffentlichten Seiten öffnen | Vollständige Verwaltungsübersicht, klare Zustände und Menüzuordnungen | +| WEB-02 | Reihenfolge im Hauptmenü ändern | Nur das benannte Menü geändert; Seite und Fußmenüreihenfolge unverändert | +| WEB-03 | Dieselbe Seite im Haupt- und Fußmenü verwenden | Referenz auf dieselbe Seite; Beschriftung und Reihenfolge je Eintrag nachvollziehbar | +| WEB-04 | Menüeintrag ausblenden oder entfernen | Wirkung auf Menü und gegebenenfalls Unterpunkte erklärt; Seite nicht gelöscht oder automatisch unveröffentlicht | +| WEB-05 | Veröffentlichte Seite ohne sichtbaren Menüeintrag prüfen | Direkte Erreichbarkeit und andere Verwendungen nicht mit „privat“ verwechselt | +| WEB-06 | Menüpunkt auf eine Seite ohne öffentliche Revision richten | Zielzustand verständlich; keine automatische Veröffentlichung | +| WEB-07 | Zwischen Webpräsenz, Seiteneditor und Quellenredaktion wechseln | Kontext und offene Eingaben erhalten beziehungsweise ausdrücklich behandelt; keine versteckte Speicherung anderer Bereiche | +| WEB-08 | Menü- und Geräteansicht prüfen | Zutreffende Haupt-/Fußnavigation, gültige Hierarchie und nachvollziehbare Reihenfolge; tatsächliche Ausgabe geprüft | +| WEB-09 | „Versteckt“ beziehungsweise Suchmaschinenangabe verwenden | Genau benannte Wirkung; Menüausblendung nicht als Zugriffsschutz oder gesicherter Sitemap-Ausschluss dargestellt | +| WEB-10 | Seitenliste anders sortieren oder filtern | Keine Änderung der öffentlichen Menüfolge; Auswahl und Filterkontext nachvollziehbar | +| WEB-11 | Menütext ändern und zwischen Einträgen oder Bereichen wechseln | Offene Änderung erhalten; Seitentitel unverändert. Speichern benennt exakt den betroffenen Menüumfang | +| WEB-12 | Einzigen Unterpunkt ohne gültigen Nachbarn bewegen | Keine aktive wirkungslose Bewegung und kein stiller Elternwechsel; Alternative zur Ziehbedienung vorhanden | +| WEB-13 | Menüvorschau mit offenen Änderungen öffnen und schließen | Stand und Bereich erkennbar, keine Speicherung oder Veröffentlichung; Arbeitszustand danach erhalten | + +Diese Fälle und WEB-R01 bis WEB-R07 sind Entwurf. Die drei neuen Bildreferenzen stehen zur Auswahl; aktuelle schreibende Abläufe und tatsächliche Ausgabe sind noch zu prüfen. + +## Quellen und offene Punkte + +- [Einzelner CMS-Seiteneditor](12-cms-seiteneditor-entwurf.md). +- [Gemeinsamer Verwaltungsstandard](10-verwaltungsstandard-entwurf.md). +- [Bestehender CMS-Vertrag §10](../../architektur/cms-widget-registry.md). +- [Audit B35/B36](audit/Belege.md), frühere Navigation. +- [Fachliche Anforderungen und offene Fragen](04-fachliche-anforderungen.md), FACH-54/55 und OFF-23 bis OFF-25. + +OFF-23 hält die Bedeutung einer zusätzlichen Seitenorganisation fest. OFF-24 hält die gewünschte Bedeutung „versteckter Seiten“ fest; OFF-25 den Umfang übergreifender Website-Einstellungen. Der Umsetzungsstand wird nicht aus dem Namen eines neuen Konfigurators abgeleitet. diff --git a/docs/ux/verwaltung/14-verwaltungsstandard.md b/docs/ux/verwaltung/14-verwaltungsstandard.md new file mode 100644 index 0000000..3e60b82 --- /dev/null +++ b/docs/ux/verwaltung/14-verwaltungsstandard.md @@ -0,0 +1,85 @@ +# Verbindlicher Designstandard für die Verwaltung + +Stand: 19.11.2026. Grundlage: UX-Audit und gemeinsame Designentscheidungen mit dem Auftraggeber. Die jüngste Rückmeldung beendet weitere allgemeine Designabstimmungen als Voraussetzung für den Umbau. Die vorhandene Richtung ist ausreichend bestimmt, um einen Coding-Agenten mit der Umsetzung zu beauftragen. + +## Geltung und Rangfolge + +Dieses Dokument ist die maßgebliche Design- und Interaktionsgrundlage für den Verwaltungsumbau und künftige Verwaltungsoberflächen. Der [Umbauauftrag](15-umbauauftrag.md) macht die Umsetzung konkret. Bestehende Betriebs-, Sicherheits-, Test- und fachliche Vertragsregeln bleiben erhalten. Eine Designvorgabe ersetzt keine fachliche Freigabe für geänderte Lizenz-, Erwerbs- oder Versionsregeln. + +Die Entscheidungen und Abbildungen in Dokument 02 bis 13 liefern Herkunft und Referenzen. Ihre früheren Hinweise auf ausstehende Detailabstimmung sind zeitliche Arbeitsstände und kein allgemeines Startverbot mehr. Es werden nicht sämtliche alternativen Bilddetails oder offenen Fachfragen pauschal freigegeben. Bei Abweichungen gilt: dieser Standard für gemeinsame UX; bestätigte Anforderungen und bestehende fachliche Verträge für Bedeutung und Wirkung; ausgewählte Bilder für die räumliche Richtung. Bildfehler und historische Alternativen nicht nachbauen. + +## 1. Ein gemeinsamer Arbeitsplatz + +- Laravel, Filament und Livewire bleiben Grundlage. Bestehende Modelle, Beziehungen, Registry, Rechte und Fassungsbindungen erhalten. +- Ein gemeinsamer Verwaltungsrahmen mit klarer Navigation, verständlichem Objektkopf, direkt erreichbaren Arbeitsbereichen und nachvollziehbarem Rückweg. +- Nichtlineare Arbeit nutzt einen Kontextarbeitsplatz. Nur tatsächlich lineare Vorgänge erhalten eine Schrittführung; abgeschlossene Bereiche bleiben direkt erreichbar. Anlegen und Bearbeiten nutzen dieselbe Grundmaske. +- Produktinformationen, redaktionelle Präsentation, kommerzielle Angaben und technische Verwaltungsinformationen sind gezielt gegliedert. Keine lange Gesamtformularliste und keine technische Statussammlung als Hauptarbeitsfläche. +- Vorhandene Bereiche vollständig in die gemeinsamen Muster überführen. Noch nicht gebaute Shop-, Mitglieder-, Lizenz- oder Kursbuchfunktionen werden durch diesen Auftrag nicht neu erfunden. + +## 2. Visueller Rahmen und Größen + +Ruhige helle Flächen, dunkelblaue lesbare Texte, grüne Hauptaktion, zurückhaltende Auswahlmarkierung und klare Gruppierung gemäß den ausgewählten Referenzen. Bestehende freigegebene Markenassets und Tokens aus dem [Designsystem](../../architektur/designsystem.md) sowie den [Designprinzipien](../../prinzipien/design-prinzipien.md) verwenden. Keine Farbentnahme aus generierten Bildern und keine neue Schrift pro Bereich. + +Die frühere pauschale Aussage im Designsystem, die Verwaltung bleibe in Standardgestaltung, wird für den hier beschriebenen Verwaltungsumbau durch diesen Standard abgelöst. Der Coding-Agent führt den Geltungsbereich dort entsprechend nach; öffentliche Website-Gestaltung und fachliche Verträge werden dadurch nicht geändert. + +Abstände, Schriftgrößen, Zeilenhöhen, Radien, Inhalts- und Panelbreiten werden als gemeinsame Tokens an einer Stelle umgesetzt und dokumentiert. Der Coding-Agent konkretisiert diese Werte anhand vorhandener Komponenten und Referenzen; dafür ist keine neue grundsätzliche Designauswahl erforderlich. Tabellen dürfen die verfügbare Desktopbreite nutzen; Texteingaben bleiben lesbar. Technische Felder und seltene Optionen werden kontextbezogen zugänglich, nicht unauffindbar entfernt. + +Die verfügbare Fensterbreite bestimmt die Anordnung. Inhalte dürfen bei kleinerem Desktopfenster und Zoom weder unbedienbar noch verdeckt werden. Sichtbarer Tastaturfokus, verständliche Beschriftungen, ausreichende Kontraste und Alternativen zum Ziehen sind Bestandteil der Umsetzung. Zustand wird nicht allein durch Farbe vermittelt. + +## 3. Objektübersicht, Auswahl und Zuordnung + +- Gemeinsame kompakte Listen mit visueller Vorschau, Suche, nachvollziehbaren aktiven Filtern, verständlichem Zustand und kontextgerechten Aktionen. Keine individuelle Neuinterpretation je Fachobjekttyp. +- Der gemeinsame Picker folgt der [gewählten Listenbasis](03-auswahl-und-zuordnung-entwurf.md): kleine Vorschauen in der Liste, Detailprüfung des betrachteten Elements, eindeutig davon getrennte Auswahl zur Übernahme. +- Auswahl bleibt bei Suche, Filtern und Seitenwechsel erhalten. Eine benannte Bestätigung übernimmt die Auswahl; Abbrechen verändert die vorhandene Zuordnung nicht. Fachlich zulässige Objekte und Fassungen sind Kontext derselben Komponente. +- Zuordnungen zeigen Quelle und konkrete Verwendung. Hinzufügen, Austauschen und Entfernen sind unterscheidbar. Entfernen einer Referenz löscht nicht das Quellobjekt. +- Geordnete Listen unterstützen Drag-and-drop und eine Tastaturalternative. Umordnen verändert nur den benannten Umfang. Gefilterte Teilmengen dürfen keine versteckten oder mehrdeutigen Reihenfolgeänderungen auslösen. + +## 4. Objektbearbeitung und Zusammenstellung + +Für Module und Programme gilt die gewählte Kombination: kompakte Struktur links, großer Detailbereich rechts und klare Gruppierung. Maßgebliche Referenz: [kombinierter Aufbauarbeitsplatz](bilder/aufbau-kombiniert-v1.png), erläutert in [Dokument 06](06-aufbau-arbeitsplatz-entwurf.md). Medien verwenden denselben Rahmen mit ihren tatsächlichen Datei- und Fassungsfunktionen. Kein weiterer Grundentwurf ist erforderlich, um diese Funktionen einzuordnen. + +Quelle und lokale Verwendung dürfen nicht unbemerkt ineinander übergehen. Ein Quellenobjekt wird über einen ausdrücklich benannten Einstieg bearbeitet. Vorschau und Produktpräsentation sind gezielte Arbeitskontexte und verdrängen nicht die eigentliche Zusammenstellung. + +## 5. Gemeinsame Redaktion + +Ein gemeinsamer Redaktionsmanager für Medien einschließlich Filmen, Module, Programme und Lizenzartikel; weitere Fachobjekte wie Trainingspläne bleiben anschließbar. Grundlage: [Redaktionsübersicht 1](bilder/redaktion-01-uebersicht.png) und [gemeinsame Register am Film](bilder/redaktion-register-medium-v1.png), erläutert in [Dokument 09](09-redaktionsarbeitsplatz-entwurf.md). + +Texte, Präsentationsmedien und Einordnung werden in gezielten gemeinsamen Bereichen beziehungsweise Registern bearbeitet. Text und Medien müssen nicht gleichzeitig auf eine Seite passen. Titel, Teaser, Beschreibungen und redaktionelle Hinweise gehören zum Fachobjekt; gewöhnliche Beschreibungstexte werden nicht automatisch zu Medienobjekten. Verbindliche Lehrtexte und ihre fachlichen Fassungen bleiben getrennt. + +Präsentationsmedien werden ausschließlich über den zentralen visuellen Picker referenziert. Mehrere Medien pro Rolle, visuelle Vorschau, Austausch, Entfernen und Sortierung bleiben möglich. Reine Präsentationsmedien benötigen keine Lehrinhaltsfassung. Klassifikation, tatsächliche Verwendung und Rechte sind unterschiedliche Angaben. + +Übernommene Werte und eigene Abweichungen sind erkennbar; bestehende Auflösungsregeln bleiben erhalten. CMS-Verwendungen nutzen zentrale Angaben als Quelle und kennzeichnen lokale Abweichungen. Offene Vererbungsdetails nicht durch unbemerkte neue Rückfallregeln entscheiden. + +## 6. Wechsel, Speichern und Rückmeldung + +- Wechsel zum Redaktionsmanager und zurück erhält offene Eingaben, Auswahl, Reihenfolge und Bearbeitungskontext des Ausgangseditors. Kein vorgeschaltetes Pflichtspeichern, kein verstecktes Mitspeichern und kein Überschreiben neuer Redaktionswerte durch alte Formularwerte. +- Der Agent löst die technische Zustandserhaltung innerhalb des bestehenden Systems und prüft dabei neue Objekte, Uploads, Validierungsfehler und Browser-Rückwege. Das ist eine Umsetzungspflicht, kein weiterer allgemeiner Designfreigabeschritt. +- Eine verständliche Hauptaktion benennt ihren Speicher- oder Wirkungsumfang. Speichern ist nicht automatisch fachliche Freigabe, Artikelaktivierung oder Website-Veröffentlichung. Ein gemeinsamer Statusbereich zeigt nur die für die aktuelle Aufgabe nötigen Aussagen. +- Es gibt keine neue pauschale Genehmigungskette. Bestehende fachliche Prüfungen werden sinnvoll zugänglich gemacht und nicht allein aufgrund technischer Zustände zu weiteren manuellen Schritten. +- Vorschau benennt Gegenstand, Ausgabe und Datenstand. Aktuelle offene Eingaben sollen prüfbar sein; falls ein Ausgabeweg technisch nur gespeicherte Daten unterstützt, ist dies eindeutig zu benennen und als Abweichung zu dokumentieren. Keine heimliche Speicherung zur Vorschau. + +## 7. Website und CMS + +Die Einzel-Seitenbearbeitung führt die [Weiterentwicklung aus Dokument 12](12-cms-seiteneditor-entwurf.md) fort: breite visuelle Seitenstruktur, großzügige Konfigurationsbereiche für Abschnitt und Baustein, derselbe Seitenarbeitsstand und verlustfreie Rückwege. Konfigurationsumfang nicht in eine zu schmale rechte Spalte pressen. + +Das vorhandene Raster mit maximal vier logischen Einheiten, nebeneinanderliegenden Karten, verschiedenen Breiten und fachlich unterstützten Höhen bleibt sichtbar und funktional erhalten. Bestehende Abschnittsformatierungen und typabhängige Bausteinoptionen vollständig berücksichtigen. Keine neue freie Pixel-/Masonry-Logik aus einem Bild ableiten. Zentrale Redaktion bleibt Quelle für objektbezogene Inhalte; lokale Abweichungen sind erkennbar. + +Die [Webpräsenz-Verwaltung](13-webpraesenz-verwaltung-entwurf.md) trennt Seitenbestand und Menüorganisation. Der Auftraggeber bevorzugt Entwurf 1 und 3. Als Umsetzungskonkretisierung wird bei ausreichender Breite die Menüliste mit festem Detailbereich nach Entwurf 1 genutzt; bei schmalerem Fenster dieselbe Bearbeitung inline nach Entwurf 3, mit höchstens einem geöffneten Eintrag. Offene Änderungen und Orientierung bleiben beim Wechsel erhalten. Keine zusätzliche Variantenwahl vor dem Start erforderlich. + +Menütext, Seitentitel, Menüfolge und Seitenveröffentlichung sind unabhängig. Menü ausblenden oder Eintrag entfernen löscht keine Seite und entzieht keine Nutzungsrechte. Die vorhandenen Haupt-/Fußmenübereiche und Hierarchiegrenzen erhalten. Menüänderungen speichern benennt die Wirkung auf die öffentliche Navigation; keine zusätzliche allgemeine Website-Freigabe erfinden. „Website-Rahmen“ ist kein Auftrag für neue globale Theme-, Startseiten- oder Seitenbaumfunktionen. + +## 8. Schutz fachlicher Wirkung + +Bestehende Erwerbe, Bedingungen, zugesagte Aktualisierungen, Rechte und Historie bleiben durch normale Bearbeitung geschützt. Rechtlich notwendiger Rückzug bleibt eine ausdrückliche Handlung mit Grund, Umfang und Ergebnis. Eine rein visuelle Überarbeitung verändert dessen Sperrwirkung nicht; bestehende Ausgabewege sind bei Änderungen daran nachweisbar zu prüfen. + +[Dokument 04](04-fachliche-anforderungen.md) hält offene Geschäftsfragen fest. Diese blockieren nur tatsächlich davon abhängige Funktionen. Ein offener Rabatt- oder Angebotsmechanismus verhindert keinen Medien-/Redaktionsumbau. Der Agent baut keine neue Geschäftsregel aus einem Mockup. Bei einem konkreten fachlichen Widerspruch benennt er den betroffenen Teil und arbeitet an unabhängigen Teilen weiter. + +## 9. Wiederverwendung und Abnahme + +Gleiche Aufgabe bedeutet dieselbe gepflegte Komponente: Rahmen, Listen, Picker, Redaktion, Sortierung, Status-/Aktionsbereich, Dialoge und Vorschau. Gemeinsam gepflegte Komponenten müssen von mehreren Objektarten genutzt werden; kopierte ähnlich aussehende Formulare erfüllen dies nicht. + +Die Abnahme bewertet die echte Anwendung, nicht die Bildvorlage oder eine Agentenbehauptung. Für jeden Umsetzungsteil sind die relevanten PICK-, BUILD-, RED-, CMS-, WEB- und Zustandsfälle aus den Detaildokumenten auszuwählen. Sie dienen als konkretisierte Prüfaufgaben; fachlich offene Erwartungen werden nicht automatisch neue Geschäftsregeln. Keine zusätzliche Designfreigabe pro Fall. + +Erforderliche Nachweise: funktionierender Hauptablauf, Erhalt offener Eingaben, Berechtigungs-/Fassungsregressionen im betroffenen Umfang, Tastaturbedienung, relevante Lade-/Leer-/Fehlerzustände sowie Screenshots bei sinnvoller breiter und schmalerer Fenstergröße. Bestehende Repository-Prüfpflichten bleiben maßgeblich. Nicht geprüfte Punkte und Abweichungen konkret angeben. Umsetzung und Abnahme schrittweise durchführen; die gesamte Verwaltung benötigt nicht vorab einen Screenkatalog. + +Die [Agentenregelvorlagen](regeln/AGENTS-verwaltung-entwurf.md) verweisen auf diesen Standard. Ihre Einbindung in aktive Agentenregeln gehört zum Umbauauftrag und ergänzt bestehende Betriebsregeln. Dieser Dokumentationsschritt startet keinen Coding-Agenten und verändert keine Anwendung. diff --git a/docs/ux/verwaltung/15-umbauauftrag.md b/docs/ux/verwaltung/15-umbauauftrag.md new file mode 100644 index 0000000..071bdb0 --- /dev/null +++ b/docs/ux/verwaltung/15-umbauauftrag.md @@ -0,0 +1,64 @@ +# Umbauauftrag: einheitliche Verwaltungs-UX + +Stand: 19.11.2026. Fertige Übergabe an einen anschließend beauftragten Coding-Agenten. Keine weitere allgemeine Designauswahl ist als Startbedingung erforderlich. Dieser Auftrag wurde hier dokumentiert; die Anwendung ist damit noch nicht umgebaut und kein Agent wurde gestartet. + +## Auftrag + +Baue die vorhandene Verwaltung von „Lara & Felix – Stark im Alltag“ auf den [verbindlichen Verwaltungsstandard](14-verwaltungsstandard.md) um. Nutze Laravel, Filament und Livewire sowie die vorhandenen fachlichen Funktionen. Ziel sind gemeinsame, visuelle, aufgabenorientierte Arbeitsplätze und echte wiederverwendbare Komponenten. Lange Gesamtformulare, fragmentierte Picker und individuelle Bedienlogik je Objekttyp sind durch die vereinbarten Muster zu ersetzen. + +Der Designprozess ist ausreichend abgeschlossen, um zu beginnen. Fordere keine neuen Mockups oder erneute Grundsatzfreigabe für jeden Screen an. Technische Einbettung, gemeinsame Tokens, responsives Verhalten und Zustandsbewahrung konkretisierst du im Rahmen des Standards und belegst das Ergebnis in der laufenden Anwendung. + +## Vor dem ersten Anwendungseingriff + +1. `CLAUDE.md` und aktive Repository-Regeln lesen; insbesondere Branch-, Test-, Deployment- und Medienschutzregeln beachten. Keine Produktivänderung oder manuelles Serverdeployment aus diesem Auftrag ableiten. +2. Dokument 14, bestätigte Entscheidungen in Dokument 02, Fachanforderungen in Dokument 04 und die aufgabenrelevanten Detaildokumente lesen. Ältere allgemeine „noch abzustimmen“-Hinweise werden durch Dokument 14 für die Designausführung abgelöst. Offene Geschäftsregeln bleiben offen. +3. Den aktuellen Code und die echte Testoberfläche prüfen: relevante Routen, Editoren, Komponenten, Aktionen, Felder, Validierungen, Rechte und Fassungsbindungen erfassen. Die Auditbelege sind historische Evidenz, kein Nachweis des heutigen Funktionsstands. +4. Eine kompakte Zuordnung bestehender Funktionen zu neuem Arbeitsplatz und gemeinsamem Baustein dokumentieren. Keine fachliche Option verlieren, weil sie in einer Bildreferenz nicht dargestellt ist. Geeignete vorhandene Komponenten weiterverwenden. +5. Die Einstiegshinweise für Cursor und Claude Code auf denselben Standard ausrichten. Vorbereitete Vorlagen unter `regeln/` verwenden und bestehende Betriebsregeln ergänzen, nicht ersetzen. Kein konkurrierendes Regelwerk kopieren. + +Diese Schritte sind Teil der Umsetzung und keine zusätzliche pauschale Genehmigungsschleife. + +## Umsetzung in zusammenhängenden Teilen + +### A. Gemeinsamer Rahmen und Medien-/Redaktionsablauf + +Gemeinsame Layout-, Aktions-, Status- und Listengrundlagen sowie zentralen Picker und Redaktionsmanager umsetzen. Den tatsächlichen Medieneditor einordnen; seine Datei-, Verarbeitungs-, Rechte- und Fassungsfunktionen erhalten. + +Durchgängiger Referenzablauf: vorhandenes Medium öffnen, eine Ausgangseingabe ändern, Redaktion öffnen, Text bearbeiten, Präsentationsmedium über den zentralen Picker zuordnen, mehrere Medien derselben Rolle sortieren, Ausgabe prüfen und zur Ausgangsbearbeitung zurückkehren. Offene Ausgangseingaben und neue Redaktionswerte bleiben erhalten. Kein Pflichtspeichern vor dem Wechsel. + +Den bereits gewählten Programm-/Modularbeitsplatz über dieselben Komponenten anschließen, insbesondere Redaktionseinstieg, Rückkehr, Picker und geordnete Referenzen. Keine unabhängige zweite Redaktionsmaske. + +### B. Objektübersichten und weitere bestehende Inhaltsarbeitsplätze + +Vorhandene Objektübersichten, Module, Programme und vorhandene Lizenzartikel auf die gemeinsamen Muster umstellen. Geeignete Suche, Filter, visuelle Listen und direkte Bereiche nutzen. Angebote verwenden dieselbe Grundmaske für Anlegen und Bearbeiten; tatsächliche lineare Abläufe können Schritte haben. Bestehende Fachlogik erhalten; offene Angebots-, Rabatt- und Lizenzfragen nicht neu erfinden. + +### C. CMS und Webpräsenz + +Vorhandenen CMS-Seiteneditor gemäß Dokument 14 und den Referenzen in Dokument 12 umbauen: sichtbares Vierer-Raster, volle Arbeitsbreite, Abschnitts- und Bausteinkonfiguration mit ausreichendem Platz, gemeinsame Medienauswahl und zentrale Redaktionsquellen. Keine bestehenden Konfigurationsmöglichkeiten oder Revisionsfunktionen verlieren. + +Die übergeordnete Seiten-/Menüverwaltung anhand Dokument 13 zusammenführen. Getrennte Zustände für Seitenveröffentlichung und Menüeinblendung erhalten. Breiter Arbeitsplatz nach Entwurf 1, schmalere Anordnung mit denselben Feldern nach Entwurf 3. Bestehende Menübereiche und Hierarchiegrenzen erhalten; keine neue beliebige Seitenhierarchie oder Themeverwaltung. + +Die Teile bauen aufeinander auf. Ein funktionierender erster Teil dient als reale Komponentenreferenz; er ist kein Vorwand für einen erneuten allgemeinen Designprozess. Die fachliche und visuelle Abnahme kann pro abgeschlossenem Teil erfolgen. Es gibt kein automatisches Produktivdeployment durch eine UX-Abnahme. + +## Grenzen + +- Keine Änderung bestehender Datenmodelle, Beziehungen, Versions- oder Rechtebedeutungen als beiläufige Folge der Gestaltung. Technisch erforderliche Anpassungen innerhalb der bestehenden Fachlogik nachvollziehbar dokumentieren; vorhandene Migrationsregeln beachten. +- Keine neue allgemeine Genehmigungsstrecke, kein Ersatz von Laravel/Filament/Livewire, keine dauerhaften konkurrierenden Alt-/Neu-Editoren für denselben Zweck. +- Nicht vorhandene Shop-, Mitglieder-, Lizenzmanagement- oder Kursbuchfunktionen sind Folgearbeit. Ihre künftigen Oberflächen müssen den Standard nutzen; dieser Auftrag baut sie nicht erstmals fachlich auf. +- Bei einer tatsächlich abhängigen offenen Geschäftsentscheidung den konkreten Konflikt und die notwendige Entscheidung benennen. Unabhängige Teile weiter bearbeiten. Keine allgemeine Rückfrage nur wegen fehlender Pixelwerte, Registerbezeichnungen oder technischer Detailplanung. + +## Abnahme und Lieferung + +Verwende die [Abnahmevorlage](regeln/ux-abnahme-vorlage.md) und die aufgabenrelevanten Fälle der Detaildokumente. Bestehende Testpflichten erfüllen; keine Tests gegen Produktion und keine Datenbankrücksetzung der Testinstanz. + +Für jeden abgeschlossenen Teil liefern: + +- geänderte Arbeitsplätze und erhaltene Funktionen; +- tatsächlich gemeinsam verwendete Komponenten und zentrale Gestaltungstokens; +- geprüften Hauptablauf einschließlich Rückkehr und Fehlerkorrektur; +- relevante Funktions-, Berechtigungs- und Fassungsprüfungen mit tatsächlichem Ergebnis; +- Screenshots aus der gerenderten Testanwendung bei breiter und schmalerer Darstellung sowie geprüfte Tastaturinteraktionen; +- konkrete Abweichungen, offene abhängige Fragen und nicht geprüfte Zustände; +- fortgeschriebene Dokumentation als Grundlage für spätere Agenten. + +Eine Sammlung statischer Mockups, umbenannte Filament-Felder oder vier kopierte Einzelmasken erfüllen den Auftrag nicht. Maßgeblich sind die funktionierende Benutzerführung, konsistente gemeinsame Komponenten und der Erhalt fachlicher Wirkung. diff --git a/docs/ux/verwaltung/16-funktionszuordnung.md b/docs/ux/verwaltung/16-funktionszuordnung.md new file mode 100644 index 0000000..00880e1 --- /dev/null +++ b/docs/ux/verwaltung/16-funktionszuordnung.md @@ -0,0 +1,48 @@ +# Zuordnung vorhandener Funktionen + +Stand: 20.11.2026, nach Teil C (Seiteneditor und Webpräsenz); zuerst angelegt am 19.11.2026 mit Teil A. Keine Fachoption entfällt, weil sie im Mockup fehlt. + +## Aufgabenzuordnung der Arbeitsplätze + +| Arbeitsplatz | Bearbeitetes Objekt | Aufgabe hier | Unmittelbar dazu | Gehört woanders hin | +|---|---|---|---|---| +| Redaktionsmanager | Medium, Modul, Programm oder Lizenzartikel als Ganzes | Beschreibende Texte, Präsentationsmedien und Einordnung pflegen | Herkunft je Text (eigen oder übernommen), Website-Status je zugeordnetem Medium, Speicherumfang, „Ausgabe prüfen“ | Datei und Fassungen (Medieneditor), Aufbau und Didaktik (Aufbau), Stand, Preis, Rechte (Lizenzartikel) | +| Medieneditor | ein Medium | Datei, Fassungen, Vorschaubild, Verwendung, Website-Freigabe | Fassungsstatus, Freigaben je Fassung, wo eine Fassung eingebunden ist, Vorschau der Karten | Texte und Präsentation (Redaktion) | +| Aufbau | Modul oder Programm | Bestandteile zusammenstellen, Didaktik, Katalogbild, Fassung freigeben | Verwendung eines Bestandteils an dieser Stelle (Rolle, Hinweis) | Texte, Präsentationsmedien, Einordnung (Redaktion); Quelle eines Bestandteils (eigener Editor) | +| Lizenzartikel | ein Lizenzartikel | Überblick über Stand und Angebote, Einstieg in die Präsentation | fachliche Quelle | Stand veröffentlichen und zurückziehen (Weitere Aktionen) | + +## Bisher und jetzt + +| Bisher | Jetzt | Gemeinsamer Baustein | +|---|---|---| +| Je Objektart eigene Texte-Ansichten (`texte-medium`, `texte-komposition`, `texte-artikel`) | Ein Register „Texte“; die Seite liefert nur die Feldliste (`redaktionFelder()`) | `verwaltung/texte.blade.php`, `verwaltung/textfeld.blade.php` | +| Je Objektart eigene Einordnung | Ein Register „Einordnung“; die Seite liefert Gruppen (`einordnungGruppen()`) | `verwaltung/einordnung.blade.php` | +| Präsentationsliste mit sofortigem Schreiben, Rollenauswahl als Dropdown unter der Liste, Austausch hängt neues Medium ans Ende | Arbeitsstand bis „Redaktion speichern“; Rollengruppen mit Hinzufügen, Austauschen an gleicher Stelle, Entfernen, Ziehen und Pfeiltasten; „Neu zugeordnet“ | `verwaltung/praesentation.blade.php`, `PresentationMedia::staged/describe/commit` | +| Zwei Picker (Radio-Liste im Medium, Modaldialog im Aufbau) | Ein visueller Picker mit drei Zwecken: Aufbau (Fassung), Präsentation (Mehrfachauswahl, Rolle), Austausch (ein Medium) | `verwaltung/picker.blade.php`, Trait `ManagesEditorialSurface` | +| Website-Freigabe als Knopf in jeder Zuordnung | Status mit „Freigabe ansehen“; Freigeben/Zurücknehmen im Menü der Zeile mit Rückfrage, weil global wirksam | `verwaltung/zuordnung-menue.blade.php` | +| Abweichende Formulierungen sofort gespeichert | Teil des Arbeitsstands, gespeichert mit „Redaktion speichern“ | `verwaltung/varianten.blade.php` | +| Medienansicht mit doppeltem Titel, zwei „Redaktion bearbeiten“, umbrechenden Bereichen, halber Breite | Ein Objektkopf; Register „Inhalt und Fassungen“ im Rahmen des Aufbaus (Fassungen links, gewählte Fassung rechts mit Abspieler oder Lehrtext, Status, Freigeben, Deaktivieren, „Im eigenen Tab“, Einbindung dieser Fassung), „Vorschaubild“, „Verwendung“, „Vorschau“, „Website“; volle Breite. Medien ohne Fassung zeigen „Erste Fassung anlegen“ statt einer leeren Liste. Alte Adresse `bereich=fassungen` öffnet das zusammengelegte Register | `verwaltung/kopf.blade.php`, Aufbau-Klassen `vw-aufbau`/`vw-baustein is-fest` | +| Fassungswechsel im Medium verwarf einen offenen Lehrtext still; „Text speichern“ ließ die alte Fassung ausgewählt | Wechsel fragt im gemeinsamen Bestätigungsdialog; offener Text steht im Kopfstatus und löst die Abgangswarnung aus; nach dem Speichern ist die neue Fassung gewählt, die Rückmeldung steht an der Fassung | `bestaetigung.blade.php`, `abgang.blade.php` | +| „Fassung freigeben“ als Kopfaktion des Mediums | „Diese Fassung freigeben“ an der gewählten Fassung; der offene Entwurf zusätzlich unter „Weitere Aktionen“ | `kopf.blade.php` | +| Bereich „Beschreibung“ und „Präsentation“ im Medium | Texte und Präsentation in der Redaktion; Website-Freigabe, Quellenzeile (Anzeige), Seitenverwendung und Änderungsverlauf im Bereich „Website“ | – | +| Website-Freigabe speicherte offene Quellenzeile und Alternativtext mit | Freigabe nutzt den gespeicherten Stand; Änderung in der Redaktion | – | +| Dialog „Modul bearbeiten“ mit Beschreibung, Didaktik, Einordnung, Titelbild | Register „Didaktik und Katalogbild“ im Aufbau: Didaktik gehört zum Entwurf, Katalogbild wirkt sofort ohne Fassung; Texte und Einordnung nur in der Redaktion | `verwaltung/aufbau-angaben.blade.php` | +| Aufbau als Kartenliste mit rechter Spalte (zweiter Titel, Präsentationsmedien) und Dialog „Bestandteil bearbeiten“ | Kombinierter Aufbauarbeitsplatz: Struktur links (Bausteinkarten mit Position, Quelle aufklappbar „Nur zur Ansicht“, Ziehen, Alt+Pfeil, Knöpfe unter der Liste), Detail rechts mit „An dieser Stelle“ (Rolle, Hinweis), „Quelle“ (Quelltext, Quelle bearbeiten), „Inhaltsvorschau“; Register „Fassungen und Verwendung“. Lokale Angaben werden mit „Entwurf speichern“ gesichert | `verwaltung/aufbau.blade.php`, `verwaltung/aufbau-verlauf.blade.php` | +| Filament-Kopfaktionen (Fassung freigeben, Neue Fassung, Bibliothek anzeigen/ausblenden, Stand veröffentlichen/zurückziehen) | Benannte Aktionen, aus dem gemeinsamen Kopf aufgerufen; seltene in „Weitere Aktionen“ | `kopf.blade.php`, `…Action()`-Methoden | +| Lizenzartikel: Filament-Abschnitte und eingebettete Redaktion | Kopf, Überblick (Präsentation, Stand, Angebote), Redaktion als eigener Arbeitsplatz | `editorial/license-desk.blade.php` | +| CMS-Seite: Filament-Kopf, Seitenformular mit Raster und Gestaltung an jedem Abschnitt, Revisionen als Tabelle unter dem Formular, Widgetdialog „Widget bearbeiten“ | Seitenaufbau als Überblick mit Miniaturvorschau je Baustein und knappen Abschnittsköpfen; Bildfelder über den gemeinsamen Picker (statt eigener Auswahlliste); Abschnittsgestaltung in drei Gruppen; „Entwurf speichern“ auch im Bausteindialog. Seitenkopf mit getrenntem Speicher- und Veröffentlichungszustand („Entwurf speichern“, Strg+S, „Veröffentlichen …“, Seitenvorschau, Live-Seite unter „Weitere Aktionen“); Register Seiteninhalt, Seiteneinstellungen, Verlauf. Seitenaufbau zeigt Abschnitte mit Plätzen; „Abschnitt gestalten“ öffnet einen Kontext für Raster und Gestaltung genau eines Abschnitts (Adresse `?abschnitt=N`, Esc und „Zur Seite“ zurück); „Konfigurieren“ öffnet den Baustein als großen Kontext mit Vorschau, Verlassen nur über „Zur Seite“ (übernimmt) oder „Änderungen verwerfen“. Ein Fehler in einem ausgeblendeten Register oder Abschnittsteil macht ihn sichtbar. Wiederherstellen einer Revision und Veröffentlichungsregeln unverändert | `cms/seite-kopf.blade.php`, `EditPage`, `SectionEditor`, `WidgetEditor` | +| Redaktionelle Auswahlwerte nur über Migrationen änderbar; „Inhaltsart“ bot allen Objekten alle Materialarten an | Arbeitsplatz „Redaktionelle Stammdaten“ (fachliche Materialarten, Altersbereich und Zielgruppe, Einsatzbereich, Verwendungszweck; Säulen verlinkt): Anlegen, Umbenennen bei fester Kennung, Deaktivieren, Reihenfolge, Verwendung; Materialarten mit zulässigen Kontexten. Redaktion, Medien- und Kompositionsfilter, Picker und Mitgliederbibliothek nutzen dieselbe Regel; „Fachliche Materialart“ durchgängig (FACH-56 bis FACH-58) | `RedaktionelleStammdaten`, `EditorialVocabulary` | +| Seitenliste (Filament-Tabelle: Pfad, „Veröffentlicht: Ja/Entwurf“, Zuletzt bearbeitet, Duplizieren) | Webpräsenz, Register „Seiten“: gemeinsame Bestandsliste mit Titel und Adresse, Veröffentlichung (Revision, „Entwurf neuer“, „Nur Entwurf“), Menüzuordnung je Bereich oder „Ohne Menüeintrag“, Filter Veröffentlichung und Menü, Sortierung zuletzt bearbeitet (beide Richtungen) oder Adresse (beide Richtungen), Bearbeiten, Vorschau, Duplizieren (gleicher Dialog und Fehler). „Seite anlegen“ im Kopf. `/verwaltung/pages` leitet nach derselben Rechteprüfung dorthin | `Webpraesenz`, `verwaltung/bestand` | +| Navigationsverwaltung (Filament-Tabelle je Platz, Dialoge Anlegen/Bearbeiten, Sofort-Ausblenden, Ziehen, Löschen) | Webpräsenz, Register „Menüs“: Bereichsauswahl, Menübaum mit einer Untermenüebene, Detailbereich rechts (breit) bzw. ein aufgeklappter Eintrag (schmal) mit Menütext, Ziel (Seitenwahl mit Zustand oder Adresse), Untermenü von, Im Menü anzeigen, Menübereich, Aus Menü entfernen; Umordnen per Ziehen, Knöpfen oder Alt+Pfeil innerhalb der Ebene. Änderungen bilden einen Arbeitsstand und werden mit „Menüänderungen speichern“ gemeinsam geschrieben (vorher wirkte jede Handlung sofort). Regeln der bisherigen Form unverändert geprüft. `/verwaltung/navigation-items` leitet dorthin | `Webpraesenz`, `cms/menues`, `cms/menue-zeile`, `cms/menue-detail`, `cms/ziel-auswahl`, `bestaetigung`, `abgang` | +| Separater Filament-Editor `EditContentElement` (Gesamtformular, „Bearbeiten“ in der Medienliste) | Adresse leitet nach der Rechteprüfung in die Redaktion; „Redaktion“ in der Medienliste öffnet sie direkt; „Medium löschen“ (nur ohne Fassung) unter „Weitere Aktionen“ des Medieneditors | `kopf.blade.php` | +| Vorschaubild aus vorhandenem Bild (Oberfläche seit 72130d6 entfallen, Logik `adoptLibraryImage` vorhanden) | „Bild aus dem Bestand wählen“ im Register „Vorschaubild“ (neben Filmstelle, Hochladen, Bilddatei), über den gemeinsamen Picker | `picker.blade.php` (Zweck Vorschaubild) | +| Arbeitsplatz als Kartenwand mit Inline-Anlegefeldern; „Module“ und „Programme“ als eigene Filament-Tabellen derselben Objekte | Eine Bestandsliste für Programme und Module; „Module“, „Programme“ und „Fachliche Kombinationen“ zeigen dieselben Zeilen mit festem Typ; ein Anlegedialog für Module und Programme | `verwaltung/bestand`, `ListsCompositions`, `` | +| Medien mit elf gleichrangigen Filtern, Kacheln als Grundansicht | Suche, Technische Art, Freigabe, Verwendung sichtbar; übrige acht unter „Weitere Filter“; aktive Filter als Chips; Liste als Grundansicht, Kacheln wählbar; Adressnamen unverändert | `verwaltung/bestand` | +| Lizenzartikel, Pakete, Rechteprofile, Angebote, Säulen, Benutzer als Filament-Tabellen mit technischen Spalten | Gemeinsame Bestandsliste mit lesbaren Zuständen und Zustandsfilter; nach dem Anlegen öffnet der neue Eintrag | `ListsCatalog`, `CatalogLabels` | +| Angebot: Filament-Abschnitte und Dialog „Fassung aktivieren“ ohne Vorbelegung | Katalog-Objektseite; eine Maske für erste und geänderte Fassung, bei Änderung vorbelegt (FACH-08, FACH-20); Wirkung `OfferService::activate` unverändert | `catalog/objekt` | +| Paket: Filament-Abschnitte und Dialog „Fassung veröffentlichen“ ohne Vorbelegung | Katalog-Objektseite; dieselbe Maske, bei Änderung vorbelegt; Wirkung `BundleService::publish` unverändert | `catalog/objekt` | +| Rechteprofil: Abschnitt mit „film: streamen“, doppelter Titel | Katalog-Objektseite mit erlaubten Handlungen, Verwendung in Angeboten, Fassungen | `catalog/objekt`, `CatalogLabels` | +| „Medium anlegen“ öffnete keinen Dialog (Dialogbereich fehlte) | Die gemeinsame Liste gibt den Dialogbereich aus | `verwaltung/bestand` | +| Bestätigungen per Browser-`confirm()` | Gemeinsamer Bestätigungsdialog; Warnung beim Verlassen mit ungespeicherten Änderungen | `bestaetigung.blade.php`, `abgang.blade.php` | + +Offen und nicht neu entschieden: Angebotsfassungen, Rabatte, Zielgruppen-Vorrang (OFF-19), leere Artikeltexte (OFF-20), Slideshow (OFF-21), versteckte Seiten (OFF-24). diff --git a/docs/ux/verwaltung/README.md b/docs/ux/verwaltung/README.md new file mode 100644 index 0000000..26f1382 --- /dev/null +++ b/docs/ux/verwaltung/README.md @@ -0,0 +1,102 @@ +# Lara & Felix – Verwaltung: UX und Design + +Stand: 19.11.2026. Die gemeinsam festgelegte Designrichtung ist ausreichend für den Umbau. Keine weitere allgemeine Designfreigabe oder vollständige Screenserie als Startbedingung. + +**Aktueller Einstieg:** [Verbindlicher Verwaltungsstandard](14-verwaltungsstandard.md) und [Umbauauftrag](15-umbauauftrag.md). Teil A (gemeinsamer Rahmen, Picker, Redaktion) ist in der Anwendung begonnen. Offene Geschäftsfragen bleiben in Dokument 04. Die Zuordnung steht in [16-funktionszuordnung.md](16-funktionszuordnung.md), die Maße in [tokens.md](tokens.md). + +Dokument 02 bis 13 bewahren den Abstimmungsverlauf. Ihre nachfolgenden älteren Entwurfs- und Freigabehinweise sind im Sinn der Rangfolge von Dokument 14 zu lesen; sie verlangen keine erneute allgemeine Designabstimmung. + +## Geltung und Lesereihenfolge + +| Dokument | Inhalt | Status | +|---|---|---| +| [Verbindlicher Verwaltungsstandard](14-verwaltungsstandard.md) | Gemeinsame Layout-, Komponenten-, Interaktions- und Abnahmeregeln | Maßgebliche Umsetzungsgrundlage nach gemeinsamer Abstimmung | +| [Umbauauftrag](15-umbauauftrag.md) | Konkrete schrittweise Umsetzung und Nachweise für den Coding-Agenten | Übergabefertig; keine weitere allgemeine Designauswahl erforderlich, Umsetzung noch nicht gestartet | +| [Auditbericht](audit/UX-Audit.md) | Tatsächlich geprüfte Testinstanz, 15 Befunde, Bedienwege und Grenzen | Erfasst; technische Ursachen und schreibende Abläufe teilweise ungeprüft | +| [Auditbelege](audit/Belege.md) | 46 aktuelle Bildschirmaufnahmen mit Kurznotizen | Belege der damaligen Oberflächen; keine Zielbilder | +| [Abgestimmte Designrichtung](02-designentscheidungen.md) | Gemeinsamer Arbeitsplatz, geführte Abläufe, Trennung der Präsentation | Richtung vom Auftraggeber bestätigt; Details offen | +| [Auswahl und Zuordnung](03-auswahl-und-zuordnung-entwurf.md) | Gewählte Listenbasis, verfeinerte Vorschau und Interaktionsregeln | Listenbasis bestätigt; Detailausgestaltung und Prüfkriterien weiterhin Entwurf | +| [Fachliche Anforderungen und offene Fragen](04-fachliche-anforderungen.md) | Anforderungen aus dem Gespräch, Alternativen und Prüfbeispiele | Anforderungsliste; keine vollständige Fachspezifikation | +| [Übergabe an Coding-Agenten](05-coder-uebergabe-arbeitsstand.md) | Geltung, Abgrenzung, Prüfbedarf und Vorbereitung späterer Implementierungsaufträge | Noch kein Implementierungsauftrag | +| [Aufbauarbeitsplatz](06-aufbau-arbeitsplatz-entwurf.md) | Gewählte Kombination: kompakte Struktur, großer Detailbereich und klare Gruppierung | Räumliche Grundlage bestätigt; Detailregeln weiterhin Entwurf | +| [Speichern, Vorschau und Freigabe](07-speichern-vorschau-freigabe-entwurf.md) | Zustände, Speicherwirkung und abgeglichene Freigabewege einschließlich Anzeigefreigabe und öffentlicher Listung | Neuer UX-Entwurf zur Abstimmung; keine zusätzliche fachliche Freigabe | +| [Einfacher Redaktionsalltag](08-einfacher-redaktionsalltag-entwurf.md) | Maßstab, vereinfachter Produktarbeitsplatz und Anschluss des Kursbuchsystems | Betriebsmaßstab bestätigt; Bedienbündelung und fachliche Vereinfachungen zur Abstimmung | +| [Gemeinsamer Redaktionsarbeitsplatz](09-redaktionsarbeitsplatz-entwurf.md) | Texte, Varianten, Klassifikation, Medienrollen, Herkunft und gemeinsame Register | Entwurf 1 als Grundlage gewählt; Register am Film konkretisiert, Details weiter Entwurf; aktuelle Anwendungs-UX nicht abgenommen | +| [Planungstext Redaktionsmodul](quellen/redaktionsmodul-planungschat-2026-11-19.md) | Vom Auftraggeber eingebrachte fachliche und UX-Anforderungen | Quelle vom 19.11.2026, keine Implementierungsabnahme | +| [Verwaltungsstandard – Konsolidierung](10-verwaltungsstandard-entwurf.md) | Arbeitsplatzfamilien, gemeinsame Komponenten, Umsetzung und Abnahme | Konsolidierter Vorschlag; ergänzende Regeln noch nicht insgesamt freigegeben | +| [CMS-Prüfbedarf](11-cms-pruefbedarf.md) | Bestehende Auditbefunde, dokumentierte Korrekturen und verbleibende Referenzlücke | Kein neuer abgeschlossener Live-Audit; Zugriff erforderte Anmeldung | +| [Cursor-Regelvorlage](regeln/cursor-verwaltung-entwurf.mdc) und [gemeinsame Agentenanweisung](regeln/AGENTS-verwaltung-entwurf.md) | Einstieg in denselben gepflegten Standard | Auf Standard 14 ausgerichtete Vorlagen; Einbindung in aktive Regeln ist Teil des Umbauauftrags | +| [UX-Abnahmevorlage](regeln/ux-abnahme-vorlage.md) | Aufgabenbezogene Übergabe mit tatsächlichen Prüfbelegen | Vorschlag für spätere ausdrücklich beauftragte Umsetzungen | +| [CMS-Seiteneditor](12-cms-seiteneditor-entwurf.md) | Sichtbares Vierer-Raster, Abschnittsgestaltung und großer Bausteinkonfigurator mit zentralen Redaktionsdaten | Überarbeiteter Vorschlag mit drei zusammengehörigen Zuständen, noch abzustimmen; keine neue Live-Abnahme | +| [Webpräsenz verwalten](13-webpraesenz-verwaltung-entwurf.md) | Übergeordnete Seitenübersicht, Menüs, Sichtbarkeit und Website-Rahmen | Präferenz für 1 und 3; angepasste Anordnung je Fensterbreite vorgeschlagen, noch nicht bestätigt | +| [Generierung der Auswahlentwürfe](generierung/auswahl-prompts.md) | Exakte Prompts und Referenzzuordnung für die neuen Auswahlbilder | Herkunftsnachweis | + +## Aktueller Stand + +1. Die vorhandene Verwaltung wurde als zusammenhängendes Produkt geprüft. +2. Als Grundrichtung wurden die Arbeitsfläche mit Kontext und geführte lineare Abläufe bestätigt. +3. Anlegen und Bearbeiten sollen dieselbe Grundmaske nutzen. Bereiche sind direkt erreichbar. +4. Präsentation wird separat betrachtet und unterstützt verschiedene Ausgabeansichten. +5. Angebotsfassungen, Angebotsvarianten, Hierarchien und die genaue Rabattlogik bleiben fachlich offen. +6. Für Auswahl und Zuordnung wurde die Liste mit visuellen Vorschauen und Detailprüfung als bevorzugte Grundlage gewählt. Die größere eigenständige Auswahlliste wird zurückgestellt. +7. Fachliche Inhaltstypen bleiben von Dateitypen unterscheidbar. Nutzung und Verwertung werden als zusätzliche Informationsbedarfe festgehalten; ihre genaue fachliche Abgrenzung bleibt offen. +8. Für den Aufbauarbeitsplatz ist die Arbeitsaufteilung aus Entwurf 2 mit Rahmen und Gruppierung aus Entwurf 1 bestätigt (UX-D15). Die kombinierte Abbildung konkretisiert diese Richtung. Regeln und Prüffälle trennen konkrete Verwendung, Quelle und Reihenfolge; Detailfragen bleiben offen. + +9. Speichern, Vorschau und Freigabe sind in Dokument 07 als nächster UX-Entwurf ausgearbeitet. Ein verfeinertes Bild zeigt die Statusinformationen am gewählten Aufbauarbeitsplatz. Die Regeln und STATE-Prüffälle sind noch nicht bestätigt. Der Quellenabgleich unterscheidet technische Bereitschaft, Anzeigefreigabe, öffentliche Listung als Zielkonzept, Artikelveröffentlichung, Angebotsaktivierung, CMS-Revision und Website-Medienfreigabe. + +10. Der Auftraggeber hat den Maßstab präzisiert: überschaubares Angebot, meist eine bearbeitende Person und späteres Kursbuchsystem (UX-D16/17). Dokument 08 ist der Ausgangspunkt für die nächste Ablaufabstimmung. Die Freigabeebenen in Dokument 07 werden nicht zu ebenso vielen manuellen Stationen. + +11. Bestehende Erwerbe und vereinbarte Nutzungsrechte bleiben vor unbeabsichtigten Folgen normaler Änderungen geschützt. Rechtlich notwendige Rückzüge müssen mit sofortiger Wirkung möglich sein (UX-D18/19). Dokument 08 unterscheidet den normalen Alltag und diesen Ausnahmeweg; OFF-18 hält den Prüfbedarf über alle Ausgabewege fest. + +12. Die gemeinsame Redaktion für Texte, Einordnung und Präsentationsmedien ist als nächster zentraler Baustein bekräftigt (UX-D20/21). Dokument 09 führt Redaktionsentwurf 1 als gewählte Grundlage weiter (UX-D22). Ein neuer Entwurf verteilt die Redaktion auf gemeinsame Register und zeigt Präsentationsmedien an einem Unterrichtsfilm; die konkrete Ausgestaltung ist weiter abzustimmen. Der Baustein kann als Redaktionsmanager geöffnet werden, sofern der Rückweg sämtliche offenen Eingaben der eigentlichen Objektbearbeitung erhält (UX-D23/FACH-49). Der vollständige Planungstext ist als Quelle erhalten; OFF-19 bis OFF-21 bewahren offene Varianten-, Übernahme- und Slideshow-Fragen. + +13. Dokument 10 bündelt den Vorschlag für die Umsetzung: fünf Arbeitsplatzfamilien statt eines individuellen Designs für jeden Screen, gemeinsame Komponenten und nachweisbare Abnahme. CMS-Seiteneditor und kompakte Übersicht werden weiter ausgearbeitet; am bereits gewählten Programm-/Modularbeitsplatz werden Redaktionseinstieg und Rückweg ergänzt. Kein erneuter Grundentwurf dieser Arbeitsplätze. Coding-Regelvorlagen sind vorbereitet, aber nicht aktiviert. Dokument 11 ordnet die CMS-Schwächen nach ihrem tatsächlichen Belegstatus ein; ein erneuter Live-Zugriff endete an der Anmeldung. + +14. Dokument 12 führt nach der Raster-/Konfigurationsrückmeldung einen zusammenhängenden Vorschlag weiter: Seitenaufbau in voller Arbeitsbreite, Abschnitt gestalten, Baustein konfigurieren. Vier logische Einheiten, unterschiedliche Höhen, vollständige Konfiguration und zentrale Redaktionsdaten sind ausdrücklich berücksichtigt. Die ersten drei Richtungen bleiben Vergleich; die neue Arbeitsaufteilung ist noch abzustimmen. Programm-/Modulbearbeitung behält ihre gewählte Grundlage. + +15. Die übergeordnete Verwaltung der Webpräsenz fehlt als eigener UX-Arbeitsplatz. Dokument 13 zeigt drei alternative Anordnungen: getrennte Register mit festem Menüeditor, Seitenbestand und Menü nebeneinander sowie direkte Bearbeitung in der breiten Menüliste. Der Auftraggeber bevorzugt 1 und 3, nennt zusätzlichen Scrollbedarf bei Inline-Konfiguration und ihre Eignung für kleinere Monitore. Die Kombination je verfügbarer Fensterbreite ist vorgeschlagen, noch nicht bestätigt; globale Einstellungen bleiben gezielt zu klären. Seitenveröffentlichung und Menüausblendung bleiben getrennt. Die zuletzt vier angezeigten CMS-Bilder waren drei Zustände der Einzel-Seitenbearbeitung plus eine korrigierte Abschnittsaufnahme. + +**Bestätigte Richtung ist keine vollständige Komponentenfreigabe.** Für den Auswahlbaustein ist Entwurf 1 als Listenbasis bestätigt. Die Verfeinerung v2 ergänzt Informationsbereiche für Inhaltstyp, Einordnung, Verwendung sowie Nutzung und Verwertung. Deren genaue Belegung, das vorgeschlagene Verhalten und Prüfkriterien bleiben zur weiteren Abstimmung markiert. + +## Visuelle Referenzen + +| Datei | Einordnung | +|---|---| +| [Arbeitsfläche mit Kontext](bilder/richtung-arbeitsflaeche-kontext.png) | Als Grundmuster für tägliche Arbeit bevorzugt | +| [Geführter Ablauf](bilder/richtung-gefuehrter-ablauf.png) | Für tatsächlich lineare Prozesse bevorzugt | +| [Bearbeitung neben Ergebnis](bilder/richtung-ergebnis-zurueckgestellt.png) | Für Angebotszusammenstellung zurückgestellt; Präsentation separat bearbeiten | +| [Kombinierte Richtung](bilder/richtung-kombiniert.png) | Verbindung beider bevorzugter Bedienmuster; Angebotsdetails sind illustrative Beispiele | +| [Auswahlentwurf 1](bilder/auswahl-01-liste-detail.png) | Als bevorzugte Listenbasis bestätigt | +| [Verfeinerte Listenansicht v2](bilder/auswahl-01-liste-detail-v2.png) | Weiterentwicklung der gewählten Basis; neue Informationsgruppen im Detail noch Entwurf | +| [Auswahlentwurf 2](bilder/auswahl-02-raster-detail.png) | Nicht als Grundanordnung gewählt; optionale Rasteransicht noch offen | +| [Auswahlentwurf 3](bilder/auswahl-03-bestand-auswahl.png) | Zurückgestellt; die Detailprüfung benötigt Raum für weitere fachliche Informationen | +| [Kombinierter Aufbauarbeitsplatz](bilder/aufbau-kombiniert-v1.png) | Bestätigte Arbeitsaufteilung und Gruppierung, visuell konkretisiert | +| [Aufbau mit Arbeitszustand](bilder/aufbau-zustaende-v1.png) | Fortführung der gewählten Anordnung; Zustands- und Speicherregeln zur Abstimmung | +| [Aufbauentwurf 1](bilder/aufbau-01-strukturliste-kontext.png) | Rahmen und Gruppierung in die Kombination übernommen | +| [Aufbauentwurf 2](bilder/aufbau-02-struktur-detailbereich.png) | Gewählte Arbeitsaufteilung: kompakte Struktur und großer Detailbereich | +| [Aufbauentwurf 3](bilder/aufbau-03-inline-bearbeitung.png) | Als Grundanordnung zurückgestellt | +| [Redaktion 1: Übersicht](bilder/redaktion-01-uebersicht.png) | Gewählte aufgeräumte Basis; gleichzeitige Text-/Medienspalten sind keine Pflicht | +| [Redaktion 2: Navigator und Detail](bilder/redaktion-02-navigator-detail.png) | Vergleich; nicht als Grundlage gewählt | +| [Redaktion 3: Direkte Bearbeitung](bilder/redaktion-03-direkt-kontext.png) | Vergleich; nicht als Grundlage gewählt | +| [Gemeinsame Register am Film](bilder/redaktion-register-medium-v1.png) | Fortführung der gewählten Basis mit eigener Registerkarte für Präsentationsmedien; Detailentwurf | +| [CMS 1: Struktur und Bearbeitung](bilder/cms-01-struktur-bearbeitung.png) | Kompakte Struktur mit festem Bearbeitungsbereich; zur Auswahl | +| [CMS 2: Seitenfläche und Inspektor](bilder/cms-02-seitenflaeche-inspektor.png) | Direkte Auswahl auf visueller Seite; zur Auswahl | +| [CMS 3: Einzelbearbeitung](bilder/cms-03-einzelbearbeitung.png) | Große Bearbeitungsfläche mit Rückweg; zur Auswahl | +| [CMS-Weiterentwicklung: Seitenaufbau](bilder/cms-weiterentwicklung-seitenaufbau-v1.png) | Breite Arbeitsfläche mit Nachbarn und 1+1+2-Raster; Teil eines Vorschlags | +| [CMS-Weiterentwicklung: Abschnitt](bilder/cms-weiterentwicklung-abschnitt-v1.png) | Eigener großer Gestaltungsbereich, korrigierte Rasterskizzen; Teil desselben Vorschlags | +| [CMS-Weiterentwicklung: Baustein](bilder/cms-weiterentwicklung-baustein-v1.png) | Typabhängiger Konfigurator mit zentraler Quelle; Teil desselben Vorschlags | +| [Webpräsenz 1: Register und Menüeditor](bilder/webpraesenz-01-register-menueeditor.png) | Alternative mit festem Detailbereich; zur Auswahl | +| [Webpräsenz 2: Seiten und Menü](bilder/webpraesenz-02-seiten-menues.png) | Gleichzeitiger Bestand und Menüzuordnung; zur Auswahl | +| [Webpräsenz 3: Direkte Menübearbeitung](bilder/webpraesenz-03-direkt-menue.png) | Breite Liste, Bearbeitung am Eintrag; zur Auswahl | + +Die Nummern der Auswahlentwürfe entsprechen der tatsächlichen Anzeigereihenfolge im Gespräch. Sie gehören zu diesem neuen Auswahlvergleich; sie sind unabhängig von den Nummern der früheren Angebotsrichtungen. + +## Grenzen der Bildreferenzen + +Die Zielbilder wurden mit dem integrierten Bildgenerator anhand aktueller Auditbilder und der bestätigten Richtung erzeugt. Es sind keine Screenshots implementierter Oberflächen. Texte, Randbereiche und Beispielbilder können Ungenauigkeiten enthalten. Maßgeblich sind die jeweils bestätigten schriftlichen Regeln. Fachlich offene Inhalte dürfen nicht aus Bilddetails abgeleitet werden. + +Die Markenfarben und Schriften aus der vorhandenen Projektdokumentation wurden als vorläufige visuelle Grundlage genutzt. Diese Ablage erteilt keine neue Markenfreigabe. + +## Weiterführung + +Der Standard in Dokument 14 und der Auftrag in Dokument 15 bilden jetzt die Umsetzungsgrundlage. Umsetzungserkenntnisse und gemeinsame Tokens dort fortschreiben; fachliche Fragen in Dokument 04 bewahren. Aktive Agenteneinstiege bei Beginn des Umbaus auf dieselbe Quelle ausrichten. Abnahmen prüfen konkrete funktionierende Teile, ohne den allgemeinen Designprozess erneut zu öffnen. diff --git a/docs/ux/verwaltung/abnahme/stammdaten.md b/docs/ux/verwaltung/abnahme/stammdaten.md new file mode 100644 index 0000000..38c6eec --- /dev/null +++ b/docs/ux/verwaltung/abnahme/stammdaten.md @@ -0,0 +1,84 @@ +# Redaktionelle Stammdaten (FACH-56 bis FACH-58) + +Stand: 20.11.2026. **Geprüfter Code-Stand:** `develop` mit `f774d43` auf `luf-test` (Lauf 4956), danach `70695db` (Tabellenumbruch, Lauf 4958). Geprüft mit dem Prüfkonto der Redaktion bei 1440 × 900 und 1280 × 800. Kein Produktivdeployment. + +## Bedienung + +- **Einstieg:** Seitenleiste „Inhalte“ → „Redaktionelle Stammdaten“ (`/verwaltung/stammdaten`). Zugang haben Konten mit der Rolle Redakteur, wie bei der übrigen Redaktion. +- **Gruppen:** Fachliche Materialarten, Altersbereich und Zielgruppe, Einsatzbereich, Redaktioneller Verwendungszweck. Die Gruppe steht in der Adresse (`?gruppe=…`). +- **Fachliche Säulen:** Daneben führt ein Verweis in die vorhandene Säulenverwaltung. Es gibt keinen zweiten Säulenkatalog. +- **Liste:** + - Suche nach Bezeichnung oder Kennung. + - Filter Aktiv/Inaktiv. + - Je Wert: Bezeichnung, feste Kennung, bei Materialarten „Zulässig für“, Status und Verwendung, etwa „3 Programme“ oder „Nicht verwendet“. +- **Anlegen:** „Wert anlegen“. Die Kennung entsteht aus der Bezeichnung und bleibt danach fest. Materialarten brauchen mindestens einen zulässigen Kontext: Medium, Modul, Programm oder Lizenzartikel. +- **Bearbeiten:** Die Bezeichnung ist änderbar, die Kennung nicht. Bei Materialarten lassen sich auch die Kontexte ändern. Werden dabei Kontexte entfernt, in denen der Wert verwendet wird, nennt der Dialog Anzahl und Titel der betroffenen Objekte und verlangt eine Bestätigung. Die Zuordnungen bleiben erhalten. +- **Reihenfolge:** „Nach oben“ und „Nach unten“ in jeder Zeile oder „Per Ziehen sortieren“. Die Reihenfolge gilt in Redaktion, Filtern und Picker. Verschieben tauscht nur die beiden benachbarten Einträge. +- **Weitere Aktionen:** + - „Verwendung“: Liste der zugeordneten Objekte mit Links und gefilterten Bestandslisten. Ein Klick auf die Verwendungsangabe öffnet sie ebenfalls. + - „Deaktivieren“ und „Reaktivieren“. + - „Löschen“: nur sichtbar, solange der Wert nirgends zugeordnet ist; serverseitig erneut geprüft. +- **Feste Kennungen:** `programm`, `modul` und `traineranleitung` verwendet der Code (Programmseiten, Anlegen von Modulen und Programmen, Vertraulichkeit). Ihre Bezeichnung ist pflegbar. Deaktivieren, Kontexte ändern und Löschen sind gesperrt. + +## Regeln in allen Auswahlstellen + +Die Regeln liegen an einer Stelle, `App\Domain\Catalog\EditorialVocabulary`: + +- **Neu wählbar:** nur aktive Werte, Materialarten zusätzlich nur im zulässigen Kontext. „Programm“ und „Modul“ erscheinen deshalb nicht als Materialart eines Mediums. +- **Bestehende Zuordnungen:** Sie bleiben sichtbar und gekennzeichnet, mit „(inaktiv)“ oder „(hier nicht vorgesehen)“. + - Beim Speichern anderer Angaben bleiben sie erhalten (`IdentityDimension::replaceOffered`). + - Entfernt werden sie nur, wenn man sie ausdrücklich abwählt. +- **Serverseitige Prüfung:** Eine neu gesetzte Materialart wird geprüft. Inaktive oder nicht vorgesehene Arten weist das Speichern ab und öffnet das Register „Einordnung“. +- **Filter:** Sie bieten aktive Werte und zusätzlich verwendete inaktive Werte (gekennzeichnet) an. Ein gewählter Filter bleibt erhalten. +- **Mitgliederbibliothek (öffentlich):** zeigt nur aktive Werte und einen bereits gewählten. + +| Stelle | Anbindung | +|---|---| +| Redaktion Medium | Materialart (Kontext Medium), Einordnung, serverseitige Prüfung | +| Redaktion Lizenzartikel | Materialart (Kontext Lizenzartikel), Einordnung, serverseitige Prüfung | +| Redaktion Modul und Programm | Einordnung (die Materialart setzt das System beim Anlegen) | +| Medienmanager | Filter „Fachliche Materialart“ (`?inhaltsart=`) und „Einordnung“ (`?einordnung=`) | +| Arbeitsplatz, Module, Programme | Filter „Fachliche Einordnung“ (`?pillar=`) | +| Gemeinsamer Picker | neuer Filter „Fachliche Materialart“; Einordnungsfilter im Aufbau nach der Filterregel; Detail trennt „Fachliche Materialart“ und „Medienart“ | +| Mitgliederbibliothek | Einordnungsfilter | + +**Umbenennen wirkt sofort überall:** Bezeichnungen werden nirgends als Kopie gespeichert. Anzeigen lesen sie über die Beziehung, die Suche im Medienmanager durchsucht Titel- und Textfelder, Filter arbeiten mit der Kennung des Datensatzes. + +Der Begriff „Inhaltsart“ heißt durchgängig „Fachliche Materialart“: Redaktion, Rückmeldung zu geänderten Feldern, früherer Medieneditor, Redaktionsvorschau der Katalogkarten und Konsolenmeldung. Die technische Art heißt im Picker „Medienart“. + +## Migration + +`2026_11_20_200000_editorial_master_data_management` ergänzt nur. Es wird nichts umbenannt oder gelöscht, und `down()` entfernt nur die neuen Spalten. + +- **`editorial_content_kinds`:** neu sind `is_active` (Vorgabe: aktiv) und `contexts` (JSON). + - Die Kontexte werden einmalig abgeleitet: `programm` → Programm und Lizenzartikel, `modul` → Modul und Lizenzartikel, alle übrigen → Medium und Lizenzartikel. + - Danach kommt jeder Kontext hinzu, in dem die Art tatsächlich verwendet wird. Keine vorhandene Zuordnung wird dadurch unzulässig. +- **`editorial_dimension_values`:** neu sind `sort_order` (bisherige Reihenfolge nach Kennung, in Zehnerschritten) und `is_active`. +- **luf-test:** Die Migration lief mit dem Deploy (Lauf 4956). Ergebnis: 14 Materialarten mit Kontexten wie oben, alle aktiv. + +## Prüfung + +| Fall | Ergebnis | +|---|---| +| Tests (`RedaktionelleStammdatenTest`, 10 Tests) | Alle neun geforderten Fälle sind abgedeckt:
1. Anlegen und im passenden Editor wählen.
2. Speichern und über Einordnungs- und Materialartfilter finden.
3. Umbenennen: Kennung und Zuordnung bleiben; die Vertraulichkeit hängt an der Kennung.
4. Deaktivieren: Zuordnung sichtbar, „(inaktiv)“; bei einem anderen Medium nicht angeboten und serverseitig abgewiesen.
5. Teaser speichern: inaktive Zuordnung und inaktive Materialart bleiben.
6. Reaktivieren, „Nach unten“ und „Nach oben“.
7. Programm und Modul weder im Medieneditor noch im Medienfilter noch im Picker; Speichern abgewiesen.
8. Säulenverwaltung unverändert erreichbar.
9. Katalogverwalter erhält 403 auf Seite und Livewire-Komponente.
Zusätzlich: Kontextänderung mit Bestätigung, Löschen nur ohne Zuordnung, Systemkennungen geschützt, Picker- und Bibliotheksfilter mit inaktiven Werten, Verschieben ohne unbeteiligte Schreibzugriffe | +| luf-test, Ablauf mit Prüfwert | Prüfwert „UX-Prüfung Zielgruppe“ angelegt und dem Prüfmedium 22 „Testplatzhalter Hintergrund“ zugeordnet:
• Verwendung „1 Medium“; Medienfilter `?einordnung=20` findet das Medium.
• Umbenannt: sichtbar und gewählt.
• Deaktiviert: Dialog nennt „1 Medium“, im Medium „(inaktiv)“ und gewählt, beim Medium 10 nicht angeboten.
• Teaser gespeichert und zurückgesetzt: Zuordnung bleibt.
• Reaktiviert, nach oben und wieder nach unten.
• Materialart im Medium und im Picker ohne Programm und Modul.
• Zuordnung gelöst, Prüfwert gelöscht | +| luf-test, Datenbank | Vor und nach dem Ablauf lesend verglichen (Materialarten, Dimensionen, Werte, Zuordnungen, Materialart-Spalten): Bezeichnungen, Aktivstatus und alle Zuordnungen unverändert; Prüfwert entfernt; Teaser des Prüfmediums wieder leer. Einzige Änderung: Die fünf Zielgruppenwerte sind durch „Nach oben/unten“ auf 10 bis 50 umnummeriert (Reihenfolge unverändert, `updated_at` neu). Danach geändert: Verschieben tauscht nur noch zwei Einträge (Test) | +| Darstellung | 1440 × 900 und 1280 × 800 ohne waagerechten Überlauf; Bearbeitungsdialog mit Kennung und Kontexten; Verwendungsdialog mit Links | + +## Einschränkungen + +- **Kontexte:** gibt es nur für Materialarten. Einordnungswerte gelten wie bisher für alle Objektarten. Fachliche Kombinationen tragen keine Materialart. +- **Säulen-Spiegel (bestehender Restpunkt, nicht geändert):** Die Dimension „Fachliche Säule“ ist eine Kopie der Säulen aus der Migration vom 16.11. Module, Programme und Lizenzartikel bieten sie weiterhin an, sie wird aber nicht mit der Säulenverwaltung abgeglichen. Medien verwenden die Säulen direkt. +- **Löschen:** nur ohne Zuordnung. Es gibt kein Zusammenführen und kein Umdeuten von Werten. +- **Bezeichnungen:** Innerhalb einer Gruppe darf eine Bezeichnung nur einmal vorkommen, ohne Unterscheidung von Groß- und Kleinschreibung. +- **Picker-Filter:** Der Filter „Fachliche Materialart“ grenzt nur Medien ein. Module im Aufbau-Picker bleiben davon unberührt. +- **Schmale Fenster:** Unter etwa 1100 px Inhaltsbreite scrollt die Tabelle waagerecht (Filament-Tabelle). + +## Belege + +| | | +|---|---| +| ![Materialarten 1440](stammdaten/01-materialarten-1440.jpg) | ![Materialarten 1280](stammdaten/02-materialarten-1280.jpg) | +| ![Zielgruppe mit Prüfwert](stammdaten/03-zielgruppe.jpg) | ![Verwendung](stammdaten/04-verwendung.jpg) | +| ![Einordnung im Medium](stammdaten/05-einordnung.jpg) | ![Inaktive Zuordnung bleibt sichtbar](stammdaten/06-inaktiv.jpg) | +| ![Picker mit fachlicher Materialart](stammdaten/07-picker.jpg) | | diff --git a/docs/ux/verwaltung/abnahme/stammdaten/01-materialarten-1440.jpg b/docs/ux/verwaltung/abnahme/stammdaten/01-materialarten-1440.jpg new file mode 100644 index 0000000..e7f7a7e Binary files /dev/null and b/docs/ux/verwaltung/abnahme/stammdaten/01-materialarten-1440.jpg differ diff --git a/docs/ux/verwaltung/abnahme/stammdaten/02-materialarten-1280.jpg b/docs/ux/verwaltung/abnahme/stammdaten/02-materialarten-1280.jpg new file mode 100644 index 0000000..dd3c47f Binary files /dev/null and b/docs/ux/verwaltung/abnahme/stammdaten/02-materialarten-1280.jpg differ diff --git a/docs/ux/verwaltung/abnahme/stammdaten/03-zielgruppe.jpg b/docs/ux/verwaltung/abnahme/stammdaten/03-zielgruppe.jpg new file mode 100644 index 0000000..e7c0b8a Binary files /dev/null and b/docs/ux/verwaltung/abnahme/stammdaten/03-zielgruppe.jpg differ diff --git a/docs/ux/verwaltung/abnahme/stammdaten/04-verwendung.jpg b/docs/ux/verwaltung/abnahme/stammdaten/04-verwendung.jpg new file mode 100644 index 0000000..dbb6e8a Binary files /dev/null and b/docs/ux/verwaltung/abnahme/stammdaten/04-verwendung.jpg differ diff --git a/docs/ux/verwaltung/abnahme/stammdaten/05-einordnung.jpg b/docs/ux/verwaltung/abnahme/stammdaten/05-einordnung.jpg new file mode 100644 index 0000000..7a3f949 Binary files /dev/null and b/docs/ux/verwaltung/abnahme/stammdaten/05-einordnung.jpg differ diff --git a/docs/ux/verwaltung/abnahme/stammdaten/06-inaktiv.jpg b/docs/ux/verwaltung/abnahme/stammdaten/06-inaktiv.jpg new file mode 100644 index 0000000..8fb664b Binary files /dev/null and b/docs/ux/verwaltung/abnahme/stammdaten/06-inaktiv.jpg differ diff --git a/docs/ux/verwaltung/abnahme/stammdaten/07-picker.jpg b/docs/ux/verwaltung/abnahme/stammdaten/07-picker.jpg new file mode 100644 index 0000000..4aa1a05 Binary files /dev/null and b/docs/ux/verwaltung/abnahme/stammdaten/07-picker.jpg differ diff --git a/docs/ux/verwaltung/abnahme/teil-a.md b/docs/ux/verwaltung/abnahme/teil-a.md new file mode 100644 index 0000000..5135b34 --- /dev/null +++ b/docs/ux/verwaltung/abnahme/teil-a.md @@ -0,0 +1,147 @@ +# Abnahme Teil A, Abschnitt 1: Redaktionsmanager + +Stand: 19.11.2026. **Geprüfter Code-Stand:** `develop` mit Commit `baa7691` auf der Testinstanz `luf-test` (Image `luf-app-test:baa7691…`, Deploy-Lauf 4888 grün), Prüfkonto der Redaktion. Spätere Commits ändern nur Dokumentation. Keine fachliche Freigabe und kein Produktivdeployment. + +## Aufgabe und Maßstab + +- **Objekt:** ein Medium, Modul, Programm oder Lizenzartikel als Ganzes. **Aufgabe:** beschreibende Texte, Präsentationsmedien und Einordnung pflegen und die Wirkung prüfen. **Unmittelbar dazu:** Herkunft je Text, Website-Status je zugeordnetem Medium, Speicherumfang, Ausgabe. **Woanders:** Datei und Fassungen (Medieneditor), Aufbau und Didaktik (Aufbau), Stand, Preis und Rechte (Lizenzartikel). Zuordnung im Detail: [Dokument 16](../16-funktionszuordnung.md). +- **Maßstab:** [Dokument 14](../14-verwaltungsstandard.md), [Dokument 09](../09-redaktionsarbeitsplatz-entwurf.md) mit [Redaktionsübersicht 1](../bilder/redaktion-01-uebersicht.png) und [Register am Film](../bilder/redaktion-register-medium-v1.png); Picker nach [Listenbasis v2](../bilder/auswahl-01-liste-detail-v2.png). +- **Gemeinsame Bausteine** (von Medium, Modul/Programm und Lizenzartikel benutzt): `verwaltung/kopf` (Objektkopf mit Status, Aktionen, Weitere Aktionen), `verwaltung/redaktion` (Manager), `verwaltung/texte` + `textfeld`, `verwaltung/praesentation` + `zuordnung-menue`, `verwaltung/einordnung`, `verwaltung/varianten`, `verwaltung/picker` (Präsentation, Austausch, Bestandteil im Aufbau, Vorschaubild), `verwaltung/bestaetigung` (statt Browser-`confirm()`), `verwaltung/abgang` (Warnung beim Verlassen), `verwaltung/styles` (Tokens, siehe [tokens.md](../tokens.md)). Logik im Trait `ManagesEditorialSurface`, Schreiben über `PresentationMedia::commit`. +- **Offene Fachfragen** OFF-19 (Zielgruppe/Ausgabe), OFF-20 (leere eigene Werte, übernommene Medienrollen), OFF-21 (Galerie/Slideshow) wurden nicht entschieden. Ein leeres eigenes Feld übernimmt wie bisher die Quelle. + +## Ergebnis + +- **Vorher:** Redaktion in halber Seitenbreite; doppelter Titel und mehrere „Redaktion bearbeiten“; Picker im Medium als ungestaltete Radioliste in 500 px; zwei unterschiedliche Picker; Zuordnungen wurden sofort geschrieben, Austausch hängte das neue Medium ans Ende; Didaktikdialog und Website-Freigabe speicherten offene Redaktionseingaben verdeckt mit; ein zweites Formular („Bearbeiten“ in der Medienliste) bearbeitete dieselben Texte anders; Lizenzartikel ohne erkennbare Herkunft. +- **Nachher:** ein Objektkopf (Rückweg, Pfad mit Link zur Liste, Titel, Typzeile, Statuszeilen, Hauptaktion, „Weitere Aktionen“). Drei Register mit Änderungsmarken. Texte als Lesezeilen mit gezielter Bearbeitung, Herkunft „Übernommen aus …“ / „Eigene Angabe“, „Wieder aus der Quelle übernehmen“, „Änderung zurücknehmen“. Präsentationsmedien nach Rolle mit Vorschau, Website-Status, Austauschen an gleicher Stelle, Zuordnung entfernen, Ziehen und Pfeilknöpfe nur innerhalb der Rolle, Galerie als nummerierte Kacheln mit Menü. Eine belegte Einzelrolle (Titelbild, Hero, Hover) wird im Picker ausdrücklich „ausgetauscht“, nicht stillschweigend überschrieben. Ein visueller Picker für alle Zwecke: Liste mit Vorschau, Detail des betrachteten Eintrags, getrennte Auswahl, Auswahlchips über Suche und Filter hinweg, benannte Übernahme. +- **Speicherwirkung:** „Redaktion speichern“ (auch Strg+S) schreibt Texte, Einordnung, Präsentationszuordnungen und abweichende Formulierungen gemeinsam; Zuordnungen, die inzwischen anderswo hinzugekommen sind, bleiben erhalten. Keine Fassung, keine Website-Freigabe, kein Aufbau. Website-Freigabe eines zugeordneten Mediums ist eine eigene, sofort und global wirksame Handlung mit Bestätigungsdialog. „Verwerfen“ setzt nach Bestätigung nur die Redaktion zurück. Verlassen der Seite mit offenen Änderungen fragt der Browser nach. +- **Rückweg:** Manager und Ausgangseditor sind dieselbe Livewire-Komponente. Wechsel per Knopf und per Browser-Zurück/-Vor (`?redaktion=1`) erhält offene Eingaben beider Seiten; der Ausgangseditor zeigt „Redaktion mit ungespeicherten Änderungen · Zur Redaktion“. Wer nach „Zurück zur Medienbearbeitung“ im Browser zurückblättert, landet wieder in der Redaktion (gewöhnliches Verlaufsverhalten, Inhalte bleiben erhalten). +- **Daten:** kein neues Datenmodell, keine Migration. Neu sind nur Lese-/Schreibmethoden an `PresentationMedia` (`staged`, `describe`, `refusal`, `commit`), die bestehende Regeln einhalten. Das frühere Gesamtformular `…/bearbeiten` leitet nach der Rechteprüfung in die Redaktion; „Medium löschen“ (nur ohne Fassung) steht jetzt unter „Weitere Aktionen“. Die seit 72130d6 fehlende Übernahme eines vorhandenen Bildes als Vorschaubild ist über den Picker wieder erreichbar. + +## Tatsächliche Prüfung + +| Prüffall | Ergebnis / Beleg | Grenze | +|---|---|---| +| Referenzablauf Dokument 15 am Medium „Lara im Park“ | Bestanden auf luf-test (`baa7691`): Alternativtext im Editor offen geändert → Redaktion → Teaser geändert → zwei Galeriebilder per Mehrfachauswahl und ein Titelbild → per Tastatur/Menü umsortiert → Galeriebild ausgetauscht (bleibt an Position 1) → zurück: Eingabe erhalten, Status zeigt offene Redaktion → wieder Redaktion, Zuordnungen unverändert → gespeichert → Editor-Eingabe weiter offen → Neuladen: Redaktion gespeichert, Alternativtext unverändert gespeichert. Danach auf Ausgangsstand zurückgesetzt. Bilder 01–07 | Film ohne Datei im Picker nicht geprüft | +| Modul „Modul Abstand“ | Bestanden: Bestandteil verschoben (ungespeichert) → Redaktion, Kurzbeschreibung und Titelbild → zurück: Reihenfolge und beide Statuszeilen erhalten → Redaktion gespeichert, Aufbau bleibt ungespeichert → „Entwurf verwerfen“ setzt nur den Aufbau zurück. Aufgeräumt. Bilder 08–09 | Programm nur lokal und in Tests | +| Lizenzartikel „abstand-trainer“ | Bestanden: Überblick, Quelle „Programm Abstand“, eigene Kurzbeschreibung mit „Eigene Angabe“ und „Geändert“, „Wieder aus der Quelle übernehmen“, ohne Speichern verlassen. Bilder 10–11 | Quelle hat auf luf-test keine Texte; „Übernommen aus …“ mit Wert in `EditorialDeskTest` belegt | +| Dialoge (14 Aktionen) | luf-test: Neue Fassung anlegen, Fassung deaktivieren, Fassung freigeben, Medium löschen, Vorschaubild aus dem Bestand, Aus Mitgliederbibliothek ausblenden, Didaktik und Katalogbild, Bestandteil bearbeiten, Text erstellen, Bestandteil auswählen, Medium anlegen (aus dem Picker, Picker vorher geschlossen), Stand veröffentlichen, Stand zurückziehen: jeweils geöffnet, Fokus im Dialog, mit Esc geschlossen. „Fassung freigeben“ im Aufbau öffnet bei unverändertem Aufbau bewusst keinen Dialog, sondern meldet das. Bilder 17–21 | Absenden der Dialoge nicht im Browser (fachlich durch Tests abgedeckt) | +| Verwerfen, Abgangswarnung | luf-test: „Verwerfen“ fragt im gemeinsamen Dialog, Bestätigen stellt den gespeicherten Teaser wieder her; Seitenwechsel mit offenen Änderungen löst die Browserwarnung aus, ohne offene Änderungen nicht | – | +| Abbrechen, Austausch, Entfernen, gleichzeitige Änderung | Feature-Tests: Abbrechen im Austausch lässt Zuordnung unverändert; Austausch an gleicher Stelle; belegte Einzelrolle als Austausch; Entfernen löst nur die Referenz, Medium und Website-Freigabe bleiben; eine zwischenzeitlich von anderer Seite ergänzte Zuordnung bleibt beim Speichern erhalten | gleichzeitige Bearbeitung im Browser nicht nachgestellt | +| Fehlerzustand | Leerer Arbeitstitel: Speichern bricht ab, Register springt auf Texte, Fehler am Feld, übrige Eingaben bleiben (Feature-Test) | im Browser nicht ausgelöst | +| Rechte | Feature-Tests: Katalogverwalter sieht beim Medium keine Redaktion (auch nicht über `?redaktion=1`), Speichern, Picker und Entfernen ergeben 403; Redakteur ohne Katalogrolle erhält beim Lizenzartikel 403; Katalogverwalter sieht am Artikel kein Website-Freigabemenü | – | +| Tastatur, Fokus | luf-test: Register mit Pfeiltasten und Enter; Fokus bleibt 30 von 30 Tabulatorschritten im Picker; Esc schließt Picker, Menüs und Dialoge; Sortieren und Zeilenmenü per Enter. Strg+S lokal geprüft | Bildschirmleser nicht geprüft | +| Browser-Zurück/-Vor | luf-test: Zurück schließt die Redaktion, offene Eingaben beider Seiten bleiben; Vor öffnet sie mit dem Arbeitsstand | – | +| Breiten | luf-test bei 1440, 1180 (Seitenleiste sichtbar), 900 und 760 px ohne waagerechtes Scrollen; Picker ab 64 rem untereinander, unter 40 rem Vollbild; Bausteinkarten im Aufbau umbrechen. Bilder 12–16 | Browser-Zoom nicht gesondert geprüft (entspricht kleineren CSS-Breiten) | +| Repository-Prüfungen | Lokal `php artisan test`: 277 Tests grün; Pint auf Codepfaden grün; Gitea `ci-feature` und `deploy-test` für jeden Commit grün | Instanz-Suite nach dem Deploy existiert noch nicht (U0) | + +Tests mit Bezug: `VerwaltungArbeitsplatzTest` (Rückweg, Browser-Zurück, Arbeitsstand, gleichzeitige Änderung, Einzelrolle, Vorschaubild aus dem Bestand, Bestätigung, Rechte, Abbrechen, Austausch/Sortierung, Entfernen, Verwerfen, Fehler, keine verdeckte Speicherung im Didaktikdialog und bei der Website-Freigabe, Medium anlegen aus dem Picker), `EditorialDeskTest`, `PresentationMediaTest`, `MediaEditorTest`, `MediaAdministrationTest`, `MediaLibraryTest`, `EditorialEditorTest`, `WebsiteReleaseTest`, `CatalogAdministrationTest`. Angepasste Tests prüften alte Orte (Bereich „Beschreibung“, Dialog „Modul bearbeiten“, Gesamtformular) oder CSS-Zeichenketten; sie prüfen jetzt dieselbe Wirkung am neuen Ort. + +## Belege + +| | | +|---|---| +| ![Medieneditor](teil-a/01-medium-editor.jpg) | ![Texte geändert](teil-a/02-redaktion-texte-geaendert.jpg) | +| ![Picker Mehrfachauswahl](teil-a/03-picker-mehrfachauswahl.jpg) | ![Picker Austausch](teil-a/04-picker-austausch.jpg) | +| ![Arbeitsstand Präsentationsmedien](teil-a/05-praesentationsmedien-arbeitsstand.jpg) | ![Rückkehr mit offenen Eingaben](teil-a/06-rueckkehr-offene-eingaben.jpg) | +| ![Gespeichert](teil-a/07-redaktion-gespeichert.jpg) | ![Modul mit offenem Aufbau und offener Redaktion](teil-a/08-modul-aufbau-und-redaktion-offen.jpg) | +| ![Ausgabe prüfen am Modul](teil-a/09-modul-ausgabe-pruefen.jpg) | ![Lizenzartikel Überblick](teil-a/10-lizenzartikel-ueberblick.jpg) | +| ![Lizenzartikel eigene Angabe](teil-a/11-lizenzartikel-eigene-angabe.jpg) | ![1180 px Texte](teil-a/12-schmal-1180-texte.jpg) | +| ![900 px Einordnung](teil-a/13-schmal-900-einordnung.jpg) | ![760 px Picker](teil-a/14-schmal-760-picker.jpg) | +| ![900 px Medium](teil-a/15-schmal-900-medium.jpg) | ![760 px Aufbau](teil-a/16-schmal-760-aufbau.jpg) | +| ![Verwerfen bestätigen](teil-a/17-bestaetigung-verwerfen.jpg) | ![Dialog Neue Fassung](teil-a/18-dialog-neue-fassung.jpg) | +| ![Vorschaubild aus dem Bestand](teil-a/19-dialog-vorschaubild-aus-dem-bestand.jpg) | ![Didaktik und Katalogbild](teil-a/20-dialog-didaktik.jpg) | +| ![Medium anlegen aus dem Picker](teil-a/21-dialog-medium-anlegen-aus-picker.jpg) | | + +## Verbleibende Abweichungen + +1. ~~Aufbauarbeitsplatz noch nicht nach dem kombinierten Aufbaubild~~ – erledigt in Abschnitt 2 (unten). +2. ~~Medieneditor ohne Struktur links / Detail rechts~~ – erledigt in Abschnitt 3 (unten). +3. **Zwei Dialogarten:** Formularaktionen (Neue Fassung, Freigaben, Deaktivieren, Löschen, Medium anlegen, Bibliothek) sind Filament-Dialoge; Picker, Bestätigungen, Fassungsfreigabe im Aufbau und „Neuen Text erstellen“ sind der gemeinsame `vw`-Dialog. Seit Abschnitt 3 tragen Filament-Hauptknöpfe das Verwaltungsgrün; Filament stellt die Hauptaktion links vor „Abbrechen“, die `vw`-Dialoge rechts danach. Alle haben Fokusfalle und Esc. +4. **„Ausgabe prüfen“:** Medium zeigt Website- und Bibliothekskarte; Arbeitstitel, Anzeigename und Kurzbeschreibung mit aktuellen Eingaben, Bild und übrige Angaben gespeichert (so im Dialog benannt). Modul/Programm zeigt die Website-Karte im gespeicherten Stand und sagt das. Lizenzartikel hat keine eigene Ausgabe, daher kein Knopf. +5. **Picker:** Reine Textelemente werden in der Präsentation nicht angeboten (sie sind keine Präsentationsmedien); Dokumente bleiben wählbar. Keine Listen-/Kachel-Umschaltung mehr; die Liste mit Vorschau ist die gewählte Basis. Ein neues Medium lässt sich nur im Aufbau-Picker anlegen, nicht im Präsentationskontext. +6. **Schrift:** Die Verwaltung nutzt die Panelschrift; die Markenschriften sind dort nicht geladen. +7. Nicht geprüft: Bildschirmleser, Hochkontrastmodus, gleichzeitige Bearbeitung durch zwei Personen im Browser. + +--- + +# Abschnitt 2: Aufbauarbeitsplatz + +Stand: 20.11.2026. **Geprüfter Code-Stand:** `develop` mit `105d27f` (Abläufe) und `a994c87` (Register „Fassungen und Verwendung“ nach der Chip-Korrektur `60f5b8e`) auf `luf-test`, Prüfkonto der Redaktion. Keine fachliche Freigabe und kein Produktivdeployment. + +## Aufgabe und Maßstab + +- **Objekt:** ein Modul oder Programm. **Aufgabe:** Bestandteile zusammenstellen und ordnen, ihre Verwendung an dieser Stelle beschreiben, Didaktik und Katalogbild pflegen, eine Fassung freigeben. **Unmittelbar dazu:** referenzierte Quelle und Fassung jedes Bestandteils, Inhalt einer referenzierten Quelle (nur zur Ansicht), Speicher- und Bibliotheksstand. **Woanders:** Texte, Präsentationsmedien, Einordnung (Redaktion); Inhalt einer Quelle (eigener Editor). +- **Maßstab:** [kombinierter Aufbauarbeitsplatz](../bilder/aufbau-kombiniert-v1.png), [Dokument 06](../06-aufbau-arbeitsplatz-entwurf.md), [Dokument 14](../14-verwaltungsstandard.md) Abschnitt 4. +- **Gemeinsame Bausteine:** `verwaltung/kopf`, `verwaltung/picker` (Zweck Aufbau), `verwaltung/bestaetigung`, `verwaltung/abgang`, `verwaltung/redaktion`; neu `verwaltung/aufbau` (Struktur links, Detail rechts), `aufbau-angaben`, `aufbau-verlauf`. Die Klassen `vw-aufbau`, `vw-struktur`, `vw-baustein`, `vw-detailbereich` nutzt auch der Medieneditor (Abschnitt 3). + +## Ergebnis + +- **Vorher:** Kartenliste mit rechter Spalte (zweiter Titel, Präsentationsmedien), Dialog „Bestandteil bearbeiten“ für Rolle, Hinweis und Quelltext, Dialog „Modul bearbeiten“, fünf Kopfaktionen, ältere `luf`-Dialoge ohne Fokusfalle. +- **Nachher:** Kopf mit „Vorschau für Trainer“, „Redaktion bearbeiten“, „Entwurf speichern“ und „Weitere Aktionen“ (Fassung freigeben, Bibliothek anzeigen/ausblenden, Entwurf verwerfen). Register „Aufbau“, „Didaktik und Katalogbild“, „Fassungen und Verwendung“. Struktur links: nummerierte Bausteinkarten mit Vorschau, Typ, Fassung und Rolle; Module klappen ihren Quelleninhalt „Nur zur Ansicht“ auf; Reihenfolge per Ziehen, Alt+Pfeil oder die Knöpfe unter der Liste („Position 2 von 4“). Detail rechts für die gewählte Verwendung: „An dieser Stelle“ (Rolle, Hinweis; „Gilt nur hier. Die Quelle bleibt unverändert.“), „Quelle“ (Quelltext, Quelle bearbeiten), „Inhaltsvorschau“. +- **Speicherwirkung:** Rolle, Hinweis, Reihenfolge, Bestandteile und Didaktik sind Entwurf und werden nur mit „Entwurf speichern“ (Strg+S) gesichert; Auswahlwechsel und Registerwechsel speichern nichts verdeckt. Das Katalogbild wirkt sofort ohne Fassung. „Fassung freigeben“ zeigt im `vw`-Dialog, was schon freigegeben ist, was mit freigegeben wird und was die Freigabe verhindert. +- **Korrekturen nach der Prüfung auf luf-test:** Ein aufgeklapptes Modul blieb nach dem Verschieben an der alten Position aufgeklappt (Zustand hing am Index, jetzt an der Quelle). Der Hinweis „noch keine Fassung sichtbar“ widersprach der Liste, obwohl Fassung 1 in der Bibliothek war; der Stand-Chip „In der Mitgliederbibliothek“ neben „Fassung 2“ las sich, als wäre Fassung 2 sichtbar (jetzt „Bibliothek zeigt Fassung 1“, auch auf den Arbeitsplatzkarten). Das Menü im Detailbereich hat einen eigenen zugänglichen Namen. + +## Tatsächliche Prüfung + +| Prüffall | Ergebnis / Beleg | Grenze | +|---|---|---| +| Programm „Programm Abstand“ (luf-test, 1440/900/760 px) | Bestanden: Modul aufgeklappt (Quelle „Trainerunterlage Abstand“, „Lara im Park“) → erste Verwendung gewählt, Rolle „Prüfung Einstieg“ und Hinweis lokal geändert → andere Verwendung gewählt und zurück: Eingaben erhalten → nach unten verschoben, aufgeklappter Inhalt wandert mit → Quelle, Inhaltsvorschau → Redaktion und zurück: Reihenfolge und Status „Änderungen am Aufbau nicht gespeichert“ erhalten → Entwurf gespeichert („Es entsteht keine neue Fassung“) → Neuladen: Reihenfolge gespeichert → „Entwurf verwerfen“: Ausgangsstand. Bilder 22–30 | – | +| Verdecktes Speichern | Feature-Tests: Auswahlwechsel, Hinzufügen und Rückkehr aus der Redaktion schreiben keinen Entwurf; Didaktik nur mit „Entwurf speichern“ | – | +| Rechte, Freigabe, Bibliothek | Feature-Tests (`EditorialEditorTest`, `VerwaltungArbeitsplatzTest`): Freigabedialog mit Zustimmung für mitfreizugebende Bestandteile, Bibliothekshinweis nennt die sichtbare Fassung | Freigabe im Browser nicht ausgelöst (würde eine unveränderliche Fassung auf luf-test erzeugen) | +| Repository | Lokal 281 Tests grün (bei `105d27f`), Pint grün, `ci-feature` und `deploy-test` grün | – | + +--- + +# Abschnitt 3: Medieneditor + +Stand: 20.11.2026. **Geprüfter Code-Stand:** `develop` mit `0a8ff07` (Abläufe) und `7b712e0` (Dialog-Einstiege, Deploy-Lauf 4908 grün) auf `luf-test`, Prüfkonto der Redaktion; Breiten 900/760 px zusätzlich bei `a994c87` durchlaufen. Keine fachliche Freigabe und kein Produktivdeployment. + +## Aufgabe und Maßstab + +- **Objekt:** ein Medium. **Aufgabe:** Datei bzw. Lehrtext in Fassungen führen, Fassungen freigeben oder deaktivieren, Vorschaubild wählen, Verwendung und Website-Freigabe überblicken. **Unmittelbar dazu:** Status, Änderungsnotiz, Begründung einer Deaktivierung, Freigabehindernis und Einbindung je Fassung. **Woanders:** Texte, Präsentationsmedien, Einordnung (Redaktion). +- **Maßstab:** [Dokument 14](../14-verwaltungsstandard.md) Abschnitt 4 („Medien verwenden denselben Rahmen mit ihren tatsächlichen Datei- und Fassungsfunktionen“), [Dokument 15](../15-umbauauftrag.md) Teil A („Den tatsächlichen Medieneditor einordnen; seine Datei-, Verarbeitungs-, Rechte- und Fassungsfunktionen erhalten“), Rahmen des [kombinierten Aufbaubilds](../bilder/aufbau-kombiniert-v1.png). +- **Gemeinsame Bausteine:** `verwaltung/kopf`, Register, Aufbau-Rahmen (`vw-aufbau`, `vw-struktur`, `vw-baustein` mit Modifikator `is-fest` für nicht sortierbare Zeilen, `vw-detailbereich`), `verwaltung/bestaetigung` (Fassungswechsel mit offenem Text, Website-Freigabe zurücknehmen), `verwaltung/abgang`, `verwaltung/picker` (Zweck Vorschaubild), `filament.media.preview-frame` (auch „Ausgabe prüfen“ der Redaktion). Andere Nutzungen geprüft: Aufbau (unverändert, eigene Modifikatorklasse), Kopf-Statuspunkt (eine zunächst überschriebene Klasse `vw-punkt` wurde vor dem Commit auf einen Modifikator zurückgeführt). + +## Ergebnis + +- **Vorher:** Bereich „Inhalt“ mit Abspieler und daneben einem Kasten „Vorschaubild“ mit fünf gestapelten Knöpfen; Fassungen als eigener Bereich ohne Inhalt; Lehrtext doppelt (gerendert und im Feld); Wechsel der Fassung verwarf einen offenen Lehrtext still; „Text speichern“ ließ die alte Fassung ausgewählt; Verwendung doppelt (Aufklappliste und Textzeilen); ältere `luf`-Knöpfe. +- **Nachher:** Register „Inhalt und Fassungen“ im Aufbau-Rahmen: Fassungen links (neueste zuerst, Status mit Punkt, Datum, Änderungsnotiz), gewählte Fassung rechts mit „Im eigenen Tab“, „Deaktivieren“ bzw. „Diese Fassung freigeben“, Hinweisbändern, Abspieler oder bearbeitbarem Lehrtext und „Eingebunden in“ (Module und Programme genau dieser Fassung). Medien ohne Fassung zeigen „Noch keine Inhaltsfassung“ mit „Erste Fassung anlegen“ statt einer leeren Spalte. Register „Vorschaubild“ wie „Didaktik und Katalogbild“: Bild, Herkunft, Alternativtext; rechts „Vorschaubild ändern“ mit Filmstelle (beginnt bei der Stelle des aktuellen Bildes) oder Hochladen, Bilddatei, Bestand. „Verwendung“ als verlinkte Liste, getrennt nach Modulen/Programmen und Lizenzartikeln. +- **Speicherwirkung:** „Text speichern“ ändert eine noch nirgends verbindlich verwendete Fassung und legt sonst die nächste Fassung an (bestehende Regel `isCommitted`); der Hinweis unter dem Feld sagt vorher, welcher Fall gilt; danach ist die gespeicherte Fassung gewählt. Offener Lehrtext erscheint im Kopf („Text der Fassung nicht gespeichert“) und löst die Abgangswarnung aus; Fassungswechsel fragt „Ungespeicherten Text verwerfen?“. Vorschaubild und Alternativtext wirken sofort ohne Fassung. „Fassung freigeben“ steht an der Fassung; der offene Entwurf zusätzlich unter „Weitere Aktionen“. Der Dialog „Neue Fassung anlegen“ nennt Zweck und Folgen und bestätigt mit „Fassung anlegen“. +- **Fehler beim Prüfen gefunden und behoben:** Ohne ausdrückliche Auswahl zeigte der Editor die neueste freigegebene Fassung. Nach „Neue Fassung anlegen“ (und ebenso nach dem Freigeben eines Entwurfs) wechselte die Anzeige deshalb still auf die andere Fassung, während das Textfeld noch den Wortlaut der bisherigen enthielt; „Text speichern“ schrieb ihn in die neue Fassung. Auf luf-test ist das beim Prüflauf am Prüfmedium passiert (Fassung 2 erhielt den Text von Fassung 1). Seit `0a8ff07` wird die gezeigte Fassung beim Öffnen festgehalten; Fassung 2 wurde über die Oberfläche auf den im Dialog eingegebenen Text zurückgesetzt und je Fassung nachgeprüft (auch nach Neuladen). Zwei Feature-Tests sichern das ab. +- **Erhalten:** Upload und Hintergrundübernahme, Entscheidungsmarke, Datei entfernen (Fassungsdialog), Freigeben mit und ohne Fassungsangabe, Deaktivieren mit Begründung, Löschen nur ohne Fassung, Filmstelle, eigenes Bild, Bild aus dem Bestand, Website-Freigabe mit Rückfrage, Karten-Vorschau, Rechteprüfung (`ContentElementResource::editor()`). Adresse `?bereich=fassungen&fassung=…` öffnet das zusammengelegte Register mit der Fassung. + +## Tatsächliche Prüfung + +| Prüffall | Ergebnis / Beleg | Grenze | +|---|---|---| +| Film „Lara im Park“ (luf-test) | Fassung 1 mit echtem Abspieler und „Eingebunden in“; Register Vorschaubild mit Filmstelle 41,5 s; Verwendung mit acht Modul- und Programmfassungen und einem Lizenzartikel, je mit genutzter Fassung und Rolle. Nur angesehen. Bilder 31, 37, 38 | Kein Film mit mehreren Fassungen auf luf-test | +| Prüfmedium „UX-Pilot Hinweis“ (luf-test, Text) | „Neue Fassung anlegen“ → Fassung 2 angelegt und gewählt → Text ergänzt (Kopf: „Text der Fassung nicht gespeichert“) → Fassung 1 gewählt: Bestätigungsdialog → Esc: Fassung 2 und Text bleiben → Redaktion und zurück: Text bleibt → erneut gewechselt, „Verwerfen und wechseln“: Fassung 1, Status ohne offenen Text → Fassung 2 gewählt, Zeile ergänzt, „Text speichern“: „Der Text ist in Fassung 2 gespeichert. Es entsteht keine neue Fassung.“ → Neuladen: gespeichert → Ausgangstext wiederhergestellt. Alte Adresse `bereich=fassungen` öffnet „Inhalt und Fassungen“. Bilder 32–36 | **Bleibend:** Das Prüfmedium hat jetzt Fassung 2 (Fassungen lassen sich nicht löschen) | +| Dialog-Einstiege (luf-test, nie abgesendet) | „Deaktivieren“ an Fassung 2 des Prüfmediums → „Fassung 2 deaktivieren“ mit Pflichtfeld Begründung; „Diese Fassung freigeben“ und „Weitere Aktionen → Entwurf Fassung 1 freigeben“ am Entwurfsmedium (id 10) → „Fassung 1 freigeben“, Argument `version` jeweils die richtige Fassung. Fokus im Dialog, Esc schließt, Fassungsliste danach unverändert. Nebenwirkung der Knopffarbe im CMS-Dialog „Navigationspunkt erstellen“: nur „Erstellen“ grün, „Erstellen & weiterer Eintrag“ und „Abbrechen“ unverändert. Bilder 42–43 | – | +| Medium ohne Fassung | luf-test „Lara Felix Park Original“: Hinweis und „Erste Fassung anlegen“, kein leerer Strukturbereich; „Die Bilddatei verwenden“ erscheint ohne Datei nicht. Bild 39 | – | +| Breiten | luf-test bei 1440, 900 und 760 px: unter 82 rem stehen Fassungen über der gewählten Fassung, ohne waagerechtes Scrollen. Bilder 40–41 | – | +| Feature-Tests | Fassungswechsel mit offenem Text (Abbrechen, Bestätigen), Freigabe einer anderen Fassung, neue Fassung aus dem Dialog und eine fremde `?fassung=`-Angabe verschieben keinen Text, Dialogtitel nennen die Fassung, neue Fassung beim Speichern einer verwendeten Fassung wird gewählt, Liste und Detail mit Freigegeben/Entwurf/Deaktiviert und Begründung, alte Adresse, Medium ohne Fassung, Startwert der Filmstelle. Bewusst angepasst: Lehrtext steht nur im Feld (`assertSet`), Filmstelle im Register Vorschaubild, Verwendung als verlinkte Liste | Freigeben/Deaktivieren im Browser nicht ausgelöst (unumkehrbar auf luf-test), in Tests abgedeckt | +| Repository | Lokal 290 Tests grün, Pint grün, `ci-feature` und `deploy-test` für jeden Commit grün | Instanz-Suite (U0) existiert noch nicht | + +## Belege Abschnitte 2 und 3 + +| | | +|---|---| +| ![Programm Aufbau](teil-a/22-aufbau-programm.jpg) | ![Quelle aufgeklappt](teil-a/23-aufbau-quelle-aufgeklappt.jpg) | +| ![Lokal geändert und verschoben](teil-a/24-aufbau-lokal-geaendert.jpg) | ![Detail Quelle](teil-a/25-aufbau-quelle.jpg) | +| ![Inhaltsvorschau](teil-a/26-aufbau-inhaltsvorschau.jpg) | ![Didaktik und Katalogbild](teil-a/27-aufbau-didaktik-katalogbild.jpg) | +| ![Fassungen und Verwendung](teil-a/28-aufbau-fassungen-verwendung.jpg) | ![900 px Aufbau](teil-a/29-aufbau-900.jpg) | +| ![760 px Aufbau](teil-a/30-aufbau-760.jpg) | ![Film, Fassung mit Abspieler](teil-a/31-medium-film-fassung.jpg) | +| ![Dialog Neue Fassung](teil-a/32-medium-dialog-neue-fassung.jpg) | ![Text mit zwei Fassungen](teil-a/33-medium-text-zwei-fassungen.jpg) | +| ![Wechsel bestätigen](teil-a/34-medium-wechsel-bestaetigen.jpg) | ![Ältere Fassung](teil-a/35-medium-aeltere-fassung.jpg) | +| ![Gespeichert](teil-a/36-medium-gespeichert.jpg) | ![Vorschaubild](teil-a/37-medium-vorschaubild.jpg) | +| ![Verwendung](teil-a/38-medium-verwendung.jpg) | ![Ohne Fassung](teil-a/39-medium-ohne-fassung.jpg) | +| ![900 px Medium](teil-a/40-medium-900.jpg) | ![760 px Medium](teil-a/41-medium-760.jpg) | +| ![Dialog Fassung deaktivieren](teil-a/42-medium-dialog-deaktivieren.jpg) | ![CMS-Dialog mit angeglichener Hauptaktion](teil-a/43-cms-dialog-knopffarbe.jpg) | + +## Verbleibende Abweichungen Abschnitte 2 und 3 + +1. **Register im Aufbau:** Das kombinierte Bild zeigt fünf Register (Aufbau, Angaben, Einordnung, Präsentation, Verlauf). Einordnung und Präsentation liegen nach Dokument 14 in der Redaktion; deshalb drei Register (Aufbau, Didaktik und Katalogbild, Fassungen und Verwendung). +2. **Katalogbild/Vorschaubild:** Aufbau und Medium nutzen dasselbe Muster, aber noch zwei Teilansichten mit eigenen Methoden; eine gemeinsame Bildwahl-Komponente steht aus. Im Aufbau startet die Filmstelle noch bei leerem Wert. +3. **Filament-Dialoge:** Reihenfolge Hauptaktion vor „Abbrechen“ (siehe Abschnitt 1, Punkt 3). Der Fassungsdialog zeigt das Feld „Entscheidungsmarke“ auch bei Texten (bestehendes Formular, unverändert). Die Angleichung der Hauptknöpfe an das Verwaltungsgrün gilt für **alle** Filament-Dialoge im Panel, also auch im CMS (Teil C); Kopfknöpfe von Filament-Seiten außerhalb von Dialogen (z. B. „Erstellen“ in der Navigation) bleiben vorerst im hellen Filament-Grün. +4. **Datei öffnen:** Unter dem Abspieler bleibt der schlichte Verweis „Datei öffnen“ aus dem gemeinsamen Abspieler (`content.player`, auch in der Vorschau verwendet). +5. Nicht geprüft: Bildschirmleser, Hochkontrast, Upload einer neuen Filmdatei im Browser (Hintergrundübernahme in `MediaAdministrationTest`). diff --git a/docs/ux/verwaltung/abnahme/teil-a/01-medium-editor.jpg b/docs/ux/verwaltung/abnahme/teil-a/01-medium-editor.jpg new file mode 100644 index 0000000..2df156b Binary files /dev/null and b/docs/ux/verwaltung/abnahme/teil-a/01-medium-editor.jpg differ diff --git a/docs/ux/verwaltung/abnahme/teil-a/02-redaktion-texte-geaendert.jpg b/docs/ux/verwaltung/abnahme/teil-a/02-redaktion-texte-geaendert.jpg new file mode 100644 index 0000000..4a6e428 Binary files /dev/null and b/docs/ux/verwaltung/abnahme/teil-a/02-redaktion-texte-geaendert.jpg differ diff --git a/docs/ux/verwaltung/abnahme/teil-a/03-picker-mehrfachauswahl.jpg b/docs/ux/verwaltung/abnahme/teil-a/03-picker-mehrfachauswahl.jpg new file mode 100644 index 0000000..741af0c Binary files /dev/null and b/docs/ux/verwaltung/abnahme/teil-a/03-picker-mehrfachauswahl.jpg differ diff --git a/docs/ux/verwaltung/abnahme/teil-a/04-picker-austausch.jpg b/docs/ux/verwaltung/abnahme/teil-a/04-picker-austausch.jpg new file mode 100644 index 0000000..28d4b95 Binary files /dev/null and b/docs/ux/verwaltung/abnahme/teil-a/04-picker-austausch.jpg differ diff --git a/docs/ux/verwaltung/abnahme/teil-a/05-praesentationsmedien-arbeitsstand.jpg b/docs/ux/verwaltung/abnahme/teil-a/05-praesentationsmedien-arbeitsstand.jpg new file mode 100644 index 0000000..da88838 Binary files /dev/null and b/docs/ux/verwaltung/abnahme/teil-a/05-praesentationsmedien-arbeitsstand.jpg differ diff --git a/docs/ux/verwaltung/abnahme/teil-a/06-rueckkehr-offene-eingaben.jpg b/docs/ux/verwaltung/abnahme/teil-a/06-rueckkehr-offene-eingaben.jpg new file mode 100644 index 0000000..38623fe Binary files /dev/null and b/docs/ux/verwaltung/abnahme/teil-a/06-rueckkehr-offene-eingaben.jpg differ diff --git a/docs/ux/verwaltung/abnahme/teil-a/07-redaktion-gespeichert.jpg b/docs/ux/verwaltung/abnahme/teil-a/07-redaktion-gespeichert.jpg new file mode 100644 index 0000000..43c2cc9 Binary files /dev/null and b/docs/ux/verwaltung/abnahme/teil-a/07-redaktion-gespeichert.jpg differ diff --git a/docs/ux/verwaltung/abnahme/teil-a/08-modul-aufbau-und-redaktion-offen.jpg b/docs/ux/verwaltung/abnahme/teil-a/08-modul-aufbau-und-redaktion-offen.jpg new file mode 100644 index 0000000..8bbb1c3 Binary files /dev/null and b/docs/ux/verwaltung/abnahme/teil-a/08-modul-aufbau-und-redaktion-offen.jpg differ diff --git a/docs/ux/verwaltung/abnahme/teil-a/09-modul-ausgabe-pruefen.jpg b/docs/ux/verwaltung/abnahme/teil-a/09-modul-ausgabe-pruefen.jpg new file mode 100644 index 0000000..a72493d Binary files /dev/null and b/docs/ux/verwaltung/abnahme/teil-a/09-modul-ausgabe-pruefen.jpg differ diff --git a/docs/ux/verwaltung/abnahme/teil-a/10-lizenzartikel-ueberblick.jpg b/docs/ux/verwaltung/abnahme/teil-a/10-lizenzartikel-ueberblick.jpg new file mode 100644 index 0000000..ccad4bf Binary files /dev/null and b/docs/ux/verwaltung/abnahme/teil-a/10-lizenzartikel-ueberblick.jpg differ diff --git a/docs/ux/verwaltung/abnahme/teil-a/11-lizenzartikel-eigene-angabe.jpg b/docs/ux/verwaltung/abnahme/teil-a/11-lizenzartikel-eigene-angabe.jpg new file mode 100644 index 0000000..7be60e8 Binary files /dev/null and b/docs/ux/verwaltung/abnahme/teil-a/11-lizenzartikel-eigene-angabe.jpg differ diff --git a/docs/ux/verwaltung/abnahme/teil-a/12-schmal-1180-texte.jpg b/docs/ux/verwaltung/abnahme/teil-a/12-schmal-1180-texte.jpg new file mode 100644 index 0000000..1c8695c Binary files /dev/null and b/docs/ux/verwaltung/abnahme/teil-a/12-schmal-1180-texte.jpg differ diff --git a/docs/ux/verwaltung/abnahme/teil-a/13-schmal-900-einordnung.jpg b/docs/ux/verwaltung/abnahme/teil-a/13-schmal-900-einordnung.jpg new file mode 100644 index 0000000..9bf60eb Binary files /dev/null and b/docs/ux/verwaltung/abnahme/teil-a/13-schmal-900-einordnung.jpg differ diff --git a/docs/ux/verwaltung/abnahme/teil-a/14-schmal-760-picker.jpg b/docs/ux/verwaltung/abnahme/teil-a/14-schmal-760-picker.jpg new file mode 100644 index 0000000..e0c109e Binary files /dev/null and b/docs/ux/verwaltung/abnahme/teil-a/14-schmal-760-picker.jpg differ diff --git a/docs/ux/verwaltung/abnahme/teil-a/15-schmal-900-medium.jpg b/docs/ux/verwaltung/abnahme/teil-a/15-schmal-900-medium.jpg new file mode 100644 index 0000000..c9cc807 Binary files /dev/null and b/docs/ux/verwaltung/abnahme/teil-a/15-schmal-900-medium.jpg differ diff --git a/docs/ux/verwaltung/abnahme/teil-a/16-schmal-760-aufbau.jpg b/docs/ux/verwaltung/abnahme/teil-a/16-schmal-760-aufbau.jpg new file mode 100644 index 0000000..c735310 Binary files /dev/null and b/docs/ux/verwaltung/abnahme/teil-a/16-schmal-760-aufbau.jpg differ diff --git a/docs/ux/verwaltung/abnahme/teil-a/17-bestaetigung-verwerfen.jpg b/docs/ux/verwaltung/abnahme/teil-a/17-bestaetigung-verwerfen.jpg new file mode 100644 index 0000000..5b079e3 Binary files /dev/null and b/docs/ux/verwaltung/abnahme/teil-a/17-bestaetigung-verwerfen.jpg differ diff --git a/docs/ux/verwaltung/abnahme/teil-a/18-dialog-neue-fassung.jpg b/docs/ux/verwaltung/abnahme/teil-a/18-dialog-neue-fassung.jpg new file mode 100644 index 0000000..1059dee Binary files /dev/null and b/docs/ux/verwaltung/abnahme/teil-a/18-dialog-neue-fassung.jpg differ diff --git a/docs/ux/verwaltung/abnahme/teil-a/19-dialog-vorschaubild-aus-dem-bestand.jpg b/docs/ux/verwaltung/abnahme/teil-a/19-dialog-vorschaubild-aus-dem-bestand.jpg new file mode 100644 index 0000000..1614b5b Binary files /dev/null and b/docs/ux/verwaltung/abnahme/teil-a/19-dialog-vorschaubild-aus-dem-bestand.jpg differ diff --git a/docs/ux/verwaltung/abnahme/teil-a/20-dialog-didaktik.jpg b/docs/ux/verwaltung/abnahme/teil-a/20-dialog-didaktik.jpg new file mode 100644 index 0000000..04dff77 Binary files /dev/null and b/docs/ux/verwaltung/abnahme/teil-a/20-dialog-didaktik.jpg differ diff --git a/docs/ux/verwaltung/abnahme/teil-a/21-dialog-medium-anlegen-aus-picker.jpg b/docs/ux/verwaltung/abnahme/teil-a/21-dialog-medium-anlegen-aus-picker.jpg new file mode 100644 index 0000000..15c11f1 Binary files /dev/null and b/docs/ux/verwaltung/abnahme/teil-a/21-dialog-medium-anlegen-aus-picker.jpg differ diff --git a/docs/ux/verwaltung/abnahme/teil-a/22-aufbau-programm.jpg b/docs/ux/verwaltung/abnahme/teil-a/22-aufbau-programm.jpg new file mode 100644 index 0000000..cf612e0 Binary files /dev/null and b/docs/ux/verwaltung/abnahme/teil-a/22-aufbau-programm.jpg differ diff --git a/docs/ux/verwaltung/abnahme/teil-a/23-aufbau-quelle-aufgeklappt.jpg b/docs/ux/verwaltung/abnahme/teil-a/23-aufbau-quelle-aufgeklappt.jpg new file mode 100644 index 0000000..70da8a2 Binary files /dev/null and b/docs/ux/verwaltung/abnahme/teil-a/23-aufbau-quelle-aufgeklappt.jpg differ diff --git a/docs/ux/verwaltung/abnahme/teil-a/24-aufbau-lokal-geaendert.jpg b/docs/ux/verwaltung/abnahme/teil-a/24-aufbau-lokal-geaendert.jpg new file mode 100644 index 0000000..a7b3ab7 Binary files /dev/null and b/docs/ux/verwaltung/abnahme/teil-a/24-aufbau-lokal-geaendert.jpg differ diff --git a/docs/ux/verwaltung/abnahme/teil-a/25-aufbau-quelle.jpg b/docs/ux/verwaltung/abnahme/teil-a/25-aufbau-quelle.jpg new file mode 100644 index 0000000..863d774 Binary files /dev/null and b/docs/ux/verwaltung/abnahme/teil-a/25-aufbau-quelle.jpg differ diff --git a/docs/ux/verwaltung/abnahme/teil-a/26-aufbau-inhaltsvorschau.jpg b/docs/ux/verwaltung/abnahme/teil-a/26-aufbau-inhaltsvorschau.jpg new file mode 100644 index 0000000..96fccec Binary files /dev/null and b/docs/ux/verwaltung/abnahme/teil-a/26-aufbau-inhaltsvorschau.jpg differ diff --git a/docs/ux/verwaltung/abnahme/teil-a/27-aufbau-didaktik-katalogbild.jpg b/docs/ux/verwaltung/abnahme/teil-a/27-aufbau-didaktik-katalogbild.jpg new file mode 100644 index 0000000..05e3d17 Binary files /dev/null and b/docs/ux/verwaltung/abnahme/teil-a/27-aufbau-didaktik-katalogbild.jpg differ diff --git a/docs/ux/verwaltung/abnahme/teil-a/28-aufbau-fassungen-verwendung.jpg b/docs/ux/verwaltung/abnahme/teil-a/28-aufbau-fassungen-verwendung.jpg new file mode 100644 index 0000000..a527ba6 Binary files /dev/null and b/docs/ux/verwaltung/abnahme/teil-a/28-aufbau-fassungen-verwendung.jpg differ diff --git a/docs/ux/verwaltung/abnahme/teil-a/29-aufbau-900.jpg b/docs/ux/verwaltung/abnahme/teil-a/29-aufbau-900.jpg new file mode 100644 index 0000000..a7146ed Binary files /dev/null and b/docs/ux/verwaltung/abnahme/teil-a/29-aufbau-900.jpg differ diff --git a/docs/ux/verwaltung/abnahme/teil-a/30-aufbau-760.jpg b/docs/ux/verwaltung/abnahme/teil-a/30-aufbau-760.jpg new file mode 100644 index 0000000..f5e4279 Binary files /dev/null and b/docs/ux/verwaltung/abnahme/teil-a/30-aufbau-760.jpg differ diff --git a/docs/ux/verwaltung/abnahme/teil-a/31-medium-film-fassung.jpg b/docs/ux/verwaltung/abnahme/teil-a/31-medium-film-fassung.jpg new file mode 100644 index 0000000..01a9b15 Binary files /dev/null and b/docs/ux/verwaltung/abnahme/teil-a/31-medium-film-fassung.jpg differ diff --git a/docs/ux/verwaltung/abnahme/teil-a/32-medium-dialog-neue-fassung.jpg b/docs/ux/verwaltung/abnahme/teil-a/32-medium-dialog-neue-fassung.jpg new file mode 100644 index 0000000..4ab0a1d Binary files /dev/null and b/docs/ux/verwaltung/abnahme/teil-a/32-medium-dialog-neue-fassung.jpg differ diff --git a/docs/ux/verwaltung/abnahme/teil-a/33-medium-text-zwei-fassungen.jpg b/docs/ux/verwaltung/abnahme/teil-a/33-medium-text-zwei-fassungen.jpg new file mode 100644 index 0000000..cba2028 Binary files /dev/null and b/docs/ux/verwaltung/abnahme/teil-a/33-medium-text-zwei-fassungen.jpg differ diff --git a/docs/ux/verwaltung/abnahme/teil-a/34-medium-wechsel-bestaetigen.jpg b/docs/ux/verwaltung/abnahme/teil-a/34-medium-wechsel-bestaetigen.jpg new file mode 100644 index 0000000..772af5a Binary files /dev/null and b/docs/ux/verwaltung/abnahme/teil-a/34-medium-wechsel-bestaetigen.jpg differ diff --git a/docs/ux/verwaltung/abnahme/teil-a/35-medium-aeltere-fassung.jpg b/docs/ux/verwaltung/abnahme/teil-a/35-medium-aeltere-fassung.jpg new file mode 100644 index 0000000..971d812 Binary files /dev/null and b/docs/ux/verwaltung/abnahme/teil-a/35-medium-aeltere-fassung.jpg differ diff --git a/docs/ux/verwaltung/abnahme/teil-a/36-medium-gespeichert.jpg b/docs/ux/verwaltung/abnahme/teil-a/36-medium-gespeichert.jpg new file mode 100644 index 0000000..ff53373 Binary files /dev/null and b/docs/ux/verwaltung/abnahme/teil-a/36-medium-gespeichert.jpg differ diff --git a/docs/ux/verwaltung/abnahme/teil-a/37-medium-vorschaubild.jpg b/docs/ux/verwaltung/abnahme/teil-a/37-medium-vorschaubild.jpg new file mode 100644 index 0000000..8cfb3da Binary files /dev/null and b/docs/ux/verwaltung/abnahme/teil-a/37-medium-vorschaubild.jpg differ diff --git a/docs/ux/verwaltung/abnahme/teil-a/38-medium-verwendung.jpg b/docs/ux/verwaltung/abnahme/teil-a/38-medium-verwendung.jpg new file mode 100644 index 0000000..8776d2f Binary files /dev/null and b/docs/ux/verwaltung/abnahme/teil-a/38-medium-verwendung.jpg differ diff --git a/docs/ux/verwaltung/abnahme/teil-a/39-medium-ohne-fassung.jpg b/docs/ux/verwaltung/abnahme/teil-a/39-medium-ohne-fassung.jpg new file mode 100644 index 0000000..b352c67 Binary files /dev/null and b/docs/ux/verwaltung/abnahme/teil-a/39-medium-ohne-fassung.jpg differ diff --git a/docs/ux/verwaltung/abnahme/teil-a/40-medium-900.jpg b/docs/ux/verwaltung/abnahme/teil-a/40-medium-900.jpg new file mode 100644 index 0000000..0b0ff73 Binary files /dev/null and b/docs/ux/verwaltung/abnahme/teil-a/40-medium-900.jpg differ diff --git a/docs/ux/verwaltung/abnahme/teil-a/41-medium-760.jpg b/docs/ux/verwaltung/abnahme/teil-a/41-medium-760.jpg new file mode 100644 index 0000000..a6397e5 Binary files /dev/null and b/docs/ux/verwaltung/abnahme/teil-a/41-medium-760.jpg differ diff --git a/docs/ux/verwaltung/abnahme/teil-a/42-medium-dialog-deaktivieren.jpg b/docs/ux/verwaltung/abnahme/teil-a/42-medium-dialog-deaktivieren.jpg new file mode 100644 index 0000000..b38eaa0 Binary files /dev/null and b/docs/ux/verwaltung/abnahme/teil-a/42-medium-dialog-deaktivieren.jpg differ diff --git a/docs/ux/verwaltung/abnahme/teil-a/43-cms-dialog-knopffarbe.jpg b/docs/ux/verwaltung/abnahme/teil-a/43-cms-dialog-knopffarbe.jpg new file mode 100644 index 0000000..ce614be Binary files /dev/null and b/docs/ux/verwaltung/abnahme/teil-a/43-cms-dialog-knopffarbe.jpg differ diff --git a/docs/ux/verwaltung/abnahme/teil-b.md b/docs/ux/verwaltung/abnahme/teil-b.md new file mode 100644 index 0000000..3b7f20e --- /dev/null +++ b/docs/ux/verwaltung/abnahme/teil-b.md @@ -0,0 +1,86 @@ +# Abnahme Teil B: Objektübersichten und Katalog-Arbeitsplätze + +Stand: 20.11.2026. **Geprüfter Code-Stand:** `develop` mit `b600294` auf `luf-test` (Deploy-Lauf 4924 grün), Tastatur, Anlegedialoge und Angebotsbedingungen zusätzlich bei `71e71b4` (Lauf 4928), Prüfkonto der Redaktion mit Katalogrolle, Breiten 1440, 900 und 760 px. Die Paketseite wurde lokal geprüft (auf luf-test gibt es kein Paket, und ein angelegtes bliebe dauerhaft). Keine fachliche Freigabe und kein Produktivdeployment. Vorlage: [ux-abnahme-vorlage](../regeln/ux-abnahme-vorlage.md). + +## Mitgelieferte Korrektur: „Medium anlegen“ ohne Funktion + +- **Ursache:** Filament gibt den Dialogbereich einer Listenseite über die Tabelle aus. Die Medienliste ersetzt die Tabelle durch eine eigene Ansicht; damit fehlte der Bereich. Die Aktion wurde geöffnet (`mountedActions` gesetzt), aber nie angezeigt. +- **Behebung** (`f846c0b`, danach in die gemeinsame Liste übernommen): Die Liste gibt den Dialogbereich selbst aus. Jede Seite, die eine Tabelle durch die gemeinsame Liste ersetzt, hat ihn damit automatisch. Ein Test je umgestellter Liste prüft das (`wire:partial="action-modals"`). +- **Geprüft:** lokal ein Textmedium und ein Bildmedium mit Upload vollständig angelegt, danach Weiterleitung zum Medium (Bild: Fassung 1 als Entwurf, bis die Datei übernommen ist); auf luf-test den Dialog geöffnet, „Bild“ gewählt (Dateifeld und „Eigenständiges Präsentationsmedium“ erscheinen), abgebrochen. Bild 08. + +## Aufgabe und Maßstab + +- **Objekt:** Bestände (Programme und Module, Medien, Lizenzartikel, Pakete, Rechteprofile, Angebote, fachliche Säulen und Kombinationen, Konten). **Aufgabe:** finden, eingrenzen, Zustand erkennen, öffnen oder anlegen; Katalogobjekte zusammenstellen. **Woanders:** Bearbeitung der Inhalte (Aufbau, Medieneditor, Redaktion), CMS (Teil C). +- **Maßstab:** [Dokument 14](../14-verwaltungsstandard.md) §3 (gemeinsame kompakte Listen mit visueller Vorschau, Suche, nachvollziehbaren aktiven Filtern, verständlichem Zustand, kontextgerechten Aktionen) und §9 (eine gepflegte Komponente), [Dokument 15](../15-umbauauftrag.md) Teil B, [Dokument 04](../04-fachliche-anforderungen.md) FACH-08, FACH-20; Listenbasis aus [Dokument 03](../03-auswahl-und-zuordnung-entwurf.md). + +## Gemeinsame Bausteine + +| Baustein | Genutzt von | +|---|---| +| `` (Vorschau, Titel, Typzeile; ein Link oder Knopf) | Picker (alle Zwecke) und alle Bestandslisten | +| `verwaltung/bestand` + Trait `ShowsBestand` (Suche, sichtbare Filter, „Weitere Filter“, aktive Filter als entfernbare Chips, „Alle zurücksetzen“, Trefferzahl, Zeilen oder Kacheln, „Weitere anzeigen“ in Schritten von 50, Leerzustand, Dialogbereich) | Arbeitsplatz, Module, Programme, Fachliche Kombinationen (`ListsCompositions`), Medien, Lizenzartikel, Pakete, Rechteprofile, Angebote, Fachliche Säulen, Benutzer (`ListsCatalog`) | +| `catalog/objekt` (Kopf, Hauptabschnitte, Begleitinformation) + `CatalogLabels` (Fähigkeiten, Zweck, Vergabe) | Angebot, Paket, Rechteprofil | +| Ein Anlegedialog für Module und Programme | Arbeitsplatz, „Module“, „Programme“ | +| Filament-Hauptknöpfe im Verwaltungsgrün (Seitenkopf, Dialogfuß, Formularfuß) | ganzes Panel | + +## Ergebnis + +- **Vorher:** Arbeitsplatz als Kartenwand mit Inline-Anlegefeldern; „Module“ und „Programme“ zusätzlich als Filament-Tabellen derselben Objekte; Medien mit elf gleichrangigen Filtern und Kacheln als Grundansicht; Kataloglisten mit technischen Spalten („Aktueller Stand: 1“, „Fassungen: aktiv“); nach dem Anlegen eines Katalogobjekts blieb man in der Liste; Angebot und Paket mit Filament-Abschnitten und einem Dialog, der für jede Änderung alles neu verlangte; Rechteprofil mit doppeltem Titel und „film: streamen“. +- **Nachher:** Eine Liste für alle Bestände. Häufige Filter sichtbar, seltene unter „Weitere Filter“ (mit Zähler); jeder aktive Filter als benannter Chip mit ×; Filter und Ansicht stehen in der Adresse und überstehen das Neuladen. Zeilen mit kleiner Vorschau, Titel, Typ, Kurztext, lesbaren Zuständen und benannten Aktionen („Aufbau“, „Redaktion“, „Ansehen“, „Öffnen“, „Bearbeiten“). Medien öffnen als kompakte Liste (Dokument 14), Kacheln bleiben wählbar. „Module“ und „Programme“ zeigen dieselben Zeilen wie der Arbeitsplatz mit festem Typ; es gibt einen Anlegedialog. Katalogobjekte öffnen nach dem Anlegen. +- **Angebot und Paket:** eine Maske für Anlegen und Ändern (FACH-20). „Fassung aktivieren“ bzw. „Geänderte Fassung aktivieren“ (Paket: „… veröffentlichen“); bei einer Änderung ist die Maske mit der aktiven bzw. veröffentlichten Fassung vorbelegt (FACH-08: keine vollständige Neuerfassung). Titel und Knopf nennen die neue Fassungsnummer; die Beschreibung sagt die tatsächliche Wirkung: Beim Angebot wird die bisherige Fassung beendet und bleibt gespeichert, bereits begründete Berechtigungen ändern sich nicht; beim Paket bleiben frühere Fassungen veröffentlicht. Die Fachlogik (`OfferService::activate`, `BundleService::publish`) ist unverändert. +- **Rechteprofil:** erlaubte Handlungen lesbar, Verwendung in Angeboten, Fassungen mit „Festgeschrieben“; kein doppelter Titel. + +## Tatsächliche Prüfung + +| Prüffall | Ergebnis / Beleg | Grenze | +|---|---|---| +| Arbeitsplatz (luf-test, 1440/900/760) | 11 Einträge; Suche „Abstand“ + Art „Module“ → 1 Treffer, Chips „Suche: „Abstand““ und „Art: Module“; Art-Chip entfernt → 2; „Alle zurücksetzen“ → 11; „Modul anlegen“ geöffnet, Fokus im Dialog, Esc schließt. Bilder 01–03, 19, 20 | Anlegen im Browser auf luf-test nicht abgeschickt (Feature-Test) | +| Module, Programme | „Module“ 8, „Programme“ 3; kein Art-Umschalter bei festem Typ. Bild 04 | – | +| Medien | 17 Medien; „Technische Art: Film“ und „Archiv: Auch archivierte“ → 3, beide als Chips, Adresse `?art=film&archiv=alle`, nach Neuladen unverändert; Kacheln; „Medium anlegen“ geöffnet und geschlossen. Bilder 05–08, 21 | – | +| Kataloglisten | Lizenzartikel „Stand 1 veröffentlicht · In einem aktiven Angebot“; Angebot „Fassung 1 aktiv · Auf Abruf“ mit Positionen; Rechteprofil mit lesbaren Fähigkeiten; Pakete leer mit Leerzustand. Bilder 09, 10 | Pakete auf luf-test leer | +| Angebotsmaske | „Geänderte Fassung aktivieren“ öffnet „Angebot ändern: Fassung 2 aktivieren“, vorbelegt (Vergabe „Auf Abruf“, 1 Position), Knopf „Fassung 2 aktivieren“; Esc. Danach lesend in der Datenbank geprüft: weiterhin genau Fassung 1, aktiv. Bilder 11, 12, 22 | Nicht abgeschickt (würde eine dauerhafte Fassung erzeugen); Aktivierung im Feature-Test | +| Paket (lokal) | Seite mit Bestandteilen, aufgelösten Artikeln, Fassungen; Maske vorbelegt (vorhandener Artikel angehakt). Bilder 13, 14 | lokal | +| Rechteprofil, Säulen, Kombinationen, Benutzer | Rechteprofil „Abstand ansehen“ mit „Fassung 1 · Ehrenamtlich · festgeschrieben seit 16.11.2026“, Verwendung im Testangebot; Säulen 5, Filter „Auf der Website veröffentlicht“ → 0, „Speichern“ der Säule im Verwaltungsgrün; Kombinationen leer („Noch keine fachlichen Kombinationen“); Benutzer 6 Konten. Bilder 15–17 | Benutzerliste nicht abgebildet (echte E-Mail-Adressen) | +| Tastatur und Fokus (luf-test) | Tab-Reihenfolge Arbeitsplatz: Suche → „Alle“ → „Programme“ → „Module“ → Stand → „Weitere Filter“ → erste Zeile → „Aufbau“. „Weitere Filter“ öffnet mit Enter; „Module“ per Enter gefiltert (8); Chip „Art: Module“ per Enter entfernt (11, keine Chips); Zeile per Enter geöffnet; Picker-Zeile per Enter betrachtet. Sichtbarer Fokusrahmen 3 px an Zeile, Picker-Zeile und „Weitere Filter“. Bilder 23, 24 | „Weitere anzeigen“ auf luf-test nicht erreichbar (höchstens 17 Einträge); im Feature-Test mit 53 Modulen | +| Alle Anlegedialoge (luf-test, nie abgeschickt) | „Programm anlegen“, „Artikel anlegen“, „Paket anlegen“, „Rechteprofil anlegen“, „Angebot anlegen“, „Säule anlegen“, „Kombination anlegen“: jeweils Dialog sichtbar, Fokus im Dialog, Esc schließt. „Benutzer anlegen“ führt zu `/verwaltung/users/create` | – | +| Picker nach Umstellung auf den gemeinsamen Eintrag | luf-test Aufbau: 17 Treffer, Eintrag betrachtet, einer markiert, Esc schließt ohne Änderung; lokal Präsentations-Picker mit Mehrfachauswahl (2 ausgewählt). Bild 18 | – | +| Feature-Tests | `BestandslisteTest` (13 Tests): fester Typ, ein Anlegedialog (inkl. Pflichtfeld), Filterchips und „Weitere anzeigen“, Medienfilter aus der Adresse, Rechte (Redakteur ohne Katalogrolle: 403 auf Katalog, Katalogverwalter: 403 auf Arbeitsplatz/Module), lesbare Katalogzustände und Filter, Weiterleitung nach dem Anlegen, Angebots- und Paketmaske (erste Fassung, Vorbelegung, alte Fassung beendet bzw. veröffentlicht), Rechteprofil lesbar, Säulen/Kombinationen/Konten. Angepasst: Medienliste öffnet als Liste; das Ersatzsymbol heißt `data-symbol` | – | +| Repository | Lokal 304 Tests grün, Pint grün, `ci-feature` und `deploy-test` für jeden Commit grün | Instanz-Suite (U0) existiert noch nicht | + +## Gefundene und behobene Fehler + +1. „Medium anlegen“ öffnete keinen Dialog (siehe oben). +2. Eine Konstante im Trait der Liste war von der Ansicht aus nicht erreichbar; „Weitere anzeigen“ wäre ab 51 Einträgen mit einem Fehler abgebrochen. Vor der Auslieferung durch den Test mit 53 Modulen gefunden. +3. Das Filterfeld „Zustand“ und die Zustandsliste jeder Zeile trugen denselben zugänglichen Namen (auf luf-test gefunden); die Zeilen heißen jetzt „Zustand von …“. +4. „Geänderte Fassung aktivieren“ setzte Inhaberart, Laufzeitregel, Steuerklasse und „dynamisch“ still auf die Vorgabe zurück, obwohl die Maske „vorbelegt“ sagte; jetzt werden sie aus der aktiven Fassung übernommen und im Dialog genannt (Test mit Organisation/befristet). Auf luf-test hatte die vorhandene Fassung die Vorgabewerte, es ging nichts verloren. +5. Eingaben in einem geöffneten Anlegedialog klappten eine mit „Weitere anzeigen“ verlängerte Liste wieder zu. +6. Der Art-Umschalter brach in zwei Zeilen um; Filaments Pfad stand auf der Angebotsseite doppelt; der Leistungsumfang stand in technischer Schreibweise; Leerzustand „Noch keine Fachliche Kombinationen“. + +**Nachtrag (Rückschritt aus Teil B, in zwei Schritten behoben):** Die Regel für grüne Filament-Hauptknöpfe (`51d58ac`) traf auch Auswahlfelder: gewählte und nicht gewählte Optionen sahen gleich aus. `afe35fc` beschränkte die Regel auf Knöpfe und Links; damit waren Auswahlfelder mit Radio-Darstellung (Rasterauswahl, „Bild links/rechts“) wieder richtig. Auswahlfelder in Knopfform (Vorschaubreite im Bausteindialog, Knopfgruppen) blieben falsch, bis `77ebb0c` die Regel auf Kopf, Dialogfuß und Formularaktionen eingegrenzt hat (`:is(.fi-header, .fi-modal-footer, .fi-sc-actions)`). Auf luf-test sichtbar von `51d58ac` bis `77ebb0c`. Unabhängig davon war die Vorschaubreite schon vor Teil B ohne Markierung, solange niemand eine Breite gewählt hatte; seit `77ebb0c` ist die Vorgabe beim Öffnen gewählt. Die Prüfung der Nebenwirkung hatte zuerst nur einen Dialog betrachtet. Nachgeprüft wird auf luf-test mit „Säule Speichern“, einem Katalog-Dialogfuß, dem Raster und der Vorschaubreite (Abnahme Teil C). + +## Belege + +| | | +|---|---| +| ![Arbeitsplatz](teil-b/01-arbeitsplatz.jpg) | ![Arbeitsplatz gefiltert](teil-b/02-arbeitsplatz-gefiltert.jpg) | +| ![Dialog Neues Modul](teil-b/03-dialog-neues-modul.jpg) | ![Module](teil-b/04-module.jpg) | +| ![Medien](teil-b/05-medien.jpg) | ![Medien, weitere Filter](teil-b/06-medien-weitere-filter.jpg) | +| ![Medien als Kacheln](teil-b/07-medien-kacheln.jpg) | ![Dialog Medium anlegen](teil-b/08-dialog-medium-anlegen.jpg) | +| ![Lizenzartikel](teil-b/09-lizenzartikel.jpg) | ![Angebote](teil-b/10-angebote.jpg) | +| ![Angebot](teil-b/11-angebot.jpg) | ![Angebotsmaske vorbelegt](teil-b/12-angebot-maske-vorbelegt.jpg) | +| ![Paket (lokal)](teil-b/13-paket-lokal.jpg) | ![Paketmaske (lokal)](teil-b/14-paket-maske-lokal.jpg) | +| ![Rechteprofil](teil-b/15-rechteprofil.jpg) | ![Säulen](teil-b/16-saeulen.jpg) | +| ![Säule bearbeiten](teil-b/17-saeule-bearbeiten.jpg) | ![Picker mit gemeinsamem Eintrag](teil-b/18-picker-gemeinsamer-eintrag.jpg) | +| ![Arbeitsplatz 900 px](teil-b/19-arbeitsplatz-900.jpg) | ![Arbeitsplatz 760 px gefiltert](teil-b/20-arbeitsplatz-760-gefiltert.jpg) | +| ![Medien 760 px mit Filtern](teil-b/21-medien-760-filter.jpg) | ![Angebot 760 px](teil-b/22-angebot-760.jpg) | +| ![Fokus auf einer Zeile](teil-b/23-tastatur-fokus-zeile.jpg) | ![Fokus im Picker](teil-b/24-tastatur-fokus-picker.jpg) | + +## Verbleibende Abweichungen und offene Fragen + +1. **Offene Fachfragen, nicht entschieden:** „Als Vorlage verwenden“ für Angebote (FACH-09) hängt an OFF-04 (was übernommen wird); Varianten innerhalb eines Angebots oder parallele Angebote (OFF-01), Rabatte (OFF-06) und Laufzeiten (FACH-13) sind nicht gebaut. Ob jede Änderung eines aktiven Angebots eine neue Fassung braucht (OFF-02), bleibt offen; umgesetzt ist das bestehende Verhalten (neue Fassung, alte beendet). +2. **Formulare ohne gemeinsamen Rahmen:** Säule bearbeiten und Konto anlegen/bearbeiten bleiben Filament-Formulare (Hauptknopf angeglichen). Der Anlegedialog „Neue fachliche Kombination“ bleibt eigener Filament-Dialog. +3. **Filtern im Speicher:** Die Listen lesen den (kleinen) Bestand und filtern in PHP, wie zuvor Arbeitsplatz und Medien. Für sehr große Bestände wäre eine Datenbankabfrage je Filter nötig (FACH-32 nennt einen überschaubaren Bestand). +4. **Lizenzartikel:** Titel fällt ohne Arbeits- oder Anzeigetitel auf die Kennung zurück (auf luf-test „abstand-trainer“). +5. **Filament-Dialoge:** Hauptaktion links vor „Abbrechen“ (siehe Teil A). +6. **Dashboard** (`/verwaltung`) ist Filaments Startseite und nicht Teil dieses Abschnitts; unverändert. +7. Nicht geprüft: Bildschirmleser, Hochkontrast; Anlegen und Aktivieren im Browser auf luf-test (bewusst, dauerhafte Daten; durch Feature-Tests abgedeckt). diff --git a/docs/ux/verwaltung/abnahme/teil-b/01-arbeitsplatz.jpg b/docs/ux/verwaltung/abnahme/teil-b/01-arbeitsplatz.jpg new file mode 100644 index 0000000..bfde24e Binary files /dev/null and b/docs/ux/verwaltung/abnahme/teil-b/01-arbeitsplatz.jpg differ diff --git a/docs/ux/verwaltung/abnahme/teil-b/02-arbeitsplatz-gefiltert.jpg b/docs/ux/verwaltung/abnahme/teil-b/02-arbeitsplatz-gefiltert.jpg new file mode 100644 index 0000000..6b72ac6 Binary files /dev/null and b/docs/ux/verwaltung/abnahme/teil-b/02-arbeitsplatz-gefiltert.jpg differ diff --git a/docs/ux/verwaltung/abnahme/teil-b/03-dialog-neues-modul.jpg b/docs/ux/verwaltung/abnahme/teil-b/03-dialog-neues-modul.jpg new file mode 100644 index 0000000..d8e250d Binary files /dev/null and b/docs/ux/verwaltung/abnahme/teil-b/03-dialog-neues-modul.jpg differ diff --git a/docs/ux/verwaltung/abnahme/teil-b/04-module.jpg b/docs/ux/verwaltung/abnahme/teil-b/04-module.jpg new file mode 100644 index 0000000..f16b7e0 Binary files /dev/null and b/docs/ux/verwaltung/abnahme/teil-b/04-module.jpg differ diff --git a/docs/ux/verwaltung/abnahme/teil-b/05-medien.jpg b/docs/ux/verwaltung/abnahme/teil-b/05-medien.jpg new file mode 100644 index 0000000..68479ef Binary files /dev/null and b/docs/ux/verwaltung/abnahme/teil-b/05-medien.jpg differ diff --git a/docs/ux/verwaltung/abnahme/teil-b/06-medien-weitere-filter.jpg b/docs/ux/verwaltung/abnahme/teil-b/06-medien-weitere-filter.jpg new file mode 100644 index 0000000..a481fba Binary files /dev/null and b/docs/ux/verwaltung/abnahme/teil-b/06-medien-weitere-filter.jpg differ diff --git a/docs/ux/verwaltung/abnahme/teil-b/07-medien-kacheln.jpg b/docs/ux/verwaltung/abnahme/teil-b/07-medien-kacheln.jpg new file mode 100644 index 0000000..4880f89 Binary files /dev/null and b/docs/ux/verwaltung/abnahme/teil-b/07-medien-kacheln.jpg differ diff --git a/docs/ux/verwaltung/abnahme/teil-b/08-dialog-medium-anlegen.jpg b/docs/ux/verwaltung/abnahme/teil-b/08-dialog-medium-anlegen.jpg new file mode 100644 index 0000000..2974be3 Binary files /dev/null and b/docs/ux/verwaltung/abnahme/teil-b/08-dialog-medium-anlegen.jpg differ diff --git a/docs/ux/verwaltung/abnahme/teil-b/09-lizenzartikel.jpg b/docs/ux/verwaltung/abnahme/teil-b/09-lizenzartikel.jpg new file mode 100644 index 0000000..8a78f6f Binary files /dev/null and b/docs/ux/verwaltung/abnahme/teil-b/09-lizenzartikel.jpg differ diff --git a/docs/ux/verwaltung/abnahme/teil-b/10-angebote.jpg b/docs/ux/verwaltung/abnahme/teil-b/10-angebote.jpg new file mode 100644 index 0000000..7e9731e Binary files /dev/null and b/docs/ux/verwaltung/abnahme/teil-b/10-angebote.jpg differ diff --git a/docs/ux/verwaltung/abnahme/teil-b/11-angebot.jpg b/docs/ux/verwaltung/abnahme/teil-b/11-angebot.jpg new file mode 100644 index 0000000..a18158b Binary files /dev/null and b/docs/ux/verwaltung/abnahme/teil-b/11-angebot.jpg differ diff --git a/docs/ux/verwaltung/abnahme/teil-b/12-angebot-maske-vorbelegt.jpg b/docs/ux/verwaltung/abnahme/teil-b/12-angebot-maske-vorbelegt.jpg new file mode 100644 index 0000000..752fd06 Binary files /dev/null and b/docs/ux/verwaltung/abnahme/teil-b/12-angebot-maske-vorbelegt.jpg differ diff --git a/docs/ux/verwaltung/abnahme/teil-b/13-paket-lokal.jpg b/docs/ux/verwaltung/abnahme/teil-b/13-paket-lokal.jpg new file mode 100644 index 0000000..edf3fc6 Binary files /dev/null and b/docs/ux/verwaltung/abnahme/teil-b/13-paket-lokal.jpg differ diff --git a/docs/ux/verwaltung/abnahme/teil-b/14-paket-maske-lokal.jpg b/docs/ux/verwaltung/abnahme/teil-b/14-paket-maske-lokal.jpg new file mode 100644 index 0000000..73cd127 Binary files /dev/null and b/docs/ux/verwaltung/abnahme/teil-b/14-paket-maske-lokal.jpg differ diff --git a/docs/ux/verwaltung/abnahme/teil-b/15-rechteprofil.jpg b/docs/ux/verwaltung/abnahme/teil-b/15-rechteprofil.jpg new file mode 100644 index 0000000..a6756c0 Binary files /dev/null and b/docs/ux/verwaltung/abnahme/teil-b/15-rechteprofil.jpg differ diff --git a/docs/ux/verwaltung/abnahme/teil-b/16-saeulen.jpg b/docs/ux/verwaltung/abnahme/teil-b/16-saeulen.jpg new file mode 100644 index 0000000..3f7aab8 Binary files /dev/null and b/docs/ux/verwaltung/abnahme/teil-b/16-saeulen.jpg differ diff --git a/docs/ux/verwaltung/abnahme/teil-b/17-saeule-bearbeiten.jpg b/docs/ux/verwaltung/abnahme/teil-b/17-saeule-bearbeiten.jpg new file mode 100644 index 0000000..9bae388 Binary files /dev/null and b/docs/ux/verwaltung/abnahme/teil-b/17-saeule-bearbeiten.jpg differ diff --git a/docs/ux/verwaltung/abnahme/teil-b/18-picker-gemeinsamer-eintrag.jpg b/docs/ux/verwaltung/abnahme/teil-b/18-picker-gemeinsamer-eintrag.jpg new file mode 100644 index 0000000..fedc7a2 Binary files /dev/null and b/docs/ux/verwaltung/abnahme/teil-b/18-picker-gemeinsamer-eintrag.jpg differ diff --git a/docs/ux/verwaltung/abnahme/teil-b/19-arbeitsplatz-900.jpg b/docs/ux/verwaltung/abnahme/teil-b/19-arbeitsplatz-900.jpg new file mode 100644 index 0000000..0c4987b Binary files /dev/null and b/docs/ux/verwaltung/abnahme/teil-b/19-arbeitsplatz-900.jpg differ diff --git a/docs/ux/verwaltung/abnahme/teil-b/20-arbeitsplatz-760-gefiltert.jpg b/docs/ux/verwaltung/abnahme/teil-b/20-arbeitsplatz-760-gefiltert.jpg new file mode 100644 index 0000000..729d210 Binary files /dev/null and b/docs/ux/verwaltung/abnahme/teil-b/20-arbeitsplatz-760-gefiltert.jpg differ diff --git a/docs/ux/verwaltung/abnahme/teil-b/21-medien-760-filter.jpg b/docs/ux/verwaltung/abnahme/teil-b/21-medien-760-filter.jpg new file mode 100644 index 0000000..340108f Binary files /dev/null and b/docs/ux/verwaltung/abnahme/teil-b/21-medien-760-filter.jpg differ diff --git a/docs/ux/verwaltung/abnahme/teil-b/22-angebot-760.jpg b/docs/ux/verwaltung/abnahme/teil-b/22-angebot-760.jpg new file mode 100644 index 0000000..43a8641 Binary files /dev/null and b/docs/ux/verwaltung/abnahme/teil-b/22-angebot-760.jpg differ diff --git a/docs/ux/verwaltung/abnahme/teil-b/23-tastatur-fokus-zeile.jpg b/docs/ux/verwaltung/abnahme/teil-b/23-tastatur-fokus-zeile.jpg new file mode 100644 index 0000000..66fb49c Binary files /dev/null and b/docs/ux/verwaltung/abnahme/teil-b/23-tastatur-fokus-zeile.jpg differ diff --git a/docs/ux/verwaltung/abnahme/teil-b/24-tastatur-fokus-picker.jpg b/docs/ux/verwaltung/abnahme/teil-b/24-tastatur-fokus-picker.jpg new file mode 100644 index 0000000..af392b6 Binary files /dev/null and b/docs/ux/verwaltung/abnahme/teil-b/24-tastatur-fokus-picker.jpg differ diff --git a/docs/ux/verwaltung/abnahme/teil-c.md b/docs/ux/verwaltung/abnahme/teil-c.md new file mode 100644 index 0000000..4326ab3 --- /dev/null +++ b/docs/ux/verwaltung/abnahme/teil-c.md @@ -0,0 +1,245 @@ +# Abnahme Teil C: CMS-Seiteneditor und Webpräsenz + +Stand: 20.11.2026. **Geprüfter Code-Stand:** `develop` mit `d4110b1` auf `luf-test` (Deploy-Lauf 4946 grün). Seiteneditor zuvor mit `77ebb0c` (Lauf 4940), Webpräsenz mit `30dd0f9` (Lauf 4942), Dialogerkennung mit `0c6519b` (Lauf 4944). Geprüft mit dem Prüfkonto der Redaktion bei 1440, 900 und 760 px. Ziehen und die Messung liefen lokal. Keine fachliche Freigabe und kein Produktivdeployment. Vorlage: [ux-abnahme-vorlage](../regeln/ux-abnahme-vorlage.md). + +**Prüfdaten auf luf-test:** Die Seite `/ux-pruefung-cms` (Seite 21, Kopie von „Prävention im Alltag“, nicht veröffentlicht) mit den Revisionen 69 und 70 bleibt als dauerhafte Prüfseite bestehen. Referenzseiten wurden nicht verändert und nichts wurde veröffentlicht. Die Menüs wurden nur mit einem ausgeblendeten Prüfeintrag beschrieben, der im selben Lauf wieder entfernt wurde. Vorher und nachher wurde `navigation_items` lesend verglichen (alle Spalten einschließlich `updated_at`): identisch. + +## Aufgabe und Maßstab + +- **C1 Seiteneditor:** + - **Objekt:** eine CMS-Seite. + - **Aufgabe:** Abschnitte und Bausteine ordnen, einen Abschnitt gestalten, einen Baustein konfigurieren, den Entwurf speichern, veröffentlichen, die Revisionen einsehen. + - **Maßstab:** [Dokument 12](../12-cms-seiteneditor-entwurf.md) mit den Mockups Seitenaufbau, Abschnitt und Baustein. +- **C2 Webpräsenz:** + - **Objekt:** der Seitenbestand und die Menüs der Website. + - **Aufgabe:** Seiten finden und ihren Zustand erkennen; Menüs ordnen, Ziele setzen und Einträge ein- oder ausblenden. + - **Maßstab:** [Dokument 13](../13-webpraesenz-verwaltung-entwurf.md), Entwürfe 1 (breit) und 3 (schmal), Regeln WEB-R01 bis WEB-R07. +- **Für beide:** + - [Dokument 14](../14-verwaltungsstandard.md) und [Dokument 15](../15-umbauauftrag.md) Teil C. + - Keine neuen Geschäftsregeln. + - OFF-23 bis OFF-25 bleiben offen. „Website-Rahmen“ wird nicht gebaut und auch nicht als Register angedeutet. + +## Gemeinsame Bausteine + +| Baustein | Genutzt von | +|---|---| +| `verwaltung/kopf` (Objektkopf, getrennte Zustände, Aktionen, „Weitere Aktionen“) | Seiteneditor (`cms/seite-kopf`), Webpräsenz (`cms/webpraesenz-kopf`) | +| `vw-register` (Register mit Zähler und Offen-Markierung) | Seiteneditor, Webpräsenz | +| `verwaltung/bestand` + `ShowsBestand`, `` | Register „Seiten“; Erweiterung: Sortierauswahl (kein Filter-Chip) sowie Zeilenaktionen als Knopf (`wire`) oder im neuen Tab | +| `` als Knopf | Zielseitenwahl der Menüs | +| `verwaltung/bestaetigung` | „Aus Menü entfernen“, „Menüänderungen verwerfen“, „Gespeicherten Stand laden“ | +| `verwaltung/abgang` | Webpräsenz bei offenen Menüänderungen (Seiteneditor wie bisher über Filament) | +| Tokens `--vw-…` in `verwaltung/styles.blade.php` | neue Klassen `vw-menue-…`, `vw-zielkarte`, `vw-schalter`, `luf-baustein-dialog` | + +## C1: Seiteneditor + +- **Vorher:** + - Filament-Kopf mit „Speichern“ unter dem Formular. + - An jedem Abschnitt standen Raster und Gestaltung aufgeklappt. + - Die Revisionen standen als Tabelle unter dem Formular. + - Der Widgetdialog „Widget bearbeiten“ (4xl) hatte ein Schließen-Kreuz und schloss bei Esc oder Klick daneben. +- **Kopf und Register:** + - Der Kopf zeigt den Speicherstand und den Veröffentlichungsstand getrennt: „Änderungen nicht gespeichert“, „Entwurf gespeichert (Revision N)“ oder „Gespeicherter Stand ist veröffentlicht“, dazu „Öffentlich: Revision N“ oder „Noch nicht veröffentlicht“, gegebenenfalls mit „der gespeicherte Entwurf ist neuer“. + - Aktionen im Kopf: Seitenvorschau, „Entwurf speichern“ (auch Strg+S) und „Veröffentlichen …“; „Live-Seite öffnen“ steht unter „Weitere Aktionen“. + - Register: Seiteninhalt, Seiteneinstellungen, Verlauf. Ausgeblendete Register behalten ihre Eingaben und werden mitgespeichert. +- **Seitenaufbau:** zeigt Abschnitte mit ihren Plätzen. + - „Abschnitt gestalten“ öffnet einen Kontext für genau einen Abschnitt: Raster, Breite, Hintergrund, Abstände, Trenner. + - Der Kontext steht in der Adresse (`?abschnitt=N`) und übersteht das Speichern. Zurück führen „Zur Seite“ oder Esc. +- **„Konfigurieren“:** öffnet den Baustein als großen Kontext. + - Die Überschrift nennt Typ, Abschnitt, Platz und Einheiten, zum Beispiel „Einstieg (Hero) konfigurieren · Abschnitt 1 · Platz 1 · 4 Einheiten“. + - Ab 1280 px stehen Inhalt, Medien und Darstellung neben der Vorschau. + - Verlassen geht nur über „Zur Seite“ (übernimmt in den Entwurf) oder „Änderungen verwerfen“. Esc, Klick daneben und ein Schließen-Kreuz gibt es nicht, weil sie still verwerfen würden. + - Der Inhalt scrollt im Dialog, der Dialogfuß bleibt sichtbar. +- **Fehler werden sichtbar (CMS-12):** + - Ein Fehler in einem ausgeblendeten Register schaltet auf dieses Register. + - Ein Raster- oder Gestaltungsfehler öffnet den betroffenen Abschnitt. + - Liegt der Fehler in dem Abschnitt, der gerade gestaltet wird, bleibt der Kontext offen. +- **Unverändert:** Revisionslogik, Veröffentlichen, Wiederherstellen, Widgetregeln, Seitenanlage. + +### Messung: Baustein im Dialog oder direkt in der Seite + +Lokal gemessen mit einer Seite aus 20 Abschnitten und 20 Bausteinen (nur in der lokalen Datenbank): + +| Variante | Laden | Anfrage (Median) | Antwort | +|---|---|---|---| +| Baustein als Dialog (umgesetzt) | 3,9 s | 1,9 s | 2,2 MB | +| Alle Bausteinformulare in der Seite | 11,3 s | 2,3 s | 3,3 MB | + +Deshalb bleibt der Baustein ein eigener großer Kontext mit dem Schritt „Zur Seite“. Eine Bearbeitung direkt in der Seite hätte das Laden fast verdreifacht. + +## C2: Webpräsenz + +- **Vorher:** + - Zwei getrennte Filament-Listen. „Seiten“ zeigte Pfad, „Veröffentlicht: Ja/Entwurf“ und Datum. + - „Navigation“ war eine Tabelle je Platz mit Dialogen. Jede Handlung (Ausblenden, Ziehen, Löschen) wirkte sofort auf die Website. +- **Nachher:** ein Arbeitsplatz „Webpräsenz“ (Seitenleiste „Website“). Die Register „Seiten“ und „Menüs“ stehen unter einem gemeinsamen Kopf. +- **Seiten:** + - **Zeilen:** Titel, Adresse und Veröffentlichungszustand: „Veröffentlicht (Revision N)“, zusätzlich „Entwurf neuer“, oder „Nur Entwurf, nicht veröffentlicht“. + - **Menüzuordnung:** je Bereich, ausgeblendete Einträge gekennzeichnet; „Ohne Menüeintrag“, wenn es keine gibt. + - **Hinweis bei veröffentlichten Seiten ohne sichtbaren Eintrag:** „öffentlich über die Adresse erreichbar und in der Sitemap“. Das betrifft WEB-05 und WEB-09; es entsteht kein „privat“. + - **Filter:** Veröffentlichung und Menü (im Hauptmenü sichtbar, nicht im Hauptmenü, ohne Menüeintrag). + - **Sortierung:** zuletzt bearbeitet (beide Richtungen) oder Adresse (beide Richtungen). + - **Aktionen:** Bearbeiten, Vorschau, Duplizieren (gleicher Dialog und Pfadfehler wie bisher); „Seite anlegen“ im Kopf. +- **Menüs:** Die Bereichsauswahl zeigt die Zahl der Einträge und „geändert“; die Einträge stehen als Baum mit einer Untermenüebene. + - **Breit (ab etwa 900 px Arbeitsfläche, Entwurf 1):** Liste links, fester Detailbereich rechts. + - **Schmal (Entwurf 3):** genau ein aufgeklappter Eintrag mit denselben Feldern in zwei Spalten. + - Der Detailbereich existiert immer nur einmal. +- **Detail:** + - Menütext. + - Ziel: Seitenkarte mit Zustand, „Ziel ändern“ (Seitensuche mit Zustand), „Seite bearbeiten“ (neuer Tab) und „Stattdessen eine Adresse angeben“. + - „Untermenü von“, „Im Menü anzeigen“, Menübereich und „Aus Menü entfernen“. + - Ein Ziel ohne öffentliche Revision wird erklärt; die Auswahl veröffentlicht nichts (WEB-06). +- **Reihenfolge:** Umordnen per Ziehen, mit „Nach oben“ und „Nach unten“, mit Alt+Pfeil oder über das „…“-Menü einer Zeile. + - Das gilt nur innerhalb derselben Ebene. Ohne gültigen Nachbarn ist die Bewegung deaktiviert, die Ebene wechselt nie still (WEB-12). +- **Speichern (WEB-R05):** + - Alle Menüänderungen bilden einen Arbeitsstand. Der Kopf nennt die betroffenen Bereiche („betrifft Hauptmenü“) und die Wirkung („Wirkt nach dem Speichern sofort auf die öffentliche Navigation“). + - „Menüänderungen speichern“ schreibt alles in einem Schritt. + - Geprüft wird nach den Regeln der bisherigen Form: + - Menütext Pflicht, höchstens 80 Zeichen; + - Seite oder sichere Adresse, außer bei einem Untermenüöffner; + - Untermenü nur unter einem Eintrag der obersten Ebene des Hauptmenüs. + - Beim ersten Fehler wird der Eintrag gewählt, sein Bereich gezeigt und die Meldung steht am Feld. + - Hat jemand die Menüs seit dem Laden an anderer Stelle gespeichert, wird nicht überschrieben. Der Kopf bietet dann „Gespeicherten Stand laden …“ an. + - Geschrieben werden nur geänderte Einträge; unveränderte erhalten höchstens eine neue Reihenfolge. +- **Offene Menüänderungen:** + - Sie bleiben beim Registerwechsel erhalten. + - Die Seitenliste weist darauf hin. + - Beim Verlassen warnt der Browser. + - „Seite bearbeiten“ öffnet einen neuen Tab und speichert nichts mit (WEB-R06). +- **Bisherige Adressen:** `/verwaltung/pages` und `/verwaltung/navigation-items` leiten nach derselben Rechteprüfung in die Webpräsenz. Anlegen und Bearbeiten einer Seite bleiben unter `/verwaltung/pages/…`. + +### Bewusste Verhaltensänderungen und Schutz + +- **Nicht mehr sofort wirksam:** Ausblenden, Umordnen und Entfernen wirken erst mit „Menüänderungen speichern“ (WEB-R05). Das ist die vereinbarte Speichereinheit, keine neue Versionierung. +- **Eintrag mit Untereinträgen bleibt im Hauptmenü:** Die öffentliche Navigation zeigt Untereinträge nur unter Einträgen der Kopfzeile (`SiteNavigation::header()`). Ein Wechsel in den Fußbereich hätte sie unsichtbar gemacht. Der Wechsel ist deshalb gesperrt und wird erklärt. Das schützt vor einem widersprüchlichen Zustand und ist keine neue Fachregel. Ein Untereintrag selbst darf wechseln; er steht dort in der obersten Ebene. +- **Entfernen eines übergeordneten Eintrags:** Die Bestätigung nennt die Untereinträge. Sie rücken schon im Arbeitsstand in die oberste Ebene, so wie die Datenbank beim Löschen (`nullOnDelete`). +- **Reihenfolge je Bereich:** Gezählt wird je Bereich, weil die öffentliche Ausgabe nach Bereich filtert. Eine Umordnung im Hauptmenü schreibt keinen Fußbereich-Eintrag (WEB-02, Test). + +## Tatsächliche Prüfung + +| Prüffall | Ergebnis / Beleg | Grenze | +|---|---|---| +| Seiteneditor, normaler Ablauf (luf-test, Kopie) | Abschnitt 2 gestaltet (Adresse `?abschnitt=1`, Esc zurück), Baustein konfiguriert (Register Inhalt, Medien, Darstellung), „Zur Seite“, „Entwurf speichern“ → Revision 70; Veröffentlichen-Dialog geöffnet und abgebrochen. Bilder 01–05 | Nicht veröffentlicht (Prüfseite bleibt Entwurf) | +| Baustein: Verlassen und Tastatur (luf-test) | Mit `77ebb0c`: Esc lässt den Dialog offen. Mit `0c6519b`: kein Schließen-Kreuz; im Kontext „Abschnitt gestalten“ bei offenem Dialog lösen weder Esc noch Strg+S etwas aus (kein `closeAbschnitt`, kein `save`; Dialog und `?abschnitt=` bleiben); per Tab erreicht: „Zur Seite“ und „Änderungen verwerfen“; Strg+S bei offenem Dialog ruft kein Speichern auf (Livewire-Aufrufe mitgeschnitten), Verlauf bleibt bei 2 Revisionen; „Änderungen verwerfen“ → Status unverändert „Entwurf gespeichert (Revision 70)“. Bild 06 | – | +| Fehlerfall CMS-12 (luf-test) | Abschnitt 2: Hintergrund „Bild“ ohne Bild, „Zur Seite“, „Entwurf speichern“ aus dem Seitenaufbau → Adresse `?abschnitt=1`, Kontext „Abschnitt 2 · Raster 4“, Meldung am Bildfeld; keine Revision; nach Neuladen unverändert. Bild 07 | – | +| Seiteneditor bei 900 und 760 px (luf-test, `d4110b1`) | Kein waagerechter Überlauf; Abschnittskontext und Baustein bedienbar; Dialogfuß bei 900 und 760 am unteren Rand, der Inhalt scrollt (scrollTop 341 bzw. 462). Bilder 08–10 | – | +| Knopffarben (Nachtrag Teil B, luf-test) | „Speichern“ der Säule `rgb(59, 123, 9)` (Verwaltungsgrün); Dialog „Neuer Lizenzartikel“: „Artikel anlegen“ grün, „Abbrechen“ weiß; Raster: gewählte Option grün markiert, übrige weiß; Vorschaubreite: „4 Einheiten“ vorgewählt und markiert, übrige weiß. Bilder 09, 11, 12 | – | +| Webpräsenz, Seiten (luf-test) | `/verwaltung/pages` führt zu `/verwaltung/webpraesenz`; 21 Seiten; Filter „Ohne Menüeintrag“ → 12 Seiten; Zustände und Menübereiche je Zeile. Bilder 13, 14, 22 | – | +| Duplizieren | luf-test: „Duplizieren: Impressum“ öffnet „Seite /impressum duplizieren“, Fokus im Feld „Pfad der neuen Seite“, abgebrochen. Lokal: vorhandener Pfad → „Diesen Pfad verwendet bereits eine andere Seite.“ im offenen Dialog; neuer Pfad → Weiterleitung in den Editor der Kopie | Auf luf-test nicht abgeschickt (die Kopie bliebe dauerhaft) | +| Webpräsenz, Menüs: Fehler, Anlegen, Entfernen (luf-test) | `/verwaltung/navigation-items` führt zu `?bereich=menues`. Fußbereich Rechtliches: „Eintrag hinzufügen“ setzt den Fokus in den Menütext; Speichern ohne Angaben → „Bitte einen Menütext eingeben.“ und „Wählen Sie eine Seite oder eine Adresse.“, nichts geschrieben. Prüfeintrag mit Ziel Impressum über die Seitensuche, ausgeblendet, gespeichert (Meldung „Die öffentliche Navigation zeigt jetzt den neuen Stand: Fußbereich: Rechtliches.“); öffentliche Seite `/impressum` zeigt ihn nicht. Danach über die Bestätigung entfernt und gespeichert. Datenbank vorher und nachher identisch. Bilder 15–19 | – | +| Menüs bei 900 und 760 px (luf-test) | Schmale Anordnung, genau ein aufgeklappter Eintrag, ein Detailbereich, Pfeile je Zeile (erste Zeile „nach oben“ deaktiviert). Bilder 20, 21 | – | +| Tastatur Menüs (lokal, 1440 und 760) | Alt+↑ verschiebt den fokussierten Eintrag, der Fokus bleibt auf ihm; Tab erreicht danach dessen Aktionen | – | +| Auswahlwechsel (lokal, 1440 und 760) | Nach Wechsel der Auswahl ändert eine Eingabe nur den gewählten Eintrag (siehe Fehler 4) | – | +| Ziehen (lokal) | Oberste Ebene: „Angebote“ vor „Prävention“ gezogen; Untermenü: zwei Untereinträge vertauscht, oberste Ebene unverändert; danach wählt jede Zeile ihren eigenen Eintrag; keine JS-Fehler; verworfen. Bild 23 | Nur lokal (auf luf-test nicht gespeichert) | +| Feature-Tests | `CmsArbeitsplatzTest` (9): Kopfzustände, ausgeblendete Register, Fehler wechselt das Register, Verlauf per Adresse, Abschnittskontext übersteht das Speichern, Baustein-Überschrift und Verlassen, Gestaltungsfehler öffnet den Abschnitt (auch aus einem anderen Kontext). `WebpraesenzTest` (17): Weiterleitungen und Rechte, Zustände und Filter, Sortierung ändert keine Menüs, Duplizieren, Arbeitsstand über Registerwechsel, öffentliche Reihenfolge = Editorreihenfolge, Fußbereich unberührt, Bewegungsgrenzen, Ziehen nur unter Geschwistern, Entfernen mit Untereinträgen, Bereichsschutz, Regeln und Fehlerauswahl, Prüfeintrag ohne Spuren, zwischenzeitliche Änderung, Verwerfen, ein Detailbereich je Anordnung, Ziel ohne Veröffentlichung, nur geänderte Einträge geschrieben. Bewusst übertragen: Tests der alten Seitenliste und Navigation (`CmsEditorTest`, `CmsPageListAndSpacingTest`, `AdministrationTest`) prüfen dieselben Erwartungen jetzt in der Webpräsenz | – | +| Repository | Lokal 330 Tests grün, Pint grün; `ci-feature` und `deploy-test` für jeden Commit grün | Instanz-Suite (U0) existiert noch nicht | + +## Gefundene und behobene Fehler + +1. **Revisionen-Register leer:** Die Tabelle lud nur verzögert und blieb im ausgeblendeten Register leer. Sie lädt jetzt sofort. +2. **Zu breite Hauptknopf-Regel:** Sie traf Auswahlfelder in Knopfform. Das betraf die Vorschaubreite und Knopfgruppen. Behoben mit `77ebb0c`; der Nachtrag in [teil-b.md](teil-b.md) ist berichtigt. +3. **Stille Verlustwege im Bausteindialog:** Das Schließen-Kreuz verwarf still. Strg+S speicherte die Seite bei offenem Dialog ohne dessen Eingaben (`bc6e4ec`). +4. **Offene Dialoge falsch erkannt:** Die erste Prüfung (`offsetParent`) hielt fest positionierte Filament-Dialoge immer für geschlossen. Auf luf-test bemerkt, mit `getClientRects()` behoben (`0c6519b`), danach auf luf-test nachgeprüft. +5. **Auswahlwechsel im Menüeditor:** Nach einem Wechsel blieb das Feld „Menütext“ an den vorigen Eintrag gebunden; eine Eingabe änderte zwei Einträge. Lokal gefunden und vor der Auslieferung behoben: Der Detailbereich hat einen eigenen Schlüssel je Eintrag. +6. **Unbeteiligte Einträge mitgeschrieben:** Die erste Fassung des Speicherns hätte unveränderte Einträge mitgeschrieben (Nummerierung über alle Bereiche, Bereinigung von Leerzeichen). Vor der Auslieferung behoben, mit Test. +7. **Dialogfuß bei 900 px nicht erreichbar:** Im Bausteindialog lagen „Zur Seite“ und „Änderungen verwerfen“ außerhalb des Fensters, sobald die Vorschau unter dem Formular stand. Ohne Kreuz und Esc war der Dialog nicht zu verlassen. Auf luf-test gefunden, mit `d4110b1` behoben und nachgeprüft. + +## Abweichungen und offene Punkte + +- **Bausteindialog:** Er deckt den Seitenkopf ab. „Zur Seite“ ist ein Übernahmeschritt in den Entwurf, kein Speichern. Begründung: Messung oben. +- **Dialogknöpfe:** Die Reihenfolge in Filament-Dialogen bleibt „Hauptaktion zuerst“ (Filament-Standard). +- **Keine Menüvorschau:** Es gibt keine Vorschau des offenen Arbeitsstands. „Website ansehen (gespeicherter Stand)“ öffnet die Website und sagt, welchen Stand sie zeigt (WEB-R07); WEB-13 entfällt damit. +- **Keine Suche in der Menüliste:** Die Suche ist eine vorgeschlagene Detailregel in Dokument 13 und wurde nicht gebaut. Die Liste zeigt immer einen ganzen Bereich. +- **Erste Darstellung breit:** Die Menüs erscheinen immer zuerst in der breiten Anordnung. In schmalen Fenstern wechselt die Anordnung nach einer Anfrage. +- **Menüzuordnungen im Register „Seiten“:** Sie zeigen den gespeicherten Stand. Auf offene Änderungen weist ein Hinweis hin. +- **Nicht umgesetzt:** „Website-Rahmen“ (OFF-25), versteckte Seiten mit Suchmaschinenangabe (OFF-24) und eine Seitenorganisation (OFF-23). +- **Lokal statt luf-test:** Ziehen und das Abschicken von „Duplizieren“ sind nur lokal geprüft. + +## Belege + +| | | +|---|---| +| ![Seitenaufbau](teil-c/01-seitenaufbau.jpg) | ![Abschnitt gestalten](teil-c/02-abschnitt-gestalten.jpg) | +| ![Baustein konfigurieren](teil-c/03-baustein-konfigurieren.jpg) | ![Seiteneinstellungen](teil-c/04-seiteneinstellungen.jpg) | +| ![Verlauf](teil-c/05-verlauf.jpg) | ![Baustein ohne Kreuz](teil-c/06-baustein-ohne-kreuz.jpg) | +| ![Fehler öffnet Abschnitt](teil-c/07-fehler-oeffnet-abschnitt.jpg) | ![Seitenaufbau 900 px](teil-c/08-seitenaufbau-900.jpg) | +| ![Abschnitt 760 px](teil-c/09-abschnitt-760.jpg) | ![Baustein 760 px](teil-c/10-baustein-760.jpg) | +| ![Säule Speichern](teil-c/11-saeule-speichern.jpg) | ![Katalogdialog](teil-c/12-katalogdialog.jpg) | +| ![Webpräsenz Seiten](teil-c/13-webpraesenz-seiten.jpg) | ![Seiten ohne Menüeintrag](teil-c/14-seiten-ohne-menueeintrag.jpg) | +| ![Menüs](teil-c/15-menues.jpg) | ![Menü Fehler](teil-c/16-menue-fehler.jpg) | +| ![Zielseite wählen](teil-c/17-zielseite-waehlen.jpg) | ![Prüfeintrag offen](teil-c/18-pruefeintrag-offen.jpg) | +| ![Aus Menü entfernen](teil-c/19-aus-menue-entfernen.jpg) | ![Menüs 900 px](teil-c/20-menues-900.jpg) | +| ![Menüs 760 px](teil-c/21-menues-760.jpg) | ![Seiten 760 px](teil-c/22-seiten-760.jpg) | +| ![Ziehen (lokal)](teil-c/23-ziehen-lokal.jpg) | | + +## Nachtrag: CMS-Abschluss (Bedienbarkeit) + +Stand: 20.11.2026. **Geprüfter Code-Stand:** `develop` mit `f3eda56` auf `luf-test` (Lauf 4952). Prüfseite: neue dauerhafte Kopie `/ux-pruefung-aufbau` (Seite 22) von `/premium-referenz`. Sie hat 7 Abschnitte, die Raster 4, 3 + 1, 2 + 2 und 1 + 1 + 1 + 1 und die Bausteine Hero, Handlungsaufruf, Bild und Text, Fließtext, Überschrift und Karten. Das Original blieb unverändert. Die Kopie ist auf luf-test veröffentlicht (Revision 75; Revision 76 ist ein neuerer Entwurf). Geprüft bei 100 % Zoom in den Fenstergrößen 1440 × 900 und 1280 × 800. Keine neuen CMS-Funktionen, kein Frameworkwechsel. + +### Was sich geändert hat + +- **Seitenaufbau als Überblick:** + - Jeder Baustein erscheint als Miniaturvorschau: gleiche Ausgabe wie die Website, in Desktop-Proportion gerendert, verkleinert und in der Höhe begrenzt. + - Der Abschnittskopf zeigt „Abschnitt N“, das Raster und nur abweichende Gestaltung; vollständig steht alles im Titel und für Screenreader bereit. + - Plätze haben keinen eigenen Kopf mehr. Sie zeigen sich über Lage und Breite, ein Griff verschiebt den Baustein. Ein Platz, der nicht passt, bleibt als Warnung sichtbar. + - Bausteine tragen einen kurzen Namen und eine Inhaltsangabe. + - Alle Aktionen nennen ihr Ziel, etwa „Abschnitt duplizieren“, „Baustein entfernen“ oder „Baustein auf einen anderen Platz ziehen“. + - Rahmen und Überschrift „Inhalt der Seite“ und die leeren Abstände ausgeblendeter Teile entfallen. + - Die Typzeile im Kopf entfällt (der Pfad steht im Brotkrumenpfad), und der Speicherstand steht in einer Zeile. + - Erläuterungen stehen unter „Hilfe“. + - Ergebnis: Der Seitenaufbau der Prüfseite ist bei 1440 px 1978 px hoch statt 5907 px. Im ersten Bild sind zwei ganze Abschnitte und der dritte mit Kopf und Bausteinen zu sehen, vorher war es ein Abschnitt. +- **Abschnitt gestalten:** + - Eine knappe Leiste mit „Zum Seitenaufbau“, „Abschnitt N gestalten · Raster X“ und „Hilfe“; keine wiederholte Zusammenfassung mehr. + - Die Einstellungen stehen in den Gruppen „Raster und Breite“, „Hintergrund“ (Bild, Ausschnitt und Überlagerung nur bei „Bild“) sowie „Abstände und Trenner“. Feldtexte sind zu Hinweisen geworden. + - Darunter steht der Abschnitt als kompakte Vorschau aus Miniaturen. + - Die Rückkehr springt an den Abschnitt und setzt den Fokus auf dessen „Abschnitt gestalten“. +- **Baustein konfigurieren:** + - Im Fuß stehen „Zum Seitenaufbau“, „Entwurf speichern“ (übernimmt und speichert ohne Zwischenschritt) und „Änderungen verwerfen“. + - Karten mit Fachobjekt zeigen die zentrale Angabe aus der Redaktion als Platzhalter. Eine eigene Angabe ist als „Eigene Angabe für diese Karte“ markiert. +- **Bildauswahl über den gemeinsamen Picker:** + - Bildfelder in Bausteinen und im Abschnittshintergrund öffnen den gemeinsamen visuellen Picker. Die bisherige eigene Auswahlliste entfällt. + - Der allgemeine Teil des Pickers liegt im Trait `ChoosesMedia`, aus der Redaktion herausgelöst und nicht kopiert. + - `ChoosesWebsiteImages` übernimmt nur Website-Bilder in genau das auslösende Feld, auch im Bausteindialog. Die Auswahl gibt nichts frei. + - Das Hochladen eines neuen Bilds bleibt unverändert. +- **Webpräsenz:** + - Kompakter Kopf; Erläuterungen zu Sortierung, Ausblenden, Speichern und Veröffentlichung stehen unter „Hilfe“. + - Der Chip zeigt „Veröffentlicht“, die Revisionsnummer steht in der Detailzeile. + - In den Menüs gibt es kein Dauerband und keine wiederholten Erläuterungen mehr. Menüliste und Detailbearbeitung bleiben. + +### Geprüfte Abläufe (luf-test) + +| Ablauf | Ergebnis | +|---|---| +| Überblick | 1440 × 900: zwei Abschnitte ganz, der dritte mit Kopf und Bausteinen; 1280 × 800: ein ganzer, der zweite mit Bausteinen. Bilder 30–32 | +| Abschnitt gestalten | Hintergrund von „Standard“ auf „Hell“ geändert, „Zum Seitenaufbau“ → Status „Änderungen nicht gespeichert“, Abschnitt 3 oben im Bild, Fokus auf „Abschnitt gestalten“; wieder geöffnet: Wert erhalten; Esc → Seitenaufbau. Bild 33 | +| Baustein | Text geändert, „Zum Seitenaufbau“, wieder geöffnet: Eingabe erhalten. Bild 34 | +| Bild über den Picker | Im Baustein „Bild auswählen“ → gemeinsamer Picker über dem Dialog (10 Bilder, Fokus im Suchfeld); Esc schließt nur den Picker; Bild betrachtet, ausgewählt, „Bild übernehmen“ → im Baustein gesetzt. Bild 35 | +| Speichern aus dem Baustein | „Entwurf speichern“ im Dialog → Dialog zu, Kopf „Entwurf gespeichert (Revision 76) · Öffentlich: Revision 75 · der gespeicherte Entwurf ist neuer“. Bild 36 | +| Vorschau und Veröffentlichung | Seitenvorschau der Revision lädt und enthält die Änderung; „Veröffentlichen …“ an der Kopie → „Gespeicherter Stand ist veröffentlicht (Revision 75)“, `/ux-pruefung-aufbau` öffentlich mit der Änderung | +| Tastatur | Tab im Seitenaufbau: „Abschnitt gestalten“, „Abschnitt duplizieren“, „Abschnitt löschen“, „Abschnitt einklappen“, „Baustein auf einen anderen Platz ziehen“, „Konfigurieren“, „Baustein entfernen“, „Abschnitt ziehen“, „Abschnitt nach oben/unten“ | +| Öffentliche Darstellung | 12 öffentliche Seiten (`/`, `/praevention`, `/premium-referenz`, `/referenz-abschnitte`, `/designreferenz` und weitere) nach jedem Deploy mit dem Stand vor dem Umbau verglichen: identisch | +| Webpräsenz | Seiten und Menüs mit Hilfe geprüft. Bilder 37, 38 | +| Tests | 334 grün, darunter neu: Gruppen speichern gemeinsam, Speichern aus dem Baustein, Bild über den Picker bis in die Revision, Pfadprüfung des Pickers. Bewusst angepasst: Texte „Zum Seitenaufbau“, Gruppennamen, Bausteinbeschriftung | + +### Gefundene und behobene Fehler + +1. **Leere Abstände:** Ausgeblendete Formularteile behielten ihre Rasterzelle, das ergab etwa 70 px Leerraum je Abschnitt. Behoben. +2. **Veralteter Kopf:** Nach „Entwurf speichern“ aus dem Baustein zeigte der Kopf weiter „Änderungen nicht gespeichert“, weil Filament nach einer Dialogaktion nur den Dialog neu rendert. Auf luf-test gefunden und mit `f3eda56` behoben. + +### Restpunkte (klein, nicht ausgeweitet) + +- Bei 1280 × 800 ist nur ein Abschnitt ganz sichtbar. Für den vollständigen Überblick gibt es „Alle einklappen“. +- Lange Seitentitel brechen im Kopf bei 1280 px um. +- In Plätzen mit einer Einheit steht „Konfigurieren“ unter dem Namen. +- Ein Einstieg wird höchstens auf die Hälfte verkleinert und unten abgeschnitten. Langtext ist in der Miniatur nur als Textblock erkennbar. +- Der Picker zeigt wie in der Redaktion auch Bild-Entwürfe. Ob ein Bild öffentlich erscheint, sagt die Website-Freigabe im Detail. + +### Belege + +| | | +|---|---| +| ![Vorher: Seitenaufbau](teil-c/30-vorher-seitenaufbau.jpg) | ![Seitenaufbau 1440](teil-c/31-seitenaufbau-1440.jpg) | +| ![Seitenaufbau 1280](teil-c/32-seitenaufbau-1280.jpg) | ![Abschnitt gestalten](teil-c/33-abschnitt-gestalten.jpg) | +| ![Baustein](teil-c/34-baustein.jpg) | ![Bild im gemeinsamen Picker](teil-c/35-bild-im-gemeinsamen-picker.jpg) | +| ![Gespeichert aus dem Baustein](teil-c/36-gespeichert-aus-dem-baustein.jpg) | ![Webpräsenz Seiten](teil-c/37-webpraesenz-seiten.jpg) | +| ![Webpräsenz Menüs mit Hilfe](teil-c/38-webpraesenz-menues-hilfe.jpg) | | diff --git a/docs/ux/verwaltung/abnahme/teil-c/01-seitenaufbau.jpg b/docs/ux/verwaltung/abnahme/teil-c/01-seitenaufbau.jpg new file mode 100644 index 0000000..81dd0d6 Binary files /dev/null and b/docs/ux/verwaltung/abnahme/teil-c/01-seitenaufbau.jpg differ diff --git a/docs/ux/verwaltung/abnahme/teil-c/02-abschnitt-gestalten.jpg b/docs/ux/verwaltung/abnahme/teil-c/02-abschnitt-gestalten.jpg new file mode 100644 index 0000000..ff0fa96 Binary files /dev/null and b/docs/ux/verwaltung/abnahme/teil-c/02-abschnitt-gestalten.jpg differ diff --git a/docs/ux/verwaltung/abnahme/teil-c/03-baustein-konfigurieren.jpg b/docs/ux/verwaltung/abnahme/teil-c/03-baustein-konfigurieren.jpg new file mode 100644 index 0000000..ac12483 Binary files /dev/null and b/docs/ux/verwaltung/abnahme/teil-c/03-baustein-konfigurieren.jpg differ diff --git a/docs/ux/verwaltung/abnahme/teil-c/04-seiteneinstellungen.jpg b/docs/ux/verwaltung/abnahme/teil-c/04-seiteneinstellungen.jpg new file mode 100644 index 0000000..b3cfc87 Binary files /dev/null and b/docs/ux/verwaltung/abnahme/teil-c/04-seiteneinstellungen.jpg differ diff --git a/docs/ux/verwaltung/abnahme/teil-c/05-verlauf.jpg b/docs/ux/verwaltung/abnahme/teil-c/05-verlauf.jpg new file mode 100644 index 0000000..8c97f74 Binary files /dev/null and b/docs/ux/verwaltung/abnahme/teil-c/05-verlauf.jpg differ diff --git a/docs/ux/verwaltung/abnahme/teil-c/06-baustein-ohne-kreuz.jpg b/docs/ux/verwaltung/abnahme/teil-c/06-baustein-ohne-kreuz.jpg new file mode 100644 index 0000000..5186c76 Binary files /dev/null and b/docs/ux/verwaltung/abnahme/teil-c/06-baustein-ohne-kreuz.jpg differ diff --git a/docs/ux/verwaltung/abnahme/teil-c/07-fehler-oeffnet-abschnitt.jpg b/docs/ux/verwaltung/abnahme/teil-c/07-fehler-oeffnet-abschnitt.jpg new file mode 100644 index 0000000..4a9189a Binary files /dev/null and b/docs/ux/verwaltung/abnahme/teil-c/07-fehler-oeffnet-abschnitt.jpg differ diff --git a/docs/ux/verwaltung/abnahme/teil-c/08-seitenaufbau-900.jpg b/docs/ux/verwaltung/abnahme/teil-c/08-seitenaufbau-900.jpg new file mode 100644 index 0000000..2aa2965 Binary files /dev/null and b/docs/ux/verwaltung/abnahme/teil-c/08-seitenaufbau-900.jpg differ diff --git a/docs/ux/verwaltung/abnahme/teil-c/09-abschnitt-760.jpg b/docs/ux/verwaltung/abnahme/teil-c/09-abschnitt-760.jpg new file mode 100644 index 0000000..6122bdb Binary files /dev/null and b/docs/ux/verwaltung/abnahme/teil-c/09-abschnitt-760.jpg differ diff --git a/docs/ux/verwaltung/abnahme/teil-c/10-baustein-760.jpg b/docs/ux/verwaltung/abnahme/teil-c/10-baustein-760.jpg new file mode 100644 index 0000000..d89240e Binary files /dev/null and b/docs/ux/verwaltung/abnahme/teil-c/10-baustein-760.jpg differ diff --git a/docs/ux/verwaltung/abnahme/teil-c/11-saeule-speichern.jpg b/docs/ux/verwaltung/abnahme/teil-c/11-saeule-speichern.jpg new file mode 100644 index 0000000..e076a44 Binary files /dev/null and b/docs/ux/verwaltung/abnahme/teil-c/11-saeule-speichern.jpg differ diff --git a/docs/ux/verwaltung/abnahme/teil-c/12-katalogdialog.jpg b/docs/ux/verwaltung/abnahme/teil-c/12-katalogdialog.jpg new file mode 100644 index 0000000..6ec01ee Binary files /dev/null and b/docs/ux/verwaltung/abnahme/teil-c/12-katalogdialog.jpg differ diff --git a/docs/ux/verwaltung/abnahme/teil-c/13-webpraesenz-seiten.jpg b/docs/ux/verwaltung/abnahme/teil-c/13-webpraesenz-seiten.jpg new file mode 100644 index 0000000..7d0601d Binary files /dev/null and b/docs/ux/verwaltung/abnahme/teil-c/13-webpraesenz-seiten.jpg differ diff --git a/docs/ux/verwaltung/abnahme/teil-c/14-seiten-ohne-menueeintrag.jpg b/docs/ux/verwaltung/abnahme/teil-c/14-seiten-ohne-menueeintrag.jpg new file mode 100644 index 0000000..0f61606 Binary files /dev/null and b/docs/ux/verwaltung/abnahme/teil-c/14-seiten-ohne-menueeintrag.jpg differ diff --git a/docs/ux/verwaltung/abnahme/teil-c/15-menues.jpg b/docs/ux/verwaltung/abnahme/teil-c/15-menues.jpg new file mode 100644 index 0000000..1ddcbf5 Binary files /dev/null and b/docs/ux/verwaltung/abnahme/teil-c/15-menues.jpg differ diff --git a/docs/ux/verwaltung/abnahme/teil-c/16-menue-fehler.jpg b/docs/ux/verwaltung/abnahme/teil-c/16-menue-fehler.jpg new file mode 100644 index 0000000..f0f4690 Binary files /dev/null and b/docs/ux/verwaltung/abnahme/teil-c/16-menue-fehler.jpg differ diff --git a/docs/ux/verwaltung/abnahme/teil-c/17-zielseite-waehlen.jpg b/docs/ux/verwaltung/abnahme/teil-c/17-zielseite-waehlen.jpg new file mode 100644 index 0000000..0fb0376 Binary files /dev/null and b/docs/ux/verwaltung/abnahme/teil-c/17-zielseite-waehlen.jpg differ diff --git a/docs/ux/verwaltung/abnahme/teil-c/18-pruefeintrag-offen.jpg b/docs/ux/verwaltung/abnahme/teil-c/18-pruefeintrag-offen.jpg new file mode 100644 index 0000000..9858d74 Binary files /dev/null and b/docs/ux/verwaltung/abnahme/teil-c/18-pruefeintrag-offen.jpg differ diff --git a/docs/ux/verwaltung/abnahme/teil-c/19-aus-menue-entfernen.jpg b/docs/ux/verwaltung/abnahme/teil-c/19-aus-menue-entfernen.jpg new file mode 100644 index 0000000..ba0bfb7 Binary files /dev/null and b/docs/ux/verwaltung/abnahme/teil-c/19-aus-menue-entfernen.jpg differ diff --git a/docs/ux/verwaltung/abnahme/teil-c/20-menues-900.jpg b/docs/ux/verwaltung/abnahme/teil-c/20-menues-900.jpg new file mode 100644 index 0000000..e23bafe Binary files /dev/null and b/docs/ux/verwaltung/abnahme/teil-c/20-menues-900.jpg differ diff --git a/docs/ux/verwaltung/abnahme/teil-c/21-menues-760.jpg b/docs/ux/verwaltung/abnahme/teil-c/21-menues-760.jpg new file mode 100644 index 0000000..cd3fa38 Binary files /dev/null and b/docs/ux/verwaltung/abnahme/teil-c/21-menues-760.jpg differ diff --git a/docs/ux/verwaltung/abnahme/teil-c/22-seiten-760.jpg b/docs/ux/verwaltung/abnahme/teil-c/22-seiten-760.jpg new file mode 100644 index 0000000..b994453 Binary files /dev/null and b/docs/ux/verwaltung/abnahme/teil-c/22-seiten-760.jpg differ diff --git a/docs/ux/verwaltung/abnahme/teil-c/23-ziehen-lokal.jpg b/docs/ux/verwaltung/abnahme/teil-c/23-ziehen-lokal.jpg new file mode 100644 index 0000000..5222d41 Binary files /dev/null and b/docs/ux/verwaltung/abnahme/teil-c/23-ziehen-lokal.jpg differ diff --git a/docs/ux/verwaltung/abnahme/teil-c/30-vorher-seitenaufbau.jpg b/docs/ux/verwaltung/abnahme/teil-c/30-vorher-seitenaufbau.jpg new file mode 100644 index 0000000..38f0c4b Binary files /dev/null and b/docs/ux/verwaltung/abnahme/teil-c/30-vorher-seitenaufbau.jpg differ diff --git a/docs/ux/verwaltung/abnahme/teil-c/31-seitenaufbau-1440.jpg b/docs/ux/verwaltung/abnahme/teil-c/31-seitenaufbau-1440.jpg new file mode 100644 index 0000000..8746bad Binary files /dev/null and b/docs/ux/verwaltung/abnahme/teil-c/31-seitenaufbau-1440.jpg differ diff --git a/docs/ux/verwaltung/abnahme/teil-c/32-seitenaufbau-1280.jpg b/docs/ux/verwaltung/abnahme/teil-c/32-seitenaufbau-1280.jpg new file mode 100644 index 0000000..83665c6 Binary files /dev/null and b/docs/ux/verwaltung/abnahme/teil-c/32-seitenaufbau-1280.jpg differ diff --git a/docs/ux/verwaltung/abnahme/teil-c/33-abschnitt-gestalten.jpg b/docs/ux/verwaltung/abnahme/teil-c/33-abschnitt-gestalten.jpg new file mode 100644 index 0000000..f549d8a Binary files /dev/null and b/docs/ux/verwaltung/abnahme/teil-c/33-abschnitt-gestalten.jpg differ diff --git a/docs/ux/verwaltung/abnahme/teil-c/34-baustein.jpg b/docs/ux/verwaltung/abnahme/teil-c/34-baustein.jpg new file mode 100644 index 0000000..c29b182 Binary files /dev/null and b/docs/ux/verwaltung/abnahme/teil-c/34-baustein.jpg differ diff --git a/docs/ux/verwaltung/abnahme/teil-c/35-bild-im-gemeinsamen-picker.jpg b/docs/ux/verwaltung/abnahme/teil-c/35-bild-im-gemeinsamen-picker.jpg new file mode 100644 index 0000000..ec6d55d Binary files /dev/null and b/docs/ux/verwaltung/abnahme/teil-c/35-bild-im-gemeinsamen-picker.jpg differ diff --git a/docs/ux/verwaltung/abnahme/teil-c/36-gespeichert-aus-dem-baustein.jpg b/docs/ux/verwaltung/abnahme/teil-c/36-gespeichert-aus-dem-baustein.jpg new file mode 100644 index 0000000..a021316 Binary files /dev/null and b/docs/ux/verwaltung/abnahme/teil-c/36-gespeichert-aus-dem-baustein.jpg differ diff --git a/docs/ux/verwaltung/abnahme/teil-c/37-webpraesenz-seiten.jpg b/docs/ux/verwaltung/abnahme/teil-c/37-webpraesenz-seiten.jpg new file mode 100644 index 0000000..728da2c Binary files /dev/null and b/docs/ux/verwaltung/abnahme/teil-c/37-webpraesenz-seiten.jpg differ diff --git a/docs/ux/verwaltung/abnahme/teil-c/38-webpraesenz-menues-hilfe.jpg b/docs/ux/verwaltung/abnahme/teil-c/38-webpraesenz-menues-hilfe.jpg new file mode 100644 index 0000000..3896d86 Binary files /dev/null and b/docs/ux/verwaltung/abnahme/teil-c/38-webpraesenz-menues-hilfe.jpg differ diff --git a/docs/ux/verwaltung/audit/01-dashboard.jpg b/docs/ux/verwaltung/audit/01-dashboard.jpg new file mode 100644 index 0000000..924e17f Binary files /dev/null and b/docs/ux/verwaltung/audit/01-dashboard.jpg differ diff --git a/docs/ux/verwaltung/audit/02-arbeitsplatz.jpg b/docs/ux/verwaltung/audit/02-arbeitsplatz.jpg new file mode 100644 index 0000000..9fac72e Binary files /dev/null and b/docs/ux/verwaltung/audit/02-arbeitsplatz.jpg differ diff --git a/docs/ux/verwaltung/audit/03-modul-aufbau.jpg b/docs/ux/verwaltung/audit/03-modul-aufbau.jpg new file mode 100644 index 0000000..d63a1de Binary files /dev/null and b/docs/ux/verwaltung/audit/03-modul-aufbau.jpg differ diff --git a/docs/ux/verwaltung/audit/04-materialpicker.jpg b/docs/ux/verwaltung/audit/04-materialpicker.jpg new file mode 100644 index 0000000..f7b983d Binary files /dev/null and b/docs/ux/verwaltung/audit/04-materialpicker.jpg differ diff --git a/docs/ux/verwaltung/audit/05-modul-beschreibung.jpg b/docs/ux/verwaltung/audit/05-modul-beschreibung.jpg new file mode 100644 index 0000000..59af117 Binary files /dev/null and b/docs/ux/verwaltung/audit/05-modul-beschreibung.jpg differ diff --git a/docs/ux/verwaltung/audit/06-modul-einordnung.jpg b/docs/ux/verwaltung/audit/06-modul-einordnung.jpg new file mode 100644 index 0000000..385c9ca Binary files /dev/null and b/docs/ux/verwaltung/audit/06-modul-einordnung.jpg differ diff --git a/docs/ux/verwaltung/audit/07-medien-uebersicht.jpg b/docs/ux/verwaltung/audit/07-medien-uebersicht.jpg new file mode 100644 index 0000000..88c9992 Binary files /dev/null and b/docs/ux/verwaltung/audit/07-medien-uebersicht.jpg differ diff --git a/docs/ux/verwaltung/audit/08-medien-liste.jpg b/docs/ux/verwaltung/audit/08-medien-liste.jpg new file mode 100644 index 0000000..bcd4993 Binary files /dev/null and b/docs/ux/verwaltung/audit/08-medien-liste.jpg differ diff --git a/docs/ux/verwaltung/audit/09-medien-suche.jpg b/docs/ux/verwaltung/audit/09-medien-suche.jpg new file mode 100644 index 0000000..f23f60f Binary files /dev/null and b/docs/ux/verwaltung/audit/09-medien-suche.jpg differ diff --git a/docs/ux/verwaltung/audit/10-medium-beschreibung.jpg b/docs/ux/verwaltung/audit/10-medium-beschreibung.jpg new file mode 100644 index 0000000..4903f29 Binary files /dev/null and b/docs/ux/verwaltung/audit/10-medium-beschreibung.jpg differ diff --git a/docs/ux/verwaltung/audit/11-medium-fassungen.jpg b/docs/ux/verwaltung/audit/11-medium-fassungen.jpg new file mode 100644 index 0000000..2c74496 Binary files /dev/null and b/docs/ux/verwaltung/audit/11-medium-fassungen.jpg differ diff --git a/docs/ux/verwaltung/audit/12-medium-verwendung.jpg b/docs/ux/verwaltung/audit/12-medium-verwendung.jpg new file mode 100644 index 0000000..ba369b0 Binary files /dev/null and b/docs/ux/verwaltung/audit/12-medium-verwendung.jpg differ diff --git a/docs/ux/verwaltung/audit/13-medium-praesentationspicker.jpg b/docs/ux/verwaltung/audit/13-medium-praesentationspicker.jpg new file mode 100644 index 0000000..91ad52d Binary files /dev/null and b/docs/ux/verwaltung/audit/13-medium-praesentationspicker.jpg differ diff --git a/docs/ux/verwaltung/audit/14-cms-seitenliste.jpg b/docs/ux/verwaltung/audit/14-cms-seitenliste.jpg new file mode 100644 index 0000000..6758099 Binary files /dev/null and b/docs/ux/verwaltung/audit/14-cms-seitenliste.jpg differ diff --git a/docs/ux/verwaltung/audit/15-cms-editor.jpg b/docs/ux/verwaltung/audit/15-cms-editor.jpg new file mode 100644 index 0000000..bcf694e Binary files /dev/null and b/docs/ux/verwaltung/audit/15-cms-editor.jpg differ diff --git a/docs/ux/verwaltung/audit/16-cms-widgetdialog.jpg b/docs/ux/verwaltung/audit/16-cms-widgetdialog.jpg new file mode 100644 index 0000000..23d6960 Binary files /dev/null and b/docs/ux/verwaltung/audit/16-cms-widgetdialog.jpg differ diff --git a/docs/ux/verwaltung/audit/17-cms-bildpicker.jpg b/docs/ux/verwaltung/audit/17-cms-bildpicker.jpg new file mode 100644 index 0000000..a93a286 Binary files /dev/null and b/docs/ux/verwaltung/audit/17-cms-bildpicker.jpg differ diff --git a/docs/ux/verwaltung/audit/18-cms-geraetevorschau.jpg b/docs/ux/verwaltung/audit/18-cms-geraetevorschau.jpg new file mode 100644 index 0000000..3438356 Binary files /dev/null and b/docs/ux/verwaltung/audit/18-cms-geraetevorschau.jpg differ diff --git a/docs/ux/verwaltung/audit/19-cms-struktur-revisionen.jpg b/docs/ux/verwaltung/audit/19-cms-struktur-revisionen.jpg new file mode 100644 index 0000000..e1377e1 Binary files /dev/null and b/docs/ux/verwaltung/audit/19-cms-struktur-revisionen.jpg differ diff --git a/docs/ux/verwaltung/audit/20-kombination-leerzustand.jpg b/docs/ux/verwaltung/audit/20-kombination-leerzustand.jpg new file mode 100644 index 0000000..811184d Binary files /dev/null and b/docs/ux/verwaltung/audit/20-kombination-leerzustand.jpg differ diff --git a/docs/ux/verwaltung/audit/21-kombination-anlegen.jpg b/docs/ux/verwaltung/audit/21-kombination-anlegen.jpg new file mode 100644 index 0000000..83d22b8 Binary files /dev/null and b/docs/ux/verwaltung/audit/21-kombination-anlegen.jpg differ diff --git a/docs/ux/verwaltung/audit/22-module-tabelle.jpg b/docs/ux/verwaltung/audit/22-module-tabelle.jpg new file mode 100644 index 0000000..627999d Binary files /dev/null and b/docs/ux/verwaltung/audit/22-module-tabelle.jpg differ diff --git a/docs/ux/verwaltung/audit/23-programme-tabelle.jpg b/docs/ux/verwaltung/audit/23-programme-tabelle.jpg new file mode 100644 index 0000000..20cd1a1 Binary files /dev/null and b/docs/ux/verwaltung/audit/23-programme-tabelle.jpg differ diff --git a/docs/ux/verwaltung/audit/24-programm-aufbau.jpg b/docs/ux/verwaltung/audit/24-programm-aufbau.jpg new file mode 100644 index 0000000..85b84bf Binary files /dev/null and b/docs/ux/verwaltung/audit/24-programm-aufbau.jpg differ diff --git a/docs/ux/verwaltung/audit/25-programm-fassungsstatus.jpg b/docs/ux/verwaltung/audit/25-programm-fassungsstatus.jpg new file mode 100644 index 0000000..1f3b8a2 Binary files /dev/null and b/docs/ux/verwaltung/audit/25-programm-fassungsstatus.jpg differ diff --git a/docs/ux/verwaltung/audit/26-lizenzartikel-liste.jpg b/docs/ux/verwaltung/audit/26-lizenzartikel-liste.jpg new file mode 100644 index 0000000..6ea1bab Binary files /dev/null and b/docs/ux/verwaltung/audit/26-lizenzartikel-liste.jpg differ diff --git a/docs/ux/verwaltung/audit/27-lizenzartikel-detail.jpg b/docs/ux/verwaltung/audit/27-lizenzartikel-detail.jpg new file mode 100644 index 0000000..ddc34bc Binary files /dev/null and b/docs/ux/verwaltung/audit/27-lizenzartikel-detail.jpg differ diff --git a/docs/ux/verwaltung/audit/28-pakete-leerzustand.jpg b/docs/ux/verwaltung/audit/28-pakete-leerzustand.jpg new file mode 100644 index 0000000..c3fcf12 Binary files /dev/null and b/docs/ux/verwaltung/audit/28-pakete-leerzustand.jpg differ diff --git a/docs/ux/verwaltung/audit/29-rechteprofile-liste.jpg b/docs/ux/verwaltung/audit/29-rechteprofile-liste.jpg new file mode 100644 index 0000000..11201f6 Binary files /dev/null and b/docs/ux/verwaltung/audit/29-rechteprofile-liste.jpg differ diff --git a/docs/ux/verwaltung/audit/30-rechteprofil-detail.jpg b/docs/ux/verwaltung/audit/30-rechteprofil-detail.jpg new file mode 100644 index 0000000..248a93b Binary files /dev/null and b/docs/ux/verwaltung/audit/30-rechteprofil-detail.jpg differ diff --git a/docs/ux/verwaltung/audit/31-angebote-liste.jpg b/docs/ux/verwaltung/audit/31-angebote-liste.jpg new file mode 100644 index 0000000..38d3ce3 Binary files /dev/null and b/docs/ux/verwaltung/audit/31-angebote-liste.jpg differ diff --git a/docs/ux/verwaltung/audit/32-angebot-detail.jpg b/docs/ux/verwaltung/audit/32-angebot-detail.jpg new file mode 100644 index 0000000..e24097b Binary files /dev/null and b/docs/ux/verwaltung/audit/32-angebot-detail.jpg differ diff --git a/docs/ux/verwaltung/audit/33-saeulen-liste.jpg b/docs/ux/verwaltung/audit/33-saeulen-liste.jpg new file mode 100644 index 0000000..d6b3eea Binary files /dev/null and b/docs/ux/verwaltung/audit/33-saeulen-liste.jpg differ diff --git a/docs/ux/verwaltung/audit/34-saeule-bearbeiten.jpg b/docs/ux/verwaltung/audit/34-saeule-bearbeiten.jpg new file mode 100644 index 0000000..7e91726 Binary files /dev/null and b/docs/ux/verwaltung/audit/34-saeule-bearbeiten.jpg differ diff --git a/docs/ux/verwaltung/audit/35-navigation-liste.jpg b/docs/ux/verwaltung/audit/35-navigation-liste.jpg new file mode 100644 index 0000000..c6f00ba Binary files /dev/null and b/docs/ux/verwaltung/audit/35-navigation-liste.jpg differ diff --git a/docs/ux/verwaltung/audit/36-navigation-dialog.jpg b/docs/ux/verwaltung/audit/36-navigation-dialog.jpg new file mode 100644 index 0000000..2e49d07 Binary files /dev/null and b/docs/ux/verwaltung/audit/36-navigation-dialog.jpg differ diff --git a/docs/ux/verwaltung/audit/37-materialpicker-fokus.jpg b/docs/ux/verwaltung/audit/37-materialpicker-fokus.jpg new file mode 100644 index 0000000..f0abe61 Binary files /dev/null and b/docs/ux/verwaltung/audit/37-materialpicker-fokus.jpg differ diff --git a/docs/ux/verwaltung/audit/37-materialpicker-fokus.txt b/docs/ux/verwaltung/audit/37-materialpicker-fokus.txt new file mode 100644 index 0000000..86ae9c8 --- /dev/null +++ b/docs/ux/verwaltung/audit/37-materialpicker-fokus.txt @@ -0,0 +1,305 @@ +Browser tab: 2, Title: "UX-Pilot Entwurf bearbeiten - Verwaltung", URL: "http://192.168.2.144:3011/verwaltung/uebungen/12". +1 AXWebArea UX-Pilot Entwurf bearbeiten - Verwaltung, URL: 192.168.2.144:3011/verwaltung/uebungen/12 + 2 link Description: Zum Inhalt springen, Value: 192.168.2.144:3011/verwaltung/uebungen/12#fi-main-content + 3 container Menüleiste + 4 link Description: Verwaltung, Value: 192.168.2.144:3011/verwaltung + 5 container + 6 text Globale Suche + 7 search text field (settable) Globale Suche, ID: global-search-N9xNn7SOGGrE0xTaEfvl-input + 8 text Press Down arrow to browse results. Use Up and Down arrows to move between results, and Tab to reach result actions. Press Escape to close results. + 9 pop up button (collapsed) Description: Benutzermenü, ID: fi-dropdown-trigger-bl8ala0j, Secondary Actions: Expand + 10 image Avatar von chatgpt + 11 container Seitennavigation + 12 content list + 13 content list + 14 link Description: Dashboard, Value: 192.168.2.144:3011/verwaltung + 15 link Description: Navigation, Value: 192.168.2.144:3011/verwaltung/navigation-items + 16 link Description: Seiten, Value: 192.168.2.144:3011/verwaltung/pages + 17 link Description: Benutzer, Value: 192.168.2.144:3011/verwaltung/users + 18 container + 19 text Inhalte + 20 button (expanded) Description: Inhalte, Secondary Actions: Collapse + 21 content list fi-sidebar-group-items-inhalte-032890e8 + 22 link Description: Arbeitsplatz, Value: 192.168.2.144:3011/verwaltung/arbeitsplatz + 23 link Description: Medien, Value: 192.168.2.144:3011/verwaltung/content-elements + 24 link Description: Fachliche Kombinationen, Value: 192.168.2.144:3011/verwaltung/kombinationen + 25 link Description: Module, Value: 192.168.2.144:3011/verwaltung/uebungen + 26 link Description: Programme, Value: 192.168.2.144:3011/verwaltung/kurse + 27 link Description: Fachliche Säulen, Value: 192.168.2.144:3011/verwaltung/saeulen + 28 container + 29 text Katalog + 30 button (expanded) Description: Katalog, Secondary Actions: Collapse + 31 content list fi-sidebar-group-items-katalog-a961db1b + 32 link Description: Lizenzartikel, Value: 192.168.2.144:3011/verwaltung/license-articles + 33 link Description: Pakete, Value: 192.168.2.144:3011/verwaltung/bundles + 34 link Description: Rechteprofile, Value: 192.168.2.144:3011/verwaltung/rights-profiles + 35 link Description: Angebote, Value: 192.168.2.144:3011/verwaltung/offers + 36 container fi-main-content + 37 container + 38 container Breadcrumb + 39 content list + 40 link Description: Module, Value: 192.168.2.144:3011/verwaltung/uebungen + 41 link Description: UX-Pilot Entwurf, Value: 192.168.2.144:3011/verwaltung/uebungen/12 + 42 text Bearbeiten + 43 heading UX-Pilot Entwurf, Value: 1 + 44 text UX-Pilot Entwurf + 45 text Ein Modul mit Lernziel, Zeit, Material und geordneten Bestandteilen. Dieselben Medien können in mehreren Modulen stecken. Der Entwurf ist gespeichert. Fassung 1 bleibt unverändert. Sie ist nicht in der Mitgliederbibliothek. + 46 link Description: Vorschau für Trainer, Value: 192.168.2.144:3011/redaktion/aufbau/12/entwurf + 47 button In Mitgliederbibliothek anzeigen + 48 link Description: Zum Arbeitsplatz, Value: 192.168.2.144:3011/verwaltung/arbeitsplatz + 49 text Der Entwurf ist gespeichert. Fassung 1 bleibt unverändert. Sie ist nicht in der Mitgliederbibliothek. + 50 button Entwurf speichern + 51 link Description: Vorschau für Trainer, Value: 192.168.2.144:3011/redaktion/aufbau/12/entwurf + 52 button Fassung freigeben + 53 button Entwurf verwerfen + 54 container Aufbau + 55 heading Aufbau, Value: 2 + 56 text Aufbau + 57 button Bestandteil hinzufügen + 58 button Text erstellen + 59 button Medium anlegen + 60 text Der Aufbau ist die Arbeitsfläche. Das Stiftsymbol bearbeitet den Bestandteil, das Auge öffnet eine Vorschau. Ziehen ändert die Reihenfolge, Nach oben und Nach unten tun dasselbe ohne Ziehen. + 61 content list + 62 container + 63 button Kein Titelbild Text UX-Pilot Hinweis Unterlage · Fassung 1 + 64 text Kein Titelbild + 65 text Text + 66 text UX-Pilot Hinweis + 67 text Unterlage · Fassung 1 + 68 link Description: Vorschau: UX-Pilot Hinweis, Value: 192.168.2.144:3011/redaktion/inhalt/8 + 69 button Bearbeiten: UX-Pilot Hinweis + 70 button (disabled) UX-Pilot Hinweis nach oben + 71 button UX-Pilot Hinweis nach unten + 72 container + 73 button Unterrichtsfilm Lara im Park Film · Fassung 1 + 74 text Unterrichtsfilm + 75 text Lara im Park + 76 text Film · Fassung 1 + 77 link Description: Vorschau: Lara im Park, Value: 192.168.2.144:3011/redaktion/inhalt/3 + 78 button Bearbeiten: Lara im Park + 79 button Lara im Park nach oben + 80 button Lara im Park nach unten + 81 container + 82 button Kein Titelbild Text Trainerunterlage Abstand Hinweisblatt · Fassung 1 + 83 text Kein Titelbild + 84 text Text + 85 text Trainerunterlage Abstand + 86 text Hinweisblatt · Fassung 1 + 87 link Description: Vorschau: Trainerunterlage Abstand, Value: 192.168.2.144:3011/redaktion/inhalt/5 + 88 button Bearbeiten: Trainerunterlage Abstand + 89 button Trainerunterlage Abstand nach oben + 90 button Trainerunterlage Abstand nach unten + 91 container + 92 button Kein Titelbild Text Noch ein weiterer Test eines Textes Unterlage · Entwurf + 93 text Kein Titelbild + 94 text Text + 95 text Noch ein weiterer Test eines Textes + 96 text Unterlage · Entwurf + 97 link Description: Vorschau: Noch ein weiterer Test eines Textes, Value: 192.168.2.144:3011/redaktion/inhalt/10 + 98 button Bearbeiten: Noch ein weiterer Test eines Textes + 99 button Noch ein weiterer Test eines Textes nach oben + 100 button Noch ein weiterer Test eines Textes nach unten + 101 container + 102 button Film Felix beim Onkel Film · Entwurf + 103 text Film + 104 text Felix beim Onkel + 105 text Film · Entwurf + 106 link Description: Vorschau: Felix beim Onkel, Value: 192.168.2.144:3011/redaktion/inhalt/11 + 107 button Bearbeiten: Felix beim Onkel + 108 button Felix beim Onkel nach oben + 109 button Felix beim Onkel nach unten + 110 container + 111 button Film Felix und der Autofahrer Film · Entwurf + 112 text Film + 113 text Felix und der Autofahrer + 114 text Film · Entwurf + 115 link Description: Vorschau: Felix und der Autofahrer, Value: 192.168.2.144:3011/redaktion/inhalt/12 + 116 button Bearbeiten: Felix und der Autofahrer + 117 button Felix und der Autofahrer nach oben + 118 button (disabled) Felix und der Autofahrer nach unten + 119 container Überblick + 120 text MODUL + 121 heading UX-Pilot Entwurf, Value: 2 + 122 text UX-Pilot Entwurf + 123 container Status + 124 text Fassung 1 Entwurf offen Nicht in der Mitgliederbibliothek Nicht auf der Website Kein aktives Angebot + 125 text KATALOGVORSCHAU + 126 image Lara und Felix im Park + 127 text Ein kurzer Kartentext für die UX-Prüfung. Er soll auf der Karte sichtbar bleiben, auch wenn er etwas länger wird und mehr als eine Zeile braucht. + 128 text Lernziel: Nur Entwurf danach + 129 container + 130 text 12 Minuten · Nur das Testblatt. + 131 text Titelbild aus einem vorhandenen Bild. + 132 button Modul bearbeiten + 133 heading Präsentationsmedien, Value: 3 + 134 text Präsentationsmedien + 135 text Zugeordnet wird ein Medium aus dem Bestand. Die Rolle gilt nur für diese Zuordnung. Sie gibt das Medium nicht frei und nimmt es nicht in den Lehrinhalt auf. + 136 text Noch ohne Angabe: Anzeigename, Teaser. + 137 text Noch kein Präsentationsmedium. Das Vorschaubild der Bibliothek bleibt davon unabhängig. + 138 container + 139 text Rolle + 140 pop up button (collapsed, settable) Rolle, Value: Titelbild / Standard-Thumbnail, Secondary Actions: Expand + 141 menu + 142 (selected) Titelbild / Standard-Thumbnail + 143 Alternatives Titelbild + 144 Hero-Bild + 145 Hoverbild + 146 Trailer / Teaserfilm + 147 Vorschauclip + 148 Audiovorschau + 149 Interview + 150 Galerieelement + 151 text Die tatsächliche Verwendung steht getrennt davon und wird nicht als Verwendungszweck gespeichert. + 152 button Medium aus dem Bestand auswählen + 153 heading Freigegebene Fassungen, Value: 3 + 154 text Freigegebene Fassungen + 155 content list + 156 container + 157 text Fassung 1, nicht in der Mitgliederbibliothek + 158 text Letzter freigegebener Stand + 159 button Als Vorlage laden + 160 link Description: Vorschau, Value: 192.168.2.144:3011/redaktion/aufbau/12/15 + 161 text In der Mitgliederbibliothek ist noch keine Fassung sichtbar. „In Mitgliederbibliothek anzeigen“ wählt die letzte freigegebene Fassung. Das veröffentlicht weder die Website noch ein Angebot. Es gibt einen gespeicherten Entwurf neben der freigegebenen Fassung. + 162 button (collapsed) Was Speichern und Freigeben bedeuten, Secondary Actions: Expand + 163 text Was Speichern und Freigeben bedeuten + 164 container Material auswählen + 165 container + 166 heading Material auswählen, Value: 2, ID: picker-titel + 167 text Material auswählen + 168 button Schließen + 169 text Suche + 170 search text field (settable) Suche, ID: picker-suche + 171 container Inhaltsart + 172 checkbox Alle, Value: 1 + 173 checkbox Filme, Value: 0 + 174 checkbox Bilder, Value: 0 + 175 checkbox Dokumente, Value: 0 + 176 checkbox Texte, Value: 0 + 177 checkbox Module, Value: 0 + 178 container Darstellung + 179 checkbox Kacheln, Value: 1 + 180 checkbox Liste, Value: 0 + 181 text Entwürfe bleiben sichtbar. So kann ein Modul sie weiterhin gemeinsam mit dem Aufbau freigeben. Eine nicht passende Art filterst du hier, ohne die übrigen Medien zu verstecken. Fachliche Einordnung + 182 pop up button (collapsed, settable) Fachliche Einordnung, Value: Alle Einordnungen, ID: picker-dimension, Secondary Actions: Expand + 183 menu + 184 (selected) Alle Einordnungen + 185 container Altersbereich und Zielgruppe + 186 Kinder + 187 Jugendliche + 188 Erwachsene + 189 Eltern + 190 Fachkräfte + 191 container Einsatzbereich + 192 Kita + 193 Schule + 194 Familie + 195 Fortbildung + 196 container Fachliche Säule + 197 Meine Grenzen – Ich darf Nein sagen + 198 Sicher handeln im Alltag + 199 Geheimnisse, Vertrauen und Hilfe holen + 200 Freundschaft, Selbstbehauptung und Zivilcourage + 201 Streit, Bedrängung und Konflikte bewältigen + 202 container Redaktioneller Verwendungszweck + 203 Training / Lehrinhalt + 204 Trainer- und Begleitmaterial + 205 Website / Marketing + 206 Markenpräsentation + 207 Interne redaktionelle Ressource + 208 content list + 209 checkbox Value: 0, Film Felix und der Autofahrer Hier kommt die Beschreibung zum Film hin Aktueller Stand · Entwurf Nur in der Redaktionsvorschau sichtbar: Das Medium hat noch keine bereitgestellte Fassung. + 210 text Film + 211 text Felix und der Autofahrer + 212 text Hier kommt die Beschreibung zum Film hin + 213 text Aktueller Stand · Entwurf + 214 text Nur in der Redaktionsvorschau sichtbar: Das Medium hat noch keine bereitgestellte Fassung. + 215 checkbox Value: 0, Film Felix beim Onkel Aktueller Stand · Entwurf Nur in der Redaktionsvorschau sichtbar: Das Medium hat noch keine bereitgestellte Fassung. + 216 text Film + 217 text Felix beim Onkel + 218 text Aktueller Stand · Entwurf + 219 text Nur in der Redaktionsvorschau sichtbar: Das Medium hat noch keine bereitgestellte Fassung. + 220 checkbox Value: 0, Kein Titelbild Text Noch ein weiterer Test eines Textes Aktueller Stand · Entwurf Nur in der Redaktionsvorschau sichtbar: Das Medium hat noch keine bereitgestellte Fassung. + 221 text Kein Titelbild + 222 text Text + 223 text Noch ein weiterer Test eines Textes + 224 text Aktueller Stand · Entwurf + 225 text Nur in der Redaktionsvorschau sichtbar: Das Medium hat noch keine bereitgestellte Fassung. + 226 checkbox Value: 0, Kein Titelbild Text Nur ein allgemeiner Hinweis Aktueller Stand · Fassung 1 Nur in der Redaktionsvorschau sichtbar: Das Medium gehört zu keinem öffentlich gezeigten Programm. Medien haben noch keine eigene öffentliche Freigabe (öffentliches Profil, ADR-29). + 227 text Kein Titelbild + 228 text Text + 229 text Nur ein allgemeiner Hinweis + 230 text Aktueller Stand · Fassung 1 + 231 text Nur in der Redaktionsvorschau sichtbar: Das Medium gehört zu keinem öffentlich gezeigten Programm. Medien haben noch keine eigene öffentliche Freigabe (öffentliches Profil, ADR-29). + 232 checkbox Value: 0, Kein Titelbild Text UX-Pilot Hinweis Aktueller Stand · Fassung 1 Nur in der Redaktionsvorschau sichtbar: Das Medium gehört zu keinem öffentlich gezeigten Programm. Medien haben noch keine eigene öffentliche Freigabe (öffentliches Profil, ADR-29). + 233 text Kein Titelbild + 234 text Text + 235 text UX-Pilot Hinweis + 236 text Aktueller Stand · Fassung 1 + 237 text Nur in der Redaktionsvorschau sichtbar: Das Medium gehört zu keinem öffentlich gezeigten Programm. Medien haben noch keine eigene öffentliche Freigabe (öffentliches Profil, ADR-29). + 238 checkbox Value: 0, Kein Titelbild Text Trainerunterlage Abstand Aktueller Stand · Fassung 1 Öffentlich nur als Teil der Programmseite „Programm Abstand“. Die Mediendatei wird dabei nicht ausgeliefert. + 239 text Kein Titelbild + 240 text Text + 241 text Trainerunterlage Abstand + 242 text Aktueller Stand · Fassung 1 + 243 text Öffentlich nur als Teil der Programmseite „Programm Abstand“. Die Mediendatei wird dabei nicht ausgeliefert. + 244 checkbox Value: 0, Unterrichtsfilm Lara im Park Ein Unterrichtsfilm über Nähe, Unwohlsein und die eigene Grenze. Aktueller Stand · Fassung 1 Öffentlich nur als Teil der Programmseite „Programm Abstand“. Die Mediendatei wird dabei nicht ausgeliefert. + 245 text Unterrichtsfilm + 246 text Lara im Park + 247 text Ein Unterrichtsfilm über Nähe, Unwohlsein und die eigene Grenze. + 248 text Aktueller Stand · Fassung 1 + 249 text Öffentlich nur als Teil der Programmseite „Programm Abstand“. Die Mediendatei wird dabei nicht ausgeliefert. + 250 checkbox Kein Titelbild Programm Freigabe Programm Aktueller Stand · Fassung 1, Value: 0 + 251 text Kein Titelbild + 252 text Programm + 253 text Freigabe Programm + 254 text Aktueller Stand · Fassung 1 + 255 checkbox Kein Titelbild Modul Untermodul Freigabe Aktueller Stand · Fassung 1, Value: 0 + 256 text Kein Titelbild + 257 text Modul + 258 text Untermodul Freigabe + 259 text Aktueller Stand · Fassung 1 + 260 checkbox Kein Titelbild Modul Freigabe mit Anleitung Aktueller Stand · Fassung 1, Value: 0 + 261 text Kein Titelbild + 262 text Modul + 263 text Freigabe mit Anleitung + 264 text Aktueller Stand · Fassung 1 + 265 checkbox Kein Titelbild Modul Freigabe mit Lara Aktueller Stand · Fassung 1, Value: 0 + 266 text Kein Titelbild + 267 text Modul + 268 text Freigabe mit Lara + 269 text Aktueller Stand · Fassung 1 + 270 checkbox Kein Titelbild Programm Programm Abstand Aktueller Stand · Fassung 2, Value: 0 + 271 text Kein Titelbild + 272 text Programm + 273 text Programm Abstand + 274 text Aktueller Stand · Fassung 2 + 275 checkbox Value: 0, Modul Die eigene Grenzen erkennen, aufs Bauchgefühl hören und entsprechend handeln Aktueller Stand · Fassung 1 + 276 text Modul + 277 text Die eigene Grenzen erkennen, aufs Bauchgefühl hören und entsprechend handeln + 278 text Aktueller Stand · Fassung 1 + 279 checkbox Kein Titelbild Programm UX-Prüfung, nur Test Aktueller Stand · Fassung 3, Value: 0 + 280 text Kein Titelbild + 281 text Programm + 282 text UX-Prüfung, nur Test + 283 text Aktueller Stand · Fassung 3 + 284 checkbox Kein Titelbild Modul UX-Prüfung Modul Aktueller Stand · Fassung 1, Value: 0 + 285 text Kein Titelbild + 286 text Modul + 287 text UX-Prüfung Modul + 288 text Aktueller Stand · Fassung 1 + 289 checkbox Kein Titelbild Modul Modul Hilfe Aktueller Stand · Fassung 1, Value: 0 + 290 text Kein Titelbild + 291 text Modul + 292 text Modul Hilfe + 293 text Aktueller Stand · Fassung 1 + 294 checkbox Kein Titelbild Modul Modul Abstand Aktueller Stand · Fassung 1, Value: 0 + 295 text Kein Titelbild + 296 text Modul + 297 text Modul Abstand + 298 text Aktueller Stand · Fassung 1 + 299 container Ausgewählter Inhalt + 300 text Wähle einen Eintrag, sieh ihn dir an und übernimm ihn in den Entwurf. + 301 button Neuen Text erstellen + 302 button Medium anlegen + +The focused UI element is 58 button Text erstellen \ No newline at end of file diff --git a/docs/ux/verwaltung/audit/38-materialpicker-auswahl.jpg b/docs/ux/verwaltung/audit/38-materialpicker-auswahl.jpg new file mode 100644 index 0000000..bcb97e4 Binary files /dev/null and b/docs/ux/verwaltung/audit/38-materialpicker-auswahl.jpg differ diff --git a/docs/ux/verwaltung/audit/39-bestandteil-bearbeiten.jpg b/docs/ux/verwaltung/audit/39-bestandteil-bearbeiten.jpg new file mode 100644 index 0000000..0240658 Binary files /dev/null and b/docs/ux/verwaltung/audit/39-bestandteil-bearbeiten.jpg differ diff --git a/docs/ux/verwaltung/audit/40-trainervorschau-entwurf.jpg b/docs/ux/verwaltung/audit/40-trainervorschau-entwurf.jpg new file mode 100644 index 0000000..185f45c Binary files /dev/null and b/docs/ux/verwaltung/audit/40-trainervorschau-entwurf.jpg differ diff --git a/docs/ux/verwaltung/audit/41-modul-entwurfsbestandteile.jpg b/docs/ux/verwaltung/audit/41-modul-entwurfsbestandteile.jpg new file mode 100644 index 0000000..3f197eb Binary files /dev/null and b/docs/ux/verwaltung/audit/41-modul-entwurfsbestandteile.jpg differ diff --git a/docs/ux/verwaltung/audit/42-medien-anlegen-ohne-reaktion.jpg b/docs/ux/verwaltung/audit/42-medien-anlegen-ohne-reaktion.jpg new file mode 100644 index 0000000..39f4c8c Binary files /dev/null and b/docs/ux/verwaltung/audit/42-medien-anlegen-ohne-reaktion.jpg differ diff --git a/docs/ux/verwaltung/audit/43-medium-separater-editor.jpg b/docs/ux/verwaltung/audit/43-medium-separater-editor.jpg new file mode 100644 index 0000000..b24aac0 Binary files /dev/null and b/docs/ux/verwaltung/audit/43-medium-separater-editor.jpg differ diff --git a/docs/ux/verwaltung/audit/44-globale-suche.jpg b/docs/ux/verwaltung/audit/44-globale-suche.jpg new file mode 100644 index 0000000..ac5a291 Binary files /dev/null and b/docs/ux/verwaltung/audit/44-globale-suche.jpg differ diff --git a/docs/ux/verwaltung/audit/45-benutzer-liste.jpg b/docs/ux/verwaltung/audit/45-benutzer-liste.jpg new file mode 100644 index 0000000..aa5852c Binary files /dev/null and b/docs/ux/verwaltung/audit/45-benutzer-liste.jpg differ diff --git a/docs/ux/verwaltung/audit/46-testmitglied-bearbeiten.jpg b/docs/ux/verwaltung/audit/46-testmitglied-bearbeiten.jpg new file mode 100644 index 0000000..c49e47f Binary files /dev/null and b/docs/ux/verwaltung/audit/46-testmitglied-bearbeiten.jpg differ diff --git a/docs/ux/verwaltung/audit/Belege.html b/docs/ux/verwaltung/audit/Belege.html new file mode 100644 index 0000000..4c3718b --- /dev/null +++ b/docs/ux/verwaltung/audit/Belege.html @@ -0,0 +1,143 @@ +Belege – Lara & Felix

Lara & Felix – Bildschirmbelege zum UX-Audit

+

Aufnahmen vom 19.11.2026 aus der tatsächlich bedienten Testinstanz. B01–B46 sind Bildschirmzustände in Aufnahmereihenfolge; die übergeordneten Arbeitswege S01–S14 stehen im Auditbericht.

+

Die Bilddateien wurden bei der Erfassung gespeichert und geöffnet. Notizen beziehen sich auf den dargestellten Zustand und die im Bericht beschriebenen Interaktionen. Schreibende Abschlüsse wurden nicht ausgeführt.

+

Zum Auditbericht

+

B01 – Dashboard

+

Bewertung: Schwach. Nur Willkommen und Abmelden; gemeinsamer Navigationsrahmen vorhanden, keine Aufgabenübersicht.

+

B01: Dashboard

+

B02 – Arbeitsplatz

+

Bewertung: Brauchbare Grundlage. Visuelle Module und Programme mit Status; große Karten und mehrere Filterebenen.

+

B02: Arbeitsplatz

+

B03 – Modulaufbau

+

Bewertung: Verbesserungsbedürftig. Aufbau und Fassungen sichtbar; doppelte Aktionen und hoher Platzbedarf.

+

B03: Modulaufbau

+

B04 – Materialpicker

+

Bewertung: Verbesserungsbedürftig. Karten, Suche und Details vorhanden; lange Hinweise und geringe Übersicht über viele Einträge.

+

B04: Materialpicker

+

B05 – Modulbeschreibung

+

Bewertung: Verbesserungsbedürftig. Thematische Tabs vorhanden; langer Beschreibungstab mit Abschluss unterhalb des ersten Ausschnitts.

+

B05: Modulbeschreibung

+

B06 – Moduleinordnung

+

Bewertung: Verbesserungsbedürftig. Mehrfachzuordnung vorhanden; 19 Werte vertikal über lange Scrollstrecke.

+

B06: Moduleinordnung

+

B07 – Medienübersicht

+

Bewertung: Verbesserungsbedürftig. Bilder und Status vorhanden; zehn Filter plus Erklärungstext vor den Ergebnissen.

+

B07: Medienübersicht

+

B08 – Medienliste

+

Bewertung: Verbesserungsbedürftig. Ansichtswechsel funktioniert; großer Filterkopf bleibt bestehen.

+

B08: Medienliste

+

B09 – Mediensuche

+

Bewertung: Funktioniert im geprüften Fall. Eingabe Lara reduziert auf zwei Medien und bietet Filter zurücksetzen.

+

B09: Mediensuche

+

B10 – Medienbeschreibung

+

Bewertung: Uneinheitlich. Ansehen enthält bearbeitbare Felder und Live-Vorschau; zusätzlicher separater Editor vorhanden.

+

B10: Medienbeschreibung

+

B11 – Medienfassungen

+

Bewertung: Brauchbare Grundlage. Konkrete Fassung, Filmvorschau und Deaktivieren sichtbar; kein Zustandswechsel ausgeführt.

+

B11: Medienfassungen

+

B12 – Medienverwendung

+

Bewertung: Brauchbare Grundlage. Verknüpfte Verwendungsstellen mit Fassungen; Zähleinheit nicht sofort nachvollziehbar.

+

B12: Medienverwendung

+

B13 – Präsentationspicker am Medium

+

Bewertung: Verbesserungsbedürftig. Bestand durchsuchbar; Bildauswahl erfolgt in textbasierter Radioliste ohne Vergleichsbilder.

+

B13: Präsentationspicker am Medium

+

B14 – CMS-Seitenliste

+

Bewertung: Brauchbar. Suche, Datum und veröffentlichte Seiten erkennbar; nicht veröffentlichte Zeilen ohne ausdrücklichen Statustext.

+

B14: CMS-Seitenliste

+

B15 – CMS-Seiteneditor

+

Bewertung: Verbesserungsbedürftig. Visuelles Raster und echte Widgets; tiefe Rahmenverschachtelung und lange Scrollstrecke.

+

B15: CMS-Seiteneditor

+

B16 – CMS-Widgetdialog

+

Bewertung: Brauchbare Grundlage. Inhalt, Medien und Darstellung getrennt; eigene Vorschau weiter unten im langen Dialog.

+

B16: CMS-Widgetdialog

+

B17 – CMS-Bildpicker

+

Bewertung: Gute Grundlage. Suchfähige Auswahl mit Thumbnails und Website-Freigabe; Kontext hinter Dropdown teilweise verdeckt.

+

B17: CMS-Bildpicker

+

B18 – CMS-Gerätevorschau

+

Bewertung: Gute Grundlage. Revision und unveröffentlichter Zustand klar, Gerätegrößen wählbar; Revision unverändert betrachtet.

+

B18: CMS-Gerätevorschau

+

B19 – CMS-Struktur und Revisionen

+

Bewertung: Gute Grundlage. Kompakte Struktur nach Einklappen, Revision mit Autor und Zeit; nur eine Revision vorhanden.

+

B19: CMS-Struktur und Revisionen

+

B20 – Kombinationen leer

+

Bewertung: Nicht ausreichend prüfbar. Leerzustand vorhanden; laut Betreiber bislang nicht sinnvoll konfigurierbar.

+

B20: Kombinationen leer

+

B21 – Kombination anlegen

+

Bewertung: Nur Einstieg geprüft. Einfacher Dialog mit Bezeichnung; Absenden nicht ausgeführt, Bestandsbearbeitung ungeprüft.

+

B21: Kombination anlegen

+

B22 – Modultabelle

+

Bewertung: Verbesserungsbedürftig. Acht Einträge sichtbar; rechte Spalte teilweise abgeschnitten, horizontales Scrollen bei drei Spalten.

+

B22: Modultabelle

+

B23 – Programmtabelle

+

Bewertung: Brauchbare Grundlage. Jüngste und angezeigte Fassung im Status unterscheidbar; drei Einträge im Testbestand.

+

B23: Programmtabelle

+

B24 – Programmaufbau

+

Bewertung: Verbesserungsbedürftig. Vier Bestandteile und Statusübersicht; mehrere Aktionsleisten und große Zeilen.

+

B24: Programmaufbau

+

B25 – Programmfassungsstatus

+

Bewertung: Kritisch. Fassung 1 als in der Bibliothek markiert, direkt darunter gegenteiliger Hinweis.

+

B25: Programmfassungsstatus

+

B26 – Lizenzartikelliste

+

Bewertung: Brauchbare Grundlage. Kennung, Produktlinie und Stand sichtbar; nur ein Datensatz, kein großer Bestand geprüft.

+

B26: Lizenzartikelliste

+

B27 – Lizenzartikeldetail

+

Bewertung: Verbesserungsbedürftig. Stand und Angebot vorhanden; Eingabefelder schwer erkennbar, Beziehungen weitgehend Text.

+

B27: Lizenzartikeldetail

+

B28 – Pakete leer

+

Bewertung: Nicht ausreichend prüfbar. Kein Bestandsobjekt; laut Betreiber bisherige Konfiguration nicht sinnvoll nutzbar.

+

B28: Pakete leer

+

B29 – Rechteprofile

+

Bewertung: Brauchbare Grundlage. Name und Zweck in Übersicht; nur ein Testobjekt vorhanden.

+

B29: Rechteprofile

+

B30 – Rechteprofildetail

+

Bewertung: Verbesserungsbedürftig. Zweck und Aktionen sichtbar; doppelte Titelaktion und technische Ausgabeklassennamen.

+

B30: Rechteprofildetail

+

B31 – Angebotsliste

+

Bewertung: Verbesserungsbedürftig. Aktivstatus sichtbar, steht unter der Spalte Fassungen; nur ein Testobjekt.

+

B31: Angebotsliste

+

B32 – Angebotsdetail

+

Bewertung: Verbesserungsbedürftig. Positionen und aufgelöste Rechte vorhanden; aktivieren trotz aktivem Stand, Beziehungen nur Text.

+

B32: Angebotsdetail

+

B33 – Säulenübersicht

+

Bewertung: Brauchbare Grundlage. Website-Status und Medienzahl sichtbar; fünf Werte vorhanden.

+

B33: Säulenübersicht

+

B34 – Säule bearbeiten

+

Bewertung: Brauchbar mit Inkonsistenzen. Kurzes Formular; Reihenfolge als Zahl, Veröffentlichung als Schalter, keine Vorschau im geprüften Formular.

+

B34: Säule bearbeiten

+

B35 – Website-Navigation

+

Bewertung: Brauchbare Grundlage. Gruppierte Ziele, Suche und Reihenfolge-Modus; Veröffentlichung anders geführt als CMS-Seiten.

+

B35: Website-Navigation

+

B36 – Navigation bearbeiten

+

Bewertung: Brauchbare Grundlage. Interne Seite statt freier Adresse wählbar; Reihenfolge und Sichtbarkeit im selben Dialog.

+

B36: Navigation bearbeiten

+

B37 – Materialpicker mit Fokusproblem

+

Bewertung: Kritisch. Tab führt nach Dialogöffnung zum Hintergrundbutton Text erstellen; zusätzlicher Fokus-Textbeleg gespeichert.

+

B37: Materialpicker mit Fokusproblem

+

B38 – Ausgewähltes Material

+

Bewertung: Brauchbare Grundlage. Fassung und Übernehmen sichtbar; Auswahl allein bestätigt noch keine Übernahme.

+

B38: Ausgewähltes Material

+

B39 – Bestandteil bearbeiten

+

Bewertung: Brauchbare Grundlage. Kontextbeschreibung und lokale Rolle klar erklärt; sechs Folgeaktionen konkurrieren im Dialog.

+

B39: Bestandteil bearbeiten

+

B40 – Trainervorschau Entwurf

+

Bewertung: Klärungsbedürftig. Drei Bestandteile in vollständiger gespeicherter Entwurfsvorschau; sechs auf der Arbeitsfläche, keine Erklärung der Differenz.

+

B40: Trainervorschau Entwurf

+

B41 – Entwurfsbestandteile im Modul

+

Bewertung: Klärungsbedürftig. Drei zusätzliche Entwurfsbestandteile sichtbar; beim verglichenen Vorschauweg nicht enthalten.

+

B41: Entwurfsbestandteile im Modul

+

B42 – Medienanlage ohne Reaktion

+

Bewertung: Blockiert im geprüften Weg. Medium anlegen ohne Dialog oder Erklärung, auch nach frischem Seitenaufruf; Ursache nicht nachgewiesen.

+

B42: Medienanlage ohne Reaktion

+

B43 – Separater Medieneditor

+

Bewertung: Uneinheitlich. Zweiter Bearbeitungsweg mit anderen Feldbezeichnungen und langem Formular.

+

B43: Separater Medieneditor

+

B44 – Globale Suche

+

Bewertung: Funktioniert im geprüften Fall. Lara liefert drei gruppierte Treffer aus Medien und Modulen; keine Vollständigkeitsprüfung.

+

B44: Globale Suche

+

B45 – Benutzerliste

+

Bewertung: Verbesserungsbedürftig. Sechs Konten, Status und Personalrollen; breite Rollenspalte erzeugt horizontales Scrollen.

+

B45: Benutzerliste

+

B46 – Testmitglied bearbeiten

+

Bewertung: Basis vorhanden. Stammdaten, Status, Personalrollen und Berechtigung vergeben; kein umfassender Kunden- und Lizenzarbeitsplatz.

+

B46: Testmitglied bearbeiten

+
\ No newline at end of file diff --git a/docs/ux/verwaltung/audit/Belege.md b/docs/ux/verwaltung/audit/Belege.md new file mode 100644 index 0000000..4251262 --- /dev/null +++ b/docs/ux/verwaltung/audit/Belege.md @@ -0,0 +1,283 @@ +# Lara & Felix – Bildschirmbelege zum UX-Audit + +Aufnahmen vom 19.11.2026 aus der tatsächlich bedienten Testinstanz. B01–B46 sind Bildschirmzustände in Aufnahmereihenfolge; die übergeordneten Arbeitswege S01–S14 stehen im Auditbericht. + +Die Bilddateien wurden bei der Erfassung gespeichert und geöffnet. Notizen beziehen sich auf den dargestellten Zustand und die im Bericht beschriebenen Interaktionen. Schreibende Abschlüsse wurden nicht ausgeführt. + +[Zum Auditbericht](UX-Audit.md) + +## B01 – Dashboard + +**Bewertung:** Schwach. Nur Willkommen und Abmelden; gemeinsamer Navigationsrahmen vorhanden, keine Aufgabenübersicht. + +![B01: Dashboard](01-dashboard.jpg) + +## B02 – Arbeitsplatz + +**Bewertung:** Brauchbare Grundlage. Visuelle Module und Programme mit Status; große Karten und mehrere Filterebenen. + +![B02: Arbeitsplatz](02-arbeitsplatz.jpg) + +## B03 – Modulaufbau + +**Bewertung:** Verbesserungsbedürftig. Aufbau und Fassungen sichtbar; doppelte Aktionen und hoher Platzbedarf. + +![B03: Modulaufbau](03-modul-aufbau.jpg) + +## B04 – Materialpicker + +**Bewertung:** Verbesserungsbedürftig. Karten, Suche und Details vorhanden; lange Hinweise und geringe Übersicht über viele Einträge. + +![B04: Materialpicker](04-materialpicker.jpg) + +## B05 – Modulbeschreibung + +**Bewertung:** Verbesserungsbedürftig. Thematische Tabs vorhanden; langer Beschreibungstab mit Abschluss unterhalb des ersten Ausschnitts. + +![B05: Modulbeschreibung](05-modul-beschreibung.jpg) + +## B06 – Moduleinordnung + +**Bewertung:** Verbesserungsbedürftig. Mehrfachzuordnung vorhanden; 19 Werte vertikal über lange Scrollstrecke. + +![B06: Moduleinordnung](06-modul-einordnung.jpg) + +## B07 – Medienübersicht + +**Bewertung:** Verbesserungsbedürftig. Bilder und Status vorhanden; zehn Filter plus Erklärungstext vor den Ergebnissen. + +![B07: Medienübersicht](07-medien-uebersicht.jpg) + +## B08 – Medienliste + +**Bewertung:** Verbesserungsbedürftig. Ansichtswechsel funktioniert; großer Filterkopf bleibt bestehen. + +![B08: Medienliste](08-medien-liste.jpg) + +## B09 – Mediensuche + +**Bewertung:** Funktioniert im geprüften Fall. Eingabe Lara reduziert auf zwei Medien und bietet Filter zurücksetzen. + +![B09: Mediensuche](09-medien-suche.jpg) + +## B10 – Medienbeschreibung + +**Bewertung:** Uneinheitlich. Ansehen enthält bearbeitbare Felder und Live-Vorschau; zusätzlicher separater Editor vorhanden. + +![B10: Medienbeschreibung](10-medium-beschreibung.jpg) + +## B11 – Medienfassungen + +**Bewertung:** Brauchbare Grundlage. Konkrete Fassung, Filmvorschau und Deaktivieren sichtbar; kein Zustandswechsel ausgeführt. + +![B11: Medienfassungen](11-medium-fassungen.jpg) + +## B12 – Medienverwendung + +**Bewertung:** Brauchbare Grundlage. Verknüpfte Verwendungsstellen mit Fassungen; Zähleinheit nicht sofort nachvollziehbar. + +![B12: Medienverwendung](12-medium-verwendung.jpg) + +## B13 – Präsentationspicker am Medium + +**Bewertung:** Verbesserungsbedürftig. Bestand durchsuchbar; Bildauswahl erfolgt in textbasierter Radioliste ohne Vergleichsbilder. + +![B13: Präsentationspicker am Medium](13-medium-praesentationspicker.jpg) + +## B14 – CMS-Seitenliste + +**Bewertung:** Brauchbar. Suche, Datum und veröffentlichte Seiten erkennbar; nicht veröffentlichte Zeilen ohne ausdrücklichen Statustext. + +![B14: CMS-Seitenliste](14-cms-seitenliste.jpg) + +## B15 – CMS-Seiteneditor + +**Bewertung:** Verbesserungsbedürftig. Visuelles Raster und echte Widgets; tiefe Rahmenverschachtelung und lange Scrollstrecke. + +![B15: CMS-Seiteneditor](15-cms-editor.jpg) + +## B16 – CMS-Widgetdialog + +**Bewertung:** Brauchbare Grundlage. Inhalt, Medien und Darstellung getrennt; eigene Vorschau weiter unten im langen Dialog. + +![B16: CMS-Widgetdialog](16-cms-widgetdialog.jpg) + +## B17 – CMS-Bildpicker + +**Bewertung:** Gute Grundlage. Suchfähige Auswahl mit Thumbnails und Website-Freigabe; Kontext hinter Dropdown teilweise verdeckt. + +![B17: CMS-Bildpicker](17-cms-bildpicker.jpg) + +## B18 – CMS-Gerätevorschau + +**Bewertung:** Gute Grundlage. Revision und unveröffentlichter Zustand klar, Gerätegrößen wählbar; Revision unverändert betrachtet. + +![B18: CMS-Gerätevorschau](18-cms-geraetevorschau.jpg) + +## B19 – CMS-Struktur und Revisionen + +**Bewertung:** Gute Grundlage. Kompakte Struktur nach Einklappen, Revision mit Autor und Zeit; nur eine Revision vorhanden. + +![B19: CMS-Struktur und Revisionen](19-cms-struktur-revisionen.jpg) + +## B20 – Kombinationen leer + +**Bewertung:** Nicht ausreichend prüfbar. Leerzustand vorhanden; laut Betreiber bislang nicht sinnvoll konfigurierbar. + +![B20: Kombinationen leer](20-kombination-leerzustand.jpg) + +## B21 – Kombination anlegen + +**Bewertung:** Nur Einstieg geprüft. Einfacher Dialog mit Bezeichnung; Absenden nicht ausgeführt, Bestandsbearbeitung ungeprüft. + +![B21: Kombination anlegen](21-kombination-anlegen.jpg) + +## B22 – Modultabelle + +**Bewertung:** Verbesserungsbedürftig. Acht Einträge sichtbar; rechte Spalte teilweise abgeschnitten, horizontales Scrollen bei drei Spalten. + +![B22: Modultabelle](22-module-tabelle.jpg) + +## B23 – Programmtabelle + +**Bewertung:** Brauchbare Grundlage. Jüngste und angezeigte Fassung im Status unterscheidbar; drei Einträge im Testbestand. + +![B23: Programmtabelle](23-programme-tabelle.jpg) + +## B24 – Programmaufbau + +**Bewertung:** Verbesserungsbedürftig. Vier Bestandteile und Statusübersicht; mehrere Aktionsleisten und große Zeilen. + +![B24: Programmaufbau](24-programm-aufbau.jpg) + +## B25 – Programmfassungsstatus + +**Bewertung:** Kritisch. Fassung 1 als in der Bibliothek markiert, direkt darunter gegenteiliger Hinweis. + +![B25: Programmfassungsstatus](25-programm-fassungsstatus.jpg) + +## B26 – Lizenzartikelliste + +**Bewertung:** Brauchbare Grundlage. Kennung, Produktlinie und Stand sichtbar; nur ein Datensatz, kein großer Bestand geprüft. + +![B26: Lizenzartikelliste](26-lizenzartikel-liste.jpg) + +## B27 – Lizenzartikeldetail + +**Bewertung:** Verbesserungsbedürftig. Stand und Angebot vorhanden; Eingabefelder schwer erkennbar, Beziehungen weitgehend Text. + +![B27: Lizenzartikeldetail](27-lizenzartikel-detail.jpg) + +## B28 – Pakete leer + +**Bewertung:** Nicht ausreichend prüfbar. Kein Bestandsobjekt; laut Betreiber bisherige Konfiguration nicht sinnvoll nutzbar. + +![B28: Pakete leer](28-pakete-leerzustand.jpg) + +## B29 – Rechteprofile + +**Bewertung:** Brauchbare Grundlage. Name und Zweck in Übersicht; nur ein Testobjekt vorhanden. + +![B29: Rechteprofile](29-rechteprofile-liste.jpg) + +## B30 – Rechteprofildetail + +**Bewertung:** Verbesserungsbedürftig. Zweck und Aktionen sichtbar; doppelte Titelaktion und technische Ausgabeklassennamen. + +![B30: Rechteprofildetail](30-rechteprofil-detail.jpg) + +## B31 – Angebotsliste + +**Bewertung:** Verbesserungsbedürftig. Aktivstatus sichtbar, steht unter der Spalte Fassungen; nur ein Testobjekt. + +![B31: Angebotsliste](31-angebote-liste.jpg) + +## B32 – Angebotsdetail + +**Bewertung:** Verbesserungsbedürftig. Positionen und aufgelöste Rechte vorhanden; aktivieren trotz aktivem Stand, Beziehungen nur Text. + +![B32: Angebotsdetail](32-angebot-detail.jpg) + +## B33 – Säulenübersicht + +**Bewertung:** Brauchbare Grundlage. Website-Status und Medienzahl sichtbar; fünf Werte vorhanden. + +![B33: Säulenübersicht](33-saeulen-liste.jpg) + +## B34 – Säule bearbeiten + +**Bewertung:** Brauchbar mit Inkonsistenzen. Kurzes Formular; Reihenfolge als Zahl, Veröffentlichung als Schalter, keine Vorschau im geprüften Formular. + +![B34: Säule bearbeiten](34-saeule-bearbeiten.jpg) + +## B35 – Website-Navigation + +**Bewertung:** Brauchbare Grundlage. Gruppierte Ziele, Suche und Reihenfolge-Modus; Veröffentlichung anders geführt als CMS-Seiten. + +![B35: Website-Navigation](35-navigation-liste.jpg) + +## B36 – Navigation bearbeiten + +**Bewertung:** Brauchbare Grundlage. Interne Seite statt freier Adresse wählbar; Reihenfolge und Sichtbarkeit im selben Dialog. + +![B36: Navigation bearbeiten](36-navigation-dialog.jpg) + +## B37 – Materialpicker mit Fokusproblem + +**Bewertung:** Kritisch. Tab führt nach Dialogöffnung zum Hintergrundbutton Text erstellen; zusätzlicher Fokus-Textbeleg gespeichert. + +![B37: Materialpicker mit Fokusproblem](37-materialpicker-fokus.jpg) + +## B38 – Ausgewähltes Material + +**Bewertung:** Brauchbare Grundlage. Fassung und Übernehmen sichtbar; Auswahl allein bestätigt noch keine Übernahme. + +![B38: Ausgewähltes Material](38-materialpicker-auswahl.jpg) + +## B39 – Bestandteil bearbeiten + +**Bewertung:** Brauchbare Grundlage. Kontextbeschreibung und lokale Rolle klar erklärt; sechs Folgeaktionen konkurrieren im Dialog. + +![B39: Bestandteil bearbeiten](39-bestandteil-bearbeiten.jpg) + +## B40 – Trainervorschau Entwurf + +**Bewertung:** Klärungsbedürftig. Drei Bestandteile in vollständiger gespeicherter Entwurfsvorschau; sechs auf der Arbeitsfläche, keine Erklärung der Differenz. + +![B40: Trainervorschau Entwurf](40-trainervorschau-entwurf.jpg) + +## B41 – Entwurfsbestandteile im Modul + +**Bewertung:** Klärungsbedürftig. Drei zusätzliche Entwurfsbestandteile sichtbar; beim verglichenen Vorschauweg nicht enthalten. + +![B41: Entwurfsbestandteile im Modul](41-modul-entwurfsbestandteile.jpg) + +## B42 – Medienanlage ohne Reaktion + +**Bewertung:** Blockiert im geprüften Weg. Medium anlegen ohne Dialog oder Erklärung, auch nach frischem Seitenaufruf; Ursache nicht nachgewiesen. + +![B42: Medienanlage ohne Reaktion](42-medien-anlegen-ohne-reaktion.jpg) + +## B43 – Separater Medieneditor + +**Bewertung:** Uneinheitlich. Zweiter Bearbeitungsweg mit anderen Feldbezeichnungen und langem Formular. + +![B43: Separater Medieneditor](43-medium-separater-editor.jpg) + +## B44 – Globale Suche + +**Bewertung:** Funktioniert im geprüften Fall. Lara liefert drei gruppierte Treffer aus Medien und Modulen; keine Vollständigkeitsprüfung. + +![B44: Globale Suche](44-globale-suche.jpg) + +## B45 – Benutzerliste + +**Bewertung:** Verbesserungsbedürftig. Sechs Konten, Status und Personalrollen; breite Rollenspalte erzeugt horizontales Scrollen. + +![B45: Benutzerliste](45-benutzer-liste.jpg) + +## B46 – Testmitglied bearbeiten + +**Bewertung:** Basis vorhanden. Stammdaten, Status, Personalrollen und Berechtigung vergeben; kein umfassender Kunden- und Lizenzarbeitsplatz. + +![B46: Testmitglied bearbeiten](46-testmitglied-bearbeiten.jpg) diff --git a/docs/ux/verwaltung/audit/Belegregister.json b/docs/ux/verwaltung/audit/Belegregister.json new file mode 100644 index 0000000..59e8218 --- /dev/null +++ b/docs/ux/verwaltung/audit/Belegregister.json @@ -0,0 +1,466 @@ +{ + "date": "2026-11-19", + "source": "Aktuelle Testinstanz", + "screenshots": [ + { + "id": "B01", + "title": "Dashboard", + "health": "Schwach", + "note": "Nur Willkommen und Abmelden; gemeinsamer Navigationsrahmen vorhanden, keine Aufgabenübersicht.", + "file": "01-dashboard.jpg", + "width": 1440, + "height": 1000, + "sha256": "07bfd7b839bb49c307a5da1a85fe56f097f8554b58c9cbc4dc08f325099f2985" + }, + { + "id": "B02", + "title": "Arbeitsplatz", + "health": "Brauchbare Grundlage", + "note": "Visuelle Module und Programme mit Status; große Karten und mehrere Filterebenen.", + "file": "02-arbeitsplatz.jpg", + "width": 1425, + "height": 990, + "sha256": "895a1ea684e1874d53f14831eb45754c29d183aeac890c923c9a13eef857d7e6" + }, + { + "id": "B03", + "title": "Modulaufbau", + "health": "Verbesserungsbedürftig", + "note": "Aufbau und Fassungen sichtbar; doppelte Aktionen und hoher Platzbedarf.", + "file": "03-modul-aufbau.jpg", + "width": 1425, + "height": 990, + "sha256": "65886dfa82d34ef7daa42b66bb0a2251965825b9e398b046a78ea2ff865c2431" + }, + { + "id": "B04", + "title": "Materialpicker", + "health": "Verbesserungsbedürftig", + "note": "Karten, Suche und Details vorhanden; lange Hinweise und geringe Übersicht über viele Einträge.", + "file": "04-materialpicker.jpg", + "width": 1425, + "height": 990, + "sha256": "cf38d7d9ba25dd01768ac13d2c82e87bd46a0c192c125e47a62c97f1afb4fe6a" + }, + { + "id": "B05", + "title": "Modulbeschreibung", + "health": "Verbesserungsbedürftig", + "note": "Thematische Tabs vorhanden; langer Beschreibungstab mit Abschluss unterhalb des ersten Ausschnitts.", + "file": "05-modul-beschreibung.jpg", + "width": 1425, + "height": 990, + "sha256": "8164d8e1e6af8277190d26339dfeb45df31b26e72ea21de4c8d0f837d72ae65d" + }, + { + "id": "B06", + "title": "Moduleinordnung", + "health": "Verbesserungsbedürftig", + "note": "Mehrfachzuordnung vorhanden; 19 Werte vertikal über lange Scrollstrecke.", + "file": "06-modul-einordnung.jpg", + "width": 1425, + "height": 990, + "sha256": "b7873a82a07c1dc2ed9ee533667313a9e8315fe687023eab2abdfe41b0ce2de2" + }, + { + "id": "B07", + "title": "Medienübersicht", + "health": "Verbesserungsbedürftig", + "note": "Bilder und Status vorhanden; zehn Filter plus Erklärungstext vor den Ergebnissen.", + "file": "07-medien-uebersicht.jpg", + "width": 1425, + "height": 990, + "sha256": "1e5ad40fdeff2f604e7f8fe91a6f89f7c2634165db483a8d2bf54cb028c98256" + }, + { + "id": "B08", + "title": "Medienliste", + "health": "Verbesserungsbedürftig", + "note": "Ansichtswechsel funktioniert; großer Filterkopf bleibt bestehen.", + "file": "08-medien-liste.jpg", + "width": 1425, + "height": 990, + "sha256": "f6388fae34c4653e5408006cd4b958c5953daa13c764e01deee43e9f3305dd94" + }, + { + "id": "B09", + "title": "Mediensuche", + "health": "Funktioniert im geprüften Fall", + "note": "Eingabe Lara reduziert auf zwei Medien und bietet Filter zurücksetzen.", + "file": "09-medien-suche.jpg", + "width": 1425, + "height": 990, + "sha256": "9aab0a545cb4d9461ee143d8697642260ca2150b301004caafcc1f1a15823f44" + }, + { + "id": "B10", + "title": "Medienbeschreibung", + "health": "Uneinheitlich", + "note": "Ansehen enthält bearbeitbare Felder und Live-Vorschau; zusätzlicher separater Editor vorhanden.", + "file": "10-medium-beschreibung.jpg", + "width": 1425, + "height": 990, + "sha256": "8a6f0cdf8e07b02f19e5c7390e6596e9f096da76b294b408c97d2e527fba14f3" + }, + { + "id": "B11", + "title": "Medienfassungen", + "health": "Brauchbare Grundlage", + "note": "Konkrete Fassung, Filmvorschau und Deaktivieren sichtbar; kein Zustandswechsel ausgeführt.", + "file": "11-medium-fassungen.jpg", + "width": 1440, + "height": 1000, + "sha256": "185305c341634232d6939091d845e277e8d707ba0b98402252ced9947bf2662e" + }, + { + "id": "B12", + "title": "Medienverwendung", + "health": "Brauchbare Grundlage", + "note": "Verknüpfte Verwendungsstellen mit Fassungen; Zähleinheit nicht sofort nachvollziehbar.", + "file": "12-medium-verwendung.jpg", + "width": 1425, + "height": 990, + "sha256": "a0af19ca11aa3289eff8da788d300109255015adcbd7e293438566768b5e1be4" + }, + { + "id": "B13", + "title": "Präsentationspicker am Medium", + "health": "Verbesserungsbedürftig", + "note": "Bestand durchsuchbar; Bildauswahl erfolgt in textbasierter Radioliste ohne Vergleichsbilder.", + "file": "13-medium-praesentationspicker.jpg", + "width": 1425, + "height": 990, + "sha256": "3f664f7d04c688ce5a37f2a26c55ad3d068e67331cb2c5445ac40b19106703f2" + }, + { + "id": "B14", + "title": "CMS-Seitenliste", + "health": "Brauchbar", + "note": "Suche, Datum und veröffentlichte Seiten erkennbar; nicht veröffentlichte Zeilen ohne ausdrücklichen Statustext.", + "file": "14-cms-seitenliste.jpg", + "width": 1425, + "height": 990, + "sha256": "bb23697a5a2f23126af056b14599467fc68a4f18bbedc48d29538bb9498b3737" + }, + { + "id": "B15", + "title": "CMS-Seiteneditor", + "health": "Verbesserungsbedürftig", + "note": "Visuelles Raster und echte Widgets; tiefe Rahmenverschachtelung und lange Scrollstrecke.", + "file": "15-cms-editor.jpg", + "width": 1425, + "height": 990, + "sha256": "f550569928a86e85ad60565bf8424ea837f25cc5d4d22cfb43700e4421230cd8" + }, + { + "id": "B16", + "title": "CMS-Widgetdialog", + "health": "Brauchbare Grundlage", + "note": "Inhalt, Medien und Darstellung getrennt; eigene Vorschau weiter unten im langen Dialog.", + "file": "16-cms-widgetdialog.jpg", + "width": 1440, + "height": 1000, + "sha256": "19762771afb3896e7f98847c81b9a2265aba97efbc556c6a0e768e66f72dbe91" + }, + { + "id": "B17", + "title": "CMS-Bildpicker", + "health": "Gute Grundlage", + "note": "Suchfähige Auswahl mit Thumbnails und Website-Freigabe; Kontext hinter Dropdown teilweise verdeckt.", + "file": "17-cms-bildpicker.jpg", + "width": 1440, + "height": 1000, + "sha256": "42efad6a55eb84239050b856b7332ebbcb7bc8c210539c89843eacaf107f91dc" + }, + { + "id": "B18", + "title": "CMS-Gerätevorschau", + "health": "Gute Grundlage", + "note": "Revision und unveröffentlichter Zustand klar, Gerätegrößen wählbar; Revision unverändert betrachtet.", + "file": "18-cms-geraetevorschau.jpg", + "width": 1265, + "height": 712, + "sha256": "c98b3a3f13b7f5b03fc7a2982e4bade734883c9c01c1f44c0b496aa64a97480c" + }, + { + "id": "B19", + "title": "CMS-Struktur und Revisionen", + "health": "Gute Grundlage", + "note": "Kompakte Struktur nach Einklappen, Revision mit Autor und Zeit; nur eine Revision vorhanden.", + "file": "19-cms-struktur-revisionen.jpg", + "width": 1440, + "height": 1000, + "sha256": "f5c37d963e92219d1565d43bd367d22efc52d31caf1638fba546bb0f74ee75be" + }, + { + "id": "B20", + "title": "Kombinationen leer", + "health": "Nicht ausreichend prüfbar", + "note": "Leerzustand vorhanden; laut Betreiber bislang nicht sinnvoll konfigurierbar.", + "file": "20-kombination-leerzustand.jpg", + "width": 1440, + "height": 1000, + "sha256": "fc691d1dade2e5121f59b16ecaf8fa56a88efb42e998a69d59f7d7f3e1b07616" + }, + { + "id": "B21", + "title": "Kombination anlegen", + "health": "Nur Einstieg geprüft", + "note": "Einfacher Dialog mit Bezeichnung; Absenden nicht ausgeführt, Bestandsbearbeitung ungeprüft.", + "file": "21-kombination-anlegen.jpg", + "width": 1440, + "height": 1000, + "sha256": "b73135a8c7f3db2953fbc64289b76e0305091888298258a91d4f23c87a5e48e4" + }, + { + "id": "B22", + "title": "Modultabelle", + "health": "Verbesserungsbedürftig", + "note": "Acht Einträge sichtbar; rechte Spalte teilweise abgeschnitten, horizontales Scrollen bei drei Spalten.", + "file": "22-module-tabelle.jpg", + "width": 1440, + "height": 1000, + "sha256": "59f6fb0c992c95853f4d0a51af2c2d6204feb4941f83bb071c215e9dfac6929c" + }, + { + "id": "B23", + "title": "Programmtabelle", + "health": "Brauchbare Grundlage", + "note": "Jüngste und angezeigte Fassung im Status unterscheidbar; drei Einträge im Testbestand.", + "file": "23-programme-tabelle.jpg", + "width": 1440, + "height": 1000, + "sha256": "8af8be34d8732a704250c8ae6b195f1235db66e432e175c71139d64789a8998f" + }, + { + "id": "B24", + "title": "Programmaufbau", + "health": "Verbesserungsbedürftig", + "note": "Vier Bestandteile und Statusübersicht; mehrere Aktionsleisten und große Zeilen.", + "file": "24-programm-aufbau.jpg", + "width": 1425, + "height": 990, + "sha256": "485abe75441f187dba114d094bd2184d04ff2ce1820ffd41b9ed6b33958326d2" + }, + { + "id": "B25", + "title": "Programmfassungsstatus", + "health": "Kritisch", + "note": "Fassung 1 als in der Bibliothek markiert, direkt darunter gegenteiliger Hinweis.", + "file": "25-programm-fassungsstatus.jpg", + "width": 1425, + "height": 990, + "sha256": "25ed503968fa8a95984e7603c3eebcbf2cecb4e87b765b9a998382c3f2b45fb6" + }, + { + "id": "B26", + "title": "Lizenzartikelliste", + "health": "Brauchbare Grundlage", + "note": "Kennung, Produktlinie und Stand sichtbar; nur ein Datensatz, kein großer Bestand geprüft.", + "file": "26-lizenzartikel-liste.jpg", + "width": 1440, + "height": 1000, + "sha256": "5da74a31a98e3ebc62768254bc30eefa1f38ce9062ab8881d19fcbaeaf543158" + }, + { + "id": "B27", + "title": "Lizenzartikeldetail", + "health": "Verbesserungsbedürftig", + "note": "Stand und Angebot vorhanden; Eingabefelder schwer erkennbar, Beziehungen weitgehend Text.", + "file": "27-lizenzartikel-detail.jpg", + "width": 1425, + "height": 990, + "sha256": "b7d72dbc8c8e6ed52c7f5ae533adc73b69b1bc7d3f1055a214fe28fa99ff72d5" + }, + { + "id": "B28", + "title": "Pakete leer", + "health": "Nicht ausreichend prüfbar", + "note": "Kein Bestandsobjekt; laut Betreiber bisherige Konfiguration nicht sinnvoll nutzbar.", + "file": "28-pakete-leerzustand.jpg", + "width": 1440, + "height": 1000, + "sha256": "76e7b0ff6a603f2824de7ccf44f9a4d1a63defda23551c84bfbe51606b1288ae" + }, + { + "id": "B29", + "title": "Rechteprofile", + "health": "Brauchbare Grundlage", + "note": "Name und Zweck in Übersicht; nur ein Testobjekt vorhanden.", + "file": "29-rechteprofile-liste.jpg", + "width": 1440, + "height": 1000, + "sha256": "68229768753fbb4f6b44b1df16bca9051f93427bafe11da2626554901ff15993" + }, + { + "id": "B30", + "title": "Rechteprofildetail", + "health": "Verbesserungsbedürftig", + "note": "Zweck und Aktionen sichtbar; doppelte Titelaktion und technische Ausgabeklassennamen.", + "file": "30-rechteprofil-detail.jpg", + "width": 1440, + "height": 1000, + "sha256": "9fde6bcf60dc4d039129586f3b311b2f2a2e2bc0146232eab7fb266bb6ce0ae0" + }, + { + "id": "B31", + "title": "Angebotsliste", + "health": "Verbesserungsbedürftig", + "note": "Aktivstatus sichtbar, steht unter der Spalte Fassungen; nur ein Testobjekt.", + "file": "31-angebote-liste.jpg", + "width": 1440, + "height": 1000, + "sha256": "58cfead27f174521f4f34252bc9a130feb7d63d4befc1dbd729870fde61bb368" + }, + { + "id": "B32", + "title": "Angebotsdetail", + "health": "Verbesserungsbedürftig", + "note": "Positionen und aufgelöste Rechte vorhanden; aktivieren trotz aktivem Stand, Beziehungen nur Text.", + "file": "32-angebot-detail.jpg", + "width": 1440, + "height": 1000, + "sha256": "b1a58fa2dbecd995f34ff5922c2d2a50481a98baba22517c9c00e56fbd4ac566" + }, + { + "id": "B33", + "title": "Säulenübersicht", + "health": "Brauchbare Grundlage", + "note": "Website-Status und Medienzahl sichtbar; fünf Werte vorhanden.", + "file": "33-saeulen-liste.jpg", + "width": 1440, + "height": 1000, + "sha256": "3995524ccb047b37c16c7efd7d2b4c14664143f1863fd85672b09129cfd63fa7" + }, + { + "id": "B34", + "title": "Säule bearbeiten", + "health": "Brauchbar mit Inkonsistenzen", + "note": "Kurzes Formular; Reihenfolge als Zahl, Veröffentlichung als Schalter, keine Vorschau im geprüften Formular.", + "file": "34-saeule-bearbeiten.jpg", + "width": 1440, + "height": 1000, + "sha256": "1079044ed8a386113bc93c7762e6617c39b5bb0364f4deb93ecf1f994d4ad687" + }, + { + "id": "B35", + "title": "Website-Navigation", + "health": "Brauchbare Grundlage", + "note": "Gruppierte Ziele, Suche und Reihenfolge-Modus; Veröffentlichung anders geführt als CMS-Seiten.", + "file": "35-navigation-liste.jpg", + "width": 1425, + "height": 990, + "sha256": "c641607954ff4b535b71796379717d20af7a123cc9cb2fc5e432e986003f00f0" + }, + { + "id": "B36", + "title": "Navigation bearbeiten", + "health": "Brauchbare Grundlage", + "note": "Interne Seite statt freier Adresse wählbar; Reihenfolge und Sichtbarkeit im selben Dialog.", + "file": "36-navigation-dialog.jpg", + "width": 1440, + "height": 1000, + "sha256": "2b896edcf2e36b4cb3a8649cdfcc3a66c91b70124c004bf046b296516787a32f" + }, + { + "id": "B37", + "title": "Materialpicker mit Fokusproblem", + "health": "Kritisch", + "note": "Tab führt nach Dialogöffnung zum Hintergrundbutton Text erstellen; zusätzlicher Fokus-Textbeleg gespeichert.", + "file": "37-materialpicker-fokus.jpg", + "width": 1425, + "height": 990, + "sha256": "e72ab30488f116a5c88502152b0199bcb94d858442f0ab1c6142d1d9ebbe58f5" + }, + { + "id": "B38", + "title": "Ausgewähltes Material", + "health": "Brauchbare Grundlage", + "note": "Fassung und Übernehmen sichtbar; Auswahl allein bestätigt noch keine Übernahme.", + "file": "38-materialpicker-auswahl.jpg", + "width": 1425, + "height": 990, + "sha256": "0dee63ebd28f2dc2767cb6fc57b4a89410e2f1e477b2c4850060c67fb6a06447" + }, + { + "id": "B39", + "title": "Bestandteil bearbeiten", + "health": "Brauchbare Grundlage", + "note": "Kontextbeschreibung und lokale Rolle klar erklärt; sechs Folgeaktionen konkurrieren im Dialog.", + "file": "39-bestandteil-bearbeiten.jpg", + "width": 1425, + "height": 990, + "sha256": "f5313dfa39aa0185fd477b419eefa6b3d22f1f95a0fad18a5a7fc7190af60add" + }, + { + "id": "B40", + "title": "Trainervorschau Entwurf", + "health": "Klärungsbedürftig", + "note": "Drei Bestandteile in vollständiger gespeicherter Entwurfsvorschau; sechs auf der Arbeitsfläche, keine Erklärung der Differenz.", + "file": "40-trainervorschau-entwurf.jpg", + "width": 1265, + "height": 1732, + "sha256": "2696d7f0fcd38be21c0ca9b7c004948a606f3019a7aae23e76d2a46181c3beea" + }, + { + "id": "B41", + "title": "Entwurfsbestandteile im Modul", + "health": "Klärungsbedürftig", + "note": "Drei zusätzliche Entwurfsbestandteile sichtbar; beim verglichenen Vorschauweg nicht enthalten.", + "file": "41-modul-entwurfsbestandteile.jpg", + "width": 1425, + "height": 990, + "sha256": "a3cb2a97346d5b230c61ead47810a4a4aad561b1d375ff09c539d30955c0ab99" + }, + { + "id": "B42", + "title": "Medienanlage ohne Reaktion", + "health": "Blockiert im geprüften Weg", + "note": "Medium anlegen ohne Dialog oder Erklärung, auch nach frischem Seitenaufruf; Ursache nicht nachgewiesen.", + "file": "42-medien-anlegen-ohne-reaktion.jpg", + "width": 1425, + "height": 990, + "sha256": "fda5c26c9e4646fc33e7357b0a6d4c4a3563e9d554e64dbae8d38e8104db743b" + }, + { + "id": "B43", + "title": "Separater Medieneditor", + "health": "Uneinheitlich", + "note": "Zweiter Bearbeitungsweg mit anderen Feldbezeichnungen und langem Formular.", + "file": "43-medium-separater-editor.jpg", + "width": 1425, + "height": 990, + "sha256": "87e5e41c95cd5d2b91c146f27fc17f03e1995637b9c026a0f5d9bad39b5c147e" + }, + { + "id": "B44", + "title": "Globale Suche", + "health": "Funktioniert im geprüften Fall", + "note": "Lara liefert drei gruppierte Treffer aus Medien und Modulen; keine Vollständigkeitsprüfung.", + "file": "44-globale-suche.jpg", + "width": 1425, + "height": 990, + "sha256": "6f5ec0c20600460a3145bdd22104c2e866301fe3715b8e3039521bd47dd67c27" + }, + { + "id": "B45", + "title": "Benutzerliste", + "health": "Verbesserungsbedürftig", + "note": "Sechs Konten, Status und Personalrollen; breite Rollenspalte erzeugt horizontales Scrollen.", + "file": "45-benutzer-liste.jpg", + "width": 1440, + "height": 1000, + "sha256": "1ae42ab219594c195cae904a17d0c90b77da44b6fa23c7d535abe9b2691c54e8" + }, + { + "id": "B46", + "title": "Testmitglied bearbeiten", + "health": "Basis vorhanden", + "note": "Stammdaten, Status, Personalrollen und Berechtigung vergeben; kein umfassender Kunden- und Lizenzarbeitsplatz.", + "file": "46-testmitglied-bearbeiten.jpg", + "width": 1440, + "height": 1000, + "sha256": "bb24f88a83072435d42e5c5e9a23fc47af117d782edc08abc5a61d9565cffd94" + } + ] +} \ No newline at end of file diff --git a/docs/ux/verwaltung/audit/UX-Audit.html b/docs/ux/verwaltung/audit/UX-Audit.html new file mode 100644 index 0000000..fb7efeb --- /dev/null +++ b/docs/ux/verwaltung/audit/UX-Audit.html @@ -0,0 +1,394 @@ +UX-Audit – Lara & Felix

Lara & Felix – UX-Audit der Verwaltung

+

Phase 1 · Stand 19.11.2026 · Entscheidungsgrundlage, kein freigegebenes Zielkonzept

+

Urteil

+

Die Verwaltung enthält bereits gute Ansätze für einen visuellen Arbeitsplatz. Sie bietet aber noch kein verlässlich einheitliches Bedienmodell. Besonders schwer wiegen widersprüchliche Sichtbarkeitshinweise, eine ungeklärte Abweichung zwischen Modulaufbau und Entwurfsvorschau sowie ein bestätigtes Problem der Tastaturführung. Ein rein gestalterischer Angleich würde diese Probleme nicht lösen.

+

Das CMS ist die stärkste Referenz für kontextbezogene Bearbeitung und echte Vorschauen. Auch außerhalb des CMS bestehen inzwischen visuelle Komponenten: gemeinsamer Arbeitsplatz für Programme und Module, Aufbaukarten, Materialpicker und Medienvorschau. Diese vorhandenen Fähigkeiten sollten die Grundlage weiterer Entscheidungen bilden.

+

Für den überwiegend von einer Person betriebenen Verwaltungsalltag sind Zusammenhang, Orientierung und sichere Rückmeldung besonders wichtig. Die Person wechselt zwischen redaktioneller Darstellung, didaktischem Aufbau, kommerziellem Angebot und Kundenbetreuung. Die Oberfläche muss dabei jeweils zeigen, welches Objekt bearbeitet wird und welche Wirkung eine Handlung hat.

+

Grundlage und Prüfgrenzen

+
    +
  • Tatsächlich geprüft: Testinstanz unter http://192.168.2.144:3011/verwaltung, angemeldetes Konto „chatgpt“, 46 gespeicherte Bildschirmaufnahmen und ausgewählte Tastaturinteraktionen.
  • +
  • Verwaltungsansichten überwiegend bei 1440 × 1000 px geprüft. Eigenständige Vorschaufenster nutzen ihre Browserbreite; die CMS-Gerätevorschau simuliert zusätzlich die gewählte Inhaltsbreite. Dies ist kein vollständiger Test aller Bildschirmgrößen.
  • +
  • Sichtbarer Bestand: 17 Medien, acht Module, drei Programme, 20 CMS-Seiten, fünf fachliche Säulen, je ein Lizenzartikel, Rechteprofil und Angebot. Kombinationen und Pakete waren leer.
  • +
  • Geöffnet wurden Übersichten, bestehende Objekte, Auswahldialoge, Bearbeitungsdialoge, Revisionsübersicht und Vorschauen. Eine Materialauswahl wurde markiert und ohne Übernahme geschlossen.
  • +
  • Keine fachlichen Daten gespeichert, keine Zuordnung übernommen, keine Reihenfolge verändert, nichts freigegeben, veröffentlicht, aktiviert, zurückgezogen oder gelöscht. Kein Repository-Umbau.
  • +
  • Erfolgs-, Fehler- und Konfliktverhalten nach tatsächlichen Schreibvorgängen, Uploadverarbeitung, Freigabebestätigungen, Berechtigungsprüfungen, Wiederherstellung und Rückzug sind damit nicht vollständig geprüft.
  • +
  • Keine Aussage zur vollständigen Barrierefreiheit. Bestätigt ist der unten beschriebene Fokusfehler; Kontraste, Screenreader, Zoom, Playerbedienung und vollständige Tastaturwege bleiben gesondert zu testen.
  • +
+

Nutzerkontext aus dem Gespräch: In der Regel betreut eine Person die Inhalte. Medien dienen allen Bereichen. CMS, lizenzierbare Lerninhalte, Angebote/Bundles und später Shop-, Rabatt-, Lizenz- und Mitgliederverwaltung gehören zum Gesamtsystem. Kombinationen und Pakete konnten laut Betreiber bisher nicht sinnvoll konfiguriert und genutzt werden. Shop-, Sonderrabatt-, Lizenzmanagement- und umfassende Mitgliederarbeitsplätze sind laut Betreiber noch nicht gebaut; sie werden hier als zukünftiger Umfang geführt, nicht als geprüfte defekte Oberflächen.

+

Abgleich mit dem erwarteten System

+

Die Dokumentation beschreibt das Soll; sie ist kein Beleg für das Verhalten der Testinstanz. Ältere Architekturtexte und aktuelle Fortschrittsnotizen haben unterschiedliche Geltung. Die aktuellen Aussagen des Betreibers und die im Audit beobachteten Zustände sind deshalb gesondert ausgewiesen.

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Dokumentierte AnforderungBeobachtungEinordnung
Redaktionelle Anzeigedaten, fachlicher Lehrinhalt und kommerzielle Angaben haben unterschiedliche ÄnderungsregelnErklärungen dazu sind vorhanden, stehen jedoch verstreut in Fließtexten und unterschiedlichen DialogenDas fachliche Modell ist sinnvoll; seine Wirkung muss an der jeweiligen Handlung deutlicher werden
Wiederverwendung über Verweise auf vorhandene Identitäten und FassungenPicker und Verwendungsansicht machen dies teilweise bereits verständlichBewahren; keine Kopierlogik oder neue Objektstruktur erforderlich
Drei getrennte Vorschauen: Mitgliederansicht, didaktischer Aufbau, kaufbarer Umfang mit RechtenCMS-Gerätevorschau, schematische Trainervorschau und aufgelöste Angebotsrechte sind verteilt erreichbarBedeutung und Aussagekraft der Vorschauen müssen eindeutig sein; schematische Vorschau ist keine vollständige Mitgliederansicht
Verwaltung bildet Aufgaben statt nur Tabellen abArbeitsplatz für Programme/Module vorhanden, Katalog weitgehend Tabellen und TextausgabenDer durchgängige Arbeitsweg von Inhalt zu Angebot ist noch nicht als zusammenhängender Arbeitsplatz erfahrbar
Katalog und Kundenverwaltung unterstützen Umfang, Rechte, Verwendungen und AuswirkungenEinzelne Beziehungen werden nur als Text ausgegeben; Benutzeransicht zeigt primär Stammdaten und PersonalrollenSichtbare Basis vorhanden, vollständige Kunden- und Lizenzarbeit laut Betreiber noch nicht gebaut
Konfigurierbare FachdimensionenMehrfachzuordnung vorhanden; eigenständige Pflege anderer Dimensionen war in der Navigation nicht auffindbarSichtbare Zuordnung geprüft, administrative Erweiterbarkeit nicht nachgewiesen
+

Maßgebliche lokale Quellen:

+ +

Die Informationsbasis vom 19.11. erklärt ausdrücklich, dass die Bestandssuche an Medium und Lizenzartikel als kurze Liste vorliegt, während der visuelle Picker an der Aufbauseite hängt. Damit ist die beobachtete Uneinheitlichkeit dokumentarisch nachvollziehbar. Sie bleibt für die Bedienung ein Problem. Ebenso müssen redaktionelle Angaben ohne neue Inhaltsfassung bearbeitbar bleiben; ein späterer einheitlicher Rahmen darf daraus keinen zusätzlichen Freigabezwang machen.

+

Geprüfte Stationen

+

Die Nummern S01–S14 bezeichnen Auditstationen; B01–B46 im separaten Belegkatalog bezeichnen die konkreten Bildschirmzustände.

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
StationGeprüfter WegZustandBelege
S01Dashboard, Seitennavigation, globale SucheSchwacher Einstieg; Suche liefert passende, nach Objekttyp gruppierte TrefferB01, B44
S02Gemeinsamer Arbeitsplatz für Module und ProgrammeGute visuelle Grundlage; große Karten und mehrere Statushinweise konkurrierenB02
S03Modul öffnen, Angaben bearbeiten, Klassifikationen aufrufenFachlich nachvollziehbar, uneinheitliche und sehr lange DialogeB03, B05, B06
S04Materialpicker öffnen, per Tab bedienen, Material auswählen und ohne Übernahme schließenVisuell hilfreich; bestätigter Fokusfehler, viel Erklärungstext, Auswahl einzeln geführtB04, B37, B38
S05Bestehenden Bestandteil bearbeitenLokaler Geltungsbereich verständlich; sechs Aktionen im Dialog konkurrierenB39
S06Medienübersicht, Listenansicht, SucheSuche funktioniert; zu großer Filter- und ErklärungskopfB07–B09, B42
S07Medium ansehen, Fassungen, Verwendung, Präsentationszuordnung, separater EditorGute fachliche Hilfen; doppelte Bearbeitungswege und abweichende AuswahlmusterB10–B13, B43
S08CMS-Seitenliste, Editor, Widgetdialog, BildpickerStärkste visuelle Führung; tiefe Verschachtelung und lange ScrollwegeB14–B17
S09CMS-Gerätevorschau, eingeklappte Struktur und RevisionenGute Vorschau und Chronologie; Vergleich bei nur einer Revision nicht prüfbarB18, B19
S10Kombinationen: Leerzustand und AnlegeeinstiegBestandsbearbeitung nicht prüfbar; Nutzungshürde vom Betreiber bestätigtB20, B21
S11Modul-/Programmtabellen, Programm mit mehreren Fassungen, ModulentwurfsvorschauKritische Status- und Vorschauabweichungen; Tabelle teilweise zu breitB22–B25, B40, B41
S12Lizenzartikel, Pakete, Rechteprofile, AngeboteGroßer Qualitätsabstand zum CMS; Pakete ohne prüfbares BeispielB26–B32
S13Fachliche Säulen und Website-NavigationGrundsätzlich klare einfache Formulare; Reihenfolge und Veröffentlichung abweichend bedientB33–B36
S14Benutzerliste und TestmitgliedStammdaten und Personalrollen vorhanden; noch kein umfassender KundenarbeitsplatzB45, B46
+

Befunde nach Priorität

+

P1: behindert eine Kernaufgabe oder eine verlässliche Entscheidung über den sichtbaren Zustand. P2: wesentliche Einschränkung von Effizienz, Verständlichkeit oder Konsistenz. P3: begrenztes sprachliches oder visuelles Detail. Die Priorisierung gilt für den beobachteten Zustand, nicht als Aussage über ungeprüfte Serverlogik.

+

UX-01 · P1 · Widersprüchliche Bibliothekssichtbarkeit

+

Beobachtung: „Programm Abstand“ führt Fassung 1 ausdrücklich als „in der Mitgliederbibliothek“. Unmittelbar darunter steht: „In der Mitgliederbibliothek ist noch keine Fassung sichtbar.“ Die jüngste Fassung 2 und die sichtbare Fassung 1 werden an anderer Stelle durchaus getrennt benannt.

+

Auswirkung: Die Person kann aus der Oberfläche nicht verlässlich entscheiden, ob und welchen Stand Mitglieder sehen. Dies ist ein inhaltlicher Widerspruch, keine reine Gestaltungsfrage.

+

Erforderliche Klärung: Eine nachvollziehbare Darstellung von letztem freigegebenem Stand und tatsächlich angezeigtem Stand. Hilfetexte müssen den jeweiligen Datensatz korrekt beschreiben. Die tatsächliche Mitgliederansicht wurde in diesem Audit nicht als zweite Identität geprüft.

+

Belege: B23–B25, besonders B25.

+

Widerspruch bei der Bibliothekssichtbarkeit

+

UX-02 · P1 · Arbeitsfläche und Entwurfsvorschau zeigen unterschiedliche Bestände

+

Beobachtung: „UX-Pilot Entwurf“ enthält auf der Arbeitsfläche sechs Bestandteile: drei mit Fassung 1 und drei als Entwurf. Die geöffnete „Vorschau des gespeicherten Entwurfs“ zeigt nur die drei Bestandteile mit Fassung 1. Eine Erklärung für die drei ausgelassenen Entwürfe ist in der Vorschau nicht vorhanden. Die Arbeitsfläche meldet einen gespeicherten Entwurf.

+

Auswirkung: Die Vorschau ermöglicht keine vollständige Kontrolle des auf der Arbeitsfläche dargestellten Aufbaus. Ob eine Filterregel oder ein Unterschied zwischen gespeichertem und bearbeitetem Zustand zugrunde liegt, bleibt offen. Beide Fälle müssten sichtbar erklärt werden.

+

Erforderliche Klärung: Aussagekraft und Datenstand der Vorschau müssen zu ihrer Beschriftung passen. Ausgelassene oder noch nicht nutzbare Bestandteile brauchen eine nachvollziehbare Kennzeichnung. Keine Aussage über einen Verlust gespeicherter Daten.

+

Belege: B03, B40, B41.

+

UX-03 · P1 · Tastaturfokus bleibt hinter dem Materialpicker

+

Beobachtung: Nach Öffnen von „Bestandteil hinzufügen“ bleibt der Fokus auf dem auslösenden Button der Hintergrundseite. Ein anschließendes Tab setzt ihn auf „Text erstellen“, ebenfalls hinter dem offenen Picker. Der Fokusverlauf wurde zusätzlich als Textbeleg gespeichert.

+

Auswirkung: Der sichtbare Dialog und das tatsächlich bediente Element fallen auseinander. Tastaturbedienung kann versehentlich Hintergrundaktionen erreichen.

+

Erforderliche Klärung: Fokus beim Öffnen in den Dialog führen, Hintergrundbedienung währenddessen verhindern und beim Schließen passend zurückgeben. Das vorhandene CMS-Dialogverhalten zeigte beim geprüften Einstieg bereits einen Fokus im Dialog und ist hierfür eine nützliche interne Referenz.

+

Belege: B37 und 37-materialpicker-fokus.txt.

+

UX-04 · P1 · „Medium anlegen“ ohne sichtbare Reaktion

+

Beobachtung: Der Button in der Medienübersicht öffnete im geprüften Zugang keinen Dialog und zeigte keine verständliche Rückmeldung. Nach frischem Seitenaufruf wurde der Einstieg einmal erneut geprüft; das Ergebnis blieb gleich.

+

Auswirkung: Der zentrale Weg für neue Medien war an dieser Stelle blockiert. Ob ein anderer Einstieg funktioniert, ist dadurch nicht entschieden. Ein alternativer Upload wird im CMS-Widget angeboten, wurde jedoch nicht ausgeführt.

+

Erforderliche Klärung: Den konkreten Einstieg mit dem Testkonto nachprüfen. Falls ein Zustand oder eine Berechtigung die Handlung verhindert, muss die Oberfläche dies erklären. Beobachtete Browserfehler wurden nicht als bewiesene Ursache eingeordnet.

+

Beleg: B42.

+

UX-05 · P2 · Zwei Medieneditoren mit unterschiedlichem Umfang und Wortlaut

+

Beobachtung: „Ansehen“ öffnet einen Tab-Arbeitsplatz mit bearbeitbaren Angaben, Speichern und Live-Vorschau. „Bearbeiten“ öffnet ein separates langes Formular für dasselbe Medium. Die Bezeichnungen variieren etwa zwischen „Arbeitstitel“ und „Titel“ sowie „Anzeigename“ und „Anzeigetitel“. Nicht alle Felder sind auf beiden Wegen gleich angeboten.

+

Auswirkung: Vor der eigentlichen Änderung muss die Person wissen, welcher Bearbeitungsweg den benötigten Bereich enthält. „Ansehen“ beschreibt die mögliche Handlung unzureichend.

+

Prüfziel für den späteren Entwurf: Eine eindeutige Hauptadresse für den Objektarbeitsplatz und konsistente Feldbezeichnungen; Spezialansichten müssen ihren Zweck klar erkennen lassen.

+

Belege: B10, B43.

+

UX-06 · P2 · Drei unterschiedliche Auswahloberflächen für denselben Medienbestand

+

Beobachtung: Aufbauauswahl über große Karten mit Suche, Filter und Detailbereich; Präsentationszuordnung am Medium über Radioliste ohne Thumbnails; CMS-Bildwahl über bebildertes, durchsuchbares Auswahlfeld. Der visuelle Picker bietet „Übernehmen“, die Radioliste „Zuordnen“. Das CMS zeigt die Website-Freigabe direkt am Bild.

+

Auswirkung: Wiedererkennen, Vorauswahl und Prüfung der Eignung kosten je Kontext unterschiedlich viel Aufmerksamkeit. Gerade bei Präsentationsbildern erschwert die textbasierte Liste den visuellen Vergleich.

+

Prüfziel für den späteren Entwurf: Gemeinsame Interaktionsregeln für Suche, Ergebnisdarstellung, Auswahl, Detailprüfung und Bestätigung. Fachlich unterschiedliche erlaubte Arten und Fassungen müssen erhalten bleiben.

+

Belege: B13, B17, B38; dokumentarisch bestätigt durch die Informationsbasis vom 19.11.

+

Visueller Materialpicker mit Detailbereich

+

UX-07 · P2 · Ergebnisse beginnen zu spät; Filter und Hilfetexte dominieren

+

Beobachtung: Die Medienübersicht zeigt zehn Auswahlfilter zusätzlich zur Suche und einen längeren Erklärungstext. Die ersten Karten beginnen ungefähr bei zwei Dritteln der sichtbaren Höhe. Auch die Listenansicht übernimmt den großen Kopf. Im Modul stehen über dem Aufbau mehrere Aktions- und Erklärungsebenen; die erste Reihe zeigt im Wesentlichen zwei Bestandteile.

+

Auswirkung: Häufiges Suchen, Vergleichen und Sortieren führt zu vermeidbaren Scrollwegen. Der Wechsel auf „Liste“ schafft noch keinen ausreichend kompakten Bestandsarbeitsplatz.

+

Prüfziel für den späteren Entwurf: Häufige Filter und aktive Einschränkungen schnell erfassbar halten; seltene Optionen und längere Erklärungen bedarfsgerecht zugänglich machen. Karten- und Listenansicht nach realem Vergleichsbedarf beurteilen.

+

Belege: B07–B09, B24, B42.

+

Medienübersicht mit hohem Filterkopf

+

UX-08 · P2 · Klassifikation erzeugt lange Auswahlstrecken

+

Beobachtung: Im Moduldialog werden 19 Werte aus vier Dimensionen untereinander angeboten. Bereits diese kleine Ausgangsmenge benötigt Scrollen. Am Lizenzartikel erscheinen dieselben Themen als eng umbrochene Checkboxfolgen. Die Medienfilter bieten Fachsäule separat und nochmals innerhalb der Einordnung an.

+

Auswirkung: Zugeordnete Werte sind schwer zusammenfassend zu erfassen; mit wachsenden Dimensionen steigt der Suchaufwand. Zuordnung und Übersicht sind je Objekt anders gestaltet.

+

Prüfziel für den späteren Entwurf: Dimensionen verständlich gruppieren, vorhandene Zuordnungen auf einen Blick zeigen und größere Wertemengen gezielt durchsuchen können. Kleine feste Auswahlen dürfen weiterhin einfache Checkboxen verwenden; die Schwierigkeit liegt hier in Anordnung, Wiederholung und Wachstum.

+

Belege: B06, B27, B42.

+

UX-09 · P2 · CMS zeigt zu viel Strukturmechanik gleichzeitig

+

Beobachtung: Abschnitt, Rasterauswahl, Abschnittsgestaltung, Rasterplatz, Widgetrahmen und Widgetvorschau liegen ineinander. Schon der erste Abschnitt beansprucht fast die gesamte sichtbare Arbeitshöhe. „Alle einklappen“ erzeugt dagegen eine gut lesbare kompakte Struktur. Der Widgetdialog besitzt eigene lange Inhalte und eine weitere Vorschau darunter.

+

Auswirkung: Die Person arbeitet häufig an einzelnen Inhalten, muss dabei aber viele Struktur- und Konfigurationsrahmen durchqueren. Gesamtstruktur und Inhaltsbearbeitung sind schwer gleichzeitig im Blick zu halten.

+

Prüfziel für den späteren Entwurf: Zwischen Strukturüberblick, ausgewähltem Inhalt und kontextbezogenen Einstellungen klar unterscheiden; den kompakten Aufbau als bereits vorhandene Stärke nutzen. Noch keine Festlegung auf eine konkrete neue Bildschirmkomposition.

+

Belege: B15, B16, B19.

+

Kompakte CMS-Struktur mit Revisionen

+

UX-10 · P2 · Tabellen benötigen schon bei kleinen Beständen horizontales Scrollen

+

Beobachtung: Die Modultabelle mit nur drei Spalten schneidet bei 1440 px Teile der rechten Spalte ab. Lange Namen und ausformulierte Statusangaben verbreitern die Tabelle. Die Benutzerliste wird durch die zahlreichen Rollen ebenfalls breiter als der Inhaltsbereich.

+

Auswirkung: Angaben eines Objekts lassen sich nicht ohne Verschieben vollständig prüfen. Dies begrenzt die gewünschte effiziente Desktopbedienung bereits vor einem großen Datenbestand.

+

Prüfziel für den späteren Entwurf: Spalten nach Aufgabe priorisieren, lange Inhalte sinnvoll umbrechen oder zusammenfassen und volle Angaben ohne Orientierungsverlust zugänglich machen.

+

Belege: B22, B45.

+

UX-11 · P2 · Katalogbeziehungen werden dargestellt, aber kaum als Arbeitswege nutzbar

+

Beobachtung: Lizenzartikel zeigt Bestand und zugehöriges Angebot als Text; Angebotsdetails zeigen Lizenzartikel und Rechteprofil ebenfalls als Text. Die enthaltene Trainerunterlage erscheint im Artikel mehrfach ohne gut erkennbaren Herkunftspfad. Redaktionelle Felder am Lizenzartikel haben kaum sichtbare Grenzen, Beschriftungen und Leerhinweise laufen ineinander. Die Angabe „Keine Angabe“ lässt den tatsächlich aus der Quelle übernommenen Wert nicht erkennen.

+

Auswirkung: Die Person muss für Änderungen zurück in die Navigation und die genannten Objekte erneut suchen. Herkunft, eigene Abweichung und wirksamer Wert sind schwer unterscheidbar. Wiederverwendung kann wie ein unklarer Doppeleintrag wirken.

+

Prüfziel für den späteren Entwurf: Beziehungen als direkt benutzbare Verknüpfungen mit Herkunft und Fassung darstellen; Quelle, wirksame Angabe und eigene Überschreibung verständlich zeigen. Wiederholte Verwendungen müssen fachlich erhalten bleiben.

+

Belege: B27, B30, B32; Auflösungsregeln in der Informationsbasis, Abschnitt „Auflösung“.

+

Lizenzartikel mit schwer erkennbarer Redaktion

+

UX-12 · P2 · Sichtbare Aktionen passen nicht eindeutig zum aktuellen Zustand

+

Beobachtung: Ein bereits als aktiv ausgewiesenes Angebot bietet prominent „Fassung aktivieren“. Ein veröffentlichter Artikel zeigt „Stand veröffentlichen“ und „Stand zurückziehen“ mit gleicher visueller Gewichtung. Ein Programm ohne offenen Entwurf bietet „Entwurf verwerfen“. Im Modul-/Programmarbeitsplatz werden Vorschau und Status mehrfach wiederholt.

+

Auswirkung: Die Oberfläche verlangt zusätzliche Interpretation: Was ist jetzt sinnvoll, was ändert sich und welches Objekt betrifft es? Eine gegebenenfalls nachfolgende Bestätigung kann helfen, ersetzt jedoch keine klare Orientierung vor dem Klick.

+

Prüfziel für den späteren Entwurf: Handlung, Gegenstand und erwartete Wirkung am aktuellen Zustand ausrichten. Die nachgelagerten Bestätigungen und tatsächlichen Zustandswechsel wurden bewusst nicht ausgeführt und sind noch zu prüfen.

+

Belege: B24, B27, B32.

+

UX-13 · P2 · Einstieg und Navigation bilden den täglichen Aufgabenwechsel schwach ab

+

Beobachtung: Das Dashboard bietet im geprüften Konto nur Willkommen und Abmelden. Der nützlichere Arbeitsplatz liegt darunter im Bereich Inhalte und betrifft ausschließlich Programme und Module. CMS-Seiten, Website-Navigation und Benutzer stehen ungruppiert vor Inhalte und Katalog. Module/Programme haben zugleich eigene Tabellen und den gemeinsamen Arbeitsplatz. Globale Suche ist vorhanden und liefert passende Ergebnisse nach Objekttyp.

+

Auswirkung: Der bevorzugte Einstieg und die Beziehung zwischen Arbeitsansicht und Objekttyp sind unklar. Eine Person mit mehreren Aufgabenbereichen erhält keine Übersicht über jüngste Arbeit oder anstehende nächste Schritte.

+

Prüfziel für den späteren Entwurf: Eine verständliche gemeinsame Orientierung über Arbeitskontexte und Aufgaben hinweg. Noch nicht gebaute Shop- und Kundenabläufe gehören ins spätere Gesamtkonzept, wurden aber nicht als bestehende Oberflächen bewertet.

+

Belege: B01, B02, B22, B23, B44, B46; Betreiberkontext.

+

UX-14 · P2 · Visuelle Komponenten wirken wie mehrere Produkte

+

Beobachtung: CMS und klassische Filament-Masken nutzen gerundete Felder, ruhige Container und kleinere Schaltflächen. Aufbauarbeitsplätze und Picker zeigen scharfkantige Rahmen, größere Schaltflächen, eine andere Überschriftenanmutung und gelbe Unterstreichungen. Am Lizenzartikel sind Eingabeflächen teilweise kaum erkennbar. Hier unterscheiden sich auch Fokus- und Dialogverhalten.

+

Auswirkung: Visuell ähnliche Absichten werden unterschiedlich signalisiert. Die Person kann Interaktionen nicht zuverlässig von einem Bereich auf den nächsten übertragen.

+

Prüfziel für den späteren Entwurf: Gemeinsame grundlegende Komponenten für Felder, Dialoge, Aktionshierarchie, Status, Abstände und Fokus. Die attraktive öffentliche Markeninszenierung braucht im Verwaltungsarbeitsplatz eine zum Arbeitszweck passende Dosierung.

+

Belege: B16, B19, B24, B27, B38, B43.

+

UX-15 · P3 · Sprache und Bedeutungen sind nicht durchgängig vereinheitlicht

+

Beobachtung: „Abstand ansehen ansehen“ entsteht aus Objektname und angehängter Aktion. „Übungen und Kurse“ steht in Erklärungen neben den Navigationsbegriffen Module und Programme. „Entwurf egal“, „Context“, technische Ausgabeklassen und Verweise wie „ADR-29“ erscheinen neben redaktionellen Alltagsbegriffen. „6 Verwendungen“ öffnet beim Medium eine längere Liste mit mehreren historischen Fassungen desselben Programms; die Zähleinheit wird nicht erläutert.

+

Auswirkung: Die Person muss Begriffe und Zählweise erschließen. Unterschiedliche fachliche Dinge dürfen unterschiedliche Namen haben; dieselbe Bedeutung sollte jedoch nicht je Maske neu formuliert werden.

+

Prüfziel für den späteren Entwurf: Einheitliches redaktionelles Vokabular und konkrete Aktionsbeschriftungen. Technische und architektonische Erläuterungen nur dort zeigen, wo sie eine tatsächliche Entscheidung unterstützen.

+

Belege: B20, B30, B38, B42; vollständige Verwendungsansicht im Audit geöffnet.

+

Bedienwege und Anzahl der Aktionen

+

Die Zählung erfasst konkrete Bedienaktionen bis zu einem beobachteten Zustand. Eine Texteingabe zählt als eine Aktion; Scrollen und Ladezeit sind nicht als Klicks verrechnet. Dies sind keine Messungen mit echten Anwendern und keine vollständigen Erfolgsquoten. Schreibende Abschlüsse wurden nicht ausgeführt.

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Aufgabe und AusgangspunktGeprüfter WegBeobachtete AktionenGrenze / zusätzlicher Aufwand
Medium über dessen Namen finden; Ausgangspunkt beliebige VerwaltungsseiteMedien → Suche „Lara“ → Titel „Lara im Park“2 Klicks + 1 TexteingabeBearbeitbare Beschreibung erreicht; Speichern nicht ausgeführt
Verwendungen vom geöffneten Medium prüfenVerwendung → „6 Verwendungen“ aufklappen2 KlicksVerknüpfte Module/Programme sichtbar; Zählweise umfasst unterschiedliche Ebenen
Bestandsteil wählen; Ausgangspunkt andere VerwaltungsseiteArbeitsplatz → Modul → Bestandteil hinzufügen → Material markieren4 Klicks ohne Such- oder Filtereingabe„Übernehmen“ und „Entwurf speichern“ werden angeboten; beide nicht ausgeführt. Bei sechs Einzelmaterialien muss der weitere Ablauf erst praktisch vermessen werden
Beschreibung eines geöffneten Moduls erreichenModul bearbeiten → Beschreibung ist Standardtab1 KlickEingabe und Übernehmen wären nachgelagert; Dialog erklärt eine direkte Speicherung der Angaben
Klassifikation eines geöffneten Moduls erreichenModul bearbeiten → Einordnung2 Klicks19 Werte, zusätzliche Scrollstrecke; Abschluss nicht ausgeführt
Lokale Kontextbeschreibung eines Bestandteils erreichenBearbeiten am Bestandteil1 KlickEigene Beschreibung/Rolle sichtbar; sechs konkurrierende Folgeaktionen
CMS-Widgetinhalt erreichen; Ausgangspunkt andere VerwaltungsseiteSeiten → Seite → Bearbeiten am Widget3 Klicks plus nötiges Scrollen„Übernehmen“, „Entwurf speichern“, „Vorschau“ und „Veröffentlichen“ sind getrennte sichtbare Schritte; nicht als vollständiger Schreibablauf getestet
CMS-Bildwahl öffnen; Ausgangspunkt SeiteneditorWidget bearbeiten → Medien → Bildauswahl3 KlicksSuchfähige Auswahl mit Thumbnails und Freigabestatus erreicht
Stammdaten eines Testmitglieds erreichenBenutzer → Testmitglied2 KlicksKein umfassender Überblick über Bestellungen und Lizenzen; vollständiger Bereich laut Betreiber noch nicht gebaut
+

Die größte erkennbare Reibung entsteht nicht allein durch Klickanzahl. Sie entsteht durch Scrollstrecken, erneut nötige Orientierung und Zweifel an der Wirkung einer Handlung. Eine weitere Beschleunigung durch Mehrfachauswahl ist für den Aufbau prüfenswert, aber fachliche Rollen und Fassungen je Verwendung müssen dabei erhalten bleiben. Dies ist noch keine festgelegte Interaktionsregel.

+

Was als Grundlage erhalten bleiben sollte

+
    +
  1. Gemeinsamer visueller Arbeitsplatz für Module und Programme.
  2. +
  3. Materialsuche mit Karten, Detailprüfung und sichtbaren Fassungen.
  4. +
  5. Verweise auf vorhandene Medien und kontextbezogene Rollen.
  6. +
  7. Verwendungsnachweise mit direktem Absprung in Module und Programme.
  8. +
  9. Sichtbare Trennung von freigegebenem Stand und Bibliotheksstand – nach Korrektur der widersprüchlichen Aussagen.
  10. +
  11. CMS-Rasterdarstellung, kontextbezogene Widgetdialoge und Bildsuche mit Thumbnails.
  12. +
  13. Echte CMS-Gerätevorschau und Revisionen mit Bearbeiter und Zeitpunkt.
  14. +
  15. Alternative Auf-/Ab-Aktionen zu Drag-and-drop.
  16. +
  17. Klassifikation als Mehrfachzuordnung sowie getrennte fachliche und technische Medienart.
  18. +
  19. Bereits dokumentierte Trennung redaktioneller, fachlicher und kommerzieller Änderungen.
  20. +
+

Offene Prüflücken

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
BereichWas noch nicht belegt istNötige Grundlage
Kombinationen und PaketeSinnvolles Zusammenstellen, verschachtelte Bearbeitung, Versionen und praktische NutzbarkeitGemeinsam nachvollziehbarer Beispielablauf; laut Betreiber derzeitige Nutzungshürde
Speichern und FreigebenRückmeldung, Fehler, Auswirkungen, Wiederherstellung, versehentlicher Verlust, RechteprüfungGezielter Test an ausdrücklich disponiblen Daten mit tatsächlichen Schreibvorgängen
MedienanlageAnlage nach dem blockierten Einstieg, Verarbeitung, Fehlerbehandlung, große UploadsFunktionierender Einstieg; anschließend freigegebener Testupload
TrainervorschauUrsache und genaue Regel der 6/3-Abweichung; Übereinstimmung mit tatsächlicher MitgliederansichtDatenstand und Vorschauabsicht klären, danach End-to-End-Prüfung
Große BeständePaginierung im visuellen Picker, Auswahl über viele Treffer, Performance, gespeicherte AnsichtenRepräsentativer größerer Bestand
BarrierefreiheitVollständige Tastaturbedienung, Dialogsemantik, Statusansagen, Kontraste, ZoomGezielte zusätzliche Prüfung; der bestätigte Fokusfehler benötigt bereits Korrektur
RollenUnterschiede zwischen Redaktion, Fachprüfung, Katalog und KundenbetreuungPrüfung mit repräsentativen Konten; aktuelles Testkonto besitzt mehrere Rollen
Shop, Sonderrabatte, Lizenzmanagement, umfassende MitgliederverwaltungReale Bedienabläufe noch nicht vorhandenLaut Betreiber noch nicht gebaut; Dokumentation liefert den erwarteten Umfang
TrainingspläneEigenständiger aktueller Verwaltungsarbeitsplatz nicht aufgefundenSpätere Zieldefinition im Gesamtkonzept; keine Erfindung eines neuen Fachmodells im Audit
+

Konsequenz für die weitere gemeinsame Arbeit

+

Vor der visuellen Auswahl sollten die P1-Befunde als getrennte Punkte bestätigt beziehungsweise fachlich aufgeklärt werden. Das nachfolgende Zielkonzept muss den gesamten Verwaltungsalltag aufnehmen, einschließlich späterer Angebots-, Rabatt-, Kunden- und Lizenzarbeit. Es darf aus dem heutigen schmalen Menü keinen dauerhaft schmalen Zielumfang ableiten.

+

Die nächste Phase kann gemeinsame visuelle Richtungen für Orientierung, Objektarbeitsplatz, Auswahl und Zustandsführung erarbeiten. Sie muss die dokumentierten Klassen A/B/C, CMS-Revisionen, Rechte und Datenbeziehungen erhalten und den Ein-Personen-Alltag unterstützen. In diesem Audit wurden weder eine Designrichtung gewählt noch verbindliche Cursor-Regeln, Implementierungsaufträge oder ein neues Verwaltungsframework festgelegt.

+

Vollständige aktuelle Bildschirmbelege mit Kurznotizen: Belegkatalog.

+
\ No newline at end of file diff --git a/docs/ux/verwaltung/audit/UX-Audit.md b/docs/ux/verwaltung/audit/UX-Audit.md new file mode 100644 index 0000000..b4865a2 --- /dev/null +++ b/docs/ux/verwaltung/audit/UX-Audit.md @@ -0,0 +1,285 @@ +# Lara & Felix – UX-Audit der Verwaltung + +**Phase 1 · Stand 19.11.2026 · Entscheidungsgrundlage, kein freigegebenes Zielkonzept** + +## Urteil + +Die Verwaltung enthält bereits gute Ansätze für einen visuellen Arbeitsplatz. Sie bietet aber noch kein verlässlich einheitliches Bedienmodell. Besonders schwer wiegen widersprüchliche Sichtbarkeitshinweise, eine ungeklärte Abweichung zwischen Modulaufbau und Entwurfsvorschau sowie ein bestätigtes Problem der Tastaturführung. Ein rein gestalterischer Angleich würde diese Probleme nicht lösen. + +Das CMS ist die stärkste Referenz für kontextbezogene Bearbeitung und echte Vorschauen. Auch außerhalb des CMS bestehen inzwischen visuelle Komponenten: gemeinsamer Arbeitsplatz für Programme und Module, Aufbaukarten, Materialpicker und Medienvorschau. Diese vorhandenen Fähigkeiten sollten die Grundlage weiterer Entscheidungen bilden. + +Für den überwiegend von einer Person betriebenen Verwaltungsalltag sind Zusammenhang, Orientierung und sichere Rückmeldung besonders wichtig. Die Person wechselt zwischen redaktioneller Darstellung, didaktischem Aufbau, kommerziellem Angebot und Kundenbetreuung. Die Oberfläche muss dabei jeweils zeigen, welches Objekt bearbeitet wird und welche Wirkung eine Handlung hat. + +## Grundlage und Prüfgrenzen + +- Tatsächlich geprüft: Testinstanz unter http://192.168.2.144:3011/verwaltung, angemeldetes Konto „chatgpt“, 46 gespeicherte Bildschirmaufnahmen und ausgewählte Tastaturinteraktionen. +- Verwaltungsansichten überwiegend bei 1440 × 1000 px geprüft. Eigenständige Vorschaufenster nutzen ihre Browserbreite; die CMS-Gerätevorschau simuliert zusätzlich die gewählte Inhaltsbreite. Dies ist kein vollständiger Test aller Bildschirmgrößen. +- Sichtbarer Bestand: 17 Medien, acht Module, drei Programme, 20 CMS-Seiten, fünf fachliche Säulen, je ein Lizenzartikel, Rechteprofil und Angebot. Kombinationen und Pakete waren leer. +- Geöffnet wurden Übersichten, bestehende Objekte, Auswahldialoge, Bearbeitungsdialoge, Revisionsübersicht und Vorschauen. Eine Materialauswahl wurde markiert und ohne Übernahme geschlossen. +- Keine fachlichen Daten gespeichert, keine Zuordnung übernommen, keine Reihenfolge verändert, nichts freigegeben, veröffentlicht, aktiviert, zurückgezogen oder gelöscht. Kein Repository-Umbau. +- Erfolgs-, Fehler- und Konfliktverhalten nach tatsächlichen Schreibvorgängen, Uploadverarbeitung, Freigabebestätigungen, Berechtigungsprüfungen, Wiederherstellung und Rückzug sind damit nicht vollständig geprüft. +- Keine Aussage zur vollständigen Barrierefreiheit. Bestätigt ist der unten beschriebene Fokusfehler; Kontraste, Screenreader, Zoom, Playerbedienung und vollständige Tastaturwege bleiben gesondert zu testen. + +**Nutzerkontext aus dem Gespräch:** In der Regel betreut eine Person die Inhalte. Medien dienen allen Bereichen. CMS, lizenzierbare Lerninhalte, Angebote/Bundles und später Shop-, Rabatt-, Lizenz- und Mitgliederverwaltung gehören zum Gesamtsystem. Kombinationen und Pakete konnten laut Betreiber bisher nicht sinnvoll konfiguriert und genutzt werden. Shop-, Sonderrabatt-, Lizenzmanagement- und umfassende Mitgliederarbeitsplätze sind laut Betreiber noch nicht gebaut; sie werden hier als zukünftiger Umfang geführt, nicht als geprüfte defekte Oberflächen. + +## Abgleich mit dem erwarteten System + +Die Dokumentation beschreibt das Soll; sie ist kein Beleg für das Verhalten der Testinstanz. Ältere Architekturtexte und aktuelle Fortschrittsnotizen haben unterschiedliche Geltung. Die aktuellen Aussagen des Betreibers und die im Audit beobachteten Zustände sind deshalb gesondert ausgewiesen. + +| Dokumentierte Anforderung | Beobachtung | Einordnung | +|---|---|---| +| Redaktionelle Anzeigedaten, fachlicher Lehrinhalt und kommerzielle Angaben haben unterschiedliche Änderungsregeln | Erklärungen dazu sind vorhanden, stehen jedoch verstreut in Fließtexten und unterschiedlichen Dialogen | Das fachliche Modell ist sinnvoll; seine Wirkung muss an der jeweiligen Handlung deutlicher werden | +| Wiederverwendung über Verweise auf vorhandene Identitäten und Fassungen | Picker und Verwendungsansicht machen dies teilweise bereits verständlich | Bewahren; keine Kopierlogik oder neue Objektstruktur erforderlich | +| Drei getrennte Vorschauen: Mitgliederansicht, didaktischer Aufbau, kaufbarer Umfang mit Rechten | CMS-Gerätevorschau, schematische Trainervorschau und aufgelöste Angebotsrechte sind verteilt erreichbar | Bedeutung und Aussagekraft der Vorschauen müssen eindeutig sein; schematische Vorschau ist keine vollständige Mitgliederansicht | +| Verwaltung bildet Aufgaben statt nur Tabellen ab | Arbeitsplatz für Programme/Module vorhanden, Katalog weitgehend Tabellen und Textausgaben | Der durchgängige Arbeitsweg von Inhalt zu Angebot ist noch nicht als zusammenhängender Arbeitsplatz erfahrbar | +| Katalog und Kundenverwaltung unterstützen Umfang, Rechte, Verwendungen und Auswirkungen | Einzelne Beziehungen werden nur als Text ausgegeben; Benutzeransicht zeigt primär Stammdaten und Personalrollen | Sichtbare Basis vorhanden, vollständige Kunden- und Lizenzarbeit laut Betreiber noch nicht gebaut | +| Konfigurierbare Fachdimensionen | Mehrfachzuordnung vorhanden; eigenständige Pflege anderer Dimensionen war in der Navigation nicht auffindbar | Sichtbare Zuordnung geprüft, administrative Erweiterbarkeit nicht nachgewiesen | + +Maßgebliche lokale Quellen: + +- [Produktkonfiguration, Objektmodell und Klassen A/B/C](../../../fachkonzept/produktkonfiguration-und-mitgliederbereich.md) +- [Dokumentierter redaktioneller Arbeitsablauf](../../../fachkonzept/produktkonfiguration-und-mitgliederbereich.md) +- [Redaktionelle Informationsbasis, Stand 19.11.2026](../../../architektur/redaktionelle-informationsbasis.md) +- [Erwartete Verwaltungsbereiche](../../../architektur/09_CMS_Administration_Community.md) +- [Aktuell dokumentierter MVP-Stand](../../../betrieb/MVP-Stand.md) +- [Design- und UX-Prinzipien](../../../prinzipien/design-prinzipien.md) + +Die Informationsbasis vom 19.11. erklärt ausdrücklich, dass die Bestandssuche an Medium und Lizenzartikel als kurze Liste vorliegt, während der visuelle Picker an der Aufbauseite hängt. Damit ist die beobachtete Uneinheitlichkeit dokumentarisch nachvollziehbar. Sie bleibt für die Bedienung ein Problem. Ebenso müssen redaktionelle Angaben ohne neue Inhaltsfassung bearbeitbar bleiben; ein späterer einheitlicher Rahmen darf daraus keinen zusätzlichen Freigabezwang machen. + +## Geprüfte Stationen + +Die Nummern S01–S14 bezeichnen Auditstationen; B01–B46 im separaten Belegkatalog bezeichnen die konkreten Bildschirmzustände. + +| Station | Geprüfter Weg | Zustand | Belege | +|---|---|---|---| +| S01 | Dashboard, Seitennavigation, globale Suche | Schwacher Einstieg; Suche liefert passende, nach Objekttyp gruppierte Treffer | B01, B44 | +| S02 | Gemeinsamer Arbeitsplatz für Module und Programme | Gute visuelle Grundlage; große Karten und mehrere Statushinweise konkurrieren | B02 | +| S03 | Modul öffnen, Angaben bearbeiten, Klassifikationen aufrufen | Fachlich nachvollziehbar, uneinheitliche und sehr lange Dialoge | B03, B05, B06 | +| S04 | Materialpicker öffnen, per Tab bedienen, Material auswählen und ohne Übernahme schließen | Visuell hilfreich; bestätigter Fokusfehler, viel Erklärungstext, Auswahl einzeln geführt | B04, B37, B38 | +| S05 | Bestehenden Bestandteil bearbeiten | Lokaler Geltungsbereich verständlich; sechs Aktionen im Dialog konkurrieren | B39 | +| S06 | Medienübersicht, Listenansicht, Suche | Suche funktioniert; zu großer Filter- und Erklärungskopf | B07–B09, B42 | +| S07 | Medium ansehen, Fassungen, Verwendung, Präsentationszuordnung, separater Editor | Gute fachliche Hilfen; doppelte Bearbeitungswege und abweichende Auswahlmuster | B10–B13, B43 | +| S08 | CMS-Seitenliste, Editor, Widgetdialog, Bildpicker | Stärkste visuelle Führung; tiefe Verschachtelung und lange Scrollwege | B14–B17 | +| S09 | CMS-Gerätevorschau, eingeklappte Struktur und Revisionen | Gute Vorschau und Chronologie; Vergleich bei nur einer Revision nicht prüfbar | B18, B19 | +| S10 | Kombinationen: Leerzustand und Anlegeeinstieg | Bestandsbearbeitung nicht prüfbar; Nutzungshürde vom Betreiber bestätigt | B20, B21 | +| S11 | Modul-/Programmtabellen, Programm mit mehreren Fassungen, Modulentwurfsvorschau | Kritische Status- und Vorschauabweichungen; Tabelle teilweise zu breit | B22–B25, B40, B41 | +| S12 | Lizenzartikel, Pakete, Rechteprofile, Angebote | Großer Qualitätsabstand zum CMS; Pakete ohne prüfbares Beispiel | B26–B32 | +| S13 | Fachliche Säulen und Website-Navigation | Grundsätzlich klare einfache Formulare; Reihenfolge und Veröffentlichung abweichend bedient | B33–B36 | +| S14 | Benutzerliste und Testmitglied | Stammdaten und Personalrollen vorhanden; noch kein umfassender Kundenarbeitsplatz | B45, B46 | + +## Befunde nach Priorität + +**P1:** behindert eine Kernaufgabe oder eine verlässliche Entscheidung über den sichtbaren Zustand. **P2:** wesentliche Einschränkung von Effizienz, Verständlichkeit oder Konsistenz. **P3:** begrenztes sprachliches oder visuelles Detail. Die Priorisierung gilt für den beobachteten Zustand, nicht als Aussage über ungeprüfte Serverlogik. + +### UX-01 · P1 · Widersprüchliche Bibliothekssichtbarkeit + +**Beobachtung:** „Programm Abstand“ führt Fassung 1 ausdrücklich als „in der Mitgliederbibliothek“. Unmittelbar darunter steht: „In der Mitgliederbibliothek ist noch keine Fassung sichtbar.“ Die jüngste Fassung 2 und die sichtbare Fassung 1 werden an anderer Stelle durchaus getrennt benannt. + +**Auswirkung:** Die Person kann aus der Oberfläche nicht verlässlich entscheiden, ob und welchen Stand Mitglieder sehen. Dies ist ein inhaltlicher Widerspruch, keine reine Gestaltungsfrage. + +**Erforderliche Klärung:** Eine nachvollziehbare Darstellung von letztem freigegebenem Stand und tatsächlich angezeigtem Stand. Hilfetexte müssen den jeweiligen Datensatz korrekt beschreiben. Die tatsächliche Mitgliederansicht wurde in diesem Audit nicht als zweite Identität geprüft. + +**Belege:** B23–B25, besonders B25. + +![Widerspruch bei der Bibliothekssichtbarkeit](25-programm-fassungsstatus.jpg) + +### UX-02 · P1 · Arbeitsfläche und Entwurfsvorschau zeigen unterschiedliche Bestände + +**Beobachtung:** „UX-Pilot Entwurf“ enthält auf der Arbeitsfläche sechs Bestandteile: drei mit Fassung 1 und drei als Entwurf. Die geöffnete „Vorschau des gespeicherten Entwurfs“ zeigt nur die drei Bestandteile mit Fassung 1. Eine Erklärung für die drei ausgelassenen Entwürfe ist in der Vorschau nicht vorhanden. Die Arbeitsfläche meldet einen gespeicherten Entwurf. + +**Auswirkung:** Die Vorschau ermöglicht keine vollständige Kontrolle des auf der Arbeitsfläche dargestellten Aufbaus. Ob eine Filterregel oder ein Unterschied zwischen gespeichertem und bearbeitetem Zustand zugrunde liegt, bleibt offen. Beide Fälle müssten sichtbar erklärt werden. + +**Erforderliche Klärung:** Aussagekraft und Datenstand der Vorschau müssen zu ihrer Beschriftung passen. Ausgelassene oder noch nicht nutzbare Bestandteile brauchen eine nachvollziehbare Kennzeichnung. Keine Aussage über einen Verlust gespeicherter Daten. + +**Belege:** B03, B40, B41. + +### UX-03 · P1 · Tastaturfokus bleibt hinter dem Materialpicker + +**Beobachtung:** Nach Öffnen von „Bestandteil hinzufügen“ bleibt der Fokus auf dem auslösenden Button der Hintergrundseite. Ein anschließendes Tab setzt ihn auf „Text erstellen“, ebenfalls hinter dem offenen Picker. Der Fokusverlauf wurde zusätzlich als Textbeleg gespeichert. + +**Auswirkung:** Der sichtbare Dialog und das tatsächlich bediente Element fallen auseinander. Tastaturbedienung kann versehentlich Hintergrundaktionen erreichen. + +**Erforderliche Klärung:** Fokus beim Öffnen in den Dialog führen, Hintergrundbedienung währenddessen verhindern und beim Schließen passend zurückgeben. Das vorhandene CMS-Dialogverhalten zeigte beim geprüften Einstieg bereits einen Fokus im Dialog und ist hierfür eine nützliche interne Referenz. + +**Belege:** B37 und 37-materialpicker-fokus.txt. + +### UX-04 · P1 · „Medium anlegen“ ohne sichtbare Reaktion + +**Beobachtung:** Der Button in der Medienübersicht öffnete im geprüften Zugang keinen Dialog und zeigte keine verständliche Rückmeldung. Nach frischem Seitenaufruf wurde der Einstieg einmal erneut geprüft; das Ergebnis blieb gleich. + +**Auswirkung:** Der zentrale Weg für neue Medien war an dieser Stelle blockiert. Ob ein anderer Einstieg funktioniert, ist dadurch nicht entschieden. Ein alternativer Upload wird im CMS-Widget angeboten, wurde jedoch nicht ausgeführt. + +**Erforderliche Klärung:** Den konkreten Einstieg mit dem Testkonto nachprüfen. Falls ein Zustand oder eine Berechtigung die Handlung verhindert, muss die Oberfläche dies erklären. Beobachtete Browserfehler wurden nicht als bewiesene Ursache eingeordnet. + +**Beleg:** B42. + +### UX-05 · P2 · Zwei Medieneditoren mit unterschiedlichem Umfang und Wortlaut + +**Beobachtung:** „Ansehen“ öffnet einen Tab-Arbeitsplatz mit bearbeitbaren Angaben, Speichern und Live-Vorschau. „Bearbeiten“ öffnet ein separates langes Formular für dasselbe Medium. Die Bezeichnungen variieren etwa zwischen „Arbeitstitel“ und „Titel“ sowie „Anzeigename“ und „Anzeigetitel“. Nicht alle Felder sind auf beiden Wegen gleich angeboten. + +**Auswirkung:** Vor der eigentlichen Änderung muss die Person wissen, welcher Bearbeitungsweg den benötigten Bereich enthält. „Ansehen“ beschreibt die mögliche Handlung unzureichend. + +**Prüfziel für den späteren Entwurf:** Eine eindeutige Hauptadresse für den Objektarbeitsplatz und konsistente Feldbezeichnungen; Spezialansichten müssen ihren Zweck klar erkennen lassen. + +**Belege:** B10, B43. + +### UX-06 · P2 · Drei unterschiedliche Auswahloberflächen für denselben Medienbestand + +**Beobachtung:** Aufbauauswahl über große Karten mit Suche, Filter und Detailbereich; Präsentationszuordnung am Medium über Radioliste ohne Thumbnails; CMS-Bildwahl über bebildertes, durchsuchbares Auswahlfeld. Der visuelle Picker bietet „Übernehmen“, die Radioliste „Zuordnen“. Das CMS zeigt die Website-Freigabe direkt am Bild. + +**Auswirkung:** Wiedererkennen, Vorauswahl und Prüfung der Eignung kosten je Kontext unterschiedlich viel Aufmerksamkeit. Gerade bei Präsentationsbildern erschwert die textbasierte Liste den visuellen Vergleich. + +**Prüfziel für den späteren Entwurf:** Gemeinsame Interaktionsregeln für Suche, Ergebnisdarstellung, Auswahl, Detailprüfung und Bestätigung. Fachlich unterschiedliche erlaubte Arten und Fassungen müssen erhalten bleiben. + +**Belege:** B13, B17, B38; dokumentarisch bestätigt durch die Informationsbasis vom 19.11. + +![Visueller Materialpicker mit Detailbereich](38-materialpicker-auswahl.jpg) + +### UX-07 · P2 · Ergebnisse beginnen zu spät; Filter und Hilfetexte dominieren + +**Beobachtung:** Die Medienübersicht zeigt zehn Auswahlfilter zusätzlich zur Suche und einen längeren Erklärungstext. Die ersten Karten beginnen ungefähr bei zwei Dritteln der sichtbaren Höhe. Auch die Listenansicht übernimmt den großen Kopf. Im Modul stehen über dem Aufbau mehrere Aktions- und Erklärungsebenen; die erste Reihe zeigt im Wesentlichen zwei Bestandteile. + +**Auswirkung:** Häufiges Suchen, Vergleichen und Sortieren führt zu vermeidbaren Scrollwegen. Der Wechsel auf „Liste“ schafft noch keinen ausreichend kompakten Bestandsarbeitsplatz. + +**Prüfziel für den späteren Entwurf:** Häufige Filter und aktive Einschränkungen schnell erfassbar halten; seltene Optionen und längere Erklärungen bedarfsgerecht zugänglich machen. Karten- und Listenansicht nach realem Vergleichsbedarf beurteilen. + +**Belege:** B07–B09, B24, B42. + +![Medienübersicht mit hohem Filterkopf](42-medien-anlegen-ohne-reaktion.jpg) + +### UX-08 · P2 · Klassifikation erzeugt lange Auswahlstrecken + +**Beobachtung:** Im Moduldialog werden 19 Werte aus vier Dimensionen untereinander angeboten. Bereits diese kleine Ausgangsmenge benötigt Scrollen. Am Lizenzartikel erscheinen dieselben Themen als eng umbrochene Checkboxfolgen. Die Medienfilter bieten Fachsäule separat und nochmals innerhalb der Einordnung an. + +**Auswirkung:** Zugeordnete Werte sind schwer zusammenfassend zu erfassen; mit wachsenden Dimensionen steigt der Suchaufwand. Zuordnung und Übersicht sind je Objekt anders gestaltet. + +**Prüfziel für den späteren Entwurf:** Dimensionen verständlich gruppieren, vorhandene Zuordnungen auf einen Blick zeigen und größere Wertemengen gezielt durchsuchen können. Kleine feste Auswahlen dürfen weiterhin einfache Checkboxen verwenden; die Schwierigkeit liegt hier in Anordnung, Wiederholung und Wachstum. + +**Belege:** B06, B27, B42. + +### UX-09 · P2 · CMS zeigt zu viel Strukturmechanik gleichzeitig + +**Beobachtung:** Abschnitt, Rasterauswahl, Abschnittsgestaltung, Rasterplatz, Widgetrahmen und Widgetvorschau liegen ineinander. Schon der erste Abschnitt beansprucht fast die gesamte sichtbare Arbeitshöhe. „Alle einklappen“ erzeugt dagegen eine gut lesbare kompakte Struktur. Der Widgetdialog besitzt eigene lange Inhalte und eine weitere Vorschau darunter. + +**Auswirkung:** Die Person arbeitet häufig an einzelnen Inhalten, muss dabei aber viele Struktur- und Konfigurationsrahmen durchqueren. Gesamtstruktur und Inhaltsbearbeitung sind schwer gleichzeitig im Blick zu halten. + +**Prüfziel für den späteren Entwurf:** Zwischen Strukturüberblick, ausgewähltem Inhalt und kontextbezogenen Einstellungen klar unterscheiden; den kompakten Aufbau als bereits vorhandene Stärke nutzen. Noch keine Festlegung auf eine konkrete neue Bildschirmkomposition. + +**Belege:** B15, B16, B19. + +![Kompakte CMS-Struktur mit Revisionen](19-cms-struktur-revisionen.jpg) + +### UX-10 · P2 · Tabellen benötigen schon bei kleinen Beständen horizontales Scrollen + +**Beobachtung:** Die Modultabelle mit nur drei Spalten schneidet bei 1440 px Teile der rechten Spalte ab. Lange Namen und ausformulierte Statusangaben verbreitern die Tabelle. Die Benutzerliste wird durch die zahlreichen Rollen ebenfalls breiter als der Inhaltsbereich. + +**Auswirkung:** Angaben eines Objekts lassen sich nicht ohne Verschieben vollständig prüfen. Dies begrenzt die gewünschte effiziente Desktopbedienung bereits vor einem großen Datenbestand. + +**Prüfziel für den späteren Entwurf:** Spalten nach Aufgabe priorisieren, lange Inhalte sinnvoll umbrechen oder zusammenfassen und volle Angaben ohne Orientierungsverlust zugänglich machen. + +**Belege:** B22, B45. + +### UX-11 · P2 · Katalogbeziehungen werden dargestellt, aber kaum als Arbeitswege nutzbar + +**Beobachtung:** Lizenzartikel zeigt Bestand und zugehöriges Angebot als Text; Angebotsdetails zeigen Lizenzartikel und Rechteprofil ebenfalls als Text. Die enthaltene Trainerunterlage erscheint im Artikel mehrfach ohne gut erkennbaren Herkunftspfad. Redaktionelle Felder am Lizenzartikel haben kaum sichtbare Grenzen, Beschriftungen und Leerhinweise laufen ineinander. Die Angabe „Keine Angabe“ lässt den tatsächlich aus der Quelle übernommenen Wert nicht erkennen. + +**Auswirkung:** Die Person muss für Änderungen zurück in die Navigation und die genannten Objekte erneut suchen. Herkunft, eigene Abweichung und wirksamer Wert sind schwer unterscheidbar. Wiederverwendung kann wie ein unklarer Doppeleintrag wirken. + +**Prüfziel für den späteren Entwurf:** Beziehungen als direkt benutzbare Verknüpfungen mit Herkunft und Fassung darstellen; Quelle, wirksame Angabe und eigene Überschreibung verständlich zeigen. Wiederholte Verwendungen müssen fachlich erhalten bleiben. + +**Belege:** B27, B30, B32; Auflösungsregeln in der Informationsbasis, Abschnitt „Auflösung“. + +![Lizenzartikel mit schwer erkennbarer Redaktion](27-lizenzartikel-detail.jpg) + +### UX-12 · P2 · Sichtbare Aktionen passen nicht eindeutig zum aktuellen Zustand + +**Beobachtung:** Ein bereits als aktiv ausgewiesenes Angebot bietet prominent „Fassung aktivieren“. Ein veröffentlichter Artikel zeigt „Stand veröffentlichen“ und „Stand zurückziehen“ mit gleicher visueller Gewichtung. Ein Programm ohne offenen Entwurf bietet „Entwurf verwerfen“. Im Modul-/Programmarbeitsplatz werden Vorschau und Status mehrfach wiederholt. + +**Auswirkung:** Die Oberfläche verlangt zusätzliche Interpretation: Was ist jetzt sinnvoll, was ändert sich und welches Objekt betrifft es? Eine gegebenenfalls nachfolgende Bestätigung kann helfen, ersetzt jedoch keine klare Orientierung vor dem Klick. + +**Prüfziel für den späteren Entwurf:** Handlung, Gegenstand und erwartete Wirkung am aktuellen Zustand ausrichten. Die nachgelagerten Bestätigungen und tatsächlichen Zustandswechsel wurden bewusst nicht ausgeführt und sind noch zu prüfen. + +**Belege:** B24, B27, B32. + +### UX-13 · P2 · Einstieg und Navigation bilden den täglichen Aufgabenwechsel schwach ab + +**Beobachtung:** Das Dashboard bietet im geprüften Konto nur Willkommen und Abmelden. Der nützlichere Arbeitsplatz liegt darunter im Bereich Inhalte und betrifft ausschließlich Programme und Module. CMS-Seiten, Website-Navigation und Benutzer stehen ungruppiert vor Inhalte und Katalog. Module/Programme haben zugleich eigene Tabellen und den gemeinsamen Arbeitsplatz. Globale Suche ist vorhanden und liefert passende Ergebnisse nach Objekttyp. + +**Auswirkung:** Der bevorzugte Einstieg und die Beziehung zwischen Arbeitsansicht und Objekttyp sind unklar. Eine Person mit mehreren Aufgabenbereichen erhält keine Übersicht über jüngste Arbeit oder anstehende nächste Schritte. + +**Prüfziel für den späteren Entwurf:** Eine verständliche gemeinsame Orientierung über Arbeitskontexte und Aufgaben hinweg. Noch nicht gebaute Shop- und Kundenabläufe gehören ins spätere Gesamtkonzept, wurden aber nicht als bestehende Oberflächen bewertet. + +**Belege:** B01, B02, B22, B23, B44, B46; Betreiberkontext. + +### UX-14 · P2 · Visuelle Komponenten wirken wie mehrere Produkte + +**Beobachtung:** CMS und klassische Filament-Masken nutzen gerundete Felder, ruhige Container und kleinere Schaltflächen. Aufbauarbeitsplätze und Picker zeigen scharfkantige Rahmen, größere Schaltflächen, eine andere Überschriftenanmutung und gelbe Unterstreichungen. Am Lizenzartikel sind Eingabeflächen teilweise kaum erkennbar. Hier unterscheiden sich auch Fokus- und Dialogverhalten. + +**Auswirkung:** Visuell ähnliche Absichten werden unterschiedlich signalisiert. Die Person kann Interaktionen nicht zuverlässig von einem Bereich auf den nächsten übertragen. + +**Prüfziel für den späteren Entwurf:** Gemeinsame grundlegende Komponenten für Felder, Dialoge, Aktionshierarchie, Status, Abstände und Fokus. Die attraktive öffentliche Markeninszenierung braucht im Verwaltungsarbeitsplatz eine zum Arbeitszweck passende Dosierung. + +**Belege:** B16, B19, B24, B27, B38, B43. + +### UX-15 · P3 · Sprache und Bedeutungen sind nicht durchgängig vereinheitlicht + +**Beobachtung:** „Abstand ansehen ansehen“ entsteht aus Objektname und angehängter Aktion. „Übungen und Kurse“ steht in Erklärungen neben den Navigationsbegriffen Module und Programme. „Entwurf egal“, „Context“, technische Ausgabeklassen und Verweise wie „ADR-29“ erscheinen neben redaktionellen Alltagsbegriffen. „6 Verwendungen“ öffnet beim Medium eine längere Liste mit mehreren historischen Fassungen desselben Programms; die Zähleinheit wird nicht erläutert. + +**Auswirkung:** Die Person muss Begriffe und Zählweise erschließen. Unterschiedliche fachliche Dinge dürfen unterschiedliche Namen haben; dieselbe Bedeutung sollte jedoch nicht je Maske neu formuliert werden. + +**Prüfziel für den späteren Entwurf:** Einheitliches redaktionelles Vokabular und konkrete Aktionsbeschriftungen. Technische und architektonische Erläuterungen nur dort zeigen, wo sie eine tatsächliche Entscheidung unterstützen. + +**Belege:** B20, B30, B38, B42; vollständige Verwendungsansicht im Audit geöffnet. + +## Bedienwege und Anzahl der Aktionen + +Die Zählung erfasst konkrete Bedienaktionen bis zu einem beobachteten Zustand. Eine Texteingabe zählt als eine Aktion; Scrollen und Ladezeit sind nicht als Klicks verrechnet. Dies sind keine Messungen mit echten Anwendern und keine vollständigen Erfolgsquoten. Schreibende Abschlüsse wurden nicht ausgeführt. + +| Aufgabe und Ausgangspunkt | Geprüfter Weg | Beobachtete Aktionen | Grenze / zusätzlicher Aufwand | +|---|---|---|---| +| Medium über dessen Namen finden; Ausgangspunkt beliebige Verwaltungsseite | Medien → Suche „Lara“ → Titel „Lara im Park“ | 2 Klicks + 1 Texteingabe | Bearbeitbare Beschreibung erreicht; Speichern nicht ausgeführt | +| Verwendungen vom geöffneten Medium prüfen | Verwendung → „6 Verwendungen“ aufklappen | 2 Klicks | Verknüpfte Module/Programme sichtbar; Zählweise umfasst unterschiedliche Ebenen | +| Bestandsteil wählen; Ausgangspunkt andere Verwaltungsseite | Arbeitsplatz → Modul → Bestandteil hinzufügen → Material markieren | 4 Klicks ohne Such- oder Filtereingabe | „Übernehmen“ und „Entwurf speichern“ werden angeboten; beide nicht ausgeführt. Bei sechs Einzelmaterialien muss der weitere Ablauf erst praktisch vermessen werden | +| Beschreibung eines geöffneten Moduls erreichen | Modul bearbeiten → Beschreibung ist Standardtab | 1 Klick | Eingabe und Übernehmen wären nachgelagert; Dialog erklärt eine direkte Speicherung der Angaben | +| Klassifikation eines geöffneten Moduls erreichen | Modul bearbeiten → Einordnung | 2 Klicks | 19 Werte, zusätzliche Scrollstrecke; Abschluss nicht ausgeführt | +| Lokale Kontextbeschreibung eines Bestandteils erreichen | Bearbeiten am Bestandteil | 1 Klick | Eigene Beschreibung/Rolle sichtbar; sechs konkurrierende Folgeaktionen | +| CMS-Widgetinhalt erreichen; Ausgangspunkt andere Verwaltungsseite | Seiten → Seite → Bearbeiten am Widget | 3 Klicks plus nötiges Scrollen | „Übernehmen“, „Entwurf speichern“, „Vorschau“ und „Veröffentlichen“ sind getrennte sichtbare Schritte; nicht als vollständiger Schreibablauf getestet | +| CMS-Bildwahl öffnen; Ausgangspunkt Seiteneditor | Widget bearbeiten → Medien → Bildauswahl | 3 Klicks | Suchfähige Auswahl mit Thumbnails und Freigabestatus erreicht | +| Stammdaten eines Testmitglieds erreichen | Benutzer → Testmitglied | 2 Klicks | Kein umfassender Überblick über Bestellungen und Lizenzen; vollständiger Bereich laut Betreiber noch nicht gebaut | + +Die größte erkennbare Reibung entsteht nicht allein durch Klickanzahl. Sie entsteht durch Scrollstrecken, erneut nötige Orientierung und Zweifel an der Wirkung einer Handlung. Eine weitere Beschleunigung durch Mehrfachauswahl ist für den Aufbau prüfenswert, aber fachliche Rollen und Fassungen je Verwendung müssen dabei erhalten bleiben. Dies ist noch keine festgelegte Interaktionsregel. + +## Was als Grundlage erhalten bleiben sollte + +1. Gemeinsamer visueller Arbeitsplatz für Module und Programme. +2. Materialsuche mit Karten, Detailprüfung und sichtbaren Fassungen. +3. Verweise auf vorhandene Medien und kontextbezogene Rollen. +4. Verwendungsnachweise mit direktem Absprung in Module und Programme. +5. Sichtbare Trennung von freigegebenem Stand und Bibliotheksstand – nach Korrektur der widersprüchlichen Aussagen. +6. CMS-Rasterdarstellung, kontextbezogene Widgetdialoge und Bildsuche mit Thumbnails. +7. Echte CMS-Gerätevorschau und Revisionen mit Bearbeiter und Zeitpunkt. +8. Alternative Auf-/Ab-Aktionen zu Drag-and-drop. +9. Klassifikation als Mehrfachzuordnung sowie getrennte fachliche und technische Medienart. +10. Bereits dokumentierte Trennung redaktioneller, fachlicher und kommerzieller Änderungen. + +## Offene Prüflücken + +| Bereich | Was noch nicht belegt ist | Nötige Grundlage | +|---|---|---| +| Kombinationen und Pakete | Sinnvolles Zusammenstellen, verschachtelte Bearbeitung, Versionen und praktische Nutzbarkeit | Gemeinsam nachvollziehbarer Beispielablauf; laut Betreiber derzeitige Nutzungshürde | +| Speichern und Freigeben | Rückmeldung, Fehler, Auswirkungen, Wiederherstellung, versehentlicher Verlust, Rechteprüfung | Gezielter Test an ausdrücklich disponiblen Daten mit tatsächlichen Schreibvorgängen | +| Medienanlage | Anlage nach dem blockierten Einstieg, Verarbeitung, Fehlerbehandlung, große Uploads | Funktionierender Einstieg; anschließend freigegebener Testupload | +| Trainervorschau | Ursache und genaue Regel der 6/3-Abweichung; Übereinstimmung mit tatsächlicher Mitgliederansicht | Datenstand und Vorschauabsicht klären, danach End-to-End-Prüfung | +| Große Bestände | Paginierung im visuellen Picker, Auswahl über viele Treffer, Performance, gespeicherte Ansichten | Repräsentativer größerer Bestand | +| Barrierefreiheit | Vollständige Tastaturbedienung, Dialogsemantik, Statusansagen, Kontraste, Zoom | Gezielte zusätzliche Prüfung; der bestätigte Fokusfehler benötigt bereits Korrektur | +| Rollen | Unterschiede zwischen Redaktion, Fachprüfung, Katalog und Kundenbetreuung | Prüfung mit repräsentativen Konten; aktuelles Testkonto besitzt mehrere Rollen | +| Shop, Sonderrabatte, Lizenzmanagement, umfassende Mitgliederverwaltung | Reale Bedienabläufe noch nicht vorhanden | Laut Betreiber noch nicht gebaut; Dokumentation liefert den erwarteten Umfang | +| Trainingspläne | Eigenständiger aktueller Verwaltungsarbeitsplatz nicht aufgefunden | Spätere Zieldefinition im Gesamtkonzept; keine Erfindung eines neuen Fachmodells im Audit | + +## Konsequenz für die weitere gemeinsame Arbeit + +Vor der visuellen Auswahl sollten die P1-Befunde als getrennte Punkte bestätigt beziehungsweise fachlich aufgeklärt werden. Das nachfolgende Zielkonzept muss den gesamten Verwaltungsalltag aufnehmen, einschließlich späterer Angebots-, Rabatt-, Kunden- und Lizenzarbeit. Es darf aus dem heutigen schmalen Menü keinen dauerhaft schmalen Zielumfang ableiten. + +Die nächste Phase kann gemeinsame visuelle Richtungen für Orientierung, Objektarbeitsplatz, Auswahl und Zustandsführung erarbeiten. Sie muss die dokumentierten Klassen A/B/C, CMS-Revisionen, Rechte und Datenbeziehungen erhalten und den Ein-Personen-Alltag unterstützen. In diesem Audit wurden weder eine Designrichtung gewählt noch verbindliche Cursor-Regeln, Implementierungsaufträge oder ein neues Verwaltungsframework festgelegt. + +**Vollständige aktuelle Bildschirmbelege mit Kurznotizen:** [Belegkatalog](Belege.md). diff --git a/docs/ux/verwaltung/audit/cms-nachpruefung/01-anmeldung-erforderlich.png b/docs/ux/verwaltung/audit/cms-nachpruefung/01-anmeldung-erforderlich.png new file mode 100644 index 0000000..96e1047 Binary files /dev/null and b/docs/ux/verwaltung/audit/cms-nachpruefung/01-anmeldung-erforderlich.png differ diff --git a/docs/ux/verwaltung/audit/cms-nachpruefung/README.md b/docs/ux/verwaltung/audit/cms-nachpruefung/README.md new file mode 100644 index 0000000..8a2fad2 --- /dev/null +++ b/docs/ux/verwaltung/audit/cms-nachpruefung/README.md @@ -0,0 +1,11 @@ +# Zugriff bei der CMS-Nachprüfung + +Stand: 19.11.2026. Einziger neuer beobachteter Zustand dieses Zugriffsversuchs: Anmeldung erforderlich. Kein neuer CMS-Audit. + +| Schritt | Aktion | Zustand | +|---|---|---| +| 1 | Vorhandene Verwaltungssitzung öffnen und „Seiten“ aufrufen | Auf Anmeldung umgeleitet; weitere CMS-Prüfung blockiert | + +![Anmeldung nach abgelaufener Sitzung](01-anmeldung-erforderlich.png) + +Die Aufnahme wurde direkt aus dem In-App-Browser gespeichert und anschließend als lokale Datei betrachtet. Keine Anmeldedaten eingegeben; keine Inhaltsänderung, Freigabe oder Veröffentlichung. Die bisherigen CMS-Befunde werden in [Dokument 11](../../11-cms-pruefbedarf.md) mit ihrem ursprünglichen Belegstatus zusammengefasst. diff --git a/docs/ux/verwaltung/bilder/aufbau-01-strukturliste-kontext.png b/docs/ux/verwaltung/bilder/aufbau-01-strukturliste-kontext.png new file mode 100644 index 0000000..9fb1096 Binary files /dev/null and b/docs/ux/verwaltung/bilder/aufbau-01-strukturliste-kontext.png differ diff --git a/docs/ux/verwaltung/bilder/aufbau-02-struktur-detailbereich.png b/docs/ux/verwaltung/bilder/aufbau-02-struktur-detailbereich.png new file mode 100644 index 0000000..622934f Binary files /dev/null and b/docs/ux/verwaltung/bilder/aufbau-02-struktur-detailbereich.png differ diff --git a/docs/ux/verwaltung/bilder/aufbau-03-inline-bearbeitung.png b/docs/ux/verwaltung/bilder/aufbau-03-inline-bearbeitung.png new file mode 100644 index 0000000..3fcbcd3 Binary files /dev/null and b/docs/ux/verwaltung/bilder/aufbau-03-inline-bearbeitung.png differ diff --git a/docs/ux/verwaltung/bilder/aufbau-kombiniert-v1.png b/docs/ux/verwaltung/bilder/aufbau-kombiniert-v1.png new file mode 100644 index 0000000..7fe2d95 Binary files /dev/null and b/docs/ux/verwaltung/bilder/aufbau-kombiniert-v1.png differ diff --git a/docs/ux/verwaltung/bilder/aufbau-zustaende-v1.png b/docs/ux/verwaltung/bilder/aufbau-zustaende-v1.png new file mode 100644 index 0000000..5f87264 Binary files /dev/null and b/docs/ux/verwaltung/bilder/aufbau-zustaende-v1.png differ diff --git a/docs/ux/verwaltung/bilder/auswahl-01-liste-detail-v2.png b/docs/ux/verwaltung/bilder/auswahl-01-liste-detail-v2.png new file mode 100644 index 0000000..8f7af6a Binary files /dev/null and b/docs/ux/verwaltung/bilder/auswahl-01-liste-detail-v2.png differ diff --git a/docs/ux/verwaltung/bilder/auswahl-01-liste-detail.png b/docs/ux/verwaltung/bilder/auswahl-01-liste-detail.png new file mode 100644 index 0000000..dc2ddd9 Binary files /dev/null and b/docs/ux/verwaltung/bilder/auswahl-01-liste-detail.png differ diff --git a/docs/ux/verwaltung/bilder/auswahl-02-raster-detail.png b/docs/ux/verwaltung/bilder/auswahl-02-raster-detail.png new file mode 100644 index 0000000..e3a0d28 Binary files /dev/null and b/docs/ux/verwaltung/bilder/auswahl-02-raster-detail.png differ diff --git a/docs/ux/verwaltung/bilder/auswahl-03-bestand-auswahl.png b/docs/ux/verwaltung/bilder/auswahl-03-bestand-auswahl.png new file mode 100644 index 0000000..bc883f7 Binary files /dev/null and b/docs/ux/verwaltung/bilder/auswahl-03-bestand-auswahl.png differ diff --git a/docs/ux/verwaltung/bilder/cms-01-struktur-bearbeitung.png b/docs/ux/verwaltung/bilder/cms-01-struktur-bearbeitung.png new file mode 100644 index 0000000..8d204c5 Binary files /dev/null and b/docs/ux/verwaltung/bilder/cms-01-struktur-bearbeitung.png differ diff --git a/docs/ux/verwaltung/bilder/cms-02-seitenflaeche-inspektor.png b/docs/ux/verwaltung/bilder/cms-02-seitenflaeche-inspektor.png new file mode 100644 index 0000000..a3245f6 Binary files /dev/null and b/docs/ux/verwaltung/bilder/cms-02-seitenflaeche-inspektor.png differ diff --git a/docs/ux/verwaltung/bilder/cms-03-einzelbearbeitung.png b/docs/ux/verwaltung/bilder/cms-03-einzelbearbeitung.png new file mode 100644 index 0000000..2092fc6 Binary files /dev/null and b/docs/ux/verwaltung/bilder/cms-03-einzelbearbeitung.png differ diff --git a/docs/ux/verwaltung/bilder/cms-weiterentwicklung-abschnitt-v1.png b/docs/ux/verwaltung/bilder/cms-weiterentwicklung-abschnitt-v1.png new file mode 100644 index 0000000..c115df9 Binary files /dev/null and b/docs/ux/verwaltung/bilder/cms-weiterentwicklung-abschnitt-v1.png differ diff --git a/docs/ux/verwaltung/bilder/cms-weiterentwicklung-baustein-v1.png b/docs/ux/verwaltung/bilder/cms-weiterentwicklung-baustein-v1.png new file mode 100644 index 0000000..2b20712 Binary files /dev/null and b/docs/ux/verwaltung/bilder/cms-weiterentwicklung-baustein-v1.png differ diff --git a/docs/ux/verwaltung/bilder/cms-weiterentwicklung-seitenaufbau-v1.png b/docs/ux/verwaltung/bilder/cms-weiterentwicklung-seitenaufbau-v1.png new file mode 100644 index 0000000..ce970f3 Binary files /dev/null and b/docs/ux/verwaltung/bilder/cms-weiterentwicklung-seitenaufbau-v1.png differ diff --git a/docs/ux/verwaltung/bilder/manifest.json b/docs/ux/verwaltung/bilder/manifest.json new file mode 100644 index 0000000..3e680ac --- /dev/null +++ b/docs/ux/verwaltung/bilder/manifest.json @@ -0,0 +1,281 @@ +{ + "date": "2026-11-19", + "method": "Integrated image generation", + "images": [ + { + "file": "richtung-arbeitsflaeche-kontext.png", + "source_file": "exec-5952758e-b348-484e-b11b-b7d6e134fdd3.png", + "status": "Bestaetigte Grundrichtung fuer nichtlineare Arbeit", + "size": [ + 1487, + 1058 + ], + "sha256": "149b01ed70bab051de05e883d4cbfbb0b2e3b959281fbeaa0633afe49a31a461" + }, + { + "file": "richtung-gefuehrter-ablauf.png", + "source_file": "exec-9e26faff-c7e3-4fb6-ac11-3fd3e307a567.png", + "status": "Bestaetigte Grundrichtung fuer lineare Arbeit", + "size": [ + 1487, + 1058 + ], + "sha256": "c41cb0388665ff969bee83a2ea39ec7cc3332d54d119f1119b4d730e0c8a26d6" + }, + { + "file": "richtung-ergebnis-zurueckgestellt.png", + "source_file": "exec-2f3d4c25-3710-4c00-8da1-61b63dfb18ba.png", + "status": "Fuer Angebotszusammenstellung zurueckgestellt", + "size": [ + 1487, + 1058 + ], + "sha256": "fca736e54715894ee9cd56eb8140651cbe0192f371d2a3c6fc99b47bf90f0034" + }, + { + "file": "richtung-kombiniert.png", + "source_file": "exec-c3a8878e-4162-47fc-a4de-888da5e2eac5.png", + "status": "Bestaetigte Verbindung der Bedienmuster, fachliche Bilddetails offen", + "size": [ + 1487, + 1058 + ], + "sha256": "c9118727dd2ab4752853199c1ce1be1557903eaa1cae17859832b3be93c75fee" + }, + { + "file": "auswahl-01-liste-detail.png", + "source_file": "exec-6f75c6fb-673c-484a-b312-aaa4eb8400af.png", + "status": "Als bevorzugte Listenbasis bestaetigt; Details weiter abzustimmen", + "size": [ + 1487, + 1058 + ], + "sha256": "b7cba68411d6691c4da6e2e1b9df38b062213d26b097639cbe1fb94fd184064c" + }, + { + "file": "auswahl-02-raster-detail.png", + "source_file": "exec-257649fe-bf8b-4b32-936f-7d5b9526aa89.png", + "status": "Nicht als Grundansicht gewaehlt; optionales Raster offen", + "size": [ + 1487, + 1058 + ], + "sha256": "d13df92ce312556faaabb0ae92e05e237e196c3f3fa0e0d6874bc653669e3ed3" + }, + { + "file": "auswahl-03-bestand-auswahl.png", + "source_file": "exec-87610118-9e4e-49fb-9a43-0b31d959ca8a.png", + "status": "Zurueckgestellt; Platz fuer Einordnung, Nutzung und Verwertung erforderlich", + "size": [ + 1487, + 1058 + ], + "sha256": "f1446d4ec39577e05b56f9359c015e1852f94739899db2bfc7ae1a8739eaafcd" + }, + { + "file": "auswahl-01-liste-detail-v2.png", + "source_file": "exec-d16eb725-356a-4ba7-9bc2-395fceb21ada.png", + "status": "Verfeinerung der bestaetigten Listenbasis; Informationsgruppen im Detail Entwurf", + "size": [ + 1487, + 1058 + ], + "sha256": "d67c7fdae03afcc8598f5fb0c6454a91844eb910fce1bc4064e3e47bfc423e60" + }, + { + "file": "aufbau-01-strukturliste-kontext.png", + "source_file": "exec-b57ff487-ea7b-423f-968e-91b87198ea55.png", + "status": "Gruppierung/Rahmen fuer bestaetigte Kombination uebernommen; Arbeitsaufteilung nicht alleinige Basis", + "size": [ + 1487, + 1058 + ], + "sha256": "135c86194d78117f4db9b01b79f1f10bf1bfac44e49a296c84b56a3f24faa944" + }, + { + "file": "aufbau-02-struktur-detailbereich.png", + "source_file": "exec-6fe9cb17-27ca-4ca1-b59f-a2ccc7e74426.png", + "status": "Arbeitsaufteilung als Grundlage bestaetigt, kombiniert mit Gruppierung aus Aufbauentwurf 1", + "size": [ + 1487, + 1058 + ], + "sha256": "e2625b8ab6375b4e51a2e6ee86c69ea72c5ad07d30df525fb3d633a2fea5862e" + }, + { + "file": "aufbau-03-inline-bearbeitung.png", + "source_file": "exec-9f86637a-b4da-4772-9fd5-ca8076f581d3.png", + "status": "Als Grundanordnung zurueckgestellt", + "size": [ + 1487, + 1058 + ], + "sha256": "de28e7a25954983a0086c6185b4c4592968ed9688ac390f69d41c523fc5c6007" + }, + { + "file": "aufbau-kombiniert-v1.png", + "source_file": "exec-c22dd81c-253e-4e1a-9eae-6d1cab44667e.png", + "status": "Konkretisierung der bestaetigten Kombination UX-D15; Detailausgestaltung weiterhin Entwurf", + "size": [ + 1487, + 1058 + ], + "sha256": "e00670cdd70bc9058eccde65c7eab91d900c3bc8b85dc6fb7dab92725b05b411" + }, + { + "file": "aufbau-zustaende-v1.png", + "source_file": "exec-2d7d03f9-d147-4a9d-af85-05add0bf4303.png", + "status": "Fortfuehrung von UX-D15; Speicher- und Zustandsregeln in Dokument 07 sind neuer Entwurf zur Abstimmung", + "size": [ + 1486, + 1059 + ], + "sha256": "8e58b88b3952517e3fb9a80fe7d32f9fce6fd967f498fb6feea6b2dd3e82bdca" + }, + { + "file": "redaktion-01-uebersicht.png", + "source_file": "exec-67f551a5-4ea4-4844-a438-9cca76fbacc5.png", + "status": "Als aufgeraeumte Grundlage gewaehlt UX-D22; gemeinsame Register statt erzwungener gleichzeitiger Text-Medienansicht", + "display_order_in_editorial_set": 1, + "size": [ + 1487, + 1058 + ], + "sha256": "7be73432a0231f2845d572b6a7358677182c1c5c40d51beef1eb1973632ccff2" + }, + { + "file": "redaktion-02-navigator-detail.png", + "source_file": "exec-db00e4c3-10da-4f5f-b1bb-a2731214e718.png", + "status": "Urspruenglicher Vergleich; nicht als Grundlage gewaehlt", + "display_order_in_editorial_set": 2, + "size": [ + 1488, + 1057 + ], + "sha256": "6ca44d1e59241b64fce0a350c7d9784acad95e00a519d30d65cdf17ada76f332" + }, + { + "file": "redaktion-03-direkt-kontext.png", + "source_file": "exec-76afb26f-77bc-42cb-be90-d79d7510b613.png", + "status": "Urspruenglicher Vergleich; nicht als Grundlage gewaehlt", + "display_order_in_editorial_set": 3, + "size": [ + 1487, + 1058 + ], + "sha256": "0637c0d1386f28a78a05a033d4fec3b0cd48ee3ff5964139b4a90652d5e9dfde" + }, + { + "file": "redaktion-register-medium-v1.png", + "source_file": "exec-7105f0f2-1d14-4685-b07f-fdeaae7da995.png", + "status": "Fortfuehrung der gewaehlten Basis UX-D22 am Unterrichtsfilm; gemeinsame Register und Detailausgestaltung weiterhin Entwurf", + "size": [ + 1487, + 1058 + ], + "sha256": "9eaa95f216accb536c89f2501ef7fdb8bbe807afd1bb98238aed61c75c7e21bd" + }, + { + "file": "cms-01-struktur-bearbeitung.png", + "source_file": "exec-83acd24b-be63-4e54-bb8f-2907bceef528.png", + "status": "Erster CMS-Vergleich; Raster/Konfigurationstiefe danach konkretisiert, nicht als vollstaendige Zielreferenz ausgewaehlt", + "display_order_in_cms_set": 1, + "size": [ + 1487, + 1058 + ], + "sha256": "71295147ca230c3d9bcfc3fc28237506f4eb26db30df7da556285409166dddcc" + }, + { + "file": "cms-02-seitenflaeche-inspektor.png", + "source_file": "exec-90f2f509-baf9-4a27-876d-60646b9c8816.png", + "status": "Erster CMS-Vergleich; Raster/Konfigurationstiefe danach konkretisiert, nicht als vollstaendige Zielreferenz ausgewaehlt", + "display_order_in_cms_set": 2, + "size": [ + 1511, + 1041 + ], + "sha256": "d7d582030fa88fafbc8665eef2beb77137da6fe155a11a5defabb16a1cace399" + }, + { + "file": "cms-03-einzelbearbeitung.png", + "source_file": "exec-876b6ecc-317e-4a43-aff8-ff2613851ce6.png", + "status": "Erster CMS-Vergleich; Raster/Konfigurationstiefe danach konkretisiert, nicht als vollstaendige Zielreferenz ausgewaehlt", + "display_order_in_cms_set": 3, + "size": [ + 1486, + 1059 + ], + "sha256": "0783865414dc2489a6cf052535abc8beb318d3be8ec6c7d4e6ae684f6ca2896d" + }, + { + "file": "cms-weiterentwicklung-seitenaufbau-v1.png", + "source_file": "exec-e51c5dc3-00a9-4b0b-afe3-c5f19d8f8e56.png", + "status": "Zusammengehoeriger Arbeitszustand eines weiterentwickelten CMS-Vorschlags; noch abzustimmen, keine neue Live-Abnahme", + "working_state": "Seitenaufbau", + "size": [ + 1511, + 1041 + ], + "sha256": "f4d0be6c09cfb68cd17cf5ff0689c73e074d4e11aa8536f01aaa993ef4930377" + }, + { + "file": "cms-weiterentwicklung-abschnitt-v1.png", + "source_file": "exec-e8c9c0f6-87b4-4b0a-836c-33e0da915ab1.png", + "status": "Zusammengehoeriger Arbeitszustand eines weiterentwickelten CMS-Vorschlags; noch abzustimmen, keine neue Live-Abnahme", + "working_state": "Abschnitt gestalten; korrigierter Rasterknopf 4", + "size": [ + 1511, + 1041 + ], + "sha256": "a26d8bbcb25cc3a27ac699da29574f0500613409334061b5afe3aea74e8a851a" + }, + { + "file": "cms-weiterentwicklung-baustein-v1.png", + "source_file": "exec-2abaf986-69fc-4be0-be20-4bb702d94ccf.png", + "status": "Zusammengehoeriger Arbeitszustand eines weiterentwickelten CMS-Vorschlags; noch abzustimmen, keine neue Live-Abnahme", + "working_state": "Baustein konfigurieren", + "size": [ + 1511, + 1041 + ], + "sha256": "826f986e0270933ad7d72df870d356ac2bf77cf9f855e01d22fb54aa9ede56d3" + }, + { + "file": "webpraesenz-01-register-menueeditor.png", + "source_file": "exec-b5bd6965-2cbd-4ef6-b986-af190c089bef.png", + "status": "Vom Auftraggeber bevorzugt; genaue Kombination und Details noch abzustimmen; keine Implementierung", + "display_order_in_website_set": 1, + "arrangement": "Register und fester Menüeditor", + "size": [ + 1511, + 1041 + ], + "sha256": "343e09eb614a8f4863057373c13f6aa91dec533ea5cf7278cedbfb68bfaf04ed" + }, + { + "file": "webpraesenz-02-seiten-menues.png", + "source_file": "exec-54d245d6-2d9e-45bd-bea8-8423a5f838a8.png", + "status": "Vergleichsvariante; in der jüngsten Rückmeldung nicht als bevorzugt genannt, keine formale Ablehnung", + "display_order_in_website_set": 2, + "arrangement": "Seitenbestand und Menü nebeneinander", + "size": [ + 1511, + 1041 + ], + "sha256": "749f5c0770cf5e502806fb8392c39604fb698cf2d3824f0f6893392052fb2b31" + }, + { + "file": "webpraesenz-03-direkt-menue.png", + "source_file": "exec-b8d8e80e-5dae-48c8-ace3-19d3e9909ad1.png", + "status": "Vom Auftraggeber bevorzugt; genaue Kombination und Details noch abzustimmen; keine Implementierung", + "display_order_in_website_set": 3, + "arrangement": "Direkte Bearbeitung in breiter Menüliste", + "size": [ + 1511, + 1041 + ], + "sha256": "2e09063f09dd4cd6339dc4b15761b2f752a074be2c5c21887980f34c6ef6cd92" + } + ] +} diff --git a/docs/ux/verwaltung/bilder/redaktion-01-uebersicht.png b/docs/ux/verwaltung/bilder/redaktion-01-uebersicht.png new file mode 100644 index 0000000..b36dc52 Binary files /dev/null and b/docs/ux/verwaltung/bilder/redaktion-01-uebersicht.png differ diff --git a/docs/ux/verwaltung/bilder/redaktion-02-navigator-detail.png b/docs/ux/verwaltung/bilder/redaktion-02-navigator-detail.png new file mode 100644 index 0000000..d3b7fe1 Binary files /dev/null and b/docs/ux/verwaltung/bilder/redaktion-02-navigator-detail.png differ diff --git a/docs/ux/verwaltung/bilder/redaktion-03-direkt-kontext.png b/docs/ux/verwaltung/bilder/redaktion-03-direkt-kontext.png new file mode 100644 index 0000000..ffb3b2a Binary files /dev/null and b/docs/ux/verwaltung/bilder/redaktion-03-direkt-kontext.png differ diff --git a/docs/ux/verwaltung/bilder/redaktion-register-medium-v1.png b/docs/ux/verwaltung/bilder/redaktion-register-medium-v1.png new file mode 100644 index 0000000..eeef9c2 Binary files /dev/null and b/docs/ux/verwaltung/bilder/redaktion-register-medium-v1.png differ diff --git a/docs/ux/verwaltung/bilder/richtung-arbeitsflaeche-kontext.png b/docs/ux/verwaltung/bilder/richtung-arbeitsflaeche-kontext.png new file mode 100644 index 0000000..608095d Binary files /dev/null and b/docs/ux/verwaltung/bilder/richtung-arbeitsflaeche-kontext.png differ diff --git a/docs/ux/verwaltung/bilder/richtung-ergebnis-zurueckgestellt.png b/docs/ux/verwaltung/bilder/richtung-ergebnis-zurueckgestellt.png new file mode 100644 index 0000000..3ca5bcc Binary files /dev/null and b/docs/ux/verwaltung/bilder/richtung-ergebnis-zurueckgestellt.png differ diff --git a/docs/ux/verwaltung/bilder/richtung-gefuehrter-ablauf.png b/docs/ux/verwaltung/bilder/richtung-gefuehrter-ablauf.png new file mode 100644 index 0000000..4919a4b Binary files /dev/null and b/docs/ux/verwaltung/bilder/richtung-gefuehrter-ablauf.png differ diff --git a/docs/ux/verwaltung/bilder/richtung-kombiniert.png b/docs/ux/verwaltung/bilder/richtung-kombiniert.png new file mode 100644 index 0000000..11c38be Binary files /dev/null and b/docs/ux/verwaltung/bilder/richtung-kombiniert.png differ diff --git a/docs/ux/verwaltung/bilder/webpraesenz-01-register-menueeditor.png b/docs/ux/verwaltung/bilder/webpraesenz-01-register-menueeditor.png new file mode 100644 index 0000000..42fd3f1 Binary files /dev/null and b/docs/ux/verwaltung/bilder/webpraesenz-01-register-menueeditor.png differ diff --git a/docs/ux/verwaltung/bilder/webpraesenz-02-seiten-menues.png b/docs/ux/verwaltung/bilder/webpraesenz-02-seiten-menues.png new file mode 100644 index 0000000..e46a681 Binary files /dev/null and b/docs/ux/verwaltung/bilder/webpraesenz-02-seiten-menues.png differ diff --git a/docs/ux/verwaltung/bilder/webpraesenz-03-direkt-menue.png b/docs/ux/verwaltung/bilder/webpraesenz-03-direkt-menue.png new file mode 100644 index 0000000..d02c1a4 Binary files /dev/null and b/docs/ux/verwaltung/bilder/webpraesenz-03-direkt-menue.png differ diff --git a/docs/ux/verwaltung/generierung/aufbau-kombination.md b/docs/ux/verwaltung/generierung/aufbau-kombination.md new file mode 100644 index 0000000..d50f937 --- /dev/null +++ b/docs/ux/verwaltung/generierung/aufbau-kombination.md @@ -0,0 +1,40 @@ +# Kombinierter Aufbauarbeitsplatz + +Stand: 19.11.2026. Mit dem integrierten Bildgenerator erzeugte Konkretisierung der bestätigten Kombination: Arbeitsaufteilung aus Aufbauentwurf 2 mit Rahmen und Gruppierung aus Aufbauentwurf 1. Dies ist ein Diskussionsbild, keine implementierte Oberfläche. + +## Angehängte Referenzen + +1. ../bilder/aufbau-01-strukturliste-kontext.png +2. ../bilder/aufbau-02-struktur-detailbereich.png + +## Ausgabe + +../bilder/aufbau-kombiniert-v1.png + +## Exakter Generierungsprompt + +```text +Create realistic, production-quality UI designs with clear hierarchy, strong typography, intentional imagery, and purposeful spacing. +Use case ui-mockup. Produce ONE revised combined desktop administration design for Lara & Felix. Target1440x1024, one focused actual application frame, no browser chrome, no presentation board, no option numbers. German UI. Current date19November2026, no dates needed. +INPUTS: Image1 is prior "Strukturliste mit Kontexteditor", whose structural FRAMES/GROUPING the user likes. Image2 is prior "Kompakte Struktur mit großem Detailbereich", whose WORK ALLOCATION the user selected after explanation. Combine them rather than creating a new direction. Primary layout target is IMAGE2. Preserve its compact left structure and larger right editing area, but use IMAGE1's clear grouped containment for each referenced module and its read-only source children. +This is a visual discussion mockup, not implemented software. User has accepted this combination as design direction, not all fields or business workflows. +HARD INVARIANTS: preserve Laravel/Filament/Livewire feasibility, existing models, relationships, immutable released versions and rights. Compositions may reference media and other compositions; don't invent a fixed product hierarchy. Editing a use of a source must not silently edit source or every other occurrence. Offer variants, pricing and hierarchies are outside this screen. No shop preview, marketing cards or unrelated dashboard features. +SHELL FROM IMAGE2: narrow WHITE global nav approx200px, text Lara & Felix / Verwaltung, items Arbeitsplatz, Medien, Inhalte(selected), Angebote, Website, Kunden. Breadcrumb "Programme / Programm Abstand". Title "Programm Abstand". State "Änderungen noch nicht gespeichert" with restrained AMBER dot, never green success. Top quiet button "Programm-Vorschau" and ONE primary green "Entwurf speichern". Under header direct section tabs Aufbau(selected), Angaben, Einordnung, Präsentation, Verlauf. +WORKSPACE: narrow structure column about400px and broad right edit area for all remaining content. Aim about34%/66% split inside main workspace; sufficient left width for readable titles. No extra narrow permanent third panel. +Left header "Aufbau · 4 Bestandteile", small outlined "Hinzufügen". There are exactly4 ordered root occurrences: +1 Modul Abstand, Modul · Fassung 1 · Einstieg, SELECTED and expanded. +2 Modul Hilfe, Modul · Fassung 1, collapsed. +3 Eigene Grenzen erkennen, Modul · Fassung 1, collapsed. +4 Nur ein allgemeiner Hinweis, Text · Fassung 1. +Each root shows position number and small drag handle (not a checkbox). Use compact thumbnail/type icon and title, readable wrapping of longer titles, subtle modest8px group frames instead of flat ungrouped rows. No heavy shadows or giant gaps. +GROUPING FROM IMAGE1 applied in LEFT column: a single light neutral-outline frame encloses selected root1 and its displayed source children, so containment is unmistakable. Selected ROOT TITLE row alone has pale-blue background/thin blue selection marker; read-only children remain neutral. Under root1 a concise line "Inhalt der Quelle · Nur zur Ansicht", then indented short rows Trainerunterlage Abstand (Text) and Lara im Park (Unterrichtsfilm) with tiny thumbnail/icon. Children have NO drag handles and no edit affordance in this program context. Do not give child rows independent card borders or create accordion-in-accordion nesting. Root2 and3 may each have their own subtle group frame and disclosure, root4 simple equivalent row. All4roots visible. +A compact left bottom ordering line "Position 1 von 4" with up disabled/down enabled supports keyboard-accessible alternative to drag. Selected identity remains the root Modul Abstand, not a child. +RIGHT EDIT AREA FROM IMAGE2: heading Modul Abstand, short path "Verwendung in Programm Abstand", quiet Weitere Aktionen menu. Tabs "An dieser Stelle"(selected), "Quelle", "Vorschau". Under active tab short restrained scope notice "Gilt nur hier. Die Quelle bleibt unverändert." EXACTLY TWO local editable fields: +Rolle im Programm: Einstieg +Hinweis an dieser Stelle: Mit dem Thema Abstand beginnen. +Text input normal readable width and textarea3lines. NO repeated local save button or long global metadata form. The global Entwurf speichern is sole primary for shown structural working state. +Below a thin separator, read-only group heading "Referenz", row Modul Abstand · Fassung 1, quiet Quelle öffnen link. A small read-only summary of source children is optional; do not crowd or repeat the full tree unnecessarily. Keep global source information separate from local use edits. +Use same restrained professional language: navy#032551, ink#15243A, warmneutral#F7F6F2, white, muted#5D6A78, subtleline#DDE5E3, actiongreen#3B7B09 with white text, blue#1769AAselection and amber unsaved indicator. Readable Source Sans3-like14–16px body,28px title, precise alignment and compact human-scale spacing. Frames clarify ROOT GROUP BOUNDARIES; don't wrap the entire app in a rounded card or put cards inside cards. No playful underlines, huge placeholders, clipping or extraneous features. +Show a calm efficient editor in which operator can scan a grouped program structure and click successive occurrences to edit local data at a stable location. The combination should clearly be recognizable as layout2 plus structural grouping1, with correct amber unsaved state and generous detail area. +``` + diff --git a/docs/ux/verwaltung/generierung/aufbau-prompts.md b/docs/ux/verwaltung/generierung/aufbau-prompts.md new file mode 100644 index 0000000..18fe023 --- /dev/null +++ b/docs/ux/verwaltung/generierung/aufbau-prompts.md @@ -0,0 +1,106 @@ +# Bildgenerierung: Aufbauarbeitsplatz + +Stand: 19.11.2026. Drei unabhängige Diskussionsbilder mit dem integrierten Bildgenerator. Nummern entsprechen der tatsächlichen Anzeigereihenfolge im aktuellen Aufbauvergleich. Noch keine Anordnung gewählt und kein Implementierungsauftrag. + +## Angehängte Referenzen + +1. ../bilder/richtung-kombiniert.png – bestätigte visuelle Grundrichtung. +2. ../bilder/auswahl-01-liste-detail-v2.png – verfeinerte gewählte Listenbasis. +3. ../audit/39-bestandteil-bearbeiten.jpg – tatsächlich beobachtete lokale Bearbeitung. +4. ../audit/24-programm-aufbau.jpg – tatsächlich beobachteter Programmaufbau. + +## 1 – Strukturliste mit Kontexteditor + +Ausgabe: ../bilder/aufbau-01-strukturliste-kontext.png + +```text +Create realistic, production-quality UI designs with clear hierarchy, strong typography, intentional imagery, and purposeful spacing. +Use case ui-mockup. One independent focused desktop design concept for Lara & Felix ADMINISTRATION composition workspace. Target dimensions1440x1024, natural desktop ratio, no browser chrome, device frame or presentation board, no option numbers. Human-readable German UI. Current date19November2026; omit dates. +CONTEXT: user approved a coherent enterprise administration language, persistent workspace for regular nonlinear work and guided steps only for linear tasks. Selection uses LIST with thumbnails and a detail view. This task is the TARGET WORKSPACE AFTER choosing components: overview, local editing and ordering in modules/programs. No implementation, just visual discussion. +REFERENCES: image1 approved combined workspace language; image2 selected media picker language; image3 ACTUAL old local component editing dialog; image4 ACTUAL existing program composition. Use old screenshots for domain facts and pain-point grounding, comprehensively redesign clutter and nested modal editing. Preserve the approved calm visual language. +HARD INVARIANTS: Laravel/Filament/Livewire, current models, reference relationships, immutable released compositions and rights retained. Modules/programs are compositions that may contain media OR other compositions, no forced fixed product hierarchy. Different occurrences of a reused source may have different roles, order and local notes. Editing occurrence data MUST NOT silently edit the source or all usages. No invented pricing, licensing, commercial offer variants, shop preview, global new object types or business release rules. Defined fachlicher Inhaltstyp is distinct from technical media/file type, and use/exploitation information may exist; don't cram these into every row or declare rights from tags. +SAME EXAMPLE FOR EVERY CONCEPT: global nav narrow rail containing Arbeitsplatz, Medien, Inhalte(selected), Angebote, Website, Kunden. Truthful breadcrumb "Programme / Programm Abstand". Page title "Programm Abstand". This is an existing program being edited, not creating an offer, no onboarding wizard. Small unified edit-state line "Änderungen noch nicht gespeichert". ONE green PRIMARY action "Entwurf speichern" in the page header. One quiet supporting "Vorschau" action; do not show competing Publish/Activate actions. Saving does not publish. +Small direct section nav "Aufbau" selected, "Angaben", "Einordnung", "Präsentation", "Verlauf". Only build details active, not all long forms. +ROOT COMPOSITION contains exactly FOUR ordered occurrences: +1 "Modul Abstand" · Modul · Fassung1 · local role "Einstieg" — selected, expanded to show two read-only source children "Trainerunterlage Abstand" (Text) and "Lara im Park" (Unterrichtsfilm), visually clearly subordinate to the referenced module. +2 "Modul Hilfe" · Modul · Fassung1 — collapsed. +3 "Eigene Grenzen erkennen" · Modul · Fassung1 — collapsed. +4 "Nur ein allgemeiner Hinweis" · Text · Fassung1. +Small useful thumbnails when recognizable, restrained source/type icons for modules/text; no giant generic placeholder images or product cards. +Critical semantics of nested content: the current program references Modul Abstand Fassung1. Children displayed beneath that module are READ-ONLY source structure in this PROGRAM workspace. To edit a nested source, explicit source editor needed. Current selected item is ROOT occurrence1 "Modul Abstand", so editable role and note belong to its use in PROGRAMM ABSTAND, not the module's global definition or its child media. +Only two LOCAL editing controls for selected occurrence: "Rolle im Programm" text value "Einstieg", and "Hinweis an dieser Stelle" short textarea example "Mit dem Thema Abstand beginnen." Label this group "An dieser Stelle im Programm". Short explicit scope line "Gilt nur hier. Die Quelle bleibt unverändert." Show source identity separately as read-only "Quelle: Modul Abstand · Fassung1" with quiet "Quelle öffnen" link. Source preview or source facts always distinct from editable local use; no fields for global source description intermingled. +ORDERING: ordered rows with discreet drag handle and position indicator. Accessible alternate move-up/move-down or position controls for selected root occurrence are visibly available without drag. Show "Position1von4" with up disabled and down enabled; make this compact and subordinate, no full button wall on every row. Adding via "Bestandteil hinzufügen" opens the already selected reusable picker in a future implementation, don't open picker here. +CONTENT DENSITY: compact rows and manageable nesting; all4rootoccurrences and useful selected detail should fit without clipping main controls. Never depict a board of workflow status columns (didactic order is not Kanban status). Minimal repeated badges, no giant action/description bands, no dashboard metrics or unrelated feature inventory. +VISUAL LANGUAGE: white/warm neutral#F7F6F2, navy#032551, ink#15243A, muted#5D6A78, actiongreen#3B7B09 white text, subtleline#DDE5E3, blue#1769AA selected/inspection marker. Body14–16px readable Source Sans3-like sans, page title28px, modest8px radius, restrained line icons. Hierarchy through alignment, grouping, spacing and light dividers. No excessive shadows, nested cards, giant marketing preview, playful typography or decorative yellow underlines. +Focus one clear task and primary action. Field text and example grouping are illustrative, not new taxonomy or mandatory workflows. This is a discussion mockup, no tested keyboard or saving behavior claims. +DIRECTION NAME: "Strukturliste mit Kontexteditor". Main content below section tabs is a two-pane workspace: left about65% width ordered STRUCTURE LIST, right35% LOCAL CONTEXT EDITOR separated by a thin vertical line and subtle tint. This is the closest continuation of the approved context workspace. +List header "Aufbau" and outlined "Bestandteil hinzufügen". Root rows approx76px high. First selected root "Modul Abstand" has subtle blue selection marker and expanded source children indented beneath it with text "Inhalte aus Modul Abstand" and small read-only indicator; children are short44px rows, no editable controls or drag handles. Other roots compact collapsed with small disclosure chevron as appropriate. Each root has position number, restrained drag handle and title/type/version. A small inline local role label "Einstieg" for selected module, not a huge status pill. Keep component titles readable, not truncated to illegibility. +Right editor heading "Modul Abstand", read-only source line "Quelle: Modul Abstand · Fassung1" with a quiet "Quelle öffnen" link. A thin divider then local heading "An dieser Stelle im Programm", exactly the two editable local fields from common brief, and scope hint. Under fields a compact ordering section "Position1von4" with up/down controls, up disabled. At bottom one quiet overflow link "Weitere Aktionen" for removal/replace; no prominent delete CTA. No local save button: page-level Entwurf speichern remains clear primary, local edits visibly part of the same unsaved working state. +Use right pane for useful selected-item context rather than a marketing card or giant image. Root list and local editing should be simultaneously assessable. Ensure all4rootrows fit with first module's children expanded and header/footer remains in view. +``` + +## 2 – Kompakte Struktur mit großem Detailbereich + +Ausgabe: ../bilder/aufbau-02-struktur-detailbereich.png + +```text +Create realistic, production-quality UI designs with clear hierarchy, strong typography, intentional imagery, and purposeful spacing. +Use case ui-mockup. One independent focused desktop design concept for Lara & Felix ADMINISTRATION composition workspace. Target dimensions1440x1024, natural desktop ratio, no browser chrome, device frame or presentation board, no option numbers. Human-readable German UI. Current date19November2026; omit dates. +CONTEXT: user approved a coherent enterprise administration language, persistent workspace for regular nonlinear work and guided steps only for linear tasks. Selection uses LIST with thumbnails and a detail view. This task is the TARGET WORKSPACE AFTER choosing components: overview, local editing and ordering in modules/programs. No implementation, just visual discussion. +REFERENCES: image1 approved combined workspace language; image2 selected media picker language; image3 ACTUAL old local component editing dialog; image4 ACTUAL existing program composition. Use old screenshots for domain facts and pain-point grounding, comprehensively redesign clutter and nested modal editing. Preserve the approved calm visual language. +HARD INVARIANTS: Laravel/Filament/Livewire, current models, reference relationships, immutable released compositions and rights retained. Modules/programs are compositions that may contain media OR other compositions, no forced fixed product hierarchy. Different occurrences of a reused source may have different roles, order and local notes. Editing occurrence data MUST NOT silently edit the source or all usages. No invented pricing, licensing, commercial offer variants, shop preview, global new object types or business release rules. Defined fachlicher Inhaltstyp is distinct from technical media/file type, and use/exploitation information may exist; don't cram these into every row or declare rights from tags. +SAME EXAMPLE FOR EVERY CONCEPT: global nav narrow rail containing Arbeitsplatz, Medien, Inhalte(selected), Angebote, Website, Kunden. Truthful breadcrumb "Programme / Programm Abstand". Page title "Programm Abstand". This is an existing program being edited, not creating an offer, no onboarding wizard. Small unified edit-state line "Änderungen noch nicht gespeichert". ONE green PRIMARY action "Entwurf speichern" in the page header. One quiet supporting "Vorschau" action; do not show competing Publish/Activate actions. Saving does not publish. +Small direct section nav "Aufbau" selected, "Angaben", "Einordnung", "Präsentation", "Verlauf". Only build details active, not all long forms. +ROOT COMPOSITION contains exactly FOUR ordered occurrences: +1 "Modul Abstand" · Modul · Fassung1 · local role "Einstieg" — selected, expanded to show two read-only source children "Trainerunterlage Abstand" (Text) and "Lara im Park" (Unterrichtsfilm), visually clearly subordinate to the referenced module. +2 "Modul Hilfe" · Modul · Fassung1 — collapsed. +3 "Eigene Grenzen erkennen" · Modul · Fassung1 — collapsed. +4 "Nur ein allgemeiner Hinweis" · Text · Fassung1. +Small useful thumbnails when recognizable, restrained source/type icons for modules/text; no giant generic placeholder images or product cards. +Critical semantics of nested content: the current program references Modul Abstand Fassung1. Children displayed beneath that module are READ-ONLY source structure in this PROGRAM workspace. To edit a nested source, explicit source editor needed. Current selected item is ROOT occurrence1 "Modul Abstand", so editable role and note belong to its use in PROGRAMM ABSTAND, not the module's global definition or its child media. +Only two LOCAL editing controls for selected occurrence: "Rolle im Programm" text value "Einstieg", and "Hinweis an dieser Stelle" short textarea example "Mit dem Thema Abstand beginnen." Label this group "An dieser Stelle im Programm". Short explicit scope line "Gilt nur hier. Die Quelle bleibt unverändert." Show source identity separately as read-only "Quelle: Modul Abstand · Fassung1" with quiet "Quelle öffnen" link. Source preview or source facts always distinct from editable local use; no fields for global source description intermingled. +ORDERING: ordered rows with discreet drag handle and position indicator. Accessible alternate move-up/move-down or position controls for selected root occurrence are visibly available without drag. Show "Position1von4" with up disabled and down enabled; make this compact and subordinate, no full button wall on every row. Adding via "Bestandteil hinzufügen" opens the already selected reusable picker in a future implementation, don't open picker here. +CONTENT DENSITY: compact rows and manageable nesting; all4rootoccurrences and useful selected detail should fit without clipping main controls. Never depict a board of workflow status columns (didactic order is not Kanban status). Minimal repeated badges, no giant action/description bands, no dashboard metrics or unrelated feature inventory. +VISUAL LANGUAGE: white/warm neutral#F7F6F2, navy#032551, ink#15243A, muted#5D6A78, actiongreen#3B7B09 white text, subtleline#DDE5E3, blue#1769AA selected/inspection marker. Body14–16px readable Source Sans3-like sans, page title28px, modest8px radius, restrained line icons. Hierarchy through alignment, grouping, spacing and light dividers. No excessive shadows, nested cards, giant marketing preview, playful typography or decorative yellow underlines. +Focus one clear task and primary action. Field text and example grouping are illustrative, not new taxonomy or mandatory workflows. This is a discussion mockup, no tested keyboard or saving behavior claims. +STATE SEMANTICS: the line 'Änderungen noch nicht gespeichert' uses neutral text or a restrained amber dot, never a green success indicator. Keep typography 'Fassung 1' with readable spacing. No false saved or released success claim. +DIRECTION NAME: "Kompakte Struktur mit großem Detailbereich". Same program and same content, but a master-detail organization optimized for focused editing of many components. After global nav and header/section navigation, main workspace split into narrow internal STRUCTURE column about320px and broad EDIT AREA filling the remaining width. Do not add a third pane. Do not turn source content into marketing/product cards. +Internal left header "Aufbau · 4 Bestandteile" with compact add icon/button labeled "Hinzufügen". A very compact ordered tree lists all4rootitems with number and restrained handle/disclosure, tiny type icon or thumbnail, truncated only when unavoidable. Selected root Modul Abstand is expanded with two read-only child lines correctly indented and marked source content. No checkbox selection on these editing rows. Root2,3 collapsed, root4text. At bottom of internal outline a small selected-position control "Position 1 von 4" with arrow up disabled and arrow down enabled. +Broad main EDIT area begins with heading Modul Abstand, clear short path "Verwendung in Programm Abstand", then three small tabs "An dieser Stelle"(active), "Quelle", "Vorschau". Active tab shows the same two local fields: "Rolle im Programm" and "Hinweis an dieser Stelle", scope hint "Gilt nur hier. Die Quelle bleibt unverändert." Keep text input modest width, textarea only3lines. No wall of other metadata. +Below fields a thin divider and quiet read-only block "Referenz" with "Modul Abstand · Fassung 1" and one source link. Source children could be read as tiny one-line summary here only if not duplicate/clutter; prioritize calm edit space. One quiet "Weitere Aktionen" menu for replace/remove, no competing Save/Apply for pane. Page top Entwurf speichern is sole primary. +The user should feel able to click each outline entry and immediately edit its local usage without opening stacked dialogs or losing the whole sequence. Left tree establishes hierarchy, right area establishes scope and action. Maintain professional information density: avoid giant whitespace that resembles an empty form, but don't fill space with unnecessary cards. Main controls fit within1024px height. +``` + +## 3 – Direkte Bearbeitung im Aufbau + +Ausgabe: ../bilder/aufbau-03-inline-bearbeitung.png + +```text +Create realistic, production-quality UI designs with clear hierarchy, strong typography, intentional imagery, and purposeful spacing. +Use case ui-mockup. One independent focused desktop design concept for Lara & Felix ADMINISTRATION composition workspace. Target dimensions1440x1024, natural desktop ratio, no browser chrome, device frame or presentation board, no option numbers. Human-readable German UI. Current date19November2026; omit dates. +CONTEXT: user approved a coherent enterprise administration language, persistent workspace for regular nonlinear work and guided steps only for linear tasks. Selection uses LIST with thumbnails and a detail view. This task is the TARGET WORKSPACE AFTER choosing components: overview, local editing and ordering in modules/programs. No implementation, just visual discussion. +REFERENCES: image1 approved combined workspace language; image2 selected media picker language; image3 ACTUAL old local component editing dialog; image4 ACTUAL existing program composition. Use old screenshots for domain facts and pain-point grounding, comprehensively redesign clutter and nested modal editing. Preserve the approved calm visual language. +HARD INVARIANTS: Laravel/Filament/Livewire, current models, reference relationships, immutable released compositions and rights retained. Modules/programs are compositions that may contain media OR other compositions, no forced fixed product hierarchy. Different occurrences of a reused source may have different roles, order and local notes. Editing occurrence data MUST NOT silently edit the source or all usages. No invented pricing, licensing, commercial offer variants, shop preview, global new object types or business release rules. Defined fachlicher Inhaltstyp is distinct from technical media/file type, and use/exploitation information may exist; don't cram these into every row or declare rights from tags. +SAME EXAMPLE FOR EVERY CONCEPT: global nav narrow rail containing Arbeitsplatz, Medien, Inhalte(selected), Angebote, Website, Kunden. Truthful breadcrumb "Programme / Programm Abstand". Page title "Programm Abstand". This is an existing program being edited, not creating an offer, no onboarding wizard. Small unified edit-state line "Änderungen noch nicht gespeichert". ONE green PRIMARY action "Entwurf speichern" in the page header. One quiet supporting "Vorschau" action; do not show competing Publish/Activate actions. Saving does not publish. +Small direct section nav "Aufbau" selected, "Angaben", "Einordnung", "Präsentation", "Verlauf". Only build details active, not all long forms. +ROOT COMPOSITION contains exactly FOUR ordered occurrences: +1 "Modul Abstand" · Modul · Fassung1 · local role "Einstieg" — selected, expanded to show two read-only source children "Trainerunterlage Abstand" (Text) and "Lara im Park" (Unterrichtsfilm), visually clearly subordinate to the referenced module. +2 "Modul Hilfe" · Modul · Fassung1 — collapsed. +3 "Eigene Grenzen erkennen" · Modul · Fassung1 — collapsed. +4 "Nur ein allgemeiner Hinweis" · Text · Fassung1. +Small useful thumbnails when recognizable, restrained source/type icons for modules/text; no giant generic placeholder images or product cards. +Critical semantics of nested content: the current program references Modul Abstand Fassung1. Children displayed beneath that module are READ-ONLY source structure in this PROGRAM workspace. To edit a nested source, explicit source editor needed. Current selected item is ROOT occurrence1 "Modul Abstand", so editable role and note belong to its use in PROGRAMM ABSTAND, not the module's global definition or its child media. +Only two LOCAL editing controls for selected occurrence: "Rolle im Programm" text value "Einstieg", and "Hinweis an dieser Stelle" short textarea example "Mit dem Thema Abstand beginnen." Label this group "An dieser Stelle im Programm". Short explicit scope line "Gilt nur hier. Die Quelle bleibt unverändert." Show source identity separately as read-only "Quelle: Modul Abstand · Fassung1" with quiet "Quelle öffnen" link. Source preview or source facts always distinct from editable local use; no fields for global source description intermingled. +ORDERING: ordered rows with discreet drag handle and position indicator. Accessible alternate move-up/move-down or position controls for selected root occurrence are visibly available without drag. Show "Position1von4" with up disabled and down enabled; make this compact and subordinate, no full button wall on every row. Adding via "Bestandteil hinzufügen" opens the already selected reusable picker in a future implementation, don't open picker here. +CONTENT DENSITY: compact rows and manageable nesting; all4rootoccurrences and useful selected detail should fit without clipping main controls. Never depict a board of workflow status columns (didactic order is not Kanban status). Minimal repeated badges, no giant action/description bands, no dashboard metrics or unrelated feature inventory. +VISUAL LANGUAGE: white/warm neutral#F7F6F2, navy#032551, ink#15243A, muted#5D6A78, actiongreen#3B7B09 white text, subtleline#DDE5E3, blue#1769AA selected/inspection marker. Body14–16px readable Source Sans3-like sans, page title28px, modest8px radius, restrained line icons. Hierarchy through alignment, grouping, spacing and light dividers. No excessive shadows, nested cards, giant marketing preview, playful typography or decorative yellow underlines. +Focus one clear task and primary action. Field text and example grouping are illustrative, not new taxonomy or mandatory workflows. This is a discussion mockup, no tested keyboard or saving behavior claims. +STATE SEMANTICS: the line 'Änderungen noch nicht gespeichert' uses neutral text or a restrained amber dot, never a green success indicator. Keep typography 'Fassung 1' with readable spacing. No false saved or released success claim. +DIRECTION NAME: "Direkte Bearbeitung im Aufbau". A focused inline editing composition workspace. Same overall shell, program header, saved-state line, section tabs and same4rootitems as other proposals, but NO permanent right inspector and no narrow secondary outline column. One full-width ordered build surface across the content width. +Header row "Aufbau · 4 Bestandteile" left and outlined "Bestandteil hinzufügen" right. Root rows numbered with discreet drag handles; selected root1 Modul Abstand expands a purposeful inline LOCAL EDIT region within the list. Selected root title row has a subtle blue marker and shows type/version plus local role Einstieg. Under the selected title, two-column compact inline controls: left about35% "Rolle im Programm" input Einstieg; right65% "Hinweis an dieser Stelle" shallow2line textarea with example. Above controls a small clear group label "An dieser Stelle im Programm". Below scope hint "Gilt nur hier. Die Quelle bleibt unverändert." +Source content beneath is in a DISTINCT read-only band labeled "Inhalte aus Modul Abstand · Fassung 1 · Nur zur Ansicht", showing two short subordinate media rows or a compact two-item source list with text/document icon and tiny park-bench thumbnail. One quiet "Quelle öffnen" link. No source edit inputs, no media playback controls that dominate this editing view. Keep this source band light and low, not a card inside card. +Selected occurrence's compact position controls appear in its title row or inline bottom: "Position 1 von 4", up disabled, down enabled. Remaining three root rows below are collapsed, compact, and show exactly the other common example titles. Expand only ONE local editor at a time in the mockup, maintaining all4rootoccurrences on screen. Row overflow menu for secondary remove/replace actions, not lots of repeated buttons. +Global "Entwurf speichern" top is still the sole primary; do NOT add a local Apply/Save button inside every row. Local changes visibly part of unsaved program working state. Read-only module source expansion and current program occurrence editing are visibly different. The intended advantage is very short eye travel from source occurrence to editing position, with the potential cost of list-height changes; render a calm readable composition without accordion-in-accordion clutter. +Use unified separators on one continuous white working surface, not independently raised cards. Actual metadata preview/group labels concise and no instructional wall. All content and main actions fit1024px. +``` + diff --git a/docs/ux/verwaltung/generierung/auswahl-liste-verfeinerung-v2.md b/docs/ux/verwaltung/generierung/auswahl-liste-verfeinerung-v2.md new file mode 100644 index 0000000..ef5fd44 --- /dev/null +++ b/docs/ux/verwaltung/generierung/auswahl-liste-verfeinerung-v2.md @@ -0,0 +1,38 @@ +# Verfeinerung der gewählten Listenansicht + +Stand: 19.11.2026. Erzeugt mit dem integrierten Bildgenerator. Entwurf 1 wurde vom Auftraggeber als bevorzugte Grundlage gewählt. Dieses neue Bild konkretisiert den Hinweis zu fachlichen Inhaltstypen sowie Nutzung und Verwertung; die Detailausgestaltung ist noch nicht abschließend freigegeben. + +## Referenzen + +1. ../bilder/auswahl-01-liste-detail.png – vom Auftraggeber bevorzugte Listenbasis. +2. ../audit/11-medium-fassungen.jpg – tatsächliche Filmansicht von Lara im Park. + +## Ausgabe + +../bilder/auswahl-01-liste-detail-v2.png + +## Exakter Generierungsprompt + +```text +Create realistic, production-quality UI designs with clear hierarchy, strong typography, intentional imagery, and purposeful spacing. +Use case ui-mockup. Produce ONE refined version of the SELECTED list picker for Lara & Felix administration. Target dimensions1440x1024, no browser chrome, one realistic desktop dialog, not alternative concepts. All readable German text. Date anchor19November2026; dates unnecessary. +Image1 is the user-selected design target: preserve its list+right-detail layout, visual language, sparse search/filter bar, selected-item chips and footer. Image2 is actual source screenshot of the film Lara im Park on a park bench. Use the park-bench scene as its thumbnail and media preview. These are visual/domain references, not a screenshot to clone the old admin typography from. +USER FEEDBACK: selected LIST display with thumbnails and individual preview as practical default. Separate large chosen-items pane from former alternative is set aside because richer content classification and usage/exploitation information need space. Keep selection chips only, not a second large selection list. +User explicitly requires defined fachliche Inhaltstypen distinct from technical file/media types, plus the topics Nutzung and Verwertung. Their detailed business definitions remain OPEN. Do not invent license rules, commercial permissions, public-release states or new data relationships. Do not put a green allowed/commercial badge or assert exploitation rights. No shop/public product presentation. +Preserve title "Medien auswählen", context "Für das Modul: Eigene Grenzen erkennen", close control. Search "Titel oder Suchbegriff", compact clearly labeled filter "Inhaltstyp: Alle", secondary "Weitere Filter". Show "6 Treffer" and understated "Listenansicht"; remove prominent grid toggle from this refinement so chosen default is clear. +Main body approx60% unified compact results list and40% DETAIL region. Six consistent rows: +Lara im Park, checked and currently INSPECTED, metadata "Unterrichtsfilm · Inhaltsfassung 1"; +Trainerunterlage Abstand, checked, metadata "Trainerunterlage · Inhaltsfassung 1"; +Felix beim Onkel, unchecked, metadata "Filmbeispiel · Entwurf"; +Nur ein allgemeiner Hinweis, unchecked, metadata "Hinweistext · Inhaltsfassung 1"; +Lara Felix Park Original, unchecked, metadata "Präsentationsbild"; +UX-Pilot Hinweis, unchecked, metadata "Hinweistext · Inhaltsfassung 1". +These classifications are illustrative UI data, not a business decision about production taxonomy. Small thumbnail or document/text icon and title, one concise metadata line. No extra columns for every attribute. Two green inclusion checkboxes separate from BLUE thin inspection outline of Lara row. Keyboard focus is a separate implementation concern, don't label blue inspected state as a tested focus system. +Right detail region: title Lara im Park, restrained 16:9 media preview with accurate park-bench imagery and simple player controls, short description "Ein Unterrichtsfilm über Nähe, Unwohlsein und die eigene Grenze." Under preview show compact INLINE TYPE FACTS to visibly distinguish "Inhaltstyp: Unterrichtsfilm" and "Medienart: Film". No file format extension needed because actual format unverified. +Below use three compact collapsible information rows with clear labels "Einordnung", "Verwendung", "Nutzung und Verwertung". All collapsed in this image so no invented taxonomy or exploitation data is displayed. These are information areas within the same detail pane; do not open nested dialogs or show a long checkbox form. No architecture notes or developer disclaimers in actual UI. +Fixed selection strip "2 ausgewählt" with removable named chips Lara im Park and Trainerunterlage Abstand. Fixed action footer short note "Die Auswahl wird erst mit Übernehmen zugeordnet.", "Abbrechen" secondary and ONE green primary "2 Medien übernehmen". +Preserve neutral professional enterprise/DAM language, white/warm neutral surfaces, navy#032551, ink#15243A, muted#5D6A78, actiongreen#3B7B09 white text, subtleline#DDE5E3, blue#1769AA for inspection/focus accent, modest8pxradii. Body14–16px readable Source Sans3-like sans. Use grouping/spacing/dividers first. No nested cards, card inventory, large empty placeholders, marketing hero, unrelated global navigation, stacked modals, clipped footer or excessive repeated badges. +Underlying dimmed page should only show truthful sparse context "Module / Eigene Grenzen erkennen"; don't mix offers into module breadcrumb. +Hard constraints preserve existing models, relationships, versioning, rights, Laravel/Filament/Livewire feasibility. This is a discussion image, not implementation. Keep the user-selected composition and refine metadata scalability and clear type labeling only. +``` + diff --git a/docs/ux/verwaltung/generierung/auswahl-prompts.md b/docs/ux/verwaltung/generierung/auswahl-prompts.md new file mode 100644 index 0000000..614c17b --- /dev/null +++ b/docs/ux/verwaltung/generierung/auswahl-prompts.md @@ -0,0 +1,101 @@ +# Bildgenerierung: Auswahl und Zuordnung + +Stand: 19.11.2026. Erzeugt mit dem integrierten Bildgenerator. Diese Prompts dokumentieren visuelle Diskussionen, keine fachlichen Beschlüsse und keine Implementierung. + +## Referenzbilder + +1. ../bilder/richtung-kombiniert.png – bestätigte gemeinsame Gestaltungsrichtung. +2. ../audit/38-materialpicker-auswahl.jpg – tatsächlich beobachteter Materialpicker als fachlicher Bezug und UX-Ausgangslage. +3. ../audit/11-medium-fassungen.jpg – tatsächliche Filmansicht von Lara im Park. + +Die folgenden Texte wurden vollständig an die Bildgenerierung übergeben. Die Referenzen wurden bei jeder Generierung als Bilddateien angehängt. Nummern entsprechen der tatsächlichen Anzeigereihenfolge der drei Ergebnisse im Gespräch. + +## 1 – Liste mit Detailprüfung + +Ausgabe: ../bilder/auswahl-01-liste-detail.png + +```text +Create realistic, production-quality UI designs with clear hierarchy, strong typography, intentional imagery, and purposeful spacing. +Use case ui-mockup. One independent detailed design proposal for a reusable selection-and-assignment surface in Lara & Felix administration. Exact target desktop dimensions 1440 x 1024, one screen, natural ratio, no browser chrome or presentation board, no option numbers. All UI in accurate, legible German. +This is a discussion image, NOT a tested or implemented interface. Date anchor19 November2026; omit dates if unnecessary. +ATTACHED REFERENCES: first image is the user-approved hybrid administration visual language (persistent object workspace plus guided steps only for linear tasks). Second image is existing cluttered material picker from real test instance, as DOMAIN CONTEXT and a negative usability reference. Third image is the real film "Lara im Park", showing the correct image of a woman and child on a park bench. Reuse recognizable real product thumbnails where appropriate, particularly the park-bench scene for Lara im Park. Do not recreate the old giant placeholder graphics for text materials; use clean document/text type icons. +USER DESIGN DECISIONS: coherent single admin system; visual contextual editing; reusable selection behavior across media, didactic content and licensing contexts; efficient desktop use and large collections; no long checkbox forms, nested modal loops, mixed product presentation and administrative controls. No shop preview or marketing card. Preserve Laravel/Filament/Livewire feasibility and existing object models/rights/version relationships. Offer variants, histories and hierarchy are still open business questions: DO NOT invent business decisions or include them in this picker. +HERO TASK: choose existing media to reference in a didactic module. Heading "Medien auswählen", clear small context "Für das Modul: Eigene Grenzen erkennen". Available source inventory is broader than this one task, while permitted media and reference rules are context-dependent. Do not silently copy files or create new versions by choosing them. +SHARED BEHAVIOR FOR ALL PROPOSALS: inspecting/focusing a result and checking it for inclusion are distinct actions, expressed visually differently. Checkbox indicates selected for inclusion. Thin navy/blue focus outline or row marker identifies currently inspected result. Preserve selected items across search/filter changes. Always visible number of selected items, clear way to remove them. One green PRIMARY action exactly "2 Medien übernehmen". One subordinate "Abbrechen". No publish/activate/release actions in this surface. Confirmation text "Die Auswahl wird erst mit Übernehmen zugeordnet." as a short quiet footer note. No implied new technical save/version rules. +CONSISTENT EXAMPLE DATA: +"Lara im Park" · Film · 1:55 · Inhaltsfassung1 — CHECKED, currently INSPECTED; +"Trainerunterlage Abstand" · Text · Inhaltsfassung1 — CHECKED; +"Felix beim Onkel" · Film · Entwurf — not checked; +"Nur ein allgemeiner Hinweis" · Text · Inhaltsfassung1 — not checked; +"Lara Felix Park Original" · Bild — not checked; +"UX-Pilot Hinweis" · Text · Inhaltsfassung1 — not checked. +These are illustrative UI data grounded in source names; do not show invented customer or price information. Status text indicates the content draft/version, never imply website public release or customer access. When displaying details of Lara im Park, show meaningful media preview, title, type, "Inhaltsfassung 1", short description "Ein Unterrichtsfilm über Nähe, Unwohlsein und die eigene Grenze." Keep administrative technical details secondary and collapsible. No long legal/architecture explanation. +COMMON VISUAL LANGUAGE: white base surfaces, warm neutral #F7F6F2, navy #032551, ink #15243A, actiongreen #3B7B09 with white labels, line #DDE5E3, muted#5D6A78, focus#1769AA. Readable Source Sans 3-like sans-serif14–16px body, compact human-readable heading24–28px, modest8px corners. Strong alignment/grouping, subtle separators, only small surface tints; no excessive shadows, card-in-card layouts, cartoons, decorative underlines or illustrative dashboards. Compact consistent line icons. Do not fake logo: understated plain text Lara & Felix only when context needs it. +Design a focused primary screen rather than a feature inventory. Main controls: search "Titel oder Suchbegriff", compact media-type filter and one "Weitere Filter" control, no filter wall. Only useful selected-item/status signals. Keep long text under65characters per line. Fit all essential controls at1024px height without clipping. No app metrics, unrelated feature navigation or additional unrequested configuration panels. +DIRECTION NAME: "Liste mit Detailprüfung". This is the recommended calm general-purpose selection layout. Show a large purpose-built dialog occupying almost the desktop viewport, with minimal dimmed background of the module editor and no stacked dialogs. Dialog edges about36px from viewport; natural subtle border, no large drop shadow. +Header title and module context left, clear close icon right. One search row across the dialog with search field taking most width, media-type filter "Alle Arten", secondary "Weitere Filter". Below, slim toolbar with "6 Treffer" left, a small list/grid view toggle right (list selected). +Main dialog split into approx63% RESULT LIST and37% DETAIL INSPECTOR. Left a unified table-like list of the six common example records, rows approx78px high with checkbox, 70x44 thumbnail or text icon, title and compact type/version metadata. Use no independent cards. Lara im Park and Trainerunterlage Abstand checkboxes checked, while Lara's row alone has a fine blue focus line and light neutral inspection background (NOT a green selection wash over all checked rows). Clear differentiation between selection and inspection. +Right inspector on a softly tinted base: medium preview of the park-bench scene, heading Lara im Park, two quiet metadata items "Film" and "Inhaltsfassung 1", short accurate description. One small "Weitere Informationen" disclosure for admin metadata. No edit form. +Fixed selection footer above actions: "2 ausgewählt", two small removable named selection chips. Bottom action row note "Die Auswahl wird erst mit Übernehmen zugeordnet." left; "Abbrechen" secondary and "2 Medien übernehmen" primary right. Retain enough height for all controls at1024px. +The eye must land on search, results and confirm in that order, with optional detail reading. Professional precision, compact rows, accessible target sizes, no duplicated selected cards, no tutorial paragraph. +``` + +## 2 – Bildraster mit Detailprüfung + +Ausgabe: ../bilder/auswahl-02-raster-detail.png + +```text +Create realistic, production-quality UI designs with clear hierarchy, strong typography, intentional imagery, and purposeful spacing. +Use case ui-mockup. One independent detailed design proposal for a reusable selection-and-assignment surface in Lara & Felix administration. Exact target desktop dimensions 1440 x 1024, one screen, natural ratio, no browser chrome or presentation board, no option numbers. All UI in accurate, legible German. +This is a discussion image, NOT a tested or implemented interface. Date anchor19 November2026; omit dates if unnecessary. +ATTACHED REFERENCES: first image is the user-approved hybrid administration visual language (persistent object workspace plus guided steps only for linear tasks). Second image is existing cluttered material picker from real test instance, as DOMAIN CONTEXT and a negative usability reference. Third image is the real film "Lara im Park", showing the correct image of a woman and child on a park bench. Reuse recognizable real product thumbnails where appropriate, particularly the park-bench scene for Lara im Park. Do not recreate the old giant placeholder graphics for text materials; use clean document/text type icons. +USER DESIGN DECISIONS: coherent single admin system; visual contextual editing; reusable selection behavior across media, didactic content and licensing contexts; efficient desktop use and large collections; no long checkbox forms, nested modal loops, mixed product presentation and administrative controls. No shop preview or marketing card. Preserve Laravel/Filament/Livewire feasibility and existing object models/rights/version relationships. Offer variants, histories and hierarchy are still open business questions: DO NOT invent business decisions or include them in this picker. +HERO TASK: choose existing media to reference in a didactic module. Heading "Medien auswählen", clear small context "Für das Modul: Eigene Grenzen erkennen". Available source inventory is broader than this one task, while permitted media and reference rules are context-dependent. Do not silently copy files or create new versions by choosing them. +SHARED BEHAVIOR FOR ALL PROPOSALS: inspecting/focusing a result and checking it for inclusion are distinct actions, expressed visually differently. Checkbox indicates selected for inclusion. Thin navy/blue focus outline or row marker identifies currently inspected result. Preserve selected items across search/filter changes. Always visible number of selected items, clear way to remove them. One green PRIMARY action exactly "2 Medien übernehmen". One subordinate "Abbrechen". No publish/activate/release actions in this surface. Confirmation text "Die Auswahl wird erst mit Übernehmen zugeordnet." as a short quiet footer note. No implied new technical save/version rules. +CONSISTENT EXAMPLE DATA: +"Lara im Park" · Film · 1:55 · Inhaltsfassung1 — CHECKED, currently INSPECTED; +"Trainerunterlage Abstand" · Text · Inhaltsfassung1 — CHECKED; +"Felix beim Onkel" · Film · Entwurf — not checked; +"Nur ein allgemeiner Hinweis" · Text · Inhaltsfassung1 — not checked; +"Lara Felix Park Original" · Bild — not checked; +"UX-Pilot Hinweis" · Text · Inhaltsfassung1 — not checked. +These are illustrative UI data grounded in source names; do not show invented customer or price information. Status text indicates the content draft/version, never imply website public release or customer access. When displaying details of Lara im Park, show meaningful media preview, title, type, "Inhaltsfassung 1", short description "Ein Unterrichtsfilm über Nähe, Unwohlsein und die eigene Grenze." Keep administrative technical details secondary and collapsible. No long legal/architecture explanation. +COMMON VISUAL LANGUAGE: white base surfaces, warm neutral #F7F6F2, navy #032551, ink #15243A, actiongreen #3B7B09 with white labels, line #DDE5E3, muted#5D6A78, focus#1769AA. Readable Source Sans 3-like sans-serif14–16px body, compact human-readable heading24–28px, modest8px corners. Strong alignment/grouping, subtle separators, only small surface tints; no excessive shadows, card-in-card layouts, cartoons, decorative underlines or illustrative dashboards. Compact consistent line icons. Do not fake logo: understated plain text Lara & Felix only when context needs it. +Design a focused primary screen rather than a feature inventory. Main controls: search "Titel oder Suchbegriff", compact media-type filter and one "Weitere Filter" control, no filter wall. Only useful selected-item/status signals. Keep long text under65characters per line. Fit all essential controls at1024px height without clipping. No app metrics, unrelated feature navigation or additional unrequested configuration panels. +DIRECTION NAME: "Bildraster mit Detailprüfung". A visually oriented media selection workspace within the same accepted product language and exact same selection semantics as other proposals. Show a near-full desktop dialog on a minimally dimmed module editor. Header and contextual subtitle, close icon top right. One compact search/filter row. Below row, "6 Treffer" left and compact "Liste / Raster" view toggle right, Raster active. +Main body split68% VISUAL RESULT GRID and32% CONTEXT INSPECTOR. Left grid is three columns and two rows, six thoughtfully sized tiles with large useful preview thumbnails and maximum two text lines. Tiles form a calm uniform grid with small8px gaps; no heavy border or shadow. Checkbox at tile top-left is the selection control, outside the preview media itself or on a clear white solid control background. Two checked tiles "Lara im Park" and "Trainerunterlage Abstand". Currently inspected Lara tile alone has a fine blue focus border; checked trainer tile has only the checked control and a small green selected marker, no focus border. Use readable short names, small film/text/image type label. No long descriptions, legal instructions, version paragraphs or multiline status badges on every tile. +Right inspector shows Lara im Park park-bench preview at16:9, title, type and content version, concise description. "Weitere Informationen" quiet disclosure below; do not add edit inputs or unrelated actions. +Full-width fixed bottom selection strip "2 ausgewählt" with named removable chips, then quiet confirmation note and action row "Abbrechen" secondary plus ONE green "2 Medien übernehmen". This component is for quick visual recognition, particularly films and pictures, yet must show text items via elegant compact document previews/icons rather than giant generic illustrations. +Arrange exactly all six records from common brief, no duplicate objects or fabricated rows. Preserve right inspector width adequate for text. Warm calm base, restrained iconography, high contrast and professional desktop precision. All essential footer actions visible. +``` + +## 3 – Bestand und Auswahl nebeneinander + +Ausgabe: ../bilder/auswahl-03-bestand-auswahl.png + +```text +Create realistic, production-quality UI designs with clear hierarchy, strong typography, intentional imagery, and purposeful spacing. +Use case ui-mockup. One independent detailed design proposal for a reusable selection-and-assignment surface in Lara & Felix administration. Exact target desktop dimensions 1440 x 1024, one screen, natural ratio, no browser chrome or presentation board, no option numbers. All UI in accurate, legible German. +This is a discussion image, NOT a tested or implemented interface. Date anchor19 November2026; omit dates if unnecessary. +ATTACHED REFERENCES: first image is the user-approved hybrid administration visual language (persistent object workspace plus guided steps only for linear tasks). Second image is existing cluttered material picker from real test instance, as DOMAIN CONTEXT and a negative usability reference. Third image is the real film "Lara im Park", showing the correct image of a woman and child on a park bench. Reuse recognizable real product thumbnails where appropriate, particularly the park-bench scene for Lara im Park. Do not recreate the old giant placeholder graphics for text materials; use clean document/text type icons. +USER DESIGN DECISIONS: coherent single admin system; visual contextual editing; reusable selection behavior across media, didactic content and licensing contexts; efficient desktop use and large collections; no long checkbox forms, nested modal loops, mixed product presentation and administrative controls. No shop preview or marketing card. Preserve Laravel/Filament/Livewire feasibility and existing object models/rights/version relationships. Offer variants, histories and hierarchy are still open business questions: DO NOT invent business decisions or include them in this picker. +HERO TASK: choose existing media to reference in a didactic module. Heading "Medien auswählen", clear small context "Für das Modul: Eigene Grenzen erkennen". Available source inventory is broader than this one task, while permitted media and reference rules are context-dependent. Do not silently copy files or create new versions by choosing them. +SHARED BEHAVIOR FOR ALL PROPOSALS: inspecting/focusing a result and checking it for inclusion are distinct actions, expressed visually differently. Checkbox indicates selected for inclusion. Thin navy/blue focus outline or row marker identifies currently inspected result. Preserve selected items across search/filter changes. Always visible number of selected items, clear way to remove them. One green PRIMARY action exactly "2 Medien übernehmen". One subordinate "Abbrechen". No publish/activate/release actions in this surface. Confirmation text "Die Auswahl wird erst mit Übernehmen zugeordnet." as a short quiet footer note. No implied new technical save/version rules. +CONSISTENT EXAMPLE DATA: +"Lara im Park" · Film · 1:55 · Inhaltsfassung1 — CHECKED, currently INSPECTED; +"Trainerunterlage Abstand" · Text · Inhaltsfassung1 — CHECKED; +"Felix beim Onkel" · Film · Entwurf — not checked; +"Nur ein allgemeiner Hinweis" · Text · Inhaltsfassung1 — not checked; +"Lara Felix Park Original" · Bild — not checked; +"UX-Pilot Hinweis" · Text · Inhaltsfassung1 — not checked. +These are illustrative UI data grounded in source names; do not show invented customer or price information. Status text indicates the content draft/version, never imply website public release or customer access. When displaying details of Lara im Park, show meaningful media preview, title, type, "Inhaltsfassung 1", short description "Ein Unterrichtsfilm über Nähe, Unwohlsein und die eigene Grenze." Keep administrative technical details secondary and collapsible. No long legal/architecture explanation. +COMMON VISUAL LANGUAGE: white base surfaces, warm neutral #F7F6F2, navy #032551, ink #15243A, actiongreen #3B7B09 with white labels, line #DDE5E3, muted#5D6A78, focus#1769AA. Readable Source Sans 3-like sans-serif14–16px body, compact human-readable heading24–28px, modest8px corners. Strong alignment/grouping, subtle separators, only small surface tints; no excessive shadows, card-in-card layouts, cartoons, decorative underlines or illustrative dashboards. Compact consistent line icons. Do not fake logo: understated plain text Lara & Felix only when context needs it. +Design a focused primary screen rather than a feature inventory. Main controls: search "Titel oder Suchbegriff", compact media-type filter and one "Weitere Filter" control, no filter wall. Only useful selected-item/status signals. Keep long text under65characters per line. Fit all essential controls at1024px height without clipping. No app metrics, unrelated feature navigation or additional unrequested configuration panels. +DIRECTION NAME: "Bestand und Auswahl nebeneinander". A task-focused selection arrangement with an explicitly visible chosen collection. ONE near-full desktop dialog on subtly dimmed module workspace. Same visual language and behavior as references, not a new application or different brand. +Header "Medien auswählen", contextual subtitle and close icon, compact search/filter row. Dialog body has TWO EQUALLY PROMINENT columns: LEFT "Bestand · 6 Treffer" and RIGHT "Auswahl · 2 Medien". This alternative gives selected scope more space rather than a large inspector. Both columns are unified compact row lists, not cards. +Left six common records with small thumbnails/icons, readable title, media kind/version. Checked inclusion shown by green checkbox for Lara im Park and Trainerunterlage Abstand; remaining unselected. Lara im Park currently inspected has thin BLUE focus outline separate from checkmark. Small row detail icon can indicate preview without changing selection. +Right chosen collection lists exactly Lara im Park and Trainerunterlage Abstand with compact thumbs, title, type, remove button. Selection list preserves chosen order visually but DO NOT add drag handles or claim choosing order changes didactic order; actual composition ordering is a subsequent separate action, not this selection component. The right column's lower half contains a clearly labeled compact "Detailvorschau · Lara im Park" region, with a modest16:9 park-bench preview and one-line type/version; this is a preview of focused source, not shop/public presentation. Keep row choices distinct from detail area using whitespace and thin divider. No extra large repeated title/descriptions. +Footer left short "Die Auswahl wird erst mit Übernehmen zugeordnet.", right "Abbrechen" secondary and ONE green "2 Medien übernehmen". No redundant bottom named chips since full chosen selection is already right; count remains visible in header. No arrow-transfer steps: checking a source immediately updates LOCAL chosen list; remove unchecks source; final Übernehmen confirms once. Support checkbox-based keyboard operation in the design; drag-and-drop is not required for selection. +The hierarchy should make chosen inventory, available source and final confirmation unmistakable. Sparse concise text, high scanning efficiency, no nested modals or unnecessary intermediate confirm buttons. Do not show invented select-all actions, complicated permissions controls or metrics. +``` + diff --git a/docs/ux/verwaltung/generierung/cms-konfiguration-weiterentwicklung.md b/docs/ux/verwaltung/generierung/cms-konfiguration-weiterentwicklung.md new file mode 100644 index 0000000..fb417e8 --- /dev/null +++ b/docs/ux/verwaltung/generierung/cms-konfiguration-weiterentwicklung.md @@ -0,0 +1,132 @@ +# CMS-Weiterentwicklung: Raster, Abschnitt und Baustein + +Datum: 19.11.2026. Integrierter Bildgenerator. Zusammengehörige Arbeitszustände eines überarbeiteten Vorschlags nach der Rückmeldung zum Vierer-Raster und zur Konfigurationstiefe. Keine drei neuen Alternativen; keine finale Auswahl oder Implementierung. + +## Quellen und Prüfung + +Die bisherige visuelle Seitenfläche und die Einzelbearbeitung wurden direkt betrachtet. Zusätzlich wurden die historischen Abschnitts-/Darstellungsaufnahmen geprüft. Der aktuelle Code von SectionLayouts, SectionStyle, WidgetType, ProgramCardWidget und PremiumCardWidget sowie der Registry-Vertrag wurden nur gelesen. Alte kombinierte Abschnittsabstände wurden nicht als gültiger Stand übernommen. + +Lokale Bildreferenzen: + +- [Vorherige visuelle Seitenfläche](../bilder/cms-02-seitenflaeche-inspektor.png). +- [Vorherige Einzelbearbeitung](../bilder/cms-03-einzelbearbeitung.png). +- Historische Abschnittsaufnahme: `docs/analysen/adaptive-widgets-screenshots/15-nachpruefung-abstand-oben.jpg`. +- Historische Darstellungsaufnahme: `docs/analysen/adaptive-widgets-screenshots/04-editor-dialog-darstellung.jpg`. + +Die historischen Abschnittsabstände wurden später ersetzt; der aktuelle Entwurf verwendet Abstand oben, Abstand unten und Widget-Abstand als drei unabhängige Werte. Die neuen Ansichten sind generierte Referenzen, keine aktuellen Browser-Screenshots. + +## Seitenaufbau + +Ausgabe: [cms-weiterentwicklung-seitenaufbau-v1.png](../bilder/cms-weiterentwicklung-seitenaufbau-v1.png). + +Tatsächlich angehängte Referenzen: Vorherige Seitenfläche, Einzelbearbeitung, historische Abschnitts- und Widgetdarstellung. + +### Exakter Prompt + +```text +Create a realistic, production-quality German desktop admin UI for Lara & Felix, natural 1487 x 1058 frame, no device/browser mockup. Current date 19 November 2026; no dates needed. This is a refinement after user feedback, showing ONE coherent CMS concept in related working states. Do not create another style or another CMS framework. +References include previous CMS concepts in approved quiet white/navy/green frame and actual legacy section/widget configuration screenshots. Use their existing capabilities, not old excessive nested form wrappers. The old section screenshot has obsolete combined spacing fields; the current correct model is THREE separate fields Abstand oben, Abstand unten, Widget-Abstand. Do NOT restore combined spacing or an extra old spacing override. +Global navigation like previous approved frame: Lara & Felix / Verwaltung; Arbeitsplatz, Medien, Inhalte, Angebote, Website SELECTED, Kunden, approx210px. Header breadcrumb Website / Seiten / Prävention im Alltag; page title Prävention im Alltag; amber "Entwurf · Änderungen nicht gespeichert", separate quiet "Öffentlich: Revision 12". ONE primary green "Entwurf speichern"; secondary "Seitenvorschau", subdued "Veröffentlichen…". Page tabs Seiteninhalt active, Seiteneinstellungen, Verlauf. +Owner-operated modest platform, not giant shop admin. Existing Laravel/Filament/Livewire page -> sections -> slots -> one widget per slot stays intact. Four LOGICAL column UNITS per section, not four arbitrary equal cards always. Valid patterns are 4; 2+2; 1+3; 3+1; 1+2+1; 1+1+1+1; 1+1+2; 2+1+1. Heights depend on widget type/content and its supported choices. Do not imply a pixel-height limit, universal freely resizable cards, masonry layout or extra row-span model. +There is NO permanent narrow settings sidebar required. Page arrangement uses the whole available work area. Dedicated section configuration and a generous widget configurator are separate contexts in same page working draft, with explicit return retaining open edits. No per-widget persistence button required; no new approval chain. +Shared example page: Abschnitt1 "Einstieg" full width (4 units), can be compact in overview. Abschnitt2 "Training im Alltag", layout1+1+2 with THREE neighboring different-width widgets: first a Themenkarte "Grenzen" uses1unit; second Programmkarte "Programm Abstand" uses1unit, selected when relevant; third Bild und Text "Gemeinsam üben" uses2units. Show different natural heights (first short, second taller, third a different supported presentation height) with empty space below shorter cards in SAME section, not masonry. Abschnitt3 "Häufige Fragen" fullwidth4 can be compact below. +Program widget references Programm Abstand (Programm) and normally uses its central editorial title, summary and cover. Sample central summary "Ein Trainingsprogramm über Nähe, Abstand und persönliche Grenzen." No price/buy CTA. Central editing is through Redaktionsmanager, optional widget-level overrides local only. Pure page widgets may own page-specific text; do not require a product source for every page sentence. +No new public-profile mechanism, content-version requirement for presentation media, license pricing, database fields, user management, AI composer or workflow metrics. Generated photos merely illustrate training/park situations. Use simple separators and clear whitespace, avoid card nesting, compact ordinary 14-16px body text, legible field labels. +Each image is a single working state, not a collage or a choice between multiple designs. +Working state name: Seitenaufbau mit sichtbarem Vierer-Raster. +References1/2 ground approved admin styling, references3/4 show existing section and widget configuration capabilities. This image shows the entire arranging workspace, NOT a configurator open. +Below page tabs heading "Seitenaufbau" on left, quiet "Arbeitsansicht" and eye/menu controls. Full available work width, absolutely NO settings pane on the right. One button "+ Abschnitt hinzufügen" in appropriate quiet location. +Render Abschnitt1 as a compact visual row/preview "Einstieg · Raster4" with some small hero content, not a huge hero taking all screen. +Make Abschnitt2 prominent. Header line "Abschnitt2 · Training im Alltag", small readable "Raster1+1+2" and explicit outlined button "Abschnitt gestalten" plus quiet overflow menu. Draw four subtle vertical guide UNITS numbered1,2,3,4 above its body. They must align precisely to content spans: Themenkarte over unit1, Programmkarte over unit2, Bild und Text spanning units3AND4. Dividers show 1:1:2 proportions, not three equal columns. +The cards sit next to each other, aligned at top, naturally unequal heights. Program card selected thinblue outline, no inherited-source fields on canvas. Each widget frame labels type and span: "Themenkarte · 1 Einheit", "Programmkarte · 1 Einheit", "Bild und Text · 2 Einheiten". On selected program show obvious quiet "Konfigurieren" action; section button configures SECTION, widget action configures WIDGET. Other widgets can have overflow menu rather than repeated toolbar. +Themenkarte short: small training image plus Grenzen title. Program card taller: photo, Programm Abstand title, central summary. Bild und Text wide: medium park photo strip, Gemeinsam üben heading and a couple lines own page text, small neutral action if needed; not same card cloned. Do NOT force all cards equal height. +Below Abschnitt2 a summary "3 Bausteine · 4 Rastereinheiten" and tiny descriptive line "Breiten und Höhen folgen Raster, Inhalt und Bausteintyp." No constant dimensions configuration controls in page canvas. +Show Abschnitt3 header and small FAQ preview below if space. No clipped fields/buttons. Clear proposal demonstrates overview and two gateways, not all settings at once. +``` + +## Abschnitt gestalten + +Ausgabe: [cms-weiterentwicklung-abschnitt-v1.png](../bilder/cms-weiterentwicklung-abschnitt-v1.png). + +Tatsächlich angehängte Referenzen: Neue Seitenaufbauansicht, historische Abschnittsaufnahme und vorherige Seitenfläche. + +### Exakter Prompt + +```text +Create a realistic, production-quality German desktop admin UI for Lara & Felix, natural 1487 x 1058 frame, no device/browser mockup. Current date 19 November 2026; no dates needed. This is a refinement after user feedback, showing ONE coherent CMS concept in related working states. Do not create another style or another CMS framework. +References include previous CMS concepts in approved quiet white/navy/green frame and actual legacy section/widget configuration screenshots. Use their existing capabilities, not old excessive nested form wrappers. The old section screenshot has obsolete combined spacing fields; the current correct model is THREE separate fields Abstand oben, Abstand unten, Widget-Abstand. Do NOT restore combined spacing or an extra old spacing override. +Global navigation like previous approved frame: Lara & Felix / Verwaltung; Arbeitsplatz, Medien, Inhalte, Angebote, Website SELECTED, Kunden, approx210px. Header breadcrumb Website / Seiten / Prävention im Alltag; page title Prävention im Alltag; amber "Entwurf · Änderungen nicht gespeichert", separate quiet "Öffentlich: Revision 12". ONE primary green "Entwurf speichern"; secondary "Seitenvorschau", subdued "Veröffentlichen…". Page tabs Seiteninhalt active, Seiteneinstellungen, Verlauf. +Owner-operated modest platform, not giant shop admin. Existing Laravel/Filament/Livewire page -> sections -> slots -> one widget per slot stays intact. Four LOGICAL column UNITS per section, not four arbitrary equal cards always. Valid patterns are 4; 2+2; 1+3; 3+1; 1+2+1; 1+1+1+1; 1+1+2; 2+1+1. Heights depend on widget type/content and its supported choices. Do not imply a pixel-height limit, universal freely resizable cards, masonry layout or extra row-span model. +There is NO permanent narrow settings sidebar required. Page arrangement uses the whole available work area. Dedicated section configuration and a generous widget configurator are separate contexts in same page working draft, with explicit return retaining open edits. No per-widget persistence button required; no new approval chain. +Shared example page: Abschnitt1 "Einstieg" full width (4 units), can be compact in overview. Abschnitt2 "Training im Alltag", layout1+1+2 with THREE neighboring different-width widgets: first a Themenkarte "Grenzen" uses1unit; second Programmkarte "Programm Abstand" uses1unit, selected when relevant; third Bild und Text "Gemeinsam üben" uses2units. Show different natural heights (first short, second taller, third a different supported presentation height) with empty space below shorter cards in SAME section, not masonry. Abschnitt3 "Häufige Fragen" fullwidth4 can be compact below. +Program widget references Programm Abstand (Programm) and normally uses its central editorial title, summary and cover. Sample central summary "Ein Trainingsprogramm über Nähe, Abstand und persönliche Grenzen." No price/buy CTA. Central editing is through Redaktionsmanager, optional widget-level overrides local only. Pure page widgets may own page-specific text; do not require a product source for every page sentence. +No new public-profile mechanism, content-version requirement for presentation media, license pricing, database fields, user management, AI composer or workflow metrics. Generated photos merely illustrate training/park situations. Use simple separators and clear whitespace, avoid card nesting, compact ordinary 14-16px body text, legible field labels. +Each image is a single working state, not a collage or a choice between multiple designs. +Working state name: Großzügige Abschnittsgestaltung. +Reference1 is the new full-width page arrangement from this SAME proposal. Reference2 is the historical section form, which has obsolete spacing fields; apply the current three-independent-spacing rule above. Reference3 grounds the approved admin frame. +Show a dedicated, generous configuration context for SECTION2. Keep same global page header/actions/tabs. Below tabs a clear back link "Zur Seite"; heading "Abschnitt gestalten"; subtitle "Abschnitt2 · Training im Alltag". This context configures the containing section, NOT the program card's texts. +Use around 65% wide settings on LEFT, 35% scaled preview/context on RIGHT. This is not a permanent narrow right-hand form. Whole content area is available to configure the section; avoid nested decorative field cards. +Left content under heading "Raster": eight clear graphic pattern buttons in two rows of four. Exact labels 4; 2+2; 1+3; 3+1; 1+2+1; 1+1+1+1; 1+1+2 SELECTED green; 2+1+1. Graphic pattern proportions reflect label. Keep labels readable. No arbitrary resizing of width outside these allowed section patterns. +Below a two-column row: +"Inhaltsbreite" dropdown value "Standard". +"Hintergrund" dropdown value "Helle Markenfläche". +Then group heading "Abstände" with THREE separately labeled controls in one row or clean small group: +"Abstand oben" value "Normal"; +"Abstand unten" value "Kompakt"; +"Widget-Abstand" value "Normal". +Then "Trenner" dropdown value "Dezente Linie". +No combined "oben und unten" field and no extra override. For a background-image choice the same configurator would reveal central image selection, image focus and overlay; don't show them as mandatory when Helle Markenfläche is selected. +Right: heading "Abschnittsvorschau", small explicit label "Verkleinert · Raster1+1+2". Show the same three neighboring widgets from reference1 in 1:1:2 proportions and visibly natural different heights on the light section surface. This preview is intentionally scaled, not a narrow responsive output that incorrectly stacks all cards. It can be schematic-real preview with readable short titles, not all original text at full size. Compact summary beneath: "3 Bausteine · 4 Rastereinheiten", "Breite: Standard", "Fläche: Helle Markenfläche". An unobtrusive "In der Seite ansehen" returns to arrangement, not another save. +Bottom contextual note "Änderungen bleiben im Seitenentwurf. Gespeichert wird über „Entwurf speichern“." No extra apply/section-save or publishing button. Real roomy section configurator with all essential current options locatable, still part of one page working draft. +``` + +## Programmkarte konfigurieren + +Ausgabe: [cms-weiterentwicklung-baustein-v1.png](../bilder/cms-weiterentwicklung-baustein-v1.png). + +Tatsächlich angehängte Referenzen: Neue Seitenaufbauansicht, vorherige Einzelbearbeitung und historische Widgetdarstellung. + +### Exakter Prompt + +```text +Create a realistic, production-quality German desktop admin UI for Lara & Felix, natural 1487 x 1058 frame, no device/browser mockup. Current date 19 November 2026; no dates needed. This is a refinement after user feedback, showing ONE coherent CMS concept in related working states. Do not create another style or another CMS framework. +References include previous CMS concepts in approved quiet white/navy/green frame and actual legacy section/widget configuration screenshots. Use their existing capabilities, not old excessive nested form wrappers. The old section screenshot has obsolete combined spacing fields; the current correct model is THREE separate fields Abstand oben, Abstand unten, Widget-Abstand. Do NOT restore combined spacing or an extra old spacing override. +Global navigation like previous approved frame: Lara & Felix / Verwaltung; Arbeitsplatz, Medien, Inhalte, Angebote, Website SELECTED, Kunden, approx210px. Header breadcrumb Website / Seiten / Prävention im Alltag; page title Prävention im Alltag; amber "Entwurf · Änderungen nicht gespeichert", separate quiet "Öffentlich: Revision 12". ONE primary green "Entwurf speichern"; secondary "Seitenvorschau", subdued "Veröffentlichen…". Page tabs Seiteninhalt active, Seiteneinstellungen, Verlauf. +Owner-operated modest platform, not giant shop admin. Existing Laravel/Filament/Livewire page -> sections -> slots -> one widget per slot stays intact. Four LOGICAL column UNITS per section, not four arbitrary equal cards always. Valid patterns are 4; 2+2; 1+3; 3+1; 1+2+1; 1+1+1+1; 1+1+2; 2+1+1. Heights depend on widget type/content and its supported choices. Do not imply a pixel-height limit, universal freely resizable cards, masonry layout or extra row-span model. +There is NO permanent narrow settings sidebar required. Page arrangement uses the whole available work area. Dedicated section configuration and a generous widget configurator are separate contexts in same page working draft, with explicit return retaining open edits. No per-widget persistence button required; no new approval chain. +Shared example page: Abschnitt1 "Einstieg" full width (4 units), can be compact in overview. Abschnitt2 "Training im Alltag", layout1+1+2 with THREE neighboring different-width widgets: first a Themenkarte "Grenzen" uses1unit; second Programmkarte "Programm Abstand" uses1unit, selected when relevant; third Bild und Text "Gemeinsam üben" uses2units. Show different natural heights (first short, second taller, third a different supported presentation height) with empty space below shorter cards in SAME section, not masonry. Abschnitt3 "Häufige Fragen" fullwidth4 can be compact below. +Program widget references Programm Abstand (Programm) and normally uses its central editorial title, summary and cover. Sample central summary "Ein Trainingsprogramm über Nähe, Abstand und persönliche Grenzen." No price/buy CTA. Central editing is through Redaktionsmanager, optional widget-level overrides local only. Pure page widgets may own page-specific text; do not require a product source for every page sentence. +No new public-profile mechanism, content-version requirement for presentation media, license pricing, database fields, user management, AI composer or workflow metrics. Generated photos merely illustrate training/park situations. Use simple separators and clear whitespace, avoid card nesting, compact ordinary 14-16px body text, legible field labels. +Each image is a single working state, not a collage or a choice between multiple designs. +Working state name: Bausteinkonfigurator mit zentraler Quelle. +Reference1 is the new whole-page arrangement of this SAME proposal. Reference2 is prior roomy widget-focus concept. Reference3 is actual current display-options dialog grounding existing controls. +Show a generous WIDGET configurator as a context of same page draft, not a narrow permanent right sidebar. Preserve global page header and one page-level save action. Clear back link "Zur Seite", heading "Programmkarte konfigurieren", subtitle "Abschnitt2 · Platz2 · 1 Rastereinheit". Neighboring cards remain available by returning to actual page, not shown as fake current full page. +Immediately below a compact source strip: "Quelle: Programm Abstand (Programm)" with a small "Zentrale Texte und Präsentationsmedien" descriptor and action "Redaktionsmanager öffnen". This source action edits global object data; it is NOT another editor for page-only text. +Inside configurator tabs "Quelle & Inhalt", "Medien", "Darstellung" SELECTED. The user can access full configuration without squeezing every control into the page inspector. +Two main areas: LEFT about60% for readable display controls, RIGHT about40% Bausteinvorschau. No card nesting or price/license settings. +Exact current ProgramCard-supported display controls: +"Anordnung" with two large option buttons "Anpassend" SELECTED and "Bild über dem Text". +"Höhe" with two option buttons "Natürliche Höhe" SELECTED and "An die Zeile angleichen". +A short hint "Die Breite ergibt sich aus dem Rasterplatz. Die Höhe folgt Inhalt und Darstellung." No arbitrary width selector inside widget; no pixel height limit. +Two compact paired field rows: +"Bildformat" dropdown "Querformat16:9"; "Bilddarstellung" dropdown "Ausschnitt". +"Überschriftenebene" dropdown "H3"; a small switch "Kurzbeschreibung anzeigen" on. +A simple collapsed "Weitere Anzeigeoptionen" row may expose metadata/action options, not an enormous generic form. The object's kind Program is always shown; do NOT add toggle to hide that kind. Image-focus/crop controls and central image choice are available in Medien tab, not every configuration simultaneously visible. +Right heading "Bausteinvorschau", small "Aktueller Platz · 1 Einheit". Show a single natural-width program card with image above title, central title Programm Abstand, central summary exactly "Ein Trainingsprogramm über Nähe, Abstand und persönliche Grenzen." It is narrow because real slot is1unit, not forced side-by-side photo/text by the wider configurator. Label "Angaben aus der zentralen Redaktion" below preview. No giant public page and no claim these media already public in real instance. +Optional small source-context action "Quelle ansehen" only if not duplicate. No manual repeated central name/description entry in active Darstellung tab. Local text overrides remain accessible in Quelle & Inhalt and explicitly scoped to this card, not default duplicated authoring. +At bottom a concise note "Darstellungsänderungen gelten nur für diese Karte. Offene Seiteneingaben bleiben erhalten." No separate widget save or Übernehmen button, no approve action. Show the practical space for full editor and clear connection to central Redaktion. +``` + +## Gezielte Korrektur der Abschnittsaufnahme + +Erste Ausgabe: `exec-61cc784d-0a7f-4481-862a-8b669acc81cd.png`. Der Rasterknopf „4“ zeigte fälschlich vier getrennte Balken. Er wurde vor Ablage der finalen Referenz korrigiert. Finale Ausgabe: `exec-e8c9c0f6-87b4-4b0a-836c-33e0da915ab1.png`, im Paket als `cms-weiterentwicklung-abschnitt-v1.png`. Die erste unzutreffende Ausgabe ist keine gültige Referenz. + +### Exakter Korrekturprompt + +```text +Edit the attached CMS section-configuration screenshot with ONE precise correction. Preserve the full UI layout, typography, text, controls, previews, colours and all other raster buttons. +In the upper-left Raster choice labelled "4", the current graphic incorrectly shows FOUR separate small grey rectangles. Replace ONLY that graphic with ONE SINGLE continuous wide grey rectangle spanning the same schematic width. Label stays "4". This denotes one full-width slot spanning four logical units. +The distinct second-row button labelled "1 + 1 + 1 + 1" must continue to show four separate equal rectangles. All other valid pattern graphics and selected1+1+2 remain exactly as shown. +Do not redesign or add anything. Target same1511x1041 aspect ratio, natural no stretching. +``` + diff --git a/docs/ux/verwaltung/generierung/cms-prompts.md b/docs/ux/verwaltung/generierung/cms-prompts.md new file mode 100644 index 0000000..34fb538 --- /dev/null +++ b/docs/ux/verwaltung/generierung/cms-prompts.md @@ -0,0 +1,128 @@ +# CMS-Seiteneditor – Generierung der Anordnungen + +Datum: 19.11.2026. Integrierter Bildgenerator. Drei unabhängige CMS-Anordnungen innerhalb des bereits gewählten Verwaltungsrahmens. Reihenfolge entspricht der tatsächlichen Anzeige im Gespräch. Keine Anordnung ausgewählt und keine Umsetzung. + +## Referenzen aller Aufrufe + +1. [B15: verschachtelter CMS-Editor](../audit/15-cms-editor.jpg), vorhandene Fähigkeiten und zu reduzierende Strukturmechanik. +2. [B16: Widgetdialog](../audit/16-cms-widgetdialog.jpg), Inhalts-, Medien- und Darstellungsaufgaben. +3. [B19: kompakte Struktur](../audit/19-cms-struktur-revisionen.jpg), positive strukturelle Referenz. +4. [B18: Seitenausgabe in Vorschau](../audit/18-cms-geraetevorschau.jpg), vorhandener Ausgabe-/Vorschaurahmen. +5. [Gewählter Verwaltungsrahmen](../bilder/aufbau-kombiniert-v1.png). + +Die Quellen wurden direkt betrachtet und als lokale Bildreferenzen an jeden Aufruf übergeben. Sie sind frühere Auditbelege, kein neuer Live-Audit. Die bekannte Anmeldegrenze ist in Dokument 11 erhalten; die Fortführung der Entwurfsarbeit wurde danach vom Auftraggeber beauftragt. + +## Angezeigter Entwurf 1: Struktur und fester Bearbeitungsbereich + +Ausgabe: [cms-01-struktur-bearbeitung.png](../bilder/cms-01-struktur-bearbeitung.png). + +### Exakter Prompt + +```text +Use case: ui-mockup. Create realistic production-quality German desktop CMS administration UI for Lara & Felix. ONE independent focused design, not a collage, no browser or device frame. Target 1487 x 1058. Current date anchor 19 November 2026; no dates need be shown. +Reference images: image 1 current CMS expanded editor demonstrates excessive nested frames to improve, image 2 current widget dialog provides real field/content patterns, image 3 current compact CMS outline is a positive reference, image 4 existing real rendered page preview grounds CMS output and brand, image 5 is the selected new admin frame to MATCH for administration. Preserve the approved quiet white admin surfaces, navy typography, green primary action, restrained blue selection and sensible spacing. Existing public widget styling is its own rendered content, never turn admin into a promotional landing page. +Context: owner-operated platform, modest catalog, usually one editor. Keep Laravel/Filament/Livewire-compatible existing CMS model Page -> Sections -> Slots -> Widget. Existing widget registry, section grids, central media and program references, revisions and renderers remain. Do not invent another CMS, freeform absolute-position canvas, AI composer, dashboards or seven-stage release process. +Global left nav exactly "Lara & Felix", "Verwaltung"; Arbeitsplatz, Medien, Inhalte, Angebote, Website SELECTED, Kunden. Approx 210px wide like reference 5. Breadcrumb "Website / Seiten / Prävention im Alltag". Page title "Prävention im Alltag". Header status "Entwurf · Änderungen nicht gespeichert" with amber indicator. Separate quiet fact "Öffentlich: Revision 12". This is illustrative data, not claims about actual content of reference screenshots. +Header right: ONE primary green "Entwurf speichern", secondary outlined eye "Seitenvorschau", subdued supporting "Veröffentlichen…" (not a green competing button). This CMS action may save and publish the current page draft through the existing explicit flow, no new business-release process. Shared page tabs "Seiteninhalt" active, "Seiteneinstellungen", "Verlauf". Address and SEO belong to Seiteneinstellungen rather than a permanent giant form above the content. +Same example page composition in all designs: +- Abschnitt 1 "Einstieg", grid 4 full width, widget Einstieg (Hero). +- Abschnitt 2 "Training im Alltag", grid 2 + 2: first slot Bild und Text; second slot Programmkarte "Programm Abstand", SELECTED. +- Abschnitt 3 "Häufige Fragen", grid 4, widget FAQ. +Use natural training/park thumbnails, not placeholder posters or giant decorative background art. Page output may show headline "Stark im Alltag", a concise text about personal boundaries, a small program card, and FAQ; no price, purchase CTA or invented shop. +Current editing target is the ONE program-card widget in Abschnitt 2, second slot. Do not mix page settings, section layout and all widget controls into one panel. +Selected widget content editor: +heading "Programmkarte"; path "Abschnitt 2 · Training im Alltag". Tabs "Inhalt" active, "Medien", "Darstellung". +Source line "Quelle: Programm Abstand (Programm)" and link "Redaktion öffnen" for shared source editorial manager, with context/return handled later. Source is a reference, not copied data. +"Überschrift": effective value "Programm Abstand", subtle label "Aus Programm übernommen"; supporting link "Hier anpassen". +"Kurztext": own local override textarea "Übungen für mehr Sicherheit im Alltag." and label "Eigene Angabe für diese Karte"; small "Wieder übernehmen" action. +Small scope note "Lokale Änderungen gelten nur für diese Karte." It must not say source editing has only local effect. +Media tab would use the shared media picker and show website permission, not a text radio list. Do not put all media and display settings permanently into active Inhalt tab. +Reordering sections and widgets uses targeted handles and keyboard alternatives, and only valid destinations. No drag handles on every nested frame. Selected-widget menu can expose duplicate/remove-assignment; never present global source deletion as removing a widget. +Any widget preview is identified "Bausteinvorschau"; it should include its section surface where relevant. Page preview is distinct, names draft/revision and device width, never claims an unapproved source asset publicly available. Current page editor in images is NOT proof of functional rendering. +Keep at most two main content areas after global navigation. Use whitespace and simple dividers instead of nested cards. Natural readable type 14-16px body, page title max36, stable control placements. Source fields should be truly readable, and UI fit viewport with no overlapping/clipped controls. No huge full-page explanatory banners, no field inventory, no extra template/global-section functionality. +Direction name: Struktur und fester Bearbeitungsbereich. +Under the page tabs create a 33%-wide compact structural outline on the left and a 67%-wide selected-widget editor on the right. The positive outline reference 3 and selected program workspace frame reference 5 guide grouping. +Outline header "Seitenstruktur", quiet "+ Abschnitt" action. Three compact section groups with ordinal 1/2/3 and small grid summary "4" or "2 + 2". First/third collapsed enough to read names. Second expanded shows its two slots as indented thumbnail rows: "Bild und Text", and SELECTED "Programmkarte · Programm Abstand" with thin blue outline. The grouping visibly distinguishes section and contained widget, without repeated raster panels. Place movement alternatives only for selected meaningful target, not every row. +Main right pane contains the selected widget editor as specified, with spacious form for inherited heading and the ONE local short-text override. Section layout controls appear only if the section itself is selected; do not show all raster choices now. +A modest lower "Bausteinvorschau" can show the program card on its section surface, but do not let it dominate the active editing pane or add another full webpage. It is okay to show a collapsed preview link if that keeps the active form legible. +User model: always see where the widget sits while editing at a stable place; navigate by structure, not by scrolling through many giant sections. Main source/display tools are accessible in respective tabs. No modal overlay. +``` + +## Angezeigter Entwurf 2: Visuelle Seitenfläche mit Kontextinspektor + +Ausgabe: [cms-02-seitenflaeche-inspektor.png](../bilder/cms-02-seitenflaeche-inspektor.png). + +### Exakter Prompt + +```text +Use case: ui-mockup. Create realistic production-quality German desktop CMS administration UI for Lara & Felix. ONE independent focused design, not a collage, no browser or device frame. Target 1487 x 1058. Current date anchor 19 November 2026; no dates need be shown. +Reference images: image 1 current CMS expanded editor demonstrates excessive nested frames to improve, image 2 current widget dialog provides real field/content patterns, image 3 current compact CMS outline is a positive reference, image 4 existing real rendered page preview grounds CMS output and brand, image 5 is the selected new admin frame to MATCH for administration. Preserve the approved quiet white admin surfaces, navy typography, green primary action, restrained blue selection and sensible spacing. Existing public widget styling is its own rendered content, never turn admin into a promotional landing page. +Context: owner-operated platform, modest catalog, usually one editor. Keep Laravel/Filament/Livewire-compatible existing CMS model Page -> Sections -> Slots -> Widget. Existing widget registry, section grids, central media and program references, revisions and renderers remain. Do not invent another CMS, freeform absolute-position canvas, AI composer, dashboards or seven-stage release process. +Global left nav exactly "Lara & Felix", "Verwaltung"; Arbeitsplatz, Medien, Inhalte, Angebote, Website SELECTED, Kunden. Approx 210px wide like reference 5. Breadcrumb "Website / Seiten / Prävention im Alltag". Page title "Prävention im Alltag". Header status "Entwurf · Änderungen nicht gespeichert" with amber indicator. Separate quiet fact "Öffentlich: Revision 12". This is illustrative data, not claims about actual content of reference screenshots. +Header right: ONE primary green "Entwurf speichern", secondary outlined eye "Seitenvorschau", subdued supporting "Veröffentlichen…" (not a green competing button). This CMS action may save and publish the current page draft through the existing explicit flow, no new business-release process. Shared page tabs "Seiteninhalt" active, "Seiteneinstellungen", "Verlauf". Address and SEO belong to Seiteneinstellungen rather than a permanent giant form above the content. +Same example page composition in all designs: +- Abschnitt 1 "Einstieg", grid 4 full width, widget Einstieg (Hero). +- Abschnitt 2 "Training im Alltag", grid 2 + 2: first slot Bild und Text; second slot Programmkarte "Programm Abstand", SELECTED. +- Abschnitt 3 "Häufige Fragen", grid 4, widget FAQ. +Use natural training/park thumbnails, not placeholder posters or giant decorative background art. Page output may show headline "Stark im Alltag", a concise text about personal boundaries, a small program card, and FAQ; no price, purchase CTA or invented shop. +Current editing target is the ONE program-card widget in Abschnitt 2, second slot. Do not mix page settings, section layout and all widget controls into one panel. +Selected widget content editor: +heading "Programmkarte"; path "Abschnitt 2 · Training im Alltag". Tabs "Inhalt" active, "Medien", "Darstellung". +Source line "Quelle: Programm Abstand (Programm)" and link "Redaktion öffnen" for shared source editorial manager, with context/return handled later. Source is a reference, not copied data. +"Überschrift": effective value "Programm Abstand", subtle label "Aus Programm übernommen"; supporting link "Hier anpassen". +"Kurztext": own local override textarea "Übungen für mehr Sicherheit im Alltag." and label "Eigene Angabe für diese Karte"; small "Wieder übernehmen" action. +Small scope note "Lokale Änderungen gelten nur für diese Karte." It must not say source editing has only local effect. +Media tab would use the shared media picker and show website permission, not a text radio list. Do not put all media and display settings permanently into active Inhalt tab. +Reordering sections and widgets uses targeted handles and keyboard alternatives, and only valid destinations. No drag handles on every nested frame. Selected-widget menu can expose duplicate/remove-assignment; never present global source deletion as removing a widget. +Any widget preview is identified "Bausteinvorschau"; it should include its section surface where relevant. Page preview is distinct, names draft/revision and device width, never claims an unapproved source asset publicly available. Current page editor in images is NOT proof of functional rendering. +Keep at most two main content areas after global navigation. Use whitespace and simple dividers instead of nested cards. Natural readable type 14-16px body, page title max36, stable control placements. Source fields should be truly readable, and UI fit viewport with no overlapping/clipped controls. No huge full-page explanatory banners, no field inventory, no extra template/global-section functionality. +Direction name: Visuelle Seitenfläche mit Kontextinspektor. +Under the common page tabs show a large VISUAL page-editing surface about 68% of the available workspace width on left and a fixed context inspector about 32% on right. Do not add a persistent second structural sidebar; a quiet "Struktur" button can open the outline on demand. The difference from structural editing is choosing the element on its visible page representation. +Left heading "Arbeitsansicht" with small note "Ausgewählt: Abschnitt 2 · Programmkarte". The canvas shows the same example page's three sections compactly: +Einstieg: a restrained crop of a photo-with-text widget with navy heading "Stark im Alltag" and a small authentic park photograph; not a huge marketing hero. +Training im Alltag: two equal columns, "Bild und Text" content on left and the program card on right. The right card has title "Programm Abstand", current local summary "Übungen für mehr Sicherheit im Alltag.", real thumbnail, and a clear thin BLUE editing-selection outline. Selection controls visually belong to the editor, not a public purchase CTA. Section 2 context label at its top and a small section-action menu, not every grid option. This render is a working canvas; do not label this narrow area Desktop 1440px or promise full-size page fidelity. +Häufige Fragen: small visible FAQ heading and one collapsed question, below selected section. If room include quiet "+ Abschnitt hinzufügen" at bottom. Avoid nested heavy containers around every grid slot. +Right inspector: heading "Programmkarte", path "Abschnitt 2 · Training im Alltag", tabs "Inhalt", "Medien", "Darstellung", and precisely the common source/heading/local-shorttext fields. The own local override textarea must be actually readable, the source line and "Redaktion öffnen" access clear. A compact overflow menu may expose movement, duplicate and remove from page, without duplicating a whole toolbar on every canvas block. +The page-wide preview is still the top "Seitenvorschau" button; do not add a second redundant full-page preview or lower card preview in inspector, since the canvas already shows it. +User model: see roughly the result on the left and select a widget to change its content beside it. Section layout settings appear only when selecting the section. Public and admin framing remain distinct. Use realistic spacing and complete visible controls rather than an overstuffed three-column dashboard. +``` + +## Angezeigter Entwurf 3: Großzügige Einzelbearbeitung mit Rückweg + +Ausgabe: [cms-03-einzelbearbeitung.png](../bilder/cms-03-einzelbearbeitung.png). + +### Exakter Prompt + +```text +Use case: ui-mockup. Create realistic production-quality German desktop CMS administration UI for Lara & Felix. ONE independent focused design, not a collage, no browser or device frame. Target 1487 x 1058. Current date anchor 19 November 2026; no dates need be shown. +Reference images: image 1 current CMS expanded editor demonstrates excessive nested frames to improve, image 2 current widget dialog provides real field/content patterns, image 3 current compact CMS outline is a positive reference, image 4 existing real rendered page preview grounds CMS output and brand, image 5 is the selected new admin frame to MATCH for administration. Preserve the approved quiet white admin surfaces, navy typography, green primary action, restrained blue selection and sensible spacing. Existing public widget styling is its own rendered content, never turn admin into a promotional landing page. +Context: owner-operated platform, modest catalog, usually one editor. Keep Laravel/Filament/Livewire-compatible existing CMS model Page -> Sections -> Slots -> Widget. Existing widget registry, section grids, central media and program references, revisions and renderers remain. Do not invent another CMS, freeform absolute-position canvas, AI composer, dashboards or seven-stage release process. +Global left nav exactly "Lara & Felix", "Verwaltung"; Arbeitsplatz, Medien, Inhalte, Angebote, Website SELECTED, Kunden. Approx 210px wide like reference 5. Breadcrumb "Website / Seiten / Prävention im Alltag". Page title "Prävention im Alltag". Header status "Entwurf · Änderungen nicht gespeichert" with amber indicator. Separate quiet fact "Öffentlich: Revision 12". This is illustrative data, not claims about actual content of reference screenshots. +Header right: ONE primary green "Entwurf speichern", secondary outlined eye "Seitenvorschau", subdued supporting "Veröffentlichen…" (not a green competing button). This CMS action may save and publish the current page draft through the existing explicit flow, no new business-release process. Shared page tabs "Seiteninhalt" active, "Seiteneinstellungen", "Verlauf". Address and SEO belong to Seiteneinstellungen rather than a permanent giant form above the content. +Same example page composition in all designs: +- Abschnitt 1 "Einstieg", grid 4 full width, widget Einstieg (Hero). +- Abschnitt 2 "Training im Alltag", grid 2 + 2: first slot Bild und Text; second slot Programmkarte "Programm Abstand", SELECTED. +- Abschnitt 3 "Häufige Fragen", grid 4, widget FAQ. +Use natural training/park thumbnails, not placeholder posters or giant decorative background art. Page output may show headline "Stark im Alltag", a concise text about personal boundaries, a small program card, and FAQ; no price, purchase CTA or invented shop. +Current editing target is the ONE program-card widget in Abschnitt 2, second slot. Do not mix page settings, section layout and all widget controls into one panel. +Selected widget content editor: +heading "Programmkarte"; path "Abschnitt 2 · Training im Alltag". Tabs "Inhalt" active, "Medien", "Darstellung". +Source line "Quelle: Programm Abstand (Programm)" and link "Redaktion öffnen" for shared source editorial manager, with context/return handled later. Source is a reference, not copied data. +"Überschrift": effective value "Programm Abstand", subtle label "Aus Programm übernommen"; supporting link "Hier anpassen". +"Kurztext": own local override textarea "Übungen für mehr Sicherheit im Alltag." and label "Eigene Angabe für diese Karte"; small "Wieder übernehmen" action. +Small scope note "Lokale Änderungen gelten nur für diese Karte." It must not say source editing has only local effect. +Media tab would use the shared media picker and show website permission, not a text radio list. Do not put all media and display settings permanently into active Inhalt tab. +Reordering sections and widgets uses targeted handles and keyboard alternatives, and only valid destinations. No drag handles on every nested frame. Selected-widget menu can expose duplicate/remove-assignment; never present global source deletion as removing a widget. +Any widget preview is identified "Bausteinvorschau"; it should include its section surface where relevant. Page preview is distinct, names draft/revision and device width, never claims an unapproved source asset publicly available. Current page editor in images is NOT proof of functional rendering. +Keep at most two main content areas after global navigation. Use whitespace and simple dividers instead of nested cards. Natural readable type 14-16px body, page title max36, stable control placements. Source fields should be truly readable, and UI fit viewport with no overlapping/clipped controls. No huge full-page explanatory banners, no field inventory, no extra template/global-section functionality. +Direction name: Großzügige Einzelbearbeitung mit Rückweg. +Keep exactly the common page header, global navigation, page tabs, illustrative current/public state and page-level actions. This is a focused MODE of the same page editor, not an independent widget administration or modal blocking the page actions. +Under page tabs show a prominent but quiet left-arrow text link "Zur Seitenstruktur", then heading "Programmkarte bearbeiten", breadcrumb/path "Abschnitt 2 · Training im Alltag · Platz 2". A short note "Änderungen bleiben im Seitenentwurf erhalten." The normal page outline is off screen in this focus mode and returns through that link with selection, open edits and scroll position retained. +Use the broad workspace for TWO areas: about 55% content editor on left, 45% isolated Bausteinvorschau on right. Do not insert another nested sidebar or all-page canvas. This differs from direction with permanent outline: here the editor gains room and the source context is explicit. +Left editor tabs Inhalt active, Medien, Darstellung. Content pane contains the shared source and inheritance controls, inherited heading with "Hier anpassen", own local Kurztext textarea with the exact shared sentence and "Wieder übernehmen", plus the exact local scope note. No other field inventory and no new asset/version/release settings. +Right area heading "Bausteinvorschau", sublabel "Im Kontext von Abschnitt 2". A well-proportioned single program card on a quiet light section surface shows natural training image, title Programm Abstand and summary matching own edited text. It is not a big shop page or the full page preview. Do not label this preview public/approved or Desktop1440. Small link "Ganze Seite prüfen" may refer to the same page preview but avoid duplicating actions if it creates clutter. +Below the editor/preview pair a quiet full-width context strip can state "Diese Karte verwendet Angaben aus Programm Abstand. Eigene Angaben überschreiben nur diese Verwendung." If it duplicates existing note omit it. +There is NO per-widget Save or Übernehmen button. Changes in this focused editing mode remain in the in-memory page working draft; top "Entwurf speichern" is the one explicit persistence action. Return does not silently discard or publish. Keep the top supporting Veröffentlichen… visible as page action, not a third widget release button. +User model: focus on one content unit with adequate room, inspect its actual card next to fields, then return one step to the page outline. Strong typographic hierarchy and ordinary product UI, not a wizard or dashboard. +``` + diff --git a/docs/ux/verwaltung/generierung/redaktion-prompts.md b/docs/ux/verwaltung/generierung/redaktion-prompts.md new file mode 100644 index 0000000..5737f35 --- /dev/null +++ b/docs/ux/verwaltung/generierung/redaktion-prompts.md @@ -0,0 +1,94 @@ +# Redaktionsarbeitsplatz – Bildprompts und Referenzen + +Datum: 19.11.2026. Integrierter Bildgenerator. Drei unabhängige Anordnungen in der bereits gewählten Gestaltungsrichtung; noch keine ausgewählt. Die Nummern entsprechen der tatsächlichen Anzeigereihenfolge im Gespräch. + +Referenzen für alle drei Aufrufe: + +1. [Bestätigter Rahmen](../bilder/aufbau-kombiniert-v1.png). +2. [Gewählter Auswahlbaustein](../bilder/auswahl-01-liste-detail-v2.png). +3. [Audit B13](../audit/13-medium-praesentationspicker.jpg), als Negativbeleg der textbasierten Medienauswahl, nicht als Zielbild. + +## Angezeigter Entwurf 1: Redaktionsübersicht mit gezielter Bearbeitung + +Ausgabe: [redaktion-01-uebersicht.png](../bilder/redaktion-01-uebersicht.png). + +### Exakter Prompt + +```text +Create a realistic production-quality German desktop administration UI for Lara & Felix. Focused primary screen, ONE design, no collage, no external device frame. Target 1487 x 1058, natural desktop ratio. Current date anchor 19 November 2026; no dates needed. +Reference image 1 is the approved admin frame: preserve white surfaces, dark navy typography, restrained green actions, spacing and quiet navigation. Reference image 2 is the chosen shared media picker: use it to ground visual-media treatment; do NOT show the picker open on this screen. Reference image 3 is the audited old radio-list form: negative UX evidence only; do NOT reproduce its long form or text-only radio media selection. +Product: owner-operated platform with modest catalog and usually one editor. This is a reusable editorial workspace embedded at a domain object, the same patterns for media, modules, programs, license articles and future training plans. Not a separate CMS, not a generic giant shop or marketing dashboard. +Keep global navigation: Lara & Felix / Verwaltung; Arbeitsplatz, Medien, Inhalte, Angebote, Website, Kunden. Angebote selected because example is a license article. Breadcrumb "Lizenzartikel / Programm Abstand". Page title "Programm Abstand"; clear smaller descriptor "Redaktion · Lizenzartikel". Amber small status "Änderungen nicht gespeichert". Top right secondary eye action "Ausgabe prüfen", ONE primary green action "Redaktion speichern". No approve/publish button and no commercial inputs. Small local statement in editorial area "Gespeicherte Angaben werden in verwendenden Ansichten aktualisiert." Do not claim editorial changes have no public effect. +Object section tabs "Übersicht", "Redaktion" selected, "Verlauf". These tab names are illustrative. The underlying source is "Programm Abstand (Programm)". +Shared illustrative data, same in all images: +Text group "Texte". Name "Programm Abstand" inherited from source. Teaser "Eigene Grenzen erkennen und im Alltag sicher handeln." inherited from source. Kurzbeschreibung is the currently selected and editable OWN override, two natural sentences "Ein Trainingsprogramm über Nähe, Abstand und persönliche Grenzen. Mit Modulen und Materialien für die Arbeit mit Gruppen." Explicit label "Eigene Angabe"; source affordance "Übernommenen Text ansehen" or "Wieder übernehmen". Full description is available by a compact two-line excerpt and editing action, not a huge empty rich-text form. Avoid creating a separate media object for any description. +Text provenance must be visible per field where relevant, "Übernommen aus Programm Abstand" versus "Eigene Angabe". Never imply every object inherits from a parent. Editing this license article's own override does not edit the source program. No invented rule for blending multiple sources. +Classifications show a compact grouped summary "Einordnung": Thema "Grenzen", Zielgruppe "Trainer", Einsatz "Training". These are independent descriptive classifications, not use history or permissions; no giant checkbox grid. +Media group "Präsentationsmedien", all references to central media manager. Own assignments for this example; no implicit copying. Title image "Abstand – Titelbild": small natural photo of training situation, Website status freigegeben. Trailer group contains TWO distinct video thumbnails: "Abstand kurz erklärt", duration 0:42, "Für Website freigegeben"; "Abstand im Alltag", duration 1:05, amber "Nicht für Website freigegeben". Gallery group three small training photographs, label "Galerie · 3 Bilder". Each role can contain multiple assignments; do not imply trailers unique. Role is not file type. Source videos are presentation media, do not require a teaching-content version; do NOT display Fassung required errors. +Use simple realistic training/park imagery as illustrations, restrained no decorative hero art. Each current assignment has a clear thumbnail and readable title; selected assignment exposes replace/remove-from-role options, without delete-original wording. Media group has a quiet "+ Medien zuordnen" action which would use the existing shared picker, no radio list. Ordered groups show drag handles and a compact up/down alternative at selection. Removal means unlink, not delete original. +The unapproved video may be visible inside admin with its warning; it is not shown as publicly available. Do not add a global warning that blocks saving all text because one medium lacks website permission. No seven release badges, prices, entitlements, participant tables, technical schemas, metrics, or shop product page embedded as the main editor. +Typography legible 14-16px at design scale, clean alignments, comfortable text measure. Use hierarchy, whitespace and separators before cards. No card nesting or giant form-field inventory. Do not cram every minor feature; keep source and field scope clear. +Direction name: Redaktionsübersicht mit gezielter Bearbeitung. +Layout: under object tabs a two-column editorial overview, texts around 55% width on left and assigned presentation media 45% on right. All primary information visible simultaneously. Sections sit on one plain surface separated by lightweight rules, not a grid of decorative cards. +Left: compact read-only display name and inherited teaser with subtle provenance and pencil actions. Selected Kurzbeschreibung shows a medium textarea directly inside its section, OWN override marker and a link to inspect the source text. Full description is a short folded excerpt below, then compact classification summary. +Right: media grouped visibly by role, one title image row, two ordered trailer rows with thumbnails and distinct public statuses, a three-image gallery strip. Group-level add action. A selected trailer reveals concise "Austauschen" and "Zuordnung entfernen" actions; other rows not overloaded with buttons. Make the two trailers unmistakably two entries under same role. +User model: read current editorial coverage at a glance; click a field or media assignment to edit that small part locally. No additional side inspector. No whole screen composed as the public product page. Fit viewport naturally. +``` + +## Angezeigter Entwurf 2: Redaktionsnavigator mit festem Detailbereich + +Ausgabe: [redaktion-02-navigator-detail.png](../bilder/redaktion-02-navigator-detail.png). + +### Exakter Prompt + +```text +Create a realistic production-quality German desktop administration UI for Lara & Felix. Focused primary screen, ONE design, no collage, no external device frame. Target 1487 x 1058, natural desktop ratio. Current date anchor 19 November 2026; no dates needed. +Reference image 1 is the approved admin frame: preserve white surfaces, dark navy typography, restrained green actions, spacing and quiet navigation. Reference image 2 is the chosen shared media picker: use it to ground visual-media treatment; do NOT show the picker open on this screen. Reference image 3 is the audited old radio-list form: negative UX evidence only; do NOT reproduce its long form or text-only radio media selection. +Product: owner-operated platform with modest catalog and usually one editor. This is a reusable editorial workspace embedded at a domain object, the same patterns for media, modules, programs, license articles and future training plans. Not a separate CMS, not a generic giant shop or marketing dashboard. +Keep global navigation: Lara & Felix / Verwaltung; Arbeitsplatz, Medien, Inhalte, Angebote, Website, Kunden. Angebote selected because example is a license article. Breadcrumb "Lizenzartikel / Programm Abstand". Page title "Programm Abstand"; clear smaller descriptor "Redaktion · Lizenzartikel". Amber small status "Änderungen nicht gespeichert". Top right secondary eye action "Ausgabe prüfen", ONE primary green action "Redaktion speichern". No approve/publish button and no commercial inputs. Small local statement in editorial area "Gespeicherte Angaben werden in verwendenden Ansichten aktualisiert." Do not claim editorial changes have no public effect. +Object section tabs "Übersicht", "Redaktion" selected, "Verlauf". These tab names are illustrative. The underlying source is "Programm Abstand (Programm)". +Shared illustrative data, same in all images: +Text group "Texte". Name "Programm Abstand" inherited from source. Teaser "Eigene Grenzen erkennen und im Alltag sicher handeln." inherited from source. Kurzbeschreibung is the currently selected and editable OWN override, two natural sentences "Ein Trainingsprogramm über Nähe, Abstand und persönliche Grenzen. Mit Modulen und Materialien für die Arbeit mit Gruppen." Explicit label "Eigene Angabe"; source affordance "Übernommenen Text ansehen" or "Wieder übernehmen". Full description is available by a compact two-line excerpt and editing action, not a huge empty rich-text form. Avoid creating a separate media object for any description. +Text provenance must be visible per field where relevant, "Übernommen aus Programm Abstand" versus "Eigene Angabe". Never imply every object inherits from a parent. Editing this license article's own override does not edit the source program. No invented rule for blending multiple sources. +Classifications show a compact grouped summary "Einordnung": Thema "Grenzen", Zielgruppe "Trainer", Einsatz "Training". These are independent descriptive classifications, not use history or permissions; no giant checkbox grid. +Media group "Präsentationsmedien", all references to central media manager. Own assignments for this example; no implicit copying. Title image "Abstand – Titelbild": small natural photo of training situation, Website status freigegeben. Trailer group contains TWO distinct video thumbnails: "Abstand kurz erklärt", duration 0:42, "Für Website freigegeben"; "Abstand im Alltag", duration 1:05, amber "Nicht für Website freigegeben". Gallery group three small training photographs, label "Galerie · 3 Bilder". Each role can contain multiple assignments; do not imply trailers unique. Role is not file type. Source videos are presentation media, do not require a teaching-content version; do NOT display Fassung required errors. +Use simple realistic training/park imagery as illustrations, restrained no decorative hero art. Each current assignment has a clear thumbnail and readable title; selected assignment exposes replace/remove-from-role options, without delete-original wording. Media group has a quiet "+ Medien zuordnen" action which would use the existing shared picker, no radio list. Ordered groups show drag handles and a compact up/down alternative at selection. Removal means unlink, not delete original. +The unapproved video may be visible inside admin with its warning; it is not shown as publicly available. Do not add a global warning that blocks saving all text because one medium lacks website permission. No seven release badges, prices, entitlements, participant tables, technical schemas, metrics, or shop product page embedded as the main editor. +Typography legible 14-16px at design scale, clean alignments, comfortable text measure. Use hierarchy, whitespace and separators before cards. No card nesting or giant form-field inventory. Do not cram every minor feature; keep source and field scope clear. +Direction name: Redaktionsnavigator mit festem Detailbereich. +The primary difference is navigation and editing focus, NOT brand style. Under the object tabs create a compact editorial navigator about 260px wide on the left and a broad stable editing pane to its right. This editorial navigator is inside the workspace, distinct from the global sidebar. It is grouped by purpose, not a long form. +Navigator: "Texte" group with Name (small inherited indicator), Teaser (inherited), "Kurzbeschreibung" selected (Eigene Angabe), Beschreibung. Then "Einordnung" with a compact summary "Grenzen · Trainer · Training". Then "Präsentationsmedien" with compact thumbnail-led role summaries "Titelbild · 1", "Trailer · 2" and "Galerie · 3". Do not fill the navigator with technical status badges. A small teaser summary is readable on the navigator, not just names of empty field categories. +Right editor pane: heading "Kurzbeschreibung", small "Eigene Angabe für diesen Lizenzartikel"; calm source line "Quelle: Programm Abstand (Programm)" with link "Übernommenen Text ansehen". One comfortable medium textarea with the shared two-sentence own description. Supporting link "Wieder übernehmen" and explanatory text "Ändert nur die eigene Beschreibung dieses Lizenzartikels." This is a source choice, not another Save step. +Lower right pane: an accessible compact "Präsentationsmedien" overview, so visual assets remain visible while editing text. Use one title image thumbnail, TWO trailer rows grouped under Trailer with name, duration, explicit website permission text (one allowed, one not), and a compact 3-image gallery strip. No duplicate role media listings full-size in both navigator and detail. A single "+ Medien zuordnen" button above this lower media summary. Clicking a role in navigator would open its detailed editing workspace in this stable right pane; don't show a second fake Save button. +User model: move between tasks via a short consistent navigator; editing controls stay at a stable place. Do not drift into a generic settings menu with no visible text/media summary. Ensure the current editorial state can be understood without opening six dialogs. Avoid squeezing the active editor to make every field visible. +``` + +## Angezeigter Entwurf 3: Direkt bearbeitbare Redaktionsfläche mit Quellenkontext + +Ausgabe: [redaktion-03-direkt-kontext.png](../bilder/redaktion-03-direkt-kontext.png). + +### Exakter Prompt + +```text +Create a realistic production-quality German desktop administration UI for Lara & Felix. Focused primary screen, ONE design, no collage, no external device frame. Target 1487 x 1058, natural desktop ratio. Current date anchor 19 November 2026; no dates needed. +Reference image 1 is the approved admin frame: preserve white surfaces, dark navy typography, restrained green actions, spacing and quiet navigation. Reference image 2 is the chosen shared media picker: use it to ground visual-media treatment; do NOT show the picker open on this screen. Reference image 3 is the audited old radio-list form: negative UX evidence only; do NOT reproduce its long form or text-only radio media selection. +Product: owner-operated platform with modest catalog and usually one editor. This is a reusable editorial workspace embedded at a domain object, the same patterns for media, modules, programs, license articles and future training plans. Not a separate CMS, not a generic giant shop or marketing dashboard. +Keep global navigation: Lara & Felix / Verwaltung; Arbeitsplatz, Medien, Inhalte, Angebote, Website, Kunden. Angebote selected because example is a license article. Breadcrumb "Lizenzartikel / Programm Abstand". Page title "Programm Abstand"; clear smaller descriptor "Redaktion · Lizenzartikel". Amber small status "Änderungen nicht gespeichert". Top right secondary eye action "Ausgabe prüfen", ONE primary green action "Redaktion speichern". No approve/publish button and no commercial inputs. Small local statement in editorial area "Gespeicherte Angaben werden in verwendenden Ansichten aktualisiert." Do not claim editorial changes have no public effect. +Object section tabs "Übersicht", "Redaktion" selected, "Verlauf". These tab names are illustrative. The underlying source is "Programm Abstand (Programm)". +Shared illustrative data, same in all images: +Text group "Texte". Name "Programm Abstand" inherited from source. Teaser "Eigene Grenzen erkennen und im Alltag sicher handeln." inherited from source. Kurzbeschreibung is the currently selected and editable OWN override, two natural sentences "Ein Trainingsprogramm über Nähe, Abstand und persönliche Grenzen. Mit Modulen und Materialien für die Arbeit mit Gruppen." Explicit label "Eigene Angabe"; source affordance "Übernommenen Text ansehen" or "Wieder übernehmen". Full description is available by a compact two-line excerpt and editing action, not a huge empty rich-text form. Avoid creating a separate media object for any description. +Text provenance must be visible per field where relevant, "Übernommen aus Programm Abstand" versus "Eigene Angabe". Never imply every object inherits from a parent. Editing this license article's own override does not edit the source program. No invented rule for blending multiple sources. +Classifications show a compact grouped summary "Einordnung": Thema "Grenzen", Zielgruppe "Trainer", Einsatz "Training". These are independent descriptive classifications, not use history or permissions; no giant checkbox grid. +Media group "Präsentationsmedien", all references to central media manager. Own assignments for this example; no implicit copying. Title image "Abstand – Titelbild": small natural photo of training situation, Website status freigegeben. Trailer group contains TWO distinct video thumbnails: "Abstand kurz erklärt", duration 0:42, "Für Website freigegeben"; "Abstand im Alltag", duration 1:05, amber "Nicht für Website freigegeben". Gallery group three small training photographs, label "Galerie · 3 Bilder". Each role can contain multiple assignments; do not imply trailers unique. Role is not file type. Source videos are presentation media, do not require a teaching-content version; do NOT display Fassung required errors. +Use simple realistic training/park imagery as illustrations, restrained no decorative hero art. Each current assignment has a clear thumbnail and readable title; selected assignment exposes replace/remove-from-role options, without delete-original wording. Media group has a quiet "+ Medien zuordnen" action which would use the existing shared picker, no radio list. Ordered groups show drag handles and a compact up/down alternative at selection. Removal means unlink, not delete original. +The unapproved video may be visible inside admin with its warning; it is not shown as publicly available. Do not add a global warning that blocks saving all text because one medium lacks website permission. No seven release badges, prices, entitlements, participant tables, technical schemas, metrics, or shop product page embedded as the main editor. +Typography legible 14-16px at design scale, clean alignments, comfortable text measure. Use hierarchy, whitespace and separators before cards. No card nesting or giant form-field inventory. Do not cram every minor feature; keep source and field scope clear. +Direction name: Direkt bearbeitbare Redaktionsfläche mit Quellenkontext. +The primary difference is direct editing in a readable editorial document surface, with a slim contextual source inspector at right, not an editorial navigator and not a public shop preview. Preserve the global approved frame. +Under the object tabs use a broad main editorial canvas (about 70%) and a narrow right inspector (about 30%). The canvas shows plain readable content blocks with light separators and small pencil affordances, not labeled form rows. This is a private editorial layout, no buy CTA, no marketing hero section. +Canvas top: compact display name line and readable teaser text with subtle inherited provenance. Selected Kurzbeschreibung is expanded exactly in place as a medium textarea with the shared own two sentences; a thin blue selection rule marks only this field. Below it a folded "Ausführliche Beschreibung" excerpt and compact Einordnung chips. No duplicate text editing field in inspector. +Canvas lower half: "Präsentationsmedien" and quiet "+ Medien zuordnen"; grouped role rows: Titelbild thumbnail and readable name; Trailer contains two compact thumbnail-led rows with exact shared names, durations and contrasting website permission statements; Galerie shows three small thumbnails as an explicitly ordered strip, with individual drag handles only when selected. Do NOT put drag handles on role headings, do NOT allow trailers to be sorted into title images. Make first trailer up disabled and down enabled; second trailer up enabled and down disabled. If image gets crowded omit persistent movement actions except at selected row. +Right inspector header "Kurzbeschreibung" and contextual source explanation: "Eigene Angabe", "Gilt nur für diesen Lizenzartikel." Source section label "Quelle: Programm Abstand (Programm)" with source excerpt "Ein Programm für die Arbeit mit persönlichen Grenzen." and subdued action "Wieder übernehmen". Explain "Die Angaben am Programm bleiben unverändert." Beneath: compact "Ausgabe prüfen" contextual choices "Kachel", "Detailseite", "Mitgliederbibliothek" as buttons/links, no rendered fake public view dominating editor. These choices refer to illustrative output contexts, not targeted audience text variants and no legal release permission. A tiny small-print source note is acceptable, no extra dashboard panels. +User model: read and adjust editorial content where it appears; select a field to inspect provenance and scope at the stable right inspector. Main editor can be longer than viewport, but this frame must fit the focused content naturally and not cut buttons or text. Keep text measure comfortable, no long field inventory and no technical status cluster. +``` + diff --git a/docs/ux/verwaltung/generierung/redaktion-register.md b/docs/ux/verwaltung/generierung/redaktion-register.md new file mode 100644 index 0000000..a1b5abd --- /dev/null +++ b/docs/ux/verwaltung/generierung/redaktion-register.md @@ -0,0 +1,30 @@ +# Gemeinsame Register am Beispiel eines Unterrichtsfilms + +Datum: 19.11.2026. Integrierter Bildgenerator. Eine überarbeitete Ansicht nach Auswahl von Redaktionsentwurf 1; keine neue Richtungsserie. + +Referenzen: [Gewählte Übersicht](../bilder/redaktion-01-uebersicht.png), [gemeinsamer Picker](../bilder/auswahl-01-liste-detail-v2.png). + +Ausgabe: [Medienredaktion mit getrennten Registern](../bilder/redaktion-register-medium-v1.png). + +Status: Entwurf zur Konkretisierung der gewählten Basis. Registerbezeichnungen und Details sind weiter abzustimmen. + +## Exakter Prompt + +```text +Use case: ui-mockup, targeted refinement of the selected editorial administration design. +Create ONE realistic production-quality German desktop UI continuing reference image 1, the selected clean editorial overview. Preserve the Lara & Felix white/navy/green visual frame, legible type and quiet separators. Target 1487 x 1058, natural viewport, no external mockup frame. Current date anchor 19 November 2026; no dates needed. +User refinement: texts and presentation media should not be forced onto one screen. Reuse IDENTICAL editorial tabs and interactions on media (including teaching films), modules, programs, license articles and future training plans. This image demonstrates the same shared editorial component on a TEACHING FILM rather than a license article. Do not create a film-specific editor or a new visual style. Reference image 2 is the approved common picker, grounding visual media selection; do not show picker open. +Global nav: Lara & Felix / Verwaltung; Arbeitsplatz, Medien SELECTED, Inhalte, Angebote, Website, Kunden. +Breadcrumb "Medien / Lara im Park"; page title "Lara im Park"; subtitle "Redaktion · Medium · Unterrichtsfilm". Amber dot and "Änderungen nicht gespeichert". Top right secondary "Ausgabe prüfen" with eye icon, ONE primary green "Redaktion speichern". +At the editorial workspace level a single clear tab strip "Texte", "Präsentationsmedien" SELECTED with green underline, "Einordnung". No forced text panels alongside the media list. Do not display a separate source inheritance panel on this film; the current object owns these assignments. No universal source-parent assumption and no price/license fields. +Below tabs: heading "Präsentationsmedien für Lara im Park"; supporting one-line explanation "Zuordnungen beschreiben die Präsentation. Der Lehrinhalt bleibt unverändert." Right a quiet outlined "+ Medien zuordnen" that opens the common visual picker. No technical metadata or extra save button. +Use full available content width for clean thumbnail-led media rows grouped by ROLE. Role headings are small bold separated by thin rules, with NO drag handles on role headings. Same reusable layout on every object. Only order media inside a role. No card nesting, no decorative marketing hero and no public shop preview embedded as main editor. +Role "Titelbilder": one row, thumbnail of trainers and children in a park, title "Lara im Park – Titelbild", type "Bild", readable green status "Für Website freigegeben". Small supporting "Austauschen" and "Zuordnung entfernen" actions. No movement actions with only one item. +Role "Trailer · 2 Medien": two separate rows of referenced presentation films with thumbnails and names. +First row title "Lara im Park – Kurz erklärt", type "Film", duration "0:42", green "Für Website freigegeben". It is selected with subtle pale blue fill and thin blue outline; small label "Neu zugeordnet" if room. Selected row has drag handle, UP button visibly disabled, DOWN button enabled, supporting "Austauschen" and "Zuordnung entfernen". +Second row title "Lara im Park – Einblicke", type "Film", duration "1:05", amber "Nicht für Website freigegeben". Drag handle and UP enabled / DOWN disabled if shown. In the same row, unobtrusive link "Freigabe ansehen" points to the referenced medium, not approval of this teaching film or the whole editorial workspace. No giant warning blocking all editing. +Role "Galerie · 3 Bilder": show THREE individual thumbnail-led compact list rows or an ordered horizontal strip with distinct individual item containers, small position numbers 1,2,3, and individual action menu affordance on each. Readable titles "Training im Park", "Abstand üben", "Gemeinsam reflektieren". First/last movement limits must be correct if rendered. Do not provide a single remove button that ambiguously removes the entire gallery. This is an ordered collection, not proof of an implemented slideshow widget. +At bottom, if space, a concise note "Entfernen löst nur diese Zuordnung. Das Medium bleibt im Bestand." Do not show a new configuration wizard, global seven-release badges, content-version requirement for presentation films, commercial parameters, or hidden mandatory publishing step. +Important behavior reflected in layout: media selection uses existing shared picker, assignment is a reference, multiple media per role permitted, pure presentation videos need no teaching-content version. Original teaching film and its source file are not replaced when its presentation trailer is exchanged. Website permission is a state of the referenced presentation medium. +Use purposeful spacing, clear 14-16px body text, media thumbs about 110x65 or 140x80 depending space. Fit all required content naturally in the desktop frame with no clipped labels. This is one refined shared-tab design, not three variants. +``` diff --git a/docs/ux/verwaltung/generierung/speichern-vorschau-freigabe.md b/docs/ux/verwaltung/generierung/speichern-vorschau-freigabe.md new file mode 100644 index 0000000..0ff7997 --- /dev/null +++ b/docs/ux/verwaltung/generierung/speichern-vorschau-freigabe.md @@ -0,0 +1,23 @@ +# Konkretisierung: Speichern, Vorschau und Freigabe + +Datum: 19.11.2026. Integrierter Bildgenerator; eine Fortführung des gewählten Aufbauarbeitsplatzes, kein neuer Richtungsvergleich. + +Referenz: [Bestätigte Kombination](../bilder/aufbau-kombiniert-v1.png). + +Ausgabe: [Aufbau mit Arbeitszustand](../bilder/aufbau-zustaende-v1.png). Bild und Regeln bleiben zur Abstimmung; keine Implementierung. + +## Exakter Prompt + +```text +Use case: ui-mockup, precise refinement of an already selected administration design. +Create a realistic production-quality German desktop admin UI. This is ONE continuation of the attached selected design, not a new visual direction or a collage. Reference image 1 is the selected Lara & Felix composition workspace; preserve its typography, quiet white surfaces, dark navy text, green primary button, left navigation, compact left structure with grouped source children, and large stable right editing pane. Match its 1487 x 1058 aspect ratio; target 1487 x 1058. Current date anchor 19 November 2026; no dates need be visible. +Purpose of this refinement: show an unmistakable distinction between unsaved editing, draft lifecycle, and actual customer availability. Preserve the existing domain architecture; a program composition is NOT itself a published article or offer. +Header: breadcrumb "Programme / Programm Abstand"; large title "Programm Abstand". Below the title a calm metadata line "Aufbau · Fassung 2 · Entwurf". On its own readable line show an amber dot and exact text "Änderungen nicht gespeichert". Header right: secondary button with eye icon "Aufbau-Vorschau", primary green button "Entwurf speichern". One clear primary action. Do not add publish, activate, or release buttons to this editing state. +Below header add ONE compact quiet information strip with info icon and exact text "Sie bearbeiten den Aufbau. Bereits verfügbare Artikelstände bleiben unverändert." This refers ONLY to the structure changes shown, not all identity descriptions. +Then section navigation "Aufbau" active green underline, "Angaben", "Einordnung", "Präsentation", "Prüfung", "Verlauf". Prüfung is navigation into a later contextual review workspace, not a status badge and not an automatic approval. +Main work area: keep two columns roughly 40/60 after left global navigation. Left column heading "Aufbau · 4 Bestandteile" with secondary outlined "+ Hinzufügen". Four roots with stable position numbers and drag handles. First root selected in a light blue thin frame: "Modul Abstand", subtitle "Modul · Fassung 1 · Einstieg"; expanded subgroup in same frame with label "Inhalt der Quelle · Nur zur Ansicht" and small read-only source children "Trainerunterlage Abstand" (Text icon), "Lara im Park" (small photographic video thumbnail). Other roots collapsed: "Modul Hilfe" (Modul · Fassung 1), "Eigene Grenzen erkennen" (Modul · Fassung 1), "Nur ein allgemeiner Hinweis" (Text · Fassung 1). At bottom of left area "Position 1 von 4" with up disabled and down enabled buttons. +Right pane heading "Modul Abstand", subtitle "Verwendung in Programm Abstand"; small supporting "Weitere Aktionen" menu. Segmented tabs "An dieser Stelle" selected, "Quelle", "Inhaltsvorschau" (disambiguate source preview from Aufbau-Vorschau). +Info note "Gilt nur hier. Die Quelle bleibt unverändert." Editable field "Rolle im Programm" value "Einstieg", then "Hinweis an dieser Stelle" textarea value "Mit dem Thema Abstand beginnen." Small line below local fields "Änderungen werden mit dem Aufbau gespeichert." Do not add a second local Save button. +Minimal source reference section below if room: "Quelle: Modul Abstand · Fassung 1" and link "Quelle öffnen". Avoid duplication of all source children in right pane. +Global nav exactly as reference: Lara & Felix / Verwaltung; Arbeitsplatz, Medien, Inhalte active, Angebote, Website, Kunden. No metrics, shop product cards, commercial fields, extra dashboard panels, or notifications. Border and spacing must show grouping without making every status a badge. Legible natural German labels, clean alignment, no clipped or overlapping content. Keep meaningful editor space despite expanded header. No side-by-side states, no callout annotations, no external mockup frame. +``` diff --git a/docs/ux/verwaltung/generierung/webpraesenz-prompts.md b/docs/ux/verwaltung/generierung/webpraesenz-prompts.md new file mode 100644 index 0000000..94ae2d4 --- /dev/null +++ b/docs/ux/verwaltung/generierung/webpraesenz-prompts.md @@ -0,0 +1,108 @@ +# Webpräsenz – Generierungsnachweis + +Stand 19.11.2026. Drei einzeln erzeugte alternative Anordnungen, in der unten aufgeführten Reihenfolge im Gespräch angezeigt. Keine Variante wurde bisher gewählt. Keine neue Live-Prüfung oder Implementierung. Die erneute Browseranmeldung war weiterhin Grenze des Live-Abgleichs; die Gestaltung verwendet den bereits dokumentierten Bestand und den autorisierten Entwurfsauftrag. + +## Referenzen + +1. [Früherer Navigationsbestand](../audit/35-navigation-liste.jpg) +2. [Früherer Navigationsdialog](../audit/36-navigation-dialog.jpg) +3. [Frühere Seitenübersicht](../audit/14-cms-seitenliste.jpg) +4. [Fortgeführter Verwaltungsrahmen am Seitenaufbau](../bilder/cms-weiterentwicklung-seitenaufbau-v1.png) + +Die ersten drei Dateien sind bestehende Auditbelege, keine neuen aktuellen Aufnahmen. Die vierte dient als visuelle Referenz des weitergeführten Entwurfs. Auswahl und bekannte Bildgrenzen stehen in [Dokument 13](../13-webpraesenz-verwaltung-entwurf.md). Alle Prompts wurden mit diesen vier Referenzdateien und ohne transparenten Hintergrund einzeln ausgeführt. Beispielseiten sind illustrative Daten. Die Bilder sind keine Funktions- oder Abnahmebelege. + +## Exakte vollständige Prompts in Anzeigereihenfolge + +### 1 – Register und fester Menüeditor + +Ausgabe: [Bild](../bilder/webpraesenz-01-register-menueeditor.png); Quelldatei `exec-b5bd6965-2cbd-4ef6-b986-af190c089bef.png`. + +```text +Create a realistic production-quality German desktop administration UI for Lara & Felix, ONE independent visual option, natural 1487 x 1058 target frame, no browser/device frame, no collage. Current date anchor19November2026, no dates necessary. +References1/2 are actual prior audit captures of navigation and its edit dialog, grounding current capabilities. Reference3 is actual prior page inventory. Reference4 is the chosen new quiet admin frame: MATCH its white surfaces, navy text, green primary action, typography/spacing and restrained blue current selection. Improve old workflows without inventing a new CMS framework or visual language. +Purpose: unified WEBSITE-LEVEL workspace above individual page editing. Owner-operated modest site with one main editor. Same admin components for lists, choice, editing and return. Existing Page model and independent NavigationItem model retained; no invented compulsory page tree or deeply nested navigation. One submenu level in HEADER only. Separate FOOTER groups Service, Kontakt, Rechtliches are supported. Page inventories are not automatically menu hierarchy. +Global nav Lara & Felix / Verwaltung; Arbeitsplatz, Medien, Inhalte, Angebote, Website SELECTED, Kunden. Breadcrumb Website / Webpräsenz. Main title "Webpräsenz". Top status amber "Menüänderungen nicht gespeichert". ONE primary green "Menüänderungen speichern", secondary "Menüvorschau". Calm readable line "Wirkt nach dem Speichern auf die öffentliche Navigation." No global Publish Website button and no additional release workflow for menu edits. +Illustrative SAME data in every option, not claims about actual instance: +10 CMS pages: Start /; Konzept /konzept; Prävention im Alltag /praevention-im-alltag; Programme /programme; Für Trainer /trainer; Aktion Herbst /aktion-herbst; Neues Angebot /neues-angebot; Kontakt /kontakt; Impressum /impressum; Datenschutz /datenschutz. +All pages are Veröffentlicht EXCEPT Neues Angebot is Entwurf with no public revision. +HEADER navigation contains six entries incl one child: +1 Start -> /, visible. +2 Konzept -> /konzept, visible. + child "Prävention" -> page Prävention im Alltag /praevention-im-alltag, visible, CURRENT SELECTED menu entry. Single level of indentation. +3 Programme -> /programme, visible. +4 Für Trainer -> /trainer, visible. +5 Aktion Herbst -> /aktion-herbst, "Im Menü ausgeblendet"; target page remains Veröffentlicht. +Kontakt has placement Fußbereich:Kontakt, Impressum and Datenschutz Fußbereich:Rechtliches; footer Service group can be empty. Neues Angebot has "Ohne Menüzuordnung". Never label the hidden menu's page private or unpublished. Do not give page inventory a fake drag-to-reorder that silently changes all menus. +Current selected item editor data: "Menütext" value "Prävention"; "Zielseite" a visual reference row "Prävention im Alltag" with path and "Veröffentlicht" status; action "Ziel ändern" opens common context-appropriate page choice, not a long plain dropdown/radio list; link "Seite bearbeiten" opens page editor with preserved menu working draft. "Untermenü von" value "Konzept". Switch "Im Hauptmenü anzeigen" ON. This changes menu entry only, not page title/publication/SEO or product rights. A quiet overflow can expose "Aus Menü entfernen" without deleting page. +Reorder uses drag handles plus up/down alternatives at selected item. Valid depth only one submenu level. Changing selected entry does not auto-save, publish or lose drafts. A site preview would omit hidden Aktion Herbst but page remains reachable by URL. Selecting a draft target never publishes it automatically. +Show menu placement selector currently "Hauptmenü" with access to Fußbereich-Service/Kontakt/Rechtliches. At most two main content areas after global sidebar. Use lightweight grouped rows, no decorative dashboard cards, no metrics and no feature inventory. Readable14-16px text, complete visible controls, purposeful whitespace. Do not invent noindex implementation, homepage reassignment, global theme editor or universal Website verstecken toggle. Site-wide framework settings may be available as a quiet section link but do not fake details. +Do not confuse submenu navigation entries with a new folder/parent relationship in pages. A page can appear in multiple menus with different order and menu label. Preserve same illustrative page/menu data across options. +Direction name: Getrennte Register mit festem Menüeditor. +After header use clear top-level workspace tabs "Seiten · 10", "Menüs" ACTIVE, "Website-Rahmen". This is ONE workspace with separate focused tasks. +Under tabs: placement selector Hauptmenü, count "6 Einträge" (includes hidden and submenu entry), and one quiet "+ Eintrag hinzufügen". +Main layout two areas: left around60% the visual ordered menu tree, right40% the stable selected-item editor. Left list shows all six header entries and their target paths. Indented Prävention under Konzept selected thin blue outline; drag handles and subtle state text. Hidden Aktion Herbst row slightly muted, eye-off icon and text Im Menü ausgeblendet; show smaller Veröffentlicht status for target only if it keeps meaning clear. Do not show a public page editor in this screen. +Right heading "Menüeintrag: Prävention", compact clear scope "Hauptmenü · unter Konzept". Four selected-entry controls from common brief, with source page as readable reference rather than duplicated page content. Show small note "Die Seite bleibt unverändert. Hier ändern Sie nur den Menüeintrag." The global Save is the only persistence action; no competing local Save button. +At list bottom or selected footer include up/down alternatives clearly scoped to selected entry, not every row. Footer menu groups are selectable, not independently fabricated admin. +User model: choose Seiten tab for inventory or Menüs for ordering; fixed detail pane for a selected small menu entry. This proposed menu detail is compact enough to fit, unlike the much bigger widget configurator. Keep all six entries and complete selected editor visible. +``` + +### 2 – Seitenbestand und Menü nebeneinander + +Ausgabe: [Bild](../bilder/webpraesenz-02-seiten-menues.png); Quelldatei `exec-54d245d6-2d9e-45bd-bea8-8423a5f838a8.png`. + +```text +Create a realistic production-quality German desktop administration UI for Lara & Felix, ONE independent visual option, natural 1487 x 1058 target frame, no browser/device frame, no collage. Current date anchor19November2026, no dates necessary. +References1/2 are actual prior audit captures of navigation and its edit dialog, grounding current capabilities. Reference3 is actual prior page inventory. Reference4 is the chosen new quiet admin frame: MATCH its white surfaces, navy text, green primary action, typography/spacing and restrained blue current selection. Improve old workflows without inventing a new CMS framework or visual language. +Purpose: unified WEBSITE-LEVEL workspace above individual page editing. Owner-operated modest site with one main editor. Same admin components for lists, choice, editing and return. Existing Page model and independent NavigationItem model retained; no invented compulsory page tree or deeply nested navigation. One submenu level in HEADER only. Separate FOOTER groups Service, Kontakt, Rechtliches are supported. Page inventories are not automatically menu hierarchy. +Global nav Lara & Felix / Verwaltung; Arbeitsplatz, Medien, Inhalte, Angebote, Website SELECTED, Kunden. Breadcrumb Website / Webpräsenz. Main title "Webpräsenz". Top status amber "Menüänderungen nicht gespeichert". ONE primary green "Menüänderungen speichern", secondary "Menüvorschau". Calm readable line "Wirkt nach dem Speichern auf die öffentliche Navigation." No global Publish Website button and no additional release workflow for menu edits. +Illustrative SAME data in every option, not claims about actual instance: +10 CMS pages: Start /; Konzept /konzept; Prävention im Alltag /praevention-im-alltag; Programme /programme; Für Trainer /trainer; Aktion Herbst /aktion-herbst; Neues Angebot /neues-angebot; Kontakt /kontakt; Impressum /impressum; Datenschutz /datenschutz. +All pages are Veröffentlicht EXCEPT Neues Angebot is Entwurf with no public revision. +HEADER navigation contains six entries incl one child: +1 Start -> /, visible. +2 Konzept -> /konzept, visible. + child "Prävention" -> page Prävention im Alltag /praevention-im-alltag, visible, CURRENT SELECTED menu entry. Single level of indentation. +3 Programme -> /programme, visible. +4 Für Trainer -> /trainer, visible. +5 Aktion Herbst -> /aktion-herbst, "Im Menü ausgeblendet"; target page remains Veröffentlicht. +Kontakt has placement Fußbereich:Kontakt, Impressum and Datenschutz Fußbereich:Rechtliches; footer Service group can be empty. Neues Angebot has "Ohne Menüzuordnung". Never label the hidden menu's page private or unpublished. Do not give page inventory a fake drag-to-reorder that silently changes all menus. +Current selected item editor data: "Menütext" value "Prävention"; "Zielseite" a visual reference row "Prävention im Alltag" with path and "Veröffentlicht" status; action "Ziel ändern" opens common context-appropriate page choice, not a long plain dropdown/radio list; link "Seite bearbeiten" opens page editor with preserved menu working draft. "Untermenü von" value "Konzept". Switch "Im Hauptmenü anzeigen" ON. This changes menu entry only, not page title/publication/SEO or product rights. A quiet overflow can expose "Aus Menü entfernen" without deleting page. +Reorder uses drag handles plus up/down alternatives at selected item. Valid depth only one submenu level. Changing selected entry does not auto-save, publish or lose drafts. A site preview would omit hidden Aktion Herbst but page remains reachable by URL. Selecting a draft target never publishes it automatically. +Show menu placement selector currently "Hauptmenü" with access to Fußbereich-Service/Kontakt/Rechtliches. At most two main content areas after global sidebar. Use lightweight grouped rows, no decorative dashboard cards, no metrics and no feature inventory. Readable14-16px text, complete visible controls, purposeful whitespace. Do not invent noindex implementation, homepage reassignment, global theme editor or universal Website verstecken toggle. Site-wide framework settings may be available as a quiet section link but do not fake details. +Do not confuse submenu navigation entries with a new folder/parent relationship in pages. A page can appear in multiple menus with different order and menu label. Preserve same illustrative page/menu data across options. +Direction name: Seitenbestand und Menü nebeneinander. +After header use workspace tabs "Seiten & Menüs" ACTIVE, "Website-Rahmen". The central comparison is a two-pane layout showing full page inventory alongside menu assignment, without a permanent third editor column. +LEFT around52% width: heading "Seiten · 10", compact search placeholder "Seiten suchen", one compact filter "Alle Seiten", optional subdued "+ Seite". A clear lightweight table with columns "Seite", "Stand", "Menü". Show all ten illustrative pages with compact rows: title with path underneath, Veröffentlicht vs Entwurf badge, and actual relationship. Selected related page Prävention im Alltag pale blue, marked "Hauptmenü · unter Konzept". Aktion Herbst explicitly "Hauptmenü · ausgeblendet"; Neues Angebot has Entwurf and "Ohne Menüzuordnung"; Kontakt Footer-Kontakt, Impressum/Datenschutz Footer-Rechtliches. Don't force table horizontal scrolling; use shorter relationship labels or wrapped two lines. +RIGHT around48% width: heading "Menü", placement selector Hauptmenü, "6 Einträge", quiet "+ Eintrag". Compact ordered tree shows all six header entries, Prävention indented below Konzept, selected. Hidden Aktion Herbst has eye-off and text Ausgeblendet. +Expand the CURRENT SELECTED menu row IN PLACE with only the main relevant menu controls, no extra panel below entire menu. This selected block shows "Menütext" Prävention, "Zielseite" reference Prävention im Alltag (Veröffentlicht) with compact Ziel ändern and Seite bearbeiten actions, and "Im Hauptmenü anzeigen" on. Parent context already visible; optional compact Untermenü von Konzept if room. A compact selected-row menu exposes movement and removing only menu reference. Don't add local Save button. +The global Save applies MENU edits only, not unrelated pending page edits. Support that through clear scope note "Menü bearbeiten – Seiteninhalt bleibt unverändert." Page list is visible for finding/choosing targets, not an auto-parented page tree. A small "Seite bearbeiten" opens actual page editor with return context retained. +User model: see which pages exist, what is published, and where they appear while assembling the menu. Do not add metrics, all-menu previews or extra dashboard. Preserve readable tree/table within viewport; table and selected row height should be compact but never clipped. +``` + +### 3 – Direkte Bearbeitung in breiter Menüliste + +Ausgabe: [Bild](../bilder/webpraesenz-03-direkt-menue.png); Quelldatei `exec-b8d8e80e-5dae-48c8-ace3-19d3e9909ad1.png`. + +```text +Create a realistic production-quality German desktop administration UI for Lara & Felix, ONE independent visual option, natural 1487 x 1058 target frame, no browser/device frame, no collage. Current date anchor19November2026, no dates necessary. +References1/2 are actual prior audit captures of navigation and its edit dialog, grounding current capabilities. Reference3 is actual prior page inventory. Reference4 is the chosen new quiet admin frame: MATCH its white surfaces, navy text, green primary action, typography/spacing and restrained blue current selection. Improve old workflows without inventing a new CMS framework or visual language. +Purpose: unified WEBSITE-LEVEL workspace above individual page editing. Owner-operated modest site with one main editor. Same admin components for lists, choice, editing and return. Existing Page model and independent NavigationItem model retained; no invented compulsory page tree or deeply nested navigation. One submenu level in HEADER only. Separate FOOTER groups Service, Kontakt, Rechtliches are supported. Page inventories are not automatically menu hierarchy. +Global nav Lara & Felix / Verwaltung; Arbeitsplatz, Medien, Inhalte, Angebote, Website SELECTED, Kunden. Breadcrumb Website / Webpräsenz. Main title "Webpräsenz". Top status amber "Menüänderungen nicht gespeichert". ONE primary green "Menüänderungen speichern", secondary "Menüvorschau". Calm readable line "Wirkt nach dem Speichern auf die öffentliche Navigation." No global Publish Website button and no additional release workflow for menu edits. +Illustrative SAME data in every option, not claims about actual instance: +10 CMS pages: Start /; Konzept /konzept; Prävention im Alltag /praevention-im-alltag; Programme /programme; Für Trainer /trainer; Aktion Herbst /aktion-herbst; Neues Angebot /neues-angebot; Kontakt /kontakt; Impressum /impressum; Datenschutz /datenschutz. +All pages are Veröffentlicht EXCEPT Neues Angebot is Entwurf with no public revision. +HEADER navigation contains six entries incl one child: +1 Start -> /, visible. +2 Konzept -> /konzept, visible. + child "Prävention" -> page Prävention im Alltag /praevention-im-alltag, visible, CURRENT SELECTED menu entry. Single level of indentation. +3 Programme -> /programme, visible. +4 Für Trainer -> /trainer, visible. +5 Aktion Herbst -> /aktion-herbst, "Im Menü ausgeblendet"; target page remains Veröffentlicht. +Kontakt has placement Fußbereich:Kontakt, Impressum and Datenschutz Fußbereich:Rechtliches; footer Service group can be empty. Neues Angebot has "Ohne Menüzuordnung". Never label the hidden menu's page private or unpublished. Do not give page inventory a fake drag-to-reorder that silently changes all menus. +Current selected item editor data: "Menütext" value "Prävention"; "Zielseite" a visual reference row "Prävention im Alltag" with path and "Veröffentlicht" status; action "Ziel ändern" opens common context-appropriate page choice, not a long plain dropdown/radio list; link "Seite bearbeiten" opens page editor with preserved menu working draft. "Untermenü von" value "Konzept". Switch "Im Hauptmenü anzeigen" ON. This changes menu entry only, not page title/publication/SEO or product rights. A quiet overflow can expose "Aus Menü entfernen" without deleting page. +Reorder uses drag handles plus up/down alternatives at selected item. Valid depth only one submenu level. Changing selected entry does not auto-save, publish or lose drafts. A site preview would omit hidden Aktion Herbst but page remains reachable by URL. Selecting a draft target never publishes it automatically. +Show menu placement selector currently "Hauptmenü" with access to Fußbereich-Service/Kontakt/Rechtliches. At most two main content areas after global sidebar. Use lightweight grouped rows, no decorative dashboard cards, no metrics and no feature inventory. Readable14-16px text, complete visible controls, purposeful whitespace. Do not invent noindex implementation, homepage reassignment, global theme editor or universal Website verstecken toggle. Site-wide framework settings may be available as a quiet section link but do not fake details. +Do not confuse submenu navigation entries with a new folder/parent relationship in pages. A page can appear in multiple menus with different order and menu label. Preserve same illustrative page/menu data across options. +DISTINCT ARRANGEMENT: full-width menu list with editing directly inside the selected row. Tabs "Seiten · 10", "Menüs" ACTIVE, "Website-Rahmen". No fixed side editor and no page inventory beside the menu. Use one generous full-width menu panel under tabs, heading "Hauptmenü" placement dropdown, "6 Einträge", "+ Eintrag". Compact table column headers "Menüeintrag", "Zielseite", "Sichtbarkeit". Top-level rows Start, Konzept, Programme, Für Trainer, Aktion Herbst have target path and readable visibility. Indent selected Prävention one level directly under Konzept, label distinct from page title. Its row expands in place into a clean two-column editor, spanning table width: left Menütext input and Untermenü von Konzept; right Zielseite reference with published badge, Ziel ändern and Seite bearbeiten, plus visibility switch. Keep other rows visible below. Use a subtle blue selected expanded row and clear white/grouped surfaces, not oversized card stacks. No extra Save inside row, global Menu save only. For this sole child under Konzept, any same-parent up/down buttons MUST be disabled; changing parent is explicit, no implicit unnesting. Drag handle and overflow are present. At bottom a compact help sentence: "Ausgeblendete Menüeinträge ändern die Veröffentlichung der Zielseite nicht." Target page remains published. Menu preview is top action only; don't add a third preview panel. Full-width layout makes page-target reference and actions comfortably readable. Website-Rahmen tab is only a proposed entry point, no fictional settings. Exact same 6-entry data, no missing hidden entry or added duplicates. Polish as a coherent real desktop app, not a wireframe. +``` + diff --git a/docs/ux/verwaltung/paket-manifest.json b/docs/ux/verwaltung/paket-manifest.json new file mode 100644 index 0000000..80f5265 --- /dev/null +++ b/docs/ux/verwaltung/paket-manifest.json @@ -0,0 +1,557 @@ +{ + "date": "2026-11-19", + "target": "C:\\Dev\\Lara-und-felix.de\\docs\\ux\\verwaltung", + "status": "Agreed administrative design consolidated as binding execution standard with ready coding-agent brief; historical draft start barriers superseded; business questions retained; no application changes or agent started", + "files": [ + { + "path": "02-designentscheidungen.md", + "bytes": 15934, + "sha256": "12ae5fee1e8b979a329d8e5a374c26a07cf50b7bd87fac959366bb6d55079675" + }, + { + "path": "03-auswahl-und-zuordnung-entwurf.md", + "bytes": 13031, + "sha256": "01afc98a377f83590471b8ff09a1f6de12a64bbf58875fd8b5387db1526580da" + }, + { + "path": "04-fachliche-anforderungen.md", + "bytes": 30110, + "sha256": "3ed79a485e93810d661965b5e885db52a10744096b8bc16f98540e16491daa3b" + }, + { + "path": "05-coder-uebergabe-arbeitsstand.md", + "bytes": 10317, + "sha256": "57376f2b7d7b717818a2a5d06ed6a6c21ab7f9db2fb11918c4083d4360d2adce" + }, + { + "path": "06-aufbau-arbeitsplatz-entwurf.md", + "bytes": 17404, + "sha256": "ac7b8309af5d504c537bbae7fcf45c6c9da624dd86350c85e5ddd099bd71055e" + }, + { + "path": "07-speichern-vorschau-freigabe-entwurf.md", + "bytes": 30699, + "sha256": "a55d5fdd81005c037a8333441de0aa0c1654ecef7a804b79e67b03b6ab978b68" + }, + { + "path": "08-einfacher-redaktionsalltag-entwurf.md", + "bytes": 14508, + "sha256": "7c9181e686450017b2ae4bc047650183e86667f08152c3096897104b0a3d6961" + }, + { + "path": "09-redaktionsarbeitsplatz-entwurf.md", + "bytes": 27017, + "sha256": "7726923c7b22349be25c76af1bac4a16a166235dba19109d23a85dd278bbdbf8" + }, + { + "path": "10-verwaltungsstandard-entwurf.md", + "bytes": 10800, + "sha256": "c649aab153815cfa993e2ab355bed3abd6c98d869e7fbde8c335d8bb6720c7ce" + }, + { + "path": "11-cms-pruefbedarf.md", + "bytes": 5715, + "sha256": "4d32f1d5506174d000833e15f4bb47aa6fbfc89cf534a28c0ba020ad95faa99b" + }, + { + "path": "12-cms-seiteneditor-entwurf.md", + "bytes": 26071, + "sha256": "be930f5ec01f2efb08131afcf35eb913f5b116e5396bc63f5c58883327c48f2c" + }, + { + "path": "13-webpraesenz-verwaltung-entwurf.md", + "bytes": 19640, + "sha256": "1f9e6a34b9ac285749b041403ba82504e816996932a51ce18ea1ade1239f6e86" + }, + { + "path": "14-verwaltungsstandard.md", + "bytes": 12786, + "sha256": "fcb6ccd507d37be0bf65d0edf0f5f9d70157f4d47c4a270a89e05cbf5ce39375" + }, + { + "path": "15-umbauauftrag.md", + "bytes": 7052, + "sha256": "d75cf9babc34c7c57f4158c2a6e6dcaeeaa76760f1ca8690607ebc9f1c326a36" + }, + { + "path": "README.md", + "bytes": 15404, + "sha256": "dddaa8dfa5da2f2717191e681cca72d28254f46d1445fcbe8e57f959185a4ce1" + }, + { + "path": "audit/01-dashboard.jpg", + "bytes": 25017, + "sha256": "07bfd7b839bb49c307a5da1a85fe56f097f8554b58c9cbc4dc08f325099f2985" + }, + { + "path": "audit/02-arbeitsplatz.jpg", + "bytes": 115227, + "sha256": "895a1ea684e1874d53f14831eb45754c29d183aeac890c923c9a13eef857d7e6" + }, + { + "path": "audit/03-modul-aufbau.jpg", + "bytes": 105753, + "sha256": "65886dfa82d34ef7daa42b66bb0a2251965825b9e398b046a78ea2ff865c2431" + }, + { + "path": "audit/04-materialpicker.jpg", + "bytes": 105606, + "sha256": "cf38d7d9ba25dd01768ac13d2c82e87bd46a0c192c125e47a62c97f1afb4fe6a" + }, + { + "path": "audit/05-modul-beschreibung.jpg", + "bytes": 76325, + "sha256": "8164d8e1e6af8277190d26339dfeb45df31b26e72ea21de4c8d0f837d72ae65d" + }, + { + "path": "audit/06-modul-einordnung.jpg", + "bytes": 58923, + "sha256": "b7873a82a07c1dc2ed9ee533667313a9e8315fe687023eab2abdfe41b0ce2de2" + }, + { + "path": "audit/07-medien-uebersicht.jpg", + "bytes": 109717, + "sha256": "1e5ad40fdeff2f604e7f8fe91a6f89f7c2634165db483a8d2bf54cb028c98256" + }, + { + "path": "audit/08-medien-liste.jpg", + "bytes": 91765, + "sha256": "f6388fae34c4653e5408006cd4b958c5953daa13c764e01deee43e9f3305dd94" + }, + { + "path": "audit/09-medien-suche.jpg", + "bytes": 92993, + "sha256": "9aab0a545cb4d9461ee143d8697642260ca2150b301004caafcc1f1a15823f44" + }, + { + "path": "audit/10-medium-beschreibung.jpg", + "bytes": 74614, + "sha256": "8a6f0cdf8e07b02f19e5c7390e6596e9f096da76b294b408c97d2e527fba14f3" + }, + { + "path": "audit/11-medium-fassungen.jpg", + "bytes": 66804, + "sha256": "185305c341634232d6939091d845e277e8d707ba0b98402252ced9947bf2662e" + }, + { + "path": "audit/12-medium-verwendung.jpg", + "bytes": 64669, + "sha256": "a0af19ca11aa3289eff8da788d300109255015adcbd7e293438566768b5e1be4" + }, + { + "path": "audit/13-medium-praesentationspicker.jpg", + "bytes": 70109, + "sha256": "3f664f7d04c688ce5a37f2a26c55ad3d068e67331cb2c5445ac40b19106703f2" + }, + { + "path": "audit/14-cms-seitenliste.jpg", + "bytes": 56790, + "sha256": "bb23697a5a2f23126af056b14599467fc68a4f18bbedc48d29538bb9498b3737" + }, + { + "path": "audit/15-cms-editor.jpg", + "bytes": 70741, + "sha256": "f550569928a86e85ad60565bf8424ea837f25cc5d4d22cfb43700e4421230cd8" + }, + { + "path": "audit/16-cms-widgetdialog.jpg", + "bytes": 61893, + "sha256": "19762771afb3896e7f98847c81b9a2265aba97efbc556c6a0e768e66f72dbe91" + }, + { + "path": "audit/17-cms-bildpicker.jpg", + "bytes": 65001, + "sha256": "42efad6a55eb84239050b856b7332ebbcb7bc8c210539c89843eacaf107f91dc" + }, + { + "path": "audit/18-cms-geraetevorschau.jpg", + "bytes": 71883, + "sha256": "c98b3a3f13b7f5b03fc7a2982e4bade734883c9c01c1f44c0b496aa64a97480c" + }, + { + "path": "audit/19-cms-struktur-revisionen.jpg", + "bytes": 110824, + "sha256": "f5c37d963e92219d1565d43bd367d22efc52d31caf1638fba546bb0f74ee75be" + }, + { + "path": "audit/20-kombination-leerzustand.jpg", + "bytes": 59109, + "sha256": "fc691d1dade2e5121f59b16ecaf8fa56a88efb42e998a69d59f7d7f3e1b07616" + }, + { + "path": "audit/21-kombination-anlegen.jpg", + "bytes": 49027, + "sha256": "b73135a8c7f3db2953fbc64289b76e0305091888298258a91d4f23c87a5e48e4" + }, + { + "path": "audit/22-module-tabelle.jpg", + "bytes": 108494, + "sha256": "59f6fb0c992c95853f4d0a51af2c2d6204feb4941f83bb071c215e9dfac6929c" + }, + { + "path": "audit/23-programme-tabelle.jpg", + "bytes": 71488, + "sha256": "8af8be34d8732a704250c8ae6b195f1235db66e432e175c71139d64789a8998f" + }, + { + "path": "audit/24-programm-aufbau.jpg", + "bytes": 140612, + "sha256": "485abe75441f187dba114d094bd2184d04ff2ce1820ffd41b9ed6b33958326d2" + }, + { + "path": "audit/25-programm-fassungsstatus.jpg", + "bytes": 123067, + "sha256": "25ed503968fa8a95984e7603c3eebcbf2cecb4e87b765b9a998382c3f2b45fb6" + }, + { + "path": "audit/26-lizenzartikel-liste.jpg", + "bytes": 58812, + "sha256": "5da74a31a98e3ebc62768254bc30eefa1f38ce9062ab8881d19fcbaeaf543158" + }, + { + "path": "audit/27-lizenzartikel-detail.jpg", + "bytes": 110169, + "sha256": "b7d72dbc8c8e6ed52c7f5ae533adc73b69b1bc7d3f1055a214fe28fa99ff72d5" + }, + { + "path": "audit/28-pakete-leerzustand.jpg", + "bytes": 49900, + "sha256": "76e7b0ff6a603f2824de7ccf44f9a4d1a63defda23551c84bfbe51606b1288ae" + }, + { + "path": "audit/29-rechteprofile-liste.jpg", + "bytes": 56288, + "sha256": "68229768753fbb4f6b44b1df16bca9051f93427bafe11da2626554901ff15993" + }, + { + "path": "audit/30-rechteprofil-detail.jpg", + "bytes": 46870, + "sha256": "9fde6bcf60dc4d039129586f3b311b2f2a2e2bc0146232eab7fb266bb6ce0ae0" + }, + { + "path": "audit/31-angebote-liste.jpg", + "bytes": 56089, + "sha256": "58cfead27f174521f4f34252bc9a130feb7d63d4befc1dbd729870fde61bb368" + }, + { + "path": "audit/32-angebot-detail.jpg", + "bytes": 60121, + "sha256": "b1a58fa2dbecd995f34ff5922c2d2a50481a98baba22517c9c00e56fbd4ac566" + }, + { + "path": "audit/33-saeulen-liste.jpg", + "bytes": 79009, + "sha256": "3995524ccb047b37c16c7efd7d2b4c14664143f1863fd85672b09129cfd63fa7" + }, + { + "path": "audit/34-saeule-bearbeiten.jpg", + "bytes": 67395, + "sha256": "1079044ed8a386113bc93c7762e6617c39b5bb0364f4deb93ecf1f994d4ad687" + }, + { + "path": "audit/35-navigation-liste.jpg", + "bytes": 98415, + "sha256": "c641607954ff4b535b71796379717d20af7a123cc9cb2fc5e432e986003f00f0" + }, + { + "path": "audit/36-navigation-dialog.jpg", + "bytes": 96304, + "sha256": "2b896edcf2e36b4cb3a8649cdfcc3a66c91b70124c004bf046b296516787a32f" + }, + { + "path": "audit/37-materialpicker-fokus.jpg", + "bytes": 133669, + "sha256": "e72ab30488f116a5c88502152b0199bcb94d858442f0ab1c6142d1d9ebbe58f5" + }, + { + "path": "audit/37-materialpicker-fokus.txt", + "bytes": 17078, + "sha256": "cc028dd4d19e9efee252db133435b93b91dbeec3782a440422dfef416f5bb1c2" + }, + { + "path": "audit/38-materialpicker-auswahl.jpg", + "bytes": 156584, + "sha256": "0dee63ebd28f2dc2767cb6fc57b4a89410e2f1e477b2c4850060c67fb6a06447" + }, + { + "path": "audit/39-bestandteil-bearbeiten.jpg", + "bytes": 126289, + "sha256": "f5313dfa39aa0185fd477b419eefa6b3d22f1f95a0fad18a5a7fc7190af60add" + }, + { + "path": "audit/40-trainervorschau-entwurf.jpg", + "bytes": 100320, + "sha256": "2696d7f0fcd38be21c0ca9b7c004948a606f3019a7aae23e76d2a46181c3beea" + }, + { + "path": "audit/41-modul-entwurfsbestandteile.jpg", + "bytes": 141305, + "sha256": "a3cb2a97346d5b230c61ead47810a4a4aad561b1d375ff09c539d30955c0ab99" + }, + { + "path": "audit/42-medien-anlegen-ohne-reaktion.jpg", + "bytes": 150021, + "sha256": "fda5c26c9e4646fc33e7357b0a6d4c4a3563e9d554e64dbae8d38e8104db743b" + }, + { + "path": "audit/43-medium-separater-editor.jpg", + "bytes": 87349, + "sha256": "87e5e41c95cd5d2b91c146f27fc17f03e1995637b9c026a0f5d9bad39b5c147e" + }, + { + "path": "audit/44-globale-suche.jpg", + "bytes": 91322, + "sha256": "6f5ec0c20600460a3145bdd22104c2e866301fe3715b8e3039521bd47dd67c27" + }, + { + "path": "audit/45-benutzer-liste.jpg", + "bytes": 87326, + "sha256": "1ae42ab219594c195cae904a17d0c90b77da44b6fa23c7d535abe9b2691c54e8" + }, + { + "path": "audit/46-testmitglied-bearbeiten.jpg", + "bytes": 63885, + "sha256": "bb24f88a83072435d42e5c5e9a23fc47af117d782edc08abc5a61d9565cffd94" + }, + { + "path": "audit/Belege.html", + "bytes": 13543, + "sha256": "d5a1993a1416e412d889baa4d8ae49fdf8124a0de67e4874accc2641e61931ed" + }, + { + "path": "audit/Belege.md", + "bytes": 10604, + "sha256": "5da77a547e2582bb36c881fbfdaee3d05dd75a591e3c87420b8c0b8319e23739" + }, + { + "path": "audit/Belegregister.json", + "bytes": 18239, + "sha256": "7089079e071d9afefa76a193d0d0a5fea8bf31fcbce1e99833a29301418e19a5" + }, + { + "path": "audit/UX-Audit.html", + "bytes": 35280, + "sha256": "118fd49fa448b85c5ff3a6dfdafdeaf59bbf2e8f33dd20b232a0fef885ba7bf2" + }, + { + "path": "audit/UX-Audit.md", + "bytes": 30884, + "sha256": "eeeffa7279db9254c519d18787355d6e85a9febb295815bed5eea1d5dc19d28e" + }, + { + "path": "audit/cms-nachpruefung/01-anmeldung-erforderlich.png", + "bytes": 23905, + "sha256": "59c196fb20f77cd92124aba32a323fbd5abdc7391b882cc76d5b4120d0bf2b14" + }, + { + "path": "audit/cms-nachpruefung/README.md", + "bytes": 742, + "sha256": "91d54d3960de5c265fcf89de85b9d310b47027002cd8bc58a439669be2e74fa1" + }, + { + "path": "bilder/aufbau-01-strukturliste-kontext.png", + "bytes": 1559220, + "sha256": "135c86194d78117f4db9b01b79f1f10bf1bfac44e49a296c84b56a3f24faa944" + }, + { + "path": "bilder/aufbau-02-struktur-detailbereich.png", + "bytes": 1632319, + "sha256": "e2625b8ab6375b4e51a2e6ee86c69ea72c5ad07d30df525fb3d633a2fea5862e" + }, + { + "path": "bilder/aufbau-03-inline-bearbeitung.png", + "bytes": 1684145, + "sha256": "de28e7a25954983a0086c6185b4c4592968ed9688ac390f69d41c523fc5c6007" + }, + { + "path": "bilder/aufbau-kombiniert-v1.png", + "bytes": 1650553, + "sha256": "e00670cdd70bc9058eccde65c7eab91d900c3bc8b85dc6fb7dab92725b05b411" + }, + { + "path": "bilder/aufbau-zustaende-v1.png", + "bytes": 1691925, + "sha256": "8e58b88b3952517e3fb9a80fe7d32f9fce6fd967f498fb6feea6b2dd3e82bdca" + }, + { + "path": "bilder/auswahl-01-liste-detail-v2.png", + "bytes": 1708921, + "sha256": "d67c7fdae03afcc8598f5fb0c6454a91844eb910fce1bc4064e3e47bfc423e60" + }, + { + "path": "bilder/auswahl-01-liste-detail.png", + "bytes": 1681131, + "sha256": "b7cba68411d6691c4da6e2e1b9df38b062213d26b097639cbe1fb94fd184064c" + }, + { + "path": "bilder/auswahl-02-raster-detail.png", + "bytes": 1563826, + "sha256": "d13df92ce312556faaabb0ae92e05e237e196c3f3fa0e0d6874bc653669e3ed3" + }, + { + "path": "bilder/auswahl-03-bestand-auswahl.png", + "bytes": 1707418, + "sha256": "f1446d4ec39577e05b56f9359c015e1852f94739899db2bfc7ae1a8739eaafcd" + }, + { + "path": "bilder/cms-01-struktur-bearbeitung.png", + "bytes": 1530701, + "sha256": "71295147ca230c3d9bcfc3fc28237506f4eb26db30df7da556285409166dddcc" + }, + { + "path": "bilder/cms-02-seitenflaeche-inspektor.png", + "bytes": 1566338, + "sha256": "d7d582030fa88fafbc8665eef2beb77137da6fe155a11a5defabb16a1cace399" + }, + { + "path": "bilder/cms-03-einzelbearbeitung.png", + "bytes": 1482298, + "sha256": "0783865414dc2489a6cf052535abc8beb318d3be8ec6c7d4e6ae684f6ca2896d" + }, + { + "path": "bilder/cms-weiterentwicklung-abschnitt-v1.png", + "bytes": 1705073, + "sha256": "a26d8bbcb25cc3a27ac699da29574f0500613409334061b5afe3aea74e8a851a" + }, + { + "path": "bilder/cms-weiterentwicklung-baustein-v1.png", + "bytes": 1551864, + "sha256": "826f986e0270933ad7d72df870d356ac2bf77cf9f855e01d22fb54aa9ede56d3" + }, + { + "path": "bilder/cms-weiterentwicklung-seitenaufbau-v1.png", + "bytes": 1707193, + "sha256": "f4d0be6c09cfb68cd17cf5ff0689c73e074d4e11aa8536f01aaa993ef4930377" + }, + { + "path": "bilder/manifest.json", + "bytes": 10527, + "sha256": "3465fc19c8a298d58aa7fd044e10c66287b4692bd765b0cfea1bfbb95ac5d9e6" + }, + { + "path": "bilder/redaktion-01-uebersicht.png", + "bytes": 1836817, + "sha256": "7be73432a0231f2845d572b6a7358677182c1c5c40d51beef1eb1973632ccff2" + }, + { + "path": "bilder/redaktion-02-navigator-detail.png", + "bytes": 1845098, + "sha256": "6ca44d1e59241b64fce0a350c7d9784acad95e00a519d30d65cdf17ada76f332" + }, + { + "path": "bilder/redaktion-03-direkt-kontext.png", + "bytes": 1783922, + "sha256": "0637c0d1386f28a78a05a033d4fec3b0cd48ee3ff5964139b4a90652d5e9dfde" + }, + { + "path": "bilder/redaktion-register-medium-v1.png", + "bytes": 1593814, + "sha256": "9eaa95f216accb536c89f2501ef7fdb8bbe807afd1bb98238aed61c75c7e21bd" + }, + { + "path": "bilder/richtung-arbeitsflaeche-kontext.png", + "bytes": 1292059, + "sha256": "149b01ed70bab051de05e883d4cbfbb0b2e3b959281fbeaa0633afe49a31a461" + }, + { + "path": "bilder/richtung-ergebnis-zurueckgestellt.png", + "bytes": 1469614, + "sha256": "fca736e54715894ee9cd56eb8140651cbe0192f371d2a3c6fc99b47bf90f0034" + }, + { + "path": "bilder/richtung-gefuehrter-ablauf.png", + "bytes": 1305215, + "sha256": "c41cb0388665ff969bee83a2ea39ec7cc3332d54d119f1119b4d730e0c8a26d6" + }, + { + "path": "bilder/richtung-kombiniert.png", + "bytes": 1606156, + "sha256": "c9118727dd2ab4752853199c1ce1be1557903eaa1cae17859832b3be93c75fee" + }, + { + "path": "bilder/webpraesenz-01-register-menueeditor.png", + "bytes": 1383910, + "sha256": "343e09eb614a8f4863057373c13f6aa91dec533ea5cf7278cedbfb68bfaf04ed" + }, + { + "path": "bilder/webpraesenz-02-seiten-menues.png", + "bytes": 1730741, + "sha256": "749f5c0770cf5e502806fb8392c39604fb698cf2d3824f0f6893392052fb2b31" + }, + { + "path": "bilder/webpraesenz-03-direkt-menue.png", + "bytes": 1636193, + "sha256": "2e09063f09dd4cd6339dc4b15761b2f752a074be2c5c21887980f34c6ef6cd92" + }, + { + "path": "generierung/aufbau-kombination.md", + "bytes": 5967, + "sha256": "62dfce12ffa822f8bdb30e430fd24f3767b3b05b3ad6fb3d517e94a98cce1399" + }, + { + "path": "generierung/aufbau-prompts.md", + "bytes": 24955, + "sha256": "5db093f2ff84405e6ac502b624a1df919f68b30983c1d1167b2e06a39edd658d" + }, + { + "path": "generierung/auswahl-liste-verfeinerung-v2.md", + "bytes": 5399, + "sha256": "1502ade2e7ba27c284bd7bd3bc1f2fb6f81a965faf847db8d9ab1064663baa3d" + }, + { + "path": "generierung/auswahl-prompts.md", + "bytes": 21786, + "sha256": "bba50835435ca95cf45c956ff9834b64159d26c3b729b50a574158214e7153ee" + }, + { + "path": "generierung/cms-konfiguration-weiterentwicklung.md", + "bytes": 22234, + "sha256": "927edbba09e6d97ac121527173ecf081e293178b5ec50da9919024e47fb0fd2f" + }, + { + "path": "generierung/cms-prompts.md", + "bytes": 22790, + "sha256": "3eb9fbb44e1f4607a592946d37dec7bf94ad6836dc86d2e3e53e9bc5cffe009d" + }, + { + "path": "generierung/redaktion-prompts.md", + "bytes": 22037, + "sha256": "f92b12b5dc1b9ea44abb8ae0bbcebb9be4ce17758c055059d3667151e2f8f49d" + }, + { + "path": "generierung/redaktion-register.md", + "bytes": 5419, + "sha256": "fd62a4f5af8dec660fe5bae72bc0a24ed5dd31afd2c7e6d9ca1c776b08974641" + }, + { + "path": "generierung/speichern-vorschau-freigabe.md", + "bytes": 4253, + "sha256": "608ac3fa61a9d13719c76e665e7a2eecf5974722501a34d525d31437f512b371" + }, + { + "path": "generierung/webpraesenz-prompts.md", + "bytes": 20700, + "sha256": "a086397c891f4b29c8ba5641af5d5535c8b3a1b121fcd39dd05843f2e7870d31" + }, + { + "path": "quellen/redaktionsmodul-planungschat-2026-11-19.md", + "bytes": 5400, + "sha256": "dae167695f465f51fccb2e68c3b0d8ef33ac74a5e68dced765c0b3a8cb41372f" + }, + { + "path": "regeln/AGENTS-verwaltung-entwurf.md", + "bytes": 1523, + "sha256": "1a2ae56de78344b7990f0d7d440310210d2b36f55c764af2107c60775167aa8e" + }, + { + "path": "regeln/cursor-verwaltung-entwurf.mdc", + "bytes": 2364, + "sha256": "57269047da1e8f08d9691350f0bbb098eac47e31ef4772d54848a0224c16064b" + }, + { + "path": "regeln/ux-abnahme-vorlage.md", + "bytes": 1760, + "sha256": "ea692889261ef50247a6d3592b699f344d6ca51c50e3de6efa3b295915d26c96" + } + ] +} diff --git a/docs/ux/verwaltung/quellen/redaktionsmodul-planungschat-2026-11-19.md b/docs/ux/verwaltung/quellen/redaktionsmodul-planungschat-2026-11-19.md new file mode 100644 index 0000000..334b38e --- /dev/null +++ b/docs/ux/verwaltung/quellen/redaktionsmodul-planungschat-2026-11-19.md @@ -0,0 +1,102 @@ +# Quelle: Planungschat zum zentralen Redaktionsmodul + +Vom Auftraggeber am 19.11.2026 in die gemeinsame UX-Abstimmung eingebracht. Die nachfolgende Beschreibung ist als Anforderung bewahrt. Sie ist keine Abnahme der bestehenden Implementierung. Einleitend hat der Auftraggeber bekräftigt, dass Medien, Module, Programme und Trainingspläne eigene textuelle und grafische Angaben einschließlich Teaservideos und Slideshows erhalten sollen. Der Auftrag sei bereits an den Coding-Agenten gegangen; ein einheitliches zentrales System sei derzeit nicht erreicht. + +--- + +## Lara & Felix – Zentrales Redaktionsmodul: Fachlicher und UX-Kontext + +### Ziel + +Die zentrale Redaktionsverwaltung ist die gemeinsame Grundlage für die Beschreibung und Präsentation unserer Inhalte. + +Sie wird für **Medien, Module, Programme und Lizenzartikel** eingesetzt und soll später auch für weitere Fachobjekte wie Trainingspläne nutzbar sein. + +Redaktionelle Informationen werden einmal zentral gepflegt und anschließend auf der Website, im CMS und in der Mitgliederbibliothek wiederverwendet. + +### 1. Redaktionelle Informationen + +Jedes Fachobjekt kann eigene Informationen besitzen: + +- Anzeigename und Titel +- Teasertext +- Kurzbeschreibung +- Ausführliche Beschreibung +- Fachliche Einordnung +- Zielgruppenbezogene Textvarianten +- Schlagwörter und Klassifikationen + +**Wichtig:** Diese Texte gehören unmittelbar zum jeweiligen Fachobjekt. Für gewöhnliche Beschreibungen, Lernziele oder Trainerhinweise werden nicht automatisch eigenständige Medienobjekte angelegt. + +Verbindliche Lehrtexte bleiben von redaktionellen Beschreibungstexten getrennt und unterliegen gegebenenfalls der fachlichen Versionierung. + +### 2. Fachliche Klassifikation + +Medien müssen über ihre technische Art (Film, Bild, Audio, Dokument, Text) hinaus fachlich klassifizierbar sein. + +Beispiele sind Unterrichtsfilm, Trailer, Interview, Titelbild, Hintergrundbild oder Traineranleitung. + +Hinzu kommen Verwendungszwecke wie Training, Begleitmaterial oder Website/Marketing sowie Themenbereiche und Zielgruppen. + +Die Klassifikation dient insbesondere der Auffindbarkeit. Sie ist von der tatsächlichen Verwendung und von Freigaberechten unabhängig. + +### 3. Zugeordnete Präsentationsmedien + +Jedes Fachobjekt kann mehrere zusätzliche Medien erhalten: + +- Titelbilder und alternative Bilder +- Trailer und Teaserfilme +- Vorschauclips +- Interviews +- Bildergalerien +- Weitere Präsentationsressourcen + +**Mehrfachzuordnungen je Rolle sind möglich**, beispielsweise mehrere Trailer zu einem Unterrichtsfilm. + +Alle Präsentationsmedien stammen aus dem zentralen Medienmanager. Es werden ausschließlich Referenzen gespeichert. + +Reine Präsentationsmedien benötigen keine fachliche Inhaltsfassung, unabhängig davon, ob es sich um Bilder oder Videos handelt. + +### 4. Lizenzartikel + +Ein Lizenzartikel kann redaktionelle Texte und Präsentationsmedien vom zugrunde liegenden Fachobjekt übernehmen oder eigene Angaben besitzen. + +Die kommerziellen Informationen – Preise, Nutzungsrechte und Vertragsbedingungen – bleiben getrennt und werden nicht im Redaktionsmodul verwaltet. + +### 5. Veröffentlichung und Wiederverwendung + +Redaktionelle Angaben können unabhängig von fachlichen Inhaltsfassungen geändert werden. + +CMS-Widgets verwenden standardmäßig die zentralen Informationen, dürfen aber einzelne Angaben lokal überschreiben. + +Die öffentliche Ausgabe zugeordneter Bilder oder Videos setzt eine gültige Website-Freigabe voraus. + +Wird diese zurückgenommen, verschwindet das betroffene Medium aus der öffentlichen Darstellung. Andere Texte und Inhalte bleiben erhalten. + +### 6. Wesentliche UX-Anforderungen + +Das Redaktionsmodul soll **ein einheitlicher, visueller und aufgabenorientierter Arbeitsplatz** sein – keine weitere lange Formularmaske. + +Insbesondere: + +- Kompakte Übersicht der vorhandenen redaktionellen Angaben +- Gezielte Bearbeitung einzelner Informationen +- Visuelle Darstellung bereits zugeordneter Medien +- Auswahl ausschließlich über den vorhandenen zentralen Medienpicker +- Komfortables Hinzufügen, Austauschen, Entfernen und Sortieren +- Drag-and-drop bei geordneten Medienlisten +- Klare Unterscheidung zwischen übernommenen und eigenen Informationen +- Verständliche Freigabestatus und geeignete Vorschauen +- Einheitliche Bedienung bei Medien, Modulen, Programmen und Lizenzartikeln + +Die derzeitige Implementierung erfüllt die fachliche Grundlage teilweise, ist **UX-seitig jedoch ausdrücklich nicht abgenommen**. Insbesondere lange Formularlisten und Medienauswahl per Radio-Buttons beziehungsweise Checkboxen sind ungeeignet. + +### 7. Rahmenbedingungen + +Lara & Felix ist eine inhabergeführte Plattform mit begrenztem Inhalts- und Lizenzartikelbestand und aktuell einer verantwortlichen bearbeitenden Person. + +Wir benötigen keine komplexen Redaktionsworkflows, Genehmigungsketten oder überdimensionierten Shop-Administrationsfunktionen. + +Technische Fassungs- und Rechteprüfungen müssen sicher funktionieren, sollen aber die alltägliche Bedienung nicht unnötig belasten. + +**UX-Leitgedanke:** Ich möchte ein Fachobjekt öffnen und sofort sehen, wie es beschrieben und präsentiert wird. Ich möchte Texte direkt bearbeiten, Medien visuell zuordnen und das Ergebnis kontrollieren können – ohne mich durch umfangreiche Formulare, technische Statusfelder und komplexe Freigabeprozesse arbeiten zu müssen. diff --git a/docs/ux/verwaltung/regeln/AGENTS-verwaltung-entwurf.md b/docs/ux/verwaltung/regeln/AGENTS-verwaltung-entwurf.md new file mode 100644 index 0000000..0011f49 --- /dev/null +++ b/docs/ux/verwaltung/regeln/AGENTS-verwaltung-entwurf.md @@ -0,0 +1,12 @@ +# Gemeinsamer Einstieg für Verwaltungsarbeit + +Stand: 19.11.2026. Vorlage für Cursor, Claude Code und weitere Coding-Agenten. Hier unter `docs/ux/verwaltung/regeln/` noch keine aktive `AGENTS.md`. Bei Beginn des beauftragten Umbaus in aktive Einstiegshinweise einbinden; Betriebsregeln ergänzen, nicht ersetzen. + +- `CLAUDE.md` und aktive Repository-Regeln lesen. +- `docs/ux/verwaltung/14-verwaltungsstandard.md` als maßgebliche Designgrundlage und `15-umbauauftrag.md` als konkreten Auftrag verwenden. Die gemeinsame Richtung ist ausreichend abgestimmt. Keine neue allgemeine Designfreigabe oder Screenserie verlangen. +- README und Dokument 04 für Herkunft und offene Geschäftsfragen heranziehen. Historische Entwurfsstände sind nach der Rangfolge in Dokument 14 zu lesen; keine alternativen Bilder oder offenen Geschäftsregeln pauschal implementieren. +- Gleichartige Aufgaben mit gemeinsam gepflegten Komponenten lösen. Vorhandene Fachfunktionen, Datenbeziehungen, Rechte und Fassungsbindungen erhalten. +- Technische Detailentscheidungen und gemeinsame Gestaltungswerte im Rahmen des Standards treffen und dokumentieren. Offene Eingaben beim Wechsel zur Redaktion und zurück erhalten; Speicherwirkung benennen. +- Hauptabläufe funktional und visuell an der tatsächlichen Anwendung prüfen, bestehende Testpflichten erfüllen, Screenshots und konkrete verbleibende Abweichungen liefern. Keine ungeprüfte Funktions- oder Abnahmebehauptung. + +Diese Dokumentation startet keinen Agenten und bewirkt kein Deployment. diff --git a/docs/ux/verwaltung/regeln/cursor-verwaltung-entwurf.mdc b/docs/ux/verwaltung/regeln/cursor-verwaltung-entwurf.mdc new file mode 100644 index 0000000..5f4adfd --- /dev/null +++ b/docs/ux/verwaltung/regeln/cursor-verwaltung-entwurf.mdc @@ -0,0 +1,19 @@ +--- +description: Gemeinsame verbindliche UX-Vorgaben für Verwaltungsänderungen bei Lara & Felix. Vorlage zur Einbindung während des beauftragten Umbaus. +alwaysApply: true +--- + +# Verwaltung – gemeinsame Designgrundlage + +Diese Datei liegt unter `docs/ux/verwaltung/regeln/` und ist hier noch keine aktive Cursor-Regel. Bei Beginn des beauftragten Umbaus den aktiven Einstieg ergänzen; bestehende Betriebsregeln erhalten. + +1. `CLAUDE.md`, vorhandene aktive Repository-Regeln und `docs/ux/verwaltung/README.md` lesen. +2. `docs/ux/verwaltung/14-verwaltungsstandard.md` ist die maßgebliche UX-Grundlage. `15-umbauauftrag.md` beschreibt Umsetzung und Nachweise. Keine erneute allgemeine Designfreigabe oder neue Mockups je Screen verlangen. +3. Gemeinsame Komponenten statt kopierter Masken: Rahmen, Listen, Picker, Redaktion, geordnete Zuordnung, Status/Aktionen und Vorschau. Fachlich zulässige Typen und Referenzen sind Kontext derselben Komponente. +4. Eindeutigen Speicherumfang, Zustand und Vorschau-Datenstand anzeigen. Keine pauschale neue Genehmigungskette. Produktbeschreibung, Lehrinhalt, kommerzielle Daten und technische Verwaltung gezielt gliedern. +5. Redaktion für Medien einschließlich Filmen, Module, Programme und Lizenzartikel gemeinsam nutzen. Zentrale Medien referenzieren, mehrere Medien je Rolle und reine Präsentationsmedien ohne Lehrfassung erhalten. +6. Rückkehr mit offenen Eingaben sicherstellen; kein Pflichtspeichern vor dem Redaktionswechsel, kein heimliches Mitspeichern und kein veraltetes Zurückschreiben. +7. Bestehende Erwerbe, Rechte, Historie und fachliche Fassungsregeln erhalten. Offene Fragen in Dokument 04 nicht selbst durch neue Geschäftsregeln entscheiden; nur tatsächlich abhängige Teile gezielt klären. +8. Bestehende Tokens und freigegebene Assets nutzen, Verwaltungsmaße gemeinsam konkretisieren. Bilder sind räumliche Referenzen, keine autoritative Farbquelle oder auszuliefernde UI-Grafik. +9. Betroffene Abläufe funktional und visuell prüfen: Rückkehr, relevante Fehler-/Leer-/Ladezustände, Tastatur, breite/schmalere Fenster und fachliche Regressionen. Bestehende Betriebs- und Testregeln erfüllen. +10. Tatsächliche Komponentenwiederverwendung, Prüfergebnisse, gerenderte Screenshots und konkrete Abweichungen liefern; `regeln/ux-abnahme-vorlage.md` verwenden. Keine unbewiesene Abnahme behaupten. diff --git a/docs/ux/verwaltung/regeln/ux-abnahme-vorlage.md b/docs/ux/verwaltung/regeln/ux-abnahme-vorlage.md new file mode 100644 index 0000000..c78cc0a --- /dev/null +++ b/docs/ux/verwaltung/regeln/ux-abnahme-vorlage.md @@ -0,0 +1,30 @@ +# Vorlage: Übergabe eines Verwaltungsumbaus + +**Status: Vorschlag.** Für einen später ausdrücklich beauftragten Teil ausfüllen. Keine neue Genehmigungskette und keine Behauptung bereits ausgeführter Tests. + +## Aufgabe und Maßstab + +- Nutzeraufgabe und betroffener Arbeitsplatz: +- Bestätigte Entscheidungen und ausgewählte Referenz: +- Verwendete gemeinsame Komponenten und begründete Erweiterungen: +- Betroffene offene Fachfragen; für diesen Teil geklärt oder weiterhin ausgenommen: + +## Ergebnis + +- Konkretes Verhalten vorher/nachher: +- Speicher-, Vorschau- und Veröffentlichungswirkung: +- Umgang mit bestehenden Daten, Erwerbsrechten, Fassungen und historischen Nachweisen: +- Verbleibende Abweichungen gegenüber dem vereinbarten Standard: + +## Tatsächliche Prüfung + +| Prüffall | Ergebnis / Beleg | Grenze | +|---|---|---| +| Normaler durchgängiger Ablauf | Ausfüllen | Nicht geprüft ist kein Erfolg | +| Offene Eingaben, Kontextwechsel und Rückkehr | Ausfüllen | Einschließlich alter Formularwerte nach Redaktionsänderung, soweit betroffen | +| Relevante Leer-, Lade- und Fehlerzustände | Ausfüllen | Nur tatsächlich geprüfte Zustände nennen | +| Tastatur, Fokus, Dialoge und Sortierung | Ausfüllen | Jeweils betroffene Bedienwege | +| Darstellung auf vorgesehenen Breiten und mit Zoom | Ausfüllen | Tatsächliche Breiten/Ansichten angeben | +| Fachliche Regressionen und Repository-Prüfungen | Ausfüllen | Ausgeführte Prüfungen und Ergebnis benennen | + +Screenshots aus der gerenderten Anwendung, passende Testresultate und nachvollziehbare Schritte verlinken. Beispielbilder oder Behauptungen eines Coding-Agenten ersetzen keine Beobachtung. Abschließende Abnahme des beauftragten Umfangs und noch offene Punkte getrennt festhalten. diff --git a/docs/ux/verwaltung/tokens.md b/docs/ux/verwaltung/tokens.md new file mode 100644 index 0000000..aade12d --- /dev/null +++ b/docs/ux/verwaltung/tokens.md @@ -0,0 +1,39 @@ +# Verwaltungstokens + +Stand: 19.11.2026. Gemeinsame Werte für die Verwaltungsarbeitsplätze. Quelle der Farben ist das [Designsystem](../../architektur/designsystem.md), nicht die Mockups. + +**Eine Stelle:** `resources/views/filament/verwaltung/styles.blade.php`. Die Datei wird einmal je Seite über `PanelsRenderHook::STYLES_AFTER` im `AdminPanelProvider` geladen. Tokens liegen auf `:root` (`--vw-…`), Bausteine nutzen die Klassen `vw-…`. Ältere Bereiche (`luf-…` in `editorial/styles.blade.php`, `media/library-styles.blade.php`, `media/editor-styles.blade.php`) bleiben, bis ihre Arbeitsplätze umgebaut sind; sie definieren keine `vw-…`-Regeln mehr. + +| Token | Wert | Verwendung | +|---|---|---| +| `--vw-ink` | `#032551` | Text und Überschriften | +| `--vw-pine` / `--vw-pine-dark` | `#3b7b09` / `#2f6407` | Hauptaktion (Weißschrift), aktives Register, gewählte Kapsel | +| `--vw-pine-soft` | `#e9f3e1` | Hintergrund für „Eigene Angabe“, „Neu zugeordnet“, gewählte Chips | +| `--vw-paper` | `#f7f6f2` | ruhige Flächen, Quellenkasten | +| `--vw-line` / `--vw-line-strong` | `#d5ddd6` / `#b9c6bc` | Linien, Rahmen von Feldern und Schaltflächen | +| `--vw-quiet` / `--vw-muted` | `#3e4c5c` / `#5b6876` | Nebenangaben, leere Angaben | +| `--vw-select` / `--vw-select-line` | `#eef5fb` / `#1769aa` | betrachtete oder zuletzt bewegte Zeile | +| `--vw-info` / `--vw-info-line` | `#eef5fb` / `#d5e4f0` | Hinweisband (Speicherumfang) | +| `--vw-warn` / `--vw-error` | `#9a5b00` / `#a3261b` | „Nicht für Website freigegeben“, Fehler | +| `--vw-yellow` | `#fcd10a` | nur Markierung (Ablageziel beim Ziehen), nie als Textfarbe | +| Fokus | `#1769aa`, 3 px, 2 px Abstand | alle Bedienelemente | +| `--vw-target` | 2,75 rem | Mindesthöhe von Schaltflächen und Feldern; klein 2,25 rem | +| `--vw-radius` / `--vw-radius-small` | 0,5 / 0,35 rem | Karten, Felder, Bilder; Kapseln rund | +| `--vw-title` / `--vw-section` | 1,875 / 1,25 rem | Objekttitel, Abschnittstitel | +| `--vw-reading` | 46 rem | Lesebreite langer Texte (linke Textspalte höchstens 52 rem) | +| `--vw-thumb` / `--vw-thumb-small` | 9,5 / 6 rem, 16:9 | Vorschau in Zuordnungen bzw. Picker und schmalen Zeilen | +| `--vw-dialog` | 78 rem breit, höchstens 58 rem hoch | Picker; „Ausgabe prüfen“ 44 rem | + +## Umbrüche + +| Bereich | Breit | Schmaler | +|---|---|---| +| Register Texte | zwei Spalten (Texte 1,7 : Weitere Angaben 1) | ab 80 rem Fensterbreite eine Spalte | +| Zuordnungszeile | Griff, Bild, Text, Aktionen in einer Zeile | Containerbreite unter 52 rem: Aktionen in zweiter Zeile, Bild 6 rem | +| Galerie | Kacheln ab 17 rem, automatisch | eine Spalte, wenn der Platz fehlt | +| Picker | Liste und Detail nebeneinander, getrennt scrollbar | ab 64 rem eine gemeinsame Scrollfläche, Detail unter der Liste; unter 40 rem Vollbild | +| Medieneditor | Inhalt und Seitenspalte (20–26 rem) | ab 72 rem untereinander | + +Schrift: die Schrift des Filament-Panels. Die Marken-Schriften (Nunito, Source Sans 3) werden in der Verwaltung nicht geladen; ein Mischsatz mit Ersatzschriften wird vermieden. + +Öffentliche Website-Klassen bleiben in `resources/css/tokens.css`. diff --git a/package-lock.json b/package-lock.json new file mode 100644 index 0000000..011c8a1 --- /dev/null +++ b/package-lock.json @@ -0,0 +1,2283 @@ +{ + "name": "app", + "lockfileVersion": 3, + "requires": true, + "packages": { + "": { + "dependencies": { + "hls.js": "^1.7.4" + }, + "devDependencies": { + "@tailwindcss/vite": "^4.0.0", + "concurrently": "^10.0.3", + "laravel-vite-plugin": "^3.1", + "tailwindcss": "^4.0.0", + "vite": "^8.0.0" + }, + "optionalDependencies": { + "@laravel/multiplex": "^0.4.1" + } + }, + "node_modules/@alcalzone/ansi-tokenize": { + "version": "0.3.1", + "resolved": "https://registry.npmjs.org/@alcalzone/ansi-tokenize/-/ansi-tokenize-0.3.1.tgz", + "integrity": "sha512-cUD0PT0YX+rImRhfn7BfMRduP/tX/Zqt/N0dHlAyn2RlcJssCb5KsCJkhln61eh9vuJDkH8wKn3L8zJzzWXPFg==", + "license": "MIT", + "optional": true, + "dependencies": { + "ansi-styles": "^6.2.1", + "is-fullwidth-code-point": "^5.0.0" + }, + "engines": { + "node": ">=18" + } + }, + "node_modules/@alcalzone/ansi-tokenize/node_modules/ansi-styles": { + "version": "6.2.3", + "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-6.2.3.tgz", + "integrity": "sha512-4Dj6M28JB+oAH8kFkTLUo+a2jwOFkuqb3yucU0CANcRRUbxS0cP0nZYCGjcc3BNXwRIsUVmDGgzawme7zvJHvg==", + "license": "MIT", + "optional": true, + "engines": { + "node": ">=12" + }, + "funding": { + "url": "https://github.com/chalk/ansi-styles?sponsor=1" + } + }, + "node_modules/@emnapi/core": { + "version": "2.0.0-beta.2", + "resolved": "https://registry.npmjs.org/@emnapi/core/-/core-2.0.0-beta.2.tgz", + "integrity": "sha512-MzCVoWtcg4Pm2B3je5mMvYMvj3MmBKw+fU7vbsJc9/iT8ip6/eYIHo/Dsm/mr+wsHB6SEyJDuxB09Yy6r/8+4A==", + "dev": true, + "license": "MIT", + "optional": true, + "dependencies": { + "@emnapi/wasi-threads": "2.2.0", + "tslib": "^2.4.0" + } + }, + "node_modules/@emnapi/runtime": { + "version": "2.0.0-beta.2", + "resolved": "https://registry.npmjs.org/@emnapi/runtime/-/runtime-2.0.0-beta.2.tgz", + "integrity": "sha512-JcrSPzPvZuNZvJqPTF9Fw25LbOJ8avzFVlaf2grmH4Cku0oGP47tRgqPZadcfj3YoZMHkFVnCYFbQM8I+i5QEw==", + "dev": true, + "license": "MIT", + "optional": true, + "dependencies": { + "tslib": "^2.4.0" + } + }, + "node_modules/@emnapi/wasi-threads": { + "version": "2.2.0", + "resolved": "https://registry.npmjs.org/@emnapi/wasi-threads/-/wasi-threads-2.2.0.tgz", + "integrity": "sha512-JP7OYH38Q7+pyTAe14raZHLQIK7BDKbdwji+Xi3pcd/6QkJYQH3SX4wu6EplGrGJWRepoNzedfm0G3B9Z4e9Rw==", + "dev": true, + "license": "MIT", + "optional": true, + "dependencies": { + "tslib": "^2.4.0" + } + }, + "node_modules/@jridgewell/gen-mapping": { + "version": "0.3.13", + "resolved": "https://registry.npmjs.org/@jridgewell/gen-mapping/-/gen-mapping-0.3.13.tgz", + "integrity": "sha512-2kkt/7niJ6MgEPxF0bYdQ6etZaA+fQvDcLKckhy1yIQOzaoKjBBjSj63/aLVjYE3qhRt5dvM+uUyfCg6UKCBbA==", + "dev": true, + "license": "MIT", + "dependencies": { + "@jridgewell/sourcemap-codec": "^1.5.0", + "@jridgewell/trace-mapping": "^0.3.24" + } + }, + "node_modules/@jridgewell/remapping": { + "version": "2.3.5", + "resolved": "https://registry.npmjs.org/@jridgewell/remapping/-/remapping-2.3.5.tgz", + "integrity": "sha512-LI9u/+laYG4Ds1TDKSJW2YPrIlcVYOwi2fUC6xB43lueCjgxV4lffOCZCtYFiH6TNOX+tQKXx97T4IKHbhyHEQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "@jridgewell/gen-mapping": "^0.3.5", + "@jridgewell/trace-mapping": "^0.3.24" + } + }, + "node_modules/@jridgewell/resolve-uri": { + "version": "3.1.3", + "resolved": "https://registry.npmjs.org/@jridgewell/resolve-uri/-/resolve-uri-3.1.3.tgz", + "integrity": "sha512-lhTtjtoEArWBjismtfS761S9Hlyn+nIZqOZVYoZ1Xn82PMNMVnk+jj/NhC4fAXGTs7ydONcJiR5vyQBTMDu27g==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=6.0.0" + } + }, + "node_modules/@jridgewell/sourcemap-codec": { + "version": "1.6.0", + "resolved": "https://registry.npmjs.org/@jridgewell/sourcemap-codec/-/sourcemap-codec-1.6.0.tgz", + "integrity": "sha512-T7jf+5zgsZHwNJ4lvQ7/aezbyk0nNX+zJVWpmHA7VYsEx7a7qr5Rg5IbtJFqkgze5Y2sruq1RUY8Q837Od7iFw==", + "dev": true, + "license": "MIT" + }, + "node_modules/@jridgewell/trace-mapping": { + "version": "0.3.31", + "resolved": "https://registry.npmjs.org/@jridgewell/trace-mapping/-/trace-mapping-0.3.31.tgz", + "integrity": "sha512-zzNR+SdQSDJzc8joaeP8QQoCQr8NuYx2dIIytl1QeBEZHJ9uW6hebsrYgbz8hJwUQao3TWCMtmfV8Nu1twOLAw==", + "dev": true, + "license": "MIT", + "dependencies": { + "@jridgewell/resolve-uri": "^3.1.0", + "@jridgewell/sourcemap-codec": "^1.4.14" + } + }, + "node_modules/@laravel/multiplex": { + "version": "0.4.5", + "resolved": "https://registry.npmjs.org/@laravel/multiplex/-/multiplex-0.4.5.tgz", + "integrity": "sha512-NhDhj4b1/+6j1xYnonzx3vZa39CAUUM7iCAN0xZ5jjcYw3GKORtiXXb0XwXW74wyeVJ25vAvXzfIhy4MXmmzCw==", + "license": "MIT", + "optional": true, + "os": [ + "darwin", + "linux" + ], + "dependencies": { + "ansi-styles": "^7.0.0", + "commander": "^15.0.0", + "ink": "^7.1.0", + "react": "^19.2.7", + "string-width": "^8.2.2", + "wrap-ansi": "^10.0.0" + }, + "bin": { + "multiplex": "dist/cli.js" + }, + "engines": { + "node": ">=22.13.0" + } + }, + "node_modules/@napi-rs/wasm-runtime": { + "version": "1.2.6", + "resolved": "https://registry.npmjs.org/@napi-rs/wasm-runtime/-/wasm-runtime-1.2.6.tgz", + "integrity": "sha512-mRyDmEw9/fCDXCGfL1sbgIw/GUK0PVxRW4YwgPN61F3LQ+fSyoBFarJVzgGyhF6kRzEQZ0FejDqm4WLXSeqQmw==", + "dev": true, + "license": "MIT", + "optional": true, + "dependencies": { + "@tybys/wasm-util": "^0.10.3" + }, + "engines": { + "node": "^20.19.0 || ^22.13.0 || >=23.5.0" + }, + "funding": { + "type": "github", + "url": "https://github.com/sponsors/Brooooooklyn" + }, + "peerDependencies": { + "@emnapi/core": "^1.7.1 || 2.0.0-beta.2", + "@emnapi/runtime": "^1.7.1 || 2.0.0-beta.2" + } + }, + "node_modules/@oxc-project/types": { + "version": "0.156.0", + "resolved": "https://registry.npmjs.org/@oxc-project/types/-/types-0.156.0.tgz", + "integrity": "sha512-1Duyg48TdJNdyhEB8Xn1L36bT9Pv6GUtlKjHxOys8xkaF/rQq3XJE+bAurSK/AgIz5mGFsb77cn9Pb20+WCScw==", + "dev": true, + "license": "MIT", + "funding": { + "url": "https://github.com/sponsors/oxc-project" + } + }, + "node_modules/@rolldown/binding-android-arm-eabi": { + "version": "1.2.19", + "resolved": "https://registry.npmjs.org/@rolldown/binding-android-arm-eabi/-/binding-android-arm-eabi-1.2.19.tgz", + "integrity": "sha512-e+Ebe0WT+9tbXmNKPIiC8YrWAHYwug3m6i4p3rZGGulfZri1jtI4HslT+OZnFf/OIHowWF71DTlHwXBP2SiA7A==", + "cpu": [ + "arm" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "android" + ], + "engines": { + "node": "^20.19.0 || >=22.12.0" + } + }, + "node_modules/@rolldown/binding-android-arm64": { + "version": "1.2.19", + "resolved": "https://registry.npmjs.org/@rolldown/binding-android-arm64/-/binding-android-arm64-1.2.19.tgz", + "integrity": "sha512-hOombrTJ+szt2ciEzS7oCA78lMPBgF5UMQWCJIyNfnrI7GLl8HYoFqCnpL2gcPOaXMqryGCU5ExdQKyDDcC+yA==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "android" + ], + "engines": { + "node": "^20.19.0 || >=22.12.0" + } + }, + "node_modules/@rolldown/binding-darwin-arm64": { + "version": "1.2.19", + "resolved": "https://registry.npmjs.org/@rolldown/binding-darwin-arm64/-/binding-darwin-arm64-1.2.19.tgz", + "integrity": "sha512-XoMA2pwCKGTQzUjPgtRwkedH4WmXhdIPKT6l6oOxd1PUbNodGI6DcBekgN7EC//+x3pfBYX/qL1gNmZAqivw5g==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "darwin" + ], + "engines": { + "node": "^20.19.0 || >=22.12.0" + } + }, + "node_modules/@rolldown/binding-darwin-x64": { + "version": "1.2.19", + "resolved": "https://registry.npmjs.org/@rolldown/binding-darwin-x64/-/binding-darwin-x64-1.2.19.tgz", + "integrity": "sha512-zo8EsSSwMZCY/e+fRnGaX02YGgvJD0yvhNi/9hpGPA2MJ9ZF8dPCw75UGfpI6OpQ/myR/dIYmogRvqiZD0TrXg==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "darwin" + ], + "engines": { + "node": "^20.19.0 || >=22.12.0" + } + }, + "node_modules/@rolldown/binding-freebsd-x64": { + "version": "1.2.19", + "resolved": "https://registry.npmjs.org/@rolldown/binding-freebsd-x64/-/binding-freebsd-x64-1.2.19.tgz", + "integrity": "sha512-O8ISAOfI1nj7AuBPd30FSF47z7f7lzlk5poQVGgiikvQuGEBFYvW8ki+UEnT+YJPnNGjQzn304klt4O9FUE7mA==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "freebsd" + ], + "engines": { + "node": "^20.19.0 || >=22.12.0" + } + }, + "node_modules/@rolldown/binding-linux-arm-gnueabihf": { + "version": "1.2.19", + "resolved": "https://registry.npmjs.org/@rolldown/binding-linux-arm-gnueabihf/-/binding-linux-arm-gnueabihf-1.2.19.tgz", + "integrity": "sha512-/lYCba5NO0yq4S0jGMH8QTBtkvQxoXjoQWzF5BcWp9MjB9jxVRD1GQDNofkVjcOj30DWyhLIN/4Oe60JKzaONw==", + "cpu": [ + "arm" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": "^20.19.0 || >=22.12.0" + } + }, + "node_modules/@rolldown/binding-linux-arm64-gnu": { + "version": "1.2.19", + "resolved": "https://registry.npmjs.org/@rolldown/binding-linux-arm64-gnu/-/binding-linux-arm64-gnu-1.2.19.tgz", + "integrity": "sha512-pm/apFMBnSbFb3O6nG5pHO1iqHhZrjGDFEjSm+ot9J17XXPvH9L90y5h+jgfHCE+Qdlsvy8qKEcU4VKxgjD+vA==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": "^20.19.0 || >=22.12.0" + } + }, + "node_modules/@rolldown/binding-linux-arm64-musl": { + "version": "1.2.19", + "resolved": "https://registry.npmjs.org/@rolldown/binding-linux-arm64-musl/-/binding-linux-arm64-musl-1.2.19.tgz", + "integrity": "sha512-K1SmQp3FFichn8oqrNIwvFoZ5wcvjC7goBzpaMNvLf9FZc+QB/QvLmnpJZgAAGHiD980tP8FZZnXk2K94rvlxg==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": "^20.19.0 || >=22.12.0" + } + }, + "node_modules/@rolldown/binding-linux-ppc64-gnu": { + "version": "1.2.19", + "resolved": "https://registry.npmjs.org/@rolldown/binding-linux-ppc64-gnu/-/binding-linux-ppc64-gnu-1.2.19.tgz", + "integrity": "sha512-I0xwD57jP/3A7+5UPZin2w8Y7XHEmEM5zqpYZOcQ45MlNW6tUJUziymV3yRr7rL4vwyfEcRsRksC4a7Kc08p5Q==", + "cpu": [ + "ppc64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": "^20.19.0 || >=22.12.0" + } + }, + "node_modules/@rolldown/binding-linux-s390x-gnu": { + "version": "1.2.19", + "resolved": "https://registry.npmjs.org/@rolldown/binding-linux-s390x-gnu/-/binding-linux-s390x-gnu-1.2.19.tgz", + "integrity": "sha512-BrtEHT24SNXj9HiXqy+s/kXiSiQGt6EKCPUlRirAoIioVxKGnbXBUEkbZASAei7iZJB0/Ynm+0JP00Ipx7AnSw==", + "cpu": [ + "s390x" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": "^20.19.0 || >=22.12.0" + } + }, + "node_modules/@rolldown/binding-linux-x64-gnu": { + "version": "1.2.19", + "resolved": "https://registry.npmjs.org/@rolldown/binding-linux-x64-gnu/-/binding-linux-x64-gnu-1.2.19.tgz", + "integrity": "sha512-rm75/9DkHKeU2WnA8w4X94WGYgLlDCFCfkQC+4bguVJmC/jvDRv2B+2wLOYhyE0fVuv7//Ckk39OoOufyCu76Q==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": "^20.19.0 || >=22.12.0" + } + }, + "node_modules/@rolldown/binding-linux-x64-musl": { + "version": "1.2.19", + "resolved": "https://registry.npmjs.org/@rolldown/binding-linux-x64-musl/-/binding-linux-x64-musl-1.2.19.tgz", + "integrity": "sha512-irh/4+iYFM4GAzpluDErgjz89bj6NDtqqMAG/6O1LG38Ed3NpyebzCpcVNkFW8uhy+/3/BocUvnXDR33CXWe9A==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": "^20.19.0 || >=22.12.0" + } + }, + "node_modules/@rolldown/binding-openharmony-arm64": { + "version": "1.2.19", + "resolved": "https://registry.npmjs.org/@rolldown/binding-openharmony-arm64/-/binding-openharmony-arm64-1.2.19.tgz", + "integrity": "sha512-+KWTWNoPt+CfSq94CiceWu3yPE+QzkaG+phPyz9G60tmZLwfQkcA4AeksafzvJAw4pvg1mcd5a1TkUqVv0s4JA==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "openharmony" + ], + "engines": { + "node": "^20.19.0 || >=22.12.0" + } + }, + "node_modules/@rolldown/binding-wasm32-wasi": { + "version": "1.2.19", + "resolved": "https://registry.npmjs.org/@rolldown/binding-wasm32-wasi/-/binding-wasm32-wasi-1.2.19.tgz", + "integrity": "sha512-7EH+skOsl5qpWnK0vzamgJFhOv1cwxQpsxm8tI883K9fur5c27p8q87fzEO6BbBPabA2/+s/zR63/pLc137iOg==", + "cpu": [ + "wasm32" + ], + "dev": true, + "license": "MIT", + "optional": true, + "dependencies": { + "@emnapi/core": "2.0.0-beta.2", + "@emnapi/runtime": "2.0.0-beta.2", + "@napi-rs/wasm-runtime": "1.2.6" + }, + "engines": { + "node": "^20.19.0 || ^22.13.0 || >=23.5.0" + } + }, + "node_modules/@rolldown/binding-win32-arm64-msvc": { + "version": "1.2.19", + "resolved": "https://registry.npmjs.org/@rolldown/binding-win32-arm64-msvc/-/binding-win32-arm64-msvc-1.2.19.tgz", + "integrity": "sha512-3Q1Yg1Q7tEvBWoZf5rFvG/GKZQPgwfru+p4wBajDfJFBs0SHCpL++dfTjW9gyAKd1T7ZpIYvdaUax7Pa/IhFVQ==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "win32" + ], + "engines": { + "node": "^20.19.0 || >=22.12.0" + } + }, + "node_modules/@rolldown/binding-win32-x64-msvc": { + "version": "1.2.19", + "resolved": "https://registry.npmjs.org/@rolldown/binding-win32-x64-msvc/-/binding-win32-x64-msvc-1.2.19.tgz", + "integrity": "sha512-y/sqRRc6d7hECzOFc5n3LSeqctmIp9mMjY1Kq4s14uLPd/LZ4z7i1zrW6fMtp2mPeuQIC4e6ULMcwQzMomqQag==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "win32" + ], + "engines": { + "node": "^20.19.0 || >=22.12.0" + } + }, + "node_modules/@rolldown/pluginutils": { + "version": "1.1.1", + "resolved": "https://registry.npmjs.org/@rolldown/pluginutils/-/pluginutils-1.1.1.tgz", + "integrity": "sha512-glFIJDvLNDtJhT9qrMFWLPbvS+skxgt4L0K8Ei2YtnhPysAJnsI7nyxSJxKj4ADeKX0OLjC4ntRkwpLOoS3rwA==", + "dev": true, + "license": "MIT" + }, + "node_modules/@tailwindcss/node": { + "version": "4.3.5", + "resolved": "https://registry.npmjs.org/@tailwindcss/node/-/node-4.3.5.tgz", + "integrity": "sha512-yT53FzV4ke0cr/BguDxhWMpm5MJu1O2muzk+tKw6lKHjODAsYArBbWwFbJiaksfzFv1tpkO9QHGzmfs1hJT66g==", + "dev": true, + "license": "MIT", + "dependencies": { + "@jridgewell/remapping": "^2.3.5", + "enhanced-resolve": "^5.24.5", + "jiti": "^2.7.0", + "lightningcss": "1.33.0", + "magic-string": "^1.1.0", + "source-map-js": "^1.2.1", + "tailwindcss": "4.3.5" + } + }, + "node_modules/@tailwindcss/oxide": { + "version": "4.3.5", + "resolved": "https://registry.npmjs.org/@tailwindcss/oxide/-/oxide-4.3.5.tgz", + "integrity": "sha512-PynqGLZsZvwM9tqD/CUxkOIfyd6K5elZ2MooauzJryP/UqXYgi3yYbtt3N0Xe+MHV/eFKPFQCEfIKAqlAS1CBg==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">= 20" + }, + "optionalDependencies": { + "@tailwindcss/oxide-android-arm64": "4.3.5", + "@tailwindcss/oxide-darwin-arm64": "4.3.5", + "@tailwindcss/oxide-darwin-x64": "4.3.5", + "@tailwindcss/oxide-freebsd-x64": "4.3.5", + "@tailwindcss/oxide-linux-arm-gnueabihf": "4.3.5", + "@tailwindcss/oxide-linux-arm64-gnu": "4.3.5", + "@tailwindcss/oxide-linux-arm64-musl": "4.3.5", + "@tailwindcss/oxide-linux-x64-gnu": "4.3.5", + "@tailwindcss/oxide-linux-x64-musl": "4.3.5", + "@tailwindcss/oxide-wasm32-wasi": "4.3.5", + "@tailwindcss/oxide-win32-arm64-msvc": "4.3.5", + "@tailwindcss/oxide-win32-x64-msvc": "4.3.5" + } + }, + "node_modules/@tailwindcss/oxide-android-arm64": { + "version": "4.3.5", + "resolved": "https://registry.npmjs.org/@tailwindcss/oxide-android-arm64/-/oxide-android-arm64-4.3.5.tgz", + "integrity": "sha512-Se0z5xMqcSQanJD1IYmO0cGpK3iv0fp3ZsIT7xRJZ1Da5PghvNoc46zz4jIQn+aan3dV9T8AermFNN9QPmsh0Q==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "android" + ], + "engines": { + "node": ">= 20" + } + }, + "node_modules/@tailwindcss/oxide-darwin-arm64": { + "version": "4.3.5", + "resolved": "https://registry.npmjs.org/@tailwindcss/oxide-darwin-arm64/-/oxide-darwin-arm64-4.3.5.tgz", + "integrity": "sha512-UPrgTDuUbvmqGMZuCnmI3FKee/tYKzKdp00/kuB4oSGB213VYg8QTdF7lVhnPoBXq/mIfJ+ILoBFqNOboWcMwQ==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "darwin" + ], + "engines": { + "node": ">= 20" + } + }, + "node_modules/@tailwindcss/oxide-darwin-x64": { + "version": "4.3.5", + "resolved": "https://registry.npmjs.org/@tailwindcss/oxide-darwin-x64/-/oxide-darwin-x64-4.3.5.tgz", + "integrity": "sha512-E+p7HEtjI0b8D7kbbWxH067cGui6d4c79COGko9fAPVE3rwc1E7ld2HFCbaG86AOGWS5VKQYqZOaf38ya4uxTQ==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "darwin" + ], + "engines": { + "node": ">= 20" + } + }, + "node_modules/@tailwindcss/oxide-freebsd-x64": { + "version": "4.3.5", + "resolved": "https://registry.npmjs.org/@tailwindcss/oxide-freebsd-x64/-/oxide-freebsd-x64-4.3.5.tgz", + "integrity": "sha512-yWEWcWyAG7rWOcTpJTjdhQ3pcaFY2h+0bqTRfgU3G2fz87ZU3AKdvdZKhslD+kyHnjBUWKvNdRYwIYC5dI1tIg==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "freebsd" + ], + "engines": { + "node": ">= 20" + } + }, + "node_modules/@tailwindcss/oxide-linux-arm-gnueabihf": { + "version": "4.3.5", + "resolved": "https://registry.npmjs.org/@tailwindcss/oxide-linux-arm-gnueabihf/-/oxide-linux-arm-gnueabihf-4.3.5.tgz", + "integrity": "sha512-WmeVjtJhZlr+smpqcdR2kQkkn6arHIJnUIBxTO2EJcTLGY1ecVXNo2hbSn8xc0IH2aEtys936iMWKGyj0GaKnA==", + "cpu": [ + "arm" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">= 20" + } + }, + "node_modules/@tailwindcss/oxide-linux-arm64-gnu": { + "version": "4.3.5", + "resolved": "https://registry.npmjs.org/@tailwindcss/oxide-linux-arm64-gnu/-/oxide-linux-arm64-gnu-4.3.5.tgz", + "integrity": "sha512-DTCSyucc6ShMp1QMqV5R94Z7xlgNgUzkGmFF1rL5HH2Qjy4eSmEqy+YLGkqqYvWa4sILtgrBt1JjRKbneQtiFQ==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">= 20" + } + }, + "node_modules/@tailwindcss/oxide-linux-arm64-musl": { + "version": "4.3.5", + "resolved": "https://registry.npmjs.org/@tailwindcss/oxide-linux-arm64-musl/-/oxide-linux-arm64-musl-4.3.5.tgz", + "integrity": "sha512-H9lsvO4x9E4nE4Hi8h7NHHw0O/kcVSu+iOyFHNGdYzazGgDjFHZbE6S3hQ8kMcbNXSBlMdNi67LV5EVqtpaJtw==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">= 20" + } + }, + "node_modules/@tailwindcss/oxide-linux-x64-gnu": { + "version": "4.3.5", + "resolved": "https://registry.npmjs.org/@tailwindcss/oxide-linux-x64-gnu/-/oxide-linux-x64-gnu-4.3.5.tgz", + "integrity": "sha512-4uxQvtBvPuIdl13WfUBj9xMZHH14PtHZ8OZdtLmdyDtG66sCa1t599NZT+jagkUzRtWhuul1qRZQ1nAJscXN5g==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">= 20" + } + }, + "node_modules/@tailwindcss/oxide-linux-x64-musl": { + "version": "4.3.5", + "resolved": "https://registry.npmjs.org/@tailwindcss/oxide-linux-x64-musl/-/oxide-linux-x64-musl-4.3.5.tgz", + "integrity": "sha512-0JQAzs7jwbA7O6+z/adU+Jk3AXwsu3npAhtr5escXS7TqEqWcaDV7qHuI+0Vy/KQRuVGnLQREcSJWYauyV3oqg==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">= 20" + } + }, + "node_modules/@tailwindcss/oxide-wasm32-wasi": { + "version": "4.3.5", + "resolved": "https://registry.npmjs.org/@tailwindcss/oxide-wasm32-wasi/-/oxide-wasm32-wasi-4.3.5.tgz", + "integrity": "sha512-OJhFmlEfdzMr+avACdi40RPtnkW0B6hXyxL/8r+tnEHBWZji36CYRjEXrrvgBmaYsD3oEOBqwYFRKsYvzFe7Bw==", + "bundleDependencies": [ + "@napi-rs/wasm-runtime", + "@emnapi/core", + "@emnapi/runtime", + "@tybys/wasm-util", + "@emnapi/wasi-threads", + "tslib" + ], + "dev": true, + "license": "MIT", + "optional": true, + "dependencies": { + "@emnapi/core": "^1.11.3", + "@emnapi/runtime": "^1.11.3", + "@emnapi/wasi-threads": "^1.2.3", + "@napi-rs/wasm-runtime": "^1.2.2", + "@tybys/wasm-util": "^0.10.3", + "tslib": "^2.8.1" + }, + "engines": { + "node": "^20.19.0 || ^22.13.0 || >=23.5.0" + } + }, + "node_modules/@tailwindcss/oxide-wasm32-wasi/node_modules/@emnapi/core": { + "version": "1.11.3", + "dev": true, + "inBundle": true, + "license": "MIT", + "optional": true, + "dependencies": { + "@emnapi/wasi-threads": "1.2.3", + "tslib": "^2.4.0" + } + }, + "node_modules/@tailwindcss/oxide-wasm32-wasi/node_modules/@emnapi/runtime": { + "version": "1.11.3", + "dev": true, + "inBundle": true, + "license": "MIT", + "optional": true, + "dependencies": { + "tslib": "^2.4.0" + } + }, + "node_modules/@tailwindcss/oxide-wasm32-wasi/node_modules/@emnapi/wasi-threads": { + "version": "1.2.3", + "dev": true, + "inBundle": true, + "license": "MIT", + "optional": true, + "dependencies": { + "tslib": "^2.4.0" + } + }, + "node_modules/@tailwindcss/oxide-wasm32-wasi/node_modules/@napi-rs/wasm-runtime": { + "version": "1.2.2", + "dev": true, + "inBundle": true, + "license": "MIT", + "optional": true, + "dependencies": { + "@tybys/wasm-util": "^0.10.3" + }, + "engines": { + "node": "^20.19.0 || ^22.13.0 || >=23.5.0" + }, + "funding": { + "type": "github", + "url": "https://github.com/sponsors/Brooooooklyn" + }, + "peerDependencies": { + "@emnapi/core": "^1.7.1 || ^2.0.0-alpha.3", + "@emnapi/runtime": "^1.7.1 || ^2.0.0-alpha.3" + } + }, + "node_modules/@tailwindcss/oxide-wasm32-wasi/node_modules/@tybys/wasm-util": { + "version": "0.10.3", + "dev": true, + "inBundle": true, + "license": "MIT", + "optional": true, + "dependencies": { + "tslib": "^2.4.0" + } + }, + "node_modules/@tailwindcss/oxide-wasm32-wasi/node_modules/tslib": { + "version": "2.8.1", + "dev": true, + "inBundle": true, + "license": "0BSD", + "optional": true + }, + "node_modules/@tailwindcss/oxide-win32-arm64-msvc": { + "version": "4.3.5", + "resolved": "https://registry.npmjs.org/@tailwindcss/oxide-win32-arm64-msvc/-/oxide-win32-arm64-msvc-4.3.5.tgz", + "integrity": "sha512-9o8jgthi+QE5eandnboiJT64VQfnIArfZzSTdgbhEK5aafdiu2jTW9Honi/mwYHxBZuH1vAC57IFyrh+0iK5Gg==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "win32" + ], + "engines": { + "node": ">= 20" + } + }, + "node_modules/@tailwindcss/oxide-win32-x64-msvc": { + "version": "4.3.5", + "resolved": "https://registry.npmjs.org/@tailwindcss/oxide-win32-x64-msvc/-/oxide-win32-x64-msvc-4.3.5.tgz", + "integrity": "sha512-XiKFfIy1RWe7qK4WqByxNW7Oz1/nkOy8o/BWhHminyV1PmpUd8Eedj5v2A8h2kpqeVlz6xRnwk9Fr/ZXNLcZfg==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "win32" + ], + "engines": { + "node": ">= 20" + } + }, + "node_modules/@tailwindcss/vite": { + "version": "4.3.5", + "resolved": "https://registry.npmjs.org/@tailwindcss/vite/-/vite-4.3.5.tgz", + "integrity": "sha512-BCNiY0a1ZjdOHVqw7kyb7U72BwfMF3dfUuN+tQsLWky/J5JOI/r7abibglXfygrZhVO/3u3V+E25kkKTeMkXaQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "@tailwindcss/node": "4.3.5", + "@tailwindcss/oxide": "4.3.5", + "tailwindcss": "4.3.5" + }, + "peerDependencies": { + "vite": "^5.2.0 || ^6 || ^7 || ^8" + } + }, + "node_modules/@tybys/wasm-util": { + "version": "0.10.4", + "resolved": "https://registry.npmjs.org/@tybys/wasm-util/-/wasm-util-0.10.4.tgz", + "integrity": "sha512-W3c4gRigFS0T/Ma4qIYF3GDAc5AQdHb1yL5znJT1Zv1YaD9Kitx656wBjvr19qbiosmZT8lWDM5BEMynUqX65A==", + "dev": true, + "license": "MIT", + "optional": true, + "dependencies": { + "tslib": "^2.4.0" + } + }, + "node_modules/ansi-escapes": { + "version": "7.3.0", + "resolved": "https://registry.npmjs.org/ansi-escapes/-/ansi-escapes-7.3.0.tgz", + "integrity": "sha512-BvU8nYgGQBxcmMuEeUEmNTvrMVjJNSH7RgW24vXexN4Ven6qCvy4TntnvlnwnMLTVlcRQQdbRY8NKnaIoeWDNg==", + "license": "MIT", + "optional": true, + "dependencies": { + "environment": "^1.0.0" + }, + "engines": { + "node": ">=18" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/ansi-regex": { + "version": "6.6.0", + "resolved": "https://registry.npmjs.org/ansi-regex/-/ansi-regex-6.6.0.tgz", + "integrity": "sha512-XZ5apbzreCbXSKwPjJstu8R0zOi247w3XYwWxtwBXgpZrCyc1Ka7p9/xY0A9/diMewmHbEKz+FIraWaEWjlN5g==", + "devOptional": true, + "license": "MIT", + "engines": { + "node": ">=12" + }, + "funding": { + "url": "https://github.com/chalk/ansi-regex?sponsor=1" + } + }, + "node_modules/ansi-styles": { + "version": "7.0.0", + "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-7.0.0.tgz", + "integrity": "sha512-kKvt3m4uwzqL0wlkPd09CmljPJGOZZ4D0fP65sqFSvPkMRKhNi+74MgIJ5QxE6SxqB4t4KyUFGg8+n5zjo6hew==", + "license": "MIT", + "optional": true, + "engines": { + "node": ">=22" + }, + "funding": { + "url": "https://github.com/chalk/ansi-styles?sponsor=1" + } + }, + "node_modules/auto-bind": { + "version": "5.0.1", + "resolved": "https://registry.npmjs.org/auto-bind/-/auto-bind-5.0.1.tgz", + "integrity": "sha512-ooviqdwwgfIfNmDwo94wlshcdzfO64XV0Cg6oDsDYBJfITDz1EngD2z7DkbvCWn+XIMsIqW27sEVF6qcpJrRcg==", + "license": "MIT", + "optional": true, + "engines": { + "node": "^12.20.0 || ^14.13.1 || >=16.0.0" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/chalk": { + "version": "5.6.2", + "resolved": "https://registry.npmjs.org/chalk/-/chalk-5.6.2.tgz", + "integrity": "sha512-7NzBL0rN6fMUW+f7A6Io4h40qQlG+xGmtMxfbnH/K7TAtt8JQWVQK+6g0UXKMeVJoyV5EkkNsErQ8pVD3bLHbA==", + "devOptional": true, + "license": "MIT", + "engines": { + "node": "^12.17.0 || ^14.13 || >=16.0.0" + }, + "funding": { + "url": "https://github.com/chalk/chalk?sponsor=1" + } + }, + "node_modules/cli-boxes": { + "version": "4.0.1", + "resolved": "https://registry.npmjs.org/cli-boxes/-/cli-boxes-4.0.1.tgz", + "integrity": "sha512-5IOn+jcCEHEraYolBPs/sT4BxYCe2nHg374OPiItB1O96KZFseS2gthU4twyYzeDcFew4DaUM/xwc5BQf08JJw==", + "license": "MIT", + "optional": true, + "engines": { + "node": ">=18.20 <19 || >=20.10" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/cli-cursor": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/cli-cursor/-/cli-cursor-4.0.0.tgz", + "integrity": "sha512-VGtlMu3x/4DOtIUwEkRezxUZ2lBacNJCHash0N0WeZDBS+7Ux1dm3XWAgWYxLJFMMdOeXMHXorshEFhbMSGelg==", + "license": "MIT", + "optional": true, + "dependencies": { + "restore-cursor": "^4.0.0" + }, + "engines": { + "node": "^12.20.0 || ^14.13.1 || >=16.0.0" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/cli-truncate": { + "version": "6.2.0", + "resolved": "https://registry.npmjs.org/cli-truncate/-/cli-truncate-6.2.0.tgz", + "integrity": "sha512-5uyZew3nYoDgyltqSI8OER6DuyecorYOSVDAXl9wQ9Y8Re/HaQ/5qP0HmTUOUQqmvtpB+mlsf1gG/FUS3U1gLQ==", + "license": "MIT", + "optional": true, + "dependencies": { + "slice-ansi": "^10.0.0", + "string-width": "^8.3.0" + }, + "engines": { + "node": ">=22" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/cli-truncate/node_modules/slice-ansi": { + "version": "10.0.1", + "resolved": "https://registry.npmjs.org/slice-ansi/-/slice-ansi-10.0.1.tgz", + "integrity": "sha512-CJKEH3zwVX4bOnE+bFbmh+JK/YMT9VAazqBsVBTesnYKXlNtz6oVmrhNp1jHrxHzscuUkWiKZpzNzFraZcrorg==", + "license": "MIT", + "optional": true, + "dependencies": { + "ansi-styles": "^7.0.0", + "string-width": "^8.3.0" + }, + "engines": { + "node": ">=22" + }, + "funding": { + "url": "https://github.com/chalk/slice-ansi?sponsor=1" + } + }, + "node_modules/cliui": { + "version": "9.0.1", + "resolved": "https://registry.npmjs.org/cliui/-/cliui-9.0.1.tgz", + "integrity": "sha512-k7ndgKhwoQveBL+/1tqGJYNz097I7WOvwbmmU2AR5+magtbjPWQTS1C5vzGkBC8Ym8UWRzfKUzUUqFLypY4Q+w==", + "dev": true, + "license": "ISC", + "dependencies": { + "string-width": "^7.2.0", + "strip-ansi": "^7.1.0", + "wrap-ansi": "^9.0.0" + }, + "engines": { + "node": ">=20" + } + }, + "node_modules/cliui/node_modules/ansi-styles": { + "version": "6.2.3", + "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-6.2.3.tgz", + "integrity": "sha512-4Dj6M28JB+oAH8kFkTLUo+a2jwOFkuqb3yucU0CANcRRUbxS0cP0nZYCGjcc3BNXwRIsUVmDGgzawme7zvJHvg==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=12" + }, + "funding": { + "url": "https://github.com/chalk/ansi-styles?sponsor=1" + } + }, + "node_modules/cliui/node_modules/string-width": { + "version": "7.2.0", + "resolved": "https://registry.npmjs.org/string-width/-/string-width-7.2.0.tgz", + "integrity": "sha512-tsaTIkKW9b4N+AEj+SVA+WhJzV7/zMhcSu78mLKWSk7cXMOSHsBKFWUs0fWwq8QyK3MgJBQRX6Gbi4kYbdvGkQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "emoji-regex": "^10.3.0", + "get-east-asian-width": "^1.0.0", + "strip-ansi": "^7.1.0" + }, + "engines": { + "node": ">=18" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/cliui/node_modules/wrap-ansi": { + "version": "9.0.2", + "resolved": "https://registry.npmjs.org/wrap-ansi/-/wrap-ansi-9.0.2.tgz", + "integrity": "sha512-42AtmgqjV+X1VpdOfyTGOYRi0/zsoLqtXQckTmqTeybT+BDIbM/Guxo7x3pE2vtpr1ok6xRqM9OpBe+Jyoqyww==", + "dev": true, + "license": "MIT", + "dependencies": { + "ansi-styles": "^6.2.1", + "string-width": "^7.0.0", + "strip-ansi": "^7.1.0" + }, + "engines": { + "node": ">=18" + }, + "funding": { + "url": "https://github.com/chalk/wrap-ansi?sponsor=1" + } + }, + "node_modules/code-excerpt": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/code-excerpt/-/code-excerpt-4.0.0.tgz", + "integrity": "sha512-xxodCmBen3iy2i0WtAK8FlFNrRzjUqjRsMfho58xT/wvZU1YTM3fCnRjcy1gJPMepaRlgm/0e6w8SpWHpn3/cA==", + "license": "MIT", + "optional": true, + "dependencies": { + "convert-to-spaces": "^2.0.1" + }, + "engines": { + "node": "^12.20.0 || ^14.13.1 || >=16.0.0" + } + }, + "node_modules/commander": { + "version": "15.1.0", + "resolved": "https://registry.npmjs.org/commander/-/commander-15.1.0.tgz", + "integrity": "sha512-cgnQ88TRrWcC7pVq46RzJVRMktu3W2RcbnoidnfBsl1bmDCBwJS/udcIZpKoCrbAYYaCqsz1yZCVIgbIaU3ddQ==", + "license": "MIT", + "optional": true, + "engines": { + "node": ">=22.12.0" + } + }, + "node_modules/concurrently": { + "version": "10.0.7", + "resolved": "https://registry.npmjs.org/concurrently/-/concurrently-10.0.7.tgz", + "integrity": "sha512-zMCeLhawVIj3SLbpg0/BWCdJl1wcBSpcHKbNrhaM01P3xAlEWcH30Lea2q+F4uGZ7YM0scDK0dgpWyn1uCJj6w==", + "dev": true, + "license": "MIT", + "dependencies": { + "chalk": "5.6.2", + "rxjs": "7.8.2", + "shell-quote": "1.12.0", + "supports-color": "10.2.2", + "tree-kill": "1.2.2", + "yargs": "18.0.0" + }, + "bin": { + "conc": "dist/bin/index.js", + "concurrently": "dist/bin/index.js" + }, + "engines": { + "node": ">=22" + }, + "funding": { + "url": "https://github.com/open-cli-tools/concurrently?sponsor=1" + } + }, + "node_modules/convert-to-spaces": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/convert-to-spaces/-/convert-to-spaces-2.0.1.tgz", + "integrity": "sha512-rcQ1bsQO9799wq24uE5AM2tAILy4gXGIK/njFWcVQkGNZ96edlpY+A7bjwvzjYvLDyzmG1MmMLZhpcsb+klNMQ==", + "license": "MIT", + "optional": true, + "engines": { + "node": "^12.20.0 || ^14.13.1 || >=16.0.0" + } + }, + "node_modules/detect-libc": { + "version": "2.1.2", + "resolved": "https://registry.npmjs.org/detect-libc/-/detect-libc-2.1.2.tgz", + "integrity": "sha512-Btj2BOOO83o3WyH59e8MgXsxEQVcarkUOpEYrubB0urwnN10yQ364rsiByU11nZlqWYZm05i/of7io4mzihBtQ==", + "dev": true, + "license": "Apache-2.0", + "engines": { + "node": ">=8" + } + }, + "node_modules/emoji-regex": { + "version": "10.6.0", + "resolved": "https://registry.npmjs.org/emoji-regex/-/emoji-regex-10.6.0.tgz", + "integrity": "sha512-toUI84YS5YmxW219erniWD0CIVOo46xGKColeNQRgOzDorgBi1v4D71/OFzgD9GO2UGKIv1C3Sp8DAn0+j5w7A==", + "dev": true, + "license": "MIT" + }, + "node_modules/enhanced-resolve": { + "version": "5.27.0", + "resolved": "https://registry.npmjs.org/enhanced-resolve/-/enhanced-resolve-5.27.0.tgz", + "integrity": "sha512-Do6BB2xzlcc/odFg+XEYyneAx4T/WfywO71yw9ePS2tVfRsf7JVR4mUeELadIeHzixkzbG5DpluiEFPi2WGfYQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "graceful-fs": "^4.2.4", + "tapable": "^2.3.3" + }, + "engines": { + "node": ">=10.13.0" + } + }, + "node_modules/environment": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/environment/-/environment-1.1.0.tgz", + "integrity": "sha512-xUtoPkMggbz0MPyPiIWr1Kp4aeWJjDZ6SMvURhimjdZgsRuDplF5/s9hcgGhyXMhs+6vpnuoiZ2kFiu3FMnS8Q==", + "license": "MIT", + "optional": true, + "engines": { + "node": ">=18" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/es-toolkit": { + "version": "1.53.2", + "resolved": "https://registry.npmjs.org/es-toolkit/-/es-toolkit-1.53.2.tgz", + "integrity": "sha512-iUqZ+NlwH4jUgRmXZUxFBsV/9762TQEa1O4IXLFBmDEjVHScBytKuseX23I0+v9ShZ5MYxEx6WKNzm6IPnex8g==", + "license": "MIT", + "optional": true, + "workspaces": [ + "docs", + "benchmarks", + "tests/types", + "tests/browser-compat" + ] + }, + "node_modules/escalade": { + "version": "3.2.0", + "resolved": "https://registry.npmjs.org/escalade/-/escalade-3.2.0.tgz", + "integrity": "sha512-WUj2qlxaQtO4g6Pq5c29GTcWGDyd8itL8zTlipgECz3JesAiiOKotd8JU6otB3PACgG6xkJUyVhboMS+bje/jA==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=6" + } + }, + "node_modules/escape-string-regexp": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/escape-string-regexp/-/escape-string-regexp-2.0.0.tgz", + "integrity": "sha512-UpzcLCXolUWcNu5HtVMHYdXJjArjsF9C0aNnquZYY4uW/Vu0miy5YoWvbV345HauVvcAUnpRuhMMcqTcGOY2+w==", + "license": "MIT", + "optional": true, + "engines": { + "node": ">=8" + } + }, + "node_modules/fdir": { + "version": "6.5.0", + "resolved": "https://registry.npmjs.org/fdir/-/fdir-6.5.0.tgz", + "integrity": "sha512-tIbYtZbucOs0BRGqPJkshJUYdL+SDH7dVM8gjy+ERp3WAUjLEFJE+02kanyHtwjWOnwrKYBiwAmM0p4kLJAnXg==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=12.0.0" + }, + "peerDependencies": { + "picomatch": "^3 || ^4" + }, + "peerDependenciesMeta": { + "picomatch": { + "optional": true + } + } + }, + "node_modules/fsevents": { + "version": "2.3.3", + "resolved": "https://registry.npmjs.org/fsevents/-/fsevents-2.3.3.tgz", + "integrity": "sha512-5xoDfX+fL7faATnagmWPpbFtwh/R77WmMMqqHGS65C3vvB0YHrgF+B1YmZ3441tMj5n63k0212XNoJwzlhffQw==", + "dev": true, + "hasInstallScript": true, + "license": "MIT", + "optional": true, + "os": [ + "darwin" + ], + "engines": { + "node": "^8.16.0 || ^10.6.0 || >=11.0.0" + } + }, + "node_modules/get-caller-file": { + "version": "2.0.5", + "resolved": "https://registry.npmjs.org/get-caller-file/-/get-caller-file-2.0.5.tgz", + "integrity": "sha512-DyFP3BM/3YHTQOCUL/w0OZHR0lpKeGrxotcHWcqNEdnltqFwXVfhEBQ94eIo34AfQpo0rGki4cyIiftY06h2Fg==", + "dev": true, + "license": "ISC", + "engines": { + "node": "6.* || 8.* || >= 10.*" + } + }, + "node_modules/get-east-asian-width": { + "version": "1.7.0", + "resolved": "https://registry.npmjs.org/get-east-asian-width/-/get-east-asian-width-1.7.0.tgz", + "integrity": "sha512-XjH1AECxf0giL2V1aU8vKyRR2ppRUb5c0EvT7zuJTokQ74bNo52zOtghqdWIqrhUD79fo3x0WfKZdOqxF6LG1Q==", + "devOptional": true, + "license": "MIT", + "engines": { + "node": ">=18" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/graceful-fs": { + "version": "4.2.12", + "resolved": "https://registry.npmjs.org/graceful-fs/-/graceful-fs-4.2.12.tgz", + "integrity": "sha512-iuyGF2E4oafQfPsRrG2wtY2ILupMhvtdrhzrxB+0VcjsPpSPttpfYdjnGFGsTi5MaJFjI1jOKHPQ6UTbTj9TAw==", + "dev": true, + "license": "BlueOak-1.0.0" + }, + "node_modules/hls.js": { + "version": "1.7.4", + "resolved": "https://registry.npmjs.org/hls.js/-/hls.js-1.7.4.tgz", + "integrity": "sha512-3GlxGdPvT2YHvQYOt+yOzT/DEior/qJVNIylHA77kgeoBTdQQqi70GwefNEUmHQeNGyjC8U62+bruqW/Tpm+tg==", + "license": "Apache-2.0" + }, + "node_modules/indent-string": { + "version": "5.0.0", + "resolved": "https://registry.npmjs.org/indent-string/-/indent-string-5.0.0.tgz", + "integrity": "sha512-m6FAo/spmsW2Ab2fU35JTYwtOKa2yAwXSwgjSv1TJzh4Mh7mC3lzAOVLBprb72XsTrgkEIsl7YrFNAiDiRhIGg==", + "license": "MIT", + "optional": true, + "engines": { + "node": ">=12" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/ink": { + "version": "7.1.1", + "resolved": "https://registry.npmjs.org/ink/-/ink-7.1.1.tgz", + "integrity": "sha512-Y43xxa1ZSPvpmfLHcN5o+OdP8Rf8ykkNJEuKYOUNZKT8wXVNLFTtEm1nSDMQkfBH+YANF4Xuu0hhZ4ejqAtN2w==", + "license": "MIT", + "optional": true, + "dependencies": { + "@alcalzone/ansi-tokenize": "^0.3.0", + "ansi-escapes": "^7.3.0", + "ansi-styles": "^6.2.3", + "auto-bind": "^5.0.1", + "chalk": "^5.6.2", + "cli-boxes": "^4.0.1", + "cli-cursor": "^4.0.0", + "cli-truncate": "^6.0.0", + "code-excerpt": "^4.0.0", + "es-toolkit": "^1.45.1", + "indent-string": "^5.0.0", + "is-in-ci": "^2.0.0", + "patch-console": "^2.0.0", + "react-reconciler": "^0.33.0", + "scheduler": "^0.27.0", + "signal-exit": "^3.0.7", + "slice-ansi": "^9.0.0", + "stack-utils": "^2.0.6", + "string-width": "^8.2.0", + "terminal-size": "^4.0.1", + "type-fest": "^5.5.0", + "widest-line": "^6.0.0", + "wrap-ansi": "^10.0.0", + "ws": "^8.20.0", + "yoga-layout": "~3.2.1" + }, + "engines": { + "node": ">=22" + }, + "peerDependencies": { + "@types/react": ">=19.2.0", + "react": ">=19.2.0", + "react-devtools-core": ">=6.1.2" + }, + "peerDependenciesMeta": { + "@types/react": { + "optional": true + }, + "react-devtools-core": { + "optional": true + } + } + }, + "node_modules/ink/node_modules/ansi-styles": { + "version": "6.2.3", + "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-6.2.3.tgz", + "integrity": "sha512-4Dj6M28JB+oAH8kFkTLUo+a2jwOFkuqb3yucU0CANcRRUbxS0cP0nZYCGjcc3BNXwRIsUVmDGgzawme7zvJHvg==", + "license": "MIT", + "optional": true, + "engines": { + "node": ">=12" + }, + "funding": { + "url": "https://github.com/chalk/ansi-styles?sponsor=1" + } + }, + "node_modules/is-fullwidth-code-point": { + "version": "5.1.0", + "resolved": "https://registry.npmjs.org/is-fullwidth-code-point/-/is-fullwidth-code-point-5.1.0.tgz", + "integrity": "sha512-5XHYaSyiqADb4RnZ1Bdad6cPp8Toise4TzEjcOYDHZkTCbKgiUl7WTUCpNWHuxmDt91wnsZBc9xinNzopv3JMQ==", + "license": "MIT", + "optional": true, + "dependencies": { + "get-east-asian-width": "^1.3.1" + }, + "engines": { + "node": ">=18" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/is-in-ci": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/is-in-ci/-/is-in-ci-2.0.0.tgz", + "integrity": "sha512-cFeerHriAnhrQSbpAxL37W1wcJKUUX07HyLWZCW1URJT/ra3GyUTzBgUnh24TMVfNTV2Hij2HLxkPHFZfOZy5w==", + "license": "MIT", + "optional": true, + "bin": { + "is-in-ci": "cli.js" + }, + "engines": { + "node": ">=20" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/jiti": { + "version": "2.7.0", + "resolved": "https://registry.npmjs.org/jiti/-/jiti-2.7.0.tgz", + "integrity": "sha512-AC/7JofJvZGrrneWNaEnJeOLUx+JlGt7tNa0wZiRPT4MY1wmfKjt2+6O2p2uz2+skll8OZZmJMNqeke7kKbNgQ==", + "dev": true, + "license": "MIT", + "bin": { + "jiti": "lib/jiti-cli.mjs" + } + }, + "node_modules/laravel-vite-plugin": { + "version": "3.2.1", + "resolved": "https://registry.npmjs.org/laravel-vite-plugin/-/laravel-vite-plugin-3.2.1.tgz", + "integrity": "sha512-VqWn6U4YC1zRYVDlR/hu7JHesXqwj+DsEBSlVAe7al1MlAE5aYslyuyYV7v47DCGLGKJZxfbaZnApsIHdYIBJA==", + "dev": true, + "license": "MIT", + "dependencies": { + "picocolors": "^1.0.0", + "tinyglobby": "^0.2.12", + "vite-plugin-full-reload": "^1.1.0" + }, + "bin": { + "clean-orphaned-assets": "bin/clean.js" + }, + "engines": { + "node": "^20.19.0 || >=22.12.0" + }, + "peerDependencies": { + "fontaine": "^0.8.0 || ^1.0.0", + "vite": "^8.0.0" + }, + "peerDependenciesMeta": { + "fontaine": { + "optional": true + } + } + }, + "node_modules/lightningcss": { + "version": "1.33.0", + "resolved": "https://registry.npmjs.org/lightningcss/-/lightningcss-1.33.0.tgz", + "integrity": "sha512-WkUDrojuJs0xkgGf2udWxa3yGBRxPtxUkB79i6aCZLRgc7PM8fZe9TosfPDcvEpQZbuFASnHYmRLBLUbmLOIIA==", + "dev": true, + "license": "MPL-2.0", + "dependencies": { + "detect-libc": "^2.0.3" + }, + "engines": { + "node": ">= 12.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/parcel" + }, + "optionalDependencies": { + "lightningcss-android-arm64": "1.33.0", + "lightningcss-darwin-arm64": "1.33.0", + "lightningcss-darwin-x64": "1.33.0", + "lightningcss-freebsd-x64": "1.33.0", + "lightningcss-linux-arm-gnueabihf": "1.33.0", + "lightningcss-linux-arm64-gnu": "1.33.0", + "lightningcss-linux-arm64-musl": "1.33.0", + "lightningcss-linux-x64-gnu": "1.33.0", + "lightningcss-linux-x64-musl": "1.33.0", + "lightningcss-win32-arm64-msvc": "1.33.0", + "lightningcss-win32-x64-msvc": "1.33.0" + } + }, + "node_modules/lightningcss-android-arm64": { + "version": "1.33.0", + "resolved": "https://registry.npmjs.org/lightningcss-android-arm64/-/lightningcss-android-arm64-1.33.0.tgz", + "integrity": "sha512-gEpRTalKdosp4Bb8qWtc2iOgE5SeIHlpS1up9bFq2wAyYhl1UdTObYiHe98zEM9SQvSoqQZ1IQD0JNpg3Ml5pg==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MPL-2.0", + "optional": true, + "os": [ + "android" + ], + "engines": { + "node": ">= 12.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/parcel" + } + }, + "node_modules/lightningcss-darwin-arm64": { + "version": "1.33.0", + "resolved": "https://registry.npmjs.org/lightningcss-darwin-arm64/-/lightningcss-darwin-arm64-1.33.0.tgz", + "integrity": "sha512-Sciaz8eenNTKn9b3t7+xr0ipTp9YxKQY4npwQ3mrRuL0BAVHBLyZxofhaKBAVtzmtRZ/zTyo0/to4B1uWG/Djg==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MPL-2.0", + "optional": true, + "os": [ + "darwin" + ], + "engines": { + "node": ">= 12.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/parcel" + } + }, + "node_modules/lightningcss-darwin-x64": { + "version": "1.33.0", + "resolved": "https://registry.npmjs.org/lightningcss-darwin-x64/-/lightningcss-darwin-x64-1.33.0.tgz", + "integrity": "sha512-Z5UPAxzrjlWNNyGy6i65cJzzvgJ5D3T6wMvs+gWpY9d7qRhANrxqAp6LhxIgZhWEw18RfJTGcRxjuLIBr+m8XQ==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MPL-2.0", + "optional": true, + "os": [ + "darwin" + ], + "engines": { + "node": ">= 12.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/parcel" + } + }, + "node_modules/lightningcss-freebsd-x64": { + "version": "1.33.0", + "resolved": "https://registry.npmjs.org/lightningcss-freebsd-x64/-/lightningcss-freebsd-x64-1.33.0.tgz", + "integrity": "sha512-QQM/Ti/hQajJwCY+RiWuCZ9sdtI/XQk7nDK5vC8kkdwixezOlDgvDx7+RT+QjK6FcFT4MpsuoBnHIo/O3StRRg==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MPL-2.0", + "optional": true, + "os": [ + "freebsd" + ], + "engines": { + "node": ">= 12.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/parcel" + } + }, + "node_modules/lightningcss-linux-arm-gnueabihf": { + "version": "1.33.0", + "resolved": "https://registry.npmjs.org/lightningcss-linux-arm-gnueabihf/-/lightningcss-linux-arm-gnueabihf-1.33.0.tgz", + "integrity": "sha512-N7FVBe6iS24MlM6R/4RBTxGhQheZGs7tiQ9U32UtF75NzP5Q7xWPRqLBCKxlRQRk3rY1jCIPLzx7WzOhuUIRLQ==", + "cpu": [ + "arm" + ], + "dev": true, + "license": "MPL-2.0", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">= 12.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/parcel" + } + }, + "node_modules/lightningcss-linux-arm64-gnu": { + "version": "1.33.0", + "resolved": "https://registry.npmjs.org/lightningcss-linux-arm64-gnu/-/lightningcss-linux-arm64-gnu-1.33.0.tgz", + "integrity": "sha512-j2v/itmy4HlNxlc6voKXYgBqNi0Ng2LShg4z7GufpEgs05P+2suBVyi9I6YHq5uoVFx9ETin3eCEhLVyXGQnKg==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MPL-2.0", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">= 12.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/parcel" + } + }, + "node_modules/lightningcss-linux-arm64-musl": { + "version": "1.33.0", + "resolved": "https://registry.npmjs.org/lightningcss-linux-arm64-musl/-/lightningcss-linux-arm64-musl-1.33.0.tgz", + "integrity": "sha512-yiO5ROMuYQgXbC60yjZU5CYSFZGKXL0HFATXt9mHJn1+zW55oCtMI9NfcVhYLMFDL7gV7oBPon/EmMMGg2OvtQ==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MPL-2.0", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">= 12.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/parcel" + } + }, + "node_modules/lightningcss-linux-x64-gnu": { + "version": "1.33.0", + "resolved": "https://registry.npmjs.org/lightningcss-linux-x64-gnu/-/lightningcss-linux-x64-gnu-1.33.0.tgz", + "integrity": "sha512-ar+Ju7LmcN0Jo4FpL4hpFybwNG9/3A/Br5KW2n2jyODg3MEZXaDYADdemoNS+BDNfMgKvylJLj4S5tyRActuAg==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MPL-2.0", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">= 12.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/parcel" + } + }, + "node_modules/lightningcss-linux-x64-musl": { + "version": "1.33.0", + "resolved": "https://registry.npmjs.org/lightningcss-linux-x64-musl/-/lightningcss-linux-x64-musl-1.33.0.tgz", + "integrity": "sha512-RYiYbkokw0trfKqqzfF55lginwEPrD3OJDfTuJzFs1MK6iFnDenaz1fqLLtX4ITG3OktJQXOeTaw1awrBAlZPw==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MPL-2.0", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">= 12.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/parcel" + } + }, + "node_modules/lightningcss-win32-arm64-msvc": { + "version": "1.33.0", + "resolved": "https://registry.npmjs.org/lightningcss-win32-arm64-msvc/-/lightningcss-win32-arm64-msvc-1.33.0.tgz", + "integrity": "sha512-1K+MPfLSFVpphzpdbfkhlWk6wBrTObBzS2T6db10PNOZgR9GoVsAWzwNyuhUYYbTp23j+4RrncfujZ4uAzXvwA==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MPL-2.0", + "optional": true, + "os": [ + "win32" + ], + "engines": { + "node": ">= 12.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/parcel" + } + }, + "node_modules/lightningcss-win32-x64-msvc": { + "version": "1.33.0", + "resolved": "https://registry.npmjs.org/lightningcss-win32-x64-msvc/-/lightningcss-win32-x64-msvc-1.33.0.tgz", + "integrity": "sha512-OlEICDx/Xl0FqSp4bry8zFnCvGpig3Gl4gCquvYwHuqJKEC1+n9NgDniFvqHGmMv1ZkqDJrDqKKSykTDX+ehuA==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MPL-2.0", + "optional": true, + "os": [ + "win32" + ], + "engines": { + "node": ">= 12.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/parcel" + } + }, + "node_modules/magic-string": { + "version": "1.4.5", + "resolved": "https://registry.npmjs.org/magic-string/-/magic-string-1.4.5.tgz", + "integrity": "sha512-oLLC2+YvQUfAa+vxoufE/yc1icb87M9iXIRqAoR/2EhE/8cb3SF/+Gi0c2By1B+5Vz2e2vQtUvHiu1+63Znh+w==", + "dev": true, + "license": "MIT", + "dependencies": { + "@jridgewell/sourcemap-codec": "^1.6.0" + } + }, + "node_modules/mimic-fn": { + "version": "2.1.0", + "resolved": "https://registry.npmjs.org/mimic-fn/-/mimic-fn-2.1.0.tgz", + "integrity": "sha512-OqbOk5oEQeAZ8WXWydlu9HJjz9WVdEIvamMCcXmuqUYjTknH/sqsWvhQ3vgwKFRR1HpjvNBKQ37nbJgYzGqGcg==", + "license": "MIT", + "optional": true, + "engines": { + "node": ">=6" + } + }, + "node_modules/nanoid": { + "version": "3.3.20", + "resolved": "https://registry.npmjs.org/nanoid/-/nanoid-3.3.20.tgz", + "integrity": "sha512-uKdg2G3GNCKQn9byYOpxbGqrT2fGO5KRt5J/8b3pok8rT6qxGWF6hxMyJiEYtAf+FVyYuD9hRaDqX5uPFYJ4ZQ==", + "dev": true, + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/ai" + } + ], + "license": "MIT", + "bin": { + "nanoid": "bin/nanoid.cjs" + }, + "engines": { + "node": "^10 || ^12 || ^13.7 || ^14 || >=15.0.1" + } + }, + "node_modules/onetime": { + "version": "5.1.2", + "resolved": "https://registry.npmjs.org/onetime/-/onetime-5.1.2.tgz", + "integrity": "sha512-kbpaSSGJTWdAY5KPVeMOKXSrPtr8C8C7wodJbcsd51jRnmD+GZu8Y0VoU6Dm5Z4vWr0Ig/1NKuWRKf7j5aaYSg==", + "license": "MIT", + "optional": true, + "dependencies": { + "mimic-fn": "^2.1.0" + }, + "engines": { + "node": ">=6" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/patch-console": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/patch-console/-/patch-console-2.0.0.tgz", + "integrity": "sha512-0YNdUceMdaQwoKce1gatDScmMo5pu/tfABfnzEqeG0gtTmd7mh/WcwgUjtAeOU7N8nFFlbQBnFK2gXW5fGvmMA==", + "license": "MIT", + "optional": true, + "engines": { + "node": "^12.20.0 || ^14.13.1 || >=16.0.0" + } + }, + "node_modules/picocolors": { + "version": "1.1.1", + "resolved": "https://registry.npmjs.org/picocolors/-/picocolors-1.1.1.tgz", + "integrity": "sha512-xceH2snhtb5M9liqDsmEw56le376mTZkEX/jEb/RxNFyegNul7eNslCXP9FDj/Lcu0X8KEyMceP2ntpaHrDEVA==", + "dev": true, + "license": "ISC" + }, + "node_modules/picomatch": { + "version": "4.0.7", + "resolved": "https://registry.npmjs.org/picomatch/-/picomatch-4.0.7.tgz", + "integrity": "sha512-qcJu88Q2IWqJsDD529JKMdwGm/dvInW4HvQnRwiH9JtihJvzGOscDtHE3x1pBKeUOTysQ8kVmLnJ2kJu7yhcGA==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=12" + }, + "funding": { + "url": "https://github.com/sponsors/jonschlinkert" + } + }, + "node_modules/postcss": { + "version": "8.5.33", + "resolved": "https://registry.npmjs.org/postcss/-/postcss-8.5.33.tgz", + "integrity": "sha512-RVHEU9/Pp1Fnjr/MpAJsZoADukCKhfIi15OunEYiGktIkYLkPVvC1sioWolGDS7XByMTx9m/IGbro0Js13zhnQ==", + "dev": true, + "funding": [ + { + "type": "opencollective", + "url": "https://opencollective.com/postcss/" + }, + { + "type": "tidelift", + "url": "https://tidelift.com/funding/github/npm/postcss" + }, + { + "type": "github", + "url": "https://github.com/sponsors/ai" + } + ], + "license": "MIT", + "dependencies": { + "nanoid": "^3.3.20", + "picocolors": "^1.1.1", + "source-map-js": "^1.2.2" + }, + "engines": { + "node": "^10 || ^12 || >=14" + } + }, + "node_modules/react": { + "version": "19.3.1", + "resolved": "https://registry.npmjs.org/react/-/react-19.3.1.tgz", + "integrity": "sha512-QNhWdt7nrgVWWQG58QuGsAR3jv3Hbe4mb4vz7w2csnHavciZJgda1CPNaldF6eVxv90ud3jUXpKlHL69gO38yw==", + "license": "MIT", + "optional": true, + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/react-reconciler": { + "version": "0.33.0", + "resolved": "https://registry.npmjs.org/react-reconciler/-/react-reconciler-0.33.0.tgz", + "integrity": "sha512-KetWRytFv1epdpJc3J4G75I4WrplZE5jOL7Yq0p34+OVOKF4Se7WrdIdVC45XsSSmUTlht2FM/fM1FZb1mfQeA==", + "license": "MIT", + "optional": true, + "dependencies": { + "scheduler": "^0.27.0" + }, + "engines": { + "node": ">=0.10.0" + }, + "peerDependencies": { + "react": "^19.2.0" + } + }, + "node_modules/restore-cursor": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/restore-cursor/-/restore-cursor-4.0.0.tgz", + "integrity": "sha512-I9fPXU9geO9bHOt9pHHOhOkYerIMsmVaWB0rA2AI9ERh/+x/i7MV5HKBNrg+ljO5eoPVgCcnFuRjJ9uH6I/3eg==", + "license": "MIT", + "optional": true, + "dependencies": { + "onetime": "^5.1.0", + "signal-exit": "^3.0.2" + }, + "engines": { + "node": "^12.20.0 || ^14.13.1 || >=16.0.0" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/rolldown": { + "version": "1.2.19", + "resolved": "https://registry.npmjs.org/rolldown/-/rolldown-1.2.19.tgz", + "integrity": "sha512-QIiV1J9d0pzN4jeeTH4sjPy0AZ6cAy2cG0ExeoE1+U8Rvj+hR3gYkokx0YbeUNGlZqiQJJ2utcETe0oKXwzsuA==", + "dev": true, + "license": "MIT", + "dependencies": { + "@oxc-project/types": "=0.156.0", + "@rolldown/pluginutils": "^1.0.0" + }, + "bin": { + "rolldown": "bin/cli.mjs" + }, + "engines": { + "node": "^20.19.0 || >=22.12.0" + }, + "optionalDependencies": { + "@rolldown/binding-android-arm-eabi": "1.2.19", + "@rolldown/binding-android-arm64": "1.2.19", + "@rolldown/binding-darwin-arm64": "1.2.19", + "@rolldown/binding-darwin-x64": "1.2.19", + "@rolldown/binding-freebsd-x64": "1.2.19", + "@rolldown/binding-linux-arm-gnueabihf": "1.2.19", + "@rolldown/binding-linux-arm64-gnu": "1.2.19", + "@rolldown/binding-linux-arm64-musl": "1.2.19", + "@rolldown/binding-linux-ppc64-gnu": "1.2.19", + "@rolldown/binding-linux-s390x-gnu": "1.2.19", + "@rolldown/binding-linux-x64-gnu": "1.2.19", + "@rolldown/binding-linux-x64-musl": "1.2.19", + "@rolldown/binding-openharmony-arm64": "1.2.19", + "@rolldown/binding-wasm32-wasi": "1.2.19", + "@rolldown/binding-win32-arm64-msvc": "1.2.19", + "@rolldown/binding-win32-x64-msvc": "1.2.19" + } + }, + "node_modules/rxjs": { + "version": "7.8.2", + "resolved": "https://registry.npmjs.org/rxjs/-/rxjs-7.8.2.tgz", + "integrity": "sha512-dhKf903U/PQZY6boNNtAGdWbG85WAbjT/1xYoZIC7FAY0yWapOBQVsVrDl58W86//e1VpMNBtRV4MaXfdMySFA==", + "dev": true, + "license": "Apache-2.0", + "dependencies": { + "tslib": "^2.1.0" + } + }, + "node_modules/scheduler": { + "version": "0.27.0", + "resolved": "https://registry.npmjs.org/scheduler/-/scheduler-0.27.0.tgz", + "integrity": "sha512-eNv+WrVbKu1f3vbYJT/xtiF5syA5HPIMtf9IgY/nKg0sWqzAUEvqY/xm7OcZc/qafLx/iO9FgOmeSAp4v5ti/Q==", + "license": "MIT", + "optional": true + }, + "node_modules/shell-quote": { + "version": "1.12.0", + "resolved": "https://registry.npmjs.org/shell-quote/-/shell-quote-1.12.0.tgz", + "integrity": "sha512-PcByqNyT/38F2kDNi006HAMRJaULuBzq/FOsw3qdZvX/GA9W/jamDaRskgHjubHiftXK5sIFxLNkvrXUwcof6Q==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/signal-exit": { + "version": "3.0.7", + "resolved": "https://registry.npmjs.org/signal-exit/-/signal-exit-3.0.7.tgz", + "integrity": "sha512-wnD2ZE+l+SPC/uoS0vXeE9L1+0wuaMqKlfz9AMUo38JsyLSBWSFcHR1Rri62LZc12vLr1gb3jl7iwQhgwpAbGQ==", + "license": "ISC", + "optional": true + }, + "node_modules/slice-ansi": { + "version": "9.0.1", + "resolved": "https://registry.npmjs.org/slice-ansi/-/slice-ansi-9.0.1.tgz", + "integrity": "sha512-aBY19bn/XA+hKOKX0qL7Z0UfdBsbQvc9hn993U8ALUjzxCvDcuZqLoRXjGJrUARWAlwMnsRVD9sw2AFNOYvalA==", + "license": "MIT", + "optional": true, + "dependencies": { + "ansi-styles": "^6.2.3", + "is-fullwidth-code-point": "^5.1.0" + }, + "engines": { + "node": ">=22" + }, + "funding": { + "url": "https://github.com/chalk/slice-ansi?sponsor=1" + } + }, + "node_modules/slice-ansi/node_modules/ansi-styles": { + "version": "6.2.3", + "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-6.2.3.tgz", + "integrity": "sha512-4Dj6M28JB+oAH8kFkTLUo+a2jwOFkuqb3yucU0CANcRRUbxS0cP0nZYCGjcc3BNXwRIsUVmDGgzawme7zvJHvg==", + "license": "MIT", + "optional": true, + "engines": { + "node": ">=12" + }, + "funding": { + "url": "https://github.com/chalk/ansi-styles?sponsor=1" + } + }, + "node_modules/source-map-js": { + "version": "1.2.2", + "resolved": "https://registry.npmjs.org/source-map-js/-/source-map-js-1.2.2.tgz", + "integrity": "sha512-KGj/8Y43x35aZVDtt+J4mK1hoLGHULMYfSkODJNQjNDC3oW1PqPoxMwo0pLUsWM/UEGzON/NxeHywEfNXNP3Vw==", + "dev": true, + "license": "BSD-3-Clause", + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/stack-utils": { + "version": "2.0.6", + "resolved": "https://registry.npmjs.org/stack-utils/-/stack-utils-2.0.6.tgz", + "integrity": "sha512-XlkWvfIm6RmsWtNJx+uqtKLS8eqFbxUg0ZzLXqY0caEy9l7hruX8IpiDnjsLavoBgqCCR71TqWO8MaXYheJ3RQ==", + "license": "MIT", + "optional": true, + "dependencies": { + "escape-string-regexp": "^2.0.0" + }, + "engines": { + "node": ">=10" + } + }, + "node_modules/string-width": { + "version": "8.3.0", + "resolved": "https://registry.npmjs.org/string-width/-/string-width-8.3.0.tgz", + "integrity": "sha512-ZbmZM0JCihQN91dWnxoipT2KOEyHqEyfRXUyjuRhW8b/xnqPDoq4gWEVApTVa9db2wN8mmoikgFBbjh71+cGeQ==", + "license": "MIT", + "optional": true, + "dependencies": { + "get-east-asian-width": "^1.5.0", + "strip-ansi": "^7.1.2" + }, + "engines": { + "node": ">=20" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/strip-ansi": { + "version": "7.2.0", + "resolved": "https://registry.npmjs.org/strip-ansi/-/strip-ansi-7.2.0.tgz", + "integrity": "sha512-yDPMNjp4WyfYBkHnjIRLfca1i6KMyGCtsVgoKe/z1+6vukgaENdgGBZt+ZmKPc4gavvEZ5OgHfHdrazhgNyG7w==", + "devOptional": true, + "license": "MIT", + "dependencies": { + "ansi-regex": "^6.2.2" + }, + "engines": { + "node": ">=12" + }, + "funding": { + "url": "https://github.com/chalk/strip-ansi?sponsor=1" + } + }, + "node_modules/supports-color": { + "version": "10.2.2", + "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-10.2.2.tgz", + "integrity": "sha512-SS+jx45GF1QjgEXQx4NJZV9ImqmO2NPz5FNsIHrsDjh2YsHnawpan7SNQ1o8NuhrbHZy9AZhIoCUiCeaW/C80g==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=18" + }, + "funding": { + "url": "https://github.com/chalk/supports-color?sponsor=1" + } + }, + "node_modules/tagged-tag": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/tagged-tag/-/tagged-tag-1.0.0.tgz", + "integrity": "sha512-yEFYrVhod+hdNyx7g5Bnkkb0G6si8HJurOoOEgC8B/O0uXLHlaey/65KRv6cuWBNhBgHKAROVpc7QyYqE5gFng==", + "license": "MIT", + "optional": true, + "engines": { + "node": ">=20" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/tailwindcss": { + "version": "4.3.5", + "resolved": "https://registry.npmjs.org/tailwindcss/-/tailwindcss-4.3.5.tgz", + "integrity": "sha512-FcQk9BuffmEHJP2G0XmB2SplU1aLTI7j07Kunk+U74Ny+XiWOtzXz9aujFZ/avntw1e2cOv/3PkgzflQ7gX2vQ==", + "dev": true, + "license": "MIT" + }, + "node_modules/tapable": { + "version": "2.3.4", + "resolved": "https://registry.npmjs.org/tapable/-/tapable-2.3.4.tgz", + "integrity": "sha512-NHFiWnAbMJxNNpBwiO7jJVGDuqMxT9/oV8v57RR+fgBQShkJil5inGD8/xWy0hjLyHQyX1tu27QANhlz3KBqCg==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=6" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/webpack" + } + }, + "node_modules/terminal-size": { + "version": "4.0.1", + "resolved": "https://registry.npmjs.org/terminal-size/-/terminal-size-4.0.1.tgz", + "integrity": "sha512-avMLDQpUI9I5XFrklECw1ZEUPJhqzcwSWsyyI8blhRLT+8N1jLJWLWWYQpB2q2xthq8xDvjZPISVh53T/+CLYQ==", + "license": "MIT", + "optional": true, + "engines": { + "node": ">=18" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/tinyglobby": { + "version": "0.2.17", + "resolved": "https://registry.npmjs.org/tinyglobby/-/tinyglobby-0.2.17.tgz", + "integrity": "sha512-wXR/dYpcqKmfWpEdZjiKJOwCNFndD0DMnrW/cYjVGttEkBfVgcLFHoNrlj47mjOVic9yyNu65alsgF4NQyTa2g==", + "dev": true, + "license": "MIT", + "dependencies": { + "fdir": "^6.5.0", + "picomatch": "^4.0.4" + }, + "engines": { + "node": ">=12.0.0" + }, + "funding": { + "url": "https://github.com/sponsors/SuperchupuDev" + } + }, + "node_modules/tree-kill": { + "version": "1.2.2", + "resolved": "https://registry.npmjs.org/tree-kill/-/tree-kill-1.2.2.tgz", + "integrity": "sha512-L0Orpi8qGpRG//Nd+H90vFB+3iHnue1zSSGmNOOCh1GLJ7rUKVwV2HvijphGQS2UmhUZewS9VgvxYIdgr+fG1A==", + "dev": true, + "license": "MIT", + "bin": { + "tree-kill": "cli.js" + } + }, + "node_modules/tslib": { + "version": "2.9.1", + "resolved": "https://registry.npmjs.org/tslib/-/tslib-2.9.1.tgz", + "integrity": "sha512-a4Ux9VKuIMHsOS7ENbEq6hK2ZGYIT27Rtl0E4eD9KqwxhKiQeMZE/9xb3IdYwWaSOyIBQLExhQgXDTYoiCxnWA==", + "dev": true, + "license": "0BSD" + }, + "node_modules/type-fest": { + "version": "5.10.0", + "resolved": "https://registry.npmjs.org/type-fest/-/type-fest-5.10.0.tgz", + "integrity": "sha512-NoSdpq/WEiAg5sjmBkmV/hfxv6HJH4NqPNrqjtSO5CwRmpsDfaf4begxW34KdJykH/l1yHtwBWQkCRdoXO8mPA==", + "license": "(MIT OR CC0-1.0)", + "optional": true, + "dependencies": { + "tagged-tag": "^1.0.0" + }, + "engines": { + "node": ">=20" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/vite": { + "version": "8.3.8", + "resolved": "https://registry.npmjs.org/vite/-/vite-8.3.8.tgz", + "integrity": "sha512-LzOn3h9rG/0vhLdXrV4yJ4QFA9eEoqCl+Yx+kGJd7aB9w6nfNgVHKSYwLPZUHrz4ZGa+t+kXjV9itvcHDLQouA==", + "dev": true, + "license": "MIT", + "dependencies": { + "lightningcss": "^1.33.0", + "picomatch": "^4.0.7", + "postcss": "^8.5.32", + "rolldown": "~1.2.18", + "tinyglobby": "^0.2.17" + }, + "bin": { + "vite": "bin/vite.js" + }, + "engines": { + "node": "^20.19.0 || >=22.12.0" + }, + "funding": { + "url": "https://github.com/vitejs/vite?sponsor=1" + }, + "optionalDependencies": { + "fsevents": "~2.3.3" + }, + "peerDependencies": { + "@types/node": "^20.19.0 || >=22.12.0", + "@vitejs/devtools": "^0.7.1 || ^0.8.0", + "esbuild": "^0.27.0 || ^0.28.0", + "jiti": ">=1.21.0", + "less": "^4.0.0", + "sass": "^1.70.0", + "sass-embedded": "^1.70.0", + "stylus": ">=0.54.8", + "sugarss": "^5.0.0", + "terser": "^5.16.0", + "tsx": "^4.8.1", + "yaml": "^2.4.2" + }, + "peerDependenciesMeta": { + "@types/node": { + "optional": true + }, + "@vitejs/devtools": { + "optional": true + }, + "esbuild": { + "optional": true + }, + "jiti": { + "optional": true + }, + "less": { + "optional": true + }, + "sass": { + "optional": true + }, + "sass-embedded": { + "optional": true + }, + "stylus": { + "optional": true + }, + "sugarss": { + "optional": true + }, + "terser": { + "optional": true + }, + "tsx": { + "optional": true + }, + "yaml": { + "optional": true + } + } + }, + "node_modules/vite-plugin-full-reload": { + "version": "1.2.0", + "resolved": "https://registry.npmjs.org/vite-plugin-full-reload/-/vite-plugin-full-reload-1.2.0.tgz", + "integrity": "sha512-kz18NW79x0IHbxRSHm0jttP4zoO9P9gXh+n6UTwlNKnviTTEpOlum6oS9SmecrTtSr+muHEn5TUuC75UovQzcA==", + "dev": true, + "license": "MIT", + "dependencies": { + "picocolors": "^1.0.0", + "picomatch": "^2.3.1" + } + }, + "node_modules/vite-plugin-full-reload/node_modules/picomatch": { + "version": "2.3.2", + "resolved": "https://registry.npmjs.org/picomatch/-/picomatch-2.3.2.tgz", + "integrity": "sha512-V7+vQEJ06Z+c5tSye8S+nHUfI51xoXIXjHQ99cQtKUkQqqO1kO/KCJUfZXuB47h/YBlDhah2H3hdUGXn8ie0oA==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=8.6" + }, + "funding": { + "url": "https://github.com/sponsors/jonschlinkert" + } + }, + "node_modules/widest-line": { + "version": "6.0.0", + "resolved": "https://registry.npmjs.org/widest-line/-/widest-line-6.0.0.tgz", + "integrity": "sha512-U89AsyEeAsyoF0zVJBkG9zBgekjgjK7yk9sje3F4IQpXBJ10TF6ByLlIfjMhcmHMJgHZI4KHt4rdNfktzxIAMA==", + "license": "MIT", + "optional": true, + "dependencies": { + "string-width": "^8.1.0" + }, + "engines": { + "node": ">=20" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/wrap-ansi": { + "version": "10.0.2", + "resolved": "https://registry.npmjs.org/wrap-ansi/-/wrap-ansi-10.0.2.tgz", + "integrity": "sha512-6OLRNZqRntVGBm26ghZ5eZhCuWWyOkRCSn8XsOIuq5stpCE/tjLbdozd93naILZig0lmD8ANfRwnhn0DLeXGlg==", + "license": "MIT", + "optional": true, + "dependencies": { + "ansi-styles": "^6.2.3", + "string-width": "^8.2.0" + }, + "engines": { + "node": ">=20" + }, + "funding": { + "url": "https://github.com/chalk/wrap-ansi?sponsor=1" + } + }, + "node_modules/wrap-ansi/node_modules/ansi-styles": { + "version": "6.2.3", + "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-6.2.3.tgz", + "integrity": "sha512-4Dj6M28JB+oAH8kFkTLUo+a2jwOFkuqb3yucU0CANcRRUbxS0cP0nZYCGjcc3BNXwRIsUVmDGgzawme7zvJHvg==", + "license": "MIT", + "optional": true, + "engines": { + "node": ">=12" + }, + "funding": { + "url": "https://github.com/chalk/ansi-styles?sponsor=1" + } + }, + "node_modules/ws": { + "version": "8.23.0", + "resolved": "https://registry.npmjs.org/ws/-/ws-8.23.0.tgz", + "integrity": "sha512-wCkmX8QMOrKjgO8HW2WyDbTSGeqkocxgDzS9iR79rEAexty6/2qzilx3Ag8Tqf9ykop3irLKle0MtVn5qjVnoQ==", + "license": "MIT", + "optional": true, + "engines": { + "node": ">=10.0.0" + }, + "peerDependencies": { + "bufferutil": "^4.0.1", + "utf-8-validate": ">=5.0.2" + }, + "peerDependenciesMeta": { + "bufferutil": { + "optional": true + }, + "utf-8-validate": { + "optional": true + } + } + }, + "node_modules/y18n": { + "version": "5.0.8", + "resolved": "https://registry.npmjs.org/y18n/-/y18n-5.0.8.tgz", + "integrity": "sha512-0pfFzegeDWJHJIAmTLRP2DwHjdF5s7jo9tuztdQxAhINCdvS+3nGINqPd00AphqJR/0LhANUS6/+7SCb98YOfA==", + "dev": true, + "license": "ISC", + "engines": { + "node": ">=10" + } + }, + "node_modules/yargs": { + "version": "18.0.0", + "resolved": "https://registry.npmjs.org/yargs/-/yargs-18.0.0.tgz", + "integrity": "sha512-4UEqdc2RYGHZc7Doyqkrqiln3p9X2DZVxaGbwhn2pi7MrRagKaOcIKe8L3OxYcbhXLgLFUS3zAYuQjKBQgmuNg==", + "dev": true, + "license": "MIT", + "dependencies": { + "cliui": "^9.0.1", + "escalade": "^3.1.1", + "get-caller-file": "^2.0.5", + "string-width": "^7.2.0", + "y18n": "^5.0.5", + "yargs-parser": "^22.0.0" + }, + "engines": { + "node": "^20.19.0 || ^22.12.0 || >=23" + } + }, + "node_modules/yargs-parser": { + "version": "22.0.0", + "resolved": "https://registry.npmjs.org/yargs-parser/-/yargs-parser-22.0.0.tgz", + "integrity": "sha512-rwu/ClNdSMpkSrUb+d6BRsSkLUq1fmfsY6TOpYzTwvwkg1/NRG85KBy3kq++A8LKQwX6lsu+aWad+2khvuXrqw==", + "dev": true, + "license": "ISC", + "engines": { + "node": "^20.19.0 || ^22.12.0 || >=23" + } + }, + "node_modules/yargs/node_modules/string-width": { + "version": "7.2.0", + "resolved": "https://registry.npmjs.org/string-width/-/string-width-7.2.0.tgz", + "integrity": "sha512-tsaTIkKW9b4N+AEj+SVA+WhJzV7/zMhcSu78mLKWSk7cXMOSHsBKFWUs0fWwq8QyK3MgJBQRX6Gbi4kYbdvGkQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "emoji-regex": "^10.3.0", + "get-east-asian-width": "^1.0.0", + "strip-ansi": "^7.1.0" + }, + "engines": { + "node": ">=18" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/yoga-layout": { + "version": "3.2.1", + "resolved": "https://registry.npmjs.org/yoga-layout/-/yoga-layout-3.2.1.tgz", + "integrity": "sha512-0LPOt3AxKqMdFBZA3HBAt/t/8vIKq7VaQYbuA8WxCgung+p9TVyKRYdpvCb80HcdTN2NkbIKbhNwKUfm3tQywQ==", + "license": "MIT", + "optional": true + } + } +} diff --git a/package.json b/package.json new file mode 100644 index 0000000..1841ad6 --- /dev/null +++ b/package.json @@ -0,0 +1,22 @@ +{ + "$schema": "https://www.schemastore.org/package.json", + "private": true, + "type": "module", + "scripts": { + "build": "vite build", + "dev": "vite" + }, + "devDependencies": { + "@tailwindcss/vite": "^4.0.0", + "concurrently": "^10.0.3", + "laravel-vite-plugin": "^3.1", + "tailwindcss": "^4.0.0", + "vite": "^8.0.0" + }, + "optionalDependencies": { + "@laravel/multiplex": "^0.4.1" + }, + "dependencies": { + "hls.js": "^1.7.4" + } +} diff --git a/phpunit.xml b/phpunit.xml new file mode 100644 index 0000000..1ce3e4c --- /dev/null +++ b/phpunit.xml @@ -0,0 +1,39 @@ + + + + + tests/Unit + + + tests/Feature + + + + + app + + + + + + + + + + + + + + + + + + + + + diff --git a/public/.htaccess b/public/.htaccess new file mode 100644 index 0000000..b574a59 --- /dev/null +++ b/public/.htaccess @@ -0,0 +1,25 @@ + + + Options -MultiViews -Indexes + + + RewriteEngine On + + # Handle Authorization Header + RewriteCond %{HTTP:Authorization} . + RewriteRule .* - [E=HTTP_AUTHORIZATION:%{HTTP:Authorization}] + + # Handle X-XSRF-Token Header + RewriteCond %{HTTP:x-xsrf-token} . + RewriteRule .* - [E=HTTP_X_XSRF_TOKEN:%{HTTP:X-XSRF-Token}] + + # Redirect Trailing Slashes If Not A Folder... + RewriteCond %{REQUEST_FILENAME} !-d + RewriteCond %{REQUEST_URI} (.+)/$ + RewriteRule ^ %1 [L,R=301] + + # Send Requests To Front Controller... + RewriteCond %{REQUEST_FILENAME} !-d + RewriteCond %{REQUEST_FILENAME} !-f + RewriteRule ^ index.php [L] + diff --git a/public/favicon.ico b/public/favicon.ico new file mode 100644 index 0000000..e69de29 diff --git a/public/images/brand/lara-felix-logo-kompakt-128.webp b/public/images/brand/lara-felix-logo-kompakt-128.webp new file mode 100644 index 0000000..b5c142a Binary files /dev/null and b/public/images/brand/lara-felix-logo-kompakt-128.webp differ diff --git a/public/images/brand/lara-felix-logo-kompakt-256.webp b/public/images/brand/lara-felix-logo-kompakt-256.webp new file mode 100644 index 0000000..2e80eff Binary files /dev/null and b/public/images/brand/lara-felix-logo-kompakt-256.webp differ diff --git a/public/index.php b/public/index.php new file mode 100644 index 0000000..ee8f07e --- /dev/null +++ b/public/index.php @@ -0,0 +1,20 @@ +handleRequest(Request::capture()); diff --git a/public/robots.txt b/public/robots.txt new file mode 100644 index 0000000..eb05362 --- /dev/null +++ b/public/robots.txt @@ -0,0 +1,2 @@ +User-agent: * +Disallow: diff --git a/resources/css/app.css b/resources/css/app.css new file mode 100644 index 0000000..b950a03 --- /dev/null +++ b/resources/css/app.css @@ -0,0 +1,576 @@ +@import 'tailwindcss'; + +/* + * Lara & Felix – gemeinsames Stylesheet für Website, Anmeldung und Mitgliederbereich (ADR-36). + * Reihenfolge: Tokens → Grundelemente → Grundkomponenten → Website-Gerüst → Abschnitte → Widgets → Mitgliederbereich. + */ +@import './tokens.css'; +@import './base.css'; +@import './components.css'; +@import './site.css'; +@import './sections.css'; +@import './widgets.css'; +/* Premium-Widgets nach Brand-UI-Kit v1.6; ersetzen das frühere Hero- und Bild-und-Text-CSS. */ +@import './components/lf-hero.css'; +@import './components/lf-bild-text.css'; +/* Premium-Karten nach Brand-UI-Kit v1.7 (Entwurf zur visuellen Freigabe): Themen-, Medien- und Programmkarte. */ +@import './components/lf-premium-card.css'; + +/* + * Mitgliederbereich: eigene Anwendungsoberfläche mit eigener Navigation. Er verwendet die gemeinsamen + * Tokens über seine bisherigen Variablennamen; Layout und Navigation bleiben unverändert. + */ +body.member { + --marke-navy: var(--lf-navy); + --marke-gruen: var(--lf-green); + --marke-aktion: var(--lf-green-deep); + --marke-gelb: var(--lf-yellow); + --marke-creme: var(--lf-cream); + --marke-tinte: var(--lf-ink); + --text: var(--color-text); + --text-leise: var(--color-text-muted); + --flaeche: var(--color-surface-subtle); + --flaeche-karte: var(--color-surface-raised); + --linie: var(--color-border); + --aktion: var(--color-action); + --aktion-text: var(--color-action-text); + --akzent: var(--color-accent); + --fokus: var(--color-focus); + --erfolg: var(--color-success); + --hinweis: var(--color-warning); + --fehler: var(--color-danger); + --radius-karte: var(--radius-card); + --radius-flaeche: var(--radius-panel); + --radius-pille: var(--radius-pill); + --schatten: var(--shadow-raised); + --schrift-lesen: var(--font-reading); + --schrift-auszeichnung: var(--font-display); + background: var(--flaeche); + color: var(--text); + font-family: var(--schrift-lesen); + font-size: var(--text-body); +} + +body.member :focus-visible { + outline: 3px solid var(--fokus); + outline-offset: 3px; +} + +body.member h1, +body.member h2, +body.member .member-mark .brand-name, +body.member .entry strong { + font-family: var(--schrift-auszeichnung); + letter-spacing: -0.02em; +} + +body.member h1 { + font-size: clamp(2.125rem, 4vw, 3.25rem); + line-height: 1.15; + margin: 0.2rem 0 0.6rem; + max-width: 18ch; +} + +body.member h2 { + font-size: clamp(1.35rem, 2vw, 1.7rem); + line-height: 1.25; + margin: 0 0 0.75rem; + overflow-wrap: anywhere; +} + +body.member .member-shell { + min-height: 100vh; +} + +body.member .member-side { + display: none; +} + +body.member .member-main { + min-width: 0; +} + +body.member .member-top, +body.member .member-sheet { + width: min(72rem, calc(100% - 2rem)); + margin-inline: auto; +} + +body.member .member-top { + display: flex; + flex-wrap: wrap; + align-items: center; + gap: 0.75rem 1rem; + min-height: 4.25rem; +} + +body.member .member-mark { + display: flex; + flex-direction: column; + color: inherit; + text-decoration: none; + line-height: 1.1; +} + +body.member .member-mark .brand-name { + font-size: 1.35rem; + white-space: nowrap; +} + +body.member .member-mark .brand-claim, +body.member .quiet { + color: var(--text-leise); + font-size: 0.9rem; +} + +body.member .member-quick { + display: flex; + gap: 0.75rem; + margin-left: auto; +} + +body.member .member-quick a { + color: inherit; + text-decoration: none; + min-height: 2.75rem; + display: inline-flex; + align-items: center; +} + +body.member .member-sheet { + padding-bottom: 6.5rem; +} + +body.member .member-intro { + margin: 0.5rem 0 1.5rem; +} + +body.member .lede { + max-width: 62ch; + font-size: 1.125rem; +} + +body.member .flag { + display: inline-block; + margin: 0; + padding: 0.15rem 0 0.2rem; + background-image: linear-gradient(var(--akzent), var(--akzent)); + background-position: 0 100%; + background-repeat: no-repeat; + background-size: 100% 0.45rem; + color: var(--marke-navy); + font-weight: 650; +} + +body.member .member-nav { + display: grid; + gap: 0.25rem; +} + +body.member .member-nav a, +body.member .member-dock a, +body.member .button, +body.member button.button { + min-height: 2.75rem; + display: inline-flex; + align-items: center; +} + +body.member .button, +body.member button.button { + font: inherit; + background: var(--aktion); + color: var(--aktion-text); + border: 0; + border-radius: var(--radius-pille); + padding: 0.55rem 1rem; + text-decoration: none; + cursor: pointer; + width: fit-content; +} + +body.member .button-quiet { + background: transparent; + color: var(--marke-navy); + box-shadow: inset 0 0 0 2px var(--marke-navy); +} + +body.member .member-dock { + position: fixed; + left: 0; + right: 0; + bottom: 0; + z-index: 5; + display: grid; + grid-template-columns: repeat(5, 1fr); + background: var(--marke-navy); + padding: 0.25rem 0.35rem calc(0.25rem + env(safe-area-inset-bottom)); +} + +body.member .member-dock a { + justify-content: center; + text-align: center; + color: #f7f6f2; + text-decoration: none; + font-size: 0.78rem; + line-height: 1.15; + padding: 0.35rem 0.15rem; + border-radius: 10px; +} + +body.member .member-dock a[aria-current='page'] { + background: var(--akzent); + color: var(--marke-navy); +} + +body.member .finder, +body.member .form { + display: grid; + gap: 0.9rem; + background: var(--flaeche-karte); + border: 1px solid var(--linie); + border-radius: var(--radius-flaeche); + padding: 1rem; + margin-bottom: 1.5rem; +} + +body.member .finder-query, +body.member .form label, +body.member legend { + font-weight: 650; +} + +body.member input[type='search'], +body.member input[type='text'], +body.member .form input { + font: inherit; + width: 100%; + box-sizing: border-box; + min-height: 2.75rem; + border: 1px solid #8aa084; + border-radius: 8px; + background: white; + padding: 0.55rem 0.75rem; +} + +body.member fieldset { + border: 0; + margin: 0; + padding: 0; + display: flex; + flex-wrap: wrap; + gap: 0.5rem 0.9rem; +} + +body.member .check { + display: flex; + align-items: flex-start; + gap: 0.55rem; + width: 100%; + min-height: 2.75rem; + font-weight: 400; +} + +body.member .check input { + width: 1.25rem; + height: 1.25rem; + margin-top: 0.15rem; + flex: none; +} + +body.member .finder-actions, +body.member .member-sheet form + form { + display: flex; + flex-wrap: wrap; + gap: 0.75rem; +} + +body.member .card-grid, +body.member .entry-grid { + display: grid; + gap: 1rem; +} + +body.member .media-card, +body.member .entry, +body.member .license-list li, +body.member .course > li, +body.member .empty { + background: var(--flaeche-karte); + border: 1px solid var(--linie); + border-radius: var(--radius-karte); + box-shadow: var(--schatten); +} + +body.member .media-card a, +body.member .entry { + display: grid; + color: inherit; + text-decoration: none; + min-height: 100%; +} + +body.member .thumb { + aspect-ratio: 4 / 3; + border-radius: var(--radius-karte) var(--radius-karte) 0 0; + background: + linear-gradient(160deg, var(--marke-navy) 0 58%, var(--akzent) 58% 68%, #e7efe4 68%); + display: flex; + flex-direction: column; + justify-content: space-between; + padding: 0.8rem; +} + +body.member .thumb .flag { + align-self: flex-start; + background-color: var(--akzent); + background-image: none; + padding: 0.2rem 0.55rem; + border-radius: var(--radius-pille); +} + +body.member .thumb img { + width: 100%; + height: 8rem; + object-fit: cover; + border-radius: 8px; +} + +body.member .thumb-label { + align-self: flex-start; + background: rgb(255 255 255 / 92%); + color: var(--marke-navy); + border-radius: 8px; + padding: 0.2rem 0.45rem; +} + +body.member .card-copy { + display: grid; + gap: 0.45rem; + padding: 0.9rem 1rem 1rem; +} + +body.member .card-copy p, +body.member .reading, +body.member .prose { + max-width: 68ch; +} + +body.member .entry { + padding: 1rem 1.1rem; + align-content: end; + min-height: 7.5rem; +} + +body.member .entry strong { + font-size: 2.4rem; + color: var(--marke-navy); +} + +body.member .state { + margin: 0.4rem 0; + font-weight: 650; +} + +body.member .state-nutzbar { + color: var(--erfolg); +} + +body.member .state-teilweise, +body.member .state-hinweis { + color: var(--hinweis); +} + +body.member .state-nicht, +body.member .state-nichtenthalten, +body.member .errors { + color: var(--fehler); +} + +body.member .errors, +body.member .status { + border-radius: 8px; + padding: 0.75rem 1rem; +} + +body.member .errors { + background: #fde8e6; +} + +body.member .status { + background: #e5f3ea; + color: var(--erfolg); +} + +body.member .facts { + display: grid; + gap: 0.75rem; + margin: 0 0 1.25rem; +} + +body.member .facts div { + background: var(--flaeche-karte); + border-radius: 8px; + padding: 0.75rem 0.9rem; +} + +body.member .facts dt { + color: var(--text-leise); + font-size: 0.9rem; +} + +body.member .facts dd { + margin: 0.15rem 0 0; + font-weight: 650; +} + +body.member .didactic, +body.member .reading { + background: var(--flaeche-karte); + border-left: 6px solid var(--akzent); + border-radius: 0 var(--radius-karte) var(--radius-karte) 0; + padding: 1rem 1.1rem; + margin-bottom: 1.5rem; +} + +body.member .course { + list-style: none; + padding: 0; + margin: 0; + display: grid; + gap: 1rem; +} + +body.member .course > li { + padding: 1rem; + display: grid; + gap: 0.7rem; +} + +body.member .course .course { + margin-top: 0.4rem; +} + +body.member .player { + display: grid; + gap: 0.7rem; + background: var(--marke-navy); + border-radius: var(--radius-karte); + padding: 0.7rem; +} + +body.member .player video, +body.member .player audio { + width: 100%; + max-height: 70vh; + background: #02182f; +} + +body.member .player .button { + justify-self: start; +} + +body.member .license-list { + list-style: none; + padding: 0; + display: grid; + gap: 1rem; +} + +body.member .license-list li, +body.member .empty { + padding: 1rem 1.1rem; +} + +body.member .crumb a { + color: var(--marke-navy); +} + +@media (min-width: 40rem) { + body.member .card-grid, + body.member .entry-grid, + body.member .facts { + grid-template-columns: 1fr 1fr; + } + + body.member .finder .check { + width: auto; + } +} + +@media (min-width: 64rem) { + body.member .member-shell { + display: grid; + grid-template-columns: 16.5rem minmax(0, 1fr); + } + + body.member .member-side { + display: flex; + flex-direction: column; + gap: 1.5rem; + position: sticky; + top: 0; + height: 100vh; + padding: 1.25rem 1rem 1.5rem; + background: var(--marke-navy); + color: #f7f6f2; + } + + body.member .member-side .member-mark, + body.member .member-side .member-nav a { + color: #f7f6f2; + } + + body.member .member-side .member-nav a { + text-decoration: none; + border-radius: 10px; + padding: 0 0.7rem; + } + + body.member .member-side .member-nav a[aria-current='page'] { + background: var(--akzent); + color: var(--marke-navy); + } + + body.member .member-logout { + margin-top: auto; + } + + body.member .member-logout button { + font: inherit; + color: #f7f6f2; + background: transparent; + border: 0; + min-height: 2.75rem; + cursor: pointer; + padding: 0 0.7rem; + } + + body.member .member-top, + body.member .member-dock { + display: none; + } + + body.member .member-top { + justify-content: flex-end; + } + + body.member .member-sheet { + padding-bottom: 3rem; + } + + body.member .card-grid { + grid-template-columns: 1fr 1fr 1fr; + } +} + +@media (prefers-reduced-motion: reduce) { + body.member * { + scroll-behavior: auto; + } +} + +/* Wortmarke in der dunklen Seitenleiste: heller Zusatz für ausreichenden Kontrast. */ +body.member .member-side .member-mark .brand-claim { + color: #d3dde8; +} diff --git a/resources/css/base.css b/resources/css/base.css new file mode 100644 index 0000000..42ab8dc --- /dev/null +++ b/resources/css/base.css @@ -0,0 +1,149 @@ +/* Grundelemente und Typografie, gemeinsam für Website, Anmeldung und Mitgliederbereich. */ + +*, +*::before, +*::after { + box-sizing: border-box; +} + +html { + background: var(--color-surface); + color: var(--color-text); + font-family: var(--font-reading); + font-size: 100%; + line-height: var(--leading-body); + -webkit-text-size-adjust: 100%; + /* Platz für den Scrollbalken immer freihalten: kurze und lange Seiten haben dieselbe Breite, nichts springt. */ + scrollbar-gutter: stable; + /* Sprungziele und Fokus nicht unter der klebenden Kopfzeile verstecken. */ + scroll-padding-top: calc(var(--header-height) + var(--space-4)); +} + +body { + margin: 0; + min-height: 100vh; + font-size: var(--text-body); + background: var(--color-surface); + color: var(--color-text); +} + +img, +video, +svg { + max-width: 100%; +} + +img { + height: auto; +} + +a { + color: var(--color-link); + text-decoration-thickness: 1px; + text-underline-offset: 0.18em; +} + +a:hover { + color: var(--color-link-hover); + text-decoration-thickness: 2px; +} + +:focus-visible { + outline: 3px solid var(--color-focus); + outline-offset: 3px; +} + +h1, +h2, +h3 { + font-family: var(--font-display); + color: var(--color-heading); + line-height: var(--leading-heading); + letter-spacing: -0.02em; + font-weight: 800; + overflow-wrap: break-word; + hyphens: auto; +} + +h1 { + font-size: var(--text-h1); + margin: 0 0 var(--space-4); +} + +h2 { + font-size: var(--text-h2); + margin: 0 0 var(--space-3); +} + +h3 { + font-size: var(--text-h3); + margin: 0 0 var(--space-2); + font-weight: 700; +} + +p { + margin: 0 0 var(--space-4); +} + +.lede { + font-size: var(--text-lede); + color: var(--color-text); + max-width: var(--measure); +} + +.prose { + max-width: var(--measure); +} + +.prose > :last-child, +.lede:last-child { + margin-bottom: 0; +} + +.prose ul, +.prose ol { + margin: 0 0 var(--space-4); + padding-left: 1.4rem; +} + +.prose li > p { + margin: 0; +} + +.visually-hidden { + position: absolute !important; + width: 1px; + height: 1px; + padding: 0; + margin: -1px; + overflow: hidden; + clip: rect(0 0 0 0); + white-space: nowrap; + border: 0; +} + +.skip { + position: absolute; + left: var(--space-4); + top: -4rem; + z-index: 100; + background: var(--lf-white); + color: var(--lf-navy); + padding: var(--space-2) var(--space-3); + border-radius: var(--radius-small); +} + +.skip:focus { + top: var(--space-4); +} + +@media (prefers-reduced-motion: reduce) { + *, + *::before, + *::after { + scroll-behavior: auto !important; + transition-duration: 0.01ms !important; + animation-duration: 0.01ms !important; + animation-iteration-count: 1 !important; + } +} diff --git a/resources/css/components.css b/resources/css/components.css new file mode 100644 index 0000000..e380afd --- /dev/null +++ b/resources/css/components.css @@ -0,0 +1,302 @@ +/* + * Gemeinsame Grundkomponenten (Standardmuster, nur mit Tokens eingefärbt). Sie werden von Website, + * Anmeldung und Mitgliederbereich verwendet und können später gezielt veredelt werden. + */ + +/* Container */ +.ui-container { + width: min(var(--container-standard), 100% - 2 * var(--gutter)); + margin-inline: auto; +} + +.ui-container-wide { + width: min(var(--container-wide), 100% - 2 * var(--gutter)); +} + +/* Schaltflächen und Schaltflächen-Links: Haupt, Neben, Text. Mindestgröße 44 px. */ +.button, +.ui-button { + display: inline-flex; + align-items: center; + justify-content: center; + gap: var(--space-2); + min-height: var(--touch-target); + padding: 0.55rem 1.25rem; + border: 2px solid transparent; + border-radius: var(--radius-pill); + background: var(--color-action); + color: var(--color-action-text); + font: inherit; + font-weight: 700; + line-height: 1.2; + max-width: 100%; + text-align: center; + overflow-wrap: anywhere; + text-decoration: none; + cursor: pointer; + transition: background-color 0.15s ease, border-color 0.15s ease; +} + +.button:hover, +.ui-button:hover { + background: var(--color-action-hover); + color: var(--color-action-text); + text-decoration: none; +} + +/* Markenschaltfläche: Gelb mit dunkelblauer Schrift (11:1), für die wichtigste Handlung im Seiteneinstieg. */ +.button-brand { + background: var(--lf-yellow); + color: var(--lf-navy); +} + +.button-brand:hover { + background: #ffe05c; + color: var(--lf-navy); +} + +.button-secondary, +.ui-button-secondary { + background: transparent; + border-color: var(--color-border-strong); + color: var(--color-action-secondary-text); +} + +.button-secondary:hover, +.ui-button-secondary:hover { + background: transparent; + border-color: currentColor; + color: var(--color-action-secondary-text); +} + +.button-quiet, +.ui-button-quiet { + background: transparent; + color: var(--color-link); + padding-inline: var(--space-2); + text-decoration: underline; +} + +.button-quiet:hover, +.ui-button-quiet:hover { + background: transparent; + color: var(--color-link-hover); +} + +.button[disabled], +.ui-button[disabled], +.ui-button[aria-disabled='true'] { + background: var(--color-disabled-surface); + border-color: transparent; + color: var(--color-disabled); + cursor: not-allowed; +} + +/* Formulare: sichtbare Beschriftung, Fehlertext am Feld. */ +.form { + display: grid; + gap: var(--space-4); + max-width: 28rem; +} + +.form label, +.ui-field { + display: grid; + gap: var(--space-1); + font-weight: 600; +} + +.form input, +.form select, +.form textarea, +.ui-input { + font: inherit; + font-weight: 400; + min-height: var(--touch-target); + padding: 0.5rem 0.75rem; + border: 1px solid var(--color-border-strong); + border-radius: var(--radius-small); + background: var(--lf-white); + color: var(--lf-ink); + width: 100%; +} + +.form input[aria-invalid='true'], +.ui-input[aria-invalid='true'] { + border-color: var(--color-danger); +} + +.form button { + width: fit-content; +} + +.form button:not(.button-quiet):not(.button-secondary) { + display: inline-flex; + align-items: center; + min-height: var(--touch-target); + padding: 0.55rem 1.25rem; + border: 0; + border-radius: var(--radius-pill); + background: var(--color-action); + color: var(--color-action-text); + font: inherit; + font-weight: 700; + cursor: pointer; +} + +.check { + display: grid; + grid-template-columns: auto 1fr; + align-items: start; + gap: var(--space-2); + font-weight: 400; +} + +.check input { + width: 1.25rem; + height: 1.25rem; + min-height: 0; + margin-top: 0.2rem; +} + +.ui-field-error { + color: var(--color-danger); + font-weight: 400; + font-size: var(--text-small); +} + +/* Statusanzeigen: Farbe, Symbol und Text tragen gemeinsam (nie Farbe allein). */ +.status, +.errors, +.ui-notice { + display: block; + border-left: 4px solid currentColor; + border-radius: var(--radius-small); + padding: var(--space-3) var(--space-4); + margin: 0 0 var(--space-5); + max-width: var(--measure); +} + +.status, +.ui-notice-success { + background: var(--color-success-surface); + color: var(--color-success); +} + +.errors, +.ui-notice-danger { + background: var(--color-danger-surface); + color: var(--color-danger); +} + +.ui-notice-warning { + background: var(--color-warning-surface); + color: var(--color-warning); +} + +.ui-notice-info { + background: var(--color-info-surface); + color: var(--color-info); +} + +.ui-notice-title { + font-weight: 700; +} + +.errors ul { + margin: var(--space-2) 0 0; + padding-left: 1.2rem; +} + +/* Karten-Grundkomponente */ +.ui-card, +.empty { + background: var(--color-surface-raised); + border: 1px solid var(--color-border); + border-radius: var(--radius-card); + padding: var(--space-5); +} + +.empty { + max-width: var(--measure); +} + +/* Dialog (natives dialog-Element) */ +.ui-dialog { + border: 0; + border-radius: var(--radius-panel); + padding: var(--space-6); + max-width: min(36rem, 100% - 2rem); + background: var(--lf-white); + color: var(--lf-ink); + box-shadow: var(--shadow-raised); +} + +.ui-dialog::backdrop { + background: rgb(3 37 81 / 55%); +} + +/* Kennzeile über Überschriften */ +.ui-flag { + display: inline-flex; + align-items: center; + gap: var(--space-2); + font-size: 0.8125rem; + font-weight: 700; + letter-spacing: 0.08em; + text-transform: uppercase; + color: var(--color-text-muted); +} + +.ui-flag::before { + content: ''; + width: 1.6rem; + height: 4px; + border-radius: 4px; + background: var(--color-accent); +} + +/* Themensignatur: Nummer und Name tragen die Unterscheidung; Symbol erst nach Freigabe. */ +.ui-theme-signature { + display: inline-flex; + align-items: center; + gap: var(--space-2); + font-weight: 600; +} + +.ui-theme-signature-mark { + display: inline-grid; + place-items: center; + min-width: 2rem; + height: 2rem; + border-radius: var(--radius-small); + border: 1px solid var(--color-border-strong); + background: var(--theme-tint, var(--color-surface-subtle)); + color: var(--lf-navy); + font-family: var(--font-display); + font-weight: 800; +} + +.ui-theme-signature[data-theme='1'] { --theme-tint: var(--color-theme-1); } +.ui-theme-signature[data-theme='2'] { --theme-tint: var(--color-theme-2); } +.ui-theme-signature[data-theme='3'] { --theme-tint: var(--color-theme-3); } +.ui-theme-signature[data-theme='4'] { --theme-tint: var(--color-theme-4); } +.ui-theme-signature[data-theme='5'] { --theme-tint: var(--color-theme-5); } + +/* Redaktionelle Hinweise in der Vorschau (öffentlich nie sichtbar). */ +.preview-note, +.preview-banner { + background: var(--color-warning-surface); + color: var(--color-warning); + border-left: 4px solid currentColor; + border-radius: var(--radius-small); + font-size: var(--text-small); + padding: var(--space-2) var(--space-3); + margin: var(--space-2) 0 0; +} + +.preview-banner { + margin: 0; + border-radius: 0; + text-align: center; +} diff --git a/resources/css/components/lf-bild-text.css b/resources/css/components/lf-bild-text.css new file mode 100644 index 0000000..ce3ead0 --- /dev/null +++ b/resources/css/components/lf-bild-text.css @@ -0,0 +1,226 @@ +/* + * Premium-Bild-und-Text – übernommen aus docs/Brand-UI-Kit/12_premium_widgets_adaptiv_v1.6/components/lf-bild-text.v1.6.css. + * Ersetzt das bisherige Bild-und-Text-CSS (nicht parallel laden). Die Darstellung folgt der tatsächlichen + * Containerbreite, nicht der Einheitenzahl. + * + * Anpassungen an das Repository: + * - Oberfläche „clear“ übernimmt die Bedeutungswerte des Abschnitts (auch auf dunklen Abschnitten lesbar). + * - Überschrift erbt Farbe und Schrift (globale h1–h3-Regeln setzen sonst Navy). + * - Fokusfarbe aus den Tokens; Schriften über --lf-font-display und --lf-font-ui. + */ +.lf-bt-host { container: lf-bt / inline-size; inline-size: 100%; min-inline-size: 0; max-inline-size: 100%; } +.lf-bt-host, .lf-bt-host * { box-sizing: border-box; } + +.lf-bt { + --bt-navy: var(--lf-navy, #032551); + --bt-green: var(--lf-green-deep, #3b7b09); + --bt-yellow: var(--lf-yellow, #fcd10a); + --bt-cream: var(--lf-cream, #f7f6f2); + --bt-muted: var(--lf-muted, #46556b); + --bt-eyebrow: #295b08; + --bt-focus-x: 64%; + --bt-focus-y: 43%; + --color-focus: var(--lf-focus); + display: grid; + grid-template-columns: minmax(0, 1fr); + align-items: start; + gap: clamp(0.9rem, 2.65cqi, 2rem); + padding: clamp(1rem, 2.8cqi, 3.25rem); + border-radius: clamp(1rem, 1.8cqi, 1.65rem); + min-inline-size: 0; + max-inline-size: 100%; + background: var(--bt-cream); + color: var(--bt-navy); + font: 400 1rem/1.6 var(--lf-font-ui); + overflow-wrap: break-word; +} + +.lf-bt--navy { + --bt-muted: #f0f4f9; + --bt-eyebrow: #fff2b0; + --color-focus: var(--lf-yellow); + background: var(--bt-navy); + color: #fff; +} + +/* Ohne eigene Fläche: Farben des Abschnitts (hell, dunkel, Markenakzent). */ +.lf-bt--clear { + --bt-muted: var(--color-text-muted); + --bt-eyebrow: var(--color-heading); + --color-focus: inherit; + background: transparent; + color: var(--color-heading); + padding-inline: 0; +} + +.lf-bt__copy { min-inline-size: 0; max-inline-size: 49rem; align-self: center; } + +.lf-bt__eyebrow { + display: flex; + align-items: center; + gap: 0.6rem; + margin: 0 0 0.8rem; + color: var(--bt-eyebrow); + font-size: 0.73rem; + line-height: 1.45; + font-weight: 800; + letter-spacing: 0.065em; + text-transform: uppercase; + overflow-wrap: anywhere; +} + +.lf-bt__eyebrow::before { + content: ''; + flex: 0 0 auto; + inline-size: 1.35rem; + block-size: 0.25rem; + background: var(--bt-yellow); + border-radius: 999px; +} + +.lf-bt__headline { + margin: 0; + color: inherit; + font-family: var(--lf-font-display); + font-size: clamp(1.55rem, 4.5cqi, 3.35rem); + line-height: 1.14; + letter-spacing: -0.03em; + font-weight: 850; + overflow-wrap: anywhere; + hyphens: manual; + text-wrap: balance; +} + +.lf-bt__accent { + display: block; + inline-size: clamp(4.6rem, 12cqi, 7rem); + block-size: 0.36rem; + margin: clamp(0.55rem, 1.7cqi, 1rem) 0 clamp(0.8rem, 2.3cqi, 1.25rem) 0.12rem; + background: var(--bt-yellow); + border-radius: 90% 35% 75% 40%; + transform: rotate(-1deg); +} + +.lf-bt__body { color: var(--bt-muted); font-size: clamp(0.97rem, 1.45cqi, 1.12rem); line-height: 1.62; overflow-wrap: anywhere; } +.lf-bt__body > :first-child { margin-block-start: 0; } +.lf-bt__body > :last-child { margin-block-end: 0; } +.lf-bt__body p { margin: 0 0 0.9em; } +.lf-bt__body ul, +.lf-bt__body ol { padding-inline-start: 1.35em; margin: 0.6em 0; } +.lf-bt__body a { color: inherit; text-decoration: underline; text-underline-offset: 0.15em; } + +.lf-bt__actions { display: flex; flex-wrap: wrap; align-items: stretch; gap: 0.65rem; margin-block-start: clamp(1rem, 2cqi, 1.5rem); min-inline-size: 0; } + +.lf-bt__button { + display: inline-flex; + align-items: center; + justify-content: center; + gap: 0.5rem; + max-inline-size: 100%; + min-inline-size: 0; + min-block-size: 2.95rem; + padding: 0.7rem 1rem; + background: var(--bt-green); + border: 2px solid var(--bt-green); + color: #fff; + border-radius: 999px; + text-decoration: none; + text-align: center; + font-size: 0.89rem; + font-weight: 800; + line-height: 1.33; + overflow-wrap: anywhere; + white-space: normal; + transition: background-color 0.14s ease, transform 0.14s ease; +} + +.lf-bt__button:visited { color: #fff; } +.lf-bt__button:hover { background: #285a06; color: #fff; transform: translateY(-1px); } +.lf-bt__button--secondary, +.lf-bt__button--secondary:visited { background: transparent; border-color: currentColor; color: inherit; } +.lf-bt__button--secondary:hover { background: rgb(3 37 81 / 6%); color: inherit; } +.lf-bt--navy .lf-bt__button--secondary:hover, +.scope-dark .lf-bt--clear .lf-bt__button--secondary:hover, +.scope-accent .lf-bt--clear .lf-bt__button--secondary:hover { background: rgb(255 255 255 / 12%); } +.lf-bt__button:focus-visible, +.lf-bt__body a:focus-visible { outline: 3px solid var(--color-focus); outline-offset: 3px; } + +.lf-bt__media { position: relative; display: block; order: -1; min-inline-size: 0; isolation: isolate; } + +.lf-bt__media::before { + content: ''; + position: absolute; + inset: auto -0.42rem -0.45rem 1rem; + z-index: -1; + block-size: 53%; + border-radius: 1.1rem; + background: #8ab848; + transform: rotate(1.5deg); +} + +.lf-bt--navy .lf-bt__media::before { background: var(--bt-yellow); } + +.lf-bt__image { + display: block; + inline-size: 100%; + max-inline-size: none; + block-size: auto; + aspect-ratio: 16 / 10; + object-fit: cover; + object-position: var(--bt-focus-x) var(--bt-focus-y); + border-radius: clamp(0.78rem, 1.8cqi, 1.3rem); + box-shadow: 0 10px 28px rgb(3 37 81 / 11%); +} + +.lf-bt--height-compact .lf-bt__image { aspect-ratio: 16 / 9; } +.lf-bt--height-spacious .lf-bt__image { aspect-ratio: 4 / 3; } +.lf-bt--height-compact { gap: clamp(0.75rem, 2cqi, 1.45rem); } +.lf-bt--height-spacious { gap: clamp(1.15rem, 3.4cqi, 2.7rem); } +.lf-bt--without-image { grid-template-columns: minmax(0, 1fr); } + +/* Schmale Plätze: vollständiger Text und Links, keine erzwungene Höhe. */ +@container lf-bt (max-width: 539.99px) { + .lf-bt__actions { display: grid; grid-template-columns: minmax(0, 1fr); } + .lf-bt__button { inline-size: 100%; } + .lf-bt__headline { font-size: clamp(1.42rem, 6.8cqi, 2.2rem); } + .lf-bt__eyebrow { letter-spacing: 0.03em; } +} + +/* Mittlere Containerbreite (meist zwei Einheiten): flacher Bildstreifen statt gequetschter Zweispaltigkeit. */ +@container lf-bt (min-width: 540px) and (max-width: 899.99px) { + .lf-bt { gap: clamp(0.8rem, 1.6cqi, 1.2rem); padding: clamp(1.1rem, 2.4cqi, 1.65rem); } + .lf-bt--clear { padding-inline: 0; } + .lf-bt__media { inline-size: 100%; } + .lf-bt__image { aspect-ratio: 2.15 / 1; } + .lf-bt--height-compact .lf-bt__image { aspect-ratio: 2.5 / 1; } + .lf-bt--height-spacious .lf-bt__image { aspect-ratio: 1.8 / 1; } + .lf-bt__headline { font-size: clamp(1.65rem, 3.6cqi, 2.28rem); } + .lf-bt__body { font-size: 1.01rem; line-height: 1.59; } + .lf-bt__actions { margin-block-start: 0.95rem; } + .lf-bt__button { flex: 1 1 13rem; } +} + +/* Breiter Container: zweispaltige Komposition, Bild links oder rechts. */ +@container lf-bt (min-width: 900px) { + .lf-bt { + grid-template-columns: minmax(0, 1.02fr) minmax(0, 0.98fr); + align-items: center; + gap: clamp(1.8rem, 4cqi, 4.5rem); + padding: clamp(1.8rem, 4cqi, 4.5rem); + } + + .lf-bt--clear { padding-inline: 0; } + .lf-bt__media { order: 0; align-self: stretch; } + .lf-bt--image-left .lf-bt__media { order: -1; } + .lf-bt__image { block-size: 100%; min-block-size: 18rem; aspect-ratio: 4 / 3; } + .lf-bt--height-compact .lf-bt__image { min-block-size: 14rem; aspect-ratio: 3 / 2; } + .lf-bt--height-spacious .lf-bt__image { min-block-size: 24rem; aspect-ratio: 1 / 1; } + .lf-bt--height-compact { padding-block: clamp(1.25rem, 2.8cqi, 2.6rem); } + .lf-bt--height-spacious { padding-block: clamp(2.15rem, 4.5cqi, 4.75rem); } + .lf-bt--without-image { grid-template-columns: minmax(0, 1fr); } +} + +@media (prefers-reduced-motion: reduce) { + .lf-bt__button { transition: none; } + .lf-bt__button:hover { transform: none; } +} diff --git a/resources/css/components/lf-hero.css b/resources/css/components/lf-hero.css new file mode 100644 index 0000000..60ee795 --- /dev/null +++ b/resources/css/components/lf-hero.css @@ -0,0 +1,209 @@ +/* + * Premium-Einstieg – übernommen aus docs/Brand-UI-Kit/12_premium_widgets_adaptiv_v1.6/components/lf-hero.v1.6.css. + * Ersetzt das bisherige Hero-CSS (nicht parallel laden). + * + * Anpassungen an das Repository (dokumentiert in docs/architektur/cms-widget-registry.md): + * - Überschrift und Akzent erben Farbe und erhalten Blockdarstellung (die globalen h1–h3-Regeln setzen sonst Navy). + * - Akzentwahl underline/rays/none; Strahlen aus resources/views/components/brand/rays.blade.php. + * - Fokusfarbe und Schriften über die gemeinsamen Tokens (--lf-font-display, --lf-font-ui, --color-focus). + * Die Höhen sind Mindesthöhen ab 860 px Containerbreite; Inhalte vergrößern jede Variante. + */ +.lf-hero-host { container: lf-hero / inline-size; inline-size: 100%; min-inline-size: 0; max-inline-size: 100%; } +.lf-hero-host, .lf-hero-host * { box-sizing: border-box; } + +.lf-hero { + --lf-hero-navy: var(--lf-navy, #032551); + --lf-hero-green: var(--lf-green-deep, #3b7b09); + --lf-hero-yellow: var(--lf-yellow, #fcd10a); + --lf-hero-cream: var(--lf-cream, #f7f6f2); + --lf-hero-focus-x: 68%; + --lf-hero-focus-y: 50%; + --color-focus: var(--lf-focus); + isolation: isolate; + position: relative; + display: grid; + align-items: center; + min-inline-size: 0; + min-block-size: 32rem; + max-inline-size: 100%; + border-radius: clamp(1rem, 1.9cqi, 1.75rem); + background: var(--lf-hero-cream); + color: var(--lf-hero-navy); + font-family: var(--lf-font-display); +} + +.lf-hero--height-compact { min-block-size: 25rem; } +.lf-hero--height-normal { min-block-size: 32rem; } +.lf-hero--height-large { min-block-size: 40rem; } + +.lf-hero__photo { + position: absolute; + inset: 0; + z-index: -2; + inline-size: 100%; + block-size: 100%; + max-inline-size: none; + object-fit: cover; + object-position: var(--lf-hero-focus-x) var(--lf-hero-focus-y); + border-radius: inherit; +} + +.lf-hero--photo-split::before { + content: ''; + position: absolute; + inset: 0; + z-index: -1; + border-radius: inherit; + background: linear-gradient(90deg, rgb(250 249 243 / 99%) 0%, rgb(250 249 243 / 98%) 28%, rgb(250 249 243 / 85%) 41%, rgb(250 249 243 / 12%) 69%, transparent 80%); +} + +.lf-hero--editorial-solid { + --color-focus: var(--lf-yellow); + background: var(--lf-hero-navy); + color: #fff; +} + +.lf-hero--editorial-solid::before { + content: ''; + position: absolute; + inset: auto -7% -50% auto; + z-index: -1; + inline-size: 40%; + aspect-ratio: 1; + background: var(--lf-hero-green); + border-radius: 50%; + opacity: 0.8; +} + +.lf-hero--editorial-solid { overflow: hidden; } + +.lf-hero__inner { + inline-size: 100%; + max-inline-size: 1440px; + min-inline-size: 0; + margin-inline: auto; + padding: clamp(1.8rem, 4.3cqi, 5rem); + padding-block: clamp(2.1rem, 5cqi, 5rem); +} + +.lf-hero__copy { position: relative; max-inline-size: min(660px, 58%); min-inline-size: 0; } +.lf-hero--editorial-solid .lf-hero__copy { max-inline-size: 760px; } + +.lf-hero__eyebrow { + display: inline-block; + margin: 0; + padding: 0.35em 0.75em; + border-radius: 999px; + background: #dff0c0; + color: #17370b; + font-weight: 800; + font-size: clamp(0.78rem, 1.25cqi, 0.95rem); + overflow-wrap: anywhere; +} + +.lf-hero__title { + margin: 0.25em 0; + color: inherit; + font-family: inherit; + font-size: clamp(2.1rem, 5.4cqi, 4.9rem); + line-height: 1.06; + letter-spacing: -0.035em; + font-weight: 900; + text-wrap: balance; + overflow-wrap: anywhere; + hyphens: manual; +} + +.lf-hero__title-accent { + display: block; + inline-size: clamp(6rem, 15cqi, 15rem); + block-size: 0.42rem; + margin: 0 0 clamp(1.1rem, 2cqi, 1.5rem); + background: var(--lf-hero-yellow); + border-radius: 90% 30% 45% 25%; + transform: rotate(-1deg); +} + +.lf-hero__rays { + position: absolute; + inset-block-start: -2.4rem; + inset-inline-start: -2.2rem; + inline-size: clamp(2.6rem, 4.5cqi, 3.6rem); + color: var(--lf-hero-yellow); + transform: rotate(-24deg); + pointer-events: none; +} + +.lf-hero__description { + max-inline-size: 56ch; + margin: 0 0 clamp(1.25rem, 2.1cqi, 2rem); + font-family: var(--lf-font-ui); + font-size: clamp(1.05rem, 1.7cqi, 1.3rem); + line-height: 1.5; + overflow-wrap: anywhere; +} + +.lf-hero__actions { display: flex; flex-wrap: wrap; align-items: stretch; gap: 0.75rem; min-inline-size: 0; } + +.lf-hero__button { + display: inline-flex; + align-items: center; + justify-content: center; + min-inline-size: 0; + max-inline-size: 100%; + min-block-size: 3rem; + padding: 0.77rem 1.2rem; + border: 2px solid transparent; + border-radius: 999px; + font: 800 0.96rem/1.28 var(--lf-font-ui); + text-decoration: none; + text-align: center; + white-space: normal; + overflow-wrap: anywhere; + transition: transform 0.15s ease, background-color 0.15s ease; +} + +.lf-hero__button:hover { transform: translateY(-1px); } +.lf-hero__button:focus-visible { outline: 3px solid var(--color-focus); outline-offset: 3px; } +.lf-hero__button--primary, +.lf-hero__button--primary:visited { background: var(--lf-hero-green); color: #fff; } +.lf-hero__button--primary:hover { background: #285a06; color: #fff; } +.lf-hero__button--secondary, +.lf-hero__button--secondary:visited { background: rgb(255 255 255 / 95%); color: var(--lf-hero-navy); border-color: var(--lf-hero-navy); } +.lf-hero__button--secondary:hover { color: var(--lf-hero-navy); } + +.lf-hero__bottom { + position: absolute; + inset: auto 0 0; + block-size: 15px; + border-radius: 0 0 1.5rem 1.5rem; + background: linear-gradient(105deg, var(--lf-hero-yellow) 0%, var(--lf-hero-yellow) 22%, var(--lf-hero-green) 72%); + clip-path: polygon(0 45%, 30% 90%, 65% 75%, 100% 0, 100% 100%, 0 100%); + pointer-events: none; +} + +/* Sicherheitsumbruch, wenn der Container physisch zu schmal ist; keine eigene redaktionelle Variante. */ +@container lf-hero (max-width: 859.99px) { + .lf-hero { display: block; min-block-size: 0; } + .lf-hero--height-compact, + .lf-hero--height-normal, + .lf-hero--height-large { min-block-size: 0; } + .lf-hero__photo { position: relative; display: block; block-size: auto; aspect-ratio: 16 / 9; } + .lf-hero--photo-split::before { display: none; } + .lf-hero__inner { padding: clamp(1.2rem, 3.5cqi, 2rem); padding-block-end: 2.4rem; } + .lf-hero__copy { max-inline-size: 100%; } + .lf-hero__title { font-size: clamp(2rem, 5.5cqi, 3.1rem); } + .lf-hero__description { font-size: 1.07rem; } + .lf-hero--editorial-solid .lf-hero__copy { max-inline-size: 100%; } + .lf-hero__rays { inset-block-start: -1.6rem; inset-inline-start: auto; inset-inline-end: 0; transform: rotate(10deg); } +} + +@container lf-hero (max-width: 440px) { + .lf-hero__actions { display: grid; grid-template-columns: minmax(0, 1fr); } + .lf-hero__button { inline-size: 100%; } +} + +@media (prefers-reduced-motion: reduce) { + .lf-hero__button { transition: none; } + .lf-hero__button:hover { transform: none; } +} diff --git a/resources/css/components/lf-premium-card.css b/resources/css/components/lf-premium-card.css new file mode 100644 index 0000000..3af6783 --- /dev/null +++ b/resources/css/components/lf-premium-card.css @@ -0,0 +1,341 @@ +/* + * Premium-Karten (Themen-, Medien-, Programmkarte) – übernommen aus + * docs/Brand-UI-Kit/13_premium_karten_v1.7_entwurf/components/lf-premium-card.css (Entwurf zur visuellen Freigabe). + * + * Anpassungen an das Repository: + * - Eine Karte je Platz im bestehenden Abschnittsraster. Das Beispielraster des Kits (.lf-pc-grid, .lf-pc-section, + * Spannweiten-Klassen) wird bewusst nicht übernommen; Spalten und Abstände bestimmt der Abschnitt. + * - Breitenumschaltung bei 520 px über den Platz-Container „slot“ (eine Karte füllt ihren Platz), nicht über das Fenster. + * - Gleiche Höhe je Zeile über die gemeinsame Höhe „fill“ (widgets.css), Aktion dann am unteren Rand. + * - Schriften und Farben ausschließlich über vorhandene Tokens (tokens.css); keine neuen Schriften. + * - Die Karte hat ihre eigene helle Fläche und setzt dafür die hellen Bedeutungswerte, auch in dunklen Abschnitten. + * - Kein line-clamp, keine feste Höhe: lange Titel und Texte brechen um. + */ +.lf-pc, +.lf-pc * { + box-sizing: border-box; +} + +.lf-pc { + --color-heading: var(--lf-navy); + --color-text: var(--lf-ink); + --color-text-muted: var(--lf-ink-muted); + --color-border: var(--lf-line); + --color-focus: var(--lf-focus); + --pc-surface: var(--lf-white); + --pc-subtle: var(--lf-cream); + --pc-action: var(--lf-green-deep); + --pc-action-hover: #2f6407; + --pc-action-text: var(--lf-white); + --pc-accent: var(--lf-yellow); + --pc-ratio: 16 / 9; + + display: grid; + grid-template-columns: minmax(0, 1fr); + grid-template-rows: auto 1fr; + min-inline-size: 0; + inline-size: 100%; + color: var(--color-text); + background: var(--pc-surface); + border: 1px solid var(--color-border); + border-radius: var(--radius-panel); + box-shadow: var(--shadow-raised); + font: 400 1rem/1.55 var(--font-reading); + overflow-wrap: anywhere; +} + +.lf-pc--square { --pc-ratio: 1 / 1; } +.lf-pc--portrait { --pc-ratio: 3 / 4; } +.lf-pc--landscape { --pc-ratio: 16 / 9; } +.lf-pc--without-visual { grid-template-rows: 1fr; } + +/* Gleiche Höhe je Zeile (Höhe „An die Zeile angleichen“): Karte füllt den gestreckten Platz. */ +.widget-height-fill > .lf-pc { + flex: 1 1 auto; +} + +.lf-pc__visual { + position: relative; + min-inline-size: 0; + align-self: start; + margin: 10px 10px 0; +} + +.lf-pc__image { + display: block; + inline-size: 100%; + block-size: auto; + aspect-ratio: var(--pc-ratio); + /* Breite gestapelte Karten (zum Beispiel 4 Einheiten, Hochformat) würden sonst über 1000 px hoch: Das Bild wird + begrenzt, „Ganzes Bild“ bleibt vollständig (Rand), „Ausschnitt“ folgt dem Bildfokus. Text wird nie begrenzt. */ + max-block-size: min(70vh, 640px); + object-fit: cover; + object-position: var(--pc-focus-x, 66%) var(--pc-focus-y, 45%); + border-radius: var(--radius-card); + background: var(--pc-subtle); +} + +.lf-pc--contain .lf-pc__image { + object-fit: contain; + padding: 8px; +} + +.lf-pc__badge { + position: absolute; + inset: 12px auto auto 12px; + max-inline-size: calc(100% - 24px); + padding: 5px 10px; + border-radius: var(--radius-pill); + color: var(--lf-navy); + background: var(--lf-white); + font-size: 0.75rem; + font-weight: 600; + line-height: 1.45; +} + +.lf-pc__body { + display: flex; + flex-direction: column; + align-items: start; + min-inline-size: 0; + padding: clamp(20px, 4.5cqi, 32px); + gap: 12px; +} + +.lf-pc__kind { + margin: 0; + color: var(--pc-action); + font-size: 0.75rem; + font-weight: 600; + letter-spacing: 0.06em; + text-transform: uppercase; +} + +.lf-pc .lf-pc__title { + margin: 0; + color: var(--color-heading); + font: 800 clamp(1.35rem, 4.6cqi, 1.75rem) / 1.18 var(--font-display); + letter-spacing: -0.025em; + text-wrap: balance; +} + +.lf-pc__summary { + margin: 0; + color: var(--color-text-muted); +} + +.lf-pc__meta { + display: flex; + flex-wrap: wrap; + gap: 6px 14px; + list-style: none; + padding: 0; + margin: 0; + color: var(--color-text-muted); + font-size: 0.875rem; +} + +.lf-pc__meta li { + min-inline-size: 0; + margin: 0; +} + +.lf-pc__footer { + margin-block-start: auto; + padding-block-start: 10px; + inline-size: 100%; + display: flex; + flex-direction: column; + gap: 12px; + align-items: start; +} + +.lf-pc__note { + margin: 0; + color: var(--color-text-muted); + font-size: 0.8125rem; +} + +.lf-pc__cta { + display: inline-flex; + align-items: center; + justify-content: center; + min-block-size: 44px; + max-inline-size: 100%; + padding: 10px 18px; + border: 1px solid transparent; + border-radius: var(--radius-pill); + background: var(--pc-action); + color: var(--pc-action-text); + font-weight: 600; + font-size: 0.9375rem; + line-height: 1.4; + text-decoration: none; + text-align: center; + white-space: normal; + transition: background-color 0.15s ease; +} + +.lf-pc__cta:visited { color: var(--pc-action-text); } +.lf-pc__cta:hover { background: var(--pc-action-hover); color: var(--pc-action-text); } +.lf-pc__cta:focus-visible { outline: 3px solid var(--color-focus); outline-offset: 4px; } + +/* Redaktionell: ruhige Textverlinkung mit gelber Unterstreichung. */ +.lf-pc--editorial .lf-pc__cta { + padding-inline: 0; + background: transparent; + color: var(--color-heading); + border-radius: 4px; + text-align: start; + text-decoration: underline; + text-decoration-color: var(--pc-accent); + text-decoration-thickness: 3px; + text-underline-offset: 7px; +} + +.lf-pc--editorial .lf-pc__cta:visited { color: var(--color-heading); } +.lf-pc--editorial .lf-pc__cta:hover { background: transparent; color: var(--color-heading); text-decoration-color: currentColor; } + +/* Medien und Material: Metadatenband, grüne Aktion. */ +.lf-pc--media .lf-pc__meta { + padding-block: 10px; + inline-size: 100%; + border-block: 1px solid var(--color-border); +} + +/* Programm und Modul: Navy-Tafel mit Art und gelbem Akzent, auch ohne Foto vollständig; Navy-Aktion. */ +.lf-pc__panel { + display: flex; + flex-direction: column; + justify-content: space-between; + gap: 20px; + min-block-size: 140px; + margin: 10px 10px 0; + padding: 24px; + border-radius: var(--radius-card); + background: var(--lf-navy); + color: var(--lf-white); +} + +.lf-pc__panel-label { + font: 800 1.6rem / 1.15 var(--font-display); +} + +.lf-pc__panel-accent { + display: block; + inline-size: 72px; + block-size: 10px; + color: var(--pc-accent); +} + +/* Film ohne freigegebenes Bild: Filmtafel (Navy, Filmstreifen-Symbol, kein Abspielsymbol – die Karte spielt nichts ab). */ +.lf-pc__panel-icon { + display: block; + inline-size: 44px; + block-size: 44px; + color: var(--pc-accent); +} + +/* Material (Dokument, Text, Hörstück …): ruhige Cremefläche mit Materialsymbol statt Foto. */ +.lf-pc__panel--material { + background: var(--pc-subtle); + color: var(--lf-navy); + border: 1px solid var(--color-border); +} + +.lf-pc__panel--material .lf-pc__panel-icon { color: var(--lf-navy); } + +.lf-pc--material .lf-pc__meta { + padding-block: 10px; + inline-size: 100%; + border-block: 1px solid var(--color-border); +} + +/* Nur Redaktionsvorschau: Vorschaubild der Bibliothek ist markiert, weil es öffentlich nicht erscheint. */ +.lf-pc__library-flag { + position: absolute; + inset: auto 12px 12px auto; + max-inline-size: calc(100% - 24px); + padding: 4px 10px; + border-radius: var(--radius-pill); + color: var(--lf-white); + background: rgb(3 37 81 / 86%); + font-size: 0.75rem; + font-weight: 600; +} + +.lf-pc__editorial { + inline-size: 100%; + margin: 0; + font-size: 0.8125rem; +} + +.lf-pc__editorial summary { + cursor: pointer; + font-weight: 600; +} + +.lf-pc__editorial[open] summary { + margin-block-end: 0.4rem; +} + +.lf-pc__private-flag { + margin: 0; + padding: 3px 10px; + border-radius: var(--radius-pill); + background: var(--color-warning-surface, var(--lf-yellow-tint)); + color: var(--lf-navy); + font-size: 0.75rem; + font-weight: 600; +} + +.lf-pc__editorial p, +.lf-pc__editorial ul { + margin: 0 0 0.35rem; +} + +.lf-pc__editorial ul { + padding-inline-start: 1.1rem; +} + +.lf-pc--catalog .lf-pc__kind { color: var(--color-heading); } +.lf-pc--catalog .lf-pc__cta { background: var(--lf-navy); color: var(--lf-white); } +.lf-pc--catalog .lf-pc__cta:visited { color: var(--lf-white); } +.lf-pc--catalog .lf-pc__cta:hover { background: var(--lf-navy-deep); color: var(--lf-white); } + +/* Nur in der Redaktionsvorschau sichtbare Karte: gestrichelter Rand als Hinweis. */ +.lf-pc--internal { border-style: dashed; } + +/* Ab 520 px Kartenbreite (= Platzbreite) Bild oder Tafel neben dem Text, außer in der Variante „Bild immer oben“. */ +@container slot (min-width: 520px) { + .lf-pc:not(.lf-pc--without-visual, .lf-pc--stacked) { + grid-template-columns: minmax(0, 0.42fr) minmax(0, 0.58fr); + grid-template-rows: 1fr; + } + + .lf-pc:not(.lf-pc--stacked) .lf-pc__visual { + margin: 10px 0 10px 10px; + align-self: center; + display: flex; + } + + /* Neben dem Text wie ein Bild mittig, auch wenn die Karte auf Zeilenhöhe gestreckt ist. */ + .lf-pc:not(.lf-pc--stacked) .lf-pc__panel { + margin: 10px 0 10px 10px; + min-block-size: 220px; + align-self: center; + } + + .lf-pc--contain:not(.lf-pc--stacked) .lf-pc__visual { + align-items: center; + background: var(--pc-subtle); + border-radius: var(--radius-card); + } + + .lf-pc__body { padding: clamp(22px, 4cqi, 36px); } + .lf-pc .lf-pc__title { font-size: clamp(1.45rem, 3.4cqi, 2rem); } +} + +@media (prefers-reduced-motion: reduce) { + .lf-pc__cta { transition: none; } +} diff --git a/resources/css/sections.css b/resources/css/sections.css new file mode 100644 index 0000000..9c3b991 --- /dev/null +++ b/resources/css/sections.css @@ -0,0 +1,169 @@ +/* + * Abschnitte des Seiteneditors (Seite → Abschnitte → Slots → Widgets). + * Gestaltung nur über Aufzählungswerte; jede Fläche setzt die Bedeutungswerte neu (tokens.css). + * + * Responsive Regeln (siehe SectionLayouts::columns): + * - Abschnitt unter 40rem: alle Slots untereinander in Slot-Reihenfolge. + * - 40 bis 60rem: gleich breite Slots nebeneinander, ungleiche untereinander. + * - ab 60rem: Verhältnis der Rastereinheiten. + * Jeder Slot ist ein eigener Container; Widgets richten sich nach der Slotbreite, nicht nach dem Fenster. + */ + +.page-sections { + display: block; +} + +/* + * Abstände (Hülle Version 2): genau drei Werte je Abschnitt, keine weitere Vorgabe aus Seiten- oder Rasterhüllen. + * - oben/unten: Innenabstand des Abschnitts; zwischen zwei Abschnitten addieren sich „unten“ und „oben“ (0 + 0 = 0). + * Bei eigener Fläche liegen beide innerhalb der Fläche, damit Hintergründe nahtlos anschließen. + * - Widget-Abstand: Abstand zwischen den Plätzen des Rasters, nebeneinander und gestapelt. + * Abstände innerhalb eines Widgets (zum Beispiel zwischen Karten) bleiben im Widget (--grid-gap). + */ +.page-section { + position: relative; + isolation: isolate; + background: var(--color-surface); + color: var(--color-text); + padding-top: var(--section-space-top); + padding-bottom: var(--section-space-bottom); + --section-space-top: var(--section-space-compact); + --section-space-bottom: var(--section-space-compact); + --section-gap: var(--section-gap-normal); +} + +.section-space-top-none { --section-space-top: var(--section-space-none); } +.section-space-top-compact { --section-space-top: var(--section-space-compact); } +.section-space-top-normal { --section-space-top: var(--section-space-normal); } +.section-space-top-large { --section-space-top: var(--section-space-large); } +.section-space-bottom-none { --section-space-bottom: var(--section-space-none); } +.section-space-bottom-compact { --section-space-bottom: var(--section-space-compact); } +.section-space-bottom-normal { --section-space-bottom: var(--section-space-normal); } +.section-space-bottom-large { --section-space-bottom: var(--section-space-large); } +.section-gap-none { --section-gap: var(--section-gap-none); } +.section-gap-compact { --section-gap: var(--section-gap-compact); } +.section-gap-normal { --section-gap: var(--section-gap-normal); } +.section-gap-large { --section-gap: var(--section-gap-large); } + +.page-section-inner { + position: relative; + z-index: 1; + width: min(var(--section-width), 100% - 2 * var(--gutter)); + margin-inline: auto; + container-type: inline-size; + container-name: section; + --section-width: var(--container-standard); +} + +.section-width-narrow .page-section-inner { + --section-width: var(--container-narrow); +} + +.section-width-wide .page-section-inner { + --section-width: var(--container-wide); +} + +.section-width-full .page-section-inner { + --section-width: 100%; +} + +.section-grid { + display: grid; + gap: var(--section-gap); + grid-template-columns: minmax(0, 1fr); + align-items: start; +} + +@container section (min-width: 40rem) { + .section-grid { + grid-template-columns: var(--section-cols-md, minmax(0, 1fr)); + } +} + +@container section (min-width: 60rem) { + .section-grid { + grid-template-columns: var(--section-cols-lg, minmax(0, 1fr)); + } +} + +.section-slot { + min-width: 0; + container-type: inline-size; + container-name: slot; +} + +/* Flächen */ +.section-bg-light { + --color-surface: var(--color-surface-subtle); +} + +/* Dunkle Fläche und Markenakzent: Bedeutungswerte aus .scope-dark / .scope-accent (tokens.css). */ +.section-bg-dark, +.section-bg-accent { + background: var(--color-surface); +} + +/* Hintergrundbild mit Fokuspunkt (object-position) und Überlagerung für ausreichenden Kontrast. */ +.section-bg-image { + --color-surface: var(--lf-navy); + overflow: hidden; +} + +.page-section-image { + position: absolute; + inset: 0; + z-index: -2; + width: 100%; + height: 100%; + object-fit: cover; +} + +.section-bg-image::before { + content: ''; + position: absolute; + inset: 0; + z-index: -1; + pointer-events: none; +} + +.section-overlay-light::before { + background: rgb(255 255 255 / 84%); +} + +.section-overlay-dark::before { + background: rgb(3 37 81 / 78%); +} + +/* Ohne Überlagerung bleibt die Schrift dunkel; geeignet für Widgets mit eigener heller Fläche. */ +.section-overlay-none { + --color-surface: transparent; +} + +/* Trenner zwischen Abschnitten */ +.section-divider { + width: min(var(--container-standard), 100% - 2 * var(--gutter)); + margin-inline: auto; +} + +.section-divider-line { + padding-block: var(--space-5); +} + +.section-divider-line span { + display: block; + border-top: 1px solid var(--lf-line); +} + +.section-divider-accent { + display: flex; + justify-content: center; + padding-block: var(--space-2); +} + +.section-divider-accent span { + display: block; + width: 4.5rem; + height: 5px; + border-radius: 5px; + background: var(--lf-yellow); +} diff --git a/resources/css/site.css b/resources/css/site.css new file mode 100644 index 0000000..0dec335 --- /dev/null +++ b/resources/css/site.css @@ -0,0 +1,597 @@ +/* Globales Website-Gerüst: Kopfzeile, Hauptnavigation, mobile Navigation, Fußbereich, Seitenfläche. */ + +/* Wortmarke (vorläufiger Schriftzug, bis eine freigegebene Logodatei vorliegt). */ +.brand { + display: inline-flex; + flex-direction: column; + gap: 0.1rem; + color: var(--color-heading); + text-decoration: none; + line-height: 1; + min-height: var(--touch-target); + justify-content: center; +} + +.brand:hover { + color: var(--color-heading); +} + +.brand-name { + font-family: var(--font-display); + font-weight: 800; + font-size: 1.375rem; + letter-spacing: -0.02em; + white-space: nowrap; +} + +.brand-claim { + font-size: 0.8125rem; + font-weight: 600; + color: var(--color-text-muted); + white-space: nowrap; +} + +/* + * Freigegebene Wortmarke (Kompaktfassung, Brand-UI-Kit 08_freigegebene_logovarianten) in Kopfzeile und Fußbereich. + * Die Höhe ist ein Token je Ort; die Breite folgt dem Seitenverhältnis aus width/height im Markup. + */ +.brand-logo { + flex: none; + --brand-logo-height: 3rem; +} + +.brand-logo-image { + display: block; + width: auto; + height: var(--brand-logo-height); +} + +@media (min-width: 75rem) { + .site-header .brand-logo { + --brand-logo-height: 3.75rem; + } +} + +/* + * Kopfzeile. Die Box hat immer dieselbe Höhe (--header-height-initial) und klebt mit negativem Abstand. + * Die innere Leiste klebt oben: Beim Scrollen wandert sie um den Unterschied nach oben, danach bleibt + * genau die kompakte Leiste stehen. Der Seitenfluss ändert sich nie; ohne JavaScript funktioniert es genauso. + */ +.site-header-sentinel { + position: absolute; + top: 0; + left: 0; + width: 1px; + height: max(1px, var(--header-height-initial) - var(--header-height)); + pointer-events: none; +} + +.site-header { + position: sticky; + top: calc(var(--header-height) - var(--header-height-initial)); + z-index: 50; + height: var(--header-height-initial); + background: var(--lf-white); + box-shadow: 0 1px 0 var(--color-border); + transition: box-shadow 0.2s ease; +} + +.site-header.is-compact { + box-shadow: 0 1px 0 var(--color-border), 0 8px 22px rgb(3 37 81 / 8%); +} + +/* Außenabstand statt Innenabstand der Kopfzeile: Klebende Elemente bleiben in der Inhaltsbox ihres Elternelements. */ +.site-header-bar { + position: sticky; + top: 0; + height: var(--header-height); + margin-top: calc((var(--header-height-initial) - var(--header-height)) / 2); +} + +.site-header-inner { + display: flex; + align-items: center; + gap: var(--space-4) var(--space-6); + height: 100%; +} + +/* Großzügige Wortmarke im Ausgangszustand, kompakt beim Scrollen. Nur transform: keine Layoutverschiebung. */ +@media (min-width: 75rem) { + .site-header .brand-logo { + transform-origin: left center; + transform: scale(1.32); + transition: transform 0.22s ease; + } + + .site-header.is-compact .brand-logo { + transform: none; + } + + /* Platz für die skalierte Wortmarke, damit die Navigation nicht überdeckt wird. */ + .site-header .site-nav { + margin-left: var(--space-6); + } +} + +.site-header-actions { + display: flex; + align-items: center; + gap: var(--space-2); + margin-left: auto; + flex: none; +} + +.site-icon-link, +.site-menu-button { + display: inline-flex; + align-items: center; + justify-content: center; + gap: var(--space-2); + min-width: var(--touch-target); + min-height: var(--touch-target); + padding: 0 var(--space-4); + border: 2px solid var(--lf-navy); + border-radius: var(--radius-pill); + background: transparent; + color: var(--lf-navy); + font: inherit; + font-size: 1rem; + font-weight: 700; + white-space: nowrap; + text-decoration: none; + cursor: pointer; + transition: background-color 0.15s ease, color 0.15s ease; +} + +.site-icon-link:hover, +.site-menu-button:hover { + background: var(--lf-navy); + color: var(--lf-white); +} + +.site-icon-link svg, +.site-menu-button svg { + width: 1.25rem; + height: 1.25rem; + flex: none; +} + +/* Hauptnavigation (Desktop): eine Zeile, nie umbrechend. Passt sie nicht, schaltet site-nav.js in den Menümodus. */ +.site-nav-list, +.site-subnav { + list-style: none; + margin: 0; + padding: 0; +} + +.site-nav { + flex: 1 1 auto; + min-width: 0; +} + +.site-nav-list { + display: flex; + flex-wrap: nowrap; + align-items: center; + gap: 0 var(--space-1); +} + +.site-nav-item { + position: relative; + display: flex; + align-items: center; + flex: none; +} + +.site-nav a { + position: relative; + display: inline-flex; + align-items: center; + min-height: var(--touch-target); + padding: 0 0.55rem; + font-size: 1rem; + color: var(--lf-navy); + font-weight: 600; + white-space: nowrap; + text-decoration: none; + border-radius: var(--radius-small); +} + +.site-nav a:hover { + color: var(--lf-navy); + text-decoration: underline; + text-decoration-thickness: 2px; + text-underline-offset: 0.35em; +} + +/* Aktive Seite: gelbe Markenunterstreichung (Brand-Kit), zusätzlich aria-current für Hilfsmittel. */ +.site-nav-list > .site-nav-item > a[aria-current='page']::after, +.site-nav-list > .site-nav-item.is-active-trail > a::after { + content: ''; + position: absolute; + left: 0.55rem; + right: 0.55rem; + bottom: 0.2rem; + height: 0.3rem; + border-radius: 0.3rem; + background: var(--lf-yellow); + transform: rotate(-1deg); +} + +.site-nav-list > .site-nav-item > a[aria-current='page']:hover, +.site-nav-list > .site-nav-item.is-active-trail > a:hover { + text-decoration: none; +} + +.site-nav-toggle { + display: inline-flex; + align-items: center; + justify-content: center; + width: 2rem; + min-height: var(--touch-target); + margin-left: -0.4rem; + border: 0; + background: transparent; + color: var(--lf-navy); + cursor: pointer; + border-radius: var(--radius-small); +} + +.site-nav-toggle svg { + width: 1rem; + height: 1rem; + transition: transform 0.15s ease; +} + +.site-nav-toggle[aria-expanded='true'] svg { + transform: rotate(180deg); +} + +.site-subnav { + display: none; +} + +.site-subnav a { + width: 100%; +} + +.site-header:not(.is-menu-mode) .site-subnav { + position: absolute; + top: calc(100% + 0.25rem); + left: 0; + min-width: 15rem; + padding: var(--space-2); + background: var(--lf-white); + border: 1px solid var(--color-border); + border-radius: var(--radius-card); + box-shadow: var(--shadow-raised); +} + +.site-header:not(.is-menu-mode) .site-nav-item.is-open > .site-subnav { + display: block; +} + +.site-menu-button { + display: none; +} + +/* Kontozugang nur als Symbol: unter 75 rem und wenn die Navigation sonst nicht in eine Zeile passt. */ +.site-header.is-account-compact .site-account-label { + position: absolute; + width: 1px; + height: 1px; + overflow: hidden; + clip: rect(0 0 0 0); + white-space: nowrap; +} + +.site-header.is-account-compact .site-account-link { + padding: 0; +} + +@media (max-width: 74.99rem) { + .site-account-label { + position: absolute; + width: 1px; + height: 1px; + overflow: hidden; + clip: rect(0 0 0 0); + white-space: nowrap; + } + + .site-icon-link { + padding: 0; + } + + /* Ohne JavaScript: Navigation als umbrechende Liste unter der Leiste, Kopfzeile wächst mit. */ + html:not(.js) .site-header { + height: auto; + } + + html:not(.js) .site-header-bar { + position: static; + height: auto; + margin-top: 0; + } + + html:not(.js) .site-header-inner { + flex-wrap: wrap; + min-height: var(--header-height); + } + + html:not(.js) .site-nav { + order: 3; + flex-basis: 100%; + padding-bottom: var(--space-2); + } + + html:not(.js) .site-nav-list { + flex-wrap: wrap; + } +} + +/* + * Menümodus (mit JavaScript): unter 75 rem und immer dann, wenn die Navigation aus dem CMS nicht in eine Zeile passt. + * Die Menü-Schaltfläche öffnet eine Fläche unter der sichtbaren Leiste. Keine Navigation am unteren Bildschirmrand. + */ +.site-header.is-menu-mode .site-menu-button { + display: inline-flex; +} + +.site-header.is-menu-mode .site-nav { + display: none; + position: fixed; + inset: var(--site-menu-top, var(--header-height)) 0 0; + z-index: 49; + overflow-y: auto; + overscroll-behavior: contain; + margin: 0; + background: var(--lf-white); + padding: var(--space-4) var(--gutter) var(--space-8); + border-top: 1px solid var(--color-border); +} + +.site-header.is-menu-mode.is-menu-open .site-nav { + display: block; +} + +.site-header.is-menu-mode .site-nav-list { + display: block; +} + +.site-header.is-menu-mode .site-nav-item { + display: block; + border-bottom: 1px solid var(--color-border); +} + +.site-header.is-menu-mode .site-nav a { + min-height: 3rem; + font-size: 1.125rem; + width: 100%; + white-space: normal; +} + +.site-header.is-menu-mode .site-nav-list > .site-nav-item > a::after { + right: auto; + width: 3rem; +} + +.site-header.is-menu-mode .site-nav-toggle { + display: none; +} + +.site-header.is-menu-mode .site-subnav { + display: block; + padding: 0 0 var(--space-2) var(--space-4); +} + +.site-header.is-menu-mode .site-subnav a { + font-size: 1rem; + font-weight: 400; + min-height: var(--touch-target); +} + +body.has-open-menu { + overflow: hidden; +} + +/* Inhaltsfläche */ +.site-main { + display: block; + min-height: 50vh; +} + +/* Klassische Inhaltsseiten (Programme, Themen, Anmeldung): ein Blatt in Standardbreite. */ +.sheet { + width: min(var(--container-standard), 100% - 2 * var(--gutter)); + margin-inline: auto; + padding: clamp(1.5rem, 4vw, 3.5rem) 0 clamp(3rem, 6vw, 5rem); +} + +.sheet > .block + .block { + margin-top: var(--space-6); +} + +.themes { + list-style: none; + padding: 0; + margin: var(--space-5) 0 0; +} + +.themes li { + border-top: 1px solid var(--color-border); + padding: var(--space-4) 0; +} + +.themes a { + font-family: var(--font-display); + font-weight: 700; + font-size: var(--text-h3); + text-decoration: none; +} + +.themes p { + max-width: var(--measure); + margin: var(--space-1) 0 0; +} + +.catalog, +.course { + list-style: none; + padding: 0; + display: grid; + gap: var(--space-4); +} + +.catalog li, +.course li { + background: var(--color-surface-raised); + border: 1px solid var(--color-border); + border-radius: var(--radius-card); + padding: var(--space-4) var(--space-5); + display: grid; + gap: var(--space-2); +} + +.catalog video, +.course video { + width: min(100%, 40rem); + background: #111; +} + +.course h2 { + font-size: var(--text-h3); + margin: 0 0 var(--space-2); +} + +.course-actions { + display: flex; + flex-wrap: wrap; + gap: var(--space-2); +} + +/* Fußbereich: dunkle Markenfläche, Wortmarke, Linkgruppen aus dem CMS, grüner Bogen als Abschluss. */ +.site-footer { + position: relative; + overflow: hidden; + isolation: isolate; + background: var(--color-surface); + color: var(--color-text); + padding: clamp(3rem, 2rem + 4vw, 5rem) 0 0; + margin-top: 0; +} + +/* Endet die Seite mit einer dunklen Fläche, trennt eine feine Linie sie vom Fußbereich. */ +main:has(> .page-section.scope-dark:last-child) + .site-footer { + box-shadow: inset 0 1px 0 rgb(255 255 255 / 18%); +} + +.site-footer-inner { + display: grid; + gap: var(--space-6) var(--space-7); + padding-bottom: clamp(2.5rem, 2rem + 2vw, 3.5rem); +} + +@media (min-width: 48rem) { + .site-footer-inner { + grid-template-columns: minmax(13rem, 1.3fr) repeat(auto-fit, minmax(11rem, 1fr)); + } +} + +.site-footer .brand { + color: var(--color-heading); +} + +.site-footer .brand-logo { + --brand-logo-height: 4.5rem; +} + +.site-footer h2 { + font-family: var(--font-display); + font-size: 1.0625rem; + font-weight: 800; + letter-spacing: 0; + color: var(--color-heading); + margin: 0 0 var(--space-2); +} + +.site-footer ul { + list-style: none; + margin: 0; + padding: 0; +} + +.site-footer li a { + display: inline-flex; + align-items: center; + min-height: var(--touch-target); + color: var(--color-text-muted); + text-decoration: none; +} + +.site-footer li a:hover, +.site-footer li a[aria-current='page'] { + color: var(--color-link-hover); + text-decoration: underline; +} + +/* Grundzeile mit den rechtlichen Links; der Bogen läuft rechts darunter aus. */ +.site-footer-base { + position: relative; + z-index: 1; + border-top: 1px solid var(--color-border); + padding: var(--space-3) 0 clamp(3rem, 2rem + 4vw, 4.5rem); +} + +.site-footer-base ul { + display: flex; + flex-wrap: wrap; + gap: 0 var(--space-5); +} + +/* Helle Schrift: auf Navy 14:1, auf dem grünen Bogen 4,8:1. */ +.site-footer-base li a { + font-size: var(--text-small); + color: var(--color-text); +} + +/* Grün dunkel unter weißer Schrift: 5,2:1, auch wenn der Bogen Links berührt. */ +.site-footer-arc { + position: absolute; + right: 0; + bottom: 0; + z-index: -1; + width: min(46rem, 70%); + height: clamp(2.5rem, 1.5rem + 4vw, 5rem); + color: var(--lf-green-deep); +} + +.site-footer:not(:has(.site-footer-base)) .site-footer-inner { + padding-bottom: clamp(4rem, 3rem + 4vw, 6rem); +} + +/* Markenakzente (Brand-Kit 03_svg_entwuerfe, Entwürfe). Nur dekorativ, Farbe über Tokens. */ +.brand-underline { + display: block; + width: 100%; + height: 0.55em; + color: var(--color-accent); + overflow: visible; +} + +.brand-rays { + display: block; + width: 3.5rem; + height: auto; + color: var(--lf-yellow); +} + +/* Fußbereich schließt auch kurze Seiten am unteren Rand ab (nicht im Mitgliederbereich). */ +body:not(.member) { + display: flex; + flex-direction: column; +} + +body:not(.member) > main { + flex: 1 0 auto; +} diff --git a/resources/css/tokens.css b/resources/css/tokens.css new file mode 100644 index 0000000..72d02e5 --- /dev/null +++ b/resources/css/tokens.css @@ -0,0 +1,204 @@ +/* + * Lara & Felix – gemeinsames Designsystem, Ebene 1 und 2 (ADR-36, Website-Zielkonzept 7.1). + * + * VORLÄUFIG: Die Markenwerte stammen aus docs/Brand-UI-Kit/02_design_tokens (Entwurf vom 15.11.2026, + * aus den Originalmotiven abgeleitet, nicht freigegeben). Schriften nach Website-Zielkonzept 7.2 + * (Empfehlung, nicht freigegeben). Eine Freigabe ändert nur diese Datei. + * + * Regeln: + * - Komponenten und Widgets verwenden ausschließlich Bedeutungswerte (--color-text, --color-surface, …). + * - Markengelb nie als Textfarbe auf hellem Grund; Markengrün #5b8625 nur für Flächen ohne Text. + * - Abschnittsflächen (.section-bg-*) und Komponenten mit eigener Fläche setzen die Bedeutungswerte neu. + */ + +@theme { + --font-sans: 'Source Sans 3', 'Segoe UI', system-ui, sans-serif; + --font-display: 'Nunito', 'Trebuchet MS', 'Segoe UI', system-ui, sans-serif; +} + +:root { + /* Ebene 1: Markenwerte (vorläufig) */ + --lf-navy: #032551; + --lf-navy-deep: #01244c; + --lf-green: #5b8625; + --lf-green-deep: #3b7b09; + --lf-yellow: #fcd10a; + --lf-cream: #f7f6f2; + --lf-white: #ffffff; + --lf-ink: #15243a; + + /* Ergänzende UI-Werte (eigene Ableitung, Kontrast geprüft) */ + --lf-ink-muted: #3e4c5c; + --lf-line: #d5ddd6; + --lf-line-strong: #8a9a92; + --lf-focus: #1769aa; + --lf-green-tint: #e8f0de; + --lf-yellow-tint: #fff4d6; + + /* Ebene 2: Bedeutungswerte (heller Grund) */ + --color-text: var(--lf-ink); + --color-text-muted: var(--lf-ink-muted); + --color-heading: var(--lf-navy); + --color-link: var(--lf-navy); + --color-link-hover: var(--lf-green-deep); + --color-surface: var(--lf-white); + --color-surface-subtle: var(--lf-cream); + --color-surface-raised: var(--lf-white); + --color-border: var(--lf-line); + --color-border-strong: var(--lf-line-strong); + --color-focus: var(--lf-focus); + --color-accent: var(--lf-yellow); + --color-action: var(--lf-green-deep); + --color-action-hover: #2f6407; + --color-action-text: var(--lf-white); + --color-action-secondary-text: var(--lf-navy); + --color-success: #1b5e32; + --color-success-surface: #e5f4ec; + --color-warning: #6b4a00; + --color-warning-surface: var(--lf-yellow-tint); + --color-danger: #8e1b24; + --color-danger-surface: #fbe9ea; + --color-info: var(--lf-navy); + --color-info-surface: #e8eef6; + --color-disabled: #6b7682; + --color-disabled-surface: #eceeec; + + /* Themensignaturen der fünf Themenbereiche: vorbereitet, Tönungen und Symbole sind nicht freigegeben. + Bis zur Freigabe tragen Nummer und Name die Unterscheidung; alle Tönungen sind neutral. */ + --color-theme-1: var(--color-surface-subtle); + --color-theme-2: var(--color-surface-subtle); + --color-theme-3: var(--color-surface-subtle); + --color-theme-4: var(--color-surface-subtle); + --color-theme-5: var(--color-surface-subtle); + + /* Schriftvariablen der Kit-Komponenten (Brand-UI-Kit v1.6) zeigen auf die gemeinsamen Schriften. */ + --lf-font-display: var(--font-display); + --lf-font-ui: var(--font-reading); + --lf-muted: #46556b; + + /* Typografie (Website-Zielkonzept 7.2: Fließtext 17 → 18 px, H1 34 → 52 px) */ + --font-reading: var(--font-sans); + --text-small: 0.9375rem; + --text-body: clamp(1.0625rem, 1.03rem + 0.15vw, 1.125rem); + --text-lede: clamp(1.125rem, 1.05rem + 0.4vw, 1.3125rem); + --text-h3: clamp(1.25rem, 1.16rem + 0.4vw, 1.375rem); + --text-h2: clamp(1.625rem, 1.35rem + 1.2vw, 2.125rem); + --text-h1: clamp(2.125rem, 1.6rem + 2.4vw, 3.25rem); + --leading-body: 1.6; + --leading-heading: 1.15; + --measure: 70ch; + + /* Abstände (Grundmaß 4 px) */ + --space-1: 0.25rem; + --space-2: 0.5rem; + --space-3: 0.75rem; + --space-4: 1rem; + --space-5: 1.5rem; + --space-6: 2rem; + --space-7: 3rem; + --space-8: 4rem; + --space-9: 6rem; + + /* Rundungen und Schatten */ + --radius-small: 8px; + --radius-card: 14px; + --radius-panel: 22px; + --radius-pill: 999px; + --shadow-raised: 0 10px 28px rgb(3 37 81 / 8%); + + /* + * Breitenmodell (Designiteration 1). Vier semantische Stufen; die Abschnittsbreiten des Editors + * (narrow, standard, wide, full) zeigen auf sie. Hintergründe reichen immer über die ganze Fensterbreite, + * nur der Inhalt wird begrenzt. + * - Lesebereich: lange Texte, Formulare + * - Standard: Grundraster der Website; Kopfzeile, Fußbereich und Seiteninhalt fluchten hier + * - Breit: bildstarke Kompositionen auf großen Bildschirmen + * - Vollbreite: Inhalt bis an den Seitenrand (mit Randabstand) + */ + --gutter: clamp(1rem, 4vw, 2.5rem); + --grid-gap: clamp(1.25rem, 2.5vw, 2.25rem); + + /* Stufen der Abschnittsabstände (oben, unten) und des Widget-Abstands im Abschnittsraster (SectionStyle::SPACINGS). */ + --section-space-none: 0px; + --section-space-compact: clamp(1.5rem, 1rem + 2vw, 3rem); + --section-space-normal: clamp(3rem, 2rem + 4vw, 6rem); + --section-space-large: clamp(4.5rem, 3rem + 5vw, 8rem); + --section-gap-none: 0px; + --section-gap-compact: clamp(0.75rem, 1.25vw, 1.25rem); + --section-gap-normal: clamp(1.25rem, 2.5vw, 2.25rem); + --section-gap-large: clamp(2rem, 4vw, 3.5rem); + --width-reading: 44rem; + --width-standard: 82rem; + --width-wide: 96rem; + --container-narrow: var(--width-reading); + --container-standard: var(--width-standard); + --container-wide: var(--width-wide); + /* Linker Rand des Grundrasters innerhalb einer fensterbreiten Fläche (ohne 100vw, daher ohne Scrollbalken-Fehler). */ + --frame-inset: max(var(--gutter), (100% - var(--width-standard)) / 2); + + /* + * Kopfzeile: zwei Zustände bei unveränderter Box (kein Layoutsprung). Die Kopfzeile ist + * --header-height-initial hoch und klebt mit negativem Abstand, sodass beim Scrollen nur die + * kompakte Leiste (--header-height) sichtbar bleibt. Auf Smartphones sind beide Werte gleich. + */ + --header-height: 4rem; + --header-height-initial: 4rem; + --touch-target: 2.75rem; +} + +@media (min-width: 75rem) { + :root { + --header-height: 4.5rem; + --header-height-initial: 6.5rem; + } +} + +/* Dunkle Fläche: helle Schrift, gelber Fokus (Navy/Weiß 15:1). */ +.scope-dark { + --color-text: #f4f6f8; + --color-text-muted: #d3dde8; + --color-heading: var(--lf-white); + --color-link: var(--lf-white); + --color-link-hover: var(--lf-yellow); + --color-surface: var(--lf-navy); + --color-border: rgb(255 255 255 / 28%); + --color-border-strong: rgb(255 255 255 / 55%); + --color-focus: var(--lf-yellow); + --color-action: var(--lf-yellow); + --color-action-hover: #ffe05c; + --color-action-text: var(--lf-navy); + --color-action-secondary-text: var(--lf-white); +} + +/* Markenakzent: dunkles Grün mit weißer Schrift (5,2:1). */ +.scope-accent { + --color-text: var(--lf-white); + --color-text-muted: #eef4e8; + --color-heading: var(--lf-white); + --color-link: var(--lf-white); + --color-link-hover: var(--lf-yellow); + --color-surface: var(--lf-green-deep); + --color-border: rgb(255 255 255 / 35%); + --color-border-strong: rgb(255 255 255 / 65%); + --color-focus: var(--lf-yellow); + --color-action: var(--lf-white); + --color-action-hover: var(--lf-cream); + --color-action-text: var(--lf-navy); + --color-action-secondary-text: var(--lf-white); +} + +/* Heller Grund, zum Beispiel Karten auf dunklen Abschnitten. */ +.scope-light { + --color-text: var(--lf-ink); + --color-text-muted: var(--lf-ink-muted); + --color-heading: var(--lf-navy); + --color-link: var(--lf-navy); + --color-link-hover: var(--lf-green-deep); + --color-border: var(--lf-line); + --color-border-strong: var(--lf-line-strong); + --color-focus: var(--lf-focus); + --color-action: var(--lf-green-deep); + --color-action-hover: #2f6407; + --color-action-text: var(--lf-white); + --color-action-secondary-text: var(--lf-navy); +} diff --git a/resources/css/widgets.css b/resources/css/widgets.css new file mode 100644 index 0000000..3014288 --- /dev/null +++ b/resources/css/widgets.css @@ -0,0 +1,467 @@ +/* + * Widget-Ansichten der Bestandswidgets. Jede Regel verwendet Bedeutungswerte und richtet sich nach der Slotbreite + * (Container „slot“), nicht nach dem Fenster. Markenakzente (Unterstreichung, Strahlen) stammen aus + * resources/views/components/brand und sind dekorativ. + */ + +.widget { + min-width: 0; + color: var(--color-text); + overflow-wrap: break-word; +} + +/* + * Gemeinsamer Layoutvertrag (ADR-38): Höhe „fill“ streckt das Widget auf die Höhe der Abschnittszeile, wenn Plätze + * nebeneinander stehen. Gestapelt (schmaler Abschnitt) entspricht das der Inhaltshöhe. Inhalte werden nie begrenzt. + */ +.section-slot:has(> .widget-height-fill) { + align-self: stretch; + display: flex; + flex-direction: column; +} + +.section-slot > .widget-height-fill { + flex: 1 1 auto; + display: flex; + flex-direction: column; +} + +.widget-height-fill > .cta { + flex: 1 1 auto; + display: flex; + flex-direction: column; + justify-content: center; + align-items: flex-start; +} + +.widget > :last-child, +.widget .prose > :last-child { + margin-bottom: 0; +} + +/* Überschrift */ +.widget-heading h1, +.widget-heading h2 { + max-width: 22ch; +} + +/* Fließtext */ +.widget-prose .prose p { + margin: 0 0 var(--space-4); +} + +/* ------------------------------------------------------------------------------------------------ + * Redaktionelle Karten. Varianten: Raster (cards-grid), kompakte Liste (cards-compact), + * erste Karte hervorgehoben (cards-featured). Die ganze Karte ist über den Titellink klickbar. + * ---------------------------------------------------------------------------------------------- */ +.cards { + --card-surface: var(--lf-cream); + display: grid; + grid-template-columns: repeat(auto-fill, minmax(min(15rem, 100%), 1fr)); + gap: var(--grid-gap); + list-style: none; + padding: 0; + margin: 0; +} + +.section-bg-light .cards, +.scope-dark .cards, +.scope-accent .cards, +.section-bg-image .cards { + --card-surface: var(--lf-white); +} + +.card { + position: relative; + display: flex; + flex-direction: column; + background: var(--card-surface); + border-radius: var(--radius-card); + overflow: hidden; + color: var(--lf-ink); + --color-text: var(--lf-ink); + --color-text-muted: var(--lf-ink-muted); + --color-heading: var(--lf-navy); + --color-link: var(--lf-navy); + --color-focus: var(--lf-focus); +} + +.card-media { + aspect-ratio: 3 / 2; + overflow: hidden; + background: var(--lf-green-tint); +} + +.card-image { + display: block; + width: 100%; + height: 100%; + object-fit: cover; +} + +.card-body { + display: grid; + gap: var(--space-2); + padding: var(--space-5); +} + +.card-title { + font-size: clamp(1.1875rem, 1.1rem + 0.4cqi, 1.375rem); + line-height: 1.2; + margin: 0; +} + +.card-title a { + color: inherit; + text-decoration: none; +} + +/* Gestreckter Link: die ganze Karte ist klickbar, ein einziger Tabstopp. */ +.card-title a::after { + content: ''; + position: absolute; + inset: 0; + border-radius: inherit; +} + +.card-linked:hover .card-title a { + text-decoration: underline; + text-decoration-thickness: 2px; + text-underline-offset: 0.2em; +} + +.card-linked:has(a:focus-visible) { + outline: 3px solid var(--color-focus); + outline-offset: 3px; +} + +.card-title a:focus-visible { + outline: none; +} + +.card p { + margin: 0; + color: var(--color-text-muted); +} + +/* Karte ohne Bild: gelbe Markenkante oben. */ +.cards-grid .card:not(.card-with-image), +.cards-featured .card:not(.card-with-image) { + box-shadow: inset 0 5px 0 var(--lf-yellow); +} + +/* Hervorgehoben: Die erste Karte nimmt die ganze Zeile ein, ab 44rem Bild neben dem Text. */ +.cards-featured .card-lead { + grid-column: 1 / -1; +} + +.cards-featured .card-lead .card-title { + font-size: clamp(1.5rem, 1.1rem + 1.8cqi, 2.25rem); +} + +.cards-featured .card-lead .card-body { + padding: clamp(1.5rem, 4cqi, 3rem); + align-content: center; +} + +@container slot (min-width: 44rem) { + .cards-featured .card-lead.card-with-image { + display: grid; + grid-template-columns: minmax(0, 1.25fr) minmax(0, 1fr); + } + + .cards-featured .card-lead .card-media { + aspect-ratio: auto; + min-height: 20rem; + } +} + +/* Kompakte Liste: redaktionelle Zeilen mit Trennlinie, Bild klein rechts. */ +.cards-compact { + grid-template-columns: minmax(0, 1fr); + gap: 0; +} + +.cards-compact .card { + flex-direction: row-reverse; + align-items: center; + gap: var(--space-4); + border-radius: 0; + background: transparent; + border-top: 1px solid var(--color-border); + color: var(--color-text); + --color-text: inherit; + --color-heading: inherit; + --color-link: inherit; + --color-text-muted: inherit; + overflow: visible; +} + +.cards-compact .card:last-child { + border-bottom: 1px solid var(--color-border); +} + +.cards-compact .card-body { + flex: 1; + padding: var(--space-4) 0; +} + +.cards-compact .card p { + opacity: 0.88; +} + +.cards-compact .card-media { + flex: none; + width: clamp(4.5rem, 18cqi, 6.5rem); + aspect-ratio: 1; + margin-block: var(--space-3); + border-radius: var(--radius-small); +} + +/* ------------------------------------------------------------------------------------------------ + * Programm- und Modulkarten. Inhalte aus den Fachdaten; die Markentafel trägt die Art (Programm, Modul). + * Stufen: schmal gestapelt; ab 40rem Slotbreite bei einer Karte Tafel neben dem Text; Liste in „compact“. + * ---------------------------------------------------------------------------------------------- */ +.catalog-cards > h2 { + max-width: 22ch; +} + +.catalog-list { + display: grid; + grid-template-columns: repeat(auto-fill, minmax(min(17rem, 100%), 1fr)); + gap: var(--grid-gap); + list-style: none; + padding: 0; + margin: var(--space-5) 0 0; +} + +.catalog-cards > :first-child + .catalog-list, +.catalog-cards > .catalog-list:first-child { + margin-top: 0; +} + +.catalog-card { + position: relative; + display: flex; + flex-direction: column; + background: var(--lf-white); + border: 1px solid var(--lf-line); + border-radius: var(--radius-card); + overflow: hidden; + color: var(--lf-ink); + --color-text: var(--lf-ink); + --color-text-muted: var(--lf-ink-muted); + --color-heading: var(--lf-navy); + --color-link: var(--lf-navy); + --color-focus: var(--lf-focus); +} + +.catalog-card-visual { + position: relative; + display: flex; + align-items: flex-end; + min-height: 7rem; + padding: var(--space-4) var(--space-5); + background: var(--lf-navy); + border-bottom: 5px solid var(--lf-yellow); +} + +/* Auf dunklen Flächen trägt Grün dunkel die Tafel, damit sie sich vom Abschnitt abhebt. */ +.scope-dark .catalog-card-visual { + background: var(--lf-green-deep); +} + +.catalog-card-visual span { + font-family: var(--font-display); + font-weight: 800; + font-size: 1.25rem; + color: var(--lf-white); +} + +.catalog-card-rays { + position: absolute; + top: var(--space-4); + right: var(--space-5); + width: 2.75rem; +} + +.catalog-card-body { + display: grid; + gap: var(--space-2); + align-content: start; + padding: var(--space-5); +} + +.catalog-card-body h3 { + font-size: clamp(1.25rem, 1.15rem + 0.5cqi, 1.5rem); + line-height: 1.2; + margin: 0; +} + +.catalog-card-body h3 a { + color: inherit; + text-decoration: none; +} + +.catalog-card-linked h3 a::after { + content: ''; + position: absolute; + inset: 0; +} + +.catalog-card-linked:hover h3 a { + text-decoration: underline; + text-decoration-thickness: 2px; + text-underline-offset: 0.2em; +} + +.catalog-card-linked:has(a:focus-visible) { + outline: 3px solid var(--color-focus); + outline-offset: 3px; +} + +.catalog-card-linked h3 a:focus-visible { + outline: none; +} + +.catalog-card-body p { + margin: 0; + color: var(--color-text-muted); +} + +/* Die Art steht in der Tafel; für Hilfsmittel bleibt sie im Text erhalten. */ +.catalog-cards-standard .catalog-card-kind { + position: absolute; + width: 1px; + height: 1px; + overflow: hidden; + clip: rect(0 0 0 0); + white-space: nowrap; +} + +.catalog-card-kind { + font-size: var(--text-small); + font-weight: 700; + color: var(--lf-green-deep); + margin: 0; +} + +.catalog-cards[data-count='1'] .catalog-list { + grid-template-columns: minmax(0, 1fr); +} + +@container slot (min-width: 40rem) { + .catalog-cards-standard[data-count='1'] .catalog-card { + display: grid; + grid-template-columns: minmax(12rem, 1fr) minmax(0, 2fr); + } + + .catalog-cards-standard[data-count='1'] .catalog-card-visual { + border-bottom: 0; + border-right: 5px solid var(--lf-yellow); + min-height: 11rem; + } + + .catalog-cards-standard[data-count='1'] .catalog-card-body { + align-content: center; + padding: var(--space-6); + } +} + +.catalog-cards-compact .catalog-list { + grid-template-columns: minmax(0, 1fr); + gap: 0; +} + +.catalog-cards-compact .catalog-card { + border-width: 1px 0 0; + border-radius: 0; + background: transparent; + color: var(--color-text); + --color-text: inherit; + --color-text-muted: inherit; + --color-heading: inherit; + --color-link: inherit; + border-color: var(--color-border); + overflow: visible; +} + +.catalog-cards-compact .catalog-card:last-child { + border-bottom-width: 1px; +} + +.catalog-cards-compact .catalog-card-body { + padding: var(--space-4) 0; + gap: var(--space-1); +} + +.catalog-cards-compact .catalog-card-kind { + color: inherit; + opacity: 0.85; +} + +.catalog-card-internal { + border-style: dashed; +} + +/* Handlungsaufruf */ +.cta { + position: relative; + background: var(--color-surface-subtle); + border-radius: var(--radius-panel); + padding: clamp(1.5rem, 5cqi, 3rem); + color: var(--lf-ink); + --color-heading: var(--lf-navy); + --color-text: var(--lf-ink); + --color-link: var(--lf-navy); + --color-focus: var(--lf-focus); + --color-action: var(--lf-green-deep); + --color-action-hover: #2f6407; + --color-action-text: var(--lf-white); +} + +.section-bg-light .cta { + background: var(--lf-white); +} + +.cta h2 { + font-size: clamp(1.5rem, 1.1rem + 2cqi, 2.25rem); +} + +.cta p { + max-width: var(--measure); +} + +.cta a { + margin-top: var(--space-2); +} + +@container slot (max-width: 20rem) { + .cta a { + width: 100%; + } +} + +/* Häufige Fragen */ +.faq { + margin: 0; +} + +.faq dt { + font-family: var(--font-display); + font-weight: 700; + font-size: 1.125rem; + color: var(--color-heading); + padding-top: var(--space-4); + border-top: 1px solid var(--color-border); +} + +.faq dt:first-child { + border-top: 0; + padding-top: 0; +} + +.faq dd { + margin: var(--space-2) 0 var(--space-4); + max-width: var(--measure); +} diff --git a/resources/js/app.js b/resources/js/app.js new file mode 100644 index 0000000..3bc512a --- /dev/null +++ b/resources/js/app.js @@ -0,0 +1,94 @@ +import Hls from 'hls.js'; +import './site-nav.js'; + +function attachPlayback(video) { + if (!(video instanceof HTMLVideoElement) || video.dataset.playbackReady === '1') { + return; + } + + const source = video.dataset.hls; + + if (!source) { + return; + } + + video.dataset.playbackReady = '1'; + + if (Hls.isSupported()) { + const playback = new Hls(); + playback.loadSource(source); + playback.attachMedia(video); + + return; + } + + if (video.canPlayType('application/vnd.apple.mpegurl')) { + video.src = source; + } +} + +function scanPlayback(root) { + if (root instanceof HTMLVideoElement) { + attachPlayback(root); + } + + if (root instanceof Element) { + root.querySelectorAll('video[data-hls]').forEach(attachPlayback); + } +} + +scanPlayback(document); + +new MutationObserver((records) => { + records.forEach((record) => { + record.addedNodes.forEach((node) => { + if (node instanceof Element) { + scanPlayback(node); + } + }); + }); +}).observe(document.documentElement, { childList: true, subtree: true }); + +document.addEventListener('click', (event) => { + const fullscreen = event.target.closest('[data-fullscreen]'); + + if (fullscreen) { + const media = fullscreen.closest('.player')?.querySelector('video, audio'); + + if (media?.requestFullscreen) { + media.requestFullscreen(); + } + + return; + } + + const decision = event.target.closest('[data-course-decision]'); + const restart = event.target.closest('[data-course-restart]'); + const button = decision || restart; + + if (!button) { + return; + } + + const video = button.closest('li')?.querySelector('video'); + + if (!video) { + return; + } + + if (restart) { + video.currentTime = 0; + video.play(); + + return; + } + + const at = Number(video.dataset.decision); + + if (Number.isNaN(at)) { + return; + } + + video.currentTime = at; + video.pause(); +}); diff --git a/resources/js/site-nav.js b/resources/js/site-nav.js new file mode 100644 index 0000000..dc8d12a --- /dev/null +++ b/resources/js/site-nav.js @@ -0,0 +1,185 @@ +/** + * Website-Kopfzeile: Menümodus, mobile Navigation, Untermenüs und kompakter Zustand beim Scrollen. + * + * Breitenstufen der Kopfzeile (Messung inline in header.blade.php, window.lufHeaderMode): + * 1. Navigation und Kontozugang mit Beschriftung passen in eine Zeile. + * 2. Sonst: Kontozugang nur als Symbol (is-account-compact). + * 3. Sonst und immer unter 75 rem: Menümodus (is-menu-mode). + * So bricht die Navigation aus dem CMS nie um, und die Höhe der Kopfzeile bleibt auf allen Seiten gleich. + * Ohne JavaScript bleibt die Navigation als umbrechende Liste bedienbar (CSS: html:not(.js)). + */ +const BASELINE = window.matchMedia('(max-width: 74.99rem)'); + +function focusableIn(element) { + return [...element.querySelectorAll('a[href], button:not([disabled])')].filter((node) => node.offsetParent !== null); +} + +const isMenuMode = (header) => header.classList.contains('is-menu-mode'); + +function setupMenu(header) { + const button = header.querySelector('[data-site-menu-button]'); + const nav = header.querySelector('#site-nav'); + + if (!button || !nav) { + return () => {}; + } + + const label = button.querySelector('[data-menu-label]'); + const iconOpen = button.querySelector('[data-icon-open]'); + const iconClose = button.querySelector('[data-icon-close]'); + + const setOpen = (open, { restoreFocus = true } = {}) => { + if (open) { + // Die Fläche beginnt unter dem sichtbaren Teil der Kopfzeile, gleich in welchem Zustand. + header.style.setProperty('--site-menu-top', `${Math.max(0, Math.round(header.getBoundingClientRect().bottom))}px`); + } + header.classList.toggle('is-menu-open', open); + document.body.classList.toggle('has-open-menu', open); + button.setAttribute('aria-expanded', String(open)); + if (label) { + label.textContent = open ? 'Schließen' : 'Menü'; + } + iconOpen?.toggleAttribute('hidden', open); + iconClose?.toggleAttribute('hidden', !open); + + if (open) { + focusableIn(nav)[0]?.focus(); + } else if (restoreFocus) { + button.focus(); + } + }; + + button.addEventListener('click', () => setOpen(button.getAttribute('aria-expanded') !== 'true')); + + header.addEventListener('keydown', (event) => { + if (!header.classList.contains('is-menu-open')) { + return; + } + + if (event.key === 'Escape') { + event.preventDefault(); + setOpen(false); + + return; + } + + // Fokus bleibt in Menü-Schaltfläche und Menü, solange das Menü offen ist. Die Reihenfolge wird vollständig + // selbst gesteuert, weil die Schaltfläche im Quelltext hinter der Navigation steht (sonst springt Tab in den Inhalt). + if (event.key === 'Tab') { + const items = [button, ...focusableIn(nav)]; + const index = items.indexOf(document.activeElement); + const next = index === -1 ? 0 : (index + (event.shiftKey ? -1 : 1) + items.length) % items.length; + + event.preventDefault(); + items[next].focus(); + } + }); + + nav.addEventListener('click', (event) => { + if (event.target.closest('a[href]:not([data-site-subnav-label])') && header.classList.contains('is-menu-open')) { + setOpen(false, { restoreFocus: false }); + } + }); + + // Rückgabe: schließt das Menü, wenn der Menümodus endet. + return () => { + if (header.classList.contains('is-menu-open')) { + setOpen(false, { restoreFocus: false }); + } + }; +} + +/** + * Breitenstufen: Die Messung steht als window.lufHeaderMode inline direkt nach der Kopfzeile + * (components/site/header.blade.php), damit schon der erste Frame stimmt. Hier wird sie bei Größenänderungen, + * beim Wechsel über 75 rem und nach dem Laden der Schriften wiederholt. + */ +function setupMode(header, closeMenu) { + const apply = window.lufHeaderMode; + const inner = header.querySelector('.site-header-inner'); + + if (typeof apply !== 'function' || !inner) { + return; + } + + const update = () => { + if (apply(header) !== 'menu') { + closeMenu(); + } + }; + + update(); + new ResizeObserver(update).observe(inner); + BASELINE.addEventListener('change', update); + document.fonts?.ready.then(update); +} + +function setupSubmenus(header) { + const items = [...header.querySelectorAll('.site-nav-item.has-children')]; + + const close = (item, focusToggle = false) => { + item.classList.remove('is-open'); + const toggle = item.querySelector('[data-site-subnav-toggle]'); + toggle?.setAttribute('aria-expanded', 'false'); + if (focusToggle) { + toggle?.focus(); + } + }; + + items.forEach((item) => { + const toggle = item.querySelector('[data-site-subnav-toggle]'); + const label = item.querySelector('[data-site-subnav-label]'); + + const open = () => { + items.filter((other) => other !== item).forEach((other) => close(other)); + item.classList.add('is-open'); + toggle?.setAttribute('aria-expanded', 'true'); + }; + + toggle?.addEventListener('click', () => (item.classList.contains('is-open') ? close(item) : open())); + label?.addEventListener('click', (event) => { + event.preventDefault(); + item.classList.contains('is-open') ? close(item) : open(); + }); + + item.addEventListener('keydown', (event) => { + if (event.key === 'Escape' && item.classList.contains('is-open')) { + event.stopPropagation(); + close(item, true); + } + }); + + item.addEventListener('focusout', (event) => { + if (!isMenuMode(header) && !item.contains(event.relatedTarget)) { + close(item); + } + }); + }); + + document.addEventListener('click', (event) => { + items.filter((item) => !item.contains(event.target)).forEach((item) => close(item)); + }); +} + +/** + * Kompakter Zustand: Sobald der Bereich über der kompakten Leiste aus dem Bild gescrollt ist, wird die Wortmarke + * verkleinert und ein Schatten gesetzt. Die Höhe im Seitenfluss ändert sich dabei nicht. + */ +function setupCompact(header) { + const sentinel = document.querySelector('[data-site-header-sentinel]'); + + if (!sentinel || !('IntersectionObserver' in window)) { + return; + } + + new IntersectionObserver(([entry]) => { + header.classList.toggle('is-compact', !entry.isIntersecting); + }).observe(sentinel); +} + +document.querySelectorAll('[data-site-header]').forEach((header) => { + const closeMenu = setupMenu(header); + setupMode(header, closeMenu); + setupSubmenus(header); + setupCompact(header); +}); diff --git a/resources/views/auth/forgot-password.blade.php b/resources/views/auth/forgot-password.blade.php new file mode 100644 index 0000000..7e86a6c --- /dev/null +++ b/resources/views/auth/forgot-password.blade.php @@ -0,0 +1,17 @@ +@extends('layouts.site') + +@section('title', 'Passwort vergessen') + +@section('content') +

Passwort zurücksetzen

+
+ @csrf + + @error('email') +

{{ $message }}

+ @enderror + +
+@endsection diff --git a/resources/views/auth/login.blade.php b/resources/views/auth/login.blade.php new file mode 100644 index 0000000..8ea3d02 --- /dev/null +++ b/resources/views/auth/login.blade.php @@ -0,0 +1,29 @@ +@extends('layouts.site') + +@section('title', 'Anmelden') + +@section('content') +

Anmelden

+ @if ($errors->any()) + + @endif +
+ @csrf + + + + +
+

Passwort vergessen

+@endsection diff --git a/resources/views/auth/register.blade.php b/resources/views/auth/register.blade.php new file mode 100644 index 0000000..d0b28eb --- /dev/null +++ b/resources/views/auth/register.blade.php @@ -0,0 +1,35 @@ +@extends('layouts.site') + +@section('title', 'Registrieren') + +@section('content') +

Registrieren

+

Die Plattform ist für Erwachsene, die Präventionsangebote durchführen. Kinder brauchen kein Konto.

+ @if ($errors->any()) + + @endif +
+ @csrf + + + + + + +
+@endsection diff --git a/resources/views/auth/reset-password.blade.php b/resources/views/auth/reset-password.blade.php new file mode 100644 index 0000000..f22fae2 --- /dev/null +++ b/resources/views/auth/reset-password.blade.php @@ -0,0 +1,28 @@ +@extends('layouts.site') + +@section('title', 'Neues Passwort') + +@section('content') +

Neues Passwort

+
+ @csrf + + + + + @if ($errors->any()) + + @endif + +
+@endsection diff --git a/resources/views/auth/verify-email.blade.php b/resources/views/auth/verify-email.blade.php new file mode 100644 index 0000000..0a5d519 --- /dev/null +++ b/resources/views/auth/verify-email.blade.php @@ -0,0 +1,12 @@ +@extends('layouts.site') + +@section('title', 'E-Mail bestätigen') + +@section('content') +

E-Mail bestätigen

+

Wir haben Ihnen eine Nachricht geschickt. Der Mitgliederbereich öffnet sich, sobald die Adresse bestätigt ist.

+
+ @csrf + +
+@endsection diff --git a/resources/views/components/brand/arc.blade.php b/resources/views/components/brand/arc.blade.php new file mode 100644 index 0000000..9cdf280 --- /dev/null +++ b/resources/views/components/brand/arc.blade.php @@ -0,0 +1,2 @@ +{{-- Markenakzent „Bogen“: grüne Schwungfläche als Abschluss dunkler Flächen (nach dem Homepage-Entwurf des Brand-Kits). Dekorativ. --}} +class(['brand-arc']) }} viewBox="0 0 400 120" preserveAspectRatio="none" aria-hidden="true" focusable="false"> diff --git a/resources/views/components/brand/rays.blade.php b/resources/views/components/brand/rays.blade.php new file mode 100644 index 0000000..611bdcc --- /dev/null +++ b/resources/views/components/brand/rays.blade.php @@ -0,0 +1,2 @@ +{{-- Markenakzent „Signalstrahlen“ (Brand-Kit 03_svg_entwuerfe/yellow-rays.svg, Entwurf). Dekorativ; nie an der Wortmarke. --}} +class(['brand-rays']) }} viewBox="0 0 100 85" aria-hidden="true" focusable="false"> diff --git a/resources/views/components/brand/underline.blade.php b/resources/views/components/brand/underline.blade.php new file mode 100644 index 0000000..2ade83c --- /dev/null +++ b/resources/views/components/brand/underline.blade.php @@ -0,0 +1,2 @@ +{{-- Markenakzent „Unterstreichung“ (Brand-Kit 03_svg_entwuerfe/yellow-underline.svg, Entwurf). Dekorativ, Farbe über currentColor. --}} +class(['brand-underline']) }} viewBox="0 0 280 28" preserveAspectRatio="none" aria-hidden="true" focusable="false"> diff --git a/resources/views/components/site/brand.blade.php b/resources/views/components/site/brand.blade.php new file mode 100644 index 0000000..9596f33 --- /dev/null +++ b/resources/views/components/site/brand.blade.php @@ -0,0 +1,24 @@ +{{-- + Wortmarke. + - variant „logo“ (Website-Kopfzeile und Fußbereich): freigegebene Lara-&-Felix-Wortmarke, Kompaktfassung aus + docs/Brand-UI-Kit/08_freigegebene_logovarianten/logo_lara_felix_kompakt.png (Freigabe 18.11.2026). Eingebunden + sind zugeschnittene WebP-Ableitungen unter public/images/brand; die Originaldatei bleibt unverändert. + Breite und Höhe stehen im Markup, damit die Kopfzeile vor dem Laden des Bildes richtig misst (kein Layoutsprung). + - variant „plain“ (Mitgliederbereich): Schriftzug mit Zusatz, unverändert. + Eine spätere Vektorfassung wird ausschließlich hier ausgetauscht. +--}} +@props(['href' => null, 'claim' => 'Stark im Alltag', 'variant' => 'plain']) +@if ($variant === 'logo') + class(['brand', 'brand-logo']) }} href="{{ $href ?? route('home') }}" data-brand-status="freigegeben"> + Lara & Felix – Stark im Alltag + +@else + class(['brand']) }} href="{{ $href ?? route('home') }}" data-brand-status="vorlaeufig"> + Lara & Felix + {{ $claim }} + +@endif diff --git a/resources/views/components/site/cart-link.blade.php b/resources/views/components/site/cart-link.blade.php new file mode 100644 index 0000000..85576e3 --- /dev/null +++ b/resources/views/components/site/cart-link.blade.php @@ -0,0 +1,10 @@ +{{-- + Vorbereiteter Warenkorbzugang. Der Warenkorb gehört zum kommerziellen Anwendungssystem, nicht zum CMS. + Solange cms.cart.enabled nicht gesetzt ist, wird nichts ausgegeben: kein funktionsloser Kaufknopf. +--}} +@if (config('cms.cart.enabled') && filled(config('cms.cart.url'))) + + +@endif diff --git a/resources/views/components/site/footer.blade.php b/resources/views/components/site/footer.blade.php new file mode 100644 index 0000000..662447c --- /dev/null +++ b/resources/views/components/site/footer.blade.php @@ -0,0 +1,51 @@ +@props(['navigation', 'path' => null]) +@php + $groups = collect(\App\Domain\Cms\SiteNavigation::forPath($navigation, $path ?? request()->path())->footerGroups()); + $legal = $groups->firstWhere('key', 'footer_legal'); + $columns = $groups->reject(fn (array $group): bool => $group['key'] === 'footer_legal'); + $themes = \App\Domain\Catalog\Pillar::query()->published()->get(['id', 'name', 'slug']); +@endphp +{{-- + Fußbereich: Links aus der CMS-Navigation (Plätze „Fußbereich: …“) und die veröffentlichten Themenbereiche. + Keine eigene Inhaltsverwaltung, keine erfundenen Kontakt- oder Rechtstexte. „Rechtliches“ steht in der Grundzeile. +--}} +
+ + @if ($legal) + + @endif + +
diff --git a/resources/views/components/site/header.blade.php b/resources/views/components/site/header.blade.php new file mode 100644 index 0000000..3e195e2 --- /dev/null +++ b/resources/views/components/site/header.blade.php @@ -0,0 +1,82 @@ +@props(['navigation', 'path' => null]) +@php + $entries = \App\Domain\Cms\SiteNavigation::forPath($navigation, $path ?? request()->path())->header(); +@endphp +{{-- + Globale Kopfzeile. Gleiche Ausgabe für Gäste und Mitglieder (ADR-32): Der Kontozugang führt zum Mitgliederbereich, + der bei Bedarf zur Anmeldung leitet. + Geometrie: Die Box ist immer --header-height-initial hoch und klebt mit negativem Abstand; die innere Leiste + klebt oben. Beim Scrollen bleibt nur die kompakte Leiste sichtbar, ohne dass sich die Höhe im Seitenfluss ändert. +--}} + + +{{-- + Breitenstufen vor dem ersten Zeichnen setzen (läuft nach dem Laden des Stylesheets, vor dem Zeichnen): + full = Navigation und beschrifteter Kontozugang passen in eine Zeile, icon = Kontozugang nur als Symbol, + menu = Menümodus (immer unter 75 rem). Gemessen wird die Desktop-Darstellung an der echten Navigation; + resources/js/site-nav.js ruft dieselbe Funktion bei Größenänderungen und nach dem Laden der Schriften erneut auf. +--}} + diff --git a/resources/views/components/vw/eintrag.blade.php b/resources/views/components/vw/eintrag.blade.php new file mode 100644 index 0000000..0164ec3 --- /dev/null +++ b/resources/views/components/vw/eintrag.blade.php @@ -0,0 +1,35 @@ +{{-- + Gemeinsamer Eintrag (Dokument 14 §3 und §9): kleine Vorschau, Titel, Typzeile. Genutzt vom Picker und von allen + Bestandslisten. Das ganze Element ist ein Link oder Knopf ($as), damit Bild und Titel dieselbe Handlung auslösen. + Weitere Inhalte (Kurztext, Chips) kommen über den Slot in den Textbereich. +--}} +@props([ + 'titel', + 'meta' => null, + 'bild' => null, + 'bildNotiz' => null, + 'bildFehlt' => null, + 'bildAlt' => '', + 'symbol' => 'dokument', + 'titelId' => null, + 'as' => 'a', +]) +<{{ $as }} {{ $attributes->class('vw-eintrag') }}> + + @if (filled($bild)) + {{ $bildAlt }} + @else + @include('filament.verwaltung.icon', ['name' => $symbol])@if (filled($bildFehlt)){{ $bildFehlt }}@endif + @endif + @if (filled($bildNotiz)) + {{ $bildNotiz }} + @endif + + + {{ $titel }} + @if (filled($meta)) + {{ $meta }} + @endif + {{ $slot }} + + diff --git a/resources/views/content/player.blade.php b/resources/views/content/player.blade.php new file mode 100644 index 0000000..20a0c05 --- /dev/null +++ b/resources/views/content/player.blade.php @@ -0,0 +1,32 @@ +@php + $metadata = is_array($version->metadata) ? $version->metadata : []; + $class = $version->element->output_class; + $poster = \App\Domain\Media\ThumbnailRef::url('editorial.card', 'element', $version->element->id, $version->element->thumbnail_path); + $playback = $class === 'film' ? app(\App\Http\Controllers\ContentPreviewController::class)->playback($version) : null; +@endphp + +@if ($class === 'film' && $playback) + @include('content.video', ['playback' => $playback, 'poster' => $poster, 'style' => 'width: 100%; max-height: 70vh; background: #111;']) + @if ($fileUrl) +

Datei öffnen

+ @endif +@elseif ($fileUrl) + @if ($class === 'audio') + + @elseif ($class === 'bild') + {{ $version->element->working_title }} + @else + + @endif +

Datei öffnen

+@elseif ($pending) +

Die Datei wird noch übernommen.

+@elseif (is_string($metadata['file'] ?? null)) +

Für Fassung {{ $version->number }} ist eine Datei vorgemerkt, sie liegt aber nicht vor.

+@endif + +@if (filled($version->body)) +
+ {!! nl2br(e($version->body)) !!} +
+@endif diff --git a/resources/views/content/preview.blade.php b/resources/views/content/preview.blade.php new file mode 100644 index 0000000..81eb063 --- /dev/null +++ b/resources/views/content/preview.blade.php @@ -0,0 +1,14 @@ +@extends('layouts.site') + +@section('title', $version->element->working_title) + +@section('content') +

{{ $version->element->working_title }}

+

Fassung {{ $version->number }}, nur für die Verwaltung.

+ @include('content.player', ['version' => $version, 'fileUrl' => $fileUrl, 'pending' => $pending]) + @if (! $fileUrl && ! $pending && blank($version->body)) +
+

Für diese Fassung liegt noch kein lesbarer Text und keine übernommene Datei vor.

+
+ @endif +@endsection diff --git a/resources/views/content/video.blade.php b/resources/views/content/video.blade.php new file mode 100644 index 0000000..430adb1 --- /dev/null +++ b/resources/views/content/video.blade.php @@ -0,0 +1,6 @@ + diff --git a/resources/views/filament/catalog/objekt.blade.php b/resources/views/filament/catalog/objekt.blade.php new file mode 100644 index 0000000..673ff9a --- /dev/null +++ b/resources/views/filament/catalog/objekt.blade.php @@ -0,0 +1,59 @@ +{{-- + Gemeinsame Katalog-Objektseite (Angebot, Paket, Rechteprofil): gemeinsamer Kopf, Hauptabschnitte links, + Begleitinformation rechts. Parameter: + kopf Parameter für filament.verwaltung.kopf + haupt Liste ['titel', 'zusatz' => kleiner Titelzusatz, 'hilfe', 'zeilen' => [['text', 'neben']], 'leer' => ['titel', 'text']] + seite Liste ['titel', 'zeilen' => [['text', 'zustand' => ['label', 'ton'], 'neben']], 'hilfe', 'leer' => Text] +--}} +
+ @include('filament.verwaltung.kopf', $kopf) + +
+
+ @foreach ($haupt as $abschnitt) +
+

{{ $abschnitt['titel'] }}@if (filled($abschnitt['zusatz'] ?? null)) · {{ $abschnitt['zusatz'] }}@endif

+ @if (filled($abschnitt['hilfe'] ?? null)) +

{{ $abschnitt['hilfe'] }}

+ @endif + @if (($abschnitt['zeilen'] ?? []) === [] && ! empty($abschnitt['leer'])) +
+ {{ $abschnitt['leer']['titel'] }} +

{{ $abschnitt['leer']['text'] }}

+
+ @elseif (($abschnitt['zeilen'] ?? []) !== []) +
    + @foreach ($abschnitt['zeilen'] as $zeile) +
  • {{ $zeile['text'] }}@if (filled($zeile['neben'] ?? null)) {{ $zeile['neben'] }}@endif
  • + @endforeach +
+ @endif +
+ @endforeach +
+ + +
+
diff --git a/resources/views/filament/cms/bild-feld.blade.php b/resources/views/filament/cms/bild-feld.blade.php new file mode 100644 index 0000000..7e72d96 --- /dev/null +++ b/resources/views/filament/cms/bild-feld.blade.php @@ -0,0 +1,23 @@ +{{-- Bildfeld im CMS: Auswahl über den gemeinsamen Picker (ChoosesWebsiteImages); Status zeigt das Feld „Gewähltes Bild“. --}} +@php + $wert = $getState(); + $pfad = $getStatePath(); + $mitPicker = method_exists($getLivewire(), 'openWebsiteImagePicker'); +@endphp + +
+ @if (blank($wert)) + Kein Bild gewählt. + @endif + @if ($mitPicker) + + {{ blank($wert) ? 'Bild auswählen' : 'Anderes Bild wählen' }} + + @endif + @if (filled($wert)) + + Bild entfernen + + @endif +
+
diff --git a/resources/views/filament/cms/bild-picker.blade.php b/resources/views/filament/cms/bild-picker.blade.php new file mode 100644 index 0000000..c135e31 --- /dev/null +++ b/resources/views/filament/cms/bild-picker.blade.php @@ -0,0 +1,4 @@ +{{-- Gemeinsamer Picker für Website-Bilder im CMS (ChoosesWebsiteImages). --}} +@if ($this->pickerOpen && $this->pickerPurpose === 'website-bild') + @include('filament.verwaltung.picker') +@endif diff --git a/resources/views/filament/cms/menue-detail.blade.php b/resources/views/filament/cms/menue-detail.blade.php new file mode 100644 index 0000000..c672bc3 --- /dev/null +++ b/resources/views/filament/cms/menue-detail.blade.php @@ -0,0 +1,106 @@ +{{-- Detailbereich eines Menüeintrags (WEB-R03/R04): Menütext, Ziel, Ebene, Sichtbarkeit und Bereich. Nur einmal im DOM. --}} +@php + $e = $this->eintraege[$k]; + $name = trim($e['label']) ?: 'Ohne Menütext'; + $ziel = $this->zielVon($k); + $kinder = $this->kinderVon($k); + $eltern = $this->elternVon($k); + $elternName = $eltern !== null ? (trim($this->eintraege[$eltern]['label']) ?: 'Ohne Menütext') : null; + $fehler = fn (string $feld) => $errors->first("eintraege.$k.$feld"); +@endphp +{{-- Eigener Schlüssel je Eintrag: Beim Wechsel entstehen die Felder neu, statt am vorigen Eintrag gebunden zu bleiben. --}} +
+
+
+

Menüeintrag: {{ $e['id'] === null && trim($e['label']) === '' ? 'Neuer Eintrag' : $name }}

+

{{ $this->bereichsName($e['placement']) }}@if ($elternName) · unter „{{ $elternName }}“@endif @if ($e['id'] === null) · neu, noch nicht gespeichert @endif

+
+ +
+ +
+
$fehler('label')])> + + + + @if ($fehler('label'))

{{ $fehler('label') }}

@endif +
+ +
$fehler('url') || $fehler('page_id')])> + Ziel + @if ($ziel['art'] === 'seite') +
+ @include('filament.verwaltung.icon', ['name' => 'dokument']) + {{ $ziel['titel'] }}{{ $ziel['pfad'] }} + {{ $ziel['zustand']['label'] }} +
+
+ + @include('filament.verwaltung.icon', ['name' => 'extern'])Seite bearbeiten + +
+ @if ($ziel['zustand']['ton'] === 'offen') +

Diese Seite ist nicht veröffentlicht. Der Menüeintrag führt öffentlich ins Leere, bis die Seite veröffentlicht ist. Die Auswahl hier veröffentlicht sie nicht.

+ @endif + @else + @if ($ziel['art'] === 'fehlt') +

Die bisherige Zielseite gibt es nicht mehr. Bitte ein neues Ziel wählen.

+ @endif + + +
+ +
+ + @endif + @foreach (['page_id', 'url'] as $feld) + @if ($fehler($feld))

{{ $fehler($feld) }}

@endif + @endforeach +
+ + @if ($e['placement'] === 'header') +
$fehler('parent')])> + + + + @if ($fehler('parent'))

{{ $fehler('parent') }}

@endif +
+ @endif + +
+ + +
+ +
$fehler('placement')])> + + + + @if ($fehler('placement'))

{{ $fehler('placement') }}

@endif +
+
+
diff --git a/resources/views/filament/cms/menue-zeile.blade.php b/resources/views/filament/cms/menue-zeile.blade.php new file mode 100644 index 0000000..d04ad0b --- /dev/null +++ b/resources/views/filament/cms/menue-zeile.blade.php @@ -0,0 +1,59 @@ +{{-- Eine Zeile des Menüeditors; in schmaler Anordnung folgt beim gewählten Eintrag der Detailbereich. --}} +@php + $e = $this->eintraege[$k]; + $name = trim($e['label']) ?: 'Ohne Menütext'; + $ziel = $this->zielVon($k); + $gewaehlt = $k === $auswahl; + $eltern = $this->elternVon($k); + $elternVerborgen = $eltern !== null && ! $this->eintraege[$eltern]['is_visible']; + $sichtbar = $e['is_visible'] && ! $elternVerborgen; + $hoch = $this->nachbar($k, 'hoch'); + $runter = $this->nachbar($k, 'runter'); + $zielText = match ($ziel['art']) { + 'seite', 'adresse' => $ziel['pfad'], + 'fehlt' => 'Zielseite fehlt', + default => $this->kinderVon($k) !== [] ? 'öffnet nur das Untermenü' : 'Kein Ziel', + }; +@endphp +
$gewaehlt, 'is-unter' => $unter, 'is-verborgen' => ! $sichtbar]) data-menue="{{ $k }}" + x-on:keydown.alt.up.prevent="$wire.verschiebe('{{ $k }}', 'hoch', true)" x-on:keydown.alt.down.prevent="$wire.verschiebe('{{ $k }}', 'runter', true)"> + + + + + @include('filament.verwaltung.icon', ['name' => $sichtbar ? 'auge' : 'auge-zu']) + {{ $sichtbar ? 'Im Menü sichtbar' : ($elternVerborgen && $e['is_visible'] ? 'Ausgeblendet mit „'.(trim($this->eintraege[$eltern]['label']) ?: 'Ohne Menütext').'“' : 'Im Menü ausgeblendet') }} + + + @if ($e['id'] === null) + Neu + @endif + @if (($ziel['zustand']['ton'] ?? null) === 'offen' || ($ziel['zustand']['ton'] ?? null) === 'achtung') + {{ $ziel['art'] === 'seite' ? 'Ziel nicht veröffentlicht' : $ziel['zustand']['label'] }} + @endif + @if ($schmal) + + + @endif + + + + + + + +
+ +
+
+
+
+@if ($schmal && $gewaehlt) +
+ @include('filament.cms.menue-detail', ['k' => $k]) +
+@endif diff --git a/resources/views/filament/cms/menues.blade.php b/resources/views/filament/cms/menues.blade.php new file mode 100644 index 0000000..cbadf4b --- /dev/null +++ b/resources/views/filament/cms/menues.blade.php @@ -0,0 +1,76 @@ +{{-- + Menüeditor (Dokument 13, Entwurf 1 und 3): Bei genügend Breite Menüliste links und ortsfester Detailbereich rechts, + sonst dieselben Felder in genau einem aufgeklappten Eintrag. Die Breite misst der Browser am Arbeitsbereich; der + Detailbereich existiert immer nur einmal. +--}} +@php + $bereich = $this->menue; + $baum = $this->baum($bereich); + $auswahl = $this->auswahl !== null && ($this->eintraege[$this->auswahl]['placement'] ?? null) === $bereich ? $this->auswahl : null; + $schmal = $this->schmal; + $anzahl = $this->anzahl($bereich); +@endphp +
$schmal, 'is-breit' => ! $schmal]) + x-data="{ pruefe(breite) { const schmal = breite < 900; if (breite > 0 && schmal !== $wire.schmal) $wire.set('schmal', schmal) } }" + x-init="pruefe($el.clientWidth); new ResizeObserver((e) => pruefe(e[0].contentRect.width)).observe($el)"> +
+
+
+ + + + {{ $anzahl }} {{ $anzahl === 1 ? 'Eintrag' : 'Einträge' }} + @can('create', \App\Domain\Cms\NavigationItem::class) + + @endcan +
+ + @if ($baum === []) +
+ {{ $this->bereichsName($bereich) }} ist leer +

Ohne Einträge erscheint dieser Bereich nicht auf der Website. „Eintrag hinzufügen“ legt den ersten an.

+
+ @else +
    + @foreach ($baum as $i => $knoten) +
  1. + @include('filament.cms.menue-zeile', ['k' => $knoten['k'], 'nummer' => $i + 1, 'unter' => false]) + @if ($knoten['kinder'] !== []) +
      + @foreach ($knoten['kinder'] as $kind) +
    1. + @include('filament.cms.menue-zeile', ['k' => $kind, 'nummer' => null, 'unter' => true]) +
    2. + @endforeach +
    + @endif +
  2. + @endforeach +
+ @endif + + @if (! $schmal && $auswahl !== null) + @php($name = trim($this->eintraege[$auswahl]['label']) ?: 'Ohne Menütext') +
+ Reihenfolge für „{{ $name }}“ ändern: + + +
+ @endif +
+ + @unless ($schmal) +
+ @if ($auswahl !== null) + @include('filament.cms.menue-detail', ['k' => $auswahl]) + @else +

Wählen Sie links einen Eintrag, um Menütext, Ziel, Sichtbarkeit und Platz zu bearbeiten.

+ @endif +
+ @endunless +
+
diff --git a/resources/views/filament/cms/seite-kopf.blade.php b/resources/views/filament/cms/seite-kopf.blade.php new file mode 100644 index 0000000..7cbe42c --- /dev/null +++ b/resources/views/filament/cms/seite-kopf.blade.php @@ -0,0 +1,108 @@ +{{-- Kopf des Seiten-Arbeitsplatzes (Dokument 12, CMS-R01): Speicherzustand und öffentliche Revision getrennt. --}} +@php + /** @var \App\Domain\Cms\Page $seite */ + $neueste = $seite->latestRevision; + $oeffentlich = $seite->publishedRevision; + $entwurfStatus = match (true) { + $ungespeichert => ['text' => 'Änderungen nicht gespeichert', 'ton' => 'offen'], + $neueste === null => ['text' => 'Noch kein gespeicherter Entwurf', 'ton' => 'neutral'], + $oeffentlich !== null && $neueste->id === $oeffentlich->id => ['text' => 'Gespeicherter Stand ist veröffentlicht (Revision '.$neueste->id.')', 'ton' => 'gut'], + default => ['text' => 'Entwurf gespeichert (Revision '.$neueste->id.')', 'ton' => 'neutral'], + }; + $oeffentlichStatus = $oeffentlich !== null + ? ['text' => 'Öffentlich: Revision '.$oeffentlich->id.($neueste !== null && $neueste->id !== $oeffentlich->id ? ' · der gespeicherte Entwurf ist neuer' : ''), 'ton' => 'gut'] + : ['text' => 'Noch nicht veröffentlicht', 'ton' => 'neutral']; + $aktionen = []; + if ($neueste !== null) { + $aktionen[] = ['label' => 'Seitenvorschau', 'href' => route('pages.preview.devices', $neueste), 'neu' => true, 'icon' => 'auge', 'art' => 'line']; + } + $aktionen[] = ['label' => 'Entwurf speichern', 'wire' => 'save', 'art' => 'primary']; + if (auth()->user()?->can('publish', $seite)) { + $aktionen[] = ['label' => 'Veröffentlichen …', 'wire' => "mountAction('publish')"]; + } + $mehr = []; + if ($seite->isPublished()) { + $mehr[] = ['label' => 'Live-Seite öffnen', 'href' => $seite->publicUrl(), 'neu' => true, 'hinweis' => 'Zeigt die veröffentlichte Revision.']; + } + $titel = $neueste?->contentTitle() ?: $seite->path; + $anzahlRevisionen = $seite->revisions()->count(); +@endphp +
+ @include('filament.verwaltung.kopf', [ + 'brot' => [['label' => 'Webpräsenz', 'href' => \App\Filament\Pages\Webpraesenz::getUrl()], $seite->path], + 'titel' => $titel, + 'status' => [$entwurfStatus, $oeffentlichStatus], + 'aktionen' => $aktionen, + 'mehr' => $mehr, + ]) +
+
+ @foreach (['inhalt' => 'Seiteninhalt', 'einstellungen' => 'Seiteneinstellungen', 'verlauf' => 'Verlauf'] as $wert => $label) + + @endforeach +
+ {{-- Erläuterungen gezielt aufrufbar statt als Dauertext. --}} +
+ @include('filament.verwaltung.icon', ['name' => 'info'])Hilfe +
+ @if ($this->register === 'einstellungen') +

Adresse, Suchmaschinentexte und Themenbereiche gehören zum Seitenentwurf und werden mit „Entwurf speichern“ gesichert.

+ @elseif ($this->register === 'verlauf') +

Jede Speicherung legt eine Revision an. Öffnen verändert keine Revision; „Wiederherstellen“ legt eine neue Revision mit dem alten Stand an.

+ @else +

Der Seitenaufbau zeigt jeden Abschnitt mit seinen Plätzen im Rasterverhältnis der Website und je Baustein eine verkleinerte Vorschau. Die vollständige Ausgabe zeigt die Seitenvorschau.

+

„Abschnitt gestalten“ öffnet Raster, Inhaltsbreite, Hintergrund, Abstände und Trenner eines Abschnitts; „Konfigurieren“ öffnet Inhalt, Medien und Darstellung eines Bausteins. Beides arbeitet am selben Seitenentwurf.

+

„Entwurf speichern“ (auch Strg+S) legt eine Revision an; öffentlich wird sie erst über „Veröffentlichen …“.

+ @endif +
+
+
+
+@php + $abschnittSchluessel = $this->register === 'inhalt' ? $this->abschnittSchluessel() : null; +@endphp +@if ($this->register === 'inhalt' && $abschnittSchluessel === null) + {{-- Seitenaufbau: Raster und Gestaltung stehen im Kontext „Abschnitt gestalten“, nicht an jedem Abschnitt. --}} + +@elseif ($abschnittSchluessel !== null) + @php + $abschnittsZustand = $this->data['sections'][$abschnittSchluessel] ?? []; + $rasterKurz = \App\Domain\Cms\Sections\SectionLayouts::short(\App\Domain\Cms\Sections\SectionLayouts::has($abschnittsZustand['layout'] ?? null) ? $abschnittsZustand['layout'] : \App\Domain\Cms\Sections\SectionLayouts::DEFAULT); + @endphp +
+ +

Abschnitt {{ $this->abschnitt + 1 }} gestalten

+ Raster {{ $rasterKurz }} +
+ @include('filament.verwaltung.icon', ['name' => 'info'])Hilfe +
+

Raster und Inhaltsbreite, Hintergrund sowie Abstände und Trenner dieses Abschnitts. Die Plätze darunter zeigen seine Bausteine verkleinert im gewählten Rasterverhältnis.

+

Abstand oben und unten: Zwischen zwei Abschnitten addieren sich „unten“ und „oben“; „Kein Abstand“ lässt einen Einstieg direkt unter der Kopfzeile beginnen. Bei eigener Fläche liegen beide Abstände innerhalb der Fläche. Der Widget-Abstand gilt zwischen den Plätzen. Ein Hintergrund reicht immer über die ganze Bildschirmbreite.

+

Änderungen bleiben im Seitenentwurf, auch nach „Zum Seitenaufbau“ oder Esc; gespeichert wird über „Entwurf speichern“.

+
+
+
+ +@endif +{{-- Seiten-Arbeitsplatz: kein eigener Rahmen „Inhalt der Seite“; der Seitenaufbau beginnt direkt unter den Registern. --}} + +@include('filament.cms.bild-picker') diff --git a/resources/views/filament/cms/styles.blade.php b/resources/views/filament/cms/styles.blade.php new file mode 100644 index 0000000..e24e5cb --- /dev/null +++ b/resources/views/filament/cms/styles.blade.php @@ -0,0 +1,175 @@ + + diff --git a/resources/views/filament/cms/webpraesenz-kopf.blade.php b/resources/views/filament/cms/webpraesenz-kopf.blade.php new file mode 100644 index 0000000..d9ebe44 --- /dev/null +++ b/resources/views/filament/cms/webpraesenz-kopf.blade.php @@ -0,0 +1,70 @@ +{{-- Kopf der Webpräsenz (Dokument 13, WEB-R05): Menüstand mit betroffenen Bereichen, Register Seiten und Menüs. --}} +@php + $bereiche = $this->betroffeneBereiche(); + $offen = $bereiche !== []; + $namen = implode(', ', array_map($this->bereichsName(...), $bereiche)); + $status = match (true) { + $this->konflikt => [ + ['text' => 'Nicht gespeichert: Die Menüs wurden inzwischen an anderer Stelle geändert.', 'ton' => 'offen', 'aktion' => ['label' => 'Gespeicherten Stand laden …', 'wire' => "askConfirmation('neuLaden')"]], + ], + $offen => [ + ['text' => 'Menüänderungen nicht gespeichert · betrifft '.$namen, 'ton' => 'offen'], + ['text' => 'Wirkt nach dem Speichern sofort auf die öffentliche Navigation.', 'ton' => 'neutral'], + ], + default => [['text' => 'Menüs gespeichert · entsprechen der öffentlichen Navigation', 'ton' => 'gut']], + }; + $aktionen = []; + if ($this->register === 'seiten') { + if (auth()->user()?->can('create', \App\Domain\Cms\Page::class)) { + $aktionen[] = ['label' => 'Seite anlegen', 'href' => \App\Filament\Resources\Pages\PageResource::getUrl('create'), 'icon' => 'plus', 'art' => $offen ? 'line' : 'primary']; + } + if ($offen) { + $aktionen[] = ['label' => 'Menüänderungen speichern', 'wire' => 'speichern', 'art' => 'primary']; + } + } else { + $aktionen[] = ['label' => 'Website ansehen (gespeicherter Stand)', 'href' => url('/'), 'neu' => true, 'icon' => 'extern', 'art' => 'line']; + $aktionen[] = ['label' => 'Menüänderungen speichern', 'wire' => 'speichern', 'art' => 'primary', 'disabled' => ! $offen]; + } + $mehr = $offen ? [['label' => 'Menüänderungen verwerfen …', 'wire' => "askConfirmation('verwerfen')", 'hinweis' => 'Alle Menüs kehren zum gespeicherten Stand zurück.', 'gefahr' => true]] : []; + $anzahlSeiten = \App\Domain\Cms\Page::query()->count(); +@endphp +
+ @include('filament.verwaltung.kopf', [ + 'brot' => ['Website', 'Webpräsenz'], + 'titel' => 'Webpräsenz', + 'status' => $status, + 'aktionen' => $aktionen, + 'mehr' => $mehr, + ]) +
+
+ @foreach (['seiten' => 'Seiten', 'menues' => 'Menüs'] as $wert => $label) + + @endforeach +
+ {{-- Erläuterungen zu Sortierung, Ausblenden, Speichern und Veröffentlichung gezielt aufrufbar. --}} +
+ @include('filament.verwaltung.icon', ['name' => 'info'])Hilfe +
+ @if ($this->register === 'menues') +

Menütext, Ziel, Ebene, Sichtbarkeit und Bereich gehören zum Menüeintrag. Die Zielseite bleibt unverändert; ihre Veröffentlichung ist davon unabhängig.

+

Ausblenden oder Entfernen wirkt nur auf den Menüeintrag. Eine veröffentlichte Seite bleibt über ihre Adresse erreichbar und in der Sitemap.

+

Umordnen per Ziehen, mit „Nach oben“/„Nach unten“ oder Alt+↑/↓ in der Liste, immer innerhalb derselben Ebene.

+

Alle Änderungen bleiben offen, bis „Menüänderungen speichern“ sie gemeinsam schreibt; dann wirken sie sofort auf die öffentliche Navigation. „Seite bearbeiten“ öffnet einen neuen Tab und speichert hier nichts mit.

+ @else +

Die Sortierung ordnet nur diese Übersicht; die Reihenfolge der Website-Menüs steht im Register „Menüs“.

+

„Veröffentlicht“ heißt: Die Seite hat eine öffentliche Revision (Nummer in der Detailzeile, Verlauf in der Seite). „Entwurf neuer“: gespeicherte Änderungen sind noch nicht öffentlich. „Ohne Menüeintrag“ sagt nichts über die Veröffentlichung.

+

Menüzuordnungen zeigen den gespeicherten Stand der Menüs.

+ @endif +
+
+
+ @include('filament.verwaltung.abgang', ['offen' => $offen]) +
+ diff --git a/resources/views/filament/cms/webpraesenz.blade.php b/resources/views/filament/cms/webpraesenz.blade.php new file mode 100644 index 0000000..75594bc --- /dev/null +++ b/resources/views/filament/cms/webpraesenz.blade.php @@ -0,0 +1,11 @@ + + @if ($this->register === 'menues') + @include('filament.cms.menues') + @else + @include('filament.verwaltung.bestand') + @endif + @include('filament.verwaltung.bestaetigung') + @if ($this->zielwahl !== null && isset($this->eintraege[$this->zielwahl])) + @include('filament.cms.ziel-auswahl') + @endif + diff --git a/resources/views/filament/cms/widget-live-preview.blade.php b/resources/views/filament/cms/widget-live-preview.blade.php new file mode 100644 index 0000000..70c026d --- /dev/null +++ b/resources/views/filament/cms/widget-live-preview.blade.php @@ -0,0 +1,31 @@ +{{-- + Live-Vorschau im Bearbeitungsdialog eines Widgets. Gerendert wird mit derselben Widget-Ansicht wie auf der + öffentlichen Seite (WidgetEditor::renderPreview), in einer festen logischen Breite und auf die Dialogbreite + verkleinert. So greifen die Container-Abfragen der Widgets wie auf der Website. +--}} +@php + $bodyClass = $bodyClass ?? ''; + $caption = $caption ?? 'Vorschau bei '.$width.' px Platzbreite, verkleinert. Gleiche Darstellung wie auf der Website.'; + $document = '' + .$stylesheets + .'' + .'
'.$html.'
'; +@endphp +
+

{{ $caption }}

+ @if (trim($html) === '') +

Dieses Widget zeigt mit den aktuellen Angaben öffentlich nichts an.

+ @else +
+ +
+ @endif +
diff --git a/resources/views/filament/cms/widget-preview.blade.php b/resources/views/filament/cms/widget-preview.blade.php new file mode 100644 index 0000000..93fd78c --- /dev/null +++ b/resources/views/filament/cms/widget-preview.blade.php @@ -0,0 +1,27 @@ +{{-- + Miniaturvorschau eines Bausteins im Seitenaufbau. Das Widget wird mit derselben Ansicht wie auf der öffentlichen + Seite gerendert, in einem eigenen Dokument in Desktopbreite (Anteil des Platzes an 1200 px) und verkleinert. So + bleiben Art und Aufbau erkennbar, ohne dass ein Einstieg oder Langtext einen Bildschirm füllt. Die vollständige + Ausgabe zeigt die Seitenvorschau. +--}} +@php + $document = '' + .$stylesheets + .'' + .'
'.$html.'
'; +@endphp +@if (trim($html) === '') +

Zeigt öffentlich noch nichts an. Bitte Inhalte ergänzen.

+@else + +@endif diff --git a/resources/views/filament/cms/ziel-auswahl.blade.php b/resources/views/filament/cms/ziel-auswahl.blade.php new file mode 100644 index 0000000..1e89d69 --- /dev/null +++ b/resources/views/filament/cms/ziel-auswahl.blade.php @@ -0,0 +1,49 @@ +{{-- „Ziel ändern“ (WEB-R03): Seitensuche mit Titel, Adresse und Veröffentlichungszustand. Wählen veröffentlicht nichts. --}} +@php + $e = $this->eintraege[$this->zielwahl]; + $seiten = $this->zielSeiten(); + $aktuell = $e['page_id'] !== null ? (int) $e['page_id'] : null; +@endphp + diff --git a/resources/views/filament/editorial/desk-page.blade.php b/resources/views/filament/editorial/desk-page.blade.php new file mode 100644 index 0000000..d619d2b --- /dev/null +++ b/resources/views/filament/editorial/desk-page.blade.php @@ -0,0 +1,3 @@ + + @include('filament.verwaltung.bestand') + diff --git a/resources/views/filament/editorial/edit.blade.php b/resources/views/filament/editorial/edit.blade.php new file mode 100644 index 0000000..30de769 --- /dev/null +++ b/resources/views/filament/editorial/edit.blade.php @@ -0,0 +1,4 @@ + + @include('filament.editorial.styles') + @include('filament.editorial.editor') + diff --git a/resources/views/filament/editorial/editor.blade.php b/resources/views/filament/editorial/editor.blade.php new file mode 100644 index 0000000..9fa8d99 --- /dev/null +++ b/resources/views/filament/editorial/editor.blade.php @@ -0,0 +1,169 @@ +@if ($this->redaktionOpen) + @include('filament.verwaltung.redaktion') +@else +@php + $titel = trim($this->displayTitle) !== '' ? trim($this->displayTitle) : trim($this->designation); + $statusSatz = $this->editorStatus(); + $aufbauOffen = str_starts_with($statusSatz, 'Es gibt ungespeicherte'); + $redaktionOffen = $this->redaktionOffen(); + $bereit = $this->currentReadyVersion(); + $aktionen = []; + if ($url = $this->previewUrl()) { + $aktionen[] = ['label' => 'Vorschau für Trainer', 'href' => $url, 'neu' => true, 'icon' => 'auge']; + } + $aktionen[] = ['label' => 'Redaktion bearbeiten', 'wire' => "openRedaktion('texte')", 'art' => 'line', 'icon' => 'stift']; + $aktionen[] = ['label' => 'Entwurf speichern', 'wire' => 'saveDraft', 'art' => 'primary']; + $mehr = [['label' => 'Fassung freigeben', 'wire' => 'armRelease', 'hinweis' => 'Neue unveränderliche Fassung aus dem Aufbau.']]; + if ($bereit !== null) { + $mehr[] = $this->isInLibrary() + ? ['label' => 'Aus Mitgliederbibliothek ausblenden', 'wire' => "mountAction('displayRevoke')", 'hinweis' => 'Der Inhalt bleibt gespeichert.'] + : ['label' => 'In Mitgliederbibliothek anzeigen', 'wire' => "mountAction('displayRelease')", 'hinweis' => 'Zeigt die letzte freigegebene Fassung.']; + } + $mehr[] = ['label' => 'Entwurf verwerfen', 'wire' => 'discardDraft', 'hinweis' => 'Zurück zum letzten gespeicherten Aufbau.', 'gefahr' => true]; + $anzahl = count($this->members); + $typ = implode(' · ', array_filter([ + 'Aufbau', + $bereit !== null ? 'Fassung '.$bereit->number.' freigegeben' : 'Noch keine Fassung', + is_array($this->getRecord()->working_draft) && $this->getRecord()->working_draft !== [] ? 'Entwurf gespeichert' : null, + ])); +@endphp +
+ @include('filament.verwaltung.kopf', [ + 'zurueck' => ['label' => 'Zum Arbeitsplatz', 'href' => \App\Filament\Pages\EditorialDesk::getUrl()], + 'brot' => [['label' => $this->isProgram() ? 'Programme' : 'Module', 'href' => $this::getResource()::getUrl('index')], $titel], + 'titel' => $titel, + 'typ' => $this->hostLabel().' · '.$typ, + 'status' => [ + ['text' => $aufbauOffen ? 'Änderungen am Aufbau nicht gespeichert' : $statusSatz, 'ton' => $aufbauOffen ? 'offen' : ($bereit !== null ? 'gut' : 'neutral')], + $redaktionOffen ? ['text' => 'Die Redaktion hat ungespeicherte Änderungen.', 'ton' => 'offen', 'aktion' => ['label' => 'Zur Redaktion', 'wire' => "openRedaktion('".$this->redaktionTab."')"]] : null, + ], + 'aktionen' => $aktionen, + 'mehr' => $mehr, + ]) + +
+ @if ($this->returnUrl !== '') +

+ @include('filament.verwaltung.icon', ['name' => 'info']) + Dieser Eintrag wurde aus einem anderen Aufbau geöffnet. + +

+ @endif +

@include('filament.verwaltung.icon', ['name' => 'info'])„Entwurf speichern“ sichert Aufbau, Rollen, Hinweise und Didaktik. Freigegebene Fassungen bleiben unverändert, bis du eine neue Fassung freigibst. Texte und Präsentation bearbeitest du in der Redaktion.

+ @foreach (array_unique(array_filter([$this->feedback, $this->deskFeedback])) as $meldung) +

{{ $meldung }} +

+ @endforeach +
+ +
+ @foreach (['aufbau' => 'Aufbau', 'angaben' => 'Didaktik und Katalogbild', 'verlauf' => 'Fassungen und Verwendung'] as $wert => $label) + + @endforeach +
+ + @if ($this->aufbauTab === 'angaben') + @include('filament.verwaltung.aufbau-angaben') + @elseif ($this->aufbauTab === 'verlauf') + @include('filament.verwaltung.aufbau-verlauf') + @else + @include('filament.verwaltung.aufbau') + @endif + + @if ($this->releaseArmed) + @php($review = $this->releaseReview()) + + @endif + + @if ($this->textOpen) + + @endif + + @if ($this->pickerOpen) + @include('filament.verwaltung.picker') + @endif + @include('filament.verwaltung.bestaetigung') + @include('filament.verwaltung.abgang', ['offen' => $aufbauOffen || $redaktionOffen]) +
+@endif diff --git a/resources/views/filament/editorial/license-desk.blade.php b/resources/views/filament/editorial/license-desk.blade.php new file mode 100644 index 0000000..f43fdfc --- /dev/null +++ b/resources/views/filament/editorial/license-desk.blade.php @@ -0,0 +1,86 @@ +@if ($this->redaktionOpen) + @include('filament.verwaltung.redaktion') +@else + @php + /** @var \App\Domain\Catalog\LicenseArticle $artikel */ + $artikel = $this->getRecord(); + $profil = $this->editorialProfile('artikel'); + $quelle = $this->redaktionQuelle(); + $titel = $this->redaktionTitel(); + $offen = $this->redaktionOffen(); + $aktionen = []; + if ($this->canEditEditorial()) { + $aktionen[] = ['label' => 'Redaktion bearbeiten', 'wire' => "openRedaktion('texte')", 'art' => 'line', 'icon' => 'stift']; + } + $mehr = [ + ['label' => 'Stand veröffentlichen', 'wire' => "mountAction('release')", 'hinweis' => 'Neuer Artikelstand aus einer freigegebenen Fassung.'], + ['label' => 'Stand zurückziehen', 'wire' => "mountAction('withdraw')", 'hinweis' => 'Rechtlich notwendiger Rückzug mit Begründung.', 'gefahr' => true], + ]; + @endphp +
+ @include('filament.verwaltung.kopf', [ + 'brot' => [['label' => 'Lizenzartikel', 'href' => \App\Filament\Resources\LicenseArticles\LicenseArticleResource::getUrl('index')], $titel], + 'titel' => $titel, + 'typ' => 'Lizenzartikel · Kennung '.$artikel->code.($artikel->product_line ? ' · '.$artikel->product_line : ''), + 'status' => [ + ['text' => \Illuminate\Support\Str::before($stand[0] ?? '', ' · Dasselbe'), 'ton' => $artikel->current_release_id ? 'gut' : 'neutral'], + $offen ? ['text' => 'Redaktion mit ungespeicherten Änderungen', 'ton' => 'offen', 'aktion' => ['label' => 'Zur Redaktion', 'wire' => "openRedaktion('".$this->redaktionTab."')"]] : null, + ], + 'aktionen' => $aktionen, + 'mehr' => $mehr, + ]) + + @if ($this->deskFeedback !== '') +

{{ $this->deskFeedback }}

+ @endif + @include('filament.verwaltung.abgang', ['offen' => $offen]) + +
+
+
+

Präsentation des Artikels

+ @if ($quelle) + Quelle: {{ $quelle['titel'] }} ({{ $quelle['art'] }}) + @endif +
+
+ @foreach (['display_title' => 'Name', 'teaser' => 'Teaser', 'summary' => 'Kurzbeschreibung'] as $feld => $label) +
{{ $label }}
+
+ {{ $profil->value($feld) ?? 'Keine Angabe' }} + @if ($profil->origin($feld) === 'quelle') + Übernommen + @elseif ($profil->origin($feld) === 'eigen') + Eigene Angabe + @endif +
+ @endforeach +
Präsentationsmedien
+
{{ count(app(\App\Domain\Catalog\PresentationMedia::class)->staged($artikel)) }} Zuordnungen
+
+ @if ($this->canEditEditorial()) +
+ @endif +
+ +
+
+@endif diff --git a/resources/views/filament/editorial/preview-nodes.blade.php b/resources/views/filament/editorial/preview-nodes.blade.php new file mode 100644 index 0000000..0b5678f --- /dev/null +++ b/resources/views/filament/editorial/preview-nodes.blade.php @@ -0,0 +1,15 @@ +
    $nested ?? false])> + @foreach ($nodes as $node) +
  1. +

    {{ $node['role'] }}

    +

    {{ $node['title'] }}

    +

    {{ $node['kind'] }}@if ($node['version']) · {{ $node['version'] }}@endif

    + @if ($node['open_url']) +

    Medium ansehen

    + @endif + @if ($node['children'] !== []) + @include('filament.editorial.preview-nodes', ['nodes' => $node['children'], 'nested' => true]) + @endif +
  2. + @endforeach +
diff --git a/resources/views/filament/editorial/preview.blade.php b/resources/views/filament/editorial/preview.blade.php new file mode 100644 index 0000000..61b126f --- /dev/null +++ b/resources/views/filament/editorial/preview.blade.php @@ -0,0 +1,57 @@ + + + + + + Vorschau: {{ $title }} + + + +
+ +

Zurück zur Bearbeitung

+ @if ($kind) +

{{ $kind }}

+ @endif +

{{ $title }}

+ @if (filled($summary)) +

{{ $summary }}

+ @endif + @if (filled($description ?? null)) +

Beschreibung

+

{{ $description }}

+ @endif + @if (filled($learningGoal)) +

Lernziel

+

{{ $learningGoal }}

+ @endif + @if ($durationMinutes) +

Zeit: {{ $durationMinutes }} Minuten

+ @endif + @if (filled($materialNote)) +

Material

+

{{ $materialNote }}

+ @endif +

Aufbau

+ @include('filament.editorial.preview-nodes', ['nodes' => $nodes]) +
+ + diff --git a/resources/views/filament/editorial/styles.blade.php b/resources/views/filament/editorial/styles.blade.php new file mode 100644 index 0000000..ea38173 --- /dev/null +++ b/resources/views/filament/editorial/styles.blade.php @@ -0,0 +1,275 @@ + diff --git a/resources/views/filament/editorial/variants.blade.php b/resources/views/filament/editorial/variants.blade.php new file mode 100644 index 0000000..c80e199 --- /dev/null +++ b/resources/views/filament/editorial/variants.blade.php @@ -0,0 +1,39 @@ +
+ Abweichende Formulierung für einen Kontext +

Ohne Eintrag gilt die zentrale Angabe. Eine Abweichung gilt nur für den gewählten Kontext und ändert die Quelle nicht.

+ @if ($variants = $this->variantRows()) +
    + @foreach ($variants as $variant) +
  • + {{ \App\Domain\Catalog\EditorialProfileReader::AUDIENCES[$variant->audience] ?? $variant->audience }} + · {{ $this->variantFieldLabel($variant->field) }}: + {{ \Illuminate\Support\Str::limit($variant->body, 160) }} + @if ($this->canEditEditorial()) + + @endif +
  • + @endforeach +
+ @endif + @if ($this->canEditEditorial()) + + + + + @endif +
diff --git a/resources/views/filament/media/editor-styles.blade.php b/resources/views/filament/media/editor-styles.blade.php new file mode 100644 index 0000000..3259c03 --- /dev/null +++ b/resources/views/filament/media/editor-styles.blade.php @@ -0,0 +1,119 @@ + diff --git a/resources/views/filament/media/library-styles.blade.php b/resources/views/filament/media/library-styles.blade.php new file mode 100644 index 0000000..f6a13e4 --- /dev/null +++ b/resources/views/filament/media/library-styles.blade.php @@ -0,0 +1,259 @@ + diff --git a/resources/views/filament/media/preview-frame.blade.php b/resources/views/filament/media/preview-frame.blade.php new file mode 100644 index 0000000..aaee2d5 --- /dev/null +++ b/resources/views/filament/media/preview-frame.blade.php @@ -0,0 +1,21 @@ +
+
+
+ + +
+
+ + +
+
+ @include('filament.cms.widget-live-preview', [ + 'html' => $this->previewHtml(), + 'stylesheets' => \App\Filament\Support\WidgetEditor::previewStylesheets(), + 'width' => (int) $this->previewWidth, + 'bodyClass' => $this->previewSurface === 'bibliothek' ? 'member' : '', + 'caption' => $this->previewSurface === 'bibliothek' + ? 'Bibliothekskarte bei '.$this->previewWidth.' px. Dieselbe Karte wie im Mitgliederbereich.' + : 'Website-Karte bei '.$this->previewWidth.' px. Dieselbe Karte wie im öffentlichen Auftritt. Das Bibliotheksbild ist nur hier sichtbar.', + ]) +
diff --git a/resources/views/filament/media/usages.blade.php b/resources/views/filament/media/usages.blade.php new file mode 100644 index 0000000..f17228d --- /dev/null +++ b/resources/views/filament/media/usages.blade.php @@ -0,0 +1,22 @@ +{{-- Verwendung eines Mediums in der Bestandsliste: Zahl, aufklappbar zu Modul/Programm mit Fassung und Rolle. --}} +
+ @if ($card['usages'] === []) +

{{ $card['usageLabel'] }}

+ @else +
+ {{ $card['usageLabel'] }} +
    + @foreach ($card['usages'] as $usage) +
  • + {{ $usage['type'] }} + {{ $usage['name'] }} + Medium {{ $usage['mediumVersion'] }}, eingesetzt in {{ $usage['hostVersion'] }}@if ($usage['roles'] !== []) · {{ implode(', ', $usage['roles']) }}@endif +
  • + @endforeach +
+
+ @endif + @if ($card['licenseText']) +

{{ $card['licenseText'] }}

+ @endif +
diff --git a/resources/views/filament/media/viewer.blade.php b/resources/views/filament/media/viewer.blade.php new file mode 100644 index 0000000..0a66d3c --- /dev/null +++ b/resources/views/filament/media/viewer.blade.php @@ -0,0 +1,425 @@ +@php + use App\Domain\Catalog\ContentVersionStatus; + $fokus = $this->bereich; + $editable = $canRevise; + $bereit = $versions->first(fn ($version) => $version->status === ContentVersionStatus::Bereit); + $entwurf = $versions->first(fn ($version) => $version->status === ContentVersionStatus::Entwurf); + $webOffen = $this->websiteIsPublic(); + $statusTeile = []; + $statusTeile[] = $bereit ? 'Fassung '.$bereit->number.' freigegeben' : ($versions->isEmpty() ? 'Ohne Inhaltsfassung' : 'Noch keine freigegebene Fassung'); + if ($entwurf) { + $statusTeile[] = 'Entwurf Fassung '.$entwurf->number.' offen'; + } + $statusTeile[] = $webOffen ? 'Für die Website freigegeben' : 'Nicht für die Website freigegeben'; + $redaktionOffen = $this->redaktionOffen(); + $textOffen = $this->textUnsaved(); + $titel = (string) ($element->display_title ?: $element->working_title); + $aktionen = []; + if ($this->canEditEditorial()) { + $aktionen[] = ['label' => 'Redaktion bearbeiten', 'wire' => "openRedaktion('texte')", 'art' => 'line', 'icon' => 'stift']; + } + if ($canRevise) { + $aktionen[] = ['label' => 'Neue Fassung anlegen', 'wire' => "mountAction('revise')", 'art' => 'primary']; + } + $mehr = []; + if ($canRevise && $entwurf) { + $mehr[] = ['label' => 'Entwurf Fassung '.$entwurf->number.' freigeben', 'wire' => "mountAction('releaseVersion', { version: ".$entwurf->id." })", 'hinweis' => 'Die Fassung wird unveränderlich. Bibliothek und Website ändern sich dadurch nicht.']; + } + if ($canRevise && $versions->isEmpty()) { + $mehr[] = ['label' => 'Medium löschen', 'wire' => "mountAction('delete')", 'hinweis' => 'Nur ohne Fassung möglich.', 'gefahr' => true]; + } +@endphp + +
+@include('filament.media.library-styles') +@include('filament.media.editor-styles') + +@if ($this->redaktionOpen) + @include('filament.verwaltung.redaktion') +@else +
+ @include('filament.verwaltung.kopf', [ + 'brot' => [['label' => 'Medien', 'href' => \App\Filament\Resources\ContentElements\ContentElementResource::getUrl('index')], $titel], + 'titel' => $titel, + 'typ' => implode(' · ', array_filter(['Medium', \App\Domain\Cms\Catalog\PublicMaterialReader::outputLabel((string) $element->output_class), $element->editorialContentKind?->label])), + 'status' => [ + ['text' => implode(' · ', $statusTeile), 'ton' => $bereit ? 'gut' : 'neutral'], + $textOffen ? ['text' => 'Text der Fassung nicht gespeichert', 'ton' => 'offen', 'aktion' => $fokus !== 'inhalt' ? ['label' => 'Zum Text', 'wire' => "\$set('bereich', 'inhalt')"] : null] : null, + $redaktionOffen ? ['text' => 'Redaktion mit ungespeicherten Änderungen', 'ton' => 'offen', 'aktion' => ['label' => 'Zur Redaktion', 'wire' => "openRedaktion('".$this->redaktionTab."')"]] : null, + ], + 'aktionen' => $aktionen, + 'mehr' => $mehr, + ]) + + @foreach (array_filter([$this->deskFeedback, $this->editorialFeedback]) as $meldung) +

{{ $meldung }}

+ @endforeach + +
+ @foreach ([ + 'inhalt' => 'Inhalt und Fassungen', + 'vorschaubild' => 'Vorschaubild', + 'verwendung' => 'Verwendung', + 'vorschau' => 'Vorschau', + 'website' => 'Website', + ] as $value => $label) + + @endforeach +
+
+ + @php + $kurzStatus = fn ($version): string => match ($version->status) { + ContentVersionStatus::Gesperrt => 'Deaktiviert', + ContentVersionStatus::Entwurf => 'Entwurf', + default => 'Freigegeben', + }; + $langStatus = fn ($version): string => match ($version->status) { + ContentVersionStatus::Gesperrt => 'Deaktiviert', + ContentVersionStatus::Entwurf => 'Entwurf, noch nicht freigegeben', + default => 'Freigegeben', + }; + $symbol = match ((string) $element->output_class) { + 'film' => 'film', + 'bild' => 'bild', + 'audio' => 'audio', + default => 'dokument', + }; + @endphp + +
+ @if ($fokus === 'inhalt') + @if ($versions->isEmpty()) + {{-- Viele Medien sind reine Präsentationsmedien ohne Fassung: kein leerer Strukturbereich. --}} +
+ Noch keine Inhaltsfassung +

Dieses Medium wird ohne Fassung verwendet, zum Beispiel als Präsentationsbild auf Karten und Seiten. Eine Fassung brauchst du erst, wenn die Datei oder ein Lehrtext in Modulen und Programmen eingesetzt werden soll.

+ @if ($canRevise) + + @endif +
+ @else + {{-- Gleicher Rahmen wie der Aufbauarbeitsplatz: Fassungen links, ausgewählte Fassung rechts. --}} +
+
+
+

Fassungen · {{ $versions->count() }}

+
+
    + @foreach ($versions as $version) + @php $aktiv = $shown && $shown->id === $version->id; @endphp +
  1. $aktiv])> +
    + +
    +
  2. + @endforeach +
+

Eine neue Datei oder ein geänderter Lehrtext ergibt eine neue Fassung. Redaktion, Vorschaubild und Website-Angaben ändern keine Fassung.

+
+ +
+ @php + $problem = $shown->status === ContentVersionStatus::Entwurf + ? app(\App\Domain\Catalog\ContentService::class)->elementReleaseProblem($shown) + : null; + $naechste = (int) $versions->max('number') + 1; + $verwendet = array_values(array_filter($this->usageCard()['usages'], fn (array $usage): bool => ($usage['mediumVersionId'] ?? null) === $shown->id)); + $hatDatei = $fileUrl || $pending || is_string((is_array($shown->metadata) ? $shown->metadata : [])['file'] ?? null); + @endphp +
+
+

Fassung {{ $shown->number }}

+

{{ $langStatus($shown) }}@if ($shown->created_at) · angelegt am {{ $shown->created_at->format('d.m.Y') }}@endif

+
+
+ @include('filament.verwaltung.icon', ['name' => 'extern'])Im eigenen Tab + @if ($canRevise && $shown->status === ContentVersionStatus::Bereit) + + @endif + @if ($canRevise && $shown->status === ContentVersionStatus::Entwurf) + + @endif +
+
+ + @if (filled($shown->change_note)) +

@include('filament.verwaltung.icon', ['name' => 'info'])Änderungsnotiz: {{ $shown->change_note }}

+ @endif + @if ($shown->status === ContentVersionStatus::Gesperrt) +

@include('filament.verwaltung.icon', ['name' => 'achtung'])Diese Fassung wird nicht mehr ausgeliefert und kann nicht neu eingebunden werden.@if (filled($shown->block_reason)) Begründung: {{ $shown->block_reason }}@endif

+ @endif + @if ($problem) +

@include('filament.verwaltung.icon', ['name' => 'achtung']){{ $problem }}

+ @endif + @if ($this->fassungFeedback !== '') +

$this->fassungFeedbackError]) role="{{ $this->fassungFeedbackError ? 'alert' : 'status' }}">{{ $this->fassungFeedback }} +

+ @endif + +
+ @if ($canEditBody) + + +

+ @if ($bodyCommitted) + Fassung {{ $shown->number }} ist freigegeben und wird verwendet. Sie bleibt unverändert, „Text speichern“ legt Fassung {{ $naechste }} an. + @else + Fassung {{ $shown->number }} wird noch nirgends verbindlich verwendet. „Text speichern“ ändert diese Fassung, es entsteht keine neue. + @endif +

+
+ + @if ($textOffen) + + @endif +
+ @else + @if ($hatDatei || filled($shown->body)) +
+ @include('content.player', ['version' => $shown, 'fileUrl' => $fileUrl, 'pending' => $pending]) +
+ @else +
Kein Inhalt hinterlegt

Für Fassung {{ $shown->number }} liegt noch kein Text und keine Datei vor.

+ @endif + @endif + +
+

Eingebunden in

+ @forelse ($verwendet as $usage) +

{{ $usage['name'] }} + {{ $usage['type'] }} · {{ $usage['hostVersion'] }}@if ($usage['roles'] !== []) · {{ implode(', ', $usage['roles']) }}@endif

+ @empty +

Fassung {{ $shown->number }} ist in keinem Modul und keinem Programm eingebunden.

+ @endforelse +
+
+
+
+ @endif + @elseif ($fokus === 'vorschaubild') +
+
+

Vorschaubild

+

Bild der Karte dieses Mediums in Arbeitsplatz, Bibliothek und Auswahl. In Modulen und Programmen ohne eigenes Katalogbild dient es als Vorschlag. Es wird sofort übernommen und erzeugt keine Fassung.

+
+ @if ($pictureUrl) + {{ $element->thumbnail_alt ?: $element->working_title }} + @else + Noch kein Vorschaubild + @endif +
+ @if ($pictureCaption !== '') +

{{ $pictureCaption }}

+ @endif + @if ($this->pictureFeedback !== '') +

{{ $this->pictureFeedback }} +

+ @endif + @if ($canRevise) + +
+ + +
+ @elseif (filled($element->thumbnail_alt)) +

Alternativtext: {{ $element->thumbnail_alt }}

+ @endif +
+ + @if ($canRevise) + + @endif +
+ @elseif ($fokus === 'verwendung') + @php + $card = $this->usageCard(); + $artikel = array_values(array_filter($usage, fn (string $line): bool => str_starts_with($line, 'Lizenzartikel '))); + @endphp +
+

Wo dieses Medium eingebunden ist

+

Eine Verwendung verweist auf eine konkrete Fassung. Die Rolle steht an der Verwendung, nicht als Kopie des Mediums. Präsentationsmedien und Website-Seiten stehen in der Redaktion und unter „Website“.

+ @if ($card['usages'] === [] && $artikel === []) +
Noch nicht eingebunden

Noch in keinem Modul, keinem Programm und keinem Lizenzartikel verwendet.

+ @endif + @if ($card['usages'] !== []) +

In Modulen und Programmen · {{ count($card['usages']) }}

+
    + @foreach ($card['usages'] as $eintrag) +
  • + {{ $eintrag['name'] }} + {{ $eintrag['type'] }} · {{ $eintrag['hostVersion'] }} · nutzt {{ $eintrag['mediumVersion'] }}@if ($eintrag['roles'] !== []) · {{ implode(', ', $eintrag['roles']) }}@endif +
  • + @endforeach +
+ @endif + @if ($artikel !== []) +

In Lizenzartikeln · {{ count($artikel) }}

+
    + @foreach ($artikel as $line) +
  • {{ $line }}
  • + @endforeach +
+ @endif + @if ($card['licenseText']) +

@include('filament.verwaltung.icon', ['name' => 'info']){{ $card['licenseText'] }}

+ @endif +
+ @elseif ($fokus === 'vorschau') +
+

Website-Karte und Bibliothekskarte mit dem aktuellen Stand der Redaktion. Ein Bibliotheksbild ist in der Vorschau sichtbar und damit nicht öffentlich freigegeben.

+ @include('filament.media.preview-frame') +
+ @else +
+
+

Website-Freigabe

+

+ $webOffen, 'is-nicht' => ! $webOffen])> + @include('filament.verwaltung.icon', ['name' => $webOffen ? 'ok' : 'achtung']) + {{ $webOffen ? 'Für die Website freigegeben. Öffentliche Seiten lesen nur die freigegebene Ableitung.' : 'Nicht für die Website freigegeben.' }} + +

+ @if ($this->websiteFeedback !== '') +

{{ $this->websiteFeedback }}

+ @endif + @if ($editable) +
+ @if ($webOffen) + + @else + + @endif +
+ @endif +
+
Quellenzeile
{{ filled($element->website_credit) ? $element->website_credit : 'Keine Angabe' }}
+
Alternativtext
{{ filled($element->website_alt) ? $element->website_alt : 'Keine Angabe' }}
+
+ @if ($this->canEditEditorial()) +
+ @endif + @if ($redaktionOffen) +

Die Redaktion hat ungespeicherte Änderungen. Die Freigabe nutzt den gespeicherten Stand.

+ @endif +
+ +
+ @endif +
+ @if ($this->pickerOpen) + @include('filament.verwaltung.picker') + @endif + @include('filament.verwaltung.bestaetigung') + @include('filament.verwaltung.abgang', ['offen' => $redaktionOffen || $textOffen]) +@endif + + +
diff --git a/resources/views/filament/stammdaten-verwendung.blade.php b/resources/views/filament/stammdaten-verwendung.blade.php new file mode 100644 index 0000000..e815d3a --- /dev/null +++ b/resources/views/filament/stammdaten-verwendung.blade.php @@ -0,0 +1,24 @@ +
+ @if ($zeilen === []) +

Dieser Wert ist derzeit nirgends zugeordnet.

+ @else + + @if ($mehr > 0) +

Und {{ $mehr }} weitere. Die gefilterten Listen zeigen alle.

+ @endif + @endif + @if ($filter !== []) +

+ @foreach ($filter as $link) + {{ $link['label'] }} + @endforeach +

+ @endif +
diff --git a/resources/views/filament/stammdaten.blade.php b/resources/views/filament/stammdaten.blade.php new file mode 100644 index 0000000..c57dfd3 --- /dev/null +++ b/resources/views/filament/stammdaten.blade.php @@ -0,0 +1,27 @@ + +
+
+
+ @foreach ($this->gruppen() as $wert => $label) + + @endforeach +
+ Fachliche Säulen @include('filament.verwaltung.icon', ['name' => 'extern']) +
+

+ @if ($this->gruppe === 'materialart') + Fachliche Materialart eines Mediums, Moduls, Programms oder Lizenzartikels – unabhängig von der technischen Medienart. „Zulässig für“ bestimmt, wo sie neu gewählt werden kann. + @else + Einordnung für Suche und Filter. Sie gibt nichts frei, erteilt keine Rechte und ist keine tatsächliche Verwendung. + @endif + Fachliche Säulen werden in der Säulenverwaltung gepflegt. +

+
+
+ {{ $this->table }} +
+
diff --git a/resources/views/filament/verwaltung/abgang.blade.php b/resources/views/filament/verwaltung/abgang.blade.php new file mode 100644 index 0000000..155de97 --- /dev/null +++ b/resources/views/filament/verwaltung/abgang.blade.php @@ -0,0 +1,17 @@ +{{-- Warnt beim Verlassen der Seite (Link, Neuladen, Tab schließen), solange ungespeicherte Änderungen bestehen. --}} +@if ($offen ?? false) + +@endif +@once + +@endonce diff --git a/resources/views/filament/verwaltung/aufbau-angaben.blade.php b/resources/views/filament/verwaltung/aufbau-angaben.blade.php new file mode 100644 index 0000000..a5bd9b8 --- /dev/null +++ b/resources/views/filament/verwaltung/aufbau-angaben.blade.php @@ -0,0 +1,77 @@ +{{-- Didaktik (gehört zum Aufbau-Entwurf) und Katalogbild (sofort wirksam, ohne Fassung). --}} +@php + $cover = $this->coverPicture(); + $filme = $this->frameFilms(); + $ort = $this->isProgram() ? 'dieses Programms' : 'dieses Moduls'; +@endphp +
+
+

Didaktik

+

Lernziel, Zeit und Material gehören zum fachlichen Stand {{ $ort }}. Sie werden mit „Entwurf speichern“ gesichert und erst mit „Fassung freigeben“ Teil einer neuen Fassung.

+ +
+ + +
+ +

Name, Texte, Präsentationsmedien und Einordnung bearbeitest du in der Redaktion. +

+
+ + +
diff --git a/resources/views/filament/verwaltung/aufbau-verlauf.blade.php b/resources/views/filament/verwaltung/aufbau-verlauf.blade.php new file mode 100644 index 0000000..c33afe7 --- /dev/null +++ b/resources/views/filament/verwaltung/aufbau-verlauf.blade.php @@ -0,0 +1,57 @@ +{{-- Freigegebene Fassungen, Sichtbarkeit und Verwendung einer Komposition. --}} +@php + $fassungen = $this->versionChoices(); + $verwendung = $this->usageLines(); +@endphp +
+
+

Freigegebene Fassungen

+ @if ($fassungen === []) +
Noch keine freigegebene Fassung

Sie entsteht mit „Fassung freigeben“ unter „Weitere Aktionen“, nicht beim Speichern des Entwurfs.

+ @else + + @endif + @if ($follow = $this->releaseFollowUp()) +

{{ $follow }}

+ @endif +
+ Was Speichern und Freigeben bedeuten +
+

Name, Texte, Einordnung und Präsentation ändern die sichtbare Karte. Sie erzeugen keine Inhaltsfassung und werden in der Redaktion gespeichert.

+

„Entwurf speichern“ hält Aufbau, Rollen, Hinweise, Lernziel, Zeit und Material fest. Eine freigegebene Fassung bleibt dabei unverändert.

+

„Fassung freigeben“ erzeugt eine neue unveränderliche Fassung. Die bisherige bleibt für ältere Verweise erhalten.

+

„In Mitgliederbibliothek anzeigen“ entscheidet, welche freigegebene Fassung Trainer sehen. Das veröffentlicht weder die Website noch ein Angebot.

+

Ein Medium oder Modul, das auch woanders steckt, bleibt dort bei seiner bisherigen Fassung. Hier wird nur darauf verwiesen.

+
+
+
+ +
diff --git a/resources/views/filament/verwaltung/aufbau.blade.php b/resources/views/filament/verwaltung/aufbau.blade.php new file mode 100644 index 0000000..1ceec18 --- /dev/null +++ b/resources/views/filament/verwaltung/aufbau.blade.php @@ -0,0 +1,220 @@ +{{-- Aufbauarbeitsplatz: kompakte Struktur links, ausgewählte Verwendung rechts (Dokument 06, kombinierter Entwurf). --}} +@php + $members = $this->members; + $anzahl = count($members); + $auswahl = $this->selected !== null && isset($members[$this->selected]) ? $this->selected : null; + $gewaehlt = $auswahl !== null ? $members[$auswahl] : null; + $symbol = fn (?string $tone): string => match ($tone) { 'film' => 'film', 'audio' => 'audio', 'dokument' => 'dokument', 'modul', 'programm' => 'modul', default => 'dokument' }; + $istKomposition = fn (array $m): bool => (bool) preg_match('/^composition(-draft)?:/', (string) ($m['target'] ?? '')); + $ort = ($this->isProgram() ? 'im Programm' : 'im Modul'); +@endphp +
+
+
+

Aufbau · {{ $anzahl }} {{ $anzahl === 1 ? 'Bestandteil' : 'Bestandteile' }}

+ +
+ + @if ($members === []) +
+ Noch kein Bestandteil +

{{ $this->isProgram() ? 'Füge Module oder Medien hinzu.' : 'Füge vorhandene Medien hinzu, erstelle einen Text oder lege ein Medium an. Ein Film ist nicht nötig.' }} Es wird nur verwiesen, nichts kopiert.

+ +
+ @else +
    + @foreach ($members as $index => $member) + @php + $aktiv = $auswahl === $index; + $offen = in_array((string) $member['target'], $this->expanded, true); + $komposition = $istKomposition($member); + @endphp +
  1. $aktiv]) + draggable="true" + x-on:dragstart="von = {{ $index }}; $event.dataTransfer.effectAllowed = 'move'" + x-on:dragend="von = null; ueber = null" + x-on:dragover.prevent="ueber = {{ $index }}" + x-on:drop.prevent="if (von !== null && von !== {{ $index }}) { $wire.moveTo(von, {{ $index }}) } von = null; ueber = null" + x-bind:class="{ 'is-ziehen': von === {{ $index }}, 'is-ziel': ueber === {{ $index }} && von !== {{ $index }} }"> +
    + @include('filament.verwaltung.icon', ['name' => 'griff'])Ziehgriff + + + @if ($komposition) + + @endif +
    + @if ($komposition && $offen) + @php $kinder = $this->childrenRows((string) $member['target']); @endphp +
    +

    Inhalt der Quelle · Nur zur Ansicht

    + @forelse ($kinder as $kind) +
    + + @if (! empty($kind['image']))@else@include('filament.verwaltung.icon', ['name' => $symbol($kind['tone'])])@endif + + {{ $kind['title'] }}
    {{ $kind['kind'] }}@if ($kind['role'] !== '') · {{ $kind['role'] }}@endif
    +
    + @empty +

    Die Quelle hat noch keinen Inhalt.

    + @endforelse +
    + @endif +
  2. + @endforeach +
+
+ @if ($auswahl !== null) Position {{ $auswahl + 1 }} von {{ $anzahl }} @else Keine Verwendung ausgewählt @endif + + + + +
+ @endif +
+ +
+ @if ($gewaehlt === null) +
+ Keine Verwendung ausgewählt +

Wähle links einen Bestandteil. Hier bearbeitest du seine Rolle und seinen Hinweis an dieser Stelle.

+
+ @else + @php + $alternativen = $this->selectedAlternatives(); + $editUrl = ! empty($gewaehlt['edit_url']) ? $gewaehlt['edit_url'].(str_contains($gewaehlt['edit_url'], '?') ? '&' : '?').'zurueck='.urlencode($this->selfUrl()) : null; + $istText = ($gewaehlt['output'] ?? '') === 'text'; + @endphp +
+
+

{{ $gewaehlt['title'] }}

+

Verwendung {{ $ort }} „{{ trim($this->displayTitle) !== '' ? $this->displayTitle : $this->designation }}“ · Stelle {{ $auswahl + 1 }}

+
+
+ +
+ @if (! empty($gewaehlt['open_url'])) + Inhaltsvorschau in neuem Tab + @endif + @if ($editUrl) + Quelle bearbeitenÖffnet {{ $istKomposition($gewaehlt) ? 'das Modul' : 'das Medium' }} selbst. Ungespeicherte Änderungen am Aufbau vorher speichern. + @endif +
+ +
+
+
+ +
+ @foreach (['stelle' => 'An dieser Stelle', 'quelle' => 'Quelle', 'vorschau' => 'Inhaltsvorschau'] as $wert => $label) + + @endforeach +
+ + @if ($this->detailTab === 'quelle') +
+

@include('filament.verwaltung.icon', ['name' => 'info'])Angaben der Quelle. Sie gelten überall, wo {{ $istKomposition($gewaehlt) ? 'dieses Modul' : 'dieses Medium' }} verwendet wird.

+
+
Quelle
{{ $gewaehlt['title'] }} · {{ $gewaehlt['kind'] }}
+
Fassung
{{ $gewaehlt['version_label'] }}
+ @if (filled($gewaehlt['summary'] ?? null))
Kurzbeschreibung
{{ $gewaehlt['summary'] }}
@endif + @if (filled($gewaehlt['medium_description'] ?? null))
Beschreibung
{{ \Illuminate\Support\Str::limit($gewaehlt['medium_description'], 400) }}
@endif + @if (filled($gewaehlt['usage_note'] ?? null))
Hinweise für den Einsatz
{{ $gewaehlt['usage_note'] }}
@endif + @if (filled($gewaehlt['license_note'] ?? null))
Interner Lizenzvermerk
{{ $gewaehlt['license_note'] }}
@endif +
+ @if ($istText) +
+

Wortlaut des Textes

+ + +

+ @if (! empty($gewaehlt['committed'])) + Diese Fassung ist freigegeben und wird verwendet. Speichern legt eine neue Fassung an; die bisherige bleibt in den freigegebenen Aufbauten. + @else + Dieser Text ist noch nicht freigegeben und verwendet. Speichern schreibt dieselbe Fassung fort. + @endif +

+
+
+ @endif + @if ($istKomposition($gewaehlt)) + @php $kinder = $this->childrenRows((string) $gewaehlt['target']); @endphp +
+

Inhalt der Quelle · {{ count($kinder) }} {{ count($kinder) === 1 ? 'Bestandteil' : 'Bestandteile' }}

+ @foreach ($kinder as $kind) +
+ @if (! empty($kind['image']))@else@include('filament.verwaltung.icon', ['name' => $symbol($kind['tone'])])@endif + {{ $kind['title'] }}
{{ $kind['kind'] }}@if ($kind['role'] !== '') · {{ $kind['role'] }}@endif
+
+ @endforeach +
+ @endif + @if ($editUrl) +

@include('filament.verwaltung.icon', ['name' => 'extern'])Quelle bearbeiten + @if ($aufbauOffen) Der Aufbau hat ungespeicherte Änderungen; vorher „Entwurf speichern“.@endif

+ @endif +
+ @elseif ($this->detailTab === 'vorschau') +
+ @if (! empty($gewaehlt['open_url'])) +

Zeigt {{ $gewaehlt['version_label'] }} so, wie Trainer den Inhalt sehen. Die Ansicht ist schreibgeschützt.

+ + @include('filament.verwaltung.icon', ['name' => 'extern'])In neuem Tab öffnen + @else +

Für diesen Bestandteil gibt es keine Inhaltsvorschau.

+ @endif +
+ @else +
+

@include('filament.verwaltung.icon', ['name' => 'info'])Gilt nur hier. Die Quelle bleibt unverändert.

+ + + @if (count($alternativen) > 1) +
+ Verwendete Fassung +
+ @foreach ($alternativen as $alternative) + + @endforeach +
+ Gilt nur in diesem Aufbau. Eine neuere Fassung wird nicht automatisch übernommen. +
+ @endif +

Änderungen werden mit dem Aufbau gespeichert („Entwurf speichern“).

+

Quelle: {{ $gewaehlt['title'] }} · {{ $gewaehlt['version_label'] }} +

+
+ @endif + @endif +
+
diff --git a/resources/views/filament/verwaltung/bestaetigung.blade.php b/resources/views/filament/verwaltung/bestaetigung.blade.php new file mode 100644 index 0000000..7aac3d1 --- /dev/null +++ b/resources/views/filament/verwaltung/bestaetigung.blade.php @@ -0,0 +1,25 @@ +{{-- Gemeinsamer Bestätigungsdialog für folgenreiche Handlungen (ersetzt das Browserfenster confirm()). --}} +@if ($frage = $this->bestaetigung) +
+
+
+
+

{{ $frage['titel'] }}

+

{{ $frage['text'] }}

+
+
+
+
+
+ + +
+
+
+
+
+@endif diff --git a/resources/views/filament/verwaltung/bestand-auswahl.blade.php b/resources/views/filament/verwaltung/bestand-auswahl.blade.php new file mode 100644 index 0000000..5371c14 --- /dev/null +++ b/resources/views/filament/verwaltung/bestand-auswahl.blade.php @@ -0,0 +1,27 @@ +{{-- Ein Auswahlfilter der Bestandsliste: ['eigenschaft', 'label', 'vorgabe', 'optionen' | 'gruppen', 'alle' => Text der Vorgabe]. --}} +@php + $feldId = 'filter-'.str_replace('.', '-', $f['eigenschaft']); +@endphp +
+ + +
diff --git a/resources/views/filament/verwaltung/bestand.blade.php b/resources/views/filament/verwaltung/bestand.blade.php new file mode 100644 index 0000000..1ea9e24 --- /dev/null +++ b/resources/views/filament/verwaltung/bestand.blade.php @@ -0,0 +1,176 @@ +{{-- + Gemeinsame Bestandsliste (Dokument 14 §3): Suche, wenige sichtbare Filter, „Weitere Filter“, aktive Filter als + entfernbare Chips, Trefferzahl, Zeilen (oder Kacheln) mit Vorschau, Zustand und passenden Aktionen, Leerzustand, + „Weitere anzeigen“. Die Seite liefert die Beschreibung über bestand() (Trait ShowsBestand): + + suche ['eigenschaft', 'label', 'platzhalter'] + segmente / filter / weitere Liste ['eigenschaft', 'label', 'vorgabe', 'optionen' => [wert => label] + oder 'gruppen' => [['label', 'optionen' => [wert => label]]]] + zeilen Liste ['schluessel', 'titel', 'meta', 'text', 'bild', 'bildNotiz', 'symbol', 'url', + 'chips' => [['label', 'ton' => gut|offen|achtung|leise|neutral]], 'hinweise' => [string], + 'aktionen' => [['label', 'href' | 'wire', 'icon', 'neu' => neuer Tab]], 'zusatz' => ['view', 'daten']] + sortierung ['eigenschaft', 'label', 'optionen' => [wert => label]] ordnet nur die Liste und ist kein Filter + einheit [Einzahl, Mehrzahl]; leer ['titel', 'text']; ansicht Name der Eigenschaft für Liste/Kacheln oder null +--}} +@php + $b = $this->bestand(); + $zeilen = $b['zeilen']; + $gesamt = count($zeilen); + $sichtbar = array_slice($zeilen, 0, $this->bestandGrenze); + $einheit = $b['einheit'] ?? ['Eintrag', 'Einträge']; + $optionenVon = function (array $f): array { + if (isset($f['optionen'])) { + return $f['optionen']; + } + $alle = []; + foreach ($f['gruppen'] ?? [] as $gruppe) { + $alle += $gruppe['optionen']; + } + + return $alle; + }; + $aktiv = []; + $suchEigenschaft = $b['suche']['eigenschaft']; + if (trim((string) data_get($this, $suchEigenschaft)) !== '') { + $aktiv[] = ['label' => 'Suche: „'.trim((string) data_get($this, $suchEigenschaft)).'“', 'eigenschaft' => $suchEigenschaft, 'vorgabe' => '']; + } + foreach ([...($b['segmente'] ?? []), ...($b['filter'] ?? []), ...($b['weitere'] ?? [])] as $f) { + $wert = (string) data_get($this, $f['eigenschaft']); + if ($wert !== (string) $f['vorgabe']) { + $aktiv[] = ['label' => $f['label'].': '.($optionenVon($f)[$wert] ?? $wert), 'eigenschaft' => $f['eigenschaft'], 'vorgabe' => (string) $f['vorgabe']]; + } + } + $weitereAktiv = collect($b['weitere'] ?? [])->filter(fn ($f) => (string) data_get($this, $f['eigenschaft']) !== (string) $f['vorgabe'])->count(); + $ansichtEigenschaft = $b['ansicht'] ?? null; + $kacheln = $ansichtEigenschaft !== null && data_get($this, $ansichtEigenschaft) === 'kacheln'; +@endphp +
+ + + @if ($b['hinweis'] ?? null) +

{{ $b['hinweis'] }}

+ @endif + +
+

+ {{ $gesamt }} {{ $gesamt === 1 ? $einheit[0] : $einheit[1] }}@if ($aktiv !== []) gefunden @endif +

+ @if ($aktiv !== []) +
    + @foreach ($aktiv as $chip) +
  • + @endforeach +
  • +
+ @endif + @if ($ansichtEigenschaft !== null) +
+ + +
+ @endif +
+ +
+ @if ($zeilen === []) +
+ @if ($aktiv !== []) + Nichts gefunden +

Prüfe die Schreibweise oder entferne einen Filter.

+ + @else + {{ $b['leer']['titel'] ?? 'Noch nichts angelegt' }} +

{{ $b['leer']['text'] ?? '' }}

+ @endif +
+ @else +
    $kacheln]) data-ansicht="{{ $kacheln ? 'kacheln' : 'liste' }}" aria-label="{{ $einheit[1] }}"> + @foreach ($sichtbar as $z) +
  • + + @if (filled($z['text'] ?? null)) + {{ $z['text'] }} + @endif + +
    + @if (($z['chips'] ?? []) !== []) +
      + @foreach ($z['chips'] as $chip) +
    • {{ $chip['label'] }}
    • + @endforeach +
    + @endif + @foreach ($z['hinweise'] ?? [] as $hinweis) +

    {{ $hinweis }}

    + @endforeach + @if (! empty($z['zusatz'])) + @include($z['zusatz']['view'], $z['zusatz']['daten'] ?? []) + @endif +
    + @if (($z['aktionen'] ?? []) !== []) +
    + @foreach ($z['aktionen'] as $aktion) + @if (! empty($aktion['wire'])) + + @else + @if (! empty($aktion['icon']))@include('filament.verwaltung.icon', ['name' => $aktion['icon']])@endif{{ $aktion['label'] }} + @endif + @endforeach +
    + @endif +
  • + @endforeach +
+ @if ($gesamt > count($sichtbar)) +
+ {{ count($sichtbar) }} von {{ $gesamt }} angezeigt + +
+ @endif + @endif +
+ + {{-- Listen ersetzen die Filament-Tabelle, die sonst den Dialogbereich der Seite ausgibt (z. B. „… anlegen“). --}} + +
diff --git a/resources/views/filament/verwaltung/einordnung.blade.php b/resources/views/filament/verwaltung/einordnung.blade.php new file mode 100644 index 0000000..5f00592 --- /dev/null +++ b/resources/views/filament/verwaltung/einordnung.blade.php @@ -0,0 +1,42 @@ +@php + $art = method_exists($this, 'einordnungArt') ? $this->einordnungArt() : null; + $gruppen = $this->einordnungGruppen(); +@endphp +
+
+

Einordnung

+ Steuert Suche und Filter. Sie gibt kein Medium frei, erteilt keine Rechte und ist keine tatsächliche Verwendung. +
+ @if ($art) + + @endif + @if ($gruppen === []) +

Es sind noch keine fachlichen Themen angelegt.

+ @else +
+ @foreach ($gruppen as $gruppe) +
+ {{ $gruppe['legend'] }} +
+ @foreach ($gruppe['values'] as $value) + + @endforeach +
+
+ @endforeach +
+ @endif +
diff --git a/resources/views/filament/verwaltung/icon.blade.php b/resources/views/filament/verwaltung/icon.blade.php new file mode 100644 index 0000000..59125ed --- /dev/null +++ b/resources/views/filament/verwaltung/icon.blade.php @@ -0,0 +1,31 @@ +@php + $paths = [ + 'auge' => '', + 'auge-zu' => '', + 'plus' => '', + 'tausch' => '', + 'x' => '', + 'hoch' => '', + 'runter' => '', + 'griff' => '', + 'mehr' => '', + 'ok' => '', + 'achtung' => '', + 'zurueck' => '', + 'stift' => '', + 'info' => '', + 'suche' => '', + 'film' => '', + 'bild' => '', + 'dokument' => '', + 'audio' => '', + 'extern' => '', + 'modul' => '', + 'schluessel' => '', + 'etikett' => '', + 'filter' => '', + 'zuruecksetzen' => '', + ]; + $name = $name ?? 'info'; +@endphp + diff --git a/resources/views/filament/verwaltung/kopf.blade.php b/resources/views/filament/verwaltung/kopf.blade.php new file mode 100644 index 0000000..a1983d5 --- /dev/null +++ b/resources/views/filament/verwaltung/kopf.blade.php @@ -0,0 +1,92 @@ +{{-- + Gemeinsamer Objektkopf. Parameter: + zurueck ['label' => …, 'wire' => … | 'href' => …] oder null + brot Liste von Bezeichnungen, die letzte ist das bearbeitete Objekt + titel, typ (Zeile unter dem Titel), status ['text' => …, 'ton' => offen|gut|neutral, 'aktion' => ['label', 'wire']] + aktionen Liste ['label', 'wire' | 'href', 'art' => primary|line|quiet, 'icon', 'neu' => bool, 'disabled' => bool] + mehr Liste ['label', 'wire' | 'href', 'hinweis', 'gefahr' => bool, 'neu' => bool] für „Weitere Aktionen“ +--}} +@php + $zurueck = $zurueck ?? null; + $brot = $brot ?? []; + $status = $status ?? null; + $stati = $status === null ? [] : (isset($status['text']) ? [$status] : array_values(array_filter($status))); + $aktionen = $aktionen ?? []; + $mehr = $mehr ?? []; +@endphp +
+ @if ($zurueck) + @if (! empty($zurueck['wire'])) + + @else + @include('filament.verwaltung.icon', ['name' => 'zurueck']){{ $zurueck['label'] }} + @endif + @endif + @if ($brot !== []) + + @endif +
+
+

{{ $titel }}

+ @if (filled($typ ?? null)) +

{{ $typ }}

+ @endif + @foreach ($stati as $eintrag) +

+ ($eintrag['ton'] ?? '') === 'offen', 'is-gut' => ($eintrag['ton'] ?? '') === 'gut']) aria-hidden="true"> + {{ $eintrag['text'] }}@if (! empty($eintrag['aktion'])) + + @endif +

+ @endforeach +
+ @if ($aktionen !== [] || $mehr !== []) +
+ @foreach ($aktionen as $aktion) + @php($klasse = 'vw-btn'.match ($aktion['art'] ?? 'quiet') { 'primary' => ' is-primary', 'line' => ' is-line', default => '' }) + @if (! empty($aktion['href'])) + + @if (! empty($aktion['icon']))@include('filament.verwaltung.icon', ['name' => $aktion['icon']])@endif + {{ $aktion['label'] }} + + @else + + @endif + @endforeach + @if ($mehr !== []) +
+ +
+ @foreach ($mehr as $eintrag) + @if (! empty($eintrag['href'])) + + {{ $eintrag['label'] }}@if (! empty($eintrag['hinweis'])){{ $eintrag['hinweis'] }}@endif + + @else + + @endif + @endforeach +
+
+ @endif +
+ @endif +
+
diff --git a/resources/views/filament/verwaltung/picker.blade.php b/resources/views/filament/verwaltung/picker.blade.php new file mode 100644 index 0000000..4ff3965 --- /dev/null +++ b/resources/views/filament/verwaltung/picker.blade.php @@ -0,0 +1,272 @@ +{{-- Gemeinsamer visueller Picker. Kontexte: aufbau (Bestandteil mit Fassung), praesentation (mehrere Medien), austausch (ein Medium ersetzt eine Zuordnung). --}} +@php + $zweck = $this->pickerPurpose; + $mehrfach = $this->pickerAllowsMany(); + $ergebnis = $this->pickerResult(); + $detail = $this->pickerDetail(); + $markiert = $this->pickerMarked; + $ersetzt = $this->replacingKey !== null ? $this->pickerReplacing() : null; + $rollen = $this->presentationRoleOptions(); + $bindbar = in_array($zweck, ['praesentation', 'austausch'], true) && in_array($this->presentationRole, \App\Domain\Catalog\PresentationRole::BOUND_ROLES, true); + $symbol = fn (?string $output): string => match ($output) { 'film' => 'film', 'bild' => 'bild', 'audio' => 'audio', default => 'dokument' }; + $kopf = $this->pickerKontext(); + $artLabel = $zweck === 'aufbau' ? 'Inhaltstyp' : 'Medienart'; + $materialarten = $this->pickerMaterialarten(); +@endphp + diff --git a/resources/views/filament/verwaltung/praesentation.blade.php b/resources/views/filament/verwaltung/praesentation.blade.php new file mode 100644 index 0000000..791ab80 --- /dev/null +++ b/resources/views/filament/verwaltung/praesentation.blade.php @@ -0,0 +1,129 @@ +@php + $titel = $this->redaktionTitel(); + $freigabeRecht = $this->canReleasePresentation(); + $ausgabe = fn (string $output): string => match ($output) { 'film' => 'Film', 'bild' => 'Bild', 'audio' => 'Hörstück', 'pdf', 'document' => 'Dokument', 'text' => 'Text', default => 'Medium' }; + $symbol = fn (string $output): string => match ($output) { 'film' => 'film', 'bild' => 'bild', 'audio' => 'audio', default => 'dokument' }; +@endphp +
+
+
+

Präsentationsmedien für {{ $titel }}

+

Zuordnungen beschreiben die Präsentation. Datei und Lehrinhalt des Objekts bleiben unverändert.

+
+ @if ($editable) + + @endif +
+ + @if ($gruppen === []) +
+ Noch keine Präsentationsmedien +

Titelbild, Trailer oder Galerie kommen aus dem Medienbestand. Es wird nur verwiesen, nichts kopiert.

+ @if ($editable) + + @endif +
+ @endif + + @foreach ($gruppen as $gruppe) + @php + $anzahl = count($gruppe['rows']); + $sortierbar = $editable && $gruppe['ordered'] && $anzahl > 1; + $galerie = $gruppe['role'] === 'galerie'; + @endphp +
+
+

{{ $gruppe['label'] }}

+ @if ($gruppe['multiple']) + · {{ $anzahl }} {{ $anzahl === 1 ? 'Medium' : 'Medien' }} + @endif + @if ($editable && $gruppe['multiple']) + + @endif +
+
    $galerie, 'vw-zuordnungen' => ! $galerie]) + x-data="{ von: null, ueber: null }" + aria-label="{{ $gruppe['label'] }}{{ $sortierbar ? ', sortierbar' : '' }}"> + @foreach ($gruppe['rows'] as $index => $row) + @php + $erste = $index === 0; + $letzte = $index === $anzahl - 1; + $fokus = $this->praesentationFokus === $row['key']; + $mediumUrl = \App\Filament\Resources\ContentElements\ContentElementResource::getUrl('view', ['record' => $row['element_id']]); + @endphp +
  • $galerie, 'vw-zeile' => ! $galerie, 'is-fokus' => $fokus]) + @if ($sortierbar) + draggable="true" + x-on:dragstart="von = '{{ $row['key'] }}'; $event.dataTransfer.effectAllowed = 'move'" + x-on:dragend="von = null; ueber = null" + x-on:dragover.prevent="ueber = '{{ $row['key'] }}'" + x-on:drop.prevent="if (von && von !== '{{ $row['key'] }}') { $wire.placePresentation(von, '{{ $row['key'] }}') } von = null; ueber = null" + x-bind:class="{ 'is-ziehen': von === '{{ $row['key'] }}', 'is-ziel': ueber === '{{ $row['key'] }}' && von !== '{{ $row['key'] }}' }" + @endif> + @unless ($galerie) + + @endunless + + @if (! empty($row['image'])) + + @else + @include('filament.verwaltung.icon', ['name' => $symbol($row['output'])]) + @endif + @if ($galerie || $gruppe['ordered']) + @if ($galerie){{ $index + 1 }}@endif + @endif + @if (in_array($row['output'], ['film', 'audio'], true)) + {{ $ausgabe($row['output']) }} + @endif + + ! $galerie, 'vw-kachel-text' => $galerie])> + {{ $row['title'] }} + + {{ $ausgabe($row['output']) }}@if (filled($row['kind']) && $row['kind'] !== $ausgabe($row['output'])) · {{ $row['kind'] }}@endif + @if ($row['new']) + Neu zugeordnet + @endif + + + $row['released'], 'is-nicht' => ! $row['released']])> + @include('filament.verwaltung.icon', ['name' => $row['released'] ? 'ok' : 'achtung']) + {{ $galerie ? ($row['released'] ? 'Website: freigegeben' : 'Website: nicht freigegeben') : $row['release_label'] }} + + @unless ($galerie) + Freigabe ansehen (öffnet das Medium in einem neuen Tab) + @endunless + + @if ($row['binding']) + {{ $row['binding']['label'] }} + @endif + + @if ($editable) + @unless ($galerie) + + + + @if ($sortierbar) + + + + + @endif + @include('filament.verwaltung.zuordnung-menue', ['row' => $row, 'mediumUrl' => $mediumUrl, 'galerie' => false]) + + @else + @include('filament.verwaltung.zuordnung-menue', ['row' => $row, 'mediumUrl' => $mediumUrl, 'galerie' => true, 'erste' => $erste, 'letzte' => $letzte, 'sortierbar' => $sortierbar]) + @endunless + @endif +
  • + @endforeach +
+
+ @endforeach + + @if ($gruppen !== []) +

@include('filament.verwaltung.icon', ['name' => 'info'])„Zuordnung entfernen“ löst nur diese Zuordnung. Das Medium bleibt im Bestand, in anderen Verwendungen und mit seiner Website-Freigabe erhalten.

+ @endif +
diff --git a/resources/views/filament/verwaltung/redaktion.blade.php b/resources/views/filament/verwaltung/redaktion.blade.php new file mode 100644 index 0000000..3869f76 --- /dev/null +++ b/resources/views/filament/verwaltung/redaktion.blade.php @@ -0,0 +1,106 @@ +{{-- Gemeinsamer Redaktionsmanager. Die Seite liefert redaktionKopf(), redaktionTitel(), redaktionFelder() und einordnungGruppen(). --}} +@php + $kopf = $this->redaktionKopf(); + $offen = $this->redaktionOffen(); + $register = $this->redaktionOffeneRegister(); + $editable = $this->canEditEditorial(); + $mediengruppen = $this->presentationGroups(); + $medienzahl = array_sum(array_map(fn (array $gruppe): int => count($gruppe['rows']), $mediengruppen)); + $ausgabe = $this->redaktionAusgabe() !== null; + $aktionen = []; + if ($ausgabe) { + $aktionen[] = ['label' => 'Ausgabe prüfen', 'wire' => 'openAusgabe', 'icon' => 'auge']; + } + if ($editable) { + $aktionen[] = ['label' => 'Redaktion speichern', 'wire' => 'saveRedaktion', 'art' => 'primary']; + } +@endphp +
+ @include('filament.verwaltung.kopf', [ + 'zurueck' => ['label' => $kopf['zurueck'], 'wire' => 'closeRedaktion'], + 'brot' => [$kopf['liste'], $this->redaktionTitel()], + 'titel' => $this->redaktionTitel(), + 'typ' => implode(' · ', array_filter(['Redaktion', $kopf['art'], $kopf['typ'] ?? null])), + 'status' => $offen + ? ['text' => 'Änderungen nicht gespeichert', 'ton' => 'offen', 'aktion' => $editable ? ['label' => 'Verwerfen', 'wire' => "askConfirmation('discardRedaktion')"] : null] + : ['text' => 'Alle Änderungen gespeichert', 'ton' => 'gut'], + 'aktionen' => $aktionen, + ]) + +
+ @foreach (['texte' => 'Texte', 'medien' => 'Präsentationsmedien', 'einordnung' => 'Einordnung'] as $wert => $label) + + @endforeach +
+ +
+

@include('filament.verwaltung.icon', ['name' => 'info']){{ $kopf['umfang'] }}

+ @if ($this->deskFeedback !== '') +

$this->deskFeedbackError]) role="{{ $this->deskFeedbackError ? 'alert' : 'status' }}"> + {{ $this->deskFeedback }} + +

+ @endif +
+ +
+ @if ($this->redaktionTab === 'medien') + @include('filament.verwaltung.praesentation', ['gruppen' => $mediengruppen, 'editable' => $editable]) + @elseif ($this->redaktionTab === 'einordnung') + @include('filament.verwaltung.einordnung', ['editable' => $editable]) + @else + @include('filament.verwaltung.texte', ['editable' => $editable]) + @endif +
+ + @if ($this->pickerOpen) + @include('filament.verwaltung.picker') + @endif + + @include('filament.verwaltung.bestaetigung') + @include('filament.verwaltung.abgang', ['offen' => $offen]) + + @if ($this->ausgabeOpen && ($ausgabeDaten = $this->redaktionAusgabe())) + + @endif +
diff --git a/resources/views/filament/verwaltung/styles.blade.php b/resources/views/filament/verwaltung/styles.blade.php new file mode 100644 index 0000000..ba1ae17 --- /dev/null +++ b/resources/views/filament/verwaltung/styles.blade.php @@ -0,0 +1,589 @@ +{{-- Gemeinsame Verwaltungsgestaltung (Dokument 14). Einmal je Seite über PanelsRenderHook::STYLES_AFTER geladen. --}} + diff --git a/resources/views/filament/verwaltung/texte.blade.php b/resources/views/filament/verwaltung/texte.blade.php new file mode 100644 index 0000000..d9286bc --- /dev/null +++ b/resources/views/filament/verwaltung/texte.blade.php @@ -0,0 +1,47 @@ +@php + $felder = $this->redaktionFelder(); + $haupt = array_values(array_filter($felder, fn (array $feld): bool => ($feld['gruppe'] ?? 'haupt') === 'haupt')); + $weitere = array_values(array_filter($felder, fn (array $feld): bool => ($feld['gruppe'] ?? 'haupt') === 'weitere')); + $quelle = method_exists($this, 'redaktionQuelle') ? $this->redaktionQuelle() : null; +@endphp +
+
+
+

Texte

+ @if ($quelle) + Leere Angaben übernehmen den Text aus „{{ $quelle['titel'] }}“. + @endif +
+
+ @foreach ($haupt as $feld) + @include('filament.verwaltung.textfeld', ['feld' => $feld, 'editable' => $editable]) + @endforeach +
+
+
+ @if ($quelle) +
+

Fachliche Quelle

+

{{ $quelle['titel'] }} · {{ $quelle['art'] }}

+

Eigene Angaben gelten nur für {{ $quelle['fuer'] }}. Die Quelle bleibt unverändert.

+ @if (! empty($quelle['url'])) + @include('filament.verwaltung.icon', ['name' => 'extern'])Quelle in neuem Tab öffnen + @endif +
+ @elseif (method_exists($this, 'redaktionOhneQuelle') && ($ohne = $this->redaktionOhneQuelle())) +

@include('filament.verwaltung.icon', ['name' => 'info']){{ $ohne }}

+ @endif + @if ($weitere !== []) +

Weitere Angaben

+
+ @foreach ($weitere as $feld) + @include('filament.verwaltung.textfeld', ['feld' => $feld, 'editable' => $editable]) + @endforeach +
+ @endif + @include('filament.verwaltung.varianten', ['editable' => $editable]) + @if (method_exists($this, 'redaktionTexteHinweis') && ($hinweis = $this->redaktionTexteHinweis())) +

{{ $hinweis }}

+ @endif +
+
diff --git a/resources/views/filament/verwaltung/textfeld.blade.php b/resources/views/filament/verwaltung/textfeld.blade.php new file mode 100644 index 0000000..589b906 --- /dev/null +++ b/resources/views/filament/verwaltung/textfeld.blade.php @@ -0,0 +1,72 @@ +@php + $model = $feld['model']; + $wert = trim((string) $this->{$model}); + $quelleWert = trim((string) ($feld['quelle']['wert'] ?? '')); + $quelleTitel = $feld['quelle']['titel'] ?? null; + $uebernommen = $wert === '' && $quelleWert !== ''; + $geaendert = $this->feldGeaendert($feld); + $fehler = $this->redaktionFehlerFeld === $model; + $lang = mb_strlen($uebernommen ? $quelleWert : $wert) > 220; + $kind = $feld['kind'] ?? 'text'; + $id = 'feld-'.$feld['id']; +@endphp +
$fehler]) wire:key="feld-{{ $feld['id'] }}" x-data="{ offen: @js($fehler), voll: false }"> +
+

{{ $feld['label'] }}@if (! empty($feld['required'])) (Pflichtangabe)@endif

+ @if ($quelleTitel !== null) + @if ($uebernommen) + Übernommen aus {{ $quelleTitel }} + @elseif ($wert !== '') + Eigene Angabe + @endif + @endif + @if ($geaendert) + Geändert + @endif + @if ($editable) + + @endif +
+ +
+ @if ($wert === '' && ! $uebernommen) +

Keine Angabe

+ @else +

$uebernommen, 'is-kurz' => $lang]) x-bind:class="{ 'is-voll': voll }">{{ $uebernommen ? $quelleWert : $wert }}

+ @if ($lang) + + @endif + @endif +
+ + @if ($editable) +
+ + @if ($kind === 'textarea') + + @else + + @endif + @if ($fehler && $this->deskFeedback !== '') +

{{ $this->deskFeedback }}

+ @endif +
+ @if (filled($feld['hilfe'] ?? null)) + {{ $feld['hilfe'] }} + @endif + @if ($quelleTitel !== null && $quelleWert !== '' && $wert === '') + + @endif + @if ($quelleTitel !== null && $wert !== '') + + @endif + @if ($geaendert) + + @endif +
+
+ @endif +
diff --git a/resources/views/filament/verwaltung/varianten.blade.php b/resources/views/filament/verwaltung/varianten.blade.php new file mode 100644 index 0000000..607e998 --- /dev/null +++ b/resources/views/filament/verwaltung/varianten.blade.php @@ -0,0 +1,59 @@ +@php + $varianten = $this->variantRows(); + $kontexte = \App\Domain\Catalog\EditorialProfileReader::AUDIENCES; +@endphp +
+
+

Abweichende Formulierungen

+ @if ($editable) + + @endif +
+

Ohne Abweichung gilt überall die zentrale Angabe. Eine Abweichung gilt nur im gewählten Kontext und ändert die zentrale Angabe nicht.

+ @if ($varianten !== []) +
    + @foreach ($varianten as $variante) +
  • +
    + {{ $kontexte[$variante['audience']] ?? $variante['audience'] }} · {{ $this->variantFieldLabel($variante['field']) }} + @if ($editable) + + + + + @endif +
    + {{ \Illuminate\Support\Str::limit($variante['body'], 220) }} +
  • + @endforeach +
+ @endif + @if ($editable) +
+
+ + +
+ +
+ + + Gespeichert wird mit „Redaktion speichern“. +
+
+ @endif +
diff --git a/resources/views/filament/verwaltung/zuordnung-menue.blade.php b/resources/views/filament/verwaltung/zuordnung-menue.blade.php new file mode 100644 index 0000000..54959df --- /dev/null +++ b/resources/views/filament/verwaltung/zuordnung-menue.blade.php @@ -0,0 +1,32 @@ +@php + $galerie = $galerie ?? false; +@endphp +
+ +
+ @if ($galerie) + + + @if ($sortierbar ?? false) + + + @endif +
+ @endif + + Medium öffnenIn einem neuen Tab. Diese Redaktion bleibt offen. + + @if ($this->canReleasePresentation()) +
+ @if ($row['released']) + + @else + + @endif + @endif +
+
diff --git a/resources/views/layouts/member.blade.php b/resources/views/layouts/member.blade.php new file mode 100644 index 0000000..f88fa17 --- /dev/null +++ b/resources/views/layouts/member.blade.php @@ -0,0 +1,50 @@ + + + + + + @yield('title', 'Mitgliederbereich') + + @fonts + @vite(['resources/css/app.css', 'resources/js/app.js']) + + + +
+ +
+
+ + +
+ @csrf + +
+
+
+ @if (session('status')) +

{{ session('status') }}

+ @endif + @yield('content') +
+
+
+ + + diff --git a/resources/views/layouts/site.blade.php b/resources/views/layouts/site.blade.php new file mode 100644 index 0000000..8591b48 --- /dev/null +++ b/resources/views/layouts/site.blade.php @@ -0,0 +1,29 @@ + + + + + + @yield('title', config('app.name')) + @hasSection('description') + + @endif + @hasSection('canonical') + + @endif + @stack('head') + + @fonts + @vite(['resources/css/app.css', 'resources/js/app.js']) + + + + +
+ @if (session('status')) +

{{ session('status') }}

+ @endif + @yield('content') +
+ + + diff --git a/resources/views/mail/order-confirmed.blade.php b/resources/views/mail/order-confirmed.blade.php new file mode 100644 index 0000000..802382e --- /dev/null +++ b/resources/views/mail/order-confirmed.blade.php @@ -0,0 +1 @@ +Ihre Bestellung {{ $order->id }} ist bezahlt. Die dazugehörigen Inhalte liegen in der Bibliothek. diff --git a/resources/views/member/article.blade.php b/resources/views/member/article.blade.php new file mode 100644 index 0000000..30aaa81 --- /dev/null +++ b/resources/views/member/article.blade.php @@ -0,0 +1,52 @@ +@extends('layouts.member') + +@section('title', $title) + +@section('content') +

Bibliothek

+
+ @if ($kind) +

{{ $kind }}

+ @endif +

{{ $title }}

+ @if ($release?->classification_note) +

{{ $release->classification_note }}

+ @endif +
+ @if ($entries === []) +
+

Kein veröffentlichter Stand

+

Für diesen Eintrag liegt noch kein veröffentlichter Stand vor.

+
+ @else +
    + @foreach ($entries as $entry) +
  1. +

    {{ $entry['role'] }}: {{ $entry['version']->element->working_title }}

    + @if (filled($entry['version']->element->description)) +

    {{ $entry['version']->element->description }}

    + @endif + @if ($entry['playable']) +
    + @include('content.video', [ + 'playback' => ['mode' => $entry['playback'] ?? 'file', 'url' => $entry['url']], + 'poster' => \App\Domain\Media\ThumbnailRef::url('member.thumbnail', 'element', $entry['version']->element->id, $entry['version']->element->thumbnail_path), + ]) + +
    + @elseif ($entry['allowed'] && $entry['url']) +

    Ansehen

    + @else +

    Nicht enthalten. Für diesen Teil liegt keine Freigabe vor.

    + @endif + @if (filled($entry['version']->body)) +
    + {!! nl2br(e($entry['version']->body)) !!} +
    + @endif +
  2. + @endforeach +
+ @endif +

Artikel {{ $article->code }}

+@endsection diff --git a/resources/views/member/dashboard.blade.php b/resources/views/member/dashboard.blade.php new file mode 100644 index 0000000..9dbdb68 --- /dev/null +++ b/resources/views/member/dashboard.blade.php @@ -0,0 +1,30 @@ +@extends('layouts.member') + +@section('title', 'Mitgliederbereich') + +@section('content') +
+

Übersicht

+

Guten Tag, {{ auth()->user()->name }}

+

In der Bibliothek liegen die Übungen und Materialien Ihrer Berechtigungen. Angebote können Sie abrufen oder im Testmodus kaufen.

+
+
+ + + +
+
+ + {{ $programCount }} + Programme + + + {{ $moduleCount }} + Module + + + {{ $materialCount }} + Materialien + +
+@endsection diff --git a/resources/views/member/grants.blade.php b/resources/views/member/grants.blade.php new file mode 100644 index 0000000..51a5d66 --- /dev/null +++ b/resources/views/member/grants.blade.php @@ -0,0 +1,29 @@ +@extends('layouts.member') + +@section('title', 'Meine Lizenzen') + +@section('content') +
+

Getrennt von der Bibliothek

+

Meine Lizenzen

+

Hier stehen Zweck, Herkunft und Zeitraum. Die Inhalte selbst öffnen Sie in der Bibliothek.

+
+ @if ($grants->isEmpty()) +
+

Keine Lizenz

+

Ihnen ist noch keine Lizenz zugeordnet.

+

Zu den Angeboten

+
+ @else +
    + @foreach ($grants as $grant) +
  • +

    {{ $grant->article->code }}

    +

    Zweck: {{ $grant->rights_snapshot['purpose'] ?? 'nicht angegeben' }}

    +

    seit {{ $grant->valid_from?->timezone(config('app.timezone'))->format('d.m.Y') }}

    +

    In der Bibliothek öffnen

    +
  • + @endforeach +
+ @endif +@endsection diff --git a/resources/views/member/library.blade.php b/resources/views/member/library.blade.php new file mode 100644 index 0000000..07117d7 --- /dev/null +++ b/resources/views/member/library.blade.php @@ -0,0 +1,110 @@ +@extends('layouts.member') + +@section('title', match ($sicht) { + 'programme' => 'Programme', + 'module' => 'Module', + default => 'Bibliothek', +}) + +@section('content') +
+

Für die Kursstunde

+

{{ match ($sicht) { + 'programme' => 'Programme', + 'module' => 'Module', + default => 'Bibliothek', + } }}

+

Suchen Sie ein Programm, ein Modul oder ein einzelnes Material und öffnen Sie, was Ihre Lizenz enthält.

+
+ +
+ + + @if ($filterDimensions->isNotEmpty()) + @foreach ($filterDimensions as $dimension) +
+ {{ $dimension->label }} + @foreach ($dimension->values as $value) + + @endforeach +
+ @endforeach + @endif +
+ Verfügbarkeit + + + +
+
+ + Zurücksetzen +
+
+ + @php + $showPrograms = $sicht !== 'module'; + $showModules = $sicht !== 'programme'; + $showMaterials = $sicht === null; + $visible = ($showPrograms ? count($programs) : 0) + ($showModules ? count($modules) : 0) + ($showMaterials ? count($materials) : 0); + @endphp + + @if ($visible === 0) +
+ @if ($libraryEmpty && ($query ?? '') === '' && ($nutzung ?? '') === '' && $dimensionIds === []) +

Noch nichts in der Bibliothek

+

Unter Angebote können Sie ein kostenloses Material abrufen oder ein Angebot im Testmodus kaufen.

+

Zu den Angeboten

+ @else +

Keine Treffer

+

Für diese Suche oder Filterkombination liegt nichts in Ihrer Bibliothek. Setzen Sie die Filter zurück oder sehen Sie die Angebote an.

+

Zu den Angeboten

+ @endif +
+ @else + @if ($showPrograms && $programs !== []) +
+

Programme

+
+ @foreach ($programs as $program) + @include('member.partials.card', [ + 'href' => route('member.program', $program['composition']), + 'card' => $program + [ + 'error' => $program['composition']->thumbnail_error, + ], + ]) + @endforeach +
+
+ @endif + @if ($showModules && $modules !== []) +
+

Module

+
+ @foreach ($modules as $module) + @include('member.partials.card', [ + 'href' => route('member.program', $module['composition']), + 'card' => $module + ['error' => $module['composition']->thumbnail_error], + ]) + @endforeach +
+
+ @endif + @if ($showMaterials && $materials !== []) +
+

Materialien

+
+ @foreach ($materials as $material) + @include('member.partials.card', [ + 'href' => route('member.article', $material['article']), + 'card' => $material, + ]) + @endforeach +
+
+ @endif + @endif +@endsection diff --git a/resources/views/member/materials.blade.php b/resources/views/member/materials.blade.php new file mode 100644 index 0000000..252af8c --- /dev/null +++ b/resources/views/member/materials.blade.php @@ -0,0 +1,40 @@ +@extends('layouts.member') + +@section('title', 'Materialien') + +@section('content') + @inject('courses', App\Http\CourseOutline::class) +
+

Materialien

+

Filme und Materialien

+

Filme und Hörstücke, die Ihre Lizenz zum Abspielen freigibt.

+
+ @php + $films = $grants->filter(function ($grant) { + return $grant->article->currentRelease?->contents->contains( + fn ($content) => in_array($content->elementVersion->element->output_class, ['film', 'audio'], true), + ); + }); + @endphp + @if ($films->isEmpty()) +
+

Kein Film in dieser Lizenz

+

Unter Ihren Berechtigungen ist gerade kein Film oder Hörstück.

+

Zur Bibliothek

+
+ @else +
+ @foreach ($films as $grant) + @include('member.partials.card', [ + 'href' => route('member.article', $grant->article), + 'card' => [ + 'title' => $courses->title($grant->article), + 'kind' => $courses->kindLabel($grant->article), + 'summary' => null, + 'coverage' => 'nutzbar', + ], + ]) + @endforeach +
+ @endif +@endsection diff --git a/resources/views/member/offers.blade.php b/resources/views/member/offers.blade.php new file mode 100644 index 0000000..7113641 --- /dev/null +++ b/resources/views/member/offers.blade.php @@ -0,0 +1,39 @@ +@extends('layouts.member') + +@section('title', 'Angebote') + +@section('content') +
+

Zugang

+

Angebote

+

Ein Abruf legt die Lizenz an. Die Inhalte erscheinen danach in der Bibliothek.

+
+ @if ($errors->any()) + + @endif + @if ($offers->isEmpty()) +

Keine Angebote

Gerade ist kein persönliches Angebot aktiv.

+ @else +
    + @foreach ($offers as $offer) + @php $version = $offer->versions->first(); @endphp +
  • +

    {{ $offer->name }}

    + @if ($version) +

    + @if ($version->grant_kind === 'kauf') + {{ number_format($version->price_cents / 100, 2, ',', '.') }} €, Testzahlung + @else + Kostenlos abrufen + @endif +

    +
    + @csrf + +
    + @endif +
  • + @endforeach +
+ @endif +@endsection diff --git a/resources/views/member/order.blade.php b/resources/views/member/order.blade.php new file mode 100644 index 0000000..4eeb46f --- /dev/null +++ b/resources/views/member/order.blade.php @@ -0,0 +1,38 @@ +@extends('layouts.member') + +@section('title', 'Bestellung') + +@section('content') +
+

Testzahlung

+

Bestellung {{ $order->id }}

+
+ @if ($errors->any()) + + @endif +

Status: {{ $order->status }}

+
    + @foreach ($order->lines as $line) +
  • +

    {{ filled($line->offer_name) ? $line->offer_name : ($line->offerVersion->offer->name ?? 'Angebot') }}

    +

    {{ number_format($line->price_cents / 100, 2, ',', '.') }} €

    +
  • + @endforeach +
+ @if ($testPayment && $order->status === 'offen') +
+ @csrf + +
+
+ @csrf + +
+ @endif + @if ($order->status === 'bezahlt') +
+ @csrf + +
+ @endif +@endsection \ No newline at end of file diff --git a/resources/views/member/partials/card.blade.php b/resources/views/member/partials/card.blade.php new file mode 100644 index 0000000..f8fd531 --- /dev/null +++ b/resources/views/member/partials/card.blade.php @@ -0,0 +1,29 @@ +@php + $coverageLabel = match ($card['coverage'] ?? '') { + 'nutzbar' => 'Nutzbar', + 'teilweise' => 'Teilweise nutzbar', + default => 'Nicht enthalten', + }; +@endphp + diff --git a/resources/views/member/partials/nav.blade.php b/resources/views/member/partials/nav.blade.php new file mode 100644 index 0000000..66dba00 --- /dev/null +++ b/resources/views/member/partials/nav.blade.php @@ -0,0 +1,10 @@ + diff --git a/resources/views/member/partials/structure.blade.php b/resources/views/member/partials/structure.blade.php new file mode 100644 index 0000000..fb00c2a --- /dev/null +++ b/resources/views/member/partials/structure.blade.php @@ -0,0 +1,46 @@ +
    + @foreach ($nodes as $node) +
  1. +
    +

    {{ $node['role'] }}

    +

    {{ $node['role'] }}: @if ($node['program_url'] ?? null){{ $node['title'] }}@else{{ $node['title'] }}@endif

    + @if ($node['kind']) +

    {{ match ($node['kind']) { + 'document' => 'Dokument', + 'film' => 'Film', + 'audio' => 'Hörstück', + 'bild' => 'Bild', + default => $node['kind'], + } }}

    + @endif +
    + @if ($node['output_class'] === 'film' || $node['output_class'] === 'audio') + @if ($node['view_url']) +
    + @if ($node['output_class'] === 'audio') + + @else + @include('content.video', [ + 'playback' => ['mode' => $node['playback'] ?? 'file', 'url' => $node['view_url']], + 'poster' => $node['poster_url'] ?? null, + ]) + + @endif +
    + @else +

    Nicht enthalten. Für diesen Film liegt keine Freigabe vor.

    + @endif + @elseif ($node['view_url']) +

    Ansehen

    + @elseif ($node['children'] === []) +

    Nicht enthalten. Für diesen Teil liegt keine Freigabe vor.

    + @endif + @if ($node['download_url']) +

    Laden

    + @endif + @if ($node['children'] !== []) + @include('member.partials.structure', ['nodes' => $node['children']]) + @endif +
  2. + @endforeach +
diff --git a/resources/views/member/profile.blade.php b/resources/views/member/profile.blade.php new file mode 100644 index 0000000..0cdaf69 --- /dev/null +++ b/resources/views/member/profile.blade.php @@ -0,0 +1,21 @@ +@extends('layouts.member') + +@section('title', 'Profil') + +@section('content') +
+

Profil

+

Profil

+

Ihr Name ist nicht öffentlich.

+
+
+ @csrf + + @error('name') + + @enderror + +
+@endsection diff --git a/resources/views/member/program.blade.php b/resources/views/member/program.blade.php new file mode 100644 index 0000000..3013ae1 --- /dev/null +++ b/resources/views/member/program.blade.php @@ -0,0 +1,64 @@ +@extends('layouts.member') + +@section('title', $title) + +@section('content') +

Bibliothek

+
+ @if ($kind) +

{{ $kind }}

+ @endif +

{{ $title }}

+ @if (filled($summary ?? null)) +

{{ $summary }}

+ @endif + @if (filled($composition->description)) +

{{ $composition->description }}

+ @endif +
+
+
+
Nutzbarkeit
+
{{ match ($coverage) { + 'nutzbar' => 'Nutzbar', + 'teilweise' => 'Teilweise nutzbar', + default => 'Nicht enthalten', + } }}
+
+ @if ($duration_minutes) +
+
Zeit
+
{{ $duration_minutes }} Minuten
+
+ @endif +
+
Vorschaubild
+
+ @if ($picture) + {{ $picture['alt'] ?: 'Vorschaubild' }} + @else + Platzhalter + @endif +
+
+
+ @if (filled($composition->thumbnail_error)) +

{{ $composition->thumbnail_error }}

+ @endif + @if (filled($learning_goal) || $duration_minutes || filled($material_note)) +
+ @if (filled($learning_goal)) +

Lernziel

+

{{ $learning_goal }}

+ @endif + @if (filled($material_note)) +

Material

+

{{ $material_note }}

+ @endif +
+ @endif +
+

Aufbau

+ @include('member.partials.structure', ['nodes' => $nodes]) +
+@endsection diff --git a/resources/views/member/read.blade.php b/resources/views/member/read.blade.php new file mode 100644 index 0000000..c2d1bc0 --- /dev/null +++ b/resources/views/member/read.blade.php @@ -0,0 +1,19 @@ +@extends('layouts.member') + +@section('title', $version->element->working_title) + +@section('content') +

Bibliothek

+
+

{{ $version->element->working_title }}

+ @if (filled($reader ?? null) && filled($copy ?? null)) +

Lizenziert für {{ $reader }} · Lizenzkopie {{ $copy }}

+ @endif + @if (filled($license ?? null)) +

Lizenzkennzeichnung: {{ $license }}

+ @endif +
+ {!! nl2br(e($version->body)) !!} +
+
+@endsection diff --git a/resources/views/public/page.blade.php b/resources/views/public/page.blade.php new file mode 100644 index 0000000..a42abb0 --- /dev/null +++ b/resources/views/public/page.blade.php @@ -0,0 +1,19 @@ +@extends('layouts.site') + +@section('title', $documentTitle) +@section('description', $documentDescription ?? '') +@section('canonical', $page->publicUrl()) +@section('main_class', 'site-main page-sections') + +@push('head') + @if ($preview) + + @endif +@endpush + +@section('content') + @if ($preview) +

Vorschau einer unveröffentlichten Revision. Die öffentliche Seite bleibt unverändert.

+ @endif + @include($template, ['content' => $content, 'page' => $page, 'themes' => $themes ?? collect()]) +@endsection diff --git a/resources/views/public/preview-devices.blade.php b/resources/views/public/preview-devices.blade.php new file mode 100644 index 0000000..dadeee2 --- /dev/null +++ b/resources/views/public/preview-devices.blade.php @@ -0,0 +1,58 @@ + + + + + + + Vorschau {{ $page->path }} · Revision {{ $revision->id }} + + + +
+ Vorschau {{ $page->path }} +

Revision {{ $revision->id }} · {{ $isLive ? 'veröffentlicht' : 'nicht veröffentlicht' }}

+
+ + + +
+

Ohne Rahmen öffnen

+
+
+

Desktop, 1440 px

+
+ +
+
+ + + diff --git a/resources/views/public/program.blade.php b/resources/views/public/program.blade.php new file mode 100644 index 0000000..5e976d9 --- /dev/null +++ b/resources/views/public/program.blade.php @@ -0,0 +1,28 @@ +@extends('layouts.site') + +@section('title', $composition->display_title ?: $composition->designation) + +@section('content') +

Programme

+

{{ $composition->display_title ?: $composition->designation }}

+ @if (filled($composition->summary)) +

{{ $composition->summary }}

+ @endif + @if (filled($version->learning_goal)) +

Lernziel: {{ $version->learning_goal }}

+ @endif +
    + @foreach ($nodes as $node) +
  1. +

    {{ $node->role }}: {{ $node->title }}

    + @if ($node->children !== []) +
      + @foreach ($node->children as $child) +
    1. {{ $child->role }}: {{ $child->title }}
    2. + @endforeach +
    + @endif +
  2. + @endforeach +
+@endsection diff --git a/resources/views/public/programs.blade.php b/resources/views/public/programs.blade.php new file mode 100644 index 0000000..93f172d --- /dev/null +++ b/resources/views/public/programs.blade.php @@ -0,0 +1,17 @@ +@extends('layouts.site') + +@section('title', 'Programme') + +@section('content') +

Programme

+

Gezeigt wird nur eine zur Anzeige freigegebene Programmfassung. Dateien bleiben im Mitgliederbereich.

+ @if ($programs->isEmpty()) +

Noch kein Programm ist öffentlich gelistet.

+ @else + + @endif +@endsection diff --git a/resources/views/public/sitemap.blade.php b/resources/views/public/sitemap.blade.php new file mode 100644 index 0000000..3ffab2c --- /dev/null +++ b/resources/views/public/sitemap.blade.php @@ -0,0 +1,9 @@ +'; ?> + +@foreach ($pages as $page) + {{ $page->publicUrl() }} +@endforeach +@foreach ($themes as $theme) + {{ $theme->publicUrl() }} +@endforeach + diff --git a/resources/views/public/themes/index.blade.php b/resources/views/public/themes/index.blade.php new file mode 100644 index 0000000..ed7060d --- /dev/null +++ b/resources/views/public/themes/index.blade.php @@ -0,0 +1,16 @@ +@extends('layouts.site') + +@section('title', 'Themenbereiche') +@section('canonical', route('themes')) + +@section('content') +
+

Themenbereiche

+

Die fachlichen Säulen des Trainings, jeweils mit den Seiten, die dazu veröffentlicht sind.

+ @if ($themes->isEmpty()) +

Noch kein Themenbereich ist veröffentlicht.

+ @else + @include('public.themes.list', ['themes' => $themes]) + @endif +
+@endsection diff --git a/resources/views/public/themes/list.blade.php b/resources/views/public/themes/list.blade.php new file mode 100644 index 0000000..d676f28 --- /dev/null +++ b/resources/views/public/themes/list.blade.php @@ -0,0 +1,10 @@ +
    + @foreach ($themes as $theme) +
  • + {{ $theme->name }} + @if (filled($theme->public_summary)) +

    {{ $theme->public_summary }}

    + @endif +
  • + @endforeach +
diff --git a/resources/views/public/themes/show.blade.php b/resources/views/public/themes/show.blade.php new file mode 100644 index 0000000..5860fa6 --- /dev/null +++ b/resources/views/public/themes/show.blade.php @@ -0,0 +1,22 @@ +@extends('layouts.site') + +@section('title', $theme->name) +@section('description', $documentDescription) +@section('canonical', $theme->publicUrl()) + +@section('content') +
+

Themenbereiche

+

{{ $theme->name }}

+ @if (filled($theme->public_summary)) +

{{ $theme->public_summary }}

+ @endif + @if ($pages->isNotEmpty()) + + @endif +
+@endsection diff --git a/resources/views/site/templates/standard.blade.php b/resources/views/site/templates/standard.blade.php new file mode 100644 index 0000000..8d259e1 --- /dev/null +++ b/resources/views/site/templates/standard.blade.php @@ -0,0 +1,12 @@ +{{-- Seitenvorlage „standard“: Abschnitte untereinander; jeder Abschnitt bestimmt Raster, Fläche und Breite selbst. --}} +{{ $content }} +@if ($page->path === '/' && $themes->isNotEmpty()) +
+
+
+

Themenbereiche

+ @include('public.themes.list', ['themes' => $themes]) +
+
+
+@endif diff --git a/resources/views/widgets/call_to_action.blade.php b/resources/views/widgets/call_to_action.blade.php new file mode 100644 index 0000000..ae6c644 --- /dev/null +++ b/resources/views/widgets/call_to_action.blade.php @@ -0,0 +1,9 @@ +
+

{{ $data['heading'] ?? '' }}

+ @if (filled($data['text'] ?? null)) +

{{ $data['text'] }}

+ @endif + @if (\App\Domain\Cms\Widgets\Support\SafeUrl::isSafe($data['url'] ?? null)) + {{ $data['label'] ?? '' }} + @endif +
diff --git a/resources/views/widgets/cards.blade.php b/resources/views/widgets/cards.blade.php new file mode 100644 index 0000000..3b4d2bb --- /dev/null +++ b/resources/views/widgets/cards.blade.php @@ -0,0 +1,38 @@ +{{-- + Redaktionelle Karten. Varianten: standard (Raster), compact (Liste), featured (erste Karte hervorgehoben). + Die ganze Karte ist über den Titellink klickbar (gestreckter Link); Bilder sind dekorativ. +--}} +@php + $variant = in_array($variant, ['standard', 'compact', 'featured'], true) ? $variant : 'standard'; +@endphp +@if ($items !== []) +
    + @foreach ($items as $item) +
  • $item['imageUrl'], + 'card-linked' => $item['url'], + 'card-lead' => $variant === 'featured' && $loop->first, + ])> + @if ($item['imageUrl']) +
    + +
    + @endif +
    +

    + @if ($item['url']) + {{ $item['title'] }} + @else + {{ $item['title'] }} + @endif +

    + @if (filled($item['text'])) +

    {{ $item['text'] }}

    + @endif +
    +
  • + @endforeach +
+@endif +@include('widgets.partials.image-notice') diff --git a/resources/views/widgets/catalog_cards.blade.php b/resources/views/widgets/catalog_cards.blade.php new file mode 100644 index 0000000..45f2d15 --- /dev/null +++ b/resources/views/widgets/catalog_cards.blade.php @@ -0,0 +1,47 @@ +{{-- + Programm- und Modulkarten. Titel, Kurzbeschreibung, Art und Ziel kommen zur Laufzeit aus den maßgeblichen + Fachdaten (PublicCatalogReader); nichts davon wird im CMS gespeichert. Statt Bildern trägt eine Markentafel die Art. + Darstellung nach Slotbreite: schmal gestapelt, breit mit Tafel neben dem Text (siehe widgets.css). +--}} +@if ($entries !== [] || $context->preview) +
+ @if (filled($data['heading'] ?? null)) +

{{ $data['heading'] }}

+ @endif + @if (filled($data['intro'] ?? null)) +

{{ $data['intro'] }}

+ @endif + @if ($entries === []) +

Noch kein Programm oder Modul gewählt, oder keines ist öffentlich sichtbar. Öffentlich erscheint dieser Abschnitt nicht.

+ @else +
    + @foreach ($entries as $entry) +
  • $entry->url, 'catalog-card-internal' => ! $entry->public])> + @if ($variant !== 'compact') + + @endif +
    +

    {{ $entry->kindLabel }}

    +

    + @if ($entry->url) + {{ $entry->title }} + @else + {{ $entry->title }} + @endif +

    + @if ($variant !== 'compact' && filled($entry->summary)) +

    {{ $entry->summary }}

    + @endif + @unless ($entry->public) +

    Nur in der Redaktionsvorschau sichtbar: Für diese fachliche Materialart gibt es noch keine öffentliche Freigabe (öffentliches Profil, ADR-29).

    + @endunless +
    +
  • + @endforeach +
+ @endif +
+@endif diff --git a/resources/views/widgets/faq.blade.php b/resources/views/widgets/faq.blade.php new file mode 100644 index 0000000..435e11d --- /dev/null +++ b/resources/views/widgets/faq.blade.php @@ -0,0 +1,6 @@ +
+ @foreach ($data['items'] ?? [] as $item) +
{{ $item['question'] ?? '' }}
+
{{ $item['answer'] ?? '' }}
+ @endforeach +
diff --git a/resources/views/widgets/heading.blade.php b/resources/views/widgets/heading.blade.php new file mode 100644 index 0000000..68c03f4 --- /dev/null +++ b/resources/views/widgets/heading.blade.php @@ -0,0 +1,8 @@ +@if (! empty($first)) +

{{ $data['heading'] ?? '' }}

+@else +

{{ $data['heading'] ?? '' }}

+@endif +@if (filled($data['intro'] ?? null)) +

{{ $data['intro'] }}

+@endif diff --git a/resources/views/widgets/hero.blade.php b/resources/views/widgets/hero.blade.php new file mode 100644 index 0000000..b263901 --- /dev/null +++ b/resources/views/widgets/hero.blade.php @@ -0,0 +1,46 @@ +{{-- + Premium-Einstieg (Brand-UI-Kit v1.6, Komponente lf-hero), angepasst an die Widget-Hülle der Registry. + Varianten: photo_split (Foto mit heller Textfläche), editorial_solid (Navy-Markenfläche ohne Foto). + Höhen compact/normal/large sind Mindesthöhen ab 860 px Containerbreite; darunter Sicherheitsumbruch. + Das Bild des ersten Widgets der Seite wird sofort geladen, alle anderen verzögert. +--}} +@php + $layout = $variant === 'editorial_solid' ? 'editorial-solid' : 'photo-split'; + $heightClass = in_array($height, ['compact', 'normal', 'large'], true) ? $height : 'normal'; + $tag = \App\Domain\Cms\Widgets\Support\PremiumFields::headingTag($settings, ! empty($first)); + $loading = ! empty($first) ? 'loading="eager" fetchpriority="high"' : 'loading="lazy"'; +@endphp +
+
+ @if ($layout === 'photo-split' && $imageUrl) + {{ $imageAlt ?? '' }} + @endif +
+
+ @if ($accent === 'rays') + + @endif + @if (filled($data['eyebrow'] ?? null)) +

{{ $data['eyebrow'] }}

+ @endif + <{{ $tag }} class="lf-hero__title">{{ $data['heading'] ?? '' }} + @if ($accent !== 'none') + + @endif + @if (filled($data['text'] ?? null)) +

{{ $data['text'] }}

+ @endif + @if ($actions !== []) + + @endif +
+
+ +
+
+@include('widgets.partials.image-notice') diff --git a/resources/views/widgets/image_text.blade.php b/resources/views/widgets/image_text.blade.php new file mode 100644 index 0000000..d1c1d72 --- /dev/null +++ b/resources/views/widgets/image_text.blade.php @@ -0,0 +1,48 @@ +{{-- + Premium-Bild-und-Text (Brand-UI-Kit v1.6, Komponente lf-bild-text), angepasst an die Widget-Hülle der Registry. + Darstellung nach tatsächlicher Containerbreite: unter 540 px gestapelt, 540–899 px flacher Bildstreifen, + ab 900 px zweispaltig mit Bild links oder rechts (Variante). Die Höhe ändert Bildproportion und Abstände, + nie die zulässige Textmenge. Der Text ist bereits bereinigter formatierter Text (RichText::sanitize). +--}} +@php + $side = $variant === 'image_left' ? 'left' : 'right'; + $heightClass = in_array($height, ['compact', 'normal', 'spacious'], true) ? $height : 'normal'; + $tag = \App\Domain\Cms\Widgets\Support\PremiumFields::headingTag($settings, ! empty($first)); +@endphp +
+
! $imageUrl, + ]) style="--bt-focus-x: {{ $focus['x'] }}%; --bt-focus-y: {{ $focus['y'] }}%"> +
+ @if (filled($data['eyebrow'] ?? null)) +

{{ $data['eyebrow'] }}

+ @endif + @if (filled($data['title'] ?? null)) + <{{ $tag }} class="lf-bt__headline">{{ $data['title'] }} + + @endif +
{!! $body !!}
+ @if ($actions !== []) +
+ @foreach ($actions as $index => $item) + @if ($index === 0) + {{ $item['label'] }} + @else + {{ $item['label'] }} + @endif + @endforeach +
+ @endif +
+ @if ($imageUrl) +
+ {{ $imageAlt ?? '' }} +
+ @endif +
+
+@include('widgets.partials.image-notice') diff --git a/resources/views/widgets/partials/image-notice.blade.php b/resources/views/widgets/partials/image-notice.blade.php new file mode 100644 index 0000000..cd1d754 --- /dev/null +++ b/resources/views/widgets/partials/image-notice.blade.php @@ -0,0 +1,4 @@ +{{-- Nur Redaktionsvorschau: Das gewählte Bild erscheint öffentlich nicht (fehlende Website-Freigabe, Verarbeitung). --}} +@if (! empty($imageNotice) && $context->preview) +

{{ $imageNotice }}

+@endif diff --git a/resources/views/widgets/premium_card.blade.php b/resources/views/widgets/premium_card.blade.php new file mode 100644 index 0000000..87542b7 --- /dev/null +++ b/resources/views/widgets/premium_card.blade.php @@ -0,0 +1,108 @@ +{{-- + Premium-Karte (Brand-UI-Kit v1.7, Entwurf zur visuellen Freigabe) für Themen-, Medien-, Material- und Programmkarten. + Alle Texte und das Linkziel kommen aus $subject (Fachdaten zur Laufzeit, PublicCatalogReader/PublicMaterialReader); + redaktionell sind nur Kartenbild, Alternativtext, Bildausschnitt, Beschriftung der Aktion und Hinweis. + + Bildbereich, in dieser Reihenfolge: + 1. Kartenbild aus dem öffentlichen Website-Bereich (Reiter „Medien“) – öffentlich und in der Vorschau. + 2. Nur Redaktionsvorschau: Vorschaubild der Bibliothek (Filmstandbild, Modulvorschau), deutlich als nicht + öffentlich markiert. Es hat keine Freigabe für die Website und wird öffentlich nie ausgegeben. + 3. Tafel nach Fachobjekt: Programm/Modul (Navy), Film (Filmtafel), Material (Materialsymbol); Thema ohne Bildbereich. + Hinweise auf fehlende Inhalte stehen nur in der Redaktionsvorschau, öffentlich nie. +--}} +@if ($subject === null) + @if ($context->preview) +

Kein Objekt verknüpft, oder das verknüpfte Objekt ist archiviert beziehungsweise gesperrt. Öffentlich erscheint diese Karte nicht.

+ @endif +@elseif ($subject->public || $context->preview) + @php + $libraryImage = $imageUrl === null && $context->preview ? $subject->previewImage : null; + $panel = $imageUrl === null && $libraryImage === null ? $subject->visual : null; + $action = $show['action'] && $subject->url !== null ? ['url' => $subject->url, 'label' => $actionLabel] : null; + $meta = $show['meta'] ? $subject->meta : []; + $hints = $subject->missing; + $panelName = ['catalog' => 'die Navy-Tafel', 'film' => 'die Filmtafel', 'material' => 'das Materialsymbol'][$subject->visual] ?? 'die Karte ohne Bild'; + if ($context->preview && $imageUrl === null) { + $hints[] = $subject->previewImage !== null + ? 'Das Vorschaubild der Bibliothek ist nicht für die Website freigegeben; öffentlich erscheint stattdessen '.$panelName.'. Ein freigegebenes Motiv kann im Reiter „Medien“ als Kartenbild gewählt werden.' + : 'Kein Kartenbild gewählt; öffentlich erscheint '.$panelName.' (Kartenbild im Reiter „Medien“).'; + } + @endphp +
$stacked, + 'lf-pc--without-visual' => $imageUrl === null && $libraryImage === null && $panel === null, + 'lf-pc--internal' => ! $subject->public, + ]) style="--pc-focus-x: {{ $focus['x'] }}%; --pc-focus-y: {{ $focus['y'] }}%"> + @if ($imageUrl !== null || $libraryImage !== null) +
+ {{ $imageUrl !== null ? $alt : '' }} + @if ($show['kind'] && $subject->badge !== null) + {{ $subject->badge }} + @endif + @if ($libraryImage !== null) + Bibliotheksbild · nur Vorschau + @endif +
+ @elseif ($panel !== null) + + @endif +
+ @if ($show['kind'] && $subject->kind !== '') +

{{ $subject->kind }}

+ @endif + <{{ $headingTag }} class="lf-pc__title">{{ $subject->title }} + @if ($show['summary'] && filled($subject->summary)) +

{{ $subject->summary }}

+ @endif + @if ($meta !== []) +
    + @foreach ($meta as $item) +
  • {{ $item }}
  • + @endforeach +
+ @endif + @if ($action !== null || $note !== null) + + @endif + @if ($context->preview && (! $subject->public || $hints !== [])) + @unless ($subject->public) +

Nur Redaktionsvorschau

+ @endunless +
+ Hinweise für die Redaktion ({{ count($hints) + ($subject->public ? 0 : 1) }}) + @if (! $subject->public && $subject->notice !== null) +

{{ $subject->notice }}

+ @endif + @if ($hints !== []) +

Für eine vollständige Karte fehlt:

+
    + @foreach ($hints as $hint) +
  • {{ $hint }}
  • + @endforeach +
+ @endif +
+ @endif +
+
+ @include('widgets.partials.image-notice') +@endif diff --git a/resources/views/widgets/prose.blade.php b/resources/views/widgets/prose.blade.php new file mode 100644 index 0000000..5ed6931 --- /dev/null +++ b/resources/views/widgets/prose.blade.php @@ -0,0 +1,7 @@ +@if (filled($data['body'] ?? null)) +
+ @foreach (preg_split("/\n\s*\n/", trim($data['body'])) as $paragraph) +

{{ $paragraph }}

+ @endforeach +
+@endif diff --git a/routes/console.php b/routes/console.php new file mode 100644 index 0000000..3c9adf1 --- /dev/null +++ b/routes/console.php @@ -0,0 +1,8 @@ +comment(Inspiring::quote()); +})->purpose('Display an inspiring quote'); diff --git a/routes/web.php b/routes/web.php new file mode 100644 index 0000000..70fa10a --- /dev/null +++ b/routes/web.php @@ -0,0 +1,114 @@ +name('home'); +Route::get('/sitemap.xml', [PageController::class, 'sitemap'])->name('sitemap'); +Route::get('/themen', [ThemeController::class, 'index'])->name('themes'); +Route::get('/programme', [PublicCatalogController::class, 'index'])->name('public.programs'); +Route::get('/programme/{composition}', [PublicCatalogController::class, 'program'])->name('public.program'); +Route::get('/themen/{slug}', [ThemeController::class, 'show'])->name('theme')->where('slug', '[a-z0-9]+(?:-[a-z0-9]+)*'); +Route::get('/medien/{path}', [PublicMediaController::class, 'show'])->where('path', '.*')->name('media.public'); +Route::get('/website-medien/{element}', [WebsiteMediaController::class, 'show'])->whereNumber('element')->name('website.media'); + +Route::middleware('guest')->group(function () { + Route::get('/registrieren', [RegistrationController::class, 'create'])->name('register'); + Route::post('/registrieren', [RegistrationController::class, 'store']); + Route::get('/anmelden', [SessionController::class, 'create'])->name('login'); + Route::post('/anmelden', [SessionController::class, 'store'])->middleware('throttle:6,1'); + Route::get('/passwort/vergessen', [PasswordResetController::class, 'requestForm'])->name('password.request'); + Route::post('/passwort/vergessen', [PasswordResetController::class, 'send'])->name('password.email'); + Route::get('/passwort/zuruecksetzen/{token}', [PasswordResetController::class, 'resetForm'])->name('password.reset'); + Route::post('/passwort/zuruecksetzen', [PasswordResetController::class, 'reset'])->name('password.update'); +}); + +Route::post('/abmelden', [SessionController::class, 'destroy'])->middleware('auth')->name('logout'); + +Route::get('/redaktion/vorschau/{revision}', [PageController::class, 'preview']) + ->middleware('auth:staff') + ->whereNumber('revision') + ->name('pages.preview'); +Route::get('/redaktion/vorschau/{revision}/geraete', [PageController::class, 'devices']) + ->middleware('auth:staff') + ->whereNumber('revision') + ->name('pages.preview.devices'); +Route::get('/redaktion/aufbau/{composition}/entwurf', [EditorialPreviewController::class, 'draft']) + ->middleware('auth:staff') + ->name('editorial.draft-preview'); +Route::get('/redaktion/aufbau/{composition}/{version?}', [EditorialPreviewController::class, 'show']) + ->middleware('auth:staff') + ->name('editorial.preview'); +Route::get('/redaktion/frame/{version}', [EditorialPreviewController::class, 'frame']) + ->middleware('auth:staff') + ->name('editorial.frame'); +Route::get('/redaktion/karte/{kind}/{subject}', [EditorialPreviewController::class, 'card']) + ->middleware('auth:staff') + ->whereIn('kind', ['element', 'komposition']) + ->whereNumber('subject') + ->name('editorial.card'); +Route::get('/redaktion/inhalt/{version}', [ContentPreviewController::class, 'show']) + ->middleware('auth:staff') + ->name('content.preview'); +Route::get('/redaktion/inhalt/{version}/datei', [ContentPreviewController::class, 'file']) + ->middleware('auth:staff') + ->name('content.file'); +Route::get('/redaktion/inhalt/{version}/ableitung/{datei}', [ContentPreviewController::class, 'rendition']) + ->middleware('auth:staff') + ->where('datei', '.*') + ->name('content.rendition'); + +Route::middleware('auth')->group(function () { + Route::get('/email/bestaetigen', [EmailVerificationController::class, 'notice'])->name('verification.notice'); + Route::get('/email/bestaetigen/{id}/{hash}', [EmailVerificationController::class, 'verify']) + ->middleware('signed:relative') + ->name('verification.verify'); + Route::post('/email/erneut', [EmailVerificationController::class, 'send']) + ->middleware('throttle:6,1') + ->name('verification.send'); +}); + +Route::middleware(['auth', 'verified'])->prefix('bereich')->name('member.')->group(function () { + Route::get('/', [MemberController::class, 'dashboard'])->name('dashboard'); + Route::get('/bibliothek', [LibraryController::class, 'index'])->name('library'); + Route::get('/bibliothek/programme', [LibraryController::class, 'programs'])->name('programs'); + Route::get('/bibliothek/module', [LibraryController::class, 'modules'])->name('modules'); + Route::get('/bibliothek/programm/{composition}', [LibraryController::class, 'program'])->name('program'); + Route::get('/bibliothek/{article}', [LibraryController::class, 'show'])->name('article'); + Route::get('/ausgabe/{article}/{release}/{version}/{action}', [LibraryController::class, 'media']) + ->middleware('signed:relative') + ->name('media'); + Route::get('/abschnitt/{article}/{release}/{version}/{datei}', [LibraryController::class, 'rendition']) + ->where('datei', '.*') + ->middleware('signed:relative') + ->name('rendition'); + Route::get('/vorschau/{kind}/{subject}', [LibraryController::class, 'thumbnail']) + ->whereNumber('subject') + ->name('thumbnail'); + Route::get('/materialien', [LibraryController::class, 'materials'])->name('materials'); + Route::get('/berechtigungen', [LibraryController::class, 'grants'])->name('grants'); + Route::get('/angebote', [CheckoutController::class, 'offers'])->name('offers'); + Route::post('/angebote/{offer}/abrufen', [CheckoutController::class, 'claim'])->name('offers.claim'); + Route::post('/angebote/{offer}/kaufen', [CheckoutController::class, 'place'])->name('offers.buy'); + Route::get('/bestellung/{order}', [CheckoutController::class, 'show'])->name('order'); + Route::post('/bestellung/{order}/bestaetigen', [CheckoutController::class, 'confirm'])->name('order.confirm'); + Route::post('/bestellung/{order}/ablehnen', [CheckoutController::class, 'fail'])->name('order.fail'); + Route::post('/bestellung/{order}/widerrufen', [CheckoutController::class, 'refund'])->name('order.refund'); + Route::get('/profil', [MemberController::class, 'profile'])->name('profile'); + Route::post('/profil', [MemberController::class, 'updateProfile'])->name('profile.update'); +}); + +Route::get('/{path}', [PageController::class, 'show'])->where('path', '[a-z0-9\-]+')->name('page'); diff --git a/scripts/ci-test.sh b/scripts/ci-test.sh new file mode 100644 index 0000000..b0eeff4 --- /dev/null +++ b/scripts/ci-test.sh @@ -0,0 +1,63 @@ +#!/usr/bin/env bash +# Qualitätsprüfung eines Commits: baut das Test-Image und führt Pint und die Testsuite im Wegwerf-Container aus. +# Die fachlichen Tests nutzen SQLite im Speicher (phpunit.xml). Die Migrationen laufen zusätzlich gegen eine +# Wegwerf-Postgres, nicht gegen luf-test oder luf-prod. +# Aufruf im ausgecheckten Repo: bash scripts/ci-test.sh +set -euo pipefail + +SHA="$(git rev-parse --short=12 HEAD)" +IMG="luf-ci-test:$SHA" +NET="luf-ci-$SHA" +PG="luf-ci-pg-$SHA" + +cleanup() { + docker rm -f "$PG" >/dev/null 2>&1 || true + docker network rm "$NET" >/dev/null 2>&1 || true + docker rmi -f "$IMG" >/dev/null 2>&1 || true +} +trap cleanup EXIT + +echo "=== Test-Image bauen ($SHA) ===" +docker build --target test -t "$IMG" . + +echo "=== Pint und Tests (SQLite) ===" +docker run --rm \ + -e APP_ENV=testing \ + -e APP_KEY="base64:$(head -c 32 /dev/urandom | base64)" \ + "$IMG" + +echo "=== Migrationen gegen Wegwerf-Postgres ===" +docker network create "$NET" +docker run -d --name "$PG" --network "$NET" \ + -e POSTGRES_USER=luf \ + -e POSTGRES_PASSWORD=luf \ + -e POSTGRES_DB=luf \ + postgres:17-alpine + +ready=0 +for _ in $(seq 1 30); do + if docker exec "$PG" pg_isready -U luf -d luf >/dev/null 2>&1; then + ready=1 + break + fi + sleep 1 +done + +if [ "$ready" -ne 1 ]; then + echo "Postgres ist nicht bereit." >&2 + exit 1 +fi + +docker run --rm --network "$NET" \ + -e APP_ENV=testing \ + -e APP_KEY="base64:$(head -c 32 /dev/urandom | base64)" \ + -e DB_CONNECTION=pgsql \ + -e DB_HOST="$PG" \ + -e DB_PORT=5432 \ + -e DB_DATABASE=luf \ + -e DB_USERNAME=luf \ + -e DB_PASSWORD=luf \ + --entrypoint php \ + "$IMG" artisan migrate --force --no-interaction + +echo "✓ Qualitätsprüfung bestanden ($SHA)" diff --git a/scripts/deploy.sh b/scripts/deploy.sh new file mode 100644 index 0000000..dc14d10 --- /dev/null +++ b/scripts/deploy.sh @@ -0,0 +1,154 @@ +#!/usr/bin/env bash +# LUF-Deploy. Wird vom Gitea-Workflow aufgerufen, nachdem APP_DIR auf den getesteten Commit steht. +# Ablauf: Konfiguration prüfen -> Portprüfung -> Build -> DB starten -> Migration -> Start -> Health. +# Schlägt ein Schritt fehl, wird auf den zuletzt erfolgreichen Image-Tag zurückgesetzt (Code, nicht Migrationen). +# +# Erwartete Variablen (setzt der Workflow): +# LUF_ENV test | prod +# APP_DIR Deploy-Verzeichnis (Git-Checkout) +# ENV_FILE Env-Datei außerhalb des Repos (/etc/luf/.env) +# COMPOSE_PROJECT Compose-Projektname (luf-test | luf-prod) +# WEB_PORT Host-Port des Web-Containers +set -euo pipefail + +: "${LUF_ENV:?LUF_ENV fehlt}" "${APP_DIR:?APP_DIR fehlt}" "${ENV_FILE:?ENV_FILE fehlt}" +: "${COMPOSE_PROJECT:?COMPOSE_PROJECT fehlt}" "${WEB_PORT:?WEB_PORT fehlt}" + +case "$LUF_ENV" in + test|prod) ;; + *) echo "✗ LUF_ENV=$LUF_ENV, erlaubt: test | prod"; exit 1 ;; +esac + +# Ein Deploy gleichzeitig pro Host (Build braucht RAM, Ports und Images werden gemeinsam genutzt). +exec 9>/tmp/luf-deploy.lock +flock -w 1200 9 || { echo "✗ Deploy-Sperre nach 20 min nicht erhalten"; exit 1; } + +cd "$APP_DIR" +LUF_TAG="$(git rev-parse --short=12 HEAD)" +PREV_TAG="$(cat .last_good_tag 2>/dev/null || true)" +export LUF_ENV LUF_TAG LUF_ENV_FILE="$ENV_FILE" LUF_WEB_PORT="$WEB_PORT" + +dc() { + docker compose -p "$COMPOSE_PROJECT" -f docker-compose.yml --env-file "$ENV_FILE" "$@" +} + +env_value() { + grep -E "^$1=" "$ENV_FILE" | tail -1 | cut -d= -f2- | tr -d "\"'" || true +} + +# --- 1. Konfiguration prüfen (keine Werte ausgeben) -------------------------------------------- +if [ ! -r "$ENV_FILE" ]; then + echo "✗ $ENV_FILE fehlt oder ist nicht lesbar."; exit 1 +fi +for var in APP_KEY APP_URL DB_DATABASE DB_USERNAME DB_PASSWORD; do + if [ -z "$(env_value "$var")" ]; then + echo "✗ $var ist in $ENV_FILE nicht gesetzt."; exit 1 + fi +done +app_env="$(env_value APP_ENV)" +if [ "$LUF_ENV" = prod ]; then + [ "$app_env" = production ] || { echo "✗ Prod braucht APP_ENV=production."; exit 1; } + [ "$(env_value APP_DEBUG)" = false ] || { echo "✗ Prod braucht APP_DEBUG=false."; exit 1; } +else + [ "$app_env" != production ] || { echo "✗ Test darf nicht APP_ENV=production haben."; exit 1; } +fi +echo "✓ $ENV_FILE geprüft ($LUF_ENV, Tag $LUF_TAG, vorheriger Tag ${PREV_TAG:-keiner})" + +# --- 1b. Medien-Ablage (NFS-Mount vom NAS) ----------------------------------------------------- +# Pfad ist fest an die Umgebung gebunden: Test kann nie auf den Prod-Bestand zeigen. +MEDIA_HOST="/srv/luf/$LUF_ENV/media" +media_env="$(env_value LUF_MEDIA_HOST)" +if [ -n "$media_env" ] && [ "$media_env" != "$MEDIA_HOST" ]; then + echo "✗ LUF_MEDIA_HOST in $ENV_FILE weicht von $MEDIA_HOST ab."; exit 1 +fi +export LUF_MEDIA_HOST="$MEDIA_HOST" +# Zugriff löst den automount aus; timeout, weil der Mount hart ist und bei NAS-Ausfall hängen würde. +timeout 30 ls "$MEDIA_HOST" >/dev/null 2>&1 || { echo "✗ $MEDIA_HOST nicht erreichbar (NAS/NFS-Mount prüfen)."; exit 1; } +if ! findmnt -n -t nfs4 -M "$MEDIA_HOST" >/dev/null; then + echo "✗ $MEDIA_HOST ist kein NFS-Mount. Es werden keine Medien auf die lokale Platte geschrieben."; exit 1 +fi +for d in originals derived public; do + [ -d "$MEDIA_HOST/$d" ] || timeout 30 mkdir -p "$MEDIA_HOST/$d" || { echo "✗ $MEDIA_HOST/$d fehlt und lässt sich nicht anlegen."; exit 1; } +done +echo "✓ Medien: $MEDIA_HOST (NFS), originals/derived/public vorhanden" + +# --- 2. Portkonflikt: Port darf nur von diesem Projekt belegt sein ----------------------------- +if ss -ltnH "sport = :$WEB_PORT" | grep -q .; then + if [ -z "$(dc ps -q web 2>/dev/null)" ]; then + echo "✗ Host-Port $WEB_PORT ist von einem fremden Dienst belegt. Abbruch."; exit 1 + fi +fi + +wait_for_db() { + local i status + for i in $(seq 1 40); do + status="$(docker inspect -f '{{.State.Health.Status}}' "$(dc ps -q db)" 2>/dev/null || true)" + [ "$status" = healthy ] && return 0 + sleep 3 + done + echo "✗ Datenbank nicht healthy"; return 1 +} + +wait_for_web() { + local i + for i in $(seq 1 60); do + if curl -sf -o /dev/null "http://127.0.0.1:$WEB_PORT/up"; then + echo "✓ /up antwortet (http://127.0.0.1:$WEB_PORT/up)"; return 0 + fi + sleep 3 + done + echo "✗ /up nicht erreichbar"; return 1 +} + +deploy() { + echo "=== LUF $LUF_ENV: Build $LUF_TAG ===" + dc build app web || return 1 + # Schreibprobe als www-data (echte UID im Container) auf den Medienordnern der Hintergrundverarbeitung. + dc run --rm --no-deps -T queue sh -c 'for f in "$MEDIA_ORIGINALS_PATH" "$MEDIA_DERIVED_PATH" "$MEDIA_PUBLIC_PATH"; do t="$f/.write-test-$$"; touch "$t" && rm "$t" || exit 1; done' \ + || { echo "✗ Schreibprobe auf $LUF_MEDIA_HOST fehlgeschlagen (NFS-Rechte/Squash auf dem NAS prüfen)"; return 1; } + echo "✓ Schreibprobe auf $LUF_MEDIA_HOST bestanden" + dc up -d db || return 1 + wait_for_db || return 1 + echo "=== Migrationen ===" + dc run --rm --no-deps -T app php artisan migrate --force || return 1 + echo "=== Start ===" + dc up -d --remove-orphans || return 1 + wait_for_web || return 1 + # Die App muss die Datenbank wirklich erreichen, nicht nur Nginx antworten lassen. + dc exec -T app php artisan migrate:status >/dev/null || { echo "✗ App erreicht die Datenbank nicht"; return 1; } + echo "✓ App erreicht die Datenbank" +} + +rollback() { + if [ -z "$PREV_TAG" ] || [ "$PREV_TAG" = "$LUF_TAG" ]; then + echo "✗ Kein Rollback möglich (kein früherer Stand bekannt)."; return 1 + fi + for img in "luf-app-$LUF_ENV:$PREV_TAG" "luf-web-$LUF_ENV:$PREV_TAG"; do + docker image inspect "$img" >/dev/null 2>&1 || { echo "✗ Rollback-Image $img fehlt."; return 1; } + done + echo "=== Rollback auf $PREV_TAG (Datenbank-Migrationen werden nicht zurückgenommen) ===" + export LUF_TAG="$PREV_TAG" + dc up -d --no-build --remove-orphans || return 1 + wait_for_web +} + +prune_images() { + local repo + for repo in "luf-app-$LUF_ENV" "luf-web-$LUF_ENV"; do + docker image ls "$repo" --format '{{.Tag}}' \ + | grep -v -x -e "$LUF_TAG" -e "${PREV_TAG:-none}" | tail -n +3 \ + | xargs -r -I{} docker rmi "$repo:{}" >/dev/null 2>&1 || true + done +} + +if deploy; then + echo "$LUF_TAG" > .last_good_tag + prune_images + echo "=== LUF $LUF_ENV Deploy abgeschlossen ($LUF_TAG) ===" +else + echo "✗ Deploy fehlgeschlagen. Zustand:" + dc ps || true + dc logs --tail 80 app web || true + rollback || true + exit 1 +fi diff --git a/scripts/paket0-readonly-extra.sql b/scripts/paket0-readonly-extra.sql new file mode 100644 index 0000000..d122182 --- /dev/null +++ b/scripts/paket0-readonly-extra.sql @@ -0,0 +1,19 @@ +\echo '=== Aktive Angebotsfassungen (Überblick) ===' +SELECT ov.offer_id, o.name, ov.number, ov.grant_kind, ov.price_cents +FROM offer_versions ov +JOIN offers o ON o.id = ov.offer_id +WHERE ov.status = 'aktiv' +ORDER BY ov.offer_id, ov.number; + +\echo '=== Heutige Registrierungslogik: alle aktiven personen-Registrierungsfassungen ===' +SELECT count(*)::int AS would_issue_count +FROM offer_versions +WHERE status = 'aktiv' AND grant_kind = 'bei_registrierung' AND holder_kind = 'person'; + +\echo '=== Grants je Angebot (über acquisition reference offer) ===' +SELECT a.reference_id AS offer_id, count(DISTINCT g.id)::int AS grant_count +FROM acquisitions a +JOIN grants g ON g.acquisition_id = a.id +WHERE a.reference_type = 'offer' +GROUP BY a.reference_id +ORDER BY a.reference_id; \ No newline at end of file diff --git a/scripts/paket0-readonly.sql b/scripts/paket0-readonly.sql new file mode 100644 index 0000000..281d836 --- /dev/null +++ b/scripts/paket0-readonly.sql @@ -0,0 +1,52 @@ +-- Paket 0: lesende Bestandsaufnahme (Testinstanz). Keine Schreibzugriffe. + +\echo '=== Angebote mit mehr als einer aktiven Fassung ===' +SELECT o.id AS offer_id, + o.name AS offer_name, + count(*)::int AS active_count, + string_agg(ov.number::text, ',' ORDER BY ov.number) AS active_numbers, + string_agg(DISTINCT ov.grant_kind, ',') AS grant_kinds +FROM offers o +JOIN offer_versions ov ON ov.offer_id = o.id AND ov.status = 'aktiv' +GROUP BY o.id, o.name +HAVING count(*) > 1 +ORDER BY o.id; + +\echo '=== Alle aktiven Registrierungsfassungen ===' +SELECT ov.offer_id, + o.name AS offer_name, + ov.id AS version_id, + ov.number, + ov.grant_kind +FROM offer_versions ov +JOIN offers o ON o.id = ov.offer_id +WHERE ov.status = 'aktiv' + AND ov.grant_kind = 'bei_registrierung' + AND ov.holder_kind = 'person' +ORDER BY ov.offer_id, ov.number; + +\echo '=== Spalte offer_name auf order_lines ===' +SELECT column_name +FROM information_schema.columns +WHERE table_schema = 'public' + AND table_name = 'order_lines' + AND column_name = 'offer_name'; + +\echo '=== Anzahl Bestellzeilen gesamt ===' +SELECT count(*)::int AS order_line_count FROM order_lines; + +\echo '=== Grants mit offer_version_id in conditions (aktive Dubletten-Angebote) ===' +SELECT ov.offer_id, + ov.number AS version_number, + (a.conditions->>'offer_version_id') AS stored_version_id, + count(g.id)::int AS grant_count +FROM offer_versions ov +JOIN offers o ON o.id = ov.offer_id +LEFT JOIN acquisitions a ON (a.conditions->>'offer_version_id')::bigint = ov.id +LEFT JOIN grants g ON g.acquisition_id = a.id +WHERE ov.status = 'aktiv' + AND ov.offer_id IN ( + SELECT offer_id FROM offer_versions WHERE status = 'aktiv' GROUP BY offer_id HAVING count(*) > 1 + ) +GROUP BY ov.offer_id, ov.number, a.conditions->>'offer_version_id' +ORDER BY ov.offer_id, ov.number; \ No newline at end of file diff --git a/storage/app/.gitignore b/storage/app/.gitignore new file mode 100644 index 0000000..fedb287 --- /dev/null +++ b/storage/app/.gitignore @@ -0,0 +1,4 @@ +* +!private/ +!public/ +!.gitignore diff --git a/storage/app/private/.gitignore b/storage/app/private/.gitignore new file mode 100644 index 0000000..d6b7ef3 --- /dev/null +++ b/storage/app/private/.gitignore @@ -0,0 +1,2 @@ +* +!.gitignore diff --git a/storage/app/public/.gitignore b/storage/app/public/.gitignore new file mode 100644 index 0000000..d6b7ef3 --- /dev/null +++ b/storage/app/public/.gitignore @@ -0,0 +1,2 @@ +* +!.gitignore diff --git a/storage/framework/.gitignore b/storage/framework/.gitignore new file mode 100644 index 0000000..7a0b408 --- /dev/null +++ b/storage/framework/.gitignore @@ -0,0 +1,10 @@ +compiled.php +config.php +down +events.scanned.php +lsp-*.php +maintenance.php +routes.php +routes.scanned.php +schedule-* +services.json diff --git a/storage/framework/cache/.gitignore b/storage/framework/cache/.gitignore new file mode 100644 index 0000000..d7852b8 --- /dev/null +++ b/storage/framework/cache/.gitignore @@ -0,0 +1,4 @@ +* +!data/ +!locks/ +!.gitignore diff --git a/storage/framework/cache/data/.gitignore b/storage/framework/cache/data/.gitignore new file mode 100644 index 0000000..d6b7ef3 --- /dev/null +++ b/storage/framework/cache/data/.gitignore @@ -0,0 +1,2 @@ +* +!.gitignore diff --git a/storage/framework/cache/locks/.gitignore b/storage/framework/cache/locks/.gitignore new file mode 100644 index 0000000..d6b7ef3 --- /dev/null +++ b/storage/framework/cache/locks/.gitignore @@ -0,0 +1,2 @@ +* +!.gitignore diff --git a/storage/framework/sessions/.gitignore b/storage/framework/sessions/.gitignore new file mode 100644 index 0000000..d6b7ef3 --- /dev/null +++ b/storage/framework/sessions/.gitignore @@ -0,0 +1,2 @@ +* +!.gitignore diff --git a/storage/framework/testing/.gitignore b/storage/framework/testing/.gitignore new file mode 100644 index 0000000..d6b7ef3 --- /dev/null +++ b/storage/framework/testing/.gitignore @@ -0,0 +1,2 @@ +* +!.gitignore diff --git a/storage/framework/views/.gitignore b/storage/framework/views/.gitignore new file mode 100644 index 0000000..d6b7ef3 --- /dev/null +++ b/storage/framework/views/.gitignore @@ -0,0 +1,2 @@ +* +!.gitignore diff --git a/tests/Feature/AdministrationTest.php b/tests/Feature/AdministrationTest.php new file mode 100644 index 0000000..e3204d3 --- /dev/null +++ b/tests/Feature/AdministrationTest.php @@ -0,0 +1,145 @@ + 'https://CHANGE-ME.example']); + + $response = $this->withHeaders([ + 'X-Forwarded-Host' => '', + 'X-Forwarded-Port' => '', + 'X-Forwarded-Proto' => '', + ])->get('http://192.168.2.144:3011/verwaltung'); + + $response->assertRedirect('http://192.168.2.144:3011/verwaltung/login'); + + $intended = session('url.intended'); + $this->assertIsString($intended); + $this->assertSame('192.168.2.144', parse_url($intended, PHP_URL_HOST)); + $this->assertSame(3011, parse_url($intended, PHP_URL_PORT)); + $this->assertSame('/verwaltung', parse_url($intended, PHP_URL_PATH)); + } + + public function test_login_drops_an_intended_address_that_leaves_the_opened_host(): void + { + config(['app.url' => 'https://CHANGE-ME.example']); + + $this->withSession(['url.intended' => 'http:///verwaltung']) + ->get('http://192.168.2.144:3011/verwaltung/login') + ->assertOk(); + + $this->assertNull(session('url.intended')); + + $this->withSession(['url.intended' => 'http://192.168.2.144:3011/verwaltung']) + ->get('http://192.168.2.144:3011/verwaltung/login') + ->assertOk(); + + $this->assertSame('http://192.168.2.144:3011/verwaltung', session('url.intended')); + } + + public function test_guests_and_members_cannot_open_the_administration(): void + { + $this->get('/verwaltung')->assertRedirect('/verwaltung/login'); + + $member = User::factory()->create(); + + $this->actingAs($member)->get('/verwaltung')->assertRedirect('/verwaltung/login'); + $this->actingAs($member, 'staff')->get('/verwaltung')->assertForbidden(); + } + + public function test_editor_must_set_up_multi_factor_authentication(): void + { + $editor = User::factory()->redakteur()->create(); + + $this->actingAs($editor, 'staff') + ->get('/verwaltung') + ->assertRedirect(); + } + + public function test_editor_with_multi_factor_can_open_pages_but_not_user_management(): void + { + $editor = User::factory()->redakteur()->create(); + $editor->saveAppAuthenticationSecret('JBSWY3DPEHPK3PXP'); + + $this->actingAs($editor, 'staff')->get('/verwaltung')->assertOk(); + // Der Seitenbestand steht seit Teil C in der Webpräsenz; die alte Adresse leitet dorthin. + $this->actingAs($editor, 'staff')->get('/verwaltung/pages')->assertRedirect(url('/verwaltung/webpraesenz')); + $this->actingAs($editor, 'staff')->get('/verwaltung/webpraesenz')->assertOk(); + $this->actingAs($editor, 'staff')->get('/verwaltung/users')->assertForbidden(); + $this->assertTrue($editor->can('update', Page::query()->first())); + $this->assertFalse($editor->can('viewAny', User::class)); + } + + public function test_system_administrator_manages_roles_and_does_not_publish_pages(): void + { + $admin = User::factory()->systemverwalter()->create(); + $admin->saveAppAuthenticationSecret('JBSWY3DPEHPK3PXP'); + $member = User::factory()->create(); + $page = Page::query()->where('path', '/')->firstOrFail(); + + $this->actingAs($admin, 'staff')->get('/verwaltung/users')->assertOk(); + $this->actingAs($admin, 'staff')->get('/verwaltung/pages')->assertForbidden(); + $this->assertFalse($admin->can('publish', $page)); + + app(AssignStaffRoles::class)->sync($member, [StaffRole::Redakteur->value], $admin); + + $this->assertTrue($member->fresh()->hasStaffRole(StaffRole::Redakteur)); + } + + public function test_draft_does_not_change_the_public_page_until_it_is_published(): void + { + $editor = User::factory()->redakteur()->create(); + $page = Page::query()->where('path', '/')->firstOrFail(); + $publishedId = $page->published_revision_id; + + $revision = app(PageService::class)->saveRevision($page, [ + ['type' => 'heading', 'heading' => 'Nur ein Entwurf', 'intro' => 'Noch nicht live.'], + ], 'Entwurf', 'Entwurf', $editor); + + $this->get('/')->assertOk()->assertDontSee('Nur ein Entwurf'); + $this->assertSame($publishedId, $page->fresh()->published_revision_id); + + $this->actingAs($editor); + app(PageService::class)->publish($page->fresh(), $revision); + + $this->get('/')->assertOk()->assertSee('Nur ein Entwurf'); + } + + public function test_restoring_a_revision_creates_a_new_revision_and_keeps_the_live_page(): void + { + $editor = User::factory()->redakteur()->create(); + $service = app(PageService::class); + $page = Page::query()->where('path', '/praevention')->firstOrFail(); + $original = $page->publishedRevision; + + $second = $service->saveRevision($page, [ + ['type' => 'heading', 'heading' => 'Zweite Fassung', 'intro' => 'Ersetzt die erste nach Veröffentlichung.'], + ], null, null, $editor); + $service->publish($page->fresh(), $second); + + $this->get('/praevention')->assertSee('Zweite Fassung'); + + $restored = $service->restore($page->fresh(), $original, $editor); + + $this->assertNotSame($original->id, $restored->id); + $this->assertSame($original->blocks, $restored->blocks); + $this->get('/praevention')->assertSee('Zweite Fassung')->assertDontSee('Prävention im Alltag'); + + $service->publish($page->fresh(), $restored); + + $this->get('/praevention')->assertSee('Prävention im Alltag')->assertDontSee('Zweite Fassung'); + } +} diff --git a/tests/Feature/BestandslisteTest.php b/tests/Feature/BestandslisteTest.php new file mode 100644 index 0000000..5cd2600 --- /dev/null +++ b/tests/Feature/BestandslisteTest.php @@ -0,0 +1,429 @@ +createComposition('Modul Abstand', CompositionKind::Uebung); + $content->createComposition('Programm Abstand', CompositionKind::Kurs); + $editor = $this->editor(); + + Livewire::actingAs($editor, 'staff') + ->test(ListExercises::class) + ->assertSee('Modul Abstand') + ->assertDontSee('Programm Abstand') + ->assertDontSeeHtml('aria-labelledby="segment-kindFilter"') + ->assertSeeHtml('wire:partial="action-modals"') + ->assertSee('Aufbau') + ->assertSee('Redaktion'); + + Livewire::actingAs($editor, 'staff') + ->test(ListCourses::class) + ->assertSee('Programm Abstand') + ->assertDontSee('Modul Abstand'); + + Livewire::actingAs($editor, 'staff') + ->test(EditorialDesk::class) + ->assertSee('Programm Abstand') + ->assertSee('Modul Abstand') + ->assertSeeHtml('wire:partial="action-modals"') + ->set('kindFilter', 'modul') + ->assertSee('Art: Module') + ->assertDontSee('Programm Abstand') + ->call('resetFilters') + ->assertSee('Programm Abstand'); + } + + public function test_desk_and_lists_create_modules_and_programs_through_one_dialog(): void + { + $editor = $this->editor(); + + Livewire::actingAs($editor, 'staff') + ->test(EditorialDesk::class) + ->callAction('createModule', ['designation' => 'Neues Modul vom Arbeitsplatz']) + ->assertHasNoActionErrors() + ->assertRedirect(); + + Livewire::actingAs($editor, 'staff') + ->test(ListExercises::class) + ->callAction('createModule', ['designation' => 'Neues Modul aus der Liste']) + ->assertHasNoActionErrors(); + + Livewire::actingAs($editor, 'staff') + ->test(EditorialDesk::class) + ->callAction('createProgram', ['designation' => '']) + ->assertHasActionErrors(['designation' => 'required']); + + $this->assertSame(2, Composition::query()->where('kind', CompositionKind::Uebung)->count()); + $this->assertSame(0, Composition::query()->where('kind', CompositionKind::Kurs)->count()); + $created = Composition::query()->where('designation', 'Neues Modul aus der Liste')->firstOrFail(); + $this->assertSame('modul', $created->editorialContentKind?->slug); + } + + public function test_active_filters_are_named_and_removable_and_the_list_grows_in_steps(): void + { + $content = app(ContentService::class); + + foreach (range(1, Bestand::SCHRITT + 3) as $nummer) { + $content->createComposition(sprintf('Modul %02d', $nummer), CompositionKind::Uebung); + } + + Livewire::actingAs($this->editor(), 'staff') + ->test(ListExercises::class) + ->assertSeeText('53 Module') + ->assertSee('50 von 53 angezeigt') + ->assertSee('Modul 50') + ->assertDontSee('Modul 51') + ->call('mehrAnzeigen') + ->assertSee('Modul 53') + ->mountAction('createModule') + ->set('mountedActions.0.data.designation', 'Noch nicht angelegt') + ->assertSet('bestandGrenze', 2 * Bestand::SCHRITT) + ->unmountAction() + ->set('query', 'Modul 5') + ->assertSet('bestandGrenze', Bestand::SCHRITT) + ->assertSee('Suche: „Modul 5“') + ->assertSee('Alle zurücksetzen') + ->set('visibility', 'entwurf') + ->assertSee('Stand: Noch ohne Fassung') + ->set('query', '') + ->assertDontSee('Suche: „') + ->call('resetFilters') + ->assertDontSee('Alle zurücksetzen'); + } + + public function test_media_filters_keep_their_address_names_and_rarely_used_ones_sit_under_more_filters(): void + { + $content = app(ContentService::class); + $content->publishElementVersion($content->createElement('film', 'film', 'Lara im Park'), 'Film'); + $content->publishElementVersion($content->createElement('text', 'text', 'Trainerhinweis'), 'Text'); + + Livewire::withQueryParams(['art' => 'film', 'archiv' => 'alle']) + ->actingAs($this->editor(), 'staff') + ->test(ListContentElements::class) + ->assertSet('art', 'film') + ->assertSet('archiv', 'alle') + ->assertSee('Lara im Park') + ->assertDontSee('Trainerhinweis') + ->assertSee('Technische Art: Film') + ->assertSee('Archiv: Auch archivierte') + ->assertSee('Weitere Filter') + ->assertSeeHtml('wire:partial="action-modals"') + ->set('art', '') + ->assertSee('Trainerhinweis'); + } + + public function test_only_editors_reach_the_composition_lists(): void + { + $keeper = User::factory()->katalogverwalter()->create(); + $keeper->saveAppAuthenticationSecret('JBSWY3DPEHPK3PXP'); + + $this->actingAs($keeper, 'staff')->get(ExerciseResource::getUrl('index'))->assertForbidden(); + $this->actingAs($keeper, 'staff')->get(EditorialDesk::getUrl())->assertForbidden(); + } + + public function test_catalog_lists_show_readable_states_and_filter_them(): void + { + $content = app(ContentService::class); + $articles = app(ArticleService::class); + $offers = app(OfferService::class); + $sheet = $content->publishElementVersion($content->createElement('pdf', 'pdf', 'Merkblatt Alltag'), 'Hinweis'); + $released = $articles->create('demo-merkblatt', 'Erprobung'); + $articles->publishRelease($released, $sheet, 'Eigenständiges Merkblatt.'); + $articles->create('demo-leer', 'Erprobung'); + $bundle = app(BundleService::class)->create('Demo Basis'); + app(BundleService::class)->publish($bundle, [$released->fresh()]); + $rights = $offers->createRightsProfile('Erprobung lesen', 'ehrenamtlich', ['pdf' => ['ansehen', 'laden']]); + $offer = $offers->create('Kostenloses Merkblatt'); + $offers->activate($offer, [['target' => $released->fresh(), 'rights' => $rights]], ['grant_kind' => 'auf_abruf']); + $offers->create('Noch leer'); + $keeper = $this->keeper(); + + Livewire::actingAs($keeper, 'staff') + ->test(ListLicenseArticles::class) + ->assertSee('demo-merkblatt') + ->assertSee('Stand 1 veröffentlicht') + ->assertSee('In einem aktiven Angebot') + ->assertSee('Noch kein Stand') + ->assertSeeHtml('wire:partial="action-modals"') + ->set('zustand', 'ohne') + ->assertSee('Zustand: Noch ohne Stand') + ->assertSee('demo-leer') + ->assertDontSee('demo-merkblatt') + ->set('suche', 'merkblatt') + ->assertSee('Nichts gefunden'); + + Livewire::actingAs($keeper, 'staff') + ->test(ListOffers::class) + ->assertSee('Fassung 1 aktiv') + ->assertSee('Auf Abruf') + ->assertSee('Lizenzartikel demo-merkblatt · Erprobung lesen') + ->assertSee('Keine aktive Fassung') + ->assertDontSee('>aktiv<', false); + + Livewire::actingAs($keeper, 'staff') + ->test(ListBundles::class) + ->assertSee('Demo Basis') + ->assertSee('Fassung 1 veröffentlicht') + ->assertSee('1 Bestandteil'); + + Livewire::actingAs($keeper, 'staff') + ->test(ListRightsProfiles::class) + ->assertSee('Erprobung lesen') + ->assertSee('PDF ansehen, PDF herunterladen') + ->assertSee('Ehrenamtlich'); + } + + public function test_creating_a_catalog_object_opens_it_and_editors_without_the_keeper_role_stay_out(): void + { + $keeper = $this->keeper(); + + Livewire::actingAs($keeper, 'staff') + ->test(ListLicenseArticles::class) + ->callAction('create', ['code' => 'neuer-artikel', 'product_line' => 'Erprobung']) + ->assertRedirect(LicenseArticleResource::getUrl('view', ['record' => LicenseArticle::query()->where('code', 'neuer-artikel')->firstOrFail()])); + + Livewire::actingAs($keeper, 'staff') + ->test(ListOffers::class) + ->callAction('create', ['name' => 'Neues Angebot']) + ->assertRedirectContains('/verwaltung/offers/'); + + $this->actingAs($this->editor(), 'staff')->get(OfferResource::getUrl('index'))->assertForbidden(); + $this->actingAs($this->editor(), 'staff')->get(LicenseArticleResource::getUrl('index'))->assertForbidden(); + } + + public function test_one_offer_mask_activates_the_first_version_and_is_prefilled_for_a_change(): void + { + $content = app(ContentService::class); + $articles = app(ArticleService::class); + $offers = app(OfferService::class); + $sheet = $content->publishElementVersion($content->createElement('pdf', 'pdf', 'Merkblatt'), 'Hinweis'); + $article = $articles->create('demo-merkblatt', 'Erprobung'); + $articles->publishRelease($article, $sheet, 'Eigenständig.'); + $rights = $offers->createRightsProfile('Lesen', 'ehrenamtlich', ['pdf' => ['ansehen']]); + $offer = $offers->create('Merkblatt kostenlos'); + $keeper = $this->keeper(); + + $component = Livewire::actingAs($keeper, 'staff') + ->test(ViewOffer::class, ['record' => $offer->getKey()]) + ->assertSee('Noch keine aktive Fassung') + ->assertSee('Fassung aktivieren') + ->mountAction('activate'); + $this->assertSame('Erste Fassung aktivieren', $component->instance()->getMountedAction()->getModalHeading()); + $component + ->fillForm(['grant_kind' => 'auf_abruf', 'lines' => [['kind' => 'article', 'article_id' => $article->id, 'rights_id' => $rights->id]]]) + ->callMountedAction() + ->assertHasNoFormErrors() + ->assertSee('Fassung 1 aktiv · Auf Abruf') + ->assertSee('Lizenzartikel demo-merkblatt'); + + $component = Livewire::actingAs($keeper, 'staff') + ->test(ViewOffer::class, ['record' => $offer->getKey()]) + ->assertSee('Geänderte Fassung aktivieren') + ->mountAction('activate'); + $this->assertSame('Angebot ändern: Fassung 2 aktivieren', $component->instance()->getMountedAction()->getModalHeading()); + $data = $component->get('mountedActions.0.data'); + $this->assertSame('auf_abruf', $data['grant_kind']); + $this->assertSame((string) $article->id, (string) array_values($data['lines'])[0]['article_id']); + $this->assertSame((string) $rights->id, (string) array_values($data['lines'])[0]['rights_id']); + + $component->fillForm(['grant_kind' => 'kauf', 'price_cents' => 500]) + ->callMountedAction() + ->assertHasNoFormErrors() + ->assertSee('Fassung 2 aktiv · Kauf · 5,00 €') + ->assertSee('Beendet'); + + $statuses = $offer->versions()->orderBy('number')->pluck('status')->map(fn ($status) => $status instanceof \BackedEnum ? $status->value : $status)->all(); + $this->assertSame(['beendet', 'aktiv'], $statuses); + } + + public function test_a_bundle_change_is_prefilled_and_keeps_the_published_version(): void + { + $content = app(ContentService::class); + $articles = app(ArticleService::class); + $sheet = $content->publishElementVersion($content->createElement('pdf', 'pdf', 'Merkblatt'), 'Hinweis'); + $first = $articles->create('demo-a', 'Erprobung'); + $articles->publishRelease($first, $sheet, 'A.'); + $second = $articles->create('demo-b', 'Erprobung'); + $articles->publishRelease($second, $sheet, 'B.'); + $bundle = app(BundleService::class)->create('Demo Basis'); + app(BundleService::class)->publish($bundle, [$first->fresh()]); + + $component = Livewire::actingAs($this->keeper(), 'staff') + ->test(ViewBundle::class, ['record' => $bundle->getKey()]) + ->assertSee('Fassung 1 veröffentlicht') + ->assertSee('Lizenzartikel demo-a') + ->assertSee('Geänderte Fassung veröffentlichen') + ->mountAction('publish'); + $this->assertSame('Paket ändern: Fassung 2 veröffentlichen', $component->instance()->getMountedAction()->getModalHeading()); + $this->assertSame([$first->id], array_map('intval', $component->get('mountedActions.0.data.articles'))); + + $component->fillForm(['articles' => [$first->id, $second->id]]) + ->callMountedAction() + ->assertHasNoFormErrors() + ->assertSee('Fassung 2 veröffentlicht') + ->assertSee('Lizenzartikel demo-b'); + + $this->assertSame(2, $bundle->versions()->where('status', 'veroeffentlicht')->count()); + $this->assertSame(1, $bundle->versions()->where('number', 1)->firstOrFail()->items()->count()); + } + + public function test_a_rights_profile_reads_as_allowed_actions_and_names_its_offers(): void + { + $offers = app(OfferService::class); + $content = app(ContentService::class); + $articles = app(ArticleService::class); + $sheet = $content->publishElementVersion($content->createElement('pdf', 'pdf', 'Merkblatt'), 'Hinweis'); + $article = $articles->create('demo-merkblatt', 'Erprobung'); + $articles->publishRelease($article, $sheet, 'A.'); + $rights = $offers->createRightsProfile('Abstand ansehen', 'ehrenamtlich', ['pdf' => ['ansehen', 'laden']]); + $offer = $offers->create('Kostenlos'); + $offers->activate($offer, [['target' => $article->fresh(), 'rights' => $rights]], ['grant_kind' => 'auf_abruf']); + + Livewire::actingAs($this->keeper(), 'staff') + ->test(ViewRightsProfile::class, ['record' => $rights->rights_profile_id]) + ->assertSee('Abstand ansehen') + ->assertDontSee('Abstand ansehen ansehen') + ->assertSee('PDF ansehen') + ->assertSee('PDF herunterladen') + ->assertDontSee('pdf: ansehen') + ->assertSee('Kostenlos · Fassung 1') + ->assertSee('festgeschrieben seit'); + } + + public function test_pillars_combinations_and_accounts_use_the_same_list(): void + { + $content = app(ContentService::class); + $content->createComposition('Materialsatz Alltag', CompositionKind::Kombination); + $content->createComposition('Modul Abstand', CompositionKind::Uebung); + app(PillarService::class)->create('Sicher handeln im Alltag'); + $editor = $this->editor(); + + Livewire::actingAs($editor, 'staff') + ->test(ListPillars::class) + ->assertSee('Sicher handeln im Alltag') + ->assertSee('Intern') + ->assertSee('0 Medien') + ->assertSeeHtml('wire:partial="action-modals"'); + + Livewire::actingAs($editor, 'staff') + ->test(ListCombinations::class) + ->assertSee('Materialsatz Alltag') + ->assertDontSee('Modul Abstand') + ->assertSeeHtml('wire:partial="action-modals"') + ->assertSee('Kombination anlegen'); + + $admin = User::factory()->systemverwalter()->create(['name' => 'Anna Admin', 'email' => 'anna@example.test']); + $admin->saveAppAuthenticationSecret('JBSWY3DPEHPK3PXP'); + + Livewire::actingAs($admin, 'staff') + ->test(ListUsers::class) + ->assertSee('Anna Admin') + ->assertSee('anna@example.test') + ->assertSee('Benutzer anlegen') + ->set('suche', 'anna@') + ->assertSee('Anna Admin') + ->assertDontSee($editor->email); + } + + public function test_changing_an_offer_keeps_terms_the_mask_does_not_show(): void + { + $content = app(ContentService::class); + $articles = app(ArticleService::class); + $offers = app(OfferService::class); + $sheet = $content->publishElementVersion($content->createElement('pdf', 'pdf', 'Merkblatt'), 'Hinweis'); + $article = $articles->create('demo-merkblatt', 'Erprobung'); + $articles->publishRelease($article, $sheet, 'A.'); + $rights = $offers->createRightsProfile('Lesen', 'institutionell', ['pdf' => ['ansehen']]); + $offer = $offers->create('Für Einrichtungen'); + $offers->activate($offer, [['target' => $article->fresh(), 'rights' => $rights]], [ + 'grant_kind' => 'kauf', 'price_cents' => 900, 'holder_kind' => 'organisation', + 'term_rule' => 'befristet', 'tax_class' => 'ermaessigt', 'dynamic' => true, + ]); + + Livewire::actingAs($this->keeper(), 'staff') + ->test(ViewOffer::class, ['record' => $offer->getKey()]) + ->mountAction('activate') + ->fillForm(['price_cents' => 1200]) + ->callMountedAction() + ->assertHasNoFormErrors() + ->assertSee('Fassung 2 aktiv · Kauf · 12,00 €'); + + $second = $offer->versions()->where('number', 2)->firstOrFail(); + $this->assertSame('organisation', $second->holder_kind); + $this->assertSame('befristet', $second->term_rule); + $this->assertSame('ermaessigt', $second->tax_class); + $this->assertTrue((bool) $second->dynamic); + } + + public function test_a_combination_opens_its_structure_and_its_editorial_desk_from_the_list(): void + { + $combination = app(ContentService::class)->createComposition('Materialsatz Alltag', CompositionKind::Kombination); + $editor = $this->editor(); + $url = EditorialCatalog::editUrl($combination); + + Livewire::actingAs($editor, 'staff') + ->test(ListCombinations::class) + ->assertSeeHtml('href="'.$url.'"') + ->assertSeeHtml('href="'.$url.'?redaktion=1"'); + + $this->actingAs($editor, 'staff')->get($url)->assertOk()->assertSee('Materialsatz Alltag'); + $this->actingAs($editor, 'staff')->get($url.'?redaktion=1')->assertOk()->assertSee('Redaktion speichern'); + } + + private function keeper(): User + { + $keeper = User::factory()->katalogverwalter()->create(); + $keeper->saveAppAuthenticationSecret('JBSWY3DPEHPK3PXP'); + + return $keeper; + } + + private function editor(): User + { + $editor = User::factory()->redakteur()->create(); + $editor->saveAppAuthenticationSecret('JBSWY3DPEHPK3PXP'); + + return $editor; + } +} diff --git a/tests/Feature/CatalogAdministrationTest.php b/tests/Feature/CatalogAdministrationTest.php new file mode 100644 index 0000000..3ced0cc --- /dev/null +++ b/tests/Feature/CatalogAdministrationTest.php @@ -0,0 +1,113 @@ +publishElementVersion( + $content->createElement('pdf', 'pdf', 'Merkblatt Alltag'), + 'Hinweis für die Prüfung.', + ); + $exercise = $content->publishComposition( + $content->createComposition('Übung Alltag'), + [['role' => 'Merkblatt', 'target' => $sheet]], + ); + $sheetArticle = $articles->create('demo-merkblatt', 'Erprobung'); + $articles->publishRelease($sheetArticle, $sheet, 'Eigenständiges Merkblatt.'); + $exerciseArticle = $articles->create('demo-uebung', 'Erprobung'); + $articles->publishRelease($exerciseArticle, $exercise, 'Übung aus dem Merkblatt.'); + + $basis = $bundles->create('Demo Basis'); + $bundles->publish($basis, [$sheetArticle->fresh()]); + $program = $bundles->create('Demo Programm'); + $programVersion = $bundles->publish($program, [$basis, $exerciseArticle->fresh()]); + + $rights = $offers->createRightsProfile('Erprobung lesen und ansehen', 'ehrenamtlich', [ + 'pdf' => ['ansehen', 'laden'], + ]); + $free = $offers->create('Kostenloses Merkblatt'); + $offers->activate($free, [ + ['target' => $sheetArticle->fresh(), 'rights' => $rights], + ], ['grant_kind' => 'auf_abruf']); + $paid = $offers->create('Testkauf Programm'); + $offers->activate($paid, [ + ['target' => $programVersion, 'rights' => $rights], + ], ['grant_kind' => 'kauf', 'price_cents' => 500]); + + $keeper = User::factory()->katalogverwalter()->create(); + $keeper->saveAppAuthenticationSecret('JBSWY3DPEHPK3PXP'); + $editor = User::factory()->redakteur()->create(); + $editor->saveAppAuthenticationSecret('JBSWY3DPEHPK3PXP'); + + $this->actingAs($editor, 'staff') + ->get(BundleResource::getUrl('view', ['record' => $program])) + ->assertForbidden(); + + $this->actingAs($keeper, 'staff') + ->get(BundleResource::getUrl('index')) + ->assertOk() + ->assertSee('aufgelösten Artikel'); + + $this->actingAs($keeper, 'staff') + ->get(BundleResource::getUrl('view', ['record' => $program])) + ->assertOk() + ->assertSee('Paket Demo Basis') + ->assertSee('Lizenzartikel demo-uebung') + ->assertSee('demo-merkblatt') + ->assertSee('demo-uebung'); + + $this->actingAs($keeper, 'staff') + ->get(LicenseArticleResource::getUrl('view', ['record' => $sheetArticle])) + ->assertOk() + ->assertSee('Merkblatt Alltag') + ->assertSee('Paket Demo Basis') + ->assertSee('Angebot Kostenloses Merkblatt') + ->assertSee('pdf: ansehen, laden'); + + $this->actingAs($keeper, 'staff') + ->get(OfferResource::getUrl('view', ['record' => $paid])) + ->assertOk() + ->assertSee('Kauf · 5,00 €') + ->assertSee('demo-merkblatt') + ->assertSee('demo-uebung') + ->assertSee('Erprobung lesen und ansehen'); + + $sheet->load('element'); + + $this->actingAs($editor, 'staff') + ->get(ContentElementResource::getUrl('view', ['record' => $sheet->element]).'?bereich=inhalt') + ->assertOk() + ->assertSee('Hinweis für die Prüfung.') + ->assertSee('Fassung 1') + ->assertSee('Neue Fassung anlegen'); + + $this->actingAs($editor, 'staff') + ->get(ContentElementResource::getUrl('view', ['record' => $sheet->element]).'?bereich=verwendung') + ->assertOk() + ->assertSee('In Modulen und Programmen') + ->assertSee('Übung Alltag') + ->assertSee('In Lizenzartikeln') + ->assertSee('Lizenzartikel demo-merkblatt'); + } +} diff --git a/tests/Feature/CatalogFollowThroughTest.php b/tests/Feature/CatalogFollowThroughTest.php new file mode 100644 index 0000000..5378032 --- /dev/null +++ b/tests/Feature/CatalogFollowThroughTest.php @@ -0,0 +1,90 @@ +publishElementVersion($content->createElement('film', 'film', 'Film'), null, ['file' => 'inhalte/a.mp4']); + $sheet = $content->publishElementVersion($content->createElement('text', 'document', 'Blatt'), 'Text'); + $program = $content->publishComposition($content->createComposition('Programm'), [ + ['role' => 'Film', 'target' => $film], + ['role' => 'Blatt', 'target' => $sheet], + ]); + $articles = app(ArticleService::class); + $filmArticle = $articles->create('nur-film'); + $articles->publishRelease($filmArticle, $film, 'Nur der Film.'); + $offers = app(OfferService::class); + $rights = $offers->createRightsProfile('Film', 'ehrenamtlich', ['film' => ['streamen']]); + + $this->expectException(DomainRuleException::class); + $offers->activate($offers->create('Lückenhaft'), [ + ['target' => $filmArticle->fresh(), 'rights' => $rights], + ], [ + 'grant_kind' => 'kauf', + 'price_cents' => 100, + 'composition_version_id' => $program->id, + ]); + } + + public function test_a_dimension_filters_the_library_and_a_delivery_is_recorded(): void + { + Storage::fake('media_derived'); + Storage::disk('media_derived')->put('inhalte/demo.txt', 'text'); + $content = app(ContentService::class); + $version = $content->publishElementVersion( + $content->createElement('text', 'text', 'Filterblatt'), + null, + ['file' => 'inhalte/demo.txt'], + ); + $dimension = EditorialDimension::query()->create(['slug' => 'alter', 'label' => 'Alter']); + $value = EditorialDimensionValue::query()->create([ + 'editorial_dimension_id' => $dimension->id, + 'slug' => 'grundschule', + 'label' => 'Grundschule', + ]); + app(IdentityDimension::class)->assign($version->element, $value); + $articles = app(ArticleService::class); + $article = $articles->create('filter'); + $release = $articles->publishRelease($article, $version, 'Eigenständig.'); + $offers = app(OfferService::class); + $rights = $offers->createRightsProfile('Lesen', 'ehrenamtlich', ['text' => ['ansehen']]); + $offer = $offers->create('Filterangebot'); + $offers->activate($offer, [['target' => $article->fresh(), 'rights' => $rights]], ['grant_kind' => 'auf_abruf']); + $member = User::factory()->create(); + app(GrantIssuer::class)->claim($member, $offer); + + $this->actingAs($member)->get(route('member.library', ['dimension' => [$value->id]]))->assertOk()->assertSee('Filterblatt'); + $this->actingAs($member)->get(route('member.library', ['dimension' => [999]]))->assertOk()->assertDontSee('Filterblatt'); + + $url = SignedLink::temporary('member.media', now()->addMinutes(5), [ + 'article' => $article->id, + 'release' => $release->id, + 'version' => $version->id, + 'action' => 'ansehen', + 'reader' => $member->id, + ]); + $this->actingAs($member)->get($url)->assertOk(); + $this->assertSame(1, MediaDelivery::query()->count()); + $this->assertSame('ansehen', MediaDelivery::query()->first()->action); + } +} diff --git a/tests/Feature/CatalogRulesTest.php b/tests/Feature/CatalogRulesTest.php new file mode 100644 index 0000000..a39cb14 --- /dev/null +++ b/tests/Feature/CatalogRulesTest.php @@ -0,0 +1,347 @@ +element('Arbeitsheft', 'Seite 1'); + $release = app(ArticleService::class)->publishRelease( + $this->article('arbeitsheft'), + $version, + 'Eigenständiges Arbeitsheft, kein Bestandteil einer Übung.', + ); + + $this->assertSame([$version->id], $release->contents->pluck('content_element_version_id')->all()); + $this->assertSame($version->id, $release->root_element_version_id); + } + + public function test_b_composition_fixes_exact_member_versions(): void + { + $film = $this->element('Film', 'Aufnahme'); + $sheet = $this->element('Arbeitsblatt', 'Aufgaben'); + $composition = app(ContentService::class)->publishComposition( + app(ContentService::class)->createComposition('Übung'), + [ + ['role' => 'Film', 'target' => $film], + ['role' => 'Arbeitsblatt', 'target' => $sheet], + ], + ); + $release = app(ArticleService::class)->publishRelease( + $this->article('uebung'), + $composition, + 'Die Übung wird als ein Lizenzartikel geführt.', + ); + + $this->assertSame( + [$film->id, $sheet->id], + $release->contents->pluck('content_element_version_id')->all(), + ); + $this->assertNotNull($composition->attestations()->first()); + } + + public function test_c_one_element_version_can_be_reused(): void + { + $shared = $this->element('Merkblatt', 'Hinweise'); + $first = app(ContentService::class)->publishComposition( + app(ContentService::class)->createComposition('Übung A'), + [['role' => 'Merkblatt', 'target' => $shared]], + ); + $second = app(ContentService::class)->publishComposition( + app(ContentService::class)->createComposition('Übung B'), + [['role' => 'Merkblatt', 'target' => $shared]], + ); + + $this->assertEqualsCanonicalizing( + [$first->id, $second->id], + app(ContentService::class)->containingCompositionIds($shared), + ); + } + + public function test_d_nested_composition_resolves_inner_versions_and_rejects_cycles(): void + { + $sheet = $this->element('Arbeitsblatt', 'Aufgaben'); + $content = app(ContentService::class); + $inner = $content->publishComposition( + $content->createComposition('Materialsatz'), + [['role' => 'Arbeitsblatt', 'target' => $sheet]], + ); + $outer = $content->publishComposition( + $content->createComposition('Übung'), + [['role' => 'Materialsatz', 'target' => $inner]], + ); + $release = app(ArticleService::class)->publishRelease( + $this->article('uebung-mit-satz'), + $outer, + 'Verschachtelte Übung, derselbe Artikel.', + ); + + $this->assertSame(['Materialsatz / Arbeitsblatt'], $release->contents->pluck('path')->all()); + $this->assertSame([$sheet->id], $release->contents->pluck('content_element_version_id')->all()); + + $this->expectException(DomainRuleException::class); + $content->publishComposition( + $inner->composition, + [['role' => 'Übung', 'target' => $outer]], + ); + } + + public function test_e_one_article_can_belong_to_two_bundles(): void + { + $article = $this->publishedArticle('einzel', 'Blatt'); + $bundles = app(BundleService::class); + $first = $bundles->publish($bundles->create('Paket eins'), [$article]); + $second = $bundles->publish($bundles->create('Paket zwei'), [$article]); + + $this->assertSame([$article->id], $bundles->articleIds($first)); + $this->assertSame([$article->id], $bundles->articleIds($second)); + } + + public function test_f_nested_bundles_reject_cycles_and_deduplicate_articles(): void + { + $article = $this->publishedArticle('gemeinsam', 'Blatt'); + $bundles = app(BundleService::class); + $left = $bundles->create('Links'); + $right = $bundles->create('Rechts'); + $bundles->publish($left, [$article]); + $bundles->publish($right, [$article]); + $outer = $bundles->publish($bundles->create('Außen'), [$left, $right]); + + $this->assertSame([$article->id], $bundles->articleIds($outer)); + + $this->expectException(DomainRuleException::class); + $bundles->publish($left, [$outer->bundle]); + } + + public function test_g_a_new_element_version_does_not_change_a_published_composition(): void + { + $content = app(ContentService::class); + $element = $content->createElement('pdf', 'begleitmaterial', 'Anleitung'); + $first = $content->publishElementVersion($element, 'Fassung 1'); + $composition = $content->publishComposition( + $content->createComposition('Übung'), + [['role' => 'Anleitung', 'target' => $first]], + ); + $release = app(ArticleService::class)->publishRelease( + $this->article('anleitung'), + $composition, + 'Korrektur bleibt eine Fassung desselben Artikels.', + ); + + $second = $content->publishElementVersion($element->fresh(), 'Fassung 2'); + $composition->refresh()->load('members'); + + $this->assertSame($first->id, $composition->members->sole()->content_element_version_id); + $this->assertNotSame($second->id, $composition->members->sole()->content_element_version_id); + $this->assertSame( + [$first->id], + $release->fresh()->contents->pluck('content_element_version_id')->all(), + ); + + $this->expectException(DomainRuleException::class); + $first->body = 'stillschweigend geändert'; + $first->save(); + } + + public function test_an_unused_ready_text_changes_without_a_new_version(): void + { + $content = app(ContentService::class); + $version = $content->publishElementVersion($content->createElement('text', 'text', 'Notiz'), 'Alt'); + $updated = $content->reviseElementContent($version, 'Neu'); + + $this->assertFalse($content->isCommitted($updated)); + $this->assertSame($version->id, $updated->id); + $this->assertSame('Neu', $updated->body); + $this->assertSame(1, $version->element->versions()->count()); + } + + public function test_h_a_bundle_change_does_not_change_an_activated_offer(): void + { + $first = $this->publishedArticle('grundlage', 'Grundlage'); + $second = $this->publishedArticle('erweiterung', 'Erweiterung'); + $bundles = app(BundleService::class); + $bundle = $bundles->create('Programm'); + $published = $bundles->publish($bundle, [$first]); + $rights = $this->rights(); + $offer = app(OfferService::class)->activate( + app(OfferService::class)->create('Programmangebot'), + [['target' => $published, 'rights' => $rights]], + ); + + $bundles->publish($bundle, [$first, $second]); + $offer->refresh(); + + $this->assertSame([$first->id], app(OfferService::class)->scopeArticleIds($offer)); + $this->assertSame([$first->id], $bundles->articleIds($published->fresh())); + $this->assertNotNull($rights->fresh()->locked_at); + + $this->expectException(DomainRuleException::class); + $offer->tax_class = 'unveraendert'; + $offer->save(); + } + + public function test_publication_records_impact_and_withdrawal_restores_the_previous_release(): void + { + $content = app(ContentService::class); + $articles = app(ArticleService::class); + $firstVersion = $this->element('Blatt', 'Fassung 1'); + $article = $this->article('blatt'); + $first = $articles->publishRelease($article, $firstVersion, 'Erste Einordnung.'); + $article = $article->fresh(); + $rights = $this->rights(); + app(OfferService::class)->activate( + app(OfferService::class)->create('Blattangebot'), + [['target' => $article, 'rights' => $rights]], + ); + $party = Party::query()->create([ + 'type' => PartyType::Person, + 'display_name' => 'Mitglied Probe', + ]); + $acquisition = Acquisition::query()->create([ + 'party_id' => $party->id, + 'type' => AcquisitionType::FreierAbruf, + 'reference_type' => 'offer', + 'reference_id' => 1, + ]); + Grant::query()->create([ + 'acquisition_id' => $acquisition->id, + 'license_article_id' => $article->id, + 'rights_profile_version_id' => $rights->id, + 'rights_snapshot' => $rights->capabilities, + 'release_at_grant_id' => $first->id, + 'status' => GrantStatus::Aktiv, + ]); + + $secondVersion = $content->publishElementVersion($firstVersion->element->fresh(), 'Fassung 2'); + $second = $articles->publishRelease($article->fresh(), $secondVersion, 'Überarbeitung desselben Artikels.'); + + $this->assertSame(1, $second->impact_report['holders']); + $this->assertSame(['Blattangebot'], $second->impact_report['offers']); + $this->assertSame(1, $second->impact_report['replaces_number']); + + $content->block($secondVersion, 'Fehlerhafte Fassung.'); + + try { + $articles->publishRelease($article->fresh(), $secondVersion, 'Darf nicht erscheinen.'); + $this->fail('Eine gesperrte Fassung darf nicht veröffentlicht werden.'); + } catch (DomainRuleException) { + } + + $this->assertSame($second->id, $article->fresh()->current_release_id); + + $result = $articles->withdraw($article->fresh(), 'Die zweite Fassung ist fehlerhaft.'); + + $this->assertSame(1, $result['fallback_number']); + $this->assertSame(['Mitglied Probe'], $result['holders']); + $this->assertSame($first->id, $article->fresh()->current_release_id); + $this->assertSame('gesperrt', $second->fresh()->status->value); + } + + public function test_each_holder_gets_an_own_acquisition_and_one_grant_per_article(): void + { + $article = $this->publishedArticle('frei', 'Kostenloses Blatt'); + $rights = $this->rights(); + $offer = app(OfferService::class)->create('Kostenlos'); + app(OfferService::class)->activate($offer, [ + ['target' => $article, 'rights' => $rights], + ]); + + $acquisitions = []; + + foreach (['Mitglied Eins', 'Mitglied Zwei'] as $name) { + $party = Party::query()->create([ + 'type' => PartyType::Person, + 'display_name' => $name, + ]); + $acquisitions[] = Acquisition::query()->create([ + 'party_id' => $party->id, + 'type' => AcquisitionType::FreierAbruf, + 'reference_type' => 'offer', + 'reference_id' => $offer->id, + ]); + } + + $this->assertCount(2, $acquisitions); + + try { + Acquisition::query()->create([ + 'party_id' => $acquisitions[0]->party_id, + 'type' => AcquisitionType::FreierAbruf, + 'reference_type' => 'offer', + 'reference_id' => $offer->id, + ]); + $this->fail('Derselbe Inhaber darf dasselbe Angebot nicht ein zweites Mal abrufen.'); + } catch (QueryException) { + } + + Grant::query()->create([ + 'acquisition_id' => $acquisitions[0]->id, + 'license_article_id' => $article->id, + 'rights_profile_version_id' => $rights->id, + 'rights_snapshot' => $rights->capabilities, + 'release_at_grant_id' => $article->current_release_id, + 'status' => GrantStatus::Aktiv, + ]); + + $this->expectException(QueryException::class); + Grant::query()->create([ + 'acquisition_id' => $acquisitions[0]->id, + 'license_article_id' => $article->id, + 'rights_profile_version_id' => $rights->id, + 'rights_snapshot' => $rights->capabilities, + 'status' => GrantStatus::Aktiv, + ]); + } + + private function element(string $title, string $body): ContentElementVersion + { + $content = app(ContentService::class); + + return $content->publishElementVersion($content->createElement('text', 'text', $title), $body); + } + + private function article(string $code): LicenseArticle + { + return app(ArticleService::class)->create($code); + } + + private function publishedArticle(string $code, string $title): LicenseArticle + { + $article = $this->article($code); + app(ArticleService::class)->publishRelease( + $article, + $this->element($title, $title), + 'Eigenständiger Artikel.', + ); + + return $article->fresh(); + } + + private function rights(): RightsProfileVersion + { + return app(OfferService::class)->createRightsProfile('Lesen', 'ehrenamtlich', [ + 'text' => ['lesen'], + ]); + } +} diff --git a/tests/Feature/CmsArbeitsplatzTest.php b/tests/Feature/CmsArbeitsplatzTest.php new file mode 100644 index 0000000..6acd275 --- /dev/null +++ b/tests/Feature/CmsArbeitsplatzTest.php @@ -0,0 +1,238 @@ +where('path', '/praevention')->firstOrFail(); + $live = $page->published_revision_id; + + $component = Livewire::actingAs($this->editor(), 'staff') + ->test(EditPage::class, ['record' => $page->id]) + ->assertSee('Öffentlich: Revision '.$live) + ->assertDontSee('Änderungen nicht gespeichert') + ->assertSee('Entwurf speichern') + ->assertSee('Seitenvorschau') + ->assertSee('Seiteninhalt') + ->assertSee('Seiteneinstellungen') + ->assertSee('Verlauf') + ->set('data.seo_title', 'Neuer Suchmaschinentitel') + ->assertSee('Änderungen nicht gespeichert') + ->call('save') + ->assertHasNoErrors() + ->assertDontSee('Änderungen nicht gespeichert'); + + $page->refresh(); + $component->assertSee('Entwurf gespeichert (Revision '.$page->latestRevision->id.')') + ->assertSee('der gespeicherte Entwurf ist neuer'); + $this->assertSame($live, $page->published_revision_id, 'Speichern veröffentlicht nicht.'); + } + + public function test_hidden_registers_keep_their_fields_and_save_with_the_draft(): void + { + $page = Page::query()->where('path', '/praevention')->firstOrFail(); + + Livewire::actingAs($this->editor(), 'staff') + ->test(EditPage::class, ['record' => $page->id]) + ->call('showRegister', 'einstellungen') + ->assertSet('register', 'einstellungen') + ->set('data.seo_title', 'Titel aus den Einstellungen') + ->call('showRegister', 'inhalt') + ->call('save') + ->assertHasNoErrors(); + + $this->assertSame('Titel aus den Einstellungen', $page->fresh()->latestRevision->seo_title); + } + + public function test_an_error_in_a_hidden_register_shows_that_register(): void + { + $page = Page::query()->where('path', '/praevention')->firstOrFail(); + + Livewire::actingAs($this->editor(), 'staff') + ->test(EditPage::class, ['record' => $page->id]) + ->assertSet('register', 'inhalt') + ->set('data.path', '') + ->call('save') + ->assertHasErrors(['data.path']) + ->assertSet('register', 'einstellungen'); + } + + public function test_the_history_register_is_reachable_by_address(): void + { + $page = Page::query()->where('path', '/praevention')->firstOrFail(); + + Livewire::withQueryParams(['bereich' => 'verlauf']) + ->actingAs($this->editor(), 'staff') + ->test(EditPage::class, ['record' => $page->id]) + ->assertSet('register', 'verlauf') + ->assertSee('Jede Speicherung legt eine Revision an.'); + } + + public function test_designing_a_section_keeps_its_context_across_saving(): void + { + $page = Page::query()->where('path', '/')->firstOrFail(); + $component = Livewire::actingAs($this->editor(), 'staff')->test(EditPage::class, ['record' => $page->id]); + $keys = array_keys($component->get('data.sections')); + $second = (string) $keys[1]; + $sectionId = $component->get("data.sections.$second.id"); + + $component->assertSee('Abschnitt gestalten') + ->call('openAbschnitt', $second) + ->assertSet('abschnitt', 1) + ->assertSee('Zum Seitenaufbau') + ->assertSee('Abschnitt 2 gestalten') + ->set("data.sections.$second.style.background", 'dark') + ->call('save') + ->assertHasNoErrors() + ->assertSet('abschnitt', 1); + + $keysAfter = array_keys($component->get('data.sections')); + $this->assertSame($sectionId, $component->get('data.sections.'.$keysAfter[1].'.id'), 'Nach dem Speichern zeigt der Kontext denselben Abschnitt.'); + $this->assertSame((string) $keysAfter[1], $component->instance()->abschnittSchluessel()); + $this->assertSame('dark', $page->fresh()->latestRevision->sections[1]['style']['background']); + + $component->call('closeAbschnitt') + ->assertSet('abschnitt', null) + ->call('openAbschnitt', 'gibt-es-nicht') + ->assertSet('abschnitt', null); + } + + public function test_the_grouped_section_settings_save_together(): void + { + $page = Page::query()->where('path', '/')->firstOrFail(); + $component = Livewire::actingAs($this->editor(), 'staff')->test(EditPage::class, ['record' => $page->id]); + $second = (string) array_keys($component->get('data.sections'))[1]; + + $component->call('openAbschnitt', $second) + ->assertSee('Raster und Breite') + ->assertSee('Hintergrund') + ->assertSee('Abstände und Trenner') + ->set("data.sections.$second.layout", 'u3_1') + ->set("data.sections.$second.style.width", 'wide') + ->set("data.sections.$second.style.background", 'light') + ->set("data.sections.$second.style.spacing_top", 'none') + ->set("data.sections.$second.style.divider", 'accent') + ->call('save') + ->assertHasNoErrors(); + + $section = $page->fresh()->latestRevision->sections[1]; + $this->assertSame('u3_1', $section['layout']); + $this->assertSame(['wide', 'light', 'none', 'accent'], [$section['style']['width'], $section['style']['background'], $section['style']['spacing_top'], $section['style']['divider']]); + } + + public function test_the_create_form_keeps_raster_and_design_in_every_section(): void + { + Livewire::actingAs($this->editor(), 'staff') + ->test(CreatePage::class) + ->assertDontSee('Abschnitt gestalten') + ->assertDontSee('Zur Seite'); + } + + public function test_configuring_a_block_names_it_and_its_place_and_returns_to_the_page(): void + { + $page = Page::query()->where('path', '/praevention')->firstOrFail(); + $component = Livewire::actingAs($this->editor(), 'staff')->test(EditPage::class, ['record' => $page->id]); + $sectionKey = array_key_first($component->get('data.sections')); + $slotKey = array_key_first($component->get("data.sections.$sectionKey.slots")); + $widgetKey = array_key_first($component->get("data.sections.$sectionKey.slots.$slotKey.widget")); + $edit = TestAction::make('edit')->schemaComponent("sections.$sectionKey.slots.$slotKey.widget")->arguments(['item' => $widgetKey]); + + $component->assertSee('Konfigurieren')->mountAction($edit); + $action = $component->instance()->getMountedAction(); + $this->assertSame('Überschrift und Einleitung konfigurieren · Abschnitt 1 · Platz 1 · 4 Einheiten', $action->getModalHeading()); + $this->assertSame('Zum Seitenaufbau', $action->getModalSubmitActionLabel()); + $this->assertSame(['entwurfSpeichern'], array_values(array_map(fn ($footer) => $footer->getName(), $action->getExtraModalFooterActions()))); + $this->assertFalse($action->isModalClosedByEscaping()); + $this->assertFalse($action->isModalClosedByClickingAway()); + $this->assertFalse($action->hasModalCloseButton(), 'Ohne Schließen-Kreuz: Verlassen nur über „Zur Seite“ oder „Änderungen verwerfen“.'); + $this->assertStringContainsString('luf-baustein-dialog', (string) $action->getExtraModalWindowAttributeBag(), 'Eigener Scrollbereich, damit der Dialogfuß erreichbar bleibt.'); + } + + public function test_saving_from_the_block_applies_it_and_saves_the_draft_without_an_extra_step(): void + { + $page = Page::query()->where('path', '/praevention')->firstOrFail(); + $before = $page->latestRevision->id; + $component = Livewire::actingAs($this->editor(), 'staff')->test(EditPage::class, ['record' => $page->id]); + $sectionKey = array_key_first($component->get('data.sections')); + $slotKey = array_key_first($component->get("data.sections.$sectionKey.slots")); + $widgetKey = array_key_first($component->get("data.sections.$sectionKey.slots.$slotKey.widget")); + $data = $component->get("data.sections.$sectionKey.slots.$slotKey.widget.$widgetKey.data"); + $data['data']['heading'] = 'Direkt aus dem Baustein gespeichert'; + + $component->callAction( + TestAction::make('edit')->schemaComponent("sections.$sectionKey.slots.$slotKey.widget")->arguments(['item' => $widgetKey, 'speichern' => true]), + $data, + )->assertHasNoErrors(); + + $revision = $page->fresh()->latestRevision; + $this->assertNotSame($before, $revision->id, 'Eine neue Revision ist gespeichert.'); + $this->assertSame('Direkt aus dem Baustein gespeichert', $revision->sections[0]['slots'][0]['data']['heading']); + $this->assertNotSame($revision->id, $page->fresh()->published_revision_id, 'Speichern veröffentlicht nicht.'); + } + + public function test_a_design_error_from_the_page_layout_opens_the_failing_section(): void + { + $page = Page::query()->where('path', '/')->firstOrFail(); + $component = Livewire::actingAs($this->editor(), 'staff')->test(EditPage::class, ['record' => $page->id]); + $second = (string) array_keys($component->get('data.sections'))[1]; + $revision = $page->latestRevision?->id; + + // Hintergrund „Bild“ ohne Bild: Der Fehler steht am Bildfeld, das nur im Kontext „Abschnitt gestalten“ sichtbar ist. + $component->assertSet('abschnitt', null) + ->set("data.sections.$second.style.background", 'image') + ->call('save') + ->assertHasErrors(["data.sections.$second.style.image"]) + ->assertSet('register', 'inhalt') + ->assertSet('abschnitt', 1); + + $this->assertSame($revision, $page->fresh()->latestRevision?->id, 'Ein fehlerhafter Stand legt keine Revision an.'); + } + + public function test_a_design_error_in_another_section_leaves_the_current_context_for_that_section(): void + { + $page = Page::query()->where('path', '/')->firstOrFail(); + $component = Livewire::actingAs($this->editor(), 'staff')->test(EditPage::class, ['record' => $page->id]); + [$first, $second] = array_map('strval', array_slice(array_keys($component->get('data.sections')), 0, 2)); + + $component->call('openAbschnitt', $first) + ->assertSet('abschnitt', 0) + ->set("data.sections.$second.style.background", 'image') + ->call('save') + ->assertHasErrors(["data.sections.$second.style.image"]) + ->assertSet('abschnitt', 1); + + // Liegt der Fehler im gestalteten Abschnitt, bleibt der Kontext. + $component->call('save')->assertHasErrors(["data.sections.$second.style.image"])->assertSet('abschnitt', 1); + } + + private function editor(): User + { + $editor = User::factory()->redakteur()->create(); + $editor->saveAppAuthenticationSecret('JBSWY3DPEHPK3PXP'); + + return $editor; + } +} diff --git a/tests/Feature/CmsDesignIterationTest.php b/tests/Feature/CmsDesignIterationTest.php new file mode 100644 index 0000000..dd5fe7d --- /dev/null +++ b/tests/Feature/CmsDesignIterationTest.php @@ -0,0 +1,93 @@ +> $content Abschnitte oder Widgets + */ + private function publish(string $path, array $content): string + { + $page = Page::query()->create(['path' => $path]); + $service = app(PageService::class); + $service->publish($page, $service->saveRevision($page, $content, null, null, null)); + + return $this->get($path)->assertOk()->getContent(); + } + + /** + * @param list|null> $slots + * @param array $style + * @return array + */ + private function section(string $layout, array $slots, array $style = []): array + { + return ['layout' => $layout, 'style' => $style, 'slots' => $slots]; + } + + public function test_header_keeps_one_box_with_compact_bar_and_sets_the_menu_mode_before_painting(): void + { + $html = $this->publish('/rahmen', [['type' => 'heading', 'v' => 1, 'data' => ['heading' => 'Rahmen']]]); + + $this->assertStringContainsString('data-site-header-sentinel', $html); + $this->assertMatchesRegularExpression('#\s*', 'heading' => 'Erster Einstieg', 'alt' => 'Lara und Felix', 'focus_x' => 30, 'focus_y' => 70], + 'refs' => ['image' => 'cms/park.jpg'], + ]]), + $this->section('u3_1', [[ + 'type' => 'hero', 'v' => 2, 'variant' => 'editorial_solid', 'settings' => ['height' => 'large', 'heading_level' => 'h3', 'accent' => 'rays'], + 'data' => ['heading' => 'Zweiter Einstieg', 'cta_label' => 'Konzept', 'cta_url' => '/konzept'], + ], null]), + ]); + + $this->assertStringContainsString('class="lf-hero lf-hero--photo-split lf-hero--height-compact lf-hero--accent-none"', $html); + $this->assertStringContainsString('style="--lf-hero-focus-x: 30%; --lf-hero-focus-y: 70%"', $html); + $this->assertStringContainsString('alt="Lara und Felix" loading="eager" fetchpriority="high" decoding="async"', $html); + $this->assertStringContainsString('<script>alert(1)</script>', $html); + $this->assertStringNotContainsString('', $html); + $this->assertSame(1, substr_count($html, 'assertStringContainsString('

Erster Einstieg

', $html); + $this->assertStringContainsString('

Zweiter Einstieg

', $html); + $this->assertStringContainsString('lf-hero--editorial-solid lf-hero--height-large lf-hero--accent-rays', $html); + $this->assertStringContainsString('brand-rays lf-hero__rays', $html); + $this->assertSame(1, substr_count($html, 'lf-hero__title-accent'), 'Ohne Akzent keine Unterstreichung.'); + $this->assertStringContainsString('widget-hero widget-variant-photo-split widget-height-compact', $html); + } + + public function test_hero_rejects_unsafe_links_and_out_of_range_focus(): void + { + $cases = [ + 'blocks.0.data.cta2_url' => ['heading' => 'X', 'cta2_label' => 'Böse', 'cta2_url' => 'javascript:alert(1)'], + 'blocks.0.data.focus_x' => ['heading' => 'X', 'focus_x' => 150], + ]; + + foreach ($cases as $key => $data) { + try { + app(WidgetRegistry::class)->normalize([['type' => 'hero', 'v' => 2, 'data' => $data]]); + $this->fail("$key wurde angenommen."); + } catch (ValidationException $exception) { + $this->assertArrayHasKey($key, $exception->errors()); + } + } + } + + public function test_premium_image_text_renders_surface_height_side_and_sanitized_body(): void + { + $html = $this->publish('/bild-text', [ + ['type' => 'heading', 'v' => 1, 'data' => ['heading' => 'Seite']], + $this->section('u4', [[ + 'type' => 'image_text', 'v' => 3, 'variant' => 'image_left', + 'settings' => ['surface' => 'navy', 'height' => 'spacious', 'heading_level' => 'h3'], + 'data' => ['eyebrow' => 'Unser Ansatz', 'title' => 'Geschichten', 'body' => '

Text

', 'alt' => 'Park', 'cta_label' => 'Mehr', 'cta_url' => '/konzept', 'cta2_label' => 'Themen', 'cta2_url' => 'https://example.org/themen', 'focus_x' => 10, 'focus_y' => 90], + 'refs' => ['image' => 'cms/park.jpg'], + ]]), + $this->section('u4', [['type' => 'image_text', 'v' => 3, 'data' => ['body' => '

Ohne Bild

']]]), + ]); + + $this->assertStringContainsString('class="lf-bt lf-bt--navy lf-bt--image-left lf-bt--height-spacious"', $html); + $this->assertStringContainsString('style="--bt-focus-x: 10%; --bt-focus-y: 90%"', $html); + $this->assertStringContainsString('

Geschichten

', $html); + $this->assertStringContainsString('

Unser Ansatz

', $html); + $this->assertStringNotContainsString('', $html); + $this->assertStringContainsString('Mehr ', $html); + $this->assertStringContainsString('Themen', $html); + $this->assertStringContainsString('lf-bt lf-bt--cream lf-bt--image-left lf-bt--height-normal lf-bt--without-image', $html); + } + + /** + * Gemeinsamer Layoutvertrag für alle Bestandswidgets: In jeder zulässigen Platzbreite wird gerendert; nicht + * zulässige Breiten werden beim Speichern mit verständlicher Meldung abgewiesen. + */ + public function test_every_widget_renders_in_each_supported_width_and_rejects_the_others(): void + { + $samples = [ + 'heading' => ['heading' => 'Überschrift mit einem sehr langen Wort Gewaltpräventionsfortbildungsmaßnahme'], + 'prose' => ['body' => 'Fließtext mit einer langen Adresse https://example.org/'.str_repeat('a', 80)], + 'cards' => ['items' => [['title' => 'Karte mit langem Titel für schmale Plätze', 'text' => 'Beschreibung', 'url' => '/a']]], + 'call_to_action' => ['heading' => 'Aufruf', 'text' => 'Text', 'label' => 'Eine ausgesprochen lange Schaltflächenbeschriftung zum Prüfen', 'url' => '/a'], + 'faq' => ['items' => [['question' => 'Frage?', 'answer' => 'Antwort.']]], + 'hero' => ['heading' => 'Einstieg mit einer langen Überschrift, die umbrechen muss'], + 'image_text' => ['title' => 'Bild und Text', 'body' => '

Text

'], + ]; + $registry = app(WidgetRegistry::class); + $layouts = ['u4' => [4], 'u3_1' => [3, 1], 'u2_2' => [2, 2], 'u1_1_1_1' => [1, 1, 1, 1]]; + $path = 0; + + foreach ($samples as $type => $data) { + $widgetType = $registry->get($type); + $widget = ['type' => $type, 'v' => $widgetType->version(), 'data' => $data]; + + foreach ($layouts as $layout => $units) { + $slots = array_fill(0, count($units), null); + $slots[0] = $widget; + + if ($widgetType->supportsUnits($units[0])) { + $html = $this->publish('/raster-'.(++$path), [$this->section($layout, $slots)]); + $this->assertStringContainsString('widget-'.str_replace('_', '-', $type), $html, "$type in $layout"); + $this->assertStringContainsString('data-units="'.$units[0].'"', $html, "$type in $layout"); + } else { + try { + app(PageService::class)->saveRevision(Page::query()->create(['path' => '/abgewiesen-'.(++$path)]), [$this->section($layout, $slots)], null, null, null); + $this->fail("$type in $layout ({$units[0]} Einheiten) wurde angenommen."); + } catch (ValidationException $exception) { + $this->assertStringContainsString($widgetType->unitsLabel().' Rastereinheiten', $exception->errors()['sections.0.slots.0.units'][0]); + } + } + } + } + + $this->assertSame(['u4', 'u2_2', 'u1_3', 'u3_1', 'u1_2_1', 'u1_1_1_1', 'u1_1_2', 'u2_1_1'], array_keys(SectionLayouts::UNITS), 'Raster werden nur ergänzt (v1.7: 1 + 1 + 2 und 2 + 1 + 1 für gemischte Kartenraster).'); + } + + public function test_fill_height_marks_the_widget_and_defaults_to_content_height(): void + { + $html = $this->publish('/fuellen', [ + $this->section('u2_2', [ + ['type' => 'call_to_action', 'v' => 1, 'settings' => ['height' => 'fill'], 'data' => ['heading' => 'Gleich hoch', 'label' => 'Los', 'url' => '/a']], + ['type' => 'call_to_action', 'v' => 1, 'data' => ['heading' => 'Nach Inhalt', 'label' => 'Los', 'url' => '/b']], + ]), + ]); + + $this->assertStringContainsString('widget-call-to-action widget-variant-standard widget-height-fill', $html); + $this->assertStringContainsString('widget-call-to-action widget-variant-standard widget-height-auto', $html); + $this->assertStringNotContainsString('widget-prose widget-variant-standard widget-height', $html); + } +} diff --git a/tests/Feature/CmsRollbackCommandTest.php b/tests/Feature/CmsRollbackCommandTest.php new file mode 100644 index 0000000..edec1e6 --- /dev/null +++ b/tests/Feature/CmsRollbackCommandTest.php @@ -0,0 +1,45 @@ +where('path', '/praevention')->firstOrFail(); + $before = $page->published_revision_id; + + Carbon::setTestNow('2030-01-01 12:00:00'); + $new = $service->saveRevision($page, [['layout' => 'u2_2', 'style' => [], 'slots' => [ + ['type' => 'heading', 'v' => 1, 'data' => ['heading' => 'Neu']], + null, + ]]], null, null, null); + $service->publish($page, $new); + $created = Page::query()->create(['path' => '/neu-nach-deploy']); + $service->publish($created, $service->saveRevision($created, [['type' => 'heading', 'v' => 1, 'data' => ['heading' => 'Ganz neu']]], null, null, null)); + Carbon::setTestNow(); + + $this->artisan('cms:revert-published', ['--before' => '2030-01-01 11:00'])->assertSuccessful(); + $this->assertSame($new->id, $page->fresh()->published_revision_id, 'Ohne --apply ändert sich nichts.'); + + $this->artisan('cms:revert-published', ['--before' => '2030-01-01 11:00', '--apply' => true])->assertSuccessful(); + + $this->assertSame($before, $page->fresh()->published_revision_id); + $this->assertNull($created->fresh()->published_revision_id, 'Eine erst danach angelegte Seite wird zurückgezogen.'); + $this->assertNotNull($new->fresh(), 'Revisionen bleiben erhalten.'); + } + + public function test_missing_time_is_rejected(): void + { + $this->artisan('cms:revert-published')->assertFailed(); + } +} diff --git a/tests/Feature/CmsSectionRenderingTest.php b/tests/Feature/CmsSectionRenderingTest.php new file mode 100644 index 0000000..a8bbd23 --- /dev/null +++ b/tests/Feature/CmsSectionRenderingTest.php @@ -0,0 +1,262 @@ + + */ + private function heading(string $text): array + { + return ['type' => 'heading', 'v' => 1, 'data' => ['heading' => $text]]; + } + + /** + * @return array + */ + private function prose(string $text): array + { + return ['type' => 'prose', 'v' => 1, 'data' => ['body' => $text]]; + } + + /** + * @param list> $sections + */ + private function publish(string $path, array $sections): Page + { + $service = app(PageService::class); + $page = Page::query()->create(['path' => $path]); + $service->publish($page, $service->saveRevision($page, $sections, null, null, null)); + + return $page->fresh(); + } + + public function test_sections_render_grid_ratios_backgrounds_and_dividers(): void + { + $this->publish('/raster', [ + ['layout' => 'u4', 'style' => ['background' => 'dark', 'divider' => 'accent'], 'slots' => [$this->heading('Einstieg')]], + ['layout' => 'u1_3', 'style' => ['background' => 'light', 'width' => 'wide', 'divider' => 'line'], 'slots' => [$this->prose('Schmal'), $this->prose('Breit')]], + ['layout' => 'u1_1_1_1', 'style' => ['background' => 'accent', 'spacing' => 'large'], 'slots' => [$this->prose('A'), $this->prose('B'), $this->prose('C'), $this->prose('D')]], + ['layout' => 'u2_2', 'style' => ['divider' => 'line'], 'slots' => [$this->prose('Letzter')]], + ]); + + $html = $this->get('/raster')->assertOk()->getContent(); + + $this->assertStringContainsString('page-section section-bg-dark section-width-standard section-space-top-compact section-space-bottom-compact section-gap-normal section-layout-u4 scope-dark', $html); + $this->assertStringContainsString('section-bg-light section-width-wide', $html); + $this->assertStringContainsString('--section-cols-lg: minmax(0, 1fr) minmax(0, 3fr); --section-cols-md: minmax(0, 1fr)', $html); + $this->assertStringContainsString('--section-cols-md: repeat(2, minmax(0, 1fr))', $html, 'Vier gleiche Plätze stehen auf dem Tablet als 2 × 2.'); + // Eingabe im Format der Version 1 („spacing“): oben und unten großzügig, Widget-Abstand wie bisher normal. + $this->assertStringContainsString('section-bg-accent section-width-standard section-space-top-large section-space-bottom-large section-gap-normal section-layout-u1-1-1-1 scope-accent', $html); + $this->assertStringContainsString('section-divider section-divider-accent', $html); + $this->assertSame(1, substr_count($html, 'section-divider section-divider-line'), 'Nach dem letzten Abschnitt steht kein Trenner.'); + $this->assertSame(1, substr_count($html, '

'), 'Nur das erste Widget der Seite ist Überschrift erster Ordnung.'); + $this->assertLessThan(strpos($html, 'Breit'), strpos($html, 'Schmal'), 'Lese- und Fokusreihenfolge folgt den Plätzen.'); + } + + public function test_empty_slots_and_empty_sections_leave_no_gaps(): void + { + $this->publish('/luecken', [ + ['layout' => 'u1_2_1', 'style' => [], 'slots' => [$this->prose('Links'), null, $this->prose('Rechts')]], + ['layout' => 'u2_2', 'style' => ['background' => 'dark'], 'slots' => [null, null]], + ['layout' => 'u1_3', 'style' => [], 'slots' => [null, $this->prose('Allein')]], + ]); + + $html = $this->get('/luecken')->assertOk()->getContent(); + + $this->assertStringContainsString('data-slots="2" style="--section-cols-lg: minmax(0, 1fr) minmax(0, 1fr)', $html, 'Die übrigen Plätze teilen sich die Breite im Verhältnis ihrer Einheiten.'); + $this->assertStringContainsString('data-slots="1" style="--section-cols-lg: minmax(0, 1fr)', $html); + $this->assertStringNotContainsString('section-bg-dark', $html, 'Ein Abschnitt ohne Inhalt entfällt samt Fläche.'); + } + + public function test_background_image_comes_from_the_public_area_with_focus_and_overlay(): void + { + Queue::fake(); + + $this->publish('/bild', [ + ['layout' => 'u4', 'style' => ['background' => 'image', 'image' => 'cms/flaeche.jpg', 'focus' => 'top_left', 'overlay' => 'dark'], 'slots' => [$this->heading('Auf Bild')]], + ['layout' => 'u4', 'style' => ['background' => 'image', 'image' => 'cms/zweites.jpg', 'overlay' => 'light'], 'slots' => [$this->prose('Hell')]], + ]); + + $html = $this->get('/bild')->assertOk()->getContent(); + + $this->assertStringContainsString('section-bg-image', $html); + $this->assertStringContainsString('section-overlay-dark scope-dark', $html); + $this->assertStringContainsString('section-overlay-light scope-light', $html); + $this->assertMatchesRegularExpression('#]*object-position: 0% 0%#', $html); + $this->assertMatchesRegularExpression('#publish('/gleich', [ + ['layout' => 'u2_2', 'style' => ['background' => 'light'], 'slots' => [$this->heading('Links'), $this->prose('Rechts')]], + ]); + $editor = User::factory()->redakteur()->create(); + + $public = $this->get('/gleich')->getContent(); + $preview = $this->actingAs($editor, 'staff')->get(route('pages.preview', $page->published_revision_id))->getContent(); + + $this->assertSame($this->sectionsMarkup($public), $this->sectionsMarkup($preview)); + $this->assertStringContainsString('Vorschau einer unveröffentlichten Revision', $preview); + } + + public function test_public_page_is_identical_for_guests_and_members(): void + { + // Schrift-Vorabladehinweise gibt der Rahmen je Prozess nur einmal aus; sie hängen nicht vom Besucher ab. + $withoutPreload = fn (string $html): string => preg_replace('#]*>\s*#', '', $html); + $guest = $withoutPreload($this->get('/praevention')->assertOk()->getContent()); + $member = $withoutPreload($this->actingAs(User::factory()->create())->get('/praevention')->assertOk()->getContent()); + + $this->assertSame($guest, $member, 'Öffentliche Seiten hängen nicht vom Anmeldestatus ab (ADR-32).'); + $this->assertStringContainsString('href="'.route('member.dashboard').'"', $guest); + $this->assertStringContainsString('Mitgliederbereich', $guest); + } + + public function test_global_layout_has_header_navigation_mobile_menu_and_footer(): void + { + $html = $this->get('/praevention')->assertOk()->getContent(); + + $this->assertStringContainsString('Prävention#', $html); + $this->assertStringContainsString('data-site-menu-button', $html); + $this->assertStringContainsString('aria-controls="site-nav"', $html); + $this->assertStringContainsString('class="site-footer scope-dark"', $html); + $this->assertStringContainsString('

', $html); + $this->assertStringContainsString('Impressum', $html); + $this->assertStringNotContainsString('Warenkorb', $html, 'Ohne Warenkorb erscheint kein funktionsloser Kaufknopf.'); + $this->assertStringNotContainsString('fonts.bunny.net', $html); + $this->assertStringNotContainsString('fonts.googleapis.com', $html); + } + + public function test_cart_entry_appears_only_when_enabled(): void + { + config(['cms.cart.enabled' => true, 'cms.cart.url' => '/warenkorb']); + + $this->get('/praevention')->assertSee('Warenkorb')->assertSee('href="/warenkorb"', false); + } + + public function test_submenus_footer_groups_and_hidden_parents(): void + { + $parent = NavigationItem::query()->where('label', 'Prävention')->firstOrFail(); + NavigationItem::query()->create(['label' => 'Grenzen', 'url' => '/themen/grenzen', 'placement' => 'header', 'parent_id' => $parent->id, 'sort_order' => 1]); + NavigationItem::query()->create(['label' => 'Kontaktformular', 'url' => '/kontakt', 'placement' => 'footer_contact', 'sort_order' => 1]); + NavigationItem::query()->create(['label' => 'Fußkind', 'url' => '/x', 'placement' => 'footer', 'parent_id' => $parent->id, 'sort_order' => 2]); + + $html = $this->get('/praevention')->getContent(); + + $this->assertStringContainsString('site-nav-item has-children is-active-trail', $html); + $this->assertStringContainsString('aria-controls="untermenue-'.$parent->id.'"', $html); + $this->assertStringContainsString('Untermenü Prävention', $html); + $this->assertMatchesRegularExpression('#
    \s*
  • Grenzen
  • #', $html); + $this->assertStringContainsString('', $html); + $this->assertNull(NavigationItem::query()->where('label', 'Fußkind')->value('parent_id'), 'Untermenüs gibt es nur in der Hauptnavigation.'); + + $parent->update(['is_visible' => false]); + $this->assertStringNotContainsString('Grenzen', $this->get('/praevention')->getContent(), 'Mit dem Eintrag ist auch sein Untermenü ausgeblendet.'); + } + + public function test_deleting_a_parent_moves_its_children_to_the_top_level(): void + { + $parent = NavigationItem::query()->where('label', 'Prävention')->firstOrFail(); + $child = NavigationItem::query()->create(['label' => 'Grenzen', 'url' => '/themen/grenzen', 'placement' => 'header', 'parent_id' => $parent->id]); + + $parent->delete(); + + $this->assertNull($child->fresh()->parent_id); + $this->get('/ueber')->assertSee('Grenzen'); + } + + public function test_member_area_uses_the_shared_wordmark_and_tokens(): void + { + $member = User::factory()->create(); + + $this->actingAs($member) + ->get(route('member.dashboard')) + ->assertOk() + ->assertSee('class="brand member-mark"', false) + ->assertSee('Mitgliederbereich', false) + ->assertSee('class="member-dock"', false); + } + + public function test_rollback_column_lets_the_previous_renderer_show_every_widget(): void + { + $page = $this->publish('/rueckfall', [ + ['layout' => 'u1_1_1_1', 'style' => ['background' => 'dark'], 'slots' => [$this->heading('Erstens'), $this->prose('Zweitens'), null, $this->prose('Viertens')]], + ]); + + // Darstellung wie in der Fassung vor dem Abschnittsraster: flache Liste aus der Spalte blocks. + $html = app(WidgetRenderer::class)->renderAll($page->publishedRevision->blocks, RenderContext::publicPage())->toHtml(); + + foreach (['Erstens', 'Zweitens', 'Viertens'] as $text) { + $this->assertStringContainsString($text, $html); + } + } + + public function test_restore_copies_sections_and_rollback_column_unchanged(): void + { + $page = $this->publish('/wieder', [ + ['layout' => 'u2_2', 'style' => ['background' => 'light'], 'slots' => [$this->heading('Früher'), $this->prose('Stand')]], + ]); + $first = $page->publishedRevision; + $service = app(PageService::class); + $service->publish($page, $service->saveRevision($page, [['layout' => 'u4', 'style' => [], 'slots' => [$this->heading('Später')]]], null, null, null)); + + $restored = $service->restore($page->fresh(), $first, null); + $service->publish($page->fresh(), $restored); + + $this->assertSame($first->sections, $restored->fresh()->sections); + $this->assertSame($first->blocks, $restored->fresh()->blocks); + $this->get('/wieder')->assertSee('Früher')->assertDontSee('Später'); + } + + public function test_program_reference_in_a_narrow_slot_reads_catalog_data(): void + { + $program = $this->composition('Programm Abstand', 'programm', summary: 'Kurzbeschreibung aus den Fachdaten'); + + $this->publish('/programme-schmal', [ + ['layout' => 'u3_1', 'style' => [], 'slots' => [ + $this->prose('Hauptinhalt'), + ['type' => 'catalog_cards', 'v' => 1, 'variant' => 'compact', 'data' => [], 'refs' => ['items' => [['type' => 'composition', 'id' => $program->composition_id]]]], + ]], + ]); + + $this->get('/programme-schmal') + ->assertOk() + ->assertSee('Programm Abstand') + ->assertSee('catalog-cards catalog-cards-compact', false) + ->assertSee('data-units="1"', false); + } + + private function sectionsMarkup(string $html): string + { + preg_match('#]*>(.*)#s', $html, $match); + $markup = preg_replace('#

    #s', '', $match[1] ?? ''); + + return trim(preg_replace('/\s+/', ' ', $markup)); + } +} diff --git a/tests/Feature/CmsWebsiteMediaTest.php b/tests/Feature/CmsWebsiteMediaTest.php new file mode 100644 index 0000000..2be8a78 --- /dev/null +++ b/tests/Feature/CmsWebsiteMediaTest.php @@ -0,0 +1,323 @@ +releasedImage('Lara im Park', 'Lara sitzt auf einer Parkbank'); + $url = route('website.media', $medium); + + $revision = $this->publish('/medien-ueberall', [ + ['layout' => 'u4', 'style' => ['background' => 'image', 'image' => $medium->id, 'overlay' => 'light'], 'slots' => [ + ['type' => 'hero', 'v' => 2, 'variant' => 'photo_split', 'data' => ['heading' => 'Einstieg'], 'refs' => ['image' => $medium->id]], + ]], + ['layout' => 'u2_2', 'style' => [], 'slots' => [ + ['type' => 'image_text', 'v' => 3, 'variant' => 'image_left', 'data' => ['title' => 'Bild und Text', 'body' => '

    Text

    ', 'alt' => 'Eigene Beschreibung'], 'refs' => ['image' => $medium->id]], + ['type' => 'cards', 'v' => 1, 'data' => ['items' => [['title' => 'Karte', 'image' => $medium->id]]]], + ]], + ]); + + $this->assertSame($medium->id, $revision->sections[0]['slots'][0]['refs']['image'], 'Gespeichert wird die Kennung, keine Kopie.'); + $this->assertSame($medium->id, $revision->sections[0]['style']['image']); + + $main = $this->main($this->get('/medien-ueberall')->assertOk()->getContent()); + $this->assertSame(4, substr_count($main, 'src="'.$url.'"'), 'Hintergrund, Einstieg, Bild und Text, Karte verwenden dasselbe Medium.'); + $this->assertStringContainsString('alt="Lara sitzt auf einer Parkbank"', $main, 'Alternativtext des Mediums.'); + $this->assertStringContainsString('alt="Eigene Beschreibung"', $main, 'Abweichender Alternativtext im Widget.'); + $this->assertStringNotContainsString('/redaktion/', $main); + $this->assertStringNotContainsString('/medien/cms/', $main); + $this->assertSame([['path' => '/medien-ueberall', 'published' => true, 'draft' => false]], app(WebsiteImageUsage::class)->pages($medium), 'Der Medienmanager zeigt die Verwendung auf Website-Seiten.'); + } + + public function test_an_unreleased_medium_is_only_shown_in_the_preview_with_a_notice(): void + { + $medium = $this->unreleasedImage('Noch nicht freigegeben'); + + $revision = $this->publish('/nicht-freigegeben', [ + ['layout' => 'u4', 'style' => [], 'slots' => [ + ['type' => 'image_text', 'v' => 3, 'variant' => 'image_left', 'data' => ['title' => 'Mit Bild', 'body' => '

    Text bleibt sichtbar.

    '], 'refs' => ['image' => $medium->id]], + ]], + ]); + + $main = $this->main($this->get('/nicht-freigegeben')->assertOk()->getContent()); + $this->assertStringContainsString('Text bleibt sichtbar.', $main, 'Nur das Bild entfällt, nicht das Widget.'); + $this->assertStringNotContainsString('assertStringContainsString('lf-bt--without-image', $main); + + $preview = $this->actingAs(User::factory()->redakteur()->create(), 'staff')->get(route('pages.preview', $revision))->assertOk()->getContent(); + $this->assertStringContainsString('src="'.route('editorial.card', ['kind' => 'element', 'subject' => $medium->id]).'"', $preview); + $this->assertStringContainsString('Das gewählte Bild „Noch nicht freigegeben“ erscheint öffentlich nicht: Nicht für die Website freigegeben.', $preview); + } + + public function test_withdrawing_the_release_removes_the_image_from_pages_and_closes_the_former_address(): void + { + Storage::disk('media_public')->put('cms/altbild-abc123.jpg', $this->jpeg(1200, 600)); + $this->publish('/altbild', [ + ['layout' => 'u4', 'style' => [], 'slots' => [ + ['type' => 'hero', 'v' => 2, 'variant' => 'photo_split', 'data' => ['heading' => 'Früher'], 'refs' => ['image' => 'cms/altbild-abc123.jpg']], + ]], + ]); + (new ImportCmsImages)->handle(app(WebsiteIntake::class)); + $medium = WebsiteMediaAlias::query()->where('legacy_path', 'cms/altbild-abc123.jpg')->firstOrFail()->element; + $this->assertNotNull($medium->website_released_at); + $this->refreshScoped(); + + $this->get('/altbild')->assertSee('src="'.route('website.media', $medium).'"', false)->assertDontSee('/medien/cms/altbild', false); + $this->get('/medien/cms/altbild-abc123.jpg')->assertOk(); + + app(WebsiteRelease::class)->withdraw($medium); + $this->refreshScoped(); + + $this->assertStringNotContainsString('main($this->get('/altbild')->assertOk()->getContent())); + $this->get('/medien/cms/altbild-abc123.jpg')->assertNotFound(); + $this->get(route('website.media', $medium))->assertNotFound(); + Storage::disk('media_public')->assertExists('cms/altbild-abc123.jpg'); + } + + public function test_former_cms_images_are_imported_once_deduplicated_and_without_deleting_files(): void + { + $same = $this->jpeg(800, 400); + Storage::disk('media_public')->put('cms/platzhalter-karte-1-aaaaaa.jpg', $same); + Storage::disk('media_public')->put('cms/platzhalter-karte-1-bbbbbb.jpg', $same); + Storage::disk('media_public')->put('cms/markenbuehne-cccccc.png', $this->jpeg(900, 300)); + Storage::disk('media_public')->put('cms/notiz.txt', 'kein Bild'); + + (new ImportCmsImages)->handle(app(WebsiteIntake::class)); + (new ImportCmsImages)->handle(app(WebsiteIntake::class)); + + $this->assertSame(3, WebsiteMediaAlias::query()->count()); + $this->assertSame(2, ContentElement::query()->where('output_class', 'bild')->count(), 'Bytegleiche Dateien werden ein Medium.'); + $this->assertSame(['Markenbuehne', 'Platzhalter Karte 1'], ContentElement::query()->orderBy('working_title')->pluck('working_title')->all()); + $this->assertSame( + WebsiteMediaAlias::query()->where('legacy_path', 'cms/platzhalter-karte-1-aaaaaa.jpg')->value('content_element_id'), + WebsiteMediaAlias::query()->where('legacy_path', 'cms/platzhalter-karte-1-bbbbbb.jpg')->value('content_element_id'), + ); + foreach (['cms/platzhalter-karte-1-aaaaaa.jpg', 'cms/platzhalter-karte-1-bbbbbb.jpg', 'cms/markenbuehne-cccccc.png'] as $path) { + Storage::disk('media_public')->assertExists($path); + } + $this->assertTrue(ContentElement::query()->get()->every(fn (ContentElement $element): bool => $element->website_released_at !== null)); + } + + public function test_an_alias_takes_effect_only_after_the_medium_was_released(): void + { + Storage::disk('media_public')->put('cms/kaputt-dddddd.jpg', 'keine Bilddaten'); + $this->publish('/kaputt', [ + ['layout' => 'u4', 'style' => [], 'slots' => [ + ['type' => 'hero', 'v' => 2, 'variant' => 'photo_split', 'data' => ['heading' => 'Bild bleibt'], 'refs' => ['image' => 'cms/kaputt-dddddd.jpg']], + ]], + ]); + + (new ImportCmsImages)->handle(app(WebsiteIntake::class)); + $this->refreshScoped(); + + $this->assertNotNull(WebsiteMediaAlias::query()->where('legacy_path', 'cms/kaputt-dddddd.jpg')->first()); + $this->get('/kaputt')->assertSee('/medien/cms/kaputt-dddddd.jpg', false); + } + + public function test_saving_converts_an_imported_path_to_the_medium_and_rejects_other_media(): void + { + Storage::disk('media_public')->put('cms/umzug-eeeeee.jpg', $this->jpeg(1000, 500)); + (new ImportCmsImages)->handle(app(WebsiteIntake::class)); + $medium = WebsiteMediaAlias::query()->firstOrFail()->element; + + $revision = $this->publish('/umzug', [ + ['layout' => 'u4', 'style' => [], 'slots' => [ + ['type' => 'hero', 'v' => 2, 'variant' => 'photo_split', 'data' => ['heading' => 'Umzug'], 'refs' => ['image' => 'cms/umzug-eeeeee.jpg']], + ]], + ]); + $this->assertSame($medium->id, $revision->sections[0]['slots'][0]['refs']['image']); + + $film = app(ContentService::class)->createElement('film', 'film', 'Film'); + try { + app(PageService::class)->saveRevision(Page::query()->create(['path' => '/film-als-bild']), [ + ['layout' => 'u4', 'style' => [], 'slots' => [['type' => 'hero', 'v' => 2, 'data' => ['heading' => 'X'], 'refs' => ['image' => $film->id]]]], + ], null, null, null); + $this->fail('Ein Film wurde als Bild angenommen.'); + } catch (ValidationException $exception) { + $this->assertArrayHasKey('sections.0.slots.0.refs.image', $exception->errors()); + } + } + + public function test_an_image_uploaded_in_the_widget_dialog_becomes_a_medium_and_is_selected(): void + { + $editor = User::factory()->redakteur()->create(); + $editor->saveAppAuthenticationSecret('JBSWY3DPEHPK3PXP'); + $page = Page::query()->create(['path' => '/upload']); + app(PageService::class)->saveRevision($page, [ + ['layout' => 'u4', 'style' => [], 'slots' => [['type' => 'hero', 'v' => 2, 'variant' => 'photo_split', 'data' => ['heading' => 'Upload'], 'refs' => []]]], + ], null, null, null); + + $component = Livewire::actingAs($editor, 'staff')->test(EditPage::class, ['record' => $page->id]); + $sectionKey = array_key_first($component->get('data.sections')); + $slotKey = array_key_first($component->get("data.sections.$sectionKey.slots")); + $itemKey = array_key_first($component->get("data.sections.$sectionKey.slots.$slotKey.widget")); + + $component->mountAction(TestAction::make('edit')->schemaComponent("sections.$sectionKey.slots.$slotKey.widget")->arguments(['item' => $itemKey])) + ->fillForm(['refs._upload' => UploadedFile::fake()->image('lara-im-park.jpg', 1600, 900)]) + ->callMountedAction() + ->assertHasNoErrors(); + + $medium = ContentElement::query()->where('output_class', 'bild')->latest('id')->firstOrFail(); + $this->assertSame('Lara Im Park', $medium->display_title); + $this->assertNotNull($medium->website_released_at, 'Neue Bilder werden nach der Verarbeitung für die Website freigegeben.'); + $this->assertSame($medium->id, (int) $component->get("data.sections.$sectionKey.slots.$slotKey.widget.$itemKey.data.refs.image")); + + $component->call('save')->assertHasNoFormErrors(); + $this->assertSame($medium->id, $page->refresh()->latestRevision->sections[0]['slots'][0]['refs']['image']); + } + + public function test_the_picker_lists_website_images_with_their_release_state(): void + { + $released = $this->releasedImage('Freigegeben', null); + $unreleased = $this->unreleasedImage('Unfreigegeben'); + app(ContentService::class)->createElement('film', 'film', 'Film taucht nicht auf'); + + $options = app(WebsiteImage::class)->options(); + $this->assertSame([$unreleased->id, $released->id], array_keys($options)); + $this->assertStringContainsString('Website: freigegeben', $options[$released->id]); + $this->assertStringContainsString('Website: nicht freigegeben', $options[$unreleased->id]); + $this->assertStringContainsString(route('editorial.card', ['kind' => 'element', 'subject' => $released->id]), $options[$released->id]); + } + + public function test_a_block_image_is_chosen_through_the_shared_picker_and_saved_with_the_draft(): void + { + $medium = $this->releasedImage('Lara im Park', 'Lara sitzt auf einer Parkbank'); + $page = Page::query()->firstOrCreate(['path' => '/bild-picker']); + app(PageService::class)->saveRevision($page, [ + ['layout' => 'u4', 'style' => [], 'slots' => [['type' => 'hero', 'v' => 2, 'variant' => 'photo_split', 'data' => ['heading' => 'Einstieg']]]], + ], null, null, null); + $editor = User::factory()->redakteur()->create(); + $editor->saveAppAuthenticationSecret('JBSWY3DPEHPK3PXP'); + + $component = Livewire::actingAs($editor, 'staff')->test(EditPage::class, ['record' => $page->id]); + $sectionKey = array_key_first($component->get('data.sections')); + $slotKey = array_key_first($component->get("data.sections.$sectionKey.slots")); + $widgetKey = array_key_first($component->get("data.sections.$sectionKey.slots.$slotKey.widget")); + $component->mountAction(TestAction::make('edit')->schemaComponent("sections.$sectionKey.slots.$slotKey.widget")->arguments(['item' => $widgetKey])) + ->call('openWebsiteImagePicker', 'mountedActions.0.data.refs.image') + ->assertSet('pickerOpen', true) + ->assertSet('pickerPurpose', 'website-bild') + ->assertSee('Bild aus dem Medienmanager') + ->assertSee('Lara im Park'); + + $target = collect($component->instance()->pickerResult()['items'])->firstWhere('element_id', $medium->id)['target'] ?? null; + $this->assertNotNull($target, 'Das Bild erscheint im gemeinsamen Picker.'); + + $component->call('markPicker', $target, true) + ->call('confirmPicker') + ->assertSet('pickerOpen', false) + ->assertSet('mountedActions.0.data.refs.image', $medium->id) + ->callMountedAction() + ->call('save') + ->assertHasNoErrors(); + + $this->assertSame($medium->id, $page->fresh()->latestRevision->sections[0]['slots'][0]['refs']['image']); + } + + public function test_the_picker_rejects_paths_outside_the_form(): void + { + $page = Page::query()->firstOrCreate(['path' => '/bild-picker-pfad']); + app(PageService::class)->saveRevision($page, [['layout' => 'u4', 'style' => [], 'slots' => [['type' => 'heading', 'v' => 1, 'data' => ['heading' => 'X']]]]], null, null, null); + $editor = User::factory()->redakteur()->create(); + $editor->saveAppAuthenticationSecret('JBSWY3DPEHPK3PXP'); + + Livewire::actingAs($editor, 'staff')->test(EditPage::class, ['record' => $page->id]) + ->call('openWebsiteImagePicker', 'register') + ->assertSet('pickerOpen', false) + ->assertSet('bildZiel', null); + } + + private function releasedImage(string $title, ?string $alt): ContentElement + { + $path = 'cms/'.Str::slug($title).'.jpg'; + Storage::disk('cms_incoming')->put($path, $this->jpeg(1600, 800)); + + return app(WebsiteIntake::class)->acceptImage($path, $title, 'Foto: Lara und Felix', $alt)->refresh(); + } + + private function unreleasedImage(string $title): ContentElement + { + $element = app(ContentService::class)->createElement('bild', 'bild', $title); + $element->forceFill(['thumbnail_path' => 'vorschau/element-'.$element->id.'.jpg'])->save(); + Storage::disk('media_derived')->put($element->thumbnail_path, $this->jpeg(640, 320)); + + return $element->refresh(); + } + + /** + * @param list> $sections + */ + private function publish(string $path, array $sections): PageRevision + { + $page = Page::query()->firstOrCreate(['path' => $path]); + $service = app(PageService::class); + $revision = $service->saveRevision($page, $sections, null, null, null); + $service->publish($page, $revision); + + return $revision; + } + + private function refreshScoped(): void + { + $this->app->forgetScopedInstances(); + } + + private function main(string $html): string + { + preg_match('#]*>(.*)#s', $html, $match); + + return $match[1] ?? ''; + } + + private function jpeg(int $width, int $height): string + { + $image = imagecreatetruecolor($width, $height); + imagefill($image, 0, 0, imagecolorallocate($image, 200, 120, 40)); + ob_start(); + imagejpeg($image); + + return (string) ob_get_clean(); + } +} diff --git a/tests/Feature/CmsWidgetRenderingTest.php b/tests/Feature/CmsWidgetRenderingTest.php new file mode 100644 index 0000000..1ac1249 --- /dev/null +++ b/tests/Feature/CmsWidgetRenderingTest.php @@ -0,0 +1,289 @@ +storeSeededPagesInTheLegacyFormat(); + + $this->assertSame('heading', Page::query()->where('path', '/')->first()->publishedRevision->blocks[0]['type']); + $this->assertArrayNotHasKey('v', Page::query()->where('path', '/')->first()->publishedRevision->blocks[0]); + + foreach (self::LEGACY_PAGES as $path => $fixture) { + $this->assertSame($this->fixture($fixture), $this->mainText($this->get($path)->assertOk()->getContent()), "Abweichung auf $path"); + } + } + + /** + * Rundlauf: eine Seite im Altformat im Editor öffnen, speichern, veröffentlichen – der Text bleibt gleich. + */ + public function test_legacy_page_survives_a_round_trip_through_the_editor(): void + { + $this->storeSeededPagesInTheLegacyFormat(); + Filament::setCurrentPanel(Filament::getPanel('verwaltung')); + $editor = User::factory()->redakteur()->create(); + $editor->saveAppAuthenticationSecret('JBSWY3DPEHPK3PXP'); + + foreach (['/' => 'home', '/praevention' => 'praevention'] as $path => $fixture) { + $page = Page::query()->where('path', $path)->firstOrFail(); + + Livewire::actingAs($editor, 'staff') + ->test(EditPage::class, ['record' => $page->id]) + ->call('save') + ->assertHasNoErrors() + ->callAction('publish'); + + $live = $page->fresh()->publishedRevision; + $this->assertArrayHasKey('v', $live->blocks[0], 'Die neue Revision ist im Hüllenformat gespeichert.'); + $this->assertSame($this->fixture($fixture), $this->mainText($this->get($path)->getContent()), "Abweichung nach Rundlauf auf $path"); + } + } + + private const LEGACY_PAGES = ['/' => 'home', '/praevention' => 'praevention', '/materialien' => 'materialien', '/angebote' => 'angebote', '/trainer' => 'trainer', '/ueber' => 'ueber', '/impressum' => 'impressum', '/datenschutz' => 'datenschutz']; + + /** + * Auf Test und Produktion liegen die Seiten im flachen Format vor der Registry. Die Migration ruft den + * Seeder heute über die Registry auf; deshalb werden die veröffentlichten Revisionen hier mit den + * unveränderten Seederdaten im Altformat überschrieben. + */ + private function storeSeededPagesInTheLegacyFormat(): void + { + $method = new ReflectionMethod(CmsSeeder::class, 'pages'); + $pages = $method->invoke(new CmsSeeder); + + foreach ($pages as $path => $page) { + $revisionId = Page::query()->where('path', $path)->value('published_revision_id'); + DB::table('page_revisions')->where('id', $revisionId)->update(['blocks' => json_encode($page['blocks'])]); + } + } + + private function fixture(string $name): string + { + return trim(file_get_contents(base_path("tests/Fixtures/legacy-pages/$name.txt"))); + } + + public function test_legacy_revisions_stored_in_the_flat_format_still_render(): void + { + $page = Page::query()->create(['path' => '/alt']); + $revision = $page->revisions()->create([ + 'blocks' => [ + ['type' => 'heading', 'heading' => 'Alte Seite', 'intro' => 'Einleitung'], + ['type' => 'image_text', 'image' => 'cms/alt.jpg', 'alt' => 'Altes Bild', 'body' => "Absatz eins.\n\nAbsatz ."], + ['type' => 'faq', 'items' => [['question' => 'Frage?', 'answer' => 'Antwort.']]], + ['type' => 'cards', 'items' => [['title' => 'Karte', 'text' => 'Text', 'url' => '/praevention']]], + ['type' => 'call_to_action', 'heading' => 'Los', 'text' => null, 'label' => 'Anmelden', 'url' => '/anmelden'], + ], + ]); + app(PageService::class)->publish($page, $revision); + + $this->get('/alt') + ->assertOk() + ->assertSee('Alte Seite', false) + ->assertSee('

    Alte Seite

    ', false) + ->assertSee('alt="Altes Bild"', false) + ->assertSee('

    Absatz eins.

    Absatz <zwei>.

    ', false) + ->assertSee('
    Frage?
    ', false) + ->assertSee('href="/praevention"', false) + ->assertSee('href="/anmelden"', false); + + $this->assertSame('heading', $revision->fresh()->blocks[0]['type']); + $this->assertArrayNotHasKey('v', $revision->fresh()->blocks[0], 'Die gespeicherte Altrevision bleibt unverändert.'); + } + + public function test_restoring_a_legacy_revision_keeps_its_stored_blocks(): void + { + $page = Page::query()->where('path', '/')->firstOrFail(); + $legacy = $page->publishedRevision; + $service = app(PageService::class); + + $service->saveRevision($page, [['type' => 'heading', 'v' => 1, 'data' => ['heading' => 'Neu']]], null, null, null); + $restored = $service->restore($page, $legacy, null); + + $this->assertSame($legacy->blocks, $restored->blocks); + } + + public function test_new_revisions_are_stored_as_widget_envelopes(): void + { + $page = Page::query()->create(['path' => '/neu']); + + $revision = app(PageService::class)->saveRevision($page, [ + ['type' => 'prose', 'body' => 'Altes Eingabeformat'], + ['type' => 'hero', 'v' => 1, 'variant' => 'highlight', 'data' => ['heading' => 'Einstieg']], + ], null, null, null); + + $this->assertSame(['id', 'type', 'v', 'variant', 'settings', 'data', 'refs'], array_keys($revision->blocks[0])); + $this->assertSame('prose', $revision->blocks[0]['type']); + $this->assertSame(['body' => 'Altes Eingabeformat'], $revision->blocks[0]['data']); + // Gespeichert wird immer die aktuelle Version: hero v1 „highlight“ wird zu v2 „editorial_solid“. + $this->assertSame([2, 'editorial_solid'], [$revision->blocks[1]['v'], $revision->blocks[1]['variant']]); + $this->assertNull($page->fresh()->published_revision_id, 'Speichern veröffentlicht nicht.'); + } + + public function test_reference_widgets_render_their_variants(): void + { + $page = Page::query()->create(['path' => '/varianten']); + $revision = app(PageService::class)->saveRevision($page, [ + ['type' => 'hero', 'v' => 1, 'variant' => 'highlight', 'data' => ['heading' => 'Stark im Alltag', 'text' => 'Einstieg', 'cta_label' => 'Mehr', 'cta_url' => '/praevention']], + ['type' => 'image_text', 'v' => 2, 'variant' => 'image_right', 'data' => ['title' => 'Bild rechts', 'body' => '

    Text betont

    ', 'alt' => 'Beschreibung'], 'refs' => ['image' => 'cms/beispiel.jpg']], + ['type' => 'cards', 'v' => 1, 'variant' => 'compact', 'data' => ['items' => [['title' => 'Eins', 'url' => '/a'], ['title' => 'Zwei']]]], + ], null, null, null); + app(PageService::class)->publish($page, $revision); + + $this->get('/varianten') + ->assertOk() + ->assertSee('lf-hero lf-hero--editorial-solid lf-hero--height-normal', false) + ->assertSee('

    Stark im Alltag

    ', false) + ->assertSee('class="lf-hero__button lf-hero__button--primary" href="/praevention"', false) + ->assertSee('lf-bt lf-bt--cream lf-bt--image-right lf-bt--height-normal', false) + ->assertSee('

    Bild rechts

    ', false) + ->assertSee('betont', false) + ->assertSee(route('media.public', ['path' => 'cms/beispiel.jpg']), false) + ->assertSee('cards cards-compact', false); + } + + public function test_media_of_any_widget_are_published_through_the_queue(): void + { + Queue::fake(); + $page = Page::query()->create(['path' => '/medien']); + + app(PageService::class)->saveRevision($page, [ + ['type' => 'hero', 'v' => 1, 'data' => ['heading' => 'A', 'alt' => 'Bild'], 'refs' => ['image' => 'cms/hero.jpg']], + ['type' => 'cards', 'v' => 1, 'data' => ['items' => [['title' => 'K', 'image' => 'cms/karte.jpg']]]], + ], null, null, null); + + Queue::assertPushed(PublishPublicMedia::class, fn ($job) => $job->path === 'cms/hero.jpg'); + Queue::assertPushed(PublishPublicMedia::class, fn ($job) => $job->path === 'cms/karte.jpg'); + } + + public function test_catalog_cards_show_released_programs_from_the_master_data_only(): void + { + $program = $this->composition('Programm Abstand', 'programm', summary: 'Kurzbeschreibung aus den Fachdaten'); + $module = $this->composition('Modul Nein sagen', 'modul'); + $page = Page::query()->create(['path' => '/thema']); + + $revision = app(PageService::class)->saveRevision($page, [[ + 'type' => 'catalog_cards', + 'v' => 1, + 'data' => ['heading' => 'Passende Angebote'], + 'refs' => ['items' => [ + ['type' => 'composition', 'id' => $module->composition_id], + ['type' => 'composition', 'id' => $program->composition_id], + ]], + ]], null, null, null); + app(PageService::class)->publish($page, $revision); + + $this->assertSame( + ['items' => [['type' => 'composition', 'id' => $module->composition_id], ['type' => 'composition', 'id' => $program->composition_id]]], + $revision->blocks[0]['refs'], + ); + $this->assertStringNotContainsString('Programm Abstand', json_encode($revision->blocks), 'Keine Stammdaten im CMS.'); + + $this->get('/thema') + ->assertOk() + ->assertSee('Passende Angebote') + ->assertSee('Programm Abstand') + ->assertSee('Kurzbeschreibung aus den Fachdaten') + ->assertSee(route('public.program', $program->composition_id), false) + ->assertDontSee('Modul Nein sagen') + ->assertDontSee('Redaktionsvorschau'); + + $program->composition->update(['display_title' => 'Programm „Abstand halten“']); + $this->get('/thema')->assertSee('Programm „Abstand halten“'); + } + + public function test_catalog_cards_show_modules_only_in_the_protected_preview(): void + { + $module = $this->composition('Modul Nein sagen', 'modul'); + $page = Page::query()->create(['path' => '/modulseite']); + $revision = app(PageService::class)->saveRevision($page, [ + ['type' => 'heading', 'v' => 1, 'data' => ['heading' => 'Module']], + ['type' => 'catalog_cards', 'v' => 1, 'data' => [], 'refs' => ['items' => [['type' => 'composition', 'id' => $module->composition_id]]]], + ], null, null, null); + app(PageService::class)->publish($page, $revision); + + $this->get('/modulseite')->assertOk()->assertDontSee('Modul Nein sagen')->assertDontSee('catalog-cards'); + + $editor = User::factory()->redakteur()->create(); + $this->actingAs($editor, 'staff') + ->get(route('pages.preview', $revision)) + ->assertOk() + ->assertSee('Modul Nein sagen') + ->assertSee('Nur in der Redaktionsvorschau sichtbar'); + } + + public function test_revoking_the_display_release_removes_the_card_without_editing_the_page(): void + { + $program = $this->composition('Programm Rückzug', 'programm'); + $page = Page::query()->create(['path' => '/rueckzug']); + $revision = app(PageService::class)->saveRevision($page, [ + ['type' => 'heading', 'v' => 1, 'data' => ['heading' => 'Rückzug']], + ['type' => 'catalog_cards', 'v' => 1, 'refs' => ['items' => [['type' => 'composition', 'id' => $program->composition_id]]]], + ], null, null, null); + app(PageService::class)->publish($page, $revision); + $this->get('/rueckzug')->assertSee('Programm Rückzug'); + + $program->displayEvents()->update(['occurred_at' => now()->subMinute()]); + app(CompositionDisplayRelease::class)->revoke($program, User::factory()->create()); + + $this->get('/rueckzug')->assertOk()->assertDontSee('Programm Rückzug'); + } + + public function test_unreleased_or_foreign_objects_cannot_be_referenced(): void + { + $draft = $this->composition('Programm Entwurf', 'programm', released: false); + $page = Page::query()->create(['path' => '/entwurf']); + + $this->expectException(ValidationException::class); + + app(PageService::class)->saveRevision($page, [ + ['type' => 'catalog_cards', 'v' => 1, 'refs' => ['items' => [['type' => 'composition', 'id' => $draft->composition_id]]]], + ], null, null, null); + } + + public function test_public_program_list_uses_the_same_public_rule(): void + { + $this->composition('Programm Öffentlich', 'programm'); + $this->composition('Programm Intern', 'programm', released: false); + $this->composition('Modul Freigegeben', 'modul'); + + $this->get('/programme') + ->assertOk() + ->assertSee('Programm Öffentlich') + ->assertDontSee('Programm Intern') + ->assertDontSee('Modul Freigegeben'); + } + + private function mainText(string $html): string + { + preg_match('#]*>(.*)#s', $html, $match); + $text = html_entity_decode(strip_tags(str_replace('<', ' <', $match[1] ?? '')), ENT_QUOTES | ENT_HTML5, 'UTF-8'); + + return trim(preg_replace('/\s+/u', ' ', $text)); + } +} diff --git a/tests/Feature/CompositionStructureAndDisplayTest.php b/tests/Feature/CompositionStructureAndDisplayTest.php new file mode 100644 index 0000000..2827ea5 --- /dev/null +++ b/tests/Feature/CompositionStructureAndDisplayTest.php @@ -0,0 +1,93 @@ +publishElementVersion($content->createElement('film', 'film', 'Film A'), null, ['file' => 'inhalte/a.mp4']); + $programm = EditorialContentKind::query()->where('slug', 'programm')->firstOrFail(); + $composition = $content->publishComposition( + tap($content->createComposition('Programm A'), function ($item) use ($programm): void { + $item->editorial_content_kind_id = $programm->id; + $item->save(); + }), + [['role' => 'Film', 'target' => $film]], + ); + $compositionModel = $composition->composition; + + $composition->load('composition.editorialContentKind'); + $tree = app(CompositionStructureReader::class)->tree($composition); + + $this->assertSame('Programm', $composition->composition->editorialContentKind?->label); + $this->assertCount(1, $tree); + $this->assertSame('Film A', $tree[0]->title); + $this->assertFalse(app(CompositionDisplayRelease::class)->isReleased($composition)); + } + + public function test_display_release_and_revoke_are_version_bound_and_auditable(): void + { + $content = app(ContentService::class); + $composition = $content->publishComposition( + $content->createComposition('Modul A'), + [['role' => 'Text', 'target' => $content->publishElementVersion($content->createElement('text', 'text', 'Text'), 'Inhalt')]], + ); + $actor = User::factory()->create(); + $releases = app(CompositionDisplayRelease::class); + + $releases->release($composition, $actor, 'Erstfreigabe'); + $this->assertTrue($releases->isReleased($composition)); + $composition->displayEvents()->update(['occurred_at' => now()->subMinute()]); + + $releases->revoke($composition, $actor, 'Korrektur'); + $this->assertFalse($releases->isReleased($composition->fresh())); + + $this->assertCount(2, $composition->fresh()->displayEvents); + $this->assertSame($actor->id, $composition->displayEvents()->orderByDesc('id')->first()->actor_id); + } + + public function test_revoke_without_release_fails(): void + { + $content = app(ContentService::class); + $composition = $content->publishComposition( + $content->createComposition('Leer'), + [['role' => 'Text', 'target' => $content->publishElementVersion($content->createElement('text', 'text', 'Text'), 'Inhalt')]], + ); + + $this->expectException(DomainRuleException::class); + app(CompositionDisplayRelease::class)->revoke($composition, User::factory()->create()); + } + + public function test_highest_released_version_picks_latest_number(): void + { + $content = app(ContentService::class); + $element = $content->createComposition('Prog'); + $v1 = $content->publishComposition($element, [ + ['role' => 'Text', 'target' => $content->publishElementVersion($content->createElement('text', 'text', 'Eins'), '1')], + ]); + $actor = User::factory()->create(); + app(CompositionDisplayRelease::class)->release($v1, $actor); + + $v2 = $content->publishComposition($element, [ + ['role' => 'Text', 'target' => $content->publishElementVersion($content->createElement('text', 'text', 'Zwei'), '2')], + ]); + app(CompositionDisplayRelease::class)->release($v2, $actor); + + $highest = app(CompositionDisplayRelease::class)->highestReleasedVersion($element); + + $this->assertSame(2, $highest?->number); + } +} diff --git a/tests/Feature/CoursePlayerTest.php b/tests/Feature/CoursePlayerTest.php new file mode 100644 index 0000000..0ef2e85 --- /dev/null +++ b/tests/Feature/CoursePlayerTest.php @@ -0,0 +1,97 @@ +publishElementVersion( + $content->createElement('film', 'film', 'Übungsfilm'), + 'Erst ansehen, dann entscheiden.', + ['decision_seconds' => 12, 'file' => 'inhalte/film.mp4'], + ); + $course = $content->publishComposition( + $content->createComposition('Alltag üben'), + [['role' => 'Film', 'target' => $film]], + ); + $article = $articles->create('kurs-alltag', 'Erprobung'); + $articles->publishRelease($article, $course, 'Der Kurs für den Alltag.'); + $rights = $offers->createRightsProfile('Kurs sehen', 'ehrenamtlich', [ + 'film' => ['streamen', 'ansehen'], + ]); + $offer = $offers->create('Kursangebot'); + $offers->activate($offer, [ + ['target' => $article->fresh(), 'rights' => $rights], + ], ['grant_kind' => 'auf_abruf']); + $member = User::factory()->create(); + app(GrantIssuer::class)->claim($member, $offer); + + $this->actingAs($member) + ->get(route('member.library')) + ->assertOk() + ->assertSee('Bibliothek') + ->assertSee('Alltag üben'); + + $this->actingAs($member) + ->get(route('member.article', $article)) + ->assertOk() + ->assertSee('Alltag üben') + ->assertSee('Erst ansehen, dann entscheiden.') + ->assertDontSee('Zur Entscheidungsmarke') + ->assertSee($article->code); + } + + public function test_an_uploaded_file_name_with_spaces_becomes_ready(): void + { + Storage::fake('cms_incoming'); + Storage::fake('media_derived'); + Storage::disk('cms_incoming')->put('inhalte/Mein Film.mp4', 'film'); + $content = app(ContentService::class); + $version = $content->publishElementVersion( + $content->createElement('film', 'film', 'Film'), + null, + ['incoming' => 'inhalte/Mein Film.mp4'], + ); + + $version->refresh(); + + $this->assertSame(ContentVersionStatus::Bereit, $version->status); + $this->assertSame('inhalte/'.$version->id.'/Mein-Film.mp4', $version->metadata['file']); + Storage::disk('media_derived')->assertExists('inhalte/'.$version->id.'/Mein-Film.mp4'); + } + + public function test_an_editor_can_read_an_element_and_a_member_cannot(): void + { + $version = app(ContentService::class)->publishElementVersion( + app(ContentService::class)->createElement('text', 'text', 'Hinweis'), + 'Sichtbar für die Redaktion.', + ); + + $this->actingAs(User::factory()->redakteur()->create(), 'staff') + ->get(route('content.preview', $version)) + ->assertOk() + ->assertSee('Sichtbar für die Redaktion.'); + + auth('staff')->logout(); + + $this->actingAs(User::factory()->create(), 'web') + ->get(route('content.preview', $version)) + ->assertRedirect(); + } +} diff --git a/tests/Feature/EditorialContentKindTest.php b/tests/Feature/EditorialContentKindTest.php new file mode 100644 index 0000000..aa741a0 --- /dev/null +++ b/tests/Feature/EditorialContentKindTest.php @@ -0,0 +1,94 @@ +compositionArticle(CompositionKind::Kurs, designation: 'Demo-Kurs'); + + $this->assertSame('Kurs', app(CourseOutline::class)->kindLabel($article)); + $this->assertSame(CompositionKind::Kurs, $article->currentRelease->rootCompositionVersion->composition->kind); + } + + public function test_setting_editorial_kind_changes_display_without_touching_technical_kind(): void + { + $programm = EditorialContentKind::query()->where('slug', 'programm')->firstOrFail(); + $article = $this->compositionArticle(CompositionKind::Kurs, designation: 'Programm-Demo'); + $composition = $article->currentRelease->rootCompositionVersion->composition; + $versionNumber = $article->currentRelease->rootCompositionVersion->number; + + $composition->editorial_content_kind_id = $programm->id; + $composition->save(); + + $composition->refresh(); + $article->refresh(); + + $this->assertSame('Programm', app(CourseOutline::class)->kindLabel($article)); + $this->assertSame(CompositionKind::Kurs, $composition->kind); + $this->assertSame($versionNumber, $article->currentRelease->rootCompositionVersion->number); + } + + public function test_an_element_can_show_merkblatt_without_changing_output_class(): void + { + $merkblatt = EditorialContentKind::query()->where('slug', 'merkblatt')->firstOrFail(); + $content = app(ContentService::class); + $articles = app(ArticleService::class); + $version = $content->publishElementVersion($content->createElement('text', 'document', 'PDF Demo'), null, ['file' => 'inhalte/demo.pdf']); + $element = $version->element; + $element->editorial_content_kind_id = $merkblatt->id; + $element->save(); + $article = $articles->create('pdf-demo'); + $articles->publishRelease($article, $version, 'Eigenständiges PDF.'); + + $this->assertSame('document', $element->fresh()->output_class); + $this->assertSame('Merkblatt', app(CourseOutline::class)->kindLabel($article->fresh())); + } + + public function test_a_new_kind_can_be_added_without_code_changes(): void + { + EditorialContentKind::query()->create([ + 'slug' => 'trainingsmodul', + 'label' => 'Trainingsmodul', + 'sort_order' => 50, + ]); + + $this->assertArrayHasKey( + EditorialContentKind::query()->where('slug', 'trainingsmodul')->value('id'), + EditorialContentKind::selectOptions(), + ); + } + + private function compositionArticle(CompositionKind $kind, string $designation) + { + $content = app(ContentService::class); + $leaf = $content->publishElementVersion($content->createElement('text', 'text', 'Blatt'), 'Inhalt'); + $composition = $content->publishComposition( + tap($content->createComposition($designation), fn ($c) => $c->update(['kind' => $kind])), + [['role' => 'Material', 'target' => $leaf]], + ); + $article = app(ArticleService::class)->create('art-'.$kind->value); + app(ArticleService::class)->publishRelease($article, $composition, 'Test.'); + $rights = app(OfferService::class)->createRightsProfile('Lesen', 'ehrenamtlich', ['text' => ['ansehen']]); + $offer = app(OfferService::class)->create('Gratis'); + app(OfferService::class)->activate($offer, [['target' => $article->fresh(), 'rights' => $rights]], ['grant_kind' => 'auf_abruf']); + $user = User::factory()->create(); + app(GrantIssuer::class)->claim($user, $offer); + + return $article->fresh(); + } +} diff --git a/tests/Feature/EditorialDeskTest.php b/tests/Feature/EditorialDeskTest.php new file mode 100644 index 0000000..553b22e --- /dev/null +++ b/tests/Feature/EditorialDeskTest.php @@ -0,0 +1,635 @@ +createElement('film', 'film', 'Lara im Park'); + $version = $content->publishElementVersion($film, 'Filmfassung'); + $cover = $this->image('Titel Park'); + $trailer = $this->trailer('Trailer Park'); + $editor = $this->editor(); + $this->actingAs($editor, 'staff'); + + Livewire::test(ViewContentElement::class, ['record' => $film->getKey()]) + ->set('bereich', 'beschreibung') + ->set('displayTitle', 'Lara im Park') + ->set('teaser', 'Ein Nachmittag im Park.') + ->set('summary', 'Lara übt, ihre Grenze zu sagen.') + ->set('descriptionText', 'Ausführlich: die Szene im Park und was sie zeigt.') + ->set('searchTerms', 'park, grenze') + ->set('kindId', $this->kind('unterrichtsfilm')) + ->call('saveEditorial') + ->assertSee('Es gibt keine neue Fassung.'); + + $film->refresh(); + $this->assertSame(1, $film->versions()->count()); + $this->assertSame($version->id, $film->versions()->first()->id); + $this->assertSame('Ein Nachmittag im Park.', $film->teaser); + $this->assertSame($this->kind('unterrichtsfilm'), $film->editorial_content_kind_id); + + $purpose = $this->dimensionValue('verwendungszweck', 'training'); + $audience = $this->dimensionValue('zielgruppe', 'kinder'); + app(IdentityDimension::class)->assign($film, $purpose); + app(IdentityDimension::class)->assign($film, $audience); + + Livewire::test(ViewContentElement::class, ['record' => $film->getKey()]) + ->call('openRedaktion', 'medien') + ->call('openPresentationPicker', 'titelbild') + ->call('assignFromPicker', 'element:'.$cover->versions()->first()->id) + ->call('openPresentationPicker', 'trailer') + ->set('bindToVersion', true) + ->call('assignFromPicker', 'element:'.$trailer->versions()->first()->id) + ->assertSee('Titel Park') + ->assertSee('Trailer Park') + ->assertSee('Neu zugeordnet') + ->assertSee('Änderungen nicht gespeichert') + ->call('saveRedaktion') + ->assertSee('Alle Änderungen gespeichert') + ->call('releaseAssigned', $trailer->id) + ->assertSee('Für die Website freigegeben'); + + $film->refresh(); + $trailer->refresh(); + $this->assertSame(1, $film->versions()->count()); + $this->assertSame($version->id, $film->versions()->value('id')); + $this->assertNotNull($trailer->website_released_at); + $this->assertNotNull(app(WebsiteMedia::class)->present($trailer)); + + Livewire::test(ViewContentElement::class, ['record' => $film->getKey()]) + ->call('withdrawAssigned', $trailer->id); + + $this->assertNull($trailer->fresh()->website_released_at); + $this->assertNull(app(WebsiteMedia::class)->present($trailer)); + $this->assertSame(2, PresentationAssignment::query()->where('subject_id', $film->id)->count()); + } + + public function test_a_module_description_does_not_version_the_composition_or_create_a_text_medium(): void + { + $content = app(ContentService::class); + $film = $content->publishElementVersion($content->createElement('film', 'film', 'Lara im Park'), 'Film'); + $module = $content->createComposition('Eigene Grenzen erkennen'); + $module->editorial_content_kind_id = $this->kind('modul'); + $module->save(); + $version = $content->publishComposition( + $module, + [['role' => 'Film', 'target' => $film]], + didactic: ['learning_goal' => 'Eine Grenze erkennen und sagen.'], + ); + $textsBefore = ContentElement::query()->where('output_class', 'text')->count(); + $this->actingAs($this->editor(), 'staff'); + + Livewire::test(EditExercise::class, ['record' => $module->getKey()]) + ->set('teaser', 'Kurz in das Modul.') + ->set('summary', 'Kinder benennen eine eigene Grenze.') + ->set('description', 'Ausführliche Modulbeschreibung, kein Lehrtext.') + ->set('dimensionIds', [$this->dimensionValue('zielgruppe', 'kinder')->id]) + ->call('saveDisplay') + ->assertSee('Die Fassung bleibt unverändert.'); + + $module->refresh(); + $version->refresh(); + $this->assertSame(1, $module->versions()->count()); + $this->assertSame('Eine Grenze erkennen und sagen.', $version->learning_goal); + $this->assertSame('Kurz in das Modul.', $module->teaser); + $this->assertTrue( + CompositionMember::query()->where('composition_version_id', $version->id)->where('content_element_version_id', $film->id)->exists() + ); + $this->assertSame($textsBefore, ContentElement::query()->where('output_class', 'text')->count()); + + $cover = $this->pictureWithoutVersion('Modulbild ohne Fassung'); + Livewire::test(EditExercise::class, ['record' => $module->getKey()]) + ->assertSet('teaser', 'Kurz in das Modul.') + ->set('teaser', 'Geändertes Modul.') + ->call('saveDisplay') + ->assertSee('Die Fassung bleibt unverändert.') + ->call('openPresentationPicker') + ->set('pickerQuery', 'Modulbild ohne') + ->assertSee('Modulbild ohne Fassung') + ->call('assignFromPicker', 'medium:'.$cover->id) + ->call('saveRedaktion'); + + $module->refresh(); + $version->refresh(); + $this->assertSame('Geändertes Modul.', $module->teaser); + $this->assertSame('Eine Grenze erkennen und sagen.', $version->learning_goal); + $this->assertSame(0, $cover->fresh()->versions()->count()); + $this->assertSame(1, $module->versions()->count()); + $this->assertNull(PresentationAssignment::query()->where('content_element_id', $cover->id)->value('source_version_id')); + $this->assertSame( + 1, + CompositionMember::query()->where('composition_version_id', $version->id)->count() + ); + } + + public function test_a_program_keeps_its_own_cover_trailer_and_gallery_order(): void + { + $content = app(ContentService::class); + $program = $content->createComposition('Stark im Alltag', CompositionKind::Kurs); + $program->editorial_content_kind_id = $this->kind('programm'); + $program->save(); + $content->publishComposition($program, [[ + 'role' => 'Text', + 'target' => $content->publishElementVersion($content->createElement('text', 'text', 'Blatt'), 'Inhalt'), + ]]); + $cover = $this->image('Programmcover'); + $trailer = $this->trailer('Programmtrailer'); + $first = $this->image('Galerie eins'); + $second = $this->image('Galerie zwei'); + $third = $this->image('Galerie drei'); + $media = app(PresentationMedia::class); + $actor = $this->editor(); + + $media->assign($program, 'titelbild', $cover->id, null, $actor); + $media->assign($program, 'trailer', $trailer->id, $trailer->versions()->first()->id, $actor); + $media->assign($program, 'galerie', $first->id, null, $actor); + $media->assign($program, 'galerie', $second->id, null, $actor); + $media->assign($program, 'galerie', $third->id, null, $actor); + + $gallery = PresentationAssignment::query() + ->where('subject_id', $program->id) + ->whereHas('role', fn ($query) => $query->where('slug', 'galerie')) + ->orderBy('position') + ->pluck('content_element_id') + ->all(); + $this->assertSame([$first->id, $second->id, $third->id], $gallery); + + $firstAssignment = PresentationAssignment::query()->where('content_element_id', $first->id)->where('subject_id', $program->id)->first(); + $media->move($program, $firstAssignment->id, 1, $actor); + + $gallery = PresentationAssignment::query() + ->where('subject_id', $program->id) + ->whereHas('role', fn ($query) => $query->where('slug', 'galerie')) + ->orderBy('position') + ->pluck('content_element_id') + ->all(); + $this->assertSame([$second->id, $first->id, $third->id], $gallery); + $this->assertSame(1, $program->fresh()->versions()->count()); + + app(IdentityDimension::class)->assign($program, $this->dimensionValue('zielgruppe', 'eltern')); + $found = app(MediaLibrary::class)->cards([ + 'suche' => '', + 'inhaltsart' => '', + ], false); + $this->assertNotContains('Stark im Alltag', array_column($found, 'title')); + + $this->actingAs($actor, 'staff'); + Livewire::test(EditCourse::class, ['record' => $program->getKey()]) + ->call('openRedaktion', 'medien') + ->assertSee('Programmcover') + ->assertSee('Galerie zwei') + ->assertSee('Titelbild'); + } + + public function test_a_license_article_overrides_only_its_own_presentation(): void + { + $content = app(ContentService::class); + $film = $content->createElement('film', 'film', 'Lara im Park'); + $film->display_title = 'Lara im Park'; + $film->teaser = 'Teaser der Fassung'; + $film->summary = 'Kurz aus dem Film'; + $film->description = 'Lang aus dem Film'; + $film->save(); + $version = $content->publishElementVersion($film, 'Film'); + $articles = app(ArticleService::class); + $article = $articles->create('LARA-PARK', 'Alltag'); + $release = $articles->publishRelease($article, $version, 'Derselbe Unterrichtsfilm'); + $offers = Offer::query()->count(); + $note = $release->classification_note; + $number = $release->number; + $keeper = User::factory()->katalogverwalter()->create(); + $keeper->saveAppAuthenticationSecret('JBSWY3DPEHPK3PXP'); + $this->actingAs($keeper, 'staff'); + + $profile = app(EditorialProfileReader::class)->read($article->fresh(), 'artikel'); + $this->assertSame('quelle', $profile->origin('summary')); + $this->assertSame('Kurz aus dem Film', $profile->value('summary')); + $this->assertSame('Lara im Park', $profile->value('display_title')); + + Livewire::test(ViewLicenseArticle::class, ['record' => $article->getKey()]) + ->call('openRedaktion') + ->assertSee('Übernommen aus Lara im Park') + ->set('summary', 'Eigene Artikelbeschreibung') + ->call('saveLicenseEditorial') + ->assertSee('Stand, Preis und Rechte bleiben unverändert.') + ->assertSee('Übernommen aus Lara im Park') + ->assertSee('Eigene Angabe'); + + $article->refresh(); + $release->refresh(); + $this->assertSame('Eigene Artikelbeschreibung', $article->summary); + $this->assertNull($article->teaser); + $again = app(EditorialProfileReader::class)->read($article, 'artikel'); + $this->assertSame('eigen', $again->origin('summary')); + $this->assertSame('Eigene Artikelbeschreibung', $again->value('summary')); + $this->assertSame('quelle', $again->origin('teaser')); + $this->assertSame('Teaser der Fassung', $again->value('teaser')); + $this->assertSame($number, $release->number); + $this->assertSame($note, $release->classification_note); + $this->assertSame(ReleaseStatus::Veroeffentlicht, $release->status); + $this->assertSame($offers, Offer::query()->count()); + $this->assertSame(1, $film->fresh()->versions()->count()); + + $cover = $this->pictureWithoutVersion('Artikelbild ohne Fassung'); + Livewire::test(ViewLicenseArticle::class, ['record' => $article->getKey()]) + ->assertSet('summary', 'Eigene Artikelbeschreibung') + ->call('openRedaktion') + ->set('descriptionText', 'Nur dieser Artikel') + ->call('openPresentationPicker', 'titelbild') + ->set('pickerQuery', 'Artikelbild ohne') + ->assertSee('Artikelbild ohne Fassung') + ->call('assignFromPicker', 'medium:'.$cover->id) + ->call('saveLicenseEditorial') + ->assertSee('Artikelbild ohne Fassung'); + + $overridden = app(EditorialProfileReader::class)->read($article->fresh(), 'artikel'); + $this->assertSame('eigen', $overridden->origin('description')); + $this->assertSame('Nur dieser Artikel', $overridden->value('description')); + $this->assertSame('quelle', $overridden->origin('teaser')); + $this->assertSame('Teaser der Fassung', $overridden->value('teaser')); + $this->assertSame('Lang aus dem Film', $film->fresh()->description); + $this->assertSame(0, $cover->fresh()->versions()->count()); + + Livewire::test(ViewLicenseArticle::class, ['record' => $article->getKey()]) + ->set('summary', '') + ->call('saveLicenseEditorial'); + $restored = app(EditorialProfileReader::class)->read($article->fresh(), 'artikel'); + $this->assertSame('quelle', $restored->origin('summary')); + $this->assertSame('Kurz aus dem Film', $restored->value('summary')); + $this->assertSame('eigen', $restored->origin('description')); + $this->assertSame($release->id, $article->fresh()->current_release_id); + $this->assertSame(1, ArticleRelease::query()->count()); + $this->assertSame($offers, Offer::query()->count()); + $this->assertSame(ReleaseStatus::Veroeffentlicht, $release->fresh()->status); + + $ambiguous = $articles->create('UNDEUTIG'); + $program = $content->createComposition('Zweite Wurzel', CompositionKind::Kurs); + $programVersion = $content->publishComposition($program, [['role' => 'Film', 'target' => $version]]); + $ambiguous->releases()->create([ + 'number' => 1, + 'classification_note' => 'zwei Wurzeln', + 'status' => ReleaseStatus::Entwurf, + 'root_element_version_id' => $version->id, + 'root_composition_version_id' => $programVersion->id, + ]); + $ambiguous->current_release_id = $ambiguous->releases()->value('id'); + $ambiguous->save(); + $this->assertNull(app(EditorialProfileReader::class)->sourceOf($ambiguous->fresh())); + $this->assertSame('leer', app(EditorialProfileReader::class)->read($ambiguous->fresh())->origin('summary')); + } + + public function test_content_elements_do_not_offer_the_pillar_dimension_a_second_time(): void + { + $pillar = Pillar::query()->create(['name' => 'Nähe', 'slug' => 'naehe', 'sort_order' => 1]); + $dimension = EditorialDimension::query()->where('slug', 'saeule')->firstOrFail(); + $value = EditorialDimensionValue::query()->create([ + 'editorial_dimension_id' => $dimension->id, + 'slug' => 'pfeiler-'.$pillar->id, + 'label' => 'Nähe als Dimension', + ]); + $content = app(ContentService::class); + $film = $content->createElement('film', 'film', 'Film mit Säule'); + $content->publishElementVersion($film, 'Film'); + app(IdentityDimension::class)->assign($film, $value); + $kinder = $this->dimensionValue('zielgruppe', 'kinder'); + $this->actingAs($this->editor(), 'staff'); + + $html = Livewire::test(ViewContentElement::class, ['record' => $film->getKey()]) + ->call('openRedaktion', 'einordnung') + ->set('dimensionIds', [$kinder->id]) + ->call('saveEditorial') + ->html(); + + $this->assertStringContainsString('Fachliche Säulen', $html); + $this->assertStringNotContainsString('>Fachliche Säule<', $html); + $assigned = IdentityDimensionValue::query() + ->where('subject_type', $film->getMorphClass()) + ->where('subject_id', $film->id) + ->pluck('editorial_dimension_value_id') + ->all(); + $this->assertContains($value->id, $assigned); + $this->assertContains($kinder->id, $assigned); + + $module = $content->createComposition('Modul mit Säule'); + $content->publishComposition($module, [[ + 'role' => 'Film', + 'target' => $film->versions()->first(), + ]]); + Livewire::test(EditExercise::class, ['record' => $module->getKey()]) + ->call('openRedaktion', 'einordnung') + ->assertSee('Nähe als Dimension') + ->assertDontSee('Fachliche Säulen'); + } + + public function test_classification_is_filterable_and_does_not_change_use_or_release(): void + { + $content = app(ContentService::class); + $lesson = $content->createElement('film', 'film', 'Unterricht'); + $lesson->editorial_content_kind_id = $this->kind('unterrichtsfilm'); + $lesson->teaser = 'sucht-den-unterricht'; + $lesson->save(); + $content->publishElementVersion($lesson, 'Film'); + $clip = $content->createElement('film', 'film', 'Nur Trailer'); + $clip->editorial_content_kind_id = $this->kind('trailer'); + $clip->save(); + $content->publishElementVersion($clip, 'Clip'); + $picture = $content->createElement('bild', 'bild', 'Keyvisual'); + $picture->editorial_content_kind_id = $this->kind('titelbild'); + $picture->thumbnail_path = 'vorschau/key.jpg'; + $picture->save(); + $content->publishElementVersion($picture, null, ['file' => 'inhalte/key.jpg']); + $backdrop = $content->createElement('bild', 'bild', 'Hintergrund'); + $backdrop->editorial_content_kind_id = $this->kind('hintergrundbild'); + $backdrop->save(); + $content->publishElementVersion($backdrop, null, ['file' => 'inhalte/hintergrund.jpg']); + + app(IdentityDimension::class)->assign($lesson, $this->dimensionValue('verwendungszweck', 'training')); + app(IdentityDimension::class)->assign($lesson, $this->dimensionValue('verwendungszweck', 'website')); + app(IdentityDimension::class)->assign($clip, $this->dimensionValue('verwendungszweck', 'website')); + $releasedAt = null; + $lesson->website_released_at = null; + $lesson->save(); + + $library = app(MediaLibrary::class); + $lessons = array_column($library->cards(['inhaltsart' => (string) $this->kind('unterrichtsfilm')], false), 'title'); + $clips = array_column($library->cards(['inhaltsart' => (string) $this->kind('trailer')], false), 'title'); + $pictures = array_column($library->cards(['art' => 'bild', 'inhaltsart' => (string) $this->kind('titelbild')], false), 'title'); + $backs = array_column($library->cards(['inhaltsart' => (string) $this->kind('hintergrundbild')], false), 'title'); + + $this->assertSame(['Unterricht'], $lessons); + $this->assertSame(['Nur Trailer'], $clips); + $this->assertSame(['Keyvisual'], $pictures); + $this->assertSame(['Hintergrund'], $backs); + $this->assertNotContains('Nur Trailer', $lessons); + + $byPurpose = array_column($library->cards([ + 'einordnung' => (string) $this->dimensionValue('verwendungszweck', 'training')->id, + 'nutzung' => 'unbenutzt', + ], false), 'title'); + $this->assertContains('Unterricht', $byPurpose); + $this->assertNotContains('Nur Trailer', $byPurpose); + + $bySearch = array_column($library->cards(['suche' => 'sucht-den-unterricht'], false), 'title'); + $this->assertSame(['Unterricht'], $bySearch); + + $lesson->editorial_content_kind_id = $this->kind('interview'); + $lesson->save(); + $lesson->refresh(); + $this->assertSame($releasedAt, $lesson->website_released_at); + $this->assertSame(0, CompositionMember::query()->where('content_element_version_id', $lesson->versions()->first()->id)->count()); + $this->assertSame(2, IdentityDimensionValue::query()->where('subject_type', $lesson->getMorphClass())->where('subject_id', $lesson->id)->count()); + } + + public function test_the_program_card_uses_central_text_and_only_a_released_cover(): void + { + $content = app(ContentService::class); + $program = $content->createComposition('Programm Karte', CompositionKind::Kurs); + $program->editorial_content_kind_id = $this->kind('programm'); + $program->display_title = 'Zentraler Programmname'; + $program->teaser = 'Zentraler Teaser'; + $program->summary = 'Zentrale Kurzbeschreibung'; + $program->description = 'Interne Langfassung'; + $program->save(); + $version = $content->publishComposition($program, [[ + 'role' => 'Text', + 'target' => $content->publishElementVersion($content->createElement('text', 'text', 'Blatt'), 'Inhalt'), + ]]); + app(CompositionDisplayRelease::class)->release($version, User::factory()->create()); + + $cover = $this->image('Öffentliches Cover'); + Storage::disk('media_derived')->put('vorschau/oeffentlich.jpg', 'cover-bytes'); + $cover->thumbnail_path = 'vorschau/oeffentlich.jpg'; + $cover->website_alt = 'Lara auf der Wiese'; + $cover->save(); + app(WebsiteRelease::class)->release($cover); + app(PresentationMedia::class)->assign($program, 'titelbild', $cover->id, null); + + $guide = $content->createElement('text', 'text', 'Geheime Traineranleitung'); + $guide->editorial_content_kind_id = $this->kind('traineranleitung'); + $guide->description = 'Nur für Trainer, nicht öffentlich.'; + $guide->save(); + $content->publishElementVersion($guide, 'Interner Lehrtext'); + + $this->publish('/redaktion-karte', [[ + 'layout' => 'u2_2', + 'style' => [], + 'slots' => [ + $this->card('program_card', ['composition' => $program->id]), + $this->card('program_card', ['composition' => $program->id], ['heading' => 'Nur diese Karte']), + ], + ]]); + + $html = $this->get('/redaktion-karte')->assertOk()->getContent(); + $this->assertStringContainsString('Zentraler Programmname', $html); + $this->assertStringContainsString('Zentraler Teaser', $html); + $this->assertStringContainsString('Nur diese Karte', $html); + $this->assertStringNotContainsString('Interne Langfassung', $html); + $this->assertStringNotContainsString('Nur für Trainer', $html); + $this->assertStringContainsString('/website-medien/'.$cover->id, $html); + $this->assertStringNotContainsString('editorial.card', $html); + $this->assertStringNotContainsString('originals/', $html); + + $program->teaser = 'Teaser nach der Änderung'; + $program->save(); + $this->get('/redaktion-karte')->assertOk() + ->assertSee('Teaser nach der Änderung') + ->assertSee('Nur diese Karte') + ->assertSee('Zentraler Programmname'); + + app(WebsiteRelease::class)->withdraw($cover->fresh()); + $this->assertNull($cover->fresh()->website_released_at); + // WebsiteImage ist je Prozess gebunden. Ein neuer HTTP-Request im selben Testprozess + // bekommt sonst noch die vorherige Freigabe. Auf dem Server endet der Scope mit der Anfrage. + $this->app->forgetInstance(WebsiteImage::class); + $after = $this->get('/redaktion-karte')->assertOk()->getContent(); + $this->assertStringNotContainsString('/website-medien/'.$cover->id, $after); + $this->assertStringContainsString('Teaser nach der Änderung', $after); + $this->assertStringContainsString('Nur diese Karte', $after); + $this->assertStringNotContainsString('cover-bytes', $after); + $this->assertSame('Zentraler Programmname', $program->fresh()->display_title); + } + + public function test_a_bound_clip_stays_on_its_version_and_a_medium_cannot_present_itself(): void + { + $content = app(ContentService::class); + $film = $content->createElement('film', 'film', 'Lara im Park'); + $first = $content->publishElementVersion($film, 'Fassung 1'); + $trailer = $this->trailer('Ausschnitt'); + $media = app(PresentationMedia::class); + $media->assign($film, 'vorschauclip', $trailer->id, $first->id); + + $second = $content->publishElementVersion($film, 'Fassung 2'); + $rows = $media->rows($film->fresh()); + $this->assertTrue($rows[0]['binding']['stale']); + $this->assertSame($first->id, PresentationAssignment::query()->value('source_version_id')); + $this->assertNotSame($second->id, PresentationAssignment::query()->value('source_version_id')); + + $this->expectException(DomainRuleException::class); + $media->assign($film, 'titelbild', $film->id, null); + } + + public function test_a_kachel_variant_does_not_replace_the_central_teaser(): void + { + $program = app(ContentService::class)->createComposition('Variante', CompositionKind::Kurs); + $program->editorial_content_kind_id = $this->kind('programm'); + $program->teaser = 'Zentral'; + $program->save(); + app(ContentService::class)->publishComposition($program, [[ + 'role' => 'Text', + 'target' => app(ContentService::class)->publishElementVersion(app(ContentService::class)->createElement('text', 'text', 'Blatt'), 'Inhalt'), + ]]); + + app(EditorialProfileReader::class)->putVariant($program, 'teaser', 'kachel', 'Nur die Kachel', $this->editor()); + $profile = app(EditorialProfileReader::class)->read($program->fresh(), 'kachel'); + $plain = app(EditorialProfileReader::class)->read($program->fresh()); + + $this->assertSame('Nur die Kachel', $profile->value('teaser')); + $this->assertSame('variante', $profile->origin('teaser')); + $this->assertSame('Zentral', $plain->value('teaser')); + $this->assertSame('Zentral', $program->fresh()->teaser); + } + + private function pictureWithoutVersion(string $title): ContentElement + { + Storage::fake('cms_incoming'); + $path = 'inhalte/'.md5($title).'.jpg'; + Storage::disk('cms_incoming')->put($path, 'bild'); + $element = app(ContentService::class)->createElement('bild', 'bild', $title); + $element->display_title = $title; + $element->save(); + app(PresentationFile::class)->store($element, $path); + + return $element->fresh(); + } + + private function image(string $title): ContentElement + { + $content = app(ContentService::class); + $element = $content->createElement('bild', 'bild', $title); + $element->thumbnail_path = 'vorschau/'.md5($title).'.jpg'; + $element->save(); + Storage::disk('media_derived')->put($element->thumbnail_path, 'bild'); + $content->publishElementVersion($element, null, ['file' => 'inhalte/'.md5($title).'.jpg']); + + return $element->fresh(); + } + + private function trailer(string $title): ContentElement + { + $content = app(ContentService::class); + $element = $content->createElement('film', 'film', $title); + $version = $content->publishElementVersion($element, 'Teaser'); + $path = 'teaser/'.md5($title).'.mp4'; + MediaRendition::query()->create([ + 'content_element_version_id' => $version->id, + 'role' => 'preview', + 'label' => 'teaser', + 'path' => $path, + ]); + Storage::disk('media_derived')->put($path, 'teaser-bytes'); + + return $element->fresh(); + } + + private function kind(string $slug): int + { + return (int) EditorialContentKind::query()->where('slug', $slug)->value('id'); + } + + private function dimensionValue(string $dimension, string $slug): EditorialDimensionValue + { + $id = EditorialDimension::query()->where('slug', $dimension)->value('id'); + + return EditorialDimensionValue::query() + ->where('editorial_dimension_id', $id) + ->where('slug', $slug) + ->firstOrFail(); + } + + private function editor(): User + { + $editor = User::factory()->redakteur()->create(); + $editor->saveAppAuthenticationSecret('JBSWY3DPEHPK3PXP'); + + return $editor; + } + + /** + * @param list> $sections + */ + private function publish(string $path, array $sections): PageRevision + { + $page = Page::query()->create(['path' => $path]); + $service = app(PageService::class); + $revision = $service->saveRevision($page, $sections, null, null, null); + $service->publish($page, $revision); + + return $revision; + } + + /** + * @param array $refs + * @param array $data + * @return array + */ + private function card(string $type, array $refs, array $data = []): array + { + return ['type' => $type, 'v' => 1, 'variant' => 'adaptive', 'settings' => [], 'data' => $data, 'refs' => $refs]; + } +} diff --git a/tests/Feature/EditorialEditorTest.php b/tests/Feature/EditorialEditorTest.php new file mode 100644 index 0000000..93722a1 --- /dev/null +++ b/tests/Feature/EditorialEditorTest.php @@ -0,0 +1,859 @@ +publishElementVersion($content->createElement('text', 'text', 'Blatt'), 'Hinweis'); + $module = $content->publishComposition( + $content->createComposition('Modul Abstand', CompositionKind::Uebung), + [['role' => 'Unterlage', 'target' => $sheet]], + ); + $content->publishComposition( + $content->createComposition('Programm Abstand', CompositionKind::Kurs), + [['role' => 'Modul', 'target' => $module]], + ); + $editor = $this->editor(); + + Livewire::actingAs($editor, 'staff') + ->test(EditorialDesk::class) + ->assertSee('Programm Abstand') + ->assertSee('Modul Abstand') + ->set('query', 'Programm') + ->assertSee('Programm Abstand') + ->assertDontSee('Modul Abstand') + ->set('query', 'kein-treffer') + ->assertSee('Nichts gefunden'); + } + + public function test_display_data_does_not_create_a_version_and_a_module_works_without_a_film(): void + { + $editor = $this->editor(); + $module = app(ContentService::class)->createComposition('Ohne Film', CompositionKind::Uebung); + + Livewire::actingAs($editor, 'staff') + ->test(EditExercise::class, ['record' => $module->id]) + ->assertSee('Ein Film ist nicht nötig') + ->set('displayTitle', 'Sichtbar ohne Film') + ->set('summary', 'Nur eine Beschreibung') + ->call('saveDisplay') + ->assertSet('feedback', 'Die Anzeige ist gespeichert. Die Fassung bleibt unverändert.') + ->set('learningGoal', 'Den Abstand erklären') + ->call('publishRevision') + ->assertSet('feedback', 'Eine Fassung braucht mindestens einen Bestandteil. Anzeige und Kurzbeschreibung kannst du schon speichern.') + ->set('newTextTitle', 'Hinweis ohne Film') + ->set('newTextBody', 'Zuerst den Abstand ansprechen.') + ->call('addText') + ->set('releaseConsent', true) + ->call('publishRevision'); + + $module->refresh(); + + $this->assertSame('Sichtbar ohne Film', $module->display_title); + $this->assertSame(1, $module->versions()->count()); + $this->assertSame('Den Abstand erklären', $module->versions()->first()->learning_goal); + $this->assertSame(1, $module->versions()->first()->members()->count()); + } + + public function test_reordering_reuses_a_medium_and_keeps_the_released_version(): void + { + $content = app(ContentService::class); + $sheet = $content->publishElementVersion( + $content->createElement('text', 'text', 'Trainerunterlage Abstand'), + 'Im Kurs zuerst den Abstand ansprechen.', + ); + $film = $content->publishElementVersion( + $content->createElement('film', 'film', 'Lara im Park'), + 'Film', + ); + $firstModule = $content->publishComposition( + $content->createComposition('Modul Abstand', CompositionKind::Uebung), + [ + ['role' => 'Unterlage', 'target' => $sheet], + ['role' => 'Film', 'target' => $film], + ], + null, + null, + ['learning_goal' => 'Abstand halten', 'duration_minutes' => 15], + ); + $secondModule = $content->publishComposition( + $content->createComposition('Modul Hilfe', CompositionKind::Uebung), + [['role' => 'Unterlage', 'target' => $sheet]], + ); + $programVersion = $content->publishComposition( + $content->createComposition('Programm Abstand', CompositionKind::Kurs), + [ + ['role' => 'Modul', 'target' => $firstModule], + ['role' => 'Modul', 'target' => $secondModule], + ], + ); + $editor = $this->editor(); + app(CompositionDisplayRelease::class)->release($programVersion, $editor); + app(CompositionDisplayRelease::class)->release($firstModule, $editor); + + $component = Livewire::actingAs($editor, 'staff') + ->test(EditCourse::class, ['record' => $programVersion->composition_id]) + ->assertSee('Modul Abstand') + ->assertSee('Modul Hilfe'); + $members = $component->get('members'); + $component->set('members', array_reverse($members)) + ->call('publishRevision') + ->assertSet('feedback', 'Fassung 2 ist freigegeben. Der Entwurf ist geschlossen und die bisherige Fassung bleibt erhalten. Die Mitgliederbibliothek ändert sich dadurch nicht.'); + + $versions = $programVersion->composition->versions()->with('members')->orderBy('number')->get(); + + $this->assertCount(2, $versions); + $this->assertSame($firstModule->id, $versions[0]->members[0]->nested_composition_version_id); + $this->assertSame($secondModule->id, $versions[1]->members[0]->nested_composition_version_id); + $this->assertTrue(app(CompositionDisplayRelease::class)->isReleased($versions[0])); + $this->assertFalse(app(CompositionDisplayRelease::class)->isReleased($versions[1])); + $this->assertSame($sheet->id, $firstModule->members()->first()->content_element_version_id); + $this->assertSame('Im Kurs zuerst den Abstand ansprechen.', $sheet->fresh()->body); + + Livewire::actingAs($editor, 'staff') + ->test(EditCourse::class, ['record' => $programVersion->composition_id]) + ->call('releaseDisplay'); + + $this->assertTrue(app(CompositionDisplayRelease::class)->isReleased($versions[0]->fresh())); + $this->assertTrue(app(CompositionDisplayRelease::class)->isReleased($versions[1]->fresh())); + $this->assertSame(1, $film->element->versions()->count()); + + $this->actingAs($editor, 'staff') + ->get(route('editorial.preview', ['composition' => $programVersion->composition, 'version' => $versions[1]])) + ->assertOk() + ->assertSee('Vorschau für die Redaktion') + ->assertSee('Modul Hilfe') + ->assertSee('Lara im Park') + ->assertSee('Trainerunterlage Abstand'); + } + + public function test_a_new_module_returns_into_the_program(): void + { + $content = app(ContentService::class); + $sheet = $content->publishElementVersion($content->createElement('text', 'text', 'Blatt'), 'Hinweis'); + $program = $content->publishComposition( + $content->createComposition('Programm Abstand', CompositionKind::Kurs), + [['role' => 'Unterlage', 'target' => $sheet]], + ); + $editor = $this->editor(); + $programUrl = CourseResource::getUrl('edit', ['record' => $program->composition]); + + $created = Livewire::actingAs($editor, 'staff') + ->test(EditCourse::class, ['record' => $program->composition_id]) + ->set('newModuleName', 'UX-Prüfung Modul') + ->call('startModule'); + $module = Composition::query()->where('designation', 'UX-Prüfung Modul')->firstOrFail(); + + $this->assertSame(CompositionKind::Uebung, $module->kind); + + $this->actingAs($editor, 'staff') + ->get(ExerciseResource::getUrl('edit', ['record' => $module]).'?zurueck='.urlencode('http://example.test/verwaltung/kurse/1')) + ->assertOk() + ->assertSee('Zurück und einbinden'); + + Livewire::actingAs($editor, 'staff') + ->test(EditExercise::class, ['record' => $module->id]) + ->set('returnUrl', $programUrl) + ->set('newTextTitle', 'UX-Prüfung Text') + ->set('newTextBody', 'Nur für die Bedienprüfung.') + ->call('addText') + ->call('returnAndInclude') + ->assertSet('releaseArmed', true) + ->assertSee('Noch nicht freigegeben') + ->set('releaseConsent', true) + ->call('publishRevision') + ->assertRedirect(); + + $version = $module->versions()->firstOrFail(); + + $this->actingAs($editor, 'staff') + ->get($programUrl.'?uebernehmen=composition:'.$version->id) + ->assertOk() + ->assertSee('UX-Prüfung Modul') + ->assertSee('ist in den Aufbau übernommen'); + + $this->assertSame(1, $program->composition->versions()->count()); + $this->assertSame($sheet->id, $program->fresh()->members()->first()->content_element_version_id); + } + + public function test_a_role_change_stays_on_the_selected_part_when_the_order_changes(): void + { + $content = app(ContentService::class); + $sheet = $content->publishElementVersion($content->createElement('text', 'text', 'Blatt'), 'Hinweis'); + $film = $content->publishElementVersion($content->createElement('film', 'film', 'Lara im Park'), 'Film'); + $program = $content->publishComposition( + $content->createComposition('Programm Abstand', CompositionKind::Kurs), + [ + ['role' => 'Unterlage', 'target' => $sheet], + ['role' => 'Film', 'target' => $film], + ], + ); + + Livewire::actingAs($this->editor(), 'staff') + ->test(EditCourse::class, ['record' => $program->composition_id]) + ->call('selectPart', 1) + ->set('roleDraft', 'Film zum Einstieg') + ->assertSet('members.0.role', 'Unterlage') + ->assertSet('members.1.role', 'Film zum Einstieg') + ->call('movePart', 1, -1) + ->call('publishRevision') + ->assertSet('feedback', 'Fassung 2 ist freigegeben. Der Entwurf ist geschlossen und die bisherige Fassung bleibt erhalten. Die Mitgliederbibliothek ändert sich dadurch nicht.'); + + $versions = $program->composition->versions()->with('members')->orderBy('number')->get(); + + $this->assertCount(2, $versions); + $this->assertSame('Unterlage', $versions[0]->members[0]->role); + $this->assertSame('Film', $versions[0]->members[1]->role); + $this->assertSame('Film zum Einstieg', $versions[1]->members[0]->role); + $this->assertSame($film->id, $versions[1]->members[0]->content_element_version_id); + $this->assertSame('Unterlage', $versions[1]->members[1]->role); + $this->assertSame($sheet->id, $versions[1]->members[1]->content_element_version_id); + } + + public function test_saving_a_draft_ten_times_creates_one_version_only_when_released(): void + { + $editor = $this->editor(); + $module = app(ContentService::class)->createComposition('Entwurf Modul', CompositionKind::Uebung); + $component = Livewire::actingAs($editor, 'staff') + ->test(EditExercise::class, ['record' => $module->id]) + ->set('newTextTitle', 'Hinweis') + ->set('newTextBody', 'Erst der Entwurf.') + ->call('addText'); + + for ($i = 1; $i <= 10; $i++) { + $component->set('learningGoal', 'Durchgang '.$i)->call('saveDraft'); + } + + $module->refresh(); + $this->assertSame(0, $module->versions()->count()); + $this->assertSame('Durchgang 10', $module->working_draft['learning_goal']); + + Livewire::actingAs($editor, 'staff') + ->test(EditExercise::class, ['record' => $module->id]) + ->assertSet('learningGoal', 'Durchgang 10') + ->set('releaseConsent', true) + ->call('publishRevision') + ->assertSet('feedback', 'Fassung 1 ist freigegeben. Der Entwurf ist geschlossen und die bisherige Fassung bleibt erhalten. Die Mitgliederbibliothek ändert sich dadurch nicht.'); + + $module->refresh(); + $this->assertSame(1, $module->versions()->count()); + $this->assertSame('Durchgang 10', $module->versions()->first()->learning_goal); + $this->assertNull($module->working_draft); + + Livewire::actingAs($editor, 'staff') + ->test(EditExercise::class, ['record' => $module->id]) + ->set('learningGoal', 'Nur Entwurf') + ->call('saveDraft'); + + $module->refresh(); + $this->assertSame(1, $module->versions()->count()); + $this->assertSame('Durchgang 10', $module->versions()->first()->fresh()->learning_goal); + $this->assertSame('Nur Entwurf', $module->working_draft['learning_goal']); + } + + public function test_the_picker_finds_a_film_by_title(): void + { + $content = app(ContentService::class); + $content->publishElementVersion($content->createElement('film', 'film', 'Lara im Park'), 'Film'); + $module = $content->createComposition('Picker Modul', CompositionKind::Uebung); + + Livewire::actingAs($this->editor(), 'staff') + ->test(EditExercise::class, ['record' => $module->id]) + ->call('openPicker') + ->set('pickerQuery', 'Lara') + ->assertSee('Lara im Park') + ->assertSee('Neuen Text erstellen'); + } + + public function test_guests_cannot_open_the_trainer_preview(): void + { + $content = app(ContentService::class); + $sheet = $content->publishElementVersion($content->createElement('text', 'text', 'Blatt'), 'Hinweis'); + $version = $content->publishComposition( + $content->createComposition('Programm Abstand', CompositionKind::Kurs), + [['role' => 'Unterlage', 'target' => $sheet]], + ); + + $this->get(route('editorial.preview', ['composition' => $version->composition, 'version' => $version])) + ->assertRedirect(); + } + + public function test_catalog_cards_show_text_status_and_a_single_film_suggestion(): void + { + Storage::fake('media_derived'); + $content = app(ContentService::class); + $film = $this->filmWithPicture($content, 'Lara im Park'); + $withFilm = $content->publishComposition( + $content->createComposition('Modul mit Film', CompositionKind::Uebung), + [['role' => 'Film', 'target' => $film]], + ); + $withFilm->composition->summary = 'Kinder erkennen eine Grenze, bevor sie jemanden um Hilfe bitten.'; + $withFilm->composition->save(); + $plain = $content->createComposition('Modul ohne Bild', CompositionKind::Uebung); + $plain->summary = str_repeat('Ausführliche Kartenbeschreibung. ', 12); + $plain->save(); + $editor = $this->editor(); + app(CompositionDisplayRelease::class)->release($withFilm, $editor); + + Livewire::actingAs($editor, 'staff') + ->test(EditorialDesk::class) + ->assertSee('Kinder erkennen eine Grenze') + ->assertSee('Vorschlag aus dem Film Lara im Park') + ->assertSee('In der Mitgliederbibliothek') + ->assertSee('Kein Titelbild') + ->assertSee('Ausführliche Kartenbeschreibung') + ->assertSee('Nicht auf der Website') + ->assertSee('Kein aktives Angebot') + ->assertDontSee('Zur Anzeige freigeben') + ->set('visibility', 'entwurf') + ->assertSee('Modul ohne Bild') + ->assertDontSee('Modul mit Film'); + + Livewire::actingAs($editor, 'staff') + ->test(EditExercise::class, ['record' => $withFilm->composition_id]) + ->assertSee('Aus Mitgliederbibliothek ausblenden') + ->call('openModule') + ->assertSee('Vorschlag aus dem Film Lara im Park') + ->assertSee('Katalogbild') + ->assertSee('Didaktik und Katalogbild') + ->assertDontSee('Anzeige speichern') + ->assertDontSee('Zur Anzeige freigeben'); + } + + public function test_a_chosen_picture_and_description_do_not_create_a_version(): void + { + Storage::fake('media_derived'); + $content = app(ContentService::class); + $first = $this->filmWithPicture($content, 'Lara im Park'); + $second = $this->filmWithPicture($content, 'Lara im Hof'); + $version = $content->publishComposition( + $content->createComposition('Modul mit zwei Filmen', CompositionKind::Uebung), + [ + ['role' => 'Film', 'target' => $first], + ['role' => 'Weiterer Film', 'target' => $second], + ], + ); + $editor = $this->editor(); + + Livewire::actingAs($editor, 'staff') + ->test(EditExercise::class, ['record' => $version->composition_id]) + ->call('openModule') + ->assertSet('aufbauTab', 'angaben') + ->assertSee('Aus einem Film') + ->assertSee('Bild aus dem Bestand wählen') + ->assertSee('Hochladen') + ->assertSee('Lara im Park') + ->assertSee('Lara im Hof') + ->assertDontSee('Anzeige speichern') + ->assertDontSee('Titelbild speichern') + ->assertSee('Vorschlag aus dem Film Lara im Park') + ->call('adoptPicture', $first->element->id) + ->assertDontSee('Vorschlag aus dem Film') + ->assertSet('feedback', 'Das Vorschaubild ist gespeichert. Die Fassung bleibt unverändert.') + ->set('description', 'Eine fachliche Beschreibung für die Bibliothek.') + ->set('summary', 'Kurzer Kartentext') + ->call('saveDisplay') + ->assertSet('feedback', 'Die Anzeige ist gespeichert. Die Fassung bleibt unverändert.'); + + $composition = $version->composition->fresh(); + + $this->assertSame(1, $composition->versions()->count()); + $this->assertSame('vorschau/komposition-'.$composition->id.'.jpg', $composition->thumbnail_path); + $this->assertSame('element:'.$first->element->id, $composition->thumbnail_source); + $this->assertSame('Eine fachliche Beschreibung für die Bibliothek.', $composition->description); + Storage::disk('media_derived')->assertExists($composition->thumbnail_path); + $this->get('/medien/'.$composition->thumbnail_path)->assertNotFound(); + } + + public function test_texts_save_in_the_redaktion_and_the_dialog_keeps_didactics_without_a_new_version(): void + { + $content = app(ContentService::class); + $sheet = $content->publishElementVersion($content->createElement('text', 'text', 'Blatt'), 'Hinweis'); + $version = $content->publishComposition( + $content->createComposition('Dialog Modul', CompositionKind::Uebung), + [['role' => 'Unterlage', 'target' => $sheet]], + ); + $editor = $this->editor(); + + Livewire::actingAs($editor, 'staff') + ->test(EditExercise::class, ['record' => $version->composition_id]) + ->assertDontSee('Anzeige speichern') + ->call('openModule') + ->assertSee('Didaktik') + ->assertSee('Katalogbild') + ->assertSee('Name, Texte, Präsentationsmedien und Einordnung bearbeitest du in der Redaktion.') + ->set('learningGoal', 'Weg damit') + ->call('discardDraft') + ->assertSet('learningGoal', ''); + + Livewire::actingAs($editor, 'staff') + ->test(EditExercise::class, ['record' => $version->composition_id]) + ->call('openRedaktion') + ->set('description', 'Ausführlicher Dialogtext') + ->set('summary', 'Kurzer Dialogtext') + ->call('saveRedaktion') + ->assertSee('Aufbau, Lernziel, Zeit und Fassungen bleiben unverändert.'); + + $composition = $version->composition->fresh(); + $this->assertSame(1, $composition->versions()->count()); + $this->assertSame('Ausführlicher Dialogtext', $composition->description); + $this->assertNull($composition->working_draft); + + Livewire::actingAs($editor, 'staff') + ->test(EditExercise::class, ['record' => $version->composition_id]) + ->set('learningGoal', 'Nur im Entwurf') + ->set('durationMinutes', '9') + ->call('saveDraft'); + + $composition->refresh(); + $this->assertSame(1, $composition->versions()->count()); + $this->assertSame(ContentVersionStatus::Bereit, $composition->versions()->first()->status); + $this->assertSame('Nur im Entwurf', $composition->working_draft['learning_goal']); + $this->assertSame(9, $composition->working_draft['duration_minutes']); + } + + public function test_the_picker_groups_versions_and_adopts_the_chosen_one(): void + { + $content = app(ContentService::class); + $element = $content->createElement('film', 'film', 'Lara im Park'); + $first = $content->publishElementVersion($element, 'Erste Stelle'); + $second = $content->publishElementVersion($element, 'Zweite Stelle'); + $module = $content->createComposition('Fassungswahl', CompositionKind::Uebung); + + $component = Livewire::actingAs($this->editor(), 'staff') + ->test(EditExercise::class, ['record' => $module->id]) + ->call('openPicker') + ->set('pickerQuery', 'Lara') + ->set('pickerSelected', 'element:'.$second->id); + + $items = $component->instance()->pickerResult()['items']; + $this->assertCount(1, $items); + $this->assertSame('element:'.$second->id, $items[0]['target']); + + $component + ->assertSee('Fassung 1') + ->assertSee('aktueller Stand') + ->set('pickerSelected', 'element:'.$first->id) + ->call('addPart', 'element:'.$first->id) + ->assertSee('Gespeichert wird mit „Entwurf speichern“') + ->call('saveDraft'); + $module->refresh(); + $this->assertSame(0, $module->versions()->count()); + $this->assertSame('element:'.$first->id, $module->working_draft['members'][0]['target']); + } + + public function test_the_picker_includes_draft_media(): void + { + $content = app(ContentService::class); + $ready = $content->publishElementVersion($content->createElement('text', 'text', 'Fertiger Hinweis'), 'Text'); + $onlyDraft = $content->draftElementVersion($content->createElement('film', 'film', 'Felix beim Onkel'), 'Szene'); + $revised = $content->createElement('text', 'text', 'Hinweis mit Entwurf'); + $content->publishElementVersion($revised, 'Alt'); + $newerDraft = $content->draftElementVersion($revised, 'Neu'); + $module = $content->createComposition('Auswahl', CompositionKind::Uebung); + + $component = Livewire::actingAs($this->editor(), 'staff') + ->test(EditExercise::class, ['record' => $module->id]) + ->call('openPicker'); + + $byTitle = []; + + foreach ($component->instance()->pickerResult()['items'] as $item) { + $byTitle[$item['title']] = $item['target']; + } + + $this->assertSame('element:'.$ready->id, $byTitle['Fertiger Hinweis']); + $this->assertSame('element:'.$onlyDraft->id, $byTitle['Felix beim Onkel']); + $this->assertSame('element:'.$newerDraft->id, $byTitle['Hinweis mit Entwurf']); + + $component + ->set('pickerSelected', 'element:'.$onlyDraft->id) + ->assertSee('Felix beim Onkel') + ->call('addPart', 'element:'.$onlyDraft->id) + ->call('saveDraft'); + + $this->assertSame('element:'.$onlyDraft->id, $module->fresh()->working_draft['members'][0]['target']); + $this->assertSame(ContentVersionStatus::Entwurf, $onlyDraft->fresh()->status); + } + + public function test_a_local_role_is_edited_in_place_and_saved_with_the_draft(): void + { + $content = app(ContentService::class); + $sheet = $content->publishElementVersion($content->createElement('text', 'text', 'Blatt'), 'Hinweis'); + $version = $content->publishComposition( + $content->createComposition('Rollendialog', CompositionKind::Uebung), + [['role' => 'Unterlage', 'target' => $sheet]], + ); + + Livewire::actingAs($this->editor(), 'staff') + ->test(EditExercise::class, ['record' => $version->composition_id]) + ->assertSet('selected', 0) + ->assertSee('An dieser Stelle') + ->assertSee('Gilt nur hier. Die Quelle bleibt unverändert.') + ->set('roleDraft', 'Einstieg') + ->assertSee('Änderungen am Aufbau nicht gespeichert') + ->call('saveDraft') + ->assertSee('Es entsteht keine neue Fassung'); + + $composition = $version->composition->fresh(); + $this->assertSame(1, $composition->versions()->count()); + $this->assertSame('Unterlage', $composition->versions()->first()->members()->first()->role); + $this->assertSame('Einstieg', $composition->working_draft['members'][0]['role']); + } + + public function test_a_missing_film_frame_does_not_create_a_version(): void + { + Storage::fake('media_derived'); + $content = app(ContentService::class); + $element = $content->createElement('film', 'film', 'Lara im Park'); + $film = $content->publishElementVersion($element, null, ['file' => 'inhalte/lara.mp4']); + $version = $content->publishComposition( + $content->createComposition('Rahmen Modul', CompositionKind::Uebung), + [['role' => 'Film', 'target' => $film]], + ); + $editor = $this->editor(); + + $this->get(route('editorial.frame', ['version' => $film, 'sekunde' => '4.5'])) + ->assertRedirect(); + $this->actingAs($editor, 'staff') + ->get(route('editorial.frame', ['version' => $film, 'sekunde' => '4.5'])) + ->assertNotFound(); + $this->actingAs($editor, 'staff') + ->get(route('editorial.frame', ['version' => $film, 'sekunde' => 'nein'])) + ->assertNotFound(); + + Livewire::actingAs($editor, 'staff') + ->test(EditExercise::class, ['record' => $version->composition_id]) + ->call('openModule') + ->set('imageMode', 'film') + ->set('frameVersionId', $film->id) + ->set('frameSecond', '4.5') + ->call('saveCatalogImage') + ->assertSet('aufbauTab', 'angaben'); + + $composition = $version->composition->fresh(); + $film->refresh(); + $this->assertSame(1, $composition->versions()->count()); + $this->assertNull($composition->thumbnail_path); + $this->assertNotNull($composition->thumbnail_error); + $this->assertSame('inhalte/lara.mp4', $film->metadata['file']); + Storage::disk('media_derived')->assertMissing('inhalte/lara.mp4'); + } + + public function test_a_placement_note_waits_for_release_and_keeps_the_old_version(): void + { + $content = app(ContentService::class); + $sheet = $content->publishElementVersion($content->createElement('text', 'text', 'Blatt'), 'Hinweis'); + $version = $content->publishComposition( + $content->createComposition('Stellenmodul', CompositionKind::Uebung), + [['role' => 'Unterlage', 'target' => $sheet]], + ); + + Livewire::actingAs($this->editor(), 'staff') + ->test(EditExercise::class, ['record' => $version->composition_id]) + ->call('selectPart', 0) + ->assertSee('Hinweis an dieser Stelle') + ->set('noteDraft', 'Hier zuerst den Abstand ansprechen.') + ->call('saveDraft') + ->assertSee('Es entsteht keine neue Fassung') + ->call('publishRevision'); + + $composition = $version->composition->fresh(); + $this->assertSame(2, $composition->versions()->count()); + $this->assertNull($version->fresh()->members()->first()->placement_note); + $released = $composition->versions()->where('number', 2)->first(); + $this->assertSame('Hier zuerst den Abstand ansprechen.', $released->members()->first()->placement_note); + $this->assertSame(ContentVersionStatus::Bereit, $released->status); + } + + public function test_a_module_text_stays_editable_until_it_is_released_and_used(): void + { + $editor = $this->editor(); + $module = app(ContentService::class)->createComposition('Text im Modul', CompositionKind::Uebung); + $component = Livewire::actingAs($editor, 'staff') + ->test(EditExercise::class, ['record' => $module->id]) + ->set('newTextTitle', 'Hinweis') + ->set('newTextBody', 'Erster Wortlaut') + ->call('addText') + ->assertSee('Hinweis') + ->call('saveDraft') + ->call('selectPart', 0) + ->set('detailTab', 'quelle') + ->assertSee('dieselbe Fassung fort') + ->set('partBody', 'Geänderter Wortlaut') + ->call('saveSourceText') + ->assertSee('derselben Fassung'); + + $element = ContentElement::query()->where('working_title', 'Hinweis')->firstOrFail(); + $version = $element->versions()->sole(); + + $this->assertSame(ContentVersionStatus::Entwurf, $version->status); + $this->assertSame('Geänderter Wortlaut', $version->body); + $this->assertSame(1, $element->versions()->count()); + + $this->actingAs($editor, 'staff') + ->get(ContentElementResource::getUrl('index')) + ->assertOk() + ->assertSee('Hinweis') + ->assertSee('Entwurf'); + + $component->set('releaseConsent', true)->call('publishRevision'); + $this->assertSame(ContentVersionStatus::Bereit, $version->fresh()->status); + $this->assertSame($version->id, $module->fresh()->versions()->first()->members()->first()->content_element_version_id); + + $component + ->call('selectPart', 0) + ->set('detailTab', 'quelle') + ->set('partBody', 'Nach der Freigabe') + ->call('saveSourceText') + ->assertSee('neuen Fassung') + ->call('saveDraft'); + + $this->assertSame(2, $element->fresh()->versions()->count()); + $this->assertSame('Geänderter Wortlaut', $version->fresh()->body); + $this->assertSame($version->id, $module->fresh()->versions()->first()->members()->first()->content_element_version_id); + $this->assertSame('element:'.$element->versions()->orderByDesc('number')->first()->id, $module->fresh()->working_draft['members'][0]['target']); + } + + public function test_a_file_can_be_created_inside_the_module(): void + { + Storage::fake('cms_incoming'); + Storage::fake('media_derived'); + Storage::disk('cms_incoming')->put('inhalte/merkblatt.pdf', 'pdfbytes'); + $image = imagecreatetruecolor(8, 8); + ob_start(); + imagejpeg($image); + Storage::disk('cms_incoming')->put('vorschau/karte.jpg', (string) ob_get_clean()); + imagedestroy($image); + $editor = $this->editor(); + $module = app(ContentService::class)->createComposition('Datei im Modul', CompositionKind::Uebung); + + $component = Livewire::actingAs($editor, 'staff') + ->test(EditExercise::class, ['record' => $module->id]) + ->call('openPicker') + ->assertSee('Bestandteil auswählen') + ->assertSee('Neues Medium anlegen') + ->mountAction('createMedium') + ->assertSet('pickerOpen', false) + ->assertMountedActionModalSee('Vorschaubild') + ->fillForm([ + 'working_title' => 'Merkblatt', + 'shape' => 'document', + 'description' => 'Für die Gruppe', + 'usage_note' => 'Vorher lesen', + 'incoming' => ['inhalte/merkblatt.pdf'], + 'thumbnail_upload' => ['vorschau/karte.jpg'], + ]) + ->assertMountedActionModalSee('Datei wird hochgeladen') + ->callMountedAction() + ->assertSee('Merkblatt'); + + $element = ContentElement::query()->where('working_title', 'Merkblatt')->firstOrFail(); + $version = $element->versions()->sole(); + + $this->assertSame('document', $element->output_class); + $this->assertSame('Für die Gruppe', $element->description); + $this->assertSame('Vorher lesen', $element->usage_note); + $this->assertSame(ContentVersionStatus::Entwurf, $version->status); + $this->assertSame('eigen', $element->fresh()->thumbnail_source); + app(ThumbnailDeriver::class)->forElement($element->fresh()); + $this->assertSame('eigen', $element->fresh()->thumbnail_source); + $this->assertIsString($version->metadata['file'] ?? null); + Storage::disk('media_derived')->assertExists($version->metadata['file']); + + // Angaben des Mediums bearbeitet seine eigene Redaktion; der Aufbau verweist nur darauf. + $component + ->call('saveDraft') + ->set('detailTab', 'quelle') + ->assertSee('Quelle bearbeiten') + ->assertSee(ContentElementResource::getUrl('view', ['record' => $element]), false); + + $this->assertSame(1, $element->versions()->count()); + + $component->set('releaseConsent', true)->call('publishRevision'); + $this->assertSame(ContentVersionStatus::Bereit, $version->fresh()->status); + $this->assertSame($version->id, $module->fresh()->versions()->first()->members()->first()->content_element_version_id); + } + + public function test_release_reviews_the_structure_and_keeps_other_references(): void + { + $content = app(ContentService::class); + $film = $content->publishElementVersion($content->createElement('film', 'film', 'Lara im Park'), 'Film'); + $guide = $content->draftElementVersion($content->createElement('text', 'text', 'Traineranleitung'), 'Zuerst vorlesen.'); + $soonBlocked = $content->publishElementVersion($content->createElement('text', 'text', 'Alter Hinweis'), 'Alt'); + $other = $content->publishComposition( + $content->createComposition('Anderes Modul', CompositionKind::Uebung), + [['role' => 'Film', 'target' => $film]], + ); + $editor = $this->editor(); + $module = $content->createComposition('Freigabe Modul', CompositionKind::Uebung); + + $readyOnly = Livewire::actingAs($editor, 'staff') + ->test(EditExercise::class, ['record' => $module->id]) + ->call('addPart', 'element:'.$film->id) + ->call('armRelease') + ->assertSee('Bereits freigegeben') + ->assertSee('Lara im Park') + ->assertSee('bleibt unverändert') + ->assertSee('Keine Bestandteile warten') + ->call('cancelRelease') + ->assertSet('releaseArmed', false); + + $this->assertSame(0, $module->fresh()->versions()->count()); + + $readyOnly + ->call('armRelease') + ->call('publishRevision') + ->assertSee('Fassung 1 ist freigegeben') + ->call('showAufbauTab', 'verlauf') + ->assertSee('keinen offenen Entwurf') + ->assertSee('In Mitgliederbibliothek anzeigen'); + + $this->assertSame($film->id, $module->fresh()->versions()->first()->members()->first()->content_element_version_id); + $this->assertSame($film->id, $other->fresh()->members()->first()->content_element_version_id); + $this->assertSame(1, $film->element->fresh()->versions()->count()); + + $withGuide = $content->createComposition('Mit Anleitung', CompositionKind::Uebung); + $guideEditor = Livewire::actingAs($editor, 'staff') + ->test(EditExercise::class, ['record' => $withGuide->id]) + ->call('addPart', 'element:'.$guide->id) + ->call('armRelease') + ->assertSee('Traineranleitung') + ->assertSee('Der Entwurf wird freigegeben') + ->call('publishRevision') + ->assertSee('ausdrücklicher Zustimmung'); + + $this->assertSame(ContentVersionStatus::Entwurf, $guide->fresh()->status); + $this->assertSame(0, $withGuide->fresh()->versions()->count()); + + $guideEditor + ->set('releaseConsent', true) + ->call('publishRevision') + ->assertSee('Fassung 1 ist freigegeben'); + + $this->assertSame(ContentVersionStatus::Bereit, $guide->fresh()->status); + $this->assertSame($guide->id, $withGuide->fresh()->versions()->first()->members()->first()->content_element_version_id); + + $child = $content->createComposition('Untermodul', CompositionKind::Uebung); + $child->working_draft = [ + 'learning_goal' => 'Grenze erkennen', + 'duration_minutes' => 8, + 'material_note' => null, + 'revision_note' => null, + 'members' => [['role' => 'Film', 'target' => 'element:'.$film->id, 'note' => '']], + ]; + $child->save(); + $program = $content->createComposition('Freigabe Programm', CompositionKind::Kurs); + + Livewire::actingAs($editor, 'staff') + ->test(EditCourse::class, ['record' => $program->id]) + ->call('openPicker') + ->assertSee('Untermodul') + ->set('pickerSelected', 'composition-draft:'.$child->id) + ->assertSee('gemeinsame Freigabe') + ->call('addPart', 'composition-draft:'.$child->id) + ->call('armRelease') + ->assertSee('Es entsteht Fassung 1') + ->set('releaseConsent', true) + ->call('publishRevision') + ->assertSee('Fassung 1 ist freigegeben'); + + $childVersion = $child->fresh()->versions()->first(); + $this->assertSame(ContentVersionStatus::Bereit, $childVersion->status); + $this->assertSame($film->id, $childVersion->members()->first()->content_element_version_id); + $this->assertSame($childVersion->id, $program->fresh()->versions()->first()->members()->first()->nested_composition_version_id); + $this->assertSame(1, $other->composition->fresh()->versions()->count()); + $this->assertSame($film->id, $other->fresh()->members()->first()->content_element_version_id); + + $held = $content->createComposition('Behält den Hinweis', CompositionKind::Uebung); + $content->publishComposition($held, [['role' => 'Hinweis', 'target' => $soonBlocked]]); + + $broken = $content->createComposition('Mit Fehler', CompositionKind::Uebung); + $brokenEditor = Livewire::actingAs($editor, 'staff') + ->test(EditExercise::class, ['record' => $broken->id]) + ->call('addPart', 'element:'.$soonBlocked->id) + ->call('saveDraft'); + $content->block($soonBlocked, 'Nicht mehr verwenden'); + $brokenEditor + ->call('armRelease') + ->assertSee('deaktiviert') + ->assertSee('content-elements/'.$soonBlocked->content_element_id) + ->call('publishRevision') + ->assertSet('releaseArmed', true); + + $this->assertSame(0, $broken->fresh()->versions()->count()); + $this->assertSame(ContentVersionStatus::Gesperrt, $soonBlocked->fresh()->status); + + Livewire::actingAs($editor, 'staff') + ->test(EditExercise::class, ['record' => $broken->id]) + ->assertSee('Alter Hinweis') + ->assertSee('deaktiviert'); + + Livewire::actingAs($editor, 'staff') + ->test(EditExercise::class, ['record' => $held->id]) + ->assertSee('Alter Hinweis') + ->assertSee('deaktiviert') + ->set('learningGoal', 'Der Hinweis bleibt sichtbar') + ->call('armRelease') + ->assertSee('Diese Fassung ist deaktiviert') + ->assertSee('content-elements/'.$soonBlocked->content_element_id); + $this->assertSame(1, $other->composition->fresh()->versions()->count()); + } + + private function filmWithPicture(ContentService $content, string $title): ContentElementVersion + { + $element = $content->createElement('film', 'film', $title); + $version = $content->publishElementVersion($element, 'Film'); + $element->thumbnail_path = 'vorschau/element-'.$element->id.'.jpg'; + $element->thumbnail_alt = $title; + $element->save(); + $image = imagecreatetruecolor(8, 8); + ob_start(); + imagepng($image); + Storage::disk('media_derived')->put($element->thumbnail_path, ob_get_clean()); + imagedestroy($image); + + return $version->fresh(); + } + + private function editor(): User + { + $editor = User::factory()->redakteur()->create(); + $editor->saveAppAuthenticationSecret('JBSWY3DPEHPK3PXP'); + + return $editor; + } +} diff --git a/tests/Feature/IdentityProfileTest.php b/tests/Feature/IdentityProfileTest.php new file mode 100644 index 0000000..f406c1f --- /dev/null +++ b/tests/Feature/IdentityProfileTest.php @@ -0,0 +1,51 @@ +publishElementVersion($content->createElement('text', 'text', 'Arbeitstitel'), 'Text'); + $element = $version->element; + $article = app(ArticleService::class)->create('stamm'); + app(ArticleService::class)->publishRelease($article, $version, 'Eigenständig.'); + $offers = app(OfferService::class); + $rights = $offers->createRightsProfile('Lesen', 'ehrenamtlich', ['text' => ['ansehen']]); + $offer = $offers->create('Stammangebot'); + $offers->activate($offer, [['target' => $article->fresh(), 'rights' => $rights]], ['grant_kind' => 'auf_abruf']); + $member = User::factory()->create(); + app(GrantIssuer::class)->claim($member, $offer); + + $versions = $element->versions()->count(); + $releases = $article->releases()->count(); + app(IdentityProfile::class)->fill($element, [ + 'display_title' => 'Sichtbarer Titel', + 'summary' => 'Kurz für die Bibliothek', + ], $member); + + $this->assertSame($versions, $element->fresh()->versions()->count()); + $this->assertSame($releases, $article->fresh()->releases()->count()); + $this->assertSame('Sichtbarer Titel', app(CourseOutline::class)->title($article->fresh())); + $change = IdentityChange::query()->where('field', 'display_title')->first(); + $this->assertSame($member->id, $change->actor_id); + $this->assertNotNull($change->occurred_at); + + $this->actingAs($member)->get(route('member.library', ['q' => 'Sichtbarer']))->assertOk()->assertSee('Sichtbarer Titel'); + $this->actingAs($member)->get(route('member.library', ['q' => 'kommt-nicht-vor']))->assertOk()->assertDontSee('Sichtbarer Titel'); + } +} diff --git a/tests/Feature/LibraryCompletionTest.php b/tests/Feature/LibraryCompletionTest.php new file mode 100644 index 0000000..b34e439 --- /dev/null +++ b/tests/Feature/LibraryCompletionTest.php @@ -0,0 +1,77 @@ +publishElementVersion($content->createElement('film', 'film', 'Hof'), null, ['file' => 'inhalte/hof.mp4']); + $sheet = $content->publishElementVersion($content->createElement('text', 'document', 'Blatt'), 'Text'); + $programm = EditorialContentKind::query()->where('slug', 'programm')->firstOrFail(); + $version = $content->publishComposition( + tap($content->createComposition('Öffentliches Programm'), function ($item) use ($programm): void { + $item->editorial_content_kind_id = $programm->id; + $item->thumbnail_error = 'Kein Bild erzeugt.'; + $item->save(); + }), + [ + ['role' => 'Film', 'target' => $film], + ['role' => 'Blatt', 'target' => $sheet], + ], + null, + null, + ['learning_goal' => 'Abstand halten', 'duration_minutes' => 20, 'material_note' => 'Ein Blatt'], + ); + $articles = app(ArticleService::class); + $filmArticle = $articles->create('nur-film-fertig'); + $articles->publishRelease($filmArticle, $film, 'Nur Film.'); + $offers = app(OfferService::class); + $rights = $offers->createRightsProfile('Film', 'ehrenamtlich', ['film' => ['streamen']]); + $offer = $offers->create('Teilprogramm'); + $offers->activate($offer, [['target' => $filmArticle->fresh(), 'rights' => $rights]], ['grant_kind' => 'auf_abruf']); + $member = User::factory()->create(); + app(GrantIssuer::class)->claim($member, $offer); + app(CompositionDisplayRelease::class)->release($version, $member); + + $this->actingAs($member)->get(route('member.program', $version->composition)) + ->assertOk() + ->assertSee('teilweise') + ->assertSee('Abstand halten') + ->assertSee('Kein Bild erzeugt.') + ->assertSee('Platzhalter'); + + $this->get(route('public.program', $version->composition)) + ->assertOk() + ->assertSee('Öffentliches Programm') + ->assertSee('Abstand halten') + ->assertDontSee('inhalte/hof.mp4'); + + $this->get('/medien/bibliothek/geheim.jpg')->assertNotFound(); + } + + public function test_review_fixture_can_be_repeated(): void + { + $actor = User::factory()->create(); + + $this->artisan('library:review-fixture', ['--actor' => $actor->id])->assertSuccessful(); + $this->artisan('library:review-fixture', ['--actor' => $actor->id])->assertSuccessful(); + + $this->assertSame(1, Composition::query()->where('designation', 'Prüfprogramm Abstand')->count()); + $this->assertNotNull(User::query()->where('email', 'trainer-pruefung@example.test')->first()); + } +} diff --git a/tests/Feature/LibraryProgramTest.php b/tests/Feature/LibraryProgramTest.php new file mode 100644 index 0000000..d590cd1 --- /dev/null +++ b/tests/Feature/LibraryProgramTest.php @@ -0,0 +1,137 @@ +publishElementVersion( + $content->createElement('film', 'film', 'Hofszene'), + null, + ['file' => 'inhalte/hof.mp4'], + ); + $programm = EditorialContentKind::query()->where('slug', 'programm')->firstOrFail(); + $released = $content->publishComposition( + tap($content->createComposition('Sicher auf dem Schulweg'), function ($item) use ($programm): void { + $item->editorial_content_kind_id = $programm->id; + $item->save(); + }), + [['role' => 'Film', 'target' => $film]], + ); + $hidden = $content->publishComposition( + $content->createComposition('Noch nicht zeigen'), + [['role' => 'Film', 'target' => $film]], + ); + + $articles = app(ArticleService::class); + $visibleArticle = $articles->create('sichtbar'); + $articles->publishRelease($visibleArticle, $released, 'Programmartikel.'); + $hiddenArticle = $articles->create('verborgen'); + $articles->publishRelease($hiddenArticle, $hidden, 'Nicht freigegeben.'); + + $offers = app(OfferService::class); + $rights = $offers->createRightsProfile('Film', 'ehrenamtlich', ['film' => ['streamen', 'laden']]); + $offer = $offers->create('Programmzugang'); + $offers->activate($offer, [ + ['target' => $visibleArticle->fresh(), 'rights' => $rights], + ], ['grant_kind' => 'auf_abruf']); + + $member = User::factory()->create(); + app(GrantIssuer::class)->claim($member, $offer); + app(CompositionDisplayRelease::class)->release($released, $member); + + $this->actingAs($member) + ->get(route('member.library')) + ->assertOk() + ->assertSee('Sicher auf dem Schulweg') + ->assertDontSee('Noch nicht zeigen'); + + $this->actingAs($member) + ->get(route('member.program', $released->composition)) + ->assertOk() + ->assertSee('Film: Hofszene') + ->assertSee('Laden') + ->assertSee('publishElementVersion( + $content->createElement('film', 'film', 'Hofszene'), + null, + ['file' => 'inhalte/hof.mp4'], + ); + $film->element->thumbnail_path = 'vorschau/element-'.$film->element->id.'.jpg'; + $film->element->thumbnail_alt = 'Hofbild'; + $film->element->save(); + $image = imagecreatetruecolor(4, 4); + ob_start(); + imagejpeg($image); + Storage::disk('media_derived')->put($film->element->thumbnail_path, ob_get_clean()); + imagedestroy($image); + + $programm = EditorialContentKind::query()->where('slug', 'programm')->firstOrFail(); + $released = $content->publishComposition( + tap($content->createComposition('Sicher auf dem Schulweg'), function ($item) use ($programm): void { + $item->editorial_content_kind_id = $programm->id; + $item->save(); + }), + [['role' => 'Film', 'target' => $film]], + ); + $articles = app(ArticleService::class); + $article = $articles->create('sichtbar-bild'); + $articles->publishRelease($article, $released, 'Programmartikel.'); + $offers = app(OfferService::class); + $rights = $offers->createRightsProfile('Film', 'ehrenamtlich', ['film' => ['streamen', 'laden']]); + $offer = $offers->create('Programmzugang Bild'); + $offers->activate($offer, [ + ['target' => $article->fresh(), 'rights' => $rights], + ], ['grant_kind' => 'auf_abruf']); + $member = User::factory()->create(); + app(GrantIssuer::class)->claim($member, $offer); + app(CompositionDisplayRelease::class)->release($released, $member); + $elementUrl = route('member.thumbnail', ['kind' => 'element', 'subject' => $film->element->id]); + + $this->actingAs($member) + ->get(route('member.program', $released->composition)) + ->assertOk() + ->assertSee($elementUrl, false) + ->assertSee('poster="'.$elementUrl.'"', false) + ->assertDontSee('Platzhalter'); + + $this->actingAs($member) + ->get(route('member.library')) + ->assertSee($elementUrl, false); + + $this->actingAs($member)->get($elementUrl)->assertOk(); + + $composition = $released->composition; + $composition->thumbnail_path = 'vorschau/komposition-'.$composition->id.'.jpg'; + $composition->thumbnail_alt = 'Programmbild'; + $composition->save(); + Storage::disk('media_derived')->put($composition->thumbnail_path, Storage::disk('media_derived')->get($film->element->thumbnail_path)); + $programUrl = route('member.thumbnail', ['kind' => 'komposition', 'subject' => $composition->id]); + + $this->actingAs($member) + ->get(route('member.library')) + ->assertSee($programUrl, false) + ->assertDontSee($elementUrl, false); + } +} diff --git a/tests/Feature/MediaAdministrationTest.php b/tests/Feature/MediaAdministrationTest.php new file mode 100644 index 0000000..69ee223 --- /dev/null +++ b/tests/Feature/MediaAdministrationTest.php @@ -0,0 +1,504 @@ +createElement('text', 'text', 'Merkblatt'); + $content->publishElementVersion($element, 'Erste Fassung'); + $editor = User::factory()->redakteur()->create(); + $editor->saveAppAuthenticationSecret('JBSWY3DPEHPK3PXP'); + $this->actingAs($editor, 'staff'); + + Livewire::test(ViewContentElement::class, ['record' => $element->getKey()]) + ->set('bereich', 'inhalt') + ->assertOk() + ->assertSet('bodyDraft', 'Erste Fassung') + ->assertSee('Text der Fassung') + ->assertSee('Fassung 1') + ->callAction('revise', [ + 'body' => 'Zweite Fassung', + 'change_note' => 'Korrektur', + ]) + ->assertHasNoFormErrors(); + + $versions = $element->versions()->orderBy('number')->get(); + + $this->assertCount(2, $versions); + $this->assertSame('Erste Fassung', $versions[0]->body); + $this->assertSame('Zweite Fassung', $versions[1]->body); + $this->assertSame(ContentVersionStatus::Bereit, $versions[0]->status); + } + + public function test_an_uploaded_file_becomes_a_ready_version(): void + { + Storage::fake('cms_incoming'); + Storage::fake('media_derived'); + Storage::disk('cms_incoming')->put('inhalte/film.mp4', 'filmbytes'); + $content = app(ContentService::class); + $element = $content->createElement('film', 'film', 'Übungsfilm'); + $editor = User::factory()->redakteur()->create(); + $editor->saveAppAuthenticationSecret('JBSWY3DPEHPK3PXP'); + $this->actingAs($editor, 'staff'); + + Livewire::test(ViewContentElement::class, ['record' => $element->getKey()]) + ->callAction('revise', [ + 'working_title' => 'Übungsfilm', + 'body' => 'Anleitung zum Film', + 'incoming' => ['inhalte/film.mp4'], + 'decision_seconds' => 12, + ]) + ->assertHasNoFormErrors(); + + $version = $element->versions()->first(); + + $this->assertNotNull($version); + $this->assertSame(ContentVersionStatus::Bereit, $version->status); + $this->assertSame('inhalte/'.$version->id.'/film.mp4', $version->metadata['file']); + $this->assertSame(12, $version->metadata['decision_seconds']); + $this->assertSame(MediaUploadLimit::KILOBYTES, EditContentElement::uploadField()->getMaxSize()); + $this->assertSame(MediaUploadLimit::rules(), FileUploadConfiguration::rules()); + Storage::disk('media_derived')->assertExists($version->metadata['file']); + $this->assertSame('filmbytes', Storage::disk('media_derived')->get($version->metadata['file'])); + } + + public function test_an_exercise_can_gain_and_drop_a_medium_without_losing_the_old_version(): void + { + $content = app(ContentService::class); + $sheet = $content->publishElementVersion( + $content->createElement('pdf', 'pdf', 'Merkblatt'), + 'Hinweis', + ); + $film = $content->publishElementVersion( + $content->createElement('film', 'film', 'Übungsfilm'), + 'Filmtext', + ); + $exercise = $content->publishComposition( + $content->createComposition('Alltag üben'), + [['role' => 'Merkblatt', 'target' => $sheet]], + ); + $editor = User::factory()->redakteur()->create(); + $editor->saveAppAuthenticationSecret('JBSWY3DPEHPK3PXP'); + $this->actingAs($editor, 'staff'); + + $this->get(ExerciseResource::getUrl('edit', ['record' => $exercise->composition])) + ->assertOk() + ->assertSee('Merkblatt') + ->assertSee('Hinzufügen') + ->assertSee('Fassung freigeben'); + + $this->get(CourseResource::getUrl('index'))->assertOk()->assertSee('Ein Programm aus Modulen'); + $this->assertStringContainsString('Ein Kurs ist keine Übung', CompositionKind::Kurs->explanation()); + $this->get(CombinationResource::getUrl('index'))->assertOk()->assertSee('Materialsatz'); + $this->get(ContentElementResource::getUrl('index'))->assertOk()->assertSee('Übungsfilm'); + + Livewire::test(EditExercise::class, ['record' => $exercise->composition_id]) + ->set('members', [[ + 'role' => 'Film', + 'target' => 'element:'.$film->id, + 'title' => 'Übungsfilm', + 'kind' => 'Film', + 'version_label' => 'Fassung 1', + 'identity' => 'medium:'.$film->content_element_id, + ]]) + ->set('revisionNote', 'Film statt Merkblatt') + ->call('publishRevision') + ->assertSet('feedback', 'Fassung 2 ist freigegeben. Der Entwurf ist geschlossen und die bisherige Fassung bleibt erhalten. Die Mitgliederbibliothek ändert sich dadurch nicht.'); + + $versions = $exercise->composition->versions()->with('members')->orderBy('number')->get(); + + $this->assertCount(2, $versions); + $this->assertSame($sheet->id, $versions[0]->members->first()->content_element_version_id); + $this->assertSame($film->id, $versions[1]->members->first()->content_element_version_id); + $this->assertSame('Film', $versions[1]->members->first()->role); + + Livewire::test(EditExercise::class, ['record' => $exercise->composition_id]) + ->set('learningGoal', 'Den Abstand üben') + ->call('publishRevision') + ->assertSet('feedback', 'Fassung 3 ist freigegeben. Der Entwurf ist geschlossen und die bisherige Fassung bleibt erhalten. Die Mitgliederbibliothek ändert sich dadurch nicht.'); + + $this->assertSame('Den Abstand üben', $exercise->composition->versions()->orderByDesc('number')->first()->learning_goal); + $this->assertSame(3, $exercise->composition->versions()->count()); + } + + public function test_a_composition_preview_is_derived_without_a_new_version(): void + { + Storage::fake('cms_incoming'); + Storage::fake('media_derived'); + $image = imagecreatetruecolor(8, 8); + ob_start(); + imagepng($image); + $png = ob_get_clean(); + imagedestroy($image); + Storage::disk('cms_incoming')->put('vorschau/karte.png', $png); + + $content = app(ContentService::class); + $sheet = $content->publishElementVersion( + $content->createElement('text', 'text', 'Blatt'), + 'Text', + ); + $exercise = $content->publishComposition( + $content->createComposition('Alltag üben'), + [['role' => 'Blatt', 'target' => $sheet]], + ); + $editor = User::factory()->redakteur()->create(); + $editor->saveAppAuthenticationSecret('JBSWY3DPEHPK3PXP'); + $this->actingAs($editor, 'staff'); + + Livewire::test(EditExercise::class, ['record' => $exercise->composition_id]) + ->call('savePreviewImage', 'vorschau/karte.png') + ->assertSet('feedback', 'Das Vorschaubild ist gespeichert. Die Fassung bleibt unverändert.'); + + $composition = $exercise->composition->fresh(); + + $this->assertSame(1, $composition->versions()->count()); + $this->assertSame('vorschau/komposition-'.$composition->id.'.jpg', $composition->thumbnail_path); + Storage::disk('media_derived')->assertExists($composition->thumbnail_path); + $this->assertNull($composition->thumbnail_error); + } + + public function test_a_catalog_keeper_cannot_edit_media(): void + { + $element = app(ContentService::class)->createElement('text', 'text', 'Hinweis'); + + $keeper = User::factory()->katalogverwalter()->create(); + $keeper->saveAppAuthenticationSecret('JBSWY3DPEHPK3PXP'); + + $this->actingAs($keeper, 'staff') + ->get(ContentElementResource::getUrl('edit', ['record' => $element])) + ->assertForbidden(); + + $version = app(ContentService::class)->publishElementVersion($element, 'Sichtbarer Text'); + + $this->actingAs($keeper, 'staff') + ->get(ContentElementResource::getUrl('view', ['record' => $element]).'?bereich=inhalt') + ->assertOk() + ->assertSee('Fassung 1') + ->assertSee('Sichtbarer Text') + ->assertDontSee('Beschreibung ändern'); + } + + public function test_a_description_does_not_create_a_version_and_an_older_version_can_be_deactivated(): void + { + Storage::fake('media_derived'); + Storage::disk('media_derived')->put('inhalte/film.mp4', 'filmbytes'); + $content = app(ContentService::class); + $element = $content->createElement('film', 'film', 'Übungsfilm'); + $first = $content->publishElementVersion($element, 'Erste Fassung', ['file' => 'inhalte/film.mp4']); + $second = $content->publishElementVersion($element, 'Zweite Fassung', ['file' => 'inhalte/film.mp4']); + $editor = User::factory()->redakteur()->create(); + $editor->saveAppAuthenticationSecret('JBSWY3DPEHPK3PXP'); + $this->actingAs($editor, 'staff'); + + Livewire::test(ViewContentElement::class, ['record' => $element->getKey()]) + ->call('openRedaktion') + ->set('descriptionText', 'Für die Gruppe') + ->call('saveRedaktion') + ->assertSee('Es gibt keine neue Fassung.'); + + $this->assertSame(2, $element->versions()->count()); + $this->assertSame('Für die Gruppe', $element->fresh()->description); + + Livewire::test(ViewContentElement::class, ['record' => $element->getKey()]) + ->set('bereich', 'inhalt') + ->assertSee('Fassung 2') + ->assertSee('assertSee(route('content.file', $second), false) + ->set('bereich', 'fassungen') + ->assertSee('Fassung 1') + ->assertSee('Fassung 2') + ->callAction('deactivate', ['reason' => 'Veraltet'], ['version' => $first->id]) + ->assertHasNoFormErrors() + ->assertSee('Deaktiviert'); + + $first->refresh(); + + $this->assertSame(ContentVersionStatus::Gesperrt, $first->status); + $this->assertSame('Veraltet', $first->block_reason); + $this->assertSame(ContentVersionStatus::Bereit, $element->versions()->where('number', 2)->first()->status); + + $this->actingAs($editor, 'staff') + ->get(route('content.file', $first)) + ->assertOk(); + } + + public function test_usage_and_license_notes_stay_on_the_medium_and_in_the_list(): void + { + $content = app(ContentService::class); + $element = $content->createElement('film', 'film', 'Lara im Park'); + $content->publishElementVersion($element, 'Film'); + $editor = User::factory()->redakteur()->create(); + $editor->saveAppAuthenticationSecret('JBSWY3DPEHPK3PXP'); + + Livewire::actingAs($editor, 'staff') + ->test(ViewContentElement::class, ['record' => $element->getKey()]) + ->call('openRedaktion') + ->set('descriptionText', 'Lara spielt im Park.') + ->set('usageNote', 'Vor dem Film den Abstand ansprechen.') + ->set('licenseNote', 'Nur intern: Archivmaterial der Produktion.') + ->call('saveRedaktion') + ->assertSee('Es gibt keine neue Fassung.'); + + $element->refresh(); + $this->assertSame(1, $element->versions()->count()); + $this->assertSame('Vor dem Film den Abstand ansprechen.', $element->usage_note); + $this->assertSame('Nur intern: Archivmaterial der Produktion.', $element->license_note); + + Livewire::actingAs($editor, 'staff') + ->test(ListContentElements::class) + ->assertSee('Vor dem Film den Abstand ansprechen.') + ->assertSee('Nur intern: Archivmaterial'); + + Livewire::actingAs($editor, 'staff') + ->test(ViewContentElement::class, ['record' => $element->getKey()]) + ->call('openRedaktion') + ->assertSee('Hinweise für den Einsatz') + ->assertSee('Vor dem Film den Abstand ansprechen.') + ->assertSee('Interner Lizenzvermerk'); + + $this->get('/')->assertDontSee('Nur intern: Archivmaterial der Produktion.'); + } + + public function test_a_frame_uses_the_small_film_rendition_when_it_exists(): void + { + Storage::fake('media_derived'); + $content = app(ContentService::class); + $element = $content->createElement('film', 'film', 'Lara im Park'); + $version = $content->publishElementVersion($element, null, ['file' => 'inhalte/lara.mp4']); + Storage::disk('media_derived')->put('inhalte/lara.mp4', 'original'); + Storage::disk('media_derived')->put('ableitungen/'.$version->id.'/480/index.m3u8', '#EXTM3U'); + MediaRendition::query()->create([ + 'content_element_version_id' => $version->id, + 'role' => 'variant', + 'label' => '480', + 'path' => 'ableitungen/'.$version->id.'/480/index.m3u8', + ]); + + $this->assertSame( + 'ableitungen/'.$version->id.'/480/index.m3u8', + app(ThumbnailDeriver::class)->frameInput($version), + ); + } + + public function test_a_chosen_film_frame_becomes_the_medium_preview_without_a_new_version(): void + { + Storage::fake('media_derived'); + Storage::fake('cms_incoming'); + $image = imagecreatetruecolor(4, 4); + ob_start(); + imagejpeg($image); + $jpeg = ob_get_clean(); + imagedestroy($image); + $this->app->bind(ThumbnailDeriver::class, fn () => new class($jpeg) extends ThumbnailDeriver + { + public function __construct(private string $jpeg) {} + + public function jpegAtVersion(ContentElementVersion $version, float $seconds): ?string + { + return $this->jpeg; + } + }); + + $content = app(ContentService::class); + $element = $content->createElement('film', 'film', 'Hofszene'); + $version = $content->publishElementVersion($element, 'Film', ['file' => 'inhalte/hof.mp4']); + $hash = $version->content_hash; + $editor = User::factory()->redakteur()->create(); + $editor->saveAppAuthenticationSecret('JBSWY3DPEHPK3PXP'); + + Livewire::actingAs($editor, 'staff') + ->test(ViewContentElement::class, ['record' => $element->getKey()]) + ->set('bereich', 'vorschaubild') + ->assertSee('Diese Stelle übernehmen') + ->call('adoptFrame') + ->assertSet('pictureFeedback', 'Wähle zuerst eine Zeitposition.') + ->set('frameSecond', '12.5') + ->call('adoptFrame') + ->assertSet('pictureFeedback', 'Das Vorschaubild ist gespeichert. Die Fassung bleibt unverändert.'); + + $element->refresh(); + $version->refresh(); + $this->assertSame(1, $element->versions()->count()); + $this->assertSame($hash, $version->content_hash); + $this->assertSame('vorschau/element-'.$element->id.'.jpg', $element->thumbnail_path); + $this->assertSame('frame:'.$version->id.'@12.5', $element->thumbnail_source); + Storage::disk('media_derived')->assertExists($element->thumbnail_path); + $this->get('/medien/'.$element->thumbnail_path)->assertNotFound(); + $this->actingAs($editor, 'staff') + ->get(route('editorial.card', ['kind' => 'element', 'subject' => $element->id])) + ->assertOk(); + + $module = $content->publishComposition( + $content->createComposition('Modul mit Hofszene', CompositionKind::Uebung), + [['role' => 'Film', 'target' => $version]], + ); + + Livewire::actingAs($editor, 'staff') + ->test(EditExercise::class, ['record' => $module->composition_id]) + ->call('openModule') + ->assertSee('Vorschlag aus dem Film Hofszene'); + } + + public function test_an_uploaded_preview_and_an_image_file_stay_on_the_medium(): void + { + Storage::fake('media_derived'); + Storage::fake('cms_incoming'); + $image = imagecreatetruecolor(8, 8); + ob_start(); + imagepng($image); + $png = ob_get_clean(); + imagedestroy($image); + Storage::disk('cms_incoming')->put('vorschau/karte.png', $png); + Storage::disk('media_derived')->put('inhalte/bild.png', $png); + + $content = app(ContentService::class); + $text = $content->publishElementVersion($content->createElement('text', 'text', 'Blatt'), 'Hinweis'); + $picture = $content->publishElementVersion( + $content->createElement('bild', 'bild', 'Kartenbild'), + null, + ['file' => 'inhalte/bild.png'], + ); + $editor = User::factory()->redakteur()->create(); + $editor->saveAppAuthenticationSecret('JBSWY3DPEHPK3PXP'); + $this->actingAs($editor, 'staff'); + + Livewire::test(ViewContentElement::class, ['record' => $text->element->getKey()]) + ->call('savePreviewImage', 'vorschau/karte.png') + ->assertSet('pictureFeedback', 'Das Vorschaubild ist gespeichert. Die Fassung bleibt unverändert.'); + + $text->element->refresh(); + $this->assertSame(1, $text->element->versions()->count()); + $this->assertSame('eigen', $text->element->thumbnail_source); + $this->assertSame('vorschau/element-'.$text->element->id.'.jpg', $text->element->thumbnail_path); + + Livewire::test(ViewContentElement::class, ['record' => $picture->element->getKey()]) + ->call('useOwnImage') + ->assertSet('pictureFeedback', 'Das Vorschaubild ist gespeichert. Die Fassung bleibt unverändert.'); + + $picture->element->refresh(); + $this->assertSame(1, $picture->element->versions()->count()); + $this->assertSame('datei', $picture->element->thumbnail_source); + Storage::disk('media_derived')->assertExists($picture->element->thumbnail_path); + } + + public function test_staff_players_use_the_stored_film_ladder(): void + { + Storage::fake('media_derived'); + $content = app(ContentService::class); + $version = $content->publishElementVersion( + $content->createElement('film', 'film', 'Hofszene'), + null, + ['file' => 'inhalte/hof.mp4'], + ); + Storage::disk('media_derived')->put('inhalte/hof.mp4', 'filmbytes'); + $base = 'ableitungen/'.$version->id; + Storage::disk('media_derived')->put($base.'/master.m3u8', "#EXTM3U\n#EXT-X-STREAM-INF:BANDWIDTH=800000\n480/index.m3u8\n"); + Storage::disk('media_derived')->put($base.'/480/index.m3u8', "#EXTM3U\n#EXTINF:6.0,\nsegment.m4s\n"); + Storage::disk('media_derived')->put($base.'/480/segment.m4s', 'segment-bytes'); + MediaRendition::query()->create([ + 'content_element_version_id' => $version->id, + 'role' => 'master', + 'label' => 'master', + 'path' => $base.'/master.m3u8', + ]); + $editor = User::factory()->redakteur()->create(); + $editor->saveAppAuthenticationSecret('JBSWY3DPEHPK3PXP'); + $playlist = route('content.rendition', ['version' => $version, 'datei' => $base.'/master.m3u8']); + $variant = route('content.rendition', ['version' => $version, 'datei' => $base.'/480/index.m3u8']); + + $this->get($playlist)->assertRedirect(); + + $this->actingAs($editor, 'staff') + ->get($playlist) + ->assertOk() + ->assertHeader('content-type', 'application/vnd.apple.mpegurl') + ->assertSee($variant, false); + + $this->actingAs($editor, 'staff') + ->get(route('content.rendition', ['version' => $version, 'datei' => $base.'/480/segment.m4s'])) + ->assertOk(); + + $this->actingAs($editor, 'staff') + ->get(route('content.rendition', ['version' => $version, 'datei' => 'ableitungen/99/master.m3u8'])) + ->assertNotFound(); + + Livewire::actingAs($editor, 'staff') + ->test(ViewContentElement::class, ['record' => $version->element->getKey()]) + ->set('bereich', 'inhalt') + ->assertSee('data-hls="'.$playlist.'"', false) + ->assertSee(route('content.file', $version), false); + + $module = $content->publishComposition( + $content->createComposition('Modul mit Hofszene', CompositionKind::Uebung), + [['role' => 'Film', 'target' => $version]], + ); + + Livewire::actingAs($editor, 'staff') + ->test(EditExercise::class, ['record' => $module->composition_id]) + ->call('openPicker') + ->set('pickerSelected', 'element:'.$version->id) + ->assertSee('data-hls="'.$playlist.'"', false); + } + + public function test_a_draft_medium_can_be_released_from_its_editor(): void + { + $editor = User::factory()->redakteur()->create(); + $editor->saveAppAuthenticationSecret('JBSWY3DPEHPK3PXP'); + $version = app(ContentService::class)->draftElementVersion( + app(ContentService::class)->createElement('text', 'text', 'Eigener Text'), + 'Wortlaut', + ); + + Livewire::actingAs($editor, 'staff') + ->test(ViewContentElement::class, ['record' => $version->content_element_id]) + ->set('bereich', 'fassungen') + ->assertSee('noch nicht freigegeben') + ->mountAction('releaseVersion', ['version' => $version->id]) + ->callMountedAction(); + + $this->assertSame(ContentVersionStatus::Bereit, $version->fresh()->status); + $this->assertSame(1, $version->element->fresh()->versions()->count()); + + Livewire::actingAs($editor, 'staff') + ->test(ViewContentElement::class, ['record' => $version->content_element_id]) + ->set('bereich', 'inhalt') + ->assertSee('freigegeben') + ->assertDontSee('Fassung freigeben'); + $this->assertSame(1, $version->element->fresh()->versions()->count()); + } +} diff --git a/tests/Feature/MediaEditorTest.php b/tests/Feature/MediaEditorTest.php new file mode 100644 index 0000000..4aeca87 --- /dev/null +++ b/tests/Feature/MediaEditorTest.php @@ -0,0 +1,140 @@ +createElement('film', 'film', 'Lara im Park'); + $version = $content->publishElementVersion($element, 'Film'); + $editor = $this->editor(); + $this->actingAs($editor, 'staff'); + + Livewire::test(ViewContentElement::class, ['record' => $element->getKey()]) + ->call('openRedaktion') + ->set('displayTitle', 'Lara im Park, neu') + ->set('summary', 'Ein kurzer Teaser für die Karte') + ->set('descriptionText', 'Ausführliche Beschreibung nur in der Verwaltung') + ->call('saveEditorial') + ->assertSee('Gespeichert. Es gibt keine neue Fassung.') + ->assertSee('Ein kurzer Teaser für die Karte') + ->call('openAusgabe') + ->assertSee('lf-pc'); + + $element->refresh(); + $this->assertSame(1, $element->versions()->count()); + $this->assertSame($version->id, $element->versions()->first()->id); + $this->assertSame('Lara im Park, neu', $element->display_title); + $this->assertSame('Ein kurzer Teaser für die Karte', $element->summary); + $this->assertTrue( + IdentityChange::query()->where('subject_id', $element->id)->where('field', 'summary')->exists() + ); + + $draft = app(PublicMaterialReader::class)->subject($element->id, true, [ + 'summary' => 'Noch nicht gespeichert', + ]); + $this->assertSame('Noch nicht gespeichert', $draft->summary); + $this->assertSame('Ein kurzer Teaser für die Karte', $element->fresh()->summary); + + Livewire::test(ViewContentElement::class, ['record' => $element->getKey()]) + ->set('bereich', 'vorschau') + ->set('summary', 'Noch nicht gespeichert') + ->set('previewSurface', 'bibliothek') + ->assertSee('media-card') + ->assertSee('Noch nicht gespeichert'); + } + + public function test_the_picker_keeps_drafts_for_modules_and_limits_images_and_website_choices(): void + { + $content = app(ContentService::class); + $film = $content->publishElementVersion($content->createElement('film', 'film', 'Lara im Park'), 'Film'); + $draft = $content->draftElementVersion($content->createElement('text', 'text', 'Offener Entwurf'), 'Text'); + $image = $content->createElement('bild', 'bild', 'Szenenbild'); + $image->thumbnail_path = 'vorschau/szenenbild.jpg'; + $image->save(); + $content->publishElementVersion($image, null, ['file' => 'inhalte/szenenbild.jpg']); + $module = $content->createComposition('Abstand', CompositionKind::Uebung); + $editor = $this->editor(); + $this->actingAs($editor, 'staff'); + + $modulePicker = Livewire::test(EditExercise::class, ['record' => $module->id]) + ->call('openPicker') + ->set('pickerQuery', 'Offener'); + $titles = array_column($modulePicker->instance()->pickerResult()['items'], 'title'); + $this->assertContains('Offener Entwurf', $titles); + $modulePicker->assertSee('Bestandteil auswählen')->assertSee('Offener Entwurf'); + + $page = Livewire::test(ViewContentElement::class, ['record' => $film->element->getKey()]) + ->set('pickerContext', 'bild'); + $imageTitles = array_column($page->instance()->selection()['items'], 'title'); + $this->assertContains('Szenenbild', $imageTitles); + $this->assertNotContains('Lara im Park', $imageTitles); + + $page->set('pickerContext', 'website'); + $websiteTitles = array_column($page->instance()->selection()['items'], 'title'); + $this->assertContains('Offener Entwurf', $websiteTitles); + $this->assertNotContains('Abstand', $websiteTitles); + + $target = null; + foreach ($page->instance()->selection()['items'] as $item) { + if ($item['title'] === 'Szenenbild') { + $target = $item['target']; + } + } + $page->set('pickerContext', 'bild') + ->set('pickerSelected', $target) + ->call('adoptLibraryImage') + ->assertSet('pictureFeedback', 'Vorschaubild übernommen. Es gibt keine neue Fassung. Für die Website ist es damit nicht freigegeben.'); + + $film->element->refresh(); + $this->assertSame('vorschau/szenenbild.jpg', $film->element->thumbnail_path); + $this->assertSame(1, $film->element->versions()->count()); + $this->assertSame($draft->id, $draft->fresh()->id); + } + + public function test_browsing_images_does_not_return_films(): void + { + $content = app(ContentService::class); + $content->publishElementVersion($content->createElement('film', 'film', 'Nur ein Film'), 'Film'); + $content->publishElementVersion($content->createElement('bild', 'bild', 'Nur ein Bild'), null, ['file' => 'inhalte/bild.jpg']); + + $titles = array_column( + app(EditorialCatalog::class)->browse('', 'bild', '', 0)['items'], + 'title', + ); + + $this->assertSame(['Nur ein Bild'], $titles); + } + + private function editor(): User + { + $editor = User::factory()->redakteur()->create(); + $editor->saveAppAuthenticationSecret('JBSWY3DPEHPK3PXP'); + + return $editor; + } +} diff --git a/tests/Feature/MediaLibraryTest.php b/tests/Feature/MediaLibraryTest.php new file mode 100644 index 0000000..26f320e --- /dev/null +++ b/tests/Feature/MediaLibraryTest.php @@ -0,0 +1,347 @@ +createElement('film', 'film', 'Lara im Park'); + $film->description = 'Lara spielt im Park.'; + $film->thumbnail_path = 'vorschau/element-'.$film->id.'.jpg'; + $film->thumbnail_alt = 'Lara auf dem Weg'; + $film->save(); + $content->publishElementVersion($film, 'Film'); + $content->createElement('text', 'text', 'Trainerhinweis'); + + Livewire::actingAs($this->editor(), 'staff') + ->test(ListContentElements::class) + ->assertOk() + ->assertSee('data-ansicht="liste"', false) + ->assertDontSee('data-ansicht="kacheln"', false) + ->assertDontSee('Arbeitstitel') + ->assertSee('Lara im Park') + ->assertSee('Film') + ->assertSee('Lara spielt im Park.') + ->assertSee('Fassung 1 freigegeben') + ->assertSee('Lara auf dem Weg') + ->assertSee(route('editorial.card', ['kind' => 'element', 'subject' => $film->id]), false) + ->assertSee('Trainerhinweis') + ->assertSee('Text') + ->set('suche', 'Park') + ->assertSee('Lara im Park') + ->assertDontSee('Trainerhinweis') + ->set('ansicht', 'kacheln') + ->assertSet('suche', 'Park') + ->assertSee('data-ansicht="kacheln"', false) + ->assertDontSee('data-ansicht="liste"', false) + ->assertSee('Lara im Park') + ->assertDontSee('Trainerhinweis') + ->assertSee('Ansehen') + ->assertSee('Redaktion') + ->call('resetFilters') + ->assertSet('suche', '') + ->assertSet('ansicht', 'kacheln') + ->assertSee('Trainerhinweis'); + } + + public function test_a_text_medium_is_not_shown_as_a_film_or_as_a_released_version(): void + { + $content = app(ContentService::class); + $text = $content->createElement('text', 'text', 'Felix beim Onkel'); + $content->draftElementVersion($text, 'Erst vorlesen.'); + + Livewire::actingAs($this->editor(), 'staff') + ->test(ListContentElements::class) + ->assertSee('Felix beim Onkel') + ->assertSee('Text') + ->assertSee('Entwurf, noch nicht freigegeben') + ->assertSee('data-symbol="dokument"', false) + ->assertDontSee('data-symbol="film"', false) + ->assertDontSee('Fassung 1 freigegeben') + ->assertDontSee('/redaktion/karte/', false); + } + + public function test_filters_combine_and_a_draft_stays_distinct_from_a_released_version(): void + { + $content = app(ContentService::class); + $film = $content->createElement('film', 'film', 'Felix und der Autofahrer'); + $content->publishElementVersion($film, 'Erste Fassung'); + $content->draftElementVersion($film, 'Neue Schnittfassung'); + $sheet = $content->createElement('dokument', 'document', 'Traineranleitung Abstand'); + $content->publishElementVersion($sheet, 'Bitte vorlesen.'); + $broken = $content->createElement('film', 'film', 'Unlesbare Datei'); + $content->draftElementVersion($broken, null, ['error' => 'Die Datei ließ sich nicht lesen.']); + + Livewire::actingAs($this->editor(), 'staff') + ->test(ListContentElements::class) + ->assertSee('Fassung 1 freigegeben') + ->assertSee('Entwurf offen') + ->assertDontSee('Fassung 2 freigegeben') + ->set('suche', 'Autofahrer') + ->set('art', 'film') + ->set('freigabe', 'freigegeben') + ->set('entwurf', 'offen') + ->assertSee('Felix und der Autofahrer') + ->assertDontSee('Traineranleitung Abstand') + ->assertDontSee('Unlesbare Datei') + ->set('art', 'document') + ->assertDontSee('Felix und der Autofahrer') + ->call('resetFilters') + ->set('verarbeitung', 'fehler') + ->assertSee('Unlesbare Datei') + ->assertSee('Verarbeitungsfehler') + ->assertDontSee('Felix und der Autofahrer'); + } + + public function test_a_blocked_version_does_not_mark_the_whole_medium_and_stays_findable(): void + { + $content = app(ContentService::class); + $film = $content->createElement('film', 'film', 'Lara im Park'); + $first = $content->publishElementVersion($film, 'Alt'); + $content->publishElementVersion($film, 'Neu'); + $content->block($first, 'Veraltet'); + $retired = $content->createElement('film', 'film', 'Alter Take'); + $only = $content->publishElementVersion($retired, 'Take'); + $content->block($only, 'Nicht verwenden'); + + $this->assertSame(ContentVersionStatus::Gesperrt, $first->fresh()->status); + $this->assertSame(ContentVersionStatus::Bereit, $film->versions()->where('number', 2)->first()->status); + + Livewire::actingAs($this->editor(), 'staff') + ->test(ListContentElements::class) + ->assertSee('Lara im Park') + ->assertSee('Fassung 2 freigegeben') + ->assertSee('Fassung 1 deaktiviert') + ->assertDontSee('Medium deaktiviert') + ->assertDontSee('Alter Take') + ->set('fassung', 'nur') + ->assertSee('Alter Take') + ->assertSee('Fassung 1 deaktiviert') + ->assertDontSee('Lara im Park'); + } + + public function test_usage_follows_older_versions_to_the_module_and_the_program(): void + { + $content = app(ContentService::class); + $film = $content->createElement('film', 'film', 'Felix beim Onkel'); + $first = $content->publishElementVersion($film, 'Erste Fassung'); + $content->publishElementVersion($film, 'Zweite Fassung'); + $module = $content->publishComposition( + $content->createComposition('Abstand üben', CompositionKind::Uebung), + [['role' => 'Film', 'target' => $first]], + ); + $program = $content->publishComposition( + $content->createComposition('Vormittag', CompositionKind::Kurs), + [['role' => 'Film', 'target' => $first]], + ); + $moduleUrl = ExerciseResource::getUrl('edit', ['record' => $module->composition_id]); + $programUrl = CourseResource::getUrl('edit', ['record' => $program->composition_id]); + + Livewire::actingAs($this->editor(), 'staff') + ->test(ListContentElements::class) + ->assertSee('2 Verwendungen') + ->assertSee('Modul') + ->assertSee('Programm') + ->assertSee('Abstand üben') + ->assertSee('Vormittag') + ->assertSee('Medium Fassung 1', false) + ->assertSee($moduleUrl, false) + ->assertSee($programUrl, false); + + $this->assertSame($first->id, $module->members()->first()->content_element_version_id); + $this->assertSame($first->id, $program->members()->first()->content_element_version_id); + $this->assertSame(2, $film->versions()->count()); + } + + public function test_a_license_article_is_not_treated_as_library_access_or_as_usage(): void + { + $content = app(ContentService::class); + $sheet = $content->publishElementVersion( + $content->createElement('text', 'text', 'Merkblatt Grenzen'), + 'Den Abstand ansprechen.', + ); + $article = app(ArticleService::class)->create('grenzen-'.str()->lower(str()->random(4))); + app(ArticleService::class)->publishRelease($article, $sheet, 'Dieselbe Ausgabe.'); + + Livewire::actingAs($this->editor(), 'staff') + ->test(ListContentElements::class) + ->assertSee('In keinem Modul oder Programm verwendet') + ->assertSee('Im Lizenzartikel '.$article->code.' genannt. Das belegt keinen Zugriff in der Bibliothek.') + ->set('nutzung', 'verwendet') + ->assertDontSee('Merkblatt Grenzen') + ->set('nutzung', 'unbenutzt') + ->assertSee('Merkblatt Grenzen'); + } + + public function test_a_pending_file_is_not_shown_as_released_and_archived_media_stay_behind_a_filter(): void + { + Queue::fake(); + $content = app(ContentService::class); + $film = $content->createElement('film', 'film', 'Felix und der Autofahrer'); + $content->draftElementVersion($film, null, ['incoming' => 'inhalte/fahrer.mp4', 'hold' => true]); + $archived = $content->createElement('text', 'text', 'Alte Anleitung'); + $content->publishElementVersion($archived, 'Text'); + $archived->archived_at = now(); + $archived->save(); + + Livewire::actingAs($this->editor(), 'staff') + ->test(ListContentElements::class) + ->assertSee('Datei wird übernommen') + ->assertSee('Entwurf, noch nicht freigegeben') + ->assertDontSee('Alte Anleitung') + ->set('archiv', 'archiviert') + ->assertSee('Alte Anleitung') + ->assertSee('Archiviert') + ->assertDontSee('Felix und der Autofahrer'); + } + + public function test_pillar_and_classification_filters_narrow_the_same_library(): void + { + $content = app(ContentService::class); + $film = $content->createElement('film', 'film', 'Lara im Park'); + $content->publishElementVersion($film, 'Film'); + $other = $content->createElement('text', 'text', 'Ohne Säule'); + $content->publishElementVersion($other, 'Text'); + $pillar = app(PillarService::class)->create('Meine Grenzen'); + app(PillarService::class)->assign($film, [$pillar->id]); + $dimension = EditorialDimension::query()->where('slug', 'zielgruppe')->firstOrFail(); + $value = $dimension->values()->create(['slug' => 'grundschule', 'label' => 'Grundschule']); + app(IdentityDimension::class)->assign($film, $value); + + Livewire::actingAs($this->editor(), 'staff') + ->test(ListContentElements::class) + ->set('saeule', (string) $pillar->id) + ->assertSee('Lara im Park') + ->assertDontSee('Ohne Säule') + ->set('saeule', '') + ->set('einordnung', (string) $value->id) + ->assertSee('Lara im Park') + ->assertDontSee('Ohne Säule'); + } + + public function test_a_catalog_keeper_can_open_the_library_but_cannot_edit(): void + { + app(ContentService::class)->publishElementVersion( + app(ContentService::class)->createElement('text', 'text', 'Hinweis'), + 'Text', + ); + $keeper = User::factory()->katalogverwalter()->create(); + $keeper->saveAppAuthenticationSecret('JBSWY3DPEHPK3PXP'); + + Livewire::actingAs($keeper, 'staff') + ->test(ListContentElements::class) + ->assertOk() + ->assertSee('Hinweis') + ->assertSee('Ansehen') + ->assertDontSee('redaktion=1') + ->assertDontSee('Medium anlegen'); + } + + public function test_usage_counts_are_loaded_without_a_query_per_card(): void + { + $content = app(ContentService::class); + + foreach (['Lara im Park', 'Felix beim Onkel', 'Felix und der Autofahrer'] as $title) { + $version = $content->publishElementVersion($content->createElement('film', 'film', $title), 'Film'); + $content->publishComposition( + $content->createComposition('Modul '.$title, CompositionKind::Uebung), + [['role' => 'Film', 'target' => $version]], + ); + } + + DB::flushQueryLog(); + DB::enableQueryLog(); + $cards = app(MediaLibrary::class)->cards([ + 'suche' => '', + 'art' => '', + 'freigabe' => '', + 'entwurf' => '', + 'fassung' => '', + 'nutzung' => '', + 'saeule' => '', + 'einordnung' => '', + 'verarbeitung' => '', + 'archiv' => 'aktiv', + ], true); + $queries = count(DB::getQueryLog()); + + $this->assertCount(3, $cards); + $this->assertSame(1, $cards[0]['usageCount']); + $this->assertLessThan(12, $queries); + } + + public function test_an_editor_can_open_a_medium_from_the_library(): void + { + $element = app(ContentService::class)->createElement('film', 'film', 'Lara im Park'); + app(ContentService::class)->publishElementVersion($element, 'Film'); + $editor = $this->editor(); + + $this->actingAs($editor, 'staff') + ->get(ContentElementResource::getUrl('index')) + ->assertOk() + ->assertSee(ContentElementResource::getUrl('view', ['record' => $element]), false) + ->assertSee(e(ContentElementResource::getUrl('view', ['record' => $element, 'redaktion' => 1])), false); + + $this->actingAs($editor, 'staff') + ->get(ContentElementResource::getUrl('edit', ['record' => $element])) + ->assertRedirect(ContentElementResource::getUrl('view', ['record' => $element, 'redaktion' => 1])); + } + + public function test_the_create_medium_dialog_has_a_place_to_open_on_the_library_page(): void + { + $editor = $this->editor(); + + // Die Medienliste ersetzt die Filament-Tabelle, die sonst den Dialogbereich der Seite ausgibt. Ohne eigenen + // Bereich wurde „Medium anlegen“ zwar geöffnet, aber nie angezeigt. + Livewire::actingAs($editor, 'staff') + ->test(ListContentElements::class) + ->assertSee('Medium anlegen') + ->assertSeeHtml('wire:partial="action-modals"') + ->mountAction('create') + ->assertActionMounted('create') + ->fillForm(['working_title' => 'Neuer Prüftext', 'shape' => 'text', 'body' => 'Wortlaut']) + ->callMountedAction() + ->assertHasNoFormErrors(); + + $this->assertDatabaseHas('content_elements', ['working_title' => 'Neuer Prüftext']); + } + + private function editor(): User + { + $editor = User::factory()->redakteur()->create(); + $editor->saveAppAuthenticationSecret('JBSWY3DPEHPK3PXP'); + + return $editor; + } +} diff --git a/tests/Feature/MediaReleaseTest.php b/tests/Feature/MediaReleaseTest.php new file mode 100644 index 0000000..aa2d9ec --- /dev/null +++ b/tests/Feature/MediaReleaseTest.php @@ -0,0 +1,226 @@ +put('inhalte/bild.png', $png); + + $content = app(ContentService::class); + $element = $content->createElement('bild', 'bild', 'Kartenbild'); + $version = $content->publishElementVersion($element, null, ['file' => 'inhalte/bild.png']); + $hash = $version->content_hash; + + app(ThumbnailDeriver::class)->forElement($element->fresh()); + + $element->refresh(); + $version->refresh(); + $this->assertSame(1, $element->versions()->count()); + $this->assertSame($hash, $version->content_hash); + $this->assertStringStartsWith('vorschau/element-'.$element->id, (string) $element->thumbnail_path); + Storage::disk('media_derived')->assertExists($element->thumbnail_path); + $this->get('/medien/'.$element->thumbnail_path)->assertNotFound(); + + [$article, $offer, $release] = $this->offerFor($version, ['bild' => ['ansehen']]); + $member = User::factory()->create(); + $stranger = User::factory()->create(); + app(GrantIssuer::class)->claim($member, $offer); + + $this->actingAs($member) + ->get(route('member.thumbnail', ['kind' => 'element', 'subject' => $element->id])) + ->assertOk(); + $this->actingAs($stranger) + ->get(route('member.thumbnail', ['kind' => 'element', 'subject' => $element->id])) + ->assertForbidden(); + $this->assertNotNull($release); + $this->assertNotNull($article); + } + + public function test_adaptive_playback_keeps_the_source_file_and_the_permission_split(): void + { + Storage::fake('media_derived'); + Storage::disk('media_derived')->put('inhalte/hof.mp4', 'filmbytes'); + $content = app(ContentService::class); + $film = $content->publishElementVersion( + $content->createElement('film', 'film', 'Hofszene'), + null, + ['file' => 'inhalte/hof.mp4'], + ); + $hash = $film->content_hash; + [$article, $offer, $release] = $this->offerFor($film, ['film' => ['streamen', 'laden']]); + $member = User::factory()->create(); + app(GrantIssuer::class)->claim($member, $offer); + + $progressive = SignedLink::temporary('member.media', now()->addMinutes(5), [ + 'article' => $article->id, + 'release' => $release->id, + 'version' => $film->id, + 'action' => 'streamen', + 'reader' => $member->id, + ]); + $this->actingAs($member)->get($progressive)->assertOk()->assertStreamedContent('filmbytes'); + + $this->app->instance(FilmTranscoder::class, new class implements FilmTranscoder + { + public function available(): bool + { + return true; + } + + public function derive(int $versionId, string $sourceRelative): array + { + $base = 'ableitungen/'.$versionId; + Storage::disk('media_derived')->put($base.'/480/index.m3u8', "#EXTM3U\n#EXTINF:6.0,\nsegment.ts\n"); + Storage::disk('media_derived')->put($base.'/480/segment.ts', 'segment-bytes'); + Storage::disk('media_derived')->put($base.'/master.m3u8', "#EXTM3U\n#EXT-X-STREAM-INF:BANDWIDTH=800000\n480/index.m3u8\n"); + + return [ + ['role' => 'variant', 'label' => '480', 'path' => $base.'/480/index.m3u8'], + ['role' => 'master', 'label' => 'master', 'path' => $base.'/master.m3u8'], + ]; + } + }); + app(DeriveFilmRenditions::class, ['versionId' => $film->id])->handle(app(FilmTranscoder::class)); + + $film->refresh(); + $this->assertSame($hash, $film->content_hash); + $playlist = $this->actingAs($member)->get($progressive)->assertOk(); + $playlist->assertHeader('content-type', 'application/vnd.apple.mpegurl'); + $this->assertStringContainsString('abschnitt', $playlist->getContent()); + + $variant = SignedLink::temporary('member.rendition', now()->addMinutes(5), [ + 'article' => $article->id, + 'release' => $release->id, + 'version' => $film->id, + 'datei' => 'ableitungen/'.$film->id.'/480/segment.ts', + 'reader' => $member->id, + ]); + $this->actingAs($member)->get($variant)->assertOk()->assertStreamedContent('segment-bytes'); + + $foreign = SignedLink::temporary('member.rendition', now()->addMinutes(5), [ + 'article' => $article->id, + 'release' => $release->id, + 'version' => $film->id, + 'datei' => 'ableitungen/999/master.m3u8', + 'reader' => $member->id, + ]); + $this->actingAs($member)->get($foreign)->assertNotFound(); + + $download = SignedLink::temporary('member.media', now()->addMinutes(5), [ + 'article' => $article->id, + 'release' => $release->id, + 'version' => $film->id, + 'action' => 'laden', + 'reader' => $member->id, + ]); + $this->actingAs($member)->get($download)->assertOk()->assertStreamedContent('filmbytes'); + + $watchRights = app(OfferService::class)->createRightsProfile('Nur ansehen '.str()->random(4), 'ehrenamtlich', [ + 'film' => ['streamen'], + ]); + $watchOffer = app(OfferService::class)->create('Nur Stream '.str()->random(4)); + app(OfferService::class)->activate($watchOffer, [ + ['target' => $article->fresh(), 'rights' => $watchRights], + ], ['grant_kind' => 'auf_abruf']); + $watchOnly = User::factory()->create(); + app(GrantIssuer::class)->claim($watchOnly, $watchOffer); + $deniedDownload = SignedLink::temporary('member.media', now()->addMinutes(5), [ + 'article' => $article->id, + 'release' => $release->id, + 'version' => $film->id, + 'action' => 'laden', + 'reader' => $watchOnly->id, + ]); + $before = MediaDelivery::query()->count(); + $this->actingAs($watchOnly)->get($deniedDownload)->assertForbidden(); + $this->assertSame($before, MediaDelivery::query()->count()); + } + + public function test_a_document_view_is_marked_and_two_grants_stay_separate(): void + { + $content = app(ContentService::class); + $sheet = $content->publishElementVersion( + $content->createElement('text', 'document', 'Merkblatt'), + 'Erst vorlesen.', + ); + [$article, $offer, $release] = $this->offerFor($sheet, ['document' => ['ansehen']]); + $second = app(OfferService::class); + $otherRights = $second->createRightsProfile('Nur ansehen', 'ehrenamtlich', ['document' => ['ansehen']]); + $otherOffer = $second->create('Zweites Angebot'); + $second->activate($otherOffer, [ + ['target' => $article->fresh(), 'rights' => $otherRights], + ], ['grant_kind' => 'auf_abruf']); + $member = User::factory()->create(['name' => 'Trainer Prüfung']); + app(GrantIssuer::class)->claim($member, $offer); + app(GrantIssuer::class)->claim($member, $otherOffer); + $snapshots = Grant::query()->orderBy('id')->pluck('rights_snapshot', 'id')->all(); + + $url = SignedLink::temporary('member.media', now()->addMinutes(5), [ + 'article' => $article->id, + 'release' => $release->id, + 'version' => $sheet->id, + 'action' => 'ansehen', + 'reader' => $member->id, + ]); + $this->actingAs($member)->get($url)->assertOk()->assertSee('Lizenziert für Trainer Prüfung')->assertSee('Lizenzkopie'); + + $this->assertSame(1, MediaDelivery::query()->count()); + $delivery = MediaDelivery::query()->first(); + $this->assertSame('k2', $delivery->marking); + $this->assertNotNull($delivery->checksum); + $this->assertContains($delivery->grant_id, array_keys($snapshots)); + $this->assertSame($snapshots, Grant::query()->orderBy('id')->pluck('rights_snapshot', 'id')->all()); + + $stranger = User::factory()->create(); + $this->actingAs($stranger)->get($url)->assertForbidden(); + $this->assertSame(1, MediaDelivery::query()->count()); + + $catalog = app(LibraryCatalog::class)->index($member); + $this->assertCount(1, array_filter($catalog['materials'], fn (array $card): bool => $card['title'] === 'Merkblatt')); + } + + /** + * @param array> $capabilities + * @return array{0: mixed, 1: mixed, 2: mixed} + */ + private function offerFor($version, array $capabilities): array + { + $articles = app(ArticleService::class); + $offers = app(OfferService::class); + $article = $articles->create('ausgabe-'.str()->random(6)); + $release = $articles->publishRelease($article, $version, 'Stand.'); + $rights = $offers->createRightsProfile('Rechte '.str()->random(4), 'ehrenamtlich', $capabilities); + $offer = $offers->create('Angebot '.str()->random(4)); + $offers->activate($offer, [ + ['target' => $article->fresh(), 'rights' => $rights], + ], ['grant_kind' => 'auf_abruf']); + + return [$article->fresh(), $offer, $release]; + } +} diff --git a/tests/Feature/MembershipAccessTest.php b/tests/Feature/MembershipAccessTest.php new file mode 100644 index 0000000..55ef7e5 --- /dev/null +++ b/tests/Feature/MembershipAccessTest.php @@ -0,0 +1,187 @@ +freeOffer(); + $member = User::factory()->create(); + $other = User::factory()->create(); + $issuer = app(GrantIssuer::class); + + $first = $issuer->claim($member, $offer); + $again = $issuer->claim($member, $offer); + $issuer->claim($other, $offer); + + $this->assertSame($first->id, $again->id); + $this->assertSame(2, Acquisition::query()->count()); + $this->assertSame(1, Grant::query()->where('acquisition_id', $first->id)->count()); + $this->assertTrue(app(DecideAccess::class)( + $member, + $article, + $article->currentRelease, + $article->currentRelease->contents->first()->elementVersion, + 'ansehen', + )->allowed); + } + + public function test_a_grant_does_not_open_a_foreign_release(): void + { + [$article, $offer] = $this->freeOffer(); + $foreign = app(ArticleService::class); + $content = app(ContentService::class); + $otherArticle = $foreign->create('fremd'); + $version = $content->publishElementVersion($content->createElement('text', 'text', 'Fremd'), 'Nicht enthalten'); + $release = $foreign->publishRelease($otherArticle, $version, 'Eigenständiger Artikel.'); + $member = User::factory()->create(); + app(GrantIssuer::class)->claim($member, $offer); + + $decision = app(DecideAccess::class)( + $member, + $article, + $release, + $version, + 'ansehen', + ); + + $this->assertFalse($decision->allowed); + } + + public function test_test_payment_grants_once_and_a_failure_grants_nothing(): void + { + Mail::fake(); + [$article, $offer] = $this->paidOffer(); + $member = User::factory()->create(); + $checkout = app(Checkout::class); + $order = $checkout->place($member, $offer); + $checkout->confirmTestPayment($order, 'test-1'); + $checkout->confirmTestPayment($order->fresh(), 'test-2'); + + $this->assertSame(1, Grant::query()->where('license_article_id', $article->id)->count()); + Mail::assertSent(OrderConfirmed::class, 1); + + $second = $checkout->place($member, $offer); + $checkout->failTestPayment($second, 'test-fail-1'); + + $this->assertSame('fehlgeschlagen', $second->fresh()->status); + $this->assertSame(1, Grant::query()->count()); + } + + public function test_a_member_can_read_an_entitled_text_and_a_stranger_cannot(): void + { + Storage::fake('media_derived'); + Storage::disk('media_derived')->put('inhalte/demo.txt', 'geschuetzter text'); + [$article, $offer] = $this->freeOffer(file: 'inhalte/demo.txt'); + $member = User::factory()->create(); + $stranger = User::factory()->create(); + app(GrantIssuer::class)->claim($member, $offer); + $release = $article->currentRelease; + $version = $release->contents->first()->elementVersion; + + $this->actingAs($member)->get(route('member.article', $article))->assertOk()->assertSee($article->code); + $url = SignedLink::temporary('member.media', now()->addMinutes(5), [ + 'article' => $article->id, + 'release' => $release->id, + 'version' => $version->id, + 'action' => 'ansehen', + 'reader' => $member->id, + ]); + $response = $this->actingAs($member)->get($url); + $response->assertOk(); + $this->assertSame('geschuetzter text', $response->streamedContent()); + $this->actingAs($stranger)->get($url)->assertForbidden(); + } + + public function test_demo_catalog_can_be_seeded_twice(): void + { + $this->seed(DemoCatalogSeeder::class); + $this->seed(DemoCatalogSeeder::class); + + $this->assertSame(1, LicenseArticle::query()->where('code', 'demo-merkblatt')->count()); + $this->assertSame(1, Offer::query()->where('name', 'Testkauf Programm')->count()); + } + + public function test_refund_revokes_the_grant(): void + { + Mail::fake(); + [, $offer] = $this->paidOffer(); + $member = User::factory()->create(); + $checkout = app(Checkout::class); + $order = $checkout->place($member, $offer); + $checkout->confirmTestPayment($order, 'test-refund'); + $checkout->refund($order->fresh(), 'Testwiderruf'); + + $this->assertSame(GrantStatus::Widerrufen, Grant::query()->first()->status); + } + + /** + * @return array{0: LicenseArticle, 1: Offer} + */ + private function freeOffer(?string $file = null): array + { + return $this->offer('auf_abruf', null, $file); + } + + /** + * @return array{0: LicenseArticle, 1: Offer} + */ + private function paidOffer(): array + { + return $this->offer('kauf', 500); + } + + /** + * @return array{0: LicenseArticle, 1: Offer} + */ + private function offer(string $kind, ?int $price, ?string $file = null): array + { + $content = app(ContentService::class); + $articles = app(ArticleService::class); + $offers = app(OfferService::class); + $metadata = $file === null ? [] : ['file' => $file]; + $body = $file === null ? 'Lesetext' : null; + $version = $content->publishElementVersion( + $content->createElement('text', 'text', 'Blatt '.$kind), + $body, + $metadata, + ); + $article = $articles->create('artikel-'.$kind.'-'.($file === null ? 'text' : 'datei')); + $articles->publishRelease($article, $version, 'Testdaten, kein Produktpreis.'); + $rights = $offers->createRightsProfile('Lesen '.$kind, 'ehrenamtlich', [ + 'text' => ['ansehen', 'laden'], + ]); + $offer = $offers->create('Angebot '.$kind); + $offers->activate($offer, [ + ['target' => $article->fresh(), 'rights' => $rights], + ], [ + 'grant_kind' => $kind, + 'price_cents' => $price, + ]); + + return [$article->fresh(), $offer]; + } +} diff --git a/tests/Feature/OfferActivationParallelTest.php b/tests/Feature/OfferActivationParallelTest.php new file mode 100644 index 0000000..ecb411b --- /dev/null +++ b/tests/Feature/OfferActivationParallelTest.php @@ -0,0 +1,107 @@ +databasePath = sys_get_temp_dir().DIRECTORY_SEPARATOR.'luf_parallel_'.Str::uuid()->toString().'.sqlite'; + touch($this->databasePath); + + config(['database.connections.sqlite.database' => $this->databasePath]); + DB::purge('sqlite'); + DB::reconnect('sqlite'); + Artisan::call('migrate', ['--force' => true]); + } + + protected function tearDown(): void + { + if ($this->databasePath !== null && is_file($this->databasePath)) { + @unlink($this->databasePath); + } + + config(['database.connections.sqlite.database' => ':memory:']); + DB::purge('sqlite'); + + parent::tearDown(); + } + + public function test_overlapping_activations_leave_exactly_one_active_version(): void + { + [$article, $rights, $offer] = $this->offerWithArticle(); + + $baseEnv = [ + 'APP_ENV' => 'testing', + 'APP_KEY' => config('app.key'), + 'DB_CONNECTION' => 'sqlite', + 'DB_DATABASE' => $this->databasePath, + 'CACHE_STORE' => 'array', + 'QUEUE_CONNECTION' => 'sync', + 'SESSION_DRIVER' => 'array', + ]; + + $worker = base_path('tests/Support/offer_activate_worker.php'); + + $results = Process::pool(function ($pool) use ($baseEnv, $worker, $offer, $article, $rights): void { + $pool->as('a') + ->path(base_path()) + ->env($baseEnv) + ->timeout(120) + ->command([PHP_BINARY, $worker, $this->databasePath, (string) $offer->id, (string) $article->id, (string) $rights->id, '1000', '80']); + $pool->as('b') + ->path(base_path()) + ->env($baseEnv) + ->timeout(120) + ->command([PHP_BINARY, $worker, $this->databasePath, (string) $offer->id, (string) $article->id, (string) $rights->id, '2000', '0']); + })->start()->wait(); + + $this->assertTrue($results['a']->successful(), $results['a']->errorOutput()); + $this->assertTrue($results['b']->successful(), $results['b']->errorOutput()); + + $active = OfferVersion::query()->where('offer_id', $offer->id)->where('status', OfferStatus::Aktiv)->get(); + $this->assertCount(1, $active); + + $versions = OfferVersion::query()->where('offer_id', $offer->id)->orderBy('number')->get(); + $this->assertCount(2, $versions); + $this->assertSame(OfferStatus::Beendet, $versions->first()->status); + $this->assertContains($versions->last()->price_cents, [1000, 2000]); + $this->assertNotSame($versions->first()->price_cents, $versions->last()->price_cents); + } + + /** + * @return array{0: LicenseArticle, 1: RightsProfileVersion, 2: Offer} + */ + private function offerWithArticle(): array + { + $content = app(ContentService::class); + $version = $content->publishElementVersion($content->createElement('text', 'text', 'Basis'), 'Basis'); + $article = app(ArticleService::class)->publishRelease( + app(ArticleService::class)->create('parallel-basis'), + $version, + 'Paralleltest.', + )->article->fresh(); + $rights = app(OfferService::class)->createRightsProfile('Lesen', 'ehrenamtlich', ['text' => ['ansehen']]); + $offer = app(OfferService::class)->create('Parallelangebot'); + + return [$article, $rights, $offer]; + } +} diff --git a/tests/Feature/OfferVersioningTest.php b/tests/Feature/OfferVersioningTest.php new file mode 100644 index 0000000..af3bcb4 --- /dev/null +++ b/tests/Feature/OfferVersioningTest.php @@ -0,0 +1,170 @@ +offerWithArticle(); + $offers = app(OfferService::class); + + $first = $offers->activate($offer, [ + ['target' => $article, 'rights' => $rights], + ], ['grant_kind' => 'kauf', 'price_cents' => 500]); + + $second = $offers->activate($offer, [ + ['target' => $article, 'rights' => $rights], + ], ['grant_kind' => 'kauf', 'price_cents' => 900]); + + $first->refresh(); + $second->refresh(); + + $this->assertSame(OfferStatus::Beendet, $first->status); + $this->assertSame(500, $first->price_cents); + $this->assertSame(OfferStatus::Aktiv, $second->status); + $this->assertSame(1, OfferVersion::query()->where('offer_id', $offer->id)->where('status', OfferStatus::Aktiv)->count()); + } + + public function test_an_active_version_cannot_change_except_to_beendet(): void + { + [, $rights, $offer] = $this->offerWithArticle(); + $version = app(OfferService::class)->activate($offer, [ + ['target' => $this->publishedArticle('preis', 'Preis'), 'rights' => $rights], + ], ['grant_kind' => 'kauf', 'price_cents' => 100]); + + $version->price_cents = 200; + + $this->expectException(DomainRuleException::class); + $version->save(); + } + + public function test_registration_uses_only_the_highest_active_duplicate_version(): void + { + [, $rights, $offer] = $this->offerWithArticle(); + $offers = app(OfferService::class); + $low = $offers->activate($offer, [ + ['target' => $this->publishedArticle('reg-a', 'Reg A'), 'rights' => $rights], + ], ['grant_kind' => 'bei_registrierung']); + + $high = OfferVersion::query()->create([ + 'offer_id' => $offer->id, + 'number' => $low->number + 1, + 'status' => OfferStatus::Aktiv, + 'term_rule' => $low->term_rule, + 'update_promise' => $low->update_promise, + 'dynamic' => false, + 'grant_kind' => 'bei_registrierung', + 'holder_kind' => 'person', + 'activated_at' => now(), + ]); + + $user = User::factory()->create(); + app(GrantIssuer::class)->grantRegistrationOffers($user); + + $acquisitions = Acquisition::query() + ->where('party_id', $user->party_id) + ->where('reference_type', 'offer') + ->where('reference_id', $offer->id) + ->get(); + + $this->assertCount(1, $acquisitions); + $this->assertSame($high->id, (int) ($acquisitions->first()->conditions['offer_version_id'] ?? 0)); + + app(GrantIssuer::class)->grantRegistrationOffers($user); + $this->assertSame(1, Acquisition::query()->where('party_id', $user->party_id)->where('reference_id', $offer->id)->count()); + } + + public function test_order_line_stores_offer_name_and_keeps_it_when_the_offer_is_renamed(): void + { + [, $rights, $offer] = $this->offerWithArticle(); + $offers = app(OfferService::class); + $offers->activate($offer, [ + ['target' => $this->publishedArticle('kauf', 'Kauf'), 'rights' => $rights], + ], ['grant_kind' => 'kauf', 'price_cents' => 1200]); + + $member = User::factory()->create(); + $order = app(Checkout::class)->place($member, $offer); + $line = $order->lines()->first(); + + $this->assertSame('Testangebot', $line->offer_name); + + $offer->update(['name' => 'Umbenannt']); + + $response = $this->actingAs($member)->get(route('member.order', $order)); + + $response->assertOk()->assertSee('Testangebot')->assertDontSee('Umbenannt'); + } + + public function test_an_existing_grant_keeps_snapshot_and_release_reference(): void + { + [$article, $rights, $offer] = $this->offerWithArticle(); + app(OfferService::class)->activate($offer, [ + ['target' => $article, 'rights' => $rights], + ], ['grant_kind' => 'auf_abruf']); + + $member = User::factory()->create(); + app(GrantIssuer::class)->claim($member, $offer); + $grant = Grant::query()->first(); + $snapshot = $grant->rights_snapshot; + $releaseId = $grant->release_at_grant_id; + + app(OfferService::class)->activate($offer, [ + ['target' => $article, 'rights' => $rights], + ], ['grant_kind' => 'auf_abruf']); + + $grant->refresh(); + $this->assertSame($snapshot, $grant->rights_snapshot); + $this->assertSame($releaseId, $grant->release_at_grant_id); + } + + /** + * @return array{0: LicenseArticle, 1: RightsProfileVersion, 2: Offer} + */ + private function offerWithArticle(): array + { + $article = $this->publishedArticle('basis', 'Basis'); + $rights = $this->rights(); + $offer = app(OfferService::class)->create('Testangebot'); + + return [$article, $rights, $offer]; + } + + private function publishedArticle(string $code, string $title): LicenseArticle + { + $content = app(ContentService::class); + $version = $content->publishElementVersion($content->createElement('text', 'text', $title), $title); + + return app(ArticleService::class)->publishRelease( + app(ArticleService::class)->create($code), + $version, + 'Testartikel.', + )->article->fresh(); + } + + private function rights(): RightsProfileVersion + { + return app(OfferService::class)->createRightsProfile('Lesen', 'ehrenamtlich', [ + 'text' => ['ansehen'], + ]); + } +} diff --git a/tests/Feature/PillarAssignmentTest.php b/tests/Feature/PillarAssignmentTest.php new file mode 100644 index 0000000..71670ac --- /dev/null +++ b/tests/Feature/PillarAssignmentTest.php @@ -0,0 +1,74 @@ +create('Grenzen'); + $hilfe = $pillars->create('Hilfe holen'); + $pillars->create('Alltag'); + $content = app(ContentService::class); + $filmElement = $content->createElement('film', 'film', 'Film'); + $film = $content->publishElementVersion($filmElement, 'Text'); + $sheet = $content->publishElementVersion($content->createElement('pdf', 'pdf', 'Blatt'), 'Hinweis'); + $pillars->assign($filmElement, [$hilfe->id, $grenzen->id]); + $pillars->assign($sheet->element, [$grenzen->id]); + + $this->assertSame(1, $filmElement->versions()->count()); + $this->assertSame(['Grenzen', 'Hilfe holen'], $filmElement->pillars()->pluck('name')->all()); + + $exercise = $content->publishComposition( + $content->createComposition('Übung Grenzen', CompositionKind::Uebung), + [ + ['role' => 'Film', 'target' => $film], + ['role' => 'Blatt', 'target' => $sheet], + ], + ); + $course = $content->publishComposition( + $content->createComposition('Kurs Alltag', CompositionKind::Kurs), + [['role' => 'Übung', 'target' => $exercise]], + ); + + $this->assertSame([ + 'Film — Grenzen, Hilfe holen', + 'Blatt — Grenzen', + ], app(CatalogReading::class)->memberPillars($course->composition)); + + $editor = User::factory()->redakteur()->create(); + $editor->saveAppAuthenticationSecret('JBSWY3DPEHPK3PXP'); + + $this->actingAs($editor, 'staff') + ->get(PillarResource::getUrl('index')) + ->assertOk() + ->assertSee('Grenzen') + ->assertSee('Alltag') + ->assertSee('Themenbereich der Website'); + } + + public function test_a_pillar_with_media_cannot_be_deleted(): void + { + $pillars = app(PillarService::class); + $pillar = $pillars->create('Grenzen'); + $element = app(ContentService::class)->createElement('text', 'text', 'Hinweis'); + $pillars->assign($element, [$pillar->id]); + + $this->expectException(DomainRuleException::class); + + $pillars->delete($pillar); + } +} diff --git a/tests/Feature/PresentationMediaTest.php b/tests/Feature/PresentationMediaTest.php new file mode 100644 index 0000000..ba90afa --- /dev/null +++ b/tests/Feature/PresentationMediaTest.php @@ -0,0 +1,269 @@ +createComposition('Programm mit Teaser', CompositionKind::Kurs); + $program->editorial_content_kind_id = EditorialContentKind::query()->where('slug', 'programm')->value('id'); + $program->display_title = 'Name aus der Redaktion'; + $program->teaser = 'Teaser aus der Redaktion'; + $program->description = 'Interne Langfassung'; + $program->save(); + $version = $content->publishComposition($program, [[ + 'role' => 'Text', + 'target' => $content->publishElementVersion($content->createElement('text', 'text', 'Blatt'), 'Inhalt'), + ]]); + app(CompositionDisplayRelease::class)->release($version, User::factory()->create()); + + $image = $this->store('bild', 'Pruefbild ohne Fassung', 'bild-bytes'); + $teaser = $this->store('film', 'Teaser ohne Fassung', 'teaser-bytes'); + $editor = User::factory()->redakteur()->create(); + $editor->saveAppAuthenticationSecret('JBSWY3DPEHPK3PXP'); + $this->actingAs($editor, 'staff'); + + $found = app(EditorialCatalog::class)->presentationBrowse('ohne Fassung'); + $targets = array_column($found['items'], 'target'); + $this->assertContains('medium:'.$image->id, $targets); + $this->assertContains('medium:'.$teaser->id, $targets); + + $didactic = app(EditorialCatalog::class)->browse('ohne Fassung', 'alle', '', $program->id); + $this->assertNotContains('medium:'.$image->id, array_column($didactic['items'], 'target')); + $this->assertNotContains('medium:'.$teaser->id, array_column($didactic['items'], 'target')); + + Livewire::test(EditCourse::class, ['record' => $program->getKey()]) + ->call('openRedaktion', 'medien') + ->call('openPresentationPicker', 'titelbild') + ->set('pickerQuery', 'Pruefbild ohne') + ->assertSee('Pruefbild ohne Fassung') + ->call('assignFromPicker', 'medium:'.$image->id) + ->call('openPresentationPicker', 'trailer') + ->set('pickerQuery', 'Teaser ohne') + ->set('bindToVersion', false) + ->call('assignFromPicker', 'medium:'.$teaser->id) + ->call('saveRedaktion') + ->assertSee('Pruefbild ohne Fassung') + ->assertSee('Teaser ohne Fassung') + ->assertDontSee('Gebunden an Fassung'); + + $this->assertSame(0, $image->fresh()->versions()->count()); + $this->assertSame(0, $teaser->fresh()->versions()->count()); + $this->assertSame(1, $program->fresh()->versions()->count()); + $this->assertSame(0, Grant::query()->count()); + $this->assertNull(PresentationAssignment::query()->where('content_element_id', $image->id)->value('source_version_id')); + $this->assertNull(PresentationAssignment::query()->where('content_element_id', $teaser->id)->value('source_version_id')); + $this->assertSame(1, CompositionMember::query()->where('composition_version_id', $version->id)->count()); + + app(WebsiteRelease::class)->release($image->fresh()); + app(WebsiteRelease::class)->release($teaser->fresh()); + $image->refresh(); + $teaser->refresh(); + $this->assertNotNull($image->website_released_at); + $this->assertNotNull($teaser->website_released_at); + $this->assertSame(0, $image->versions()->count()); + $this->assertSame(0, $teaser->versions()->count()); + $this->assertSame(0, Grant::query()->count()); + Storage::disk('media_public')->assertExists($image->website_public_path); + Storage::disk('media_public')->assertExists($teaser->website_public_path); + $this->assertStringNotContainsString('originals', (string) $teaser->website_public_path); + + $this->publish('/praesentation-ohne-fassung', [[ + 'layout' => 'u2_2', + 'style' => [], + 'slots' => [ + $this->card('program_card', ['composition' => $program->id]), + $this->card('program_card', ['composition' => $program->id], ['heading' => 'Nur diese Karte']), + ], + ]]); + + $this->get('/praesentation-ohne-fassung')->assertOk() + ->assertSee('Name aus der Redaktion') + ->assertSee('Teaser aus der Redaktion') + ->assertSee('Nur diese Karte') + ->assertSee('/website-medien/'.$image->id, false) + ->assertDontSee('Interne Langfassung'); + + $film = app(WebsiteMedia::class)->present($teaser); + $this->assertNotNull($film); + $this->assertSame('film', $film->kind); + $this->get($film->url)->assertOk()->assertStreamedContent('teaser-bytes'); + + $program->teaser = 'Teaser nach der zentralen Änderung'; + $program->save(); + $this->app->forgetInstance(WebsiteImage::class); + $this->get('/praesentation-ohne-fassung')->assertOk() + ->assertSee('Teaser nach der zentralen Änderung') + ->assertSee('Nur diese Karte') + ->assertDontSee('Teaser aus der Redaktion'); + + app(WebsiteRelease::class)->withdraw($image->fresh()); + app(WebsiteRelease::class)->withdraw($teaser->fresh()); + $this->app->forgetInstance(WebsiteImage::class); + + $after = $this->get('/praesentation-ohne-fassung')->assertOk()->getContent(); + $this->assertStringNotContainsString('/website-medien/'.$image->id, $after); + $this->assertStringContainsString('Teaser nach der zentralen Änderung', $after); + $this->assertStringContainsString('Nur diese Karte', $after); + $this->get(route('website.media', $teaser))->assertNotFound(); + $this->get(route('website.media', $image))->assertNotFound(); + Storage::disk('media_derived')->assertExists($image->thumbnail_path); + Storage::disk('media_derived')->assertExists($teaser->preview_path); + $this->assertSame(0, $teaser->fresh()->versions()->count()); + $this->assertSame('Name aus der Redaktion', $program->fresh()->display_title); + } + + public function test_creating_a_presentation_film_does_not_open_a_content_version(): void + { + Storage::disk('cms_incoming')->put('inhalte/teaser.mp4', 'teaser-bytes'); + $editor = User::factory()->redakteur()->create(); + $this->actingAs($editor, 'staff'); + + $element = MediumForm::create([ + 'working_title' => 'Marketingclip', + 'shape' => 'film', + 'incoming' => 'inhalte/teaser.mp4', + 'without_version' => true, + 'description' => 'Nur die Website', + ], hold: false); + + $this->assertSame(0, $element->versions()->count()); + $this->assertSame('teaser/'.$element->id.'/datei.mp4', $element->preview_path); + $this->assertNull($element->website_released_at); + $this->assertSame(0, Grant::query()->count()); + Storage::disk('media_derived')->assertExists($element->preview_path); + Storage::disk('media_originals')->assertDirectoryEmpty('/'); + } + + public function test_a_versionless_audio_preview_is_released_without_a_license(): void + { + $audio = $this->store('audio', 'Audiovorschau ohne Fassung', 'audio-bytes'); + $this->assertNull(app(WebsiteMedia::class)->present($audio)); + + app(WebsiteRelease::class)->release($audio); + $audio->refresh(); + $presentation = app(WebsiteMedia::class)->present($audio); + $this->assertNotNull($presentation); + $this->assertSame('audio', $presentation->kind); + $this->get($presentation->url)->assertOk()->assertStreamedContent('audio-bytes'); + $this->assertSame(0, $audio->versions()->count()); + $this->assertSame(0, Grant::query()->count()); + + app(WebsiteRelease::class)->withdraw($audio->fresh()); + $this->assertNull(app(WebsiteMedia::class)->present($audio->fresh())); + $this->get(route('website.media', $audio))->assertNotFound(); + Storage::disk('media_derived')->assertExists($audio->preview_path); + } + + public function test_an_explicit_version_binding_stays_optional(): void + { + $content = app(ContentService::class); + $film = $content->createElement('film', 'film', 'Unterricht'); + $version = $content->publishElementVersion($film, 'Fassung'); + $clip = $this->store('film', 'Clip ohne Fassung', 'clip-bytes'); + + app(PresentationMedia::class)->assign($film, 'trailer', $clip->id, null); + $this->assertNull(PresentationAssignment::query()->value('source_version_id')); + + app(PresentationMedia::class)->assign($film, 'trailer', $clip->id, $version->id); + $this->assertSame($version->id, PresentationAssignment::query()->value('source_version_id')); + $this->assertSame(0, $clip->fresh()->versions()->count()); + $this->assertSame(1, $film->fresh()->versions()->count()); + $this->assertSame(0, Grant::query()->count()); + } + + public function test_a_widget_with_nothing_but_a_missing_medium_is_omitted(): void + { + $image = $this->store('bild', 'Nur ein Bild', 'bild-bytes'); + $html = app(WidgetRenderer::class)->renderAll([ + ['type' => 'heading', 'v' => 1, 'variant' => 'standard', 'settings' => [], 'data' => ['heading' => 'Die Überschrift bleibt'], 'refs' => []], + ['type' => 'cards', 'v' => 1, 'variant' => 'standard', 'settings' => [], 'data' => ['items' => [ + ['title' => '', 'text' => null, 'url' => null, 'image' => $image->id], + ]], 'refs' => []], + ], RenderContext::publicPage())->toHtml(); + + $this->assertStringContainsString('Die Überschrift bleibt', $html); + $this->assertStringNotContainsString('widget-cards', $html); + $this->assertStringNotContainsString(' 'jpg', + 'audio' => 'mp3', + default => 'mp4', + }; + $path = 'inhalte/'.md5($title).'.'.$extension; + Storage::disk('cms_incoming')->put($path, $bytes); + $element = app(ContentService::class)->createElement($output, $output, $title); + $element->display_title = $title; + $element->save(); + app(PresentationFile::class)->store($element, $path); + + return $element->fresh(); + } + + /** + * @param list> $sections + */ + private function publish(string $path, array $sections): void + { + $page = Page::query()->create(['path' => $path]); + $service = app(PageService::class); + $revision = $service->saveRevision($page, $sections, null, null, null); + $service->publish($page, $revision); + } + + /** + * @param array $refs + * @param array $data + * @return array + */ + private function card(string $type, array $refs, array $data = []): array + { + return ['type' => $type, 'v' => 1, 'variant' => 'adaptive', 'settings' => [], 'data' => $data, 'refs' => $refs]; + } +} diff --git a/tests/Feature/PublicPageTest.php b/tests/Feature/PublicPageTest.php new file mode 100644 index 0000000..d2f9e2b --- /dev/null +++ b/tests/Feature/PublicPageTest.php @@ -0,0 +1,44 @@ +get('/'); + + $response->assertOk(); + $response->assertSee('Lara & Felix', false); + $response->assertSee('Stark im Alltag'); + $response->assertSee('Anmelden'); + $response->assertSee('href="'.route('login').'"', false); + $response->assertDontSee('/verwaltung'); + } + + public function test_known_pages_and_sitemap_are_available(): void + { + $this->get('/praevention')->assertOk()->assertSee('Prävention im Alltag'); + $this->get('/angebote')->assertOk()->assertDontSee('€'); + $this->get('/sitemap.xml')->assertOk()->assertSee(url('/praevention'), false); + } + + public function test_missing_page_is_not_found(): void + { + $this->get('/gibt-es-nicht')->assertNotFound(); + } + + public function test_page_paths_are_unique(): void + { + $this->expectException(QueryException::class); + + Page::query()->create(['path' => '/']); + } +} diff --git a/tests/Feature/PublicThemeTest.php b/tests/Feature/PublicThemeTest.php new file mode 100644 index 0000000..576c89f --- /dev/null +++ b/tests/Feature/PublicThemeTest.php @@ -0,0 +1,56 @@ +create('Grenzen'); + $hilfe = $pillars->create('Hilfe holen'); + $film = app(ContentService::class)->createElement('film', 'film', 'Geheimer Film'); + $pillars->assign($film, [$grenzen->id, $hilfe->id]); + $page = Page::query()->where('path', '/praevention')->firstOrFail(); + $draft = Page::query()->create(['path' => '/entwurf-thema']); + $pillars->assignPages($page, [$grenzen->id, $hilfe->id]); + $pillars->assignPages($draft, [$grenzen->id]); + + $this->get('/themen')->assertOk()->assertSee('Noch kein Themenbereich ist veröffentlicht.'); + $this->get('/themen/grenzen')->assertNotFound(); + + $pillars->present($grenzen, 'Grenzen', 'grenzen', 'Nein sagen und dabei bleiben.', true, 1); + $pillars->present($hilfe, 'Hilfe holen', 'hilfe-holen', 'Eine Vertrauensperson finden.', true, 2); + + $this->get('/') + ->assertOk() + ->assertSee('Themenbereiche') + ->assertSee('Grenzen') + ->assertSee('Hilfe holen') + ->assertSee('Nein sagen und dabei bleiben.') + ->assertDontSee('Geheimer Film'); + + $this->get('/themen/grenzen') + ->assertOk() + ->assertSee('Präventionskonzept') + ->assertDontSee('/entwurf-thema') + ->assertDontSee('Geheimer Film'); + + $this->get('/themen/hilfe-holen') + ->assertOk() + ->assertSee('Präventionskonzept'); + + $this->get('/sitemap.xml') + ->assertOk() + ->assertSee(url('/themen/grenzen'), false) + ->assertSee(url('/themen/hilfe-holen'), false); + } +} diff --git a/tests/Feature/RedaktionelleStammdatenTest.php b/tests/Feature/RedaktionelleStammdatenTest.php new file mode 100644 index 0000000..76b91e2 --- /dev/null +++ b/tests/Feature/RedaktionelleStammdatenTest.php @@ -0,0 +1,326 @@ +editor(); + $film = app(ContentService::class)->createElement('film', 'film', 'Lara im Park'); + + Livewire::actingAs($editor, 'staff') + ->test(RedaktionelleStammdaten::class) + ->call('zeigeGruppe', 'zielgruppe') + ->callAction('anlegen', ['label' => 'Großeltern']) + ->assertHasNoActionErrors() + ->call('zeigeGruppe', 'materialart') + ->callAction('anlegen', ['label' => 'Rollenspielkarte', 'contexts' => ['medium']]) + ->assertHasNoActionErrors(); + + $wert = $this->value('zielgruppe', 'grosseltern'); + $art = EditorialContentKind::query()->where('slug', 'rollenspielkarte')->firstOrFail(); + $this->assertTrue($art->is_active); + $this->assertSame(['medium'], $art->contexts); + $this->assertArrayNotHasKey($art->id, app(EditorialVocabulary::class)->kindOptions('lizenzartikel'), 'Nur im gewählten Kontext angeboten.'); + + Livewire::actingAs($editor, 'staff') + ->test(ViewContentElement::class, ['record' => $film->getKey()]) + ->call('openRedaktion', 'einordnung') + ->assertSee('Großeltern') + ->assertSee('Rollenspielkarte') + ->set('kindId', $art->id) + ->set('dimensionIds', [$wert->id]) + ->call('saveEditorial') + ->assertSet('deskFeedbackError', false); + + $this->assertSame($art->id, $film->fresh()->editorial_content_kind_id); + $this->assertTrue($this->assigned($film, $wert)); + + Livewire::withQueryParams(['einordnung' => (string) $wert->id])->actingAs($editor, 'staff') + ->test(ListContentElements::class)->assertSee('Lara im Park'); + Livewire::withQueryParams(['inhaltsart' => (string) $art->id])->actingAs($editor, 'staff') + ->test(ListContentElements::class)->assertSee('Lara im Park'); + } + + public function test_renaming_keeps_identity_and_assignments_everywhere(): void + { + $film = app(ContentService::class)->createElement('film', 'film', 'Lara im Park'); + $kinder = $this->value('zielgruppe', 'kinder'); + app(IdentityDimension::class)->assign($film, $kinder); + $trainer = EditorialContentKind::query()->where('slug', 'traineranleitung')->firstOrFail(); + + Livewire::actingAs($this->editor(), 'staff') + ->test(RedaktionelleStammdaten::class) + ->call('zeigeGruppe', 'zielgruppe') + ->callAction(TestAction::make('bearbeiten')->table($kinder), ['label' => 'Kinder (6–10 Jahre)']) + ->assertHasNoActionErrors() + ->call('zeigeGruppe', 'materialart') + ->callAction(TestAction::make('bearbeiten')->table($trainer), ['label' => 'Anleitung für Trainer']) + ->assertHasNoActionErrors(); + + $kinder->refresh(); + $this->assertSame('kinder', $kinder->slug, 'Die Kennung bleibt.'); + $this->assertSame('Kinder (6–10 Jahre)', $kinder->label); + $this->assertTrue($this->assigned($film, $kinder)); + $this->assertContains('Altersbereich und Zielgruppe: Kinder (6–10 Jahre)', array_column(app(MediaLibrary::class)->classifications(), 'label')); + + // Systemkennung: Vertraulichkeit hängt an der Kennung, nicht an der Bezeichnung. + $this->assertSame('traineranleitung', $trainer->fresh()->slug); + $anleitung = app(ContentService::class)->createElement('bild', 'bild', 'Ablauf intern'); + $anleitung->forceFill(['editorial_content_kind_id' => $trainer->id])->save(); + $this->assertFalse(WebsiteImage::isSelectable($anleitung->fresh())); + } + + public function test_deactivating_keeps_assignments_visible_blocks_new_choice_and_survives_other_saves(): void + { + $editor = $this->editor(); + $film = app(ContentService::class)->createElement('film', 'film', 'Lara im Park'); + $anderes = app(ContentService::class)->createElement('film', 'film', 'Felix im Bus'); + $schule = $this->value('einsatzbereich', 'schule'); + $art = EditorialContentKind::query()->where('slug', 'unterrichtsfilm')->firstOrFail(); + app(IdentityDimension::class)->assign($film, $schule); + $film->forceFill(['editorial_content_kind_id' => $art->id])->save(); + + $stammdaten = Livewire::actingAs($editor, 'staff')->test(RedaktionelleStammdaten::class) + ->call('zeigeGruppe', 'einsatzbereich') + ->callAction(TestAction::make('umschalten')->table($schule)) + ->call('zeigeGruppe', 'materialart') + ->callAction(TestAction::make('umschalten')->table($art)); + $this->assertFalse($schule->fresh()->is_active); + $this->assertFalse($art->fresh()->is_active); + + // Bestehende Zuordnung sichtbar und erhalten, auch wenn andere Angaben gespeichert werden. + Livewire::actingAs($editor, 'staff') + ->test(ViewContentElement::class, ['record' => $film->getKey()]) + ->call('openRedaktion', 'einordnung') + ->assertSee('Schule (inaktiv)') + ->assertSee('Unterrichtsfilm (inaktiv)') + ->set('teaser', 'Neuer Teaser') + ->call('saveEditorial') + ->assertSet('deskFeedbackError', false); + $this->assertTrue($this->assigned($film, $schule), 'Die inaktive Zuordnung bleibt beim Speichern anderer Angaben.'); + $this->assertSame($art->id, $film->fresh()->editorial_content_kind_id); + + // Neue Auswahl ausgeschlossen: weder angeboten noch serverseitig angenommen. + Livewire::actingAs($editor, 'staff') + ->test(ViewContentElement::class, ['record' => $anderes->getKey()]) + ->call('openRedaktion', 'einordnung') + ->assertSee('Kita') + ->assertDontSee('Schule (inaktiv)') + ->assertDontSee('Unterrichtsfilm') + ->set('dimensionIds', [$schule->id]) + ->set('kindId', $art->id) + ->call('saveEditorial') + ->assertSet('deskFeedbackError', true) + ->assertSet('redaktionTab', 'einordnung'); + $this->assertNull($anderes->fresh()->editorial_content_kind_id); + app(IdentityDimension::class)->replaceOffered($anderes, [$schule->id]); + $this->assertFalse($this->assigned($anderes, $schule)); + + // Filter findet die Zuordnung weiterhin; ein gewählter Filter bleibt. + $this->assertContains('Einsatzbereich: Schule (inaktiv)', array_column(app(MediaLibrary::class)->classifications(), 'label')); + Livewire::withQueryParams(['einordnung' => (string) $schule->id])->actingAs($editor, 'staff') + ->test(ListContentElements::class)->assertSet('einordnung', (string) $schule->id)->assertSee('Lara im Park')->assertDontSee('Felix im Bus'); + + // Reaktivieren und Reihenfolge ändern. + $stammdaten->call('zeigeGruppe', 'einsatzbereich') + ->callAction(TestAction::make('umschalten')->table($schule->fresh())); + $this->assertTrue($schule->fresh()->is_active); + $erster = $this->dimension('einsatzbereich')->values()->first(); + $stammdaten->callAction(TestAction::make('runter')->table($erster)); + $this->assertNotSame($erster->id, $this->dimension('einsatzbereich')->values()->first()->id); + $stammdaten->callAction(TestAction::make('hoch')->table($erster->fresh())); + $this->assertSame($erster->id, $this->dimension('einsatzbereich')->values()->first()->id); + } + + public function test_object_kinds_are_not_offered_as_material_of_a_medium(): void + { + $editor = $this->editor(); + $bild = app(ContentService::class)->createElement('bild', 'bild', 'Szenenbild'); + $programm = EditorialContentKind::query()->where('slug', 'programm')->firstOrFail(); + $modul = EditorialContentKind::query()->where('slug', 'modul')->firstOrFail(); + $vokabular = app(EditorialVocabulary::class); + + foreach ([$vokabular->kindOptions('medium'), $vokabular->kindFilterOptions('medium')] as $optionen) { + $this->assertArrayNotHasKey($programm->id, $optionen); + $this->assertArrayNotHasKey($modul->id, $optionen); + } + $this->assertArrayHasKey($programm->id, $vokabular->kindOptions('programm')); + $this->assertArrayHasKey($modul->id, $vokabular->kindOptions('modul')); + + $seite = Livewire::actingAs($editor, 'staff')->test(ViewContentElement::class, ['record' => $bild->getKey()]); + $this->assertArrayNotHasKey($programm->id, $seite->instance()->einordnungArt()['options']); + $this->assertArrayNotHasKey($programm->id, $seite->instance()->pickerMaterialarten()); + $seite->set('kindId', $programm->id)->call('saveEditorial')->assertSet('deskFeedbackError', true); + $this->assertNull($bild->fresh()->editorial_content_kind_id); + } + + public function test_changing_contexts_of_a_used_kind_asks_and_keeps_assignments(): void + { + $film = app(ContentService::class)->createElement('film', 'film', 'Lara im Park'); + $art = EditorialContentKind::query()->where('slug', 'interview')->firstOrFail(); + $film->forceFill(['editorial_content_kind_id' => $art->id])->save(); + + $seite = Livewire::actingAs($this->editor(), 'staff')->test(RedaktionelleStammdaten::class); + $seite->callAction(TestAction::make('bearbeiten')->table($art), ['label' => 'Interview', 'contexts' => ['lizenzartikel']]) + ->assertHasActionErrors(['konflikt_bestaetigt']); + $this->assertContains('medium', $art->fresh()->contexts); + + Livewire::actingAs($this->editor(), 'staff')->test(RedaktionelleStammdaten::class) + ->callAction(TestAction::make('bearbeiten')->table($art), ['label' => 'Interview', 'contexts' => ['lizenzartikel'], 'konflikt_bestaetigt' => true]) + ->assertHasNoActionErrors(); + $this->assertSame(['lizenzartikel'], $art->fresh()->contexts); + $this->assertSame($art->id, $film->fresh()->editorial_content_kind_id, 'Die Zuordnung bleibt.'); + $this->assertSame('Interview (hier nicht vorgesehen)', app(EditorialVocabulary::class)->kindOptions('medium', $art->id)[$art->id]); + } + + public function test_used_values_cannot_be_deleted_and_system_kinds_stay_fixed(): void + { + $film = app(ContentService::class)->createElement('film', 'film', 'Lara im Park'); + $kinder = $this->value('zielgruppe', 'kinder'); + app(IdentityDimension::class)->assign($film, $kinder); + $unbenutzt = $this->value('zielgruppe', 'eltern'); + $programm = EditorialContentKind::query()->where('slug', 'programm')->firstOrFail(); + + Livewire::actingAs($this->editor(), 'staff')->test(RedaktionelleStammdaten::class) + ->call('zeigeGruppe', 'zielgruppe') + ->assertActionHidden(TestAction::make('loeschen')->table($kinder)) + ->callAction(TestAction::make('loeschen')->table($unbenutzt)) + ->call('zeigeGruppe', 'materialart') + ->assertActionHidden(TestAction::make('umschalten')->table($programm)) + ->assertActionHidden(TestAction::make('loeschen')->table($programm)); + + $this->assertNotNull($kinder->fresh()); + $this->assertNull($unbenutzt->fresh()); + $this->assertTrue($programm->fresh()->is_active); + } + + public function test_pillars_keep_their_own_management(): void + { + $editor = $this->editor(); + app(PillarService::class)->create('Neue Säule'); + + $this->actingAs($editor, 'staff')->get('/verwaltung/saeulen')->assertOk()->assertSee('Neue Säule'); + Livewire::actingAs($editor, 'staff')->test(RedaktionelleStammdaten::class) + ->assertSee('Fachliche Säulen') + ->assertDontSee('pfeiler-1'); + $this->assertArrayNotHasKey(EditorialDimension::PILLAR_SLUG, (new RedaktionelleStammdaten)->gruppen()); + } + + public function test_filters_in_picker_and_member_library_follow_their_rules_for_inactive_values(): void + { + $film = app(ContentService::class)->createElement('film', 'film', 'Lara im Park'); + $schule = $this->value('einsatzbereich', 'schule'); + $kita = $this->value('einsatzbereich', 'kita'); + app(IdentityDimension::class)->assign($film, $schule); + $schule->update(['is_active' => false]); + $kita->update(['is_active' => false]); + $modul = app(ContentService::class)->createComposition('Grenzen üben', CompositionKind::Uebung); + + // Aufbau-Picker: verwendete inaktive Werte bleiben als Filter auffindbar, unbenutzte inaktive nicht. + $seite = Livewire::actingAs($this->editor(), 'staff')->test(EditExercise::class, ['record' => $modul->getKey()]); + $labels = array_merge(...array_map(fn (array $g): array => array_column($g['values'], 'label'), $seite->instance()->pickerDimensionGroups())); + $this->assertContains('Schule (inaktiv)', $labels); + $this->assertNotContains('Kita (inaktiv)', $labels); + + // Mitgliederbibliothek: nur aktive Werte, ein gewählter inaktiver bleibt sichtbar. + $vokabular = app(EditorialVocabulary::class); + $ids = fn ($dimensionen): array => $dimensionen->flatMap(fn ($d) => $d->values->pluck('id'))->map(fn ($id): int => (int) $id)->all(); + $this->assertNotContains($schule->id, $ids($vokabular->memberFilterDimensions())); + $this->assertContains($schule->id, $ids($vokabular->memberFilterDimensions([$schule->id]))); + } + + public function test_reordering_swaps_only_the_two_neighbours(): void + { + $werte = $this->dimension('zielgruppe')->values()->get(); + [$erster, $zweiter, $dritter] = [$werte[0], $werte[1], $werte[2]]; + $vorher = $dritter->updated_at?->toDateTimeString(); + Carbon::setTestNow(now()->addMinute()); + + Livewire::actingAs($this->editor(), 'staff')->test(RedaktionelleStammdaten::class) + ->call('zeigeGruppe', 'zielgruppe') + ->callAction(TestAction::make('runter')->table($erster)); + + $this->assertSame([$zweiter->id, $erster->id], $this->dimension('zielgruppe')->values()->limit(2)->pluck('id')->all()); + $this->assertSame($vorher, $dritter->fresh()->updated_at?->toDateTimeString(), 'Unbeteiligte Werte werden nicht geschrieben.'); + Carbon::setTestNow(); + } + + public function test_staff_without_the_editor_role_cannot_change_master_data(): void + { + $katalog = User::factory()->katalogverwalter()->create(); + $katalog->saveAppAuthenticationSecret('JBSWY3DPEHPK3PXP'); + $kinder = $this->value('zielgruppe', 'kinder'); + + $this->actingAs($katalog, 'staff')->get('/verwaltung/stammdaten')->assertForbidden(); + Livewire::actingAs($katalog, 'staff')->test(RedaktionelleStammdaten::class)->assertForbidden(); + $this->assertTrue($kinder->fresh()->is_active); + } + + private function assigned(ContentElement $element, EditorialDimensionValue $value): bool + { + return IdentityDimensionValue::query() + ->where('subject_type', $element->getMorphClass()) + ->where('subject_id', $element->id) + ->where('editorial_dimension_value_id', $value->id) + ->exists(); + } + + private function dimension(string $slug): EditorialDimension + { + return EditorialDimension::query()->where('slug', $slug)->firstOrFail(); + } + + private function value(string $dimension, string $slug): EditorialDimensionValue + { + return EditorialDimensionValue::query() + ->where('editorial_dimension_id', $this->dimension($dimension)->id) + ->where('slug', $slug) + ->firstOrFail(); + } + + private function editor(): User + { + $editor = User::factory()->redakteur()->create(); + $editor->saveAppAuthenticationSecret('JBSWY3DPEHPK3PXP'); + + return $editor; + } +} diff --git a/tests/Feature/RegistrationTest.php b/tests/Feature/RegistrationTest.php new file mode 100644 index 0000000..eab8e43 --- /dev/null +++ b/tests/Feature/RegistrationTest.php @@ -0,0 +1,131 @@ +from('/registrieren')->post('/registrieren', [ + 'name' => 'Ada Trainer', + 'email' => 'ada@example.com', + 'password' => 'password-pass', + 'password_confirmation' => 'password-pass', + ]); + + $response->assertRedirect('/registrieren'); + $response->assertSessionHasErrors('adult'); + $this->assertDatabaseCount('users', 0); + } + + public function test_registration_creates_a_person_and_sends_verification(): void + { + Notification::fake(); + + $response = $this->post('/registrieren', [ + 'name' => 'Ada Trainer', + 'email' => 'ada@example.com', + 'password' => 'password-pass', + 'password_confirmation' => 'password-pass', + 'adult' => '1', + ]); + + $response->assertRedirect(route('verification.notice')); + + $user = User::query()->where('email', 'ada@example.com')->first(); + $this->assertNotNull($user); + $this->assertNotNull($user->confirmed_adult_at); + $this->assertSame('person', $user->party->type->value); + $this->assertSame('private', $user->party->profile->visibility['display_name']); + $this->assertAuthenticatedAs($user); + Notification::assertSentTo($user, VerifyEmailAddress::class); + } + + public function test_placeholder_app_url_uses_the_address_opened_in_the_browser(): void + { + Notification::fake(); + config(['app.url' => 'https://CHANGE-ME.example']); + + $response = $this->post('/registrieren', [ + 'name' => 'Probe Mitglied', + 'email' => 'probe@example.test', + 'password' => 'password-pass', + 'password_confirmation' => 'password-pass', + 'adult' => '1', + ]); + + $response->assertRedirect(url('/email/bestaetigen')); + + $user = User::query()->where('email', 'probe@example.test')->firstOrFail(); + Notification::assertSentTo($user, VerifyEmailAddress::class, function (VerifyEmailAddress $notification) use ($user): bool { + $link = $notification->toMail($user)->actionUrl; + $path = parse_url($link, PHP_URL_PATH); + $query = parse_url($link, PHP_URL_QUERY); + + $this->actingAs($user) + ->get($path.'?'.$query) + ->assertRedirect(route('member.dashboard')); + + return str_starts_with($link, url('/email/bestaetigen/')) + && ! str_contains($link, 'CHANGE-ME.example'); + }); + } + + public function test_verified_member_can_log_in_and_reaches_the_dashboard(): void + { + $user = User::factory()->create([ + 'email' => 'ada@example.com', + 'password' => 'password-pass', + ]); + + $response = $this->post('/anmelden', [ + 'email' => 'ada@example.com', + 'password' => 'password-pass', + ]); + + $response->assertRedirect(route('member.dashboard')); + $this->assertAuthenticatedAs($user); + $this->get('/bereich')->assertOk()->assertSee('Guten Tag'); + $this->get('/bereich/bibliothek')->assertOk()->assertSee('Noch nichts in der Bibliothek'); + } + + public function test_unverified_member_cannot_open_the_member_area(): void + { + $user = User::factory()->unverified()->create([ + 'password' => 'password-pass', + ]); + + $this->post('/anmelden', [ + 'email' => $user->email, + 'password' => 'password-pass', + ])->assertRedirect(route('member.dashboard')); + + $this->get('/bereich')->assertRedirect(route('verification.notice')); + } + + public function test_password_reset_sends_a_link(): void + { + Notification::fake(); + $user = User::factory()->create(); + + $this->post('/passwort/vergessen', ['email' => $user->email]) + ->assertSessionHas('status'); + + Notification::assertSentTo($user, ResetPassword::class); + } + + public function test_guests_cannot_open_the_member_area(): void + { + $this->get('/bereich')->assertRedirect('/anmelden'); + $this->get('/bereich/berechtigungen')->assertRedirect('/anmelden'); + } +} diff --git a/tests/Feature/StaffAuthenticationTest.php b/tests/Feature/StaffAuthenticationTest.php new file mode 100644 index 0000000..7d95127 --- /dev/null +++ b/tests/Feature/StaffAuthenticationTest.php @@ -0,0 +1,75 @@ +assertSame('Lara&Felix (dev)', StaffAuthenticatorName::current()); + + $provider = Filament::getPanel('verwaltung')->getMultiFactorAuthenticationProviders()['app'] ?? null; + $this->assertInstanceOf(AppAuthentication::class, $provider); + $this->assertSame('Lara&Felix (dev)', $provider->getBrandName()); + + $this->app['env'] = 'production'; + + $this->assertSame('Lara&Felix', StaffAuthenticatorName::current()); + } + + public function test_a_trusted_device_skips_the_code_until_the_secret_changes(): void + { + $user = User::factory()->systemverwalter()->create(); + $user->saveAppAuthenticationSecret('JBSWY3DPEHPK3PXP'); + $device = app(TrustedStaffDevice::class); + $request = Request::create('/verwaltung/login', 'POST', cookies: [ + TrustedStaffDevice::COOKIE => $device->token($user), + ]); + $this->app->instance('request', $request); + + $this->assertTrue($device->isTrusted($user, $request)); + $this->assertNull(TrustedDeviceChallenge::make()->getFirstEnabledProvider($user)); + + $user->saveAppAuthenticationSecret('KRSXG5CTMVRXEZLU'); + + $this->assertFalse($device->isTrusted($user, $request)); + $this->assertInstanceOf(AppAuthentication::class, TrustedDeviceChallenge::make()->getFirstEnabledProvider($user)); + } + + public function test_changing_the_own_password_keeps_the_staff_session_hash(): void + { + $admin = User::factory()->systemverwalter()->create(); + $this->actingAs($admin, 'staff'); + session()->put(['password_hash_staff' => $admin->getAuthPassword()]); + + UserResource::persist($admin, [ + 'name' => $admin->name, + 'email' => $admin->email, + 'password' => 'neues-passwort-1', + 'status' => AccountStatus::Aktiv->value, + 'roles' => [StaffRole::Systemverwalter->value], + ], false); + + $admin->refresh(); + + $this->assertTrue(Hash::check('neues-passwort-1', $admin->password)); + $this->assertSame($admin->getAuthPassword(), session('password_hash_staff')); + $this->assertAuthenticatedAs($admin, 'staff'); + } +} diff --git a/tests/Feature/VerwaltungArbeitsplatzTest.php b/tests/Feature/VerwaltungArbeitsplatzTest.php new file mode 100644 index 0000000..df35497 --- /dev/null +++ b/tests/Feature/VerwaltungArbeitsplatzTest.php @@ -0,0 +1,800 @@ +film(); + $mine = $this->picture('Meine Galerie'); + $theirs = $this->picture('Fremde Galerie'); + + $page = Livewire::actingAs($this->editor(), 'staff') + ->test(ViewContentElement::class, ['record' => $film->getKey()]) + ->call('openRedaktion', 'medien'); + + app(PresentationMedia::class)->assign($film, 'galerie', $theirs->id, null); + + $page->call('openPresentationPicker', 'galerie') + ->call('assignFromPicker', 'medium:'.$mine->id) + ->call('saveRedaktion'); + + $this->assertEqualsCanonicalizing([$theirs->id, $mine->id], $this->order($film, 'galerie')); + } + + public function test_adding_to_an_occupied_single_role_is_an_exchange(): void + { + $film = $this->film(); + $old = $this->picture('Altes Titelbild'); + $new = $this->picture('Neues Titelbild'); + app(PresentationMedia::class)->assign($film, 'titelbild', $old->id, null); + + Livewire::actingAs($this->editor(), 'staff') + ->test(ViewContentElement::class, ['record' => $film->getKey()]) + ->call('openRedaktion', 'medien') + ->call('openPresentationPicker', 'titelbild') + ->assertSee('Wird ersetzt') + ->assertSee('Diese Rolle hat nur ein Medium.') + ->call('markPicker', 'medium:'.$new->id, true) + ->assertSee('Austauschen') + ->call('confirmPicker') + ->assertSee('„Neues Titelbild“ ersetzt „Altes Titelbild“ an derselben Stelle') + ->call('saveRedaktion'); + + $this->assertSame([$new->id], $this->order($film, 'titelbild')); + $this->assertNotNull($old->fresh()); + } + + public function test_a_stock_image_can_become_the_preview_image_through_the_shared_picker(): void + { + $film = $this->film(); + $image = $this->picture('Szenenbild'); + + Livewire::actingAs($this->editor(), 'staff') + ->test(ViewContentElement::class, ['record' => $film->getKey()]) + ->call('openThumbnailPicker') + ->assertSee('Vorschaubild aus dem Bestand') + ->assertSee('Szenenbild') + ->call('markPicker', 'medium:'.$image->id, true) + ->assertSee('Als Vorschaubild übernehmen') + ->call('confirmPicker') + ->assertSet('pickerOpen', false) + ->assertSet('pictureFeedback', 'Vorschaubild übernommen. Es gibt keine neue Fassung. Für die Website ist es damit nicht freigegeben.'); + + $this->assertSame($image->thumbnail_path, $film->fresh()->thumbnail_path); + $this->assertSame(1, $film->fresh()->versions()->count()); + } + + public function test_confirmations_use_the_shared_dialog_and_only_known_actions(): void + { + $film = $this->film(); + $film->teaser = 'Gespeichert'; + $film->save(); + + Livewire::actingAs($this->editor(), 'staff') + ->test(ViewContentElement::class, ['record' => $film->getKey()]) + ->call('openRedaktion') + ->set('teaser', 'Offen') + ->call('askConfirmation', 'discardRedaktion') + ->assertSee('Änderungen der Redaktion verwerfen?') + ->call('cancelConfirmation') + ->assertSet('teaser', 'Offen') + ->call('askConfirmation', 'discardRedaktion') + ->call('confirmConfirmation') + ->assertSet('teaser', 'Gespeichert') + ->call('askConfirmation', 'saveRedaktionTexte') + ->assertSet('bestaetigung', null); + } + + public function test_only_editors_change_the_redaktion_and_the_address_does_not_bypass_it(): void + { + $film = $this->film(); + $keeper = User::factory()->katalogverwalter()->create(); + $keeper->saveAppAuthenticationSecret('JBSWY3DPEHPK3PXP'); + + Livewire::actingAs($keeper, 'staff') + ->withQueryParams(['redaktion' => '1']) + ->test(ViewContentElement::class, ['record' => $film->getKey()]) + ->assertSet('redaktionOpen', false) + ->assertDontSee('Redaktion bearbeiten') + ->call('saveRedaktion') + ->assertForbidden(); + + foreach (['removePresentation' => ['a1'], 'confirmPicker' => [], 'openPresentationPicker' => []] as $method => $arguments) { + Livewire::actingAs($keeper, 'staff') + ->test(ViewContentElement::class, ['record' => $film->getKey()]) + ->set('pickerMarked', ['medium:1' => 'x']) + ->call($method, ...$arguments) + ->assertForbidden(); + } + + $this->assertSame(0, PresentationAssignment::query()->count()); + } + + public function test_the_license_article_needs_the_catalog_role_and_offers_no_global_release_there(): void + { + $content = app(ContentService::class); + $film = $this->film(); + $version = $film->versions()->first(); + $articles = app(ArticleService::class); + $article = $articles->create('LARA-PARK', 'Alltag'); + $articles->publishRelease($article, $version, 'Derselbe Unterrichtsfilm'); + $image = $this->picture('Artikelbild'); + app(PresentationMedia::class)->assign($article, 'titelbild', $image->id, null); + + $this->actingAs($this->editor(), 'staff') + ->get(LicenseArticleResource::getUrl('view', ['record' => $article])) + ->assertForbidden(); + + $keeper = User::factory()->katalogverwalter()->create(); + $keeper->saveAppAuthenticationSecret('JBSWY3DPEHPK3PXP'); + + Livewire::actingAs($keeper, 'staff') + ->test(ViewLicenseArticle::class, ['record' => $article->getKey()]) + ->call('openRedaktion', 'medien') + ->assertSee('Artikelbild') + ->assertSee('Medium öffnen') + ->assertDontSee('Für die Website freigeben') + ->assertDontSee('Website-Freigabe zurücknehmen'); + } + + public function test_aufbau_keeps_local_inputs_while_switching_and_saves_only_with_the_draft(): void + { + $content = app(ContentService::class); + $sheet = $content->publishElementVersion($content->createElement('text', 'text', 'Blatt'), 'Hinweis'); + $film = $content->publishElementVersion($content->createElement('film', 'film', 'Lara im Park'), 'Film'); + $extra = $content->publishElementVersion($content->createElement('bild', 'bild', 'Szenenbild'), null, ['file' => 'inhalte/szene.jpg']); + $version = $content->publishComposition( + $content->createComposition('Wechsel', CompositionKind::Uebung), + [['role' => 'Unterlage', 'target' => $sheet], ['role' => 'Film', 'target' => $film]], + ); + + $page = Livewire::actingAs($this->editor(), 'staff') + ->test(EditExercise::class, ['record' => $version->composition_id]) + ->assertSet('selected', 0) + ->assertSee('Position 1 von 2') + ->set('roleDraft', 'Einstieg') + ->set('noteDraft', 'Zuerst besprechen') + ->call('selectPart', 1) + ->assertSet('roleDraft', 'Film') + ->call('selectPart', 0) + ->assertSet('roleDraft', 'Einstieg') + ->assertSet('noteDraft', 'Zuerst besprechen') + ->call('addPart', 'element:'.$extra->id) + ->assertSet('selected', 2) + ->assertSee('Änderungen am Aufbau nicht gespeichert'); + + $this->assertNull($version->composition->fresh()->working_draft); + + $page->call('askConfirmation', 'removePart', 2) + ->assertSee('„Szenenbild“ aus diesem Aufbau entfernen?') + ->call('confirmConfirmation') + ->assertSee('Das Quellobjekt bleibt im Bestand') + ->call('saveDraft'); + + $draft = $version->composition->fresh()->working_draft; + $this->assertSame(['Einstieg', 'Film'], array_column($draft['members'], 'role')); + $this->assertSame('Zuerst besprechen', $draft['members'][0]['note']); + $this->assertNotNull($extra->fresh()); + $this->assertSame(1, $version->composition->fresh()->versions()->count()); + } + + public function test_a_referenced_module_shows_its_source_content_read_only(): void + { + $content = app(ContentService::class); + $sheet = $content->publishElementVersion($content->createElement('text', 'text', 'Trainerunterlage Abstand'), 'Hinweis'); + $module = $content->publishComposition($content->createComposition('Modul Abstand', CompositionKind::Uebung), [['role' => 'Unterlage', 'target' => $sheet]]); + $program = $content->publishComposition($content->createComposition('Programm Abstand', CompositionKind::Kurs), [['role' => 'Einstieg', 'target' => $module]]); + + Livewire::actingAs($this->editor(), 'staff') + ->test(EditCourse::class, ['record' => $program->composition_id]) + ->assertDontSee('Inhalt der Quelle') + ->call('toggleExpanded', 0) + ->assertSee('Inhalt der Quelle') + ->assertSee('Nur zur Ansicht') + ->assertSee('Trainerunterlage Abstand') + ->set('detailTab', 'quelle') + ->assertSee('Quelle bearbeiten'); + } + + public function test_the_library_note_names_the_version_members_actually_see(): void + { + $content = app(ContentService::class); + $sheet = $content->publishElementVersion($content->createElement('text', 'text', 'Blatt'), 'A'); + $other = $content->publishElementVersion($content->createElement('text', 'text', 'Blatt zwei'), 'B'); + $module = $content->createComposition('Sichtbar', CompositionKind::Uebung); + $first = $content->publishComposition($module, [['role' => 'Unterlage', 'target' => $sheet]]); + $editor = $this->editor(); + app(CompositionDisplayRelease::class)->release($first, $editor); + $content->publishComposition($module->fresh(), [['role' => 'Unterlage', 'target' => $other]]); + + Livewire::actingAs($editor, 'staff') + ->test(EditExercise::class, ['record' => $module->id]) + ->call('showAufbauTab', 'verlauf') + ->assertSee('In der Mitgliederbibliothek ist Fassung 1 sichtbar, die neuere Fassung 2 noch nicht.') + ->assertDontSee('noch keine Fassung sichtbar'); + + $labels = array_column(app(EditorialCatalog::class)->statusChips($module->fresh(), false), 'label'); + $this->assertContains('Bibliothek zeigt Fassung 1', $labels); + $this->assertNotContains('In der Mitgliederbibliothek', $labels); + } + + public function test_an_expanded_module_stays_expanded_when_it_moves(): void + { + $content = app(ContentService::class); + $sheet = $content->publishElementVersion($content->createElement('text', 'text', 'Unterlage A'), 'A'); + $other = $content->publishElementVersion($content->createElement('text', 'text', 'Unterlage B'), 'B'); + $first = $content->publishComposition($content->createComposition('Erstes Modul', CompositionKind::Uebung), [['role' => 'Unterlage', 'target' => $sheet]]); + $second = $content->publishComposition($content->createComposition('Zweites Modul', CompositionKind::Uebung), [['role' => 'Unterlage', 'target' => $other]]); + $program = $content->publishComposition($content->createComposition('Programm', CompositionKind::Kurs), [['role' => 'Modul', 'target' => $first], ['role' => 'Modul', 'target' => $second]]); + + Livewire::actingAs($this->editor(), 'staff') + ->test(EditCourse::class, ['record' => $program->composition_id]) + ->call('toggleExpanded', 0) + ->assertSee('Unterlage A') + ->call('movePart', 0, 1) + ->assertSee('Unterlage A') + ->assertDontSee('Unterlage B'); + } + + public function test_creating_a_medium_from_the_picker_closes_the_picker_first(): void + { + $module = app(ContentService::class)->createComposition('Neues Medium', CompositionKind::Uebung); + + Livewire::actingAs($this->editor(), 'staff') + ->test(EditExercise::class, ['record' => $module->id]) + ->call('openPicker') + ->assertSee('Neues Medium anlegen') + ->call('startCreateMedium') + ->assertSet('pickerOpen', false) + ->assertDontSee('Bestandteil auswählen'); + } + + public function test_redaktion_return_keeps_open_composition_inputs_and_saves_only_editorial_text(): void + { + $content = app(ContentService::class); + $sheet = $content->publishElementVersion($content->createElement('text', 'text', 'Blatt'), 'Hinweis'); + $version = $content->publishComposition( + $content->createComposition('Rueckweg', CompositionKind::Uebung), + [['role' => 'Unterlage', 'target' => $sheet]], + ); + $editor = $this->editor(); + + Livewire::actingAs($editor, 'staff') + ->test(EditExercise::class, ['record' => $version->composition_id]) + ->call('openPart', 0) + ->set('roleDraft', 'Einstieg') + ->set('learningGoal', 'Grenze erkennen') + ->call('openRedaktion') + ->assertSet('redaktionOpen', true) + ->assertSee('Redaktion speichern') + ->assertSee('Zurück zum Aufbau') + ->assertSee('Präsentationsmedien') + ->assertDontSee('In Mitgliederbibliothek anzeigen') + ->assertDontSee('Vorschau für Trainer') + ->assertSet('roleDraft', 'Einstieg') + ->assertSet('learningGoal', 'Grenze erkennen') + ->set('teaser', 'Kurzer Teaser im Manager') + ->assertSee('Änderungen nicht gespeichert') + ->call('closeRedaktion') + ->assertSet('redaktionOpen', false) + ->assertSee('Die Redaktion hat ungespeicherte Änderungen.') + ->assertSet('teaser', 'Kurzer Teaser im Manager') + ->assertSet('roleDraft', 'Einstieg') + ->assertSet('learningGoal', 'Grenze erkennen') + ->call('saveRedaktion') + ->assertSee('Aufbau, Lernziel, Zeit und Fassungen bleiben unverändert.') + ->assertSet('learningGoal', 'Grenze erkennen'); + + $composition = $version->composition->fresh(); + $this->assertSame('Kurzer Teaser im Manager', $composition->teaser); + $this->assertSame(1, $composition->versions()->count()); + $this->assertNull($composition->versions()->first()->learning_goal); + $this->assertSame('Unterlage', $composition->versions()->first()->members()->first()->role); + } + + public function test_didactic_dialog_and_draft_discard_do_not_touch_open_redaktion_inputs(): void + { + $content = app(ContentService::class); + $sheet = $content->publishElementVersion($content->createElement('text', 'text', 'Blatt'), 'Hinweis'); + $version = $content->publishComposition( + $content->createComposition('Verdeckt', CompositionKind::Uebung), + [['role' => 'Unterlage', 'target' => $sheet]], + ); + + $page = Livewire::actingAs($this->editor(), 'staff') + ->test(EditExercise::class, ['record' => $version->composition_id]) + ->call('openRedaktion') + ->set('teaser', 'Noch nicht gespeichert') + ->call('closeRedaktion') + ->call('openModule') + ->set('durationMinutes', '20') + ->call('saveDraft') + ->call('saveCatalogImage') + ->assertSet('teaser', 'Noch nicht gespeichert'); + + $this->assertNull($version->composition->fresh()->teaser); + + $page->call('discardDraft') + ->assertSet('teaser', 'Noch nicht gespeichert'); + + $this->assertNull($version->composition->fresh()->teaser); + } + + public function test_media_redaktion_return_keeps_the_open_version_text(): void + { + $content = app(ContentService::class); + $film = $content->createElement('film', 'film', 'Lara im Park'); + $content->publishElementVersion($film, 'Filmfassung'); + $editor = $this->editor(); + + Livewire::actingAs($editor, 'staff') + ->test(ViewContentElement::class, ['record' => $film->getKey()]) + ->set('bereich', 'inhalt') + ->set('bodyDraft', 'Offener Lehrtext') + ->set('thumbnailAlt', 'Offener Alternativtext') + ->call('openRedaktion') + ->assertSee('Zurück zur Medienbearbeitung') + ->set('teaser', 'Neuer Teaser') + ->call('closeRedaktion') + ->assertSet('redaktionOpen', false) + ->assertSet('bereich', 'inhalt') + ->assertSet('bodyDraft', 'Offener Lehrtext') + ->assertSet('thumbnailAlt', 'Offener Alternativtext') + ->assertSet('teaser', 'Neuer Teaser') + ->call('openRedaktion') + ->assertSet('teaser', 'Neuer Teaser') + ->call('saveRedaktion') + ->call('closeRedaktion') + ->assertSet('thumbnailAlt', 'Offener Alternativtext'); + + $film->refresh(); + $this->assertSame('Neuer Teaser', $film->teaser); + $this->assertNull($film->thumbnail_alt); + } + + public function test_the_redaktion_state_lives_in_the_address_for_browser_back(): void + { + $content = app(ContentService::class); + $film = $content->createElement('film', 'film', 'Lara im Park'); + $content->publishElementVersion($film, 'Filmfassung'); + + Livewire::actingAs($this->editor(), 'staff') + ->withQueryParams(['redaktion' => '1']) + ->test(ViewContentElement::class, ['record' => $film->getKey()]) + ->assertSet('redaktionOpen', true) + ->assertSee('Zurück zur Medienbearbeitung') + ->set('teaser', 'Offen beim Zurückblättern') + ->set('redaktionOpen', false) + ->assertDontSee('Zurück zur Medienbearbeitung') + ->assertSee('Redaktion mit ungespeicherten Änderungen') + ->assertSet('teaser', 'Offen beim Zurückblättern'); + + $this->assertNull($film->fresh()->teaser); + } + + public function test_website_release_does_not_save_open_redaktion_inputs(): void + { + $content = app(ContentService::class); + $image = $content->createElement('bild', 'bild', 'Szenenbild'); + $editor = $this->editor(); + + Livewire::actingAs($editor, 'staff') + ->test(ViewContentElement::class, ['record' => $image->getKey()]) + ->call('openRedaktion') + ->set('websiteCredit', 'Offene Quellenzeile') + ->set('teaser', 'Offener Teaser') + ->call('closeRedaktion') + ->set('bereich', 'website') + ->call('releaseForWebsite') + ->assertSet('websiteCredit', 'Offene Quellenzeile') + ->assertSet('teaser', 'Offener Teaser'); + + $image->refresh(); + $this->assertNull($image->website_credit); + $this->assertNull($image->teaser); + } + + public function test_presentation_changes_are_staged_until_redaktion_is_saved(): void + { + $content = app(ContentService::class); + $film = $content->createElement('film', 'film', 'Lara im Park'); + $content->publishElementVersion($film, 'Filmfassung'); + $first = $this->picture('Galerie eins'); + $second = $this->picture('Galerie zwei'); + + $page = Livewire::actingAs($this->editor(), 'staff') + ->test(ViewContentElement::class, ['record' => $film->getKey()]) + ->call('openRedaktion', 'medien') + ->call('openPresentationPicker', 'galerie') + ->call('markPicker', 'medium:'.$first->id, true) + ->call('markPicker', 'medium:'.$second->id, true) + ->set('pickerQuery', 'etwas ganz anderes') + ->assertSet('pickerMarked', ['medium:'.$first->id => 'Galerie eins', 'medium:'.$second->id => 'Galerie zwei']) + ->assertSee('2 Medien übernehmen') + ->call('confirmPicker') + ->assertSet('pickerOpen', false) + ->assertSee('Neu zugeordnet') + ->assertSee('Änderungen nicht gespeichert'); + + $this->assertSame(0, PresentationAssignment::query()->where('subject_id', $film->id)->count()); + + $page->call('saveRedaktion')->assertSee('Alle Änderungen gespeichert'); + + $this->assertSame([$first->id, $second->id], $this->order($film, 'galerie')); + } + + public function test_cancelling_the_picker_keeps_the_existing_assignment(): void + { + $content = app(ContentService::class); + $film = $content->createElement('film', 'film', 'Lara im Park'); + $content->publishElementVersion($film, 'Filmfassung'); + $cover = $this->picture('Titel alt'); + $other = $this->picture('Titel neu'); + app(PresentationMedia::class)->assign($film, 'titelbild', $cover->id, null); + $key = 'a'.PresentationAssignment::query()->value('id'); + + Livewire::actingAs($this->editor(), 'staff') + ->test(ViewContentElement::class, ['record' => $film->getKey()]) + ->call('openRedaktion', 'medien') + ->call('beginExchange', $key) + ->call('markPicker', 'medium:'.$other->id, true) + ->call('closePicker') + ->assertSee('Die vorhandene Zuordnung bleibt unverändert.') + ->assertSee('Alle Änderungen gespeichert'); + + $this->assertSame([$cover->id], $this->order($film, 'titelbild')); + } + + public function test_exchange_keeps_the_position_and_reordering_stays_within_its_role(): void + { + $content = app(ContentService::class); + $film = $content->createElement('film', 'film', 'Lara im Park'); + $content->publishElementVersion($film, 'Filmfassung'); + $one = $this->picture('Bild eins'); + $two = $this->picture('Bild zwei'); + $three = $this->picture('Bild drei'); + $replacement = $this->picture('Bild neu'); + $cover = $this->picture('Titel'); + $media = app(PresentationMedia::class); + $media->assign($film, 'titelbild', $cover->id, null); + foreach ([$one, $two, $three] as $image) { + $media->assign($film, 'galerie', $image->id, null); + } + $keyOf = fn (ContentElement $image): string => 'a'.PresentationAssignment::query()->where('content_element_id', $image->id)->value('id'); + + Livewire::actingAs($this->editor(), 'staff') + ->test(ViewContentElement::class, ['record' => $film->getKey()]) + ->call('openRedaktion', 'medien') + ->call('beginExchange', $keyOf($two)) + ->call('markPicker', 'medium:'.$replacement->id, true) + ->assertSee('Austauschen') + ->call('confirmPicker') + ->assertSee('ersetzt „Bild zwei“ an derselben Stelle') + ->call('movePresentation', $keyOf($three), -1) + ->call('movePresentation', $keyOf($one), -1) + ->call('saveRedaktion'); + + $this->assertSame([$one->id, $three->id, $replacement->id], $this->order($film, 'galerie')); + $this->assertSame([$cover->id], $this->order($film, 'titelbild')); + $this->assertNotNull($two->fresh(), 'Entfernen einer Zuordnung löscht das Medium nicht.'); + } + + public function test_removing_an_assignment_keeps_the_medium_and_its_website_release(): void + { + $content = app(ContentService::class); + $film = $content->createElement('film', 'film', 'Lara im Park'); + $content->publishElementVersion($film, 'Filmfassung'); + $image = $this->picture('Freigegebenes Bild'); + $image->website_released_at = now(); + $image->save(); + app(PresentationMedia::class)->assign($film, 'titelbild', $image->id, null); + $key = 'a'.PresentationAssignment::query()->value('id'); + + Livewire::actingAs($this->editor(), 'staff') + ->test(ViewContentElement::class, ['record' => $film->getKey()]) + ->call('openRedaktion', 'medien') + ->call('removePresentation', $key) + ->assertSee('Änderungen nicht gespeichert') + ->call('saveRedaktion'); + + $this->assertSame(0, PresentationAssignment::query()->where('subject_id', $film->id)->count()); + $this->assertNotNull($image->fresh()); + $this->assertNotNull($image->fresh()->website_released_at); + } + + public function test_discarding_the_redaktion_restores_saved_values_only(): void + { + $content = app(ContentService::class); + $film = $content->createElement('film', 'film', 'Lara im Park'); + $film->teaser = 'Gespeichert'; + $film->save(); + $content->publishElementVersion($film, 'Filmfassung'); + + Livewire::actingAs($this->editor(), 'staff') + ->test(ViewContentElement::class, ['record' => $film->getKey()]) + ->set('bodyDraft', 'Offener Lehrtext') + ->call('openRedaktion') + ->set('teaser', 'Verworfen') + ->set('variantBody', 'Nur für die Kachel') + ->call('saveVariant') + ->call('discardRedaktion') + ->assertSet('teaser', 'Gespeichert') + ->assertSet('bodyDraft', 'Offener Lehrtext') + ->assertSee('Alle Änderungen gespeichert'); + + $this->assertSame(0, EditorialTextVariant::query()->count()); + } + + public function test_a_missing_working_title_is_shown_at_the_field_and_nothing_is_saved(): void + { + $content = app(ContentService::class); + $film = $content->createElement('film', 'film', 'Lara im Park'); + $content->publishElementVersion($film, 'Filmfassung'); + + Livewire::actingAs($this->editor(), 'staff') + ->test(ViewContentElement::class, ['record' => $film->getKey()]) + ->call('openRedaktion', 'medien') + ->set('workingTitle', '') + ->set('teaser', 'Bleibt offen') + ->call('saveRedaktion') + ->assertSet('redaktionTab', 'texte') + ->assertSet('redaktionFehlerFeld', 'workingTitle') + ->assertSee('Der Arbeitstitel fehlt.') + ->assertSet('teaser', 'Bleibt offen'); + + $this->assertNull($film->fresh()->teaser); + $this->assertSame('Lara im Park', $film->fresh()->working_title); + } + + private function film(): ContentElement + { + $content = app(ContentService::class); + $film = $content->createElement('film', 'film', 'Lara im Park'); + $content->publishElementVersion($film, 'Filmfassung'); + + return $film->fresh(); + } + + private function picture(string $title): ContentElement + { + $image = app(ContentService::class)->createElement('bild', 'bild', $title); + $image->thumbnail_path = 'vorschau/'.md5($title).'.jpg'; + $image->save(); + + return $image; + } + + /** + * @return list + */ + private function order(ContentElement $subject, string $role): array + { + return PresentationAssignment::query() + ->where('subject_type', $subject->getMorphClass()) + ->where('subject_id', $subject->id) + ->whereHas('role', fn ($query) => $query->where('slug', $role)) + ->orderBy('position') + ->pluck('content_element_id') + ->map(fn ($id): int => (int) $id) + ->all(); + } + + public function test_switching_versions_keeps_an_unsaved_text_until_the_editor_confirms(): void + { + $content = app(ContentService::class); + $text = $content->createElement('text', 'text', 'Trainerunterlage'); + $first = $content->publishElementVersion($text, 'Erster Wortlaut'); + $second = $content->draftElementVersion($text, 'Zweiter Wortlaut'); + + Livewire::actingAs($this->editor(), 'staff') + ->test(ViewContentElement::class, ['record' => $text->getKey()]) + ->assertSet('bodyDraft', 'Erster Wortlaut') + ->set('bodyDraft', 'Offener Wortlaut') + ->assertSee('Text der Fassung nicht gespeichert') + ->call('showVersion', $second->id) + ->assertSet('bodyDraft', 'Offener Wortlaut') + ->assertSee('Ungespeicherten Text verwerfen?') + ->call('cancelConfirmation') + ->assertSet('bodyDraft', 'Offener Wortlaut') + ->call('showVersion', $second->id) + ->call('confirmConfirmation') + ->assertSet('fassung', $second->id) + ->assertSet('bodyDraft', 'Zweiter Wortlaut') + ->assertDontSee('Text der Fassung nicht gespeichert'); + + $this->assertSame('Erster Wortlaut', $first->fresh()->body); + } + + public function test_saving_a_released_text_selects_the_new_version(): void + { + $content = app(ContentService::class); + $text = $content->createElement('text', 'text', 'Trainerunterlage'); + $first = $content->publishElementVersion($text, 'Erster Wortlaut'); + $content->publishElementVersion($text, 'Zweiter Wortlaut'); + $content->publishComposition($content->createComposition('Modul mit Unterlage', CompositionKind::Uebung), [['role' => 'Unterlage', 'target' => $first]]); + + $component = Livewire::actingAs($this->editor(), 'staff') + ->test(ViewContentElement::class, ['record' => $text->getKey()]) + ->call('showVersion', $first->id) + ->assertSet('bodyDraft', 'Erster Wortlaut') + ->set('bodyDraft', 'Dritter Wortlaut') + ->assertSee('Fassung 1 ist freigegeben und wird verwendet.') + ->assertSee('Eingebunden in') + ->assertSee('Modul mit Unterlage') + ->call('saveShownText') + ->assertSee('Fassung 3 ist angelegt. Fassung 1 bleibt erhalten.'); + + $third = $text->versions()->where('number', 3)->firstOrFail(); + $component->assertSet('fassung', $third->id)->assertSet('bodyDraft', 'Dritter Wortlaut'); + $this->assertSame('Erster Wortlaut', $first->fresh()->body); + } + + public function test_media_versions_are_listed_left_and_the_chosen_one_is_shown_right(): void + { + $content = app(ContentService::class); + $film = $content->createElement('film', 'film', 'Lara im Park'); + $first = $content->publishElementVersion($film, 'Erste Filmfassung'); + $second = $content->publishElementVersion($film, 'Zweite Filmfassung'); + $content->block($first, 'Alter Schnitt'); + $draft = $content->draftElementVersion($film, 'Dritte Filmfassung'); + + Livewire::actingAs($this->editor(), 'staff') + ->test(ViewContentElement::class, ['record' => $film->getKey()]) + ->assertSee('Inhalt und Fassungen') + ->assertSeeText('Fassungen · 3') + ->assertSee('Fassung 2, Freigegeben') + ->call('showVersion', $draft->id) + ->assertSet('fassung', $draft->id) + ->assertSee('Entwurf, noch nicht freigegeben') + ->assertSee('Diese Fassung freigeben') + ->mountAction('releaseVersion', ['version' => $draft->id]) + ->tap(fn ($component) => $this->assertSame('Fassung 3 freigeben', $component->instance()->getMountedAction()->getModalHeading())) + ->unmountAction() + ->mountAction('deactivate', ['version' => $second->id]) + ->tap(fn ($component) => $this->assertSame('Fassung 2 deaktivieren', $component->instance()->getMountedAction()->getModalHeading())) + ->unmountAction() + ->call('showVersion', $first->id) + ->assertSee('Begründung: Alter Schnitt') + ->assertDontSee('Diese Fassung freigeben'); + } + + public function test_releasing_another_version_does_not_move_the_shown_text_onto_it(): void + { + $content = app(ContentService::class); + $text = $content->createElement('text', 'text', 'Trainerunterlage'); + $first = $content->publishElementVersion($text, 'Erster Wortlaut'); + $draft = $content->draftElementVersion($text, 'Zweiter Wortlaut'); + + Livewire::actingAs($this->editor(), 'staff') + ->test(ViewContentElement::class, ['record' => $text->getKey()]) + ->assertSet('bodyDraft', 'Erster Wortlaut') + ->callAction('releaseVersion', [], ['version' => $draft->id]) + ->assertSet('fassung', $first->id) + ->assertSet('bodyDraft', 'Erster Wortlaut') + ->assertDontSee('Text der Fassung nicht gespeichert'); + + $this->assertSame('Zweiter Wortlaut', $draft->fresh()->body); + } + + public function test_a_foreign_version_in_the_address_still_pins_the_shown_version(): void + { + $content = app(ContentService::class); + $text = $content->createElement('text', 'text', 'Trainerunterlage'); + $first = $content->publishElementVersion($text, 'Erster Wortlaut'); + $draft = $content->draftElementVersion($text, 'Zweiter Wortlaut'); + $foreign = $content->publishElementVersion($content->createElement('text', 'text', 'Anderes Blatt'), 'Fremd'); + + Livewire::withQueryParams(['fassung' => $foreign->id]) + ->actingAs($this->editor(), 'staff') + ->test(ViewContentElement::class, ['record' => $text->getKey()]) + ->assertSet('fassung', $first->id) + ->assertSet('bodyDraft', 'Erster Wortlaut') + ->callAction('releaseVersion', [], ['version' => $draft->id]) + ->assertSet('fassung', $first->id) + ->assertSet('bodyDraft', 'Erster Wortlaut') + ->assertDontSee('Text der Fassung nicht gespeichert'); + } + + public function test_a_new_version_from_the_dialog_is_shown_with_its_own_text(): void + { + $content = app(ContentService::class); + $text = $content->createElement('text', 'text', 'Trainerunterlage'); + $content->publishElementVersion($text, 'Erster Wortlaut'); + + $component = Livewire::actingAs($this->editor(), 'staff') + ->test(ViewContentElement::class, ['record' => $text->getKey()]) + ->callAction('revise', ['body' => 'Neuer Wortlaut', 'change_note' => 'Neu']) + ->assertHasNoFormErrors(); + + $second = $text->versions()->where('number', 2)->firstOrFail(); + $component->assertSet('fassung', $second->id) + ->assertSet('bodyDraft', 'Neuer Wortlaut') + ->assertDontSee('Text der Fassung nicht gespeichert'); + } + + public function test_the_frame_slider_starts_at_the_current_preview_frame(): void + { + $content = app(ContentService::class); + $film = $content->createElement('film', 'film', 'Lara im Park'); + $version = $content->publishElementVersion($film, 'Filmfassung'); + $film->forceFill(['thumbnail_source' => 'frame:'.$version->id.'@41.5'])->save(); + + Livewire::actingAs($this->editor(), 'staff') + ->test(ViewContentElement::class, ['record' => $film->getKey()]) + ->set('bereich', 'vorschaubild') + ->assertSee('Vorschaubild aus dem Film bei 41.5 Sekunden.') + ->assertSee('{ second: "41.5" }') + ->set('frameSecond', '12') + ->assertSee('{ second: "12" }'); + } + + public function test_the_old_versions_area_opens_the_combined_register(): void + { + $content = app(ContentService::class); + $version = $content->publishElementVersion($content->createElement('text', 'text', 'Blatt'), 'A'); + $editor = $this->editor(); + + Livewire::actingAs($editor, 'staff') + ->test(ViewContentElement::class, ['record' => $version->content_element_id]) + ->set('bereich', 'fassungen') + ->assertSet('bereich', 'inhalt') + ->set('bereich', 'vorschaubild') + ->assertSee('Bild aus dem Bestand wählen') + ->assertSee('Alternativtext'); + + $this->actingAs($editor, 'staff') + ->get(ViewContentElement::getUrl(['record' => $version->content_element_id]).'?bereich=fassungen&fassung='.$version->id) + ->assertOk() + ->assertSee('Inhalt und Fassungen'); + } + + public function test_a_medium_without_versions_offers_the_first_version_instead_of_an_empty_list(): void + { + $image = app(ContentService::class)->createElement('bild', 'bild', 'Szenenbild'); + + Livewire::actingAs($this->editor(), 'staff') + ->test(ViewContentElement::class, ['record' => $image->getKey()]) + ->assertSee('Noch keine Inhaltsfassung') + ->assertSee('Erste Fassung anlegen') + ->assertDontSeeText('Fassungen · 0'); + } + + private function editor(): User + { + $editor = User::factory()->redakteur()->create(); + $editor->saveAppAuthenticationSecret('JBSWY3DPEHPK3PXP'); + + return $editor; + } +} diff --git a/tests/Feature/WebpraesenzTest.php b/tests/Feature/WebpraesenzTest.php new file mode 100644 index 0000000..756f5e3 --- /dev/null +++ b/tests/Feature/WebpraesenzTest.php @@ -0,0 +1,438 @@ +editor(); + $admin = User::factory()->systemverwalter()->create(); + $admin->saveAppAuthenticationSecret('JBSWY3DPEHPK3PXP'); + + $this->actingAs($editor, 'staff')->get('/verwaltung/webpraesenz')->assertOk()->assertSee('Webpräsenz'); + $this->actingAs($editor, 'staff')->get('/verwaltung/pages')->assertRedirect(Webpraesenz::getUrl()); + $this->actingAs($editor, 'staff')->get('/verwaltung/navigation-items')->assertRedirect(Webpraesenz::getUrl(['bereich' => 'menues'])); + $this->actingAs($editor, 'staff')->get('/verwaltung/pages/create')->assertOk(); + + $this->actingAs($admin, 'staff')->get('/verwaltung/webpraesenz')->assertForbidden(); + $this->actingAs($admin, 'staff')->get('/verwaltung/pages')->assertForbidden(); + } + + public function test_the_page_inventory_shows_publication_and_menu_state_separately(): void + { + $service = app(PageService::class); + $draft = Page::query()->create(['path' => '/nur-entwurf']); + $service->saveRevision($draft, [['type' => 'heading', 'v' => 1, 'data' => ['heading' => 'Noch geheim']]], null, null, null); + $loose = Page::query()->create(['path' => '/ohne-menue']); + $service->publish($loose, $service->saveRevision($loose, [['type' => 'heading', 'v' => 1, 'data' => ['heading' => 'Ohne Menü']]], null, null, null)); + + $component = Livewire::actingAs($this->editor(), 'staff') + ->test(Webpraesenz::class) + ->assertSet('register', 'seiten') + ->assertSee('Seite anlegen') + ->assertSee('Noch geheim') + ->assertSee('Nur Entwurf, nicht veröffentlicht') + ->assertSee('Ohne Menüeintrag') + ->assertSee('Ohne sichtbaren Menüeintrag, aber öffentlich über die Adresse erreichbar und in der Sitemap.') + ->assertSee('Hauptmenü'); + + $component->set('imMenue', 'ohne') + ->assertSee('/nur-entwurf') + ->assertSee('/ohne-menue') + ->assertDontSee('/praevention'); + + $component->set('imMenue', 'alle')->set('zustand', 'nur_entwurf') + ->assertSee('/nur-entwurf') + ->assertDontSee('/ohne-menue'); + + // Fußbereich zählt nicht als Hauptmenü. + $component->set('zustand', 'alle')->set('imMenue', 'nicht_hauptmenue') + ->assertSee('/impressum') + ->assertDontSee('/praevention'); + } + + public function test_the_inventory_sorts_by_last_edit_or_address_without_touching_the_menus(): void + { + $service = app(PageService::class); + Carbon::setTestNow('2026-11-18 08:00:00'); + $pages = collect([2, 10, 1])->map(fn (int $i) => Page::query()->create(['path' => '/seite-'.$i])); + Carbon::setTestNow('2026-11-18 09:30:00'); + $service->saveRevision($pages->last(), [['type' => 'heading', 'v' => 1, 'data' => ['heading' => 'Neu bearbeitet']]], null, null, null); + $menus = NavigationItem::query()->orderBy('id')->get(['id', 'sort_order', 'updated_at'])->toArray(); + + Livewire::actingAs($this->editor(), 'staff') + ->test(Webpraesenz::class) + ->assertSeeInOrder(['Neu bearbeitet', '/seite-2']) + ->assertSee('Zuletzt bearbeitet 18.11.2026 10:30') + ->set('sortierung', 'adresse') + ->assertSeeInOrder(['/seite-1', '/seite-2', '/seite-10']) + ->set('sortierung', 'adresse_ab') + ->assertSeeInOrder(['/seite-10', '/seite-2', '/seite-1']) + ->set('sortierung', 'bearbeitet_alt') + ->assertSeeInOrder(['/seite-2', 'Neu bearbeitet']); + + $this->assertSame($menus, NavigationItem::query()->orderBy('id')->get(['id', 'sort_order', 'updated_at'])->toArray(), 'Sortieren der Übersicht ändert keine Menüfolge (WEB-R01).'); + } + + public function test_duplicating_a_page_keeps_its_rules_and_opens_the_copy(): void + { + $source = Page::query()->where('path', '/praevention')->firstOrFail(); + $before = $source->latestRevision->id; + + Livewire::actingAs($this->editor(), 'staff') + ->test(Webpraesenz::class) + ->assertSee('Duplizieren') + ->callAction('duplicate', ['path' => '/praevention'], ['page' => $source->id]) + ->assertHasActionErrors(['path']); + + Livewire::actingAs($this->editor(), 'staff') + ->test(Webpraesenz::class) + ->callAction('duplicate', ['path' => '/kopie-praevention'], ['page' => $source->id]) + ->assertHasNoActionErrors() + ->assertRedirect(); + + $copy = Page::query()->where('path', '/kopie-praevention')->firstOrFail(); + $this->assertNull($copy->published_revision_id); + $this->assertFalse(NavigationItem::query()->where('page_id', $copy->id)->exists(), 'Duplizieren legt keinen Menüeintrag an.'); + $this->assertSame($before, $source->fresh()->latestRevision->id); + } + + public function test_menu_changes_stay_open_across_registers_until_saved(): void + { + $about = $this->item('Über das Projekt'); + $key = 'e'.$about->id; + + $component = $this->menus() + ->call('waehle', $key) + ->assertSee('Menüeintrag: Über das Projekt') + ->assertSee('Menüs gespeichert') + ->set("eintraege.$key.label", 'Über uns') + ->assertSee('Menüänderungen nicht gespeichert · betrifft Hauptmenü') + ->call('zeigeRegister', 'seiten') + ->assertSee('Im Register „Menüs“ gibt es ungespeicherte Änderungen.') + ->call('zeigeRegister', 'menues') + ->assertSet("eintraege.$key.label", 'Über uns'); + + $this->assertSame('Über das Projekt', $about->fresh()->label, 'Vor dem Speichern bleibt die Navigation unverändert.'); + + $component->call('speichern')->assertHasNoErrors()->assertSee('Menüs gespeichert'); + $this->assertSame('Über uns', $about->fresh()->label); + $this->get('/praevention')->assertSee('Über uns'); + } + + public function test_reordering_the_main_menu_changes_only_that_menu(): void + { + $footerBefore = NavigationItem::query()->where('placement', 'footer')->orderBy('id')->get(['id', 'sort_order', 'updated_at'])->toArray(); + $component = $this->menus(); + $angebote = 'e'.$this->item('Angebote')->id; + + Carbon::setTestNow(now()->addMinute()); + $component->call('verschiebe', $angebote, 'hoch') + ->call('verschiebe', $angebote, 'hoch') + ->assertSee('betrifft Hauptmenü') + ->call('speichern') + ->assertHasNoErrors(); + + $expected = array_map(fn (array $knoten): string => $component->get("eintraege.{$knoten['k']}.label"), $component->instance()->baum('header')); + $public = array_column($this->publicNavigation()->header(), 'label'); + $this->assertSame(['Start', 'Angebote', 'Prävention', 'Materialien', 'Trainer und Einrichtungen', 'Über das Projekt', 'Anmelden'], $public); + $this->assertSame($expected, $public, 'Die öffentliche Reihenfolge entspricht der Liste im Editor.'); + $this->assertSame($footerBefore, NavigationItem::query()->where('placement', 'footer')->orderBy('id')->get(['id', 'sort_order', 'updated_at'])->toArray(), 'Der Fußbereich bleibt unberührt (WEB-02).'); + } + + public function test_saving_writes_only_changed_entries_and_keeps_existing_ties(): void + { + $first = NavigationItem::query()->create(['label' => 'Gleichstand A', 'url' => '/a', 'placement' => 'footer_contact', 'sort_order' => 50]); + $second = NavigationItem::query()->create(['label' => 'Gleichstand B', 'url' => '/b', 'placement' => 'footer_contact', 'sort_order' => 50]); + $spaced = $this->item('Anmelden'); + $spaced->forceFill(['label' => ' Anmelden ', 'url' => '/anmelden '])->save(); + $untouched = NavigationItem::query()->whereKey([$first->id, $second->id, $spaced->id])->orderBy('id')->get(['id', 'label', 'url', 'sort_order', 'updated_at'])->toArray(); + $about = 'e'.$this->item('Über das Projekt')->id; + + Carbon::setTestNow(now()->addMinute()); + $this->menus()->set("eintraege.$about.label", 'Über uns')->call('speichern')->assertHasNoErrors(); + + $this->assertSame('Über uns', $this->item('Über uns')->label); + $this->assertSame($untouched, NavigationItem::query()->whereKey([$first->id, $second->id, $spaced->id])->orderBy('id')->get(['id', 'label', 'url', 'sort_order', 'updated_at'])->toArray(), 'Unveränderte Einträge werden nicht geschrieben.'); + } + + public function test_moves_without_a_valid_neighbour_do_nothing_and_never_change_the_level(): void + { + $component = $this->menus(); + $start = 'e'.$this->item('Start')->id; + $praevention = 'e'.$this->item('Prävention')->id; + $materialien = 'e'.$this->item('Materialien')->id; + + $component->set("eintraege.$materialien.parent", $praevention)->assertHasNoErrors(); + $this->assertNull($component->instance()->nachbar($materialien, 'hoch')); + $this->assertNull($component->instance()->nachbar($materialien, 'runter')); + $this->assertNull($component->instance()->nachbar($start, 'hoch')); + + $folge = $component->get('folge'); + $component->call('verschiebe', $materialien, 'hoch')->call('verschiebe', $materialien, 'runter')->call('verschiebe', $start, 'hoch'); + $this->assertSame($folge, $component->get('folge')); + $this->assertSame($praevention, $component->instance()->elternVon($materialien), 'Bewegen wechselt nie still die Ebene (WEB-12).'); + + $component->call('waehle', $materialien) + ->assertSee('Reihenfolge für „Materialien“ ändern') + ->assertSee('Untermenü von'); + + $component->call('speichern')->assertHasNoErrors(); + $header = $this->publicNavigation()->header(); + $this->assertSame(['Materialien'], array_column($header[1]['children'], 'label')); + } + + public function test_dragging_reorders_only_entries_of_the_same_level(): void + { + $component = $this->menus(); + $header = array_column($component->instance()->baum('header'), 'k'); + $footer = array_column($component->instance()->baum('footer'), 'k'); + + $component->call('sortiere', [...array_slice($header, 0, 2), $footer[0]]); + $this->assertSame($header, array_column($component->instance()->baum('header'), 'k'), 'Eine gemischte Liste wird nicht übernommen.'); + + $component->call('sortiere', array_reverse($header)); + $this->assertSame(array_reverse($header), array_column($component->instance()->baum('header'), 'k')); + $this->assertSame($footer, array_column($component->instance()->baum('footer'), 'k')); + } + + public function test_removing_a_parent_names_and_promotes_its_children_and_keeps_the_page(): void + { + $praevention = $this->item('Prävention'); + $materialien = $this->item('Materialien'); + $materialien->update(['parent_id' => $praevention->id]); + $p = 'e'.$praevention->id; + + $component = $this->menus() + ->call('askConfirmation', 'entfernen', $p) + ->assertSee('„Prävention“ aus dem Menü entfernen?') + ->assertSee('Der Untereintrag „Materialien“ rückt in die oberste Ebene des Hauptmenüs.') + ->call('confirmConfirmation') + ->assertSet('eintraege.e'.$materialien->id.'.parent', null); + + $this->assertNotNull($praevention->fresh(), 'Entfernen wirkt erst mit dem Speichern.'); + + $component->call('speichern')->assertHasNoErrors(); + $this->assertNull($praevention->fresh()); + $this->assertNull($materialien->fresh()->parent_id); + $this->assertNotNull(Page::query()->where('path', '/praevention')->first(), 'Die Seite bleibt bestehen.'); + } + + public function test_an_entry_with_children_stays_in_the_main_menu(): void + { + $praevention = 'e'.$this->item('Prävention')->id; + $materialien = 'e'.$this->item('Materialien')->id; + + $component = $this->menus() + ->set("eintraege.$materialien.parent", $praevention) + ->call('waehle', $praevention) + ->assertSee('Ein Eintrag mit Untereinträgen bleibt im Hauptmenü') + ->set("eintraege.$praevention.placement", 'footer') + ->assertHasErrors(["eintraege.$praevention.placement"]) + ->assertSet("eintraege.$praevention.placement", 'header'); + + // Ein Untereintrag darf in den Fußbereich; dort steht er in der obersten Ebene. + $component->set("eintraege.$materialien.placement", 'footer_legal') + ->assertSet("eintraege.$materialien.parent", null) + ->assertSet('menue', 'footer_legal') + ->call('speichern') + ->assertHasNoErrors(); + + $this->assertSame('footer_legal', $this->item('Materialien')->placement); + $this->assertNull($this->item('Materialien')->parent_id); + } + + public function test_saving_checks_the_previous_rules_and_shows_the_failing_entry(): void + { + $before = $this->snapshot(); + + $this->menus() + ->call('zeigeMenue', 'footer_legal') + ->call('eintragHinzufuegen') + ->assertSet('auswahl', 'n1') + ->set('eintraege.n1.url', 'javascript:alert(1)') + ->call('zeigeMenue', 'header') + ->call('speichern') + ->assertHasErrors(['eintraege.n1.label', 'eintraege.n1.url']) + ->assertSet('auswahl', 'n1') + ->assertSet('menue', 'footer_legal') + ->set('eintraege.n1.url', '') + ->set('eintraege.n1.label', 'Ohne Ziel') + ->call('speichern') + ->assertHasErrors(['eintraege.n1.url']) + ->assertSee('Wählen Sie eine Seite oder eine Adresse.'); + + $this->assertSame($before, $this->snapshot(), 'Ein fehlerhafter Stand schreibt nichts.'); + $this->get('/praevention')->assertDontSee('javascript:alert(1)', false); + } + + public function test_a_hidden_test_entry_can_be_added_and_removed_without_trace(): void + { + $before = $this->snapshot(); + $impressum = Page::query()->where('path', '/impressum')->firstOrFail(); + + $component = $this->menus() + ->call('zeigeMenue', 'footer_legal') + ->call('eintragHinzufuegen') + ->set('eintraege.n1.label', 'UX-Prüfung') + ->call('oeffneZielwahl', 'n1') + ->assertSee('Zielseite wählen') + ->set('zielSuche', 'impressum') + ->call('waehleZiel', $impressum->id) + ->assertSet('zielwahl', null) + ->assertSet('eintraege.n1.page_id', $impressum->id) + ->set('eintraege.n1.is_visible', false) + ->assertSee('betrifft Fußbereich: Rechtliches') + ->call('speichern') + ->assertHasNoErrors(); + + $item = NavigationItem::query()->where('label', 'UX-Prüfung')->firstOrFail(); + $this->assertSame('footer_legal', $item->placement); + $this->assertFalse($item->is_visible); + $this->get('/praevention')->assertDontSee('UX-Prüfung'); + + $component->assertSet('auswahl', 'e'.$item->id) + ->call('askConfirmation', 'entfernen', 'e'.$item->id) + ->call('confirmConfirmation') + ->call('speichern') + ->assertHasNoErrors(); + + $this->assertSame(array_values(array_filter($before, fn (array $row): bool => true)), $this->snapshot(), 'Nach dem Entfernen entspricht die Navigation wieder dem Ausgangsstand.'); + } + + public function test_a_save_after_a_parallel_change_is_refused_and_can_be_reloaded(): void + { + $about = $this->item('Über das Projekt'); + $component = $this->menus()->set('eintraege.e'.$about->id.'.label', 'Meine Änderung'); + + Carbon::setTestNow(now()->addMinute()); + $about->update(['label' => 'Andere Sitzung']); + + $component->call('speichern') + ->assertSet('konflikt', true) + ->assertSee('Nicht gespeichert: Die Menüs wurden inzwischen an anderer Stelle geändert.'); + $this->assertSame('Andere Sitzung', $about->fresh()->label, 'Die zwischenzeitliche Speicherung wird nicht überschrieben.'); + + $component->call('askConfirmation', 'neuLaden') + ->assertSee('Gespeicherten Stand laden?') + ->call('confirmConfirmation') + ->assertSet('konflikt', false) + ->assertSet('eintraege.e'.$about->id.'.label', 'Andere Sitzung') + ->assertSee('Menüs gespeichert'); + } + + public function test_discarding_returns_to_the_saved_menus(): void + { + $about = 'e'.$this->item('Über das Projekt')->id; + + $this->menus() + ->set("eintraege.$about.is_visible", false) + ->call('askConfirmation', 'verwerfen') + ->assertSee('Betroffen: Hauptmenü.') + ->call('confirmConfirmation') + ->assertSet("eintraege.$about.is_visible", true) + ->assertDontSee('Menüänderungen nicht gespeichert'); + } + + public function test_the_detail_exists_once_in_the_wide_and_the_narrow_arrangement(): void + { + $component = $this->menus()->call('waehle', 'e'.$this->item('Prävention')->id); + + $wide = $component->html(); + $this->assertSame(1, substr_count($wide, 'id="menue-text"')); + $this->assertStringContainsString('vw-menue-detail', $wide); + $this->assertStringNotContainsString('vw-menue-inline', $wide); + + $component->set('schmal', true); + $narrow = $component->html(); + $this->assertSame(1, substr_count($narrow, 'id="menue-text"')); + $this->assertStringContainsString('vw-menue-inline', $narrow); + $this->assertStringNotContainsString('class="vw-menue-detail"', $narrow); + $component->assertSet('auswahl', 'e'.$this->item('Prävention')->id); + } + + public function test_a_target_page_without_public_revision_is_explained_and_not_published(): void + { + $draft = Page::query()->create(['path' => '/bald']); + app(PageService::class)->saveRevision($draft, [['type' => 'heading', 'v' => 1, 'data' => ['heading' => 'Bald da']]], null, null, null); + $about = 'e'.$this->item('Über das Projekt')->id; + + $this->menus() + ->call('waehle', $about) + ->call('oeffneZielwahl', $about) + ->assertSee('Nur Entwurf, öffentlich nicht erreichbar') + ->call('waehleZiel', $draft->id) + ->assertSee('Diese Seite ist nicht veröffentlicht.') + ->assertSee('Ziel nicht veröffentlicht') + ->call('speichern') + ->assertHasNoErrors(); + + $this->assertNull($draft->fresh()->published_revision_id, 'Ein Menüziel wird nicht automatisch veröffentlicht (WEB-06).'); + } + + private function menus(): Testable + { + return Livewire::withQueryParams(['bereich' => 'menues']) + ->actingAs($this->editor(), 'staff') + ->test(Webpraesenz::class) + ->assertSet('register', 'menues'); + } + + private function item(string $label): NavigationItem + { + return NavigationItem::query()->where('label', $label)->firstOrFail(); + } + + private function publicNavigation(): SiteNavigation + { + return SiteNavigation::forPath(NavigationItem::query()->visible()->with('page')->orderBy('sort_order')->orderBy('id')->get(), '/'); + } + + /** + * @return list> + */ + private function snapshot(): array + { + return NavigationItem::query()->orderBy('id')->get(['id', 'label', 'page_id', 'url', 'placement', 'sort_order', 'is_visible', 'parent_id', 'updated_at'])->toArray(); + } + + private function editor(): User + { + $editor = User::factory()->redakteur()->create(); + $editor->saveAppAuthenticationSecret('JBSWY3DPEHPK3PXP'); + + return $editor; + } +} diff --git a/tests/Feature/WebsiteImageResolutionTest.php b/tests/Feature/WebsiteImageResolutionTest.php new file mode 100644 index 0000000..90ffa5e --- /dev/null +++ b/tests/Feature/WebsiteImageResolutionTest.php @@ -0,0 +1,68 @@ +accept('cms/gross.png', $this->png(3000, 1500, transparent: true)); + [$width, $height] = getimagesizefromstring(Storage::disk('media_derived')->get($element->thumbnail_path)); + $this->assertSame([2400, 1200], [$width, $height]); + + $image = imagecreatefromstring(Storage::disk('media_derived')->get($element->thumbnail_path)); + $this->assertGreaterThan(240, imagecolorat($image, 5, 5) & 0xFF, 'Transparenz wird weiß, nicht schwarz.'); + } + + public function test_small_images_are_not_enlarged(): void + { + $element = $this->accept('cms/klein.png', $this->png(800, 450)); + [$width, $height] = getimagesizefromstring(Storage::disk('media_derived')->get($element->thumbnail_path)); + $this->assertSame([800, 450], [$width, $height]); + } + + private function accept(string $path, string $bytes): ContentElement + { + Storage::disk('cms_incoming')->put($path, $bytes); + + return app(WebsiteIntake::class)->acceptImage($path, 'Testbild')->refresh(); + } + + private function png(int $width, int $height, bool $transparent = false): string + { + $image = imagecreatetruecolor($width, $height); + + if ($transparent) { + imagesavealpha($image, true); + imagefill($image, 0, 0, imagecolorallocatealpha($image, 0, 0, 0, 127)); + } else { + imagefill($image, 0, 0, imagecolorallocate($image, 30, 90, 160)); + } + + ob_start(); + imagepng($image); + + return (string) ob_get_clean(); + } +} diff --git a/tests/Feature/WebsiteIntakeTest.php b/tests/Feature/WebsiteIntakeTest.php new file mode 100644 index 0000000..21feb9c --- /dev/null +++ b/tests/Feature/WebsiteIntakeTest.php @@ -0,0 +1,110 @@ +put('cms/hero.png', $this->pngBytes()); + $editor = User::factory()->redakteur()->create(); + + $element = app(WebsiteIntake::class)->acceptImage( + 'cms/hero.png', + 'Lara im Park', + 'Foto: Lara und Felix', + 'Lara sitzt auf einer Parkbank', + $editor, + ); + + $element->refresh(); + $this->assertSame(0, $element->versions()->count()); + $this->assertSame(0, Grant::query()->count()); + $this->assertSame('Lara im Park', $element->display_title); + $this->assertSame('vorschau/element-'.$element->id.'.jpg', $element->thumbnail_path); + $this->assertSame('website/'.$element->id.'/datei.jpg', $element->website_public_path); + $this->assertNotNull($element->website_released_at); + Storage::disk('cms_incoming')->assertMissing('cms/hero.png'); + Storage::disk('media_derived')->assertExists($element->thumbnail_path); + Storage::disk('media_originals')->assertMissing('cms/hero.png'); + + $presentation = app(WebsiteMedia::class)->present($element); + $this->assertNotNull($presentation); + $this->assertSame($element->id, $presentation->elementId); + $this->assertSame('Lara sitzt auf einer Parkbank', $presentation->alt); + $this->assertSame('Foto: Lara und Felix', $presentation->credit); + $this->assertSame('bild', $presentation->kind); + $this->assertStringStartsWith("\xFF\xD8", $this->get($presentation->url)->assertOk()->streamedContent()); + } + + public function test_a_missing_or_misplaced_file_creates_no_medium(): void + { + $intake = app(WebsiteIntake::class); + Storage::disk('cms_incoming')->put('cms/hero.png', $this->pngBytes()); + + try { + $intake->acceptImage('cms/hero.png', ' '); + $this->fail('Der Titel hätte abgelehnt werden müssen.'); + } catch (DomainRuleException $exception) { + $this->assertSame('Der Titel fehlt.', $exception->getMessage()); + } + + foreach (['cms/fehlt.png', 'originals/geheim.png', 'cms/../originals/geheim.png', ''] as $path) { + try { + $intake->acceptImage($path, 'Ohne Datei'); + $this->fail('Die Datei hätte abgelehnt werden müssen.'); + } catch (DomainRuleException $exception) { + $this->assertSame('Die Bilddatei liegt nicht im Eingang.', $exception->getMessage()); + } + } + + $this->assertSame(0, ContentElement::query()->count()); + Storage::disk('media_public')->assertMissing('website/1/datei.jpg'); + } + + public function test_an_unreadable_file_is_kept_but_not_released(): void + { + Storage::disk('cms_incoming')->put('cms/kaputt.jpg', 'kein bild'); + + $element = app(WebsiteIntake::class)->acceptImage('cms/kaputt.jpg', 'Unlesbar', 'Quelle'); + + $this->assertNull($element->fresh()->website_released_at); + $this->assertNotNull($element->fresh()->thumbnail_error); + $this->assertNull(app(WebsiteMedia::class)->present($element)); + Storage::disk('cms_incoming')->assertExists('cms/kaputt.jpg'); + Storage::disk('media_public')->assertMissing('website/'.$element->id.'/datei.jpg'); + } + + private function pngBytes(): string + { + $image = imagecreatetruecolor(8, 8); + ob_start(); + imagepng($image); + $bytes = ob_get_clean(); + imagedestroy($image); + + return is_string($bytes) ? $bytes : ''; + } +} diff --git a/tests/Feature/WebsiteReleaseTest.php b/tests/Feature/WebsiteReleaseTest.php new file mode 100644 index 0000000..3ba6143 --- /dev/null +++ b/tests/Feature/WebsiteReleaseTest.php @@ -0,0 +1,181 @@ +createElement('bild', 'bild', 'Hero Park'); + $version = $content->publishElementVersion($element, null, ['file' => 'inhalte/hero.jpg']); + $element->forceFill([ + 'display_title' => 'Lara im Park', + 'thumbnail_path' => 'vorschau/hero.jpg', + 'license_note' => 'Interner Rechtevermerk', + ])->save(); + Storage::disk('media_derived')->put('vorschau/hero.jpg', 'hero-bytes'); + Storage::disk('media_originals')->put('inhalte/hero.jpg', 'original-bytes'); + + $editor = User::factory()->redakteur()->create(); + $this->actingAs($editor, 'staff'); + + Livewire::test(ViewContentElement::class, ['record' => $element->getKey()]) + ->call('openRedaktion') + ->set('websiteCredit', 'Foto: Lara und Felix, eigene Aufnahme') + ->set('websiteAlt', 'Lara sitzt auf einer Parkbank') + ->call('saveRedaktion') + ->call('closeRedaktion') + ->set('bereich', 'website') + ->call('releaseForWebsite') + ->assertSee('Für die Website freigegeben'); + + $element->refresh(); + $this->assertSame(1, $element->versions()->count()); + $this->assertSame($version->id, $element->versions()->first()->id); + $this->assertSame(0, Grant::query()->count()); + $this->assertNotNull($element->website_released_at); + $this->assertSame('website/'.$element->id.'/datei.jpg', $element->website_public_path); + $this->assertSame('Foto: Lara und Felix, eigene Aufnahme', $element->website_credit); + Storage::disk('media_public')->assertExists($element->website_public_path); + Storage::disk('media_derived')->assertExists('vorschau/hero.jpg'); + Storage::disk('media_originals')->assertExists('inhalte/hero.jpg'); + $this->assertFalse(app(PublicMaterialReader::class)->isPublic($element)); + + $presentation = app(WebsiteMedia::class)->present($element); + $this->assertNotNull($presentation); + $this->assertSame('Lara im Park', $presentation->title); + $this->assertSame('Lara sitzt auf einer Parkbank', $presentation->alt); + $this->assertSame('Foto: Lara und Felix, eigene Aufnahme', $presentation->credit); + $this->assertSame('bild', $presentation->kind); + + $this->get($presentation->url) + ->assertOk() + ->assertStreamedContent('hero-bytes'); + + $this->get('/medien/'.$element->website_public_path)->assertNotFound(); + $this->assertTrue(IdentityChange::query()->where('subject_id', $element->id)->where('field', 'website_credit')->exists()); + $this->assertTrue(IdentityChange::query()->where('subject_id', $element->id)->where('field', 'website_released_at')->exists()); + } + + public function test_a_film_releases_only_its_teaser_and_can_be_withdrawn(): void + { + $content = app(ContentService::class); + $element = $content->createElement('film', 'film', 'Teaser Park'); + $version = $content->publishElementVersion($element, 'Teaser'); + MediaRendition::query()->create([ + 'content_element_version_id' => $version->id, + 'role' => 'master', + 'label' => 'master', + 'path' => 'filme/master.mp4', + ]); + Storage::disk('media_derived')->put('filme/master.mp4', 'master-bytes'); + + $release = app(WebsiteRelease::class); + $this->assertNotNull($release->refusal($element)); + $this->assertNull(app(WebsiteMedia::class)->present($element)); + Storage::disk('media_public')->assertDirectoryEmpty('/'); + + MediaRendition::query()->create([ + 'content_element_version_id' => $version->id, + 'role' => 'preview', + 'label' => 'teaser', + 'path' => 'teaser/kurz.mp4', + ]); + Storage::disk('media_derived')->put('teaser/kurz.mp4', 'teaser-bytes'); + $release->release($element); + + $element->refresh(); + $presentation = app(WebsiteMedia::class)->present($element); + $this->assertNotNull($presentation); + $this->assertSame('film', $presentation->kind); + $this->get($presentation->url)->assertOk()->assertStreamedContent('teaser-bytes'); + Storage::disk('media_public')->assertMissing('website/'.$element->id.'/datei-master'); + $this->assertStringNotContainsString('master', (string) $element->website_public_path); + + $release->withdraw($element); + $element->refresh(); + $this->assertNull($element->website_released_at); + $this->assertNull(app(WebsiteMedia::class)->present($element)); + $this->get(route('website.media', $element))->assertNotFound(); + Storage::disk('media_derived')->assertExists('filme/master.mp4'); + Storage::disk('media_derived')->assertExists('teaser/kurz.mp4'); + } + + public function test_trainer_guides_and_unready_files_stay_unpublished(): void + { + $content = app(ContentService::class); + $guide = $content->createElement('text', 'text', 'Abstand Trainer'); + $guide->editorial_content_kind_id = EditorialContentKind::query()->where('slug', 'traineranleitung')->value('id'); + $guide->thumbnail_path = 'vorschau/intern.jpg'; + $guide->output_class = 'bild'; + $guide->save(); + Storage::disk('media_derived')->put('vorschau/intern.jpg', 'intern'); + + $this->assertNotNull(app(WebsiteRelease::class)->refusal($guide)); + app(WebsiteRelease::class)->release($guide); + $this->assertNull($guide->fresh()->website_released_at); + + $image = $content->createElement('bild', 'bild', 'Ohne Datei'); + $image->thumbnail_path = 'vorschau/../originals/geheim.jpg'; + $image->save(); + app(WebsiteRelease::class)->release($image); + $this->assertNull($image->fresh()->website_public_path); + Storage::disk('media_public')->assertDirectoryEmpty('/'); + } + + public function test_a_slideshow_keeps_only_released_media_in_order(): void + { + $released = $this->releasedImage('Erstes Bild'); + $hidden = app(ContentService::class)->createElement('bild', 'bild', 'Zweites Bild'); + $later = $this->releasedImage('Drittes Bild'); + + $presentations = app(WebsiteMedia::class)->presentMany([$released->id, $hidden->id, $later->id, 'kein-medium']); + + $this->assertSame( + [$released->id, $later->id], + array_map(fn ($presentation) => $presentation->elementId, $presentations), + ); + } + + private function releasedImage(string $title): ContentElement + { + $element = app(ContentService::class)->createElement('bild', 'bild', $title); + app(ContentService::class)->publishElementVersion($element, null, ['file' => 'inhalte/'.$element->id.'.jpg']); + $element->thumbnail_path = 'vorschau/element-'.$element->id.'.jpg'; + $element->save(); + Storage::disk('media_derived')->put($element->thumbnail_path, 'bytes-'.$element->id); + app(WebsiteRelease::class)->release($element); + + return $element->fresh(); + } +} diff --git a/tests/Fixtures/legacy-pages/angebote.txt b/tests/Fixtures/legacy-pages/angebote.txt new file mode 100644 index 0000000..604a22e --- /dev/null +++ b/tests/Fixtures/legacy-pages/angebote.txt @@ -0,0 +1 @@ +Angebote Umfang, Rechte und Preise eines Angebots kommen aus dem Katalog. Sie werden hier nicht als freier Text ersetzt. Es sind noch keine Angebote veröffentlicht. Sobald ein Angebot aktiv ist, zeigt diese Seite seinen Umfang aus dem gespeicherten Stand. diff --git a/tests/Fixtures/legacy-pages/datenschutz.txt b/tests/Fixtures/legacy-pages/datenschutz.txt new file mode 100644 index 0000000..7240d9e --- /dev/null +++ b/tests/Fixtures/legacy-pages/datenschutz.txt @@ -0,0 +1 @@ +Datenschutz Die Datenschutzerklärung wird hier gepflegt und ist noch nicht eingesetzt. Profilangaben sind standardmäßig nicht öffentlich. Geschützte Medien werden nicht über einen öffentlichen Dateipfad ausgeliefert. diff --git a/tests/Fixtures/legacy-pages/home.txt b/tests/Fixtures/legacy-pages/home.txt new file mode 100644 index 0000000..4cb7f29 --- /dev/null +++ b/tests/Fixtures/legacy-pages/home.txt @@ -0,0 +1 @@ +Stark im Alltag Lara & Felix ist eine Plattform für Gewaltprävention, Selbstbehauptung und gewaltpräventive Bildungsarbeit. Sie unterstützt Erwachsene, die solche Angebote vorbereiten und durchführen. Die Lerninhalte richten sich unter anderem an Kinder. Kinder sind keine Benutzerinnen und Benutzer der Plattform und brauchen kein eigenes Konto. Die Filme „Lara & Felix“ sind die erste Produktreihe. Übungen, Programme und weitere Materialien lassen sich in derselben Struktur verwalten, ohne die Plattform auf eine einzelne Episode festzulegen. Prävention Worum es in der Bildungsarbeit geht. Materialien Filme und Begleitmaterial, sobald sie veröffentlicht sind. Für Trainer und Einrichtungen Wer die Plattform nutzt. Mitgliederbereich Nach der Anmeldung sehen Sie die Materialien, für die eine Berechtigung vorliegt. Anmelden diff --git a/tests/Fixtures/legacy-pages/impressum.txt b/tests/Fixtures/legacy-pages/impressum.txt new file mode 100644 index 0000000..458d2d4 --- /dev/null +++ b/tests/Fixtures/legacy-pages/impressum.txt @@ -0,0 +1 @@ +Impressum Die gesetzlich erforderlichen Angaben werden hier veröffentlicht, sobald sie feststehen. Diese Seite ist redaktionell pflegbar. Sie enthält noch keine Angaben zu einer verantwortlichen Stelle. diff --git a/tests/Fixtures/legacy-pages/materialien.txt b/tests/Fixtures/legacy-pages/materialien.txt new file mode 100644 index 0000000..4796065 --- /dev/null +++ b/tests/Fixtures/legacy-pages/materialien.txt @@ -0,0 +1 @@ +Filme und Lernmaterialien Hier erscheinen veröffentlichte Inhalte aus dem Katalog. Die Seite kopiert keine Produkttexte und nennt keine Preise. Solange noch kein Lizenzartikel veröffentlicht ist, bleibt diese Übersicht leer. Dieselbe Stelle zeigt später Filme, Übungen und Begleitmaterial aus den maßgeblichen Datensätzen. diff --git a/tests/Fixtures/legacy-pages/praevention.txt b/tests/Fixtures/legacy-pages/praevention.txt new file mode 100644 index 0000000..52ee89b --- /dev/null +++ b/tests/Fixtures/legacy-pages/praevention.txt @@ -0,0 +1 @@ +Prävention im Alltag Die Plattform stellt Materialien bereit, mit denen Trainerinnen, Trainer und pädagogische Fachkräfte Präventionsangebote durchführen. Es geht um Selbstbehauptung, das Erkennen von Grenzverletzungen und um Handlungsfähigkeit in konkreten Situationen. Die Durchführung bleibt bei den Erwachsenen vor Ort. Eine Entscheidungspause in einem Film ist eine Markierung für den Präsenzkurs. Daraus wird kein digitales Quiz und keine eigenständige Lernanwendung für Kinder. diff --git a/tests/Fixtures/legacy-pages/trainer.txt b/tests/Fixtures/legacy-pages/trainer.txt new file mode 100644 index 0000000..4db8976 --- /dev/null +++ b/tests/Fixtures/legacy-pages/trainer.txt @@ -0,0 +1 @@ +Für Trainer und Einrichtungen Die Plattform ist für Erwachsene, die geeignete Präventionsangebote durchführen. Dazu gehören Gewaltschutztrainer, Trainer und Übungsleiter, pädagogische Fachkräfte sowie Vereine und Bildungseinrichtungen. Ein Konto allein öffnet keine Materialien. Sichtbar wird, was eine konkrete Berechtigung erlaubt. Organisationen können später eigene Lizenzen halten. Eine persönliche Freischaltung ist keine Organisationslizenz. diff --git a/tests/Fixtures/legacy-pages/ueber.txt b/tests/Fixtures/legacy-pages/ueber.txt new file mode 100644 index 0000000..1e87c10 --- /dev/null +++ b/tests/Fixtures/legacy-pages/ueber.txt @@ -0,0 +1 @@ +Über das Projekt Lara & Felix – Stark im Alltag ist eine eigenständige Plattform für Gewaltprävention, Selbstbehauptung und gewaltpräventive Bildungsarbeit. Die erste Produktreihe sind die vorhandenen Filme. Das Fachmodell bleibt offen für weitere Medienarten, Übungen und Programme. diff --git a/tests/Support/BuildsCatalog.php b/tests/Support/BuildsCatalog.php new file mode 100644 index 0000000..f3bc7c7 --- /dev/null +++ b/tests/Support/BuildsCatalog.php @@ -0,0 +1,36 @@ +where('slug', $kind)->firstOrFail()->id; + + $version = $content->publishComposition( + tap($content->createComposition($designation), function ($composition) use ($kindId, $summary): void { + $composition->editorial_content_kind_id = $kindId; + $composition->summary = $summary; + $composition->save(); + }), + [['role' => 'Text', 'target' => $content->publishElementVersion($content->createElement('text', 'text', $designation.' Blatt'), 'Inhalt')]], + ); + + if ($released) { + app(CompositionDisplayRelease::class)->release($version, User::factory()->create()); + } + + return $version; + } +} diff --git a/tests/Support/offer_activate_worker.php b/tests/Support/offer_activate_worker.php new file mode 100644 index 0000000..b2c7e42 --- /dev/null +++ b/tests/Support/offer_activate_worker.php @@ -0,0 +1,47 @@ + \n"); + exit(2); +} + +$database = $argv[1]; +$offerId = (int) $argv[2]; +$articleId = (int) $argv[3]; +$rightsId = (int) $argv[4]; +$priceCents = (int) $argv[5]; +$delayMs = (int) $argv[6]; + +putenv('APP_ENV=testing'); +putenv('DB_CONNECTION=sqlite'); +putenv('DB_DATABASE='.$database); + +require __DIR__.'/../../vendor/autoload.php'; +$app = require __DIR__.'/../../bootstrap/app.php'; +$app->make(Kernel::class)->bootstrap(); + +if ($delayMs > 0) { + usleep($delayMs * 1000); +} + +$offers = app(OfferService::class); +$offer = Offer::query()->findOrFail($offerId); +$article = LicenseArticle::query()->findOrFail($articleId); +$rights = RightsProfileVersion::query()->findOrFail($rightsId); + +$offers->activate($offer, [ + ['target' => $article, 'rights' => $rights], +], [ + 'grant_kind' => 'kauf', + 'price_cents' => $priceCents, +]); + +echo "ok\n"; diff --git a/tests/TestCase.php b/tests/TestCase.php new file mode 100644 index 0000000..388f6b5 --- /dev/null +++ b/tests/TestCase.php @@ -0,0 +1,15 @@ +withoutVite(); + } +} diff --git a/tests/Unit/PageSectionsTest.php b/tests/Unit/PageSectionsTest.php new file mode 100644 index 0000000..70b0bf5 --- /dev/null +++ b/tests/Unit/PageSectionsTest.php @@ -0,0 +1,290 @@ +|null> $slots + * @param array $style + * @return array + */ + private function section(string $layout, array $slots, array $style = []): array + { + return ['layout' => $layout, 'style' => $style, 'slots' => $slots]; + } + + /** + * @return array + */ + private function heading(string $text): array + { + return ['type' => 'heading', 'v' => 1, 'data' => ['heading' => $text]]; + } + + public function test_required_layouts_exist_with_at_most_four_units(): void + { + $this->assertSame(['u4', 'u2_2', 'u1_3', 'u3_1', 'u1_2_1', 'u1_1_1_1', 'u1_1_2', 'u2_1_1'], array_keys(SectionLayouts::UNITS), 'Raster werden nur ergänzt (v1.7: 1 + 1 + 2 und 2 + 1 + 1 für gemischte Kartenraster).'); + + foreach (SectionLayouts::UNITS as $key => $units) { + $this->assertSame(4, array_sum($units), $key); + $this->assertLessThanOrEqual(4, count($units), $key); + } + + $this->assertSame('1 + 2 + 1', SectionLayouts::short('u1_2_1')); + $this->assertSame('1 + 1 + 2', SectionLayouts::short('u1_1_2')); + $this->assertSame(['lg' => 'minmax(0, 1fr) minmax(0, 1fr) minmax(0, 2fr)', 'md' => 'minmax(0, 1fr)'], SectionLayouts::columns(SectionLayouts::units('u1_1_2'))); + } + + public function test_columns_follow_the_units_and_stack_unequal_layouts_on_tablets(): void + { + $this->assertSame(['lg' => 'minmax(0, 1fr) minmax(0, 3fr)', 'md' => 'minmax(0, 1fr)'], SectionLayouts::columns([1, 3])); + $this->assertSame('repeat(2, minmax(0, 1fr))', SectionLayouts::columns([1, 1, 1, 1])['md']); + $this->assertSame('repeat(3, minmax(0, 1fr))', SectionLayouts::columns([1, 1, 1])['md']); + $this->assertSame('repeat(2, minmax(0, 1fr))', SectionLayouts::columns([2, 2])['md']); + $this->assertSame(['lg' => 'minmax(0, 1fr)', 'md' => 'minmax(0, 1fr)'], SectionLayouts::columns([3])); + } + + public function test_sections_are_normalized_with_slots_matching_the_layout(): void + { + $stored = $this->sections()->normalize([ + $this->section('u1_3', [$this->heading('Links'), $this->heading('Rechts')], ['background' => 'dark', 'divider' => 'line']), + $this->section('u1_1_1_1', [$this->heading('Eins'), null, $this->heading('Drei')]), + ]); + + $this->assertCount(2, $stored); + $this->assertSame('u1_3', $stored[0]['layout']); + $this->assertSame(2, $stored[0]['v'], 'Hülle Version 2: drei unabhängige Abstände.'); + $this->assertSame('dark', $stored[0]['style']['background']); + $this->assertSame('line', $stored[0]['style']['divider']); + $this->assertSame('standard', $stored[0]['style']['width']); + $this->assertCount(4, $stored[1]['slots'], 'Fehlende Plätze werden als leere Plätze ergänzt.'); + $this->assertNull($stored[1]['slots'][1]); + $this->assertNull($stored[1]['slots'][3]); + $this->assertNotEmpty($stored[0]['id']); + } + + public function test_flat_widgets_are_taken_over_as_full_width_sections(): void + { + $stored = $this->sections()->normalize([ + ['type' => 'heading', 'heading' => 'Altformat'], + $this->heading('Hülle'), + ]); + + $this->assertSame(['u4', 'u4'], array_column($stored, 'layout')); + $this->assertSame('Altformat', $stored[0]['slots'][0]['data']['heading']); + } + + public function test_more_widgets_than_slots_are_rejected_instead_of_dropped(): void + { + try { + $this->sections()->normalize([ + $this->section('u2_2', [$this->heading('A'), $this->heading('B'), $this->heading('C')]), + ]); + $this->fail('Überzähliges Widget wurde angenommen.'); + } catch (ValidationException $exception) { + $this->assertArrayHasKey('sections.0.slots', $exception->errors()); + $this->assertStringContainsString('2 Plätze', $exception->errors()['sections.0.slots'][0]); + } + } + + public function test_surplus_empty_slots_are_compacted_without_losing_widgets(): void + { + $stored = $this->sections()->normalize([ + $this->section('u2_2', [$this->heading('A'), null, $this->heading('C'), null]), + ]); + + $this->assertSame(['A', 'C'], array_map(fn ($slot) => $slot['data']['heading'], $stored[0]['slots'])); + } + + /** + * Layoutvertrag (ADR-38): Ein Platz muss eine der unterstützten Breiten haben. Der Premium-Einstieg ist seit + * Kit v1.6 nur für 3 oder 4 Einheiten vorgesehen (vorher Mindestbreite 2). + */ + public function test_widget_supported_widths_are_enforced_per_slot(): void + { + $hero = ['type' => 'hero', 'v' => 2, 'data' => ['heading' => 'Einstieg']]; + + foreach ([['u1_3', [$hero, null]], ['u2_2', [$hero, null]]] as [$layout, $slots]) { + try { + $this->sections()->normalize([$this->section($layout, $slots)]); + $this->fail("Einstieg im zu schmalen Platz ($layout) wurde angenommen."); + } catch (ValidationException $exception) { + $this->assertArrayHasKey('sections.0.slots.0.units', $exception->errors()); + $this->assertStringContainsString('3 oder 4 Rastereinheiten', $exception->errors()['sections.0.slots.0.units'][0]); + } + } + + $stored = $this->sections()->normalize([$this->section('u1_3', [null, $hero])]); + $this->assertSame('hero', $stored[0]['slots'][1]['type']); + $this->assertSame([3, 4], app(WidgetRegistry::class)->get('hero')->supportedUnits()); + + $imageText = ['type' => 'image_text', 'v' => 3, 'data' => ['body' => '

    Schmal

    ']]; + $stored = $this->sections()->normalize([$this->section('u1_1_1_1', [$imageText, null, null, null])]); + $this->assertSame('image_text', $stored[0]['slots'][0]['type'], 'Bild und Text ist für 1 bis 4 Einheiten freigegeben.'); + } + + public function test_free_style_values_and_unknown_layouts_are_rejected(): void + { + foreach ([ + [['layout' => 'u5', 'slots' => []], 'sections.0.layout'], + [$this->section('u4', [], ['background' => '#ff00ff']), 'sections.0.style.background'], + [$this->section('u4', [], ['css' => 'color: red']), 'sections.0.style.css'], + [$this->section('u4', [], ['spacing_top' => 'riesig']), 'sections.0.style.spacing_top'], + [$this->section('u4', [], ['spacing_bottom' => '0px']), 'sections.0.style.spacing_bottom'], + [$this->section('u4', [], ['gap' => '3rem']), 'sections.0.style.gap'], + ] as [$section, $key]) { + try { + $this->sections()->normalize([$section]); + $this->fail('Freier Wert wurde angenommen: '.$key); + } catch (ValidationException $exception) { + $this->assertArrayHasKey($key, $exception->errors()); + } + } + } + + public function test_background_image_must_be_public_and_is_dropped_for_other_backgrounds(): void + { + try { + $this->sections()->normalize([$this->section('u4', [$this->heading('A')], ['background' => 'image', 'image' => 'bibliothek/standbild.jpg'])]); + $this->fail('Geschütztes Bild wurde als Hintergrund angenommen.'); + } catch (ValidationException $exception) { + $this->assertArrayHasKey('sections.0.style.image', $exception->errors()); + } + + try { + $this->sections()->normalize([$this->section('u4', [$this->heading('A')], ['background' => 'image'])]); + $this->fail('Hintergrundbild ohne Bild wurde angenommen.'); + } catch (ValidationException $exception) { + $this->assertArrayHasKey('sections.0.style.image', $exception->errors()); + } + + $stored = $this->sections()->normalize([ + $this->section('u4', [$this->heading('A')], ['background' => 'image', 'image' => 'cms/flaeche.jpg', 'focus' => 'top', 'overlay' => 'dark']), + $this->section('u4', [$this->heading('B')], ['background' => 'light', 'image' => 'cms/flaeche.jpg']), + ]); + + $this->assertSame('cms/flaeche.jpg', $stored[0]['style']['image']); + $this->assertNull($stored[1]['style']['image']); + $this->assertSame(['cms/flaeche.jpg'], $this->sections()->mediaPaths($stored)); + } + + public function test_ids_are_unique_across_the_whole_page_after_duplicating_a_section(): void + { + $section = ['id' => 'abschnitt-a'] + $this->section('u2_2', [ + ['id' => 'widget-a'] + $this->heading('A'), + ['id' => 'widget-b'] + $this->heading('B'), + ]); + + $stored = $this->sections()->normalize([$section, $section]); + + $this->assertSame('abschnitt-a', $stored[0]['id']); + $this->assertNotSame('abschnitt-a', $stored[1]['id']); + $widgetIds = array_column(array_merge($stored[0]['slots'], $stored[1]['slots']), 'id'); + $this->assertCount(4, array_unique($widgetIds)); + $this->assertSame(['widget-a', 'widget-b'], array_slice($widgetIds, 0, 2)); + } + + public function test_all_errors_of_a_page_are_reported_together(): void + { + try { + $this->sections()->normalize([ + $this->section('u2_2', [['type' => 'heading', 'v' => 1, 'data' => []], null]), + $this->section('u4', [['type' => 'call_to_action', 'v' => 1, 'data' => ['heading' => 'X', 'label' => 'Los', 'url' => 'javascript:alert(1)']]]), + ]); + $this->fail('Fehlerhafte Seite wurde angenommen.'); + } catch (ValidationException $exception) { + $this->assertArrayHasKey('sections.0.slots.0.data.heading', $exception->errors()); + $this->assertArrayHasKey('sections.1.slots.0.data.url', $exception->errors()); + } + } + + public function test_reading_without_sections_wraps_legacy_blocks_in_single_column_sections(): void + { + $sections = $this->sections()->read(null, [ + ['type' => 'heading', 'heading' => 'Alt'], + ['type' => 'gibt_es_nicht'], + ['type' => 'prose', 'v' => 1, 'data' => ['body' => 'Text']], + ]); + + $this->assertCount(2, $sections); + $this->assertSame('u4', $sections[0]['layout']); + $this->assertSame(['compact', 'compact', 'normal'], [$sections[0]['style']['spacing_top'], $sections[0]['style']['spacing_bottom'], $sections[0]['style']['gap']]); + $this->assertSame('none', $sections[1]['style']['spacing_top'], 'Wie bisher steht zwischen zwei Altbausteinen nur einmal der kompakte Abstand.'); + $this->assertSame('Alt', $sections[0]['slots'][0]['data']['heading']); + $this->assertSame('prose', $sections[1]['slots'][0]['type']); + } + + public function test_reading_is_lenient_with_unknown_stored_values(): void + { + $sections = $this->sections()->read([ + ['id' => 'x', 'layout' => 'u9', 'style' => ['background' => 'pink', 'width' => 'wide'], 'slots' => [['type' => 'heading', 'v' => 1, 'data' => ['heading' => 'A']]]], + ]); + + $this->assertSame('u4', $sections[0]['layout']); + $this->assertSame('default', $sections[0]['style']['background']); + $this->assertSame('wide', $sections[0]['style']['width']); + } + + public function test_flatten_keeps_reading_order_for_the_rollback_column(): void + { + $stored = $this->sections()->normalize([ + $this->section('u1_1_1_1', [$this->heading('1'), null, $this->heading('3'), $this->heading('4')]), + $this->section('u4', [$this->heading('5')]), + ]); + + $this->assertSame(['1', '3', '4', '5'], array_map(fn ($widget) => $widget['data']['heading'], $this->sections()->flatten($stored))); + $this->assertSame('1', $this->sections()->pageTitle($stored)); + } + + public function test_style_summary_names_background_and_divider(): void + { + $this->assertSame('Dunkle Markenfläche · Breit · Trenner: Dezente Linie', SectionStyle::summary(['background' => 'dark', 'width' => 'wide', 'divider' => 'line'])); + } + + public function test_duplicated_section_is_inserted_right_after_its_original(): void + { + $items = ['a' => ['n' => 1], 'b' => ['n' => 2], 'c' => ['n' => 3]]; + + $this->assertSame(['a', 'b', 'kopie', 'c'], array_keys(SectionEditor::insertCopyAfter($items, 'b', 'kopie'))); + $this->assertSame(['n' => 2], SectionEditor::insertCopyAfter($items, 'b', 'kopie')['kopie']); + $this->assertSame($items, SectionEditor::insertCopyAfter($items, 'fehlt', 'kopie')); + } + + public function test_layout_change_in_the_editor_never_drops_a_widget(): void + { + $slots = [ + 'a' => ['widget' => ['w1' => ['type' => 'heading']]], + 'b' => ['widget' => []], + 'c' => ['widget' => ['w3' => ['type' => 'prose']]], + 'd' => ['widget' => []], + ]; + + $two = SectionEditor::arrangeSlots($slots, 'u2_2'); + $this->assertSame(['a', 'c'], array_keys($two)); + + $one = SectionEditor::arrangeSlots($two, 'u4'); + $this->assertCount(2, $one, 'Passen die Widgets nicht, bleiben alle erhalten; das Speichern weist die Seite ab.'); + + $four = SectionEditor::arrangeSlots($two, 'u1_1_1_1'); + $this->assertCount(4, $four); + $this->assertSame(['a', 'c'], array_slice(array_keys($four), 0, 2)); + $this->assertSame(2, SectionEditor::filledCount($four)); + } +} diff --git a/tests/Unit/WidgetRegistryTest.php b/tests/Unit/WidgetRegistryTest.php new file mode 100644 index 0000000..89e5306 --- /dev/null +++ b/tests/Unit/WidgetRegistryTest.php @@ -0,0 +1,378 @@ +registry()->all(); + + $this->assertSame( + ['hero', 'heading', 'prose', 'image_text', 'cards', 'catalog_cards', 'topic_card', 'media_card', 'program_card', 'call_to_action', 'faq'], + array_keys($types), + ); + + foreach ($types as $key => $type) { + $this->assertSame($key, $type->key()); + $this->assertNotSame('', $type->label()); + $this->assertNotSame('', $type->description()); + $this->assertGreaterThanOrEqual(1, $type->version()); + $this->assertNotEmpty($type->variants()); + $this->assertArrayHasKey($type->defaultVariant(), $type->variants()); + $this->assertNotEmpty($type->dataRules()); + $this->assertNotEmpty($type->editorSchema()); + $this->assertTrue(view()->exists($type->view()), "Ansicht für $key fehlt"); + } + } + + public function test_reference_widgets_offer_at_least_two_variants(): void + { + foreach (['hero', 'image_text', 'cards', 'catalog_cards'] as $key) { + $this->assertGreaterThanOrEqual(2, count($this->registry()->get($key)->variants()), $key); + } + + $this->assertSame(['image_left', 'image_right'], array_keys($this->registry()->get('image_text')->variants())); + } + + public function test_registration_rejects_duplicate_and_invalid_keys(): void + { + $registry = new WidgetRegistry([$this->customWidget('teaser')]); + + $this->expectException(InvalidArgumentException::class); + $registry->register($this->customWidget('teaser')); + } + + public function test_registration_rejects_keys_that_are_not_stable_identifiers(): void + { + $this->expectException(InvalidArgumentException::class); + + new WidgetRegistry([$this->customWidget('Teaser Box')]); + } + + /** Gemeinsamer Layoutvertrag (ADR-38) für jede registrierte Art. */ + public function test_every_widget_declares_the_shared_layout_contract(): void + { + foreach ($this->registry()->all() as $key => $type) { + $units = $type->supportedUnits(); + $this->assertNotEmpty($units, $key); + $this->assertSame([], array_diff($units, [1, 2, 3, 4]), $key); + $this->assertSame(min($units), $type->minUnits(), $key); + $this->assertTrue($type->supportsUnits($type->preferredUnits()), $key); + $this->assertNotEmpty($type->stages(), $key); + $this->assertNotSame('', $type->narrowBehavior(), $key); + $this->assertSame([], array_diff(array_keys($type->heights()), array_keys(WidgetType::HEIGHTS)), $key); + + if ($type->heights() !== []) { + $this->assertArrayHasKey($type->defaultHeight(), $type->heights(), $key); + $this->assertSame($type->heights(), $type->settingOptions()['height'], $key); + } + } + + $this->assertSame([3, 4], $this->registry()->get('hero')->supportedUnits()); + $this->assertSame(['compact', 'normal', 'large'], array_keys($this->registry()->get('hero')->heights())); + $this->assertSame([1, 2, 3, 4], $this->registry()->get('image_text')->supportedUnits()); + $this->assertSame(['compact', 'normal', 'spacious'], array_keys($this->registry()->get('image_text')->heights())); + $this->assertSame(['auto', 'fill'], array_keys($this->registry()->get('call_to_action')->heights())); + $this->assertSame([2, 3, 4], $this->registry()->get('faq')->supportedUnits()); + $this->assertSame('3 oder 4', $this->registry()->get('hero')->unitsLabel()); + $this->assertSame('1 bis 4', $this->registry()->get('cards')->unitsLabel()); + } + + public function test_height_is_an_enumerated_setting_with_a_default(): void + { + $widget = $this->registry()->normalize([ + ['type' => 'hero', 'v' => 2, 'settings' => ['height' => 'large'], 'data' => ['heading' => 'X']], + ])[0]; + $this->assertSame('large', $widget['settings']['height']); + $this->assertSame('normal', $this->registry()->get('hero')->height(['settings' => []])); + + try { + $this->registry()->normalize([['type' => 'hero', 'v' => 2, 'settings' => ['height' => '900px'], 'data' => ['heading' => 'X']]]); + $this->fail('Freie Höhe wurde angenommen.'); + } catch (ValidationException $exception) { + $this->assertArrayHasKey('blocks.0.settings.height', $exception->errors()); + } + + try { + $this->registry()->normalize([['type' => 'prose', 'v' => 1, 'settings' => ['height' => 'compact'], 'data' => ['body' => 'Text']]]); + $this->fail('Höhe für eine Art ohne Höhenwahl wurde angenommen.'); + } catch (ValidationException $exception) { + $this->assertArrayHasKey('blocks.0.settings.height', $exception->errors()); + } + } + + public function test_a_new_widget_type_works_through_the_contract_alone(): void + { + $registry = new WidgetRegistry([$this->customWidget('teaser')]); + $this->app->instance(WidgetRegistry::class, $registry); + + $stored = $registry->normalize([ + ['type' => 'teaser', 'v' => 1, 'variant' => 'wide', 'data' => ['heading' => 'Neu']], + ]); + + $this->assertSame('teaser', $stored[0]['type']); + $this->assertSame('wide', $stored[0]['variant']); + $this->assertSame(['heading' => 'Neu'], $stored[0]['data']); + + $html = app(WidgetRenderer::class)->renderAll($stored, RenderContext::publicPage())->toHtml(); + $this->assertStringContainsString('

    Neu

    ', $html); + $this->assertStringContainsString('widget-variant-wide', $html); + + $block = WidgetEditor::block($registry->get('teaser')); + $this->assertSame('teaser', $block->getName()); + // Sichtbar kurzer Name und Inhalt, vollständig (mit Darstellung) im Titel (CMS-Abschluss). + $label = (string) $block->getLabel(['variant' => 'wide', 'data' => ['heading' => 'Neu']]); + $this->assertStringContainsString('title="Teaser · Breit – Neu"', $label); + $this->assertStringContainsString('Teaser', $label); + $this->assertStringContainsString('Neu', $label); + } + + public function test_unknown_type_and_unregistered_variant_are_rejected(): void + { + try { + $this->registry()->normalize([['type' => 'html', 'v' => 1, 'data' => ['markup' => '']]]); + $this->fail('Unbekannte Art wurde angenommen.'); + } catch (ValidationException $exception) { + $this->assertArrayHasKey('blocks.0.type', $exception->errors()); + } + + try { + $this->registry()->normalize([['type' => 'hero', 'v' => 2, 'variant' => 'gross-und-bunt', 'data' => ['heading' => 'X']]]); + $this->fail('Unbekannte Variante wurde angenommen.'); + } catch (ValidationException $exception) { + $this->assertArrayHasKey('blocks.0.variant', $exception->errors()); + } + } + + public function test_free_settings_are_rejected(): void + { + $this->expectException(ValidationException::class); + + $this->registry()->normalize([ + ['type' => 'heading', 'v' => 1, 'settings' => ['class' => 'bg-red-500'], 'data' => ['heading' => 'X']], + ]); + } + + /** + * Bewusst geändert (zentrale Medienverwaltung): Der Alternativtext gehört zum Medium im Medienmanager. Im Widget ist er + * eine optionale Abweichung und deshalb keine Pflicht mehr; ein früheres CMS-Bild ohne Zuordnung bleibt gültig. + */ + public function test_image_text_takes_the_alternative_text_from_the_medium_and_keeps_legacy_images(): void + { + $stored = $this->registry()->normalize([ + ['type' => 'image_text', 'v' => 2, 'data' => ['body' => '

    Text

    '], 'refs' => ['image' => 'cms/bild.jpg']], + ]); + $this->assertSame('cms/bild.jpg', $stored[0]['refs']['image']); + $this->assertNull($stored[0]['data']['alt']); + + $stored = $this->registry()->normalize([ + ['type' => 'image_text', 'v' => 2, 'data' => ['body' => '

    Ohne Bild

    '], 'refs' => []], + ]); + $this->assertNull($stored[0]['refs']['image']); + } + + public function test_links_reject_script_urls_in_every_widget(): void + { + $cases = [ + ['type' => 'call_to_action', 'heading' => 'Weiter', 'label' => 'Öffnen', 'url' => 'javascript:alert(1)'], + ['type' => 'cards', 'v' => 1, 'data' => ['items' => [['title' => 'A', 'url' => 'javascript:alert(1)']]]], + ['type' => 'hero', 'v' => 1, 'data' => ['heading' => 'A', 'cta_label' => 'Los', 'cta_url' => '//fremd.example/x']], + ]; + + foreach ($cases as $case) { + try { + $this->registry()->normalize([$case]); + $this->fail('Unsichere Adresse wurde angenommen: '.$case['type']); + } catch (ValidationException) { + $this->addToAssertionCount(1); + } + } + } + + public function test_images_must_come_from_the_public_website_area(): void + { + $this->expectException(ValidationException::class); + + $this->registry()->normalize([ + ['type' => 'hero', 'v' => 1, 'data' => ['heading' => 'A', 'alt' => 'Bild'], 'refs' => ['image' => 'bibliothek/geschuetzt.jpg']], + ]); + } + + public function test_formatted_text_is_sanitized_when_saved(): void + { + $stored = $this->registry()->normalize([[ + 'type' => 'image_text', + 'v' => 2, + 'data' => ['body' => '

    Hallo Welt böse gut

    '], + ]]); + + $body = $stored[0]['data']['body']; + $this->assertStringNotContainsString('script', $body); + $this->assertStringNotContainsString('onclick', $body); + $this->assertStringNotContainsString('javascript:', $body); + $this->assertStringNotContainsString('iframe', $body); + $this->assertStringContainsString('Welt', $body); + $this->assertStringContainsString('href="/praevention"', $body); + } + + public function test_legacy_blocks_are_read_as_version_one_envelopes(): void + { + $widget = $this->registry()->upcast(['type' => 'heading', 'heading' => 'Alt', 'intro' => 'Einleitung']); + + $this->assertSame([ + 'id' => null, + 'type' => 'heading', + 'v' => 1, + 'variant' => 'standard', + 'settings' => [], + 'data' => ['heading' => 'Alt', 'intro' => 'Einleitung'], + 'refs' => [], + ], $widget); + } + + public function test_legacy_image_text_is_upgraded_to_the_current_version_on_read(): void + { + $legacy = ['type' => 'image_text', 'image' => 'cms/alt.jpg', 'alt' => 'Kinder im Kreis', 'body' => "Erster Absatz & mehr.\n\nZweiter ."]; + + $widget = $this->registry()->upcast($legacy); + + $this->assertSame(3, $widget['v']); + $this->assertSame('image_left', $widget['variant']); + $this->assertSame(['image' => 'cms/alt.jpg'], $widget['refs']); + $this->assertSame('Kinder im Kreis', $widget['data']['alt']); + $this->assertNull($widget['data']['title']); + $this->assertSame('

    Erster Absatz & mehr.

    Zweiter <Absatz>.

    ', $widget['data']['body']); + } + + public function test_stored_version_one_envelope_is_upgraded_as_well(): void + { + $widget = $this->registry()->upcast([ + 'id' => 'abc', 'type' => 'image_text', 'v' => 1, 'variant' => 'standard', + 'data' => ['image' => null, 'alt' => 'x', 'body' => 'Nur Text'], 'refs' => [], + ]); + + $this->assertSame(3, $widget['v']); + $this->assertSame('abc', $widget['id']); + $this->assertSame('image_left', $widget['variant']); + $this->assertSame('

    Nur Text

    ', $widget['data']['body']); + } + + public function test_widgets_from_a_newer_schema_cannot_be_saved(): void + { + $this->expectException(ValidationException::class); + + $this->registry()->normalize([['type' => 'heading', 'v' => 99, 'data' => ['heading' => 'Zukunft']]]); + } + + public function test_read_skips_unknown_types_without_failing(): void + { + $widgets = $this->registry()->read([ + ['type' => 'gibt_es_nicht', 'v' => 1], + ['type' => 'prose', 'body' => 'Bleibt lesbar'], + ]); + + $this->assertCount(1, $widgets); + $this->assertSame('prose', $widgets[0]['type']); + } + + public function test_ids_are_kept_and_duplicates_get_new_ids(): void + { + $stored = $this->registry()->normalize([ + ['id' => 'erster', 'type' => 'heading', 'v' => 1, 'data' => ['heading' => 'A']], + ['id' => 'erster', 'type' => 'heading', 'v' => 1, 'data' => ['heading' => 'Kopie']], + ['type' => 'prose', 'body' => 'Ohne Kennung'], + ]); + + $this->assertSame('erster', $stored[0]['id']); + $this->assertNotSame('erster', $stored[1]['id']); + $this->assertNotEmpty($stored[2]['id']); + $this->assertNotSame($stored[1]['id'], $stored[2]['id']); + } + + public function test_only_declared_fields_are_stored(): void + { + $stored = $this->registry()->normalize([[ + 'type' => 'cards', + 'v' => 1, + 'data' => ['items' => [['title' => 'A', 'price' => '99 €', 'url' => '/a']], 'license' => 'alle'], + 'refs' => ['offer' => 7], + ]]); + + $this->assertSame(['items' => [['title' => 'A', 'text' => null, 'url' => '/a', 'image' => null]]], $stored[0]['data']); + $this->assertSame([], $stored[0]['refs']); + } + + public function test_rich_text_from_plain_text_escapes_markup(): void + { + $this->assertSame('

    <b>fett</b>

    ', RichText::fromPlainText('fett')); + $this->assertSame('', RichText::fromPlainText(" \n ")); + } + + private function customWidget(string $key): WidgetType + { + return new class($key) extends WidgetType + { + public function __construct(private readonly string $widgetKey) {} + + public function key(): string + { + return $this->widgetKey; + } + + public function label(): string + { + return 'Teaser'; + } + + public function description(): string + { + return 'Testwidget'; + } + + public function variants(): array + { + return ['standard' => 'Standard', 'wide' => 'Breit']; + } + + public function dataRules(): array + { + return ['heading' => ['required', 'string', 'max:50']]; + } + + public function dataFields(): array + { + return [TextInput::make('heading')]; + } + + public function view(): string + { + return 'widgets.heading'; + } + + public function summary(array $widget): string + { + return (string) ($widget['data']['heading'] ?? ''); + } + }; + } +} diff --git a/vite.config.js b/vite.config.js new file mode 100644 index 0000000..9270b47 --- /dev/null +++ b/vite.config.js @@ -0,0 +1,30 @@ +import { defineConfig } from 'vite'; +import laravel from 'laravel-vite-plugin'; +import { bunny } from 'laravel-vite-plugin/fonts'; +import tailwindcss from '@tailwindcss/vite'; + +export default defineConfig({ + plugins: [ + laravel({ + input: ['resources/css/app.css', 'resources/js/app.js'], + refresh: true, + fonts: [ + // Vorläufige Markenschriften (Website-Zielkonzept 7.2, nicht freigegeben); beim Build lokal abgelegt. + bunny('Nunito', { + weights: [700, 800, 900], + optimizedFallbacks: false, + }), + bunny('Source Sans 3', { + weights: [400, 600], + optimizedFallbacks: false, + }), + ], + }), + tailwindcss(), + ], + server: { + watch: { + ignored: ['**/storage/framework/views/**'], + }, + }, +});