member-platform/docs/LOCAL_DEV_RUNBOOK.md

Local Dev Runbook

1) 啟動後端

cd backend
.venv/bin/uvicorn app.main:app --env-file .env.development --host 127.0.0.1 --port 8000

2) 啟動前端

cd frontend
npm install
npm run dev

3) 基本檢查

• Backend health: GET http://127.0.0.1:8000/healthz
• Frontend: http://localhost:5173 或 http://127.0.0.1:5173
• 檢查 admin API 是否有自動帶 X-Client-Key、X-API-Key

4) 驗收順序（本地）

1. 建立公司、站台
2. 建立系統、模組
3. 建立會員
4. 建立群組
5. 在群組配置：站台/系統/模組/action(view/edit)/會員
6. 到系統/模組/公司/會員頁確認關聯列表是否正確

5) 注意事項

• 本輪不產最終規格表
• DB 真實來源僅 backend/scripts/init_schema.sql