> ## 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-Hant/docs/reference/permissions.md)中處理。

## 人員如何儲存

Alforse 將一個人拆分到三個相連的資料表：

| 資料表 | 保存的內容 | 範圍 |
| - | - | - |
| `user` | 登入身分 | 全域 |
| `employee` | 單一公司的成員資格 | 每家公司 |
| `employeeJob` | 職稱、地點、部門、班次與主管 | 每家公司 |

由於這些記錄共用同一個 ID，且後兩者以公司為範圍，一個登入帳號可以為多家公司工作，並在每家公司擁有不同的職稱、據點或主管。

## 員工

### 員工名錄

**員工**位於**管理**之下，是公司的人員清單。欄位涵蓋名字與姓氏、電子郵件、員工類型與地點，後面接著**狀態**：

| 狀態 | 意義 |
| - | - |
| **「啟用中」** | 公司的在職成員。 |
| **「已邀請」** | 邀請仍待處理。 |
| **「停用」** | 不再是公司的在職人員。 |

沒有人會手動設定這個狀態。Alforse 會根據員工記錄與任何未結邀請推算出來。

如果公司強制啟用雙重驗證，名錄會新增**雙重驗證**欄，顯示每個人是否已設定驗證器。對於遺失裝置的人，列選單會提供**「重設雙重驗證」**。請參閱[雙重驗證](https://docs.alforse.com/zh-Hant/docs/reference/two-factor.md)。

### 員工記錄

人員頁面分為多個選項卡：**個人資料**、**工單**、**能力**、**備註**、每個屬性類別各一個選項卡，以及在啟用工時追蹤時的**工時卡**。**工單**（Job）選項卡承載職務安排資料：

| 欄位 | 類型 | 用途 |
| - | - | - |
| **職稱**（Title） | 文字 | 此人在這家公司的角色名稱。不授予任何存取權（見下方警告）。 |
| **開始日期** | 日期 | 到職的第一天。 |
| **地點** | 參照 | 所屬據點。必填。 |
| **班次** | 參照 | 選填的工作時程，排程器讀取它來判斷此人何時可以承接需要特定能力的工作。 |
| **部門** | 參照 | 此人所屬的組織單位。 |
| **主管** | 參照 | 另一位員工，即此人的直屬上級。 |

HEADS UP

此選項卡上的「Job」指的是*職稱*，不是生產工單。`employeeJob` 資料表記錄組織安排，與存放製造工單的 `job` 資料表毫無關係。職稱也不授予任何權限：一個人能做什麼，取決於他們的**員工類型**，詳見[權限](https://docs.alforse.com/zh-Hant/docs/reference/permissions.md)。

### 新增與移除人員

邀請與停用人員是在身分與存取流程中進行，而不是在這裡。請注意，停用某人遠不只是一次編輯：他們的公司成員資格會被移除、職務安排會被刪除，存取權也會被撤銷。

## 部門

部門描述公司的組織方式，位於**配置**之下。將部門指向上層部門即可建立階層，因此人數可以逐層彙總。人員從其**工單**選項卡指派到部門。

| 欄位 | 類型 | 用途 |
| - | - | - |
| **部門名稱** | 文字 | 在整家公司內唯一。 |
| **上層部門** | 參照 | 此單位所隸屬的單位；留空則為最上層。 |

HEADS UP

刪除部門是硬刪除：該列會被移除。請先重新指派所有被安排在其中的人員，否則他們的職務安排將沒有部門。

## 班次

班次定義某個據點的工作時間：何時開始、何時結束，以及在星期幾。您從人員的**工單**選項卡為其指派班次。

| 欄位 | 類型 | 用途 |
| - | - | - |
| **班次名稱** | 文字 | 時程的標籤。 |
| **地點** | 參照 | 擁有該班次的據點。必填。 |
| **開始時間** / **結束時間** | 時間 | 每日的上班與下班時間。兩者皆必填。 |
| **天數** | 布林值 | 七個開關，從星期一到星期日，標示上班的日子。 |

### 班次如何影響排程

班次是[排程](https://docs.alforse.com/zh-Hant/docs/reference/scheduling.md)的真正輸入，不只是記錄今天誰在。引擎會將每個人的班次時數與機器的運轉時數重疊，以判斷需要特定能力的工作何時可以執行。因此，變更班次，或變更某人所屬的班次，都會讓受影響的排程排入重新規劃。

NOTE

班次同時適用於機器與人員。對員工而言，班次設定此人何時可以被排程；對[工作中心](https://docs.alforse.com/zh-Hant/docs/reference/work-centers.md)而言，則設定該工作站的運轉時間。當工序的流程需要某項能力時，當班的操作員就是決定性的限制：沒有合格的操作員當班，工序就會等待。

刪除班次只會將它標記為停用而不是移除，因此過去的指派保持完整。

## 假日

假日標示公司不上班的日子。清單依年份分組，年份由 Alforse 從每個假日的日期推算，因此一次可以檢查一個曆年。

| 欄位 | 類型 | 用途 |
| - | - | - |
| **假日名稱** | 文字 | 清單中顯示的標籤。必填。 |
| **日期** | 日期 | 休假日。必填；年份取自此日期。 |

## 屬性

需要記錄 Alforse 沒有內建欄位的資訊，例如證照到期日、識別證號碼或 T 恤尺寸？請使用屬性，分為兩層：

* **屬性類別**將相關欄位分組。它有名稱、表情符號，以及一個公開開關，決定其屬性是否出現在個人的公開個人資料上，或僅供管理員查看。
* **屬性**是類別內的一個欄位，具有資料類型。

每個屬性由下列內容定義：

FieldType

<details>
  <summary>**Name**`text`</summary>

  欄位的名稱。
</details>

<details>
  <summary>**Data Type**`enum`</summary>

  可接受的值類型；見下表。
</details>

<details>
  <summary>**List Options**`text[]`</summary>

  允許的值。僅在資料類型為*清單*時使用。
</details>

<details>
  <summary>**Self Managed**`boolean`</summary>

  開啟：員工可以在自己的個人資料上編輯該值。關閉：僅管理員可以。
</details>

### 資料類型

資料類型來自固定的清單：

| 資料類型 | 可用於屬性 | 備註 |
| - | - | - |
| **「文字」**、**「數值」**、**「是／否」**、**「日期」**、**「使用者」** | 是 | |
| **「清單」** | 是 | 選項來自其清單選項。 |
| **「客戶」**、**「供應商」**、**「檔案」** | 否 | 加在客戶與供應商的自訂欄位上，它們共用此清單。 |
| **「連結」** | 否 | 僅提供給自訂欄位。 |

NOTE

建立屬性時請謹慎選擇資料類型：一旦記錄了值就無法再變更。刪除類別或屬性是軟刪除（標記為停用），因此停用屬性會保留已收集的值。

## 工時卡

工時卡記錄員工上下班打卡的時間。

### 啟用工時卡

工時追蹤預設為關閉。在**設定 → 人員**下開啟**工時卡**（標示為 Beta）。接著每個人都會有一個**工時卡**選項卡，且**管理**之下會出現全公司的清單。

### 條目與狀態

一筆條目包含員工、上班打卡時間、選填的下班打卡時間，以及備註。其**狀態**取決於是否存在下班打卡：

<details open>
  <summary>**啟用中**</summary>

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

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

  已下班打卡。條目已結束，其時數已固定。
</details>

* 狀態是計算出來的，不是儲存的。
* **沒有核准步驟**：完成的工時卡就是定案，不會等待簽核。
* 時數從上班打卡計到下班打卡，條目啟用期間則計到*現在*。每週時數是當週條目的總和。
* 您可以直接新增、編輯或刪除條目，因此漏打卡之後可以補正。

NOTE

這些是辦公室端的出勤記錄。在現場，操作員是在 [MES](https://docs.alforse.com/zh-Hant/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-Hant/docs/reference/permissions.md)

**雙重驗證**

驗證器代碼、全公司強制啟用，以及重設遺失的裝置。

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

**MES**

在現場針對工單工序登記工時。

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

**工作中心**

工序執行的地點，以及它們如何排程與計算成本。

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


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