Normale Benutzer

• Können Stempel von Agenten erhalten
• Können ihre Stempel bei Agenten verwenden
• Haben einen QR-Code zur Identifikation
• Können Statistiken einsehen

Agenten

• Können QR-Codes scannen
• Können Stempel vergeben und verwenden
• Haben ein erweiterbares Profil mit Logo
• Haben Zugang zu detaillierten Statistiken
• Können Ihre PayPal Adresse dem Benutzer anzeigen lassen

Registrierung

• E-Mail-basierte Registrierung mit Passwort
• E-Mail-Verifizierung mit Deep Link-Integration
• Rollenauswahl (Benutzer oder Agent)
• Automatische Profilerstellung in der Datenbank

Anmeldung

• Standard E-Mail/Passwort Login
• Automatische Session-Verwaltung
• Token-Refresh für längere Sessions

• E-Mail-Bestätigungs-Links öffnen automatisch die App
• URL-Schema: com.stefanbess.stampsnap.app://login-callback/
• Callback-Handling für nahtlose Benutzerführung

User Dashboard

• Stempel-Übersicht nach Agenten sortiert
• QR-Code-Anzeige für Agent-Interaktionen
• Aktivitätsverlauf mit Agent-Logos
• Statistiken-Zugang zu detaillierten Auswertungen
• Pull-to-Refresh für Live-Updates

Agent Dashboard

• Live-Statistiken (heute vergeben/verwendet)
• QR-Scanner-Zugang für Stempel-Transaktionen
• Benutzer-Übersicht mit Stempel-Counts
• Auto-Refresh alle 15 Sekunden
• Schnellaktionen für häufige Aufgaben

Scanner-Features

• Mobile Scanner Integration mit Overlay
• Automatische Code-Erkennung
• Flash/Taschenlampen-Steuerung
• Kamera-Wechsel (Front/Back)
• Duplicate-Prevention gegen Mehrfach-Scans

Stempel-Logik

• Intelligente Entscheidung:
  • Hat Benutzer Stempel → Verwende 1 Stempel
  • Hat keine Stempel → Zeige Vergabe-Dialog
• Atomic Operations zur Vermeidung von Race Conditions
• Verification System für Transaktions-Sicherheit

Race Condition Protection

• Multiple Protection Layers:
  • Operation tracking
  • Cooldown-Mechanismen
  • Database-level optimistic locking
  • Verification delays

Benutzer-Profile

• Name und E-Mail-Verwaltung
• Stempel-Übersicht
• Aktivitätsverlauf

Agent-Profile

• Logo-Upload und -Verwaltung
• Supabase Storage Integration
• Automatische Bildoptimierung
• Fallback-Anzeige bei fehlenden Logos

Weitere Features

• Beschreibung für Agent-Services
• PayPal-Integration für Zahlungen
• Profil-Validierung

Features

• PayPal-Adresse-Validierung (E-Mail oder paypal.me)
• Automatische URL-Generierung
• Multi-Strategy PayPal-Opening:
  • Externe App
  • System Browser
  • In-App Browser (Fallback)
• Copy-to-Clipboard Funktionalität
• PayPal-Dialoge mit mehreren Optionen

Anzeige

• PayPal-Indikatoren bei Agenten mit Zahlungsoption
• Optionale PayPal-Buttons in Agent-Details
• Integration in Agent-Profile

User-Statistiken

• Gesamt-Stempel-Übersicht
• Agent-Ranking nach Stempel-Anzahl
• Zeitbasierte Auswertungen (heute/Woche/Monat)
• Aktivitäts-Trends nach Agenten
• Interaktions-Geschichte

Agent-Statistiken

• Live-Dashboard mit Echtzeit-Updates
• Heute's Aktivitäten (vergeben/verwendet)
• Aktive Benutzer-Counts
• Stempel im Umlauf
• Wöchentliche Trends
• Top-Kunden-Übersicht

Real-time Updates

• Stream-basierte UI-Updates
• Automatische Refresh-Mechanismen
• Push-Notifications bei Stempel-Aktivitäten
• Optimistic UI-Updates

Offline-Handling

• Cached Data Display
• Retry-Mechanismen bei Netzwerkfehlern
• Graceful Error-Handling

Account-Einstellungen

• Profil-Bearbeitung
• Passwort-Änderung
• E-Mail-Verwaltung
• Datenschutz-Informationen

App-Einstellungen

• Theme-Verwaltung (iOS-Style)
• Notification-Präferenzen
• Hilfe & Support-Dialoge
• About-Informationen

Account-Löschung

• Komplette Daten-Entfernung
• Multi-Strategy Account Deletion:
  • Enhanced RPC mit Auth-Löschung
  • Fallback: Datenbank + Auth-Löschung
  • Auth-User-Markierung (wenn Löschung fehlschlägt)
• Detaillierte Lösch-Vorschau
• Agent-Stempel-Preservation (aktive Stempel bleiben bei anderen Benutzern)

Datenschutz

• Minimale Datenspeicherung
• Sichere Auth-Token-Verwaltung
• Verschlüsselte Datenübertragung
• GDPR-konforme Löschfunktionen

Security Features

• UUID-basierte Benutzer-IDs
• Supabase Row Level Security
• Protected API-Endpoints
• Input-Validierung

Design

• iOS-inspiriertes Design mit Material 3
• Konsistente Farbpalette
• Accessibility-Features
• Responsive Layout

Custom Widgets

• IOSCard: Container mit Schatten und Rundungen
• IOSButton: iOS-Style Buttons
• AgentLogoWidget: Logo-Anzeige mit Fallbacks
• AgentInfoTile: Komplette Agent-Informationen

Animations

• Smooth Page-Transitions
• Loading-Animations
• Success/Error-Feedback
• Pull-to-Refresh-Animationen

Performance-Features

• Stream-basierte Live-Updates
• Lazy Loading von Agent-Details
• Image Caching für Logos
• Database Query-Optimierung
• Memory-efficient State Management

Error Handling

• Comprehensive Error-Catching
• User-friendly Error-Messages
• Automatic Retry-Mechanisms
• Fallback-Strategien

Haupttabellen

• profiles: Benutzer-Basisdaten
• agent_stamps: Stempel-Zuordnungen zwischen Benutzern und Agenten
• stamp_transactions: Detaillierte Transaktionshistorie
• agent_profiles: Erweiterte Agent-Informationen (Logo, Beschreibung, PayPal)

Storage

• Supabase Storage: Agent-Logos und Dateien
• Automatic Cleanup: Verwaiste Dateien werden entfernt

iOS-Integration

• Deep Link-Handling
• Native Look-and-Feel
• Platform-specific Animations

Android-Integration

• Material Design-Kompatibilität
• Android Deep Links
• Platform-adaptive UI

Code-Architektur

• Provider Pattern für State Management
• Service-Layer für Business Logic
• Model-Layer für Datenstrukturen
• Widget-Abstraktion für Wiederverwendbarkeit

Testing & Quality

• Comprehensive Error-Logging
• Debug-Modi für Entwicklung
• Operation-Tracking für Debugging
• Performance-Monitoring