Seminar Credo TypeScript – Custom Modules, Dependency Injection und Erweiterungen

Das zweitägige Seminar behandelt die strukturierte Erweiterung von Credo durch eigene Module, Services, Repositorys, Events und Plattformadapter. Der Schwerpunkt liegt auf sauberer Dependency Injection, stabilen Schnittstellen, Testbarkeit, Versionsgrenzen und wartbaren Integrationen.

Inhaltsverzeichnis

• Lernziele und fachliche Einordnung
• Schrittweise Seminarinhalte
• Praxisübungen und Laborszenarien
• Zielgruppe und Voraussetzungen
• Didaktik und Arbeitsweise

Lernziele

• Die Modul- und Dependency-Injection-Architektur von Credo sicher nutzen.
• Eigene Konfigurationen, Services und Provider mit klaren Lebenszyklen entwickeln.
• Repositorys, Records, Events und Plattformadapter integrieren.
• Erweiterungen gegen interne Implementierungsdetails entkoppeln.
• Custom Modules automatisiert testen, paketieren und versionieren.

Schrittweise Seminarinhalte

1. Modulgrenzen und Erweiterungsstrategie

Schwerpunkt: fachliche Verantwortung, öffentliche APIs, interne Implementierungen, Kopplung, Abhängigkeiten, Lebenszyklen, Fehlergrenzen und Versionsrisiken.

1. Anwendungsfall, Schutzbedarf, Eingaben, Ausgaben und messbare Abnahmekriterien für den Themenblock „Modulgrenzen und Erweiterungsstrategie“ erfassen.
2. Die relevanten Objekte, Rollen, Datenflüsse und Abhängigkeiten anhand von fachliche Verantwortung, öffentliche APIs, interne Implementierungen, Kopplung, Abhängigkeiten, Lebenszyklen, Fehlergrenzen und Versionsrisiken modellieren und verbindliche Konfigurationsentscheidungen festlegen.
3. Die erforderlichen TypeScript-Komponenten, Credo-Module, Provider, Konfigurationen oder Prozessschritte in einer kontrollierten Laborumgebung implementieren.
4. Funktion, Berechtigungen, Schlüsselverwendung, Protokollzustände, Datenpersistenz und Fehlerverhalten mit definierten Positiv- und Negativfällen prüfen.
5. Als Arbeitsergebnis ein freigegebenes Erweiterungsdesign dokumentieren, fachlich abnehmen und als wiederholbaren Entwicklungs- oder Betriebsstandard festhalten.

2. Moduldefinition und Konfiguration

Schwerpunkt: Modulklasse, Konfigurationsobjekte, Standardwerte, Validierung, Registrierungszeitpunkt, Initialisierung, Shutdown und Dokumentation.

1. Anwendungsfall, Schutzbedarf, Eingaben, Ausgaben und messbare Abnahmekriterien für den Themenblock „Moduldefinition und Konfiguration“ erfassen.
2. Die relevanten Objekte, Rollen, Datenflüsse und Abhängigkeiten anhand von Modulklasse, Konfigurationsobjekte, Standardwerte, Validierung, Registrierungszeitpunkt, Initialisierung, Shutdown und Dokumentation modellieren und verbindliche Konfigurationsentscheidungen festlegen.
3. Die erforderlichen TypeScript-Komponenten, Credo-Module, Provider, Konfigurationen oder Prozessschritte in einer kontrollierten Laborumgebung implementieren.
4. Funktion, Berechtigungen, Schlüsselverwendung, Protokollzustände, Datenpersistenz und Fehlerverhalten mit definierten Positiv- und Negativfällen prüfen.
5. Als Arbeitsergebnis ein installierbares Custom Module dokumentieren, fachlich abnehmen und als wiederholbaren Entwicklungs- oder Betriebsstandard festhalten.

3. Dependency Injection und Provider

Schwerpunkt: Tokens, Klassen, Factorys, Singleton- und Context-Lebenszyklen, optionale Abhängigkeiten, Overrides, Test-Doubles und zirkuläre Abhängigkeiten.

