MVP-001-MATERIALIZATION-AND-PROVENANCE-CONTRACT

MVP-001 – Materialisierungs- und Provenienzvertrag#

Zweck#

Dieser Vertrag beschreibt, wie ein fachlicher Artefaktstand als Datenbankzustand, Markdown, HTML, Report oder ZIP repräsentiert und wieder aufgenommen wird, ohne Identität, Revision, Sprache, Beziehungen oder ⌘HerkunftProvenienz beschreibt die nachvollziehbare Herkunft eines Wissenselements, einer Aussage oder einer abgeleiteten Darstellung. zu verlieren.

Materialisierungstypen#

• produktiver Arbeitszustand in MariaDB;
• Repository-Dokumente und strukturierte Sidecar-/Manifestdaten;
• lesbare Markdown- und HTML-Repräsentationen;
• Reports und Verification ⌘EvidenceTechnical documentation artifact.;
• Full- oder changed-only Transportpakete.

Jede Materialisierung besitzt einen expliziten Typ und einen nachvollziehbaren Bezug auf ⌘ArtefaktEin Artefakt ist jede eindeutig identifizierbare fachliche, technische, organisatorische oder reale Einheit, die in der Engineering-Landschaft modelliert wird., Revision, Sprache, Erzeugungsprozess und Zeitpunkt.

Provenance-Mindestumfang#

Soweit für den Materialisierungstyp relevant, bleiben erhalten:

• stabile Artifact- und Relationship-Identifier;
• konkrete Quellrevisionen;
• Sprache und Lokalisierungsrevision;
• Owner beziehungsweise fachliche Heimat;
• erzeugender Akteur oder Prozess;
• Erzeugungszeitpunkt;
• Quellmaterialisierung oder Importherkunft;
• Validation- und Reviewstatus.

Roundtrip-Regeln#

1. Exportierte Arbeitspakete binden konkrete Ausgangsrevisionen.
2. Rückgaben werden gegen diese Ausgangsrevisionen als Delta bewertet.
3. Änderungen werden nicht allein aufgrund gleicher Dateipfade als konfliktfrei angenommen.
4. Neue, geänderte und explizit gelöschte Dateien werden getrennt ausgewiesen.
5. Fehlende Dateien sind niemals implizite Löschaufträge.
6. Löschungen benötigen einzelne zulässige deletedFiles-Einträge im Manifest.
7. Eine angenommene Änderung erzeugt neue Revisionen und Provenance; bestehende Revisionen werden nicht überschrieben.
8. Unauflösbare Identitäten, Revisionen oder Referenzen führen zu einem Validation ⌘FindingTechnical documentation artifact..

Verlustarm versus semantisch vollständig#

Legacy-Markdown kann zunächst verlustarm aufgenommen werden, auch wenn nicht jede Aussage bereits strukturiert ist. Verlustarm bedeutet, dass Inhalt und vorhandene Metadaten bewahrt werden. Semantisch vollständig ist die Aufnahme erst, wenn Identität, relevante Beziehungen, Sprache, Revision und Herkunft strukturiert nachvollziehbar sind.

Abgrenzung#

Dieses Dokument definiert den solutionweiten Vertrag. Konkrete ZIP-Erzeugung, lokale Pfade, Importbefehle oder Git-Abläufe gehören in Engineering Tools beziehungsweise Workspace.

Beziehungen#

• ◆MVP-001 – Mehrsprachige ArtefaktplattformVerbindlicher Solution Contract für das erste produktive Plateau der Engineering Platform. — contributes_to