系统管理总览
页面导读
适用场景适合平台管理员初始化组织、账号、角色、菜单权限、数据权限和基础系统参数。
前置条件已完成平台部署并可使用管理员账号登录，已规划机构层级、角色边界和数据权限。
操作路径系统管理 → 部门/机构 → 角色 → 用户 → 菜单 → 字典 → 参数配置。
验收点不同角色能看到正确菜单，设备和产品数据按机构隔离，普通用户不能越权操作。
一、初始化顺序
二、机构与部门
机构是多租户和数据隔离的基础。正式项目中建议先完成机构规划，再导入设备和用户。
| 配置项 | 说明 | 注意事项 |
|---|---|---|
| 机构名称 | 企业、项目、客户或部门名称 | 命名要能表达业务归属 |
| 上级机构 | 形成上下级数据管理关系 | 上级可按权限查看下级数据 |
| 管理员账号 | 当前机构管理员 | 每个机构建议有明确管理员 |
| 邀请码 | Web 注册绑定机构 | 需要配合角色权限使用 |
| 状态 | 正常或停用 | 停用会影响下级用户使用 |
三、角色与数据权限
角色决定用户能看什么菜单、能操作哪些按钮、能查询哪些数据。
| 数据权限 | 适用场景 |
|---|---|
| 全部数据权限 | 超级管理员或平台运维 |
| 本机构及以下数据权限 | 区域管理员、集团管理员 |
| 本机构数据权限 | 单个租户管理员 |
| 仅本人数据权限 | 普通业务人员，只看自己创建或分配的数据 |
| 自定义数据权限 | 特殊项目或跨组织协作 |
警告
设备、产品、场景、工单、报表等模块都可能受数据权限影响。排查“页面看不到数据”时，不要只看接口，也要检查角色数据范围。
四、用户管理
创建用户时重点确认：
| 字段 | 说明 |
|---|---|
| 所属机构 | 决定用户默认数据归属 |
| 角色 | 决定菜单、按钮和数据权限 |
| 手机/邮箱 | 登录、通知、工单提醒等业务可能使用 |
| 状态 | 停用后不可正常登录 |
| 密码策略 | 首次交付建议强制修改默认密码 |
终端用户与租户用户要区分：终端用户通常用于小程序/App 绑定设备，租户用户用于 Web 后台管理。
五、菜单与按钮权限
菜单权限决定页面是否可见，按钮权限决定新增、编辑、删除、导出、下发等操作是否可用。
| 类型 | 作用 | 示例 |
|---|---|---|
| 目录 | 左侧菜单分组 | 设备管理 |
| 菜单 | 可访问页面 | 产品管理、设备管理 |
| 按钮 | 页面操作权限 | 新增、删除、导出、指令下发 |
| 外链 | 跳转外部系统或大屏 | 可视化平台、在线演示 |
修改菜单后需要重新给角色授权，并让用户重新登录验证。
六、字典与参数配置
字典用于维护下拉选项、枚举文本和业务状态；参数配置用于控制系统级开关和默认值。
| 类型 | 示例 | 注意事项 |
|---|---|---|
| 字典类型 | 告警级别、卡平台、通知业务编码 | 修改字典可能影响前端显示和后端枚举 |
| 字典数据 | 启用/停用、等级、平台类型 | 保持键值稳定，避免影响历史数据 |
| 系统参数 | 登录配置、业务开关、第三方 Key | 修改前确认是否需要重启或清缓存 |
| 翻译配置 | 菜单、字典、物模型翻译 | 多语言场景需同步维护 |
七、验收清单
| 验收项 | 正常表现 |
|---|---|
| 机构 | 上下级机构关系正确 |
| 角色 | 菜单、按钮、数据权限符合预期 |
| 用户 | 不同用户登录后看到不同菜单和数据 |
| 数据隔离 | 下级看不到无权限的上级数据 |
| 指令权限 | 只有授权用户可下发设备指令 |
| 字典参数 | 页面下拉和业务状态显示正确 |
| 日志 | 登录日志、操作日志可追踪 |
八、常见问题
用户看不到菜单
检查角色是否分配菜单、菜单状态是否正常、路由地址是否正确、用户是否重新登录。
用户看得到页面但不能点按钮
检查按钮权限标识、角色授权、前端权限指令和后端权限注解。
用户看不到设备或产品
检查机构、角色数据权限、设备分配、产品私有状态和是否勾选显示上级机构产品。
终端用户和租户用户混淆
终端用户通常用于 App/小程序，租户用户用于 Web 后台。不要把终端用户直接授予后台管理权限。
九、二次开发入口
| 类型 | 路径或接口 | 说明 |
|---|---|---|
| 前端页面 | vue3/src/views/system/user | 用户管理 |
| 前端页面 | vue3/src/views/system/role | 角色管理 |
| 前端页面 | vue3/src/views/system/menu | 菜单权限 |
| 前端页面 | vue3/src/views/system/dept | 机构部门 |
| 前端页面 | vue3/src/views/system/dict、config | 字典和参数 |
| 后端接口 | /system/user、/system/role、/system/menu、/system/dept | 系统管理接口 |
| SQL 表 | sys_user、sys_role、sys_menu、sys_dept、sys_dict_* | 系统管理核心表 |