完善项目

2025-09-28 17:58:43 +08:00
parent ec3f472641
commit 5b615473e0
59 changed files with 5428 additions and 593 deletions
--- a/insurance_backend/routes/insuranceTypes.js
+++ b/insurance_backend/routes/insuranceTypes.js
@@ -3,34 +3,328 @@ const router = express.Router();
 const insuranceTypeController = require('../controllers/insuranceTypeController');
 const { jwtAuth, checkPermission } = require('../middleware/auth');

+/**
+ * @swagger
+ * /api/insurance-types:
+ *   get:
+ *     summary: 获取险种列表
+ *     description: 分页获取险种列表，支持多种筛选条件
+ *     tags:
+ *       - 险种管理
+ *     security:
+ *       - bearerAuth: []
+ *     parameters:
+ *       - name: page
+ *         in: query
+ *         description: 页码
+ *         required: false
+ *         schema:
+ *           type: integer
+ *           default: 1
+ *           minimum: 1
+ *       - name: pageSize
+ *         in: query
+ *         description: 每页数量
+ *         required: false
+ *         schema:
+ *           type: integer
+ *           default: 10
+ *           minimum: 1
+ *           maximum: 100
+ *       - name: name
+ *         in: query
+ *         description: 险种名称（模糊搜索）
+ *         required: false
+ *         schema:
+ *           type: string
+ *       - name: status
+ *         in: query
+ *         description: 险种状态
+ *         required: false
+ *         schema:
+ *           type: string
+ *           enum: [active, inactive]
+ *       - name: applicable_livestock
+ *         in: query
+ *         description: 适用牲畜类型（模糊搜索）
+ *         required: false
+ *         schema:
+ *           type: string
+ *       - name: service_area
+ *         in: query
+ *         description: 服务区域（模糊搜索）
+ *         required: false
+ *         schema:
+ *           type: string
+ *       - name: on_sale_status
+ *         in: query
+ *         description: 在售状态
+ *         required: false
+ *         schema:
+ *           type: boolean
+ *     responses:
+ *       '200':
+ *         description: 获取成功
+ *         content:
+ *           application/json:
+ *             schema:
+ *               type: object
+ *               properties:
+ *                 success:
+ *                   type: boolean
+ *                   example: true
+ *                 message:
+ *                   type: string
+ *                   example: "获取险种列表成功"
+ *                 data:
+ *                   type: array
+ *                   items:
+ *                     $ref: '#/components/schemas/InsuranceType'
+ *                 pagination:
+ *                   $ref: '#/components/schemas/Pagination'
+ *       '401':
+ *         $ref: '#/components/responses/UnauthorizedError'
+ *       '403':
+ *         $ref: '#/components/responses/ForbiddenError'
+ *       '500':
+ *         description: 服务器内部错误
+ *   post:
+ *     summary: 创建险种
+ *     description: 创建新的保险险种
+ *     tags:
+ *       - 险种管理
+ *     security:
+ *       - bearerAuth: []
+ *     requestBody:
+ *       required: true
+ *       content:
+ *         application/json:
+ *           schema:
+ *             $ref: '#/components/schemas/CreateInsuranceTypeRequest'
+ *     responses:
+ *       '201':
+ *         description: 创建成功
+ *         content:
+ *           application/json:
+ *             schema:
+ *               type: object
+ *               properties:
+ *                 success:
+ *                   type: boolean
+ *                   example: true
+ *                 message:
+ *                   type: string
+ *                   example: "创建险种成功"
+ *                 data:
+ *                   $ref: '#/components/schemas/InsuranceType'
+ *       '400':
+ *         description: 请求参数错误
+ *       '401':
+ *         $ref: '#/components/responses/UnauthorizedError'
+ *       '403':
+ *         $ref: '#/components/responses/ForbiddenError'
+ *       '500':
+ *         description: 服务器内部错误
+ */
+
 // 获取险种列表
 router.get('/', jwtAuth, checkPermission('insurance_type', 'read'), 
  insuranceTypeController.getInsuranceTypes
 );

