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