Files
laraundfelix/docs/architektur/12_Entscheidungsprotokoll_ADR.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

30 KiB
Raw Blame History

12 – Entscheidungsprotokoll (ADR)

Status der Einträge: vorgeschlagen, sofern nicht anders vermerkt. Die Entscheidung liegt beim Auftraggeber. ADRs sind Architekturvorschläge, keine Fachregeln.

ADR-02 ist am 15.11.2026 beschlossen: Laravel 13, Filament 5, PHP 8.4, PostgreSQL, server-gerendert. Die Umsetzung hat begonnen. Die übrigen Einträge bleiben Vorschläge.

Stand nach der Challenger-Prüfung vom 14.11.2026 (13, Abschnitte 8 und 9): ADR-02, ADR-09 und ADR-10 sind ersetzt; ADR-01, ADR-11, ADR-12, ADR-14, ADR-18 und ADR-20 sind ergänzt; ADR-23 bis ADR-27 sind neu. Die übrigen wurden geprüft und unverändert beibehalten. Die frühere Fassung der ersetzten Einträge ist jeweils unter „Abgelöst“ in einem Satz festgehalten.

Nr. Thema Empfehlung in einem Satz
ADR-01 Gesamtarchitektur Integrierter modularer Kern mit Community als Satellit, mit getrennten Rechten im Innern
ADR-02 Stapel des Kerns Beschlossen (15.11.2026): Laravel 13, Filament 5, PHP 8.4, PostgreSQL, server-gerendert
ADR-03 Vier Ebenen des Produktmodells Inhalt, Lizenzartikel, Angebot, Berechtigung mit je eigener Identität
ADR-04 Artikelgrenze ausdrückliche Deklaration, keine Ableitung aus dem Inhaltsgraphen
ADR-05 Berechtigung als unteilbares Bündel Entscheidung je einzelner Berechtigung, nie Vereinigung
ADR-06 Eingefrorener Bestellumfang Kopie des aufgelösten Umfangs in der Bestellposition
ADR-07 Versionierung der Lernprodukte unveränderliche Fassungen, exakte Verweise, Kompatibilitätsbestätigung
ADR-08 Veröffentlichung Vorgang mit Vorabprüfung und atomarer Zeigerumschaltung
ADR-09 Aktualisierungen jede gültige Berechtigung deckt alle freigegebenen Fassungen ihres Artikels; keine wählbaren Anspruchsregeln
ADR-10 Upgrade zusätzlicher Erwerb mit neuer vollständiger Berechtigung; die vorhandene bleibt unverändert
ADR-11 Inhaber Person oder Organisation von Beginn an
ADR-12 Community ausgereiftes Fremdprodukt; Kern ist Identitätsgeber und führt Gruppen
ADR-13 Trainerverzeichnis im Kern, nicht in der Forensoftware
ADR-14 Zahlung Adapter; Freischaltung nur auf geprüftes Ereignis oder aktive Abfrage; aktiver Abgleich
ADR-15 Streamingschutz signierte Sitzungsadressen, kein DRM
ADR-16 Medienauslieferung austauschbarer Adapter; lokal beginnen, Auslieferungsnetz nach Schwellen
ADR-17 Kennzeichnung Stufenmodell; unsichtbares Videowasserzeichen erst nach Erprobung
ADR-18 Ausgabenachweis vor Erzeugung angelegt, für jede individuelle Ausgabe
ADR-19 Hintergrundverarbeitung datenbankgestützte Warteschlange und Postausgang
ADR-20 Betrieb Container auf einem Server; identische Anwendung in allen Stufen
ADR-21 Rechnung externer Dienst hinter Adapter
ADR-22 Seiten und Katalogdarstellung Seiten aus Bausteinen; Katalogbausteine zeigen auf Identitäten
ADR-23 Berechtigungsquelle Erwerb als individuelle Quelle je Inhaber; das allgemeine Angebot ist keine Quelle
ADR-24 Medienausgabe Gegenstand vor Recht: Ausgabe nur im Zusammenhang eines Stands; Freigabe je Datei
ADR-25 Schadensbegrenzung getrennte Rechte je Prozess, getrennte Herkunftsadressen, Verwaltung ohne Alleskönner
ADR-26 Sicherung und Wiederanlauf fortlaufend außer Haus und nur anfügbar; Sicherheitsjournal; Ziele je Schadensfall
ADR-27 Ereignis und Abgleich Ereignisse für Schnelligkeit, wiederholbarer Soll-Ist-Abgleich für Richtigkeit

ADR-01 – Integrierter modularer Kern mit Community-Satellit

