# 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` - `AUTHENTIK_*` 需可連到 Authentik ## 4) 基本檢查 - `GET http://127.0.0.1:8000/healthz` - 登入後打 `GET /admin/members` 應可回資料 - 非 admin 群組帳號打 `/admin/*` 應回 `403` ## 5) 會員流程驗收 1. 新增會員(username/email/display_name,開啟 sync_to_authentik) 2. 確認列表可看到新會員與 `authentik_sub` 3. 點「重設密碼」,取得臨時密碼 4. 到 Authentik 驗證該會員可用新密碼登入