第八部分：用户手册（概要）
8.1 平台操作指南
8.1.1 登录与注册
- 访问
https://iot.xxx.com，首次使用需注册企业账号 - 登录后进入仪表盘
8.1.2 设备管理
- 添加设备：点击“设备管理”→“添加设备”→输入设备ID和密钥（设备外壳标签上）→选择协议→完成
- 查看设备：列表显示设备状态，点击可查看实时数据与历史曲线
8.1.3 远程控制
- 在设备详情页，点击“控制”选项卡 → 选择控制命令（开关、调节等）→ 确认发送 → 显示执行结果
8.1.4 数据分析
- “数据报表”菜单 → 选择设备、时间范围、数据类型 → 生成图表，可导出Excel
8.2 硬件安装指南（以温湿度传感器为例）
- 打开包装，取出传感器主体和支架
- 使用附赠的Micro-USB线充电2小时（红灯充电，绿灯满电）
- 下载配网App或通过微信小程序，长按设备按键5秒进入配网模式
- 输入Wi-Fi密码，等待提示“配网成功”
- 登录平台查看设备是否在线
8.3 当前 MVP 管理后台操作（2026-09-12 补充）
8.1～8.2 是目标产品概要；本节与当前可运行工程一致。
8.3.1 登录与总览
- 启动 Spring Boot（8080）和 Vue 开发服务后，打开
http://127.0.0.1:5173/。 - 管理员使用
admin / admin123，运维使用operator / operator123。 - 总览显示设备总数、在线数、终端用户数、待处理告警、今日指令、消息趋势和最近告警。
- 右上角刷新按钮重新请求当前页面；退出按钮清除本地登录令牌。
8.3.2 产品与设备
- 进入“产品管理”查看 ProductKey、品类、协议、物模型版本和设备数量。
- 管理员点击“新建产品”，ProductKey 不能重复；运维角色只能查看产品。
- 进入“设备管理”可搜索名称/编号。点击“注册设备”，填写设备名称、唯一序列号、产品和固件版本。
- 新设备默认为离线、未绑定；创建结果含绑定码和设备凭据语义，生产系统只应一次显示设备密钥。
8.3.3 指令、告警和审计
- 在设备行点击“下发指令”。页面提交后状态为 SENT；只有设备 ACK 经 EMQX/Kafka 返回后才显示 SUCCEEDED/FAILED。
- “告警中心”显示待处理/已恢复状态；点击“标记已处理”更新告警并记录审计。
- 只有管理员能打开“审计日志”，运维访问相应 API 会被后端拒绝。
8.4 当前 MVP 小程序操作
- 微信开发者工具导入
iot-platform-mvp/mini-program。 - 检查
config.js中的 API 地址。开发工具默认使用http://127.0.0.1:8080，真机改为开发机局域网 HTTPS 地址。 - 点击“使用本地演示身份”，或走微信一键登录适配入口。
- 设备页右上角点击“＋”，扫码或输入演示绑定码
IOT-GW-0002。 - 绑定成功后返回设备页并下拉刷新；进入设备详情查看当前属性、产品、协议、固件和最后活跃时间。
- 在线智能开关可以切换电源；离线设备禁用开关，避免向用户伪报即时成功。
- “我的”页可查看用户身份并退出登录。
8.5 常见问题
| 现象 | 处理 |
|---|---|
| 后台提示账号或密码错误 | 检查大小写；演示管理员为 admin/admin123 |
| 页面提示登录过期 | 重新登录；检查 Redis 连通性、iot:session:{token} 和 TTL |
| 小程序请求失败 | 确认后端已启动、config.js 地址可从当前设备访问、合法域名设置符合环境 |
| 绑定码无效 | 去除空格并核对标签；演示码为 IOT-GW-0002 |
| 设备已被绑定 | 当前所有者先申请解绑/转移；管理员不能直接把同一设备重复分配 |
| 设备离线 | 检查供电、网络、设备凭据、EMQX 连接、Kafka Bridge 和最后活跃时间 |
| 指令等待中 | 设备离线或尚未 ACK；不要重复快速点击，使用 commandId 查询结果 |
8.6 数据与账号注意事项
演示数据和默认密码只用于本地验证。生产使用独立账号、强密码/单点登录和 HTTPS；不要在截图、工单或聊天中发送设备密钥。用户只能查看本人设备，发现归属错误应停止控制并发起转移流程，由平台保留审计。