Vortrag: Christian Pfahl (ca. 45 Minuten) „Agile Softwareentwicklung und Architektur-Dokumentation?!“ Jeder liebt Dokumentationen, oder? Falls nicht, möchte man sich auf das Nötigste beschränken – doch was ist das Nötigste? Vielleicht Architektur-Dokumentation?? Was ist denn genau eine “Architektur”-Dokumentation??? Und wie passt das überhaupt zu “agiler Softwareentwicklung”????

1. Agile Softwareentwicklung und
Architektur-Dokumentation?!
Eine Urlaubsreise von 45 Minuten
mit Christian Pfahl (cp@KriNiTo.de)

2. Was ist das „Nötigste“?
„Kalymnos 2005 022“. Lizenziert unter CC BY-SA 2.5 über Wikimedia Commons -
http://commons.wikimedia.org/wiki/File:Kalymnos_2005_022.jpg#mediaviewer/File:Kalymnos_2005_022.jpg

3. Was ist das „Nötigste“?
„Kalymnos 2005 022“. Lizenziert unter CC BY-SA 2.5 über Wikimedia Commons -
http://commons.wikimedia.org/wiki/File:Kalymnos_2005_022.jpg#mediaviewer/File:Kalymnos_2005_022.jpg
Funktionen
Qualitäten
Laufende
Software
Architektur (Doku)
beschäftigt sich mit

4. Was ist Architektur? (Verworfenes…)
"Gateway 111001" by Kafring - Own work. Licensed
under CC BY-SA 3.0 via Wikimedia Commons -
http://commons.wikimedia.org/wiki/File:Gateway_111
001.jpg#mediaviewer/File:Gateway_111001.jpg
"Science books in Senate House" by Tom Morris - Own work. Licensed under
CC BY-SA 3.0 via Wikimedia Commons -
http://commons.wikimedia.org/wiki/File:Science_books_in_Senate_House.jpg
#mediaviewer/File:Science_books_in_Senate_House.jpg

5. Was ist (Urlaubs-)Architektur?

6. Was ist (Urlaubs-)Architektur?
"Otakuthon 2014- Men in Black (14850563279)" by Pikawil from
Laval, Canada - Otakuthon 2014: Men in Black. Licensed under CC BY
2.0 via Wikimedia Commons -
http://commons.wikimedia.org/wiki/File:Otakuthon_2014-
_Men_in_Black_(14850563279).jpg

7. Architektur unseres Urlaubs
Ort(e), Hotel(s),
Reise-Pakete,
Mottos wie:
„Kein Stress“
Fundamentale Konzepte oder Eigenschaften
eines Systems in seiner Umgebung verkörpert
in seinen Bausteinen, Beziehungen und
Prinzipien, die für seinen Entwurf und seine
Evolution gelten. (Definition inAnlehnung an IEEE-1471)
Reiseveranstalter,
Teilnehmer…
(Änderbar?)
Wenn es schwer geändert werden kann,
ist es Architektur
(Freie Übersetzung einer Definition von Martin Fowler)
Gemeinsame
Vorstellungen,
Ziele und
Werte?
“In most successful software projects, the
expert developers working on that project
have a shared understanding of the
system design.This shared understanding
is called 'architecture'....”
(Definition von Ralph Johnson - Gang of Four)

8. „Architektur“

9. Agile vs. Architektur (-Doku)?
TEXTHier steht IhrText.
"Scrum-1" by Maree Reveley - Own work. Licensed under CC BY-SA 2.5 via Wikimedia
Commons - http://commons.wikimedia.org/wiki/File:Scrum-
1.JPG#mediaviewer/File:Scrum-1.JPG

10. Agile vs. Architektur (-Doku)?
TEXTHier steht IhrText.
"Scrum-1" by Maree Reveley - Own work. Licensed under CC BY-SA 2.5 via Wikimedia
Commons - http://commons.wikimedia.org/wiki/File:Scrum-
1.JPG#mediaviewer/File:Scrum-1.JPG
“Working software
over comprehensive
documentation”
“That is, while there is
value in the items on
the right, we value the
items on the left more.”
 Agile Dokumentation - Gerhard
Müller - AgileTuesday / 7.10.2014:
http://youtu.be/w6kUKTzqLF4

11. Agile und Architektur-(Doku): Ein Widerspruch?

12. Was ist „Architektur-Dokumentation“?

13. Nun weiter mit unserem Urlaub….

14. Was schreiben wir auf? Wie fangen wir an?Vorschlag:

