diff --git a/appendix.tex b/appendix.tex index 8378dbc..16cac95 100644 --- a/appendix.tex +++ b/appendix.tex @@ -6,4 +6,5 @@ \input{appendix/interview-questions} \input{appendix/fragebogen-extern} \input{appendix/interview-protokoll} + \input{appendix/pflichtenheft} \end{appendices} diff --git a/appendix/interview-protokoll.tex b/appendix/interview-protokoll.tex index 584b4d0..489081c 100644 --- a/appendix/interview-protokoll.tex +++ b/appendix/interview-protokoll.tex @@ -1,5 +1,5 @@ \chapter{Interview-Protokoll} -\label{chap:interview-protokoll} +\label{chap:anhang-interview-protokoll} \begin{table}[htbp] \centering @@ -21,25 +21,25 @@ - Wird aufgemacht - Ziehen qr code raus - Haben entweder Handscanner oder handy und scannen den code ein -- system gibt an, welche Einlieferungsnummer aufgeklebt werden muss +- system gibt an, welche \ac{ELN} aufgeklebt werden muss - wein wird eingelagert -Die Einlieferungsnummer muss im Verein mit der Jahresauswahlprobe unique sein. -Die Einlieferungsnummer ist dann im Format {Einlieferungsnummer}-{Jahresauswahl\-probennummer} -z.b. 19-1 gesetzt. Das steht für Einlieferungsnummer 19, Jahresauswahlprobe 1. +Die \ac{ELN} muss im Verein mit der \ac{JAP} unique sein. +Die \ac{ELN} ist dann im Format {\ac{ELN}}-{Jahresauswahl\-probennummer} +z.b. 19-1 gesetzt. Das steht für \ac{ELN} 19, \ac{JAP} 1. Auf Datenkbankebene unique. Es wird bei 1 angefangen zu zählen. \paragraph*{Mit was soll dieser Code gescannt werden? Soll der Scanner in der Applikation eingebaut sein, oder soll das System auch mit Drittanbieter-Apps funktionieren?} Smartphone ist am sinnvollsten, da feedback von Webseite -Backup-Funktion die Einliefungsnummer händisch einzugeben. Das ginge dann auch mit einem Handscanner. +Backup-Funktion die \ac{ELN} händisch einzugeben. Das ginge dann auch mit einem Handscanner. \paragraph*{Von welchem Endgerät wird gescannt?} Es gibt dedizierte Scanhardware, die sich vor Ort befindet. Das genaue Gerät wird in Kürze festgestellt. \paragraph*{Welche Fallbacks soll es geben, sollte ein Code nicht scanbar sein? Z.B.: Der Code- Inhalt in Text unter dem Code, der auch von Hand eintippbar sei.} -Einlieferungsnummer händisch eingeben. -Die ELN (Einlieferungsnummer) muss also auch unter dem qr code stehen, aber das ist für uns out-of-scope. +\ac{ELN} händisch eingeben. +Die \ac{ELN} muss also auch unter dem qr code stehen, aber das ist für uns out-of-scope. Das ist nicht der QR-Code, den wir generieren, sondern der, der beim Einlagern auf die Flasche geklebt wird. Diese lässt Weinland Mosel im Voraus drucken. @@ -51,9 +51,9 @@ Gespeichert in der Datenbank. \paragraph*{Gibt es im Lager Wlan?} Out of scope -Es gibt eine Liste mit Jahrsauswahlproben +Es gibt eine Liste mit \acp{JAP} Da werden verschiedene aufgelistet -Backenduser können die Anmeldung (Weine an Proben anmelden) an-und-abschalten. +Backenduser können die Anmeldung (Weine an \acp{JAP} anmelden) an-und-abschalten. Vergangene Proben werden nicht angezeigt. Die Probe gilt als vergangen, wenn die Proben probiert wurden. Die Anmeldemöglichkeit und Probenanzeige im Anmeldetool ist ein Clone vom „active until“ im „access-„panel. Mit dateselector. @@ -67,10 +67,10 @@ Wenn Nichtmitglied: Ggf account erstellen ohne Mitgliedsnummer -Eine Jahresauswahlprobe auswählen +Eine \ac{JAP} auswählen Einen Wein anmelden, Webform zu Weindaten ausfüllen. PDF downloaden, ausdrucken im Paket dem Wein beilegen. -Das PDF muss Daten zum Wein beinhalten, und den qr-code mit der Einlieferungsnummer. (zur Zuordnung) +Das PDF muss Daten zum Wein beinhalten, und den qr-code mit der \ac{ELN}. (zur Zuordnung) Nummernschwund, falls Weine gelöscht werden, ist kein Problem. 196 darf auf 194 folgen. Adressierung wird selbst gemacht. @@ -89,12 +89,12 @@ Frankierung auch. \paragraph*{Soll auch ein Kunde in der Lage sein, seine eigene Weinsendung(en) aus dem System zu löschen oder zu verändern? (Eventuell vertippt man sich) Wenn ja, bis wann? Bis zur Eingangsbestätigung?} Nach Einreichung (nicht Eingang bei WM) nicht mehr veränderbar und auch nicht löschbar. -\paragraph*{Die Einlieferungsnummer ist eine inkrementell erhöhte Ganzzahl. Ist der tatsäch- liche Wert dieser wichtig, oder ist es lediglich wichtig, dass sie eindeutig ist? Der einfachste/günstigste Weg wäre es, sie in der Datenbank als “auto\_increment” zu deklarieren. Dann hätte man niemals, auch über x Auswahlproben hinweggehend, die selbe Einlieferungsnummern- zwei mal. Das verkürzt und vereinfacht die Entwick- lung, den entstehenden Code, und die Nutzererfahrung auf Seiten von Weinland Mosel.} +\paragraph*{Die \ac{ELN} ist eine inkrementell erhöhte Ganzzahl. Ist der tatsäch- liche Wert dieser wichtig, oder ist es lediglich wichtig, dass sie eindeutig ist? Der einfachste/günstigste Weg wäre es, sie in der Datenbank als “auto\_increment” zu deklarieren. Dann hätte man niemals, auch über x Auswahlproben hinweggehend, die selbe \acp{ELN}- zwei mal. Das verkürzt und vereinfacht die Entwick- lung, den entstehenden Code, und die Nutzererfahrung auf Seiten von Weinland Mosel.} - siehe oben \paragraph*{Weiteres} -Es soll einen single-view für weine geben, der anhand einer Einlieferungsnummer aufrufbar ist. +Es soll einen single-view für weine geben, der anhand einer \ac{ELN} aufrufbar ist. \paragraph*{Zum Formular, das Winzer ausfüllen:} Das Formular besteht zwei Schritten: diff --git a/appendix/interview-questions.tex b/appendix/interview-questions.tex index f856821..2b479ff 100644 --- a/appendix/interview-questions.tex +++ b/appendix/interview-questions.tex @@ -46,9 +46,9 @@ Wenn ja, bis wann? Bis zur Eingangsbestätigung? Ist hierbei eine Bulk-Action wichtig? \\ \\ -Die Einlieferungsnummer ist eine inkrementell erhöhte Ganzzahl. +Die \ac{ELN} ist eine inkrementell erhöhte Ganzzahl. Ist der tatsächliche Wert dieser wichtig, oder ist es lediglich wichtig, dass sie eindeutig ist? Der einfachste/günstigste Weg wäre es, sie in der Datenbank als \enquote{auto\_increment} zu deklarieren. -Dann hätte man niemals, auch über x Auswahlproben hinweggehend, die selbe Einlieferungsnummer zwei mal. +Dann hätte man niemals, auch über x Auswahlproben hinweggehend, die selbe \ac{ELN} zwei mal. Das verkürzt und vereinfacht die Entwicklung, den entstehenden Code, und die Nutzererfahrung auf Seiten von Weinland Mosel. diff --git a/appendix/pflichtenheft.tex b/appendix/pflichtenheft.tex new file mode 100644 index 0000000..c2247cb --- /dev/null +++ b/appendix/pflichtenheft.tex @@ -0,0 +1,37 @@ +\chapter{Pflichtenheft} +\label{chap:anhang-pflichtenheft} + +\begin{table}[htbp] + \centering + \begin{tabular}{|l|l|} + \hline + \textbf{Art} & \textbf{Beschreibung}\\ + \hline + \hline + Constraint & Einbau in brown-field TYPO3\\\hdashline + Constraint & Kunden-UI im Frontend\\\hdashline + \ac{FA} & \makecell[l]{Mitglieder bei \ac{WM} können sich einen Nutzeraccount erstellen}\\\hdashline + \ac{FA} & \makecell[l]{Nicht-Mitglieder bei \ac{WM} können sich einen Nutzeraccount\\erstellen}\\\hdashline + \ac{FA} & \makecell[l]{Angemeldete Nutzer sehen eine Übersicht aller\\aktiven \acp{JAP}}\\\hdashline + \ac{FA} & \makecell[l]{Angemeldete Nutzer können mehrere Weine bei aktiven\\\acp{JAP} anmelden}\\\hdashline + \ac{FA} & \makecell[l]{Eine Weinanmeldung frägt Weindaten mit einem Webform ab}\\\hdashline + \ac{FA} & \makecell[l]{Vor Abschluss des Formulars wird eine Übersicht der\\Daten gezeigt}\\\hdashline + \ac{FA} & \makecell[l]{Das Formular lässt sich mit einem \enquote{Jetzt verbindlich anmelden}\\abschicken}\\\hdashline + \ac{FA} & \makecell[l]{Angemeldete Nutzer sehen angemeldete Weine für\\\acp{JAP} inklusive Versandstatus}\\\hdashline + \ac{FA} & \makecell[l]{Für angemeldete Weine lassen sich PDF-Dateien herunterladen, die\\die \ac{ELN} als Barcode und eine Beschreibung des Weines enthalten}\\\hdashline + \ac{NFA} & \makecell[l]{Das Formular mit Weindaten und dem QR-Code lässt sich\\auch direkt nach Anmeldung eines Weines herunterladen}\\\hdashline + \ac{FA} & \makecell[l]{Mitarbeiter von \ac{WM} können eingetragene Weine als\\TYPO3-Objekte manipulieren}\\\hdashline + \ac{FA} & \makecell[l]{Mitarbeiter von \ac{WM} können \acp{JAP} im Backend\\zeitgesteuert für Anmeldungen freigeben}\\\hdashline + \ac{FA} & \makecell[l]{Mitarbeiter von \ac{WM} können \acp{JAP} im Backend\\zeitgesteuert für die Einsicht freigeben}\\\hdashline + \ac{FA} & \makecell[l]{Mitarbeiter von \ac{WM} können einen gesicherten API-Link anhand\\einer \ac{ELN} aufrufen um einen Wein als \enquote{eingegangen}\\zu markieren}\\\hdashline + \ac{NFA} & \makecell[l]{Der API-Link ist mittels eines API-Keys gesichert}\\\hdashline + \ac{NFA} & \makecell[l]{Der API-Key wird in POST-Daten übergeben}\\\hdashline + \ac{NFA} & \makecell[l]{Die \ac{ELN} wird url-kodiert übergeben}\\\hdashline + \ac{FA} & \makecell[l]{Mitarbeiter von \ac{WM} können diesen API-Key im Backend\\verändern}\\\hdashline + \ac{NFA} & \makecell[l]{Nach Aufruf eines API-Links wird gezeigt, weilcher Wein\\gescannt wurde}\\\hdashline + \ac{FA} & \makecell[l]{Nach Aufruf eines API-Links gibt es einen Button die\\Buchung zurückzuziehen}\\\hdashline + \ac{FA} & \makecell[l]{Es gibt eine Weboberfläche um \acp{ELN} händisch einzugeben}\\\hdashline + \ac{NFA} & \makecell[l]{Der Prozess soll auf ein GERÄT\_XYZ spezialisiert sein}\\ + \hline + \end{tabular} +\end{table} diff --git a/chapters/anforderungserfassung.tex b/chapters/anforderungserfassung.tex index 3e044e8..553704a 100644 --- a/chapters/anforderungserfassung.tex +++ b/chapters/anforderungserfassung.tex @@ -22,11 +22,11 @@ Wie oben erwähnt, sind bereits die Constraints und einige funktionale Anforderu \hdashline Constraint & Kunden-UI im Frontend\\ \hdashline - \ac{FA} & Aus dem Papierformular soll ein Webform werden\\ + \ac{NFA} & Aus dem Papierformular soll ein Webform werden\\ \hdashline - \ac{FA} & \makecell[l]{Angaben zum Weingut des Weines sollen aus dem\\Accountdatensatz anstatt aus dem Webform kommen}\\ + \ac{NFA} & \makecell[l]{Angaben zum Weingut des Weines sollen aus dem\\Accountdatensatz anstatt aus dem Webform kommen}\\ \hdashline - \ac{FA} & \makecell[l]{Registrierte Weinteilnahmen bestehen aus einem Wein\\und einem Zustand(Ausstehend,Eingegangen).}\\ + \ac{NFA} & \makecell[l]{Registrierte Weinteilnahmen bestehen aus einem Wein\\und einem Zustand(Ausstehend,Eingegangen).}\\ \hdashline \ac{FA} & \makecell[l]{Beim Erstellen einer Weinteilnahme soll ein QR-Code als\\PDF generiert werden, der den Wein identifiziert}\\ \hdashline @@ -68,3 +68,10 @@ Sämtliche Fragen an die Stakeholdergruppe \enquote{Mitarbeiter \ac{WM}} wurden beantwortet und als Anforderung festgehalten. Insofern gibt es schlichtweg keine offnen Fragen, die diese Stakeholdergruppe beantworten könnten. Damit fällt ein Onlinefragebogen für \enquote{Mitarbeiter \ac{WM}} weg. Der Fragebogen zur Stakeholdergruppe \enquote{teilnehmende Weingüter} liegt in \fullref{chap:anhang-fragebogen-extern} bei. + +\section{Ergebnisse} +Aus dem Interview mit dem Product Owner und dem Fragebogen an die Winzer ergibt ein Pflichtenheft. +Dieses ist im Anhang unter \fullref{chap:anhang-pflichtenheft} zu finden. +Das Interviewprotokoll und Fragebogenergebnisse sind im Anhang unter +\fullref{chap:anhang-interview-protokoll} und XXXX zu finden. + diff --git a/chapters/einleitung.tex b/chapters/einleitung.tex index cf8219d..461bc8c 100644 --- a/chapters/einleitung.tex +++ b/chapters/einleitung.tex @@ -1,8 +1,9 @@ \chapter{Einleitung} \label{chap:einleitung} -Der Regionalverband für Weine \ac{WM} lässt Weine in organisierten Weinproben von Juroren bewerten. +Der Regionalverband für Weine \ac{WM} lässt Weine in organisierten Weinproben, sog. \ac{JAP}, von Juroren bewerten. Teilnehmende Weingüter registrieren ihre Weine in verschiedenen Kategorien und schicken diese auf dem Postweg ein. -Dieser Prozess bildet sich in Form von ausgedruckten Formularen, die von Hand ausgefüllt und von Hand in eine Excel-Tabelle übertragen werden, ab. +Dieser Prozess bildet sich in Form von ausgedruckten Formularen, die von Hand ausgefüllt und von Hand in eine +Excel-Tabelle übertragen werden, ab. \section{Problemstellung} \label{chap:einleitung-problemstellung} @@ -24,7 +25,7 @@ Der Postweg stellt somit eine Lücke zwischen diesen Prozessen dar. Kommt ein teilnehmender Wein bei \ac{WM} an, wird das beiliegende Formular von Hand in eine Excel-Tabelle übertragen. Diese Schnittstelle ist besonders resourcenaufwändig und fehleranfällig, weil es oft vorkommt, dass die zuteils dysgraphisch verfassten Formulare nur schwer, mehrdeutig, oder gar nicht dechiffriert werden können. -In diesem Prozess wird der Teilnahme des Weines eine inkrementell aufsteigende Einlieferungsnummer zugewiesen, +In diesem Prozess wird der Teilnahme des Weines eine inkrementell aufsteigende \ac{ELN} zugewiesen, die anschließend in Form eines Aufklebers an der Flasche befestigt wird. Anschließend wird die Flasche im Lager verstaut. \section{Zielsetzung} diff --git a/dexes/acrodex.tex b/dexes/acrodex.tex index 727de9e..f5068da 100644 --- a/dexes/acrodex.tex +++ b/dexes/acrodex.tex @@ -18,6 +18,12 @@ \acro{NFA}[NFA]{Nichtfunktionale Anforderung} \acroplural{NFA}[FAs]{Nichtfunktionale Anforderungen} + +\acro{ELN}[ELN]{Einlieferungsnummer} +\acroplural{ELN}[ELNs]{Einlieferungsnummern} + +\acro{JAP}[JAP]{Jahresauswahlprobe} +\acroplural{JAP}[JAPs]{Jahresauswahlproben} % % \end{acronym} diff --git a/main.pdf b/main.pdf index 3d200ea..21a94bf 100644 Binary files a/main.pdf and b/main.pdf differ