TJWaterServerBinary/.github/skills/business/network-assets/SKILL.md

---
name: api-operations-business-network-assets
description: 网络资产（节点/管段/设备）与空间拓扑接口集合。
version: 2.1.0
---

# 何时使用

当需求落在 **business/network-assets** 的接口范围时使用本技能。

# 输入要求

- 可选：`BASE_URL`（默认 `http://127.0.0.1:8000`）
- 可选：`AUTH_TOKEN`（按环境鉴权策略）
- 覆盖方法：`GET`, `POST`

# Action Skills

- `demands`: `demands/SKILL.md`
- `general`: `general/SKILL.md`
- `geometry`: `geometry/SKILL.md`
- `junctions`: `junctions/SKILL.md`
- `pipes`: `pipes/SKILL.md`
- `pumps`: `pumps/SKILL.md`
- `regions`: `regions/SKILL.md`
- `reservoirs`: `reservoirs/SKILL.md`
- `tags`: `tags/SKILL.md`
- `tanks`: `tanks/SKILL.md`
- `valves`: `valves/SKILL.md`

# 操作目录（Domain -> Scenario -> Action）

## Action: `demands`
- 详情技能：`demands/SKILL.md`
- `GET /api/v1/calculatedemandtonetwork/` - 计算需水量到整网分配
- `GET /api/v1/calculatedemandtonodes/` - 计算需水量到节点分配
- `GET /api/v1/calculatedemandtoregion/` - 计算需水量到区域分配
- `GET /api/v1/getdemandproperties/` - 获取需水量属性
- `GET /api/v1/getdemandschema` - 获取需水量属性架构
- `POST /api/v1/setdemandproperties/` - 设置需水量属性

## Action: `general`
- 详情技能：`general/SKILL.md`
- `POST /api/v1/deletelink/` - 删除管线
- `POST /api/v1/deletenode/` - 删除节点
- `GET /api/v1/getallscadaproperties/` - 获取所有SCADA点属性
- `GET /api/v1/getelementproperties/` - 获取元素属性
- `GET /api/v1/getelementpropertieswithtype/` - 获取指定类型元素属性
- `GET /api/v1/getelementtype/` - 获取元素类型
- `GET /api/v1/getelementtypevalue/` - 获取元素类型值
- `GET /api/v1/getlinkproperties/` - 获取管线属性
- `GET /api/v1/getlinks/` - 获取所有管线
- `GET /api/v1/getlinktype/` - 获取管线类型
- `GET /api/v1/getnodelinks/` - 获取节点的关联管线
- `GET /api/v1/getnodeproperties/` - 获取节点属性
- `GET /api/v1/getnodes/` - 获取所有节点
- `GET /api/v1/getnodetype/` - 获取节点类型
- `GET /api/v1/getscadaproperties/` - 获取SCADA点属性
- `GET /api/v1/getstatus/` - 获取管线状态
- `GET /api/v1/getstatusschema` - 获取状态属性架构
- `GET /api/v1/gettitle/` - 获取水网标题属性
- `GET /api/v1/gettitleschema/` - 获取标题属性架构
- `GET /api/v1/isjunction/` - 检查是否为接点
- `GET /api/v1/islink/` - 检查管线有效性
- `GET /api/v1/isnode/` - 检查节点有效性
- `GET /api/v1/ispipe/` - 检查是否为管道
- `GET /api/v1/ispump/` - 检查是否为泵
- `GET /api/v1/isreservoir/` - 检查是否为水源
- `GET /api/v1/istank/` - 检查是否为蓄水池
- `GET /api/v1/isvalve/` - 检查是否为阀门
- `POST /api/v1/setstatus/` - 设置管线状态
- `GET /api/v1/settitle/` - 设置水网标题属性

## Action: `geometry`
- 详情技能：`geometry/SKILL.md`
- `GET /api/v1/getmajornodecoords/` - 获取主要节点坐标
- `GET /api/v1/getmajorpipenodes/` - 获取主要管道节点
- `GET /api/v1/getnetworkgeometries/` - 获取完整网络几何信息
- `GET /api/v1/getnetworkinextent/` - 获取范围内的网络元素
- `GET /api/v1/getnetworklinknodes/` - 获取网络管线节点
- `GET /api/v1/getnodecoord/` - 获取节点坐标

