quality-documentation-manager

质量文档管理员

面向符合 ISO 13485 的质量管理体系，设计和管理文档控制系统，包括编号规则、审批工作流、变更控制和电子记录合规性。

---

目录

• 文档控制工作流
• 文档编号系统
• 审批和评审流程
• 变更控制流程
• 21 CFR Part 11 合规性
• 参考文档
• 工具

---

先明确信息

在设置文档控制或验证文档之前，请先确认以下输入信息。如果其中某项缺失或含糊不清，且会影响结果，请先询问；如果不会影响结果，请采用合理的默认值，并说明所采用的默认值。

• 文档类型： QM、SOP、WI、TF、SPEC 或 PLN（决定所需的评审人、审批人和编号）。
• 法规范围： 仅 ISO 13485，还是包含 21 CFR Part 11 电子记录（决定是否需要审计追踪和电子签名控制）。
• 变更分类： 行政类、次要、重大或紧急（决定审批路径和影响评估）。

请针对当前请求询问最重要的两三项，而不是询问完整列表。如果用户希望立即获得结果，请直接提供，并在开头说明你的假设。

文档控制工作流

从创建到废止，实施文档控制：

1. 按照编号程序分配文档编号
2. 使用受控模板创建文档
3. 将文档提交给所需评审人评审
4. 处理评审意见并记录回复
5. 获取所需的审批签名
6. 指定生效日期并分发
7. 更新文档主清单
8. 验证： 确保文档在使用地点可访问；移除过时版本

文档生命周期阶段

阶段	定义	所需操作
草稿	正在创建或修订	作者正在编辑，不可用于实际工作
评审中	已发送评审	评审人提供反馈
已批准	已获得所有签名	可用于培训和分发
已生效	培训已完成，文档已发布	可供使用
已被取代	已由较新版本取代	从当前使用中移除
已废止	不再适用	按保留计划归档

文档类型和前缀

前缀	文档类型	典型内容
QM	质量手册	QMS 概述、范围、方针
SOP	标准操作规程	流程级程序
WI	工作指导书	任务级分步说明
TF	模板/表单	受控表单
SPEC	规范	产品/流程规范
PLN	计划	质量/项目计划

按文档类型划分的必需评审人

文档类型	必需评审人	必需审批人
SOP	流程负责人、QA	QA 经理、流程负责人
WI	区域主管、QA	区域经理
SPEC	工程、QA	工程经理、QA
TF	流程负责人	QA
设计文档	设计团队、QA	设计控制负责人

---

文档编号系统

分配一致的文档编号，以便识别和检索。

编号格式

标准格式：PREFIX-CATEGORY-SEQUENCE[-REVISION]

Example: SOP-02-001-A

SOP = Document type (Standard Operating Procedure)
02  = Category code (Document Control)
001 = Sequential number
A   = Revision indicator

类别代码

代码	功能领域	描述
01	质量管理	QMS 程序、管理评审
02	文档控制	本领域
03	人力资源	培训、能力
04	设计与开发	设计控制流程
05	采购	供应商管理
06	生产	制造程序
07	质量控制	检验、测试
08	CAPA	纠正/预防措施
09	风险管理	ISO 14971 流程
10	法规事务	申报、合规

编号工作流

1. 作者向文档控制部门申请文档编号
2. 文档控制部门核实类别分配
3. 文档控制部门分配下一个可用的序列号
4. 将编号记录在文档主清单中
5. 作者使用分配的编号创建文档
6. 验证： 编号格式符合标准；主清单中无重复编号

修订标识

更改类型	修订增量	示例
重大修订	增加编号	Rev 01 → Rev 02
次要修订	增加子修订号	Rev 01 → Rev 01.1
管理性更改	不变或添加字母后缀	Rev 01 → Rev 01a

完整的编号指南请参阅 references/document-control-procedures.md。

---

审批与评审流程

在发布文档前，完成所需的评审与审批。

评审工作流

