Appearance
資金明細（開發文檔）
最後更新：2026-04-10
📖 功能說明請參考 資金明細
架構
相關檔案
ViewController（2 個）
| 檔案 | 說明 |
|---|---|
.../MiddleMenu/C/CapitalListViewController.swift | 資金明細列表 |
.../MiddleMenu/C/CaptialDetailViewController.swift | 資金詳情 |
基礎路徑：
BBSport/Tab/我的/Mine/
ViewModel（3 個）
| 檔案 | 說明 |
|---|---|
.../MiddleMenu/VM/CapitalListViewModel.swift | 列表 ViewModel |
.../MiddleMenu/VM/CaptialDetailViewModel.swift | 詳情 ViewModel |
.../MiddleMenu/VM/BBCapitalCellViewModel.swift | Cell ViewModel |
基礎路徑：
BBSport/Tab/我的/Mine/
Model（5 個）
| 檔案 | 說明 |
|---|---|
.../MiddleMenu/M/BBCapitaDetailModel.swift | 資金詳情 |
.../MiddleMenu/M/BBGeneralInfoManager.swift | 通用資訊管理 |
.../MiddleMenu/M/BBWithDoawSplitModel.swift | 提款拆單 |
.../MiddleMenu/M/CapitaTypeListModel.swift | 交易類型列表 |
.../MiddleMenu/M/BBNoticeReplayModel.swift | 回覆通知 |
基礎路徑：
BBSport/Tab/我的/Mine/
Model — 其他（2 個）
| 檔案 | 說明 |
|---|---|
.../MiddleMenu/M/CapitaTypeModel.swift | 交易類型 |
.../MiddleMenu/M/TradingStatus.swift | 交易狀態 |
基礎路徑：
BBSport/Tab/我的/Mine/
View（5 個）
| 檔案 | 說明 |
|---|---|
.../MiddleMenu/V/CapitalScreenView.swift | 資金篩選 |
.../MiddleMenu/V/CaptialDetailInfoCell.swift | 詳情資訊 Cell |
.../MiddleMenu/V/CaptialDetailTableViewCell.swift | 詳情列表 Cell |
.../MiddleMenu/V/TabSelectView.swift | Tab 選擇 |
.../MiddleMenu/V/TradingStatusButton.swift | 交易狀態按鈕 |
基礎路徑：
BBSport/Tab/我的/Mine/
API Request（3 個）
| 檔案 | 說明 |
|---|---|
BBSport/API/STAPI/CapitalDetail/STAPI+BalanceTypeListRequest.swift | 交易類型列表（/balance/type/list） |
BBSport/API/STAPI/CapitalDetail/STAPI+CapitalDetailListRequest.swift | 資金明細列表（/balance/list） |
BBSport/API/STAPI/CapitalDetail/STAPI+SplitOrderRequest.swift | 拆單明細（/balance/load/withdraw/splitOrder） |
API
列表查詢
交易類型列表
POST api/forehead/data/balance/type/list — urlForm — STAPI.BalanceTypeListRequest
用途
動態載入篩選器中的交易類型選項。
無參數，靠 Header token/uid 認證。
Response： data: [CapitaTypeModel]
| 欄位 | 型別 | 說明 |
|---|---|---|
| txId | Int | 交易類型代碼 |
| txName | String | 類型名稱（充值/提現/轉帳/紅利/返水等） |
資金明細列表
POST api/forehead/data/balance/list — urlForm — STAPI
Request：
| 參數 | 型別 | 必填 | 說明 |
|---|---|---|---|
| transactionType | string | ✅ | 交易類型：1=存款, 2=提現, 3=轉帳, 4=紅利, 5=返水, 6=提現退回, 8=上級轉入, 10=減幣, 14=全部 |
| startTime | string | ✅ | 開始時間（yyyy-MM-dd HH:mm:ss） |
| endTime | string | ✅ | 截止時間（yyyy-MM-dd HH:mm:ss） |
| transactionStatus | string | ✅ | -1=全部, 0=處理中, 1=成功, 2=失敗 |
| page | int | ✅ | 頁碼（從 1 開始） |
| size | int | ✅ | 每頁筆數 |
Response：
| 欄位 | 型別 | 說明 |
|---|---|---|
| total | Int | 總筆數 |
| list | [BBCapitaDetailListModel] | 交易記錄列表 |
BBCapitaDetailListModel 完整欄位
| 欄位 | 型別 | 說明 |
|---|---|---|
| transactionType | Int | 交易類型 ID |
| transactionTypeName | String | 交易類型名稱 |
| transactionDate | Int | 交易時間（timestamp） |
| transactionAmount | Double | 交易金額 |
| actualAmountStr | String | 實際到帳金額（字串） |
| afterBalance | Double | 帳變後餘額 |
| beforeBalance | Double | 帳變前餘額 |
| status | Int | 狀態（0=處理中, 1=成功, 2=失敗） |
| orderId | String | 流水號 |
| fee | Double | 手續費 |
| totalFee | Double | 總手續費 |
| reallyAmount | Double | 實際到帳金額 |
| subType | String | 詳情描述 |
| subTypeId | Int | 詳情 ID |
| extra | BBWithDoawSplitModel? | 拆單資訊（splitType 等） |
拆單明細
POST api/forehead/data/balance/load/withdraw/splitOrder — urlForm — STAPI
用途
點擊拆單記錄（extra.splitType == "1"）時載入子訂單。
| 參數 | 型別 | 必填 | 說明 |
|---|---|---|---|
| orderId | string | ✅ | 訂單 ID |
Response： data: [BBCapitaDetailListModel]，結構同資金明細列表。
資料模型速查
TradingStatus 枚舉
| Case | rawValue | 說明 |
|---|---|---|
.all | "-1" | 全部 |
.processing | "0" | 處理中 |
.success | "1" | 成功 |
.failed | "2" | 失敗 |
來源：
BBSport/Tab/我的/Mine/MiddleMenu/M/TradingStatus.swift
實作重點
- 分頁載入：Cell 高度固定 64pt；分頁 size 默認 100（
CapitalListViewModel.size = 100）；若回傳筆數 < 10 → 自動載入下一頁 - 篩選器：交易類型由
BalanceTypeListRequest動態取得，支援多選 - 撤銷充值訂單：監聽
STNotify.cancelOrder→ 執行撤銷邏輯 - 夜間模式：監聯
STNotify.NIGHT_PATTERN_OPEN→ 更新空狀態圖示顏色
關鍵數字
- Cell 高度固定 64pt
- 分頁 size 默認 100
- 分頁閾值：回傳筆數 < 10 自動載入下一頁