/**
 * 智能预警模块 Swagger 文档
 * @file swagger-smart-alerts.js
 * @description 定义智能预警相关的API文档
 */

/**
 * @swagger
 * tags:
 *   - name: 智能预警
 *     description: 智能预警系统管理
 *   - name: 智能耳标预警
 *     description: 智能耳标预警管理
 *   - name: 智能项圈预警
 *     description: 智能项圈预警管理
 */

/**
 * @swagger
 * components:
 *   schemas:
 *     AlertStats:
 *       type: object
 *       properties:
 *         totalAlerts:
 *           type: integer
 *           description: 总预警数量
 *           example: 25
 *         eartagAlerts:
 *           type: integer
 *           description: 耳标预警数量
 *           example: 15
 *         collarAlerts:
 *           type: integer
 *           description: 项圈预警数量
 *           example: 10
 *         eartagDevices:
 *           type: integer
 *           description: 耳标设备总数
 *           example: 100
 *         collarDevices:
 *           type: integer
 *           description: 项圈设备总数
 *           example: 80
 *         alertsByType:
 *           type: object
 *           properties:
 *             battery:
 *               type: integer
 *               description: 电量预警数量
 *               example: 5
 *             offline:
 *               type: integer
 *               description: 离线预警数量
 *               example: 8
 *             temperature:
 *               type: integer
 *               description: 温度预警数量
 *               example: 3
 *             movement:
 *               type: integer
 *               description: 运动预警数量
 *               example: 6
 *             wear:
 *               type: integer
 *               description: 佩戴预警数量
 *               example: 3
 *         alertsByLevel:
 *           type: object
 *           properties:
 *             high:
 *               type: integer
 *               description: 高级预警数量
 *               example: 8
 *             medium:
 *               type: integer
 *               description: 中级预警数量
 *               example: 12
 *             low:
 *               type: integer
 *               description: 低级预警数量
 *               example: 5
 *
 *     EartagAlert:
 *       type: object
 *       properties:
 *         id:
 *           type: string
 *           description: 预警ID
 *           example: "alert_001"
 *         deviceId:
 *           type: string
 *           description: 设备ID
 *           example: "eartag_001"
 *         deviceName:
 *           type: string
 *           description: 设备名称
 *           example: "耳标设备001"
 *         animalId:
 *           type: string
 *           description: 动物ID
 *           example: "animal_001"
 *         animalName:
 *           type: string
 *           description: 动物名称
 *           example: "牛001"
 *         farmId:
 *           type: string
 *           description: 养殖场ID
 *           example: "farm_001"
 *         farmName:
 *           type: string
 *           description: 养殖场名称
 *           example: "示例养殖场"
 *         alertType:
 *           type: string
 *           enum: [battery, offline, temperature, movement, wear]
 *           description: 预警类型
 *           example: "battery"
 *         alertLevel:
 *           type: string
 *           enum: [high, medium, low]
 *           description: 预警级别
 *           example: "high"
 *         alertMessage:
 *           type: string
 *           description: 预警消息
 *           example: "设备电量低于10%"
 *         alertValue:
 *           type: number
 *           description: 预警值
 *           example: 8.5
 *         threshold:
 *           type: number
 *           description: 阈值
 *           example: 10
 *         status:
 *           type: string
 *           enum: [pending, processing, resolved, ignored]
 *           description: 处理状态
 *           example: "pending"
 *         isHandled:
 *           type: boolean
 *           description: 是否已处理
 *           example: false
 *         handledBy:
 *           type: string
 *           description: 处理人
 *           example: "admin"
 *         handledAt:
 *           type: string
 *           format: date-time
 *           description: 处理时间
 *           example: "2024-01-15T10:30:00Z"
 *         handledNote:
 *           type: string
 *           description: 处理备注
 *           example: "已更换电池"
 *         createdAt:
 *           type: string
 *           format: date-time
 *           description: 创建时间
 *           example: "2024-01-15T08:30:00Z"
 *         updatedAt:
 *           type: string
 *           format: date-time
 *           description: 更新时间
 *           example: "2024-01-15T10:30:00Z"
 *
 *     CollarAlert:
 *       type: object
 *       properties:
 *         id:
 *           type: string
 *           description: 预警ID
 *           example: "alert_002"
 *         deviceId:
 *           type: string
 *           description: 设备ID
 *           example: "collar_001"
 *         deviceName:
 *           type: string
 *           description: 设备名称
 *           example: "项圈设备001"
 *         animalId:
 *           type: string
 *           description: 动物ID
 *           example: "animal_002"
 *         animalName:
 *           type: string
 *           description: 动物名称
 *           example: "牛002"
 *         farmId:
 *           type: string
 *           description: 养殖场ID
 *           example: "farm_001"
 *         farmName:
 *           type: string
 *           description: 养殖场名称
 *           example: "示例养殖场"
 *         alertType:
 *           type: string
 *           enum: [battery, offline, temperature, movement, wear, location]
 *           description: 预警类型
 *           example: "offline"
 *         alertLevel:
 *           type: string
 *           enum: [high, medium, low]
 *           description: 预警级别
 *           example: "medium"
 *         alertMessage:
 *           type: string
 *           description: 预警消息
 *           example: "设备离线超过2小时"
 *         alertValue:
 *           type: number
 *           description: 预警值
 *           example: 120
 *         threshold:
 *           type: number
 *           description: 阈值
 *           example: 60
 *         status:
 *           type: string
 *           enum: [pending, processing, resolved, ignored]
 *           description: 处理状态
 *           example: "pending"
 *         isHandled:
 *           type: boolean
 *           description: 是否已处理
 *           example: false
 *         handledBy:
 *           type: string
 *           description: 处理人
 *           example: "admin"
 *         handledAt:
 *           type: string
 *           format: date-time
 *           description: 处理时间
 *           example: "2024-01-15T12:30:00Z"
 *         handledNote:
 *           type: string
 *           description: 处理备注
 *           example: "设备已重新上线"
 *         createdAt:
 *           type: string
 *           format: date-time
 *           description: 创建时间
 *           example: "2024-01-15T10:30:00Z"
 *         updatedAt:
 *           type: string
 *           format: date-time
 *           description: 更新时间
 *           example: "2024-01-15T12:30:00Z"
 *
 *     AlertHandleRequest:
 *       type: object
 *       required:
 *         - action
 *       properties:
 *         action:
 *           type: string
 *           enum: [resolve, ignore, process]
 *           description: 处理动作
 *           example: "resolve"
 *         note:
 *           type: string
 *           description: 处理备注
 *           example: "问题已解决"
 *         handledBy:
 *           type: string
 *           description: 处理人
 *           example: "admin"
 *
 *     BatchHandleRequest:
 *       type: object
 *       required:
 *         - alertIds
 *         - action
 *       properties:
 *         alertIds:
 *           type: array
 *           items:
 *             type: string
 *           description: 预警ID列表
 *           example: ["alert_001", "alert_002", "alert_003"]
 *         action:
 *           type: string
 *           enum: [resolve, ignore, process]
 *           description: 处理动作
 *           example: "resolve"
 *         note:
 *           type: string
 *           description: 处理备注
 *           example: "批量处理预警"
 *         handledBy:
 *           type: string
 *           description: 处理人
 *           example: "admin"
 */

