Initial commit: Report automation script using Playwright

2026-04-18 14:42:46 +08:00
commit 556fec602a
9 changed files with 411 additions and 0 deletions
@@ -0,0 +1,35 @@
+# ALIGNMENT - 报表自动化任务
+
+## 1. 原始需求
+自动化完成从 `secsion.com` 导出报表并上传至 `94kan.cn` 的全流程。
+
+## 2. 任务特性规范
+- **技术栈**: Python + Playwright (由于涉及复杂的浏览器交互、HTTPS证书处理、文件下载和上传，Playwright 是最佳选择)。
+- **运行环境**: Windows 操作系统。
+- **目标网站 1**: `https://secsion.com:8000/` (B端电商店铺类后台管理)。
+- **目标网站 2**: `https://sale.94kan.cn/` (销售数据分析器)。
+
+## 3. 需求理解与边界确认
+### 3.1 任务流程
+1. **登录阶段**: 访问登录页 -> 选择角色"店铺" -> 输入账号密码 -> 登录。
+2. **报表导出阶段**: 访问统计页 -> 设置日期 (2026-04-18) -> 导出报表。
+3. **报表上传阶段**: 访问上传页 -> 上传下载的文件 -> 等待结果。
+
+### 3.2 边界与限制
+- **HTTPS 证书**: 必须忽略证书错误或自动点击继续。
+- **文件下载**: 需捕获动态下载的文件并保存到指定路径。
+- **文件上传**: 需定位隐藏的 input 元素或直接操作上传。
+- **登录状态**: 初始实现为单次任务流，后续可考虑持久化 Context。
+
+## 4. 疑问澄清与智能决策
+- **Q**: 网站访问可能由于网络限制失败？
+- **A**: 使用浏览器自动化直接访问，不通过后端 API 库，通常能绕过简单的跨域或内网限制。
+- **Q**: 证书警告处理？
+- **A**: Playwright 的 `browser_context(ignore_https_errors=True)` 可全局解决。
+- **Q**: 文件名动态变化？
+- **A**: 使用 Playwright 的 `expect_download()` 监听器获取真实文件名。
+
+## 5. 验收标准
+- [ ] 成功下载以 `.xlsx` 结尾的报表文件。
+- [ ] 成功在 `94kan.cn` 触发上传动作。
+- [ ] 控制台输出清晰的操作日志。
@@ -0,0 +1,24 @@
+# CONSENSUS - 报表自动化任务共识
+
+## 1. 明确的需求描述
+开发一个 Python 脚本，实现以下自动化操作：
+1. 登录 `secsion.com:8000`。
+2. 导出 2026-04-18 的商品统计报表。
+3. 将导出的报表上传至 `sale.94kan.cn`。
+
+## 2. 技术实现方案
+- **框架**: Playwright for Python。
+- **模式**: Headed 模式（方便调试）或 Headless 模式（正式运行）。
+- **证书处理**: 配置 `ignore_https_errors=True`。
+- **下载逻辑**: 监听 `download` 事件。
+- **上传逻辑**: 定位上传按钮对应的 `input[type="file"]`。
+
+## 3. 技术约束与集成方案
+- 账号：`15682076681` / 密码：`123456`。
+- 角色选择：必须点击包含“店铺”文本的选项。
+- 日期选择：填充两个日期选择器为 `2026-04-18`。
+
+## 4. 验收标准
+- 脚本运行无报错。
+- 最终在 `94kan.cn` 看到“处理中”或“上传成功”的提示。
+- 本地保存一份下载的 Excel 文件副本。
@@ -0,0 +1,42 @@
+# DESIGN - 报表自动化架构设计
+
+## 1. 整体架构
+```mermaid
+graph TD
+    A[Main Script] --> B[Browser Manager]
+    A --> C[Secsion Service]
+    A --> D[Upload Service]
+    B --> E[Playwright Context]
+    C --> E
+    D --> E
+```
+
+## 2. 核心组件说明
+- **Browser Manager**: 初始化 Playwright，配置 `ignore_https_errors`，管理浏览器生命周期。
+- **Secsion Service**:
+    - `login()`: 处理角色选择、账号密码输入、登录按钮点击。
+    - `export_report(date)`: 处理日期填写、点击导出、捕获下载流。
+- **Upload Service**:
+    - `upload_file(file_path)`: 处理 94kan.cn 的文件上传。
+
+## 3. 数据流向
+1. 启动浏览器 -> 建立 Context。
+2. `Secsion Service` 登录 -> 获取报表下载对象。
+3. 保存文件至 `temp_downloads/` 目录。
+4. `Upload Service` 读取该文件并上传。
+5. 关闭浏览器。
+
+## 4. 异常处理策略
+- **超时处理**: 设置全局等待超时（30s）。
+- **重试机制**: 对关键点击动作进行简单重试。
+- **日志记录**: 使用 Python `logging` 模块记录每一步状态。
+
+## 5. 接口契约 (伪代码)
+```python
+class SecsionService:
+    def login(page, username, password): ...
+    def export_report(page, date_str) -> str: ... # returns file path
+
+class UploadService:
+    def upload(page, file_path): ...
+```
@@ -0,0 +1,25 @@
+# FINAL - 报表自动化项目总结
+
+## 1. 项目执行概览
+- **任务目标**: 实现从 `secsion.com` 导出报表并上传至 `94kan.cn`。
+- **核心逻辑**: 使用 Playwright 进行浏览器自动化，处理了 HTTPS 证书忽略、文件异步下载和表单上传。
+- **交付代码**: `main.py`。
+
+## 2. 功能实现情况
+- [x] **登录逻辑**: 实现了角色选择、账号密码填写。
+- [x] **报表导出**: 实现了日期选择器填充和 `download` 事件监听。
+- [x] **文件上传**: 实现了针对 `94kan.cn` 的文件设置逻辑。
+- [x] **错误处理**: 集成了日志记录和错误截图功能。
+
+## 3. 技术挑战应对
+- **HTTPS 证书**: 通过 `ignore_https_errors=True` 绕过。
+- **动态下载**: 使用 `expect_download()` 确保文件被正确捕获并保存。
+- **文件对话框**: 使用 `set_input_files` 绕过系统原生对话框。
+
+## 4. 运行结果
+- 环境依赖已安装。
+- **全流程成功跑通**:
+    - 成功登录 `secsion.com`（处理了 URL 大小写敏感问题）。
+    - 成功导出报表并保存到本地 `downloads/`。
+    - 成功将报表上传至 `94kan.cn` 并触发了分析。
+- 验证截图已保存：`upload_result.png`。
@@ -0,0 +1,53 @@
+# TASK - 报表自动化原子任务拆分
+
+## 任务依赖图
+```mermaid
+graph LR
+    T1[环境准备] --> T2[Secsion登录逻辑]
+    T2 --> T3[报表导出逻辑]
+    T3 --> T4[94kan上传逻辑]
+    T4 --> T5[主程序集成与测试]
+```
+
+## 原子任务定义
+
+### T1: 环境准备
+- **输入**: 无
+- **动作**: 安装 `playwright`, `pytest-playwright`，初始化项目目录。
+- **输出**: `requirements.txt`, 已安装的依赖。
+- **验收**: 运行 `playwright install` 成功。
+
+### T2: Secsion 登录模块
+- **输入**: 账号、密码、浏览器 Page。
+- **动作**: 
+    1. 访问登录 URL。
+    2. 处理证书警告（如有）。
+    3. 点击“店铺”角色。
+    4. 输入凭据并提交。
+- **输出**: 成功跳转至首页。
+- **验收**: 页面 URL 包含 `homepage`。
+
+### T3: 报表导出模块
+- **输入**: 浏览器 Page, 日期字符串。
+- **动作**:
+    1. 访问统计 URL。
+    2. 填充日期选择器。
+    3. 监听 `download` 事件。
+    4. 点击“导出报表”。
+- **输出**: 导出的文件路径。
+- **验收**: 文件存在于本地且大小大于 0。
+
+### T4: 94kan 上传模块
+- **输入**: 浏览器 Page, 文件路径。
+- **动作**:
+    1. 访问 94kan URL。
+    2. 定位上传组件。
+    3. 使用 `set_input_files` 设置文件。
+- **输出**: 上传成功状态。
+- **验收**: 页面显示“处理中”或上传进度。
+
+### T5: 主程序集成
+- **输入**: 以上所有模块。
+- **动作**: 串联流程，加入日志。
+- **输出**: `main.py`。
+- **验收**: 全流程自动运行成功。
@@ -0,0 +1,11 @@
+# TODO - 报表自动化后续事宜
+
+## 1. 待办事项
+- [ ] **定期维护**: 定期检查网站选择器是否发生变化。
+- [ ] **清理下载**: 脚本目前将文件保存在 `downloads/`，可考虑定期清理。
+- [ ] **通知集成**: 如果需要，可以集成邮件或钉钉通知，告知上传结果。
+
+## 2. 操作指引
+- **运行脚本**: `python main.py`
+- **查看日志**: `automation.log`
+- **查看最后一次上传截图**: `upload_result.png`