1. Anwendungsfall, Schutzbedarf, Eingaben, Ausgaben und messbare Abnahmekriterien für den Themenblock „Dependency Injection und Provider“ erfassen.
2. Die relevanten Objekte, Rollen, Datenflüsse und Abhängigkeiten anhand von Tokens, Klassen, Factorys, Singleton- und Context-Lebenszyklen, optionale Abhängigkeiten, Overrides, Test-Doubles und zirkuläre Abhängigkeiten modellieren und verbindliche Konfigurationsentscheidungen festlegen.
3. Die erforderlichen TypeScript-Komponenten, Credo-Module, Provider, Konfigurationen oder Prozessschritte in einer kontrollierten Laborumgebung implementieren.
4. Funktion, Berechtigungen, Schlüsselverwendung, Protokollzustände, Datenpersistenz und Fehlerverhalten mit definierten Positiv- und Negativfällen prüfen.
5. Als Arbeitsergebnis eine kontrollierte Serviceverdrahtung dokumentieren, fachlich abnehmen und als wiederholbaren Entwicklungs- oder Betriebsstandard festhalten.

4. Services, Commands und fachliche APIs

Schwerpunkt: Anwendungsservices, Eingabe- und Ergebnisobjekte, Fehlerklassen, Transaktionen, Idempotenz, Berechtigungsgrenzen und Telemetrie.

1. Anwendungsfall, Schutzbedarf, Eingaben, Ausgaben und messbare Abnahmekriterien für den Themenblock „Services, Commands und fachliche APIs“ erfassen.
2. Die relevanten Objekte, Rollen, Datenflüsse und Abhängigkeiten anhand von Anwendungsservices, Eingabe- und Ergebnisobjekte, Fehlerklassen, Transaktionen, Idempotenz, Berechtigungsgrenzen und Telemetrie modellieren und verbindliche Konfigurationsentscheidungen festlegen.
3. Die erforderlichen TypeScript-Komponenten, Credo-Module, Provider, Konfigurationen oder Prozessschritte in einer kontrollierten Laborumgebung implementieren.
4. Funktion, Berechtigungen, Schlüsselverwendung, Protokollzustände, Datenpersistenz und Fehlerverhalten mit definierten Positiv- und Negativfällen prüfen.
5. Als Arbeitsergebnis eine stabile fachliche Modulschnittstelle dokumentieren, fachlich abnehmen und als wiederholbaren Entwicklungs- oder Betriebsstandard festhalten.

5. Records, Repositorys und Persistenz

Schwerpunkt: Record-Design, Tags, Abfragen, Migrationen, Repository-Abstraktion, Tenant-Kontext, Verschlüsselung, Löschung und Datenintegrität.

1. Anwendungsfall, Schutzbedarf, Eingaben, Ausgaben und messbare Abnahmekriterien für den Themenblock „Records, Repositorys und Persistenz“ erfassen.
2. Die relevanten Objekte, Rollen, Datenflüsse und Abhängigkeiten anhand von Record-Design, Tags, Abfragen, Migrationen, Repository-Abstraktion, Tenant-Kontext, Verschlüsselung, Löschung und Datenintegrität modellieren und verbindliche Konfigurationsentscheidungen festlegen.
3. Die erforderlichen TypeScript-Komponenten, Credo-Module, Provider, Konfigurationen oder Prozessschritte in einer kontrollierten Laborumgebung implementieren.
4. Funktion, Berechtigungen, Schlüsselverwendung, Protokollzustände, Datenpersistenz und Fehlerverhalten mit definierten Positiv- und Negativfällen prüfen.
5. Als Arbeitsergebnis eine testbare Persistenzerweiterung dokumentieren, fachlich abnehmen und als wiederholbaren Entwicklungs- oder Betriebsstandard festhalten.

6. Events, Hooks und Plattformadapter

