a620906209
849c33e83a
- 移至 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>
1.6 KiB
1.6 KiB
Why
前端請求回應偏慢，調查後確認根本原因為：無任何快取層、多處 Controller 直接執行全表查詢（無分頁）、資料庫缺少關鍵索引，導致每次請求都是全量 DB 掃描。
What Changes
- 補充 DB 索引：
notifications表補[notifiable_type, notifiable_id, read_at]複合索引；diving_offers表補provider_id索引 - 查詢優化：
ReviewController::publicList()將 3 次獨立 SQL 合併；AdminReviewController::index()加入分頁 - 引入快取層（Redis）：
AdminStatsController統計數據、課程列表搜尋結果、評價分布加Cache::remember() - Cache driver 切換為 Redis：目前 driver 為
database，改為 Redis 以降低快取本身的 DB 負擔
Capabilities
New Capabilities
api-cache-layer：為高頻讀取端點（統計、課程列表、評價分布）加入 Redis 快取，定義 TTL 策略與快取失效時機db-index-optimization：補充缺少的資料庫索引，涵蓋 notifications 與 diving_offers 表
Modified Capabilities
review-lifecycle：publicList端點行為改變——合併查詢、加入分頁參數（per_page預設 20）
Impact
- 後端：
ReviewController、AdminReviewController、AdminStatsController、config/cache.php、.env（CACHE_STORE=redis） - 資料庫：新增一個 migration 補索引
- Docker：需確認
docker-compose.yml中已有 Redis 服務（若無則補上） - 前端：
ReviewController加分頁後，前端呼叫端需傳入page參數（或保持預設，相容現有行為）