# Eventos do Monitriip

## Visão Geral

O modulo "**Eventos Monitriip**" é uma ferramenta essencial para empresas de transporte que precisam monitorar eventos de seus veículos para o Monitriip. Este módulo permite o acompanhamento de jornadas de trabalho, paradas e outras operações realizadas pelos motoristas utilizando o aplicativo do Monitriip disponível para dispositivos ANDROID, mantendo conformidade com as exigências da ANTT (Agência Nacional de Transportes Terrestres).

Para acessar clique no menu **VIAGENS** opção **EVENTOS DO MONITRIIP**

## Interface Principal - Tela de Pesquisa

### Descrição

A tela principal apresenta uma interface de pesquisa organizada em duas seções principais:

1. **Seção de Filtros** - Localizada na parte superior da tela, permite refinar os resultados da pesquisa.
2. **Tabela de Resultados** - Exibe os eventos encontrados de acordo com os filtros aplicados.

### Elementos da Interface

#### Seção de Filtros

- **Título**: "Filtros" com opção de colapsar/expandir
- **Campo Veículo**: Seletor dropdown que permite escolher um veículo específico
- **Campo Período**: Composto por: 
    - Data de início (formato DD-MM-YYYY)
    - Texto "à"
    - Data de fim (formato DD-MM-YYYY)
- **Botões de Ação**: 
    - Botão de Pesquisa (ícone de lupa)
    - Botão Limpar Filtros (ícone de arquivo)
    - Botão Exportar para CSV (ícone de salvar)

#### Tabela de Resultados

A tabela apresenta os seguintes campos:

- **VEÍCULO**: Placa do veículo (ex: PIE-5277)
- **IMEI**: Número de identificação do dispositivo (ex: 6f71f71f4d3d3970)
- **DATA/HORA**: Data e hora do evento (formato DD/MM/YYYY HH:MM:SS)
- **OPERAÇÃO**: Tipo de operação realizada (ex: Log Jornada Trabalho, Detecção Parada)
- **TIPO EVENTO**: Classificação do evento
- **AUTORIZAÇÃO VIAGEM**: Número de autorização, quando aplicável
- **MOTIVO PARADA**: Motivo para paradas (ex: OUTRO)
- **DATA RECEBIMENTO**: Data e hora de recebimento do evento pelo sistema
- **ENVIO ANTT**: Data e hora do envio à ANTT
- **PROCESSADO**: Status de processamento (SIM/NÃO)

#### Paginação

- **Indicador de Páginas**: Exibe a página atual e o total (ex: 1-17 de 20)
- **Controles de Navegação**: Botões para avançar/retroceder páginas

## Tela de Detalhes do Evento

Ao selecionar um registro na tabela, o sistema abre uma tela de detalhes com informações completas sobre o evento.

### Elementos da Tela de Detalhes

A tela de detalhes apresenta todas as informações do evento selecionado em formato de visualização (não editável), organizadas em blocos de dados:

#### Bloco 1:

- **Veículo**: Placa do veículo
- **Operação**: Tipo de operação do evento
- **Data/Hora**: Data e hora de ocorrência
- **IMEI**: Identificador do dispositivo

#### Bloco 2:

- **Latitude**: Coordenada geográfica (clicável para abrir o Google Maps)
- **Longitude**: Coordenada geográfica (clicável para abrir o Google Maps)
- **CPF Motorista**: Identificação do condutor
- **Tipo Evento**: Classificação do evento

#### Bloco 3:

- **Autorização Viagem**: Número de autorização
- **Tipo Registro Viagem**: Classificação do registro
- **Motivo Parada**: Razão da parada
- **Tipo Registro Evento**: Classificação do registro

#### Bloco 4:

- **Sentido Linha**: Direção da rota
- **Identificação Linha**: Código da linha de transporte
- **Código Tipo Viagem**: Classificação da viagem
- **Data Programada Viagem**: Data planejada

#### Bloco 5:

- **Hora Programada Viagem**: Horário planejado
- **Data Recebimento**: Data/hora de recepção pelo sistema
- **Data Envio ANTT**: Data/hora de transmissão para ANTT
- **Processado**: Status de processamento

#### Controles:

- **Botão Voltar**: Retorna para a tela de pesquisa

## Fluxo de Trabalho

