Vendor-Setup — Drover & Luna

Die Gehwegerkennung erfordert Fahrzeug-Hardware. Levy Vision integriert mit Drover AI PathPilot (primär) und Luna Systems (Alternative, stärker in der EU). Dieser Artikel führt Sie durch die Pipeline Beschaffung → Installation → Provisionierung → Verifizierung für beide. Wir behandeln am Ende auch Captur.ai — Captur liefert einen Parkpose-Klassifikator, keine Gehweg-Hardware.

Falls Sie überhaupt keine Gehwegerkennung betreiben, überspringen Sie diesen Artikel — Helm und Parkpose funktionieren ohne jegliche Vendor-Hardware.

Vendor wählen

Kostenangaben sind Schätzungen aus öffentlicher Berichterstattung. Ihr tatsächliches Angebot kommt vom Vendor in Ihrem kommerziellen Gespräch. Kontaktieren Sie Ihren Levy-Account-Manager für einen Intro.

Schritt 1 — Vendor-Vereinbarung unterzeichnen

Sowohl Drover als auch Luna verlangen eine Papier-Vereinbarung, bevor sie Geräte für Sie provisionieren. Levy verkauft die Hardware nicht weiter — Sie kaufen direkt, wir integrieren über Webhooks.

Was Sie vom Vendor brauchen:

• API-Key für ihre Provisionierungs-API
• Webhook-Signing-Secret (pro Unterkonto bevorzugt)
• Geräte-Seriennummern für die zu installierenden Einheiten
• OEM-Kompatibilitätsliste für Ihre spezifischen Scooter-/Bike-Modelle

Speziell für die Gehwegerkennung auf dem OKAI ES400 bestätigen Sie mit dem Vendor, dass Mid-Ride-Speed-Cap auf Ihrer Hardware-Version funktioniert — ältere ES400-Firmware akzeptiert HBLB-Geschwindigkeitsbefehle nicht zuverlässig.

Schritt 2 — Hardware an Fahrzeugen installieren

Das ist mechanische Arbeit und variiert nach Vendor und Fahrzeugmodell. Der Vendor stellt Installationsanleitungen bereit; der Levy-Support hat Installationsnotizen für gängige Kombinationen (Drover + Segway Max Plus, Drover + OKAI ES400, Luna + die meisten Scooter).

Praktische Tipps:

• Pilotieren Sie 5–10 Fahrzeuge, bevor Sie die ganze Flotte installieren. Hardware-DOA-Raten liegen bei der Erstinstallation bei 2–5 %.
• Machen Sie Fotos von jeder Installation — nützlich, falls eine Einheit später Ärger macht und Sie eine Vendor-RMA einreichen müssen.
• Notieren Sie jede Geräteseriennummer und an welches Fahrzeug sie ging. Diese geben Sie in Schritt 3 in Levy ein.

Schritt 3 — Geräte in Levy provisionieren

Öffnen Sie Dashboard > Safety > Vendor devices. Die Seite zeigt jedes provisionierte Gerät für Ihr Unterkonto.

Um ein neues hinzuzufügen:

1. Klicken Sie Provision device.
2. Wählen Sie den Vendor (drover oder luna).
3. Geben Sie die Geräteseriennummer ein (vom Vendor).
4. Wählen Sie das Fahrzeug aus dem Dropdown (es erscheinen nur Fahrzeuge in Ihrem Unterkonto).
5. Klicken Sie auf Save.

Im Hintergrund schreibt das eine Zeile in cv_vendor_devices, die die Vendor-Seriennummer mit der Fahrzeug-UUID verknüpft. Wenn Ereignisse vom Vendor-Webhook eingehen, nutzen wir dieses Mapping, um das Ereignis dem richtigen Fahrzeug und der richtigen Fahrt zuzuordnen.

Sie können das per CSV-Upload (device_serial,vehicle_uuid) bulk machen — nützlich für flottenweite Rollouts von mehr als ~20 Geräten.

Schritt 4 — Webhook-Secret konfigurieren

Öffnen Sie Dashboard > Safety > Safety settings und finden Sie das Feld Webhook signing secret. Fügen Sie das vom Vendor erhaltene Secret ein.

Warum pro Unterkonto? Verschiedene Betreiber auf Ihrer Plattform können verschiedene Vendor mit verschiedenen Secrets nutzen. Pro-Unterkonto-Speicherung heißt, wir verifizieren jeden eingehenden Webhook gegen den richtigen Schlüssel.

Einmal gespeichert, wird dieses Secret im Ruhezustand verschlüsselt. Es wird nie protokolliert, nie über die API zurückgegeben, und Sie können es jederzeit rotieren, ohne bereits erfasste Ereignisse zu beeinflussen.

Schritt 5 — Dem Vendor sagen, wohin Ereignisse senden

Geben Sie dem Vendor diese Webhook-URLs:

