feat: jap->jahresauswahlprobe

This commit is contained in:
Leon Etienne 2023-03-27 01:38:58 +02:00
parent 2819603046
commit db7e0dd5ea
Signed by: leonetienne
SSH Key Fingerprint: SHA256:hs2AZKjRTbd2kYg44u89rM19UT2LyBOpSbIShsdkkfg
7 changed files with 27 additions and 27 deletions

View File

@ -43,9 +43,9 @@ Mitarbeiter authentifizieren sich mit einem Frontend-Nutzer. Dieser Nutzer ist T
Out of scope
\paragraph*{Wie wollen Sie Weinanmeldungen zwischen Jahresauswahlproben im Frontend trennen? Wichtig: Aktuelle Proben nach Anmeldeschluss sollten immer noch sichtbar sein und alte Proben ggf. gar nicht mehr angezeigt werden.}
Es gibt eine Liste mit \acp{JAP}.
Es gibt eine Liste mit Jahresauswahlproben.
Da werden verschiedene aufgelistet.
Backenduser können die Anmeldung (Weine an \acp{JAP} anmelden) an- und abschalten.
Backenduser können die Anmeldung (Weine an Jahresauswahlproben anmelden) an- und abschalten.
Vergangene Proben werden nicht angezeigt.
Die Probe gilt als vergangen, wenn die Proben probiert wurden.
Die Anmeldemöglichkeit und \enquote{Probe ist vorbei}-Feststellung im Anmeldetool ist ein Clone vom „active until“ im „access-„panel. Mit Dateselector.
@ -58,7 +58,7 @@ In account einloggen
Wenn Nichtmitglied:
Ggf account erstellen ohne Mitgliedsnummer <muss händisch freigeschalten werden>
Eine \ac{JAP} auswählen
Eine Jahresauswahlprobe 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 \ac{ELN}. (zur Zuordnung)

View File

