refactor: 重构为可部署到服务器的模块化结构(v5.0.0)
- 拆包 fengxiang/:config/client/store/notify/monitor/admin/tts,统一入口 order_monitor.py - 服务器形态:Docker 常驻,Cookie 由本机登录后 POST 上传并热加载,不再依赖桌面弹窗 - 修复:首次启动重推历史订单、speak() 阻塞主循环、夜间 sleep 10h 不可中断 - 修复:test_push.py 残留 miservice 依赖(小爱已移除)、run_monitor.bat 写死盘符 - 配置化:webhook/shopId 移出源码(环境变量 > config.yaml > 默认值) - 可观测:滚动文件日志 + /healthz + Docker HEALTHCHECK + 告警冷却 - 飞书通道保留配置位,默认关闭(原 token 已失效 code=19001) - 新增 22 项单元测试(不联网)
This commit is contained in:
1 parent
ab6a2bb7ea
commit
4ee30399bf
30 files changed
+2410
-825
No files matched your search
@@ -1,78 +1,42 @@
|
||||
# 丰享订单监控项目
|
||||
# 丰享订单监控 —— 项目上下文(给 AI 协作用)
|
||||
|
||||
## 项目概述
|
||||
## 一句话
|
||||
监控丰享商家端(fs.szfx.com)新订单 → 推企业微信。本机负责登录(过腾讯验证码),
|
||||
服务器 Docker 负责 7×24 轮询与推送。
|
||||
|
||||
自动监控丰享商家端(fs.szfx.com)的新订单,同时推送到企业微信、飞书群和本地TTS语音播报**。
|
||||
## 运行形态
|
||||
- 本机 Windows:`run.bat` 跑 `order_monitor.py`;`login.bat` 跑 `fengxiang_scraper.py` 登录并上传 Cookie
|
||||
- 服务器:`/data/docker/fengxiang-monitor`,容器 `fengxiang-monitor`,宿主机 `52100` → 容器 `8089`
|
||||
- 生产只启用企业微信通道;飞书配置位保留但默认关闭(原 token 已失效,`code=19001`)
|
||||
|
||||
## 文件说明
|
||||
## 代码约定
|
||||
- 包 `fengxiang/`,配置三级覆盖:**环境变量 > config.yaml > config.py 的 DEFAULTS**
|
||||
- 密钥(webhook、admin token)只能出现在 `config.yaml` / `.env`,绝不写进源码
|
||||
- 异常分三类:`SessionExpired`(要登录)/ `ApiError`(业务错误码)/ `NetworkError`(可重试)
|
||||
- 状态用 `store.State`:`last_order_id` + `pushed_ids` 双保险去重,写入必须原子(tmp + os.replace)
|
||||
- 推送失败不能抛到主循环;告警必须经过 `Dispatcher.alert` 的冷却
|
||||
- 主循环任何异常都要兜住(`except Exception` 记日志后继续),进程不能死
|
||||
- TTS 只在 `sys.platform == "win32"` 且 `tts.enabled` 时启用
|
||||
|
||||
| 文件 | 用途 |
|
||||
|------|------|
|
||||
| `order_monitor.py` | 主程序:监控订单 + 企业微信 + 飞书 + 本地TTS播报 |
|
||||
| `push_latest_order.py` | 单次获取最新订单并推送企业微信 |
|
||||
| `fetch_orders.py` | 复用 Cookie 获取订单数据(命令行) |
|
||||
| `fengxiang_scraper.py` | 首次登录获取 Cookie(Playwright 半自动) |
|
||||
| `cookies.json` | 丰享平台的登录 Cookie |
|
||||
| `order_data.json` | 订单数据样例 |
|
||||
## 关键业务规则
|
||||
1. 首次启动只建基线,**不推历史订单**
|
||||
2. 积压 > `bulk_summary_threshold`(默认 5)时发一条汇总,不逐条推
|
||||
3. 夜间 21:00–07:40 分片休眠(每 60s 醒一次),期间仍响应 Cookie 更新与停止信号
|
||||
4. Cookie 文件变化自动热重载,无需重启容器
|
||||
5. 会话失效 → 告警(30min 冷却)→ 阻塞等待新 Cookie → 自动恢复并回推恢复通知
|
||||
|
||||
## 已逆向的 API
|
||||
|
||||
### 丰享平台
|
||||
|
||||
- **登录**: `POST https://fspass.szfx.com/api/login`
|
||||
- 参数: `uname`(手机号), `upass`(密码Base64反转), `ticket`, `randstr`(腾讯验证码)
|
||||
- 登录后通过 `https://fs.szfx.com/saasmerchant/setstoken` 设置 Cookie
|
||||
- Cookie 保存在浏览器中,主要: `USS`, `PTOKEN`, `CPTOKEN`, `STOKEN`
|
||||
|
||||
- **订单列表**: `POST https://fs.szfx.com/saasmerchant/pcweb/order/quickpayorder/list`
|
||||
- Content-Type: application/json
|
||||
- Body: `{"shopId": "20434543575189", "page": 1, "pageSize": 20}`
|
||||
- 需要登录 Cookie,未登录返回 `errno: 110003`
|
||||
- 返回: `{errno: 0, data: {total, list: [...], count}}`
|
||||
|
||||
- **关键字段**:
|
||||
- `shopId`: `20434543575189` (益选便利店)
|
||||
- `orderId`: 订单号
|
||||
- `amountPayable`: 实付金额(单位:分)
|
||||
- `allPrice`: 订单金额(单位:分)
|
||||
- `shopName`, `city`, `companyName`, `workplaceName`: 业务信息
|
||||
- `createTime`, `payTime`, `finishTime`: 时间戳(秒)
|
||||
|
||||
### 本地 TTS(IndexTTS2)
|
||||
|
||||
- 使用本地部署的 IndexTTS2 模型,无需联网
|
||||
- 模型路径: `E:\2025Code\python\IndexTT\index-tts\`
|
||||
- 语音样本: `examples/voice_01.wav`
|
||||
- 封装模块: `local_tts.py`
|
||||
- 调用方式: `_local_speak(text)` → 合成 WAV → 本地播放
|
||||
|
||||
### 企业微信 Webhook
|
||||
- URL: `https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=644ab6d9-3b66-4166-88e9-5a8a89e3731d`
|
||||
- 只能发消息,不能收消息
|
||||
|
||||
## order_monitor.py 核心逻辑
|
||||
|
||||
1. Playwright 打开浏览器,用户手动登录丰享平台
|
||||
2. 登录成功后,通过浏览器页面的 `fetch()` 调用订单 API(复用浏览器会话,最自然)
|
||||
3. 每次拉取最近 N 条订单,和上次最新订单号对比,找出所有新订单
|
||||
4. 新订单同时推送企业微信 + 飞书 + 本地TTS播报
|
||||
5. 高峰期(11-13点、17-19点)10-20秒轮询,闲时 30-60 秒
|
||||
6. 每 5 分钟刷新页面防 Session 过期
|
||||
7. Session 过期自动检测 → 通知企业微信 → 等待用户重新登录
|
||||
|
||||
## 消息格式
|
||||
|
||||
- 企业微信: `【丰享丰食】订单收款成功,收款24.00元`
|
||||
- 本地TTS: 同上文案语音播报
|
||||
|
||||
## 已安装的依赖
|
||||
|
||||
```
|
||||
pip install playwright requests
|
||||
playwright install chromium
|
||||
## 常用命令
|
||||
```bash
|
||||
python -m unittest discover -s tests -v # 22 项测试,不联网
|
||||
python fetch_orders.py 1 5 # 调试取单
|
||||
python push_latest_order.py --dry # 调试推送
|
||||
docker compose up -d --build && docker compose logs -f
|
||||
curl -s localhost:52100/healthz
|
||||
```
|
||||
|
||||
## 注意事项
|
||||
|
||||
- 丰享登录有**腾讯验证码 TCaptcha**,无法纯接口绕过,必须用 Playwright 浏览器登录
|
||||
- Windows 终端输出中文会乱码,但实际发送的内容是正确的 UTF-8
|
||||
## 已知坑
|
||||
- 丰享接口是逆向的,`errno` 含义可能变;会话失效码目前 `{110003, 10009}`
|
||||
- 未配置 `admin.token` 时写接口只允许 127.0.0.1(避免裸奔)
|
||||
- 单实例:状态文件无锁,同店铺不要起两个容器
|
||||
- `amountPayable` 单位是**分**,展示要 /100
|
||||
- 原仓库历史里有明文 webhook,已迁到配置;改动提交时不要再写回源码
|
||||
Reference in new issue
Block a user