> ## 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.

# 量具与校准

> 登记测量仪器，让每台仪器按校准计划运行，把每次校准记录为证据，并一目了然地看到哪些量具已超出校准。

质量团队使用量具和校准来证明每次测量背后的仪器是可信的。量具是受控的测量仪器，如卡尺、千分尺、塞规或三坐标测量机；每台量具按周期性的校准计划运行，每次校准都保留为带日期的记录。

量具属于质量模块。记录[检验](https://docs.alforse.com/zh/docs/reference/inspections.md#gauges)时，你可以注明每个特性用哪台量具测量。

## 概览

| 概念 | 含义 | 位置 |
| - | - | - |
| **量具** | 一台实体仪器，有编号、类型和计划。 | **质量 → 校准 → 量具** |
| **量具类型** | 仪器的种类（卡尺、千分尺、三坐标测量机等）。 | **量具类型** |
| **校准记录** | 一次带日期的校准，含读数、环境条件和签核。 | **质量 → 校准 → 记录** |
| **校准状态** | `Pending`、`In-Calibration` 或 `Out-of-Calibration`，由 Alforse 推算。 | 显示在量具上 |

## 量具记录

在**质量 → 校准 → 量具**下添加量具。每台量具都需要一个**量具类型**。新公司已预置十九种量具类型，包括量块、多种卡尺和千分尺变体、塞规、平板和三坐标测量机。若要添加自己的类型，请前往**量具类型**并输入名称，不需要其他内容。

### 量具字段

FieldType

<details>
  <summary>**gaugeId**</summary>

  你为该仪器设定的编号，例如 `G-001`。留空时使用量具编号序列中的下一个号码。
</details>

<details>
  <summary>**gaugeTypeId**required</summary>

  这是哪一种仪器，从你的量具类型中选择。
</details>

<details>
  <summary>**gaugeRole**required</summary>

  `Master` 表示标准量具，即用来核对其他量具的基准；`Standard` 表示日常使用的测量仪器。
</details>

<details>
  <summary>**calibrationIntervalInMonths**required`number`</summary>

  量具必须多久校准一次（以月计）；下次到期日据此推算。默认为 6，且至少为 1。
</details>

<details>
  <summary>**description**</summary>

  用你自己的话说明这台仪器是什么。
</details>

<details>
  <summary>**modelNumber**</summary>

  制造商的型号。
</details>

<details>
  <summary>**serialNumber**</summary>

  仪器的序列号。
</details>

<details>
  <summary>**supplierId**</summary>

  量具的购买来源。
</details>

<details>
  <summary>**dateAcquired**</summary>

  量具归你所有的日期。
</details>

<details>
  <summary>**lastCalibrationDate**</summary>

  最近一次校准的日期。在第一条校准记录出现之前可手动编辑；之后始终取自最新的记录。
</details>

<details>
  <summary>**nextCalibrationDate**</summary>

  下次校准的到期日，等于*上次校准日期 + 周期*。每次记录校准时重新计算；仅在第一条记录之前可手动编辑。
</details>

<details>
  <summary>**locationId**</summary>

  存放量具的场所。
</details>

<details>
  <summary>**storageUnitId**</summary>

  该位置内存放量具的库位。
</details>

### 停用量具

量具要么是 `Active`，要么是 `Inactive`。

* **停用**量具即让其退役。其记录和校准历史会保留，并且不再出现在检验的量具列表中。
* 只有量具没有校准历史时才能**删除**，因为删除会彻底移除记录。

这两个操作都需要 `quality` **删除**权限。

## 校准计划

计划由两个值构成：以月计的**周期**和**上次校准日期**。记录一次校准时，Alforse 把其日期作为上次校准日期，并加上周期得到下次到期日。

## 记录校准

每次对量具校准时，都要在**质量 → 校准 → 记录**下登记一条**校准记录**。该记录就是你的证据：谁批准的、读数与哪个标准做了比较、环境条件，以及读数本身。

### 校准记录字段

FieldType

<details>
  <summary>**gaugeId**required</summary>

  校准的是哪台量具。
</details>

<details>
  <summary>**dateCalibrated**required</summary>

  校准进行的日期。会复制到量具上作为其上次校准日期，并据此推算下一次。
</details>

<details>
  <summary>**requiresAction**</summary>

  校准中发现需要跟进的事项时勾选。
</details>

<details>
  <summary>**requiresAdjustment**</summary>

  量具需要调整时勾选。
</details>

<details>
  <summary>**requiresRepair**</summary>

  量具必须维修时勾选。
</details>

<details>
  <summary>**calibrationAttempts**</summary>

  成对的读数：已知的参考值，以及量具对它实际测得的值。
</details>

<details>
  <summary>**measurementStandard**</summary>

  读数所比对的标准，例如可溯源至 NIST 的标准，或标准量具的序列号。
</details>

<details>
  <summary>**temperature**`number`</summary>

  当时的室温，单位 °C。
</details>

<details>
  <summary>**humidity**`number`</summary>

  当时的相对湿度，以 0 到 1 之间的小数输入（0.45 = 45%）。
</details>

<details>
  <summary>**supplierId**</summary>

  校准外包时，执行校准的外部实验室。
</details>

<details>
  <summary>**approvedBy**</summary>

  签核该校准的人。
</details>

<details>
  <summary>**notes**</summary>

  任何其他值得记录的内容。
</details>

### 合格或不合格

你不需要选择结果；由三个 **requires** 字段决定：

| `requiresAction`、`requiresAdjustment`、`requiresRepair` | 结果 | 之后的量具状态 |
| - | - | - |
| 均未勾选 | **合格** | `In-Calibration` |
| 勾选任意一项 | **不合格** | `Out-of-Calibration` |

NOTE

**每次校准都会保留**

新的校准会与旧记录并列添加，绝不会替换它们，因此量具保有完整的带日期历史，按最新在前排列。量具本身只汇总最近一次的日期和由此得出的状态。

## 校准状态

量具的校准状态由 Alforse 为你设置，你不能手动指定。

<details>
  <summary>**Pending**</summary>

  每台新量具的起点。计划已存在，但尚未记录合格的校准，因此量具还不能确认属于哪一种状态。
</details>

<details open>
  <summary>**In-Calibration**</summary>

  最近一次校准合格，且尚未再次到期。可以信赖用它进行的测量。
</details>

<details>
  <summary>**Out-of-Calibration**</summary>

  最近一次校准不合格，或已过到期日。依赖它之前请重新校准。
</details>

### 逾期

超过下次到期日的量具显示为 `Out-of-Calibration`，无论其上次保存的结果如何。

HEADS UP

**逾期是计算出来的，而不是保存的**

不存在“逾期”操作。每当显示量具时，Alforse 都会将其下次到期日与今天比较，因此计划失效当天，状态就会自动变为 `Out-of-Calibration`。恢复的唯一方法是记录一次新的合格校准。

### 到期提醒

定时任务会查找即将超出校准的量具，并通知**设置 → 质量**下为校准到期提醒所列的人员。请在那里添加合适的人，以免逾期的量具无人留意。

### 状态仅供参考

`Out-of-Calibration` 的量具**不会**阻止检验。仍可使用它记录样本，并接受或拒收批次。请把状态和到期提醒视为需要采取行动的信号，而不是闸门。

## 故障排除

| 症状 | 原因 | 处理 |
| - | - | - |
| "Calibration interval is required"（需要填写校准周期） | 周期为空、为零或为负。 | 输入 1 或更大的整数月数。 |
| "Type is required"（需要填写类型） | 量具没有量具类型。 | 选择一个量具类型。 |
| "Gauge is required" / "Date is required"（需要选择量具 / 需要填写日期） | 校准记录缺少量具或日期。 | 选择量具并输入校准日期。 |
| "Failed to insert gauge"、"Failed to update gauge" 或 "Failed to insert gauge calibration record"（插入量具、更新量具或插入量具校准记录失败） | 保存失败：数据库约束、序列问题或缺少权限。 | 重新加载后再试；检查你的角色是否拥有所需的质量权限。 |
| 校准合格，但量具仍显示 `Out-of-Calibration` | 下次到期日已过去，所以量具显示为逾期。 | 记录一次新的合格校准，让下次到期日移到未来。 |
| 逾期的量具没有阻止检验 | 状态仅供参考，没有拦截。 | 根据状态或到期提醒采取行动。 |

## 相关内容

**质量**

问题、纠正措施工作流和来料检验。

[Open](https://docs.alforse.com/zh/docs/reference/quality.md)


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