Netzwerksolution Documentation Report

EP-001A-DOMAIN-INVARIANTS

EP-001A – Domäneninvarianten und Lebenszyklen#

Zweck#

Dieses Dokument bündelt die verbindlichen Regeln, die in Persistenz, Backend, API, UI und Tests identisch durchgesetzt werden müssen.

Identität#

  1. Fachliche Identitäten sind stabil und technologieunabhängig.
  2. Datenbank-Primärschlüssel dürfen fachliche IDs materialisieren, aber nicht ersetzen.
  3. Dateipfade und Dateinamen sind keine fachlichen Identitäten.
  4. Sprache ist keine Eigenschaft der Artifact-Identität, sondern einer Localization.

Revisionierung#

  1. Fachlich gespeicherte Stände sind unveränderlich.
  2. Bearbeitung erzeugt eine neue Revision.
  3. Die aktuelle Revision ist eine Referenz, keine Überschreibung älterer Stände.
  4. Jede Revision kennt Akteur, Zeitpunkt, und Vorgänger.
  5. Beziehungen und Sprachvarianten besitzen eigene Revisionen.

Mehrsprachigkeit#

  1. Unterstützte MVP-Sprachen sind de, en und uk.
  2. UI-Sprache und Artefaktsprache werden getrennt gespeichert und verwendet.
  3. Ein Benutzer kann eine englische UI nutzen und gleichzeitig deutsche und ukrainische Inhalte vergleichen.
  4. Fehlende Sprachvarianten werden ausdrücklich als fehlend behandelt.
  5. Fallbacks dürfen die tatsächliche Sprache eines Inhalts nicht verschleiern.
  6. Maschinelle Übersetzungen erhalten mindestens den Status machine-translated oder review-required.
  7. erfolgt nur durch eine berechtigte Handlung.
  8. Wird die Quellrevision geändert, muss die Aktualität abgeleiteter Übersetzungen neu bewertet werden.

Beziehungen#

  1. Source, Target und RelationshipType sind verpflichtend.
  2. Beziehungstypen definieren Richtung, Kardinalität und erlaubte Zieltypen.
  3. Beziehungen sind eigenständige Domänenobjekte.
  4. Textlinks können Beziehungen materialisieren, ersetzen sie aber nicht.
  5. Änderungen an Beziehungen sind revisions- und auditierbar.

Dimensionen#

  1. Jede besitzt eine Definition.
  2. Werte müssen zum Wertebereich der Definition gehören.
  3. Kardinalität wird zentral validiert.
  4. Freie Dimensionsschlüssel ohne Definition sind im produktiven Modell unzulässig.
  5. Sprachen, Terminologien und Sicherheitsklassifikationen können als Dimensionen referenziert werden, behalten aber ihre eigenen fachlichen Objekte und Regeln.

Security und Autorisierung#

  1. Jede schreibende Aktion hat einen authentifizierten oder eindeutig technischen Akteur.
  2. Autorisierung wird serverseitig geprüft.
  3. UI-Ausblendung ersetzt keine Berechtigungsprüfung.
  4. Review, Freigabe, Übersetzungsstart, Roundtrip-Annahme und sind getrennte Berechtigungen.
  5. Secrets werden nicht als Artefaktinhalt, Audit-Nutzdaten oder Paketmetadaten gespeichert.

Audit#

  1. Sicherheits- und fachrelevante Änderungen erzeugen AuditEvents.
  2. AuditEvents sind append-only.
  3. Audit enthält mindestens Akteur, Aktion, Ziel, Zeitpunkt und Ergebnis.
  4. Roundtrip- und Request-IDs werden durchgängig weitergegeben.
  5. Audit und fachliche Revisionierung ergänzen sich; keines ersetzt das andere.

Übersetzung#

  1. TranslationJobs werden manuell oder durch explizit konfigurierte Automation erzeugt.
  2. Der muss manuelles Starten nach de, en und uk unterstützen.
  3. Jeder Job referenziert eine konkrete Quellrevision.
  4. Übersetzungsergebnisse erzeugen neue Lokalisierungsrevisionen.
  5. Connectorfehler verändern die bestehende freigegebene Sprachfassung nicht.
  6. Terminologiebezug und verwendeter Connector sind nachvollziehbar.

Roundtrip#

  1. Ein RoundtripJob speichert die Ausgangsrevisionen.
  2. Exportierte ZIPs sind Materialisierungen, keine führende Quelle.
  3. Rückgaben werden als Delta gegen den gespeicherten Ausgangszustand geprüft.
  4. Validierung, Review, Annahme und Promotion sind getrennte Zustände.
  5. Ein technischer Import ist keine automatische fachliche Annahme.
  6. Der Transportkanal zur AI bleibt austauschbar.

Löschung#

  1. Fachliche Löschung ist zunächst ein Statuswechsel oder kontrollierter Tombstone.
  2. Physische Löschung benötigt eine eigene Policy.
  3. Historie, Audit und referenzielle Integrität werden berücksichtigt.
  4. Manifestbasierte Dateilöschungen betreffen Materialisierungen, nicht automatisch Domänenobjekte.

MVP-Lebenszyklen#

Artifact#

draft → active → deprecated → archived

ArtifactLocalizationRevision#

draft
                → machine-translated | review-required
                → reviewed
                → approved
                → outdated

outdated kann erneut in review-required oder durch eine neue Revision in draft überführt werden.

TranslationJob#

requested → queued → running → completed
                                            └→ failed
                requested / queued ─────────→ cancelled

RoundtripJob#

draft
                → prepared
                → exported
                → returned
                → validating
                → review-required
                → accepted | rejected
                → promoted

Akzeptanz für EP-001A#

EP-001A ist fachlich abgeschlossen, wenn:

UAM-Invariantenbezug#

Die Invarianten dieses Dokuments sind die ausführbare Domänenpräzisierung des . Adapter-, UI- oder Transportmodelle dürfen sie nicht abschwächen. Insbesondere bleiben stabile fachliche IDs von Datenbank-IDs, Pfaden und Transportpositionen getrennt.

↑