Kontext. Das Zielbild verbindet Website, Katalog, Lizenzen, Kauf, Medien, Organisationen und Community. Ein kleiner Anbieter betreibt die Plattform (VIS-006). Entscheidung. Eine in Module gegliederte Kernanwendung mit einer Datenbank; Community als eigenständiges Produkt, schmal angebunden. Alternativen. Kopfloses, komponiertes System; Komposition aus Standardsoftware; vollständiger Eigenbau einschließlich Community (02). Begründung. Transaktionale Einheit von Kauf, Recht und Nachweis; eine Datenquelle für Website und Rechte; wenige Betriebsteile; Community-Funktionen müssen nicht entwickelt werden. Folgen. Zwei Oberflächen und zwei Technologiestapel; bewusste Gestaltung der Einheit nötig (09, C.8). Modulgrenzen müssen diszipliniert eingehalten werden, sonst entsteht ein unstrukturierter Monolith. Ergänzt nach der Challenger-Prüfung. Die Entscheidung wurde erneut gegen die Alternativen geprüft und bleibt, unter zwei Auflagen (02, Abschnitt 7): Der Kern ist eine ausrollbare Einheit, aber nicht ein einziger Vertrauensbereich (ADR-25); der Satellit teilt weder Herkunftsadresse noch Sitzung mit dem Kern (ADR-12).

ADR-02 – Technologiestapel des Kerns (ersetzt)

Kontext. Redaktionsarbeitsplatz (WEB-005), Lizenzkern mit umfangreicher Verwaltung, Hintergrundverarbeitung, Medienverarbeitung; ein Betreiber mit begrenzter Wartungszeit, der Laravel/Filament aktuell betreibt und Python/PostgreSQL/Docker kennt. Entscheidung. Beschlossen am 15.11.2026 mit Beginn der Umsetzung: Laravel 13, Filament 5, PHP 8.4 und PostgreSQL. Die Seiten sind server-gerendert; Entwurf, Vorschau, Veröffentlichung und Wiederherstellung einer Revision sind Bestandteil der Anwendung. Der frühere Vergleich bleibt als Begründung stehen: Unter dem Betriebsrahmen sprach mehr für Laravel + Filament. Der Machbarkeitsnachweis aus 10, Abschnitt 2.1, wird durch die laufende Umsetzung ersetzt und nicht erneut als Studie geführt. Alternativen. Next.js + Payload; FastAPI + React + Headless CMS (beide weiterhin nicht empfohlen). Begründung. Keine Fachanforderung entscheidet zwischen den beiden Kandidaten. Django + Wagtail bringt die Redaktion öffentlicher Seiten fertig mit und hat längere Pflegezeiträume. Laravel + Filament bringt die Verwaltungsoberflächen des Lizenzkerns (größter Einzelaufwand), die Hintergrundverarbeitung und die vorhandene Betriebserfahrung mit und vermeidet einen dritten Stapel. Folgen. Die Umsetzung hat begonnen. Ein Wechsel des Stapels ist nicht mehr mit vertretbarem Aufwand möglich. Die Modulgrenzen aus 03 bleiben bestehen; die Formulierung älterer Kapitel ist weiterhin stapelneutral und wird nicht neu geschrieben. Abgelöst. Frühere Fassung: „Django + Wagtail, knapp, wegen fertiger Redaktion und Medienwerkzeugen im selben Sprachraum“. Das Medienargument hielt der Prüfung nicht stand, das Redaktionsargument nur für öffentliche Seiten (Befunde CH-52, CH-53).

ADR-03 – Vier Ebenen des Produktmodells

Kontext. PROD-001 verbietet eine starre Hierarchie; PROD-008 verlangt eigene Rollen für Medien, Inhalte, Artikel, Pakete, Angebote. Entscheidung. Inhalt, Lizenzartikel, Angebot und Berechtigung sind getrennte Ebenen mit eigenen Identitäten und eigenen Lebenszyklen. Alternativen. Ein „Produkt“-Objekt mit Typfeld und Eltern-Kind-Beziehung. Begründung. Nur die Trennung erlaubt Wiederverwendung ohne Kopie, frei gesetzte Artikelgrenzen, veränderliche Angebote bei festen Käufen. Folgen. Mehr Objekte und mehr Begriffe für die Redaktion; die Verwaltung muss den Zusammenhang sichtbar machen (Vorschau der Auflösung, Verwendungsnachweis).

ADR-04 – Artikelgrenze durch ausdrückliche Deklaration

