这是一个模拟真实电商企业经营日报场景的 RPA 自动化项目，面向订单数据整理、经营指标统计、风险识别、报告生成和日报通知等重复性业务工作。
系统以影刀 主流程.flow 作为业务入口：影刀负责流程编排、子流程调用和自动任务执行，Python 负责数据分析与业务逻辑，并结合 AI 生成经营分析结果，形成从订单数据到经营日报通知的自动化闭环。
项目当前使用 CSV 模拟订单数据，提供清洗结果、Markdown 日报、AI 分析文本、Excel 报告、运行日志和飞书通知效果，适合用于 RPA + Python 自动化方案展示与面试讲解。
影刀
.flow文件由影刀平台管理，不包含在本仓库中；流程结构见docs/RPA流程设计.md。
- RPA 与 Python 职责分离
- 影刀负责主流程编排、子流程调用、自动任务执行和消息通知环节调度。
- Python 负责 CSV 数据处理与清洗、指标统计、风险检测、AI 经营分析和报告生成。
- 配置化业务规则：
config/business_rules.json管理销售状态、退款状态、排除状态和风险阈值，使统计口径与风险规则可以独立维护。 - AI Provider 可替换设计：支持 Mock Provider 与 Gemini Provider，通过
config/ai_config.json切换，兼顾离线演示与真实 AI 分析。 - 自动化业务闭环：订单数据依次经过清洗、统计、风险检测和 AI 分析，最终生成报告并发送飞书通知。
订单数据
↓
数据清洗
↓
订单统计
↓
风险检测
↓
AI 经营分析
↓
Markdown / Excel 报告
↓
飞书通知
影刀 RPA（业务流程入口）
├─ 主流程编排
├─ 子流程调用
└─ 任务执行与通知调度
↓
Python 业务处理
├─ CSV 校验与清洗
├─ 指标统计与风险检测
├─ AI Provider 调用
└─ Markdown / Excel 报告生成
↓
飞书机器人 Webhook 文本通知
核心设计原则是让影刀负责“流程如何运行”，让 Python 负责“业务数据如何处理”，从而保持流程编排与业务逻辑的清晰边界。
推荐业务入口：影刀 主流程.flow
01_Download_Order
↓
02_Process_Order
↓
03_Generate_Report
↓
06_Risk_Check
↓
07_AI_Analysis
↓
05_Excel_Report
↓
04_Send_Report
其中 06_Risk_Check 和 07_AI_Analysis 属于经营分析阶段，分别完成配置化风险识别与 AI 经营分析。仓库中的 Python 模块由影刀子流程调用，详细职责和输入输出见 docs/RPA流程设计.md。
| 影刀自动化流程 | 项目运行日志 |
|---|---|
 |
 |
| 飞书日报推送 | Excel 经营报告 |
 |
 |
| 项目目录结构 | |
 |
EcommerceAutomation/
├─ config/ # 业务规则、AI 配置和 Prompt 模板
├─ data/ # 原始、清洗后和来源示例数据
├─ docs/ # 系统设计、RPA 流程和项目说明
│ └─ images/ # README 展示截图
├─ reports/ # Markdown、AI 文本和 Excel 报告
├─ scripts/ # Python 模块开发验证入口
├─ src/ecommerce_automation/ # Python 业务实现
├─ logs/ # 按日期生成的运行日志
├─ tests/ # 测试目录
├─ requirements.txt # Python 依赖声明
└─ README.md # GitHub 项目展示主页
| 模块 | 代码位置 | 主要职责 |
|---|---|---|
| 数据处理 | order_reader.py |
校验订单字段，清理文本并规范化数值与时间格式 |
| 订单统计 | statistics.py |
统计订单量、有效销售额和不同状态订单数量 |
| 业务规则 | business_rules.py |
加载并校验订单状态口径和风险阈值 |
| 风险检测 | risk_checker.py |
检测销售额、退款率和取消率风险并评分分级 |
| AI 分析 | ai_analyzer.py、ai_provider/ |
构建经营分析并调用 Mock 或 Gemini Provider |
| 报告生成 | report_generator.py、excel_report.py |
生成 Markdown、AI 文本和 Excel 经营报告 |
| 飞书通知 | feishu_sender.py |
通过机器人 Webhook 发送经营日报文本消息 |
详细设计与模块边界见 docs/项目说明.md 和 docs/01_system_design.md。
在影刀中运行 主流程.flow，由主流程按照 RPA 自动化流程依次调用各子流程。飞书步骤会产生真实外部通知，运行前应确认 Webhook 和接收群配置。
python -m venv .venv
.venv\Scripts\Activate.ps1
python -m pip install -r requirements.txt
python -m pip install openpyxlscripts/ 仅用于开发阶段验证 Python 模块，不替代影刀业务入口：
python scripts/run_order_reader.py
python scripts/run_statistics.py
python scripts/run_report_generator.pyExcel 与飞书模块可通过公开函数单独验证，具体命令见 docs/项目说明.md。
| 技术 | 项目用途 |
|---|---|
| 影刀 RPA | 主流程编排、子流程调用、任务执行和通知调度 |
| Python 3.10 | CSV 处理、业务规则、统计分析和模块实现 |
| pandas | 数据分析扩展选项；当前 CSV 流程使用 Python 标准库 csv |
| openpyxl | 生成带样式的 Excel 经营分析报告 |
| requests | 调用 Gemini REST API 和飞书机器人 Webhook |
| Markdown | 输出可阅读、可归档的经营日报 |
| 飞书 Webhook | 推送经营日报文本消息 |
| AI Provider 设计 | 通过配置切换 Mock Provider 与 Gemini Provider |
- 数据来源：使用本地 CSV 模拟订单数据，展示完整处理流程；数据入口可在后续替换为获得授权的真实电商 API。
- 经营分析：覆盖订单统计、销售额/退款率/取消率风险检测、风险评分和 AI 文本分析。
- AI 模式：支持 Mock 与 Gemini 两种 Provider，可根据演示或联网环境切换。
- 报告输出：生成 Markdown 日报、AI 分析文本和 Excel 经营报告。
- 消息通知：通过飞书机器人发送文本日报；Excel 文件上传不在当前版本范围内。
- RPA 资产：影刀流程在影刀平台中维护，仓库保存流程设计文档和 Python 业务模块。
- 在获得平台授权后接入真实电商 API，补充或替换 CSV 数据入口；
- 引入数据库，沉淀订单、指标、风险事件和历史报告；
- 增加 Web 管理后台，统一展示任务状态、规则配置和报告历史；
- 扩展多店铺、商品、SKU 和跨周期趋势分析；
- 完善自动化测试、依赖声明和统一异常告警机制；
- 增加飞书文件上传能力，使 Excel 报告可作为附件发送。