資源與載入(docs/27 第 1 節):首頁下載 8.7 → 1.6 MB、載入畫面 4.4 → 1.5 秒,進一局 5.0 → 1.3 MB - 中文字型切成 unicode-range 小片,照畫面出現的頻率排(art/fonts/split-webfonts.py),拿掉 Google Fonts; canvas 上的字(3D 看板、名牌、分享圖)字型片載好再畫一次(ui/canvasFont.ts) - 3D 模型 meshopt 壓縮、只留用到的動作(art/optimize-3d.mjs、game/gltf.ts),5.5 → 1.0 MB - 卡圖 320 px 小圖+srcset(art/cards-small.sh);木紋貼圖縮小;背景音樂改 Opus 96 kbps(art/music-opus.sh) - 新增 GET /api/scenarios/list 只回大廳用到的欄位(1.52 → 0.44 MB);伺服器沒有這條路由時前端改抓舊的清單 玩法(docs/27 第 2–4 節,研究桌遊機制後挑兩個做): - 趕場(推運氣):每週可以翻牌庫頂的牌免費打,越翻越容易翻車(POST /api/rogue/runs/:id/overtime) - 政見支票(藏起來的長期目標):第 1 週開跑記者會三選一或不開,開票時兌現全市加票、跳票掉票 新主畫面圖示:重畫投票箱(art/icon/icon.svg、render-icons.sh),apple-touch 滿版不透明,加 Android maskable 修 Bug: - 舊版伺服器沒有新路由時,首頁、政治生涯的紅色「Not Found」改成照樣能用;版本對不上時寫中文說明 - 捏人物「存起來,去政治生涯」直接選好剛捏的角色、跳到選家鄉 - 政見支票:開票畫面的兌現與否和開票結果一致(照投票日的票數判定);跳過=不開;模擬玩家都不開 - 趕場翻到的免費牌只免費一次 - 劇本清單算錯一次後不會一直回錯誤 - 分享圖的標語、減少動態效果時的 3D 看板,字型晚到後重畫 - Safari 解不開 OGG 時改放 MP3 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> |
||
|---|---|---|
| .. | ||
| public | ||
| scripts | ||
| src | ||
| test | ||
| .gitignore | ||
| README.md | ||
| index.html | ||
| package.json | ||
| pnpm-lock.yaml | ||
| tsconfig.json | ||
| vite.config.ts | ||
README.md
選舉小鎮 — 前端
前端只依賴 @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 一樣轉給後端。
開發
pnpm install
pnpm sync-fixtures # 從 ../backend/data/build/packs 複製資料包到 public/fixtures(需先在後端產生)
pnpm dev
讀取資料時會用協定的 Zod 定義驗證;格式和協定不符會直接顯示錯誤。
檢查
pnpm test
pnpm typecheck
pnpm build
設計 token(顏色、字型)集中在 src/theme/tokens.css。