View on GitHub

Software Engineering - HS 2024

Vorlesungswebseite für den Kurs Software Engineering der Universität Basel

Projektschritt 1: Pflichtenheft und Projektplan

Vorbereitung

Wechseln Sie auf den project branch. Erzeugen Sie dann, ausgehend vom Branch project, einen neuen Branch mit dem Namen requirements.

Kopieren Sie das Pflichtenheft Markdown Template in den Ordner docs/sweng.

Einleitung und allgemeine Beschreibung

Schauen Sie sich die Theorie zum Thema Anforderungsanalyse nochmals genau an. Überlegen Sie sich wer ihre Stakeholder sind und wie diese von den Änderungen betroffen sind. Schauen Sie sich die nachfolgenden Beispiele für Pflichtenhefte an:

Schreiben Sie nun die Abschnitte 1 - 2 im Pflichtenheft für ihr Projekt. Nachdem Sie die Abschnitte geschrieben haben, machen Sie mit den nachfolgenden Schritten weiter.

Anwendungsfälle

Definieren Sie nun die Anwendungsfälle (Use-cases) für Ihr Projekt. Beschreiben Sie dabei relevante Szenarien aus Benutzersicht, inklusive der möglichen Sonderfälle und Ausnahmen die dabei auftreten können. Dokumentieren Sie die Use-cases im Anhang des Pflichtenhefts.

Funktionale Anforderungen

Als nächstes beschreiben Sie die funktionalen Anforderungen im entsprechenden Abschnitt des Pflichtenhefts. Zur Identifizierung der funktionalen Anforderungen sollten Sie die oben erstellten Use-cases verwenden. Ergänzen Sie ihr Pflichtenheft mit den Anforderungen.

Tipp: Falls viele von Ihren Anforderungen die Benutzeroberfläche betreffen, hilft es neue GUI Elemente bereits grafisch zu illustrieren. Sie können diese zum Beispiel mit einem Zeichenprogramm wie Inkscape oder Paint erstellen.

Abnahmekriterien

Überlegen Sie sich sinnvolle Abnahmekriterien. Diese Kriterien sollen von uns überprüfbar sein und die Grundlage für die Entscheidung bilden, ob Sie das Projekt bestehen.

Offene Fragen an Betreuer und JabRef Entwickler

Notieren Sie sich Unklarheiten und offene Fragen, die sie gerne mit Ihrem Betreuer diskutieren möchten, direkt im Dokument. Kennzeichnen Sie diese klar mit dem Vermerk OPEN QUESTION: .

Projektplan

Erstellen Sie nun anhand der Anforderungen einen Projektplan. Auf dem Plan sollen alle Tasks, die Sie zur Durchführung des Projekts bearbeiten müssen, aufgeführt sein. Für jede Task soll ersichtlich sein, wie lange diese dauert, wer diese bearbeitet und wann Sie mit der Bearbeitung beginnen können. Für so ein einfaches Projekt reicht, wenn Sie einfach eine Excel Tabelle oder ähnliches nutzen. In einem grösseren Projekt würde man dafür professionelle Projektmanagementsoftware verwenden.

Die Schätzung des Aufwands für eine Task ist schwierig. Je besser die funktionalen Anforderungen spezifiziert sind, desto einfacher wird es aber, da wohldefinierte Anforderungen zu konkreteren und dadurch besser überschaubaren Tasks übersetzt werden können. Natürlich hilft es auch sich mit dem Code auseinander zu setzen, um ein Gefühl für die Komplexität zu bekommen.

Abgabe

Die Abgabe erfolgt pro Gruppe, mittels Pull Request auf ihren project branch. Den Abgabetermin finden Sie in der Übersicht. Geben Sie Ihren Betreuer als Reviewer an.