15 · 设备标注（底图标记）
所属板块：项目管理（单项目维度）
功能概述
设备标注用于在**项目平面图（底图）**上直观标出各设备的安装位置：
- 上传 / 更换项目底图（小区平面图、地下室平面图等图片）；
- 在底图上添加标注点（名称、安装位置描述、颜色），并可绑定台账中的设备；
- 单个增删改，或对整图批量保存。
标注不仅是可视化展示：告警短信中的「位置」信息即取自该设备标注的安装位置描述，因此告警类设备务必做好标注。
适用角色：
| 操作 | 超级管理员 | 系统管理员 | 项目主管 | 项目员工 |
|---|---|---|---|---|
| 查看标注 | ✅ | ✅ | ✅ | ✅ |
| 底图上传 / 标注增删改 / 批量保存 | ✅ 直接生效 | 申请后待审批 | ✅ 直接生效 | 申请后待项目主管审批 |
页面入口：项目详情 →「设备标注」页签。
上传底图
- 在设备标注页点击 上传底图。
- 选择图片文件（支持
jpg / jpeg / png / gif / bmp / webp格式）。 - 确认上传：
- 超级管理员 / 项目主管：文件立即生效，底图更新；
- 系统管理员 / 项目员工：文件先暂存临时目录，提示「底图已上传，等待审批」，审批通过后正式生效。
⚠️ 走审批的底图在审批通过前项目仍使用旧底图；若审批处理时临时文件已过期，会提示「临时文件已过期，请重新上传」。
添加 / 编辑标注
- 在底图上点击需标注的位置（或在工具栏点击 新增标注）。
- 填写标注信息：
| 字段 | 必填 | 说明 |
|---|---|---|
| 标记名称 | ✅ | 如「1 号水压计」「PLC 控制箱」 |
| 安装位置 | — | 位置文字描述，如「3 号楼地下室配电间」；告警短信中的「位置」取此字段，建议必填 |
| 颜色 | — | 标注点颜色（十六进制色值），默认蓝色 #1890FF |
| 坐标 X / Y | — | 标注点在底图上的百分比位置，拖动标注点自动更新 |
| 绑定设备 | — | 从本项目顶级设备中选择；绑定后可在地图页联动查看设备状态 |
- 点击 确定 保存（单个新增 / 编辑同样受审批流控制）。
删除标注
- 选中标注后点击 删除 并确认；
- 删除已绑定设备的标注不影响设备台账本身，但该设备的告警短信「位置」将显示为「-」。
批量保存（整图保存）
- 在底图上完成全部新增、拖动、编辑、删除操作。
- 点击 批量保存，一次性提交整图标注。
⚠️ 批量保存为覆盖式：系统先删除该项目全部旧标注，再按当前画布内容重新写入。批量保存前请确认画布上的标注完整无误，避免误删。
审批说明
标注相关的全部写操作（单个增删改、批量保存、底图上传）均纳入审批流：
常见问题
Q：告警短信里位置显示「-」？ 该设备未做标注，或标注未填写「安装位置」。请补齐标注信息。
Q：批量保存后标注不见了？ 批量保存是覆盖式写入，若提交时画布内容不完整会覆盖掉旧标注；待审批期间以旧数据为准，审批通过后才切换为新内容。请重新整理画布后再次提交。