EA-MVP-ACCEPTANCE-001
MVP Acceptance Criteria – erster produktiver Vertikalschnitt#
Zweck#
Diese Kriterien beschreiben die sichtbare Wirkung, mit der der GlossarbegriffEin MVP ist eine kleinste überprüfbare Materialisierung mit bewusst begrenztem Umfang.Glossareintrag vollständig lesen als produktive Materialisierung der ausgewählten Capabilities gilt. Technische Detailanforderungen werden anschließend in der Solution Architecture spezifiziert.
End-to-End-Szenario#
Ein berechtigter Benutzer meldet sich an, verwendet die Anwendung vollständig in einer gewählten UI-Sprache, öffnet ein reales importiertes Architekturartefakt, bearbeitet Inhalt und Beziehungen, erzeugt Sprachfassungen, vergleicht und korrigiert Übersetzungen und stößt einen nachvollziehbaren Mensch–AI-Roundtrip an.
Verbindliche Akzeptanzkriterien#
A. Benutzer, Sprache und Security#
- Anmeldung und sichere Session sind vorhanden.
- Serverseitige Autorisierung schützt lesende, schreibende, übersetzende, reviewende und Roundtrip-bezogene Aktionen.
- Der Benutzer besitzt eine persistierte UI-Sprachpräferenz.
- Die UI kann vollständig in
de,enundukbedient werden. - UI-Sprache und Sprache des geöffneten Artefakts sind voneinander unabhängig.
- Secrets und konkrete Runtime-Konfiguration werden nicht im Repository gespeichert.
B. Artefakte und Beziehungen#
- Ein vorhandenes Markdown-Dokument kann verlustarm als 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 importiert werden.
- Das Artefakt besitzt eine stabile, sprachunabhängige Identität.
- Metadaten, Inhalt, Status, Ownership und aktuelle Revision sind sichtbar.
- Eingehende und ausgehende Beziehungen können angezeigt und bearbeitet werden.
- Speichern erzeugt eine nachvollziehbare neue Revision.
- Die ursprüngliche Repository- und Pfadherkunft bleibt nachvollziehbar.
C. Mehrsprachige Inhalte#
- Ein Artefakt kann mindestens Sprachvarianten für
de,enundukbesitzen. - Sprachvarianten referenzieren ihren Quellstand und ihre Quellrevision.
- Fehlende und veraltete Übersetzungen sind sichtbar.
- Mindestens die Status
draft,machine-translated,review-required,reviewed,approvedundoutdatedsind abbildbar. - Terminologiekontext kann einem Übersetzungsvorgang zugeordnet werden.
D. Automatische Übersetzung#
- Ein berechtigter Benutzer kann eine automatische Übersetzung manuell anstoßen.
- Als Zielsprache können mindestens
enundukgewählt werden; die Architektur unterstützt alle drei Richtungen zwischende,enunduk. - Der Auftrag wird als persistierter Translation Job geführt.
- Provider, Ausgangsrevision, Zielsprache, Status und Ergebnis sind nachvollziehbar.
- Ein maschinelles Ergebnis wird nicht automatisch als fachlich freigegeben markiert.
E. Vergleich und Bearbeitung#
- Quell- und Zielfassung können nebeneinander beziehungsweise in einer vergleichbaren Merge-/Diff-Ansicht dargestellt werden.
- Die Zielfassung kann direkt in dieser Ansicht bearbeitet werden.
- Quellrevision, Zielrevision und Übersetzungsstatus sind sichtbar.
- Speichern erzeugt eine neue Sprachvariantenrevision und einen Audit-Eintrag.
- Review und GlossarbegriffEin Release ist ein bewusst freigegebener und nachvollziehbarer Stand von Artefakten und ihrer Realisierung.Glossareintrag vollständig lesen sind nur mit passenden Berechtigungen möglich.
F. Human–AI Roundtrip#
- Ein Benutzer kann aus der Anwendung heraus Artefakte und Sprachvarianten für einen Roundtrip auswählen.
- Das Paket hält mindestens Artefaktidentitäten, Ausgangsrevisionen, Beziehungen und Auftrag fest.
- Engineering Tools erzeugen und validieren das technische Austauschpaket.
- Rückgaben werden als Delta gegen die Ausgangsrevisionen dargestellt.
- Änderungen können kontrolliert angenommen oder abgelehnt werden.
- Der gesamte Vorgang ist über Roundtrip-ID, Akteur, Zeitpunkte, Status und Ergebnisse nachvollziehbar.
G. Betrieb#
- Es existieren getrennte Test- und Produktionsumgebungen.
- Beide verwenden dieselbe Anwendung und unterscheiden sich über Environment-Konfiguration.
- Backend, Frontend, MariaDB, Translation GlossarbegriffEin Service ist eine abgegrenzte bereitgestellte technische oder fachliche Leistung mit klarer Verantwortung.Glossareintrag vollständig lesen und Roundtrip Worker sind als getrennte Runtime-Komponenten betreibbar.
- Logs, Reports, Fehlerzustände und Wiederaufnahme sind verfügbar.
- Ein fehlgeschlagener Job verliert weder Auftrag noch Ausgangsrevisionen.
H. Materialisierung und Austausch#
- Datenbank ist der führende Arbeitszustand der laufenden Anwendung.
- Markdown bleibt verlustarmes Austausch- und Reportformat.
- Importierte Inhalte können wieder als Markdown und ZIP materialisiert werden.
- HTML und UI sind weitere Darstellungen derselben identifizierbaren Artefakte.
Nicht ausreichend#
Der MVP ist nicht akzeptiert, wenn lediglich ein Texteditor, ein statischer Markdown-Browser oder ein nicht historisierter Datenbankimport vorliegt. Ebenso unzureichend sind nur simulierte Übersetzung, nur eine UI-Sprache, clientseitige Scheinberechtigungen oder ein Roundtrip ohne Revisionen und Audit.