Designdokument

[mitschke]

Hier ein paar Anhaltspunkte zu den Inhalten des geforderten Designdokuments.

Das Designdokument soll eine Übersicht über die Architektur geben und die Komponenten der Software beschreiben. Das Dokument sollte nicht mehr als 4500 Worte lang sein (das entspricht in etwa 10 Seiten Text). Zusätzliche könnt ihr beliebig viele Graphiken einfügen. Bei den Graphiken solltet ihr auf die Einhaltung von UML-Standards achten, um eine eindeutige Semantik zu gewährleisten.

Als Inspiration für euer Dokument könnt ihr die folgende Spezifikation verwenden. Die Spezifikation ist ausführlich und bietet einen guten Rahmen für das von uns geforderte Dokument. Hierbei sollet ihr euch aber nur auf die Teile beschränken, die relevant sind, d.h. nur das was sich auf die Architektur und das Design und die entsprechenden Entscheidungen bezieht.

Achtet auf einen strukturierten und klaren Aufbau Ihres Dokumentes. Häufig ist es sinnvoll, mit einem hohen Abstraktionsgrad anzufangen, also zunächst einen Überblick über die Gesamtarchitektur zu geben und anschließend jeweils für kleinere Teile der Anwendung eine detailiertere Beschreibung des Designs zu geben. Ihr solltet außerdem zu Begin des Dokumentes kurz den Inhalt eures Projektes vorstellen. Dabei könnt ihr zum Beispiel eine Abbildung zwischen der Real-World-Domäne eures Projektes und dem Design Ihrer Software geben. Wichtig ist außerdem am Anfang des Dokumentes die Designziele aufzustellen und am Ende zu bewerten, in wie fern Sie diese Ziele mit der Architektur erreicht werden.

Weitere Punkte, die in dem Dokument genannt werden sollen sind Entscheidungen, die ihr bezüglich des Designs gefällt habt, und an welchen Stellen in eurem Design Erweiterungsmöglichkeiten einplant sind.