## Action: `junctions`
- 详情技能：`junctions/SKILL.md`
- `POST /api/v1/addjunction/` - 添加节点
- `POST /api/v1/deletejunction/` - 删除节点
- `GET /api/v1/getalljunctionproperties/` - 获取所有节点属性
- `GET /api/v1/getjunctioncoord/` - 获取节点坐标
- `GET /api/v1/getjunctiondemand/` - 获取节点需水量
- `GET /api/v1/getjunctionelevation/` - 获取节点标高
- `GET /api/v1/getjunctionpattern/` - 获取节点需水模式
- `GET /api/v1/getjunctionproperties/` - 获取节点属性
- `GET /api/v1/getjunctionschema` - 获取节点架构
- `GET /api/v1/getjunctionx/` - 获取节点 X 坐标
- `GET /api/v1/getjunctiony/` - 获取节点 Y 坐标
- `POST /api/v1/setjunctioncoord/` - 设置节点坐标
- `POST /api/v1/setjunctiondemand/` - 设置节点需水量
- `POST /api/v1/setjunctionelevation/` - 设置节点标高
- `POST /api/v1/setjunctionpattern/` - 设置节点需水模式
- `POST /api/v1/setjunctionproperties/` - 批量设置节点属性
- `POST /api/v1/setjunctionx/` - 设置节点 X 坐标
- `POST /api/v1/setjunctiony/` - 设置节点 Y 坐标

## Action: `pipes`
- 详情技能：`pipes/SKILL.md`
- `POST /api/v1/addpipe/` - 添加管道
- `POST /api/v1/deletepipe/` - 删除管道
- `GET /api/v1/getallpipeproperties/` - 获取所有管道属性
- `GET /api/v1/getpipediameter/` - 获取管道管径
- `GET /api/v1/getpipelength/` - 获取管道长度
- `GET /api/v1/getpipeminorloss/` - 获取管道局部阻力系数
- `GET /api/v1/getpipenode1/` - 获取管道起始节点
- `GET /api/v1/getpipenode2/` - 获取管道终止节点
- `GET /api/v1/getpipeproperties/` - 获取管道属性
- `GET /api/v1/getpiperoughness/` - 获取管道粗糙度
- `GET /api/v1/getpipeschema` - 获取管道模式
- `GET /api/v1/getpipestatus/` - 获取管道状态
- `POST /api/v1/setpipediameter/` - 设置管道管径
- `POST /api/v1/setpipelength/` - 设置管道长度
- `POST /api/v1/setpipeminorloss/` - 设置管道局部阻力系数
- `POST /api/v1/setpipenode1/` - 设置管道起始节点
- `POST /api/v1/setpipenode2/` - 设置管道终止节点
- `POST /api/v1/setpipeproperties/` - 设置管道属性
- `POST /api/v1/setpiperoughness/` - 设置管道粗糙度
- `POST /api/v1/setpipestatus/` - 设置管道状态

## Action: `pumps`
- 详情技能：`pumps/SKILL.md`
- `POST /api/v1/addpump/` - 添加水泵
- `POST /api/v1/deletepump/` - 删除水泵
- `GET /api/v1/getallpumpproperties/` - 获取所有水泵属性
- `GET /api/v1/getpumpnode1/` - 获取水泵起始节点
- `GET /api/v1/getpumpnode2/` - 获取水泵终止节点
- `GET /api/v1/getpumpproperties/` - 获取水泵属性
- `GET /api/v1/getpumpschema` - 获取水泵模式
- `POST /api/v1/setpumpnode1/` - 设置水泵起始节点
- `POST /api/v1/setpumpnode2/` - 设置水泵终止节点
- `POST /api/v1/setpumpproperties/` - 设置水泵属性

