Fahrt pausieren

Das Pausieren von Fahrten ermoglicht es Kunden, ihre Fahrt vorubergehend zu stoppen, wahrend das Fahrzeug reserviert bleibt. Diese Funktion ist wesentlich fur Pausen wahrend der Fahrt und wird auch vom System fur automatische Eingriffe verwendet, wenn bestimmte Bedingungen erkannt werden.

Ubersicht

Die Pausenfunktion dient zwei Hauptzwecken:

1. Vom Kunden initiierte Pause - Lasst Kunden Pausen machen, ohne ihre Fahrt zu beenden
2. Vom System initiierte Pause - Pausiert Fahrten automatisch, wenn Bedingungen ein Eingreifen erfordern

Das Verstandnis der verschiedenen Pausenarten und ihrer Verhaltensweisen ist fur Betreiber entscheidend, da sie unterschiedliche Sicherheitsauswirkungen und Fahrzeugbefehlsmuster haben.

Schlusselkonzepte

Pausenarten

Manuelle Pause (vom Kunden initiiert)

Wenn ein Kunde seine Fahrt uber die App pausiert:

Haufige Verwendung:

• Kurze Ladenstopps
• Kaffeepausen
• Auf Freunde warten
• Mehrziel-Fahrten

Auto-Pause: Inaktivitat

Wenn das Fahrzeug langere Zeit stillgestanden hat:

Erkennungslogik:

WENN Fahrzeug sich nicht uber stationary_radius_m hinaus bewegt hat
   fur stationary_minutes Dauer
UND keine aktuelle Bewegung erkannt (Geschwindigkeit < recent_motion_speed_kmh)
DANN Auto-Pause auslosen

Auto-Pause: Kein Standort

Wenn das Fahrzeug aufhort, GPS-Standort zu melden:

Haufige Ursachen:

• Innenraum-Parken (GPS blockiert)
• Funklöcher
• IoT-Gerat-Probleme
• Akkuprobleme

Auto-Pause: Unzureichende Mittel

Warum keine Sperre?

Dies ist eine kritische Sicherheitsentscheidung:

Beim Pausieren wegen unzureichender Mittel bewegt sich der Fahrer moglicherweise mit hoher Geschwindigkeit. Das Sperren der Rader wahrend der Fahrt konnte einen gefahrlichen Unfall verursachen. Stattdessen deaktivieren wir nur das Gas, was dem Fahrer ermoglicht, sicher zum Stillstand zu rollen, bevor das Fahrzeug unbrauchbar wird.

Die Gas-Deaktivierung:

• Unterbricht die Stromzufuhr zum Motor
• Lasst Rader frei drehen (Rollen)
• Fahrer kann zu einem sicheren Haltepunkt gleiten
• Fahrzeug stoppt nicht abrupt

Sicherheitsmatrix

Das System verwendet diese Entscheidungsmatrix fur Pausenverhalten:

Warum das wichtig ist

Szenario: Kunde fahrt mit 25 km/h, als sein Guthaben aufgebraucht ist.

Korrektes Verhalten (nur Gas):

• Motorleistung wird unterbrochen
• Kunde rollt naturlich zum Stillstand
• Kunde steigt sicher ab
• Kunde ladt Guthaben auf oder beendet Fahrt

Falsches Verhalten (Rader sperren):

• Rader sperren bei 25 km/h
• Kunde sturzt
• Mogliche schwere Verletzung
• Erhebliche Haftung

Gas-Pause-Upgrade

Wenn eine Fahrt gas-pausiert ist (unzureichende Mittel), uberwacht das System auf eine Gelegenheit zum Upgrade auf volle Sperre.

Warum upgraden?

Die Nur-Gas-Pause ist eine Sicherheitsmassnahme fur bewegte Fahrzeuge. Sobald das Fahrzeug stillsteht, ist es sicher, die volle Sperre fur bessere Sicherheit anzuwenden.

Upgrade-Prozess

Der Auto-Pause-Cron-Job uberwacht gas-pausierte Fahrten:

1. Prufen, ob Fahrt gas-pausiert ist (auto_pause_reason = 'insufficient_funds')
2. Prufen, ob Fahrzeug jetzt stillsteht
3. Falls lange genug stillstehend:
   a. SPERREN-Befehl an Fahrzeug senden
   b. Fahrtstatus aktualisieren auf "Pausiert (Gesperrt)"
   c. Upgrade-Ereignis protokollieren

