election-game/web
王性驊 2b0fd1ab33 選戰卡牌第五版:趕場、政見支票、資源瘦身、新主畫面圖示、修 Bug
資源與載入(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>
2026-10-30 17:04:19 +08:00
..
public 選戰卡牌第五版:趕場、政見支票、資源瘦身、新主畫面圖示、修 Bug 2026-10-30 17:04:19 +08:00
scripts 初始匯入:選舉小鎮(backend、web、art 合成一個 repo) 2026-10-28 15:58:33 +08:00
src 選戰卡牌第五版:趕場、政見支票、資源瘦身、新主畫面圖示、修 Bug 2026-10-30 17:04:19 +08:00
test 選戰卡牌:地方事件週、對手類型、聲望解鎖、流派傾向、新牌插圖 2026-10-29 17:32:15 +08:00
.gitignore 初始匯入:選舉小鎮(backend、web、art 合成一個 repo) 2026-10-28 15:58:33 +08:00
README.md 首頁速度、載入畫面、本命區與候選人類型、完成度 2026-10-28 17:23:32 +08:00
index.html 選戰卡牌第五版:趕場、政見支票、資源瘦身、新主畫面圖示、修 Bug 2026-10-30 17:04:19 +08:00
package.json 首頁速度、載入畫面、本命區與候選人類型、完成度 2026-10-28 17:23:32 +08:00
pnpm-lock.yaml 初始匯入:選舉小鎮(backend、web、art 合成一個 repo) 2026-10-28 15:58:33 +08:00
tsconfig.json 初始匯入:選舉小鎮(backend、web、art 合成一個 repo) 2026-10-28 15:58:33 +08:00
vite.config.ts 初始匯入:選舉小鎮(backend、web、art 合成一個 repo) 2026-10-28 15:58:33 +08:00

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。