arc42
arc42 ist eine Gliederung für Architekturbeschreibungen. Sie verbindet Anforderungen, Lösungsstrategie, Bausteine, Laufzeit, Deployment, Entscheidungen und Risiken.
- ZieleQualitätsziel am Anfang.
- SichtenStruktur und Laufzeit.
- VerweiseEntscheidungen und Risiken verbinden.
Einordnung
Warum das wichtig ist
Gute Einzeldiagramme helfen wenig, wenn niemand sieht, wie Ziel, Struktur, Ablauf, Entscheidung und Risiko zusammenhängen. arc42 gibt diesen Dingen feste Plätze, die aufeinander verweisen. Einzelne Sichten haben eigene Bausteine.
Dieser Baustein zeigt die Struktur und Querverbindungen einer Architekturbeschreibung. C4 und Sequenzdiagramme liefern mögliche Sichten; ADRs halten einzelne Entscheidungen fest.
Auf einen Blick · arc42 als Gliederung
Ausgefüllte arc42-Bausteine für den Shop
Die Shopdokumentation verknüpft das Ziel für Bestellbestätigungen mit Zahlungsablauf, Rollout, ADR zur Modulstruktur und einem offenen Restore-Risiko.
So liest du das Bild
- Ziele Abschnitt „Kontext und Ziele“: Bestellbestätigungen im vereinbarten Zeitbudget sichtbar.
- Sichten Abschnitte „Bausteinsicht“ und „Laufzeitsicht“: Bestellung, Zahlung und Versand mit dem Zahlungsablauf.
- Verweise Abschnitte „Entscheidungen“ (ADR-01) und „Risiken“ (Restore-Dauer ungemessen).
- Kontext und Ziele
- Bestellbestätigungen sollen innerhalb des vereinbarten Zeitbudgets sichtbar sein; der Zahlungsanbieter liegt außerhalb der Shopgrenze.
- Lösungsstrategie
- Der Shop bleibt ein modularer Monolith. Das Zahlungsmodul klärt ausstehende Ergebnisse über die Zahlungskennung beim externen Anbieter.
- Bausteinsicht
- Bestellung besitzt Auftragsstatus und Modulvertrag; Zahlung besitzt Autorisierungskennung und Anbieteradapter; Versand verarbeitet bestätigte Bestellungen.
- Laufzeitsicht
- Bestellung übergibt den Zahlungsauftrag an Zahlung; Zahlung ruft den Anbieter auf und meldet den bestätigten Status zurück.
- Entscheidungen
- ADR-01 wählt den modularen Monolithen mit getrennten Modulverantwortungen und einer externen Zahlungsanbindung.
- Risiken
- Die Dauer eines Restore mit Zahlungsabgleich ist ungemessen; das Betriebsteam führt eine isolierte Probe durch.
Nutzen & Grenzen
Hilft, wenn
- Entwicklung, Fachseite und Betrieb profitieren von einem gemeinsamen Einstieg zu Zielen, Struktur und Betriebsfragen.
- Langfristige Übergaben und Änderungen brauchen auffindbare Entscheidungen und Risiken.
In der Praxis
- Leser und Informationsbedarf bestimmen. Benenne, wer die Beschreibung für welche Entscheidungen nutzt. Priorisiere Fragen zu Struktur, Laufzeit, Qualität und Risiken nach ihrem tatsächlichen Bedarf. Das Ergebnis ist ein zugeschnittener Dokumentationsumfang.
- Ziele und Belege verknüpfen. Verbinde Qualitätsziele mit Strategie, Sichten, Entscheidungen und passenden Betriebsinformationen. Verweise auf führende Artefakte und halte Zusammenhänge auffindbar; Änderungen bleiben an ihrer maßgeblichen Quelle nachvollziehbar.
- Lücken und Pflegeverantwortung festlegen. Markiere offene Annahmen, Risiken, Verantwortliche und Aktualisierungsanlässe. Prüfe die Beschreibung bei relevanten Änderungen. Das Ergebnis ist eine gepflegte Informationsstruktur mit sichtbaren offenen Punkten.
Ausführliche Erklärung lesen
arc42 strukturiert Architekturbeschreibungen in Themen wie Ziele, Randbedingungen, Kontext, Strategie, Bausteine, Laufzeit, Verteilung, Konzepte, Entscheidungen und Risiken. Der Abschnittsumfang richtet sich nach Bedarf; arc42 ordnet Fragen und beantwortet sie durch passende Architektursichten und Architekturentscheidung.
Zusammenhänge machen die Beschreibung nützlich: Ein Qualitätsziel begründet eine Strategie, die sich in Bausteinen und Abläufen zeigt. Bestehende Quellen können verlinkt werden, damit Informationen nicht mehrfach gepflegt werden. Zuständigkeiten und Aktualisierungsanlässe halten Inhalte verlässlich. arc42 ordnet relevante Antworten zu einer nachvollziehbaren Wissensstruktur für die jeweiligen Leser. Die Gliederung verbindet führende Quellen über Verweise und kann über mehrere gepflegte Artefakte verteilt sein. Pflege bleibt dort gebündelt, wo Informationen führend bearbeitet werden.
arc42 wurde von Gernot Starke und Peter Hruschka entwickelt und ist als Vorlage frei verfügbar.
Selbst prüfen
Teste dich in drei Stufen
AblesenIm Bild nachsehen
Welcher arc42-Abschnitt nennt das offene Restore-Risiko?
Lösung mit Begründung ansehen
Der Abschnitt „Risiken“: Die Dauer eines Restore mit Zahlungsabgleich ist ungemessen.
AnwendenAuf eine neue Lage übertragen
Das Team führt einen Zahlungs-Timeout als Qualitätsziel ein. Welche Abschnitte bearbeitest du?
Lösung mit Begründung ansehen
Trage das Ziel unter „Kontext und Ziele“ ein und verweise aus „Lösungsstrategie“ und „Laufzeitsicht“ darauf. Ein Betriebsindikator macht die Einhaltung beobachtbar.
BewertenEine Alternative abwägen
Wäre eine Sammlung loser Diagramme statt arc42 ausreichend? Wäge ab.
Lösung mit Begründung ansehen
Lose Diagramme sind schnell erstellt. Ohne feste Gliederung fehlen aber Ziele, Entscheidungen und Risiken, und es ist unklar, was zusammengehört; arc42 kostet dafür Pflegeaufwand.
Vertiefen
Diese Bausteine führen die Gedanken dieser Seite weiter.
Quellen
- arc42 – Template Overview (öffnet in neuem Tab)Zeigt die zwölf Abschnitte und ihre Aufgaben in einer Architekturdokumentation.
- arc42 – Building Block View (öffnet in neuem Tab)Erklärt hierarchische Zerlegung und die Dokumentation von Bausteinen.
- arc42 – Runtime View (öffnet in neuem Tab)Beschreibt, wie wichtige Abläufe und Interaktionen dokumentiert werden.