Files
laraundfelix/docs/architektur/02_Architekturvarianten_und_Entscheidung.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

16 KiB
Raw Blame History

02 – Architekturvarianten und Entscheidung

Phase B, Schritt 6. Verglichen werden vier in sich schlüssige Gesamtkonzepte. Danach folgt, getrennt, die Wahl des Technologiestapels für den Kern. Technologiebelege und Quellen: 10_Technologiebewertung.md, 17_Quellen.md.

Nach der Challenger-Prüfung (13, Abschnitte 8 und 9): Die Wahl der Gesamtvariante A wurde erneut geprüft und bleibt, mit zwei Auflagen (Abschnitt 7). Die Einschätzung zum Technologiestapel des Kerns (Abschnitt 8) ist geändert: von „S1 empfohlen“ auf „offen, Entscheidung nach Machbarkeitsnachweis“.


1. Auswahlkriterien

Nr. Kriterium Gewicht Begründung aus dem Zielbild
K1 Abbildbarkeit des Lizenz- und Versionskerns (INV-01 bis INV-08) 5 PROD-005, LIC-005, LIC-006, VER-002: Hier liegt das Alleinstellungsmerkmal und das größte Fehlerrisiko.
K2 Eine Datenquelle für Website, Angebot, Recht, Bibliothek (INV-15) 4 WEB-004
K3 Redaktionsarbeitsplatz ohne Entwickler 4 WEB-001, WEB-005, ADM-002
K4 Vollwertige Fachcommunity 4 COM-001 bis COM-004
K5 Betreibbarkeit durch kleinen Anbieter 5 VIS-006, OPS-002
K6 Portabilität Heimserver → VPS 3 OPS-001, OPS-003
K7 Transaktionssicherheit Zahlung ↔ Recht 4 PAY-004, SC-24
K8 Entwicklungsaufwand bis zum vollständigen Zielbild 3 Ehrliche Aufwandsbewertung laut Auftrag
K9 Abhängigkeits- und Lizenzrisiko der Bausteine 3 Langfristiger Betrieb

Bewertung 1 (schwach) bis 5 (stark). Die Punktzahl ist eine Entscheidungshilfe, kein Rechenbeweis; die Begründungen darunter tragen die Empfehlung.

2. Variante A – Integrierter modularer Kern mit Community-Satellit

flowchart LR
  Nutzer((Nutzer)) --> RP["Reverse Proxy"]
  RP --> Kern["Kernanwendung: Website, CMS, Katalog, Lizenzen, Shop, Bibliothek, Admin, Identität"]
  RP --> Forum["Community-Software"]
  Kern --> DB[("Relationale Datenbank")]
  Kern --> Jobs["Hintergrundverarbeitung: Medien, Kennzeichnung, Abgleich"]
  Jobs --> Speicher[("Medienspeicher")]
  Kern <-->|"Anmeldung, Gruppen, Themen"| Forum
  Kern <-->|"Checkout, Ereignisse"| PSP["Zahlungsdienst"]
  Speicher -.->|"optional"| CDN["Auslieferungsnetz"]

Idee: Eine einzige, in Module gegliederte Anwendung besitzt alle geschäftskritischen Daten in einer Datenbank. Website und CMS sind Teil dieser Anwendung und lesen den Katalog direkt. Die Community ist ein ausgereiftes Fremdprodukt, das über einmalige Anmeldung, Gruppenabgleich und Verlinkung angebunden wird. Zahlung, Mailversand und gegebenenfalls Medienauslieferung sind externe Dienste hinter Adaptern.

Stärken

  • Kauf, Berechtigungsvergabe, Audit und Ausgabenachweis laufen in einer Datenbanktransaktion (K7). Kein verteilter Zustand zwischen Shop und Rechteverwaltung.
  • Website-Bausteine referenzieren Katalogobjekte statt Kopien (K2).
  • Ein Deployment, eine Sicherung des Kerns, ein Update-Prozess (K5, K6).
  • Community-Funktionen wie Moderation, Meldungen, Vertrauensstufen, Nachrichten und Benachrichtigungen müssen nicht entwickelt werden (K4, K8).

