Seminar TypeScript Professional – Architektur und Domain Modeling

Wachsende Anwendungen benötigen mehr als korrekt annotierte Funktionen. Im Mittelpunkt steht eine Struktur, in der fachliche Regeln unabhängig von HTTP, Datenbank und Benutzeroberfläche nachvollziehbar bleiben. Ein bestehender Buchungsdienst wird schrittweise in klar abgegrenzte Module überführt. Dabei werden die Folgen jeder Entwurfsentscheidung für Änderbarkeit, Fehlersuche und Tests untersucht.

Das Seminar verbindet strukturelle Typisierung mit Domain Modeling und einer pragmatischen Anwendung von Ports und Adaptern. Interfaces werden dort eingesetzt, wo sie tatsächlich Verträge ausdrücken. Klassen, reine Funktionen und unveränderliche Daten werden nach ihrem konkreten Nutzen ausgewählt. Ein Architekturreview prüft, ob die vereinbarten Grenzen auch bei einer späteren Erweiterung erhalten bleiben.

Lernziele

• Fachliche Zustände und Invarianten mit aussagekräftigen Typen modellieren.
• Modulgrenzen, öffentliche APIs und Abhängigkeitsrichtungen begründet festlegen.
• Infrastruktur über Ports, Adapter und explizite Komposition anbinden.
• Technische Fehler und fachliche Ablehnungen konsistent behandeln.
• Architekturregeln durch Tests und automatisierte Importkontrollen absichern.

Zielgruppe

Erfahrene TypeScript-Entwickler, Softwarearchitekten und technische Teamleiter mit Verantwortung für größere Anwendungen.

Voraussetzungen

Sichere TypeScript-Grundlagen einschließlich Union Types, Narrowing, Generics und ES-Modulen; Erfahrung mit automatisierten Tests. Empfohlen: Grundlagen und Sprachpraxis sowie Fortgeschrittenes Typsystem und Generics.

Inhaltsübersicht

1. Fachliche Modelle und Invarianten
2. Module und Abhängigkeiten
3. Verträge, Fehler und Adapter
4. Refactoring und Architekturprüfung

Seminarinhalte

Fachliche Modelle und Invarianten

• Anwendungsfälle, Zustände und Verantwortlichkeiten aus einem Buchungsprozess ableiten.
• Value Objects, validierende Fabrikfunktionen und markierte Typen für fachliche Kennungen entwerfen.
• Zulässige Zustandsübergänge als diskriminierte Vereinigungen und explizite Operationen ausdrücken.
• Grenzen rein statischer Garantien und erforderliche Laufzeitprüfungen dokumentieren.

Module und Abhängigkeiten

• Fachmodule anhand von Änderungsgründen und Datenverantwortung schneiden.
• Öffentliche Exporte begrenzen und zyklische Abhängigkeiten erkennen.
• Reine Geschäftslogik von I/O und Framework-Lebenszyklen trennen.
• Dependency Injection über Konstruktoren oder Funktionsparameter und einen Composition Root umsetzen.

Verträge, Fehler und Adapter

• Ports für Persistenz, Zeit und externe Dienste mit kleinen Verträgen definieren.
• Ergebnisobjekte und Exceptions nach Fehlerart und Aufrufgrenze einsetzen.
• Transaktionsgrenzen, Nebenläufigkeit und Wiederholbarkeit fachlich einordnen.
• Einen vorhandenen Infrastrukturadapter austauschen, ohne das Domänenmodell anzupassen.

Refactoring und Architekturprüfung

• Verhaltenssichernde Tests vor dem Umbau eines gekoppelten Moduls ergänzen.
• Refactoring in kleine, kompilierbare und überprüfbare Schritte zerlegen.
• Unerlaubte Importe und unbeabsichtigte öffentliche Exporte automatisiert erkennen.
• Eine neue Geschäftsregel implementieren und den Entwurf anhand des Änderungsumfangs bewerten.

Praxisprojekt

Die praktische Arbeit folgt einer zusammenhängenden Aufgabenstellung. Die folgenden Schritte werden anhand vorbereiteter Ausgangsstände umgesetzt und mit überprüfbaren Zwischenständen verbunden.

1. Den vorbereiteten Buchungsdienst ausführen, bestehende Tests prüfen und Abhängigkeiten aufnehmen.
2. Buchungsstatus und Kennungen modellieren; ungültige Zustände durch gezielte Gegenbeispiele sichtbar machen.
3. Persistenz- und Zeitabhängigkeiten über Ports aus der Geschäftslogik herauslösen.
4. Einen In-Memory-Adapter ergänzen und die Geschäftsregeln ohne Datenbank testen.
5. Eine Stornierungsregel einbauen und automatisierte Kontrollen für die Modulgrenzen ausführen.
6. Die Änderungen anhand von Fehlerverträgen, Kopplung und Testbarkeit im Code-Review beurteilen.

Schulungsumgebung

Vorbereitetes TypeScript-Projekt mit Tests, lokalem Repository und austauschbaren Infrastrukturadaptern. Die Übungen benötigen keine produktiven Zugänge.

Die Schulungsumgebung wird vom Kunden nach der vorab abgestimmten technischen Checkliste bereitgestellt. Benötigte Installationsrechte, Werkzeuge und Übungsstände werden vor Seminarbeginn geprüft.