103 lines
11 KiB
Markdown
103 lines
11 KiB
Markdown
# Lara & Felix – Technischer Architekturauftrag v1.1
|
||
## Vollständige Zielarchitektur vor Umsetzungsphasen und MVP-Slice
|
||
|
||
**Auftraggeber:** Betreiber der Plattform „Lara & Felix – Stark im Alltag“
|
||
**Auftragsart:** Eigenständige technische Lösungsskizze für das **gesamte fachliche Zielbild**, keine Implementierung
|
||
**Fachliche Grundlage:** `01_LUF_Zielbild_und_Fachkonzept_v1.1.md`
|
||
**Validierung:** `03_LUF_Pruefszenarien_v1.1.md`
|
||
|
||
## 1. Was du entwerfen sollst
|
||
|
||
Dies ist der **erste Architekturauftrag für dieses Vorhaben**. Es gibt keine bereits vorgegebene technische Architektur oder zuvor erteilten Implementierungsauftrag. Betrachte die drei übergebenen Unterlagen als alleinigen aktuellen Input. Rekonstruiere keine historische Diskussion und ziehe keine alten Versionen als konkurrierende Anforderungen heran.
|
||
|
||
Erarbeite eine **durchgängige, gut begründete technische Lösungsarchitektur für das vollständige Zielsystem** von `lara-und-felix.de`: öffentlicher Webauftritt, Redaktion und Inhaltsverwaltung, frei kombinierbare Unterrichtsinhalte und Produkte, Versionierung, Releases, digitale Lizenzvermarktung, Kauf- und Rechteverwaltung, geschütztes Streaming und Download, Individualisierung, Mitgliederbereich, Organisationen, Trainerverifikation und Fachcommunity.
|
||
|
||
Leitfrage: **Wie sollte die gesamte Plattform gebaut und betrieben werden, damit alle im Zielbild beschriebenen Funktionen kohärent zusammenarbeiten, nicht nur die Funktionen des ersten Releases?**
|
||
|
||
Entwickle eine klare Empfehlung. Begnüge dich weder mit einer abstrakten Boxengrafik noch mit einer Aneinanderreihung unbewerteter Technologieoptionen.
|
||
|
||
## 2. Grundprinzip: Technologieneutral und eigenständig denken
|
||
|
||
Das Fachkonzept beschreibt Anforderungen, **keinen Stack**. Untersuche verschiedene passende Gesamtansätze, zum Beispiel eine integrierte Anwendung, ein sinnvoll geteiltes Frontend-/Backend-System oder eine getrennte öffentliche Marketingoberfläche mit gemeinsamer Produkt-/Rechtebasis. Prüfe Vorteile, Nachteile und Folgekosten nach fachlicher Eignung. Auch PHP-basierte oder einheitliche Lösungen dürfen nicht allein aufgrund früher genannter Favoriten verworfen werden.
|
||
|
||
Weder Next.js noch FastAPI, PostgreSQL, Laravel, Payload, Directus, Discourse, Stripe, Mollie oder eine bestimmte Containerplattform sind vorgegeben. Auch die Aufteilung in einzelne Dienste ist **erst Ergebnis** deiner Analyse. Die vorhandenen Erfahrungen des Betreibers mit Linux, Docker, Gitea, NAS und Reverse Proxy sind Kontext, keine Verpflichtung, alles in derselben Weise zu bauen.
|
||
|
||
Untersuche Eigenentwicklung gegenüber zweckmäßiger Integration bestehender Komponenten. Vermeide sowohl kurzsichtige Kleinstlösungen als auch vorsorgliche Plattformabstraktionen ohne realen Bezug zum Zielbild.
|
||
|
||
## 3. Verpflichtende Reihenfolge der Analyse
|
||
|
||
### Phase A – Zielbild fachlich und funktional vollständig erfassen
|
||
|
||
1. Lies beide Referenzdokumente vollständig.
|
||
2. Erstelle eine **Fähigkeitenlandkarte** der gesamten geplanten Plattform: Akteure, fachliche Domänen, Kernprozesse, Daten- und Informationsflüsse sowie Betreiberarbeit.
|
||
3. Stelle die wichtigsten Ende-zu-Ende-Nutzerwege dar: Öffentlichkeit, kostenlose Mitgliedschaft, ehrenamtlicher/kommerzieller Lizenzkauf, Streaming/Download, Community/Vernetzung, Organisation, Trainerverifikation, Content-Produktion/Release und Aktualisierung.
|
||
4. Bestimme **gesamtsystemische Invarianten** wie die quellenbezogene atomare Lizenzauflösung, konsistente Releases und das Verbot unberechtigter Rechtekombinationen.
|
||
5. Liste echte fachliche Lücken und widersprüchliche Regeln. Schlage plausible Varianten vor und sage, wie weit die technische Planung ohne endgültige Geschäftsentscheidung möglich ist.
|
||
|
||
### Phase B – Zielarchitektur entwerfen und Alternativen bewerten
|
||
|
||
6. Entwerfe mindestens zwei **in sich schlüssige** Lösungskonzepte auf Gesamtplattformebene und vergleiche sie. Eine klare, vorzugsweise durchgängige Empfehlung ist erforderlich.
|
||
7. Dokumentiere die Verantwortung der Komponenten, Datenhoheit, Schnittstellen, interne und externe Integrationen, Sicherheitsgrenzen und den vollständigen Zielzustand einschließlich der späteren Community- und Organisationsfunktionen.
|
||
8. Zeige das **konkrete konzeptionelle Modell** für freie Inhaltskomposition, Lizenzartikel, Angebotssnapshots, Rechtequellen, Organisationen, Versionen, fachliche Kompatibilität und konsistente Veröffentlichung. Gib Beispiele, die das Modell tatsächlich belasten.
|
||
9. Entwirf die kauf- und lizenzkritischen Abläufe einschließlich Zahlungsfehlern, Rückerstattungen, mehreren Berechtigungsquellen und Teil-Upgrades.
|
||
10. Entwirf Streaming, Materialdownloads, Kennzeichnung, Co-Branding und nachvollziehbare Ausgabe auf Basis der Zielanforderungen. Bewerte technische Alternativen und den realen Ressourcenbedarf.
|
||
11. Entwirf Administration, CMS und Community als dauerhafte Fähigkeiten der gesamten Plattform, nicht als nachträgliche Add-ons ohne Integrationsstrategie.
|
||
12. Beschreibe die Betriebsarchitektur vom selbst gehosteten Start bis zum späteren VPS-Betrieb: Wiederherstellung, Datenmigration, Monitoring, Updateprozesse, Ausfälle und Datenschutz.
|
||
|
||
### Phase C – Architektur validieren
|
||
|
||
13. Gehe alle Prüfszenarien aus Dokument 03 durch. Beurteile, ob die **Zielarchitektur** jeden Fall behandelt, wo Entscheidungen offen bleiben und welche Restrisiken bestehen.
|
||
14. Prüfe besonders Interaktionen zwischen Domänen: Produktänderung ↔ Lizenzanspruch ↔ Version/Release ↔ Dateiausgabe; Organisation ↔ Mitglied ↔ Trainerstatus ↔ Community; Zahlung ↔ Bestellhistorie ↔ Freischaltung.
|
||
15. Stelle fest, ob ein Ansatz einen späteren Zielbestandteil künstlich erschwert oder unmöglich macht. Bewerte auch organisatorischen Aufwand und Wartbarkeit einer langfristig klein betriebenen Plattform.
|
||
|
||
### Phase D – Erst dann Realisierung planen
|
||
|
||
16. **Erst nach Beschreibung der vollständigen Zielarchitektur**: Gliedere die Realisierung in aufeinander aufbauende, fachlich nutzbare Ausbaustufen. Zeige Abhängigkeiten, technische Vorleistungen und Risiken.
|
||
17. Schlage **zusätzlich** einen ersten marktfähigen MVP-Slice vor, einschließlich begründeter Auswahl, Nutzwert, Abgrenzung und Test-/Einführungsvoraussetzungen. Dieser Slice ist **eine Planungsansicht der Zielarchitektur, keine neue Begrenzung des Zielbilds**.
|
||
18. Ordne jedem späteren Zielbestandteil eine Ausbauphase und ggf. jetzt bereits nötige Architekturvorbereitung zu. Funktionen, die im ersten Slice fehlen, verschwinden nicht aus der Architekturstudie.
|
||
|
||
## 4. Erwartete Ergebnisse
|
||
|
||
Bitte liefere eine **reviewfähige Architekturstudie** mit verständlichen Diagrammen und nachvollziehbarer Begründung. Ein einziges Gesamtdokument mit Anhängen ist ebenso akzeptabel wie sauber referenzierte Teildokumente. Inhaltlich erwarten wir:
|
||
|
||
| Nr. | Ergebnis | Erwartete Tiefe |
|
||
|---|---|---|
|
||
| 1 | Verständnis des vollständigen Zielbilds | Zielgruppen, End-to-End-Journeys, Fähigkeitenlandkarte, Geschäfts- und Inhaltsflüsse |
|
||
| 2 | Architekturvarianten mit Entscheidung | Mindestens zwei tragfähige Konzepte, klare Auswahlkriterien und Empfehlung |
|
||
| 3 | Vollständige Zielsystemarchitektur | Öffentliche Präsenz, CMS, Produkt-/Lizenzkern, Shop, Bibliothek, Medien, Community, Administration, Schnittstellen |
|
||
| 4 | Domänenmodell und Datenverantwortung | Stabile Identitäten, Beziehungen, Produktgraph, Lizenzartikel, Rechte, Organisationen, Versionen, Releases |
|
||
| 5 | Kerninvarianten und Berechtigungslogik | Rechtequellen, Überlappungen, Entzug, Upgrades, Paketauflösung, berechtigte Medienaktionen |
|
||
| 6 | Versionierungs- und Veröffentlichungsmodell | Konsistente Inhaltskombination, Kompatibilitätsprüfung, Freigabe, Rückzug, Altrelease und Historie |
|
||
| 7 | Kritische fachliche Abläufe | Redaktion, Kauf, kostenloser Zugriff, Streaming, Download/Branding, Trainerverifikation, Community, Organisation |
|
||
| 8 | Technologiebewertung | Konkrete, aktuell geprüfte Optionen für Frontend, Backend, Datenhaltung, CMS, Community, Payment und Medien |
|
||
| 9 | Betriebs-, Sicherheits- und Datenschutzkonzept | Self-Hosting, VPS-Migration, Backups/Restore, Fehlerfälle, Rechteprüfung und rechtliche Prüfbedarfe |
|
||
| 10 | Qualität und Grenzen | Risiken, Lastannahmen, Betriebskosten, Wartung, Alternativen, offene Fachentscheidungen |
|
||
| 11 | Entscheidungsprotokoll (ADR) | Wesentliche Entscheidungspunkte, Begründungen, Alternativen und Konsequenzen |
|
||
| 12 | Szenarien-Matrix | Abdeckung **aller** Prüffälle aus Dokument 03 mit präzisen Verweisen |
|
||
| 13 | Entwicklungsroadmap | Ausbaustufen für **das vollständige Zielbild** und deren Abhängigkeiten |
|
||
| 14 | Zusätzlicher MVP-Slice | Ein möglicher erster nutzbarer Release, **erst nach** Zielarchitektur und Roadmap dargestellt |
|
||
|
||
**Qualitätsmaßstab:** Die Architekturstudie muss eine spätere fundierte technische Entscheidung ermöglichen, nicht möglichst wenig Aufwand für einen MVP erzeugen. Bewerte sowohl Vollständigkeit im Zielbild als auch Umsetzbarkeit und Aufwand ehrlich.
|
||
|
||
## 5. Was du nicht vorentscheiden darfst
|
||
|
||
- Kein Framework, CMS, Datenbanktyp, Communityprodukt, PSP oder Streamingverfahren als vom Auftraggeber festgelegt ausgeben.
|
||
- Keine festen Preise, Honorarsätze, Vertragslaufzeiten, Updateansprüche oder Ausnahmeregelungen aus Beispielen ableiten.
|
||
- Keine automatische kostenlose Aktualisierung für alle Bestandskunden behaupten: Die Updatepolitik ist offen, während die Versionsfähigkeit feststeht.
|
||
- Nicht die spätere Trainervernetzung, Organisations-Selbstverwaltung oder die freie Produktkomposition auf einen Minimalumfang reduzieren, nur weil eine erste Version kleiner sein könnte.
|
||
- Keine zugesicherte Robustheit unsichtbarer Wasserzeichen ohne tatsächliche Verfahrenserprobung annehmen.
|
||
- Keine generelle Multi-Tenant-/LMS-Plattform außerhalb des Lara-&-Felix-Zielbilds voraussetzen.
|
||
- Keine nicht eingesehenen Repository- oder Serverdetails als tatsächlich geprüft darstellen.
|
||
|
||
## 6. Recherche und bestehende technische Umgebung
|
||
|
||
Nutze bevorzugt offizielle Dokumentationen und anerkannte Sicherheitsquellen und nenne direkte Links und Prüfdatum für wesentliche aktuelle Technikbehauptungen. Mache Produkte, Lizenzmodelle, Systemanforderungen und Kosten transparent vergleichbar. Relevante Referenzen können beispielsweise Herstellerdokumentation, OWASP, Datenschutzbehörden und die Dokumentation des konkret empfohlenen Hosting-/Zahlungsstacks sein.
|
||
|
||
Falls Zugang besteht, prüfe bestehende Softwareprojekte wie Shinkan oder FewoPortal und die Infrastruktur **ausschließlich lesend** auf praktische Erkenntnisse. Der Auftraggeber hat noch **keine** technische Lösungsskizze oder Implementierung für Lara & Felix beauftragt. Es darf keinen fiktiven Ist-Zustand für dieses neue Projekt geben.
|
||
|
||
## 7. Ausführungsgrenzen – nur zum Schutz bestehender Systeme
|
||
|
||
Dieser Auftrag autorisiert Recherche, Konzeptarbeit, Diagramme, read-only Repository-Inspektion nach gewährtem Zugriff und Erstellung der Ergebnisdokumentation. **Keine Implementierung, Codeänderung, Migration, Datenbankveränderung, Installation, Änderung laufender Systeme, Deployment, Commit, Produktivscan oder Buchung kostenpflichtiger Dienste.** Gehe sparsam und vertraulich mit Zugangsdaten um.
|
||
|
||
Diese Grenze ist **keine** Einschränkung des fachlichen Zielbilds. Nach Abgabe der Lösungsskizze wird die Architektur geprüft; die Umsetzung benötigt einen gesonderten Auftrag.
|