ACANTO — Monitoramento de frota

Frota

—

Log de auditoria

Veículos

Placa	Tecnologia	Motorista
—

Motoristas

Nome	CPF	CNH	Cat.	Vínculo	Município/UF	Ativo
—

Clientes

Razão social	CNPJ	Tipo	Município/UF	Ativo	Torre	Checklist
—

Agentes de IA (prompts)

✷ O que a plataforma já faz sozinha — catálogo dos agentes embutidos

Estes agentes já operam por regra hoje. Quando o agente de IA real for plugado, ele preenche o mesmo ponto sem mudar o fluxo.

Prompts customizados (seus)

Agente	Função	Modelo	Ativo
—

Integração / API

Entregue isto a quem vai integrar a tecnologia do rastreador para nos enviar dados reais de viagem. A plataforma recebe posições e eventos; a tecnologia é quem envia.

1. Autenticação

Cada requisição leva o token no cabeçalho Authorization: Bearer SEU_TOKEN. Gere o token por fornecedor no bloco 3. URL base desta plataforma:

2. Endpoints (o que a tecnologia envia)

POST /api/posicoes — ping de GPS

Obrigatórios: external_id, placa, ocorrido_em (ISO 8601), lat, lng. Opcionais: velocidade_kmh, rumo (graus 0–360), ignicao (bool), odometro_km.

{
  "external_id": "abc-123",
  "placa": "ABC1D23",
  "ocorrido_em": "2026-06-15T13:40:00Z",
  "lat": -23.55, "lng": -46.63,
  "velocidade_kmh": 62, "rumo": 37, "ignicao": true
}

POST /api/eventos — macro / ocorrência

Obrigatórios: external_id, placa, ocorrido_em, macro_codigo. Opcionais: lat, lng, macro_descricao, motorista_id.

{
  "external_id": "evt-987",
  "placa": "ABC1D23",
  "ocorrido_em": "2026-06-15T13:41:00Z",
  "macro_codigo": "PANICO",
  "macro_descricao": "Botao de panico acionado"
}

Respostas: 201 criado · 200 reenvio idempotente (mesmo external_id não duplica) · 400 campo faltando · 401 token inválido · 422 placa não reconhecida nesta gerenciadora.

3. Tokens por fornecedor

Fornecedor / origem

Descrição (opcional)

Fornecedor	Token	Descrição	Ativo
—

⚠ O token dá acesso de envio. Trate como senha; revogue se vazar (o envio para na hora).

4. De-para de macros (fornecedor → canônico)

Cada rastreador nomeia os eventos do seu jeito (ex.: M01, EMERG). Mapeie para o código canônico da plataforma — é o que faz a severidade e a correlação baterem certo. Sem mapa, o evento é classificado por palavra-chave (menos confiável).

Fornecedor

Macro do fornecedor

Evento canônico

Descrição (opcional)

Fornecedor	Macro do fornecedor	→ Canônico	Descrição
—

🧩 Modelos de Apólice por seguradora

Quando a IA lê uma apólice, ela usa o modelo da seguradora pra saber onde mora cada coisa (LMG, faixas, específicas, exclusões). Layout consistente = extração mais confiável. Apólice de uma seguradora sem modelo cai no genérico e avisa — aí você cadastra aqui. A keyword é a palavra que casa com o nome da seguradora (ex.: "tokio" casa "Tokio Marine S.A.").

—

＋ Novo modelo / editar existente

Keyword (palavra do nome da seguradora)

Nome (rótulo)

Dicas (onde mora cada campo nesta seguradora)

🤖 IA ajuda a escrever as dicas. Anexe o PDF da apólice desta seguradora e a IA propõe o de-para (onde mora LMG, faixas, específicas, exclusões, POS) no padrão dos outros modelos. Você revisa e edita antes de salvar — a IA rascunha, o humano confirma.

Salvar com a mesma keyword sobrescreve o modelo dela.

Saúde do sistema

Monitora banco, ingestão e integrações para pegar lentidão antes do cliente interno sentir. Atualiza sozinho.

🤖 Uso de IA (custo por PGR e por viagem)

Quanto a IA da Claude custou — separando a leitura/regras do PGR da IA que roda na viagem (foto do checklist e a Atena). Conta a partir da implantação do monitor (não retroage). Custo em dólar pelo preço do modelo; reais aproximado.

