# 银行管理系统后端API接口文档

## 概述

本文档详细描述了银行管理系统后端的所有API接口，包括接口地址、请求方法、参数说明、响应格式等信息。后端基于Node.js + Express.js + Sequelize + MySQL技术栈开发。

## 基础信息

- **基础URL**: `http://localhost:5351`
- **API版本**: v1.0.0
- **认证方式**: JWT Token
- **数据格式**: JSON
- **字符编码**: UTF-8

## 通用响应格式

### 成功响应
```json
{
  "success": true,
  "message": "操作成功",
  "data": {},
  "timestamp": "2024-01-18T10:30:00.000Z"
}
```

### 错误响应
```json
{
  "success": false,
  "message": "错误信息",
  "error": "ERROR_CODE",
  "timestamp": "2024-01-18T10:30:00.000Z"
}
```

## 1. 认证模块 (Authentication)

### 1.1 用户登录
- **接口地址**: `POST /api/auth/login`
- **功能描述**: 用户登录获取访问令牌
- **请求参数**:
  ```json
  {
    "username": "admin",
    "password": "password123"
  }
  ```
- **响应数据**:
  ```json
  {
    "success": true,
    "data": {
      "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
      "user": {
        "id": 1,
        "username": "admin",
        "name": "管理员",
        "role": "admin",
        "email": "admin@bank.com"
      },
      "expiresIn": 86400
    }
  }
  ```

### 1.2 用户登出
- **接口地址**: `POST /api/auth/logout`
- **功能描述**: 用户登出，使令牌失效
- **请求头**: `Authorization: Bearer <token>`

### 1.3 刷新令牌
- **接口地址**: `POST /api/auth/refresh`
- **功能描述**: 刷新访问令牌
- **请求头**: `Authorization: Bearer <token>`

### 1.4 获取当前用户信息
- **接口地址**: `GET /api/auth/me`
- **功能描述**: 获取当前登录用户信息
- **请求头**: `Authorization: Bearer <token>`

## 2. 用户管理模块 (User Management)

### 2.1 获取用户列表
- **接口地址**: `GET /api/users`
- **功能描述**: 分页获取用户列表
- **请求参数**:
  - `page`: 页码 (默认: 1)
  - `pageSize`: 每页数量 (默认: 10)
  - `search`: 搜索关键词
  - `role`: 角色筛选
  - `status`: 状态筛选
- **响应数据**:
  ```json
  {
    "success": true,
    "data": {
      "users": [
        {
          "id": 1,
          "username": "admin",
          "name": "管理员",
          "role": "admin",
          "status": "active",
          "email": "admin@bank.com",
          "createdAt": "2024-01-01T00:00:00.000Z"
        }
      ],
      "pagination": {
        "current": 1,
        "pageSize": 10,
        "total": 100,
        "totalPages": 10
      }
    }
  }
  ```

### 2.2 创建用户
- **接口地址**: `POST /api/users`
- **功能描述**: 创建新用户
- **请求参数**:
  ```json
  {
    "username": "newuser",
    "password": "password123",
    "name": "新用户",
    "role": "teller",
    "email": "newuser@bank.com",
    "phone": "13800138000"
  }
  ```

### 2.3 获取用户详情
- **接口地址**: `GET /api/users/:id`
- **功能描述**: 获取指定用户详细信息

### 2.4 更新用户信息
- **接口地址**: `PUT /api/users/:id`
- **功能描述**: 更新用户信息
- **请求参数**: 同创建用户，所有字段可选

### 2.5 删除用户
- **接口地址**: `DELETE /api/users/:id`
- **功能描述**: 删除用户（软删除）

### 2.6 重置用户密码
- **接口地址**: `POST /api/users/:id/reset-password`
- **功能描述**: 重置用户密码
- **请求参数**:
  ```json
  {
    "newPassword": "newpassword123"
  }
  ```

## 3. 账户管理模块 (Account Management)

