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
—

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
—

Saúde do sistema

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

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)

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

Escoltas

Empresa	Contato	Telefone	Responsável	Ativa
—

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	Ativa
—

Áreas de Risco

Áreas de risco da GR (independentes de rota). Quando o motor de eventos existir, um caminhão entrando na área dispara a reação escolhida. Hoje você cadastra; o disparo é pós-integração.

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

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
—

Usuários

Username	Nome	Papel	Nível	Transportadora
—

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
—

Central de Monitoramento

—

Clique numa viagem para ver no mapa o rastro percorrido.

Painel de Alertas

demonstração

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:

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)

Saúde do sistema

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)

Escoltas

Pronta Resposta

Acionamentos

Iscas

Áreas de Risco

PGR — Planos de Gerenciamento de Risco

Reações a eventos

Usuários

Permissões por nível

Bases de monitoramento

Operações

Rotas

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

Central de Monitoramento

Painel de Risco

Pendências

Checklist a vencer / vencido

Viagens / SM

Cadastrar veículo

Cadastrar motorista

Nova SM

Solicitar viagem

Viagem

Sensores 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

Faixas do PGR:

Cadastrar usuário

Cadastrar reação

Cadastrar agente

Cadastrar item

Cadastrar escolta

Cadastrar isca