/**
 * @swagger
 * /smart-alerts/public/stats:
 *   get:
 *     tags:
 *       - 智能预警
 *     summary: 获取智能预警统计
 *     description: 获取智能预警的统计数据，包括各类预警的数量和设备总数
 *     responses:
 *       200:
 *         description: 获取统计成功
 *         content:
 *           application/json:
 *             schema:
 *               allOf:
 *                 - $ref: '#/components/schemas/ApiResponse'
 *                 - type: object
 *                   properties:
 *                     data:
 *                       $ref: '#/components/schemas/AlertStats'
 *       500:
 *         description: 服务器内部错误
 *         content:
 *           application/json:
 *             schema:
 *               $ref: '#/components/schemas/ErrorResponse'
 */

/**
 * @swagger
 * /smart-alerts/public/eartag/stats:
 *   get:
 *     tags:
 *       - 智能耳标预警
 *     summary: 获取智能耳标预警统计
 *     description: 获取智能耳标预警的统计数据，包括各类预警的数量和设备总数
 *     responses:
 *       200:
 *         description: 获取统计成功
 *         content:
 *           application/json:
 *             schema:
 *               allOf:
 *                 - $ref: '#/components/schemas/ApiResponse'
 *                 - type: object
 *                   properties:
 *                     data:
 *                       $ref: '#/components/schemas/AlertStats'
 *       500:
 *         description: 服务器内部错误
 *         content:
 *           application/json:
 *             schema:
 *               $ref: '#/components/schemas/ErrorResponse'
 */

