Dokumentiere die redaktionellen Stammdaten mit Prüfung auf luf-test
CI Feature / test (push) Successful in 1m9s
Deploy Test / test (push) Successful in 1m8s
Deploy Test / deploy (push) Successful in 31s

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
LarsandClaude Opus 5.5 committed 2026-11-20 21:34:00 +01:00
1 parent 70695db290
commit e20f428a57
10 files changed
+85 -2

No files matched your search

+2 -2
View File
@@ -63,6 +63,6 @@ ## Entwicklung
## Verwaltungsoberfläche
- Maßgeblich sind `docs/ux/verwaltung/14-verwaltungsstandard.md` (Design und Interaktion) und `15-umbauauftrag.md` (Auftrag, Nachweise). Keine neue allgemeine Designabstimmung verlangen. Einstieg für alle Agenten: `AGENTS.md`, `.cursor/rules/verwaltung-ux.mdc`.
- Gemeinsame Bausteine wiederverwenden statt neue Masken bauen: `resources/views/filament/verwaltung/` (`kopf`, `redaktion`, `texte`, `praesentation`, `einordnung`, `picker`, `bestaetigung`, `abgang`, `aufbau`, `bestand`) mit dem Trait `App\Filament\Support\ManagesEditorialSurface`. Listen nutzen `verwaltung/bestand` mit `ShowsBestand` (bzw. `ListsCompositions`, `ListsCatalog`) und den Eintrag `<x-vw.eintrag>`, 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. 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`).
- Gemeinsame Bausteine wiederverwenden statt neue Masken bauen: `resources/views/filament/verwaltung/` (`kopf`, `redaktion`, `texte`, `praesentation`, `einordnung`, `picker`, `bestaetigung`, `abgang`, `aufbau`, `bestand`) mit dem Trait `App\Filament\Support\ManagesEditorialSurface`. Listen nutzen `verwaltung/bestand` mit `ShowsBestand` (bzw. `ListsCompositions`, `ListsCatalog`) und den Eintrag `<x-vw.eintrag>`, 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`.
- 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`.
@@ -31,6 +31,7 @@ ## Bisher und jetzt
| 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` |
+82
View File
@@ -0,0 +1,82 @@
# 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 die betroffenen Zuordnungen 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.
- **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“; Detail trennt „Fachliche Materialart“ und „Medienart“ |
| Mitgliederbibliothek | Einordnungsfilter |
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`, 8 Tests) | Alle neun geforderten Fälle sind abgedeckt:<br>1. Anlegen und im passenden Editor wählen.<br>2. Speichern und über Einordnungs- und Materialartfilter finden.<br>3. Umbenennen: Kennung und Zuordnung bleiben; die Vertraulichkeit hängt an der Kennung.<br>4. Deaktivieren: Zuordnung sichtbar, „(inaktiv)“; bei einem anderen Medium nicht angeboten und serverseitig abgewiesen.<br>5. Teaser speichern: inaktive Zuordnung und inaktive Materialart bleiben.<br>6. Reaktivieren, „Nach unten“ und „Nach oben“.<br>7. Programm und Modul weder im Medieneditor noch im Medienfilter noch im Picker; Speichern abgewiesen.<br>8. Säulenverwaltung unverändert erreichbar.<br>9. Katalogverwalter erhält 403 auf Seite und Livewire-Komponente.<br>Zusätzlich: Kontextänderung mit Bestätigung, Löschen nur ohne Zuordnung, Systemkennungen geschützt. Gesamt 342 Tests grün |
| luf-test, Ablauf mit Prüfwert | Prüfwert „UX-Prüfung Zielgruppe“ angelegt und dem Prüfmedium 22 „Testplatzhalter Hintergrund“ zugeordnet:<br>• Verwendung „1 Medium“; Medienfilter `?einordnung=20` findet das Medium.<br>• Umbenannt: sichtbar und gewählt.<br>• Deaktiviert: Dialog nennt „1 Medium“, im Medium „(inaktiv)“ und gewählt, beim Medium 10 nicht angeboten.<br>• Teaser gespeichert und zurückgesetzt: Zuordnung bleibt.<br>• Reaktiviert, nach oben und wieder nach unten.<br>• Materialart im Medium und im Picker ohne Programm und Modul.<br>• 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) |
| 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) | |
Binary file not shown.

After

Width:  |  Height:  |  Size: 113 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 92 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 105 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 72 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 128 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 128 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 104 KiB