29 lines
1.1 KiB
Markdown
29 lines
1.1 KiB
Markdown
|
|
# 選舉小鎮 — 前端
|
|||
|
|
|
|||
|
|
前端只依賴 `@election2026/protocol`(後端程式庫中的協定套件),不含任何遊戲規則,所有結算都在後端。整體架構見 `../backend/docs/README.md`。
|
|||
|
|
|
|||
|
|
畫面(hash 路由,`src/App.tsx`):首頁與選戰卡牌(`#/`、`#/rogue/<局>`)、政治生涯、圖鑑與成就、捏人物、服裝店、政策島、小遊戲、任期試玩、歷屆參選人,
|
|||
|
|
以及開發用的資料檢視器(`#/viewer`)、美術總覽(`#/art`、`#/faces`)、頭像部件檢查(`#/avatar-check`)。
|
|||
|
|
|
|||
|
|
開發時要先啟動後端 API(`pnpm --filter @election2026/server start`,見後端 README);`/api` 由 Vite 轉給 `127.0.0.1:8787`。
|
|||
|
|
|
|||
|
|
## 開發
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
pnpm install
|
|||
|
|
pnpm sync-fixtures # 從 ../backend/data/build/packs 複製資料包到 public/fixtures(需先在後端產生)
|
|||
|
|
pnpm dev
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
讀取資料時會用協定的 Zod 定義驗證;格式和協定不符會直接顯示錯誤。
|
|||
|
|
|
|||
|
|
## 檢查
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
pnpm test
|
|||
|
|
pnpm typecheck
|
|||
|
|
pnpm build
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
設計 token(顏色、字型)集中在 `src/theme/tokens.css`。
|