Stoxer App
更新日期：2026-08-11（修訂：2026-09-03）
跨券商 CSV 交易明細整合：多源數據欄位映射與統一數據結構實作
說明 Stoxer App 系統中，股票明細（CSV）匯入對應邏輯與四種核心交易分類，並提供網頁動態互動體驗區，供用戶練習對照。
一、 股票明細（CSV）資料對應與分類概念解析
在個人投資帳務管理中，每家券商或銀行輸出的 CSV 交易明細格式不盡相同。例如「AA證券」可能標註「成交日期」，而「BB證券」標註「交易日」；描述買賣動作時，有些系統寫「現股買進」，有些寫「整股買入」。
為了讓 Stoxer App 能整理計算持股成本與帳戶餘額，CSV 匯入機制採用了兩層對應原理：
📋 1. 明細欄位對應 (Column Mapping)
將 CSV 的直欄標頭（如「成交價」）對號入座連結至系統目標欄位（如「成交單價」）。費用欄位（如手續費與證交稅）更支援將多個欄位同時拖入加總。
🏷️ 2. 交易內容對應 (Value Mapping)
將 CSV 內的原始交易中文字（如「除息發放」）歸類至系統四種核心帳務類型中，以確保庫存股數與現金帳務正確計算。
系統四種核心帳務類型說明：
📈 買賣交易 (Stock Trading)
一般買進、賣出、當沖、零股與申購。連動庫存數量、成本與賣出已實現損益。
💵 股利股息 (Dividend)
現金股利、配息與借券利息。增加現金餘額並歸類至專屬股利統計，不變動庫存。
🏦 存入款項 (Deposit)
資金匯入、存款利息與獎金回饋。單純增加帳戶可用現金，不影響股票庫存。
💸 提出款項 (Withdrawal)
資金出金、ATM 提款與手續費扣款。單純減少帳戶可用現金。
二、 動態範例：明細欄位拖曳對應練習
請試著將下方原始 CSV 標頭欄位（灰色卡片），使用滑鼠拖曳（或點擊選取）移至右側對應的「系統目標欄位」：
🎯 練習 1：股票明細 CSV 表頭對照
對應進度: 0 / 8
待對應的 CSV 標頭（可拖曳或點擊後放置）：
交易日期 / 除權息日
Trade Date / 成交日期
拖曳或點擊放置至此
交易類別
Trade Type / 交易種類
拖曳或點擊放置至此
應收付帳款
Net Settlement Amount
拖曳或點擊放置至此
股票代號
Stock Symbol / 代碼
拖曳或點擊放置至此
成交股數
Volume / 成交量
拖曳或點擊放置至此
成交單價
Unit Price / 成交價
拖曳或點擊放置至此
交易成本 (支援多欄位加總)
可將手續費與證券交易稅同時拖入加總
拖曳手續費或稅金等欄位至此...
🎉 太棒了！您已成功完成明細欄位對應練習！
三、 動態範例：交易內容分類拖曳對應練習
請將下方股票明細出現的原始交易描述字串（灰色卡片），分類拖曳至正確的「四種系統核心類型」方格中：
🏷️ 練習 2：交易明細描述分類
對應進度: 0 / 8
待分類的交易明細描述字串（可拖曳或點擊後放置）：
📈 1. 買賣交易 (stockTrading)
已分類 0 項
拖曳買賣、當沖等字串至此...
💵 2. 股利股息 (dividend)
已分類 0 項
拖曳股利、配息、借券利息至此...
🏦 3. 存入款項 (deposit)
已分類 0 項
拖曳入金、存款利息至此...
💸 4. 提出款項 (withdrawal)
已分類 0 項
拖曳出金、提款、扣款至此...
🎉 恭喜！您已成功完成交易描述分類練習！