Schwächen

  • Zwei Systeme mit eigener Oberfläche; das Gefühl „ein Angebot“ (ID-001) verlangt bewusste Gestaltung von Anmeldung, Kopfzeile und Verlinkung.
  • Der Community-Satellit bringt einen zweiten Technologiestapel mit eigenem Update-Rhythmus.
  • Profildaten existieren an zwei Orten; die Datenhoheit muss klar geregelt sein.

3. Variante B – Kopfloses, komponiertes System

flowchart LR
  Nutzer((Nutzer)) --> FE["Frontend-Anwendung mit Server-Rendering"]
  FE --> CMS["Headless CMS"]
  FE --> API["Lizenz- und Commerce-Dienst"]
  CMS --> DB1[("CMS-Datenbank")]
  API --> DB2[("Lizenz-Datenbank")]
  API <--> PSP["Zahlungsdienst"]
  FE --> Forum["Community-Software"]
  API <--> Forum
  API --> Jobs["Medien-Worker"]

Idee: Getrennte Präsentationsschicht, ein Headless CMS für Inhalte und ein eigener Dienst für Lizenzen, Bestellungen und Medienrechte. Kommunikation über APIs.

Stärken

  • Klare technische Grenzen; Frontend frei gestaltbar; CMS-Produkt austauschbar.
  • Passt zu Teams, die Frontend und Backend getrennt entwickeln.

Schwächen

  • Produktinformationen leben in zwei Systemen (redaktionelle Beschreibung im CMS, Lizenzartikel im Dienst). Die Konsistenz, die WEB-004 fordert, muss über Synchronisation oder Laufzeitkomposition hergestellt werden (K2).
  • Versionierung der Lerninhalte (VER-001 bis VER-006) lässt sich nicht an die Versionsfunktion eines CMS delegieren, weil die Kompatibilitätsbestätigung und der eingefrorene Artikel-Stand zum Lizenzkern gehören. Es entsteht entweder doppelte Versionslogik oder das CMS wird auf Marketingseiten reduziert.
  • Drei bis vier eigenständig zu betreibende Laufzeiten plus Community (K5). Mehr Angriffsfläche, mehr Updates, mehr Fehlerbilder für einen Einzelbetreiber.
  • Höherer Aufwand ohne fachlichen Gegenwert bei den erwarteten Nutzerzahlen (K8).

4. Variante C – Komposition aus Standardsoftware

Idee: Ein verbreitetes CMS mit Shop-Erweiterung, Mitgliedschafts- oder LMS-Erweiterung und Community-Erweiterung (oder separatem Forum). Konfiguration statt Entwicklung.

Stärken

  • Schnellster Weg zu Website, Checkout und einfachem Mitgliederbereich.
  • Großes Ökosystem, viele Dienstleister.

Schwächen

  • Die Kernanforderungen sind in Standard-Shops und Mitgliedschaftserweiterungen nicht modelliert: quellenbezogene Berechtigungen je Lizenzartikel, Verbot der Rechtekombination (LIC-006), eingefrorener Paketumfang (PROD-005), Kompatibilitätsbestätigung (VER-004), Ausgabenachweis (VER-009), Sitzpools (ID-003). Sie müssten als Eigenentwicklung innerhalb fremder Datenmodelle entstehen (K1). Das ist die teuerste Form der Eigenentwicklung.
  • Viele Erweiterungen verschiedener Hersteller, jede mit eigenem Lizenz- und Update-Verhalten; das Sicherheits- und Wartungsrisiko wächst mit jeder Erweiterung (K5, K9).
  • Kauf und Recht sind über Erweiterungsgrenzen verteilt (K7).

Die Variante ist für ein reines „Video kaufen, Video sehen“-Produkt angemessen. Für das beschriebene Zielbild verschiebt sie den Aufwand nur an eine ungünstigere Stelle.

