Mapa ao vivoCentral de operações NAVEG

Camadas
Em construção
Esta seção entra em breve na Central de Operações.
Carregando…
Visão geral da operação
Carregando…
Central de Status
Carregando…
MódulosAtive os módulos contratados. Quando um módulo é ativado, ele passa a aparecer no menu do painel. O WhatsApp é o módulo padrão e permanece sempre ativo.
Carregando…
Parâmetros Referência — ainda sem edição pela interface. Os valores abaixo estão fixos no código (fleet_routes.py e demais módulos do hub) e só mudam com deploy.
Alertas de frota (fleet_routes.py — modo OBSERVE)
100 km/h
Excesso de velocidade
06h–20h
Expediente normal
20%
Bateria baixa do rastreador
15 min
Sem comunicação
60 min
Veículo offline
30 min
Parado com motor ligado
Motor ligado fora do intervalo 06h–20h (fuso America/Maceió, UTC-3) gera um alerta de "fora do expediente". A engine só registra essas condições — nenhuma ação é disparada automaticamente sobre o veículo ou o motorista.
Despacho e equipes
Equipes usadas ao Agendar/Reagendar uma O.S. pelo mapa. O ID é o identificador da equipe no IXC.
ID IXC Equipe
3201-EQP-01-JTC
2302-EQP-02-JTC
3703-EQP-03-JTC
3604-EQP-04-JTC
3405-EQP-05-JTC
3106-EQP.01-AAD
Camadas do mapa
Zoom mínimo antes de desenhar os pontos no mapa, para não sobrecarregar o navegador com milhares de marcadores de uma vez.
Camada Zoom mínimo
Clientesz12
Acessosz12
CTOsz12
Cabeamento (FiberDocs)z13
Cache de dados (IXC)
Tempo de vida do cache local dos dados vindos do IXC, para evitar bater no banco do IXC a cada clique no mapa.
Clientes — 10 min Acessos — 3 min CTOs — 10 min Elementos FiberDocs (CEO/splitter/poste/reserva/drop) — 10 min Cabeamento — 10 min
Regra Máxima
Nenhum módulo muda a rede ou o IXC sozinho — tudo é sugestão até um humano confirmar. Por isso Agendar/Reagendar O.S. pelo mapa exige confirmação explícita e é restrito a admin/gestor.
Cores por Status Legenda de referência — significado de cada cor usada nos mapas e cards do Hub e do FiberDocs (somente consulta)

Veículos

Motor ligado
Motor desligado
Sem comunicação
Offline

Ordens de Serviço

Aberta
Deslocamento
Em execução
Reagendada
Sigla Status (sistema) Cor no mapa
A Aberta
AN Em análise
EN Encaminhada
AG Agendada
AS Assumida
DS Deslocamento
EX Em execução
RAG Reagendada

CTOs (ocupação de portas — FiberDocs)

Livre — abaixo de 70% das portas ocupadas
Quase cheia — 70% ou mais ocupada
Lotada — 100% das portas ocupadas

Acessos (rede e FiberDocs)

Login online
Login offline

Cabeamento (FiberDocs)

Fibra (distribuição)
Backbone
Drop (última milha até o cliente)

Fibras (padrão ABNT)

