election-game/web/README.md

32 lines
1.3 KiB
Markdown
Raw Permalink Normal View History

# 選舉小鎮 — 前端
前端只依賴 `@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`。
開發用的頁面(`#/viewer`、`#/art`、`#/faces`、`#/avatar-check`)只有 `pnpm dev` 打得開,正式版不打包。
正式玩(第一次連線快很多):`pnpm start`=建置後用 `vite preview` 在 5173 提供,`/api` 一樣轉給後端。
## 開發
```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`。