niuniu/gaokao-volunteer-system
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
1ce861166f5453593e4d764abdb24efd705cfeb3
gaokao-volunteer-system/docs/IMPLEMENTATION_PLAN_v2.md
Hermes Agent a146fe942c feat(audit): 完整审核+修订版实施计划 
【审核工作】
基于 plan-audit skill 对 11 份文档（5874行）做完整审核：
- 文档完整性: A级 ✅
- 业务对齐: A级 ✅
- 差异化策略: A级 ✅
- 技术选型: A级 ✅
- 任务分解: A级 ✅
- 行业实践: C级 🔴 (5/10)
- 实施可执行: B级 🟡 (62.5%)

【发现14项差距】
4项重大缺失:
  G-01: Web端完全未在实施计划
  G-02: 管理后台(432行设计)无对应实施
  G-03: 分享功能(274行设计)无对应实施
  G-04: AI审核PRD标P1但实际应P0

4项中等缺失:
  G-05: 测试覆盖仅6用例(需≥80%)
  G-06: 渠道SDK集成未设计
  G-07: 错误处理体系缺失
  G-08: CI/CD流程未设计

3项设计偏差:
  D-01: data/crowd_db目录不存在
  D-02: 性能目标无验证任务
  D-03: 数据加密未实施

3项建议优化

【关键产出】
1. docs/AUDIT_REPORT_2026-06-11.md (382行)
   - 完整审核报告
   - 行业最佳实践对照
   - 风险评估
   - 行动建议

2. docs/REMEDIATION_TASK_BOARD_2026-06-11.md (386行)
   - 14项修复任务清单
   - 最短闭环路径
   - 决策记录

3. docs/IMPLEMENTATION_PLAN_v2.md (412行)
   - 11个核心任务（原5个+新增6个）
   - 工期30天→40天
   - 强制TDD覆盖率门槛
   - 6周详细时间表

【已修复P0】
- PRD: F020 AI审核 P1→P0
- 创建 data/crowd_db/ 目录（D-01修复）
- 修订IP为v2版（10.1→11任务）
- 加入测试覆盖率门槛

【决策记录】
D-01: AI审核提升至P0
D-02: 管理后台/分享纳入MVP
D-03: Web端推迟到v2.3
D-04: 测试覆盖设硬指标
D-05: CI/CD简化版

【行业实践差距】
标准达标: 5/10 (50%)
- 测试覆盖: 🔴
- 错误处理: 🔴
- CI/CD: 🔴
- 降级策略: 🔴
- API版本: 🔴
- 日志审计: 🟡
- 性能监控: 🟡
- 数据备份: 🟡
- 安全认证: 🟡
- 文档: 🟡

【下一步】
启动T1 AI审核服务实施(10天)
2026-06-12 10:05:13 +08:00

14 KiB
Raw Blame History

实施计划 v2（修订版）

v2.1 详细开发任务分解 - 审核后修订

版本: v2.0 基础版本: v1.0 修订日期: 2026-06-11 修订原因: 审核发现14项差距，补齐4项P0后启动 目标: 实现AI审核、反扎堆检测、数据溯源、订单管理 时间: 2026年6月15日 - 7月25日（40天） 方法: TDD + 频繁提交 + 覆盖率门槛

0. 变更日志 (Change Log)

v1.0 → v2.0 主要变更

变更 原因 影响
新增T6管理后台MVP ADMIN_DESIGN 432行无对应实施 +7天
新增T7分享功能MVP SHARING_DESIGN 274行无对应实施 +5天
新增T8渠道SDK集成 场景A自动化实现 +3天
新增T9错误处理体系 行业最佳实践 +2天
新增T10 CI/CD基础 自动化测试+部署 +2天
T4.1增加加密字段 数据安全合规 +0.5天
T5.2增加并发测试 性能指标验证 +0.5天
T1.9细化Skills集成 避免功能割裂 +0.5天
强制TDD覆盖率门槛 行业基础标准 全程
总工期 30天 → 40天 +33%

关联文档

总览

11个核心开发任务

任务 工时 优先级 状态
T1: AI审核服务（49元版）⭐核心 10天 P0 📋
T2: 反扎堆检测功能 5天 P0 📋
T3: 数据溯源功能 5天 P1 📋
T4: 订单管理基础 5天 P1 📋
T5: 集成测试与发布 5天 P0 📋
T6: 管理后台MVP 7天 P1 📋 🆕
T7: 分享功能MVP 5天 P1 📋 🆕
T8: 渠道SDK集成 3天 P2 📋 🆕
T9: 错误处理体系 2天 P1 📋 🆕
T10: CI/CD基础 2天 P1 📋 🆕
T11: 性能与安全加固 3天 P2 📋 🆕

总工时: 52天（折合40个工作日）

T1: AI审核服务（49元版）⭐核心 [v1.0]

1.1-1.10 任务清单

