wtf-frontend/docs/architecture.md

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)。