+/**
+ * @swagger
+ * /api/insurance-types/{id}:
+ *   get:
+ *     summary: 获取单个险种
+ *     description: 根据ID获取险种详细信息
+ *     tags:
+ *       - 险种管理
+ *     security:
+ *       - bearerAuth: []
+ *     parameters:
+ *       - name: id
+ *         in: path
+ *         description: 险种ID
+ *         required: true
+ *         schema:
+ *           type: integer
+ *     responses:
+ *       '200':
+ *         description: 获取成功
+ *         content:
+ *           application/json:
+ *             schema:
+ *               type: object
+ *               properties:
+ *                 success:
+ *                   type: boolean
+ *                   example: true
+ *                 message:
+ *                   type: string
+ *                   example: "获取险种详情成功"
+ *                 data:
+ *                   $ref: '#/components/schemas/InsuranceType'
+ *       '401':
+ *         $ref: '#/components/responses/UnauthorizedError'
+ *       '403':
+ *         $ref: '#/components/responses/ForbiddenError'
+ *       '404':
+ *         description: 险种不存在
+ *       '500':
+ *         description: 服务器内部错误
+ */
 // 获取单个险种详情
 router.get('/:id', jwtAuth, checkPermission('insurance_type', 'read'),
  insuranceTypeController.getInsuranceTypeById
 );

 // 创建险种
-router.post('/', jwtAuth, checkPermission('insurance_type', 'create'),
-  insuranceTypeController.createInsuranceType
-);
+router.post('/', jwtAuth, checkPermission('insurance_type', 'create'), insuranceTypeController.createInsuranceType);

+/**
+ * @swagger
+ * /api/insurance-types/{id}:
+ *   put:
+ *     summary: 更新险种
+ *     description: 根据ID更新险种信息
+ *     tags:
+ *       - 险种管理
+ *     security:
+ *       - bearerAuth: []
+ *     parameters:
+ *       - name: id
+ *         in: path
+ *         description: 险种ID
+ *         required: true
+ *         schema:
+ *           type: integer
+ *     requestBody:
+ *       required: true
+ *       content:
+ *         application/json:
+ *           schema:
+ *             $ref: '#/components/schemas/UpdateInsuranceTypeRequest'
+ *     responses:
+ *       '200':
+ *         description: 更新成功
+ *         content:
+ *           application/json:
+ *             schema:
+ *               type: object
+ *               properties:
+ *                 success:
+ *                   type: boolean
+ *                   example: true
+ *                 message:
+ *                   type: string
+ *                   example: "更新险种成功"
+ *                 data:
+ *                   $ref: '#/components/schemas/InsuranceType'
+ *       '400':
+ *         description: 请求参数错误
+ *       '401':
+ *         $ref: '#/components/responses/UnauthorizedError'
+ *       '403':
+ *         $ref: '#/components/responses/ForbiddenError'
+ *       '404':
+ *         description: 险种不存在
+ *       '500':
+ *         description: 服务器内部错误
+ *   delete:
+ *     summary: 删除险种
+ *     description: 根据ID删除险种
+ *     tags:
+ *       - 险种管理
+ *     security:
+ *       - bearerAuth: []
+ *     parameters:
+ *       - name: id
+ *         in: path
+ *         description: 险种ID
+ *         required: true
+ *         schema:
+ *           type: integer
+ *     responses:
+ *       '200':
+ *         description: 删除成功
+ *         content:
+ *           application/json:
+ *             schema:
+ *               type: object
+ *               properties:
+ *                 success:
+ *                   type: boolean
+ *                   example: true
+ *                 message:
+ *                   type: string
+ *                   example: "删除险种成功"
+ *       '401':
+ *         $ref: '#/components/responses/UnauthorizedError'
+ *       '403':
+ *         $ref: '#/components/responses/ForbiddenError'
+ *       '404':
+ *         description: 险种不存在
+ *       '500':
+ *         description: 服务器内部错误
+ */
 // 更新险种