### 3.1 获取账户列表
- **接口地址**: `GET /api/accounts`
- **功能描述**: 分页获取账户列表
- **请求参数**:
  - `page`: 页码
  - `pageSize`: 每页数量
  - `search`: 搜索关键词
  - `type`: 账户类型筛选
  - `status`: 状态筛选
  - `userId`: 用户ID筛选
- **响应数据**:
  ```json
  {
    "success": true,
    "data": {
      "accounts": [
        {
          "id": 1,
          "accountNumber": "6225123456789001",
          "name": "张三储蓄账户",
          "type": "savings",
          "status": "active",
          "balance": 10000.50,
          "userId": 1,
          "userName": "张三",
          "createdAt": "2024-01-01T00:00:00.000Z"
        }
      ],
      "pagination": {
        "current": 1,
        "pageSize": 10,
        "total": 100,
        "totalPages": 10
      }
    }
  }
  ```

### 3.2 创建账户
- **接口地址**: `POST /api/accounts`
- **功能描述**: 创建新账户
- **请求参数**:
  ```json
  {
    "name": "新账户",
    "type": "savings",
    "userId": 1,
    "initialBalance": 0,
    "notes": "账户备注"
  }
  ```

### 3.3 获取账户详情
- **接口地址**: `GET /api/accounts/:id`
- **功能描述**: 获取指定账户详细信息

### 3.4 更新账户信息
- **接口地址**: `PUT /api/accounts/:id`
- **功能描述**: 更新账户信息

### 3.5 冻结/解冻账户
- **接口地址**: `POST /api/accounts/:id/toggle-status`
- **功能描述**: 切换账户状态（活跃/冻结）
- **请求参数**:
  ```json
  {
    "status": "frozen" // 或 "active"
  }
  ```

### 3.6 获取账户交易记录
- **接口地址**: `GET /api/accounts/:id/transactions`
- **功能描述**: 获取指定账户的交易记录
- **请求参数**:
  - `page`: 页码
  - `pageSize`: 每页数量
  - `startDate`: 开始日期
  - `endDate`: 结束日期
  - `type`: 交易类型筛选

## 4. 交易管理模块 (Transaction Management)

### 4.1 获取交易列表
- **接口地址**: `GET /api/transactions`
- **功能描述**: 分页获取交易记录列表
- **请求参数**:
  - `page`: 页码
  - `pageSize`: 每页数量
  - `type`: 交易类型筛选
  - `status`: 状态筛选
  - `accountNumber`: 账户号码筛选
  - `startDate`: 开始日期
  - `endDate`: 结束日期
  - `minAmount`: 最小金额
  - `maxAmount`: 最大金额
- **响应数据**:
  ```json
  {
    "success": true,
    "data": {
      "transactions": [
        {
          "id": "T202401180001",
          "type": "deposit",
          "accountNumber": "6225123456789001",
          "accountName": "张三储蓄账户",
          "amount": 5000.00,
          "status": "completed",
          "channel": "counter",
          "description": "现金存款",
          "timestamp": "2024-01-18T09:30:25.000Z"
        }
      ],
      "pagination": {
        "current": 1,
        "pageSize": 10,
        "total": 1000,
        "totalPages": 100
      }
    }
  }
  ```

### 4.2 创建交易
- **接口地址**: `POST /api/transactions`
- **功能描述**: 创建新交易记录
- **请求参数**:
  ```json
  {
    "type": "deposit",
    "accountId": 1,
    "amount": 1000.00,
    "description": "存款描述",
    "channel": "counter"
  }
  ```

### 4.3 获取交易详情
- **接口地址**: `GET /api/transactions/:id`
- **功能描述**: 获取指定交易详细信息

### 4.4 更新交易状态
- **接口地址**: `PUT /api/transactions/:id/status`
- **功能描述**: 更新交易状态
- **请求参数**:
  ```json
  {
    "status": "completed",
    "notes": "处理备注"
  }
  ```

### 4.5 获取交易统计
- **接口地址**: `GET /api/transactions/statistics`
- **功能描述**: 获取交易统计数据
- **请求参数**:
  - `startDate`: 开始日期
  - `endDate`: 结束日期
  - `type`: 交易类型
