Compare commits
1 Commits
master
...
4ce4a717db
| Author | SHA1 | Date | |
|---|---|---|---|
| 4ce4a717db |
@@ -99,10 +99,7 @@
|
||||
"Bash(git -C \"D:\\\\ccdi\\\\ccdi\" status --short)",
|
||||
"Bash(git -C \"D:\\\\ccdi\\\\ccdi\" add \"doc/plans/2025-02-08-intermediary-import-history-cleanup.md\" \"doc/reports/2026-02-08-intermediary-import-history-cleanup-completion.md\")",
|
||||
"Bash(git -C \"D:\\\\ccdi\\\\ccdi\" commit -m \"$\\(cat <<''EOF''\ndocs: 添加中介导入历史清除功能完成报告\n\n- 添加功能设计文档\n- 添加功能完成总结报告\n- 包含代码审查结果和后续优化建议\n\nCo-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>\nEOF\n\\)\")",
|
||||
"Bash(git -C \"D:\\\\ccdi\\\\ccdi\" log --oneline -5)",
|
||||
"Bash([:*)",
|
||||
"Bash([ -d modules ])",
|
||||
"Bash([ -d test-data ])"
|
||||
"Bash(git -C \"D:\\\\ccdi\\\\ccdi\" log --oneline -5)"
|
||||
]
|
||||
},
|
||||
"enabledMcpjsonServers": [
|
||||
|
||||
@@ -1,124 +0,0 @@
|
||||
# 员工信息导入相关接口文档
|
||||
|
||||
## 1. 导入员工信息(异步)
|
||||
|
||||
**接口地址:** `POST /ccdi/employee/importData`
|
||||
|
||||
**权限标识:** `ccdi:employee:import`
|
||||
|
||||
**请求参数:**
|
||||
|
||||
| 参数名 | 类型 | 必填 | 说明 |
|
||||
|--------|------|------|------|
|
||||
| file | File | 是 | Excel文件 |
|
||||
| updateSupport | boolean | 否 | 是否更新已存在的数据,默认false |
|
||||
|
||||
**响应示例:**
|
||||
|
||||
```json
|
||||
{
|
||||
"code": 200,
|
||||
"msg": "导入任务已提交,正在后台处理",
|
||||
"data": {
|
||||
"taskId": "uuid-string",
|
||||
"status": "PROCESSING",
|
||||
"message": "导入任务已提交,正在后台处理"
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
## 2. 查询导入状态
|
||||
|
||||
**接口地址:** `GET /ccdi/employee/importStatus/{taskId}`
|
||||
|
||||
**权限标识:** 无
|
||||
|
||||
**路径参数:**
|
||||
|
||||
| 参数名 | 类型 | 必填 | 说明 |
|
||||
|--------|------|------|------|
|
||||
| taskId | String | 是 | 任务ID |
|
||||
|
||||
**响应示例:**
|
||||
|
||||
```json
|
||||
{
|
||||
"code": 200,
|
||||
"data": {
|
||||
"taskId": "uuid-string",
|
||||
"status": "SUCCESS",
|
||||
"totalCount": 100,
|
||||
"successCount": 95,
|
||||
"failureCount": 5,
|
||||
"progress": 100,
|
||||
"startTime": 1707225600000,
|
||||
"endTime": 1707225900000,
|
||||
"message": "导入完成"
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
**状态说明:**
|
||||
|
||||
| 状态值 | 说明 |
|
||||
|--------|------|
|
||||
| PROCESSING | 处理中 |
|
||||
| SUCCESS | 全部成功 |
|
||||
| PARTIAL_SUCCESS | 部分成功 |
|
||||
| FAILED | 全部失败 |
|
||||
|
||||
## 3. 查询导入失败记录
|
||||
|
||||
**接口地址:** `GET /ccdi/employee/importFailures/{taskId}`
|
||||
|
||||
**权限标识:** 无
|
||||
|
||||
**路径参数:**
|
||||
|
||||
| 参数名 | 类型 | 必填 | 说明 |
|
||||
|--------|------|------|------|
|
||||
| taskId | String | 是 | 任务ID |
|
||||
|
||||
**查询参数:**
|
||||
|
||||
| 参数名 | 类型 | 必填 | 说明 |
|
||||
|--------|------|------|------|
|
||||
| pageNum | Integer | 否 | 页码,默认1 |
|
||||
| pageSize | Integer | 否 | 每页条数,默认10 |
|
||||
|
||||
**响应示例:**
|
||||
|
||||
```json
|
||||
{
|
||||
"code": 200,
|
||||
"rows": [
|
||||
{
|
||||
"employeeId": "1234567",
|
||||
"name": "张三",
|
||||
"idCard": "110101199001011234",
|
||||
"deptId": 100,
|
||||
"phone": "13800138000",
|
||||
"status": "0",
|
||||
"hireDate": "2020-01-01",
|
||||
"errorMessage": "身份证号格式错误"
|
||||
}
|
||||
],
|
||||
"total": 5
|
||||
}
|
||||
```
|
||||
|
||||
## 使用流程
|
||||
|
||||
1. 前端调用导入接口上传Excel文件
|
||||
2. 后端立即返回taskId
|
||||
3. 前端每2秒轮询查询导入状态
|
||||
4. 导入完成后显示结果
|
||||
5. 如有失败,显示"查看导入失败记录"按钮
|
||||
6. 用户点击按钮查看失败记录详情
|
||||
|
||||
## 注意事项
|
||||
|
||||
1. Redis中存储的导入状态和失败记录保留7天
|
||||
2. taskId如果过期或不存在,查询接口会返回错误
|
||||
3. 导入是异步处理,大量数据导入不会阻塞HTTP请求
|
||||
4. 失败记录只保存失败的数据,成功的数据不会存储
|
||||
@@ -1,790 +0,0 @@
|
||||
# 采购交易信息管理 - API接口文档
|
||||
|
||||
## 文档信息
|
||||
- **模块名称**: 采购交易信息管理
|
||||
- **Controller**: `CcdiPurchaseTransactionController`
|
||||
- **Base Path**: `/ccdi/purchaseTransaction`
|
||||
- **Swagger**: http://localhost:8080/swagger-ui/index.html
|
||||
- **生成时间**: 2026-02-06
|
||||
|
||||
---
|
||||
|
||||
## 目录
|
||||
1. [接口列表](#接口列表)
|
||||
2. [接口详情](#接口详情)
|
||||
3. [数据模型](#数据模型)
|
||||
4. [错误码说明](#错误码说明)
|
||||
5. [接口示例](#接口示例)
|
||||
|
||||
---
|
||||
|
||||
## 接口列表
|
||||
|
||||
| 序号 | 接口名称 | HTTP方法 | 路径 | 权限标识 | 说明 |
|
||||
|------|---------|----------|------|----------|------|
|
||||
| 1 | 查询采购交易列表 | GET | /list | ccdi:purchaseTransaction:list | 分页查询采购交易信息 |
|
||||
| 2 | 获取采购交易详情 | GET | /{purchaseId} | ccdi:purchaseTransaction:query | 根据ID获取详细信息 |
|
||||
| 3 | 新增采购交易 | POST | / | ccdi:purchaseTransaction:add | 新增采购交易记录 |
|
||||
| 4 | 修改采购交易 | PUT | / | ccdi:purchaseTransaction:edit | 修改采购交易记录 |
|
||||
| 5 | 删除采购交易 | DELETE | /{purchaseIds} | ccdi:purchaseTransaction:remove | 删除采购交易记录 |
|
||||
| 6 | 导出采购交易 | POST | /export | ccdi:purchaseTransaction:export | 导出Excel文件 |
|
||||
| 7 | 下载导入模板 | POST | /importTemplate | 无 | 下载带下拉框的模板 |
|
||||
| 8 | 导入采购交易 | POST | /importData | ccdi:purchaseTransaction:import | 异步导入Excel数据 |
|
||||
| 9 | 查询导入状态 | GET | /importStatus/{taskId} | ccdi:purchaseTransaction:import | 查询异步导入进度 |
|
||||
| 10 | 查询导入失败记录 | GET | /importFailures/{taskId} | ccdi:purchaseTransaction:import | 查询导入失败详情 |
|
||||
|
||||
---
|
||||
|
||||
## 接口详情
|
||||
|
||||
### 1. 查询采购交易列表
|
||||
|
||||
**接口描述**: 分页查询采购交易信息列表，支持多条件查询
|
||||
|
||||
**请求方式**: `GET`
|
||||
|
||||
**请求路径**: `/ccdi/purchaseTransaction/list`
|
||||
|
||||
**权限要求**: `ccdi:purchaseTransaction:list`
|
||||
|
||||
**请求参数**:
|
||||
|
||||
| 参数名 | 类型 | 必填 | 说明 | 示例值 |
|
||||
|--------|------|------|------|--------|
|
||||
| pageNum | Integer | 否 | 页码，默认1 | 1 |
|
||||
| pageSize | Integer | 否 | 每页条数，默认10 | 10 |
|
||||
| projectName | String | 否 | 项目名称（模糊查询） | 办公设备采购 |
|
||||
| subjectName | String | 否 | 标的物名称（模糊查询） | 电脑 |
|
||||
| applicantName | String | 否 | 申请人姓名（模糊查询） | 张三 |
|
||||
| params[beginApplyDate] | String | 否 | 申请日期起始 | 2025-01-01 |
|
||||
| params[endApplyDate] | String | 否 | 申请日期结束 | 2025-12-31 |
|
||||
|
||||
**响应示例**:
|
||||
```json
|
||||
{
|
||||
"code": 200,
|
||||
"msg": "查询成功",
|
||||
"rows": [
|
||||
{
|
||||
"purchaseId": "PO20250206001",
|
||||
"purchaseCategory": "货物类",
|
||||
"projectName": "办公设备采购项目",
|
||||
"subjectName": "笔记本电脑",
|
||||
"subjectDesc": "高性能办公笔记本",
|
||||
"purchaseQty": 50.00,
|
||||
"budgetAmount": 500000.00,
|
||||
"bidAmount": 450000.00,
|
||||
"actualAmount": 455000.00,
|
||||
"contractAmount": 450000.00,
|
||||
"settlementAmount": 455000.00,
|
||||
"purchaseMethod": "公开招标",
|
||||
"supplierName": "某某科技有限公司",
|
||||
"contactPerson": "李四",
|
||||
"contactPhone": "13800138000",
|
||||
"supplierUscc": "91110000MA000000XX",
|
||||
"supplierBankAccount": "1234567890123456789",
|
||||
"applyDate": "2025-01-01",
|
||||
"planApproveDate": "2025-01-05",
|
||||
"announceDate": "2025-01-10",
|
||||
"bidOpenDate": "2025-01-15",
|
||||
"contractSignDate": "2025-01-20",
|
||||
"expectedDeliveryDate": "2025-02-01",
|
||||
"actualDeliveryDate": "2025-02-01",
|
||||
"acceptanceDate": "2025-02-05",
|
||||
"settlementDate": "2025-02-10",
|
||||
"applicantId": "E001001",
|
||||
"applicantName": "张三",
|
||||
"applyDepartment": "信息技术部",
|
||||
"purchaseLeaderId": "E002001",
|
||||
"purchaseLeaderName": "王五",
|
||||
"purchaseDepartment": "采购部",
|
||||
"createTime": "2025-02-06 10:00:00",
|
||||
"updateTime": "2025-02-06 10:00:00",
|
||||
"createdBy": "admin",
|
||||
"updatedBy": "admin"
|
||||
}
|
||||
],
|
||||
"total": 100
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 2. 获取采购交易详情
|
||||
|
||||
**接口描述**: 根据采购事项ID获取详细信息
|
||||
|
||||
**请求方式**: `GET`
|
||||
|
||||
**请求路径**: `/ccdi/purchaseTransaction/{purchaseId}`
|
||||
|
||||
**权限要求**: `ccdi:purchaseTransaction:query`
|
||||
|
||||
**路径参数**:
|
||||
|
||||
| 参数名 | 类型 | 必填 | 说明 | 示例值 |
|
||||
|--------|------|------|------|--------|
|
||||
| purchaseId | String | 是 | 采购事项ID | PO20250206001 |
|
||||
|
||||
**响应示例**:
|
||||
```json
|
||||
{
|
||||
"code": 200,
|
||||
"msg": "操作成功",
|
||||
"data": {
|
||||
"purchaseId": "PO20250206001",
|
||||
"purchaseCategory": "货物类",
|
||||
"projectName": "办公设备采购项目",
|
||||
"subjectName": "笔记本电脑",
|
||||
"subjectDesc": "高性能办公笔记本",
|
||||
"purchaseQty": 50.00,
|
||||
"budgetAmount": 500000.00,
|
||||
"bidAmount": 450000.00,
|
||||
"actualAmount": 455000.00,
|
||||
"contractAmount": 450000.00,
|
||||
"settlementAmount": 455000.00,
|
||||
"purchaseMethod": "公开招标",
|
||||
"supplierName": "某某科技有限公司",
|
||||
"contactPerson": "李四",
|
||||
"contactPhone": "13800138000",
|
||||
"supplierUscc": "91110000MA000000XX",
|
||||
"supplierBankAccount": "1234567890123456789",
|
||||
"applyDate": "2025-01-01",
|
||||
"planApproveDate": "2025-01-05",
|
||||
"announceDate": "2025-01-10",
|
||||
"bidOpenDate": "2025-01-15",
|
||||
"contractSignDate": "2025-01-20",
|
||||
"expectedDeliveryDate": "2025-02-01",
|
||||
"actualDeliveryDate": "2025-02-01",
|
||||
"acceptanceDate": "2025-02-05",
|
||||
"settlementDate": "2025-02-10",
|
||||
"applicantId": "E001001",
|
||||
"applicantName": "张三",
|
||||
"applyDepartment": "信息技术部",
|
||||
"purchaseLeaderId": "E002001",
|
||||
"purchaseLeaderName": "王五",
|
||||
"purchaseDepartment": "采购部",
|
||||
"createTime": "2025-02-06 10:00:00",
|
||||
"updateTime": "2025-02-06 10:00:00",
|
||||
"createdBy": "admin",
|
||||
"updatedBy": "admin"
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 3. 新增采购交易
|
||||
|
||||
**接口描述**: 新增采购交易记录
|
||||
|
||||
**请求方式**: `POST`
|
||||
|
||||
**请求路径**: `/ccdi/purchaseTransaction`
|
||||
|
||||
**权限要求**: `ccdi:purchaseTransaction:add`
|
||||
|
||||
**请求头**:
|
||||
```
|
||||
Content-Type: application/json
|
||||
Authorization: Bearer {token}
|
||||
```
|
||||
|
||||
**请求体** (`CcdiPurchaseTransactionAddDTO`):
|
||||
|
||||
| 参数名 | 类型 | 必填 | 说明 | 示例值 |
|
||||
|--------|------|------|------|--------|
|
||||
| purchaseId | String | 是 | 采购事项ID（最大32字符） | PO20250206001 |
|
||||
| purchaseCategory | String | 否 | 采购类别（最大50字符） | 货物类 |
|
||||
| projectName | String | 否 | 项目名称（最大200字符） | 办公设备采购项目 |
|
||||
| subjectName | String | 否 | 标的物名称（最大200字符） | 笔记本电脑 |
|
||||
| subjectDesc | String | 否 | 标的物描述（最大500字符） | 高性能办公笔记本 |
|
||||
| purchaseQty | BigDecimal | 否 | 采购数量 | 50.00 |
|
||||
| budgetAmount | BigDecimal | 否 | 预算金额 | 500000.00 |
|
||||
| bidAmount | BigDecimal | 否 | 中标金额 | 450000.00 |
|
||||
| actualAmount | BigDecimal | 否 | 实际采购金额 | 455000.00 |
|
||||
| contractAmount | BigDecimal | 否 | 合同金额 | 450000.00 |
|
||||
| settlementAmount | BigDecimal | 否 | 结算金额 | 455000.00 |
|
||||
| purchaseMethod | String | 否 | 采购方式（最大50字符） | 公开招标 |
|
||||
| supplierName | String | 否 | 供应商名称（最大200字符） | 某某科技有限公司 |
|
||||
| supplierUscc | String | 否 | 供应商统一信用代码（最大18字符） | 91110000MA000000XX |
|
||||
| contactPerson | String | 否 | 供应商联系人（最大50字符） | 李四 |
|
||||
| contactPhone | String | 否 | 供应商联系电话（最大20字符） | 13800138000 |
|
||||
| supplierBankAccount | String | 否 | 供应商银行账户（最大50字符） | 1234567890123456789 |
|
||||
| applyDate | String | 否 | 采购申请日期（yyyy-MM-dd） | 2025-01-01 |
|
||||
| planApproveDate | String | 否 | 采购计划批准日期（yyyy-MM-dd） | 2025-01-05 |
|
||||
| announceDate | String | 否 | 采购公告发布日期（yyyy-MM-dd） | 2025-01-10 |
|
||||
| bidOpenDate | String | 否 | 开标日期（yyyy-MM-dd） | 2025-01-15 |
|
||||
| contractSignDate | String | 否 | 合同签订日期（yyyy-MM-dd） | 2025-01-20 |
|
||||
| expectedDeliveryDate | String | 否 | 预计交货日期（yyyy-MM-dd） | 2025-02-01 |
|
||||
| actualDeliveryDate | String | 否 | 实际交货日期（yyyy-MM-dd） | 2025-02-01 |
|
||||
| acceptanceDate | String | 否 | 验收日期（yyyy-MM-dd） | 2025-02-05 |
|
||||
| settlementDate | String | 否 | 结算日期（yyyy-MM-dd） | 2025-02-10 |
|
||||
| applicantId | String | 否 | 申请人工号（最大20字符） | E001001 |
|
||||
| applicantName | String | 否 | 申请人姓名（最大50字符） | 张三 |
|
||||
| applyDepartment | String | 否 | 申请部门（最大100字符） | 信息技术部 |
|
||||
| purchaseLeaderId | String | 否 | 采购负责人工号（最大20字符） | E002001 |
|
||||
| purchaseLeaderName | String | 否 | 采购负责人姓名（最大50字符） | 王五 |
|
||||
| purchaseDepartment | String | 否 | 采购部门（最大100字符） | 采购部 |
|
||||
|
||||
**请求示例**:
|
||||
```json
|
||||
{
|
||||
"purchaseId": "PO20250206001",
|
||||
"purchaseCategory": "货物类",
|
||||
"projectName": "办公设备采购项目",
|
||||
"subjectName": "笔记本电脑",
|
||||
"subjectDesc": "高性能办公笔记本",
|
||||
"purchaseQty": 50.00,
|
||||
"budgetAmount": 500000.00,
|
||||
"bidAmount": 450000.00,
|
||||
"actualAmount": 455000.00,
|
||||
"contractAmount": 450000.00,
|
||||
"settlementAmount": 455000.00,
|
||||
"purchaseMethod": "公开招标",
|
||||
"supplierName": "某某科技有限公司",
|
||||
"supplierUscc": "91110000MA000000XX",
|
||||
"contactPerson": "李四",
|
||||
"contactPhone": "13800138000",
|
||||
"supplierBankAccount": "1234567890123456789",
|
||||
"applyDate": "2025-01-01",
|
||||
"planApproveDate": "2025-01-05",
|
||||
"announceDate": "2025-01-10",
|
||||
"bidOpenDate": "2025-01-15",
|
||||
"contractSignDate": "2025-01-20",
|
||||
"expectedDeliveryDate": "2025-02-01",
|
||||
"actualDeliveryDate": "2025-02-01",
|
||||
"acceptanceDate": "2025-02-05",
|
||||
"settlementDate": "2025-02-10",
|
||||
"applicantId": "E001001",
|
||||
"applicantName": "张三",
|
||||
"applyDepartment": "信息技术部",
|
||||
"purchaseLeaderId": "E002001",
|
||||
"purchaseLeaderName": "王五",
|
||||
"purchaseDepartment": "采购部"
|
||||
}
|
||||
```
|
||||
|
||||
**响应示例**:
|
||||
```json
|
||||
{
|
||||
"code": 200,
|
||||
"msg": "操作成功"
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 4. 修改采购交易
|
||||
|
||||
**接口描述**: 修改采购交易记录
|
||||
|
||||
**请求方式**: `PUT`
|
||||
|
||||
**请求路径**: `/ccdi/purchaseTransaction`
|
||||
|
||||
**权限要求**: `ccdi:purchaseTransaction:edit`
|
||||
|
||||
**请求头**:
|
||||
```
|
||||
Content-Type: application/json
|
||||
Authorization: Bearer {token}
|
||||
```
|
||||
|
||||
**请求体** (`CcdiPurchaseTransactionEditDTO`):
|
||||
|
||||
参数同新增接口，但purchaseId为必填且不可修改。
|
||||
|
||||
**响应示例**:
|
||||
```json
|
||||
{
|
||||
"code": 200,
|
||||
"msg": "操作成功"
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 5. 删除采购交易
|
||||
|
||||
**接口描述**: 删除采购交易记录（支持批量删除）
|
||||
|
||||
**请求方式**: `DELETE`
|
||||
|
||||
**请求路径**: `/ccdi/purchaseTransaction/{purchaseIds}`
|
||||
|
||||
**权限要求**: `ccdi:purchaseTransaction:remove`
|
||||
|
||||
**路径参数**:
|
||||
|
||||
| 参数名 | 类型 | 必填 | 说明 | 示例值 |
|
||||
|--------|------|------|------|--------|
|
||||
| purchaseIds | String[] | 是 | 采购事项ID数组，多个用逗号分隔 | PO20250206001,PO20250206002 |
|
||||
|
||||
**请求示例**:
|
||||
```
|
||||
DELETE /ccdi/purchaseTransaction/PO20250206001,PO20250206002
|
||||
```
|
||||
|
||||
**响应示例**:
|
||||
```json
|
||||
{
|
||||
"code": 200,
|
||||
"msg": "操作成功"
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 6. 导出采购交易
|
||||
|
||||
**接口描述**: 导出采购交易信息到Excel文件
|
||||
|
||||
**请求方式**: `POST`
|
||||
|
||||
**请求路径**: `/ccdi/purchaseTransaction/export`
|
||||
|
||||
**权限要求**: `ccdi:purchaseTransaction:export`
|
||||
|
||||
**请求参数**: 同查询接口，支持条件导出
|
||||
|
||||
**响应**: Excel文件流
|
||||
|
||||
**请求示例**:
|
||||
```bash
|
||||
curl -X POST "http://localhost:8080/ccdi/purchaseTransaction/export" \
|
||||
-H "Authorization: Bearer {token}" \
|
||||
-d "projectName=办公设备&applicantName=张三"
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 7. 下载导入模板
|
||||
|
||||
**接口描述**: 下载带字典下拉框的Excel导入模板
|
||||
|
||||
**请求方式**: `POST`
|
||||
|
||||
**请求路径**: `/ccdi/purchaseTransaction/importTemplate`
|
||||
|
||||
**权限要求**: 无
|
||||
|
||||
**响应**: Excel模板文件流（包含数据验证下拉框）
|
||||
|
||||
**请求示例**:
|
||||
```bash
|
||||
curl -X POST "http://localhost:8080/ccdi/purchaseTransaction/importTemplate" \
|
||||
-H "Authorization: Bearer {token}" \
|
||||
-o purchase_transaction_template.xlsx
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 8. 导入采购交易
|
||||
|
||||
**接口描述**: 异步导入Excel数据
|
||||
|
||||
**请求方式**: `POST`
|
||||
|
||||
**请求路径**: `/ccdi/purchaseTransaction/importData?updateSupport={updateSupport}`
|
||||
|
||||
**权限要求**: `ccdi:purchaseTransaction:import`
|
||||
|
||||
**请求头**:
|
||||
```
|
||||
Content-Type: multipart/form-data
|
||||
Authorization: Bearer {token}
|
||||
```
|
||||
|
||||
**路径参数**:
|
||||
|
||||
| 参数名 | 类型 | 必填 | 说明 | 示例值 |
|
||||
|--------|------|------|------|--------|
|
||||
| updateSupport | boolean | 是 | 是否更新已存在数据 | true/false |
|
||||
|
||||
**表单参数**:
|
||||
|
||||
| 参数名 | 类型 | 必填 | 说明 |
|
||||
|--------|------|------|------|
|
||||
| file | File | 是 | Excel文件（.xlsx或.xls） |
|
||||
|
||||
**响应示例**:
|
||||
```json
|
||||
{
|
||||
"code": 200,
|
||||
"msg": "导入任务已提交，任务ID：task-20250206-123456789"
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 9. 查询导入状态
|
||||
|
||||
**接口描述**: 查询异步导入任务的执行状态
|
||||
|
||||
**请求方式**: `GET`
|
||||
|
||||
**请求路径**: `/ccdi/purchaseTransaction/importStatus/{taskId}`
|
||||
|
||||
**权限要求**: `ccdi:purchaseTransaction:import`
|
||||
|
||||
**路径参数**:
|
||||
|
||||
| 参数名 | 类型 | 必填 | 说明 | 示例值 |
|
||||
|--------|------|------|------|--------|
|
||||
| taskId | String | 是 | 任务ID | task-20250206-123456789 |
|
||||
|
||||
**响应示例**:
|
||||
```json
|
||||
{
|
||||
"code": 200,
|
||||
"msg": "操作成功",
|
||||
"data": {
|
||||
"taskId": "task-20250206-123456789",
|
||||
"status": "completed",
|
||||
"total": 1000,
|
||||
"successCount": 980,
|
||||
"failureCount": 20,
|
||||
"errorMsg": null
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
**状态说明**:
|
||||
- `pending`: 等待执行
|
||||
- `running`: 正在执行
|
||||
- `completed`: 执行完成
|
||||
- `failed`: 执行失败
|
||||
|
||||
---
|
||||
|
||||
### 10. 查询导入失败记录
|
||||
|
||||
**接口描述**: 查询导入任务中失败的记录详情
|
||||
|
||||
**请求方式**: `GET`
|
||||
|
||||
**请求路径**: `/ccdi/purchaseTransaction/importFailures/{taskId}`
|
||||
|
||||
**权限要求**: `ccdi:purchaseTransaction:import`
|
||||
|
||||
**路径参数**:
|
||||
|
||||
| 参数名 | 类型 | 必填 | 说明 | 示例值 |
|
||||
|--------|------|------|------|--------|
|
||||
| taskId | String | 是 | 任务ID | task-20250206-123456789 |
|
||||
|
||||
**响应示例**:
|
||||
```json
|
||||
{
|
||||
"code": 200,
|
||||
"msg": "操作成功",
|
||||
"data": [
|
||||
{
|
||||
"purchaseId": "PO20250206001",
|
||||
"rowNum": 5,
|
||||
"errorMessage": "采购事项ID已存在"
|
||||
},
|
||||
{
|
||||
"purchaseId": "PO20250206002",
|
||||
"rowNum": 12,
|
||||
"errorMessage": "预算金额格式错误"
|
||||
}
|
||||
]
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 数据模型
|
||||
|
||||
### CcdiPurchaseTransactionVO (查询返回对象)
|
||||
|
||||
采购交易信息的视图对象，用于列表查询和详情展示。
|
||||
|
||||
### CcdiPurchaseTransactionAddDTO (新增请求对象)
|
||||
|
||||
新增采购交易时的请求参数对象。
|
||||
|
||||
### CcdiPurchaseTransactionEditDTO (修改请求对象)
|
||||
|
||||
修改采购交易时的请求参数对象。
|
||||
|
||||
### CcdiPurchaseTransactionQueryDTO (查询请求对象)
|
||||
|
||||
查询条件参数对象。
|
||||
|
||||
### CcdiPurchaseTransactionExcel (导入导出对象)
|
||||
|
||||
Excel导入导出使用的数据对象，支持字典下拉框。
|
||||
|
||||
### ImportStatusVO (导入状态对象)
|
||||
|
||||
异步导入任务的状态信息。
|
||||
|
||||
| 字段 | 类型 | 说明 |
|
||||
|------|------|------|
|
||||
| taskId | String | 任务ID |
|
||||
| status | String | 状态：pending/running/completed/failed |
|
||||
| total | Integer | 总记录数 |
|
||||
| successCount | Integer | 成功数量 |
|
||||
| failureCount | Integer | 失败数量 |
|
||||
| errorMsg | String | 错误信息（失败时） |
|
||||
|
||||
### PurchaseTransactionImportFailureVO (导入失败记录对象)
|
||||
|
||||
导入失败的记录详情。
|
||||
|
||||
| 字段 | 类型 | 说明 |
|
||||
|------|------|------|
|
||||
| purchaseId | String | 采购事项ID |
|
||||
| rowNum | Integer | 行号 |
|
||||
| errorMessage | String | 错误信息 |
|
||||
|
||||
---
|
||||
|
||||
## 错误码说明
|
||||
|
||||
### HTTP状态码
|
||||
|
||||
| 状态码 | 说明 |
|
||||
|--------|------|
|
||||
| 200 | 请求成功 |
|
||||
| 401 | 未授权，token无效或过期 |
|
||||
| 403 | 无权限访问 |
|
||||
| 404 | 资源不存在 |
|
||||
| 500 | 服务器内部错误 |
|
||||
|
||||
### 业务错误码
|
||||
|
||||
| code | msg | 说明 |
|
||||
|------|-----|------|
|
||||
| 200 | 操作成功 | 请求成功处理 |
|
||||
| 500 | 操作失败 | 服务器处理失败 |
|
||||
| 401 | 请先登录 | 未登录或token过期 |
|
||||
| 403 | 无权限访问 | 权限不足 |
|
||||
|
||||
---
|
||||
|
||||
## 接口示例
|
||||
|
||||
### 1. 完整的CRUD流程
|
||||
|
||||
```bash
|
||||
# 1. 登录获取token
|
||||
TOKEN=$(curl -s -X POST "http://localhost:8080/login/test" \
|
||||
-H "Content-Type: application/json" \
|
||||
-d '{"username":"admin","password":"admin123"}' \
|
||||
| jq -r '.token')
|
||||
|
||||
# 2. 查询列表
|
||||
curl -X GET "http://localhost:8080/ccdi/purchaseTransaction/list?pageNum=1&pageSize=10" \
|
||||
-H "Authorization: Bearer $TOKEN"
|
||||
|
||||
# 3. 新增记录
|
||||
curl -X POST "http://localhost:8080/ccdi/purchaseTransaction" \
|
||||
-H "Authorization: Bearer $TOKEN" \
|
||||
-H "Content-Type: application/json" \
|
||||
-d '{
|
||||
"purchaseId": "PO20250206001",
|
||||
"projectName": "办公设备采购项目",
|
||||
"subjectName": "笔记本电脑",
|
||||
"budgetAmount": 500000.00
|
||||
}'
|
||||
|
||||
# 4. 获取详情
|
||||
curl -X GET "http://localhost:8080/ccdi/purchaseTransaction/PO20250206001" \
|
||||
-H "Authorization: Bearer $TOKEN"
|
||||
|
||||
# 5. 修改记录
|
||||
curl -X PUT "http://localhost:8080/ccdi/purchaseTransaction" \
|
||||
-H "Authorization: Bearer $TOKEN" \
|
||||
-H "Content-Type: application/json" \
|
||||
-d '{
|
||||
"purchaseId": "PO20250206001",
|
||||
"projectName": "办公设备采购项目（修改）",
|
||||
"subjectName": "笔记本电脑",
|
||||
"budgetAmount": 550000.00
|
||||
}'
|
||||
|
||||
# 6. 删除记录
|
||||
curl -X DELETE "http://localhost:8080/ccdi/purchaseTransaction/PO20250206001" \
|
||||
-H "Authorization: Bearer $TOKEN"
|
||||
```
|
||||
|
||||
### 2. 导入导出流程
|
||||
|
||||
```bash
|
||||
# 1. 下载模板
|
||||
curl -X POST "http://localhost:8080/ccdi/purchaseTransaction/importTemplate" \
|
||||
-H "Authorization: Bearer $TOKEN" \
|
||||
-o template.xlsx
|
||||
|
||||
# 2. 填写数据后导入
|
||||
curl -X POST "http://localhost:8080/ccdi/purchaseTransaction/importData?updateSupport=false" \
|
||||
-H "Authorization: Bearer $TOKEN" \
|
||||
-F "file=@data.xlsx"
|
||||
|
||||
# 响应: {"code":200,"msg":"导入任务已提交，任务ID：task-xxx"}
|
||||
|
||||
# 3. 查询导入状态
|
||||
curl -X GET "http://localhost:8080/ccdi/purchaseTransaction/importStatus/task-xxx" \
|
||||
-H "Authorization: Bearer $TOKEN"
|
||||
|
||||
# 4. 如果有失败，查询失败记录
|
||||
curl -X GET "http://localhost:8080/ccdi/purchaseTransaction/importFailures/task-xxx" \
|
||||
-H "Authorization: Bearer $TOKEN"
|
||||
|
||||
# 5. 导出数据
|
||||
curl -X POST "http://localhost:8080/ccdi/purchaseTransaction/export" \
|
||||
-H "Authorization: Bearer $TOKEN" \
|
||||
-d "projectName=办公设备" \
|
||||
-o export_data.xlsx
|
||||
```
|
||||
|
||||
### 3. Postman测试步骤
|
||||
|
||||
1. **创建环境变量**:
|
||||
- `base_url`: http://localhost:8080
|
||||
- `token`: (登录后获取)
|
||||
|
||||
2. **创建Pre-request Script**:
|
||||
```javascript
|
||||
// 自动设置token
|
||||
if (!pm.environment.get("token")) {
|
||||
const loginRequest = {
|
||||
url: pm.environment.get("base_url") + "/login/test",
|
||||
method: "POST",
|
||||
header: {"Content-Type": "application/json"},
|
||||
body: {
|
||||
mode: "raw",
|
||||
raw: JSON.stringify({username: "admin", password: "admin123"})
|
||||
}
|
||||
};
|
||||
pm.sendRequest(loginRequest, (err, res) => {
|
||||
pm.environment.set("token", res.json().token);
|
||||
});
|
||||
}
|
||||
```
|
||||
|
||||
3. **设置Authorization**:
|
||||
- Type: Bearer Token
|
||||
- Token: `{{token}}`
|
||||
|
||||
4. **执行测试**:
|
||||
- 按接口顺序执行
|
||||
- 查看响应结果
|
||||
- 验证数据正确性
|
||||
|
||||
---
|
||||
|
||||
## 附录
|
||||
|
||||
### A. 数据库表结构
|
||||
|
||||
表名: `ccdi_purchase_transaction`
|
||||
|
||||
| 字段名 | 类型 | 说明 | 备注 |
|
||||
|--------|------|------|------|
|
||||
| purchase_id | varchar(32) | 采购事项ID | 主键 |
|
||||
| purchase_category | varchar(50) | 采购类别 | |
|
||||
| project_name | varchar(200) | 项目名称 | |
|
||||
| subject_name | varchar(200) | 标的物名称 | |
|
||||
| subject_desc | varchar(500) | 标的物描述 | |
|
||||
| purchase_qty | decimal(10,2) | 采购数量 | |
|
||||
| budget_amount | decimal(15,2) | 预算金额 | |
|
||||
| bid_amount | decimal(15,2) | 中标金额 | |
|
||||
| actual_amount | decimal(15,2) | 实际采购金额 | |
|
||||
| contract_amount | decimal(15,2) | 合同金额 | |
|
||||
| settlement_amount | decimal(15,2) | 结算金额 | |
|
||||
| purchase_method | varchar(50) | 采购方式 | |
|
||||
| supplier_name | varchar(200) | 中标供应商名称 | |
|
||||
| contact_person | varchar(50) | 供应商联系人 | |
|
||||
| contact_phone | varchar(20) | 供应商联系电话 | |
|
||||
| supplier_uscc | varchar(18) | 供应商统一信用代码 | |
|
||||
| supplier_bank_account | varchar(50) | 供应商银行账户 | |
|
||||
| apply_date | date | 采购申请日期 | |
|
||||
| plan_approve_date | date | 采购计划批准日期 | |
|
||||
| announce_date | date | 采购公告发布日期 | |
|
||||
| bid_open_date | date | 开标日期 | |
|
||||
| contract_sign_date | date | 合同签订日期 | |
|
||||
| expected_delivery_date | date | 预计交货日期 | |
|
||||
| actual_delivery_date | date | 实际交货日期 | |
|
||||
| acceptance_date | date | 验收日期 | |
|
||||
| settlement_date | date | 结算日期 | |
|
||||
| applicant_id | varchar(20) | 申请人工号 | |
|
||||
| applicant_name | varchar(50) | 申请人姓名 | |
|
||||
| apply_department | varchar(100) | 申请部门 | |
|
||||
| purchase_leader_id | varchar(20) | 采购负责人工号 | |
|
||||
| purchase_leader_name | varchar(50) | 采购负责人姓名 | |
|
||||
| purchase_department | varchar(100) | 采购部门 | |
|
||||
| create_time | datetime | 创建时间 | 自动填充 |
|
||||
| update_time | datetime | 更新时间 | 自动填充 |
|
||||
| created_by | varchar(64) | 创建人 | 自动填充 |
|
||||
| updated_by | varchar(64) | 更新人 | 自动填充 |
|
||||
|
||||
### B. 菜单权限配置
|
||||
|
||||
执行以下SQL配置菜单权限：
|
||||
|
||||
```sql
|
||||
-- 文件路径: sql/ccdi_purchase_transaction_menu.sql
|
||||
-- 执行此文件以配置菜单和权限
|
||||
source sql/ccdi_purchase_transaction_menu.sql;
|
||||
```
|
||||
|
||||
### C. 前端API文件
|
||||
|
||||
前端API定义文件: `ruoyi-ui/src/api/ccdiPurchaseTransaction.js`
|
||||
|
||||
---
|
||||
|
||||
## 导入功能交互说明
|
||||
|
||||
### 前端交互流程
|
||||
|
||||
1. **上传文件**
|
||||
- 用户点击"导入"按钮
|
||||
- 选择Excel文件
|
||||
- 点击"确定"上传
|
||||
- **导入对话框立即关闭**
|
||||
|
||||
2. **后台处理**
|
||||
- 右上角显示通知:"导入任务已提交,正在后台处理中,处理完成后将通知您"
|
||||
- 系统每2秒轮询一次导入状态
|
||||
|
||||
3. **导入完成**
|
||||
- 全部成功:显示绿色通知"导入完成!全部成功!共导入N条数据"
|
||||
- 部分失败:显示橙色通知"导入完成!成功N条,失败M条"
|
||||
- 如果有失败记录,操作栏显示"查看导入失败记录"按钮
|
||||
|
||||
4. **查看失败记录**
|
||||
- 点击"查看导入失败记录"按钮
|
||||
- 打开对话框显示分页的失败记录
|
||||
- 包含字段:采购事项ID、项目名称、标的物名称、失败原因
|
||||
- 支持清除历史记录
|
||||
|
||||
### 状态持久化
|
||||
|
||||
- 导入状态保存在localStorage中
|
||||
- 刷新页面后仍可查看上次导入结果
|
||||
- 状态保留7天,过期自动清除
|
||||
|
||||
### 与员工信息导入的对比
|
||||
|
||||
采购交易导入完全复用了员工信息导入的逻辑,两者的交互方式完全一致。
|
||||
|
||||
---
|
||||
|
||||
## 版本历史
|
||||
|
||||
| 版本 | 日期 | 说明 | 作者 |
|
||||
|------|------|------|------|
|
||||
| 1.0.0 | 2026-02-06 | 初始版本，采购交易信息管理接口 | ruoyi |
|
||||
| 1.1.0 | 2026-02-08 | 添加导入功能交互说明 | ruoyi |
|
||||
|
||||
---
|
||||
|
||||
## 联系方式
|
||||
|
||||
如有问题，请联系开发团队。
|
||||
@@ -1,430 +0,0 @@
|
||||
# 员工招聘信息管理 API文档
|
||||
|
||||
**模块名称:** ccdi-staff-recruitment
|
||||
**版本:** 1.0
|
||||
**生成日期:** 2025-02-05
|
||||
**基础路径:** `/ccdi/staffRecruitment`
|
||||
|
||||
---
|
||||
|
||||
## 目录
|
||||
|
||||
1. [查询接口](#1-查询接口)
|
||||
2. [操作接口](#2-操作接口)
|
||||
3. [导入导出接口](#3-导入导出接口)
|
||||
4. [数据模型](#4-数据模型)
|
||||
5. [错误码说明](#5-错误码说明)
|
||||
|
||||
---
|
||||
|
||||
## 1. 查询接口
|
||||
|
||||
### 1.1 分页查询招聘信息列表
|
||||
|
||||
**接口描述:** 分页查询员工招聘信息列表,支持多条件筛选
|
||||
|
||||
**请求方式:** `GET`
|
||||
|
||||
**接口路径:** `/ccdi/staffRecruitment/list`
|
||||
|
||||
**权限标识:** `ccdi:staffRecruitment:list`
|
||||
|
||||
**请求参数:**
|
||||
|
||||
| 参数名 | 类型 | 必填 | 说明 | 示例值 |
|
||||
|-------|------|------|------|--------|
|
||||
| pageNum | Integer | 否 | 页码，默认1 | 1 |
|
||||
| pageSize | Integer | 否 | 每页条数，默认10 | 10 |
|
||||
| recruitName | String | 否 | 招聘项目名称(模糊查询) | 2025春季招聘 |
|
||||
| posName | String | 否 | 职位名称(模糊查询) | 软件工程师 |
|
||||
| candName | String | 否 | 候选人姓名(模糊查询) | 张三 |
|
||||
| candId | String | 否 | 证件号码(精确查询) | 110101199001011234 |
|
||||
| admitStatus | String | 否 | 录用状态(精确查询) | 录用/未录用/放弃 |
|
||||
| interviewerName | String | 否 | 面试官姓名(模糊查询,查询面试官1或2) | 李四 |
|
||||
| interviewerId | String | 否 | 面试官工号(精确查询,查询面试官1或2) | 10001 |
|
||||
|
||||
**响应示例:**
|
||||
|
||||
```json
|
||||
{
|
||||
"code": 200,
|
||||
"msg": "查询成功",
|
||||
"rows": [
|
||||
{
|
||||
"recruitId": "REC20250205001",
|
||||
"recruitName": "2025春季校园招聘",
|
||||
"posName": "Java开发工程师",
|
||||
"posCategory": "技术类",
|
||||
"posDesc": "负责后端系统开发",
|
||||
"candName": "张三",
|
||||
"candEdu": "本科",
|
||||
"candId": "110101199001011234",
|
||||
"candSchool": "清华大学",
|
||||
"candMajor": "计算机科学与技术",
|
||||
"candGrad": "202506",
|
||||
"admitStatus": "录用",
|
||||
"admitStatusDesc": "已录用该候选人",
|
||||
"interviewerName1": "李四",
|
||||
"interviewerId1": "10001",
|
||||
"interviewerName2": "王五",
|
||||
"interviewerId2": "10002",
|
||||
"createdBy": "admin",
|
||||
"createTime": "2025-02-05 10:00:00",
|
||||
"updatedBy": null,
|
||||
"updateTime": null
|
||||
}
|
||||
],
|
||||
"total": 100
|
||||
}
|
||||
```
|
||||
|
||||
### 1.2 查询招聘信息详情
|
||||
|
||||
**接口描述:** 根据招聘项目编号查询详细信息
|
||||
|
||||
**请求方式:** `GET`
|
||||
|
||||
**接口路径:** `/ccdi/staffRecruitment/{recruitId}`
|
||||
|
||||
**权限标识:** `ccdi:staffRecruitment:query`
|
||||
|
||||
**路径参数:**
|
||||
|
||||
| 参数名 | 类型 | 必填 | 说明 | 示例值 |
|
||||
|-------|------|------|------|--------|
|
||||
| recruitId | String | 是 | 招聘项目编号 | REC20250205001 |
|
||||
|
||||
**响应示例:**
|
||||
|
||||
```json
|
||||
{
|
||||
"code": 200,
|
||||
"msg": "操作成功",
|
||||
"data": {
|
||||
"recruitId": "REC20250205001",
|
||||
"recruitName": "2025春季校园招聘",
|
||||
"posName": "Java开发工程师",
|
||||
"posCategory": "技术类",
|
||||
"posDesc": "负责后端系统开发，要求熟悉Spring Boot、MyBatis Plus等框架",
|
||||
"candName": "张三",
|
||||
"candEdu": "本科",
|
||||
"candId": "110101199001011234",
|
||||
"candSchool": "清华大学",
|
||||
"candMajor": "计算机科学与技术",
|
||||
"candGrad": "202506",
|
||||
"admitStatus": "录用",
|
||||
"admitStatusDesc": "已录用该候选人",
|
||||
"interviewerName1": "李四",
|
||||
"interviewerId1": "10001",
|
||||
"interviewerName2": "王五",
|
||||
"interviewerId2": "10002",
|
||||
"createdBy": "admin",
|
||||
"createTime": "2025-02-05 10:00:00",
|
||||
"updatedBy": null,
|
||||
"updateTime": null
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 2. 操作接口
|
||||
|
||||
### 2.1 新增招聘信息
|
||||
|
||||
**接口描述:** 新增一条员工招聘信息
|
||||
|
||||
**请求方式:** `POST`
|
||||
|
||||
**接口路径:** `/ccdi/staffRecruitment`
|
||||
|
||||
**权限标识:** `ccdi:staffRecruitment:add`
|
||||
|
||||
**请求体:**
|
||||
|
||||
```json
|
||||
{
|
||||
"recruitId": "REC20250205001",
|
||||
"recruitName": "2025春季校园招聘",
|
||||
"posName": "Java开发工程师",
|
||||
"posCategory": "技术类",
|
||||
"posDesc": "负责后端系统开发",
|
||||
"candName": "张三",
|
||||
"candEdu": "本科",
|
||||
"candId": "110101199001011234",
|
||||
"candSchool": "清华大学",
|
||||
"candMajor": "计算机科学与技术",
|
||||
"candGrad": "202506",
|
||||
"admitStatus": "录用",
|
||||
"interviewerName1": "李四",
|
||||
"interviewerId1": "10001",
|
||||
"interviewerName2": "王五",
|
||||
"interviewerId2": "10002"
|
||||
}
|
||||
```
|
||||
|
||||
**字段校验规则:**
|
||||
|
||||
| 字段 | 校验规则 | 错误提示 |
|
||||
|-----|---------|---------|
|
||||
| recruitId | @NotBlank, @Size(max=32) | 招聘项目编号不能为空/长度不能超过32 |
|
||||
| recruitName | @NotBlank, @Size(max=100) | 招聘项目名称不能为空/长度不能超过100 |
|
||||
| posName | @NotBlank, @Size(max=100) | 职位名称不能为空/长度不能超过100 |
|
||||
| posCategory | @NotBlank, @Size(max=50) | 职位类别不能为空/长度不能超过50 |
|
||||
| posDesc | @NotBlank | 职位描述不能为空 |
|
||||
| candName | @NotBlank, @Size(max=20) | 应聘人员姓名不能为空/长度不能超过20 |
|
||||
| candEdu | @NotBlank, @Size(max=20) | 应聘人员学历不能为空/长度不能超过20 |
|
||||
| candId | @NotBlank, @Pattern(身份证正则) | 证件号码不能为空/格式不正确 |
|
||||
| candSchool | @NotBlank, @Size(max=50) | 应聘人员毕业院校不能为空/长度不能超过50 |
|
||||
| candMajor | @NotBlank, @Size(max=30) | 应聘人员专业不能为空/长度不能超过30 |
|
||||
| candGrad | @NotBlank, @Pattern(YYYYMM) | 毕业年月不能为空/格式不正确 |
|
||||
| admitStatus | @NotBlank, @EnumValid | 录用情况不能为空/状态值不合法 |
|
||||
|
||||
**响应示例:**
|
||||
|
||||
```json
|
||||
{
|
||||
"code": 200,
|
||||
"msg": "操作成功"
|
||||
}
|
||||
```
|
||||
|
||||
### 2.2 修改招聘信息
|
||||
|
||||
**接口描述:** 修改已有的员工招聘信息
|
||||
|
||||
**请求方式:** `PUT`
|
||||
|
||||
**接口路径:** `/ccdi/staffRecruitment`
|
||||
|
||||
**权限标识:** `ccdi:staffRecruitment:edit`
|
||||
|
||||
**请求体:**
|
||||
|
||||
```json
|
||||
{
|
||||
"recruitId": "REC20250205001",
|
||||
"recruitName": "2025春季校园招聘",
|
||||
"posName": "Java开发工程师",
|
||||
"posCategory": "技术类",
|
||||
"posDesc": "负责后端系统开发，负责核心模块设计",
|
||||
"candName": "张三",
|
||||
"candEdu": "本科",
|
||||
"candId": "110101199001011234",
|
||||
"candSchool": "清华大学",
|
||||
"candMajor": "计算机科学与技术",
|
||||
"candGrad": "202506",
|
||||
"admitStatus": "录用",
|
||||
"interviewerName1": "李四",
|
||||
"interviewerId1": "10001",
|
||||
"interviewerName2": "王五",
|
||||
"interviewerId2": "10002"
|
||||
}
|
||||
```
|
||||
|
||||
**响应示例:**
|
||||
|
||||
```json
|
||||
{
|
||||
"code": 200,
|
||||
"msg": "操作成功"
|
||||
}
|
||||
```
|
||||
|
||||
### 2.3 删除招聘信息
|
||||
|
||||
**接口描述:** 批量删除员工招聘信息
|
||||
|
||||
**请求方式:** `DELETE`
|
||||
|
||||
**接口路径:** `/ccdi/staffRecruitment/{recruitIds}`
|
||||
|
||||
**权限标识:** `ccdi:staffRecruitment:remove`
|
||||
|
||||
**路径参数:**
|
||||
|
||||
| 参数名 | 类型 | 必填 | 说明 | 示例值 |
|
||||
|-------|------|------|------|--------|
|
||||
| recruitIds | String[] | 是 | 招聘项目编号数组,多个用逗号分隔 | REC20250205001,REC20250205002 |
|
||||
|
||||
**响应示例:**
|
||||
|
||||
```json
|
||||
{
|
||||
"code": 200,
|
||||
"msg": "操作成功"
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 3. 导入导出接口
|
||||
|
||||
### 3.1 下载导入模板
|
||||
|
||||
**接口描述:** 下载Excel导入模板
|
||||
|
||||
**请求方式:** `POST`
|
||||
|
||||
**接口路径:** `/ccdi/staffRecruitment/importTemplate`
|
||||
|
||||
**权限标识:** 无
|
||||
|
||||
**响应:** Excel文件流
|
||||
|
||||
**模板字段顺序:**
|
||||
|
||||
| 序号 | 字段名 | 说明 | 必填 |
|
||||
|-----|--------|------|------|
|
||||
| 1 | 招聘项目编号 | 唯一标识 | 是 |
|
||||
| 2 | 招聘项目名称 | - | 是 |
|
||||
| 3 | 职位名称 | - | 是 |
|
||||
| 4 | 职位类别 | - | 是 |
|
||||
| 5 | 职位描述 | - | 是 |
|
||||
| 6 | 应聘人员姓名 | - | 是 |
|
||||
| 7 | 应聘人员学历 | - | 是 |
|
||||
| 8 | 应聘人员证件号码 | 身份证号 | 是 |
|
||||
| 9 | 应聘人员毕业院校 | - | 是 |
|
||||
| 10 | 应聘人员专业 | - | 是 |
|
||||
| 11 | 应聘人员毕业年月 | 格式:YYYYMM | 是 |
|
||||
| 12 | 录用情况 | 录用/未录用/放弃 | 是 |
|
||||
| 13 | 面试官1姓名 | - | 否 |
|
||||
| 14 | 面试官1工号 | - | 否 |
|
||||
| 15 | 面试官2姓名 | - | 否 |
|
||||
| 16 | 面试官2工号 | - | 否 |
|
||||
|
||||
### 3.2 批量导入
|
||||
|
||||
**接口描述:** 通过Excel批量导入招聘信息
|
||||
|
||||
**请求方式:** `POST`
|
||||
|
||||
**接口路径:** `/ccdi/staffRecruitment/importData?updateSupport={updateSupport}`
|
||||
|
||||
**权限标识:** `ccdi:staffRecruitment:import`
|
||||
|
||||
**请求参数:**
|
||||
|
||||
| 参数名 | 类型 | 必填 | 说明 | 示例值 |
|
||||
|-------|------|------|------|--------|
|
||||
| updateSupport | Boolean | 否 | 是否更新已存在的数据 | true |
|
||||
| file | File | 是 | Excel文件 | - |
|
||||
|
||||
**请求类型:** `multipart/form-data`
|
||||
|
||||
**响应示例 (成功):**
|
||||
|
||||
```json
|
||||
{
|
||||
"code": 200,
|
||||
"msg": "恭喜您，数据已全部导入成功！共 10 条，数据类型：新增 8 条，更新 2 条"
|
||||
}
|
||||
```
|
||||
|
||||
**响应示例 (部分失败):**
|
||||
|
||||
```json
|
||||
{
|
||||
"code": 500,
|
||||
"msg": "很抱歉，导入完成！成功 8 条，失败 2 条，错误如下：<br/>1、招聘项目编号 REC001 导入失败：该招聘项目编号已存在<br/>2、招聘项目编号 REC002 导入失败：证件号码格式不正确"
|
||||
}
|
||||
```
|
||||
|
||||
### 3.3 导出
|
||||
|
||||
**接口描述:** 导出招聘信息到Excel
|
||||
|
||||
**请求方式:** `POST`
|
||||
|
||||
**接口路径:** `/ccdi/staffRecruitment/export`
|
||||
|
||||
**权限标识:** `ccdi:staffRecruitment:export`
|
||||
|
||||
**请求参数:** 与分页查询接口相同的查询条件
|
||||
|
||||
**响应:** Excel文件流
|
||||
|
||||
---
|
||||
|
||||
## 4. 数据模型
|
||||
|
||||
### 4.1 录用状态枚举 (AdmitStatus)
|
||||
|
||||
| 枚举值 | 说明 |
|
||||
|--------|------|
|
||||
| 录用 | 已录用该候选人 |
|
||||
| 未录用 | 未录用该候选人 |
|
||||
| 放弃 | 候选人放弃 |
|
||||
|
||||
### 4.2 CcdiStaffRecruitmentVO
|
||||
|
||||
招聘信息返回对象,包含所有字段及状态描述。
|
||||
|
||||
### 4.3 CcdiStaffRecruitmentExcel
|
||||
|
||||
Excel导入导出对象,使用EasyExcel注解。
|
||||
|
||||
---
|
||||
|
||||
## 5. 错误码说明
|
||||
|
||||
| 错误码 | 说明 |
|
||||
|--------|------|
|
||||
| 200 | 操作成功 |
|
||||
| 400 | 参数校验失败 |
|
||||
| 401 | 未授权,请先登录 |
|
||||
| 403 | 无权限访问 |
|
||||
| 404 | 资源不存在 |
|
||||
| 409 | 主键冲突 |
|
||||
| 500 | 服务器内部错误 |
|
||||
|
||||
### 常见业务错误
|
||||
|
||||
| 错误信息 | 说明 |
|
||||
|---------|------|
|
||||
| 该招聘项目编号已存在 | 新增时recruitId重复 |
|
||||
| 招聘项目编号不能为空 | recruitId字段为空 |
|
||||
| 证件号码格式不正确 | 身份证号格式验证失败 |
|
||||
| 毕业年月格式不正确 | candGrad不是YYYYMM格式 |
|
||||
| 录用情况状态值不合法 | admitStatus不是枚举值之一 |
|
||||
|
||||
---
|
||||
|
||||
## 附录
|
||||
|
||||
### Swagger UI
|
||||
|
||||
访问地址: `/swagger-ui/index.html`
|
||||
|
||||
### 测试账号
|
||||
|
||||
- 用户名: admin
|
||||
- 密码: admin123
|
||||
|
||||
### Token获取
|
||||
|
||||
**接口:** POST `/login`
|
||||
|
||||
**请求体:**
|
||||
|
||||
```json
|
||||
{
|
||||
"username": "admin",
|
||||
"password": "admin123"
|
||||
}
|
||||
```
|
||||
|
||||
**响应:**
|
||||
|
||||
```json
|
||||
{
|
||||
"code": 200,
|
||||
"msg": "操作成功",
|
||||
"token": "Bearer eyJhbGciOiJIUzUxMiJ9..."
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
**文档生成时间:** 2025-02-05
|
||||
**文档版本:** 1.0
|
||||
@@ -1,610 +0,0 @@
|
||||
# 中介黑名单管理 API 文档 v2.0
|
||||
|
||||
## 概述
|
||||
|
||||
中介黑名单管理模块提供个人和实体两类中介信息的增删改查、类型化模板下载和批量导入导出功能。
|
||||
|
||||
**基础路径**: `/ccdi/intermediary`
|
||||
|
||||
**权限标识前缀**: `ccdi:intermediary`
|
||||
|
||||
**文档版本**: v2.0
|
||||
|
||||
**更新日期**: 2026-02-04
|
||||
|
||||
---
|
||||
|
||||
## API 接口列表
|
||||
|
||||
### 1. 查询中介列表
|
||||
|
||||
**接口地址**: `GET /ccdi/intermediary/list`
|
||||
|
||||
**权限要求**: `ccdi:intermediary:list`
|
||||
|
||||
**请求参数** (Query Params):
|
||||
|
||||
| 参数名 | 类型 | 必填 | 说明 |
|
||||
|--------|------|------|------|
|
||||
| name | String | 否 | 姓名/机构名称(模糊查询) |
|
||||
| certificateNo | String | 否 | 证件号/统一社会信用代码(精确查询) |
|
||||
| intermediaryType | String | 否 | 中介类型(1=个人, 2=实体) |
|
||||
| pageNum | Integer | 否 | 页码(默认1) |
|
||||
| pageSize | Integer | 否 | 每页数量(默认10) |
|
||||
|
||||
**响应示例**:
|
||||
```json
|
||||
{
|
||||
"code": 200,
|
||||
"msg": "操作成功",
|
||||
"rows": [
|
||||
{
|
||||
"bizId": "I202602040001",
|
||||
"name": "张三",
|
||||
"certificateNo": "110101199001011234",
|
||||
"intermediaryType": "1",
|
||||
"intermediaryTypeName": "个人",
|
||||
"status": "0",
|
||||
"statusName": "正常",
|
||||
"remark": "测试数据",
|
||||
"createBy": "admin",
|
||||
"createTime": "2026-02-04 10:00:00"
|
||||
}
|
||||
],
|
||||
"total": 1
|
||||
}
|
||||
```
|
||||
|
||||
**响应字段说明**:
|
||||
|
||||
| 字段名 | 类型 | 说明 |
|
||||
|--------|------|------|
|
||||
| bizId | String | 业务ID |
|
||||
| name | String | 姓名/机构名称 |
|
||||
| certificateNo | String | 证件号/统一社会信用代码 |
|
||||
| intermediaryType | String | 中介类型(1=个人, 2=实体) |
|
||||
| intermediaryTypeName | String | 中介类型名称 |
|
||||
| status | String | 状态(0=正常, 1=停用) |
|
||||
| statusName | String | 状态名称 |
|
||||
| remark | String | 备注 |
|
||||
| createBy | String | 创建人 |
|
||||
| createTime | String | 创建时间 |
|
||||
|
||||
---
|
||||
|
||||
### 2. 查询个人中介详情
|
||||
|
||||
**接口地址**: `GET /ccdi/intermediary/person/{bizId}`
|
||||
|
||||
**权限要求**: `ccdi:intermediary:query`
|
||||
|
||||
**路径参数**:
|
||||
|
||||
| 参数名 | 类型 | 必填 | 说明 |
|
||||
|--------|------|------|------|
|
||||
| bizId | String | 是 | 业务ID |
|
||||
|
||||
**响应示例**:
|
||||
```json
|
||||
{
|
||||
"code": 200,
|
||||
"msg": "操作成功",
|
||||
"data": {
|
||||
"bizId": "I202602040001",
|
||||
"name": "张三",
|
||||
"certificateNo": "110101199001011234",
|
||||
"intermediaryType": "1",
|
||||
"intermediaryTypeName": "个人",
|
||||
"status": "0",
|
||||
"statusName": "正常",
|
||||
"personType": "中介",
|
||||
"personSubType": "本人",
|
||||
"relationType": "正常",
|
||||
"gender": "M",
|
||||
"genderName": "男",
|
||||
"idType": "身份证",
|
||||
"personId": "110101199001011234",
|
||||
"mobile": "13800138000",
|
||||
"wechatNo": "zhangsan",
|
||||
"contactAddress": "北京市朝阳区",
|
||||
"company": "XX公司",
|
||||
"socialCreditCode": "91110000123456789X",
|
||||
"position": "经纪人",
|
||||
"relatedNumId": "",
|
||||
"relation": "",
|
||||
"remark": "测试数据",
|
||||
"createBy": "admin",
|
||||
"createTime": "2026-02-04 10:00:00"
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 3. 查询实体中介详情
|
||||
|
||||
**接口地址**: `GET /ccdi/intermediary/entity/{socialCreditCode}`
|
||||
|
||||
**权限要求**: `ccdi:intermediary:query`
|
||||
|
||||
**路径参数**:
|
||||
|
||||
| 参数名 | 类型 | 必填 | 说明 |
|
||||
|--------|------|------|------|
|
||||
| socialCreditCode | String | 是 | 统一社会信用代码 |
|
||||
|
||||
**响应示例**:
|
||||
```json
|
||||
{
|
||||
"code": 200,
|
||||
"msg": "操作成功",
|
||||
"data": {
|
||||
"bizId": "I202602040002",
|
||||
"name": "XX中介公司",
|
||||
"certificateNo": "91110000123456789X",
|
||||
"intermediaryType": "2",
|
||||
"intermediaryTypeName": "实体",
|
||||
"status": "0",
|
||||
"statusName": "正常",
|
||||
"enterpriseName": "XX中介公司",
|
||||
"socialCreditCode": "91110000123456789X",
|
||||
"enterpriseType": "有限责任公司",
|
||||
"enterpriseNature": "民企",
|
||||
"industryClass": "房地产",
|
||||
"industryName": "房地产业",
|
||||
"establishDate": "2020-01-01",
|
||||
"registerAddress": "北京市朝阳区",
|
||||
"legalRepresentative": "张三",
|
||||
"legalCertType": "身份证",
|
||||
"legalCertNo": "110101199001011234",
|
||||
"shareholder1": "李四",
|
||||
"shareholder2": "王五",
|
||||
"shareholder3": "",
|
||||
"shareholder4": "",
|
||||
"shareholder5": "",
|
||||
"remark": "测试数据",
|
||||
"createBy": "admin",
|
||||
"createTime": "2026-02-04 10:00:00"
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 4. 新增个人中介
|
||||
|
||||
**接口地址**: `POST /ccdi/intermediary/person`
|
||||
|
||||
**权限要求**: `ccdi:intermediary:add`
|
||||
|
||||
**请求体** (application/json):
|
||||
```json
|
||||
{
|
||||
"name": "张三",
|
||||
"personType": "中介",
|
||||
"personSubType": "本人",
|
||||
"relationType": "正常",
|
||||
"gender": "M",
|
||||
"idType": "身份证",
|
||||
"personId": "110101199001011234",
|
||||
"mobile": "13800138000",
|
||||
"wechatNo": "zhangsan",
|
||||
"contactAddress": "北京市朝阳区",
|
||||
"company": "XX公司",
|
||||
"socialCreditCode": "91110000123456789X",
|
||||
"position": "经纪人",
|
||||
"relatedNumId": "",
|
||||
"relation": "",
|
||||
"remark": "测试数据"
|
||||
}
|
||||
```
|
||||
|
||||
**字段说明**:
|
||||
|
||||
| 字段名 | 类型 | 必填 | 说明 |
|
||||
|--------|------|------|------|
|
||||
| name | String | 是 | 姓名(最大100字符) |
|
||||
| personId | String | 是 | 证件号码(最大50字符) |
|
||||
| personType | String | 否 | 人员类型 |
|
||||
| personSubType | String | 否 | 人员子类型 |
|
||||
| relationType | String | 否 | 关系类型 |
|
||||
| gender | String | 否 | 性别(M=男, F=女, O=其他) |
|
||||
| idType | String | 否 | 证件类型 |
|
||||
| mobile | String | 否 | 手机号码(最大20字符) |
|
||||
| wechatNo | String | 否 | 微信号(最大50字符) |
|
||||
| contactAddress | String | 否 | 联系地址(最大200字符) |
|
||||
| company | String | 否 | 所在公司(最大200字符) |
|
||||
| socialCreditCode | String | 否 | 企业统一信用码(最大50字符) |
|
||||
| position | String | 否 | 职位(最大100字符) |
|
||||
| relatedNumId | String | 否 | 关联人员ID(最大50字符) |
|
||||
| relation | String | 否 | 关联关系(最大50字符) |
|
||||
| remark | String | 否 | 备注(最大500字符) |
|
||||
|
||||
**响应示例**:
|
||||
```json
|
||||
{
|
||||
"code": 200,
|
||||
"msg": "操作成功"
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 5. 新增实体中介
|
||||
|
||||
**接口地址**: `POST /ccdi/intermediary/entity`
|
||||
|
||||
**权限要求**: `ccdi:intermediary:add`
|
||||
|
||||
**请求体** (application/json):
|
||||
```json
|
||||
{
|
||||
"enterpriseName": "XX中介公司",
|
||||
"socialCreditCode": "91110000123456789X",
|
||||
"enterpriseType": "有限责任公司",
|
||||
"enterpriseNature": "民企",
|
||||
"industryClass": "房地产",
|
||||
"industryName": "房地产业",
|
||||
"establishDate": "2020-01-01",
|
||||
"registerAddress": "北京市朝阳区",
|
||||
"legalRepresentative": "张三",
|
||||
"legalCertType": "身份证",
|
||||
"legalCertNo": "110101199001011234",
|
||||
"shareholder1": "李四",
|
||||
"shareholder2": "王五",
|
||||
"shareholder3": "",
|
||||
"shareholder4": "",
|
||||
"shareholder5": "",
|
||||
"remark": "测试数据"
|
||||
}
|
||||
```
|
||||
|
||||
**字段说明**:
|
||||
|
||||
| 字段名 | 类型 | 必填 | 说明 |
|
||||
|--------|------|------|------|
|
||||
| enterpriseName | String | 是 | 机构名称(最大200字符) |
|
||||
| socialCreditCode | String | 否 | 统一社会信用代码(最大50字符) |
|
||||
| enterpriseType | String | 否 | 主体类型(最大50字符) |
|
||||
| enterpriseNature | String | 否 | 企业性质(最大50字符) |
|
||||
| industryClass | String | 否 | 行业分类(最大100字符) |
|
||||
| industryName | String | 否 | 所属行业(最大100字符) |
|
||||
| establishDate | Date | 否 | 成立日期 |
|
||||
| registerAddress | String | 否 | 注册地址(最大500字符) |
|
||||
| legalRepresentative | String | 否 | 法定代表人(最大100字符) |
|
||||
| legalCertType | String | 否 | 法定代表人证件类型(最大50字符) |
|
||||
| legalCertNo | String | 否 | 法定代表人证件号码(最大50字符) |
|
||||
| shareholder1-5 | String | 否 | 股东信息(每个最大100字符) |
|
||||
| remark | String | 否 | 备注(最大500字符) |
|
||||
|
||||
**响应示例**:
|
||||
```json
|
||||
{
|
||||
"code": 200,
|
||||
"msg": "操作成功"
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 6. 修改个人中介
|
||||
|
||||
**接口地址**: `PUT /ccdi/intermediary/person`
|
||||
|
||||
**权限要求**: `ccdi:intermediary:edit`
|
||||
|
||||
**请求体** (application/json):
|
||||
```json
|
||||
{
|
||||
"bizId": "I202602040001",
|
||||
"name": "张三",
|
||||
"personType": "中介",
|
||||
"personSubType": "本人",
|
||||
"relationType": "正常",
|
||||
"gender": "M",
|
||||
"idType": "身份证",
|
||||
"personId": "110101199001011234",
|
||||
"mobile": "13800138000",
|
||||
"wechatNo": "zhangsan",
|
||||
"contactAddress": "北京市朝阳区",
|
||||
"company": "XX公司",
|
||||
"socialCreditCode": "91110000123456789X",
|
||||
"position": "经纪人",
|
||||
"relatedNumId": "",
|
||||
"relation": "",
|
||||
"remark": "测试数据"
|
||||
}
|
||||
```
|
||||
|
||||
**字段说明**: 与新增个人中介相同,bizId为必填项
|
||||
|
||||
**响应示例**:
|
||||
```json
|
||||
{
|
||||
"code": 200,
|
||||
"msg": "操作成功"
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 7. 修改实体中介
|
||||
|
||||
**接口地址**: `PUT /ccdi/intermediary/entity`
|
||||
|
||||
**权限要求**: `ccdi:intermediary:edit`
|
||||
|
||||
**请求体** (application/json):
|
||||
```json
|
||||
{
|
||||
"socialCreditCode": "91110000123456789X",
|
||||
"enterpriseName": "XX中介公司",
|
||||
"enterpriseType": "有限责任公司",
|
||||
"enterpriseNature": "民企",
|
||||
"industryClass": "房地产",
|
||||
"industryName": "房地产业",
|
||||
"establishDate": "2020-01-01",
|
||||
"registerAddress": "北京市朝阳区",
|
||||
"legalRepresentative": "张三",
|
||||
"legalCertType": "身份证",
|
||||
"legalCertNo": "110101199001011234",
|
||||
"shareholder1": "李四",
|
||||
"shareholder2": "王五",
|
||||
"shareholder3": "",
|
||||
"shareholder4": "",
|
||||
"shareholder5": "",
|
||||
"remark": "测试数据"
|
||||
}
|
||||
```
|
||||
|
||||
**字段说明**: 与新增实体中介相同,socialCreditCode为必填项
|
||||
|
||||
**响应示例**:
|
||||
```json
|
||||
{
|
||||
"code": 200,
|
||||
"msg": "操作成功"
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 8. 删除中介
|
||||
|
||||
**接口地址**: `DELETE /ccdi/intermediary/{ids}`
|
||||
|
||||
**权限要求**: `ccdi:intermediary:remove`
|
||||
|
||||
**路径参数**:
|
||||
|
||||
| 参数名 | 类型 | 必填 | 说明 |
|
||||
|--------|------|------|------|
|
||||
| ids | String[] | 是 | 业务ID数组(逗号分隔) |
|
||||
|
||||
**响应示例**:
|
||||
```json
|
||||
{
|
||||
"code": 200,
|
||||
"msg": "操作成功"
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 9. 校验人员ID唯一性
|
||||
|
||||
**接口地址**: `GET /ccdi/intermediary/checkPersonIdUnique`
|
||||
|
||||
**权限要求**: 无
|
||||
|
||||
**请求参数**:
|
||||
|
||||
| 参数名 | 类型 | 必填 | 说明 |
|
||||
|--------|------|------|------|
|
||||
| personId | String | 是 | 证件号码 |
|
||||
| bizId | String | 否 | 排除的业务ID(修改时使用) |
|
||||
|
||||
**响应示例**:
|
||||
```json
|
||||
{
|
||||
"code": 200,
|
||||
"msg": "操作成功",
|
||||
"data": true
|
||||
}
|
||||
```
|
||||
|
||||
**data字段说明**: true=唯一可用, false=已存在
|
||||
|
||||
---
|
||||
|
||||
### 10. 校验统一社会信用代码唯一性
|
||||
|
||||
**接口地址**: `GET /ccdi/intermediary/checkSocialCreditCodeUnique`
|
||||
|
||||
**权限要求**: 无
|
||||
|
||||
**请求参数**:
|
||||
|
||||
| 参数名 | 类型 | 必填 | 说明 |
|
||||
|--------|------|------|------|
|
||||
| socialCreditCode | String | 是 | 统一社会信用代码 |
|
||||
| excludeId | String | 否 | 排除的ID(修改时使用) |
|
||||
|
||||
**响应示例**:
|
||||
```json
|
||||
{
|
||||
"code": 200,
|
||||
"msg": "操作成功",
|
||||
"data": true
|
||||
}
|
||||
```
|
||||
|
||||
**data字段说明**: true=唯一可用, false=已存在
|
||||
|
||||
---
|
||||
|
||||
### 11. 下载个人中介导入模板
|
||||
|
||||
**接口地址**: `POST /ccdi/intermediary/importPersonTemplate`
|
||||
|
||||
**权限要求**: 无
|
||||
|
||||
**响应**: Excel模板文件下载
|
||||
|
||||
**Excel格式说明**:
|
||||
|
||||
**Sheet1: 个人中介信息**
|
||||
| 姓名 | 人员类型 | 人员子类型 | 关系类型 | 性别▼ | 证件类型▼ | 证件号码 | 手机号码 | 微信号 | 联系地址 | 所在公司 | 企业统一信用码 | 职位 | 关联人员ID | 关联关系 | 备注 |
|
||||
|------|---------|-----------|---------|-------|-----------|---------|---------|--------|---------|---------|--------------|-----|-----------|---------|------|
|
||||
| 张三 | 中介 | 本人 | 正常 | 男 | 身份证 | 110101199001011234 | 13800138000 | zhangsan | 北京市朝阳区 | XX公司 | 91110000XXXXXXXXXX | 经纪人 | - | - | 测试 |
|
||||
|
||||
**注**: 带▼标记的列包含下拉框,选项来自字典
|
||||
|
||||
---
|
||||
|
||||
### 12. 下载实体中介导入模板
|
||||
|
||||
**接口地址**: `POST /ccdi/intermediary/importEntityTemplate`
|
||||
|
||||
**权限要求**: 无
|
||||
|
||||
**响应**: Excel模板文件下载
|
||||
|
||||
**Excel格式说明**:
|
||||
|
||||
**Sheet1: 实体中介信息**
|
||||
| 机构名称 | 统一社会信用代码 | 主体类型▼ | 企业性质▼ | 行业分类 | 所属行业 | 成立日期 | 注册地址 | 法定代表人 | 法定代表人证件类型 | 法定代表人证件号码 | 股东1 | 股东2 | 股东3 | 股东4 | 股东5 | 备注 |
|
||||
|---------|-----------------|-----------|-----------|---------|---------|---------|---------|-----------|-------------------|-------------------|-------|-------|-------|-------|-------|------|
|
||||
| XX公司 | 91110000XXXXXXXXXX | 有限责任公司 | 民企 | 房地产 | 房地产业 | 2020-01-01 | 北京市朝阳区 | 张三 | 身份证 | 110101199001011234 | 李四 | 王五 | - | - | - | - |
|
||||
|
||||
---
|
||||
|
||||
### 13. 导入个人中介数据
|
||||
|
||||
**接口地址**: `POST /ccdi/intermediary/importPersonData`
|
||||
|
||||
**权限要求**: `ccdi:intermediary:import`
|
||||
|
||||
**请求参数** (multipart/form-data):
|
||||
|
||||
| 参数名 | 类型 | 必填 | 说明 |
|
||||
|--------|------|------|------|
|
||||
| file | File | 是 | Excel文件 |
|
||||
| updateSupport | Boolean | 否 | 是否更新已存在数据(默认false) |
|
||||
|
||||
**响应示例**:
|
||||
```json
|
||||
{
|
||||
"code": 200,
|
||||
"msg": "恭喜您,数据已全部导入成功!共10条"
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 14. 导入实体中介数据
|
||||
|
||||
**接口地址**: `POST /ccdi/intermediary/importEntityData`
|
||||
|
||||
**权限要求**: `ccdi:intermediary:import`
|
||||
|
||||
**请求参数** (multipart/form-data):
|
||||
|
||||
| 参数名 | 类型 | 必填 | 说明 |
|
||||
|--------|------|------|------|
|
||||
| file | File | 是 | Excel文件 |
|
||||
| updateSupport | Boolean | 否 | 是否更新已存在数据(默认false) |
|
||||
|
||||
**响应示例**:
|
||||
```json
|
||||
{
|
||||
"code": 200,
|
||||
"msg": "恭喜您,数据已全部导入成功!共10条"
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 字典数据说明
|
||||
|
||||
导入模板中的下拉框选项来自系统字典管理,相关字典类型:
|
||||
|
||||
| 字典类型 | 字典名称 | 用途 |
|
||||
|---------|---------|------|
|
||||
| ccdi_indiv_gender | 个人中介性别 | 个人中介模板性别下拉框 |
|
||||
| ccdi_certificate_type | 证件类型 | 个人中介模板证件类型下拉框 |
|
||||
| ccdi_entity_type | 主体类型 | 机构中介模板主体类型下拉框 |
|
||||
| ccdi_enterprise_nature | 企业性质 | 机构中介模板企业性质下拉框 |
|
||||
| ccdi_data_source | 数据来源 | 数据来源字段映射 |
|
||||
|
||||
---
|
||||
|
||||
## 错误码说明
|
||||
|
||||
| HTTP状态码 | 错误码 | 说明 |
|
||||
|-----------|--------|------|
|
||||
| 200 | 200 | 操作成功 |
|
||||
| 401 | 401 | 未授权,请先登录 |
|
||||
| 403 | 403 | 无权限访问 |
|
||||
| 500 | 500 | 服务器内部错误 |
|
||||
|
||||
---
|
||||
|
||||
## 业务错误信息
|
||||
|
||||
| 错误信息 | 说明 |
|
||||
|----------|------|
|
||||
| 姓名不能为空 | 个人中介新增/修改时姓名为空 |
|
||||
| 机构名称不能为空 | 实体中介新增/修改时机构名称为空 |
|
||||
| 证件号码不能为空 | 个人中介新增/修改时证件号码为空 |
|
||||
| 该证件号已存在 | 新增/导入时证件号重复 |
|
||||
| 该统一社会信用代码已存在 | 新增/导入时信用代码重复 |
|
||||
| 姓名长度不能超过100个字符 | 姓名超长 |
|
||||
| 证件号码长度不能超过50个字符 | 证件号码超长 |
|
||||
| 机构名称长度不能超过200个字符 | 机构名称超长 |
|
||||
|
||||
---
|
||||
|
||||
## 测试账号
|
||||
|
||||
- 用户名: `admin`
|
||||
- 密码: `admin123`
|
||||
|
||||
测试前请先调用 `/login/test` 接口获取Token。
|
||||
|
||||
---
|
||||
|
||||
## 更新日志
|
||||
|
||||
| 版本 | 日期 | 说明 |
|
||||
|------|------|------|
|
||||
| 1.0.0 | 2026-01-29 | 初始版本,支持个人和机构分类管理 |
|
||||
| 1.1.0 | 2026-01-29 | 添加字典下拉框功能,分离个人/机构模板 |
|
||||
| 1.2.0 | 2026-01-29 | 修改接口分离:新增个人/机构专用修改接口,修复中介类型修改问题 |
|
||||
| 1.3.0 | 2026-01-29 | 新增接口分离:新增个人/机构专用新增接口,统一接口设计 |
|
||||
| 2.0.0 | 2026-02-04 | 重构版本:使用MyBatis Plus,分离DTO/VO,统一业务ID(bizId),优化查询接口 |
|
||||
|
||||
---
|
||||
|
||||
## 主要变更说明 (v2.0)
|
||||
|
||||
### 架构变更
|
||||
- 使用MyBatis Plus替代原生MyBatis
|
||||
- 分离DTO(请求)和VO(响应)对象
|
||||
- 统一使用业务ID(bizId)作为主键
|
||||
|
||||
### 接口变更
|
||||
- 查询详情接口分离为个人和实体两个接口
|
||||
- 新增接口分离为个人和实体两个接口
|
||||
- 修改接口分离为个人和实体两个接口
|
||||
- 新增唯一性校验接口
|
||||
|
||||
### 数据模型变更
|
||||
- 个人中介使用`personId`作为证件号字段
|
||||
- 实体中介使用`socialCreditCode`作为统一社会信用代码字段
|
||||
- 删除了`intermediaryId`,统一使用`bizId`
|
||||
|
||||
### 查询功能增强
|
||||
- 支持按中介类型查询
|
||||
- 支持按姓名/机构名称模糊查询
|
||||
- 支持按证件号/统一社会信用代码精确查询
|
||||
@@ -1,726 +0,0 @@
|
||||
# 中介黑名单管理 API 文档 v2.0
|
||||
|
||||
## 概述
|
||||
|
||||
中介黑名单管理模块提供个人和机构两类中介信息的增删改查、类型化模板下载和批量导入导出功能。
|
||||
|
||||
**基础路径**: `/ccdi/intermediary`
|
||||
|
||||
**权限标识前缀**: `ccdi:intermediary`
|
||||
|
||||
**技术栈**: Spring Boot 3 + MyBatis Plus + MySQL
|
||||
|
||||
---
|
||||
|
||||
## API 接口列表
|
||||
|
||||
### 1. 查询中介黑名单列表
|
||||
|
||||
**接口地址**: `GET /ccdi/intermediary/list`
|
||||
|
||||
**权限要求**: `ccdi:intermediary:list`
|
||||
|
||||
**请求参数**:
|
||||
|
||||
| 参数名 | 类型 | 必填 | 说明 |
|
||||
|--------|------|------|------|
|
||||
| name | String | 否 | 姓名/机构名称（模糊查询） |
|
||||
| certificateNo | String | 否 | 证件号/统一社会信用代码（精确查询） |
|
||||
| intermediaryType | String | 否 | 中介类型（1=个人, 2=机构） |
|
||||
| pageNum | Integer | 否 | 页码（默认1） |
|
||||
| pageSize | Integer | 否 | 每页数量（默认10） |
|
||||
|
||||
**响应示例**:
|
||||
```json
|
||||
{
|
||||
"code": 200,
|
||||
"msg": "操作成功",
|
||||
"rows": [
|
||||
{
|
||||
"id": "abc123",
|
||||
"name": "张三",
|
||||
"certificateNo": "110101199001011234",
|
||||
"intermediaryType": "1",
|
||||
"personType": "中介",
|
||||
"company": "XX公司",
|
||||
"dataSource": "MANUAL",
|
||||
"createTime": "2026-02-04 10:00:00",
|
||||
"updateTime": "2026-02-05 14:30:00"
|
||||
}
|
||||
],
|
||||
"total": 1
|
||||
}
|
||||
```
|
||||
|
||||
**响应字段说明**:
|
||||
|
||||
| 字段名 | 类型 | 说明 |
|
||||
|--------|------|------|
|
||||
| id | String | ID（个人为bizId，实体为socialCreditCode） |
|
||||
| name | String | 姓名/机构名称 |
|
||||
| certificateNo | String | 证件号/统一社会信用代码 |
|
||||
| intermediaryType | String | 中介类型（1=个人, 2=实体） |
|
||||
| personType | String | 人员类型/实体 |
|
||||
| company | String | 公司/机构名称 |
|
||||
| dataSource | String | 数据来源（MANUAL=手动, IMPORT=导入, API=接口） |
|
||||
| createTime | Date | 创建时间 |
|
||||
| updateTime | Date | 修改时间 |
|
||||
|
||||
---
|
||||
|
||||
### 2. 查询个人中介详情
|
||||
|
||||
**接口地址**: `GET /ccdi/intermediary/person/{bizId}`
|
||||
|
||||
**权限要求**: `ccdi:intermediary:query`
|
||||
|
||||
**路径参数**:
|
||||
|
||||
| 参数名 | 类型 | 必填 | 说明 |
|
||||
|--------|------|------|------|
|
||||
| bizId | String | 是 | 人员业务ID |
|
||||
|
||||
**响应示例**:
|
||||
```json
|
||||
{
|
||||
"code": 200,
|
||||
"msg": "操作成功",
|
||||
"data": {
|
||||
"bizId": "abc123xyz456",
|
||||
"intermediaryType": "1",
|
||||
"name": "张三",
|
||||
"personType": "房产中介",
|
||||
"personSubType": "本人",
|
||||
"gender": "M",
|
||||
"idType": "身份证",
|
||||
"personId": "110101199001011234",
|
||||
"mobile": "13800138000",
|
||||
"wechatNo": "zhangsan_wx",
|
||||
"contactAddress": "北京市朝阳区XX路XX号",
|
||||
"company": "XX房产中介公司",
|
||||
"position": "经纪人",
|
||||
"socialCreditCode": "91110000XXXXXXXXXX",
|
||||
"relatedNumId": "rel123",
|
||||
"relationType": "配偶",
|
||||
"dataSource": "MANUAL",
|
||||
"remark": "测试数据",
|
||||
"createTime": "2026-02-04 10:00:00"
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
**响应字段说明**:
|
||||
|
||||
| 字段名 | 类型 | 说明 |
|
||||
|--------|------|------|
|
||||
| bizId | String | 人员业务ID |
|
||||
| intermediaryType | String | 中介类型（固定为"1"） |
|
||||
| name | String | 姓名 |
|
||||
| personType | String | 人员类型（房产中介、贷款中介等） |
|
||||
| personSubType | String | 人员子类型（本人、配偶、父亲等） |
|
||||
| gender | String | 性别（M=男, F=女, O=其他） |
|
||||
| idType | String | 证件类型（身份证、护照等） |
|
||||
| personId | String | 证件号码 |
|
||||
| mobile | String | 手机号码 |
|
||||
| wechatNo | String | 微信号 |
|
||||
| contactAddress | String | 联系地址 |
|
||||
| company | String | 所在公司 |
|
||||
| position | String | 职位 |
|
||||
| socialCreditCode | String | 企业统一信用码 |
|
||||
| relatedNumId | String | 关联人员ID |
|
||||
| relationType | String | 关联关系（配偶、父子、母女等） |
|
||||
| dataSource | String | 数据来源 |
|
||||
| remark | String | 备注 |
|
||||
| createTime | Date | 创建时间 |
|
||||
|
||||
---
|
||||
|
||||
### 3. 查询实体中介详情
|
||||
|
||||
**接口地址**: `GET /ccdi/intermediary/entity/{socialCreditCode}`
|
||||
|
||||
**权限要求**: `ccdi:intermediary:query`
|
||||
|
||||
**路径参数**:
|
||||
|
||||
| 参数名 | 类型 | 必填 | 说明 |
|
||||
|--------|------|------|------|
|
||||
| socialCreditCode | String | 是 | 统一社会信用代码 |
|
||||
|
||||
**响应示例**:
|
||||
```json
|
||||
{
|
||||
"code": 200,
|
||||
"msg": "操作成功",
|
||||
"data": {
|
||||
"socialCreditCode": "91110000XXXXXXXXXX",
|
||||
"intermediaryType": "2",
|
||||
"enterpriseName": "XX中介公司",
|
||||
"enterpriseType": "有限责任公司",
|
||||
"enterpriseNature": "民企",
|
||||
"industryClass": "房地产",
|
||||
"industryName": "房地产业",
|
||||
"establishDate": "2020-01-01",
|
||||
"registerAddress": "北京市朝阳区XX路XX号",
|
||||
"legalRepresentative": "张三",
|
||||
"legalCertType": "身份证",
|
||||
"legalCertNo": "110101199001011234",
|
||||
"shareholder1": "李四",
|
||||
"shareholder2": "王五",
|
||||
"shareholder3": "赵六",
|
||||
"shareholder4": null,
|
||||
"shareholder5": null,
|
||||
"dataSource": "MANUAL",
|
||||
"remark": "测试数据",
|
||||
"createTime": "2026-02-04 10:00:00"
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
**响应字段说明**:
|
||||
|
||||
| 字段名 | 类型 | 说明 |
|
||||
|--------|------|------|
|
||||
| socialCreditCode | String | 统一社会信用代码 |
|
||||
| intermediaryType | String | 中介类型（固定为"2"） |
|
||||
| enterpriseName | String | 机构名称 |
|
||||
| enterpriseType | String | 主体类型 |
|
||||
| enterpriseNature | String | 企业性质 |
|
||||
| industryClass | String | 行业分类 |
|
||||
| industryName | String | 所属行业 |
|
||||
| establishDate | Date | 成立日期 |
|
||||
| registerAddress | String | 注册地址 |
|
||||
| legalRepresentative | String | 法定代表人 |
|
||||
| legalCertType | String | 法定代表人证件类型 |
|
||||
| legalCertNo | String | 法定代表人证件号码 |
|
||||
| shareholder1-5 | String | 股东信息 |
|
||||
| dataSource | String | 数据来源 |
|
||||
| remark | String | 备注 |
|
||||
| createTime | Date | 创建时间 |
|
||||
|
||||
---
|
||||
|
||||
### 4. 新增个人中介
|
||||
|
||||
**接口地址**: `POST /ccdi/intermediary/person`
|
||||
|
||||
**权限要求**: `ccdi:intermediary:add`
|
||||
|
||||
**请求体**:
|
||||
```json
|
||||
{
|
||||
"name": "张三",
|
||||
"personType": "房产中介",
|
||||
"personSubType": "本人",
|
||||
"gender": "M",
|
||||
"idType": "身份证",
|
||||
"personId": "110101199001011234",
|
||||
"mobile": "13800138000",
|
||||
"wechatNo": "zhangsan_wx",
|
||||
"contactAddress": "北京市朝阳区XX路XX号",
|
||||
"company": "XX房产中介公司",
|
||||
"position": "经纪人",
|
||||
"socialCreditCode": "91110000XXXXXXXXXX",
|
||||
"relatedNumId": "rel123",
|
||||
"relationType": "配偶",
|
||||
"remark": "测试数据"
|
||||
}
|
||||
```
|
||||
|
||||
**字段说明**:
|
||||
|
||||
| 字段名 | 类型 | 必填 | 说明 |
|
||||
|--------|------|------|------|
|
||||
| name | String | 是 | 姓名（1-100字符） |
|
||||
| personId | String | 是 | 证件号码（不超过50字符） |
|
||||
| personType | String | 否 | 人员类型（枚举值，见下文） |
|
||||
| personSubType | String | 否 | 人员子类型（枚举值，见下文） |
|
||||
| gender | String | 否 | 性别（M=男, F=女, O=其他） |
|
||||
| idType | String | 否 | 证件类型（枚举值，见下文） |
|
||||
| mobile | String | 否 | 手机号码（不超过20字符） |
|
||||
| wechatNo | String | 否 | 微信号（不超过50字符） |
|
||||
| contactAddress | String | 否 | 联系地址（不超过200字符） |
|
||||
| company | String | 否 | 所在公司（不超过200字符） |
|
||||
| position | String | 否 | 职位（不超过100字符） |
|
||||
| socialCreditCode | String | 否 | 企业统一信用码（不超过50字符） |
|
||||
| relatedNumId | String | 否 | 关联人员ID（不超过50字符） |
|
||||
| relationType | String | 否 | 关联关系（枚举值，见下文） |
|
||||
| remark | String | 否 | 备注（不超过500字符） |
|
||||
|
||||
**响应示例**:
|
||||
```json
|
||||
{
|
||||
"code": 200,
|
||||
"msg": "操作成功"
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 5. 新增实体中介
|
||||
|
||||
**接口地址**: `POST /ccdi/intermediary/entity`
|
||||
|
||||
**权限要求**: `ccdi:intermediary:add`
|
||||
|
||||
**请求体**:
|
||||
```json
|
||||
{
|
||||
"enterpriseName": "XX中介公司",
|
||||
"socialCreditCode": "91110000XXXXXXXXXX",
|
||||
"enterpriseType": "有限责任公司",
|
||||
"enterpriseNature": "民企",
|
||||
"industryClass": "房地产",
|
||||
"industryName": "房地产业",
|
||||
"establishDate": "2020-01-01",
|
||||
"registerAddress": "北京市朝阳区XX路XX号",
|
||||
"legalRepresentative": "张三",
|
||||
"legalCertType": "身份证",
|
||||
"legalCertNo": "110101199001011234",
|
||||
"shareholder1": "李四",
|
||||
"shareholder2": "王五",
|
||||
"shareholder3": "赵六",
|
||||
"shareholder4": null,
|
||||
"shareholder5": null,
|
||||
"remark": "测试数据"
|
||||
}
|
||||
```
|
||||
|
||||
**字段说明**:
|
||||
|
||||
| 字段名 | 类型 | 必填 | 说明 |
|
||||
|--------|------|------|------|
|
||||
| enterpriseName | String | 是 | 机构名称（1-200字符） |
|
||||
| socialCreditCode | String | 是 | 统一社会信用代码（不超过50字符） |
|
||||
| enterpriseType | String | 否 | 主体类型（枚举值，见下文） |
|
||||
| enterpriseNature | String | 否 | 企业性质（枚举值，见下文） |
|
||||
| industryClass | String | 否 | 行业分类（不超过100字符） |
|
||||
| industryName | String | 否 | 所属行业（不超过100字符） |
|
||||
| establishDate | Date | 否 | 成立日期（yyyy-MM-dd） |
|
||||
| registerAddress | String | 否 | 注册地址（不超过500字符） |
|
||||
| legalRepresentative | String | 否 | 法定代表人（不超过100字符） |
|
||||
| legalCertType | String | 否 | 法定代表人证件类型（枚举值） |
|
||||
| legalCertNo | String | 否 | 法定代表人证件号码（不超过50字符） |
|
||||
| shareholder1-5 | String | 否 | 股东信息（每个不超过100字符） |
|
||||
| remark | String | 否 | 备注（不超过500字符） |
|
||||
|
||||
**响应示例**:
|
||||
```json
|
||||
{
|
||||
"code": 200,
|
||||
"msg": "操作成功"
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 6. 修改个人中介
|
||||
|
||||
**接口地址**: `PUT /ccdi/intermediary/person`
|
||||
|
||||
**权限要求**: `ccdi:intermediary:edit`
|
||||
|
||||
**请求体**:
|
||||
```json
|
||||
{
|
||||
"bizId": "abc123xyz456",
|
||||
"name": "张三",
|
||||
"personType": "房产中介",
|
||||
"personSubType": "本人",
|
||||
"gender": "M",
|
||||
"idType": "身份证",
|
||||
"personId": "110101199001011234",
|
||||
"mobile": "13800138000",
|
||||
"wechatNo": "zhangsan_wx",
|
||||
"contactAddress": "北京市朝阳区XX路XX号",
|
||||
"company": "XX房产中介公司",
|
||||
"position": "经纪人",
|
||||
"socialCreditCode": "91110000XXXXXXXXXX",
|
||||
"relatedNumId": "rel123",
|
||||
"relationType": "配偶",
|
||||
"remark": "测试数据"
|
||||
}
|
||||
```
|
||||
|
||||
**字段说明**: 与新增接口相同，但 `bizId` 为必填项。
|
||||
|
||||
**响应示例**:
|
||||
```json
|
||||
{
|
||||
"code": 200,
|
||||
"msg": "操作成功"
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 7. 修改实体中介
|
||||
|
||||
**接口地址**: `PUT /ccdi/intermediary/entity`
|
||||
|
||||
**权限要求**: `ccdi:intermediary:edit`
|
||||
|
||||
**请求体**:
|
||||
```json
|
||||
{
|
||||
"socialCreditCode": "91110000XXXXXXXXXX",
|
||||
"enterpriseName": "XX中介公司",
|
||||
"enterpriseType": "有限责任公司",
|
||||
"enterpriseNature": "民企",
|
||||
"industryClass": "房地产",
|
||||
"industryName": "房地产业",
|
||||
"establishDate": "2020-01-01",
|
||||
"registerAddress": "北京市朝阳区XX路XX号",
|
||||
"legalRepresentative": "张三",
|
||||
"legalCertType": "身份证",
|
||||
"legalCertNo": "110101199001011234",
|
||||
"shareholder1": "李四",
|
||||
"shareholder2": "王五",
|
||||
"shareholder3": "赵六",
|
||||
"shareholder4": null,
|
||||
"shareholder5": null,
|
||||
"remark": "测试数据"
|
||||
}
|
||||
```
|
||||
|
||||
**字段说明**: 与新增接口相同。
|
||||
|
||||
**响应示例**:
|
||||
```json
|
||||
{
|
||||
"code": 200,
|
||||
"msg": "操作成功"
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 8. 删除中介
|
||||
|
||||
**接口地址**: `DELETE /ccdi/intermediary/{ids}`
|
||||
|
||||
**权限要求**: `ccdi:intermediary:remove`
|
||||
|
||||
**路径参数**:
|
||||
|
||||
| 参数名 | 类型 | 必填 | 说明 |
|
||||
|--------|------|------|------|
|
||||
| ids | String[] | 是 | ID数组（个人为bizId，实体为socialCreditCode） |
|
||||
|
||||
**示例**: `/ccdi/intermediary/abc123,91110000XXXXXXXXXX`
|
||||
|
||||
**响应示例**:
|
||||
```json
|
||||
{
|
||||
"code": 200,
|
||||
"msg": "操作成功"
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 9. 校验人员ID唯一性
|
||||
|
||||
**接口地址**: `GET /ccdi/intermediary/checkPersonIdUnique`
|
||||
|
||||
**权限要求**: 无
|
||||
|
||||
**请求参数**:
|
||||
|
||||
| 参数名 | 类型 | 必填 | 说明 |
|
||||
|--------|------|------|------|
|
||||
| personId | String | 是 | 证件号码 |
|
||||
| bizId | String | 否 | 排除的人员ID（修改时使用） |
|
||||
|
||||
**响应示例**:
|
||||
```json
|
||||
{
|
||||
"code": 200,
|
||||
"msg": "操作成功",
|
||||
"data": true
|
||||
}
|
||||
```
|
||||
|
||||
**响应说明**: `true` 表示唯一，`false` 表示已存在。
|
||||
|
||||
---
|
||||
|
||||
### 10. 校验统一社会信用代码唯一性
|
||||
|
||||
**接口地址**: `GET /ccdi/intermediary/checkSocialCreditCodeUnique`
|
||||
|
||||
**权限要求**: 无
|
||||
|
||||
**请求参数**:
|
||||
|
||||
| 参数名 | 类型 | 必填 | 说明 |
|
||||
|--------|------|------|------|
|
||||
| socialCreditCode | String | 是 | 统一社会信用代码 |
|
||||
| excludeId | String | 否 | 排除的ID（修改时使用） |
|
||||
|
||||
**响应示例**:
|
||||
```json
|
||||
{
|
||||
"code": 200,
|
||||
"msg": "操作成功",
|
||||
"data": true
|
||||
}
|
||||
```
|
||||
|
||||
**响应说明**: `true` 表示唯一，`false` 表示已存在。
|
||||
|
||||
---
|
||||
|
||||
## 枚举接口
|
||||
|
||||
### 获取人员类型选项
|
||||
|
||||
**接口地址**: `GET /ccdi/enum/indivType`
|
||||
|
||||
**权限要求**: 无
|
||||
|
||||
**响应示例**:
|
||||
```json
|
||||
{
|
||||
"code": 200,
|
||||
"msg": "操作成功",
|
||||
"data": [
|
||||
{ "value": "房产中介", "label": "房产中介" },
|
||||
{ "value": "贷款中介", "label": "贷款中介" },
|
||||
{ "value": "职业背债人", "label": "职业背债人" },
|
||||
{ "value": "担保中介", "label": "担保中介" },
|
||||
{ "value": "评估中介", "label": "评估中介" }
|
||||
]
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 获取人员子类型选项
|
||||
|
||||
**接口地址**: `GET /ccdi/enum/indivSubType`
|
||||
|
||||
**权限要求**: 无
|
||||
|
||||
**响应示例**:
|
||||
```json
|
||||
{
|
||||
"code": 200,
|
||||
"msg": "操作成功",
|
||||
"data": [
|
||||
{ "value": "本人", "label": "本人" },
|
||||
{ "value": "配偶", "label": "配偶" },
|
||||
{ "value": "父亲", "label": "父亲" },
|
||||
{ "value": "母亲", "label": "母亲" },
|
||||
{ "value": "兄弟", "label": "兄弟" },
|
||||
{ "value": "姐妹", "label": "姐妹" },
|
||||
{ "value": "子女", "label": "子女" }
|
||||
]
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 获取性别选项
|
||||
|
||||
**接口地址**: `GET /ccdi/enum/gender`
|
||||
|
||||
**权限要求**: 无
|
||||
|
||||
**响应示例**:
|
||||
```json
|
||||
{
|
||||
"code": 200,
|
||||
"msg": "操作成功",
|
||||
"data": [
|
||||
{ "value": "M", "label": "男" },
|
||||
{ "value": "F", "label": "女" },
|
||||
{ "value": "O", "label": "其他" }
|
||||
]
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 获取证件类型选项
|
||||
|
||||
**接口地址**: `GET /ccdi/enum/certType`
|
||||
|
||||
**权限要求**: 无
|
||||
|
||||
**响应示例**:
|
||||
```json
|
||||
{
|
||||
"code": 200,
|
||||
"msg": "操作成功",
|
||||
"data": [
|
||||
{ "value": "身份证", "label": "身份证" },
|
||||
{ "value": "护照", "label": "护照" },
|
||||
{ "value": "港澳通行证", "label": "港澳通行证" },
|
||||
{ "value": "台湾通行证", "label": "台湾通行证" }
|
||||
]
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 获取关联关系选项
|
||||
|
||||
**接口地址**: `GET /ccdi/enum/relationType`
|
||||
|
||||
**权限要求**: 无
|
||||
|
||||
**响应示例**:
|
||||
```json
|
||||
{
|
||||
"code": 200,
|
||||
"msg": "操作成功",
|
||||
"data": [
|
||||
{ "value": "配偶", "label": "配偶" },
|
||||
{ "value": "父子", "label": "父子" },
|
||||
{ "value": "母女", "label": "母女" },
|
||||
{ "value": "兄弟", "label": "兄弟" },
|
||||
{ "value": "姐妹", "label": "姐妹" },
|
||||
{ "value": "亲属", "label": "亲属" },
|
||||
{ "value": "朋友", "label": "朋友" },
|
||||
{ "value": "同事", "label": "同事" }
|
||||
]
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 获取主体类型选项
|
||||
|
||||
**接口地址**: `GET /ccdi/enum/corpType`
|
||||
|
||||
**权限要求**: 无
|
||||
|
||||
**响应示例**:
|
||||
```json
|
||||
{
|
||||
"code": 200,
|
||||
"msg": "操作成功",
|
||||
"data": [
|
||||
{ "value": "有限责任公司", "label": "有限责任公司" },
|
||||
{ "value": "股份有限公司", "label": "股份有限公司" },
|
||||
{ "value": "个体工商户", "label": "个体工商户" },
|
||||
{ "value": "合伙企业", "label": "合伙企业" },
|
||||
{ "value": "个人独资企业", "label": "个人独资企业" }
|
||||
]
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 获取企业性质选项
|
||||
|
||||
**接口地址**: `GET /ccdi/enum/corpNature`
|
||||
|
||||
**权限要求**: 无
|
||||
|
||||
**响应示例**:
|
||||
```json
|
||||
{
|
||||
"code": 200,
|
||||
"msg": "操作成功",
|
||||
"data": [
|
||||
{ "value": "国企", "label": "国企" },
|
||||
{ "value": "民企", "label": "民企" },
|
||||
{ "value": "外企", "label": "外企" },
|
||||
{ "value": "合资", "label": "合资" }
|
||||
]
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 获取数据来源选项
|
||||
|
||||
**接口地址**: `GET /ccdi/enum/dataSource`
|
||||
|
||||
**权限要求**: 无
|
||||
|
||||
**响应示例**:
|
||||
```json
|
||||
{
|
||||
"code": 200,
|
||||
"msg": "操作成功",
|
||||
"data": [
|
||||
{ "value": "MANUAL", "label": "手动录入" },
|
||||
{ "value": "SYSTEM", "label": "系统同步" },
|
||||
{ "value": "IMPORT", "label": "批量导入" },
|
||||
{ "value": "API", "label": "接口获取" }
|
||||
]
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 错误码说明
|
||||
|
||||
| HTTP状态码 | 错误码 | 说明 |
|
||||
|-----------|--------|------|
|
||||
| 200 | 200 | 操作成功 |
|
||||
| 401 | 401 | 未授权，请先登录 |
|
||||
| 403 | 403 | 无权限访问 |
|
||||
| 500 | 500 | 服务器内部错误 |
|
||||
|
||||
## 业务错误信息
|
||||
|
||||
| 错误信息 | 说明 |
|
||||
|----------|------|
|
||||
| 姓名不能为空 | 新增/修改时姓名为空 |
|
||||
| 证件号码不能为空 | 新增时证件号码为空 |
|
||||
| 该证件号已存在 | 新增/导入时证件号重复 |
|
||||
| 该统一社会信用代码已存在 | 新增/导入时信用代码重复 |
|
||||
| 姓名长度不能超过100个字符 | 姓名超长 |
|
||||
| 证件号长度不能超过50个字符 | 证件号超长 |
|
||||
|
||||
## 测试账号
|
||||
|
||||
- **用户名**: `admin`
|
||||
- **密码**: `admin123`
|
||||
|
||||
**获取Token**: 调用 `POST /login/test` 接口获取Token，后续请求在 Header 中添加：
|
||||
```
|
||||
Authorization: Bearer {token}
|
||||
```
|
||||
|
||||
## 更新日志
|
||||
|
||||
| 版本 | 日期 | 说明 |
|
||||
|------|------|------|
|
||||
| 2.0.0 | 2026-02-05 | 统一字段命名，使用接口枚举，更新文档与实际代码一致 |
|
||||
| 1.3.0 | 2026-01-29 | 新增接口分离：个人/机构专用新增接口 |
|
||||
| 1.2.0 | 2026-01-29 | 修改接口分离：个人/机构专用修改接口 |
|
||||
| 1.1.0 | 2026-01-29 | 添加字典下拉框功能 |
|
||||
| 1.0.0 | 2026-01-29 | 初始版本 |
|
||||
|
||||
## 注意事项
|
||||
|
||||
1. **中介类型字段**:
|
||||
- 个人中介：`intermediaryType = "1"`
|
||||
- 实体中介：`intermediaryType = "2"`
|
||||
|
||||
2. **枚举值使用**:
|
||||
- 所有下拉选项字段应使用枚举接口返回的 `value` 值
|
||||
- 不要硬编码或使用字典表的 `dictValue`
|
||||
|
||||
3. **数据来源字段**:
|
||||
- 手动录入：`MANUAL`
|
||||
- 系统同步：`SYSTEM`
|
||||
- 批量导入：`IMPORT`
|
||||
- 接口获取：`API`
|
||||
|
||||
4. **分页排序**:
|
||||
- 列表查询默认按 `updateTime` 降序排列
|
||||
- 使用 MyBatis Plus 分页插件
|
||||
|
||||
5. **ID字段**:
|
||||
- 个人中介使用 `bizId` 作为唯一标识
|
||||
- 实体中介使用 `socialCreditCode` 作为唯一标识
|
||||
|
||||
6. **批量操作**:
|
||||
- 删除接口支持同时删除个人和实体中介
|
||||
- 根据ID长度自动判断类型（个人ID较长）
|
||||
@@ -1,271 +0,0 @@
|
||||
# 中介黑名单管理API测试报告
|
||||
|
||||
## 测试概述
|
||||
|
||||
**测试时间:** 2026-01-29 16:43:11
|
||||
**测试环境:** http://localhost:8080
|
||||
**测试账号:** admin
|
||||
**测试脚本:** [test_intermediary_blacklist.sh](../scripts/test_intermediary_blacklist.sh)
|
||||
**测试通过率:** 100.00%
|
||||
|
||||
## 测试结果汇总
|
||||
|
||||
| 指标 | 数值 |
|
||||
|------|------|
|
||||
| 测试场景总数 | 11 |
|
||||
| 通过数量 | 11 |
|
||||
| 失败数量 | 0 |
|
||||
| 通过率 | 100.00% |
|
||||
|
||||
## 测试用例详情
|
||||
|
||||
### 1. 登录测试
|
||||
|
||||
**接口:** `POST /login/test`
|
||||
**描述:** 使用测试账号登录获取认证token
|
||||
|
||||
**请求参数:**
|
||||
```json
|
||||
{
|
||||
"username": "admin",
|
||||
"password": "admin123"
|
||||
}
|
||||
```
|
||||
|
||||
**测试结果:** ✅ 通过
|
||||
- 成功获取token
|
||||
- token格式正确
|
||||
|
||||
---
|
||||
|
||||
### 2. 查询中介黑名单列表
|
||||
|
||||
**接口:** `GET /ccdi/intermediary/list`
|
||||
**描述:** 分页查询中介黑名单列表
|
||||
|
||||
**请求参数:**
|
||||
- pageNum: 1
|
||||
- pageSize: 10
|
||||
|
||||
**测试结果:** ✅ 通过
|
||||
- 返回分页数据结构正确
|
||||
- 包含 total 和 rows 字段
|
||||
- 数据格式符合预期
|
||||
|
||||
---
|
||||
|
||||
### 3. 新增个人中介黑名单
|
||||
|
||||
**接口:** `POST /ccdi/intermediary`
|
||||
**描述:** 新增个人类型的中介黑名单记录
|
||||
|
||||
**请求参数:**
|
||||
```json
|
||||
{
|
||||
"name": "测试个人中介_20260129_164311",
|
||||
"certificateNo": "TESTCERT20260129_164311",
|
||||
"intermediaryType": "1",
|
||||
"remark": "自动化测试数据"
|
||||
}
|
||||
```
|
||||
|
||||
**测试结果:** ✅ 通过
|
||||
- 成功创建记录
|
||||
- 返回状态码 200
|
||||
- 成功获取到新创建的ID: 2005
|
||||
|
||||
---
|
||||
|
||||
### 4. 新增机构中介黑名单
|
||||
|
||||
**接口:** `POST /ccdi/intermediary`
|
||||
**描述:** 新增机构类型的中介黑名单记录
|
||||
|
||||
**请求参数:**
|
||||
```json
|
||||
{
|
||||
"name": "测试机构中介_20260129_164311",
|
||||
"certificateNo": "TESTORG20260129_164311",
|
||||
"intermediaryType": "2",
|
||||
"remark": "自动化测试机构数据"
|
||||
}
|
||||
```
|
||||
|
||||
**测试结果:** ✅ 通过
|
||||
- 成功创建记录
|
||||
- 返回状态码 200
|
||||
- 成功获取到新创建的ID: 2006
|
||||
|
||||
---
|
||||
|
||||
### 5. 获取中介详情
|
||||
|
||||
**接口:** `GET /ccdi/intermediary/{intermediaryId}`
|
||||
**描述:** 根据ID获取中介详细信息
|
||||
|
||||
**请求参数:**
|
||||
- intermediaryId: 2005
|
||||
|
||||
**测试结果:** ✅ 通过
|
||||
- 成功获取详情信息
|
||||
- 返回完整的数据结构
|
||||
- 包含所有必要字段
|
||||
|
||||
---
|
||||
|
||||
### 6. 修改中介黑名单
|
||||
|
||||
**接口:** `PUT /ccdi/intermediary`
|
||||
**描述:** 修改已存在的中介信息
|
||||
|
||||
**请求参数:**
|
||||
```json
|
||||
{
|
||||
"intermediaryId": 2005,
|
||||
"name": "测试个人中介_修改",
|
||||
"certificateNo": "TESTCERT20260129_164311",
|
||||
"intermediaryType": "1",
|
||||
"status": "1",
|
||||
"remark": "修改后的自动化测试数据"
|
||||
}
|
||||
```
|
||||
|
||||
**测试结果:** ✅ 通过
|
||||
- 成功更新记录
|
||||
- 返回状态码 200
|
||||
- 数据修改生效
|
||||
|
||||
---
|
||||
|
||||
### 7. 导出中介黑名单列表
|
||||
|
||||
**接口:** `POST /ccdi/intermediary/export`
|
||||
**描述:** 导出中介黑名单数据为Excel文件
|
||||
|
||||
**请求参数:**
|
||||
```json
|
||||
{}
|
||||
```
|
||||
|
||||
**测试结果:** ✅ 通过
|
||||
- 成功导出Excel文件
|
||||
- 文件格式正确
|
||||
- 文件保存至: test_output/test6_export.xlsx
|
||||
|
||||
---
|
||||
|
||||
### 8. 下载个人中介导入模板
|
||||
|
||||
**接口:** `POST /ccdi/intermediary/importPersonTemplate`
|
||||
**描述:** 下载个人中介导入Excel模板
|
||||
|
||||
**测试结果:** ✅ 通过
|
||||
- 成功下载模板文件
|
||||
- 文件格式正确
|
||||
- 文件保存至: test_output/test7_person_template.xlsx
|
||||
|
||||
---
|
||||
|
||||
### 9. 下载机构中介导入模板
|
||||
|
||||
**接口:** `POST /ccdi/intermediary/importEntityTemplate`
|
||||
**描述:** 下载机构中介导入Excel模板
|
||||
|
||||
**测试结果:** ✅ 通过
|
||||
- 成功下载模板文件
|
||||
- 文件格式正确
|
||||
- 文件保存至: test_output/test8_entity_template.xlsx
|
||||
|
||||
---
|
||||
|
||||
### 10. 条件查询（按中介类型）
|
||||
|
||||
**接口:** `GET /ccdi/intermediary/list`
|
||||
**描述:** 按中介类型筛选查询
|
||||
|
||||
**请求参数:**
|
||||
- pageNum: 1
|
||||
- pageSize: 10
|
||||
- intermediaryType: 1 (个人)
|
||||
|
||||
**测试结果:** ✅ 通过
|
||||
- 查询结果正确
|
||||
- 数据筛选生效
|
||||
- 返回指定类型的数据
|
||||
|
||||
---
|
||||
|
||||
### 11. 条件查询（按状态）
|
||||
|
||||
**接口:** `GET /ccdi/intermediary/list`
|
||||
**描述:** 按状态筛选查询
|
||||
|
||||
**请求参数:**
|
||||
- pageNum: 1
|
||||
- pageSize: 10
|
||||
- status: 1
|
||||
|
||||
**测试结果:** ✅ 通过
|
||||
- 查询结果正确
|
||||
- 数据筛选生效
|
||||
- 返回指定状态的数据
|
||||
|
||||
---
|
||||
|
||||
### 12. 删除中介黑名单
|
||||
|
||||
**接口:** `DELETE /ccdi/intermediary/{intermediaryIds}`
|
||||
**描述:** 批量删除中介黑名单记录
|
||||
|
||||
**请求参数:**
|
||||
- intermediaryIds: 2005,2006
|
||||
|
||||
**测试结果:** ✅ 通过
|
||||
- 成功删除记录
|
||||
- 返回状态码 200
|
||||
- 数据删除生效
|
||||
|
||||
---
|
||||
|
||||
## 测试文件清单
|
||||
|
||||
### 响应JSON文件
|
||||
- `test1_list_response.json` - 查询列表响应
|
||||
- `test2_add_person_response.json` - 新增个人中介响应
|
||||
- `test3_add_entity_response.json` - 新增机构中介响应
|
||||
- `test4_get_info_response.json` - 获取详情响应
|
||||
- `test5_edit_response.json` - 修改中介响应
|
||||
- `test9_remove_response.json` - 删除中介响应
|
||||
- `test10_query_by_type_response.json` - 按类型查询响应
|
||||
- `test11_query_by_status_response.json` - 按状态查询响应
|
||||
|
||||
### Excel文件
|
||||
- `test6_export.xlsx` - 导出的数据文件
|
||||
- `test7_person_template.xlsx` - 个人中介导入模板
|
||||
- `test8_entity_template.xlsx` - 机构中介导入模板
|
||||
|
||||
### 报告文件
|
||||
- `test_report_20260129_164311.txt` - 详细测试日志
|
||||
|
||||
## 结论
|
||||
|
||||
**所有测试用例均已通过，中介黑名单管理API功能完整且运行正常。**
|
||||
|
||||
### 主要验证点
|
||||
1. ✅ 认证授权机制正常
|
||||
2. ✅ CRUD操作功能完整
|
||||
3. ✅ 分页查询功能正常
|
||||
4. ✅ 条件筛选功能正常
|
||||
5. ✅ 文件导入导出功能正常
|
||||
6. ✅ 批量操作功能正常
|
||||
|
||||
### 建议
|
||||
1. 建议在实际部署前进行压力测试
|
||||
2. 建议添加更多的边界条件测试用例
|
||||
3. 建议完善错误码和错误信息的文档
|
||||
|
||||
---
|
||||
|
||||
**报告生成时间:** 2026-01-29 16:43:11
|
||||
**测试工具:** curl + bash
|
||||
**报告生成者:** Claude Code
|
||||
@@ -1,316 +0,0 @@
|
||||
# 员工信息管理 API 文档
|
||||
|
||||
## 概述
|
||||
|
||||
员工信息管理模块提供员工信息的增删改查、批量导入导出功能。
|
||||
|
||||
**基础路径**: `/ccdi/employee`
|
||||
|
||||
**权限标识前缀**: `ccdi:employee`
|
||||
|
||||
**重要更新**: 自2026-02-05起,员工ID(employeeId)作为柜员号使用,为7位数字,手动输入,唯一不可重复。
|
||||
|
||||
---
|
||||
|
||||
## API 接口列表
|
||||
|
||||
### 1. 查询员工列表
|
||||
|
||||
**接口地址**: `GET /ccdi/employee/list`
|
||||
|
||||
**权限要求**: `ccdi:employee:list`
|
||||
|
||||
**请求参数**:
|
||||
|
||||
| 参数名 | 类型 | 必填 | 说明 |
|
||||
|--------|------|------|------|
|
||||
| name | String | 否 | 姓名(模糊查询) |
|
||||
| employeeId | Long | 否 | 员工ID(柜员号,精确查询,7位数字) |
|
||||
| deptId | Long | 否 | 所属部门ID |
|
||||
| idCard | String | 否 | 身份证号(精确查询) |
|
||||
| status | String | 否 | 状态(0=在职, 1=离职) |
|
||||
| pageNum | Integer | 否 | 页码(默认1) |
|
||||
| pageSize | Integer | 否 | 每页数量(默认10) |
|
||||
|
||||
**响应示例**:
|
||||
```json
|
||||
{
|
||||
"code": 200,
|
||||
"msg": "操作成功",
|
||||
"rows": [
|
||||
{
|
||||
"employeeId": 1000001,
|
||||
"name": "张三",
|
||||
"deptId": 100,
|
||||
"deptName": "总部",
|
||||
"idCard": "110101199001011234",
|
||||
"phone": "13800138000",
|
||||
"hireDate": "2020-01-01",
|
||||
"status": "0",
|
||||
"statusDesc": "在职",
|
||||
"createTime": "2026-01-28 10:00:00"
|
||||
}
|
||||
],
|
||||
"total": 1
|
||||
}
|
||||
```
|
||||
|
||||
**响应字段说明**:
|
||||
|
||||
| 字段名 | 类型 | 说明 |
|
||||
|--------|------|------|
|
||||
| employeeId | Long | 员工ID(柜员号,7位数字) |
|
||||
| name | String | 姓名 |
|
||||
| deptId | Long | 所属部门ID |
|
||||
| deptName | String | 所属部门名称(关联 sys_dept 表) |
|
||||
| idCard | String | 身份证号 |
|
||||
| phone | String | 电话 |
|
||||
| hireDate | Date | 入职时间 |
|
||||
| status | String | 状态(0=在职, 1=离职) |
|
||||
| statusDesc | String | 状态描述 |
|
||||
| createTime | Date | 创建时间 |
|
||||
|
||||
---
|
||||
|
||||
### 2. 查询员工详情
|
||||
|
||||
**接口地址**: `GET /ccdi/employee/{employeeId}`
|
||||
|
||||
**权限要求**: `ccdi:employee:query`
|
||||
|
||||
**路径参数**:
|
||||
|
||||
| 参数名 | 类型 | 必填 | 说明 |
|
||||
|--------|------|------|------|
|
||||
| employeeId | Long | 是 | 员工ID(柜员号) |
|
||||
|
||||
**响应示例**:
|
||||
```json
|
||||
{
|
||||
"code": 200,
|
||||
"msg": "操作成功",
|
||||
"data": {
|
||||
"employeeId": 1000001,
|
||||
"name": "张三",
|
||||
"deptId": 100,
|
||||
"idCard": "110101199001011234",
|
||||
"phone": "13800138000",
|
||||
"hireDate": "2020-01-01",
|
||||
"status": "0",
|
||||
"statusDesc": "在职",
|
||||
"createTime": "2026-01-28 10:00:00"
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 3. 新增员工
|
||||
|
||||
**接口地址**: `POST /ccdi/employee`
|
||||
|
||||
**权限要求**: `ccdi:employee:add`
|
||||
|
||||
**请求头**:
|
||||
```
|
||||
Content-Type: application/json
|
||||
Authorization: Bearer {token}
|
||||
```
|
||||
|
||||
**请求体**:
|
||||
```json
|
||||
{
|
||||
"employeeId": 1000001,
|
||||
"name": "张三",
|
||||
"deptId": 100,
|
||||
"idCard": "110101199001011234",
|
||||
"phone": "13800138000",
|
||||
"hireDate": "2020-01-01",
|
||||
"status": "0"
|
||||
}
|
||||
```
|
||||
|
||||
**字段说明**:
|
||||
|
||||
| 字段名 | 类型 | 必填 | 说明 | 校验规则 |
|
||||
|--------|------|------|------|----------|
|
||||
| employeeId | Long | 是 | 员工ID(柜员号,7位数字) | 必填,7位数字,唯一 |
|
||||
| name | String | 是 | 姓名 | 最大100字符 |
|
||||
| deptId | Long | 是 | 所属部门ID | 必填 |
|
||||
| idCard | String | 是 | 身份证号 | 18位,符合国标,唯一 |
|
||||
| phone | String | 是 | 电话 | 必填,11位手机号 |
|
||||
| hireDate | Date | 否 | 入职时间 | yyyy-MM-dd |
|
||||
| status | String | 是 | 状态 | 0=在职, 1=离职 |
|
||||
|
||||
**响应示例**:
|
||||
```json
|
||||
{
|
||||
"code": 200,
|
||||
"msg": "操作成功"
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 4. 编辑员工
|
||||
|
||||
**接口地址**: `PUT /ccdi/employee`
|
||||
|
||||
**权限要求**: `ccdi:employee:edit`
|
||||
|
||||
**请求体**:
|
||||
```json
|
||||
{
|
||||
"employeeId": 1000001,
|
||||
"name": "张三",
|
||||
"deptId": 100,
|
||||
"idCard": "110101199001011234",
|
||||
"phone": "13800138000",
|
||||
"hireDate": "2020-01-01",
|
||||
"status": "0"
|
||||
}
|
||||
```
|
||||
|
||||
**字段说明**: 与新增接口相同,employeeId 为必填项,编辑时不可修改柜员号。
|
||||
|
||||
**响应示例**:
|
||||
```json
|
||||
{
|
||||
"code": 200,
|
||||
"msg": "操作成功"
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 5. 删除员工
|
||||
|
||||
**接口地址**: `DELETE /ccdi/employee/{employeeIds}`
|
||||
|
||||
**权限要求**: `ccdi:employee:remove`
|
||||
|
||||
**路径参数**:
|
||||
|
||||
| 参数名 | 类型 | 必填 | 说明 |
|
||||
|--------|------|------|------|
|
||||
| employeeIds | Long[] | 是 | 员工ID数组（逗号分隔） |
|
||||
|
||||
**响应示例**:
|
||||
```json
|
||||
{
|
||||
"code": 200,
|
||||
"msg": "操作成功"
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 6. 导出员工信息
|
||||
|
||||
**接口地址**: `POST /ccdi/employee/export`
|
||||
|
||||
**权限要求**: `ccdi:employee:export`
|
||||
|
||||
**请求参数**: 与查询列表接口相同(支持筛选条件)
|
||||
|
||||
**响应**: Excel 文件下载
|
||||
|
||||
---
|
||||
|
||||
### 7. 下载导入模板(带字典下拉框)
|
||||
|
||||
**接口地址**: `POST /ccdi/employee/importTemplate`
|
||||
|
||||
**权限要求**: 无
|
||||
|
||||
**功能说明**: 下载的 Excel 模板中,"状态"列会自动添加字典下拉框,方便用户选择。
|
||||
|
||||
**响应**: Excel 模板文件下载
|
||||
|
||||
**Excel 格式说明**:
|
||||
|
||||
**Sheet1: 员工信息**
|
||||
| 姓名* | 柜员号* | 所属部门ID* | 身份证号* | 电话* | 入职时间 | 状态▼* |
|
||||
|------|--------|------------|----------|------|----------|------|
|
||||
| 张三 | 1000001 | 100 | 110101199001011234 | 13800138000 | 2020-01-01 | 在职 |
|
||||
|
||||
**注**:
|
||||
- 带 * 标记的列为必填项(姓名、柜员号、所属部门、身份证号、电话、状态)
|
||||
- 带 ▼ 标记的列包含下拉框,选项来自字典 `ccdi_employee_status`
|
||||
|
||||
**使用 @DictDropdown 注解实现**:
|
||||
- 状态字段使用 `@DictDropdown(dictType = "ccdi_employee_status")` 注解
|
||||
- 系统自动从 Redis 缓存读取字典数据并生成下拉框
|
||||
- 下拉选项可动态更新,刷新字典缓存后生效
|
||||
|
||||
---
|
||||
|
||||
### 8. 导入员工信息
|
||||
|
||||
**接口地址**: `POST /ccdi/employee/importData`
|
||||
|
||||
**权限要求**: `ccdi:employee:import`
|
||||
|
||||
**请求参数**:
|
||||
|
||||
| 参数名 | 类型 | 必填 | 说明 |
|
||||
|--------|------|------|------|
|
||||
| file | File | 是 | Excel 文件 |
|
||||
| updateSupport | Boolean | 否 | 是否更新已存在数据(默认false) |
|
||||
|
||||
**Excel 格式**:
|
||||
|
||||
**Sheet1: 员工信息**
|
||||
| 姓名* | 柜员号* | 所属部门ID* | 身份证号* | 电话* | 入职时间 | 状态* |
|
||||
|------|--------|------------|----------|------|----------|------|
|
||||
| 张三 | 1000001 | 100 | 110101199001011234 | 13800138000 | 2020-01-01 | 在职 |
|
||||
|
||||
**说明**:
|
||||
- ***标记为必填项**: 姓名、柜员号、所属部门、身份证号、电话、状态**
|
||||
- 柜员号: 7位数字,必填,唯一
|
||||
- 所属部门: 必须填写有效的部门ID
|
||||
- 电话: 必须填写11位手机号
|
||||
- 入职时间: 选填,格式为 yyyy-MM-dd
|
||||
|
||||
**响应示例**:
|
||||
```json
|
||||
{
|
||||
"code": 200,
|
||||
"msg": "恭喜您,数据已全部导入成功!共 10 条"
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 错误码说明
|
||||
|
||||
| 错误码 | 说明 |
|
||||
|--------|------|
|
||||
| 200 | 操作成功 |
|
||||
| 401 | 未授权,请先登录 |
|
||||
| 403 | 无权限访问 |
|
||||
| 500 | 服务器内部错误 |
|
||||
|
||||
## 业务错误信息
|
||||
|
||||
| 错误信息 | 说明 |
|
||||
|----------|------|
|
||||
| 该柜员号已存在 | 新增时柜员号重复 |
|
||||
| 柜员号不能为空 | 新增时柜员号为空 |
|
||||
| 柜员号必须为7位数字 | 柜员号格式不正确 |
|
||||
| 所属部门不能为空 | 新增时所属部门为空 |
|
||||
| 该身份证号已存在 | 新增/编辑时身份证号重复 |
|
||||
| 姓名不能为空 | 新增时姓名为空 |
|
||||
| 身份证号格式不正确 | 身份证号不符合18位国标 |
|
||||
| 电话不能为空 | 新增时电话为空 |
|
||||
| 电话格式不正确 | 手机号不符合11位格式 |
|
||||
| 状态只能填写'在职'或'离职' | 状态值不正确 |
|
||||
|
||||
---
|
||||
|
||||
## 测试账号
|
||||
|
||||
- 用户名: `admin`
|
||||
- 密码: `admin123`
|
||||
|
||||
测试前请先调用 `/login/test` 接口获取 Token。
|
||||
@@ -1,326 +0,0 @@
|
||||
# 后端枚举字段说明
|
||||
|
||||
## 概述
|
||||
|
||||
后端只返回枚举代码值，不返回枚举名称。前端需要根据代码值进行转换显示。
|
||||
|
||||
---
|
||||
|
||||
## API 返回的枚举字段
|
||||
|
||||
### 1. 中介类型 (intermediaryType)
|
||||
|
||||
| 代码值 | 说明 |
|
||||
|--------|------|
|
||||
| `1` | 个人中介 |
|
||||
| `2` | 机构中介 |
|
||||
|
||||
**前端转换示例:**
|
||||
```javascript
|
||||
const getIntermediaryTypeName = (type) => {
|
||||
const map = {
|
||||
'1': '个人',
|
||||
'2': '机构'
|
||||
}
|
||||
return map[type] || '未知'
|
||||
}
|
||||
```
|
||||
|
||||
### 2. 状态 (status)
|
||||
|
||||
| 代码值 | 说明 |
|
||||
|--------|------|
|
||||
| `0` | 正常 |
|
||||
| `1` | 停用 |
|
||||
|
||||
**前端转换示例:**
|
||||
```javascript
|
||||
const getStatusName = (status) => {
|
||||
const map = {
|
||||
'0': '正常',
|
||||
'1': '停用'
|
||||
}
|
||||
return map[status] || '未知'
|
||||
}
|
||||
```
|
||||
|
||||
### 3. 数据来源 (dataSource / date_source)
|
||||
|
||||
| 代码值 | 说明 |
|
||||
|--------|------|
|
||||
| `MANUAL` | 手动录入 |
|
||||
| `IMPORT` | 批量导入 |
|
||||
| `SYSTEM` | 系统同步 |
|
||||
| `API` | 接口获取 |
|
||||
|
||||
**前端转换示例:**
|
||||
```javascript
|
||||
const getDataSourceName = (source) => {
|
||||
const map = {
|
||||
'MANUAL': '手动录入',
|
||||
'IMPORT': '批量导入',
|
||||
'SYSTEM': '系统同步',
|
||||
'API': '接口获取'
|
||||
}
|
||||
return map[source] || '未知'
|
||||
}
|
||||
```
|
||||
|
||||
### 4. 性别 (indivGender) - 个人中介
|
||||
|
||||
| 代码值 | 说明 |
|
||||
|--------|------|
|
||||
| `M` | 男 |
|
||||
| `F` | 女 |
|
||||
| `O` | 其他 |
|
||||
|
||||
**前端转换示例:**
|
||||
```javascript
|
||||
const getGenderName = (gender) => {
|
||||
const map = {
|
||||
'M': '男',
|
||||
'F': '女',
|
||||
'O': '其他'
|
||||
}
|
||||
return map[gender] || '未知'
|
||||
}
|
||||
```
|
||||
|
||||
### 5. 证件类型 (indivCertType)
|
||||
|
||||
常用证件类型代码:
|
||||
- `身份证` - 身份证
|
||||
- `护照` - 护照
|
||||
- `港澳通行证` - 港澳通行证
|
||||
- `台湾通行证` - 台湾通行证
|
||||
|
||||
---
|
||||
|
||||
## API 返回数据示例
|
||||
|
||||
### 列表查询响应
|
||||
|
||||
```json
|
||||
{
|
||||
"code": 200,
|
||||
"msg": "查询成功",
|
||||
"rows": [
|
||||
{
|
||||
"intermediaryId": 1,
|
||||
"name": "张三",
|
||||
"certificateNo": "110101199001011234",
|
||||
"intermediaryType": "1",
|
||||
"status": "0",
|
||||
"dataSource": "MANUAL",
|
||||
"createTime": "2026-02-04 10:00:00",
|
||||
"updateTime": "2026-02-04 10:00:00"
|
||||
},
|
||||
{
|
||||
"intermediaryId": 0,
|
||||
"name": "测试机构有限公司",
|
||||
"certificateNo": "91110000123456789X",
|
||||
"intermediaryType": "2",
|
||||
"status": "0",
|
||||
"dataSource": "MANUAL",
|
||||
"createTime": "2026-02-04 10:00:00",
|
||||
"updateTime": "2026-02-04 10:00:00"
|
||||
}
|
||||
],
|
||||
"total": 2
|
||||
}
|
||||
```
|
||||
|
||||
### 个人中介详情响应
|
||||
|
||||
```json
|
||||
{
|
||||
"code": 200,
|
||||
"data": {
|
||||
"intermediaryId": 1,
|
||||
"name": "张三",
|
||||
"certificateNo": "110101199001011234",
|
||||
"intermediaryType": "1",
|
||||
"status": "0",
|
||||
"dataSource": "MANUAL",
|
||||
"remark": "测试数据",
|
||||
"indivType": "中介",
|
||||
"indivSubType": "本人",
|
||||
"indivGender": "M",
|
||||
"indivCertType": "身份证",
|
||||
"indivPhone": "13800138000",
|
||||
"indivWechat": "test_wx001",
|
||||
"indivAddress": "北京市朝阳区测试路123号",
|
||||
"indivCompany": "测试公司",
|
||||
"indivPosition": "测试员",
|
||||
"createTime": "2026-02-04 10:00:00"
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
### 机构中介详情响应
|
||||
|
||||
```json
|
||||
{
|
||||
"code": 200,
|
||||
"data": {
|
||||
"intermediaryId": 0,
|
||||
"name": "测试机构有限公司",
|
||||
"certificateNo": "91110000123456789X",
|
||||
"intermediaryType": "2",
|
||||
"status": "0",
|
||||
"dataSource": "MANUAL",
|
||||
"remark": "机构中介测试数据",
|
||||
"corpCreditCode": "91110000123456789X",
|
||||
"corpType": "有限责任公司",
|
||||
"corpNature": "民营企业",
|
||||
"corpIndustryCategory": "制造业",
|
||||
"corpIndustry": "通用设备制造业",
|
||||
"corpEstablishDate": "2020-01-01",
|
||||
"corpAddress": "北京市海淀区测试大街456号",
|
||||
"corpLegalRep": "李四",
|
||||
"corpLegalCertType": "身份证",
|
||||
"corpLegalCertNo": "110101198001011234",
|
||||
"createTime": "2026-02-04 10:00:00"
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 前端 Vue 组件示例
|
||||
|
||||
### 枚举转换工具函数
|
||||
|
||||
```javascript
|
||||
// utils/enums.js
|
||||
export const IntermediaryType = {
|
||||
PERSON: '1',
|
||||
ENTITY: '2',
|
||||
getName: (type) => {
|
||||
const map = {
|
||||
'1': '个人',
|
||||
'2': '机构'
|
||||
}
|
||||
return map[type] || '未知'
|
||||
}
|
||||
}
|
||||
|
||||
export const IntermediaryStatus = {
|
||||
NORMAL: '0',
|
||||
DISABLED: '1',
|
||||
getName: (status) => {
|
||||
const map = {
|
||||
'0': '正常',
|
||||
'1': '停用'
|
||||
}
|
||||
return map[status] || '未知'
|
||||
}
|
||||
}
|
||||
|
||||
export const DataSource = {
|
||||
MANUAL: 'MANUAL',
|
||||
IMPORT: 'IMPORT',
|
||||
SYSTEM: 'SYSTEM',
|
||||
API: 'API',
|
||||
getName: (source) => {
|
||||
const map = {
|
||||
'MANUAL': '手动录入',
|
||||
'IMPORT': '批量导入',
|
||||
'SYSTEM': '系统同步',
|
||||
'API': '接口获取'
|
||||
}
|
||||
return map[source] || '未知'
|
||||
}
|
||||
}
|
||||
|
||||
export const Gender = {
|
||||
MALE: 'M',
|
||||
FEMALE: 'F',
|
||||
OTHER: 'O',
|
||||
getName: (gender) => {
|
||||
const map = {
|
||||
'M': '男',
|
||||
'F': '女',
|
||||
'O': '其他'
|
||||
}
|
||||
return map[gender] || '未知'
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
### 表格列使用枚举
|
||||
|
||||
```vue
|
||||
<template>
|
||||
<el-table :data="tableData">
|
||||
<el-table-column prop="name" label="姓名" />
|
||||
|
||||
<el-table-column prop="intermediaryType" label="中介类型">
|
||||
<template #default="{ row }">
|
||||
{{ IntermediaryType.getName(row.intermediaryType) }}
|
||||
</template>
|
||||
</el-table-column>
|
||||
|
||||
<el-table-column prop="status" label="状态">
|
||||
<template #default="{ row }">
|
||||
<el-tag :type="row.status === '0' ? 'success' : 'danger'">
|
||||
{{ IntermediaryStatus.getName(row.status) }}
|
||||
</el-tag>
|
||||
</template>
|
||||
</el-table-column>
|
||||
|
||||
<el-table-column prop="dataSource" label="数据来源">
|
||||
<template #default="{ row }">
|
||||
{{ DataSource.getName(row.dataSource) }}
|
||||
</template>
|
||||
</el-table-column>
|
||||
</el-table>
|
||||
</template>
|
||||
|
||||
<script>
|
||||
import { IntermediaryType, IntermediaryStatus, DataSource } from '@/utils/enums'
|
||||
|
||||
export default {
|
||||
data() {
|
||||
return {
|
||||
IntermediaryType,
|
||||
IntermediaryStatus,
|
||||
DataSource,
|
||||
tableData: []
|
||||
}
|
||||
}
|
||||
}
|
||||
</script>
|
||||
```
|
||||
|
||||
### 表单下拉框使用枚举
|
||||
|
||||
```vue
|
||||
<template>
|
||||
<el-form :model="form">
|
||||
<el-form-item label="中介类型" prop="intermediaryType">
|
||||
<el-select v-model="form.intermediaryType" placeholder="请选择中介类型">
|
||||
<el-option label="个人" value="1" />
|
||||
<el-option label="机构" value="2" />
|
||||
</el-select>
|
||||
</el-form-item>
|
||||
|
||||
<el-form-item label="状态" prop="status">
|
||||
<el-radio-group v-model="form.status">
|
||||
<el-radio label="0">正常</el-radio>
|
||||
<el-radio label="1">停用</el-radio>
|
||||
</el-radio-group>
|
||||
</el-form-item>
|
||||
</el-form>
|
||||
</template>
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 注意事项
|
||||
|
||||
1. **后端只返回代码值**，前端负责转换为显示名称
|
||||
2. **前端下拉框的 value 应该使用代码值**（如 '1', '2', '0' 等）
|
||||
3. **建议在前端统一维护枚举映射关系**，避免硬编码
|
||||
4. **新增枚举值时**，只需要前端更新映射表即可，后端无需修改
|
||||
5. **国际化支持**：前端可以根据语言切换返回不同的名称
|
||||
@@ -1,23 +0,0 @@
|
||||
中介人员基本信息表：ccdi_biz_intermediary,,,,,,
|
||||
序号,字段名,类型,默认值,是否可为空,是否主键,注释
|
||||
1,biz_id,VARCHAR,-,否,是,人员ID
|
||||
2,person_type,VARCHAR,-,否,否,人员类型，中介、职业背债人、房产中介等
|
||||
3,person_sub_type,VARCHAR,-,是,否,人员子类型
|
||||
5,name,VARCHAR,-,否,否,姓名
|
||||
6,gender,CHAR,-,是,否,性别
|
||||
7,id_type,VARCHAR,身份证,否,否,证件类型
|
||||
8,person_id,VARCHAR,-,否,否,证件号码
|
||||
9,mobile,VARCHAR,-,是,否,手机号码
|
||||
10,wechat_no,VARCHAR,-,是,否,微信号
|
||||
11,contact_address,VARCHAR,-,是,否,联系地址
|
||||
12,company,VARCHAR,-,是,否,所在公司
|
||||
13,social_credit_code,VARCHAR,,,,企业统一信用码
|
||||
14,position,VARCHAR,-,是,否,职位
|
||||
15,related_num_id,VARCHAR,-,是,否,关联人员ID
|
||||
16,relation_type,VARCHAR,-,是,否,关系类型，如：配偶、子女、父母、兄弟姐妹等
|
||||
17,date_source,,,,,"数据来源，MANUAL:手动录入, SYSTEM:系统同步, IMPORT:批量导入, API:接口获取"
|
||||
18,remark,,,,,备注信息
|
||||
19,created_by,VARCHAR,-,否,-,记录创建人
|
||||
20,updated_by,VARCHAR,-,是,-,记录更新人
|
||||
21,create_time,DATETIME,,否,,记录创建时间
|
||||
22,update_time,DATETIME,-,是,-,记录更新时间
|
||||
|
@@ -1,26 +0,0 @@
|
||||
3.企业主体信息表：ccdi_enterprise_base_info,,,,,,
|
||||
序号,字段名,类型,默认值,是否可为空,是否主键,注释
|
||||
1,social_credit_code,VARCHAR,-,否,是,统一社会信用代码，员工企业关联关系表的外键
|
||||
2,enterprise_name,VARCHAR,-,否,-,企业名称
|
||||
3,enterprise_type,VARCHAR,-,否,-,"企业类型,有限责任公司、股份有限公司、合伙企业、个体工商户、外资企业等"
|
||||
4,enterprise_nature,VARCHAR,-,是,-,"企业性质,国企、民企、外企、合资、其他"
|
||||
5,industry_class,VARCHAR,-,是,-,行业分类
|
||||
6,industry_name,VARCHAR,-,是,-,所属行业
|
||||
7,establish_date,DATE,-,是,-,成立日期
|
||||
8,register_address,VARCHAR,-,是,-,注册地址
|
||||
9,legal_representative,VARCHAR,-,是,-,法定代表人
|
||||
10,legal_cert_type,VARCHAR,-,是,-,法定代表人证件类型
|
||||
11,legal_cert_no,VARCHAR,-,是,-,法定代表人证件号码
|
||||
12,shareholder1,VARCHAR,-,是,-,股东1
|
||||
13,shareholder2,VARCHAR,-,是,-,股东2
|
||||
14,shareholder3,VARCHAR,-,是,-,股东3
|
||||
15,shareholder4,VARCHAR,-,是,-,股东4
|
||||
16,shareholder5,VARCHAR,-,是,-,股东5
|
||||
17,status,VARCHAR,,,,经营状态
|
||||
18,create_time,DATETIME,当前时间,否,-,创建时间
|
||||
19,update_time,DATETIME,当前时间,否,-,更新时间
|
||||
20,created_by,VARCHAR,-,否,-,创建人
|
||||
21,updated_by,VARCHAR,-,是,-,更新人
|
||||
22,data_source,VARCHAR,MANUAL,是,-,"数据来源,MANUAL:手动录入, SYSTEM:系统同步, API:接口获取, IMPORT:批量导入"
|
||||
23,risk_level,VARCHAR(10),1,是,否,"风险等级：1-高风险, 2-中风险, 3-低风险"
|
||||
24,ent_source,VARCHAR(20),GENERAL,否,否,"企业来源：GENERAL-一般企业, EMP_RELATION-员工关系人, CREDIT_CUSTOMER-信贷客户, INTERMEDIARY-中介, BOTH-兼有"
|
||||
|
@@ -1,28 +0,0 @@
|
||||
1.人员家庭关系表：ccdi_fmy_relation_person,,,,,,
|
||||
序号,字段名,类型,默认值,是否可为空,是否主键,注释
|
||||
1,id,BIGINT,-,否,自动递增,主键，唯一标识
|
||||
2,person_id,VARCHAR,-,否,-,员工身份证号，关联员工表的外键
|
||||
3,relation_type,VARCHAR,-,否,-,关系类型，如：配偶、子女、父母、兄弟姐妹等
|
||||
4,relation_name,VARCHAR,-,否,-,关系人姓名
|
||||
5,gender,CHAR,-,是,-,M:男 F:女 O:其他
|
||||
6,birth_date,DATE,-,是,-,关系人出生日期
|
||||
7,relation_cert_type,VARCHAR,-,是,-,身份证、护照、军官证等
|
||||
8,relation_cert_no,VARCHAR,-,是,-,证件号码
|
||||
9,mobile_phone1,VARCHAR,-,是,-,手机号码1
|
||||
10,mobile_phone2,VARCHAR,-,是,-,手机号码2
|
||||
11,wechat_no1,VARCHAR,-,是,-,微信名称1
|
||||
12,wechat_no2,VARCHAR,-,是,-,微信名称2
|
||||
13,wechat_no3,VARCHAR,-,是,-,微信名称3
|
||||
14,contact_address,VARCHAR,-,是,-,详细联系地址
|
||||
15,relation_desc,VARCHAR,-,是,-,关系详细描述
|
||||
16,status,INT,1,否,-,关系是否有效：0 - 无效、1 - 有效（默认有效）
|
||||
17,effective_date,DATETIME,-,是,-,关系生效日期
|
||||
18,invalid_date,DATETIME,,是,,关系失效日期
|
||||
19,remark,TEXT,-,是,-,备注信息
|
||||
20,data_source,VARCHAR(50),,是,否,数据来源（系统名称）
|
||||
21,is_emp_family,TINYINT(1),0,否,否,是否是员工的家庭关系：0-否 1-是
|
||||
22,is_cust_family,TINYINT(1),0,否,否,是否是信贷客户的家庭关系：0-否 1-是
|
||||
23,created_by,VARCHAR,-,否,-,记录创建人
|
||||
24,updated_by,VARCHAR,-,是,-,记录更新人
|
||||
25,create_time,DATETIME,,否,,记录创建时间
|
||||
26,update_time,DATETIME,-,是,-,记录更新时间
|
||||
|
@@ -1,38 +0,0 @@
|
||||
6.员工采购交易信息表：ccdi_purchase_transaction,,,,,,
|
||||
序号,字段名,类型,默认值,是否可为空,是否主键,注释
|
||||
1,purchase_id,VARCHAR(32),,否,是,采购事项ID
|
||||
2,purchase_category,VARCHAR(50),-,否,否,采购类别
|
||||
3,project_name,VARCHAR(200),-,是,否,项目名称
|
||||
4,subject_name,VARCHAR(200),-,否,否,标的物名称
|
||||
5,subject_desc,TEXT,-,是,否,标的物描述
|
||||
6,purchase_qty,"DECIMAL(12,4)",1,否,否,采购数量
|
||||
7,budget_amount,"DECIMAL(18,2)",-,否,否,预算金额
|
||||
8,bid_amount,"DECIMAL(18,2)",-,是,否,中标金额
|
||||
9,actual_amount,"DECIMAL(18,2)",-,是,否,实际采购金额
|
||||
10,contract_amount,"DECIMAL(18,2)",-,是,否,合同金额
|
||||
11,settlement_amount,"DECIMAL(18,2)",-,是,否,结算金额
|
||||
12,purchase_method,VARCHAR(50),-,否,否,采购方式
|
||||
13,supplier_name,VARCHAR(200),-,是,否,中标供应商名称
|
||||
14,contact_person,VARCHAR(50),-,是,否,供应商联系人
|
||||
15,contact_phone,VARCHAR(20),-,是,否,供应商联系电话
|
||||
16,supplier_uscc,VARCHAR(18),-,是,否,供应商统一信用代码
|
||||
17,supplier_bank_account,VARCHAR(50),-,是,否,供应商银行账户
|
||||
18,apply_date,DATE,-,否,否,采购申请日期（或立项日期）
|
||||
19,plan_approve_date,DATE,-,是,否,采购计划批准日期
|
||||
20,announce_date,DATE,-,是,否,采购公告发布日期
|
||||
21,bid_open_date,DATE,-,是,否,开标日期
|
||||
22,contract_sign_date,DATE,-,是,否,合同签订日期
|
||||
23,expected_delivery_date,DATE,-,是,否,预计交货日期
|
||||
24,actual_delivery_date,DATE,-,是,否,实际交货日期
|
||||
25,acceptance_date,DATE,-,是,否,验收日期
|
||||
26,settlement_date,DATE,-,是,否,结算日期
|
||||
27,applicant_id,VARCHAR(7),-,否,否,申请人工号
|
||||
28,applicant_name,VARCHAR(50),-,否,否,申请人姓名
|
||||
29,apply_department,VARCHAR(100),-,否,否,申请部门
|
||||
30,purchase_leader_id,VARCHAR(7),-,是,否,采购负责人工号
|
||||
31,purchase_leader_name,VARCHAR(50),-,是,否,采购负责人姓名
|
||||
32,purchase_department,VARCHAR(100),-,是,否,采购部门
|
||||
33,create_time,DATETIME,CURRENT_TIMESTAMP,否,否,创建时间
|
||||
34,update_time,DATETIME,CURRENT_TIMESTAMP,否,否,更新时间
|
||||
35,created_by,VARCHAR(50),-,否,否,创建人
|
||||
36,updated_by,VARCHAR(50),-,是,否,更新人
|
||||
|
@@ -1,18 +0,0 @@
|
||||
2.企业关联关系表：ccdi_staff_enterprise_relation,,,,,,
|
||||
序号,字段名,类型,默认值,是否可为空,是否主键,注释
|
||||
1,id,BIGINT,-,否,自动递增,主键，唯一标识
|
||||
2,person_id,VARCHAR,-,否,-,身份证号，关联员工表的外键
|
||||
3,relation_person_post,VARCHAR,-,是,-,关联人在企业的职务：股东、法人、高管、实际控制人等
|
||||
4,social_credit_code,VARCHAR,-,否,-,统一社会信用代码，关联企业主体信息表的外键
|
||||
5,enterprise_name,VARCHAR,-,是,-,企业名称（冗余存储，便于快速查询）
|
||||
6,status,INT,1,否,-,关系是否有效：0 - 无效、1 - 有效（默认有效）
|
||||
7,remark,TEXT,-,是,-,补充说明
|
||||
8,data_source,VARCHAR(50),,是,否,数据来源
|
||||
9,is_employee,TINYINT(1),0,否,否,是否是员工：0-否 1-是
|
||||
10,is_emp_family,TINYINT(1),0,否,否,是否是员工家庭关联人：0-否 1-是
|
||||
11,is_customer,TINYINT(1),0,否,否,是否是信贷客户：0-否 1-是
|
||||
12,is_cust_family,TINYINT(1),0,否,否,是否是信贷客户关联人：0-否 1-是
|
||||
13,created_by,VARCHAR,-,否,-,记录创建人
|
||||
14,updated_by,VARCHAR,-,是,-,记录更新人
|
||||
15,create_time,DATETIME,-,否,-,记录创建时间
|
||||
16,update_time,DATETIME,-,否,-,记录更新时间
|
||||
|
@@ -1,22 +0,0 @@
|
||||
4.员工招聘信息表：ccdi_staff_recruitment,,,,,,
|
||||
序号,字段名,类型,默认值,是否可为空,是否主键,注释
|
||||
1,recruit_id,VARCHAR(32),,否,是,招聘项目编号
|
||||
2,recruit_name,VARCHAR(100),,否,否,招聘项目名称
|
||||
3,pos_name,VARCHAR(100),,否,否,职位名称
|
||||
4,pos_category,VARCHAR(50),,否,否,职位类别
|
||||
5,pos_desc,TEXT,,否,否,职位描述
|
||||
6,cand_name,VARCHAR(20),,否,否,应聘人员姓名
|
||||
7,cand_edu,VARCHAR(20),,否,否,应聘人员学历
|
||||
8,cand_id,VARCHAR(18),,否,否,应聘人员证件号码
|
||||
9,cand_school,VARCHAR(50),,否,否,应聘人员毕业院校
|
||||
10,cand_major,VARCHAR(30),,否,否,应聘人员专业
|
||||
11,cand_grad,VARCHAR(6),,否,否,应聘人员毕业年月
|
||||
12,admit_status,VARCHAR(10),,否,否,记录录用情况：录用、未录用、放弃等
|
||||
13,interviewer_name1,VARCHAR(20),,是,否,面试官1姓名
|
||||
14,interviewer_id1,VARCHAR(10),,是,否,面试官1工号
|
||||
13,interviewer_name2,VARCHAR(20),,是,否,面试官2姓名
|
||||
14,interviewer_id2,VARCHAR(10),,是,否,面试官2工号
|
||||
16,created_by,VARCHAR(20),-,否,否,记录创建人
|
||||
17,updated_by,VARCHAR(20),-,是,否,记录更新人
|
||||
18,create_time,VARCHAR(10),0000-00-00,是,否,创建时间
|
||||
19,update_time,VARCHAR(10),0000-00-00,是,否,更新时间
|
||||
|
@@ -1,18 +0,0 @@
|
||||
5.员工调动记录表：ccdi_staff_transfer,,,,,,
|
||||
序号,字段名,类型,默认值,是否可为空,是否主键,注释
|
||||
1,num_id,string,,否,是,员工工号（主键）
|
||||
2,transfer_type,VARCHAR,,是,否,"调动类型:PROMOTION:升职, DEMOTION:降职, LATERAL:平调, ROTATION:轮岗, SECONDMENT:借调, DEPARTMENT_CHANGE:部门调动, POSITION_CHANGE:职位调整, RETURN:返岗, TERMINATION:离职, OTHER:其他"
|
||||
3,transfer_sub_type,VARCHAR,,是,否,"调动子类型,双聘调动、临时调动等"
|
||||
4,dept_id_before,VARCHAR,,是,否,调动前部门ID
|
||||
5,dept_name_before,VARCHAR,,是,否,调动前部门
|
||||
6,grade_before,VARCHAR,,是,否,调动前职级
|
||||
7,position_before,VARCHAR,,是,否,调动前岗位
|
||||
8,salary_level_before,VARCHAR,,是,否,调动前薪酬等级
|
||||
9,dept_id_after,VARCHAR,0000-00-00,是,否,调动后部门ID
|
||||
10,dept_name_after,VARCHAR,0000-00-00,是,否,调动后部门
|
||||
11,grade_after,VARCHAR,,是,否,调动后职级
|
||||
12,position_after,VARCHAR,,是,否,调动后岗位
|
||||
13,salary_level_after,VARCHAR,,是,否,调动后薪酬等级
|
||||
14,transfer_date,DATE,,是,否,调动日期
|
||||
15,create_time,DATETIME,-,否,当前时间,记录创建时间
|
||||
16,update_time,DATETIME,-,否,当前时间,记录更新时间
|
||||
|
@@ -1,110 +0,0 @@
|
||||
# 数据库唯一索引验证报告
|
||||
|
||||
## 验证日期
|
||||
2026-02-08
|
||||
|
||||
## 验证目的
|
||||
确认中介信息导入功能所需的数据库唯一索引已正确配置,为 `INSERT ... ON DUPLICATE KEY UPDATE` 语句提供基础支持。
|
||||
|
||||
## 涉及表
|
||||
- `ccdi_biz_intermediary` (个人中介表)
|
||||
- `ccdi_enterprise_base_info` (实体中介表)
|
||||
|
||||
---
|
||||
|
||||
## 检查结果
|
||||
|
||||
### 1. 个人中介表 (ccdi_biz_intermediary)
|
||||
|
||||
#### 检查项: person_id 唯一索引
|
||||
|
||||
**检查前状态:**
|
||||
- 存在普通索引 `idx_person_id` (Non_unique = 1)
|
||||
- ❌ 不满足唯一性要求
|
||||
|
||||
**执行操作:**
|
||||
```sql
|
||||
-- 删除原有普通索引
|
||||
ALTER TABLE ccdi_biz_intermediary DROP INDEX idx_person_id;
|
||||
|
||||
-- 创建唯一索引
|
||||
ALTER TABLE ccdi_biz_intermediary ADD UNIQUE KEY uk_person_id (person_id);
|
||||
```
|
||||
|
||||
**检查后状态:**
|
||||
- ✅ 唯一索引 `uk_person_id` 已创建
|
||||
- Non_unique: 0
|
||||
- Column_name: person_id
|
||||
- Index_type: BTREE
|
||||
- Cardinality: 1745
|
||||
|
||||
**最终索引状态:**
|
||||
- ✅ PRIMARY KEY: `biz_id`
|
||||
- ✅ UNIQUE KEY: `uk_person_id` (Non_unique = 0)
|
||||
- ✅ INDEX: `idx_name` (普通索引)
|
||||
- ✅ INDEX: `idx_mobile` (普通索引)
|
||||
|
||||
**完整索引列表:**
|
||||
```sql
|
||||
SHOW INDEX FROM ccdi_biz_intermediary;
|
||||
```
|
||||
|
||||
| Key_name | Column_name | Non_unique | Index_type |
|
||||
|----------|-------------|------------|------------|
|
||||
| PRIMARY | biz_id | 0 | BTREE |
|
||||
| uk_person_id | person_id | 0 | BTREE |
|
||||
| idx_name | name | 1 | BTREE |
|
||||
| idx_mobile | mobile | 1 | BTREE |
|
||||
|
||||
---
|
||||
|
||||
### 2. 实体中介表 (ccdi_enterprise_base_info)
|
||||
|
||||
#### 检查项: social_credit_code 主键
|
||||
|
||||
**检查前状态:**
|
||||
- ✅ `social_credit_code` 已为 PRIMARY KEY
|
||||
- 字段类型: varchar(50)
|
||||
- 约束: NOT NULL
|
||||
- 引擎: InnoDB
|
||||
|
||||
**表结构确认:**
|
||||
```sql
|
||||
SHOW CREATE TABLE ccdi_enterprise_base_info;
|
||||
```
|
||||
|
||||
**结论:**
|
||||
- ✅ 无需修改,已满足要求
|
||||
|
||||
---
|
||||
|
||||
## 总结
|
||||
|
||||
### 验证结论
|
||||
✅ **所有必需的唯一索引/主键均已正确配置**
|
||||
|
||||
### 配置详情
|
||||
|
||||
| 表名 | 字段 | 约束类型 | 状态 |
|
||||
|------|------|----------|------|
|
||||
| ccdi_biz_intermediary | person_id | UNIQUE KEY | ✅ 已创建 |
|
||||
| ccdi_enterprise_base_info | social_credit_code | PRIMARY KEY | ✅ 已存在 |
|
||||
|
||||
### 对导入功能的影响
|
||||
- ✅ `INSERT ... ON DUPLICATE KEY UPDATE` 现在可以正确工作
|
||||
- ✅ 个人中介数据根据 `person_id` 自动去重和更新
|
||||
- ✅ 实体中介数据根据 `social_credit_code` 自动去重和更新
|
||||
|
||||
### 注意事项
|
||||
1. **唯一索引约束:** 导入数据时,如果 `person_id` 重复,将自动执行更新操作
|
||||
2. **性能影响:** 唯一索引会在插入和更新时进行唯一性检查,对性能有轻微影响
|
||||
3. **数据完整性:** 唯一索引确保了数据的唯一性,防止重复数据
|
||||
|
||||
---
|
||||
|
||||
## 执行人员
|
||||
Claude Code AI Assistant
|
||||
|
||||
## 审核状态
|
||||
✅ 已完成验证并创建唯一索引
|
||||
✅ 文档已提交到 git (commit: a6a872b)
|
||||
File diff suppressed because it is too large
Load Diff
@@ -1,226 +0,0 @@
|
||||
# EasyExcel字典下拉框使用说明
|
||||
|
||||
## 功能概述
|
||||
|
||||
本项目实现了EasyExcel自定义WriteHandler拦截器，可以在生成Excel模板时自动添加基于若依框架字典数据的下拉框。
|
||||
|
||||
## 核心组件
|
||||
|
||||
### 1. @DictDropdown 注解
|
||||
|
||||
位置：`com.ruoyi.common.annotation.DictDropdown`
|
||||
|
||||
用于标注需要添加下拉框的字段。
|
||||
|
||||
**属性说明：**
|
||||
| 属性 | 类型 | 默认值 | 说明 |
|
||||
|-----|------|--------|------|
|
||||
| dictType | String | 必填 | 字典类型编码，对应若依字典管理中的字典类型 |
|
||||
| displayType | DisplayType | LABEL | 下拉框显示内容类型（LABEL：显示标签，VALUE：显示值） |
|
||||
| strict | boolean | true | 是否仅允许选择下拉框中的值 |
|
||||
| hiddenSheetName | String | "dict_hidden" | 隐藏Sheet名称（用于存储大量下拉选项） |
|
||||
|
||||
### 2. DictDropdownWriteHandler 处理器
|
||||
|
||||
位置：`com.ruoyi.dpc.handler.DictDropdownWriteHandler`
|
||||
|
||||
核心功能：
|
||||
- 解析实体类中的@DictDropdown注解
|
||||
- 从若依字典缓存获取字典数据
|
||||
- 为对应列添加下拉框验证
|
||||
- 自动处理下拉选项超过Excel字符限制的情况（使用隐藏Sheet）
|
||||
|
||||
### 3. EasyExcelUtil 工具类扩展
|
||||
|
||||
位置：`com.ruoyi.dpc.utils.EasyExcelUtil`
|
||||
|
||||
新增方法：
|
||||
- `importTemplateWithDictDropdown()` - 下载带字典下拉框的导入模板
|
||||
- `exportExcelWithDictDropdown()` - 导出带字典下拉框的Excel
|
||||
|
||||
## 使用示例
|
||||
|
||||
### 步骤1：在实体类上添加注解
|
||||
|
||||
```java
|
||||
package com.ruoyi.dpc.domain.excel;
|
||||
|
||||
import com.alibaba.excel.annotation.ExcelProperty;
|
||||
import com.alibaba.excel.annotation.write.style.ColumnWidth;
|
||||
import com.ruoyi.common.annotation.DictDropdown;
|
||||
import lombok.Data;
|
||||
|
||||
@Data
|
||||
public class CcdiEmployeeExcel {
|
||||
|
||||
@ExcelProperty(value = "姓名", index = 0)
|
||||
@ColumnWidth(15)
|
||||
private String name;
|
||||
|
||||
@ExcelProperty(value = "柜员号", index = 1)
|
||||
@ColumnWidth(15)
|
||||
private String tellerNo;
|
||||
|
||||
// 添加字典下拉框注解
|
||||
@ExcelProperty(value = "状态", index = 6)
|
||||
@ColumnWidth(10)
|
||||
@DictDropdown(dictType = "ccdi_employee_status")
|
||||
private String status;
|
||||
}
|
||||
```
|
||||
|
||||
### 步骤2：在Controller中使用
|
||||
|
||||
```java
|
||||
@RestController
|
||||
@RequestMapping("/ccdi/employee")
|
||||
public class CcdiEmployeeController {
|
||||
|
||||
/**
|
||||
* 下载带字典下拉框的导入模板
|
||||
*/
|
||||
@PostMapping("/importTemplateWithDropdown")
|
||||
public void importTemplateWithDropdown(HttpServletResponse response) {
|
||||
EasyExcelUtil.importTemplateWithDictDropdown(
|
||||
response,
|
||||
CcdiEmployeeExcel.class,
|
||||
"员工信息"
|
||||
);
|
||||
}
|
||||
|
||||
/**
|
||||
* 导出带字典下拉框的Excel
|
||||
*/
|
||||
@PostMapping("/exportWithDropdown")
|
||||
public void exportWithDropdown(HttpServletResponse response) {
|
||||
List<CcdiEmployeeExcel> list = employeeService.selectEmployeeList();
|
||||
EasyExcelUtil.exportExcelWithDictDropdown(
|
||||
response,
|
||||
list,
|
||||
CcdiEmployeeExcel.class,
|
||||
"员工信息"
|
||||
);
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
## 高级用法
|
||||
|
||||
### 1. 显示字典键值而非标签
|
||||
|
||||
```java
|
||||
@DictDropdown(dictType = "ccdi_employee_status", displayType = DisplayType.VALUE)
|
||||
private String status;
|
||||
```
|
||||
|
||||
### 2. 允许手动输入（非严格模式）
|
||||
|
||||
```java
|
||||
@DictDropdown(dictType = "ccdi_employee_status", strict = false)
|
||||
private String status;
|
||||
```
|
||||
|
||||
### 3. 自定义隐藏Sheet名称
|
||||
|
||||
```java
|
||||
@DictDropdown(dictType = "ccdi_employee_status", hiddenSheetName = "employee_status_dict")
|
||||
private String status;
|
||||
```
|
||||
|
||||
## 注意事项
|
||||
|
||||
1. **必须指定@ExcelProperty的index属性**
|
||||
- 字段必须指定@ExcelProperty注解的index值，否则无法正确映射列位置
|
||||
|
||||
2. **字典数据必须预先加载到缓存**
|
||||
- 使用前需要确保字典数据已经加载到Redis缓存中
|
||||
- 可通过若依系统的字典管理功能预热缓存
|
||||
|
||||
3. **下拉选项数量限制**
|
||||
- 当下拉选项总长度超过255字符时，自动使用隐藏Sheet存储
|
||||
- 隐藏Sheet在Excel中不可见，但下拉框功能正常
|
||||
|
||||
4. **字段必须标注@ExcelProperty注解**
|
||||
- 只有同时标注了@ExcelProperty和@DictDropdown的字段才会添加下拉框
|
||||
|
||||
## 测试验证
|
||||
|
||||
### 接口测试
|
||||
|
||||
1. 启动项目后，访问Swagger UI：`http://localhost:8080/swagger-ui/index.html`
|
||||
|
||||
2. 找到员工信息管理相关接口：
|
||||
- `POST /ccdi/employee/importTemplateWithDropdown` - 下载带字典下拉框的模板
|
||||
|
||||
3. 调用接口下载模板，检查Excel中的下拉框是否正常
|
||||
|
||||
### 手动验证
|
||||
|
||||
1. 打开下载的Excel模板
|
||||
2. 点击标注了下拉框的列（如"状态"列）
|
||||
3. 检查是否出现下拉箭头和选项列表
|
||||
4. 尝试选择和输入，验证验证规则是否生效
|
||||
|
||||
## 技术实现细节
|
||||
|
||||
### Excel下拉列表限制处理
|
||||
|
||||
Excel对下拉列表的直接字符数有限制（约255字符），本项目采用以下策略：
|
||||
|
||||
1. **选项较少时（<255字符）**
|
||||
- 直接使用 `DataValidationHelper.createExplicitListConstraint()` 创建下拉列表
|
||||
- 下拉选项内联在单元格验证中
|
||||
|
||||
2. **选项较多时（≥255字符）**
|
||||
- 创建隐藏Sheet存储所有选项
|
||||
- 使用 `DataValidationHelper.createFormulaListConstraint()` 通过公式引用
|
||||
- 自动隐藏Sheet（`workbook.setSheetHidden()`）
|
||||
|
||||
### 字典数据获取
|
||||
|
||||
```
|
||||
┌─────────────┐ 缓存查询 ┌─────────────┐
|
||||
│ DictDropdown │ ───────────▶ │ DictUtils │
|
||||
│ 注解 │ │ .getDictCache() │
|
||||
└─────────────┘ └─────────────┘
|
||||
│
|
||||
▼
|
||||
┌─────────────┐
|
||||
│ Redis缓存 │
|
||||
│ sys_dict:key │
|
||||
└─────────────┘
|
||||
```
|
||||
|
||||
### 列索引映射
|
||||
|
||||
通过反射获取字段的@ExcelProperty注解中的index值，确保下拉框添加到正确的列。
|
||||
|
||||
## 常见问题
|
||||
|
||||
### Q1：下拉框没有显示？
|
||||
|
||||
**可能原因：**
|
||||
1. 字典数据未加载到缓存
|
||||
2. 字段未指定@ExcelProperty的index值
|
||||
3. 字典类型编码错误
|
||||
|
||||
**解决方法：**
|
||||
1. 在若依系统字典管理中，进入对应字典类型，刷新缓存
|
||||
2. 检查实体类字段注解是否正确
|
||||
3. 确认dictType值与字典管理中的字典类型一致
|
||||
|
||||
### Q2：下拉选项显示不完整？
|
||||
|
||||
**原因：** 选项字符数超过255字符，但隐藏Sheet创建失败
|
||||
|
||||
**解决方法：** 检查日志中的错误信息，确保有权限创建隐藏Sheet
|
||||
|
||||
### Q3：可以手动输入非下拉选项的值吗？
|
||||
|
||||
**答案：** 可以，通过设置 `strict = false` 允许手动输入
|
||||
|
||||
## 更新日志
|
||||
|
||||
| 版本 | 日期 | 说明 |
|
||||
|------|------|------|
|
||||
| 1.0.0 | 2026-01-29 | 初始版本，支持字典下拉框功能 |
|
||||
@@ -1,273 +0,0 @@
|
||||
# 中介黑名单管理模块 - 测试与部署文档
|
||||
|
||||
## 文件说明
|
||||
|
||||
本目录包含中介黑名单管理模块(v2.0)的测试脚本、API文档、菜单配置和测试报告模板。
|
||||
|
||||
```
|
||||
doc/
|
||||
├── scripts/
|
||||
│ ├── test-intermediary-api.sh # API自动化测试脚本
|
||||
│ └── cleanup-intermediary-test-data.sh # 测试数据清理脚本
|
||||
├── api/
|
||||
│ └── 中介黑名单管理API文档-v2.0.md # 完整的API接口文档
|
||||
├── test/
|
||||
│ └── intermediary-blacklist-test-report.md # 测试报告模板
|
||||
└── sql/
|
||||
└── menu-intermediary.sql # 菜单配置SQL
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 快速开始
|
||||
|
||||
### 1. 执行菜单SQL
|
||||
|
||||
首先在数据库中执行菜单配置SQL,为系统添加中介黑名单管理菜单:
|
||||
|
||||
```bash
|
||||
mysql -u root -p ruoyi < sql/menu-intermediary.sql
|
||||
```
|
||||
|
||||
或者直接在MySQL客户端中执行:
|
||||
|
||||
```sql
|
||||
source D:/ccdi/ccdi/sql/menu-intermediary.sql;
|
||||
```
|
||||
|
||||
执行后,在角色管理中为相应角色分配权限。
|
||||
|
||||
### 2. 运行API测试脚本
|
||||
|
||||
确保后端服务已启动(http://localhost:8080),然后执行测试脚本:
|
||||
|
||||
```bash
|
||||
cd D:/ccdi/ccdi/doc/scripts
|
||||
bash test-intermediary-api.sh
|
||||
```
|
||||
|
||||
测试脚本会自动:
|
||||
- 获取Token
|
||||
- 测试查询列表
|
||||
- 测试新增个人中介
|
||||
- 测试新增实体中介
|
||||
- 测试查询详情
|
||||
- 测试修改操作
|
||||
- 测试唯一性校验
|
||||
- 测试条件查询
|
||||
|
||||
### 3. 清理测试数据
|
||||
|
||||
测试完成后,运行清理脚本删除测试数据:
|
||||
|
||||
```bash
|
||||
cd D:/ccdi/ccdi/doc/scripts
|
||||
bash cleanup-intermediary-test-data.sh
|
||||
```
|
||||
|
||||
### 4. 查看API文档
|
||||
|
||||
参考API文档进行接口对接:
|
||||
|
||||
- 文件位置: `doc/api/中介黑名单管理API文档-v2.0.md`
|
||||
- Swagger UI: http://localhost:8080/swagger-ui/index.html
|
||||
|
||||
### 5. 填写测试报告
|
||||
|
||||
根据测试结果填写测试报告模板:
|
||||
|
||||
- 文件位置: `doc/test/intermediary-blacklist-test-report.md`
|
||||
|
||||
---
|
||||
|
||||
## API接口列表
|
||||
|
||||
### 基础路径
|
||||
`/ccdi/intermediary`
|
||||
|
||||
### 主要接口
|
||||
|
||||
| 方法 | 路径 | 说明 | 权限 |
|
||||
|------|------|------|------|
|
||||
| GET | /list | 查询中介列表 | ccdi:intermediary:list |
|
||||
| GET | /person/{bizId} | 查询个人中介详情 | ccdi:intermediary:query |
|
||||
| GET | /entity/{socialCreditCode} | 查询实体中介详情 | ccdi:intermediary:query |
|
||||
| POST | /person | 新增个人中介 | ccdi:intermediary:add |
|
||||
| POST | /entity | 新增实体中介 | ccdi:intermediary:add |
|
||||
| PUT | /person | 修改个人中介 | ccdi:intermediary:edit |
|
||||
| PUT | /entity | 修改实体中介 | ccdi:intermediary:edit |
|
||||
| DELETE | /{ids} | 删除中介 | ccdi:intermediary:remove |
|
||||
| GET | /checkPersonIdUnique | 校验人员ID唯一性 | 无 |
|
||||
| GET | /checkSocialCreditCodeUnique | 校验统一社会信用代码唯一性 | 无 |
|
||||
| POST | /importPersonTemplate | 下载个人中介导入模板 | 无 |
|
||||
| POST | /importEntityTemplate | 下载实体中介导入模板 | 无 |
|
||||
| POST | /importPersonData | 导入个人中介数据 | ccdi:intermediary:import |
|
||||
| POST | /importEntityData | 导入实体中介数据 | ccdi:intermediary:import |
|
||||
|
||||
详细接口说明请参考API文档。
|
||||
|
||||
---
|
||||
|
||||
## 测试账号
|
||||
|
||||
- **用户名**: admin
|
||||
- **密码**: admin123
|
||||
- **角色**: 管理员
|
||||
|
||||
---
|
||||
|
||||
## 菜单权限说明
|
||||
|
||||
执行menu-intermediary.sql后,系统会创建以下权限:
|
||||
|
||||
| 权限标识 | 说明 |
|
||||
|---------|------|
|
||||
| ccdi:intermediary:query | 查询中介详情 |
|
||||
| ccdi:intermediary:list | 查询中介列表 |
|
||||
| ccdi:intermediary:add | 新增中介 |
|
||||
| ccdi:intermediary:edit | 修改中介 |
|
||||
| ccdi:intermediary:remove | 删除中介 |
|
||||
| ccdi:intermediary:export | 导出中介数据 |
|
||||
| ccdi:intermediary:import | 导入中介数据 |
|
||||
|
||||
在角色管理中为相应角色分配这些权限。
|
||||
|
||||
---
|
||||
|
||||
## 数据字典说明
|
||||
|
||||
模块使用的数据字典类型:
|
||||
|
||||
| 字典类型 | 字典名称 | 用途 |
|
||||
|---------|---------|------|
|
||||
| ccdi_indiv_gender | 个人中介性别 | 个人中介模板性别下拉框 |
|
||||
| ccdi_certificate_type | 证件类型 | 个人中介模板证件类型下拉框 |
|
||||
| ccdi_entity_type | 主体类型 | 机构中介模板主体类型下拉框 |
|
||||
| ccdi_enterprise_nature | 企业性质 | 机构中介模板企业性质下拉框 |
|
||||
| ccdi_data_source | 数据来源 | 数据来源字段映射 |
|
||||
|
||||
确保这些字典类型在系统中已配置。
|
||||
|
||||
---
|
||||
|
||||
## 测试用例统计
|
||||
|
||||
本模块共包含44个测试用例,涵盖:
|
||||
|
||||
1. **列表查询** (7个用例)
|
||||
- 基础列表查询
|
||||
- 分页查询
|
||||
- 按姓名查询
|
||||
- 按证件号查询
|
||||
- 按中介类型查询
|
||||
- 组合条件查询
|
||||
|
||||
2. **个人中介管理** (8个用例)
|
||||
- 新增个人中介
|
||||
- 字段验证
|
||||
- 唯一性校验
|
||||
- 修改个人中介
|
||||
- 查询详情
|
||||
|
||||
3. **实体中介管理** (7个用例)
|
||||
- 新增实体中介
|
||||
- 字段验证
|
||||
- 唯一性校验
|
||||
- 修改实体中介
|
||||
- 查询详情
|
||||
|
||||
4. **唯一性校验** (2个用例)
|
||||
- 人员ID唯一性
|
||||
- 统一社会信用代码唯一性
|
||||
|
||||
5. **删除功能** (3个用例)
|
||||
- 删除单条记录
|
||||
- 批量删除
|
||||
- 删除不存在的记录
|
||||
|
||||
6. **导入导出** (11个用例)
|
||||
- 模板下载
|
||||
- 数据导入
|
||||
- 数据导出
|
||||
- 异常处理
|
||||
|
||||
7. **权限控制** (6个用例)
|
||||
- 各功能点的权限验证
|
||||
|
||||
---
|
||||
|
||||
## 常见问题
|
||||
|
||||
### 1. 测试脚本无法执行
|
||||
|
||||
**问题**: bash: test-intermediary-api.sh: command not found
|
||||
|
||||
**解决**: 使用bash命令执行
|
||||
```bash
|
||||
bash test-intermediary-api.sh
|
||||
```
|
||||
|
||||
### 2. jq命令未安装
|
||||
|
||||
**问题**: jq: command not found
|
||||
|
||||
**解决**: 安装jq命令
|
||||
```bash
|
||||
# Ubuntu/Debian
|
||||
apt-get install jq
|
||||
|
||||
# CentOS/RHEL
|
||||
yum install jq
|
||||
|
||||
# Windows (使用Git Bash)
|
||||
# 下载jq for Windows并添加到PATH
|
||||
```
|
||||
|
||||
### 3. Token获取失败
|
||||
|
||||
**问题**: Token获取失败或返回null
|
||||
|
||||
**解决**:
|
||||
- 确保后端服务已启动
|
||||
- 确认用户名密码正确(admin/admin123)
|
||||
- 检查/login/test接口是否正常
|
||||
|
||||
### 4. 菜单不显示
|
||||
|
||||
**问题**: 执行SQL后菜单不显示
|
||||
|
||||
**解决**:
|
||||
- 在角色管理中为当前角色分配权限
|
||||
- 刷新页面或重新登录
|
||||
- 检查父级菜单ID(2000)是否存在
|
||||
|
||||
### 5. 导入失败
|
||||
|
||||
**问题**: 导入数据时报错
|
||||
|
||||
**解决**:
|
||||
- 确认Excel模板格式正确
|
||||
- 检查必填字段是否为空
|
||||
- 检查证件号或统一社会信用代码是否重复
|
||||
|
||||
---
|
||||
|
||||
## 版本历史
|
||||
|
||||
| 版本 | 日期 | 说明 |
|
||||
|------|------|------|
|
||||
| 2.0.0 | 2026-02-04 | 重构版本:使用MyBatis Plus,分离DTO/VO,统一业务ID |
|
||||
| 1.3.0 | 2026-01-29 | 新增接口分离:新增个人/机构专用新增接口 |
|
||||
| 1.2.0 | 2026-01-29 | 修改接口分离:新增个人/机构专用修改接口 |
|
||||
| 1.1.0 | 2026-01-29 | 添加字典下拉框功能,分离个人/机构模板 |
|
||||
| 1.0.0 | 2026-01-29 | 初始版本,支持个人和机构分类管理 |
|
||||
|
||||
---
|
||||
|
||||
## 联系方式
|
||||
|
||||
如有问题,请联系开发团队。
|
||||
|
||||
---
|
||||
|
||||
**最后更新**: 2026-02-04
|
||||
@@ -1,66 +0,0 @@
|
||||
# 文档目录结构
|
||||
|
||||
本目录包含纪检初核系统的各类文档、测试数据和脚本。
|
||||
|
||||
## 目录说明
|
||||
|
||||
### 📁 docs/
|
||||
项目文档目录
|
||||
- `纪检初核系统功能说明书-V1.0.docx/md` - 系统功能说明书
|
||||
- `纪检初核系统模块划分方案.md` - 模块划分方案
|
||||
- `若依环境使用手册.docx` - 若依框架使用手册
|
||||
- `中介黑名单弹窗优化设计.md` - UI设计文档
|
||||
- `EasyExcel字典下拉框使用说明.md` - Excel导入使用说明
|
||||
|
||||
### 📁 api/
|
||||
API接口文档目录
|
||||
- `员工信息管理API文档.md` - 员工信息管理模块API
|
||||
- `中介黑名单管理API文档.md` - 中介黑名单管理模块API
|
||||
|
||||
### 📁 scripts/
|
||||
测试脚本目录
|
||||
- `test_import.py` - 导入功能测试脚本
|
||||
- `test_import_simple.py` - 简单导入测试脚本
|
||||
- `test_uniqueness_validation.py` - 唯一性校验测试脚本
|
||||
- `generate_test_data.py` - 测试数据生成脚本
|
||||
|
||||
### 📁 test-data/
|
||||
测试数据目录
|
||||
- `个人中介黑名单模板_1769667622015.xlsx` - 导入模板
|
||||
- `个人中介黑名单测试数据_1000条.xlsx` - 测试数据（第1批）
|
||||
- `个人中介黑名单测试数据_1000条_第2批.xlsx` - 测试数据（第2批）
|
||||
- `中介人员信息表.csv` - 中介人员数据
|
||||
- `中介主体信息表.csv` - 中介主体数据
|
||||
|
||||
### 📁 other/
|
||||
其他文件目录
|
||||
- `纪检初核系统-离线演示包/` - 离线演示包（解压版）
|
||||
- `纪检初核系统-离线演示包.zip` - 离线演示包（压缩版）
|
||||
- `ScreenShot_*.png` - 截图文件
|
||||
|
||||
### 📁 modules/
|
||||
模块设计文档目录
|
||||
- `01-项目管理模块/` - 项目管理模块文档
|
||||
- `02-项目工作台/` - 项目工作台模块文档
|
||||
- `03-信息维护模块.md` - 信息维护模块文档
|
||||
- `04-参数配置模块.md` - 参数配置模块文档
|
||||
- `05-系统管理模块.md` - 系统管理模块文档
|
||||
|
||||
## 使用说明
|
||||
|
||||
### 生成测试数据
|
||||
```bash
|
||||
cd doc/scripts
|
||||
python generate_test_data.py
|
||||
```
|
||||
|
||||
### 运行测试脚本
|
||||
```bash
|
||||
cd doc/scripts
|
||||
python test_uniqueness_validation.py
|
||||
```
|
||||
|
||||
### 导入测试数据
|
||||
1. 从 `test-data/` 目录下载对应的Excel文件
|
||||
2. 在系统页面点击"导入"按钮
|
||||
3. 选择文件并上传
|
||||
@@ -1,393 +0,0 @@
|
||||
# 员工导入服务规范合规审查报告
|
||||
|
||||
**审查时间**: 2026-02-09
|
||||
**审查文件**: `CcdiEmployeeImportServiceImpl.java`
|
||||
**审查类型**: 规范合规最终审查
|
||||
|
||||
---
|
||||
|
||||
## 一、审查结果总览
|
||||
|
||||
### ✅ 最终评估：**完全合规**
|
||||
|
||||
**综合评分**: 100/100
|
||||
|
||||
---
|
||||
|
||||
## 二、详细审查清单
|
||||
|
||||
### 1. 功能完整性检查 (25分)
|
||||
|
||||
#### ✅ 批量查询实现 (25/25分)
|
||||
|
||||
| 检查项 | 要求 | 实际情况 | 状态 |
|
||||
|--------|------|----------|------|
|
||||
| 调用 getExistingIdCards | 批量查询身份证号 | 第50行已调用 | ✅ |
|
||||
| existingIdCards 集合 | 存储数据库已存在身份证号 | 第50行已创建 | ✅ |
|
||||
| processedIdCards 集合 | 跟踪Excel内已处理身份证号 | 第54行已创建 | ✅ |
|
||||
| processedEmployeeIds 集合 | 跟踪Excel内已处理柜员号 | 第53行已创建 | ✅ |
|
||||
|
||||
**证据代码**:
|
||||
```java
|
||||
// 第49-50行：批量查询
|
||||
Set<Long> existingIds = getExistingEmployeeIds(excelList);
|
||||
Set<String> existingIdCards = getExistingIdCards(excelList);
|
||||
|
||||
// 第53-54行：Excel内处理跟踪
|
||||
Set<Long> processedEmployeeIds = new HashSet<>();
|
||||
Set<String> processedIdCards = new HashSet<>();
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 2. 实现正确性检查 (25分)
|
||||
|
||||
#### ✅ 检查顺序 (25/25分)
|
||||
|
||||
**设计规范要求的检查顺序**:
|
||||
1. ✅ 数据库重复检查
|
||||
2. ✅ Excel内柜员号重复检查
|
||||
3. ✅ Excel内身份证号重复检查
|
||||
|
||||
**实际实现顺序**:
|
||||
|
||||
**新增分支** (第90-101行):
|
||||
```java
|
||||
} else {
|
||||
// 柜员号不存在,检查Excel内重复
|
||||
if (processedEmployeeIds.contains(excel.getEmployeeId())) { // 2. 柜员号
|
||||
throw new RuntimeException(String.format("柜员号[%d]在导入文件中重复,已跳过此条记录", excel.getEmployeeId()));
|
||||
}
|
||||
if (StringUtils.isNotEmpty(excel.getIdCard()) &&
|
||||
processedIdCards.contains(excel.getIdCard())) { // 3. 身份证号
|
||||
throw new RuntimeException(String.format("身份证号[%s]在导入文件中重复,已跳过此条记录", excel.getIdCard()));
|
||||
}
|
||||
newRecords.add(employee);
|
||||
}
|
||||
```
|
||||
|
||||
**更新分支** (第72-88行):
|
||||
```java
|
||||
if (existingIds.contains(excel.getEmployeeId())) {
|
||||
if (!isUpdateSupport) {
|
||||
throw new RuntimeException("柜员号已存在且未启用更新支持");
|
||||
}
|
||||
// 更新模式: 检查Excel内重复
|
||||
if (processedEmployeeIds.contains(excel.getEmployeeId())) { // 2. 柜员号
|
||||
throw new RuntimeException(String.format("柜员号[%d]在导入文件中重复,已跳过此条记录", excel.getEmployeeId()));
|
||||
}
|
||||
if (StringUtils.isNotEmpty(excel.getIdCard()) &&
|
||||
processedIdCards.contains(excel.getIdCard())) { // 3. 身份证号
|
||||
throw new RuntimeException(String.format("身份证号[%s]在导入文件中重复,已跳过此条记录", excel.getIdCard()));
|
||||
}
|
||||
updateRecords.add(employee);
|
||||
}
|
||||
```
|
||||
|
||||
**评价**: 完全符合设计规范，检查顺序正确。
|
||||
|
||||
---
|
||||
|
||||
#### ✅ if-else分支结构 (25/25分)
|
||||
|
||||
**设计规范**: 完整的双分支结构
|
||||
- **数据库存在分支**: 处理更新模式
|
||||
- **数据库不存在分支**: 处理新增模式
|
||||
|
||||
**实际实现**:
|
||||
```java
|
||||
// 第72-88行：数据库存在分支
|
||||
if (existingIds.contains(excel.getEmployeeId())) {
|
||||
// 更新模式检查
|
||||
// ...
|
||||
updateRecords.add(employee);
|
||||
} else {
|
||||
// 第90-101行：数据库不存在分支
|
||||
// 新增模式检查
|
||||
// ...
|
||||
newRecords.add(employee);
|
||||
}
|
||||
```
|
||||
|
||||
**评价**: 分支结构完整，逻辑清晰。
|
||||
|
||||
---
|
||||
|
||||
#### ✅ 标记时机正确 (25/25分)
|
||||
|
||||
**设计规范**: 只在记录成功通过所有验证并确定要插入时，才标记为"已处理"
|
||||
|
||||
**实际实现**:
|
||||
```java
|
||||
// 第71-110行：完整的验证流程
|
||||
if (existingIds.contains(excel.getEmployeeId())) {
|
||||
// 验证Excel内重复
|
||||
// ...
|
||||
updateRecords.add(employee); // 确定插入
|
||||
} else {
|
||||
// 验证Excel内重复
|
||||
// ...
|
||||
newRecords.add(employee); // 确定插入
|
||||
}
|
||||
|
||||
// 第104-110行：统一标记（两个分支后）
|
||||
// 统一标记为已处理（两个分支都会执行到这里）
|
||||
if (excel.getEmployeeId() != null) {
|
||||
processedEmployeeIds.add(excel.getEmployeeId());
|
||||
}
|
||||
if (StringUtils.isNotEmpty(excel.getIdCard())) {
|
||||
processedIdCards.add(excel.getIdCard());
|
||||
}
|
||||
```
|
||||
|
||||
**评价**: 标记时机完全正确，只有成功通过验证的记录才会被标记。
|
||||
|
||||
---
|
||||
|
||||
#### ✅ 空值处理正确 (25/25分)
|
||||
|
||||
**设计规范**: 只有非空的字段才参与重复检测和标记
|
||||
|
||||
**实际实现**:
|
||||
|
||||
**检测时**:
|
||||
```java
|
||||
// 第82-85行：身份证号空值检查
|
||||
if (StringUtils.isNotEmpty(excel.getIdCard()) &&
|
||||
processedIdCards.contains(excel.getIdCard())) {
|
||||
throw new RuntimeException(String.format("身份证号[%s]在导入文件中重复,已跳过此条记录", excel.getIdCard()));
|
||||
}
|
||||
```
|
||||
|
||||
**标记时**:
|
||||
```java
|
||||
// 第105-110行：空值检查
|
||||
if (excel.getEmployeeId() != null) {
|
||||
processedEmployeeIds.add(excel.getEmployeeId());
|
||||
}
|
||||
if (StringUtils.isNotEmpty(excel.getIdCard())) {
|
||||
processedIdCards.add(excel.getIdCard());
|
||||
}
|
||||
```
|
||||
|
||||
**评价**: 空值处理完全正确，符合设计规范。
|
||||
|
||||
---
|
||||
|
||||
#### ✅ 更新模式处理 (25/25分)
|
||||
|
||||
**设计规范**: 更新模式下也要进行Excel内重复检查
|
||||
|
||||
**实际实现**:
|
||||
```java
|
||||
// 第72-88行：更新模式分支
|
||||
if (existingIds.contains(excel.getEmployeeId())) {
|
||||
if (!isUpdateSupport) {
|
||||
throw new RuntimeException("柜员号已存在且未启用更新支持");
|
||||
}
|
||||
|
||||
// 更新模式: 检查Excel内重复
|
||||
if (processedEmployeeIds.contains(excel.getEmployeeId())) {
|
||||
throw new RuntimeException(String.format("柜员号[%d]在导入文件中重复,已跳过此条记录", excel.getEmployeeId()));
|
||||
}
|
||||
if (StringUtils.isNotEmpty(excel.getIdCard()) &&
|
||||
processedIdCards.contains(excel.getIdCard())) {
|
||||
throw new RuntimeException(String.format("身份证号[%s]在导入文件中重复,已跳过此条记录", excel.getIdCard()));
|
||||
}
|
||||
|
||||
// 通过检查,添加到更新列表
|
||||
updateRecords.add(employee);
|
||||
}
|
||||
```
|
||||
|
||||
**评价**: 更新模式下完整实现了Excel内重复检查。
|
||||
|
||||
---
|
||||
|
||||
### 3. 代码一致性检查 (25分)
|
||||
|
||||
#### ✅ 与参考实现风格一致 (25/25分)
|
||||
|
||||
**参考实现** (`CcdiIntermediaryEntityImportServiceImpl.java`):
|
||||
```java
|
||||
if (existingCreditCodes.contains(excel.getSocialCreditCode())) {
|
||||
// 数据库存在,直接报错
|
||||
throw new RuntimeException(String.format("统一社会信用代码[%s]已存在,请勿重复导入", excel.getSocialCreditCode()));
|
||||
} else if (excelProcessedIds.contains(excel.getSocialCreditCode())) {
|
||||
// Excel内重复
|
||||
throw new RuntimeException(String.format("统一社会信用代码[%s]在导入文件中重复,已跳过此条记录", excel.getSocialCreditCode()));
|
||||
} else {
|
||||
newRecords.add(entity);
|
||||
excelProcessedIds.add(excel.getSocialCreditCode()); // 标记为已处理
|
||||
}
|
||||
```
|
||||
|
||||
**当前实现** (`CcdiEmployeeImportServiceImpl.java`):
|
||||
```java
|
||||
if (existingIds.contains(excel.getEmployeeId())) {
|
||||
// 更新模式检查
|
||||
updateRecords.add(employee);
|
||||
} else {
|
||||
// 新增模式检查
|
||||
if (processedEmployeeIds.contains(excel.getEmployeeId())) {
|
||||
throw new RuntimeException(String.format("柜员号[%d]在导入文件中重复,已跳过此条记录", excel.getEmployeeId()));
|
||||
}
|
||||
if (StringUtils.isNotEmpty(excel.getIdCard()) &&
|
||||
processedIdCards.contains(excel.getIdCard())) {
|
||||
throw new RuntimeException(String.format("身份证号[%s]在导入文件中重复,已跳过此条记录", excel.getIdCard()));
|
||||
}
|
||||
newRecords.add(employee);
|
||||
}
|
||||
|
||||
// 统一标记
|
||||
if (excel.getEmployeeId() != null) {
|
||||
processedEmployeeIds.add(excel.getEmployeeId());
|
||||
}
|
||||
if (StringUtils.isNotEmpty(excel.getIdCard())) {
|
||||
processedIdCards.add(excel.getIdCard());
|
||||
}
|
||||
```
|
||||
|
||||
**一致性分析**:
|
||||
- ✅ 错误消息格式完全一致
|
||||
- ✅ 使用 String.format 进行消息格式化
|
||||
- ✅ 异常处理方式一致
|
||||
- ✅ 批量查询模式一致
|
||||
- ✅ 标记逻辑清晰易懂
|
||||
|
||||
**评价**: 代码风格与参考实现保持高度一致。
|
||||
|
||||
---
|
||||
|
||||
#### ✅ 错误消息格式符合要求 (25/25分)
|
||||
|
||||
**设计规范要求**:
|
||||
- 柜员号: "柜员号[XXX]在导入文件中重复,已跳过此条记录"
|
||||
- 身份证号: "身份证号[XXX]在导入文件中重复,已跳过此条记录"
|
||||
|
||||
**实际实现**:
|
||||
```java
|
||||
// 第80行：柜员号错误消息
|
||||
throw new RuntimeException(String.format("柜员号[%d]在导入文件中重复,已跳过此条记录", excel.getEmployeeId()));
|
||||
|
||||
// 第84行：身份证号错误消息
|
||||
throw new RuntimeException(String.format("身份证号[%s]在导入文件中重复,已跳过此条记录", excel.getIdCard()));
|
||||
|
||||
// 第93行：柜员号错误消息（新增分支）
|
||||
throw new RuntimeException(String.format("柜员号[%d]在导入文件中重复,已跳过此条记录", excel.getEmployeeId()));
|
||||
|
||||
// 第97行：身份证号错误消息（新增分支）
|
||||
throw new RuntimeException(String.format("身份证号[%s]在导入文件中重复,已跳过此条记录", excel.getIdCard()));
|
||||
```
|
||||
|
||||
**评价**: 错误消息格式完全符合设计规范要求。
|
||||
|
||||
---
|
||||
|
||||
### 4. 方法签名更新检查 (25分)
|
||||
|
||||
#### ✅ validateEmployeeData 方法签名更新 (25/25分)
|
||||
|
||||
**设计规范**: 添加 existingIdCards 参数
|
||||
|
||||
**实际实现** (第280行):
|
||||
```java
|
||||
/**
|
||||
* 验证员工数据
|
||||
*
|
||||
* @param addDTO 新增DTO
|
||||
* @param isUpdateSupport 是否支持更新
|
||||
* @param existingIds 已存在的员工ID集合(导入场景使用,传null表示单条新增)
|
||||
* @param existingIdCards 已存在的身份证号集合(导入场景使用,传null表示单条新增)
|
||||
*/
|
||||
public void validateEmployeeData(CcdiEmployeeAddDTO addDTO, Boolean isUpdateSupport, Set<Long> existingIds, Set<String> existingIdCards) {
|
||||
// ...
|
||||
}
|
||||
```
|
||||
|
||||
**方法调用** (第66行):
|
||||
```java
|
||||
validateEmployeeData(addDTO, isUpdateSupport, existingIds, existingIdCards);
|
||||
```
|
||||
|
||||
**批量查询结果使用** (第324行):
|
||||
```java
|
||||
// 使用批量查询的结果检查身份证号唯一性
|
||||
if (existingIdCards != null && existingIdCards.contains(addDTO.getIdCard())) {
|
||||
throw new RuntimeException("该身份证号已存在");
|
||||
}
|
||||
```
|
||||
|
||||
**评价**: 方法签名更新完整，参数传递正确，批量查询结果正确使用。
|
||||
|
||||
---
|
||||
|
||||
## 三、代码质量评价
|
||||
|
||||
### 优点总结
|
||||
|
||||
1. **性能优化**: 使用批量查询替代单条查询，显著提升性能
|
||||
2. **逻辑清晰**: 双分支结构清晰，易于理解和维护
|
||||
3. **错误处理完善**: 所有异常情况都有明确的错误消息
|
||||
4. **空值安全**: 正确处理空值情况，避免空指针异常
|
||||
5. **注释清晰**: 关键步骤都有清晰的注释说明
|
||||
6. **符合规范**: 完全符合设计规范和参考实现风格
|
||||
|
||||
### 与参考实现的差异说明
|
||||
|
||||
**差异点**: 当前实现使用了双分支结构（更新/新增），而参考实现使用单分支结构
|
||||
|
||||
**原因分析**:
|
||||
- 参考实现是纯新增模式（不支持更新）
|
||||
- 当前实现支持更新模式，需要区分更新和新增两种场景
|
||||
|
||||
**评价**: 这是合理的差异，双分支结构更适合支持更新模式的场景。
|
||||
|
||||
---
|
||||
|
||||
## 四、测试建议
|
||||
|
||||
### 建议测试场景
|
||||
|
||||
1. **Excel内柜员号重复测试**
|
||||
- 准备3条相同柜员号的记录
|
||||
- 验证只有第一条成功，后2条失败
|
||||
- 验证错误消息格式正确
|
||||
|
||||
2. **Excel内身份证号重复测试**
|
||||
- 准备3条相同身份证号的记录
|
||||
- 验证只有第一条成功，后2条失败
|
||||
- 验证错误消息格式正确
|
||||
|
||||
3. **数据库重复 + Excel内重复测试**
|
||||
- 准备柜员号在数据库存在，且在Excel内重复的记录
|
||||
- 验证更新模式下Excel内重复检查生效
|
||||
|
||||
4. **空值处理测试**
|
||||
- 准备身份证号为空的记录
|
||||
- 验证空值不参与重复检测
|
||||
|
||||
5. **更新模式测试**
|
||||
- 启用更新支持
|
||||
- 验证Excel内重复检查在更新模式下生效
|
||||
|
||||
---
|
||||
|
||||
## 五、最终结论
|
||||
|
||||
### ✅ 完全合规
|
||||
|
||||
**评分**: 100/100
|
||||
|
||||
**合规要点**:
|
||||
- ✅ 功能完整性: 25/25分
|
||||
- ✅ 实现正确性: 25/25分
|
||||
- ✅ 代码一致性: 25/25分
|
||||
- ✅ 方法签名更新: 25/25分
|
||||
|
||||
**审批意见**: 该实现完全符合设计规范要求，可以进行代码合并。
|
||||
|
||||
---
|
||||
|
||||
**审查人**: Claude
|
||||
**审查日期**: 2026-02-09
|
||||
@@ -1,262 +0,0 @@
|
||||
# 员工导入Excel内双字段重复检测功能实现报告
|
||||
|
||||
## 功能概述
|
||||
为员工导入模块添加Excel内双字段(柜员号和身份证号)重复检测功能,防止同一Excel文件中出现重复数据导入到数据库。
|
||||
|
||||
## 实现时间
|
||||
2026-02-09
|
||||
|
||||
## 实现位置
|
||||
- 文件: `D:\ccdi\ccdi\ruoyi-ccdi\src\main\java\com\ruoyi\ccdi\service\impl\CcdiEmployeeImportServiceImpl.java`
|
||||
- 方法: `importEmployeeAsync` (第43-126行)
|
||||
|
||||
## 核心功能
|
||||
|
||||
### 1. 批量查询已存在的身份证号
|
||||
在数据分类前,批量查询数据库中已存在的身份证号:
|
||||
```java
|
||||
Set<Long> existingIds = getExistingEmployeeIds(excelList);
|
||||
Set<String> existingIdCards = getExistingIdCards(excelList);
|
||||
```
|
||||
|
||||
**优点**:
|
||||
- 减少数据库查询次数,提高性能
|
||||
- 避免逐条查询导致的N+1问题
|
||||
|
||||
### 2. 添加Excel内处理跟踪集合
|
||||
```java
|
||||
Set<Long> processedEmployeeIds = new HashSet<>();
|
||||
Set<String> processedIdCards = new HashSet<>();
|
||||
```
|
||||
|
||||
**作用**:
|
||||
- 跟踪Excel文件中已处理的柜员号
|
||||
- 跟踪Excel文件中已处理的身份证号
|
||||
- 用于检测Excel内部的重复数据
|
||||
|
||||
### 3. 双字段重复检测逻辑
|
||||
|
||||
在逐条处理时,按以下顺序检查:
|
||||
|
||||
```java
|
||||
if (existingIds.contains(excel.getEmployeeId())) {
|
||||
// 柜员号在数据库中已存在
|
||||
if (isUpdateSupport) {
|
||||
updateRecords.add(employee);
|
||||
} else {
|
||||
throw new RuntimeException("柜员号已存在且未启用更新支持");
|
||||
}
|
||||
} else if (processedEmployeeIds.contains(excel.getEmployeeId())) {
|
||||
// 柜员号在Excel文件中重复
|
||||
throw new RuntimeException(String.format("柜员号[%d]在导入文件中重复,已跳过此条记录", excel.getEmployeeId()));
|
||||
} else if (StringUtils.isNotEmpty(excel.getIdCard()) &&
|
||||
processedIdCards.contains(excel.getIdCard())) {
|
||||
// 身份证号在Excel文件中重复
|
||||
throw new RuntimeException(String.format("身份证号[%s]在导入文件中重复,已跳过此条记录", excel.getIdCard()));
|
||||
} else {
|
||||
// 无重复,添加到新记录
|
||||
newRecords.add(employee);
|
||||
// 只在成功时标记
|
||||
if (excel.getEmployeeId() != null) {
|
||||
processedEmployeeIds.add(excel.getEmployeeId());
|
||||
}
|
||||
if (StringUtils.isNotEmpty(excel.getIdCard())) {
|
||||
processedIdCards.add(excel.getIdCard());
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
**检查顺序**:
|
||||
1. 先检查柜员号是否在数据库中存在
|
||||
2. 再检查柜员号是否在Excel文件内重复
|
||||
3. 最后检查身份证号是否在Excel文件内重复
|
||||
4. 只在记录成功添加到newRecords后才标记为已处理
|
||||
|
||||
### 4. 更新validateEmployeeData方法
|
||||
|
||||
**修改前**:
|
||||
```java
|
||||
public void validateEmployeeData(CcdiEmployeeAddDTO addDTO, Boolean isUpdateSupport, Set<Long> existingIds)
|
||||
```
|
||||
|
||||
**修改后**:
|
||||
```java
|
||||
public void validateEmployeeData(CcdiEmployeeAddDTO addDTO, Boolean isUpdateSupport, Set<Long> existingIds, Set<String> existingIdCards)
|
||||
```
|
||||
|
||||
**身份证号唯一性检查优化**:
|
||||
```java
|
||||
// 导入场景:如果柜员号不存在,才检查身份证号唯一性
|
||||
if (!existingIds.contains(addDTO.getEmployeeId())) {
|
||||
// 使用批量查询的结果检查身份证号唯一性
|
||||
if (existingIdCards != null && existingIdCards.contains(addDTO.getIdCard())) {
|
||||
throw new RuntimeException("该身份证号已存在");
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
**优点**:
|
||||
- 使用批量查询结果,避免逐条查询
|
||||
- 提高导入性能
|
||||
|
||||
## 技术特点
|
||||
|
||||
### 1. 双字段同时检测
|
||||
同时检测柜员号(Long类型)和身份证号(String类型)的Excel内重复
|
||||
|
||||
### 2. 检查顺序合理
|
||||
- 先检查数据库重复(避免无效数据处理)
|
||||
- 再检查Excel内重复(防止重复导入)
|
||||
- 最后标记已处理(只在成功后标记)
|
||||
|
||||
### 3. 空值处理
|
||||
使用`StringUtils.isNotEmpty`和`Objects::nonNull`进行空值检查,避免空指针异常
|
||||
|
||||
### 4. 错误消息明确
|
||||
- 柜员号重复: "柜员号[XXX]在导入文件中重复,已跳过此条记录"
|
||||
- 身份证号重复: "身份证号[XXX]在导入文件中重复,已跳过此条记录"
|
||||
|
||||
### 5. 性能优化
|
||||
- 批量查询数据库中已存在的柜员号和身份证号
|
||||
- 使用HashSet进行O(1)复杂度的重复检测
|
||||
- 减少数据库查询次数
|
||||
|
||||
## 测试场景
|
||||
|
||||
### 场景1: 柜员号在Excel内重复
|
||||
**输入**:
|
||||
```
|
||||
柜员号 姓名 身份证号
|
||||
1001 张三 110101199001011234
|
||||
1001 李四 110101199001011235
|
||||
```
|
||||
|
||||
**期望结果**:
|
||||
- 第一条记录成功导入
|
||||
- 第二条记录失败,错误信息: "柜员号[1001]在导入文件中重复,已跳过此条记录"
|
||||
|
||||
### 场景2: 身份证号在Excel内重复
|
||||
**输入**:
|
||||
```
|
||||
柜员号 姓名 身份证号
|
||||
1001 张三 110101199001011234
|
||||
1002 李四 110101199001011234
|
||||
```
|
||||
|
||||
**期望结果**:
|
||||
- 第一条记录成功导入
|
||||
- 第二条记录失败,错误信息: "身份证号[110101199001011234]在导入文件中重复,已跳过此条记录"
|
||||
|
||||
### 场景3: 柜员号和身份证号同时重复
|
||||
**输入**:
|
||||
```
|
||||
柜员号 姓名 身份证号
|
||||
1001 张三 110101199001011234
|
||||
1001 张三 110101199001011234
|
||||
```
|
||||
|
||||
**期望结果**:
|
||||
- 第一条记录成功导入
|
||||
- 第二条记录失败,错误信息: "柜员号[1001]在导入文件中重复,已跳过此条记录"
|
||||
|
||||
### 场景4: 正常导入(无重复)
|
||||
**输入**:
|
||||
```
|
||||
柜员号 姓名 身份证号
|
||||
1001 张三 110101199001011234
|
||||
1002 李四 110101199001011235
|
||||
1003 王五 110101199001011236
|
||||
```
|
||||
|
||||
**期望结果**:
|
||||
- 所有记录都成功导入
|
||||
|
||||
## 代码对比
|
||||
|
||||
### 修改前
|
||||
```java
|
||||
// 批量查询已存在的柜员号
|
||||
Set<Long> existingIds = getExistingEmployeeIds(excelList);
|
||||
|
||||
// 分类数据
|
||||
for (int i = 0; i < excelList.size(); i++) {
|
||||
// ...
|
||||
validateEmployeeData(addDTO, isUpdateSupport, existingIds);
|
||||
|
||||
if (existingIds.contains(excel.getEmployeeId())) {
|
||||
if (isUpdateSupport) {
|
||||
updateRecords.add(employee);
|
||||
} else {
|
||||
throw new RuntimeException("柜员号已存在且未启用更新支持");
|
||||
}
|
||||
} else {
|
||||
newRecords.add(employee);
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
### 修改后
|
||||
```java
|
||||
// 批量查询已存在的柜员号和身份证号
|
||||
Set<Long> existingIds = getExistingEmployeeIds(excelList);
|
||||
Set<String> existingIdCards = getExistingIdCards(excelList);
|
||||
|
||||
// 用于跟踪Excel文件内已处理的主键
|
||||
Set<Long> processedEmployeeIds = new HashSet<>();
|
||||
Set<String> processedIdCards = new HashSet<>();
|
||||
|
||||
// 分类数据
|
||||
for (int i = 0; i < excelList.size(); i++) {
|
||||
// ...
|
||||
validateEmployeeData(addDTO, isUpdateSupport, existingIds, existingIdCards);
|
||||
|
||||
if (existingIds.contains(excel.getEmployeeId())) {
|
||||
if (isUpdateSupport) {
|
||||
updateRecords.add(employee);
|
||||
} else {
|
||||
throw new RuntimeException("柜员号已存在且未启用更新支持");
|
||||
}
|
||||
} else if (processedEmployeeIds.contains(excel.getEmployeeId())) {
|
||||
throw new RuntimeException(String.format("柜员号[%d]在导入文件中重复,已跳过此条记录", excel.getEmployeeId()));
|
||||
} else if (StringUtils.isNotEmpty(excel.getIdCard()) &&
|
||||
processedIdCards.contains(excel.getIdCard())) {
|
||||
throw new RuntimeException(String.format("身份证号[%s]在导入文件中重复,已跳过此条记录", excel.getIdCard()));
|
||||
} else {
|
||||
newRecords.add(employee);
|
||||
// 只在成功时标记
|
||||
if (excel.getEmployeeId() != null) {
|
||||
processedEmployeeIds.add(excel.getEmployeeId());
|
||||
}
|
||||
if (StringUtils.isNotEmpty(excel.getIdCard())) {
|
||||
processedIdCards.add(excel.getIdCard());
|
||||
}
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
## 参考实现
|
||||
本功能参考了中介人员导入模块的双字段重复检测实现:
|
||||
- 文件: `CcdiIntermediaryEntityImportServiceImpl.java`
|
||||
- 关键方法: `importEntityAsync`
|
||||
|
||||
## 编译验证
|
||||
已通过Maven编译验证,无语法错误:
|
||||
```bash
|
||||
mvn clean compile -DskipTests
|
||||
```
|
||||
|
||||
编译结果: BUILD SUCCESS
|
||||
|
||||
## 测试脚本
|
||||
测试脚本位置: `D:\ccdi\ccdi\doc\test-scripts\test_employee_duplicate_detection.py`
|
||||
|
||||
## 总结
|
||||
本次实现成功为员工导入模块添加了Excel内双字段重复检测功能,主要改进包括:
|
||||
|
||||
1. **批量查询优化**: 添加`getExistingIdCards`方法批量查询已存在的身份证号
|
||||
2. **双字段检测**: 同时检测柜员号和身份证号的Excel内重复
|
||||
3. **性能优化**: 使用批量查询减少数据库访问次数
|
||||
4. **错误处理**: 提供明确的错误提示信息
|
||||
5. **代码规范**: 遵循若依框架编码规范,使用MyBatis Plus进行数据操作
|
||||
|
||||
该功能可以有效防止Excel文件内部的重复数据导入到数据库,提高数据质量和导入可靠性。
|
||||
@@ -1,303 +0,0 @@
|
||||
# 员工导入Excel内双字段重复检测 - 代码流程说明
|
||||
|
||||
## 方法签名
|
||||
```java
|
||||
public void importEmployeeAsync(List<CcdiEmployeeExcel> excelList, Boolean isUpdateSupport, String taskId)
|
||||
```
|
||||
|
||||
## 完整流程图
|
||||
|
||||
```
|
||||
开始
|
||||
│
|
||||
├─ 1. 初始化集合
|
||||
│ ├─ newRecords = new ArrayList<>() // 新增记录
|
||||
│ ├─ updateRecords = new ArrayList<>() // 更新记录
|
||||
│ └─ failures = new ArrayList<>() // 失败记录
|
||||
│
|
||||
├─ 2. 批量查询数据库
|
||||
│ ├─ getExistingEmployeeIds(excelList)
|
||||
│ │ └─ 返回: Set<Long> existingIds // 数据库中已存在的柜员号
|
||||
│ │
|
||||
│ └─ getExistingIdCards(excelList)
|
||||
│ └─ 返回: Set<String> existingIdCards // 数据库中已存在的身份证号
|
||||
│
|
||||
├─ 3. 初始化Excel内跟踪集合
|
||||
│ ├─ processedEmployeeIds = new HashSet<>() // Excel内已处理的柜员号
|
||||
│ └─ processedIdCards = new HashSet<>() // Excel内已处理的身份证号
|
||||
│
|
||||
├─ 4. 遍历Excel数据
|
||||
│ │
|
||||
│ └─ FOR EACH excel IN excelList
|
||||
│ │
|
||||
│ ├─ 4.1 数据转换
|
||||
│ │ ├─ addDTO = new CcdiEmployeeAddDTO()
|
||||
│ │ ├─ BeanUtils.copyProperties(excel, addDTO)
|
||||
│ │ └─ employee = new CcdiEmployee()
|
||||
│ │ └─ BeanUtils.copyProperties(excel, employee)
|
||||
│ │
|
||||
│ ├─ 4.2 数据验证
|
||||
│ │ └─ validateEmployeeData(addDTO, isUpdateSupport, existingIds, existingIdCards)
|
||||
│ │ ├─ 验证必填字段(姓名、柜员号、部门、身份证号、电话、状态)
|
||||
│ │ ├─ 验证身份证号格式
|
||||
│ │ └─ 验证柜员号和身份证号唯一性
|
||||
│ │
|
||||
│ ├─ 4.3 重复检测与分类
|
||||
│ │ │
|
||||
│ │ ├─ IF existingIds.contains(excel.getEmployeeId())
|
||||
│ │ │ ├─ 柜员号在数据库中已存在
|
||||
│ │ │ ├─ IF isUpdateSupport
|
||||
│ │ │ │ └─ updateRecords.add(employee) // 添加到更新列表
|
||||
│ │ │ └─ ELSE
|
||||
│ │ │ └─ throw RuntimeException("柜员号已存在且未启用更新支持")
|
||||
│ │ │
|
||||
│ │ ├─ ELSE IF processedEmployeeIds.contains(excel.getEmployeeId())
|
||||
│ │ │ └─ throw RuntimeException("柜员号[XXX]在导入文件中重复,已跳过此条记录")
|
||||
│ │ │
|
||||
│ │ ├─ ELSE IF processedIdCards.contains(excel.getIdCard())
|
||||
│ │ │ └─ throw RuntimeException("身份证号[XXX]在导入文件中重复,已跳过此条记录")
|
||||
│ │ │
|
||||
│ │ └─ ELSE
|
||||
│ │ ├─ newRecords.add(employee) // 添加到新增列表
|
||||
│ │ ├─ IF excel.getEmployeeId() != null
|
||||
│ │ │ └─ processedEmployeeIds.add(excel.getEmployeeId()) // 标记柜员号
|
||||
│ │ └─ IF StringUtils.isNotEmpty(excel.getIdCard())
|
||||
│ │ └─ processedIdCards.add(excel.getIdCard()) // 标记身份证号
|
||||
│ │
|
||||
│ └─ 4.4 异常处理
|
||||
│ └─ CATCH Exception
|
||||
│ ├─ failure = new ImportFailureVO()
|
||||
│ ├─ BeanUtils.copyProperties(excel, failure)
|
||||
│ ├─ failure.setErrorMessage(e.getMessage())
|
||||
│ └─ failures.add(failure)
|
||||
│
|
||||
├─ 5. 批量操作数据库
|
||||
│ ├─ IF !newRecords.isEmpty()
|
||||
│ │ └─ saveBatch(newRecords, 500) // 批量插入新数据
|
||||
│ │
|
||||
│ └─ IF !updateRecords.isEmpty() && isUpdateSupport
|
||||
│ └─ employeeMapper.insertOrUpdateBatch(updateRecords) // 批量更新已有数据
|
||||
│
|
||||
├─ 6. 保存失败记录到Redis
|
||||
│ └─ IF !failures.isEmpty()
|
||||
│ └─ redisTemplate.opsForValue().set("import:employee:" + taskId + ":failures", failures, 7, TimeUnit.DAYS)
|
||||
│
|
||||
├─ 7. 生成导入结果
|
||||
│ ├─ result = new ImportResult()
|
||||
│ ├─ result.setTotalCount(excelList.size())
|
||||
│ ├─ result.setSuccessCount(newRecords.size() + updateRecords.size())
|
||||
│ └─ result.setFailureCount(failures.size())
|
||||
│
|
||||
└─ 8. 更新导入状态
|
||||
└─ updateImportStatus("employee", taskId, finalStatus, result)
|
||||
└─ IF result.getFailureCount() == 0
|
||||
└─ finalStatus = "SUCCESS"
|
||||
└─ ELSE
|
||||
└─ finalStatus = "PARTIAL_SUCCESS"
|
||||
|
||||
结束
|
||||
```
|
||||
|
||||
## 关键逻辑说明
|
||||
|
||||
### 1. 重复检测优先级
|
||||
```
|
||||
数据库柜员号重复 > Excel内柜员号重复 > Excel内身份证号重复
|
||||
```
|
||||
|
||||
**原因**:
|
||||
- 数据库检查优先: 避免处理已经存在且不允许更新的数据
|
||||
- Excel内柜员号检查: 柜员号是主键,优先检查
|
||||
- Excel内身份证号检查: 身份证号也需要唯一性
|
||||
|
||||
### 2. 标记时机
|
||||
```
|
||||
只在记录成功添加到newRecords后才标记为已处理
|
||||
```
|
||||
|
||||
**原因**:
|
||||
- 避免将验证失败的记录标记为已处理
|
||||
- 确保只有成功插入数据库的记录才会占用柜员号和身份证号
|
||||
- 防止因前一条记录失败导致后一条有效记录被误判为重复
|
||||
|
||||
### 3. 空值处理
|
||||
```java
|
||||
// 柜员号空值检查
|
||||
if (excel.getEmployeeId() != null) {
|
||||
processedEmployeeIds.add(excel.getEmployeeId());
|
||||
}
|
||||
|
||||
// 身份证号空值检查
|
||||
if (StringUtils.isNotEmpty(excel.getIdCard())) {
|
||||
processedIdCards.add(excel.getIdCard());
|
||||
}
|
||||
```
|
||||
|
||||
**原因**:
|
||||
- 防止空指针异常
|
||||
- 确保只有有效的柜员号和身份证号才会被检查重复
|
||||
|
||||
### 4. 批量查询优化
|
||||
```java
|
||||
// 批量查询柜员号
|
||||
Set<Long> existingIds = getExistingEmployeeIds(excelList);
|
||||
|
||||
// 批量查询身份证号
|
||||
Set<String> existingIdCards = getExistingIdCards(excelList);
|
||||
```
|
||||
|
||||
**优点**:
|
||||
- 一次性查询所有需要的数据
|
||||
- 避免逐条查询导致的N+1问题
|
||||
- 使用HashSet实现O(1)复杂度的查找
|
||||
|
||||
## 错误消息说明
|
||||
|
||||
### 1. 柜员号在数据库中已存在
|
||||
```java
|
||||
"柜员号已存在且未启用更新支持"
|
||||
```
|
||||
|
||||
### 2. 柜员号在Excel内重复
|
||||
```java
|
||||
String.format("柜员号[%d]在导入文件中重复,已跳过此条记录", excel.getEmployeeId())
|
||||
```
|
||||
|
||||
**示例**: "柜员号[1001]在导入文件中重复,已跳过此条记录"
|
||||
|
||||
### 3. 身份证号在Excel内重复
|
||||
```java
|
||||
String.format("身份证号[%s]在导入文件中重复,已跳过此条记录", excel.getIdCard())
|
||||
```
|
||||
|
||||
**示例**: "身份证号[110101199001011234]在导入文件中重复,已跳过此条记录"
|
||||
|
||||
## validateEmployeeData方法说明
|
||||
|
||||
### 方法签名
|
||||
```java
|
||||
public void validateEmployeeData(CcdiEmployeeAddDTO addDTO,
|
||||
Boolean isUpdateSupport,
|
||||
Set<Long> existingIds,
|
||||
Set<String> existingIdCards)
|
||||
```
|
||||
|
||||
### 验证流程
|
||||
```
|
||||
1. 验证必填字段
|
||||
├─ 姓名不能为空
|
||||
├─ 柜员号不能为空
|
||||
├─ 所属部门不能为空
|
||||
├─ 身份证号不能为空
|
||||
├─ 电话不能为空
|
||||
└─ 状态不能为空
|
||||
|
||||
2. 验证身份证号格式
|
||||
└─ IdCardUtil.getErrorMessage(addDTO.getIdCard())
|
||||
|
||||
3. 验证唯一性
|
||||
├─ IF existingIds == null (单条新增场景)
|
||||
│ ├─ 检查柜员号唯一性(数据库查询)
|
||||
│ └─ 检查身份证号唯一性(数据库查询)
|
||||
│
|
||||
└─ ELSE (导入场景)
|
||||
├─ IF 柜员号不存在于数据库
|
||||
│ └─ 检查身份证号唯一性(使用批量查询结果)
|
||||
└─ ELSE (柜员号已存在,允许更新)
|
||||
└─ 跳过身份证号检查(更新模式下不检查身份证号重复)
|
||||
|
||||
4. 验证状态
|
||||
└─ 状态只能填写'0'(在职)或'1'(离职)
|
||||
```
|
||||
|
||||
### 导入场景的身份证号唯一性检查优化
|
||||
```java
|
||||
// 导入场景:如果柜员号不存在,才检查身份证号唯一性
|
||||
if (!existingIds.contains(addDTO.getEmployeeId())) {
|
||||
// 使用批量查询的结果检查身份证号唯一性
|
||||
if (existingIdCards != null && existingIdCards.contains(addDTO.getIdCard())) {
|
||||
throw new RuntimeException("该身份证号已存在");
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
**优化点**:
|
||||
- 使用批量查询结果`existingIdCards`,避免逐条查询数据库
|
||||
- 只在柜员号不存在时才检查身份证号(因为柜员号存在时是更新模式)
|
||||
|
||||
## 批量查询方法说明
|
||||
|
||||
### getExistingEmployeeIds
|
||||
```java
|
||||
private Set<Long> getExistingEmployeeIds(List<CcdiEmployeeExcel> excelList) {
|
||||
List<Long> employeeIds = excelList.stream()
|
||||
.map(CcdiEmployeeExcel::getEmployeeId)
|
||||
.filter(Objects::nonNull)
|
||||
.collect(Collectors.toList());
|
||||
|
||||
if (employeeIds.isEmpty()) {
|
||||
return Collections.emptySet();
|
||||
}
|
||||
|
||||
List<CcdiEmployee> existingEmployees = employeeMapper.selectBatchIds(employeeIds);
|
||||
return existingEmployees.stream()
|
||||
.map(CcdiEmployee::getEmployeeId)
|
||||
.collect(Collectors.toSet());
|
||||
}
|
||||
```
|
||||
|
||||
### getExistingIdCards
|
||||
```java
|
||||
private Set<String> getExistingIdCards(List<CcdiEmployeeExcel> excelList) {
|
||||
List<String> idCards = excelList.stream()
|
||||
.map(CcdiEmployeeExcel::getIdCard)
|
||||
.filter(StringUtils::isNotEmpty)
|
||||
.collect(Collectors.toList());
|
||||
|
||||
if (idCards.isEmpty()) {
|
||||
return Collections.emptySet();
|
||||
}
|
||||
|
||||
LambdaQueryWrapper<CcdiEmployee> wrapper = new LambdaQueryWrapper<>();
|
||||
wrapper.in(CcdiEmployee::getIdCard, idCards);
|
||||
List<CcdiEmployee> existingEmployees = employeeMapper.selectList(wrapper);
|
||||
|
||||
return existingEmployees.stream()
|
||||
.map(CcdiEmployee::getIdCard)
|
||||
.collect(Collectors.toSet());
|
||||
}
|
||||
```
|
||||
|
||||
**特点**:
|
||||
- 使用Stream API进行数据提取和过滤
|
||||
- 过滤空值,避免无效查询
|
||||
- 使用MyBatis Plus的批量查询方法
|
||||
- 返回Set集合,实现O(1)复杂度的查找
|
||||
|
||||
## 性能分析
|
||||
|
||||
### 时间复杂度
|
||||
- 批量查询: O(n), n为Excel记录数
|
||||
- 重复检测: O(1), 使用HashSet
|
||||
- 总体复杂度: O(n)
|
||||
|
||||
### 空间复杂度
|
||||
- existingIds: O(m), m为数据库中已存在的柜员号数量
|
||||
- existingIdCards: O(k), k为数据库中已存在的身份证号数量
|
||||
- processedEmployeeIds: O(n), n为Excel记录数
|
||||
- processedIdCards: O(n), n为Excel记录数
|
||||
- 总体空间复杂度: O(m + k + n)
|
||||
|
||||
### 数据库查询次数
|
||||
- 修改前: 1次(批量查询柜员号) + n次(逐条查询身份证号) = O(n)
|
||||
- 修改后: 2次(批量查询柜员号 + 批量查询身份证号) = O(1)
|
||||
|
||||
**性能提升**: 减少n-1次数据库查询
|
||||
|
||||
## 总结
|
||||
本实现通过以下技术手段实现了Excel内双字段重复检测:
|
||||
1. 批量查询优化,减少数据库访问
|
||||
2. 使用HashSet进行O(1)复杂度的重复检测
|
||||
3. 合理的检查顺序和标记时机
|
||||
4. 完善的空值处理和错误提示
|
||||
5. 遵循若依框架编码规范,使用MyBatis Plus进行数据操作
|
||||
Binary file not shown.
|
Before Width: | Height: | Size: 161 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 103 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 393 KiB |
@@ -1,162 +0,0 @@
|
||||
# 中介黑名单导入功能修复说明
|
||||
|
||||
## 问题描述
|
||||
|
||||
在导入机构中介黑名单数据时，出现以下错误：
|
||||
|
||||
```
|
||||
Error updating database. Cause: java.sql.SQLIntegrityConstraintViolationException: Column 'certificate_no' cannot be null
|
||||
```
|
||||
|
||||
## 问题原因
|
||||
|
||||
1. **数据库约束**：`ccdi_intermediary_blacklist` 表的 `certificate_no` 字段设置为 `NOT NULL`，不允许存储 null 值。
|
||||
|
||||
2. **代码缺陷**：在 `CcdiIntermediaryBlacklistServiceImpl.java` 的 `importEntityIntermediary` 方法中，导入机构中介时只设置了 `corpCreditCode`（统一社会信用代码），但没有设置 `certificateNo` 字段，导致该字段为 null。
|
||||
|
||||
3. **批量插入失败**：`batchInsert` 方法明确插入 `certificate_no` 字段，当值为 null 时违反数据库约束。
|
||||
|
||||
## 解决方案
|
||||
|
||||
### 1. 代码修改
|
||||
|
||||
**文件**：[CcdiIntermediaryBlacklistServiceImpl.java](d:\discipline-prelim-check\discipline-prelim-check\ruoyi-ccdi\src\main\java\com\ruoyi\dpc\service\impl\CcdiIntermediaryBlacklistServiceImpl.java)
|
||||
|
||||
**修改位置**：第 390-394 行
|
||||
|
||||
**修改前**：
|
||||
```java
|
||||
// 转换为实体
|
||||
CcdiIntermediaryBlacklist intermediary = new CcdiIntermediaryBlacklist();
|
||||
intermediary.setName(excel.getName());
|
||||
intermediary.setIntermediaryType("2");
|
||||
```
|
||||
|
||||
**修改后**：
|
||||
```java
|
||||
// 转换为实体
|
||||
CcdiIntermediaryBlacklist intermediary = new CcdiIntermediaryBlacklist();
|
||||
intermediary.setName(excel.getName());
|
||||
// 对于机构中介，使用统一社会信用代码作为证件号
|
||||
intermediary.setCertificateNo(excel.getCorpCreditCode());
|
||||
intermediary.setIntermediaryType("2");
|
||||
```
|
||||
|
||||
### 2. 验证逻辑增强
|
||||
|
||||
**文件**：[CcdiIntermediaryBlacklistServiceImpl.java](d:\discipline-prelim-check\discipline-prelim-check\ruoyi-ccdi\src\main\java\com\ruoyi\dpc\service\impl\CcdiIntermediaryBlacklistServiceImpl.java)
|
||||
|
||||
**修改位置**：第 484-488 行
|
||||
|
||||
**修改前**：
|
||||
```java
|
||||
private void validateEntityIntermediaryData(CcdiIntermediaryEntityExcel excel) {
|
||||
if (StringUtils.isEmpty(excel.getName())) {
|
||||
throw new RuntimeException("机构名称不能为空");
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
**修改后**：
|
||||
```java
|
||||
private void validateEntityIntermediaryData(CcdiIntermediaryEntityExcel excel) {
|
||||
if (StringUtils.isEmpty(excel.getName())) {
|
||||
throw new RuntimeException("机构名称不能为空");
|
||||
}
|
||||
// 验证统一社会信用代码不能为空（因为会用作 certificate_no 字段）
|
||||
if (StringUtils.isEmpty(excel.getCorpCreditCode())) {
|
||||
throw new RuntimeException("统一社会信用代码不能为空");
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
### 3. 批量更新 XML 配置优化
|
||||
|
||||
**文件**：[CcdiIntermediaryBlacklistMapper.xml](d:\discipline-prelim-check\discipline-prelim-check\ruoyi-ccdi\src\main\resources\mapper\dpc\CcdiIntermediaryBlacklistMapper.xml)
|
||||
|
||||
**修改位置**：第 125-127 行
|
||||
|
||||
**修改前**：
|
||||
```xml
|
||||
<if test="item.dataSource != null">data_source = #{item.dataSource},</if>
|
||||
update_by = #{item.updateBy},
|
||||
update_time = #{item.updateTime}
|
||||
```
|
||||
|
||||
**修改后**：
|
||||
```xml
|
||||
<if test="item.dataSource != null">data_source = #{item.dataSource},</if>
|
||||
<if test="item.certificateNo != null">certificate_no = #{item.certificateNo},</if>
|
||||
update_by = #{item.updateBy},
|
||||
update_time = #{item.updateTime}
|
||||
```
|
||||
|
||||
## 设计说明
|
||||
|
||||
### 为什么使用统一社会信用代码作为证件号？
|
||||
|
||||
1. **数据一致性**：统一社会信用代码本身就是机构的法定证件号，将其同时存储在 `certificate_no` 字段中可以保持数据的一致性。
|
||||
|
||||
2. **查询便利**：`certificate_no` 字段有索引，设置后可以快速查询机构中介。
|
||||
|
||||
3. **兼容性好**：个人中介和机构中介都使用 `certificate_no` 字段，查询逻辑更统一。
|
||||
|
||||
4. **不破坏现有结构**：不需要修改数据库表结构，只修改代码逻辑。
|
||||
|
||||
## 测试验证
|
||||
|
||||
### 测试用例
|
||||
|
||||
1. **个人中介导入**：正常导入个人中介数据，验证 `certificate_no` 字段正确存储身份证号。
|
||||
|
||||
2. **机构中介导入**：导入机构中介数据，验证 `certificate_no` 字段正确存储统一社会信用代码。
|
||||
|
||||
3. **统一社会信用代码为空**：验证当统一社会信用代码为空时，导入被正确拒绝并给出错误提示。
|
||||
|
||||
4. **批量更新**：验证批量更新时 `certificate_no` 字段能够正确更新。
|
||||
|
||||
### 测试脚本
|
||||
|
||||
测试脚本位于：[doc/test-data/test_import_fix.py](d:\discipline-prelim-check\discipline-prelim-check\doc\test-data\test_import_fix.py)
|
||||
|
||||
运行测试：
|
||||
```bash
|
||||
python doc/test-data/test_import_fix.py
|
||||
```
|
||||
|
||||
## 影响范围
|
||||
|
||||
### 已影响的功能
|
||||
- 机构中介批量导入功能
|
||||
|
||||
### 不影响的功能
|
||||
- 个人中介导入功能
|
||||
- 手动新增中介功能
|
||||
- 中介查询功能
|
||||
- 中介导出功能
|
||||
|
||||
## 注意事项
|
||||
|
||||
1. **数据迁移**：如果数据库中已存在机构中介数据且 `certificate_no` 为 null，需要执行以下 SQL 进行数据修复：
|
||||
|
||||
```sql
|
||||
UPDATE ccdi_intermediary_blacklist
|
||||
SET certificate_no = corp_credit_code
|
||||
WHERE intermediary_type = '2' AND certificate_no IS NULL AND corp_credit_code IS NOT NULL;
|
||||
```
|
||||
|
||||
2. **Excel 模板**：确保导入模板中统一社会信用代码字段设置为必填项。
|
||||
|
||||
3. **前端验证**：建议在前端表单中也添加统一社会信用代码的必填验证。
|
||||
|
||||
## 修改文件列表
|
||||
|
||||
1. [CcdiIntermediaryBlacklistServiceImpl.java](d:\discipline-prelim-check\discipline-prelim-check\ruoyi-ccdi\src\main\java\com\ruoyi\dpc\service\impl\CcdiIntermediaryBlacklistServiceImpl.java) - 服务层实现
|
||||
2. [CcdiIntermediaryBlacklistMapper.xml](d:\discipline-prelim-check\discipline-prelim-check\ruoyi-ccdi\src\main\resources\mapper\dpc\CcdiIntermediaryBlacklistMapper.xml) - MyBatis 映射文件
|
||||
3. [test_import_fix.py](d:\discipline-prelim-check\discipline-prelim-check\doc\test-data\test_import_fix.py) - 测试脚本
|
||||
|
||||
## 版本历史
|
||||
|
||||
| 版本 | 日期 | 作者 | 说明 |
|
||||
|------|------|------|------|
|
||||
| 1.0 | 2026-01-29 | ruoyi | 初始版本，修复机构中介导入时 certificate_no 为 null 的问题 |
|
||||
Binary file not shown.
@@ -1 +0,0 @@
|
||||
window.ENV = {"IS_FEAT_FLPAK4GB":true,"IS_FEAT_ABOARD":true,"IS_FEAT_SIGMA":true,"IS_LEGACY_V7":true,"BOMX_API_SDK_URL":"https://sdk.boardmix.cn/bmsdk","BOMX_API_CLIENT_ID":"IpfSMaEsOHWu7cg7","AIPPT_CLIENT_ID":"0ePnORDMD6KJSIIB","AIPPT_API_SDK_URL":"https://sdk.pptgo.cn/pptsdk","PIXSO_API_URL":"https://ps.modao.cc","PIXSO_USER_CLIENT_ID":"pixso_design_online"}
|
||||
@@ -1 +0,0 @@
|
||||
TAG_V++3NXya0fYxmDs8mWSM69pSHMU=|2026-01-27T00_2026-01-27T00:11:10.126Z
|
||||
@@ -1 +0,0 @@
|
||||
window["hzv5"] = window["hzv5"] || {};window["hzv5"]["init"] = {"MBServer":"modao.cc","MBClientDownloadURL":"https://cdn-release.modao.cc/desktop/Mockitt-darwin-x64-zh-1.2.5.dmg","MBChromeDownloadURL":"https://www.google.cn/chrome/","MBSketchPluginDownloadURL":"https://cdn-release.modao.cc/sketch/MockingBot.zh.sketchplugin.zip","isOnPremises":false,"isWonderShare":false,"projectUpper":{"owner_id":2209883,"owner_name":"谢小涵","owner_email":"153276082@qq.com","owner_avatar":"https://oss-mb-fog.modao.cc/uploads4/avatars/220/2209883/forum_132.jpeg","id":33418631,"limitation":{"storage":5000,"exportable":["png","pngs","htmlzip"],"encryptable":true,"inspectable":true,"slices":true,"projects":65535,"screens":65535,"commentable":true},"screens_count":5,"cid":"pb2mk0rvsqu5j6763","team_cid":"temk0rv8qmsbc9ft","space_cid":"splopmenp3ricy1f","space_name":"默认空间","name":"纪检初核系统","type":"proto2","attr":{"export_settings":[{"affix":"suffix","scale":"1","format":"png"}],"export_with_device_frame":false},"created_at":1767594090000,"updated_at":1768285464000,"timestamp":"1768285464","access":"public","access_token":"WEvGV4cIt8dobuo9KjUF","version":"v3","icon":null,"cover":"/uploads7/covers/3341/33418631/cover_1769473447.png","custom_cover":null,"is_custom_cover":false,"splash":null,"width":1440,"height":1024,"device":"web","model":"desktop","scale":100,"archived":false,"is_sclib":false,"parent_cid":"pb2m9uxlouyf4dwms","source_upper_cid":null,"clones":11,"shell_type":"device","password":"","wechat":false,"highlight":true,"preview_option":1,"expired":false,"deleted":false,"duplicating":false,"permissions":[{"user_id":2209883,"role":"project_owner"}],"is_org_project":false,"is_sub_project":false,"runner_mode":"preview","comment_permission":"org_member","tabs":null,"visibility":"open","building":"view_sticky","scene_tag":"PC-web","is_solo_lifetime":true,"is_first_canvas_open":null},"projectMeta":{"cid":"pm2mk0rvsquvpcjcs","mtime":1767594090054,"name":"","type":"proto2","ttag":"flat","upper_cid":"pb2mk0rvsqu5j6763","upper_type":"project-basic","is_flat_meta":true}}
|
||||
File diff suppressed because one or more lines are too long
@@ -1 +0,0 @@
|
||||
window["hzv5"] = window["hzv5"] || {};window["hzv5"]["mktc"] = {"md_vip_mkt_list":[],"mt_vip_mkt_list":[],"no_wm_mkt_list":["igk8iirffgi4hpfx","igk8iisxdk72zt9","igk8iiv3qpgl3lsx","igk8iiw2zlastfks","igk8ij5zxd43jlud","igk8ijdjkayrsvvz","igk8ijgosea1iye0","igkszmzkoc8bv5fq","igkw1wjh6762ojwr","igkwotlxrcwn19vd"]}
|
||||
@@ -1,44 +0,0 @@
|
||||
<!doctype html><html translate="no"><head><meta charset="UTF-8"><meta name="viewport" content="width=device-width,user-scalable=no,initial-scale=1,maximum-scale=1,minimum-scale=1"><meta name="apple-mobile-web-app-capable" content="yes"><meta name="mobile-web-app-capable" content="yes"><meta name="renderer" content="webkit"><meta http-equiv="X-UA-Compatible" content="ie=edge"><title>墨刀</title><link rel="icon" id="icon" href="mb-proto2/vis/modao/favicon_home_screen_new.ico"><link rel="apple-touch-icon-precomposed" id="apple-touch-icon" href="mb-proto2/vis/modao/favicon_home_screen_new.ico"><link rel="stylesheet" href="mb-proto2/icons/fa5/css/fa5.css"><script>if (
|
||||
function() { try { eval([
|
||||
'for (const a of []) {}',
|
||||
'let b = { fetch, Proxy }',
|
||||
'let c = (async () => {})()',
|
||||
'let { d0, ...d1 } = { ...b }'
|
||||
].join(';')) } catch (e) { console.log('!!', e); return true } }()
|
||||
) location.href = "https://modao.cc/browser-update"</script><script src="mb-static/2410/echarts-map/loadMap.js"></script><script src="env/2203.js"></script><script>window.ENV.NO_SENTRY = true; window.ENV.NO_TRACK = true</script><script>if (ENV.IS_MO) {
|
||||
document.title = 'Mockitt';
|
||||
document.documentElement.classList.add('wonder-share');
|
||||
document.getElementById('icon').href = '/mb-static/2509/favicon-mo.ico';
|
||||
document.getElementById('apple-touch-icon').href = '/mb-static/2509/favicon-mo.ico';
|
||||
}</script><script>window.dataLayer = window.dataLayer || [];
|
||||
function gtag() { dataLayer.push(arguments) };
|
||||
ENV.IS_MO && gtag('js', new Date());
|
||||
ENV.IS_MO && gtag('config', 'UA-4839360-64');
|
||||
ENV.IS_MO && document.write('<script async src="https://www.googletagmanager.com/gtag/js?id=UA-4839360-64"><'+'/script>')</script><script>window.dataLayer = window.dataLayer || [];
|
||||
function gtag() { dataLayer.push(arguments) };
|
||||
ENV.IS_MO && gtag('js', new Date());
|
||||
ENV.IS_MO && gtag('config', 'G-24WTSJBD5B');
|
||||
ENV.IS_MO && document.write('<script async src="https://www.googletagmanager.com/gtag/js?id=G-24WTSJBD5B"><'+'/script>')</script><script src="mb-static/2308/core-js-3.32.1/modern.js"></script><script>ENV.NO_TRACK || document.write('<script src="mb-static/2502/sa-1.26.18/_.js"><'+'/script>')</script><script defer="defer" src="mb-proto2/6.3688a-vendor-0d07687f4be09b8b3eca.js"></script><script defer="defer" src="mb-proto2/5.fxqum-vendor-f8aaf1fb2db7ed4b19df.js"></script><script defer="defer" src="mb-proto2/5.7b24m-vendor-c6215ade32c4d6e04f4c.js"></script><script defer="defer" src="mb-proto2/4.ekpaa-vendor-4a8c0d8af0989de4a89f.js"></script><script defer="defer" src="mb-proto2/4.n9fxu-vendor-121f3fbb2320541a30bc.js"></script><script defer="defer" src="mb-proto2/3.h4vam-vendor-5567a1235ac230e00561.js"></script><script defer="defer" src="mb-proto2/preview-html-zip-40b1c65b44de21c4ab8a.js"></script><link href="mb-proto2/6.3688a-vendor-16f3ece222913e7058d1.css" rel="stylesheet"><link href="mb-proto2/preview-html-zip-f0d9de76208db26b1137.css" rel="stylesheet"><script>function loadGTM() {
|
||||
if (ENV.NO_TRACK) {
|
||||
return
|
||||
}
|
||||
|
||||
(function (w, d, s, l, i) {
|
||||
w[l] = w[l] || [];
|
||||
w[l].push({
|
||||
'gtm.start': new Date().getTime(),
|
||||
event: 'gtm.js',
|
||||
});
|
||||
var f = d.getElementsByTagName(s)[0],
|
||||
j = d.createElement(s),
|
||||
dl = l !== 'dataLayer' ? '&l=' + l : '';
|
||||
j.async = true;
|
||||
j.src = 'https://www.googletagmanager.com/gtm.js?id=' + i + dl;
|
||||
f.parentNode.insertBefore(j, f);
|
||||
})(window, document, 'script', 'dataLayer', 'GTM-TZJK297T');
|
||||
}
|
||||
loadGTM()</script></head><body><div id="workspace"></div><script>HZv5_PREVIEW_MODE="device"</script>
|
||||
<script src="extra/data.0.js"></script>
|
||||
<script src="extra/data.2.js"></script>
|
||||
<script src="extra/data.1.js"></script>
|
||||
</body></html>
|
||||
File diff suppressed because one or more lines are too long
File diff suppressed because one or more lines are too long
File diff suppressed because one or more lines are too long
File diff suppressed because one or more lines are too long
File diff suppressed because one or more lines are too long
File diff suppressed because one or more lines are too long
File diff suppressed because it is too large
Load Diff
Binary file not shown.
|
Before Width: | Height: | Size: 44 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 56 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 56 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 53 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 52 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 29 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 30 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 14 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 53 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 36 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 139 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 88 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 34 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 104 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 143 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 379 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 129 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 112 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 38 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 19 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 35 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 52 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 62 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 39 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 34 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 45 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 43 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 49 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 100 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 123 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 88 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 118 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 351 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 103 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 361 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 60 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 36 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 34 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 43 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 9.3 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 49 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 375 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 665 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 12 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 19 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 10 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 34 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 81 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 19 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 48 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 194 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 146 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 67 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 74 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 88 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 43 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 63 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 42 KiB |
Some files were not shown because too many files have changed in this diff Show More
Reference in New Issue
Block a user