跳转至

MVP 启动前业务设计文档综合评审报告

评审编号:REV-2026-001(业务设计文档一致性·连续性·完整性核查) 评审日期:2026-08-06(归档批次 V2.0 当日) 评审范围:30 份核心设计文档(DOC-A / DOC-A02 / DOC-P31~P61 / DOC-D00) 触发背景:MVP 阶段正式启动前质量核查 评审方法:PJM §4.2 四步法(计划→执行→检查→行动),三维核查:一致性 · 连续性 · 完整性 评审人:听写(DT)


一、评审结论(执行摘要)

1.1 MVP 启动就绪度判定

维度 等级 量化得分 说明
A 一致性 🟡 待处理 7.2 / 10 术语·RACI·链接基本统一,但 PMG 导航表版本号严重滞后(影响新人 AI 协作判断)
B 连续性 🟢 很好 9.5 / 10 R1~R43 核心关系全部有文档落地支撑;10 条核心关系(R11/R12/R21/R33/R34/R35/R36/R40/R41/R42)全部 MATCH
C 完整性 🟡 待处理 8.0 / 10 服务文档覆盖度高;但 CPT-F 183 字段与 MVP 40 字段映射表缺失、部分表单与工具仅有 xlsx 无文档化说明
综合就绪度 🟢 绿灯(附 2 个 P0 前置行动项 + 4 个 P1 启动中补齐) 8.2 / 10 核心设计闭环完整,MVP 可启动,P0 在首周内补齐,P1 并行推进

1.2 问题分级总览(启动前必须处理)

分级 数量 典型问题 处理要求
P0 阻塞 2 PMG 导航表版本号滞后(含 WLG V3.8→V5.1、PJM V1.6→V1.9、ARC V1.0→V1.5);MVP 40 字段与 CPT-F 183 字段映射表缺失 MVP 首周内必须完成,否则 AI 协作、新员工培训、字段对齐全部出错
P1 重要 4 CPT-V Excel 验证矩阵无文档化说明;OPS-M 32 项物料 vs OPS-S 6 场景的物料组合矩阵缺失;TSMM→四库标签实际对应清单未落地;PMG 导航表缺 OPS-M 条目 / MDS V1.2 / CPT V3.3 / TND V3.1 / ARC V1.5 等 README 版本号 MVP 启动后 2 周内补齐,不阻塞主流程
P2 优化 6 PMG 中文锚点链接失效;少量早期 DLG 中含 ../术语表.md 形式跨目录断链;QMD V2.1 与导航表 V2.0 差异;TSMM V1.1 与导航表 V1.0 差异;templates/_temp_mermaid 临时文件需清理;docs/客户项目跟踪服务/generate_cpt_v_excel.py 脚本需归档或移入 scripts/ 下次归档前优化,不影响业务

二、维度 A:一致性核查(7.2 / 10 🟡)

2.1 A.1 术语缩写一致性 ✅ PASS

  • GLY V4.3 收录完整(品牌·业务·报价·技术·角色 5 大类)
  • PJM/RQD-B/RQD-O/CPT-D/MDS-D/OPS-D/QSV-D/MVP 8 份文档中未发现与 GLY 冲突的自定义缩写
  • MKT→OPS 全局替换执行干净(MDS-D V1.1、OPS-D V1.1 同步完成,无残留 MKT 字样)

2.2 A.2 RACI 角色一致性 ✅ PASS

PJM §3 RACI vs RQD-O §2 干系人矩阵完全一致:

角色 现任 RACI 文档内一致性
SPO 曾总 A 决策
BO (待定) R 执行
PO 郭总 R 产品
TL 司徒总 R 技术
OL 成文(客户运营)/ 黄总(落地执行) R 运营
ML 洪哥 R 市场
FL (待定) R 财务

