# 实施计划 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% | ### 关联文档 - [AUDIT_REPORT_2026-06-11.md](archive/2026-06-historical-snapshots/AUDIT_REPORT_2026-06-11.md) - [REMEDIATION_TASK_BOARD_2026-06-11.md](archive/2026-06-historical-snapshots/REMEDIATION_TASK_BOARD_2026-06-11.md) --- ## 总览 ### 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](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](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](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](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](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 流水线设计 ```yaml # .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](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 - [ ] 代码已实现 - [x] 单元测试已写且**通过覆盖率门槛**（全局≥80%，核心=100%，E2E模拟通过） - [ ] 集成测试通过（如适用） - [ ] 文档已更新 - [ ] 已提交到Git - [ ] 已推送到3个仓库 - [ ] **CI流水线通过**（T10后） ### 整个v2.1的DoD - [ ] AI审核服务可运行（49元版） - [ ] 反扎堆检测可运行 - [ ] 数据溯源在报告中可见 - [ ] 订单管理可工作 - [ ] 管理后台MVP可用 - [ ] 分享功能MVP可用 - [x] **测试覆盖率：全局≥80%, 核心=100%, E2E模拟通过** - [ ] **CI流水线通过率100%** - [ ] 端到端测试100%通过 - [ ] 3个仓库代码同步 - [ ] 文档完整 - [ ] **已通过闲鱼承接5+大厂AI用户** --- ## 风险与应对 | 风险 | 可能性 | 影响 | 应对措施 | | ------------------ | ------ | ---- | ------------------ | | 工期延长错过高考季 | 中 | 高 | 优先P0，可砍T6-T11 | | 测试覆盖率不达标 | 中 | 中 | TDD强制+CI门槛 | | 管理后台范围蔓延 | 中 | 中 | MVP原则 | | 渠道SDK不稳定 | 高 | 中 | 手动兜底方案 | | 集成问题 | 中 | 中 | 提早联调 | --- ## 相关文档 - [AUDIT_REPORT](archive/2026-06-historical-snapshots/AUDIT_REPORT_2026-06-11.md) - 审核报告 - [REMEDIATION_TASK_BOARD](archive/2026-06-historical-snapshots/REMEDIATION_TASK_BOARD_2026-06-11.md) - 任务板 - [TECH_ARCHITECTURE](../TECH_ARCHITECTURE.md) - 技术架构 - [PRD](../../product/PRD.md) - 产品需求 --- **版本**: v2.0 **最后更新**: 2026-06-11 **下次评审**: 任务完成后