Add SEO and Marketing Strategy Documentation for Lara & Felix Platform
CI Feature / test (push) Successful in 36s
CI Feature / test (push) Successful in 36s
- Introduced comprehensive SEO and marketing requirements in a new document (SEO-Marketing.md) to enhance visibility and user engagement. - Developed a strategic framework for the ongoing development of the Lara & Felix platform, focusing on digital product strategy, user experience, and marketing automation in a new document (Strategieentwicklung.md).
This commit is contained in:
1 parent
8a3f6df770
commit
5dccbbce80
48 files changed
+6980
-40
No files matched your search
@@ -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.
|
||||
@@ -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 `<track>` 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.
|
||||
@@ -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.
|
||||
@@ -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`).
|
||||
Reference in new issue
Block a user