De
Até

Integrações por fornecedor

Fornecedor	Status	Última posição	Na última hora	Token ativo
—

📡 Conexões

Sala de controle da integração (separada do monitoramento): cada fornecedor está vivo? o dado está chegando? quais caminhões em viagem ficaram mudos? Atualiza sozinho.

Veículos EM VIAGEM sem comunicação

Placa	SM	Transportadora	Mudo desde	Ciência
—

Integrações por fornecedor

Fornecedor	Status	Última posição	Na última hora	Token ativo
—

Relatórios / Faturamento

Mês

Ano

Base de faturamento (decisão do produto): veículos monitorados no mês (qualquer SM ativa no período) e SMs/viagens iniciadas no mês.

Transportadora	Veículos no mês	SMs / viagens no mês
Escolha o período e clique em Gerar.

Detalhado por viagem — este é o conjunto (line items) que a plataforma de faturamento consome via integração; o preço/tarifa é definido lá, não aqui

Código	Transportador	Veículo	Tecnologia	Produto	Cliente	Rota	KM	Carga (R$)	Status	Início	Dias
—

Checklist (itens a testar)

Como funciona: cada item é um teste de sensor antes da viagem. A lista é a mesma para todas as tecnologias — a tabela Cobertura por tecnologia (logo abaixo) é o de-para que decide, por tecnologia, o que valida sozinho.
• Ative só os itens que sua operação exige · marque Obrigatório os que travam a liberação da SM (clique direto nas colunas Ativo/Obrigatório).
• O que a tecnologia emite → valida automático pelo sinal real (passivo). O que não emite → vira teste físico (motorista) ou comando. A GR reconhece no fim.
• Não sabe por onde começar? Clique em Ativar recomendados (Posição, Porta do baú, Desengate, Pânico, Sirene).

#	Descrição	Evento esperado	Obrigatório	Ativo
—

Cobertura por tecnologia

Quais eventos cada tecnologia de rastreador emite (✓ verde = mapeado). Cinza = não mapeado para aquela tecnologia. Lido do de-para do sistema.

—

Vistoria por foto (modo "Foto" do App)

A operação no modo Foto pede estas fotos ao motorista. Edite a lista: adicione (lacre, hodômetro, NF…), remova, marque as obrigatórias.

Foto pedida	Obrigatória
—

Nova foto (descrição)

Obrigatória

⏰ Agendar Checklist

Aparecem aqui os veículos cuja operação exige checklist e que ainda não concluíram. O horário do checklist é próprio (independente da partida). Os não agendados vêm primeiro. O envio do link do checklist é automático (WhatsApp Business); o link manual é um recurso de exceção.

—

📊 Indicadores

De

Até

Placa

Tipo

Valor da carga (total)

—

Qtde de viagens

—

Viagens por período

Por situação

Por placa

Cidade de origem

Cidade de destino

Escoltas

Empresa	Contato	Telefone	Responsável	Status	Ativa	Ações
—

Pronta Resposta

Parceiros que vão ao local em caso de sinistro. Quando há suspeita no Painel de Risco, a IA consulta esta lista (quem está perto / ETA) — mas o GO é do líder ou acima.

Empresa
Contato / Telefone
Cobertura
ETA médio (min)

Empresa	Contato	Cobertura	ETA méd.	Ativo
—

Acionamentos

—

Suspeitas encaminhadas à pronta-resposta. A IA/operador abre e consulta os parceiros; o GO (mandar ir) é 100% do líder ou acima.

Iscas

Identificador	Modelo	Fornecedor	Bateria	Status	Ativa	Ações
—

Áreas de Risco

A GR cadastra as áreas. Escopo Global vale pra todos os clientes; escopo por cliente só dispara pros carros daquele cliente. Um carro entrando na área dispara a reação escolhida.

Nome	Escopo	Nível	Tipo	Cobertura	Reação	Ativa	Ações
—

Área de Sombra (GSM)

Zonas onde vários veículos (≥3), em trânsito, ficaram mudos e reapareceram adiante — atravessaram um buraco de sinal. Provável falta de cobertura celular, não jamming. Ignora caminhão parado (pátio/depósito: reaparece no mesmo lugar). Derivado do nosso histórico. Contextualiza o "sem sinal": mudo aqui = provável cobertura; mudo fora = suspeita.

