election-game/web/README.md

32 lines
1.3 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 選舉小鎮 — 前端
前端只依賴 `@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`。