5. Variante D – Vollständige Eigenentwicklung einschließlich Community

Idee: Wie Variante A, aber Forum, Nachrichten, Moderation und Benachrichtigungen werden selbst gebaut.

Stärken

  • Ein System, ein Konto, eine Oberfläche, eine Datenbank; perfekte Integration von Profil, Status und Diskussion.

Schwächen

  • Eine „echte Fachcommunity“ (COM-001) umfasst erheblich mehr als Beiträge: Meldewesen, Moderationswarteschlangen, Spamabwehr, Bearbeitungshistorie, E-Mail-Benachrichtigungen mit Antwortfunktion, Suche, Zitate, Erwähnungen, mobile Bedienung. Das ist ein eigenes Produkt (K8).
  • Das Risiko, an der Community zu sparen und bei einem „an den Shop angehängten Minimalforum“ zu landen, widerspricht COM-001 unmittelbar.

6. Bewertungsmatrix

Kriterium (Gewicht) A Kern + Satellit B Kopflos C Standardsoftware D Alles selbst
K1 Lizenz-/Versionskern (5) 5 5 2 5
K2 Eine Datenquelle (4) 5 3 2 5
K3 Redaktion (4) 4 4 4 3
K4 Community (4) 4 4 3 2
K5 Betreibbarkeit (5) 4 2 3 4
K6 Portabilität (3) 4 3 4 5
K7 Transaktionssicherheit (4) 5 3 2 5
K8 Aufwand zum Zielbild (3) 4 2 2 1
K9 Abhängigkeitsrisiko (3) 4 3 2 5
Gewichtete Summe (max. 175) 153 115 93 138

7. Empfehlung auf Gesamtplattformebene

Variante A: integrierter modularer Kern mit Community-Satellit.

Tragende Gründe:

  1. Der Lizenz- und Versionskern ist in jedem Fall Eigenentwicklung. Dann soll er dort liegen, wo er transaktional mit Bestellung, Audit und Ausgabenachweis zusammenarbeitet und wo die Website ihn direkt lesen kann.
  2. Die Community ist die einzige große Fähigkeit, für die ein ausgereiftes, selbst betreibbares Fremdprodukt den Bedarf weitgehend deckt. Ihre Kopplung an den Kern ist schmal (Anmeldung, Gruppen, Verlinkung) und fällt bei einem Ausfall nicht auf Kauf und Unterricht durch.
  3. Die Zahl der Betriebsbausteine bleibt für einen Einzelbetreiber überschaubar.

Bewusst in Kauf genommen: zwei Oberflächen und ein zweiter Technologiestapel für die Community. Gegenmaßnahmen stehen in 09_CMS_Administration_Community.md.

Erneute Prüfung der Gesamtentscheidung (Challenger). Gesucht wurden Gründe, die Variante A zu verwerfen:

Einwand Prüfung Ergebnis
Die Punktsummen könnten das Ergebnis vortäuschen. Nachgerechnet (153 / 115 / 93 / 138): rechnerisch richtig. Variante A bleibt vorn, solange K1, K5 und K7 hoch gewichtet sind; das folgt aus PROD-005, LIC-006, VIS-006 und PAY-004 und nicht aus Vorlieben. hält
Ein integrierter Kern ist ein Vertrauensbereich: Ein Fehler im CMS öffnet Lizenzen, Zahlungen und Medien. Trifft die Erstfassung (Befund CH-46). Variante B hätte hier einen Vorteil, bezahlt mit drei bis vier Laufzeiten. Der Einwand ist innerhalb von A lösbar: getrennte Rechte je Prozess auf Datenbank und Speicher, Originale außerhalb der Reichweite des Webprozesses, getrennte Herkunftsadressen, Sicherung außer Reichweite des Servers (03, Abschnitt 6). Auflage 1
Der Community-Satellit ist ein Sprungbrett in den Kern und der aufwendigste Baustein im Betrieb. Trifft die Erstfassung, soweit sie eine gemeinsame Adresse und Sitzung vorsah (Befund CH-29). Lösbar durch eigene Unterdomäne ohne gemeinsame Sitzung und einen Kern, der dem Forum nicht vertraut. Der Betriebsaufwand bleibt und ist vor Stufe A3 bewusst zu entscheiden (Befund CH-54). Auflage 2
Variante D (alles selbst) vermiede Abgleich und Profilkopien. Richtig, aber COM-001 verlangt eine vollwertige Fachcommunity; der Eigenbau bleibt das größere Risiko. Die Profilkopien entfallen jetzt auch in A (09, C.4). A bleibt

