Fehlerbehebung

Fahrer-Score ist Soft-Fail. Fehler werden protokolliert, blockieren aber nie eine Fahrt. Das macht Probleme oft still.

Eine Fahrt hat keinen Score

Symptom: Abgeschlossene Fahrt existiert, aber keine ride_safety_signals-Zeile.

Prufen, in Reihenfolge:

1. Subkonto aktiviert? subaccount_rider_score_settings.enabled = true.
2. Fahrt in bewertetem Zustand beendet? Abgebrochene Fahrten werden nicht bewertet.
3. Zu kurz? Unter min_ride_seconds (60) oder min_ride_meters (200) ausgeschlossen.
4. Server-Log-Eintrag? Sentry prufen.
5. Manuelle Neuberechnung. POST /api/internal/rider-score/recompute mit { rideId }.

Rollierender Score stimmt nicht mit Fahrt-Scores uberein

Symptom: Drei hohe Fahrt-Scores, aber rollierender Score kaum bewegt.

Prufen:

1. Wie viele bewertete Fahrten? Mit drei Fahrten ist der Fahrer noch Anfanger.
2. Halbwertszeit? Bei 90 Tagen kaum Bewegung.
3. Fenster? Historische schlechte Fahrten zahlen noch.
4. Kurz-Fahrten ausgeschlossen? Nur Fahrten uber den Schwellen werden gezahlt.

Stufe sitzt fest

Symptom: Score uberschritt Grenze vor einer Stunde, aber Abzeichen geandert sich nicht.

Prufen:

1. rider_scores.computed_at - rollierender Score neu berechnet?
2. Push-Zustellung - Stufe aktualisiert nach Push.
3. pickTierForScore-Snapshot - sich uberschneidende Bereiche?
4. Manuelle Neuberechnung - POST /api/internal/rider-score/recompute mit { customerId }.

Pramie wurde nicht ausgestellt

Symptom: Gold-Fahrer beendete Fahrt, guter Score, aber keine Gutschrift.

rider_score_rewards fur diese Fahrt prufen. status-Feld:

Intervention wurde nicht ausgelost

Symptom: Score unter 40 aber keine Drosselbegrenzung.

Prufen:

1. Leiterregel. Schritt 4 aktiviert?
2. rider_interventions-Zeile. Schritt-4-Intervention offen?
3. getActiveInterventionState - Sentry prufen.
4. IoT-Drossel-Unterstutzung. Fahrzeuge ohne Drosselbefehle uberspringen Schritt 4.
5. Aktiver Einspruch. Wenn Fahrer Einspruch eingelegt hat, ist die Intervention pausiert - korrektes Verhalten.

Helm-Selfie-Rabatt wurde nicht angewendet

Symptom: Selfie verifiziert aber Entsperrgebuhr nicht reduziert.

Prufen:

1. rider_helmet_selfies-Zeile. passed_at gesetzt? ttl_expires_at in der Zukunft?
2. consumed_at - bei helmet_single_use=true bereits verbraucht.
3. apply-uplift.ts - in Pricing-Flow eingebunden?
4. Subkonto-Einstellung - helmet_discount_unlock_fee_cents > 0?
5. Falsche Tabelle. Altere interne Dokumente referenzieren helmet_verifications (CV-Pipeline). Die rider-score-Helm-Tabelle ist rider_helmet_selfies.

Reaktionstest wird wiederholt ausgelost

Symptom: Fahrer bestand den Test, aber App fragt beim nachsten Unlock erneut.

Prufen:

1. reaction_repeat_hours - Standard 6. Mehr als 6 Stunden vergangen?
2. reaction_window_* - Unlock im Nachtfenster?
3. reaction_tests-Zeile - passed=true?
4. Zufalls-Trigger - reaction_random_trigger_pct > 0?

Score andert sich nicht nach Gewichts-Anderung

Symptom: Gewichte vor einer Stunde aktualisiert, aber rollierende Scores identisch.

Erwartet. Gewichts-Anderungen:

• Wirken sofort auf zukunftige Fahrt-Scores.
• Losen einmalige vollstandige Neuberechnung uber den nachtlichen Cron aus.
• Andern ruckwirkend KEINE gespeicherten Fahrt-Scores.

Fur sofortige Neuberechnung: POST /api/internal/rider-score/recompute mit { subaccountId }.

Prufspur-Eintrag fehlt

Symptom: Intervention aufgehoben mit Grund, aber kein Eintrag in Prufspur.

Prufen:

1. Zeitbereich-Filter - Standard letzte 30 Tage.
2. Actor-Filter - System-Aktionen erscheinen nicht bei Filter auf eigene user_id.
3. Aktions-Typ-Filter - "intervention_lift" unterscheidet sich von "intervention_close".

Cron lauft nicht

Symptom: Nachtliche Neuberechnung scheint nie zu feuern.

Prufen:

1. vercel.json Eintrage fur /api/cron/rider-score-recompute, etc.
2. Cron-Auth-Header - geteiltes Geheimnis.
3. Vercel-Dashboard > Cron Jobs.

---