Zum Inhalt springen

Glossar

Begriffe, die in CodamAI eine feste Bedeutung haben. Alphabetisch.

BegriffBedeutung
Abstraktes ModellModell, das selbst nicht instanziierbar ist und mehrere konkrete Untertypen hat. Wird über einen Hub-Router abgefragt, siehe Vererbung.
@type / _MODELTYPEDiskriminator, der bei abstrakten Modellen den konkreten Untertyp benennt. Im JSON @type, in der Datenbank die Spalte _MODELTYPE.
AbstractLayerBasisklasse des System-Layers mit der gesamten Rekursion für Create, Update, Patch, Read und Delete. Rund 1.700 Zeilen – das fachliche Herzstück.
ADRArchitecture Decision Record – eine festgehaltene Architekturentscheidung samt Begründung und Alternativen.
AttributfilterDatenfilter, der ein Benutzerprofil-Attribut (z. B. projects) gegen ein Datenfeld prüft. Siehe Attributbasierte Filter.
BlueprintBeschreibung eines Soll-Schemas für den MCP-Server. Wird validiert, geplant, freigegeben und angewendet.
BFFBackend for Frontend. Die Nitro-Serverschicht der Nuxt-Frontends, die die CDMS-API kapselt und den Token setzt.
CDMSCodamAI Data Management System – die modellgetriebene Backend-Basis.
Change SetEingefrorener, freigabepflichtiger Änderungsplan im MCP-Server. Genau einmal anwendbar.
CIASCodamAI Identity & Access System – Authentifizierung, Token, Rollen, Mandanten-Kontext.
CreateReadModeSTRICT oder LENIENT: entscheidet, ob ein fehlgeschlagenes Zurücklesen nach einem Create das Create zurückrollt. Siehe Transaktionen.
DataViewRead-only-Sicht auf berechnete/aggregierte Daten (Konzept; im aktuellen Code nicht ausgebaut).
DTOAntwortmodell. Wird aus der Entity gemappt und an den Client geliefert.
Effektiver TenantDer Mandant, der für die aktuelle Anfrage tatsächlich gilt: aus dem Token, ggf. durch einen autorisierten Kontextwechsel überschrieben.
EntityJPA-Persistenzmodell. Erbt je nach Einordnung von AbstractSystemModel, AbstractTenantModel oder AbstractUserModel.
EnversHibernate Envers – die Auditing-Bibliothek, die Revisionstabellen führt.
ExpanderKomponente im REST-Layer, die den Response Request des Clients auflöst: Wildcards expandieren, Felder prüfen, verschachtelte Anfragen rekursiv aufbauen.
HookErweiterungspunkt für Businesslogik vor/nach Datenbankzugriffen, auf Klassen- oder Feldebene. Siehe Hooks.
HubDas zentrale CDMS, in dem die Datenmodelle aller CDMS-Systeme gepflegt werden. Nicht zu verwechseln mit der Hub-API.
Hub-APIGenerierter Router-Controller für ein abstraktes Modell; verteilt Requests an die APIs der konkreten Untertypen.
MCPModel Context Protocol. Der MCP-Server des Hubs erlaubt KI-Clients das Lesen des Meta-Modells und kontrollierte Schemaänderungen.
Meta / MetaServiceGenerierte Metadaten eines Modells: Felder, Typen, Beziehungen, Regeln, Rollen. Zur Laufzeit über ModelMetaInterface.
Modul (CDMS-System)Eine fachliche Anwendung im Hub, deren Modelle verwaltet werden. Im Frontend „Modul”, im Backend historisch „System”.
Operation ContextBindet im MCP-Server alle Aufrufe einer Änderungsabsicht unveränderlich an genau ein Ziel-CDMS.
Owner-FilterAutomatischer Filter auf _userId bei benutzereigenen Modellen. Liegt im System-Layer.
PayloadEingabemodell der API: CreatePayload, UpdatePayload, PatchPayload, jeweils verpackt in WritePayload.
PersistenzzielSystem-Datenbank oder Tenant-Datenbank. Wird pro Entity-Typ aufgelöst.
Recursive-TypenPro Beziehung konfigurierte Erlaubnis, ob CDMS über sie hinweg anlegen (CREATE), ändern (UPDATE), lesen (READ) oder löschen (DELETE) darf.
Response RequestDie response-Sektion eines Payloads: bestimmt, welche Felder und Beziehungen die Antwort enthält.
RevisionEin Auditing-Eintrag zu einem Objektstand, mit Nummer, Zeitpunkt, Benutzer, IP und User-Agent.
SingletonModell, von dem es pro Scope (System/Tenant/User) genau ein Objekt gibt. Kein Suchendpunkt, keine sichtbare ID.
Strict ModeFehlerverhalten bei unzulässigen Anfragen: strikt = Fehler, tolerant = still ignorieren. Siehe Strict Mode.
System-LayerSchicht zwischen REST und Persistenz: Rekursion, Validierung, Hooks, Sicherheitsfilter, Orchestrierung.
TenantMandant. In Betriebsart MULTI eine eigene Datenbank, in SINGLE existiert keine technische Trennung.
Tenant-KatalogTabelle in der System-Datenbank, die entscheidet, ob ein Mandant überhaupt bedient wird (NEW, ACTIVE, DISABLED).
Tuple-ProjektionLadeverfahren der Persistenz: Statt ganzer Entitäten werden genau die angefragten Felder als Tuple gelesen und zur Entity zusammengesetzt.
Wildcard + / *Im Response Request: + lädt alle skalaren Felder, * zusätzlich alle Referenzen (jeweils nur mit id).