Solucao de Problemas do Levy Vision
Este artigo e sua primeira parada quando algo parece errado. Os diagnosticos abaixo cobrem os problemas mais comuns entre capacete, estacionamento e deteccao de calcada. Se nada aqui resolver, contate o suporte com os IDs de evento relevantes.
Selfie de capacete nunca aparece para pilotos
O piloto toca em Unlock, mas nenhuma tela de selfie aparece.
Verifique o interruptor de subaccount
- Abra Dashboard > Safety > Safety settings.
- Confirme que voce esta no subaccount correto no seletor.
- Verifique que Helmet check enabled esta ativado. Salve se voce mudou.
Verifique o bypass AXA
Se o veiculo tem um cadeado de capacete AXA e o piloto acabou de destravar o capacete (em 60 segundos), o bypass pula o selfie automaticamente. Procure por um evento com status='bypassed' em Safety > Events. Se voce ve um, o sistema esta funcionando como projetado.
Verifique a versao do app do piloto
A tela de selfie de capacete entra na versao do app de piloto 1.8.0 em diante. Se o piloto esta em uma versao mais antiga, peca para atualizar. A App Store normalmente tem a versao mais recente em um dia apos o lancamento.
Verifique o toggle de consentimento IL
Se o endereco de cobranca do piloto e Illinois e ele nao aceitou o toggle de consentimento BIPA nas configuracoes da conta, o fluxo de selfie e pulado. Peca a ele para abrir o app de piloto, ir para Profile > Privacy e aceitar o toggle.
Selfie de capacete aparece mas sempre falha
O piloto tira um selfie limpo usando capacete, mas o resultado e sempre fail.
Verifique a confianca
Abra Safety > Events, encontre o evento falho, clique na linha. Olhe a string de raciocinio de inferencia. Problemas comuns:
- "low_light" — o piloto esta em condicoes escuras. Precisa se mover para luz melhor.
- "face_occluded" — o capacete esta muito baixo na testa. Comum com capacetes integrais.
- "headwear_not_helmet" — o modelo acha que e um chapeu. Alguns capacetes urbanos parecem chapeus para o modelo.
Para o ultimo caso, marque o evento como falso positivo. O modelo aprende com essas marcacoes ao longo do tempo.
Tente strict mode desligado
Se voce tem Strict mode ligado e o piloto nao consegue passar da tela, temporariamente desligue o strict (Safety > Safety settings), peca ao piloto para tentar de novo, depois religue o strict. Com strict desligado, um evento ambiguous ainda inicia a viagem, o que desbloqueia o piloto enquanto voce depura.
Verifique o status do Gemini
Se muitos pilotos em muitas frotas estao falhando, nosso provedor Gemini pode estar fora. Verifique o Sentry para erros helmet_classifier_inference_failed. Se voce ve um pico, o fail-open esta ligado (eventos inference_failed ainda iniciam a viagem), entao pilotos nao deveriam estar bloqueados.
Resultados de pose de estacionamento nunca aparecem
O piloto tira a foto de fim de viagem, mas nenhuma linha aparece em Safety > Parking reviews ou Safety > Events.
Verifique o interruptor de subaccount
Em Safety > Safety settings, confirme que Parking validation enabled esta ligado. Desligado significa que a foto e coletada mas nao avaliada.
Aguarde alguns segundos
O classificador pode levar ate 5 segundos no Gemini e mais no Captur (async). De a ele um minuto, depois atualize.
Verifique a foto
Se a foto esta corrompida (queda de rede no meio do upload), nenhuma inferencia roda. Veja no detalhe da viagem pela foto de estacionamento. Se esta faltando ou quebrada, o piloto deve refazer — ha uma opcao "Retake parking photo" no app dele para a viagem mais recente.
Verifique o storage bucket
O bucket cv-evidence precisa existir com acesso privado e leituras por URL assinada. Se foi deletado ou suas politicas foram mudadas, a classificacao falha silenciosamente. Contate o suporte se voce suspeitar disso.
Nenhum evento de calcada esta fluindo
Voce instalou hardware de fornecedor, provisionou dispositivos e esperou que eventos aparecessem — mas Safety > Events nao tem linhas sidewalk_entry.
Este e o problema mais comum. Resolva em ordem:
Confirme que o dispositivo esta mapeado
Abra Safety > Vendor devices. O serial do dispositivo deve estar na lista e ligado a um veiculo real. Se esta faltando, o webhook dispara mas nao conseguimos atribuir.
Confirme que a aplicacao esta ligada
Em Safety > Safety settings, verifique que Sidewalk detection enabled esta ligado. Com ele desligado, eventos ainda sao registrados mas o painel os esconde por padrao. Use o filtro "Show all event types" na pagina de eventos para verificar.
Confirme que o webhook chega a nos
No painel do fornecedor, encontre o "webhook delivery log" ou equivalente. Procure por tentativas de entrega para nossa URL. Devem ser 200 OK. Se sao 401, a assinatura esta errada — verifique o Webhook signing secret nas configuracoes de seguranca.
Se estao com timeout (504), nosso endpoint pode estar lento sob carga. O Sentry tera capturado; contate o suporte.
Confirme o schema de assinatura
Drover usa t=<ts>,v1=<hex> HMAC-SHA256. Luna usa hex plano HMAC-SHA256. Se o fornecedor esta assinando com um schema diferente (alguns tem endpoints mais antigos), rejeitaremos. Peca ao fornecedor para confirmar o schema.
Confirme que ha uma viagem
Atribuimos eventos de calcada a viagem atual do veiculo. Se o veiculo esta ocioso (sem viagem ativa), o evento e registrado mas nao aplicado, e pode nao aparecer na UI do piloto. Verifique Safety > Events com o filtro "vehicle: idle" ligado.
Corte de aceleracao nao disparou
Voce esperava que um veiculo fosse cortado apos o limiar mas o piloto continuou andando.
Verifique a contagem de limiar
Abra a viagem. Conte os eventos de calcada. Se o piloto teve 2 eventos e seu Cut threshold e 3, nenhum corte deve disparar. Confirme limiares nas configuracoes de seguranca.
Verifique o interruptor principal de throttle cut
Throttle cut enabled e um interruptor principal separado do limiar. Se estiver desligado, nenhum corte dispara independente do limiar.
Verifique o protocolo
Alguns protocolos IoT nao suportam desativacao de aceleracao no meio da viagem. Olhe o iot_type do veiculo. Se e acton-legacy, throttle cut nao e suportado — so warn dispara. Veja a matriz de compatibilidade de OEM em Politica de corte de aceleracao.
Verifique o log de comandos IoT
Abra o detalhe da viagem. A secao "IoT commands" deve mostrar uma tentativa de disable_throttle com motivo cv_sidewalk_repeated. Se esta faltando, a engine de politicas nao disparou — verifique o feed de eventos para uma linha cv_violation_actions.
Se o comando foi tentado mas falhou (queued + timed out), o veiculo estava offline. A engine de politicas tenta novamente por 60 segundos, depois desiste.
Aceleracao nao restaura
Um piloto foi cortado e agora nao consegue obter a aceleracao de volta mesmo apos tocar em I'm back on the road.
Verifique a telemetria
O endpoint de restore exige 30 segundos de telemetria limpa (nenhum evento de calcada). Se o piloto ainda esta em uma calcada de acordo com o fornecedor, o restore e negado. Olhe o feed de eventos para a viagem.
Verifique o caminho IoT
Se o veiculo esta offline, o comando enable nao pode alcanca-lo. Aguarde o veiculo reportar de volta, depois peca ao piloto para tentar de novo.
Restore manual
Se voce precisa sobrepor, abra o evento em Safety > Events e clique em Restore throttle. O painel emite enableVehicleThrottle() diretamente, ignorando a verificacao de telemetria.
Latencia parece lenta
Pilotos reclamam que selfie de capacete ou validacao de estacionamento demora muito.
Verifique o grafico de latencia
A pagina Safety > Overview tem latencia p50 e p95 para cada capacidade. Meta da especificacao:
- Capacete: 2s p50, 4s p95
- Estacionamento (Gemini): 3s p50, 6s p95
- Estacionamento (Captur): async, sem espera do piloto
Se voce esta consistentemente acima desses numeros, contate o suporte.
Verifique a rede celular do piloto
A maioria dos relatos de "inferencia lenta" sao uploads lentos. O classificador em si leva 1–2 segundos; o resto e upload de imagem e round-trip de rede. Pilotos em conexoes ruins veem o atraso.
Falsos positivos estao muito altos
Pilotos estao sendo cortados ou multados quando nao deveriam.
Use Flag false positive
Cada falso positivo deve ser marcado na linha do evento. Isso alimenta a pipeline de melhoria do modelo. Nao pule esse passo.
Aumente os limiares
Nas configuracoes de seguranca, aumente os limiares warn / speed-reduce / cut em um. O modelo nao esta mudando, mas a engine de politicas fica menos agressiva.
Adicione lista de permissao de geocerca
Calcadas que nao sao realmente calcadas (ciclovias protegidas, pracas) — adicione um poligono kind=allow em Sidewalk hotspots.
Escale para o suporte
Se sua taxa de falsos positivos esta acima de 5% apos uma semana de ajuste, isso e um sinal de que o modelo esta mal calibrado para sua geografia ou mix de veiculos. Diga ao suporte — podemos ajustar pisos de confianca por subaccount.
Ainda travado?
Abra um ticket de suporte do centro de ajuda ou envie email para support@levyelectric.com. Inclua:
- ID do subaccount
- Um ID de evento especifico (do feed de eventos)
- O que voce esperava vs o que aconteceu
- Intervalo de tempo do problema