32 lines
1.3 KiB
Markdown
32 lines
1.3 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`。
|
||
開發用的頁面(`#/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`。
|