- **响应数据**:
  ```json
  {
    "success": true,
    "data": {
      "todayCount": 15,
      "todayAmount": 25000.00,
      "monthCount": 342,
      "monthAmount": 1250000.00,
      "typeDistribution": {
        "deposit": 120,
        "withdrawal": 80,
        "transfer": 100,
        "payment": 42
      }
    }
  }
  ```

### 4.6 导出交易数据
- **接口地址**: `POST /api/transactions/export`
- **功能描述**: 导出交易数据为Excel/PDF/CSV格式
- **请求参数**:
  ```json
  {
    "format": "excel",
    "startDate": "2024-01-01",
    "endDate": "2024-01-31",
    "filters": {
      "type": ["deposit", "withdrawal"],
      "status": ["completed"]
    }
  }
  ```

## 5. 贷款管理模块 (Loan Management)

### 5.1 贷款商品管理

#### 5.1.1 获取贷款商品列表
- **接口地址**: `GET /api/loans/products`
- **功能描述**: 获取贷款商品列表
- **请求参数**:
  - `page`: 页码
  - `pageSize`: 每页数量
  - `search`: 搜索关键词
  - `type`: 产品类型筛选
  - `status`: 状态筛选
- **响应数据**:
  ```json
  {
    "success": true,
    "data": {
      "products": [
        {
          "id": 1,
          "name": "个人住房贷款",
          "code": "LOAN-001",
          "type": "mortgage",
          "status": "active",
          "minAmount": 100000,
          "maxAmount": 5000000,
          "minTerm": 12,
          "maxTerm": 360,
          "interestRate": 4.5,
          "maxInterestRate": 6.5,
          "requirements": "年满18周岁，有稳定收入来源",
          "description": "专为个人购房提供的住房抵押贷款产品"
        }
      ],
      "pagination": {
        "current": 1,
        "pageSize": 10,
        "total": 50,
        "totalPages": 5
      }
    }
  }
  ```

#### 5.1.2 创建贷款商品
- **接口地址**: `POST /api/loans/products`
- **功能描述**: 创建新的贷款商品
- **请求参数**:
  ```json
  {
    "name": "个人消费贷款",
    "code": "LOAN-002",
    "type": "personal",
    "minAmount": 10000,
    "maxAmount": 500000,
    "minTerm": 6,
    "maxTerm": 60,
    "interestRate": 6.8,
    "maxInterestRate": 12.5,
    "requirements": "年满18周岁，有稳定收入来源",
    "description": "用于个人消费支出的信用贷款产品"
  }
  ```

#### 5.1.3 更新贷款商品
- **接口地址**: `PUT /api/loans/products/:id`
- **功能描述**: 更新贷款商品信息

#### 5.1.4 删除贷款商品
- **接口地址**: `DELETE /api/loans/products/:id`
- **功能描述**: 删除贷款商品

#### 5.1.5 切换商品状态
- **接口地址**: `POST /api/loans/products/:id/toggle-status`
- **功能描述**: 启用/停用贷款商品

### 5.2 贷款申请管理

#### 5.2.1 获取贷款申请列表
- **接口地址**: `GET /api/loans/applications`
- **功能描述**: 获取贷款申请列表
- **请求参数**:
  - `page`: 页码
  - `pageSize`: 每页数量
  - `search`: 搜索关键词
  - `type`: 申请类型筛选
  - `status`: 状态筛选
  - `startDate`: 开始日期
  - `endDate`: 结束日期
- **响应数据**:
  ```json
  {
    "success": true,
    "data": {
      "applications": [
        {
          "id": 1,
          "applicationNumber": "APP-202401180001",
          "applicantName": "张三",
          "type": "personal",
          "status": "pending",
          "amount": 200000,
          "term": 24,
          "interestRate": 6.5,
          "applicationTime": "2024-01-18T09:30:00.000Z",
          "phone": "13800138000",
          "idCard": "110101199001011234",
          "purpose": "个人消费"
        }
      ],
      "pagination": {
        "current": 1,
        "pageSize": 10,
        "total": 100,
        "totalPages": 10
      }
    }
  }
  ```

