/** * @swagger * components: * schemas: * Transfer: * type: object * properties: * id: * type: integer * description: 转账记录ID * user_id: * type: integer * description: 用户ID * recipient_id: * type: integer * description: 接收方用户ID * amount: * type: number * format: float * description: 转账金额 * status: * type: string * enum: [pending, completed, failed, cancelled] * description: 转账状态 * transfer_type: * type: string * enum: [user_to_user, user_to_system, system_to_user] * description: 转账类型 * voucher_image: * type: string * description: 转账凭证图片路径 * remark: * type: string * description: 转账备注 * created_at: * type: string * format: date-time * description: 创建时间 * updated_at: * type: string * format: date-time * description: 更新时间 * Pagination: * type: object * properties: * total: * type: integer * description: 总记录数 * page: * type: integer * description: 当前页码 * limit: * type: integer * description: 每页记录数 * total_pages: * type: integer * description: 总页数 */ /** * @swagger * /transfers: * get: * summary: 获取转账列表 * tags: [Transfers] * security: * - bearerAuth: [] * parameters: * - in: query * name: status * schema: * type: string * description: 转账状态过滤 * - in: query * name: transfer_type * schema: * type: string * 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: search * schema: * type: string * description: 搜索关键词（用户名或真实姓名） * - in: query * name: page * schema: * type: integer * default: 1 * description: 页码 * - in: query * name: limit * schema: * type: integer * default: 10 * description: 每页数量 * - in: query * name: sort * schema: * type: string * description: 排序字段 * - in: query * name: order * schema: * type: string * enum: [asc, desc] * description: 排序方向 * responses: * 200: * description: 成功获取转账列表 * content: * application/json: * schema: * type: object * properties: * success: * type: boolean * data: * type: object * properties: * transfers: * type: array * items: * $ref: '#/components/schemas/Transfer' * pagination: * $ref: '#/components/schemas/Pagination' * 401: * description: 未授权 * 500: * description: 服务器错误 */ /** * @swagger * /transfers/list: * get: * summary: 获取转账记录列表 * tags: [Transfers] * security: * - bearerAuth: [] * parameters: * - in: query * name: status * schema: * type: string * description: 转账状态过滤 * - in: query * name: transfer_type * schema: * type: string * 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: page * schema: * type: integer * default: 1 * description: 页码 * - in: query * name: limit * schema: * type: integer * default: 10 * description: 每页数量 * - in: query * name: sort * schema: * type: string * description: 排序字段 * - in: query * name: order * schema: * type: string * enum: [asc, desc] * description: 排序方向 * responses: * 200: * description: 成功获取转账记录列表 * content: * application/json: * schema: * type: object * properties: * success: * type: boolean * data: * type: object * properties: * transfers: * type: array * items: * $ref: '#/components/schemas/Transfer' * pagination: * $ref: '#/components/schemas/Pagination' * 401: * description: 未授权 * 500: * description: 服务器错误 */ /** * @swagger * /transfers/public-account: * get: * summary: 获取公户信息 * tags: [Transfers] * security: * - bearerAuth: [] * responses: * 200: * description: 成功获取公户信息 * content: * application/json: * schema: * type: object * properties: * success: * type: boolean * example: true * data: * type: object * properties: * id: * type: integer * description: 公户ID * username: * type: string * description: 公户用户名 * example: public_account * real_name: * type: string * description: 公户名称 * balance: * type: number * format: float * description: 公户余额 * 401: * description: 未授权 * 404: * description: 公户不存在 * 500: * description: 服务器错误 */ /** * @swagger * /transfers/create: * post: * summary: 创建转账记录 * tags: [Transfers] * security: * - bearerAuth: [] * requestBody: * required: true * content: * application/json: * schema: * type: object * required: * - to_user_id * - amount * - transfer_type * properties: * to_user_id: * type: integer * description: 接收方用户ID * amount: * type: number * format: float * description: 转账金额 * transfer_type: * type: string * enum: [user_to_user, user_to_system, system_to_user] * description: 转账类型 * remark: * type: string * description: 转账备注 * responses: * 201: * description: 转账记录创建成功 * content: * application/json: * schema: * type: object * properties: * success: * type: boolean * example: true * message: * type: string * example: 转账记录创建成功，等待确认 * data: * type: object * properties: * transfer_id: * type: integer * description: 转账记录ID * 400: * description: 请求参数错误 * 401: * description: 未授权 * 500: * description: 服务器错误 */ /** * @swagger * /transfers/admin/create: * post: * summary: 管理员创建转账记录 * tags: [Transfers] * security: * - bearerAuth: [] * requestBody: * required: true * content: * application/json: * schema: * type: object * required: * - from_user_id * - to_user_id * - amount * - transfer_type * properties: * from_user_id: * type: integer * description: 发送方用户ID * to_user_id: * type: integer * description: 接收方用户ID * amount: * type: number * format: float * description: 转账金额 * transfer_type: * type: string * enum: [user_to_user, user_to_system, system_to_user] * description: 转账类型 * description: * type: string * description: 转账描述 * responses: * 201: * description: 转账记录创建成功 * content: * application/json: * schema: * type: object * properties: * success: * type: boolean * example: true * message: * type: string * example: 转账记录创建成功 * data: * type: object * properties: * transfer_id: * type: integer * description: 转账记录ID * 400: * description: 请求参数错误 * 401: * description: 未授权 * 403: * description: 权限不足 * 500: * description: 服务器错误 */