173 lines
28 KiB
Python
173 lines
28 KiB
Python
"""Only the three requested documentation corrections; no product access or execution."""
|
||
from pathlib import Path
|
||
import hashlib,json,re,difflib
|
||
|
||
O=Path(__file__).resolve().parents[1]
|
||
S=Path('C:/Dev/jinkendo-phase3-2-technical-reference-architecture-v0.2-2026-10-16')
|
||
N=['A_Jinkendo_Technical_Reference_Architecture','B_Implementation_Blueprint_Application_Foundation','C_Technical_Decisions_Open_Issues']
|
||
before={str(p):hashlib.sha256(p.read_bytes()).hexdigest() for p in S.rglob('*') if p.is_file()}
|
||
original={n:(S/(n+'_V2.md')).read_text(encoding='utf-8') for n in N}
|
||
def rep(t,a,b):
|
||
assert a in t,a[:120]
|
||
return t.replace(a,b,1)
|
||
def prep(n):return original[n].replace('· v0.2 ·','· v0.3 ·',1).replace(S.as_posix(),O.as_posix())
|
||
|
||
a=prep(N[0])
|
||
a=rep(a,'einem Gitea-Ablauf, der geprüfte Build-Artefakte bis zur Produktion erhält.','einem Gitea-Ablauf mit verpflichtenden Release-Gates und nachvollziehbarer Zuordnung von Quellstand, Build und getesteter Produktionsversion.')
|
||
anchor='## A1 – Technologiestack und zulässige Varianten'
|
||
a=rep(a,anchor,'''## A0 – Verbindliche Verträge, technische Defaults und Nachweis
|
||
|
||
Die Zielarchitektur in A und ihre Ausgestaltung in B sind ein **vorgeschlagener technischer Standard**. Die bereits beschlossenen Architekturverträge gelten unabhängig davon; technische Detailvorschläge werden durch dieses Dokument nicht automatisch zu weiteren beschlossenen Familienverträgen.
|
||
|
||
| Einordnung | Geltung in dieser Referenz |
|
||
|---|---|
|
||
| **Verbindliche Architekturverträge** | Verifizierte Identität und Datenraumgrenzen; Fail-Closed-Autorisierung neuer geschützter Funktionen; wirksame Objekt-/Scopeprüfung; sichere atomare Transaktionsgrenzen; verlässlicher Migrations-/Erfolgsnachweis; Secret-/Privacy-Grenzen; verpflichtende Release-Gates und eindeutige Zuordnung zur produktiven Version. Maßgeblich bleiben die beschlossenen ADRs und produktbezogenen Schutzgrenzen. |
|
||
| **Technische Defaults** | Bevorzugte Framework-/Versionslinien in A1, Verzeichnis- und Dateidetails in A2/B1, konkrete Modul-/Hilfsnamen, numerische Listenlimits in A4, Poolgrößen und Zeitbudgets in A5, Clienttimeout in A7/B3 sowie Artefakttransport und bevorzugtes Build-Verfahren in A9/B5. Sie sind begründet anpassbare Ausgangspunkte. |
|
||
|
||
Bei begründetem Produktbedarf dürfen Defaults angepasst werden. Grund, gewählter Wert bzw. Ersatz und geeigneter Funktions-/Kompatibilitätsnachweis werden kurz im Produktauftrag oder in der Produktkonfiguration festgehalten; dafür wird kein neuer ADR oder zusätzlicher Freigabezyklus verlangt. Begründete Varianten dürfen keinen verbindlichen Schutz-, Transaktions- oder Releasevertrag abschwächen. Anpassbare Verzeichnisnamen ändern beispielsweise nicht die Verantwortungsgrenzen; anpassbare Timeouts beseitigen keine wirksamen Ressourcenlimits. Die gewählten Versionen müssen weiterhin unterstützt und untereinander kompatibel sein. Nach außen veröffentlichte API-Verträge bleiben gegenüber ihren Clients kompatibel, auch wenn interne Details angepasst werden.
|
||
|
||
Für die folgenden Abschnitte gilt diese Nachweiskennzeichnung:
|
||
|
||
| Nachweisgrad | Bedeutung / aktueller Stand |
|
||
|---|---|
|
||
| **V – Vorgeschlagener technischer Standard** | Zielentscheidungen und Implementierungsvorgaben in A/B; technisch konkret, noch keine ausgeführte Referenzimplementierung. |
|
||
| **I – Bereits vorhandene Implementierungsreferenz** | Benannte Produktdateien und Mechanismen aus v0.2; statisch untersuchte Vorbilder. Vorhandener Code oder eine Testdatei allein ist kein erfolgreicher Testnachweis. |
|
||
| **T – Tatsächlich durch Tests validierte Lösung** | Nur mit konkretem Testumfang, bestandenem Ergebnis, Quell-/Buildstand und Ausführungsumgebung. Für die hier vorgeschlagene Foundation wird kein solcher Gesamtnachweis behauptet; v0.3 führt keine Tests aus. |
|
||
| **K – Noch nicht integrierte oder getestete Kombination** | Die produktübergreifende Foundation-Synthese, Adapterkombinationen und kleinen Codebeispiele. Zusammenwirken und Versionskompatibilität müssen bei der Umsetzung erst validiert werden. |
|
||
|
||
Eine Passage kann V und K zugleich sein; ein I-Verweis hebt sie nicht automatisch auf T. B beschreibt einen künftigen Aufbau und dessen Abnahmebedingungen, keine bereits produktionsreife Referenzimplementierung. Die Versions-/Supportangaben aus A1 werden als bisheriger Dokumentstand übernommen, in v0.3 nicht erneut recherchiert.
|
||
|
||
'''+anchor)
|
||
a=rep(a,'| Bestandteil | Bevorzugte Basis für eine neue App | Verwendung |','| Bestandteil | Technischer Default für eine neue App | Verwendung |')
|
||
a=rep(a,'Eine Anwendung bleibt ein Repository mit Backend, Frontend, Migrationen, Tests und Deploymentdefinitionen.', '**Technischer Strukturdefault:** Eine Anwendung bleibt ein Repository mit Backend, Frontend, Migrationen, Tests und Deploymentdefinitionen. Verzeichnisdetails und Zuschnitt dürfen gemäß A0 angepasst werden; die Verantwortungs- und Schutzgrenzen bleiben erhalten.')
|
||
a=rep(a,'| Listen | `limit` Standard 50, Maximum 200; opaker validierter Cursor; stabile Sortierung mit ID als Tiebreaker |','| Listen | Numerische Defaults: `limit` 50, Maximum 200; begründet anpassbar. Begrenzte Abfragen, validierter Cursor und stabile Sortierung mit ID als Tiebreaker bleiben der Vertrag. |')
|
||
a=rep(a,'Ausgangswerte: ein Prozess, Pool 1–5, Wartezeit 3 Sekunden, höchstens 20 Wartende.', '**Anpassbare technische Defaults:** ein Prozess, Pool 1–5, Wartezeit 3 Sekunden, höchstens 20 Wartende.')
|
||
a=rep(a,'nach höchstens 60 Sekunden Wartezeit bricht er ab.', 'nach einem begrenzten Wartebudget bricht er ab (technischer Default: 60 Sekunden).')
|
||
a=rep(a,'Standard: relative Same-Origin-URLs, Cookie-Credentials, 15 Sekunden Timeout, AbortSignal, Prüfung von Content-Type/Status und Unterstützung von 204.', 'Transportdefault: relative Same-Origin-URLs und 15 Sekunden Timeout; begründete Anpassungen folgen A0. Cookie-Credentials, AbortSignal, Prüfung von Content-Type/Status und Unterstützung von 204 gehören zum beschriebenen Transportvertrag.')
|
||
old='''Der Releaseweg bleibt `develop → Dev → Tests → bewusste Freigabe → main → Prod`. Testresultate und unveränderliche Images werden an Source-Commit, Source-Tree und Buildrevision gebunden. Merge-Commits dürfen eine andere SHA haben; ihr Tree muss exakt dem qualifizierten Tree entsprechen. Produktion bekommt die qualifizierten Images ohne Neubuild. Nachgelagerter Health-Smoke bleibt erhalten, ersetzt das Test-Gate aber nicht.
|
||
|
||
Bevorzugt werden Docker-Image-Archive mit SHA-256 und Release-Manifest über die vorhandene Artefaktablage. Eine bereits verfügbare Gitea-OCI-Registry ist eine gleichwertige Transportvariante mit Digestbindung. Keine neue Registry-Infrastruktur wird vorausgesetzt. Die Freigabe erfolgt über geschützten `main` und bewusst angenommenen Release-PR, nicht über ein vermeintliches GitHub-Environment-Gate: Gitea ignoriert `jobs.<job_id>.environment`. [Gitea-Kompatibilität](https://docs.gitea.com/usage/actions/comparison/)'''
|
||
new='''**Verbindlicher Releasevertrag gemäß ADR-11:** Der Weg bleibt `develop → Dev → Tests → bewusste Freigabe → main → Prod`. Pflicht-Gates müssen vor der Produktionsumschaltung bestanden sein. Quellstand, Build-Eingaben, Testläufe und tatsächlich eingesetzte Artefakte müssen eindeutig zusammengehören. Ein nachgelagerter Health-Smoke ersetzt das Release-Gate nicht. Die bewusste menschliche Produktionsfreigabe bleibt erhalten.
|
||
|
||
| Technische Variante | Umsetzung / Nachweis |
|
||
|---|---|
|
||
| **R1 – Bevorzugter Default: Build once, deploy many** | Die in Dev qualifizierten Backend-/Frontend-Artefakte werden unverändert nach Prod übernommen. Hashes/Digests und Buildrevision binden Test und Deployment; kein weiterer Build ist für diese Variante nötig. |
|
||
| **R2 – Zulässige ADR-11-Variante: kontrollierte separate Builds** | Dev- und Prod-Artefakte dürfen getrennt aus nachvollziehbaren Quellständen und reproduzierbar festgehaltenen Build-Eingaben entstehen. Lockfiles, Build-Rezept, Toolchain/Basisimages und erlaubte öffentliche Build-Parameter werden dokumentiert. Der konkrete Prod-Build erhält vor der Umschaltung seine erforderlichen Tests/Gates und eine eigene Artefakt-/Buildkennung. Ein grüner Dev-Build allein qualifiziert kein neu gebautes Prod-Artefakt. Unterschiedliche Artefakthashes zwischen Dev und Prod sind dabei zulässig. |
|
||
|
||
In beiden Varianten verknüpft der Releasenachweis getesteten Quell-/Buildstand, menschlich freigegebenen main-Stand und tatsächlich deployte Artefakte. Bei Merge-Commits wird die Beziehung über Commit und Source-Tree nachgewiesen. Der Default ist ein mit dem qualifizierten Stand identischer Tree; abweichender Produktionsquellstand oder abweichende Build-Eingaben benötigen die passenden dokumentierten Gate-Ergebnisse für den konkreten Kandidaten, keine ungeprüfte Gleichsetzung mit dem Dev-Lauf. Reproduzierbarkeit ersetzt diese Tests nicht.
|
||
|
||
Default für den Artefakttransport sind Docker-Image-Archive mit SHA-256 und Release-Manifest über die vorhandene Ablage; eine vorhandene Gitea-OCI-Registry mit Digestbindung ist ebenfalls zulässig. Keine Variante verlangt neue CI/CD-Infrastruktur. Die Freigabe erfolgt über geschützten `main` und bewusst angenommenen Release-PR, nicht über ein vermeintliches GitHub-Environment-Gate: Gitea ignoriert `jobs.<job_id>.environment`. [Gitea-Kompatibilität](https://docs.gitea.com/usage/actions/comparison/)'''
|
||
a=rep(a,old,new)
|
||
a=rep(a,'Die verbindlichen Mindestfälle, Testbefehle und der genaue Ablauf stehen in B4/B5.', 'Die erforderlichen Mindestnachweise und ihre technischen Umsetzungsvorschläge (Befehle und Abläufe) stehen in B4/B5; konkrete Pfade und Befehle dürfen im Rahmen von A0 konsistent angepasst werden.')
|
||
a=rep(a,'Die Referenzkombination, Versionskompatibilität und kleinen Beispiele wurden nicht als Anwendung ausgeführt.', 'Nach A0 sind die Zielangaben V, die benannten Produktmechanismen I und die Foundation-Synthese samt Beispielen K. Ein T-Gesamtnachweis liegt nicht vor: Referenzkombination, Versionskompatibilität und Beispiele wurden nicht als Anwendung ausgeführt. Auch die neuen Release-Varianten sind dokumentierte Vorgaben, keine in diesem Auftrag getesteten Pipelines.')
|
||
|
||
b=prep(N[1])
|
||
b=rep(b,'· unmittelbar nutzbare Implementierungsvorlage**','· vorgeschlagener Blueprint, keine ausgeführte Referenzimplementierung**')
|
||
anchor='## B1 – Auftrag und Zielstruktur'
|
||
b=rep(b,anchor,'''**Geltung und Nachweis:** Dieser Blueprint ist V und als kombinierte Lösung K gemäß A0. Benannte Produktdateien sind I; geforderte Mindesttests sind noch keine T-Ergebnisse. Weder die Beispielausschnitte noch die gesamte Foundation sind hier integriert, getestet oder als produktionsreif nachgewiesen. Die tatsächliche Implementierung muss die erforderlichen Nachweise erst erbringen.
|
||
|
||
**Verträge und Defaults:** Verbindlich bleiben insbesondere Datenraum-/Privacy-Grenzen, Fail-Closed-Zugriff, sichere Transaktionen und Release-Gates. Verzeichnisdetails, Modulnamen, Framework-/Versionslinien und numerische Einstellungen sind technische Defaults gemäß A0. Begründete Anpassungen sind im Produktauftrag bzw. in dessen Konfiguration kurz festzuhalten; keine zusätzliche Freigabeschleife. Die Aussage „gemäß A“ meint diese Unterscheidung, keinen starren Zwang zu jedem Beispielwert.
|
||
|
||
'''+anchor)
|
||
b=rep(b,'Erstelle im ausdrücklich benannten neuen Produkt-Repository die folgende Foundation. Verwende die Versionslinien aus A1, löse stabile Patchstände auf und committe Lockfiles.', 'Erstelle im ausdrücklich benannten neuen Produkt-Repository eine Foundation nach den Verträgen dieses Blueprints. Nutze den folgenden Verzeichnisbaum und die Versionslinien aus A1 als technische Defaults; begründete Anpassungen folgen A0. Löse stabile kompatible Patchstände auf und committe Lockfiles.')
|
||
b=rep(b,'Python läuft mit `backend` als Working Directory, Imports beginnen mit `app.`.', 'Im dargestellten Strukturdefault läuft Python mit `backend` als Working Directory, Imports beginnen mit `app.`. Bei anderer begründeter Verzeichnisstruktur werden Importpfade und Befehle konsistent angepasst; keine impliziten Importnebenwirkungen.')
|
||
b=rep(b,'Illustration des DB-Adapters; Pool-Konfiguration und Fehlerübersetzung kommen aus A5/A4:', 'Nicht integrierte und nicht ausgeführte Illustration (K) des DB-Adapters; Pool-Konfiguration und Fehlerübersetzung kommen aus A5/A4. `timeout=3` ist ein technischer Default, keine unveränderliche Architekturgrenze:')
|
||
b=rep(b,'| Pool-/SQL-Zeitbudgets | Typisiert und begrenzt entsprechend A5; keine negativen/ungeprüften Zahlen |','| Pool-/SQL-Zeitbudgets | Numerische Defaults aus A5 begründet anpassbar; typisierte Validierung und wirksame Grenzen bleiben erforderlich. |')
|
||
b=rep(b,'Der Transportvertrag lautet:', 'Der vorgeschlagene Transportvertrag (V) wird durch folgenden nicht ausgeführten Ausschnitt (K) illustriert; `timeoutMs: 15000` ist ein anpassbarer technischer Default:')
|
||
b=rep(b,'Der Frontend-Build enthält keine Dev-/Prod-Origins oder privaten VITE-Variablen. API-Pfade bleiben Same-Origin, damit exakt dasselbe Frontend-Image in Dev und Prod nutzbar ist.', 'Bevorzugter Frontend-Default sind relative Same-Origin-API-Pfade ohne Dev-/Prod-Origins im Build; damit kann R1 dasselbe Frontend-Image verwenden. R2 darf nachvollziehbar deklarierte öffentliche Build-Parameter unterscheiden und muss den konkreten Prod-Build validieren. Secrets und private VITE-Variablen bleiben in beiden Varianten ausgeschlossen.')
|
||
b=rep(b,'| Release | Rotes Pflicht-Gate, fehlende DB-Suite, falsche Tree-SHA, verändertes Image-Archiv oder falsche Buildrevision verhindern Promotion |','| Release | In R1 und R2 sperren rote/fehlende Pflicht-Gates und nicht passende Quell-/Build-/Artefaktnachweise das Deployment. R1 prüft identische qualifizierte Artefakte; R2 prüft auch den separaten Prod-Kandidaten vor der Umschaltung. |')
|
||
start=b.index('## B5 – Gitea-Ablauf und Build-Nachvollziehbarkeit')
|
||
end=b.index('## B6 – Erweiterung und Fertigstellung')
|
||
b5='''## B5 – Gitea-Ablauf und Build-Nachvollziehbarkeit
|
||
|
||
**Verbindlich:** `develop → Dev → Tests → bewusste Freigabe → main → Prod`, erforderliche Release-Gates, menschliche Freigabe und eindeutige Versions-/Artefaktzuordnung. **Technische Varianten:** R1 „Build once, deploy many“ ist der bevorzugte Default; R2 sind nach ADR-11 weiterhin zulässige kontrollierte, reproduzierbare getrennte Dev-/Prod-Builds. Beides sind noch nicht ausgeführte Verfahrensvorgaben (V/K), keine hier validierten Pipelines.
|
||
|
||
Die bestehenden Gitea-Prozesse werden entsprechend genutzt. Zwei logische Aufgaben – Dev-Qualifikation und Produktionsfreigabe/-deployment – können in den vorhandenen Workflows abgebildet werden; Dateinamen und Jobaufteilung sind Defaults, keine neue Infrastrukturvorgabe. Nicht vertrauenswürdige PR-Checks erhalten weder Deploy-/Prod-Secrets noch Zugriff auf produktive Docker-Sockets. Deploy-Jobs laufen nur für geschützte eigene Branches auf berechtigten Runnern. Actions werden auf geprüfte Commitstände gepinnt und müssen zur eingesetzten Gitea-/Runner-Version passen. Siehe C, O2.
|
||
|
||
| Stufe | R1 – bevorzugt: identische Artefakte | R2 – zulässig: separate Builds |
|
||
|---|---|---|
|
||
| 1 · develop | Quellcommit S/Tree T, Lockfiles und Build-Eingaben festhalten; schnelle Tests und Import-/OpenAPI-Prüfung. | Derselbe Dev-Vertrag; Dev-Build-Rezept und Parameter eindeutig aufzeichnen. |
|
||
| 2 · Dev | Backend-/Frontend-Artefakte bauen und identifizieren, explizite Dev-Migration und Dev-Deployment; Read-only-Smoke. | Identifizierte Dev-Artefakte bauen und nach Dev deployen; Migration und Read-only-Smoke wie R1. |
|
||
| 3 · Tests | Die gebauten Artefakte im isolierten Stack mit Pflichtsuiten aus B4 und Browserfällen qualifizieren. | Die Dev-Artefakte mit den erforderlichen Suiten qualifizieren. Das Ergebnis gilt für diesen Dev-Build, nicht automatisch für einen späteren Prod-Build. |
|
||
| 4 · Bewusste Freigabe | Mensch nimmt den Release-PR nach erfolgreicher Dev-Qualifikation auf geschütztes `main` an. | Dieselbe menschliche Freigabe; freigegebener Quellstand und deklarierte Produktions-Build-Eingaben bleiben nachvollziehbar. |
|
||
| 5 · Prod-Kandidat / Gate | Qualifizierte Artefakte aus dem passenden vertrauenswürdigen Run übernehmen, Hashes und Quellbeziehung prüfen. Default: S ist in main enthalten und `tree(main) == T`. | Aus dem freigegebenen Stand mit gelockten Abhängigkeiten, festgehaltenem Build-Rezept, Toolchain/Basisimages und deklarierten Parametern reproduzierbar separat bauen. Den konkreten Prod-Kandidaten im isolierten Stack vor Deployment durch seine Pflicht-Gates führen; eigener Validierungsrun und eigene Artefaktkennungen. |
|
||
| 6 · Prod | Erst bei vollständigem Nachweis: Deployment serialisieren, Schema-/Backupbedingung prüfen, explizite Prod-Migration, qualifizierte Artefakte umschalten. | Erst nach erfolgreichen Gates für den separaten Prod-Build dieselben Betriebsbedingungen prüfen und genau diesen Prod-Kandidaten umschalten. Keine ungetestete zusätzliche Änderung oder weiterer ungeprüfter Build. |
|
||
| 7 · Smoke | Read-only-Smoke und eingesetzte Build-/Artefaktkennung protokollieren. | Identische Nachweispflicht für die tatsächlich eingesetzte Prod-Version. |
|
||
|
||
Ein rotes, fehlendes oder übersprungenes Pflicht-Gate stoppt beide Varianten. `main` enthält den bewusst freigegebenen Stand; eine Abweichung vom Dev-Tree darf nicht unter dessen grünem Ergebnis als mitgetestet gelten. Sie benötigt die zugehörigen Tests und Nachweise für den tatsächlich freigegebenen Produktionsquellstand. Änderungen außerhalb dieser menschlich freigegebenen Eingaben sind kein bereits genehmigter Release. Ein weiterer menschlicher Freigabezyklus nur wegen der Wahl von R2 wird nicht eingeführt.
|
||
|
||
Der Produktionstest läuft isoliert gegen den konkreten Prod-Kandidaten, niemals mit synthetischen Mutationen in einer Kundendatenbank. Weder Reproduzierbarkeit noch ein Health-Smoke nach Deployment ersetzen dieses Gate. Runtime-/Build-Eingaben werden kontrolliert aufgelöst; spontane Paketupdates oder nicht dokumentierte Build-Änderungen sind in keiner Variante erlaubt. Ein kontrollierter Prod-Build in R2 ist ausdrücklich zulässig.
|
||
|
||
**Releasenachweis für beide Varianten:** getesteter Quell-/Buildstand, freigegebener main-Stand und tatsächlich deployte Artefakte werden verknüpft. Das nachstehende Manifest ist das bevorzugte technische Format; gleichwertige vorhandene Gitea-Nachweise dürfen es abbilden. Verbindlich ist die vollständige Zuordnung, nicht ein bestimmter JSON-Feldname oder zusätzlicher Dienst.
|
||
|
||
```text
|
||
product_id, build_variant (R1/R2), approved_main_commit,
|
||
dev_source_commit/tree, dev_build_id, dev_qualification_run_id,
|
||
prod_source_commit/tree, prod_build_id, prod_validation_run_id,
|
||
backend/frontend_artifact_ids und Hashes/Digests je Build,
|
||
Lockfilehashes, Build-Rezept/Toolchain/Basisimages und öffentliche Build-Parameter,
|
||
migrations_digest, expected_schema_head,
|
||
gate_results je qualifiziertem Build mit Ausführungs-/Skipnachweisen,
|
||
deployed_build_id und tatsächlich eingesetzte Artefakthashes,
|
||
qualified_rollback_images
|
||
```
|
||
|
||
In R1 dürfen Dev- und Prod-Build-/Validierungsreferenzen auf denselben qualifizierten Build verweisen. In R2 sind die getrennten Builds und ihre Ergebnisse explizit zugeordnet; unterschiedliche Hashes sind kein Fehler, wenn gerade das eingesetzte Prod-Artefakt qualifiziert ist. Merge-Commits werden über Commit und Source-Tree den Freigaben zugeordnet. Eine inzwischen weitergelaufene Dev-Instanz ersetzt keinen dieser Nachweise.
|
||
|
||
Production vertraut den Nachweisen der passenden geschützten Workflow-Runs, nicht einem beliebig hochgeladenen JSON oder bewegbaren `latest`-Tag. Artefakte bleiben mindestens über das vereinbarte Rollbackfenster nachvollziehbar verfügbar. Archive mit SHA-256 und eine bereits vorhandene OCI-Registry mit Digestbindung sind Transportvarianten; keine neue CI/CD-Infrastruktur wird verlangt.
|
||
|
||
Gitea `environment: production` zählt nicht als manuelle Freigabe. Workflowübergreifende Reihenfolge und Deploymentserialisierung werden ausdrücklich hergestellt. Ein produkt-/umgebungsspezifischer Hostlock ist ein technischer Default bei Jobs auf demselben Deploy-Host, keine Pflicht zu genau diesem Mechanismus. Fehler geben die gewählte Sperre und temporäre Teststacks zuverlässig frei.
|
||
|
||
Rollback verwendet ein auf dem aktuellen Schema qualifiziertes voriges Artefaktpaar. Migrationen laufen nicht automatisch rückwärts. Ohne erforderliche Kompatibilität stoppt das Release vor der Migration; nach unerwarteten Fehlern gelten kontrollierter Forward-Fix oder vorbereiteter Restore. Die Backup-/Recoverybedingungen des Produktprofils bleiben für beide Build-Varianten unverändert.
|
||
|
||
'''
|
||
b=b[:start]+b5+b[end:]
|
||
b=rep(b,'neu aufgelöste Pakete im Release, rebuild in Prod,', 'ungeplant neu aufgelöste Pakete im Release, ungeprüfter Prod-Neubuild,')
|
||
b=rep(b,'Die Foundation ist implementiert, wenn Struktur und Verträge stehen, die Pflichtfälle ihrer tatsächlich registrierten Funktionen laufen, Lockfiles und OpenAPI vorliegen und der Releaseweg reproduzierbar sperren kann.', 'Abnahmebedingungen für eine künftige Foundation-Implementierung sind: Struktur und Verträge umgesetzt, Pflichtfälle der tatsächlich registrierten Funktionen nachweislich bestanden, Lockfiles/OpenAPI vorhanden und wirksame Release-Sperren belegt. Diese Bedingungen sind hier Vorgaben, kein Bericht bereits bestandener Tests. Auch ihre spätere Erfüllung ersetzt keine produktbezogene Produktionsreifeprüfung.')
|
||
|
||
c=prep(N[2])
|
||
c=rep(c,'Neu zusammengeführt werden eine modulare Struktur, explizite Transaktionen, ein einheitlicher HTTP-Vertrag und eine nachweisbare Promotion geprüfter Images.', 'Neu zusammengeführt werden eine modulare Struktur, explizite Transaktionen, ein einheitlicher HTTP-Vertrag und ein Release-Verfahren mit verpflichtenden Gates und nachvollziehbarer Quell-/Build-/Artefaktzuordnung.')
|
||
anchor='## Überprüfung der bisherigen Gewichtung'
|
||
c=rep(c,anchor,'''## Gezielte Korrekturen in v0.3
|
||
|
||
1. **ADR-11 / Release:** R1 „Build once, deploy many“ bleibt bevorzugter technischer Default. R2 – kontrollierte, reproduzierbare getrennte Dev-/Prod-Builds – bleibt zulässig. Beide benötigen Pflicht-Gates vor Prod, menschliche Freigabe und eindeutige Zuordnung der tatsächlich eingesetzten Version. Bei R2 wird der konkrete Prod-Kandidat zusätzlich qualifiziert. Branchstrategie und bestehende Infrastruktur bleiben erhalten.
|
||
2. **Nachweis:** A/B sind V (vorgeschlagener technischer Standard) und als Kombination K (noch nicht integriert/getestet). Produkt-Codeverweise sind I (vorhandene Implementierungsreferenz). T setzt bestandene Tests mit Umfang, Stand und Umgebung voraus; für die Foundation wird kein T-Gesamtnachweis oder Produktionsreife behauptet. Die früher benannten Testquellen werden dadurch nicht zu Testergebnissen.
|
||
3. **Verträge / Defaults:** A0 unterscheidet verbindliche Schutz-, Datenraum-, Transaktions- und Releaseverträge von anpassbaren technischen Defaults wie Poolgröße, Timeout, Verzeichnisdetail und Framework-Version. Begründete Anpassung im Produktauftrag bzw. in der Konfiguration genügt; keine neuen ADRs oder Freigabeschleifen.
|
||
|
||
Die bereichsspezifische Referenzauswahl und die bisherigen drei offenen Produkt-/Betriebspunkte bleiben unverändert. Die nachstehende Einordnung wird aus v0.2 übernommen; v0.3 führt keine erneute Produktreifebewertung oder Konsolidierung durch.
|
||
|
||
'''+anchor)
|
||
c=rep(c,'## Technische Empfehlungen und wichtigste Alternativen','## Technische Empfehlungen und wichtigste Alternativen\n\nNachweisstatus: Die bevorzugten Zielausgestaltungen sind V, ihre noch nicht ausgeführte Kombination K; die Herkunftsspalte nennt bestehende Referenzen I. Keine Zeile wird hier als durch Tests validierte Foundation-Lösung T ausgewiesen. Die Geltung verbindlicher Verträge gegenüber technischen Defaults folgt A0.')
|
||
c=rep(c,'ein Composition Root. Vorhanden, einfach zu erweitern, kein neuer Betrieb.', 'ein Composition Root. Aus vorhandenen Teilmechanismen abgeleiteter Zielentwurf, noch keine validierte Gesamtimplementierung; kein neuer Betrieb.')
|
||
c=rep(c,'| TF-08 · Deployment | Bestehende Branchfolge; einmal gebaute qualifizierte Images, Tree-/Commit-/Hash-Nachweis, menschlich angenommener Release-PR auf geschütztes main. | Nur Tests nach Prod reichen nicht. Bestehender OCI-Transport ist erlaubt; keine neue Registry erforderlich. GitHub-Environment-Approval wird nicht vorausgesetzt. |', '| TF-08 · Deployment | Verbindlich: bestehende Branchfolge, menschliche Freigabe, Release-Gates und Quell-/Build-/Artefaktzuordnung. Default R1: identische qualifizierte Images übernehmen. | ADR-11-Variante R2: kontrollierte reproduzierbare separate Builds mit Pflicht-Gates für den konkreten Prod-Build vor Deployment. Keine neue Infrastruktur; Tests nur nach Prod reichen nicht. |')
|
||
c=rep(c,'Release-PR, Manifestprüfung und gleiche Images sind festgelegt.', 'Menschliche Freigabe, Release-Gates und eindeutige Versionszuordnung sind festgelegt; gleiche Images sind Default R1, getrennte qualifizierte Builds zulässige Variante R2.')
|
||
c=rep(c,'Die Versions-/Supportquellen stehen in A1.', 'Die Versions-/Supportquellen und ihre Einordnung als technische Defaults stehen in A1/A0; v0.3 nimmt keine neue Versionsrecherche vor.')
|
||
old=c[c.index('Die ursprüngliche Fassung erfasste 103 gezielte Eingaben.'):]
|
||
c=rep(c,old,'''Die ursprüngliche Fassung erfasste 103 gezielte Eingaben; der Ergänzungsreview in v0.2 dokumentierte die Referenzgewichtung. Diese historischen Quellprüfungen werden in v0.3 nicht wiederholt. Für v0.3 wurden ausschließlich die drei v0.2-Dokumente an den beauftragten Punkten geändert und auf Konsistenz geprüft. v0.2 bleibt unverändert. Es wurden weder Produkt-Repositories geändert noch Code, Produkttests, Paketinstallationen, Laufzeitprüfungen, Migrationen, Deployments oder Gitea-Änderungen ausgeführt. Die Beispiele und Zielkombinationen bleiben K; Dokumentationsprüfungen sind keine T-Validierung der Foundation.
|
||
''')
|
||
|
||
for n,t in zip(N,[a,b,c]):(O/(n+'.md')).write_text(t,encoding='utf-8')
|
||
|
||
# Exact v0.2 preservation and narrow scope verification; never open product source.
|
||
after={str(p):hashlib.sha256(p.read_bytes()).hexdigest() for p in S.rglob('*') if p.is_file()}
|
||
assert before==after,'v0.2 changed'
|
||
docs={n:(O/(n+'.md')).read_text(encoding='utf-8') for n in N}
|
||
# Existing reference selection, open questions and examples are preserved; only the requested classifications/release text differ.
|
||
def section(t,start,end):return t.split(start,1)[1].split(end,1)[0]
|
||
assert section(original[N[2]],'## Überprüfung der bisherigen Gewichtung','## Technische Empfehlungen und wichtigste Alternativen')==section(c,'## Überprüfung der bisherigen Gewichtung','## Technische Empfehlungen und wichtigste Alternativen')
|
||
assert section(original[N[0]],'## A8 – Schnittstellen zu Security, Datenraum, KI und Subscriptions','## A9 – Testing, Deployment und Reuse')==section(a,'## A8 – Schnittstellen zu Security, Datenraum, KI und Subscriptions','## A9 – Testing, Deployment und Reuse')
|
||
for n in N:
|
||
assert re.findall(r'^```python\n(.*?)^```',original[n],re.M|re.S)==re.findall(r'^```python\n(.*?)^```',docs[n],re.M|re.S)
|
||
assert re.findall(r'^```javascript\n(.*?)^```',original[n],re.M|re.S)==re.findall(r'^```javascript\n(.*?)^```',docs[n],re.M|re.S)
|
||
assert '· v0.3 ·' in docs[n]
|
||
assert docs[n].count('\n```')%2==0
|
||
for target in re.findall(r'\]\(([^)]+)\)',docs[n]):
|
||
if target.startswith('https://'):continue
|
||
path=re.sub(r':\d+$','',target)
|
||
if path.startswith(O.as_posix()):assert Path(path).is_file(),target
|
||
diff=''.join(difflib.unified_diff(original[n].splitlines(True),docs[n].splitlines(True),fromfile=n+'_v0.2',tofile=n+'_v0.3'))
|
||
(O/'_support'/(n+'.diff')).write_text(diff,encoding='utf-8')
|
||
result={'version':'v0.3','main_documents':[n+'.md' for n in N],'v02_files_hashed_unchanged':len(before),'v02_sha256':before,'v02_unchanged':True,'reference_weighting_section_unchanged':True,'security_scope_privacy_section_unchanged':True,'python_and_javascript_examples_unchanged':True,'new_product_tests':0,'new_research':False,'correction_scope':['ADR-11 release variants','evidence status','binding contracts vs adaptable defaults']}
|
||
(O/'_support/document_check.json').write_text(json.dumps(result,ensure_ascii=False,indent=2),encoding='utf-8')
|
||
print(json.dumps(result,ensure_ascii=False))
|