#### 5.2.2 创建贷款申请
- **接口地址**: `POST /api/loans/applications`
- **功能描述**: 创建新的贷款申请
- **请求参数**:
  ```json
  {
    "productId": 1,
    "applicantName": "张三",
    "amount": 200000,
    "term": 24,
    "phone": "13800138000",
    "idCard": "110101199001011234",
    "purpose": "个人消费",
    "remark": "申请备注"
  }
  ```

#### 5.2.3 获取申请详情
- **接口地址**: `GET /api/loans/applications/:id`
- **功能描述**: 获取贷款申请详细信息

#### 5.2.4 审核贷款申请
- **接口地址**: `POST /api/loans/applications/:id/audit`
- **功能描述**: 审核贷款申请
- **请求参数**:
  ```json
  {
    "action": "approve", // 或 "reject"
    "comment": "审核意见"
  }
  ```

#### 5.2.5 获取申请审核记录
- **接口地址**: `GET /api/loans/applications/:id/audit-records`
- **功能描述**: 获取申请审核历史记录

### 5.3 贷款合同管理

#### 5.3.1 获取贷款合同列表
- **接口地址**: `GET /api/loans/contracts`
- **功能描述**: 获取贷款合同列表

#### 5.3.2 创建贷款合同
- **接口地址**: `POST /api/loans/contracts`
- **功能描述**: 创建贷款合同

#### 5.3.3 获取合同详情
- **接口地址**: `GET /api/loans/contracts/:id`
- **功能描述**: 获取合同详细信息

#### 5.3.4 更新合同状态
- **接口地址**: `PUT /api/loans/contracts/:id/status`
- **功能描述**: 更新合同状态

### 5.4 贷款解押管理

#### 5.4.1 获取解押申请列表
- **接口地址**: `GET /api/loans/releases`
- **功能描述**: 获取贷款解押申请列表

#### 5.4.2 创建解押申请
- **接口地址**: `POST /api/loans/releases`
- **功能描述**: 创建解押申请

#### 5.4.3 处理解押申请
- **接口地址**: `POST /api/loans/releases/:id/process`
- **功能描述**: 处理解押申请

## 6. 报表统计模块 (Reports)

### 6.1 生成交易报表
- **接口地址**: `POST /api/reports/transactions`
- **功能描述**: 生成交易报表
- **请求参数**:
  ```json
  {
    "startDate": "2024-01-01",
    "endDate": "2024-01-31",
    "transactionTypes": ["deposit", "withdrawal"],
    "format": "excel"
  }
  ```

### 6.2 生成账户报表
- **接口地址**: `POST /api/reports/accounts`
- **功能描述**: 生成账户报表
- **请求参数**:
  ```json
  {
    "endDate": "2024-01-31",
    "accountTypes": ["savings", "checking"],
    "format": "pdf"
  }
  ```

### 6.3 生成用户报表
- **接口地址**: `POST /api/reports/users`
- **功能描述**: 生成用户报表
- **请求参数**:
  ```json
  {
    "roles": ["admin", "manager"],
    "startDate": "2024-01-01",
    "endDate": "2024-01-31",
    "format": "csv"
  }
  ```

### 6.4 获取报表列表
- **接口地址**: `GET /api/reports`
- **功能描述**: 获取已生成的报表列表

### 6.5 下载报表
- **接口地址**: `GET /api/reports/:id/download`
- **功能描述**: 下载指定报表文件

### 6.6 删除报表
- **接口地址**: `DELETE /api/reports/:id`
- **功能描述**: 删除报表文件

## 7. 仪表盘模块 (Dashboard)

### 7.1 获取仪表盘数据
- **接口地址**: `GET /api/dashboard`
- **功能描述**: 获取仪表盘统计数据
- **响应数据**:
  ```json
  {
    "success": true,
    "data": {
      "stats": {
        "totalUsers": 1250,
        "totalAccounts": 3420,
        "todayTransactions": 156,
        "totalAssets": 12500000.50
      },
      "recentTransactions": [
        {
          "id": "T202401180001",
          "type": "deposit",
          "amount": 5000.00,
          "accountNumber": "6225123456789001",
          "timestamp": "2024-01-18T09:30:25.000Z"
        }
      ],
      "systemInfo": {
        "uptime": "5天12小时",
        "lastUpdate": "2024-01-18T10:30:00.000Z"
      }
    }
  }
  ```

