1. 位置管理
菜单路径：运维管理 → 位置管理。 自后端 2.00.070 起，位置采用任意层级的完整路径，例如 园区/一号楼/三层/仓库。设备、网关和模板仍通过位置编码 location_code 关联位置。
1.1. 字段说明
| 字段 | 说明 |
|---|---|
code | 位置编码，新增时必填；设备、网关和模板引用该编码。路径迁移或修改不改变编码。 |
path | 包含当前位置名称的完整路径，在当前组织内唯一，以 / 分隔层级。 |
name | 当前位置名称，保存时取完整路径的最后一段。 |
remark | 备注。 |
address1、address2、zip_code | 详细地址与邮编。 |
phone、manager | 联系电话和负责人。 |
status | 位置状态。 |
longitude、latitude | 经纬度。 |
params | 扩展参数。 |
新增／编辑表单采用“父级路径 + 当前位置名称”，即时预览完整路径；不再要求固定填写区域、省、市。完整路径不能以 / 开头或结尾，不能有空层级、空白字符或逗号。上表列出数据字段，并不表示表单提供所有字段的输入框。
1.2. 分页列表与层级树
默认打开分页列表，可按名称、路径、编码查询；路径条件为完整路径精确匹配。列表提供导入、导出和选中记录删除。
切换到层级树后，左侧显示位置树，初始展示根级、子级收起。点击任意实际位置节点，右侧可查看位置资料、下级数量，以及本级或本级及子孙级设备／网关的分页列表。直属资产按当前节点编码关联；包含后代时请选择对应页签，见下文 2.00.083 范围说明。
树只显示真实位置记录，不补虚拟中间节点。例如已有 A 和 A/B/C，但没有 A/B 时，A/B/C 会作为根节点显示，原始路径仍保留。下级数量和分支删除范围按完整路径统计，因此可能包含显示在另一个根节点的记录。
右侧没有资产时，检查所选位置是否有设备／网关直接绑定，以及其 location_code 是否正确。
1.3. 新增、编辑与移动分支
- 新增顶级位置时，将父级设为顶级，填写编码、当前位置名称及其他资料。
- 新增下级时，在目标位置详情点击新增下级，或在新增表单选择已有实际位置作为父级；父级选择器支持搜索。
- 检查完整路径预览后保存。例如父级为
园区/一号楼/三层，名称为仓库，路径就是园区/一号楼/三层/仓库。 - 编辑位置时，可修改名称或父级以移动分支。父级选择会排除自身和全部下级，不能移入自身下级。
修改父路径会在同一数据库事务中同步更新全部后代路径前缀；若有路径冲突，整批回滚，不会只移动一部分。位置 ID 和编码保持不变，设备、网关无需因改路径而重新绑定。已有位置若缺少实际父记录，未修改父路径时会保留原路径，不因树中显示为根节点而改写。
1.4. 删除位置
| 操作入口 | 删除范围 | 设备／网关影响 |
|---|---|---|
| 分页列表删除 | 只删除选中的位置记录，不递归删除下级。 | 不删除设备／网关，也不自动清除其绑定编码。 |
| 层级树分支删除 | 删除该完整路径及其全部下级位置记录；确认框显示影响记录数。 | 不删除设备／网关，也不自动清除其绑定编码。 |
删除前核对范围
树上可见的子节点不一定覆盖完整分支，尤其是存在缺失父记录时。确认分支删除前核对影响记录数。删除后，资产可能仍保存一个已不存在的位置编码；如需继续按位置查询，请手动为受影响设备／网关选择有效位置。
1.5. Excel 导入导出与旧数据迁移
位置 Excel 导入导出改用 path，替代旧 area、province、city 三列地域格式。请重新导出新版模板或数据样例，填写含名称的完整路径，再导入。编辑已有位置保留原 ID；同批修改父路径时，未修改的子行旧路径会跟随父级级联更新，不会撤销父级变更结果。
升级迁移会用旧“区域/省/市/名称”拼接路径，跳过空地域；名称为空时用编码兜底。原名称和地域原始值备份到 legacy_hierarchy，旧地域列仍保留，但不再作为业务层级字段。特殊字符转为百分号文本，重复路径以原 ID 等后缀消歧。已有非空路径和已有备份不覆盖，原 ID、编码及设备／网关绑定编码保持不变。
迁移不会移动对象存储文件。仅拉取代码不代表数据库已经升级，部署前请阅读系统升级中的 2.00.070 注意事项。
1.6. 与设备、网关、模板的关系
- 设备和网关通过
location_code选择已有位置，界面显示完整路径；路径、名称和编码是不同字段。 - 设备配置模板可预置
location_code，供后续创建或导入设备使用。 - 批量导入设备时仍使用
location_code；这与位置表导入使用path不同。如果设备导入中的位置编码不存在，平台会将该设备的位置置为空并继续导入。
建议先维护位置，再在设备 Excel 中填写对应的 code。
本级与本级及子孙级（2.00.083）
在位置详情分别选择本级或本级及子孙级的设备／网关页签。本级只查看直接绑定当前位置的资产；子孙级包含当前位置和后代位置。先确认页签范围，再读取分页总数，不能把当前页数量作为整个范围总量。
设备按需查询使用 /thinklink/device/find-page-by-fields 的 location_code_subtree；网关使用 /thinklink/gateway/find-page 的同名参数。原列表 location_code 仍表示本级。子树根据正式位置 path 的完整边界判断，不能按 code 字符串前缀匹配；不存在的位置返回空范围，不回退到全部组织设备。
正式位置树与部门范围不同。业务空间按实际设备绑定确定范围，不能默认等于一个位置子树。汇总需要完整分页，失败、未加载或过期保留状态。详见微应用读取示例。