Erste Schritte mit Levy Compliance

Dieser Artikel fuehrt Sie durch das Onboarding einer einzelnen Zustaendigkeit (eine Stadt). Das Endergebnis: MDS-Endpunkte sind aktiv, der Policy-Feed der Stadt wird jede Minute abgefragt, Geofences aktivieren sich planmaessig und der Stadtkontakt erhaelt taegliche/woechentliche/monatliche Digest-E-Mails.

Voraussetzungen

Bevor Sie beginnen, bestaetigen Sie Folgendes:

Schritt 1 -- Zustaendigkeit anlegen

Schritt 2 -- Bestaetigen, dass MDS-Endpunkte antworten

Jede Zustaendigkeit erbt unter Ihrem Subaccount dieselbe MDS-Endpunkt-Basis:

GET /api/mds/{subaccountId}/provider/v2/vehicles
GET /api/mds/{subaccountId}/provider/v2/vehicles/status
GET /api/mds/{subaccountId}/provider/v2/trips
GET /api/mds/{subaccountId}/provider/v2/events
GET /api/mds/{subaccountId}/provider/v2/telemetry/{vehicle_id}
GET /api/mds/{subaccountId}/provider/v2/stops
GET /api/mds/{subaccountId}/provider/v2/reports
GET /api/mds/{subaccountId}/.well-known/jwks.json

Rufen Sie vehicles/status mit Ihrem Bearer-Token zur Bestaetigung auf:

curl -H "Authorization: Bearer <YOUR_MDS_TOKEN>" \
  https://fleets.levyelectric.com/api/mds/<subaccountId>/provider/v2/vehicles/status

Eine erfolgreiche Antwort enthaelt:

• HTTP 200
• Content-Type: application/vnd.mds+json;version=2.0
• MDS-JWT-Header (signierter Beweis des Response-Body-sha256)
• Ein version-Feld mit Wert 2.0.1 im JSON-Envelope

Siehe MDS Provider-Einrichtung fuer die vollstaendige Endpunkt-Referenz.

Schritt 3 -- URLs an die Stadt uebergeben

Senden Sie dem Stadtkontakt eine kurze E-Mail mit diesen vier Angaben:

Die Populus-/Ride-Report-/Lacuna-Instanz der Stadt validiert die Endpunkte gegen den MobilityData-GBFS-Validator und den OMF-mds-provider-validator, bevor Ihre Flotte als aktiv im Stadt-Dashboard erscheint. Beide Validatoren sollten ohne Warnungen bestehen.

Schritt 4 -- Den ersten Policy-Poll beobachten

Der mds-policy-poll-Cron laeuft jede Minute. Innerhalb von 60 Sekunden nach dem Speichern der Zustaendigkeit:

1. Der Poller ruft den Policy-Feed der Stadt ab.
2. Die Rohnutzlast wird sha256-gehasht und mit dem letzten bekannten Hash verglichen.
3. Bei Aenderung parsen der Zod-Validator policies[] und geographies[].
4. Policies werden upgesertet; Regeln vollstaendig ersetzt; policy_geofences-Zeilen aus den referenzierten Geografien materialisiert.
5. Ein Eintrag landet in mds_policy_audit mit run_id, diff-JSON und applied_at.

Oeffnen Sie /dashboard/compliance/{jurisdiction-id} und Sie sollten die aktive Policy-Liste sehen. Siehe Policy-Aufnahme von Staedten fuer den Diff-Viewer.

Schritt 5 -- Stadtkontakte einrichten

Stadtkontakte erhalten Magic-Link-Zugang zum Stadt-Portal und Digest-E-Mails in der von Ihnen festgelegten Kadenz.

Schritt 6 -- Genehmigungsbedingungen definieren

Falls Ihre Genehmigung durchsetzbare Bedingungen vorgibt (Flotten-Cap, Equity-Zonen-Anteil, Beschwerde-SLA), erfassen Sie diese in permit_conditions. Der Compliance-Reporter wertet sie bei jedem Digest-Lauf aus.

Siehe Genehmigungs-Konditionsberichte fuer die Evaluator-Details.

Schritt 7 -- Den ersten Digest verifizieren

Der compliance-digest-Cron laeuft stuendlich und geht jeden city_contacts-Eintrag durch, dessen Kadenzfenster abgelaufen ist. Fuer einen heute angelegten daily-Kontakt landet die erste E-Mail innerhalb einer Stunde nach Schluss der Digest-Periode (typischerweise Mitternacht Ortszeit der Zustaendigkeit).

Wenn die E-Mail rausgeht:

• Eine Zeile wird in city_compliance_reports mit payload (gerendertes JSON) und pdf_url (falls monatliches PDF angehaengt) geschrieben.
• Das last_digest_sent_at des Kontakts wird aktualisiert.

Wenn die Stadt die E-Mail nach dem erwarteten Fenster nicht sieht, pruefen Sie zunaechst Spam, dann last_digest_sent_at in city_contacts -- wenn veraltet, hat der Cron nicht gefeuert oder der Sender hat einen Fehler erzeugt. Siehe Fehlerbehebung.

Was Sie erreicht haben

Nach den Schritten 1-7:

• Ihr Subaccount veroeffentlicht einen konformen MDS 2.0 Provider-Feed
• Ein GBFS 3.0-Feed (mit vehicle_type_id pro Zonenregel) ist parallel zum 2.x-Feed aktiv
• Der Policy-Feed der Stadt wird jede Minute abgefragt und gegen letzten bekannten Stand verglichen
• Gestapelte Geofences mit korrekter Prioritaet materialisieren sich aus staedtischen Regeln
• Der Stadtkontakt kann sich via Magic-Link am Portal anmelden
• Digest-E-Mails fliessen in der konfigurierten Kadenz
• Genehmigungs-Konditions-Pass/Fail wird taeglich berechnet und in Betreiber-Dashboard und Stadt-Portal angezeigt

Sie koennen Ihren staedtischen Genehmigungsbeauftragten jetzt auf die oeffentlichen MDS-Endpunkte und den GBFS 3.0-Stamm verweisen.

Was kommt als naechstes?

• MDS Provider-Einrichtung -- Endpunkt-Referenz und Signierdetails.
• Policy-Aufnahme von Staedten -- Diff-Viewer, Audit, Aktivierung.
• Prioritaet gestapelter Geofences -- wie staedtische Regeln Ihre Betreiberzonen ueberlagern.
• Fehlerbehebung -- wenn Polls oder Digests nicht ausgeloest werden.