Erkennungskriterien

Eine gas-pausierte Fahrt wird auf volle Sperre upgegraded, wenn:

• Fahrzeug sich nicht uber den Schwellenwert stationary_radius_m hinaus bewegt hat
• Keine aktuelle Bewegung erkannt (Geschwindigkeit < recent_motion_speed_kmh)
• Fahrzeug auf Befehle reagiert

Pausen-Abrechnung

Wie Pausentarife funktionieren

Wahrend pausierter Zeitraume gilt ein reduzierter Tarif:

Aktives Fahren:  0,39 € pro Minute
Pausiert:        0,10 € pro Minute (Beispiel)

Pausentarife werden in den Preisregeln fur jedes Fahrzeugmodell konfiguriert.

Abrechnungsberechnungsbeispiel

Fahrt: 20 Minuten gesamt
- 15 Minuten aktives Fahren
- 5 Minuten pausiert

Entsperrgebuhr:           1,00 €
Aktive Zeit:              15 × 0,39 € = 5,85 €
Pausenzeit:               5 × 0,10 € = 0,50 €
────────────────────────────────────────
Gesamt:                   7,35 €

Kontinuierliche Abrechnung

Wahrend Auto-Pause wegen unzureichender Mittel:

• Abrechnung lauft mit Pausentarif weiter
• Guthabensaldo kann weiter ins Negative gehen
• Kunde erhalt Push-Benachrichtigung
• Fahrt dauert an, bis Guthaben aufgeladen oder automatisch beendet

Auto-Pause-Konfiguration

Konfigurieren Sie Auto-Pause-Verhalten in Einstellungen > Sonstiges:

Stillstandserkennung-Einstellungen

{
  "auto_pause_if_stationary": {
    "enabled": true,
    "stationary_minutes": 30,
    "stationary_radius_m": 100,
    "max_movement_within_radius_m": 0,
    "recent_motion_window_seconds": 60,
    "recent_motion_speed_kmh": 2
  }
}

Niedriges-Guthaben-Einstellungen

{
  "payments": {
    "stop_vehicle_on_low_balance": true,
    "stop_vehicle_threshold_cents": 0
  }
}

Schwellenwert auf 0 setzen bedeutet, dass das Fahrzeug stoppt, wenn das Guthaben negativ wird.

Fortsetzungsanforderungen

Guthabenprufung bei Fortsetzung

Bevor eine Fahrt fortgesetzt werden kann, validiert das System, dass der Kunde ausreichende Mittel hat:

Erforderliches Guthaben = pro_minute_rate_cents × 1 Minute

Falls das Guthaben unter diesem Minimum liegt:

• Fortsetzung wird blockiert
• Kunde erhalt Fehler mit erforderlichem vs. aktuellem Guthaben
• Kunde muss zuerst Guthaben aufladen
• Auto-Aufladung kann auslosen, falls aktiviert

Beispiel:

Pro-Minute-Tarif: 0,39 €
Erforderliches Minimum: 0,39 € (39 Cent)
Kundenguthaben: 0,25 €

Ergebnis: Fortsetzung blockiert - "Unzureichendes Guthaben"
Erforderlich: 0,39 € | Aktuell: 0,25 €

Auto-Ende nach Pause

Fahrten konnen automatisch beendet werden, wenn zu lange pausiert:

Konfiguration

{
  "auto_end_if_not_moving": {
    "enabled": true,
    "not_moving_radius_m": 75,
    "end_after_pause_minutes": 30
  }
}

Auto-Ende-Verhalten

Wenn Bedingungen erfullt sind:

1. System pruft, ob Fahrzeug in gultiger Parkzone ist
2. Falls gultig, wird Fahrt automatisch beendet
3. Endpreis wird berechnet und belastet
4. Kunde erhalt Push-Benachrichtigung
5. Fahrzeug wird fur nachste Miete verfugbar

Falls nicht in gultiger Zone:

• Fahrt bleibt pausiert
• System uberwacht weiter
• Manuelles Eingreifen kann erforderlich sein

API-Endpunkte

Fahrt pausieren (Mobil)

POST /api/mobile/rides/{ride_id}/pause/

Authentifizierung: Kunden-JWT erforderlich

Anfrage-Body:

{
  "pause_location": {
    "latitude": 37.7749,
    "longitude": -122.4194
  }
}

Antwort (200 OK):

