Features

Kaufen

Bild: Die Nutzerkarte und alle verfügbaren Gegenstände

• Aktivierte Nutzer können beliebig freigeschaltene Gegenstände kaufen.
• Es können bis zu 10 Gegenstände des selben Typs in einer Transaktion gekauft werden.
• Der Kiosk kann im Namen von anderen Nutzern, solange die Nutzer den Kiosk aktiviert haben, Käufe tätigen.
• Jeder Kauf ist mit einem Eintrag in der Kaufhistorie und damit auch Transaktionshistorie verknüpft

Kiosk

Bild: Nutzerauswahl und Nutzersuchleiste

• Kiosk-Geräte laufen unter einem Kiosk-Nutzer.
• Diese Geräte können im angemeldeten Zustand einen Nutzer auswählen und für diesen Gegenstände kaufen.
• Deaktivierte und Versteckte Nutzer werden nicht angezeigt.
• Eine Nutzerauswahl leitet direkt zum Kaufmenü für diesen Nutzer weiter.
• Wenn eine Wartung des Geräts durchgeführt werden muss, kann der Nutzer unter drücken der F8-Taste abgemeldet werden.

Theme

• Durch klicken auf das Bier-Icon kann das Theme rotiert werden.
• Aktuell gibt es 2 Themes:
  • Lila
  • Blau (Fachschafts blau)
• IN ARBEIT - An bestimmten Tagen im Jahr werden einzelne Themes ohne Deaktivierungsmöglichkeit angewendet:
  • Pi Day (04. März)
  • Mario Day (10. März)
  • Star Wars (04. Mai)

Kaufhistorie

Bild: Name, Gesamtbetrag, Anzahl der gekauften Gegenstände, Gegenstand Anzeigename (bei fehlendem Gegenstand wird ID verwendet), Zeitstempel.

• Bei jedem Kauf wird ein Eintrag erstellt.
• Einträge können nicht gelöscht werden!
• Bei Preisänderungen oder Löschung von Nutzer/Gegenstand bleibt der ursprüngliche Preis in älteren Einträgen erhalten (siehe Bild).

Transaktionshistorie

Bild: Zeitstempel, Transaktionsart, authentifizierter Nutzer, Empfänger, Betrag (+ vorheriger Kontostand bei Änderung)

• Jeder Kauf von Gegenständen, Einzahlungen & Änderungen ist mit einem Eintrag verbunden.
• Einträge können nicht gelöscht werden!
• Jede Transaktion ist eine dieser Transaktionarten:
  • BUY: Wenn für den Empfänger ein Gegenstand gekauft wird.
  • DEPOSIT: Wenn der Empfänger Guthaben eingezahlt bekommt.
  • CHANGE: Wenn Ein Administrator das Guthaben des Empfängers ändert. Vorheriger Kontostand wird angezeigt (siehe Bild).
• Der authentifizierte Nutzer (Nutzer-ID in Klammern) entspricht dem angemeldeten Nutzer, unter dem die Transaktion getätigt wurde.

Rechnungen

Bild: Sichtbarkeit der Rechnung, Informationselement, Nutzername, Gegenstandsanzahl, Gesamtschulden, Zeitstempel

Bei klicken auf das Informationsicon werden folgende Details zur Rechnung angezeigt:

Bild: Nutzername & ID, Einzelne Gegenstände (Name, Anzahl, Kaufpreis, Gesamtpreis), Rechnungszeitraum, Kontostand zum Zeitpunkt der Rechnung

• Der Rechnungszeitraum erstreckt sich vom Zeitpunkt der letzten Rechnung bis zum Zeitpunkt der neuen Rechnung.
• Sollte sich der Preis eines Gegenstandes über den Zeitraum ändern, wird dies in der Rechnung als ein neuer Eintrag unter gleichem Gegenstandsnamen angezeigt (siehe Bild).
• Es wird der Kontostand zum Zeitpunkt der Abrechnung angezeigt (Kann sich über andere Transaktionstypen zusätzlich geändert haben => Siehe Transaktionshistorie).
• Sobald eine Rechnung per Mail ("Brief" statt "Auge"-Icon bei Sichtbarkeit) verschickt wurde kann sie nicht mehr gelöscht werden.

Nutzerkarte

Bild: Nutzername, diverse Statistik-Emojis, aktuelles Level, level-Fortschrittsanzeige, Letzte 3 Käufe, Kontostand

• Die Statistik-Emojis zeigen die Achievements und Ranglistenplatzierungen des Nutzers (Ohne Statistiksystem => 💙🦆💙).
• Es werden die bis zu 3 letzten Käufe des Nutzers angezeigt
• Der Gesamtkontostand entspricht bei Beträgen <0 den Schulden beziehungsweise bei >0 dem Guthaben bei der Kaffekasse.

Level

Das Levelsystem (Zahl "9" und Fortschrittleiste) ist eine direkte Abbildung der Gesamtausgaben des jeweiligen Nutzers.

• Ein Level entsprich 5€ an Ausgaben.
• Jeder Nutzer beginnt bei Level 1 (0€ Ausgaben -> Level 1)

Statistiken

Bild: Systemweite Statistiken. Die 10 letzten Käufe, Gesamtguthaben, Rangliste, etc.

• Für die Statistiken werden die Historie und Nutzerprofile ausgewertet.
• Versteckte Nutzer fließen Anonym in die Metriken ein.
• Statistiken/Metriken können nach Komplett, die letzten 7 Tage oder 30 Tage angezeigt werden.
• Weitere Statistik-Seiten sind Nutzer und Gegenstände.