### 7.2 获取图表数据
- **接口地址**: `GET /api/dashboard/charts`
- **功能描述**: 获取仪表盘图表数据
- **请求参数**:
  - `type`: 图表类型 (transaction-trend, account-distribution)
  - `period`: 时间周期 (7d, 30d, 90d)

## 8. 项目管理模块 (Project Management)

### 8.1 获取项目列表
- **接口地址**: `GET /api/projects`
- **功能描述**: 获取项目列表
- **请求参数**:
  - `page`: 页码
  - `pageSize`: 每页数量
  - `search`: 搜索关键词
  - `status`: 状态筛选
  - `priority`: 优先级筛选
- **响应数据**:
  ```json
  {
    "success": true,
    "data": {
      "projects": [
        {
          "id": 1,
          "name": "核心银行系统升级",
          "code": "PRJ-001",
          "status": "active",
          "priority": "high",
          "manager": "张三",
          "progress": 75,
          "startDate": "2024-01-01",
          "endDate": "2024-06-30",
          "description": "升级核心银行系统，提升性能和安全性"
        }
      ],
      "pagination": {
        "current": 1,
        "pageSize": 10,
        "total": 50,
        "totalPages": 5
      }
    }
  }
  ```

### 8.2 创建项目
- **接口地址**: `POST /api/projects`
- **功能描述**: 创建新项目

### 8.3 更新项目
- **接口地址**: `PUT /api/projects/:id`
- **功能描述**: 更新项目信息

### 8.4 删除项目
- **接口地址**: `DELETE /api/projects/:id`
- **功能描述**: 删除项目

## 9. 系统检查模块 (System Check)

### 9.1 获取检查项目列表
- **接口地址**: `GET /api/system/check-items`
- **功能描述**: 获取系统检查项目列表

### 9.2 执行系统检查
- **接口地址**: `POST /api/system/check`
- **功能描述**: 执行系统健康检查

### 9.3 获取检查历史
- **接口地址**: `GET /api/system/check-history`
- **功能描述**: 获取系统检查历史记录

### 9.4 获取系统状态
- **接口地址**: `GET /api/system/status`
- **功能描述**: 获取系统运行状态

## 10. 市场行情模块 (Market Trends)

### 10.1 获取市场数据
- **接口地址**: `GET /api/market/data`
- **功能描述**: 获取实时市场数据
- **响应数据**:
  ```json
  {
    "success": true,
    "data": {
      "shanghaiIndex": 3245.67,
      "shanghaiIndexChange": 1.25,
      "shenzhenIndex": 12345.89,
      "shenzhenIndexChange": -0.85,
      "chinextIndex": 2567.34,
      "chinextIndexChange": 2.15,
      "exchangeRate": 7.2345,
      "exchangeRateChange": -0.12
    }
  }
  ```

### 10.2 获取银行股行情
- **接口地址**: `GET /api/market/bank-stocks`
- **功能描述**: 获取银行股票行情

### 10.3 获取市场新闻
- **接口地址**: `GET /api/market/news`
- **功能描述**: 获取市场新闻

## 11. 硬件管理模块 (Hardware Management)

### 11.1 获取设备列表
- **接口地址**: `GET /api/hardware/devices`
- **功能描述**: 获取硬件设备列表
- **请求参数**:
  - `page`: 页码
  - `pageSize`: 每页数量
  - `search`: 搜索关键词
  - `type`: 设备类型筛选
  - `status`: 状态筛选
  - `location`: 位置筛选

### 11.2 创建设备
- **接口地址**: `POST /api/hardware/devices`
- **功能描述**: 添加新设备

### 11.3 更新设备
- **接口地址**: `PUT /api/hardware/devices/:id`
- **功能描述**: 更新设备信息

