diff --git a/docs/architecture.md b/docs/architecture.md
new file mode 100644
index 0000000..4c7ded2
--- /dev/null
+++ b/docs/architecture.md
@@ -0,0 +1,30 @@
+# WTFX Frontend Architecture
+
+WTFX 前端采用 **Monorepo / 多应用独立包架构**，由三大核心端构成：
+
+```
+wtf-frontend/
+├── apps/
+│   ├── admin/             # 超级管理员控制台 (Next.js / AntD / Ethers.js)
+│   │   ├── 合约一键部署向导 (Robinhood Testnet / Mainnet)
+│   │   ├── 协议参数治理 (手续费分成、白名单管理、Tier 阈值覆盖)
+│   │   └── 争议裁决与退款管理 (overrideFinalise / refund)
+│   ├── web/               # Web 高频预测交易终端 (Next.js / Tailwind / TradingView)
+│   └── tma/               # Telegram Mini App 小程序端 (Taro / React)
+├── packages/
+│   ├── contracts/         # 自动从 wtf-contract 同步的 ABI 与地址配置
+│   ├── ui/                # 共享专业交易 UI 组件库
+│   └── sdk/               # 预测市场合约交互 SDK 与数学计算库
+└── README.md
+```
+
+## 1. Admin 后端核心功能规划
+
+- **部署面板 (Deploy Hub)**：支持连接钱包（MetaMask / OKX / 私钥模式），一键部署并初始化 Controller、Curve、Mock 代币并自动导出 ABI 与 Address。
+- **协议治理 (Governance Desk)**：
+  - 手续费分成调整 (`setCreatorShare`, `setCentralWallet`)；
+  - 抵押品与曲线白名单管理 (`setCollateralWhitelisted`, `setCurveWhitelisted`)；
+  - 分档位阈值与争议期配置 (`setMarketTier`, `setMarketConfigOverride`)。
+- **裁决与风控 (Oracle & Dispute)**：
+  - 异常市场紧急暂停 (`pause` / `unpause`)；
+  - 争议窗口期改判 (`overrideFinalise`) 与强制全员返还 (`refund`)。