Kontext. PROD-005 verlangt Auflösung auf die „kleinsten enthaltenen lizenzierbaren Artikel“. Im freien Inhaltsgraphen ist „kleinste“ nicht eindeutig, sobald sich Artikel überschneiden oder Material keinem kleineren Artikel angehört. Entscheidung. Lizenzartikel sind die Blätter des Paketgraphen und werden nie weiter zerlegt. Der Betreiber deklariert sie. Eine Abdeckungsprüfung meldet Material, das von keinem Artikel erfasst ist. Alternativen. Automatische Ableitung durch Abstieg im Inhaltsgraphen. Begründung. Deterministisch, erklärbar, frei von Mehrdeutigkeit (PROD-007). Folgen. Der Betreiber muss Artikel bewusst anlegen; die Funktion „Paket aus Komposition vorschlagen“ mildert den Aufwand.

ADR-05 – Berechtigung als unteilbares Bündel

Kontext. LIC-006: keine Vermischung zu nicht erworbenen Kombinationen. Entscheidung. Jede Berechtigung trägt ein vollständiges Rechtebündel. Die Entscheidungsfunktion prüft jede Bedingung an derselben Berechtigung. Eine Vereinigung über Berechtigungen existiert im Code nicht. Alternativen. Wirksame Rechte als Vereinigung aller Fähigkeiten mit nachträglichen Ausschlussregeln. Begründung. Für die verbotene Kombination gibt es im Entwurf keinen Weg; die tragende Berechtigung jeder Aktion ist benennbar. Die Challenger-Prüfung hat das bestätigt (Befund CH-05), mit der Einschränkung, dass zusätzlich der Gegenstand der Anfrage zu prüfen ist (ADR-24). Folgen. Upgrades sind neue Berechtigungen (ADR-10). Die Bibliothek muss „wirksame Aktionen“ über die Entscheidungsfunktion ermitteln.

ADR-06 – Eingefrorener Bestellumfang

Kontext. PROD-006, PAY-005: Angebote und Pakete ändern sich; frühere Käufe müssen rekonstruierbar bleiben. Entscheidung. Die Bestellposition verweist auf die Angebotsfassung und trägt eine eigene Kopie des aufgelösten Umfangs einschließlich einer Kopie der Rechte, der Laufzeit und der Updatezusage. Alternativen. Nur Verweis auf die unveränderliche Angebotsfassung. Begründung. Die Kopie macht die Bestellung unabhängig von späterem Archivieren oder Datenbereinigungen im Katalog und ist die unmittelbare Vorlage für die Vergabe. Folgen. Redundante Speicherung; gewollt.

ADR-07 – Versionierung der Lernprodukte

Kontext. VER-001 bis VER-006. Entscheidung. Unveränderliche Fassungen für Inhalte und Kompositionen; Kompositionen verweisen auf exakte Mitgliedsfassungen; Kompatibilitätsbestätigung ist an die Prüfsumme der Mitgliedermenge gebunden. Alternativen. „Aktuelle Fassung“ als gleitender Verweis; gemeinsame Versionsnummer für alle Bestandteile. Begründung. Gleitende Verweise verletzen VER-006; gemeinsame Nummern widersprechen VER-004. Folgen. Jede Änderung an einem geteilten Inhalt erzeugt Arbeit in jeder verwendenden Komposition. Das ist die geforderte fachliche Bewertung, kein Nebeneffekt.

ADR-08 – Veröffentlichung als Vorgang mit atomarer Umschaltung

Kontext. VER-005, ADM-003, SC-18: kein halb veröffentlichter Stand. Entscheidung. Alle Medien liegen vor der Freigabe vollständig und unveränderlich adressiert vor; die Veröffentlichung ändert in einer Transaktion nur Zeiger und Status. Alternativen. Schrittweises Aktivieren einzelner Objekte. Begründung. Fehler in Verarbeitung oder Umschaltung können den bestehenden Stand nicht berühren. Folgen. Nachgelagerte Wirkungen müssen wiederholbar sein; Speicher wächst, weil nichts überschrieben wird.

ADR-09 – Aktualisierungen: alle freigegebenen Fassungen des Artikels (ersetzt)

