Dokumente eines IT-Projektes: - Pflichtenheft & Co - jheger@upb.de Fachbereich Informatik Paderborn, 04.06.2003
Überlappendes Phasenschema Dokumente der einzelnen Phasen 2
1.1 Überlappendes Phasenschema 1.1 Überlap. Phasenschema Aufwand Weitere Modelle: -Code and Fix - Wasserfallmodell -V-Modell -Spiralmodell - zyklische Modell Zeit I Vorstudie V Implementierung und Test II Ist-Analyse VI Systemeinführung III Sollkonzept [VII Systembetrieb] IV Systementwurf Vgl. [Fischer et al. 02, S.323ff.] 3
1.2 Dokumente der einzelnen Phasen 1.2 Überblick Dokumente Vorstudie -> Durchführbarkeitsstudie Ist-Analyse -> Systembeschreibung und Systemabgrenzung -> Schwachstellenbericht -> Beginn des Glossars Sollkonzept -> Organisationsplan -> Pflichtenheft -> Kostenschätzung Systementwurf -> Systementwurf Implementierung und Test -> Programmcode -> Dokumentation -> Testfälle Systemeinführung -> Abschlussbericht 4
Programmcode Dokumentation Pflichtenheft 5
2.1 Programmcode und Dokumentation 2.1 Prg. Code / Dokumentation Programmcode ist das Produkt selbst wird von Gruppe erstellt CVS nötig Dokumentation Verständnis aller Beteiligten wird sichergestellt Vereinfacht Fehlersuche und Erweiterungen... Dokumentation wichtig 6
2.2 Pflichtenheft 2.2 Pflichtenheft Funktionsbeschreibung für das System (aus Sicht des Auftraggebers) Hardware- / Softwareumgebung Schnittstellen zu anderen betrieblichen Systemen Kompatibilitäten auf Hardware- oder Softwareebene Anbindung an bestimmte Netze bzw. Telekommunikationsdienstleistungen Sicherheitskriterien (z.b. Ausfallsicherheit, Backups) Serviceanforderungen (z.b. Hotline, obere Zeitschranke für Fehlerbehebung) Anforderungen an die Oberfläche Preislicher Rahmen für das System 7
2.2.1 Zielbestimmung und Produkteinsatz 2.2 Pflichtenheft Kopf: Projekt: Auftraggeber: Auftragnehmer: 1. Zielbestimmung Einleitung Hauptaufgabe wird festgelegt -> Grund für die Entwicklung Zielgruppe definieren (Vorwissen, Erfahrungen) 2. Produkteinsatz Einsatzbereich des Systems wird festgelegt Darstellung der systemrelevanten Abläufe Pflichtenheft: Reicko Heckel, Annika Wagner, Albert Zündorf 8
2.2.2 Beschreibung des Produkteinsatzes 2.2 Pflichtenheft 2. Produkteinsatz 2.1Beschreibung des Problembereichs Allgemein verständliche Beschreibung des Problembereichs Laien mit der Terminologie und den Zusammenhängen vertraut machen 2.2 Glossar Falls kein ausführliches Glossar (als eigenes Dokument) angelegt wird, hier die wichtigsten Begriffe erklären 2.3 Modell des Problembereichs (grafisch) Modell kann z.b. ein Klassendiagramm sein 2.4 Beschreibung des Geschäftsfeldes (kann entfallen) Darstellung der Geschäftsprozesse (Abläufe) z.b. mit Hilfe eines USE-Cases 9
2.2.2 Beschreibung des Produkteinsatzes (2) 2.2 Pflichtenheft 2. Produkteinsatz 2.1 Beschreibung des Problembereichs 2.2 Glossar 2.3 Modell des Problembereichs (grafisch) 2.4 Beschreibung des Geschäftsfeldes (kann entfallen) 2.5 Beschreibung der Geschäftsprozesse (kann entfallen) Genauere Beschreibung der Geschäftsprozesse Beschreibung mit Tabelle und/oder Aktivitätendiagramm Auslösendes Ereignis Ergebnis Mitwirkende <Handlung oder Zeitpunkt, wann der GP beginnt> <Was soll erreicht werden> <Rollenname der Beteiligten oder eines Systems> 10
2.2.3 Produktfunktionen 3. Produktfunktinen 2.2 Pflichtenheft Beschreibung der Funktionalitäten Jede Funktionalität lässt sich einem GP aus (2) zuordnen 3.1 Use Case Diagramme Überblick über die Funktionalitäten 3.2 Beschreibung zu <Use Case-ID>: <Use Case-Name> 3.2.1 Charakterisierende Informationen Übergeordneter elementarer Geschäftsprozess: Ziel des Use Cases: Vorbedingungen: Nachbedingung bei erfolgreicher Ausführung: Beteiligter Nutzer: Auslösendes Ereignis: <Prozess-ID: <elemetarer Geschäftsprozess> (Verzweigung angeben) <Ausführliche Beschreibung des Zieles des Use Cases> <Was muss garantiert werden, damit der UC ausgeführt werden kann> <Was muss für eine erfolgreiche Ausführung des Use Cases sichergestellt werden> <Rollename> Beschreibung des Nutzers oder des Systems <Handlung oder Zeitpunkt, die Use Case auslöst> 11
2.2.3 Produktfunktionen (2) 2.2 Pflichtenheft 3.2 Beschreibung zu <Use Case-ID>: <Use Case-Name> 3.2.1 Charakterisierende Informationen <Tabelle> (s.o.) Skizze / Screenshot der GUI 3.2.2 Szenario für den Standardablauf (Erfolg) Schritt <Schrittnr.> Nutzer <Name des Nutzer> Beschreibung der Aktivität <Beschreibung dessen, was der Nutzer tut> GUIs für den Standardablauf des Use Cases: Skizze / Screenshot der GUI 12
2.2.3 Produktfunktionen (3) 2.2 Pflichtenheft 3.2 Beschreibung zu <Use Case-ID>: <Use Case-Name> 3.2.1 Charakterisierende Informationen 3.2.2 Szenario für den Standardablauf (Erfolg) 3.2.3 Szenarien für die alternative Abläufe (Misserfolg oder Umweg) Schritt <Referenz auf Schrittnr. aus Standardablauf> Nutzer <Was verursacht den alternativen Ablauf> Beschreibung der Aktivität <Beschreibung der entsprechenden Aktivität> GUIs für alternative Abläufe des Use Cases: Skizze / Screenshot der GUI 3.2.4 Beschreibung des allgemeinen Ablaufs Aktivitätsdiagramme zu den Abläufen aus dem vorherigen Abschnitt 3.2.5 Offene Punkte Beschreibung dessen, was noch unklar ist 13
2.2.4 Produktcharakteristiken 2.2 Pflichtenheft 4. Beschreibung der nicht-funktionalen Anforderungen Charakteristiken oder Qualitäten, die das Produkt attraktiv machen und wodurch es sich von ähnlichen abhebt. Name: Typ: Beschreibung Zugeordneter(r) Use Case(s) <Kurze, eindeutige Bezeichnung> <Einen Typ aus der im Anhang definierten Liste auswählen> <Beschreibung in Sprache des Nutzers, die versucht Mehrdeutigkeiten zu vermeiden> <Use Case-ID> Typen: Use Effizienz Pflege Sicher Benutzbarkeitsanforderung Effizienzanforderungen Wartbarkeits- und Portierbarkeitsanforderungen Sicherheitsanforderungen Legal Gesetzliche Anforderungen 14
Literatur: IT Consulting Skript zur Veranstaltung Leena Suhl, Thomas Knechtel, Markus Toschläger Links: http://www.upb.de/cs/ag-engels/ag_dt/courses/lehrveranstaltungen /WS0203/TSEI/Templates/Pflichtenheft-Template.pdf http://www.pa.ethz.ch/formulare/acrobat/pflichtenheft_wegleitung_pdf.pdf http://www.informatik.uni-mannheim.de/informatik/pi4/stud/veranstaltungen /ss2001/pm/dokumente/vorlagen/pflichtenheft.html 15
Vielen Danken für Eure Aufmerksamkeit! Fachbereich Informatik