Glossar
Begriffe, die in CodamAI eine feste Bedeutung haben. Alphabetisch.
| Begriff | Bedeutung |
|---|---|
| Abstraktes Modell | Modell, das selbst nicht instanziierbar ist und mehrere konkrete Untertypen hat. Wird über einen Hub-Router abgefragt, siehe Vererbung. |
@type / _MODELTYPE | Diskriminator, der bei abstrakten Modellen den konkreten Untertyp benennt. Im JSON @type, in der Datenbank die Spalte _MODELTYPE. |
| AbstractLayer | Basisklasse des System-Layers mit der gesamten Rekursion für Create, Update, Patch, Read und Delete. Rund 1.700 Zeilen – das fachliche Herzstück. |
| ADR | Architecture Decision Record – eine festgehaltene Architekturentscheidung samt Begründung und Alternativen. |
| Attributfilter | Datenfilter, der ein Benutzerprofil-Attribut (z. B. projects) gegen ein Datenfeld prüft. Siehe Attributbasierte Filter. |
| Blueprint | Beschreibung eines Soll-Schemas für den MCP-Server. Wird validiert, geplant, freigegeben und angewendet. |
| BFF | Backend for Frontend. Die Nitro-Serverschicht der Nuxt-Frontends, die die CDMS-API kapselt und den Token setzt. |
| CDMS | CodamAI Data Management System – die modellgetriebene Backend-Basis. |
| Change Set | Eingefrorener, freigabepflichtiger Änderungsplan im MCP-Server. Genau einmal anwendbar. |
| CIAS | CodamAI Identity & Access System – Authentifizierung, Token, Rollen, Mandanten-Kontext. |
| CreateReadMode | STRICT oder LENIENT: entscheidet, ob ein fehlgeschlagenes Zurücklesen nach einem Create das Create zurückrollt. Siehe Transaktionen. |
| DataView | Read-only-Sicht auf berechnete/aggregierte Daten (Konzept; im aktuellen Code nicht ausgebaut). |
| DTO | Antwortmodell. Wird aus der Entity gemappt und an den Client geliefert. |
| Effektiver Tenant | Der Mandant, der für die aktuelle Anfrage tatsächlich gilt: aus dem Token, ggf. durch einen autorisierten Kontextwechsel überschrieben. |
| Entity | JPA-Persistenzmodell. Erbt je nach Einordnung von AbstractSystemModel, AbstractTenantModel oder AbstractUserModel. |
| Envers | Hibernate Envers – die Auditing-Bibliothek, die Revisionstabellen führt. |
| Expander | Komponente im REST-Layer, die den Response Request des Clients auflöst: Wildcards expandieren, Felder prüfen, verschachtelte Anfragen rekursiv aufbauen. |
| Hook | Erweiterungspunkt für Businesslogik vor/nach Datenbankzugriffen, auf Klassen- oder Feldebene. Siehe Hooks. |
| Hub | Das zentrale CDMS, in dem die Datenmodelle aller CDMS-Systeme gepflegt werden. Nicht zu verwechseln mit der Hub-API. |
| Hub-API | Generierter Router-Controller für ein abstraktes Modell; verteilt Requests an die APIs der konkreten Untertypen. |
| MCP | Model Context Protocol. Der MCP-Server des Hubs erlaubt KI-Clients das Lesen des Meta-Modells und kontrollierte Schemaänderungen. |
| Meta / MetaService | Generierte 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 Context | Bindet im MCP-Server alle Aufrufe einer Änderungsabsicht unveränderlich an genau ein Ziel-CDMS. |
| Owner-Filter | Automatischer Filter auf _userId bei benutzereigenen Modellen. Liegt im System-Layer. |
| Payload | Eingabemodell der API: CreatePayload, UpdatePayload, PatchPayload, jeweils verpackt in WritePayload. |
| Persistenzziel | System-Datenbank oder Tenant-Datenbank. Wird pro Entity-Typ aufgelöst. |
| Recursive-Typen | Pro Beziehung konfigurierte Erlaubnis, ob CDMS über sie hinweg anlegen (CREATE), ändern (UPDATE), lesen (READ) oder löschen (DELETE) darf. |
| Response Request | Die response-Sektion eines Payloads: bestimmt, welche Felder und Beziehungen die Antwort enthält. |
| Revision | Ein Auditing-Eintrag zu einem Objektstand, mit Nummer, Zeitpunkt, Benutzer, IP und User-Agent. |
| Singleton | Modell, von dem es pro Scope (System/Tenant/User) genau ein Objekt gibt. Kein Suchendpunkt, keine sichtbare ID. |
| Strict Mode | Fehlerverhalten bei unzulässigen Anfragen: strikt = Fehler, tolerant = still ignorieren. Siehe Strict Mode. |
| System-Layer | Schicht zwischen REST und Persistenz: Rekursion, Validierung, Hooks, Sicherheitsfilter, Orchestrierung. |
| Tenant | Mandant. In Betriebsart MULTI eine eigene Datenbank, in SINGLE existiert keine technische Trennung. |
| Tenant-Katalog | Tabelle in der System-Datenbank, die entscheidet, ob ein Mandant überhaupt bedient wird (NEW, ACTIVE, DISABLED). |
| Tuple-Projektion | Ladeverfahren 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). |