用户与场景
用户角色
平台管理员
负责系统全局配置和用户管理，通过 Web 管理后台操作。
| 关注点 | 对应功能 | 页面 |
|---|---|---|
| 系统运行概览 | 设备总数、在线率、今日告警 | Dashboard |
| 用户管理 | 添加/禁用/删除用户，分配角色 | 用户管理 |
| 权限控制 | 创建角色，配置菜单+接口权限树 | 角色管理 |
| 菜单配置 | 动态路由、按钮权限 | 菜单管理 |
| 组织架构 | 部门树、成员归属 | 部门管理 |
| 数据字典 | 系统枚举值维护 | 字典管理 |
| 系统参数 | 全局配置项管理 | 系统配置 |
| 通知公告 | 发布/编辑/置顶系统公告 | 通知公告 |
| 审计追溯 | 操作日志查询、安全审计 | 操作日志 |
典型工作流：
Web 登录 → Dashboard 查看概览 → 用户管理（添加新成员）
→ 角色管理（给成员分配角色） → 操作日志（审计追溯）设备使用者
平台核心用户，通过微信小程序日常使用，关注名下设备的查看、控制和场景管理。
| 关注点 | 对应功能 | 页面 |
|---|---|---|
| 账号管理 | 注册/登录/找回密码、微信绑定 | 登录页、注册页 |
| 查看设备 | 所有设备的在线状态和关键数据 | 首页（设备列表） |
| 添加设备 | 新设备配网、激活上线 | 设备添加 |
| 设备控制 | 开关、参数调节、实时反馈 | 设备详情 |
| 设备管理 | 命名、信息查看、解绑 | 设备设置 |
| 数据趋势 | 历史数据查看 | 数据历史 |
| 家庭管理 | 多家庭/多房间、设备分组 | 家庭管理 |
| 个人设置 | 主题、密码、账号安全 | 设置、个人中心 |
典型工作流：
新用户上手：
下载小程序 → 注册账号 → 登录 → 空设备列表（引导添加）
→ 设备添加（扫码配网）→ 配网成功 → 命名设备 → 进入设备详情日常使用：
打开小程序（自动登录）→ 首页设备列表 → 点击设备
→ 设备详情（查看状态 + 控制开关）→ 返回列表家庭管理：
个人中心 → 家庭管理 → 创建"家"/"公司"
→ 进入设备设置 → 将设备归入指定家庭和房间
→ 首页按家庭切换视图开发者
负责设备接入和平台二次开发，主要使用文档和 Web 后台。
| 关注点 | 对应功能 | 入口 |
|---|---|---|
| 物模型规范 | JSON Schema、数据类型、定义示例 | 架构文档 |
| MQTT 协议 | Topic 规范、认证方式、Payload 格式 | MQTT 通信协议文档 |
| 设备接入 | ESP32 示例代码、最佳实践 | 设备接入指南 |
| 产品创建 | Web 后台创建产品、配置物模型 | Web 产品管理 |
| 调试排错 | 设备日志、MQTT 报文监控 | Web 后台 + EMQX Dashboard |
| API 开发 | REST 接口文档、错误码 | API 接口规范文档 |
典型工作流：
阅读架构文档 → Web 后台创建产品 → 编写物模型 JSON
→ ESP32 固件开发（参考接入指南）→ MQTT 调试
→ 设备激活注册 → 小程序验证设备上线 → 问题排查（日志+EMQX）使用场景
场景一：新用户注册并添加第一个设备
小王买了两个智能插座，下载小程序后完成注册，通过配网将插座加入平台。
操作步骤：
- 打开小程序，进入登录页 → 点击"注册"
- 输入账号、密码，完成注册 → 自动登录
- 首页显示空状态："还没有设备，点击添加"
- 点击"添加设备" → 选择"扫码配网"
- 扫描插座二维码 → 输入 WiFi 密码 → 等待配网
- 配网成功 → 为设备命名"客厅插座"
- 返回首页，设备卡片出现，显示在线状态
涉及页面： 注册 → 登录 → 首页（空状态）→ 设备添加 → 首页（有设备）
关键体验： 从注册到设备上线，全程不超过 3 分钟
场景二：日常设备控制
下班路上，通过小程序查看家里设备状态，提前打开热水器。
操作步骤：
- 打开小程序，首页显示所有设备卡片
- 看到"热水器"在线，点击进入设备详情
- 详情页展示当前温度、开关状态
- 点击"开机"按钮 → 显示 Loading → 收到执行反馈 → 状态变为"已开启"
- 返回首页，设备卡片摘要更新
涉及页面： 首页（设备列表）→ 设备详情 → 首页
关键体验： 打开小程序到完成控制 < 5 秒，操作反馈 < 2 秒
场景三：多家庭管理
小李把设备分别装在家和公司，通过家庭管理切换查看。
操作步骤：
- 进入"我的" → "家庭管理"
- 创建两个家庭：家（客厅+卧室）、公司（办公室）
- 返回首页 → 进入设备详情 → "设备设置"
- 将插座 1 归入"家 - 客厅"，插座 2 归入"公司 - 办公室"
- 首页顶部切换"家"/"公司"，设备列表按家庭过滤
- 选择"公司"，只显示办公室设备
涉及页面： 个人中心 → 家庭管理 → 设备设置 → 首页
场景四：设备维护与解绑
一个插座出现故障需要更换，用户解绑旧设备后添加新设备。
操作步骤：
- 首页找到故障设备 → 点击进入设备详情
- 右上角进入"设备设置"
- 查看设备信息（MAC、固件版本）确认型号
- 点击"解绑设备" → 二次确认 → 解绑成功
- 返回首页，设备已移除
- 新设备到货后，按"场景一"流程重新添加
涉及页面： 首页 → 设备详情 → 设备设置 → 首页 → 设备添加
场景五：工业设备监控（Web 后台）
工厂运维人员通过 Web 后台监控生产线设备，配置告警规则。
操作步骤：
- Web 登录 → Dashboard 显示今日设备在线率、告警数
- 进入"设备列表" → 筛选"产线设备" → 查看所有设备状态
- 点击某设备进入详情 → 查看实时数据和设备影子
- 进入"数据看板" → 选择时间范围 → 查看温度/振动趋势曲线
- 配置告警规则：温度 > 80°C 时，发送小程序通知
- 收到告警后，通过设备详情远程调整参数或停机
涉及页面： Dashboard → 设备列表 → 设备详情 → 数据看板
关键体验： 数据看板加载 < 1 秒，告警延迟 < 10 秒