1. 作者完成文档草稿
2. 作者通过路由表单或 DMS 提交评审
3. 根据文档类型指定评审人员
4. 评审人员在评审期限内（5-10 个工作日）提供意见
5. 作者处理意见并记录回复
6. 作者重新提交修订后的文档
7. 审批人签名并注明日期
8. 验证： 所有必需的评审人员均已完成评审；所有意见均已处理并记录处置情况

意见处置

处置方式	所需操作
接受	按原文纳入意见
修改后接受	经修改后纳入，并记录理由
拒绝	不予纳入，并记录理由
延后处理	在未来修订中处理，并记录原因

审批矩阵

Document Level 1 (Policy/QM): CEO or delegate + QA Manager
Document Level 2 (SOP): Department Manager + QA Manager
Document Level 3 (WI/TF): Area Supervisor + QA Representative

签名要求

要素	要求
姓名	签署人的正楷姓名
签名	手写或电子签名
日期	签署日期
角色	签署人的职能/角色

---

变更控制流程

通过评审和审批系统地管理文档变更。

变更控制工作流

1. 确定文档变更需求
2. 填写变更申请表并说明理由
3. 文档控制部门分配变更编号并登记申请
4. 将申请发送给评审人员进行影响评估
5. 根据变更分类获得审批
6. 作者实施已批准的变更
7. 更新修订编号和变更历史
8. 验证： 变更符合已批准的范围；变更历史完整

变更分类

类别	定义	审批级别	示例
管理性	不影响内容	文档控制部门	拼写错误、格式
次要	有限的内容变更	流程负责人 + QA	澄清说明
重大	重大内容变更	完整评审流程	新要求
紧急	紧急安全/合规事项	加急处理 + 追溯审批	安全问题

影响评估检查清单

影响领域	评估问题
培训	变更是否需要重新培训？
设备	变更是否会影响设备或系统？
验证	变更是否需要重新验证？
法规	变更是否会影响法规申报文件？
其他文档	哪些相关文档需要更新？
记录	哪些记录会受到影响？

变更历史记录

每份文档都必须包含变更历史：

| Revision | Date | Description | Author | Approver |
|----------|------|-------------|--------|----------|
| 01 | 2023-01-15 | Initial release | J. Smith | M. Jones |
| 02 | 2024-03-01 | Updated workflow | J. Smith | M. Jones |

---

21 CFR Part 11 合规性

实施电子记录和电子签名控制，以符合 FDA 要求。

Part 11 适用范围

适用范围	不适用范围
FDA 法规要求的记录	纸质记录
提交给 FDA 的记录	内部非监管类文件
必需记录上的电子签名	一般电子邮件通信

电子记录控制

1. 验证系统的准确性和可靠性
2. 为所有更改实施安全审计追踪
3. 将系统访问权限限制为授权人员
4. 生成准确、可供人阅读的副本
5. 在整个保留期内保护记录
6. **验证：**审计追踪会记录所有更改的操作者、内容和时间

审计追踪要求

要求	实施方式
安全	用户无法修改
由计算机生成	系统自动创建
带有时间戳	每项操作的日期和时间
保留原始值	保留先前的值
用户身份	记录做出每项更改的人员

电子签名要求

要求	实施方式
个人专属	不可由多人共用
至少包含 2 个组成部分	至少包含用户 ID + 密码
签名呈现	显示姓名、日期/时间和含义
与记录关联	不可从记录中分离或复制

签名呈现

每个电子签名都必须显示：

元素	示例
正楷姓名	John Smith
日期和时间	2024-03-15 14:32:05 EST
含义	批准发布

系统控制检查清单

访问控制：

• 每人使用唯一的用户 ID
• 强制执行密码复杂度要求
• 多次尝试失败后锁定帐户
• 不活动后会话超时

审计追踪：

• 记录所有记录的创建操作
• 记录所有修改及旧值/新值
• 捕获用户身份
• 所有条目均带有日期/时间戳

安全：

• 基于角色的访问控制
• 对静态和传输中的数据进行加密
• 定期备份并测试恢复能力

详细的合规要求请参阅 references/21cfr11-compliance-guide.md。

