🧠

Semantik-Studio

semantic_core core_platform 🛡️ RLS Protected

Tenant-Workflows, Canvas, Intents, Felder und Simulationsläufe.

Fachliche Bestimmung: Ermöglicht flexible Fachkonfiguration ohne Codeänderungen. Produktkategorien können mit versionierten Fieldsets (z.B. Rohrdurchmesser, RAL-Farbe, Leistung in kW) angereichert werden. Bietet eine strikte Typ-Validierungs-Engine (String, Number mit Komma-Parsing, Select/Enum, Boolean, Date) und steuert den Veröffentlichungs- und Freigabeprozess von Merkmalsdefinitionen.

⚡ Workflows & Läbenszykle (1) 🗄️ Datemodell & Fälder (2) 🔌 Iistigspünkt (UI & APIs) (5) 🛡️ Regulatorie & Compliance

⚡ Workflows & Läbenszykle

Fieldset-Entwurf, Validierung und Aktivierung `fieldset_lifecycle`

Entwurf von Kategorie-Merkmalen, Pflichtfeld-Kennzeichnung, Simulation und Freigabe zur Produktionsreife.

stateDiagram-v2 [*] --> DRAFT: Merkmale & Pflichtfelder definieren DRAFT --> SIMULATION: Simulation gegen Altbestand SIMULATION --> DRAFT: Pflichtfeldfehler korrigieren SIMULATION --> PUBLISHED: Revision snapshotten (Hash) PUBLISHED --> ACTIVE: Versionszeiger aktivieren ACTIVE --> [*]: Sofort in ERP & Portal aktiv

1. DRAFT

Entwurfsphase

Merkmale anlegen, Typen definieren und is_required kennzeichnen.

Aktionen: Entwurf isoliert halten

2. SIMULATION

Regel-Simulation

Prüfung gegen bestehende Produkte der Kategorie auf Pflichtfeldverletzungen.

Aktionen: Fehlerbericht anzeigen

3. PUBLISH

Veröffentlichung

Erzeugen eines unveränderlichen Snapshots (Revision mit SHA-Hash).

Aktionen: Revision sperren

4. ACTIVATION

Aktivierung

Setzen des aktiven Versionszeigers für ERP und Kundenportal.

Aktionen: Fieldset im Portal schalten

🗄️ Datemodell & Fälder

CategoryAttributeBinding category_attribute_bindings RLS Aktiv

7 Fälder / Spalte

Verknüpfung von dynamischen Attributen mit einer Produktkategorie inkl. Pflichtfeld- und Sichtbarkeitsflags.

Feldname	Datetyp	Pflicht	Schlüssel	Fachlichi Bedütig
`id`	`UUID`	Nein	PK	Bindungs-ID
`tenant_id`	`UUID`	Nein	-	Mandanten-ID (RLS)
`category_id`	`UUID`	Nein	FK ➔ product_categories.id	Zugeordnete Kategorie
`field_key`	`VARCHAR(100)`	Ja *	-	Technischer Merkmals-Schlüssel
`is_required`	`BOOLEAN`	Nein	-	Pflichtfeld-Kennzeichnung
`portal_visible`	`BOOLEAN`	Nein	-	Sichtbarkeit im Kundenportal
`sequence`	`INTEGER`	Nein	-	Anzeigereihenfolge

SemanticExtensionValue semantic_extension_values RLS Aktiv

6 Fälder / Spalte

Persistierte Instanzwerte für konfigurierte Produkt- und Belegattribute.

Feldname	Datetyp	Pflicht	Schlüssel	Fachlichi Bedütig
`id`	`UUID`	Nein	PK	Wert-ID
`tenant_id`	`UUID`	Nein	-	Mandanten-ID (RLS)
`entity_type`	`VARCHAR(50)`	Nein	-	Zielentität (z.B. product, quote_item)
`entity_id`	`UUID`	Nein	-	ID der Zielentität
`field_key`	`VARCHAR(100)`	Nein	-	Merkmals-Schlüssel
`value_text`	`TEXT`	Nein	-	Normalisierter Wert

🔌 Iistigspünkt (UI & APIs)

Art	Method	Endpunkt / Pfad	Titel & Zweck	Berächtigig
🖥️ WEB-UI	GET	`/semantic`	Semantik-Studio Übersicht der semantischen Modelle und Revisionsstände	`agents:read`
🖥️ WEB-UI	GET	`/semantic/customizing`	Customizing-Konsole Verwaltung von Feldsets und Attributen	`agents:manage`
🖥️ WEB-UI	GET	`/admin/categories`	Kategorienverwaltung Fieldset-Builder und Single-Click-Pflichtfeld-Toggle	`catalog:manage`
⚡ REST API	GET	`/api/v1/catalog/products/categories/{id}/fieldset`	Fieldset API Liefert das vererbte Attribut-Fieldset einer Kategorie	`catalog:read`
⚡ REST API	POST	`/api/v1/catalog/products/categories/{id}/fieldset/bindings`	Merkmal binden Fügt ein Merkmal zu einer Kategorie hinzu	`catalog:manage`

🛡️ Regulatorie & Compliance

Dieses Modul unterliegt folgenden gesetzlichen, regulatorischen und Revisionsstandards:

GoBD Datenmodell-Dokumentation
Semantische Provenienz

Verknüpfti Modul: