Automatische Ruckerstattungen

Das automatische Ruckerstattungssystem erkennt Fahrten, die wahrscheinlich fehlgeschlagen sind oder Fehlfunktionen hatten, und erstattet Kunden automatisch auf ihr Wallet. Dies hilft, die Kundenzufriedenheit zu erhalten, wenn Fahrzeuge fehlfunktionieren, nicht ordnungsgemas entsperrt werden konnen oder andere Probleme auftreten, die zu sehr kurzen, erfolglosen Fahrten fuhren.

Funktionsweise

Der automatische Ruckerstattungs-Ablauf

Wenn eine Fahrt endet, bewertet das System, ob sie fur eine automatische Ruckerstattung qualifiziert ist:

Warum die Verzogerung?

Das System wartet eine konfigurierbare Anzahl von Minuten, bevor es die Ruckerstattung verarbeitet. Diese Verzogerung ermoglicht:

1. Spat eintreffende Telemetriedaten zur Aktualisierung der Fahrtmetriken
2. IoT-Datensynchronisation zum Abschluss mit endgultiger Entfernung/Dauer
3. Backend-Verarbeitung zur Finalisierung der Fahrtberechnungen

Dies verhindert vorzeitige Ruckerstattungen basierend auf unvollstandigen Daten.

Berechtigungskriterien

Eine Fahrt qualifiziert sich fur automatische Ruckerstattung, wenn ALLE der folgenden Punkte zutreffen:

Was gepruft wird

Die Berechtigungsbewertung verwendet folgende Fahrtdaten:

• Dauer in Sekunden
• Entfernung in Metern
• Gesamtkosten
• Abgebuchter Betrag
• Zahlungsstatus

Konfiguration

Zugang zu Einstellungen

Konfigurieren Sie automatische Ruckerstattungen im Admin-Dashboard:

1. Navigieren Sie zu Einstellungen
2. Klicken Sie auf den Tab Fahrten
3. Finden Sie den Abschnitt Automatische Ruckerstattungen

Konfigurationsoptionen

Empfohlene Werte nach Anwendungsfall

Konservativ (Weniger Ruckerstattungen)

Verwenden Sie diese Einstellungen, wenn Sie automatische Ruckerstattungen minimieren und manuelle Uberprufung bevorzugen mochten:

Standard (Ausgewogen)

Die Standardeinstellungen balancieren Kundenzufriedenheit mit betrieblicher Aufsicht:

Grosszugig (Mehr Ruckerstattungen)

Verwenden Sie diese Einstellungen fur maximale Kundenzufriedenheit:

Job-Status

Automatische Ruckerstattungs-Jobs durchlaufen diese Status:

Cron-Job-Details

Der automatische Ruckerstattungs-Cron lauft alle 5 Minuten uber Vercel Cron.

Verarbeitungsverhalten

Jede Cron-Ausfuhrung:

1. Verarbeitet bis zu 25 Jobs pro Durchlauf
2. Verarbeitet nur Jobs, bei denen scheduled_for ≤ NOW()
3. Verwendet optimistisches Sperren, um doppelte Verarbeitung zu verhindern
4. Bereinigt abgelaufene Jobs, die alter als 7 Tage sind

Antwortformat

Der Cron-Endpunkt gibt Verarbeitungsstatistiken zuruck:

{
  "success": true,
  "timestamp": "2025-01-19T12:00:00Z",
  "duration_ms": 1234,
  "processed": 15,
  "succeeded": 12,
  "cancelled": 2,
  "failed": 1,
  "total_refunded_usd": 24.50
}

Admin-Dashboard

Greifen Sie auf das Dashboard fur automatische Ruckerstattungen zu unter Dashboard > Ruckerstattungen > Automatisch.

Dashboard-Funktionen

Statistikkarten

• Ausstehende Jobs - Anzahl der auf Verarbeitung wartenden Jobs
• Erfolgreich (24h) - Erfolgreiche Ruckerstattungen in den letzten 24 Stunden
• Gesamt erstattet (24h) - Erstatteter Dollarbetrag
• Erfolgsrate - Prozentsatz der erfolgreichen Jobs

Ausstehende Jobs-Tabelle

• Fahrt-Link
• Kunden-Link
• Fahrtmetriken (Dauer, Entfernung)
• Ruckerstattungsbetrag
• Geplante Verarbeitungszeit
• Abbrechen-Aktion

Fehlgeschlagene Jobs-Warnung

• Prominent angezeigt, wenn Jobs Aufmerksamkeit benotigen
• Wiederholen- und Abbrechen-Aktionen

Aktuelle Ruckerstattungen-Tabelle

• Verarbeitete Ruckerstattungen der letzten 24 Stunden
• Betrag, Kunde, Fahrtdetails
• Job-ID zur Fehlerbehebung

Verfugbare Aktionen

Ruckerstattungsprozess-Details

Was wahrend der Ruckerstattung passiert

1. Job-Sperre erworben - Status auf processing gesetzt
2. Einstellungen validiert - Prufen, ob Auto-Ruckerstattung noch aktiviert
3. Fahrt neu abgerufen - Neueste Fahrtmetriken abrufen
4. Berechtigung neu bewertet - Bestatigen, dass noch innerhalb der Schwellenwerte
5. Erstattungsfahiger Betrag berechnet - Tatsachlich bezahlt minus bereits erstattet
6. Wallet gutgeschrieben - Wallet-Guthaben des Kunden erhoht
7. Wallet-Transaktion erstellt - Prufpfad aufgezeichnet
8. Fahrt aktualisiert - Als erstattet markiert, wenn vollstandig erstattet
9. Benachrichtigung gesendet - Push-Benachrichtigung an Kunden
10. Job abgeschlossen - Status auf succeeded gesetzt

