06. 管理员后台¶
管理员用户可进入 /admin 后台。后台菜单包括：
- 系统数据
- 用户管理
- 设备管理
- 群组管理
- 通信记录
- 资源管理
- 站点配置
1. 系统数据¶
后台首页 /admin/dashboard 展示系统全局统计：
- 总设备数。
- 在线设备。
- 群组数量。
- 用户数量。
- 通信记录数。
- 通信总大小。
- 通信总时长。
- 通信趋势。
截图占位：后台系统数据页。建议展示全局统计卡片和趋势图。
相关 API：
| Method | Path | Auth | 说明 |
|---|---|---|---|
| GET | /api/platform/totalstats |
Public | 平台统计。 |
| GET | /api/comm-records/system-stats |
Admin | 系统通信统计。 |
| GET | /api/comm-records/system-trend |
Admin | 系统通信趋势。 |
2. 用户管理¶
后台用户管理包含：
- 账号管理
/admin/users - 用户审批
/admin/approvals - 操作证审批
/admin/certificate-approvals
管理员可：
- 查询用户列表。
- 查看用户详情。
- 修改用户资料、角色、状态。
- 禁用/启用用户。
- 删除用户。
- 重置用户密码。
- 审批注册用户。
- 审批操作证和呼号变更。
截图占位：用户管理页。建议展示用户表格、状态、角色、编辑/禁用/删除按钮。
截图占位：用户审批页。建议展示待审核用户和审批对话框。
截图占位：操作证审批页。建议展示证件预览、呼号、审批备注。
相关 API：
| Method | Path | Auth | 说明 |
|---|---|---|---|
| GET | /api/users |
Admin | 用户列表。 |
| GET | /api/users/:id |
Admin | 用户详情。 |
| PUT | /api/users/:id |
Admin | 更新用户。 |
| DELETE | /api/users/:id |
Admin | 删除用户。 |
| PUT | /api/users/:id/status |
Admin | 更新用户状态。 |
| PUT | /api/users/:id/password |
JWT | 管理员或本人改密码。 |
| GET | /api/approvals/pending |
Admin | 用户审批列表。 |
| PUT | /api/approvals/:id/approve |
Admin | 用户审批。 |
| GET | /api/certificate-approvals |
Admin | 操作证审批列表。 |
| PUT | /api/operator-certificates/:id/approve |
Admin | 操作证审批。 |
3. 设备管理¶
后台设备管理包含：
- 客户端
/admin/devices - 中继台
/admin/relays - 服务器
/admin/servers - 固件管理
/admin/firmware
管理员客户端管理与用户设备管理类似，但可查看全局设备，并可读取、修改、同步任意设备配置。
截图占位：后台客户端设备页。建议展示全局设备列表和配置入口。
截图占位：中继台管理页。建议展示中继台频率、亚音、位置和状态。
截图占位：服务器管理页。建议展示服务器名称、地址、状态和备注。
截图占位：固件管理页。建议展示型号、版本、文件哈希、最新版本标识和上传入口。
相关 API：
| Method | Path | Auth | 说明 |
|---|---|---|---|
| GET | /api/devices |
JWT+Approved | 设备列表。 |
| GET | /api/admin/devices/:id/config |
Admin | 任意设备配置读取。 |
| PUT | /api/admin/devices/:id/config |
Admin | 任意设备配置更新。 |
| POST | /api/admin/devices/:id/config/sync |
Admin | 任意设备配置下发。 |
| GET | /api/relays |
Admin | 中继台列表。 |
| POST | /api/relay/create |
Admin | 创建中继台。 |
| POST | /api/relay/update |
Admin | 更新中继台。 |
| POST | /api/relay/delete |
Admin | 删除中继台。 |
| GET | /api/servers |
Admin | 服务器列表。 |
| POST | /api/server/create |
Admin | 创建服务器。 |
| POST | /api/server/update |
Admin | 更新服务器。 |
| POST | /api/server/delete |
Admin | 删除服务器。 |
| GET | /api/firmware |
Admin | 固件列表。 |
| POST | /api/firmware |
Admin | 上传固件。 |
| DELETE | /api/firmware/:id |
Admin | 删除固件。 |
4. 群组管理和互联管理¶
后台群组管理包含：
- 普通群组
/admin/groups - 互联管理
/admin/group-links
管理员可管理所有公开群组和私有群组，也可创建虚拟互联组。虚拟互联组本身是一个特殊群组，可关联多个目标群组，实现跨群组互联。
截图占位：后台群组管理页。建议展示公开/私有群组、启用状态和设备列表。
截图占位：互联管理页。建议展示虚拟互联组、已关联群组和可添加群组。
相关 API：
| Method | Path | Auth | 说明 |
|---|---|---|---|
| GET | /api/groups |
JWT+Approved | 群组列表。 |
| POST | /api/groups |
JWT+Approved | 创建群组。 |
| PUT | /api/groups/:id |
Admin/Owner | 更新群组。 |
| DELETE | /api/groups/:id |
Admin/Owner | 删除群组。 |
| POST | /api/group-links |
Admin | 创建虚拟互联组。 |
| GET | /api/group-links |
Admin | 互联组列表。 |
| GET | /api/group-links/available-targets |
Admin | 可关联目标群组。 |
| PUT | /api/group-links/:id |
Admin | 更新互联组。 |
| DELETE | /api/group-links/:id |
Admin | 删除互联组。 |
| POST | /api/group-links/:id/targets |
Admin | 增加关联目标。 |
| DELETE | /api/group-links/:id/targets/:targetId |
Admin | 移除关联目标。 |
5. 资源管理¶
资源管理 /admin/assets 是一个虚拟文件系统。管理员可创建文件夹、上传文件、重命名、移动、替换、删除资源。前台下载中心通过公开接口读取目录树和下载链接。
截图占位：资源管理页。建议展示目录树、文件列表、上传/移动/替换操作。
相关 API：
| Method | Path | Auth | 说明 |
|---|---|---|---|
| GET | /api/assets |
Admin | 资源列表。 |
| POST | /api/assets/folder |
Admin | 创建文件夹。 |
| POST | /api/assets/upload |
Admin | 上传文件。 |
| PUT | /api/assets/:id |
Admin | 更新资源。 |
| PUT | /api/assets/:id/move |
Admin | 移动资源。 |
| POST | /api/assets/:id/replace |
Admin | 覆盖文件。 |
| DELETE | /api/assets/:id |
Admin | 删除资源。 |
| GET | /api/assets/tree |
Public | 目录树。 |
| GET | /api/assets/folder/:id |
Public | 文件夹内容。 |
| GET | /api/assets/:id/download |
Public | 下载链接。 |
6. 站点配置¶
站点配置 /admin/settings 包含：
- 系统信息：站点名称、简称、Logo、Favicon、语言、ICP。
- APRS：服务器、端口、本机地址、本机端口、呼号、SSID、经纬度、海拔、日志。
- OpenAI：Base URL、API Key、模型/Engine。
- 通信设置：是否启用音频记录、保留天数、最小录制阈值、最大录制时长、批量上传间隔。
- SMTP：服务器地址、端口、SSL、发件人昵称、发件人邮箱、授权码。
- 注册设置：是否要求邮箱验证。
- 操作日志：按事件类型和关键字查询系统操作记录。
截图占位：站点配置页。建议展示系统信息、APRS、通信设置、SMTP、注册设置和操作日志标签页。
相关 API：
| Method | Path | Auth | 说明 |
|---|---|---|---|
| GET | /api/config/public |
Public | 公开站点配置。 |
| GET | /api/config/category/:category |
JWT | 分类配置读取。 |
| PUT | /api/config/system |
Admin | 系统配置更新。 |
| PUT | /api/config/icp |
Admin | ICP 配置更新。 |
| PUT | /api/config/aprs |
Admin | APRS 配置更新。 |
| PUT | /api/config/openai |
Admin | OpenAI 配置更新。 |
| GET | /api/config/comm-settings |
Admin | 通信设置读取。 |
| PUT | /api/config/comm-settings |
Admin | 通信设置更新。 |
| GET | /api/config/registration |
Admin | 注册配置读取。 |
| PUT | /api/config/registration |
Admin | 注册配置更新。 |
| GET | /api/config/smtp |
Admin | SMTP 配置读取。 |
| PUT | /api/config/smtp |
Admin | SMTP 配置更新。 |
| GET | /api/operatorlog/list |
Admin | 操作日志列表。 |
| GET | /api/operatorlog/stats |
Admin | 操作日志统计。 |
| GET | /api/config/aprs/logs |
Admin | APRS 最近日志。 |
7. 缓存监控¶
缓存指标接口用于管理员查看和重置缓存统计，也可清空全部缓存。
相关 API：
| Method | Path | Auth | 说明 |
|---|---|---|---|
| GET | /api/cache/metrics |
Admin | 缓存指标。 |
| POST | /api/cache/metrics/reset |
Admin | 重置缓存指标。 |
| POST | /api/cache/clear |
Admin | 清空缓存。 |