/**
 * @swagger
 * /smart-alerts/public/eartag:
 *   get:
 *     tags:
 *       - 智能耳标预警
 *     summary: 获取智能耳标预警列表
 *     description: 获取智能耳标预警列表，支持分页、搜索和筛选
 *     parameters:
 *       - $ref: '#/components/parameters/PaginationQuery/properties/page'
 *       - $ref: '#/components/parameters/PaginationQuery/properties/limit'
 *       - in: query
 *         name: search
 *         schema:
 *           type: string
 *         description: 搜索关键词（设备名称、动物名称、养殖场名称）
 *       - in: query
 *         name: alertType
 *         schema:
 *           type: string
 *           enum: [battery, offline, temperature, movement, wear]
 *         description: 预警类型筛选
 *       - in: query
 *         name: alertLevel
 *         schema:
 *           type: string
 *           enum: [high, medium, low]
 *         description: 预警级别筛选
 *       - in: query
 *         name: status
 *         schema:
 *           type: string
 *           enum: [pending, processing, resolved, ignored]
 *         description: 处理状态筛选
 *       - in: query
 *         name: farmId
 *         schema:
 *           type: string
 *         description: 养殖场ID筛选
 *       - in: query
 *         name: isHandled
 *         schema:
 *           type: boolean
 *         description: 是否已处理筛选
 *       - in: query
 *         name: startDate
 *         schema:
 *           type: string
 *           format: date
 *         description: 开始日期
 *       - in: query
 *         name: endDate
 *         schema:
 *           type: string
 *           format: date
 *         description: 结束日期
 *     responses:
 *       200:
 *         description: 获取列表成功
 *         content:
 *           application/json:
 *             schema:
 *               allOf:
 *                 - $ref: '#/components/schemas/ApiResponse'
 *                 - type: object
 *                   properties:
 *                     data:
 *                       type: object
 *                       properties:
 *                         alerts:
 *                           type: array
 *                           items:
 *                             $ref: '#/components/schemas/EartagAlert'
 *                         pagination:
 *                           type: object
 *                           properties:
 *                             total:
 *                               type: integer
 *                               example: 100
 *                             page:
 *                               type: integer
 *                               example: 1
 *                             limit:
 *                               type: integer
 *                               example: 10
 *                             totalPages:
 *                               type: integer
 *                               example: 10
 *       500:
 *         description: 服务器内部错误
 *         content:
 *           application/json:
 *             schema:
 *               $ref: '#/components/schemas/ErrorResponse'
 */

/**
 * @swagger
 * /smart-alerts/public/eartag/{id}:
 *   get:
 *     tags:
 *       - 智能耳标预警
 *     summary: 获取单个智能耳标预警详情
 *     description: 获取指定ID的智能耳标预警详细信息
 *     parameters:
 *       - in: path
 *         name: id
 *         required: true
 *         schema:
 *           type: string
 *         description: 预警ID
 *     responses:
 *       200:
 *         description: 获取详情成功
 *         content:
 *           application/json:
 *             schema:
 *               allOf:
 *                 - $ref: '#/components/schemas/ApiResponse'
 *                 - type: object
 *                   properties:
 *                     data:
 *                       $ref: '#/components/schemas/EartagAlert'
 *       400:
 *         description: 请求参数错误
 *         content:
 *           application/json:
 *             schema:
 *               $ref: '#/components/schemas/ErrorResponse'
 *       404:
 *         description: 预警不存在
 *         content:
 *           application/json:
 *             schema:
 *               $ref: '#/components/schemas/ErrorResponse'
 *       500:
 *         description: 服务器内部错误
 *         content:
 *           application/json:
 *             schema:
 *               $ref: '#/components/schemas/ErrorResponse'
 */

