Fahrzeugvalidierung

Fahrzeugvalidierung ist der Prozess, der bestimmt, ob ein Fahrzeug von einem Kunden gemietet werden kann. Wenn ein Kunde versucht, ein Fahrzeug zu scannen oder eine Fahrt zu starten, führt das System mehrere Validierungsprüfungen durch, um sicherzustellen, dass das Fahrzeug sicher, verfügbar und ordnungsgemäß konfiguriert ist.

Validierungsübersicht

Wann Validierung erfolgt

Fahrzeugvalidierung findet an mehreren Punkten statt:

Validierungsantwort

Jede Validierung gibt zurück:

• Erfolg: Fahrzeug ist verfügbar, Fahrt kann fortgesetzt werden
• Fehler: Fahrzeug kann nicht gemietet werden, mit Begründung

Validierungsprüfungen

Das System führt mehrere Prüfungen der Reihe nach durch. Alle müssen bestanden werden, damit ein Fahrzeug verfügbar ist.

1. Fahrzeug existiert

Prüfung: Existiert das Fahrzeug im System?

Häufige Fehlerursachen:

• Ungültiger oder beschädigter QR-Code
• Fahrzeug aus dem System gelöscht
• Fahrzeug aus anderer Umgebung (Staging vs. Produktion)

2. Statusprüfung

Prüfung: Hat das Fahrzeug einen verfügbaren Status?

3. Aktive-Fahrt-Prüfung

Prüfung: Hat das Fahrzeug bereits eine aktive Fahrt?

Dies verhindert Doppelbuchungen, auch wenn der Status nicht korrekt aktualisiert wurde.

4. Akkuladestand-Prüfung

Prüfung: Hat das Fahrzeug ausreichend Akku?

Beispiel: Wenn das Minimum auf 20% gesetzt ist, schlägt ein Fahrzeug mit 18% Akku die Validierung fehl.

5. IoT-Geräte-Prüfung

Prüfung: Ist ein funktionierendes IoT-Gerät angeschlossen?

Fahrzeuge ohne IoT-Geräte können nicht gemietet werden, weil:

• Entsperrbefehl nicht gesendet werden kann
• Standort während der Fahrt nicht verfolgt werden kann
• Fahrtende nicht verifiziert werden kann

6. Standortvalidierung

Prüfung: Befindet sich das Fahrzeug in einer erlaubten Zone?

7. Unterkonto-Prüfung

Prüfung: Hat der Kunde Zugang zu diesem Unterkonto?

Dies gilt, wenn:

• Mehrere Betreiber eine App teilen
• Kunde sich bei einem anderen Betreiber angemeldet hat
• Regionale Beschränkungen gelten

8. Kundenberechtigung

Prüfung: Darf der Kunde mieten?

Validierungsnachrichten

Erfolgsantwort

Bei bestandener Validierung:

{
  "valid": true,
  "vehicle": {
    "id": "fahrzeug-uuid",
    "vehicle_number": "VH-001",
    "battery_level": 85,
    "model": "Levy Max"
  },
  "pricing": {
    "unlock_fee": 1.00,
    "per_minute_rate": 0.35
  }
}

Fehlerantwort

Bei fehlgeschlagener Validierung:

{
  "valid": false,
  "error_code": "VEHICLE_LOW_BATTERY",
  "message": "Der Akku dieses Fahrzeugs ist zu niedrig. Bitte versuchen Sie ein anderes Fahrzeug.",
  "details": {
    "current_battery": 12,
    "minimum_required": 20
  }
}

Häufige Fehlercodes

Konfigurationsoptionen

Unterkonto-Einstellungen

Jedes Unterkonto kann Validierungsregeln konfigurieren:

Überschreibungsmöglichkeiten

Bestimmte Rollen können die Validierung umgehen:

Echtzeit-Verfügbarkeit

Kartenanzeige

In der Kunden-App-Karte:

• Nur validiert-verfügbare Fahrzeuge erscheinen
• Fahrzeuge, die eine Prüfung nicht bestehen, sind ausgeblendet
• Aktualisiert sich in Echtzeit, wenn sich Bedingungen ändern

