# 風之曦原 (Wind of Dawn) — Web 2.5 完整系統架構與規格手冊

## 1. 專案概述
《風之曦原》（Wind of Dawn）是一個示範如何優雅銜接 Web2 使用者體驗與 Web3 數位產權的 Web 2.5 抽卡手遊。
傳統 Web3 遊戲往往強迫使用者在一開始就安裝 MetaMask、切換網路、購買原生代幣支付 Gas，門檻極高。
《風之曦原》透過「遊戲內無感抽卡 + SSR 有感自主上鏈 (Gasless Minting)」架構，讓所有玩家在毫無障礙的情況下享受收集樂趣，並在獲得稀有卡片時自主選擇是否將其轉化為真實的鏈上 ERC-721 NFT。

## 2. 卡池架構與設計
遊戲共包含三大系列 52 張精心設計的原創卡牌，分屬三個特色主題池：

### 第 1 彈：風之曦原（繪本水彩 · 常駐池）
- **類型**：固定機率卡池（Gacha），無限量發行。
- **單抽/十連成本**：100 星塵 / 900 星塵。
- **稀有度機率**：N: 55.5%, R: 30.0%, SR: 11.0%, SSR: 3.5%。
- **保底機制**：90 抽保底 SSR；十連抽保底 R 以上。
- **代表卡片**：
  - `ssr01`: 曦光騎士王 奧瑞恩 (光屬性, ATK 1680, HP 2600)
  - `ssr02`: 星紋魔女 賽拉菲娜 (暗屬性, ATK 1740, HP 2480)
  - 以及 SR 艾莉薇、卡希爾、溫特爾、莉薇安等。

### 第 2 彈：童話剪影（暗黑剪紙 · 一番賞）
- **類型**：限量箱抽（Ichiban Kuji），一箱共 80 張。
- **單抽/十連成本**：300 星塵 / 2700 星塵。
- **機制**：每抽出一張，箱內剩餘即時減少，當下機率由剩餘庫存動態計算。
- **代表卡片**：
  - `fssr01`: 吹笛人與鼠群 (限量 1 張/箱)
  - `fssr02`: 穿靴子的貓 (限量 1 張/箱)
  - 以及小紅帽、白雪公主、糖果屋兄妹、長髮公主等經典童話剪影。

### 第 3 彈：卡寶千面（美術史 · 常駐池）
- **類型**：藝術史風格探索常駐池。
- **特色**：固定主角「卡寶兔子」以 20 種世界藝術史流派演繹（浮世繪、新藝術、裝飾藝術、荷蘭油畫、立體派、包浩斯等）。
- **代表卡片**：
  - `c19`: 鳥獸戲畫 卡寶 (水屬性, SSR, 12世紀日本漫畫鼻祖線條)
  - `c20`: 泥金手抄本 卡寶 (光屬性, SSR, 中世紀羊皮紙金箔蛋彩)

## 3. Web 2.5 鏈上架構與智能合約
- **合約標準**：Solidity ERC-721 + ERC721Enumerable + ERC721URIStorage。
- **合約地址**：`0x3E531663287933486293F19dFb51979931e238a0` (Ethereum Sepolia)。
- **Gasless 鑄造機制**：由伺服器/本機 Worker 管理員錢包代表呼叫 `mintTo(address recipient, string cardId, string imageCid, uint256 edition)`。玩家不需持有 ETH 或簽署鏈上交易。
- **IPFS 存儲**：所有 52 張卡圖及生成的卡背均已上傳至 Pinata IPFS，CIDs 註冊於合約中，具有永久不可篡改性。

## 4. 安全與隱私架構
- **私鑰防護**：生產環境雲端伺服器不保存簽章私鑰，鑄造工作交由本地 Worker 執行或需管理員在後台手動核准。
- **權限控制**：管理後台支援管理員 Email 授權與獨立 ADMIN_TOKEN 雙重驗證，支援異常申請退回與審核。