MVP-001-UNIFIED-ARTIFACT-MODEL-REALIZATION

MVP-001 – Einheitliche Artifact-Model-Realisierung#

Zweck und Einordnung#

Dieses Dokument konsolidiert das Unified ⌘ArtifactEin Artefakt ist jede eindeutig identifizierbare fachliche, technische, organisatorische oder reale Einheit, die in der Engineering-Landschaft modelliert wird. Model als technische Solution-Realisierung für MVP-001. Die universellen Bedeutungen von ⌘MeaningBedeutung beschreibt den fachlichen Sinn eines Elements und seine Relevanz für Menschen und Organisationen., Artifact, ⌘RelationshipEine Beziehung beschreibt eine nachvollziehbare Verbindung zwischen Bedeutungen, Artefakten und ihrem Kontext. und Identity bleiben Eigentum der Enterprise Architecture. Diese Solution definiert ausschließlich, wie diese Bedeutungen im Lösungsraum der Engineering Platform identifiziert, versioniert, lokalisiert, referenziert, persistiert und materialisiert werden.

Führende Modellkette#

Enterprise Artifact / Relationship / Identity
                → sprachunabhängige Solution-Identität
                → unveränderliche Revisionen und Lokalisierungsrevisionen
                → typisierte Beziehungen und Dimensionszuordnungen
                → Persistenz- und Repository-Verträge
                → kontrollierte Manifest-, Markdown-, HTML-, Report- und ZIP-Materialisierung
                → Validation und Evidence

Keine Materialisierung ersetzt die fachliche Identität oder wird zu einer konkurrierenden Wahrheit.

Solutionweite Kernverträge#

Artifact Identity#

Ein Artifact besitzt eine stabile, sprach- und materialisierungsunabhängige ArtifactId. Dateipfad, Dateiname, Sprache, Datenbank-Primärschlüssel und Transportposition sind technische Adressen oder Repräsentationen, aber keine fachliche Identität.

Revision und Provenance#

Fachliche Änderungen erzeugen unveränderliche Revisionen. Jede Revision weist mindestens Artefaktbezug, Vorgängerbezug, Akteur, Zeitpunkt, Änderungsgrund und ⌘HerkunftProvenienz beschreibt die nachvollziehbare Herkunft eines Wissenselements, einer Aussage oder einer abgeleiteten Darstellung. aus. Bestehende Revisionen werden nicht überschrieben.

Lokalisierung#

Sprachvarianten besitzen eigene Lokalisierungsidentitäten und unveränderliche Lokalisierungsrevisionen, bleiben aber demselben sprachunabhängigen Artefakt zugeordnet. Quellsprache, Quellrevision, Übersetzungsherkunft sowie Review- und Freigabestatus bleiben nachvollziehbar.

Relationship#

Eine fachliche Beziehung besitzt eine eigene stabile Identität und Revisionen. Freitextlinks können eine Darstellung oder Navigation bilden, ersetzen aber keine typisierte Relationship, wenn die Beziehung fachlich ausgewertet, validiert oder historisiert werden muss.

Relationship Types materialisieren den Enterprise-Katalog enterprise-architecture:60-metamodel/relationship-type-catalog.md. Solution-Speicherung verwendet die kanonischen Schlüssel; lokalisierte Labels und Legacy-Namensvarianten bleiben Darstellungen. valid_during, precedes und evolves_from werden mit denselben Quell-/Ziel-, Kardinalitäts-, Zyklus-, Lifecycle- und Revisionsregeln wie alle anderen Typen realisiert.

Dimension#

Dimensionen werden nur über definierte ⌘DimensionEine Dimension beschreibt eine Ausprägung eines Artefakts oder eines Attributwerts. Sprache ist keine Sonderbehandlung, sondern eine mögliche Dimension. Definitions, zulässige Werte, Kardinalitäten und Anwendungsbereiche verwendet. Unkontrollierte Key-Value-Erweiterungen bilden keinen gleichwertigen Ersatz.

Manifest und Reference Resolution#

Ein Manifest verbindet stabile fachliche Identitäten mit konkreten Repository- und Transportmaterialisierungen. Reference Resolution folgt dem Vertrag in ◆MVP-001-identifier-and-reference-contract.mdVerbindlicher Vertrag für stabile Identifier, Referenzarten und deren Auflösung über Persistenz und Materialisierungen hinweg..

Materialisierung#

Markdown, HTML, Reports, Datenbankzeilen und ZIP-Inhalte sind kontrollierte Repräsentationen eines freigegebenen fachlichen Zustands. Materialisierung, Herkunft und Roundtrip-Schutzregeln werden in ◆MVP-001-materialization-and-provenance-contract.mdVerbindlicher Vertrag für Materialisierungen, Herkunft, Roundtrip-Deltas und verlustarme Wiedereinspielung. präzisiert.

Verbindliche Invarianten#

1. Eine fachliche Identität bleibt bei Pfad-, Sprach-, Format- oder Speicherwechsel erhalten.
2. Eine gespeicherte Revision wird nicht mutiert.
3. Beziehungen und relevante Zuordnungen bleiben explizit, typisiert und prüfbar.
4. Jede materialisierte Datei ist auf eine fachliche Identität und einen konkreten Stand zurückführbar.
5. Import und Export dürfen keine neue fachliche Identität aus Dateinamen oder Reihenfolge ableiten, wenn eine stabile Identität vorliegt.
6. Konflikte zwischen Materialisierung und führendem Arbeitszustand werden als Delta oder Validation ⌘FindingTechnical documentation artifact. behandelt, nicht stillschweigend überschrieben.
7. Fehlende Dateien in einem changed-only-Paket sind keine Löschaufträge.
8. Enterprise-Semantik wird referenziert und nicht lokal neu definiert.

Realisierungsbezüge#

• Kanonisches Domain Model: ◆MVP-001-domain-model.mdTechnical documentation artifact.
• Domain Invariants: ◆EP-001A-domain-invariants.mdTechnical documentation artifact.
• Persistence Model: ◆EP-001B-persistence-model.mdTechnical documentation artifact.
• Repository Contract: ◆../60-services/EP-001C-go-domain-repository-contract.mdTechnical documentation artifact.
• Manifest Mapping: ◆../95-building-blocks/MVP-001-artifact-manifest-mapping.mdTechnical documentation artifact.
• ⌘MaterializationEine Materialisierung ist die technisch erzeugte und persistierte Darstellung einer Projektion. Decision: ◆../96-decisions/SADR-002-artifact-manifest-materialization.mdVerbindliche Solution-Entscheidung SADR-002 - Artifact Manifest Materialization.
• Requirements: ◆../97-requirements/MVP-001-unified-artifact-model-requirements.mdRückverfolgbare Anforderungen für Identität, Revision, Referenzauflösung, Materialisierung und Provenance.
• Verification: ◆../98-tests/MVP-001-unified-artifact-model-verification-matrix.mdVerifikationsmatrix für stabile Identität, Revision, Beziehungen, Referenzen, Materialisierung und Roundtrip-Provenance.

Historische Konsolidierung#

Die historische Gesamtarchitektur enthielt tragfähige Aussagen zu stabilen Artefakt-IDs, eigenständigen Relationships, Manifesten, Roundtrip, Traceability und Knowledge Artifacts. Diese Aussagen wurden hier auf ihre Solution-Realisierungsanteile reduziert und gegen den bereits führenden Zielstand konsolidiert. Historische Ordner, Berichte und universelle Ontologiedefinitionen wurden nicht übernommen.