📊 Sistema de Processamento de Planilhas de Plano de Saúde

Sistema profissional para processamento mensal de planilhas de mensalidades e consultas de plano de saúde, com fluxo consistente, saneamento cadastral e validações de integridade, desenvolvido para o SINTUNIFEI.

🎯 Objetivo

Automatizar a atualização mensal das planilhas com:

• Atualização de valores de mensalidades
• Consolidação de consultas/coparticipação
• Preenchimento de CPF e dependência a partir da base de beneficiários ativos
• Validações de integridade e consistência
• Relatórios de discrepâncias e conferência

✨ Principais funcionalidades

• Geração de planilha mensal atualizada (dados_atualizados.xlsx)
• Consolidação de consultas em planilha final (dados_com_consultas.xlsx)
• Geração de base de preenchimento cadastral (beneficiarios_preenchimento.xlsx)
• Preenchimento de dados faltantes (dados_preenchidos.xlsx)
• Relatório de famílias não encontradas (nomes_nao_encontrados.xlsx)
• Validação de nulos, duplicatas e divergências
• Comparação de entradas/saídas entre meses

📁 Estrutura do projeto

.
├── 01_Processamento/                # Notebooks principais de processamento
│   ├── 1_Gerar_Nova_Planilha.ipynb   # Mensalidades
│   └── 2_Processar_Consultas.ipynb   # Consultas/Coparticipação
├── 02_Validacao/                     # Notebooks de validação e conferência
│   ├── 1_Validacao_Pos_Geracao.ipynb # Validação de mensalidades
│   └── 1.1_Validacao_Entra_Sai.ipynb # Entradas/saídas entre meses
├── 03_0utros/                        # Utilitários complementares
│   └── Preencher_Dados.ipynb         # Saneamento cadastral (CPF/DEPENDENCIA)
├── Guia_de_Uso.md                    # Guia rápido de execução
├── requirements.txt
└── README.md

✅ Requisitos

• Python 3.8+
• Jupyter Notebook/Lab
• Dependências em requirements.txt

🔧 Instalação

python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

🚀 Fluxo de trabalho mensal (rápido)

1. Gerar mensalidades
   Execute 01_Processamento/1_Gerar_Nova_Planilha.ipynb
   Resultado: dados_atualizados.xlsx

2. Validar mensalidades
   Execute 02_Validacao/1_Validacao_Pos_Geracao.ipynb

3. Processar consultas
   Execute 01_Processamento/2_Processar_Consultas.ipynb
   Resultado: dados_com_consultas.xlsx

4. Preencher dados cadastrais faltantes (quando necessário)
   Execute 03_0utros/Preencher_Dados.ipynb
   Resultados: beneficiarios_preenchimento.xlsx, dados_preenchidos.xlsx e nomes_nao_encontrados.xlsx

5. Comparar entrada/saída
   Execute 02_Validacao/1.1_Validacao_Entra_Sai.ipynb

📖 Documentação

• Guia de uso: Guia_de_Uso.md

---

Desenvolvido para o SINTUNIFEI | Sistema de Processamento de Planilhas de Plano de Saúde