# Admin Panel Mapping (Admin API)

本表用于前端管理面板的「页面与接口对照」与基础交互流程说明。
鉴权统一使用：`Authorization: Bearer <EZ_ADMIN_TOKEN>`。

---

## 页面与接口对照表

| 页面 | 接口 | 交互要点 |
| --- | --- | --- |
| Dashboard / 全局概览 | `GET /admin/dashboard/summary` `GET /admin/realtime` `GET /admin/stats` | 聚合指标、实时 QPS、传统统计 |
| Dashboard / 告警 | `GET /admin/alerts` `GET /admin/alerts/stats` `POST /admin/alerts/:id/ack` `POST /admin/alerts/:id/resolve` | 告警列表、统计、确认、解决 |
| Dashboard / 上游凭证统计 | `GET /admin/apikey-stats/summary` | 上游 API Key 成功率统计，支持时间范围 |
| 操作日志 | `GET /admin/operation-logs` | 管理员操作审计 |
| 租户（Masters）列表 | `GET /admin/masters` `POST /admin/masters` `POST /admin/masters/batch` | 列表 + 批量操作 |
| 租户详情 | `GET /admin/masters/:id` `PUT /admin/masters/:id` `DELETE /admin/masters/:id` | 查看/编辑/删除 |
| 租户实时监控 | `GET /admin/masters/:id/realtime` | 实时 QPS/用量 |
| 租户状态管理 | `POST /admin/masters/:id/manage` | 冻结/解冻/状态切换 |
| 租户访问权限 | `GET /admin/masters/:id/access` `PUT /admin/masters/:id/access` | 设置 namespaces/能力 |
| 子 Key 颁发 | `POST /admin/masters/:id/keys` | 发放子 Key |
| 子 Key 权限 | `GET /admin/keys/:id/access` `PUT /admin/keys/:id/access` | Key 级别访问控制 |
| Namespaces | `GET /admin/namespaces` `POST /admin/namespaces` `GET /admin/namespaces/:id` `PUT /admin/namespaces/:id` `DELETE /admin/namespaces/:id` | 命名空间 CRUD |
| Provider Groups | `GET /admin/provider-groups` `POST /admin/provider-groups` `GET /admin/provider-groups/:id` `PUT /admin/provider-groups/:id` `DELETE /admin/provider-groups/:id` | 上游组定义 |
| API Keys | `GET /admin/api-keys` `POST /admin/api-keys` `GET /admin/api-keys/:id` `PUT /admin/api-keys/:id` `DELETE /admin/api-keys/:id` `POST /admin/api-keys/batch` | group_id 过滤、批量操作 |
| Bindings | `GET /admin/bindings` `POST /admin/bindings` `GET /admin/bindings/:id` `PUT /admin/bindings/:id` `DELETE /admin/bindings/:id` `POST /admin/bindings/batch` | bindingKey -> group_id，多候选 + weight |
| Models | `GET /admin/models` `POST /admin/models` `PUT /admin/models/:id` `DELETE /admin/models/:id` `POST /admin/models/batch` | 模型能力表 |
| Feature Flags | `GET /admin/features` `PUT /admin/features` | DP 开关、日志策略等 |
| Model Registry | `GET /admin/model-registry/status` `POST /admin/model-registry/check` `POST /admin/model-registry/refresh` `POST /admin/model-registry/rollback` | 外部模型注册表 |
| 日志查询 | `GET /admin/logs` `DELETE /admin/logs` | 查询/清理 |
| 日志统计 | `GET /admin/logs/stats` | 日志统计视图 |
| 日志 Webhook | `GET /admin/logs/webhook` `PUT /admin/logs/webhook` | 告警配置 |
| 同步快照 | `POST /admin/sync/snapshot` | 手动触发 CP -> Redis |

---

## 交互流程

### 上游配置上线
1. `POST /admin/provider-groups` 创建 ProviderGroup。
2. `POST /admin/api-keys` 绑定 key（必要时多条）。
3. `POST /admin/bindings` 建立 `bindingKey = namespace.public_model -> group_id`（可多条绑定 + weight）。
4. `POST /admin/models` 或 `POST /admin/model-registry/refresh` 更新能力表（能力校验基于 bindingKey）。

### 租户开通
1. `POST /admin/masters` 创建租户。
2. `PUT /admin/masters/:id/access` 设置可见 namespaces。
3. `POST /admin/masters/:id/keys` 签发子 Key。
4. `PUT /admin/keys/:id/access` 细化 Key 的访问范围（可选）。

### 日常运维
1. `GET /admin/logs` + `GET /admin/logs/stats` 查询异常与用量（支持 `group_by=hour|minute`）。
2. `PUT /admin/logs/webhook` 配告警；`DELETE /admin/logs` 清理。
3. `GET /admin/dashboard/summary`、`GET /admin/realtime`、`GET /admin/masters/:id/realtime` 查看实时指标。
4. `GET /admin/alerts` + `GET /admin/alerts/stats` 查看系统告警；`POST /admin/alerts/:id/ack` 确认告警。
5. `GET /admin/apikey-stats/summary` 查看上游凭证成功率（支持 `since/until` 时间范围）。
6. `PUT /admin/features` 调整 DP 开关；必要时 `POST /admin/sync/snapshot` 手动同步。
