SAD-001　系統架構總覽

1. 架構目標與原則

1.1 架構目標

1.2 架構原則（Architecture Principles）

2. 系統上下文（Context View）

flowchart LR
  HOLDER["持卡人"]
  MERCHANT["特店與收單機構"]
  ORG["卡組織<br/>VISA / MasterCard / NCCC / JCB / AE"]
  TICKET["票證公司<br/>悠遊卡 / 一卡通 / 愛金卡"]

  subgraph SYS["信用卡核心系統（本專案）"]
    GW["API 閘道"]
    SVC["17 個微服務"]
    GW --> SVC
  end

  CREDIT["徵信與徵審系統"]
  CORE["銀行核心系統<br/>CIF / 存款"]
  GL["總帳系統"]
  HSM["HSM 加密機"]
  NOTIFY["通知通道<br/>簡訊 / 電郵 / 推播 / LINE"]
  CHANNEL["數位通路<br/>行動銀行 / 網銀 / 客服系統"]

  HOLDER --> CHANNEL
  CHANNEL --> GW
  MERCHANT --> SVC
  ORG --> SVC
  TICKET --> SVC
  SVC --> CREDIT
  SVC --> CORE
  SVC --> GL
  SVC --> HSM
  SVC --> NOTIFY

3. 容器視圖（Container View）

flowchart TD
  subgraph CLIENT["前端"]
    WEB["營運管理平台<br/>React 18 + Vite"]
  end
  subgraph EDGE["邊緣層"]
    GW["API 閘道<br/>路由 / 認證 / 限流"]
    BFF["BFF<br/>前端專用聚合"]
  end
  subgraph DOMAIN["領域服務層"]
    AUTH["authorization-service"]
    LIM["limit-service"]
    CARD["card-service"]
    PTY["party-service"]
    PRD["product-service"]
    POST["posting-service"]
    PAY["payment-service"]
  end
  subgraph SUPPORT["支撐服務層"]
    STM["statement-service"]
    PRC["pricing-service"]
    INS["installment-service"]
    RWD["rewards-service"]
    CLR["clearing-service"]
    DSP["dispute-service"]
    MRC["merchant-service"]
    NOT["notification-service"]
    RPT["report-service"]
    MIG["migration-service"]
  end
  subgraph INFRA["基礎設施"]
    BUS["事件匯流<br/>Kafka"]
    WDB["寫入資料庫<br/>PostgreSQL"]
    RDB["讀取資料庫<br/>PostgreSQL"]
    CACHE["快取<br/>Redis"]
    OBS["可觀測性<br/>日誌 / 指標 / 追蹤"]
  end
  WEB --> GW
  GW --> BFF
  BFF --> AUTH
  BFF --> LIM
  BFF --> CARD
  BFF --> PTY
  BFF --> PRD
  BFF --> POST
  BFF --> PAY
  BFF --> STM
  BFF --> PRC
  BFF --> INS
  BFF --> RWD
  BFF --> CLR
  BFF --> DSP
  BFF --> MRC
  BFF --> NOT
  BFF --> RPT
  BFF --> MIG
  DOMAIN --> BUS
  SUPPORT --> BUS
  DOMAIN --> WDB
  DOMAIN --> RDB
  DOMAIN --> CACHE
  SUPPORT --> WDB
  BUS --> OBS

3.1 容器職責

4. 分層架構（每個微服務內部）

採六角形架構（Ports & Adapters），依賴方向一律向內：

flowchart TD
  subgraph OUT["外部"]
    HTTP["HTTP 請求"]
    EVT["事件"]
    DB["資料庫"]
    EXT["外部系統"]
  end
  subgraph IFACE["interfaces（介面層）"]
    CTRL["REST Controller"]
    CONS["Event Consumer"]
  end
  subgraph APP["application（應用層）"]
    UC["Use Case / 服務編排"]
    TX["交易邊界"]
  end
  subgraph DOM["domain（領域層）"]
    ENT["Entity / Aggregate"]
    VO["Value Object"]
    RULE["業務規則"]
    EV["Domain Event"]
  end
  subgraph INFRA2["infrastructure（基礎層）"]
    REPO["Repository 實作"]
    PUB["Event Publisher"]
    ADP["外部系統適配器"]
    OBX["Outbox"]
  end
  HTTP --> CTRL
  EVT --> CONS
  CTRL --> UC
  CONS --> UC
  UC --> ENT
  UC --> RULE
  UC --> REPO
  UC --> PUB
  REPO --> DB
  ADP --> EXT
  PUB --> OBX

4.1 依賴規則（強制）

違反 DR-01～DR-05 由 CSP-002 §5 之依賴掃描於 CI 阻擋。

5. 關鍵架構決策（ADR 摘要）

6. 品質屬性與架構戰術

7. 技術棧與埠／轉接器對照

7.1 技術棧（參考實作棧）

選型理由：① 可於本環境立即建置與測試（本機無 Java／Maven／Docker daemon）；
② 與雲原生、容器化部署一致；③ 契約（OpenAPI）與事件（JSON Schema）皆語言中立。

7.2 埠／轉接器對照表（若業主指定 Java 21 + Spring Boot 3）

本架構之領域層與契約層不受技術棧影響。切換技術棧時僅需替換基礎層轉接器：

決策點：實際開發環境由業主於程式撰寫階段指定（GOV-003 §4 條件 8）。
無論選用何者，SDD-000~007 之設計與 SDD-006 之 API 契約均不需變更。

8. 架構檢核