VIG-IA — Vigilância em Saúde por Inteligência Artificial¶

🚑 Sistema de Monitoramento de Agravos de Notificação Compulsória

Monitoramento automatizado de boletins de emergência em tempo real,
com detecção de agravos e insights epidemiológicos apoiados por IA.

O que é o VIG-IA?¶

O VIG-IA é um sistema de vigilância epidemiológica automatizada que:

🔍 Monitora boletins de emergência em tempo real a partir do DataLake hospitalar
🦠 Detecta agravos de notificação compulsória (dengue, meningite, tuberculose, etc.)
🤖 Analisa textos clínicos com Inteligência Artificial (OpenAI GPT-4o-mini)
📊 Gera dashboards interativos com KPIs epidemiológicos, mapas e tendências
🔒 Audita todas as ações em conformidade com a LGPD

Para quem é este manual?¶

Perfil	O que vai encontrar
Operador	Como usar os dashboards, interpretar dados, exportar relatórios
Administrador	Como gerenciar cenários, usuários, agravos e revisar desambiguações da IA
TI / DevOps	Como fazer deploy, configurar, atualizar e resolver problemas

Componentes do Sistema¶

O VIG-IA possui 4 componentes principais, todos containerizados com Docker:

graph LR
    subgraph Docker Compose
        D["🖥️ Dashboard<br/>FastAPI + SPA<br/>Porta 5000"]
        W["⚡ Watchdog<br/>Processamento<br/>contínuo"]
        C["🌤️ Clima Job<br/>Coleta diária<br/>Open-Meteo"]
        M["📘 Manual<br/>Este site<br/>Porta 5001"]
    end

    U["👤 Usuário"] --> D
    U --> M

    subgraph Bancos de Dados
        DNCI["🗄️ PostgreSQL DNCI<br/>Leitura/Escrita"]
        DTW["🗄️ PostgreSQL DTW<br/>Somente Leitura"]
    end

    D --> DNCI
    D --> DTW
    W --> DNCI
    W --> DTW
    C --> DNCI

    subgraph APIs Externas
        OAI["🤖 OpenAI"]
        OM["🌡️ Open-Meteo"]
        GM["🗺️ Google Maps"]
    end

    W --> OAI
    C --> OM
    D --> GM

Componente	Tecnologia	Descrição
Dashboard	FastAPI + HTML/JS/CSS	Interface web com 9 dashboards + LGPD + Revisão IA
Watchdog	Python + psycopg2	Serviço de processamento contínuo de boletins
Clima Job	Python + httpx	Coleta diária de dados climáticos (Open-Meteo)
Manual	MkDocs Material + nginx	Este manual de operações (você está aqui!)

Dashboards Disponíveis¶

Dashboard	Ícone	Descrição
DataLake	🗄️	Visão crua do pipeline — total DTW, processados, pendentes, status do watchdog
Técnico	⚙️	Métricas de processamento, matriz de auditoria, log de execução
Saúde	🩺	KPIs epidemiológicos, ranking CIDs, lista de casos, filtro por estado do paciente
Mapa	🗺️	Google Maps com marcadores por unidade e heatmap por bairro
Explorador	🔬	Árvore de agravos, presumíveis e evidências (read-only)
Clima	🌤️	Histórico climático, previsão 7 dias, correlação clima × agravos
Cenários	📋	CRUD de cenários de monitoramento com versionamento
LGPD	🛡️	Auditoria de ações — KPIs, timeline, purga automática
Revisão IA	🔍	Fila de desambiguação — aceitar/rejeitar agravos com baixa confiança

Acesso Rápido¶

Guia do Operador

Aprenda a usar os dashboards, filtros, exports e visualizações.

Começar
Guia do Administrador

Gerencie cenários, usuários, agravos e revisões de IA.

Administrar
Deploy e Infraestrutura

Docker, configuração, migrações e troubleshooting.

Deploy
Referência da API

Documentação completa dos 45+ endpoints REST.

API

Versão Atual¶

v2.8.0 — Fase 2 Sprint 8 (Relatórios com Versionamento)

Consulte o Changelog completo para o histórico de versões.