Gerenciando Viagens
A página de Viagens é seu centro de comando para monitorar e gerenciar toda a atividade de viagens da sua frota. Este guia abrangente cobre tudo que os operadores precisam saber sobre rastreamento de viagens, entendimento de status, filtragem de dados e tomada de ações.
Visao Geral
A página de Viagens fornece uma visão em tempo real de todas as viagens da sua frota, desde viagens ativas acontecendo agora até dados históricos concluídos. Ela foi projetada tanto para monitoramento de alto nível quanto para investigação detalhada de viagens individuais.
Principais Recursos
- Monitoramento em tempo real - Veja viagens ativas conforme acontecem
- Filtragem abrangente - Filtre por status, período, veículo ou cliente
- Rastreamento de receita - Visibilidade instantânea da receita de viagens
- Ações rápidas - Navegue para detalhes da viagem com um clique
- Estatísticas resumidas - Métricas de desempenho da frota em um relance
Acessando a Página de Viagens
Navegue até Painel > Viagens no menu de navegação principal. A página exibe todas as viagens associadas à sua subconta (localização) selecionada atualmente.
Layout da Página
Cartões de Resumo
Quatro cartões de resumo no topo fornecem métricas-chave para o período selecionado:
| Cartão | Descrição | O Que Mostra |
|---|---|---|
| Total de Viagens | Contagem de todas as viagens no período filtrado | Número de viagens iniciadas |
| Viagens Ativas | Viagens em andamento atualmente | Contagem em tempo real de viagens em progresso |
| Viagens Concluídas | Viagens finalizadas com sucesso | Viagens que terminaram normalmente |
| Receita Total | Receita bruta das viagens | Soma de todas as cobranças de viagens no período |
Atualização Automática
Esses cartões atualizam automaticamente conforme novas viagens são concluídas ou filtros mudam.
Barra de Filtros
Localizada abaixo dos cartões de resumo, a barra de filtros fornece opções poderosas de filtragem:
Filtro de Status
Filtre viagens pelo seu estado atual:
| Status | Descrição |
|---|---|
| Todos | Mostrar todas as viagens independente do status |
| Ativa | Viagens atualmente em progresso |
| Pausada | Viagens temporariamente pausadas |
| Concluída | Viagens que terminaram normalmente |
| Cancelada | Viagens canceladas antes da conclusão |
Período
Filtre viagens por quando ocorreram:
- Hoje - Apenas viagens de hoje
- Ontem - Viagens do dia anterior
- Últimos 7 Dias - Visão da semana corrente
- Últimos 30 Dias - Visão do mês corrente
- Este Mês - Mês calendário atual
- Mês Passado - Mês calendário anterior
- Personalizado - Selecione datas de início e fim específicas
Busca
A barra de busca aceita:
- ID/Número da Viagem (ex.: "R-12345")
- Nome ou email do cliente
- ID/número do veículo
- Número de telefone do cliente
Tabela de Viagens
A tabela principal de dados exibe viagens com as seguintes colunas:
| Coluna | Descrição |
|---|---|
| Viagem # | Identificador único da viagem (clique para ver detalhes) |
| Cliente | Nome do cliente e selo de verificação |
| Veículo | ID e modelo do veículo |
| Status | Status atual da viagem com selo visual |
| Iniciada | Data e hora que a viagem começou |
| Finalizada | Data e hora que a viagem terminou (em branco se ativa) |
| Duração | Tempo total da viagem (tempo ativo + tempo pausado) |
| Distância | Distância total percorrida em milhas ou quilômetros |
| Total | Valor final ou em execução da cobrança |
Entendendo os Status das Viagens
Ativa
A viagem está atualmente em progresso:
- Cliente está alugando ativamente o veículo
- Cobrança baseada em tempo está em execução
- Veículo está desbloqueado e operacional
- Cor do selo: Azul
Pausada
A viagem está temporariamente suspensa. O sistema distingue entre dois tipos de pausas:
Pausada (Bloqueada)
- Veículo está fisicamente bloqueado (imobilizado)
- Ocorre quando o cliente pausa manualmente a viagem
- Também ocorre para pausas automáticas devido à inatividade ou sem localização GPS
- Selo mostra: "Pausada (Bloqueada)"
- Cor do selo: Amarelo
Pausada (Acelerador Desativado)
- Motor do veículo está desativado mas as rodas não estão bloqueadas
- Recurso crítico de segurança: Usado quando o veículo pode estar em movimento
- Ocorre quando auto-pausado devido a saldo insuficiente na carteira
- Permite que o piloto desacelere até uma parada segura antes de bloquear
- Selo mostra: "Pausada (Acelerador Desativado)"
- Cor do selo: Laranja
Segurança em Primeiro Lugar
Quando uma viagem é pausada por fundos insuficientes, o sistema apenas desativa o acelerador (não o bloqueio) porque o piloto pode estar em movimento. Isso previne quedas perigosas de bloqueios súbitos das rodas.
Concluída
A viagem terminou normalmente:
- Cliente encerrou a viagem pelo aplicativo
- Tarifa final foi calculada e cobrada
- Veículo está bloqueado e disponível para próximo aluguel
- Cor do selo: Verde
Cancelada
A viagem foi cancelada antes da conclusão:
- Pode ser cancelada pelo cliente, operador ou sistema
- Cobranças parciais ou nenhuma cobrança podem se aplicar
- Cor do selo: Cinza
Links Diretos de Outras Páginas
A página de Viagens suporta filtragem baseada em URL, permitindo navegação fluida de páginas relacionadas:
Da Página do Veículo
Ao visualizar um veículo específico e clicar em "Ver Viagens", você é levado à página de Viagens filtrada para mostrar apenas as viagens daquele veículo.
Da Página do Cliente
Ao visualizar um perfil de cliente e clicar em "Ver Viagens", você vê apenas o histórico de viagens daquele cliente.
Esses filtros exibem um banner proeminente mostrando qual filtro está ativo, com opção de um clique para limpá-lo.
Trabalhando com a Tabela de Viagens
Ordenação
Clique em qualquer cabeçalho de coluna para ordenar por aquela coluna:
- Primeiro clique: Ordem crescente
- Segundo clique: Ordem decrescente
- Terceiro clique: Redefinir para padrão (mais recentes primeiro)
Paginação
Listas grandes de viagens são paginadas:
- Padrão: 50 viagens por página
- Navegação de página no rodapé
- Mostra contagem total (ex.: "Mostrando 1-50 de 1.234 viagens")
Ações da Linha
Cada linha de viagem fornece acesso rápido aos detalhes:
- Clique no número da viagem para abrir a Página de Detalhes da Viagem completa
- Clique no nome do cliente para ver o perfil do cliente
- Clique no ID do veículo para ver a página de detalhes do veículo
Informações de Receita e Cobrança
Como a Receita é Calculada
Cobranças de viagem tipicamente incluem:
- Taxa de Desbloqueio - Cobrança única quando a viagem inicia
- Cobranças por Tempo - Taxa por minuto para tempo de pilotagem ativa
- Cobranças de Pausa - Taxa por minuto reduzida durante períodos pausados
- Cobranças por Distância - Se precificação por distância estiver configurada
- Menos Descontos - Códigos promocionais, assinaturas ou pacotes de viagem
Exibição de Tarifa em Tempo Real
Para viagens ativas e pausadas, o sistema exibe uma tarifa ao vivo que atualiza em tempo real:
| Status da Viagem | Exibição da Tarifa | Frequência de Atualização |
|---|---|---|
| Ativa | Total em execução (ao vivo) | A cada atualização de página |
| Pausada | Total em execução (ao vivo) | A cada atualização de página |
| Concluída | Valor final cobrado | Estático |
A tarifa ao vivo é calculada no servidor a cada requisição e inclui:
- Todo tempo decorrido (ativo + pausado nas respectivas taxas)
- Taxa de desbloqueio
- Quaisquer descontos aplicáveis
- Limite diário se atingido
Indicador de Estimativa
Tarifas de viagens ativas mostram um prefixo "~" para indicar que são estimativas. A cobrança final é calculada quando a viagem termina e pode diferir ligeiramente devido ao timing.
Impacto do Limite Diário
Se um cliente atinge seu limite diário:
- A coluna Total mostra o valor limitado
- A viagem ainda conta para as métricas
- O sistema aplica automaticamente o limite durante a cobrança
Monitorando Viagens Ativas
Para equipes de operações monitorando atividade em tempo real:
Melhores Práticas
- Filtre para status Ativo durante horários de pico
- Ordene por Hora de Início (mais antigas primeiro) para identificar viagens travadas
- Observe viagens de longa duração que podem precisar de intervenção
- Monitore viagens Pausadas que podem estar abandonadas
Sinais de Alerta para Observar
- Viagens ativas por mais de 2-3 horas (podem estar travadas)
- Viagens pausadas durando mais de 30 minutos (podem estar abandonadas)
- Múltiplas viagens ativas para o mesmo veículo (problema de dados)
- Viagens ativas em veículos marcados como "Offline" (problema de conectividade)
Recursos de Auto-Pausa e Auto-Encerramento
O sistema inclui recursos automáticos de gerenciamento de viagens (configurados por subconta):
Auto-Pausa Quando Estacionário
Se habilitado, viagens são automaticamente pausadas quando:
- Veículo está estacionário por X minutos (configurável)
- Veículo não se moveu além de um limite de raio (configurável)
- Nenhum movimento recente detectado dos sensores IoT
Quando auto-pausado:
- Veículo é bloqueado e acelerador desativado
- Cobrança de taxa de pausa se aplica (tipicamente menor que taxa ativa)
- Cliente recebe notificação push
- Viagem pode ser retomada pelo aplicativo
Auto-Encerramento Após Pausa Prolongada
Se habilitado, viagens pausadas são automaticamente encerradas quando:
- Viagem está pausada por X minutos (configurável)
- Veículo está dentro do raio aceitável de encerramento de viagem
Quando auto-encerrado:
- Tarifa final é calculada e cobrada
- Veículo fica disponível para próximo aluguel
- Cliente recebe notificação de conclusão de viagem
Auto-Pausa por Saldo Baixo
Se habilitado, viagens são auto-pausadas quando:
- Saldo da carteira do cliente cai abaixo do limite
- Carteira do cliente fica negativa após ciclo de cobrança
Recurso de Segurança
Pausas por saldo baixo usam apenas desativação de acelerador (não bloqueio) porque o piloto pode estar em movimento. Isso permite que desacelerem até uma parada segura.
Permissões
Acesso à página de Viagens requer permissões apropriadas:
| Função | Nível de Acesso |
|---|---|
| Super Admin | Acesso total a viagens de todas as subcontas |
| Admin Global | Acesso total às subcontas atribuídas |
| Admin / Gerente de Frota | Visualizar e gerenciar viagens |
| Técnico de Serviço | Acesso somente leitura às viagens |
| Visualizador | Acesso somente leitura às viagens |
Permissões adicionais podem ser necessárias para ações específicas:
- ride:refund - Necessário para processar reembolsos
- ride:update - Necessário para modificar dados de viagem
Configurações
Várias configurações de subconta afetam o comportamento das viagens (configuradas em Configurações > Geral):
Auto-Pausa Quando Estacionário
enabled: true/false
stationary_minutes: 30 (tempo antes de pausar)
stationary_radius_m: 100 (metros - raio para "não movendo")
recent_motion_window_seconds: 60
recent_motion_speed_kmh: 2
Auto-Encerramento Após Pausa
enabled: true/false
not_moving_radius_m: 75
end_after_pause_minutes: 30
Parada de Veículo por Saldo Baixo
stop_vehicle_on_low_balance: true/false
stop_vehicle_threshold_cents: 0 (tipicamente carteira fica negativa)
Solução de Problemas
Viagens Não Aparecendo
- Verifique os filtros ativos (status, período)
- Confirme que está visualizando a subconta correta
- Limpe todos os filtros e termos de busca
- Verifique se a viagem foi cancelada/excluída
Receita Não Corresponde ao Esperado
- Verifique descontos aplicados (códigos promocionais, assinaturas)
- Confirme que o limite diário não foi atingido
- Procure reembolsos parciais no histórico da viagem
- Confirme que regras de preço estão ativas para o modelo do veículo
Contagem de Viagens Ativas Parece Errada
- Algumas viagens podem estar pausadas (contadas separadamente)
- Verifique viagens que precisam de intervenção manual
- Confirme que dispositivo IoT está reportando corretamente
- Procure viagens encerradas pelo sistema que aparecem no backlog
Status Mostra "Pausada" Inesperadamente
- Cliente pode ter pausado manualmente
- Auto-pausa pode ter sido acionada (movimento ocioso)
- Saldo baixo da carteira pode ter acionado desativação do acelerador
- Verifique
auto_pause_reasonnos detalhes da viagem para a causa
Melhores Práticas
- Monitoramento regular - Verifique viagens ativas pelo menos de hora em hora durante operações
- Investigue viagens travadas - Viagens ativas por >2 horas podem precisar de intervenção
- Revise viagens canceladas - Entenda por que clientes estão cancelando
- Rastreie horários de pico - Use filtros de data para identificar períodos movimentados
- Exporte dados regularmente - Baixe dados de viagem para análise offline
- Configure alertas - Use notificações por email para problemas operacionais