Kostenlose Entsperrungen (Stufenvorteil)

Kostenlose Entsperrungen sind ein Treuestufen-Vorteil, der die Entsperrgebühr für eine bestimmte Anzahl von Fahrten pro Monat erlässt. Kunden höherer Stufen erhalten mehr kostenlose Entsperrungen, was einen überzeugenden Grund schafft, mit Ihrer Flotte engagiert zu bleiben.

Überblick

Jede Treuestufe kann eine konfigurierbare Anzahl kostenloser Entsperrungen pro Monat beinhalten. Wenn Kunden eine Fahrt starten, überprüft das System automatisch ihre Stufenvorteile und wendet eine kostenlose Entsperrung an, falls verfügbar, wodurch ihnen die Entsperrgebühr erspart wird.

Hauptfunktionen

• Pro-Stufen-Konfiguration - Unterschiedliche Mengen für jede Treuestufe festlegen
• Monatlicher Reset - Zähler wird zu Beginn jedes Monats zurückgesetzt
• Automatische Anwendung - Keine Aktion vom Kunden erforderlich
• Echtzeit-Verfolgung - Kunden sehen verbleibende kostenlose Entsperrungen in der App
• Fahrten-Verfolgung - Jede Fahrt vermerkt, ob eine kostenlose Entsperrung verwendet wurde

So funktioniert es

Kunde tippt auf "Entsperren"
         ↓
System prüft Treuestufe
         ↓
Kostenlose Entsperrungen verfügbar?
    ├── Ja → Entsperrgebühr überspringen
    │         Nutzungszähler erhöhen
    │         Fahrt als "kostenlose Entsperrung genutzt" markieren
    │         Kunde sieht "$0 Entsperrgebühr"
    └── Nein → Entsperrgebühr normal berechnen
             Kunde zahlt vom Wallet

Kostenlose Entsperrungen konfigurieren

Stufen einrichten

Beispiel-Stufenstruktur

Monatlicher Reset

Die Zählung der kostenlosen Entsperrungen wird automatisch zu Beginn jedes Kalendermonats zurückgesetzt.

Reset-Logik

Neuer Monat beginnt (z.B. 1. Februar)
         ↓
Kunde startet erste Fahrt des Monats
         ↓
System prüft: Ist Reset-Datum vor diesem Monat?
    ├── Ja → Zähler auf 0 zurücksetzen
    │         Reset-Datum auf 1. Feb. setzen
    └── Nein → Bestehenden Zähler verwenden

Wichtige Hinweise

• Reset erfolgt bei der ersten Fahrt des neuen Monats, nicht um Mitternacht
• Ungenutzte kostenlose Entsperrungen werden NICHT übertragen
• Kunden werden in der App über ihr neues monatliches Kontingent informiert

Kundenerfahrung

Vor Fahrtbeginn

Kunden sehen ihren Treuestatus:

• Aktueller Stufenname und Abzeichen
• In diesem Monat genutzte kostenlose Entsperrungen
• Verbleibende kostenlose Entsperrungen

Während der Entsperrung

Wenn eine kostenlose Entsperrung verfügbar ist:

1. Kunde tippt auf "Entsperren" am Fahrzeug
2. System wendet kostenlose Entsperrung automatisch an
3. Toast-Nachricht: "Kostenlose Entsperrung angewendet! X verbleibend diesen Monat"
4. Entsperrgebühr wird als $0 auf der Quittung angezeigt

Im Treuebereich

Die mobile App zeigt:

• free_unlocks_used - In diesem Monat genutzte Anzahl
• free_unlocks_remaining - Verbleibende Anzahl
• Visueller Fortschrittsbalken zur Nutzung

Stufen-Konfigurationsfelder

loyalty_tiers Tabelle

customer_loyalty Tabelle

Implementierungsdetails

Kostenlose Entsperrung prüfen und anwenden

Wenn eine Fahrt startet, macht das System:

1. Stufeninformationen abrufen - Aktuelle Stufe und Vorteile des Kunden abrufen
2. Verbleibende berechnen - freeUnlocksRemaining = tier.free_unlocks_per_month - free_unlocks_used_this_month
3. Verfügbarkeit prüfen - Wenn freeUnlocksRemaining > 0
4. Vorteil anwenden - Zähler erhöhen, Entsperrgebühr überspringen
5. Bei Fahrt vermerken - used_free_unlock = true setzen

