Extração e Tratamento

Aplicação desktop para automatizar a extração de dois relatórios operacionais, validar os períodos, transformar as métricas e atualizar uma planilha de controle no Microsoft Excel.

Esta é uma versão anonimizada para portfólio. URLs, seletores reais, credenciais, nomes de organizações, campanhas, relatórios e planilhas operacionais não fazem parte do repositório.

Funcionalidades

• interface desktop em Tkinter;
• automação do navegador com Playwright;
• leitura e tratamento dos relatórios com pandas;
• atualização segura do Excel com xlwings;
• validação de período e regras de horário;
• seleção automática de modelo para sábado;
• histórico de relatórios organizado por data;
• logs de execução com traceback para diagnóstico;
• empacotamento para Windows com PyInstaller.

Estrutura principal

• App_Agent_HangUp.py: interface e orquestração;
• Extrator_Sistema.py: navegação e download dos relatórios;
• Automacao_Agent_HangUp.py: validação, ETL e atualização do Excel;
• config_sistema.example.ini: exemplo de configuração sem dados reais;
• build_app.ps1: geração da aplicação portátil;
• requirements_app.txt: dependências Python.

Configuração local

1. Copie config_sistema.example.ini para config_sistema.ini.
2. Preencha URLs, seletores e opções do sistema utilizado.
3. Crie 01 - ENTRADA e adicione localmente os modelos Excel necessários.
4. Instale as dependências com py -m pip install -r requirements_app.txt.
5. Instale o navegador com py -m playwright install chromium.
6. Execute py App_Agent_HangUp.py.

Os arquivos locais citados acima são ignorados pelo Git. Nunca publique credenciais, planilhas reais, relatórios baixados, logs ou capturas de tela do sistema de produção.

Build para Windows

Com o aplicativo fechado, execute:

powershell.exe -NoProfile -ExecutionPolicy Bypass -File .\build_app.ps1

O pacote será criado em dist\Agent_x_HangUp.

Observação

Os seletores do arquivo de exemplo são ilustrativos. Cada sistema possui uma estrutura própria e exige calibração antes do uso.

Créditos

Projeto original criado por Daniel Rodrigues Yu.

Versões derivadas devem preservar o arquivo LICENSE e este aviso de autoria.