{ "swagger": "2.0", "info": { "description": "智能心率采集分析平台后端服务，基于 Gin 框架，提供心率采集、AI 分析、教案管理、设备管理等功能", "title": "智能心率采集分析平台 API", "contact": {}, "version": "1.0" }, "host": "localhost:8081", "basePath": "/api/v1", "paths": { "/admin/gateways": { "get": { "security": [ { "BearerAuth": [] } ], "description": "查询网关列表，支持关键词/售出状态/项目类型/区域筛选。超级管理员可查全部，操作员只能查所属区域", "produces": [ "application/json" ], "tags": [ "网关管理" ], "summary": "获取网关列表", "parameters": [ { "type": "string", "description": "关键词(名称/MAC模糊搜索)", "name": "keyword", "in": "query" }, { "type": "boolean", "description": "售出状态", "name": "isSold", "in": "query" }, { "type": "string", "description": "项目类型", "name": "projectType", "in": "query" }, { "type": "integer", "description": "区域ID", "name": "regionId", "in": "query" } ], "responses": { "200": { "description": "查询成功", "schema": { "$ref": "#/definitions/controllers.SwagAPIResponse" } } } }, "post": { "security": [ { "BearerAuth": [] } ], "description": "创建新的网关记录，自动同步到产品库存", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "网关管理" ], "summary": "创建网关", "parameters": [ { "description": "网关信息", "name": "gateway", "in": "body", "required": true, "schema": { "$ref": "#/definitions/controllers.gatewayPayload" } } ], "responses": { "201": { "description": "创建成功", "schema": { "$ref": "#/definitions/controllers.SwagAPIResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/controllers.SwagAPIResponse" } }, "409": { "description": "MAC地址已存在", "schema": { "$ref": "#/definitions/controllers.SwagAPIResponse" } } } } }, "/admin/gateways/{id}": { "put": { "security": [ { "BearerAuth": [] } ], "description": "更新指定网关的详细信息，自动同步到产品库存", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "网关管理" ], "summary": "更新网关信息", "parameters": [ { "type": "integer", "description": "网关ID", "name": "id", "in": "path", "required": true }, { "description": "更新信息", "name": "gateway", "in": "body", "required": true, "schema": { "$ref": "#/definitions/controllers.gatewayPayload" } } ], "responses": { "200": { "description": "更新成功", "schema": { "$ref": "#/definitions/controllers.SwagAPIResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/controllers.SwagAPIResponse" } }, "404": { "description": "网关不存在", "schema": { "$ref": "#/definitions/controllers.SwagAPIResponse" } } } }, "delete": { "security": [ { "BearerAuth": [] } ], "description": "删除指定网关（已售出的网关禁止删除），自动同步删除产品库存", "produces": [ "application/json" ], "tags": [ "网关管理" ], "summary": "删除网关", "parameters": [ { "type": "integer", "description": "网关ID", "name": "id", "in": "path", "required": true } ], "responses": { "200": { "description": "删除成功", "schema": { "$ref": "#/definitions/controllers.SwagAPIResponse" } }, "403": { "description": "已售出无法删除", "schema": { "$ref": "#/definitions/controllers.SwagAPIResponse" } }, "404": { "description": "网关不存在", "schema": { "$ref": "#/definitions/controllers.SwagAPIResponse" } } } } }, "/admin/kindergartens": { "get": { "security": [ { "BearerAuth": [] } ], "description": "查询幼儿园列表，支持按名称/地址模糊搜索", "produces": [ "application/json" ], "tags": [ "幼儿园管理" ], "summary": "获取幼儿园列表", "parameters": [ { "type": "string", "description": "关键词(名称/地址模糊搜索)", "name": "keyword", "in": "query" } ], "responses": { "200": { "description": "查询成功", "schema": { "$ref": "#/definitions/controllers.SwagAPIResponse" } } } }, "post": { "security": [ { "BearerAuth": [] } ], "description": "创建新的幼儿园记录", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "幼儿园管理" ], "summary": "创建幼儿园", "parameters": [ { "description": "幼儿园信息", "name": "kindergarten", "in": "body", "required": true, "schema": { "$ref": "#/definitions/controllers.kindergartenPayload" } } ], "responses": { "201": { "description": "创建成功", "schema": { "$ref": "#/definitions/controllers.SwagAPIResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/controllers.SwagAPIResponse" } } } } }, "/admin/kindergartens/{id}": { "put": { "security": [ { "BearerAuth": [] } ], "description": "更新指定幼儿园的名称、地址和区域", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "幼儿园管理" ], "summary": "更新幼儿园信息", "parameters": [ { "type": "integer", "description": "幼儿园ID", "name": "id", "in": "path", "required": true }, { "description": "更新信息", "name": "kindergarten", "in": "body", "required": true, "schema": { "$ref": "#/definitions/controllers.kindergartenPayload" } } ], "responses": { "200": { "description": "更新成功", "schema": { "$ref": "#/definitions/controllers.SwagAPIResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/controllers.SwagAPIResponse" } }, "404": { "description": "幼儿园不存在", "schema": { "$ref": "#/definitions/controllers.SwagAPIResponse" } } } }, "delete": { "security": [ { "BearerAuth": [] } ], "description": "删除指定幼儿园，如果被用户绑定则无法删除", "produces": [ "application/json" ], "tags": [ "幼儿园管理" ], "summary": "删除幼儿园", "parameters": [ { "type": "integer", "description": "幼儿园ID", "name": "id", "in": "path", "required": true } ], "responses": { "200": { "description": "删除成功", "schema": { "$ref": "#/definitions/controllers.SwagAPIResponse" } }, "404": { "description": "幼儿园不存在", "schema": { "$ref": "#/definitions/controllers.SwagAPIResponse" } }, "409": { "description": "已绑定用户无法删除", "schema": { "$ref": "#/definitions/controllers.SwagAPIResponse" } } } } }, "/admin/product-definitions": { "get": { "security": [ { "BearerAuth": [] } ], "description": "查询产品定义列表，支持按关键词/分类/启用状态筛选", "produces": [ "application/json" ], "tags": [ "产品定义管理" ], "summary": "获取产品定义列表", "parameters": [ { "type": "string", "description": "关键词(代码/名称/描述模糊搜索)", "name": "keyword", "in": "query" }, { "type": "string", "description": "分类筛选", "name": "category", "in": "query" }, { "type": "boolean", "description": "是否启用", "name": "isActive", "in": "query" } ], "responses": { "200": { "description": "查询成功", "schema": { "$ref": "#/definitions/controllers.SwagAPIResponse" } } } }, "post": { "security": [ { "BearerAuth": [] } ], "description": "创建新的产品定义", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "产品定义管理" ], "summary": "创建产品定义", "parameters": [ { "description": "产品定义信息", "name": "productDefinition", "in": "body", "required": true, "schema": { "$ref": "#/definitions/controllers.productDefinitionPayload" } } ], "responses": { "201": { "description": "创建成功", "schema": { "$ref": "#/definitions/controllers.SwagAPIResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/controllers.SwagAPIResponse" } } } } }, "/admin/product-definitions/{id}": { "put": { "security": [ { "BearerAuth": [] } ], "description": "更新指定产品定义的信息", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "产品定义管理" ], "summary": "更新产品定义", "parameters": [ { "type": "integer", "description": "产品定义ID", "name": "id", "in": "path", "required": true }, { "description": "更新信息", "name": "productDefinition", "in": "body", "required": true, "schema": { "$ref": "#/definitions/controllers.productDefinitionPayload" } } ], "responses": { "200": { "description": "更新成功", "schema": { "$ref": "#/definitions/controllers.SwagAPIResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/controllers.SwagAPIResponse" } }, "404": { "description": "产品定义不存在", "schema": { "$ref": "#/definitions/controllers.SwagAPIResponse" } } } }, "delete": { "security": [ { "BearerAuth": [] } ], "description": "删除指定产品定义（被库存或模板引用的无法删除）", "produces": [ "application/json" ], "tags": [ "产品定义管理" ], "summary": "删除产品定义", "parameters": [ { "type": "integer", "description": "产品定义ID", "name": "id", "in": "path", "required": true } ], "responses": { "200": { "description": "删除成功", "schema": { "$ref": "#/definitions/controllers.SwagAPIResponse" } }, "404": { "description": "产品定义不存在", "schema": { "$ref": "#/definitions/controllers.SwagAPIResponse" } }, "409": { "description": "已被引用无法删除", "schema": { "$ref": "#/definitions/controllers.SwagAPIResponse" } } } } }, "/admin/product-inventories": { "get": { "security": [ { "BearerAuth": [] } ], "description": "查询产品库存列表，支持多条件筛选", "produces": [ "application/json" ], "tags": [ "产品库存管理" ], "summary": "获取产品库存列表", "parameters": [ { "type": "string", "description": "关键词(资产名称/序列号/购买方等模糊搜索)", "name": "keyword", "in": "query" }, { "type": "string", "description": "产品代码筛选", "name": "productCode", "in": "query" }, { "type": "string", "description": "项目类型代码筛选", "name": "projectTypeCode", "in": "query" }, { "type": "string", "description": "套件代码筛选", "name": "suiteCode", "in": "query" }, { "type": "string", "description": "状态筛选", "name": "status", "in": "query" }, { "type": "string", "description": "购买方类型筛选", "name": "soldTargetType", "in": "query" }, { "type": "integer", "description": "区域ID", "name": "regionId", "in": "query" } ], "responses": { "200": { "description": "查询成功", "schema": { "$ref": "#/definitions/controllers.SwagAPIResponse" } } } }, "post": { "security": [ { "BearerAuth": [] } ], "description": "创建新的产品库存记录", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "产品库存管理" ], "summary": "创建产品库存记录", "parameters": [ { "description": "库存信息", "name": "inventory", "in": "body", "required": true, "schema": { "$ref": "#/definitions/controllers.productInventoryPayload" } } ], "responses": { "201": { "description": "创建成功", "schema": { "$ref": "#/definitions/controllers.SwagAPIResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/controllers.SwagAPIResponse" } } } } }, "/admin/product-inventories/{id}": { "put": { "security": [ { "BearerAuth": [] } ], "description": "更新指定产品库存记录", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "产品库存管理" ], "summary": "更新产品库存", "parameters": [ { "type": "integer", "description": "库存ID", "name": "id", "in": "path", "required": true }, { "description": "更新信息", "name": "inventory", "in": "body", "required": true, "schema": { "$ref": "#/definitions/controllers.productInventoryPayload" } } ], "responses": { "200": { "description": "更新成功", "schema": { "$ref": "#/definitions/controllers.SwagAPIResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/controllers.SwagAPIResponse" } }, "404": { "description": "库存记录不存在", "schema": { "$ref": "#/definitions/controllers.SwagAPIResponse" } } } }, "delete": { "security": [ { "BearerAuth": [] } ], "description": "删除指定产品库存记录（已售出的无法删除）", "produces": [ "application/json" ], "tags": [ "产品库存管理" ], "summary": "删除产品库存", "parameters": [ { "type": "integer", "description": "库存ID", "name": "id", "in": "path", "required": true } ], "responses": { "200": { "description": "删除成功", "schema": { "$ref": "#/definitions/controllers.SwagAPIResponse" } }, "404": { "description": "库存记录不存在", "schema": { "$ref": "#/definitions/controllers.SwagAPIResponse" } }, "409": { "description": "已售出无法删除", "schema": { "$ref": "#/definitions/controllers.SwagAPIResponse" } } } } }, "/admin/product-prototypes": { "get": { "security": [ { "BearerAuth": [] } ], "description": "查询产品原型列表，支持按关键词/产品代码/项目类型筛选", "produces": [ "application/json" ], "tags": [ "产品原型管理" ], "summary": "获取产品原型列表", "parameters": [ { "type": "string", "description": "关键词(名称/备注模糊搜索)", "name": "keyword", "in": "query" }, { "type": "string", "description": "产品代码筛选", "name": "productCode", "in": "query" }, { "type": "string", "description": "项目类型代码筛选", "name": "projectTypeCode", "in": "query" } ], "responses": { "200": { "description": "查询成功", "schema": { "$ref": "#/definitions/controllers.SwagAPIResponse" } } } }, "post": { "security": [ { "BearerAuth": [] } ], "description": "创建新的产品原型", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "产品原型管理" ], "summary": "创建产品原型", "parameters": [ { "description": "产品原型信息", "name": "productPrototype", "in": "body", "required": true, "schema": { "$ref": "#/definitions/controllers.productPrototypePayload" } } ], "responses": { "201": { "description": "创建成功", "schema": { "$ref": "#/definitions/controllers.SwagAPIResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/controllers.SwagAPIResponse" } } } } }, "/admin/product-prototypes/{id}": { "put": { "security": [ { "BearerAuth": [] } ], "description": "更新指定产品原型的信息", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "产品原型管理" ], "summary": "更新产品原型", "parameters": [ { "type": "integer", "description": "产品原型ID", "name": "id", "in": "path", "required": true }, { "description": "更新信息", "name": "productPrototype", "in": "body", "required": true, "schema": { "$ref": "#/definitions/controllers.productPrototypePayload" } } ], "responses": { "200": { "description": "更新成功", "schema": { "$ref": "#/definitions/controllers.SwagAPIResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/controllers.SwagAPIResponse" } }, "404": { "description": "产品原型不存在", "schema": { "$ref": "#/definitions/controllers.SwagAPIResponse" } } } }, "delete": { "security": [ { "BearerAuth": [] } ], "description": "删除指定产品原型", "produces": [ "application/json" ], "tags": [ "产品原型管理" ], "summary": "删除产品原型", "parameters": [ { "type": "integer", "description": "产品原型ID", "name": "id", "in": "path", "required": true } ], "responses": { "200": { "description": "删除成功", "schema": { "$ref": "#/definitions/controllers.SwagAPIResponse" } }, "404": { "description": "产品原型不存在", "schema": { "$ref": "#/definitions/controllers.SwagAPIResponse" } } } } }, "/admin/product-suites": { "get": { "security": [ { "BearerAuth": [] } ], "description": "查询产品套件列表，含套件下的库存明细", "produces": [ "application/json" ], "tags": [ "产品套件管理" ], "summary": "获取产品套件列表", "parameters": [ { "type": "string", "description": "关键词(代码/名称/备注模糊搜索)", "name": "keyword", "in": "query" }, { "type": "string", "description": "项目类型代码筛选", "name": "projectTypeCode", "in": "query" } ], "responses": { "200": { "description": "查询成功", "schema": { "$ref": "#/definitions/controllers.SwagAPIResponse" } } } }, "post": { "security": [ { "BearerAuth": [] } ], "description": "创建新的产品套件，可选关联库存记录", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "产品套件管理" ], "summary": "创建产品套件", "parameters": [ { "description": "套件信息", "name": "suite", "in": "body", "required": true, "schema": { "$ref": "#/definitions/controllers.productSuitePayload" } } ], "responses": { "201": { "description": "创建成功", "schema": { "$ref": "#/definitions/controllers.SwagAPIResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/controllers.SwagAPIResponse" } } } } }, "/admin/product-suites/{id}": { "put": { "security": [ { "BearerAuth": [] } ], "description": "更新指定产品套件的信息和关联库存", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "产品套件管理" ], "summary": "更新产品套件", "parameters": [ { "type": "integer", "description": "套件ID", "name": "id", "in": "path", "required": true }, { "description": "更新信息", "name": "suite", "in": "body", "required": true, "schema": { "$ref": "#/definitions/controllers.productSuitePayload" } } ], "responses": { "200": { "description": "更新成功", "schema": { "$ref": "#/definitions/controllers.SwagAPIResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/controllers.SwagAPIResponse" } }, "404": { "description": "套件不存在", "schema": { "$ref": "#/definitions/controllers.SwagAPIResponse" } } } }, "delete": { "security": [ { "BearerAuth": [] } ], "description": "删除指定产品套件，自动解除关联库存的绑定", "produces": [ "application/json" ], "tags": [ "产品套件管理" ], "summary": "删除产品套件", "parameters": [ { "type": "integer", "description": "套件ID", "name": "id", "in": "path", "required": true } ], "responses": { "200": { "description": "删除成功", "schema": { "$ref": "#/definitions/controllers.SwagAPIResponse" } }, "404": { "description": "套件不存在", "schema": { "$ref": "#/definitions/controllers.SwagAPIResponse" } } } } }, "/admin/project-product-templates": { "get": { "security": [ { "BearerAuth": [] } ], "description": "查询项目产品模板列表，含项目类型和产品名称", "produces": [ "application/json" ], "tags": [ "项目产品模板管理" ], "summary": "获取项目产品模板列表", "parameters": [ { "type": "string", "description": "项目类型代码筛选", "name": "projectTypeCode", "in": "query" } ], "responses": { "200": { "description": "查询成功", "schema": { "$ref": "#/definitions/controllers.SwagAPIResponse" } } } } }, "/admin/project-types": { "get": { "security": [ { "BearerAuth": [] } ], "description": "查询项目类型列表，支持按关键词/是否支持网关/是否启用筛选", "produces": [ "application/json" ], "tags": [ "项目类型管理" ], "summary": "获取项目类型列表", "parameters": [ { "type": "string", "description": "关键词(代码/名称/描述模糊搜索)", "name": "keyword", "in": "query" }, { "type": "boolean", "description": "是否支持网关", "name": "supportsGateway", "in": "query" }, { "type": "boolean", "description": "是否启用", "name": "isActive", "in": "query" } ], "responses": { "200": { "description": "查询成功", "schema": { "$ref": "#/definitions/controllers.SwagAPIResponse" } } } }, "post": { "security": [ { "BearerAuth": [] } ], "description": "创建新的项目类型", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "项目类型管理" ], "summary": "创建项目类型", "parameters": [ { "description": "项目类型信息", "name": "projectType", "in": "body", "required": true, "schema": { "$ref": "#/definitions/controllers.projectTypePayload" } } ], "responses": { "201": { "description": "创建成功", "schema": { "$ref": "#/definitions/controllers.SwagAPIResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/controllers.SwagAPIResponse" } } } } }, "/admin/project-types/{id}": { "put": { "security": [ { "BearerAuth": [] } ], "description": "更新指定项目类型的信息", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "项目类型管理" ], "summary": "更新项目类型", "parameters": [ { "type": "integer", "description": "项目类型ID", "name": "id", "in": "path", "required": true }, { "description": "更新信息", "name": "projectType", "in": "body", "required": true, "schema": { "$ref": "#/definitions/controllers.projectTypePayload" } } ], "responses": { "200": { "description": "更新成功", "schema": { "$ref": "#/definitions/controllers.SwagAPIResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/controllers.SwagAPIResponse" } }, "404": { "description": "项目类型不存在", "schema": { "$ref": "#/definitions/controllers.SwagAPIResponse" } } } }, "delete": { "security": [ { "BearerAuth": [] } ], "description": "删除指定项目类型（被网关引用的无法删除）", "produces": [ "application/json" ], "tags": [ "项目类型管理" ], "summary": "删除项目类型", "parameters": [ { "type": "integer", "description": "项目类型ID", "name": "id", "in": "path", "required": true } ], "responses": { "200": { "description": "删除成功", "schema": { "$ref": "#/definitions/controllers.SwagAPIResponse" } }, "404": { "description": "项目类型不存在", "schema": { "$ref": "#/definitions/controllers.SwagAPIResponse" } }, "409": { "description": "已被网关引用无法删除", "schema": { "$ref": "#/definitions/controllers.SwagAPIResponse" } } } } }, "/admin/statistics/ai-analysis": { "get": { "security": [ { "BearerAuth": [] } ], "description": "按区域统计AI分析的使用情况，包括调用次数、Token消耗、费用等", "produces": [ "application/json" ], "tags": [ "统计管理" ], "summary": "AI分析区域统计", "parameters": [ { "type": "integer", "description": "区域ID", "name": "regionId", "in": "query" }, { "type": "integer", "description": "开始时间(毫秒时间戳)", "name": "startTime", "in": "query" }, { "type": "integer", "description": "结束时间(毫秒时间戳)", "name": "endTime", "in": "query" } ], "responses": { "200": { "description": "查询成功", "schema": { "$ref": "#/definitions/controllers.SwagAPIResponse" } } } } }, "/admin/statistics/ai-analysis-records": { "get": { "security": [ { "BearerAuth": [] } ], "description": "分页查询AI分析记录，支持按区域和时间范围筛选", "produces": [ "application/json" ], "tags": [ "统计管理" ], "summary": "获取AI分析记录列表", "parameters": [ { "type": "integer", "description": "页码(默认1)", "name": "pageNum", "in": "query" }, { "type": "integer", "description": "每页数量(默认10,最大100)", "name": "pageSize", "in": "query" }, { "type": "integer", "description": "区域ID", "name": "regionId", "in": "query" }, { "type": "integer", "description": "开始时间(毫秒时间戳)", "name": "startTime", "in": "query" }, { "type": "integer", "description": "结束时间(毫秒时间戳)", "name": "endTime", "in": "query" } ], "responses": { "200": { "description": "查询成功", "schema": { "$ref": "#/definitions/controllers.SwagAPIResponse" } } } } }, "/admin/statistics/ai-analysis-records/{id}": { "delete": { "security": [ { "BearerAuth": [] } ], "description": "删除指定的AI分析记录", "produces": [ "application/json" ], "tags": [ "统计管理" ], "summary": "删除AI分析记录", "parameters": [ { "type": "integer", "description": "记录ID", "name": "id", "in": "path", "required": true } ], "responses": { "200": { "description": "删除成功", "schema": { "$ref": "#/definitions/controllers.SwagAPIResponse" } }, "404": { "description": "记录不存在", "schema": { "$ref": "#/definitions/controllers.SwagAPIResponse" } } } } }, "/admin/statistics/ai-analysis-timeline": { "get": { "security": [ { "BearerAuth": [] } ], "description": "按日期统计AI分析的使用情况趋势，含总体和分区域数据", "produces": [ "application/json" ], "tags": [ "统计管理" ], "summary": "AI分析时间线统计", "parameters": [ { "type": "integer", "description": "区域ID", "name": "regionId", "in": "query" }, { "type": "integer", "description": "开始时间(毫秒时间戳)", "name": "startTime", "in": "query" }, { "type": "integer", "description": "结束时间(毫秒时间戳)", "name": "endTime", "in": "query" } ], "responses": { "200": { "description": "查询成功", "schema": { "$ref": "#/definitions/controllers.SwagAPIResponse" } } } } }, "/admin/statistics/mqtt-training-sessions": { "get": { "security": [ { "BearerAuth": [] } ], "description": "按区域统计MQTT训练会话情况，包括开始、结束、完成、进行中的会话数", "produces": [ "application/json" ], "tags": [ "统计管理" ], "summary": "训练会话区域统计", "parameters": [ { "type": "integer", "description": "区域ID", "name": "regionId", "in": "query" }, { "type": "string", "description": "类型筛选", "name": "flavorType", "in": "query" }, { "type": "integer", "description": "开始时间(毫秒时间戳)", "name": "startTime", "in": "query" }, { "type": "integer", "description": "结束时间(毫秒时间戳)", "name": "endTime", "in": "query" } ], "responses": { "200": { "description": "查询成功", "schema": { "$ref": "#/definitions/controllers.SwagAPIResponse" } } } } }, "/admin/system-debug/mqtt/start": { "post": { "security": [ { "BearerAuth": [] } ], "description": "启动MQTT调试服务", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "系统调试" ], "summary": "启动MQTT调试", "parameters": [ { "description": "是否持久化到数据库", "name": "persist", "in": "body", "schema": { "$ref": "#/definitions/controllers.mqttDebugStartRequest" } } ], "responses": { "200": { "description": "启动成功", "schema": { "$ref": "#/definitions/controllers.SwagAPIResponse" } } } } }, "/admin/system-debug/mqtt/status": { "get": { "security": [ { "BearerAuth": [] } ], "description": "获取MQTT调试服务的当前运行状态", "produces": [ "application/json" ], "tags": [ "系统调试" ], "summary": "获取MQTT调试状态", "responses": { "200": { "description": "查询成功", "schema": { "$ref": "#/definitions/controllers.SwagAPIResponse" } } } } }, "/admin/system-debug/mqtt/stop": { "post": { "security": [ { "BearerAuth": [] } ], "description": "停止MQTT调试服务", "produces": [ "application/json" ], "tags": [ "系统调试" ], "summary": "停止MQTT调试", "responses": { "200": { "description": "停止成功", "schema": { "$ref": "#/definitions/controllers.SwagAPIResponse" } } } } }, "/admin/system-debug/mqtt/ws": { "get": { "description": "通过WebSocket实时监听MQTT消息（需要SuperAdmin权限）", "tags": [ "系统调试" ], "summary": "MQTT WebSocket连接", "parameters": [ { "type": "string", "description": "JWT Token", "name": "token", "in": "query", "required": true } ], "responses": { "101": { "description": "切换为WebSocket协议" } } } }, "/admin/users": { "get": { "security": [ { "BearerAuth": [] } ], "description": "查询系统用户列表，支持按关键词/角色/类型筛选", "produces": [ "application/json" ], "tags": [ "用户管理" ], "summary": "获取用户列表", "parameters": [ { "type": "string", "description": "关键词(用户名/邮箱/手机号模糊搜索)", "name": "keyword", "in": "query" }, { "type": "string", "description": "角色筛选", "name": "role", "in": "query" }, { "type": "string", "description": "类型筛选", "name": "flavorType", "in": "query" } ], "responses": { "200": { "description": "查询成功", "schema": { "$ref": "#/definitions/controllers.SwagAPIResponse" } } } }, "post": { "security": [ { "BearerAuth": [] } ], "description": "创建新的系统用户", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "用户管理" ], "summary": "创建用户", "parameters": [ { "description": "用户信息", "name": "user", "in": "body", "required": true, "schema": { "$ref": "#/definitions/controllers.userAdminPayload" } } ], "responses": { "201": { "description": "创建成功", "schema": { "$ref": "#/definitions/controllers.SwagAPIResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/controllers.SwagAPIResponse" } } } } }, "/admin/users/{id}": { "put": { "security": [ { "BearerAuth": [] } ], "description": "更新指定用户的详细信息，支持重置密码和吊销Token", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "用户管理" ], "summary": "更新用户信息", "parameters": [ { "type": "integer", "description": "用户ID", "name": "id", "in": "path", "required": true }, { "description": "更新信息", "name": "user", "in": "body", "required": true, "schema": { "$ref": "#/definitions/controllers.userAdminPayload" } } ], "responses": { "200": { "description": "更新成功", "schema": { "$ref": "#/definitions/controllers.SwagAPIResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/controllers.SwagAPIResponse" } }, "404": { "description": "用户不存在", "schema": { "$ref": "#/definitions/controllers.SwagAPIResponse" } } } }, "delete": { "security": [ { "BearerAuth": [] } ], "description": "删除指定用户（不能删除admin账号和当前登录用户）", "produces": [ "application/json" ], "tags": [ "用户管理" ], "summary": "删除用户", "parameters": [ { "type": "integer", "description": "用户ID", "name": "id", "in": "path", "required": true } ], "responses": { "200": { "description": "删除成功", "schema": { "$ref": "#/definitions/controllers.SwagAPIResponse" } }, "400": { "description": "无法删除受保护账号", "schema": { "$ref": "#/definitions/controllers.SwagAPIResponse" } }, "404": { "description": "用户不存在", "schema": { "$ref": "#/definitions/controllers.SwagAPIResponse" } } } } }, "/gateways/by-mac": { "get": { "security": [ { "BearerAuth": [] } ], "description": "根据MAC地址查询网关信息（支持格式兼容：带冒号/横线/纯数字）", "produces": [ "application/json" ], "tags": [ "网关管理" ], "summary": "按MAC查询网关", "parameters": [ { "type": "string", "description": "MAC地址", "name": "mac", "in": "query", "required": true } ], "responses": { "200": { "description": "查询成功", "schema": { "$ref": "#/definitions/controllers.SwagAPIResponse" } }, "400": { "description": "MAC参数为空", "schema": { "$ref": "#/definitions/controllers.SwagAPIResponse" } }, "404": { "description": "未找到该网关", "schema": { "$ref": "#/definitions/controllers.SwagAPIResponse" } } } } }, "/lesson-plans": { "get": { "security": [ { "BearerAuth": [] } ], "description": "获取教案文件列表（非分页），按创建时间倒序", "produces": [ "application/json" ], "tags": [ "教案管理" ], "summary": "获取教案列表", "responses": { "200": { "description": "查询成功", "schema": { "$ref": "#/definitions/controllers.SwagAPIResponse" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/controllers.SwagAPIResponse" } } } } }, "/lesson-plans/page": { "get": { "security": [ { "BearerAuth": [] } ], "description": "分页获取教案文件列表，支持文件名模糊搜索、上传者搜索、区域筛选、排序", "produces": [ "application/json" ], "tags": [ "教案管理" ], "summary": "分页查询教案", "parameters": [ { "type": "integer", "description": "页码(默认1)", "name": "pageNum", "in": "query" }, { "type": "integer", "description": "每页数量(默认10,最大100)", "name": "pageSize", "in": "query" }, { "type": "string", "description": "文件名模糊搜索", "name": "keyword", "in": "query" }, { "type": "string", "description": "上传者名模糊搜索", "name": "uploaderName", "in": "query" }, { "type": "integer", "description": "区域ID", "name": "regionId", "in": "query" }, { "type": "string", "description": "排序字段: file_size | created_at", "name": "sortBy", "in": "query" }, { "type": "string", "description": "排序方向: asc | desc", "name": "sortOrder", "in": "query" } ], "responses": { "200": { "description": "查询成功", "schema": { "$ref": "#/definitions/controllers.SwagAPIResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/controllers.SwagAPIResponse" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/controllers.SwagAPIResponse" } } } } }, "/lesson-plans/share/{code}/download": { "get": { "description": "通过6位分享码下载教案文件（无需认证）", "produces": [ "application/octet-stream" ], "tags": [ "教案管理" ], "summary": "通过分享码下载教案", "parameters": [ { "type": "string", "description": "6位分享码", "name": "code", "in": "path", "required": true } ], "responses": { "200": { "description": "教案文件", "schema": { "type": "file" } }, "400": { "description": "分享码无效", "schema": { "$ref": "#/definitions/controllers.SwagAPIResponse" } }, "404": { "description": "分享码过期或不存在", "schema": { "$ref": "#/definitions/controllers.SwagAPIResponse" } } } } }, "/lesson-plans/upload": { "post": { "security": [ { "BearerAuth": [] } ], "description": "上传 .docx 格式的教案文件，支持MD5去重，最大10MB", "consumes": [ "multipart/form-data" ], "produces": [ "application/json" ], "tags": [ "教案管理" ], "summary": "上传教案文件", "parameters": [ { "type": "file", "description": "教案文件(.docx)", "name": "file", "in": "formData", "required": true } ], "responses": { "201": { "description": "上传成功", "schema": { "$ref": "#/definitions/controllers.SwagAPIResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/controllers.SwagAPIResponse" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/controllers.SwagAPIResponse" } }, "409": { "description": "文件已存在", "schema": { "$ref": "#/definitions/controllers.SwagAPIResponse" } } } } }, "/lesson-plans/{id}": { "delete": { "security": [ { "BearerAuth": [] } ], "description": "删除教案文件及其关联的分享码", "produces": [ "application/json" ], "tags": [ "教案管理" ], "summary": "删除教案文件", "parameters": [ { "type": "integer", "description": "教案ID", "name": "id", "in": "path", "required": true } ], "responses": { "200": { "description": "删除成功", "schema": { "$ref": "#/definitions/controllers.SwagAPIResponse" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/controllers.SwagAPIResponse" } }, "403": { "description": "无权限", "schema": { "$ref": "#/definitions/controllers.SwagAPIResponse" } }, "404": { "description": "文件不存在", "schema": { "$ref": "#/definitions/controllers.SwagAPIResponse" } } } } }, "/lesson-plans/{id}/download": { "get": { "security": [ { "BearerAuth": [] } ], "description": "通过ID下载教案文件，自动更新下载计数和最后下载时间", "produces": [ "application/octet-stream" ], "tags": [ "教案管理" ], "summary": "下载教案文件", "parameters": [ { "type": "integer", "description": "教案ID", "name": "id", "in": "path", "required": true } ], "responses": { "200": { "description": "教案文件", "schema": { "type": "file" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/controllers.SwagAPIResponse" } }, "403": { "description": "无权限", "schema": { "$ref": "#/definitions/controllers.SwagAPIResponse" } }, "404": { "description": "文件不存在", "schema": { "$ref": "#/definitions/controllers.SwagAPIResponse" } } } } }, "/lesson-plans/{id}/share-code": { "post": { "security": [ { "BearerAuth": [] } ], "description": "为教案文件生成6位数字分享码，有效期5分钟，每次生成会失效之前的分享码", "produces": [ "application/json" ], "tags": [ "教案管理" ], "summary": "生成分享码", "parameters": [ { "type": "integer", "description": "教案ID", "name": "id", "in": "path", "required": true } ], "responses": { "200": { "description": "生成成功", "schema": { "$ref": "#/definitions/controllers.SwagAPIResponse" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/controllers.SwagAPIResponse" } }, "403": { "description": "无权限", "schema": { "$ref": "#/definitions/controllers.SwagAPIResponse" } }, "404": { "description": "文件不存在", "schema": { "$ref": "#/definitions/controllers.SwagAPIResponse" } } } } }, "/login": { "post": { "description": "用户名密码登录，返回JWT Token和用户信息", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "认证" ], "summary": "用户登录", "parameters": [ { "description": "登录信息", "name": "request", "in": "body", "required": true, "schema": { "$ref": "#/definitions/controllers.SwagLoginRequest" } } ], "responses": { "200": { "description": "登录成功", "schema": { "$ref": "#/definitions/controllers.SwagAPIResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/controllers.SwagAPIResponse" } }, "401": { "description": "用户名或密码错误", "schema": { "$ref": "#/definitions/controllers.SwagAPIResponse" } }, "403": { "description": "用户已禁用", "schema": { "$ref": "#/definitions/controllers.SwagAPIResponse" } } } } }, "/register": { "post": { "description": "注册新用户，返回JWT Token", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "认证" ], "summary": "用户注册", "parameters": [ { "description": "注册信息", "name": "request", "in": "body", "required": true, "schema": { "$ref": "#/definitions/controllers.SwagRegisterRequest" } } ], "responses": { "201": { "description": "注册成功", "schema": { "$ref": "#/definitions/controllers.SwagAPIResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/controllers.SwagAPIResponse" } }, "409": { "description": "用户名已存在", "schema": { "$ref": "#/definitions/controllers.SwagAPIResponse" } } } } }, "/step": { "post": { "security": [ { "BearerAuth": [] } ], "description": "接收并保存踏步训练记录，包含心率和步频数据，异步计算回归结果", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "踏步训练" ], "summary": "创建踏步训练记录", "parameters": [ { "description": "踏步训练记录", "name": "record", "in": "body", "required": true, "schema": { "$ref": "#/definitions/controllers.SwagAPIResponse" } } ], "responses": { "201": { "description": "保存成功", "schema": { "$ref": "#/definitions/controllers.SwagAPIResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/controllers.SwagAPIResponse" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/controllers.SwagAPIResponse" } } } } }, "/step/train-data/{trainId}": { "get": { "security": [ { "BearerAuth": [] } ], "description": "根据训练ID获取踏步训练的详细信息，包含心率和步频数据", "produces": [ "application/json" ], "tags": [ "踏步训练" ], "summary": "获取踏步训练详情", "parameters": [ { "type": "integer", "description": "训练ID", "name": "trainId", "in": "path", "required": true } ], "responses": { "200": { "description": "查询成功", "schema": { "$ref": "#/definitions/controllers.SwagAPIResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/controllers.SwagAPIResponse" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/controllers.SwagAPIResponse" } }, "404": { "description": "训练记录不存在", "schema": { "$ref": "#/definitions/controllers.SwagAPIResponse" } } } } }, "/step/train-rank/{trainId}": { "get": { "security": [ { "BearerAuth": [] } ], "description": "根据训练ID和回归类型获取训练排名", "produces": [ "application/json" ], "tags": [ "踏步训练" ], "summary": "获取训练排名", "parameters": [ { "type": "integer", "description": "训练ID", "name": "trainId", "in": "path", "required": true }, { "type": "integer", "description": "回归类型: 1=线性回归 | 3=二次回归", "name": "type", "in": "query", "required": true } ], "responses": { "200": { "description": "查询成功", "schema": { "$ref": "#/definitions/controllers.SwagAPIResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/controllers.SwagAPIResponse" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/controllers.SwagAPIResponse" } } } } }, "/step/train-records": { "get": { "security": [ { "BearerAuth": [] } ], "description": "分页获取当前用户的踏步训练记录，按开始时间倒序", "produces": [ "application/json" ], "tags": [ "踏步训练" ], "summary": "获取踏步训练记录列表", "parameters": [ { "type": "integer", "description": "页码(默认1)", "name": "pageNum", "in": "query" }, { "type": "integer", "description": "每页数量(默认10,最大100)", "name": "pageSize", "in": "query" } ], "responses": { "200": { "description": "查询成功", "schema": { "$ref": "#/definitions/controllers.SwagAPIResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/controllers.SwagAPIResponse" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/controllers.SwagAPIResponse" } } } } }, "/train-records": { "post": { "description": "接收并保存训练记录及心率数据，支持重复上传（按train_id去重更新）", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "训练管理" ], "summary": "创建训练记录", "parameters": [ { "description": "训练记录数据", "name": "record", "in": "body", "required": true, "schema": { "$ref": "#/definitions/controllers.SwagAPIResponse" } } ], "responses": { "201": { "description": "保存成功", "schema": { "$ref": "#/definitions/controllers.SwagAPIResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/controllers.SwagAPIResponse" } } } } }, "/train-records/analysis": { "get": { "description": "对历史心率数据进行统计分析和正态分布曲线拟合", "produces": [ "application/json" ], "tags": [ "训练管理" ], "summary": "心率曲线分析", "responses": { "200": { "description": "分析成功", "schema": { "$ref": "#/definitions/controllers.SwagAPIResponse" } }, "400": { "description": "数据量不足", "schema": { "$ref": "#/definitions/controllers.SwagAPIResponse" } } } } }, "/train-records/analysis-by-ai": { "post": { "description": "上传心率CSV和教案文件，通过AI生成课堂分析报告，支持流式和非流式输出", "consumes": [ "multipart/form-data" ], "produces": [ "application/json" ], "tags": [ "AI分析" ], "summary": "AI分析", "parameters": [ { "type": "file", "description": "心率数据CSV文件", "name": "heart_rate_data", "in": "formData", "required": true }, { "type": "file", "description": "步数数据CSV文件(analysis_type为heart_rate_with_steps时必填)", "name": "step_data", "in": "formData" }, { "type": "file", "description": "教案DOCX文件(teaching_plan_source为upload/wechat时必填)", "name": "teaching_plan", "in": "formData" }, { "type": "string", "description": "分析类型: heart_rate_only(默认) | heart_rate_with_steps", "name": "analysis_type", "in": "formData" }, { "type": "string", "description": "教案来源: upload(默认) | cloud | wechat", "name": "teaching_plan_source", "in": "formData" }, { "type": "string", "description": "区域ID", "name": "regionid", "in": "formData" }, { "type": "string", "description": "训练ID", "name": "trainid", "in": "formData" }, { "type": "string", "description": "云端教案ID(teaching_plan_source=cloud时必填)", "name": "lesson_plan_id", "in": "formData" }, { "type": "string", "description": "是否流式输出: true | false", "name": "stream", "in": "formData" } ], "responses": { "200": { "description": "分析成功", "schema": { "$ref": "#/definitions/controllers.SwagAPIResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/controllers.SwagAPIResponse" } } } } }, "/train-records/cloud-files": { "get": { "description": "获取所有云端教案文件列表", "produces": [ "application/json" ], "tags": [ "训练管理" ], "summary": "获取云端教案列表", "responses": { "200": { "description": "查询成功", "schema": { "$ref": "#/definitions/controllers.SwagAPIResponse" } } } } }, "/train-records/session": { "post": { "description": "上传训练开始/结束会话，用于MQTT训练会话追踪", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "训练管理" ], "summary": "上传训练会话", "parameters": [ { "description": "训练会话数据", "name": "session", "in": "body", "required": true, "schema": { "$ref": "#/definitions/controllers.trainingSessionRequest" } } ], "responses": { "200": { "description": "操作成功", "schema": { "$ref": "#/definitions/controllers.SwagAPIResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/controllers.SwagAPIResponse" } } } } } }, "definitions": { "controllers.SwagAPIResponse": { "type": "object", "properties": { "code": { "description": "HTTP状态码", "type": "integer" }, "data": { "description": "响应数据" }, "msg": { "description": "响应消息", "type": "string" } } }, "controllers.SwagLoginRequest": { "type": "object", "properties": { "password": { "description": "密码", "type": "string" }, "username": { "description": "用户名", "type": "string" } } }, "controllers.SwagRegisterRequest": { "type": "object", "properties": { "flavorType": { "description": "类型", "type": "string" }, "password": { "description": "密码", "type": "string" }, "regionIds": { "description": "区域ID列表", "type": "array", "items": { "type": "integer" } }, "role": { "description": "角色", "type": "string" }, "username": { "description": "用户名", "type": "string" } } }, "controllers.gatewayPayload": { "type": "object", "properties": { "isSold": { "type": "boolean" }, "location": { "type": "string" }, "mac": { "type": "string" }, "name": { "type": "string" }, "projectType": { "type": "string" }, "regionId": { "type": "integer" }, "soldAt": { "description": "SoldAt 是可选字段。如果 IsSold 为 true 且未传此字段，后端自动设为当前时间", "type": "string" } } }, "controllers.kindergartenPayload": { "type": "object", "properties": { "address": { "type": "string" }, "name": { "type": "string" }, "regionId": { "type": "integer" } } }, "controllers.mqttDebugStartRequest": { "type": "object", "properties": { "persistToDatabase": { "type": "boolean" } } }, "controllers.productDefinitionPayload": { "type": "object", "properties": { "category": { "type": "string" }, "code": { "type": "string" }, "description": { "type": "string" }, "isActive": { "type": "boolean" }, "name": { "type": "string" }, "parameterSchema": { "type": "string" }, "sort": { "type": "integer" }, "trackSerialNumber": { "type": "boolean" } } }, "controllers.productInventoryPayload": { "type": "object", "properties": { "assetName": { "type": "string" }, "notes": { "type": "string" }, "parameterValues": { "type": "string" }, "productCode": { "type": "string" }, "projectTypeCode": { "type": "string" }, "regionId": { "type": "integer" }, "serialNumber": { "type": "string" }, "soldAt": { "type": "string" }, "soldTargetName": { "type": "string" }, "soldTargetType": { "type": "string" }, "soldTo": { "type": "string" }, "status": { "type": "string" }, "storageLocation": { "type": "string" }, "suiteCode": { "type": "string" }, "suiteId": { "type": "integer" } } }, "controllers.productPrototypePayload": { "type": "object", "properties": { "assetName": { "type": "string" }, "name": { "type": "string" }, "notes": { "type": "string" }, "parameterValues": { "type": "string" }, "productCode": { "type": "string" }, "projectTypeCode": { "type": "string" }, "regionId": { "type": "integer" }, "status": { "type": "string" }, "storageLocation": { "type": "string" } } }, "controllers.productSuitePayload": { "type": "object", "properties": { "code": { "type": "string" }, "inventoryIds": { "type": "array", "items": { "type": "integer" } }, "name": { "type": "string" }, "notes": { "type": "string" }, "projectTypeCode": { "type": "string" }, "regionId": { "type": "integer" }, "soldTargetName": { "type": "string" }, "soldTargetType": { "type": "string" } } }, "controllers.projectTypePayload": { "type": "object", "properties": { "code": { "type": "string" }, "description": { "type": "string" }, "isActive": { "type": "boolean" }, "name": { "type": "string" }, "sort": { "type": "integer" }, "supportsGateway": { "type": "boolean" } } }, "controllers.trainingSessionRequest": { "type": "object", "properties": { "age": { "type": "integer" }, "aiResult": { "type": "string" }, "appName": { "type": "string" }, "duration": { "type": "integer" }, "endTime": { "type": "integer" }, "evaluation": { "type": "string" }, "gender": { "type": "string" }, "isStart": { "type": "boolean" }, "maxHeartRate": { "type": "integer" }, "name": { "type": "string" }, "peopleNum": { "type": "integer" }, "regionId": { "type": "integer" }, "runType": { "type": "string" }, "testTime": { "type": "integer" }, "tid": { "type": "integer" }, "time": { "type": "integer" } } }, "controllers.userAdminPayload": { "type": "object", "properties": { "email": { "type": "string" }, "flavorType": { "$ref": "#/definitions/models.UserFlavorType" }, "isActive": { "type": "boolean" }, "password": { "type": "string" }, "phone": { "type": "string" }, "regionIds": { "type": "array", "items": { "type": "integer" } }, "revokeTokens": { "type": "boolean" }, "role": { "$ref": "#/definitions/models.UserRole" }, "username": { "type": "string" } } }, "models.UserFlavorType": { "type": "string", "enum": [ "all", "flink", "full", "light", "heartrate", "run50" ], "x-enum-varnames": [ "UserFlavorAll", "UserFlavorFlink", "UserFlavorFull", "UserFlavorLight", "UserFlavorHeartRate", "UserFlavorRun50" ] }, "models.UserRole": { "type": "string", "enum": [ "super_admin", "region_admin", "operator", "viewer" ], "x-enum-varnames": [ "UserRoleSuperAdmin", "UserRoleRegionAdmin", "UserRoleOperator", "UserRoleViewer" ] } }, "securityDefinitions": { "BearerAuth": { "type": "apiKey", "name": "Authorization", "in": "header" } } }