主题
5. 项目管理
项目管理用于组织和分类设备，将设备按项目进行分组管理，便于按项目维度查看数据和管理权限。
5.1 项目总览
菜单路径：项目管理/项目总览
项目总览提供项目的整体统计和可视化展示。
5.1.1 统计信息
- 项目总数：系统中所有项目数量
- 项目设备数：各项目下的设备数量统计
- 项目告警数：各项目的告警统计
5.1.2 可视化展示
- 项目分布：项目的地理分布或分类分布
- 项目趋势：项目数量变化趋势
5.2 项目列表
菜单路径：项目管理/项目列表
5.2.1 列表功能
项目列表显示所有项目，包含以下信息：
- 项目名称
- 项目描述
- 项目状态：启用/禁用
- 关联设备数
- 创建时间
- 操作：查看详情、编辑、删除
5.2.2 搜索和筛选
- 搜索：支持按项目名称搜索
- 筛选：支持按项目状态筛选
5.2.3 项目操作
新增项目
权限要求：需要 project:info:create 权限
- 点击"新增"按钮
- 填写项目信息：
- 项目名称（必填）
- 项目描述（可选）
- 项目地址（可选）
- 其他信息
- 保存项目
编辑项目
权限要求：需要 project:info:edit 权限
在项目列表中点击"编辑"按钮修改项目信息。
删除项目
权限要求：需要 project:info:delete 权限
警告：删除项目前，请确保项目下没有关联设备，或已处理关联设备。
5.3 项目详情
访问方式：从项目列表点击项目进入详情页面
项目详情采用左侧模块导航 + 右侧内容区布局。可见模块由 项目角色权限 控制，不同成员看到的模块可能不同。
5.3.1 总览
权限要求：basic:view（项目级）
显示项目基本信息、成员概览、关键统计指标等。支持归档、删除等操作（需 basic:archive、basic:delete 等权限）。
5.3.2 设备管理
权限要求：device:view（项目级）
- 设备列表：查看项目下关联的所有设备
- 设备统计：在线/离线数量统计
- 添加/移除设备：管理项目与设备的关联关系（需相应编辑权限）
5.3.3 告警管理
权限要求：alarm:active 或 alarm:history（项目级）
- 查看项目维度的活跃告警与历史告警
- 按设备、级别、时间筛选告警
- 处理或确认告警（需相应操作权限）
5.3.4 图表
权限要求：chart:view（项目级）
查看项目配置的数据图表，支持按时间范围查看设备数据趋势。
5.3.5 可视化
权限要求：visualization:view（项目级）
查看项目配置的可视化大屏（go-view），用于项目监控展示。
5.3.6 项目视频
权限要求：project:video:view（项目级）
查看项目关联的摄像头列表，支持预览项目范围内的监控画面。
5.3.7 报表
权限要求：report:view（项目级）
查看项目报表数据，支持按配置的时间范围生成统计报表。
5.3.8 自动化
权限要求：automation:view（项目级）
查看和管理项目级自动化规则（跨设备的联动策略）。
5.3.9 资料库
权限要求：document:view（项目级）；管理需 document:manage
- 上传、下载项目相关文档资料
- 按分类管理技术文档、合同、图纸等
5.3.10 项目 Dashboard
与「数据可视化/项目 Dashboard」菜单功能互通，可在项目详情或独立菜单中管理 go-view 大屏。项目级查看 Dashboard 通常需 dashboard:view 权限。
注意：项目权限按项目 UID 隔离，权限代码（如
device:view）在不同项目中互不影响，需在每个项目中单独分配角色。
5.4 项目编辑
菜单路径：项目管理/编辑项目（从项目详情进入）
权限要求：需要 project:info:edit 权限（系统级）
项目编辑页面通过顶部标签切换不同配置模块：
5.4.1 基本信息
- 项目名称、描述、地址
- 项目状态（启用/禁用/归档）
5.4.2 角色配置
- 定义项目内角色（如管理员、运维、只读）
- 为每个角色分配项目模块权限（设备、告警、图表等）
5.4.3 用户管理
- 添加/移除项目成员
- 为成员分配项目角色
- 支持按昵称/用户名/邮箱搜索用户
5.4.4 设备管理
- 将设备加入项目或从项目移除
- 批量管理项目设备关联
5.4.5 图表配置
- 配置项目数据图表的数据源与展示方式
5.4.6 报表配置
- 配置项目报表模板与统计维度
5.4.7 能耗配置
- 配置项目能耗统计相关参数（如适用）
5.4.8 可视化配置
- 关联或管理项目的 go-view 可视化大屏
5.4.9 配置网关
访问路径：项目管理/编辑项目/配置网关（/project/edit/:id/gateway-setup）
权限要求：gateway:info:create
用于在项目场景下批量添加网关：
- 从项目编辑页进入「配置网关」
- 填写网关信息（模块 SN、验证码、南向配置等）
南向配置需事先在 Web 端创建并发布，详见 南向配置；Modbus RTU 场景参见 Modbus RTU 专章。
- 关联到当前项目
- 提交后网关及下属设备纳入项目管理
5.5 项目权限说明
5.5.1 系统菜单权限
project:overview:view：查看项目总览project:list:view：查看项目列表project:info:create：新增项目project:info:edit：编辑项目project:info:delete：删除项目
5.5.2 项目级权限（按项目隔离，常用）
| 权限代码 | 说明 |
|---|---|
basic:view | 查看项目总览 |
basic:edit | 编辑项目基本信息 |
device:view | 查看项目设备 |
alarm:active / alarm:history | 查看项目告警 |
chart:view | 查看项目图表 |
visualization:view | 查看项目可视化 |
project:video:view | 查看项目视频 |
report:view | 查看项目报表 |
automation:view | 查看项目自动化 |
document:view | 查看资料库 |
dashboard:view | 查看项目 Dashboard |
重要：项目权限与系统菜单权限独立。有「项目列表」菜单权限不代表能查看项目内所有模块，还需项目管理员分配项目角色。
5.6 常见问题
Q: 无法创建项目？
A: 检查：
- 是否有
project:info:create权限 - 项目名称是否已存在（需唯一）
Q: 项目下看不到设备？
A: 检查：
- 设备是否已关联到项目
- 是否有查看项目设备的权限
- 设备是否在你的权限范围内
Q: 项目权限不生效？
A: 检查：
- 是否在该项目中分配了项目角色
- 项目角色是否包含对应模块权限（如
device:view） - 项目 UID 是否正确
Q: 项目详情里看不到某些模块？
A: 检查：
- 项目角色是否开通了该模块权限
- 项目是否已配置对应资源（如图表、可视化、资料库）
- 联系项目管理员调整角色权限
更多跨模块问题见 常见问题索引。
下一步：了解了项目管理后，可以学习 工单管理 来处理工单流程。