## Action: `regions`
- 详情技能：`regions/SKILL.md`
- `POST /api/v1/adddistrictmeteringarea/` - 添加新DMA
- `POST /api/v1/addregion/` - 添加新区域
- `POST /api/v1/addservicearea/` - 添加新服务区
- `POST /api/v1/addvirtualdistrict/` - 添加新虚拟分区
- `GET /api/v1/calculatedistrictmeteringarea/` - 计算DMA分区
- `GET /api/v1/calculatedistrictmeteringareafornetwork/` - 计算整网DMA分区
- `GET /api/v1/calculatedistrictmeteringareafornodes/` - 计算节点DMA分区
- `GET /api/v1/calculatedistrictmeteringareaforregion/` - 计算区域内DMA分区
- `GET /api/v1/calculateregion/` - 计算区域
- `GET /api/v1/calculateservicearea/` - 计算服务区
- `GET /api/v1/calculatevirtualdistrict/` - 计算虚拟分区
- `POST /api/v1/deletedistrictmeteringarea/` - 删除DMA
- `POST /api/v1/deleteregion/` - 删除区域
- `POST /api/v1/deleteservicearea/` - 删除服务区
- `POST /api/v1/deletevirtualdistrict/` - 删除虚拟分区
- `POST /api/v1/generatedistrictmeteringarea/` - 生成DMA分区
- `POST /api/v1/generateregion/` - 生成区域分区
- `POST /api/v1/generateservicearea/` - 生成服务区分区
- `POST /api/v1/generatesubdistrictmeteringarea/` - 生成DMA子分区
- `POST /api/v1/generatevirtualdistrict/` - 生成虚拟分区
- `GET /api/v1/getalldistrictmeteringareaids/` - 获取所有DMA ID
- `GET /api/v1/getalldistrictmeteringareas/` - 获取所有DMA
- `GET /api/v1/getallregions/` - 获取所有区域
- `GET /api/v1/getallserviceareas/` - 获取所有服务区
- `GET /api/v1/getallvirtualdistrict/` - 获取所有虚拟分区
- `GET /api/v1/getdistrictmeteringarea/` - 获取DMA信息
- `GET /api/v1/getdistrictmeteringareaschema/` - 获取DMA属性架构
- `GET /api/v1/getregion/` - 获取区域信息
- `GET /api/v1/getregionschema/` - 获取区域属性架构
- `GET /api/v1/getservicearea/` - 获取服务区信息
- `GET /api/v1/getserviceareaschema/` - 获取服务区属性架构
- `GET /api/v1/getvirtualdistrict/` - 获取虚拟分区信息
- `GET /api/v1/getvirtualdistrictschema/` - 获取虚拟分区属性架构
- `POST /api/v1/setdistrictmeteringarea/` - 设置DMA属性
- `POST /api/v1/setregion/` - 设置区域属性
- `POST /api/v1/setservicearea/` - 设置服务区属性
- `POST /api/v1/setvirtualdistrict/` - 设置虚拟分区属性

## Action: `reservoirs`
- 详情技能：`reservoirs/SKILL.md`
- `POST /api/v1/addreservoir/` - 添加水库
- `POST /api/v1/deletereservoir/` - 删除水库
- `GET /api/v1/getallreservoirproperties/` - 获取所有水库属性
- `GET /api/v1/getreservoircoord/` - 获取水库坐标
- `GET /api/v1/getreservoirhead/` - 获取水库水头
- `GET /api/v1/getreservoirpattern/` - 获取水库模式
- `GET /api/v1/getreservoirproperties/` - 获取水库属性
- `GET /api/v1/getreservoirschema` - 获取水库模式
- `GET /api/v1/getreservoirx/` - 获取水库X坐标
- `GET /api/v1/getreservoiry/` - 获取水库Y坐标
- `POST /api/v1/setreservoircoord/` - 设置水库坐标
- `POST /api/v1/setreservoirhead/` - 设置水库水头
- `POST /api/v1/setreservoirpattern/` - 设置水库模式
- `POST /api/v1/setreservoirproperties/` - 设置水库属性
- `POST /api/v1/setreservoirx/` - 设置水库X坐标
- `POST /api/v1/setreservoiry/` - 设置水库Y坐标

