为什么值得关注

它展示了从浏览器自动化（Playwright）、数据处理（pandas）到 Excel 更新（xlwings）的完整自动化流程，并打包为可移植的 Windows 可执行文件，配有 Tkinter 图形界面。

适合谁使用

定期提取和合并报告的运营分析师
希望自动执行重复数据录入的 Excel 用户
寻找浏览器自动化工具模板的开发者
需要免安装、自包含解决方案的 IT 人员

典型使用场景

自动从 Web 门户每日或每周获取系统报告
验证报告周期并应用业务规则后更新共享 Excel 文件
为非技术用户创建可执行工具，无需手动操作即可执行报告更新
维护已下载报告的历史记录和执行日志，便于审计

项目优势

使用 Playwright 实现可靠的浏览器自动化，xlwings 安全更新 Excel
包含时间周期验证、周末模型选择和带堆栈跟踪的执行日志
通过 PyInstaller 打包成单一可移植可执行文件，无需运行时依赖
匿名化的配置模板避免意外泄露凭据

使用前须知

需要针对每个目标系统手动校准选择器和 URL
仅支持 Windows，未提及跨平台支持
依赖于预先设置的本地 Excel 模板和文件夹结构
仓库本身不提供真实系统，仅为演示项目，使用假数据

README 快速开始

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

Copie config_sistema.example.ini para config_sistema.ini.
Preencha URLs, seletores e opções do sistema utilizado.
Crie 01 - ENTRADA e adicione localmente os modelos Excel necessários.
Instale as dependências com py -m pip install -r requirements_app.txt.
Instale o navegador com py -m playwright install chromium.
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.

项目描述

Automação de extração, tratamento e consolidação de relatórios operacionais em Excel, utilizando Python, Playwright, pandas, xlwings e Tkinter.

Extracao-e-Tratamento