Appearance
角色列表
路徑：/admin/permissions/roles | 快捷鍵：3 → B
角色列表頁面用於管理系統中所有角色及其對應的權限配置。透過角色，站主可以精細控制不同管理員能夠存取的功能範圍。
頁面說明
頁面顯示一個角色表格：
| 欄位 | 說明 |
|---|---|
| 序號 | 角色編號 |
| 角色名稱 | 顯示角色標籤名稱與角色代碼（Code） |
| 角色類型 | 系統商（system，藍色 badge）或 商戶（merchant，黃色 badge） |
| 類型 | 內建（builtin，灰色 badge）或 自訂（綠色 badge） |
| 權限數 | 已分配權限數 / 該角色類型的總權限數（系統商角色顯示系統後台權限總數，商戶角色顯示商戶後台權限總數） |
| 操作 | 編輯權限、編輯角色、刪除角色按鈕 |
內建角色
系統預設以下內建角色，不可刪除：
| 角色代碼 | 角色類型 | 說明 |
|---|---|---|
root | 系統商 | 最高權限，擁有所有權限，不可編輯權限或刪除 |
systemAdmin | 系統商 | 系統管理員，預設擁有大部分管理權限 |
systemStaff | 系統商 | 系統人員，預設擁有基本查詢權限 |
merchantOwner | 商戶 | 商戶負責人，預設擁有商戶端完整權限 |
merchantAdmin | 商戶 | 商戶管理員，預設擁有商戶端大部分權限 |
merchantStaff | 商戶 | 商戶人員，預設僅有基本查詢權限 |
TIP
內建角色的代碼與角色類型不可修改，僅可調整標籤名稱與權限配置（root 除外）。
新增角色
- 點擊 「新增角色」 按鈕
- 填寫以下資訊：
| 欄位 | 必填 | 說明 |
|---|---|---|
| 角色代碼 | 是 | 英文代碼，建立後不可修改 |
| 角色名稱 | 是 | 顯示用的中文名稱 |
| 角色類型 | 是 | 選擇「系統商」或「商戶」，決定此角色可存取的功能範圍 |
- 點擊 「確認」 儲存
編輯角色
- 點擊操作欄的編輯圖示
- 僅可修改角色名稱（標籤）
- 角色代碼與角色類型不可修改
- 內建角色僅可修改名稱
編輯權限
- 點擊操作欄的 「編輯權限」 按鈕（root 角色不會顯示此按鈕）
- 開啟權限編輯彈窗，系統會根據角色類型自動篩選：
- 系統商角色：僅顯示「系統後台」分頁的權限項目
- 商戶角色：僅顯示「商戶後台」分頁的權限項目
- 權限依選單結構分組顯示，每個群組可展開/收合
- 頂部提供 全選 / 取消全選 按鈕（僅影響當前顯示的權限）
- 勾選需要的權限後點擊 「儲存」
權限限制
非 root 用戶僅能分配自己擁有的權限給其他角色。如果您沒有某項權限，該項目在編輯時會被隱藏。
刪除角色
- 僅自訂角色可以刪除
- 點擊刪除按鈕後需確認操作
- 刪除角色前，請確保沒有用戶正在使用該角色