Kapitel III · Bereich 12 von 12

Dokumentation & Kommunikation

Die Frage an unseren ShopWie hält das Team fest, warum der Shop ein modularer Monolith bleibt?

Hier findest du Formate für verständliche Architekturbilder und nachvollziehbare Entscheidungen.

Drei Fragen an jede Architekturbeschreibung

  1. Warum gilt das, und was ist offen?

    Begründen

    Ein ADR hält fest, warum der Shop ein modularer Monolith bleibt; ein offenes Restore-Risiko erhält Verantwortliche und einen Prüfschritt.

  2. Wie sieht das System aus?

    Zeigen

    Die Containersicht zeigt Shop-Anwendung und Datenbank; ein Sequenzdiagramm zeigt Reservierung, Zahlung P-731 und Bestätigung von B-1042.

  3. Wo steht alles zusammen?

    Ordnen

    arc42 verbindet das Ziel für Bestellbestätigungen mit Zahlungsablauf, Rollout, ADR zur Modulstruktur und offenem Restore-Risiko.

So hängen die Bausteine zusammen

ADRs dokumentieren Entscheidungen, C4 erklärt statische Struktur, Sequenzdiagramme zeigen Abläufe und Verteilungssichten die Zuordnung zu Laufzeitumgebungen. arc42 ordnet diese Inhalte ein; ein Risikolog hält offene Unsicherheiten und nächste Prüfungen fest.

Vorlagearc42arc42 ordnet Anforderungen, Sichten, Entscheidungen und Risiken in einer Architekturbeschreibung.ArtefaktArchitecture Decision Recordhält Kontext, Gründe und Folgen einer Architekturentscheidung festModellC4-Modellliefert Strukturansichten auf abgestuften AbstraktionsebenenArtefaktSequenzdiagrammzeigt Reihenfolge und Verzweigungen einer LaufzeitinteraktionArtefaktVerteilungssichtordnet Bausteine den Knoten und Verbindungen ihrer Laufzeitumgebung zuAktivitätRisiken kommunizierenverknüpft offene Unsicherheiten mit Folgen, Besitzern und Prüfschritten
Zusammenhänge: Architecture Decision Record hält Kontext, Gründe und Folgen einer Architekturentscheidung fest; C4-Modell liefert Strukturansichten auf abgestuften Abstraktionsebenen; Sequenzdiagramm zeigt Reihenfolge und Verzweigungen einer Laufzeitinteraktion; Verteilungssicht ordnet Bausteine den Knoten und Verbindungen ihrer Laufzeitumgebung zu; Risiken kommunizieren verknüpft offene Unsicherheiten mit Folgen, Besitzern und Prüfschritten.

Dein Lernpfad durch den Bereich

Hier klärst du im Shop, wie das Team festhält, warum der Shop ein modularer Monolith bleibt. Daraus entwickelst du Entscheidungsnotizen, Strukturbilder und eine gemeinsame Beschreibung. Jeder Baustein zeigt sein Thema an unserem Shop.

  1. Das lernst duDu kannst einen ADR mit Kontext, verglichenen Architekturvarianten, Auswahlgründen und technischen Folgen vollständig ausfüllen.

    Im ShopDer Shop muss Bestell-, Zahlungs- und Versandlogik entwickeln und betreiben. Das Team entscheidet zwischen modularer Anwendung und unabhängig bereitgestellten Services.

    Architecture Decision Record öffnen
  2. C4-Modell

    Bilder

    Das lernst duDu kannst die C4-Ebene passend zur Frage auswählen und Systemgrenze, Container und Verantwortlichkeiten lesbar darstellen.

    Im ShopDer Shop ist ein System mit Browsern, einem externen Zahlungsanbieter und einer Shop-Anwendung. Eine Containeransicht zeigt Shop-Anwendung und Datenbank; erst die Komponentenebene zerlegt die Anwendung in Module.

    C4-Modell öffnen
  3. Das lernst duDu kannst Nachrichten in zeitlicher Reihenfolge darstellen und einen Fehlerpfad mit seinem sichtbaren Systemzustand ergänzen.

    Im ShopDer Shop reserviert eine Bestellung, autorisiert die Zahlung und bestätigt anschließend den Auftrag. Bei verlorener Antwort fragt er den bestehenden Zahlungsstatus ab.

    Sequenzdiagramm öffnen
  4. Das lernst duDu kannst Anwendung, Laufzeitknoten, Datenspeicher und externe Abhängigkeiten einer Verteilungssicht zuordnen.

    Im ShopDer modulare Shop läuft als Anwendung auf zwei Instanzen und nutzt eine verwaltete Datenbank. Die Zahlungsanbindung führt zu einem externen Anbieter.

    Verteilungssicht öffnen
  5. arc42

    Struktur

    Das lernst duDu kannst arc42-Abschnitte so verbinden, dass Qualitätsziele, Sichten, Entscheidungen und Risiken aufeinander verweisen.

    Im ShopDie Shopdokumentation verknüpft das Ziel für Bestellbestätigungen mit Zahlungsablauf, Rollout, ADR zur Modulstruktur und einem offenen Restore-Risiko.

    arc42 öffnen
  6. Das lernst duDu kannst ein Risiko mit Ursache, Ereignis, Auswirkung, Verantwortlichem und nächstem Prüfschritt konkret dokumentieren.

    Im ShopDas Team weiß, dass Bestellbackups existieren, hat den Restore mit Zahlungsabgleich aber noch nicht praktisch erprobt.

    Risiken kommunizieren öffnen