member-platform/docs/LOCAL_DEV_RUNBOOK.md

Local Dev Runbook

1) 啟動後端

cd backend
./scripts/start_dev.sh

2) 啟動前端

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 驗證該會員可用新密碼登入