Compare commits

...

2 Commits

Author SHA1 Message Date
vincent efbbf6265c docs: 架构文档 v2.0 — 根据评审意见迭代更新
v1.0 评审通过后,根据四位评审人意见迭代:

沈路明(PM) 评审意见:
- P2: 前端搜索增加按期号精确查找
- P2: 生成记录增加策略类型筛选
- P3: 统计页增加历史趋势可视化
- P3: 覆盖写入先写.tmp再rename

陆怀瑾(COO) 评审意见:
- 新增 R-09/R-10/R-11 风险项
- R-09 运维单点依赖 → 安排徐聪为备用运维
- R-10 数据抓取静默失败 → 接入飞书通知
- R-11 Excel格式漂移 → 增加跳过量监控

徐聪(Dev) 评审意见:
- realpath+commonpath双重校验(已完成)
- 修正app.py行数490→728
- 确认fetch_data已有MAX_RETRIES=3
- 确认web_executor已有timeout=300s
- P2: api_history列名抽取为配置常量
- P2: .generation_records.json加fcntl.flock
- P3: lottery/目录自动清理
- P3: api_token迁移至环境变量
- 新增 R-12/R-13 风险项

严维序(OPS) 评审意见:
- 更新服务名为lotto-app.service(已部署)
- 旧lotto-web.service建议清理
- 统一虚拟环境venv/(删除.venv/)
- P1: 配置logrotate日志轮转
- P1: 服务健康监控接入心跳巡检
- 更新ExecStartPre补充numpy检查
- 确认backup.sh已部署

新增内容:
- §12.1 评审意见响应矩阵(25项)
- ADR-LOTTO-005 文件并发写入安全
- ADR-LOTTO-006 API Token安全管理
- BC-11a 符号链接绕过边界条件
- 部署拓扑图同步实际状态

Co-authored-by: multica-agent <github@multica.ai>
2026-07-03 20:47:37 +08:00
vincent a6f473f836 feat: 双色球自动化系统架构设计文档 v1.0 (BIZ-74)
- 系统架构图(拓扑/数据流/模块依赖)
- 技术选型对比(后端/前端/存储/部署)
- 模块详细设计(单文件/单函数级)
- 接口定义(8个API完整规范)
- 数据模型 + ER关系
- 非功能需求(性能/可用性/安全/兼容性)
- 边界条件20项 + 异常场景10项
- 编码规范与技术栈约束
- 部署架构 + 定时任务设计
- 风险评估 + 开发排期
- ADR决策记录4条

Co-authored-by: multica-agent <github@multica.ai>
2026-07-03 16:36:15 +08:00
File diff suppressed because it is too large Load Diff