本資料夾保存 Arova Nexus 的重大架構決策紀錄。每個 ADR 用於追溯「為什麼當初選這個方案」，避免日後重複爭論或忘記約束。

原則

• 一個決策一份 ADR；新決策取代舊決策時，舊 ADR 標記為 Superseded by ADR-N，內容不刪除
• 格式固定：背景 → 決策 → 理由 → 替代方案 → 影響
• 狀態追蹤：提議（Proposed）→ 已採納（Accepted）→ 已廢棄（Deprecated / Superseded）
• 寫作對象：一年後接手的新架構師，他不在場時需要能看懂

索引

何時該寫 ADR

觸發點範例：

• 引入新的核心依賴（框架、資料庫、MQ）
• 改變資料流方向（如從同步改非同步）
• 非典型的技術選擇（不用主流方案）
• 與 PRD 約束相關的技術折衷

ADR 模板

# ADR-N: [決策標題]

**狀態：** 提議 / 已採納 / 已廢棄 / Superseded by ADR-M
**日期：** YYYY-MM-DD
**決策者：** [角色 / 人名]

## 背景
為什麼需要做這個決策？現狀是什麼？

## 決策
我們決定 [明確的選擇]。

## 理由
為什麼選這個方案？和產品約束（On-Prem First / 模組化 / Event-Centric）如何對應？

## 考慮過的替代方案

| 方案 | 優點 | 缺點 |
|------|------|------|

## 影響

### 正面
- ...

### 負面 / 取捨
- ...

### 需要追蹤的風險
- ...