Centurio System- & Moduldokumentation
🏛️ Plattform-Architektur 🔑 Login
Alle Module / core_platform / Semantik-Studio
🧠

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 & Lebenszyklen

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

⚙️ Fachprozesse & Capabilities (System-Fachlogik)

Registrierte Fachoperationen und System-Capabilities dieses Moduls zur Steuerung von Workflows, Kaskaden und KI-Agenten.

Gesamt: 0
Keine modul-spezifischen Capabilities registriert. Das Modul nutzt Standard-CRUD und Kern-APIs.

🧠 Fachprozess-Erzählung & Dual Knowledge Architektur

Synthese aus der ideologischen Blaupause (Meta-Fachlogik / Soll), der faktischen System-Implementierung (System-Fachlogik / Ist) und No-Code Customizing für KI-Consultants.

Dual Knowledge Layer
📖

Der durchgängige Businessprozess im Detail (End-to-End Fließtext-Erzählung)

Der funktionale Ablauf von Semantik-Studio in der Plattform-Architektur

Das Modul semantic_core erbringt zentrale Infrastruktur- und Steuerungsdienste im Monolithen. Jeder Aufruf durchläuft die zweistufige Sicherheitsarchitektur: Zunächst verifiziert der Session-Guard die Identität des Benutzers, woraufhin die PostgreSQL Row-Level-Security (RLS) aktiviert wird. Dadurch ist garantiert, dass Datenzugriffe mathematisch und physisch ausschließlich auf den authentifizierten tenant_id-Kontext beschränkt bleiben.

Mutationen und administrative Aktionen werden über transaktionale Services ausgeführt. Bei zustandsverändernden Operationen schreibt das System simultan in die betriebliche Zieltabelle und in die transaktionale Outbox. Asynchrone Worker greifen diese Signale ab und kaskadieren Ereignisse an nachgelagerte Module, ohne den synchronen HTTP-Pfad zu blockieren. Jeder Zugriff wird unveränderbar im Audit-Trail protokolliert.

🏛️

Meta-Fachlogik: Ideologische Blaupause, Soll-Weltbild & Normen

Meta-Fachlogik: Sicherheits- und Plattform-Architektur

Basiert auf den Standards ISO/IEC 27001:2022 (Informationssicherheits-Managementsysteme), den BSI IT-Grundschutz-Bausteinen (APP.3.1 Webanwendungen, SYS.1.1 Allgemeiner Server) und Art. 32 DSGVO.

  • Mandantentrennung als Primärinvariante: Keine Mandantendaten dürfen jemals ohne tenant_id-Filter geladen oder mutiert werden. Das Soll-Modell verlangt die Durchsetzung auf Datenbankebene via PostgreSQL RLS.

  • Unveränderbarkeit von Sicherheitsereignissen: Protokolldateien, Logins, Berechtigungsänderungen und Konfigurationsmutationen müssen revisionssicher und schreibgeschützt festgeschrieben werden.

⚙️

Systemische Fachlogik: Faktische Umsetzung in Centurio ERP & Capabilities

Systemische Fachlogik: Die faktische Umsetzung von Semantik-Studio

In Centurio ERP wird semantic_core als modularer Monolith-Baustein unter app.modules.semantic_core geführt. Die Autorisierung erfolgt über die zentrale RBAC-Engine mit Berechtigungs-Prüfung gegen Rollen und Berechtigungen. Datenänderungen lösen Outbox-Events aus, die über den PostgreSQL events-Bus verteilt werden. Idempotente Requests verhindern Replay-Angriffe und versehentliche Mehrfachausführungen.

🤖

KI-Consultant Leitfaden: Customizing- & No-Code-Konzept (Soll-Ist-Synthese)

AI Solution Architect Blueprint

KI-Consultant Blueprint: Customizing & No-Code Leitfaden für Semantik-Studio

  • No-Code Datenmodell-Erweiterung: Bei Bedarf können kundenspezifische Zusatzfelder im No-Code Customizing Studio angelegt werden.

  • Workflow-Integration: Administrative Ereignisse können als Trigger in der Canvas No-Code DAG Engine genutzt werden.

  • Sicherheitsregeln: Vor kritischen Systemänderungen sind Human-in-the-Loop Freigabegates einzurichten.

📚 Operative Prozessbegriffe & Transaktionsschnittstellen

Zentrale Fachbegriffe im Prozesszusammenhang (Operatives Modell)
Mandantenisolation (RLS)
PostgreSQL Row-Level-Security zur physischen und logischen Trennung aller Kundendaten auf Datenbankebene.
Zweistufige Authentifizierung
Strikte Trennung zwischen globalem Benutzerkonto und mandantenbezogener Rollenzuweisung (RBAC).
Transaktionale Outbox
Entkoppeltes Event-Publishing zur Vermeidung von Distributed-Transaction-Inkonsistenzen.
Revisionssicherer Audit-Trail
Lückenlose Aufzeichnung aller datenverändernden Zugriffe für Compliance und Rechnungsprüfung.
📥 Eingänge & Trigger (Inputs)
  • Systemaufrufe über REST-API oder Web-Portal
  • Hintergrund-Worker und Cron-Jobs
  • Ereignisse über den Outbox-Eventbus
📤 Ausgänge & Arbeitsergebnisse (Outputs)
  • Ausführungs- und Protokolldaten
  • Audit-Events im Revisionsjournal
  • Veränderte Systemzustände
⚡ Kaskaden & Folgeprozesse (Cascades)
  • security_event -> admin_alert: Alarmierung bei verdächtigen Zugriffen
  • config_changed -> cache_invalidation: Sofortige Aktualisierung
🛡️ Nebenprozesse & Resilienz
  • Manuelle Ausnahmebehandlung durch berechtigte Sachbearbeiter
  • Revisionssichere Protokollierung im Audit-Trail
💡 No-Code Checkliste & Praxistipps
  • Rollen- und Berechtigungsstufen exakt an Mitarbeiteraufgaben anpassen
  • Sicherheitsrichtlinien für Passwörter und Sessions aktivieren

🗄️ Datenmodelle & Felder

CategoryAttributeBinding category_attribute_bindings RLS Aktiv
7 Felder / Spalten

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

Feldname Datentyp Pflicht Schlüssel Fachliche Bedeutung
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 Felder / Spalten

Persistierte Instanzwerte für konfigurierte Produkt- und Belegattribute.

Feldname Datentyp Pflicht Schlüssel Fachliche Bedeutung
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

🔌 Einstiegspunkte (UI & APIs)

Art Methode Endpunkt / Pfad Titel & Zweck Berechtigung
🖥️ 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

🛡️ Regulatorik & Compliance

Dieses Modul unterliegt folgenden gesetzlichen, regulatorischen und Revisionsstandards:

  • GoBD Datenmodell-Dokumentation
  • Semantische Provenienz
Verknüpfte Module:
➔ catalog ➔ quotes ➔ workorders ➔ portal