### 11.4 删除设备
- **接口地址**: `DELETE /api/hardware/devices/:id`
- **功能描述**: 删除设备

### 11.5 设备检查
- **接口地址**: `POST /api/hardware/devices/:id/check`
- **功能描述**: 执行设备检查

### 11.6 设备维护
- **接口地址**: `POST /api/hardware/devices/:id/maintenance`
- **功能描述**: 设置设备维护状态

## 12. 员工管理模块 (Employee Management)

### 12.1 获取员工列表
- **接口地址**: `GET /api/employees`
- **功能描述**: 获取员工列表
- **请求参数**:
  - `page`: 页码
  - `pageSize`: 每页数量
  - `search`: 搜索关键词
  - `status`: 状态筛选
  - `department`: 部门筛选
  - `position`: 职位筛选

### 12.2 创建员工
- **接口地址**: `POST /api/employees`
- **功能描述**: 添加新员工

### 12.3 更新员工
- **接口地址**: `PUT /api/employees/:id`
- **功能描述**: 更新员工信息

### 12.4 删除员工
- **接口地址**: `DELETE /api/employees/:id`
- **功能描述**: 删除员工

### 12.5 切换员工状态
- **接口地址**: `POST /api/employees/:id/toggle-status`
- **功能描述**: 切换员工在职/离职状态

### 12.6 导出员工数据
- **接口地址**: `POST /api/employees/export`
- **功能描述**: 导出员工数据

## 13. 贷款解押模块 (Loan Release)

### 13.1 获取解押申请列表
- **接口地址**: `GET /api/loan-releases`
- **功能描述**: 获取贷款解押申请列表，支持分页和搜索
- **请求参数**:
  - `page` (integer, optional): 页码，默认1
  - `pageSize` (integer, optional): 每页数量，默认10
  - `searchField` (string, optional): 搜索字段 (application_number, customer_name, product_name)
  - `searchValue` (string, optional): 搜索值
  - `status` (string, optional): 解押状态筛选
  - `sortField` (string, optional): 排序字段
  - `sortOrder` (string, optional): 排序方向
- **响应数据**:
  ```json
  {
    "success": true,
    "data": {
      "releases": [
        {
          "id": 1,
          "applicationNumber": "20240227145555918",
          "productName": "中国工商银行扎旗支行\"畜禽活体抵押\"",
          "farmerName": "刘超",
          "applicantName": "刘超",
          "applicantIdNumber": "511123199001013017",
          "applicantPhone": "13800138000",
          "assetType": "牛",
          "releaseQuantity": "10头",
          "releaseAmount": 10000,
          "status": "released",
          "applicationTime": "2024-02-27T06:55:55.000Z",
          "processTime": "2024-02-27T07:30:00.000Z",
          "completeTime": "2024-02-27T08:00:00.000Z",
          "processorName": "系统管理员",
          "processComment": "审核通过，同意解押",
          "rejectionReason": null,
          "remark": "客户信用良好",
          "created_at": "2025-09-26T03:38:50.000Z",
          "updated_at": "2025-09-26T03:38:50.000Z"
        }
      ],
      "pagination": {
        "current": 1,
        "pageSize": 10,
        "total": 6,
        "totalPages": 1
      }
    }
  }
  ```

### 13.2 获取解押申请详情
- **接口地址**: `GET /api/loan-releases/:id`
- **功能描述**: 获取指定解押申请的详细信息
- **路径参数**:
  - `id` (integer, required): 解押申请ID