Variante A bleibt die Empfehlung, unter den Auflagen 1 und 2. Ohne sie verfehlt sie SEC-003.

Was die Empfehlung ändern würde:

  • Wenn die Community auf Dauer klein bleibt und eng mit Katalogobjekten verwoben sein soll (z. B. strukturierte Erfahrungsberichte je Übung als Kernfunktion), gewinnt Variante D für einen schmalen Eigenbau an Reiz. Das Zielbild nennt aber ausdrücklich Vernetzung, private Kommunikation und Moderation.
  • Wenn ein getrenntes Frontend-Team entsteht oder native Apps geplant werden, wird die API-Trennung aus Variante B wertvoller. Variante A schließt das nicht aus: Der Kern erhält von Beginn an klar geschnittene Modulschnittstellen, die sich später als API öffnen lassen.

8. Zweite Ebene: Technologiestapel des Kerns

Die Gesamtentscheidung legt keinen Stapel fest. Vier Kandidaten wurden für den Kern verglichen. Details und Quellen in 10_Technologiebewertung.md.

Kandidat Charakter Redaktion von Haus aus Kernlogik und Transaktionen Medien-/Kennzeichnungswerkzeuge Nähe zum Betreiber¹
S1 Python-Webframework mit integriertem CMS (Django + Wagtail) Server-gerenderter Monolith Sehr stark für Seiten: Seitenbaum, Bausteinfelder, Entwurf, Vorschau, Revisionen, Freigabe-Workflows; für andere Objekte einzeln zuschaltbar Stark; Hintergrundverarbeitung über Zusatzpaket Ausreichend; Transkodierung über Kommandozeilenprogramm, PDF-Bibliotheken vorhanden (Lizenz prüfen) Python und PostgreSQL aus Shinkan; beide Frameworks neu
S2 PHP-Framework mit Admin-Baukasten (Laravel + Filament) Server-gerenderter Monolith Verwaltungsoberflächen sehr stark; CMS-Funktionen für Seiten (Entwurf, Vorschau, Revision) sind Eigenbau oder Zukauf Stark; Hintergrundverarbeitung im Framework Ausreichend; Transkodierung über Kommandozeilenprogramm, PDF-Stempelung vorhanden (Zusatzmodul für neuere PDFs prüfen) Hoch: FewoPortal nutzt genau diesen Stapel; dessen Sektionssystem deckt Entwurf und Revision nicht ab
S3 TypeScript-Framework mit eingebettetem CMS (Next.js + Payload) Server-Rendering plus Admin in einer Anwendung Stark: Versionen, Entwürfe, Vorschau, Bausteine Mittel: Geschäftslogik in CMS-Hooks oder daneben Mittel React aus Shinkan; Framework neu
S4 Getrennte API und SPA (FastAPI + React) plus separates CMS Entspricht Variante B abhängig vom CMS Stark Stark Hoch: Shinkan-Muster

¹ Aus rein lesender Sichtung von CLAUDE.md, composer.json und docker-compose.yml der Projekte FewoPortal und Shinkan. Server und Laufzeitumgebung wurden nicht eingesehen.

8.1 Einschätzung für den Kern nach der Challenger-Prüfung

