diff --git a/CLAUDE.md b/CLAUDE.md index f6a9d3f..df51dc2 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -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 ``, 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`). +- 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 ``, 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“. Fachliche Säulen gibt es nur in der Säulenverwaltung (`pillars`); Zuordnung über `PillarService::assign`, nie über eine Dimension. 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/docs/ux/verwaltung/16-funktionszuordnung.md b/docs/ux/verwaltung/16-funktionszuordnung.md index 00880e1..a9c394f 100644 --- a/docs/ux/verwaltung/16-funktionszuordnung.md +++ b/docs/ux/verwaltung/16-funktionszuordnung.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` | +| Fachliche Säulen: Medien und Seiten über die Säulenverwaltung, Module, Programme und Lizenzartikel über eine nicht abgeglichene Kopie als Dimension | Eine Quelle: Säulenverwaltung (`pillars`) für alle fünf Objektarten; Auswahl in der Redaktion, Filter in Medien, Modulen und Programmen, Aufbau-Picker und Mitgliederbibliothek; alte Zuordnungen verlustfrei übernommen (`luf:saeulen-uebernehmen`); Kopie bleibt nur als Verlauf | `PillarService`, `AssignsPillars`, `LegacyPillarAdoption` | | 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` | diff --git a/docs/ux/verwaltung/abnahme/stammdaten.md b/docs/ux/verwaltung/abnahme/stammdaten.md index 38c6eec..0551c03 100644 --- a/docs/ux/verwaltung/abnahme/stammdaten.md +++ b/docs/ux/verwaltung/abnahme/stammdaten.md @@ -68,12 +68,51 @@ ## Prüfung ## 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. +- **Säulen-Spiegel: behoben am 21.11.2026**, siehe „Nachtrag: Säulen aus einer Quelle“. - **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). +## Nachtrag: Säulen aus einer Quelle (21.11.2026) + +**Geprüfter Code-Stand:** `develop` mit `7c48a64` auf `luf-test` (Migration `2026_11_21_100000` gelaufen). + +**Gemeinsame Quelle:** die Säulenverwaltung (Tabelle `pillars`). Medien (`content_element_pillar`), Seiten (`page_pillar`) und jetzt auch Module und Programme (`composition_pillar`) sowie Lizenzartikel (`license_article_pillar`) verweisen mit demselben Fremdschlüssel auf sie; die Datenbank verhindert das Löschen einer verwendeten Säule (`restrictOnDelete`). Auswahl, Anzeige und Filter lesen die Säule selbst, deshalb gilt ein neuer oder geänderter Name sofort überall. + +**Befund vorher:** +- Medien und Seiten verwendeten die Säulen direkt. Module, Programme und Lizenzartikel nutzten die Dimension „Fachliche Säule“, eine Kopie, die die Migration vom 16.11. einmal gespiegelt hat. Später angelegte oder umbenannte Säulen fehlten dort. +- Dieselbe Kopie speiste Filter in Medienliste („Einordnung“), Aufbau-Picker, Listen für Programme und Module und die Mitgliederbibliothek. Für Medien waren die Spiegelzeilen veraltet. +- Abgeleitete Säulen (aus enthaltenen Medien) sind nur eine Laufzeitableitung (`CatalogReading::memberPillars`). Der Code schreibt nirgends Zuordnungen mit Herkunft „abgeleitet“. +- Veröffentlichte Seiten, Revisionen und Widgets verweisen auf `pillars`, nicht auf die alten Werte. Außer den Zuordnungszeilen verweist nichts auf die Kopie. + +**Umsetzung:** +- Editoren: Modul, Programm und Lizenzartikel wählen „Fachliche Säulen“ aus der Säulenverwaltung (gemeinsam über `AssignsPillars`, Mehrfachauswahl, wie bei Medien). Die Zuordnung ersetzt die bisherige vollständig; andere Angaben zu speichern lässt sie unverändert. +- Filter: Module und Programme (Arbeitsplatz und Listen) und Aufbau-Picker haben „Fachliche Säule“. Die Mitgliederbibliothek bietet nur Säulen an, die ein sichtbares Objekt tatsächlich trägt (Entscheidung, damit neue oder interne Säulen ohne Zuordnung nicht erscheinen). Es zählt die direkte Zuordnung. Alte Adressen mit einem Säulenwert in `?einordnung=`, `?pillar=` oder `dimension[]=` gelten für die verknüpfte Säule. +- Ausgeblendet: Die alte Dimension erscheint in keinem Editor, Filter oder in den Stammdaten. Ihre Tabellen und Zeilen bleiben als Verlauf unverändert bestehen. +- Löschschutz: Eine Säule mit zugeordneten Medien, Modulen, Programmen, Lizenzartikeln oder Seiten wird nicht gelöscht; die Meldung nennt die Zahlen. Die Säulenliste zählt alle Objektarten. +- Rechte: Modul und Programm bearbeitet nur die Redaktion, den Lizenzartikel die Redaktion mit Katalogrolle; ein Konto ohne diese Rollen erhält 403, auch über direkte Livewire-Aufrufe. +- Veröffentlichung: Anlegen und Zuordnen einer Säule veröffentlicht nichts. Die Themenseite bleibt Sache der Säulenverwaltung. + +**Übernahme der alten Zuordnungen** (`LegacyPillarAdoption`, in der Migration und mit `php artisan luf:saeulen-uebernehmen [--dry-run]`): +- Ein alter Wert gilt nur dann als Säule, wenn seine Kennung `pfeiler-` (die die Spiegelung geschrieben hat) auf eine vorhandene Säule zeigt, die nicht jünger als der Wert ist. Gleiche Nummern ohne Kennung oder ähnliche Namen genügen nicht. Die Verknüpfung steht in `editorial_dimension_values.pillar_id`; eine abweichende Bezeichnung nach einem Umbenennen wird nur berichtet. +- Übernommen werden nur direkte Zuordnungen von Modulen, Programmen und Lizenzartikeln. Wiederholte Läufe fügen nichts hinzu (insert-or-ignore, Test). +- Nicht übernommen, sondern mit Datensatz und Grund gemeldet: Werte ohne belastbare Kennung, Kennungen auf fehlende Säulen, abgeleitete Zuordnungen, Zuordnungen zu fehlenden Objekten, unbekannte Objektarten. Es wird nichts gelöscht oder geraten. +- Medien bleiben bei ihrer Zuordnung (`content_element_pillar`); die gespiegelten Zeilen sind veraltet und werden nur gezählt. +- Alte Zeilen werden nie geändert oder gelöscht. + +**Ergebnis auf luf-test:** +- 5 alte Säulenwerte sind über ihre Kennung mit den Säulen 1 bis 5 verknüpft. +- Zu übernehmen waren 0 Zuordnungen (Module und Programme 0, Lizenzartikel 0). 0 gespiegelte Medienzeilen; 3 Medienzuordnungen bestehen nur in der Medienzuordnung. +- Keine ungeklärten Fälle. +- Auf Prod hat die Kopie noch keine Werte, weil dort noch keine Säulen angelegt waren; die Migration hat dort nichts zu übernehmen. Nach dem nächsten Merge bieten Module, Programme und Lizenzartikel auf Prod die dort angelegten Säulen an (vorher gab es dort keine Auswahl). + +**Tests:** `PillarUnificationTest` (13): anlegen und bei Modul, Programm und Lizenzartikel wählen (ohne Veröffentlichung); umbenennen (Editoren, Filter, Säulenliste, Zuordnungen bleiben); andere Angaben speichern; Übernahme vollständig und wiederholbar; mehrdeutige, abgeleitete und verwaiste Fälle werden gemeldet und nicht zugeordnet; zu junge Säule; direkte und abgeleitete Zuordnung getrennt; Filter und alte Adressen; Löschschutz (Dienst und Datenbank); Rechte; Stammdaten ohne Säulenkopie; Mitgliederbibliothek; öffentliche Seiten, Fassungen und Themen unverändert. Ein Test hat dabei einen Fehler im Übernahmebericht gefunden und ist behoben. Der bisherige Test, der die alte Kopie bei Modulen erwartete, ist bewusst ersetzt. Gesamt 358 Tests grün. + +**Browser auf luf-test** (1440 × 900 und 1280 × 800): Prüfsäule „UX-Prüfung Säule“ in der Säulenverwaltung angelegt (unveröffentlicht), im Modul „UX-Prüfung Modul“ und im Lizenzartikel `abstand-trainer` gewählt und gespeichert, umbenannt, beide Objekte erneut geöffnet (neuer Name, Auswahl erhalten, alter Name weg), Arbeitsplatz nach der Säule gefiltert (1 Treffer, Filter übersteht das Neuladen), Säulenfilter im Aufbau-Picker, Löschversuch abgewiesen („1 Modul oder Programm, 1 Lizenzartikel“). Danach Zuordnungen gelöst und die Prüfsäule gelöscht. Vorher und nachher stimmen Säulen, Medien- und Seitenzuordnungen, Zähler der Fassungen und Revisionen überein; 13 öffentliche Seiten sind identisch. Die Kennungen 6 und 7 der Prüfsäulen sind verbraucht. Bilder 08 bis 12. + +**Offen:** Die alte Dimension und ihre Zeilen bleiben als Verlauf bestehen; sie ließen sich in einem späteren, eigenen Schritt entfernen. + ## Belege | | | @@ -81,4 +120,6 @@ ## 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) | | +| ![Picker mit fachlicher Materialart](stammdaten/07-picker.jpg) | ![Säule beim Modul zuordnen](stammdaten/08-saeule-modul-zuordnen.jpg) | +| ![Säule umbenannt, Modul erneut geöffnet](stammdaten/09-saeule-modul-umbenannt.jpg) | ![Filter nach Säule bei 1280 px](stammdaten/10-saeule-filter-module-1280.jpg) | +| ![Picker mit Säulenfilter](stammdaten/11-saeule-picker.jpg) | ![Löschschutz](stammdaten/12-saeule-loeschschutz.jpg) | diff --git a/docs/ux/verwaltung/abnahme/stammdaten/08-saeule-modul-zuordnen.jpg b/docs/ux/verwaltung/abnahme/stammdaten/08-saeule-modul-zuordnen.jpg new file mode 100644 index 0000000..a1bdd4f Binary files /dev/null and b/docs/ux/verwaltung/abnahme/stammdaten/08-saeule-modul-zuordnen.jpg differ diff --git a/docs/ux/verwaltung/abnahme/stammdaten/09-saeule-modul-umbenannt.jpg b/docs/ux/verwaltung/abnahme/stammdaten/09-saeule-modul-umbenannt.jpg new file mode 100644 index 0000000..c22ea11 Binary files /dev/null and b/docs/ux/verwaltung/abnahme/stammdaten/09-saeule-modul-umbenannt.jpg differ diff --git a/docs/ux/verwaltung/abnahme/stammdaten/10-saeule-filter-module-1280.jpg b/docs/ux/verwaltung/abnahme/stammdaten/10-saeule-filter-module-1280.jpg new file mode 100644 index 0000000..beddad9 Binary files /dev/null and b/docs/ux/verwaltung/abnahme/stammdaten/10-saeule-filter-module-1280.jpg differ diff --git a/docs/ux/verwaltung/abnahme/stammdaten/11-saeule-picker.jpg b/docs/ux/verwaltung/abnahme/stammdaten/11-saeule-picker.jpg new file mode 100644 index 0000000..3e24201 Binary files /dev/null and b/docs/ux/verwaltung/abnahme/stammdaten/11-saeule-picker.jpg differ diff --git a/docs/ux/verwaltung/abnahme/stammdaten/12-saeule-loeschschutz.jpg b/docs/ux/verwaltung/abnahme/stammdaten/12-saeule-loeschschutz.jpg new file mode 100644 index 0000000..b7e3f3f Binary files /dev/null and b/docs/ux/verwaltung/abnahme/stammdaten/12-saeule-loeschschutz.jpg differ