Commit Graph

5 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
vincent 929f13b11f docs(BIZ-76): Metapi NVIDIA网关切换配置指南归档
Co-authored-by: multica-agent <github@multica.ai>
2026-07-03 15:03:10 +08:00
vincent 01640e0617 docs: BIZ-19 Agent 知识库集成指南 + 知识查询最佳实践
Co-authored-by: multica-agent <github@multica.ai>
2026-06-24 12:21:26 +08:00
vincent dc00661a34 BIZ-17: QMD和Wiki工具链测试报告与检索指南
- docs/qmd-verification-report.md: QMD功能验证(技能可用,CLI需修复Node.js原生模块兼容性)
- docs/wiki-toolchain-test-report.md: Wiki 5工具完整测试(4通过/1需注意前置条件)
- docs/agent-kb-retrieval-guide.md: Agent知识库检索决策指南(含工具选择/查询构造/缺口上报)
- scripts/wiki-lint-check.sh: Wiki质量自动化检查脚本

Co-authored-by: multica-agent <github@multica.ai>
2026-06-22 20:20:59 +08:00