Add Redis-backed cache backend with env switch

2026-04-03 02:38:54 +08:00
parent ed413ce39d
commit 955019e8d7
9 changed files with 148 additions and 7 deletions
--- a/docs/ARCHITECTURE.md
+++ b/docs/ARCHITECTURE.md
@@ -31,6 +31,7 @@
 - 站台角色指派（`PUT /admin/sites/{site_key}/roles`、`PUT /admin/roles/{role_key}/sites`）會即時同步到 Keycloak Group Role Mapping。
 - 使用者加入 Site 時，透過同步邏輯使其在 IdP 端取得對應角色能力。
 - 讀取效能：後端採用 memory cache（後續可換 Redis），`GET` 先讀快取；`POST/PUT/PATCH/DELETE` 成功後自動失效快取。
+- 快取後端可由 `.env` 切換：`CACHE_BACKEND=memory|redis`（無需改程式）。

 ## 後台安全線
 - `/admin/*` 必須 Bearer token。