niuniu/gaokao-volunteer-system

Fork 0

Files

Hermes Agent a16fa07ba5

CI / pytest (Python 3.10) (push) Has been cancelled

Details

CI / pytest (Python 3.11) (push) Has been cancelled

Details

CI / pytest (Python 3.12) (push) Has been cancelled

Details

docs: sync historical snapshots and crowd db quality

2026-06-14 17:46:34 +08:00

16 KiB

Raw Blame History

实施缺陷修复任务板（历史快照）

该文档是 2026-06-11 的历史快照，不再代表当前执行优先级。当前整改板请优先阅读：docs/CURRENT_STATE.md → docs/ACTIVE_EXECUTION_BOARD_2026-06-13.md → docs/ACTIVE_REMEDIATION_2026-06-13.md。

v2.1 实施计划与产品规划对齐修复

生成日期: 2026-06-11 关联审核报告: AUDIT_REPORT_2026-06-11.md 当前门禁结论: 🟡 条件启动 - 需先修复P0/P1缺陷

0. 当前门禁（Gate）状态

维度	状态	说明
文档完整性	🟢 PASS	11份文档5874行
PRD覆盖率	🟡 CONDITIONAL	5/8完全对齐，3项需补
实施计划可执行性	🟡 CONDITIONAL	14项待修复
行业实践	🔴 FAIL	5/10达标
测试覆盖	🔴 FAIL	6个用例远低于80%

当前Gate: 🟡 B+级（可启动实施，但需先完成P0修复任务）

1. 任务分类与最短闭环路径

1.1 任务分类总览

┌────────────────────────────────────────────────────┐
│  P0 严重（4项）─ 1-2天                            │
│  ├── 修订PRD优先级（F020 P1→P0）                    │
│  ├── 创建data/crowd_db目录                         │
│  ├── 补充T6管理后台MVP                             │
│  └── 补充T7分享功能MVP                             │
├────────────────────────────────────────────────────┤
│  P1 重要（4项）─ 1周                              │
│  ├── 强制TDD覆盖率门槛                             │
│  ├── 补充T8渠道SDK集成                             │
│  ├── 补充T9错误处理体系                             │
│  └── 补充T10 CI/CD基础                             │
├────────────────────────────────────────────────────┤
│  P2 一般（3项）─ 2周                              │
│  ├── T4.1增加加密字段                               │
│  ├── T5.2增加并发测试                               │
│  └── T1.9细化Skills集成                            │
├────────────────────────────────────────────────────┤
│  S 建议（3项）─ 持续优化                            │
│  ├── T1.4明确27省规则库复用                        │
│  ├── T1.3增加多场景fixtures                         │
│  └── 全局: 实施时持续收集反馈                       │
└────────────────────────────────────────────────────┘

1.2 最短闭环路径

Day 1 (今天):
  P0-1: 修订PRD优先级 ─────┐
  P0-2: 创建目录 ──────────┼─→ 合并1次commit
  P0-3: 补充T6设计要点 ────┤
  P0-4: 补充T7设计要点 ────┘

Day 2-3:
  P1-5: 修订T1-T5任务增加覆盖率门槛
  P1-6: 起草T8渠道SDK设计
  P1-7: 起草T9错误处理设计
  P1-8: 起草T10 CI/CD设计

Day 4-7:
  P2-9: 修订T4.1 schema（加密）
  P2-10: 修订T5.2（并发）
  P2-11: 修订T1.9（集成细化）

Day 7 (一周后):
  合并为 v2.1 IMPLEMENTATION_PLAN_v2.md
  推送三个仓库
  启动实施

2. 详细任务清单

P0 严重（必须完成才能启动v2.1）

任务 P0-1: 修订PRD优先级（F020 AI审核 P1→P0）

字段	内容
目标	F020 AI方案审核从P1提升至P0
理由	49元AI审核是核心差异化产品，承接大厂AI用户
文件	`product/PRD.md`
位置	功能表（8.5节 P2增强功能块）
完成标准	表格中F020行优先级列从P1改为P0
影响范围	同步ROADMAP T1的优先级标记
验证	grep "F020" product/PRD.md 显示 P0
工时	0.5小时
状态	⏳ 待执行
依赖	无
执行人	PM

任务 P0-2: 创建 data/crowd_db 目录结构

字段	内容
目标	创建大厂AI推荐数据库的目录
理由	T1.5 引用 data/crowd_db/loader.py 但目录不存在
文件	`data/crowd_db/.gitkeep` + `data/crowd_db/README.md`
完成标准	目录存在+README说明数据格式
验证	`ls data/crowd_db/` 看到文件
工时	0.5小时
状态	⏳ 待执行
依赖	无
执行人	Tech Lead

