election-game/web
王性驊 0e24ee6a16 選戰卡牌:對手規則、隨機行事曆、流派核心牌、精英站、局中小勝利
每局不一樣(docs/25 第 3、4 節)
- 對手規則 7 條(名嘴加持、地方大老、大打空戰、鐵票區、網路謠言、地毯式掃街、形象牌),開局抽 1 條,逆風 5 起 2 條
- 辯論、民調、黑函的週次每局隨機;上方週次標出大場面
- 精英站「地方派系談判」:接下挑戰,下週在指定的區淨增票數,達成拿稀有幕僚
- 下一站畫面看得到下下週的門

流派與小勝利(第 2、5 節)
- 9 張流派核心牌、5 位改規則的幕僚
- 翻區抽牌(每週最多 2 張)、民調領先多一張稀有牌、落後下週體力 +1、結果頁標出最關鍵的一區

選人與手感(第 1、7 節)
- 選人畫面顯示候選人類型、技能、弱點與這個類型的逆風紀錄(伺服器啟動時先算好,人物查詢改用姓名索引)
- 出牌不等伺服器:牌先飛出去、手牌體力先扣,伺服器回來校正
- 設定加「快速模式」:開票夜、週末結算、選情快報快一倍

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Uirha5kfuiGbEBhsk7ijDg
2026-10-28 17:45:05 +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:45:05 +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。