Seminar Credo TypeScript – Upgrade und Migration von Aries Framework JavaScript und Credo

Das zweitägige Seminar plant und erprobt Upgrades bestehender Aries-Framework-JavaScript- und Credo-Lösungen. Abhängigkeiten, ESM, Modulzuschnitt, DIDComm-Auslagerung, Wallet- und KMS-Änderungen, Persistenz, Datenmigration, API-Anpassungen, Tests, Cutover und Rollback werden kontrolliert bearbeitet.

Inhaltsverzeichnis

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

Lernziele

• Bestand, Versionen, Abhängigkeiten und technische Risiken vollständig erfassen.
• Quellcode- und Konfigurationsänderungen in eine geordnete Migrationsfolge überführen.
• Wallet-, KMS-, DIDComm- und Persistenzänderungen sicher behandeln.
• Daten- und Protokollkompatibilität automatisiert prüfen.
• Cutover, Rollback, Nachkontrolle und Betriebsübergabe vorbereiten.

Schrittweise Seminarinhalte

1. Bestandsaufnahme und Zielversion

Schwerpunkt: Anwendungsversionen, Pakete, Plattformen, Node.js, React Native, native Bibliotheken, Module, Custom Code, Datenbanken, Protokollpartner und Supportgrenzen.

1. Anwendungsfall, Schutzbedarf, Eingaben, Ausgaben und messbare Abnahmekriterien für den Themenblock „Bestandsaufnahme und Zielversion“ erfassen.
2. Die relevanten Objekte, Rollen, Datenflüsse und Abhängigkeiten anhand von Anwendungsversionen, Pakete, Plattformen, Node.js, React Native, native Bibliotheken, Module, Custom Code, Datenbanken, Protokollpartner und Supportgrenzen 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 vollständige Migrationsinventur dokumentieren, fachlich abnehmen und als wiederholbaren Entwicklungs- oder Betriebsstandard festhalten.

2. Abhängigkeits- und API-Differenzanalyse

Schwerpunkt: Paketnamen, Imports, ESM, Exports, Konstruktoren, Konfiguration, entfernte APIs, Typänderungen, Events, Fehlerklassen und Build-Werkzeuge.

1. Anwendungsfall, Schutzbedarf, Eingaben, Ausgaben und messbare Abnahmekriterien für den Themenblock „Abhängigkeits- und API-Differenzanalyse“ erfassen.
2. Die relevanten Objekte, Rollen, Datenflüsse und Abhängigkeiten anhand von Paketnamen, Imports, ESM, Exports, Konstruktoren, Konfiguration, entfernte APIs, Typänderungen, Events, Fehlerklassen und Build-Werkzeuge 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 priorisierte Anpassungsliste dokumentieren, fachlich abnehmen und als wiederholbaren Entwicklungs- oder Betriebsstandard festhalten.

3. Modulzuschnitt und DIDComm-Migration

Schwerpunkt: Core-Funktionen, explizite Protokollmodule, Transport, Out-of-Band, Connections, Mediation, Handler, Konfiguration und deaktivierte Funktionen.

1. Anwendungsfall, Schutzbedarf, Eingaben, Ausgaben und messbare Abnahmekriterien für den Themenblock „Modulzuschnitt und DIDComm-Migration“ erfassen.
2. Die relevanten Objekte, Rollen, Datenflüsse und Abhängigkeiten anhand von Core-Funktionen, explizite Protokollmodule, Transport, Out-of-Band, Connections, Mediation, Handler, Konfiguration und deaktivierte Funktionen 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 korrekt modularisierte Anwendung dokumentieren, fachlich abnehmen und als wiederholbaren Entwicklungs- oder Betriebsstandard festhalten.

4. Wallet- und KMS-Umstellung

Schwerpunkt: alte Wallet-Operationen, neue KMS-Abstraktionen, Key IDs, Algorithmen, Import, Export, Signatur, Key Agreement, Wallet Keys und Recovery-Grenzen.

1. Anwendungsfall, Schutzbedarf, Eingaben, Ausgaben und messbare Abnahmekriterien für den Themenblock „Wallet- und KMS-Umstellung“ erfassen.
2. Die relevanten Objekte, Rollen, Datenflüsse und Abhängigkeiten anhand von alte Wallet-Operationen, neue KMS-Abstraktionen, Key IDs, Algorithmen, Import, Export, Signatur, Key Agreement, Wallet Keys und Recovery-Grenzen 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 einen geprüften Schlüssel- und Wallet-Migrationspfad dokumentieren, fachlich abnehmen und als wiederholbaren Entwicklungs- oder Betriebsstandard festhalten.

