Vorlage zur Anforderungs
Werbung
<projektbezeichnung> Anforderungs- und Designspezifikation, <version> Verfasser: <name> <name> Anmerkung: Das vorliegende Dokument ist eine Vorlage zur Erstellung einer Anforderungs- und Designspezifikation für kleine Projekte. Die im Dokument enthaltenen Textteile in blauer Schrift sind als Erläuterungen und Hinweise zu verstehen; sie müssen bei der Erstellung der Spezifikation gelöscht bzw. durch projektspezifische Angaben ergänzt oder ersetzt werden. Status: Datum: © Prof. Dr. M. Rezagholi <dok-status> <datum> Anforderungs- und Designspezifikation Dokumentenverwaltung <projektbezeichnung> Dokumentenverwaltung Dokument-Historie Version Status Datum Verantwortlicher Änderungsgrund Dokument wurde mit folgenden Tools erstellt: <Textverarbeitungstool> <Grafiktool> … Seite 2 / 6 Anforderungs- und Designspezifikation Inhaltsverzeichnis <projektbezeichnung> Inhaltsverzeichnis 1 Einleitung ................................................................................................................................ 4 1.1 Zweck des Dokuments ...................................................................................................... 4 1.2 Gültigkeit des Dokuments.................................................................................................. 4 1.3 Begriffsbestimmungen und Abkürzungen .......................................................................... 4 1.4 Zusammenhang mit anderen Dokumenten ........................................................................ 4 2 Allgemeine Beschreibung des gewünschten Systems ....................................................... 4 2.1 Zweck des gewünschten Systems..................................................................................... 4 2.2 Überblick über die geforderte Funktionalität ...................................................................... 4 2.3 Abgrenzung und Einbettung des gewünschten Systems ................................................... 4 2.4 Allgemeine Einschränkungen ............................................................................................ 4 2.5 Vorgaben zu Hardware und Software ................................................................................ 4 2.6 Anforderungsquellen / Zielgruppen.................................................................................... 4 3 Detaillierte Beschreibung der Anforderungen (Leistungsmerkmale) ................................. 4 3.1 Lieferumfang ..................................................................................................................... 4 3.2 Abläufe (Szenarien) von Interaktionen mit der Umgebung................................................. 5 3.3 Geforderte Funktionen des Produkts ................................................................................. 5 3.4 Struktur und Verhalten des System ................................................................................... 5 3.5 Schnittstellen des gewünschten Systems .......................................................................... 5 3.6 Zu berücksichtigende Normen ........................................................................................... 5 3.7 Qualitätsanforderungen / sonstige entwicklerorientierte Anforderungen ............................ 5 4 Vorgaben des Auftraggebers an die Projektabwicklung ..................................................... 5 4.1 Anforderungen an die Realisierung ................................................................................... 5 4.2 Abnahmebedingungen ...................................................................................................... 5 4.3 Fertige und zugekaufte Komponenten ............................................................................... 6 4.4 Lieferbedingungen ............................................................................................................ 6 4.5 Gewährleistung ................................................................................................................. 6 5 Durchführbarkeitsuntersuchungen....................................................................................... 6 6 Bewertung der Anforderungen .............................................................................................. 6 7 Verpflichtungen des Auftraggebers ...................................................................................... 6 8 Literaturverweise.................................................................................................................... 6 9 Anhang .................................................................................................................................... 6 Seite 3 / 6 Anforderungs- und Designspezifikation <projektbezeichnung> Error! Use the Home tab to apply Überschrift 1 to the text that you want to appear here. 1 Einleitung 1.1 Zweck des Dokuments Zielsetzung des Dokuments und Adressatenkreis 1.2 Gültigkeit des Dokuments für welche Anwendungsdomäne (Fachgebiet)? Gesamtes Projekt? Basissystem? DeltaEntwicklung? Aufbauend auf anderer Anforderungsspezifikation? 1.3 Begriffsbestimmungen und Abkürzungen Die Begriffsdefinitionen sind deshalb so besonders wichtig, weil die Anforderungsspezifikation die gemeinsame Verständnisbasis von Auftraggeber und Auftragnehmer darstellt. 1.4 Zusammenhang mit anderen Dokumenten Existieren andere Anforderungsdokumente (System Spezifikation, Lastenheft, ...) so muss sich die Anforderungsspezifikation auf diese Dokumente beziehen. Schnittstellen zu anderen Projekten sollen bei der ausführlichen Beschreibung der Systemschnittstellen beschrieben werden. 2 Allgemeine Beschreibung des gewünschten Systems 2.1 Zweck des gewünschten Systems Ziel und Einsatz des Produkts aus Auftraggebersicht 2.2 Überblick über die geforderte Funktionalität Hier werden die Leistungen aufgelistet, die das System erbringen wird (Zusammenfassung von Kapitel 3). Gegebenenfalls können auch die Leistungen, die das System nicht erbringen wird, explizit aufgelistet werden. 2.3 Abgrenzung und Einbettung des gewünschten Systems wesentliche Leistungen des Systems; Abgrenzung zu anderen Systemen in der Umgebung, konsistent mit evtl. vorhandenen übergeordneten Dokumenten. 2.4 Allgemeine Einschränkungen Vorgaben zu Schnittstellen, Standards, Methoden 2.5 Vorgaben zu Hardware und Software HW- und SW-Umgebung des Zielsystems 2.6 Anforderungsquellen / Zielgruppen Benutzer des gewünschten Systems, ... (andere Stakeholder) 3 Detaillierte Beschreibung der Anforderungen (Leistungsmerkmale) 3.1 Lieferumfang Beschreibung der zu liefernden System-Bestandteile; Beschreibung der zu liefernden Hauptfunktionalität. Seite 4 / 6 Anforderungs- und Designspezifikation <projektbezeichnung> Error! Use the Home tab to apply Überschrift 1 to the text that you want to appear here. 3.2 Abläufe (Szenarien) von Interaktionen mit der Umgebung Typische Abläufe z.B. mit Anwendungsfall-Diagrammen darstellen. 3.3 Geforderte Funktionen des Produkts Das Produkt wird aus funktionaler Sicht anhand von Anwendungsfällen (Use Cases) beschrieben. Jeder Anwendungsfall wird in Form einer Tabelle spezifiziert: Bezeichnung Zusammenfassung Akteure Vorbedingung Ablaufbeschreibung Verwendungen (IncludeBeziehungen) Erweiterungen (ExtendBeziehungen) Alternativen Nachbedingung Fehlschlag Name des Anwendungsfalls Kurzbeschreibung (was wird bei erfolgreicher Ausführung erreicht) Akteure (Personen oder andere Systeme), die den Anwendungsfall auslösen oder bei der Durchführung involviert sind Voraussetzungen, die zur Ausführung des Anwendungsfalls erfüllt sein müssen Strukturierte Ablaufbeschreibung (alle Aktionen des Standardfalls) Auflistung aller Anwendungsfälle, die von dem Anwendungsfall verwendet werden Auflistung aller Anwendungsfälle, die den Anwendungsfall erweitern. Optionen und Alternative Ausführung einzelner Aktionen Resultate, die der Anwendungsfall liefert Erwarteter Zustand, wenn das Ziel nicht erreicht werden kann 3.4 Struktur und Verhalten des System Beschreibung der verschiedenen statischen Strukturaspekte des Systems (Klassen-, Paket-, Komponenten-, Verteilungsdiagramm) sowie Beschreibung der Dynamik, der internen Abläufe und des Zusammenspiels der Systemteile (Aktivität-, Sequenz-, Zustand-, Timingdiagramm). 3.5 Schnittstellen des gewünschten Systems Beschreibung der Benutzerschnittstellen; Beschreibung der Schnittstellen zu anderen Softund Hardwaresystemen. Zu berücksichtigende Normen 3.6 Zu berücksichtigende Normen 3.7 Qualitätsanforderungen / sonstige entwicklerorientierte Anforderungen Spezifikation von Anforderungen hinsichtlich Performance, Ressourcen, Safety (Schutz und Sicherheit), Datensicherheit, Portabilität, Reliability, Wartung, Wiederverwendung, Usability, Serviceability 4 Vorgaben des Auftraggebers an die Projektabwicklung 4.1 Anforderungen an die Realisierung z. B. Angaben über zu verwendende Software, Hardware, Entwicklungsmethode, Termine, Ausbaustufen, zugekaufte Produkte 4.2 Abnahmebedingungen Bedingungen des Auftraggebers für die Abnahme, wogegen?, wie?, welche Unterlagen Seite 5 / 6 Anforderungs- und Designspezifikation <projektbezeichnung> Error! Use the Home tab to apply Überschrift 1 to the text that you want to appear here. 4.3 Fertige und zugekaufte Komponenten z. B. Standardsoftware, wiederverwendete eigene Software, Software des Auftraggebers, Betriebssysteme, ... 4.4 Lieferbedingungen z.B. Lieferplan mit Terminen, Form der Lieferungen, geforderte Dokumentation 4.5 Gewährleistung Gewährleistungsdauer, Umfang der Gewährleistung, Fehlermeldungsverfahren, ... 5 Durchführbarkeitsuntersuchungen Markt- und Kundenanalyse, Durchführbarkeitsanalyse,... 6 Bewertung der Anforderungen Falls bei der Beschreibung der funktionalen Eigenschaften des Produkts noch nicht erfolgt: Klassifizierung, Priorisierung, Auswahl (Paketierung) mit Auswahlbegründungen 7 Verpflichtungen des Auftraggebers z.B.: gestellte Hardware / Software, Schulung von Entwicklern oder von Auftraggeberpersonal, Ansprechpartner, zur Verfügung stellen von Räumen, Rechenzentrum, Reaktionszeiten des Auftraggebers auf Anfragen 8 Literaturverweise 9 Anhang relevante Dokumente, die zusätzliche Informationen über das zu erstellende System geben, z.B. Modelle Seite 6 / 6
