Buchumschlag

Indicadores CAPS – Monitoramento e Gestão de Metas em Saúde Mental

Fuente: Zenodo
Gespeichert in:
Bibliographische Detailangaben
1. Verfasser: Gabriel da Silva Fernandes
Format: Recurso digital
Sprache:Portugiesisch
Veröffentlicht: Zenodo 2025
Schlagworte:
saude mental
caps
indicadores
sus
gestão
metas
monitoramento
python
saude pubilca
software livre
Online-Zugang:
Acceder al recurso
Tags: Tag hinzufügen
Keine Tags, Fügen Sie den ersten Tag hinzu!
_version_ 1866901709333200896
author Gabriel da Silva Fernandes
author_facet Gabriel da Silva Fernandes
contents <ul> <li> <p> </p> <p>Indicadores CAPS – Versão 5.0<br>Monitoramento e Gestão de Metas em Saúde Mental (Variável 2 + Variável 3)</p> <h2>1. Introdução</h2> <p>O <strong>Indicadores CAPS 5.0</strong> é uma aplicação desktop (Windows, formato <code>.exe</code>) desenvolvida em Python com interface gráfica em Tkinter + ttkbootstrap.</p> <p>Ele foi pensado para gestores e equipes de CAPS que usam o PCSM e precisam:</p> <ul> <li> <p>Importar relatórios oficiais (RAAS, BPA-I, BPA-C, 166, 193, 293, 156, 282, 121, 149, 151, 160, 180, 181, 307 etc.).</p> </li> <li> <p>Calcular automaticamente indicadores operacionais com metas da <strong>Variável 2</strong> (Atendimento Familiar, Reabilitação Psicossocial em instituição, Matriciamento, Busca Ativa, Atendimento Individual, Completude Cadastral…).</p> </li> <li> <p>Calcular, em um painel próprio, os indicadores da <strong>Variável 3</strong> (Gestantes, Comorbidades, Lesão Autoprovocada/Tentativa, Situação de Rua, Vacinação, Notificações de Tuberculose, Inserção/Permanência Escolar em CAPSi).</p> </li> <li> <p>Gerar relatórios textuais prontos para WhatsApp (com emojis).</p> </li> <li> <p>Produzir planilhas Excel por profissional, com destaque das pendências.</p> </li> <li> <p>Manter um histórico diário em banco SQLite, com visualização gráfica da evolução dos indicadores.</p> </li> </ul> <p>A lógica continua a mesma:</p> <ol> <li> <p>Você importa os relatórios do PCSM.</p> </li> <li> <p>Configura metas da unidade.</p> </li> <li> <p>Clica em <strong>Calcular Indicadores</strong> (Variável 2) ou <strong>Calcular Variável 3</strong>.</p> </li> <li> <p>O programa entrega:</p> <ul> <li> <p>Um texto completo, pronto para colar em grupo de coordenação.</p> </li> <li> <p>Arquivos Excel com demandas organizadas por profissional.</p> </li> <li> <p>Indicadores salvos num histórico para análise gráfica ao longo do tempo.</p> </li> <li> <p>No caso da Variável 3, um resumo por componente com cálculo de UC (unidade de cobrança) e listas de aptos/inaptos.</p> </li> </ul> </li> </ol> <h2>2. Novidades da Versão 5.0 (em relação à 4.4.1)</h2> <h3> Painel completo da Variável 3</h3> <ul> <li> <p>Nova coluna dedicada <strong>“Variável 3 – Indicadores Específicos”</strong>.</p> </li> <li> <p>Campo de seleção de <strong>competência (mês/ano)</strong> para os indicadores que dependem do período (especialmente Rel. 307 – Lesão Autoprovocada).</p> </li> <li> <p>Campo para informar se o serviço é <strong>CAPS adulto</strong> ou <strong>CAPSi</strong>, ativando o indicador de <strong>Inserção/Permanência Escolar</strong> (Rel. 181) apenas quando faz sentido.</p> </li> <li> <p>Botões próprios para carregar:</p> <ul> <li> <p><strong>Rel. 121 – Comorbidades (HAS/DM)</strong></p> </li> <li> <p><strong>Rel. 160 – Gestantes (com integração ao Rel. 95 de data de cadastro)</strong></p> </li> <li> <p><strong>Rel. 180 – Vacinação</strong></p> </li> <li> <p><strong>Rel. 149 – Notificações de Tuberculose (campo SINAN)</strong></p> </li> <li> <p><strong>Rel. 151 – Situação de Rua</strong></p> </li> <li> <p><strong>Rel. 181 – Inserção/Permanência na Escola (CAPSi)</strong></p> </li> <li> <p><strong>Rel. 307 – Lesão Autoprovocada/Tentativa de suicídio</strong></p> </li> </ul> </li> <li> <p>Botão <strong>“Calcular Variável 3”</strong> que:</p> <ul> <li> <p>Junta todos os indicadores carregados.</p> </li> <li> <p>Calcula as UCs de cada componente.</p> </li> <li> <p>Gera texto consolidado para WhatsApp.</p> </li> <li> <p>Pode gerar planilhas auxiliares para alguns indicadores (ex.: Lesão Autoprovocada, Situação de Rua).</p> </li> </ul> </li> </ul> <h3> Indicador de Comorbidades – Rel. 121</h3> <ul> <li> <p>Leitura automática do <strong>Rel. 121</strong> (HAS/DM), com detecção de cabeçalho.</p> </li> <li> <p>Lê, de forma robusta:</p> <ul> <li> <p>Número de pacientes ativos considerados no relatório.</p> </li> <li> <p>Total de pessoas com <strong>Hipertensão</strong>.</p> </li> <li> <p>Total de pessoas com <strong>Diabetes</strong>.</p> </li> <li> <p>Percentuais (quando já calculados no relatório) ou cálculo automático a partir dos ativos.</p> </li> </ul> </li> <li> <p>Indicador da Variável 3 com metas padrão:</p> <ul> <li> <p><strong>HAS:</strong> prevalência mínima ≥ 27% dos ativos.</p> </li> <li> <p><strong>DM:</strong> prevalência mínima ≥ 8% dos ativos.</p> </li> </ul> </li> <li> <p>Cálculo de UC:</p> <ul> <li> <p>Até <strong>100 UC</strong> para HAS.</p> </li> <li> <p>Até <strong>100 UC</strong> para DM.</p> </li> <li> <p>Total <strong>0–200 UC</strong> para Comorbidades.</p> </li> </ul> </li> <li> <p>Aviso se o número de “ativos” do Rel. 121 divergir do carregado no Rel. 166.</p> </li> </ul> <h3> Indicador de Gestantes – Rel. 160 + Rel. 95</h3> <ul> <li> <p>Integração mais sofisticada dos relatórios:</p> <ul> <li> <p><strong>Rel. 160 – Gestantes</strong></p> </li> <li> <p><strong>Rel. 95 – Data de cadastro</strong> (para definir corretamente em qual trimestre a gestante passa a contar).</p> </li> </ul> </li> <li> <p>Lógica por <strong>trimestre fixo</strong>:</p> <ul> <li> <p>1º trimestre: <strong>Fevereiro, Março, Abril</strong></p> </li> <li> <p>2º trimestre: <strong>Maio, Junho, Julho</strong></p> </li> <li> <p>3º trimestre: <strong>Agosto, Setembro, Outubro</strong></p> </li> <li> <p>4º trimestre: <strong>Novembro, Dezembro, Janeiro</strong></p> </li> </ul> </li> <li> <p>O programa:</p> <ul> <li> <p>Identifica quais gestantes realmente “entram” no trimestre analisado (a partir da data de cadastro).</p> </li> <li> <p>Monta listas de <strong>APTAS</strong> e <strong>INAPTAS</strong> conforme os critérios estabelecidos.</p> </li> <li> <p>Gera cards por profissional, com detalhes de cada gestante.</p> </li> </ul> </li> <li> <p>Texto pronto para WhatsApp + opção de planilhas auxiliares.</p> </li> </ul> <h3> Indicador de Lesão Autoprovocada / Tentativa – Rel. 307 (layout novo)</h3> <ul> <li> <p>Implementação atualizada do <strong>Rel. 307</strong>, acompanhando o novo layout:</p> <ul> <li> <p>Agora sem coluna “tipo”, usando <strong>Data de Origem/Notificação/Comunicação</strong>.</p> </li> <li> <p>Campo de competência (mês/ano) definido na própria aba da Variável 3.</p> </li> </ul> </li> <li> <p>O programa:</p> <ul> <li> <p>Lê o CSV de forma robusta (latin-1 ou utf-8-sig).</p> </li> <li> <p>Mapeia as colunas por <strong>palavras-chave</strong> (prontuário, nome, data, profissional).</p> </li> <li> <p>Filtra automaticamente os registros apenas da competência selecionada (mês/ano).</p> </li> <li> <p>Tudo que fica fora do período vai para uma lista separada, com o motivo (por exemplo: “fora da competência” ou “sem data de referência”).</p> </li> </ul> </li> <li> <p>Gera:</p> <ul> <li> <p>Cards por profissional com os casos da competência.</p> </li> <li> <p>Lista dos fora do período (útil para limpeza/ajuste no PCSM).</p> </li> <li> <p>Texto de resumo para Var.3, com contagens e UC.</p> </li> </ul> </li> </ul> <h3> ‍♀️ Situação de Rua – Rel. 151 (Indicador Var.3)</h3> <ul> <li> <p>Leitura do <strong>Relatório 151 – Situação de Rua</strong> com foco na Variável 3.</p> </li> <li> <p>Para cada usuário em situação de rua, o indicador checa no período:</p> <ul> <li> <p>Se houve <strong>articulação em rede</strong> (tipo de atendimento adequado).</p> </li> <li> <p>Se foi realizado <strong>teste rápido de HIV</strong>.</p> </li> <li> <p>Se foi realizado <strong>teste rápido de sífilis</strong>.</p> </li> </ul> </li> <li> <p>O usuário só entra como <strong>APTO</strong> se satisfizer o conjunto de critérios.</p> </li> <li> <p>O relatório gera:</p> <ul> <li> <p>Contagem de aptos/inaptos.</p> </li> <li> <p>Cards por profissional com o motivo de estar fora do indicador (ex.: faltou teste de HIV, faltou articulação etc.).</p> </li> <li> <p>Cálculo de UC específico de Situação de Rua dentro da Variável 3.</p> </li> </ul> </li> </ul> <h3> Vacinação – Rel. 180 (Var.3)</h3> <ul> <li> <p>Leitura do <strong>Rel. 180 – Vacinação</strong> dentro da aba Variável 3.</p> </li> <li> <p>O programa:</p> <ul> <li> <p>Consolida por faixa etária/critério definido no relatório.</p> </li> <li> <p>Calcula a cobertura e compara com a meta (por exemplo 85% — ajustável conforme norma adotada).</p> </li> </ul> </li> <li> <p>Saída:</p> <ul> <li> <p>Resumo com total de usuários elegíveis.</p> </li> <li> <p>Quantos estão com vacina em dia.</p> </li> <li> <p>Cálculo de UC de vacinação na Variável 3.</p> </li> </ul> </li> </ul> <h3> Notificações de Tuberculose – Rel. 149 (SINAN)</h3> <ul> <li> <p>Leitura do <strong>Rel. 149 – Notificações (Tuberculose)</strong>.</p> </li> <li> <p>Lógica focada na meta da Variável 3:</p> <ul> <li> <p>Filtra o trimestre correto.</p> </li> <li> <p>Separa notificações “com SINAN lançado” x “sem SINAN”.</p> </li> <li> <p>Desconsidera notificações do trimestre anterior trazidas junto no relatório.</p> </li> </ul> </li> <li> <p>Gera:</p> <ul> <li> <p>Resumo por profissional com quantas notificações estão completas (com SINAN) e quantas ainda não.</p> </li> <li> <p>Texto consolidado para Var.3 com cálculo de UC específico de TB.</p> </li> </ul> </li> </ul> <h3> Inserção/Permanência Escolar – Rel. 181 (para CAPSi)</h3> <ul> <li> <p>Ativo apenas quando o serviço é configurado como <strong>CAPSi</strong>.</p> </li> <li> <p>Leitura do <strong>Rel. 181</strong>:</p> <ul> <li> <p>Conta quantos usuários deveriam estar na escola.</p> </li> <li> <p>Quantos estão de fato matriculados e em acompanhamento.</p> </li> </ul> </li> <li> <p>Compara com a meta da Variável 3 (por exemplo, ≥ 80% em escola).</p> </li> <li> <p>Gera:</p> <ul> <li> <p>Texto com resumo (elegíveis, na escola, fora).</p> </li> <li> <p>Cálculo de UC escolar dentro da Var.3.</p> </li> </ul> </li> </ul> <h3> Interface visual aprimorada</h3> <ul> <li> <p>Papel de parede de fundo mais escuro, mantendo o destaque para os painéis.</p> </li> <li> <p><strong>Imagem exclusiva na coluna central</strong> (CAPS2.png/jpg/jpeg) com recorte automático que se ajusta ao tamanho da janela.</p> </li> <li> <p>Mantém o clima de “painel de comando” do CAPS, mas com visual mais limpo.</p> </li> </ul> <h2>3. Instalação e Execução</h2> <h3>3.1. Versão .exe (recomendada)</h3> <ul> <li> <p>Baixe o arquivo <code>Indicadores_CAPS_5.0.exe</code> (ou nome equivalente) a partir do Zenodo.</p> </li> <li> <p>Coloque o <code>.exe</code> em uma pasta de sua preferência (idealmente junto dos arquivos auxiliares, como vídeo/GIF do splash e imagens CAPS.png/CAPS2.png, se fornecidos).</p> </li> <li> <p>Dê duplo-clique para executar em qualquer máquina Windows.</p> </li> <li> <p>Não é necessário ter Python instalado.</p> </li> <li> <p>Aguarde a tela de splash completar (0–100%).</p> </li> <li> <p>Ao final, a janela principal é exibida.</p> </li> </ul> <h3>3.2. Execução via código fonte (opcional)</h3> <p>Se preferir rodar o <code>.py</code> diretamente:</p> <ul> <li> <p>Requer Python 3.x e os pacotes principais:</p> <ul> <li> <p><code>tkinter</code>, <code>ttkbootstrap</code></p> </li> <li> <p><code>matplotlib</code></p> </li> <li> <p><code>pandas</code></p> </li> <li> <p><code>openpyxl</code></p> </li> <li> <p><code>sqlite3</code></p> </li> </ul> </li> <li> <p>Instale as dependências (<code>pip install ...</code>) e execute:</p> </li> </ul> <pre><code>python app.py </code></pre> <h2>4. Tela de Splash</h2> <ul> <li> <p>Exibe um vídeo/GIF em loop (por exemplo, <code>CAPS.mp4</code>) com:</p> <ul> <li> <p>Barra de progresso de 0% a 100%.</p> </li> <li> <p>Mensagens de carregamento em tom leve e motivador.</p> </li> </ul> </li> <li> <p>Ao terminar o carregamento, abre a janela principal.</p> </li> <li> <p>A imagem de fundo estática (CAPS.png) pode ser usada como “wallpaper” geral, e a CAPS2.png fica como papel de parede da coluna central.</p> </li> </ul> <h2>5. Estrutura da Interface</h2> <p>A janela principal é organizada em três grandes blocos:</p> <ol> <li> <p><strong>Banner Superior</strong></p> <ul> <li> <p>Faixa com o título:</p> <ul> <li> <p>“<strong>Indicadores CAPS – Bora Bater Meta Gente!</strong>”</p> </li> </ul> </li> <li> <p>Pode incluir gradiente e imagem de fundo.</p> </li> </ul> </li> <li> <p><strong>Coluna Esquerda – Variável 2 / Importação de Relatórios Base</strong></p> <ul> <li> <p>Painel com botões para cada relatório do PCSM usado nos indicadores operacionais:</p> <ul> <li> <p>Pacientes Ativos – <strong>Rel. 166 – Var 2</strong></p> </li> <li> <p>RAAS – <strong>Rel. 20 – Var 2</strong></p> </li> <li> <p>BPA-I – <strong>Rel. 12 – Var 2</strong></p> </li> <li> <p>BPA-C – <strong>Rel. 277 – Var 2</strong></p> </li> <li> <p>Internações Psiquiátricas – <strong>Rel. 148 – Var 2</strong></p> </li> <li> <p>Pacientes em Instituição – <strong>Rel. 18 (+112) – Var 2</strong></p> </li> <li> <p>Busca Ativa – <strong>Rel. 0007 – Var 2</strong></p> </li> <li> <p>Unidades Matriciadas – <strong>Rel. 153 – Var 2</strong></p> </li> <li> <p>Pacientes sem PTS – <strong>Rel. 193 – Var 2</strong></p> </li> <li> <p>Completude Cadastral – <strong>Rel. 293 – Var 2</strong></p> </li> <li> <p>Relatório 156 – CID</p> </li> <li> <p>Relatório 282 – Reinserção Produtiva</p> </li> </ul> </li> <li> <p>Ao lado de cada botão, um <strong>label de status</strong> mostra:</p> <ul> <li> <p>Se o arquivo foi carregado.</p> </li> <li> <p>Quantos registros foram lidos.</p> </li> <li> <p>Resumos importantes (ex.: “156 (CID): com X | sem Y”, “282: CAPS X – Total N (Acomp. A | Busca B)”).</p> </li> </ul> </li> </ul> </li> <li> <p><strong>Coluna Direita – Variável 3</strong></p> <p>Painel próprio com:</p> <ul> <li> <p>Campos de configuração da <strong>Variável 3</strong>:</p> <ul> <li> <p>Seleção de <strong>competência</strong> (mês/ano).</p> </li> <li> <p>Seleção do tipo de serviço (<strong>CAPS adulto / CAPSi</strong>).</p> </li> </ul> </li> <li> <p>Botões de importação específicos:</p> <ul> <li> <p><strong>Comorbidades – Rel. 121</strong></p> </li> <li> <p><strong>Gestantes – Rel. 160</strong> (com uso opcional da integração Rel. 95 já carregada no backend da aplicação)</p> </li> <li> <p><strong>Vacinação – Rel. 180</strong></p> </li> <li> <p><strong>Notificações TB – Rel. 149</strong></p> </li> <li> <p><strong>Situação de Rua – Rel. 151</strong></p> </li> <li> <p><strong>Inserção/Permanência Escolar – Rel. 181</strong> (visível/ativo apenas para CAPSi)</p> </li> <li> <p><strong>Lesão Autoprovocada/Tentativa – Rel. 307</strong></p> </li> </ul> </li> <li> <p>Labels de status resumindo:</p> <ul> <li> <p>Quantos registros cada relatório trouxe.</p> </li> <li> <p>Se houve filtro por competência (307).</p> </li> <li> <p>Observações úteis (ex.: diferença entre ativos do Rel. 121 e do 166).</p> </li> </ul> </li> </ul> </li> <li> <p><strong>Painel Central / Ações e Saída</strong></p> <ul> <li> <p><strong>Painel de Indicadores Gerais (Var. 2)</strong>:</p> <ul> <li> <p>Campos que mostram:</p> <ul> <li> <p>Total de pacientes ativos.</p> </li> <li> <p>Totais de RAAS, BPA-I e BPA-C.</p> </li> <li> <p>Resumo de institucionalizados com RP/BA.</p> </li> <li> <p>Resumo de completude, CID e reinserção produtiva (quando carregados).</p> </li> </ul> </li> </ul> </li> <li> <p><strong>Painel de Ações / Botões Principais (Var. 2 + extras)</strong>:</p> <ul> <li> <p> <strong>Calcular Indicadores</strong> (Variável 2)</p> </li> <li> <p>⭐ <strong>Copiar Relatório</strong> (texto da Variável 2 para WhatsApp)</p> </li> <li> <p> <strong>Configurar Metas</strong> (AF, RP, BA, AI, completude etc.)</p> </li> <li> <p>⏰ <strong>Separar por Prof.</strong> (planilhas de demandas gerais por profissional)</p> </li> <li> <p> <strong>Busca Ativa por Prof.</strong></p> </li> <li> <p> <strong>Sem Prof. Ref.</strong> (lista textos + .txt + Excel)</p> </li> <li> <p> <strong>Sem PTS por Prof.</strong></p> </li> <li> <p> <strong>Clínicas de Família / CMS</strong></p> </li> <li> <p> <strong>Panorama CAPS</strong> (resumo compacto com emojis)</p> </li> <li> <p> <strong>Histórico / Gráficos</strong></p> </li> <li> <p> <strong>Procedimentos (RAAS/BPA)</strong> (planilhas consolidadas por profissional)</p> </li> <li> <p> <strong>Ranking TOP20</strong> (pendências por profissional)</p> </li> <li> <p> <strong>Gráfico de Completude</strong> (quando o Rel. 293 está carregado)</p> </li> </ul> </li> <li> <p><strong>Painel de Ações – Variável 3</strong>:</p> <ul> <li> <p>Botão <strong>Calcular Variável 3</strong>:</p> <ul> <li> <p>Gera o texto consolidado dos indicadores da Var.3.</p> </li> <li> <p>Atualiza o painel de saída.</p> </li> <li> <p>Copia para a área de transferência.</p> </li> </ul> </li> <li> <p>Botão <strong>Copiar texto Var. 3</strong> (quando implementado) ou reaproveitamento da própria função de cálculo.</p> </li> </ul> </li> <li> <p><strong>Painel de Saída de Texto</strong>:</p> <ul> <li> <p>Área de texto com rolagem (ScrolledText) onde:</p> <ul> <li> <p>O relatório final da Variável 2 é exibido.</p> </li> <li> <p>O relatório da Variável 3 também pode ser exibido.</p> </li> <li> <p>Tudo em formato amigável para copia/cola em WhatsApp, com emojis e marcadores.</p> </li> </ul> </li> </ul> </li> </ul> </li> </ol> <h2>6. Passo a Passo de Uso</h2> <h3>6.1. Abrir o programa</h3> <ol> <li> <p>Execute o <code>.exe</code>.</p> </li> <li> <p>Aguarde a tela de splash completar.</p> </li> <li> <p>A janela principal será aberta (modo maximizado, até 1280×720 ou conforme tela).</p> </li> </ol> <h3>6.2. Importar arquivos de relatórios – Variável 2</h3> <p>Para cada relatório PCSM, clique no botão correspondente e selecione o arquivo (.csv ou .xlsx, conforme o caso).</p> <p>Resumo:</p> <ul> <li> <p><strong>Pacientes Ativos – Rel. 166</strong></p> <ul> <li> <p>Campos esperados: Nome, Profissional Primário, Profissional Secundário, Status (B = Busca Ativa).</p> </li> <li> <p>O programa cria índices internos por paciente e profissional, cuidando de homônimos.</p> </li> </ul> </li> <li> <p><strong>RAAS – Rel. 20</strong></p> <ul> <li> <p>Conta:</p> <ul> <li> <p>Atendimentos familiares.</p> </li> <li> <p>Registros de Reabilitação Psicossocial em instituição (RP).</p> </li> <li> <p>Atendimentos individuais.</p> </li> <li> <p>Registros de Busca Ativa.</p> </li> </ul> </li> <li> <p>Atualiza contadores internos e labels na tela.</p> </li> </ul> </li> <li> <p><strong>BPA-I – Rel. 12</strong> e <strong>BPA-C – Rel. 277</strong></p> <ul> <li> <p>Usados para compor o total de procedimentos e o cálculo de % de Atendimento Individual.</p> </li> <li> <p>Leitura robusta, apenas somando linhas relevantes.</p> </li> </ul> </li> <li> <p><strong>Internações Psiquiátricas – Rel. 148</strong></p> <ul> <li> <p>Lê CPS, nome do paciente e outros campos.</p> </li> <li> <p>Gera uma lista de internações, usada no relatório e nas demandas.</p> </li> </ul> </li> <li> <p><strong>Pacientes em Instituição – Rel. 18 (+ Rel. 112 opcional)</strong></p> <ul> <li> <p>Lê nome, tipo de moradia, instituição, etc.</p> </li> <li> <p>Pode ser complementado com o Rel. 112 – Busca ativa realizada no período, para identificar quem foi visitado.</p> </li> </ul> </li> <li> <p><strong>Busca Ativa – Rel. 0007</strong></p> <ul> <li> <p>Deduplica registros por paciente, mantendo a data mais recente.</p> </li> <li> <p>Usa os campos de paciente, profissional de referência, data, tipo.</p> </li> </ul> </li> <li> <p><strong>Unidades Matriciadas – Rel. 153</strong></p> <ul> <li> <p>Limpa os nomes de unidades, remove duplicatas.</p> </li> <li> <p>Preenche a lista de unidades para o cálculo de Matriciamento (≥ 60% de CAPS matriciados).</p> </li> </ul> </li> <li> <p><strong>Pacientes sem PTS – Rel. 193</strong></p> <ul> <li> <p>Lê pacientes sem PTS e tenta vincular a um UID do 166 por:</p> <ul> <li> <p>ID de prontuário, quando possível.</p> </li> <li> <p>Nome, em último caso, evitando homônimos ambíguos.</p> </li> </ul> </li> <li> <p>Exporta um <code>SEM_PTS_AMBIGUOS.csv</code> quando há conflitos.</p> </li> </ul> </li> <li> <p><strong>Completude Cadastral – Rel. 293</strong></p> <ul> <li> <p>Calcula, para cada paciente ativo:</p> <ul> <li> <p>Se possui cadastro completo.</p> </li> <li> <p>Quais campos estão faltando (benefício, gênero, tipo de moradia).</p> </li> </ul> </li> <li> <p>Gera rótulos de pendências usados nas planilhas de demandas e no ranking TOP20.</p> </li> </ul> </li> <li> <p><strong>Relatório 156 – CID</strong></p> <ul> <li> <p>Conta:</p> <ul> <li> <p>Total de pacientes com CID.</p> </li> <li> <p>Total de pacientes sem CID (campo vazio ou “sem CID”).</p> </li> </ul> </li> <li> <p>Exibe resumo no label e adiciona essas informações no relatório de indicadores e no Panorama CAPS.</p> </li> </ul> </li> <li> <p><strong>Relatório 282 – Reinserção Produtiva</strong></p> <ul> <li> <p>Solicita a escolha de um CAPS da lista (apenas na primeira vez).</p> </li> <li> <p>Conta, apenas para o CAPS escolhido:</p> <ul> <li> <p>Total de casos em Reinserção Produtiva.</p> </li> <li> <p>Quantos estão em Acompanhamento.</p> </li> <li> <p>Quantos em Busca Ativa.</p> </li> </ul> </li> <li> <p>Esses números entram no relatório de indicadores e no Panorama CAPS.</p> </li> </ul> </li> </ul> <h3>6.3. Importar arquivos – Variável 3</h3> <p>Na coluna da Variável 3:</p> <ol> <li> <p>Defina <strong>competência (mês/ano)</strong> e se o serviço é <strong>CAPS</strong> ou <strong>CAPSi</strong>.</p> </li> <li> <p>Carregue:</p> <ul> <li> <p><strong>Comorbidades – Rel. 121</strong><br>CSV com prevalência de HAS/DM por pacientes ativos.</p> </li> <li> <p><strong>Gestantes – Rel. 160</strong><br>(o programa usa também as informações de cadastro do Rel. 95, já integradas no núcleo de dados).</p> </li> <li> <p><strong>Vacinação – Rel. 180</strong><br>Relatório de vacinação da unidade.</p> </li> <li> <p><strong>Situação de Rua – Rel. 151</strong><br>Pacientes em situação de rua vinculados ao CAPS.</p> </li> <li> <p><strong>Notificações TB – Rel. 149</strong><br>Notificações de Tuberculose com campo SINAN.</p> </li> <li> <p><strong>Inserção/Permanência Escolar – Rel. 181</strong> (CAPSi)</p> </li> <li> <p><strong>Lesão Autoprovocada – Rel. 307</strong><br>Atenção ao layout novo do CSV: o programa já está adaptado.</p> </li> </ul> </li> </ol> <p>Os labels ao lado de cada botão informam quantos registros foram lidos e se houve filtros por competência.</p> <h3>6.4. Configurar Metas (Variável 2 e parâmetros gerais)</h3> <p>Ao clicar em <strong>Configurar Metas</strong>, é aberta uma janela para ajuste dos parâmetros, por exemplo:</p> <ul> <li> <p>Percentual mínimo de:</p> <ul> <li> <p>Atendimento Familiar.</p> </li> <li> <p>Reabilitação Psicossocial em Instituição.</p> </li> <li> <p>Busca Ativa (relação com ativos ou institucionalizados).</p> </li> <li> <p>Atendimento Individual (limite máximo %).</p> </li> </ul> </li> <li> <p>Alvo de projeção em BA (número de pacientes a alcançar).</p> </li> <li> <p>Meta de Completude Cadastral (percentual).</p> </li> </ul> <p>As configurações são salvas em <code>indicadores_config.json</code>.</p> <h3>6.5. Calcular Indicadores – Variável 2</h3> <p>O botão <strong>Calcular Indicadores</strong>:</p> <ul> <li> <p>Pergunta (na primeira vez) se deseja ativar o <strong>Modo Sigiloso</strong>:</p> <ul> <li> <p>Quando ligado, os nomes dos profissionais são ocultados (Profissional #01, #02…).</p> </li> </ul> </li> <li> <p>Gera um relatório completo com seções como:</p> <ul> <li> <p> ‍ ‍ Atendimento Familiar vs. meta</p> </li> <li> <p> Reabilitação Psicossocial em Instituição (RP / BA RAAS / BA 112)</p> </li> <li> <p> Matriciamento de Unidades</p> </li> <li> <p> ⚕️ Atendimento Individual vs. meta, com ranking dos profissionais que mais fazem AI</p> </li> <li> <p> Resumo CID (Rel. 156) – pacientes com/sem CID</p> </li> <li> <p> Reinserção Produtiva (Rel. 282) – total, acompanhamento, busca ativa</p> </li> <li> <p> Busca Ativa vs. meta e projeção até o alvo</p> </li> <li> <p> Pacientes sem PTS e sem Profissional de Referência (síntese)</p> </li> </ul> </li> </ul> <p>O texto é exibido no painel, copiado para a área de transferência e salvo como <code>resultado.txt</code>.<br>Os indicadores do dia são gravados em <code>historico_indicadores.db</code>.</p> <h3>6.6. Calcular Indicadores – Variável 3</h3> <p>O botão <strong>Calcular Variável 3</strong>:</p> <ul> <li> <p>Verifica se os relatórios essenciais para Var.3 foram carregados (166, 0007, e pelo menos alguns dos 121/149/151/160/180/181/307).</p> </li> <li> <p>Usa a competência definida (mês/ano) para o que depende de período (especialmente 307 e ajustes de trimestre em gestantes).</p> </li> <li> <p>Gera um relatório com blocos como:</p> <ul> <li> <p> <strong>Comorbidades (Rel. 121)</strong></p> <ul> <li> <p>Ativos considerados, HAS, DM, percentuais.</p> </li> <li> <p>UC HAS, UC DM, UC total.</p> </li> </ul> </li> <li> <p> <strong>Gestantes (Rel. 160 + 95)</strong></p> <ul> <li> <p>Trimestre analisado.</p> </li> <li> <p>Quantas gestantes entram no período.</p> </li> <li> <p>Aptas x inaptas, com cards por profissional.</p> </li> </ul> </li> <li> <p> <strong>Vacinação (Rel. 180)</strong></p> <ul> <li> <p>Cobertura, elegíveis, UC de vacinação.</p> </li> </ul> </li> <li> <p> ‍♀️ <strong>Situação de Rua (Rel. 151)</strong></p> <ul> <li> <p>Quantos usuários em situação de rua.</p> </li> <li> <p>Quantos têm articulação + TR HIV + TR Sífilis.</p> </li> <li> <p>Aptos x inaptos, UC específica.</p> </li> </ul> </li> <li> <p> <strong>Notificações TB (Rel. 149)</strong></p> <ul> <li> <p>Notificações com SINAN x sem SINAN.</p> </li> <li> <p>Controle de trimestre correto.</p> </li> <li> <p>UC de TB.</p> </li> </ul> </li> <li> <p> <strong>Lesão Autoprovocada/Tentativa (Rel. 307)</strong></p> <ul> <li> <p>Casos na competência.</p> </li> <li> <p>Casos fora da competência (em lista auxiliar).</p> </li> <li> <p>Cards por profissional.</p> </li> </ul> </li> <li> <p> <strong>Inserção/Permanência Escolar (Rel. 181 – CAPSi)</strong></p> <ul> <li> <p>Elegíveis x matriculados.</p> </li> <li> <p>Cobertura e UC escolar.</p> </li> </ul> </li> </ul> </li> <li> <p>Ao final, pode apresentar um <strong>resumo de UC total da Variável 3</strong> (somatório dos componentes) e, se configurado, copiar o texto direto para a área de transferência.</p> </li> </ul> <h3>6.7. Relatórios e Planilhas de Demandas</h3> <p>As ações extras da Variável 2 continuam:</p> <ul> <li> <p>⏰ <strong>Separar por Profissional</strong></p> <ul> <li> <p>Gera <code>Demandas profissionais</code> na Área de Trabalho, com:</p> <ul> <li> <p>Planilhas por profissional, trazendo:</p> <ul> <li> <p>Pacientes ativos.</p> </li> <li> <p>Situação de PTS.</p> </li> <li> <p>Situação em instituição.</p> </li> <li> <p>Pendências de completude.</p> </li> </ul> </li> <li> <p>Células críticas destacadas em vermelho.</p> </li> </ul> </li> </ul> </li> <li> <p> <strong>Busca Ativa por Profissional</strong></p> <ul> <li> <p>Gera pastas/planilhas com Busca Ativa agrupada por profissional.</p> </li> </ul> </li> <li> <p> <strong>Sem Prof. Ref.</strong></p> <ul> <li> <p>Lista pacientes ativos sem nenhum profissional vinculado.</p> </li> <li> <p>Copia texto para WhatsApp e salva <code>.txt</code>.</p> </li> </ul> </li> <li> <p> <strong>Sem PTS por Prof.</strong></p> <ul> <li> <p>Agrupa todos os pacientes sem PTS por profissional de referência.</p> </li> <li> <p>Exibe texto e grava arquivo <code>.txt</code>.</p> </li> </ul> </li> <li> <p> <strong>Procedimentos (RAAS/BPA)</strong></p> <ul> <li> <p>Consolida RAAS, BPA-I e BPA-C em um arquivo Excel com:</p> <ul> <li> <p>Aba por profissional.</p> </li> <li> <p>Filtros e larguras de colunas automáticas.</p> </li> <li> <p>Marcação em vermelho de:</p> <ul> <li> <p>Pacientes sem PTS.</p> </li> <li> <p>Pacientes em instituição sem RP/BA.</p> </li> <li> <p>Pendências de completude.</p> </li> </ul> </li> </ul> </li> </ul> </li> <li> <p> <strong>Ranking TOP20</strong></p> <ul> <li> <p>Monta um ranking dos profissionais com mais pendências (PTS + instituição + completude).</p> </li> <li> <p>Gera texto para discussão e planilha de apoio.</p> </li> </ul> </li> <li> <p> <strong>Clínicas de Família / CMS</strong></p> <ul> <li> <p>Interface para configurar lista de unidades disponíveis e selecionadas.</p> </li> <li> <p>Salva em <code>clinicas_familia.json</code>, usado no cálculo de Matriciamento.</p> </li> </ul> </li> <li> <p> <strong>Panorama CAPS</strong></p> <ul> <li> <p>Cria um resumo curto, com emojis, mostrando:</p> <ul> <li> <p>Ativos, BA, sem PTS, sem profissional de referência.</p> </li> <li> <p>Total de procedimentos.</p> </li> <li> <p>Internações.</p> </li> <li> <p>Institucionalizados atendidos/total.</p> </li> <li> <p>Unidades matriciadas.</p> </li> <li> <p>CID (com/sem).</p> </li> <li> <p>Reinserção produtiva (total, em acompanhamento, em BA).</p> </li> </ul> </li> </ul> </li> <li> <p> <strong>Histórico / Gráficos</strong></p> <ul> <li> <p>Permite escolher um indicador (AF, RP, BA, AI, completude etc.).</p> </li> <li> <p>Exibe gráfico com:</p> <ul> <li> <p>Linha de meta.</p> </li> <li> <p>Média móvel.</p> </li> <li> <p>Pontos por dia/semana/mês.</p> </li> </ul> </li> <li> <p>Permite excluir registros do histórico, se necessário.</p> </li> </ul> </li> <li> <p> <strong>Gráfico de Completude</strong></p> <ul> <li> <p>Quando o Rel. 293 está carregado:</p> <ul> <li> <p>Exibe gráfico de pizza com % de cadastro completo.</p> </li> <li> <p>Exibe barras mostrando quais campos mais faltam (benefício, gênero, moradia).</p> </li> </ul> </li> </ul> </li> </ul> <h2>7. Estrutura de Arquivos Gerados</h2> <p>O programa cria e atualiza alguns arquivos:</p> <ul> <li> <p><code>resultado.txt</code></p> <ul> <li> <p>Último relatório completo da Variável 2 (e, se desejado, pode ser reaproveitado para Var.3).</p> </li> </ul> </li> <li> <p><code>historico_indicadores.db</code></p> <ul> <li> <p>Banco SQLite com tabela <code>historico</code>, armazenando indicadores diários (AF, RP, BA, AI, completude, CID, reinserção, etc.).</p> </li> </ul> </li> <li> <p><code>clinicas_familia.json</code></p> <ul> <li> <p>Configuração de unidades de atenção básica para cálculo de Matriciamento.</p> </li> </ul> </li> <li> <p><code>indicadores_config.json</code></p> <ul> <li> <p>Metas e parâmetros definidos na tela de configuração.</p> </li> </ul> </li> <li> <p>Pastas na Área de Trabalho, como:</p> <ul> <li> <p><code>Demandas profissionais/</code></p> </li> <li> <p><code>Demandas busca ativa/</code></p> </li> <li> <p>Planilhas consolidadas de procedimentos (RAAS/BPA).</p> </li> </ul> </li> <li> <p>Arquivos auxiliares de ambiguidade:</p> <ul> <li> <p><code>SEM_PTS_AMBIGUOS.csv</code> – pacientes sem PTS com ID / nome ambíguo entre múltiplos profissionais.</p> </li> <li> <p>Arquivos auxiliares para Var.3 (quando existirem), como planilhas de lesão autoprovocada ou fora de período.</p> </li> </ul> </li> </ul> <h2>8. Observações Importantes</h2> <ul> <li> <p>Os CSV devem usar <code>;</code> como delimitador e codificação <code>latin-1</code> ou <code>utf-8</code>, conforme exportado pelo PCSM.</p> </li> <li> <p>Sempre carregue primeiro o <strong>Rel. 166 – Pacientes Ativos</strong>, pois muitos outros relatórios dependem dele para vincular pacientes a profissionais.</p> </li> <li> <p>Para a <strong>Variável 3</strong>, é fortemente recomendado:</p> <ul> <li> <p>Definir a competência antes de carregar o Rel. 307.</p> </li> <li> <p>Conferir se os relatórios (121, 149, 151, 160, 180, 181, 307) foram exportados nos layouts mais recentes da SMS.</p> </li> </ul> </li> <li> <p>O programa tenta ser robusto a mudanças mínimas nas colunas (detectando cabeçalho e palavras-chave), mas:</p> <ul> <li> <p>Se a SMS alterar fortemente o layout dos relatórios, será necessário ajustar o código.</p> </li> </ul> </li> <li> <p>O executável foi pensado para rodar sem instalação de dependências.</p> </li> <li> <p>Em caso de erro:</p> <ul> <li> <p>Verifique se o arquivo realmente corresponde ao relatório indicado.</p> </li> <li> <p>Confirme se o arquivo não foi aberto simultaneamente por outro programa (como Excel).</p> </li> </ul> </li> </ul> <p> </p> <p> </p> </li> </ul>
format Recurso digital
id zenodo_https___doi_org_10_5281_zenodo_17796260
institution Zenodo
language por
publishDate 2025
publisher Zenodo
record_format zenodo
spellingShingle Indicadores CAPS – Monitoramento e Gestão de Metas em Saúde Mental
Gabriel da Silva Fernandes
saude mental
caps
indicadores
sus
gestão
metas
monitoramento
python
saude pubilca
software livre
<ul> <li> <p> </p> <p>Indicadores CAPS – Versão 5.0<br>Monitoramento e Gestão de Metas em Saúde Mental (Variável 2 + Variável 3)</p> <h2>1. Introdução</h2> <p>O <strong>Indicadores CAPS 5.0</strong> é uma aplicação desktop (Windows, formato <code>.exe</code>) desenvolvida em Python com interface gráfica em Tkinter + ttkbootstrap.</p> <p>Ele foi pensado para gestores e equipes de CAPS que usam o PCSM e precisam:</p> <ul> <li> <p>Importar relatórios oficiais (RAAS, BPA-I, BPA-C, 166, 193, 293, 156, 282, 121, 149, 151, 160, 180, 181, 307 etc.).</p> </li> <li> <p>Calcular automaticamente indicadores operacionais com metas da <strong>Variável 2</strong> (Atendimento Familiar, Reabilitação Psicossocial em instituição, Matriciamento, Busca Ativa, Atendimento Individual, Completude Cadastral…).</p> </li> <li> <p>Calcular, em um painel próprio, os indicadores da <strong>Variável 3</strong> (Gestantes, Comorbidades, Lesão Autoprovocada/Tentativa, Situação de Rua, Vacinação, Notificações de Tuberculose, Inserção/Permanência Escolar em CAPSi).</p> </li> <li> <p>Gerar relatórios textuais prontos para WhatsApp (com emojis).</p> </li> <li> <p>Produzir planilhas Excel por profissional, com destaque das pendências.</p> </li> <li> <p>Manter um histórico diário em banco SQLite, com visualização gráfica da evolução dos indicadores.</p> </li> </ul> <p>A lógica continua a mesma:</p> <ol> <li> <p>Você importa os relatórios do PCSM.</p> </li> <li> <p>Configura metas da unidade.</p> </li> <li> <p>Clica em <strong>Calcular Indicadores</strong> (Variável 2) ou <strong>Calcular Variável 3</strong>.</p> </li> <li> <p>O programa entrega:</p> <ul> <li> <p>Um texto completo, pronto para colar em grupo de coordenação.</p> </li> <li> <p>Arquivos Excel com demandas organizadas por profissional.</p> </li> <li> <p>Indicadores salvos num histórico para análise gráfica ao longo do tempo.</p> </li> <li> <p>No caso da Variável 3, um resumo por componente com cálculo de UC (unidade de cobrança) e listas de aptos/inaptos.</p> </li> </ul> </li> </ol> <h2>2. Novidades da Versão 5.0 (em relação à 4.4.1)</h2> <h3> Painel completo da Variável 3</h3> <ul> <li> <p>Nova coluna dedicada <strong>“Variável 3 – Indicadores Específicos”</strong>.</p> </li> <li> <p>Campo de seleção de <strong>competência (mês/ano)</strong> para os indicadores que dependem do período (especialmente Rel. 307 – Lesão Autoprovocada).</p> </li> <li> <p>Campo para informar se o serviço é <strong>CAPS adulto</strong> ou <strong>CAPSi</strong>, ativando o indicador de <strong>Inserção/Permanência Escolar</strong> (Rel. 181) apenas quando faz sentido.</p> </li> <li> <p>Botões próprios para carregar:</p> <ul> <li> <p><strong>Rel. 121 – Comorbidades (HAS/DM)</strong></p> </li> <li> <p><strong>Rel. 160 – Gestantes (com integração ao Rel. 95 de data de cadastro)</strong></p> </li> <li> <p><strong>Rel. 180 – Vacinação</strong></p> </li> <li> <p><strong>Rel. 149 – Notificações de Tuberculose (campo SINAN)</strong></p> </li> <li> <p><strong>Rel. 151 – Situação de Rua</strong></p> </li> <li> <p><strong>Rel. 181 – Inserção/Permanência na Escola (CAPSi)</strong></p> </li> <li> <p><strong>Rel. 307 – Lesão Autoprovocada/Tentativa de suicídio</strong></p> </li> </ul> </li> <li> <p>Botão <strong>“Calcular Variável 3”</strong> que:</p> <ul> <li> <p>Junta todos os indicadores carregados.</p> </li> <li> <p>Calcula as UCs de cada componente.</p> </li> <li> <p>Gera texto consolidado para WhatsApp.</p> </li> <li> <p>Pode gerar planilhas auxiliares para alguns indicadores (ex.: Lesão Autoprovocada, Situação de Rua).</p> </li> </ul> </li> </ul> <h3> Indicador de Comorbidades – Rel. 121</h3> <ul> <li> <p>Leitura automática do <strong>Rel. 121</strong> (HAS/DM), com detecção de cabeçalho.</p> </li> <li> <p>Lê, de forma robusta:</p> <ul> <li> <p>Número de pacientes ativos considerados no relatório.</p> </li> <li> <p>Total de pessoas com <strong>Hipertensão</strong>.</p> </li> <li> <p>Total de pessoas com <strong>Diabetes</strong>.</p> </li> <li> <p>Percentuais (quando já calculados no relatório) ou cálculo automático a partir dos ativos.</p> </li> </ul> </li> <li> <p>Indicador da Variável 3 com metas padrão:</p> <ul> <li> <p><strong>HAS:</strong> prevalência mínima ≥ 27% dos ativos.</p> </li> <li> <p><strong>DM:</strong> prevalência mínima ≥ 8% dos ativos.</p> </li> </ul> </li> <li> <p>Cálculo de UC:</p> <ul> <li> <p>Até <strong>100 UC</strong> para HAS.</p> </li> <li> <p>Até <strong>100 UC</strong> para DM.</p> </li> <li> <p>Total <strong>0–200 UC</strong> para Comorbidades.</p> </li> </ul> </li> <li> <p>Aviso se o número de “ativos” do Rel. 121 divergir do carregado no Rel. 166.</p> </li> </ul> <h3> Indicador de Gestantes – Rel. 160 + Rel. 95</h3> <ul> <li> <p>Integração mais sofisticada dos relatórios:</p> <ul> <li> <p><strong>Rel. 160 – Gestantes</strong></p> </li> <li> <p><strong>Rel. 95 – Data de cadastro</strong> (para definir corretamente em qual trimestre a gestante passa a contar).</p> </li> </ul> </li> <li> <p>Lógica por <strong>trimestre fixo</strong>:</p> <ul> <li> <p>1º trimestre: <strong>Fevereiro, Março, Abril</strong></p> </li> <li> <p>2º trimestre: <strong>Maio, Junho, Julho</strong></p> </li> <li> <p>3º trimestre: <strong>Agosto, Setembro, Outubro</strong></p> </li> <li> <p>4º trimestre: <strong>Novembro, Dezembro, Janeiro</strong></p> </li> </ul> </li> <li> <p>O programa:</p> <ul> <li> <p>Identifica quais gestantes realmente “entram” no trimestre analisado (a partir da data de cadastro).</p> </li> <li> <p>Monta listas de <strong>APTAS</strong> e <strong>INAPTAS</strong> conforme os critérios estabelecidos.</p> </li> <li> <p>Gera cards por profissional, com detalhes de cada gestante.</p> </li> </ul> </li> <li> <p>Texto pronto para WhatsApp + opção de planilhas auxiliares.</p> </li> </ul> <h3> Indicador de Lesão Autoprovocada / Tentativa – Rel. 307 (layout novo)</h3> <ul> <li> <p>Implementação atualizada do <strong>Rel. 307</strong>, acompanhando o novo layout:</p> <ul> <li> <p>Agora sem coluna “tipo”, usando <strong>Data de Origem/Notificação/Comunicação</strong>.</p> </li> <li> <p>Campo de competência (mês/ano) definido na própria aba da Variável 3.</p> </li> </ul> </li> <li> <p>O programa:</p> <ul> <li> <p>Lê o CSV de forma robusta (latin-1 ou utf-8-sig).</p> </li> <li> <p>Mapeia as colunas por <strong>palavras-chave</strong> (prontuário, nome, data, profissional).</p> </li> <li> <p>Filtra automaticamente os registros apenas da competência selecionada (mês/ano).</p> </li> <li> <p>Tudo que fica fora do período vai para uma lista separada, com o motivo (por exemplo: “fora da competência” ou “sem data de referência”).</p> </li> </ul> </li> <li> <p>Gera:</p> <ul> <li> <p>Cards por profissional com os casos da competência.</p> </li> <li> <p>Lista dos fora do período (útil para limpeza/ajuste no PCSM).</p> </li> <li> <p>Texto de resumo para Var.3, com contagens e UC.</p> </li> </ul> </li> </ul> <h3> ‍♀️ Situação de Rua – Rel. 151 (Indicador Var.3)</h3> <ul> <li> <p>Leitura do <strong>Relatório 151 – Situação de Rua</strong> com foco na Variável 3.</p> </li> <li> <p>Para cada usuário em situação de rua, o indicador checa no período:</p> <ul> <li> <p>Se houve <strong>articulação em rede</strong> (tipo de atendimento adequado).</p> </li> <li> <p>Se foi realizado <strong>teste rápido de HIV</strong>.</p> </li> <li> <p>Se foi realizado <strong>teste rápido de sífilis</strong>.</p> </li> </ul> </li> <li> <p>O usuário só entra como <strong>APTO</strong> se satisfizer o conjunto de critérios.</p> </li> <li> <p>O relatório gera:</p> <ul> <li> <p>Contagem de aptos/inaptos.</p> </li> <li> <p>Cards por profissional com o motivo de estar fora do indicador (ex.: faltou teste de HIV, faltou articulação etc.).</p> </li> <li> <p>Cálculo de UC específico de Situação de Rua dentro da Variável 3.</p> </li> </ul> </li> </ul> <h3> Vacinação – Rel. 180 (Var.3)</h3> <ul> <li> <p>Leitura do <strong>Rel. 180 – Vacinação</strong> dentro da aba Variável 3.</p> </li> <li> <p>O programa:</p> <ul> <li> <p>Consolida por faixa etária/critério definido no relatório.</p> </li> <li> <p>Calcula a cobertura e compara com a meta (por exemplo 85% — ajustável conforme norma adotada).</p> </li> </ul> </li> <li> <p>Saída:</p> <ul> <li> <p>Resumo com total de usuários elegíveis.</p> </li> <li> <p>Quantos estão com vacina em dia.</p> </li> <li> <p>Cálculo de UC de vacinação na Variável 3.</p> </li> </ul> </li> </ul> <h3> Notificações de Tuberculose – Rel. 149 (SINAN)</h3> <ul> <li> <p>Leitura do <strong>Rel. 149 – Notificações (Tuberculose)</strong>.</p> </li> <li> <p>Lógica focada na meta da Variável 3:</p> <ul> <li> <p>Filtra o trimestre correto.</p> </li> <li> <p>Separa notificações “com SINAN lançado” x “sem SINAN”.</p> </li> <li> <p>Desconsidera notificações do trimestre anterior trazidas junto no relatório.</p> </li> </ul> </li> <li> <p>Gera:</p> <ul> <li> <p>Resumo por profissional com quantas notificações estão completas (com SINAN) e quantas ainda não.</p> </li> <li> <p>Texto consolidado para Var.3 com cálculo de UC específico de TB.</p> </li> </ul> </li> </ul> <h3> Inserção/Permanência Escolar – Rel. 181 (para CAPSi)</h3> <ul> <li> <p>Ativo apenas quando o serviço é configurado como <strong>CAPSi</strong>.</p> </li> <li> <p>Leitura do <strong>Rel. 181</strong>:</p> <ul> <li> <p>Conta quantos usuários deveriam estar na escola.</p> </li> <li> <p>Quantos estão de fato matriculados e em acompanhamento.</p> </li> </ul> </li> <li> <p>Compara com a meta da Variável 3 (por exemplo, ≥ 80% em escola).</p> </li> <li> <p>Gera:</p> <ul> <li> <p>Texto com resumo (elegíveis, na escola, fora).</p> </li> <li> <p>Cálculo de UC escolar dentro da Var.3.</p> </li> </ul> </li> </ul> <h3> Interface visual aprimorada</h3> <ul> <li> <p>Papel de parede de fundo mais escuro, mantendo o destaque para os painéis.</p> </li> <li> <p><strong>Imagem exclusiva na coluna central</strong> (CAPS2.png/jpg/jpeg) com recorte automático que se ajusta ao tamanho da janela.</p> </li> <li> <p>Mantém o clima de “painel de comando” do CAPS, mas com visual mais limpo.</p> </li> </ul> <h2>3. Instalação e Execução</h2> <h3>3.1. Versão .exe (recomendada)</h3> <ul> <li> <p>Baixe o arquivo <code>Indicadores_CAPS_5.0.exe</code> (ou nome equivalente) a partir do Zenodo.</p> </li> <li> <p>Coloque o <code>.exe</code> em uma pasta de sua preferência (idealmente junto dos arquivos auxiliares, como vídeo/GIF do splash e imagens CAPS.png/CAPS2.png, se fornecidos).</p> </li> <li> <p>Dê duplo-clique para executar em qualquer máquina Windows.</p> </li> <li> <p>Não é necessário ter Python instalado.</p> </li> <li> <p>Aguarde a tela de splash completar (0–100%).</p> </li> <li> <p>Ao final, a janela principal é exibida.</p> </li> </ul> <h3>3.2. Execução via código fonte (opcional)</h3> <p>Se preferir rodar o <code>.py</code> diretamente:</p> <ul> <li> <p>Requer Python 3.x e os pacotes principais:</p> <ul> <li> <p><code>tkinter</code>, <code>ttkbootstrap</code></p> </li> <li> <p><code>matplotlib</code></p> </li> <li> <p><code>pandas</code></p> </li> <li> <p><code>openpyxl</code></p> </li> <li> <p><code>sqlite3</code></p> </li> </ul> </li> <li> <p>Instale as dependências (<code>pip install ...</code>) e execute:</p> </li> </ul> <pre><code>python app.py </code></pre> <h2>4. Tela de Splash</h2> <ul> <li> <p>Exibe um vídeo/GIF em loop (por exemplo, <code>CAPS.mp4</code>) com:</p> <ul> <li> <p>Barra de progresso de 0% a 100%.</p> </li> <li> <p>Mensagens de carregamento em tom leve e motivador.</p> </li> </ul> </li> <li> <p>Ao terminar o carregamento, abre a janela principal.</p> </li> <li> <p>A imagem de fundo estática (CAPS.png) pode ser usada como “wallpaper” geral, e a CAPS2.png fica como papel de parede da coluna central.</p> </li> </ul> <h2>5. Estrutura da Interface</h2> <p>A janela principal é organizada em três grandes blocos:</p> <ol> <li> <p><strong>Banner Superior</strong></p> <ul> <li> <p>Faixa com o título:</p> <ul> <li> <p>“<strong>Indicadores CAPS – Bora Bater Meta Gente!</strong>”</p> </li> </ul> </li> <li> <p>Pode incluir gradiente e imagem de fundo.</p> </li> </ul> </li> <li> <p><strong>Coluna Esquerda – Variável 2 / Importação de Relatórios Base</strong></p> <ul> <li> <p>Painel com botões para cada relatório do PCSM usado nos indicadores operacionais:</p> <ul> <li> <p>Pacientes Ativos – <strong>Rel. 166 – Var 2</strong></p> </li> <li> <p>RAAS – <strong>Rel. 20 – Var 2</strong></p> </li> <li> <p>BPA-I – <strong>Rel. 12 – Var 2</strong></p> </li> <li> <p>BPA-C – <strong>Rel. 277 – Var 2</strong></p> </li> <li> <p>Internações Psiquiátricas – <strong>Rel. 148 – Var 2</strong></p> </li> <li> <p>Pacientes em Instituição – <strong>Rel. 18 (+112) – Var 2</strong></p> </li> <li> <p>Busca Ativa – <strong>Rel. 0007 – Var 2</strong></p> </li> <li> <p>Unidades Matriciadas – <strong>Rel. 153 – Var 2</strong></p> </li> <li> <p>Pacientes sem PTS – <strong>Rel. 193 – Var 2</strong></p> </li> <li> <p>Completude Cadastral – <strong>Rel. 293 – Var 2</strong></p> </li> <li> <p>Relatório 156 – CID</p> </li> <li> <p>Relatório 282 – Reinserção Produtiva</p> </li> </ul> </li> <li> <p>Ao lado de cada botão, um <strong>label de status</strong> mostra:</p> <ul> <li> <p>Se o arquivo foi carregado.</p> </li> <li> <p>Quantos registros foram lidos.</p> </li> <li> <p>Resumos importantes (ex.: “156 (CID): com X | sem Y”, “282: CAPS X – Total N (Acomp. A | Busca B)”).</p> </li> </ul> </li> </ul> </li> <li> <p><strong>Coluna Direita – Variável 3</strong></p> <p>Painel próprio com:</p> <ul> <li> <p>Campos de configuração da <strong>Variável 3</strong>:</p> <ul> <li> <p>Seleção de <strong>competência</strong> (mês/ano).</p> </li> <li> <p>Seleção do tipo de serviço (<strong>CAPS adulto / CAPSi</strong>).</p> </li> </ul> </li> <li> <p>Botões de importação específicos:</p> <ul> <li> <p><strong>Comorbidades – Rel. 121</strong></p> </li> <li> <p><strong>Gestantes – Rel. 160</strong> (com uso opcional da integração Rel. 95 já carregada no backend da aplicação)</p> </li> <li> <p><strong>Vacinação – Rel. 180</strong></p> </li> <li> <p><strong>Notificações TB – Rel. 149</strong></p> </li> <li> <p><strong>Situação de Rua – Rel. 151</strong></p> </li> <li> <p><strong>Inserção/Permanência Escolar – Rel. 181</strong> (visível/ativo apenas para CAPSi)</p> </li> <li> <p><strong>Lesão Autoprovocada/Tentativa – Rel. 307</strong></p> </li> </ul> </li> <li> <p>Labels de status resumindo:</p> <ul> <li> <p>Quantos registros cada relatório trouxe.</p> </li> <li> <p>Se houve filtro por competência (307).</p> </li> <li> <p>Observações úteis (ex.: diferença entre ativos do Rel. 121 e do 166).</p> </li> </ul> </li> </ul> </li> <li> <p><strong>Painel Central / Ações e Saída</strong></p> <ul> <li> <p><strong>Painel de Indicadores Gerais (Var. 2)</strong>:</p> <ul> <li> <p>Campos que mostram:</p> <ul> <li> <p>Total de pacientes ativos.</p> </li> <li> <p>Totais de RAAS, BPA-I e BPA-C.</p> </li> <li> <p>Resumo de institucionalizados com RP/BA.</p> </li> <li> <p>Resumo de completude, CID e reinserção produtiva (quando carregados).</p> </li> </ul> </li> </ul> </li> <li> <p><strong>Painel de Ações / Botões Principais (Var. 2 + extras)</strong>:</p> <ul> <li> <p> <strong>Calcular Indicadores</strong> (Variável 2)</p> </li> <li> <p>⭐ <strong>Copiar Relatório</strong> (texto da Variável 2 para WhatsApp)</p> </li> <li> <p> <strong>Configurar Metas</strong> (AF, RP, BA, AI, completude etc.)</p> </li> <li> <p>⏰ <strong>Separar por Prof.</strong> (planilhas de demandas gerais por profissional)</p> </li> <li> <p> <strong>Busca Ativa por Prof.</strong></p> </li> <li> <p> <strong>Sem Prof. Ref.</strong> (lista textos + .txt + Excel)</p> </li> <li> <p> <strong>Sem PTS por Prof.</strong></p> </li> <li> <p> <strong>Clínicas de Família / CMS</strong></p> </li> <li> <p> <strong>Panorama CAPS</strong> (resumo compacto com emojis)</p> </li> <li> <p> <strong>Histórico / Gráficos</strong></p> </li> <li> <p> <strong>Procedimentos (RAAS/BPA)</strong> (planilhas consolidadas por profissional)</p> </li> <li> <p> <strong>Ranking TOP20</strong> (pendências por profissional)</p> </li> <li> <p> <strong>Gráfico de Completude</strong> (quando o Rel. 293 está carregado)</p> </li> </ul> </li> <li> <p><strong>Painel de Ações – Variável 3</strong>:</p> <ul> <li> <p>Botão <strong>Calcular Variável 3</strong>:</p> <ul> <li> <p>Gera o texto consolidado dos indicadores da Var.3.</p> </li> <li> <p>Atualiza o painel de saída.</p> </li> <li> <p>Copia para a área de transferência.</p> </li> </ul> </li> <li> <p>Botão <strong>Copiar texto Var. 3</strong> (quando implementado) ou reaproveitamento da própria função de cálculo.</p> </li> </ul> </li> <li> <p><strong>Painel de Saída de Texto</strong>:</p> <ul> <li> <p>Área de texto com rolagem (ScrolledText) onde:</p> <ul> <li> <p>O relatório final da Variável 2 é exibido.</p> </li> <li> <p>O relatório da Variável 3 também pode ser exibido.</p> </li> <li> <p>Tudo em formato amigável para copia/cola em WhatsApp, com emojis e marcadores.</p> </li> </ul> </li> </ul> </li> </ul> </li> </ol> <h2>6. Passo a Passo de Uso</h2> <h3>6.1. Abrir o programa</h3> <ol> <li> <p>Execute o <code>.exe</code>.</p> </li> <li> <p>Aguarde a tela de splash completar.</p> </li> <li> <p>A janela principal será aberta (modo maximizado, até 1280×720 ou conforme tela).</p> </li> </ol> <h3>6.2. Importar arquivos de relatórios – Variável 2</h3> <p>Para cada relatório PCSM, clique no botão correspondente e selecione o arquivo (.csv ou .xlsx, conforme o caso).</p> <p>Resumo:</p> <ul> <li> <p><strong>Pacientes Ativos – Rel. 166</strong></p> <ul> <li> <p>Campos esperados: Nome, Profissional Primário, Profissional Secundário, Status (B = Busca Ativa).</p> </li> <li> <p>O programa cria índices internos por paciente e profissional, cuidando de homônimos.</p> </li> </ul> </li> <li> <p><strong>RAAS – Rel. 20</strong></p> <ul> <li> <p>Conta:</p> <ul> <li> <p>Atendimentos familiares.</p> </li> <li> <p>Registros de Reabilitação Psicossocial em instituição (RP).</p> </li> <li> <p>Atendimentos individuais.</p> </li> <li> <p>Registros de Busca Ativa.</p> </li> </ul> </li> <li> <p>Atualiza contadores internos e labels na tela.</p> </li> </ul> </li> <li> <p><strong>BPA-I – Rel. 12</strong> e <strong>BPA-C – Rel. 277</strong></p> <ul> <li> <p>Usados para compor o total de procedimentos e o cálculo de % de Atendimento Individual.</p> </li> <li> <p>Leitura robusta, apenas somando linhas relevantes.</p> </li> </ul> </li> <li> <p><strong>Internações Psiquiátricas – Rel. 148</strong></p> <ul> <li> <p>Lê CPS, nome do paciente e outros campos.</p> </li> <li> <p>Gera uma lista de internações, usada no relatório e nas demandas.</p> </li> </ul> </li> <li> <p><strong>Pacientes em Instituição – Rel. 18 (+ Rel. 112 opcional)</strong></p> <ul> <li> <p>Lê nome, tipo de moradia, instituição, etc.</p> </li> <li> <p>Pode ser complementado com o Rel. 112 – Busca ativa realizada no período, para identificar quem foi visitado.</p> </li> </ul> </li> <li> <p><strong>Busca Ativa – Rel. 0007</strong></p> <ul> <li> <p>Deduplica registros por paciente, mantendo a data mais recente.</p> </li> <li> <p>Usa os campos de paciente, profissional de referência, data, tipo.</p> </li> </ul> </li> <li> <p><strong>Unidades Matriciadas – Rel. 153</strong></p> <ul> <li> <p>Limpa os nomes de unidades, remove duplicatas.</p> </li> <li> <p>Preenche a lista de unidades para o cálculo de Matriciamento (≥ 60% de CAPS matriciados).</p> </li> </ul> </li> <li> <p><strong>Pacientes sem PTS – Rel. 193</strong></p> <ul> <li> <p>Lê pacientes sem PTS e tenta vincular a um UID do 166 por:</p> <ul> <li> <p>ID de prontuário, quando possível.</p> </li> <li> <p>Nome, em último caso, evitando homônimos ambíguos.</p> </li> </ul> </li> <li> <p>Exporta um <code>SEM_PTS_AMBIGUOS.csv</code> quando há conflitos.</p> </li> </ul> </li> <li> <p><strong>Completude Cadastral – Rel. 293</strong></p> <ul> <li> <p>Calcula, para cada paciente ativo:</p> <ul> <li> <p>Se possui cadastro completo.</p> </li> <li> <p>Quais campos estão faltando (benefício, gênero, tipo de moradia).</p> </li> </ul> </li> <li> <p>Gera rótulos de pendências usados nas planilhas de demandas e no ranking TOP20.</p> </li> </ul> </li> <li> <p><strong>Relatório 156 – CID</strong></p> <ul> <li> <p>Conta:</p> <ul> <li> <p>Total de pacientes com CID.</p> </li> <li> <p>Total de pacientes sem CID (campo vazio ou “sem CID”).</p> </li> </ul> </li> <li> <p>Exibe resumo no label e adiciona essas informações no relatório de indicadores e no Panorama CAPS.</p> </li> </ul> </li> <li> <p><strong>Relatório 282 – Reinserção Produtiva</strong></p> <ul> <li> <p>Solicita a escolha de um CAPS da lista (apenas na primeira vez).</p> </li> <li> <p>Conta, apenas para o CAPS escolhido:</p> <ul> <li> <p>Total de casos em Reinserção Produtiva.</p> </li> <li> <p>Quantos estão em Acompanhamento.</p> </li> <li> <p>Quantos em Busca Ativa.</p> </li> </ul> </li> <li> <p>Esses números entram no relatório de indicadores e no Panorama CAPS.</p> </li> </ul> </li> </ul> <h3>6.3. Importar arquivos – Variável 3</h3> <p>Na coluna da Variável 3:</p> <ol> <li> <p>Defina <strong>competência (mês/ano)</strong> e se o serviço é <strong>CAPS</strong> ou <strong>CAPSi</strong>.</p> </li> <li> <p>Carregue:</p> <ul> <li> <p><strong>Comorbidades – Rel. 121</strong><br>CSV com prevalência de HAS/DM por pacientes ativos.</p> </li> <li> <p><strong>Gestantes – Rel. 160</strong><br>(o programa usa também as informações de cadastro do Rel. 95, já integradas no núcleo de dados).</p> </li> <li> <p><strong>Vacinação – Rel. 180</strong><br>Relatório de vacinação da unidade.</p> </li> <li> <p><strong>Situação de Rua – Rel. 151</strong><br>Pacientes em situação de rua vinculados ao CAPS.</p> </li> <li> <p><strong>Notificações TB – Rel. 149</strong><br>Notificações de Tuberculose com campo SINAN.</p> </li> <li> <p><strong>Inserção/Permanência Escolar – Rel. 181</strong> (CAPSi)</p> </li> <li> <p><strong>Lesão Autoprovocada – Rel. 307</strong><br>Atenção ao layout novo do CSV: o programa já está adaptado.</p> </li> </ul> </li> </ol> <p>Os labels ao lado de cada botão informam quantos registros foram lidos e se houve filtros por competência.</p> <h3>6.4. Configurar Metas (Variável 2 e parâmetros gerais)</h3> <p>Ao clicar em <strong>Configurar Metas</strong>, é aberta uma janela para ajuste dos parâmetros, por exemplo:</p> <ul> <li> <p>Percentual mínimo de:</p> <ul> <li> <p>Atendimento Familiar.</p> </li> <li> <p>Reabilitação Psicossocial em Instituição.</p> </li> <li> <p>Busca Ativa (relação com ativos ou institucionalizados).</p> </li> <li> <p>Atendimento Individual (limite máximo %).</p> </li> </ul> </li> <li> <p>Alvo de projeção em BA (número de pacientes a alcançar).</p> </li> <li> <p>Meta de Completude Cadastral (percentual).</p> </li> </ul> <p>As configurações são salvas em <code>indicadores_config.json</code>.</p> <h3>6.5. Calcular Indicadores – Variável 2</h3> <p>O botão <strong>Calcular Indicadores</strong>:</p> <ul> <li> <p>Pergunta (na primeira vez) se deseja ativar o <strong>Modo Sigiloso</strong>:</p> <ul> <li> <p>Quando ligado, os nomes dos profissionais são ocultados (Profissional #01, #02…).</p> </li> </ul> </li> <li> <p>Gera um relatório completo com seções como:</p> <ul> <li> <p> ‍ ‍ Atendimento Familiar vs. meta</p> </li> <li> <p> Reabilitação Psicossocial em Instituição (RP / BA RAAS / BA 112)</p> </li> <li> <p> Matriciamento de Unidades</p> </li> <li> <p> ⚕️ Atendimento Individual vs. meta, com ranking dos profissionais que mais fazem AI</p> </li> <li> <p> Resumo CID (Rel. 156) – pacientes com/sem CID</p> </li> <li> <p> Reinserção Produtiva (Rel. 282) – total, acompanhamento, busca ativa</p> </li> <li> <p> Busca Ativa vs. meta e projeção até o alvo</p> </li> <li> <p> Pacientes sem PTS e sem Profissional de Referência (síntese)</p> </li> </ul> </li> </ul> <p>O texto é exibido no painel, copiado para a área de transferência e salvo como <code>resultado.txt</code>.<br>Os indicadores do dia são gravados em <code>historico_indicadores.db</code>.</p> <h3>6.6. Calcular Indicadores – Variável 3</h3> <p>O botão <strong>Calcular Variável 3</strong>:</p> <ul> <li> <p>Verifica se os relatórios essenciais para Var.3 foram carregados (166, 0007, e pelo menos alguns dos 121/149/151/160/180/181/307).</p> </li> <li> <p>Usa a competência definida (mês/ano) para o que depende de período (especialmente 307 e ajustes de trimestre em gestantes).</p> </li> <li> <p>Gera um relatório com blocos como:</p> <ul> <li> <p> <strong>Comorbidades (Rel. 121)</strong></p> <ul> <li> <p>Ativos considerados, HAS, DM, percentuais.</p> </li> <li> <p>UC HAS, UC DM, UC total.</p> </li> </ul> </li> <li> <p> <strong>Gestantes (Rel. 160 + 95)</strong></p> <ul> <li> <p>Trimestre analisado.</p> </li> <li> <p>Quantas gestantes entram no período.</p> </li> <li> <p>Aptas x inaptas, com cards por profissional.</p> </li> </ul> </li> <li> <p> <strong>Vacinação (Rel. 180)</strong></p> <ul> <li> <p>Cobertura, elegíveis, UC de vacinação.</p> </li> </ul> </li> <li> <p> ‍♀️ <strong>Situação de Rua (Rel. 151)</strong></p> <ul> <li> <p>Quantos usuários em situação de rua.</p> </li> <li> <p>Quantos têm articulação + TR HIV + TR Sífilis.</p> </li> <li> <p>Aptos x inaptos, UC específica.</p> </li> </ul> </li> <li> <p> <strong>Notificações TB (Rel. 149)</strong></p> <ul> <li> <p>Notificações com SINAN x sem SINAN.</p> </li> <li> <p>Controle de trimestre correto.</p> </li> <li> <p>UC de TB.</p> </li> </ul> </li> <li> <p> <strong>Lesão Autoprovocada/Tentativa (Rel. 307)</strong></p> <ul> <li> <p>Casos na competência.</p> </li> <li> <p>Casos fora da competência (em lista auxiliar).</p> </li> <li> <p>Cards por profissional.</p> </li> </ul> </li> <li> <p> <strong>Inserção/Permanência Escolar (Rel. 181 – CAPSi)</strong></p> <ul> <li> <p>Elegíveis x matriculados.</p> </li> <li> <p>Cobertura e UC escolar.</p> </li> </ul> </li> </ul> </li> <li> <p>Ao final, pode apresentar um <strong>resumo de UC total da Variável 3</strong> (somatório dos componentes) e, se configurado, copiar o texto direto para a área de transferência.</p> </li> </ul> <h3>6.7. Relatórios e Planilhas de Demandas</h3> <p>As ações extras da Variável 2 continuam:</p> <ul> <li> <p>⏰ <strong>Separar por Profissional</strong></p> <ul> <li> <p>Gera <code>Demandas profissionais</code> na Área de Trabalho, com:</p> <ul> <li> <p>Planilhas por profissional, trazendo:</p> <ul> <li> <p>Pacientes ativos.</p> </li> <li> <p>Situação de PTS.</p> </li> <li> <p>Situação em instituição.</p> </li> <li> <p>Pendências de completude.</p> </li> </ul> </li> <li> <p>Células críticas destacadas em vermelho.</p> </li> </ul> </li> </ul> </li> <li> <p> <strong>Busca Ativa por Profissional</strong></p> <ul> <li> <p>Gera pastas/planilhas com Busca Ativa agrupada por profissional.</p> </li> </ul> </li> <li> <p> <strong>Sem Prof. Ref.</strong></p> <ul> <li> <p>Lista pacientes ativos sem nenhum profissional vinculado.</p> </li> <li> <p>Copia texto para WhatsApp e salva <code>.txt</code>.</p> </li> </ul> </li> <li> <p> <strong>Sem PTS por Prof.</strong></p> <ul> <li> <p>Agrupa todos os pacientes sem PTS por profissional de referência.</p> </li> <li> <p>Exibe texto e grava arquivo <code>.txt</code>.</p> </li> </ul> </li> <li> <p> <strong>Procedimentos (RAAS/BPA)</strong></p> <ul> <li> <p>Consolida RAAS, BPA-I e BPA-C em um arquivo Excel com:</p> <ul> <li> <p>Aba por profissional.</p> </li> <li> <p>Filtros e larguras de colunas automáticas.</p> </li> <li> <p>Marcação em vermelho de:</p> <ul> <li> <p>Pacientes sem PTS.</p> </li> <li> <p>Pacientes em instituição sem RP/BA.</p> </li> <li> <p>Pendências de completude.</p> </li> </ul> </li> </ul> </li> </ul> </li> <li> <p> <strong>Ranking TOP20</strong></p> <ul> <li> <p>Monta um ranking dos profissionais com mais pendências (PTS + instituição + completude).</p> </li> <li> <p>Gera texto para discussão e planilha de apoio.</p> </li> </ul> </li> <li> <p> <strong>Clínicas de Família / CMS</strong></p> <ul> <li> <p>Interface para configurar lista de unidades disponíveis e selecionadas.</p> </li> <li> <p>Salva em <code>clinicas_familia.json</code>, usado no cálculo de Matriciamento.</p> </li> </ul> </li> <li> <p> <strong>Panorama CAPS</strong></p> <ul> <li> <p>Cria um resumo curto, com emojis, mostrando:</p> <ul> <li> <p>Ativos, BA, sem PTS, sem profissional de referência.</p> </li> <li> <p>Total de procedimentos.</p> </li> <li> <p>Internações.</p> </li> <li> <p>Institucionalizados atendidos/total.</p> </li> <li> <p>Unidades matriciadas.</p> </li> <li> <p>CID (com/sem).</p> </li> <li> <p>Reinserção produtiva (total, em acompanhamento, em BA).</p> </li> </ul> </li> </ul> </li> <li> <p> <strong>Histórico / Gráficos</strong></p> <ul> <li> <p>Permite escolher um indicador (AF, RP, BA, AI, completude etc.).</p> </li> <li> <p>Exibe gráfico com:</p> <ul> <li> <p>Linha de meta.</p> </li> <li> <p>Média móvel.</p> </li> <li> <p>Pontos por dia/semana/mês.</p> </li> </ul> </li> <li> <p>Permite excluir registros do histórico, se necessário.</p> </li> </ul> </li> <li> <p> <strong>Gráfico de Completude</strong></p> <ul> <li> <p>Quando o Rel. 293 está carregado:</p> <ul> <li> <p>Exibe gráfico de pizza com % de cadastro completo.</p> </li> <li> <p>Exibe barras mostrando quais campos mais faltam (benefício, gênero, moradia).</p> </li> </ul> </li> </ul> </li> </ul> <h2>7. Estrutura de Arquivos Gerados</h2> <p>O programa cria e atualiza alguns arquivos:</p> <ul> <li> <p><code>resultado.txt</code></p> <ul> <li> <p>Último relatório completo da Variável 2 (e, se desejado, pode ser reaproveitado para Var.3).</p> </li> </ul> </li> <li> <p><code>historico_indicadores.db</code></p> <ul> <li> <p>Banco SQLite com tabela <code>historico</code>, armazenando indicadores diários (AF, RP, BA, AI, completude, CID, reinserção, etc.).</p> </li> </ul> </li> <li> <p><code>clinicas_familia.json</code></p> <ul> <li> <p>Configuração de unidades de atenção básica para cálculo de Matriciamento.</p> </li> </ul> </li> <li> <p><code>indicadores_config.json</code></p> <ul> <li> <p>Metas e parâmetros definidos na tela de configuração.</p> </li> </ul> </li> <li> <p>Pastas na Área de Trabalho, como:</p> <ul> <li> <p><code>Demandas profissionais/</code></p> </li> <li> <p><code>Demandas busca ativa/</code></p> </li> <li> <p>Planilhas consolidadas de procedimentos (RAAS/BPA).</p> </li> </ul> </li> <li> <p>Arquivos auxiliares de ambiguidade:</p> <ul> <li> <p><code>SEM_PTS_AMBIGUOS.csv</code> – pacientes sem PTS com ID / nome ambíguo entre múltiplos profissionais.</p> </li> <li> <p>Arquivos auxiliares para Var.3 (quando existirem), como planilhas de lesão autoprovocada ou fora de período.</p> </li> </ul> </li> </ul> <h2>8. Observações Importantes</h2> <ul> <li> <p>Os CSV devem usar <code>;</code> como delimitador e codificação <code>latin-1</code> ou <code>utf-8</code>, conforme exportado pelo PCSM.</p> </li> <li> <p>Sempre carregue primeiro o <strong>Rel. 166 – Pacientes Ativos</strong>, pois muitos outros relatórios dependem dele para vincular pacientes a profissionais.</p> </li> <li> <p>Para a <strong>Variável 3</strong>, é fortemente recomendado:</p> <ul> <li> <p>Definir a competência antes de carregar o Rel. 307.</p> </li> <li> <p>Conferir se os relatórios (121, 149, 151, 160, 180, 181, 307) foram exportados nos layouts mais recentes da SMS.</p> </li> </ul> </li> <li> <p>O programa tenta ser robusto a mudanças mínimas nas colunas (detectando cabeçalho e palavras-chave), mas:</p> <ul> <li> <p>Se a SMS alterar fortemente o layout dos relatórios, será necessário ajustar o código.</p> </li> </ul> </li> <li> <p>O executável foi pensado para rodar sem instalação de dependências.</p> </li> <li> <p>Em caso de erro:</p> <ul> <li> <p>Verifique se o arquivo realmente corresponde ao relatório indicado.</p> </li> <li> <p>Confirme se o arquivo não foi aberto simultaneamente por outro programa (como Excel).</p> </li> </ul> </li> </ul> <p> </p> <p> </p> </li> </ul>
title Indicadores CAPS – Monitoramento e Gestão de Metas em Saúde Mental
topic saude mental
caps
indicadores
sus
gestão
metas
monitoramento
python
saude pubilca
software livre
url https://doi.org/10.5281/zenodo.17796260

Ähnliche Einträge