Local (lat, lng)	Veículos mudos	Silêncios	Último
Clique em Atualizar pra derivar as zonas do histórico.

PGR — Planos de Gerenciamento de Risco

Cada PGR pertence a um cliente. As faixas (valor da carga × região → medidas) definem o que a viagem exige. Um PGR só "entra em uso" depois de aprovado.

Nº controle	Cliente	Seguradora	Mercadoria	Status	Ações
—

Reações a eventos

Tipo de evento	Classificação	Canal	Escala p/	Ativa
—

Reações combinadas — 2+ eventos juntos numa janela disparam uma reação própria

Nome	Eventos (todos juntos)	Janela	Classificação	Aciona PR	Ativa
—

Usuários

Username	Nome	Papel	Nível	Transportadora
—

Torre de controle (serviço pago)

por transportadora

A Torre é um serviço cobrado à parte. Ligue aqui só para os clientes que contrataram — quem estiver desligado não vê a aba nem recebe os dados (a trava é no servidor).

Transportadora	CNPJ	Torre	Ação
—

Atribuição	Liberado a partir de
—

Bases de monitoramento

Cada base cobre um conjunto de operações. O operador vê só as viagens das operações da base dele; líder e supervisor veem tudo. A base Residual cobre, sozinha, toda operação que não foi atribuída a nenhuma base — é a rede de segurança.

Nome	Tipo	Operações	Ativa	Ações
—

Operações

Nome	Cliente	PGR / Produto	Valor mín	Valor máx	Ativa
—

Rotas

Nome	Origem	Destino	Distância	Tempo	Ativa	Ações
—

Editor de Rota

0 locais

Marque os locais (paradas): clique no mapa, ou use a barra abaixo para digitar CEP / coordenada. Depois clique em Salvar locais e, se quiser, Recalcular pela ordem dos locais.

Adicionar ponto: CEP · LatLong

Sensores

🩺 Relatório de saúde da frota — revise aqui antes de notificar a transportadora

Novo sensor / atuador

Tipo

Lista-mestre da gerenciadora. Sensor mede/comunica; atuador age (bloqueio, sirene). Em cada veículo (tela Veículos / Sensores) você marca quais ele tem.

Sensor (lista-mestre)
—

Padrão por tipo (herança)

Defina o conjunto de cada tipo — uma lista para carroceria (Baú, Sider…) e outra para veículo/cavalo (Truck, 3/4, Toco…). Todo veículo desse tipo herda automaticamente. A exceção é por placa, no bloco de baixo.

Categoria
Tipo

Escolha a categoria e o tipo, e clique em “carregar”.

Tipo de carroceria	Qtd
—

Tipo de veículo (cavalo)	Qtd
—

Exceção por placa

Busque a placa e ajuste/iniba os sensores só daquele veículo (sobrepõe o template do tipo). Sem listar 5000 — só o que você procura.

🔍

Minhas Viagens

—

Placa / SM	Rota / Produto	Carga	Status
—

Nova Solicitação de Monitoramento

Informe só o básico. A gerenciadora completa o plano de risco (PGR, medidas, corredor) e libera a viagem.

⚠ Regra: a SM só abre com as 3 pontas liberadas — veículo, carreta e motorista com pesquisa aprovada e checklist ok. Sem liberação vigente, não libera.

Veículo e motorista

Veículo (cavalo) *

Carretas (opcional, até 3 — truck/VUC deixe em branco)

Motorista

Rota

Operação e carga

Produto / carga

Valor da carga (R$)

Operação (sugerida pelo produto e valor)

Não concorda? Você pode escolher outra operação.

Data prevista da viagem

Tipo de solicitação

O número da SM é gerado automaticamente pela gerenciadora.

Segurança (opcional)

Só aparecem iscas e escoltas aprovadas pela gerenciadora. As pendentes não podem ser usadas.

Isca (dispositivo)

Quantidade de iscas

Escolta

Minhas cargas

Você abre o pedido (transportadora + rota + carga). A transportadora atribui o caminhão e a gerenciadora libera. Acompanhe o status aqui.

Preencha os campos em português.

