Fachliche Dokumentation — adhoc Workbench

Status: Entwurf · Stand: 2026-04-25

Diese Dokumentation beschreibt die fachliche Seite der Workbench-Plattform für die ad hoc Unternehmensgruppe — Geschäftsmodell, Akteure, Use-Cases, Domänenobjekte, Workflows und Rollen.

Sie steht bewusst neben der UI-Doku (docs/ui/) und der technischen Spezifikation (docs/spec/):

Ort	Inhalt	Sprache
docs/business/ (hier)	Was wird fachlich abgebildet? Wer arbeitet damit? Welche Cases?	erklärend, fachlich
docs/ui/	Wie sieht das System aus? Komponenten, Screens, Interaktionsmuster	gestalterisch, exemplarisch
docs/spec/	Wie ist es technisch / strukturell festgelegt? DDL, Trigger, Views, Sicherheit	normativ, technisch

Beide Welten verweisen aufeinander. Das Mapping zwischen Fachobjekten und der generischen MDM-Plattform aus docs/spec/ liegt unter 70-mapping-to-spec/.

Lesepfad

1. Kontext — wer ist die ad hoc Holding, was sind die Töchter, was ist das Problem? → 10-business/01-context.md
2. Wertversprechen — was leistet die Workbench fachlich? → 10-business/02-value-proposition.md
3. Use-Cases — die Liegenschafts-Bewertung als Leitfall, danach Aggregation und Szenarien. → 20-use-cases/01-overview.md
4. Domäne — Stammdaten / Modell / Case als Dreieck, Fachobjekte und Relationen. → 30-domain/01-domain-overview.md
5. Workflows und Rollen — Lebenszyklen und Sichten je Rolle. → 40-workflows/ und 50-roles/
6. Regeln und Berechnung — Rule Engine, Solver, Wirtschaftlichkeitskriterien. → 60-rules-and-calculation/
7. Mapping zur Spec — wie wird das Fachmodell auf die generische MDM-Plattform abgebildet? → 70-mapping-to-spec/
8. Offene Punkte — fachliche Entscheidungen, die noch ausstehen. → 80-open-questions/

Struktur

docs/business/
├── 00-overview/                Glossar, Lesepfad
├── 10-business/                Kontext, Wertversprechen, Stakeholder, Nicht-Ziele
├── 20-use-cases/               Leitfälle (Bewertung, Aggregation, Szenarien, Pflege)
├── 30-domain/                  Fachobjekte, Beziehungen
├── 40-workflows/               Case-/Stammdaten-/Modell-Lebenszyklen
├── 50-roles/                   Rollenmodell und Sichten
├── 60-rules-and-calculation/   Regelengine, Solver, Wirtschaftlichkeitslogik
├── 70-mapping-to-spec/         Fachobjekt → entity_type / relation_type / Attribut
└── 80-open-questions/          Offene fachliche Punkte

Verhältnis zur generischen MDM-Spec

docs/spec/ definiert eine generische, metadatengetriebene MDM-Plattform (entity_type, entity, relation_type, RBAC, Audit, Outbox, Multi-Tenancy). Diese Plattform ist nicht auf den ad-hoc-Use-Case zugeschnitten — sie kann auch für andere Stammdatenwelten betrieben werden.

docs/business/ definiert die konkrete Konfiguration dieser Plattform für ad hoc: welche entity_type-Einträge gibt es, welche Attribute, welche Relationen, welche Rollen.

Die Workbench entsteht damit aus zwei Schichten:

• generischer MDM-Kern (Spec) — austauschbar, mehrfach nutzbar
• adhoc-Konfiguration (Business) — Seed-Daten + UI-Konventionen + Rule-Engine-Inhalte

Quellen / Vorarbeiten

Der fachliche Inhalt baut auf folgenden Vorarbeiten auf (siehe c:\project\mgm\projektmike\):

• output/gettingtoyes/story.md — Vorgehensmodell, Phasen, Stakeholder
• output/gettingtoyes/zielarchitektur.md — Domänen-Dreieck Stammdaten / Modell / Case
• output/gettingtoyes/technik.md — Stack-Entscheidungen (Authentik, OpenFGA, Postgres+JSONB, Drizzle)
• output/gettingtoyes/make_or_buy_in_times_of_ai.md — Make/Buy-Strategie
• input/input_nachricht_michael_2026_04_12.md — Original-Anforderung Holding-Case + Mieterstrom
• input/input_entscheidungen_2026_04_15.md — gesetzte technische Entscheidungen
• input/raw/notes_2026_04_21.md — adhoc-Plattform-Ziel