任务 P0-3: 补充T6 管理后台MVP设计

字段	内容
目标	补充管理后台的MVP实施任务
理由	ADMIN_DESIGN.md 432行设计无对应实施
文件	`docs/IMPLEMENTATION_PLAN.md`
位置	T5之后增加T6
范围	T6.1 FastAPI + 简易WebUI（仪表盘+订单管理+用户管理）
工时估算	5-7天（MVP）
完成标准	T6.1-T6.5任务分解+DoD
决策	推荐"CLI + 极简Web"而非完整后台
状态	⏳ 待执行
依赖	T4订单管理（基础）
执行人	Tech Lead + Engineer

任务 P0-4: 补充T7 分享功能MVP设计

字段	内容
目标	补充报告分享功能的实施任务
理由	SHARING_DESIGN.md 274行设计无对应实施
文件	`docs/IMPLEMENTATION_PLAN.md`
位置	T6之后增加T7
范围	T7.1 短链接生成 + T7.2 海报生成 + T7.3 权限控制
工时估算	3-5天（MVP）
完成标准	T7.1-T7.3任务分解+DoD
状态	⏳ 待执行
依赖	T1.7 报告生成器（基础）
执行人	Engineer

P1 重要（1周内完成）

任务 P1-5: 强制TDD覆盖率门槛

字段	内容
目标	在实施计划中明确测试覆盖要求
理由	当前6个用例远低于80%标准
文件	`docs/IMPLEMENTATION_PLAN.md`
位置	T5.x 验证标准中
要求	核心代码≥80%, 整体≥60%
机制	CI中运行pytest --cov，未达标拒绝合并
工时	1小时（设计门槛）
状态	⏳ 待执行
依赖	T10 CI/CD

任务 P1-6: 起草T8 渠道SDK集成

字段	内容
目标	设计闲鱼/微信渠道SDK集成方案
理由	场景A的自动化实现
范围	闲鱼SDK、微信SDK、企业微信SDK、钉钉SDK
方案	优先Webhook轮询+手动兜底
工时	1天（设计）
文件	`docs/CHANNEL_INTEGRATION.md`
状态	⏳ 待执行
依赖	无（设计阶段）

任务 P1-7: 起草T9 错误处理体系

字段	内容
目标	设计统一错误处理体系
理由	当前无统一错误处理
范围	错误码定义、用户友好提示、日志记录、异常捕获
工时	1天（设计+实施）
文件	`docs/ERROR_HANDLING.md` + 代码
状态	⏳ 待执行

任务 P1-8: 起草T10 CI/CD基础

字段	内容
目标	建立GitHub Actions基础流水线
理由	自动化测试+部署
范围	自动化测试+覆盖率报告+多仓库同步
工时	1天（实施）
文件	`.github/workflows/ci.yml`
状态	⏳ 待执行

P2 一般（v2.1实施中处理）

任务 P2-9: 修订T4.1 schema（加密字段）

字段	内容
目标	客户数据加密存储
理由	TECH 6.1 设计要求
范围	手机号/身份证号等敏感字段
方法	AES-256对称加密
工时	0.5天
文件	`docs/plans/T4-1-order-schema.md`

任务 P2-10: 修订T5.2（并发测试）

字段	内容
目标	验证TECH"并发10用户"指标
理由	性能目标无验证任务
范围	locust/pytest-benchmark
工时	0.5天

任务 P2-11: 修订T1.9（Skills集成细化）

字段	内容
目标	明确4个现有skills与新审核服务的集成
理由	T1.9仅简单提及
范围	gaokao-counselor-long调用gaokao-audit的接口
工时	0.5天

S 建议（持续优化）

ID	建议	状态
S-12	T1.4明确27省规则库复用	⏳ 持续
S-13	T1.3增加多场景fixtures（至少3个省份）	⏳ 持续
S-14	实施时收集真实用户反馈	⏳ 持续

3. 时间表（修订版）

修订前 vs 修订后

周次	修订前	修订后	变化
Day 1-2	T1.1-T1.3	T1.1-T1.3 + P0-1~4	+0.5天文档修订
Day 3-5	T1.4-T1.7	T1.4-T1.7	一致
Day 6-7	T1.8-T1.10	T1.8-T1.10 + P1-5门槛	+0.5天
Week 2	T2.x	T2.x + P1-6起草	+1天
Week 3	T3-T4	T3-T4 + P1-7/8	+2天
Week 4	T5	T5 + P2-9/10/11	+1.5天
Week 5	-	T6-T10补充任务	新增

总工期: 30天 → 40天 (+33%)

调整理由:

行业实践差距需要弥补
测试覆盖要求需要时间
4项P0需要补齐才能启动

4. 依赖关系

