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
5.2 KiB
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、至少两个项目和三种职责：
- 文档树选择结构画布和传统阅读器。
- 选择专用规则与公司通用规则。
- 查看规则来源、版本和禁止回退说明。
- 生成预览并定位诊断到具体节点。
- 添加批注和修订，完成审阅与批准。
- 下载 Markdown、批准稿、留痕稿和完整包。
- 查看追溯网中的来源、规则、修订、审签和交付物。
- 无权限用户的页面与网络响应均无受限内容。
- 浅色、深色、窄屏、长文档和长文件名可用。
12. 性能和容量
记录而非预设通过：10/50/100/300 页等价内容，1/10/50 MB 图片集，100/1,000/5,000 节点，100/1,000 批注。分别测解析、编译、渲染、校验、保存和下载时间及峰值内存。容量阈值根据实测和产品要求另行评审，不用无证据数字放行。
13. 证据要求
每项通过断言绑定命令、完整对象 SHA、组件 pin、配置、输出和来源等级。SELF 本地记录不能冒充 CI/GATE；浏览器截图不能替代网络权限断言；能够打开 DOCX 不能替代格式保真或审签真实性。