{ "openapi": "3.0.1", "info": { "title": "【IF】福建水务营收系统", "description": "", "version": "1.0.0" }, "tags": [ { "name": "MeterManagement" }, { "name": "部门管理" }, { "name": "AddressManagement" }, { "name": "系统表格列配置" } ], "paths": { "/admin-api/business/meter-maker/page": { "get": { "summary": "获取水表厂家分页列表", "deprecated": false, "description": "获取所有水表厂家的分页列表，支持搜索和过滤", "operationId": "getMeterMakerList", "tags": [], "parameters": [ { "name": "pageNo", "in": "query", "description": "页码，从1开始", "required": false, "schema": { "type": "integer", "minimum": 1, "default": 1, "example": 1 } }, { "name": "pageSize", "in": "query", "description": "每页数量", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 20, "example": 20 } }, { "name": "name", "in": "query", "description": "厂家名称", "required": false, "example": "test", "schema": { "type": "string", "example": "name,-code" } }, { "name": "code", "in": "query", "description": "厂家代码", "required": false, "example": "WI2SCO111M", "schema": { "type": "string", "maxLength": 100, "example": "关键词" } }, { "name": "tag", "in": "header", "description": "默认全局带上tag参数，优先访问本地启动的服务", "example": "{{tag}}", "schema": { "type": "string", "default": "{{tag}}" } }, { "name": "Authorization", "in": "header", "description": "", "example": "{{authorization}}", "schema": { "type": "string", "default": "{{authorization}}" } }, { "name": "tenant-id", "in": "header", "description": "", "example": "{{tenant-id}}", "schema": { "type": "string", "default": "{{tenant-id}}" } } ], "responses": { "200": { "description": "水表厂家列表", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "data", "msg" ], "properties": { "code": { "type": "integer", "example": 0 }, "data": { "type": "object", "required": [ "list", "total" ], "properties": { "list": { "type": "array", "items": { "type": "object", "required": [ "id", "name", "code", "status", "createTime" ], "properties": { "id": { "type": "integer", "format": "int64", "description": "主键", "example": 1001 }, "name": { "type": "string", "description": "厂家名称", "maxLength": 100, "example": "威星智能股份有限公司" }, "code": { "type": "string", "description": "厂家代码", "maxLength": 100, "example": "WISCOM" }, "rechargeType": { "type": "string", "description": "充值类型" }, "address": { "type": "string", "description": "地址", "maxLength": 500, "example": "湖南省长沙市高新区麓谷大道698号" }, "contact": { "type": "string", "description": "联系人", "maxLength": 100, "example": "张三" }, "contactNumber": { "type": "string", "description": "联系号码", "maxLength": 100, "example": "13800138000" }, "remark": { "type": "string", "description": "备注", "maxLength": 500 }, "status": { "type": "integer", "description": "状态(0-否, 1-是)", "enum": [ 0, 1 ], "example": 1 }, "createTime": { "type": "string", "format": "date-time", "description": "创建时间", "readOnly": true, "example": "2023-12-01T10:30:00Z" }, "updateTime": { "type": "string", "format": "date-time", "description": "更新时间", "readOnly": true, "example": "2023-12-01T10:30:00Z" }, "creator": { "type": "string", "description": "创建人id", "readOnly": true, "maxLength": 100 }, "updater": { "type": "string", "description": "更新人id", "readOnly": true, "maxLength": 100 }, "deleted": { "type": "boolean", "description": "是否删除", "readOnly": true, "example": false }, "tenantId": { "type": "integer", "format": "int64", "description": "租户id", "readOnly": true, "example": 0 } } } }, "total": { "type": "integer", "example": 20 } } }, "msg": { "type": "string", "example": "" } } } } }, "headers": {} } }, "security": [] } }, "/admin-api/business/meter-maker/get": { "get": { "summary": "获取水表厂家详情", "deprecated": false, "description": "获取所有水表厂家的分页列表，支持搜索和过滤", "operationId": "getMeterMakerList", "tags": [], "parameters": [ { "name": "id", "in": "query", "description": "主键", "required": false, "schema": { "type": "string", "example": "ACTIVE" } }, { "name": "tag", "in": "header", "description": "默认全局带上tag参数，优先访问本地启动的服务", "example": "{{tag}}", "schema": { "type": "string", "default": "{{tag}}" } }, { "name": "Authorization", "in": "header", "description": "", "example": "{{authorization}}", "schema": { "type": "string", "default": "{{authorization}}" } }, { "name": "tenant-id", "in": "header", "description": "", "example": "{{tenant-id}}", "schema": { "type": "string", "default": "{{tenant-id}}" } } ], "responses": { "200": { "description": "水表厂家列表", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "data", "msg" ], "properties": { "code": { "type": "integer", "example": 0 }, "data": { "type": "object", "required": [ "id", "name", "code", "status", "createTime" ], "properties": { "id": { "type": "integer", "format": "int64", "description": "主键", "example": 1001 }, "name": { "type": "string", "description": "厂家名称", "maxLength": 100, "example": "威星智能股份有限公司" }, "code": { "type": "string", "description": "厂家代码", "maxLength": 100, "example": "WISCOM" }, "rechargeType": { "type": "string", "description": "充值类型", "maxLength": 10, "example": "CARD" }, "address": { "type": "string", "description": "地址", "maxLength": 500, "example": "湖南省长沙市高新区麓谷大道698号" }, "contact": { "type": "string", "description": "联系人", "maxLength": 100, "example": "张三" }, "contactNumber": { "type": "string", "description": "联系号码", "maxLength": 100, "example": "13800138000" }, "remark": { "type": "string", "description": "备注", "maxLength": 500 }, "status": { "type": "integer", "description": "状态(0-否, 1-是)", "enum": [ 0, 1 ], "example": 1 }, "createTime": { "type": "string", "format": "date-time", "description": "创建时间", "readOnly": true, "example": "2023-12-01T10:30:00Z" }, "updateTime": { "type": "string", "format": "date-time", "description": "更新时间", "readOnly": true, "example": "2023-12-01T10:30:00Z" }, "creator": { "type": "string", "description": "创建人id", "readOnly": true, "maxLength": 100 }, "updater": { "type": "string", "description": "更新人id", "readOnly": true, "maxLength": 100 }, "deleted": { "type": "boolean", "description": "是否删除", "readOnly": true, "example": false }, "tenantId": { "type": "integer", "format": "int64", "description": "租户id", "readOnly": true, "example": 0 } } }, "msg": { "type": "string", "example": "" } } }, "example": { "code": 0, "data": { "id": 1001, "name": "威星智能股份有限公司", "code": "WISCOM", "rechargeType": "CARD", "address": "湖南省长沙市高新区麓谷大道698号", "contact": "张三", "contactNumber": "13800138000", "remark": "string", "status": 0, "createTime": "2023-12-01T10:30:00Z", "updateTime": "2023-12-01T10:30:00Z", "creator": "string", "updater": "string", "deleted": false, "tenantId": 0 }, "msg": "" } } }, "headers": {} } }, "security": [] } }, "/admin-api/business/meter-maker/list-all-simple": { "get": { "summary": "获取水表厂家下拉列表 ", "deprecated": false, "description": "获取所有水表厂家的分页列表，支持搜索和过滤", "operationId": "getMeterMakerList", "tags": [], "parameters": [ { "name": "tag", "in": "header", "description": "默认全局带上tag参数，优先访问本地启动的服务", "example": "{{tag}}", "schema": { "type": "string", "default": "{{tag}}" } }, { "name": "Authorization", "in": "header", "description": "", "example": "{{authorization}}", "schema": { "type": "string", "default": "{{authorization}}" } }, { "name": "tenant-id", "in": "header", "description": "", "example": "{{tenant-id}}", "schema": { "type": "string", "default": "{{tenant-id}}" } } ], "responses": { "200": { "description": "水表厂家列表", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data" ], "properties": { "code": { "type": "integer", "example": 0 }, "data": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "integer", "title": "integer", "description": "主键" }, "code": { "type": "string" }, "name": { "type": "string" } }, "required": [ "id", "code", "name" ] } }, "msg": { "type": "string" } } } } }, "headers": {} } }, "security": [] } }, "/admin-api/business/meter-maker/create": { "post": { "summary": "创建水表厂家", "deprecated": false, "description": "创建新的水表厂家信息", "operationId": "createMeterMaker", "tags": [ "MeterManagement" ], "parameters": [ { "name": "tag", "in": "header", "description": "默认全局带上tag参数，优先访问本地启动的服务", "example": "{{tag}}", "schema": { "type": "string", "default": "{{tag}}" } }, { "name": "Authorization", "in": "header", "description": "", "example": "{{authorization}}", "schema": { "type": "string", "default": "{{authorization}}" } }, { "name": "tenant-id", "in": "header", "description": "", "example": "{{tenant-id}}", "schema": { "type": "string", "default": "{{tenant-id}}" } } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "name": { "type": "string" }, "code": { "type": "string" }, "rechargeType": { "type": "integer" }, "address": { "type": "string" }, "contact": { "type": "string" }, "contactNumber": { "type": "string" }, "remark": { "type": "string" } }, "required": [ "name", "code", "contactNumber" ] }, "example": { "name": "威星智能股份有限公司", "code": "WISCOM", "rechargeType": "CARD", "address": "湖南省长沙市高新区麓谷大道698号", "contact": "张三", "contactNumber": "13800138000", "remark": "描述" } } } }, "responses": { "200": { "description": "创建成功", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "integer" }, "data": { "type": "boolean" }, "msg": { "type": "string" } }, "required": [ "code", "data", "msg" ] } } }, "headers": {} } }, "security": [] } }, "/admin-api/business/meter-maker/update": { "put": { "summary": "修改水表厂家", "deprecated": false, "description": "", "operationId": "createMeterMaker", "tags": [ "MeterManagement" ], "parameters": [ { "name": "tag", "in": "header", "description": "默认全局带上tag参数，优先访问本地启动的服务", "example": "{{tag}}", "schema": { "type": "string", "default": "{{tag}}" } }, { "name": "Authorization", "in": "header", "description": "", "example": "{{authorization}}", "schema": { "type": "string", "default": "{{authorization}}" } }, { "name": "tenant-id", "in": "header", "description": "", "example": "{{tenant-id}}", "schema": { "type": "string", "default": "{{tenant-id}}" } } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "integer" }, "name": { "type": "string" }, "code": { "type": "string" }, "rechargeType": { "type": "string" }, "address": { "type": "string" }, "contact": { "type": "string" }, "contactNumber": { "type": "string" }, "remark": { "type": "string" } }, "required": [ "id" ] }, "example": { "id": 1, "name": "威星智能股份有限公司", "code": "WISCOM", "rechargeType": "CARD", "address": "湖南省长沙市高新区麓谷大道698号", "contact": "张三", "contactNumber": "13800138000", "remark": "描述" } } } }, "responses": { "200": { "description": "创建成功", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "integer" }, "data": { "type": "boolean" }, "msg": { "type": "string" } }, "required": [ "code", "data", "msg" ] } } }, "headers": {} } }, "security": [] } }, "/admin-api/business/meter-maker/delete": { "delete": { "summary": "删除水表厂家", "deprecated": false, "description": "", "operationId": "createMeterMaker", "tags": [ "MeterManagement" ], "parameters": [ { "name": "id", "in": "query", "description": "integer，主键", "required": true, "example": "1", "schema": { "type": "string" } }, { "name": "tag", "in": "header", "description": "默认全局带上tag参数，优先访问本地启动的服务", "example": "{{tag}}", "schema": { "type": "string", "default": "{{tag}}" } }, { "name": "Authorization", "in": "header", "description": "", "example": "{{authorization}}", "schema": { "type": "string", "default": "{{authorization}}" } }, { "name": "tenant-id", "in": "header", "description": "", "example": "{{tenant-id}}", "schema": { "type": "string", "default": "{{tenant-id}}" } } ], "responses": { "200": { "description": "创建成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "data", "msg" ], "properties": { "code": { "type": "integer" }, "data": { "type": "boolean" }, "msg": { "type": "string" } } } } }, "headers": {} } }, "security": [] } }, "/admin-api/business/meter-maker/update-status": { "put": { "summary": "修改水表厂家状态", "deprecated": false, "description": "更新厂家的状态", "tags": [], "parameters": [ { "name": "tag", "in": "header", "description": "默认全局带上tag参数，优先访问本地启动的服务", "example": "{{tag}}", "schema": { "type": "string", "default": "{{tag}}" } }, { "name": "Authorization", "in": "header", "description": "", "example": "{{authorization}}", "schema": { "type": "string", "default": "{{authorization}}" } }, { "name": "tenant-id", "in": "header", "description": "", "example": "{{tenant-id}}", "schema": { "type": "string", "default": "{{tenant-id}}" } } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "integer", "description": "主键" }, "status": { "type": "integer" } }, "required": [ "id", "status" ] }, "examples": {} } } }, "responses": { "200": { "description": "", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "integer" }, "data": { "type": "boolean" }, "msg": { "type": "string" } }, "required": [ "code", "msg" ] } } }, "headers": {} } }, "security": [] } }, "/admin-api/business/meter-maker/delete-list": { "delete": { "summary": "批量删除水表厂家", "deprecated": false, "description": "", "tags": [], "parameters": [ { "name": "ids", "in": "query", "description": "integer，主键", "required": false, "example": [ "1", "2", "3" ], "schema": { "type": "array", "items": { "type": "string" } } }, { "name": "tag", "in": "header", "description": "默认全局带上tag参数，优先访问本地启动的服务", "example": "{{tag}}", "schema": { "type": "string", "default": "{{tag}}" } }, { "name": "Authorization", "in": "header", "description": "", "example": "{{authorization}}", "schema": { "type": "string", "default": "{{authorization}}" } }, { "name": "tenant-id", "in": "header", "description": "", "example": "{{tenant-id}}", "schema": { "type": "string", "default": "{{tenant-id}}" } } ], "responses": { "200": { "description": "", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "integer" }, "data": { "type": "boolean" }, "msg": { "type": "string" } }, "required": [ "code", "msg" ] } } }, "headers": {} } }, "security": [] } }, "/admin-api/business/meter-model/page": { "get": { "summary": "获取水表分页型号", "deprecated": false, "description": "", "operationId": "getMeterMakerList", "tags": [ "MeterManagement" ], "parameters": [ { "name": "pageNo", "in": "query", "description": "页码，从1开始", "required": false, "schema": { "type": "integer", "minimum": 1, "default": 1, "example": 1 } }, { "name": "pageSize", "in": "query", "description": "每页数量", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 20, "example": 20 } }, { "name": "code", "in": "query", "description": "型号代码", "required": false, "schema": { "type": "string", "example": "name,-code" } }, { "name": "name", "in": "query", "description": "型号名称", "required": false, "schema": { "type": "string", "maxLength": 100, "example": "关键词" } }, { "name": "tag", "in": "header", "description": "默认全局带上tag参数，优先访问本地启动的服务", "example": "{{tag}}", "schema": { "type": "string", "default": "{{tag}}" } }, { "name": "Authorization", "in": "header", "description": "", "example": "{{authorization}}", "schema": { "type": "string", "default": "{{authorization}}" } }, { "name": "tenant-id", "in": "header", "description": "", "example": "{{tenant-id}}", "schema": { "type": "string", "default": "{{tenant-id}}" } } ], "responses": { "200": { "description": "水表厂家列表", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "data", "msg" ], "properties": { "code": { "type": "integer", "example": 0 }, "data": { "type": "object", "required": [ "list", "total" ], "properties": { "list": { "type": "array", "items": { "type": "object", "required": [ "id", "makerCode", "name", "code", "status", "caliberRange", "remark", "maker" ], "properties": { "id": { "type": "integer", "format": "int64", "description": "主键", "example": 2001 }, "code": { "type": "string", "description": "型号代码", "maxLength": 100, "example": "WISCOM-LXSY-15E" }, "name": { "type": "string", "description": "型号名称", "maxLength": 100, "example": "LXSY-15E" }, "makerCode": { "type": "string", "description": "厂家代码", "maxLength": 100, "example": "WISCOM" }, "maker": { "type": "object", "properties": { "id": { "type": "integer", "description": "厂家id" }, "code": { "type": "string", "description": "厂家代码" }, "name": { "type": "string", "description": "厂家名称（关联查询）" } }, "required": [ "id", "code", "name" ] }, "caliberRange": { "type": "string", "description": "口径范围", "maxLength": 200, "example": "DN15-DN200" }, "remark": { "type": "string", "description": "备注", "maxLength": 500 }, "status": { "type": "integer", "description": "状态(0-否, 1-是)", "enum": [ 0, 1 ], "example": 1 }, "createTime": { "type": "string", "format": "date-time", "description": "创建时间", "readOnly": true, "example": "2023-12-01T10:30:00Z" }, "updateTime": { "type": "string", "format": "date-time", "description": "更新时间", "readOnly": true, "example": "2023-12-01T10:30:00Z" }, "creator": { "type": "string", "description": "创建人id", "readOnly": true, "maxLength": 100 }, "updater": { "type": "string", "description": "更新人id", "readOnly": true, "maxLength": 100 }, "deleted": { "type": "integer", "description": "是否删除" }, "tenantId": { "type": "integer", "format": "int64", "description": "租户id", "readOnly": true, "example": 0 } } } }, "total": { "type": "integer", "example": 45 } } }, "msg": { "type": "string", "example": "" } } }, "example": { "code": 0, "data": { "list": [ { "id": 2001, "code": "WISCOM-LXSY-15E", "name": "LXSY-15E", "makerCode": "WISCOM", "maker": { "id": 0, "code": "string", "name": "string" }, "caliberRange": "DN15-DN200", "remark": "string", "status": 0, "createTime": "2023-12-01T10:30:00Z", "updateTime": "2023-12-01T10:30:00Z", "creator": "string", "updater": "string", "deleted": 0, "tenantId": 0 } ], "total": 45 }, "msg": "" } } }, "headers": {} } }, "security": [] } }, "/admin-api/business/meter-model/get": { "get": { "summary": "获取水表型号详情 ", "deprecated": false, "description": "获取所有水表厂家的分页列表，支持搜索和过滤", "operationId": "getMeterMakerList", "tags": [ "MeterManagement" ], "parameters": [ { "name": "id", "in": "query", "description": "主键", "required": false, "schema": { "type": "string", "example": "ACTIVE" } }, { "name": "tag", "in": "header", "description": "默认全局带上tag参数，优先访问本地启动的服务", "example": "{{tag}}", "schema": { "type": "string", "default": "{{tag}}" } }, { "name": "Authorization", "in": "header", "description": "", "example": "{{authorization}}", "schema": { "type": "string", "default": "{{authorization}}" } }, { "name": "tenant-id", "in": "header", "description": "", "example": "{{tenant-id}}", "schema": { "type": "string", "default": "{{tenant-id}}" } } ], "responses": { "200": { "description": "水表厂家列表", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "data", "msg" ], "properties": { "code": { "type": "integer", "example": 0 }, "data": { "type": "object", "required": [ "id", "name", "code" ], "properties": { "id": { "type": "integer", "format": "int64", "description": "主键", "example": 2001 }, "code": { "type": "string", "description": "型号代码", "maxLength": 100, "example": "WISCOM-LXSY-15E" }, "name": { "type": "string", "description": "型号名称", "maxLength": 100, "example": "LXSY-15E" }, "makerCode": { "type": "string", "description": "厂家代码", "maxLength": 100, "example": "WISCOM" }, "maker": { "type": "object", "properties": { "id": { "type": "integer", "description": "厂家id" }, "code": { "type": "string", "description": "厂家代码" }, "name": { "type": "string", "description": "厂家名称（关联查询）" } } }, "caliberRange": { "type": "string", "description": "口径范围", "maxLength": 200, "example": "DN15-DN200" }, "remark": { "type": "string", "description": "备注", "maxLength": 500 }, "status": { "type": "integer", "description": "状态(0-否, 1-是)", "enum": [ 0, 1 ], "example": 1 }, "createTime": { "type": "string", "format": "date-time", "description": "创建时间", "readOnly": true, "example": "2023-12-01T10:30:00Z" }, "updateTime": { "type": "string", "format": "date-time", "description": "更新时间", "readOnly": true, "example": "2023-12-01T10:30:00Z" }, "creator": { "type": "string", "description": "创建人id", "readOnly": true, "maxLength": 100 }, "updater": { "type": "string", "description": "更新人id", "readOnly": true, "maxLength": 100 }, "deleted": { "type": "integer", "description": "是否删除" }, "tenantId": { "type": "integer", "format": "int64", "description": "租户id", "readOnly": true, "example": 0 } } }, "msg": { "type": "string", "example": "" } } }, "example": { "code": 0, "data": { "id": 2001, "code": "WISCOM-LXSY-15E", "name": "LXSY-15E", "makerCode": "WISCOM", "maker": { "id": 0, "code": "string", "name": "string" }, "caliberRange": "DN15-DN200", "remark": "string", "status": 0, "createTime": "2023-12-01T10:30:00Z", "updateTime": "2023-12-01T10:30:00Z", "creator": "string", "updater": "string", "deleted": false, "tenantId": 0 }, "msg": "" } } }, "headers": {} } }, "security": [] } }, "/admin-api/business/meter-model/list-all-simple": { "get": { "summary": "获取水表型号下拉列表", "deprecated": false, "description": "获取水表型号下拉列表", "operationId": "getMeterMakerList", "tags": [ "MeterManagement" ], "parameters": [ { "name": "tag", "in": "header", "description": "默认全局带上tag参数，优先访问本地启动的服务", "example": "{{tag}}", "schema": { "type": "string", "default": "{{tag}}" } }, { "name": "Authorization", "in": "header", "description": "", "example": "{{authorization}}", "schema": { "type": "string", "default": "{{authorization}}" } }, { "name": "tenant-id", "in": "header", "description": "", "example": "{{tenant-id}}", "schema": { "type": "string", "default": "{{tenant-id}}" } } ], "responses": { "200": { "description": "水表厂家列表", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "data", "msg" ], "properties": { "code": { "type": "integer", "example": 0 }, "data": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "integer", "title": "integer", "description": "主键" }, "code": { "type": "string" }, "name": { "type": "string" } }, "required": [ "id", "code", "name" ] } }, "msg": { "type": "string" } } }, "example": { "code": 0, "data": [ { "id": 45, "code": "82", "name": "皋洁" }, { "id": 90, "code": "22", "name": "玄霞" } ], "msg": "eu" } } }, "headers": {} } }, "security": [] } }, "/admin-api/business/meter-model/create": { "post": { "summary": "创建水表型号", "deprecated": false, "description": "", "operationId": "createMeterMaker", "tags": [ "MeterManagement" ], "parameters": [ { "name": "tag", "in": "header", "description": "默认全局带上tag参数，优先访问本地启动的服务", "example": "{{tag}}", "schema": { "type": "string", "default": "{{tag}}" } }, { "name": "Authorization", "in": "header", "description": "", "example": "{{authorization}}", "schema": { "type": "string", "default": "{{authorization}}" } }, { "name": "tenant-id", "in": "header", "description": "", "example": "{{tenant-id}}", "schema": { "type": "string", "default": "{{tenant-id}}" } } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "name": { "type": "string" }, "code": { "type": "string" }, "makerCode": { "type": "string" }, "caliberRange": { "type": "string" }, "remark": { "type": "string" } }, "required": [ "name", "code" ] }, "example": { "name": "SC-LXS-15E", "code": "SC_LXS_15E", "makerCode": "SANCHUAN_001", "caliber_range": "DN15-DN200", "remark": "三川智慧15mm口径智能水表" } } } }, "responses": { "200": { "description": "创建成功", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "integer" }, "data": { "type": "boolean" }, "msg": { "type": "string" } }, "required": [ "code", "data", "msg" ] } } }, "headers": {} } }, "security": [] } }, "/admin-api/business/meter-model/update": { "put": { "summary": "修改水表型号", "deprecated": false, "description": "", "operationId": "createMeterMaker", "tags": [ "MeterManagement" ], "parameters": [ { "name": "tag", "in": "header", "description": "默认全局带上tag参数，优先访问本地启动的服务", "example": "{{tag}}", "schema": { "type": "string", "default": "{{tag}}" } }, { "name": "Authorization", "in": "header", "description": "", "example": "{{authorization}}", "schema": { "type": "string", "default": "{{authorization}}" } }, { "name": "tenant-id", "in": "header", "description": "", "example": "{{tenant-id}}", "schema": { "type": "string", "default": "{{tenant-id}}" } } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "integer" }, "data": { "type": "boolean" }, "msg": { "type": "string" } }, "required": [ "code", "data", "msg" ] }, "example": { "id": 1, "name": "SC-LXS-15E", "code": "SC_LXS_15E", "makerCode": "SANCHUAN_001", "caliberRange": "DN15-DN200", "remark": "三川智慧15mm口径智能水表" } } } }, "responses": { "200": { "description": "创建成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "data", "msg" ], "properties": { "code": { "type": "integer", "example": 0 }, "data": { "type": "boolean" }, "msg": { "type": "string", "example": "创建成功" } } } } }, "headers": {} } }, "security": [] } }, "/admin-api/business/meter-model/delete": { "delete": { "summary": "删除水表型号", "deprecated": false, "description": "", "operationId": "createMeterMaker", "tags": [ "MeterManagement" ], "parameters": [ { "name": "id", "in": "query", "description": "integer，主键", "required": true, "example": "1", "schema": { "type": "string" } }, { "name": "tag", "in": "header", "description": "默认全局带上tag参数，优先访问本地启动的服务", "example": "{{tag}}", "schema": { "type": "string", "default": "{{tag}}" } }, { "name": "Authorization", "in": "header", "description": "", "example": "{{authorization}}", "schema": { "type": "string", "default": "{{authorization}}" } }, { "name": "tenant-id", "in": "header", "description": "", "example": "{{tenant-id}}", "schema": { "type": "string", "default": "{{tenant-id}}" } } ], "responses": { "200": { "description": "创建成功", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "integer" }, "data": { "type": "boolean" }, "msg": { "type": "string" } }, "required": [ "code", "data", "msg" ] } } }, "headers": {} } }, "security": [] } }, "/admin-api/business/meter-model/update-status": { "put": { "summary": "修改水表型号状态", "deprecated": false, "description": "", "tags": [], "parameters": [ { "name": "tag", "in": "header", "description": "默认全局带上tag参数，优先访问本地启动的服务", "example": "{{tag}}", "schema": { "type": "string", "default": "{{tag}}" } }, { "name": "Authorization", "in": "header", "description": "", "example": "{{authorization}}", "schema": { "type": "string", "default": "{{authorization}}" } }, { "name": "tenant-id", "in": "header", "description": "", "example": "{{tenant-id}}", "schema": { "type": "string", "default": "{{tenant-id}}" } } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "integer", "title": "integer", "description": "主键" }, "status": { "type": "integer", "title": "string", "description": "0 启用 1禁用" } }, "required": [ "id", "status" ] }, "examples": {} } } }, "responses": { "200": { "description": "", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "integer" }, "data": { "type": "boolean" }, "msg": { "type": "string" } }, "required": [ "code", "msg" ] } } }, "headers": {} } }, "security": [] } }, "/admin-api/business/meter-model/delete-list": { "delete": { "summary": "批量删除水表型号", "deprecated": false, "description": "", "tags": [], "parameters": [ { "name": "ids", "in": "query", "description": "integer，主键", "required": false, "example": [ "1", "2", "3" ], "schema": { "type": "array", "items": { "type": "string" } } }, { "name": "tag", "in": "header", "description": "默认全局带上tag参数，优先访问本地启动的服务", "example": "{{tag}}", "schema": { "type": "string", "default": "{{tag}}" } }, { "name": "Authorization", "in": "header", "description": "", "example": "{{authorization}}", "schema": { "type": "string", "default": "{{authorization}}" } }, { "name": "tenant-id", "in": "header", "description": "", "example": "{{tenant-id}}", "schema": { "type": "string", "default": "{{tenant-id}}" } } ], "responses": { "200": { "description": "", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "integer" }, "data": { "type": "boolean" }, "msg": { "type": "string" } }, "required": [ "code", "msg", "data" ] } } }, "headers": {} } }, "security": [] } }, "/admin-api/business/meter-caliber/page": { "get": { "summary": "获取水表分页口径", "deprecated": false, "description": "", "operationId": "getMeterMakerList", "tags": [ "MeterManagement" ], "parameters": [ { "name": "pageNo", "in": "query", "description": "页码，从1开始", "required": true, "schema": { "type": "integer", "minimum": 1, "default": 1, "example": 1 } }, { "name": "pageSize", "in": "query", "description": "每页数量", "required": true, "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 20, "example": 20 } }, { "name": "name", "in": "query", "description": "口径名称", "required": false, "schema": { "type": "string" } }, { "name": "value", "in": "query", "description": "口径值（单位：毫米）", "required": false, "schema": { "type": "number" } }, { "name": "highCoefficient", "in": "query", "description": "量高系数，抄表量高提醒系数", "required": false, "schema": { "type": "number" } }, { "name": "lowCoefficient", "in": "query", "description": "量低系数，抄表量低提醒系数", "required": false, "schema": { "type": "number" } }, { "name": "replacePeriod", "in": "query", "description": "定换周期 / 使用年限", "required": false, "schema": { "type": "integer" } }, { "name": "tag", "in": "header", "description": "默认全局带上tag参数，优先访问本地启动的服务", "example": "{{tag}}", "schema": { "type": "string", "default": "{{tag}}" } }, { "name": "Authorization", "in": "header", "description": "", "example": "{{authorization}}", "schema": { "type": "string", "default": "{{authorization}}" } }, { "name": "tenant-id", "in": "header", "description": "", "example": "{{tenant-id}}", "schema": { "type": "string", "default": "{{tenant-id}}" } } ], "responses": { "200": { "description": "水表厂家列表", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "data", "msg" ], "properties": { "code": { "type": "integer", "example": 0 }, "data": { "type": "object", "required": [ "list", "total" ], "properties": { "list": { "type": "array", "items": { "type": "object", "required": [ "id", "name", "value", "highCoefficient", "lowCoefficient" ], "properties": { "id": { "type": "integer", "format": "int64", "description": "主键", "example": 3001 }, "name": { "type": "string", "description": "口径名称", "maxLength": 100, "example": "DN15" }, "value": { "type": "number", "format": "decimal", "description": "口径值（单位：毫米）", "minimum": 0, "example": 15 }, "checkPeriod": { "type": "integer", "description": "强检周期（单位：年）", "nullable": true, "example": 6 }, "replacePeriod": { "type": "integer", "description": "定换周期（单位：年）", "nullable": true, "example": 8 }, "highCoefficient": { "type": "number", "format": "decimal", "description": "量高系数", "minimum": 0, "example": 1.2 }, "lowCoefficient": { "type": "number", "format": "decimal", "description": "量低系数", "minimum": 0, "example": 0.8 }, "remark": { "type": "string", "description": "备注", "maxLength": 500, "nullable": true }, "status": { "type": "integer", "description": "状态(0-否, 1-是)", "enum": [ 0, 1 ], "example": 1 }, "createTime": { "type": "string", "format": "date-time", "description": "创建时间", "readOnly": true, "example": "2023-12-01T10:30:00Z" }, "updateTime": { "type": "string", "format": "date-time", "description": "更新时间", "readOnly": true, "example": "2023-12-01T10:30:00Z" }, "creator": { "type": "string", "description": "创建人id", "readOnly": true, "maxLength": 100 }, "updater": { "type": "string", "description": "更新人id", "readOnly": true, "maxLength": 100 }, "deleted": { "type": "integer", "description": "是否删除" }, "tenantId": { "type": "integer", "format": "int64", "description": "租户id", "readOnly": true, "example": 0 } } } }, "total": { "type": "integer", "example": 12 } } }, "msg": { "type": "string", "example": "" } } }, "example": { "code": 0, "data": { "list": [ { "id": 3001, "name": "DN15", "value": 15, "checkPeriod": 6, "replacePeriod": 8, "highCoefficient": 1.2, "lowCoefficient": 0.8, "remark": "string", "status": 0, "createTime": "2023-12-01T10:30:00Z", "updateTime": "2023-12-01T10:30:00Z", "creator": "string", "updater": "string", "deleted": false, "tenantId": 0 } ], "total": 12 }, "msg": "" } } }, "headers": {} } }, "security": [] } }, "/admin-api/business/meter-caliber/get": { "get": { "summary": "获取水表口径详情", "deprecated": false, "description": "获取所有水表厂家的分页列表，支持搜索和过滤", "operationId": "getMeterMakerList", "tags": [ "MeterManagement" ], "parameters": [ { "name": "id", "in": "query", "description": "主键", "required": false, "schema": { "type": "string", "example": "ACTIVE" } }, { "name": "tag", "in": "header", "description": "默认全局带上tag参数，优先访问本地启动的服务", "example": "{{tag}}", "schema": { "type": "string", "default": "{{tag}}" } }, { "name": "Authorization", "in": "header", "description": "", "example": "{{authorization}}", "schema": { "type": "string", "default": "{{authorization}}" } }, { "name": "tenant-id", "in": "header", "description": "", "example": "{{tenant-id}}", "schema": { "type": "string", "default": "{{tenant-id}}" } } ], "responses": { "200": { "description": "水表厂家列表", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg" ], "properties": { "code": { "type": "integer", "example": 0 }, "data": { "type": "object", "required": [ "id", "name", "value", "highCoefficient", "lowCoefficient" ], "properties": { "id": { "type": "integer", "format": "int64", "description": "主键", "example": 3001 }, "name": { "type": "string", "description": "口径名称", "maxLength": 100, "example": "DN15" }, "value": { "type": "number", "format": "decimal", "description": "口径值（单位：毫米）", "minimum": 0, "example": 15 }, "checkPeriod": { "type": "integer", "description": "强检周期（单位：年）", "nullable": true, "example": 6 }, "replacePeriod": { "type": "integer", "description": "定换周期（单位：年）", "nullable": true, "example": 8 }, "highCoefficient": { "type": "number", "format": "decimal", "description": "量高系数", "minimum": 0, "example": 1.2 }, "lowCoefficient": { "type": "number", "format": "decimal", "description": "量低系数", "minimum": 0, "example": 0.8 }, "remark": { "type": "string", "description": "备注", "maxLength": 500 }, "status": { "type": "integer", "description": "状态(0-否, 1-是)", "enum": [ 0, 1 ], "example": 1 }, "createTime": { "type": "string", "format": "date-time", "description": "创建时间", "readOnly": true, "example": "2023-12-01T10:30:00Z" }, "updateTime": { "type": "string", "format": "date-time", "description": "更新时间", "readOnly": true, "example": "2023-12-01T10:30:00Z" }, "creator": { "type": "string", "description": "创建人id", "readOnly": true, "maxLength": 100 }, "updater": { "type": "string", "description": "更新人id", "readOnly": true, "maxLength": 100 }, "deleted": { "type": "integer", "description": "是否删除" }, "tenantId": { "type": "integer", "format": "int64", "description": "租户id", "readOnly": true, "example": 0 } } }, "msg": { "type": "string", "example": "" } } }, "example": { "code": 0, "data": { "id": 3001, "name": "DN15", "value": 15, "checkPeriod": 6, "replacePeriod": 8, "highCoefficient": 1.2, "lowCoefficient": 0.8, "remark": "string", "status": 0, "createTime": "2023-12-01T10:30:00Z", "updateTime": "2023-12-01T10:30:00Z", "creator": "string", "updater": "string", "deleted": false, "tenantId": 0 }, "msg": "" } } }, "headers": {} } }, "security": [] } }, "/admin-api/business/meter-caliber/list-all-simple": { "get": { "summary": "获取水表口径下拉列表", "deprecated": false, "description": "获取所有水表厂家的分页列表，支持搜索和过滤", "operationId": "getMeterMakerList", "tags": [ "MeterManagement" ], "parameters": [ { "name": "tag", "in": "header", "description": "默认全局带上tag参数，优先访问本地启动的服务", "example": "{{tag}}", "schema": { "type": "string", "default": "{{tag}}" } }, { "name": "Authorization", "in": "header", "description": "", "example": "{{authorization}}", "schema": { "type": "string", "default": "{{authorization}}" } }, { "name": "tenant-id", "in": "header", "description": "", "example": "{{tenant-id}}", "schema": { "type": "string", "default": "{{tenant-id}}" } } ], "responses": { "200": { "description": "水表厂家列表", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "data", "msg" ], "properties": { "code": { "type": "integer", "example": 0 }, "data": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "integer", "title": "integer", "description": "主键" }, "name": { "type": "string" }, "value": { "type": "number" } }, "required": [ "id", "name", "value" ] } }, "msg": { "type": "string" } } }, "example": { "code": 0, "data": { "id": 1001, "name": "威星智能股份有限公司" }, "msg": "string" } } }, "headers": {} } }, "security": [] } }, "/admin-api/business/meter-caliber/create": { "post": { "summary": "创建水表口径", "deprecated": false, "description": "", "operationId": "createMeterMaker", "tags": [ "MeterManagement" ], "parameters": [ { "name": "tag", "in": "header", "description": "默认全局带上tag参数，优先访问本地启动的服务", "example": "{{tag}}", "schema": { "type": "string", "default": "{{tag}}" } }, { "name": "Authorization", "in": "header", "description": "", "example": "{{authorization}}", "schema": { "type": "string", "default": "{{authorization}}" } }, { "name": "tenant-id", "in": "header", "description": "", "example": "{{tenant-id}}", "schema": { "type": "string", "default": "{{tenant-id}}" } } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "name": { "type": "string" }, "value": { "type": "integer" }, "replacePeriod": { "type": "number" }, "highCoefficient": { "type": "number" }, "lowCoefficient": { "type": "number" }, "remark": { "type": "string" } }, "required": [ "name", "value", "highCoefficient", "replacePeriod", "lowCoefficient" ] }, "example": { "name": "DN15", "value": 15, "replacePeriod": 8, "highCoefficient": 1.2, "lowCoefficient": 0.8, "remark": "string" } } } }, "responses": { "200": { "description": "创建成功", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "integer" }, "data": { "type": "boolean" }, "msg": { "type": "string" } }, "required": [ "code", "data", "msg" ] } } }, "headers": {} } }, "security": [] } }, "/admin-api/business/meter-caliber/update": { "put": { "summary": "修改水表口径", "deprecated": false, "description": "", "operationId": "createMeterMaker", "tags": [ "MeterManagement" ], "parameters": [ { "name": "tag", "in": "header", "description": "默认全局带上tag参数，优先访问本地启动的服务", "example": "{{tag}}", "schema": { "type": "string", "default": "{{tag}}" } }, { "name": "Authorization", "in": "header", "description": "", "example": "{{authorization}}", "schema": { "type": "string", "default": "{{authorization}}" } }, { "name": "tenant-id", "in": "header", "description": "", "example": "{{tenant-id}}", "schema": { "type": "string", "default": "{{tenant-id}}" } } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "integer" }, "name": { "type": "string" }, "value": { "type": "integer" }, "checkPeriod": { "type": "integer" }, "replacePeriod": { "type": "integer" }, "highCoefficient": { "type": "number" }, "lowCoefficient": { "type": "number" }, "remark": { "type": "string" } }, "required": [ "id" ] }, "example": { "id": 3001, "name": "DN15", "value": 15, "checkPeriod": 6, "replacePeriod": 8, "highCoefficient": 1.2, "lowCoefficient": 0.8, "remark": "string" } } } }, "responses": { "200": { "description": "创建成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "data", "msg" ], "properties": { "code": { "type": "integer" }, "data": { "type": "boolean" }, "msg": { "type": "string" } } } } }, "headers": {} } }, "security": [] } }, "/admin-api/business/meter-caliber/delete": { "delete": { "summary": "删除水表口径", "deprecated": false, "description": "", "operationId": "createMeterMaker", "tags": [ "MeterManagement" ], "parameters": [ { "name": "id", "in": "query", "description": "integer，主键", "required": true, "example": "1", "schema": { "type": "string" } }, { "name": "tag", "in": "header", "description": "默认全局带上tag参数，优先访问本地启动的服务", "example": "{{tag}}", "schema": { "type": "string", "default": "{{tag}}" } }, { "name": "Authorization", "in": "header", "description": "", "example": "{{authorization}}", "schema": { "type": "string", "default": "{{authorization}}" } }, { "name": "tenant-id", "in": "header", "description": "", "example": "{{tenant-id}}", "schema": { "type": "string", "default": "{{tenant-id}}" } } ], "responses": { "200": { "description": "创建成功", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "integer" }, "data": { "type": "boolean" }, "msg": { "type": "string" } }, "required": [ "code", "data", "msg" ] } } }, "headers": {} } }, "security": [] } }, "/admin-api/business/meter-caliber/delete-list": { "delete": { "summary": "批量删除水表口径", "deprecated": false, "description": "", "tags": [], "parameters": [ { "name": "ids", "in": "query", "description": "integer，主键", "required": false, "example": [ "1", "2", "3" ], "schema": { "type": "array", "items": { "type": "string" } } }, { "name": "tag", "in": "header", "description": "默认全局带上tag参数，优先访问本地启动的服务", "example": "{{tag}}", "schema": { "type": "string", "default": "{{tag}}" } }, { "name": "Authorization", "in": "header", "description": "", "example": "{{authorization}}", "schema": { "type": "string", "default": "{{authorization}}" } }, { "name": "tenant-id", "in": "header", "description": "", "example": "{{tenant-id}}", "schema": { "type": "string", "default": "{{tenant-id}}" } } ], "responses": { "200": { "description": "", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "integer" }, "data": { "type": "boolean" }, "msg": { "type": "string" } }, "required": [ "code", "msg" ] } } }, "headers": {} } }, "security": [] } }, "/admin-api/business/meter-caliber/update-status": { "put": { "summary": "修改水表口径状态", "deprecated": false, "description": "", "tags": [], "parameters": [ { "name": "tag", "in": "header", "description": "默认全局带上tag参数，优先访问本地启动的服务", "example": "{{tag}}", "schema": { "type": "string", "default": "{{tag}}" } }, { "name": "Authorization", "in": "header", "description": "", "example": "{{authorization}}", "schema": { "type": "string", "default": "{{authorization}}" } }, { "name": "tenant-id", "in": "header", "description": "", "example": "{{tenant-id}}", "schema": { "type": "string", "default": "{{tenant-id}}" } } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "integer", "title": "integer", "description": "主键" }, "status": { "type": "integer", "title": "string", "description": "支持多个字段模糊搜索" } }, "required": [ "id", "status" ] }, "examples": {} } } }, "responses": { "200": { "description": "", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "integer" }, "data": { "type": "boolean" }, "msg": { "type": "string" } }, "required": [ "code", "msg" ] } } }, "headers": {} } }, "security": [] } }, "/admin-api/business/meter-range/page": { "get": { "summary": "获取水表分页量程", "deprecated": false, "description": "", "operationId": "getMeterMakerList", "tags": [ "MeterManagement" ], "parameters": [ { "name": "pageNo", "in": "query", "description": "页码，从1开始", "required": false, "example": 1, "schema": { "type": "integer", "minimum": 1, "default": 1, "example": 1 } }, { "name": "pageSize", "in": "query", "description": "每页数量", "required": false, "example": 5, "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 20, "example": 20 } }, { "name": "code", "in": "query", "description": "量程代码", "required": false, "schema": { "type": "string", "example": "name,-code" } }, { "name": "name", "in": "query", "description": "量程名称", "required": false, "schema": { "type": "string", "maxLength": 100, "example": "关键词" } }, { "name": "value", "in": "query", "description": "量程值（单位：立方米）", "required": false, "schema": { "type": "number" } }, { "name": "tag", "in": "header", "description": "默认全局带上tag参数，优先访问本地启动的服务", "example": "{{tag}}", "schema": { "type": "string", "default": "{{tag}}" } }, { "name": "Authorization", "in": "header", "description": "", "example": "{{authorization}}", "schema": { "type": "string", "default": "{{authorization}}" } }, { "name": "tenant-id", "in": "header", "description": "", "example": "{{tenant-id}}", "schema": { "type": "string", "default": "{{tenant-id}}" } } ], "responses": { "200": { "description": "水表厂家列表", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "data", "msg" ], "properties": { "code": { "type": "integer", "example": 0 }, "data": { "type": "object", "required": [ "list", "total" ], "properties": { "list": { "type": "array", "items": { "type": "object", "required": [ "id", "name", "code", "value", "status", "createTime" ], "properties": { "id": { "type": "integer", "format": "int64", "description": "主键", "example": 4001 }, "name": { "type": "string", "description": "量程名称", "maxLength": 100, "example": "常用量程" }, "code": { "type": "string", "description": "量程代码", "maxLength": 100, "example": "RANGE_NORMAL" }, "value": { "type": "number", "format": "decimal", "description": "量程值（单位：立方米）", "minimum": 0, "example": 100 }, "remark": { "type": "string", "description": "备注", "maxLength": 500 }, "status": { "type": "integer", "description": "状态(0-否, 1-是)", "enum": [ 0, 1 ], "example": 1 }, "createTime": { "type": "string", "format": "date-time", "description": "创建时间", "readOnly": true, "example": "2023-12-01T10:30:00Z" }, "updateTime": { "type": "string", "format": "date-time", "description": "更新时间", "readOnly": true, "example": "2023-12-01T10:30:00Z" }, "creator": { "type": "string", "description": "创建人id", "readOnly": true, "maxLength": 100 }, "updater": { "type": "string", "description": "更新人id", "readOnly": true, "maxLength": 100 }, "deleted": { "type": "integer", "description": "是否删除" }, "tenantId": { "type": "integer", "format": "int64", "description": "租户id", "readOnly": true, "example": 0 } } } }, "total": { "type": "integer", "example": 8 } } }, "msg": { "type": "string", "example": "" } } }, "example": { "code": 0, "data": { "list": [ { "id": 4001, "name": "常用量程", "code": "RANGE_NORMAL", "value": 100, "remark": "string", "status": 0, "createTime": "2023-12-01T10:30:00Z", "updateTime": "2023-12-01T10:30:00Z", "creator": "string", "updater": "string", "deleted": false, "tenantId": 0 } ], "total": 8 }, "msg": "" } } }, "headers": {} } }, "security": [] } }, "/admin-api/business/meter-range/get": { "get": { "summary": "获取水表量程详情", "deprecated": false, "description": "获取所有水表厂家的分页列表，支持搜索和过滤", "operationId": "getMeterMakerList", "tags": [ "MeterManagement" ], "parameters": [ { "name": "id", "in": "query", "description": "主键", "required": false, "schema": { "type": "string", "example": "ACTIVE" } }, { "name": "tag", "in": "header", "description": "默认全局带上tag参数，优先访问本地启动的服务", "example": "{{tag}}", "schema": { "type": "string", "default": "{{tag}}" } }, { "name": "Authorization", "in": "header", "description": "", "example": "{{authorization}}", "schema": { "type": "string", "default": "{{authorization}}" } }, { "name": "tenant-id", "in": "header", "description": "", "example": "{{tenant-id}}", "schema": { "type": "string", "default": "{{tenant-id}}" } } ], "responses": { "200": { "description": "水表厂家列表", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "data", "msg" ], "properties": { "code": { "type": "integer", "example": 0 }, "data": { "type": "object", "required": [ "id", "name", "code", "value", "status", "createTime" ], "properties": { "id": { "type": "integer", "format": "int64", "description": "主键", "example": 4001 }, "name": { "type": "string", "description": "量程名称", "maxLength": 100, "example": "常用量程" }, "code": { "type": "string", "description": "量程代码", "maxLength": 100, "example": "RANGE_NORMAL" }, "value": { "type": "number", "format": "decimal", "description": "量程值（单位：立方米）", "minimum": 0, "example": 100 }, "remark": { "type": "string", "description": "备注", "maxLength": 500 }, "status": { "type": "integer", "description": "状态(0-否, 1-是)", "enum": [ 0, 1 ], "example": 1 }, "createTime": { "type": "string", "format": "date-time", "description": "创建时间", "readOnly": true, "example": "2023-12-01T10:30:00Z" }, "updateTime": { "type": "string", "format": "date-time", "description": "更新时间", "readOnly": true, "example": "2023-12-01T10:30:00Z" }, "creator": { "type": "string", "description": "创建人id", "readOnly": true, "maxLength": 100 }, "updater": { "type": "string", "description": "更新人id", "readOnly": true, "maxLength": 100 }, "deleted": { "type": "boolean", "description": "是否删除", "readOnly": true, "example": false }, "tenantId": { "type": "integer", "format": "int64", "description": "租户id", "readOnly": true, "example": 0 } } }, "msg": { "type": "string", "example": "" } } }, "example": { "code": 0, "data": { "id": 4001, "name": "常用量程", "code": "RANGE_NORMAL", "value": 100, "remark": "string", "status": 0, "createTime": "2023-12-01T10:30:00Z", "updateTime": "2023-12-01T10:30:00Z", "creator": "string", "updater": "string", "deleted": false, "tenantId": 0 }, "msg": "" } } }, "headers": {} } }, "security": [] } }, "/admin-api/business/meter-range/list-all-simple": { "get": { "summary": "获取水表量程下拉列表", "deprecated": false, "description": "获取水表量程下拉列表", "operationId": "getMeterMakerList", "tags": [ "MeterManagement" ], "parameters": [ { "name": "tag", "in": "header", "description": "默认全局带上tag参数，优先访问本地启动的服务", "example": "{{tag}}", "schema": { "type": "string", "default": "{{tag}}" } }, { "name": "Authorization", "in": "header", "description": "", "example": "{{authorization}}", "schema": { "type": "string", "default": "{{authorization}}" } }, { "name": "tenant-id", "in": "header", "description": "", "example": "{{tenant-id}}", "schema": { "type": "string", "default": "{{tenant-id}}" } } ], "responses": { "200": { "description": "水表厂家列表", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "data", "msg" ], "properties": { "code": { "type": "integer", "example": 0 }, "data": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "integer", "title": "integer", "description": "主键" }, "name": { "type": "string", "description": "量程名称" }, "code": { "type": "string", "description": "量程代码" }, "value": { "type": "number", "description": "量程值" } }, "required": [ "id", "name", "code", "value" ] } }, "msg": { "type": "string" } } }, "example": { "code": 0, "data": [ { "id": 23, "name": "镇一诺", "code": "37", "value": 4 }, { "id": 26, "name": "素熙成", "code": "35", "value": 38 } ], "msg": "fugiat" } } }, "headers": {} } }, "security": [] } }, "/admin-api/business/meter-range/create": { "post": { "summary": "创建水表量程", "deprecated": false, "description": "", "operationId": "createMeterMaker", "tags": [ "MeterManagement" ], "parameters": [ { "name": "tag", "in": "header", "description": "默认全局带上tag参数，优先访问本地启动的服务", "example": "{{tag}}", "schema": { "type": "string", "default": "{{tag}}" } }, { "name": "Authorization", "in": "header", "description": "", "example": "{{authorization}}", "schema": { "type": "string", "default": "{{authorization}}" } }, { "name": "tenant-id", "in": "header", "description": "", "example": "{{tenant-id}}", "schema": { "type": "string", "default": "{{tenant-id}}" } } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "name": { "type": "string" }, "code": { "type": "string" }, "value": { "type": "integer" }, "remark": { "type": "string" } }, "required": [ "name", "code", "value" ] }, "example": { "name": "常用量程", "code": "RANGE_NORMAL", "value": 100, "remark": "string" } } } }, "responses": { "200": { "description": "创建成功", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "integer" }, "data": { "type": "boolean" }, "msg": { "type": "string" } }, "required": [ "code", "data", "msg" ] } } }, "headers": {} } }, "security": [] } }, "/admin-api/business/meter-range/update": { "put": { "summary": "修改水表量程", "deprecated": false, "description": "", "operationId": "createMeterMaker", "tags": [ "MeterManagement" ], "parameters": [ { "name": "tag", "in": "header", "description": "默认全局带上tag参数，优先访问本地启动的服务", "example": "{{tag}}", "schema": { "type": "string", "default": "{{tag}}" } }, { "name": "Authorization", "in": "header", "description": "", "example": "{{authorization}}", "schema": { "type": "string", "default": "{{authorization}}" } }, { "name": "tenant-id", "in": "header", "description": "", "example": "{{tenant-id}}", "schema": { "type": "string", "default": "{{tenant-id}}" } } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "integer", "title": "integer", "description": "主键" }, "name": { "type": "string", "description": "量程名称" }, "code": { "type": "string", "description": "量程代码" }, "value": { "type": "string", "description": "量程值（单位：立方米）" }, "remark": { "type": "string", "description": "备注" } }, "required": [ "id", "name", "code", "value" ] }, "example": { "id": 1, "name": "常用量程", "code": "RANGE_NORMAL", "value": 100, "remark": "string" } } } }, "responses": { "200": { "description": "创建成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "data", "msg" ], "properties": { "code": { "type": "integer", "example": 0 }, "data": { "type": "boolean" }, "msg": { "type": "string", "example": "创建成功" } } } } }, "headers": {} } }, "security": [] } }, "/admin-api/business/meter-range/delete": { "delete": { "summary": "删除水表量程", "deprecated": false, "description": "", "operationId": "createMeterMaker", "tags": [ "MeterManagement" ], "parameters": [ { "name": "id", "in": "query", "description": "integer，主键", "required": true, "example": "1", "schema": { "type": "string" } }, { "name": "tag", "in": "header", "description": "默认全局带上tag参数，优先访问本地启动的服务", "example": "{{tag}}", "schema": { "type": "string", "default": "{{tag}}" } }, { "name": "Authorization", "in": "header", "description": "", "example": "{{authorization}}", "schema": { "type": "string", "default": "{{authorization}}" } }, { "name": "tenant-id", "in": "header", "description": "", "example": "{{tenant-id}}", "schema": { "type": "string", "default": "{{tenant-id}}" } } ], "responses": { "200": { "description": "创建成功", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "integer" }, "data": { "type": "boolean" }, "msg": { "type": "string" } }, "required": [ "code", "data", "msg" ] } } }, "headers": {} } }, "security": [] } }, "/admin-api/business/meter-range/delete-list": { "delete": { "summary": "批量删除水表量程", "deprecated": false, "description": "", "tags": [], "parameters": [ { "name": "ids", "in": "query", "description": "", "required": false, "example": [ "1", "2", "3" ], "schema": { "type": "array", "items": { "type": "string" } } }, { "name": "tag", "in": "header", "description": "默认全局带上tag参数，优先访问本地启动的服务", "example": "{{tag}}", "schema": { "type": "string", "default": "{{tag}}" } }, { "name": "Authorization", "in": "header", "description": "", "example": "{{authorization}}", "schema": { "type": "string", "default": "{{authorization}}" } }, { "name": "tenant-id", "in": "header", "description": "", "example": "{{tenant-id}}", "schema": { "type": "string", "default": "{{tenant-id}}" } } ], "responses": { "200": { "description": "", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "integer" }, "data": { "type": "boolean" }, "msg": { "type": "string" } }, "required": [ "code", "msg" ] } } }, "headers": {} } }, "security": [] } }, "/admin-api/business/meter-range/update-status": { "put": { "summary": "修改水表量程状态", "deprecated": false, "description": "", "tags": [], "parameters": [ { "name": "tag", "in": "header", "description": "默认全局带上tag参数，优先访问本地启动的服务", "example": "{{tag}}", "schema": { "type": "string", "default": "{{tag}}" } }, { "name": "Authorization", "in": "header", "description": "", "example": "{{authorization}}", "schema": { "type": "string", "default": "{{authorization}}" } }, { "name": "tenant-id", "in": "header", "description": "", "example": "{{tenant-id}}", "schema": { "type": "string", "default": "{{tenant-id}}" } } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "integer", "title": "integer", "description": "主键" }, "status": { "type": "integer", "title": "string", "description": "0是1否" } }, "required": [ "id", "status" ] }, "examples": {} } } }, "responses": { "200": { "description": "", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "integer" }, "data": { "type": "boolean" }, "msg": { "type": "string" } }, "required": [ "code", "msg" ] } } }, "headers": {} } }, "security": [] } }, "/admin-api/system/dept/list": { "get": { "summary": "获取站点列表", "deprecated": false, "description": "根据编号获取部门详细信息", "operationId": "getDept", "tags": [ "部门管理" ], "parameters": [ { "name": "name", "in": "query", "description": "站点名称", "required": false, "example": "", "schema": { "type": "string" } }, { "name": "code", "in": "query", "description": "站点编码", "required": false, "example": "", "schema": { "type": "string" } }, { "name": "type", "in": "query", "description": "机构类型", "required": false, "example": "10", "schema": { "type": "string" } }, { "name": "tag", "in": "header", "description": "默认全局带上tag参数，优先访问本地启动的服务", "example": "{{tag}}", "schema": { "type": "string", "default": "{{tag}}" } }, { "name": "Authorization", "in": "header", "description": "", "example": "{{authorization}}", "schema": { "type": "string", "default": "{{authorization}}" } }, { "name": "tenant-id", "in": "header", "description": "", "example": "{{tenant-id}}", "schema": { "type": "string", "default": "{{tenant-id}}" } } ], "responses": { "200": { "description": "查询成功", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "integer" }, "data": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "integer" }, "name": { "type": "string" }, "parentId": { "type": "integer", "nullable": true }, "type": { "type": "string" }, "code": { "type": "string" }, "sort": { "type": "integer" }, "longitude": { "type": "string", "nullable": true }, "latitude": { "type": "string", "nullable": true }, "leaderUserId": { "type": "integer", "nullable": true }, "phone": { "type": "string", "nullable": true }, "email": { "type": "string", "nullable": true }, "status": { "type": "integer" }, "remark": { "type": "string", "nullable": true }, "createTime": { "type": "string" } }, "required": [ "id", "name", "status", "type", "code" ] } }, "msg": { "type": "string" } }, "required": [ "code", "msg" ] }, "example": { "code": 17, "data": [ { "id": 1024, "name": "芋道", "parentId": 1024, "sort": 1024, "leaderUserId": 2048, "phone": "15601691000", "email": "sw@iocoder.cn", "status": 1, "createTime": "2025-07-04T16:00:00" }, { "id": 1025, "name": "研发部", "parentId": 1024, "sort": 2048, "leaderUserId": 2049, "phone": "13800000000", "email": "dev@iocoder.cn", "status": 1, "createTime": "2025-07-04T16:05:00" } ], "msg": "nostrud sit tempor ut cillum" } } }, "headers": {} } }, "security": [] } }, "/admin-api/system/dept/get": { "get": { "summary": "获得部门信息详情", "deprecated": false, "description": "根据编号获取部门详细信息", "operationId": "getDept", "tags": [ "部门管理" ], "parameters": [ { "name": "id", "in": "query", "description": "部门编号", "required": true, "schema": { "type": "integer", "format": "int64", "example": 1024 } }, { "name": "tag", "in": "header", "description": "默认全局带上tag参数，优先访问本地启动的服务", "example": "{{tag}}", "schema": { "type": "string", "default": "{{tag}}" } }, { "name": "Authorization", "in": "header", "description": "", "example": "{{authorization}}", "schema": { "type": "string", "default": "{{authorization}}" } }, { "name": "tenant-id", "in": "header", "description": "", "example": "{{tenant-id}}", "schema": { "type": "string", "default": "{{tenant-id}}" } } ], "responses": { "200": { "description": "查询成功", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "integer" }, "data": { "type": "object", "properties": { "id": { "type": "integer", "example": 1024 }, "name": { "type": "string", "example": "芋道" }, "parentId": { "type": "integer", "example": 1024 }, "sort": { "type": "integer", "example": 1024 }, "leaderUserId": { "type": "integer", "example": 2048 }, "phone": { "type": "string", "example": "15601691000" }, "email": { "type": "string", "example": "sw@iocoder.cn" }, "status": { "type": "integer", "example": 1 }, "createTime": { "type": "string", "format": "date-time", "example": "2025-07-04T16:00:00" } }, "required": [ "id", "name", "parentId", "sort", "leaderUserId", "phone", "email", "status", "createTime" ] }, "msg": { "type": "string" } }, "required": [ "code", "data", "msg" ] }, "example": { "code": 17, "data": { "id": 1024, "name": "芋道", "parentId": 1024, "sort": 1024, "leaderUserId": 2048, "phone": "15601691000", "email": "sw@iocoder.cn", "status": 1, "createTime": "2025-07-04T16:00:00" }, "msg": "nostrud sit tempor ut cillum" } } }, "headers": {} } }, "security": [] } }, "/admin-api/system/dept/list-all-simple": { "get": { "summary": "获取部门下拉列表", "deprecated": false, "description": "根据条件查询部门列表", "operationId": "getDeptList", "tags": [ "部门管理" ], "parameters": [ { "name": "tag", "in": "header", "description": "默认全局带上tag参数，优先访问本地启动的服务", "example": "{{tag}}", "schema": { "type": "string", "default": "{{tag}}" } }, { "name": "Authorization", "in": "header", "description": "", "example": "{{authorization}}", "schema": { "type": "string", "default": "{{authorization}}" } }, { "name": "tenant-id", "in": "header", "description": "", "example": "{{tenant-id}}", "schema": { "type": "string", "default": "{{tenant-id}}" } } ], "responses": { "200": { "description": "查询成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "data", "msg" ], "properties": { "code": { "type": "integer", "example": 0 }, "data": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "integer", "title": "站点编号" }, "name": { "type": "string", "title": "站点名称" }, "code": { "type": "string", "title": "站点代码" }, "parentId": { "type": "integer", "title": "父站点 ID" } }, "required": [ "id", "name", "code", "parentId" ] } }, "msg": { "type": "string" } } } } }, "headers": {} } }, "security": [] } }, "/admin-api/system/dept/create": { "post": { "summary": "创建部门", "deprecated": false, "description": "创建新的部门信息", "operationId": "createDept", "tags": [ "部门管理" ], "parameters": [ { "name": "tag", "in": "header", "description": "默认全局带上tag参数，优先访问本地启动的服务", "example": "{{tag}}", "schema": { "type": "string", "default": "{{tag}}" } }, { "name": "Authorization", "in": "header", "description": "", "example": "{{authorization}}", "schema": { "type": "string", "default": "{{authorization}}" } }, { "name": "tenant-id", "in": "header", "description": "", "example": "{{tenant-id}}", "schema": { "type": "string", "default": "{{tenant-id}}" } } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "name": { "type": "string" }, "parentId": { "type": "integer" }, "code": { "type": "string", "title": "站点代码" }, "type": { "type": "string", "title": "机构类型" }, "longitude": { "type": "number", "title": "经度" }, "latitude": { "type": "number", "title": "纬度" }, "leaderUserId": { "type": "integer", "title": "负责人的用户编号" }, "phone": { "type": "string" }, "email": { "type": "string" }, "status": { "type": "integer" }, "remark": { "type": "string", "title": "备注" }, "sort": { "type": "integer", "title": "显示顺序" } }, "required": [ "name", "parentId", "leaderUserId", "code", "longitude", "latitude", "sort" ] }, "example": { "name": "矫依诺", "parentId": 27, "code": "37", "type": "deserunt aliquip amet ut dolore", "longitude": 4, "latitude": 6, "leaderUserId": 60, "phone": "084 5434 3838", "email": "o97scp_gc158@yeah.net", "status": 83, "remark": "cillum ut" } } } }, "responses": { "200": { "description": "创建成功", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "integer" }, "data": { "type": "integer", "title": "id" }, "msg": { "type": "string" } }, "required": [ "code", "data", "msg" ] } } }, "headers": {} } }, "security": [] } }, "/admin-api/system/dept/update": { "put": { "summary": "更新部门", "deprecated": false, "description": "更新部门信息", "operationId": "updateDept", "tags": [ "部门管理" ], "parameters": [ { "name": "tag", "in": "header", "description": "默认全局带上tag参数，优先访问本地启动的服务", "example": "{{tag}}", "schema": { "type": "string", "default": "{{tag}}" } }, { "name": "Authorization", "in": "header", "description": "", "example": "{{authorization}}", "schema": { "type": "string", "default": "{{authorization}}" } }, { "name": "tenant-id", "in": "header", "description": "", "example": "{{tenant-id}}", "schema": { "type": "string", "default": "{{tenant-id}}" } } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "integer" }, "name": { "type": "string" }, "parentId": { "type": "integer" }, "code": { "type": "string" }, "type": { "type": "string" }, "longitude": { "type": "number", "title": "经度" }, "latitude": { "type": "number", "title": "纬度" }, "sort": { "type": "integer" }, "leaderUserId": { "type": "integer" }, "phone": { "type": "string" }, "email": { "type": "string" }, "status": { "type": "integer" }, "remark": { "type": "string" } }, "required": [ "id", "longitude", "latitude" ] }, "example": { "id": "1", "name": "芋道", "parentId": 1024, "sort": 1, "leaderUserId": 2048, "phone": "15601691000", "email": "sw@iocoder.cn", "type": "0", "code": "a001", "status": 1 } } } }, "responses": { "200": { "description": "更新成功", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "integer" }, "data": { "type": "boolean" }, "msg": { "type": "string" } }, "required": [ "code", "data", "msg" ] } } }, "headers": {} } }, "security": [] } }, "/admin-api/system/dept/delete": { "delete": { "summary": "删除部门", "deprecated": false, "description": "删除指定的部门", "operationId": "deleteDept", "tags": [ "部门管理" ], "parameters": [ { "name": "id", "in": "query", "description": "部门编号（分公司或站点id）", "required": true, "schema": { "type": "integer", "format": "int64", "example": 1024 } }, { "name": "tag", "in": "header", "description": "默认全局带上tag参数，优先访问本地启动的服务", "example": "{{tag}}", "schema": { "type": "string", "default": "{{tag}}" } }, { "name": "Authorization", "in": "header", "description": "", "example": "{{authorization}}", "schema": { "type": "string", "default": "{{authorization}}" } }, { "name": "tenant-id", "in": "header", "description": "", "example": "{{tenant-id}}", "schema": { "type": "string", "default": "{{tenant-id}}" } } ], "responses": { "200": { "description": "删除成功", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "integer" }, "data": { "type": "boolean" }, "msg": { "type": "string" } }, "required": [ "code", "data", "msg" ] } } }, "headers": {} } }, "security": [] } }, "/admin-api/business/company-account/page": { "get": { "summary": "获取水司账户分页列表", "deprecated": false, "description": "获取所有水司账户的分页列表，支持搜索和过滤", "operationId": "getCompanyAccountList", "tags": [ "AddressManagement" ], "parameters": [ { "name": "pageNo", "in": "query", "description": "页码，从1开始", "required": false, "schema": { "type": "integer", "minimum": 1, "default": 1, "example": 1 } }, { "name": "pageSize", "in": "query", "description": "每页数量", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 20, "example": 20 } }, { "name": "sort", "in": "query", "description": "排序字段，加-为降序，多个逗号分割", "required": false, "schema": { "type": "string", "example": "name,-code" } }, { "name": "search", "in": "query", "description": "支持多个字段模糊搜索", "required": false, "schema": { "type": "string", "maxLength": 100, "example": "关键词" } }, { "name": "status", "in": "query", "description": "状态过滤", "required": false, "schema": { "type": "string", "example": "ACTIVE" } }, { "name": "tag", "in": "header", "description": "默认全局带上tag参数，优先访问本地启动的服务", "example": "{{tag}}", "schema": { "type": "string", "default": "{{tag}}" } }, { "name": "Authorization", "in": "header", "description": "", "example": "{{authorization}}", "schema": { "type": "string", "default": "{{authorization}}" } }, { "name": "tenant-id", "in": "header", "description": "", "example": "{{tenant-id}}", "schema": { "type": "string", "default": "{{tenant-id}}" } } ], "responses": { "200": { "description": "水司账户列表", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "data", "msg" ], "properties": { "code": { "type": "integer", "example": 0 }, "data": { "type": "object", "required": [ "list", "total" ], "properties": { "list": { "type": "array", "items": { "type": "object", "required": [ "id", "accountName", "bankName", "bankCode", "bankAccount", "status", "createTime" ], "properties": { "id": { "type": "integer", "format": "int64", "description": "主键", "example": 5001 }, "accountName": { "type": "string", "description": "账户名称", "maxLength": 200, "example": "长沙市水务集团有限公司" }, "accountAddress": { "type": "string", "description": "账户地址", "maxLength": 500, "example": "湖南省长沙市芙蓉区五一大道123号" }, "bankName": { "type": "string", "description": "开户行名称", "maxLength": 200, "example": "中国工商银行长沙市分行营业部" }, "bankCode": { "type": "string", "description": "开户行代码", "maxLength": 100, "example": "102501000018" }, "bankAccount": { "type": "string", "description": "开户行账户", "maxLength": 100, "example": "1901021329000123456" }, "remark": { "type": "string", "description": "备注", "maxLength": 500 }, "status": { "type": "integer", "description": "状态(0-否, 1-是)", "enum": [ 0, 1 ], "example": 1 }, "createTime": { "type": "string", "format": "date-time", "description": "创建时间", "readOnly": true, "example": "2023-12-01T10:30:00Z" }, "updateTime": { "type": "string", "format": "date-time", "description": "更新时间", "readOnly": true, "example": "2023-12-01T10:30:00Z" }, "creator": { "type": "string", "description": "创建人id", "readOnly": true, "maxLength": 100 }, "updater": { "type": "string", "description": "更新人id", "readOnly": true, "maxLength": 100 }, "deleted": { "type": "integer", "description": "是否删除" }, "tenantId": { "type": "integer", "format": "int64", "description": "租户id", "readOnly": true, "example": 0 } } } }, "total": { "type": "integer", "example": 15 } } }, "msg": { "type": "string", "example": "" } } }, "example": { "code": 0, "data": { "list": [ { "id": 4001, "name": "长沙水业集团", "code": "CHANGSHA_WATER_GROUP", "accountName": "长沙水业集团收费专户", "accountAddress": "湖南省长沙市芙蓉区五一大道389号", "bankName": "中国建设银行长沙市分行营业部", "bankCode": "CCB_CHANGSHA_001", "bankAccount": "43001234567890123456", "status": 1, "remark": "主要收费账户，用于居民用水收费", "createTime": "2024-01-01T00:00:00" } ], "total": 15 }, "msg": "" } } }, "headers": {} } }, "security": [] } }, "/admin-api/business/company-account/get": { "get": { "summary": "获取水司账户详情", "deprecated": false, "description": "根据账户ID获取水司账户详细信息", "operationId": "getCompanyAccountById", "tags": [ "AddressManagement" ], "parameters": [ { "name": "id", "in": "query", "description": "水司账户ID", "required": true, "schema": { "type": "integer", "format": "int64" } }, { "name": "tag", "in": "header", "description": "默认全局带上tag参数，优先访问本地启动的服务", "example": "{{tag}}", "schema": { "type": "string", "default": "{{tag}}" } }, { "name": "Authorization", "in": "header", "description": "", "example": "{{authorization}}", "schema": { "type": "string", "default": "{{authorization}}" } }, { "name": "tenant-id", "in": "header", "description": "", "example": "{{tenant-id}}", "schema": { "type": "string", "default": "{{tenant-id}}" } } ], "responses": { "200": { "description": "水司账户列表", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "integer" }, "data": { "type": "object", "properties": { "id": { "type": "integer" }, "accountName": { "type": "string" }, "accountAddress": { "type": "string" }, "bankName": { "type": "string" }, "bankCode": { "type": "string" }, "bankAccount": { "type": "string" }, "remark": { "type": "string" }, "status": { "type": "integer" }, "createTime": { "type": "string" }, "updateTime": { "type": "string" }, "creator": { "type": "string" }, "updater": { "type": "string" }, "deleted": { "type": "integer" }, "tenantId": { "type": "integer" } }, "required": [ "id", "accountName", "accountAddress", "bankName", "bankCode", "bankAccount", "status", "remark", "createTime" ] }, "msg": { "type": "string" } }, "required": [ "code", "data", "msg" ] }, "example": { "code": 0, "data": { "id": 4001, "name": "长沙水业集团", "code": "CHANGSHA_WATER_GROUP", "accountName": "长沙水业集团收费专户", "accountAddress": "湖南省长沙市芙蓉区五一大道389号", "bankName": "中国建设银行长沙市分行营业部", "bankCode": "CCB_CHANGSHA_001", "bankAccount": "43001234567890123456", "status": 1, "remark": "主要收费账户，用于居民用水收费", "createTime": "2024-01-01T00:00:00" }, "msg": "" } } }, "headers": {} } }, "security": [] } }, "/admin-api/business/company-account/list-all-simple": { "get": { "summary": "获取水司账户下拉列表", "deprecated": false, "description": "根据条件查询部门列表", "operationId": "getDeptList", "tags": [ "部门管理" ], "parameters": [ { "name": "tag", "in": "header", "description": "默认全局带上tag参数，优先访问本地启动的服务", "example": "{{tag}}", "schema": { "type": "string", "default": "{{tag}}" } }, { "name": "Authorization", "in": "header", "description": "", "example": "{{authorization}}", "schema": { "type": "string", "default": "{{authorization}}" } }, { "name": "tenant-id", "in": "header", "description": "", "example": "{{tenant-id}}", "schema": { "type": "string", "default": "{{tenant-id}}" } } ], "responses": { "200": { "description": "查询成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "data", "msg" ], "properties": { "code": { "type": "integer", "example": 0 }, "data": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "integer", "title": "主键" }, "accountName": { "type": "string", "title": "账户名称" }, "accountAddress": { "type": "string", "title": "账户地址" }, "bankName": { "type": "string", "title": "开户行名称" } }, "required": [ "id", "accountName", "accountAddress", "bankName" ] } }, "msg": { "type": "string" } } } } }, "headers": {} } }, "security": [] } }, "/admin-api/business/company-account/create": { "post": { "summary": "创建水司账户", "deprecated": false, "description": "创建新的水司账户信息", "operationId": "createCompanyAccount", "tags": [ "AddressManagement" ], "parameters": [ { "name": "tag", "in": "header", "description": "默认全局带上tag参数，优先访问本地启动的服务", "example": "{{tag}}", "schema": { "type": "string", "default": "{{tag}}" } }, { "name": "Authorization", "in": "header", "description": "", "example": "{{authorization}}", "schema": { "type": "string", "default": "{{authorization}}" } }, { "name": "tenant-id", "in": "header", "description": "", "example": "{{tenant-id}}", "schema": { "type": "string", "default": "{{tenant-id}}" } } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "accountName": { "type": "string", "title": "账户名称" }, "accountAddress": { "type": "string", "title": "账户地址" }, "bankName": { "type": "string", "title": "开户行名称" }, "bankCode": { "type": "string", "title": "开户行代码" }, "bankAccount": { "type": "string", "title": "开户行账户" }, "remark": { "type": "string", "title": "备注" } }, "required": [ "accountName", "accountAddress", "bankName", "bankCode", "bankAccount", "remark" ] }, "example": { "accountName": "长沙水业集团收费专户", "accountAddress": "湖南省长沙市芙蓉区五一大道389号", "bankName": "中国建设银行长沙市分行营业部", "bankCode": "CCB_CHANGSHA_001", "bankAccount": "43001234567890123456", "remark": "主要收费账户，用于居民用水收费" } } } }, "responses": { "200": { "description": "创建成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "data", "msg" ], "properties": { "code": { "type": "integer", "example": 0 }, "data": { "nullable": true, "oneOf": [ { "type": "string" }, { "type": "integer" }, { "type": "boolean" }, { "type": "array" }, { "type": "object" }, { "type": "number" } ] }, "msg": { "type": "string", "example": "创建成功" } } }, "example": { "code": 0, "data": { "list": [ { "id": 1001 } ], "total": 1 }, "msg": "创建成功" } } }, "headers": {} } }, "security": [] } }, "/admin-api/business/company-account": { "put": { "summary": "更新水司账户信息", "deprecated": false, "description": "更新指定水司账户的信息", "operationId": "updateCompanyAccount", "tags": [ "AddressManagement" ], "parameters": [ { "name": "accountId", "in": "query", "description": "水司账户ID", "required": true, "schema": { "type": "integer", "format": "int64" } }, { "name": "tag", "in": "header", "description": "默认全局带上tag参数，优先访问本地启动的服务", "example": "{{tag}}", "schema": { "type": "string", "default": "{{tag}}" } }, { "name": "Authorization", "in": "header", "description": "", "example": "{{authorization}}", "schema": { "type": "string", "default": "{{authorization}}" } }, { "name": "tenant-id", "in": "header", "description": "", "example": "{{tenant-id}}", "schema": { "type": "string", "default": "{{tenant-id}}" } } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "integer" }, "dept_code": { "type": "string" }, "accountName": { "type": "string" }, "accountAddress": { "type": "string" }, "bankName": { "type": "string" }, "bankCode": { "type": "string" }, "bankAccount": { "type": "string" }, "status": { "type": "integer" }, "remark": { "type": "string" } }, "required": [ "id" ] }, "example": { "id": 1, "dept_code": "a001", "accountName": "长沙水业集团收费专户", "accountAddress": "湖南省长沙市芙蓉区五一大道389号", "bankName": "中国建设银行长沙市分行营业部", "bankCode": "CCB_CHANGSHA_001", "bankAccount": "43001234567890123456", "status": 1, "remark": "主要收费账户，用于居民用水收费" } } } }, "responses": { "200": { "description": "更新成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "data", "msg" ], "properties": { "code": { "type": "integer", "example": 0 }, "data": { "type": "object", "required": [ "list", "total" ], "properties": { "list": { "type": "array", "items": {}, "maxItems": 0 }, "total": { "type": "integer", "example": 0 } } }, "msg": { "type": "string", "example": "更新成功" } } }, "example": { "code": 0, "data": { "list": [], "total": 0 }, "msg": "更新成功" } } }, "headers": {} } }, "security": [] } }, "/admin-api/business/company-account/delete": { "delete": { "summary": "删除水司账户", "deprecated": false, "description": "删除指定的水司账户", "operationId": "deleteCompanyAccount", "tags": [ "AddressManagement" ], "parameters": [ { "name": "accountId", "in": "query", "description": "水司账户ID", "required": true, "schema": { "type": "integer", "format": "int64" } }, { "name": "tag", "in": "header", "description": "默认全局带上tag参数，优先访问本地启动的服务", "example": "{{tag}}", "schema": { "type": "string", "default": "{{tag}}" } }, { "name": "Authorization", "in": "header", "description": "", "example": "{{authorization}}", "schema": { "type": "string", "default": "{{authorization}}" } }, { "name": "tenant-id", "in": "header", "description": "", "example": "{{tenant-id}}", "schema": { "type": "string", "default": "{{tenant-id}}" } } ], "responses": { "200": { "description": "删除成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "data", "msg" ], "properties": { "code": { "type": "integer", "example": 0 }, "data": { "type": "object", "required": [ "list", "total" ], "properties": { "list": { "type": "array", "items": { "type": "string" }, "maxItems": 0 }, "total": { "type": "integer", "example": 0 } } }, "msg": { "type": "string", "example": "删除成功" } } }, "example": { "code": 0, "data": { "list": [], "total": 0 }, "msg": "删除成功" } } }, "headers": {} } }, "security": [] } }, "/admin-api/business/community/page": { "get": { "summary": "获取小区分页列表", "deprecated": false, "description": "获取所有小区的分页列表，支持按部门过滤和层级查询", "operationId": "getCommunityList", "tags": [ "AddressManagement" ], "parameters": [ { "name": "pageNo", "in": "query", "description": "页码，从1开始", "required": false, "schema": { "type": "integer", "minimum": 1, "default": 1, "example": 1 } }, { "name": "pageSize", "in": "query", "description": "每页数量", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 20, "example": 20 } }, { "name": "name", "in": "query", "description": "小区名称", "required": false, "schema": { "type": "string" } }, { "name": "code", "in": "query", "description": "小区代码", "required": false, "schema": { "type": "string" } }, { "name": "tag", "in": "header", "description": "默认全局带上tag参数，优先访问本地启动的服务", "example": "{{tag}}", "schema": { "type": "string", "default": "{{tag}}" } }, { "name": "Authorization", "in": "header", "description": "", "example": "{{authorization}}", "schema": { "type": "string", "default": "{{authorization}}" } }, { "name": "tenant-id", "in": "header", "description": "", "example": "{{tenant-id}}", "schema": { "type": "string", "default": "{{tenant-id}}" } } ], "responses": { "200": { "description": "小区列表", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "data", "msg" ], "properties": { "code": { "type": "integer", "example": 0 }, "data": { "type": "object", "required": [ "list", "total" ], "properties": { "list": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "integer", "format": "int64" }, "name": { "type": "string" }, "code": { "type": "string" }, "address": { "type": "string" }, "contactNumber": { "type": "string" }, "deptCode": { "type": "string" }, "deptName": { "type": "string" }, "parentId": { "type": "integer", "format": "int64", "nullable": true }, "ancestorList": { "type": "string", "nullable": true }, "sort": { "type": "integer" }, "status": { "type": "integer" }, "remark": { "type": "string" }, "createTime": { "type": "string", "format": "date-time" } } } }, "total": { "type": "integer", "example": 80 } } }, "msg": { "type": "string", "example": "" } } }, "example": { "code": 0, "data": { "list": [ { "id": 16001, "name": "湘江世纪城", "code": "XIANGJIANG_COMMUNITY", "address": "岳麓区潇湘中路328号", "contactNumber": "0731-88888003", "deptCode": "YUELU_DEPT", "deptName": "岳麓区分公司", "parentId": 0, "ancestorList": "", "sort": 1, "status": 1, "remark": "高档住宅小区", "createTime": "2024-01-05T14:20:00" } ], "total": 80 }, "msg": "" } } }, "headers": {} } }, "security": [] } }, "/admin-api/business/community/get": { "get": { "summary": "获取小区详情", "deprecated": false, "description": "根据小区ID获取小区详细信息", "operationId": "getCommunityById", "tags": [ "AddressManagement" ], "parameters": [ { "name": "id", "in": "query", "description": "小区ID", "required": true, "schema": { "type": "integer", "format": "int64" } }, { "name": "tag", "in": "header", "description": "默认全局带上tag参数，优先访问本地启动的服务", "example": "{{tag}}", "schema": { "type": "string", "default": "{{tag}}" } }, { "name": "Authorization", "in": "header", "description": "", "example": "{{authorization}}", "schema": { "type": "string", "default": "{{authorization}}" } }, { "name": "tenant-id", "in": "header", "description": "", "example": "{{tenant-id}}", "schema": { "type": "string", "default": "{{tenant-id}}" } } ], "responses": { "200": { "description": "小区列表", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "data", "msg" ], "properties": { "code": { "type": "integer", "example": 0 }, "data": { "type": "object", "required": [ "id", "name", "code", "deptCode", "status" ], "properties": { "id": { "type": "integer", "example": 80 }, "name": { "type": "string" }, "code": { "type": "string" }, "address": { "type": "string" }, "contactNumber": { "type": "string" }, "deptCode": { "type": "string" }, "parentId": { "type": "integer", "nullable": true }, "ancestorList": { "type": "string", "nullable": true }, "sort": { "type": "integer" }, "remark": { "type": "string" }, "status": { "type": "integer" }, "createTime": { "type": "string" }, "updateTime": { "type": "string" }, "creator": { "type": "string" }, "updater": { "type": "string" }, "deleted": { "type": "integer" }, "tenantId": { "type": "integer" } } }, "msg": { "type": "string", "example": "" } } }, "example": { "code": 0, "data": { "list": [ { "id": 16001, "name": "湘江世纪城", "code": "XIANGJIANG_COMMUNITY", "address": "岳麓区潇湘中路328号", "contactNumber": "0731-88888003", "deptCode": "YUELU_DEPT", "deptName": "岳麓区分公司", "parentId": 0, "ancestorList": "", "sort": 1, "status": 1, "remark": "高档住宅小区", "createTime": "2024-01-05T14:20:00" } ], "total": 80 }, "msg": "" } } }, "headers": {} } }, "security": [] } }, "/admin-api/business/community/list-all-simple": { "get": { "summary": "获取小区下拉列表", "deprecated": false, "description": "", "operationId": "getDeptList", "tags": [ "部门管理" ], "parameters": [ { "name": "tag", "in": "header", "description": "默认全局带上tag参数，优先访问本地启动的服务", "example": "{{tag}}", "schema": { "type": "string", "default": "{{tag}}" } }, { "name": "Authorization", "in": "header", "description": "", "example": "{{authorization}}", "schema": { "type": "string", "default": "{{authorization}}" } }, { "name": "tenant-id", "in": "header", "description": "", "example": "{{tenant-id}}", "schema": { "type": "string", "default": "{{tenant-id}}" } } ], "responses": { "200": { "description": "查询成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "data", "msg" ], "properties": { "code": { "type": "integer", "example": 0 }, "data": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "integer", "title": "integer", "description": "主键" }, "name": { "type": "string" }, "code": { "type": "string" }, "parentId": { "type": "integer" } }, "required": [ "id", "name", "code" ] } }, "msg": { "type": "string" } } }, "example": { "code": 0, "data": { "id": 1001, "code": "string", "name": "威星智能股份有限公司" }, "msg": "string" } } }, "headers": {} } }, "security": [] } }, "/admin-api/business/community/create": { "post": { "summary": "创建小区", "deprecated": false, "description": "创建新的小区信息", "operationId": "createCommunity", "tags": [ "AddressManagement" ], "parameters": [ { "name": "tag", "in": "header", "description": "默认全局带上tag参数，优先访问本地启动的服务", "example": "{{tag}}", "schema": { "type": "string", "default": "{{tag}}" } }, { "name": "Authorization", "in": "header", "description": "", "example": "{{authorization}}", "schema": { "type": "string", "default": "{{authorization}}" } }, { "name": "tenant-id", "in": "header", "description": "", "example": "{{tenant-id}}", "schema": { "type": "string", "default": "{{tenant-id}}" } } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "name": { "type": "string" }, "code": { "type": "string" }, "address": { "type": "string", "nullable": true }, "contactNumber": { "type": "string", "nullable": true }, "deptCode": { "type": "string" }, "parentId": { "type": "integer", "nullable": true }, "remark": { "type": "string" } }, "required": [ "name", "code", "deptCode" ] }, "example": { "name": "用梓涵", "code": "64", "address": "西藏自治区 诸州市 河北区 亥栋835号 94单元", "contactNumber": "3", "deptCode": "26", "parentId": 6, "remark": "aliqua" } } } }, "responses": { "200": { "description": "创建成功", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "integer" }, "data": { "type": "integer", "title": "id" }, "msg": { "type": "string" } }, "required": [ "code", "data", "msg" ] }, "example": { "code": 0, "data": true, "msg": "string" } } }, "headers": {} } }, "security": [] } }, "/admin-api/business/community/update": { "put": { "summary": "更新小区信息", "deprecated": false, "description": "更新指定小区的信息", "operationId": "updateCommunity", "tags": [ "AddressManagement" ], "parameters": [ { "name": "communityId", "in": "query", "description": "小区ID", "required": true, "schema": { "type": "integer", "format": "int64" } }, { "name": "tag", "in": "header", "description": "默认全局带上tag参数，优先访问本地启动的服务", "example": "{{tag}}", "schema": { "type": "string", "default": "{{tag}}" } }, { "name": "Authorization", "in": "header", "description": "", "example": "{{authorization}}", "schema": { "type": "string", "default": "{{authorization}}" } }, { "name": "tenant-id", "in": "header", "description": "", "example": "{{tenant-id}}", "schema": { "type": "string", "default": "{{tenant-id}}" } } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "integer" }, "name": { "type": "string" }, "code": { "type": "string" }, "address": { "type": "string" }, "contactNumber": { "type": "string" }, "deptCode": { "type": "string" }, "parentId": { "type": "integer" }, "sort": { "type": "integer" }, "status": { "type": "integer" }, "remark": { "type": "string" } }, "required": [ "id" ] }, "example": { "id": 1, "name": "湘江世纪城", "code": "XIANGJIANG_COMMUNITY", "address": "岳麓区潇湘中路328号", "contactNumber": "0731-88888003", "deptCode": "YUELU_DEPT", "parentId": 0, "sort": 1, "status": 1, "remark": "高档住宅小区" } } } }, "responses": { "200": { "description": "更新成功", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "integer" }, "data": { "type": "boolean" }, "msg": { "type": "string" } }, "required": [ "code", "data", "msg" ] }, "example": { "code": 0, "data": true, "msg": "string" } } }, "headers": {} } }, "security": [] } }, "/admin-api/business/community/delete": { "delete": { "summary": "删除小区", "deprecated": false, "description": "删除指定的小区", "operationId": "deleteCommunity", "tags": [ "AddressManagement" ], "parameters": [ { "name": "id", "in": "query", "description": "小区ID", "required": true, "example": 1, "schema": { "type": "integer", "format": "int64" } }, { "name": "tag", "in": "header", "description": "默认全局带上tag参数，优先访问本地启动的服务", "example": "{{tag}}", "schema": { "type": "string", "default": "{{tag}}" } }, { "name": "Authorization", "in": "header", "description": "", "example": "{{authorization}}", "schema": { "type": "string", "default": "{{authorization}}" } }, { "name": "tenant-id", "in": "header", "description": "", "example": "{{tenant-id}}", "schema": { "type": "string", "default": "{{tenant-id}}" } } ], "responses": { "200": { "description": "删除成功", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "integer" }, "data": { "type": "boolean" }, "msg": { "type": "string" } }, "required": [ "code", "data", "msg" ] }, "example": { "code": 0, "data": true, "msg": "string" } } }, "headers": {} } }, "security": [] } }, "/admin-api/business/community/update-status": { "put": { "summary": "更新小区状态", "deprecated": false, "description": "", "tags": [], "parameters": [ { "name": "tag", "in": "header", "description": "默认全局带上tag参数，优先访问本地启动的服务", "example": "{{tag}}", "schema": { "type": "string", "default": "{{tag}}" } }, { "name": "Authorization", "in": "header", "description": "", "example": "{{authorization}}", "schema": { "type": "string", "default": "{{authorization}}" } }, { "name": "tenant-id", "in": "header", "description": "", "example": "{{tenant-id}}", "schema": { "type": "string", "default": "{{tenant-id}}" } } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "integer" }, "status": { "type": "integer" } }, "required": [ "id", "status" ] }, "examples": {} } } }, "responses": { "200": { "description": "", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "integer" }, "data": { "nullable": true, "oneOf": [ { "type": "string" }, { "type": "integer" }, { "type": "boolean" }, { "type": "array" }, { "type": "object" }, { "type": "number" } ] }, "msg": { "type": "string" } }, "required": [ "code", "msg" ] } } }, "headers": {} } }, "security": [] } }, "/admin-api/business/community/list-by-dept-code": { "get": { "summary": "获取某站点下的小区", "deprecated": false, "description": "", "tags": [], "parameters": [ { "name": "deptCode", "in": "query", "description": "", "required": false, "schema": { "type": "string" } }, { "name": "tag", "in": "header", "description": "默认全局带上tag参数，优先访问本地启动的服务", "example": "{{tag}}", "schema": { "type": "string", "default": "{{tag}}" } }, { "name": "Authorization", "in": "header", "description": "", "example": "{{authorization}}", "schema": { "type": "string", "default": "{{authorization}}" } }, { "name": "tenant-id", "in": "header", "description": "", "example": "{{tenant-id}}", "schema": { "type": "string", "default": "{{tenant-id}}" } } ], "responses": { "200": { "description": "", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "integer" }, "data": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "integer" }, "name": { "type": "string" }, "code": { "type": "string" }, "address": { "type": "string", "nullable": true }, "contactNumber": { "type": "string", "nullable": true }, "deptCode": { "type": "string" }, "parentId": { "type": "integer", "nullable": true }, "ancestorList": { "type": "string", "nullable": true }, "sort": { "type": "integer" }, "remark": { "type": "string", "nullable": true }, "status": { "type": "integer" }, "createTime": { "type": "string" }, "updateTime": { "type": "string" }, "creator": { "type": "string" }, "updater": { "type": "string" }, "deleted": { "type": "integer" }, "tenantId": { "type": "integer" } }, "required": [ "id", "name", "code", "deptCode", "sort", "status" ] } }, "msg": { "type": "string" } }, "required": [ "code" ] } } }, "headers": {} } }, "security": [] } }, "/admin-api/business/community/delete-list": { "delete": { "summary": "批量删除小区", "deprecated": false, "description": "", "tags": [], "parameters": [ { "name": "ids", "in": "query", "description": "", "required": false, "example": [ "1", "2" ], "schema": { "type": "array", "items": { "type": "string" } } }, { "name": "tag", "in": "header", "description": "默认全局带上tag参数，优先访问本地启动的服务", "example": "{{tag}}", "schema": { "type": "string", "default": "{{tag}}" } }, { "name": "Authorization", "in": "header", "description": "", "example": "{{authorization}}", "schema": { "type": "string", "default": "{{authorization}}" } }, { "name": "tenant-id", "in": "header", "description": "", "example": "{{tenant-id}}", "schema": { "type": "string", "default": "{{tenant-id}}" } } ], "responses": { "200": { "description": "", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "integer" }, "data": { "nullable": true, "oneOf": [ { "type": "string" }, { "type": "integer" }, { "type": "boolean" }, { "type": "array" }, { "type": "object" }, { "type": "number" } ] }, "msg": { "type": "string" } }, "required": [ "code", "msg" ] } } }, "headers": {} } }, "security": [] } }, "/admin-api/business/price-category/page": { "get": { "summary": "水价归属分页列表", "deprecated": false, "description": "获取所有小区的分页列表，支持按部门过滤和层级查询", "operationId": "getCommunityList", "tags": [ "AddressManagement" ], "parameters": [ { "name": "pageNo", "in": "query", "description": "页码，从1开始", "required": false, "schema": { "type": "integer", "minimum": 1, "default": 1, "example": 1 } }, { "name": "pageSize", "in": "query", "description": "每页数量", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 20, "example": 20 } }, { "name": "name", "in": "query", "description": "归属名称", "required": false, "schema": { "type": "string", "example": "ACTIVE" } }, { "name": "code", "in": "query", "description": "归属代码", "required": false, "schema": { "type": "string" } }, { "name": "tag", "in": "header", "description": "默认全局带上tag参数，优先访问本地启动的服务", "example": "{{tag}}", "schema": { "type": "string", "default": "{{tag}}" } }, { "name": "Authorization", "in": "header", "description": "", "example": "{{authorization}}", "schema": { "type": "string", "default": "{{authorization}}" } }, { "name": "tenant-id", "in": "header", "description": "", "example": "{{tenant-id}}", "schema": { "type": "string", "default": "{{tenant-id}}" } } ], "responses": { "200": { "description": "小区列表", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "data", "msg" ], "properties": { "code": { "type": "integer", "description": "状态码", "example": 0 }, "data": { "type": "object", "properties": { "list": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "integer" }, "name": { "type": "string" }, "code": { "type": "string" }, "parentId": { "type": "integer", "nullable": true }, "ancestorList": { "type": "string", "nullable": true }, "sort": { "type": "integer" }, "remark": { "type": "string" }, "status": { "type": "integer" }, "createTime": { "type": "string" }, "updateTime": { "type": "string" }, "creator": { "type": "string" }, "updater": { "type": "string" }, "deleted": { "type": "integer" }, "tenantId": { "type": "integer" } }, "required": [ "id", "name", "code", "remark", "status" ] } }, "total": { "type": "integer" } }, "required": [ "list", "total" ] }, "msg": { "type": "string", "description": "消息", "example": "" } } }, "example": { "code": 0, "data": { "list": [ { "id": 0, "name": "string", "code": "string", "parentId": 0, "ancestorList": "string", "sort": 0, "remark": "string", "status": 0, "createTime": "2019-08-24T14:15:22.123Z", "updateTime": "2019-08-24T14:15:22.123Z", "creator": "string", "updater": "string", "deleted": true, "tenant_id": 0 } ], "total": 12 }, "msg": "" } } }, "headers": {} } }, "security": [] } }, "/admin-api/business/price-category/get": { "get": { "summary": "水价归属详情", "deprecated": false, "description": "根据小区ID获取小区详细信息", "operationId": "getCommunityById", "tags": [ "AddressManagement" ], "parameters": [ { "name": "id", "in": "query", "description": "水价归属id", "required": true, "example": 0, "schema": { "type": "integer", "format": "int64" } }, { "name": "tag", "in": "header", "description": "默认全局带上tag参数，优先访问本地启动的服务", "example": "{{tag}}", "schema": { "type": "string", "default": "{{tag}}" } }, { "name": "Authorization", "in": "header", "description": "", "example": "{{authorization}}", "schema": { "type": "string", "default": "{{authorization}}" } }, { "name": "tenant-id", "in": "header", "description": "", "example": "{{tenant-id}}", "schema": { "type": "string", "default": "{{tenant-id}}" } } ], "responses": { "200": { "description": "小区列表", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "data", "msg" ], "properties": { "code": { "type": "integer", "description": "状态码", "example": 0 }, "data": { "type": "object", "properties": { "id": { "type": "integer", "format": "int64", "description": "主键" }, "name": { "type": "string", "description": "归属名称" }, "code": { "type": "string", "description": "归属代码" }, "parentId": { "type": "integer", "description": "父级归属id", "format": "int64", "nullable": true }, "ancestorList": { "type": "string", "description": "祖级列表", "nullable": true }, "sort": { "type": "integer", "description": "排序" }, "remark": { "type": "string", "description": "备注" }, "status": { "type": "integer", "description": "状态" }, "createTime": { "type": "string", "format": "date-time", "description": "创建时间" }, "updateTime": { "type": "string", "format": "date-time", "description": "更新时间" }, "creator": { "type": "string", "description": "创建人id" }, "updater": { "type": "string", "description": "更新人id" }, "deleted": { "type": "integer", "description": "是否删除" }, "tenantId": { "type": "integer", "description": "租户id" } }, "required": [ "tenantId", "name", "code", "id" ] }, "msg": { "type": "string", "description": "消息", "example": "" } } }, "example": { "code": 0, "data": { "id": 0, "name": "string", "code": "string", "parentId": 0, "ancestorList": "string", "sort": 0, "price_cost_adjustment_count": "string", "remark": "string", "status": 0, "createTime": "2019-08-24T14:15:22.123Z", "updateTime": "2019-08-24T14:15:22.123Z", "creator": "string", "updater": "string", "deleted": true, "tenant_id": 0 }, "msg": "" } } }, "headers": {} } }, "security": [] } }, "/admin-api/business/price-category/list-all-simple": { "get": { "summary": "获取水价归属精简列表", "deprecated": false, "description": "", "tags": [], "parameters": [ { "name": "tag", "in": "header", "description": "默认全局带上tag参数，优先访问本地启动的服务", "example": "{{tag}}", "schema": { "type": "string", "default": "{{tag}}" } }, { "name": "Authorization", "in": "header", "description": "", "example": "{{authorization}}", "schema": { "type": "string", "default": "{{authorization}}" } }, { "name": "tenant-id", "in": "header", "description": "", "example": "{{tenant-id}}", "schema": { "type": "string", "default": "{{tenant-id}}" } } ], "responses": { "200": { "description": "", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "integer" }, "data": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "integer" }, "name": { "type": "string" }, "code": { "type": "string" } }, "required": [ "id", "name", "code" ] } }, "msg": { "type": "string" } }, "required": [ "code", "msg" ] } } }, "headers": {} } }, "security": [] } }, "/admin-api/business/price-category/create": { "post": { "summary": "创建水价归属", "deprecated": false, "description": "创建新的小区信息", "operationId": "createCommunity", "tags": [ "AddressManagement" ], "parameters": [ { "name": "tag", "in": "header", "description": "默认全局带上tag参数，优先访问本地启动的服务", "example": "{{tag}}", "schema": { "type": "string", "default": "{{tag}}" } }, { "name": "Authorization", "in": "header", "description": "", "example": "{{authorization}}", "schema": { "type": "string", "default": "{{authorization}}" } }, { "name": "tenant-id", "in": "header", "description": "", "example": "{{tenant-id}}", "schema": { "type": "string", "default": "{{tenant-id}}" } } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "name": { "type": "string" }, "code": { "type": "string" }, "parentId": { "type": "integer" }, "remark": { "type": "string" } }, "required": [ "name", "code" ] }, "example": { "name": "居民用水", "code": "1", "remark": "quis sunt mollit incididunt consequat" } } } }, "responses": { "200": { "description": "创建成功", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "integer" }, "data": { "nullable": true, "oneOf": [ { "type": "string" }, { "type": "integer" }, { "type": "boolean" }, { "type": "array" }, { "type": "object" }, { "type": "number" } ] }, "msg": { "type": "string" } }, "required": [ "code", "data", "msg" ] }, "example": { "code": 0, "data": true, "msg": "string" } } }, "headers": {} } }, "security": [] } }, "/admin-api/business/price-category/update": { "put": { "summary": "更新水价归属信息", "deprecated": false, "description": "更新指定小区的信息", "operationId": "updateCommunity", "tags": [ "AddressManagement" ], "parameters": [ { "name": "tag", "in": "header", "description": "默认全局带上tag参数，优先访问本地启动的服务", "example": "{{tag}}", "schema": { "type": "string", "default": "{{tag}}" } }, { "name": "Authorization", "in": "header", "description": "", "example": "{{authorization}}", "schema": { "type": "string", "default": "{{authorization}}" } }, { "name": "tenant-id", "in": "header", "description": "", "example": "{{tenant-id}}", "schema": { "type": "string", "default": "{{tenant-id}}" } } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "integer" }, "name": { "type": "string" }, "code": { "type": "string" }, "parentId": { "type": "integer" }, "remark": { "type": "string" } }, "required": [ "id" ] }, "example": { "id": 4, "name": "test", "code": "1", "parentId": 0, "remark": "mollit laboris est" } } } }, "responses": { "200": { "description": "更新成功", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "integer" }, "data": { "type": "boolean" }, "msg": { "type": "string" } }, "required": [ "code", "data", "msg" ] }, "example": { "code": 0, "data": true, "msg": "string" } } }, "headers": {} } }, "security": [] } }, "/admin-api/business/price-category/delete": { "delete": { "summary": "删除水价归属", "deprecated": false, "description": "删除指定的小区", "operationId": "deleteCommunity", "tags": [ "AddressManagement" ], "parameters": [ { "name": "id", "in": "query", "description": "", "required": false, "schema": { "type": "integer" } }, { "name": "tag", "in": "header", "description": "默认全局带上tag参数，优先访问本地启动的服务", "example": "{{tag}}", "schema": { "type": "string", "default": "{{tag}}" } }, { "name": "Authorization", "in": "header", "description": "", "example": "{{authorization}}", "schema": { "type": "string", "default": "{{authorization}}" } }, { "name": "tenant-id", "in": "header", "description": "", "example": "{{tenant-id}}", "schema": { "type": "string", "default": "{{tenant-id}}" } } ], "responses": { "200": { "description": "删除成功", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "integer" }, "data": { "nullable": true, "oneOf": [ { "type": "string" }, { "type": "integer" }, { "type": "boolean" }, { "type": "array" }, { "type": "object" }, { "type": "number" } ] }, "msg": { "type": "string" } }, "required": [ "code", "data", "msg" ] }, "example": { "code": 0, "data": true, "msg": "string" } } }, "headers": {} } }, "security": [] } }, "/admin-api/business/price-category/delete-list": { "delete": { "summary": "批量删除水价归属", "deprecated": false, "description": "", "tags": [], "parameters": [ { "name": "ids", "in": "query", "description": "", "required": false, "example": [ "1", "2" ], "schema": { "type": "array", "items": { "type": "string" } } }, { "name": "tag", "in": "header", "description": "默认全局带上tag参数，优先访问本地启动的服务", "example": "{{tag}}", "schema": { "type": "string", "default": "{{tag}}" } }, { "name": "Authorization", "in": "header", "description": "", "example": "{{authorization}}", "schema": { "type": "string", "default": "{{authorization}}" } }, { "name": "tenant-id", "in": "header", "description": "", "example": "{{tenant-id}}", "schema": { "type": "string", "default": "{{tenant-id}}" } } ], "responses": { "200": { "description": "", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "integer" }, "data": { "nullable": true, "oneOf": [ { "type": "string" }, { "type": "integer" }, { "type": "boolean" }, { "type": "array" }, { "type": "object" }, { "type": "number" } ] }, "msg": { "type": "string" } }, "required": [ "code", "msg" ] } } }, "headers": {} } }, "security": [] } }, "/admin-api/business/cost-component/page": { "get": { "summary": "获取费用组成分页", "deprecated": false, "description": "", "operationId": "getMeterMakerList", "tags": [ "MeterManagement" ], "parameters": [ { "name": "pageNo", "in": "query", "description": "页码，从1开始", "required": false, "example": 1, "schema": { "type": "integer", "minimum": 1, "default": 1, "example": 1 } }, { "name": "pageSize", "in": "query", "description": "每页数量", "required": false, "example": 0, "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 20, "example": 20 } }, { "name": "name", "in": "query", "description": "费用名称", "required": false, "schema": { "type": "string" } }, { "name": "code", "in": "query", "description": "费用代码", "required": false, "schema": { "type": "string" } }, { "name": "tag", "in": "header", "description": "默认全局带上tag参数，优先访问本地启动的服务", "example": "{{tag}}", "schema": { "type": "string", "default": "{{tag}}" } }, { "name": "Authorization", "in": "header", "description": "", "example": "{{authorization}}", "schema": { "type": "string", "default": "{{authorization}}" } }, { "name": "tenant-id", "in": "header", "description": "", "example": "{{tenant-id}}", "schema": { "type": "string", "default": "{{tenant-id}}" } } ], "responses": { "200": { "description": "水表厂家列表", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "data", "msg" ], "properties": { "code": { "type": "integer", "example": 0 }, "data": { "type": "object", "required": [ "list", "total" ], "properties": { "list": { "type": "array", "items": { "type": "object", "required": [ "id", "code" ], "properties": { "id": { "type": "integer", "format": "int64", "description": "主键", "example": 1001 }, "name": { "type": "string", "description": "费用名称", "maxLength": 100, "example": "基本费用" }, "code": { "type": "string", "description": "费用代码", "maxLength": 100, "example": "BASIC_FEE" }, "penaltyCoefficient": { "type": "number", "format": "decimal", "description": "违约金系数", "example": 1.5 }, "zeroUsageCalculation": { "type": "integer", "description": "零用量是否计算" }, "sort": { "type": "integer", "description": "排序", "title": "string", "example": 0 }, "remark": { "type": "string", "description": "备注", "maxLength": 500 }, "status": { "type": "integer", "description": "状态", "example": 0 }, "createTime": { "type": "string", "format": "date-time", "description": "创建时间", "readOnly": true, "example": "2023-12-01T10:30:00Z" }, "updateTime": { "type": "string", "format": "date-time", "description": "更新时间", "readOnly": true, "example": "2023-12-01T10:30:00Z" }, "creator": { "type": "string", "description": "创建人id", "readOnly": true, "maxLength": 100 }, "updater": { "type": "string", "description": "更新人id", "readOnly": true, "maxLength": 100 }, "deleted": { "type": "integer", "description": "是否删除" }, "tenantId": { "type": "integer", "format": "int64", "description": "租户id", "readOnly": true, "example": 0 } } } }, "total": { "type": "integer", "example": 10 } } }, "msg": { "type": "string", "example": "" } } }, "example": { "code": 0, "data": { "list": [ { "id": 1001, "name": "基本费用", "code": "BASIC_FEE", "penaltyCoefficient": 1.5, "zeroUsageCalculation": 57, "sort": 0, "remark": "proident", "status": 0, "deleted": 94 }, { "id": 1001, "name": "基本费用", "code": "BASIC_FEE", "penaltyCoefficient": 1.5, "zeroUsageCalculation": 75, "sort": 0, "remark": "deserunt officia sed", "status": 0, "deleted": 47 }, { "id": 1001, "name": "基本费用", "code": "BASIC_FEE", "penaltyCoefficient": 1.5, "zeroUsageCalculation": 1, "sort": 0, "remark": "laboris ut enim", "status": 0, "deleted": 83 } ], "total": 10 }, "msg": "" } } }, "headers": {} } }, "security": [] } }, "/admin-api/business/cost-component/get": { "get": { "summary": "获取费用组成详情", "deprecated": false, "description": "获取所有水表厂家的分页列表，支持搜索和过滤", "operationId": "getMeterMakerList", "tags": [ "MeterManagement" ], "parameters": [ { "name": "id", "in": "query", "description": "主键", "required": false, "schema": { "type": "string", "example": "ACTIVE" } }, { "name": "tag", "in": "header", "description": "默认全局带上tag参数，优先访问本地启动的服务", "example": "{{tag}}", "schema": { "type": "string", "default": "{{tag}}" } }, { "name": "Authorization", "in": "header", "description": "", "example": "{{authorization}}", "schema": { "type": "string", "default": "{{authorization}}" } }, { "name": "tenant-id", "in": "header", "description": "", "example": "{{tenant-id}}", "schema": { "type": "string", "default": "{{tenant-id}}" } } ], "responses": { "200": { "description": "水表厂家列表", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "data", "msg" ], "properties": { "code": { "type": "integer", "example": 0 }, "data": { "type": "object", "required": [ "id", "code" ], "properties": { "id": { "type": "integer", "format": "int64", "description": "主键", "example": 1001 }, "name": { "type": "string", "description": "费用名称", "maxLength": 100, "example": "基本费用" }, "code": { "type": "string", "description": "费用代码", "maxLength": 100, "example": "BASIC_FEE" }, "penaltyCoefficient": { "type": "number", "format": "decimal", "description": "违约金系数", "example": 1.5 }, "zeroUsageCalculation": { "type": "integer", "description": "零用量是否计算" }, "sort": { "type": "integer", "description": "排序", "example": 0 }, "remark": { "type": "string", "description": "备注", "maxLength": 500 }, "status": { "type": "integer", "description": "状态", "example": 0 }, "createTime": { "type": "string", "format": "date-time", "description": "创建时间", "readOnly": true, "example": "2023-12-01T10:30:00Z" }, "updateTime": { "type": "string", "format": "date-time", "description": "更新时间", "readOnly": true, "example": "2023-12-01T10:30:00Z" }, "creator": { "type": "string", "description": "创建人id", "readOnly": true, "maxLength": 100 }, "updater": { "type": "string", "description": "更新人id", "readOnly": true, "maxLength": 100 }, "deleted": { "type": "integer", "description": "是否删除" }, "tenantId": { "type": "integer", "format": "int64", "description": "租户id", "readOnly": true, "example": 0 } } }, "msg": { "type": "string", "example": "" } } }, "example": { "code": 0, "data": { "id": 1001, "name": "基本费用", "code": "BASIC_FEE", "penaltyCoefficient": 1.5, "zeroUsageCalculation": false, "sort": 0, "remark": "string", "status": 0, "createTime": "2023-12-01T10:30:00Z", "updateTime": "2023-12-01T10:30:00Z", "creator": "string", "updater": "string", "deleted": false, "tenantId": 0 }, "msg": "" } } }, "headers": {} } }, "security": [] } }, "/admin-api/business/cost-component/list-all-simple": { "get": { "summary": "获取费用组成下拉列表", "deprecated": false, "description": "获取费用组成下拉列表", "operationId": "getMeterMakerList", "tags": [], "parameters": [ { "name": "tag", "in": "header", "description": "默认全局带上tag参数，优先访问本地启动的服务", "example": "{{tag}}", "schema": { "type": "string", "default": "{{tag}}" } }, { "name": "Authorization", "in": "header", "description": "", "example": "{{authorization}}", "schema": { "type": "string", "default": "{{authorization}}" } }, { "name": "tenant-id", "in": "header", "description": "", "example": "{{tenant-id}}", "schema": { "type": "string", "default": "{{tenant-id}}" } } ], "responses": { "200": { "description": "水表厂家列表", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "data", "msg" ], "properties": { "code": { "type": "integer", "example": 0 }, "data": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "integer" }, "name": { "type": "string" }, "code": { "type": "string" } }, "required": [ "id", "name", "code" ] } }, "msg": { "type": "string" } } }, "example": { "code": 0, "data": { "id": 1001, "code": "string", "name": "威星智能股份有限公司" }, "msg": "string" } } }, "headers": {} } }, "security": [] } }, "/admin-api/business/cost-component/create": { "post": { "summary": "创建费用组成", "deprecated": false, "description": "", "operationId": "createMeterMaker", "tags": [ "MeterManagement" ], "parameters": [ { "name": "tag", "in": "header", "description": "默认全局带上tag参数，优先访问本地启动的服务", "example": "{{tag}}", "schema": { "type": "string", "default": "{{tag}}" } }, { "name": "Authorization", "in": "header", "description": "", "example": "{{authorization}}", "schema": { "type": "string", "default": "{{authorization}}" } }, { "name": "tenant-id", "in": "header", "description": "", "example": "{{tenant-id}}", "schema": { "type": "string", "default": "{{tenant-id}}" } } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "name": { "type": "string" }, "code": { "type": "string" }, "penaltyCoefficient": { "type": "number" }, "remark": { "type": "string" } }, "required": [ "name", "code" ] }, "example": { "name": "基本费用", "code": 1, "penaltyCoefficient": 1, "remark": "基本费用" } } } }, "responses": { "200": { "description": "创建成功", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "integer" }, "data": { "type": "integer" }, "msg": { "type": "string" } }, "required": [ "code", "data", "msg" ] } } }, "headers": {} } }, "security": [] } }, "/admin-api/business/cost-component/update": { "put": { "summary": "修改费用组成", "deprecated": false, "description": "", "operationId": "createMeterMaker", "tags": [], "parameters": [ { "name": "tag", "in": "header", "description": "默认全局带上tag参数，优先访问本地启动的服务", "example": "{{tag}}", "schema": { "type": "string", "default": "{{tag}}" } }, { "name": "Authorization", "in": "header", "description": "", "example": "{{authorization}}", "schema": { "type": "string", "default": "{{authorization}}" } }, { "name": "tenant-id", "in": "header", "description": "", "example": "{{tenant-id}}", "schema": { "type": "string", "default": "{{tenant-id}}" } } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "integer" }, "name": { "type": "string" }, "code": { "type": "integer" }, "penaltyCoefficient": { "type": "number" }, "remark": { "type": "string" } }, "required": [ "id", "penaltyCoefficient", "remark" ] }, "example": { "id": 100, "name": "渠敏", "code": 49, "penaltyCoefficient": 87, "remark": "aute exercitation dolor nostrud" } } } }, "responses": { "200": { "description": "创建成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "data", "msg" ], "properties": { "code": { "type": "integer" }, "data": { "nullable": true, "oneOf": [ { "type": "string" }, { "type": "integer" }, { "type": "boolean" }, { "type": "array" }, { "type": "object" }, { "type": "number" } ] }, "msg": { "type": "string" } } } } }, "headers": {} } }, "security": [] } }, "/admin-api/business/cost-component/update-status": { "put": { "summary": "修改费用组成状态", "deprecated": false, "description": "", "tags": [], "parameters": [ { "name": "tag", "in": "header", "description": "默认全局带上tag参数，优先访问本地启动的服务", "example": "{{tag}}", "schema": { "type": "string", "default": "{{tag}}" } }, { "name": "Authorization", "in": "header", "description": "", "example": "{{authorization}}", "schema": { "type": "string", "default": "{{authorization}}" } }, { "name": "tenant-id", "in": "header", "description": "", "example": "{{tenant-id}}", "schema": { "type": "string", "default": "{{tenant-id}}" } } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "integer" }, "status": { "type": "integer" } }, "required": [ "id", "status" ] }, "examples": {} } } }, "responses": { "200": { "description": "", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "integer" }, "data": { "nullable": true, "oneOf": [ { "type": "string" }, { "type": "integer" }, { "type": "boolean" }, { "type": "array" }, { "type": "object" }, { "type": "number" } ] }, "msg": { "type": "string" } }, "required": [ "code", "msg" ] } } }, "headers": {} } }, "security": [] } }, "/admin-api/business/cost-component/update-zero-status": { "put": { "summary": "修改费用组成零用量计算状态", "deprecated": false, "description": "", "tags": [], "parameters": [ { "name": "tag", "in": "header", "description": "默认全局带上tag参数，优先访问本地启动的服务", "example": "{{tag}}", "schema": { "type": "string", "default": "{{tag}}" } }, { "name": "Authorization", "in": "header", "description": "", "example": "{{authorization}}", "schema": { "type": "string", "default": "{{authorization}}" } }, { "name": "tenant-id", "in": "header", "description": "", "example": "{{tenant-id}}", "schema": { "type": "string", "default": "{{tenant-id}}" } } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "integer", "title": "integer", "description": "主键" }, "status": { "type": "integer" } }, "required": [ "id", "status" ] }, "examples": {} } } }, "responses": { "200": { "description": "", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "integer" }, "data": { "nullable": true, "oneOf": [ { "type": "string" }, { "type": "integer" }, { "type": "boolean" }, { "type": "array" }, { "type": "object" }, { "type": "number" } ] }, "msg": { "type": "string" } }, "required": [ "code", "msg" ] } } }, "headers": {} } }, "security": [] } }, "/admin-api/business/cost-component/delete": { "delete": { "summary": "删除费用组成", "deprecated": false, "description": "", "operationId": "createMeterMaker", "tags": [ "MeterManagement" ], "parameters": [ { "name": "id", "in": "query", "description": "integer，主键", "required": true, "example": "1", "schema": { "type": "string" } }, { "name": "tag", "in": "header", "description": "默认全局带上tag参数，优先访问本地启动的服务", "example": "{{tag}}", "schema": { "type": "string", "default": "{{tag}}" } }, { "name": "Authorization", "in": "header", "description": "", "example": "{{authorization}}", "schema": { "type": "string", "default": "{{authorization}}" } }, { "name": "tenant-id", "in": "header", "description": "", "example": "{{tenant-id}}", "schema": { "type": "string", "default": "{{tenant-id}}" } } ], "responses": { "200": { "description": "创建成功", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "integer" }, "data": { "type": "boolean" }, "msg": { "type": "string" } }, "required": [ "code", "data", "msg" ] } } }, "headers": {} } }, "security": [] } }, "/admin-api/business/cost-component/delete-list": { "delete": { "summary": "批量删除费用组成", "deprecated": false, "description": "", "tags": [], "parameters": [ { "name": "ids", "in": "query", "description": "", "required": false, "example": [ "1", "2" ], "schema": { "type": "array", "items": { "type": "string" } } }, { "name": "tag", "in": "header", "description": "默认全局带上tag参数，优先访问本地启动的服务", "example": "{{tag}}", "schema": { "type": "string", "default": "{{tag}}" } }, { "name": "Authorization", "in": "header", "description": "", "example": "{{authorization}}", "schema": { "type": "string", "default": "{{authorization}}" } }, { "name": "tenant-id", "in": "header", "description": "", "example": "{{tenant-id}}", "schema": { "type": "string", "default": "{{tenant-id}}" } } ], "responses": { "200": { "description": "", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "integer" }, "data": { "nullable": true, "oneOf": [ { "type": "string" }, { "type": "integer" }, { "type": "boolean" }, { "type": "array" }, { "type": "object" }, { "type": "number" } ] }, "msg": { "type": "string" } }, "required": [ "code", "msg" ] } } }, "headers": {} } }, "security": [] } }, "/admin-api/business/price-cost-adjustment/get": { "get": { "summary": "水价归属下水价费用调整详情", "deprecated": false, "description": "", "operationId": "getMeterMakerList", "tags": [ "MeterManagement" ], "parameters": [ { "name": "price_category_code", "in": "query", "description": "水价归属代码", "required": false, "schema": { "type": "string", "example": "ACTIVE" } }, { "name": "tag", "in": "header", "description": "默认全局带上tag参数，优先访问本地启动的服务", "example": "{{tag}}", "schema": { "type": "string", "default": "{{tag}}" } }, { "name": "Authorization", "in": "header", "description": "", "example": "{{authorization}}", "schema": { "type": "string", "default": "{{authorization}}" } }, { "name": "tenant-id", "in": "header", "description": "", "example": "{{tenant-id}}", "schema": { "type": "string", "default": "{{tenant-id}}" } } ], "responses": { "200": { "description": "水表厂家列表", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "data", "msg" ], "properties": { "code": { "type": "integer", "example": 0 }, "data": { "type": "array", "items": { "type": "object", "required": [ "id", "priceCategoryCode", "costComponentCode" ], "properties": { "id": { "type": "integer", "format": "int64", "description": "主键", "example": 1001 }, "priceCategoryCode": { "type": "string", "description": "水价归属代码", "maxLength": 100, "example": "RESIDENTIAL" }, "costComponentCode": { "type": "string", "description": "费用组成代码", "maxLength": 100, "example": "BASIC_WATER_FEE" }, "calculationMode": { "type": "integer", "description": "计算类型", "example": 1 }, "isTiered": { "type": "boolean", "description": "是否阶梯(0-非阶梯，1-阶梯)", "example": false }, "tieredMode": { "type": "integer", "description": "阶梯类型", "example": 0 }, "tierLevel": { "type": "integer", "description": "阶梯级别(第几阶梯，如1、2、3等)", "example": 0 }, "volumeCoefficient": { "type": "number", "format": "decimal", "description": "水量系数(用于特殊计算场景)", "example": 1 }, "chargePenalty": { "type": "boolean", "description": "是否收取违约金(0-不收取，1-收取)", "example": true }, "sort": { "type": "integer", "description": "排序", "example": 0 }, "remark": { "type": "string", "description": "备注", "maxLength": 500 }, "status": { "type": "integer", "description": "状态", "example": 0 }, "createTime": { "type": "string", "format": "date-time", "description": "创建时间", "readOnly": true, "example": "2023-12-01T10:30:00Z" }, "updateTime": { "type": "string", "format": "date-time", "description": "更新时间", "readOnly": true, "example": "2023-12-01T10:30:00Z" }, "creator": { "type": "string", "description": "创建人id", "readOnly": true, "maxLength": 100 }, "updater": { "type": "string", "description": "更新人id", "readOnly": true, "maxLength": 100 }, "deleted": { "type": "boolean", "description": "是否删除", "readOnly": true, "example": false }, "tenantId": { "type": "integer", "format": "int64", "description": "租户id", "readOnly": true, "example": 0 }, "tierAdjustments": { "type": "array", "description": "阶梯调整列表", "items": { "type": "object", "required": [ "id", "costAdjustmentId", "costComponentCode", "price" ], "properties": { "id": { "type": "integer", "format": "int64", "description": "主键", "example": 2001 }, "costAdjustmentId": { "type": "integer", "format": "int64", "description": "水价费用调整id", "example": 1001 }, "costComponentCode": { "type": "string", "description": "费用组成代码", "maxLength": 100, "example": "BASIC_WATER_FEE" }, "tierLevel": { "type": "integer", "description": "阶梯级别(第几阶梯，如1、2、3等)", "example": 1 }, "startVolume": { "type": "number", "format": "decimal", "description": "开始水量(单位：立方米)", "example": 0 }, "endVolume": { "type": "number", "format": "decimal", "description": "结束水量(单位：立方米，为空表示无上限)", "example": 100 }, "price": { "type": "number", "format": "decimal", "description": "价格(单位：元/立方米或元（固定费用）)", "example": 2.5 }, "volumeCoefficient": { "type": "number", "format": "decimal", "description": "水量系数(用于特殊计算场景)", "example": 1 }, "sort": { "type": "integer", "description": "排序", "example": 0 }, "remark": { "type": "string", "description": "备注", "maxLength": 500 }, "status": { "type": "integer", "description": "状态", "example": 0 }, "createTime": { "type": "string", "format": "date-time", "description": "创建时间", "readOnly": true, "example": "2023-12-01T10:30:00Z" }, "updateTime": { "type": "string", "format": "date-time", "description": "更新时间", "readOnly": true, "example": "2023-12-01T10:30:00Z" }, "creator": { "type": "string", "description": "创建人id", "readOnly": true, "maxLength": 100 }, "updater": { "type": "string", "description": "更新人id", "readOnly": true, "maxLength": 100 }, "deleted": { "type": "boolean", "description": "是否删除", "readOnly": true, "example": false }, "tenantId": { "type": "integer", "format": "int64", "description": "租户id", "readOnly": true, "example": 0 } } } } } } }, "msg": { "type": "string", "example": "" } } }, "example": { "code": 0, "data": [ { "id": 1001, "priceCategoryCode": "RESIDENTIAL", "costComponentCode": "BASIC_WATER_FEE", "calculationMode": 1, "isTiered": false, "tieredMode": 0, "tierLevel": 0, "volumeCoefficient": 1, "chargePenalty": true, "sort": 0, "remark": "string", "status": 0, "createTime": "2023-12-01T10:30:00Z", "updateTime": "2023-12-01T10:30:00Z", "creator": "string", "updater": "string", "deleted": false, "tenantId": 0, "tierAdjustments": [ { "id": 2001, "costAdjustmentId": 1001, "costComponentCode": "BASIC_WATER_FEE", "tierLevel": 1, "startVolume": 0, "endVolume": 100, "price": 2.5, "volumeCoefficient": 1, "sort": 0, "remark": "string", "status": 0, "createTime": "2023-12-01T10:30:00Z", "updateTime": "2023-12-01T10:30:00Z", "creator": "string", "updater": "string", "deleted": false, "tenantId": 0 } ] } ], "msg": "" } } }, "headers": {} } }, "security": [] } }, "/admin-api/business/price-cost-adjustment/batch-create": { "post": { "summary": "批量创建水价费用调整", "deprecated": false, "description": "", "operationId": "getMeterMakerList", "tags": [ "MeterManagement" ], "parameters": [ { "name": "tag", "in": "header", "description": "默认全局带上tag参数，优先访问本地启动的服务", "example": "{{tag}}", "schema": { "type": "string", "default": "{{tag}}" } }, { "name": "Authorization", "in": "header", "description": "", "example": "{{authorization}}", "schema": { "type": "string", "default": "{{authorization}}" } }, { "name": "tenant-id", "in": "header", "description": "", "example": "{{tenant-id}}", "schema": { "type": "string", "default": "{{tenant-id}}" } } ], "requestBody": { "content": { "application/json": { "schema": { "type": "array", "items": { "type": "object", "properties": { "priceCategoryCode": { "type": "string" }, "costComponentCode": { "type": "string" }, "calculationMode": { "type": "integer" }, "isTiered": { "type": "boolean" }, "tieredMode": { "type": "integer" }, "tierLevel": { "type": "integer" }, "volumeCoefficient": { "type": "integer" }, "chargePenalty": { "type": "boolean" }, "sort": { "type": "integer" }, "remark": { "type": "string" }, "tierAdjustments": { "type": "array", "items": { "type": "object", "properties": { "costAdjustmentId": { "type": "integer" }, "costComponentCode": { "type": "string" }, "tierLevel": { "type": "integer" }, "startVolume": { "type": "integer" }, "endVolume": { "type": "integer" }, "price": { "type": "number" }, "volumeCoefficient": { "type": "integer" }, "sort": { "type": "integer" }, "remark": { "type": "string" } }, "required": [ "costAdjustmentId", "costComponentCode" ] } } }, "required": [ "costComponentCode", "priceCategoryCode" ] } }, "example": [ { "priceCategoryCode": "RESIDENTIAL", "costComponentCode": "BASIC_WATER_FEE", "calculationMode": 1, "isTiered": false, "tieredMode": 0, "tierLevel": 0, "volumeCoefficient": 1, "chargePenalty": true, "sort": 0, "remark": "string", "tierAdjustments": [ { "costAdjustmentId": 1001, "costComponentCode": "BASIC_WATER_FEE", "tierLevel": 1, "startVolume": 0, "endVolume": 100, "price": 2.5, "volumeCoefficient": 1, "sort": 0, "remark": "string" } ] } ] } } }, "responses": { "200": { "description": "水表厂家列表", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "data", "msg" ], "properties": { "code": { "type": "integer" }, "data": { "type": "boolean" }, "msg": { "type": "string" } } }, "example": { "code": 0, "data": true, "msg": "string" } } }, "headers": {} } }, "security": [] } }, "/admin-api/business/price-cost-adjustment/batch-update": { "put": { "summary": "批量修改水价费用调整", "deprecated": false, "description": "注意修改要添加修改历史biz_price_adjustment_history、biz_price_cost_adjustment_history、biz_price_tier_adjustment_history", "operationId": "getMeterMakerList", "tags": [ "MeterManagement" ], "parameters": [ { "name": "tag", "in": "header", "description": "默认全局带上tag参数，优先访问本地启动的服务", "example": "{{tag}}", "schema": { "type": "string", "default": "{{tag}}" } }, { "name": "Authorization", "in": "header", "description": "", "example": "{{authorization}}", "schema": { "type": "string", "default": "{{authorization}}" } }, { "name": "tenant-id", "in": "header", "description": "", "example": "{{tenant-id}}", "schema": { "type": "string", "default": "{{tenant-id}}" } } ], "requestBody": { "content": { "application/json": { "schema": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "integer" }, "priceCategoryCode": { "type": "string" }, "costComponentCode": { "type": "string" }, "calculationMode": { "type": "integer" }, "isTiered": { "type": "boolean" }, "tieredMode": { "type": "integer" }, "tierLevel": { "type": "integer" }, "volumeCoefficient": { "type": "integer" }, "chargePenalty": { "type": "boolean" }, "sort": { "type": "integer" }, "remark": { "type": "string" }, "tierAdjustments": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "integer" }, "costAdjustmentId": { "type": "integer" }, "costComponentCode": { "type": "string" }, "tierLevel": { "type": "integer" }, "startVolume": { "type": "integer" }, "endVolume": { "type": "integer" }, "price": { "type": "number" }, "volumeCoefficient": { "type": "integer" }, "sort": { "type": "integer" }, "remark": { "type": "string" } }, "required": [ "id" ] } } }, "required": [ "id" ] } }, "example": [ { "id": 1, "priceCategoryCode": "RESIDENTIAL", "costComponentCode": "BASIC_WATER_FEE", "calculationMode": 1, "isTiered": false, "tieredMode": 0, "tierLevel": 0, "volumeCoefficient": 1, "chargePenalty": true, "sort": 0, "remark": "string", "tierAdjustments": [ { "id": 1, "costAdjustmentId": 1001, "costComponentCode": "BASIC_WATER_FEE", "tierLevel": 1, "startVolume": 0, "endVolume": 100, "price": 2.5, "volumeCoefficient": 1, "sort": 0, "remark": "string" } ] } ] } } }, "responses": { "200": { "description": "水表厂家列表", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "data", "msg" ], "properties": { "code": { "type": "integer", "example": 0 }, "data": { "type": "array", "items": { "type": "object", "required": [ "id", "priceCategoryCode", "costComponentCode" ], "properties": { "id": { "type": "integer", "format": "int64", "description": "主键", "example": 1001 }, "priceCategoryCode": { "type": "string", "description": "水价归属代码", "maxLength": 100, "example": "RESIDENTIAL" }, "costComponentCode": { "type": "string", "description": "费用组成代码", "maxLength": 100, "example": "BASIC_WATER_FEE" }, "calculationMode": { "type": "integer", "description": "计算类型", "example": 1 }, "isTiered": { "type": "boolean", "description": "是否阶梯(0-非阶梯，1-阶梯)", "example": false }, "tieredMode": { "type": "integer", "description": "阶梯类型", "example": 0 }, "tierLevel": { "type": "integer", "description": "阶梯级别(第几阶梯，如1、2、3等)", "example": 0 }, "volumeCoefficient": { "type": "number", "format": "decimal", "description": "水量系数(用于特殊计算场景)", "example": 1 }, "chargePenalty": { "type": "boolean", "description": "是否收取违约金(0-不收取，1-收取)", "example": true }, "sort": { "type": "integer", "description": "排序", "example": 0 }, "remark": { "type": "string", "description": "备注", "maxLength": 500 }, "status": { "type": "integer", "description": "状态", "example": 0 }, "createTime": { "type": "string", "format": "date-time", "description": "创建时间", "readOnly": true, "example": "2023-12-01T10:30:00Z" }, "updateTime": { "type": "string", "format": "date-time", "description": "更新时间", "readOnly": true, "example": "2023-12-01T10:30:00Z" }, "creator": { "type": "string", "description": "创建人id", "readOnly": true, "maxLength": 100 }, "updater": { "type": "string", "description": "更新人id", "readOnly": true, "maxLength": 100 }, "deleted": { "type": "boolean", "description": "是否删除", "readOnly": true, "example": false }, "tenantId": { "type": "integer", "format": "int64", "description": "租户id", "readOnly": true, "example": 0 }, "tierAdjustments": { "type": "array", "description": "阶梯调整列表", "items": { "type": "object", "required": [ "id", "costAdjustmentId", "costComponentCode", "price" ], "properties": { "id": { "type": "integer", "format": "int64", "description": "主键", "example": 2001 }, "costAdjustmentId": { "type": "integer", "format": "int64", "description": "水价费用调整id", "example": 1001 }, "costComponentCode": { "type": "string", "description": "费用组成代码", "maxLength": 100, "example": "BASIC_WATER_FEE" }, "tierLevel": { "type": "integer", "description": "阶梯级别(第几阶梯，如1、2、3等)", "example": 1 }, "startVolume": { "type": "number", "format": "decimal", "description": "开始水量(单位：立方米)", "example": 0 }, "endVolume": { "type": "number", "format": "decimal", "description": "结束水量(单位：立方米，为空表示无上限)", "example": 100 }, "price": { "type": "number", "format": "decimal", "description": "价格(单位：元/立方米或元（固定费用）)", "example": 2.5 }, "volumeCoefficient": { "type": "number", "format": "decimal", "description": "水量系数(用于特殊计算场景)", "example": 1 }, "sort": { "type": "integer", "description": "排序", "example": 0 }, "remark": { "type": "string", "description": "备注", "maxLength": 500 }, "status": { "type": "integer", "description": "状态", "example": 0 }, "createTime": { "type": "string", "format": "date-time", "description": "创建时间", "readOnly": true, "example": "2023-12-01T10:30:00Z" }, "updateTime": { "type": "string", "format": "date-time", "description": "更新时间", "readOnly": true, "example": "2023-12-01T10:30:00Z" }, "creator": { "type": "string", "description": "创建人id", "readOnly": true, "maxLength": 100 }, "updater": { "type": "string", "description": "更新人id", "readOnly": true, "maxLength": 100 }, "deleted": { "type": "boolean", "description": "是否删除", "readOnly": true, "example": false }, "tenantId": { "type": "integer", "format": "int64", "description": "租户id", "readOnly": true, "example": 0 } } } } } } }, "msg": { "type": "string", "example": "" } } }, "example": { "code": 0, "data": [ { "id": 1001, "priceCategoryCode": "RESIDENTIAL", "costComponentCode": "BASIC_WATER_FEE", "calculationMode": 1, "isTiered": false, "tieredMode": 0, "tierLevel": 0, "volumeCoefficient": 1, "chargePenalty": true, "sort": 0, "remark": "string", "status": 0, "createTime": "2023-12-01T10:30:00Z", "updateTime": "2023-12-01T10:30:00Z", "creator": "string", "updater": "string", "deleted": false, "tenantId": 0, "tierAdjustments": [ { "id": 2001, "costAdjustmentId": 1001, "costComponentCode": "BASIC_WATER_FEE", "tierLevel": 1, "startVolume": 0, "endVolume": 100, "price": 2.5, "volumeCoefficient": 1, "sort": 0, "remark": "string", "status": 0, "createTime": "2023-12-01T10:30:00Z", "updateTime": "2023-12-01T10:30:00Z", "creator": "string", "updater": "string", "deleted": false, "tenantId": 0 } ] } ], "msg": "" } } }, "headers": {} } }, "security": [] } }, "/admin-api/business/price-template/create": { "post": { "summary": "创建水价费用调整模板", "deprecated": false, "description": "", "tags": [], "parameters": [ { "name": "tag", "in": "header", "description": "默认全局带上tag参数，优先访问本地启动的服务", "example": "{{tag}}", "schema": { "type": "string", "default": "{{tag}}" } }, { "name": "Authorization", "in": "header", "description": "", "example": "{{authorization}}", "schema": { "type": "string", "default": "{{authorization}}" } }, { "name": "tenant-id", "in": "header", "description": "", "example": "{{tenant-id}}", "schema": { "type": "string", "default": "{{tenant-id}}" } } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "string", "title": "模版代码" }, "name": { "type": "string", "title": "用水性质" }, "priceCategoryCode": { "type": "string", "title": "用水性质归属" }, "meterStart": { "type": "integer", "title": "起开量" }, "remark": { "type": "string", "title": "备注", "nullable": true } }, "required": [ "code", "name", "priceCategoryCode", "meterStart" ] }, "examples": {} } } }, "responses": { "200": { "description": "", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "integer" }, "data": { "nullable": true, "oneOf": [ { "type": "string" }, { "type": "integer" }, { "type": "boolean" }, { "type": "array" }, { "type": "object" }, { "type": "number" } ] }, "msg": { "type": "string" } }, "required": [ "code", "msg" ] } } }, "headers": {} } }, "security": [] } }, "/admin-api/business/price-adjustment-history/page": { "get": { "summary": "水价调整历史分页", "deprecated": false, "description": "", "tags": [], "parameters": [ { "name": "pageNo", "in": "query", "description": "页码，从1开始", "required": false, "example": 0, "schema": { "type": "integer" } }, { "name": "pageSize", "in": "query", "description": "每页数量", "required": false, "example": 0, "schema": { "type": "integer" } }, { "name": "sort", "in": "query", "description": "排序字段，加-为降序，多个逗号分割", "required": false, "example": "", "schema": { "type": "string" } }, { "name": "search", "in": "query", "description": "支持多个字段模糊搜索", "required": false, "example": "", "schema": { "type": "string" } }, { "name": "status", "in": "query", "description": "状态过滤", "required": false, "example": "", "schema": { "type": "string" } }, { "name": "tag", "in": "header", "description": "默认全局带上tag参数，优先访问本地启动的服务", "example": "{{tag}}", "schema": { "type": "string", "default": "{{tag}}" } }, { "name": "Authorization", "in": "header", "description": "", "example": "{{authorization}}", "schema": { "type": "string", "default": "{{authorization}}" } }, { "name": "tenant-id", "in": "header", "description": "", "example": "{{tenant-id}}", "schema": { "type": "string", "default": "{{tenant-id}}" } } ], "responses": { "200": { "description": "", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "data", "msg" ], "properties": { "code": { "type": "integer", "example": 0 }, "data": { "type": "object", "required": [ "list", "total" ], "properties": { "list": { "type": "array", "items": { "type": "object", "required": [ "id", "priceCategoryCode", "effectiveDate" ], "properties": { "id": { "type": "integer", "format": "int64", "description": "主键", "example": 1001 }, "priceCategoryCode": { "type": "string", "description": "水价归属代码", "maxLength": 100, "example": "RESIDENTIAL" }, "adjustmentName": { "type": "string", "description": "调价名称(如：2024年居民用水调价方案)", "maxLength": 200, "example": "2024年居民用水调价方案" }, "effectiveDate": { "type": "string", "format": "date", "description": "生效日期", "example": "2024-01-01" }, "expiryDate": { "type": "string", "format": "date", "description": "失效日期(为空表示长期有效)", "example": "2024-12-31" }, "adjustmentReason": { "type": "string", "description": "调价原因", "maxLength": 500, "example": "根据市政府相关文件精神，结合当前水资源成本上涨情况" }, "adjuster": { "type": "string", "description": "调价人", "maxLength": 100, "example": "张三" }, "adjustmentTime": { "type": "string", "format": "date-time", "description": "调价时间", "example": "2023-12-01T10:30:00Z" }, "remark": { "type": "string", "description": "备注", "maxLength": 500 }, "status": { "type": "integer", "description": "状态", "example": 0 }, "createTime": { "type": "string", "format": "date-time", "description": "创建时间", "readOnly": true, "example": "2023-12-01T10:30:00Z" }, "updateTime": { "type": "string", "format": "date-time", "description": "更新时间", "readOnly": true, "example": "2023-12-01T10:30:00Z" }, "creator": { "type": "string", "description": "创建人id", "readOnly": true, "maxLength": 100 }, "updater": { "type": "string", "description": "更新人id", "readOnly": true, "maxLength": 100 }, "deleted": { "type": "boolean", "description": "是否删除", "readOnly": true, "example": false }, "tenantId": { "type": "integer", "format": "int64", "description": "租户id", "readOnly": true, "example": 0 } } } }, "total": { "type": "integer", "example": 15 } } }, "msg": { "type": "string", "example": "" } } }, "example": { "code": 0, "data": { "list": [ { "id": 1001, "priceCategoryCode": "RESIDENTIAL", "adjustmentName": "2024年居民用水调价方案", "effectiveDate": "2024-01-01", "expiryDate": "2024-12-31", "adjustmentReason": "根据市政府相关文件精神，结合当前水资源成本上涨情况", "adjuster": "张三", "adjustmentTime": "2023-12-01T10:30:00Z", "remark": "string", "status": 0, "createTime": "2023-12-01T10:30:00Z", "updateTime": "2023-12-01T10:30:00Z", "creator": "string", "updater": "string", "deleted": false, "tenantId": 0 } ], "total": 15 }, "msg": "" } } }, "headers": {} } }, "security": [] } }, "/admin-api/business/price-adjustment-history/detail": { "get": { "summary": "水价调整历史->详情", "deprecated": false, "description": "", "tags": [], "parameters": [ { "name": "id", "in": "query", "description": "水价历史id", "required": false, "schema": { "type": "string" } }, { "name": "tag", "in": "header", "description": "默认全局带上tag参数，优先访问本地启动的服务", "example": "{{tag}}", "schema": { "type": "string", "default": "{{tag}}" } }, { "name": "Authorization", "in": "header", "description": "", "example": "{{authorization}}", "schema": { "type": "string", "default": "{{authorization}}" } }, { "name": "tenant-id", "in": "header", "description": "", "example": "{{tenant-id}}", "schema": { "type": "string", "default": "{{tenant-id}}" } } ], "responses": { "200": { "description": "", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "data", "msg" ], "properties": { "code": { "type": "integer", "example": 0 }, "data": { "type": "array", "items": { "type": "object", "required": [ "id", "historyId", "priceCategoryCode", "costComponentCode" ], "properties": { "id": { "type": "integer", "format": "int64", "description": "主键", "example": 1001 }, "historyId": { "type": "integer", "format": "int64", "description": "水价调整记录id", "example": 5001 }, "priceCategoryCode": { "type": "string", "description": "水价归属代码", "maxLength": 100, "example": "RESIDENTIAL" }, "costComponentCode": { "type": "string", "description": "费用组成代码", "maxLength": 100, "example": "BASIC_WATER_FEE" }, "calculationMode": { "type": "integer", "description": "计算类型", "example": 1 }, "isTiered": { "type": "boolean", "description": "是否阶梯(0-非阶梯，1-阶梯)", "example": false }, "tieredMode": { "type": "integer", "description": "阶梯类型", "example": 0 }, "tierLevel": { "type": "integer", "description": "阶梯级别(第几阶梯，如1、2、3等)", "example": 0 }, "volumeCoefficient": { "type": "number", "format": "decimal", "description": "水量系数(用于特殊计算场景)", "example": 1 }, "chargePenalty": { "type": "boolean", "description": "是否收取违约金(0-不收取，1-收取)", "example": true }, "sort": { "type": "integer", "description": "排序", "example": 0 }, "remark": { "type": "string", "description": "备注", "maxLength": 500 }, "status": { "type": "integer", "description": "状态", "example": 0 }, "createTime": { "type": "string", "format": "date-time", "description": "创建时间", "readOnly": true, "example": "2023-12-01T10:30:00Z" }, "updateTime": { "type": "string", "format": "date-time", "description": "更新时间", "readOnly": true, "example": "2023-12-01T10:30:00Z" }, "creator": { "type": "string", "description": "创建人id", "readOnly": true, "maxLength": 100 }, "updater": { "type": "string", "description": "更新人id", "readOnly": true, "maxLength": 100 }, "deleted": { "type": "boolean", "description": "是否删除", "readOnly": true, "example": false }, "tenantId": { "type": "integer", "format": "int64", "description": "租户id", "readOnly": true, "example": 0 }, "tierAdjustmentHistories": { "type": "array", "description": "阶梯调整历史列表", "items": { "type": "object", "required": [ "id", "costAdjustmentHistoryId", "costComponentCode", "price" ], "properties": { "id": { "type": "integer", "format": "int64", "description": "主键", "example": 2001 }, "costAdjustmentHistoryId": { "type": "integer", "format": "int64", "description": "水价费用调整历史id", "example": 1001 }, "costComponentCode": { "type": "string", "description": "费用组成代码", "maxLength": 100, "example": "BASIC_WATER_FEE" }, "tierLevel": { "type": "integer", "description": "阶梯级别(第几阶梯，如1、2、3等)", "example": 1 }, "startVolume": { "type": "number", "format": "decimal", "description": "开始水量(单位：立方米)", "example": 0 }, "endVolume": { "type": "number", "format": "decimal", "description": "结束水量(单位：立方米，为空表示无上限)", "example": 100 }, "price": { "type": "number", "format": "decimal", "description": "价格(单位：元/立方米或元（固定费用）)", "example": 2.5 }, "volumeCoefficient": { "type": "number", "format": "decimal", "description": "水量系数(用于特殊计算场景)", "example": 1 }, "sort": { "type": "integer", "description": "排序", "example": 0 }, "remark": { "type": "string", "description": "备注", "maxLength": 500 }, "status": { "type": "integer", "description": "状态", "example": 0 }, "createTime": { "type": "string", "format": "date-time", "description": "创建时间", "readOnly": true, "example": "2023-12-01T10:30:00Z" }, "updateTime": { "type": "string", "format": "date-time", "description": "更新时间", "readOnly": true, "example": "2023-12-01T10:30:00Z" }, "creator": { "type": "string", "description": "创建人id", "readOnly": true, "maxLength": 100 }, "updater": { "type": "string", "description": "更新人id", "readOnly": true, "maxLength": 100 }, "deleted": { "type": "boolean", "description": "是否删除", "readOnly": true, "example": false }, "tenantId": { "type": "integer", "format": "int64", "description": "租户id", "readOnly": true, "example": 0 } } } } } } }, "msg": { "type": "string", "example": "" } } }, "example": { "code": 0, "data": [ { "id": 1001, "historyId": 5001, "priceCategoryCode": "RESIDENTIAL", "costComponentCode": "BASIC_WATER_FEE", "calculationMode": 1, "isTiered": false, "tieredMode": 0, "tierLevel": 0, "volumeCoefficient": 1, "chargePenalty": true, "sort": 0, "remark": "string", "status": 0, "createTime": "2023-12-01T10:30:00Z", "updateTime": "2023-12-01T10:30:00Z", "creator": "string", "updater": "string", "deleted": false, "tenantId": 0, "tierAdjustmentHistories": [ { "id": 2001, "costAdjustmentHistoryId": 1001, "costComponentCode": "BASIC_WATER_FEE", "tierLevel": 1, "startVolume": 0, "endVolume": 100, "price": 2.5, "volumeCoefficient": 1, "sort": 0, "remark": "string", "status": 0, "createTime": "2023-12-01T10:30:00Z", "updateTime": "2023-12-01T10:30:00Z", "creator": "string", "updater": "string", "deleted": false, "tenantId": 0 } ] } ], "msg": "" } } }, "headers": {} } }, "security": [] } }, "/admin-api/business/price-discount-scheme/page": { "get": { "summary": "水价优惠方案查询", "deprecated": false, "description": "", "tags": [], "parameters": [ { "name": "pageNo", "in": "query", "description": "integer，页码", "required": false, "schema": { "type": "string" } }, { "name": "pageSize", "in": "query", "description": "integer，每页大小", "required": false, "schema": { "type": "string" } }, { "name": "search", "in": "query", "description": "string，支持多个字段模糊搜索", "required": false, "schema": { "type": "string" } }, { "name": "sort", "in": "query", "description": "string，排序字段，加-为降序，多个逗号分割", "required": false, "schema": { "type": "string" } }, { "name": "tag", "in": "header", "description": "默认全局带上tag参数，优先访问本地启动的服务", "example": "{{tag}}", "schema": { "type": "string", "default": "{{tag}}" } }, { "name": "Authorization", "in": "header", "description": "", "example": "{{authorization}}", "schema": { "type": "string", "default": "{{authorization}}" } }, { "name": "tenant-id", "in": "header", "description": "", "example": "{{tenant-id}}", "schema": { "type": "string", "default": "{{tenant-id}}" } } ], "responses": { "200": { "description": "", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "data", "msg" ], "properties": { "code": { "type": "integer", "example": 0 }, "data": { "type": "array", "items": { "type": "object", "required": [ "id", "schemeName", "schemeCode", "priceCategoryCode", "discountType", "effectiveDate" ], "properties": { "id": { "type": "integer", "format": "int64", "description": "主键", "example": 1001 }, "schemeName": { "type": "string", "description": "方案名称(如：居民用户优惠方案2024)", "maxLength": 200, "example": "居民用户优惠方案2024" }, "schemeCode": { "type": "string", "description": "方案代码", "maxLength": 100, "example": "RESIDENT_DISCOUNT_2024" }, "priceCategoryCode": { "type": "string", "description": "水价归属代码", "maxLength": 100, "example": "RESIDENTIAL" }, "discountType": { "type": "integer", "description": "优惠方式", "example": 1 }, "effectiveDate": { "type": "string", "format": "date", "description": "生效日期", "example": "2024-01-01" }, "expiryDate": { "type": "string", "format": "date", "description": "失效日期(为空表示长期有效)", "example": "2024-12-31" }, "schemeDescription": { "type": "string", "description": "方案描述", "maxLength": 1000, "example": "针对居民用户的水费优惠方案，采用阶梯式优惠模式" }, "sort": { "type": "integer", "description": "排序", "example": 0 }, "remark": { "type": "string", "description": "备注", "maxLength": 500 }, "status": { "type": "integer", "description": "状态", "example": 0 }, "createTime": { "type": "string", "format": "date-time", "description": "创建时间", "readOnly": true, "example": "2023-12-01T10:30:00Z" }, "updateTime": { "type": "string", "format": "date-time", "description": "更新时间", "readOnly": true, "example": "2023-12-01T10:30:00Z" }, "creator": { "type": "string", "description": "创建人id", "readOnly": true, "maxLength": 100 }, "updater": { "type": "string", "description": "更新人id", "readOnly": true, "maxLength": 100 }, "deleted": { "type": "boolean", "description": "是否删除", "readOnly": true, "example": false }, "tenantId": { "type": "integer", "format": "int64", "description": "租户id", "readOnly": true, "example": 0 } } } }, "msg": { "type": "string", "example": "" } } }, "example": { "code": 0, "data": [ { "id": 1001, "schemeName": "居民用户优惠方案2024", "schemeCode": "RESIDENT_DISCOUNT_2024", "priceCategoryCode": "RESIDENTIAL", "discountType": 1, "effectiveDate": "2024-01-01", "expiryDate": "2024-12-31", "schemeDescription": "针对居民用户的水费优惠方案，采用阶梯式优惠模式", "sort": 0, "remark": "string", "status": 0, "createTime": "2023-12-01T10:30:00Z", "updateTime": "2023-12-01T10:30:00Z", "creator": "string", "updater": "string", "deleted": false, "tenantId": 0 } ], "msg": "" } } }, "headers": {} } }, "security": [] } }, "/admin-api/business/price-discount-scheme/detail": { "get": { "summary": "水价优惠方案->详情", "deprecated": false, "description": "", "tags": [], "parameters": [ { "name": "scheme_code", "in": "query", "description": "水价优惠代码", "required": true, "example": "1", "schema": { "type": "string" } }, { "name": "tag", "in": "header", "description": "默认全局带上tag参数，优先访问本地启动的服务", "example": "{{tag}}", "schema": { "type": "string", "default": "{{tag}}" } }, { "name": "Authorization", "in": "header", "description": "", "example": "{{authorization}}", "schema": { "type": "string", "default": "{{authorization}}" } }, { "name": "tenant-id", "in": "header", "description": "", "example": "{{tenant-id}}", "schema": { "type": "string", "default": "{{tenant-id}}" } } ], "responses": { "200": { "description": "", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "data", "msg" ], "properties": { "code": { "type": "integer", "example": 0 }, "data": { "type": "array", "items": { "type": "object", "required": [ "id", "schemeCode" ], "properties": { "id": { "type": "integer", "format": "int64", "description": "主键", "example": 2001 }, "schemeCode": { "type": "string", "description": "优惠方案代码", "maxLength": 100, "example": "RESIDENT_DISCOUNT_2024" }, "tierLevel": { "type": "integer", "description": "阶梯级别(第几阶梯，如1、2、3等)", "example": 1 }, "startVolume": { "type": "number", "format": "decimal", "description": "开始水量(单位：立方米)", "example": 0 }, "endVolume": { "type": "number", "format": "decimal", "description": "结束水量(单位：立方米，为空表示无上限)", "example": 50 }, "includeInTier": { "type": "boolean", "description": "是否计入阶梯(0-不计入阶梯，1-计入阶梯)", "example": true }, "sort": { "type": "integer", "description": "排序", "example": 0 }, "remark": { "type": "string", "description": "备注", "maxLength": 500 }, "status": { "type": "integer", "description": "状态", "example": 0 }, "createTime": { "type": "string", "format": "date-time", "description": "创建时间", "readOnly": true, "example": "2023-12-01T10:30:00Z" }, "updateTime": { "type": "string", "format": "date-time", "description": "更新时间", "readOnly": true, "example": "2023-12-01T10:30:00Z" }, "creator": { "type": "string", "description": "创建人id", "readOnly": true, "maxLength": 100 }, "updater": { "type": "string", "description": "更新人id", "readOnly": true, "maxLength": 100 }, "deleted": { "type": "boolean", "description": "是否删除", "readOnly": true, "example": false }, "tenantId": { "type": "integer", "format": "int64", "description": "租户id", "readOnly": true, "example": 0 }, "discountCosts": { "type": "array", "description": "优惠费用列表", "items": { "type": "object", "required": [ "id", "tierId", "costComponentCode", "discountPrice" ], "properties": { "id": { "type": "integer", "format": "int64", "description": "主键", "example": 3001 }, "tierId": { "type": "integer", "format": "int64", "description": "优惠阶梯id", "example": 2001 }, "costComponentCode": { "type": "string", "description": "费用组成代码", "maxLength": 100, "example": "BASIC_WATER_FEE" }, "discountPrice": { "type": "number", "format": "decimal", "description": "优惠价格(单位：元/立方米或元（固定费用）)", "example": 2 }, "sort": { "type": "integer", "description": "排序", "example": 0 }, "remark": { "type": "string", "description": "备注", "maxLength": 500 }, "status": { "type": "integer", "description": "状态", "example": 0 }, "createTime": { "type": "string", "format": "date-time", "description": "创建时间", "readOnly": true, "example": "2023-12-01T10:30:00Z" }, "updateTime": { "type": "string", "format": "date-time", "description": "更新时间", "readOnly": true, "example": "2023-12-01T10:30:00Z" }, "creator": { "type": "string", "description": "创建人id", "readOnly": true, "maxLength": 100 }, "updater": { "type": "string", "description": "更新人id", "readOnly": true, "maxLength": 100 }, "deleted": { "type": "boolean", "description": "是否删除", "readOnly": true, "example": false }, "tenantId": { "type": "integer", "format": "int64", "description": "租户id", "readOnly": true, "example": 0 } } } } } } }, "msg": { "type": "string", "example": "" } } }, "example": { "code": 0, "data": [ { "id": 2001, "schemeCode": "RESIDENT_DISCOUNT_2024", "tierLevel": 1, "startVolume": 0, "endVolume": 50, "includeInTier": true, "sort": 0, "remark": "string", "status": 0, "createTime": "2023-12-01T10:30:00Z", "updateTime": "2023-12-01T10:30:00Z", "creator": "string", "updater": "string", "deleted": false, "tenantId": 0, "discountCosts": [ { "id": 3001, "tierId": 2001, "costComponentCode": "BASIC_WATER_FEE", "discountPrice": 2, "sort": 0, "remark": "string", "status": 0, "createTime": "2023-12-01T10:30:00Z", "updateTime": "2023-12-01T10:30:00Z", "creator": "string", "updater": "string", "deleted": false, "tenantId": 0 } ] } ], "msg": "" } } }, "headers": {} } }, "security": [] } }, "/admin-api/business/price-discount-scheme/create": { "post": { "summary": "创建水价优惠方案", "deprecated": false, "description": "", "tags": [], "parameters": [ { "name": "tag", "in": "header", "description": "默认全局带上tag参数，优先访问本地启动的服务", "example": "{{tag}}", "schema": { "type": "string", "default": "{{tag}}" } }, { "name": "Authorization", "in": "header", "description": "", "example": "{{authorization}}", "schema": { "type": "string", "default": "{{authorization}}" } }, { "name": "tenant-id", "in": "header", "description": "", "example": "{{tenant-id}}", "schema": { "type": "string", "default": "{{tenant-id}}" } } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "schemeName": { "type": "string" }, "schemeCode": { "type": "string" }, "priceCategoryCode": { "type": "string" }, "discountType": { "type": "integer" }, "effectiveDate": { "type": "string" }, "expiryDate": { "type": "string" }, "schemeDescription": { "type": "string" }, "sort": { "type": "integer" }, "remark": { "type": "string" }, "adiscountTiers": { "type": "array", "items": { "type": "object", "properties": { "schemeCode": { "type": "string" }, "tierLevel": { "type": "integer" }, "startVolume": { "type": "integer" }, "endVolume": { "type": "integer" }, "includeInTier": { "type": "boolean" }, "sort": { "type": "integer" }, "remark": { "type": "string" }, "discountCosts": { "type": "array", "items": { "type": "object", "properties": { "tierId": { "type": "integer" }, "costComponentCode": { "type": "string" }, "discountPrice": { "type": "integer" }, "sort": { "type": "integer" }, "remark": { "type": "string" } }, "required": [ "tierId", "costComponentCode", "discountPrice" ] } } }, "required": [ "schemeCode" ] } } }, "required": [ "schemeName", "schemeCode", "priceCategoryCode", "discountType", "effectiveDate", "adiscountTiers" ] }, "example": { "schemeName": "居民用户优惠方案2024", "schemeCode": "RESIDENT_DISCOUNT_2024", "priceCategoryCode": "RESIDENTIAL", "discountType": 1, "effectiveDate": "2024-01-01", "expiryDate": "2024-12-31", "schemeDescription": "针对居民用户的水费优惠方案，采用阶梯式优惠模式", "sort": 0, "remark": "string", "adiscountTiers": [ { "schemeCode": "RESIDENT_DISCOUNT_2024", "tierLevel": 1, "startVolume": 0, "endVolume": 50, "includeInTier": true, "sort": 0, "remark": "string", "discountCosts": [ { "tierId": 2001, "costComponentCode": "BASIC_WATER_FEE", "discountPrice": 2, "sort": 0, "remark": "string" } ] } ] } } } }, "responses": { "200": { "description": "", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "integer" }, "data": { "type": "boolean" }, "msg": { "type": "string" } }, "required": [ "code", "data", "msg" ] }, "example": { "code": 0, "data": true, "msg": "string" } } }, "headers": {} } }, "security": [] } }, "/admin-api/business/price-discount-scheme/update": { "post": { "summary": "修改水价优惠方案", "deprecated": false, "description": "", "tags": [], "parameters": [ { "name": "tag", "in": "header", "description": "默认全局带上tag参数，优先访问本地启动的服务", "example": "{{tag}}", "schema": { "type": "string", "default": "{{tag}}" } }, { "name": "Authorization", "in": "header", "description": "", "example": "{{authorization}}", "schema": { "type": "string", "default": "{{authorization}}" } }, { "name": "tenant-id", "in": "header", "description": "", "example": "{{tenant-id}}", "schema": { "type": "string", "default": "{{tenant-id}}" } } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "integer" }, "schemeName": { "type": "string" }, "schemeCode": { "type": "string" }, "priceCategoryCode": { "type": "string" }, "discountType": { "type": "integer" }, "effectiveDate": { "type": "string" }, "expiryDate": { "type": "string" }, "schemeDescription": { "type": "string" }, "sort": { "type": "integer" }, "remark": { "type": "string" }, "adiscountTiers": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "integer" }, "schemeCode": { "type": "string" }, "tierLevel": { "type": "integer" }, "startVolume": { "type": "integer" }, "endVolume": { "type": "integer" }, "includeInTier": { "type": "boolean" }, "sort": { "type": "integer" }, "remark": { "type": "string" }, "discountCosts": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "integer" }, "tierId": { "type": "integer" }, "costComponentCode": { "type": "string" }, "discountPrice": { "type": "integer" }, "sort": { "type": "integer" }, "remark": { "type": "string" } }, "required": [ "id" ] } } }, "required": [ "id" ] } } }, "required": [ "id" ] }, "example": { "id": 1, "schemeName": "居民用户优惠方案2024", "schemeCode": "RESIDENT_DISCOUNT_2024", "priceCategoryCode": "RESIDENTIAL", "discountType": 1, "effectiveDate": "2024-01-01", "expiryDate": "2024-12-31", "schemeDescription": "针对居民用户的水费优惠方案，采用阶梯式优惠模式", "sort": 0, "remark": "string", "adiscountTiers": [ { "id": 1, "schemeCode": "RESIDENT_DISCOUNT_2024", "tierLevel": 1, "startVolume": 0, "endVolume": 50, "includeInTier": true, "sort": 0, "remark": "string", "discountCosts": [ { "id": 1, "tierId": 2001, "costComponentCode": "BASIC_WATER_FEE", "discountPrice": 2, "sort": 0, "remark": "string" } ] } ] } } } }, "responses": { "200": { "description": "", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "integer" }, "data": { "type": "boolean" }, "msg": { "type": "string" } }, "required": [ "code", "data", "msg" ] }, "example": { "code": 0, "data": true, "msg": "string" } } }, "headers": {} } }, "security": [] } }, "/admin-api/business/water-use-scheme/create": { "post": { "summary": "新增用水方案", "deprecated": false, "description": "", "tags": [], "parameters": [ { "name": "tag", "in": "header", "description": "默认全局带上tag参数，优先访问本地启动的服务", "example": "{{tag}}", "schema": { "type": "string", "default": "{{tag}}" } }, { "name": "Authorization", "in": "header", "description": "", "example": "{{authorization}}", "schema": { "type": "string", "default": "{{authorization}}" } }, { "name": "tenant-id", "in": "header", "description": "", "example": "{{tenant-id}}", "schema": { "type": "string", "default": "{{tenant-id}}" } } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "name": { "type": "string", "title": "方案名称" }, "templateCode": { "type": "string", "title": "水价调整模板代码" }, "schemeCycle": { "type": "integer", "title": "计划周期" }, "schemeType": { "type": "integer", "title": "计划模式" }, "waterUseSchemeTierList": { "type": "array", "items": { "type": "object", "properties": { "level": { "type": "string", "title": "级别名称" }, "startWater": { "type": "integer", "title": "阶梯下限" }, "endWater": { "type": "integer", "title": "阶梯上限" }, "price": { "type": "number", "title": "价格" } }, "required": [ "level", "startWater", "endWater", "price" ] }, "title": "阶梯数组" } }, "required": [ "name", "templateCode", "schemeCycle", "schemeType" ] }, "examples": {} } } }, "responses": { "200": { "description": "", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "integer" }, "data": { "nullable": true, "oneOf": [ { "type": "string" }, { "type": "integer" }, { "type": "boolean" }, { "type": "array" }, { "type": "object" }, { "type": "number" } ] }, "msg": { "type": "string" } }, "required": [ "code", "msg" ] } } }, "headers": {} } }, "security": [] } }, "/admin-api/business/water-use-scheme/update": { "put": { "summary": "更新用水方案", "deprecated": false, "description": "", "tags": [], "parameters": [ { "name": "tag", "in": "header", "description": "默认全局带上tag参数，优先访问本地启动的服务", "example": "{{tag}}", "schema": { "type": "string", "default": "{{tag}}" } }, { "name": "Authorization", "in": "header", "description": "", "example": "{{authorization}}", "schema": { "type": "string", "default": "{{authorization}}" } }, { "name": "tenant-id", "in": "header", "description": "", "example": "{{tenant-id}}", "schema": { "type": "string", "default": "{{tenant-id}}" } } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "integer" }, "name": { "type": "string" }, "templateCode": { "type": "string" }, "schemeCycle": { "type": "integer" }, "schemeType": { "type": "integer" }, "waterUseSchemeTierList": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "integer" }, "level": { "type": "string" }, "startWater": { "type": "integer" }, "endWater": { "type": "integer" }, "price": { "type": "number" } }, "required": [ "id", "level", "startWater", "endWater", "price" ] } } }, "required": [ "id", "name", "waterUseSchemeTierList", "schemeType", "schemeCycle", "templateCode" ] }, "examples": {} } } }, "responses": { "200": { "description": "", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "integer" }, "data": { "nullable": true, "oneOf": [ { "type": "string" }, { "type": "integer" }, { "type": "boolean" }, { "type": "array" }, { "type": "object" }, { "type": "number" } ] }, "msg": { "type": "string" } }, "required": [ "code", "msg" ] } } }, "headers": {} } }, "security": [] } }, "/admin-api/business/water-use-scheme/update-status": { "put": { "summary": "修改用水方案状态", "deprecated": false, "description": "", "tags": [], "parameters": [ { "name": "tag", "in": "header", "description": "默认全局带上tag参数，优先访问本地启动的服务", "example": "{{tag}}", "schema": { "type": "string", "default": "{{tag}}" } }, { "name": "Authorization", "in": "header", "description": "", "example": "{{authorization}}", "schema": { "type": "string", "default": "{{authorization}}" } }, { "name": "tenant-id", "in": "header", "description": "", "example": "{{tenant-id}}", "schema": { "type": "string", "default": "{{tenant-id}}" } } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "integer" }, "status": { "type": "integer" } }, "required": [ "id", "status" ] }, "examples": {} } } }, "responses": { "200": { "description": "", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "integer" }, "data": { "nullable": true, "oneOf": [ { "type": "string" }, { "type": "integer" }, { "type": "boolean" }, { "type": "array" }, { "type": "object" }, { "type": "number" } ] }, "msg": { "type": "string" } }, "required": [ "code", "msg" ] } } }, "headers": {} } }, "security": [] } }, "/admin-api/business/water-use-scheme/page": { "get": { "summary": "分页查询用水方案", "deprecated": false, "description": "", "tags": [], "parameters": [ { "name": "pageNo", "in": "query", "description": "", "required": true, "schema": { "type": "integer" } }, { "name": "pageSIZE", "in": "query", "description": "", "required": true, "schema": { "type": "integer" } }, { "name": "name", "in": "query", "description": "", "required": false, "schema": { "type": "string" } }, { "name": "tag", "in": "header", "description": "默认全局带上tag参数，优先访问本地启动的服务", "example": "{{tag}}", "schema": { "type": "string", "default": "{{tag}}" } }, { "name": "Authorization", "in": "header", "description": "", "example": "{{authorization}}", "schema": { "type": "string", "default": "{{authorization}}" } }, { "name": "tenant-id", "in": "header", "description": "", "example": "{{tenant-id}}", "schema": { "type": "string", "default": "{{tenant-id}}" } } ], "responses": { "200": { "description": "", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "integer" }, "data": { "type": "object", "properties": { "list": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "integer" }, "name": { "type": "string" }, "templateCode": { "type": "string" }, "schemeCycle": { "type": "integer" }, "schemeType": { "type": "integer" }, "remark": { "type": "string" }, "status": { "type": "integer" }, "createTime": { "type": "string" }, "updateTime": { "type": "string" }, "creator": { "type": "string" }, "updater": { "type": "string" }, "deleted": { "type": "integer" }, "tenantId": { "type": "integer" } }, "required": [ "id", "remark", "schemeType", "schemeCycle", "templateCode", "name", "updater", "creator", "updateTime", "createTime", "status", "tenantId", "deleted" ] } }, "total": { "type": "integer" } }, "required": [ "list", "total" ] }, "msg": { "type": "string" } }, "required": [ "code", "msg" ] } } }, "headers": {} } }, "security": [] } }, "/admin-api/business/water-use-scheme/list-all-simple": { "get": { "summary": "获取用水方案精简列表", "deprecated": false, "description": "", "tags": [], "parameters": [ { "name": "tag", "in": "header", "description": "默认全局带上tag参数，优先访问本地启动的服务", "example": "{{tag}}", "schema": { "type": "string", "default": "{{tag}}" } }, { "name": "Authorization", "in": "header", "description": "", "example": "{{authorization}}", "schema": { "type": "string", "default": "{{authorization}}" } }, { "name": "tenant-id", "in": "header", "description": "", "example": "{{tenant-id}}", "schema": { "type": "string", "default": "{{tenant-id}}" } } ], "responses": { "200": { "description": "", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "integer" }, "data": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "integer", "title": "integer", "description": "主键" }, "name": { "type": "string", "description": "方案名称" }, "status": { "type": "integer" } }, "required": [ "id", "name", "status" ] } }, "msg": { "type": "string" } }, "required": [ "code", "msg" ] } } }, "headers": {} } }, "security": [] } }, "/admin-api/business/water-use-scheme/get": { "get": { "summary": "获取用水方案详情", "deprecated": false, "description": "", "tags": [], "parameters": [ { "name": "id", "in": "query", "description": "", "required": false, "schema": { "type": "integer" } }, { "name": "tag", "in": "header", "description": "默认全局带上tag参数，优先访问本地启动的服务", "example": "{{tag}}", "schema": { "type": "string", "default": "{{tag}}" } }, { "name": "Authorization", "in": "header", "description": "", "example": "{{authorization}}", "schema": { "type": "string", "default": "{{authorization}}" } }, { "name": "tenant-id", "in": "header", "description": "", "example": "{{tenant-id}}", "schema": { "type": "string", "default": "{{tenant-id}}" } } ], "responses": { "200": { "description": "", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "integer" }, "data": { "type": "object", "properties": { "id": { "type": "integer" }, "name": { "type": "string" }, "templateCode": { "type": "string" }, "schemeCycle": { "type": "integer" }, "schemeType": { "type": "integer" }, "remark": { "type": "string", "nullable": true }, "status": { "type": "integer", "nullable": true }, "createTime": { "type": "string", "nullable": true }, "updateTime": { "type": "string" }, "creator": { "type": "string" }, "updater": { "type": "string" }, "tenantId": { "type": "integer" }, "waterUseSchemeTierList": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "integer" }, "schemeId": { "type": "integer" }, "level": { "type": "string" }, "startWater": { "type": "integer" }, "endWater": { "type": "integer" }, "price": { "type": "number" }, "sort": { "type": "integer" }, "remark": { "type": "string", "nullable": true }, "status": { "type": "integer", "nullable": true }, "createTime": { "type": "string", "nullable": true }, "updateTime": { "type": "string", "nullable": true }, "creator": { "type": "string" }, "updater": { "type": "string" }, "deleted": { "type": "integer" }, "tenantId": { "type": "integer" } }, "required": [ "id", "endWater", "startWater", "level", "schemeId", "sort", "price", "creator", "updater", "tenantId", "deleted" ] } } }, "required": [ "id", "schemeType", "schemeCycle", "templateCode", "name", "waterUseSchemeTierList" ] }, "msg": { "type": "string" } }, "required": [ "code", "msg" ] } } }, "headers": {} } }, "security": [] } }, "/admin-api/system/user-form-config/batch-save": { "post": { "summary": "批量保存系统表格列配置", "deprecated": false, "description": "", "tags": [], "parameters": [ { "name": "tag", "in": "header", "description": "默认全局带上tag参数，优先访问本地启动的服务", "example": "{{tag}}", "schema": { "type": "string", "default": "{{tag}}" } }, { "name": "Authorization", "in": "header", "description": "", "example": "{{authorization}}", "schema": { "type": "string", "default": "{{authorization}}" } }, { "name": "tenant-id", "in": "header", "description": "", "example": "{{tenant-id}}", "schema": { "type": "string", "default": "{{tenant-id}}" } } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": {} }, "examples": {} } } }, "responses": { "200": { "description": "", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "integer" }, "data": { "type": "boolean" }, "msg": { "type": "string" } }, "required": [ "code", "msg" ] } } }, "headers": {} } }, "security": [] } }, "/admin-api/system/user-form-config/page": { "get": { "summary": "获得系统表格列配置分页", "deprecated": false, "description": "分页查询系统表格列配置列表", "operationId": "getUserFormConfigPage", "tags": [ "系统表格列配置" ], "parameters": [ { "name": "pageNo", "in": "query", "description": "页码，从1开始", "required": false, "schema": { "type": "integer", "minimum": 1, "default": 1 } }, { "name": "pageSize", "in": "query", "description": "每页条数", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 10 } }, { "name": "userId", "in": "query", "description": "用户ID", "required": false, "schema": { "type": "integer", "format": "int64" } }, { "name": "roleId", "in": "query", "description": "角色ID", "required": false, "schema": { "type": "integer", "format": "int64" } }, { "name": "configType", "in": "query", "description": "配置类型：1-个人配置，2-角色配置", "required": false, "schema": { "type": "integer", "enum": [ 1, 2 ] } }, { "name": "menuId", "in": "query", "description": "表格标识", "required": false, "schema": { "type": "string" } }, { "name": "columnKey", "in": "query", "description": "列字段标识", "required": false, "schema": { "type": "string" } }, { "name": "tag", "in": "header", "description": "默认全局带上tag参数，优先访问本地启动的服务", "example": "{{tag}}", "schema": { "type": "string", "default": "{{tag}}" } }, { "name": "Authorization", "in": "header", "description": "", "example": "{{authorization}}", "schema": { "type": "string", "default": "{{authorization}}" } }, { "name": "tenant-id", "in": "header", "description": "", "example": "{{tenant-id}}", "schema": { "type": "string", "default": "{{tenant-id}}" } } ], "responses": { "200": { "description": "分页查询成功", "content": { "application/json": { "schema": { "allOf": [ { "type": "object", "properties": {} }, { "type": "object", "properties": { "data": { "type": "object", "properties": {} } } } ] }, "example": { "code": 0, "data": { "list": [ { "id": 10, "userId": null, "roleId": 1, "configType": 2, "menuId": "10", "columnKey": "createTime", "columnTitle": "创建时间", "columnWidth": 180, "isVisible": 1, "isPrintable": 1, "sortOrder": 5, "createTime": 1752044875528 }, { "id": 9, "userId": null, "roleId": 1, "configType": 2, "menuId": "10", "columnKey": "status", "columnTitle": "状态", "columnWidth": 80, "isVisible": 1, "isPrintable": 1, "sortOrder": 4, "createTime": 1752044875526 }, { "id": 8, "userId": null, "roleId": 1, "configType": 2, "menuId": "10", "columnKey": "phone", "columnTitle": "手机号", "columnWidth": 150, "isVisible": 0, "isPrintable": 0, "sortOrder": 3, "createTime": 1752044875524 }, { "id": 7, "userId": null, "roleId": 1, "configType": 2, "menuId": "10", "columnKey": "email", "columnTitle": "邮箱地址", "columnWidth": 200, "isVisible": 1, "isPrintable": 0, "sortOrder": 2, "createTime": 1752044875522 }, { "id": 6, "userId": null, "roleId": 1, "configType": 2, "menuId": "10", "columnKey": "username", "columnTitle": "用户名", "columnWidth": 120, "isVisible": 1, "isPrintable": 1, "sortOrder": 1, "createTime": 1752044875518 }, { "id": 5, "userId": 1, "roleId": null, "configType": 1, "menuId": "10", "columnKey": "createTime", "columnTitle": "创建时间1", "columnWidth": 180, "isVisible": 1, "isPrintable": 1, "sortOrder": 5, "createTime": 1752044637224 }, { "id": 4, "userId": 1, "roleId": null, "configType": 1, "menuId": "10", "columnKey": "status", "columnTitle": "状态1", "columnWidth": 80, "isVisible": 1, "isPrintable": 1, "sortOrder": 4, "createTime": 1752044637223 }, { "id": 3, "userId": 1, "roleId": null, "configType": 1, "menuId": "10", "columnKey": "phone", "columnTitle": "手机号", "columnWidth": 150, "isVisible": 0, "isPrintable": 0, "sortOrder": 3, "createTime": 1752044637221 }, { "id": 2, "userId": 1, "roleId": null, "configType": 1, "menuId": "10", "columnKey": "email", "columnTitle": "邮箱地址", "columnWidth": 200, "isVisible": 1, "isPrintable": 0, "sortOrder": 2, "createTime": 1752044637219 }, { "id": 1, "userId": 1, "roleId": null, "configType": 1, "menuId": "10", "columnKey": "username", "columnTitle": "用户名", "columnWidth": 120, "isVisible": 1, "isPrintable": 1, "sortOrder": 1, "createTime": 1752044637213 } ], "total": 10 }, "msg": "" } } }, "headers": {} }, "400": { "description": "请求参数错误", "content": { "application/json": { "schema": { "type": "object", "properties": {} } } }, "headers": {} } }, "security": [] } }, "/admin-api/system/user-form-config/create": { "post": { "summary": "创建系统表格列配置", "deprecated": false, "description": "创建单个系统表格列配置记录", "operationId": "createUserFormConfig", "tags": [ "系统表格列配置" ], "parameters": [ { "name": "tag", "in": "header", "description": "默认全局带上tag参数，优先访问本地启动的服务", "example": "{{tag}}", "schema": { "type": "string", "default": "{{tag}}" } }, { "name": "Authorization", "in": "header", "description": "", "example": "{{authorization}}", "schema": { "type": "string", "default": "{{authorization}}" } }, { "name": "tenant-id", "in": "header", "description": "", "example": "{{tenant-id}}", "schema": { "type": "string", "default": "{{tenant-id}}" } } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": {} } } } }, "responses": { "200": { "description": "创建成功", "content": { "application/json": { "schema": { "type": "object", "properties": {} } } }, "headers": {} }, "400": { "description": "请求参数错误", "content": { "application/json": { "schema": { "type": "object", "properties": {} } } }, "headers": {} } }, "security": [] } }, "/admin-api/system/user-form-config/update": { "put": { "summary": "更新系统表格列配置", "deprecated": false, "description": "更新指定的系统表格列配置记录", "operationId": "updateUserFormConfig", "tags": [ "系统表格列配置" ], "parameters": [ { "name": "tag", "in": "header", "description": "默认全局带上tag参数，优先访问本地启动的服务", "example": "{{tag}}", "schema": { "type": "string", "default": "{{tag}}" } }, { "name": "Authorization", "in": "header", "description": "", "example": "{{authorization}}", "schema": { "type": "string", "default": "{{authorization}}" } }, { "name": "tenant-id", "in": "header", "description": "", "example": "{{tenant-id}}", "schema": { "type": "string", "default": "{{tenant-id}}" } } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": {} } } } }, "responses": { "200": { "description": "更新成功", "content": { "application/json": { "schema": { "type": "object", "properties": {} } } }, "headers": {} }, "400": { "description": "请求参数错误", "content": { "application/json": { "schema": { "type": "object", "properties": {} } } }, "headers": {} } }, "security": [] } }, "/admin-api/system/user-form-config/delete": { "delete": { "summary": "删除系统表格列配置", "deprecated": false, "description": "根据ID删除指定的系统表格列配置记录", "operationId": "deleteUserFormConfig", "tags": [ "系统表格列配置" ], "parameters": [ { "name": "id", "in": "query", "description": "配置记录ID", "required": true, "schema": { "type": "integer", "format": "int64" } }, { "name": "tag", "in": "header", "description": "默认全局带上tag参数，优先访问本地启动的服务", "example": "{{tag}}", "schema": { "type": "string", "default": "{{tag}}" } }, { "name": "Authorization", "in": "header", "description": "", "example": "{{authorization}}", "schema": { "type": "string", "default": "{{authorization}}" } }, { "name": "tenant-id", "in": "header", "description": "", "example": "{{tenant-id}}", "schema": { "type": "string", "default": "{{tenant-id}}" } } ], "responses": { "200": { "description": "删除成功", "content": { "application/json": { "schema": { "type": "object", "properties": {} } } }, "headers": {} }, "400": { "description": "请求参数错误", "content": { "application/json": { "schema": { "type": "object", "properties": {} } } }, "headers": {} } }, "security": [] } }, "/admin-api/system/user-form-config/delete-list": { "delete": { "summary": "批量删除系统表格列配置", "deprecated": false, "description": "根据ID列表批量删除系统表格列配置记录", "operationId": "deleteUserFormConfigList", "tags": [ "系统表格列配置" ], "parameters": [ { "name": "ids", "in": "query", "description": "配置记录ID列表，多个ID用逗号分隔", "required": true, "schema": { "type": "string" } }, { "name": "tag", "in": "header", "description": "默认全局带上tag参数，优先访问本地启动的服务", "example": "{{tag}}", "schema": { "type": "string", "default": "{{tag}}" } }, { "name": "Authorization", "in": "header", "description": "", "example": "{{authorization}}", "schema": { "type": "string", "default": "{{authorization}}" } }, { "name": "tenant-id", "in": "header", "description": "", "example": "{{tenant-id}}", "schema": { "type": "string", "default": "{{tenant-id}}" } } ], "responses": { "200": { "description": "批量删除成功", "content": { "application/json": { "schema": { "type": "object", "properties": {} } } }, "headers": {} }, "400": { "description": "请求参数错误", "content": { "application/json": { "schema": { "type": "object", "properties": {} } } }, "headers": {} } }, "security": [] } }, "/admin-api/system/user-form-config/get": { "get": { "summary": "获得系统表格列配置", "deprecated": false, "description": "根据ID获取指定的系统表格列配置详情", "operationId": "getUserFormConfig", "tags": [ "系统表格列配置" ], "parameters": [ { "name": "id", "in": "query", "description": "配置记录ID", "required": true, "schema": { "type": "integer", "format": "int64" } }, { "name": "tag", "in": "header", "description": "默认全局带上tag参数，优先访问本地启动的服务", "example": "{{tag}}", "schema": { "type": "string", "default": "{{tag}}" } }, { "name": "Authorization", "in": "header", "description": "", "example": "{{authorization}}", "schema": { "type": "string", "default": "{{authorization}}" } }, { "name": "tenant-id", "in": "header", "description": "", "example": "{{tenant-id}}", "schema": { "type": "string", "default": "{{tenant-id}}" } } ], "responses": { "200": { "description": "获取成功", "content": { "application/json": { "schema": { "allOf": [ { "type": "object", "properties": {} }, { "type": "object", "properties": { "data": { "type": "object", "properties": {} } } } ] } } }, "headers": {} }, "400": { "description": "请求参数错误", "content": { "application/json": { "schema": { "type": "object", "properties": {} } } }, "headers": {} } }, "security": [] } }, "/admin-api/system/user-form-config/export-excel": { "get": { "summary": "导出系统表格列配置Excel", "deprecated": false, "description": "导出系统表格列配置数据为Excel文件", "operationId": "exportUserFormConfigExcel", "tags": [ "系统表格列配置" ], "parameters": [ { "name": "userId", "in": "query", "description": "用户ID", "required": false, "schema": { "type": "integer", "format": "int64" } }, { "name": "roleId", "in": "query", "description": "角色ID", "required": false, "schema": { "type": "integer", "format": "int64" } }, { "name": "configType", "in": "query", "description": "配置类型：1-个人配置，2-角色配置", "required": false, "schema": { "type": "integer", "enum": [ 1, 2 ] } }, { "name": "menuId", "in": "query", "description": "表格标识", "required": false, "schema": { "type": "string" } }, { "name": "columnKey", "in": "query", "description": "列字段标识", "required": false, "schema": { "type": "string" } }, { "name": "tag", "in": "header", "description": "默认全局带上tag参数，优先访问本地启动的服务", "example": "{{tag}}", "schema": { "type": "string", "default": "{{tag}}" } }, { "name": "Authorization", "in": "header", "description": "", "example": "{{authorization}}", "schema": { "type": "string", "default": "{{authorization}}" } }, { "name": "tenant-id", "in": "header", "description": "", "example": "{{tenant-id}}", "schema": { "type": "string", "default": "{{tenant-id}}" } } ], "responses": { "200": { "description": "Excel文件导出成功", "content": { "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet": { "schema": { "type": "object", "properties": {} } } }, "headers": {} }, "400": { "description": "请求参数错误", "content": { "application/json": { "schema": { "type": "object", "properties": {} } } }, "headers": {} } }, "security": [] } } }, "components": { "schemas": {}, "securitySchemes": { "bearerAuth": { "type": "http", "scheme": "bearer", "bearerFormat": "JWT" } } }, "servers": [], "security": [] }