election-game/web
王性驊 ecb07bb544 選戰卡牌:歷史形勢(選前藍綠形勢、全國風向、翻盤)、可選局數、大絕招人人可用、讀取不卡、新圖示
- 歷史形勢(docs/26 第 8d 節,研究 2014 鄭文燦在藍大於綠的桃園勝選):開局照投票日以前的歷屆選舉算藍綠形勢
  (原本的「真實底盤」其實是開票結果);每年的全國風向由資料算出(apps/sim rogue-tides);現任包袱、捲土重來
  依中選會紀錄;對手輕敵;選人畫面先看難度(GET /api/rogue/outlook),遊戲裡狀態列、對手面板都寫出來
- 可選局數:自由選戰 6、8、10、12 週,行事曆與對手成長依長度換算
- 大絕招:每個人每週都集氣(一局的六成集滿),落後、翻區、贏下戰場更快;歷史形勢只算比開局又多落後的
- 讀取:不再另外開 WebGL 檢查(卡住約 1.6 秒、不釋放),3D 場景先畫讀取動畫再搭;共用 Loader 動畫,
  主執行緒忙也會動;首頁載入畫面最多擋 4 秒
- 新圖示:可愛的投票箱(favicon、192/512、apple-touch、manifest)
- 逆風規則在遊戲裡看得到;手機狀態列不再藏起逆風標籤;加了大絕招後重新校準對手強度

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Uirha5kfuiGbEBhsk7ijDg
2026-10-30 08:47:34 +08:00
..
public 選戰卡牌:歷史形勢(選前藍綠形勢、全國風向、翻盤)、可選局數、大絕招人人可用、讀取不卡、新圖示 2026-10-30 08:47:34 +08:00
scripts 初始匯入:選舉小鎮(backend、web、art 合成一個 repo) 2026-10-28 15:58:33 +08:00
src 選戰卡牌:歷史形勢(選前藍綠形勢、全國風向、翻盤)、可選局數、大絕招人人可用、讀取不卡、新圖示 2026-10-30 08:47:34 +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 選戰卡牌:歷史形勢(選前藍綠形勢、全國風向、翻盤)、可選局數、大絕招人人可用、讀取不卡、新圖示 2026-10-30 08:47:34 +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。