diff --git a/docs/index.md b/docs/index.md index 43b553f..0da024e 100644 --- a/docs/index.md +++ b/docs/index.md @@ -18,216 +18,11 @@ Ein Reparateur ist ein Mitglied des Repair-Cafés das die Gäste bei der Reparat Ein Organisator ist Mitglied des Repair-Cafés das die Termine mit den Gästen organisiert und die Reparateure zu den Geräten zuordnet. -## Anwendungsfälle - -Die Anwendungsfälle sind in Meilensteine unterteilt. -Zu Meilenstein 1 (M1) gehören alle Anwendungsfälle die notwendig sind um RepApp "produktiv" für die Anmeldung von Geräten zu verwenden. - -### Gast - -- [x] M1: Als Gast möchte ich einen Termin für eine Reparatur vereinbaren. (A1) -- [x] M1: Als Gast möchte ich eine Bestätigung für eine Reparaturanfrage bekommen. (A2) -- [ ] M1: Als Gast möchte ich eine Terminbenachrichtigung oder eine Absage bekommen. (A3) -- [ ] M1: Als Gast möchte ich Rückfragen zum Gerät empfangen und diese beantworten können. (A5) -- [ ] M1: Als Gast möchte ich Fragen ans Repair-Café stellen können. (A26) -- [ ] M1: Als Gast möchte ich ausschließlich per eMail mit dem System interagieren können. (A30) -- [ ] M1: Als Gast möchte per eMail Fragen ans Team stellen können. (A33) -- [ ] M1: Als Gast möchte ich per eMail auf Rückfragen antworten können. (A34) -- [ ] M1: Als Gast möchte ich eine Termineinladung per eMail bestätigen können. (A35) - -- [ ] Als Gast möchte ich mein angemeldetes Gerät und dessen Status einsehen können. (A4) -- [ ] Als Gast möchte ich ein Gerät für eine Folgereparatur anmelden können. (A6) -- [ ] Als Gast möchte ich meine Daten ansehen können. (A21) -- [ ] Als Gast möchte ich meine Daten löschen können. (A22) -- [ ] Als Gast möchte ich eine Geräteanmeldung löschen können. (A23) - -### Reparateur - -- [ ] M1: Als Reparateur möchte ich die angemeldeten Geräte ansehen können. (A7) -- [ ] M1: Als Reparateur möchte ich mir ein angemeldetes Gerät zuordnen können. (A8) -- [ ] M1: Als Reparateur möchte ich Rückfragen zum Gerät stellen können. (A10) -- [ ] M1: Als Reparateur möchte ich eine Benachrichtigung bekommen wenn eine Rückfrage beantwortet wird. (A11) -- [ ] M1: Als Reparateur möchte ich eine Benachrichtigung bekommen wenn mir ein Gerät zugeordnet wird. (A12) -- [ ] M1: Als Reparateur möchte ich mich für ein Repair-Café anmelden können. (A13) -- [ ] M1: Als Reparateur möchte ich mich für ein Repair-Café abmelden können. (A14) - -- [ ] Als Reparateur möchte ich ein angemeldetes Gerät ablehnen können. (A9) -- [ ] Als Reparateur möchte ich benachrichtigt werden wenn ein Gast eine mir zugeordnete Geräteanmeldung löscht. (A25) - -### Organisator - -- [x] M1: Als Organisator möchte ich benachrichtigt werden wenn ein Gast ein Gerät anmeldet. (A25) -- [ ] M1: Als Organisator möchte ich ein Repair-Café anlegen können. (A15) -- [ ] M1: Als Organisator möchte ich die Geräte einsehen können. (A16) -- [ ] M1: Als Organisator möchte ich eine Rückfrage zu einem Geräte stellen können. (A17) -- [ ] M1: Als Organisator möchte ich ein Geräte ablehnen können. (A18) -- [ ] M1: Als Organisator möchte ich ein Geräte zu einem Termin zuordnen können. (A19) -- [ ] M1: Als Organisator möchte ich einen Reparateur zu einem Termin zuordnen können. (A20) -- [ ] M1: Als Organisator möchte ich ein Gerät bearbeiten können. (A28) -- [ ] M1: Als Organisator möchte ich ein Gerät absagen können, wenn der Gast mich informiert hat dass er nicht kommt. (A29) - -- [ ] Als Organisator möchte ich benachrichtigt werden wenn ein Gast eine Geräteanmeldung löscht. (A24) -- [ ] Als Organisator möchte ich alle Daten exportieren können. (A31) -- [ ] Als Organisator möchte ich Geräte auf ein späteres Repair-Café verschieben können. (A32) - -## Daten - - -### Benutzer - -Ein Repapp-Benutzer erweitert den Standard-Benutzer um eine eindeutige eMail-Adresse, um diese als Identifikationsmerkmal verwenden zu können. - -### Cafe - -Ein Cafe ist ein Repair-Café Termin. - -Attribute: - -- Ort: Beschreibung wo das Repair-Café stattfindet -- Adresse: Adresse an der das Repair-Café stattfindet -- Datum: Datum der Veranstaltung - -Annahmen: - -- Ein Repair-Café beginnt um 13:00 Uhr. -- Ein Repair-Café hat drei aufeinanderfolgende Zeitslots pro Reparateur mit je einer Stunde - -### Reparateur - -Ein Reparateur ist ein Mitglied des Repair-Cafés das Gäste bei der Reparatur ihrer Geräte unterstützt. - -Attribute: - -- Name: Name des Reparateurs -- Mail: eMail-Adresse für Benachrichtigungen - -Annahmen: - -- Reparateure sind immer verfügbar, d.h. Zeitslots für jeden Reparateur werden zu einem neuen Repair-Café Termin automatisch hinzugefügt. -- Reparateure können alles reparieren. Geräte Kategorien, Skills, ... werden im Moment nicht berücksichtigt. - -### Organisator - -Ein Organisator ist ein Mitglied des Repair-Cafés das Reparaturtermine mit den Gästen vereinbart. - -Attribute: - -- Name: Name des Organisators -- Mail: eMail-Adresse für Benachrichtigungen - -### Gast - -Ein Gast ist ein Gerätebesitzer, der ein Gerät zur Reparatur anmeldet. - -Attribute: - -- Name: Name des Gastes -- Telefon: Festnetz oder Mobilnummer des Gastes -- Wohnort: Wohnort des Gastes -- Mail: eMail-Adresse des Gastes für Benachrichtigungen - -Technische Attribute: - -- Identifier: SHA256 Hash aus Name + Wohnort + Timestamp -- Benutzer: Referenz zum Benutzer der für diesen Gast erstellt wurde. - -### Gerät - -Ein Gerät ist ein defekter Gegenstand der im Rahmen eines Repair-Cafés repariert werden soll. - -Attribute: - -- Erstellungsdatum: Datum an dem diese Gerät angemeldet wurde. -- Gerät: Bezeichnung des Geräts -- Hersteller: Hersteller des Geräts -- Fehler: Beschreibung des Defekts -- Folgetermin: Boolesches Flag das anzeigt ob es sich um einen Folgetermin handelt. -- Foto vom Gerät -- Foto vom Typenschild -- Bestätigung gesendet?: Ein boolesches Flag das anzeigt ob eine eMail als Anmeldebestätigung gesendet wurde. - -Technische Attribute: - -- Identifier: SHA256 Hash aus Gerät + Gast + Timestamp -- Gast: Referenz zum Gast der das Gerät besitzt -- Cafe: Referenz zum Repair-Café für das diese Gerät angemeldet ist - -### Termin - -Ein Termin ist eine Zuordnung von einem Gerät zu einem Zeitslot der Repair-Café Veranstaltung und einem Reparateur. -Ein Termin ist bestätigt, wenn eine Organisator eine Termineinladung gesendet hat und er Gast diese bestätigt hat. - -Attribute: - -- Uhrzeit: Uhrzeit des Termins -- Betätigt: Boolesches Flag. True wenn die Einladung vom Gast bestätigt wurde. - -Technische Attribute: - -- Cafe: Referenz zum Cafe -- Reparateur: Referenz um Reparateur oder NULL -- Gerät: Referenz zum Gerät - -### Frage - -Eine Frage ist eine Rückfrage nach mehr Informationen zu einem Gerät, erstellt von einem Organisator oder einem Reparateur. - -Attribute: - -- Frage: Frage zum Gerät oder Defekt -- Antwort: Antwort des Gastes -- Erstellungsdatum: Datum der Erstellung der Rückfrage - -Technische Attribute: - -- Organisator: Referenz zum Organisator oder NULL -- Reparateur: Referenz zum Reparateur oder NULL -- Gerät: Referenz zum Gerät - -### Kandidat - -Ein Kandidat ist ein Geräte ohne festen Termin. -Diese Geräte werden von den Gästen zu Beginn des Repair-Café gebracht und am Ende abgeholt. -Falls ein Reparateur Zeit hat kann er eines dieser Geräte reparieren. - -- Bestätigt: Boolesches Flag. True wenn die Einladung vom Gast bestätigt wurde. - -Technische Attribute: - -- Cafe: Referenz zum Cafe -- Gerät: Referenz zum Gerät - -### Einmal-Login - -Ein Einmal-Login ist ein Geheimnis das es einem Gast erlaubt sich einmalig damit anzumelden. - -- Geheimnis: Geheimnis um den Gast zu identifizieren. -- URL: URL die nach der Anmeldung angezeigt werden soll. -- Erstellungsdatum: Datum an dem der Einmal-Login angelegt wurde. -- Login benutzt?: Boolesches Flag. True wenn der Einmal-Login bereits benutzt wurde. -- Login Datum: Datum an dem der Einmal-Login benutzt wurde, oder Datum der Erstellung, da das Feld aus technischen Gründen nicht leer sein kann. - -Technische Attribute: - -- Benutzer: Referenz zum Benutzer - -### Nachricht - -Eine Nachricht ist eine Anfrage von einem Gast. - -- Nachricht: Anfrage des Gastes. -- Antwort: Antwort an den Gast. -- Erstellungsdatum: Datum an dem die Anfrage erstellt wurde. - -Technische Attribute: - -- Gast: Referenz zum Gast - ## Anmelde Konzept RepApp unterstützt pro Benutzer-Gruppe verschiedenen Anmelde-Konzepte. -## Gäste +### Gäste Für Gäste wird automatsch ein Benutzerkonto angelegt, mit einem generierten, sicheren Passwort. Mit der eMail Adresse und dem Passwort kann ein Gast sich in der RepApp anmelden um seine Daten sehen und bearbeiten zu können. @@ -239,113 +34,22 @@ Nach dem erfolgreichen Login wird der Gast automatisch zu der hinterlegten URL w Wenn ein Gast versucht den Einmal-Link nochmals zu verwenden, schlägt dies Fehl, und dem Gast wird automatisch ein neuer Einmal-Link per eMail mitgeteilt. Dies wird dem Gast auch über entsprechende Nachrichten mitgeteilt. -## Mitarbeiter +### Mitarbeiter Der Login für Mitarbeiter ist nur über das Single-Sign-On der Repair-Cafés erlaubt (Keycloak), das mittels OIDC angebunden ist. Alle Mitarbeiter im Repair-Café haben dort bereits einen Benutzer, was zum einen sicherstellt dass es sich um einen Mitarbeiter handelt, und zum anderen auch die Veraltung der Benutzer in RepApp vereinfacht. -## Ansichten +## Geräte -### Landing Page: Repair-Cafés (S1) +Zur Reparatur angemeldete Geräte können in den folgenden Zuständen sein: -URL: / - -Name: index - -Sicherheit: Die Seite ist ohne Zugangsbeschränkung oder Anmeldung erreichbar. - -Diese Seite zeigt eine Liste der zukünftigen Repair-Café Termine. -Sie enthält pro Repair-Café einen Link um ein Gerät für dieses Repair-Café anzumelden. - -### Gerät anmelden (S2) - -URL: cafe/int:cafe/ - -Name: register_device - -Sicherheit: Die Seite ist ohne Zugangsbeschränkung oder Anmeldung erreichbar. - -Diese Seite zeigt das Formular zum anmelden der Geräte. -Das Formular hat die Felder `eMail-Adresse`, `Art des Geräts`, `Hersteller & Modell/Typ`, `Fehlerbeschreibung`, `Foto vom Gerät`, `Foto vom Typenschild`, ein Kontrollkästchen `Folgetermin`, ein Kontrollkästchen `Informationen zur Reparaturabwicklung`, ein Kontrollkästchen `Datenschutz` und einen Knopf `Absenden` zum senden des Formulars. - -Das Repair-Café zu dem die Anmeldung gehört ist über eine ID in der URL der Seite festgelegt. - -Falls die eMail Adresse zu einem bekannten Gast gehört, wird beim absenden des Formulars eine eMail-Benachrichtigung and die Organisatoren und Bestätigung an den Gast gesendet. - -### Gast anmelden (S3) - -URL: cafe/int:cafe/device/str:device_identifier/mail/str:mail/ - -Name: register_guest - -Sicherheit: Die Seite ist ohne Zugangsbeschränkung oder Anmeldung erreichbar. - -Diese Seite zeigt das Formular zum anmelden eines neuen Gastes. -Das Formular hat die Felder `Name`, `Telefon`, `Wohnort` und einen Knopf `Absenden` zum senden des Formulars. - -Die eMail-Adresse und das Gerät zu dem die Gast-Kontaktdaten gehören ist über IDs in der URL der Seite festgelegt. - -Beim absenden des Formulars eine eMail-Benachrichtigung and die Organisatoren und Bestätigung an den Gast gesendet. - -### Anmeldung bestätigt (S7) - -URL: cafe/int:cafe/device/str:device_identifier/confirm/ - -Name: register_device_final - -Sicherheit: Die Seite ist ohne Zugangsbeschränkung oder Anmeldung erreichbar. - -Die Seite Anmeldung bestätigt zeigt einen Hinweis dass die Anmeldung des Gerätes erfolgreich abgeschlossen wurde. - -Die Geräte ID ist in der URL der Seite festgelegt. - -### Geräte Detailseite (S5) - -URL: device/str:device_identifier/ - -Name: view_device - -Sicherheit: Diese Seite ist für alle Mitarbeiter und den Gast der das Gerät angemeldet hat erreichbar. - -Die Geräte Detailseite zeigt die Informationen `Art des Geräts`, `Hersteller & Modell/Typ`, `Fehlerbeschreibung`, `Foto vom Gerät`, `Foto vom Typenschild` und `Folgetermin` an. - -Das Gerät ist über IDs in der URL der Seite festgelegt. - -### Gast Detailseite (S6) - -URL: guest/profile/ - -Name: guest_profile - -Sicherheit: Die Seite enthält persönliche Daten und ist nur für den Gast zu dem sie gehört erreichbar. - -Die Gast Detailseite hat die Felder `Name`, `eMail`, `Telefon` und `Wohnort` die mit den Angaben des Gastes ausgefüllt sind. -Weiter enthält die Seite einen Knopf `Aktualisieren` der das Formular absendet. -Die Ansicht enthält auch eine Liste mit Links zu allen Geräten die der Gast angemeldet hat. - -Der Gast ist über den angemeldeten Benutzer festgelegt. - -## Abläufe - -### Anmeldung eines defekten Gerätes - -#### Variante: Neuer Gast (F1) - -Als neuer Gast der ein defekten Geräte anmelden möchte, - -- gehe ich auf die Seite (S1) der Repair-Café Termine. Dort klicke ich auf `Gerät anmelden` bei dem richtigen Repair-Café Termin. Dieser Klick bringt mich auf die nächste Seite. -- Die nächste Seite (S2) enthält ein Formular mit den Feldern `eMail-Adresse`, `Art des Geräts`, `Hersteller & Modell/Typ`, `Fehlerbeschreibung`, `Foto vom Gerät`, `Foto vom Typenschild`, ein Kontrollkästchen `Folgetermin`, ein Kontrollkästchen `Informationen zur Reparaturabwicklung` une ein Kontrollkästchen `Datenschutz`. Nachdem ich die Felder ausgefüllt habe klicke auf auf `Absenden`. Dieser Klick bringt mich auf die nächste Seite. -- Die nächste Seite (S3) enthält ein Formular mit den Feldern `Name`, `Telefon` und `Wohnort`. Nachdem ich die Felder ausgefüllt habe klicke auf auf `Absenden`. Dieser Klick bringt mich auf die nächste Seite. -- Die nächste Seite (S5) bestätigt mir die Anmeldung meines Gerätes. -- In meinem eMail Posteingang finde ich ebenfalls eine Bestätigung der Geräteanmeldung. - -#### Variante: Bekannter Gast (existierende eMail Adresse) (F2) - -Als bekannter Gast der ein defekten Geräte anmelden möchte, - -- gehe ich auf die Seite (S1) der Repair-Café Termine. Dort klicke ich auf `Gerät anmelden` bei dem richtigen Repair-Café Termin. Dieser Klick bringt mich auf die nächste Seite. -- Die nächste Seite (S2) enthält ein Formular mit den Feldern `eMail-Adresse`, `Art des Geräts`, `Hersteller & Modell/Typ`, `Fehlerbeschreibung`, `Foto vom Gerät`, `Foto vom Typenschild`, ein Kontrollkästchen `Folgetermin`, ein Kontrollkästchen `Informationen zur Reparaturabwicklung` une ein Kontrollkästchen `Datenschutz`. Nachdem ich die Felder ausgefüllt habe klicke auf auf `Absenden`. Dieser Klick bringt mich auf die nächste Seite. -- Die nächste Seite (S5) bestätigt mir die Anmeldung meines Gerätes. -- In meinem eMail Posteingang finde ich ebenfalls eine Bestätigung der Geräteanmeldung. +- (0) Neu: Das Gerät wurde vom Gast angemeldet und muss als nächstes durch einen Organisator überprüft werden. +- (-1) Neu: Das Gerät wurde abgelehnt. +- (1) Rückfrage: Bei der Überprüfung durch einen Organisator wurde festgestellt dass benötigte Informationen fehlen und eine Rückfrage an den Gast gesendet. Die Antwort ist noch nicht eingetroffen. +- (2) Rückfrage beantwortet: Eine Rückfrage der Organisation wurde durch den Gast beantwortet. Als nächstes muss die Antwort durch einen Organisator überprüft werden. +- (3) Warteliste: Das Gerät wurde durch die Organisation überprüft und kann einem Repair-Café zugeordnet werden. Jetzt können Reparateure das Gerät einsehen. +- (4) Reserviert: Ein Reparateur hat sich das Gerät zugeordnet. +- (6) Zugeordnet: Das Gerät ist einem Repair-Café zugeordnet. +- (7) Gebucht: Das Gerät ist einem Reparaturtermin zugeordnet. ## Konfigurationsparameter diff --git a/docs/models.md b/docs/models.md new file mode 100644 index 0000000..aab20eb --- /dev/null +++ b/docs/models.md @@ -0,0 +1,152 @@ +# Daten + + +## Benutzer + +Ein Repapp-Benutzer erweitert den Standard-Benutzer um eine eindeutige eMail-Adresse, um diese als Identifikationsmerkmal verwenden zu können. + +## Cafe + +Ein Cafe ist ein Repair-Café Termin. + +Attribute: + +- Ort: Beschreibung wo das Repair-Café stattfindet +- Adresse: Adresse an der das Repair-Café stattfindet +- Datum: Datum der Veranstaltung + +Annahmen: + +- Ein Repair-Café beginnt um 13:00 Uhr. +- Ein Repair-Café hat drei aufeinanderfolgende Zeitslots pro Reparateur mit je einer Stunde + +## Reparateur + +Ein Reparateur ist ein Mitglied des Repair-Cafés das Gäste bei der Reparatur ihrer Geräte unterstützt. + +Attribute: + +- Name: Name des Reparateurs +- Mail: eMail-Adresse für Benachrichtigungen + +Annahmen: + +- Reparateure sind immer verfügbar, d.h. Zeitslots für jeden Reparateur werden zu einem neuen Repair-Café Termin automatisch hinzugefügt. +- Reparateure können alles reparieren. Geräte Kategorien, Skills, ... werden im Moment nicht berücksichtigt. + +## Organisator + +Ein Organisator ist ein Mitglied des Repair-Cafés das Reparaturtermine mit den Gästen vereinbart. + +Attribute: + +- Name: Name des Organisators +- Mail: eMail-Adresse für Benachrichtigungen + +## Gast + +Ein Gast ist ein Gerätebesitzer, der ein Gerät zur Reparatur anmeldet. + +Attribute: + +- Name: Name des Gastes +- Telefon: Festnetz oder Mobilnummer des Gastes +- Wohnort: Wohnort des Gastes +- Mail: eMail-Adresse des Gastes für Benachrichtigungen + +Technische Attribute: + +- Identifier: SHA256 Hash aus Name + Wohnort + Timestamp +- Benutzer: Referenz zum Benutzer der für diesen Gast erstellt wurde. + +## Gerät + +Ein Gerät ist ein defekter Gegenstand der im Rahmen eines Repair-Cafés repariert werden soll. + +Attribute: + +- Erstellungsdatum: Datum an dem diese Gerät angemeldet wurde. +- Gerät: Bezeichnung des Geräts +- Hersteller: Hersteller des Geräts +- Fehler: Beschreibung des Defekts +- Folgetermin: Boolesches Flag das anzeigt ob es sich um einen Folgetermin handelt. +- Foto vom Gerät +- Foto vom Typenschild +- Bestätigung gesendet?: Ein boolesches Flag das anzeigt ob eine eMail als Anmeldebestätigung gesendet wurde. + +Technische Attribute: + +- Identifier: SHA256 Hash aus Gerät + Gast + Timestamp +- Gast: Referenz zum Gast der das Gerät besitzt +- Cafe: Referenz zum Repair-Café für das diese Gerät angemeldet ist + +## Termin + +Ein Termin ist eine Zuordnung von einem Gerät zu einem Zeitslot der Repair-Café Veranstaltung und einem Reparateur. +Ein Termin ist bestätigt, wenn eine Organisator eine Termineinladung gesendet hat und er Gast diese bestätigt hat. + +Attribute: + +- Uhrzeit: Uhrzeit des Termins +- Betätigt: Boolesches Flag. True wenn die Einladung vom Gast bestätigt wurde. + +Technische Attribute: + +- Cafe: Referenz zum Cafe +- Reparateur: Referenz um Reparateur oder NULL +- Gerät: Referenz zum Gerät + +## Frage + +Eine Frage ist eine Rückfrage nach mehr Informationen zu einem Gerät, erstellt von einem Organisator oder einem Reparateur. + +Attribute: + +- Frage: Frage zum Gerät oder Defekt +- Antwort: Antwort des Gastes +- Erstellungsdatum: Datum der Erstellung der Rückfrage + +Technische Attribute: + +- Organisator: Referenz zum Organisator oder NULL +- Reparateur: Referenz zum Reparateur oder NULL +- Gerät: Referenz zum Gerät + +## Kandidat + +Ein Kandidat ist ein Geräte ohne festen Termin. +Diese Geräte werden von den Gästen zu Beginn des Repair-Café gebracht und am Ende abgeholt. +Falls ein Reparateur Zeit hat kann er eines dieser Geräte reparieren. + +- Bestätigt: Boolesches Flag. True wenn die Einladung vom Gast bestätigt wurde. + +Technische Attribute: + +- Cafe: Referenz zum Cafe +- Gerät: Referenz zum Gerät + +## Einmal-Login + +Ein Einmal-Login ist ein Geheimnis das es einem Gast erlaubt sich einmalig damit anzumelden. + +- Geheimnis: Geheimnis um den Gast zu identifizieren. +- URL: URL die nach der Anmeldung angezeigt werden soll. +- Erstellungsdatum: Datum an dem der Einmal-Login angelegt wurde. +- Login benutzt?: Boolesches Flag. True wenn der Einmal-Login bereits benutzt wurde. +- Login Datum: Datum an dem der Einmal-Login benutzt wurde, oder Datum der Erstellung, da das Feld aus technischen Gründen nicht leer sein kann. + +Technische Attribute: + +- Benutzer: Referenz zum Benutzer + +## Nachricht + +Eine Nachricht ist eine Anfrage von einem Gast. + +- Nachricht: Anfrage des Gastes. +- Antwort: Antwort an den Gast. +- Erstellungsdatum: Datum an dem die Anfrage erstellt wurde. + +Technische Attribute: + +- Gast: Referenz zum Gast diff --git a/docs/use_cases.md b/docs/use_cases.md new file mode 100644 index 0000000..2f07450 --- /dev/null +++ b/docs/use_cases.md @@ -0,0 +1,52 @@ +# Anwendungsfälle + +Die Anwendungsfälle sind in Meilensteine unterteilt. +Zu Meilenstein 1 (M1) gehören alle Anwendungsfälle die notwendig sind um RepApp "produktiv" für die Anmeldung von Geräten zu verwenden. + +## Gast + +- [x] M1: Als Gast möchte ich einen Termin für eine Reparatur vereinbaren. (A1) +- [x] M1: Als Gast möchte ich eine Bestätigung für eine Reparaturanfrage bekommen. (A2) +- [ ] M1: Als Gast möchte ich eine Terminbenachrichtigung oder eine Absage bekommen. (A3) +- [ ] M1: Als Gast möchte ich Rückfragen zum Gerät empfangen und diese beantworten können. (A5) +- [ ] M1: Als Gast möchte ich Fragen ans Repair-Café stellen können. (A26) +- [ ] M1: Als Gast möchte ich ausschließlich per eMail mit dem System interagieren können. (A30) +- [ ] M1: Als Gast möchte per eMail Fragen ans Team stellen können. (A33) +- [ ] M1: Als Gast möchte ich per eMail auf Rückfragen antworten können. (A34) +- [ ] M1: Als Gast möchte ich eine Termineinladung per eMail bestätigen können. (A35) + +- [ ] Als Gast möchte ich mein angemeldetes Gerät und dessen Status einsehen können. (A4) +- [ ] Als Gast möchte ich ein Gerät für eine Folgereparatur anmelden können. (A6) +- [ ] Als Gast möchte ich meine Daten ansehen können. (A21) +- [ ] Als Gast möchte ich meine Daten löschen können. (A22) +- [ ] Als Gast möchte ich eine Geräteanmeldung löschen können. (A23) + +## Reparateur + +- [ ] M1: Als Reparateur möchte ich die angemeldeten Geräte ansehen können. (A7) +- [ ] M1: Als Reparateur möchte ich mir ein angemeldetes Gerät zuordnen können. (A8) +- [ ] M1: Als Reparateur möchte ich Rückfragen zum Gerät stellen können. (A10) +- [ ] M1: Als Reparateur möchte ich eine Benachrichtigung bekommen wenn eine Rückfrage beantwortet wird. (A11) +- [ ] M1: Als Reparateur möchte ich eine Benachrichtigung bekommen wenn mir ein Gerät zugeordnet wird. (A12) +- [ ] M1: Als Reparateur möchte ich mich für ein Repair-Café anmelden können. (A13) +- [ ] M1: Als Reparateur möchte ich mich für ein Repair-Café abmelden können. (A14) + +- [ ] Als Reparateur möchte ich ein angemeldetes Gerät ablehnen können. (A9) +- [ ] Als Reparateur möchte ich benachrichtigt werden wenn ein Gast eine mir zugeordnete Geräteanmeldung löscht. (A25) + +## Organisator + +- [x] M1: Als Organisator möchte ich benachrichtigt werden wenn ein Gast ein Gerät anmeldet. (A25) +- [ ] M1: Als Organisator möchte ich ein Repair-Café anlegen können. (A15) +- [ ] M1: Als Organisator möchte ich die Geräte einsehen können. (A16) +- [ ] M1: Als Organisator möchte ich eine Rückfrage zu einem Geräte stellen können. (A17) +- [ ] M1: Als Organisator möchte ich ein Geräte ablehnen können. (A18) +- [ ] M1: Als Organisator möchte ich ein Geräte zu einem Termin zuordnen können. (A19) +- [ ] M1: Als Organisator möchte ich einen Reparateur zu einem Termin zuordnen können. (A20) +- [ ] M1: Als Organisator möchte ich ein Gerät bearbeiten können. (A28) +- [ ] M1: Als Organisator möchte ich ein Gerät absagen können, wenn der Gast mich informiert hat dass er nicht kommt. (A29) + +- [ ] Als Organisator möchte ich benachrichtigt werden wenn ein Gast eine Geräteanmeldung löscht. (A24) +- [ ] Als Organisator möchte ich alle Daten exportieren können. (A31) +- [ ] Als Organisator möchte ich Geräte auf ein späteres Repair-Café verschieben können. (A32) + diff --git a/docs/views.md b/docs/views.md new file mode 100644 index 0000000..1d50837 --- /dev/null +++ b/docs/views.md @@ -0,0 +1,80 @@ +# Ansichten + +## Landing Page: Repair-Cafés (S1) + +URL: / + +Name: index + +Sicherheit: Die Seite ist ohne Zugangsbeschränkung oder Anmeldung erreichbar. + +Diese Seite zeigt eine Liste der zukünftigen Repair-Café Termine. +Sie enthält pro Repair-Café einen Link um ein Gerät für dieses Repair-Café anzumelden. + +## Gerät anmelden (S2) + +URL: cafe/int:cafe/ + +Name: register_device + +Sicherheit: Die Seite ist ohne Zugangsbeschränkung oder Anmeldung erreichbar. + +Diese Seite zeigt das Formular zum anmelden der Geräte. +Das Formular hat die Felder `eMail-Adresse`, `Art des Geräts`, `Hersteller & Modell/Typ`, `Fehlerbeschreibung`, `Foto vom Gerät`, `Foto vom Typenschild`, ein Kontrollkästchen `Folgetermin`, ein Kontrollkästchen `Informationen zur Reparaturabwicklung`, ein Kontrollkästchen `Datenschutz` und einen Knopf `Absenden` zum senden des Formulars. + +Das Repair-Café zu dem die Anmeldung gehört ist über eine ID in der URL der Seite festgelegt. + +Falls die eMail Adresse zu einem bekannten Gast gehört, wird beim absenden des Formulars eine eMail-Benachrichtigung and die Organisatoren und Bestätigung an den Gast gesendet. + +## Gast anmelden (S3) + +URL: cafe/int:cafe/device/str:device_identifier/mail/str:mail/ + +Name: register_guest + +Sicherheit: Die Seite ist ohne Zugangsbeschränkung oder Anmeldung erreichbar. + +Diese Seite zeigt das Formular zum anmelden eines neuen Gastes. +Das Formular hat die Felder `Name`, `Telefon`, `Wohnort` und einen Knopf `Absenden` zum senden des Formulars. + +Die eMail-Adresse und das Gerät zu dem die Gast-Kontaktdaten gehören ist über IDs in der URL der Seite festgelegt. + +Beim absenden des Formulars eine eMail-Benachrichtigung and die Organisatoren und Bestätigung an den Gast gesendet. + +## Anmeldung bestätigt (S7) + +URL: cafe/int:cafe/device/str:device_identifier/confirm/ + +Name: register_device_final + +Sicherheit: Die Seite ist ohne Zugangsbeschränkung oder Anmeldung erreichbar. + +Die Seite Anmeldung bestätigt zeigt einen Hinweis dass die Anmeldung des Gerätes erfolgreich abgeschlossen wurde. + +Die Geräte ID ist in der URL der Seite festgelegt. + +## Geräte Detailseite (S5) + +URL: device/str:device_identifier/ + +Name: view_device + +Sicherheit: Diese Seite ist für alle Mitarbeiter und den Gast der das Gerät angemeldet hat erreichbar. + +Die Geräte Detailseite zeigt die Informationen `Art des Geräts`, `Hersteller & Modell/Typ`, `Fehlerbeschreibung`, `Foto vom Gerät`, `Foto vom Typenschild` und `Folgetermin` an. + +Das Gerät ist über IDs in der URL der Seite festgelegt. + +## Gast Detailseite (S6) + +URL: guest/profile/ + +Name: guest_profile + +Sicherheit: Die Seite enthält persönliche Daten und ist nur für den Gast zu dem sie gehört erreichbar. + +Die Gast Detailseite hat die Felder `Name`, `eMail`, `Telefon` und `Wohnort` die mit den Angaben des Gastes ausgefüllt sind. +Weiter enthält die Seite einen Knopf `Aktualisieren` der das Formular absendet. +Die Ansicht enthält auch eine Liste mit Links zu allen Geräten die der Gast angemeldet hat. + +Der Gast ist über den angemeldeten Benutzer festgelegt. diff --git a/docs/workflows.md b/docs/workflows.md new file mode 100644 index 0000000..d6589c5 --- /dev/null +++ b/docs/workflows.md @@ -0,0 +1,64 @@ +# Abläufe + +## Gast: Anmeldung eines defekten Gerätes + +#### Variante: Neuer Gast (F1) + +Als neuer Gast der ein defekten Geräte anmelden möchte, + +- gehe ich auf die Seite (S1) der Repair-Café Termine. Dort klicke ich auf `Gerät anmelden` bei dem richtigen Repair-Café Termin. Dieser Klick bringt mich auf die nächste Seite. +- Die nächste Seite (S2) enthält ein Formular mit den Feldern `eMail-Adresse`, `Art des Geräts`, `Hersteller & Modell/Typ`, `Fehlerbeschreibung`, `Foto vom Gerät`, `Foto vom Typenschild`, ein Kontrollkästchen `Folgetermin`, ein Kontrollkästchen `Informationen zur Reparaturabwicklung` une ein Kontrollkästchen `Datenschutz`. Nachdem ich die Felder ausgefüllt habe klicke auf auf `Absenden`. Dieser Klick bringt mich auf die nächste Seite. +- Die nächste Seite (S3) enthält ein Formular mit den Feldern `Name`, `Telefon` und `Wohnort`. Nachdem ich die Felder ausgefüllt habe klicke auf auf `Absenden`. Dieser Klick bringt mich auf die nächste Seite. +- Die nächste Seite (S5) bestätigt mir die Anmeldung meines Gerätes. +- In meinem eMail Posteingang finde ich ebenfalls eine Bestätigung der Geräteanmeldung. + +### Variante: Bekannter Gast (existierende eMail Adresse) (F2) + +Als bekannter Gast der ein defekten Geräte anmelden möchte, + +- gehe ich auf die Seite (S1) der Repair-Café Termine. Dort klicke ich auf `Gerät anmelden` bei dem richtigen Repair-Café Termin. Dieser Klick bringt mich auf die nächste Seite. +- Die nächste Seite (S2) enthält ein Formular mit den Feldern `eMail-Adresse`, `Art des Geräts`, `Hersteller & Modell/Typ`, `Fehlerbeschreibung`, `Foto vom Gerät`, `Foto vom Typenschild`, ein Kontrollkästchen `Folgetermin`, ein Kontrollkästchen `Informationen zur Reparaturabwicklung` une ein Kontrollkästchen `Datenschutz`. Nachdem ich die Felder ausgefüllt habe klicke auf auf `Absenden`. Dieser Klick bringt mich auf die nächste Seite. +- Die nächste Seite (S5) bestätigt mir die Anmeldung meines Gerätes. +- In meinem eMail Posteingang finde ich ebenfalls eine Bestätigung der Geräteanmeldung. + +## Organisator: Neues Gerät - akzeptieren für ausgewähltes Repair-Café + +Als Organisator habe ich eine eMail bekommen dass ein neues Gerät angemeldet wurde. Ich möchte dieses Gerät nun ansehen un die Eingangsüberprüfung durchführen. +- Ich öffne die RepApp im Browser +- Im Menü klicke ich auf Mitarbeiter, was mich zur Single Sign On Anmeldung bringt. +- Ich melde mich mit meinem Repair-Café Konto an und werde automatisch zur Hauptmenü für die Organisatoren weitergeleitet. +- Im Hauptmenü sehe ich das neue Gerät im Bereich Geräte. +- Ich klicke auf den Knopf "Details" für das neue Gerät, und mein Browser öffnet eine Seite in der ich die Details zu dem Gerät sehe. Auf der Seite sind Knöpfe: `Annehmen für gewähltes Repair-Café`, `Annehmen für anderes Repair-Café`, `Ablehnen` und `Rückfrage`. Alle notwendigen Informationen sind vorhanden und ich entscheide mich das Gerät für das ausgewählte Repair-Café zu akzeptieren. Der Klick auf `Annehmen für gewähltes Repair-Café` bringt mich zurück zum Hauptmenü. +- In der Liste der neuen Geräte ist das gerade bearbeitete Gerät nicht mehr sichtbar. + +## Organisator: Neues Gerät - akzeptieren für späteres Repair-Café + +Als Organisator habe ich eine eMail bekommen dass ein neues Gerät angemeldet wurde. Ich möchte dieses Gerät nun ansehen un die Eingangsüberprüfung durchführen. +- Ich öffne die RepApp im Browser +- Im Menü klicke ich auf Mitarbeiter, was mich zur Single Sign On Anmeldung bringt. +- Ich melde mich mit meinem Repair-Café Konto an und werde automatisch zur Hauptmenü für die Organisatoren weitergeleitet. +- Im Hauptmenü sehe ich das neue Gerät im Bereich Geräte. +- Ich klicke auf den Knopf "Details" für das neue Gerät, und mein Browser öffnet eine Seite in der ich die Details zu dem Gerät sehe. Auf der Seite sind Knöpfe: `Annehmen für gewähltes Repair-Café`, `Annehmen für anderes Repair-Café`, `Ablehnen` und `Rückfrage`. Alle notwendigen Informationen sind vorhanden, aber da ich weiß dass im nächsten Repair-Café kein geeigneter Reparateur verfügbar ist entscheide ich mich das Gerät für ein späteres Repair-Café zu akzeptieren. Der Klick auf `Annehmen für anderes Repair-Café` bringt mich zurück zum Hauptmenü. +- In der Liste der neuen Geräte ist das gerade bearbeitete Gerät nicht mehr sichtbar. + +## Organisator: Neues Gerät - ablehnen + +Als Organisator habe ich eine eMail bekommen dass ein neues Gerät angemeldet wurde. Ich möchte dieses Gerät nun ansehen un die Eingangsüberprüfung durchführen. +- Ich öffne die RepApp im Browser +- Im Menü klicke ich auf Mitarbeiter, was mich zur Single Sign On Anmeldung bringt. +- Ich melde mich mit meinem Repair-Café Konto an und werde automatisch zur Hauptmenü für die Organisatoren weitergeleitet. +- Im Hauptmenü sehe ich das neue Gerät im Bereich Geräte. +- Ich klicke auf den Knopf "Details" für das neue Gerät, und mein Browser öffnet eine Seite in der ich die Details zu dem Gerät sehe. Auf der Seite sind Knöpfe: `Annehmen für gewähltes Repair-Café`, `Annehmen für anderes Repair-Café`, `Ablehnen` und `Rückfrage`. Alle notwendigen Informationen sind vorhanden, aber es gibt keinen geeigneten Reparateur im Repair-Café, und ich entscheide mich das Gerät abzulehnen. Der Klick auf `Ablehnen` bringt mich zu einer neuen Seite. +- Auf der neuen Seite sehe ich ein Formular mit einem Textbereich der die Überschrift "Antwort an den Gast" trägt. Im Formular ist bereits ein Standard-Text zur Ablehnung eines Geräts. Ich passe den Text an um dem Gast mitzuteilen dass wir leider keinen geeigneten Reparateur haben und klicke auf den Knopf `Absenden`. Der Klick bringt mich zurück zum Hauptmenü. +- In der Liste der neuen Geräte ist das gerade bearbeitete Gerät nicht mehr sichtbar. + +## Organisator: Neues Gerät - Rückfrage + +Als Organisator habe ich eine eMail bekommen dass ein neues Gerät angemeldet wurde. Ich möchte dieses Gerät nun ansehen un die Eingangsüberprüfung durchführen. +- Ich öffne die RepApp im Browser +- Im Menü klicke ich auf Mitarbeiter, was mich zur Single Sign On Anmeldung bringt. +- Ich melde mich mit meinem Repair-Café Konto an und werde automatisch zur Hauptmenü für die Organisatoren weitergeleitet. +- Im Hauptmenü sehe ich das neue Gerät im Bereich Geräte. +- Ich klicke auf den Knopf "Details" für das neue Gerät, und mein Browser öffnet eine Seite in der ich die Details zu dem Gerät sehe. Auf der Seite sind Knöpfe: `Annehmen für gewähltes Repair-Café`, `Annehmen für anderes Repair-Café`, `Ablehnen` und `Rückfrage`. Da notwendige Informationen fehlen entscheide ich mich eine Rückfrage an den Gast zu stellen, und drücke den Knopf `Rückfrage`. Der Klick bringt mich zu einer neuen Seite. +- Auf der neuen Seite sehe ich ein Formular mit einem Textbereich der die Überschrift "Rückfrage" trägt. Im Formular ist bereits ein Standard-Text für Rückfragen. Ich passe den Text an um die notwendigen Informationen anzufragen und klicke auf den Knopf `Absenden`. Der Klick bringt mich zurück zum Hauptmenü. +- In der Liste der neuen Geräte ist das gerade bearbeitete Gerät nicht mehr sichtbar. diff --git a/mkdocs.yml b/mkdocs.yml index 683e0f3..c24106f 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -1,6 +1,12 @@ site_name: RepApp - Makespace Repair-Café Hilpoltstein site_url: https://makes-hacks-hip.github.io/RepApp/ nav: + - RepApp: + - Beschreibung: 'index.md' + - Anforderungen: 'use_cases.md' + - Abläufe: 'workflows.md' + - Ansichten: 'views.md' + - Daten-Modell: 'models.md' - 'Repair-Café & Makespace': - Repair-Café: https://www.repaircafe-hilpoltstein.de - Makespace: https://makes-hacks-hip.de