Netzwerksolution Documentation Report

MVP-001-BUILDING-BLOCK-MAP

MVP-001 – Building-Block-Karte#

Reference Building Blocks#

Die folgenden Einträge sind Solution Building Blocks der Engineering Platform. Ihre lösungsneutralen Ursprünge und die Zuordnung zu Backend, Frontend, Persistenz und Runtime sind in festgelegt.

Ein Solution konkretisiert einen oder mehrere Reference Building Blocks, ohne deren stillschweigend neu zu definieren.

Zweck#

Diese Map strukturiert die produktive Engineering Platform in fachlich und technisch gekapselte Building Blocks. Sie verhindert eine Vermischung von Verantwortlichkeiten, ohne für MVP-001 eine verteilte Microservice-Landschaft zu erzwingen.

Die Building Blocks werden zunächst als Module eines modularen Go-Backends und eines modularen JavaScript-Frontends materialisiert. Ihre Grenzen sind so zu gestalten, dass einzelne Blocks später als eigenständige Prozesse oder Services herausgelöst werden können, ohne das Fachmodell neu zu schreiben.

Ableitungskette#

Enterprise Capability
                → MVP Requirement
                → Solution Building Block
                → Go Module / JavaScript Module
                → API / Event / Port
                → Persistence Objects
                → Test

Jeder Building Block muss auf mindestens eine bestehende und mindestens ein MVP-Requirement zurückgeführt werden. Die verbindliche Zuordnung steht in . Building Blocks tragen zu Capabilities bei; sie besitzen oder implementieren eine Capability nicht allein.

Building Blocks#

BB-EP-001 – Platform Shell#

Zweck

Stellt den gemeinsamen Laufzeit- und Navigationsrahmen der Engineering Platform bereit.

Realisiert insbesondere

Go-Verantwortung

JavaScript-Verantwortung

Veröffentlicht

Darf nicht besitzen

BB-EP-002 – Identity & Access#

Zweck

Verantwortet Benutzeridentität, Anmeldung, Rollen, Berechtigungen und Benutzerpräferenzen.

Realisiert insbesondere

Go-Verantwortung

JavaScript-Verantwortung

Persistenzobjekte

Veröffentlicht

Darf nicht besitzen

BB-EP-003 – Artifact Management#

Zweck

Verantwortet stabile Artefaktidentitäten, Metadaten, Status, Ownership und Revisionen.

Realisiert insbesondere

Go-Verantwortung

JavaScript-Verantwortung

Persistenzobjekte

Veröffentlicht

Darf nicht besitzen

BB-EP-004 – Relationship Management#

Zweck

Verantwortet typisierte, gerichtete und dimensionierte Beziehungen zwischen Artefakten.

Realisiert insbesondere

Go-Verantwortung

JavaScript-Verantwortung

Persistenzobjekte

Veröffentlicht

Darf nicht besitzen

BB-EP-005 – Localization#

Zweck

Verantwortet sprachabhängige Artefaktinhalte und deren Revisionsbezug unabhängig von der UI-Sprache.

Realisiert insbesondere

Go-Verantwortung

JavaScript-Verantwortung

Persistenzobjekte

Veröffentlicht

Darf nicht besitzen

BB-EP-006 – Terminology#

Zweck

Verantwortet Begriffe, Definitionen, Terminologiegruppen und sprachspezifische Benennungen.

Realisiert insbesondere

Go-Verantwortung

JavaScript-Verantwortung

Persistenzobjekte

Veröffentlicht

Darf nicht besitzen

BB-EP-007 – Translation#

Zweck

Verantwortet manuell gestartete automatische Übersetzungen sowie deren Status, und Reviewbedarf.

Realisiert insbesondere

Go-Verantwortung

JavaScript-Verantwortung

Persistenzobjekte

Veröffentlicht

Darf nicht besitzen

BB-EP-008 – Audit & Traceability#

Zweck

Verantwortet unverlierbare Nachvollziehbarkeit von Änderungen, Jobs, Entscheidungen und Herkunft.

Realisiert insbesondere

Go-Verantwortung

JavaScript-Verantwortung

Persistenzobjekte

Veröffentlicht

Darf nicht besitzen

BB-EP-009 – Roundtrip Orchestration#

Zweck

Verantwortet den fachlichen Mensch–AI-Roundtrip aus der Anwendung heraus.

Realisiert insbesondere

Go-Verantwortung

JavaScript-Verantwortung

Persistenzobjekte

Veröffentlicht

Darf nicht besitzen

BB-EP-010 – Persistence#

Zweck

Stellt transaktionale Persistenz, Migrationen, Outbox und technische Repository-Adapter bereit.

Realisiert insbesondere

Go-Verantwortung

JavaScript-Verantwortung

Keine direkte Verantwortung.

Persistenzobjekte

Veröffentlicht

Darf nicht besitzen

BB-EP-011 – Runtime Integration#

Zweck

Bindet die Engineering Platform kontrolliert an Test- und Produktionsruntime, Konfiguration, Jobs und Betriebsinformationen an.

Realisiert insbesondere

Go-Verantwortung

JavaScript-Verantwortung

Veröffentlicht

Darf nicht besitzen

Initiale technische Materialisierung#

Die Building Blocks werden zunächst wie folgt materialisiert:

engineering-platform/
                ├── 10-backend/
                │   ├── cmd/platform/
                │   └── internal/
                │       ├── platform/
                │       ├── identity/
                │       ├── artifacts/
                │       ├── relationships/
                │       ├── localization/
                │       ├── terminology/
                │       ├── translation/
                │       ├── audit/
                │       ├── roundtrip/
                │       ├── persistence/
                │       └── runtimeintegration/
                └── 20-frontend/src/
                    ├── shell/
                    ├── identity/
                    ├── artifacts/
                    ├── relationships/
                    ├── localization/
                    ├── terminology/
                    ├── translation/
                    ├── audit/
                    └── roundtrip/

Die konkrete Verzeichnisstruktur wird im Engineering-Platform-Repository materialisiert. Diese Solution Architecture definiert die fachlichen Grenzen und Abhängigkeiten.

MVP-Abhängigkeitsrichtung#

Platform Shell
                    ↓
                Identity & Access
                    ↓
                Artifact Management ← Relationship Management
                    ↓                    ↓
                Localization ← Terminology
                    ↓
                Translation
                    ↓
                Roundtrip Orchestration

                Audit & Traceability wird von allen fachlichen Blocks über einen Port genutzt.
                Persistence implementiert Ports der fachlichen Blocks.
                Runtime Integration stellt technische Laufzeitdienste bereit.

Die Darstellung beschreibt zulässige Nutzung, keine Datenbank- oder Quellcodebesitzverhältnisse.

BB-EP-012 – Knowledge & Guidance Management#

Materialisiert Knowledge Management und verbindet Help Contexts, Glossar, Learning Nuggets, Quellen und Workbench-Kontext.

BB-EP-013 – Bootstrap & Installation Management#

Zweck

Koordiniert deklarative, idempotente Installation, Bootstrap-Prüfungen und deren Evidence.

Veröffentlicht

Darf nicht besitzen

Führende Ownership-Sicht#

Die vollständige Zuordnung von primärer Ownership, veröffentlichten Grenzen und zulässigen Abhängigkeiten steht in .

Requirement- und Verification-Bezug#

Building Blocks sind Realisierungsbeiträge und keine Eigentümer von Requirements oder Capabilities. Die Nachweiskette von Vertrag und Requirement über Building-Block-Beitrag bis Verification wird repositoryweit in der geführt.

↑