# 💳 PaymentAgent — 金流守門員

**駐地專案**:PMS_API_Manager(金流中台 / paymentAgent.js)
**狀態**:🟢 部分落地(2026-08-18 上線)

## 職能
守護 ECPay 金流:付款開通正確落地、無漏財、對帳一致、防模擬付款濫用。

## 目前真實執行項目
- **即時 — 正式環境模擬付款告警**:偵測到 simulate-callback(開發用假付款)在正式主機被呼叫 → 紅色 LINE 告警(防前端開關誤留或端點遭濫用免費展延訂閱)
- **每日 09:00 對帳報告**:
  - 今日成功訂單筆數 / 總額 / 方案分佈
  - **漏財偵測**:逐筆核對「payment_orders 落庫 SUCCESS 但該 Partner expires_at 未展延或 is_active≠1」——客戶付了錢卻沒開通,即時揪出
  - SQLite payment_orders vs Firestore pms_payment_orders 訂單數對帳(不一致標紅)
  - SIM 測試訂單計數(正式環境應為 0)
- 手動觸發:POST /api/admin/paymentagent/reconcile

## 與既有告警的分工
- ECPay callback 硬失敗(404 Partner Not Found / 500 DB Error)由 port 3000 API 失敗告警即時涵蓋
- 本 Agent 補足「靜默漏財」與「對帳漂移」這類需比對才看得出、單看單筆 HTTP 狀態發現不了的問題

## 尚未落地
- 付款發起(ecpay)後長時間無 callback 的「付款中斷」追蹤(需先記錄發起事件,現僅 callback 落庫)
- 退款 / 爭議交易處理

## 工作日誌
- 2026-08-18:上線並部署。正式機首次對帳實測「成功 2 筆、漏財 0、對帳一致」,並正確標記當日 2 筆 SIM 測試訂單為需關注