角色列表

路徑：/admin/permissions/roles  |  快捷鍵：3 → J

角色列表頁面用於管理系統中所有角色及其對應的權限配置。透過角色，站主可以精細控制不同管理員能夠存取的功能範圍。

頁面說明

頁面顯示一個角色表格：

欄位	說明
ID	列表序號
角色名稱	顯示角色標籤名稱與角色代碼（Code）
角色類型	系統商（藍色 badge）或 商戶（黃色 badge）
類型	內建（builtin，灰色 badge）或 自訂（綠色 badge）
權限數	已分配權限數 / 該角色類型的總權限數（系統商角色顯示系統後台權限總數，商戶角色顯示商戶後台權限總數）
操作	編輯權限、編輯角色、刪除角色按鈕

內建角色

系統預設以下內建角色，不可刪除：

角色代碼	角色類型	說明
root	系統商	最高權限，擁有所有權限，不可編輯權限或刪除
systemAdmin	系統商	系統管理員，預設擁有大部分管理權限
systemStaff	系統商	系統人員，預設擁有基本查詢權限
merchantOwner	商戶	商戶負責人，預設擁有商戶端完整權限
merchantAdmin	商戶	商戶管理員，預設擁有商戶端大部分權限
merchantStaff	商戶	商戶人員，預設僅有基本查詢權限

TIP

內建角色的代碼與角色類型不可修改，僅可調整標籤名稱與權限配置（root 除外）。

新增角色

1. 點擊 「新增角色」 按鈕
2. 填寫以下資訊：

欄位	必填	說明
角色代碼	是	英文代碼，建立後不可修改
角色標籤	是	顯示用的中文名稱
角色類型	是	選擇「系統商」或「商戶」，決定此角色可存取的功能範圍

3. 點擊 「建立」 儲存

編輯角色

• 點擊操作欄的編輯圖示
• 僅可修改角色標籤
• 角色代碼與角色類型不可修改
• 內建角色僅可修改名稱

編輯權限

1. 點擊操作欄的 「編輯權限」 按鈕（root 角色不會顯示此按鈕）
2. 開啟權限編輯彈窗，系統會根據角色類型自動篩選：
   • 系統商角色：僅顯示「系統後台」分頁的權限項目
   • 商戶角色：僅顯示「商戶後台」分頁的權限項目
3. 權限依選單結構分組顯示，每個群組可展開/收合
4. 頂部提供 全選 / 取消全選 按鈕（僅影響當前顯示的權限）
5. 勾選需要的權限後點擊 「儲存」

權限限制

非 root 用戶僅能分配自己擁有的權限給其他角色。如果您沒有某項權限，該項目在編輯時會被隱藏。

站點限定權限

部分權限對應的是 站點客製化功能，只會出現在有啟用該功能的站點；未啟用的站點在權限編輯彈窗中 完全看不到 這些項目，避免誤設定不存在的功能。

目前的站點限定權限一覽：

權限代碼	對應功能	說明
queryCvs.refund / queryAtm.refund / queryCreditCard.refund / queryCoin.refund	訂單退款	將對應類型的已付款訂單標記為已退款
settlement.review	雙人審核	審核（核准／駁回）下撥申請
cloudBalance.review	雙人審核	審核（核准／駁回）雲帳戶調帳申請
proxy.read / proxy.create / proxy.update / proxy.delete	VPN 管理	VPN 管理頁面的檢視與金鑰增刪改
scrapers.read / scrapers.create / scrapers.update / scrapers.delete	爬蟲管理	腳本配置頁面的檢視與爬蟲實例增刪改
channels.read / channels.create / channels.update / channels.delete	通道列表	通道列表頁面的檢視與通道增刪改
promo.read / promo.update / promo.recharge	代理推廣	代理推廣頁面的檢視、設定與加值
cloudBalance.setWallet	雙錢包	設定商戶的代付扣款來源錢包
cloudBalance.transfer	雙錢包	執行主錢包與卡卡錢包的互轉

預設分配

settlement.review 與 cloudBalance.review 已預設分配給內建的 系統管理員（systemAdmin） 角色；其餘站點限定權限預設未分配，需自行勾選。

另外，內建的 systemAdmin 角色預設 不含 telegram.*（TG 機器人）與 queryCoin.*（幣商訂單）權限，需要時請在此頁手動勾選。

刪除角色

• 僅自訂角色可以刪除
• 點擊刪除按鈕後需確認操作
• 刪除角色前，請確保沒有用戶正在使用該角色