角色列表

路徑：/merchant/permissions/roles  |  快捷鍵：3 → B  |  權限要求：merchantRoles

商戶端的角色權限管理頁面。商戶負責人可在此建立自己的角色，並精細控制每個角色能存取哪些商戶後台功能，再於商戶人員頁面把角色指派給人員。

與系統後台的差異

此頁面只看得到、也只能設定 商戶後台 的權限。系統後台的功能權限不會出現在這裡，商戶端無法自行提權到系統端功能。

頁面說明

欄位	說明
ID	列表序號
角色名稱	內建角色顯示系統翻譯後的名稱，自訂角色顯示自行設定的名稱
類型	內建（灰色 badge）或 自訂（綠色 badge）
權限數	該角色已分配的商戶端權限數 / 商戶端權限總數。商戶負責人（merchantOwner）顯示「全部權限」
操作	編輯權限、編輯角色、刪除角色

內建角色

角色代碼	說明	可否調整
merchantOwner	商戶負責人，固定擁有商戶端全部權限	不可編輯權限、不可刪除
merchantAdmin	商戶管理員，預設擁有商戶端大部分功能	可編輯權限，不可刪除、不可改名
merchantStaff	商戶人員，預設僅有基本查詢功能	可編輯權限，不可刪除、不可改名

WARNING

商戶負責人（merchantOwner）的操作欄不會出現任何按鈕，只顯示「商戶負責人擁有所有權限，無需設定」，避免最高權限角色被誤改或誤刪。

新增角色

1. 點擊右上角 「新增角色」 按鈕（需 merchantRoles.create 權限）
2. 填寫欄位：

欄位	必填	說明
角色代碼	是	英文代碼，建立後不可修改
角色標籤	是	顯示用名稱

3. 點擊 「建立」 儲存

新建立的角色預設沒有任何權限，需再進入「編輯權限」勾選。

編輯角色

點擊操作欄的鉛筆圖示（需 merchantRoles.update 權限），僅可修改 角色名稱；角色代碼建立後鎖定。內建角色不會出現此按鈕。

編輯權限

1. 點擊操作欄的盾牌圖示（需 merchantRoles.editPermissions 權限）
2. 彈窗依 商戶後台側邊欄結構 分組列出所有可設定的權限，群組可展開／收合
3. 每一層都提供快速操作：
   • 彈窗右上角的 全選 / 取消全選：套用到所有商戶端權限
   • 群組列右側的 全選 / 取消全選：只套用該群組
   • 各功能區塊右上角的 全選 / 取消全選：只套用該功能
4. 群組列會顯示 已勾選 / 總數，全部勾滿時數字轉為主色
5. 勾選完成後點擊 「儲存」

修改自己的角色會自動重新整理

若你修改的正好是自己目前使用的角色，儲存後頁面會自動重新載入，讓新的權限即時套用到側邊欄與各頁按鈕。

刪除角色

• 僅 自訂 角色可刪除（需 merchantRoles.delete 權限），內建角色不會出現刪除按鈕
• 點擊刪除按鈕後需再次確認
• 刪除前請先確認沒有人員仍在使用該角色

權限

權限代碼	說明
merchantRoles.read	查看角色列表頁面
merchantRoles.create	新增自訂角色
merchantRoles.update	編輯自訂角色名稱
merchantRoles.editPermissions	編輯角色的權限勾選
merchantRoles.delete	刪除自訂角色