Banking 跨系統優化提案

1. 現況分析

三專案現況分工、跨系統痛點、整體資料流。

1.1 三專案角色

1.2 跨系統痛點

1.3 對比視覺

2. 優化目標架構

統一 Extension + HQ 雙向對帳 + 水位服務 + 異常 Dashboard。

藍=統一 Extension / 紫=HQ 服務 / 綠=資料層

2.1 關鍵改變

3. Phase 1：分支整合與統一

Week 1–2。風險最低、效益最快。

3.1 整合範圍

3.2 manifest 統一

• 合併後 content_scripts.js 清單加入 2 家新銀行
• permissions 補齊 storage、webNavigation（test 已有）
• run_at: document_end、all_frames: true 維持

3.3 驗收條件

• 12 家網銀 content script 載入無衝突
• popup 快速複製按鈕在 main 分支可用
• 原 main 的分頁 pause / 銀行 tab 管理保留

4. Phase 2：撥款狀態管控

Week 3–4。承接 auto_banking 原 proposal 的 Phase 2，此處為跨系統視角整合版。

4.1 五階段狀態機

// Extension 端（chrome.storage.local）
const TICKET_STATE = {
  UNFILLED:   'unfilled',    // 初始 → 5min 後 needs_speed
  FILLED:     'filled',      // FillForm 填入後
  RELEASING:  'releasing',   // 放行確認頁偵測到
  RELEASED:   'released',    // 放行結果頁偵測到成功
  CONFIRMED:  'confirmed',   // 出帳 bank_tx 配對成功
};

// HQ 端 EgopayApprM.status
const HQ_STATUS = {
  PENDING:    0,   // 待執行
  SUCCESS:    1,   // 成功
  FAILED:     2,   // 失敗
  FILLING:    3,   // 匯款中（新增）
};

4.2 三道防重複閘門

4.3 新增 HQ API

5. Phase 3：雙向對帳與賣單自動對帳

Week 5–7。此階段是 gamepp-web 從買單對帳延伸到賣單對帳的關鍵。

5.1 出帳資料打通

// Extension 各銀行 content script（移除入帳 filter）
tx.direction = tx.in > 0 ? 'in' : 'out';
records.push(tx);

// background.js 去重 key 加入 direction
const dedupKey = `${date}_${time}_${account}_${direction}_${amount}`;

// gamepp-web: AutoBankingC::receive_*（出帳寫入 bank_transactions）
if ($record['direction'] === 'out') {
    BankTransaction::create([
        'bank'                => $bank,
        'out'                 => $record['out'],
        'account'             => $record['account'],
        'balance'             => $record['balance'],
        'accounting_datetime' => $record['datetime'],
    ]);
    continue; // 不進 payment 配對，改入 appr 配對引擎
}

5.2 買單 + 賣單統一配對引擎

同一收集路徑，按 direction 分流到買單 / 賣單配對

• 買單（direction=in）：bank_tx.in + account + datetime → 比對 egopay_payments（現行邏輯）
• 賣單（direction=out）：bank_tx.out + account + datetime → 比對 egopay_apprs（新增）
• 未配對 → 進入異常清單（未開單入帳 / 重複匯款）

5.3 自動回填

5.4 DB Schema

ALTER TABLE bank_transactions
  ADD INDEX idx_bank_out_acctime (bank, out, accounting_datetime);

ALTER TABLE egopay_apprs
  ADD COLUMN bank_transaction_id BIGINT UNSIGNED NULL AFTER status,
  ADD INDEX idx_bank_tx (bank_transaction_id);

6. Phase 4：異常偵測

6.1 異常偵測引擎

7. 風險與緩解

跨系統整合必然涉及協同風險，以下為主要識別項。