Kontext. VER-008 und VER-010 in der Fassung vom 14.11.2026 (Beschlüsse F-NEU-01, F-NEU-02): Die Updatepolitik ist entschieden. Entscheidung. Eine gültige Berechtigung deckt jeden freigegebenen, nicht gesperrten Stand ihres Lizenzartikels (INV-18). Es gibt keine wählbaren Anspruchsregeln. Abgelöste Stände bleiben im Regelfall verfügbar; Sperre und Rückzug sind begründungspflichtige Einzelentscheidungen. Die Updatezusage wird als fester Wert in Angebotsfassung und Bestellung festgehalten. Die Einordnung „neue Fassung“ oder „neues Produkt“ ist eine festgehaltene Betreiberentscheidung mit Begründung; der Auswirkungsbericht zeigt ihre Folgen (06, Abschnitt 7). Alternativen. (a) Wählbare Regeln je Angebot (frühere Fassung); (b) Regel nur im Code ohne festgehaltene Zusage; (c) technische Kriterien für die Produktgrenze. Begründung. (a) widerspricht der entschiedenen Regel und kompliziert den Kern ohne Nutzen; (b) ließe das Zugesagte unbelegt, falls die Politik für künftige Verkäufe geändert würde; (c) wäre eine Geschäftsregel, die das System nicht zu setzen hat. Folgen. Kein Erlös aus neuen Fassungen desselben Artikels; die Produktgrenze wird geldwirksam und braucht Sorgfalt. Mehrere Stände eines Artikels sind gleichzeitig auslieferbar; die Bibliothek zeigt die neueste zuerst. Abgelöst. Frühere Fassung: „Versionsanspruch je Berechtigung als konfigurierbare Regel (fixiert, bis Ausgabe, Zeitraum, alle) mit Stand-Klasse und Pflichtaktualisierung“. Auftragsgemäß für eine damals offene Politik entworfen; durch den Beschluss überholt (Befunde CH-10, CH-11, CH-12).

ADR-10 – Upgrade als zusätzlicher Erwerb (ersetzt)

Kontext. LIC-007, LIC-012 (Beschluss F-NEU-03), SC-09. Entscheidung. Ein Upgrade ist eine Bestellposition und wird zu einem eigenen Erwerb mit einer neuen, vollständigen Berechtigung. Die vorhandene Berechtigung bleibt unverändert aktiv (INV-19). Die Bestellposition hält fest, auf welche Berechtigung sich das Upgrade bezieht und ob es von deren Fortbestand abhängt („abhängig“ oder „eigenständig“). Fällt die Bezugsberechtigung eines abhängigen Upgrades durch Erstattung, Rückbuchung oder Widerruf weg, wird das Upgrade ausgesetzt und ein Klärungsfall angelegt (05, Abschnitt 8). Alternativen. (a) Zusatzrecht, das eine vorhandene Berechtigung ergänzt; (b) Ersetzung der Ausgangsberechtigung mit Zustand „aufgegangen“ (frühere Fassung). Begründung. (a) wäre die Vermischung, die LIC-006 verbietet. (b) verschlechtert erworbene Rechte, sobald das Upgrade abläuft, rückgebucht wird oder die Ausgangsbestellung erstattet wird, und lässt erstattete Rechte wieder aufleben. Das Nebeneinander zweier vollständiger Berechtigungen schadet nicht, weil die Entscheidung je Berechtigung einzeln prüft (ADR-05). Folgen. Ein Artikel kann mehrere aktive Berechtigungen desselben Inhabers haben; die Bibliothek fasst sie zusammen. Preisformel und die Wahl „abhängig“ oder „eigenständig“ je Upgrade-Angebot sind Geschäftsentscheidungen (13, E-21). Abgelöst. Frühere Fassung: „Ausgangsberechtigung wird als aufgegangen markiert und bei Erstattung des Upgrades reaktiviert“ (Befunde CH-06, CH-07).

ADR-11 – Inhaber ist Person oder Organisation

Kontext. ID-003, ID-004, SCOPE-003. Entscheidung. Berechtigungen zeigen von Beginn an auf einen abstrakten Inhaber. Sitzpool und Sitzzuweisung sind Teil des Grundmodells, auch wenn die Oberfläche später kommt. Alternativen. Berechtigung am Konto; Organisationen später nachrüsten. Begründung. Nachrüsten würde die zentrale Tabelle und die Entscheidungsfunktion umbauen. Folgen. Geringfügig mehr Modell in der ersten Stufe. Ergänzt nach der Challenger-Prüfung. (1) Genau ein Sitzpool je Erwerb der Organisation mit der beim Erwerb eingefrorenen Sitzzahl; eine Sitzzuweisung setzt eine aktive Mitgliedschaft voraus und endet mit ihr (Befunde CH-25, CH-26). (2) Der erste Schnitt verkauft nur an Einzelpersonen. Die frühere Aussage, Organisationslizenzen seien „als manuelle Betreibervergabe an einzelne Konten überbrückbar“, ist zurückgenommen: Persönliche Berechtigungen werden nicht als Organisationslizenz angeboten oder abgerechnet (ID-004, Beschluss F-NEU-04; Befund CH-24).

ADR-12 – Community als Fremdprodukt, Kern führt

