/**
 * @swagger
 * /api/v1/admin/categories:
 *   get:
 *     summary: 获取分类列表
 *     description: 获取所有服务分类列表
 *     tags: [Admin Categories]
 *     security:
 *       - bearerAuth: []
 *     responses:
 *       200:
 *         description: 获取成功
 *         content:
 *           application/json:
 *             schema:
 *               type: object
 *               properties:
 *                 code:
 *                   type: integer
 *                   example: 0
 *                 data:
 *                   type: array
 *                   items:
 *                     $ref: '#/components/schemas/Category'
 *       401:
 *         description: 未授权
 *
 *   post:
 *     summary: 创建分类
 *     description: 创建新的服务分类
 *     tags: [Admin Categories]
 *     security:
 *       - bearerAuth: []
 *     requestBody:
 *       required: true
 *       content:
 *         application/json:
 *           schema:
 *             type: object
 *             required:
 *               - key
 *               - name_zh
 *               - name_en
 *               - name_pt
 *             properties:
 *               key:
 *                 type: string
 *                 description: 分类唯一标识
 *                 example: "airport"
 *               name_zh:
 *                 type: string
 *                 description: 中文名称
 *                 example: "机场服务"
 *               name_en:
 *                 type: string
 *                 description: 英文名称
 *                 example: "Airport Service"
 *               name_pt:
 *                 type: string
 *                 description: 葡语名称
 *                 example: "Serviço de Aeroporto"
 *               icon:
 *                 type: string
 *                 description: 图标URL
 *               sort_order:
 *                 type: integer
 *                 description: 排序
 *                 default: 0
 *     responses:
 *       201:
 *         description: 创建成功
 *       400:
 *         description: 请求参数错误
 *       401:
 *         description: 未授权
 *
 * /api/v1/admin/categories/{id}:
 *   get:
 *     summary: 获取分类详情
 *     description: 获取指定分类的详细信息
 *     tags: [Admin Categories]
 *     security:
 *       - bearerAuth: []
 *     parameters:
 *       - in: path
 *         name: id
 *         required: true
 *         schema:
 *           type: string
 *           format: uuid
 *         description: 分类ID
 *     responses:
 *       200:
 *         description: 获取成功
 *       404:
 *         description: 分类不存在
 *
 *   put:
 *     summary: 更新分类
 *     description: 更新分类信息
 *     tags: [Admin Categories]
 *     security:
 *       - bearerAuth: []
 *     parameters:
 *       - in: path
 *         name: id
 *         required: true
 *         schema:
 *           type: string
 *           format: uuid
 *         description: 分类ID
 *     requestBody:
 *       required: true
 *       content:
 *         application/json:
 *           schema:
 *             type: object
 *             properties:
 *               key:
 *                 type: string
 *               name_zh:
 *                 type: string
 *               name_en:
 *                 type: string
 *               name_pt:
 *                 type: string
 *               icon:
 *                 type: string
 *               sort_order:
 *                 type: integer
 *     responses:
 *       200:
 *         description: 更新成功
 *       404:
 *         description: 分类不存在
 *
 *   delete:
 *     summary: 删除分类
 *     description: 删除指定分类
 *     tags: [Admin Categories]
 *     security:
 *       - bearerAuth: []
 *     parameters:
 *       - in: path
 *         name: id
 *         required: true
 *         schema:
 *           type: string
 *           format: uuid
 *         description: 分类ID
 *     responses:
 *       200:
 *         description: 删除成功
 *       404:
 *         description: 分类不存在
 */
