docs: add frontend multi-app and admin architecture design

This commit is contained in:
Bot
2026-08-30 23:43:55 +08:00
parent ee468d797d
commit 874b421f39
+30
View File
@@ -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`)。