intermediate
MDS
GBFS
Compliance

Levy Compliance Uebersicht

Was Levy Compliance leistet und wie MDS 2.0 Provider, GBFS 3.0, staedtische Policy-Aufnahme und Echtzeit-Durchsetzung fuer lizenzierte Betreiber zusammenspielen.

Levy Fleets TeamMay 18, 202612 min read

Levy Compliance Uebersicht

Levy Compliance ist die Bruecke zwischen Ihrer Flotte und den staedtischen Regulierungsbehoerden, die Ihre Betriebsgenehmigung erteilen. Es implementiert die Mobility Data Specification (MDS) 2.0 Provider- und Policy-APIs, veroeffentlicht einen GBFS 3.0-Feed parallel zum bestehenden 2.x-Feed, nimmt den Policy-Feed jeder Stadt auf, materialisiert die resultierenden Geofences mit korrekter Prioritaet und sendet OEM-spezifische Geschwindigkeitsbegrenzungs-Befehle an Ihre Fahrzeuge innerhalb von Sekunden nach Regelaktivierung.

Fuer wen ist das gedacht?

Betreiber, die eine Stadtgenehmigung haben (oder beantragen). Staedte verlangen zunehmend MDS 2.0 Provider-Konformitaet, einen GBFS 3.0-Feed und nachweisbare Echtzeit-Durchsetzung von Policy-Regeln. Levy Compliance erfuellt alle drei direkt nach Einrichtung.

Was enthalten ist

