11 App Nutzen
SurfaceScratcher edited this page 2026-05-19 23:41:58 +02:00
This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

App nutzen

Erste Schritte

Anmelden

  1. App öffnen
  2. Auf "Anmelden" tippen
  3. Der System-Browser öffnet sich mit der Keycloak-Login-Seite
  4. Mit deinen Zugangsdaten anmelden
  5. Du wirst automatisch zur App weitergeleitet

Falls du noch kein Konto hast: Kontaktiere den Administrator.

Abmelden

  • Über das Menü (oben links) → "Abmelden"
  • Alle lokalen Daten werden gelöscht

Einkaufslisten

Liste erstellen

  1. Auf "+" tippen
  2. Namen eingeben (z.B. "Wocheneinkauf")
  3. Optional: Geschäft auswählen
  4. Optional: Datum im Format YYYY-MM-DD eintragen (z.B. für „Grillabend 12.05.")
  5. "Erstellen" tippen

Listen-Reihenfolge ändern

In der Listenübersicht (Bereiche „Listen", „Einkaufen", „Todo") hat jede Zeile rechts zwei kleine Pfeil-Buttons:

  • verschiebt die Liste um eine Position nach oben
  • entsprechend nach unten

Die Reihenfolge ist global gespeichert und bleibt nach Reload / Neu-Login erhalten. Neu erstellte Listen landen automatisch am Ende.

Das geplante Datum wird in der Listenübersicht als 📅 … neben dem Geschäftsnamen angezeigt und lässt sich später im Detail-Screen über „Ändern" / „Datum setzen" anpassen oder löschen (leeres Feld + ✓).

Items hinzufügen

  1. Liste öffnen
  2. Auf "+" tippen
  3. Produkt eingeben
  4. Mit "Hinzufügen" bestätigen

Einkaufsliste scannen

Statt manuell einzutippen:

  1. Auf das Kamera-Symbol tippen
  2. Handgeschriebene Einkaufsliste fotografieren
  3. App erkennt die Produkte automatisch (OCR)
  4. Erkannte Items prüfen und übernehmen

Items abhaken

  • Item antippen → wird als "erledigt" markiert
  • Erledigte Items erscheinen durchgestrichen

Fehlende Artikel markieren

Wenn ein Artikel im Geschäft nicht verfügbar war:

  1. Beim Artikel auf das ⚠-Symbol tippen → wird als "fehlend" markiert
  2. Fehlende Artikel werden orange hervorgehoben
  3. Nochmal antippen entfernt die Markierung

Fehlende Artikel in andere Liste übernehmen

Sobald mindestens ein Artikel als fehlend markiert ist, erscheint oberhalb der Items ein Hinweis (z.B. "⚠ 3 fehlend") mit dem Button "Fehlende übernehmen":

  1. Auf "Fehlende übernehmen" tippen
  2. Entweder eine bestehende Liste auswählen oder einen neuen Listennamen eingeben und "+ Neu" drücken
  3. Die fehlenden Artikel werden in das Ziel kopiert (im Ziel ohne ✓ und ohne ⚠), in der Ursprungsliste bleiben sie unverändert

Geschäfte

Häufig besuchte Geschäfte lassen sich speichern und einer Einkaufsliste zuordnen.

  1. Menü → "Geschäfte"
  2. Auf "+" → Name eingeben
  3. Bei einer Liste: Geschäft auswählen

Paket-Tracking

Siehe Paket-Tracking für die technische Übersicht. Aus Sicht der App:

Mail-Konto verbinden

  1. Menü → „Mail"„+ Konto"
  2. IMAP-Daten eingeben (Host, Port, TLS, Username, App-Passwort)
  3. „Verbindung testen" → bei Erfolg speichern
  4. Auto-Scan ist standardmäßig aktiv

Auto-Scan pro Konto ausschalten

  • Konto öffnen → Schalter „Tracking-Scan" deaktivieren
  • Das Konto wird ab sofort ignoriert; bereits angelegte Sendungen bleiben erhalten

Paket manuell anlegen

  1. Menü → „Pakete"„+ Paket"
  2. Tracking-Nummer eingeben (Pflicht)
  3. Optional: Carrier (DHL, UPS, …) und freie Notiz
  4. „Anlegen" → die Sendung erscheint sofort in der Liste

Status verfolgen

  • Die App fragt regelmäßig im Hintergrund den Lieferstatus ab.
  • Bei relevanten Ereignissen (z.B. „abholbereit", „beim Nachbarn") wird automatisch ein Todo in der Liste „Pakete" erzeugt.
  • Diese Liste findet sich im Menü unter „Todo" (eigener Bereich für Listen vom Typ Todo).
  • In der Paket-Detail-Ansicht zeigt der Verlauf alle vom Provider gemeldeten Events chronologisch absteigend (neuestes oben).

Einkaufen-Bereich

Der Menüpunkt „Einkaufen" zeigt ausschließlich Listen vom Typ Shopping.

  • Neue Listen, die hier angelegt werden, sind automatisch vom Typ Shopping (keine Typ-Auswahl mehr nötig).
  • Bei der Anlage lässt sich direkt ein Geschäft zuordnen.
  • Alle Listen quer über alle Typen bleiben unter „Listen" sichtbar.

Einkaufen-Modus

Sobald eine Einkaufsliste mindestens einen Artikel hat, erscheint oben der Button 🛒 Einkaufen-Modus". Dieser Modus ist für den eigentlichen Einkauf im Laden gedacht:

  • Vollbild-Ansicht ohne Edit- oder Hinzufügen-UI nur die Artikel.
  • Große Tap-Flächen: einmal auf eine Zeile tippen reicht zum Abhaken.
  • Erledigte Artikel werden ausgegraut, durchgestrichen und nach unten sortiert (zuletzt abgehakte zuerst).
  • Fehlende Artikel (⚠) bleiben innerhalb der noch nicht erledigten oben.
  • „Beenden" oben rechts kehrt zur normalen Listenansicht zurück.

Todo-Bereich

Der Menüpunkt „Todo" zeigt ausschließlich Listen vom Typ Todo (analog zum „Einkaufen"-Bereich für Einkaufslisten).

  • Neue Listen, die hier angelegt werden, sind automatisch vom Typ Todo (keine Typ-Auswahl mehr nötig).
  • Die automatisch generierte Liste „Pakete" (aus dem Paket-Tracking) ist hier auffindbar.
  • Alle Listen quer über alle Typen bleiben unter „Listen" sichtbar.

Einstellungen

Erreichbar über das Profil-Menü (Initialen-Kreis oben rechts) → „Einstellungen".

Die Einstellungen sind in Bereiche unterteilt — auf dem Web in einer linken Sub-Sidebar (auf schmalen Viewports als horizontale Liste oben), auf dem Mobile als Stack mit Liste:

  • Mailkonten — verbundene Mail-Konten verwalten (hinzufügen, entfernen, Tracking-Scan an/aus) und Mail-Lernspeicher pflegen
  • Mail-Tags — Tags umbenennen, zusammenführen, löschen
  • Geschäfte — Geschäfte für Einkaufslisten verwalten
  • OCR-Training — Fortschritt der gesammelten OCR-Trainingsdaten (Sessions, korrigierte Zeilen, Korrekturquote, letzte Session) inkl. Fortschrittsbalken in Richtung eines Fine-Tuning-Richtwerts

Auf schmalen Web-Viewports erreichst du die Bereichs-Navigation („Einkaufen", „Mail", „Archiv" …) jetzt über das -Icon links oben im Header — sie öffnet sich als Drawer-Sheet von unten.


Datenschutz

  • Alle Daten werden auf dem eigenen Server (api.mrrm.de) gespeichert
  • Keine Weitergabe an Dritte
  • Login über Keycloak (selbst gehostet auf auth.mrrm.de)
  • Passwörter werden niemals im Klartext gespeichert