适用场景
你要 上传 SOP、换 PDF、理解 0.1 与 1.0、或发现 旧版不能改。本文写平台文档族规则；试验审阅路径见 eTMF，质量受控路径见 QualityDocs。
文档族结构
一篇 库文档 是一个 文档族（family）：
| 概念 | 说明 |
|---|---|
| 最新版本 | 唯一操作入口：当前文件、状态、属性在此维护 |
| 版本记录 | 族内每次升版一行；升版后旧「最新」冻结 只读 |
| 占位文档 | 可先建壳再传首文件，仍在 0.1 补传 |
业务用户几乎总在 最新版本 上上传、改状态、送审；历史版本用于对照、审计与「当时生效的是什么」。
创建与首版
- 创建文档，选类型/子类型（决定生命周期与布局）。
- 上传首个文件 → 通常形成 0.1（族内首版），不会自动跳到 1.0。
- 占位：无文件也可先建记录；首传仍在当前最新版上完成，不自动升版。
缺 create 或类型不允许时，无创建入口；与记录对象同理，见 权限与角色。
改内容：同步 vs 升版
| 你的操作 | 版本号 | 备注 |
|---|---|---|
| 只改元数据字段（标题、分类等） | 不变 | 同步到当前版本行 |
| 检入 / 上传新版本 / 升版 | 次版本 +1 | 旧最新冻结 |
| 进入应用定义的 稳态（如已批准/生效） | 主版本 +1、次归零 | 例 0.3 → 1.0 |
| 在稳态后要改 PDF 内容 | 须先起草/升版出新 0.x | 不能直接覆盖 1.0 文件 |
替换源文件 必须走升版；不能在同一版本号上覆盖二进制（合规要求）。
版本号速查示例
| 族内轨迹 | 含义 |
|---|---|
| 0.1 → 0.2 → 0.3 | 草案迭代，尚未稳态 |
| 0.3 → 1.0 | 批准/生效升格 |
| 1.0 → 1.1 | 生效后小改（若库允许小幅升版） |
| 新 0.1 并存 | 常表示从生效版 建立草稿 并行起草 |
具体主/次版本进位以库配置与应用为准；上表帮助读界面上的数字。
状态与生命周期
文档 state__v 在 最新版本 上随用户动作或工作流变化。
| 产品线 | 深读 |
|---|---|
| 试验 TMF 文档 | eTMF 审阅与批准 |
| 质量受控文档 | QualityDocs 概览 |
| 审核通过后的培训/变更控制分叉 | 文档审核、变更控制 |
送审后审批在 我的任务 完成，与记录对象相同；批准中勿指望状态下拉直接生效。
查看、预览与下载
| 操作 | 约束 |
|---|---|
| 预览 | 按类型生成可查看格式；无源文件时可能仅元数据 |
| 下载 | 须 download 权限；部分状态禁止外发 |
| 历史版打开 | 只读；显示当时版本号与文件 |
| 审计 | 查看/下载/签出等写入文档活动；详见 电子签名与审计 |
签出（若库启用）
部分类型支持 签出 / 签入：签出期间他人可能不能并发升版。未签入就离开可能导致他人 blocked——按库规程签入或取消签出。
与业务记录的关联
文档可通过 关系字段 挂在偏差、变更控制、研究等记录上。删关系不等于删文档族；文档生命周期仍独立。相关列表里「添加现有文档」须你对两端都有 read。
常见问题
| 现象 | 建议 |
|---|---|
| 找不到 1.0 | 尚未稳态升格；或只在历史版本列表里 |
| 不能改旧版 PDF | 历史冻结；对 最新版 升版或建草稿 |
| 改了标题版本号不变 | 正常；换文件才升版 |
| 审核通过后状态名看不懂 | 读 QualityDocs/eTMF 专题，平台只保证「最新版承载状态」 |
| 生效后还想改几个字 | 走新版本路径，不能原地覆盖 1.0 文件 |