Pagina de Detalhes da Viagem

A Pagina de Detalhes da Viagem fornece uma visao abrangente de tudo que aconteceu durante uma viagem. Este e seu recurso principal para investigar problemas de viagem, processar reembolsos, entender disputas de clientes e analisar padroes de viagem.

Visao Geral

Cada viagem no sistema tem sua propria pagina de detalhes acessivel clicando no numero da viagem na lista de Viagens. Esta pagina consolida todos os dados da viagem incluindo tempo, precos, rota, eventos e acoes.

Principais Recursos

Linha do tempo completa da viagem - Veja exatamente o que aconteceu e quando
Detalhamento de precos - Entenda cada cobranca e desconto
Visualizacao de rota - Visao do mapa do percurso da viagem
Log de atividades - Todos os eventos incluindo entradas em zonas, pausas e comandos
Acoes administrativas - Pausar, retomar, encerrar viagens e processar reembolsos
Contexto do cliente - Acesso rapido ao perfil e historico do cliente

Acessando um Detalhe de Viagem

Navegue ate a pagina de detalhes atraves de qualquer um destes metodos:

Da lista de Viagens - Clique no numero da viagem (ex.: "R-12345")
Do perfil do Cliente - Clique em qualquer viagem no historico
Do detalhe do Veiculo - Clique em qualquer viagem no historico de viagens do veiculo
URL Direto - /dashboard/rides/{ride_id}

Secoes da Pagina

Secao de Cabecalho

O cabecalho exibe identificacao essencial da viagem:

Elemento	Descricao
Numero da Viagem	Identificador unico (ex.: "Viagem #R-12345")
Selo de Status	Status atual da viagem com codificacao de cores
Data de Criacao	Quando a viagem foi iniciada
Botoes de Acao	Acoes administrativas disponiveis baseadas no estado da viagem

Botoes de Acao Administrativa

Acoes disponiveis dependem do status atual da viagem:

Status da Viagem	Acoes Disponiveis
Ativa	Pausar, Encerrar Viagem
Pausada	Retomar, Encerrar Viagem
Concluida	Somente visualizacao (sem acoes)
Cancelada	Somente visualizacao (sem acoes)

Permissoes Necessarias

Voce precisa da permissao ride:update para pausar, retomar ou encerrar viagens. A permissao ride:refund e necessaria para processar reembolsos.

Aba de Informacoes Gerais

A secao de informacoes primarias exibe:

Status e Tempo da Viagem

Campo	Descricao
Status	Estado atual da viagem (Ativa/Pausada/Concluida/Cancelada)
Iniciada	Data e hora que a viagem comecou (cliente desbloqueou veiculo)
Encerrada	Data e hora que a viagem terminou (se concluida)
Duracao Ativa	Tempo total gasto pilotando ativamente
Duracao Pausada	Tempo total gasto em estado pausado
Duracao Total	Tempo ativo + pausado combinado

Distancia e Rota

Campo	Descricao
Distancia Total	Distancia percorrida durante a viagem (milhas ou km)
Localizacao Inicial	Coordenadas GPS e/ou endereco onde a viagem comecou
Localizacao Final	Coordenadas GPS e/ou endereco onde a viagem terminou

Informacoes do Veiculo

Campo	Descricao
Veiculo	ID do veiculo (link clicavel para detalhe do veiculo)
Modelo do Veiculo	Tipo de veiculo usado
Bateria Inicial	Nivel de bateria quando a viagem comecou
Bateria Final	Nivel de bateria quando a viagem terminou

Secao do Cliente

Acesso rapido a informacoes e acoes do cliente:

Detalhes do Cliente

Campo	Descricao
Nome	Nome completo do cliente (link clicavel para perfil)
Email	Endereco de email do cliente
Telefone	Numero de telefone do cliente
Status de Verificacao	Se o cliente verificou sua conta
Cliente Desde	Data de criacao da conta

Metricas do Cliente (Visao Rapida)

Metrica	Descricao
Total de Viagens	Numero de viagens que este cliente fez
Saldo da Carteira	Saldo atual da carteira pre-paga
Valor Vitalicio	Receita total deste cliente

Secao de Precos

Um detalhamento detalhado de como a viagem foi precificada:

Snapshot de Precos

Quando uma viagem inicia, o sistema captura um "snapshot de precos" - as regras de precos em vigor naquele momento. Isso garante cobranca consistente mesmo se os precos mudarem durante a viagem.

