Kurs · Schulung · Workshop
Hands-on Software Architecture
Praxisnaher Architektur-Kurs: Architektur sichtbar machen mit dem Architecture Canvas, Entscheide festhalten mit Architecture Decision Records (ADR) und Schnittstellen API-first dokumentieren – herstellerneutral und direkt anwendbar.
Zwei Tage praktische Softwarearchitektur an der Schnittstelle von Business und Technik. Statt dicker Konzeptpapiere entstehen leichtgewichtige, lebendige Artefakte: ein Architecture Canvas, das die wichtigsten Bausteine und Zusammenhänge auf einer Seite zeigt, Architecture Decision Records (ADR), die festhalten warum eine Entscheidung getroffen wurde, und API-first dokumentierte Schnittstellen. Herstellerneutral und auf jede Sprache und jedes Framework übertragbar. Am Ende nimmst du ausgefüllte Artefakte für dein eigenes System mit.
Trainer
Stimmen unserer Teilnehmer:innen






Diese Kunden haben Kurse im gleichen Themen-Cluster bei uns gebucht.Mehr Kunden →
Inhalt
Softwarearchitektur scheitert selten am fehlenden Wissen, sondern an fehlender Orientierung: Niemand sieht das grosse Ganze auf einen Blick, wichtige Entscheide sind nur in den Köpfen einzelner, und Schnittstellen sind unklar dokumentiert. Das Team umgeht dann lieber die Architektur, statt sie weiterzuentwickeln.
In diesem Kurs baust du an einem vorbereiteten Beispielsystem ein kleines, aber wirkungsvolles Set an Artefakten auf, das genau diese Orientierung schafft – herstellerneutral und auf jede Sprache und jedes Framework übertragbar. Der Kurs kann an die Bedürfnisse deines Teams angepasst und als In-House-Schulung auch am eigenen System durchgeführt werden.
– Architektur sichtbar machen:
- Das Architecture Communication Canvas: Bausteine, Qualitätsziele und Kontext einer Architektur auf einer Seite darstellen
- Blick von aussen nach innen: System-Kontext, wichtigste Bausteine und deren Zusammenspiel
- Hands-On: Für das Beispielsystem gemeinsam ein Architecture Canvas ausfüllen
– Architektur-Entscheide festhalten:
- Warum statt Was: Architecture Decision Records (ADR) als nachvollziehbares Entscheidungslog
- Ein ADR schreiben: Kontext, Optionen, Entscheid und Konsequenzen
- Leitplanken statt starrer Vorgaben: welche Regeln bei Änderungen gelten
- Hands-On: Zu einer konkreten Entscheidung im Beispielsystem ein ADR verfassen und im Team challengen
– Schnittstellen API-first dokumentieren:
- API-first: die Schnittstelle vor der Implementierung entwerfen
- OpenAPI als herstellerneutrales Format für lesbare, versionierbare API-Dokumentation
- Verträge zwischen Teams: wie klare Schnittstellen die Zusammenarbeit entkoppeln
- Hands-On: Eine API des Beispielsystems API-first mit OpenAPI beschreiben
– Business und Tech verbinden:
- Architektur als Brücke zwischen Geschäftswert und technischer Umsetzung
- Die Artefakte in der täglichen Arbeit lebendig halten, statt sie veralten zu lassen
- Architektur kommunizieren: dieselbe Sicht für Business, Product und Entwicklung
- Hands-On: Die erstellten Artefakte für ein Zielpublikum aufbereiten und präsentieren
Am Ende des Kurses hast du ein ausgefülltes Architecture Canvas, mehrere ADR und eine API-first-Dokumentation erstellt – und weisst, wie du diese Artefakte in deinem eigenen Team einführst und lebendig hältst.
Der effektive Kursinhalt kann, abhängig von Trainer, Durchführung, Dauer und Konstellation der Teilnehmer:innen, von obigen Angaben abweichen.
In-House Kurs anfragen
Öffentlichen Termin anfragen
Kein passender öffentlicher Termin dabei? Trag dich unverbindlich ein – sobald genug Interesse besteht, planen wir einen neuen öffentlichen Termin und informieren dich zuerst.
Mehr über Software Architecture, ADR und Architecture Canvas
Gute Softwarearchitektur zeigt sich weniger in umfangreichen Dokumenten als in wenigen, gezielten Artefakten, die Entscheidungen leicht machen: eine Übersicht der Bausteine, klare Leitplanken und ein nachvollziehbares Entscheidungslog. Architecture Decision Records (ADR), das Architecture Communication Canvas und API-first-Dokumentation bilden zusammen ein leichtgewichtiges, herstellerneutrales Set, das Business und Technik auf einen gemeinsamen Nenner bringt.Weitere Ressourcen:
History
Architecture Decision Records wurden 2011 von Michael Nygard populär gemacht und etablierten sich als einfache, versionierbare Methode, um Architektur-Entscheide nachvollziehbar festzuhalten – nahe am Code statt in einem separaten Dokumentenarchiv.
Das Architecture Communication Canvas entstand im Umfeld von arc42 rund um Gernot Starke als eine Seite, die eine Architektur kompakt kommuniziert. Ergänzt durch den API-first-Ansatz mit OpenAPI (aus Swagger, seit 2010) ergibt sich ein pragmatisches Set an lebendigen Artefakten für moderne, teamorientierte Softwareentwicklung.
