03. 用户控制台

1. 用户侧导航

普通用户登录后进入控制台。左侧菜单包含：

• 仪表盘 /dashboard
• 在线收发 /radio
• 设备管理 /devices
• 群组管理 /groups
• 个人中心 /profile
• 通信记录 /comm-records/platform
• 通联日志 /comm-records/logbook

其中在线收发、设备管理、群组管理、通信记录和通联日志需要账号审核通过后才显示或可访问。

2. 仪表盘

仪表盘展示：

• 当前用户状态：管理员、普通用户、待审核、已拒绝。
• 我的设备数量。
• 在线设备数量。
• 群组数量。
• 通信记录数量。
• 通信总时长。
• 近 30 天通信趋势。
• 我的设备在线率。
• 系统名称、版本、协议版本。

待审核用户会看到状态刷新提示；被拒绝用户会看到拒绝原因。

截图占位：用户仪表盘。建议展示欢迎卡片、统计卡片和趋势图。

相关 API：

Method	Path	Auth	说明
GET	/api/me	JWT	当前用户信息。
GET	/api/platform/totalstats	Public	平台统计。
GET	/api/devices	JWT+Approved	设备列表。
GET	/api/comm-records/user-stats	JWT	当前用户通信统计。
GET	/api/comm-records/user-trend	JWT	当前用户通信趋势。

3. 个人中心

个人中心用于维护个人资料和账号安全信息，常见操作包括：

• 修改昵称、电话、地址、生日、性别、DMR ID、MDC ID、个人简介。
• 上传头像。
• 修改密码。
• 修改邮箱。
• 查看和管理设备准入密码。
• 上传操作证或申请呼号变更。
• 查看操作证审核状态。
• 绑定或解绑 SSO。

呼号不能直接通过个人资料接口修改。用户需要提交操作证/呼号申请，管理员审批通过后才会生效。

截图占位：个人中心。建议展示资料编辑、头像、设备密码、操作证状态。

相关 API：

Method	Path	Auth	说明
GET	/api/me	JWT	当前用户信息。
PUT	/api/me	JWT	更新个人资料。
PUT	/api/me/password	JWT	修改自己密码。
PUT	/api/me/email	JWT	修改邮箱。
POST	/api/upload/file	JWT	通用文件上传，用于头像等。
POST	/api/upload/operator-certificate	JWT	上传操作证。
GET	/api/operator-certificate	JWT	查询本人操作证。

4. 设备准入密码

设备准入密码用于普通 UDP 设备认证。密码会加密存储，前端查询时通常以脱敏形式展示。

常见操作：

• 查看当前设备密码状态。
• 手动修改设备密码。
• 重新生成设备密码。

设备端认证时会提交用户名和设备密码。历史 bcrypt 设备密码在认证后会自动迁移为 AES 可逆密文。

相关 API：

Method	Path	Auth	说明
GET	/api/user/device-password	JWT	获取设备准入密码。
PUT	/api/user/device-password	JWT	修改设备准入密码。
POST	/api/user/device-password/regenerate	JWT	重新生成设备准入密码。

5. 公开用户信息

登录用户可查询其他用户的公开信息，用于页面展示或通信记录关联信息。

相关 API：

Method	Path	Auth	说明
GET	/api/users/:id/public	JWT	按 ID 获取用户公开信息。
GET	/api/users/name/:username/public	JWT	按用户名获取用户公开信息。