Campo	Descricao
Modelo do Veiculo	O modelo determinando o preco
Tipo de Preco	Por minuto ou por distancia
Taxa de Desbloqueio	Cobranca unica de desbloqueio
Taxa por Minuto	Taxa cobrada por minuto de pilotagem ativa
Taxa de Pausa	Taxa cobrada por minuto enquanto pausado
Taxa por Distancia	Taxa por milha/km (se baseado em distancia)
Preco Minimo	Preco minimo da viagem
Limite Diario	Cobranca diaria maxima para este cliente

Detalhamento de Cobranças

Calculo detalhado das cobranças da viagem:

Taxa de Desbloqueio:       R$5,00
Tempo Ativo (15 min):      R$29,25 (15 x R$1,95)
Tempo de Pausa (3 min):    R$1,50 (3 x R$0,50)
----------------------------------------
Subtotal:                  R$35,75
Desconto (Promo):         -R$5,00
----------------------------------------
Total Cobrado:             R$30,75

Descontos Aplicados

Se algum desconto foi aplicado, ele aparece na exibicao de precos:

Tipo de Desconto	Exibicao	Descricao
Desconto de Pacote	Mostra nome do pacote e % de desconto	Pacotes de viagem pre-comprados que reduzem taxa por minuto
Desconto de Assinatura	Mostra nome da assinatura e % de desconto	Associacao ativa que reduz precos
Codigo Promocional	Mostra codigo promo e valor	Codigos de desconto de uso unico ou campanha
Limite Diario	Mostra limite atingido	Protecao automatica de limite que limita gastos diarios

Atualizacoes de Preco em Tempo Real

Para viagens ativas e pausadas, a exibicao de preco atualiza automaticamente:

Recurso	Comportamento
Intervalo de Atualizacao	A cada 30 segundos para viagens ativas/pausadas
Exibicao Estatica	Sem atualizacao para viagens concluidas/canceladas
Dados Buscados	Tarifa atual, descontos, saldo pendente

O componente de preco ao vivo mostra:

Tarifa Atual - Total em execucao baseado no tempo decorrido
Descontos Aplicados - Descontos ativos de pacote, assinatura ou promo
Saldo Pendente - Valor ainda devido (tarifa atual menos creditos)

Saldo Pendente

O saldo pendente reflete o que o cliente deve atualmente: Tarifa Atual - Creditos da Carteira Aplicados - Descontos. Para viagens ativas, isso atualiza em tempo real.

Linha do Tempo de Atividades

Um log cronologico de todos os eventos durante a viagem:

Tipos de Eventos

Evento	Descricao
Viagem Iniciada	Cliente desbloqueou veiculo e comecou a viagem
Viagem Pausada	Viagem foi pausada (manual ou automatica)
Viagem Retomada	Viagem foi retomada do estado pausado
Viagem Encerrada	Viagem foi concluida
Zona Entrada	Veiculo entrou em uma zona especial
Zona Saida	Veiculo saiu de uma zona especial
Comando de Bloqueio	Veiculo foi bloqueado remotamente
Comando de Desbloqueio	Veiculo foi desbloqueado remotamente
Acelerador Desativado	Motor do veiculo foi desativado
Acelerador Ativado	Motor do veiculo foi ativado

Eventos de Zona

Zonas especiais acionam eventos quando entradas ou saidas:

Tipo de Zona	Cor	Efeito
Zona de Estacionamento	Verde	Areas de estacionamento designadas
Zona Proibida para Estacionamento	Vermelho	Nao pode encerrar viagem aqui
Zona Proibida	Preto	Veiculo para quando entra
Zona de Limite de Velocidade	Amarelo	Velocidade maxima reduzida
Zona de Carregamento	Azul	Locais de troca de bateria
Zona de Bonus	Gradiente verde	Incentivo para encerrar aqui

Cada evento de zona mostra:

Nome da zona
Timestamp de entrada ou saida
Duracao dentro da zona (para saidas)

Eventos de Auto-Pausa

Quando uma viagem e automaticamente pausada, a linha do tempo mostra:

Motivo da pausa: idle_movement, no_location ou insufficient_funds
Metodo de pausa: Se veiculo foi bloqueado ou apenas acelerador desativado
Hora de retomada: Quando/se a viagem foi retomada

Secao de Reembolsos

Rastreie toda atividade de reembolso da viagem:

Resumo de Reembolso

Campo	Descricao
Cobranca Original	Valor total cobrado pela viagem
Total Reembolsado	Soma de todos os reembolsos emitidos
Restante	Valor ainda cobravel (elegivel para reembolso)

