weichen
647da98577
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
3.8 KiB
3.8 KiB
统一文档渲染器方案文档集
日期：2026-10-15。状态：设计与实施计划待人工评审。范围：第一阶段只实现 Word；PPT、PDF 作为同一架构的后续格式适配器，不在本阶段实施。
目标
建立一个由声明式规则驱动的统一文档渲染平台。智能体和成员以 Markdown 及结构化元数据维护内容，系统按文档实例、文档类型、项目或公司默认规则选择渲染配置，输出可下载、可审阅、可批准、可追溯的 DOCX。新增文档类型通过发布新的规则包和受控资产完成，不需要为每种文档编写独立渲染器。
文档导航
| 文档 | 用途 |
|---|---|
| 01 需求与范围 | 产品目标、角色、范围、验收口径和非目标 |
| 02 总体架构与方案 | 统一文档模型、渲染内核、格式适配器及系统边界 |
| 03 渲染规则规范 | RenderProfile、规则选择、版本和声明式安全边界 |
| 04 公司 Word 设计规范 | 页面、字体、标题、表格、页眉页脚、Logo、编号和例外规则 |
| 05 生命周期与流程 | 起草、预览、审阅、批准、导出、升级及回滚流程 |
| 06 修订、批注与审签 | Word 审阅模式、批注、回复、修订与双 Word 交付 |
| 07 权限、安全与审计 | 私域、项目权限、资产安全、审计及防伪造要求 |
| 08 模板接入与迁移 | 44 份模板接入、字典门禁清零及未来上传模板生成规则 |
| 09 实施计划 | 可执行的分阶段任务、接口、文件、测试和提交边界 |
| 10 测试与验收计划 | 单元、保真、迁移、浏览器、权限及全模板验收矩阵 |
| 11 需求追踪与评审清单 | 用户要求、设计、实施任务、验收证据和待评审决策的逐项对应 |
document-manifest.json 固定本次评审文档的文件名、大小和 SHA256。评审意见导致任一正文变化时，必须重新生成清单，旧清单不得继续作为相同评审对象。
当前事实基线
- DHF 目录登记 44 份已发布模板，其中 30 份原生 DOCX、14 份旧 DOC 的受控转换链。
- 41/44 含页眉或页脚部件。
- 40 份存在文件名称、文件号、版本等控制字段；现已登记 78 个页眉/页脚槽位。
- 企业机密声明及 PAGE/NUMPAGES 域属于固定内容，不是项目可填写槽位。
- 当前逐项产品链为 42 PASS、2 EXPECTED_BLOCKED、0 FAIL；两份阻塞来自字典登记/迁移边界，第一阶段必须清零后才能声明 44/44 可生成。
- 当前 RDM 已有冻结模板槽位填充能力，Backend 已有独立
house-styleMarkdown→DOCX 工具；两者尚未共享统一文档模型和 RenderProfile 合同。
以上为当前工作分支源码和既有 SELF 记录中的事实基线，不代表部署环境验收或 CI/GATE 结论。44 份视觉共性仍须按 04 公司 Word 设计规范执行逐模板普查。
统一原则
- Markdown 是可编辑的权威内容源，DOCX 是由确切规则版本生成的交付物。
- 一个渲染内核消费多个规则包；不得为每个文档类型复制渲染器代码。
- 受控文档指定规则失配时阻止生成，不静默回退公司默认规则。
- 发布规则不可原地修改；新规则生成新版本，旧文档继续绑定旧版本。
- 审核、批准、签署和批注作者只能来自系统可信身份及真实流程。
- 原件、规则、Markdown、输出文件和清单均保留哈希与追溯关系。