Why: the plan's progress annex still described the pre-adjudication state (44 needs-review, U2-U6 pending); the authoritative record must reflect the 2026-10-14 landing: batch adjudication, publication flip (44/44 published), U5 product-loop wiring with pilot pass, U6 per-identity matrix (41 PASS + 2 EXPECTED_BLOCKED + 1 EXPECTED_LIMITED), and the owner-side exit items (deployment pilot, independent REPLAY, U4 originals) now blocked on the owner per the handoff checklist. Evidence: docs-only change in the Documents repo; all referenced RDM PRs (#377/#381/#383/#385/#387/#389/#391) carry green CI and merged state; pilot and matrix outputs are recorded in the RDM task cards and docs/records/dhf/. Impact: plan annex only; no code or asset change. Refs: RDM docs/records/dhf/package-review-decision-2026-10-14.md; RDM docs/records/dhf/u6-acceptance.md; u6-replay-handoff.md
29 KiB
title, type, date, artifact_contract, product_contract_source, origin, execution
| title | type | date | artifact_contract | product_contract_source | origin | execution |
|---|---|---|---|---|---|---|
| DHF 模板接入 RDM 文档生成管线 - Plan | feat | 2026-10-14 | ce-unified-plan/v1 | legacy-requirements | 2026-10-11-rdm-template-dialog-generation.md | code |
DHF 模板接入 RDM 文档生成管线 - Plan
批准与实施进展(2026-10-14 后续附注)
本节记录批准后的状态;下方 r0.1 主文保留批准前评审快照,原对象 SHA256 为 f99e1424a9bb86f68ad6de91657102a36004c61fb0f36c8427e913d9e0cf9643。主文中的“草案”“待批准”“本轮 NOT_RUN”指当时状态,不代表今日仍未获实施授权。
- owner 已批准 r0.1 的需求、方案和实施计划并授权 U1–U6 按阶段推进,另批准 E1-R1 隔离追加试验。U1 当前增量已走完阶段 6–10:阶段 6/7 获 owner 人工结论,独立 Review 闭合整改,最终 HEAD 的 GATE 与独立重放核验记录在案,三份交付 PR 均已合入。
- RDM 已封装 44 个逻辑原件,owner 分别接受项目建议书、F01、F02、DI 四份确切四哈希包(内容与版式接受,正式发布授权仍未给出);全部 44 项仍
needs-review,正式发布数 0。E1/E1-R1 使 14 DOC 均有转换候选,但逐项 Word 保真 NOT_PASSED;其余 40 项待包级裁定。F01/F02 的正式类型/存量字典升级及 U2–U6 真实产品流程仍未完成。 - U1 当前增量的终态以归档任务卡为准:Dev 仓
.task/archive/feature-dhf-template-pipeline-plan.md(随 Dev #542 归档合入)。合入记录:Documents #102 merge9062445db808、RDM #365 merge57d2214feb0a、Dev #540 merge11aa76a3bc1c,三个 main 树各自与受测 head 一致。U1 剩余 40 项包级裁定、14 DOC 保真对照、类型合同与 U2–U6 按本方案顺序继续;此前 WIP/待整改表述与旧 GATE 不再作为放行依据。 - 2026-10-14 收口(本轮):批量 1–5 包级裁定获 owner「全部按推荐」批复并落档(RDM
docs/records/dhf/package-review-decision-2026-10-14.md);其余 DOC 11 份(#377)与 DOCX 17 份(#381)四哈希候选包合入,44/44 具备候选包;owner 同轮授权 catalog 翻转,#383 将 44 项全部置published+confirmed+绑定四哈希+issues 全清。U5 交付命令接线与实例播种随 #385 落地,真实产品二进制全链路试点 PASS;U6 逐项验收矩阵随 #387 完成——44/44 入账=41 PASS+2 EXPECTED_BLOCKED(F01/F02 字典门禁,owner 裁定暂缓)+1 EXPECTED_LIMITED(无槽位确认报告,空填充 fail-closed 拒绝实测),0 FAIL;过程中修复 F05/F06 封面双层嵌套缺陷并补登记 11 个批量裁定 docType。卡片 #379/#382/#384/#386/#388/#390/#392 全部归档,RDM mainc5ea0f5。交接文档 u6-replay-handoff.md 固化 owner 侧三项动作:①部署发布包+三用户真实试点(回传导出 Word SHA256 与审签元数据);②独立审阅者以一键驱动scripts/dhf-u6-replay.sh完成 R1–R4 重放并签署(作者 SELF 试运行全绿,审阅者重跑方为 REPLAY);③提供带附件/页眉页脚的真实原件路径以启动 U4。独立 REPLAY 与真实环境试点完成前,本方案 DoD 的「试点交付/全量交付」两项维持 owner 阻塞态。
修订 r0.1;需求负责人 weichen;方案编制 Codex;各仓实施负责人待立项指定。
本文件是 DHF 接入专项的评审草案,授权终点为源码/资产调查、方案和计划文档、记忆归档。
需求取舍、设计、实施和测试计划仍须按 Dev policy/delivery.md 逐阶段评审;本文不授予业务实施、转换试验、迁移、发布或部署权限。
文件路径以目标仓为准:Dev: 为 Agent-System-Dev,RDM: 为 Agent-System-RDM,Frontend: 为 Agent-System-Frontend;无前缀为 Documents 仓。
Goal Capsule
用户能在 RDM 项目对话中,按提供的 DHF 标准模板编制文档,取得内容有依据、格式可核查、审签版本一致的 Word 文件。
采用现有 RDM 模板、两树一网、持久提案和三权流程,补齐 Word 资产解析、固定绑定和模板填充导出。
本批最终覆盖 Dev .templates/DHF 文件模板/ 全部 44 份逻辑资产;试点成功只代表试点完成。
首选下一步是评审范围及解析试验 E1;E1 的 DOC 保真结果是全量接入的前置条件。
Product Contract
Summary
将 44 份 Word 原件转为可审核发布的模板包,使其内容结构、填写规则和原始版式共同约束文档生成。 先用真实 DHF 项目建议书完成一条用户闭环,再按文档族接入全部资产;设计输入规格书和验证确认报告同时作为结构与示例语义的压力样本。 登录恢复为已收官基线;本专项不把部署增强或账户恢复重新列作遗留实现项。
Problem Frame
RDM 当前注册量不能代表标准模板可用量。 已有模板选择、章节实例化和导出器缺少共同的模板身份,新增 Word 文件后仍可能生成错误用途的正文,或者丢失原件的表格与排版。 模板中的示例测试结果和签署意见还可能被误当作本项目已经发生的事实。
Current State
本轮源码/资产观察为 SELF,业务测试、DOC 转换、真实模型、浏览器验收、CI 和部署均为 NOT_RUN。
调查对象:Dev R0 add097d06137c4912a4ed9279e98ca353e4e4cf1;RDM 6fcb256205c2384abed35d3b6ab96ca7216e9297;Documents 草案从本轮 SSH/API 同值的 main 7bd4e17827d4c7c88647bf3c9199c495b60cb107 建立。
RDM 正式产品的 Frontend gitlink 与实际检出均为 eb2d6d32f9323094d568bc9d80b4e5ed4f0af25b;该源码基线用于定位当前预览行为,不代表组合浏览器验收。
Dev 固定 Documents 的 a7ff466… 与本轮 Documents main 不同;本轮只保存规划,不推进 gitlink,未来集成须处理两条历史及规范差异。
源码/资产原始输出与完整 SHA 由 Dev 任务卡的 evidence 段记录;以下是静态分析,不是运行通过声明。
| 对象 | 当前事实 | 接入含义 |
|---|---|---|
| DHF 原件 | 44 份:30 DOCX、14 DOC,7 阶段;41 个不同 SHA256 | 同内容不同阶段仍保留独立逻辑用途 |
| RDM 目录 | 69 个 docType,73 项 registry:4 定制 Markdown+69 骨架 | 骨架含“内容要求待补”,不算 69 份标准正文已迁入 |
| Word 原件 | RDM 未跟踪 DOC/DOCX 原模板 | 需要可脱离 Dev 工作目录的正式资产包 |
| 现有解析 | DOCX 主要读 document.xml,DOC 不支持 | 不能用文本抽取代替完整内容和版式解析 |
| 模板选择 | Compose 按适用列表首项选 key;rd_proposal 首项为 weekly-report | 必须消除注册顺序决定正文用途 |
| 结构实例化 | 独立 structure YAML 建文档/章节,无公开的按模板实例化命令 | 模板发布、文档创建与生成入口需要接成一条路径 |
| 固定版本 | Doc/Section/Version 未存真实模板绑定;提交的 TemplateVersion 实为字典版本 | 当前快照无法证明 Word 模板身份不漂移 |
| 审签与提案 | 有事务采纳、幂等、持久提案及整文三权 | 扩展既有机制,不重写审批和项目权限 |
| DOCX 导出 | 新建最小 OOXML,不消费原件版式;未按指定整文审批轮次导出 | 需要原模板填充和批准快照再现 |
| 用户入口 | 自然语言写文档 intent 用错 docType 且仅查询模板;正式 Web 使用 Frontend pin | 真实对话、工具 schema 与正式 React 产品均需验证 |
资产阶段分布:商务 1、策划 3、设计输入 15、设计输出 9、设计验证 8、设计转换 3、设计确认 5。 四份输出/验证/转移/确认评审原件字节相同,但不能合并为一份逻辑模板。 候选适配为 32 份映射既有类型、12 份新增或细分用途待评审;不等同于批准新增 12 个类型。
Requirements
资产与内容约束:
| ID | 要求 | 可判定验收条件 | 来源 |
|---|---|---|---|
| R1 | 44 份原件逐份登记来源、用途、版本和状态 | 每个路径有完整 hash 和处置;重复内容保留逻辑用途;未验证项不可标可用 | 本轮范围;TT-T01/T04 |
| R2 | 保留真实多级结构、表格、填写规则与关键版式 | 对照每份原件无关键静默丢失;DOC 的解析/转换差异有人工裁定 | TT-T01/T02;现有模板方案 R3/R11 |
| R3 | 示例、说明、占位符与固定文本分别处理 | 无真实证据时不预填验证成功、样本量或签署;模板内产品示例不进入项目事实 | 原件填写说明;原方案 R6 |
| R4 | 模板用途和项目适用性明确 | 选择显式正文模板;计划/报告、验证/确认用途不混用;不适用部分注明理由 | TT-T03;原方案 R1/R3 |
生成与受控交付:
| ID | 要求 | 可判定验收条件 | 来源 |
|---|---|---|---|
| R5 | 新实例及历史内容固定实际模板身份 | templateId/version 与原件、结构、渲染包的完整 hash 可复核;升级不改旧版本 | TT-T04;原方案 R3/R9 |
| R6 | 用户能从项目对话创建或更新模板文档 | 真实认证总线到实例化、生成、提案、采纳;歧义先澄清;总结请求不触发写入 | 原方案 R2/R7/R13 |
| R7 | 生成和下载遵守现有项目、资源和文档职责 | 仅指定编制人生成/采纳;检索与模型输入授权;恢复、撤权及下载再次核验 | 原方案 R4/R9/R11 |
| R8 | 模板、正文、依据和审签使用同一冻结对象 | 旧卡片/并发/模板退役均不能覆盖新内容;正式导出读取指定批准快照 | 原方案 R5/R7/R8/R9/R11 |
| R9 | 完成状态以实际 Word 与用户流程验收为准 | 每个发布模板至少一个正常样例及一个空缺/冲突样例;44 份全部有结果 | 原方案 R12;TT-V01–03 |
Scope Boundaries
本专项承接在途 feature/rdm-two-trees-latest-templates 的 TT-T01–04,依赖其 TT-D01–04 的递归结构、结构提案和版本保护。
该任务已形成阶段 2 评估;本轮读取的记录仍待人工评审,不把其文字升级为实施批准。
两个任务只能有一处权威模板/内容块契约和一份 44 资产台账;实施立项前指定契约 owner,按共同 R0 分工,禁止各做一套树或升级机制。
原两树一网任务其余需求继续由其主记录维护,本专项的聚焦不削减那 28 项完整范围。
Deferred to Follow-Up Work
未提供新标准原件的其余 37 个既有类型保留兼容和明确状态;不以本批 44 份宣称覆盖全部 69 类型。
历史报价 XLSX 不在本批 Word 接入范围;全局项目字典扩展、默认成员工作上下文、完整审计展示继续归原两树专项。
-open-existing 修复和 U2/U3 部署增强保持独立新需求。
旧项目批量改绑、运行库迁移和上线需独立方案与授权,本轮不启动。
User Flow
用户在可信项目对话中提出“按 DHF 模板生成项目建议书”;系统确认目标文档、用途和已发布模板。 已有同类文档时展示更新目标;缺职责时等待负责人分配,由指定编制人接续。 模板不适用、资料不足或用途歧义时保留待处理状态,不能退回任意骨架继续生成。 生成任务使用已固定且有权使用的项目依据,返回逐块内容、来源、差异和缺项;编制人采纳后才形成内部版本。 审核和批准绑定整文快照;草稿与正式版可区分地预览/下载,正式 Word 从指定批准快照和固定模板包生成。
Planning Contract
Key Technical Decisions
KTD1. 将原件、结构合同、渲染包组成同一个不可变模板发布版本;登记阶段/用途、适用规则和来源谱系。 原件永久保存;DOC 转换产物是派生件,记录转换器版本/配置及产物 hash。 默认模板只能从人工确认的显式绑定取得;语义版本比较替代字符串最大值,骨架显示“待标准模板”,不得混成已发布 DHF。 共享模板/默认绑定治理沿用原模板方案 KTD1的获批仓库发布边界;本专项不开放运行时模板管理权限。
KTD2. Word 在资产准备阶段规范化为 DOCX,运行时不新增 LibreOffice 服务依赖。 先复用在途 E1 的隔离试验,验证 DOC→DOCX 的可行性与损失;不得直接把 DOC 二进制当字符串或重命名扩展名。 建议方法受官方格式与转换接口支持,但本批保真尚未验证:MS-DOC 格式、LibreOffice 转换参数、格式过滤器。 E1 先检验用户需求、软件测试用例、采购技术说明三种 DOC 样本,再覆盖全部 14 份;失败项保留未验证,不能降低 R2。 本轮 PATH 未找到 LibreOffice/soffice;固定工具版本、隔离环境和试验授权仍是前置条件。 E1 使用独立转换器 profile、只读原件和隔离临时输出,禁用宏、外部内容加载和网络;转换进程不得访问用户凭证或运行库。
KTD3. 结构合同采用原两树专项的递归内容块,模板只定义其约束和 Word 槽位映射。 块具有稳定 ID、层级、顺序、填写语义、字段/重复行/合并关系、依据需求、适用性和附件引用;显示标题不作为身份。 解析综合样式继承、outlineLvl、自动编号、正文顺序和表格关系,人工确认其业务含义。 蓝字、斜体、黑字只是分类线索;预填的 IQ/OQ/PQ 成功、样本量 22 和“同意”意见必须按 R3 处理。
KTD4. 扩展现有领域对象、事件 payload 和 replay,固定模板绑定及每次生成的内容/依据基线。 增加 RDM 领域的按模板实例化与生成编排入口;既有 compose/propose/adopt 适配到同一约束,不建立第二个提案或审批库。 实例化事务创建文档、内容块和模板绑定;确认/采纳使用预期版本、opId 幂等和事务内复验。 生成任务保存输入清单与候选,失败可恢复;恢复重新验证权限及模板可用性,缺少依赖时返回明确待处理结果。
KTD5. DOCX 采用固定原模板包的槽位填充渲染,结构化内容是业务正文权威。
保留原件的封面、页眉页脚、样式、编号、图片和非填充部件,确定性填充已标记的段落/单元格/重复行。
发布检查识别会自动读取外部内容的关系;派生渲染包禁止保留外链图片加载,普通引用链接保持可审查的文本/超链接语义。
本批《原材料进货检验规范》的图片同时有内嵌 rId11 和外链 rId12;派生包保留内嵌图片,移除 rId12 关系及对应 r:link,原件不变,处置进入差异台账。
只有外链而无可保全本地内容时阻止发布,不能静默删图或自动下载补齐。
原模板包不得直接把示例结论保留为实例结果;签署区域只映射真实审签元数据,不生成手写签名。
提交快照冻结真实模板 binding、内容块/章节版本、依据和渲染器版本;导出明确选择草稿或某一批准快照,不能读取各章当前最新版拼装。
批准 Word 首次生成后,字节、完整 hash、固定输入与精确批准快照持久关联,随批准历史保留;现有短期导出工件的 24 小时寿命不能作为该文件的保留策略。
采用 RDM 自有的受控导出产物仓储,复用现有文件/hash 完整性机制,下载权限使用 doc_export_visibility.go 的受控正文授权,区分短期导出和批准历史文件;下载链接可短期失效,批准文件不能因此删除。
批准后排队生成并保存该交付物,生成失败不回滚已批准的文档状态,文件状态保持待生成或失败;固定输入的幂等重试保存完整文件及关联后才可声明文件就绪。
同一快照再次取得文件返回原批准字节;首次生成或获准重建只能使用可执行的固定渲染版本,相关模板包/槽位映射缺失、原件 hash 不符或旧渲染路径不可执行时明确阻塞,禁止自动改用新版渲染器。
软件升级和例行清理必须保全批准文件及关联;结构化内容仍是业务权威,存档 Word 是对应快照的固定交付物。
现有仅含字典版本的历史快照不补造模板身份;继续按旧导出路径提供并标明历史格式,不能宣称新 DHF 保真。
KTD6. RDM 持有领域模板与生成/导出逻辑,Frontend 持有正式用户界面。
对话、工具及工作区消费同一服务端对象和状态;修正错误 intent 参数,并公开合法的模板绑定和提案 schema。
正式产品必须检验 Frontend 发布版本和 RDM pins 的组合;仅修改 RDM web/app.js 不算正式产品交付。
按 Dev DESIGN 复用三栏、卡片与唯一文件预览,界面消费令牌和已有原语;文档纸面保留原件自己的字体和颜色。
预览明确区分页式视图、版式降级的内容视图和无法读取;页式渲染失败时显示“版式预览不可用,当前仅展示内容”,保留同一 Word 文件的下载入口供核对,不把内容视图当作格式验收。
仅当已批准路径无法由公开扩展点实现时,向基座提交四要素扩展申请;禁止改 RDM pins 或导入 Backend internal。
High-Level Technical Design
以下图示规定权威和流向;具体类型名、函数及路径由实施时确定。
flowchart LR
O[44份只读原件] --> N[DOC规范化与差异核对]
N --> T[固定模板包: 原件/结构/槽位]
T --> I[可信项目与按模板实例化]
K[授权知识与原文版本] --> G[逐块生成和校验]
I --> G
G --> P[持久提案和差异]
P --> A[编制人采纳: 事务/CAS]
A --> S[整文提交/审核/批准快照]
T --> E[固定模板填充导出]
S --> E
E --> F[同一文件预览和下载]
stateDiagram-v2
[*] --> Imported
Imported --> NeedsReview: 结构/语义/版式待确认
NeedsReview --> Published: 资产评审通过
NeedsReview --> Blocked: 关键丢失或用途不明
Blocked --> NeedsReview: 有依据的修正
Published --> Retired: 受控退役
sequenceDiagram
actor A as 编制人
participant C as 对话/工具
participant R as RDM领域服务
participant D as 事务与事件库
participant E as Word导出
A->>C: 指定项目/目标/模板
C->>R: 可信主体与明确绑定
R->>D: 实例化及生成输入快照
R-->>A: 候选、差异、缺项与来源
A->>R: 采纳固定提案
R->>D: 权限/版本复验,原子提交
Note over R,D: 三权审签后冻结整文及真实模板
A->>R: 导出指定批准快照
R->>E: 固定内容与模板包
E-->>A: 经授权的文件预览/下载
Dependencies and Open Questions
实施启动阻塞项:本轮范围与取舍评审、在途两树任务契约 owner、44 份逐项阶段/type/用途映射、E1 授权与 DOC 保真结果、原件内容分类及导出槽位合同。 特别是 F02《验证确认报告》虽位于设计验证目录,正文是过程 IQ/OQ/PQ 确认,须由业务负责人裁定用途,不按目录自动映射。 导出关键版式以 R2 为底线;允许的字体替代和跨 Office 分页差异在 E1/样例评审中逐项确认,不承诺像素一致。 源模板中的企业信息、示例产品名和标识需人工分类为企业固定项或项目替换项;无人确认时保持待发布。 具体 helper 名称、序列化细节和测试夹具目录由实施者确定;不得用这些细节延后上述业务裁定。
Implementation Units
以下 U-ID 只属于本专项;均为待批准工作,不代表 E1 或任何业务实施已启动。
U1. Asset Contract and Conversion Proof
覆盖 R1–R4;先与 TT-T/TT-D 的 owner 固定共享契约与台账。
Files:RDM internal/rdmapp/templates/、templates.go、templates_embed.go;新增 docs/records/dhf/ 台账及 template_asset_contract_test.go(拟定);Dev 原件保持只读。
产物为 44 份完整谱系、用途/适用性映射、内容分类、保真差异台账和已评审结构/槽位规范。
先用项目建议书 DOCX 完成内容模型;设计输入规格书及 F02 报告校验多级结构与示例语义,复用 E1 覆盖全部 DOC。
验证场景:损坏/加密/不支持对象拒绝发布;重复 hash 不吞用途;混合标题/编号正确;黑字假结论不能成为项目结果;每个 DOC 关键差异有判定;外链图片处置后内嵌图完整且导出无自动外部内容读取。
出口:44 份处置明确,全部 14 DOC 方法可核验;未通过资产保持阻塞,不能进入全量发布。
U2. Published Template Binding and Instantiation
依赖 U1 共享契约;覆盖 R1/R4/R5/R8。
Files:RDM templates.go、structure.go、internal/domain/doctree.go、payloads.go、replay.go、plugins/rdm/plugin.go;新增 dhf_template_instance_test.go(拟定)。
增加发布模板包与明确默认用途,原子创建文档/块/真实模板 binding;内容块复用 TT-D,不按标题去重代替身份。
验证场景:v2/v10 选择、周报与建议书同 docType、缺包/hash 错误、退役、重复创建、跨项目、更名同名章、失败回滚及重启重放;模板升级不会覆盖旧实例。
出口:无 Dev 源码目录的构建制品可实例化试点模板;新对象与历史对象有明确兼容路径。
U3. Evidence-Based Generation and Confirmed Adoption
依赖 U2;覆盖 R3/R6–R8。
Files:RDM compose.go、draft.go、draftproposal.go、plugins/rdm/plugin.go;扩展 compose_test.go、draftproposal_test.go、plugins/rdm/intents_test.go。
修正 intent 和总线 schema;按块要求组织有权依据,结构化生成并校验,复用持久提案/事务采纳;同时落实 Compose 的指定编制人门禁。
验证场景:真实自然语言请求从正确模板到提案;无资料、示例黑字、适用条件冲突均诚实留缺;未分配职责、非编制人和私人未发布资料拒绝;并发采纳、重复点击、取消、断连/恢复及撤权结果可查且不重复生效。
出口:项目建议书有固定来源的完整候选和内部版本;无证据的测试/验证字段仍空缺或注明未执行。
U4. Approved Snapshot and Word Fidelity
依赖 U2/U3;覆盖 R2/R3/R5/R8/R9。
Files:RDM docsubmission.go、docx.go、doc_export_visibility.go、export_artifact.go、领域快照 payload/replay;扩展 docx_test.go、plugins/rdm/doc_submission_test.go;新增 dhf_docx_fidelity_test.go(拟定)。
冻结真实模板及渲染版本,补整文快照选择;实现原 OOXML 槽位填充、重复行和附件映射及批准 Word 持久关联,旧导出语义独立兼容。
验证场景:审核中改正文被拒、提交后模板更新/退役、批准后当前章变化、历史批准轮次重导出、槽位重复/缺失、长表格跨页、合并关系、编号、图片、页眉页脚、中文字体、非法 XML;无真实签署不填意见;下载撤权立即拒绝。
跨版本验收:旧版批准/导出→超过短期工件 TTL→升级并更换渲染实现→取得同一轮次 Word,字节 hash 与原批准文件一致;下载仍按当前权限判断。原批准文件损坏或丢失且固定渲染版本不可执行时明确阻塞,不生成外观相近的新文件冒充历史产物。
故障验收:生成失败不改变审批结论;写文件与关联记录部分失败不发布就绪文件,重启后可查并幂等恢复;文件下载采用正文职责权限,普通审计权不扩大文件读取范围。
出口:三用户完成试点审签,Word 内容/依据与批准快照相同,关键版式对照通过;ZIP 非空或可打开仅为辅助检查。
U5. Formal Product Path and Offline Package
依赖 U3/U4;覆盖 R6/R7/R9。
Files:RDM scripts/build-product.sh、scripts/pack-release.sh、templates_embed.go、templates_embed_test.go;Frontend src/previewsetup.ts、真实对话卡片/文件预览/API 与相关浏览器用例(其余路径实施前按当前发布版定位)。
统一包内模板路径、读取路径和 hash 校验;对话与辅助工作区复用同一任务/提案/快照,交付正式 Frontend 版本后由 RDM 正常消费。
验证场景:真实 auth-on 两项目三用户,关闭右栏完成编制,刷新/重启/撤权/旧卡片;脱离源码运行同一制品,资产缺失/摘要错误拒绝;原模板字体/颜色在预览保留;页式渲染失败明确降级,完全无法读取显示错误及下载入口;证明浏览器使用精确 Frontend SHA。
出口:项目建议书在正式产品完成全流程,固定组合 CI 与独立重放齐备;静态工作台或桩测试不能替代。
U6. Complete All DHF Families
依赖 U1–U5 试点通过;覆盖 R1–R9。 Files:RDM 模板包、registry、映射台账及每文档族的内容/Word 回归样例,复用 U1 的唯一资产台账。 顺序为策划/输入→输出→验证/确认→商务/转换及剩余评审;DOC 规范化与 DOCX 内容整理可在同一契约下并行,发布仍逐批评审。 每份模板至少运行一个有材料的完整样例和一个缺证据/冲突样例;报告类只使用实际提供的验证记录,不能生成执行记录。 出口:44 份逐资产结果齐全,声明可用者通过真实生成/采纳/审签/导出;未解决项显式保留,本目标不能标全量完成。
Verification Contract
验证在后续批准的阶段执行;本轮只能做原件/源码阅读和文档一致性检查。 实施期先补关键链路的行为测试,再扩展原有实现;正式验收遵循 Dev evidence、精确组件 SHA、CI GATE 与独立 REPLAY 门禁。
| 证据层 | 对象与方法 | 硬判据 |
|---|---|---|
| 资产 | 44 份路径、原件/派生/结构/渲染 hash、DOC 差异和业务分类 | 44/44 可追溯;原件不变;关键结构/语义/格式无静默丢失 |
| 领域 | RDM 模板/实例/提案/审签/事件重放测试 | 固定绑定、CAS/幂等、失败全回滚、历史再现,负向越权为零 |
| 真实总线 | 意图→schema→认证主体→实例化/生成/采纳/导出 | 用合法 docType/templateRef;工具暴露参数和处理器一致 |
| 模型行为 | 固定真实素材、原件和任务,人工审核正文与引用 | 不编造事实、样本量、执行记录、结论或签署;缺项明确 |
| Word | OOXML 核对+真实 Office/LibreOffice 打开+人工原件对照+升级后历史文件重取 | 内容/表格/合并/编号/图片/页眉页脚/关键样式与固定快照一致;批准历史文件不受短期 TTL 清理 |
| 正式浏览器 | 真实 auth-on 三用户两项目、对话/卡片/预览/下载、重启/撤权 | 完整用户流程,文件可读可下载,职责/私域隔离有效 |
| 安装制品 | 固定 RDM/Frontend/Backend pins 与模板包,源码外运行 | 无 cwd 依赖;读/打包路径同值;错包拒绝,不回退到骨架 |
RDM 的现有 make test、product build、模板/提案/审签测试用于回归;Frontend 使用相关浏览器测试;Dev 有 gitlink 改动时执行组合 make test 和 make build。
正式以各 PR 当前 HEAD 的必需 CI 为准;原件盘点 SELF、模型自评和历史绿色 CI不能代替当前验收。
生成耗时、费用和人工修订量先建立试点基线,再确认目标;本轮不编造工期或质量评分。
Definition of Done
规划交付:范围、源码基线、44 资产特点、技术决策、依赖、工作包、验证和阻塞项可审查;未批准及未执行阶段明确。 试点交付:真实 DHF 项目建议书在正式产品,经三用户完成生成/采纳/审签/按快照 Word 导出,精确组合证据齐备。 全量交付:U6 达到 44 份逐资产验收,原两树任务的共同契约和台账同步;试点或 registry 数量不能替代。 上线交付:另行确认实例、制品和迁移范围,按批准窗口部署并运行验收;本方案完成不等于上线。
Appendix
主要源码:RDM internal/rdmapp/templates.go、templates_gen.go、templates_embed.go、structure.go、parse.go、compose.go、draftproposal.go、docsubmission.go、docx.go、plugins/rdm/plugin.go、scripts/build-product.sh。
本轮资产证据索引:44 份原件的路径/hash/结构特征及源文件摘要;完整命令输出以 Dev 任务卡 evidence 为准。
上游来源:原模板生成方案、最终目标方案、两树一网方案及在途 feature/rdm-two-trees-latest-templates 阶段 1/2 记录;旧“四模板”盘点只作历史。
登录收官来源:Dev docs/svc-deploy/2026-10-13-login-recovery-contract.md 的最后一项为“完成”,PR #516 已合入;owner 于 2026-10-13 自行在浏览器确认通过,密码不经 Agent。本轮不重做该验收。