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

# 人员

> 在 Alforse 中设置员工主数据，包括岗位安排、部门、为排程器提供输入的班次、假期、自定义员工属性和办公室工时记录。

“人员”保存公司的人力资源主数据：谁在这里工作、在组织中处于什么位置、何时工作，以及您跟踪的关于他们的任何额外信息。管理员和人力资源人员负责维护；计划员依赖这些数据，因为班次决定了受技能限制的工作何时可以排程。

登录、角色和访问授权不属于此区域，它们在[权限](https://docs.alforse.com/zh/docs/reference/permissions.md)中处理。

## 人员如何存储

Alforse 将一个人拆分到三张相互关联的表中：

| 表 | 保存内容 | 范围 |
| - | - | - |
| `user` | 登录身份 | 全局 |
| `employee` | 某家公司的成员身份 | 每家公司 |
| `employeeJob` | 职称、位置、部门、班次和经理 | 每家公司 |

由于这些记录共用一个 ID，且后两张表按公司划分范围，一个登录账号可以为多家公司工作，并在每家公司拥有不同的职称、站点或经理。

## 员工

### 员工目录

位于**管理**下的**员工**是公司的员工名单。各列包括名、姓、电子邮件、员工类型和位置，最后是**状态**：

| 状态 | 含义 |
| - | - |
| **“启用”** | 公司的在职成员。 |
| **“已邀请”** | 邀请仍在等待处理。 |
| **“已停用”** | 不再是公司的在职成员。 |

没有人手动设置此状态。Alforse 根据员工记录以及任何未处理的邀请计算得出。

如果公司强制启用双因素认证，目录会增加一个**双因素**列，显示每个人是否已设置验证器。对于丢失设备的人，行菜单随后会提供**“重置双因素认证”**。参见[双因素认证](https://docs.alforse.com/zh/docs/reference/two-factor.md)。

### 员工记录

一个人的页面分为多个选项卡：**个人资料**、**岗位**（Job）、**技能**、**备注**、每个属性类别各一个选项卡，以及在启用时间跟踪时的**工时记录**。**岗位**选项卡承载岗位安排数据：

| 字段 | 类型 | 用途 |
| - | - | - |
| **标题**（Title） | 文本 | 此人在本公司中的职务名称。不授予任何访问权限（见下方警告）。 |
| **开始日期** | 日期 | 入职第一天。 |
| **位置** | 引用 | 所属站点。必填。 |
| **班次** | 引用 | 可选的工作时间安排，排程器读取它来判断此人何时可以承担受技能限制的工作。 |
| **部门** | 引用 | 此人所在的组织单元。 |
| **经理** | 引用 | 另一名员工，即此人的汇报对象。 |

HEADS UP

此选项卡上的“岗位”指的是职称，而不是生产工单。`employeeJob` 表记录的是组织内的安排，与保存工作订单的 `job` 表毫无关系。职称同样不授予任何权限：一个人能做什么取决于其**员工类型**，详见[权限](https://docs.alforse.com/zh/docs/reference/permissions.md)。

### 添加和移除人员

邀请和停用人员发生在身份与访问流程中，而不是在这里。请注意，停用某人远不止是一次编辑：其公司成员身份被移除，岗位安排被删除，访问权限被撤销。

## 部门

部门描述公司的组织结构，位于**配置**下。将部门指向上级部门即可建立层级，从而逐级汇总人数。一个人从其**岗位**选项卡被安排到某个部门。

| 字段 | 类型 | 用途 |
| - | - | - |
| **部门名称** | 文本 | 在整个公司内唯一。 |
| **上级部门** | 引用 | 本部门所汇报的单元；留空则为顶级部门。 |

HEADS UP

删除部门是硬删除：该行会被移除。请先重新分配所有被安排在该部门的人员，否则他们的岗位安排将没有部门。

## 班次

班次定义某个站点的工作时间：何时开始工作、何时结束，以及在星期几。您从某人的**岗位**选项卡为其指定班次。

| 字段 | 类型 | 用途 |
| - | - | - |
| **班次名称** | 文本 | 该时间安排的标签。 |
| **位置** | 引用 | 拥有该班次的站点。必填。 |
| **开始时间** / **结束时间** | 时间 | 每日开始和结束时间。两者均必填。 |
| **天数** | 布尔值 | 七个开关，从周一到周日，标记工作日。 |

### 班次如何影响排程

班次是[排程](https://docs.alforse.com/zh/docs/reference/scheduling.md)的真正输入，而不只是今天谁在岗的记录。排程引擎将每个人的班次时间与机器的运营时间重叠，以决定受技能限制的工作何时可以运行。因此，更改班次或更改某人所在的班次，会将受影响排程的重新计划加入队列。

NOTE

班次既适用于人员，也适用于机器。对员工而言，班次设定此人何时可以被排程；对[工作中心](https://docs.alforse.com/zh/docs/reference/work-centers.md)而言，它设定该工位的运营时间。当工序的工艺需要某项技能时，当班的操作员是决定性约束：如果没有合格的操作员当班，该工序就要等待。

删除班次只是将其标记为停用，而不是移除，因此过去的分配保持完整。

## 假期

假期标记公司不上班的日子。列表按年份分组，年份由每个假期的日期推导，因此一次可以检查一个日历年。

| 字段 | 类型 | 用途 |
| - | - | - |
| **假期名称** | 文本 | 列表中显示的标签。必填。 |
| **日期** | 日期 | 休息日。必填；年份取自该日期。 |

## 属性

需要记录 Alforse 没有内置字段的信息，比如证书到期日、工牌号或 T 恤尺码？请使用属性，它们分为两个层级：

* **属性类别**将相关字段分组。它有名称、一个表情符号和一个公开开关，该开关决定其属性是显示在个人的公开资料上，还是仅对管理员可见。
* **属性**是类别内的一个字段，带有数据类型。

每个属性由以下内容定义：

FieldType

<details>
  <summary>**名称**`text`</summary>

  字段的名称。
</details>

<details>
  <summary>**数据类型**`enum`</summary>

  它接受的值的类型；见下表。
</details>

<details>
  <summary>**列表选项**`text[]`</summary>

  允许的值。仅当数据类型为*列表*时使用。
</details>

<details>
  <summary>**自我管理**`boolean`</summary>

  开：员工可以在自己的个人资料上编辑该值。关：只有管理员可以。
</details>

### 数据类型

数据类型来自一个固定列表：

| 数据类型 | 可用于属性 | 备注 |
| - | - | - |
| **“文本”**、**“数值”**、**“是/否”**、**“日期”**、**“用户”** | 是 | |
| **“列表”** | 是 | 选项来自其列表选项。 |
| **“客户”**、**“供应商”**、**“文件”** | 否 | 添加在客户和供应商的自定义字段上，它们共用这个列表。 |
| **“链接”** | 否 | 仅在自定义字段上提供。 |

NOTE

创建属性时请谨慎选择数据类型：一旦记录了值，就无法更改。删除类别或属性是软删除（标记为停用），因此停用某个属性会保留已收集的值。

## 工时记录

工时记录记录员工在工作日上下班打卡的时间。

### 启用工时记录

时间跟踪默认关闭。在**设置 → 人员**下打开**工时记录**（标记为 Beta）。随后每个人都会有一个**工时记录**选项卡，并在**管理**下出现一个公司范围的列表。

### 条目和状态

一个条目包含员工、上班打卡时间、可选的下班打卡时间和备注。其**状态**取决于是否存在下班打卡：

<details open>
  <summary>**进行中**</summary>

  已上班打卡，尚未下班打卡：员工正在上班。
</details>

<details>
  <summary>**已完成**</summary>

  已下班打卡。条目已关闭，时长固定。
</details>

* 状态是计算得出的，而非存储的。
* **没有审批步骤**：已完成的工时记录是最终的，不会等待签字确认。
* 时长从上班打卡算到下班打卡；条目仍在进行中时，则算到*当前*。每周工时汇总当前一周的条目。
* 您可以直接添加、编辑或删除条目，因此漏打卡可以事后修正。

NOTE

这些是办公室端的考勤记录。在车间，操作员在 [MES](https://docs.alforse.com/zh/docs/reference/mes.md) 中针对具体的工单工序登记时间，这与员工的上下班打卡是两套独立的机制。

## 故障排除

| 消息或症状 | 原因 | 解决方法 |
| - | - | - |
| 保存班次时出现 “Location is required”（位置为必填项） | 班次必须属于一个位置（`locationId`）。相比之下，员工自己的班次分配是可选的。 | 选择一个位置，然后保存。 |
| “Start time is required” / “End time is required”（开始时间为必填项 / 结束时间为必填项） | 班次的两个时间都是必填的。 | 填写两个时间。 |
| 假期上出现 “Date is required” 或 “Name is required”（日期为必填项 / 名称为必填项） | 假期需要名称和日期；年份由日期推导。 | 两项都填写。 |
| 删除后人员失去了部门 | 部门删除是硬删除，与班次和属性被标记为停用不同。 | 将这些员工重新分配到另一个部门。 |
| 没有**工时记录**选项卡或列表 | 时间跟踪已关闭。 | 在**设置 → 人员**下打开**工时记录**。 |
| 找不到审批工时记录的地方 | 工时记录没有审批工作流；已完成的条目是最终的。 | 通过编辑或删除条目来更正错误。 |

## 相关内容

**权限**

员工类型、角色，以及每个人可以做什么。

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

**双因素认证**

验证器代码、公司范围的强制启用，以及重置丢失的设备。

[Open](https://docs.alforse.com/zh/docs/reference/two-factor.md)

**MES**

在车间针对工单工序登记时间。

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

**工作中心**

工序在哪里运行，以及如何排程和计算成本。

[Open](https://docs.alforse.com/zh/docs/reference/work-centers.md)


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