437 lines
17 KiB
Markdown
437 lines
17 KiB
Markdown
# 实施计划 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](../AUDIT_REPORT_2026-06-11.md)
|
||
- [REMEDIATION_TASK_BOARD_2026-06-11.md](../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](../AUDIT_REPORT_2026-06-11.md) - 审核报告
|
||
- [REMEDIATION_TASK_BOARD](../REMEDIATION_TASK_BOARD_2026-06-11.md) - 任务板
|
||
- [TECH_ARCHITECTURE](../TECH_ARCHITECTURE.md) - 技术架构
|
||
- [PRD](../../product/PRD.md) - 产品需求
|
||
|
||
---
|
||
|
||
**版本**: v2.0
|
||
**最后更新**: 2026-06-11
|
||
**下次评审**: 任务完成后
|