adr vertraulich owner: matus

ADR-0001: Provenienz und Scope — Gold Path E1/E3 aus dem `tuxamed`-Extraktionsbericht, E2 bewusst ausgeschlossen

ADR-0001: Provenienz und Scope — Gold Path E1/E3 aus dem tuxamed-Extraktionsbericht, E2 bewusst ausgeschlossen

Status

Angenommen (2026-08-09)

Kontext

Herkunft des Materials. Die fachliche Grundlage dieses Produkts liegt in einem anderen Repo: tuxamed, Verzeichnis Bearbeitet/. Das ist das anonymisierte, verifizierte Ergebnis eines Use-Case-Extraktionsdurchlaufs nach GG-META-0005 vom 2026-08-08 — 8 Domänendokumente, 3 Prozesse, 90 Testfälle, ein Rollenmodell und ein Extraktionsbericht mit 65 offenen Fragen. Die Arbeitszone raw/ desselben Repos ist versiegelt; sie wurde bei der Anlage dieses Produkts nicht geöffnet, nicht gelesen und nicht aufgelistet, und das gilt weiter.

Der Umfang ist nicht selbst gewählt. Bearbeitet/00-bericht.md §9 enthält einen ausgearbeiteten Schnittvorschlag, der ausdrücklich nicht nach „was ist am einfachsten" ausgewählt ist, sondern nach: „Welcher zusammenhängende Ausschnitt ist mit dem heute vorliegenden Material überhaupt belegbar und erzeugt trotzdem einen Durchlauf, zu dem der Kunde ‚ja, so meinen wir das' oder ‚nein, so nicht' sagen kann?" Dieser Schnitt heißt dort „Gold Path E1/E3" und umfasst 34 der 108 Stories.

Derselbe Abschnitt rechnet vor, warum der im Material selbst genannte „MVP-/Weekend-Cut" keiner ist: Er listet 78 Stories — alle 77 P0-Stories plus eine — und benennt damit den vollständigen P0-Umfang unter anderem Namen.

Zwei Fragen überlagern alles andere. OF-B1 (IVDR/MDR) und OF-B2 (Pilot-Betriebsmodus) sind im Material selbst als über den Prototypen hinaus blockierend geführt, an Dritte adressiert und mit langer Vorlaufzeit versehen. Sie sind so folgenreich, dass sie eigene ADRs haben (ADR-0002, ADR-0003).

Entscheidung

1. Eigenes Produkt-Repo tuxametrics, Geschwister-Checkout neben zwirn (GG-META-0002 §0), groupId = io.dl.tuxametrics. Ausgangspunkt: zwirn-project-template, Servicemuster aus zwirn/samples/sample-data-service-quarkus, Frontendmuster aus zwirn/samples/sample-frontend-react.

   Nicht unter C:\dev\tuxamed\ verschachtelt: dort liegt bereits ein eigenes Git-Repo mit der versiegelten Arbeitszone raw/. Ein verschachteltes Repo würde die Trennung zwischen Rohmaterial-Zone und Produktcode aufweichen — genau die Trennung, die GG-META-0005 §4 schützt.

2. Modul-Kürzel txm (TuXaMetrics). Verwendet für das Business-Key-Segment ({tenant}-txm-{objekt}-{nanoid8}), den Capability-Namensraum (txm.{objekt}.{aktion}) und das API-Präfix (/api/txm/v1).

   Begründung: Der Gold-Path-Schnitt ist ein zusammenhängender fachlicher Ablauf über acht Domänen hinweg (Patient → Befund → Auswertung → Empfehlung → Freigabe → Report), nicht acht getrennte Bounded Contexts. Also genügt ein Kürzel für das Produkt als Ganzes — wie pra bei prototyping-assistant, anders als vam bei dkfz-prozesswerkstatt, wo das Kürzel nur einen von mehreren geplanten Contexts benennt. txm ist frei gegenüber den Kürzeln in Reichweite (smpl, tstm, aim, vam, fin, vid, pra).

   Abweichung vom Material, bewusst: Bearbeitet/domaenen/00-domaenenschnitt.md schlägt acht Modulkürzel vor (regw, pata, intk, ausw, evid, thpl, rprt, govn). Die Objektkürzel daraus sind übernommen (pat, aus, msw, med, fnd, rec, ovr), die Modulkürzel nicht — acht Services für einen Prototyp wären eine Architekturentscheidung, die das Material nicht trägt und die den einen Durchlauf, um den es geht, in acht Deployments zerlegen würde. Der Domänenschnitt bleibt als Paketstruktur und Dokumentation erhalten (../project/domain-map.md).

