/**
 * @swagger
 * /api/v1/invitations/generate:
 *   post:
 *     summary: 生成邀请码
 *     description: 为当前用户生成唯一的邀请码
 *     tags: [Invitations]
 *     security:
 *       - bearerAuth: []
 *     responses:
 *       200:
 *         description: 生成成功
 *         content:
 *           application/json:
 *             schema:
 *               type: object
 *               properties:
 *                 success:
 *                   type: boolean
 *                   example: true
 *                 data:
 *                   type: object
 *                   properties:
 *                     invitationCode:
 *                       type: string
 *                       description: 邀请码
 *                       example: "ABC123"
 *       401:
 *         description: 未授权
 *
 * /api/v1/invitations/stats:
 *   get:
 *     summary: 获取邀请统计
 *     description: 获取当前用户的邀请统计数据
 *     tags: [Invitations]
 *     security:
 *       - bearerAuth: []
 *     responses:
 *       200:
 *         description: 获取成功
 *         content:
 *           application/json:
 *             schema:
 *               type: object
 *               properties:
 *                 success:
 *                   type: boolean
 *                   example: true
 *                 data:
 *                   type: object
 *                   properties:
 *                     totalInvites:
 *                       type: integer
 *                       description: 总邀请人数
 *                       example: 10
 *                     paidInvites:
 *                       type: integer
 *                       description: 已付款邀请人数
 *                       example: 5
 *                     totalRewards:
 *                       type: number
 *                       format: decimal
 *                       description: 总奖励金额
 *                       example: 150.00
 *                     availableBalance:
 *                       type: number
 *                       format: decimal
 *                       description: 可用余额
 *                       example: 100.00
 *                     invitationCode:
 *                       type: string
 *                       description: 邀请码
 *                       example: "ABC123"
 *       401:
 *         description: 未授权
 *
 * /api/v1/invitations/records:
 *   get:
 *     summary: 获取邀请记录
 *     description: 获取当前用户的邀请记录列表
 *     tags: [Invitations]
 *     security:
 *       - bearerAuth: []
 *     parameters:
 *       - in: query
 *         name: page
 *         schema:
 *           type: integer
 *           minimum: 1
 *           default: 1
 *         description: 页码
 *       - in: query
 *         name: limit
 *         schema:
 *           type: integer
 *           minimum: 1
 *           maximum: 100
 *           default: 10
 *         description: 每页数量
 *     responses:
 *       200:
 *         description: 获取成功
 *         content:
 *           application/json:
 *             schema:
 *               type: object
 *               properties:
 *                 success:
 *                   type: boolean
 *                   example: true
 *                 data:
 *                   type: object
 *                   properties:
 *                     records:
 *                       type: array
 *                       items:
 *                         $ref: '#/components/schemas/Invitation'
 *                     pagination:
 *                       $ref: '#/components/schemas/PaginationMeta'
 *       401:
 *         description: 未授权
 */
