主题
快速上手：租户初始化
本文面向 租户管理员、实施交付人员，帮助你在约 1～2 小时内完成新租户上线前的 基础配置，为后续 网关接入 和 APP 用户使用做好准备。
各步骤的详细说明请通过文内链接跳转到对应专章。
适用角色与阅读路径
| 角色 | 你需要做什么 | 重点阅读 |
|---|---|---|
| 租户管理员 | 产品、用户、权限 | 阶段 0～3 |
| 实施交付 | 按清单交付可运行环境 | 全文 + 交付清单 |
| 现场安装人员 | 只负责装网关 | 完成阶段 0～2 后转 网关接入 |
若你还不熟悉 Web 界面，可先阅读 快速开始。
交付速览清单
管理员完成以下项，即可进入网关接入阶段：
- [ ] 企业信息 已填写（名称、联系方式等）
- [ ] 租户 ID 已告知 APP 注册用户（向平台服务商确认或在本企业配置中查询）
- [ ] 至少 1 个产品型号 及 物模型 已配置（若安装网关时需选产品/填档案）
- [ ] 角色 已创建：管理员、实施/安装、业务查看（可按实际裁剪）
- [ ] 用户 已创建并分配角色（含现场安装与 APP 终端用户）
- [ ] （网关场景） 安装人员具备
gateway:info:create、gateway:config:edit等权限
整体流程
企业信息 → 产品/物模型 → 角色与用户 → 网关接入
↑ 管理员 Web ↑阶段 0：登录与规划
参与人：租户管理员
预计时间：10 分钟
- 使用管理员账号登录 Web 后台
- 确认侧边栏可见 系统设置、权限管理、网关管理 等菜单；若缺失，联系平台服务商开通权限
- 明确本租户交付范围（是否含 Modbus 网关、是否使用 APP 安装等）
阶段 1：企业与产品
参与人：租户管理员
预计时间：20～40 分钟
产出：企业信息完备；至少 1 套可用的产品/物模型（按需）
1.1 企业信息
路径：系统设置 → 企业信息
填写企业名称、Logo、地址、联系电话等。完成后将 租户 ID 告知需要注册 APP 的用户（租户 ID 为 APP 注册必填项）。
详见 企业信息配置。
1.2 产品型号（按需）
路径：系统设置 → 产品型号
若网关安装或设备档案需要选择「产品」，须预先创建产品型号：
- 点击「新增」，填写产品名称、产品编码（唯一）
- 保存后进入产品详情
详见 产品型号管理。
1.3 物模型（按需）
路径：产品详情 → 编辑物模型
为产品配置属性、事件、服务。APP 安装网关时若需填设备档案，字段往往与物模型/产品配置相关。
最小示例（温湿度类设备）：
| 类型 | 标识 | 名称 | 数据类型 |
|---|---|---|---|
| 属性 | temperature | 温度 | float |
| 属性 | humidity | 湿度 | float |
也可从 JSON 导入物模型，减少手工录入。详见 物模型管理。
网关 Modbus 采集 使用「南向配置」，与物模型是不同概念；二者关系见 南向配置 · 与物模型的关系，接入流程见 网关接入 · 阶段 1。
阶段 2：角色与用户
参与人：租户管理员
预计时间：20～30 分钟
产出：各岗位账号可登录，菜单与操作符合预期
2.1 创建角色
路径：权限管理 → 角色管理
建议至少准备三类 系统角色（名称可自定）：
| 角色 | 典型权限 |
|---|---|
| 租户管理员 | 系统设置、权限管理、网关与南向、项目管理 |
| 实施/安装 | 网关新增、南向配置、APP 安装相关 |
| 业务查看 | 设备/项目查看、告警查看，无配置权限 |
在角色编辑页勾选 菜单权限 与 操作权限。详见 8.2 角色管理。
2.2 创建用户并分配角色
路径：权限管理 → 用户管理
- 点击「新增」，填写用户名、手机号、初始密码
- 为用户分配上一步创建的角色
- 将 登录方式 告知用户：Web 用手机号/用户名；APP 用
手机号@租户ID
现场安装人员须具备网关与南向相关权限；APP 终端用户通常只需设备查看/控制类权限。详见 8.1 用户管理。
2.3 部门（可选）
若企业有组织架构要求，可在 权限管理 → 部门管理 中维护部门树，再将用户挂到对应部门。
若需让 下级组织（经销商、子公司、服务商等）自行管理员工与子组织账号，见 多级组织与账号管理。
阶段 3：交付验证
参与人：租户管理员
预计时间：10 分钟
按下列项自检后，即可进入网关接入：
| 检查项 | 期望结果 |
|---|---|
| 管理员可登录 Web | 关键菜单可见、可操作 |
| 实施账号可登录 | 可见网关管理、南向配置（按角色设计） |
| APP 测试账号可注册/登录 | 使用 手机号@租户ID 登录成功 |
| 产品/物模型（若需要） | 安装网关时可选产品、档案字段正常 |
下一步：按 快速上手：网关接入 完成首次数据上云。
若终端用户无需参与装网关，可同步提供 快速上手：APP 终端用户。
常见卡点速查
| 现象 | 最可能原因 | 处理 |
|---|---|---|
| 菜单大量缺失 | 角色权限未勾选对应菜单 | 编辑角色，补全菜单与操作权限 |
| APP 用户无法注册 | 未提供租户 ID 或 ID 错误 | 核对租户 ID 并告知用户 |
| 安装网关时无产品可选 | 未创建产品型号 | 完成阶段 1.2 |
| 安装时档案字段异常 | 物模型或租户档案未配置 | 检查产品与系统侧档案配置 |
| 按钮灰色不可点 | 缺少操作级权限码 | 在角色中勾选对应 gateway:*、project:* 等权限 |
权限码完整列表见 附录。
下一步阅读
- 网关与数据接入：快速上手：网关接入
- APP 终端用户：快速上手：APP 终端用户
- 权限详解：权限管理
- 系统配置详解：系统设置概览 · 产品与物模型 · 企业与全局配置
- 排障参考：常见问题索引 · Web 详细 FAQ
- 多级组织：多级组织与账号管理