Historico de Reembolsos

Cada entrada de reembolso mostra:

Valor - Quanto foi reembolsado
Tipo - Credito na carteira ou reembolso no cartao
Motivo - Por que o reembolso foi emitido
Emitido Por - Admin que processou o reembolso
Data - Quando o reembolso foi processado

Processando um Reembolso

Para emitir um reembolso (requer permissao ride:refund):

Clique em Emitir Reembolso

Clique no botao Emitir Reembolso na secao de Reembolsos.

Digite o Valor

Digite o valor do reembolso (ate o saldo restante).

Selecione o Tipo de Reembolso

Escolha o tipo de reembolso:

Credito na Carteira - Adiciona ao saldo pre-pago do cliente
Reembolso no Cartao - Reembolsa ao metodo de pagamento original

Digite o Motivo

Digite um motivo/nota (obrigatorio para trilha de auditoria).

Processar

Clique em Processar Reembolso para concluir.

Reembolsos no Cartao

Reembolsos no cartao so podem ser processados se a cobranca original foi feita via Stripe e e elegivel para reembolso.

Mapa de Rota

Um mapa interativo mostrando o percurso da viagem:

Recursos do Mapa

Recurso	Descricao
Linha de Rota	Trilha GPS do percurso da viagem
Marcador de Inicio	Pin verde mostrando local de inicio da viagem
Marcador de Fim	Pin vermelho mostrando local de termino da viagem
Sobreposicoes de Zona	Representacao visual das zonas cruzadas
Marcadores de Evento	Icones para eventos-chave (pausas, entradas em zonas)

Comparacao de Localizacao Final

O sistema captura duas localizacoes finais:

Localizacao do Veiculo - Coordenadas GPS do dispositivo IoT do veiculo
Localizacao do Dispositivo do Usuario - Coordenadas GPS do telefone do cliente

A pagina exibe:

Ambas localizacoes no mapa
Distancia entre elas (em metros)
Qual fonte foi usada para validacao de zona

Discrepancia de Localizacao

Se houver distancia significativa entre as duas localizacoes (>50m), pode indicar deriva de GPS, cliente encerrou viagem remotamente ou potencial abuso (cliente nao esta no veiculo).

Secao de Foto Final

Se uma foto foi enviada quando a viagem terminou:

Exibicao da Foto

Imagem em tamanho completo do veiculo estacionado
Timestamp de quando a foto foi tirada
Coordenadas GPS de onde a foto foi capturada

Requisitos de Foto

Fotos finais podem ser obrigatorias baseadas nas configuracoes:

Obrigatoria em Zonas Proibidas para Estacionamento - Ao encerrar fora de areas designadas
Sempre Obrigatoria - Para todas as conclusoes de viagem
Opcional - Escolha do cliente enviar

Secao de Feedback

Se o cliente enviou feedback apos a viagem:

Exibicao do Feedback

Avaliacao por Estrelas - Avaliacao de 1-5 estrelas com exibicao visual
Comentario - Feedback escrito do cliente
Enviado Em - Quando o feedback foi fornecido

Use feedback para:

Identificar problemas de manutencao de veiculos
Entender satisfacao do cliente
Rastrear tendencias de qualidade de servico

Veja Sistema de Feedback de Viagens para mais detalhes sobre o sistema de feedback.

Detalhes Tecnicos

Fontes de Dados

A pagina de detalhes da viagem agrega dados de multiplas tabelas:

Dado	Tabela Fonte
Info da viagem	`rides`
Cliente	`customers`
Veiculo	`vehicles`
Precos	`live_pricing_snapshots`
Rota	`ride_locations`
Eventos de zona	`ride_zone_events`
Eventos de bloqueio	`ride_lock_events`
Reembolsos	`ride_refunds`
Feedback	`ride_feedback`

Comportamento de Atualizacao

Viagens Ativas/Pausadas - Secao de precos auto-atualiza a cada 30 segundos
Viagens Concluidas - Exibicao estatica (sem auto-atualizacao necessaria)
Atualizacao Manual - Clique em "Atualizar" para atualizar todos os dados imediatamente
Dados ao vivo incluem - Tarifa atual, descontos aplicados, saldo pendente

Permissoes

Permissao	Nivel de Acesso
ride:view	Necessario para acessar detalhes da viagem
ride:update	Necessario para pausar/retomar/encerrar viagens
ride:refund	Necessario para processar reembolsos