/**
 * @swagger
 * /smart-alerts/public/eartag/{id}/handle:
 *   post:
 *     tags:
 *       - 智能耳标预警
 *     summary: 处理智能耳标预警
 *     description: 处理指定的智能耳标预警
 *     parameters:
 *       - in: path
 *         name: id
 *         required: true
 *         schema:
 *           type: string
 *         description: 预警ID
 *     requestBody:
 *       required: true
 *       content:
 *         application/json:
 *           schema:
 *             $ref: '#/components/schemas/AlertHandleRequest'
 *     responses:
 *       200:
 *         description: 处理成功
 *         content:
 *           application/json:
 *             schema:
 *               allOf:
 *                 - $ref: '#/components/schemas/ApiResponse'
 *                 - type: object
 *                   properties:
 *                     data:
 *                       $ref: '#/components/schemas/EartagAlert'
 *       400:
 *         description: 请求参数错误
 *         content:
 *           application/json:
 *             schema:
 *               $ref: '#/components/schemas/ErrorResponse'
 *       404:
 *         description: 预警不存在
 *         content:
 *           application/json:
 *             schema:
 *               $ref: '#/components/schemas/ErrorResponse'
 *       500:
 *         description: 服务器内部错误
 *         content:
 *           application/json:
 *             schema:
 *               $ref: '#/components/schemas/ErrorResponse'
 */

/**
 * @swagger
 * /smart-alerts/public/eartag/batch-handle:
 *   post:
 *     tags:
 *       - 智能耳标预警
 *     summary: 批量处理智能耳标预警
 *     description: 批量处理多个智能耳标预警
 *     requestBody:
 *       required: true
 *       content:
 *         application/json:
 *           schema:
 *             $ref: '#/components/schemas/BatchHandleRequest'
 *     responses:
 *       200:
 *         description: 批量处理成功
 *         content:
 *           application/json:
 *             schema:
 *               allOf:
 *                 - $ref: '#/components/schemas/ApiResponse'
 *                 - type: object
 *                   properties:
 *                     data:
 *                       type: object
 *                       properties:
 *                         successCount:
 *                           type: integer
 *                           description: 成功处理数量
 *                           example: 5
 *                         failedCount:
 *                           type: integer
 *                           description: 失败数量
 *                           example: 0
 *                         processedAlerts:
 *                           type: array
 *                           items:
 *                             $ref: '#/components/schemas/EartagAlert'
 *       400:
 *         description: 请求参数错误
 *         content:
 *           application/json:
 *             schema:
 *               $ref: '#/components/schemas/ErrorResponse'
 *       500:
 *         description: 服务器内部错误
 *         content:
 *           application/json:
 *             schema:
 *               $ref: '#/components/schemas/ErrorResponse'
 */

/**
 * @swagger
 * /smart-alerts/public/eartag/export:
 *   get:
 *     tags:
 *       - 智能耳标预警
 *     summary: 导出智能耳标预警数据
 *     description: 导出智能耳标预警数据为Excel文件
 *     parameters:
 *       - in: query
 *         name: alertType
 *         schema:
 *           type: string
 *           enum: [battery, offline, temperature, movement, wear]
 *         description: 预警类型筛选
 *       - in: query
 *         name: alertLevel
 *         schema:
 *           type: string
 *           enum: [high, medium, low]
 *         description: 预警级别筛选
 *       - in: query
 *         name: status
 *         schema:
 *           type: string
 *           enum: [pending, processing, resolved, ignored]
 *         description: 处理状态筛选
 *       - in: query
 *         name: farmId
 *         schema:
 *           type: string
 *         description: 养殖场ID筛选
 *       - in: query
 *         name: startDate
 *         schema:
 *           type: string
 *           format: date
 *         description: 开始日期
 *       - in: query
 *         name: endDate
 *         schema:
 *           type: string
 *           format: date
 *         description: 结束日期
 *     responses:
 *       200:
 *         description: 导出成功
 *         content:
 *           application/vnd.openxmlformats-officedocument.spreadsheetml.sheet:
 *             schema:
 *               type: string
 *               format: binary
 *       500:
 *         description: 服务器内部错误
 *         content:
 *           application/json:
 *             schema:
 *               $ref: '#/components/schemas/ErrorResponse'
 */

