KaffeeBoys Anleitung

Kaffeemaschinen Management · kaffeboys.app

📱
App Installation
KaffeeBoys als App auf dem Handy installieren

iOS iPhone — Safari

⚠️ Nur Safari funktioniert für die iOS-Installation — nicht Chrome oder Firefox!

Safari öffnen und kaffeboys.app/mobil.html aufrufen

Unten auf das Teilen-Symbol tippen (Quadrat mit Pfeil nach oben ↑)

Nach unten scrollen → „Zum Home-Bildschirm" antippen

„Hinzufügen" bestätigen — die App erscheint auf dem Home-Bildschirm

App immer über das Home-Bildschirm-Icon öffnen (nicht über Safari)

Android Android — Chrome

Chrome öffnen und kaffeboys.app/mobil.html aufrufen

Oben rechts auf die drei Punkte ⋮ tippen

„App installieren" oder „Zum Startbildschirm hinzufügen" auswählen

Bestätigen — App erscheint auf dem Home-Bildschirm

🔔
Push-Benachrichtigungen
Automatische Meldungen bei wichtigen Ereignissen

Push aktivieren

App über das Home-Bildschirm-Icon öffnen

Menü (☰) antippen → Profil auswählen

Auf „🔔 Push aktivieren" tippen

Erlaubnis im Dialog erteilen — Status wechselt auf „✅ Push aktiv"

⚠️ Push funktioniert nur wenn die App über das Home-Bildschirm-Icon geöffnet wird — nicht direkt im Browser!

Wann kommt ein Push?

  • 🧹 Reinigung morgen — Vorwarnung um 08:00 Uhr
  • 🧹 Reinigung heute — Erinnerung um 08:00 Uhr (kritisch)
  • ⚠️ Bestand unter Minimum — sofort wenn eingetragen
  • 🚨 Kritischer Bestand — sofort, laute Vibration (Stummschaltung überschrieben)
  • 🚨 Neue Störung gemeldet — sofort an alle Admins
  • 🔧 Störung zugewiesen — sofort an den zugewiesenen Mitarbeiter
  • Störung behoben — sofort an alle Admins
📅
Kalender-Abo
Reinigungsplan im eigenen Kalender abonnieren
ℹ️ Der Reinigungsplan kann als Kalender-Abo abonniert werden — neue Einträge erscheinen automatisch in deinem Kalender.

iOS iPhone — Schnellweg

App öffnen → im Menü Kalender antippen

Unten auf „📅 Kalender abonnieren" tippen

iPhone fragt automatisch → „Abonnieren" bestätigen

Fertig! Der Kalender erscheint in der Kalender-App als „☕ Reinigungsplan"

iOS iPhone — Manuell

Einstellungen öffnen → KalenderAccounts

„Account hinzufügen"„Andere"

„Kalenderabo hinzufügen" antippen

Diese URL eingeben und auf „Weiter" tippen:

https://kaffeboys.app/api/kalender.php?a=ical&token=2d0590804f90ba17826b11fd

„Sichern" tippen — fertig!

Android Google Calendar

Am Computer calendar.google.com öffnen

Links bei „Andere Kalender" auf + klicken

„Per URL" auswählen

URL einfügen und „Kalender hinzufügen" klicken:

https://kaffeboys.app/api/kalender.php?a=ical&token=2d0590804f90ba17826b11fd
⚠️ Google Calendar aktualisiert abonnierte Kalender nur alle 12–24 Stunden. Neue Einträge erscheinen also nicht sofort — das ist eine Einschränkung von Google.
📦
Bestand verwalten
Artikel, Korrekturen und Auffüllungen

Aktionen im Überblick

SchaltflächeFunktionWer
📝 KorrigierenSetzt den Bestand auf einen neuen Wert (z.B. nach Inventur)Alle
📦 AuffüllungVerbrauch aus dem Lager erfassen → Bestand sinktAlle
✨ VollreinigungReinigung protokollieren, optional mit VerbrauchAlle
+ ArtikelNeuen Artikel anlegenAdmin
⚙️ BearbeitenArtikel umbenennen, Einheit/Min/Max ändernAdmin
🗑 LöschenArtikel deaktivierenAdmin

