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

35 KiB

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

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.