FunktionBeschreibung
MDS 2.0 Provider-APISignierte Endpunkte unter /api/mds/{subaccountId}/provider/v2/* fuer Fahrzeuge, Status, Fahrten, Ereignisse, Telemetrie, Stopps und Berichte. JWT-Signierung (RS256), JWKS-Veroeffentlichung, Cursor-Paginierung, Edge-Cache.
GBFS 3.0-FeedOeffentlicher Feed unter /api/gbfs/v3/{subaccountId}/* mit manifest.json, system_regions.json, vehicle_status.json und geofencing_zones.json (mit vehicle_type_id pro Regel).
Policy-AufnahmeStuendliche Diff- + Polling-Cron-Jobs jede Minute, die den Policy-Feed jeder Stadt abrufen, mit Zod validieren, bei unveraendertem sha256 abkuerzen und Regeln zur Aktivierung vorbereiten.
Gestapelte GeofencesEine 6-stufige Prioritaetsleiter vereint staedtische Policy-Zonen, Betreiberzonen und Systemstandards, sodass die strengste Regel an jedem Kartenpunkt gewinnt.
Echtzeit-DurchsetzungWenn eine Policy-Regel aktiv wird, erhalten Fahrzeuge im Polygon einen OEM-spezifischen Befehl (OKAI •••••sign in, Segway •••••sign in, Omni •••••sign in, Queclink •••••sign in, ZIMO MQTT-Parameter), markiert mit einem sha256-Idempotenzschluessel.
Stadt-PortalMagic-Link-Login unter /city/{slug} fuer Stadtkontakte. Auf die Geometrie der Zustaendigkeit begrenzt -- sie sehen nur Flotte, Fahrten und Stellplaetze innerhalb ihrer Grenze.
Digest-E-MailsStuendlicher Cron, der taegliche, woechentliche oder monatliche Compliance-Digests an jeden city_contacts-Eintrag sendet, dessen Kadenzfenster abgelaufen ist.
Betreiber-Dashboard/dashboard/compliance mit Zustaendigkeitsindex, Policy-Diff-Viewer, Audit-Log, Durchsetzungsereignissen und dem Override-/Konflikt-Hinweisbanner.

Der Compliance-Kreislauf

              +---------------------------+
              | City Policy CMS (Populus, |
              | Lacuna, eigener Feed)     |
              +-------------+-------------+
                            | Polling alle 60s
                            v
+---------------------------+----------------------------+
|                Levy Compliance Service                 |
|                                                        |
|   parsen + validieren (Zod)                            |
|        |                                               |
|        v                                               |
|   sha256-Kurzschluss -- unveraendert? Ende             |
|        |                                               |
|        v                                               |
|   Upsert mds_policies / mds_policy_rules               |
|        |                                               |
|        v                                               |
|   policy_geofences materialisieren (PostGIS)           |
|        |                                               |
|        v                                               |
|   bei start_date: OEM-Geschwindigkeitsbefehle fan-out  |
|        |                                               |
|        v                                               |
|   in policy_enforcement_events protokollieren          |
+---------------------------+----------------------------+
                            |
              +-------------+-------------+
              v                           v
     [Fahrzeuge via IoT-Proxy]   [GBFS 3.0 + MDS Provider]

Wie unterscheidet sich das von Betreiberzonen?

Betreiberzonen (Parken, No-Go, Slow, Ride-Zonen) funktionieren weiterhin so wie zuvor. Levy Compliance fuegt eine zweite Zonenebene hinzu -- Policy-Geofences, die aus einem staedtischen Policy-Feed importiert und mit einer hoeheren Prioritaet als selbst erstellte Zonen versehen werden. Wenn sich beide ueberlappen, gewinnt die staedtische Regel.

Sie sehen das an zwei Stellen:

  1. Konflikt-Banner auf /dashboard/compliance -- zeigt jede Betreiberzone an, die derzeit von einer staedtischen Policy ueberdeckt wird.
  2. Audit-Log auf jeder Zustaendigkeitsseite -- jeder Aufnahmevorgang wird mit einem JSON-Diff erfasst, sodass Sie genau sehen, welche Regeln zwischen Polls hinzugefuegt, entfernt oder geaendert wurden.

Verkaufsargument -- "Levy uebernimmt Ihre Genehmigung"

Die Operationsgeschichte, die wir Staedten erzaehlen (und auf die Sie sich in Genehmigungsantraegen stuetzen koennen):

  1. Betreiber reicht Genehmigungsantrag ein. Wir liefern Ihnen die MDS-Endpunkt-URLs, die JWKS-URL und den GBFS 3.0-Stamm.
  2. Stadt genehmigt die Genehmigung. Sie konfigurieren die Zustaendigkeit unter /dashboard/compliance/new mit der Policy-Feed-URL der Stadt.
  3. Innerhalb von Minuten sind Geofences aktiv. Der Policy-Poller ruft den Feed ab, validiert ihn und materialisiert die Geofences.
  4. Echtzeit-Durchsetzung ist standardmaessig aktiv. Fahrzeuge in einer Slow-Zone erhalten den Geschwindigkeitsbefehl in unter 10 Sekunden (Ziel p95).
  5. Digest-E-Mails fliessen an die Stadt. Taegliche/woechentliche/monatliche Compliance-Berichte landen automatisch im Postfach des Stadtkontakts.

Nicht-Ziele

Levy Compliance ist die betreiberseitige Implementierung. Es ist nicht:

  • Eine staedtische Analyseplattform -- Staedte nutzen weiterhin Populus, Ride Report, Lacuna oder ihr eigenes Dashboard.
  • Die MDS Agency-API -- das ist Aufgabe der Stadt, nicht des Betreibers.
  • Ein Ersatz fuer Ihren Genehmigungsanwalt oder Versicherungsmakler.
  • Eine staedtische Policy-Erstellungs-UI -- Staedte erstellen Policies in eigenen Tools und veroeffentlichen sie via Policy-Feed.

Was kommt als naechstes?

Hilfe fuer eine bestimmte Stadt benoetigt?

Wir haben Betreiber in Long Beach, Boulder und Minneapolis als Launch-Maerkte angebunden. Wenn Ihre Stadt Populus, Ride Report oder Lacuna nutzt, ist die Integration sofort einsatzbereit. Bei Eigenbau-Feeds wenden Sie sich an support@levyelectric.com, und wir ergaenzen den Parser-Zweig.