Visao Geral do Levy Compliance
O Levy Compliance e a ponte entre sua frota e os reguladores municipais que concedem sua licenca de operacao. Ele implementa as APIs Mobility Data Specification (MDS) 2.0 Provider e Policy, publica um feed GBFS 3.0 ao lado do feed 2.x legado, ingere o feed de politica de cada cidade, materializa os geofences resultantes com a prioridade correta e despacha comandos de limite de velocidade especificos por OEM para seus veiculos em segundos apos uma regra ser ativada.
Para quem isso e
Operadores que mantem (ou estao solicitando) uma licenca municipal. Cidades cada vez mais exigem conformidade MDS 2.0 Provider, um feed GBFS 3.0 e aplicacao em tempo real demonstravel de regras de Policy. O Levy Compliance lida com as tres saindo da caixa.
O que vem incluido
| Capacidade | O que faz |
|---|---|
| MDS 2.0 Provider API | Endpoints assinados em /api/mds/{subaccountId}/provider/v2/* cobrindo vehicles, status, trips, events, telemetry, stops e reports. Assinatura JWT (RS256), publicacao JWKS, paginacao por cursor, cache de borda. |
| Feed GBFS 3.0 | Feed publico em /api/gbfs/v3/{subaccountId}/* com manifest.json, system_regions.json, vehicle_status.json e geofencing_zones.json (com vehicle_type_id por regra). |
| Ingestao de politica | Cron de polling a cada minuto com diff horario que puxa o feed de politica de cada jurisdicao, valida com Zod, atalha em sha256 inalterado e prepara regras para ativacao. |
| Geofences empilhados | Uma escada de prioridade de 6 niveis unifica zonas de politica municipal, zonas do operador e padroes do sistema, de modo que a regra mais restrita ganha em cada ponto do mapa. |
| Aplicacao em tempo real | Quando uma regra de Policy ativa, veiculos dentro da geometria recebem um comando de limite de velocidade especifico do OEM (OKAI •••••sign in, Segway •••••sign in, Omni •••••sign in, Queclink •••••sign in, parametro MQTT ZIMO) marcado com uma chave de idempotencia sha256. |
| Portal da cidade | Login por magic link em /city/{slug} para contatos municipais. Limitado a geometria da jurisdicao -- eles veem apenas frota, viagens e estacionamentos dentro de sua fronteira. |
| E-mails de digest | Cron horario que emite digests de conformidade diarios, semanais ou mensais para cada linha de city_contacts cuja janela de cadencia expirou. |
| Dashboard do operador | /dashboard/compliance com indice de jurisdicoes, visualizador de diff de politica, log de auditoria, eventos de aplicacao e o banner de alerta de override/conflito. |
O loop de conformidade
+---------------------------+
| CMS de politica municipal |
| (Populus, Lacuna, custom) |
+-------------+-------------+
| polling a cada 60s
v
+---------------------------+----------------------------+
| Levy Compliance Service |
| |
| parse + validacao (Zod) |
| | |
| v |
| atalho sha256 -- inalterado? sair |
| | |
| v |
| upsert mds_policies / mds_policy_rules |
| | |
| v |
| materializar policy_geofences (PostGIS) |
| | |
| v |
| em start_date: disparar comandos por OEM |
| | |
| v |
| registrar em policy_enforcement_events |
+---------------------------+----------------------------+
|
+-------------+-------------+
v v
[Veiculos via IoT proxy] [GBFS 3.0 + MDS Provider]
Como isso difere das zonas do operador
Zonas do operador (estacionamento, no-go, slow, ride zones) continuam funcionando como antes. O Levy Compliance adiciona uma segunda camada de zonas -- geofences de politica -- importados de um feed de politica municipal e marcados com uma prioridade maior do que qualquer coisa que voce crie a mao. Quando os dois se sobrepoem, a regra municipal ganha.
Voce vera isso em dois lugares:
- Banner de conflito em
/dashboard/compliance-- mostra cada zona do operador atualmente sombreada por uma politica municipal. - Log de auditoria em cada pagina de jurisdicao -- cada execucao de ingestao e registrada com um diff JSON, para que voce possa ver exatamente quais regras foram adicionadas, removidas ou modificadas entre polls.
Narrativa de vendas -- "Levy cuida da sua licenca"
A historia operacional que contamos as cidades (e na qual voce pode se apoiar em pedidos de licenca):
- Operador envia pedido de licenca. Entregamos as URLs de endpoint MDS, a URL JWKS e a raiz GBFS 3.0.
- Cidade aprova a licenca. Voce configura a jurisdicao em
/dashboard/compliance/newcom a URL do feed de politica da cidade. - Em minutos, geofences estao ativos. O poller de politica puxa o feed, valida e materializa os geofences.
- Aplicacao em tempo real e ativada por padrao. Veiculos dentro de uma slow zone recebem o comando de limite de velocidade em menos de 10 segundos (meta p95).
- E-mails de digest fluem para a cidade. Relatorios de conformidade diarios/semanais/mensais chegam automaticamente na caixa do contato municipal.
Nao-objetivos
O Levy Compliance e a implementacao do lado do operador. Nao e:
- Uma plataforma de analise do lado da cidade -- cidades continuam usando Populus, Ride Report, Lacuna ou seu proprio dashboard para isso.
- A API MDS Agency -- essa e responsabilidade da cidade, nao do operador.
- Substituto para seu advogado de licenca ou corretor de seguros.
- Uma UI de autoria de politica municipal -- cidades criam politicas em suas proprias ferramentas e publicam via feed de politica.
Proximos passos
- Comecando -- onboard uma nova jurisdicao de ponta a ponta.
- Configuracao do MDS Provider -- URLs de endpoint, JWKS e configuracao de validador.
- Ingestao de Politica de Cidades -- visualizador de diff, auditoria e fluxo de ativacao.
- Aplicacao de Velocidade em Tempo Real -- caminho de comando IoT por OEM e o skip de GPS velho.
Precisa de ajuda com uma cidade especifica?
Onboardamos operadores em Long Beach, Boulder e Minneapolis como mercados de lancamento. Se sua cidade usa Populus, Ride Report ou Lacuna, a integracao e plug-and-play. Para feeds personalizados, contate support@levyelectric.com e adicionaremos o ramo de parser.