/**
 * @swagger
 * /smart-alerts/public/collar/stats:
 *   get:
 *     tags:
 *       - 智能项圈预警
 *     summary: 获取智能项圈预警统计
 *     description: 获取智能项圈预警的统计数据，包括各类预警的数量和设备总数
 *     responses:
 *       200:
 *         description: 获取统计成功
 *         content:
 *           application/json:
 *             schema:
 *               allOf:
 *                 - $ref: '#/components/schemas/ApiResponse'
 *                 - type: object
 *                   properties:
 *                     data:
 *                       $ref: '#/components/schemas/AlertStats'
 *       500:
 *         description: 服务器内部错误
 *         content:
 *           application/json:
 *             schema:
 *               $ref: '#/components/schemas/ErrorResponse'
 */

/**
 * @swagger
 * /smart-alerts/public/collar:
 *   get:
 *     tags:
 *       - 智能项圈预警
 *     summary: 获取智能项圈预警列表
 *     description: 获取智能项圈预警列表，支持分页、搜索和筛选
 *     parameters:
 *       - $ref: '#/components/parameters/PaginationQuery/properties/page'
 *       - $ref: '#/components/parameters/PaginationQuery/properties/limit'
 *       - in: query
 *         name: search
 *         schema:
 *           type: string
 *         description: 搜索关键词（设备名称、动物名称、养殖场名称）
 *       - in: query
 *         name: alertType
 *         schema:
 *           type: string
 *           enum: [battery, offline, temperature, movement, wear, location]
 *         description: 预警类型筛选
 *       - in: query
 *         name: alertLevel
 *         schema:
 *           type: string
 *           enum: [high, medium, low]
 *         description: 预警级别筛选
 *       - in: query
 *         name: status
 *         schema:
 *           type: string
 *           enum: [pending, processing, resolved, ignored]
 *         description: 处理状态筛选
 *       - in: query
 *         name: farmId
 *         schema:
 *           type: string
 *         description: 养殖场ID筛选
 *       - in: query
 *         name: isHandled
 *         schema:
 *           type: boolean
 *         description: 是否已处理筛选
 *       - in: query
 *         name: startDate
 *         schema:
 *           type: string
 *           format: date
 *         description: 开始日期
 *       - in: query
 *         name: endDate
 *         schema:
 *           type: string
 *           format: date
 *         description: 结束日期
 *     responses:
 *       200:
 *         description: 获取列表成功
 *         content:
 *           application/json:
 *             schema:
 *               allOf:
 *                 - $ref: '#/components/schemas/ApiResponse'
 *                 - type: object
 *                   properties:
 *                     data:
 *                       type: object
 *                       properties:
 *                         alerts:
 *                           type: array
 *                           items:
 *                             $ref: '#/components/schemas/CollarAlert'
 *                         pagination:
 *                           type: object
 *                           properties:
 *                             total:
 *                               type: integer
 *                               example: 100
 *                             page:
 *                               type: integer
 *                               example: 1
 *                             limit:
 *                               type: integer
 *                               example: 10
 *                             totalPages:
 *                               type: integer
 *                               example: 10
 *       500:
 *         description: 服务器内部错误
 *         content:
 *           application/json:
 *             schema:
 *               $ref: '#/components/schemas/ErrorResponse'
 */

/**
 * @swagger
 * /smart-alerts/public/collar/{id}:
 *   get:
 *     tags:
 *       - 智能项圈预警
 *     summary: 获取单个智能项圈预警详情
 *     description: 获取指定ID的智能项圈预警详细信息
 *     parameters:
 *       - in: path
 *         name: id
 *         required: true
 *         schema:
 *           type: string
 *         description: 预警ID
 *     responses:
 *       200:
 *         description: 获取详情成功
 *         content:
 *           application/json:
 *             schema:
 *               allOf:
 *                 - $ref: '#/components/schemas/ApiResponse'
 *                 - type: object
 *                   properties:
 *                     data:
 *                       $ref: '#/components/schemas/CollarAlert'
 *       400:
 *         description: 请求参数错误
 *         content:
 *           application/json:
 *             schema:
 *               $ref: '#/components/schemas/ErrorResponse'
 *       404:
 *         description: 预警不存在
 *         content:
 *           application/json:
 *             schema:
 *               $ref: '#/components/schemas/ErrorResponse'
 *       500:
 *         description: 服务器内部错误
 *         content:
 *           application/json:
 *             schema:
 *               $ref: '#/components/schemas/ErrorResponse'
 */

