MVP-001-IDENTIFIER-AND-REFERENCE-CONTRACT
MVP-001 – Kennungs- und Referenzvertrag#
Zweck#
Dieser Vertrag trennt fachliche Identität, technische Identifier, Repository-Adressen und Darstellungspfade. Er konkretisiert Identity für diese Solution, ohne die universelle Identity-Theorie neu zu definieren.
Identifier-Klassen#
| Klasse | GlossarbegriffBedeutung beschreibt den fachlichen Sinn eines Elements und seine Relevanz für Menschen und Organisationen.Glossareintrag vollständig lesen | Stabilität |
|---|---|---|
ArtifactId |
fachliche Identität eines Artefakts | unabhängig von Sprache, Pfad und Materialisierung |
ArtifactRevisionId |
Identität eines unveränderlichen Artefaktstands | dauerhaft und eindeutig |
ArtifactLocalizationId |
Identität einer Sprachvariante | stabil je GlossarbegriffEin Artefakt ist jede eindeutig identifizierbare fachliche, technische, organisatorische oder reale Einheit, die in der Engineering-Landschaft modelliert wird. Alles Modellierbare wird als Artefakt geführt. Dazu gehören unter anderem Systeme, Beziehungen, Features, Dokumente, ADRs, Tests, UI-Buttons, Menüs, Farben, Icons, Konfigurationen, Diagramme, Runtime-Ressourcen, fachliche Objekte und reale Objekte wie ein Blumentopf, sofern sie modelliert werden. Knowledge ist keine Sonderklasse. UI- und Applikationsartefakte werden fachlich nach demselben Grundmodell behandelt.Glossareintrag vollständig lesen und Sprache |
ArtifactLocalizationRevisionId |
Identität eines unveränderlichen Sprachstands | dauerhaft und eindeutig |
RelationshipId |
fachliche Identität einer GlossarbegriffEine Beziehung beschreibt eine nachvollziehbare Verbindung zwischen Bedeutungen, Artefakten und ihrem Kontext.Glossareintrag vollständig lesen | unabhängig von Darstellung und Transport |
| technische Persistenz-ID | Adapter- oder Datenbankadresse | darf fachliche IDs nicht ersetzen |
| Repository-Pfad | Adresse einer Materialisierung | veränderlich und nicht identitätsstiftend |
Referenzarten#
- Identity Reference – verweist auf eine stabile fachliche Identität.
- Revision Reference – bindet einen konkreten unveränderlichen Stand.
- Localization Reference – bindet Sprache und gegebenenfalls Lokalisierungsrevision.
- Relationship Reference – verweist auf eine eigenständige typisierte Beziehung.
- 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 Reference – verweist auf Datei, Paketposition oder Publikation und muss auf die fachliche Identität zurückführbar sein.
- External Reference – verweist auf ein externes System und benötigt Connector-, Namespace- oder Provider-Kontext.
Auflösungsreihenfolge#
stabile fachliche ID
→ optional konkrete Revision / Sprache
→ Manifest- oder Repository-Zuordnung
→ Materialisierungspfad oder externer Connector
→ Validierung des aufgelösten ZielsEin Dateipfad darf nur als Fallback-Adresse verwendet werden, wenn das importierte Legacy-Artefakt noch keine stabile ID besitzt. Bei der kontrollierten Aufnahme wird eine stabile ID zugeordnet und dauerhaft erhalten.
Fehler- und Konfliktfälle#
- Mehrere Materialisierungen derselben ID sind zulässig, sofern Typ, Revision und GlossarbegriffProvenienz hält Quelle, Entstehungs- oder Ableitungskontext sowie gegebenenfalls Revision und Prüfung fest. Sie erklärt, warum etwas als Beleg erhalten bleibt, ohne daraus automatisch eine aktuell führende Aussage zu machen.Glossareintrag vollständig lesen eindeutig sind.
- Mehrere fachliche Objekte mit derselben stabilen ID sind ein Integritätsfehler.
- Eine Referenz auf eine unbekannte ID bleibt als nicht aufgelöste Referenz diagnostizierbar; sie wird nicht stillschweigend umgebogen.
- Eine Referenz auf eine veraltete Revision darf auf den alten Stand auflösen, muss den Aktualitätskonflikt jedoch sichtbar machen.
- Pfadänderungen dürfen keine neue fachliche Identität erzeugen.
Nachweise#
Die Verifikation erfolgt über Kontext & ZeitMVP-001 – Einheitliche Artifact-Model-VerifikationsmatrixVerifikationsmatrix für stabile Identität, Revision, Beziehungen, Referenzen, Materialisierung und Roundtrip-Provenance.Vollständig lesen. Repository- und Persistenzadapter müssen diese Regeln nachweisbar erhalten.