项目推进计划（Project Roadmap - PJR）¶
文档编号：DOC-A08 / PJR 版本：V1.1 创建日期：2026-08-20 最近更新：2026-08-21 维护人：听写（DT） 关联文档：PMG V8.0、PJM V3.0、RQD-O 执行级需求、MVP 实施方案、协作记录 COLLAB、DTL-20260820-02 阶段5完成、DTL-20260820-03 活标本失活修正
一、文档定位¶
本文档是项目重构重启后（阶段 1-5 完成）的整体推进路线图，承接 TL 指令「然后继续安排项目推进」。聚焦三个时间维度：
- 短期（P0 阻塞解除）：V3.3.0 代码恢复 → 生产部署 → UAT 复验 → 上线就绪
- 中期（V3.4.0 增量）：UAT 4 个脚本问题修复 + 真实用户场景拓展 + 运营端补齐
- 远期（V4.0.0 生产化）：MVP 验证收尾 → 口碑壁垒落地 → 运营推广 → 规模化
不替代 PJM V3.0 的项目管理制度，仅作为推进节奏的视图层。
二、当前状态评估¶
2.1 已完成资产盘点¶
| 维度 | 状态 | 关键证据 |
|---|---|---|
| 业务设计文档 | ✅ 完整 | RQD 三层 + QSV/CPT/MDS/OPS 五大服务设计 + TSMM 标签元模型 + MVP 实施方案 |
| UAT 用例 | ✅ 26 基线全覆盖 | S3 首轮 + S6 修复验证 + S7 全链路 → 43/47 PASS（4 FAIL 全为脚本问题，0 WDE Bug） |
| V3.3.0 后端代码 | ❌ 丢失 | 本机 .py 源文件被误删，Gitee 远程从未 push；127.0.0.1:8000 进程内存活标本已随三 AI 重启消失（2026-08-21 确认），完全依赖听码本地工作区恢复 |
| 生产环境部署 | ❌ 仍是 V2.0.0 | 阿里云 ECS 8.218.165.94，docker tag=weavely/dip1-api:prod，openapi 64 路由（非 136） |
| 三 AI 协作机制 | ✅ 已重构 | DT/WDE/OCM 三角色手册+DTL/OCL/WDL 日志体系+双轨交付+COLLAB 协作通道 |
| 项目治理 | ✅ 已升级 | AGENTS V8.0 + PJM V3.0 + GLY V4.6 + 协作记录 V1.8 |
2.2 核心矛盾¶
唯一阻塞：V3.3.0 代码未入库 → 生产环境无法升级 → UAT 真实用户测试无法启动 → COLLAB-20260819-01 无法 closed。
根因：原 dip1/、ocm/、协作记录.md 未纳入 git 跟踪 → 工作区清理时被误删 → 同时 V3.3.0 从未 push 到 Gitee 远程 → 双重损失。
救济路径：听码本地工作区必有 V3.3.0 源码（听码是开发者）→ 听码恢复 → 听写打包 push → 听云部署 → 听写 BD 后门复验。
三、短期推进路径（P0 阻塞解除，预计 1-3 工作日）¶
3.1 推进甘特图（Mermaid）¶
gantt
title V3.3.0 阻塞解除与上线收尾
dateFormat YYYY-MM-DD HH:mm
axisFormat %m-%d %H:%M
section 听码恢复
@听码 阅读代码基线 :w1, 2026-08-20 14:30, 30m
@听码 本地工作区恢复源码 :w2, after w1, 2h
@听码 核对 5 BUG 修复基线 :w3, after w2, 30m
@听码 本地自测(端口 8001) :w4, after w3, 1h
@听码 通知听写 + 写 WDL :w5, after w4, 30m
section 听写打包验证
听写 git pull 静态基线核对+功能验收对齐 :d1, after w5, 1h
听写打包 push hk2026 :d2, after d1, 30m
section 听云部署
@听云 服务器 git pull :o1, after d2, 30m
@听云 DB 备份+alembic 0011 :o2, after o1, 1h
@听云 v3_seed+7 环境变量 :o3, after o2, 30m
@听云 deploy-backend --force :o4, after o3, 30m
@听云 健康自检+写 OCL :o5, after o4, 30m
section 听写复验
听写 BD 后门 BD-01~06 :v1, after o5, 30m
听写静态基线+功能验收基准核对 :v2, after v1, 30m
听写 UAT 关键用例抽检 :v3, after v2, 1h
关闭 COLLAB-20260819-01 :milestone, after v3, 0d3.2 关键里程碑¶
| # | 里程碑 | 判定标准 | 负责方 |
|---|---|---|---|
| M1 | 听码提交代码 | WDL-01 完成 + commit hash 回填协作记录 | @听码 |
| M2 | 听写打包 push | hk2026 远程 main 含 V3.3.0 + DTL 日志 | 听写 |
| M3 | 听云部署完成 | /health version=3.3.0 + openapi 136 + OCL 日志 | @听云 |
| M4 | 听写 BD 后门复验通过 | BD-01~06 全绿 + schema=0011 + 种子数据就位 | 听写 |
| M5 | COLLAB-20260819-01 closed | 生产系统完全可用，UAT 真实用户测试可启动 | 听写 |
3.3 验收路径（对照基准：静态基线 + 功能验收）¶
V3.3.0 对照基准（两套，同时满足）： 1. 静态基线（硬约束，可机器核对）： - 代码基线：COLLAB-20260820-02 §代码基线要求 5 条（5 BUG 修复 + Alembic head=0011_v33_ext_ufcs_oqs_mfd + v3 种子 + 7 环境变量 + BD 后门 6 端点） - 结构基线：COLLAB-20260820-02 §丢失/缺失的代码范围 9 层模块清单（interfaces/api ~ alembic/versions，~70+ .py 文件） 2. 功能验收基准（历史测试报告，可复跑对齐）： - COLLAB 协作记录 §TR-20260819-03：S7-1 OQS 8/8、S7-2 CST 14/17、S7-3 LGD 11/11、S7-4 MFR 10/11，0 新增 WDE Bug - openapi 路由数 = 136，V3 路径（/oqs/ /lgd/ /mfd/ /ufcs/ /dt/）= 72 条 - UAT 26 基线用例覆盖率 100%（§TR-20260819-03 三·最终覆盖统计表）
2026-08-21 变更说明：原本机 127.0.0.1:8000 进程内存活标本（进程+pycache）因三 AI 重启已不存在，原"活标本勿重启"保护条款废除，改为以上静态基线+功能验收基准双轨对照。听码恢复代码后，听写先执行静态基线机器核对（5 BUG + Alembic + v3_seed + 环境变量 + BD 端点 + 文件结构清单），再本地启动服务复跑 TR-20260819-03 功能验收关键路径。
四、中期推进路径（V3.4.0 增量，预计 1-2 周）¶
4.1 V3.4.0 增量范围¶
基于 UAT 报告 TR-20260819-03 的 4 个脚本问题与 3 个运营端缺口，规划 V3.4.0 增量：
| # | 增量项 | 类型 | 责任方 | 来源 |
|---|---|---|---|---|
| I1 | S7-2 报价 404：补运营端 OL 创建报价步骤 | 脚本+流程 | 听写+@听码 | UC-15.6/15.7 |
| I2 | S7-2 师傅 404：补 CPT PATCH 派单步骤 | 脚本+流程 | 听写+@听码 | UC-15.9 |
| I3 | S7-4 空 dict body 422：修正传参 | 脚本 | 听写 | UC-26.3 |
| I4 | demo cleanup 幂等专项验证 | 部署前验证 | @听云 | WDE-005 |
| I5 | 真实用户场景拓展：C 端标准+异常+B2B2C 三模式真实账号联调 | UAT 扩展 | 听写 | RQD-O §3 MVP |
| I6 | 运营端工具：OL 创建报价 + CPT 派单的最小操作界面 | 前端 | @听码+听写设计 | RQD-B OPS-01~10 |
4.2 V3.4.0 验收标准¶
- 4 个脚本问题全部修复（I1~I3），UAT S7 阶段重跑 4 FAIL 用例 → 全 PASS
- demo cleanup 幂等专项验证通过（I4）
- 真实用户场景至少 1 个完整链路验证（C 端标准+异常+B2B2C 本地任选 1，I5）
- 运营端最小操作界面原型就位（I6 草稿版）
4.3 真实用户测试启动条件¶
听写完成 BD 后门复验 + V3.4.0 脚本问题修复后，正式启动真实用户测试（招募 2-3 个内部测试用户 + 1 个真实客户）。
五、远期推进路径（V4.0.0 生产化+运营推广，月级规划）¶
5.1 V4.0.0 战略目标（对齐 RQD-S 战略级需求）¶
| 维度 | V4.0.0 目标 | 关联文档 |
|---|---|---|
| 服务能力 | 8 大品类全覆盖 + 香港全区域配送 + B2B2C 双模式稳定运行 | RQD-B §1~3 |
| 口碑壁垒 | CPT-D L8 NPS 采集闭环 + OPS-D 口碑营销引擎 + CPL 推荐关系链 | RQD-S §3 口碑壁垒 |
| 数据闭环 | CPT→MDS 反哺机制上线（师傅画像/楼宇档案/客户标签自动更新） | MDS-D §5 + CPT-D §5 |
| 运营推广 | 6 类获客场景至少 3 个落地（线上露出+品牌合作+菜鸟物流） | OPS-S 场景手册 |
| PDPO 合规 | 客户数据保护+师傅隐私保护+授权链路 | CPL §合规 + WPL §隐私 |
5.2 V4.0.0 关键路径¶
graph LR
A[V3.3.0 上线] --> B[V3.4.0 脚本修复+真实场景]
B --> C[口碑闭环试点<br/>NPS+推荐关系]
C --> D[MDS 反哺上线<br/>画像自动更新]
D --> E[运营推广启动<br/>3 场景落地]
E --> F[V4.0.0 生产化<br/>8品类全区域]
style A fill:#2a9d8f,color:#fff
style F fill:#457b9d,color:#fff5.3 关键风险与缓解¶
| 风险 | 等级 | 缓解措施 | 责任方 |
|---|---|---|---|
| 代码再次丢失 | 高 | 阶段 1 已建 git 跟踪基线，强制每次修订即时 commit | 听写 |
| 真实用户测试反馈慢 | 中 | 启动前预招募 2-3 内部测试用户 | 听写 |
| PDPO 合规审查延迟 | 中 | 提前与 RQD-O 干系方（曾总/郭总）对齐审查标准 | 听写+TL |
| 运营推广投入不足 | 中 | TL 优先级决策+OPS 6 场景分阶段落地 | TL |
六、三 AI 协作矩阵¶
6.1 短期 P0 阶段协作矩阵¶
| 任务 | 听写（DT） | 听码（WDE） | 听云（OCM） |
|---|---|---|---|
| 代码恢复 | — | R 主责 | — |
| 代码对照验证 | R 主责 | C 协助 | — |
| 打包 push hk2026 | R 主责 | — | — |
| 生产部署 | — | — | R 主责 |
| BD 后门复验 | R 主责 | — | C 协助 |
| UAT 真实用户测试 | R 主责 | C 按需修复 | C 按需部署 |
| 日志持续 | DTL 持续 | WDL 持续 | OCL 持续 |
R=主责 / C=协助
6.2 协作通道与频率¶
| 通道 | 用途 | 频率 |
|---|---|---|
| 协作记录 COLLAB | 三 AI 之间任务流转 | 按需（每次任务发起/关闭） |
| DTL 日志 | 听写过程留痕 | 每个任务节点 |
| WDL 日志 | 听码过程留痕 | 每个代码任务节点 |
| OCL 日志 | 听云过程留痕 | 每个运维操作节点 |
| 周度同步 | TL 主持，三 AI 进展汇报 | 每周一 |
七、立即执行项（TL 已签发）¶
7.1 TL 待启动听码¶
听码作为独立 AI 角色，需 TL 在听码工作环境（dip1 子项目）中直接启动，加载以下文档：
- dip1/docs/DIP1-IMP-Code-Agent实施指南.md WDE 工作手册 V1.0
- dip1/docs/DIP1-SPEC-V3.3.md V3.3.0 规格
- dip1/docs/DIP1-IMP-V3.3.md V3.3.0 实施
- docs/协作记录.md COLLAB-20260820-02 代码恢复协作请求
听码启动后按 9 步流程执行（详见协作记录 §三 进展记录 2026-08-20 14:30）。
7.2 听写立即执行项¶
| # | 任务 | 状态 |
|---|---|---|
| T1 | 完成阶段 1-5 重构重启 | ✅ 已完成 |
| T2 | 写 DTL-02 阶段 5 完成日志 | ✅ 已完成 |
| T3 | 编制本推进计划 | ✅ 已完成（本文档） |
| T4 | 等待 @听码 提交代码后做对照验证 | ⏳ 待听码响应 |
| T5 | 完成代码对照后打包 push hk2026 | ⏳ 待 T4 |
| T6 | 通知 @听云 开始部署 | ⏳ 待 T5 |
| T7 | BD 后门复验（BD-01~06） | ⏳ 待 @听云 部署 |
| T8 | 关闭 COLLAB-20260820-02 / -01 / COLLAB-20260819-01 | ⏳ 待 T7 |
7.3 听云待启动项¶
@听云 在听写打包 push hk2026 后，按 V3.3.0 升级差异项 10 步执行（详见协作记录 COLLAB-20260819-01）：
- 服务器 git pull 拉取 V3.3.0 代码
- DB 备份（pg_dump）
- alembic upgrade head（0006~0011 共 6 个迁移，29 张新表）
- 执行 v3_seed.py（UFCS 21 + VQR 16 + MFR 1 + LGD 1 + 17 demo 账号）
- 配置 7 项新环境变量（UFCS_SECRET/UFCS_TOKEN_TTL_HOURS/UFCS_MAX_ATTEMPTS_PER_IP/DT_BACKDOOR_ENABLED/DT_BACKDOOR_TOKEN/OQS_ORL_BASE_URL/PDF_OUTPUT_DIR）
- deploy-backend.sh --force 重建镜像+容器
- demo cleanup 幂等验证（WDE-005）
- 健康自检 /health version=3.3.0
- 写 OCL 日志回填协作记录
- 通知听写 BD 后门复验
八、修订记录¶
| 版本 | 日期 | 修订人 | 修订内容 |
|---|---|---|---|
| V1.0 | 2026-08-20 | DT | 初版发布：现状评估+P0 阻塞解除路径+V3.4.0 增量+V4.0.0 远期+三 AI 协作矩阵+立即执行项 |
本文档为项目推进路线图（PJR DOC-A08 V1.0），承接 TL「继续安排项目推进」指令。短期 P0 聚焦 V3.3.0 上线收尾，中期 V3.4.0 聚焦脚本修复+真实场景，远期 V4.0.0 聚焦生产化+运营推广+口碑壁垒落地。