Minhas transportadoras

Registre as transportadoras que você já contratou.

—

SM	Transportadora	Rota / Produto	Status	Ações
—

Relatório das minhas viagens

Somente as suas viagens. Sem filtro, mostra as mais recentes. Inclui status e não-conformidades.

SM	Rota	Veículo	Status	Início	Fim	Não-conf.
—

Meu PGR

O(s) Plano(s) de Gerenciamento de Risco em que sua empresa é dona ou parte de uma operação. Você pode ver e baixar o Word — a edição é da gerenciadora.

Nº de controle	Cliente (dono)	Seguradora	Apólice	Vigência	Papel
—

Cockpit — operação ao vivo

carregando...

Central de Monitoramento

—

Clique numa viagem para ver no mapa o rastro percorrido.

Painel de Alertas

demonstração

Risco	Placa / SM	Transportadora	Rota / Produto	Carga	Situação	Últ. comunicação	Status
—

Painel de Risco

—

O que está acontecendo agora, por severidade. Crítico (vermelho) pisca até alguém clicar "ciente" — fica registrado quem viu. Atenção (amarelo) some quando normaliza. Feed real dos detectores + rastreador.

Agrupar por: Janela: só não reconhecidos mostrar resolvidos modo tela cheia atualiza sozinho a cada 20s

Pendências

—

SMs ativas com divergência na liberação. A pendência só sai quando o transportador/operador corrige — ninguém fura. O supervisor usa esta fila como alerta.

Checklist a vencer / vencido

Por veículo, quando o checklist vence (pela validade da operação). Planeje a re-checagem antes de a viagem bloquear.

Placa	Operação	Concluído em	Vence em	Restam
—

Viagens / SM

Situação: De: Até:

Nº SM	Placa	Transportadora	Rota	Motorista	Valor	Situação
—

Frota

Log de auditoria

Veículos

Motoristas

Clientes

Agentes de IA (prompts)

✷ O que a plataforma já faz sozinha — catálogo dos agentes embutidos

Prompts customizados (seus)

Integração / API

1. Autenticação

2. Endpoints (o que a tecnologia envia)

3. Tokens por fornecedor

4. De-para de macros (fornecedor → canônico)

🧩 Modelos de Apólice por seguradora

＋ Novo modelo / editar existente

Saúde do sistema

🤖 Uso de IA (custo por PGR e por viagem)

Integrações por fornecedor

📡 Conexões

Veículos EM VIAGEM sem comunicação

Integrações por fornecedor

Relatórios / Faturamento

Detalhado por viagem — este é o conjunto (line items) que a plataforma de faturamento consome via integração; o preço/tarifa é definido lá, não aqui

Checklist (itens a testar)

Cobertura por tecnologia

Vistoria por foto (modo "Foto" do App)

⏰ Agendar Checklist

📊 Indicadores

Escoltas

Pronta Resposta

Acionamentos

Iscas

Áreas de Risco

Área de Sombra (GSM)

PGR — Planos de Gerenciamento de Risco

Reações a eventos

Reações combinadas — 2+ eventos juntos numa janela disparam uma reação própria

Usuários

Torre de controle (serviço pago)

Permissões por nível

Bases de monitoramento

Operações

Rotas

📥 Importar rotas (Excel) — implantação: cria várias rotas de uma vez, com dono

Editor de Rota

Sensores

🩺 Relatório de saúde da frota — revise aqui antes de notificar a transportadora

Padrão por tipo (herança)

Exceção por placa

Minhas Viagens

🩺 Saúde da minha frota — diagnóstico e recomendações da central

Nova Solicitação de Monitoramento

Minhas cargas

Minhas transportadoras

Relatório das minhas viagens

Meu PGR

Cockpit — operação ao vivo

Central de Monitoramento

Painel de Risco

Pendências

Checklist a vencer / vencido

Viagens / SM

Cadastrar veículo

Cadastrar motorista

📊 Score do motorista

Nova SM

Solicitação de Monitoramento

Viagem

Sensores do veículo

Rastro do veículo

Detalhe do incidente

Viagem

Detalhe da SM

Cadastrar rota

Cadastrar cliente

Cadastrar operação

Cadastrar base

Operações da base:

Cadastrar área de risco

Cadastrar PGR