Spezifikationsdokument

Anmerkung: Änderungen am Dokument sind noch möglich, bitte prüfen Sie vor abgaben den Änderungsverlauf:

Übersicht

Das Spezifikationsdokument stellt den „Vertrag“ zwischen dem Team und den AGs dar. Ziel ist die Klärung des Projektrahmens.

Während der ersten Iteration (nach dem ersten Treffen mit dem AG) schreibt das Team das Spezifikationsdokument basierend auf den Diskussionen mit den AGs.

Das Spezifikationsdokument soll innerhalb der ersten Iteration (vor dem zweiten Treffen mit den AGs) weitgehend fertiggestellt und den AGs sowie der Teamleitung für Feedback übergeben werden.

Die Deadline zur Abgabe des Dokuments zur Bewertung ist der 1. Dezember 2024. Zu diesem Zeitpunkt sollen die AGs das Dokument abgesegnet haben, ihr müsst also deutlich früher eine Version für Feedback produzieren.

Anmerkung: Im Vergleich zu den Vorjahren, sind Anforderungen/Userstories NICHT Teil des Spezifikationsdokuments.

Im Folgenden ist das Spezifikationsdokument in Form von „Bewertungskriterien“ definiert.

Allgemein soll auf eine hohe Qualität des Textes geachtet werden. Sagt was wichtig ist. Habt einen roten Faden. Fasst euch kurz.

Dokumentinhalte

Projektbeschreibung (maximal 1 Seite)

Hier soll ein Kontext für das Projekt gegeben, sowie die Zielsetzung des Projektes klargemacht werden.

Zu diesem Kapitel gehört ein Architekturdiagramm (nicht Teil des Seitenlimits) das den Text unterstützt.

Hier wird ein zusammenhängender Text erwartet, die Struktur nach den Punkten unten (Vision, Ist/Soll, Domänendetails) hat sich als allgemein gut erwiesen, ist aber nicht vorgegeben. Die Punkte müssen aber abgedeckt sein.

Vision
  • Ist die Vision des Projekts verständlich erklärt?
    • Motiviert die Vision für das zu lösende Problem?
      • Ergibt die Vision eine Übersicht über die zu entwickelnde Lösung?
        • Wird der Kontext in den sich das Projekt integriert klar? Beispiel: was stellen sich die AGs in 3 Jahren mit dem Projekt vor?
          Ist-/Sollzustand
          • Wird klar, was vor dem Projekt gegeben ist?
            • Wird klar, was allgemein am Ende des Projekts vorhanden sein soll?
              • Welche Werte sind dem Auftraggeber besonders wichtig?
                • Die konkreten Projektziele sind definiert.
                  Domänenbeschreibung (wenn nötig)
                  • Wird die Domäne der zu entwickelnden Applikation erklärt?
                    • Werden die Benutzerrollen erklärt? Was soll Personen die das Projekt verwenden ermöglicht werden?
                      • Werden weitere Stakeholder erklärt? Wer ist von dem Projekt indirekt betroffen?
                        • Werden relevante Fachbegriffe erklärt?
                          • Werden Zusammenhänge zwischen verschiedenen Komponenten/Nutzern erläutert?
                            • Welche (speziellen) Einschränkungen müssen im Projekt berücksichtigt werden?
                              Wird aus dem Architekturdiagramm ersichtlich …
                              • Was die vorhandenen und geplanten Teile des Systems sind?
                                • Wie die verschiedenen Benutzerrollen mit dem System interagieren?

                                  Ergebnisse (Deliverables, maximal 1 Seite)

                                  Vom Format her eignet sich hier eine Liste an kurzen Paragraphen. Adressierte Punkte sollen ausformuliert beschrieben sein, Stichpunkte sind nicht angemessen.

                                  Ist geklärt …

                                  Risiken (maximal 1 Seite)

                                  Was sind die Risiken die verhindern könnten, dass die genannten Artefakte (Deliverables) erfolgreich erstellt werden? Wie soll damit umgegangen werden?

                                  Siehe die Folien zu Konflikte und die Beispiele für Konfliktszenarien als Anregung für mögliche Probleme.

                                  Projektrisiken sollten mit Wahrscheinlichkeiten, potenziellen Auswirkungen, und Mitigation aufgeschrieben werden.

                                  Diskutieren sie zumindest kurz die Punkte:

                                  Bitte geben Sie an, wie wahrscheinlich das Eintreten eines Risikos ist (oder ob die Wahrscheinlichkeit unklar ist) und welche Schritte in einem solchen Fall unternommen werden, um das Projekt dennoch erfolgreich abzuschließen.

                                  Rechtliches (kein Textlimit)

                                  Ist klar geregelt, ob und wie Verwendungsrechte an den Auftraggeber abgetreten werden?

                                  Ist dass es sich um ein studentisches Projekt handelt (NICHT: entspricht Werksvertrag/Dienstvertrag…)?

                                  Anmerkung: So weit der Orga bekannt haben Studis Rechte an ihren eigenen Arbeiten innerhalb von Lehrveranstaltungen. Es ist aber euer Verantwortung das vorher mit den AGs abzuklären.

                                  Bewertungsnotizen: Formaler Gesamteindruck