Files
laraundfelix/docs/architektur/15_Roadmap.md
T
LarsandCursor 2035c46edd
Deploy Test / test (push) Successful in 2m25s
Deploy Test / deploy (push) Failing after 25s
Stelle das U0-Fundament mit CMS, Mitgliedern und Filament bereit.
Co-authored-by: Cursor <cursoragent@cursor.com>
2026-11-15 08:32:14 +01:00

234 lines
19 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 15 – Entwicklungsroadmap für das vollständige Zielbild
**Phase D, Schritte 16 und 18.** Die Roadmap leitet sich aus der in `03` bis `11` beschriebenen Zielarchitektur ab. Sie verändert das Zielbild nicht (SCOPE-001). Der erste marktfähige Schnitt ist in `16_MVP_Slice.md` gesondert dargestellt.
Aufwandsspannen: `13`, Abschnitt 6. Diese Roadmap nennt bewusst keine Kalendertermine.
**Nach der Challenger-Prüfung geändert** (`13`, Abschnitte 8 und 9): A0 enthält den Machbarkeitsnachweis zur Stapelwahl und die Sicherheits- und Sicherungsbasis; A1 verkauft nur an Einzelpersonen; Organisationsangebote gibt es erst mit A4; die Vorleistungen in Abschnitt 4 sind an das korrigierte Modell angepasst; bezahlte Fassungs-Upgrades desselben Artikels sind entfallen. Die Roadmap ist eine Umsetzungsansicht und verkleinert das Zielbild nicht.
---
## 1. Überblick
```mermaid
flowchart LR
A0["A0 Fundament und Nachweise"] --> A1["A1 Sehen, registrieren, kaufen, unterrichten"]
A1 --> A2["A2 Download und Individualisierung"]
A1 --> A3["A3 Trainerstatus und Fachcommunity"]
A2 --> A4["A4 Organisationen"]
A3 --> A4
A4 --> A5["A5 Ausbau: laufende Modelle, Selbstverwaltung, Wasserzeichen"]
subgraph Betrieb["Betriebsspur, ereignisgesteuert"]
B1["B1 Eigener Server"] --> B2["B2 Auslieferungsnetz"] --> B3["B3 Gemieteter Server"]
end
A0 -.-> B1
```
A2 und A3 sind voneinander unabhängig und können in beliebiger Reihenfolge oder parallel folgen. Die Betriebsspur folgt Messwerten, nicht den Ausbaustufen.
## 2. Ausbaustufen
### A0 – Fundament und Nachweise
**Ziel:** Entscheidungen treffen, die sonst später teuer werden, und die drei technischen Unsicherheiten ausräumen.
| Arbeitspaket | Ergebnis |
|---|---|
| Bestandsprüfung am Server (lesend): Ressourcen, Anbindung, Erreichbarkeit, Reverse Proxy, NAS, Gitea, Netztrennung zum privaten Netz | Annahmen A-05 bis A-08 bestätigt oder korrigiert |
| **Machbarkeitsnachweis Kernstapel** | durch die Umsetzung ab dem 15.11.2026 ersetzt, nicht als eigene Studie wiederholt |
| Entscheidung Kernstapel (E-18) | **erledigt am 15.11.2026:** Laravel 13, Filament 5, PHP 8.4, PostgreSQL (ADR-02) |
| **Sicherheitsbasis:** drei Herkunftsadressen; getrennte Datenbankrollen und Einhängepunkte je Betriebsart; Alltags- und Systemkonto; Alarmkanal außerhalb der Plattform | Grenzen aus `03`, Abschnitt 6 stehen, bevor Fachcode entsteht |
| **Sicherungsbasis:** Außer-Haus-Ziel mit nur anfügbarem Zugang ausgewählt (A-15); fortlaufendes Änderungsprotokoll an beide Ziele; Spiegel von Quellcode und Abbildern; Sicherheitsjournal und Audit-Anker; Entscheidung über die Ziele (E-22) | `11`, Abschnitt 3 eingerichtet; erste Standortausfall-Übung mit Zeitmessung |
| Steuer- und Rechtsberatung: Steuerstatus, Kundenkreis, Zahlungs- und Rechnungsweg, Bestellablauf, Lizenzbedingungen | OPEN-06, E-09 entschieden; Textaufträge erteilt |
| Machbarkeitsnachweis Redaktion: eine echte Episode vom Upload bis zur Vorschauseite im gewählten Stapel, darunter eine verschachtelte Komposition | Bedienbarkeit des Modells belegt (R-02) |
| Machbarkeitsnachweis Medien: Verarbeitung, adaptives Streaming mit signierten Adressen, Sprungmarken-Pause, PDF-Stempelung, Vor-/Abspann ohne Neukodierung | Messwerte für `08`; R-07 geklärt |
| Betriebsbasis: Container-Gerüst, Ausrollweg, Sicherung mit erster Wiederherstellung, Testumgebung | Stufe B1 betriebsbereit |
| Erste Geschäftsregeln: Lizenztypen und Preise der Startangebote | OPEN-03 für den Start entschieden. Die Updatepolitik ist bereits entschieden (VER-008) und kein Arbeitspaket mehr. |
**Abhängigkeiten:** keine. **Risiken:** R-01, R-24. A0 ist durch die Challenger-Korrekturen größer geworden (`13`, Abschnitt 6); die Sicherheits- und Sicherungsbasis später nachzuziehen wäre teurer.
### A1 – Sehen, registrieren, kaufen, unterrichten
Der erste marktfähige Schnitt. Inhalt, Abgrenzung und Einführungsvoraussetzungen: `16_MVP_Slice.md`.
**Kurzfassung:** öffentliche Website mit CMS; vollständiges Inhalts-, Katalog- und Lizenzfundament; Veröffentlichung mit Versionierung und Rückzug; Registrierung; kostenlose Angebote; Einzel- und Paketkauf mit Einmalzahlung **durch Einzelpersonen**; Bibliothek; Streaming; Download von Begleitmaterial mit sichtbarer Lizenzzeile; manuelle Freischaltung; Vollerstattung; Verwaltung und Audit.
**Abgrenzung (ID-004):** A1 enthält keine Organisationsangebote. Persönliche Berechtigungen werden nicht als Organisationslizenz angeboten oder abgerechnet. Das Modell für Organisationen besteht vollständig; verkauft wird an Organisationen ab A4.
**Abhängigkeiten:** A0. **Risiken:** R-02, R-12, R-19, R-24, R-28.
### A2 – Download und Individualisierung
| Fähigkeit | Anforderungen |
|---|---|
| Filmdownload nach Lizenz | MED-001, LIC-003 |
| Kennzeichnung K1 bis K3 für alle Ausgaben; Vor-/Abspann im Film | MED-002, MED-004 |
| Branding-Profile mit Prüfung; Co-Branding für Dokumente und Film | LIC-010, MED-005 |
| Auswahl der Lizenz bei mehreren möglichen Zwecken | LIC-006 |
| Gezielte Upgrades als zusätzlicher Erwerb mit eingefrorener Bedingung „abhängig“ oder „eigenständig“; Klärungsfall bei Wegfall der Grundlage | LIC-007, LIC-012, PAY-003 |
| Teilerstattung, Rückbuchung, Widerruf als vollständige geführte Vorgänge | PAY-004 |
| Bibliothek: Fassungsübersicht, Änderungshinweise, Ausgabenliste | VER-008, LIC-007 |
| Suche nach Lizenzkopie-Kennung in der Verwaltung | ADM-004 |
**Abhängigkeiten:** A1; Entscheidungen OPEN-05 (Stufen K1–K3, Tiefe des Brandings), E-11, E-15, E-21.
**Technische Vorleistung aus A1:** Ausgabenachweis und Ausgabevorgang bestehen bereits für Dokumente; A2 erweitert um Film und Branding. **Risiken:** R-07.
### A3 – Trainerstatus und Fachcommunity
| Fähigkeit | Anforderungen |
|---|---|
| Verifikationsantrag, Prüfwarteschlange, Status mit Gültigkeit und Verlauf | ID-002, ID-006 |
| **Vorab:** kleiner Nachweis der Schnittstellen des Forenprodukts (`10`, Abschnitt 11 Nr. 2) und Entscheidung über Produkt und Betriebsform (E-24) | SEC-002; Annahme A-17 |
| Forensoftware in Betrieb auf eigener Unterdomäne ohne gemeinsame Sitzung; einmalige Anmeldung; aktiver Entzug mit Zurücklesen, Vorrang und Alarm; stündlicher Vollabgleich; kurzes Sitzungsalter | COM-001, COM-002, SEC-003 |
| Bereiche: Austausch, Fragen, Themenvorschläge, Diskussion je Episode, Fachbereich für verifizierte Trainer | COM-002, COM-007 |
| Profil mit Sichtbarkeit je Angabe; Trainerverzeichnis mit Suche; Kontaktanfrage | COM-003, COM-005 |
| Moderation, Meldewege mit und ohne Konto, Regeln | COM-004 |
| Gemeinsame Kopfzeile, abgestimmtes Erscheinungsbild, Benachrichtigungszähler | ID-001 |
| Auskunft und Löschung über beide Systeme | ID-005 |
**Abhängigkeiten:** A1; Entscheidungen OPEN-07, E-13; funktionierender Mailversand.
**Technische Vorleistung aus A1:** Konto mit bestätigter E-Mail; Profil mit Sichtbarkeitsfeldern; Ereignisverarbeitung. **Risiken:** R-03, R-09, R-23.
### A4 – Organisationen
| Fähigkeit | Anforderungen |
|---|---|
| Organisationen als Inhaber; Mitgliedschaften; betreiberverwaltete Zuordnung | ID-003, ID-004 |
| Sitzpool je Erwerb, Zuweisung an Mitgliedschaften, Wechsel mit Verlauf und Wechselregel | SC-14 |
| Organisationsangebote: Angebotsfassungen mit Inhaberart „Organisation“, Rechteprofile mit Zweck „institutionell“ und Sitzzahl | LIC-002, LIC-008 |
| Kauf im Namen einer Organisation mit Rechnungsdaten, über den Zahlungsdienst oder per **Überweisung auf Rechnung**; in beiden Fällen über eine Bestellung mit Umfangskopie | PAY-003, PAY-005 |
| Bibliothek zeigt Herkunft „über Organisation“ | LIC-001 |
| Co-Branding mit Branding-Profil der Organisation | LIC-010 |
| Optional: Organisationsraum in der Community | COM-004 |
**Abhängigkeiten:** technisch nur A1; sinnvoll nach A2 (Branding) und A3 (Organisationsräume); Entscheidungen OPEN-04, E-22 (Verfügbarkeit gegenüber Institutionen), Rechnungsweg.
**Technische Vorleistung aus A1:** Inhaber als Person oder Organisation; Erwerb, Mitgliedschaft, Sitzpool und Sitzzuweisung im Datenmodell; Entscheidungsfunktion berücksichtigt Sitzzuweisungen von Beginn an.
**Vorziehen möglich:** Melden sich Institutionen früh, kann A4 unmittelbar auf A1 folgen (E-23). Bis dahin gibt es keine Organisationsangebote; eine Institution kann allenfalls klar so benannte persönliche Lizenzen für namentlich bestimmte Trainer bezahlen, die bei diesen Trainern bleiben.
### A5 – Ausbau der Geschäftsmodelle und des Schutzes
| Fähigkeit | Anforderungen | Voraussetzung |
|---|---|---|
| Organisations-Selbstverwaltung: Einladung, Sitzvergabe durch Organisationsadministrator | ID-004 | A4; zusätzliche Rolle im bestehenden Vorgang |
| Befristete Lizenzen mit Verlängerung; wiederkehrende Zahlungen | LIC-008, PAY-003 | Gültigkeit und Erwerbstyp „Abonnement“ im Modell; Kündigungsweg; Entscheidung zu Abo-Konditionen |
| Dynamische Angebote („alle künftigen Episoden“) | PROD-005, SC-07 | Kennzeichen der Angebotsfassung besteht; Vergabe über den Soll-Ist-Abgleich |
| Forensisches Videowasserzeichen | MED-005 | bestandener Versuch nach `08`, 5.4; zusätzliche Ableitungen; Ausleseverfahren |
| Erweiterte Vernetzung: regionale Gruppen, Veranstaltungshinweise | COM-003 | A3 |
| Nachfolgeartikel als eigenständige neue Produkte | VER-010 | Beziehung `nachfolger_von` besteht. Kostenpflichtige „Upgrades auf neue Ausgaben“ **desselben** Artikels gibt es seit VER-008 nicht mehr. |
| Weitere Produktlinie unter Dachmarke | VIS-005 | Katalogmerkmal besteht; eigener Seitenbaum |
| Tieferes Video-Branding (Logo im Bild) | MED-005 | A2; Rechenkapazität |
Die Reihenfolge innerhalb von A5 folgt dem Geschäftsbedarf.
### Betriebsspur
| Schritt | Auslöser | Voraussetzung |
|---|---|---|
| B1 Eigener Server | Start | A0 einschließlich Sicherheits- und Sicherungsbasis |
| Standortausfall-Übung | vor dem Verkaufsstart, danach jährlich | Außer-Haus-Ziel; offline verwahrter Schlüssel |
| Vorgelagerter Zugangspunkt | Sicherheits- oder Erreichbarkeitsbedarf | – |
| Vorbereiteter Ersatz bei einem Mietanbieter | Entscheidung E-22, spätestens vor Zusagen an Institutionen | Spiegel von Quellcode und Abbildern |
| B2 Auslieferungsnetz | Schwellen aus `08`, 4.2 | Auftragsverarbeitungsvertrag; Adapter besteht ab A1 |
| B3 Gemieteter Server | Verfügbarkeitsanspruch, wiederholte Störung | Generalprobe nach `11`, 5 |
| B4 Getrennte Lasten | Messwerte | – |
## 3. Abhängigkeiten im Detail
| Fähigkeit | Braucht |
|---|---|
| Kauf | Katalog, Veröffentlichung, Lizenzen, Zahlungsadapter, Bedingungstexte, Rechnung |
| Streaming | Medienverarbeitung, Lizenzen, Ausgabe |
| Filmdownload | Streaming-Fundament plus Individualisierung |
| Upgrade | Kauf, Upgrade-Angebote, Erwerb mit Bezug auf eine vorhandene Berechtigung |
| Co-Branding | Ausgabe, Branding-Profile |
| Community | bestätigte Konten, Mailversand, Ereignisverarbeitung |
| Geschützter Fachbereich | Trainerverifikation, Gruppenabgleich |
| Diskussion je Episode | Veröffentlichung, Community |
| Organisationslizenz | Inhaber-Modell, Sitzpool, Rechteprofile |
| Selbstverwaltung | Organisationen |
| Abonnement | Kauf, Gültigkeit, wiederkehrende Ereignisse des Zahlungsdienstes |
| Wasserzeichen | Individualisierung, zusätzliche Ableitungen, bestandener Versuch |
## 4. Nicht verhandelbare Vorleistungen der ersten Stufe (SCOPE-003)
Diese Punkte kosten in A1 wenig und sind später nur mit Umbau der zentralen Tabellen nachzuholen. Sie gehören deshalb vollständig in A1, auch wenn ihre Oberfläche erst später entsteht.
| Vorleistung | Trägt später | Warum jetzt |
|---|---|---|
| Vier Ebenen des Produktmodells mit eigenen Identitäten | alles | Grundstruktur |
| Unveränderliche Fassungen mit exakten Verweisen und Kompatibilitätsbestätigung | Überarbeitungen, Rückzug | nachträglich nicht rekonstruierbar |
| Artikel-Stand mit **fixiertem Inhalt**, Einordnung, Status und Sperrgrund | Aktualisierungen, ältere Fassungen, Rückzug (VER-008) | Gegenstandsprüfung und Rückzug über Verschachtelungen brauchen die Liste von der ersten Veröffentlichung an |
| Angebotsfassungen mit Inhaberart und Updatezusage; Umfangskopie mit **Rechtekopie** in der Bestellung; unveränderliche Bedingungsfassungen | Paketänderungen, Nachweis, Vertragsdatensatz | verkaufte Bestellungen lassen sich nicht nachträglich ergänzen |
| **Erwerb** als individuelle Quelle je Inhaber; Berechtigung mit Rechteschnappschuss und Gültigkeit; Eindeutigkeit auf Datenbankebene | kostenlose Angebote für viele Mitglieder, Upgrades, Erstattungen, Abos, Organisationen | zentrale Struktur; ein späterer Umbau träfe jede vergebene Berechtigung |
| Inhaber als Person **oder Organisation**; Mitgliedschaft, Sitzpool je Erwerb und Sitzzuweisung im Modell | A4, A5 | sonst Umbau der zentralen Struktur und der Entscheidungsfunktion |
| Entscheidungsfunktion an einer Stelle: **erst Gegenstand, dann Recht**, je Berechtigung, mit Zweck und Ausgabeklasse; Signatur je Datei | Download, Branding, Organisationen, ältere Fassungen | LIC-006, MED-003; die Lücke der Erstfassung (CH-03) lag genau hier |
| Getrennte Datenbankrollen; Auditprotokoll und Ausgabenachweis nur anfügbar; Webprozess ohne Originale; drei Herkunftsadressen | Schadensbegrenzung (SEC-003) | nachträglich nur mit Umbau des Ausrollens und Risiko für Bestandsdaten |
| Fortlaufende Sicherung außer Haus, Sicherheitsjournal, Audit-Anker | Wiederherstellung, Nachweis | Lücken sind nicht nachtragbar |
| Soll-Ist-Abgleich für regelbasierte Ansprüche; Zahlungszustand durch Abfrage | dynamische Angebote, Forum-Abgleich, alle Zahlungsmodelle | idempotente Vergabe ist Eigenschaft des Fundaments |
| Rechteprofil mit Zweck, Fähigkeitsmatrix, Optionen | alle Lizenztypen | Schnappschuss wird in jede Berechtigung kopiert |
| Ausgabenachweis vor jeder individuellen Ausgabe | A2, Rückzug | Lücken sind nicht nachtragbar |
| Zahlungsadapter mit Eingangskorb, Zustandsabfrage und aktivem Abgleich einschließlich Rückblick | alle Zahlungsmodelle | SC-24 |
| Ereignisverarbeitung mit Postausgang | Community-Abgleich, Benachrichtigung | A3 hängt daran |
| Auslieferungsadapter | B2 | Wechsel ohne Umbau |
| Auditprotokoll | alles | Lücken sind nicht nachtragbar |
| Konto mit bestätigter E-Mail; Profil mit Sichtbarkeit je Angabe, Voreinstellung privat | A3 | Voraussetzung der einmaligen Anmeldung; Privatsphäre von Beginn an |
| Trainerstatus als eigenes Objekt (anfangs ohne Antragsoberfläche) | A3 | verhindert, dass Kauf als Statusersatz missbraucht wird |
| Produktlinie als Katalogmerkmal | A5 | ein Feld |
**Bewusst nicht vorgebaut** (SCOPE-003, zweiter Satz): Mandantenfähigkeit, allgemeine Plattformabstraktionen für Fremdprodukte, API für Dritte, Mehrsprachigkeit, eigener Identitätsdienst, eigener Warteschlangendienst, Orchestrierung.
## 5. Zuordnung aller Zielbestandteile
| Zielbestandteil | Stufe | Vorbereitung in A1 |
|---|---|---|
| Öffentliche Website, CMS | A1 | – |
| Freie Inhaltskomposition | A1 | – |
| Lizenzartikel, Pakete, Angebote | A1 | – |
| Versionierung, Veröffentlichung, Rückzug | A1 | – |
| Kostenlose Berechtigungen | A1 | – |
| Kauf mit Einmalzahlung | A1 | – |
| Bibliothek (Grundsicht) | A1 | – |
| Streaming | A1 | – |
| Download Begleitmaterial mit Lizenzzeile | A1 | – |
| Manuelle Freischaltung, Entzug, Vollerstattung | A1 | – |
| Filmdownload, Kennzeichnung K1–K3 | A2 | Ausgabevorgang, Nachweis |
| Co-Branding | A2 | Option im Rechteprofil |
| Gezielte Upgrades | A2 | Erwerb mit Bezug auf eine vorhandene Berechtigung und eingefrorener Bedingung; Status „ausgesetzt“ |
| Teilerstattung, Rückbuchung, Widerruf vollständig | A2 | Erstattungsfall, Status „ausgesetzt“; **Widerrufsweg für Verbraucher muss bei Verkauf an Verbraucher schon in A1 funktionieren**, dann als einfacher geführter Vorgang |
| Trainerverifikation | A3 | Statusobjekt |
| Fachcommunity, Profile, Verzeichnis | A3 | Profil, Sichtbarkeit, Ereignisse |
| Aktualisierungen und ältere Fassungen für Bestandskunden (VER-008) | A1 | – |
| Organisationen, betreiberverwaltet, einschließlich Kauf auf Rechnung | A4 | Inhaber, Erwerb, Mitgliedschaft, Sitzpool, Inhaberart der Angebotsfassung, Zahlungsart an der Zahlung |
| Organisations-Selbstverwaltung | A5 | Rollen in der Mitgliedschaft |
| Befristung, Abonnement | A5 | Gültigkeit, Erwerbstyp |
| Schadensbegrenzung, Sicherung außer Haus, Wiederanlauf (SEC-001 bis SEC-004) | A0 / A1 | – |
| Dynamische Angebote | A5 | Kennzeichen der Angebotsfassung |
| Forensisches Videowasserzeichen | A5, bedingt | Kennzeichnungsstufe als Feld des Nachweises |
| Auslieferungsnetz | B2 | Adapter |
| Gemieteter Server | B3 | Containerbetrieb, Zustand in Datenbank und Speicher |
| Weitere Produktlinie | A5 | Katalogmerkmal |
## 6. Risiken der Roadmap
| Risiko | Wo | Gegenmaßnahme |
|---|---|---|
| A1 wird zu groß (R-24) | A1 | Fundament vollständig, Oberfläche schmal; Verwaltungsoberflächen zunächst funktional statt komfortabel |
| Vorleistungen werden als „später“ gestrichen (R-25) | A1 | Abschnitt 4 als Abnahmekriterium |
| Community startet vor ausreichender Mitgliederzahl | A3 | erst nach erkennbarer Nutzerbasis aus A1; gestaffelte Öffnung |
| Entscheidungen fehlen zum Stufenbeginn (R-01) | jede | Fahrplan in `13`, Abschnitt 4 |
| Wasserzeichen wird erwartet, bevor es belegt ist (R-06, R-31) | A5 | Sprachregelung „individuell gekennzeichnete Kopien“; ehrliche Darstellung der schwachen Zuordnung von Filmen bis dahin |
| Sicherheits- und Sicherungsbasis wird als „später“ gestrichen | A0, A1 | Abschnitt 4 und die Negativtests als Abnahmekriterium |
| Institutionen werden vor A4 mit persönlichen Lizenzen „überbrückt“ (R-28) | A1 bis A3 | Inhaberart an der Angebotsfassung; A4 vorziehen statt umetikettieren |
| Der Machbarkeitsnachweis zur Stapelwahl wird übersprungen | A0 | E-18 ist die einzige blockierende Voraussetzung im Review-Gate |
## 7. Erprobung je Stufe
Jede Stufe endet mit einer Erprobung, bevor die nächste beginnt:
- **Automatisierte Tests** je Invariante (INV-01 bis INV-21) und je Prüfszenario, soweit die Stufe es berührt.
- **Negativtests** NT-01 bis NT-20 (`11`, Abschnitt 7.6), soweit die Stufe sie berührt: A1 mindestens NT-01 bis NT-07, NT-09, NT-10, NT-14 bis NT-19; A2 zusätzlich NT-08; A3 zusätzlich NT-12, NT-13, NT-20; A4 zusätzlich NT-11.
- **Wiederherstellungstest** mit Zeitmessung nach jeder Stufe mit Schemaänderung; Standortausfall-Übung vor dem Verkaufsstart.
- **Unabhängiger Sicherheitstest** der Kernwege vor dem Verkaufsstart, gesondert beauftragt.
- **Pilotnutzer:** einige Trainer nutzen die Stufe im echten Kurs und geben Rückmeldung zu Wiedergabe, Bibliothek und Material.
- **Betreiberprobe:** der Betreiber führt die Routinevorgänge der Stufe ohne Hilfe durch.