RepApp/docs/index.md

Projekt RepApp

RepApp ist eine Web App um Reparaturen im Rahmen eines Repair-Cafés zu organisieren.

Benutzer

Gast

Ein Gast ist ein Gerätebesitzer der ein oder mehrere Geräte zur Reparatur anmelden möchte.

Reparateur

Ein Reparateur ist ein Mitglied des Repair-Cafés der die Gerätebesitzer bei der Reparatur ihrer Geräte unterstützt.

Organisator

Ein Organisator ist Mitglied des Repair-Cafés der die Termine mit den Gästen organisiert und die Reparateure zu den Geräten zuordnet.

Use-Cases

Gast

• Als Gast möchte ich einen Termin für eine Reparatur vereinbaren. Dafür Stelle ich Informationen zum Gerät und eine Fehlerbeschreibung zur Verfügung.
• Als Gast möchte ich eine Bestätigung für eine Reparaturanfrage bekommen.
• Als Gast möchte ich eine Terminbenachrichtigung oder eine Absage bekommen.
• Als Gast möchte ich mein angemeldetes Gerät und dessen Status einsehen können.
• Als Gast möchte ich Rückfragen zum Gerät empfangen und diese beantworten können.
• Als Gast möchte ich ein Gerät für eine Folgereparatur anmelden können

Reparateur

• Als Reparateur möchte ich die angemeldeten Geräte ansehen können.
• Als Reparateur möchte ich mir ein angemeldetes Gerät zuordnen können.
• Als Reparateur möchte ich ein angemeldetes Gerät ablehnen können.
• Als Reparateur möchte ich Rückfragen zum Gerät stellen können.
• Als Reparateur möchte ich eine Benachrichtigung bekommen wenn eine Rückfrage beantwortet wird.
• Als Reparateur möchte ich eine Benachrichtigung bekommen wenn mir ein Gerät zugeordnet wird.
• Als Reparateur möchte ich mich für ein Repair-Café anmelden können.
• Als Reparateur möchte ich mich für ein Repair-Café abmelden können.

Organisator

• Als Organisator möchte ich ein Café anmelden können.
• Als Organisator möchte ich die Terminanfragen einsehen können.
• Als Organisator möchte ich eine Rückfrage zu einer Terminanfrage stellen können.
• Als Organisator möchte ich eine Terminanfrage ablehnen können.
• Als Organisator möchte ich eine Terminanfrage zu einem Termin zuordnen können.
• Als Organisator möchte ich einen Terminanfrage zu einem Reparateur zuordnen können.

Daten

Cafe

Ein Cafe ist ein Repair-Café Termin.

Attribute:

• Datum: Datum der Veranstaltung
• Ort: Beschreibung wo das Repair-Café stattfindet

Annahmen:

• Ein Repair-Café beginnt um 13:00 Uhr.
• Ein Repair-Café hat drei aufeinanderfolgende Slots 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. jeder Reparateur wird zu einem neuen Repair-Café Termin automatisch hinzugefügt.
• Reparateure können alles reparieren. Geräte Kategorien, Skills, ... können später hinzugefügt werden.

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 Besitzers
• Telefon: Festnetz oder Mobilnummer des Besitzers
• Wohnort: Wohnort des Besitzers
• Mail: eMail-Adresse des Besitzers für Benachrichtigungen

Technische Attribute:

• Identifier: SHA256 Hash aus Name + Wohnort + Timestamp

Annahmen:

• Es gibt nur eine Geräteanmeldung pro Besitzer. Mehrere Geräte pro Besitzer kann später hinzugefügt werden.

Gerät

Ein Gerät ist ein defekter Gegenstand der im Rahmen eines Repair-Cafés repariert werden soll.

Attribute:

• Gerät: Bezeichnung des Geräts
• Fehler: Beschreibung des Defekts
• Folgetermin: Boolesches Flag das anzeigt ob es sich um einen Folgetermin handelt.

Technische Attribute:

• Identifier: SHA256 Hash aus Gerät + Besitzer + Timestamp
• GastId: Referenz zum Gast der das Gerät besitzt

Annahmen:

• Für einen Folgetermin werden alle Daten neu eingegeben. Eine Folgereparatur auf Basis der ersten Anmeldung kann später hinzugefügt werden.

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 eine Einladung gesendet und bestätigt wurde.

Technische Attribute:

• CafeId: Referenz zum Cafe
• ReparateurId: Referenz um Reparateur oder NULL
• GerätId: Referenz zum Gerät

Frage

Eine Frage ist eine Zuordnung von einem Gerät zu einem Organisator oder einem Reparateur.

Attribute:

• Frage: Frage zum Gerät oder Defekt
• Antwort: Antwort des Gastes
• Datum: Datum der Erstellung der Rückfrage

Technische Attribute:

• OrganisatorId: Referenz zum Organisator oder NULL
• ReparateurId: Referenz zum Reparateur oder NULL
• GerätId: Referenz zum Gerät

Warteliste

Die Warteliste enthält 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.

• Betätigt: Boolesches Flag. True wenn eine Einladung gesendet und bestätigt wurde.

Technische Attribute:

• CafeId: Referenz zum Cafe
• ReparateurId: Referenz um Reparateur oder NULL
• GerätId: Referenz zum Gerät

Ansichten

(1) Landing Page: Repair-Cafés

Liste der Repair-Café Termine

(2) Gerät anmelden

Das Formular zum anmelden der Geräte hat die Felder Name, eMail-Adresse, Gerätebezeichnung, Fehlerbeschreibung und einen Knopf Absenden zum senden des Formulars.

(3) Anmeldebestätigung

Die Anmeldebestätigung zeigt die Geräte Daten erneut an, zusammen mit der Information dass das Gerät angelegt wurde und einem Link zur Geräte Detailseite.

(4) Geräte Detailseite

Die Geräte Detailseite hat die Felder Name, eMail-Adresse, Gerätebezeichnung, Fehlerbeschreibung die mit den Angaben des Besitzers ausgefüllt sind. Weiter enthält die Seite einen Knopf Aktualisieren der das Formular absendet und die Daten aktualisiert.

Abläufe

Anmeldung eines defekten Gerätes

Als Besitzer eines defekten Gerätes,

• gehe ich auf die Seite der Repair-Café Termine (1)
• dort klicke ich auf Gerät anmelden bei dem richtigen Repair-Café Termin.
• Der Link bringt mich auf eine neue Seite mit einem Formular (2).
• Das Formular hat die Felder Name, eMail-Adresse, Gerätebezeichnung und Fehlerbeschreibung.
• Nachdem ich die Felder ausgefüllt habe klicke auf auf Absenden.
• Der Klick auf Absenden bringt mich zu einer neuen Seite, die bestätigt dass mein Gerät angemeldet wurde und einen Link zu einer Geräte Detailseite (4) hat.
• In meinem eMail Posteingang finde ich eine Bestätigung der Geräteanmeldung die ebenfalls den Link zur Geräte Detailseite hat.
• Der Klick auf den Link zur (4) Geräte Detailseite bringt mich zu einer Seite auf der ich meine Angaben sehe und aktualisieren kann.