Zum Inhalt springen
ad hoc AI Workbench

UC-04 · Stammdatenpflege

Status: Entwurf · V1

Pflege der Faktenbasis: Provider, Material, Dienstleistung, Vertragsmuster, Liegenschaften, Tochterstrukturen, Codelisten.

Trigger

  • Neuer Provider tritt auf
  • Neues Material auf dem Markt
  • Vertragsmuster ändert sich (Konditionen, Laufzeit)
  • Neue Liegenschaft wird Bestandteil des Portfolios
  • Codeliste wird ergänzt (z. B. neuer Heizungstyp)

Akteur

  • Primär: Stammdatenpfleger (Tochter-spezifisch je Datentyp)
  • Mitwirkend: Analyst (löst Bedarf aus), Steward (genehmigt sensible Änderungen)
  • Aufsicht: Auditor (sieht Historie)

Ablauf

1. Suche / Anlage

Pfleger sucht zunächst, ob das Stammdatum bereits existiert (Dublettenvermeidung). Falls nein → neuer Datensatz.

2. Pflichtfelder erfassen

Je Entitätstyp definiert das Metadaten-Modell die Pflichtfelder. Beispiele:

  • Provider: Name, Sitz, Steuer-ID, Kontaktdaten, Kategorie (intern/extern), Tochter-Zuordnung wenn intern
  • Material: Hersteller, Bezeichnung, Spezifikation, Listenpreis, Datenblatt-Anhang
  • Dienstleistung: Name, Gewerk-Zuordnung, Standardpreis-Modell, Provider
  • Vertrag (Muster): Vertragstyp, Standardlaufzeit, Standardkonditionen, Kündigungsfristen
  • Liegenschaft: Adresse, Lage, Grundstücksgröße, Anzahl Gebäude/Wohneinheiten

3. Optionale Attribute

Reichern den Datensatz an: alternative Bezeichnungen, externe IDs (SAP-Nr, ERP-Nr), Schlagworte, Anhänge (Datenblätter, Zertifikate).

4. Validierung

Beim Speichern:

  • Pflichtfelder vollständig (DB-Constraint via Service)
  • Datentyp passt (Service via entity_type_attribute)
  • eindeutige Felder (z. B. Steuer-ID Provider) konfliktfrei
  • Referenzen (Provider→Tochter) existieren

5. Freigabe (optional)

Sensible Datentypen (z. B. Vertragsmuster) durchlaufen Approval (siehe ../40-workflows/02-stammdaten-lifecycle.md). Nicht-sensible werden direkt aktiv.

6. Versionierung

Jede Änderung erzeugt eine neue Version (im Spec-Modell entity_version). Cases, die einen alten Snapshot referenzieren, bleiben stabil.

Massendaten / Bulk-Import

Erst-Befüllung und regelmäßige Synchronisation aus Altsystemen über CSV/Excel-Import:

  1. Datei hochladen
  2. Spalten-Mapping (UI-Wizard)
  3. Trockenlauf — Validierungsfehler je Zeile
  4. Korrigieren oder Skip-Liste
  5. Commit

(Siehe docs/spec/90-governance/03-open-questions.md OP-41 — Mechanismus offen.)

Datenhoheit

Pro Datentyp gibt es einen fachlich Verantwortlichen (Steward). Beispiele:

  • Provider → Einkauf der Holding
  • Material → Technik der Sanierungs-Tochter
  • Vertragsmuster Mieterstrom → Energie-Tochter + Recht
  • Liegenschaft → Asset Management der Holding
  • Tochtergesellschaft → Holding selbst (selten geändert)

ACL-Mechanik (docs/spec/70-security/02-authorization.md) deckt das ab.

Beteiligte Fachobjekte

  • Provider, Material, Dienstleistung, Vertrag (Muster), Liegenschaft, Gebäude, Wohneinheit, Tochtergesellschaft
  • Codeliste (enum_set / enum_value im Spec-Modell): Gewerk-Typen, Heizungs-Typen, Modul-Hersteller, Vertragstypen, …

Verwandte Dokumente