---

参考文档

文档控制程序

references/document-control-procedures.md 包含：

• 文档编号系统和格式
• 文档生命周期阶段和状态转换
• 审核和批准工作流详情
• 带分类标准的变更控制流程
• 分发和访问控制方法
• 记录保留期限和处置程序
• 文档主清单要求

21 CFR Part 11 合规指南

references/21cfr11-compliance-guide.md 包含：

• Part 11 的适用范围和适用性
• 电子记录要求（§11.10）
• 电子签名要求（§11.50、11.100、11.200）
• 系统控制规范
• 验证方法和文档
• 合规检查清单和差距评估模板
• 常见 FDA 缺陷及预防方法

---

工具

文档验证器

# Validate document metadata
python scripts/document_validator.py --doc document.json

# Interactive validation mode
python scripts/document_validator.py --interactive

# JSON output for integration
python scripts/document_validator.py --doc document.json --output json

# Generate sample document JSON
python scripts/document_validator.py --sample > sample_doc.json

验证内容：

• 是否符合文档编号规范
• 标题和状态要求
• 日期验证（生效日期、审核到期日）
• 按文档类型确定的批准要求
• 变更历史的完整性
• 21 CFR Part 11 控制（审计追踪、签名）

示例文档输入

{
  "number": "SOP-02-001",
  "title": "Document Control Procedure",
  "doc_type": "SOP",
  "revision": "03",
  "status": "Effective",
  "effective_date": "2024-01-15",
  "review_date": "2025-01-15",
  "author": "J. Smith",
  "approver": "M. Jones",
  "change_history": [
    {"revision": "01", "date": "2022-01-01", "description": "Initial release"},
    {"revision": "02", "date": "2023-01-15", "description": "Updated workflow"},
    {"revision": "03", "date": "2024-01-15", "description": "Added e-signature requirements"}
  ],
  "has_audit_trail": true,
  "has_electronic_signature": true,
  "signature_components": 2
}

---

文档控制指标

跟踪文档控制系统的绩效。

关键绩效指标

指标	目标	计算方法
文档周期时间	<30 天	从草稿到生效的平均天数
审核完成率	>95%	按时完成的审核数 / 审核总数
变更请求积压量	<10	月末未完成的变更请求数
审核逾期率	<5%	超过审核日期的文档数 / 生效文档总数
审计发现率	每次审计 <2 项	每次内部审计中发现的文档控制问题数

定期评审计划

文档类型	评审频率
方针	每 3 年
SOP	每 2 年
WI	每 2 年
规范	按需或随产品变更
表单/模板	每 3 年

---

法规要求

ISO 13485:2016 第 4.2 条

子条款	要求
4.2.1	质量管理体系文件
4.2.2	质量手册
4.2.3	医疗器械文件（技术文档）
4.2.4	文件控制
4.2.5	记录控制

FDA 21 CFR 820

章节	要求
820.40	文件控制
820.180	记录的一般要求
820.181	器械主记录
820.184	器械历史记录
820.186	质量体系记录

常见审核发现

发现	预防措施
使用过时文件	实施分发控制
缺少审批签名	发布前强制执行工作流
变更历史不完整	要求每次修订时更新历史记录
未制定定期评审计划	建立并执行评审日历
审计跟踪记录不足	验证 DMS 是否符合 Part 11 要求

---

故障排除