3. Scope = Gold Path E1/E3, wörtlich nach §9. Enthalten sind die FACH-Items der Epics F0, F1, F2, F3, F4, F6, F7, F8, F11 und FACH-119 als mitgeführtes Feld. Die vollständige Tabelle, den Nicht-Umfang mit Begründung und den auf 63 von 90 gefilterten Testfallkatalog führt ../project/gold-path-scope.md (PG-FACH-0001).

4. Die Auswertungsebene E2 ist vollständig ausgeschlossen — und zwar sichtbar. Sie kommt in diesem Repo nirgends vor: kein Enum-Wert, kein Feld, kein Konzept, keine Referenz. Das Ebene-Enum trägt E1 und E3; die Lücke in der Nummerierung ist beabsichtigt und unübersehbar.

   Grund, wörtlich aus §9: „Die gesamte Ebene E2 — FACH-040, FACH-050, FACH-051. Nicht baubar. Keine Auffälligkeitsbereiche (OF-01/E-7). Das ist die schmerzhafteste Streichung: E2 ist laut quelle-02.md das fachliche Alleinstellungsmerkmal gegenüber einer reinen Werteliste." Zu keinem der sieben Verhältnisse (Ca/Mg, Zn/Cu, Na/K, Fe/Cu, Ca/P, Ca/K, Na/Mg) liegt ein Zahlenbereich vor.

   Ein durchnummeriertes E1/E2/E3 mit leerem E2-Zweig hätte so ausgesehen, als sei die Ebene gebaut und nur nicht befüllt. Der Berichtsabschnitt „Störungsebenen E2" existiert deshalb als ausdrücklich leerer Abschnitt mit Begründung — ein fehlender Abschnitt sieht aus wie ein Fehler, ein leerer mit Begründung ist eine Aussage.

5. Die vier „unbequemen" Elemente bleiben — gesperrte Empfehlung mit Grund, Stufenkappung, Konfundierung, informierte Übersteuerung. §9 sagt dazu: der Schnitt behält sie, „weil ohne sie die Demo das Produkt falsch darstellt", und das Material selbst nennt eine Konstellation, in der das System bewusst keine Empfehlung erzeugt, „der fachlich überzeugendste Teil der Demo". Wie sie technisch modelliert sind: ADR-0004.

6. Ein synthetischer Referenzfall statt dreizehn. §10 nennt ihn als eines der drei Dinge mit dem besten Verhältnis von Aufwand zu Wirkung: Konstellation 2 (CRP erhöht bei erniedrigtem Zink und Selen) mit Positiv- und Negativerwartung. Er liegt als Init-Bundle unter init-bundle/praxis01-referenzfall-02.json, ist als synthetisch gekennzeichnet und um drei Analyte erweitert, damit alle vier unbequemen Elemente in einem Durchlauf sichtbar werden. Die Erweiterung ist im Bundle als Entscheidung dieses Repos ausgewiesen, nicht als Aussage des Materials.

Kein Upstream-Zwirn-ADR. Dieses Produkt löst (noch) keine globale Regeländerung aus: es benutzt GG-META-0002/-0005, es ändert sie nicht. Sollte sich beim Bauen herausstellen, dass eine der Guidelines angepasst gehört, entsteht daraus ein Zwirn-ADR mit Herkunft: tuxametrics ADR-NNNN (siehe GOVERNANCE.md) — nicht eine Kopie der Regel in diesem Repo.

Konsequenzen

• + Der Umfang ist begründet und rückverfolgbar statt verhandelt: jede Auslassung hat eine offene Frage als Adresse, keine Meinung.
• + Der Prototyp kann die Frage beantworten, für die er gebaut ist (ist der Ablauf richtig geschnitten?), und behauptet nichts darüber hinaus.
• − Ohne E2 fehlt genau der Teil, den das Material als fachliches Alleinstellungsmerkmal bezeichnet. Eine Demo dieses Prototyps zeigt einen korrekten, aber nicht den distinktiven Teil des Produkts. Wer das nicht dazusagt, führt in die Irre — deshalb steht es im README, im Systemsteckbrief-Endpunkt und im Berichtsabschnitt.
• − Ein Kürzel für acht Domänen heißt: wächst das Produkt in Richtung getrennter Services, wird aus txm entweder ein Präfix mit Suffixen oder eine Migration der Business Keys. Der Zeitpunkt dafür ist die erste echte Trennung von Datenhoheit, nicht früher.
• − Die fachliche Quelle liegt in einem anderen Repo. Wer nur dieses Repo hat, kann keine Fundstelle nachschlagen. Abgemildert dadurch, dass jede Zahl im Code ihre FACH-Nummer und Zeilenangabe im Kommentar trägt.