ID 任务 工时 DoD
T1.1 准备扎堆数据库结构 1d data/crowd_db/ 目录+README+JSON
T1.2 创建审核服务Skill 0.5d skills/gaokao-audit/ 结构
T1.3 实现方案解析器 1.5d 10个测试通过
T1.4 集成规范检查器 1d 调用27省规则库
T1.5 实现扎堆检测器 1d 检测+替代方案
T1.6 实现审核服务主类 1d 端到端可用
T1.7 实现报告生成器 1d PDF生成
T1.8 创建命令行入口 0.5d gaokao-audit CLI
T1.9 集成到龙老师Skill（细化） 🆕 1d 4个skills协同工作
T1.10 审核服务集成测试 1.5d E2E测试通过

T2: 反扎堆检测功能 [v1.0]

ID 任务 工时 DoD
T2.1 整理大厂AI推荐数据 1d hunan.json 50+条
T2.2 实现数据加载器 0.5d loader.py + 测试
T2.3 实现扎堆检测算法 1d 风险评估+替代推荐
T2.4 创建扎堆报告展示 1d 集成到方案报告
T2.5 扎堆检测单元测试 0.5d 覆盖率≥80%

T3: 数据溯源功能 [v1.0]

ID 任务 工时 DoD
T3.1 扩展院校数据模型 1d 27省JSON含溯源
T3.2 实现溯源数据加载器 1d loader.py + 测试
T3.3 实现溯源报告生成 2d 报告展示溯源
T3.4 数据溯源CLI 0.5d gaokao-data-trace
T3.5 溯源API文档 0.5d API.md 更新

T4: 订单管理基础 [v1.0]

ID 任务 工时 DoD
T4.1 设计数据模型（含加密） 🆕 1d schema + AES-256
T4.2 实现数据访问层 1.5d DAO + 测试
T4.3 实现订单管理CLI 1d CRUD完整
T4.4 实现升级订单流程 1d 49→99补差价
T4.5 订单导出功能 0.5d CSV/Excel导出

T5: 集成测试与发布 [v1.0]

ID 任务 工时 DoD
T5.1 端到端测试 1.5d 业务流全通过
T5.2 性能+并发测试 🆕 1d 10并发+<5s
T5.3 文档更新 1d API/ARCH/CHANGELOG
T5.4 发布准备 1d Git tag + 推送3仓
T5.5 覆盖率门槛检查 🆕 0.5d 核心≥80%整体≥60%

T6: 管理后台MVP 🆕

审核发现: ADMIN_DESIGN.md 432行设计无对应实施

6.1 任务清单

ID 任务 工时 DoD
T6.1 FastAPI后端基础 1d 服务启动+路由
T6.2 仪表盘（数据统计） 1d 订单/用户/收入统计
T6.3 用户管理 1d 列表/详情/脱敏
T6.4 订单管理 1d 录入/状态/导出
T6.5 案例管理 1d CRUD+审核
T6.6 简易WebUI（ECharts） 1d 可视化展示
T6.7 部署Docker镜像 1d docker-compose

6.2 技术选型

  • 后端: FastAPI + SQLAlchemy
  • 前端: 极简（HTML+ECharts，避免重前端）
  • 认证: JWT（基础）
  • 部署: Docker Compose

6.3 详细计划

详见 docs/plans/T6-admin-mvp.md

T7: 分享功能MVP 🆕

审核发现: SHARING_DESIGN.md 274行设计无对应实施

7.1 任务清单

ID 任务 工时 DoD
T7.1 短链接生成 1d /s/ABC123 短码
T7.2 海报生成（PIL） 1.5d PNG/JPG 朋友圈图
T7.3 权限控制（3级） 1d 只读/评论/编辑
T7.4 撤销与统计 1d 访问量/访问者
T7.5 分享页WebUI 0.5d 响应式页面

7.2 详细计划

详见 docs/plans/T7-sharing-mvp.md

T8: 渠道SDK集成 🆕

审核发现: 场景A的自动化实现缺失

8.1 任务清单

ID 任务 工时 DoD
T8.1 闲鱼Webhook集成 1d 订单自动同步
T8.2 微信SDK集成 1d 消息推送+客服
T8.3 企业微信集成 0.5d 通知机器人
T8.4 失败兜底（手动） 0.5d 定期检查+人工

8.2 实施策略

  • 优先: Webhook轮询（合规、简单）
  • 备用: 手动录入（兜底）
  • 不推荐: 爬虫/逆向（合规风险）

8.3 详细计划

详见 docs/plans/T8-channel-integration.md

T9: 错误处理体系 🆕

审核发现: 行业实践 - 统一错误码缺失

9.1 任务清单

ID 任务 工时 DoD
T9.1 错误码体系设计 0.5d E001-E999体系
T9.2 用户友好提示 0.5d 错误→友好消息
T9.3 日志记录 0.5d 结构化日志
T9.4 异常捕获装饰器 0.5d @catch装饰器

9.2 错误码分类

E001-E099: 用户输入错误
E100-E199: 业务逻辑错误
E200-E299: 数据访问错误
E300-E399: 第三方服务错误
E400-E499: 系统错误
E500-E999: 预留扩展

9.3 详细计划

详见 docs/plans/T9-error-handling.md

T10: CI/CD基础 🆕

审核发现: 行业实践 - 自动化流程缺失

