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

# 權限與存取

> 管理員如何使用模組動作授權、員工類型範本、個人覆寫、電子郵件邀請，以及現場用的 PIN 帳號，來控制誰能在 Alforse 中看到與變更什麼。

管理員用權限來決定公司內每個人能看到與做什麼。Alforse 中的存取從不是隱含的：每項權利都是明確的**授權**，將一個模組（例如銷售或庫存）與一個動作（檢視、建立、更新或刪除）配成一對，而沒有任何授權的人可以登入，卻打不開任何一個模組。

相關頁面：員工記錄請見[人員](https://docs.alforse.com/zh-Hant/docs/reference/people.md)，同一模型下的程式化存取請見 [API 金鑰](https://docs.alforse.com/zh-Hant/docs/building/api-keys.md)，登入安全請見[雙重驗證](https://docs.alforse.com/zh-Hant/docs/reference/two-factor.md)。

## 概觀

| 概念 | 它的作用 | 在哪裡管理 |
| - | - | - |
| **授權** | 一個模組加一個動作，例如 `sales_view`。 | 任何權限矩陣 |
| **員工類型** | 可重複使用的授權範本。 | **使用者 → 員工類型** |
| **個人覆寫** | 對某個人的範本所做的例外。 | **使用者 → 帳號** |
| **批次編輯器** | 一次為多人新增或取代授權。 | **使用者 → 帳號** |
| **邀請** | 新人如何加入並取得其起始授權。 | **使用者 → 帳號** |
| **主控台操作員** | 供共用現場工作站使用、僅用 PIN 的帳號。 | **使用者 → 作業員** |

## 模組動作模型

### 授權名稱

授權寫成 `<module>_<action>`，例如 `sales_view`、`inventory_update` 或 `purchasing_create`。`sales_view` 讓人讀取銷售記錄；`inventory_update` 讓人編輯庫存。沒有任何授權隱含另一個授權。

### 模組

模組清單是固定的，權限資料表會拒絕任何其他金鑰：

會計、文件、開立發票、庫存、訊息、零件、人員、列印、生產、採購、品質、資源、銷售、設定、使用者與工作流程。

另有兩個內部模組，品項與工時卡，從不出現在權限畫面上，所以上述清單就是你能編輯的全部。

### 動作

每個模組列只顯示該模組支援的動作，選自這四種：

FieldType

<details>
  <summary>**view**</summary>

  查看該模組的記錄。沒有它，該模組的頁面對使用者完全隱藏。
</details>

<details>
  <summary>**create**</summary>

  新增記錄。
</details>

<details>
  <summary>**update**</summary>

  變更現有記錄。
</details>

<details>
  <summary>**delete**</summary>

  移除記錄。
</details>

### 權限矩陣

你編輯權限的每個地方都使用同一個矩陣：**每個模組一列，每個動作一個核取方塊**。

* 點選儲存格以切換單一授權。
* 點選列以開啟或關閉整個模組。
* 點選標題以選取全部。

員工類型範本、單一個人的覆寫、批次編輯器，以及 API 金鑰的範圍，全都使用這個相同的矩陣，所以你只需要學一次。

### 公司範圍

NOTE

**授權依公司套用**

每項授權都記錄它涵蓋的公司，因此一個人在其所屬的每家公司可以擁有不同的權利。畫面永遠編輯你目前所在公司的權限。特殊值 `"0"` 代表「所有公司」，是表示真正的跨公司管理員的方式。橫跨多家公司的人員請參閱[多公司設定](https://docs.alforse.com/zh-Hant/docs/reference/intercompany.md)。

### 兩層強制執行

Alforse 對每項授權檢查兩次：

1. **在應用程式中**，用來顯示或隱藏畫面與按鈕。
2. **在資料庫中**，透過列層級安全性，因此繞過介面的請求仍然無法取得其授權未涵蓋的資料。

資料庫這一層讓同一個模型對 [API 金鑰](https://docs.alforse.com/zh-Hant/docs/building/api-keys.md)也是安全的，其範圍使用的正是這種 `module_action` 形式。

## 員工類型

### 用範本取代核取方塊

**員工類型**是一組具名的授權。與其為每位新進人員勾選數十個儲存格，不如定義一次類型，例如擁有完整採購權限與僅檢視庫存的「採購人員」，再加以指派。它的授權會成為你指派給它的每個人的起點。

在**使用者 → 員工類型**下編輯類型，包含自訂權限的方案才提供此功能。

HEADS UP

**變更類型不會改變已在該類型上的人**

類型的授權是在你指派時複製的。之後編輯類型只會影響*之後*被指派的人；已在該類型上的每個人都保留他們目前的授權。若要更新現有員工，請使用[批次權限編輯器](#overrides-and-bulk-edits)。

### 系統類型

有兩種類型是預先建立的，不能刪除。每一種都帶有固定的 `systemType` 值，所以你可以重新命名其標籤而不會破壞 Alforse 的內部查詢：

FieldType

<details>
  <summary>**管理員**</summary>

  完整存取。交給管理公司 Alforse 設定的人。
</details>

<details>
  <summary>**主控台操作員**</summary>

  用於現場 PIN 帳號。新增作業員時 Alforse 會自動指派；你不需要手動指派。
</details>

你可以建立、重新命名與刪除其他所有類型。一家公司每種系統類型最多持有一個。

## 覆寫與批次編輯

### 個人覆寫

在**使用者 → 帳號**下，每位員工的矩陣從其員工類型開始。勾選或取消某個儲存格只會為該人記錄一個例外；類型本身不變。

當你把某人移到不同的類型時，Alforse 會詢問是要用新範本取代他們目前的授權，還是保留。

### 批次權限編輯器

若要一次變更多人，請選取使用者、選擇一種模式，然後設定矩陣：

FieldType

<details>
  <summary>**新增權限**</summary>

  在每位使用者已有的授權之上加入所選授權。不會移除任何東西。
</details>

<details>
  <summary>**更新權限**</summary>

  以該矩陣取代每位所選使用者的整組權限。
</details>

用它把員工類型的變更推行到現有員工，或一步就讓整個部門取得新模組。**新增**的意思是「也給每個人這些」；**更新**的意思是「讓每個人恰好是這樣」，所以只有在你打算覆寫時才選擇**更新**。

### 變更何時生效

NOTE

**變更會在使用者的下一個請求時套用**

為了速度，Alforse 會快取每位使用者的有效權限，並在你變更其授權時清除該快取，所以新的權利會在他們的下一個請求時套用。如果變更看起來仍未生效，幾乎都是工作階段已過時：登出再登入會強制重新讀取。

## 邀請人員

### 邀請如何運作

你永遠不需要為別人設定密碼。相反地，你透過電子郵件**邀請**他們，他們在接受時建立自己的登入。

1. 前往**使用者 → 帳號**。
2. 新增員工，填入其姓名、電子郵件、員工類型與地點。
3. Alforse 建立帳號、記錄邀請，並寄給該人一個完成加入的連結。

邀請是以電子郵件為鍵、以公司為範圍的記錄。它帶有此人起始時所擁有的授權，所以他們一接受，存取權就已就緒。

### 帳號狀態

員工的狀態由邀請與帳號推導而來：

<details>
  <summary>**已邀請**</summary>

  邀請已寄出但尚未接受。此人在使用連結之前無法登入。
</details>

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

  邀請已被接受，帳號正常使用中。
</details>

<details>
  <summary>**停用**</summary>

  帳號已被停用，或邀請在被接受之前遭撤銷。沒有存取權。
</details>

### 管理邀請與離職人員

* 從帳號清單**重新寄送**或**撤銷**尚未處理的邀請。
* **停用**啟用中的員工，會將他們從公司移除、剝奪其授權，並標記為停用。此人不會被刪除，因為他們可能仍屬於其他公司。完整記錄請見[人員](https://docs.alforse.com/zh-Hant/docs/reference/people.md)。

## 現場 PIN 帳號

### 什麼是主控台操作員

**主控台操作員**在共用工作站上用 **4 位數 PIN** 而不是電子郵件登入來登入 [MES](https://docs.alforse.com/zh-Hant/docs/reference/mes.md)。他們是另一種帳號。

### 新增作業員

1. 前往**使用者 → 作業員**。只有在公司啟用主控台模式時，此畫面才會出現。
2. 輸入姓名與地點。
3. Alforse 建立沒有電子郵件登入的輕量帳號，指派**主控台操作員**員工類型，並產生 4 位數 PIN。
4. 現在就複製 PIN。它只會顯示一次，因為 Alforse 只儲存它的雜湊值。

在現場，作業員點選自己的姓名並輸入 PIN；Alforse 在開始其工作階段之前會先檢查。

### 重設或設定 PIN

| 工作 | 位置 | 所需權限 |
| - | - | - |
| 重設作業員遺失的 PIN | **使用者 → 作業員** | `users_update` |
| 為任何其他員工設定主控台 PIN | **帳號**清單，**設定主控台 PIN** | `users_update` 與 `settings_update` |

重設會產生新的 PIN，舊的立即失效。為一般員工設定 PIN 需要額外的設定權限，因為持有該 PIN 的人可以在現場以該人的身分行動。

### PIN 鎖定

| 限制 | 範圍 | 效果 |
| - | - | - |
| 15 分鐘內輸入錯誤 PIN 5 次 | 一個人，跨所有工作站 | 該人的 PIN 登入被鎖定。鎖定一開始持續一分鐘，重複違規時加倍。之後輸入正確的 PIN 會清除其計數。 |
| 15 分鐘內輸入錯誤 PIN 30 次 | 一個工作站，跨所有人 | 該工作站達到上限。以同一登入登入的工作站共用此上限。 |

### 將作業員轉換為完整使用者

NOTE

**作業員可以升級為完整使用者**

當 PIN 帳號需要真正的 ERP 存取權時，給它一個電子郵件與完整的員工類型。Alforse 會把同一個人變成一般受邀使用者，他們先前的現場活動仍附屬於這個單一身分。

### PIN 帳號為什麼受限

PIN 帳號只持有其主控台操作員類型允許的授權。這是刻意的：遺失或共用的平板電腦無法用來進入 Alforse 的辦公室端。作業員自己的工作流程（上工打卡、回報數量、發料），請參閱 [MES 參考](https://docs.alforse.com/zh-Hant/docs/reference/mes.md)。

## 疑難排解

| 訊息或症狀 | 原因 | 修正 |
| - | - | - |
| 「Incorrect PIN」（PIN 錯誤） | PIN 與作業員的帳號不符。 | 重新輸入，或在**使用者 → 作業員**下重設。 |
| 「Too many incorrect PINs. Please wait a few minutes and try again.」（錯誤的 PIN 次數過多。請等幾分鐘後再試。） | 達到 [PIN 鎖定](#pin-lockouts)的限制。 | 等待；之後輸入正確的 PIN 會清除此人的計數。 |
| 「No PIN set. Ask an admin to set a console PIN for you.」（尚未設定 PIN。請管理員為你設定主控台 PIN。） | 此人沒有 PIN。PIN 一律由管理員產生，絕不在現場自行選擇。 | 對作業員使用**重設 PIN**，對其他員工使用**設定主控台 PIN**。 |
| 「Group members are required」（需要群組成員） | 批次動作（權限編輯、群組編輯、停用、重新寄送或撤銷邀請）在沒有選取任何人的情況下執行。 | 至少選取一位使用者。 |
| 使用者可以登入但什麼也看不到 | 他們缺少所需模組的 `<module>_view`。 | 透過其類型或覆寫授予所需的 `<module>_<action>`。 |
| 編輯員工類型沒有改變現有的人 | 類型只對變更之後被指派的人設定起始值。 | 使用批次編輯器：**更新**用於覆寫，**新增**用於疊加。 |
| 權限變更似乎沒有套用 | 使用者的工作階段已過時。 | 請他們登出再登入。 |
| 缺少**使用者 → 作業員** | 公司未啟用主控台模式。 | 啟用主控台模式，或在**帳號**下邀請一般使用者。 |

## 各部分在哪裡

**人員**

這些權限所適用的個別帳號。

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

**API 金鑰**

使用相同模組動作範圍的程式化存取。

[Open](https://docs.alforse.com/zh-Hant/docs/building/api-keys.md)

**MES 應用程式**

主控台操作員用 PIN 登入並執行現場作業的地方。

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


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