1195 lines
30 KiB
YAML
1195 lines
30 KiB
YAML
definitions:
|
||
controller.Response:
|
||
properties:
|
||
code:
|
||
allOf:
|
||
- $ref: '#/definitions/controller.ResponseCode'
|
||
description: 业务状态码
|
||
data:
|
||
description: 业务数据
|
||
message:
|
||
description: 提示信息
|
||
type: string
|
||
type: object
|
||
controller.ResponseCode:
|
||
enum:
|
||
- 2000
|
||
- 2001
|
||
- 4000
|
||
- 4001
|
||
- 4004
|
||
- 4009
|
||
- 5000
|
||
- 5003
|
||
type: integer
|
||
x-enum-comments:
|
||
CodeBadRequest: 请求参数错误
|
||
CodeConflict: 资源冲突
|
||
CodeCreated: 创建成功
|
||
CodeInternalError: 服务器内部错误
|
||
CodeNotFound: 资源未找到
|
||
CodeServiceUnavailable: 服务不可用
|
||
CodeSuccess: 操作成功
|
||
CodeUnauthorized: 未授权
|
||
x-enum-descriptions:
|
||
- 操作成功
|
||
- 创建成功
|
||
- 请求参数错误
|
||
- 未授权
|
||
- 资源未找到
|
||
- 资源冲突
|
||
- 服务器内部错误
|
||
- 服务不可用
|
||
x-enum-varnames:
|
||
- CodeSuccess
|
||
- CodeCreated
|
||
- CodeBadRequest
|
||
- CodeUnauthorized
|
||
- CodeNotFound
|
||
- CodeConflict
|
||
- CodeInternalError
|
||
- CodeServiceUnavailable
|
||
device.AreaControllerResponse:
|
||
properties:
|
||
created_at:
|
||
type: string
|
||
id:
|
||
type: integer
|
||
location:
|
||
type: string
|
||
name:
|
||
type: string
|
||
network_id:
|
||
type: string
|
||
properties:
|
||
additionalProperties: true
|
||
type: object
|
||
status:
|
||
type: string
|
||
updated_at:
|
||
type: string
|
||
type: object
|
||
device.CreateAreaControllerRequest:
|
||
properties:
|
||
location:
|
||
type: string
|
||
name:
|
||
type: string
|
||
network_id:
|
||
type: string
|
||
properties:
|
||
additionalProperties: true
|
||
type: object
|
||
required:
|
||
- name
|
||
- network_id
|
||
type: object
|
||
device.CreateDeviceRequest:
|
||
properties:
|
||
area_controller_id:
|
||
type: integer
|
||
device_template_id:
|
||
type: integer
|
||
location:
|
||
type: string
|
||
name:
|
||
type: string
|
||
properties:
|
||
additionalProperties: true
|
||
type: object
|
||
required:
|
||
- area_controller_id
|
||
- device_template_id
|
||
- name
|
||
type: object
|
||
device.CreateDeviceTemplateRequest:
|
||
properties:
|
||
category:
|
||
$ref: '#/definitions/models.DeviceCategory'
|
||
commands:
|
||
additionalProperties: true
|
||
type: object
|
||
description:
|
||
type: string
|
||
manufacturer:
|
||
type: string
|
||
name:
|
||
type: string
|
||
values:
|
||
items:
|
||
$ref: '#/definitions/models.ValueDescriptor'
|
||
type: array
|
||
required:
|
||
- category
|
||
- commands
|
||
- name
|
||
type: object
|
||
device.DeviceTemplateResponse:
|
||
properties:
|
||
category:
|
||
$ref: '#/definitions/models.DeviceCategory'
|
||
commands:
|
||
additionalProperties: true
|
||
type: object
|
||
created_at:
|
||
type: string
|
||
description:
|
||
type: string
|
||
id:
|
||
type: integer
|
||
manufacturer:
|
||
type: string
|
||
name:
|
||
type: string
|
||
updated_at:
|
||
type: string
|
||
values:
|
||
items:
|
||
$ref: '#/definitions/models.ValueDescriptor'
|
||
type: array
|
||
type: object
|
||
device.UpdateAreaControllerRequest:
|
||
properties:
|
||
location:
|
||
type: string
|
||
name:
|
||
type: string
|
||
network_id:
|
||
type: string
|
||
properties:
|
||
additionalProperties: true
|
||
type: object
|
||
required:
|
||
- name
|
||
- network_id
|
||
type: object
|
||
device.UpdateDeviceRequest:
|
||
properties:
|
||
area_controller_id:
|
||
type: integer
|
||
device_template_id:
|
||
type: integer
|
||
location:
|
||
type: string
|
||
name:
|
||
type: string
|
||
properties:
|
||
additionalProperties: true
|
||
type: object
|
||
required:
|
||
- area_controller_id
|
||
- device_template_id
|
||
- name
|
||
type: object
|
||
device.UpdateDeviceTemplateRequest:
|
||
properties:
|
||
category:
|
||
$ref: '#/definitions/models.DeviceCategory'
|
||
commands:
|
||
additionalProperties: true
|
||
type: object
|
||
description:
|
||
type: string
|
||
manufacturer:
|
||
type: string
|
||
name:
|
||
type: string
|
||
values:
|
||
items:
|
||
$ref: '#/definitions/models.ValueDescriptor'
|
||
type: array
|
||
required:
|
||
- category
|
||
- commands
|
||
- name
|
||
type: object
|
||
git_huangwc_com_pig_pig-farm-controller_internal_app_controller_device.DeviceResponse:
|
||
properties:
|
||
area_controller_id:
|
||
type: integer
|
||
area_controller_name:
|
||
type: string
|
||
created_at:
|
||
type: string
|
||
device_template_id:
|
||
type: integer
|
||
device_template_name:
|
||
type: string
|
||
id:
|
||
type: integer
|
||
location:
|
||
type: string
|
||
name:
|
||
type: string
|
||
properties:
|
||
additionalProperties: true
|
||
type: object
|
||
updated_at:
|
||
type: string
|
||
type: object
|
||
models.DeviceCategory:
|
||
enum:
|
||
- actuator
|
||
- sensor
|
||
type: string
|
||
x-enum-varnames:
|
||
- CategoryActuator
|
||
- CategorySensor
|
||
models.PlanContentType:
|
||
enum:
|
||
- sub_plans
|
||
- tasks
|
||
type: string
|
||
x-enum-comments:
|
||
PlanContentTypeSubPlans: 计划包含子计划
|
||
PlanContentTypeTasks: 计划包含任务
|
||
x-enum-descriptions:
|
||
- 计划包含子计划
|
||
- 计划包含任务
|
||
x-enum-varnames:
|
||
- PlanContentTypeSubPlans
|
||
- PlanContentTypeTasks
|
||
models.PlanExecutionType:
|
||
enum:
|
||
- automatic
|
||
- manual
|
||
type: string
|
||
x-enum-comments:
|
||
PlanExecutionTypeAutomatic: 自动执行 (包含定时和循环)
|
||
PlanExecutionTypeManual: 手动执行
|
||
x-enum-descriptions:
|
||
- 自动执行 (包含定时和循环)
|
||
- 手动执行
|
||
x-enum-varnames:
|
||
- PlanExecutionTypeAutomatic
|
||
- PlanExecutionTypeManual
|
||
models.PlanStatus:
|
||
enum:
|
||
- 0
|
||
- 1
|
||
- 2
|
||
- 3
|
||
format: int32
|
||
type: integer
|
||
x-enum-comments:
|
||
PlanStatusDisabled: 禁用计划
|
||
PlanStatusEnabled: 启用计划
|
||
PlanStatusFailed: 执行失败
|
||
PlanStatusStopeed: 执行完毕
|
||
x-enum-descriptions:
|
||
- 禁用计划
|
||
- 启用计划
|
||
- 执行完毕
|
||
- 执行失败
|
||
x-enum-varnames:
|
||
- PlanStatusDisabled
|
||
- PlanStatusEnabled
|
||
- PlanStatusStopeed
|
||
- PlanStatusFailed
|
||
models.SensorType:
|
||
enum:
|
||
- signal_metrics
|
||
- battery_level
|
||
- temperature
|
||
- humidity
|
||
- weight
|
||
type: string
|
||
x-enum-comments:
|
||
SensorTypeBatteryLevel: 电池电量
|
||
SensorTypeHumidity: 湿度
|
||
SensorTypeSignalMetrics: 信号强度
|
||
SensorTypeTemperature: 温度
|
||
SensorTypeWeight: 重量
|
||
x-enum-descriptions:
|
||
- 信号强度
|
||
- 电池电量
|
||
- 温度
|
||
- 湿度
|
||
- 重量
|
||
x-enum-varnames:
|
||
- SensorTypeSignalMetrics
|
||
- SensorTypeBatteryLevel
|
||
- SensorTypeTemperature
|
||
- SensorTypeHumidity
|
||
- SensorTypeWeight
|
||
models.TaskType:
|
||
enum:
|
||
- plan_analysis
|
||
- waiting
|
||
- release_feed_weight
|
||
type: string
|
||
x-enum-comments:
|
||
TaskPlanAnalysis: 解析Plan的Task列表并添加到待执行队列的特殊任务
|
||
TaskTypeReleaseFeedWeight: 下料口释放指定重量任务
|
||
TaskTypeWaiting: 等待任务
|
||
x-enum-descriptions:
|
||
- 解析Plan的Task列表并添加到待执行队列的特殊任务
|
||
- 等待任务
|
||
- 下料口释放指定重量任务
|
||
x-enum-varnames:
|
||
- TaskPlanAnalysis
|
||
- TaskTypeWaiting
|
||
- TaskTypeReleaseFeedWeight
|
||
models.ValueDescriptor:
|
||
properties:
|
||
multiplier:
|
||
description: 乘数，用于原始数据转换
|
||
type: number
|
||
offset:
|
||
description: 偏移量，用于原始数据转换
|
||
type: number
|
||
type:
|
||
$ref: '#/definitions/models.SensorType'
|
||
type: object
|
||
plan.CreatePlanRequest:
|
||
properties:
|
||
cron_expression:
|
||
example: 0 0 6 * * *
|
||
type: string
|
||
description:
|
||
example: 根据温度自动调节风扇和加热器
|
||
type: string
|
||
execute_num:
|
||
example: 10
|
||
type: integer
|
||
execution_type:
|
||
allOf:
|
||
- $ref: '#/definitions/models.PlanExecutionType'
|
||
example: automatic
|
||
name:
|
||
example: 猪舍温度控制计划
|
||
type: string
|
||
sub_plan_ids:
|
||
items:
|
||
type: integer
|
||
type: array
|
||
tasks:
|
||
items:
|
||
$ref: '#/definitions/plan.TaskRequest'
|
||
type: array
|
||
required:
|
||
- execution_type
|
||
- name
|
||
type: object
|
||
plan.ListPlansResponse:
|
||
properties:
|
||
plans:
|
||
items:
|
||
$ref: '#/definitions/plan.PlanResponse'
|
||
type: array
|
||
total:
|
||
example: 100
|
||
type: integer
|
||
type: object
|
||
plan.PlanResponse:
|
||
properties:
|
||
content_type:
|
||
allOf:
|
||
- $ref: '#/definitions/models.PlanContentType'
|
||
example: tasks
|
||
cron_expression:
|
||
example: 0 0 6 * * *
|
||
type: string
|
||
description:
|
||
example: 根据温度自动调节风扇和加热器
|
||
type: string
|
||
execute_count:
|
||
example: 0
|
||
type: integer
|
||
execute_num:
|
||
example: 10
|
||
type: integer
|
||
execution_type:
|
||
allOf:
|
||
- $ref: '#/definitions/models.PlanExecutionType'
|
||
example: automatic
|
||
id:
|
||
example: 1
|
||
type: integer
|
||
name:
|
||
example: 猪舍温度控制计划
|
||
type: string
|
||
status:
|
||
allOf:
|
||
- $ref: '#/definitions/models.PlanStatus'
|
||
example: 0
|
||
sub_plans:
|
||
items:
|
||
$ref: '#/definitions/plan.SubPlanResponse'
|
||
type: array
|
||
tasks:
|
||
items:
|
||
$ref: '#/definitions/plan.TaskResponse'
|
||
type: array
|
||
type: object
|
||
plan.SubPlanResponse:
|
||
properties:
|
||
child_plan:
|
||
$ref: '#/definitions/plan.PlanResponse'
|
||
child_plan_id:
|
||
example: 2
|
||
type: integer
|
||
execution_order:
|
||
example: 1
|
||
type: integer
|
||
id:
|
||
example: 1
|
||
type: integer
|
||
parent_plan_id:
|
||
example: 1
|
||
type: integer
|
||
type: object
|
||
plan.TaskRequest:
|
||
properties:
|
||
description:
|
||
example: 打开1号风扇
|
||
type: string
|
||
execution_order:
|
||
example: 1
|
||
type: integer
|
||
name:
|
||
example: 打开风扇
|
||
type: string
|
||
parameters:
|
||
additionalProperties: true
|
||
type: object
|
||
type:
|
||
allOf:
|
||
- $ref: '#/definitions/models.TaskType'
|
||
example: waiting
|
||
type: object
|
||
plan.TaskResponse:
|
||
properties:
|
||
description:
|
||
example: 打开1号风扇
|
||
type: string
|
||
execution_order:
|
||
example: 1
|
||
type: integer
|
||
id:
|
||
example: 1
|
||
type: integer
|
||
name:
|
||
example: 打开风扇
|
||
type: string
|
||
parameters:
|
||
additionalProperties: true
|
||
type: object
|
||
plan_id:
|
||
example: 1
|
||
type: integer
|
||
type:
|
||
allOf:
|
||
- $ref: '#/definitions/models.TaskType'
|
||
example: waiting
|
||
type: object
|
||
plan.UpdatePlanRequest:
|
||
properties:
|
||
cron_expression:
|
||
example: 0 0 6 * * *
|
||
type: string
|
||
description:
|
||
example: 更新后的描述
|
||
type: string
|
||
execute_num:
|
||
example: 10
|
||
type: integer
|
||
execution_type:
|
||
allOf:
|
||
- $ref: '#/definitions/models.PlanExecutionType'
|
||
example: automatic
|
||
name:
|
||
example: 猪舍温度控制计划V2
|
||
type: string
|
||
sub_plan_ids:
|
||
items:
|
||
type: integer
|
||
type: array
|
||
tasks:
|
||
items:
|
||
$ref: '#/definitions/plan.TaskRequest'
|
||
type: array
|
||
type: object
|
||
user.CreateUserRequest:
|
||
properties:
|
||
password:
|
||
example: password123
|
||
type: string
|
||
username:
|
||
example: newuser
|
||
type: string
|
||
required:
|
||
- password
|
||
- username
|
||
type: object
|
||
user.CreateUserResponse:
|
||
properties:
|
||
id:
|
||
example: 1
|
||
type: integer
|
||
username:
|
||
example: newuser
|
||
type: string
|
||
type: object
|
||
user.HistoryResponse:
|
||
properties:
|
||
action_type:
|
||
example: 更新设备
|
||
type: string
|
||
description:
|
||
example: 设备更新成功
|
||
type: string
|
||
target_resource: {}
|
||
time:
|
||
type: string
|
||
user_id:
|
||
example: 101
|
||
type: integer
|
||
username:
|
||
example: testuser
|
||
type: string
|
||
type: object
|
||
user.ListHistoryResponse:
|
||
properties:
|
||
history:
|
||
items:
|
||
$ref: '#/definitions/user.HistoryResponse'
|
||
type: array
|
||
total:
|
||
example: 100
|
||
type: integer
|
||
type: object
|
||
user.LoginRequest:
|
||
properties:
|
||
identifier:
|
||
description: Identifier 可以是用户名、邮箱、手机号、微信号或飞书账号
|
||
example: testuser
|
||
type: string
|
||
password:
|
||
example: password123
|
||
type: string
|
||
required:
|
||
- identifier
|
||
- password
|
||
type: object
|
||
user.LoginResponse:
|
||
properties:
|
||
id:
|
||
example: 1
|
||
type: integer
|
||
token:
|
||
example: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...
|
||
type: string
|
||
username:
|
||
example: testuser
|
||
type: string
|
||
type: object
|
||
info:
|
||
contact: {}
|
||
paths:
|
||
/api/v1/area-controllers:
|
||
get:
|
||
description: 获取系统中所有区域主控的列表
|
||
produces:
|
||
- application/json
|
||
responses:
|
||
"200":
|
||
description: OK
|
||
schema:
|
||
allOf:
|
||
- $ref: '#/definitions/controller.Response'
|
||
- properties:
|
||
data:
|
||
items:
|
||
$ref: '#/definitions/device.AreaControllerResponse'
|
||
type: array
|
||
type: object
|
||
summary: 获取所有区域主控列表
|
||
tags:
|
||
- 区域主控管理
|
||
post:
|
||
consumes:
|
||
- application/json
|
||
description: 根据提供的信息创建一个新区域主控
|
||
parameters:
|
||
- description: 区域主控信息
|
||
in: body
|
||
name: areaController
|
||
required: true
|
||
schema:
|
||
$ref: '#/definitions/device.CreateAreaControllerRequest'
|
||
produces:
|
||
- application/json
|
||
responses:
|
||
"200":
|
||
description: OK
|
||
schema:
|
||
allOf:
|
||
- $ref: '#/definitions/controller.Response'
|
||
- properties:
|
||
data:
|
||
$ref: '#/definitions/device.AreaControllerResponse'
|
||
type: object
|
||
summary: 创建新区域主控
|
||
tags:
|
||
- 区域主控管理
|
||
/api/v1/area-controllers/{id}:
|
||
delete:
|
||
description: 根据ID删除一个区域主控（软删除）
|
||
parameters:
|
||
- description: 区域主控ID
|
||
in: path
|
||
name: id
|
||
required: true
|
||
type: string
|
||
produces:
|
||
- application/json
|
||
responses:
|
||
"200":
|
||
description: OK
|
||
schema:
|
||
$ref: '#/definitions/controller.Response'
|
||
summary: 删除区域主控
|
||
tags:
|
||
- 区域主控管理
|
||
get:
|
||
description: 根据ID获取单个区域主控的详细信息
|
||
parameters:
|
||
- description: 区域主控ID
|
||
in: path
|
||
name: id
|
||
required: true
|
||
type: string
|
||
produces:
|
||
- application/json
|
||
responses:
|
||
"200":
|
||
description: OK
|
||
schema:
|
||
allOf:
|
||
- $ref: '#/definitions/controller.Response'
|
||
- properties:
|
||
data:
|
||
$ref: '#/definitions/device.AreaControllerResponse'
|
||
type: object
|
||
summary: 获取区域主控信息
|
||
tags:
|
||
- 区域主控管理
|
||
put:
|
||
consumes:
|
||
- application/json
|
||
description: 根据ID更新一个已存在的区域主控信息
|
||
parameters:
|
||
- description: 区域主控ID
|
||
in: path
|
||
name: id
|
||
required: true
|
||
type: string
|
||
- description: 要更新的区域主控信息
|
||
in: body
|
||
name: areaController
|
||
required: true
|
||
schema:
|
||
$ref: '#/definitions/device.UpdateAreaControllerRequest'
|
||
produces:
|
||
- application/json
|
||
responses:
|
||
"200":
|
||
description: OK
|
||
schema:
|
||
allOf:
|
||
- $ref: '#/definitions/controller.Response'
|
||
- properties:
|
||
data:
|
||
$ref: '#/definitions/device.AreaControllerResponse'
|
||
type: object
|
||
summary: 更新区域主控信息
|
||
tags:
|
||
- 区域主控管理
|
||
/api/v1/device-templates:
|
||
get:
|
||
description: 获取系统中所有设备模板的列表
|
||
produces:
|
||
- application/json
|
||
responses:
|
||
"200":
|
||
description: OK
|
||
schema:
|
||
allOf:
|
||
- $ref: '#/definitions/controller.Response'
|
||
- properties:
|
||
data:
|
||
items:
|
||
$ref: '#/definitions/device.DeviceTemplateResponse'
|
||
type: array
|
||
type: object
|
||
summary: 获取设备模板列表
|
||
tags:
|
||
- 设备模板管理
|
||
post:
|
||
consumes:
|
||
- application/json
|
||
description: 根据提供的信息创建一个新设备模板
|
||
parameters:
|
||
- description: 设备模板信息
|
||
in: body
|
||
name: deviceTemplate
|
||
required: true
|
||
schema:
|
||
$ref: '#/definitions/device.CreateDeviceTemplateRequest'
|
||
produces:
|
||
- application/json
|
||
responses:
|
||
"200":
|
||
description: OK
|
||
schema:
|
||
allOf:
|
||
- $ref: '#/definitions/controller.Response'
|
||
- properties:
|
||
data:
|
||
$ref: '#/definitions/device.DeviceTemplateResponse'
|
||
type: object
|
||
summary: 创建新设备模板
|
||
tags:
|
||
- 设备模板管理
|
||
/api/v1/device-templates/{id}:
|
||
delete:
|
||
description: 根据设备模板ID删除一个设备模板（软删除）
|
||
parameters:
|
||
- description: 设备模板ID
|
||
in: path
|
||
name: id
|
||
required: true
|
||
type: string
|
||
produces:
|
||
- application/json
|
||
responses:
|
||
"200":
|
||
description: OK
|
||
schema:
|
||
$ref: '#/definitions/controller.Response'
|
||
summary: 删除设备模板
|
||
tags:
|
||
- 设备模板管理
|
||
get:
|
||
description: 根据设备模板ID获取单个设备模板的详细信息
|
||
parameters:
|
||
- description: 设备模板ID
|
||
in: path
|
||
name: id
|
||
required: true
|
||
type: string
|
||
produces:
|
||
- application/json
|
||
responses:
|
||
"200":
|
||
description: OK
|
||
schema:
|
||
allOf:
|
||
- $ref: '#/definitions/controller.Response'
|
||
- properties:
|
||
data:
|
||
$ref: '#/definitions/device.DeviceTemplateResponse'
|
||
type: object
|
||
summary: 获取设备模板信息
|
||
tags:
|
||
- 设备模板管理
|
||
put:
|
||
consumes:
|
||
- application/json
|
||
description: 根据设备模板ID更新一个已存在的设备模板信息
|
||
parameters:
|
||
- description: 设备模板ID
|
||
in: path
|
||
name: id
|
||
required: true
|
||
type: string
|
||
- description: 要更新的设备模板信息
|
||
in: body
|
||
name: deviceTemplate
|
||
required: true
|
||
schema:
|
||
$ref: '#/definitions/device.UpdateDeviceTemplateRequest'
|
||
produces:
|
||
- application/json
|
||
responses:
|
||
"200":
|
||
description: OK
|
||
schema:
|
||
allOf:
|
||
- $ref: '#/definitions/controller.Response'
|
||
- properties:
|
||
data:
|
||
$ref: '#/definitions/device.DeviceTemplateResponse'
|
||
type: object
|
||
summary: 更新设备模板信息
|
||
tags:
|
||
- 设备模板管理
|
||
/api/v1/devices:
|
||
get:
|
||
description: 获取系统中所有设备的列表
|
||
produces:
|
||
- application/json
|
||
responses:
|
||
"200":
|
||
description: OK
|
||
schema:
|
||
allOf:
|
||
- $ref: '#/definitions/controller.Response'
|
||
- properties:
|
||
data:
|
||
items:
|
||
$ref: '#/definitions/git_huangwc_com_pig_pig-farm-controller_internal_app_controller_device.DeviceResponse'
|
||
type: array
|
||
type: object
|
||
summary: 获取设备列表
|
||
tags:
|
||
- 设备管理
|
||
post:
|
||
consumes:
|
||
- application/json
|
||
description: 根据提供的信息创建一个新设备
|
||
parameters:
|
||
- description: 设备信息
|
||
in: body
|
||
name: device
|
||
required: true
|
||
schema:
|
||
$ref: '#/definitions/device.CreateDeviceRequest'
|
||
produces:
|
||
- application/json
|
||
responses:
|
||
"200":
|
||
description: OK
|
||
schema:
|
||
allOf:
|
||
- $ref: '#/definitions/controller.Response'
|
||
- properties:
|
||
data:
|
||
$ref: '#/definitions/git_huangwc_com_pig_pig-farm-controller_internal_app_controller_device.DeviceResponse'
|
||
type: object
|
||
summary: 创建新设备
|
||
tags:
|
||
- 设备管理
|
||
/api/v1/devices/{id}:
|
||
delete:
|
||
description: 根据设备ID删除一个设备（软删除）
|
||
parameters:
|
||
- description: 设备ID
|
||
in: path
|
||
name: id
|
||
required: true
|
||
type: string
|
||
produces:
|
||
- application/json
|
||
responses:
|
||
"200":
|
||
description: OK
|
||
schema:
|
||
$ref: '#/definitions/controller.Response'
|
||
summary: 删除设备
|
||
tags:
|
||
- 设备管理
|
||
get:
|
||
description: 根据设备ID获取单个设备的详细信息
|
||
parameters:
|
||
- description: 设备ID
|
||
in: path
|
||
name: id
|
||
required: true
|
||
type: string
|
||
produces:
|
||
- application/json
|
||
responses:
|
||
"200":
|
||
description: OK
|
||
schema:
|
||
allOf:
|
||
- $ref: '#/definitions/controller.Response'
|
||
- properties:
|
||
data:
|
||
$ref: '#/definitions/git_huangwc_com_pig_pig-farm-controller_internal_app_controller_device.DeviceResponse'
|
||
type: object
|
||
summary: 获取设备信息
|
||
tags:
|
||
- 设备管理
|
||
put:
|
||
consumes:
|
||
- application/json
|
||
description: 根据设备ID更新一个已存在的设备信息
|
||
parameters:
|
||
- description: 设备ID
|
||
in: path
|
||
name: id
|
||
required: true
|
||
type: string
|
||
- description: 要更新的设备信息
|
||
in: body
|
||
name: device
|
||
required: true
|
||
schema:
|
||
$ref: '#/definitions/device.UpdateDeviceRequest'
|
||
produces:
|
||
- application/json
|
||
responses:
|
||
"200":
|
||
description: OK
|
||
schema:
|
||
allOf:
|
||
- $ref: '#/definitions/controller.Response'
|
||
- properties:
|
||
data:
|
||
$ref: '#/definitions/git_huangwc_com_pig_pig-farm-controller_internal_app_controller_device.DeviceResponse'
|
||
type: object
|
||
summary: 更新设备信息
|
||
tags:
|
||
- 设备管理
|
||
/api/v1/plans:
|
||
get:
|
||
description: 获取所有计划的列表
|
||
produces:
|
||
- application/json
|
||
responses:
|
||
"200":
|
||
description: 业务码为200代表成功获取列表
|
||
schema:
|
||
allOf:
|
||
- $ref: '#/definitions/controller.Response'
|
||
- properties:
|
||
data:
|
||
$ref: '#/definitions/plan.ListPlansResponse'
|
||
type: object
|
||
summary: 获取计划列表
|
||
tags:
|
||
- 计划管理
|
||
post:
|
||
consumes:
|
||
- application/json
|
||
description: 创建一个新的计划，包括其基本信息和所有关联的子计划/任务。
|
||
parameters:
|
||
- description: 计划信息
|
||
in: body
|
||
name: plan
|
||
required: true
|
||
schema:
|
||
$ref: '#/definitions/plan.CreatePlanRequest'
|
||
produces:
|
||
- application/json
|
||
responses:
|
||
"200":
|
||
description: 业务码为201代表创建成功
|
||
schema:
|
||
allOf:
|
||
- $ref: '#/definitions/controller.Response'
|
||
- properties:
|
||
data:
|
||
$ref: '#/definitions/plan.PlanResponse'
|
||
type: object
|
||
summary: 创建计划
|
||
tags:
|
||
- 计划管理
|
||
/api/v1/plans/{id}:
|
||
delete:
|
||
description: 根据计划ID删除计划。（软删除）
|
||
parameters:
|
||
- description: 计划ID
|
||
in: path
|
||
name: id
|
||
required: true
|
||
type: integer
|
||
produces:
|
||
- application/json
|
||
responses:
|
||
"200":
|
||
description: 业务码为200代表删除成功
|
||
schema:
|
||
$ref: '#/definitions/controller.Response'
|
||
summary: 删除计划
|
||
tags:
|
||
- 计划管理
|
||
get:
|
||
description: 根据计划ID获取单个计划的详细信息。
|
||
parameters:
|
||
- description: 计划ID
|
||
in: path
|
||
name: id
|
||
required: true
|
||
type: integer
|
||
produces:
|
||
- application/json
|
||
responses:
|
||
"200":
|
||
description: 业务码为200代表成功获取
|
||
schema:
|
||
allOf:
|
||
- $ref: '#/definitions/controller.Response'
|
||
- properties:
|
||
data:
|
||
$ref: '#/definitions/plan.PlanResponse'
|
||
type: object
|
||
summary: 获取计划详情
|
||
tags:
|
||
- 计划管理
|
||
put:
|
||
consumes:
|
||
- application/json
|
||
description: 根据计划ID更新计划的详细信息。
|
||
parameters:
|
||
- description: 计划ID
|
||
in: path
|
||
name: id
|
||
required: true
|
||
type: integer
|
||
- description: 更新后的计划信息
|
||
in: body
|
||
name: plan
|
||
required: true
|
||
schema:
|
||
$ref: '#/definitions/plan.UpdatePlanRequest'
|
||
produces:
|
||
- application/json
|
||
responses:
|
||
"200":
|
||
description: 业务码为200代表更新成功
|
||
schema:
|
||
allOf:
|
||
- $ref: '#/definitions/controller.Response'
|
||
- properties:
|
||
data:
|
||
$ref: '#/definitions/plan.PlanResponse'
|
||
type: object
|
||
summary: 更新计划
|
||
tags:
|
||
- 计划管理
|
||
/api/v1/plans/{id}/start:
|
||
post:
|
||
description: 根据计划ID启动一个计划的执行。
|
||
parameters:
|
||
- description: 计划ID
|
||
in: path
|
||
name: id
|
||
required: true
|
||
type: integer
|
||
produces:
|
||
- application/json
|
||
responses:
|
||
"200":
|
||
description: 业务码为200代表成功启动计划
|
||
schema:
|
||
$ref: '#/definitions/controller.Response'
|
||
summary: 启动计划
|
||
tags:
|
||
- 计划管理
|
||
/api/v1/plans/{id}/stop:
|
||
post:
|
||
description: 根据计划ID停止一个正在执行的计划。
|
||
parameters:
|
||
- description: 计划ID
|
||
in: path
|
||
name: id
|
||
required: true
|
||
type: integer
|
||
produces:
|
||
- application/json
|
||
responses:
|
||
"200":
|
||
description: 业务码为200代表成功停止计划
|
||
schema:
|
||
$ref: '#/definitions/controller.Response'
|
||
summary: 停止计划
|
||
tags:
|
||
- 计划管理
|
||
/api/v1/users:
|
||
post:
|
||
consumes:
|
||
- application/json
|
||
description: 根据用户名和密码创建一个新的系统用户。
|
||
parameters:
|
||
- description: 用户信息
|
||
in: body
|
||
name: user
|
||
required: true
|
||
schema:
|
||
$ref: '#/definitions/user.CreateUserRequest'
|
||
produces:
|
||
- application/json
|
||
responses:
|
||
"200":
|
||
description: 业务码为201代表创建成功
|
||
schema:
|
||
allOf:
|
||
- $ref: '#/definitions/controller.Response'
|
||
- properties:
|
||
data:
|
||
$ref: '#/definitions/user.CreateUserResponse'
|
||
type: object
|
||
summary: 创建新用户
|
||
tags:
|
||
- 用户管理
|
||
/api/v1/users/{id}/history:
|
||
get:
|
||
description: 根据用户ID，分页获取该用户的操作审计日志。
|
||
parameters:
|
||
- description: 用户ID
|
||
in: path
|
||
name: id
|
||
required: true
|
||
type: integer
|
||
- default: 1
|
||
description: 页码
|
||
in: query
|
||
name: page
|
||
type: integer
|
||
- default: 10
|
||
description: 每页大小
|
||
in: query
|
||
name: page_size
|
||
type: integer
|
||
- description: 按操作类型过滤
|
||
in: query
|
||
name: action_type
|
||
type: string
|
||
produces:
|
||
- application/json
|
||
responses:
|
||
"200":
|
||
description: 业务码为200代表成功获取
|
||
schema:
|
||
allOf:
|
||
- $ref: '#/definitions/controller.Response'
|
||
- properties:
|
||
data:
|
||
$ref: '#/definitions/user.ListHistoryResponse'
|
||
type: object
|
||
summary: 获取指定用户的操作历史
|
||
tags:
|
||
- 用户管理
|
||
/api/v1/users/login:
|
||
post:
|
||
consumes:
|
||
- application/json
|
||
description: 用户可以使用用户名、邮箱、手机号、微信号或飞书账号进行登录，成功后返回 JWT 令牌。
|
||
parameters:
|
||
- description: 登录凭证
|
||
in: body
|
||
name: credentials
|
||
required: true
|
||
schema:
|
||
$ref: '#/definitions/user.LoginRequest'
|
||
produces:
|
||
- application/json
|
||
responses:
|
||
"200":
|
||
description: 业务码为200代表登录成功
|
||
schema:
|
||
allOf:
|
||
- $ref: '#/definitions/controller.Response'
|
||
- properties:
|
||
data:
|
||
$ref: '#/definitions/user.LoginResponse'
|
||
type: object
|
||
summary: 用户登录
|
||
tags:
|
||
- 用户管理
|
||
swagger: "2.0"
|