代理后端出版

docs/apis/transfers.js

@@ -0,0 +1,134 @@
+/**
+ * @swagger
+ * tags:
+ *   name: 转账管理
+ *   description: 转账记录管理相关接口
+ */
+
+/**
+ * @swagger
+ * /transfers:
+ *   get:
+ *     summary: 获取代理下级用户转账记录列表
+ *     tags: [转账管理]
+ *     security:
+ *       - bearerAuth: []
+ *     parameters:
+ *       - in: query
+ *         name: page
+ *         schema:
+ *           type: integer
+ *           default: 1
+ *         description: 页码
+ *       - in: query
+ *         name: limit
+ *         schema:
+ *           type: integer
+ *           default: 10
+ *         description: 每页数量
+ *       - in: query
+ *         name: search
+ *         schema:
+ *           type: string
+ *         description: 搜索关键词（用户名、手机号、转账单号）
+ *       - in: query
+ *         name: status
+ *         schema:
+ *           type: string
+ *           enum: [pending, success, failed, cancelled]
+ *         description: 转账状态
+ *       - in: query
+ *         name: type
+ *         schema:
+ *           type: string
+ *           enum: [deposit, withdraw, transfer]
+ *         description: 转账类型
+ *       - in: query
+ *         name: start_date
+ *         schema:
+ *           type: string
+ *           format: date
+ *         description: 开始日期
+ *       - in: query
+ *         name: end_date
+ *         schema:
+ *           type: string
+ *           format: date
+ *         description: 结束日期
+ *       - in: query
+ *         name: min_amount
+ *         schema:
+ *           type: number
+ *         description: 最小金额
+ *       - in: query
+ *         name: max_amount
+ *         schema:
+ *           type: number
+ *         description: 最大金额
+ *       - in: query
+ *         name: sort_by
+ *         schema:
+ *           type: string
+ *           default: created_at
+ *         description: 排序字段
+ *       - in: query
+ *         name: sort_order
+ *         schema:
+ *           type: string
+ *           enum: [asc, desc]
+ *           default: desc
+ *         description: 排序方向
+ *     responses:
+ *       200:
+ *         description: 获取成功
+ *         content:
+ *           application/json:
+ *             schema:
+ *               type: object
+ *               properties:
+ *                 success:
+ *                   type: boolean
+ *                   example: true
+ *                 data:
+ *                   type: object
+ *                   properties:
+ *                     transfers:
+ *                       type: array
+ *                       items:
+ *                         $ref: '#/components/schemas/Transfer'
+ *                     total:
+ *                       type: integer
+ *                       description: 总记录数
+ *                     page:
+ *                       type: integer
+ *                       description: 当前页码
+ *                     limit:
+ *                       type: integer
+ *                       description: 每页数量
+ *                     totalPages:
+ *                       type: integer
+ *                       description: 总页数
+ *                     stats:
+ *                       type: object
+ *                       properties:
+ *                         totalAmount:
+ *                           type: number
+ *                           format: decimal
+ *                           description: 总转账金额
+ *                         successAmount:
+ *                           type: number
+ *                           format: decimal
+ *                           description: 成功转账金额
+ *                         pendingAmount:
+ *                           type: number
+ *                           format: decimal
+ *                           description: 待处理转账金额
+ *                         failedAmount:
+ *                           type: number
+ *                           format: decimal
+ *                           description: 失败转账金额
+ *       401:
+ *         description: 未授权
+ *       500:
+ *         description: 服务器错误
+ */