- **响应数据**:
  ```json
  {
    "success": true,
    "data": {
      "id": 1,
      "releaseNumber": "20240227145555918",
      "customerName": "刘超",
      "contractNumber": "CONTRACT-000007",
      "status": "released",
      "collateralType": "livestock",
      "collateralDescription": "优质肉牛",
      "loanAmount": 100000,
      "collateralValue": 150000,
      "applicationTime": "2024-02-27T06:55:55.000Z",
      "processTime": "2024-02-27T07:30:00.000Z",
      "completeTime": "2024-02-27T08:00:00.000Z",
      "phone": "13800138000",
      "idCard": "511123199001013017",
      "reason": "需要资金周转，申请部分解押",
      "remark": "客户信用良好",
      "history": [
        {
          "id": 1,
          "action": "apply",
          "operator": "刘超",
          "time": "2025-09-26T03:38:51.000Z",
          "comment": "提交解押申请"
        },
        {
          "id": 2,
          "action": "complete",
          "operator": "系统管理员",
          "time": "2025-09-26T03:38:51.000Z",
          "comment": "解押手续办理完成"
        }
      ]
    }
  }
  ```

### 13.3 创建解押申请
- **接口地址**: `POST /api/loan-releases`
- **功能描述**: 创建新的解押申请
- **请求参数**:
  ```json
  {
    "contract_id": 1,
    "customer_name": "测试用户",
    "customer_phone": "13800138000",
    "customer_id_card": "511123199001010001",
    "farmer_name": "测试用户",
    "product_name": "测试产品",
    "collateral_type": "livestock",
    "collateral_description": "测试抵押物",
    "collateral_value": 100000,
    "loan_amount": 80000,
    "release_amount": 50000,
    "release_quantity": "5头",
    "application_reason": "测试解押申请",
    "remark": "测试备注"
  }
  ```
- **响应数据**:
  ```json
  {
    "success": true,
    "message": "解押申请创建成功",
    "data": {
      "id": 13,
      "applicationNumber": "REL-1758868323652"
    }
  }
  ```

### 13.4 更新解押申请
- **接口地址**: `PUT /api/loan-releases/:id`
- **功能描述**: 更新指定解押申请信息
- **路径参数**:
  - `id` (integer, required): 解押申请ID
- **请求参数**: 同创建解押申请参数
- **响应数据**:
  ```json
  {
    "success": true,
    "message": "解押申请更新成功"
  }
  ```

### 13.5 处理解押申请
- **接口地址**: `POST /api/loan-releases/:id/process`
- **功能描述**: 处理解押申请（通过/拒绝）
- **路径参数**:
  - `id` (integer, required): 解押申请ID
- **请求参数**:
  ```json
  {
    "action": "approve",
    "comment": "审核通过",
    "remark": "测试处理"
  }
  ```
- **响应数据**:
  ```json
  {
    "success": true,
    "message": "解押申请已通过",
    "data": {
      "id": 13,
      "status": "approved",
      "action": "approve",
      "comment": "审核通过"
    }
  }
  ```

### 13.6 完成解押
- **接口地址**: `POST /api/loan-releases/:id/complete`
- **功能描述**: 完成解押手续
- **路径参数**:
  - `id` (integer, required): 解押申请ID
- **请求参数**:
  ```json
  {
    "comment": "解押手续办理完成"
  }
  ```
- **响应数据**:
  ```json
  {
    "success": true,
    "message": "解押完成",
    "data": {
      "id": 13,
      "status": "completed"
    }
  }
  ```

### 13.7 删除解押申请
- **接口地址**: `DELETE /api/loan-releases/:id`
- **功能描述**: 删除指定解押申请（仅限待处理状态）
- **路径参数**:
  - `id` (integer, required): 解押申请ID
- **响应数据**:
  ```json
  {
    "success": true,
    "message": "解押申请删除成功"
  }
  ```

### 13.8 获取解押统计信息
- **接口地址**: `GET /api/loan-releases/stats`
- **功能描述**: 获取解押申请统计信息
- **响应数据**:
  ```json
  {
    "success": true,
    "data": {
      "total": 6,
      "pending": 0,
      "processing": 0,
      "completed": 6,
      "statusStats": [
        {
          "status": "released",
          "count": 6
        }
      ]
    }
  }
  ```

## 14. 个人中心模块 (Profile)

### 14.1 获取个人信息
- **接口地址**: `GET /api/profile`
- **功能描述**: 获取当前用户个人信息

### 14.2 更新个人信息
- **接口地址**: `PUT /api/profile`
- **功能描述**: 更新个人信息

