# 系统设计与运营规范：荒域黑市（MEGASHOP）与多平台支付系统
# FREEEXILE 项目：荒蛮古武流亡 2.5D ARPG (GRIMDARK SAVAGE PRIMAL EXILE ARPG)

> **责任部门**：制作人室 (`studio_producer`)、首席文档架构师 (`lead_documentation_architect`)、服务端主架构师 (`server_systems_architect`)、全球本地化主管 (`localization_lead`)。  
> **文档版本**：1.0.0-RELEASE  
> **适用范围**：FreeExile 全服网关、iOS 客户端 (StoreKit 2)、安卓客户端 (Google Play)、官方直营 Web 商城与 Web3 加密货币支付系统。

---

## 1. 荒域黑市概述 (OVERVIEW)

- **系统名称**：`荒域黑市` (英文: `The Outcast Bazaar`, 越南文: `Hắc Thị Hoang Vực`)。
- **系统性质**：游戏发行商**官方直营商城 (Publisher Store)**，与玩家间的自由交易行**荒野寄售行 (Consignment Vault)** 严格隔离。
- **商城官方货币**：
  - **血骨古币 (Outcast Blood Coins)**：官方充值代币。
  - **基准汇率**：$\$1.00\text{ 美元} = 100\text{ 血骨古币}$。
- **荒蛮求生拒绝数值碾压 (Fair Play 理念)**：
  - 严禁出售破坏平衡的战力属性、突破骨骼天赋的付费特权。
  - 主营商品包括：**古兽残兵与血甲外观 (Skins)**、**荒野求生实用道具 (Items，含 500 血骨币解锁之高级商贾储物箱)**、**全透明概率古蛮骨匣 (Chests)**、**荒域战令与流亡契约 (Passes)**。

---

## 2. 五大商品类别与盲盒透明度保证

### 盲盒保底与概率公示机制
所有骨匣均在购买界面 $100\%$ 明确公示精确到 $0.01\%$ 的掉落概率：
- **荒蛮骨匣 (`chest_celestial_fortune`) 掉落表**：
  - **古骨碎片** (普通 45.0%)、**荒野燧石** (优秀 30.0%)、**血魂石** (稀有 20.0%)、**古骨印** (稀有 4.5%)、**血影古镜** (神话 0.5% 保底目标)。
  - **总计概率**：**100.0%**。
- **保底机制**：连续 50 次未出极品必定在第 51 次触发保底；连续 100 次未出古镜必定在第 101 次必定产出。

---

## 3. 跨平台支付合规路由 (PLATFORM COMPLIANCE)

- **iOS 平台 (苹果审核指南 3.1.1)**：
  - 苹果商店版本**严禁显示任何第三方支付入口**（Stripe、微信、支付宝、Web3 加密货币均禁止在 App 内出现）。
  - 仅开放 **Apple In-App Purchase (StoreKit 2)**，服务端通过 App Store Server API v2 进行 `SignedTransaction JWS` 验签。
- **安卓平台 (Google Play)**：仅支持 Google Play In-App Billing v6+。
- **官方 Web 直营商城与 APK 侧载版**：开放 Stripe 信用卡、PayPal 全球支付及 **Web3 加密货币钱包支付**。

---

## 4. 购买力平价 (PPP) 定价矩阵与防跨区套利

- **Tier 1 (成熟市场 - 美/日/欧)**：PPP 系数 $1.00$，标准价格。
- **Tier 2 (中等市场 - 韩/新/台)**：PPP 系数 $0.90$。
- **Tier 3 (新兴市场 - 越/泰/巴西)**：PPP 系数 $0.50$（例如越南标准包由 \$10 适配为 125,000 VND）。
- **官方商城充值返利**：因绕过苹果/谷歌 $30\%$ 抽成，Web 直营与 Web3 支付专享 **$+10\%$ 血骨古币赠送**。
- **防跨区套利盾**：校验客户端网络 IP 与支付方式发卡国，不匹配直接拦截 `REGION_MISMATCH`。

---

## 5. WEB3 加密货币钱包直付机制

- **支持公链**：Arbitrum One, Polygon PoS, Ethereum, Solana, BNB Chain。
- **支持代币**：USDT, USDC (1:1 稳定币), ETH, SOL (浮动原生代币)。
- **预言机实时汇率**：采用 Pyth / Chainlink 汇率，订单生成后锁定 **15 分钟** 支付窗口。
- **防双花攻击 (Anti-Double-Spending)**：
  - 链上 RPC 校验收款金库地址、转账代币合约与确认数。
  - 交易哈希全局持久化唯一锁，杜绝重放，最终由分布式 **两阶段提交 (2PC)** 保证 0 复制发货。