DTL L-20260825-07 6 份文档交叉一致性审查 + RNV 装修服务特征库设计 + 21 项修改同步 RQD-B
日志编号:L-20260825-07
日期:2026-08-25
撰写人:听写 DT
任务类型:交叉一致性审查 + 主数据子库设计 + 需求同步
起止时间:2026-08-25 21:30 ~ 2026-08-25 23:00
一、任务概述
承接 L-20260825-06 的「下一步建议」三项工作,本日志记录:
- 6 份设计文档交叉一致性审查:对 EVAL 21 项修改后的 QMD V3.2 / SCL V1.1 / BPL V1.1 / CPT-F V1.1 / DIS-D V1.2 / CPT-D V2.6 进行 8 条核心联动关系审查,识别 14 个问题(P0 阻塞 1 + P1 改进 9 + P2 优化 4)。
- P0 阻塞 + P1 改进修复:完成 F-R5-1 P0 阻塞(BPL-303 与 DIS upper_floor_mode 值域统一)+ 9 项 P1 改进修复。
- RNV 装修服务特征库独立设计:基于 SCL CAT-09 装修工程独立成文档,作为 MDS 主数据服务第七库。
- 21 项修改条目同步到 RQD-B:在业务级需求文档新增 §十一 章节,按 QSV/CPT/MDS/DIS/CPT-D 五个服务域归类 21 项修改条目。
用户指令:「6 份文档交叉一致性审查(如 QMD 阶梯计价 ↔ SCL U-POS ↔ CPT-F 双计量)」「为 SCL CAT-09 装修工程单独设计 RNV 装修服务特征库」「将 21 项修改条目同步到 RQD-B 业务级需求」
二、输入产物
| # |
资料/文档 |
说明 |
| 1 |
QMD V3.2 |
已完成 EVAL 5 项修改(双币种/体积重/阶梯计价/多版本/P10 扩展) |
| 2 |
SCL V1.1 |
已完成 EVAL 4 项修改(品类 15 类/计价单位 15 种/复杂度 8 维度/CAT-09/去重) |
| 3 |
BPL V1.1 |
已完成 EVAL 2 项修改(特殊楼宇约束+楼梯台阶+上楼方式判定) |
| 4 |
CPT-F V1.1 |
已完成 EVAL 4 项修改(双计量/主材分离/图纸/盖章签署) |
| 5 |
DIS-D V1.2 |
已完成 EVAL 3 项修改(区域分档/上楼方式/等候超时) |
| 6 |
CPT-D V2.6 |
已完成 EVAL 5 项修改(异常分支 20→25 类) |
| 7 |
EVAL V1.0 评估报告 |
21 项修改建议清单 + §七 跨文档联动关系图 8 条联动线 |
| 8 |
DOC-H13/H14 元朗别墅案例 |
6 大分部工程 / 151 行内部成本版 / 4 页客户对外版 / 总价差 45 万 HKD |
三、输出产物
| # |
产物 |
路径 |
变更摘要 |
| 1 |
CCRR V1.0 交叉一致性审查报告 |
docs/需求分析/需求评审/RAR-02_单证交叉一致性审查报告.md |
8 条联动关系 × 14 个问题(P0 1 + P1 9 + P2 4)+ 修复清单 |
| 2 |
RNV V1.0 装修服务特征库设计 |
docs/主数据服务/装修服务特征库设计.md |
6 大分部 + 4 个装修专用复杂度维度 + 主材工料分离 + 多版本报价模板 |
| 3 |
RQD-B V2.4 业务级需求 |
docs/需求分析/业务级需求.md |
新增 §十一 21 项修改条目同步章节(11.1~11.8) |
| 4 |
QMD V3.3 |
docs/报价服务/报价模型设计.md |
F-R2-1 tier_type 增加 volume / F-R2b PDF 模板限价 3500→4300 |
| 5 |
SCL V1.2 |
docs/主数据服务/安装服务特征库设计.md |
F-R2-2 新增 U-VOL / F-R3-1 CD-WGT 备注区分 / F-R3-2 CD-SIZE 增加议价 |
| 6 |
BPL V1.2 |
docs/主数据服务/楼宇特征库设计.md |
F-R5-1 BPL-303 增加 no_upper_floor 枚举 |
| 7 |
CPT-F V1.2 |
docs/客户项目跟踪服务/现场工作登记表.md |
F-R1-2 L5-DLV 新增币种+汇率字段 / F-R4-1 L4-ORD-015 校验规则 |
| 8 |
DIS-D V1.3 |
docs/派单服务/派单服务设计.md |
F-R5-1 upper_floor_mode 增加 mixed + calculate_mixed_fee 函数 |
| 9 |
CPT-D V2.7 |
docs/客户项目跟踪服务/客户项目跟踪服务设计.md |
异常分支 6.1/6.2/6.3/8.1 补充 trigger_condition + 事件编码 |
四、修改项明细
4.1 CCRR 交叉一致性问题(14 项 · 已全部修复)
| 编号 |
联动关系 |
问题级别 |
修复编号 |
完成状态 |
| R1-1 |
QMD 双币种 ↔ CPT-F 双计量(描述错位) |
P1 |
F-R1-1 |
✅ |
| R1-2 |
CPT-F 缺币种字段 |
P1 |
F-R1-2 |
✅ |
| R2-1 |
QMD tier_type 缺 volume |
P1 |
F-R2-1 |
✅ |
| R2-2 |
SCL 缺 U-VOL 单位 |
P1 |
F-R2-2 |
✅ |
| R3-1 |
SCL CD-WGT 分档值与议价阈值混淆 |
P1 |
F-R3-1 |
✅ |
| R3-2 |
SCL CD-SIZE 缺议价档位 |
P1 |
F-R3-2 |
✅ |
| R4-1 |
CPT-F L4-ORD-015 缺校验规则 |
P2 |
F-R4-1 |
✅ |
| R5-1 |
BPL-303 与 DIS upper_floor_mode 值域不对齐 |
P0 |
F-R5-1 |
✅ |
| R5-2 |
DIS upper_floor_mode 缺 mixed |
P1 |
F-R5-1 |
✅ |
| R5-3 |
DIS 缺字段映射表 |
P1 |
F-R5-2 |
✅ |
| R6-1 |
DIS 等候超时与 CPT-D 6.2 触发条件未字段化 |
P1 |
F-R6-1 |
✅ |
| R7-1 |
CPT-F L4-ORD-014 与 CPT-D 8.1 联动描述模糊 |
P2 |
F-R7-1 |
✅ |
| R8-1 |
CPT-F L2-SIT-016 与 CPT-D 6.3 图纸不详阈值未对齐 |
P1 |
F-R8-1 |
✅ |
| 附加-1 |
QMD §14.3 PDF 模板限价与实际不符 |
P1 |
F-R2b |
✅ |
| 附加-2 |
QMD §四品类费率未引用 SCL 计价单位 |
P1 |
F-R2c |
✅ |
4.2 RNV 装修服务特征库设计要点
| 模块 |
内容 |
对齐文档 |
| 6 大分部目录 |
RNV-01 拆除 / RNV-02 新建 / RNV-03 水电 / RNV-04 楼梯 / RNV-05 安装 / RNV-06 其他 |
DOC-H13/H14 元朗别墅案例 |
| 4 个装修专用复杂度维度 |
CD-DEMO 拆除难度 / CD-BLDR 新建结构 / CD-HIDE 水电隐蔽 / CD-STAIR 楼梯形式 |
SCL §3.4 复杂度 8 维度扩展 |
| 主材工料分离 |
主材费(U-MATL)+ 工时费(U-HOUR)独立计价 |
CPT-F L2-PRD-016~018 |
| 多版本报价模板 |
内部成本版 / 客户对外版 / 议价版 |
QMD §17 QuoteVersion |
| 阶梯计价 |
批灰刷漆 ≤100呎/100-500呎/>500呎 阶梯 |
QMD §16 TieredPricing |
| 图纸估价流程 |
图纸不完备 → 人工估价 → 二次报价 |
CPT-D 异常分支 6.3 |
4.3 RQD-B 21 项修改条目同步汇总
| 服务域 |
同步数量 |
需求编号 |
状态 |
| QSV 报价服务 |
5 项 |
QSV-09 升级 + QSV-11~14 新增 |
✅ |
| CPT 客户跟踪 |
4 项 |
CPT-15~18 新增 |
✅ |
| MDS 主数据 |
6 项 |
MDS-16~21 新增 |
✅ |
| DIS 派单服务 |
3 项 |
LGP-11~13 新增 |
✅ |
| CPT-D 异常分支 |
5 项 |
CPT-05 升级 + CPT-19 新增 |
✅ |
| 合计 |
21/21 = 100% |
— |
✅ |
五、关键决策记录
| 编号 |
决策 |
依据 |
影响 |
| D1 |
CCRR 审查范围限定为 EVAL §七 8 条联动关系 + 2 项附加(QMD §四/§14.3) |
8 条联动覆盖核心跨文档关系 |
审查聚焦不发散 |
| D2 |
P0 阻塞 F-R5-1 修复方案:BPL-303 与 DIS upper_floor_mode 值域统一为 4 值(elevator/stairs/mixed/no_upper_floor) |
原值域 3 值 vs 3 值不完全对齐 |
上楼方式决策逻辑完整 |
| D3 |
DIS 新增 calculate_mixed_fee 函数处理 mixed 场景(低楼层 stairs + 高楼层 elevator) |
mixed 场景原无计费逻辑 |
计费闭环不中断 |
| D4 |
RNV 独立成文档而非 SCL 子章节 |
装修工程 6 大分部 + 4 专用复杂度维度规模足够独立 |
MDS 六库扩展为七库 |
| D5 |
RNV「安装工程」分部引用 SCL 主体而非重复定义 |
避免数据冗余 |
主数据一致性 |
| D6 |
RQD-B §十一 按服务域归类 21 项修改条目 |
需求编号体系按服务域组织 |
需求与设计双向可追溯 |
| D7 |
RQD-B 版本号 V2.2 → V2.4(跳过 V2.3 MSC-FE 前端设计) |
V2.3 已由前序日志 L-20260825-01~05 完成 |
版本号连续 |
六、阻塞与解决
| 编号 |
阻塞 |
根因 |
解决方案 |
| B1 |
CCRR §三 R5 审查时 BPL-303 与 DIS upper_floor_mode 值域不对齐 |
BPL V1.1 值域 elevator/stairs/no_upper_floor,DIS V1.2 值域 elevator/stairs/mixed,缺对方枚举 |
F-R5-1 统一为 4 值,BPL 增加 mixed,DIS 增加 no_upper_floor |
| B2 |
RQD-B 文件 84KB 超过读取限制 |
V2.3 §十 MSC-FE 章节内容量大 |
使用 rg 搜索定位 §十一 章节,Read 带 offset/limit 分段读取 |
| B3 |
RQD-B 文件头版本号 V2.2 与 §十一 章节标记 V2.4 不一致 |
§十一 添加时未同步文件头版本号 |
Edit 更新文件头 V2.2 → V2.4 + 添加 V2.4 修订记录 |
七、跨文档联动关系(修复后)
QMD §2.1 双币种 ←→ CPT-F L5-DLV-010/011 币种+汇率快照(F-R1-2 新增)
QMD §16 TieredPricing.volume ←→ SCL §5.1.1 U-VOL(F-R2-1/2 新增)
QMD P10-F07 议价触发 ←→ SCL CD-WGT 议价阈值 ←→ CPT-D 6.1 议价触发异常(F-R3-1/2 明确)
QMD §17 QuoteVersion ←→ CPT-F L4-ORD-015 客户确认报价版本(F-R4-1 校验规则)
BPL §3.4 BPL-303 ←→ DIS upper_floor_mode ←→ QMD P3 上楼费跳过(F-R5-1 4 值统一)
DIS §6.3.5 等候超时 ←→ CPT-D 6.2 拒收+等候超时异常(F-R6-1 字段化)
CPT-F L4-ORD-014 盖章回传 ←→ CPT-D 8.1 盖章回传未完成异常(F-R7-1 描述明确)
CPT-F L2-SIT-016 图纸完备性 ←→ CPT-D 6.3 图纸不详估价异常(F-R8-1 阈值对齐)
RNV 6 大分部 ←→ DOC-H13/H14 元朗别墅案例(独立设计)
RNV CD-DEMO/CD-BLDR/CD-HIDE/CD-STAIR ←→ SCL §3.4 复杂度 8 维度(扩展)
RNV 主材工料分离 ←→ CPT-F L2-PRD-016~018(对齐)
RNV 多版本报价 ←→ QMD §17 QuoteVersion(对齐)
八、三 AI 合规声明
- 听写 DT:仅修改 docs/ 目录下设计文档(CCRR/RNV/RQD-B/QMD/SCL/BPL/CPT-F/DIS-D/CPT-D),未触及 dip1/ 代码、ocm/ 运维、Gitee 仓库、生产 ECS
- 听码 WDE:本次不涉及代码修改
- 听云 OCM:本次不涉及运维操作
- 日志即时性:任务完成后即时补写本日志,未延后
- 代码缺陷:本次为文档修改,0 代码缺陷
- 规格偏差声明:无规格偏差
- 遗留 TODO:无
九、下一步建议(供决策 · 非自动执行)
| # |
建议 |
执行人 |
触发条件 |
| 1 |
对 CCRR 修复后的 6 份文档进行二次交叉一致性验证(可选) |
DT |
用户指令 |
| 2 |
将 RNV V1.0 装修服务特征库纳入 MDS-D V1.1 主数据服务设计文档的七库总览 |
DT |
MDS-D 下次修订时 |
| 3 |
补充 H13 元朗别墅 151 行装修工程数据到 RNV 初始化脚本 |
WDE |
后端开发启动时 |
| 4 |
评估 RNV 是否需要独立的 CPT 装修工程跟踪子流程(区别于标准 8 阶段) |
DT + BO |
用户决策 |
| 5 |
git 同步 hk2026 私有主仓 main 分支(备份用) |
DT |
用户明确指令 |
| 6 |
MkDocs 构建并部署到 Cloudflare Pages(Project=hk2026-docs) |
DT |
用户明确指令 |
本日志记录 6 份文档交叉一致性审查 + RNV 装修服务特征库设计 + 21 项修改同步 RQD-B 的完整交付过程,依据 PMG V8.3 日志体系编写。