FAQ

Geral

Preciso disso se minha cidade ainda nao exige MDS?

Provavelmente sim em 12 meses. Cidades tier-1 (LA, SF, Seattle, Chicago, Denver, Minneapolis, NYC) ja exigem MDS 2.0 e GBFS 3.0 em novas licencas. Cidades tier-2 estao seguindo o template de licenca do OMF, que exige o mesmo. Onboardar agora significa que seu stack esta pronto quando o RFP da cidade chegar.

O Levy Compliance substitui meu advogado de licenca?

Nao. Cuidamos da compliance tecnica -- os endpoints MDS, a ingestao de Policy, o enforcement em tempo real, o reporting. Seu advogado cuida da revisao legal, seu corretor de seguros cuida da cobertura, e voce mantem o relacionamento com a cidade. Somos explicitamente um nao-objetivo nessas frentes.

Minhas zonas de operador existentes continuarao funcionando?

Sim. Zonas de operador (estacionamento, no-parking, slow, no-go, ride zones) continuam funcionando exatamente como antes. A ingestao de Policy adiciona uma nova camada de zonas no topo, em prioridade maior. Quando as duas se sobrepoem, a cidade ganha -- mas apenas na sobreposicao; suas zonas fora da sobreposicao permanecem em vigor. Veja Prioridade de Geofences Empilhados.

Posso rodar compliance municipal para alguns mercados mas nao outros?

Sim. O flag active em mds_jurisdictions permite pausar polling para uma jurisdicao sem deleta-la. Cidades onde voce ainda nao tem licenca nao precisam de uma linha de jurisdicao. O Levy Compliance e por jurisdicao, nao por subconta.

MDS Provider

Por que voces estao em MDS 2.0.1 e nao 2.1?

MDS 2.0.1 e atual a partir do release mais recente do OMF. 2.1 esta em rascunho do working group. Acompanhamos 2.1 em um branch separado e o lancaremos quando o OMF o promover -- nesse ponto tambem publicaremos um prefixo de rota versionado para que cidades possam adotar em seu proprio ritmo.

Por que voces usam tanto tokens bearer quanto JWTs?

Bearer e a auth primaria -- e o esquema de auth MDS Provider de facto ha anos, e a maioria dos sistemas municipais ja esta configurada para ele. O JWT assinado em cada resposta e uma prova de integridade adicional para cidades que querem uma. Elas podem ignorar o JWT e usar apenas bearer, ou verificar ambos.

Com que frequencia chaves JWKS devem rotacionar?

Anualmente e a cadencia recomendada, correspondendo a orientacao do OMF. Rotacao e nao-bloqueante -- publicamos chaves ativas + de janela de carencia, entao cidades tem uma janela de 7 dias para atualizar seu cache JWKS. Veja Gerenciamento de Chaves JWKS.

O Cloudflare proxia esses endpoints?

Sim. Todos os endpoints MDS publicos ficam atras da camada Cloudflare existente para mitigacao DDOS e bot. Limites de rate de token bearer a 60 req/min se aplicam alem.

GBFS

Tenho que migrar consumidores de 2.x para 3.0?

Nao. Ambos os feeds publicam em paralelo. Consumidores 2.x existentes continuam sem mudanca. Cidades solicitando 3.0 sao apontadas para a URL /v3/.

O GBFS 3.0 quebrara meu app movel?

O app movel do cliente le GBFS 3.0 por padrao. Se voce mantem um consumidor terceiro que esta em 2.x, deixe-o em 2.x -- o feed legado nao vai sumir. A spec GBFS em si suporta coexistencia multi-versao via manifest.json.

De onde vem vehicle_type_id?

vehicle_models.gbfs_type_id. Defina por modelo em Configuracoes -> Modelos de Veiculos. Se nao definido, o veiculo e omitido de vehicle_status.json -- visivel apenas como um agregado em system_information.json.

Ingestao de Policy

Com que frequencia o feed da cidade e consultado?

A cada 60 segundos por padrao. Cada mds_jurisdictions.poll_interval_s pode sobrescrever -- minimo 30 segundos, maximo 600. Usamos atalho sha256 em payloads byte-identicos, entao polling de regime estavel e essencialmente gratis.

E se o feed da cidade fica offline?

As ultimas politicas ingeridas com sucesso permanecem em vigor. Apos 3 polls consecutivos falhados (3 minutos de downtime), alertamos via Sentry + Slack. O estado anterior nunca e revertido; esperamos ate o feed voltar e podermos reingerir de forma limpa.

Posso editar as politicas importadas de uma cidade?

Nao -- a UI do operador nao expoe acoes de escrita em mds_policies ou policy_geofences. Essas linhas pertencem ao feed de politica da cidade. Para muda-las, a cidade atualiza seu feed; reingerimos no proximo poll.

E se a cidade publica uma politica retroativa?

Aplicamos no momento da ingestao (agora), logamos um aviso late_activation no audit e nunca retrodatamos eventos de enforcement. Se a politica da cidade afirma start_date = 2026-01-01 e ingerimos em 2026-05-18, o enforcement comeca 2026-05-18 -- nao fingimos ter aplicado para os meses anteriores.

E se duas cidades se sobrepoem?