### 14.3 修改密码
- **接口地址**: `POST /api/profile/change-password`
- **功能描述**: 修改用户密码
- **请求参数**:
  ```json
  {
    "oldPassword": "oldpassword123",
    "newPassword": "newpassword123"
  }
  ```

### 14.4 更新头像
- **接口地址**: `POST /api/profile/avatar`
- **功能描述**: 更新用户头像
- **请求类型**: `multipart/form-data`

### 14.5 获取通知列表
- **接口地址**: `GET /api/profile/notifications`
- **功能描述**: 获取用户通知列表

### 14.6 标记通知已读
- **接口地址**: `PUT /api/profile/notifications/:id/read`
- **功能描述**: 标记通知为已读

## 15. 系统设置模块 (Settings)

### 15.1 获取系统设置
- **接口地址**: `GET /api/settings`
- **功能描述**: 获取系统配置设置

### 15.2 更新基本设置
- **接口地址**: `PUT /api/settings/basic`
- **功能描述**: 更新系统基本设置

### 15.3 更新安全设置
- **接口地址**: `PUT /api/settings/security`
- **功能描述**: 更新安全相关设置

### 15.4 获取系统日志
- **接口地址**: `GET /api/settings/logs`
- **功能描述**: 获取系统操作日志

### 15.5 备份系统数据
- **接口地址**: `POST /api/settings/backup`
- **功能描述**: 备份系统数据

### 15.6 恢复系统数据
- **接口地址**: `POST /api/settings/restore`
- **功能描述**: 恢复系统数据

## 16. 文件上传模块 (File Upload)

### 16.1 上传文件
- **接口地址**: `POST /api/upload`
- **功能描述**: 上传文件
- **请求类型**: `multipart/form-data`
- **请求参数**:
  - `file`: 文件
  - `type`: 文件类型 (avatar, document, image)

### 16.2 删除文件
- **接口地址**: `DELETE /api/upload/:id`
- **功能描述**: 删除已上传的文件

## 17. 健康检查模块 (Health Check)

### 17.1 系统健康检查
- **接口地址**: `GET /api/health`
- **功能描述**: 检查系统健康状态
- **响应数据**:
  ```json
  {
    "success": true,
    "data": {
      "status": "healthy",
      "timestamp": "2024-01-18T10:30:00.000Z",
      "services": {
        "database": "healthy",
        "redis": "healthy",
        "api": "healthy"
      }
    }
  }
  ```

## 错误码说明

| 错误码 | 说明 |
|--------|------|
| 400 | 请求参数错误 |
| 401 | 未授权访问 |
| 403 | 禁止访问 |
| 404 | 资源不存在 |
| 409 | 资源冲突 |
| 422 | 数据验证失败 |
| 500 | 服务器内部错误 |

## 认证说明

所有需要认证的接口都需要在请求头中携带JWT令牌：

```
Authorization: Bearer <your-jwt-token>
```

## 分页说明

所有列表接口都支持分页，通用参数：

- `page`: 页码，从1开始
- `pageSize`: 每页数量，默认10，最大100
- `sortField`: 排序字段
- `sortOrder`: 排序方向 (asc/desc)

## 搜索说明

支持搜索的接口通用参数：

- `search`: 搜索关键词，支持模糊匹配
- `startDate`: 开始日期 (YYYY-MM-DD)
- `endDate`: 结束日期 (YYYY-MM-DD)

## 数据验证

所有接口都包含数据验证，验证规则：

- 必填字段不能为空
- 邮箱格式验证
- 手机号格式验证
- 身份证号格式验证
- 金额格式验证
- 日期格式验证

## 响应时间

- 简单查询: < 100ms
- 复杂查询: < 500ms
- 数据导出: < 5s
- 文件上传: 根据文件大小

## 限流说明

- 普通接口: 100次/分钟
- 登录接口: 10次/分钟
- 文件上传: 20次/分钟
- 数据导出: 5次/分钟

---

**文档版本**: v1.1.0  
**最后更新**: 2025-09-26  
**维护人员**: 开发团队

