Why: Define the approved direction for one rule-driven Word renderer, all-template onboarding, human-readable traceability, and review-aware delivery before implementation starts. Evidence: SELF documentation checks passed for relative links, balanced code fences, JSON parsing, manifest SHA256 coverage, and git diff whitespace. Impact: Adds a 12-document review set and immutable review manifest; no runtime code, migration, deployment, or published rule changes. Refs: feature/rdm-two-trees-latest-templates
4.5 KiB
4.5 KiB
11 需求追踪与评审清单
1. 使用方式
本表把本轮用户要求映射到设计文档、实施任务和验收证据。评审通过表示同意需求和方案边界,不表示代码已实现、测试已通过或系统已部署。实施后只有附带命令、对象 SHA 和完整输出的证据才能把状态从 DESIGNED 更新为 IMPLEMENTED、VERIFIED 或 ACCEPTED。
2. 需求追踪矩阵
| ID | 用户结果要求 | 设计位置 | 实施任务 | 主要验收 | 当前状态 |
|---|---|---|---|---|---|
| RDR-01 | Markdown 作为权威源,可同时下载 Markdown 和 Word | 01 §2/5.2;02 §2.1 | 2、4、9、10 | 10 §3/11 | DESIGNED |
| RDR-02 | 一个渲染器按规则生成多种文档,不为每种文档复制代码 | 02 §1–2;03 | 2、3、5 | 10 §2/4 | DESIGNED |
| RDR-03 | 文档可选择专用规则,未指定时使用公司默认规则 | 01 §5.1;03 §3 | 3、7、9、11 | 10 §2/7/11 | DESIGNED |
| RDR-04 | 受控文档失配时阻止生成,不能静默套默认样式 | 01 §5.1;02 §6 | 3、8、9 | 10 §2/6 | DESIGNED |
| RDR-05 | 44 份现有模板全部接入并能正常生成 | 08 §1–4 | 1、8、13 | 10 §6 | DESIGNED |
| RDR-06 | 归纳公司页面、字体、标题、表格、页眉页脚和 Logo 规范 | 04 §2–4 | 1、7 | 10 §6–7 | DESIGNED;具体值待普查评审 |
| RDR-07 | 每份文档可配置渲染方式,规则版本化且无需改代码扩展 | 03 §2–10 | 3、7、8 | 10 §2 | DESIGNED |
| RDR-08 | Word 第一阶段完成,后续同架构扩展 PDF/PPT | 01 §3;02 §7 | 2、5;后续适配器 | 公共接口兼容测试 | DESIGNED;PDF/PPT NOT_RUN |
| RDR-09 | 用户上传参考文档后可分析生成候选规则 | 05 §8;07 §3;08 §6 | 12 | 候选生命周期与恶意输入测试 | CONTRACT_ONLY |
| RDR-10 | 支持修订模式、批注、回复和真实审签信息 | 06 | 6、9、11 | 10 §5/11 | DESIGNED |
| RDR-11 | 默认交付干净批准稿和审阅留痕稿 | 05 §5;06 §7 | 6、9 | 10 §5 | DESIGNED |
| RDR-12 | 渲染结果进入文档树、笔记树和追溯网 | 01 §1/5.3;02 §2.5;05 §2 | 2、4、9 | 10 §3/9/11 | DESIGNED |
| RDR-13 | 文档树支持结构画布和传统阅读器两种视图 | 09 Task 11 | 11 | 10 §11 | DESIGNED |
| RDR-14 | 页面展示来源、置信度、冲突、修改前后、影响、人物和时间 | 07 §6;09 Task 11 | 9、11 | 10 §8/11 | DESIGNED |
| RDR-15 | 追溯网和审计受权限保护,个人流程图/思维导图保持私域 | 07 §1/4/7 | 9、11 | 10 §8–9 | DESIGNED |
| RDR-16 | 规则、模板、资产和输出可重放且旧批准文件不被覆盖 | 02 §5;03 §10;05 §6 | 3、7–9 | 10 §2/10/13 | DESIGNED |
| RDR-17 | 规则与上传文件不能执行脚本、宏、外链或任意 XML | 03 §1;07 §2–3 | 3、5、12 | 10 §2/9 | DESIGNED |
3. 阶段评审点
A. 需求与范围
- 确认第一阶段以 DOCX 为唯一生产格式。
- 确认 44/44 全链通过是完成条件,两份字典阻塞不能作为例外保留。
- 确认上传参考文档只生成候选规则,本阶段只保留合同和安全边界。
B. 架构与模块边界
- 确认采用独立
Agent-Document-Renderer模块;或记录选择内嵌包的替代决定及独立化条件。 - 确认 RDM 负责权限、冻结、审签和追溯,渲染器不反查项目数据库。
- 确认 Backend 普通交付与 RDM 受控交付最终共用同一渲染合同。
C. 规则与公司设计
- 确认规则为声明式数据,发布后不可原地修改。
- 确认先完成 44 份视觉普查,再发布字体、字号、Logo、颜色等具体公司值。
- 确认专用模板例外优先,但必须登记证据和适用范围。
D. 审阅、权限和交付
- 确认批准稿与审阅留痕稿双 Word 默认交付。
- 确认审签身份只来自冻结的可信流程记录。
- 确认追溯网和审计仍按对象权限加审计权裁剪,个人解释图不进入项目共享面。
4. 实施放行条件
评审通过后,实施仍按项目交付策略分阶段启动。第一批只放行 Task 1–3:固定公司样式普查、统一模型和 RenderProfile 合同。第一批产物通过评审后再放行 Word 适配器与 44 模板迁移,避免在规则和模块边界未稳定时批量生成不可维护的配置。
每批实施必须记录:目标分支、基线 SHA、组件 pin、变更文件、测试命令、SELF/GATE/REPLAY 来源、未运行项、迁移与回滚边界。真实数据库迁移、部署和发布仍分别受各自门禁约束。