City Compliance & MDS

MDS 2.0, GBFS 3.0, city policy ingestion, and real-time geofence enforcement

13 Articles

City Portal & Magic-Link Auth

The /city/{slug} portal that city contacts log into via emailed magic link — bounded by the jurisdiction's geometry, read-only, with a 24h HMAC-signed session cookie.

10 min read
intermediate

Digest Emails & Cadence

How the hourly compliance-digest cron walks city_contacts, picks who is due, builds the email payload, and updates last_digest_sent_at.

10 min read
intermediate

FAQ

Common questions about MDS 2.0, GBFS 3.0, Policy ingestion, real-time enforcement, the city portal, pricing, and Ride Report certification.

11 min read
intermediate

GBFS 3.0 Feeds

The v3 GBFS feed at /api/gbfs/v3/{subaccountId}/* — what's new vs 2.x, how it coexists with the legacy feed, and the geofencing_zones.json with policy geofences merged in.

12 min read
advanced

Getting Started with Levy Compliance

End-to-end onboarding for a new city jurisdiction — from permit award to first compliance digest emailed to the city.

14 min read
intermediate

JWKS Key Management

Per-subaccount RS256 keypairs, kid rotation, grace windows, and where private keys are stored.

9 min read
advanced

MDS 2.0 Provider Setup

Full reference for the MDS 2.0 Provider endpoints, JWT signing, JWKS discovery, cursor pagination, and validator configuration.

18 min read
advanced

Levy Compliance Overview

What Levy Compliance does, how MDS 2.0 Provider, GBFS 3.0, city Policy ingestion, and real-time enforcement fit together for permitted operators.

12 min read
intermediate

Permit-Condition Reports

How permit_conditions rows drive the daily compliance scoreboard — fleet cap, equity-zone deployment, complaint SLA, EOD trip report, and corral utilization.

13 min read
intermediate

Policy Ingestion from Cities

How Levy pulls each city's published Policy feed, validates it with Zod, short-circuits on unchanged sha256, materializes geofences, and surfaces the diff + audit + activation flow.

16 min read
advanced

Real-Time Speed Enforcement

The per-OEM IoT command path, sha256 idempotency, the <5min stale-GPS skip, and what happens when a city policy activates over a fleet already on the road.

14 min read
advanced

Stacked Geofence Priority

The 6-tier priority ladder that orders city policy zones, operator zones, and system defaults — and how PostGIS returns the strictest rule at each point.

12 min read
advanced

Troubleshooting

When MDS endpoints, Policy ingestion, enforcement, the city portal, or digest emails misbehave — the canonical checklist.

14 min read
advanced