# guide/ — 網頁多人版重製規格與計畫 > 這個資料夾是「交給工程師重新實作」用的**完整規格 + 計畫**。 > 不含任何實作程式碼;所有遊戲邏輯與設計都從原版 C++ 專案抽取、文件化於此。 > **原版 [`../Lengend-of-Strategy-Card-Game-/`](../Lengend-of-Strategy-Card-Game-/) 完全保留、不修改。** --- ## 這是什麼 原版是一個 raylib + C++ 的單人卡牌 Rogue-like:玩家用「硬幣 / 連擊 / 標籤」系統打牌, 一路打 11 關不斷變強的怪物。本資料夾的目標是把它**重做成網頁、可多人連線**的版本, 但**遊戲規則、卡牌、數值、關卡設計全部沿用**(這些才是專案真正的價值)。 工程師只要讀完本資料夾,就能在不看原始 C++ 的情況下,用任何網頁技術棧重建相同的遊戲。 --- ## 文件導覽(建議閱讀順序) | 檔案 | 內容 | 給誰看 | |---|---|---| | [`HANDOFF.md`](HANDOFF.md) | **交付說明**(一頁讀完即可開工的轉發版) | 全員 / 新進 | | [`00-roadmap.md`](00-roadmap.md) | **實作計畫**:階段、里程碑、風險、驗收標準 | PM / 全員 | | [`01-game-design-spec.md`](01-game-design-spec.md) | 核心玩法與**戰鬥規則引擎**(連擊/硬幣/標籤、傷害公式、回合流程) | 邏輯工程師 | | [`02-card-catalog.md`](02-card-catalog.md) | **全 41 張卡**的數值與精確效果(即時效果 + 連擊效果) | 邏輯工程師 / 企劃 | | [`03-architecture.md`](03-architecture.md) | 網頁 + 多人**架構**、技術棧、模組邊界、多人模式選擇 | 架構師 | | [`04-data-schemas-and-api.md`](04-data-schemas-and-api.md) | 資料結構(卡表、存檔/鬼影、遊戲狀態)、API 契約 | 前後端 | | [`05-ui-ux-spec.md`](05-ui-ux-spec.md) | 畫面、狀態機、版面(沿用原版 UI 行為) | 前端 / 設計 | | [`07-pvp-design.md`](07-pvp-design.md) | **即時 PvP 設計**(同時暗回合、權威伺服器、平衡參數) | 邏輯 / 後端 / 前端 | | [`06-open-questions.md`](06-open-questions.md) | **需要你/團隊拍板的決定** + 原版已知問題清單 | 決策者 | | [`08-card-effectops.md`](08-card-effectops.md) | **全 41 張卡 → EffectOp 對照表**(可直接填 cards.json) | 邏輯工程師 | | [`09-golden-tests.md`](09-golden-tests.md) | **黃金測試清單**(可執行版的規格,進 CI) | 邏輯工程師 / QA | | [`10-diagrams.md`](10-diagrams.md) | **架構圖 + 流程圖**(系統 / 玩家流程 / 戰鬥 / PvP,Mermaid) | 全員 | | [`11-content-pipeline.md`](11-content-pipeline.md) | **內容擴充流程**:新增卡牌 / 新增角色(設計→實作→測試→收尾) | 全員 | | [`12-debugging-guide.md`](12-debugging-guide.md) | **全端除錯指南**(分層定位、工具、實戰案例) | 全員 / QA | --- ## 多人模式:兩者都做(已拍板) 「多人連線」**兩種模式都要做**,並存於同一份 `battle-core`: - **A. 非同步鬼影對戰**:錄下你的戰鬥 → 別人下載你的「鬼影」當第 12 關對手。原版已設計好、 技術風險最低、完全沿用現有戰鬥引擎。**先做、先上線**。詳見 [`03-architecture.md`](03-architecture.md) §3 模式 A。 - **C. 即時 PvP**:兩位真人**同時暗回合**對戰(消除先手優勢)+ 權威伺服器。為原版沒有的全新對稱玩法, 作為**鬼影上線後的獨立增量**。完整設計見 [`07-pvp-design.md`](07-pvp-design.md)。 > 兩模式共用同一規則引擎與卡表,PvP 只在「對局協調 / 同步結算層」與前端相位 UI 新增,鬼影部分不受影響。 > PvP 的平衡參數(HP×2、回合攻擊倍率遞增)已由使用者拍板,見 [`07-pvp-design.md`](07-pvp-design.md) §0。 > 其餘待拍板事項見 [`06-open-questions.md`](06-open-questions.md)。 --- ## 給原作者(你)的提醒 - 你在課堂上學的 **OOP / 多型**設計在重製版仍然用得到(對手介面 `Opponent` → `Monster` / `Ghost` 子類), 這部分的設計理由寫在 [`03-architecture.md`](03-architecture.md)。 - 本規格忠實記錄原版「實際行為」,包含幾個看起來可能非預期的地方(見 [`06-open-questions.md`](06-open-questions.md)), 交付前請你確認那些是不是你要的設計。