Verfügbarkeitsberechnung

Das System bewertet kontinuierlich:

Verfügbar = Status ist 'available'
          UND Akku >= Minimum
          UND keine aktive Fahrt
          UND IoT verbunden
          UND im Servicegebiet

Fehlerbehebung bei Validierung

"Fahrzeug nicht verfügbar"

Schritte zur Diagnose:

1. Fahrzeugstatus prüfen im Dashboard
2. Akkuladestand überprüfen - liegt er über dem Minimum?
3. Auf aktive Fahrten prüfen auf dem Fahrzeug
4. IoT-Gerät verifizieren ist verknüpft und kommuniziert
5. Standort prüfen - ist Fahrzeug im Servicegebiet?

"Fahrzeug nicht gefunden"

Mögliche Ursachen:

1. QR-Code beschädigt - neu generieren und ersetzen
2. Falsche Umgebung - Staging vs. Produktion
3. Fahrzeug gelöscht - gelöschte Fahrzeuge prüfen
4. Unterkonto-Mismatch - Fahrzeug in anderem Unterkonto

Kunde kann kein Fahrzeug mieten

Kundenspezifische Probleme prüfen:

1. Kontostatus - gesperrt oder gebannt?
2. Zahlungsmethode - gültige Karte hinterlegt?
3. Offener Saldo - unbezahlte Beträge?
4. Verifizierung - Alters-/ID-Verifizierung erforderlich?
5. Aktive Fahrten - am Maximum-Limit?

Validierung besteht, aber Entsperren schlägt fehl

Validierung und Entsperren sind getrennt:

1. Validierung prüft Berechtigung (Datenbank)
2. Entsperren sendet Befehl an IoT-Gerät

Wenn Validierung besteht, aber Entsperren fehlschlägt:

• IoT-Gerät kann offline sein (veralteter Status)
• Befehl kann Zeitüberschreitung gehabt haben
• Gerät kann Hardwareproblem haben

API-Referenz

Fahrzeug validieren

POST /api/vehicles/{id}/validate

Anfrage:

{
  "customer_id": "kunden-uuid",
  "location": {
    "latitude": 40.7128,
    "longitude": -74.0060
  }
}

Antwort (Erfolg):

{
  "valid": true,
  "vehicle_id": "fahrzeug-uuid",
  "checks_passed": [
    "status",
    "battery",
    "iot_device",
    "no_active_ride",
    "service_area",
    "customer_eligible"
  ]
}

Antwort (Fehler):

{
  "valid": false,
  "error_code": "VEHICLE_LOW_BATTERY",
  "message": "Akkuladestand liegt unter der Mindestanforderung",
  "failed_check": "battery",
  "details": {
    "current": 15,
    "required": 20
  }
}

Fahrzeugverfügbarkeit prüfen (Leichtgewichtig)

GET /api/vehicles/{id}/available

Gibt einfachen Boolean für Kartenanzeige zurück:

{
  "available": true
}

Best Practices

Für Betreiber

1. Angemessene Mindestwerte setzen: Balance zwischen Verfügbarkeit und Sicherheit
2. Fehlgeschlagene Validierungen überwachen: Muster bei Fehlern verfolgen
3. Zonen aktuell halten: Servicegebiete korrekt halten
4. Regelmäßige Status-Audits: Verifizieren, dass Status der Realität entspricht

Für Integration

1. Alle Fehlercodes behandeln: Hilfreiche Benutzernachrichten bereitstellen
2. Angemessen cachen: Verfügbarkeit ändert sich häufig
3. Wiederholungen implementieren: Vorübergehende Fehler können sich lösen
4. Validierungsergebnisse protokollieren: Nützlich für Debugging

Für Kundenerfahrung

1. Klare Fehlermeldungen: Kunden helfen, Probleme zu verstehen
2. Alternativen vorschlagen: "Versuchen Sie ein anderes Fahrzeug in der Nähe"
3. Echtzeit-Updates: Nicht verfügbare Fahrzeuge schnell entfernen
4. Anforderungen erklären: Akkumindestwerte, Servicegebiete

---