> ## Documentation Index
> Fetch the complete documentation index at: https://docs.alforse.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 质量文档

> 编写、审批和修订受控的 SOP 与作业指导书。每次修订都是一个新版本，被取代的版本会归档而不是删除。

**质量文档**是受控的 SOP 或作业指导书。质量团队编写它们，使每个人都遵循同一份现行程序，审核人员也能查看任何早期修订版的内容。

## 概述

每份文档由富文本正文和一组有序的**步骤**组成：任务、测量、复选框、签核等。生命周期决定文档何时成为权威程序。

已发布的程序不会就地编辑。要更改它，需要发布**新版本**，被取代的版本会归档。每次修订都会留存记录，从而保留审计历史。

质量文档列在**质量 → 文件控制 → 质量文档**下。

## 创建文档

1. 进入**质量文档**，选择**添加文档**（Add Document）。
2. 在**新质量文件**中，输入**名称**和**版本**。
3. 选择**保存**。文档以**草稿**状态打开。
4. 编写作业指导书正文并添加步骤。
5. 从文档表头发布（参见[发布文档](#publish-a-document)）。

TIP

如果列表为空，**添加文档**旁边会出现**加载模板**。使用它可以从一组现成的文档开始，而不是从空白页开始。

## 生命周期

质量文档始终处于三种状态之一。对任何一份文档而言，同一时间只有一个版本处于**启用**状态。

<details>
  <summary>**Draft**</summary>

  每份文档都从这里开始。您可以更改其名称、正文和步骤；其他状态都不允许编辑。草稿尚不是人们遵循的程序。
</details>

<details open>
  <summary>**Active**</summary>

  当前生效的修订版。发布它会将具有相同名称的其他启用版本归档。
</details>

<details>
  <summary>**Archived**</summary>

  已停用的修订版，原因是更新的版本已启用，或有人将其归档。您仍可打开它，并通过**重新激活**使其恢复。
</details>

### 发布文档

文档表头中的发布按钮会根据情况改变其标签。每种形式都会使文档趋向**启用**。

| 按钮 | 显示时机 | 结果 |
| - | - | - |
| **发布** | 文档为草稿且不适用任何审批规则 | 文档变为启用。 |
| **重新激活** | 文档已归档且不适用任何审批规则 | 文档重新变为启用。 |
| **提交以审批** | 某条[审批规则](https://docs.alforse.com/zh/docs/reference/approvals.md)涵盖质量文档 | 创建审批请求；获批后文档变为启用。 |

NOTE

每个名称只能有一份文档处于启用状态。发布文档的同一事务也会将公司中与其同名的*其他*所有启用文档归档，因此“现行程序”永远不会有多份有效副本。

### 归档或还原

启用文档和草稿都可以归档，启用或已归档的版本可以还原为草稿。有一项限制：当某个版本有待处理的审批请求时，只有发起审批的人或指定审批人才能还原它。

## 版本

控制来自版本管理。**名称**标识文档；它的每次修订都是带有**版本**号（从 0 开始计数）的独立记录。名称与版本合在一起是唯一的，因此 `"Incoming Inspection Procedure"` 可以同时存在 V0、V1 和 V2。

### 修订已发布的文档

1. 打开文档，再打开表头中的**版本**菜单。
2. 选择**新版本**。**复制质量文件**表单随即打开，其中**新版本**已设为下一个版本号。
3. 选择**保存**。

新的草稿会获得正文、步骤和标签的副本；被复制的版本不会改变。发布新草稿会将之前的启用版本归档。整个过程中不会删除任何内容，因此历史保持完整。

TIP

对于受控记录，请通过**新版本**进行修订，而不要试图更改启用中的文档。这样审核人员就能准确读到 V1 的内容，并看到 V2 何时接替。

每次修订都会在**版本**菜单中显示其版本标记和状态。选择已退役的修订版会以只读方式打开；它仍保持已归档。

## 审批

文档在启用之前是否需要签核，取决于公司的[审批规则](https://docs.alforse.com/zh/docs/reference/approvals.md)。质量文档属于共享审批引擎所涵盖的单据类型之一。

| 情形 | 会发生什么 |
| - | - |
| 不适用任何审批规则 | **发布**使文档立即变为**启用**。 |
| 适用某条审批规则 | 按钮显示为**提交以审批**，并改为创建审批请求。发起请求时会通知审批人。符合条件的审批人随后会在表头看到**审批**和**拒绝**；**审批**会在一个事务中使文档变为**启用**。 |

每份文档同一时间最多只有一个待处理的审批请求。如果您提交的是已归档版本，则在请求未结期间它会回到草稿状态。

## 步骤

步骤使文档成为人们可以逐项执行并据以记录的内容。它们与工单上的程序文件共用同一模型。每个步骤都有名称、可选的说明、决定其位置的**排序**以及**类型**。类型决定记录什么内容：

FieldType

<details>
  <summary>**Task**</summary>

  要做的事情。记录只显示是否已完成。
</details>

<details>
  <summary>**Value**</summary>

  操作员输入的任意值。
</details>

<details>
  <summary>**Measurement**</summary>

  对照**计量单位**读取的数值，此类型必须提供计量单位。最小值和最大值限制为可选。
</details>

<details>
  <summary>**Checkbox**</summary>

  以是或否回答的确认。
</details>

<details>
  <summary>**Timestamp**</summary>

  事情发生的时间。
</details>

<details>
  <summary>**Person**</summary>

  谁做了某事。
</details>

<details>
  <summary>**List**</summary>

  从您定义的列表中选取的一个选项。
</details>

<details>
  <summary>**File**</summary>

  上传文件。您可以限制接受的文件类型。
</details>

<details>
  <summary>**Inspection**</summary>

  记录一次检验的步骤。
</details>

### 步骤规则

保存步骤时会执行以下检查：

* **Measurement** 步骤必须指定计量单位。其最大值不能低于最小值。
* 其他步骤类型都不能带计量单位。
* **List** 步骤必须提供其选项。

## 权限

| 操作 | 权限 |
| - | - |
| 查看文档 | `quality` **view** |
| 创建文档或新版本 | `quality` **create** |
| 编辑和发布 | `quality` **update** |
| 删除 | `quality` **delete** |

## 质量文档与相关功能的区别

质量文档是独立的。文档本身不与工艺、物料或检验关联。有两个相近的功能常被误认为它：

| 功能 | 它是什么 | 与之的关系 |
| - | - | - |
| 程序文件 | 带版本的作业指导书，会复制到工单的工序上，为其提供步骤和运行参数。 | 步骤模型相同，但它位于生产方法中，而不是质量库中。 |
| [检验文档](https://docs.alforse.com/zh/docs/reference/inspections.md) | 带气泡标注的图纸，用于首件检验和过程尺寸检验。 | 独立的功能，存储在其自己的表中。 |

关于质量模块的其余部分，包括问题、处置和来料检验，请参见[质量](https://docs.alforse.com/zh/docs/reference/quality.md)。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.