# Capítulo 02 - Módulos e Funcionalidades

## Introdução

Este capítulo descreve os módulos do E.Rastreio Portal conforme eles se apresentam na **interface do usuário**, seguindo a organização do menu lateral (sidebar). Cada grupo de menu reúne funcionalidades relacionadas e é exibido de acordo com as permissões do usuário autenticado.

---

## 1. Painéis

Ponto de entrada do sistema após o login.

- **Padrão:** dashboard principal com indicadores consolidados da frota.

## 2. Produtividade

Gestão de desempenho de analistas e metas operacionais.

- **Meu Dashboard:** indicadores individuais de produtividade.
- **Equipe:** visão consolidada da equipe (requer permissão de gerenciamento).
- **Config. SLA:** definição de metas e parâmetros de acompanhamento (requer permissão específica de SLA).

## 3. Câmeras

Monitoramento por câmeras embarcadas, integrado à plataforma **Jimi Cloud**.

- **Devices:** listagem de dispositivos, com acesso a visualização ao vivo (individual e em grade), gravações e transmissão HLS.
- **Comandos:** envio de instruções remotas às câmeras.
- **Downloads:** solicitação e gestão de arquivos de vídeo, com armazenamento em nuvem.

## 4. Rastreamento

Menu central que concentra o acompanhamento da frota, telemetria e compartilhamento. Reúne funcionalidades de três áreas do sistema.

- **Painel:** status dos rastreadores (online/offline, última comunicação).
- **Mapa em Tempo Real:** posição atual dos veículos, com velocidade, ignição e localização.
- **Replay de Rastreamento:** reconstituição do trajeto percorrido em um período.
- **Relatório de Rotas:** consolidação de deslocamentos, com exportação em Excel e PDF.
- **Telemetria:** painel analítico de desempenho por veículo. A partir de filtros de veículo e período, apresenta métricas organizadas em cinco seções — *Visão Geral*, *Tempo e Eficiência*, *Paradas*, *Segurança* e *Velocidade* — com detalhe em modais e exportação em PDF. Consulte o Capítulo 03 para o detalhamento das telas.
- **Score de Direção** *(requer permissão de telemetria)*: ranking de motoristas, score individual, perfis de pontuação e análise por IA (Gemini), com exportação em PDF.
- **Premiação** *(requer permissão de telemetria — gerenciar)*: definição e acompanhamento de recompensas por desempenho.
- **Espelhamentos:** compartilhamento externo de mapas via link tokenizado (com senha opcional) e cercas geográficas (geofences) que disparam alertas por e-mail na entrada/saída de veículos.

## 5. Ponto (EPONTODIG)

Controle da jornada de trabalho dos motoristas, com foco em conformidade trabalhista.

- **Painel:** visão consolidada das jornadas.
- **Automático:** cálculo de jornada a partir dos dados de GPS (ignição, movimento, paradas), com reprocessamento de períodos.
- **Manual:** lançamento e ajuste manual de pontos.

> As exportações legais (**AFD**, **AEJ** e espelho de ponto em PDF) e a análise de jornada estão disponíveis a partir dos relatórios do módulo.

## 6. Cooca+

Integração com a plataforma externa de compras.

- **Portal de Compras:** consulta de limite, reservas e títulos a pagar junto à API da CoocaMais. Quando o usuário possui mais de um grupo com matrícula Cooca+ cadastrada, os dados são exibidos em abas, uma por grupo. Os dados de reservas e títulos são carregados via AJAX sob demanda.

## 7. Gestão

Gestão financeira ligada à operação da frota e dos motoristas.

- **Painel:** visão consolidada de entradas e saídas.
- **Receitas:** lançamento e categorização de receitas.
- **Despesas:** lançamento e categorização de despesas.
- **Transferências:** movimentações entre contas/entidades.
- **Acertos:** fechamento e liquidação de valores por motorista.

## 8. Cadastros

Gestão das entidades operacionais fundamentais.

- **Pessoas:** cadastro de motoristas e pessoas (dados pessoais, CNH, vínculos).
- **Veículos:** cadastro completo, com integração à tabela **FIPE**, vínculo com rastreadores e histórico de motoristas. O acompanhamento de CRM do veículo é acessado a partir daqui.
- **Rastreadores:** cadastro dos dispositivos e vínculo com veículos.

> **Atenção:** o *cadastro do dispositivo* rastreador fica aqui, enquanto o *painel de acompanhamento* dos rastreadores fica no menu **Rastreamento**.

## 9. Administrador

*Exibido apenas para o administrador máximo (master admin)*

Área de configuração global, controle de acesso e gestão de entidades administrativas.

- **Grupos:** organização hierárquica de motoristas e veículos, com dados de empregador e integração CoocaMais.
- **Perfis de Acesso:** definição de perfis de permissão reutilizáveis.
- **Usuários:** gestão de contas e vínculos com veículos, grupos e associações.
- **Clientes de API:** gerenciamento de acesso à API REST do portal para sistemas e empresas externas. Permite cadastrar clientes (com nome e CNPJ/CPF), definir quais veículos cada cliente pode consultar, e gerar ou revogar tokens de acesso individuais. O token gerado é exibido uma única vez no momento da geração e não pode ser recuperado posteriormente.
- **Associação:** entidades que agregam grupos, com credenciais de integração e regras de pernoite.
- **Alertas Pernoite:** monitoramento e tratamento de alertas de pernoite dos veículos.
- **Alertas Sinal:** monitoramento e resolução de alertas de perda de sinal.
- **Auditoria:** identificação e resolução de pendências operacionais e de cadastro.
- **Permissões em Massa:** atribuição de permissões a múltiplos usuários de uma só vez.
- **Configurações:** parâmetros globais do sistema.

## 10. Módulos em Preparação

Os módulos a seguir existem na estrutura do sistema, porém **ainda não estão expostos no menu de navegação** e, portanto, não são acessíveis pela interface no estado atual. Estão documentados aqui para registro e planejamento de evolução.

### 10.1. Zonas de Risco

Módulo destinado ao **monitoramento de áreas de risco** da operação.

- **Painel de zonas de risco:** visualização e acompanhamento das áreas mapeadas, com o objetivo de apoiar a gestão de segurança da frota.
- **Situação atual:** existe uma referência residual à rota do painel no gatilho do menu "Painéis", mas sem link visível na navegação. Aguarda desenvolvimento e exposição na interface.

### 10.2. Conjuntos

Módulo destinado ao **agrupamento e organização de entidades operacionais**.

- **Gestão de conjuntos:** estruturação de agrupamentos e associação a usuários, conforme as necessidades de gestão da operação.
- **Situação atual:** não possui entrada no menu de navegação. Aguarda desenvolvimento e exposição na interface.

---

## Observações de Navegação

- **Rastreamento** é um menu combinado que agrega três domínios distintos (Rastreadores, Telemetria e Espelhamento).
- **Grupos, Associação, Alertas e Auditoria**, embora pertençam à área de administração no código, são acessados pelo menu **Administrador** na interface.
- Alguns nomes de negócio diferem da nomenclatura técnica interna do sistema.
- **Zonas de Risco** e **Conjuntos** ainda não estão disponíveis na navegação.