# Local Dev Runbook ## 1) 啟動後端 ```bash cd backend ./scripts/start_dev.sh ``` ## 2) 啟動前端 ```bash cd frontend npm install npm run dev ``` ## 3) 重要環境變數 - `backend/.env.development` - `ADMIN_REQUIRED_GROUPS=member-admin` - `KEYCLOAK_*` ## 4) 基本檢查 - `GET http://127.0.0.1:8000/healthz` - 登入後打 `GET /me` 應可回資料 - 非 admin 群組帳號打 `/admin/*` 應回 `403` ## 5) 會員流程驗收 1. 新增會員(開啟 `sync_to_idp`) 2. 確認列表可看到新會員與 `user_sub` 3. 點「重設密碼」,取得臨時密碼 4. 到 Keycloak 驗證該會員可用新密碼登入