/**
 * @swagger
 * /smart-alerts/public/collar/{id}/handle:
 *   post:
 *     tags:
 *       - 智能项圈预警
 *     summary: 处理智能项圈预警
 *     description: 处理指定的智能项圈预警
 *     parameters:
 *       - in: path
 *         name: id
 *         required: true
 *         schema:
 *           type: string
 *         description: 预警ID
 *     requestBody:
 *       required: true
 *       content:
 *         application/json:
 *           schema:
 *             $ref: '#/components/schemas/AlertHandleRequest'
 *     responses:
 *       200:
 *         description: 处理成功
 *         content:
 *           application/json:
 *             schema:
 *               allOf:
 *                 - $ref: '#/components/schemas/ApiResponse'
 *                 - type: object
 *                   properties:
 *                     data:
 *                       $ref: '#/components/schemas/CollarAlert'
 *       400:
 *         description: 请求参数错误
 *         content:
 *           application/json:
 *             schema:
 *               $ref: '#/components/schemas/ErrorResponse'
 *       404:
 *         description: 预警不存在
 *         content:
 *           application/json:
 *             schema:
 *               $ref: '#/components/schemas/ErrorResponse'
 *       500:
 *         description: 服务器内部错误
 *         content:
 *           application/json:
 *             schema:
 *               $ref: '#/components/schemas/ErrorResponse'
 */

/**
 * @swagger
 * /smart-alerts/public/collar/batch-handle:
 *   post:
 *     tags:
 *       - 智能项圈预警
 *     summary: 批量处理智能项圈预警
 *     description: 批量处理多个智能项圈预警
 *     requestBody:
 *       required: true
 *       content:
 *         application/json:
 *           schema:
 *             $ref: '#/components/schemas/BatchHandleRequest'
 *     responses:
 *       200:
 *         description: 批量处理成功
 *         content:
 *           application/json:
 *             schema:
 *               allOf:
 *                 - $ref: '#/components/schemas/ApiResponse'
 *                 - type: object
 *                   properties:
 *                     data:
 *                       type: object
 *                       properties:
 *                         successCount:
 *                           type: integer
 *                           description: 成功处理数量
 *                           example: 5
 *                         failedCount:
 *                           type: integer
 *                           description: 失败数量
 *                           example: 0
 *                         processedAlerts:
 *                           type: array
 *                           items:
 *                             $ref: '#/components/schemas/CollarAlert'
 *       400:
 *         description: 请求参数错误
 *         content:
 *           application/json:
 *             schema:
 *               $ref: '#/components/schemas/ErrorResponse'
 *       500:
 *         description: 服务器内部错误
 *         content:
 *           application/json:
 *             schema:
 *               $ref: '#/components/schemas/ErrorResponse'
 */

/**
 * @swagger
 * /smart-alerts/public/collar/export:
 *   get:
 *     tags:
 *       - 智能项圈预警
 *     summary: 导出智能项圈预警数据
 *     description: 导出智能项圈预警数据为Excel文件
 *     parameters:
 *       - in: query
 *         name: alertType
 *         schema:
 *           type: string
 *           enum: [battery, offline, temperature, movement, wear, location]
 *         description: 预警类型筛选
 *       - in: query
 *         name: alertLevel
 *         schema:
 *           type: string
 *           enum: [high, medium, low]
 *         description: 预警级别筛选
 *       - in: query
 *         name: status
 *         schema:
 *           type: string
 *           enum: [pending, processing, resolved, ignored]
 *         description: 处理状态筛选
 *       - in: query
 *         name: farmId
 *         schema:
 *           type: string
 *         description: 养殖场ID筛选
 *       - in: query
 *         name: startDate
 *         schema:
 *           type: string
 *           format: date
 *         description: 开始日期
 *       - in: query
 *         name: endDate
 *         schema:
 *           type: string
 *           format: date
 *         description: 结束日期
 *     responses:
 *       200:
 *         description: 导出成功
 *         content:
 *           application/vnd.openxmlformats-officedocument.spreadsheetml.sheet:
 *             schema:
 *               type: string
 *               format: binary
 *       500:
 *         description: 服务器内部错误
 *         content:
 *           application/json:
 *             schema:
 *               $ref: '#/components/schemas/ErrorResponse'
 */

module.exports = {};