5. Persistenz und Datenmigration

Schwerpunkt: Askar, Drizzle, SQLite, PostgreSQL, Record-Schemas, Tags, Indizes, Migrationen, Backups, Testkopien, Konsistenz und Rückwärtsgrenzen.

1. Anwendungsfall, Schutzbedarf, Eingaben, Ausgaben und messbare Abnahmekriterien für den Themenblock „Persistenz und Datenmigration“ erfassen.
2. Die relevanten Objekte, Rollen, Datenflüsse und Abhängigkeiten anhand von Askar, Drizzle, SQLite, PostgreSQL, Record-Schemas, Tags, Indizes, Migrationen, Backups, Testkopien, Konsistenz und Rückwärtsgrenzen 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 validierte Datenmigrationsfolge dokumentieren, fachlich abnehmen und als wiederholbaren Entwicklungs- oder Betriebsstandard festhalten.

6. Anwendungs- und Integrationsanpassungen

Schwerpunkt: REST-APIs, DTOs, Events, Webhooks, Tenant-Kontext, mobile Brücken, OpenID4VC, AnonCreds, Credential-Formate und Monitoring.

1. Anwendungsfall, Schutzbedarf, Eingaben, Ausgaben und messbare Abnahmekriterien für den Themenblock „Anwendungs- und Integrationsanpassungen“ erfassen.
2. Die relevanten Objekte, Rollen, Datenflüsse und Abhängigkeiten anhand von REST-APIs, DTOs, Events, Webhooks, Tenant-Kontext, mobile Brücken, OpenID4VC, AnonCreds, Credential-Formate und Monitoring 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 funktionsfähige Zielanwendung dokumentieren, fachlich abnehmen und als wiederholbaren Entwicklungs- oder Betriebsstandard festhalten.

7. Regression, Interoperabilität und Performance

Schwerpunkt: Golden Flows, gespeicherte Credentials, DIDComm-Beziehungen, externe Partner, Protokollprofile, Last, Speicher, Startzeit und Fehlerbilder.

1. Anwendungsfall, Schutzbedarf, Eingaben, Ausgaben und messbare Abnahmekriterien für den Themenblock „Regression, Interoperabilität und Performance“ erfassen.
2. Die relevanten Objekte, Rollen, Datenflüsse und Abhängigkeiten anhand von Golden Flows, gespeicherte Credentials, DIDComm-Beziehungen, externe Partner, Protokollprofile, Last, Speicher, Startzeit und Fehlerbilder 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 einen belastbaren Migrationsabnahmekatalog dokumentieren, fachlich abnehmen und als wiederholbaren Entwicklungs- oder Betriebsstandard festhalten.

8. Cutover, Rollback und Nachsorge

Schwerpunkt: Freeze, Backup, Migrationsfenster, Go oder No-Go, Rollback-Punkt, Datenkompatibilität, Monitoring, Support, Dokumentation und Altkomponentenabbau.

1. Anwendungsfall, Schutzbedarf, Eingaben, Ausgaben und messbare Abnahmekriterien für den Themenblock „Cutover, Rollback und Nachsorge“ erfassen.
2. Die relevanten Objekte, Rollen, Datenflüsse und Abhängigkeiten anhand von Freeze, Backup, Migrationsfenster, Go oder No-Go, Rollback-Punkt, Datenkompatibilität, Monitoring, Support, Dokumentation und Altkomponentenabbau 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 ausführbares Cutover- und Rollback-Runbook dokumentieren, fachlich abnehmen und als wiederholbaren Entwicklungs- oder Betriebsstandard festhalten.

Praxisübungen und Laborszenarien

• Erstellung einer Differenz- und Risikomatrix für eine Beispielanwendung.
• Anpassung von Imports, Modulkonfiguration und Agent Bootstrap.
• Migration ausgewählter Wallet- und KMS-Aufrufe.
• Testmigration einer persistenten Datenbankkopie.
• Simulation von Cutover, Abnahmekriterien und Rollback.

Zielgruppe und Voraussetzungen

Zielgruppe: Maintainer bestehender Aries-Framework-JavaScript- oder Credo-Anwendungen, TypeScript-Entwicklung, Softwarearchitektur, DevOps und technische Projektleitung.

Voraussetzungen: Gute Kenntnisse der bestehenden Anwendung, TypeScript und automatisierter Tests; Zugriff auf eine gesicherte Testkopie von Code und Daten ist hilfreich.

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.