🧭 Indicadores CAPS — Versão 5.0

📌 Monitoramento e Gestão de Metas em Saúde Mental (✅ Variável 2 | 🌙 Variável 3)

1) 👋 Visão geral (o que é isso, na prática)

O Indicadores CAPS 5.0 é um programa de computador (Windows, .exe) feito pra ajudar a unidade a importar relatórios oficiais do PCSM, calcular indicadores automaticamente e gerar saídas prontas (texto + planilhas) para gestão do dia a dia.

Ele foi pensado pra rotina real:
você carrega os relatórios → ajusta metas → clica em calcular → sai o material pronto. ✅

🎯 Pra que ele serve (sem mistério)

Ele te ajuda a:

• 📥 Importar relatórios do PCSM (vários formatos, com leitura robusta)

• ✅ Calcular a Variável 2 (rotina diária / cobrança do dia a dia)

• 🌙 Calcular a Variável 3 (quando der — é possível, mas ainda é “projeto de futuro”)

• 📲 Gerar texto pronto pro WhatsApp (com emojis e linguagem de coordenação)

• 📊 Gerar planilhas por profissional com pendências destacadas

• 🗃️ Salvar histórico diário em SQLite pra ver evolução e gráfico ao longo do tempo

2) 🧠 A lógica do programa (tipo receita)

Funciona assim:

1. 📌 Importa os relatórios do PCSM

2. 🎛️ Configura metas da unidade (quando necessário)

3. ✅ Clica em Calcular Indicadores (Variável 2)

4. 🌙 Se quiser, clica em Calcular Variável 3

5. 📦 O programa entrega:

   • 📝 Um texto completo pronto pra colar no WhatsApp

   • 📊 Excel por profissional com pendências e organização

   • 📈 Histórico salvo pra analisar tendência e evolução

Resumo: tirou o trabalho braçal da tua equipe e transformou em “painel de comando”. 🕹️📊

3) ⭐ O que mudou na versão 5.0 (comparado à 4.4.1)

🌙 Variável 3 ganhou um painel completo (e ficou “de verdade”)

• Coluna nova: “Variável 3 – Indicadores Específicos”

• Seleção de competência (mês/ano) (principalmente pro Rel. 307)

• Seleção do tipo de serviço: CAPS Adulto / CAPSi

  • Ativa Rel. 181 (escola) só quando faz sentido (CAPSi)

✅ Botões dedicados para importação:

• Rel. 121 — Comorbidades (HAS/DM)

• Rel. 160 — Gestantes (com integração do Rel. 95 quando disponível)

• Rel. 180 — Vacinação

• Rel. 149 — Notificações TB (SINAN)

• Rel. 151 — Situação de Rua

• Rel. 181 — Inserção/Permanência Escolar (CAPSi)

• Rel. 307 — Lesão Autoprovocada/Tentativa

🎯 Botão “Calcular Variável 3”:

• junta o que foi carregado,

• calcula UC por componente,

• gera texto consolidado,

• e pode gerar planilhas auxiliares (quando aplicável).

4) ✅ Relatórios — ponto IMPORTANTÍSSIMO (pra não ter dúvida)

Todos os relatórios importados são importantes.
Não é “só 166/20/12/277/18”. Esses são a base mais óbvia, mas o programa foi pensado como sistema completo.

✅ Variável 2 (CORE / dia a dia / cobrança real)

Os relatórios abaixo alimentam os cálculos, rankings, planilhas e textos operacionais:

📌 Base e procedimentos:

• 166 — Pacientes Ativos

• 20 — RAAS

• 12 — BPA-I

• 277 — BPA-C

📌 Gestão de cuidado / pendências / organização:

• 193 — Pacientes sem PTS

• 293 — Completude Cadastral

• 156 — CID

• 282 — Reinserção Produtiva

📌 Território / rede / acompanhamento:

• 0007 — Busca Ativa

