MVP-001-SYSTEM-CONTEXT

MVP-001 – Systemkontext#

Zweck#

Der System Context konkretisiert den Solution Contract als überprüfbare Grenze zwischen Engineering Platform, Benutzern, Engineering Tools, Runtime und externen Diensten.

Benutzer und Akteure#

• Architektur- und Engineering-Benutzer bearbeiten Artefakte, Beziehungen und Sprachvarianten.
• Reviewer/Freigeber prüfen Übersetzungen, Änderungen und Rückgaben.
• Administrator verwaltet Benutzer, Rollen, Konfiguration und Betriebszustände.
• AI-Teilnehmer bearbeitet exportierte Arbeitspakete; der konkrete Transport bleibt austauschbar.
• Translation ⌘ServiceEin Service ist eine abgegrenzte bereitgestellte technische oder fachliche Leistung mit klarer Verantwortung. erzeugt auf manuellen Auftrag Übersetzungsvorschläge.
• Engineering Tools importieren, exportieren, validieren, paketieren und integrieren Artefakte.

Innerhalb der Solution-Grenze#

• Web-UI und Application Layer;
• Benutzer-, Rollen- und Sitzungsverwaltung;
• Artefakt-, Beziehungs-, Sprach- und Revisionsverwaltung;
• Translation-Job-Orchestrierung und Review;
• Audit, ⌘ProvenanceProvenienz beschreibt die nachvollziehbare Herkunft eines Wissenselements, einer Aussage oder einer abgeleiteten Darstellung. und Nachvollziehbarkeit;
• Roundtrip-Auftrags-, Status- und Annahmeverwaltung;
• solutionweite Verträge für Persistenz, Materialisierung, Referenzen und ⌘EvidenceTechnical documentation artifact..

Außerhalb, aber angebunden#

• MariaDB als persistente Infrastruktur der Zielruntime;
• Translation Services und spätere AI-Provider hinter austauschbaren Servicegrenzen;
• Git-Repositories als versionierte Quell- und Integrationsziele;
• engineering-tools als ausführende Materialisierungs- und Validierungskomponente;
• Test- und Produktionsruntime;
• AI-Transportkanäle und zukünftige Connectoren.

Außerhalb bedeutet nicht architektonisch unbeachtet: Die Solution definiert Integrationsverträge und Qualitätsanforderungen, besitzt aber nicht die internen Modelle externer Systeme.

Zentrale Interaktionen#

1. Ein Benutzer meldet sich an und verwendet die UI in de, en oder uk.
2. Er öffnet ein ⌘ArtefaktEin Artefakt ist jede eindeutig identifizierbare fachliche, technische, organisatorische oder reale Einheit, die in der Engineering-Landschaft modelliert wird. unabhängig von dessen Inhaltssprache.
3. Er bearbeitet Inhalt, Metadaten oder Beziehungen und erzeugt eine nachvollziehbare Revision.
4. Er startet manuell Übersetzungen nach en und/oder uk.
5. Er vergleicht Quell- und Zielrevision, editiert und prüft die Zielfassung.
6. Er stellt Artefakte für einen Roundtrip zusammen und startet diesen aus der UI.
7. Engineering Tools erzeugen und validieren ein installierbares Austauschpaket.
8. Rückgaben werden als Delta importiert, geprüft und bewusst angenommen oder verworfen.
9. Audit-, Status- und Verification Evidence bleiben der jeweiligen Aktion zugeordnet.

Führender Zustand und Materialisierungen#

MariaDB ist der führende produktive Arbeitszustand. Markdown, HTML, Reports, ZIP-Pakete und UI-Ansichten sind Projektionen oder Materialisierungen desselben Artefaktbestands. Während der Migration muss die bestehende Markdown-Struktur verlustarm importierbar und exportierbar bleiben.

Sicherheits- und Betriebsgrenze#

• Secrets und konkrete Umgebungswerte werden nicht in Artefakten oder Source Contracts hart codiert.
• Externe Translation- oder AI-Dienste blockieren nicht das Speichern fachlicher Daten.
• Test- und Produktionsruntime sind getrennt.
• Fehler externer Dienste werden als nachvollziehbarer Job- oder Integrationsstatus behandelt.

Verweise#

• Solution Contract: ◆../10-solution-contract/MVP-001-multilingual-artifact-platform.mdVerbindlicher Solution Contract für das erste produktive Plateau der Engineering Platform.
• Scope: ◆../00-overview/solution-scope-and-boundaries.mdVerbindliche Definition des konkreten Lösungsraums und seiner Architekturebenen.
• Enterprise-Spezialisierung: ◆enterprise-theory-specialization.mdOrdnet die Solution Architecture als Spezialisierung der universellen Enterprise-Theorie ein.
• Capability-Realisierung: ◆../40-capabilities/MVP-001-capability-realization.mdFührender Einstieg für Scope, Realisierungsbeiträge und Verification der MVP-001 Capabilities.