Administration

• Die maximale Präzision für alle Geldbeträge liegt bei 2 Nachkommastellen (Centbeträge).
• Die meisten Eingabefelder werden grün bei korrekten und rot bei inkorrekten Eingaben.

Rechnungen

Bild: Nutzersuchleiste, Mailfilter, Auswahlboxen, Löschelement, Sendeelement, Erstellelement

• Die Suchleiste benötigt eine exakte Eingabe der gesuchten NutzerID.
• Der Mailfilter hat 3 Positionen (Neutral, Gesendet, Nicht gesendet), zwischen denen durch klicken rotiert werden kann.
• Rechnungs-Leisten können als orange markiert werden, wenn die Rechnung keine neuen Gegenstände zum abrechnen enthält.
• Die erste Auswahlbox wählt alle sichtbaren Elemente aus, alle können zusätzlich einzeln aus/entwählt werden.
• Ausgewählte Elemente können mit dem Löschelement gelöscht und mit dem Sendelement per Mail verschickt werden.
  • Beim Löschen von Rechnungen, die neue unversendete Rechnungen desselben Nutzers zur verfügung haben, werden die Gegenstände zu der neueren Rechnung hinzugefügt.
  • Wenn das Versenden einer Mail fehlschlägt, wird diese trotzdem als öffentlich (oranges "Auge"-Icon) markiert und für den Nutzer sichtbar gemacht.
• Nach klicken auf das Erstellelement öffnet sich ein Dialog:

Bild: Auswahlboxen, Namen, Kontostand

• Es können nur Rechnungen von Aktivierten Nutzern ausgewählt werden.
  • Deaktivierte Nutzer werden durch ein Schloss angezeigt (siehe Bild).
• Auch hier können alle möglichen Nutzer gleichzeitig ausgewählt werden.

Nutzer

Bild: Nutzersuchleiste, Erstellelement, Bearbeitungsmoduselement, Nutzeradminkarte

• Die Suchleiste nimmt jede Art von Informationen entgegen.
• Die Nutzeradminkarte zeigt an:
  • Namen
  • Aktivierungsstatus (Kreuz/Häkchen)
  • Level
  • Kontostand
  • Konto-Einzahl-Feld + Knopf
• Das Einzahl feld nimmt nur positive Werte über 0 bis 50€ entgegen.
• Beim klicken auf den Knopf des Bearbeitungsmodus werden alle Nutzeradminkarten durch [Nutzerbearbeitungskarten](Nutzer Bearbeiten)

Nutzer Bearbeiten

Bild: Nutzer-ID, Aktivierungstoggle, Löschknopf, Bearbeitungsfelder (Level, Namen, Mail-Adresse, Kontostand

• Die Nutzer-ID kann nicht geändert werden!
• Aktivierungstoggle hat auswikungen auf diverse funktionen:
  • Möglichkeit Gegenstände zu kaufen.
  • Ausstellen von Rechnungen
  • Anzeige in diversen Nutzer-Übersichten
• Das Löschen von Nutzern ist nicht umkehrbar, jedoch können neue Nutzer mit derselben ID erstellt werden.
• Bearbeitungsfelder:
  • Level, benötigen direkte Eingabe des Gesamtausgabebetrags
  • Name
  • Email-Adresse
  • Kontostand (Änderungen tauchen in der Transaktionshistorie auf)
  • Kiosk (Kann mit Kiosk einkaufen oder nicht)
  • Versteckt (Sind Profil und statistiken öffentlich einsehbar)

Beim klicken auf den Erstellknopf erscheint ein Dialog für neue Nutzer

Nutzer erstellen

Bild: Nutzer-ID, Name, Mail, Gesamtausgabe

• Die Nutzer-ID muss folgenden Regeln entsprechen (kann danach nicht geändert werden)
  • bei Integration mit LDAP mit dem Nutzernamen des gewünschten LDAP-Nutzers übereinstimmen!
  • Maximal 30 Zeichen haben!
  • Nur Kleinbuchstaben und Zahlen enthalten!
• Andere Zeichen werden bei Eingabe der ID ignoriert.
• Alle Textfelder (auch Name & Email) dürfen nicht länger als 30 Zeichen sein.
• Das Eingabefeld für die Gesamtausgabe kann zur Migration von alten Nutzern in das neue System verwendet werden.
  • Die Gesamtausgabe wird im Hintergrund für das Level-System verwendet
  • Wird bei Freilassen automatisch auf 0 gesetzt.
  • Nur positive Beträge möglich.

Gegenstände

Bild: Gegenstand-Suchleiste, Erstellelement, Gegenstand-Admin-Karte

• Bei der Gegenstands-Admin-Karte kann, ähnlich zur Bearbeitungs-Anzeige der Nutzer, auch hier:
  • Gegenstände Aktiviert/Deaktiviert werden
  • Gegenstände Gelöscht werden
  • Name geändert werden
  • Die Kategorien geändert werden
  • Die Preise geändert werden
  • Das Anzeigebild des Gegenstands geändert werden
• Durch klicken auf das Anzeigebild kann ein .png,.jpg/.jpegoder.gif ausgewählt werden.

Gegenstände erstellen

Bild: Gegenstand-ID, Kategorie, Anzeigename, Preis

• Wie auch schon für Nutzer gelten hier dieselben Regeln für IDs & Text-Felder
• Der Preis kann beliebig zwischen 0 und 100€ festgelegt werden.