Indicadores CAPS – Versão 4.4.1 Monitoramento e Gestão de Metas em Saúde Mental 1. Introdução O Indicadores CAPS 4.4.1 é uma aplicação desktop (Windows, formato .exe) desenvolvida em Python com interface gráfica em Tkinter + ttkbootstrap. Ele foi pensado para gestores e equipes de CAPS que usam o PCSM e precisam: Importar relatórios oficiais (RAAS, BPA-I, BPA-C, 166, 193, 293, 156, 282 etc.). Calcular automaticamente indicadores operacionais com metas (Atendimento Familiar, Reabilitação Psicossocial em instituição, Matriciamento, Busca Ativa, Atendimento Individual, Completude Cadastral…). Gerar relatórios textuais prontos para WhatsApp (com emojis). Produzir planilhas Excel por profissional, com destaque das pendências. Manter um histórico diário em banco SQLite, com visualização gráfica da evolução dos indicadores. A lógica é: você importa os relatórios do PCSM, configura metas, clica em Calcular Indicadores e o programa entrega: Um texto completo, pronto para colar em grupo de coordenação. Arquivos Excel com demandas organizadas por profissional. Indicadores salvos num histórico para análise gráfica ao longo do tempo. 2. Novidades da Versão 4.4.1 Em relação às versões anteriores (2.x / 4.x), a 4.4.1 traz: 🕵️ Modo Sigiloso para profissionais Pergunta se você deseja ocultar nomes de profissionais ao gerar o relatório. Quando ligado, os nomes aparecem como: Profissional #01, Profissional #02… Útil para compartilhar indicadores sem expor nominalmente a equipe. 📊 Integração com Relatório 156 – CID Leitura do Rel. 156 (CID), somando: Total de pacientes com CID. Total de pacientes sem CID. Esses valores entram diretamente no relatório de indicadores, na parte do Atendimento Individual. 🧱 Integração com Relatório 282 – Reinserção Produtiva Leitura do Rel. 282, com seleção do CAPS de interesse. Conta, para o CAPS escolhido: Total de casos em Reinserção Produtiva. Quantos estão “Em acompanhamento”. Quantos estão em “Busca Ativa”. Esses números também entram no relatório final, junto da seção de AI. 📋 Novo indicador de Completude Cadastral (Rel. 293) Importa o Relatório 293 e calcula, para os pacientes ativos: Quantos estão com cadastro “ok”. Quantos têm pendências em campos-chave: Benefício (se tem / qual tipo). Gênero. Tipo de moradia. Permite gerar: Um resumo textual de completude. Um gráfico de pizza + barras mostrando percentuais e quais campos mais faltam. 🧮 Procedimentos por profissional (RAAS / BPA-I / BPA-C) Botão “Procedimentos (RAAS/BPA)”: Consolida procedimentos de RAAS, BPA-I e BPA-C. Gera uma pasta/arquivo Excel por profissional com aba própria. Destaca em vermelho: Pacientes sem PTS. Pacientes em instituição sem RP/BA. Pendências de completude (Rel. 293) quando disponível. Garante escrita segura para o Excel (limpando caracteres que quebram o XLSX). 🧷 Ranking TOP20 de pendências Botão “Ranking TOP20”: Cria um ranking dos profissionais com maior número de pendências combinadas: Pacientes sem PTS. Pacientes institucionalizados sem RP/BA. Pendências de completude cadastral. Gera texto pronto para discussão em equipe (e Excel de apoio). 🧩 Reestruturação da Reabilitação Psicossocial (Instituição) Amarra corretamente: Pacientes do Rel. 18 – Instituição. Registros de RP no RAAS (Rel. 20). Registros de Busca Ativa no RAAS e no Rel. 112 – BA realizada no período. O indicador considera o conjunto RP OU BA (RAAS/112), evitando contagens duplicadas, e exibe: Quantos institucionalizados têm registro. Quantos ainda não têm. 📈 Histórico aprimorado de indicadores Banco historico_indicadores.db atualizado para armazenar: Ativos, institucionalizados com registro, AF, Matriciamento, BA, Sem PTS, AI, internações etc. Novas colunas para completude, CID e Reinserção Produtiva (quando disponíveis). Tela de Histórico / Gráficos permite: Visualizar série temporal por indicador (diário, semanal, mensal). Ver metas, médias móveis e excluir registros do histórico se necessário. 🧼 Leitura mais robusta de CSV Auto-detecção de cabeçalhos em relatórios 156, 282, 293 e RAAS. Limpeza automática de caracteres invisíveis que quebravam o Excel. 3. Instalação e Execução 3.1. Versão .exe (recomendada) Baixe o arquivo Indicadores_CAPS_4.4.1.exe (ou nome equivalente) a partir do Zenodo. Coloque o .exe em uma pasta de sua preferência (idealmente junto dos arquivos auxiliares, como vídeo/GIF do splash, se fornecidos). Dê duplo-clique para executar em qualquer máquina Windows. Não é necessário ter Python instalado. Aguarde a tela de splash completar (0–100%). Ao final, a janela principal é exibida. 3.2. Execução via código fonte (opcional) Se preferir rodar o .py diretamente: Requer Python 3.x e os pacotes principais: tkinter, ttkbootstrap matplotlib pandas openpyxl sqlite3 Instale as dependências (pip install ...) e execute: python Indicador.py 4. Tela de Splash Exibe um vídeo/GIF em loop (ex.: CAPS.mp4) com: Barra de progresso de 0% a 100%. Mensagens de carregamento em tom leve e motivador. Quando o carregamento termina, a janela principal é aberta. 5. Estrutura da Interface A janela principal é organizada em blocos: Banner Superior Faixa degradê animada com o título: Indicadores CAPS – Bora Bater Meta Gente! Painel de Importação de Relatórios (lado esquerdo) Botões para cada relatório do PCSM: Pacientes Ativos – Rel. 166 RAAS – Rel. 20 BPA-I – Rel. 12 BPA-C – Rel. 277 Internações Psiquiátricas – Rel. 148 Pacientes em Instituição – Rel. 18 Com opção de complementar via Rel. 112 – BA realizada no período. Busca Ativa – Rel. 0007 Unidades Matriciadas – Rel. 153 Pacientes sem PTS – Rel. 193 Completude Cadastral – Rel. 293 Relatório 156 – CID Relatório 282 – Reinserção Produtiva Ao lado de cada botão, um label de status mostra: Se o arquivo foi carregado. Quantos registros foram lidos. Resumos importantes (ex.: “156 (CID): com X | sem Y”, “282: CAPS X – Total N (Acomp. A | Busca B)”). Painel de Indicadores Gerais Campos que mostram: Total de pacientes ativos. Totais de RAAS, BPA-I e BPA-C. Resumo de institucionalizados com RP/BA. Resumo de completude, CID e reinserção produtiva (quando carregados). Painel de Ações / Botões Principais Alguns dos botões disponíveis: 🏆 Calcular Indicadores ⭐ Copiar Relatório (para a área de transferência, formato WhatsApp). 🥇 Configurar Metas (ABP, RP, BA, AI, completude etc.). ⏰ Separar por Prof. (planilhas de demandas gerais por profissional). 🎯 Busca Ativa por Prof. 🚀 Sem Prof. Ref. (relatório + .txt e Excel). 📊 Sem PTS por Prof. 🔍 Clínicas de Família / CMS (configuração e lista de unidades). 💰 Panorama CAPS (resumo geral em formato compacto com emojis). 📈 Histórico / Gráficos (visualização da série histórica). 📑 Procedimentos (RAAS/BPA) (planilhas consolidadas por profissional). 📌 Ranking TOP20 (pendências por profissional). 📉 Gráfico de Completude (quando o Rel. 293 está carregado). Painel de Saída de Texto Área de texto com rolagem (ScrolledText) onde o relatório final é exibido, com emojis e formatação voltada para copia/cola em WhatsApp. 6. Passo a Passo de Uso 6.1. Abrir o programa Execute o .exe. Aguarde a tela de splash completar. A janela principal será aberta maximizada (até 1280×720 ou tela disponível). 6.2. Importar arquivos de relatórios Para cada relatório PCSM, clique no botão correspondente e selecione o arquivo (.csv ou .xlsx, conforme o caso). Resumo dos relatórios: Pacientes Ativos – Rel. 166 Campos esperados: Nome, Profissional Primário, Profissional Secundário, Status (B = Busca Ativa). O programa cria índices internos por paciente e profissional, cuidando de homônimos. RAAS – Rel. 20 Conta: Atendimentos familiares. Registros de Reabilitação Psicossocial em instituição (RP). Atendimentos individuais. Registros de Busca Ativa. Atualiza contadores internos e labels na tela. BPA-I – Rel. 12 e BPA-C – Rel. 277 Usados para compor o total de procedimentos e o cálculo de % de Atendimento Individual. Leitura robusta, apenas somando linhas relevantes. Internações Psiquiátricas – Rel. 148 Lê CPS, nome do paciente e outros campos. Gera uma lista de internações, usada no relatório e nas demandas. Pacientes em Instituição – Rel. 18 Lê nome, tipo de moradia, instituição, etc. Pode ser complementado com o Rel. 112 – Busca ativa realizada no período, para identificar quem foi visitado. Busca Ativa – Rel. 0007 Deduplica registros por paciente, mantendo a data mais recente. Usa os campos de paciente, profissional de referência, data, tipo. Unidades Matriciadas – Rel. 153 Limpa os nomes de unidades, remove duplicatas. Preenche a lista de unidades para o cálculo de Matriciamento (≥ 60% de CAPS matriciados). Pacientes sem PTS – Rel. 193 Lê pacientes sem PTS e tenta vincular a um UID do 166 por: ID de prontuário, quando possível. Nome, em último caso, evitando homônimos ambíguos. Exporta um SEM_PTS_AMBIGUOS.csv quando há conflitos. Completude Cadastral – Rel. 293 Calcula, para cada paciente ativo: Se possui cadastro completo. Quais campos estão faltando (benefício, gênero, tipo de moradia). Gera rótulos de pendências usados nas planilhas de demandas e no ranking TOP20. Relatório 156 – CID Conta: Total de pacientes com CID. Total de pacientes sem CID (campo vazio ou “sem CID”). Exibe resumo no label e adiciona essas informações no relatório de indicadores. Relatório 282 – Reinserção Produtiva Solicita a escolha de um CAPS da lista (apenas na primeira vez). Conta, apenas para o CAPS escolhido: Total de casos em Reinserção Produtiva. Quantos estão em Acompanhamento. Quantos em Busca Ativa. Esses números também entram no relatório de indicadores. 6.3. Configurar Metas Ao clicar em Configurar Metas, é aberta uma janela para ajuste dos parâmetros, por exemplo: Percentual mínimo de: Atendimento Familiar. Reabilitação Psicossocial em Instituição. Busca Ativa (relação com ativos ou institucionalizados). Atendimento Individual (limite máximo %). Alvo de projeção em BA (número de pacientes a alcançar). Meta de Completude Cadastral (percentual). As configurações são salvas em indicadores_config.json. 6.4. Calcular Indicadores O botão Calcular Indicadores: Pergunta se deseja ativar o Modo Sigiloso (se ainda não estiver definido). Gera um relatório completo com seções como: 👨‍👩‍👧 Atendimento Familiar vs. meta 🧱 Reabilitação Psicossocial em Instituição (RP / BA RAAS / BA 112) 🏫 Matriciamento de Unidades 🧑⚕️ Atendimento Individual vs. meta, com ranking dos profissionais que mais fazem AI 🧩 Resumo CID (Rel. 156) – pacientes com/sem CID 💼 Reinserção Produtiva (Rel. 282) – total, acompanhamento, busca ativa 🔎 Busca Ativa vs. meta e projeção até o alvo 📋 Pacientes sem PTS e sem Profissional de Referência (síntese) O texto é exibido no painel, copiado para a área de transferência e salvo como resultado.txt. Os indicadores do dia são gravados em historico_indicadores.db. 6.5. Relatórios e Planilhas de Demandas Algumas ações extras importantes: ⏰ Separar por Profissional Gera Demandas profissionais na Área de Trabalho, com: Planilhas por profissional, trazendo: Pacientes ativos. Situação de PTS. Situação em instituição. Pendências de completude. Células críticas (sem PTS, institucionalizados sem RP/BA, pendências) destacadas em vermelho. 🎯 Busca Ativa por Profissional Gera pastas/planilhas com Busca Ativa agrupada por profissional. 🚀 Sem Prof. Ref. Lista pacientes ativos sem nenhum profissional vinculado. Copia texto para WhatsApp e salva .txt na pasta Demandas profissionais. 📊 Sem PTS por Prof. Agrupa todos os pacientes sem PTS por profissional de referência. Exibe texto e grava arquivo .txt. 📑 Procedimentos (RAAS/BPA) Consolida RAAS, BPA-I e BPA-C em um arquivo Excel com: Aba por profissional. Filtros e larguras de colunas automáticas. Marca em vermelho: PTS = “Não”. Em instituição sem registro RP/BA. Pendências de completude. 📌 Ranking TOP20 Monta um ranking dos profissionais com mais pendências (PTS + instituição + completude). Gera texto para discussão e planilha de apoio. 🔍 Clínicas de Família / CMS Interface para configurar lista de unidades disponíveis e selecionadas. Salva em clinicas_familia.json, usado no cálculo de Matriciamento. 💰 Panorama CAPS Cria um resumo curto, com emojis, mostrando: Ativos, BA, sem PTS, sem profissional de referência. Total de procedimentos. Internações. Matriciamento. Completude cadastral (se disponível). 📈 Histórico / Gráficos Permite escolher um indicador (AF, RP, BA, AI, completude etc.). Exibe gráfico com: Linha de meta. Média móvel. Pontos por dia/semana/mês. Permite também excluir registros do histórico (caso algum dia tenha sido gravado com erro). 📉 Gráfico de Completude Quando o Rel. 293 está carregado: Exibe gráfico de pizza com % de cadastro completo. Exibe barras mostrando quais campos mais faltam (benefício, gênero, moradia). 7. Estrutura de Arquivos Gerados O programa cria e atualiza alguns arquivos: resultado.txt Último relatório completo gerado. historico_indicadores.db Banco SQLite com tabela historico, armazenando indicadores diários. clinicas_familia.json Configuração de unidades de atenção básica para cálculo de Matriciamento. indicadores_config.json Metas e parâmetros definidos na tela de configuração. Pastas na Área de Trabalho, como: Demandas profissionais/ Demandas busca ativa/ Planilhas consolidadas de procedimentos (RAAS/BPA). Arquivos auxiliares de ambiguidade (por exemplo): SEM_PTS_AMBIGUOS.csv – pacientes sem PTS com ID / nome ambíguo entre múltiplos profissionais. 8. Observações Importantes Os CSV devem usar ; como delimitador e codificação latin-1 ou utf-8, conforme exportado pelo PCSM. Sempre carregue primeiro o Rel. 166 – Pacientes Ativos, pois muitos outros relatórios dependem dele para vincular pacientes a profissionais. O programa tenta ser robusto a mudanças mínimas nas colunas (detectando cabeçalho e palavras-chave), mas: Se a SMS alterar fortemente o layout dos relatórios, será necessário ajustar o código. O executável foi pensado para rodar sem instalação de dependências. Em caso de erro: Verifique se o arquivo realmente corresponde ao relatório indicado (166, 20, 12, 277, 148, 18, 0007, 153, 193, 293, 156, 282 etc.). Confirme se o arquivo não foi aberto simultaneamente por outro programa (como Excel).