DTL L-20260825-08 RNV 纳入 MDS-D 七库总览 + 需求评审子目录建立 + PJM 记录
日志编号:L-20260825-08
日期:2026-08-25
撰写人:听写 DT
任务类型:主数据扩展 + 目录重组 + 制度记录
起止时间:2026-08-25 23:00 ~ 2026-08-25 23:45
一、任务概述
承接 L-20260825-07 的「下一步建议」第 2 项(RNV 纳入 MDS-D 七库总览),并响应用户新指令:将需求评审作为团队内部需求分析工作流程的关键环节,创建专用子目录、加前缀序号、在 PJM 中记录。
三项子任务:
1. RNV 纳入 MDS-D 七库总览:将 RNV V1.0 装修服务特征库正式纳入 MDS-D 主数据服务设计文档的七库总览,六库→七库。
2. 需求评审子目录建立:在 docs/需求分析/ 下创建 需求评审/ 子目录,将本轮输出的 EVAL V1.0 + CCRR V1.0 两份文档移动至该目录,文件名加 RAR-NN_ 前缀序号。
3. PJM 记录需求评审工作流程:在 PJM §5.6 跨文档一致性核查清单中新增需求评审工作流程说明 + 3 项检查项(#29/#30/#31)。
用户指令:「RNV 纳入 MDS-D 七库总览。另外,前面两轮的工作性质是团队内部需求分析工作流程的一个关键环节,今后还会持续进行这类需求分析修订,完善,请在"需求分析"目录下,创建专用的子目录,然后将本轮输出文档放到这个目录下,文件名也应该加上前缀序号。同时,这个要求在pjm中记录。」
二、输入产物
| # |
资料/文档 |
说明 |
| 1 |
RNV V1.0 装修服务特征库设计 |
L-07 交付,6 大分部 + 4 个装修专用复杂度维度 |
| 2 |
MDS-D V1.3 主数据服务设计 |
六库总览待扩展为七库 |
| 3 |
EVAL V1.0 单证流程评估报告 |
位于 docs/ 根目录,待移动至需求评审子目录 |
| 4 |
CCRR V1.0 单证交叉一致性审查报告 |
位于 docs/ 根目录,待移动至需求评审子目录 |
| 5 |
RQD-B V2.4 业务级需求 |
引用 EVAL/CCRR 路径需更新 |
| 6 |
PJM V3.6 项目管理文档 |
§5.6 跨文档一致性核查清单待新增需求评审工作流程 |
三、输出产物
| # |
产物 |
路径 |
变更摘要 |
| 1 |
MDS-D V1.4 |
docs/主数据服务/主数据服务设计.md |
六库→七库总览 + RenovationCatalog 实体 + RenovationFactor VO + SevenLibraryCRUDService + RenovationCatalogRepository |
| 2 |
需求评审子目录 |
docs/需求分析/需求评审/ |
新建子目录 + README.md V1.0 目录索引 |
| 3 |
RAR-01 EVAL V1.0 |
docs/需求分析/需求评审/RAR-01_单证流程评估报告.md |
从 docs/ 移动 + 加前缀序号 |
| 4 |
RAR-02 CCRR V1.0 |
docs/需求分析/需求评审/RAR-02_单证交叉一致性审查报告.md |
从 docs/ 移动 + 加前缀序号 + 关联文档路径更新 |
| 5 |
RQD-B V2.4(引用更新) |
docs/需求分析/业务级需求.md |
EVAL/CCRR 引用路径更新为新路径 |
| 6 |
RNV V1.0(引用更新) |
docs/主数据服务/装修服务特征库设计.md |
EVAL/CCRR 关联文档路径更新 |
| 7 |
PJM V3.7 |
docs/项目管理.md |
§5.6 新增需求评审工作流程说明 + #29/#30/#31 检查项 |
四、修改项明细
4.1 MDS-D V1.3→V1.4 修改项(10 项 · 已全部完成)
| # |
章节 |
修改内容 |
完成状态 |
| 1 |
文件头 |
版本 V1.3→V1.4 + V1.4 升级摘要 + 关联文档新增 RNV/EVAL/CCRR |
✅ |
| 2 |
§1.1 服务定位 |
六类→七类主体档案 |
✅ |
| 3 |
§1.2 核心概念 |
六库→七库 + 数据闭环新增 RNV 反哺 |
✅ |
| 4 |
§1.3 双重价值 |
六类→七类 + 装修复杂度维度校准 |
✅ |
| 5 |
§3.1 不变量 |
libraryCode 枚举增加 RNV + 标签版本递增含 RNV |
✅ |
| 6 |
§3.2 实体清单 |
6→7 新增 RenovationCatalog(rnvId + 6 大分部 + 4 复杂度维度 + 主材工料分离 + 多版本报价模板) |
✅ |
| 7 |
§3.3 VO 清单 |
8→9 新增 RenovationFactor VO |
✅ |
| 8 |
§3.4 领域服务 |
SixLibraryCRUDService→SevenLibraryCRUDService + SupplyAPIService 增加 RenovationFactor |
✅ |
| 9 |
§3.6 仓储 |
新增 RenovationCatalogRepository + 工厂 SixLibraryEntityFactory→SevenLibraryEntityFactory |
✅ |
| 10 |
§四 总览 |
六库总览→七库总览新增 RNV 行 + §5.1 职责新增装修工程分部维护 + §7.1 数据闭环图新增 RNV 节点 + §7.2 校准周期新增 RNV + §九 优先级新增 RNV P2 |
✅ |
4.2 需求评审子目录建立(4 项 · 已全部完成)
| # |
操作 |
路径 |
完成状态 |
| 1 |
新建子目录 |
docs/需求分析/需求评审/ |
✅ |
| 2 |
移动 EVAL V1.0 |
docs/单证流程评估报告.md → docs/需求分析/需求评审/RAR-01_单证流程评估报告.md |
✅ |
| 3 |
移动 CCRR V1.0 |
docs/单证交叉一致性审查报告.md → docs/需求分析/需求评审/RAR-02_单证交叉一致性审查报告.md |
✅ |
| 4 |
创建 README.md |
docs/需求分析/需求评审/README.md(目录索引 V1.0) |
✅ |
4.3 引用路径更新(4 个文件 · 已全部完成)
| # |
文件 |
修改内容 |
完成状态 |
| 1 |
RQD-B V2.4 业务级需求.md |
8 处 ../单证流程评估报告.md → 需求评审/RAR-01_单证流程评估报告.md + 6 处 ../单证交叉一致性审查报告.md → 需求评审/RAR-02_单证交叉一致性审查报告.md |
✅ |
| 2 |
RNV V1.0 装修服务特征库设计.md |
关联文档 EVAL/CCRR 路径更新为 ../需求分析/需求评审/RAR-0X_*.md |
✅ |
| 3 |
RAR-02 CCRR V1.0 |
关联文档 6 份设计文档路径更新为 ../../ + EVAL 引用改为同目录 RAR-01_*.md + 修复建议表路径更新 |
✅ |
| 4 |
L-07 DTL 日志 |
CCRR 路径更新为新路径 |
✅ |
4.4 PJM V3.6→V3.7 修改项(3 项 · 已全部完成)
| # |
章节 |
修改内容 |
完成状态 |
| 1 |
文件头 |
版本 V3.6→V3.7 + 最近更新日期→2026-08-25 + 关联文档新增 RAR 引用 |
✅ |
| 2 |
§5.6 需求评审工作流程说明 |
新增说明段:评审流程 + 归档目录 + 命名规范 RAR-NN_文档标题.md |
✅ |
| 3 |
§5.6 核查清单 |
新增 #29 需求评审归档目录建立 🟢 + #30 EVAL 评估闭环 🟢 + #31 CCRR 审查闭环 🟢(28→31 项) |
✅ |
五、关键决策记录
| 编号 |
决策 |
依据 |
影响 |
| D1 |
RNV 纳入 MDS-D 七库总览而非仅作为 SCL 子章节 |
RNV 独立成文档后有 6 大分部 + 4 专用复杂度维度,规模足够作为第七库 |
MDS 架构扩展 |
| D2 |
需求评审子目录命名为「需求评审」 |
体现"评审"动作而非静态"报告",强调持续进行的工作流程 |
目录语义清晰 |
| D3 |
前缀序号采用 RAR-NN_ 格式 |
RAR = Requirements Analysis Review(3-5 字符规范);NN 两位序号从 01 起递增 |
命名规范统一 |
| D4 |
RAR 目录下 README.md 作为目录索引(非主文档) |
遵循项目规则"目录下的 README.md 仅作为目录索引" |
目录结构规范 |
| D5 |
PJM §5.6 新增需求评审工作流程说明而非独立章节 |
评审与跨文档一致性核查同属 §5.6 范畴,避免章节膨胀 |
章节结构紧凑 |
| D6 |
CCRR 报告内部相对路径从 报价服务/ 改为 ../../报价服务/ |
文件从 docs/ 移至 docs/需求分析/需求评审/,深度增加 2 级 |
路径准确性 |
六、阻塞与解决
| 编号 |
阻塞 |
根因 |
解决方案 |
| B1 |
MDS-D 中"六库"提及散落在 10+ 处 |
V1.3 时六库概念贯穿全文 |
逐处修改为"七库",保留历史修订记录中的"六库"不动 |
| B2 |
CCRR 报告内部引用 EVAL 的路径 (单证流程评估报告.md) |
移动后同目录,需改为 (RAR-01_单证流程评估报告.md) |
Edit 更新 2 处同目录引用 |
| B3 |
RQD-B 文件 84KB 超过读取限制 |
V2.3/V2.4 内容量大 |
使用 rg 搜索定位 + replace_all 批量替换路径 |
| B4 |
PJM §5.6 #28 行无结尾 | |
表格行格式不规则 |
Edit 时 old_string 不含结尾 | |
七、跨文档联动关系(修改后)
MDS-D §四 七库总览 RNV ←→ RNV V1.0 装修服务特征库设计(主数据供给)
MDS-D §3.2 RenovationCatalog ←→ RNV §2 6 大分部目录(实体定义)
MDS-D §3.3 RenovationFactor VO ←→ RNV §3 4 个装修专用复杂度维度(VO 定义)
MDS-D §7.1 数据闭环图 ←→ CPT L6 装修实际工时 → RNV 复杂度维度校准(反哺链路)
PJM §5.6 需求评审工作流程 ←→ RAR 目录 README.md(工作流程定义)
PJM §5.6 #29/#30/#31 ←→ RAR-01 EVAL + RAR-02 CCRR(核查项追溯)
RQD-B §十一 21 项同步 ←→ RAR-01 EVAL + RAR-02 CCRR(需求编号追溯)
RNV 关联文档 ←→ RAR-01/RAR-02(双向引用)
八、三 AI 合规声明
- 听写 DT:仅修改 docs/ 目录下设计文档(MDS-D/RAR/RQD-B/RNV/PJM/L-07),未触及 dip1/ 代码、ocm/ 运维、Gitee 仓库、生产 ECS
- 听码 WDE:本次不涉及代码修改
- 听云 OCM:本次不涉及运维操作
- 日志即时性:任务完成后即时补写本日志,未延后
- 代码缺陷:本次为文档修改 + 目录重组,0 代码缺陷
- 规格偏差声明:无规格偏差
- 遗留 TODO:无
九、下一步建议(供决策 · 非自动执行)
| # |
建议 |
执行人 |
触发条件 |
| 1 |
PMG agents.md 文档导航表新增 RNV 装修服务特征库行 |
DT |
PMG 下次修订时 |
| 2 |
PMG agents.md 文档树新增 RNV 节点 + MDS 目录七库说明 |
DT |
PMG 下次修订时 |
| 3 |
GLY 术语表新增 RAR(Requirements Analysis Review)术语 |
DT |
GLY 下次修订时 |
| 4 |
TND-P 技术规划新增 RAR 目录与需求评审工作流程 |
DT |
TND 下次修订时 |
| 5 |
后续需求评审产生的评估/审查报告归档至 RAR 目录,序号从 RAR-03 起递增 |
DT |
下轮需求评审时 |
| 6 |
git 同步 hk2026 私有主仓 main 分支(备份用) |
DT |
用户明确指令 |
| 7 |
MkDocs 构建并部署到 Cloudflare Pages(Project=hk2026-docs) |
DT |
用户明确指令 |
本日志记录 RNV 纳入 MDS-D 七库总览 + 需求评审子目录建立 + PJM 记录需求评审工作流程的完整交付过程,依据 PMG V8.3 日志体系编写。