================================================================================

NOME DO SCRIPT: Morcego.py PROJETO: Automação e Consolidação do Acolhimento DESENVOLVEDOR: TH3EXE VERSÃO: 3.0 (Detecção Nativa & Prevenção de Sobrescrita)

================================================================================

1. DESCRIÇÃO GERAL O script 'Morcego.py' é uma ferramenta de automação em Python desenvolvida para otimizar e padronizar o processo de importação e tratamento de bases de acolhimento (formatos .xlsx, .xls ou .csv) para a planilha oficial do Excel Online no SharePoint.

2. PRINCIPAIS FUNCIONALIDADES • Seleção Intuitiva de Arquivos: Interface gráfica (Tkinter) para escolha da base de dados de origem. • Padronização Estrita de Data: Converte e padroniza a data de entrada para o formato brasileiro (DD/MM/AAAA), evitando divergências de padrão americano. • Deduplicação Inteligente: Remove registros duplicados com base na combinação composta [Carteirinha + Usuário + Procedimento], preservando a integridade de múltiplos procedimentos para o mesmo beneficiário. • Mapeamento Posicional de Colunas: Organiza os dados exatamente no layout esperado pelo destino:

   • Coluna A: Data Entrante (DT_ALT_PE)
   • Coluna C: Base/Operadora (OPERADORA)
   • Coluna D: Carteirinha (CD_CODIGO)
   • Coluna E: Nome do Beneficiário (USUARIO)
   • Coluna H: Procedimento (NR_PROCEDIMENTO) • Relatório Resumo Local: Gera um arquivo de consolidação ('Relatorio_Resumo.xlsx') na mesma pasta de origem contendo a contagem por data e operadora. • Conexão Direta ao Navegador Aberto: Detecta automaticamente janelas do Chrome ou Edge que contenham a planilha do SharePoint/Excel Online ativa, dispensando a necessidade de reabrir o navegador ou fazer logins repetidos. • Trava de Segurança e Inserção Protegida: Inclui confirmação obrigatória e contagem regressiva para garantir que o foco do teclado esteja exatamente na célula limpa da Coluna A, prevenindo perda ou sobrescrita de dados existentes.

3. REQUISITOS E DEPENDÊNCIAS • Python 3.10+ • Pacotes Python: pandas, openpyxl, pyperclip, pyautogui, pygetwindow, tkinter • Utilitário de instalação rápida: 'instalar_dependencias.bat'

4. FLUXO DE EXECUÇÃO

   1. Executar o script 'Morcego.py'.
   2. Selecionar a planilha de origem na janela popup.
   3. Conferir o resumo impresso no terminal e o relatório salvo localmente.
   4. Garantir que a planilha oficial esteja aberta no Chrome ou Edge na primeira célula limpa da Coluna A.
   5. Confirmar com 'S' no terminal e aguardar a contagem de 3 segundos para a colagem automática dos dados via clipboard. ================================================================================