// Softwarearchitektur

Architekturentscheidungen und Dokumentation als Code

Architecture Decision Records, Diagramme und Doku im Repository statt im Wiki-Friedhof.

  • Inhouse-Schulung
  • 1 Tag
  • Fortgeschritten
  • Remote oder vor Ort
  • KI-Werkzeug
Weißes Architekturmodell auf Transparentpapier mit Grundriss, daneben ein Zeichendreieck
Symbolbild · KI-generiert

Was Sie mitnehmen

  • Sie halten Architekturentscheidungen als Architecture Decision Records im Repository fest.
  • Sie schreiben Dokumentation mit AsciiDoc und erzeugen sie mit Asciidoctor im Build.
  • Sie erstellen Diagramme als Text mit PlantUML und versionieren sie mit dem Code.
  • Sie entwerfen Entscheidungsvorlagen und Diagramme mit KI und pflegen sie versioniert.

Agenda

Die Agenda ist die Grundlage. Schwerpunkte und Beispiele stimmen wir vorab auf Ihr Team ab.

Vormittag

  • Docs as Code: Prinzip, Ablage im Repository, Review per Pull Request
  • Architecture Decision Records: Aufbau, Status, Vorlagen
  • AsciiDoc-Grundlagen und Asciidoctor im Maven- oder Gradle-Build
  • Übung: ADRs für reale Entscheidungen aus dem eigenen Projekt schreiben

Nachmittag

  • Diagramme mit PlantUML: Komponenten, Sequenzen, C4-Erweiterung
  • Einbindung in Asciidoctor, Veröffentlichung über die CI-Pipeline
  • Entscheidungsvorlagen und Diagramme mit KI entwerfen und prüfen
  • Übung: Dokumentation mit Diagrammen im Build erzeugen

KI in dieser Schulung

// KI als Werkzeug im Entwicklungsalltag

Entscheidungsvorlagen und Diagramme mit KI entwerfen und versioniert pflegen.

Voraussetzungen und Rahmen

Vorwissen
Erfahrung in der Java-Entwicklung und mit Git. Für den KI-Teil ein lokales Modell mit Ollama und Continue, Hardware vorab klären.
Werkzeuge
Asciidoctor, PlantUML (Open Source, MIT / GPL 3.0)
Niveau
Fortgeschritten
Teilnehmende
bis 10 Personen, größere Gruppen auf Anfrage
Durchführung
Remote per Videokonferenz oder bei Ihnen vor Ort
Enthalten
Abstimmung vorab, Unterlagen, Übungsprojekte, Teilnahmebescheinigungen

// Trainer mit langjähriger Softwareentwicklungserfahrung, akademische Ausbildung in Informatik und KI.