P0-1 (PRD修订)  ──┐
                    ├─→ Day 1 commit
P0-2 (创建目录)  ──┤
                    │
P0-3 (T6设计)    ──┤
                    │
P0-4 (T7设计)    ──┘

P1-5 (覆盖率)  ──→ P1-8 (CI/CD) ──→ T5.2 (验证)
P1-6 (渠道SDK) ──→ T8 实施（v2.1后）
P1-7 (错误处理)──→ T9 实施

P2-9 (加密)    ──→ T4.1 schema ──→ T4.2 DAO
P2-10 (并发)   ──→ T5.2 性能测试
P2-11 (Skills) ──→ T1.9 集成

T1.x → T2.x → T3.x → T4.x → T5.x → T6.x → T7.x（v2.2）

5. 验证方法

5.1 每天验证

文档变更已提交
已推送到3个仓库
当日任务DoD已勾选

5.2 每周验证

本周任务全部完成
测试通过率100%
文档同步更新

5.3 阶段验证

P0任务完成 → 可启动v2.1
P1任务完成 → 可达到行业基础标准
P2任务完成 → 可发布v2.1

6. 风险与缓解

风险	可能性	影响	缓解
工期延长导致窗口错过	中	高	优先P0，可砍T6/T7
测试覆盖率不达标	中	中	TDD强制+CI门槛
管理后台范围蔓延	中	中	MVP原则
渠道SDK不稳定	高	中	手动兜底方案

7. 角色与责任

角色	职责
PM	PRD修订、任务优先级决策
Tech Lead	T6-T10技术方案设计
Engineer	T1-T5实施（含覆盖率门槛）
QA	测试覆盖审计、CI质量门禁
DevOps	CI/CD流水线建设

8. 决策记录

决策D-01: AI审核是否提升至P0？

决策: ✅ 是理由: 49元AI审核是承接大厂AI用户的核心入口影响: PRD修订, ROADMAP优先级调整

决策D-02: 管理后台/分享功能是否纳入v2.1？

决策: ✅ 纳入MVP（精简版）理由: 完全缺失会阻碍业务发展影响: 总工期+10天

决策D-03: Web端是否纳入v2.1？

决策: ❌ 推迟到v2.3 理由: 30天窗口不够，技术栈待定影响: 场景B延后

决策D-04: 测试覆盖是否设硬指标？

决策: ✅ 设硬指标 - 核心≥80%, 整体≥60% 理由: 行业基础标准影响: TDD+CI门槛

决策D-05: CI/CD是否现在建设？

决策: ✅ 简化版 - GitHub Actions 理由: 自动化是基础影响: T10-CI/CD新增

9. 关联文档

文档	链接	关系
审核报告	AUDIT_REPORT_2026-06-11.md	上游
实施计划	IMPLEMENTATION_PLAN.md	待修订
PRD	../product/PRD.md	待修订
技术架构	TECH_ARCHITECTURE.md	参考

任务板版本: v1.0 生成日期: 2026-06-11 下次更新: P0完成后

16 KiB Raw Blame History Unescape Escape

实施缺陷修复任务板（历史快照）

v2.1 实施计划与产品规划对齐修复

0. 当前门禁（Gate）状态

1. 任务分类与最短闭环路径

1.1 任务分类总览

1.2 最短闭环路径

2. 详细任务清单

P0 严重（必须完成才能启动v2.1）

任务 P0-1: 修订PRD优先级（F020 AI审核 P1→P0）

任务 P0-2: 创建 data/crowd_db 目录结构

任务 P0-3: 补充T6 管理后台MVP设计

任务 P0-4: 补充T7 分享功能MVP设计

P1 重要（1周内完成）

任务 P1-5: 强制TDD覆盖率门槛

任务 P1-6: 起草T8 渠道SDK集成

任务 P1-7: 起草T9 错误处理体系

任务 P1-8: 起草T10 CI/CD基础

P2 一般（v2.1实施中处理）

任务 P2-9: 修订T4.1 schema（加密字段）

任务 P2-10: 修订T5.2（并发测试）

任务 P2-11: 修订T1.9（Skills集成细化）

S 建议（持续优化）

3. 时间表（修订版）

修订前 vs 修订后

4. 依赖关系

5. 验证方法

5.1 每天验证

5.2 每周验证

5.3 阶段验证

6. 风险与缓解

7. 角色与责任

8. 决策记录

决策D-01: AI审核是否提升至P0？

决策D-02: 管理后台/分享功能是否纳入v2.1？

决策D-03: Web端是否纳入v2.1？

决策D-04: 测试覆盖是否设硬指标？

决策D-05: CI/CD是否现在建设？

9. 关联文档

16 KiB

Raw Blame History