IoT 平台 Web 端用户手册

适用范围：iot-web（后台管理端）
建议阅读对象：最终用户与管理员（管理员章节会明确标注）
文档维护：本手册按模块拆分为多个文件，本文件为“主目录与总览”。

1. 如何使用本手册

• 按角色阅读：
  • 新租户管理员：优先 租户初始化，再 网关接入。
  • 新购网关 / 现场安装：优先 网关接入。
  • APP 终端用户：优先 APP 终端用户。
  • 所有用户：从「快速开始」开始，熟悉登录、导航、个人中心等基础操作。
  • 管理员：除业务章节外，重点阅读「权限管理」「系统设置」等管理员专用章节。
• 按问题查找：优先使用「目录」跳转到对应模块；遇到问题先看 常见问题索引（跨端排障），Web 端详情见 Web 常见问题 与「附录」。

2. 目录（点击跳转）

0. 快速上手索引
   • 租户初始化（管理员推荐）
   • 网关接入（工业网关场景）
   • APP 终端用户 0a. 常见问题索引（跨 Web / APP）
   • 账号与登录
   • 网关与南向接入
   • 设备与数据
   • 多级组织与账号管理
   • APP 常见问题
1. 快速开始
2. 工作台
3. 设备管理
4. 网关管理
   • 南向配置
   • 南向配置 - Modbus RTU
5. 项目管理
6. 售后服务
7. 告警管理
8. 固件管理
9. 视频中心
10. 数据可视化
11. 权限管理（管理员专用）
12. 系统设置（管理员专用）
    • 产品与物模型
    • 企业与全局配置
    • 网关型号
    • 审计、消息与知识库
13. Web 端常见问题
14. 附录

3. 系统简介

iot-web 是 IoT 平台的 Web 管理端，用于对 设备、网关、项目、告警、工单、维保、视频 等进行统一管理，并提供基于权限的菜单与操作控制。

3.1 主要功能概览

• 工作台/监控：查看核心指标、快速入口、监控面板等
• 设备管理：设备总览、设备列表、设备白标、设备详情（数据点/历史/告警/自动化/视频/售后/设备面板等）
• 网关管理：网关列表、网关详情、南向配置（含 Modbus RTU 采集）
• 项目管理：项目总览、项目列表、项目详情、项目编辑
• 告警管理：告警中心（查看、筛选、处理、确认等）
• 售后服务：售后总览、工单、维保合同/任务、回访任务
• 固件管理：设备固件包上传、发布与 OTA 升级管理
• 视频中心：摄像头管理、平台配置、实况大屏
• 数据可视化：项目 Dashboard、全局 Dashboard（基于 go-view）
• 权限与系统配置（管理员）：用户/角色/部门/菜单、产品型号/物模型/设备面板、企业信息（含专属客服）、全局配置、消息渠道、AI 知识库、审计日志等

3.2 权限与可见性说明（重要）

系统会基于你的账号权限：

• 动态显示菜单：你看见的菜单项可能与他人不同
• 控制按钮/操作：部分按钮可能不可见或不可点击
• 控制页面访问：无权限页面会被拦截并提示

因此，当你在本手册看到某功能但系统中未出现时，通常是 权限未开通 或 账号角色不同 所致。

4. 阅读约定

• 路径约定：本手册中的「菜单路径」采用“侧边栏菜单层级/页面名称”的写法（示例：设备管理/设备列表）。
• 术语：与设备、网关、项目相关的术语见「附录」。
• 截图：如后续需要补充截图，将统一放在 docs/user-guide/images/ 下，并在章节内引用。