Appearance
角色列表
路徑：/admin/permissions/roles | 快捷鍵：3 → J
角色列表頁面用於管理系統中所有角色及其對應的權限配置。透過角色，站主可以精細控制不同管理員能夠存取的功能範圍。
頁面說明
頁面顯示一個角色表格：
| 欄位 | 說明 |
|---|---|
| ID | 列表序號 |
| 角色名稱 | 顯示角色標籤名稱與角色代碼（Code） |
| 角色類型 | 系統商（藍色 badge）或 商戶（黃色 badge） |
| 類型 | 內建（builtin，灰色 badge）或 自訂（綠色 badge） |
| 權限數 | 已分配權限數 / 該角色類型的總權限數（系統商角色顯示系統後台權限總數，商戶角色顯示商戶後台權限總數） |
| 操作 | 編輯權限、編輯角色、刪除角色按鈕 |
內建角色
系統預設以下內建角色，不可刪除：
| 角色代碼 | 角色類型 | 說明 |
|---|---|---|
root | 系統商 | 最高權限，擁有所有權限，不可編輯權限或刪除 |
systemAdmin | 系統商 | 系統管理員，預設擁有大部分管理權限 |
systemStaff | 系統商 | 系統人員，預設擁有基本查詢權限 |
merchantOwner | 商戶 | 商戶負責人，預設擁有商戶端完整權限 |
merchantAdmin | 商戶 | 商戶管理員，預設擁有商戶端大部分權限 |
merchantStaff | 商戶 | 商戶人員，預設僅有基本查詢權限 |
TIP
內建角色的代碼與角色類型不可修改，僅可調整標籤名稱與權限配置（root 除外）。
新增角色
- 點擊 「新增角色」 按鈕
- 填寫以下資訊：
| 欄位 | 必填 | 說明 |
|---|---|---|
| 角色代碼 | 是 | 英文代碼，建立後不可修改 |
| 角色標籤 | 是 | 顯示用的中文名稱 |
| 角色類型 | 是 | 選擇「系統商」或「商戶」，決定此角色可存取的功能範圍 |
- 點擊 「建立」 儲存
編輯角色
- 點擊操作欄的編輯圖示
- 僅可修改角色標籤
- 角色代碼與角色類型不可修改
- 內建角色僅可修改名稱
編輯權限
- 點擊操作欄的 「編輯權限」 按鈕（root 角色不會顯示此按鈕）
- 開啟權限編輯彈窗，系統會根據角色類型自動篩選：
- 系統商角色：僅顯示「系統後台」分頁的權限項目
- 商戶角色：僅顯示「商戶後台」分頁的權限項目
- 權限依選單結構分組顯示，每個群組可展開/收合
- 頂部提供 全選 / 取消全選 按鈕（僅影響當前顯示的權限）
- 勾選需要的權限後點擊 「儲存」
權限限制
非 root 用戶僅能分配自己擁有的權限給其他角色。如果您沒有某項權限，該項目在編輯時會被隱藏。
下撥權限依付款方式分開授權
「撥款入帳」分組下的超商代碼下撥、ATM 下撥、信用卡下撥各自是一張權限卡，權限碼互相獨立：
| 頁面 | 查看 | 撥款 | 審核（站點限定） |
|---|---|---|---|
| 超商代碼下撥 | settlementCvs.read | settlementCvs.settle | settlementCvs.review |
| ATM 下撥 | settlementAtm.read | settlementAtm.settle | settlementAtm.review |
| 信用卡下撥 | settlementCreditCard.read | settlementCreditCard.settle | settlementCreditCard.review |
- 勾「超商代碼下撥－查看」只會開放超商下撥頁，ATM 與信用卡下撥不會跟著打開，可以只授權其中一種付款方式
- 沒有某種付款方式的「查看」權限，側邊欄就不會出現該下撥選單，也不會顯示它的待下撥數量
- 有「查看」但沒有「撥款」時，頁面可以預覽待下撥資料，但不會出現下撥按鈕
舊設定已自動轉換
過去三個下撥頁面共用同一組 settlement.read／settlement.settle／settlement.review，在權限編輯彈窗中勾其中一張卡的「查看」，另外兩張也會一起亮起。 改版時系統已自動把原本擁有這些權限的角色，換成三種付款方式都有的新權限，原本能做的事完全不變；之後要收窄範圍，再到這裡逐一取消勾選即可。
站點限定權限
部分權限對應的是 站點客製化功能，只會出現在有啟用該功能的站點；未啟用的站點在權限編輯彈窗中 完全看不到 這些項目，避免誤設定不存在的功能。
目前的站點限定權限一覽：
| 權限代碼 | 對應功能 | 說明 |
|---|---|---|
queryCvs.refund / queryAtm.refund / queryCreditCard.refund / queryCoin.refund | 訂單退款 | 將對應類型的已付款訂單標記為已退款 |
settlementCvs.review / settlementAtm.review / settlementCreditCard.review | 雙人審核 | 審核（核准／駁回）對應付款方式的下撥申請 |
cloudBalance.review | 雙人審核 | 審核（核准／駁回）雲帳戶調帳申請 |
proxy.read / proxy.create / proxy.update / proxy.delete | VPN 管理 | VPN 管理頁面的檢視與金鑰增刪改 |
proxy.cost | VPN 管理 | 查看 VPN 費用（依 Google Cloud 牌價估算）；預設不分配給任何角色 |
scrapers.read / scrapers.create / scrapers.update / scrapers.delete | 爬蟲管理 | 腳本配置頁面的檢視與爬蟲實例增刪改 |
channels.read / channels.create / channels.update / channels.delete | 通道列表 | 通道列表頁面的檢視與通道增刪改 |
cloudBalance.setWallet | 雙錢包 | 設定商戶的代付扣款來源錢包 |
cloudBalance.transfer | 雙錢包 | 執行主錢包與卡卡錢包的互轉 |
預設分配
三個下撥審核權限（settlementCvs.review／settlementAtm.review／settlementCreditCard.review）與 cloudBalance.review 已預設分配給內建的 系統管理員（systemAdmin） 角色；其餘站點限定權限預設未分配，需自行勾選。
另外，內建的 systemAdmin 角色預設 不含 telegram.*（TG 機器人）與 queryCoin.*（幣商訂單）權限，需要時請在此頁手動勾選。
刪除角色
- 僅自訂角色可以刪除
- 點擊刪除按鈕後需確認操作
- 刪除角色前，請確保沒有用戶正在使用該角色