# SCS-021　系統效能與非功能（Performance／NFR）程式設計規格（跨域）

| 項目 | 內容 |
|---|---|
| 文件編號 | SCS-021 |
| 版本 | 1.0 |
| 狀態 | **已核定（規格先行·跨域）** |
| 對應需求 | `BRD-003` 效能（授權 P99 ≤ 200ms 等）、吞吐（≥ 1,000 TPS）、容量規劃、效能測試（12 項，對應 `TRP-001 §10`） |
| 技術棧 | Java 21 + Spring Boot 4.1.1（參 `CSP-006`）；Redis 8 快取；Kafka 4.3.1 非同步；Oracle 權威＋Postgres 讀模型（CQRS） |
| 關聯文件 | `BRD-003`、`SAD-006 §4`（容量）、`TRP-001 §10`、`CSP-006` |

---

## 1. 對應需求（效能類 NFR，實測目標值）

| 類別 | 指標 | 目標 | 來源 |
|---|---|---|---|
| 效能 | 本行卡授權處理 P99 | ≤ 200 ms | `BRD-003`（G4／G5） |
| 效能 | 交易路由決策 P99 | ≤ 5 ms | `BRD-003`（G4／G5） |
| 效能 | 端到端授權（含機構往返）P95 | ≤ 500 ms | `BRD-003`（G5） |
| 吞吐 | 授權交易（未分庫分表） | ≥ 1,000 TPS | `BRD-003`（G5） |
| 吞吐 | 即時支付引擎 | > 2,000 TPS | `BRD-003`（G5） |

> 其餘 NFR（可用性、容量規劃 3 項、效能測試 12 項）見 `BRD-003` 完整追蹤表，均對應 `SAD-006` 與 `TRP-001 §10`。

---

## 2. 效能設計策略

| 策略 | 說明 | 對應技術 |
|---|---|---|
| **快取** | 高頻讀取（產品參數、額度、卡狀態）經 Redis 8 快取，降低 Oracle 壓力 | Redis 8（`CSP-006`） |
| **連線池** | HikariCP 連線池調校，避免連線耗盡 | Spring Boot 4.1.1 |
| **非同步** | 通知、點數、對帳經 Kafka 事件解耦，削峰 | Kafka 4.3.1（`CSP-006`） |
| **CQRS 讀寫分離** | 寫側 Oracle（`CC_*`）；讀側 Postgres（`proj`/`rpt`）承接高頻查詢 | `SAD-003 §9` |
| **Saga 協調** | 跨服務長事務經 `common-saga` 狀態機，避免分散式鎖定 | `common-saga` |
| **閘道限流** | `api-gateway`（8100）限流／熔斷，保護下游 | Spring Cloud 2025.1.3 |

---

## 3. 關鍵路徑效能目標

- **授權路徑**：`api-gateway` → `bff` → `authorization-service` →（快取命中）本地決策；P99 ≤ 200ms。Stand-in 降級時仍須維持目標（`SCS-001` §8）。
- **路由決策**：≤ 5ms（純記憶體／快取查詢）。
- **端到端**：含機構（VISA/MC/NCCC）往返 P95 ≤ 500ms。

---

## 4. 容量與壓測

- 容量模型：`SAD-006 §4`（容量規劃，對應 `BRD-003` 容量規劃 3 項）。
- 壓測：依 `TRP-001 §10` 效能測試（12 項）產出 P95／P99 曲線，對比 §1 門檻。
- 線性擴展：領域服務無狀態，橫向擴展（K8s HPA）因應 TPS 目標。

---

## 5. 測試案例（對應 `TRP-001 §10`）

- 授權 P99／P95 壓測（`BRD-003` 效能目標）
- 吞吐測試（≥ 1,000 TPS 授權、> 2,000 TPS 即時支付）
- 快取失效／下游降級下的效能退化邊界

---

## 6. 已知限制（誠實揭露）

- 上表 **≤ 200ms／≤ 500ms／≥ 1,000 TPS** 為 `BRD-003` 目標值；實測須待服務實作後壓測驗證，目前尚無實測數據（規格先行）。
- 分庫分表（sharding）與否影響吞吐上限（`BRD-003` 註「未分庫分表」前提下 ≥ 1,000 TPS），若客戶要求更高須提 CR。
- 容量模型（`SAD-006 §4`）之具體假設（成長率、尖峰因子）待 SA 凍結。