Schwerpunkt: Event-Typen, Payloads, Reihenfolge, Wiederholungen, Listener-Isolation, native oder serverseitige Adapter, Timeouts und Fehlerbehandlung.

1. Anwendungsfall, Schutzbedarf, Eingaben, Ausgaben und messbare Abnahmekriterien für den Themenblock „Events, Hooks und Plattformadapter“ erfassen.
2. Die relevanten Objekte, Rollen, Datenflüsse und Abhängigkeiten anhand von Event-Typen, Payloads, Reihenfolge, Wiederholungen, Listener-Isolation, native oder serverseitige Adapter, Timeouts und Fehlerbehandlung modellieren und verbindliche Konfigurationsentscheidungen festlegen.
3. Die erforderlichen TypeScript-Komponenten, Credo-Module, Provider, Konfigurationen oder Prozessschritte in einer kontrollierten Laborumgebung implementieren.
4. Funktion, Berechtigungen, Schlüsselverwendung, Protokollzustände, Datenpersistenz und Fehlerverhalten mit definierten Positiv- und Negativfällen prüfen.
5. Als Arbeitsergebnis eine lose gekoppelte Integrationsarchitektur dokumentieren, fachlich abnehmen und als wiederholbaren Entwicklungs- oder Betriebsstandard festhalten.

7. Tests, Paketierung und Versionspflege

Schwerpunkt: Unit- und Integrationstests, Agent-Testkontext, Vertragsprüfungen, Paketexports, ESM, SemVer, Changelog, Migrationshinweise und Kompatibilitätsmatrix.

1. Anwendungsfall, Schutzbedarf, Eingaben, Ausgaben und messbare Abnahmekriterien für den Themenblock „Tests, Paketierung und Versionspflege“ erfassen.
2. Die relevanten Objekte, Rollen, Datenflüsse und Abhängigkeiten anhand von Unit- und Integrationstests, Agent-Testkontext, Vertragsprüfungen, Paketexports, ESM, SemVer, Changelog, Migrationshinweise und Kompatibilitätsmatrix modellieren und verbindliche Konfigurationsentscheidungen festlegen.
3. Die erforderlichen TypeScript-Komponenten, Credo-Module, Provider, Konfigurationen oder Prozessschritte in einer kontrollierten Laborumgebung implementieren.
4. Funktion, Berechtigungen, Schlüsselverwendung, Protokollzustände, Datenpersistenz und Fehlerverhalten mit definierten Positiv- und Negativfällen prüfen.
5. Als Arbeitsergebnis ein veröffentlichungsreifes Erweiterungspaket dokumentieren, fachlich abnehmen und als wiederholbaren Entwicklungs- oder Betriebsstandard festhalten.

Praxisübungen und Laborszenarien

• Entwicklung eines eigenen Moduls mit Konfiguration, Service und öffentlicher API.
• Registrierung austauschbarer Provider und eines Test-Doubles.
• Implementierung eines eigenen Records mit Repository und Migration.
• Ausgabe eines fachlichen Events und robuste Verarbeitung durch einen Listener.
• Erstellung eines Paket- und Kompatibilitätstests.

Zielgruppe und Voraussetzungen

Zielgruppe: Fortgeschrittene TypeScript-Entwicklung, Softwarearchitektur, Plattformteams, Integrationsentwicklung und Maintainer eigener Credo-Erweiterungen.

Voraussetzungen: Gute TypeScript- und Credo-Kenntnisse; Erfahrung mit Dependency Injection, Paketierung und automatisierten Tests.

Didaktik und Arbeitsweise

Kurze Fachimpulse werden unmittelbar mit Demonstrationen, strukturierten Implementierungsschritten, Code-Reviews, praktischen Übungen und kontrollierten Fehlerfällen verbunden. Jede Übung verwendet definierte Ausgangswerte, Prüfpunkte und Dokumentationsanforderungen, damit die erarbeiteten Lösungen reproduzierbar weiterentwickelt und in den Betrieb überführt werden können.