Appearance
系統後台操作手冊
平台定位
WT Platform 是一套金流收帳系統，提供超商代碼、ATM 虛擬帳號、信用卡等多種收款方式，並支援自動撥款（下撥）與代付功能。
本手冊面向 站主（系統營運方），即向系統擁有者承租此平台的營運商。站主透過系統後台管理旗下商戶、審核資金流向、監控訂單狀態，確保平台日常營運順暢。
角色與權限
系統後台採用 RBAC（角色權限控管） 機制，分為兩層授權：
- 角色類型（RoleType）：決定角色屬於「系統商」或「商戶」，控制可存取的 API 範圍
- 細粒度權限（Permission）：每個角色可獨立設定各項功能的「新增 / 讀取 / 編輯 / 刪除」權限
側邊欄選單會自動根據當前使用者的角色權限顯示或隱藏。
系統內建六種角色：
| 角色 | 角色類型 | 說明 | 預設權限 |
|---|---|---|---|
| root | 系統商 | 最高權限，擁有所有功能 | 全部，不受權限限制 |
| systemAdmin | 系統商 | 日常營運管理者 | 系統端絕大多數功能（含用戶管理、角色管理、下撥、代付審核、雲帳戶調整）。預設 不含：TG 機器人、幣商訂單、訂單退款 |
| systemStaff | 系統商 | 系統人員 | 唯讀為主：儀表板、訂單查詢與匯出、繳費統計、撥款／代付／雲帳戶／發票的查看與匯出、操作歷程 |
| merchantOwner | 商戶 | 商戶負責人 | 商戶端完整權限（含商戶人員與角色管理） |
| merchantAdmin | 商戶 | 商戶管理員 | 商戶端大部分功能，但預設 不含 商戶人員與角色管理 |
| merchantStaff | 商戶 | 商戶人員 | 商戶端基本查詢（儀表板、站內信、訂單、繳費統計、撥款、雲帳戶、黑名單、商戶資訊），無法快速取號或申請代付 |
這些只是「預設值」
上表是系統首次建立內建角色時播種的預設權限。站主隨時可在角色列表調整（root 除外），調整後即以實際設定為準。例如要讓 systemAdmin 能管理 TG 機器人，只要把 telegram.* 勾給它即可。
除內建角色外，root 可自訂角色並精細配置每個功能模組的存取權限。建立自訂角色時需指定角色類型，系統商類型的角色只能存取系統後台功能，商戶類型的角色只能存取商戶後台功能。
TIP
root 角色由系統擁有者預設建立，不可編輯或刪除。站主日常操作建議使用 systemAdmin 角色。
選單總覽
| 選單 | 說明 | 快捷鍵 |
|---|---|---|
| 儀表板 | 當日營收概覽、圖表統計、日期對比 | 1 |
| 系統管理 | 站內信發送、黑名單管理、TG 機器人（通知+指令+廣播）、VPN 管理（站點限定）、通道列表（站點限定）、操作手冊 | 2 |
| 爬蟲管理 | 腳本配置（銀行網銀爬蟲部署與連線管理）；站點限定 | - |
| 權限管理 | 角色權限配置、操作歷程稽核 | 3 |
| 用戶管理 | 系統/商戶管理員帳號管理、登入歷程 | 4 |
| 商戶管理 | 商戶資料、API 串接歷程、通道切換歷程、代理推廣（站點限定） | 5 |
| 資料查詢 | 超商/ATM/信用卡/幣商訂單查詢、繳費統計 | 6 |
| 撥款入帳 | 依規則下撥、自訂下撥、撥款歷程 | 7 |
| 帳務管理 | 代付審核、雲帳戶管理 | 8 |
| 發票管理 | 電子發票開立與歷程查詢 | 9 |
| 行事曆 | 國定假日設定（影響撥款計算） | 0 |
操作手冊
系統管理選單中的「操作手冊」（快捷鍵 2 → H）為外部連結，點擊會在新分頁開啟本文件站（wt-docs.pages.dev）。
站點限定功能
部分功能為 站點客製化，只會在有啟用的站點出現。未啟用的站點不會顯示對應的選單、無法存取路由，角色列表的權限編輯彈窗中也不會出現相關權限。
| 功能 | 說明 |
|---|---|
| 通道列表 | 金流供應商的集中管理介面 |
| 代理推廣 | 推廣碼與建站申請管理 |
| 腳本配置 | 銀行網銀爬蟲部署與連線管理 |
| VPN 管理 | Outline VPN 金鑰管理與 IP 輪換 |
| 訂單退款 | 將已付款訂單標記為已退款 |
| 雙人審核 | 下撥與雲帳戶調帳需另一位管理員核准 |
| 代付時段金額區間 | 每個商戶可設定不同時段的代付金額限制 |
| 假資料綁定商戶／地址類型 | 假資料可綁定指定商戶，並支援地址類型 |
| 收銀台三段條碼連結 | 收銀台超商繳費區塊提供條碼連結按鈕 |
| 卡對卡自動下撥 | CTCPAY 訂單繳費完成後自動結算至雲帳戶 |
| 超商自動下撥 | 超商訂單繳費完成後自動結算至雲帳戶（商戶層級開關） |
| 卡對卡雙錢包 | 卡對卡下撥獨立為「卡卡錢包」，與主錢包分離，可互轉 |
| 顯示設定 | 側邊欄底部可調整介面密度與文字大小（站點限定） |
| 顯示欄位 | 訂單查詢頁與通道列表可自選要顯示哪些表格欄位（所有站點皆可使用） |
| 訂單篩選含已停用通道 | 「服務通道」下拉會一併列出已停用的卡，查得到那些卡的歷史訂單 |
| 點通道快速篩選 | 訂單表格上的「服務通道」可點，直接套進篩選並重查 |
| 合計費用 | 訂單查詢頁與代付審核頁的統計列多一格「合計費用」＝手續費＋服務費 |
| 代付通道統計 | 通道列表多出「代付筆數／代付金額」兩欄，代付審核可指定用哪張卡出款 |
| 通道列表收款欄位近期優先 | 四個收款欄位改成今日／最近／昨日／累積的順序 |
| ATM 補登合併帳號 | 人工補登的銀行代碼與帳號併成一欄，可直接貼「代碼-帳號」 |
| 商戶後台快速取號開關 | 可逐商戶決定商戶後台要不要顯示快速取號 |
| 代收開關歷程 | 查詢誰在什麼時候把哪個商戶的超商／ATM／信用卡開關開或關 |
| 通道限額記憶 | 配置商戶時帶出這張卡上次設定過的限額 |
| 代收 API 付款人 Email 選填 | 建單時可不帶付款人 Email（姓名與手機仍必填） |
TIP
若不確定目前站點啟用了哪些功能，最直接的判斷方式是查看側邊欄選單以及角色權限編輯彈窗中出現的項目。
頁首功能
| 功能 | 說明 |
|---|---|
| 語系切換 | 繁中 / 簡中 / English / 越南語 / 泰語 / 日語 / 韓語（共 7 種） |
| 代付待審 badge | 紅色數字顯示待審核代付數量，點擊跳轉代付審核頁 |
| 使用者名稱 | 直接顯示於頁首，旁邊附帶個人資料圖示 |
| 個人資料圖示 | 圓形使用者圖示（circle-user），點擊開啟 Popover 顯示：當前 IP 位址（透過 ipify API 取得）、Google 2FA 驗證狀態（已啟用/未啟用 badge，點擊可管理設定） |
| 登出 | 登出系統後台 |
側邊欄 Logo 右側的商店圖示可一鍵另開商戶後台（新分頁）。
側邊欄功能
| 功能 | 說明 |
|---|---|
| 主題切換 | 深色 / 淺色模式切換按鈕，位於側邊欄底部 |
| 收合按鈕 | 收合/展開側邊欄，與主題切換按鈕並排於底部 |
| 顯示設定（站點限定） | 調整介面密度與文字大小，位於側邊欄底部第三顆（滑桿圖示） |
側邊欄收合時，底部的按鈕會改為垂直堆疊排列。
顯示設定
僅在特定站點啟用
其他站點的側邊欄不會出現這顆按鈕。
點側邊欄底部的滑桿圖示可開啟顯示設定，裡面是兩個互不影響的調整項：
| 項目 | 拉桿段數 | 影響範圍 |
|---|---|---|
| 介面密度 | 5 段，最左為預設 | 只縮小留白、行高與元件高度，文字與操作圖示大小完全不變 |
| 文字大小 | 4 段，左起第 2 段為預設 | 整個介面等比放大或縮小，文字、圖示、Badge 一起跟著變 |
兩項都是拉桿，往右拉越緊湊／字越大。拉桿兩端的圖示標示方向， 軌道上的切口對齊每一個可停的位置（滑桿會剛好停在切口或軌道兩端）， 數「兩端＋中間的切口」就是總共幾段。 右上角的箭頭圖示可一鍵回到預設（維持在預設時該按鈕呈淡色）。
視窗高度不足、一頁看不到幾筆資料時，請調「介面密度」而不是用瀏覽器縮放 —— 瀏覽器縮放會把文字一起縮小到看不清楚，改成緊湊密度則能在文字維持原大小的前提下， 把篩選區、表格列高與欄與欄之間的間距一起壓縮。以訂單查詢頁為例，同一個視窗的可見資料列 可從 3 列一路增加到 10 列，而表格內文全程維持原本的大小。
覺得字偏小或偏大時再調「文字大小」，兩項可以自由搭配 —— 例如「文字放大 ＋ 最緊湊」就是字看得清楚、同時盡量多塞資料。
密度只會壓縮留白，不會動到「裝東西的容器」：操作欄的圖示、狀態標籤、開關、 快捷鍵提示、下拉選單的寬度都維持原本大小，調到最緊湊一樣看得清楚、點得到， 文字也不會被切掉。
兩項設定即點即生效、自動記住，只記在目前這台電腦的瀏覽器，不會跟著帳號跑， 也不影響其他使用者。系統後台與商戶後台各自記憶。按「重設」可回到預設值。
顯示欄位
訂單查詢頁（超商／ATM／信用卡／幣商）與通道列表表格上方那一行的右側 有「顯示欄位」，可取消勾選用不到的欄位把它收起來。
所有站點皆可使用
這個功能與上方的「顯示設定」是各自獨立的兩件事，不受站點限定： 它只調整你自己畫面上要看哪幾欄，不改資料、不改權限，也不影響其他人看到的內容。
視窗較窄時表格欄位多，一定得左右拖才看得完 —— 欄位寬度是由內容（訂單號、帳號） 撐出來的，調密度或文字大小都無法讓表格變窄，只有收起欄位有效。 收起來的欄位隨時能再打開，資料與操作按鈕都還在原處；每種付款方式各自記憶， ATM 訂單頁收起來的欄位不影響超商訂單頁。至少會保留一個欄位，不會出現空表格。
訂單查詢頁預設不收起任何欄位，沒有動過這個設定的話，表格與這個功能加入前完全一樣。 通道列表則預設先收起「參考餘額」（那是人工填的參考值，卻卡在最右邊把整張表撐寬）， 想看的時候勾回來即可 —— 只要動過一次，之後就完全以你自己的設定為準。
表格框選複製
訂單列（以及其他可展開明細的表格列）點一下會展開明細。想複製格子裡的文字時， 用滑鼠框選該列的內容不會再誤觸展開，放開滑鼠就只是選取，可以直接複製。
- 只有「框選範圍落在這一列裡」才會擋，在別列選過文字之後再點這一列，照樣正常展開
- 單純點一下不會產生選取範圍，展開行為完全不變
- 列上的按鈕、連結、輸入框本來就不算「點這一列」
快捷鍵操作
- 按下數字鍵
1~0可快速展開對應選單群組 - 展開後按字母鍵（如
A、S、D）可直接切換至子頁面 - 按
[鍵可收合/展開側邊欄
即時通知
系統後台透過 WebSocket 即時推送以下事件：
- 代付申請通知：商戶提交代付申請時，側邊欄「代付資料審核」會顯示紅色 badge 數字，並播放提示音
- 下撥 badge 更新：超商/ATM/信用卡下撥選單項目會顯示待下撥訂單數量。badge 數字會考慮每個商戶的撥款天數規則（T+N 營業日 / D+N 曆日）與國定假日設定，僅顯示今日可實際撥款的訂單數
- 訂單狀態變更：訂單查詢頁面的訂單狀態會即時更新，無需手動刷新
閒置自動登出
系統後台與商戶後台均支援閒置自動登出功能。當使用者超過 1 小時 無任何操作（滑鼠移動、鍵盤輸入、點擊等），系統會自動登出並顯示提示訊息。此機制保護帳號安全，防止未鎖定的裝置被他人使用。
二階段驗證（2FA）
系統支援 TOTP 二階段驗證，建議所有管理員帳號啟用。以下操作需要 2FA 驗證碼：
- 商戶 API Secret 重新產生
- 刪除訂單
- 刪除代理推廣申請