Files
push_fenxiangfengshi/CLAUDE.md
T
houhuan 4ee30399bf 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 项单元测试(不联网)
2026-11-16 12:45:23 +08:00

43 lines
2.4 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 丰享订单监控 —— 项目上下文(给 AI 协作用)
## 一句话
监控丰享商家端(fs.szfx.com)新订单 → 推企业微信。本机负责登录(过腾讯验证码),
服务器 Docker 负责 7×24 轮询与推送。
## 运行形态
- 本机 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` 时启用
## 关键业务规则
1. 首次启动只建基线,**不推历史订单**
2. 积压 > `bulk_summary_threshold`(默认 5)时发一条汇总,不逐条推
3. 夜间 21:00–07:40 分片休眠(每 60s 醒一次),期间仍响应 Cookie 更新与停止信号
4. Cookie 文件变化自动热重载,无需重启容器
5. 会话失效 → 告警(30min 冷却)→ 阻塞等待新 Cookie → 自动恢复并回推恢复通知
## 常用命令
```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
```
## 已知坑
- 丰享接口是逆向的,`errno` 含义可能变;会话失效码目前 `{110003, 10009}`
- 未配置 `admin.token` 时写接口只允许 127.0.0.1(避免裸奔)
- 单实例:状态文件无锁,同店铺不要起两个容器
- `amountPayable` 单位是**分**,展示要 /100
- 原仓库历史里有明文 webhook,已迁到配置;改动提交时不要再写回源码