Sequência de 12 cores que se repete a cada 12 fibras dentro do tubo/cabo, usada no diagrama de fusão.
1 Verde
2 Amarelo
3 Branco
4 Azul
5 Vermelho
6 Violeta
7 Marrom
8 Rosa
9 Preto
10 Cinza
11 Laranja
12 Aqua
Permissões Referência de controle de acesso — quem entra em quê (leitura do código atual, não é tela de administração)
Esta página é só de consulta: mostra o que já está implementado nas rotas hoje. Não existe (ainda) uma tela para criar papéis ou editar permissões — qualquer mudança de acesso é feita diretamente no código das rotas.
Acesso às telas
Tela Papéis com acesso O que acontece com os demais
Central de Operações
fleet_hub.html
admin gestor gerencia frota Papel campo é redirecionado para o app do técnico (campo.html). Qualquer outro papel (atendente/user comum, suporte) é redirecionado para fora do hub, para a tela de atendimento/WhatsApp.
FiberDocs
mapa da planta óptica
admin gestor gerencia frota suporte Mesma lista de papéis do hub, mais suporte.
Ações de escrita dentro do hub
Ação Quem confirma Quem só visualiza
Agendar / reagendar O.S. para uma equipe (despacho) admin, gestor gerencia, frota — veem a agenda e as O.S. normalmente, mas não conseguem confirmar o agendamento
Módulo Frota — rotas /api/web/fleet/*
Nível Cobre Papéis
Leitura Consulta de veículos, rastreadores, motoristas, geofences, manutenção, combustível. admin, gestor, frota, noc, gerencia
Escrita / cadastro Cadastrar/editar veículos, rastreadores, motoristas, geofences, manutenção, combustível. admin, gestor, frota
Comando ao rastreador Envio real de comando (GPRS/SMS) via Central de Comando — sai da plataforma direto para o equipamento em campo. admin, gestor (somente)
Regra Máxima: o envio de comando ao rastreador é o ponto mais sensível do módulo — fica restrito a admin e gestor porque exige validação humana explícita antes de qualquer coisa sair para o equipamento. Nenhum módulo de inteligência da plataforma age sozinho sobre a rede ou os dispositivos.
Chaves / Integração Referência somente leitura — quais integrações externas o hub usa, onde cada uma é configurada
Por segurança, nenhum valor de chave ou token é exibido aqui — apenas onde cada um está configurado.
Mapas
Google Maps JavaScript API
constante no HTML localStorage.naveg_gmaps_key
Usada na renderização dos mapas do hub e do FiberDocs. Escolha o provedor do mapa e, se usar o Google, cole a API key abaixo.
Provedor do mapa
Automático: usa o Google quando o faturamento estiver ok e cai para o OpenStreetMap (grátis, sem chave) se o Google falhar. Ao reativar o billing, o Google volta a ser priorizado sozinho.
Chave em uso: —
Ao salvar, a página recarrega e passa a usar a chave nova. Dica: no Google Cloud, restrinja a chave (por referrer + só Maps JavaScript API) e ative um alerta de orçamento.
IXC / ERP
conn_gateway (porta 8090)
variável de ambiente: CONN_TOKEN variável de ambiente: CONN_URL
Única ponte read-only para o banco de dados do IXC (ERP da NAVEG). O hub e o FiberDocs nunca acessam o IXC diretamente — sempre passam por este gateway, que roda em outro servidor interno.
Dados trafegados: consultas read-only ao IXC.
Config: autenticação por token compartilhado em CONN_TOKEN (servidor), enviado no cabeçalho X-Conn-Token; endereço do gateway configurável via CONN_URL.
Rastreamento GPS
Ingestão de posições GPS
variável de ambiente: INGEST_TOKEN
O gateway dos rastreadores (processo Node, gerenciado via pm2) envia as posições dos veículos para o endpoint de ingestão do hub.
Dados trafegados: posições GPS dos veículos.
Config: autenticado por token de ingestão em INGEST_TOKEN — a mesma variável usada pelos demais módulos de ingestão do NOC.
Central de Comando — envio ao rastreador
variável de ambiente: FLEET_CONTROL_URL variável de ambiente: FLEET_CONTROL_TOKEN
Canal de controle HTTP local próprio, usado pela Central de Comando para enviar comandos ao rastreador.
Dados trafegados: comandos emitidos pela Central de Comando.
Config: endereço em FLEET_CONTROL_URL (padrão aponta para a porta 5056 da própria máquina); token próprio em FLEET_CONTROL_TOKEN.
SMS — alternativa de envio Sem provedor configurado — inativo
Canal alternativo, usado quando o rastreador não tem dados móveis ativos no momento.
Módulo plugável: sem provedor configurado, fica seguro e inativo — não tenta enviar nada e não falha silenciosamente.
Notificações
Alerta crítico — WhatsApp / Telegram / webhook Opt-in — desativado até configurar
Módulo separado que dispara notificação de alerta crítico para WhatsApp, Telegram ou webhook.
Config: opcional (opt-in), habilitado por variável de ambiente. Sem nada configurado, simplesmente não dispara.
Armazenamento
Catálogo — veículos / motoristas / geofences SQLite
Banco compartilhado com o restante do NOC, no mesmo servidor que roda o hub.
Telemetria — posições / eventos / alertas / comandos SQLite
Banco próprio e dedicado do módulo Frota, no mesmo servidor que roda o hub.
Ajuda Guia rápido da Central de Operações — conteúdo de referência e estático, não é um painel ao vivo
Regra máxima da plataforma: nenhuma ação muda a rede ou o sistema da empresa sozinha. Tudo o que grava alguma coisa — como agendar ou reagendar uma O.S. — passa por confirmação humana antes de valer.
Navegando pelo menu
O menu lateral à esquerda é retrátil — use a seta no topo da barra para recolher ou expandir. Ele é organizado em 4 grupos:
Operação
Mapa ao vivo
Agenda de serviços
Roteirização
Alertas
Frota
Veículos
Rastreadores
Motoristas
Manutenção
Combustível
Dados
Dashboards
Ordens de Serviço
Clientes
Acessos / Rede
FiberDocs
Sistema
Central de Status
Configurações (Parâmetros, Cores por status, Permissões, Chaves / Integração)
Ajuda
Usando o mapa ao vivo
  • Veículos aparecem como um ícone com seta indicando a direção; anéis pulsantes ao redor do ícone indicam que o rastreamento está ao vivo.
  • Ordens de Serviço aparecem como um pino colorido conforme o status da O.S.
  • No topo do mapa há chips de camada para ligar/desligar Clientes, Acessos e outras camadas extras.
  • Clicar em qualquer item do mapa (veículo, O.S. ou outra camada) abre um cartão lateral com os detalhes e as ações disponíveis para aquele item.
Cartão do veículo e cartão da O.S.
Cartão do veículo
Duas abas:
Detalhes: dados do rastreador e do motorista vinculado.
O.S. do técnico: ordens de serviço do dia vinculadas ao motorista/técnico daquele veículo, com filtro de data.
Cartão da Ordem de Serviço
Mostra status, cliente e técnico responsável. Permite Agendar ou Reagendar a O.S. para a equipe mais próxima.
Agendando ou reagendando uma O.S.
1No mapa, clique no pino da O.S. desejada.
2No cartão lateral, confira status, cliente e técnico responsável.
3Use "Agendar" ou "Reagendar" para direcionar à equipe mais próxima — ação restrita a perfis admin/gestor.
4Confirme na caixa de diálogo — nada é gravado no sistema da empresa sem essa confirmação.
Reagendar segue a mesma lógica, apontando para outra equipe/horário.
Agenda de serviços e Roteirização
  • Agenda de serviços: quadro visual organizado por colaborador/técnico, um dia por vez. Use as setas para navegar entre dias.
  • Roteirização: painel que desliza a partir da esquerda do mapa para montar uma rota otimizada entre vários pontos de um dia/equipe.
Trocando o tema
O botão de tema fica no rodapé do menu lateral. Alterna entre claro e escuro, e a escolha fica salva entre sessões neste navegador.
FiberDocs em poucas palavras
É o mapa da planta de fibra óptica: caixas de atendimento dos clientes, caixas de emenda, cabos e splitters. Cada caixa de emenda ou caixa de atendimento tem um diagrama clicável que mostra a fusão fibra a fibra dentro dela.
Precisa de ajuda?
Fale com o time de TI/NOC responsável pela Central de Operações.