Operador na fronteira SF/Oakland, por exemplo. Cada mds_jurisdictions.geometry define uma fronteira; um veiculo na sobreposicao herda as regras de ambas as jurisdicoes, resolvidas via escada de prioridade. Na pratica os niveis municipais sao os mesmos (nivel 1000), entao a mais restrita das duas regras ganha.

Enforcement em tempo real

Qual e o alvo de latencia?

<10s p95 da ativacao da politica ao primeiro comando IoT enviado. OKAI ~3-5s, Omni ~5-8s, Queclink ~5-8s, ZIMO depende do broker MQTT, Segway BLE-relay pode picar a 30s+. Documentamos a lacuna do Segway com cidades adiantadamente.

Enforcement funciona em veiculos offline?

Nao. O skip de GPS velho de 5 minutos e por design. Quando o veiculo acorda e envia um GPS fresco, o motor de cruzamento de zona existente pega o policy geofence e despacha o comando. Nenhum comando e perdido -- so chega quando o veiculo esta alcancavel.

Pilotos serao notificados?

Sim. Notificacoes push no app disparam quando um piloto entra em uma slow zone municipal ou zona no-ride. A mensagem inclui um prefixo "Cidade" para que pilotos distinguam zonas de operador de politica municipal. Veja Aplicacao de Velocidade em Tempo Real.

Posso sobrepor enforcement para um unico veiculo?

Sim -- Detalhe do veiculo -> Acoes de compliance -> Definir limite de velocidade emite um setSpeedLimit() diretamente, logado com action = 'manual_override' e nota de razao. O override expira no proximo evento de cruzamento de zona.

Portal da cidade

Cidades podem editar qualquer coisa?

Nao. O portal e somente leitura. Cidades editam seu proprio feed de politica; reingerimos. O portal existe para que cidades possam ver sua frota, viagens, corredores e score de compliance em tempo real.

Como adiciono um segundo contato para a mesma jurisdicao?

Dashboard do operador -> Compliance -> Detalhe da jurisdicao -> Contatos municipais -> Adicionar. Cada contato recebe auth de magic link independente e cadencia de digest independente.

Posso revogar acesso no meio de uma sessao?

Sim. Defina portal_access = false na linha do contato. Cookies de sessao ativos se tornam invalidos imediatamente; o contato e deslogado na proxima requisicao.

O portal esta disponivel em idiomas nao-ingleses?

en e es no lancamento. Locales adicionais voltam para ingles. O campo locale do contato em city_contacts controla tanto o idioma do portal quanto o idioma do e-mail de digest.

Digests + relatorios

Qual e a diferenca entre um digest e uma chamada da API de compliance-report?

Um digest e o e-mail proativo que o Levy envia em cadencia. A API de compliance-report e um endpoint pull que cidades chamam quando precisam de um relatorio ad-hoc. Ambos renderizam da mesma forma buildComplianceReport().

Por quanto tempo relatorios sao retidos?

city_compliance_reports e retido indefinidamente. Esta e a trilha de auditoria da cidade; nao fazemos garbage collection.

Posso gerar um relatorio customizado?

Formatos de relatorio customizados (exports CSV alem do trip report embutido, deep-dives de zona de equidade, etc.) estao no roadmap. Hoje os formatos embutidos cobrem os formatos municipais mais pedidos. Para casos one-off, consulte as tabelas subjacentes diretamente via a Partner API.

Precificacao + empacotamento

Isso esta incluido no meu plano?

Incluido no tier Enterprise se voce tem pelo menos uma jurisdicao ativa. Para Pro e abaixo, e um add-on de $200/mes por jurisdicao mais uma taxa unica de $500 de onboarding por nova cidade.

Cidades pagam algo?

Nao. O feed MDS Provider, o feed GBFS 3.0, o portal da cidade e e-mails de digest sao gratuitos para a cidade. Esta e infraestrutura de elegibilidade-de-licenca, nao receita.

E as taxas de Ride Report Certified?

Se voce opta por status Ride Report Certified, essa taxa e repassada a voce ao custo (varia conforme o tier de preco do Ride Report). Nao colocamos margem.

Ride Report Certified

O que e Ride Report Certified?

O programa do Ride Report que audita o stack de compliance de um operador contra uma checklist (correcao de endpoint, SLOs de latencia, prova de tratamento de reclamacoes) e emite um badge certificado. Varios RFPs municipais agora referenciam esse badge como um qualificador de licenca.

Quando posso me inscrever?

Apos as Fases 1+2 (MDS Provider + GBFS 3.0) estarem ao vivo e validadas. A auditoria cobre endpoints, latencia e fidelidade de reporting. O Levy fornece a evidencia tecnica; voce lida com a aplicacao.

Voces garantem a certificacao?

Nao -- a certificacao e entre voce e o Ride Report. Garantimos que o stack subjacente esta conformante e que corrigiremos quaisquer lacunas expostas durante a auditoria. Na pratica, operadores na build mais recente do Levy Compliance passam.

Algo mais?

Envie e-mail para support@levyelectric.com ou sua equipe de conta. Para perguntas tecnicas do lado da cidade, cidades podem enviar e-mail para o mesmo endereco -- tratamos suporte municipal como primeira classe.