问题	可能原因	解决方法
文档验证器报告“编号格式无效”	文档编号不符合 PREFIX-CATEGORY-SEQUENCE 模式	确保编号遵循 SOP-02-001 格式（类型前缀、2 位类别代码、3 位序号）。检查前缀是否与已识别的文档类型（QM、SOP、WI、TF、SPEC、PLN）相符。
尽管已有签名，验证仍提示缺少审批人	输入 JSON 中的 approver 字段为 null 或空值	在 approver 字段中填写审批负责人的姓名。对于 SOP，必须填写流程负责人和 QA 经理。
当前文档的评审日期验证失败	review_date 已过期	更新评审日期，使其反映下一次计划评审时间。超过评审日期的文档应标记为待定期评审和重新审批。
变更历史被标记为不完整	并非所有修订都在 change_history 数组中有对应条目	每次修订版本递增都必须有对应的变更历史条目，其中包含修订版本号、日期、说明和作者。请补齐历史记录中的缺漏。
使用 eDMS 时仍被标记为不符合 Part 11 控制要求	has_audit_trail 或 has_electronic_signature 设置为 false	将两者都设为 true，并确保 signature_components 至少为 2（Part 11 要求至少包含用户 ID + 密码）。确认 eDMS 能生成计算机生成且带时间戳的审计跟踪记录。
交互模式未显示所有验证规则	终端宽度不足以显示表格输出	加宽终端窗口，或使用 --output json 获取不受显示宽度影响的结构化输出。
过时文档仍显示为“有效”	修订周期内未更新状态字段	发布新修订版本时，将先前版本的状态更新为“已取代”，并确保其已从使用点移除。对已取代的文档运行验证器进行确认。

---

成功标准

• 文档编号系统得到强制执行，文档主清单中没有重复编号，且格式合规率达到 100%
• 所有文档类型的文档周期时间（从起草到生效）平均少于 30 个工作日
• 评审完成率超过 95%（按时完成的评审数占已启动评审总数的比例）
• 任意时点的定期评审逾期率低于有效文档总数的 5%
• 已验证所有电子记录均符合 21 CFR Part 11：审计追踪记录每项变更的执行人、内容和时间；电子签名包含打印姓名、日期/时间和签署含义
• 变更控制流程通过分类工作流（Administrative/Minor/Major/Emergency）处理 100% 的文档变更，并记录影响评估
• 最近一次认证审核或监督审核中，与文档控制相关的外部审核发现为零

---

范围与限制

范围内：

• 文档编号惯例的设计与验证
• 文档生命周期管理（从 Draft 到 Obsolete）
• 评审和批准工作流的执行
• 包含分类和影响评估的变更控制流程
• 21 CFR Part 11 电子记录和电子签名合规性验证
• 定期评审计划管理
• 文档主清单维护

范围外：

• eDMS 软件的选型、实施或验证（该工具验证元数据，而非 DMS 平台本身）
• EU Annex 11 计算机化系统验证（与 Part 11 相辅相成，但需要单独的评估方法）
• 技术文件 / Design History File 内容编写（技术文档请使用 regulatory-affairs-head）
• 记录保留计划制定（该工具验证日期，但不会确定法规要求的保留期限）
• 纸质文档的分发或归档后勤工作
• 培训记录管理（该工具验证培训相关文档，但不管理培训项目）

---

集成点

技能	集成方式
quality-manager-qms-iso13485	文档控制（Clause 4.2.3）和记录控制（Clause 4.2.4）是 QMS 的核心流程；验证器负责执行 ISO 13485 文档要求
qms-audit-expert	Clause 4.2 的内部审核用于验证文档控制的有效性；审核发现会推动文档流程改进
quality-manager-qmr	文档控制指标（周期时间、逾期评审、积压）作为 QMS 绩效指标报告给管理评审
fda-consultant-specialist	FDA QMSR（2026 年 2 月生效）通过引用纳入 ISO 13485 Clause 4.2；对于电子记录，Part 11 合规性仍是单独的 FDA 要求
capa-officer	CAPA 措施通常需要修订文档；变更控制流程会跟踪由 CAPA 引起的文档变更

---

工具参考

document_validator.py

验证文档元数据、编号惯例和法规控制要求。

标志	必填	说明
--doc	是（或使用 --interactive 或 --sample）	文档元数据 JSON 文件的路径，文件包含编号、标题、类型、修订版本、状态、日期、批准人、变更历史和 Part 11 字段
--interactive	否	启动交互式验证模式，引导用户录入文档
--output	否	输出格式：json 表示输出包含严重性评级发现项的结构化内容；省略则输出人类可读文本
--sample	否	生成示例文档 JSON 模板（使用 > sample_doc.json 重定向到文件）