REALIZATION-CHAIN-REGISTER
Register repositoryübergreifender Realisierungsketten#
Zweck#
Dieses Register beschreibt nur fachlich bedeutungsvolle, repositoryübergreifende Ketten. Es ersetzt weder lokale Traceability noch allgemeine Markdown-Links.
Eine vollständige Kette führt von einer kanonischen Enterprise-Aussage über Solution-Spezialisierung und Engineering-Realisierung zu einer materialisierten Runtime-Ausführung und ihrer GlossarbegriffTechnical documentation artifact.Glossareintrag vollständig lesen.
Beziehungen#
- ArtifactBuild-VertragsmodellKanonischer repositoryübergreifender Vertrag für nachweisbare Engineering-Builds.Vollständig lesen — uses
- ArtifactDeployment-VertragsmodellKanonisches Modell für koordinierte, verifizierte und rückrollbare Deployment-Transaktionen.Vollständig lesen — uses
- ArtifactArbeitsbereichsvertragsmodellTechnical documentation artifact.Vollständig lesen — uses
Rollenfolge#
canonical-source → specialization → realization → materialization → evidence
Eine Stufe darf mehrere Artefakte besitzen, wenn sie gemeinsam dieselbe Aussage realisieren. Jede Referenz verwendet die kanonische Syntax <repository-id>:<repository-relativer-pfad>.
RC-0001 — Verifizierter Engineering-Roundtrip#
Aussage: Ein Engineering-Roundtrip ist erst erfolgreich, wenn die Änderung materialisiert, gestartet, fachlich beziehungsweise technisch verifiziert und durch referenzierbare Evidence nachgewiesen wurde.
| Rolle | Referenz | GlossarbegriffBedeutung beschreibt den fachlichen Sinn eines Elements und seine Relevanz für Menschen und Organisationen.Glossareintrag vollständig lesen |
|---|---|---|
canonical-source |
enterprise-architecture:85-reference-artifacts/reference-model/execution-evidence-model.md |
universelles Engineering-Execution- und Evidence-Modell |
canonical-source |
enterprise-architecture:96-architecture-decisions/ADR-009-roundtrip-includes-test-deployment-and-evidence.md |
verbindliche Erfolgsentscheidung |
specialization |
solution-architecture:90-deployment/MVP-001-deployment-transaction-contract.md |
solutionweite Deployment-Transaktion |
specialization |
solution-architecture:98-tests/MVP-001-runtime-deployment-verification-matrix.md |
solutionweite Nachweisanforderungen |
realization |
engineering-platform:00-overview/ROUNDTRIP_ARCHITECTURE.md |
produktbezogene Roundtrip-Orchestrierung |
realization |
engineering-platform:96-documentation/ROUNDTRIP_EVIDENCE.md |
produktbezogener Evidence-Vertrag |
realization |
engineering-tools:70-deployment/EP-002-0B-ENGINEERING-ROUNDTRIP.md |
ausführende Deployment- und Verifikationsmechanik |
| GlossarbegriffEine Materialisierung ist die technisch erzeugte und persistierte Darstellung einer Projektion. Beispiele sind JSON, HTML, Markdown, PDF, Suchindex, Diagrammdatei, Runtime-Ressource oder Report. Materialisierungen sind abgeleitet und dürfen fachlich nicht zum Single Point of Truth werden.Glossareintrag vollständig lesen | runtime:test/installations/engineering-platform/deployment.json |
materialisierte Testdeployment-Ausführung |
evidence |
runtime:test/reports/startup/engineering-platform-startup.json |
beobachteter Startup- und Readiness-Nachweis |
Vollständigkeitsregel#
Eine deklarierte Kette ist nur vollständig, wenn:
- jede Pflichtreferenz auflösbar ist,
- jede Rolle der Rollenfolge mindestens einmal vorkommt,
- Materialisierung und Evidence eine konkrete Ausführung adressieren,
- die Evidence keine neue kanonische Bedeutung definiert,
- Abweichungen als GlossarbegriffTechnical documentation artifact.Glossareintrag vollständig lesen dokumentiert werden.
Pflege#
- Enterprise Architecture besitzt dieses Register und die semantische Aussage.
- Jedes Repository besitzt die Richtigkeit seiner lokalen Kettenartefakte und Manifestdeklarationen.
- Engineering Tools validiert Auflösbarkeit und Rollenabdeckung.
- Neue Ketten werden nur aufgenommen, wenn sie fachlich vollständig und praktisch nachweisbar sind.
RC-0002 – Implementation Artifact Manifest Traceability#
Aussage: Ein Implementierungsartefakt-Manifest verbindet universelle Traceability-Regeln mit solutionweiter Zuordnung, konkreter Engineering-Materialisierung, ausführbarer Validation und bewahrter Runtime-Evidence.
| Rolle | Repositoryqualifizierte Referenz |
|---|---|
| canonical-source | enterprise-architecture:85-reference-artifacts/reference-model/artifact-manifest-model.md |
| canonical-source | enterprise-architecture:96-architecture-decisions/ADR-002-implementation-artifact-manifests.md |
| specialization | solution-architecture:95-building-blocks/MVP-001-artifact-manifest-mapping.md |
| specialization | solution-architecture:96-decisions/SADR-002-artifact-manifest-materialization.md |
| realization | engineering-platform:96-documentation/artifact-manifests.md |
| materialization | Code-ArtifactCodeansicht öffnen |
| validation | Code-ArtifactCodeansicht öffnen |
| validation | Code-ArtifactCodeansicht öffnen |
| materialization | runtime:test/installations/engineering-platform/web/src/platform-shell/artifact-manifest.json |
| evidence | runtime:test/reports/validation/artifact-manifests.json |
Die Runtime-Evidence belegt nur eine konkrete Validation der angegebenen Repository-Revisionen. Sie ersetzt weder Modell, Spezialisierung noch Engineering-Vertrag.
RC-0003 – Build Contract Realization#
Aussage: Ein Engineering-Build erzeugt aus eindeutig bestimmten, nicht aus Runtime abgeleiteten Eingaben ein identifizierbares Ergebnis und versiegelte Evidence; Build-Erfolg allein ist weder Deployment noch GlossarbegriffTechnical documentation artifact.Glossareintrag vollständig lesen.
| Rolle | Repositoryqualifizierte Referenz |
|---|---|
| canonical-source | enterprise-architecture:85-reference-artifacts/reference-model/build-contract-model.md |
| specialization | solution-architecture:90-deployment/MVP-001-build-contract.md |
| realization | engineering-platform:00-overview/BUILD_ARCHITECTURE.md |
| realization | engineering-platform:00-overview/BUILD_CONTRACT.md |
| validation | Code-ArtifactCodeansicht öffnen |
| materialization | runtime:test/builds/engineering-platform/build-manifest.json |
| evidence | runtime:test/reports/validation/build-contract.json |
Die Runtime-Dateien sind konkrete Materialisierung und Evidence. Sie definieren den Build-Vertrag nicht neu.
RC-0004 – Deployment Contract Realization#
Aussage: Ein Deployment überführt einen identifizierten Build-Kandidaten als koordinierte, verifizierte und rückrollbare Transaktion in Runtime und erzeugt versiegelte Evidence; Deployment-Erfolg allein ist keine Production-Promotion.
| Rolle | Repositoryqualifizierte Referenz |
|---|---|
| canonical-source | enterprise-architecture:85-reference-artifacts/reference-model/deployment-contract-model.md |
| specialization | solution-architecture:90-deployment/MVP-001-deployment-transaction-contract.md |
| realization | engineering-platform:00-overview/DEPLOYMENT_ARCHITECTURE.md |
| realization | engineering-platform:00-overview/DEPLOYMENT_CONTRACT.md |
| validation | Code-ArtifactCodeansicht öffnen |
| realization | Code-ArtifactCodeansicht öffnen |
| materialization | runtime:test/installations/engineering-platform/deployment.json |
| materialization | runtime:test/installations/engineering-platform/bin/engineering-platform |
| evidence | runtime:test/reports/validation/deployment-contract.json |
Die Runtime-Dateien sind konkrete Materialisierung und Evidence. Sie definieren den Deployment-Vertrag nicht neu.
RC-0005 – Workspace Contract Realization#
Aussage: Ein Workspace bindet identifizierte Eingaben und einen expliziten Schreibscope in einem kontrollierten Arbeitskontext, erzeugt nachvollziehbare Änderungen und Evidence und bleibt von Repository-Ownership, Runtime und Promotion getrennt.
| Rolle | Repositoryqualifizierte Referenz |
|---|---|
| canonical-source | enterprise-architecture:85-reference-artifacts/reference-model/workspace-contract-model.md |
| specialization | solution-architecture:70-data/MVP-001-workspace-contract.md |
| realization | engineering-platform:00-overview/WORKSPACE_CONTRACT.md |
| realization | engineering-platform:96-documentation/WORKSPACE_CONTRACT_EVIDENCE.md |
| validation | Code-ArtifactCodeansicht öffnen |
| materialization | runtime:test/workspaces/KT-0015/workspace-manifest.json |
| evidence | runtime:test/reports/validation/workspace-contract.json |
Runtime dokumentiert nur die konkrete Materialisierung und Evidence; sie definiert den Workspace-Vertrag nicht neu.
RC-0006 – Validation Contract Realization#
Aussage: Validation bewertet einen identifizierten Gegenstand gegen explizite Regeln, führt alle Pflichtprüfungen aus und erzeugt ein eindeutiges, nachvollziehbares Ergebnis mit versiegelter Evidence; Validation ist weder fachliche GlossarbegriffEin Release ist ein bewusst freigegebener und nachvollziehbarer Stand von Artefakten und ihrer Realisierung.Glossareintrag vollständig lesen noch Deployment oder Promotion.
| Rolle | Repositoryqualifizierte Referenz |
|---|---|
| canonical-source | enterprise-architecture:85-reference-artifacts/reference-model/validation-contract-model.md |
| specialization | solution-architecture:98-tests/MVP-001-validation-contract.md |
| realization | engineering-platform:00-overview/VALIDATION_CONTRACT.md |
| realization | engineering-platform:96-documentation/VALIDATION_CONTRACT_EVIDENCE.md |
| validation | Code-ArtifactCodeansicht öffnen |
| validation | engineering-tools:40-validation/VALIDATION_CONTRACT_VALIDATION.md |
| materialization | runtime:test/validations/KT-0016/validation-manifest.json |
| evidence | runtime:test/reports/validation/validation-contract.json |
Runtime dokumentiert ausschließlich die konkrete Ausführung und Evidence.