Wir bauen eine Sofware-Architektur

Der nachfolgende Text wurden mit KI erstellt und kann Fehler enthalten. Fehler gefunden? Bei GitHub editieren

Wichtige Keytakeaways

Der erste Schritt einer Architektur ist nicht die Zerlegung in Komponenten, sondern das System-Kontextdiagramm.
Das Kontextdiagramm zeigt, mit welchen Systemen das eigene System reden muss und wofür es selbst verantwortlich ist.
Ein arc42-Template füllt man nicht blind in Kapitelreihenfolge aus, sondern nutzt es als Ablage für gewonnene Erkenntnisse.
Cloud oder lokaler Server ist keine Anforderung, sondern eine Architekturentscheidung, die aus Anforderungen folgt.
Ein fachliches Backlog sagt oft nichts über Qualitäten, deshalb muss meistens die Architekt:in die Qualitätsszenarien selbst erheben.
Für den Fahrradladen ist Benutzerfreundlichkeit die wichtigste Qualität, Verfügbarkeit ist eher entspannt.

Womit fängt man an, wenn man aus einem groben Backlog eine Software-Architektur bauen soll?
Welche Nachbarsysteme hat ein Reparatursystem für einen Fahrradladen und wie integriert es sich in den bestehenden Webshop?
Wie unterscheiden sich Business-Kontext und technischer Kontext in arc42?
Wie macht man Benutzerfreundlichkeit messbar?
Sind Qualitätsszenarien Tests oder Akzeptanzkriterien?
Welche Verfügbarkeit braucht ein Fahrradladen im Shop und im Web wirklich?

System-Kontextdiagramm: Darstellung des Systems mit seinen Nutzergruppen und den Nachbarsystemen, mit denen es Schnittstellen hat.
Business-Kontext: Variante des Kontextdiagramms nach arc42 ohne Technologien, die nur Akteure und Nachbarsysteme zeigt.
Technischer Kontext: Variante des Kontextdiagramms nach arc42, die Protokolle und technische Schnittstellen ergänzt.
Qualitätsszenario: Beschreibung, wie das System auf eine Benutzung, eine Änderung oder einen Ausfall mit einer definierten Metrik reagieren soll.
Erlernbarkeit: Qualitätsmerkmal aus dem Bereich Benutzbarkeit, etwa dass ein neuer Mitarbeiter das System nach einer Stunde eigenständig bedienen kann.
Mandantenfähigkeit: Fähigkeit eines SaaS-Systems, mehrere Kunden wie verschiedene Fahrradläden in einer Installation zu bedienen.

arc42: Template für Architekturdokumentation, aus dem Kapitel 3 mit Business- und Technik-Kontext genutzt wird.
ISO 25010: Standard mit Qualitätsmerkmalen wie Zuverlässigkeit, Performance, Benutzbarkeit und Sicherheit, der als Checkliste für Qualitätsszenarien dient.
JWT: Token-Standard, mit dem der Webshop Benutzerinformationen per Cookie an das Reparatursystem weitergibt.
REST: Schnittstellenstil für die Integration mit User-Datenbank, Payment-Service und Kasse.
PayPal: Online-Payment-Service für die Bezahlung von Reparaturen außerhalb der Kasse.
Amazon Simple Email Service: Beispiel für einen E-Mail-Dienst, über den das System Kunden benachrichtigen könnte.