EA-CRR-001

Repositoryübergreifendes Referenzmodell#

Zweck#

Dieses Modell definiert repositoryqualifizierte Referenzen als stabile, paketunabhängige Beziehungen zwischen eigenständig ausgelieferten Repositorys.

Kanonische Syntax#

<repository-id>:<repository-relativer-pfad>

Beispiel:

enterprise-architecture:00-overview/cross-repository-responsibility-model.md

Syntaxregeln#

• repository-id entspricht exakt der maschinenlesbaren Repository-Identität des Zielrepositorys.
• Der Pfad ist relativ zum Root des Zielrepositorys.
• Absolute Pfade, .., Backslashes, leere Pfade und URL-Schemata sind unzulässig.
• Die Referenz adressiert eine konkrete Datei, keinen bloßen Verzeichnisnamen.
• Dateinamen und Groß-/Kleinschreibung müssen dem Zielartefakt entsprechen.

Referenzarten#

Maschinenlesbare Deklarationen verwenden eine der folgenden Rollen:

• canonical-source: führende semantische Quelle,
• specialization: solution- oder produktspezifische Spezialisierung,
• realization: technische Realisierung eines übergeordneten Vertrags,
• ⌘materializationEine Materialisierung ist die technisch erzeugte und persistierte Darstellung einer Projektion.: installierte oder erzeugte Materialisierung,
• validation: ausführbarer oder dokumentierter Validierungsvertrag,
• [[ART-DEF-0043|evidence]]: Nachweis zu einer Realisierung oder Materialisierung.

Kanonisch versus materialisiert#

Eine Referenz mit Rolle materialization oder ⌘evidenceTechnical documentation artifact. überträgt keine semantische Ownership. Materialisierte Snapshots dürfen auf ihre Quelle zurückverweisen, werden dadurch aber nicht selbst zur führenden Quelle.

Maschinenlesbare Deklaration#

Repositorys deklarieren externe Referenzen im Root-◆manifest.json unter crossRepositoryReferences:

[
                  {
                    "reference": "enterprise-architecture:00-overview/cross-repository-responsibility-model.md",
                    "role": "canonical-source",
                    "required": true
                  }
                ]

Realisierungskette#

Eine prüfbare Kette verwendet die Rollen in dieser Richtung:

canonical-source
                → specialization
                → realization
                → materialization
                → evidence

Nicht jede Kette benötigt jede Zwischenstufe. Jede vorhandene Stufe muss jedoch auf ein existierendes Zielartefakt zeigen und ihre Rolle korrekt benennen.

Validierungsverantwortung#

• enterprise-architecture besitzt Syntax, Semantik und Rollenmodell.
• engineering-tools besitzt den ausführbaren Validator.
• engineering-platform bindet die Validation in Produkt-, Build- oder Pipeline-Abläufe ein.
• Jedes Repository besitzt die Richtigkeit seiner eigenen Referenzdeklarationen.
• runtime bewahrt Quellrevision und Evidence, ohne semantische Ownership zu übernehmen.