ÜBERSICHT

StampSnap ist eine digitale Stempelkarten-App, die es Agenten ermöglicht, Stempel an Benutzer zu vergeben und zu verwalten. Die App basiert auf QR-Code-Technologie und bietet separate Dashboards für Benutzer und Agenten.

BENUTZER-FUNKTIONEN

Authentifizierung

- Registrierung mit E-Mail und Passwort

- Anmeldung mit bestehendem Konto

- E-Mail-Bestätigung über Deep Links

- Automatische Profilerstellung bei Registrierung

Dashboard

- Übersicht über alle gesammelten Stempel

- Anzeige der Gesamtanzahl aller Stempel

- Aufschlüsselung der Stempel nach Agenten

- Liste aller Agenten mit Stempelanzahl

- Letzte Aktivitäten und Transaktionen

- Pull-to-Refresh Funktionalität

- Automatische Aktualisierung beim App-Wechsel

QR-Code

- Persönlicher QR-Code zur Anzeige

- QR-Code enthält Benutzer-ID

- Anzeige für Agenten zum Scannen

- Verwendung zum Erhalten oder Verwenden von Stempeln

Stempel-Verwaltung

- Übersicht aller Stempel nach Agenten gruppiert

- Anzeige der Stempelanzahl pro Agent

- Zugriff auf Agent-Details

- Kontaktinformationen der Agenten einsehen

Statistiken

- Detaillierte Stempel-Statistiken

- Gesamtanzahl aller Stempel

- Anzahl der verschiedenen Agenten

- Durchschnittliche Stempel pro Agent

- Maximum von einem einzelnen Agenten

- Agent-Ranking nach Stempelanzahl

- Zeitbasierte Statistiken (Heute, Diese Woche, Dieser Monat)

- Aktivitäts-Trends nach Agenten

- Transaktionshistorie mit Zeitstempel

Profil-Verwaltung

- Profil bearbeiten

- Name ändern

- Profilbild hochladen

- Profilbild anzeigen

Einstellungen

- Konto-Informationen anzeigen

- Profil-Einstellungen verwalten

- Datenschutz-Informationen

- Hilfe und Support

- App-Version anzeigen

- Abmelden

- Konto vollständig löschen

AGENT-FUNKTIONEN

Authentifizierung

- Registrierung als Agent

- Anmeldung mit Agent-Konto

- Automatische Agent-Berechtigung

- E-Mail-Bestätigung

Dashboard

- Agent-Dashboard mit Übersicht

- Live-Updates alle 15 Sekunden

- Manuelle Aktualisierung per Pull-to-Refresh

- Heutige Statistiken

- Anzahl vergebener Stempel heute

- Anzahl verwendeter Stempel heute

- Aktive Kunden mit Stempeln

- Gesamt aktive Stempel im Umlauf

- Übersicht über Benutzer mit Stempeln

- Top-Benutzer nach Stempelanzahl

- Ranking-System für Kunden

QR-Code-Scanner

- QR-Code-Scanner für Benutzer-Codes

- Kamera-Integration

- Flash-Funktion

- Kamera-Wechsel (Vorder-/Rückseite)

- Automatische Erkennung von QR-Codes

- Schutz vor mehrfacher Verarbeitung

- Dialog zur Stempel-Vergabe

- Stempel vergeben oder verwenden

- Bestätigungsmeldungen

- Scan-Zähler

Stempel-Verwaltung

- Stempel an Benutzer vergeben

- Stempel von Benutzer verwenden

- Atomare Transaktionen

- Schutz vor Race Conditions

- Retry-Mechanismus bei Fehlern

- Transaktions-Logging

- Verlauf aller Transaktionen

Profil-Verwaltung

- Agent-Profil bearbeiten

- Name ändern

- Logo hochladen und verwalten

- Beschreibung hinzufügen

- Kontaktinformationen verwalten

- Website angeben

- Adresse hinterlegen

- Kontakt-E-Mail angeben

- Telefonnummer angeben

- PayPal-Adresse hinterlegen

- Logo entfernen oder ändern

Statistiken

- Detaillierte Agent-Statistiken

- Heute vergebene Stempel

- Heute verwendete Stempel

- Diese Woche vergebene Stempel

- Diese Woche verwendete Stempel

- Aktive Kunden

- Durchschnitt Stempel pro Kunde

- Gesamt im Umlauf befindliche Stempel

- Aktivitäts-Indikator

Einstellungen

- Agent-Profil verwalten

- Logo-Status anzeigen

- Profil-Einstellungen

- Hilfe und Support für Agenten

- Abmelden

- Konto löschen

TECHNISCHE FEATURES

Backend

- Supabase als Backend-Service

- Echtzeit-Updates über Streams

- Datenbank-Synchronisation

- Authentifizierung über Supabase Auth

- PKCE Auth Flow

- Automatische Token-Aktualisierung

Datenverwaltung

- Profil-Verwaltung

- Agent-Profile mit erweiterten Informationen

- Benutzer-Profile

- Stempel-Transaktionen

- Transaktionshistorie

- Atomare Datenbank-Operationen

- Optimistische Updates

Medien

- Profilbild-Upload für Benutzer

- Logo-Upload für Agenten

- Bildoptimierung

- Supabase Storage Integration

- Bild-Vorschau

PayPal-Integration

- PayPal-Adresse hinterlegen

- PayPal-Links für Zahlungen

- Anzeige von PayPal-Informationen

Sicherheit

- UUID-Validierung

- E-Mail-Validierung

- Passwort-Validierung

- Operation-Tracking

- Cooldown-Mechanismen

- Schutz vor Duplikaten

- Sichere Authentifizierung

Benutzeroberfläche

- Modernes iOS-Design

- Responsive Layout

- Pull-to-Refresh

- Loading-States

- Error-Handling

- Success-Meldungen

- Empty-States

- Card-basiertes Design

- Gradient-Effekte

- Animations

ALLGEMEINE FUNKTIONEN

Navigation

- Automatische Navigation basierend auf Benutzerrolle

- Deep Link-Unterstützung

- Auth-Callback-Handling

- Route-Management

Offline-Funktionalität

- Lokale Daten-Caching

- Optimistische UI-Updates

- Automatische Synchronisation

Datenaktualisierung

- Echtzeit-Updates über Streams

- Periodische Aktualisierungen

- Manuelle Refresh-Funktion

- Automatische Updates beim App-Wechsel

Fehlerbehandlung

- Umfassendes Error-Handling

- Retry-Mechanismen

- Benutzerfreundliche Fehlermeldungen

- Logging für Debugging

Datenschutz

- Konto-Löschung

- Daten-Export-Möglichkeiten

- Transparente Datenschutz-Informationen

- Sichere Datenübertragung