S1000D 符合性审查与项目验收:质量检查、证据链和抽样方案
S1000D 项目验收不是一次 XML 格式检查,而是对标准基线、业务规则、数据模块内容、引用媒体、适用性、出版物结构、交付环境和过程记录的综合确认。合格结论需要能回答:检查依据是什么、检查了哪些对象、发现的问题如何关闭、交付结果能否重现。
符合性审查检查什么?
符合性是相对于已批准的 S1000D Issue、Schema、Data Dictionary、BREX、项目业务规则、合同和交付基线而言的。审查方案应在项目开始或阶段启动时明确版本、范围、判定标准和责任人,避免在交付前临时改变“什么算合格”。
| 审查层次 | 主要问题 | 典型方法 | 输出证据 |
|---|---|---|---|
| 基线与配置 | 被审对象使用的 Issue、Schema、代码表和 BREX 是否正确? | 核对版本、校验配置、基线清单和权限。 | 基线清单、配置快照、版本记录。 |
| 结构与取值 | 数据模块能否按 Schema 解析,字段和代码值是否有效? | Schema、数据字典、代码表和自动校验。 | 校验日志、错误明细、重测结果。 |
| 业务规则 | 是否满足 BREX、项目规则、DMC/SNS 和模块类型约束? | 规则校验、负面样例、人工复核。 | 规则报告、豁免批准、抽样记录。 |
| 内容与安全 | 技术步骤、安全信息、警告、限制和验收内容是否正确、完整、可执行? | 专业评审、现场或台架验证、任务走查。 | 评审表、试操作记录、问题闭环。 |
| 引用与媒体 | DMRef、图形、视频、3D、热点和外部资源是否存在、版本匹配、显示正确? | 链接扫描、媒体清单、端到端阅读。 | 引用报告、媒体校验、截图或运行记录。 |
| 适用性与出版物 | 型号、构型、批次筛选后内容是否正确,PM 目录是否完整? | 真值组合、边界配置、PDF/IETP 生成测试。 | 配置样例、生成包、差异报告。 |
| 交付与运行 | 交付格式、离线环境、权限、搜索、安装和升级是否满足合同? | 目标环境验证、用户验收、恢复测试。 | 环境记录、验收签字、发布包校验值。 |
从需求到交付的证据链
验收报告最有价值的部分不是一个总分,而是能从合同或任务需求追到最终交付模块,再从模块反向追到规则、审核和发布记录。建议为每个关键需求建立稳定标识,避免用文件名或人工备注作为唯一依据。
| 证据链环节 | 应回答的问题 | 可留存的证据 |
|---|---|---|
| 需求与范围 | 为什么要编这个模块或出版物?服务哪个读者任务? | 合同条款、任务分析、DMRL、范围基线。 |
| 身份与配置 | 模块属于哪个型号、SNS、DMC、类型和适用性? | DMC/SNS 表、适用性模型、代码表、配置清单。 |
| 编制与规则 | 使用了哪个 Schema、Data Dictionary、BREX 和模板? | 规则版本、编辑记录、Schema 校验日志、模板版本。 |
| 审核与整改 | 谁检查了什么,问题如何处理,是否做了影响分析? | 技术/语言/配置评审表、不符合项单、修订差异、豁免。 |
| 发布与验收 | 最终包是否包含正确模块、媒体、目录和配置? | PM、发布日志、包清单、校验值、运行截图和批准记录。 |
需求 ID → DMRL 条目 → DMC / SNS → 数据模块版本
→ Schema / BREX 校验 → 人工评审 → PM / 适用性
→ PDF / IETP / 离线环境 → 验收结论
证据链中任何一个环节缺失,都可能导致“内容看起来正确,但无法证明按批准规则生产和交付”。对安全关键内容和配置边界,应保留足够细的证据,而不是只保留最终 PDF。
如何设计风险抽样方案?
模块数量很大时,可以采用风险分层抽样,但不能用抽样掩盖安全关键或合同明确要求的全量检查。抽样方案要在检查前批准,写清总体、分层、样本数量或比例、抽取方法、失败判定和加严规则。
| 样本层 | 建议对象 | 检查策略 |
|---|---|---|
| 全量或加严层 | 安全警告、故障隔离、应急程序、关键构型、重大变更模块。 | 全量检查或由技术责任人逐条确认,并保留现场/台架证据。 |
| 代表性层 | 不同数据模块类型、SNS 系统、编制团队、语言和媒体组合。 | 每类至少抽取代表性样本,覆盖正常、边界和复杂引用。 |
| 变更层 | 本次版本修改、迁移、代码表或 BREX 变化影响的模块。 | 按影响分析确定样本,必要时扩展到引用它们的出版物。 |
| 随机层 | 其余已批准或待发布模块。 | 使用可复现的随机方法抽取,记录总体、种子或抽取时间。 |
| 问题层 | 曾经不合格、返工次数多、长期暂停或责任交接的模块。 | 加大比例或转为全量检查,直到缺陷率恢复到批准阈值。 |
可把“抽样发现一个严重问题就扩大样本”写进方案。样本不是越多越好,关键是覆盖风险、类型和边界,并能证明抽取和结论之间的关系。合同或监管要求高于一般抽样建议时,应按合同执行。
常见不符合项
| 不符合项 | 常见表现 | 建议处理 |
|---|---|---|
| 版本基线不一致 | 模块按旧 Schema 或 BREX 校验,发布包使用了新规则。 | 冻结基线,识别影响范围,统一重新校验并记录版本。 |
| DMC/SNS 不一致 | 系统层级、标题、模块内容或文件名对应关系冲突。 | 按批准代码表修订,评估引用、DMRL 和 PM 影响。 |
| 规则通过但内容不完整 | 缺少前置条件、工具、警告、恢复步骤或验收标准。 | 补充任务和安全评审,不能用“Schema 通过”关闭问题。 |
| 引用或媒体失效 | DMRef、图形热点、视频、3D 文件或外部链接缺失。 | 锁定引用版本,执行链接和端到端阅读检查。 |
| 适用性误筛选 | 某构型看到不属于它的步骤,或目录存在但关键内容被过滤。 | 补充真值组合和边界测试,修订产品属性或适用性规则。 |
| 状态和审批缺失 | 草稿进入交付包,退回原因或豁免没有记录。 | 恢复配置管理流程,补齐审批、状态历史和发布门禁。 |
| 交付环境不一致 | 开发机可读,离线设备、目标浏览器或权限环境无法使用。 | 在合同目标环境重测并保留安装、搜索、更新和恢复证据。 |
整改、复核与验收关闭
- 登记:为问题分配唯一编号,记录严重度、发现位置、基线、复现条件和发现人。
- 分析:区分直接错误、规则缺失、流程失效和输入资料问题,确定根因与受影响范围。
- 制定措施:明确修订模块、规则、模板、代码表、工具或流程的责任人和期限。
- 修订与评审:按配置管理要求产生新版本,保留差异、审批和必要的豁免依据。
- 回归:重新做结构、规则、引用、适用性和人工检查,并扩大到受影响的出版物和交付包。
- 关闭:由独立复核人确认接受条件、证据和影响评估,更新验收结论和遗留风险。
项目验收检查清单
- 依据:Issue、Schema、Data Dictionary、代码表、BREX、合同和项目基线是否明确且版本一致?
- 范围:DMRL、数据模块、PM、适用性、媒体和交付格式是否覆盖合同要求?
- 自动校验:结构、字段、代码、规则、引用和包完整性报告是否可复现?
- 人工审查:技术内容、安全、语言、图形、故障逻辑和现场可执行性是否有责任人签字或电子记录?
- 抽样:抽样层次、比例、随机方法、全量对象、边界构型和失败后的加严规则是否提前批准?
- 问题闭环:不符合项是否有根因、责任人、整改、回归、独立复核和关闭证据?
- 交付重现:根据基线、配置和发布日志,能否重新生成或核对最终交付包?
- 遗留风险:未关闭问题、豁免、限制条件和后续计划是否在验收结论中明确,而不是隐藏在备注里?
常见问题
S1000D 符合性审查只检查 XML 能否通过 Schema 吗?
不是。Schema 通过只说明基础结构和数据类型满足某个版本,完整审查还应覆盖 BREX、项目规则、DMC/SNS、内容、安全、引用、适用性、出版物和交付环境。
S1000D 项目验收应该全量检查还是抽样?
采用风险分层策略:安全关键、故障隔离、配置边界和重大变更对象可全量或加严检查,普通模块按类型、系统、版本和适用性分层抽样。
发现不符合项后什么时候可以关闭?
完成原因分析、修订或豁免批准、影响评估、回归检查和证据归档后,由复核人确认才能关闭。
符合性审查报告需要保留哪些证据?
应保留标准与项目基线、模块和交付版本、校验日志、抽样清单、人工评审、不符合项及整改证据、适用性和环境验证结果以及批准记录。
工具报告 0 个错误就能直接验收吗?
不能。工具只覆盖已配置规则,仍需人工确认技术内容、安全、可执行性、构型边界、读者任务和交付环境。