Politica de Corte de Aceleracao

Quando a deteccao de calcada dispara, o Levy Vision usa uma escada de politicas configuravel para decidir qual aplicacao executar: avisar o piloto, reduzir a velocidade maxima ou cortar a aceleracao por completo. Este artigo explica como a escada funciona, como a restauracao e protegida e como ajustar para sua frota.

A escada roda contra o mesmo caminho de comando IoT disableVehicleThrottle() e enableVehicleThrottle() que voce ja usa em outros lugares da plataforma — nao ha nova superficie de controle de aceleracao, apenas um novo chamador.

A escada padrao

Fora da caixa, a politica executa esses passos nesta ordem dentro de uma unica viagem:

Cada passo e controlado por um limiar por subaccount em Safety > Safety settings. Diminua os limiares para frotas mais rigorosas, aumente para aquelas com cidades mais frouxas ou geografias de falsos positivos conhecidos.

Quando a escada pula um passo

Nem todo protocolo IoT suporta todo passo. A engine de politicas le o protocolo do veiculo do banco de dados e pula passos nao suportados:

• Sem suporte a speed-cap (Queclink, Zimo, Acton legacy) — passo speed_reduce e pulado, o piloto vai direto de warn para cut no proximo evento de calcada
• Sem suporte a throttle-cut — so warn dispara, sem aplicacao
• Veiculo inalcancavel (IoT offline) — a politica registra uma acao queued que tenta novamente quando o veiculo se reporta, por ate 60 segundos; depois, a acao e registrada como falhou

Cada passo que dispara escreve uma linha em cv_violation_actions para que voce tenha uma trilha de auditoria do que foi tentado e se teve sucesso.

Configurando a escada

Abra Dashboard > Safety > Safety settings e encontre a secao Sidewalk detection.

Controles de limiar

Voce tambem pode definir limiares para 0 para desativar um passo especifico sem reordenar a escada — util se voce quer apenas speed-reduce sem cut.

Por viagem vs. cumulativo

Limiares sao por viagem. Eles resetam para zero no inicio de cada nova viagem, mesmo para pilotos reincidentes. Se voce quer um acumulador multi-viagem (por exemplo, "5 eventos em um mes dispara uma revisao manual"), isso e um uso separado do feed Safety > Events mais seu CRM ou painel de operador — nao ha caminho de ban cumulativo embutido hoje.

Como funciona a restauracao da aceleracao

Quando um piloto e cortado, ele ve a Throttle restore screen:

• Uma contagem regressiva de 30 segundos
• Um mapa pequeno mostrando sua posicao
• Botao "I'm back on the road" (desativado ate a contagem acabar)

O fluxo:

1. Contagem regressiva termina. O botao ativa.
2. Piloto toca em I'm back on the road.
3. O app faz POST para /api/mobile/cv/restore-throttle-request com o ID da viagem.
4. O servidor verifica 30 segundos de telemetria limpa (nenhum evento de calcada na janela).
5. Se limpo: enableVehicleThrottle() e chamado, aceleracao retorna, modal fecha.
6. Se nao limpo: o piloto ve "Still on a sidewalk — try again in 30s" e a contagem regressiva reinicia.

Esta protecao existe para impedir que um piloto retome imediatamente o uso de calcada apos um corte.

Restauracao manual pelo operador

As vezes voce precisa sobrepor — o corte foi um falso positivo, o piloto esta preso, o modelo do fornecedor errou. Dois caminhos:

Pelo painel

1. Abra Safety > Events ou Safety > Helmet compliance (feed de eventos).
2. Encontre a linha do evento de throttle_cut.
3. Clique em Restore throttle no menu de acao.
4. O comando IoT dispara; a aceleracao do piloto retorna em alguns segundos.

A sobreposicao e registrada em cv_violation_actions com action='throttle_restore' e seu usuario como ator.

Pelo app do operador

O app de operador de tecnico de campo tem uma tela Safety events com um botao de um toque Restore throttle em cada linha de corte. Mesmo efeito do caminho do painel; util para tecnicos em campo.

Taxa de fim de viagem

Se voce define Fee per event para um valor diferente de zero, cada evento de calcada durante a viagem adiciona esse valor a tarifa final da viagem. Como com pose de estacionamento, a taxa flui pelo registro da viagem (nao diretamente para a carteira), entao net-deposited e a matematica de partner-payout permanecem corretas.

Se um piloto contesta uma taxa de calcada, trate da mesma forma que qualquer outra disputa de tarifa: abra a viagem, clique em Adjust fare e reduza o total. O credito da carteira (se houver) flui automaticamente.

Notas de privacidade

O modelo do fornecedor roda inteiramente no veiculo. O Levy Vision recebe apenas eventos normalizados (timestamp, lat/lng, confianca, ID do evento do fornecedor) — nunca video, nunca quadros brutos. Nao ha streaming de video ao vivo para o operador nesta plataforma.

Feeds de conformidade municipal agregam lat/lng do evento e timestamps; a identidade do piloto e removida antes da exportacao MDS sair do sistema. Veja Exportacao MDS para cidades para o schema de exportacao.

Perguntas comuns

Posso desativar a aplicacao em um veiculo especifico?

Nao via interruptor por veiculo. O caminho recomendado e um poligono de lista de permissao de geocerca sobre o territorio desse veiculo, ou um limiar amplo de frota de 0 para o passo de corte. Se voce tem um caso de um veiculo, contate o suporte.

E se o corte falhar porque o IoT esta offline?

A acao e registrada como enfileirada e tenta novamente por 60 segundos. Depois, e registrada como falhou. O piloto pode continuar a viagem — a falha e um modo conhecido pelo qual o piloto nao e punido. O proximo evento dispara a escada novamente.

Como sei se a escada esta realmente disparando em producao?

Verifique Safety > Events para eventos sidewalk_entry com colunas de efeitos colaterais nao vazias. Cada acao disparada escreve uma linha de cv_violation_actions visivel na gaveta do evento.