// Vereinfachte Logik aus dem Entsperr-Flow
if (tierInfo.freeUnlocksRemaining > 0) {
  const freeUnlockUsed = await applyFreeUnlock(admin, customer.id)

  if (freeUnlockUsed) {
    // Entsperrgebühr-Berechnung überspringen
    // Fahrt-Datensatz aktualisieren
    await admin.from('rides').update({
      used_free_unlock: true
    }).eq('id', ride.id)
  }
}

applyFreeUnlock Funktion

async function applyFreeUnlock(admin, customerId): Promise<boolean> {
  // 1. Treue-Datensatz des Kunden abrufen
  // 2. Kontingent kostenloser Entsperrungen der Stufe abrufen
  // 3. Prüfen, ob monatlicher Reset nötig
  // 4. Verfügbarkeit kostenloser Entsperrungen verifizieren
  // 5. Zähler erhöhen
  // 6. Erfolg zurückgeben
}

API-Referenz

Treuestatus abrufen (Mobile)

GET /api/mobile/loyalty

Antwort enthält:

{
  "tier_progress": {
    "free_unlocks_used": 3,
    "free_unlocks_remaining": 2
  },
  "tier": {
    "free_unlocks_per_month": 5
  }
}

Stufenvorteile-Prüfung

import { getTierBenefits } from '@/lib/billing/loyalty'

const benefits = await getTierBenefits(admin, customerId, accountId)
// Gibt zurück: { canUseFreeUnlock: boolean, ... }

Best Practices

Mengen festlegen

1. Konservativ starten - Mit bescheidenen Kontingenten beginnen
2. Bedeutsame Abstufungen schaffen - Jede Stufe sollte sich wie ein Upgrade anfühlen
3. Wirtschaftlichkeit berücksichtigen - Durchschnittlichen Wert der Entsperrgebühr einbeziehen
4. Mit anderen Vorteilen ausbalancieren - Keine Stufe zu mächtig machen

Beispielberechnungen

Durchschnittliche Entsperrgebühr: $1,50
Gold-Stufe: 5 kostenlose Entsperrungen = $7,50 Wert/Monat
Platin-Stufe: 10 kostenlose Entsperrungen = $15,00 Wert/Monat

Kommunikation

1. Vorteil hervorheben - Kostenlose Entsperrungen prominent in Stufenbeschreibungen zeigen
2. Fortschritt zeigen - Nutzung klar in der App anzeigen
3. Vor Ablauf benachrichtigen - Kunden alertieren, wenn der Monat endet
4. Einsparungen feiern - Kumulative Einsparungen durch kostenlose Entsperrungen zeigen

Fehlerbehebung

Kostenlose Entsperrung wurde nicht angewendet

1. Stufenkonfiguration überprüfen - Prüfen, ob free_unlocks_per_month > 0
2. Nutzungszählung prüfen - Möglicherweise alle verfügbaren Entsperrungen verbraucht
3. Stufenzuordnung verifizieren - Kunde qualifiziert sich möglicherweise noch nicht für die Stufe
4. Reset-Datum prüfen - Sicherstellen, dass monatlicher Reset ordnungsgemäß erfolgte

Falsche Anzeige der Anzahl

1. Datenbank verifizieren - customer_loyalty.free_unlocks_used_this_month prüfen
2. Reset-Logik prüfen - free_unlocks_reset_at sollte aktueller Monat sein
3. Kürzliche Fahrten überprüfen - Nach Fahrten mit used_free_unlock = true suchen

Probleme mit monatlichem Reset

1. Reset-Auslöser prüfen - Erfolgt bei erster Fahrt, nicht automatisch
2. Datumsvergleich verifizieren - Reset-Datum sollte mit Monatsbeginn verglichen werden
3. Manueller Reset - Datenbankfunktion reset_monthly_free_unlocks kann helfen

Kombination mit anderen Vorteilen

Kostenlose Entsperrungen funktionieren zusammen mit anderen Stufenvorteilen:

Wenn eine kostenlose Entsperrung verwendet wird, wird unlock_discount_pct für diese Fahrt ignoriert, da die Gebühr bereits $0 ist.