feat:實作 API 效能優化 — Redis 快取、分頁、DB 索引
- 引入 Redis(predis)快取層:Admin Stats(5分鐘)、課程列表(3分鐘,tag-based 失效)、評價分布(10分鐘) - ReviewController::publicList 改為 paginate + eager load votes,消除 N+1 - AdminReviewController::index 加入分頁(預設 20,最大 100) - 新增 notifications / diving_offers 效能索引 migration - 新增 docker-compose.override.yml 本機開發 port mapping 機制(不進 git) Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
@@ -0,0 +1,28 @@
|
||||
## 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` 參數(或保持預設,相容現有行為)
|
||||
Reference in New Issue
Block a user