-router.put('/:id', jwtAuth, checkPermission('insurance_type', 'update'),
-  insuranceTypeController.updateInsuranceType
-);
+router.put('/:id', jwtAuth, checkPermission('insurance_type', 'update'), insuranceTypeController.updateInsuranceType);

 // 删除险种
-router.delete('/:id', jwtAuth, checkPermission('insurance_type', 'delete'),
-  insuranceTypeController.deleteInsuranceType
-);
+router.delete('/:id', jwtAuth, checkPermission('insurance_type', 'delete'), insuranceTypeController.deleteInsuranceType);

+/**
+ * @swagger
+ * /api/insurance-types/{id}/status:
+ *   patch:
+ *     summary: 更新险种状态
+ *     description: 更新险种的状态和在售状态
+ *     tags:
+ *       - 险种管理
+ *     security:
+ *       - bearerAuth: []
+ *     parameters:
+ *       - name: id
+ *         in: path
+ *         description: 险种ID
+ *         required: true
+ *         schema:
+ *           type: integer
+ *     requestBody:
+ *       required: true
+ *       content:
+ *         application/json:
+ *           schema:
+ *             $ref: '#/components/schemas/UpdateInsuranceTypeStatusRequest'
+ *     responses:
+ *       '200':
+ *         description: 更新成功
+ *         content:
+ *           application/json:
+ *             schema:
+ *               type: object
+ *               properties:
+ *                 success:
+ *                   type: boolean
+ *                   example: true
+ *                 message:
+ *                   type: string
+ *                   example: "更新险种状态成功"
+ *                 data:
+ *                   $ref: '#/components/schemas/InsuranceType'
+ *       '400':
+ *         description: 请求参数错误
+ *       '401':
+ *         $ref: '#/components/responses/UnauthorizedError'
+ *       '403':
+ *         $ref: '#/components/responses/ForbiddenError'
+ *       '404':
+ *         description: 险种不存在
+ *       '500':
+ *         description: 服务器内部错误
+ */
 // 更新险种状态
-router.patch('/:id/status', jwtAuth, checkPermission('insurance_type', 'update'),
-  insuranceTypeController.updateInsuranceTypeStatus
-);
+router.patch('/:id/status', jwtAuth, checkPermission('insurance_type', 'update'), insuranceTypeController.updateInsuranceTypeStatus);

 module.exports = router;
--- a/insurance_backend/routes/livestockClaims.js
+++ b/insurance_backend/routes/livestockClaims.js
@@ -6,10 +6,27 @@ const {
  getLivestockClaimById,
  reviewLivestockClaim,
  updateLivestockClaimPayment,
-  getLivestockClaimStats
+  getLivestockClaimStats,
+  updateLivestockClaim,
+  deleteLivestockClaim
 } = require('../controllers/livestockClaimController');
 const { authenticateToken, requirePermission } = require('../middleware/auth');

+// 测试查询参数端点（无认证）
+router.get('/test-params', (req, res) => {
+  console.log('🧪 [测试端点] 查询参数测试:');
+  console.log('req.url:', req.url);
+  console.log('req.originalUrl:', req.originalUrl);
+  console.log('req.query:', req.query);
+  console.log('req.params:', req.params);
+  res.json({
+    url: req.url,
+    originalUrl: req.originalUrl,
+    query: req.query,
+    params: req.params
+  });
+});
+
 // 获取生资理赔列表
 router.get('/', authenticateToken, requirePermission('livestock_claim:read'), getLivestockClaims);

@@ -22,6 +39,12 @@ router.get('/:id', authenticateToken, requirePermission('livestock_claim:read'),
 // 创建生资理赔申请
 router.post('/', authenticateToken, requirePermission('livestock_claim:create'), createLivestockClaim);

+// 更新生资理赔信息
+router.put('/:id', authenticateToken, requirePermission('livestock_claim:update'), updateLivestockClaim);
+
+// 删除生资理赔
+router.delete('/:id', authenticateToken, requirePermission('livestock_claim:delete'), deleteLivestockClaim);
+
 // 审核生资理赔
 router.patch('/:id/review', authenticateToken, requirePermission('livestock_claim:review'), reviewLivestockClaim);