# 元境幻生管理台

`admin/` 是 MiragenFlow（元境幻生）V1 的管理员前端，基于 React、Vite 和 TDesign UI 组件构建。它只承载 `/admin/` 管理页面，不保存供应商密钥，不直接调用模型供应商接口。

## 本地开发

```bash
npm install
npm run dev:linux -- --port 3003
```

通常使用仓库根目录的 `node scripts/dev-all.mjs` 同时启动前台、管理台和 API 网关。生产环境由同一公网 origin 提供 `/`、`/admin/`、`/api/` 和 WebSocket。

## 管理范围

- 管理员独立登录、MFA、RBAC 和会话退出
- 用户、认证消息和风控策略
- 模型产品、分辨率、价格、渠道、渠道组和健康状态
- 任务、attempt、队列、余额账本、充值订单、套餐和审批
- WebDAV/临时存储策略、消息 outbox、审计日志

所有写请求必须经过服务端 `/api/v1/admin/*` 鉴权、幂等校验、版本校验和审计。页面展示的渠道凭证始终是脱敏状态；support 角色不能读取原始提示词、文件或密钥。

## 构建与检查

```bash
npm run build
npm run lint
```

管理台通过 `packages/contracts` 与前台共享公开 DTO、错误码和 WebSocket 事件类型。模板输入目录 `docs/design-reference/MiragenFlow-front/` 不属于管理台运行时依赖。