Appearance
操作歷程
路徑：/admin/permissions/list | 快捷鍵：3 → K
操作歷程記錄系統中所有管理員的操作行為，作為安全稽核依據。每一筆操作都會記錄執行者、時間、IP 位址及裝置資訊。
篩選條件
| 篩選項目 | 說明 |
|---|---|
| 排除系統操作 | 篩選列第一格的開關，預設開啟。開啟時只列出「人」做的操作，濾掉系統自動執行（例如自動撥款批次）留下的紀錄；關掉即可看到全部。切換後立即重新查詢，不必再按查詢 |
| 日期範圍 | 日期範圍，預設為今日。附「本日 / 昨日 / 本周 / 本月」快捷按鈕 |
| 操作者 | 依管理員名稱模糊搜尋 |
| 操作 | 下拉選單篩選特定操作類型，選項依本站啟用的功能列出（未啟用的站點限定功能不會出現在選單中） |
| IP | 依 IP 位址模糊搜尋（支援 IPv4 與 IPv6） |
找不到某筆自動撥款的紀錄？
「排除系統操作」預設是開的，操作者為「系統」的紀錄不會出現在列表與匯出檔中。要查自動跑批留下的紀錄，先把開關關掉。
頁面說明
頁面顯示一個表格，採用無限捲動載入（每次 50 筆，滾動至底部自動載入更多），欄位如下：
| 欄位 | 說明 |
|---|---|
| 時間 | 操作發生的日期時間 |
| 操作者 | 執行操作的管理員名稱；系統自動執行的操作顯示「系統」 |
| 操作 | 操作類型，已翻譯為中文並以顏色標籤區分 |
| 對象 | 這次操作是對誰做的，例如「商戶 某某商戶: M001」「通道 …」「代付單 …」。前面灰色小字是對象類型，後面是名稱；滑鼠移上去可看完整原始內容。針對整個模組、沒有特定對象的操作只顯示類型 |
| IP | 操作者的 IP 位址 |
| 裝置 | 從 User-Agent 解析的瀏覽器與作業系統資訊 |
| 指紋 | 瀏覽器指紋識別碼 |
| 詳情 | 點擊眼睛圖示檢視完整操作細節（每一列都有此按鈕） |
對象欄的名稱
- 商戶同時顯示名稱與商戶代碼（
名稱: 代碼），名稱是操作當下的名稱 —— 商戶事後改名，舊紀錄仍保留當時的名字，方便對照 - 通道、卡片、代付單、撥款批次同樣帶有名稱或單號，不再只有一串 id
- 功能加入前的舊紀錄已由系統補上說明；補不到名稱的舊紀錄會只顯示 id
動作顏色標籤
顏色由操作代碼自動判斷：
| 顏色 | 動作類型 |
|---|---|
| 🟢 綠色 | 代碼含 create（建立類） |
| 🟡 黃色 | 代碼含 update（更新類） |
| 🔴 紅色 | 代碼含 delete（刪除類） |
| 🔵 藍色 | 其他操作（審核、匯入、同步、撥款等） |
記錄的操作範圍
操作歷程不只涵蓋權限相關動作，而是記錄全站的敏感操作，包含：
| 類別 | 代表性操作 |
|---|---|
| 帳號與角色 | 建立／更新／刪除使用者、解鎖帳號、建立／更新／刪除角色、更新角色權限 |
| 商戶 | 建立／更新／刪除商戶、重新產生商戶金鑰、商戶排序 |
| 訂單 | 人工確認訂單、刪除訂單、補發訂單回調、修改訂單繳費資訊、訂單退款（站點限定） |
| 代付通道（站點限定） | 事後修改代付單的代付通道（通道列表的代付統計一併轉移） |
| 代付 | 建立代付、審核通過／駁回／人工退回、補發回調、上傳憑證、複製紀錄 |
| 代付備註 | 新增／更新／刪除／匯入代付帳號註記（「同步」僅見於過去跨站同步留下的舊紀錄） |
| 通道 | 建立／更新／刪除通道、批次儲存、重置通道額度 |
| 通道列表（站點限定） | 通道列表的新增／更新／刪除／批次啟停，以及從通道列表為商戶配置、調整限額、移除通道 |
| 卡對卡通道轉移（站點限定） | 把卡對卡通道從一個商戶轉到另一個商戶 |
| 撥款與雲帳戶 | 批次撥款、雲帳戶入帳／扣款、錢包互轉、設定代付來源錢包、雲帳戶同步 |
| 雙人審核 | 雙人審核通過／駁回（站點限定） |
| 黑名單 | 新增／更新／刪除／匯入／批次匯入（「同步」僅見於過去跨站同步留下的舊紀錄） |
| 代理推廣 | 新增／更新／刪除推廣連結、系統餘額異動、設定本站費率、設定保底費用、開站（清空並標記營運中） |
| 代理佣金（站點限定） | 修改商戶的代理佣金 % |
檢視詳情
點擊某筆紀錄的眼睛圖示，會開啟詳情彈窗。彈窗由上而下分成三段：
- 一句話摘要：誰（操作者）、做了什麼（操作）、什麼時間，以及對象（類型＋名稱，旁邊附原始內容）
- 變更內容：依操作的種類自動排版
- 來源與原始資料：底部列出來源 IP、裝置與瀏覽器指紋；「原始資料」預設收合，點開可看完整的 JSON
變更內容的三種排版：
| 操作種類 | 顯示方式 |
|---|---|
| 修改某些欄位（例如編輯商戶） | 「項目／原本 → 改成」前後對照表，只列有變動的欄位 |
| 調整角色權限 | 只列出新增（綠色）與移除（紅色）的權限碼，沒動到的以「其餘 N 項未變動」一行帶過 |
| 其他（例如新增、刪除） | 「項目／內容」兩欄列表 |
- 欄位名稱會翻成中文，中文下方以灰色小字附上原始欄位名，方便技術人員對照
- 值也會翻成看得懂的文字（例如「已啟用／已停用／未設定」）
- 沒有額外資料的操作會顯示「這筆操作沒有額外資料」；格式無法解析的舊紀錄會直接顯示原文，不會變成空白
匯出 CSV
點擊 「匯出」 按鈕，可將所有操作歷程紀錄（上限 99,999 筆）匯出為 CSV 檔案。匯出沿用目前的篩選條件，包含「排除系統操作」開關。
匯出欄位：
| 欄位 | 說明 |
|---|---|
| 時間 | 操作日期時間 |
| 操作者 | 管理員名稱 |
| 操作 | 操作類型（已翻譯為中文） |
| 對象 | 操作對象（原始內容） |
| IP | IP 位址 |
| 裝置 | 瀏覽器/作業系統 |
| 指紋 | 瀏覽器指紋 |
| 詳情 | JSON 格式的完整細節 |
檔案命名格式：audit-logs-{日期}.csv
無限捲動
列表採用無限捲動載入，每次 50 筆，捲動至底部自動載入更多紀錄。
權限
| 權限代碼 | 說明 |
|---|---|
audit.read | 查看操作歷程頁面 |
audit.export | 匯出 CSV |