CRMS beim Start

Worum es geht

Eingebettet hat CRMS keinen eigenen Kaltstart. Es fährt im Start der CDMS-Anwendung mit hoch, im selben Prozess und in derselben Reihenfolge wie CDMS und CIAS. Als eigener Dienst hat es einen eigenen Start, der genauso aussieht, nur ohne die Modelle von CDMS daneben.

Wie der Start von CDMS und CIAS insgesamt abläuft, steht unter Kaltstart einer Installation. Diese Seite zeigt, was CRMS dazu beiträgt.

Der Zeitstrahl

flowchart LR
    A["1 Platzierung<br/>Eigenschaft gegen Klassenpfad"] --> B["2 Kontext<br/>Pflichtangaben, Schlüssel, Bucket"]
    B --> C["3 Tabellen<br/>System- und Mandanten-DB"]
    C --> D["4 Vorlagen<br/>mitgelieferte einspielen"]
    D --> E["5 Zeitgeber<br/>Ankerlauf, Aufbewahrung"]
    E --> F(["bereit für den ersten Bericht"])
    classDef stufe fill:#ffc107,stroke:#b38600,color:#1f1a00
    classDef ziel fill:#4d7c0f,stroke:#4d7c0f,color:#fff
    class A,B,C,D,E stufe
    class F ziel

Stufe 3 ist kein fester Zeitpunkt. Die Tabellen einer Datenbank entstehen, wenn sie zum ersten Mal gebraucht wird, wie bei CDMS. Für die System-Datenbank ist das spätestens beim Einspielen der Vorlagen.

Die fünf Stufen

Stufe 2: Was den Start abbricht

Die Liste aller Variablen und wann welche Pflicht ist, steht unter Umgebungsvariablen. Den Zeitstempel-Schlüssel erklärt Zeitstempel und Anker.

Stufe 3: Wo die CRMS-Tabellen landen

CRMS hat keinen eigenen Datenbankweg. Es nutzt die gemeinsame Datenbankschicht von CodamAI, dieselbe wie bei CDMS, und meldet seine Entities dort zweimal an: einmal für die System-Datenbank, einmal für jede Mandanten-Datenbank. Jede Datenbank bekommt also dieselben crms_…-Tabellen. Welche Zeile wohin kommt, entscheidet, wem sie gehört.

In SINGLE ist das eine Datenbank. Die Dateien der endgültigen Dokumente liegen nicht in der Datenbank, sondern im S3-Bucket.

Anders als bei CIAS gibt es dafür keinen eigenen Migrationslauf. Die Tabellen entstehen auf demselben Weg wie die der CDMS-Modelle, beim ersten Zugriff auf die jeweilige Datenbank. Nach einem Update wird also auch eine Mandanten-Datenbank erst angehoben, wenn dieser Mandant arbeitet oder ein Zeitgeber ihn besucht. Einzelheiten unter Die Datenbank und Datenbanken und Schemata.

Stufe 4: Mitgelieferte Vorlagen einspielen

CRMS liest keinen Vorlagenordner von selbst. Bringt eine Anwendung Vorlagen in ihrem Build mit, spielt die Anwendung sie ein. Das Hub-Backend tut das für seine Projektdokumente, sobald es sich als bereit meldet:

Scheitert das Einspielen, steht das im Log, und der Start läuft weiter. Alles andere der Anwendung funktioniert ohne die Vorlagen. Ein Bericht, der sie braucht, antwortet bis zum nächsten erfolgreichen Einspielen mit template-not-found. Den ganzen Weg zeigt Mitgelieferte Vorlagen.

Stufe 5: Der erste Ankerlauf

Verankern heißt: CRMS lässt den letzten Stand jedes Journals mit einem Zeitstempel bestätigen. So lässt sich später nichts unbemerkt umschreiben.

Der erste Lauf beginnt eine Minute nach dem Start, danach alle CODAMAI_CRMS_ANCHOR_INTERVAL (stündlich). Der Aufbewahrungslauf, der abgelaufene Dokumente entfernt, folgt demselben Muster mit einem Abstand von 24 Stunden. Beide sind an, sobald CRMS eingebettet ist. Bei CIAS ist das umgekehrt: Seine Zeitgeber sind aus, bis jemand sie einschaltet. Der Grund ist, dass Verankern und Aufbewahren Pflichten sind und keine Wartung.

Bei mehreren Instanzen derselben Anwendung lässt du die Zeitgeber in genau einer an (CODAMAI_CRMS_SCHEDULING_ENABLED). Wie ein Anker aufgebaut ist, steht unter Zeitstempel und Anker.

CRMS meldet seine Rollen an

In Stufe 4 des Kaltstarts liest CIAS die Deklarationen der Module, also die Listen ihrer Rollen und Attribute, und legt daraus Rollen in Keycloak an. Ein eingebettetes CRMS steht in dieser Liste als Modul crms, neben cias und cdms. Seine Deklaration ist die Bean crmsIdentityRegistry, und der Projektrahmen trägt sie ein.

Daraus folgt:

• Was nicht genutzt wird, kommt nicht dazu. Ein Scope, den die Installation nicht zulässt, und Dokumente, die sie nicht ablegt, melden keine Rolle an. Der Hub lässt nur Systemvorlagen zu und legt keine Dokumente ab, seine Liste ist darum leer.
• Der Abgleich legt die Rollen an als Client-Rollen am Client der Anwendung, wie die von CDMS. Vergeben musst du sie wie jede andere Rolle.
• Ein neuer Name ersetzt den alten. Nennt die Installation eine Rolle um, meldet CRMS den neuen Namen an. Den alten legt der Abgleich still, statt ihn zu löschen. Siehe Module melden Rollen und Attribute an.
• Plattformrollen meldet CRMS nie an. Systemvorlagen schreiben die Plattform-Administratoren, die CIAS für die Installation nennt. Siehe Die Realm-Rollen der Plattform.
• Ein eigener CRMS-Dienst meldet nichts an. Seine Rollen gehören zum Client des CRMS-Dienstes. Dort legst du sie selbst an.

Wo du die Rollennamen einstellst, steht unter Die Rollen.

Die Ausprägungen

Fallen

Weiter

• Kaltstart einer Installation: der Start von CDMS und CIAS
• Datenbanken und Schemata und Module melden Rollen und Attribute an
• CRMS in den Betriebsarten
• Umgebungsvariablen und Die Datenbank
• Mitgelieferte Vorlagen und Zeitstempel und Anker