Automatische Sammelbestellung

Fällt ein Artikel unter das eingestellte Minimum, wird er automatisch zur Sammelbestellung hinzugefügt.

Bestand fällt unter Minimum → Artikel landet in der Sammelbestellung

Admin prüft und ergänzt die Sammelbestellung bei Bedarf

Admin tippt „📧 Bestätigen & Mail senden"

Mail mit Bestellliste + CoffeeFair-Link geht raus

🚨
Störungen melden
QR-Code auf der Kaffeemaschine scannen

Störung melden — für alle

✅ Kein Login erforderlich — einfach QR-Code scannen!

QR-Code auf der Kaffeemaschine scannen

Namen eingeben

Störung beschreiben — möglichst genau

Priorität wählen: Normal / Hoch / 🔴 Kritisch

Auf „Störung melden" tippen — Admins werden sofort benachrichtigt

QR-Code drucken

Im Browser kaffeboys.app/qr_print.html öffnen

Auf „🖨️ Drucken / Speichern" klicken

Als PDF speichern oder direkt drucken und auf die Kaffeemaschine kleben

👥
Benutzerverwaltung
Benutzer anlegen und Rechte vergeben

Benutzer anlegen

Menü → Verwaltung„+ Neu"

Name, Benutzername und temporären PIN (min. 4 Ziffern) eingeben

Module auswählen welche der Benutzer sehen darf

Benutzer erhält beim ersten Login die Aufforderung einen eigenen PIN zu vergeben

Module & Berechtigungen

ModulWas kann der Benutzer?
📦 BestandArtikel einsehen, Bestand korrigieren, Auffüllungen erfassen
🛒 BestellungenSammelbestellung einsehen und Artikel hinzufügen
📅 KalenderReinigungsplan einsehen, eigene Einträge als erledigt markieren
🧹 ReinigungVollreinigung und Auffüllungen protokollieren
⚙️ VerwaltungBenutzer verwalten, Einstellungen ändern (nur Admins)
Häufige Fragen
Probleme und Lösungen
Push-Benachrichtigungen kommen nicht an
Sicherstellen dass die App über das Home-Bildschirm-Icon geöffnet wird — nicht im Browser. Im Profil Push deaktivieren und neu aktivieren. Bei iPhone: in den Einstellungen → Mitteilungen prüfen ob KaffeeBoys erlaubt ist.
Kalender aktualisiert sich nicht
iPhone: Einstellungen → Kalender → Konten → abonnierter Kalender → „Account" → Abrufhäufigkeit auf „Jede Stunde" stellen.

Android/Google Calendar: Bis zu 24h Verzögerung ist normal und kann leider nicht umgangen werden — das ist eine Einschränkung von Google.
Login funktioniert nicht
Der PIN muss aus mindestens 4 Ziffern bestehen. Bei vergessenem PIN: Admin kann in der Verwaltung einen neuen temporären PIN setzen — der Benutzer muss dann beim nächsten Login einen neuen PIN vergeben.
Artikel wird nicht gespeichert / 500 Fehler
Alle Pflichtfelder (Name, Kategorie, Einheit, Min, Max) müssen ausgefüllt sein. Bitte den Admin kontaktieren wenn der Fehler weiterhin auftritt.
Störungsmeldung funktioniert nicht
Die Störungsmeldung benötigt keinen Login. Einfach kaffeboys.app/stoerung.html direkt im Browser aufrufen oder den QR-Code auf der Maschine scannen.
Wie setze ich den PIN zurück?
Als Admin: Verwaltung → Benutzer → beim entsprechenden Benutzer auf das Deaktivieren/Aktivieren-Symbol tippen → neuen Benutzer anlegen ist nicht nötig, der Admin kann direkt in der Verwaltung Module anpassen. Für PIN-Reset: Benutzer löschen und neu anlegen mit neuem PIN.