15. Überblick in derVariante: „System-Idee“
Neues System zur Sitzplatzreservierung:
Es soll ein System entwickelt werden, welches es Fahrgästen ermöglicht,
einen Sitzplatz für eine bestimmte Zugfahrt zu reservieren.
Dieses System soll „SiPlaRes“ heißen.
In SiPlaRes kann ein Fahrgast dann…..

16. Überblick als:
„Product-Fact-Sheet“
SiPlaRes 1.0
Die Lösung für Bahnunternehmen ermöglicht Ihren Fahrgästen eine
komfortable Urlaubsreise dank Sitzplatzreservierung.
Key Features:
 Einfache und schnelle Buchung über Smartphone oder PC in < 3 Minuten
 Crowd-Support: Gruppen können endlich zusammen reisen 
 Stornierung direkt und ohne Hotline möglich
 Faires Preismodell für Bahnunternehmen: Lizenzgebühren nur pro Vorgang
Systemvoraussetzungen:
 Anbindung der SiPlaRes-Cloud an Ihre Zug-Informationssysteme

17. Überblick als:
„Product-Fact-Sheet“
SiPlaRes 1.0
Die Lösung für Bahnunternehmen ermöglicht Ihren Fahrgästen eine
komfortable Urlaubsreise dank Sitzplatzreservierung.
Key Features:
 Einfache und schnelle Buchung über Smartphone oder PC in < 3 Minuten
 Crowd-Support: Gruppen können endlich zusammen reisen 
 Stornierung direkt und ohne Hotline möglich
 Faires Preismodell für Bahnunternehmen: Lizenzgebühren nur pro Vorgang
Systemvoraussetzungen:
 Anbindung der SiPlaRes-Cloud an Ihre Zug-Informationssysteme
oder „Product-Box“

18. System-Kontext-Diagramm
Systemgrenze
Web-Browser-
Schnittstelle
ZugInfo-
Schnittstelle
Bezahl-
Schnittstelle
«system»
SiPlaRes
Web-Browser-
Schnittstelle
ZugInfo-
Schnittstelle
Bezahl-
Schnittstelle
Fahrgast
«system»
Zug- und
Zugfahrtensystem
«system»
Bezahlsystem

19. System-Kontext-Diagramm (Marketing-Style)
SiPlaRes
Fahrgast
Zug- und
Zugfahrtensystem
Bezahlsystem

20. System-Kontext-Diagramm
Systemgrenze
Web-Browser-
Schnittstelle
ZugInfo-
Schnittstelle
Bezahl-
Schnittstelle
«system»
SiPlaRes
Web-Browser-
Schnittstelle
ZugInfo-
Schnittstelle
Bezahl-
Schnittstelle
Fahrgast
«system»
Zug- und
Zugfahrtensystem
«system»
Bezahlsystem

21. Bezahl-
Schnittstelle
Web-Browser-
Schnittstelle
ZugInfo-
Schnittstelle
«system»
SiPlaRes
Bezahl-
Schnittstelle
Web-Browser-
Schnittstelle
ZugInfo-
Schnittstelle
Züge
ReservierungenStornierungen
Zugfahrten
White-Box-Sicht

22. Fachbegriffe
FACH-
BEGRIFFS-
MODELL

23. Was für Architektur-Doku braucht man noch?
 Qualitätsziele und Szenarien
 Randbedingungen
 Entscheidungen
 Bausteinsicht, Laufzeitsicht,Verteilungssicht
 Konzepte und Muster
 Risiken

24. Links und Buchempfehlungen
 ARC42Template für Architektur-Doku (G. Starke):
http://www.arc42.de/
 DokChess als Beispiel für arc42 von Stefan Zörner
http://www.dokchess.de/dokchess/arc42/
 Buch: „Softwarearchitekturen dokumentieren und
kommunizieren“ von Stefan Zörner: ISBN-10: 3446429247
 Zertifizierung für Software-Architekten (CPSA):
http://www.isaqb.org/
 „Vorgehensmuster für Softwarearchitektur: Kombinierbare
Praktiken in Zeiten von Agile und Lean“ von StefanToth:
ISBN-10: 3446436154
 Agile Dokumentation - Gerhard Müller - AgileTuesday /
7.10.2014: http://youtu.be/w6kUKTzqLF4
 Sparx Enterprise Architect: http://sparxsystems.com.au/
 3D-Box erstellen: http://3d-pack.com/

25. Vielen Dank für den gemeinsamen Urlaub!
Christian Pfahl
cp@KriNiTo.de
http://www.KriNiTo.de
Agile Softwareentwicklung und Architektur-Dokumentation?!