Glossário¶

Termos técnicos e de negócio utilizados no sistema VIG-IA.

Termos de Negócio¶

Termo	Definição
Agravo	Doença ou condição de saúde de notificação compulsória (ex: dengue, meningite, tuberculose)
Boletim	Registro de atendimento de emergência no sistema hospitalar (DTW)
CID	Classificação Internacional de Doenças — código padronizado para diagnósticos médicos
Cenário	Configuração de monitoramento que define quais agravos e estabelecimentos serão vigiados
Evidência	Critério de detecção de agravo: pode ser um CID ou um termo textual encontrado na anamnese
Presumível	Variação de nome ou escrita de um agravo que pode indicar a mesma doença
Desambiguação	Processo de IA para decidir qual agravo priorizar quando múltiplos são detectados
Notificação Compulsória	Obrigação legal de reportar certas doenças às autoridades de saúde
Anamnese	Relato do paciente sobre sintomas e histórico, registrado pelo médico
DNCI	Doenças de Notificação Compulsória Imediata

Termos Técnicos¶

Termo	Definição
DataLake (DTW)	Banco de dados fonte com registros clínicos brutos do hospital
DNCI (banco)	Banco de dados do VIG-IA onde são armazenados os resultados de processamento
Watchdog	Serviço agendado que dispara ciclos de processamento de boletins
Monitor Service	Motor de processamento que analisa boletins e classifica agravos
Maturação	Período de espera (< 2h) antes de processar um boletim recém-criado
Checkpoint	Marcador do último boletim processado, para evitar reprocessamento
Pipeline	Fluxo completo: ingestão DTW → processamento → classificação → dashboard
Heatmap	Mapa de calor que mostra concentração de agravos por bairro
RBAC	Role-Based Access Control — controle de acesso por perfil (admin/operador)
JWT	JSON Web Token — método de autenticação usado pelo sistema
LGPD	Lei Geral de Proteção de Dados — lei brasileira de privacidade
Geocoding	Processo de converter endereço/bairro em coordenadas de latitude/longitude
Open-Meteo	API pública de dados meteorológicos utilizada pelo dashboard de clima

Classificações de Processamento¶

Classificação	Significado
`CID_E_ANAMNESE`	Agravo confirmado: código CID encontrado + evidência na anamnese
`CID_APENAS`	Agravo encontrado: apenas código CID, sem confirmação textual
`SUSPEITA`	Agravo suspeito: IA encontrou evidências textuais na anamnese
`SEM_AGRAVO`	Boletim analisado, nenhum agravo detectado
`REVISAO_PENDENTE`	Múltiplos agravos detectados, aguardando revisão humana

Revisão LLM (CID-only Review)¶

Quando um boletim é classificado como CID_APENAS (tem CID de agravo mas nenhum termo/termo combinado deu match), o sistema submete o texto clínico (anamnese + queixa) para análise pela IA. A IA compara o texto com a descrição do prontuário (gabarito técnico) cadastrada pelo cliente no staging do agravo.

Campo	Valores	Significado
`revisao_llm_tipo`	`CID_ONLY_REVIEW`	Tipo de revisão realizada
`revisao_llm_veredicto`	`CONFIRMADO_IA`	IA encontrou evidência textual que sustenta o agravo
`revisao_llm_veredicto`	`NAO_CONFIRMADO`	IA não encontrou evidência textual no texto clínico
`revisao_llm_confianca`	`0.00` a `1.00`	Nível de confiança da análise
`revisao_llm_justificativa`	texto livre	Explicação da IA sobre a decisão

Termo	Definição
CID-only Review	Processo onde a IA analisa o texto clínico de boletins que só têm match por CID (sem match textual)
Confirmados (IA)	Card no dashboard técnico que mostra quantos casos CID-only foram confirmados pela IA
Descartados (IA)	Card no dashboard técnico que mostra quantos alarmes falsos a IA evitou (Cenário 3 rejeitados)
Gabarito Técnico	Descrição do prontuário (`descricao_prontuario_raw`) cadastrada pelo cliente no staging do agravo, usada como referência pela IA

Status da IA¶

Status	Significado
`APROVADO`	IA confirmou a suspeita de agravo
`REJEITADO`	IA descartou a suspeita (alarme falso evitado)
`NAO_NECESSARIO`	IA não foi necessária (CID já era suficiente)

Ciclo de Vida de Cenários¶

Status	Significado
`rascunho`	Cenário em criação, não está ativo
`ativo`	Cenário em uso pelo processamento
`congelado`	Cenário travado para alterações, com rastreamento de mudanças
`arquivado`	Cenário inativo, mantido para histórico

Perfis de Acesso¶

Perfil	Permissões
`admin`	Acesso total: dashboards + configurações + LGPD + revisão
`supervisor`	Dashboards + revisão IA
`operador`	Apenas visualização dos dashboards