Kundenbenachrichtigung

Wenn eine automatische Ruckerstattung ausgestellt wird, erhalten Kunden:

Push-Benachrichtigung:

• Titel: "Fahrtruckerstattung ausgestellt"
• Text: "Eine kurzliche Fahrt wurde automatisch auf Ihr Wallet erstattet."

Wallet-Transaktion:

• Typ: Gutschrift
• Beschreibung: "Automatische Fahrtruckerstattung"
• Referenz: Fahrt-UUID

Stornierungsgrunde

Jobs konnen aus verschiedenen Grunden storniert werden:

Manuelle Ruckerstattungen

Zusatzlich zu automatischen Ruckerstattungen konnen Betreiber manuelle Ruckerstattungen uber das Dashboard ausstellen.

Ruckerstattungstypen

Ruckerstattungsmodi

Eine manuelle Ruckerstattung verarbeiten

Berechtigungsanforderungen

Ruckerstattungen erfordern die Berechtigung ride:refund. Folgende Rollen konnen Ruckerstattungen verarbeiten:

• super_admin
• global_admin
• admin
• general_manager
• franchisee_manager
• fleet_manager
• customer_support

Hinweis: Analysten und Service-Techniker konnen keine Ruckerstattungen verarbeiten.

Uberwachung

Ausstehende Jobs anzeigen

SELECT
  id,
  ride_uuid,
  customer_uuid,
  status,
  scheduled_for,
  attempts,
  created_at
FROM ride_auto_refund_jobs
WHERE status = 'pending'
ORDER BY scheduled_for ASC;

Aktuelle automatische Ruckerstattungen anzeigen

SELECT
  r.id,
  r.ride_uuid,
  r.customer_uuid,
  r.amount,
  r.processed_at,
  r.metadata->>'job_id' as job_id
FROM ride_refunds r
WHERE r.metadata->>'automatic_refund' = 'true'
  AND r.processed_at > NOW() - INTERVAL '24 hours'
ORDER BY r.processed_at DESC;

Fehlgeschlagene Jobs prufen

SELECT
  id,
  ride_uuid,
  customer_uuid,
  attempts,
  last_error,
  created_at
FROM ride_auto_refund_jobs
WHERE status = 'failed'
ORDER BY updated_at DESC
LIMIT 20;

Fehlerbehebung

Jobs werden nicht erstellt

Prufung 1: Ist automatische Ruckerstattung aktiviert?

• Navigieren Sie zu Einstellungen > Fahrten > Automatische Ruckerstattungen
• Uberprufen Sie, ob der Schalter aktiviert ist

Prufung 2: Sind Fahrtmetriken innerhalb der Schwellenwerte?

• Prufen Sie Fahrtdauer (muss ≤ max_ride_duration_minutes sein)
• Prufen Sie Fahrtentfernung (muss ≤ max_total_distance_m sein)

Prufung 3: Hat die Fahrt einen Kunden?

• Uberprufen Sie, ob die Fahrt mit einem gultigen Kunden verknupft ist

Jobs stecken in Ausstehend fest

Prufung 1: Lauft der Cron?

• Uberprufen Sie, ob Vercel Cron konfiguriert ist
• Prufen Sie Vercel-Dashboard auf Cron-Ausfuhrungsprotokolle

Prufung 2: Sind Jobs fur die Zukunft geplant?

• Jobs werden erst verarbeitet, wenn scheduled_for ≤ NOW()

Prufung 3: Prufen Sie Vercel-Funktionsprotokolle auf Fehler

Jobs schlagen fehl

Haufige Fehler und Losungen:

Leistungsoptimierung

Hochvolumen-Flotten

Fur Flotten mit vielen Fahrten, erwagen Sie:

1. Cron-Frequenz erhohen - Alle 2-3 Minuten statt 5 ausfuhren
2. Stapelgrosse erhohen - 50-100 Jobs pro Durchlauf verarbeiten
3. Warteschlangen-Ruckstau uberwachen - Alarme fur Anzahl ausstehender Jobs einrichten

Datenbankoptimierung

Stellen Sie sicher, dass diese Indizes fur optimale Leistung existieren:

-- Ausstehende Job-Suche
CREATE INDEX CONCURRENTLY IF NOT EXISTS
  idx_ride_auto_refund_jobs_pending_scheduled
  ON ride_auto_refund_jobs (scheduled_for)
  WHERE status = 'pending';

-- Kunden-Wallet-Suche
CREATE INDEX CONCURRENTLY IF NOT EXISTS
  idx_customers_wallet
  ON customers (id, wallet_balance);

Empfohlene Alarme

Richten Sie Alarme ein fur:

1. Hohe Fehlerrate - Alarm, wenn fehlgeschlagene Jobs > 10% der verarbeiteten
2. Warteschlangen-Ruckstau - Alarm, wenn ausstehende Jobs > 100
3. Verarbeitungsverzogerung - Alarm, wenn Jobs > 30 Minuten uberfällig
4. Ausfuhrungsfehler - Alarm, wenn Cron-Endpunkt 500 zuruckgibt

Nachste Schritte

• Stripe-Einrichtung - Stripe-Integration konfigurieren
• Zahlungsmethoden - Kundenkarten verwalten
• Schadensgebuhren - Kunden fur Schaden belasten