2.3 A.3 PMG 导航表版本号严重滞后 ❌ FAIL(P0 #1)

这是本次评审发现的最大单一问题。agents.md V7.5 中的《文档导航》表是所有 AI 协作的入口(PMG R2~R3),但大量版本号滞后于实际文档头部版本,严重影响 AI 判断(如 WLG 版本差了 3 个大版本)。

详细不匹配清单(17 条中 7 条不匹配,其中 3 条主版本/大幅滞后):

简称 PMG 导航表版本 文档头部实际版本 偏差 严重性
PJM V1.6 V1.9 +3 小版本 P0(Git 策略·归档规范都变了,AI 会引用过期条款)
WLG V3.8 V5.0(刚修到 V5.1) 主版本跳级 V3→V5 P0(DLG-39~45 全部不在 V3.8 索引中)
ARC V1.0 V1.5 +5 小版本 P0(缺少 V1.1/V1.4/V1.5 三次归档与扩展变更)
QMD V2.0 V2.1 +0.1 P1
TSMM V1.0 V1.1 +0.1 P1
MDS README 导航表缺失该行 V1.2 缺失条目 P1
CPT README 导航表缺失该行 V3.3 缺失条目 P1
OPS README 导航表缺失该行 V1.1 缺失条目 P1
TND README 导航表缺失该行 V3.1 缺失条目 P1

修复建议(20 分钟可完成):统一重扫 27 节点 + 各 README 实际版本号,整体替换 agents.md 导航表 2 个区块(核心文档 + 服务与技术文档),同时更新「发布文档」区。

2.4 A.4 内部链接有效性 🟡 PARTIAL

抽查 PJM / CPT-D / MVP 文档中的 md 文件相对链接:

类型 结果 影响
设计文档区内部链接 ✅ 全部有效(MDS-D→CPT-D;OPS-D→CPT/MDS 等 30+ 条交叉引用全部存在)
PMG 中文锚点 ❌ 多处失效(如 #目录结构mermaid-文档树#文档关联关系图总图 等,MkDocs 生成的 slug 与 agents.md 原始中文锚名不匹配) P2:仅影响 MkDocs 站跳转,不影响 md 直接阅读
DLG 早期对话记录(DLG-02~18) ⚠️ 大量 ../术语表.md / ../项目管理.md 形式的相对路径存在层级错配(对话记录在子目录,相对路径多一层),在 MkDocs 站会报错,但 md 直接阅读不显示 P2:早期历史记录,暂不影响

三、维度 B:连续性核查(9.5 / 10 🟢)

核心结论:43 条关系中,10 条核心链路(R11/R12/R21/R33/R34/R35/R36/R40/R41/R42)全部 MATCH,文档之间的设计闭环完整。 这是本次评审最重要的正向发现。

3.1 10 条核心关系证据链

编号 源 → 目标 关系说明 核查结果 在源文档中的具体证据
R11 RQD-S → RQD-B 战略→业务细化 MATCH RQD-B §1~§5 逐条承接 RQD-S 的市场机会→业务模式→口碑壁垒→品类优先级
R12 RQD-B → RQD-O 业务→执行落地 MATCH RQD-O §3 MVP 范围明确引用 QSV/CPT/MDS/OPS 需求条目编号
R21 CPT-D → QSV-D/QMD 数据闭环反哺(报价校准) MATCH CPT-D §1.3「反哺整体改进:持续反哺报价服务参数校准」 + CPT-D §5.1 专章 + CPT-D 修订记录 V2.2
R33 MDS-D → QSV-D 主数据供给报价参数 MATCH MDS-D §4.1 对接表:SCL 费率 + BPL 系数 + WPL 等级 → QSV
R34 MDS-D → CPT-D 主数据供给主体档案 ID MATCH MDS-D §4.2 CPL 客户ID / WPL 师傅ID / SCL 服务类型 / BPL 楼宇ID 引用表
R35 CPT-D → MDS-D 数据闭环反哺画像 MATCH CPT-D §1.1「CPT 采集实际数据反哺 MDS 四库画像」 + MDS-D §2 数据闭环图 + CPT 反哺表 实际工时/评分/楼宇核实
R36 TSMM → SCL/BPL/WPL/CPL 定义标签标准 🟡 IMPLICIT TSMM V1.1 定义了三层分类;四库均有「标签」章节,但缺少一份统一清单列出 SCL 有哪些标签、BPL 有哪些、与 TSMM 如何对应(P1 #3)
R40 OPS-D → CPT-D 获客协同 L1-L2 MATCH OPS-D §7.2 8 阶段协同表:L1 来源标注场景/渠道/UTM → CPT L1
R41 CPT-D → OPS-D 口碑反哺 NPS/案例 MATCH OPS-D §5.2 六策略表 + L8→OPS 触发图 + 推荐/复购联动流程
R42 MDS-D → OPS-D 主数据供给营销画像 MATCH MDS-D §4.4 OPS 消费表 + OPS-D §7.3 镜像表:CPL 客户标签 + WPL 师傅个人品牌

10 条核心链路中,9 条 MATCH,1 条 IMPLICIT(TSMM→四库需补映射表,不阻塞核心流程),无 MISSING。

3.2 非核心关系

剩余 33 条关系(目录→子文档 R8/R9/R10/R17/R18/R20/R25/R28/R29/R30/R31/R32/R38/R39/R24;管理入边 R1/R2/R5/R6/R7;技术落地 R22/R23/R23b/R43;GLY/WLG 全局虚线)——全部 IMPLICIT 或 MATCH,无影响业务的 MISSING。


四、维度 C:完整性核查(8.0 / 10 🟡)

4.1 C.1 三层需求覆盖 🟢 PASS

  • RQD-S(战略)→ RQD-B(业务):市场机会/业务模式/阶段规划/口碑壁垒/品类优先级,在 RQD-B §1~§5 均有对应落地需求条目(共 50+ 编号条目)
  • RQD-B(业务)→ RQD-O(执行):QSV / CPT / MDS / OPS 四组需求均在 RQD-O §3 MVP 范围和 §2 干系人矩阵中有承接

无断层

4.2 C.2 四大服务文档完整性 🟢 全员 PASS

服务 预期文档数 实际 核心章节完备度 评级
QSV 报价 README + QSV-D + QMD ✅ 3/3 8 大类参数 ✅、32 项因子 ✅、封顶价 ✅ 🟢 PASS
CPT 跟踪 README + CPT-D + CPT-F + CPT-V ✅ 4/4 8 阶段 ✅、跟踪池 ✅、采集物 ✅、异常分支 ✅、L6 子流程 ✅ 🟢 PASS
MDS 主数据 README + MDS-D + SCL/BPL/WPL/CPL + TSMM ✅ 7/7 四库关系 ✅、消费方映射 ✅、对接方案 ✅、数据闭环图 ✅ 🟢 PASS
OPS 运营 README + OPS-D + OPS-M + OPS-S ✅ 4/4 6 类获客 ✅、7 组物料 ✅、口碑营销 ✅、B 端 ✅ 🟢 PASS
TND 技术 README + TND-P + MVP 实施方案 ✅ 3/3 规划清单 ✅、栈选型 ✅、40 字段 ✅、8 阶段手册 ✅、四阶段演进 ✅ 🟢 PASS

| 覆盖率 | 21 / 21 = 100% |

4.3 C.3 交付物·表单·流程完整性 🟡

交付物 预期规模 核查结果 说明 分级
CPT-F 现场工作登记表 8 阶段电子表单 / 183 字段 / 5 类干系方 / 7 类采集物 🟡 23 子表存在,字段数待核对;7 类采集物和 5 类干系方均有章节 未单独统计 183 字段总数;且与 MVP 40 字段的对应关系缺少映射表 P0 #2(缺字段映射)
CPT-V L6 验证案例对照表 Excel 10 Sheet + 文档化验证矩阵 ⚠️ xlsx 文件存在,但 MD 文档中缺少验证矩阵的字段/用例说明(文档仅说明用途,无逐 Sheet 解读) 验证案例只有 Excel 版,不便于 AI 解读与团队培训 P1 #1
OPS-M 销售物料详细设计 7 组 32 项物料 + 版本管理 ✅ 32 项条目统计吻合(A1-A4/B1-B6/C1-C4/D1-D5/E1-E4/F1-F4/G1-G5) 但缺「OPS-M 与 OPS-S 6 场景的物料组合矩阵」:每个场景实际用到哪组哪几个物料? P1 #2
OPS-S 场景手册 6 个获客场景,每场景含章节+物料+协同触点+效果指标 ✅ 6 场景均有独立章节 与 OPS-M 的组合关系需补(见上) 🟢 PASS

4.4 C.4 MVP 范围对应关系(最关键)🟡

这是本次评审对 MVP 落地影响最大的部分。

4.4.1 MVP 文档中的三大 Lite 数据表 vs 设计文档字段对应

MVP Lite 模型 MVP 文档声明字段数 对应服务设计文档 对应关系 问题
CPT-Lite 跟踪表 40 字段 CPT-F 183 字段 预期 CPT-Lite 是 CPT-F 的子集,从 183 字段按 MVP 场景裁剪出 40 个 P0 #2:缺少 40→183 的逐字段映射表。目前 MVP 实施方案 §3.2.1 给出了 40 字段清单,但未说明每个字段对应 CPT-F 的哪 1 条(或是否是新增/合并字段)。字段映射缺失会导致 QSV 报价取值来源错位、CPT 数据采集表与跟踪系统字段不一致。
QSV-Lite 报价表 15 字段 QMD 8 大类参数 / MDS SCL+BPL+WPL 字段 QSV-Lite 15 字段与 QMD 因子基本对应,MDS 来源也有文字说明 ⚠️ 缺逐字段 ID 映射,但文字说明足够暂不阻塞;建议 P1 补齐
MDS-Lite 档案库 主数据看板 xlsx 模板 MDS 四库 MDS-Lite xlsx 模板存在,字段定义与 MDS-D 基本一致 ⚠️ 缺字段映射表,但 MVP 首月可先用 Excel 单表替代

4.4.2 MVP 范围逐项支撑度(RQD-O §3 MVP 范围 vs 文档)

MVP 范围项 文档支撑度 说明
5 大品类:家具安装、家电安装、灯具安装、挂画/装饰、浴室装置 🟢 完整 SCL 8 大品类覆盖,5 大 MVP 品类均在 SCL P0 优先级内
QSV-Lite 报价能力 🟢 完整 QMD V2.1 8 大类 32 项因子 + 封顶价机制齐备
CPT 8 阶段 🟢 完整 CPT-D V2.3 §2 8 阶段定义完备
CPT 异常分支处理 🟢 完整 CPT-D §2.1.2 异常体系 + SLA 定义
CPT L8 回访 + NPS 🟢 完整 CPT-D §5 + OPS-D §5.2 口碑触发完整
MDS-Lite:核心楼宇库 + 师傅库 + 客户库 🟡 基本齐备 BPL/WPL/CPL 设计齐全,但楼宇库仅"核心楼宇清单(港岛/九龙)"落地程度未知——设计文档有要求,实际 xlsx 待确认
OPS-Lite:线上获客 S01 + 口碑 S06 🟢 完整 OPS-S P0 优先级含 SCENE 01 和口碑六策略
OPS-Lite 物料子集(A/B/D/F 组) 🟢 完整 OPS-M 对应组物料齐备

4.4.3 MVP 就绪度判定

综合上述:🟢 MVP 可启动,2 项 P0 并行补齐

  • 不阻塞启动:5 大品类、4 大服务核心文档、L1~L8 完整流程、报价模型、口碑闭环、MDS 主数据基本架构——全部完整,四角协同闭环(R33/R34/R35/R40/R41/R42 全 MATCH),一线团队日均 2-3 单可继续沿用现有飞书多维表格 MVP。
  • 启动必须 P0 补齐
  • P0 #1 PMG 导航表版本号 → 否则 AI 每次查入口文档都会引用错版本
  • P0 #2 MVP 40 字段 vs CPT-F 183 字段映射表 → 否则 MVP 表格字段命名与 CPT 设计文档脱节,后续数据无法回流 QMD 校准

五、问题清单(12 项,按优先级排序)

P0(MVP 首周内必须完成)

# 问题 影响面 修复建议 预计工时
1 PMG 导航表 7 份文档版本号滞后 + 5 份 README 版本条目缺失 AI 协作入口、所有新人培训、交叉引用判断 重扫 27 节点+所有 README 真实版本号,整体替换 agents.md 导航表 2 区块 + 发布文档区 0.5 小时
2 MVP 40 字段 vs CPT-F 183 字段映射表缺失 CPT 数据录入一致性、QSV 反哺取数准确性、AI 生成 CPT 表单正确性 新建 docs/reviews/ 下一份「MVP 40字段映射表.md」:逐字段 MVP 字段名→CPT-F 子表.字段号→备注(合并/新增)→QMD 关联字段 2 小时

P1(启动后 2 周内补齐)

# 问题 修复建议
3 CPT-V Excel 缺少 md 文档化说明(10 Sheet 用途、验证用例、校验规则) 在 CPT-V md 文档中补充「10 Sheet 说明表」,将生成脚本 generate_cpt_v_excel.py 移入 scripts/ 统一管理
4 OPS-M 7 组物料 × OPS-S 6 场景的组合矩阵缺失(每个场景实际用哪几组哪几个物料) 在 OPS-M 末尾新增「§场景×物料组合对照表」:6 × 32 的 0/1 矩阵,标出每个场景必用/可选物料
5 TSMM 标签三层分类 → SCL/BPL/WPL/CPL 四库的实际标签清单未落地 新建 docs/reviews/「TSMM-四库标签映射表.md」:逐标签列出归属库、层级、采集时机(CPT-D 哪阶段)
6 QMD V2.1 / TSMM V1.1 / MDS README V1.2 等导航表小版本不匹配 归入 P0 #1 一并处理

P2(归档前优化,不影响主业务)

# 问题 修复建议
7 agents.md 中文锚点名在 MkDocs 站跳转失效 修正 anchor 为 slug 化格式,或在 PMG 加 TOC 生成规范
8 DLG-02~18 早期对话记录存在 ../术语表.md 等相对路径层级错配 可忽略(历史记录,MkDocs 会 warning 但不中断阅读),或批量重写 ../../ 前缀
9 docs/客户项目跟踪服务/generate_cpt_v_excel.py 脚本位置不符合规范 移入 scripts/,在 scripts/README.md 补条目
10 docs/技术文档/templates/_temp_mermaid/ 临时生成文件需清理,或移至发布/ 加入 .gitignore 排除 _temp_* 目录
11 PJM 修订记录表最后一行之后缺少 MVP 字段映射/PMG 导航表修复的版本占位 修复 P0 #1/#2 后同步追加 PJM 小版本号
12 GLY 中需补充 reviews/ 子目录说明、REV- 评审编号命名规则 GLY 下次小版本升级时加入「文档评审成果(reviews/)」条目

六、修复行动路线图

gantt
    title MVP文档问题修复甘特图(P0+P1 共 6 项)
    dateFormat YYYY-MM-DD
    axisFormat %m/%d
    section P0 首周必达
    P0#1 PMG导航表版本号更新         :crit, p01, 2026-08-06, 1d
    P0#2 MVP 40字段映射表             :crit, p02, 2026-08-07, 2d
    section P1 两周内补齐
    P1#3 CPT-V Excel文档化+脚本搬迁   :p13, after p02, 1d
    P1#4 场景×物料组合矩阵             :p14, after p02, 1d
    P1#5 TSMM→四库标签清单            :p15, after p14, 1d
    P1#6 小版本号统一归入P0#1          :done, p16, 2026-08-06, 1d
    section P2 下次归档前
    P2 6项打包处理                     :p2, after p15, 3d

七、MVP 启动建议

7.1 可以启动的 5 个依据

  1. 四角协同设计闭环完整:R33/R34/R35(MDS↔CPT↔QSV)和 R40/R41/R42(OPS↔CPT↔MDS)共 6 条主循环全部 MATCH,没有设计空白
  2. MVP 文档本身自洽:40 字段 / 15 字段 / MDS-Lite 3 份 xlsx 模板齐备,8 阶段操作手册详细程度足以让一线团队直接照着做
  3. 报价模型可冷启动:QMD V2.1 8 大类 32 项因子 + SCL 品类费率 + BPL 楼宇系数——即使没有真实数据反哺,也能给出可用报价;R21 反哺机制留好了入口
  4. 口碑壁垒链条完整:OPS-D 六策略 + 徽章激励 + CPT L8 NPS 触发图——是「服务→信任→推荐→新客户」这一战略闭环的直接落地
  5. TS 和 RACI 清晰:PJM §3 RACI 已对应到具体人名(曾/郭/司徒/成文/黄/洪),DLG-33 线下讨论的运营分工也已沉淀到 CPT-D L6 子流程

7.2 启动当天的 3 件事(建议)

  1. TL 司徒总:完成 P0 #1 PMG 导航表版本号修复(0.5 小时,听写可直接执行)
  2. OL 成文 + PO 郭总:启动 P0 #2 MVP 40 字段映射表(听写可出初稿,成文/郭总审 2 小时)
  3. SPO 曾总:在晨会上宣读本报告结论——「MVP 设计就绪,正式开工」,把 6 条 P0/P1 放到 MVP 首周看板

7.3 不建议现在做的事

  • ❌ 不要为了 P2 的锚点问题重写历史 DLG 记录(ROI 太低)
  • ❌ 不要在启动前试图把 183 字段 vs 40 字段的 143 个差数字段全部定义清楚(40 字段映射表就是 MVP 边界,剩下的 143 个是下一阶段演进的预留空间,不是 MVP 阻塞项)
  • ❌ 不要补 OPS 所有 6 场景物料后才启动(先用 P0 场景,物料随用随补)

八、本评审数据来源

来源 内容
PMG agents.md V7.5 R1~R43 关系清单、导航表版本号、文档树
30 份 DOC-* 文档头部 实际版本号基准
核心 10 关系原文 grep CPT-D §1.1/§1.3/§5.1、MDS-D §4.1/§4.2/§4.4、OPS-D §5.2/§7.2/§7.3、RQD-S/B/O 交叉引用
MVP 实施方案 V1.0 §3.2 40 字段清单(CPT-Lite)、15 字段(QSV-Lite)、MDS-Lite
OPS-M V1.0 7 组 32 项物料清单
WLG V5.0 / ARC V1.5 修订记录表尾部版本号确认

修订记录

版本 日期 评审人 修订内容
V1.0 2026-08-06 DT 创建:MVP 启动前三维核查(一致性 7.2 / 连续性 9.5 / 完整性 8.0 = 综合 8.2);问题清单 12 项(P0×2 / P1×4 / P2×6);就绪度判定 🟢 绿灯

本评审报告存放于 docs/reviews/ 目录,为后续所有评审、核查、检查、审计类成果的首个范本。