Kontext. COM-001 bis COM-007. Entscheidung. Selbst betriebene Forensoftware (Kandidat: Discourse); der Kern ist Identitätsgeber, steuert Gruppen aktiv und legt Themen je Artikel an. Kein Zustand der Community verändert Rechte im Kern. Alternativen. Eigenbau; gehostetes Produkt; anderes Forenprodukt. Begründung. Reife Moderations- und Kommunikationsfunktionen; schmale Kopplung; Ausfall ohne Wirkung auf Kernwege. Folgen. Zweiter Technologiestapel mit eigenem Aktualisierungsrhythmus; Mailversand zwingend. Ergänzt nach der Challenger-Prüfung. (1) Eigene Unterdomäne, keine gemeinsame Sitzung, der Kern vertraut Inhalten des Forums nicht (Befund CH-29). (2) Das Forum erhält nur Kennung, Anzeigename, optional Bild und die bestätigte E-Mail; Profilangaben bleiben im Kern, ein Profilabgleich entfällt (Befund CH-31). (3) Entzug und Sperre mit Zurücklesen, Vorrang und Alarm; stündlicher Vollabgleich; kurzes Sitzungsalter im Forum (Befund CH-30). (4) Das verbleibende Zeitfenster bei gestörter Verbindung wird als Restrisiko benannt, nicht wegdefiniert. (5) Die Produktwahl fällt vor Stufe A3 nach einem kleinen Nachweis der Schnittstellen (10, Abschnitt 11 Nr. 2; Befunde CH-32, CH-54).

ADR-13 – Trainerverzeichnis im Kern

Kontext. COM-003, COM-005, SC-22: Sichtbarkeit je Angabe, Suche darf Verborgenes nicht verraten. Entscheidung. Profil, Sichtbarkeit, Verzeichnis, Suche und Kontaktanfrage liegen im Kern. Alternativen. Nutzerverzeichnis und Standorterweiterung der Forensoftware. Begründung. Feines Privatsphäremodell; Verknüpfung mit dem Trainerstatus; Darstellung auch auf der Website; die geprüfte Erweiterung bietet das nicht in der nötigen Feinheit. Folgen. Eigenentwicklung überschaubaren Umfangs.

ADR-14 – Zahlung hinter Adapter mit aktivem Abgleich

Kontext. PAY-001, PAY-004, OPS-003, SC-24; Anbieter offen (PAY-006). Entscheidung. Adapter mit vier Operationen. Freischaltung nur nach signiertem Ereignis oder aktiver Statusabfrage. Eingangskorb mit eindeutiger Ereignis-ID. Regelmäßiger Abgleich der Ereignisliste und aller offenen Bestellungen. Alternativen. Freischaltung beim Rücksprung des Browsers; Vertrauen allein auf Wiederholungen des Dienstes. Begründung. Der eigene Server kann länger ausfallen als ein Dienst wiederholt; der Rücksprung ist fälschbar und unzuverlässig. Folgen. Etwas mehr Aufwand; dafür sieht der Entwurf keinen Weg vor, auf dem eine Bestellung unbemerkt verloren geht. Ergänzt nach der Challenger-Prüfung. (1) Die Meldung ist nur der Auslöser; maßgeblich ist der beim Dienst abgefragte Zustand der vom Kern selbst gespeicherten Zahlungsreferenz (INV-20). Damit sind falsche Reihenfolge und gefälschte Meldungen wirkungslos (Befunde CH-18, CH-48). (2) Ein Ereignis gilt erst nach abgeschlossener Verarbeitung als erledigt (CH-19). (3) Der Abgleich prüft auch bezahlte Bestellungen eines Rückblickzeitraums auf Erstattung und Streitfall (CH-22). (4) Eine Zahlung auf eine verworfene Bestellung führt zu Freischaltung oder Betreiberaufgabe, nie ins Leere (CH-20). (5) Zweite Zahlungsart „Überweisung auf Rechnung“ über dieselbe Bestellung (CH-56).

ADR-15 – Streamingschutz ohne DRM

Kontext. MED-001, MED-003; MED-002 verlangt keine absolute Kopierverhinderung. Entscheidung. Segmentiertes Streaming über kurzlebig signierte, an eine Sitzung gebundene Adressen; optional Abschnittsverschlüsselung. Alternativen. Kommerzielles DRM. Begründung. Verhältnis von Schutzgewinn zu Kosten, Abhängigkeit und Gerätekompatibilität im Kursbetrieb. Folgen. Technisch versierte Nutzer mit Zugang können mitschneiden; das ist vertraglich zu regeln und ehrlich zu kommunizieren. DRM bleibt nachrüstbar.

ADR-16 – Medienauslieferung als Adapter

