niuniu/gaokao-volunteer-system
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
86296bdb0e41d2e7d7d3f4b710dfb020c32eec6e
gaokao-volunteer-system/docs/IMPLEMENTATION_PLAN_v2.md
Hermes Agent 6e06e150b0
Some checks failed
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(cleanup): archive top-level historical reports
2026-06-18 11:01:15 +08:00

17 KiB
Raw Blame History

实施计划 v2（修订版）

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

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

当前说明：T1-T4、T6-T10 已有较多实现落地，但文档状态滞后；用户端 Web 自助闭环不在本计划已落地产物内。

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个工作日）

T12: 用户端 Web 自助 MVP 🆕

当前已正式立项。实施计划见 docs/plans/T12-web-self-service-mvp.md。

ID 任务 工时 DoD
T12.1 文档真相与入口基线校准 0.5d PRD/ROADMAP/BUSINESS_SCENE/T12 口径一致
T12.2 公共前台入口与套餐页 1d Landing + Pricing 页面可访问
T12.3 公开下单 1d 用户可创建前台订单
T12.4 支付域抽象 1d payment model/dao/service
T12.5 单支付提供方接入 1.5d 至少一个真实 provider
T12.6 支付回调与幂等 1d 验签/金额校验/重复回调保护
T12.7 资料填写页 1d 支付后资料表单闭环
T12.8 后台接单处理衔接 1d 前台订单进入后台处理链
T12.9 订单状态页与交付页 1d 站内查看/下载报告
T12.10 通知交付 0.5d report_ready 可通知
T12.11 退款与异常兜底 0.5d 最小售后链
T12.12 E2E 验收 1d 全链路测试通过

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% / 核心=100% / E2E模拟通过 ✅ 已完成（2026-06-13）

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 订单自动同步 ✅ 已实现并本地验证（Webhook 接单 + poller 兜底 + 审计 + 测试/覆盖率）
T8.2 微信SDK集成 1d 消息推送+客服 ✅ 已实现并本地验证（access_token 缓存 + 订阅消息/客服消息 + 标准库 transport + 测试）
T8.3 企业微信集成 0.5d 通知机器人 ✅ 已实现并本地验证（机器人 webhook + 应用消息 + access_token 缓存 + 测试）
T8.4 失败兜底（手动） 0.5d 定期检查+人工 待开始

8.2 实施策略

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

8.3 详细计划

详见 docs/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%，核心=100%，E2E模拟通过）
  • 集成测试通过（如适用）
  • 文档已更新
  • 已提交到Git
  • 已推送到3个仓库
  • CI流水线通过（T10后）

整个v2.1的DoD

  • AI审核服务可运行（49元版）
  • 反扎堆检测可运行
  • 数据溯源在报告中可见
  • 订单管理可工作
  • 管理后台MVP可用
  • 分享功能MVP可用
  • 测试覆盖率：全局≥80%, 核心=100%, E2E模拟通过
  • 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