Files
laraundfelix/docs/analysen/umsetzungsplan-mitgliederbibliothek.md
T
Lars 5dccbbce80
CI Feature / test (push) Successful in 36s
Add SEO and Marketing Strategy Documentation for Lara & Felix Platform
- 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).
2026-11-18 09:44:08 +01:00

464 lines
35 KiB
Markdown

# 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.