election-game/web
王性驊 fdd8a5cbb8 首頁速度、載入畫面、本命區與候選人類型、完成度
速度與載入
- 3D 小鎮依實際每秒張數自動降畫質;偵測到軟體繪圖直接用最低畫質;shader 背景編譯
- three.js 與一局卡牌的畫面用到才下載(首頁主程式 1.19 MB → 0.34 MB)
- 伺服器壓縮 API 回應(劇本清單 1.4 MB → 56 KB);網頁 pnpm start 用正式版
- index.html 內嵌載入畫面,顯示 3D 小鎮的搭建進度

首頁與頁面
- 拿掉首頁頁尾(致敬字樣、資料、美術連結);資料來源改放遊戲內設定選單
- 資料檢視器、美術總覽、頭像對照、部件檢查只在 pnpm dev 打得開

選戰卡牌(docs/25)
- 本命區:雙方各一(總統兩個縣市),牌 ×1.2,失守聲勢 −2,攻下對手的聲勢 +2、對手少一個行動;新牌「回鄉造勢」
- 六種候選人類型:依中選會選舉紀錄或出身決定,各有技能、弱點、專屬開局牌;每日一戰也套用
- 下一站、物資行比較常出現適合你類型的牌與幕僚,牌面標出來
- 完成度:全台制霸、六種類型、類型逆風挑戰、成就;結果頁挑戰下一級逆風、攻下一塊地盤、Enter 再來一局

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-28 17:23:32 +08:00
..
public 初始匯入:選舉小鎮(backend、web、art 合成一個 repo) 2026-10-28 15:58:33 +08:00
scripts 初始匯入:選舉小鎮(backend、web、art 合成一個 repo) 2026-10-28 15:58:33 +08:00
src 首頁速度、載入畫面、本命區與候選人類型、完成度 2026-10-28 17:23:32 +08:00
test 首頁速度、載入畫面、本命區與候選人類型、完成度 2026-10-28 17:23:32 +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-28 17:23:32 +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。