🛡️ Sentinel - Automação e Monitoramento de Infraestrutura

O Sentinel é uma aplicação web Flask para automação, consulta e monitoramento de infraestrutura do Grupo GPS. O sistema centraliza regionais, servidores, links, switches, firewalls, VPNs, certificados, relatórios e rotinas operacionais em uma interface web única.

O projeto roda principalmente em Windows, com Flask servido via Waitress, configurações locais em JSON e integrações com FortiManager, FortiAnalyzer, Zabbix, UniFi, Microsoft Graph, Active Directory e portais internos.

🚀 Visão Geral

• 🌐 Aplicação web principal: web_config.py
• ⚙️ Entrada do serviço web: run_web_service.py
• 🔌 Porta padrão: 5000
• 🧩 Templates: templates/
• 🎨 Arquivos estáticos: static/
• 📁 Dados locais/runtime: data/, output/, logs/
• 🔐 Configurações sensíveis: environment.json (não deve ir para o Git)
• 🏢 Estrutura das regionais: estrutura_regionais.json (não deve ir para o Git)

📚 Documentação de Apoio

Além deste README principal, o projeto tem documentos específicos para operação, configuração e manutenção:

• 📘 Guia de Configuração - configuração geral do ambiente.
• 🔐 README de Autenticação - autenticação e controle de acesso.
• 🧱 Estrutura V2 - organização da estrutura hierárquica.
• 🛡️ Guia de Segurança - cuidados com credenciais e arquivos sensíveis.
• 🧪 Guia JR Homologação - fluxo de homologação.
• 🏭 Ambientes Produção/Homologação - operação entre ambientes.
• 📦 Guia de Compilação EXE - empacotamento/compilação.
• 📝 Changelog - histórico de mudanças.
• 📁 Docs - documentação complementar na pasta docs/.

Observação: arquivos pessoais de contexto para IA, como COPILOT_CONTEXT.md, devem ficar somente locais e não devem ser versionados.

🧭 Funcionalidades Principais

🏢 Regionais

• Cadastro e visualização de regionais.
• Servidores, VMs, links, switches, firewalls e dados operacionais agrupados por regional.
• Contadores clicáveis para filtrar regionais com/sem servidores, links, switches e firewalls a vencer.
• Detalhes por regional com seções de servidores, links, switches, firewalls e ações operacionais.
• Tela principal em /regionais.
• Detalhe individual em /regional/<codigo>.
• Botões de preventiva por grupo: servidores, switches, firewalls e relatório consolidado da regional.
• Botão de preventiva geral para gerar relatórios individuais por dispositivo e entregar em arquivo ZIP.

🗺️ Mapa de Monitoramento

• Tela dedicada em /mapa, acessível pelo menu de Infraestrutura.
• Exibe mapa do Brasil com pontos por regional e painel lateral de alertas.
• Atualização periódica para uso em monitoramento operacional.
• Destaque visual por criticidade:
  • Crítico: itens offline que exigem ação.
  • Atenção: alertas operacionais como warnings.
  • Normal: regionais sem alerta acionável.
• Tooltips automáticos para regionais com problemas.
• Clique em estado, regional, bolinha ou tooltip para filtrar e abrir detalhes.
• Inativos/desabilitados propositalmente não devem ser tratados como alerta acionável.

🖥️ Servidores e VMs

• Monitoramento de servidores regionais.
• Consulta de status, serviços e informações de VMs.
• Relatórios simples e completos.
• Dados organizados em estrutura hierárquica por regional.

🌐 Links de Internet

• Consulta e exibição de links por regional.
• Sincronização manual com FortiManager/FortiGate.
• Identificação de interfaces WAN, IPs públicos, provedores, velocidades e status.
• A sincronização automática ao abrir a tela de regionais foi desativada para reduzir consumo de API.
• Suporte a aliases de regionais renomeadas para manter links antigos associados corretamente.
• Botões de teste e atualização usam feedback visual com load flutuante.

🔥 Firewalls

