docs: rebuild documentation set for new architecture and add DB schema guide
This commit is contained in:
31
docs/LOCAL_DEV_RUNBOOK.md
Normal file
31
docs/LOCAL_DEV_RUNBOOK.md
Normal file
@@ -0,0 +1,31 @@
|
||||
# Local Dev Runbook
|
||||
|
||||
## 1) 啟動後端
|
||||
```bash
|
||||
cd backend
|
||||
.venv/bin/uvicorn app.main:app --env-file .env.development --host 127.0.0.1 --port 8000
|
||||
```
|
||||
|
||||
## 2) 啟動前端
|
||||
```bash
|
||||
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`
|
||||
Reference in New Issue
Block a user