Validacao de Veiculos

O sistema de validacao verifica se veiculos estao prontos para viagens antes de permitir o desbloqueio. Isso garante seguranca e qualidade de servico.

Visao Geral

O Que e Validacao

Validacao e um conjunto de verificacoes automaticas que determinam se um veiculo pode ser alugado:

• Status do veiculo
• Nivel de bateria
• Localizacao
• Conectividade IoT
• Regras de zona

Quando Acontece

Regras de Validacao

Status do Veiculo

Bateria

// Regra de bateria
const MIN_BATTERY = 15; // Porcentagem

if (vehicle.battery_level < MIN_BATTERY) {
  return { valid: false, reason: "Bateria baixa" };
}

Conectividade IoT

Localizacao

Configurando Validacao

Limites de Bateria

Tolerancia de Offline

Configure quanto tempo um veiculo offline ainda pode ser alugado:

Validacao por Zona

Zonas de Operacao

Veiculos so podem ser alugados dentro de zonas de operacao:

1. Defina zonas no mapa
2. Veiculos fora da zona ficam indisponiveis
3. Cliente ve mensagem explicativa

Zonas Proibidas

Veiculos em zonas proibidas:

• Nao aparecem no mapa
• Nao podem ser desbloqueados
• Geram alerta para operador

Mensagens de Erro

Para Clientes

No Painel

Veiculos invalidos mostram:

• Badge indicando problema
• Motivo da invalidacao
• Acao sugerida

Validacao Pre-Viagem

Checklist Automatico

Antes de permitir desbloqueio:

[x] Status = available
[x] Bateria >= 15%
[x] Ultimo ping < 1 hora
[x] Localizacao dentro da zona
[x] Sem viagem ativa
[x] Sem reserva ativa

Resposta da API

{
  "can_start_ride": false,
  "validation_errors": [
    {
      "code": "low_battery",
      "message": "Bateria abaixo do minimo",
      "current_value": 10,
      "required_value": 15
    }
  ]
}

Validacao Durante Viagem

Verificacoes Continuas

Durante uma viagem, o sistema monitora:

Forcando Fim de Viagem

Em casos extremos, o sistema pode:

1. Alertar cliente para parar
2. Bloquear veiculo remotamente
3. Encerrar viagem automaticamente

Jobs de Validacao

Cron Jobs

O sistema executa validacao periodica:

Fluxo do Job

1. Buscar todos os veiculos
2. Para cada veiculo:
   a. Verificar bateria
   b. Verificar ultimo ping
   c. Verificar localizacao
   d. Atualizar status
3. Registrar estatisticas

Excecoes e Overrides

Override Manual

Operadores podem forcar disponibilidade:

1. Abrir detalhes do veiculo
2. Clicar em Forcar Disponivel
3. Confirmar a acao
4. Veiculo fica disponivel temporariamente

Excecoes por Funcao

Logs de Validacao

O Que e Registrado

Cada tentativa de validacao registra:

• Data/hora
• Veiculo
• Cliente (se aplicavel)
• Resultado
• Motivos de falha

Consultando Logs

SELECT
  created_at,
  vehicle_uuid,
  customer_uuid,
  is_valid,
  validation_errors
FROM vehicle_validations
WHERE vehicle_uuid = 'xxx'
ORDER BY created_at DESC
LIMIT 100;

Metricas de Validacao

Dashboard de Validacao

Acompanhe metricas como:

Solucao de Problemas

Veiculo Sempre Invalido

Possiveis causas:

• Bateria constantemente baixa
• Problema de IoT
• Configuracao incorreta

Solucoes:

1. Verifique nivel de bateria
2. Teste conectividade IoT
3. Revise configuracoes de validacao

Validacao Muito Lenta

Possiveis causas:

• Muitas verificacoes
• API IoT lenta
• Banco de dados lento

Solucoes:

1. Revise regras de validacao
2. Verifique performance de APIs
3. Otimize consultas

Falsos Negativos

Possiveis causas:

• Limites muito restritivos
• Dados de telemetria atrasados
• Bug no sistema

Solucoes:

1. Ajuste limites
2. Verifique frequencia de telemetria
3. Reporte o bug

Melhores Praticas

1. Equilibre seguranca e disponibilidade - Limites muito restritivos reduzem frota
2. Monitore metricas - Identifique problemas cedo
3. Comunique ao cliente - Mensagens claras de erro
4. Documente excecoes - Registre overrides manuais

Proximos Passos

• Gerenciando Veiculos - Gerenciamento completo
• Modo de Manutencao - Remover veiculos de servico
• Problemas Comuns - Resolver problemas