Untertitel: Warum öffentliche Software einen lesbaren Plan braucht – und was arc42 dafür leistet.
Ein Fachverfahren läuft. Dann fragt die Revision: Wer darf was? Warum speichert das System so? Was passiert bei Ausfall? Die Antwort: „Das weiß der eine Kollege – der ist im Urlaub.“
Software steuert und speichert – aber das Architektur-Bild steckt in Köpfen. Wer ein Haus ohne Plan umbaut, hat kein Handwerkerproblem – er hat ein Architekturproblem.
Die These in einem Satz
arc42: Struktur, Nachvollziehbarkeit, gemeinsames Bild – damit öffentliche Software kein Rätsel bleibt, sondern ein Plan mit Verantwortung.
Architektur muss lesbar sein – nicht nur im Code.
Was ohne Architektur-Bild entsteht
Teure Umbauten im Blindflug. Abhängigkeit von einzelnen Köpfen und Lieferanten. Unklare Qualitäts- und Sicherheitsziele. Revision und Wechsel dauern monatelang. Jeder kann fleißig arbeiten – und trotzdem fehlt der Plan fürs Ganze.
Was es nicht ist
Keine 500-Seiten-Bibel, kein Ersatz für Code und Tests, kein reines Zertifikats-Thema und kein totes Ablage-PDF.
Sondern ein bewährtes Gerüst: die richtigen Kapitel in sinnvoller Reihenfolge – knapp, aktualisierbar, prüfbar. Dokumentation ohne Leben veraltet. Architektur ohne Struktur bleibt im Kopf. Beides gehört zusammen.
Drei Säulen
1. Kontext und Ziele
Wofür ist das System da? Welche Qualitätsziele zählen? Wer sind Stakeholder – und welche Systeme grenzen an? Ohne Kontext baut jeder an seiner Ecke und glaubt, das Ganze zu verstehen. Messbar: Kann ein Außenstehender in kurzer Zeit sagen, was das System ist und wofür?
2. Bausteine und Entscheidungen
Woraus besteht das System? Wie und wo läuft es? Warum so – und welche Alternativen wurden verworfen? Schnittstellen müssen benannt sein, nicht nur Produktnamen. Messbar: Entscheidungen mit Begründung; Wechselbarkeit denkbar.
3. Qualität und Betrieb
Was heißt gut genug – Performance, Sicherheit, Änderbarkeit? Risiken und technische Schulden bewusst führen. Ein Glossar schafft gemeinsame Sprache. Messbar: Szenarien prüfbar, Risiken geführt, Begriffe einheitlich.
Der kulturelle Kern
| Geheimwissen | arc42-Haltung |
|---|---|
| Architektur im Kopf des Experts | Gemeinsames, prüfbares Bild |
| Irgendwo dokumentiert | Feste Kapitel, knappe Antworten |
| Entscheidungen unsichtbar | Entscheidungen begründet |
| Lieferant als Blackbox | Fortführbar ohne einen einzigen Kopf |
Die Leitfrage: Bleibt Architektur Geheimwissen weniger Köpfe – oder ein Plan mit Verantwortung?
Entscheidungsfilter
- Kann ein Neuer den Kontext in einer Stunde erklären?
- Sind Bausteine und Schnittstellen benannt – oder nur Produktnamen?
- Gibt es begründete Architekturentscheidungen – oder nur Status quo?
- Sind Qualitätsziele und Risiken explizit?
- Wäre die Architektur ohne den aktuellen Lieferanten fortführbar?
Kurzformel
arc42: Struktur, Nachvollziehbarkeit, gemeinsames Bild – damit öffentliche Software kein Rätsel bleibt, sondern ein Plan mit Verantwortung.