## Action: `tags`
- 详情技能：`tags/SKILL.md`
- `GET /api/v1/gettag/` - 获取标签信息
- `GET /api/v1/gettags/` - 获取所有标签
- `GET /api/v1/gettagschema/` - 获取标签属性架构
- `POST /api/v1/settag/` - 设置标签

## Action: `tanks`
- 详情技能：`tanks/SKILL.md`
- `POST /api/v1/addtank/` - 新增水箱
- `POST /api/v1/deletetank/` - 删除水箱
- `GET /api/v1/getalltankproperties/` - 获取所有水箱属性
- `GET /api/v1/gettankcoord/` - 获取水箱坐标
- `GET /api/v1/gettankdiameter/` - 获取水箱直径
- `GET /api/v1/gettankelevation/` - 获取水箱标高
- `GET /api/v1/gettankinitlevel/` - 获取水箱初始水位
- `GET /api/v1/gettankmaxlevel/` - 获取水箱最大水位
- `GET /api/v1/gettankminlevel/` - 获取水箱最小水位
- `GET /api/v1/gettankminvol/` - 获取水箱最小体积
- `GET /api/v1/gettankoverflow/` - 获取水箱溢流口
- `GET /api/v1/gettankproperties/` - 获取水箱属性
- `GET /api/v1/gettankschema` - 获取水箱模式
- `GET /api/v1/gettankvolcurve/` - 获取水箱容积曲线
- `GET /api/v1/gettankx/` - 获取水箱X坐标
- `GET /api/v1/gettanky/` - 获取水箱Y坐标
- `POST /api/v1/settankcoord/` - 设置水箱坐标
- `POST /api/v1/settankdiameter/` - 设置水箱直径
- `POST /api/v1/settankelevation/` - 设置水箱标高
- `POST /api/v1/settankinitlevel/` - 设置水箱初始水位
- `POST /api/v1/settankmaxlevel/` - 设置水箱最大水位
- `POST /api/v1/settankminlevel/` - 设置水箱最小水位
- `POST /api/v1/settankminvol/` - 设置水箱最小体积
- `POST /api/v1/settankoverflow/` - 设置水箱溢流口
- `POST /api/v1/settankproperties/` - 设置水箱属性
- `POST /api/v1/settankvolcurve/` - 设置水箱容积曲线
- `POST /api/v1/settankx/` - 设置水箱X坐标
- `POST /api/v1/settanky/` - 设置水箱Y坐标

## Action: `valves`
- 详情技能：`valves/SKILL.md`
- `POST /api/v1/addvalve/` - 添加阀门
- `POST /api/v1/deletevalve/` - 删除阀门
- `GET /api/v1/getallvalveproperties/` - 获取所有阀门属性
- `GET /api/v1/getvalvediameter/` - 获取阀门直径
- `GET /api/v1/getvalveminorloss/` - 获取阀门损失系数
- `GET /api/v1/getvalvenode1/` - 获取阀门起点节点
- `GET /api/v1/getvalvenode2/` - 获取阀门终点节点
- `GET /api/v1/getvalveproperties/` - 获取阀门所有属性
- `GET /api/v1/getvalveschema` - 获取阀门架构
- `GET /api/v1/getvalvesetting/` - 获取阀门开度
- `GET /api/v1/getvalvetype/` - 获取阀门类型
- `POST /api/v1/setvalvenode1/` - 设置阀门起点节点
- `POST /api/v1/setvalvenode2/` - 设置阀门终点节点
- `POST /api/v1/setvalvenodediameter/` - 设置阀门直径
- `POST /api/v1/setvalveproperties/` - 批量设置阀门属性
- `POST /api/v1/setvalvesetting/` - 设置阀门开度
- `POST /api/v1/setvalvetype/` - 设置阀门类型

# See Also

- 关联组件配置: `../component-config`
- 关联仿真分析: `../../analytics/simulation-analysis`