• 153 — Unidades Matriciadas

📌 Situações específicas que impactam leitura e gestão:

• 18 — Pacientes em Instituição

• 112 (quando usado como complemento)

• 148 — Internações Psiquiátricas

✅ Moral da história: no padrão certo, é tudo.
Se tiver correria, dá pra rodar com menos — mas o “modo ideal” é completo.

🌙 Variável 3 (sonho possível, mas não é a cobrança diária)

• 121, 149, 151, 160(+95), 180, 181(CAPSi), 307
  Ela entra como um “painel extra” pra quando der estrutura e tempo.

5) 🧩 Instalação e execução (versão do mundo real)

✅ Opção recomendada: Setup (instalador)

• Você instala e ele já deixa tudo organizado, com atalho e dependências quando necessário.

✅ Execução por .exe

• Roda sem precisar de Python instalado.

• Espera o splash (0–100%).

• Abre a janela principal.

🧪 Execução por código (opcional)

Pra rodar o app.py diretamente:

• Python 3.x + dependências (pandas, openpyxl, ttkbootstrap, matplotlib, etc.)

6) 🖥️ Interface do programa (o mapa da tela)

A tela é dividida em três áreas:

🟦 Coluna esquerda — ✅ Variável 2 (importação base)

Botões de importação + status (carregado? quantos registros? resumo rápido).

🟪 Coluna direita — 🌙 Variável 3 (importação específica)

Competência (mês/ano), tipo de serviço, botões de relatórios e status.

🟩 Centro — Painel de saída e ações

• ✅ Calcular Variável 2

• 🌙 Calcular Variável 3

• 📲 Copiar relatório pro WhatsApp

• 📊 Planilhas por profissional / ranking / gráficos / histórico

• 🔍 Clínicas de Família / CMS (usa clinicas_familia.json)

7) 🚶 Passo a passo de uso (modo “não tem como errar”)

✅ Rotina padrão (Variável 2)

1. Importa 166 primeiro (sempre)

2. Importa 20, 12, 277

3. Importa os de “gestão de pendências”: 193, 293, 156, 282

4. Importa os complementares: 18/112, 148, 0007, 153

5. Clica Calcular Variável 2

6. Copia o texto e manda na coordenação 😎📲

🌙 Rotina opcional (Variável 3)

1. Define competência (mês/ano)

2. Importa os relatórios específicos

3. Clica Calcular Variável 3

4. Copia o texto / confere as listas auxiliares

8) 📦 Arquivos que o programa cria (pra você saber onde tá tudo)

• resultado.txt — relatório final (texto pronto)

• historico_indicadores.db — histórico (SQLite)

• clinicas_familia.json — lista de unidades AB (matriciamento)

• indicadores_config.json — metas e parâmetros

• pastas na Área de Trabalho (demandas por profissional, buscas, procedimentos etc.)

9) ⚠️ Observações importantes (pra não dar dor de cabeça)

• CSV do PCSM pode vir com ; e codificação latin-1/utf-8 — o programa tenta ser robusto

• Sempre começar pelo Rel. 166, porque muita coisa depende dele

• Se mudar layout do PCSM forte demais, pode precisar ajuste no código

• Se der erro: confirmar se o arquivo é realmente daquele relatório + se não tá aberto no Excel

Se você quiser deixar isso ainda mais “cara de produto” 😮‍💨🔥, eu posso transformar esse texto em:

• texto de abertura tipo “apresentação de sistema” (bem curto e impactante),

  • um bloco técnico (com os relatórios e suas finalidades),

  • um bloco operacional (checklist do dia a dia),

  • um bloco de solução de problemas (erros mais comuns e como resolver).

Mas, do jeito que está agora, tá coerente, completo e alinhado com a tua realidade:
✅ Variável 2 é a cobrança e rotina.
🌙 Variável 3 é um sonho possível, mas não é o core do dia a dia.