Kontext. OPS-001 verlangt Start auf eigenem Server; MED-006 verlangt verlässliche Wiedergabe im Kurs. Entscheidung. Ausgabe stellt signierte Adressen aus; wer sie bedient, ist konfigurierbar. Start lokal; Wechsel auf ein Auslieferungsnetz bei definierten Schwellen. Alternativen. Von Beginn an Auslieferungsnetz; dauerhaft lokal; vollständiger Videodienst. Begründung. Erfüllt OPS-001 und hält den Ausweg offen, ohne vorab Kosten zu erzeugen. Folgen. Zwei Betriebsarten sind zu testen; beim Rückzug muss ein externer Zwischenspeicher geleert werden.

ADR-17 – Stufenmodell der Kennzeichnung

Kontext. MED-002, MED-005, OPEN-05. Entscheidung. Nachweis, eingebettete Kennung und sichtbare Lizenzzeile als feste Stufen; unauffällige Dokumentmerkmale als Ergänzung; forensisches Videowasserzeichen als Option nach bestandenem Versuch. Alternativen. Sofortige Zusage eines unsichtbaren Videowasserzeichens; Verzicht auf individuelle Kennzeichnung. Begründung. Nützliche Zuordnung ab der ersten Stufe; keine unbelegte Zusage. Folgen. Produkttexte dürfen bis zum Nachweis nur von „individuell gekennzeichneten Kopien“ sprechen.

ADR-18 – Ausgabenachweis vor Erzeugung

Kontext. VER-009, INV-10. Entscheidung. Der Nachweis wird beim Anfordern angelegt und begleitet die Datei durch Erzeugung und Auslieferung. Alternativen. Protokollierung nach erfolgreichem Download. Begründung. Keine individuelle Datei ohne Nachweis; Abbrüche bleiben nachvollziehbar. Folgen. Es entstehen auch Nachweise für nie abgerufene Dateien; ihr Status zeigt das. Ergänzt nach der Challenger-Prüfung. (1) Der Nachweis ist ein Protokoll und für sich keine Kennzeichnung: Eine gefundene Kopie ordnet er nur zu, wenn die Datei individualisiert war (Befund CH-34). (2) Dokumente werden auch beim Ansehen als gekennzeichnete Kopie mit Nachweis ausgegeben (CH-04). (3) Der Nachweis nennt den Zugriffsweg und ist auf Datenbankebene nur anfügbar. (4) Beim Abruf wird erneut entschieden (CH-23). (5) Nach einer Wiederherstellung kann ein kurzes Fenster ohne Nachweise bleiben; das ist benannt (11, Abschnitt 3.4).

ADR-19 – Datenbankgestützte Hintergrundverarbeitung

Kontext. Medienverarbeitung, Individualisierung, Abgleich, Benachrichtigung, Community-Abgleich; OPS-003 verlangt verlustfreien Umzug offener Aufträge. Entscheidung. Aufträge und fachliche Ereignisse liegen in der Kerndatenbank und werden in derselben Transaktion wie die auslösende Änderung geschrieben. Alternativen. Eigener Warteschlangendienst. Begründung. Ein Betriebsteil weniger; Aufträge sind Teil der Sicherung; keine verlorenen Nebenwirkungen. Folgen. Bei sehr hohem Durchsatz wäre ein eigener Dienst effizienter; das ist nicht absehbar und nachrüstbar.

ADR-20 – Containerbetrieb auf einem Server

Kontext. OPS-001 bis OPS-004. Entscheidung. Alle Bausteine als Container mit einer Compose-Beschreibung; gesamter Zustand in Datenbank, Medienspeicher und Community-Sicherung. Alternativen. Direktinstallation; Orchestrierer. Begründung. Umzug ist Wiederherstellung auf anderem Rechner; passt zur vorhandenen Erfahrung. Folgen. Kein automatisches Ausweichen bei Rechnerausfall; für die Größe angemessen. Ergänzt nach der Challenger-Prüfung. „Angemessen“ heißt: Wiederanlauf nach Verlust von Server oder Standort in Tagen, nicht in Stunden. Die früheren Zielwerte waren durch die Verfahren nicht getragen (ADR-26).

ADR-21 – Rechnung über externen Dienst

Kontext. PAY-005; E-Rechnung zwischen Unternehmen wird verpflichtend. Entscheidung. Rechnungsadapter; der Kern hält Nummer und unveränderliche Kopie. Alternativen. Erzeugung im Kern; Rechnungsfunktion des Zahlungsdienstes. Begründung. Formatpflichten, Nummernkreise, Korrekturen und Übergabe an die Steuerberatung sind nicht Kernkompetenz der Plattform. Folgen. Laufende Kosten; Produktwahl mit der Steuerberatung.

