Files
laraundfelix/docs/specification/02_LUF_Architekturauftrag_v1.1.md
T
LarsandClaude Sonnet 5.5 ec009a187b Initial commit
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-11-15 05:52:59 +01:00

11 KiB
Raw Blame History

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

  1. Entwerfe mindestens zwei in sich schlüssige Lösungskonzepte auf Gesamtplattformebene und vergleiche sie. Eine klare, vorzugsweise durchgängige Empfehlung ist erforderlich.
  2. 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.
  3. 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.
  4. Entwirf die kauf- und lizenzkritischen Abläufe einschließlich Zahlungsfehlern, Rückerstattungen, mehreren Berechtigungsquellen und Teil-Upgrades.
  5. Entwirf Streaming, Materialdownloads, Kennzeichnung, Co-Branding und nachvollziehbare Ausgabe auf Basis der Zielanforderungen. Bewerte technische Alternativen und den realen Ressourcenbedarf.
  6. Entwirf Administration, CMS und Community als dauerhafte Fähigkeiten der gesamten Plattform, nicht als nachträgliche Add-ons ohne Integrationsstrategie.
  7. 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

  1. Gehe alle Prüfszenarien aus Dokument 03 durch. Beurteile, ob die Zielarchitektur jeden Fall behandelt, wo Entscheidungen offen bleiben und welche Restrisiken bestehen.
  2. Prüfe besonders Interaktionen zwischen Domänen: Produktänderung ↔ Lizenzanspruch ↔ Version/Release ↔ Dateiausgabe; Organisation ↔ Mitglied ↔ Trainerstatus ↔ Community; Zahlung ↔ Bestellhistorie ↔ Freischaltung.
  3. 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

  1. Erst nach Beschreibung der vollständigen Zielarchitektur: Gliedere die Realisierung in aufeinander aufbauende, fachlich nutzbare Ausbaustufen. Zeige Abhängigkeiten, technische Vorleistungen und Risiken.
  2. 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.
  3. 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.