chore:歸檔 api-performance-optimization，同步主規格

- 移至 openspec/changes/archive/2026-05-25-api-performance-optimization/
- 新增主規格：api-cache-layer、db-index-optimization
- 更新 review-lifecycle 規格（補分頁、eager load）

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

openspec/changes/archive/2026-05-25-api-performance-optimization/specs/review-lifecycle/spec.md

@@ -0,0 +1,29 @@
+## MODIFIED Requirements
+
+### Requirement: 評價公開顯示（匿名）
+
+任何人（含未登入）SHALL 能查看課程評價列表，評價人統一顯示為「匿名潛水者」。Provider 在 Coach Portal 亦可查看自己課程的評價（只讀）。評價列表 SHALL 支援分頁，預設每頁 20 筆，最大 50 筆。
+
+#### Scenario: 取得評價列表（含 summary，含分頁）
+
+- **WHEN** 任何人送出 `GET /api/diving-offers/{id}/reviews?sort=helpful|rating|newest&page=1&per_page=20`
+- **THEN** 系統回傳 `summary`（平均星等、總數、1–5 星分布）與分頁後的 `reviews` 列表；`reviewer_name` 一律為「匿名潛水者」；已登入 Member 額外回傳 `is_mine`；未登入 `has_voted` 固定為 `false`、`is_mine` 欄位省略；回傳包含分頁 meta（`current_page`、`last_page`、`per_page`、`total`）
+
+#### Scenario: per_page 超出上限時截斷
+
+- **WHEN** 請求帶有 `per_page=200`
+- **THEN** 系統以 `per_page=50` 處理，不回傳錯誤
+
+#### Scenario: 三種排序
+
+- **WHEN** `sort=helpful`（預設）
+- **THEN** 依 `helpful_count DESC, created_at DESC` 排序
+- **WHEN** `sort=rating`
+- **THEN** 依 `rating DESC, created_at DESC` 排序
+- **WHEN** `sort=newest`
+- **THEN** 依 `created_at DESC` 排序
+
+#### Scenario: votes 透過 eager loading 查詢
+
+- **WHEN** 已登入 Member 送出評價列表請求
+- **THEN** `has_voted` 欄位透過 eager loaded `votes` collection 判斷，不額外發 SQL 查詢