ADR-22 – Seiten aus Bausteinen, Katalogdarstellung über Verweise

Kontext. WEB-004, WEB-005. Entscheidung. Freier Seitenbaum mit geprüfter Bausteinbibliothek; Katalogbausteine zeigen auf Identitäten und stellen den aktuell veröffentlichten Stand dar; Preise und Rechte sind auf Seiten nicht frei eintippbar. Alternativen. Freier Layout-Editor; feste Seitenvorlagen ohne Baukasten. Begründung. Konsistenz zwischen Seite, Angebot und Freischaltung; Zugänglichkeit bleibt prüfbar; Redaktion bleibt beweglich. Folgen. Neue Bausteintypen sind Entwicklungsarbeit.

ADR-23 – Erwerb als individuelle Berechtigungsquelle (neu)

Kontext. LIC-001, LIC-005, PAY-004; Befunde CH-01, CH-02: Die frühere „Quelle“ war je nach Fundstelle ein Angebot, eine Bestellposition oder eine Inhaberart, und ihre Eindeutigkeitsregel ließ entweder nur ein Mitglied je kostenlosem Angebot zu oder gar keine Sicherung gegen Doppelvergabe. Entscheidung. Jede Berechtigung gehört zu genau einem Erwerb mit genau einem Inhaber. Vier Erwerbstypen: Bestellposition, freier Abruf, manuelle Vergabe, Abonnement. Eindeutig ist der Erwerb je Bestellposition bzw. je (Inhaber, kostenloses Angebot) und die Berechtigung je (Erwerb, Artikel, Rechteprofil-Fassung). Das allgemeine Angebot und die Organisation sind keine Quellen; „über Organisation X“ ist ein Zugriffsweg. Alternativen. (a) Inhaber in den Eindeutigkeitsschlüssel der Berechtigung aufnehmen und die Quelle beim Angebot belassen; (b) je Vergabe eine namenlose Quellenzeile ohne eigene Eindeutigkeit. Begründung. (a) behebt die Kollision, lässt aber die Vermengung von Angebot und Herkunft bestehen und trägt Upgrade-Bezug, Sitzpool und eingefrorene Bedingungen nicht. (b) verliert die Idempotenz. Der Erwerb ist der natürliche Träger für alles, was beim Erwerb vereinbart wurde. Folgen. Ein zusätzliches Objekt in der zentralen Struktur; gehört zu den nicht verhandelbaren Vorleistungen der ersten Stufe.

ADR-24 – Gegenstand vor Recht: Ausgabe nur im Zusammenhang eines Stands (neu)

Kontext. MED-003, VER-008 Nr. 4; Befunde CH-03, CH-14: Die Entscheidung prüfte das Recht, aber nicht, ob das angefragte Medium zu dem Artikel und Stand gehört, für den das Recht besteht. Entscheidung. Jeder Stand hält bei der Freigabe seinen fixierten Inhalt als flache, unveränderliche Liste fest. Die Entscheidung lehnt ab, wenn der Stand nicht zum Artikel oder die Inhaltsfassung nicht zu diesem Inhalt gehört. Eine Zugriffsfreigabe gilt für genau eine Datei bzw. ein Stream-Format der entschiedenen Inhaltsfassung, mit passendem Zweck (INV-17). Alternativen. (a) Zugehörigkeit bei jeder Anfrage durch Durchlaufen des Kompositionsgraphen ermitteln; (b) Schutz allein durch nicht erratbare Dateipfade; (c) Verschlüsselung je Artikel. Begründung. (a) ist fehleranfällig und langsam bei Verschachtelung; (b) ist kein Schutz; (c) ist eine sinnvolle Ergänzung, ersetzt aber die Prüfung nicht. Die fixierte Liste dient zugleich dem Rückzug über Verschachtelungen hinweg und dem Verbot historischer Mischfassungen. Folgen. Eine zusätzliche, bei der Freigabe berechnete Tabelle; eine weitere automatische Prüfung im Veröffentlichungsvorgang.

ADR-25 – Schadensbegrenzung innerhalb des Kerns (neu)