1. **Acesso à Tela Principal**: O usuário acessa a interface de pesquisa
2. **Aplicação de Filtros**: Seleciona um veículo e/ou período específico
3. **Pesquisa**: Clica no botão de pesquisa para obter os resultados
4. **Visualização dos Resultados**: Analisa os eventos na tabela
5. **Acesso aos Detalhes**: Clica em um registro para ver informações completas
6. **Retorno à Pesquisa**: Utiliza o botão Voltar para retornar à tela principal
7. **Exportação de Dados**: Opcionalmente exporta os resultados para CSV

## Regras de Negócio

1. **Filtro Padrão de Data**: Ao acessar a tela pela primeira vez, o sistema define automaticamente:
    
    
    - Data inicial: primeiro dia do mês corrente
    - Data final: último dia do mês corrente
2. **Persistência de Filtros**: Os filtros são armazenados na sessão do usuário, sendo recuperados em acessos subsequentes à tela.
3. **Pesquisa de Veículos**: A busca de veículos pode ser realizada por:
    
    
    - Placa
    - Marca
    - Modelo
    - Condutor
    - Identificação interna (labelVeiculo)
4. **Formato de Coordenadas**: As coordenadas geográficas são clicáveis e abrem o Google Maps com a localização exata do evento.
5. **Exportação para CSV**: Os dados podem ser exportados no formato CSV utilizando ponto-e-vírgula como separador.
6. **Paginação**: Os resultados são paginados automaticamente para melhor desempenho.

## Instruções Passo a Passo

### Como Pesquisar Eventos

1. Acesse a tela de eventos Monitriip
2. Na seção de filtros, selecione um veículo específico (opcional)
3. Defina o período desejado nos campos de data de início e fim
4. Clique no botão de pesquisa (ícone de lupa)
5. Aguarde a exibição dos resultados na tabela

### Como Visualizar Detalhes de um Evento

1. Na tabela de resultados, clique em qualquer linha para selecionar o evento
2. O sistema abrirá automaticamente a tela de detalhes
3. Navegue pelas informações organizadas em blocos
4. Para visualizar a localização no mapa, clique nas coordenadas de latitude/longitude
5. Para retornar à tela de pesquisa, clique no botão "Voltar"

### Como Exportar Dados para CSV

1. Aplique os filtros desejados e realize a pesquisa
2. Clique no botão "Exportar para CSV" (ícone de salvar)
3. Escolha o local para salvar o arquivo
4. O arquivo será salvo com o nome "EventosMonitriip.csv"

### Como Limpar os Filtros

1. Clique no botão "Limpar Filtros" (ícone de arquivo)
2. Os campos serão redefinidos para: 
    - Veículo: vazio
    - Data inicial: primeiro dia do mês corrente
    - Data final: último dia do mês corrente

## Perguntas Frequentes

### O que é o Monitriip?

O Monitriip é um sistema de controle obrigatório para empresas de transporte rodoviário regulamentado pela ANTT. Ele registra informações sobre jornada de trabalho, paradas e outras operações realizadas pelos motoristas.

### Como identificar eventos que ainda não foram enviados à ANTT?

Verifique a coluna "ENVIO ANTT" na tabela de resultados. Se estiver vazia, o evento ainda não foi transmitido.

### É possível visualizar a localização exata de um evento?

Sim. Nos detalhes do evento, clique nas coordenadas de latitude e longitude para abrir o Google Maps com a localização exata.

### Por que alguns eventos mostram "Detecção Parada" enquanto outros mostram "Log Jornada Trabalho"?

"Detecção Parada" indica que o veículo parou por um tempo suficiente para ser considerado em pausa, enquanto "Log Jornada Trabalho" representa registros regulares de atividade.

### Como sei se um evento foi processado corretamente?

Verifique a coluna "PROCESSADO". Se mostrar "SIM", o evento foi processado com sucesso.

### O sistema armazena meus filtros para a próxima vez que eu acessar?

Sim, o sistema salva os últimos filtros utilizados e os restaura automaticamente em seu próximo acesso.

### Qual o período máximo que posso pesquisar de uma vez?

Não há limitação técnica específica, mas para melhor desempenho, recomenda-se pesquisar períodos de até 90 dias.

### É possível editar os dados de um evento?

Não, a tela de detalhes é apenas para visualização. Os eventos Monitriip são registros oficiais e não podem ser alterados após o envio.