• Tela em /firewalls.
• Consulta FortiGates via FortiManager.
• Exibe status, modelo, serial, versão da firmware e licenças FortiCare.
• Licenças usam regra operacional por status: OK, a vencer, expirada e sem sinal.
• A tela de mapa considera como alerta acionável apenas licenças expiradas ou a vencer.
• Usa cache local por até 60 minutos para reduzir chamadas repetidas ao FortiManager.
• O botão Atualizar Forti força nova consulta em tempo real.

👤 Monitor de Admins

• Tela em /admin-logins.
• Compara usuários administradores atuais com a baseline aprovada em admin_baseline.json.
• Consulta FortiManager, FortiGates via proxy do FortiManager, FortiAnalyzer e logs administrativos.
• Usa cache local por até 30 minutos.
• O botão Atualizar Forti força nova consulta.

🔌 Switches

• Tela em /switches.
• Integração com Zabbix.
• Consulta status de switches, alertas e organização por regional.
• Diferencia online, offline, warning e inativo.
• Itens inativos/desabilitados não devem entrar como alerta crítico no mapa operacional.
• Usa gerenciar_switches.py e planilha/configuração definida no ambiente.

🔐 VPN IPsec

• Tela em /vpn-ipsec.
• Exibe túneis VPN agrupados por regional.
• Dados obtidos via FortiManager/FortiGate.
• Mapeamento por regional revisado para evitar túneis aparecendo em unidades incorretas.

📡 Antenas UniFi

• Telas de antenas UniFi e dashboards relacionados.
• Coleta por Unifi.Py.
• Agrupamento por site/regional.
• Exibe status de APs, usuários conectados, modelo, firmware e informações operacionais.
• A visão de interferência/co-canal 5GHz foca em APs com Atenção ou Crítico.
• Há atualização manual das antenas para recarregar status, modelo e dados operacionais.

📜 Certificados

• Telas de validade de certificados.
• Relatórios e templates para acompanhamento de certificados e discos.
• Exemplo de template: templates/certificate_disk_report_acrab.json.

📊 Relatórios e Rotinas

• Dashboard consolidado por executar_tudo.py.
• Relatórios de infraestrutura.
• Dashboard preview em output/dashboard_preview.html usado para homologação visual.
• Checklist consolidado com visão por dispositivo e visão por regional/mapa.
• Preventivas por regional e por tipo de dispositivo.
• Relatórios preventivos individuais por dispositivo empacotados em ZIP.
• Rotinas de replicação AD.
• Capturas de portais internos, GPS Amigo, Saturno e AppGate.
• Envio de e-mails via Microsoft Graph.

🤖 SofIA

• Assistente virtual integrada ao Sentinel.
• Módulo em sofia/.
• Ativação por environment.json:

"sofia": {
  "enabled": true
}

• A SofIA atualmente usa regras determinísticas, sem LLM externo.
• Ela responde sobre regionais, servidores, switches, links, VPNs, Zabbix e dashboard com base nos dados já carregados pelo Sentinel.

🧱 Arquitetura

Automacao/
|-- web_config.py                  # Aplicação Flask principal
|-- run_web_service.py             # Inicialização Waitress
|-- config.py                      # Caminhos e carregamento do environment.json
|-- environment.example.json       # Exemplo seguro de configuração
|-- environment.json               # Configuração real local, não versionada
|-- estrutura_regionais.json       # Regionais reais, não versionado
|-- fortimanager_client.py         # Cliente FortiManager JSON-RPC
|-- fortianalyzer_client.py        # Cliente FortiAnalyzer JSON-RPC
|-- gerenciar_regionais.py         # Cadastro/estrutura de regionais
|-- gerenciar_switches.py          # Integração Zabbix/switches
|-- gerenciar_vms.py               # Rotinas de VMs
|-- executar_tudo.py               # Dashboard consolidado
|-- gps_print.py                   # Capturas de portais
|-- sofia/                         # Assistente SofIA
|-- docs/                          # Documentacao e backlog operacional
|-- templates/                     # Templates HTML/Jinja2
|-- static/                        # CSS, JS, imagens e branding
|-- data/                          # Dados gerados em runtime
|-- output/                        # HTMLs, caches e relatórios
|-- logs/                          # Logs da aplicação