{
  "ok": true,
  "ride_status": "paused",
  "paused_at": "2024-01-15T14:30:00Z",
  "lock": {
    "attempted": true,
    "success": true,
    "protocol": "OKAI"
  }
}

Fahrt fortsetzen (Mobil)

POST /api/mobile/rides/{ride_id}/resume/

Authentifizierung: Kunden-JWT erforderlich

Antwort (200 OK):

{
  "ok": true,
  "ride_status": "active",
  "resumed_at": "2024-01-15T14:45:00Z",
  "unlock": {
    "attempted": true,
    "success": true,
    "protocol": "OKAI"
  }
}

Fehlerantwort (Unzureichende Mittel):

{
  "error": "Unzureichendes Guthaben",
  "required": 0.39,
  "balance": 0.25
}

Admin Pausieren/Fortsetzen

Administratoren konnen auch Fahrten pausieren und fortsetzen:

POST /api/rides/{ride_id}/pause/
POST /api/rides/{ride_id}/resume/

Authentifizierung: Admin-Sitzung erforderlich Berechtigung: ride:update

Webhook-Integration

Das System sendet Webhooks an Partner-APIs, wenn Pausen und Fortsetzungen auftreten.

Pause-Webhook

Wenn eine Fahrt pausiert wird, reiht das System einen ride.paused-Webhook ein:

{
  "event": "ride.paused",
  "data": {
    "ride_id": "uuid-12345",
    "customer_id": "uuid-kunde",
    "vehicle_id": "uuid-fahrzeug",
    "paused_at": "2024-01-15T14:30:00Z",
    "pause_reason": "manual",
    "subaccount_id": "uuid-unterkonto"
  }
}

Fortsetzungs-Webhook

Wenn eine Fahrt fortgesetzt wird, reiht das System einen ride.resumed-Webhook ein:

{
  "event": "ride.resumed",
  "data": {
    "ride_id": "uuid-12345",
    "customer_id": "uuid-kunde",
    "vehicle_id": "uuid-fahrzeug",
    "resumed_at": "2024-01-15T14:45:00Z",
    "pause_duration_seconds": 900,
    "subaccount_id": "uuid-unterkonto"
  }
}

Fahrzeugbefehle

Sperrsequenz (Standard-Pause)

Wenn eine Fahrt normal pausiert wird:

1. SPERREN-Befehl an Fahrzeug senden
2. Auf Bestatigung warten (bis zu 10 Sekunden)
3. GAS_AUS-Befehl senden
4. Auf Bestatigung warten
5. Fahrtstatus auf 'paused' aktualisieren
6. Webhook-Benachrichtigung einreihen

Nur-Gas-Sequenz (Niedriges Guthaben)

Beim Pausieren wegen unzureichender Mittel:

1. Nur GAS_AUS-Befehl senden
2. Auf Bestatigung warten
3. Fahrtstatus auf 'paused' aktualisieren
4. KEINEN SPERREN-Befehl senden (Sicherheit)
5. Webhook-Benachrichtigung einreihen

Fortsetzungssequenz

Beim Fortsetzen einer pausierten Fahrt:

1. Guthabensaldo validieren (muss mindestens 1 Minute Fahrt abdecken)
2. ENTSPERREN-Befehl an Fahrzeug senden
3. Auf Bestatigung warten
4. GAS_AN-Befehl senden
5. Auf Bestatigung warten
6. Fahrtstatus auf 'active' aktualisieren
7. Pausenfelder loschen (auto_paused_at, auto_pause_reason)
8. Webhook-Benachrichtigung an Partner-API einreihen

Befehlsfehler

Falls Fahrzeugbefehle fehlschlagen:

Kundenerfahrung

Pause-Benachrichtigungen

Wenn eine Fahrt pausiert wird, erhalt der Kunde:

Manuelle Pause:

Fahrt pausiert
Ihre Fahrt ist pausiert. Die Abrechnung lauft mit reduziertem Pausentarif weiter.
Tippen Sie auf Fortsetzen, wenn Sie bereit sind weiterzufahren.

Auto-Pause (Inaktivitat):

Fahrt auto-pausiert
Ihre Fahrt wurde wegen Inaktivitat pausiert. Das Fahrzeug ist gesperrt.
Tippen Sie auf Fortsetzen, um Ihre Fahrt fortzusetzen.

Auto-Pause (Niedriges Guthaben):