@ -12,17 +12,17 @@
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]{Angemeldete Nutzer sehen eine Übersicht\\aller aktiven Jahresauswahlproben}\\\hdashline
\ac{FA} & \makecell[l]{Angemeldete Nutzer können mehrere Weine\\bei aktiven Jahresauswahlproben 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}-Button abschicken}\\\hdashline
\ac{FA} & \makecell[l]{Angemeldete Nutzer sehen angemeldete\\Weine für \acp{JAP} inklusive Versandstatus}\\\hdashline
\ac{FA} & \makecell[l]{Angemeldete Nutzer sehen angemeldete\\Weine für Jahresauswahlproben 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 Jahresauswahlproben\\im Backend zeitgesteuert für Anmeldungen\\freigeben}\\\hdashline
\ac{FA} & \makecell[l]{Mitarbeiter von \ac{WM} können Jahresauswahlproben\\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{FA} & \makecell[l]{Wird ein Wein via dem QR-Code als \enquote{eingegangen}\\markiert, bekommt das Weingut eine Email}\\\hdashline
\ac{NFA} & \makecell[l]{Der API-Link ist mittels eines API-Keys gesichert}\\
@ -42,7 +42,7 @@
\ac{NFA} & \makecell[l]{Nach Aufruf eines API-Links wird\\gezeigt, weilcher Wein gescannt wurde}\\\hdashline
\ac{FA} & \makecell[l]{Es gibt einen Single-View für\\Weine, der über eine \ac{ELN} in der URL erreichbar ist}\\\hdashline
\ac{NFA} & \makecell[l]{Der Wein-Single-View zeigt bekannte Weindaten}\\\hdashline
\ac{FA} & \makecell[l]{Mitarbeiter von \ac{WM} können Weineintragungen\\je nach \ac{JAP} als CSV exportieren}\\
\ac{FA} & \makecell[l]{Mitarbeiter von \ac{WM} können Weineintragungen\\je nach Jahresauswahlprobe als CSV exportieren}\\
\hline
\end{tabular}
\end{table}

View File

@ -94,11 +94,11 @@ Die wichtigsten Erkenntnisse des Interviews sind:
QRBot ermöglicht es Nutzern für jeden aufgerufenen QR-Code eine Vorlagen-URL aufzurufen,
um den gescannten Wert als Teil der Url, z.B. als Get-Parameter, zu übergeben \cite{bib:qrbot}.
Das ist prädestiniert für API-ähnliche Webseitenaufrufe, um Weine einzuchecken.
\item[Trennung von Weinen nach \acp{JAP} im Frontend]\hfill\\
Da es $n$ \acp{JAP} gibt und Weine immer genau einer \ac{JAP} zugeordnet sein müssen, macht es wenig
\item[Trennung von Weinen nach Jahresauswahlproben im Frontend]\hfill\\
Da es $n$ Jahresauswahlproben gibt und Weine immer genau einer Jahresauswahlprobe zugeordnet sein müssen, macht es wenig
Sinn alle Weine eines Nutzers auf einmal anzuzeigen. So ist es eine Anforderung, dass die
Weinansicht in zwei Ebenen unterteilt ist: Die erste Ebene soll eine Auflistung aller \ac{JAP} sein
und in der Einzelansicht der \acp{JAP} sollen alle Weine aufgelistet sein, die dieser \ac{JAP} angehören.
Weinansicht in zwei Ebenen unterteilt ist: Die erste Ebene soll eine Auflistung aller Jahresauswahlprobe sein
und in der Einzelansicht der Jahresauswahlproben sollen alle Weine aufgelistet sein, die dieser Jahresauswahlprobe angehören.
Diese Weine sind ebenso anklickbar und führen zu einer Einzelansicht der Weine.
\item[Genaue Nutzerführung für Teilnehmer]\hfill\\
Die exakten Schritte, die ein Teilnehmer tätigen muss, um verschiedene Prozesse zu durchlaufen.
@ -117,8 +117,8 @@ Die wichtigsten Erkenntnisse des Interviews sind:
\item PDF-Url für Versandbriefe
\item Registrierungsseite mit mehreren Schritten
\item Mitarbeiter-Seite für gescannte QR-Codes
\item Listenansicht der \acp{JAP} im CSV-Exporter im Backend
\item Detailansicht der \ac{JAP} im CSV-Exporter im Backend
\item Listenansicht der Jahresauswahlproben im CSV-Exporter im Backend
\item Detailansicht der Jahresauswahlprobe im CSV-Exporter im Backend
\end{itemize}
\end{description}

View File

@ -2,7 +2,7 @@
\label{chap:ausblick}
In Ausblick nach der Umsetzung der Anmeldung und Zustellung von Weinen für Weinproben des Regionalverbunds für Weine
der Weinregion Mosel als TYPO3-Extension gilt es diese TYPO3-Extension um Funktionalität zu erweitern, sodass der gesamte
Geschäftsprozess der \ac{JAP} abgedeckt ist.
Geschäftsprozess der Jahresauswahlprobe abgedeckt ist.
\begin{nicepic}
\includegraphics[width=1\textwidth]{images/geschäftsprozess-ausblick.png}
@ -11,8 +11,8 @@ Geschäftsprozess der \ac{JAP} abgedeckt ist.
\label{fig:geschaeftsprozess-ausblick}
\end{nicepic}
Der vom Kunden langfristig erwünschte Zustand ist, dass der gesamte Geschäftsprozess der \ac{JAP} teilautomatisiert wird.
Das betrifft auch, aber nicht nur, das Aufteilen von \acp{JAP} in Tische und Flights, das sichere Sammeln und Auswerten
Der vom Kunden langfristig erwünschte Zustand ist, dass der gesamte Geschäftsprozess der Jahresauswahlprobe teilautomatisiert wird.
Das betrifft auch, aber nicht nur, das Aufteilen von Jahresauswahlproben in Tische und Flights, das sichere Sammeln und Auswerten
der Bewertungen und das Publizieren der daraus resultierenden Ergebnisse.
Auch ist es angedacht die Weinanmeldung zu Jahresauswahlproben um komplexe Funktionalität zu erweitern, die sicherstellen soll, dass
nicht gegen kategorische Restriktionen verstoßen werden kann. Somit soll vermieden werden, dass Weinanmeldungen

View File

@ -1,6 +1,6 @@
\chapter{Einleitung}
\label{chap:einleitung}
Der Regionalverband für Weine \ac{WM} lässt Weine in organisierten Weinproben, sog. \acp{JAP}, von Juroren bewerten.
Der Regionalverband für Weine \ac{WM} lässt Weine in organisierten Weinproben, sog. Jahresauswahlproben, 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 ausgedruckter Formulare, die von Hand ausgefüllt und von Hand in eine
Excel-Tabelle übertragen werden, ab.

View File

@ -3,14 +3,14 @@
\section{Praktische Ergebnisse}
Die TYPO3-Erweiterung ist umgesetzt und erfüllt die vereinbarten Anforderungen.
Mitglieder und nicht-Mitgleder können Teilnehmernutzer anlegen und Weine zu \acp{JAP} anmelden.
Mitglieder und nicht-Mitgleder können Teilnehmernutzer anlegen und Weine zu Jahresauswahlproben anmelden.
Teilnehmer bekommen ein PDF-Dokument mit einem QR-Code zur späteren Zuordnung bereitgestellt.
\ac{WM}-Mitarbeiter können diesen QR-Code einscannen, um Weine als \enquote{angekommen} zu markieren.
Redakteure von \ac{WM} können Zugriffsrechte und Verhalten der \acp{JAP} auf verschiede Weisen einschränken.
Redakteure von \ac{WM} können Zugriffsrechte und Verhalten der Jahresauswahlproben auf verschiede Weisen einschränken.
Sie können den Sichtbarkeitszeitraum, den Anmeldezeitraum und den Probezeitraum, der definiert ab
wann teilnehmende Weine öffentlich sind, festlegen.
Sie können \acp{JAP} und damit deren Anmeldeformulare, auf festgelegte Wettebwerbskategorien beschränken.
Mitarbeiter können Weindatensätze, getrennt nach \acp{JAP}, als CSV-Dokument exportieren und somit
Sie können Jahresauswahlproben und damit deren Anmeldeformulare, auf festgelegte Wettebwerbskategorien beschränken.
Mitarbeiter können Weindatensätze, getrennt nach Jahresauswahlproben, als CSV-Dokument exportieren und somit
den verbleibenden Geschäftsprozess wie gehabt fortsetzen.
\section{Forschungsergebnisse}

View File

@ -101,7 +101,7 @@ eingesehen, gelöscht und bearbeitet werden.
Ein essenzieller Teil des Jahresauswahlprobenwerkzeuges ist die Registrierung von Teilnehmern.
Dieses Modul repräsentiert den ersten Berührungspunkt der Winzer mit dem System.
Hiervon profitiert \ac{WM}, weil registrierte Benutzer der Webseite eine Grundvorausetzung
für die Onlineregistrierung von Weinen zu \acp{JAP} sind.
für die Onlineregistrierung von Weinen zu Jahresauswahlproben sind.
Dem Pflichtenheft ist zu entnehmen, dass es zwei Kategorien von Teilnehmerregistrierungen gibt:
\begin{enumerate}
\item Nutzer ist \ac{WM}-Mitglied
@ -230,7 +230,7 @@ Mitarbeitern bearbeitet werden müssen. Davon profitiert \ac{WM}, da diese Zeit
\subsubsection*{IT-Sicherheit}
Es ist wichtig zu erwähnen, dass solche Überprüfungen,
wie das Aktivsein eines Registrierungszeitraumes einer \ac{JAP}, grundsätzlich im Backend, d.h. serverseitig
wie das Aktivsein eines Registrierungszeitraumes einer Jahresauswahlprobe, grundsätzlich im Backend, d.h. serverseitig
auf der betroffenen Webseite (in diesem Beispiel der Weinanmeldungsseite) durchgeführt werden.
Das Verstecken der zugehörigen
Schaltfläche im Frontend dient lediglich der User-Experience und stellt keine Sicherheitsvorkehrung dar.
@ -391,14 +391,14 @@ Detailansichten für Weine sind immer für den zugehörigen Teilnehmer einsichti
Nach Abschluss einer Jahresauswahlprobe sind alle ihr angehörigen Weine öffentlich einsichtig.
Das hat den Hintergrund, dass Jahresauswahlproben Blindverkostungen sind
und niemand die Möglichkeit haben sollte, im Voraus Informationen über die teilnehmenden Weine in Erfahrung zu bringen.
Die Ergebnisse der Jahresauswahlproben sind öffentlich, also sind es die Weine nach Abschluss einer \ac{JAP} auch.
Die Ergebnisse der Jahresauswahlproben sind öffentlich, also sind es die Weine nach Abschluss einer Jahresauswahlprobe auch.
Mitarbeiter von Weinland Mosel, wenn mit einem solchen Account angemeldet, haben immer Einsicht in Wein-Detailansichten.
Die Wein-Detailseite verfügt außerdem über einen \enquote{Versandetikett drucken}-Button, der auf das Versand-PDF verlinkt.
Dieser Button ist nur für den zugehörigen Teilnehmer und Mitarbeiter verfügbar.
Diese Daten, Fakten und Restriktionen werden serverseitig kontrolliert, um Manipulationen des Nutzers auszuschließen.
Um das zu realisieren werden Daten mit Fluid-Templates konditionell dargestellt und über Fluid-ViewHelper Links
zu anderen Ansichten generiert. Diese ViewHelper übergeben Parameter. Die hierfür relevanten Parameter der verschiedenen
Ansichten sind beispielsweise Wein-\acp{UID} und \ac{JAP}-\acp{UID}. Um Informationen über den angemeldeten Nutzer,
Ansichten sind beispielsweise Wein-\acp{UID} und Jahresauswahlprobe-\acp{UID}. Um Informationen über den angemeldeten Nutzer,
wie beispielsweise seiner Teilnehmernummer oder seiner Nutzergruppenzugehörigkeit, zu erlangen, wird sich
der Extbase-nativej Domain-Model-FrontendUser-Klasse bedient \cite{bib:typo3-ref-extbase-model-feuser}.