⚙️ Configuração

1. Copie ou gere um environment.json a partir de environment.example.json.
2. Configure credenciais e hosts dos sistemas usados:
   • Zabbix
   • FortiManager
   • FortiAnalyzer
   • UniFi
   • Microsoft Graph
   • Portais internos
3. Garanta que environment.json, estrutura_regionais.json, admin_baseline.json e arquivos com IPs/senhas continuem fora do Git.

Arquivos sensíveis já devem estar protegidos no .gitignore.

▶️ Execução Local

Instale dependências:

pip install -r requirements.txt

Inicie/reinicie o serviço web:

.\restart_web_service.ps1

Ou execute diretamente:

python run_web_service.py

Acesse:

http://localhost:5000

📊 Dashboard Consolidado

python executar_tudo.py

Para rodar sem abrir navegador:

python executar_tudo.py --no-browser

O dashboard consolidado gera arquivos em output/ e também em pastas públicas configuradas em config.py.

O preview visual do dashboard pode ser acessado pelo Sentinel quando o arquivo output/dashboard_preview.html existir. Ele é usado para validar layout e navegação antes de aplicar mudanças no checklist oficial.

🧾 Preventivas

As preventivas são relatórios operacionais gerados a partir dos dados já coletados pelo Sentinel.

• Gerar Relatório: consolida servidores, links, switches e firewalls da regional.
• Preventiva Servidores: gera visão focada apenas nos servidores da regional.
• Preventiva Switches: gera visão focada apenas nos switches da regional.
• Preventiva Firewalls: gera visão focada apenas nos firewalls/licenças da regional.
• Preventiva geral: gera relatórios individuais por dispositivo e compacta o resultado.

Os arquivos gerados ficam organizados em output/preventivas/ por ano, mês e dia.

🧯 Cache e Consumo de API Forti

Para reduzir consumo no FortiManager/FortiAnalyzer:

• /firewalls usa cache por até 60 minutos.
• /admin-logins usa cache por até 30 minutos.
• Os botões Atualizar Forti forçam consulta em tempo real.
• A sincronização automática de links ao abrir regionais foi desativada.
• A sincronização de links continua disponível manualmente.
• O mapa de monitoramento deve reaproveitar cache operacional e atualizar somente o necessário.
• O checklist diário continua sendo uma fotografia consolidada do horário programado.

Isso mantém as consultas funcionando, mas evita chamadas repetidas a cada navegação.

🔒 Segurança

• Nunca commitar environment.json.
• Nunca commitar estrutura_regionais.json com IPs reais.
• Nunca commitar admin_baseline.json se contiver usuários reais sensíveis.
• Evitar expor tokens, senhas, API keys e client secrets em código.
• Revisar git status antes de cada commit.

🧾 Logs e Diagnóstico

Locais principais:

• logs/web_service.log
• logs/sofia_audit.jsonl
• logs/certificados.log
• output/dashboard_*_cache.json
• output/status_atualizacao.json

Comandos úteis:

git status
python -m py_compile web_config.py
python tools/manual/verificar_dependencias.py

🛠️ Observações Operacionais

• O Waitress não faz auto-reload: após alterar backend, reinicie o serviço.
• Alterações em templates geralmente exigem recarregar a página.
• Rotas que consultam Forti podem demorar dependendo da quantidade de dispositivos.
• O cache foi criado para aliviar consumo de API sem remover as consultas.

✅ Status Atual do Projeto

O Sentinel hoje é uma plataforma interna de automação de infraestrutura com foco em:

• Operação regional
• Monitoramento de rede
• Mapa Brasil para acompanhamento operacional
• Inventário e status de firewalls
• Controle de admins Forti
• Links, VPNs e switches
• Antenas UniFi e interferência 5GHz
• Preventivas por regional e por dispositivo
• Certificados e relatórios
• Assistente SofIA integrada

O projeto segue em evolução e deve priorizar mudanças incrementais, mantendo compatibilidade com os dados locais e rotinas já existentes.