10.1 任务清单

ID 任务 工时 DoD
T10.1 GitHub Actions配置 1d 自动化测试
T10.2 覆盖率报告 0.5d codecov集成
T10.3 多仓库同步脚本 0.5d 3仓自动同步

10.2 流水线设计

# .github/workflows/ci.yml
name: CI
on: [push, pull_request]
jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3
      - uses: actions/setup-python@v4
      - run: pip install -r requirements.txt
      - run: pytest --cov=skills --cov=scripts --cov-report=xml
      - uses: codecov/codecov-action@v3
        with:
          file: ./coverage.xml
          fail_ci_if_error: true
          token: ${{ secrets.CODECOV_TOKEN }}

10.3 详细计划

详见 docs/plans/T10-cicd.md

T11: 性能与安全加固 🆕

审核发现: TECH性能目标无验证任务

11.1 任务清单

ID 任务 工时 DoD
T11.1 性能基准测试 1d locust脚本
T11.2 数据脱敏实施 1d 客户数据脱敏
T11.3 安全审计 1d 漏洞扫描

详细时间表（40天）

第1周（6/15-6/21）- 基础建设

日期 任务 任务ID
6/15 (一) T1.1+T1.2 扎堆库+Skill
6/16 (二) T1.3 (part1) 解析器+测试
6/17 (三) T1.3 (part2) 解析器完善
6/18 (四) T1.4 规范检查集成
6/19 (五) T1.5 扎堆检测器
6/20 (六) T1.6 审核主类
6/21 (日) T1.7 报告生成

第2周（6/22-6/28）- 审核完成

日期 任务 任务ID
6/22 (一) T1.8+T1.9 (part1) CLI+集成
6/23 (二) T1.9 (part2) 集成细化
6/24 (三) T1.10 (part1) E2E测试
6/25 (四) T1.10 (part2) E2E完善
6/26 (五) T2.1+T2.2 数据+加载器
6/27 (六) T2.3+T2.4 检测+展示
6/28 (日) T2.5+T9.1 测试+错误码

第3周（6/29-7/5）- 数据与订单

日期 任务 任务ID
6/29 (一) T3.1+T3.2 数据模型+加载器
6/30 (二) T3.3 溯源报告
7/1 (三) T3.4+T3.5 CLI+API文档
7/2 (四) T4.1 (含加密) 订单schema
7/3 (五) T4.2+T4.3 DAO+CLI
7/4 (六) T4.4+T4.5 升级流程+导出
7/5 (日) T9.2-T9.4 错误处理

第4周（7/6-7/12）- 管理后台

日期 任务 任务ID
7/6 (一) T6.1+T6.2 FastAPI+仪表盘
7/7 (二) T6.3+T6.4 用户+订单管理
7/8 (三) T6.5+T6.6 案例+WebUI
7/9 (四) T6.7 Docker镜像
7/10 (五) T7.1+T7.2 短链接+海报
7/11 (六) T7.3+T7.4 权限+撤销
7/12 (日) T7.5 分享WebUI

第5周（7/13-7/19）- 集成与发布

日期 任务 任务ID
7/13 (一) T8.1+T8.2 渠道SDK
7/14 (二) T8.3+T8.4 企业微信+兜底
7/15 (三) T10.1+T10.2 CI/CD
7/16 (四) T10.3 多仓库同步
7/17 (五) T11.1 性能测试
7/18 (六) T11.2+T11.3 脱敏+安全
7/19 (日) T5.1 E2E测试

第6周（7/20-7/25）- 发布准备

日期 任务 任务ID
7/20 (一) T5.2 并发测试
7/21 (二) T5.3 文档更新
7/22 (三) T5.4 发布准备
7/23 (四) Git tag v2.1 版本发布
7/24 (五) 推送3仓 同步发布
7/25 (六) 复盘总结 项目归档

验收标准

每个Task的DoD

  • 代码已实现
  • 单元测试已写且通过覆盖率门槛（核心≥80%）
  • 集成测试通过（如适用）
  • 文档已更新
  • 已提交到Git
  • 已推送到3个仓库
  • CI流水线通过（T10后）

整个v2.1的DoD

  • AI审核服务可运行（49元版）
  • 反扎堆检测可运行
  • 数据溯源在报告中可见
  • 订单管理可工作
  • 管理后台MVP可用
  • 分享功能MVP可用
  • 测试覆盖率：核心≥80%, 整体≥60%
  • CI流水线通过率100%
  • 端到端测试100%通过
  • 3个仓库代码同步
  • 文档完整
  • 已通过闲鱼承接5+大厂AI用户

风险与应对

风险 可能性 影响 应对措施
工期延长错过高考季 中 高 优先P0，可砍T6-T11
测试覆盖率不达标 中 中 TDD强制+CI门槛
管理后台范围蔓延 中 中 MVP原则
渠道SDK不稳定 高 中 手动兜底方案
集成问题 中 中 提早联调

相关文档

版本: v2.0 最后更新: 2026-06-11 下次评审: 任务完成后

Reference in New Issue View Git Blame Copy Permalink