添加银行端后端接口
This commit is contained in:
408
bank-backend/routes/loanApplications.js
Normal file
408
bank-backend/routes/loanApplications.js
Normal file
@@ -0,0 +1,408 @@
|
||||
/**
|
||||
* 贷款申请路由
|
||||
* @file loanApplications.js
|
||||
* @description 银行系统贷款申请相关路由配置
|
||||
*/
|
||||
const express = require('express');
|
||||
const router = express.Router();
|
||||
const { body } = require('express-validator');
|
||||
const loanApplicationController = require('../controllers/loanApplicationController');
|
||||
const { authMiddleware } = require('../middleware/auth');
|
||||
|
||||
// 所有路由都需要认证
|
||||
router.use(authMiddleware);
|
||||
|
||||
/**
|
||||
* @swagger
|
||||
* /api/loan-applications:
|
||||
* get:
|
||||
* summary: 获取贷款申请列表
|
||||
* tags: [贷款申请]
|
||||
* security:
|
||||
* - bearerAuth: []
|
||||
* parameters:
|
||||
* - in: query
|
||||
* name: page
|
||||
* schema:
|
||||
* type: integer
|
||||
* default: 1
|
||||
* description: 页码
|
||||
* - in: query
|
||||
* name: pageSize
|
||||
* schema:
|
||||
* type: integer
|
||||
* default: 10
|
||||
* description: 每页数量
|
||||
* - in: query
|
||||
* name: searchField
|
||||
* schema:
|
||||
* type: string
|
||||
* enum: [applicationNumber, customerName, productName]
|
||||
* default: applicationNumber
|
||||
* description: 搜索字段
|
||||
* - in: query
|
||||
* name: searchValue
|
||||
* schema:
|
||||
* type: string
|
||||
* description: 搜索值
|
||||
* - in: query
|
||||
* name: status
|
||||
* schema:
|
||||
* type: string
|
||||
* enum: [pending_review, verification_pending, pending_binding, approved, rejected]
|
||||
* description: 申请状态筛选
|
||||
* - in: query
|
||||
* name: sortField
|
||||
* schema:
|
||||
* type: string
|
||||
* default: createdAt
|
||||
* description: 排序字段
|
||||
* - in: query
|
||||
* name: sortOrder
|
||||
* schema:
|
||||
* type: string
|
||||
* enum: [ASC, DESC]
|
||||
* default: DESC
|
||||
* description: 排序方向
|
||||
* responses:
|
||||
* 200:
|
||||
* description: 获取成功
|
||||
* content:
|
||||
* application/json:
|
||||
* schema:
|
||||
* type: object
|
||||
* properties:
|
||||
* success:
|
||||
* type: boolean
|
||||
* data:
|
||||
* type: object
|
||||
* properties:
|
||||
* applications:
|
||||
* type: array
|
||||
* items:
|
||||
* $ref: '#/components/schemas/LoanApplication'
|
||||
* pagination:
|
||||
* $ref: '#/components/schemas/Pagination'
|
||||
*/
|
||||
router.get('/', loanApplicationController.getApplications);
|
||||
|
||||
/**
|
||||
* @swagger
|
||||
* /api/loan-applications/{id}:
|
||||
* get:
|
||||
* summary: 获取贷款申请详情
|
||||
* tags: [贷款申请]
|
||||
* security:
|
||||
* - bearerAuth: []
|
||||
* parameters:
|
||||
* - in: path
|
||||
* name: id
|
||||
* required: true
|
||||
* schema:
|
||||
* type: integer
|
||||
* description: 申请ID
|
||||
* responses:
|
||||
* 200:
|
||||
* description: 获取成功
|
||||
* content:
|
||||
* application/json:
|
||||
* schema:
|
||||
* type: object
|
||||
* properties:
|
||||
* success:
|
||||
* type: boolean
|
||||
* data:
|
||||
* $ref: '#/components/schemas/LoanApplication'
|
||||
* 404:
|
||||
* description: 申请不存在
|
||||
*/
|
||||
router.get('/:id', loanApplicationController.getApplicationById);
|
||||
|
||||
/**
|
||||
* @swagger
|
||||
* /api/loan-applications/{id}/audit:
|
||||
* post:
|
||||
* summary: 审核贷款申请
|
||||
* tags: [贷款申请]
|
||||
* security:
|
||||
* - bearerAuth: []
|
||||
* parameters:
|
||||
* - in: path
|
||||
* name: id
|
||||
* required: true
|
||||
* schema:
|
||||
* type: integer
|
||||
* description: 申请ID
|
||||
* requestBody:
|
||||
* required: true
|
||||
* content:
|
||||
* application/json:
|
||||
* schema:
|
||||
* type: object
|
||||
* required:
|
||||
* - action
|
||||
* - comment
|
||||
* properties:
|
||||
* action:
|
||||
* type: string
|
||||
* enum: [approve, reject]
|
||||
* description: 审核动作
|
||||
* comment:
|
||||
* type: string
|
||||
* description: 审核意见
|
||||
* responses:
|
||||
* 200:
|
||||
* description: 审核成功
|
||||
* content:
|
||||
* application/json:
|
||||
* schema:
|
||||
* type: object
|
||||
* properties:
|
||||
* success:
|
||||
* type: boolean
|
||||
* message:
|
||||
* type: string
|
||||
* data:
|
||||
* type: object
|
||||
* properties:
|
||||
* id:
|
||||
* type: integer
|
||||
* status:
|
||||
* type: string
|
||||
* action:
|
||||
* type: string
|
||||
* comment:
|
||||
* type: string
|
||||
* 400:
|
||||
* description: 请求参数错误
|
||||
* 404:
|
||||
* description: 申请不存在
|
||||
*/
|
||||
router.post('/:id/audit', [
|
||||
body('action')
|
||||
.isIn(['approve', 'reject'])
|
||||
.withMessage('审核动作必须是approve或reject'),
|
||||
body('comment')
|
||||
.notEmpty()
|
||||
.withMessage('审核意见不能为空')
|
||||
.isLength({ max: 500 })
|
||||
.withMessage('审核意见不能超过500个字符')
|
||||
], loanApplicationController.auditApplication);
|
||||
|
||||
/**
|
||||
* @swagger
|
||||
* /api/loan-applications/stats:
|
||||
* get:
|
||||
* summary: 获取申请统计信息
|
||||
* tags: [贷款申请]
|
||||
* security:
|
||||
* - bearerAuth: []
|
||||
* responses:
|
||||
* 200:
|
||||
* description: 获取成功
|
||||
* content:
|
||||
* application/json:
|
||||
* schema:
|
||||
* type: object
|
||||
* properties:
|
||||
* success:
|
||||
* type: boolean
|
||||
* data:
|
||||
* type: object
|
||||
* properties:
|
||||
* total:
|
||||
* type: object
|
||||
* properties:
|
||||
* applications:
|
||||
* type: integer
|
||||
* amount:
|
||||
* type: number
|
||||
* byStatus:
|
||||
* type: object
|
||||
* properties:
|
||||
* counts:
|
||||
* type: object
|
||||
* amounts:
|
||||
* type: object
|
||||
*/
|
||||
router.get('/stats', loanApplicationController.getApplicationStats);
|
||||
|
||||
/**
|
||||
* @swagger
|
||||
* /api/loan-applications/batch/status:
|
||||
* put:
|
||||
* summary: 批量更新申请状态
|
||||
* tags: [贷款申请]
|
||||
* security:
|
||||
* - bearerAuth: []
|
||||
* requestBody:
|
||||
* required: true
|
||||
* content:
|
||||
* application/json:
|
||||
* schema:
|
||||
* type: object
|
||||
* required:
|
||||
* - ids
|
||||
* - status
|
||||
* properties:
|
||||
* ids:
|
||||
* type: array
|
||||
* items:
|
||||
* type: integer
|
||||
* description: 申请ID数组
|
||||
* status:
|
||||
* type: string
|
||||
* enum: [approved, rejected]
|
||||
* description: 目标状态
|
||||
* responses:
|
||||
* 200:
|
||||
* description: 更新成功
|
||||
* content:
|
||||
* application/json:
|
||||
* schema:
|
||||
* type: object
|
||||
* properties:
|
||||
* success:
|
||||
* type: boolean
|
||||
* message:
|
||||
* type: string
|
||||
* data:
|
||||
* type: object
|
||||
* properties:
|
||||
* updatedCount:
|
||||
* type: integer
|
||||
* status:
|
||||
* type: string
|
||||
* 400:
|
||||
* description: 请求参数错误
|
||||
*/
|
||||
router.put('/batch/status', [
|
||||
body('ids')
|
||||
.isArray({ min: 1 })
|
||||
.withMessage('请选择要操作的申请'),
|
||||
body('status')
|
||||
.isIn(['approved', 'rejected'])
|
||||
.withMessage('状态必须是approved或rejected')
|
||||
], loanApplicationController.batchUpdateStatus);
|
||||
|
||||
/**
|
||||
* @swagger
|
||||
* components:
|
||||
* schemas:
|
||||
* LoanApplication:
|
||||
* type: object
|
||||
* properties:
|
||||
* id:
|
||||
* type: integer
|
||||
* description: 申请ID
|
||||
* applicationNumber:
|
||||
* type: string
|
||||
* description: 申请单号
|
||||
* productName:
|
||||
* type: string
|
||||
* description: 贷款产品名称
|
||||
* farmerName:
|
||||
* type: string
|
||||
* description: 申请养殖户姓名
|
||||
* borrowerName:
|
||||
* type: string
|
||||
* description: 贷款人姓名
|
||||
* borrowerIdNumber:
|
||||
* type: string
|
||||
* description: 贷款人身份证号
|
||||
* assetType:
|
||||
* type: string
|
||||
* description: 生资种类
|
||||
* applicationQuantity:
|
||||
* type: string
|
||||
* description: 申请数量
|
||||
* amount:
|
||||
* type: number
|
||||
* description: 申请额度
|
||||
* status:
|
||||
* type: string
|
||||
* enum: [pending_review, verification_pending, pending_binding, approved, rejected]
|
||||
* description: 申请状态
|
||||
* type:
|
||||
* type: string
|
||||
* enum: [personal, business, mortgage]
|
||||
* description: 申请类型
|
||||
* term:
|
||||
* type: integer
|
||||
* description: 申请期限（月）
|
||||
* interestRate:
|
||||
* type: number
|
||||
* description: 预计利率
|
||||
* phone:
|
||||
* type: string
|
||||
* description: 联系电话
|
||||
* purpose:
|
||||
* type: string
|
||||
* description: 申请用途
|
||||
* remark:
|
||||
* type: string
|
||||
* description: 备注
|
||||
* applicationTime:
|
||||
* type: string
|
||||
* format: date-time
|
||||
* description: 申请时间
|
||||
* approvedTime:
|
||||
* type: string
|
||||
* format: date-time
|
||||
* description: 审批通过时间
|
||||
* rejectedTime:
|
||||
* type: string
|
||||
* format: date-time
|
||||
* description: 审批拒绝时间
|
||||
* auditRecords:
|
||||
* type: array
|
||||
* items:
|
||||
* $ref: '#/components/schemas/AuditRecord'
|
||||
* description: 审核记录
|
||||
* AuditRecord:
|
||||
* type: object
|
||||
* properties:
|
||||
* id:
|
||||
* type: integer
|
||||
* description: 记录ID
|
||||
* action:
|
||||
* type: string
|
||||
* enum: [submit, approve, reject, review, verification, binding]
|
||||
* description: 审核动作
|
||||
* auditor:
|
||||
* type: string
|
||||
* description: 审核人
|
||||
* auditorId:
|
||||
* type: integer
|
||||
* description: 审核人ID
|
||||
* comment:
|
||||
* type: string
|
||||
* description: 审核意见
|
||||
* time:
|
||||
* type: string
|
||||
* format: date-time
|
||||
* description: 审核时间
|
||||
* previousStatus:
|
||||
* type: string
|
||||
* description: 审核前状态
|
||||
* newStatus:
|
||||
* type: string
|
||||
* description: 审核后状态
|
||||
* Pagination:
|
||||
* type: object
|
||||
* properties:
|
||||
* current:
|
||||
* type: integer
|
||||
* description: 当前页码
|
||||
* pageSize:
|
||||
* type: integer
|
||||
* description: 每页数量
|
||||
* total:
|
||||
* type: integer
|
||||
* description: 总记录数
|
||||
* totalPages:
|
||||
* type: integer
|
||||
* description: 总页数
|
||||
*/
|
||||
|
||||
module.exports = router;
|
||||
Reference in New Issue
Block a user