16 KiB
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:
- 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.
- 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.
- 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
- 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. - 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.