Niedriges Guthaben - Fahrzeug gestoppt
Ihr Guthaben ist zu niedrig. Der Motor wurde deaktiviert.
Laden Sie Ihr Guthaben auf, um weiterzufahren.
[Jetzt aufladen]

Fortsetzungsablauf

1. Kunde offnet App
2. Sieht "Pausiert"-Status
3. Tippt auf "Fortsetzen"-Button
4. App sendet Fortsetzungsanfrage
5. Fahrzeug entsperrt und aktiviert Gas
6. Abrechnung wechselt zuruck zum aktiven Tarif
7. Kunde fahrt weiter

Dashboard-Verwaltung

Pausierte Fahrten anzeigen

Auf der Fahrtenlisten-Seite:

1. Nach "Pausiert"-Status filtern
2. Status-Abzeichen zeigt Pausenart
3. Dauerspalte zeigt Gesamtzeit einschliesslich Pause

Admin-Aktionen

Von der Fahrtdetailseite:

Fortsetzen-Button:

• Sichtbar, wenn Fahrt pausiert ist
• Sendet Entsperren + Gas-an-Befehle
• Aktualisiert Fahrt auf aktiven Status

Fahrt beenden-Button:

• Verfugbar fur aktive und pausierte Fahrten
• Beendet Fahrt am aktuellen Standort
• Berechnet Endpreis

Fehlerbehebung

Fahrzeug sperrt bei Pause nicht

Mogliche Ursachen:

• IoT-Gerat offline
• Schwaches Mobilfunksignal
• Befehlszeituberschreitung
• Gerat-Firmware-Problem

Losung:

1. Letzte Signalzeit des Fahrzeugs prufen
2. Pause-Befehl wiederholen
3. Dashboard fur manuelle Sperre verwenden
4. Bei Bedarf Aussendienst-Team entsenden

Fahrzeug entsperrt bei Fortsetzung nicht

Mogliche Ursachen:

• IoT-Gerat offline
• Befehl erreichte Fahrzeug nicht
• Physischer Sperrmechanismus klemmt

Losung:

1. Fortsetzungsbefehl wiederholen
2. IoT-Geratestatus prufen
3. Fahrt beenden, falls Fortsetzung nicht moglich
4. Ruckerstattung ausstellen, falls gerechtfertigt
5. Fahrzeug fur Wartung markieren

Kunde steckt im pausierten Zustand fest

Falls Kunde nicht fortsetzen kann:

1. Fahrtstatus im Dashboard prufen
2. Admin-Fortsetzungsaktion versuchen
3. Fahrt bei Bedarf beenden
4. Angemessene Ruckerstattung ausstellen
5. Fahrzeug-/IoT-Problem untersuchen

Auto-Pause lost zu haufig aus

Einstellungen anpassen:

• stationary_minutes erhohen
• stationary_radius_m erhohen
• Bewegungserkennungsschwellen anpassen
• Erwagen, fur bestimmte Standorte zu deaktivieren

Best Practices

Fur Betreiber

1. Pausierte Fahrten uberwachen - Taglich auf langere Pausen prufen
2. Auto-Pause-Protokolle uberprufen - Nach Mustern suchen, die auf Probleme hinweisen
3. Schwellenwerte sorgfaltig konfigurieren - Balance zwischen Komfort und Missbrauch
4. Support-Team schulen - Wissen, wie pausenbezogene Probleme zu behandeln sind

Fur Konfiguration

1. Konservativ beginnen - Mit deaktivierter Auto-Pause beginnen
2. Grundlich testen - Fahrzeugbefehle vor Aktivierung verifizieren
3. Ihren Markt berucksichtigen - Stadtische Gebiete benotigen moglicherweise andere Einstellungen
4. Mit Kunden kommunizieren - Pausenrichtlinien in der App erklaren

Fur Sicherheit

1. Niemals fahrende Fahrzeuge sperren - Immer nur Gas fur niedriges Guthaben
2. Befehlszuverlassigkeit testen - Sicherstellen, dass Fahrzeuge konsistent reagieren
3. Manuelle Uberschreibungen haben - Dashboard sollte immer Eingreifen ermoglichen
4. Vorfalle dokumentieren - Sicherheitsbezogene Probleme verfolgen

Verwandte Artikel

• Fahrten verwalten
• Fahrtdetailseite
• Gruppenfahrten beenden
• Fahrt-Feedback-System