Bitten Sie sie auch, Ihre Unterkonto-ID im X-Levy-Subaccount-Id-Header bei jedem Request einzuschließen. Ohne den fallen wir auf das globale Webhook-Secret zurück, was bei Multi-Tenant-Setups weniger sicher ist.

Für das HMAC-Signatur-Schema:

• Drover — Header X-Drover-Signature: t=<unix_ts>,v1=<hmac_sha256_hex> über Body
• Luna — Header X-Luna-Signature: <hmac_sha256_hex> über Body
• Captur — Header X-Captur-Signature: <hmac_sha256_hex> über Body

Die Vendor-Dokumentation erklärt, wie ihr SDK Requests signiert. Wir verifizieren die Signatur bei jedem Request und lehnen Mismatches mit 401 ab.

Schritt 6 — Pipeline verifizieren

Lösen Sie ein Testereignis vom Vendor aus. Drover und Luna haben beide eine "Send test event"-Funktion in ihrem Dashboard.

1. Lösen Sie ein Testereignis für ein provisioniertes Gerät aus.
2. Innerhalb weniger Sekunden sollten Sie eine Zeile in Safety > Events mit event_type=sidewalk_entry und source=drover (oder luna) sehen.
3. Die Side-Effects-Spalte sollte leer sein (Testereignisse feuern standardmäßig keine Policy).

Falls das Ereignis nicht erscheint:

• Prüfen Sie die Vendor devices-Seite — existiert das Seriennummer-zu-Fahrzeug-Mapping?
• Prüfen Sie den Artikel Fehlerbehebung — der Diagnose-Baum "Keine Gehweg-Ereignisse" deckt Webhook-Ausfälle ab.
• Prüfen Sie Sentry, falls Sie Zugriff haben — Webhook-Signatur-Fehler werden dort protokolliert.

Schritt 7 — Durchsetzung aktivieren

Sobald Ereignisse eine Woche lang zuverlässig fließen, sind Sie bereit, die Durchsetzung umzulegen. Öffnen Sie Safety > Safety settings:

• Schalten Sie Sidewalk detection enabled auf an
• Lassen Sie Throttle cut enabled im ersten Monat deaktiviert — setzen Sie nur mit Warn + Speed Reduce durch
• Setzen Sie Schwellenwerte gemäß Throttle-Cut-Policy

Prüfen Sie die Seite Sidewalk hotspots wöchentlich. Fügen Sie Geofence-Allow-List-Polygone für klare False-Positive-Zonen hinzu (geschützte Radwege, Plätze, die Ihre Stadt erlaubt).

Captur.ai (nur Parkpose)

Wenn Sie einen Premium-Parkpose-Klassifikator statt Gemini wollen, ist Captur.ai die Option. Die Einrichtung ist einfacher — keine Hardware:

1. Unterzeichnen Sie die Captur.ai-Vereinbarung, holen Sie den API-Key.
2. Öffnen Sie Safety > Safety settings und setzen Sie Parking classifier auf Captur.
3. Fügen Sie den API-Key ein (der Levy-Support fügt ihn in Ihrem Namen als Env-Var hinzu; das ist im Dashboard aus Sicherheitsgründen nicht sichtbar).
4. Das nächste Parkfoto läuft über Captur statt Gemini.

Captur läuft asynchron — der Fahrer wartet nicht. Das Ergebnis kommt über Webhook unter /api/webhooks/captur/result und aktualisiert die parking_validations-Zeile.

Credentials erneuern oder rotieren

Wenn ein Vendor Ihren API-Key oder Signing-Secret rotiert:

1. Holen Sie die neuen Credentials vom Vendor.
2. Aktualisieren Sie den Wert unter Safety > Safety settings (Signing-Secret) und kontaktieren Sie den Levy-Support für den API-Key.
3. Verifizieren Sie, dass das nächste eingehende Ereignis weiterhin parsbar ist (Signature-Verify ist der wahrscheinlichste Fehlerpunkt).

Es gibt keine Ausfallzeit, wenn Sie es sorgfältig machen — eingehende Ereignisse mit dem alten Secret werden während des Fensters abgelehnt, in dem das neue Secret aktiv ist. Die meisten Betreiber planen Rotationen für eine schwach besuchte Stunde.

Was, wenn ein Vendor ausfällt?

Wenn die Pipeline des Vendors mehr als 5 Minuten während Hauptzeiten keine Ereignisse mehr sendet, alarmiert Sentry unser Team und wir deaktivieren die Durchsetzung für Ihre Flotte automatisch, bis Ereignisse wieder fließen. Das Dashboard zeigt ein Banner "Sidewalk detection paused — vendor outage detected", sodass Sie wissen, was passiert.

Wenn der Vendor wieder online kommt, läuft die Durchsetzung automatisch weiter. Keine Aktion Ihrerseits nötig.