Kontext. SEC-003 (Beschluss F-NEU-05); Befunde CH-37, CH-44, CH-46, CH-47: ein Prozess, ein Datenbankzugang, eine Rolle „alles“; „unveränderlich“ nur als Konvention. Entscheidung. Der Kern bleibt eine ausrollbare Einheit, läuft aber in getrennten Betriebsarten mit verschiedenen Rechten: Die Web-Betriebsart hat eine eingeschränkte Datenbankrolle (Auditprotokoll und Ausgabenachweis nur anfügbar, freigegebene Fassungen nicht änderbar, keine Schemaänderung) und keinen Zugriff auf Originale. Fremde Dateien werden in einem abgeschotteten Unterprozess gelesen. Website, Forum und Verwaltung haben getrennte Herkunftsadressen. In der Verwaltung gibt es keine Rolle „alles“; Rollenvergabe liegt bei einem eigenen Systemkonto; wirkungsstarke Vorgänge haben Mengengrenzen und eine Meldung außerhalb der Plattform. Alternativen. (a) Aufteilung des Kerns in getrennte Dienste (Variante B); (b) Verzicht auf innere Grenzen und Verlass auf Aktualisierungen und Mehrfaktor; (c) erzwungenes Vier-Augen-Prinzip. Begründung. (a) erkauft die Trennung mit mehr Betriebsteilen, die ein Einzelbetreiber nicht pflegen kann; (b) verfehlt SEC-003; (c) ist mit einer Person nicht tragbar und bleibt zuschaltbar. Getrennte Rollen und Einhängepunkte kosten Konfiguration, keinen zusätzlichen Dienst. Folgen. Etwas mehr Sorgfalt beim Ausrollen (zwei Datenbankrollen, getrennte Geheimnisse). Verbleibend: Ein übernommener Webprozess kann personenbezogene Daten lesen; die Hintergrundverarbeitung bleibt die mächtigste Komponente (11, Abschnitte 7.3 und 7.7).

ADR-26 – Sicherung außer Reichweite, Sicherheitsjournal, Ziele je Schadensfall (neu)

Kontext. OPS-002, OPS-003, SEC-002; Befunde CH-41 bis CH-45: Die Zielwerte waren für Standortverlust und Kompromittierung nicht getragen; Sicherungen waren vom Server aus zerstörbar; eine Wiederherstellung hob Sicherheitsentscheidungen auf. Entscheidung. (1) Ziele je Schadensfall statt eines Pauschalwerts; sie gelten erst nach einer Übung mit Zeitmessung als belegt. (2) Fortlaufendes Änderungsprotokoll der Datenbank an zwei Ziele, eines außer Haus. (3) Das Außer-Haus-Ziel ist aus Sicht des Servers nur anfügbar. (4) Eine Inhaltsfassung wird erst „bereit“, wenn ihr Original an zwei Orten bestätigt vorliegt. (5) Ein Sicherheitsjournal außerhalb des Servers hält Rückzüge, Sperren, Entzüge und Löschungen fest und wird nach jedem Zurückspielen erneut angewendet, bevor die Plattform öffnet. (6) Anker der Audit-Kette außerhalb des Servers. (7) Fehlbedienung und Kontomissbrauch werden vorwärts korrigiert, nicht zurückgespielt. Alternativen. (a) Zweiter, laufend gespiegelter Standort; (b) tägliche Sicherung außer Haus ohne Änderungsprotokoll; (c) sofortiger Umzug auf einen Mietserver. Begründung. (a) ist für die Größe überzogen; (b) lässt bis zu einem Tag Bestellungen und Nachweise verlieren; (c) widerspräche OPS-001, bleibt aber die Antwort, sobald Verfügbarkeit zugesagt werden soll. Folgen. Laufende Kosten für ein Außer-Haus-Ziel mit Schreibschutz; jährliche Standortausfall-Übung. Die Entscheidung über die Ziele liegt beim Betreiber (13, E-22).

ADR-27 – Ereignisse für Schnelligkeit, Abgleich für Richtigkeit (neu)

Kontext. PAY-004, PROD-005, COM-002; Befunde CH-18, CH-21, CH-30: Mehrere Zusicherungen hingen an genau einem Ereignis und gingen verloren, wenn es fehlte, doppelt kam oder in falscher Reihenfolge eintraf. Entscheidung. Wo ein Anspruch aus einer Regel folgt (kostenloses Angebot, dynamische Angebotsfassung) oder ein Zustand in einem fremden System nachzuführen ist (Zahlungszustand, Gruppen und Sperren im Forum), gibt es neben dem Ereignis einen wiederholbaren, idempotenten Soll-Ist-Abgleich. Alternativen. Verlass auf garantierte Zustellung der Ereignisse. Begründung. Zustellung ist zwischen getrennten Systemen und über Ausfälle hinweg nicht garantierbar; ein Abgleich ist bei den erwarteten Mengen billig und macht Fehler selbstheilend. Folgen. Jede abgeglichene Operation muss idempotent sein (ADR-23 sichert das für Vergaben). Abweichungen werden behoben und gemeldet, nie stillschweigend.