Geändert gegenüber der Erstfassung. Dort stand: „Empfehlung S1 (Django + Wagtail)“, knapp, begründet mit dem fertigen Redaktionsarbeitsplatz und der Medienverarbeitung im selben Sprachraum. Die erneute Prüfung steht ausführlich in 10, Abschnitt 2.1; hier das Ergebnis.

Was von der früheren Begründung hält und was nicht:

Früheres Argument für S1 Prüfung Ergebnis
Redaktion ist neben dem Lizenzkern das am schwersten nachzubauende Stück; S1 liefert sie fertig Trifft für öffentliche Seiten zu. Für Lerninhalte entwirft die Studie ein eigenes Fassungsmodell (06, Abschnitt 1), das in beiden Stapeln Eigenbau ist. hält teilweise
CMS und Kern teilen Prozess, Datenbank und Transaktion gilt für S1 und S2: In beiden ist die Website Teil derselben Anwendung kein Unterschied
Medien- und Kennzeichnungsverarbeitung ist in Python am besten unterstützt; bei S2 käme faktisch ein Python-Worker hinzu Transkodierung ist in jedem Stapel der Aufruf eines Kommandozeilenprogramms; Dokumentstempelung gibt es in beiden; ein neuronales Wasserzeichen wäre in beiden ein eigener Dienst hält nicht
Reife und Unabhängigkeit, lange Pflegezeiträume belegt; S2 hat kürzere Zyklen, die der Betreiber für ein anderes Projekt bereits trägt hält, mit geringerem Gewicht

Was für S2 spricht und in der Erstfassung nicht gewichtet war: die Verwaltungsoberflächen des Lizenzkerns als größter Einzelaufwand; die im Framework enthaltene Hintergrundverarbeitung; der Verzicht auf einen dritten Anwendungsstapel bei einem Einzelbetreiber; aktuelle Betriebserfahrung einschließlich Ausrollweg, Mehrfaktor und Mail-Testmodus.

Was gegen S2 spricht: Entwurf, Vorschau, Revisionen und Wiederherstellung für Seiten sind Eigenbau oder Zukauf. Das vorhandene Sektionssystem des FewoPortals bietet dafür laut dessen Projektbeschreibung keine Grundlage über die Bausteinidee hinaus. Dieser Aufwand wird leicht unterschätzt.

Einschätzung: Seit dem 15.11.2026 entschieden: Laravel 13, Filament 5, PostgreSQL (ADR-02). Der Vergleich davor: Keine Fachanforderung entscheidet sie; beide Stapel tragen die Zielarchitektur aus 03 bis 09, die deshalb weiterhin stapelneutral formuliert ist. Unter dem gegebenen Betriebsrahmen spricht mehr für S2, sofern die Redaktionsanforderung WEB-005 dort mit vertretbarem Aufwand erfüllbar ist. S1 ist vorzuziehen, wenn redaktionelle Freiheit und Freigabeabläufe für Seiten hoch gewichtet werden oder der Nachweis für S2 scheitert.

Nicht empfohlen bleiben S4 (entspricht Variante B) und S3 (anstehender Hauptversionswechsel, kein erkennbarer Vorteil für dieses Vorhaben).

8.2 Entscheidungsweg

  1. Machbarkeitsnachweis in Stufe A0 mit vier eng umrissenen Punkten und festem Abbruchkriterium (10, Abschnitt 2.1). Er ist ein späterer, gesondert zu beauftragender Schritt und nicht Teil dieser Studie.
  2. Entscheidung des Auftraggebers anhand des Ergebnisses und der Frage:

Trägt die vorhandene Laravel/Filament-Erfahrung auch die Redaktionsanforderung, oder soll die fertige Redaktionsumgebung den Ausschlag geben?

Die Entscheidung ist vor Beginn von Stufe A1 zu treffen. Sie verändert weder das Domänenmodell noch die Abläufe, die Sicherheitsgrenzen, die Betriebsarchitektur oder die Roadmap. Nach Beginn der Umsetzung ist sie nicht mehr mit vertretbarem Aufwand umkehrbar.