Files
Agent-System-Documents/docs/records/2026-10-15-unified-document-renderer/10-test-and-acceptance-plan.md
T

5.2 KiB

10 测试与验收计划

1. 验收层级

层级 目的
Schema 规则、模型、清单和迁移的确定性及兼容性
Renderer unit Markdown 节点到 Word 原语的正确映射
DOCX integrity OPC、XML、关系、样式、字段、锚点、批注和修订
RDM integration 权限、冻结提交、审签、交付物和追溯原子性
Template fidelity 44 份模板逐份内容与格式对照
Browser 规则选择、预览、审阅、下载和错误体验
Security/privacy 恶意规则、恶意 DOCX、撤权和私域泄露
Recovery SQLite/PG 重启、并发、失败和迁移回滚

2. RenderProfile 测试

  • 未知字段、schema、primitive 或 capability 拒绝。
  • 脚本、宏、任意 XML、外链、绝对路径和父目录拒绝。
  • 资产缺失、哈希失配和重复锚点拒绝。
  • 受控文档 allowDefaultFallback=true 拒绝发布。
  • 继承展开后快照确定,父规则修改不改变已发布子规则。
  • 同 ID/版本不同字节冲突,同字节重放幂等。

3. Markdown 与统一模型

  • 标题、段落、列表、表格、图片、引用、警示和签署节点。
  • 稳定 ID、重复 ID、深度/节点数/文本长度上限。
  • 无效 UTF-8、HTML、危险链接和未知指令。
  • 来源范围、置信度、冲突和权限标签保留。
  • 修改 Markdown 后节点身份和批注锚点保持或明确漂移。

4. Word 基础能力

  • 页面、分节、方向、页边距和分页。
  • 语义样式、标题编号、目录和列表。
  • 表格列宽、合并、重复表头、重复行和跨页。
  • 图片、题注、Logo 和替代说明。
  • 页眉、页脚、PAGE/NUMPAGES、文件控制字段。
  • 节点书签/内容控件及反向映射。
  • 生成后 ZIP/OPC/XML/关系/回读和哈希验证。

5. 审阅与批准

  • 插入、删除、替换和移动修订。
  • 批注范围、回复、解决、拒绝和孤立批注。
  • Word 作者、时间与系统快照一致。
  • 审阅稿接受全部修订后的正文等于批准稿。
  • 批准稿不含普通批注、未接受修订或私人来源。
  • 无真实审核/批准记录时阻止批准稿。
  • 相同冻结提交重试返回同一交付物。

6. 44 份模板矩阵

每份模板至少包含:

  • 一个完整正常样例。
  • 一个缺必填字段样例。
  • 一个超长或多行内容样例。
  • 一个表格/重复块样例(适用时)。
  • 页眉页脚和文件控制字段检查。
  • Logo/图片/形状检查(适用时)。
  • 原件、规范化件、规则、输出和回读哈希。
  • 人工视觉结论及例外说明。

总门槛:44 PASS、0 EXPECTED_BLOCKED、0 LIMITED、0 FAIL。

7. 公司通用规则

使用会议纪要、分析报告、技术说明、周报和无专用类型的自由报告验证。检查长标题、中文/英文混排、多页表格、图片、目录、页眉页脚和下载清单。

8. 权限矩阵

  • 项目创建者、普通成员、编制人、审阅人、批准人、管理员。
  • doc.read/write/publish、review.participate、project.settings、audit.read 交叉。
  • 私人来源、共享项目事实、受控正文和批注分别裁剪。
  • 撤权发生在解析前、渲染中、提交前和下载前。
  • 另一个项目或成员不能通过 ID、缓存、历史 URL、审阅稿或 DOCX 隐藏内容读取数据。

9. 安全矩阵

  • 带宏、ActiveX、OLE、外链和远程模板的 DOCX。
  • ZIP bomb、重复名称、路径穿越、超大图片和深 XML。
  • 规则中的脚本、任意 OOXML、远程资产和表达式注入。
  • Markdown 中的 HTML、危险 URI 和超限结构。
  • 输出 DOCX 不含宏、外部关系、无权自定义属性或隐藏文本。

10. 数据库与恢复

SQLite 与隔离 PostgreSQL 均覆盖:

  • 规则注册、发布、退役和选择。
  • 内容/规则/审签冻结。
  • 渲染成功、失败、超时和取消。
  • 同键重试、异参冲突和两实例竞争。
  • 生成中撤权和规则退役。
  • 迁移中断、回滚、备份恢复和旧二进制拒绝。
  • 批准字节在重启和规则升级后不变。

11. 浏览器验收

真实产品、auth-on、至少两个项目和三种职责:

  1. 文档树选择结构画布和传统阅读器。
  2. 选择专用规则与公司通用规则。
  3. 查看规则来源、版本和禁止回退说明。
  4. 生成预览并定位诊断到具体节点。
  5. 添加批注和修订,完成审阅与批准。
  6. 下载 Markdown、批准稿、留痕稿和完整包。
  7. 查看追溯网中的来源、规则、修订、审签和交付物。
  8. 无权限用户的页面与网络响应均无受限内容。
  9. 浅色、深色、窄屏、长文档和长文件名可用。

12. 性能和容量

记录而非预设通过:10/50/100/300 页等价内容,1/10/50 MB 图片集,100/1,000/5,000 节点,100/1,000 批注。分别测解析、编译、渲染、校验、保存和下载时间及峰值内存。容量阈值根据实测和产品要求另行评审,不用无证据数字放行。

13. 证据要求

每项通过断言绑定命令、完整对象 SHA、组件 pin、配置、输出和来源等级。SELF 本地记录不能冒充 CI/GATE;浏览器截图不能替代网络权限断言;能够打开 DOCX 不能替代格式保真或审签真实性。