Interventionsleiter

Wenn der Score eines Fahrers fallt, geht die Interventions-Engine eine 7-stufige Leiter durch. Jeder Schritt ist gestuft. Konfigurierbar pro Subkonto unter Einstellungen > Leiterregeln.

Der Kernel lebt unter src/lib/rider-score/intervention-engine.ts. Das Vor-Entsperrungs-Tor ist getActiveInterventionState() in src/app/api/mobile/rides/start/route.ts.

Die 7 Schritte

Schritte 1-3 sind Reibung ohne Leistungseinfluss. Schritte 4-7 schranken die Fahrt tatsachlich ein. Jeder Schritt schreibt in rider_interventions.

Wie jeder Schritt den Fahrer erreicht

Schritt 1 - In-App-Hinweis

Sanft. Ein Banner erscheint auf der Aufschlusselung. Bestatigen loscht die Intervention.

Schritt 2 - Push-Warnung

Gesendet uber die bestehende Push-Pipeline. Mit Link zum Verbesserungs-Leitfaden.

Schritt 3 - Bildungsquiz

Vor dem nachsten Unlock muss der Fahrer ein 5-Fragen-Zufallsquiz aus einem 6-Fragen-Pool bestehen. Optionen werden gemischt. Der Antwortschlussel wird als HMAC-signiertes Token zuruckgegeben, um Manipulation zu verhindern. Bestehen: 4 von 5.

Schritt 4 - Drosselbegrenzung (Anfanger-Modus)

Dieser Schritt erreicht das Fahrzeug. Nach Fahrt-Erstellung ruft der Post-Start-Hook applyThrottleCapToVehicle() auf, das in src/lib/iot/disable-throttle.ts aufruft.

• OKAI, Segway, Omni 4G: anvisiert fur echte Teildrosselung wenn OEM-Befehle verdrahtet sind. Heute fallt die Implementierung auf vollstandige Deaktivierung als konservative Grenze zuruck.
• Fahrzeuge ohne Drosselbefehl-Unterstutzung uberspringen Schritt 4 und springen zu Schritt 5.
• Die Begrenzung wird automatisch aufgehoben, wenn die nachste Fahrt endet.

Schritt 5 - Preisaufschlag

Ein 25%-Aufschlag wird auf die nachsten 10 Fahrten angewendet. consumeUpliftForRide() dekrementiert den Zahler. Der Aufschlag wird beim Unlock klar gezeigt.

Schritt 6 - 7-Tage-Zeit-Sperre

Vor-Entsperrungs-Tor. Der Fahrer sieht einen Sperrbildschirm mit dem Grund und der Ablaufzeit. Ride-Start wird auf API-Ebene blockiert (reason='temp_lockout').

Schritt 7 - Dauerhafte Sperre

Gleiches Tor wie Schritt 6, ohne automatischen Ablauf. Schritt 7 wird nur ausgelost, wenn Schritt 6 innerhalb der letzten 60 Tage fur denselben Fahrer ausgelost wurde. Erfordert manuelle Ops-Prufung.

Vor-Entsperrungs-Tor

Schritte 3, 4, 6 und 7 sperren beim Fahrt-Start:

getActiveInterventionState(customerId, subaccountId)
  -> blocked: 'permanent_ban' | 'temp_lockout' | 'force_quiz_required'
  -> throttleCap: { mode: 'beginner' } | null
  -> upliftPct: 25 | null

Einspruche pausieren die Leiter

Einspruch einlegen flippt die verknupfte Intervention auf status='paused_pending_appeal'. Die Intervention wird wahrend des Einspruchs nicht durchgesetzt.

• Akzeptiert: Score wird uberschrieben, rollierender Score neu berechnet.
• Abgelehnt: Intervention offnet sich wieder mit ursprunglicher Ablauf-Mathematik.

Prufspur

Jede Intervention - Erstellung, Eskalation, Bestatigung, Ablauf, Einspruchs-Auflosung, Aufhebung, Bann - schreibt eine Zeile in score_audit_log.

Pro-Subkonto-Optimierung

Sie konnen Schwellenwerte, Aufschlags-Fahrtanzahl, Sperrdauer und 60-Tage-Fenster bearbeiten. Sie konnen einen Schritt nicht entfernen, aber effektiv deaktivieren.

Was der Betreiber sieht

• Dashboard > Fahrer-Score > Interventionen: alle aktiven Interventionen mit "Aufheben"-Schaltflache.
• Prufspur: vollstandige Geschichte.
• Einspruche: ausstehende Einspruche.

Was der Fahrer sieht

• Banner nach der Fahrt wenn neue Intervention.
• Aktive Interventionen mit Erklarung zum Loschen.
• Vor-Entsperrungs-Bildschirm bei harten Interventionen.

---