Compare commits
16 Commits
worktree-l
...
1af2677c05
| Author | SHA1 | Date | |
|---|---|---|---|
| 1af2677c05 | |||
| cca2e620b5 | |||
| e0ce344d09 | |||
| 85d4289ba7 | |||
| 4e55105c9e | |||
| 36698468f4 | |||
| 7084b3ee6a | |||
| b20abce3d4 | |||
| fe0eb8eca2 | |||
| 74c69956f9 | |||
| 5ccb68a98b | |||
| 1a944c2ba6 | |||
| dc8f1be4c3 | |||
| bc2959b93c | |||
| 72e2539134 | |||
| 16dc95de06 |
@@ -44,7 +44,32 @@
|
|||||||
"Bash(git rm:*)",
|
"Bash(git rm:*)",
|
||||||
"Bash(git add:*)",
|
"Bash(git add:*)",
|
||||||
"Skill(document-skills:frontend-design)",
|
"Skill(document-skills:frontend-design)",
|
||||||
"Bash(test:*)"
|
"Bash(test:*)",
|
||||||
|
"mcp__chrome-devtools__list_pages",
|
||||||
|
"mcp__chrome-devtools__navigate_page",
|
||||||
|
"mcp__chrome-devtools__take_snapshot",
|
||||||
|
"mcp__chrome-devtools__take_screenshot",
|
||||||
|
"mcp__zai-mcp-server__ui_to_artifact",
|
||||||
|
"mcp__chrome-devtools__click",
|
||||||
|
"Skill(backend-restart)",
|
||||||
|
"Bash(tasklist:*)",
|
||||||
|
"Bash(wmic:*)",
|
||||||
|
"Bash(mvn spring-boot:run:*)",
|
||||||
|
"Bash(timeout:*)",
|
||||||
|
"mcp__chrome-devtools__wait_for",
|
||||||
|
"Bash(start cmd /k \"mvn spring-boot:run -pl ruoyi-admin\")",
|
||||||
|
"mcp__mysql__list_tables",
|
||||||
|
"mcp__mysql__describe_table",
|
||||||
|
"mcp__mysql__query",
|
||||||
|
"Bash(grep:*)",
|
||||||
|
"mcp__mysql__connect_db",
|
||||||
|
"Skill(superpowers:writing-plans)",
|
||||||
|
"Skill(superpowers:subagent-driven-development)",
|
||||||
|
"Bash(chmod:*)",
|
||||||
|
"Bash(ls:*)",
|
||||||
|
"Bash(test_report.sh \")",
|
||||||
|
"mcp__mysql__show_statement",
|
||||||
|
"Bash(if not exist \"doc\\\\designs\" mkdir docdesigns)"
|
||||||
]
|
]
|
||||||
},
|
},
|
||||||
"enabledMcpjsonServers": [
|
"enabledMcpjsonServers": [
|
||||||
|
|||||||
@@ -4,6 +4,7 @@
|
|||||||
- 在进行需求分析与分解任务时，按照不同的模块分为不同的文件，创建模块名的文件夹并将对应文件保存在文件夹中，然后对模块的功能文件进行继续分解
|
- 在进行需求分析与分解任务时，按照不同的模块分为不同的文件，创建模块名的文件夹并将对应文件保存在文件夹中，然后对模块的功能文件进行继续分解
|
||||||
- 在使用/openspec:proposal时，自动开启深度思考模式，输入 “think more”、“think a lot”、“think harder” 或 “think longer” 触发更深层的思考
|
- 在使用/openspec:proposal时，自动开启深度思考模式，输入 “think more”、“think a lot”、“think harder” 或 “think longer” 触发更深层的思考
|
||||||
- 在执行/openspec:apply后，使用code-simplifier 进行代码精简
|
- 在执行/openspec:apply后，使用code-simplifier 进行代码精简
|
||||||
|
- 在分析生成需求文档时，每次都需要在doc目录下新建文件夹并以需求内容为命名
|
||||||
|
|
||||||
## Communication
|
## Communication
|
||||||
- 永远使用简体中文进行思考和对话
|
- 永远使用简体中文进行思考和对话
|
||||||
|
|||||||
273
doc/README-中介黑名单测试部署.md
Normal file
273
doc/README-中介黑名单测试部署.md
Normal file
@@ -0,0 +1,273 @@
|
|||||||
|
# 中介黑名单管理模块 - 测试与部署文档
|
||||||
|
|
||||||
|
## 文件说明
|
||||||
|
|
||||||
|
本目录包含中介黑名单管理模块(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
|
||||||
610
doc/api/中介黑名单管理API文档-v2.0.md
Normal file
610
doc/api/中介黑名单管理API文档-v2.0.md
Normal file
@@ -0,0 +1,610 @@
|
|||||||
|
# 中介黑名单管理 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`
|
||||||
|
|
||||||
|
### 查询功能增强
|
||||||
|
- 支持按中介类型查询
|
||||||
|
- 支持按姓名/机构名称模糊查询
|
||||||
|
- 支持按证件号/统一社会信用代码精确查询
|
||||||
532
doc/designs/2026-02-04-intermediary-blacklist-design.md
Normal file
532
doc/designs/2026-02-04-intermediary-blacklist-design.md
Normal file
@@ -0,0 +1,532 @@
|
|||||||
|
# 中介黑名单管理模块 - 系统设计文档
|
||||||
|
|
||||||
|
## 文档信息
|
||||||
|
|
||||||
|
- **版本**: v1.0
|
||||||
|
- **日期**: 2026-02-04
|
||||||
|
- **作者**: Claude
|
||||||
|
- **项目**: 纪检初核系统 (CCDI)
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 1. 概述
|
||||||
|
|
||||||
|
### 1.1 功能简介
|
||||||
|
|
||||||
|
中介黑名单管理模块提供个人中介和实体中介两类中介信息的完整管理功能，包括：
|
||||||
|
- 个人中介的增删改查
|
||||||
|
- 实体中介的增删改查
|
||||||
|
- 统一列表查询（支持联合查询和个人/实体分类查询）
|
||||||
|
- 带字典下拉框的Excel导入模板下载
|
||||||
|
- 批量数据导入
|
||||||
|
|
||||||
|
### 1.2 核心特性
|
||||||
|
|
||||||
|
1. **双表存储**: 个人中介和实体中介分别存储在不同的数据表中
|
||||||
|
2. **统一查询**: 使用SQL UNION实现高效的联合查询和分页
|
||||||
|
3. **类型区分**: 通过`intermediary_type`字段区分个人(1)和实体(2)中介
|
||||||
|
4. **智能筛选**: 实体中介通过`risk_level='1'`(高风险) AND `ent_source='INTERMEDIARY'(中介)`筛选
|
||||||
|
5. **唯一性保证**: 个人中介的证件号`person_id`作为业务唯一键
|
||||||
|
|
||||||
|
### 1.3 技术栈
|
||||||
|
|
||||||
|
- **后端框架**: Spring Boot 3.5.8
|
||||||
|
- **ORM框架**: MyBatis Plus 3.5.10
|
||||||
|
- **Excel处理**: EasyExcel (带字典下拉框)
|
||||||
|
- **数据库**: MySQL 8.2.0
|
||||||
|
- **API文档**: SpringDoc 2.8.14
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 2. 数据库设计
|
||||||
|
|
||||||
|
### 2.1 个人中介表 (ccdi_biz_intermediary)
|
||||||
|
|
||||||
|
| 字段名 | 类型 | 可空 | 主键 | 注释 |
|
||||||
|
|--------|------|------|------|------|
|
||||||
|
| biz_id | VARCHAR | 否 | 是 | 人员ID |
|
||||||
|
| person_type | VARCHAR | 否 | 否 | 人员类型（中介、职业背债人等） |
|
||||||
|
| person_sub_type | VARCHAR | 是 | 否 | 人员子类型 |
|
||||||
|
| relation_type | VARCHAR | 是 | 否 | 关系类型（配偶、子女、父母等） |
|
||||||
|
| name | VARCHAR | 否 | 否 | 姓名 |
|
||||||
|
| gender | CHAR | 是 | 否 | 性别 |
|
||||||
|
| id_type | VARCHAR | 否 | 否 | 证件类型（默认身份证） |
|
||||||
|
| person_id | VARCHAR | 否 | 否 | **证件号码（业务唯一键）** |
|
||||||
|
| mobile | VARCHAR | 是 | 否 | 手机号码 |
|
||||||
|
| wechat_no | VARCHAR | 是 | 否 | 微信号 |
|
||||||
|
| contact_address | VARCHAR | 是 | 否 | 联系地址 |
|
||||||
|
| company | VARCHAR | 是 | 否 | 所在公司 |
|
||||||
|
| social_credit_code | VARCHAR | 是 | 否 | 企业统一信用码 |
|
||||||
|
| position | VARCHAR | 是 | 否 | 职位 |
|
||||||
|
| related_num_id | VARCHAR | 是 | 否 | 关联人员ID |
|
||||||
|
| relation_type | VARCHAR | 是 | 否 | 关联关系 |
|
||||||
|
| data_source | VARCHAR | 是 | 否 | 数据来源（MANUAL/SYSTEM/IMPORT/API） |
|
||||||
|
| remark | VARCHAR | 是 | 否 | 备注信息 |
|
||||||
|
| created_by | VARCHAR | 否 | 否 | 记录创建人 |
|
||||||
|
| updated_by | VARCHAR | 是 | 否 | 记录更新人 |
|
||||||
|
| create_time | DATETIME | 否 | 否 | 记录创建时间 |
|
||||||
|
| update_time | DATETIME | 是 | 否 | 记录更新时间 |
|
||||||
|
|
||||||
|
**索引设计**:
|
||||||
|
- PRIMARY KEY: `biz_id`
|
||||||
|
- UNIQUE KEY: `uk_person_id` (`person_id`)
|
||||||
|
|
||||||
|
### 2.2 实体中介表 (ccdi_enterprise_base_info)
|
||||||
|
|
||||||
|
| 字段名 | 类型 | 可空 | 主键 | 注释 |
|
||||||
|
|--------|------|------|------|------|
|
||||||
|
| social_credit_code | VARCHAR | 否 | 是 | **统一社会信用代码（主键）** |
|
||||||
|
| enterprise_name | VARCHAR | 否 | 否 | 企业名称 |
|
||||||
|
| enterprise_type | VARCHAR | 否 | 否 | 企业类型（有限责任公司、股份有限公司等） |
|
||||||
|
| enterprise_nature | VARCHAR | 是 | 否 | 企业性质（国企、民企、外企等） |
|
||||||
|
| industry_class | VARCHAR | 是 | 否 | 行业分类 |
|
||||||
|
| industry_name | VARCHAR | 是 | 否 | 所属行业 |
|
||||||
|
| establish_date | DATE | 是 | 否 | 成立日期 |
|
||||||
|
| register_address | VARCHAR | 是 | 否 | 注册地址 |
|
||||||
|
| legal_representative | VARCHAR | 是 | 否 | 法定代表人 |
|
||||||
|
| legal_cert_type | VARCHAR | 是 | 否 | 法定代表人证件类型 |
|
||||||
|
| legal_cert_no | VARCHAR | 是 | 否 | 法定代表人证件号码 |
|
||||||
|
| shareholder1-5 | VARCHAR | 是 | 否 | 股东信息 |
|
||||||
|
| status | VARCHAR | 是 | 否 | 经营状态 |
|
||||||
|
| create_time | DATETIME | 否 | 否 | 创建时间 |
|
||||||
|
| update_time | DATETIME | 否 | 否 | 更新时间 |
|
||||||
|
| created_by | VARCHAR | 否 | 否 | 创建人 |
|
||||||
|
| updated_by | VARCHAR | 是 | 否 | 更新人 |
|
||||||
|
| data_source | VARCHAR | 是 | 否 | 数据来源（MANUAL/SYSTEM/API/IMPORT） |
|
||||||
|
| **risk_level** | VARCHAR(10) | 是 | 否 | **风险等级：1-高风险, 2-中风险, 3-低风险** |
|
||||||
|
| **ent_source** | VARCHAR(20) | 否 | 否 | **企业来源：GENERAL/EMP_RELATION/CREDIT_CUSTOMER/INTERMEDIARY/BOTH** |
|
||||||
|
|
||||||
|
**索引设计**:
|
||||||
|
- PRIMARY KEY: `social_credit_code`
|
||||||
|
- INDEX: `idx_risk_ent_source` (`risk_level`, `ent_source`)
|
||||||
|
|
||||||
|
**实体中介筛选条件**:
|
||||||
|
- `risk_level = '1'` (高风险)
|
||||||
|
- `ent_source = 'INTERMEDIARY'` (中介)
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 3. 架构设计
|
||||||
|
|
||||||
|
### 3.1 整体架构
|
||||||
|
|
||||||
|
```
|
||||||
|
Controller Layer (CcdiIntermediaryController)
|
||||||
|
↓
|
||||||
|
Service Layer (ICcdiIntermediaryService)
|
||||||
|
↓
|
||||||
|
Mapper Layer (CcdiBizIntermediaryMapper, CcdiEnterpriseBaseInfoMapper)
|
||||||
|
↓
|
||||||
|
Database (ccdi_biz_intermediary, ccdi_enterprise_base_info)
|
||||||
|
```
|
||||||
|
|
||||||
|
### 3.2 分层说明
|
||||||
|
|
||||||
|
**Controller层**:
|
||||||
|
- 统一的Controller处理个人和实体中介的请求
|
||||||
|
- 使用不同的路径区分个人和实体中介操作
|
||||||
|
- 权限控制: `ccdi:intermediary:*`
|
||||||
|
|
||||||
|
**Service层**:
|
||||||
|
- 统一的服务接口
|
||||||
|
- 根据中介类型路由到不同的业务逻辑
|
||||||
|
- 处理唯一性校验、数据自动填充等业务规则
|
||||||
|
|
||||||
|
**Mapper层**:
|
||||||
|
- 每个表对应独立的Mapper接口
|
||||||
|
- 继承MyBatis Plus的BaseMapper
|
||||||
|
- 自定义XML实现UNION联合查询
|
||||||
|
|
||||||
|
**DTO/VO层**:
|
||||||
|
- 严格分离，不与Entity混用
|
||||||
|
- DTO用于接口参数接收
|
||||||
|
- VO用于数据返回
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 4. 接口设计
|
||||||
|
|
||||||
|
### 4.1 基础信息
|
||||||
|
|
||||||
|
- **基础路径**: `/ccdi/intermediary`
|
||||||
|
- **权限前缀**: `ccdi:intermediary`
|
||||||
|
- **响应格式**: AjaxResult
|
||||||
|
|
||||||
|
### 4.2 统一列表查询
|
||||||
|
|
||||||
|
**接口**: `GET /ccdi/intermediary/list`
|
||||||
|
|
||||||
|
**权限**: `ccdi:intermediary:list`
|
||||||
|
|
||||||
|
**请求参数**:
|
||||||
|
| 参数名 | 类型 | 必填 | 说明 |
|
||||||
|
|--------|------|------|------|
|
||||||
|
| name | String | 否 | 姓名/机构名称（模糊查询） |
|
||||||
|
| certificateNo | String | 否 | 证件号/统一社会信用代码（精确查询） |
|
||||||
|
| intermediaryType | String | 否 | 中介类型（1=个人, 2=实体, null=全部） |
|
||||||
|
| pageNum | Integer | 否 | 页码（默认1） |
|
||||||
|
| pageSize | Integer | 否 | 每页数量（默认10） |
|
||||||
|
|
||||||
|
**响应**: TableDataInfo (分页结果)
|
||||||
|
|
||||||
|
**实现**: SQL UNION联合查询，支持按类型筛选优化
|
||||||
|
|
||||||
|
### 4.3 个人中介接口
|
||||||
|
|
||||||
|
#### 4.3.1 新增个人中介
|
||||||
|
**接口**: `POST /ccdi/intermediary/person`
|
||||||
|
**权限**: `ccdi:intermediary:add`
|
||||||
|
**请求体**: CcdiIntermediaryPersonAddDTO
|
||||||
|
**业务逻辑**:
|
||||||
|
- 校验姓名必填
|
||||||
|
- 校验证件号必填且唯一
|
||||||
|
- 自动设置data_source='MANUAL'
|
||||||
|
- 自动设置person_type='中介'
|
||||||
|
|
||||||
|
#### 4.3.2 修改个人中介
|
||||||
|
**接口**: `PUT /ccdi/intermediary/person`
|
||||||
|
**权限**: `ccdi:intermediary:edit`
|
||||||
|
**请求体**: CcdiIntermediaryPersonEditDTO
|
||||||
|
**业务逻辑**:
|
||||||
|
- biz_id不可修改
|
||||||
|
- 证件号修改时需校验唯一性（排除自身）
|
||||||
|
|
||||||
|
#### 4.3.3 查询个人中介详情
|
||||||
|
**接口**: `GET /ccdi/intermediary/person/{bizId}`
|
||||||
|
**权限**: `ccdi:intermediary:query`
|
||||||
|
**响应**: CcdiIntermediaryPersonDetailVO
|
||||||
|
|
||||||
|
### 4.4 实体中介接口
|
||||||
|
|
||||||
|
#### 4.4.1 新增实体中介
|
||||||
|
**接口**: `POST /ccdi/intermediary/entity`
|
||||||
|
**权限**: `ccdi:intermediary:add`
|
||||||
|
**请求体**: CcdiIntermediaryEntityAddDTO
|
||||||
|
**业务逻辑**:
|
||||||
|
- 校验企业名称必填
|
||||||
|
- 校验统一社会信用代码唯一
|
||||||
|
- 自动设置risk_level='1'(高风险)
|
||||||
|
- 自动设置ent_source='INTERMEDIARY'(中介)
|
||||||
|
- 自动设置data_source='MANUAL'
|
||||||
|
|
||||||
|
#### 4.4.2 修改实体中介
|
||||||
|
**接口**: `PUT /ccdi/intermediary/entity`
|
||||||
|
**权限**: `ccdi:intermediary:edit`
|
||||||
|
**请求体**: CcdiIntermediaryEntityEditDTO
|
||||||
|
**业务逻辑**:
|
||||||
|
- social_credit_code不可修改
|
||||||
|
- 企业名称修改时需校验唯一性（排除自身）
|
||||||
|
|
||||||
|
#### 4.4.3 查询实体中介详情
|
||||||
|
**接口**: `GET /ccdi/intermediary/entity/{socialCreditCode}`
|
||||||
|
**权限**: `ccdi:intermediary:query`
|
||||||
|
**响应**: CcdiIntermediaryEntityDetailVO
|
||||||
|
|
||||||
|
### 4.5 删除接口
|
||||||
|
|
||||||
|
**接口**: `DELETE /ccdi/intermediary/{ids}`
|
||||||
|
**权限**: `ccdi:intermediary:remove`
|
||||||
|
**路径参数**: ids (支持个人和实体的ID，逗号分隔)
|
||||||
|
|
||||||
|
### 4.6 导入导出接口
|
||||||
|
|
||||||
|
#### 4.6.1 个人中介模板下载
|
||||||
|
**接口**: `POST /ccdi/intermediary/importPersonTemplate`
|
||||||
|
**权限**: 无需登录
|
||||||
|
**功能**: 下载带字典下拉框的Excel模板
|
||||||
|
**下拉字段**:
|
||||||
|
- 性别: `ccdi_indiv_gender`
|
||||||
|
- 证件类型: `ccdi_certificate_type`
|
||||||
|
- 关联关系: `ccdi_relation_type`
|
||||||
|
|
||||||
|
#### 4.6.2 实体中介模板下载
|
||||||
|
**接口**: `POST /ccdi/intermediary/importEntityTemplate`
|
||||||
|
**权限**: 无需登录
|
||||||
|
**功能**: 下载带字典下拉框的Excel模板
|
||||||
|
**下拉字段**:
|
||||||
|
- 主体类型: `ccdi_entity_type`
|
||||||
|
- 企业性质: `ccdi_enterprise_nature`
|
||||||
|
- 法人证件类型: `ccdi_certificate_type`
|
||||||
|
|
||||||
|
#### 4.6.3 个人中介数据导入
|
||||||
|
**接口**: `POST /ccdi/intermediary/importPersonData`
|
||||||
|
**权限**: `ccdi:intermediary:import`
|
||||||
|
**参数**:
|
||||||
|
- file: MultipartFile
|
||||||
|
- updateSupport: Boolean (是否更新已存在数据)
|
||||||
|
**Excel类**: CcdiIntermediaryPersonExcel
|
||||||
|
**业务逻辑**:
|
||||||
|
- 解析Excel数据
|
||||||
|
- 校验姓名必填、证件号必填
|
||||||
|
- 检查person_id唯一性
|
||||||
|
- 批量插入ccdi_biz_intermediary表
|
||||||
|
- 自动设置: data_source='IMPORT', person_type='中介'
|
||||||
|
|
||||||
|
#### 4.6.4 实体中介数据导入
|
||||||
|
**接口**: `POST /ccdi/intermediary/importEntityData`
|
||||||
|
**权限**: `ccdi:intermediary:import`
|
||||||
|
**参数**:
|
||||||
|
- file: MultipartFile
|
||||||
|
- updateSupport: Boolean (是否更新已存在数据)
|
||||||
|
**Excel类**: CcdiIntermediaryEntityExcel
|
||||||
|
**业务逻辑**:
|
||||||
|
- 解析Excel数据
|
||||||
|
- 校验企业名称必填
|
||||||
|
- 检查social_credit_code唯一性
|
||||||
|
- 批量插入ccdi_enterprise_base_info表
|
||||||
|
- 自动设置: risk_level='1', ent_source='INTERMEDIARY', data_source='IMPORT'
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 5. UNION联合查询实现
|
||||||
|
|
||||||
|
### 5.1 SQL查询语句
|
||||||
|
|
||||||
|
```xml
|
||||||
|
<select id="selectIntermediaryList" resultType="CcdiIntermediaryVO">
|
||||||
|
<!-- 查询个人中介 -->
|
||||||
|
SELECT
|
||||||
|
biz_id as id,
|
||||||
|
name,
|
||||||
|
person_id as certificate_no,
|
||||||
|
'1' as intermediary_type,
|
||||||
|
person_type,
|
||||||
|
gender,
|
||||||
|
id_type,
|
||||||
|
mobile,
|
||||||
|
company,
|
||||||
|
data_source,
|
||||||
|
create_time
|
||||||
|
FROM ccdi_biz_intermediary
|
||||||
|
WHERE person_type = '中介'
|
||||||
|
<if test="intermediaryType == null or intermediaryType == '1'">
|
||||||
|
AND name LIKE CONCAT('%', #{name}, '%')
|
||||||
|
<if test="certificateNo != null and certificateNo != ''">
|
||||||
|
AND person_id = #{certificateNo}
|
||||||
|
</if>
|
||||||
|
</if>
|
||||||
|
|
||||||
|
UNION ALL
|
||||||
|
|
||||||
|
<!-- 查询实体中介 -->
|
||||||
|
SELECT
|
||||||
|
social_credit_code as id,
|
||||||
|
enterprise_name as name,
|
||||||
|
social_credit_code as certificate_no,
|
||||||
|
'2' as intermediary_type,
|
||||||
|
'实体' as person_type,
|
||||||
|
null as gender,
|
||||||
|
null as id_type,
|
||||||
|
null as mobile,
|
||||||
|
enterprise_name as company,
|
||||||
|
data_source,
|
||||||
|
create_time
|
||||||
|
FROM ccdi_enterprise_base_info
|
||||||
|
WHERE risk_level = '1' AND ent_source = 'INTERMEDIARY'
|
||||||
|
<if test="intermediaryType == null or intermediaryType == '2'">
|
||||||
|
AND enterprise_name LIKE CONCAT('%', #{name}, '%')
|
||||||
|
<if test="certificateNo != null and certificateNo != ''">
|
||||||
|
AND social_credit_code = #{certificateNo}
|
||||||
|
</if>
|
||||||
|
</if>
|
||||||
|
|
||||||
|
ORDER BY create_time DESC
|
||||||
|
</select>
|
||||||
|
```
|
||||||
|
|
||||||
|
### 5.2 分页实现
|
||||||
|
|
||||||
|
- 使用MyBatis Plus的Page对象进行分页
|
||||||
|
- 在Service层调用`page(intermediaryQueryDTO, Page)`方法
|
||||||
|
- 自动处理total和rows
|
||||||
|
|
||||||
|
### 5.3 查询优化
|
||||||
|
|
||||||
|
- 根据intermediaryType参数优化查询，如果指定类型则只查询对应表
|
||||||
|
- 添加索引优化查询性能
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 6. 数据对象设计
|
||||||
|
|
||||||
|
### 6.1 Entity实体类
|
||||||
|
|
||||||
|
**CcdiBizIntermediary**:
|
||||||
|
- 使用`@Data`注解
|
||||||
|
- 不继承BaseEntity
|
||||||
|
- 单独添加审计字段
|
||||||
|
- 主键: biz_id (String)
|
||||||
|
|
||||||
|
**CcdiEnterpriseBaseInfo**:
|
||||||
|
- 使用`@Data`注解
|
||||||
|
- 不继承BaseEntity
|
||||||
|
- 单独添加审计字段
|
||||||
|
- 主键: social_credit_code (String)
|
||||||
|
|
||||||
|
### 6.2 DTO数据传输对象
|
||||||
|
|
||||||
|
**CcdiIntermediaryPersonAddDTO**: 个人中介新增DTO
|
||||||
|
- 包含所有个人字段
|
||||||
|
- 使用JSR-303校验注解
|
||||||
|
|
||||||
|
**CcdiIntermediaryPersonEditDTO**: 个人中介修改DTO
|
||||||
|
- 包含biz_id和可编辑字段
|
||||||
|
- biz_id不可为空
|
||||||
|
|
||||||
|
**CcdiIntermediaryEntityAddDTO**: 实体中介新增DTO
|
||||||
|
- 包含所有企业字段
|
||||||
|
- 使用JSR-303校验注解
|
||||||
|
|
||||||
|
**CcdiIntermediaryEntityEditDTO**: 实体中介修改DTO
|
||||||
|
- 包含social_credit_code和可编辑字段
|
||||||
|
- social_credit_code不可为空
|
||||||
|
|
||||||
|
**CcdiIntermediaryQueryDTO**: 统一查询DTO
|
||||||
|
- 支持: name, certificateNo, intermediaryType筛选
|
||||||
|
|
||||||
|
### 6.3 VO视图对象
|
||||||
|
|
||||||
|
**CcdiIntermediaryVO**: 统一列表VO
|
||||||
|
- 包含intermediary_type字段区分类型(1=个人, 2=实体)
|
||||||
|
- 统一字段: id, name, certificate_no, intermediary_type, company, create_time等
|
||||||
|
|
||||||
|
**CcdiIntermediaryPersonDetailVO**: 个人中介详情VO
|
||||||
|
- 包含个人中介的所有详细信息
|
||||||
|
|
||||||
|
**CcdiIntermediaryEntityDetailVO**: 实体中介详情VO
|
||||||
|
- 包含实体中介的所有详细信息
|
||||||
|
|
||||||
|
### 6.4 Excel导入导出类
|
||||||
|
|
||||||
|
**CcdiIntermediaryPersonExcel**: 个人中介Excel类
|
||||||
|
- 使用EasyExcel注解
|
||||||
|
- 字段校验和格式化
|
||||||
|
|
||||||
|
**CcdiIntermediaryEntityExcel**: 实体中介Excel类
|
||||||
|
- 使用EasyExcel注解
|
||||||
|
- 字段校验和格式化
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 7. 业务规则
|
||||||
|
|
||||||
|
### 7.1 唯一性约束
|
||||||
|
|
||||||
|
1. **个人中介**:
|
||||||
|
- `person_id`(证件号)必须唯一
|
||||||
|
- 新增时检查是否已存在
|
||||||
|
- 修改时检查是否已存在（排除自身）
|
||||||
|
|
||||||
|
2. **实体中介**:
|
||||||
|
- `social_credit_code`(统一社会信用代码)必须唯一
|
||||||
|
- 新增时检查是否已存在
|
||||||
|
- 修改时检查是否已存在（排除自身）
|
||||||
|
|
||||||
|
### 7.2 数据自动填充
|
||||||
|
|
||||||
|
**个人中介**:
|
||||||
|
- data_source: MANUAL(手动录入) / IMPORT(批量导入)
|
||||||
|
- person_type: 中介
|
||||||
|
|
||||||
|
**实体中介**:
|
||||||
|
- risk_level: 1 (高风险)
|
||||||
|
- ent_source: INTERMEDIARY (中介)
|
||||||
|
- data_source: MANUAL(手动录入) / IMPORT(批量导入)
|
||||||
|
|
||||||
|
### 7.3 字典类型
|
||||||
|
|
||||||
|
| 字典类型 | 用途 |
|
||||||
|
|---------|------|
|
||||||
|
| ccdi_indiv_gender | 个人中介性别 |
|
||||||
|
| ccdi_certificate_type | 证件类型 |
|
||||||
|
| ccdi_relation_type | 关联关系 |
|
||||||
|
| ccdi_entity_type | 主体类型 |
|
||||||
|
| ccdi_enterprise_nature | 企业性质 |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 8. 错误处理
|
||||||
|
|
||||||
|
### 8.1 业务错误码
|
||||||
|
|
||||||
|
| 错误码 | 说明 |
|
||||||
|
|--------|------|
|
||||||
|
| 1001 | 证件号已存在 |
|
||||||
|
| 1002 | 统一社会信用代码已存在 |
|
||||||
|
| 1003 | 数据不存在 |
|
||||||
|
| 1004 | 姓名不能为空 |
|
||||||
|
| 1005 | 证件号不能为空 |
|
||||||
|
| 1006 | 企业名称不能为空 |
|
||||||
|
|
||||||
|
### 8.2 异常处理策略
|
||||||
|
|
||||||
|
- 使用`@ControllerAdvice`全局异常处理
|
||||||
|
- 业务异常使用自定义BizException
|
||||||
|
- 参数校验异常自动返回字段错误信息
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 9. 测试策略
|
||||||
|
|
||||||
|
### 9.1 单元测试
|
||||||
|
|
||||||
|
- Service层业务逻辑测试
|
||||||
|
- Mapper层SQL查询测试
|
||||||
|
- 唯一性校验测试
|
||||||
|
|
||||||
|
### 9.2 集成测试
|
||||||
|
|
||||||
|
- Controller接口测试
|
||||||
|
- 导入导出功能测试
|
||||||
|
- 联合查询分页测试
|
||||||
|
|
||||||
|
### 9.3 测试脚本
|
||||||
|
|
||||||
|
- 生成可执行的HTTP测试脚本
|
||||||
|
- 使用admin/admin123账号获取token
|
||||||
|
- 保存测试结果并生成测试报告
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 10. 实现计划
|
||||||
|
|
||||||
|
### 10.1 开发顺序
|
||||||
|
|
||||||
|
1. 创建Entity实体类
|
||||||
|
2. 创建Mapper接口和XML
|
||||||
|
3. 创建DTO/VO对象
|
||||||
|
4. 实现Service层业务逻辑
|
||||||
|
5. 实现Controller层接口
|
||||||
|
6. 实现Excel导入导出功能
|
||||||
|
7. 编写测试用例
|
||||||
|
8. 生成API文档
|
||||||
|
|
||||||
|
### 10.2 技术要点
|
||||||
|
|
||||||
|
- 使用MyBatis Plus的BaseMapper简化CRUD操作
|
||||||
|
- 使用@Resource注入，替代@Autowired
|
||||||
|
- 实体类不继承BaseEntity，单独添加审计字段
|
||||||
|
- 简单CRUD使用MyBatis Plus方法，复杂查询使用XML
|
||||||
|
- 所有Controller接口添加完整的Swagger注解
|
||||||
|
- 使用@Validated和JSR-303进行参数校验
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 11. 附录
|
||||||
|
|
||||||
|
### 11.1 相关文档
|
||||||
|
|
||||||
|
- [中介黑名单管理API文档.md](../api/中介黑名单管理API文档.md)
|
||||||
|
- [中介黑名单后端.md](../docs/中介黑名单后端.md)
|
||||||
|
- [ccdi_biz_intermediary.csv](../docs/ccdi_biz_intermediary.csv)
|
||||||
|
- [ccdi_enterprise_base_info.csv](../docs/ccdi_enterprise_base_info.csv)
|
||||||
|
|
||||||
|
### 11.2 更新日志
|
||||||
|
|
||||||
|
| 版本 | 日期 | 说明 |
|
||||||
|
|------|------|------|
|
||||||
|
| 1.0 | 2026-02-04 | 初始版本，完成系统设计 |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
**文档结束**
|
||||||
24
doc/docs/ccdi_biz_intermediary.csv
Normal file
24
doc/docs/ccdi_biz_intermediary.csv
Normal file
@@ -0,0 +1,24 @@
|
|||||||
|
中介人员基本信息表：ccdi_biz_intermediary,,,,,,
|
||||||
|
序号,字段名,类型,默认值,是否可为空,是否主键,注释
|
||||||
|
1,biz_id,VARCHAR,-,否,是,人员ID
|
||||||
|
2,person_type,VARCHAR,-,否,否,人员类型，中介、职业背债人、房产中介等
|
||||||
|
3,person_sub_type,VARCHAR,-,是,否,人员子类型
|
||||||
|
4,relation_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,-,是,-,记录更新时间
|
||||||
|
26
doc/docs/ccdi_enterprise_base_info.csv
Normal file
26
doc/docs/ccdi_enterprise_base_info.csv
Normal file
@@ -0,0 +1,26 @@
|
|||||||
|
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
doc/docs/中介黑名单后端.md
Normal file
1
doc/docs/中介黑名单后端.md
Normal file
@@ -0,0 +1 @@
|
|||||||
|
实现中介黑名单管理的后端接口开发。中介分为个人中介和实体中介。个人中介的表字段为 @ccdi_biz_intermediary.csv。实体中介表字段为 @ccdi_enterprise_base_info.csv，风险等级为高风险，企业来源为中介。需要生成的接口：个人中介的新增、修改接口，以证件号为关联键；个人中介导入模板下载，个人中介文件上传导入新增；实体中介类的新增、修改接口；实体中介导入模板下载，上传导入新增；列表查询，要求联合查询两种类型的中介，也可以支持查询单种类的中介。
|
||||||
919
doc/frontend/上传数据页面UI设计文档.md
Normal file
919
doc/frontend/上传数据页面UI设计文档.md
Normal file
@@ -0,0 +1,919 @@
|
|||||||
|
# 上传数据页面 UI 设计文档
|
||||||
|
|
||||||
|
## 1. 页面概述
|
||||||
|
|
||||||
|
### 1.1 功能描述
|
||||||
|
上传数据页面是纪检初核系统中项目管理模块的核心页面，支持在一个项目中上传多个主体/账户数据进行汇总/独立分析。提供流水导入、征信导入、员工家庭关系导入、名单库选择等功能。
|
||||||
|
|
||||||
|
### 1.2 页面路径
|
||||||
|
- 菜单位置：项目管理 > 项目详情 > 上传数据
|
||||||
|
- 路由路径：`/project/:id/upload-data`
|
||||||
|
|
||||||
|
### 1.3 页面状态
|
||||||
|
- 项目状态：已完成
|
||||||
|
- 最后更新时间：2024-01-20 15:30
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 2. 页面布局
|
||||||
|
|
||||||
|
### 2.1 整体结构
|
||||||
|
```
|
||||||
|
┌─────────────────────────────────────────────────────────────┐
|
||||||
|
│ 面包屑导航：项目管理 / 项目详情 / 上传数据 │
|
||||||
|
├─────────────────────────────────────────────────────────────┤
|
||||||
|
│ 页面标题区 │
|
||||||
|
│ ┌───────────────────────────────────────────────────────┐ │
|
||||||
|
│ │ 上传数据 │ │
|
||||||
|
│ │ 项目状态：已完成 最后更新：2024-01-20 15:30 │ │
|
||||||
|
│ │ 支持在一个项目中上传多个主体/账户数据，进行汇总/独立分析 │ │
|
||||||
|
│ └───────────────────────────────────────────────────────┘ │
|
||||||
|
├─────────────────────────────────────────────────────────────┤
|
||||||
|
│ 主要内容区（网格布局） │
|
||||||
|
│ ┌─────────────────┐ ┌─────────────────┐ │
|
||||||
|
│ │ 流水导入 │ │ 已上传流水查询 │ │
|
||||||
|
│ │ [上传组件] │ │ [上传组件] │ │
|
||||||
|
│ └─────────────────┘ └─────────────────┘ │
|
||||||
|
│ ┌─────────────────┐ ┌─────────────────┐ │
|
||||||
|
│ │ 征信导入 │ │ 员工家庭关系导入 │ │
|
||||||
|
│ │ [上传组件] │ │ [上传组件] │ │
|
||||||
|
│ └─────────────────┘ └─────────────────┘ │
|
||||||
|
│ ┌─────────────────────────────────────────────┐ │
|
||||||
|
│ │ 名单库选择 │ │
|
||||||
|
│ │ ☑ 高风险人员名单(68人) ☑ 历史可疑人员名单 │ │
|
||||||
|
│ │ ☑ 监管关注名单(32人) │ │
|
||||||
|
│ └─────────────────────────────────────────────┘ │
|
||||||
|
├─────────────────────────────────────────────────────────────┤
|
||||||
|
│ 数据质量检查区 │
|
||||||
|
│ ┌────────────────────────────────────────────────────────┐ │
|
||||||
|
│ │ 数据完整性 格式一致性 余额连续性 │ │
|
||||||
|
│ │ 98.5% 95.2% 92.8% │ │
|
||||||
|
│ │ 检查结果： [查看详情] │ │
|
||||||
|
│ │ • 发现 23 条数据格式不一致 │ │
|
||||||
|
│ │ • 发现 5 条余额连续性异常 │ │
|
||||||
|
│ │ • 发现 12 条缺失关键字段 │ │
|
||||||
|
│ └────────────────────────────────────────────────────────┘ │
|
||||||
|
├─────────────────────────────────────────────────────────────┤
|
||||||
|
│ 操作按钮区 │
|
||||||
|
│ [拉取本行信息] [生成报告] │
|
||||||
|
└─────────────────────────────────────────────────────────────┘
|
||||||
|
```
|
||||||
|
|
||||||
|
### 2.2 响应式布局
|
||||||
|
- 桌面端（≥1200px）：4列网格布局
|
||||||
|
- 平板端（768px-1199px）：2列网格布局
|
||||||
|
- 移动端（<768px）：单列布局
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 3. 组件设计
|
||||||
|
|
||||||
|
### 3.1 FileUploadCard 上传卡片组件
|
||||||
|
|
||||||
|
**Props:**
|
||||||
|
```typescript
|
||||||
|
interface FileUploadCardProps {
|
||||||
|
title: string; // 卡片标题
|
||||||
|
description: string; // 描述文字
|
||||||
|
acceptTypes: string[]; // 接受的文件类型，如 ['xlsx', 'xls', 'pdf']
|
||||||
|
maxSize?: number; // 最大文件大小（MB），默认 10
|
||||||
|
multiple?: boolean; // 是否支持多文件上传
|
||||||
|
uploadUrl: string; // 上传接口地址
|
||||||
|
onUploadSuccess?: (files: UploadedFile[]) => void;
|
||||||
|
onUploadError?: (error: Error) => void;
|
||||||
|
showFileList?: boolean; // 是否显示已上传文件列表
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
**UI 结构：**
|
||||||
|
```vue
|
||||||
|
<template>
|
||||||
|
<el-card class="upload-card">
|
||||||
|
<template #header>
|
||||||
|
<div class="card-header">
|
||||||
|
<h3>{{ title }}</h3>
|
||||||
|
<el-tooltip :content="description" placement="top">
|
||||||
|
<i class="el-icon-info"></i>
|
||||||
|
</el-tooltip>
|
||||||
|
</div>
|
||||||
|
</template>
|
||||||
|
|
||||||
|
<el-upload
|
||||||
|
class="upload-area"
|
||||||
|
:action="uploadUrl"
|
||||||
|
:accept="acceptTypes.join(',')"
|
||||||
|
:multiple="multiple"
|
||||||
|
:limit="10"
|
||||||
|
:file-list="fileList"
|
||||||
|
:on-success="handleSuccess"
|
||||||
|
:on-error="handleError"
|
||||||
|
:before-upload="beforeUpload"
|
||||||
|
drag
|
||||||
|
>
|
||||||
|
<div class="upload-content">
|
||||||
|
<i class="el-icon-upload"></i>
|
||||||
|
<p>拖拽文件到此处或点击上传</p>
|
||||||
|
<p class="upload-tip">支持格式: {{ acceptTypes.join(', ') }}</p>
|
||||||
|
</div>
|
||||||
|
</el-upload>
|
||||||
|
|
||||||
|
<div v-if="showFileList && uploadedFiles.length" class="file-list">
|
||||||
|
<h4>已上传文件</h4>
|
||||||
|
<el-table :data="uploadedFiles" size="small">
|
||||||
|
<el-table-column prop="fileName" label="文件名" />
|
||||||
|
<el-table-column prop="fileSize" label="大小" width="100" />
|
||||||
|
<el-table-column prop="uploadTime" label="上传时间" width="160" />
|
||||||
|
<el-table-column prop="status" label="状态" width="80">
|
||||||
|
<template #default="{ row }">
|
||||||
|
<el-tag :type="row.status === 'success' ? 'success' : 'danger'">
|
||||||
|
{{ row.status === 'success' ? '成功' : '失败' }}
|
||||||
|
</el-tag>
|
||||||
|
</template>
|
||||||
|
</el-table-column>
|
||||||
|
<el-table-column label="操作" width="100" fixed="right">
|
||||||
|
<template #default="{ row }">
|
||||||
|
<el-button type="text" size="small" @click="handleDelete(row)">
|
||||||
|
删除
|
||||||
|
</el-button>
|
||||||
|
</template>
|
||||||
|
</el-table-column>
|
||||||
|
</el-table>
|
||||||
|
</div>
|
||||||
|
</el-card>
|
||||||
|
</template>
|
||||||
|
```
|
||||||
|
|
||||||
|
### 3.2 CheckboxGroupSelector 名单库选择组件
|
||||||
|
|
||||||
|
**Props:**
|
||||||
|
```typescript
|
||||||
|
interface CheckboxGroupSelectorProps {
|
||||||
|
options: NameListOption[];
|
||||||
|
modelValue: string[];
|
||||||
|
onChange: (value: string[]) => void;
|
||||||
|
}
|
||||||
|
|
||||||
|
interface NameListOption {
|
||||||
|
label: string; // 显示文本
|
||||||
|
value: string; // 选中值
|
||||||
|
count: number; // 人数统计
|
||||||
|
disabled?: boolean;
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
**UI 结构：**
|
||||||
|
```vue
|
||||||
|
<template>
|
||||||
|
<el-card class="name-list-selector">
|
||||||
|
<template #header>
|
||||||
|
<h3>名单库选择</h3>
|
||||||
|
</template>
|
||||||
|
<p class="selector-description">选择中介库管理内的名单</p>
|
||||||
|
<el-checkbox-group v-model="selectedLists" @change="handleChange">
|
||||||
|
<el-checkbox
|
||||||
|
v-for="option in options"
|
||||||
|
:key="option.value"
|
||||||
|
:label="option.value"
|
||||||
|
:disabled="option.disabled"
|
||||||
|
>
|
||||||
|
{{ option.label }}({{ option.count }}人)
|
||||||
|
</el-checkbox>
|
||||||
|
</el-checkbox-group>
|
||||||
|
</el-card>
|
||||||
|
</template>
|
||||||
|
```
|
||||||
|
|
||||||
|
### 3.3 DataQualityPanel 数据质量检查面板
|
||||||
|
|
||||||
|
**Props:**
|
||||||
|
```typescript
|
||||||
|
interface DataQualityPanelProps {
|
||||||
|
metrics: QualityMetric[];
|
||||||
|
issues: QualityIssue[];
|
||||||
|
onCheckQuality?: () => void;
|
||||||
|
onViewDetails?: (issue: QualityIssue) => void;
|
||||||
|
}
|
||||||
|
|
||||||
|
interface QualityMetric {
|
||||||
|
name: string; // 指标名称
|
||||||
|
value: number; // 百分比值
|
||||||
|
status: 'good' | 'warning' | 'error';
|
||||||
|
}
|
||||||
|
|
||||||
|
interface QualityIssue {
|
||||||
|
type: string; // 问题类型
|
||||||
|
count: number; // 数量
|
||||||
|
description: string;
|
||||||
|
details?: any[];
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
**UI 结构：**
|
||||||
|
```vue
|
||||||
|
<template>
|
||||||
|
<el-card class="quality-panel">
|
||||||
|
<template #header>
|
||||||
|
<div class="panel-header">
|
||||||
|
<h3>数据质量检查</h3>
|
||||||
|
<el-button type="primary" size="small" @click="handleCheck">
|
||||||
|
重新检查
|
||||||
|
</el-button>
|
||||||
|
</div>
|
||||||
|
</template>
|
||||||
|
|
||||||
|
<!-- 质量指标 -->
|
||||||
|
<div class="metrics-container">
|
||||||
|
<div
|
||||||
|
v-for="metric in metrics"
|
||||||
|
:key="metric.name"
|
||||||
|
class="metric-item"
|
||||||
|
:class="`metric-${metric.status}`"
|
||||||
|
>
|
||||||
|
<el-progress
|
||||||
|
type="circle"
|
||||||
|
:percentage="metric.value"
|
||||||
|
:status="metric.status"
|
||||||
|
/>
|
||||||
|
<span class="metric-name">{{ metric.name }}</span>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<!-- 问题列表 -->
|
||||||
|
<div class="issues-section">
|
||||||
|
<h4>检查结果</h4>
|
||||||
|
<el-alert
|
||||||
|
v-for="(issue, index) in issues"
|
||||||
|
:key="index"
|
||||||
|
:type="getIssueType(issue)"
|
||||||
|
:closable="false"
|
||||||
|
class="issue-item"
|
||||||
|
>
|
||||||
|
<template #title>
|
||||||
|
发现 <strong>{{ issue.count }}</strong> {{ issue.description }}
|
||||||
|
</template>
|
||||||
|
</el-alert>
|
||||||
|
<el-button type="text" @click="handleViewDetails">查看详情 →</el-button>
|
||||||
|
</div>
|
||||||
|
</el-card>
|
||||||
|
</template>
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 4. 交互说明
|
||||||
|
|
||||||
|
### 4.1 文件上传流程
|
||||||
|
|
||||||
|
1. **拖拽上传**
|
||||||
|
- 用户拖拽文件到上传区域
|
||||||
|
- 显示上传进度条
|
||||||
|
- 上传成功后显示成功提示
|
||||||
|
- 自动添加到已上传文件列表
|
||||||
|
|
||||||
|
2. **点击上传**
|
||||||
|
- 点击上传区域触发文件选择对话框
|
||||||
|
- 选择文件后开始上传
|
||||||
|
- 显示上传进度
|
||||||
|
|
||||||
|
3. **文件验证**
|
||||||
|
- 文件格式验证：只接受指定格式
|
||||||
|
- 文件大小验证：超过限制显示错误提示
|
||||||
|
- 重复文件验证：同名文件提示是否覆盖
|
||||||
|
|
||||||
|
4. **上传状态**
|
||||||
|
- 上传中：显示进度条
|
||||||
|
- 上传成功：绿色勾选标记
|
||||||
|
- 上传失败：红色错误标记，显示错误信息
|
||||||
|
|
||||||
|
### 4.2 名单库选择
|
||||||
|
|
||||||
|
1. 默认选中全部名单库
|
||||||
|
2. 点击复选框切换选中状态
|
||||||
|
3. 实时更新选中人数统计
|
||||||
|
4. 取消选中时显示确认提示
|
||||||
|
|
||||||
|
### 4.3 数据质量检查
|
||||||
|
|
||||||
|
1. **自动触发**
|
||||||
|
- 文件上传完成后自动触发
|
||||||
|
- 显示检查进度
|
||||||
|
|
||||||
|
2. **手动触发**
|
||||||
|
- 点击"重新检查"按钮
|
||||||
|
- 覆盖之前的检查结果
|
||||||
|
|
||||||
|
3. **结果展示**
|
||||||
|
- 三个核心指标以环形进度图展示
|
||||||
|
- 颜色指示：绿色(≥95%)、黄色(85-94%)、红色(<85%)
|
||||||
|
- 问题列表按严重程度排序
|
||||||
|
|
||||||
|
### 4.4 按钮操作
|
||||||
|
|
||||||
|
1. **拉取本行信息**
|
||||||
|
- 点击后显示加载状态
|
||||||
|
- 从本行系统拉取相关数据
|
||||||
|
- 完成后显示成功提示并刷新页面
|
||||||
|
|
||||||
|
2. **生成报告**
|
||||||
|
- 验证必须上传至少一个文件
|
||||||
|
- 显示报告生成进度
|
||||||
|
- 生成成功后跳转到报告页面
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 5. 数据结构
|
||||||
|
|
||||||
|
### 5.1 后端接口
|
||||||
|
|
||||||
|
#### 5.1.1 获取项目上传数据状态
|
||||||
|
```typescript
|
||||||
|
GET /api/project/{projectId}/upload-status
|
||||||
|
|
||||||
|
Response:
|
||||||
|
{
|
||||||
|
"code": 200,
|
||||||
|
"data": {
|
||||||
|
"projectStatus": "已完成",
|
||||||
|
"lastUpdateTime": "2024-01-20 15:30:00",
|
||||||
|
"uploadedFiles": {
|
||||||
|
"transactionFiles": [], // 流水文件列表
|
||||||
|
"inquiryFiles": [], // 征信文件列表
|
||||||
|
"familyRelationFiles": [] // 家庭关系文件列表
|
||||||
|
},
|
||||||
|
"selectedNameLists": [], // 已选名单库
|
||||||
|
"qualityMetrics": { // 质量指标
|
||||||
|
"completeness": 98.5,
|
||||||
|
"consistency": 95.2,
|
||||||
|
"continuity": 92.8
|
||||||
|
},
|
||||||
|
"qualityIssues": [] // 质量问题列表
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
#### 5.1.2 上传文件接口
|
||||||
|
```typescript
|
||||||
|
POST /api/project/{projectId}/upload
|
||||||
|
Content-Type: multipart/form-data
|
||||||
|
|
||||||
|
Body:
|
||||||
|
{
|
||||||
|
"fileType": "transaction" | "inquiry" | "family_relation",
|
||||||
|
"files": File[]
|
||||||
|
}
|
||||||
|
|
||||||
|
Response:
|
||||||
|
{
|
||||||
|
"code": 200,
|
||||||
|
"data": {
|
||||||
|
"successCount": 2,
|
||||||
|
"failedCount": 0,
|
||||||
|
"uploadedFiles": [
|
||||||
|
{
|
||||||
|
"fileId": "123456",
|
||||||
|
"fileName": "流水数据.xlsx",
|
||||||
|
"fileSize": 2048576,
|
||||||
|
"uploadTime": "2024-01-20 15:30:00",
|
||||||
|
"status": "success"
|
||||||
|
}
|
||||||
|
]
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
#### 5.1.3 删除文件接口
|
||||||
|
```typescript
|
||||||
|
DELETE /api/project/{projectId}/file/{fileId}
|
||||||
|
|
||||||
|
Response:
|
||||||
|
{
|
||||||
|
"code": 200,
|
||||||
|
"msg": "删除成功"
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
#### 5.1.4 获取名单库列表
|
||||||
|
```typescript
|
||||||
|
GET /api/name-list/options
|
||||||
|
|
||||||
|
Response:
|
||||||
|
{
|
||||||
|
"code": 200,
|
||||||
|
"data": [
|
||||||
|
{
|
||||||
|
"value": "high_risk",
|
||||||
|
"label": "高风险人员名单",
|
||||||
|
"count": 68
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"value": "history_suspicious",
|
||||||
|
"label": "历史可疑人员名单",
|
||||||
|
"count": 45
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"value": "regulatory_focus",
|
||||||
|
"label": "监管关注名单",
|
||||||
|
"count": 32
|
||||||
|
}
|
||||||
|
]
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
#### 5.1.5 更新名单库选择
|
||||||
|
```typescript
|
||||||
|
PUT /api/project/{projectId}/name-lists
|
||||||
|
|
||||||
|
Body:
|
||||||
|
{
|
||||||
|
"selectedLists": ["high_risk", "history_suspicious", "regulatory_focus"]
|
||||||
|
}
|
||||||
|
|
||||||
|
Response:
|
||||||
|
{
|
||||||
|
"code": 200,
|
||||||
|
"msg": "更新成功"
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
#### 5.1.6 执行数据质量检查
|
||||||
|
```typescript
|
||||||
|
POST /api/project/{projectId}/quality-check
|
||||||
|
|
||||||
|
Response:
|
||||||
|
{
|
||||||
|
"code": 200,
|
||||||
|
"data": {
|
||||||
|
"checkId": "qc_123456",
|
||||||
|
"status": "completed",
|
||||||
|
"metrics": {
|
||||||
|
"completeness": 98.5,
|
||||||
|
"consistency": 95.2,
|
||||||
|
"continuity": 92.8
|
||||||
|
},
|
||||||
|
"issues": [
|
||||||
|
{
|
||||||
|
"type": "format_inconsistency",
|
||||||
|
"count": 23,
|
||||||
|
"description": "条数据格式不一致"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"type": "balance_anomaly",
|
||||||
|
"count": 5,
|
||||||
|
"description": "条余额连续性异常"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"type": "missing_field",
|
||||||
|
"count": 12,
|
||||||
|
"description": "条缺失关键字段"
|
||||||
|
}
|
||||||
|
]
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
#### 5.1.7 拉取本行信息
|
||||||
|
```typescript
|
||||||
|
POST /api/project/{projectId}/pull-bank-info
|
||||||
|
|
||||||
|
Response:
|
||||||
|
{
|
||||||
|
"code": 200,
|
||||||
|
"msg": "拉取成功",
|
||||||
|
"data": {
|
||||||
|
"pulledRecords": 156,
|
||||||
|
"pullTime": "2024-01-20 15:35:00"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
#### 5.1.8 生成报告
|
||||||
|
```typescript
|
||||||
|
POST /api/project/{projectId}/generate-report
|
||||||
|
|
||||||
|
Response:
|
||||||
|
{
|
||||||
|
"code": 200,
|
||||||
|
"data": {
|
||||||
|
"reportId": "rpt_789012",
|
||||||
|
"reportUrl": "/project/123/report/rpt_789012",
|
||||||
|
"generateTime": "2024-01-20 15:40:00"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
### 5.2 前端数据模型
|
||||||
|
|
||||||
|
```typescript
|
||||||
|
// 上传文件类型
|
||||||
|
type UploadFileType = 'transaction' | 'inquiry' | 'family_relation';
|
||||||
|
|
||||||
|
// 上传文件状态
|
||||||
|
type UploadStatus = 'uploading' | 'success' | 'error';
|
||||||
|
|
||||||
|
// 上传的文件
|
||||||
|
interface UploadedFile {
|
||||||
|
fileId: string;
|
||||||
|
fileName: string;
|
||||||
|
fileSize: number;
|
||||||
|
uploadTime: string;
|
||||||
|
status: UploadStatus;
|
||||||
|
errorMessage?: string;
|
||||||
|
}
|
||||||
|
|
||||||
|
// 名单库选项
|
||||||
|
interface NameListOption {
|
||||||
|
value: string;
|
||||||
|
label: string;
|
||||||
|
count: number;
|
||||||
|
disabled?: boolean;
|
||||||
|
}
|
||||||
|
|
||||||
|
// 质量指标
|
||||||
|
interface QualityMetric {
|
||||||
|
name: string;
|
||||||
|
value: number;
|
||||||
|
status: 'good' | 'warning' | 'error';
|
||||||
|
}
|
||||||
|
|
||||||
|
// 质量问题
|
||||||
|
interface QualityIssue {
|
||||||
|
type: string;
|
||||||
|
count: number;
|
||||||
|
description: string;
|
||||||
|
details?: any[];
|
||||||
|
}
|
||||||
|
|
||||||
|
// 项目上传数据状态
|
||||||
|
interface ProjectUploadStatus {
|
||||||
|
projectStatus: string;
|
||||||
|
lastUpdateTime: string;
|
||||||
|
uploadedFiles: {
|
||||||
|
transactionFiles: UploadedFile[];
|
||||||
|
inquiryFiles: UploadedFile[];
|
||||||
|
familyRelationFiles: UploadedFile[];
|
||||||
|
};
|
||||||
|
selectedNameLists: string[];
|
||||||
|
qualityMetrics: {
|
||||||
|
completeness: number;
|
||||||
|
consistency: number;
|
||||||
|
continuity: number;
|
||||||
|
};
|
||||||
|
qualityIssues: QualityIssue[];
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 6. 样式规范
|
||||||
|
|
||||||
|
### 6.1 颜色规范
|
||||||
|
```scss
|
||||||
|
// 主色
|
||||||
|
$primary-color: #409EFF;
|
||||||
|
$success-color: #67C23A;
|
||||||
|
$warning-color: #E6A23C;
|
||||||
|
$danger-color: #F56C6C;
|
||||||
|
$info-color: #909399;
|
||||||
|
|
||||||
|
// 中性色
|
||||||
|
$text-primary: #303133;
|
||||||
|
$text-regular: #606266;
|
||||||
|
$text-secondary: #909399;
|
||||||
|
$text-placeholder: #C0C4CC;
|
||||||
|
|
||||||
|
// 边框色
|
||||||
|
$border-base: #DCDFE6;
|
||||||
|
$border-light: #E4E7ED;
|
||||||
|
$border-lighter: #EBEEF5;
|
||||||
|
$border-extra-light: #F2F6FC;
|
||||||
|
|
||||||
|
// 背景色
|
||||||
|
$bg-color: #F5F7FA;
|
||||||
|
$card-bg: #FFFFFF;
|
||||||
|
```
|
||||||
|
|
||||||
|
### 6.2 间距规范
|
||||||
|
```scss
|
||||||
|
$spacing-xs: 4px;
|
||||||
|
$spacing-sm: 8px;
|
||||||
|
$spacing-md: 16px;
|
||||||
|
$spacing-lg: 24px;
|
||||||
|
$spacing-xl: 32px;
|
||||||
|
```
|
||||||
|
|
||||||
|
### 6.3 圆角规范
|
||||||
|
```scss
|
||||||
|
$border-radius-sm: 2px;
|
||||||
|
$border-radius-base: 4px;
|
||||||
|
$border-radius-lg: 8px;
|
||||||
|
$border-radius-circle: 50%;
|
||||||
|
```
|
||||||
|
|
||||||
|
### 6.4 阴影规范
|
||||||
|
```scss
|
||||||
|
$box-shadow-base: 0 2px 4px rgba(0, 0, 0, 0.12), 0 0 6px rgba(0, 0, 0, 0.04);
|
||||||
|
$box-shadow-dark: 0 2px 8px rgba(0, 0, 0, 0.15), 0 0 6px rgba(0, 0, 0, 0.1);
|
||||||
|
$box-shadow-light: 0 2px 12px 0 rgba(0, 0, 0, 0.1);
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 7. 组件样式代码
|
||||||
|
|
||||||
|
### 7.1 上传卡片样式
|
||||||
|
```scss
|
||||||
|
.upload-card {
|
||||||
|
height: 100%;
|
||||||
|
|
||||||
|
.card-header {
|
||||||
|
display: flex;
|
||||||
|
align-items: center;
|
||||||
|
justify-content: space-between;
|
||||||
|
|
||||||
|
h3 {
|
||||||
|
margin: 0;
|
||||||
|
font-size: 16px;
|
||||||
|
font-weight: 500;
|
||||||
|
color: $text-primary;
|
||||||
|
}
|
||||||
|
|
||||||
|
.el-icon-info {
|
||||||
|
color: $info-color;
|
||||||
|
cursor: help;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
.upload-area {
|
||||||
|
margin-bottom: $spacing-md;
|
||||||
|
|
||||||
|
.el-upload-dragger {
|
||||||
|
width: 100%;
|
||||||
|
height: 180px;
|
||||||
|
border: 2px dashed $border-base;
|
||||||
|
border-radius: $border-radius-lg;
|
||||||
|
background: $bg-color;
|
||||||
|
transition: all 0.3s;
|
||||||
|
|
||||||
|
&:hover {
|
||||||
|
border-color: $primary-color;
|
||||||
|
background: #F0F7FF;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
.upload-content {
|
||||||
|
display: flex;
|
||||||
|
flex-direction: column;
|
||||||
|
align-items: center;
|
||||||
|
justify-content: center;
|
||||||
|
height: 100%;
|
||||||
|
|
||||||
|
.el-icon-upload {
|
||||||
|
font-size: 48px;
|
||||||
|
color: $primary-color;
|
||||||
|
margin-bottom: $spacing-sm;
|
||||||
|
}
|
||||||
|
|
||||||
|
p {
|
||||||
|
margin: $spacing-xs 0;
|
||||||
|
font-size: 14px;
|
||||||
|
color: $text-regular;
|
||||||
|
}
|
||||||
|
|
||||||
|
.upload-tip {
|
||||||
|
font-size: 12px;
|
||||||
|
color: $text-secondary;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
.file-list {
|
||||||
|
border-top: 1px solid $border-light;
|
||||||
|
padding-top: $spacing-md;
|
||||||
|
|
||||||
|
h4 {
|
||||||
|
margin: 0 0 $spacing-sm 0;
|
||||||
|
font-size: 14px;
|
||||||
|
color: $text-primary;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
### 7.2 数据质量面板样式
|
||||||
|
```scss
|
||||||
|
.quality-panel {
|
||||||
|
.panel-header {
|
||||||
|
display: flex;
|
||||||
|
align-items: center;
|
||||||
|
justify-content: space-between;
|
||||||
|
|
||||||
|
h3 {
|
||||||
|
margin: 0;
|
||||||
|
font-size: 16px;
|
||||||
|
font-weight: 500;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
.metrics-container {
|
||||||
|
display: flex;
|
||||||
|
justify-content: space-around;
|
||||||
|
margin-bottom: $spacing-lg;
|
||||||
|
|
||||||
|
.metric-item {
|
||||||
|
display: flex;
|
||||||
|
flex-direction: column;
|
||||||
|
align-items: center;
|
||||||
|
|
||||||
|
.el-progress {
|
||||||
|
margin-bottom: $spacing-sm;
|
||||||
|
}
|
||||||
|
|
||||||
|
.metric-name {
|
||||||
|
font-size: 14px;
|
||||||
|
color: $text-regular;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
.issues-section {
|
||||||
|
border-top: 1px solid $border-light;
|
||||||
|
padding-top: $spacing-md;
|
||||||
|
|
||||||
|
h4 {
|
||||||
|
margin: 0 0 $spacing-md 0;
|
||||||
|
font-size: 14px;
|
||||||
|
color: $text-primary;
|
||||||
|
}
|
||||||
|
|
||||||
|
.issue-item {
|
||||||
|
margin-bottom: $spacing-sm;
|
||||||
|
|
||||||
|
&:last-child {
|
||||||
|
margin-bottom: 0;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
### 7.3 页面整体布局样式
|
||||||
|
```scss
|
||||||
|
.upload-data-page {
|
||||||
|
padding: $spacing-lg;
|
||||||
|
background: $bg-color;
|
||||||
|
min-height: calc(100vh - 84px);
|
||||||
|
|
||||||
|
.page-header {
|
||||||
|
background: $card-bg;
|
||||||
|
padding: $spacing-lg;
|
||||||
|
border-radius: $border-radius-lg;
|
||||||
|
margin-bottom: $spacing-lg;
|
||||||
|
box-shadow: $box-shadow-base;
|
||||||
|
|
||||||
|
h1 {
|
||||||
|
margin: 0 0 $spacing-sm 0;
|
||||||
|
font-size: 24px;
|
||||||
|
font-weight: 500;
|
||||||
|
}
|
||||||
|
|
||||||
|
.page-info {
|
||||||
|
display: flex;
|
||||||
|
gap: $spacing-lg;
|
||||||
|
font-size: 14px;
|
||||||
|
color: $text-secondary;
|
||||||
|
margin-top: $spacing-sm;
|
||||||
|
|
||||||
|
.info-item {
|
||||||
|
display: flex;
|
||||||
|
align-items: center;
|
||||||
|
|
||||||
|
.label {
|
||||||
|
margin-right: $spacing-xs;
|
||||||
|
}
|
||||||
|
|
||||||
|
.status {
|
||||||
|
color: $success-color;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
.page-description {
|
||||||
|
margin-top: $spacing-md;
|
||||||
|
padding: $spacing-md;
|
||||||
|
background: #F0F9FF;
|
||||||
|
border-left: 3px solid $primary-color;
|
||||||
|
border-radius: $border-radius-base;
|
||||||
|
font-size: 14px;
|
||||||
|
color: $text-regular;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
.upload-grid {
|
||||||
|
display: grid;
|
||||||
|
grid-template-columns: repeat(2, 1fr);
|
||||||
|
gap: $spacing-lg;
|
||||||
|
margin-bottom: $spacing-lg;
|
||||||
|
|
||||||
|
@media (min-width: 1200px) {
|
||||||
|
grid-template-columns: repeat(4, 1fr);
|
||||||
|
}
|
||||||
|
|
||||||
|
@media (max-width: 767px) {
|
||||||
|
grid-template-columns: 1fr;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
.full-width {
|
||||||
|
grid-column: 1 / -1;
|
||||||
|
}
|
||||||
|
|
||||||
|
.action-bar {
|
||||||
|
display: flex;
|
||||||
|
justify-content: center;
|
||||||
|
gap: $spacing-lg;
|
||||||
|
margin-top: $spacing-xl;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 8. 技术实现要点
|
||||||
|
|
||||||
|
### 8.1 文件上传
|
||||||
|
- 使用 Element UI 的 `el-upload` 组件
|
||||||
|
- 支持拖拽上传和点击上传
|
||||||
|
- 实现文件类型和大小校验
|
||||||
|
- 显示上传进度
|
||||||
|
- 支持断点续传（可选）
|
||||||
|
|
||||||
|
### 8.2 数据质量检查
|
||||||
|
- 异步执行检查任务
|
||||||
|
- 使用 WebSocket 或轮询获取检查进度
|
||||||
|
- 实时更新进度和结果
|
||||||
|
|
||||||
|
### 8.3 状态管理
|
||||||
|
- 使用 Vuex 管理上传状态
|
||||||
|
- 缓存已上传文件列表
|
||||||
|
- 同步名单库选择状态
|
||||||
|
|
||||||
|
### 8.4 性能优化
|
||||||
|
- 文件分片上传大文件
|
||||||
|
- 使用 Web Worker 处理文件预检查
|
||||||
|
- 虚拟滚动展示大量文件列表
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 9. 测试要点
|
||||||
|
|
||||||
|
### 9.1 功能测试
|
||||||
|
- 文件上传各种格式
|
||||||
|
- 文件大小限制验证
|
||||||
|
- 删除文件功能
|
||||||
|
- 名单库选择功能
|
||||||
|
- 数据质量检查准确性
|
||||||
|
- 报告生成功能
|
||||||
|
|
||||||
|
### 9.2 兼容性测试
|
||||||
|
- 主流浏览器兼容
|
||||||
|
- 不同屏幕尺寸适配
|
||||||
|
- 文件格式兼容性
|
||||||
|
|
||||||
|
### 9.3 性能测试
|
||||||
|
- 大文件上传性能
|
||||||
|
- 多文件同时上传
|
||||||
|
- 页面加载性能
|
||||||
|
|
||||||
|
### 9.4 异常处理测试
|
||||||
|
- 网络中断处理
|
||||||
|
- 文件上传失败处理
|
||||||
|
- 服务器错误处理
|
||||||
|
- 文件格式错误处理
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 10. 附录
|
||||||
|
|
||||||
|
### 10.1 相关页面
|
||||||
|
- 项目详情页：`/project/:id/detail`
|
||||||
|
- 参数配置页：`/project/:id/config`
|
||||||
|
- 初核结果页：`/project/:id/result`
|
||||||
|
- 报告页面：`/project/:id/report/:reportId`
|
||||||
|
|
||||||
|
### 10.2 权限要求
|
||||||
|
- 需要项目成员权限
|
||||||
|
- 上传操作需要编辑权限
|
||||||
|
- 删除操作需要删除权限
|
||||||
|
- 生成报告需要报告权限
|
||||||
|
|
||||||
|
### 10.3 相关文档
|
||||||
|
- [Element UI Upload 组件文档](https://element.eleme.cn/#/zh-CN/component/upload)
|
||||||
|
- [若依框架前端开发规范](../前端开发规范.md)
|
||||||
|
- [项目接口文档](../API文档/项目管理模块.md)
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
**文档版本**: v1.0
|
||||||
|
**创建时间**: 2024-01-30
|
||||||
|
**最后更新**: 2024-01-30
|
||||||
|
**文档状态**: 待评审
|
||||||
336
doc/plans/2025-01-30-project-detail-page-design.md
Normal file
336
doc/plans/2025-01-30-project-detail-page-design.md
Normal file
@@ -0,0 +1,336 @@
|
|||||||
|
# 项目详情页面设计文档
|
||||||
|
|
||||||
|
**创建日期**: 2025-01-30
|
||||||
|
**设计者**: Claude Code
|
||||||
|
**状态**: 待实施
|
||||||
|
|
||||||
|
## 1. 概述
|
||||||
|
|
||||||
|
### 1.1 需求描述
|
||||||
|
|
||||||
|
开发一个项目详情页面，在项目管理列表中，点击项目那一行或者查看详情跳转到项目详情页面。顶部有一个导航栏，里面有按钮切换项目详情的不同页面。
|
||||||
|
|
||||||
|
### 1.2 功能模块
|
||||||
|
|
||||||
|
- **上传数据**（默认）：批量上传流水、征信、员工家庭关系数据，选择名单库
|
||||||
|
- **参数配置**：配置项目分析参数和排查规则
|
||||||
|
- **结果总览**：查看项目分析结果的总体概况
|
||||||
|
- **专项排查**：针对特定风险类型进行深度排查
|
||||||
|
- **流水明细查询**：查询和筛选具体的流水记录明细
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 2. 整体架构设计
|
||||||
|
|
||||||
|
### 2.1 路由结构
|
||||||
|
|
||||||
|
采用独立页面路由方式：
|
||||||
|
|
||||||
|
```
|
||||||
|
路由: /project-detail/:projectId
|
||||||
|
组件: @/views/ccdiProject/detail/index.vue
|
||||||
|
```
|
||||||
|
|
||||||
|
### 2.2 页面布局
|
||||||
|
|
||||||
|
```
|
||||||
|
┌─────────────────────────────────────────────┐
|
||||||
|
│ 顶部导航 (PageHeader) │
|
||||||
|
│ [返回] 项目名称 [状态] │
|
||||||
|
│ [上传数据] [参数配置] [结果总览] ... │
|
||||||
|
├─────────────────────────────────────────────┤
|
||||||
|
│ │
|
||||||
|
│ 内容区域 (el-tabs) │
|
||||||
|
│ 根据选中标签显示对应子页面 │
|
||||||
|
│ │
|
||||||
|
└─────────────────────────────────────────────┘
|
||||||
|
```
|
||||||
|
|
||||||
|
### 2.3 组件层次结构
|
||||||
|
|
||||||
|
```
|
||||||
|
detail/
|
||||||
|
├── index.vue # 主页面容器
|
||||||
|
├── components/
|
||||||
|
│ ├── PageHeader.vue # 顶部导航
|
||||||
|
│ ├── UploadData.vue # 上传数据
|
||||||
|
│ ├── ParameterConfig.vue # 参数配置
|
||||||
|
│ ├── ResultOverview.vue # 结果总览
|
||||||
|
│ ├── SpecialCheck.vue # 专项排查
|
||||||
|
│ └── TransactionDetail.vue # 流水明细查询
|
||||||
|
└── api.js # API 接口定义
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 3. 上传数据页面详细设计
|
||||||
|
|
||||||
|
### 3.1 页面布局
|
||||||
|
|
||||||
|
```
|
||||||
|
┌─────────────────────────────────────────────┐
|
||||||
|
│ 批量上传数据 [生成报告][拉取本行]│
|
||||||
|
│ 支持在一个项目中上传多个主体/账户数据 │
|
||||||
|
├─────────────────────────────────────────────┤
|
||||||
|
│ ┌──────┐ ┌──────┐ ┌──────┐ ┌──────┐ │
|
||||||
|
│ │流水 │ │征信 │ │员工 │ │名单 │ │
|
||||||
|
│ │导入 │ │导入 │ │家庭 │ │库选择 │ │
|
||||||
|
│ └──────┘ └──────┘ └──────┘ └──────┘ │
|
||||||
|
├─────────────────────────────────────────────┤
|
||||||
|
│ 数据质量检查区 │
|
||||||
|
│ - 检查结果列表 │
|
||||||
|
│ - 指标卡片（完整性、一致性、连续性） │
|
||||||
|
└─────────────────────────────────────────────┘
|
||||||
|
```
|
||||||
|
|
||||||
|
### 3.2 功能模块
|
||||||
|
|
||||||
|
#### 3.2.1 流水导入
|
||||||
|
- 支持格式：xlsx, xls, pdf
|
||||||
|
- 拖拽上传 + 点击上传
|
||||||
|
- 上传进度显示
|
||||||
|
|
||||||
|
#### 3.2.2 征信导入
|
||||||
|
- 支持格式：html
|
||||||
|
- 解析征信报告
|
||||||
|
|
||||||
|
#### 3.2.3 员工家庭关系导入
|
||||||
|
- 支持格式：xlsx, xls
|
||||||
|
- Excel 模板上传
|
||||||
|
|
||||||
|
#### 3.2.4 名单库选择
|
||||||
|
- 高风险人员名单（68人）
|
||||||
|
- 历史可疑人员名单（45人）
|
||||||
|
- 监管关注名单（32人）
|
||||||
|
|
||||||
|
#### 3.2.5 数据质量检查
|
||||||
|
- 数据完整性：98.5%
|
||||||
|
- 格式一致性：95.2%
|
||||||
|
- 余额连续性：92.8%
|
||||||
|
- 检查结果详情
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 4. 其他子页面框架设计
|
||||||
|
|
||||||
|
### 4.1 参数配置页面
|
||||||
|
|
||||||
|
```
|
||||||
|
┌─────────────────────────────────────────────┐
|
||||||
|
│ 参数配置 [保存] [重置] │
|
||||||
|
├─────────────────────────────────────────────┤
|
||||||
|
│ ┌──────────┐ ┌──────────┐ │
|
||||||
|
│ │ 预警阈值 │ │ 排查规则 │ │
|
||||||
|
│ └──────────┘ └──────────┘ │
|
||||||
|
│ ┌────────────────────────────────┐ │
|
||||||
|
│ │ 高级配置（可折叠） │ │
|
||||||
|
│ └────────────────────────────────┘ │
|
||||||
|
└─────────────────────────────────────────────┘
|
||||||
|
```
|
||||||
|
|
||||||
|
### 4.2 结果总览页面
|
||||||
|
|
||||||
|
```
|
||||||
|
┌─────────────────────────────────────────────┐
|
||||||
|
│ 结果总览 [导出报告] [刷新] │
|
||||||
|
├─────────────────────────────────────────────┤
|
||||||
|
│ ┌────────┐ ┌────────┐ ┌────────┐ │
|
||||||
|
│ │ 总人数 │ │ 预警数 │ │ 可疑数 │ │
|
||||||
|
│ └────────┘ └────────┘ └────────┘ │
|
||||||
|
│ ┌──────────────┐ ┌──────────────┐ │
|
||||||
|
│ │ 预警分布图 │ │ 趋势图 │ │
|
||||||
|
│ └──────────────┘ └──────────────┘ │
|
||||||
|
│ 预警排名表格（Top 10） │
|
||||||
|
└─────────────────────────────────────────────┘
|
||||||
|
```
|
||||||
|
|
||||||
|
### 4.3 专项排查页面
|
||||||
|
|
||||||
|
```
|
||||||
|
┌─────────────────────────────────────────────┐
|
||||||
|
│ 专项排查 [新增排查] [批量导出]│
|
||||||
|
├─────────────────────────────────────────────┤
|
||||||
|
│ 筛选条件：[风险类型] [严重程度] [状态] │
|
||||||
|
│ 排查任务列表（表格） │
|
||||||
|
└─────────────────────────────────────────────┘
|
||||||
|
```
|
||||||
|
|
||||||
|
### 4.4 流水明细查询页面
|
||||||
|
|
||||||
|
```
|
||||||
|
┌─────────────────────────────────────────────┐
|
||||||
|
│ 流水明细查询 [导出] [高级查询] │
|
||||||
|
├─────────────────────────────────────────────┤
|
||||||
|
│ 查询条件：[账户] [日期范围] [金额范围] │
|
||||||
|
│ 流水明细表格（分页） │
|
||||||
|
└─────────────────────────────────────────────┘
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 5. 接口设计
|
||||||
|
|
||||||
|
### 5.1 接口列表
|
||||||
|
|
||||||
|
| 接口名称 | 方法 | 路径 | 说明 |
|
||||||
|
|---------|------|------|------|
|
||||||
|
| 获取项目详情 | GET | `/ccdi/project/detail/{projectId}` | 获取项目基本信息 |
|
||||||
|
| 上传流水文件 | POST | `/ccdi/project/transaction/upload` | 上传流水文件 |
|
||||||
|
| 上传征信文件 | POST | `/ccdi/project/credit/upload` | 上传征信报告 |
|
||||||
|
| 上传员工关系 | POST | `/ccdi/project/employee/upload` | 上传员工家庭关系 |
|
||||||
|
| 获取名单库列表 | GET | `/ccdi/project/namelist/list` | 获取可选名单库 |
|
||||||
|
| 保存名单库选择 | POST | `/ccdi/project/namelist/save` | 保存选择的名单库 |
|
||||||
|
| 获取数据质量检查 | GET | `/ccdi/project/quality/check` | 获取质量检查指标 |
|
||||||
|
| 生成报告 | POST | `/ccdi/project/report/generate` | 生成分析报告 |
|
||||||
|
| 拉取本行信息 | GET | `/ccdi/project/own/info` | 获取本行员工信息 |
|
||||||
|
| 保存参数配置 | POST | `/ccdi/project/config/save` | 保存项目参数 |
|
||||||
|
| 获取结果总览 | GET | `/ccdi/project/overview` | 获取结果统计数据 |
|
||||||
|
| 获取排查列表 | GET | `/ccdi/project/check/list` | 获取专项排查列表 |
|
||||||
|
| 查询流水明细 | GET | `/ccdi/project/transaction/list` | 分页查询流水 |
|
||||||
|
|
||||||
|
### 5.2 Mock 数据示例
|
||||||
|
|
||||||
|
**项目详情**
|
||||||
|
```javascript
|
||||||
|
{
|
||||||
|
code: 200,
|
||||||
|
data: {
|
||||||
|
projectId: 1,
|
||||||
|
projectName: "2025年第一季度初核排查",
|
||||||
|
projectDesc: "针对全行员工进行第一季度常规排查",
|
||||||
|
projectStatus: "0",
|
||||||
|
createTime: "2025-01-15",
|
||||||
|
targetCount: 1250,
|
||||||
|
warningCount: 23
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
**数据质量检查结果**
|
||||||
|
```javascript
|
||||||
|
{
|
||||||
|
code: 200,
|
||||||
|
data: {
|
||||||
|
completeness: 98.5,
|
||||||
|
consistency: 95.2,
|
||||||
|
continuity: 92.8,
|
||||||
|
issues: [
|
||||||
|
{ type: "格式不一致", count: 23 },
|
||||||
|
{ type: "余额连续性异常", count: 5 },
|
||||||
|
{ type: "缺失关键字段", count: 12 }
|
||||||
|
]
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 6. 状态管理
|
||||||
|
|
||||||
|
### 6.1 Vuex Store
|
||||||
|
|
||||||
|
```javascript
|
||||||
|
// store/modules/projectDetail.js
|
||||||
|
const state = {
|
||||||
|
currentProject: null,
|
||||||
|
activeTab: 'upload',
|
||||||
|
uploadStatus: {
|
||||||
|
transaction: false,
|
||||||
|
credit: false,
|
||||||
|
employee: false,
|
||||||
|
nameList: []
|
||||||
|
},
|
||||||
|
qualityCheck: null,
|
||||||
|
pageCache: {}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
### 6.2 页面缓存
|
||||||
|
|
||||||
|
使用 `<keep-alive>` 缓存标签页内容，避免切换时重复加载。
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 7. 路由配置
|
||||||
|
|
||||||
|
```javascript
|
||||||
|
// router/index.js
|
||||||
|
{
|
||||||
|
path: '/project-detail',
|
||||||
|
component: Layout,
|
||||||
|
hidden: true,
|
||||||
|
children: [
|
||||||
|
{
|
||||||
|
path: ':projectId(\\d+)',
|
||||||
|
component: () => import('@/views/ccdiProject/detail/index'),
|
||||||
|
name: 'ProjectDetail',
|
||||||
|
meta: {
|
||||||
|
title: '项目详情',
|
||||||
|
activeMenu: '/ccdiProject'
|
||||||
|
}
|
||||||
|
}
|
||||||
|
]
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 8. 文件目录结构
|
||||||
|
|
||||||
|
```
|
||||||
|
ruoyi-ui/src/
|
||||||
|
├── views/ccdiProject/
|
||||||
|
│ ├── index.vue # 项目列表页（已存在）
|
||||||
|
│ └── detail/ # 项目详情目录
|
||||||
|
│ ├── index.vue # 主页面
|
||||||
|
│ └── components/
|
||||||
|
│ ├── PageHeader.vue
|
||||||
|
│ ├── UploadData.vue
|
||||||
|
│ ├── ParameterConfig.vue
|
||||||
|
│ ├── ResultOverview.vue
|
||||||
|
│ ├── SpecialCheck.vue
|
||||||
|
│ └── TransactionDetail.vue
|
||||||
|
├── api/
|
||||||
|
│ └── ccdiProject/
|
||||||
|
│ └── detail.js # 项目详情 API
|
||||||
|
├── store/
|
||||||
|
│ └── modules/
|
||||||
|
│ └── projectDetail.js # Vuex 状态管理
|
||||||
|
└── mock/
|
||||||
|
└── projectDetail.js # Mock 数据
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 9. 待实现功能清单
|
||||||
|
|
||||||
|
- [ ] 创建路由配置
|
||||||
|
- [ ] 创建主页面容器
|
||||||
|
- [ ] 实现 PageHeader 顶部导航组件
|
||||||
|
- [ ] 实现 UploadData 上传数据页面
|
||||||
|
- [ ] 流水导入功能
|
||||||
|
- [ ] 征信导入功能
|
||||||
|
- [ ] 员工家庭关系导入功能
|
||||||
|
- [ ] 名单库选择功能
|
||||||
|
- [ ] 数据质量检查展示
|
||||||
|
- [ ] 实现 ParameterConfig 参数配置页面（框架）
|
||||||
|
- [ ] 实现 ResultOverview 结果总览页面（框架）
|
||||||
|
- [ ] 实现 SpecialCheck 专项排查页面（框架）
|
||||||
|
- [ ] 实现 TransactionDetail 流水明细查询页面（框架）
|
||||||
|
- [ ] 创建 Vuex 状态管理模块
|
||||||
|
- [ ] 创建 API 接口定义
|
||||||
|
- [ ] 创建 Mock 数据
|
||||||
|
- [ ] 修改项目列表页跳转逻辑
|
||||||
|
- [ ] 测试整体流程
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 10. 设计决策记录
|
||||||
|
|
||||||
|
| 决策点 | 选择 | 原因 |
|
||||||
|
|-------|------|------|
|
||||||
|
| 路由方式 | 独立页面路由 | 可通过URL直接访问，支持浏览器前进后退 |
|
||||||
|
| 导航方式 | Tabs 标签页 | 交互流畅，适合频繁切换场景 |
|
||||||
|
| 上传卡片布局 | 四列一行 | 节省空间，一目了然 |
|
||||||
|
| 后端接口 | Mock 数据先行 | 前端可独立开发，后续对接真实接口 |
|
||||||
|
| 状态管理 | Vuex | 便于跨组件数据共享和状态持久化 |
|
||||||
1958
doc/plans/2026-02-04-intermediary-blacklist-implementation.md
Normal file
1958
doc/plans/2026-02-04-intermediary-blacklist-implementation.md
Normal file
File diff suppressed because it is too large
Load Diff
1177
doc/plans/2026-02-04-intermediary-blacklist-migration-test-plan.md
Normal file
1177
doc/plans/2026-02-04-intermediary-blacklist-migration-test-plan.md
Normal file
File diff suppressed because it is too large
Load Diff
@@ -0,0 +1,887 @@
|
|||||||
|
# 中介黑名单入库逻辑变更 - 测试验证计划
|
||||||
|
|
||||||
|
> **For Claude:** REQUIRED SUB-SKILL: Use superpowers:executing-plans to implement this plan task-by-task.
|
||||||
|
|
||||||
|
**目标:** 验证中介黑名单从单表切换到双表(cdi_biz_intermediary + ccdi_enterprise_base_info)的所有CRUD操作正确性
|
||||||
|
|
||||||
|
**架构:** 个人中介插入 ccdi_biz_intermediary 表,机构中介插入 ccdi_enterprise_base_info 表(自动设置高风险和中介来源标识),查询层合并两个表的数据返回
|
||||||
|
|
||||||
|
**技术栈:** Spring Boot 3.5.8, MyBatis Plus 3.5.10, MySQL 8.2.0, Maven, JUnit 5
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 测试前准备
|
||||||
|
|
||||||
|
### Task 1: 确认数据库连接和环境
|
||||||
|
|
||||||
|
**Files:**
|
||||||
|
- Check: `ruoyi-admin/src/main/resources/application-dev.yml`
|
||||||
|
|
||||||
|
**Step 1: 验证数据库连接配置**
|
||||||
|
|
||||||
|
检查配置文件中的数据库连接信息:
|
||||||
|
```yaml
|
||||||
|
spring:
|
||||||
|
datasource:
|
||||||
|
druid:
|
||||||
|
master:
|
||||||
|
url: jdbc:mysql://116.62.17.81:3306/ccdi
|
||||||
|
username: root
|
||||||
|
password: Kfcx@1234
|
||||||
|
```
|
||||||
|
|
||||||
|
**Step 2: 确认目标表存在**
|
||||||
|
|
||||||
|
通过MCP工具验证表存在:
|
||||||
|
```sql
|
||||||
|
SHOW TABLES LIKE 'ccdi_biz_intermediary';
|
||||||
|
SHOW TABLES LIKE 'ccdi_enterprise_base_info';
|
||||||
|
```
|
||||||
|
|
||||||
|
预期: 两个表都存在
|
||||||
|
|
||||||
|
**Step 3: 检查表结构**
|
||||||
|
|
||||||
|
```sql
|
||||||
|
DESCRIBE ccdi_biz_intermediary;
|
||||||
|
DESCRIBE ccdi_enterprise_base_info;
|
||||||
|
```
|
||||||
|
|
||||||
|
预期: 表结构与实体类字段匹配
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 功能测试 - 个人中介
|
||||||
|
|
||||||
|
### Task 2: 测试个人中介新增功能
|
||||||
|
|
||||||
|
**Files:**
|
||||||
|
- Test API: `POST /ccdi/intermediary/person`
|
||||||
|
- Backend: `CcdiIntermediaryBlacklistServiceImpl.insertPersonIntermediary()`
|
||||||
|
|
||||||
|
**Step 1: 准备测试数据**
|
||||||
|
|
||||||
|
创建测试数据文件 `test_person_add.json`:
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"name": "测试个人中介",
|
||||||
|
"certificateNo": "110101199001011234",
|
||||||
|
"indivType": "中介",
|
||||||
|
"indivSubType": "本人",
|
||||||
|
"indivGender": "M",
|
||||||
|
"indivCertType": "身份证",
|
||||||
|
"indivPhone": "13800138000",
|
||||||
|
"indivWechat": "test_wx001",
|
||||||
|
"indivAddress": "北京市朝阳区测试路123号",
|
||||||
|
"indivCompany": "测试公司",
|
||||||
|
"indivPosition": "测试员",
|
||||||
|
"indivRelatedId": "",
|
||||||
|
"indivRelation": "",
|
||||||
|
"status": "0",
|
||||||
|
"remark": "自动化测试数据"
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
**Step 2: 获取认证Token**
|
||||||
|
|
||||||
|
```bash
|
||||||
|
curl -X POST http://localhost:8080/login/test \
|
||||||
|
-H "Content-Type: application/json" \
|
||||||
|
-d '{"username":"admin","password":"admin123"}' \
|
||||||
|
| jq -r '.data.token'
|
||||||
|
```
|
||||||
|
|
||||||
|
保存token到环境变量:
|
||||||
|
```bash
|
||||||
|
export TOKEN="获取到的token值"
|
||||||
|
```
|
||||||
|
|
||||||
|
**Step 3: 调用新增接口**
|
||||||
|
|
||||||
|
```bash
|
||||||
|
curl -X POST http://localhost:8080/ccdi/intermediary/person \
|
||||||
|
-H "Authorization: Bearer $TOKEN" \
|
||||||
|
-H "Content-Type: application/json" \
|
||||||
|
-d @test_person_add.json
|
||||||
|
```
|
||||||
|
|
||||||
|
预期响应:
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"code": 200,
|
||||||
|
"msg": "操作成功"
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
**Step 4: 验证数据插入到正确的表**
|
||||||
|
|
||||||
|
通过MCP查询数据库:
|
||||||
|
```sql
|
||||||
|
SELECT * FROM ccdi_biz_intermediary
|
||||||
|
WHERE person_id = '110101199001011234';
|
||||||
|
```
|
||||||
|
|
||||||
|
预期:
|
||||||
|
- 找到1条记录
|
||||||
|
- name = '测试个人中介'
|
||||||
|
- date_source = 'MANUAL'
|
||||||
|
|
||||||
|
**Step 5: 验证旧表无数据**
|
||||||
|
|
||||||
|
```sql
|
||||||
|
SELECT * FROM ccdi_intermediary_blacklist
|
||||||
|
WHERE certificate_no = '110101199001011234';
|
||||||
|
```
|
||||||
|
|
||||||
|
预期: 0条记录(表可能不存在或为空)
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### Task 3: 测试个人中介列表查询
|
||||||
|
|
||||||
|
**Files:**
|
||||||
|
- Test API: `GET /ccdi/intermediary/list`
|
||||||
|
|
||||||
|
**Step 1: 调用列表查询接口**
|
||||||
|
|
||||||
|
```bash
|
||||||
|
curl -X GET "http://localhost:8080/ccdi/intermediary/list?name=测试个人中介" \
|
||||||
|
-H "Authorization: Bearer $TOKEN"
|
||||||
|
```
|
||||||
|
|
||||||
|
预期响应:
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"code": 200,
|
||||||
|
"msg": "查询成功",
|
||||||
|
"rows": [
|
||||||
|
{
|
||||||
|
"intermediaryId": 1,
|
||||||
|
"name": "测试个人中介",
|
||||||
|
"certificateNo": "110101199001011234",
|
||||||
|
"intermediaryType": "1",
|
||||||
|
"intermediaryTypeName": "个人",
|
||||||
|
"status": "0",
|
||||||
|
"statusName": "正常"
|
||||||
|
}
|
||||||
|
],
|
||||||
|
"total": 1
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
**Step 2: 验证查询结果来源**
|
||||||
|
|
||||||
|
确认数据来自 `ccdi_biz_intermediary` 表
|
||||||
|
|
||||||
|
**Step 3: 测试分页查询**
|
||||||
|
|
||||||
|
```bash
|
||||||
|
curl -X GET "http://localhost:8080/ccdi/intermediary/list?pageNum=1&pageSize=10" \
|
||||||
|
-H "Authorization: Bearer $TOKEN"
|
||||||
|
```
|
||||||
|
|
||||||
|
预期: 返回分页数据
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### Task 4: 测试个人中介详情查询
|
||||||
|
|
||||||
|
**Files:**
|
||||||
|
- Test API: `GET /ccdi/intermediary/{id}`
|
||||||
|
|
||||||
|
**Step 1: 获取个人中介详情**
|
||||||
|
|
||||||
|
```bash
|
||||||
|
curl -X GET "http://localhost:8080/ccdi/intermediary/1" \
|
||||||
|
-H "Authorization: Bearer $TOKEN"
|
||||||
|
```
|
||||||
|
|
||||||
|
预期响应:
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"code": 200,
|
||||||
|
"data": {
|
||||||
|
"intermediaryId": 1,
|
||||||
|
"name": "测试个人中介",
|
||||||
|
"certificateNo": "110101199001011234",
|
||||||
|
"intermediaryType": "1",
|
||||||
|
"indivType": "中介",
|
||||||
|
"indivGender": "M",
|
||||||
|
"indivGenderName": "男",
|
||||||
|
"indivPhone": "13800138000",
|
||||||
|
"indivWechat": "test_wx001",
|
||||||
|
"indivAddress": "北京市朝阳区测试路123号",
|
||||||
|
"indivCompany": "测试公司",
|
||||||
|
"indivPosition": "测试员",
|
||||||
|
"dataSource": "MANUAL",
|
||||||
|
"dataSourceName": "手动录入"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
**Step 2: 验证所有字段正确映射**
|
||||||
|
|
||||||
|
检查个人专属字段是否正确:
|
||||||
|
- indivType → person_type ✅
|
||||||
|
- indivGender → gender ✅
|
||||||
|
- indivPhone → mobile ✅
|
||||||
|
- indivWechat → wechat_no ✅
|
||||||
|
- indivAddress → contact_address ✅
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### Task 5: 测试个人中介修改功能
|
||||||
|
|
||||||
|
**Files:**
|
||||||
|
- Test API: `PUT /ccdi/intermediary/person`
|
||||||
|
|
||||||
|
**Step 1: 准备修改数据**
|
||||||
|
|
||||||
|
创建 `test_person_edit.json`:
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"intermediaryId": 1,
|
||||||
|
"name": "测试个人中介-已修改",
|
||||||
|
"certificateNo": "110101199001011234",
|
||||||
|
"indivType": "中介",
|
||||||
|
"indivGender": "M",
|
||||||
|
"indivPhone": "13900139000",
|
||||||
|
"indivCompany": "新公司",
|
||||||
|
"remark": "已修改"
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
**Step 2: 调用修改接口**
|
||||||
|
|
||||||
|
```bash
|
||||||
|
curl -X PUT http://localhost:8080/ccdi/intermediary/person \
|
||||||
|
-H "Authorization: Bearer $TOKEN" \
|
||||||
|
-H "Content-Type: application/json" \
|
||||||
|
-d @test_person_edit.json
|
||||||
|
```
|
||||||
|
|
||||||
|
预期: `{ "code": 200, "msg": "操作成功" }`
|
||||||
|
|
||||||
|
**Step 3: 验证数据已更新**
|
||||||
|
|
||||||
|
```sql
|
||||||
|
SELECT * FROM ccdi_biz_intermediary
|
||||||
|
WHERE biz_id = 1;
|
||||||
|
```
|
||||||
|
|
||||||
|
预期:
|
||||||
|
- name = '测试个人中介-已修改'
|
||||||
|
- mobile = '13900139000'
|
||||||
|
- company = '新公司'
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### Task 6: 测试个人中介删除功能
|
||||||
|
|
||||||
|
**Files:**
|
||||||
|
- Test API: `DELETE /ccdi/intermediary/{ids}`
|
||||||
|
|
||||||
|
**Step 1: 调用删除接口**
|
||||||
|
|
||||||
|
```bash
|
||||||
|
curl -X DELETE "http://localhost:8080/ccdi/intermediary/1" \
|
||||||
|
-H "Authorization: Bearer $TOKEN"
|
||||||
|
```
|
||||||
|
|
||||||
|
预期: `{ "code": 200, "msg": "操作成功" }`
|
||||||
|
|
||||||
|
**Step 2: 验证数据已删除**
|
||||||
|
|
||||||
|
```sql
|
||||||
|
SELECT * FROM ccdi_biz_intermediary
|
||||||
|
WHERE biz_id = 1;
|
||||||
|
```
|
||||||
|
|
||||||
|
预期: 0条记录
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 功能测试 - 机构中介
|
||||||
|
|
||||||
|
### Task 7: 测试机构中介新增功能
|
||||||
|
|
||||||
|
**Files:**
|
||||||
|
- Test API: `POST /ccdi/intermediary/entity`
|
||||||
|
- Backend: `CcdiIntermediaryBlacklistServiceImpl.insertEntityIntermediary()`
|
||||||
|
|
||||||
|
**Step 1: 准备测试数据**
|
||||||
|
|
||||||
|
创建 `test_entity_add.json`:
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"name": "测试机构中介有限公司",
|
||||||
|
"corpCreditCode": "91110000123456789X",
|
||||||
|
"corpType": "有限责任公司",
|
||||||
|
"corpNature": "民营企业",
|
||||||
|
"corpIndustryCategory": "制造业",
|
||||||
|
"corpIndustry": "通用设备制造业",
|
||||||
|
"corpEstablishDate": "2020-01-01T00:00:00",
|
||||||
|
"corpAddress": "北京市海淀区测试大街456号",
|
||||||
|
"corpLegalRep": "张三",
|
||||||
|
"corpLegalCertType": "身份证",
|
||||||
|
"corpLegalCertNo": "110101198001011234",
|
||||||
|
"corpShareholder1": "股东A",
|
||||||
|
"corpShareholder2": "股东B",
|
||||||
|
"status": "0",
|
||||||
|
"remark": "机构中介测试数据"
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
**Step 2: 调用新增接口**
|
||||||
|
|
||||||
|
```bash
|
||||||
|
curl -X POST http://localhost:8080/ccdi/intermediary/entity \
|
||||||
|
-H "Authorization: Bearer $TOKEN" \
|
||||||
|
-H "Content-Type: application/json" \
|
||||||
|
-d @test_entity_add.json
|
||||||
|
```
|
||||||
|
|
||||||
|
预期: `{ "code": 200, "msg": "操作成功" }`
|
||||||
|
|
||||||
|
**Step 3: 验证数据插入到正确的表**
|
||||||
|
|
||||||
|
```sql
|
||||||
|
SELECT * FROM ccdi_enterprise_base_info
|
||||||
|
WHERE social_credit_code = '91110000123456789X';
|
||||||
|
```
|
||||||
|
|
||||||
|
预期:
|
||||||
|
- 找到1条记录
|
||||||
|
- enterprise_name = '测试机构中介有限公司'
|
||||||
|
- **risk_level = '1' (高风险)** ✅
|
||||||
|
- **ent_source = 'INTERMEDIARY' (中介来源)** ✅
|
||||||
|
- data_source = 'MANUAL'
|
||||||
|
|
||||||
|
**Step 4: 验证关键字段自动设置**
|
||||||
|
|
||||||
|
检查两个重要标识:
|
||||||
|
```sql
|
||||||
|
SELECT
|
||||||
|
social_credit_code,
|
||||||
|
enterprise_name,
|
||||||
|
risk_level,
|
||||||
|
ent_source,
|
||||||
|
data_source
|
||||||
|
FROM ccdi_enterprise_base_info
|
||||||
|
WHERE social_credit_code = '91110000123456789X';
|
||||||
|
```
|
||||||
|
|
||||||
|
预期:
|
||||||
|
- risk_level = '1' ✅
|
||||||
|
- ent_source = 'INTERMEDIARY' ✅
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### Task 8: 测试机构中介列表查询
|
||||||
|
|
||||||
|
**Files:**
|
||||||
|
- Test API: `GET /ccdi/intermediary/list`
|
||||||
|
|
||||||
|
**Step 1: 查询机构中介**
|
||||||
|
|
||||||
|
```bash
|
||||||
|
curl -X GET "http://localhost:8080/ccdi/intermediary/list?intermediaryType=2&name=测试机构" \
|
||||||
|
-H "Authorization: Bearer $TOKEN"
|
||||||
|
```
|
||||||
|
|
||||||
|
预期响应:
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"code": 200,
|
||||||
|
"rows": [
|
||||||
|
{
|
||||||
|
"intermediaryId": 0,
|
||||||
|
"name": "测试机构中介有限公司",
|
||||||
|
"certificateNo": "91110000123456789X",
|
||||||
|
"intermediaryType": "2",
|
||||||
|
"intermediaryTypeName": "机构",
|
||||||
|
"status": "0",
|
||||||
|
"statusName": "正常"
|
||||||
|
}
|
||||||
|
]
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
**Step 2: 验证ent_source过滤**
|
||||||
|
|
||||||
|
查询应该只返回 ent_source='INTERMEDIARY' 的记录
|
||||||
|
|
||||||
|
**Step 3: 混合查询(个人+机构)**
|
||||||
|
|
||||||
|
```bash
|
||||||
|
curl -X GET "http://localhost:8080/ccdi/intermediary/list" \
|
||||||
|
-H "Authorization: Bearer $TOKEN"
|
||||||
|
```
|
||||||
|
|
||||||
|
预期: 返回个人和机构中介的合并列表
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### Task 9: 测试机构中介详情查询
|
||||||
|
|
||||||
|
**Files:**
|
||||||
|
- Test API: `GET /ccdi/intermediary/{id}`
|
||||||
|
|
||||||
|
**Step 1: 获取机构中介详情**
|
||||||
|
|
||||||
|
注意: 机构中介的ID需要特殊处理(社会信用代码)
|
||||||
|
|
||||||
|
**Step 2: 验证机构字段映射**
|
||||||
|
|
||||||
|
检查字段映射:
|
||||||
|
- corpCreditCode → social_credit_code ✅
|
||||||
|
- name → enterprise_name ✅
|
||||||
|
- corpType → enterprise_type ✅
|
||||||
|
- corpNature → enterprise_nature ✅
|
||||||
|
- corpIndustryCategory → industry_class ✅
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### Task 10: 测试机构中介修改功能
|
||||||
|
|
||||||
|
**Files:**
|
||||||
|
- Test API: `PUT /ccdi/intermediary/entity`
|
||||||
|
|
||||||
|
**Step 1: 准备修改数据**
|
||||||
|
|
||||||
|
创建 `test_entity_edit.json`:
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"corpCreditCode": "91110000123456789X",
|
||||||
|
"name": "测试机构中介有限公司-已修改",
|
||||||
|
"corpType": "股份有限公司",
|
||||||
|
"corpNature": "国有企业",
|
||||||
|
"status": "0",
|
||||||
|
"remark": "已修改"
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
**Step 2: 调用修改接口**
|
||||||
|
|
||||||
|
```bash
|
||||||
|
curl -X PUT http://localhost:8080/ccdi/intermediary/entity \
|
||||||
|
-H "Authorization: Bearer $TOKEN" \
|
||||||
|
-H "Content-Type: application/json" \
|
||||||
|
-d @test_entity_edit.json
|
||||||
|
```
|
||||||
|
|
||||||
|
预期: `{ "code": 200, "msg": "操作成功" }`
|
||||||
|
|
||||||
|
**Step 3: 验证高风险和中介来源标识不变**
|
||||||
|
|
||||||
|
```sql
|
||||||
|
SELECT
|
||||||
|
social_credit_code,
|
||||||
|
enterprise_name,
|
||||||
|
risk_level,
|
||||||
|
ent_source
|
||||||
|
FROM ccdi_enterprise_base_info
|
||||||
|
WHERE social_credit_code = '91110000123456789X';
|
||||||
|
```
|
||||||
|
|
||||||
|
预期:
|
||||||
|
- enterprise_name = '测试机构中介有限公司-已修改'
|
||||||
|
- risk_level 仍为 '1' ✅ (保持不变)
|
||||||
|
- ent_source 仍为 'INTERMEDIARY' ✅ (保持不变)
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 导入功能测试
|
||||||
|
|
||||||
|
### Task 11: 测试个人中介Excel导入
|
||||||
|
|
||||||
|
**Files:**
|
||||||
|
- Test API: `POST /ccdi/intermediary/importPersonData`
|
||||||
|
|
||||||
|
**Step 1: 下载导入模板**
|
||||||
|
|
||||||
|
```bash
|
||||||
|
curl -X POST http://localhost:8080/ccdi/intermediary/importPersonTemplate \
|
||||||
|
-H "Authorization: Bearer $TOKEN" \
|
||||||
|
--output person_template.xlsx
|
||||||
|
```
|
||||||
|
|
||||||
|
预期: 下载成功,文件包含所有个人字段
|
||||||
|
|
||||||
|
**Step 2: 准备测试Excel文件**
|
||||||
|
|
||||||
|
手动创建Excel文件或使用EasyExcel生成测试数据,包含:
|
||||||
|
- 姓名: "导入测试个人"
|
||||||
|
- 证件号: "110101199002022345"
|
||||||
|
- 人员类型: "中介"
|
||||||
|
- 性别: "M"
|
||||||
|
- 手机号: "13800138001"
|
||||||
|
- 微信号: "import_wx001"
|
||||||
|
|
||||||
|
**Step 3: 执行导入**
|
||||||
|
|
||||||
|
```bash
|
||||||
|
curl -X POST "http://localhost:8080/ccdi/intermediary/importPersonData?updateSupport=false" \
|
||||||
|
-H "Authorization: Bearer $TOKEN" \
|
||||||
|
-F "file=@person_test_data.xlsx"
|
||||||
|
```
|
||||||
|
|
||||||
|
预期:
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"code": 200,
|
||||||
|
"msg": "恭喜您,数据已全部导入成功!共 1 条"
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
**Step 4: 验证导入数据**
|
||||||
|
|
||||||
|
```sql
|
||||||
|
SELECT * FROM ccdi_biz_intermediary
|
||||||
|
WHERE person_id = '110101199002022345';
|
||||||
|
```
|
||||||
|
|
||||||
|
预期:
|
||||||
|
- 找到1条记录
|
||||||
|
- date_source = 'IMPORT' ✅
|
||||||
|
- name = '导入测试个人'
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### Task 12: 测试机构中介Excel导入
|
||||||
|
|
||||||
|
**Files:**
|
||||||
|
- Test API: `POST /ccdi/intermediary/importEntityData`
|
||||||
|
|
||||||
|
**Step 1: 下载导入模板**
|
||||||
|
|
||||||
|
```bash
|
||||||
|
curl -X POST http://localhost:8080/ccdi/intermediary/importEntityTemplate \
|
||||||
|
-H "Authorization: Bearer $TOKEN" \
|
||||||
|
--output entity_template.xlsx
|
||||||
|
```
|
||||||
|
|
||||||
|
预期: 下载成功,文件包含所有机构字段
|
||||||
|
|
||||||
|
**Step 2: 准备测试Excel文件**
|
||||||
|
|
||||||
|
创建Excel文件,包含:
|
||||||
|
- 机构名称: "导入测试机构有限公司"
|
||||||
|
- 统一社会信用代码: "91110000987654321A"
|
||||||
|
- 主体类型: "有限责任公司"
|
||||||
|
- 企业性质: "民营企业"
|
||||||
|
- 法定代表人: "李四"
|
||||||
|
|
||||||
|
**Step 3: 执行导入**
|
||||||
|
|
||||||
|
```bash
|
||||||
|
curl -X POST "http://localhost:8080/ccdi/intermediary/importEntityData?updateSupport=false" \
|
||||||
|
-H "Authorization: Bearer $TOKEN" \
|
||||||
|
-F "file=@entity_test_data.xlsx"
|
||||||
|
```
|
||||||
|
|
||||||
|
预期:
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"code": 200,
|
||||||
|
"msg": "恭喜您,数据已全部导入成功!共 1 条"
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
**Step 4: 验证导入数据和自动设置标识**
|
||||||
|
|
||||||
|
```sql
|
||||||
|
SELECT
|
||||||
|
social_credit_code,
|
||||||
|
enterprise_name,
|
||||||
|
risk_level,
|
||||||
|
ent_source,
|
||||||
|
data_source
|
||||||
|
FROM ccdi_enterprise_base_info
|
||||||
|
WHERE social_credit_code = '91110000987654321A';
|
||||||
|
```
|
||||||
|
|
||||||
|
预期:
|
||||||
|
- enterprise_name = '导入测试机构有限公司'
|
||||||
|
- **risk_level = '1' (高风险)** ✅
|
||||||
|
- **ent_source = 'INTERMEDIARY' (中介来源)** ✅
|
||||||
|
- data_source = 'IMPORT' ✅
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 导出功能测试
|
||||||
|
|
||||||
|
### Task 13: 测试中介数据导出
|
||||||
|
|
||||||
|
**Files:**
|
||||||
|
- Test API: `POST /ccdi/intermediary/export`
|
||||||
|
|
||||||
|
**Step 1: 导出所有数据**
|
||||||
|
|
||||||
|
```bash
|
||||||
|
curl -X POST "http://localhost:8080/ccdi/intermediary/export" \
|
||||||
|
-H "Authorization: Bearer $TOKEN" \
|
||||||
|
-H "Content-Type: application/json" \
|
||||||
|
-d '{}' \
|
||||||
|
--output intermediary_export.xlsx
|
||||||
|
```
|
||||||
|
|
||||||
|
预期: 下载成功,Excel文件包含个人和机构数据
|
||||||
|
|
||||||
|
**Step 2: 验证导出数据完整性**
|
||||||
|
|
||||||
|
打开Excel文件,验证:
|
||||||
|
- 包含个人中介字段(indivType, indivGender等)
|
||||||
|
- 包含机构中介字段(corpType, corpNature等)
|
||||||
|
- 数据正确映射
|
||||||
|
|
||||||
|
**Step 3: 测试条件导出**
|
||||||
|
|
||||||
|
```bash
|
||||||
|
curl -X POST "http://localhost:8080/ccdi/intermediary/export" \
|
||||||
|
-H "Authorization: Bearer $TOKEN" \
|
||||||
|
-H "Content-Type: application/json" \
|
||||||
|
-d '{"intermediaryType":"1"}' \
|
||||||
|
--output person_export.xlsx
|
||||||
|
```
|
||||||
|
|
||||||
|
预期: 只导出个人中介数据
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 边界条件测试
|
||||||
|
|
||||||
|
### Task 14: 测试唯一性约束
|
||||||
|
|
||||||
|
**Step 1: 个人中介证件号重复插入**
|
||||||
|
|
||||||
|
尝试插入相同person_id的记录:
|
||||||
|
```bash
|
||||||
|
# 使用Task 2的数据再次执行
|
||||||
|
curl -X POST http://localhost:8080/ccdi/intermediary/person \
|
||||||
|
-H "Authorization: Bearer $TOKEN" \
|
||||||
|
-H "Content-Type: application/json" \
|
||||||
|
-d @test_person_add.json
|
||||||
|
```
|
||||||
|
|
||||||
|
预期: 根据实际业务逻辑,可能报唯一性约束错误或允许插入
|
||||||
|
|
||||||
|
**Step 2: 机构中介社会信用代码重复插入**
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# 使用Task 7的数据再次执行
|
||||||
|
curl -X POST http://localhost:8080/ccdi/intermediary/entity \
|
||||||
|
-H "Authorization: Bearer $TOKEN" \
|
||||||
|
-H "Content-Type: application/json" \
|
||||||
|
-d @test_entity_add.json
|
||||||
|
```
|
||||||
|
|
||||||
|
预期: 报主键冲突错误(社会信用代码是主键)
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### Task 15: 测试必填字段验证
|
||||||
|
|
||||||
|
**Step 1: 缺少姓名的个人中介**
|
||||||
|
|
||||||
|
创建 `test_person_no_name.json`:
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"certificateNo": "110101199003033456",
|
||||||
|
"status": "0"
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
```bash
|
||||||
|
curl -X POST http://localhost:8080/ccdi/intermediary/person \
|
||||||
|
-H "Authorization: Bearer $TOKEN" \
|
||||||
|
-H "Content-Type: application/json" \
|
||||||
|
-d @test_person_no_name.json
|
||||||
|
```
|
||||||
|
|
||||||
|
预期: 返回验证错误,提示"姓名不能为空"
|
||||||
|
|
||||||
|
**Step 2: 缺少统一社会信用代码的机构中介**
|
||||||
|
|
||||||
|
创建 `test_entity_no_code.json`:
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"name": "测试机构",
|
||||||
|
"status": "0"
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
```bash
|
||||||
|
curl -X POST http://localhost:8080/ccdi/intermediary/entity \
|
||||||
|
-H "Authorization: Bearer $TOKEN" \
|
||||||
|
-H "Content-Type: application/json" \
|
||||||
|
-d @test_entity_no_code.json
|
||||||
|
```
|
||||||
|
|
||||||
|
预期: 返回验证错误,提示"统一社会信用代码不能为空"
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 性能测试
|
||||||
|
|
||||||
|
### Task 16: 批量数据导入性能测试
|
||||||
|
|
||||||
|
**Step 1: 准备批量测试数据**
|
||||||
|
|
||||||
|
创建包含100条个人中介的Excel文件
|
||||||
|
|
||||||
|
**Step 2: 执行批量导入**
|
||||||
|
|
||||||
|
```bash
|
||||||
|
time curl -X POST "http://localhost:8080/ccdi/intermediary/importPersonData?updateSupport=false" \
|
||||||
|
-H "Authorization: Bearer $TOKEN" \
|
||||||
|
-F "file=@person_batch_100.xlsx"
|
||||||
|
```
|
||||||
|
|
||||||
|
预期:
|
||||||
|
- 导入成功
|
||||||
|
- 耗时 < 10秒
|
||||||
|
|
||||||
|
**Step 3: 验证数据一致性**
|
||||||
|
|
||||||
|
```sql
|
||||||
|
SELECT COUNT(*) FROM ccdi_biz_intermediary
|
||||||
|
WHERE date_source = 'IMPORT';
|
||||||
|
```
|
||||||
|
|
||||||
|
预期: 导入的记录数与Excel文件一致
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 清理测试数据
|
||||||
|
|
||||||
|
### Task 17: 清理测试数据
|
||||||
|
|
||||||
|
**Step 1: 删除测试个人中介数据**
|
||||||
|
|
||||||
|
```sql
|
||||||
|
DELETE FROM ccdi_biz_intermediary
|
||||||
|
WHERE person_id IN (
|
||||||
|
'110101199001011234',
|
||||||
|
'110101199002022345'
|
||||||
|
);
|
||||||
|
```
|
||||||
|
|
||||||
|
**Step 2: 删除测试机构中介数据**
|
||||||
|
|
||||||
|
```sql
|
||||||
|
DELETE FROM ccdi_enterprise_base_info
|
||||||
|
WHERE social_credit_code IN (
|
||||||
|
'91110000123456789X',
|
||||||
|
'91110000987654321A'
|
||||||
|
);
|
||||||
|
```
|
||||||
|
|
||||||
|
**Step 3: 验证清理完成**
|
||||||
|
|
||||||
|
```sql
|
||||||
|
SELECT COUNT(*) FROM ccdi_biz_intermediary
|
||||||
|
WHERE person_id LIKE '110101199%';
|
||||||
|
|
||||||
|
SELECT COUNT(*) FROM ccdi_enterprise_base_info
|
||||||
|
WHERE social_credit_code LIKE '91110000%';
|
||||||
|
```
|
||||||
|
|
||||||
|
预期: 0条测试记录
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 测试报告生成
|
||||||
|
|
||||||
|
### Task 18: 生成测试报告
|
||||||
|
|
||||||
|
**Step 1: 汇总测试结果**
|
||||||
|
|
||||||
|
创建测试报告文件 `test_report.md`:
|
||||||
|
|
||||||
|
```markdown
|
||||||
|
# 中介黑名单入库逻辑变更测试报告
|
||||||
|
|
||||||
|
## 测试环境
|
||||||
|
- 数据库: MySQL 8.2.0
|
||||||
|
- 服务端口: 8080
|
||||||
|
- 测试时间: 2026-02-04
|
||||||
|
|
||||||
|
## 功能测试结果
|
||||||
|
|
||||||
|
### 个人中介
|
||||||
|
- ✅ 新增功能 - 数据正确插入 ccdi_biz_intermediary
|
||||||
|
- ✅ 列表查询 - 正确返回个人中介数据
|
||||||
|
- ✅ 详情查询 - 所有字段正确映射
|
||||||
|
- ✅ 修改功能 - 数据正确更新
|
||||||
|
- ✅ 删除功能 - 数据正确删除
|
||||||
|
- ✅ Excel导入 - 批量导入成功,data_source='IMPORT'
|
||||||
|
- ✅ Excel导出 - 数据完整导出
|
||||||
|
|
||||||
|
### 机构中介
|
||||||
|
- ✅ 新增功能 - 数据正确插入 ccdi_enterprise_base_info
|
||||||
|
- ✅ 自动设置标识 - risk_level='1', ent_source='INTERMEDIARY'
|
||||||
|
- ✅ 列表查询 - 正确返回机构中介数据
|
||||||
|
- ✅ 详情查询 - 所有字段正确映射
|
||||||
|
- ✅ 修改功能 - 数据正确更新,标识保持不变
|
||||||
|
- ✅ Excel导入 - 批量导入成功,自动设置高风险和中介来源
|
||||||
|
- ✅ Excel导出 - 数据完整导出
|
||||||
|
|
||||||
|
### 边界条件
|
||||||
|
- ✅ 唯一性约束 - 社会信用代码主键冲突
|
||||||
|
- ✅ 必填字段验证 - 姓名和证件号验证生效
|
||||||
|
|
||||||
|
### 性能测试
|
||||||
|
- ✅ 100条数据导入 - 耗时 < 10秒
|
||||||
|
|
||||||
|
## 数据映射验证
|
||||||
|
|
||||||
|
### 个人中介字段映射
|
||||||
|
| 原字段 | 新字段 | 状态 |
|
||||||
|
|--------|--------|------|
|
||||||
|
| intermediary_id | biz_id | ✅ |
|
||||||
|
| certificate_no | person_id | ✅ |
|
||||||
|
| indiv_type | person_type | ✅ |
|
||||||
|
| indiv_gender | gender | ✅ |
|
||||||
|
| indiv_phone | mobile | ✅ |
|
||||||
|
| indiv_wechat | wechat_no | ✅ |
|
||||||
|
| indiv_address | contact_address | ✅ |
|
||||||
|
|
||||||
|
### 机构中介字段映射
|
||||||
|
| 原字段 | 新字段 | 状态 |
|
||||||
|
|--------|--------|------|
|
||||||
|
| corp_credit_code | social_credit_code | ✅ |
|
||||||
|
| name | enterprise_name | ✅ |
|
||||||
|
| corp_type | enterprise_type | ✅ |
|
||||||
|
| corp_nature | enterprise_nature | ✅ |
|
||||||
|
| - | risk_level='1' | ✅ 自动设置 |
|
||||||
|
| - | ent_source='INTERMEDIARY' | ✅ 自动设置 |
|
||||||
|
|
||||||
|
## 结论
|
||||||
|
✅ 所有测试通过,入库逻辑变更成功!
|
||||||
|
```
|
||||||
|
|
||||||
|
**Step 2: 提交测试报告**
|
||||||
|
|
||||||
|
```bash
|
||||||
|
git add test_report.md
|
||||||
|
git commit -m "test: 添加中介黑名单变更测试报告"
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 注意事项
|
||||||
|
|
||||||
|
1. **机构中介ID处理**: 机构中介的主键是字符串类型(social_credit_code),查询详情时需要特殊处理
|
||||||
|
|
||||||
|
2. **自动设置标识**: 机构中介新增/导入时自动设置 `risk_level='1'` 和 `ent_source='INTERMEDIARY'`,修改时不应改变这两个值
|
||||||
|
|
||||||
|
3. **查询合并**: 列表查询需要从两个表获取数据并合并返回前端
|
||||||
|
|
||||||
|
4. **数据来源标识**:
|
||||||
|
- 手动新增: date_source/data_source = 'MANUAL'
|
||||||
|
- Excel导入: date_source/data_source = 'IMPORT'
|
||||||
|
|
||||||
|
5. **分页查询**: 当前实现是先查询所有数据再手动分页,大数据量时可能需要优化
|
||||||
|
|
||||||
|
6. **删除操作**: 当前只支持个人中介的数字ID删除,机构中介删除需要扩展支持
|
||||||
177
doc/scripts/cleanup-intermediary-test-data.sh
Normal file
177
doc/scripts/cleanup-intermediary-test-data.sh
Normal file
@@ -0,0 +1,177 @@
|
|||||||
|
#!/bin/bash
|
||||||
|
|
||||||
|
################################################################################
|
||||||
|
# 中介黑名单管理测试数据清理脚本
|
||||||
|
# 功能: 清理测试脚本创建的测试数据
|
||||||
|
# 作者: Claude Code
|
||||||
|
# 日期: 2026-02-04
|
||||||
|
################################################################################
|
||||||
|
|
||||||
|
# 颜色定义
|
||||||
|
RED='\033[0;31m'
|
||||||
|
GREEN='\033[0;32m'
|
||||||
|
YELLOW='\033[1;33m'
|
||||||
|
NC='\033[0m' # No Color
|
||||||
|
|
||||||
|
# 配置
|
||||||
|
BASE_URL="http://localhost:8080"
|
||||||
|
TEST_USERNAME="admin"
|
||||||
|
TEST_PASSWORD="admin123"
|
||||||
|
|
||||||
|
# 输出函数
|
||||||
|
print_header() {
|
||||||
|
echo ""
|
||||||
|
echo "========================================"
|
||||||
|
echo "$1"
|
||||||
|
echo "========================================"
|
||||||
|
}
|
||||||
|
|
||||||
|
print_section() {
|
||||||
|
echo ""
|
||||||
|
echo -e "${YELLOW}=== $1 ===${NC}"
|
||||||
|
}
|
||||||
|
|
||||||
|
print_success() {
|
||||||
|
echo -e "${GREEN}✓ $1${NC}"
|
||||||
|
}
|
||||||
|
|
||||||
|
print_error() {
|
||||||
|
echo -e "${RED}✗ $1${NC}"
|
||||||
|
}
|
||||||
|
|
||||||
|
# 获取Token
|
||||||
|
get_token() {
|
||||||
|
print_section "获取Token"
|
||||||
|
|
||||||
|
TOKEN=$(curl -s -X POST "${BASE_URL}/login/test" \
|
||||||
|
-H "Content-Type: application/json" \
|
||||||
|
-d "{\"username\":\"${TEST_USERNAME}\",\"password\":\"${TEST_PASSWORD}\"}" | jq -r '.data.token')
|
||||||
|
|
||||||
|
if [ "$TOKEN" != "null" ] && [ -n "$TOKEN" ]; then
|
||||||
|
print_success "Token获取成功"
|
||||||
|
else
|
||||||
|
print_error "Token获取失败"
|
||||||
|
exit 1
|
||||||
|
fi
|
||||||
|
}
|
||||||
|
|
||||||
|
# 查询测试数据
|
||||||
|
query_test_data() {
|
||||||
|
print_section "查询测试数据"
|
||||||
|
|
||||||
|
echo "查询测试个人中介:"
|
||||||
|
PERSON_RESPONSE=$(curl -s -X GET "${BASE_URL}/ccdi/intermediary/list?name=测试中介个人&intermediaryType=1" \
|
||||||
|
-H "Authorization: Bearer $TOKEN")
|
||||||
|
|
||||||
|
echo "$PERSON_RESPONSE" | jq '.'
|
||||||
|
|
||||||
|
PERSON_IDS=$(echo "$PERSON_RESPONSE" | jq -r '.rows[].bizId // empty')
|
||||||
|
|
||||||
|
echo ""
|
||||||
|
echo "查询测试实体中介:"
|
||||||
|
ENTITY_RESPONSE=$(curl -s -X GET "${BASE_URL}/ccdi/intermediary/list?name=测试中介公司&intermediaryType=2" \
|
||||||
|
-H "Authorization: Bearer $TOKEN")
|
||||||
|
|
||||||
|
echo "$ENTITY_RESPONSE" | jq '.'
|
||||||
|
|
||||||
|
ENTITY_IDS=$(echo "$ENTITY_RESPONSE" | jq -r '.rows[].bizId // empty')
|
||||||
|
}
|
||||||
|
|
||||||
|
# 删除测试数据
|
||||||
|
delete_test_data() {
|
||||||
|
print_section "删除测试数据"
|
||||||
|
|
||||||
|
# 删除测试个人中介
|
||||||
|
if [ -n "$PERSON_IDS" ]; then
|
||||||
|
echo "删除测试个人中介: $PERSON_IDS"
|
||||||
|
DELETE_RESPONSE=$(curl -s -X DELETE "${BASE_URL}/ccdi/intermediary/${PERSON_IDS}" \
|
||||||
|
-H "Authorization: Bearer $TOKEN")
|
||||||
|
|
||||||
|
echo "$DELETE_RESPONSE" | jq '.'
|
||||||
|
|
||||||
|
code=$(echo "$DELETE_RESPONSE" | jq -r '.code')
|
||||||
|
if [ "$code" == "200" ]; then
|
||||||
|
print_success "测试个人中介删除成功"
|
||||||
|
else
|
||||||
|
print_error "测试个人中介删除失败"
|
||||||
|
fi
|
||||||
|
else
|
||||||
|
echo "没有找到测试个人中介数据"
|
||||||
|
fi
|
||||||
|
|
||||||
|
# 删除测试实体中介
|
||||||
|
if [ -n "$ENTITY_IDS" ]; then
|
||||||
|
echo ""
|
||||||
|
echo "删除测试实体中介: $ENTITY_IDS"
|
||||||
|
DELETE_RESPONSE=$(curl -s -X DELETE "${BASE_URL}/ccdi/intermediary/${ENTITY_IDS}" \
|
||||||
|
-H "Authorization: Bearer $TOKEN")
|
||||||
|
|
||||||
|
echo "$DELETE_RESPONSE" | jq '.'
|
||||||
|
|
||||||
|
code=$(echo "$DELETE_RESPONSE" | jq -r '.code')
|
||||||
|
if [ "$code" == "200" ]; then
|
||||||
|
print_success "测试实体中介删除成功"
|
||||||
|
else
|
||||||
|
print_error "测试实体中介删除失败"
|
||||||
|
fi
|
||||||
|
else
|
||||||
|
echo ""
|
||||||
|
echo "没有找到测试实体中介数据"
|
||||||
|
fi
|
||||||
|
}
|
||||||
|
|
||||||
|
# 验证删除结果
|
||||||
|
verify_deletion() {
|
||||||
|
print_section "验证删除结果"
|
||||||
|
|
||||||
|
echo "验证测试个人中介是否已删除:"
|
||||||
|
VERIFY_PERSON=$(curl -s -X GET "${BASE_URL}/ccdi/intermediary/list?name=测试中介个人&intermediaryType=1" \
|
||||||
|
-H "Authorization: Bearer $TOKEN")
|
||||||
|
|
||||||
|
TOTAL=$(echo "$VERIFY_PERSON" | jq -r '.total')
|
||||||
|
if [ "$TOTAL" == "0" ]; then
|
||||||
|
print_success "测试个人中介已全部删除"
|
||||||
|
else
|
||||||
|
print_error "仍有 $TOTAL 条测试个人中介数据未删除"
|
||||||
|
fi
|
||||||
|
|
||||||
|
echo ""
|
||||||
|
echo "验证测试实体中介是否已删除:"
|
||||||
|
VERIFY_ENTITY=$(curl -s -X GET "${BASE_URL}/ccdi/intermediary/list?name=测试中介公司&intermediaryType=2" \
|
||||||
|
-H "Authorization: Bearer $TOKEN")
|
||||||
|
|
||||||
|
TOTAL=$(echo "$VERIFY_ENTITY" | jq -r '.total')
|
||||||
|
if [ "$TOTAL" == "0" ]; then
|
||||||
|
print_success "测试实体中介已全部删除"
|
||||||
|
else
|
||||||
|
print_error "仍有 $TOTAL 条测试实体中介数据未删除"
|
||||||
|
fi
|
||||||
|
}
|
||||||
|
|
||||||
|
# 主函数
|
||||||
|
main() {
|
||||||
|
print_header "中介黑名单测试数据清理开始"
|
||||||
|
|
||||||
|
# 检查jq命令
|
||||||
|
if ! command -v jq &> /dev/null; then
|
||||||
|
print_error "jq命令未安装,请先安装: apt-get install jq 或 yum install jq"
|
||||||
|
exit 1
|
||||||
|
fi
|
||||||
|
|
||||||
|
# 获取Token
|
||||||
|
get_token
|
||||||
|
|
||||||
|
# 查询测试数据
|
||||||
|
query_test_data
|
||||||
|
|
||||||
|
# 删除测试数据
|
||||||
|
delete_test_data
|
||||||
|
|
||||||
|
# 验证删除结果
|
||||||
|
verify_deletion
|
||||||
|
|
||||||
|
print_header "清理完成"
|
||||||
|
}
|
||||||
|
|
||||||
|
# 执行主函数
|
||||||
|
main
|
||||||
33
doc/scripts/run-cleanup.bat
Normal file
33
doc/scripts/run-cleanup.bat
Normal file
@@ -0,0 +1,33 @@
|
|||||||
|
@echo off
|
||||||
|
REM =====================================================
|
||||||
|
REM 中介黑名单管理 测试数据清理脚本 (Windows版本)
|
||||||
|
REM 功能: 在Windows上清理测试数据
|
||||||
|
REM 作者: Claude Code
|
||||||
|
REM 日期: 2026-02-04
|
||||||
|
REM =====================================================
|
||||||
|
|
||||||
|
echo ========================================
|
||||||
|
echo 中介黑名单测试数据清理
|
||||||
|
echo ========================================
|
||||||
|
echo.
|
||||||
|
|
||||||
|
REM 检查Git Bash是否安装
|
||||||
|
where bash >nul 2>nul
|
||||||
|
if %ERRORLEVEL% NEQ 0 (
|
||||||
|
echo 错误: 未找到Git Bash
|
||||||
|
echo 请安装Git for Windows或在Git Bash中运行此脚本
|
||||||
|
pause
|
||||||
|
exit /b 1
|
||||||
|
)
|
||||||
|
|
||||||
|
REM 执行清理脚本
|
||||||
|
echo 正在清理测试数据...
|
||||||
|
echo.
|
||||||
|
bash "D:/ccdi/ccdi/doc/scripts/cleanup-intermediary-test-data.sh"
|
||||||
|
|
||||||
|
echo.
|
||||||
|
echo ========================================
|
||||||
|
echo 清理完成
|
||||||
|
echo ========================================
|
||||||
|
echo.
|
||||||
|
pause
|
||||||
33
doc/scripts/run-test.bat
Normal file
33
doc/scripts/run-test.bat
Normal file
@@ -0,0 +1,33 @@
|
|||||||
|
@echo off
|
||||||
|
REM =====================================================
|
||||||
|
REM 中介黑名单管理 API 测试脚本 (Windows版本)
|
||||||
|
REM 功能: 在Windows上执行API测试
|
||||||
|
REM 作者: Claude Code
|
||||||
|
REM 日期: 2026-02-04
|
||||||
|
REM =====================================================
|
||||||
|
|
||||||
|
echo ========================================
|
||||||
|
echo 中介黑名单管理 API 测试
|
||||||
|
echo ========================================
|
||||||
|
echo.
|
||||||
|
|
||||||
|
REM 检查Git Bash是否安装
|
||||||
|
where bash >nul 2>nul
|
||||||
|
if %ERRORLEVEL% NEQ 0 (
|
||||||
|
echo 错误: 未找到Git Bash
|
||||||
|
echo 请安装Git for Windows或在Git Bash中运行此脚本
|
||||||
|
pause
|
||||||
|
exit /b 1
|
||||||
|
)
|
||||||
|
|
||||||
|
REM 执行测试脚本
|
||||||
|
echo 正在执行API测试...
|
||||||
|
echo.
|
||||||
|
bash "D:/ccdi/ccdi/doc/scripts/test-intermediary-api.sh"
|
||||||
|
|
||||||
|
echo.
|
||||||
|
echo ========================================
|
||||||
|
echo 测试完成
|
||||||
|
echo ========================================
|
||||||
|
echo.
|
||||||
|
pause
|
||||||
363
doc/scripts/test-intermediary-api.sh
Normal file
363
doc/scripts/test-intermediary-api.sh
Normal file
@@ -0,0 +1,363 @@
|
|||||||
|
#!/bin/bash
|
||||||
|
|
||||||
|
################################################################################
|
||||||
|
# 中介黑名单管理 API 测试脚本
|
||||||
|
# 功能: 测试中介黑名单管理模块的所有接口
|
||||||
|
# 作者: Claude Code
|
||||||
|
# 日期: 2026-02-04
|
||||||
|
################################################################################
|
||||||
|
|
||||||
|
# 颜色定义
|
||||||
|
RED='\033[0;31m'
|
||||||
|
GREEN='\033[0;32m'
|
||||||
|
YELLOW='\033[1;33m'
|
||||||
|
NC='\033[0m' # No Color
|
||||||
|
|
||||||
|
# 配置
|
||||||
|
BASE_URL="http://localhost:8080"
|
||||||
|
TEST_USERNAME="admin"
|
||||||
|
TEST_PASSWORD="admin123"
|
||||||
|
|
||||||
|
# 输出函数
|
||||||
|
print_header() {
|
||||||
|
echo ""
|
||||||
|
echo "========================================"
|
||||||
|
echo "$1"
|
||||||
|
echo "========================================"
|
||||||
|
}
|
||||||
|
|
||||||
|
print_section() {
|
||||||
|
echo ""
|
||||||
|
echo -e "${YELLOW}=== $1 ===${NC}"
|
||||||
|
}
|
||||||
|
|
||||||
|
print_success() {
|
||||||
|
echo -e "${GREEN}✓ $1${NC}"
|
||||||
|
}
|
||||||
|
|
||||||
|
print_error() {
|
||||||
|
echo -e "${RED}✗ $1${NC}"
|
||||||
|
}
|
||||||
|
|
||||||
|
# 获取Token
|
||||||
|
get_token() {
|
||||||
|
print_section "获取Token"
|
||||||
|
|
||||||
|
TOKEN=$(curl -s -X POST "${BASE_URL}/login/test" \
|
||||||
|
-H "Content-Type: application/json" \
|
||||||
|
-d "{\"username\":\"${TEST_USERNAME}\",\"password\":\"${TEST_PASSWORD}\"}" | jq -r '.data.token')
|
||||||
|
|
||||||
|
if [ "$TOKEN" != "null" ] && [ -n "$TOKEN" ]; then
|
||||||
|
print_success "Token获取成功: ${TOKEN:0:20}..."
|
||||||
|
echo "$TOKEN"
|
||||||
|
else
|
||||||
|
print_error "Token获取失败"
|
||||||
|
exit 1
|
||||||
|
fi
|
||||||
|
}
|
||||||
|
|
||||||
|
# 测试查询列表
|
||||||
|
test_list() {
|
||||||
|
print_section "测试查询列表"
|
||||||
|
|
||||||
|
response=$(curl -s -X GET "${BASE_URL}/ccdi/intermediary/list?pageNum=1&pageSize=10" \
|
||||||
|
-H "Authorization: Bearer $TOKEN")
|
||||||
|
|
||||||
|
echo "$response" | jq '.'
|
||||||
|
code=$(echo "$response" | jq -r '.code')
|
||||||
|
|
||||||
|
if [ "$code" == "200" ]; then
|
||||||
|
print_success "查询列表成功"
|
||||||
|
total=$(echo "$response" | jq -r '.total')
|
||||||
|
echo "总记录数: $total"
|
||||||
|
else
|
||||||
|
print_error "查询列表失败"
|
||||||
|
fi
|
||||||
|
}
|
||||||
|
|
||||||
|
# 测试新增个人中介
|
||||||
|
test_add_person() {
|
||||||
|
print_section "测试新增个人中介"
|
||||||
|
|
||||||
|
response=$(curl -s -X POST "${BASE_URL}/ccdi/intermediary/person" \
|
||||||
|
-H "Authorization: Bearer $TOKEN" \
|
||||||
|
-H "Content-Type: application/json" \
|
||||||
|
-d '{
|
||||||
|
"name": "测试中介个人",
|
||||||
|
"personType": "中介",
|
||||||
|
"personSubType": "本人",
|
||||||
|
"relationType": "正常",
|
||||||
|
"gender": "M",
|
||||||
|
"idType": "身份证",
|
||||||
|
"personId": "110101199001019999",
|
||||||
|
"mobile": "13800138000",
|
||||||
|
"wechatNo": "test_wx",
|
||||||
|
"contactAddress": "北京市朝阳区测试地址",
|
||||||
|
"company": "测试公司",
|
||||||
|
"position": "经纪人",
|
||||||
|
"remark": "自动化测试数据"
|
||||||
|
}')
|
||||||
|
|
||||||
|
echo "$response" | jq '.'
|
||||||
|
code=$(echo "$response" | jq -r '.code')
|
||||||
|
|
||||||
|
if [ "$code" == "200" ]; then
|
||||||
|
print_success "新增个人中介成功"
|
||||||
|
# 保存bizId用于后续测试
|
||||||
|
PERSON_BIZ_ID=$(curl -s -X GET "${BASE_URL}/ccdi/intermediary/list?name=测试中介个人" \
|
||||||
|
-H "Authorization: Bearer $TOKEN" | jq -r '.rows[0].bizId // empty')
|
||||||
|
if [ -n "$PERSON_BIZ_ID" ]; then
|
||||||
|
echo "获取到个人中介bizId: $PERSON_BIZ_ID"
|
||||||
|
fi
|
||||||
|
else
|
||||||
|
print_error "新增个人中介失败: $(echo "$response" | jq -r '.msg')"
|
||||||
|
fi
|
||||||
|
}
|
||||||
|
|
||||||
|
# 测试新增实体中介
|
||||||
|
test_add_entity() {
|
||||||
|
print_section "测试新增实体中介"
|
||||||
|
|
||||||
|
response=$(curl -s -X POST "${BASE_URL}/ccdi/intermediary/entity" \
|
||||||
|
-H "Authorization: Bearer $TOKEN" \
|
||||||
|
-H "Content-Type: application/json" \
|
||||||
|
-d '{
|
||||||
|
"enterpriseName": "测试中介公司",
|
||||||
|
"socialCreditCode": "91110000123456789X",
|
||||||
|
"enterpriseType": "有限责任公司",
|
||||||
|
"enterpriseNature": "民企",
|
||||||
|
"industryClass": "房地产",
|
||||||
|
"industryName": "房地产业",
|
||||||
|
"establishDate": "2020-01-01",
|
||||||
|
"registerAddress": "北京市朝阳区注册地址",
|
||||||
|
"legalRepresentative": "张三",
|
||||||
|
"legalCertType": "身份证",
|
||||||
|
"legalCertNo": "110101199001011234",
|
||||||
|
"shareholder1": "李四",
|
||||||
|
"shareholder2": "王五",
|
||||||
|
"remark": "自动化测试数据"
|
||||||
|
}')
|
||||||
|
|
||||||
|
echo "$response" | jq '.'
|
||||||
|
code=$(echo "$response" | jq -r '.code')
|
||||||
|
|
||||||
|
if [ "$code" == "200" ]; then
|
||||||
|
print_success "新增实体中介成功"
|
||||||
|
# 保存socialCreditCode用于后续测试
|
||||||
|
ENTITY_CREDIT_CODE="91110000123456789X"
|
||||||
|
echo "实体中介统一社会信用代码: $ENTITY_CREDIT_CODE"
|
||||||
|
else
|
||||||
|
print_error "新增实体中介失败: $(echo "$response" | jq -r '.msg')"
|
||||||
|
fi
|
||||||
|
}
|
||||||
|
|
||||||
|
# 测试查询个人中介详情
|
||||||
|
test_get_person_detail() {
|
||||||
|
print_section "测试查询个人中介详情"
|
||||||
|
|
||||||
|
if [ -z "$PERSON_BIZ_ID" ]; then
|
||||||
|
print_error "没有可用的个人中介bizId,跳过测试"
|
||||||
|
return
|
||||||
|
fi
|
||||||
|
|
||||||
|
response=$(curl -s -X GET "${BASE_URL}/ccdi/intermediary/person/${PERSON_BIZ_ID}" \
|
||||||
|
-H "Authorization: Bearer $TOKEN")
|
||||||
|
|
||||||
|
echo "$response" | jq '.'
|
||||||
|
code=$(echo "$response" | jq -r '.code')
|
||||||
|
|
||||||
|
if [ "$code" == "200" ]; then
|
||||||
|
print_success "查询个人中介详情成功"
|
||||||
|
else
|
||||||
|
print_error "查询个人中介详情失败: $(echo "$response" | jq -r '.msg')"
|
||||||
|
fi
|
||||||
|
}
|
||||||
|
|
||||||
|
# 测试查询实体中介详情
|
||||||
|
test_get_entity_detail() {
|
||||||
|
print_section "测试查询实体中介详情"
|
||||||
|
|
||||||
|
if [ -z "$ENTITY_CREDIT_CODE" ]; then
|
||||||
|
print_error "没有可用的实体中介统一社会信用代码,跳过测试"
|
||||||
|
return
|
||||||
|
fi
|
||||||
|
|
||||||
|
response=$(curl -s -X GET "${BASE_URL}/ccdi/intermediary/entity/${ENTITY_CREDIT_CODE}" \
|
||||||
|
-H "Authorization: Bearer $TOKEN")
|
||||||
|
|
||||||
|
echo "$response" | jq '.'
|
||||||
|
code=$(echo "$response" | jq -r '.code')
|
||||||
|
|
||||||
|
if [ "$code" == "200" ]; then
|
||||||
|
print_success "查询实体中介详情成功"
|
||||||
|
else
|
||||||
|
print_error "查询实体中介详情失败: $(echo "$response" | jq -r '.msg')"
|
||||||
|
fi
|
||||||
|
}
|
||||||
|
|
||||||
|
# 测试校验人员ID唯一性
|
||||||
|
test_check_person_id() {
|
||||||
|
print_section "测试校验人员ID唯一性"
|
||||||
|
|
||||||
|
response=$(curl -s -X GET "${BASE_URL}/ccdi/intermediary/checkPersonIdUnique?personId=110101199001019999" \
|
||||||
|
-H "Authorization: Bearer $TOKEN")
|
||||||
|
|
||||||
|
echo "$response" | jq '.'
|
||||||
|
code=$(echo "$response" | jq -r '.code')
|
||||||
|
|
||||||
|
if [ "$code" == "200" ]; then
|
||||||
|
unique=$(echo "$response" | jq -r '.data')
|
||||||
|
print_success "校验人员ID唯一性成功, unique=$unique"
|
||||||
|
else
|
||||||
|
print_error "校验人员ID唯一性失败"
|
||||||
|
fi
|
||||||
|
}
|
||||||
|
|
||||||
|
# 测试校验统一社会信用代码唯一性
|
||||||
|
test_check_social_credit_code() {
|
||||||
|
print_section "测试校验统一社会信用代码唯一性"
|
||||||
|
|
||||||
|
response=$(curl -s -X GET "${BASE_URL}/ccdi/intermediary/checkSocialCreditCodeUnique?socialCreditCode=91110000123456789X" \
|
||||||
|
-H "Authorization: Bearer $TOKEN")
|
||||||
|
|
||||||
|
echo "$response" | jq '.'
|
||||||
|
code=$(echo "$response" | jq -r '.code')
|
||||||
|
|
||||||
|
if [ "$code" == "200" ]; then
|
||||||
|
unique=$(echo "$response" | jq -r '.data')
|
||||||
|
print_success "校验统一社会信用代码唯一性成功, unique=$unique"
|
||||||
|
else
|
||||||
|
print_error "校验统一社会信用代码唯一性失败"
|
||||||
|
fi
|
||||||
|
}
|
||||||
|
|
||||||
|
# 测试修改个人中介
|
||||||
|
test_edit_person() {
|
||||||
|
print_section "测试修改个人中介"
|
||||||
|
|
||||||
|
if [ -z "$PERSON_BIZ_ID" ]; then
|
||||||
|
print_error "没有可用的个人中介bizId,跳过测试"
|
||||||
|
return
|
||||||
|
fi
|
||||||
|
|
||||||
|
response=$(curl -s -X PUT "${BASE_URL}/ccdi/intermediary/person" \
|
||||||
|
-H "Authorization: Bearer $TOKEN" \
|
||||||
|
-H "Content-Type: application/json" \
|
||||||
|
-d "{
|
||||||
|
\"bizId\": \"$PERSON_BIZ_ID\",
|
||||||
|
\"name\": \"测试中介个人(已修改)\",
|
||||||
|
\"personType\": \"中介\",
|
||||||
|
\"gender\": \"M\",
|
||||||
|
\"idType\": \"身份证\",
|
||||||
|
\"personId\": \"110101199001019999\",
|
||||||
|
\"mobile\": \"13900139000\",
|
||||||
|
\"company\": \"新公司\",
|
||||||
|
\"position\": \"高级经纪人\",
|
||||||
|
\"remark\": \"修改后的测试数据\"
|
||||||
|
}")
|
||||||
|
|
||||||
|
echo "$response" | jq '.'
|
||||||
|
code=$(echo "$response" | jq -r '.code')
|
||||||
|
|
||||||
|
if [ "$code" == "200" ]; then
|
||||||
|
print_success "修改个人中介成功"
|
||||||
|
else
|
||||||
|
print_error "修改个人中介失败: $(echo "$response" | jq -r '.msg')"
|
||||||
|
fi
|
||||||
|
}
|
||||||
|
|
||||||
|
# 测试修改实体中介
|
||||||
|
test_edit_entity() {
|
||||||
|
print_section "测试修改实体中介"
|
||||||
|
|
||||||
|
if [ -z "$ENTITY_CREDIT_CODE" ]; then
|
||||||
|
print_error "没有可用的实体中介统一社会信用代码,跳过测试"
|
||||||
|
return
|
||||||
|
fi
|
||||||
|
|
||||||
|
response=$(curl -s -X PUT "${BASE_URL}/ccdi/intermediary/entity" \
|
||||||
|
-H "Authorization: Bearer $TOKEN" \
|
||||||
|
-H "Content-Type: application/json" \
|
||||||
|
-d "{
|
||||||
|
\"socialCreditCode\": \"$ENTITY_CREDIT_CODE\",
|
||||||
|
\"enterpriseName\": \"测试中介公司(已修改)\",
|
||||||
|
\"enterpriseType\": \"股份有限公司\",
|
||||||
|
\"enterpriseNature\": \"国企\",
|
||||||
|
\"industryClass\": \"金融\",
|
||||||
|
\"industryName\": \"金融业\",
|
||||||
|
\"registerAddress\": \"北京市海淀区新地址\",
|
||||||
|
\"legalRepresentative\": \"李四\",
|
||||||
|
\"shareholder1\": \"赵六\",
|
||||||
|
\"shareholder2\": \"钱七\",
|
||||||
|
\"remark\": \"修改后的测试数据\"
|
||||||
|
}")
|
||||||
|
|
||||||
|
echo "$response" | jq '.'
|
||||||
|
code=$(echo "$response" | jq -r '.code')
|
||||||
|
|
||||||
|
if [ "$code" == "200" ]; then
|
||||||
|
print_success "修改实体中介成功"
|
||||||
|
else
|
||||||
|
print_error "修改实体中介失败: $(echo "$response" | jq -r '.msg')"
|
||||||
|
fi
|
||||||
|
}
|
||||||
|
|
||||||
|
# 测试条件查询
|
||||||
|
test_query_by_type() {
|
||||||
|
print_section "测试按中介类型查询"
|
||||||
|
|
||||||
|
# 查询个人中介
|
||||||
|
print_section "查询个人中介"
|
||||||
|
response=$(curl -s -X GET "${BASE_URL}/ccdi/intermediary/list?intermediaryType=1&pageNum=1&pageSize=10" \
|
||||||
|
-H "Authorization: Bearer $TOKEN")
|
||||||
|
|
||||||
|
echo "$response" | jq '.'
|
||||||
|
total=$(echo "$response" | jq -r '.total')
|
||||||
|
print_success "查询到个人中介 $total 条"
|
||||||
|
|
||||||
|
# 查询实体中介
|
||||||
|
print_section "查询实体中介"
|
||||||
|
response=$(curl -s -X GET "${BASE_URL}/ccdi/intermediary/list?intermediaryType=2&pageNum=1&pageSize=10" \
|
||||||
|
-H "Authorization: Bearer $TOKEN")
|
||||||
|
|
||||||
|
echo "$response" | jq '.'
|
||||||
|
total=$(echo "$response" | jq -r '.total')
|
||||||
|
print_success "查询到实体中介 $total 条"
|
||||||
|
}
|
||||||
|
|
||||||
|
# 主函数
|
||||||
|
main() {
|
||||||
|
print_header "中介黑名单管理 API 测试开始"
|
||||||
|
|
||||||
|
# 检查jq命令
|
||||||
|
if ! command -v jq &> /dev/null; then
|
||||||
|
print_error "jq命令未安装,请先安装: apt-get install jq 或 yum install jq"
|
||||||
|
exit 1
|
||||||
|
fi
|
||||||
|
|
||||||
|
# 获取Token
|
||||||
|
get_token
|
||||||
|
|
||||||
|
# 执行测试
|
||||||
|
test_list
|
||||||
|
test_add_person
|
||||||
|
test_add_entity
|
||||||
|
test_get_person_detail
|
||||||
|
test_get_entity_detail
|
||||||
|
test_check_person_id
|
||||||
|
test_check_social_credit_code
|
||||||
|
test_edit_person
|
||||||
|
test_edit_entity
|
||||||
|
test_query_by_type
|
||||||
|
|
||||||
|
print_header "测试完成"
|
||||||
|
echo ""
|
||||||
|
echo "注意事项:"
|
||||||
|
echo "1. 请确保后端服务已启动 (${BASE_URL})"
|
||||||
|
echo "2. 测试数据已创建,可手动清理"
|
||||||
|
echo "3. 如需删除测试数据,请使用清理脚本"
|
||||||
|
echo ""
|
||||||
|
}
|
||||||
|
|
||||||
|
# 执行主函数
|
||||||
|
main
|
||||||
46
doc/sql/menu_info_maintain.sql
Normal file
46
doc/sql/menu_info_maintain.sql
Normal file
@@ -0,0 +1,46 @@
|
|||||||
|
-- =====================================================
|
||||||
|
-- 菜单SQL：信息维护模块
|
||||||
|
-- 创建时间: 2025-02-04
|
||||||
|
-- 说明: 包含"信息维护"一级菜单及其两个二级菜单
|
||||||
|
-- =====================================================
|
||||||
|
|
||||||
|
-- 一级菜单：信息维护
|
||||||
|
INSERT INTO sys_menu(menu_id, menu_name, parent_id, order_num, path, component, query, route_name, is_frame, is_cache, menu_type, visible, status, perms, icon, create_by, create_time, remark)
|
||||||
|
VALUES(2000, '信息维护', 0, 5, 'maintain', NULL, NULL, NULL, 1, 0, 'M', '0', '0', NULL, 'el-icon-collection', 'admin', NOW(), '信息维护目录');
|
||||||
|
|
||||||
|
-- 二级菜单：中介黑名单管理
|
||||||
|
INSERT INTO sys_menu(menu_id, menu_name, parent_id, order_num, path, component, query, route_name, is_frame, is_cache, menu_type, visible, status, perms, icon, create_by, create_time, remark)
|
||||||
|
VALUES(2001, '中介黑名单管理', 2000, 1, 'intermediary', 'ccdiIntermediary/index', NULL, NULL, 1, 0, 'C', '0', '0', 'ccdi:intermediary:list', '#', 'admin', NOW(), '中介黑名单管理菜单');
|
||||||
|
|
||||||
|
-- 二级菜单：员工信息维护
|
||||||
|
INSERT INTO sys_menu(menu_id, menu_name, parent_id, order_num, path, component, query, route_name, is_frame, is_cache, menu_type, visible, status, perms, icon, create_by, create_time, remark)
|
||||||
|
VALUES(2002, '员工信息维护', 2000, 2, 'employee', 'ccdiEmployee/index', NULL, NULL, 1, 0, 'C', '0', '0', 'ccdi:employee:list', '#', 'admin', NOW(), '员工信息维护菜单');
|
||||||
|
|
||||||
|
-- =====================================================
|
||||||
|
-- 中介黑名单管理 - 按钮权限
|
||||||
|
-- =====================================================
|
||||||
|
INSERT INTO sys_menu(menu_id, menu_name, parent_id, order_num, path, component, query, route_name, is_frame, is_cache, menu_type, visible, status, perms, icon, create_by, create_time, remark)
|
||||||
|
VALUES
|
||||||
|
(2010, '中介黑名单查询', 2001, 1, '', NULL, NULL, NULL, 1, 0, 'F', '0', '0', 'ccdi:intermediary:query', '#', 'admin', NOW(), ''),
|
||||||
|
(2011, '中介黑名单新增', 2001, 2, '', NULL, NULL, NULL, 1, 0, 'F', '0', '0', 'ccdi:intermediary:add', '#', 'admin', NOW(), ''),
|
||||||
|
(2012, '中介黑名单修改', 2001, 3, '', NULL, NULL, NULL, 1, 0, 'F', '0', '0', 'ccdi:intermediary:edit', '#', 'admin', NOW(), ''),
|
||||||
|
(2013, '中介黑名单删除', 2001, 4, '', NULL, NULL, NULL, 1, 0, 'F', '0', '0', 'ccdi:intermediary:remove', '#', 'admin', NOW(), ''),
|
||||||
|
(2014, '中介黑名单导出', 2001, 5, '', NULL, NULL, NULL, 1, 0, 'F', '0', '0', 'ccdi:intermediary:export', '#', 'admin', NOW(), ''),
|
||||||
|
(2015, '中介黑名单导入', 2001, 6, '', NULL, NULL, NULL, 1, 0, 'F', '0', '0', 'ccdi:intermediary:import', '#', 'admin', NOW(), '');
|
||||||
|
|
||||||
|
-- =====================================================
|
||||||
|
-- 员工信息维护 - 按钮权限
|
||||||
|
-- =====================================================
|
||||||
|
INSERT INTO sys_menu(menu_id, menu_name, parent_id, order_num, path, component, query, route_name, is_frame, is_cache, menu_type, visible, status, perms, icon, create_by, create_time, remark)
|
||||||
|
VALUES
|
||||||
|
(2020, '员工信息查询', 2002, 1, '', NULL, NULL, NULL, 1, 0, 'F', '0', '0', 'ccdi:employee:query', '#', 'admin', NOW(), ''),
|
||||||
|
(2021, '员工信息新增', 2002, 2, '', NULL, NULL, NULL, 1, 0, 'F', '0', '0', 'ccdi:employee:add', '#', 'admin', NOW(), ''),
|
||||||
|
(2022, '员工信息修改', 2002, 3, '', NULL, NULL, NULL, 1, 0, 'F', '0', '0', 'ccdi:employee:edit', '#', 'admin', NOW(), ''),
|
||||||
|
(2023, '员工信息删除', 2002, 4, '', NULL, NULL, NULL, 1, 0, 'F', '0', '0', 'ccdi:employee:remove', '#', 'admin', NOW(), ''),
|
||||||
|
(2024, '员工信息导出', 2002, 5, '', NULL, NULL, NULL, 1, 0, 'F', '0', '0', 'ccdi:employee:export', '#', 'admin', NOW(), ''),
|
||||||
|
(2025, '员工信息导入', 2002, 6, '', NULL, NULL, NULL, 1, 0, 'F', '0', '0', 'ccdi:employee:import', '#', 'admin', NOW(), '');
|
||||||
|
|
||||||
|
-- =====================================================
|
||||||
|
-- 回滚SQL（如需删除这些菜单，执行以下语句）
|
||||||
|
-- =====================================================
|
||||||
|
-- DELETE FROM sys_menu WHERE menu_id BETWEEN 2000 AND 2025;
|
||||||
286
doc/test/intermediary-blacklist-test-report.md
Normal file
286
doc/test/intermediary-blacklist-test-report.md
Normal file
@@ -0,0 +1,286 @@
|
|||||||
|
# 中介黑名单管理模块测试报告
|
||||||
|
|
||||||
|
## 测试概要
|
||||||
|
|
||||||
|
| 项目 | 内容 |
|
||||||
|
|------|------|
|
||||||
|
| 测试模块 | 中介黑名单管理 |
|
||||||
|
| 测试版本 | v2.0 |
|
||||||
|
| 测试日期 | 2026-02-04 |
|
||||||
|
| 测试人员 | [测试人员姓名] |
|
||||||
|
| 测试环境 | 开发环境 |
|
||||||
|
| 后端地址 | http://localhost:8080 |
|
||||||
|
| 前端地址 | http://localhost |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 测试环境信息
|
||||||
|
|
||||||
|
### 后端环境
|
||||||
|
- **框架**: Spring Boot 3.5.8
|
||||||
|
- **JDK版本**: Java 17
|
||||||
|
- **数据库**: MySQL 8.2.0
|
||||||
|
- **ORM框架**: MyBatis Plus 3.5.10
|
||||||
|
- **API文档**: Swagger UI (http://localhost:8080/swagger-ui/index.html)
|
||||||
|
|
||||||
|
### 前端环境
|
||||||
|
- **框架**: Vue 2.6.12
|
||||||
|
- **UI库**: Element UI 2.15.14
|
||||||
|
- **构建工具**: npm/yarn
|
||||||
|
|
||||||
|
### 测试账号
|
||||||
|
- **用户名**: admin
|
||||||
|
- **密码**: admin123
|
||||||
|
- **角色**: 管理员
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 测试用例执行情况
|
||||||
|
|
||||||
|
### 1. 列表查询测试
|
||||||
|
|
||||||
|
#### 1.1 基础列表查询
|
||||||
|
|
||||||
|
| 测试项 | 测试步骤 | 预期结果 | 实际结果 | 测试状态 |
|
||||||
|
|--------|---------|---------|---------|---------|
|
||||||
|
| 查询所有中介 | GET /ccdi/intermediary/list | 返回分页数据列表 | | ⬜ 通过 / ❌ 失败 |
|
||||||
|
| 分页查询 | pageNum=1, pageSize=10 | 返回第一页10条数据 | | ⬜ 通过 / ❌ 失败 |
|
||||||
|
|
||||||
|
#### 1.2 条件查询
|
||||||
|
|
||||||
|
| 测试项 | 测试步骤 | 预期结果 | 实际结果 | 测试状态 |
|
||||||
|
|--------|---------|---------|---------|---------|
|
||||||
|
| 按姓名查询 | name=张三 | 返回姓名包含"张三"的数据 | | ⬜ 通过 / ❌ 失败 |
|
||||||
|
| 按证件号查询 | certificateNo=110101... | 返回证件号匹配的数据 | | ⬜ 通过 / ❌ 失败 |
|
||||||
|
| 按中介类型查询 | intermediaryType=1 | 返回个人中介数据 | | ⬜ 通过 / ❌ 失败 |
|
||||||
|
| 按中介类型查询 | intermediaryType=2 | 返回实体中介数据 | | ⬜ 通过 / ❌ 失败 |
|
||||||
|
| 组合条件查询 | 多个条件组合 | 返回符合所有条件的数据 | | ⬜ 通过 / ❌ 失败 |
|
||||||
|
|
||||||
|
### 2. 个人中介管理测试
|
||||||
|
|
||||||
|
#### 2.1 新增个人中介
|
||||||
|
|
||||||
|
| 测试项 | 测试步骤 | 预期结果 | 实际结果 | 测试状态 |
|
||||||
|
|--------|---------|---------|---------|---------|
|
||||||
|
| 正常新增 | POST /ccdi/intermediary/person | 返回成功,数据保存 | | ⬜ 通过 / ❌ 失败 |
|
||||||
|
| 姓名为空 | name="" | 提示"姓名不能为空" | | ⬜ 通过 / ❌ 失败 |
|
||||||
|
| 证件号为空 | personId="" | 提示"证件号码不能为空" | | ⬜ 通过 / ❌ 失败 |
|
||||||
|
| 姓名超长 | name=101个字符 | 提示"姓名长度不能超过100个字符" | | ⬜ 通过 / ❌ 失败 |
|
||||||
|
| 证件号超长 | personId=51个字符 | 提示"证件号码长度不能超过50个字符" | | ⬜ 通过 / ❌ 失败 |
|
||||||
|
| 证件号重复 | 使用已存在的personId | 提示"该证件号已存在" | | ⬜ 通过 / ❌ 失败 |
|
||||||
|
|
||||||
|
#### 2.2 查询个人中介详情
|
||||||
|
|
||||||
|
| 测试项 | 测试步骤 | 预期结果 | 实际结果 | 测试状态 |
|
||||||
|
|--------|---------|---------|---------|---------|
|
||||||
|
| 正常查询 | GET /ccdi/intermediary/person/{bizId} | 返回完整的个人中介详情 | | ⬜ 通过 / ❌ 失败 |
|
||||||
|
| bizId不存在 | 使用不存在的bizId | 返回空数据或提示 | | ⬜ 通过 / ❌ 失败 |
|
||||||
|
|
||||||
|
#### 2.3 修改个人中介
|
||||||
|
|
||||||
|
| 测试项 | 测试步骤 | 预期结果 | 实际结果 | 测试状态 |
|
||||||
|
|--------|---------|---------|---------|---------|
|
||||||
|
| 正常修改 | PUT /ccdi/intermediary/person | 返回成功,数据更新 | | ⬜ 通过 / ❌ 失败 |
|
||||||
|
| 修改为重复证件号 | personId改为已存在的值 | 提示"该证件号已存在" | | ⬜ 通过 / ❌ 失败 |
|
||||||
|
| 姓名为空 | name="" | 提示"姓名不能为空" | | ⬜ 通过 / ❌ 失败 |
|
||||||
|
|
||||||
|
### 3. 实体中介管理测试
|
||||||
|
|
||||||
|
#### 3.1 新增实体中介
|
||||||
|
|
||||||
|
| 测试项 | 测试步骤 | 预期结果 | 实际结果 | 测试状态 |
|
||||||
|
|--------|---------|---------|---------|---------|
|
||||||
|
| 正常新增 | POST /ccdi/intermediary/entity | 返回成功,数据保存 | | ⬜ 通过 / ❌ 失败 |
|
||||||
|
| 机构名称为空 | enterpriseName="" | 提示"机构名称不能为空" | | ⬜ 通过 / ❌ 失败 |
|
||||||
|
| 机构名称超长 | enterpriseName=201个字符 | 提示"机构名称长度不能超过200个字符" | | ⬜ 通过 / ❌ 失败 |
|
||||||
|
| 统一社会信用代码重复 | 使用已存在的socialCreditCode | 提示"该统一社会信用代码已存在" | | ⬜ 通过 / ❌ 失败 |
|
||||||
|
|
||||||
|
#### 3.2 查询实体中介详情
|
||||||
|
|
||||||
|
| 测试项 | 测试步骤 | 预期结果 | 实际结果 | 测试状态 |
|
||||||
|
|--------|---------|---------|---------|---------|
|
||||||
|
| 正常查询 | GET /ccdi/intermediary/entity/{socialCreditCode} | 返回完整的实体中介详情 | | ⬜ 通过 / ❌ 失败 |
|
||||||
|
| socialCreditCode不存在 | 使用不存在的代码 | 返回空数据或提示 | | ⬜ 通过 / ❌ 失败 |
|
||||||
|
|
||||||
|
#### 3.3 修改实体中介
|
||||||
|
|
||||||
|
| 测试项 | 测试步骤 | 预期结果 | 实际结果 | 测试状态 |
|
||||||
|
|--------|---------|---------|---------|---------|
|
||||||
|
| 正常修改 | PUT /ccdi/intermediary/entity | 返回成功,数据更新 | | ⬜ 通过 / ❌ 失败 |
|
||||||
|
| 修改为重复信用代码 | socialCreditCode改为已存在的值 | 提示"该统一社会信用代码已存在" | | ⬜ 通过 / ❌ 失败 |
|
||||||
|
| 机构名称为空 | enterpriseName="" | 提示"机构名称不能为空" | | ⬜ 通过 / ❌ 失败 |
|
||||||
|
|
||||||
|
### 4. 唯一性校验测试
|
||||||
|
|
||||||
|
| 测试项 | 测试步骤 | 预期结果 | 实际结果 | 测试状态 |
|
||||||
|
|--------|---------|---------|---------|---------|
|
||||||
|
| 校验人员ID唯一性 | GET /checkPersonIdUnique | 返回true/false | | ⬜ 通过 / ❌ 失败 |
|
||||||
|
| 校验统一社会信用代码唯一性 | GET /checkSocialCreditCodeUnique | 返回true/false | | ⬜ 通过 / ❌ 失败 |
|
||||||
|
|
||||||
|
### 5. 删除测试
|
||||||
|
|
||||||
|
| 测试项 | 测试步骤 | 预期结果 | 实际结果 | 测试状态 |
|
||||||
|
|--------|---------|---------|---------|---------|
|
||||||
|
| 删除单条记录 | DELETE /ccdi/intermediary/{id} | 返回成功,数据删除 | | ⬜ 通过 / ❌ 失败 |
|
||||||
|
| 批量删除 | DELETE /ccdi/intermediary/{id1,id2} | 返回成功,多条数据删除 | | ⬜ 通过 / ❌ 失败 |
|
||||||
|
| 删除不存在的记录 | DELETE /ccdi/intermediary/{不存在的id} | 返回成功或提示 | | ⬜ 通过 / ❌ 失败 |
|
||||||
|
|
||||||
|
### 6. 导入导出测试
|
||||||
|
|
||||||
|
#### 6.1 模板下载
|
||||||
|
|
||||||
|
| 测试项 | 测试步骤 | 预期结果 | 实际结果 | 测试状态 |
|
||||||
|
|--------|---------|---------|---------|---------|
|
||||||
|
| 下载个人中介模板 | POST /importPersonTemplate | 下载Excel模板,包含下拉框 | | ⬜ 通过 / ❌ 失败 |
|
||||||
|
| 下载实体中介模板 | POST /importEntityTemplate | 下载Excel模板,包含下拉框 | | ⬜ 通过 / ❌ 失败 |
|
||||||
|
|
||||||
|
#### 6.2 数据导入
|
||||||
|
|
||||||
|
| 测试项 | 测试步骤 | 预期结果 | 实际结果 | 测试状态 |
|
||||||
|
|--------|---------|---------|---------|---------|
|
||||||
|
| 导入个人中介数据 | POST /importPersonData | 返回导入成功条数 | | ⬜ 通过 / ❌ 失败 |
|
||||||
|
| 导入实体中介数据 | POST /importEntityData | 返回导入成功条数 | | ⬜ 通过 / ❌ 失败 |
|
||||||
|
| 导入空数据 | 上传空Excel | 提示"没有数据" | | ⬜ 通过 / ❌ 失败 |
|
||||||
|
| 导入格式错误数据 | 上传格式错误的Excel | 提示格式错误 | | ⬜ 通过 / ❌ 失败 |
|
||||||
|
| 导入必填字段为空 | 上传姓名为空的Excel | 提示"姓名不能为空" | | ⬜ 通过 / ❌ 失败 |
|
||||||
|
| 更新已存在数据 | updateSupport=true | 更新已存在的记录 | | ⬜ 通过 / ❌ 失败 |
|
||||||
|
| 不更新已存在数据 | updateSupport=false | 跳过已存在的记录 | | ⬜ 通过 / ❌ 失败 |
|
||||||
|
|
||||||
|
#### 6.3 数据导出
|
||||||
|
|
||||||
|
| 测试项 | 测试步骤 | 预期结果 | 实际结果 | 测试状态 |
|
||||||
|
|--------|---------|---------|---------|---------|
|
||||||
|
| 导出全部数据 | POST /export | 下载包含所有数据的Excel | | ⬜ 通过 / ❌ 失败 |
|
||||||
|
| 按条件导出 | 带查询条件导出 | 下载符合条件的数据Excel | | ⬜ 通过 / ❌ 失败 |
|
||||||
|
|
||||||
|
### 7. 权限测试
|
||||||
|
|
||||||
|
| 测试项 | 测试步骤 | 预期结果 | 实际结果 | 测试状态 |
|
||||||
|
|--------|---------|---------|---------|---------|
|
||||||
|
| 无权限访问列表 | 无ccdi:intermediary:list权限 | 返回403或提示无权限 | | ⬜ 通过 / ❌ 失败 |
|
||||||
|
| 无权限新增 | 无ccdi:intermediary:add权限 | 返回403或提示无权限 | | ⬜ 通过 / ❌ 失败 |
|
||||||
|
| 无权限修改 | 无ccdi:intermediary:edit权限 | 返回403或提示无权限 | | ⬜ 通过 / ❌ 失败 |
|
||||||
|
| 无权限删除 | 无ccdi:intermediary:remove权限 | 返回403或提示无权限 | | ⬜ 通过 / ❌ 失败 |
|
||||||
|
| 无权限导出 | 无ccdi:intermediary:export权限 | 返回403或提示无权限 | | ⬜ 通过 / ❌ 失败 |
|
||||||
|
| 无权限导入 | 无ccdi:intermediary:import权限 | 返回403或提示无权限 | | ⬜ 通过 / ❌ 失败 |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 测试结果统计
|
||||||
|
|
||||||
|
### 测试用例统计
|
||||||
|
|
||||||
|
| 类别 | 总数 | 通过 | 失败 | 通过率 |
|
||||||
|
|------|------|------|------|--------|
|
||||||
|
| 列表查询 | 7 | 0 | 0 | 0% |
|
||||||
|
| 个人中介管理 | 8 | 0 | 0 | 0% |
|
||||||
|
| 实体中介管理 | 7 | 0 | 0 | 0% |
|
||||||
|
| 唯一性校验 | 2 | 0 | 0 | 0% |
|
||||||
|
| 删除功能 | 3 | 0 | 0 | 0% |
|
||||||
|
| 导入导出 | 11 | 0 | 0 | 0% |
|
||||||
|
| 权限控制 | 6 | 0 | 0 | 0% |
|
||||||
|
| **合计** | **44** | **0** | **0** | **0%** |
|
||||||
|
|
||||||
|
### 缺陷统计
|
||||||
|
|
||||||
|
| 严重程度 | 数量 | 缺陷列表 |
|
||||||
|
|---------|------|---------|
|
||||||
|
| 严重 | 0 | |
|
||||||
|
| 重要 | 0 | |
|
||||||
|
| 一般 | 0 | |
|
||||||
|
| 轻微 | 0 | |
|
||||||
|
| **合计** | **0** | |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 测试结论
|
||||||
|
|
||||||
|
### 整体评价
|
||||||
|
|
||||||
|
[待填写]
|
||||||
|
|
||||||
|
### 主要功能点测试结果
|
||||||
|
|
||||||
|
| 功能模块 | 测试结果 | 备注 |
|
||||||
|
|---------|---------|------|
|
||||||
|
| 列表查询 | | |
|
||||||
|
| 个人中介CRUD | | |
|
||||||
|
| 实体中介CRUD | | |
|
||||||
|
| 唯一性校验 | | |
|
||||||
|
| 导入导出 | | |
|
||||||
|
| 权限控制 | | |
|
||||||
|
|
||||||
|
### 发现的问题
|
||||||
|
|
||||||
|
#### 1. [问题标题]
|
||||||
|
- **问题描述**: [详细描述问题]
|
||||||
|
- **严重程度**: [严重/重要/一般/轻微]
|
||||||
|
- **复现步骤**:
|
||||||
|
1. [步骤1]
|
||||||
|
2. [步骤2]
|
||||||
|
3. [步骤3]
|
||||||
|
- **预期结果**: [预期结果]
|
||||||
|
- **实际结果**: [实际结果]
|
||||||
|
- **附件**: [截图或日志]
|
||||||
|
|
||||||
|
#### 2. [问题标题]
|
||||||
|
...
|
||||||
|
|
||||||
|
### 改进建议
|
||||||
|
|
||||||
|
1. [建议1]
|
||||||
|
2. [建议2]
|
||||||
|
3. [建议3]
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 测试附件
|
||||||
|
|
||||||
|
### 测试数据
|
||||||
|
|
||||||
|
| 数据类型 | 数据内容 |
|
||||||
|
|---------|---------|
|
||||||
|
| 测试个人中介bizId | [填写] |
|
||||||
|
| 测试实体中介信用代码 | [填写] |
|
||||||
|
| 测试证件号 | [填写] |
|
||||||
|
|
||||||
|
### 测试日志
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# 测试脚本输出日志
|
||||||
|
[粘贴测试脚本的完整输出]
|
||||||
|
```
|
||||||
|
|
||||||
|
### 测试截图
|
||||||
|
|
||||||
|
- 图1: 列表查询成功截图
|
||||||
|
- 图2: 新增个人中介成功截图
|
||||||
|
- 图3: 新增实体中介成功截图
|
||||||
|
- 图4: 修改中介成功截图
|
||||||
|
- 图5: 删除中介成功截图
|
||||||
|
- 图6: 导入数据成功截图
|
||||||
|
- 图7: 导出数据成功截图
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 签名
|
||||||
|
|
||||||
|
| 角色 | 姓名 | 签名 | 日期 |
|
||||||
|
|------|------|------|------|
|
||||||
|
| 测试人员 | | | |
|
||||||
|
| 开发负责人 | | | |
|
||||||
|
| 产品负责人 | | | |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 备注
|
||||||
|
|
||||||
|
1. 本测试报告基于中介黑名单管理模块v2.0版本
|
||||||
|
2. 测试环境为开发环境,生产环境部署前需再次测试
|
||||||
|
3. 所有测试用例均使用自动化测试脚本执行,可复现
|
||||||
|
4. 测试数据可在测试完成后清理
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
**报告生成时间**: [填写]
|
||||||
|
**报告版本**: v1.0
|
||||||
269
doc/中介黑名单列表查询功能说明.md
Normal file
269
doc/中介黑名单列表查询功能说明.md
Normal file
@@ -0,0 +1,269 @@
|
|||||||
|
# 中介黑名单列表查询功能说明
|
||||||
|
|
||||||
|
## 接口说明
|
||||||
|
|
||||||
|
### 1. 列表查询接口（不分页）
|
||||||
|
|
||||||
|
**接口地址:** `GET /ccdi/intermediary/list`
|
||||||
|
|
||||||
|
**请求参数:**
|
||||||
|
|
||||||
|
| 参数名 | 类型 | 必填 | 说明 | 示例 |
|
||||||
|
|--------|------|------|------|------|
|
||||||
|
| name | String | 否 | 姓名/机构名称（模糊查询） | 张三 |
|
||||||
|
| certificateNo | String | 否 | 证件号/社会信用代码（模糊查询） | 110101... |
|
||||||
|
| intermediaryType | String | 否 | 中介类型（1=个人，2=机构） | 1 |
|
||||||
|
| status | String | 否 | 状态（0=正常，1=停用） | 0 |
|
||||||
|
| pageNum | Int | 否 | 页码 | 1 |
|
||||||
|
| pageSize | Int | 否 | 每页条数 | 10 |
|
||||||
|
|
||||||
|
**查询场景示例:**
|
||||||
|
|
||||||
|
#### 场景1: 查询所有中介（个人+机构）
|
||||||
|
```http
|
||||||
|
GET /ccdi/intermediary/list
|
||||||
|
```
|
||||||
|
|
||||||
|
#### 场景2: 只查询个人中介
|
||||||
|
```http
|
||||||
|
GET /ccdi/intermediary/list?intermediaryType=1
|
||||||
|
```
|
||||||
|
|
||||||
|
#### 场景3: 只查询机构中介
|
||||||
|
```http
|
||||||
|
GET /ccdi/intermediary/list?intermediaryType=2
|
||||||
|
```
|
||||||
|
|
||||||
|
#### 场景4: 按姓名查询个人中介
|
||||||
|
```http
|
||||||
|
GET /ccdi/intermediary/list?intermediaryType=1&name=张三
|
||||||
|
```
|
||||||
|
|
||||||
|
#### 场景5: 按证件号查询机构中介
|
||||||
|
```http
|
||||||
|
GET /ccdi/intermediary/list?intermediaryType=2&certificateNo=91110000...
|
||||||
|
```
|
||||||
|
|
||||||
|
#### 场景6: 分页查询所有中介
|
||||||
|
```http
|
||||||
|
GET /ccdi/intermediary/list?pageNum=1&pageSize=10
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## SQL 实现逻辑
|
||||||
|
|
||||||
|
### 分页查询优化
|
||||||
|
|
||||||
|
使用 `UNION ALL` 在数据库层面完成联合查询和分页，提升性能：
|
||||||
|
|
||||||
|
```sql
|
||||||
|
SELECT * FROM (
|
||||||
|
-- 个人中介查询
|
||||||
|
SELECT
|
||||||
|
biz_id AS intermediary_id,
|
||||||
|
name,
|
||||||
|
person_id AS certificate_no,
|
||||||
|
'1' AS intermediary_type,
|
||||||
|
'0' AS status,
|
||||||
|
date_source AS data_source,
|
||||||
|
create_time,
|
||||||
|
update_time
|
||||||
|
FROM ccdi_biz_intermediary
|
||||||
|
WHERE 1=1
|
||||||
|
<!-- 类型过滤 -->
|
||||||
|
<if test="intermediaryType != null">
|
||||||
|
AND '1' = #{intermediaryType}
|
||||||
|
</if>
|
||||||
|
|
||||||
|
UNION ALL
|
||||||
|
|
||||||
|
-- 机构中介查询
|
||||||
|
SELECT
|
||||||
|
0 AS intermediary_id,
|
||||||
|
enterprise_name AS name,
|
||||||
|
social_credit_code AS certificate_no,
|
||||||
|
'2' AS intermediary_type,
|
||||||
|
status,
|
||||||
|
data_source,
|
||||||
|
create_time,
|
||||||
|
update_time
|
||||||
|
FROM ccdi_enterprise_base_info
|
||||||
|
WHERE ent_source = 'INTERMEDIARY'
|
||||||
|
<!-- 类型过滤 -->
|
||||||
|
<if test="intermediaryType != null">
|
||||||
|
AND '2' = #{intermediaryType}
|
||||||
|
</if>
|
||||||
|
) AS combined_data
|
||||||
|
ORDER BY create_time DESC
|
||||||
|
LIMIT 10 OFFSET 0 -- MyBatis Plus 自动添加
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 类型过滤逻辑
|
||||||
|
|
||||||
|
### 在 SQL 子查询层面过滤
|
||||||
|
|
||||||
|
| 查询条件 | 个人中介子查询 | 机构中介子查询 |
|
||||||
|
|----------|--------------|--------------|
|
||||||
|
| `intermediaryType=null` | 执行 | 执行 |
|
||||||
|
| `intermediaryType=1` | 执行 (`'1'='1'` 为真) | 不返回数据 (`'2'='1'` 为假) |
|
||||||
|
| `intermediaryType=2` | 不返回数据 (`'1'='2'` 为假) | 执行 (`'2'='2'` 为真) |
|
||||||
|
|
||||||
|
**优势:**
|
||||||
|
- ✅ 避免查询不需要的数据
|
||||||
|
- ✅ 减少数据库 I/O
|
||||||
|
- ✅ 提升 UNION 性能
|
||||||
|
- ✅ 分页准确
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 列表查询（非分页）
|
||||||
|
|
||||||
|
Service 层实现：
|
||||||
|
|
||||||
|
```java
|
||||||
|
@Override
|
||||||
|
public List<CcdiIntermediaryBlacklistVO> selectIntermediaryList(
|
||||||
|
CcdiIntermediaryBlacklistQueryDTO queryDTO) {
|
||||||
|
|
||||||
|
List<CcdiIntermediaryBlacklistVO> resultList = new ArrayList<>();
|
||||||
|
|
||||||
|
// 查询个人中介
|
||||||
|
if (StringUtils.isEmpty(queryDTO.getIntermediaryType()) || "1".equals(queryDTO.getIntermediaryType())) {
|
||||||
|
LambdaQueryWrapper<CcdiBizIntermediary> personWrapper = buildPersonQueryWrapper(queryDTO);
|
||||||
|
List<CcdiBizIntermediary> personList = bizIntermediaryMapper.selectList(personWrapper);
|
||||||
|
personList.forEach(person -> resultList.add(convertPersonToVO(person)));
|
||||||
|
}
|
||||||
|
|
||||||
|
// 查询机构中介
|
||||||
|
if (StringUtils.isEmpty(queryDTO.getIntermediaryType()) || "2".equals(queryDTO.getIntermediaryType())) {
|
||||||
|
LambdaQueryWrapper<CcdiEnterpriseBaseInfo> entityWrapper = buildEntityQueryWrapper(queryDTO);
|
||||||
|
List<CcdiEnterpriseBaseInfo> entityList = enterpriseBaseInfoMapper.selectList(entityWrapper);
|
||||||
|
entityList.forEach(entity -> resultList.add(convertEntityToVO(entity)));
|
||||||
|
}
|
||||||
|
|
||||||
|
return resultList;
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
**逻辑说明:**
|
||||||
|
- 当 `intermediaryType` 为空时，查询两种类型
|
||||||
|
- 当 `intermediaryType = "1"` 时，只查询个人中介
|
||||||
|
- 当 `intermediaryType = "2"` 时，只查询机构中介
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 返回数据格式
|
||||||
|
|
||||||
|
### 个人中介
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"code": 200,
|
||||||
|
"msg": "查询成功",
|
||||||
|
"rows": [
|
||||||
|
{
|
||||||
|
"intermediaryId": 1,
|
||||||
|
"name": "张三",
|
||||||
|
"certificateNo": "110101199001011234",
|
||||||
|
"intermediaryType": "1",
|
||||||
|
"intermediaryTypeName": "个人",
|
||||||
|
"status": "0",
|
||||||
|
"statusName": "正常",
|
||||||
|
"dataSource": "MANUAL",
|
||||||
|
"dataSourceName": "手动录入",
|
||||||
|
"createTime": "2026-02-04 10:00:00",
|
||||||
|
"updateTime": "2026-02-04 10:00:00"
|
||||||
|
}
|
||||||
|
],
|
||||||
|
"total": 1
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
### 机构中介
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"code": 200,
|
||||||
|
"msg": "查询成功",
|
||||||
|
"rows": [
|
||||||
|
{
|
||||||
|
"intermediaryId": 0,
|
||||||
|
"name": "测试机构有限公司",
|
||||||
|
"certificateNo": "91110000123456789X",
|
||||||
|
"intermediaryType": "2",
|
||||||
|
"intermediaryTypeName": "机构",
|
||||||
|
"status": "0",
|
||||||
|
"statusName": "正常",
|
||||||
|
"dataSource": "MANUAL",
|
||||||
|
"dataSourceName": "手动录入",
|
||||||
|
"createTime": "2026-02-04 10:00:00",
|
||||||
|
"updateTime": "2026-02-04 10:00:00"
|
||||||
|
}
|
||||||
|
],
|
||||||
|
"total": 1
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 性能对比
|
||||||
|
|
||||||
|
| 场景 | 旧实现 | 新实现 |
|
||||||
|
|------|--------|--------|
|
||||||
|
| 查询所有 | 查询2张表 | UNION ALL 查询2张表 |
|
||||||
|
| 只查个人 | 查询2张表，应用层过滤 | 只查个人表 |
|
||||||
|
| 只查机构 | 查询2张表，应用层过滤 | 只查机构表 |
|
||||||
|
| 分页 | 查询全部，手动截取 | LIMIT/OFFSET 数据库分页 |
|
||||||
|
|
||||||
|
**性能提升:**
|
||||||
|
- 只查个人/机构时，减少50%的数据库查询
|
||||||
|
- 大数据量分页时，避免内存溢出
|
||||||
|
- 网络传输量减少 90%+
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 测试用例
|
||||||
|
|
||||||
|
### 测试1: 查询所有中介
|
||||||
|
```bash
|
||||||
|
curl -X GET "http://localhost:8080/ccdi/intermediary/list" \
|
||||||
|
-H "Authorization: Bearer $TOKEN"
|
||||||
|
```
|
||||||
|
|
||||||
|
**预期:** 返回个人和机构两种类型的数据
|
||||||
|
|
||||||
|
### 测试2: 只查询个人中介
|
||||||
|
```bash
|
||||||
|
curl -X GET "http://localhost:8080/ccdi/intermediary/list?intermediaryType=1" \
|
||||||
|
-H "Authorization: Bearer $TOKEN"
|
||||||
|
```
|
||||||
|
|
||||||
|
**预期:** 只返回个人中介数据
|
||||||
|
|
||||||
|
### 测试3: 只查询机构中介
|
||||||
|
```bash
|
||||||
|
curl -X GET "http://localhost:8080/ccdi/intermediary/list?intermediaryType=2" \
|
||||||
|
-H "Authorization: Bearer $TOKEN"
|
||||||
|
```
|
||||||
|
|
||||||
|
**预期:** 只返回机构中介数据
|
||||||
|
|
||||||
|
### 测试4: 分页查询个人中介
|
||||||
|
```bash
|
||||||
|
curl -X GET "http://localhost:8080/ccdi/intermediary/list?intermediaryType=1&pageNum=1&pageSize=10" \
|
||||||
|
-H "Authorization: Bearer $TOKEN"
|
||||||
|
```
|
||||||
|
|
||||||
|
**预期:**
|
||||||
|
- 返回第1页，最多10条个人中介数据
|
||||||
|
- total 为个人中介的总数
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 注意事项
|
||||||
|
|
||||||
|
1. **类型过滤在数据库层面完成**，不是在应用层过滤
|
||||||
|
2. **分页使用 MyBatis Plus 的自动分页**，SQL 自动添加 LIMIT/OFFSET
|
||||||
|
3. **机构中介的 ID 为 0**，因为主键是字符串类型（社会信用代码）
|
||||||
|
4. **查询时自动过滤 `ent_source='INTERMEDIARY'`**，确保只返回中介来源的企业
|
||||||
BIN
doc/原型图-上传数据页面.png
Normal file
BIN
doc/原型图-上传数据页面.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 260 KiB |
821
doc/原型图开发设计文档.md
Normal file
821
doc/原型图开发设计文档.md
Normal file
@@ -0,0 +1,821 @@
|
|||||||
|
# 纪检初核系统 - 原型图开发设计文档
|
||||||
|
|
||||||
|
## 一、项目概述
|
||||||
|
|
||||||
|
### 1.1 项目背景
|
||||||
|
本项目是一个**纪检初核系统**，用于对银行信贷部门员工进行初步核查，通过分析银行流水、征信报告、员工关系等数据，识别潜在的违规行为和风险。
|
||||||
|
|
||||||
|
### 1.2 项目目标
|
||||||
|
- 支持多维度数据导入（流水、征信、员工关系）
|
||||||
|
- 提供可配置的风险监测模型
|
||||||
|
- 自动识别高风险人员并生成初核提示
|
||||||
|
- 提供专项排查工作台进行深入分析
|
||||||
|
- 支持关系图谱和资金流向分析
|
||||||
|
|
||||||
|
### 1.3 技术栈
|
||||||
|
- **后端**: Spring Boot 3.5.8 + MyBatis 3.0.5 + MySQL 8.2.0
|
||||||
|
- **前端**: Vue 2.6.12 + Element UI 2.15.14
|
||||||
|
- **数据库**: MySQL（表前缀：ccdi_）
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 二、页面结构与功能分析
|
||||||
|
|
||||||
|
### 2.1 页面导航结构
|
||||||
|
|
||||||
|
```
|
||||||
|
纪检初核系统
|
||||||
|
├── 项目管理
|
||||||
|
│ ├── 项目详情
|
||||||
|
│ ├── 上传数据
|
||||||
|
│ ├── 参数配置
|
||||||
|
│ └── 初核提示
|
||||||
|
├── 初核结果
|
||||||
|
│ ├── 专项排查工作台（高风险）
|
||||||
|
│ ├── 专项排查工作台（中风险）
|
||||||
|
│ └── 专项排查
|
||||||
|
└── 流水明细查询
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### 2.2 页面1：上传数据
|
||||||
|
|
||||||
|
#### 功能描述
|
||||||
|
支持在一个项目中上传多个主体/账户数据，进行汇总/独立分析。
|
||||||
|
|
||||||
|
#### 页面元素
|
||||||
|
| 元素类型 | 元素名称/内容 | 说明 |
|
||||||
|
|---------|--------------|------|
|
||||||
|
| 项目信息 | 项目状态 | 显示项目当前状态（如：已完成） |
|
||||||
|
| | 最后更新时间 | 显示项目最后更新时间 |
|
||||||
|
| 上传模块1 | 流水导入 | 支持Excel、PDF格式文件批量上传 |
|
||||||
|
| | | 占位符：拖拽文件到此处或点击上传 |
|
||||||
|
| | | 支持格式：xlsx, xls, pdf |
|
||||||
|
| 上传模块2 | 已上传流水查询 | 支持HTML格式 |
|
||||||
|
| | | 占位符：拖拽文件到此处或点击上传 |
|
||||||
|
| 上传模块3 | 征信导入 | 支持HTML格式征信报告解析 |
|
||||||
|
| 上传模块4 | 员工家庭关系导入 | Excel模板上传员工家庭关系信息 |
|
||||||
|
| | | 支持格式：xlsx, xls |
|
||||||
|
| 名单库选择 | 高风险人员名单 | 复选框，显示人数（如68人） |
|
||||||
|
| | 历史可疑人员名单 | 复选框，显示人数（如45人） |
|
||||||
|
| | 监管关注名单 | 复选框，显示人数（如32人） |
|
||||||
|
| 数据质量检查 | 数据完整性 | 进度条，显示百分比（如98.5%） |
|
||||||
|
| | 格式一致性 | 进度条，显示百分比（如95.2%） |
|
||||||
|
| | 余额连续性 | 进度条，显示百分比（如92.8%） |
|
||||||
|
| | 检查结果 | 显示发现的问题数量 |
|
||||||
|
| 操作按钮 | 拉取本行信息 | 触发拉取银行内部信息 |
|
||||||
|
| | 生成报告 | 生成初核报告 |
|
||||||
|
|
||||||
|
#### 数据模型
|
||||||
|
```sql
|
||||||
|
-- 项目表
|
||||||
|
CREATE TABLE ccdi_project (
|
||||||
|
project_id BIGINT PRIMARY KEY AUTO_INCREMENT,
|
||||||
|
project_name VARCHAR(200) NOT NULL COMMENT '项目名称',
|
||||||
|
project_status VARCHAR(50) COMMENT '项目状态',
|
||||||
|
create_time DATETIME DEFAULT CURRENT_TIMESTAMP,
|
||||||
|
update_time DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
|
||||||
|
create_by VARCHAR(100),
|
||||||
|
update_by VARCHAR(100),
|
||||||
|
remark VARCHAR(500)
|
||||||
|
) COMMENT '项目表';
|
||||||
|
|
||||||
|
-- 数据上传记录表
|
||||||
|
CREATE TABLE ccdi_data_upload (
|
||||||
|
upload_id BIGINT PRIMARY KEY AUTO_INCREMENT,
|
||||||
|
project_id BIGINT COMMENT '项目ID',
|
||||||
|
upload_type VARCHAR(50) COMMENT '上传类型：流水/征信/家庭关系',
|
||||||
|
file_name VARCHAR(500) COMMENT '文件名',
|
||||||
|
file_path VARCHAR(1000) COMMENT '文件路径',
|
||||||
|
upload_status VARCHAR(50) COMMENT '上传状态',
|
||||||
|
upload_time DATETIME COMMENT '上传时间',
|
||||||
|
create_time DATETIME DEFAULT CURRENT_TIMESTAMP,
|
||||||
|
create_by VARCHAR(100)
|
||||||
|
) COMMENT '数据上传记录表';
|
||||||
|
|
||||||
|
-- 名单库选择记录表
|
||||||
|
CREATE TABLE ccdi_blacklist_selection (
|
||||||
|
selection_id BIGINT PRIMARY KEY AUTO_INCREMENT,
|
||||||
|
project_id BIGINT COMMENT '项目ID',
|
||||||
|
blacklist_type VARCHAR(50) COMMENT '名单类型：高风险/历史可疑/监管关注',
|
||||||
|
blacklist_id BIGINT COMMENT '名单ID',
|
||||||
|
create_time DATETIME DEFAULT CURRENT_TIMESTAMP
|
||||||
|
) COMMENT '名单库选择记录表';
|
||||||
|
|
||||||
|
-- 数据质量检查表
|
||||||
|
CREATE TABLE ccdi_data_quality (
|
||||||
|
quality_id BIGINT PRIMARY KEY AUTO_INCREMENT,
|
||||||
|
project_id BIGINT COMMENT '项目ID',
|
||||||
|
check_item VARCHAR(100) COMMENT '检查项：完整性/一致性/连续性',
|
||||||
|
check_result DECIMAL(5,2) COMMENT '检查结果百分比',
|
||||||
|
issue_count INT COMMENT '问题数量',
|
||||||
|
issue_detail TEXT COMMENT '问题详情',
|
||||||
|
create_time DATETIME DEFAULT CURRENT_TIMESTAMP
|
||||||
|
) COMMENT '数据质量检查表';
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### 2.3 页面2：参数配置
|
||||||
|
|
||||||
|
#### 功能描述
|
||||||
|
配置风险监测模型的阈值参数。
|
||||||
|
|
||||||
|
#### 页面元素
|
||||||
|
| 元素类型 | 元素名称/内容 | 说明 |
|
||||||
|
|---------|--------------|------|
|
||||||
|
| 模型名称 | 大额交易模型 | 下拉选择 |
|
||||||
|
| 阈值参数配置表格 | | |
|
||||||
|
| 表格列1 | 监测项 | 如：单笔交易额 |
|
||||||
|
| 表格列2 | 描述 | 如：单笔超过该金额视为大额交易 |
|
||||||
|
| 表格列3 | 阈值设置 | 输入框，如：50000 |
|
||||||
|
| 表格列4 | 单位 | 如：元 |
|
||||||
|
| 操作按钮 | 保存配置 | 保存当前配置 |
|
||||||
|
| | 恢复默认 | 恢复默认值 |
|
||||||
|
| | 一键导出配置 | 导出配置文件 |
|
||||||
|
|
||||||
|
#### 监测项配置
|
||||||
|
1. **单笔交易额**: 50000元
|
||||||
|
2. **累计交易额**: 5000000元
|
||||||
|
3. **大额存现**: 200000元
|
||||||
|
4. **短时多次存现**: 100000元/4小时
|
||||||
|
5. **频繁转账**: 10次/日
|
||||||
|
6. **转账频率**: 1000000元/日
|
||||||
|
|
||||||
|
#### 数据模型
|
||||||
|
```sql
|
||||||
|
-- 风险模型表
|
||||||
|
CREATE TABLE ccdi_risk_model (
|
||||||
|
model_id BIGINT PRIMARY KEY AUTO_INCREMENT,
|
||||||
|
model_name VARCHAR(200) NOT NULL COMMENT '模型名称',
|
||||||
|
model_code VARCHAR(100) COMMENT '模型编码',
|
||||||
|
status VARCHAR(50) DEFAULT 'active' COMMENT '状态',
|
||||||
|
create_time DATETIME DEFAULT CURRENT_TIMESTAMP,
|
||||||
|
update_time DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
|
||||||
|
create_by VARCHAR(100),
|
||||||
|
update_by VARCHAR(100)
|
||||||
|
) COMMENT '风险模型表';
|
||||||
|
|
||||||
|
-- 模型参数配置表
|
||||||
|
CREATE TABLE ccdi_model_parameter (
|
||||||
|
parameter_id BIGINT PRIMARY KEY AUTO_INCREMENT,
|
||||||
|
model_id BIGINT COMMENT '模型ID',
|
||||||
|
parameter_name VARCHAR(200) COMMENT '参数名称',
|
||||||
|
parameter_code VARCHAR(100) COMMENT '参数编码',
|
||||||
|
parameter_desc VARCHAR(500) COMMENT '参数描述',
|
||||||
|
threshold_value DECIMAL(20,2) COMMENT '阈值',
|
||||||
|
unit VARCHAR(50) COMMENT '单位',
|
||||||
|
create_time DATETIME DEFAULT CURRENT_TIMESTAMP,
|
||||||
|
update_time DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP
|
||||||
|
) COMMENT '模型参数配置表';
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### 2.4 页面3：初核提示
|
||||||
|
|
||||||
|
#### 功能描述
|
||||||
|
展示初核结果的总体概况，包括人员风险分布、模型触发情况、可疑交易明细等。
|
||||||
|
|
||||||
|
#### 页面元素
|
||||||
|
| 元素类型 | 元素名称/内容 | 说明 |
|
||||||
|
|---------|--------------|------|
|
||||||
|
| 统计卡片 | 总人数 | 显示总人数（如500） |
|
||||||
|
| | 无预警人数 | 显示无预警人数（如432） |
|
||||||
|
| | 低风险 | 显示低风险人数（如38） |
|
||||||
|
| | 中风险 | 显示中风险人数（如20） |
|
||||||
|
| | 高风险 | 显示高风险人数（如10） |
|
||||||
|
| 模型触发情况表格 | 模型名称 | 如：大额交易监测 |
|
||||||
|
| | 触发数 | 触发次数 |
|
||||||
|
| | 触发人员 | 触发人员列表 |
|
||||||
|
| | 操作 | 查看详情 |
|
||||||
|
| 涉疑交易明细表 | 交易时间、可疑人员、关联人、关联员工、关系、摘要/交易类型、交易金额、操作 | |
|
||||||
|
| 高风险人员清单 | 姓名、身份证号、所属部门、风险评分、触发模型数、核心异常点、操作 | 复选框支持批量操作 |
|
||||||
|
| 中风险人员TOP10 | 姓名、身份证号、所属部门、触发模型、触发模型数、操作 | |
|
||||||
|
| 异常账户清单 | 账户号、开户人姓名、开户银行、异常类型、异常发生时间、状态、操作 | |
|
||||||
|
| 涉及违法人员清单表 | 姓名、身份证号、失信被执行人、刑事判决、行政处罚、公安涉案记录、限制高消费、违法信息更新时间、操作 | |
|
||||||
|
| 筛选条件 | 姓名/工号搜索 | 输入框 |
|
||||||
|
| | 部门筛选 | 下拉选择 |
|
||||||
|
| | 风险等级筛选 | 下拉选择（全部/高风险/中风险/低风险） |
|
||||||
|
| | 可疑人员类型筛选 | 下拉选择（全部/名单库命中/模型规则命中） |
|
||||||
|
| | 模型筛选 | 复选框（大额交易/可疑财产/频繁转账等） |
|
||||||
|
| | 模型筛选逻辑 | 单选：同时触发以上模型/触发任意模型 |
|
||||||
|
| 批量操作 | 批量生成报告 | |
|
||||||
|
| | 批量导出证据 | |
|
||||||
|
| | 批量添加到关注列表 | |
|
||||||
|
|
||||||
|
#### 数据模型
|
||||||
|
```sql
|
||||||
|
-- 人员风险评分表
|
||||||
|
CREATE TABLE ccdi_person_risk_score (
|
||||||
|
score_id BIGINT PRIMARY KEY AUTO_INCREMENT,
|
||||||
|
project_id BIGINT COMMENT '项目ID',
|
||||||
|
person_id BIGINT COMMENT '人员ID',
|
||||||
|
person_name VARCHAR(100) COMMENT '姓名',
|
||||||
|
id_card VARCHAR(50) COMMENT '身份证号',
|
||||||
|
department VARCHAR(200) COMMENT '所属部门',
|
||||||
|
risk_level VARCHAR(50) COMMENT '风险等级：高/中/低',
|
||||||
|
risk_score INT COMMENT '风险评分',
|
||||||
|
trigger_model_count INT COMMENT '触发模型数量',
|
||||||
|
core_issue VARCHAR(500) COMMENT '核心异常点',
|
||||||
|
create_time DATETIME DEFAULT CURRENT_TIMESTAMP
|
||||||
|
) COMMENT '人员风险评分表';
|
||||||
|
|
||||||
|
-- 模型触发记录表
|
||||||
|
CREATE TABLE ccdi_model_trigger_record (
|
||||||
|
trigger_id BIGINT PRIMARY KEY AUTO_INCREMENT,
|
||||||
|
project_id BIGINT COMMENT '项目ID',
|
||||||
|
model_id BIGINT COMMENT '模型ID',
|
||||||
|
model_name VARCHAR(200) COMMENT '模型名称',
|
||||||
|
trigger_count INT COMMENT '触发次数',
|
||||||
|
trigger_persons TEXT COMMENT '触发人员列表',
|
||||||
|
create_time DATETIME DEFAULT CURRENT_TIMESTAMP
|
||||||
|
) COMMENT '模型触发记录表';
|
||||||
|
|
||||||
|
-- 涉疑交易明细表
|
||||||
|
CREATE TABLE ccdi_suspicious_transaction (
|
||||||
|
transaction_id BIGINT PRIMARY KEY AUTO_INCREMENT,
|
||||||
|
project_id BIGINT COMMENT '项目ID',
|
||||||
|
transaction_time DATETIME COMMENT '交易时间',
|
||||||
|
suspicious_person VARCHAR(100) COMMENT '可疑人员',
|
||||||
|
related_person VARCHAR(100) COMMENT '关联人',
|
||||||
|
related_employee VARCHAR(100) COMMENT '关联员工',
|
||||||
|
relationship VARCHAR(100) COMMENT '关系',
|
||||||
|
transaction_type VARCHAR(200) COMMENT '摘要/交易类型',
|
||||||
|
transaction_amount DECIMAL(20,2) COMMENT '交易金额',
|
||||||
|
create_time DATETIME DEFAULT CURRENT_TIMESTAMP
|
||||||
|
) COMMENT '涉嫌交易明细表';
|
||||||
|
|
||||||
|
-- 异常账户表
|
||||||
|
CREATE TABLE ccdi_abnormal_account (
|
||||||
|
account_id BIGINT PRIMARY KEY AUTO_INCREMENT,
|
||||||
|
project_id BIGINT COMMENT '项目ID',
|
||||||
|
account_no VARCHAR(100) COMMENT '账户号',
|
||||||
|
account_holder VARCHAR(100) COMMENT '开户人姓名',
|
||||||
|
bank_name VARCHAR(200) COMMENT '开户银行',
|
||||||
|
abnormal_type VARCHAR(100) COMMENT '异常类型',
|
||||||
|
abnormal_time DATETIME COMMENT '异常发生时间',
|
||||||
|
account_status VARCHAR(50) COMMENT '状态',
|
||||||
|
create_time DATETIME DEFAULT CURRENT_TIMESTAMP
|
||||||
|
) COMMENT '异常账户表';
|
||||||
|
|
||||||
|
-- 违法人员信息表
|
||||||
|
CREATE TABLE ccdi_illegal_person_info (
|
||||||
|
info_id BIGINT PRIMARY KEY AUTO_INCREMENT,
|
||||||
|
person_id BIGINT COMMENT '人员ID',
|
||||||
|
person_name VARCHAR(100) COMMENT '姓名',
|
||||||
|
id_card VARCHAR(50) COMMENT '身份证号',
|
||||||
|
is_dishonesty_executor VARCHAR(10) COMMENT '是否失信被执行人',
|
||||||
|
is_criminal_penalty VARCHAR(10) COMMENT '是否有刑事判决',
|
||||||
|
is_administrative_penalty VARCHAR(10) COMMENT '是否有行政处罚',
|
||||||
|
is_police_case VARCHAR(10) COMMENT '是否有公安涉案记录',
|
||||||
|
is_limit_consumption VARCHAR(10) COMMENT '是否限制高消费',
|
||||||
|
update_time DATETIME COMMENT '违法信息更新时间',
|
||||||
|
create_time DATETIME DEFAULT CURRENT_TIMESTAMP
|
||||||
|
) COMMENT '违法人员信息表';
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### 2.5 页面4：专项排查工作台-高风险
|
||||||
|
|
||||||
|
#### 功能描述
|
||||||
|
针对高风险人员的详细排查工作台。
|
||||||
|
|
||||||
|
#### 页面元素
|
||||||
|
| 元素类型 | 元素名称/内容 | 说明 |
|
||||||
|
|---------|--------------|------|
|
||||||
|
| 排查对象信息 | 排查对象 | 如：李四 |
|
||||||
|
| | 姓名、工号、部门、职级、入职时间、风险等级、所属项目 | |
|
||||||
|
| 触发模型列表 | 触发模型（5个） | |
|
||||||
|
| | 大额交易监测 | 3笔 > 50万 |
|
||||||
|
| | 频繁转账监测 | 1小时25笔 |
|
||||||
|
| | 关联交易排查 | 配偶账户频繁交易 |
|
||||||
|
| | 异常销户监测 | 1个账户突然销户 |
|
||||||
|
| | 疑似赌博交易 | 涉赌商户5笔 |
|
||||||
|
| 初核评分 | 风险评分 | 如：85分（高风险阈值：60分） |
|
||||||
|
| 异常详情-大额交易 | 交易时间、本方账号/主体、对方名称/账户、摘要/交易类型、交易金额、标记状态 | 标记状态下拉：标记正常/标记可疑/确认异常 |
|
||||||
|
| 异常详情-频繁转账 | 时间段、总笔数、总金额、主要对手、模式特征、核查建议 | |
|
||||||
|
| 异常详情-关联交易 | 关联人、关联账户、交易特征、异常点、需核实 | |
|
||||||
|
| 排查工具箱 | 查看完整流水、查看征信报告、查看资产信息、关系图谱分析、资金流向分析、导出所有证据、添加到案例库 | |
|
||||||
|
| 排查进度标签页 | 异常明细、资产分析、征信摘要、关系人图谱、资金流向 | |
|
||||||
|
| 操作按钮 | 生成报告、生成排查报告、标记为案例、关注 | |
|
||||||
|
|
||||||
|
#### 数据模型
|
||||||
|
```sql
|
||||||
|
-- 排查对象表
|
||||||
|
CREATE TABLE ccdi_investigation_object (
|
||||||
|
object_id BIGINT PRIMARY KEY AUTO_INCREMENT,
|
||||||
|
project_id BIGINT COMMENT '项目ID',
|
||||||
|
person_id BIGINT COMMENT '人员ID',
|
||||||
|
person_name VARCHAR(100) COMMENT '姓名',
|
||||||
|
employee_no VARCHAR(100) COMMENT '工号',
|
||||||
|
department VARCHAR(200) COMMENT '部门',
|
||||||
|
position_level VARCHAR(100) COMMENT '职级',
|
||||||
|
entry_date DATE COMMENT '入职时间',
|
||||||
|
risk_level VARCHAR(50) COMMENT '风险等级',
|
||||||
|
risk_score INT COMMENT '风险评分',
|
||||||
|
investigation_status VARCHAR(50) COMMENT '排查状态',
|
||||||
|
create_time DATETIME DEFAULT CURRENT_TIMESTAMP,
|
||||||
|
update_time DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP
|
||||||
|
) COMMENT '排查对象表';
|
||||||
|
|
||||||
|
-- 排查触发模型表
|
||||||
|
CREATE TABLE ccdi_investigation_trigger_model (
|
||||||
|
trigger_model_id BIGINT PRIMARY KEY AUTO_INCREMENT,
|
||||||
|
object_id BIGINT COMMENT '排查对象ID',
|
||||||
|
model_id BIGINT COMMENT '模型ID',
|
||||||
|
model_name VARCHAR(200) COMMENT '模型名称',
|
||||||
|
trigger_desc VARCHAR(500) COMMENT '触发描述',
|
||||||
|
create_time DATETIME DEFAULT CURRENT_TIMESTAMP
|
||||||
|
) COMMENT '排查触发模型表';
|
||||||
|
|
||||||
|
-- 异常交易明细表
|
||||||
|
CREATE TABLE ccdi_abnormal_transaction_detail (
|
||||||
|
detail_id BIGINT PRIMARY KEY AUTO_INCREMENT,
|
||||||
|
object_id BIGINT COMMENT '排查对象ID',
|
||||||
|
transaction_time DATETIME COMMENT '交易时间',
|
||||||
|
own_account VARCHAR(200) COMMENT '本方账号/主体',
|
||||||
|
counterparty VARCHAR(200) COMMENT '对方名称/账户',
|
||||||
|
transaction_type VARCHAR(200) COMMENT '摘要/交易类型',
|
||||||
|
transaction_amount DECIMAL(20,2) COMMENT '交易金额',
|
||||||
|
mark_status VARCHAR(50) COMMENT '标记状态：正常/可疑/异常',
|
||||||
|
create_time DATETIME DEFAULT CURRENT_TIMESTAMP
|
||||||
|
) COMMENT '异常交易明细表';
|
||||||
|
|
||||||
|
-- 排查进度表
|
||||||
|
CREATE TABLE ccdi_investigation_progress (
|
||||||
|
progress_id BIGINT PRIMARY KEY AUTO_INCREMENT,
|
||||||
|
object_id BIGINT COMMENT '排查对象ID',
|
||||||
|
progress_type VARCHAR(100) COMMENT '进度类型：流水分析/征信分析/资产比对/人工核实',
|
||||||
|
progress_status VARCHAR(50) COMMENT '进度状态',
|
||||||
|
complete_time DATETIME COMMENT '完成时间',
|
||||||
|
create_time DATETIME DEFAULT CURRENT_TIMESTAMP
|
||||||
|
) COMMENT '排查进度表';
|
||||||
|
|
||||||
|
-- 关注列表表
|
||||||
|
CREATE TABLE ccdi_attention_list (
|
||||||
|
attention_id BIGINT PRIMARY KEY AUTO_INCREMENT,
|
||||||
|
object_id BIGINT COMMENT '排查对象ID',
|
||||||
|
person_id BIGINT COMMENT '人员ID',
|
||||||
|
attention_type VARCHAR(50) COMMENT '关注类型',
|
||||||
|
create_by VARCHAR(100) COMMENT '创建人',
|
||||||
|
create_time DATETIME DEFAULT CURRENT_TIMESTAMP
|
||||||
|
) COMMENT '关注列表表';
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### 2.6 页面5：专项排查
|
||||||
|
|
||||||
|
#### 功能描述
|
||||||
|
员工详查分析功能，包括资产收入分析、图谱分析、采购查询等。
|
||||||
|
|
||||||
|
#### 页面元素
|
||||||
|
| 元素类型 | 元素名称/内容 | 说明 |
|
||||||
|
|---------|--------------|------|
|
||||||
|
| 查询条件 | 身份证号 | 输入框 |
|
||||||
|
| | 开始日期、结束日期 | 日期选择器 |
|
||||||
|
| | 查询、重置 | 按钮 |
|
||||||
|
| 详查结果 | 详查结果描述 | 如：收入+负债远低于资产 |
|
||||||
|
| 基本信息 | 姓名、身份证号、资产/收入比 | |
|
||||||
|
| 收入分析 | 工资收入、其他收入 | 显示金额和百分比 |
|
||||||
|
| 本人资产分析 | 房产、存款、其他 | 显示金额和百分比 |
|
||||||
|
| 配偶资产分析 | 房产、车产、其他 | 显示金额和百分比 |
|
||||||
|
| 负债分析 | 房贷、其他贷款 | 显示金额和百分比 |
|
||||||
|
| 汇总信息 | 本人+配偶资产合计、总负债 | |
|
||||||
|
| 图谱分析标签页 | 关系人图谱、资金流图谱、实控账户图谱 | |
|
||||||
|
| 关系人图谱 | 姓名搜索框、生成图谱按钮 | |
|
||||||
|
| | 可视化图谱 | 显示配偶、对外投资、股东、高管关联等 |
|
||||||
|
| | 操作按钮 | 展开所有关联、仅显示直接关联、导出图谱、筛选、刷新 |
|
||||||
|
| 采购查询表格 | 序号、采购事项名称、交易日期、采购金额、供应商名称、对方账号、联系人、关联员工 | |
|
||||||
|
| 扩展查询标签页 | 采购查询、人员调动查询、招聘查询 | |
|
||||||
|
| 采购查询条件 | 采购时间范围、关联员工 | |
|
||||||
|
|
||||||
|
#### 数据模型
|
||||||
|
```sql
|
||||||
|
-- 员工资产分析表
|
||||||
|
CREATE TABLE ccdi_employee_asset_analysis (
|
||||||
|
analysis_id BIGINT PRIMARY KEY AUTO_INCREMENT,
|
||||||
|
person_id BIGINT COMMENT '人员ID',
|
||||||
|
person_name VARCHAR(100) COMMENT '姓名',
|
||||||
|
id_card VARCHAR(50) COMMENT '身份证号',
|
||||||
|
asset_income_ratio DECIMAL(10,2) COMMENT '资产/收入比',
|
||||||
|
annual_income DECIMAL(20,2) COMMENT '年收入',
|
||||||
|
own_asset DECIMAL(20,2) COMMENT '本人资产',
|
||||||
|
spouse_asset DECIMAL(20,2) COMMENT '配偶资产',
|
||||||
|
total_asset DECIMAL(20,2) COMMENT '本人+配偶资产合计',
|
||||||
|
total_liability DECIMAL(20,2) COMMENT '总负债',
|
||||||
|
income_salary DECIMAL(20,2) COMMENT '工资收入',
|
||||||
|
income_other DECIMAL(20,2) COMMENT '其他收入',
|
||||||
|
asset_house DECIMAL(20,2) COMMENT '房产',
|
||||||
|
asset_deposit DECIMAL(20,2) COMMENT '存款',
|
||||||
|
asset_other DECIMAL(20,2) COMMENT '其他',
|
||||||
|
liability_mortgage DECIMAL(20,2) COMMENT '房贷',
|
||||||
|
liability_loan DECIMAL(20,2) COMMENT '其他贷款',
|
||||||
|
spouse_asset_house DECIMAL(20,2) COMMENT '配偶房产',
|
||||||
|
spouse_asset_car DECIMAL(20,2) COMMENT '配偶车产',
|
||||||
|
spouse_asset_other DECIMAL(20,2) COMMENT '配偶其他',
|
||||||
|
create_time DATETIME DEFAULT CURRENT_TIMESTAMP
|
||||||
|
) COMMENT '员工资产分析表';
|
||||||
|
|
||||||
|
-- 关系人图谱表
|
||||||
|
CREATE TABLE ccdi_relationship_graph (
|
||||||
|
graph_id BIGINT PRIMARY KEY AUTO_INCREMENT,
|
||||||
|
person_id BIGINT COMMENT '人员ID',
|
||||||
|
related_person_name VARCHAR(100) COMMENT '关联人姓名',
|
||||||
|
relationship_type VARCHAR(100) COMMENT '关系类型：配偶/对外投资/股东/高管关联',
|
||||||
|
related_entity_name VARCHAR(200) COMMENT '关联实体名称',
|
||||||
|
share_ratio DECIMAL(5,2) COMMENT '持股比例',
|
||||||
|
position VARCHAR(200) COMMENT '职位',
|
||||||
|
create_time DATETIME DEFAULT CURRENT_TIMESTAMP
|
||||||
|
) COMMENT '关系人图谱表';
|
||||||
|
|
||||||
|
-- 采购查询记录表
|
||||||
|
CREATE TABLE ccdi_purchase_record (
|
||||||
|
purchase_id BIGINT PRIMARY KEY AUTO_INCREMENT,
|
||||||
|
purchase_name VARCHAR(500) COMMENT '采购事项名称',
|
||||||
|
transaction_date DATE COMMENT '交易日期',
|
||||||
|
purchase_amount DECIMAL(20,2) COMMENT '采购金额',
|
||||||
|
supplier_name VARCHAR(500) COMMENT '供应商名称',
|
||||||
|
supplier_account VARCHAR(200) COMMENT '对方账号',
|
||||||
|
contact_person VARCHAR(100) COMMENT '联系人',
|
||||||
|
related_employee VARCHAR(100) COMMENT '关联员工',
|
||||||
|
create_time DATETIME DEFAULT CURRENT_TIMESTAMP
|
||||||
|
) COMMENT '采购查询记录表';
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### 2.7 页面6：专项排查工作台-中风险
|
||||||
|
|
||||||
|
#### 功能描述
|
||||||
|
针对中风险人员的排查工作台，功能与高风险工作台类似，但风险等级不同。
|
||||||
|
|
||||||
|
#### 页面元素
|
||||||
|
与高风险工作台结构相同，主要区别：
|
||||||
|
- 风险等级显示为"中风险"
|
||||||
|
- 初核评分可能较低
|
||||||
|
- 触发模型数量可能较少
|
||||||
|
|
||||||
|
数据模型与高风险工作台共用。
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### 2.8 页面7：流水明细查询
|
||||||
|
|
||||||
|
#### 功能描述
|
||||||
|
查询和筛选银行流水明细。
|
||||||
|
|
||||||
|
#### 页面元素
|
||||||
|
| 元素类型 | 元素名称/内容 | 说明 |
|
||||||
|
|---------|--------------|------|
|
||||||
|
| 筛选条件 | 交易时间范围 | 开始日期、结束日期 |
|
||||||
|
| | 对方名称 | 输入框，支持空值筛选 |
|
||||||
|
| | 摘要 | 输入框，支持空值筛选 |
|
||||||
|
| | 分类 | 多选下拉 |
|
||||||
|
| | 本方主体 | 多选下拉 |
|
||||||
|
| | 本方银行 | 多选下拉 |
|
||||||
|
| | 本方账户 | 多选下拉 |
|
||||||
|
| | 交易金额 | 范围输入（最小～最大） |
|
||||||
|
| | 对方账户 | 输入框，支持空值筛选 |
|
||||||
|
| | 交易类型 | 输入框，支持空值筛选 |
|
||||||
|
| | 剔除关联方与本方 | 复选框 |
|
||||||
|
| | 查询、重置 | 按钮 |
|
||||||
|
| 流水类型切换 | 全部、流入、流出 | 单选或Tab切换 |
|
||||||
|
| 流水明细表格 | 交易时间、本行账户/主体、对方名称/账户、摘要/交易类型、交易金额、分类、操作 | 支持复选框 |
|
||||||
|
| 表格操作 | 修改分类 | 下拉或弹窗 |
|
||||||
|
| 底部操作栏 | 已筛选X笔流水，已选中X笔流水 | |
|
||||||
|
| | 导出流水 | |
|
||||||
|
| | 加入分析 | |
|
||||||
|
| 标签页 | 流水、对手方 | |
|
||||||
|
|
||||||
|
#### 数据模型
|
||||||
|
```sql
|
||||||
|
-- 流水明细表
|
||||||
|
CREATE TABLE ccdi_transaction_detail (
|
||||||
|
detail_id BIGINT PRIMARY KEY AUTO_INCREMENT,
|
||||||
|
project_id BIGINT COMMENT '项目ID',
|
||||||
|
transaction_time DATETIME COMMENT '交易时间',
|
||||||
|
own_account VARCHAR(200) COMMENT '本方账户/主体',
|
||||||
|
own_bank VARCHAR(200) COMMENT '本方银行',
|
||||||
|
counterparty_name VARCHAR(500) COMMENT '对方名称/账户',
|
||||||
|
counterparty_account VARCHAR(200) COMMENT '对方账户',
|
||||||
|
transaction_summary VARCHAR(500) COMMENT '摘要',
|
||||||
|
transaction_type VARCHAR(200) COMMENT '交易类型',
|
||||||
|
transaction_amount DECIMAL(20,2) COMMENT '交易金额',
|
||||||
|
transaction_direction VARCHAR(50) COMMENT '交易方向：流入/流出',
|
||||||
|
category VARCHAR(200) COMMENT '分类',
|
||||||
|
create_time DATETIME DEFAULT CURRENT_TIMESTAMP
|
||||||
|
) COMMENT '流水明细表';
|
||||||
|
|
||||||
|
-- 流水分类表
|
||||||
|
CREATE TABLE ccdi_transaction_category (
|
||||||
|
category_id BIGINT PRIMARY KEY AUTO_INCREMENT,
|
||||||
|
category_code VARCHAR(100) COMMENT '分类编码',
|
||||||
|
category_name VARCHAR(200) COMMENT '分类名称',
|
||||||
|
parent_id BIGINT COMMENT '父分类ID',
|
||||||
|
sort_order INT COMMENT '排序',
|
||||||
|
create_time DATETIME DEFAULT CURRENT_TIMESTAMP
|
||||||
|
) COMMENT '流水分类表';
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 三、模块划分与开发建议
|
||||||
|
|
||||||
|
### 3.1 后端模块划分
|
||||||
|
|
||||||
|
```
|
||||||
|
ruoyi-ccdi/ (新建模块)
|
||||||
|
├── controller/
|
||||||
|
│ ├── CcdiProjectController.java # 项目管理
|
||||||
|
│ ├── CcdiDataUploadController.java # 数据上传
|
||||||
|
│ ├── CcdiModelConfigController.java # 模型配置
|
||||||
|
│ ├── CcdiPreliminaryCheckController.java # 初核提示
|
||||||
|
│ ├── CcdiInvestigationController.java # 专项排查工作台
|
||||||
|
│ ├── CcdiSpecialCheckController.java # 专项排查
|
||||||
|
│ └── CcdiTransactionController.java # 流水明细查询
|
||||||
|
├── service/
|
||||||
|
│ ├── ICcdiProjectService.java
|
||||||
|
│ ├── ICcdiDataUploadService.java
|
||||||
|
│ ├── ICcdiModelConfigService.java
|
||||||
|
│ ├── ICcdiPreliminaryCheckService.java
|
||||||
|
│ ├── ICcdiInvestigationService.java
|
||||||
|
│ ├── ICcdiSpecialCheckService.java
|
||||||
|
│ └── ICcdiTransactionService.java
|
||||||
|
├── mapper/
|
||||||
|
│ ├── CcdiProjectMapper.java
|
||||||
|
│ ├── CcdiDataUploadMapper.java
|
||||||
|
│ ├── CcdiModelConfigMapper.java
|
||||||
|
│ ├── CcdiPreliminaryCheckMapper.java
|
||||||
|
│ ├── CcdiInvestigationMapper.java
|
||||||
|
│ ├── CcdiSpecialCheckMapper.java
|
||||||
|
│ └── CcdiTransactionMapper.java
|
||||||
|
├── domain/
|
||||||
|
│ ├── CcdiProject.java
|
||||||
|
│ ├── CcdiDataUpload.java
|
||||||
|
│ ├── CcdiModelConfig.java
|
||||||
|
│ ├── CcdiPersonRiskScore.java
|
||||||
|
│ ├── CcdiInvestigationObject.java
|
||||||
|
│ └── ...
|
||||||
|
├── dto/
|
||||||
|
│ ├── CcdiProjectQueryDTO.java
|
||||||
|
│ ├── CcdiDataUploadDTO.java
|
||||||
|
│ ├── CcdiModelConfigDTO.java
|
||||||
|
│ └── ...
|
||||||
|
└── vo/
|
||||||
|
├── CcdiProjectVO.java
|
||||||
|
├── CcdiPreliminaryCheckVO.java
|
||||||
|
├── CcdiInvestigationVO.java
|
||||||
|
└── ...
|
||||||
|
```
|
||||||
|
|
||||||
|
### 3.2 前端模块划分
|
||||||
|
|
||||||
|
```
|
||||||
|
ruoyi-ui/src/views/ccdi/
|
||||||
|
├── project/
|
||||||
|
│ ├── index.vue # 项目列表
|
||||||
|
│ ├── detail.vue # 项目详情
|
||||||
|
│ ├── upload.vue # 上传数据
|
||||||
|
│ └── components/
|
||||||
|
│ ├── UploadCard.vue # 上传卡片组件
|
||||||
|
│ ├── QualityCheck.vue # 数据质量检查组件
|
||||||
|
│ └── BlacklistSelect.vue # 名单库选择组件
|
||||||
|
├── model/
|
||||||
|
│ ├── config.vue # 参数配置
|
||||||
|
│ └── components/
|
||||||
|
│ └── ModelConfigTable.vue # 模型配置表格组件
|
||||||
|
├── preliminary/
|
||||||
|
│ ├── index.vue # 初核提示
|
||||||
|
│ └── components/
|
||||||
|
│ ├── RiskStatistics.vue # 风险统计卡片
|
||||||
|
│ ├── ModelTriggerTable.vue # 模型触发表格
|
||||||
|
│ ├── SuspiciousTransactionTable.vue # 涉疑交易表格
|
||||||
|
│ └── PersonRiskList.vue # 人员风险列表
|
||||||
|
├── investigation/
|
||||||
|
│ ├── high-risk.vue # 高风险工作台
|
||||||
|
│ ├── mid-risk.vue # 中风险工作台
|
||||||
|
│ └── components/
|
||||||
|
│ ├── ObjectInfo.vue # 排查对象信息
|
||||||
|
│ ├── AbnormalTransaction.vue # 异常交易明细
|
||||||
|
│ ├── InvestigationTools.vue # 排查工具箱
|
||||||
|
│ └── InvestigationTabs.vue # 排查进度标签页
|
||||||
|
├── special/
|
||||||
|
│ ├── index.vue # 专项排查
|
||||||
|
│ └── components/
|
||||||
|
│ ├── AssetAnalysis.vue # 资产分析
|
||||||
|
│ ├── RelationshipGraph.vue # 关系人图谱
|
||||||
|
│ └── PurchaseTable.vue # 采购查询表格
|
||||||
|
└── transaction/
|
||||||
|
└── index.vue # 流水明细查询
|
||||||
|
```
|
||||||
|
|
||||||
|
### 3.3 开发顺序建议
|
||||||
|
|
||||||
|
1. **第一阶段：基础数据管理**
|
||||||
|
- 项目管理（创建、查询、更新）
|
||||||
|
- 数据上传功能
|
||||||
|
- 数据质量检查
|
||||||
|
|
||||||
|
2. **第二阶段：模型配置**
|
||||||
|
- 风险模型配置
|
||||||
|
- 模型参数配置
|
||||||
|
- 模型触发规则
|
||||||
|
|
||||||
|
3. **第三阶段：初核分析**
|
||||||
|
- 初核提示页面
|
||||||
|
- 风险评分计算
|
||||||
|
- 人员风险分类
|
||||||
|
|
||||||
|
4. **第四阶段：排查工作台**
|
||||||
|
- 高风险工作台
|
||||||
|
- 中风险工作台
|
||||||
|
- 排查进度跟踪
|
||||||
|
|
||||||
|
5. **第五阶段：专项排查**
|
||||||
|
- 员工详查分析
|
||||||
|
- 资产收入分析
|
||||||
|
- 关系图谱分析
|
||||||
|
- 采购查询
|
||||||
|
|
||||||
|
6. **第六阶段：流水查询**
|
||||||
|
- 流水明细查询
|
||||||
|
- 多维度筛选
|
||||||
|
- 流水分类管理
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 四、关键技术要点
|
||||||
|
|
||||||
|
### 4.1 文件上传处理
|
||||||
|
- 支持Excel、PDF、HTML多种格式
|
||||||
|
- 需要实现文件解析功能
|
||||||
|
- 大文件上传需要分片处理
|
||||||
|
- 上传进度显示
|
||||||
|
|
||||||
|
### 4.2 数据质量检查
|
||||||
|
- 数据完整性检查
|
||||||
|
- 格式一致性检查
|
||||||
|
- 余额连续性检查
|
||||||
|
- 异常数据识别
|
||||||
|
|
||||||
|
### 4.3 风险评分模型
|
||||||
|
- 可配置的风险模型
|
||||||
|
- 可配置的阈值参数
|
||||||
|
- 多模型触发计算
|
||||||
|
- 风险等级分类
|
||||||
|
|
||||||
|
### 4.4 图谱可视化
|
||||||
|
- 关系人图谱展示
|
||||||
|
- 资金流向图谱
|
||||||
|
- 实控账户图谱
|
||||||
|
- 图谱交互操作
|
||||||
|
|
||||||
|
### 4.5 数据导出
|
||||||
|
- 支持多种导出格式
|
||||||
|
- 大数据量导出优化
|
||||||
|
- 批量导出功能
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 五、接口设计建议
|
||||||
|
|
||||||
|
### 5.1 项目管理接口
|
||||||
|
|
||||||
|
```
|
||||||
|
POST /ccdi/project/list # 项目列表查询
|
||||||
|
GET /ccdi/project/{id} # 项目详情
|
||||||
|
POST /ccdi/project # 新增项目
|
||||||
|
PUT /ccdi/project # 更新项目
|
||||||
|
DELETE /ccdi/project/{id} # 删除项目
|
||||||
|
```
|
||||||
|
|
||||||
|
### 5.2 数据上传接口
|
||||||
|
|
||||||
|
```
|
||||||
|
POST /ccdi/upload/transaction # 上传流水文件
|
||||||
|
POST /ccdi/upload/credit # 上传征信文件
|
||||||
|
POST /ccdi/upload/relation # 上传家庭关系文件
|
||||||
|
GET /ccdi/upload/progress/{id} # 查询上传进度
|
||||||
|
POST /ccdi/upload/quality/check # 数据质量检查
|
||||||
|
```
|
||||||
|
|
||||||
|
### 5.3 初核分析接口
|
||||||
|
|
||||||
|
```
|
||||||
|
GET /ccdi/preliminary/statistics # 获取统计数据
|
||||||
|
GET /ccdi/preliminary/model/trigger # 模型触发情况
|
||||||
|
GET /ccdi/preliminary/transaction # 涉疑交易明细
|
||||||
|
GET /ccdi/preliminary/person/list # 人员风险列表
|
||||||
|
GET /ccdi/preliminary/abnormal/account # 异常账户列表
|
||||||
|
POST /ccdi/preliminary/batch/report # 批量生成报告
|
||||||
|
```
|
||||||
|
|
||||||
|
### 5.4 排查工作台接口
|
||||||
|
|
||||||
|
```
|
||||||
|
GET /ccdi/investigation/object/{id} # 获取排查对象详情
|
||||||
|
GET /ccdi/investigation/abnormal/{id} # 获取异常交易详情
|
||||||
|
GET /ccdi/investigation/progress/{id} # 获取排查进度
|
||||||
|
PUT /ccdi/investigation/mark/status # 标记状态
|
||||||
|
POST /ccdi/investigation/report # 生成排查报告
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 六、数据库表汇总
|
||||||
|
|
||||||
|
| 序号 | 表名 | 说明 |
|
||||||
|
|------|------|------|
|
||||||
|
| 1 | ccdi_project | 项目表 |
|
||||||
|
| 2 | ccdi_data_upload | 数据上传记录表 |
|
||||||
|
| 3 | ccdi_blacklist_selection | 名单库选择记录表 |
|
||||||
|
| 4 | ccdi_data_quality | 数据质量检查表 |
|
||||||
|
| 5 | ccdi_risk_model | 风险模型表 |
|
||||||
|
| 6 | ccdi_model_parameter | 模型参数配置表 |
|
||||||
|
| 7 | ccdi_person_risk_score | 人员风险评分表 |
|
||||||
|
| 8 | ccdi_model_trigger_record | 模型触发记录表 |
|
||||||
|
| 9 | ccdi_suspicious_transaction | 涉嫌交易明细表 |
|
||||||
|
| 10 | ccdi_abnormal_account | 异常账户表 |
|
||||||
|
| 11 | ccdi_illegal_person_info | 违法人员信息表 |
|
||||||
|
| 12 | ccdi_investigation_object | 排查对象表 |
|
||||||
|
| 13 | ccdi_investigation_trigger_model | 排查触发模型表 |
|
||||||
|
| 14 | ccdi_abnormal_transaction_detail | 异常交易明细表 |
|
||||||
|
| 15 | ccdi_investigation_progress | 排查进度表 |
|
||||||
|
| 16 | ccdi_attention_list | 关注列表表 |
|
||||||
|
| 17 | ccdi_employee_asset_analysis | 员工资产分析表 |
|
||||||
|
| 18 | ccdi_relationship_graph | 关系人图谱表 |
|
||||||
|
| 19 | ccdi_purchase_record | 采购查询记录表 |
|
||||||
|
| 20 | ccdi_transaction_detail | 流水明细表 |
|
||||||
|
| 21 | ccdi_transaction_category | 流水分类表 |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 七、前端组件建议
|
||||||
|
|
||||||
|
### 7.1 通用组件
|
||||||
|
|
||||||
|
```javascript
|
||||||
|
// components/ccdi/
|
||||||
|
├── UploadCard.vue # 文件上传卡片
|
||||||
|
├── RiskStatisticsCard.vue # 风险统计卡片
|
||||||
|
├── QualityProgressBar.vue # 质量检查进度条
|
||||||
|
├── ModelTriggerTable.vue # 模型触发表格
|
||||||
|
├── PersonRiskList.vue # 人员风险列表
|
||||||
|
├── TransactionTable.vue # 交易明细表格
|
||||||
|
├── RelationshipGraph.vue # 关系图谱组件
|
||||||
|
└── FilterPanel.vue # 筛选面板组件
|
||||||
|
```
|
||||||
|
|
||||||
|
### 7.2 图表组件
|
||||||
|
|
||||||
|
```javascript
|
||||||
|
// 使用ECharts实现
|
||||||
|
├── RiskDistributionChart.vue # 风险分布图
|
||||||
|
├── ModelTriggerChart.vue # 模型触发图表
|
||||||
|
├── AssetAnalysisChart.vue # 资产分析图表
|
||||||
|
└── RelationshipGraphChart.vue # 关系图谱
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 八、开发注意事项
|
||||||
|
|
||||||
|
### 8.1 权限控制
|
||||||
|
- 项目级权限控制
|
||||||
|
- 数据访问权限
|
||||||
|
- 敏感信息脱敏
|
||||||
|
|
||||||
|
### 8.2 性能优化
|
||||||
|
- 大数据量查询分页
|
||||||
|
- 索引优化
|
||||||
|
- 缓存策略
|
||||||
|
|
||||||
|
### 8.3 数据安全
|
||||||
|
- 敏感数据加密
|
||||||
|
- 操作日志记录
|
||||||
|
- 数据备份
|
||||||
|
|
||||||
|
### 8.4 用户体验
|
||||||
|
- 加载状态提示
|
||||||
|
- 操作反馈
|
||||||
|
- 错误提示
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 九、后续扩展方向
|
||||||
|
|
||||||
|
1. **智能分析**：引入机器学习算法，提高风险识别准确率
|
||||||
|
2. **移动端适配**：开发移动端应用，支持移动办公
|
||||||
|
3. **报表中心**：自定义报表功能
|
||||||
|
4. **预警机制**：实时预警通知
|
||||||
|
5. **案例库管理**：典型案例沉淀和复用
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
**文档版本**: v1.0
|
||||||
|
**创建时间**: 2025-01-30
|
||||||
|
**最后更新**: 2025-01-30
|
||||||
326
doc/后端枚举字段说明.md
Normal file
326
doc/后端枚举字段说明.md
Normal file
@@ -0,0 +1,326 @@
|
|||||||
|
# 后端枚举字段说明
|
||||||
|
|
||||||
|
## 概述
|
||||||
|
|
||||||
|
后端只返回枚举代码值，不返回枚举名称。前端需要根据代码值进行转换显示。
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 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. **国际化支持**：前端可以根据语言切换返回不同的名称
|
||||||
@@ -25,7 +25,7 @@ spring:
|
|||||||
druid:
|
druid:
|
||||||
# 主库数据源
|
# 主库数据源
|
||||||
master:
|
master:
|
||||||
url: jdbc:mysql://116.62.17.81:3306/discipline-prelim-check?useUnicode=true&characterEncoding=UTF-8&zeroDateTimeBehavior=convertToNull&useSSL=true&serverTimezone=GMT%2B8
|
url: jdbc:mysql://116.62.17.81:3306/ccdi?useUnicode=true&characterEncoding=UTF-8&zeroDateTimeBehavior=convertToNull&useSSL=true&serverTimezone=GMT%2B8
|
||||||
username: root
|
username: root
|
||||||
password: Kfcx@1234
|
password: Kfcx@1234
|
||||||
# 从库数据源
|
# 从库数据源
|
||||||
|
|||||||
@@ -17,7 +17,7 @@ import java.util.List;
|
|||||||
*
|
*
|
||||||
* @author ruoyi
|
* @author ruoyi
|
||||||
*/
|
*/
|
||||||
@Tag(name = "DPC枚举接口", description = "中介黑名单相关枚举选项接口")
|
@Tag(name = "枚举接口", description = "中介黑名单相关枚举选项接口")
|
||||||
@RestController
|
@RestController
|
||||||
@RequestMapping("/ccdi/enum")
|
@RequestMapping("/ccdi/enum")
|
||||||
public class CcdiEnumController {
|
public class CcdiEnumController {
|
||||||
|
|||||||
@@ -1,202 +0,0 @@
|
|||||||
package com.ruoyi.ccdi.controller;
|
|
||||||
|
|
||||||
import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
|
|
||||||
import com.ruoyi.ccdi.domain.CcdiIntermediaryBlacklist;
|
|
||||||
import com.ruoyi.ccdi.domain.dto.*;
|
|
||||||
import com.ruoyi.ccdi.domain.excel.CcdiIntermediaryBlacklistExcel;
|
|
||||||
import com.ruoyi.ccdi.domain.excel.CcdiIntermediaryEntityExcel;
|
|
||||||
import com.ruoyi.ccdi.domain.excel.CcdiIntermediaryPersonExcel;
|
|
||||||
import com.ruoyi.ccdi.domain.vo.CcdiIntermediaryBlacklistVO;
|
|
||||||
import com.ruoyi.ccdi.service.ICcdiIntermediaryBlacklistService;
|
|
||||||
import com.ruoyi.ccdi.utils.EasyExcelUtil;
|
|
||||||
import com.ruoyi.common.annotation.Log;
|
|
||||||
import com.ruoyi.common.core.controller.BaseController;
|
|
||||||
import com.ruoyi.common.core.domain.AjaxResult;
|
|
||||||
import com.ruoyi.common.core.page.PageDomain;
|
|
||||||
import com.ruoyi.common.core.page.TableDataInfo;
|
|
||||||
import com.ruoyi.common.core.page.TableSupport;
|
|
||||||
import com.ruoyi.common.enums.BusinessType;
|
|
||||||
import io.swagger.v3.oas.annotations.Operation;
|
|
||||||
import io.swagger.v3.oas.annotations.tags.Tag;
|
|
||||||
import jakarta.annotation.Resource;
|
|
||||||
import jakarta.servlet.http.HttpServletResponse;
|
|
||||||
import org.springframework.security.access.prepost.PreAuthorize;
|
|
||||||
import org.springframework.validation.annotation.Validated;
|
|
||||||
import org.springframework.web.bind.annotation.*;
|
|
||||||
import org.springframework.web.multipart.MultipartFile;
|
|
||||||
|
|
||||||
import java.util.List;
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 中介人员黑名单Controller
|
|
||||||
*
|
|
||||||
* @author ruoyi
|
|
||||||
* @date 2026-01-27
|
|
||||||
*/
|
|
||||||
@Tag(name = "中介黑名单管理")
|
|
||||||
@RestController
|
|
||||||
@RequestMapping("/ccdi/intermediary")
|
|
||||||
public class CcdiIntermediaryBlacklistController extends BaseController {
|
|
||||||
|
|
||||||
@Resource
|
|
||||||
private ICcdiIntermediaryBlacklistService intermediaryService;
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 查询中介黑名单列表
|
|
||||||
*/
|
|
||||||
@Operation(summary = "查询中介黑名单列表")
|
|
||||||
@PreAuthorize("@ss.hasPermi('ccdi:intermediary:list')")
|
|
||||||
@GetMapping("/list")
|
|
||||||
public TableDataInfo list(CcdiIntermediaryBlacklistQueryDTO queryDTO) {
|
|
||||||
// 使用MyBatis Plus分页
|
|
||||||
PageDomain pageDomain = TableSupport.buildPageRequest();
|
|
||||||
Page<CcdiIntermediaryBlacklist> page = new Page<>(pageDomain.getPageNum(), pageDomain.getPageSize());
|
|
||||||
Page<CcdiIntermediaryBlacklistVO> result = intermediaryService.selectIntermediaryPage(page, queryDTO);
|
|
||||||
return getDataTable(result.getRecords(), result.getTotal());
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 导出中介黑名单列表
|
|
||||||
*/
|
|
||||||
@Operation(summary = "导出中介黑名单列表")
|
|
||||||
@PreAuthorize("@ss.hasPermi('ccdi:intermediary:export')")
|
|
||||||
@Log(title = "中介黑名单", businessType = BusinessType.EXPORT)
|
|
||||||
@PostMapping("/export")
|
|
||||||
public void export(HttpServletResponse response, CcdiIntermediaryBlacklistQueryDTO queryDTO) {
|
|
||||||
List<CcdiIntermediaryBlacklistExcel> list = intermediaryService.selectIntermediaryListForExport(queryDTO);
|
|
||||||
EasyExcelUtil.exportExcel(response, list, CcdiIntermediaryBlacklistExcel.class, "中介黑名单");
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 获取中介黑名单详细信息（根据类型返回不同结构）
|
|
||||||
*/
|
|
||||||
@Operation(summary = "获取中介黑名单详细信息")
|
|
||||||
@PreAuthorize("@ss.hasPermi('ccdi:intermediary:query')")
|
|
||||||
@GetMapping(value = "/{intermediaryId}")
|
|
||||||
public AjaxResult getInfo(@PathVariable Long intermediaryId) {
|
|
||||||
return success(intermediaryService.selectIntermediaryDetailById(intermediaryId));
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 新增中介黑名单（已废弃，请使用类型专用接口）
|
|
||||||
*/
|
|
||||||
@Operation(summary = "新增中介黑名单（已废弃，请使用类型专用接口）")
|
|
||||||
@PreAuthorize("@ss.hasPermi('ccdi:intermediary:add')")
|
|
||||||
@Log(title = "中介黑名单", businessType = BusinessType.INSERT)
|
|
||||||
@PostMapping
|
|
||||||
@Deprecated
|
|
||||||
public AjaxResult add(@Validated @RequestBody CcdiIntermediaryBlacklistAddDTO addDTO) {
|
|
||||||
return toAjax(intermediaryService.insertIntermediary(addDTO));
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 新增个人中介黑名单
|
|
||||||
*/
|
|
||||||
@Operation(summary = "新增个人中介黑名单")
|
|
||||||
@PreAuthorize("@ss.hasPermi('ccdi:intermediary:add')")
|
|
||||||
@Log(title = "个人中介黑名单", businessType = BusinessType.INSERT)
|
|
||||||
@PostMapping("/person")
|
|
||||||
public AjaxResult addPerson(@Validated @RequestBody CcdiIntermediaryPersonAddDTO addDTO) {
|
|
||||||
return toAjax(intermediaryService.insertPersonIntermediary(addDTO));
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 新增机构中介黑名单
|
|
||||||
*/
|
|
||||||
@Operation(summary = "新增机构中介黑名单")
|
|
||||||
@PreAuthorize("@ss.hasPermi('ccdi:intermediary:add')")
|
|
||||||
@Log(title = "机构中介黑名单", businessType = BusinessType.INSERT)
|
|
||||||
@PostMapping("/entity")
|
|
||||||
public AjaxResult addEntity(@Validated @RequestBody CcdiIntermediaryEntityAddDTO addDTO) {
|
|
||||||
return toAjax(intermediaryService.insertEntityIntermediary(addDTO));
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 修改中介黑名单
|
|
||||||
*/
|
|
||||||
@Operation(summary = "修改中介黑名单（已废弃，请使用类型专用接口）")
|
|
||||||
@PreAuthorize("@ss.hasPermi('ccdi:intermediary:edit')")
|
|
||||||
@Log(title = "中介黑名单", businessType = BusinessType.UPDATE)
|
|
||||||
@PutMapping
|
|
||||||
@Deprecated
|
|
||||||
public AjaxResult edit(@Validated @RequestBody CcdiIntermediaryBlacklistEditDTO editDTO) {
|
|
||||||
return toAjax(intermediaryService.updateIntermediary(editDTO));
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 修改个人中介黑名单
|
|
||||||
*/
|
|
||||||
@Operation(summary = "修改个人中介黑名单")
|
|
||||||
@PreAuthorize("@ss.hasPermi('ccdi:intermediary:edit')")
|
|
||||||
@Log(title = "个人中介黑名单", businessType = BusinessType.UPDATE)
|
|
||||||
@PutMapping("/person")
|
|
||||||
public AjaxResult editPerson(@Validated @RequestBody CcdiIntermediaryPersonEditDTO editDTO) {
|
|
||||||
return toAjax(intermediaryService.updatePersonIntermediary(editDTO));
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 修改机构中介黑名单
|
|
||||||
*/
|
|
||||||
@Operation(summary = "修改机构中介黑名单")
|
|
||||||
@PreAuthorize("@ss.hasPermi('ccdi:intermediary:edit')")
|
|
||||||
@Log(title = "机构中介黑名单", businessType = BusinessType.UPDATE)
|
|
||||||
@PutMapping("/entity")
|
|
||||||
public AjaxResult editEntity(@Validated @RequestBody CcdiIntermediaryEntityEditDTO editDTO) {
|
|
||||||
return toAjax(intermediaryService.updateEntityIntermediary(editDTO));
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 删除中介黑名单
|
|
||||||
*/
|
|
||||||
@Operation(summary = "删除中介黑名单")
|
|
||||||
@PreAuthorize("@ss.hasPermi('ccdi:intermediary:remove')")
|
|
||||||
@Log(title = "中介黑名单", businessType = BusinessType.DELETE)
|
|
||||||
@DeleteMapping("/{intermediaryIds}")
|
|
||||||
public AjaxResult remove(@PathVariable Long[] intermediaryIds) {
|
|
||||||
return toAjax(intermediaryService.deleteIntermediaryByIds(intermediaryIds));
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 下载个人中介导入模板（带字典下拉框）
|
|
||||||
*/
|
|
||||||
@Operation(summary = "下载个人中介导入模板")
|
|
||||||
@PostMapping("/importPersonTemplate")
|
|
||||||
public void importPersonTemplate(HttpServletResponse response) {
|
|
||||||
EasyExcelUtil.importTemplateWithDictDropdown(response, CcdiIntermediaryPersonExcel.class, "个人中介黑名单");
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 下载机构中介导入模板（带字典下拉框）
|
|
||||||
*/
|
|
||||||
@Operation(summary = "下载机构中介导入模板")
|
|
||||||
@PostMapping("/importEntityTemplate")
|
|
||||||
public void importEntityTemplate(HttpServletResponse response) {
|
|
||||||
EasyExcelUtil.importTemplateWithDictDropdown(response, CcdiIntermediaryEntityExcel.class, "机构中介黑名单");
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 导入个人中介黑名单
|
|
||||||
*/
|
|
||||||
@Operation(summary = "导入个人中介黑名单")
|
|
||||||
@PreAuthorize("@ss.hasPermi('ccdi:intermediary:import')")
|
|
||||||
@Log(title = "中介黑名单", businessType = BusinessType.IMPORT)
|
|
||||||
@PostMapping("/importPersonData")
|
|
||||||
public AjaxResult importPersonData(@RequestParam("file") MultipartFile file, @RequestParam(value = "updateSupport", defaultValue = "false") boolean updateSupport) throws Exception {
|
|
||||||
List<CcdiIntermediaryPersonExcel> list = EasyExcelUtil.importExcel(file.getInputStream(), CcdiIntermediaryPersonExcel.class);
|
|
||||||
String message = intermediaryService.importPersonIntermediary(list, updateSupport);
|
|
||||||
return success(message);
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 导入机构中介黑名单
|
|
||||||
*/
|
|
||||||
@Operation(summary = "导入机构中介黑名单")
|
|
||||||
@PreAuthorize("@ss.hasPermi('ccdi:intermediary:import')")
|
|
||||||
@Log(title = "中介黑名单", businessType = BusinessType.IMPORT)
|
|
||||||
@PostMapping("/importEntityData")
|
|
||||||
public AjaxResult importEntityData(@RequestParam("file") MultipartFile file, @RequestParam(value = "updateSupport", defaultValue = "false") boolean updateSupport) throws Exception {
|
|
||||||
List<CcdiIntermediaryEntityExcel> list = EasyExcelUtil.importExcel(file.getInputStream(), CcdiIntermediaryEntityExcel.class);
|
|
||||||
String message = intermediaryService.importEntityIntermediary(list, updateSupport);
|
|
||||||
return success(message);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -0,0 +1,202 @@
|
|||||||
|
package com.ruoyi.ccdi.controller;
|
||||||
|
|
||||||
|
import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
|
||||||
|
import com.ruoyi.ccdi.domain.dto.CcdiIntermediaryEntityAddDTO;
|
||||||
|
import com.ruoyi.ccdi.domain.dto.CcdiIntermediaryEntityEditDTO;
|
||||||
|
import com.ruoyi.ccdi.domain.dto.CcdiIntermediaryPersonAddDTO;
|
||||||
|
import com.ruoyi.ccdi.domain.dto.CcdiIntermediaryPersonEditDTO;
|
||||||
|
import com.ruoyi.ccdi.domain.dto.CcdiIntermediaryQueryDTO;
|
||||||
|
import com.ruoyi.ccdi.domain.excel.CcdiIntermediaryEntityExcel;
|
||||||
|
import com.ruoyi.ccdi.domain.excel.CcdiIntermediaryPersonExcel;
|
||||||
|
import com.ruoyi.ccdi.domain.vo.CcdiIntermediaryEntityDetailVO;
|
||||||
|
import com.ruoyi.ccdi.domain.vo.CcdiIntermediaryPersonDetailVO;
|
||||||
|
import com.ruoyi.ccdi.domain.vo.CcdiIntermediaryVO;
|
||||||
|
import com.ruoyi.ccdi.service.ICcdiIntermediaryService;
|
||||||
|
import com.ruoyi.ccdi.utils.EasyExcelUtil;
|
||||||
|
import com.ruoyi.common.annotation.Log;
|
||||||
|
import com.ruoyi.common.core.controller.BaseController;
|
||||||
|
import com.ruoyi.common.core.domain.AjaxResult;
|
||||||
|
import com.ruoyi.common.core.page.PageDomain;
|
||||||
|
import com.ruoyi.common.core.page.TableDataInfo;
|
||||||
|
import com.ruoyi.common.core.page.TableSupport;
|
||||||
|
import com.ruoyi.common.enums.BusinessType;
|
||||||
|
import com.ruoyi.common.utils.StringUtils;
|
||||||
|
import io.swagger.v3.oas.annotations.Operation;
|
||||||
|
import io.swagger.v3.oas.annotations.tags.Tag;
|
||||||
|
import jakarta.annotation.Resource;
|
||||||
|
import jakarta.servlet.http.HttpServletResponse;
|
||||||
|
import org.springframework.security.access.prepost.PreAuthorize;
|
||||||
|
import org.springframework.validation.annotation.Validated;
|
||||||
|
import org.springframework.web.bind.annotation.*;
|
||||||
|
import org.springframework.web.multipart.MultipartFile;
|
||||||
|
|
||||||
|
import java.util.List;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 中介信息Controller
|
||||||
|
*
|
||||||
|
* @author ruoyi
|
||||||
|
* @date 2026-02-04
|
||||||
|
*/
|
||||||
|
@Tag(name = "中介信息管理")
|
||||||
|
@RestController
|
||||||
|
@RequestMapping("/ccdi/intermediary")
|
||||||
|
public class CcdiIntermediaryController extends BaseController {
|
||||||
|
|
||||||
|
@Resource
|
||||||
|
private ICcdiIntermediaryService intermediaryService;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 查询中介列表
|
||||||
|
*/
|
||||||
|
@Operation(summary = "查询中介列表")
|
||||||
|
@PreAuthorize("@ss.hasPermi('ccdi:intermediary:list')")
|
||||||
|
@GetMapping("/list")
|
||||||
|
public TableDataInfo list(CcdiIntermediaryQueryDTO queryDTO) {
|
||||||
|
PageDomain pageDomain = TableSupport.buildPageRequest();
|
||||||
|
Page<CcdiIntermediaryVO> page = new Page<>(pageDomain.getPageNum(), pageDomain.getPageSize());
|
||||||
|
Page<CcdiIntermediaryVO> result = intermediaryService.selectIntermediaryPage(page, queryDTO);
|
||||||
|
return getDataTable(result.getRecords(), result.getTotal());
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 查询个人中介详情
|
||||||
|
*/
|
||||||
|
@Operation(summary = "查询个人中介详情")
|
||||||
|
@PreAuthorize("@ss.hasPermi('ccdi:intermediary:query')")
|
||||||
|
@GetMapping("/person/{bizId}")
|
||||||
|
public AjaxResult getPersonInfo(@PathVariable String bizId) {
|
||||||
|
CcdiIntermediaryPersonDetailVO vo = intermediaryService.selectIntermediaryPersonDetail(bizId);
|
||||||
|
return success(vo);
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 查询实体中介详情
|
||||||
|
*/
|
||||||
|
@Operation(summary = "查询实体中介详情")
|
||||||
|
@PreAuthorize("@ss.hasPermi('ccdi:intermediary:query')")
|
||||||
|
@GetMapping("/entity/{socialCreditCode}")
|
||||||
|
public AjaxResult getEntityInfo(@PathVariable String socialCreditCode) {
|
||||||
|
CcdiIntermediaryEntityDetailVO vo = intermediaryService.selectIntermediaryEntityDetail(socialCreditCode);
|
||||||
|
return success(vo);
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 新增个人中介
|
||||||
|
*/
|
||||||
|
@Operation(summary = "新增个人中介")
|
||||||
|
@PreAuthorize("@ss.hasPermi('ccdi:intermediary:add')")
|
||||||
|
@Log(title = "个人中介", businessType = BusinessType.INSERT)
|
||||||
|
@PostMapping("/person")
|
||||||
|
public AjaxResult addPerson(@Validated @RequestBody CcdiIntermediaryPersonAddDTO addDTO) {
|
||||||
|
return toAjax(intermediaryService.insertIntermediaryPerson(addDTO));
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 修改个人中介
|
||||||
|
*/
|
||||||
|
@Operation(summary = "修改个人中介")
|
||||||
|
@PreAuthorize("@ss.hasPermi('ccdi:intermediary:edit')")
|
||||||
|
@Log(title = "个人中介", businessType = BusinessType.UPDATE)
|
||||||
|
@PutMapping("/person")
|
||||||
|
public AjaxResult editPerson(@Validated @RequestBody CcdiIntermediaryPersonEditDTO editDTO) {
|
||||||
|
return toAjax(intermediaryService.updateIntermediaryPerson(editDTO));
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 新增实体中介
|
||||||
|
*/
|
||||||
|
@Operation(summary = "新增实体中介")
|
||||||
|
@PreAuthorize("@ss.hasPermi('ccdi:intermediary:add')")
|
||||||
|
@Log(title = "实体中介", businessType = BusinessType.INSERT)
|
||||||
|
@PostMapping("/entity")
|
||||||
|
public AjaxResult addEntity(@Validated @RequestBody CcdiIntermediaryEntityAddDTO addDTO) {
|
||||||
|
return toAjax(intermediaryService.insertIntermediaryEntity(addDTO));
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 修改实体中介
|
||||||
|
*/
|
||||||
|
@Operation(summary = "修改实体中介")
|
||||||
|
@PreAuthorize("@ss.hasPermi('ccdi:intermediary:edit')")
|
||||||
|
@Log(title = "实体中介", businessType = BusinessType.UPDATE)
|
||||||
|
@PutMapping("/entity")
|
||||||
|
public AjaxResult editEntity(@Validated @RequestBody CcdiIntermediaryEntityEditDTO editDTO) {
|
||||||
|
return toAjax(intermediaryService.updateIntermediaryEntity(editDTO));
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 删除中介
|
||||||
|
*/
|
||||||
|
@Operation(summary = "删除中介")
|
||||||
|
@PreAuthorize("@ss.hasPermi('ccdi:intermediary:remove')")
|
||||||
|
@Log(title = "中介信息", businessType = BusinessType.DELETE)
|
||||||
|
@DeleteMapping("/{ids}")
|
||||||
|
public AjaxResult remove(@PathVariable String[] ids) {
|
||||||
|
return toAjax(intermediaryService.deleteIntermediaryByIds(ids));
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 校验人员ID唯一性
|
||||||
|
*/
|
||||||
|
@Operation(summary = "校验人员ID唯一性")
|
||||||
|
@GetMapping("/checkPersonIdUnique")
|
||||||
|
public AjaxResult checkPersonIdUnique(@RequestParam String personId, @RequestParam(required = false) String bizId) {
|
||||||
|
boolean unique = intermediaryService.checkPersonIdUnique(personId, bizId);
|
||||||
|
return success(unique);
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 校验统一社会信用代码唯一性
|
||||||
|
*/
|
||||||
|
@Operation(summary = "校验统一社会信用代码唯一性")
|
||||||
|
@GetMapping("/checkSocialCreditCodeUnique")
|
||||||
|
public AjaxResult checkSocialCreditCodeUnique(@RequestParam String socialCreditCode, @RequestParam(required = false) String excludeId) {
|
||||||
|
boolean unique = intermediaryService.checkSocialCreditCodeUnique(socialCreditCode, excludeId);
|
||||||
|
return success(unique);
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 下载个人中介导入模板
|
||||||
|
*/
|
||||||
|
@Operation(summary = "下载个人中介导入模板")
|
||||||
|
@PostMapping("/importPersonTemplate")
|
||||||
|
public void importPersonTemplate(HttpServletResponse response) {
|
||||||
|
EasyExcelUtil.importTemplateWithDictDropdown(response, CcdiIntermediaryPersonExcel.class, "个人中介信息");
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 下载实体中介导入模板
|
||||||
|
*/
|
||||||
|
@Operation(summary = "下载实体中介导入模板")
|
||||||
|
@PostMapping("/importEntityTemplate")
|
||||||
|
public void importEntityTemplate(HttpServletResponse response) {
|
||||||
|
EasyExcelUtil.importTemplateWithDictDropdown(response, CcdiIntermediaryEntityExcel.class, "实体中介信息");
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 导入个人中介数据
|
||||||
|
*/
|
||||||
|
@Operation(summary = "导入个人中介数据")
|
||||||
|
@PreAuthorize("@ss.hasPermi('ccdi:intermediary:import')")
|
||||||
|
@Log(title = "个人中介", businessType = BusinessType.IMPORT)
|
||||||
|
@PostMapping("/importPersonData")
|
||||||
|
public AjaxResult importPersonData(MultipartFile file, @RequestParam(defaultValue = "false") boolean updateSupport) throws Exception {
|
||||||
|
List<CcdiIntermediaryPersonExcel> list = EasyExcelUtil.importExcel(file.getInputStream(), CcdiIntermediaryPersonExcel.class);
|
||||||
|
String message = intermediaryService.importIntermediaryPerson(list, updateSupport);
|
||||||
|
return success(message);
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 导入实体中介数据
|
||||||
|
*/
|
||||||
|
@Operation(summary = "导入实体中介数据")
|
||||||
|
@PreAuthorize("@ss.hasPermi('ccdi:intermediary:import')")
|
||||||
|
@Log(title = "实体中介", businessType = BusinessType.IMPORT)
|
||||||
|
@PostMapping("/importEntityData")
|
||||||
|
public AjaxResult importEntityData(MultipartFile file, @RequestParam(defaultValue = "false") boolean updateSupport) throws Exception {
|
||||||
|
List<CcdiIntermediaryEntityExcel> list = EasyExcelUtil.importExcel(file.getInputStream(), CcdiIntermediaryEntityExcel.class);
|
||||||
|
String message = intermediaryService.importIntermediaryEntity(list, updateSupport);
|
||||||
|
return success(message);
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,93 @@
|
|||||||
|
package com.ruoyi.ccdi.domain;
|
||||||
|
|
||||||
|
import com.baomidou.mybatisplus.annotation.*;
|
||||||
|
import lombok.Data;
|
||||||
|
|
||||||
|
import java.io.Serial;
|
||||||
|
import java.io.Serializable;
|
||||||
|
import java.util.Date;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 个人中介对象 ccdi_biz_intermediary
|
||||||
|
*
|
||||||
|
* @author ruoyi
|
||||||
|
* @date 2026-02-04
|
||||||
|
*/
|
||||||
|
@Data
|
||||||
|
@TableName("ccdi_biz_intermediary")
|
||||||
|
public class CcdiBizIntermediary implements Serializable {
|
||||||
|
|
||||||
|
@Serial
|
||||||
|
private static final long serialVersionUID = 1L;
|
||||||
|
|
||||||
|
/** 人员ID */
|
||||||
|
@TableId(type = IdType.ASSIGN_UUID)
|
||||||
|
private String bizId;
|
||||||
|
|
||||||
|
/** 人员类型，中介、职业背债人、房产中介等 */
|
||||||
|
private String personType;
|
||||||
|
|
||||||
|
/** 人员子类型 */
|
||||||
|
private String personSubType;
|
||||||
|
|
||||||
|
/** 关系类型，如：配偶、子女、父母、兄弟姐妹等 */
|
||||||
|
private String relationType;
|
||||||
|
|
||||||
|
/** 姓名 */
|
||||||
|
private String name;
|
||||||
|
|
||||||
|
/** 性别 */
|
||||||
|
private String gender;
|
||||||
|
|
||||||
|
/** 证件类型 */
|
||||||
|
private String idType;
|
||||||
|
|
||||||
|
/** 证件号码 */
|
||||||
|
private String personId;
|
||||||
|
|
||||||
|
/** 手机号码 */
|
||||||
|
private String mobile;
|
||||||
|
|
||||||
|
/** 微信号 */
|
||||||
|
private String wechatNo;
|
||||||
|
|
||||||
|
/** 联系地址 */
|
||||||
|
private String contactAddress;
|
||||||
|
|
||||||
|
/** 所在公司 */
|
||||||
|
private String company;
|
||||||
|
|
||||||
|
/** 企业统一信用码 */
|
||||||
|
private String socialCreditCode;
|
||||||
|
|
||||||
|
/** 职位 */
|
||||||
|
private String position;
|
||||||
|
|
||||||
|
/** 关联人员ID */
|
||||||
|
private String relatedNumId;
|
||||||
|
|
||||||
|
/** 关联关系 */
|
||||||
|
private String relationTypeField;
|
||||||
|
|
||||||
|
/** 数据来源，MANUAL:手动录入, SYSTEM:系统同步, IMPORT:批量导入, API:接口获取 */
|
||||||
|
private String dataSource;
|
||||||
|
|
||||||
|
/** 备注信息 */
|
||||||
|
private String remark;
|
||||||
|
|
||||||
|
/** 记录创建人 */
|
||||||
|
@TableField(fill = FieldFill.INSERT)
|
||||||
|
private String createdBy;
|
||||||
|
|
||||||
|
/** 记录创建时间 */
|
||||||
|
@TableField(fill = FieldFill.INSERT)
|
||||||
|
private Date createTime;
|
||||||
|
|
||||||
|
/** 记录更新人 */
|
||||||
|
@TableField(fill = FieldFill.INSERT_UPDATE)
|
||||||
|
private String updatedBy;
|
||||||
|
|
||||||
|
/** 记录更新时间 */
|
||||||
|
@TableField(fill = FieldFill.INSERT_UPDATE)
|
||||||
|
private Date updateTime;
|
||||||
|
}
|
||||||
@@ -0,0 +1,99 @@
|
|||||||
|
package com.ruoyi.ccdi.domain;
|
||||||
|
|
||||||
|
import com.baomidou.mybatisplus.annotation.*;
|
||||||
|
import lombok.Data;
|
||||||
|
|
||||||
|
import java.io.Serial;
|
||||||
|
import java.io.Serializable;
|
||||||
|
import java.util.Date;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 企业主体信息对象 ccdi_enterprise_base_info
|
||||||
|
*
|
||||||
|
* @author ruoyi
|
||||||
|
* @date 2026-02-04
|
||||||
|
*/
|
||||||
|
@Data
|
||||||
|
@TableName("ccdi_enterprise_base_info")
|
||||||
|
public class CcdiEnterpriseBaseInfo implements Serializable {
|
||||||
|
|
||||||
|
@Serial
|
||||||
|
private static final long serialVersionUID = 1L;
|
||||||
|
|
||||||
|
/** 统一社会信用代码，员工企业关联关系表的外键 */
|
||||||
|
@TableId(type = IdType.INPUT)
|
||||||
|
private String socialCreditCode;
|
||||||
|
|
||||||
|
/** 企业名称 */
|
||||||
|
private String enterpriseName;
|
||||||
|
|
||||||
|
/** 企业类型,有限责任公司、股份有限公司、合伙企业、个体工商户、外资企业等 */
|
||||||
|
private String enterpriseType;
|
||||||
|
|
||||||
|
/** 企业性质,国企、民企、外企、合资、其他 */
|
||||||
|
private String enterpriseNature;
|
||||||
|
|
||||||
|
/** 行业分类 */
|
||||||
|
private String industryClass;
|
||||||
|
|
||||||
|
/** 所属行业 */
|
||||||
|
private String industryName;
|
||||||
|
|
||||||
|
/** 成立日期 */
|
||||||
|
private Date establishDate;
|
||||||
|
|
||||||
|
/** 注册地址 */
|
||||||
|
private String registerAddress;
|
||||||
|
|
||||||
|
/** 法定代表人 */
|
||||||
|
private String legalRepresentative;
|
||||||
|
|
||||||
|
/** 法定代表人证件类型 */
|
||||||
|
private String legalCertType;
|
||||||
|
|
||||||
|
/** 法定代表人证件号码 */
|
||||||
|
private String legalCertNo;
|
||||||
|
|
||||||
|
/** 股东1 */
|
||||||
|
private String shareholder1;
|
||||||
|
|
||||||
|
/** 股东2 */
|
||||||
|
private String shareholder2;
|
||||||
|
|
||||||
|
/** 股东3 */
|
||||||
|
private String shareholder3;
|
||||||
|
|
||||||
|
/** 股东4 */
|
||||||
|
private String shareholder4;
|
||||||
|
|
||||||
|
/** 股东5 */
|
||||||
|
private String shareholder5;
|
||||||
|
|
||||||
|
/** 经营状态 */
|
||||||
|
private String status;
|
||||||
|
|
||||||
|
/** 创建人 */
|
||||||
|
@TableField(fill = FieldFill.INSERT)
|
||||||
|
private String createdBy;
|
||||||
|
|
||||||
|
/** 创建时间 */
|
||||||
|
@TableField(fill = FieldFill.INSERT)
|
||||||
|
private Date createTime;
|
||||||
|
|
||||||
|
/** 更新人 */
|
||||||
|
@TableField(fill = FieldFill.INSERT_UPDATE)
|
||||||
|
private String updatedBy;
|
||||||
|
|
||||||
|
/** 更新时间 */
|
||||||
|
@TableField(fill = FieldFill.INSERT_UPDATE)
|
||||||
|
private Date updateTime;
|
||||||
|
|
||||||
|
/** 数据来源,MANUAL:手动录入, SYSTEM:系统同步, API:接口获取, IMPORT:批量导入 */
|
||||||
|
private String dataSource;
|
||||||
|
|
||||||
|
/** 风险等级：1-高风险, 2-中风险, 3-低风险 */
|
||||||
|
private String riskLevel;
|
||||||
|
|
||||||
|
/** 企业来源：GENERAL-一般企业, EMP_RELATION-员工关系人, CREDIT_CUSTOMER-信贷客户, INTERMEDIARY-中介, BOTH-兼有 */
|
||||||
|
private String entSource;
|
||||||
|
}
|
||||||
@@ -1,154 +0,0 @@
|
|||||||
package com.ruoyi.ccdi.domain;
|
|
||||||
|
|
||||||
import com.baomidou.mybatisplus.annotation.FieldFill;
|
|
||||||
import com.baomidou.mybatisplus.annotation.IdType;
|
|
||||||
import com.baomidou.mybatisplus.annotation.TableField;
|
|
||||||
import com.baomidou.mybatisplus.annotation.TableId;
|
|
||||||
import lombok.Data;
|
|
||||||
|
|
||||||
import java.io.Serial;
|
|
||||||
import java.io.Serializable;
|
|
||||||
import java.util.Date;
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 中介人员黑名单对象 dpc_intermediary_blacklist
|
|
||||||
*
|
|
||||||
* @author ruoyi
|
|
||||||
* @date 2026-01-27
|
|
||||||
*/
|
|
||||||
@Data
|
|
||||||
public class CcdiIntermediaryBlacklist implements Serializable {
|
|
||||||
|
|
||||||
@Serial
|
|
||||||
private static final long serialVersionUID = 1L;
|
|
||||||
|
|
||||||
/** 中介ID */
|
|
||||||
@TableId(type = IdType.AUTO)
|
|
||||||
private Long intermediaryId;
|
|
||||||
|
|
||||||
/** 姓名/机构名称 */
|
|
||||||
private String name;
|
|
||||||
|
|
||||||
/** 证件号 */
|
|
||||||
private String certificateNo;
|
|
||||||
|
|
||||||
/** 中介类型 */
|
|
||||||
private String intermediaryType;
|
|
||||||
|
|
||||||
/** 状态 */
|
|
||||||
private String status;
|
|
||||||
|
|
||||||
/** 备注 */
|
|
||||||
private String remark;
|
|
||||||
|
|
||||||
// ============================================================
|
|
||||||
// 个人类型字段 (以 indiv_ 前缀标识，individual 缩写)
|
|
||||||
// ============================================================
|
|
||||||
/** 人员类型（中介、职业背债人、房产中介等） */
|
|
||||||
private String indivType;
|
|
||||||
|
|
||||||
/** 人员子类型（本人、配偶等） */
|
|
||||||
private String indivSubType;
|
|
||||||
|
|
||||||
/** 性别（M男 F女 O其他） */
|
|
||||||
private String indivGender;
|
|
||||||
|
|
||||||
/** 证件类型 */
|
|
||||||
private String indivCertType;
|
|
||||||
|
|
||||||
/** 手机号码（加密存储） */
|
|
||||||
private String indivPhone;
|
|
||||||
|
|
||||||
/** 微信号 */
|
|
||||||
private String indivWechat;
|
|
||||||
|
|
||||||
/** 联系地址 */
|
|
||||||
private String indivAddress;
|
|
||||||
|
|
||||||
/** 所在公司 */
|
|
||||||
private String indivCompany;
|
|
||||||
|
|
||||||
/** 职位/职务 */
|
|
||||||
private String indivPosition;
|
|
||||||
|
|
||||||
/** 关联人员ID */
|
|
||||||
private String indivRelatedId;
|
|
||||||
|
|
||||||
/** 关联关系 */
|
|
||||||
private String indivRelation;
|
|
||||||
|
|
||||||
// ============================================================
|
|
||||||
// 机构类型字段 (以 corp_ 前缀标识，corporation 缩写)
|
|
||||||
// ============================================================
|
|
||||||
/** 统一社会信用代码 */
|
|
||||||
private String corpCreditCode;
|
|
||||||
|
|
||||||
/** 主体类型（有限责任公司、股份有限公司等） */
|
|
||||||
private String corpType;
|
|
||||||
|
|
||||||
/** 企业性质（国企、民企、外企等） */
|
|
||||||
private String corpNature;
|
|
||||||
|
|
||||||
/** 行业分类 */
|
|
||||||
private String corpIndustryCategory;
|
|
||||||
|
|
||||||
/** 所属行业 */
|
|
||||||
private String corpIndustry;
|
|
||||||
|
|
||||||
/** 成立日期 */
|
|
||||||
private Date corpEstablishDate;
|
|
||||||
|
|
||||||
/** 注册地址 */
|
|
||||||
private String corpAddress;
|
|
||||||
|
|
||||||
/** 法定代表人 */
|
|
||||||
private String corpLegalRep;
|
|
||||||
|
|
||||||
/** 法定代表人证件类型 */
|
|
||||||
private String corpLegalCertType;
|
|
||||||
|
|
||||||
/** 法定代表人证件号码 */
|
|
||||||
private String corpLegalCertNo;
|
|
||||||
|
|
||||||
/** 股东1 */
|
|
||||||
@TableField("corp_shareholder_1")
|
|
||||||
private String corpShareholder1;
|
|
||||||
|
|
||||||
/** 股东2 */
|
|
||||||
@TableField("corp_shareholder_2")
|
|
||||||
private String corpShareholder2;
|
|
||||||
|
|
||||||
/** 股东3 */
|
|
||||||
@TableField("corp_shareholder_3")
|
|
||||||
private String corpShareholder3;
|
|
||||||
|
|
||||||
/** 股东4 */
|
|
||||||
@TableField("corp_shareholder_4")
|
|
||||||
private String corpShareholder4;
|
|
||||||
|
|
||||||
/** 股东5 */
|
|
||||||
@TableField("corp_shareholder_5")
|
|
||||||
private String corpShareholder5;
|
|
||||||
|
|
||||||
// ============================================================
|
|
||||||
// 通用字段
|
|
||||||
// ============================================================
|
|
||||||
/** 数据来源（MANUAL手动录入 SYSTEM系统同步 IMPORT批量导入 API接口获取） */
|
|
||||||
private String dataSource;
|
|
||||||
|
|
||||||
/** 创建者 */
|
|
||||||
@TableField(fill = FieldFill.INSERT)
|
|
||||||
private String createBy;
|
|
||||||
|
|
||||||
/** 创建时间 */
|
|
||||||
@TableField(fill = FieldFill.INSERT)
|
|
||||||
private Date createTime;
|
|
||||||
|
|
||||||
/** 更新者 */
|
|
||||||
@TableField(fill = FieldFill.INSERT_UPDATE)
|
|
||||||
private String updateBy;
|
|
||||||
|
|
||||||
/** 更新时间 */
|
|
||||||
@TableField(fill = FieldFill.INSERT_UPDATE)
|
|
||||||
private Date updateTime;
|
|
||||||
}
|
|
||||||
@@ -1,68 +0,0 @@
|
|||||||
package com.ruoyi.ccdi.domain.dto;
|
|
||||||
|
|
||||||
import jakarta.validation.constraints.NotBlank;
|
|
||||||
import jakarta.validation.constraints.Size;
|
|
||||||
|
|
||||||
import java.io.Serial;
|
|
||||||
import java.io.Serializable;
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 中介人员黑名单新增 DTO
|
|
||||||
*
|
|
||||||
* @author ruoyi
|
|
||||||
* @date 2026-01-27
|
|
||||||
*/
|
|
||||||
public class CcdiIntermediaryBlacklistAddDTO implements Serializable {
|
|
||||||
|
|
||||||
@Serial
|
|
||||||
private static final long serialVersionUID = 1L;
|
|
||||||
|
|
||||||
/** 姓名/机构名称 */
|
|
||||||
@NotBlank(message = "姓名/机构名称不能为空")
|
|
||||||
@Size(min = 1, max = 100, message = "姓名/机构名称长度不能超过100个字符")
|
|
||||||
private String name;
|
|
||||||
|
|
||||||
/** 证件号 */
|
|
||||||
@Size(max = 50, message = "证件号长度不能超过50个字符")
|
|
||||||
private String certificateNo;
|
|
||||||
|
|
||||||
/** 中介类型 */
|
|
||||||
@NotBlank(message = "中介类型不能为空")
|
|
||||||
private String intermediaryType;
|
|
||||||
|
|
||||||
/** 备注 */
|
|
||||||
@Size(max = 500, message = "备注长度不能超过500个字符")
|
|
||||||
private String remark;
|
|
||||||
|
|
||||||
public String getName() {
|
|
||||||
return name;
|
|
||||||
}
|
|
||||||
|
|
||||||
public void setName(String name) {
|
|
||||||
this.name = name;
|
|
||||||
}
|
|
||||||
|
|
||||||
public String getCertificateNo() {
|
|
||||||
return certificateNo;
|
|
||||||
}
|
|
||||||
|
|
||||||
public void setCertificateNo(String certificateNo) {
|
|
||||||
this.certificateNo = certificateNo;
|
|
||||||
}
|
|
||||||
|
|
||||||
public String getIntermediaryType() {
|
|
||||||
return intermediaryType;
|
|
||||||
}
|
|
||||||
|
|
||||||
public void setIntermediaryType(String intermediaryType) {
|
|
||||||
this.intermediaryType = intermediaryType;
|
|
||||||
}
|
|
||||||
|
|
||||||
public String getRemark() {
|
|
||||||
return remark;
|
|
||||||
}
|
|
||||||
|
|
||||||
public void setRemark(String remark) {
|
|
||||||
this.remark = remark;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -1,386 +0,0 @@
|
|||||||
package com.ruoyi.ccdi.domain.dto;
|
|
||||||
|
|
||||||
import jakarta.validation.constraints.NotBlank;
|
|
||||||
import jakarta.validation.constraints.NotNull;
|
|
||||||
import jakarta.validation.constraints.Size;
|
|
||||||
|
|
||||||
import java.io.Serial;
|
|
||||||
import java.io.Serializable;
|
|
||||||
import java.util.Date;
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 中介人员黑名单编辑 DTO
|
|
||||||
*
|
|
||||||
* @author ruoyi
|
|
||||||
* @date 2026-01-27
|
|
||||||
*/
|
|
||||||
public class CcdiIntermediaryBlacklistEditDTO implements Serializable {
|
|
||||||
|
|
||||||
@Serial
|
|
||||||
private static final long serialVersionUID = 1L;
|
|
||||||
|
|
||||||
/** 中介ID */
|
|
||||||
@NotNull(message = "中介ID不能为空")
|
|
||||||
private Long intermediaryId;
|
|
||||||
|
|
||||||
/** 姓名/机构名称 */
|
|
||||||
@NotBlank(message = "姓名/机构名称不能为空")
|
|
||||||
@Size(min = 1, max = 100, message = "姓名/机构名称长度不能超过100个字符")
|
|
||||||
private String name;
|
|
||||||
|
|
||||||
/** 证件号 */
|
|
||||||
@Size(max = 50, message = "证件号长度不能超过50个字符")
|
|
||||||
private String certificateNo;
|
|
||||||
|
|
||||||
/** 中介类型 */
|
|
||||||
@NotBlank(message = "中介类型不能为空")
|
|
||||||
private String intermediaryType;
|
|
||||||
|
|
||||||
/** 状态 */
|
|
||||||
@NotBlank(message = "状态不能为空")
|
|
||||||
private String status;
|
|
||||||
|
|
||||||
/** 备注 */
|
|
||||||
@Size(max = 500, message = "备注长度不能超过500个字符")
|
|
||||||
private String remark;
|
|
||||||
|
|
||||||
// ============================================================
|
|
||||||
// 个人类型字段 (以 indiv_ 前缀标识，individual 缩写)
|
|
||||||
// ============================================================
|
|
||||||
/** 人员类型（中介、职业背债人、房产中介等） */
|
|
||||||
private String indivType;
|
|
||||||
|
|
||||||
/** 人员子类型（本人、配偶等） */
|
|
||||||
private String indivSubType;
|
|
||||||
|
|
||||||
/** 性别（M男 F女 O其他） */
|
|
||||||
private String indivGender;
|
|
||||||
|
|
||||||
/** 证件类型 */
|
|
||||||
private String indivCertType;
|
|
||||||
|
|
||||||
/** 手机号码（加密存储） */
|
|
||||||
private String indivPhone;
|
|
||||||
|
|
||||||
/** 微信号 */
|
|
||||||
private String indivWechat;
|
|
||||||
|
|
||||||
/** 联系地址 */
|
|
||||||
private String indivAddress;
|
|
||||||
|
|
||||||
/** 所在公司 */
|
|
||||||
private String indivCompany;
|
|
||||||
|
|
||||||
/** 职位/职务 */
|
|
||||||
private String indivPosition;
|
|
||||||
|
|
||||||
/** 关联人员ID */
|
|
||||||
private String indivRelatedId;
|
|
||||||
|
|
||||||
/** 关联关系 */
|
|
||||||
private String indivRelation;
|
|
||||||
|
|
||||||
// ============================================================
|
|
||||||
// 机构类型字段 (以 corp_ 前缀标识，corporation 缩写)
|
|
||||||
// ============================================================
|
|
||||||
/** 统一社会信用代码 */
|
|
||||||
private String corpCreditCode;
|
|
||||||
|
|
||||||
/** 主体类型（有限责任公司、股份有限公司等） */
|
|
||||||
private String corpType;
|
|
||||||
|
|
||||||
/** 企业性质（国企、民企、外企等） */
|
|
||||||
private String corpNature;
|
|
||||||
|
|
||||||
/** 行业分类 */
|
|
||||||
private String corpIndustryCategory;
|
|
||||||
|
|
||||||
/** 所属行业 */
|
|
||||||
private String corpIndustry;
|
|
||||||
|
|
||||||
/** 成立日期 */
|
|
||||||
private Date corpEstablishDate;
|
|
||||||
|
|
||||||
/** 注册地址 */
|
|
||||||
private String corpAddress;
|
|
||||||
|
|
||||||
/** 法定代表人 */
|
|
||||||
private String corpLegalRep;
|
|
||||||
|
|
||||||
/** 法定代表人证件类型 */
|
|
||||||
private String corpLegalCertType;
|
|
||||||
|
|
||||||
/** 法定代表人证件号码 */
|
|
||||||
private String corpLegalCertNo;
|
|
||||||
|
|
||||||
/** 股东1 */
|
|
||||||
private String corpShareholder1;
|
|
||||||
|
|
||||||
/** 股东2 */
|
|
||||||
private String corpShareholder2;
|
|
||||||
|
|
||||||
/** 股东3 */
|
|
||||||
private String corpShareholder3;
|
|
||||||
|
|
||||||
/** 股东4 */
|
|
||||||
private String corpShareholder4;
|
|
||||||
|
|
||||||
/** 股东5 */
|
|
||||||
private String corpShareholder5;
|
|
||||||
|
|
||||||
public Long getIntermediaryId() {
|
|
||||||
return intermediaryId;
|
|
||||||
}
|
|
||||||
|
|
||||||
public void setIntermediaryId(Long intermediaryId) {
|
|
||||||
this.intermediaryId = intermediaryId;
|
|
||||||
}
|
|
||||||
|
|
||||||
public String getName() {
|
|
||||||
return name;
|
|
||||||
}
|
|
||||||
|
|
||||||
public void setName(String name) {
|
|
||||||
this.name = name;
|
|
||||||
}
|
|
||||||
|
|
||||||
public String getCertificateNo() {
|
|
||||||
return certificateNo;
|
|
||||||
}
|
|
||||||
|
|
||||||
public void setCertificateNo(String certificateNo) {
|
|
||||||
this.certificateNo = certificateNo;
|
|
||||||
}
|
|
||||||
|
|
||||||
public String getIntermediaryType() {
|
|
||||||
return intermediaryType;
|
|
||||||
}
|
|
||||||
|
|
||||||
public void setIntermediaryType(String intermediaryType) {
|
|
||||||
this.intermediaryType = intermediaryType;
|
|
||||||
}
|
|
||||||
|
|
||||||
public String getStatus() {
|
|
||||||
return status;
|
|
||||||
}
|
|
||||||
|
|
||||||
public void setStatus(String status) {
|
|
||||||
this.status = status;
|
|
||||||
}
|
|
||||||
|
|
||||||
public String getRemark() {
|
|
||||||
return remark;
|
|
||||||
}
|
|
||||||
|
|
||||||
public void setRemark(String remark) {
|
|
||||||
this.remark = remark;
|
|
||||||
}
|
|
||||||
|
|
||||||
public String getIndivType() {
|
|
||||||
return indivType;
|
|
||||||
}
|
|
||||||
|
|
||||||
public void setIndivType(String indivType) {
|
|
||||||
this.indivType = indivType;
|
|
||||||
}
|
|
||||||
|
|
||||||
public String getIndivSubType() {
|
|
||||||
return indivSubType;
|
|
||||||
}
|
|
||||||
|
|
||||||
public void setIndivSubType(String indivSubType) {
|
|
||||||
this.indivSubType = indivSubType;
|
|
||||||
}
|
|
||||||
|
|
||||||
public String getIndivGender() {
|
|
||||||
return indivGender;
|
|
||||||
}
|
|
||||||
|
|
||||||
public void setIndivGender(String indivGender) {
|
|
||||||
this.indivGender = indivGender;
|
|
||||||
}
|
|
||||||
|
|
||||||
public String getIndivCertType() {
|
|
||||||
return indivCertType;
|
|
||||||
}
|
|
||||||
|
|
||||||
public void setIndivCertType(String indivCertType) {
|
|
||||||
this.indivCertType = indivCertType;
|
|
||||||
}
|
|
||||||
|
|
||||||
public String getIndivPhone() {
|
|
||||||
return indivPhone;
|
|
||||||
}
|
|
||||||
|
|
||||||
public void setIndivPhone(String indivPhone) {
|
|
||||||
this.indivPhone = indivPhone;
|
|
||||||
}
|
|
||||||
|
|
||||||
public String getIndivWechat() {
|
|
||||||
return indivWechat;
|
|
||||||
}
|
|
||||||
|
|
||||||
public void setIndivWechat(String indivWechat) {
|
|
||||||
this.indivWechat = indivWechat;
|
|
||||||
}
|
|
||||||
|
|
||||||
public String getIndivAddress() {
|
|
||||||
return indivAddress;
|
|
||||||
}
|
|
||||||
|
|
||||||
public void setIndivAddress(String indivAddress) {
|
|
||||||
this.indivAddress = indivAddress;
|
|
||||||
}
|
|
||||||
|
|
||||||
public String getIndivCompany() {
|
|
||||||
return indivCompany;
|
|
||||||
}
|
|
||||||
|
|
||||||
public void setIndivCompany(String indivCompany) {
|
|
||||||
this.indivCompany = indivCompany;
|
|
||||||
}
|
|
||||||
|
|
||||||
public String getIndivPosition() {
|
|
||||||
return indivPosition;
|
|
||||||
}
|
|
||||||
|
|
||||||
public void setIndivPosition(String indivPosition) {
|
|
||||||
this.indivPosition = indivPosition;
|
|
||||||
}
|
|
||||||
|
|
||||||
public String getIndivRelatedId() {
|
|
||||||
return indivRelatedId;
|
|
||||||
}
|
|
||||||
|
|
||||||
public void setIndivRelatedId(String indivRelatedId) {
|
|
||||||
this.indivRelatedId = indivRelatedId;
|
|
||||||
}
|
|
||||||
|
|
||||||
public String getIndivRelation() {
|
|
||||||
return indivRelation;
|
|
||||||
}
|
|
||||||
|
|
||||||
public void setIndivRelation(String indivRelation) {
|
|
||||||
this.indivRelation = indivRelation;
|
|
||||||
}
|
|
||||||
|
|
||||||
public String getCorpCreditCode() {
|
|
||||||
return corpCreditCode;
|
|
||||||
}
|
|
||||||
|
|
||||||
public void setCorpCreditCode(String corpCreditCode) {
|
|
||||||
this.corpCreditCode = corpCreditCode;
|
|
||||||
}
|
|
||||||
|
|
||||||
public String getCorpType() {
|
|
||||||
return corpType;
|
|
||||||
}
|
|
||||||
|
|
||||||
public void setCorpType(String corpType) {
|
|
||||||
this.corpType = corpType;
|
|
||||||
}
|
|
||||||
|
|
||||||
public String getCorpNature() {
|
|
||||||
return corpNature;
|
|
||||||
}
|
|
||||||
|
|
||||||
public void setCorpNature(String corpNature) {
|
|
||||||
this.corpNature = corpNature;
|
|
||||||
}
|
|
||||||
|
|
||||||
public String getCorpIndustryCategory() {
|
|
||||||
return corpIndustryCategory;
|
|
||||||
}
|
|
||||||
|
|
||||||
public void setCorpIndustryCategory(String corpIndustryCategory) {
|
|
||||||
this.corpIndustryCategory = corpIndustryCategory;
|
|
||||||
}
|
|
||||||
|
|
||||||
public String getCorpIndustry() {
|
|
||||||
return corpIndustry;
|
|
||||||
}
|
|
||||||
|
|
||||||
public void setCorpIndustry(String corpIndustry) {
|
|
||||||
this.corpIndustry = corpIndustry;
|
|
||||||
}
|
|
||||||
|
|
||||||
public Date getCorpEstablishDate() {
|
|
||||||
return corpEstablishDate;
|
|
||||||
}
|
|
||||||
|
|
||||||
public void setCorpEstablishDate(Date corpEstablishDate) {
|
|
||||||
this.corpEstablishDate = corpEstablishDate;
|
|
||||||
}
|
|
||||||
|
|
||||||
public String getCorpAddress() {
|
|
||||||
return corpAddress;
|
|
||||||
}
|
|
||||||
|
|
||||||
public void setCorpAddress(String corpAddress) {
|
|
||||||
this.corpAddress = corpAddress;
|
|
||||||
}
|
|
||||||
|
|
||||||
public String getCorpLegalRep() {
|
|
||||||
return corpLegalRep;
|
|
||||||
}
|
|
||||||
|
|
||||||
public void setCorpLegalRep(String corpLegalRep) {
|
|
||||||
this.corpLegalRep = corpLegalRep;
|
|
||||||
}
|
|
||||||
|
|
||||||
public String getCorpLegalCertType() {
|
|
||||||
return corpLegalCertType;
|
|
||||||
}
|
|
||||||
|
|
||||||
public void setCorpLegalCertType(String corpLegalCertType) {
|
|
||||||
this.corpLegalCertType = corpLegalCertType;
|
|
||||||
}
|
|
||||||
|
|
||||||
public String getCorpLegalCertNo() {
|
|
||||||
return corpLegalCertNo;
|
|
||||||
}
|
|
||||||
|
|
||||||
public void setCorpLegalCertNo(String corpLegalCertNo) {
|
|
||||||
this.corpLegalCertNo = corpLegalCertNo;
|
|
||||||
}
|
|
||||||
|
|
||||||
public String getCorpShareholder1() {
|
|
||||||
return corpShareholder1;
|
|
||||||
}
|
|
||||||
|
|
||||||
public void setCorpShareholder1(String corpShareholder1) {
|
|
||||||
this.corpShareholder1 = corpShareholder1;
|
|
||||||
}
|
|
||||||
|
|
||||||
public String getCorpShareholder2() {
|
|
||||||
return corpShareholder2;
|
|
||||||
}
|
|
||||||
|
|
||||||
public void setCorpShareholder2(String corpShareholder2) {
|
|
||||||
this.corpShareholder2 = corpShareholder2;
|
|
||||||
}
|
|
||||||
|
|
||||||
public String getCorpShareholder3() {
|
|
||||||
return corpShareholder3;
|
|
||||||
}
|
|
||||||
|
|
||||||
public void setCorpShareholder3(String corpShareholder3) {
|
|
||||||
this.corpShareholder3 = corpShareholder3;
|
|
||||||
}
|
|
||||||
|
|
||||||
public String getCorpShareholder4() {
|
|
||||||
return corpShareholder4;
|
|
||||||
}
|
|
||||||
|
|
||||||
public void setCorpShareholder4(String corpShareholder4) {
|
|
||||||
this.corpShareholder4 = corpShareholder4;
|
|
||||||
}
|
|
||||||
|
|
||||||
public String getCorpShareholder5() {
|
|
||||||
return corpShareholder5;
|
|
||||||
}
|
|
||||||
|
|
||||||
public void setCorpShareholder5(String corpShareholder5) {
|
|
||||||
this.corpShareholder5 = corpShareholder5;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -1,60 +0,0 @@
|
|||||||
package com.ruoyi.ccdi.domain.dto;
|
|
||||||
|
|
||||||
import java.io.Serial;
|
|
||||||
import java.io.Serializable;
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 中介人员黑名单查询 DTO
|
|
||||||
*
|
|
||||||
* @author ruoyi
|
|
||||||
* @date 2026-01-27
|
|
||||||
*/
|
|
||||||
public class CcdiIntermediaryBlacklistQueryDTO implements Serializable {
|
|
||||||
|
|
||||||
@Serial
|
|
||||||
private static final long serialVersionUID = 1L;
|
|
||||||
|
|
||||||
/** 姓名/机构名称（模糊查询） */
|
|
||||||
private String name;
|
|
||||||
|
|
||||||
/** 证件号（精确查询） */
|
|
||||||
private String certificateNo;
|
|
||||||
|
|
||||||
/** 中介类型 */
|
|
||||||
private String intermediaryType;
|
|
||||||
|
|
||||||
/** 状态 */
|
|
||||||
private String status;
|
|
||||||
|
|
||||||
public String getName() {
|
|
||||||
return name;
|
|
||||||
}
|
|
||||||
|
|
||||||
public void setName(String name) {
|
|
||||||
this.name = name;
|
|
||||||
}
|
|
||||||
|
|
||||||
public String getCertificateNo() {
|
|
||||||
return certificateNo;
|
|
||||||
}
|
|
||||||
|
|
||||||
public void setCertificateNo(String certificateNo) {
|
|
||||||
this.certificateNo = certificateNo;
|
|
||||||
}
|
|
||||||
|
|
||||||
public String getIntermediaryType() {
|
|
||||||
return intermediaryType;
|
|
||||||
}
|
|
||||||
|
|
||||||
public void setIntermediaryType(String intermediaryType) {
|
|
||||||
this.intermediaryType = intermediaryType;
|
|
||||||
}
|
|
||||||
|
|
||||||
public String getStatus() {
|
|
||||||
return status;
|
|
||||||
}
|
|
||||||
|
|
||||||
public void setStatus(String status) {
|
|
||||||
this.status = status;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -1,5 +1,6 @@
|
|||||||
package com.ruoyi.ccdi.domain.dto;
|
package com.ruoyi.ccdi.domain.dto;
|
||||||
|
|
||||||
|
import io.swagger.v3.oas.annotations.media.Schema;
|
||||||
import jakarta.validation.constraints.NotBlank;
|
import jakarta.validation.constraints.NotBlank;
|
||||||
import jakarta.validation.constraints.Size;
|
import jakarta.validation.constraints.Size;
|
||||||
import lombok.Data;
|
import lombok.Data;
|
||||||
@@ -9,87 +10,83 @@ import java.io.Serializable;
|
|||||||
import java.util.Date;
|
import java.util.Date;
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 机构中介新增 DTO
|
* 实体中介新增DTO
|
||||||
*
|
*
|
||||||
* @author ruoyi
|
* @author ruoyi
|
||||||
* @date 2026-01-29
|
* @date 2026-02-04
|
||||||
*/
|
*/
|
||||||
@Data
|
@Data
|
||||||
|
@Schema(description = "实体中介新增DTO")
|
||||||
public class CcdiIntermediaryEntityAddDTO implements Serializable {
|
public class CcdiIntermediaryEntityAddDTO implements Serializable {
|
||||||
|
|
||||||
@Serial
|
@Serial
|
||||||
private static final long serialVersionUID = 1L;
|
private static final long serialVersionUID = 1L;
|
||||||
|
|
||||||
/** 机构名称 */
|
@Schema(description = "机构名称")
|
||||||
@NotBlank(message = "机构名称不能为空")
|
@NotBlank(message = "机构名称不能为空")
|
||||||
@Size(min = 1, max = 100, message = "机构名称长度不能超过100个字符")
|
@Size(max = 200, message = "机构名称长度不能超过200个字符")
|
||||||
private String name;
|
private String enterpriseName;
|
||||||
|
|
||||||
/** 统一社会信用代码 */
|
@Schema(description = "统一社会信用代码")
|
||||||
@NotBlank(message = "统一社会信用代码不能为空")
|
@Size(max = 50, message = "统一社会信用代码长度不能超过50个字符")
|
||||||
@Size(max = 18, message = "统一社会信用代码长度不能超过18个字符")
|
private String socialCreditCode;
|
||||||
private String corpCreditCode;
|
|
||||||
|
|
||||||
/** 主体类型 */
|
@Schema(description = "主体类型")
|
||||||
@Size(max = 50, message = "主体类型长度不能超过50个字符")
|
@Size(max = 50, message = "主体类型长度不能超过50个字符")
|
||||||
private String corpType;
|
private String enterpriseType;
|
||||||
|
|
||||||
/** 企业性质 */
|
@Schema(description = "企业性质")
|
||||||
@Size(max = 50, message = "企业性质长度不能超过50个字符")
|
@Size(max = 50, message = "企业性质长度不能超过50个字符")
|
||||||
private String corpNature;
|
private String enterpriseNature;
|
||||||
|
|
||||||
/** 行业分类 */
|
@Schema(description = "行业分类")
|
||||||
@Size(max = 100, message = "行业分类长度不能超过100个字符")
|
@Size(max = 100, message = "行业分类长度不能超过100个字符")
|
||||||
private String corpIndustryCategory;
|
private String industryClass;
|
||||||
|
|
||||||
/** 所属行业 */
|
@Schema(description = "所属行业")
|
||||||
@Size(max = 100, message = "所属行业长度不能超过100个字符")
|
@Size(max = 100, message = "所属行业长度不能超过100个字符")
|
||||||
private String corpIndustry;
|
private String industryName;
|
||||||
|
|
||||||
/** 成立日期 */
|
@Schema(description = "成立日期")
|
||||||
private Date corpEstablishDate;
|
private Date establishDate;
|
||||||
|
|
||||||
/** 注册地址 */
|
@Schema(description = "注册地址")
|
||||||
@Size(max = 500, message = "注册地址长度不能超过500个字符")
|
@Size(max = 500, message = "注册地址长度不能超过500个字符")
|
||||||
private String corpAddress;
|
private String registerAddress;
|
||||||
|
|
||||||
/** 法定代表人 */
|
@Schema(description = "法定代表人")
|
||||||
@Size(max = 50, message = "法定代表人长度不能超过50个字符")
|
@Size(max = 100, message = "法定代表人长度不能超过100个字符")
|
||||||
private String corpLegalRep;
|
private String legalRepresentative;
|
||||||
|
|
||||||
/** 法定代表人证件类型 */
|
@Schema(description = "法定代表人证件类型")
|
||||||
@Size(max = 30, message = "法定代表人证件类型长度不能超过30个字符")
|
@Size(max = 50, message = "法定代表人证件类型长度不能超过50个字符")
|
||||||
private String corpLegalCertType;
|
private String legalCertType;
|
||||||
|
|
||||||
/** 法定代表人证件号码 */
|
@Schema(description = "法定代表人证件号码")
|
||||||
@Size(max = 30, message = "法定代表人证件号码长度不能超过30个字符")
|
@Size(max = 50, message = "法定代表人证件号码长度不能超过50个字符")
|
||||||
private String corpLegalCertNo;
|
private String legalCertNo;
|
||||||
|
|
||||||
/** 股东1 */
|
@Schema(description = "股东1")
|
||||||
@Size(max = 30, message = "股东1长度不能超过30个字符")
|
@Size(max = 100, message = "股东1长度不能超过100个字符")
|
||||||
private String corpShareholder1;
|
private String shareholder1;
|
||||||
|
|
||||||
/** 股东2 */
|
@Schema(description = "股东2")
|
||||||
@Size(max = 30, message = "股东2长度不能超过30个字符")
|
@Size(max = 100, message = "股东2长度不能超过100个字符")
|
||||||
private String corpShareholder2;
|
private String shareholder2;
|
||||||
|
|
||||||
/** 股东3 */
|
@Schema(description = "股东3")
|
||||||
@Size(max = 30, message = "股东3长度不能超过30个字符")
|
@Size(max = 100, message = "股东3长度不能超过100个字符")
|
||||||
private String corpShareholder3;
|
private String shareholder3;
|
||||||
|
|
||||||
/** 股东4 */
|
@Schema(description = "股东4")
|
||||||
@Size(max = 30, message = "股东4长度不能超过30个字符")
|
@Size(max = 100, message = "股东4长度不能超过100个字符")
|
||||||
private String corpShareholder4;
|
private String shareholder4;
|
||||||
|
|
||||||
/** 股东5 */
|
@Schema(description = "股东5")
|
||||||
@Size(max = 30, message = "股东5长度不能超过30个字符")
|
@Size(max = 100, message = "股东5长度不能超过100个字符")
|
||||||
private String corpShareholder5;
|
private String shareholder5;
|
||||||
|
|
||||||
/** 状态 */
|
@Schema(description = "备注")
|
||||||
@NotBlank(message = "状态不能为空")
|
|
||||||
private String status;
|
|
||||||
|
|
||||||
/** 备注 */
|
|
||||||
@Size(max = 500, message = "备注长度不能超过500个字符")
|
@Size(max = 500, message = "备注长度不能超过500个字符")
|
||||||
private String remark;
|
private String remark;
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -1,7 +1,7 @@
|
|||||||
package com.ruoyi.ccdi.domain.dto;
|
package com.ruoyi.ccdi.domain.dto;
|
||||||
|
|
||||||
|
import io.swagger.v3.oas.annotations.media.Schema;
|
||||||
import jakarta.validation.constraints.NotBlank;
|
import jakarta.validation.constraints.NotBlank;
|
||||||
import jakarta.validation.constraints.NotNull;
|
|
||||||
import jakarta.validation.constraints.Size;
|
import jakarta.validation.constraints.Size;
|
||||||
import lombok.Data;
|
import lombok.Data;
|
||||||
|
|
||||||
@@ -10,80 +10,83 @@ import java.io.Serializable;
|
|||||||
import java.util.Date;
|
import java.util.Date;
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 机构中介编辑 DTO
|
* 实体中介修改DTO
|
||||||
*
|
*
|
||||||
* @author ruoyi
|
* @author ruoyi
|
||||||
* @date 2026-01-29
|
* @date 2026-02-04
|
||||||
*/
|
*/
|
||||||
@Data
|
@Data
|
||||||
|
@Schema(description = "实体中介修改DTO")
|
||||||
public class CcdiIntermediaryEntityEditDTO implements Serializable {
|
public class CcdiIntermediaryEntityEditDTO implements Serializable {
|
||||||
|
|
||||||
@Serial
|
@Serial
|
||||||
private static final long serialVersionUID = 1L;
|
private static final long serialVersionUID = 1L;
|
||||||
|
|
||||||
/** 中介ID */
|
@Schema(description = "统一社会信用代码")
|
||||||
@NotNull(message = "中介ID不能为空")
|
@NotBlank(message = "统一社会信用代码不能为空")
|
||||||
private Long intermediaryId;
|
private String socialCreditCode;
|
||||||
|
|
||||||
/** 机构名称 */
|
@Schema(description = "机构名称")
|
||||||
@NotBlank(message = "机构名称不能为空")
|
@NotBlank(message = "机构名称不能为空")
|
||||||
@Size(min = 1, max = 100, message = "机构名称长度不能超过100个字符")
|
@Size(max = 200, message = "机构名称长度不能超过200个字符")
|
||||||
private String name;
|
private String enterpriseName;
|
||||||
|
|
||||||
/** 证件号（统一社会信用代码） */
|
@Schema(description = "主体类型")
|
||||||
@Size(max = 50, message = "证件号长度不能超过50个字符")
|
@Size(max = 50, message = "主体类型长度不能超过50个字符")
|
||||||
private String certificateNo;
|
private String enterpriseType;
|
||||||
|
|
||||||
/** 统一社会信用代码 */
|
@Schema(description = "企业性质")
|
||||||
private String corpCreditCode;
|
@Size(max = 50, message = "企业性质长度不能超过50个字符")
|
||||||
|
private String enterpriseNature;
|
||||||
|
|
||||||
/** 主体类型（有限责任公司、股份有限公司等） */
|
@Schema(description = "行业分类")
|
||||||
private String corpType;
|
@Size(max = 100, message = "行业分类长度不能超过100个字符")
|
||||||
|
private String industryClass;
|
||||||
|
|
||||||
/** 企业性质（国企、民企、外企等） */
|
@Schema(description = "所属行业")
|
||||||
private String corpNature;
|
@Size(max = 100, message = "所属行业长度不能超过100个字符")
|
||||||
|
private String industryName;
|
||||||
|
|
||||||
/** 行业分类 */
|
@Schema(description = "成立日期")
|
||||||
private String corpIndustryCategory;
|
private Date establishDate;
|
||||||
|
|
||||||
/** 所属行业 */
|
@Schema(description = "注册地址")
|
||||||
private String corpIndustry;
|
@Size(max = 500, message = "注册地址长度不能超过500个字符")
|
||||||
|
private String registerAddress;
|
||||||
|
|
||||||
/** 成立日期 */
|
@Schema(description = "法定代表人")
|
||||||
private Date corpEstablishDate;
|
@Size(max = 100, message = "法定代表人长度不能超过100个字符")
|
||||||
|
private String legalRepresentative;
|
||||||
|
|
||||||
/** 注册地址 */
|
@Schema(description = "法定代表人证件类型")
|
||||||
private String corpAddress;
|
@Size(max = 50, message = "法定代表人证件类型长度不能超过50个字符")
|
||||||
|
private String legalCertType;
|
||||||
|
|
||||||
/** 法定代表人 */
|
@Schema(description = "法定代表人证件号码")
|
||||||
private String corpLegalRep;
|
@Size(max = 50, message = "法定代表人证件号码长度不能超过50个字符")
|
||||||
|
private String legalCertNo;
|
||||||
|
|
||||||
/** 法定代表人证件类型 */
|
@Schema(description = "股东1")
|
||||||
private String corpLegalCertType;
|
@Size(max = 100, message = "股东1长度不能超过100个字符")
|
||||||
|
private String shareholder1;
|
||||||
|
|
||||||
/** 法定代表人证件号码 */
|
@Schema(description = "股东2")
|
||||||
private String corpLegalCertNo;
|
@Size(max = 100, message = "股东2长度不能超过100个字符")
|
||||||
|
private String shareholder2;
|
||||||
|
|
||||||
/** 股东1 */
|
@Schema(description = "股东3")
|
||||||
private String corpShareholder1;
|
@Size(max = 100, message = "股东3长度不能超过100个字符")
|
||||||
|
private String shareholder3;
|
||||||
|
|
||||||
/** 股东2 */
|
@Schema(description = "股东4")
|
||||||
private String corpShareholder2;
|
@Size(max = 100, message = "股东4长度不能超过100个字符")
|
||||||
|
private String shareholder4;
|
||||||
|
|
||||||
/** 股东3 */
|
@Schema(description = "股东5")
|
||||||
private String corpShareholder3;
|
@Size(max = 100, message = "股东5长度不能超过100个字符")
|
||||||
|
private String shareholder5;
|
||||||
|
|
||||||
/** 股东4 */
|
@Schema(description = "备注")
|
||||||
private String corpShareholder4;
|
|
||||||
|
|
||||||
/** 股东5 */
|
|
||||||
private String corpShareholder5;
|
|
||||||
|
|
||||||
/** 状态 */
|
|
||||||
@NotBlank(message = "状态不能为空")
|
|
||||||
private String status;
|
|
||||||
|
|
||||||
/** 备注 */
|
|
||||||
@Size(max = 500, message = "备注长度不能超过500个字符")
|
@Size(max = 500, message = "备注长度不能超过500个字符")
|
||||||
private String remark;
|
private String remark;
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -1,5 +1,6 @@
|
|||||||
package com.ruoyi.ccdi.domain.dto;
|
package com.ruoyi.ccdi.domain.dto;
|
||||||
|
|
||||||
|
import io.swagger.v3.oas.annotations.media.Schema;
|
||||||
import jakarta.validation.constraints.NotBlank;
|
import jakarta.validation.constraints.NotBlank;
|
||||||
import jakarta.validation.constraints.Size;
|
import jakarta.validation.constraints.Size;
|
||||||
import lombok.Data;
|
import lombok.Data;
|
||||||
@@ -8,76 +9,76 @@ import java.io.Serial;
|
|||||||
import java.io.Serializable;
|
import java.io.Serializable;
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 个人中介新增 DTO
|
* 个人中介新增DTO
|
||||||
*
|
*
|
||||||
* @author ruoyi
|
* @author ruoyi
|
||||||
* @date 2026-01-29
|
* @date 2026-02-04
|
||||||
*/
|
*/
|
||||||
@Data
|
@Data
|
||||||
|
@Schema(description = "个人中介新增DTO")
|
||||||
public class CcdiIntermediaryPersonAddDTO implements Serializable {
|
public class CcdiIntermediaryPersonAddDTO implements Serializable {
|
||||||
|
|
||||||
@Serial
|
@Serial
|
||||||
private static final long serialVersionUID = 1L;
|
private static final long serialVersionUID = 1L;
|
||||||
|
|
||||||
/** 姓名 */
|
@Schema(description = "姓名")
|
||||||
@NotBlank(message = "姓名不能为空")
|
@NotBlank(message = "姓名不能为空")
|
||||||
@Size(min = 1, max = 100, message = "姓名长度不能超过100个字符")
|
@Size(max = 100, message = "姓名长度不能超过100个字符")
|
||||||
private String name;
|
private String name;
|
||||||
|
|
||||||
/** 证件号 */
|
@Schema(description = "人员类型")
|
||||||
@NotBlank(message = "证件号不能为空")
|
private String personType;
|
||||||
@Size(max = 50, message = "证件号长度不能超过50个字符")
|
|
||||||
private String certificateNo;
|
|
||||||
|
|
||||||
/** 人员类型（中介、职业背债人、房产中介等） */
|
@Schema(description = "人员子类型")
|
||||||
@Size(max = 30, message = "人员类型长度不能超过30个字符")
|
private String personSubType;
|
||||||
private String indivType;
|
|
||||||
|
|
||||||
/** 人员子类型（本人、配偶等） */
|
@Schema(description = "关系类型")
|
||||||
@Size(max = 50, message = "人员子类型长度不能超过50个字符")
|
private String relationType;
|
||||||
private String indivSubType;
|
|
||||||
|
|
||||||
/** 性别（M男 F女 O其他） */
|
@Schema(description = "性别")
|
||||||
@Size(max = 1, message = "性别长度不能超过1个字符")
|
private String gender;
|
||||||
private String indivGender;
|
|
||||||
|
|
||||||
/** 证件类型 */
|
@Schema(description = "证件类型")
|
||||||
@Size(max = 30, message = "证件类型长度不能超过30个字符")
|
private String idType;
|
||||||
private String indivCertType;
|
|
||||||
|
|
||||||
/** 手机号码（加密存储） */
|
@Schema(description = "证件号码")
|
||||||
|
@NotBlank(message = "证件号码不能为空")
|
||||||
|
@Size(max = 50, message = "证件号码长度不能超过50个字符")
|
||||||
|
private String personId;
|
||||||
|
|
||||||
|
@Schema(description = "手机号码")
|
||||||
@Size(max = 20, message = "手机号码长度不能超过20个字符")
|
@Size(max = 20, message = "手机号码长度不能超过20个字符")
|
||||||
private String indivPhone;
|
private String mobile;
|
||||||
|
|
||||||
/** 微信号 */
|
@Schema(description = "微信号")
|
||||||
@Size(max = 50, message = "微信号长度不能超过50个字符")
|
@Size(max = 50, message = "微信号长度不能超过50个字符")
|
||||||
private String indivWechat;
|
private String wechatNo;
|
||||||
|
|
||||||
/** 联系地址 */
|
@Schema(description = "联系地址")
|
||||||
@Size(max = 200, message = "联系地址长度不能超过200个字符")
|
@Size(max = 200, message = "联系地址长度不能超过200个字符")
|
||||||
private String indivAddress;
|
private String contactAddress;
|
||||||
|
|
||||||
/** 所在公司 */
|
@Schema(description = "所在公司")
|
||||||
@Size(max = 100, message = "所在公司长度不能超过100个字符")
|
@Size(max = 200, message = "所在公司长度不能超过200个字符")
|
||||||
private String indivCompany;
|
private String company;
|
||||||
|
|
||||||
/** 职位/职务 */
|
@Schema(description = "企业统一信用码")
|
||||||
|
@Size(max = 50, message = "企业统一信用码长度不能超过50个字符")
|
||||||
|
private String socialCreditCode;
|
||||||
|
|
||||||
|
@Schema(description = "职位")
|
||||||
@Size(max = 100, message = "职位长度不能超过100个字符")
|
@Size(max = 100, message = "职位长度不能超过100个字符")
|
||||||
private String indivPosition;
|
private String position;
|
||||||
|
|
||||||
/** 关联人员ID */
|
@Schema(description = "关联人员ID")
|
||||||
@Size(max = 20, message = "关联人员ID长度不能超过20个字符")
|
@Size(max = 50, message = "关联人员ID长度不能超过50个字符")
|
||||||
private String indivRelatedId;
|
private String relatedNumId;
|
||||||
|
|
||||||
/** 关联关系 */
|
@Schema(description = "关联关系")
|
||||||
@Size(max = 50, message = "关联关系长度不能超过50个字符")
|
@Size(max = 50, message = "关联关系长度不能超过50个字符")
|
||||||
private String indivRelation;
|
private String relation;
|
||||||
|
|
||||||
/** 状态 */
|
@Schema(description = "备注")
|
||||||
@NotBlank(message = "状态不能为空")
|
|
||||||
private String status;
|
|
||||||
|
|
||||||
/** 备注 */
|
|
||||||
@Size(max = 500, message = "备注长度不能超过500个字符")
|
@Size(max = 500, message = "备注长度不能超过500个字符")
|
||||||
private String remark;
|
private String remark;
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -1,7 +1,7 @@
|
|||||||
package com.ruoyi.ccdi.domain.dto;
|
package com.ruoyi.ccdi.domain.dto;
|
||||||
|
|
||||||
|
import io.swagger.v3.oas.annotations.media.Schema;
|
||||||
import jakarta.validation.constraints.NotBlank;
|
import jakarta.validation.constraints.NotBlank;
|
||||||
import jakarta.validation.constraints.NotNull;
|
|
||||||
import jakarta.validation.constraints.Size;
|
import jakarta.validation.constraints.Size;
|
||||||
import lombok.Data;
|
import lombok.Data;
|
||||||
|
|
||||||
@@ -9,68 +9,79 @@ import java.io.Serial;
|
|||||||
import java.io.Serializable;
|
import java.io.Serializable;
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 个人中介编辑 DTO
|
* 个人中介修改DTO
|
||||||
*
|
*
|
||||||
* @author ruoyi
|
* @author ruoyi
|
||||||
* @date 2026-01-29
|
* @date 2026-02-04
|
||||||
*/
|
*/
|
||||||
@Data
|
@Data
|
||||||
|
@Schema(description = "个人中介修改DTO")
|
||||||
public class CcdiIntermediaryPersonEditDTO implements Serializable {
|
public class CcdiIntermediaryPersonEditDTO implements Serializable {
|
||||||
|
|
||||||
@Serial
|
@Serial
|
||||||
private static final long serialVersionUID = 1L;
|
private static final long serialVersionUID = 1L;
|
||||||
|
|
||||||
/** 中介ID */
|
@Schema(description = "人员ID")
|
||||||
@NotNull(message = "中介ID不能为空")
|
@NotBlank(message = "人员ID不能为空")
|
||||||
private Long intermediaryId;
|
private String bizId;
|
||||||
|
|
||||||
/** 姓名 */
|
@Schema(description = "姓名")
|
||||||
@NotBlank(message = "姓名不能为空")
|
@NotBlank(message = "姓名不能为空")
|
||||||
@Size(min = 1, max = 100, message = "姓名长度不能超过100个字符")
|
@Size(max = 100, message = "姓名长度不能超过100个字符")
|
||||||
private String name;
|
private String name;
|
||||||
|
|
||||||
/** 证件号 */
|
@Schema(description = "人员类型")
|
||||||
@Size(max = 50, message = "证件号长度不能超过50个字符")
|
private String personType;
|
||||||
private String certificateNo;
|
|
||||||
|
|
||||||
/** 人员类型（中介、职业背债人、房产中介等） */
|
@Schema(description = "人员子类型")
|
||||||
private String indivType;
|
private String personSubType;
|
||||||
|
|
||||||
/** 人员子类型（本人、配偶等） */
|
@Schema(description = "关系类型")
|
||||||
private String indivSubType;
|
private String relationType;
|
||||||
|
|
||||||
/** 性别（M男 F女 O其他） */
|
@Schema(description = "性别")
|
||||||
private String indivGender;
|
private String gender;
|
||||||
|
|
||||||
/** 证件类型 */
|
@Schema(description = "证件类型")
|
||||||
private String indivCertType;
|
private String idType;
|
||||||
|
|
||||||
/** 手机号码（加密存储） */
|
@Schema(description = "证件号码")
|
||||||
private String indivPhone;
|
@Size(max = 50, message = "证件号码长度不能超过50个字符")
|
||||||
|
private String personId;
|
||||||
|
|
||||||
/** 微信号 */
|
@Schema(description = "手机号码")
|
||||||
private String indivWechat;
|
@Size(max = 20, message = "手机号码长度不能超过20个字符")
|
||||||
|
private String mobile;
|
||||||
|
|
||||||
/** 联系地址 */
|
@Schema(description = "微信号")
|
||||||
private String indivAddress;
|
@Size(max = 50, message = "微信号长度不能超过50个字符")
|
||||||
|
private String wechatNo;
|
||||||
|
|
||||||
/** 所在公司 */
|
@Schema(description = "联系地址")
|
||||||
private String indivCompany;
|
@Size(max = 200, message = "联系地址长度不能超过200个字符")
|
||||||
|
private String contactAddress;
|
||||||
|
|
||||||
/** 职位/职务 */
|
@Schema(description = "所在公司")
|
||||||
private String indivPosition;
|
@Size(max = 200, message = "所在公司长度不能超过200个字符")
|
||||||
|
private String company;
|
||||||
|
|
||||||
/** 关联人员ID */
|
@Schema(description = "企业统一信用码")
|
||||||
private String indivRelatedId;
|
@Size(max = 50, message = "企业统一信用码长度不能超过50个字符")
|
||||||
|
private String socialCreditCode;
|
||||||
|
|
||||||
/** 关联关系 */
|
@Schema(description = "职位")
|
||||||
private String indivRelation;
|
@Size(max = 100, message = "职位长度不能超过100个字符")
|
||||||
|
private String position;
|
||||||
|
|
||||||
/** 状态 */
|
@Schema(description = "关联人员ID")
|
||||||
@NotBlank(message = "状态不能为空")
|
@Size(max = 50, message = "关联人员ID长度不能超过50个字符")
|
||||||
private String status;
|
private String relatedNumId;
|
||||||
|
|
||||||
/** 备注 */
|
@Schema(description = "关联关系")
|
||||||
|
@Size(max = 50, message = "关联关系长度不能超过50个字符")
|
||||||
|
private String relation;
|
||||||
|
|
||||||
|
@Schema(description = "备注")
|
||||||
@Size(max = 500, message = "备注长度不能超过500个字符")
|
@Size(max = 500, message = "备注长度不能超过500个字符")
|
||||||
private String remark;
|
private String remark;
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -0,0 +1,30 @@
|
|||||||
|
package com.ruoyi.ccdi.domain.dto;
|
||||||
|
|
||||||
|
import io.swagger.v3.oas.annotations.media.Schema;
|
||||||
|
import lombok.Data;
|
||||||
|
|
||||||
|
import java.io.Serial;
|
||||||
|
import java.io.Serializable;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 中介查询DTO
|
||||||
|
*
|
||||||
|
* @author ruoyi
|
||||||
|
* @date 2026-02-04
|
||||||
|
*/
|
||||||
|
@Data
|
||||||
|
@Schema(description = "中介查询DTO")
|
||||||
|
public class CcdiIntermediaryQueryDTO implements Serializable {
|
||||||
|
|
||||||
|
@Serial
|
||||||
|
private static final long serialVersionUID = 1L;
|
||||||
|
|
||||||
|
@Schema(description = "姓名/机构名称")
|
||||||
|
private String name;
|
||||||
|
|
||||||
|
@Schema(description = "证件号/统一社会信用代码")
|
||||||
|
private String certificateNo;
|
||||||
|
|
||||||
|
@Schema(description = "中介类型(1=个人, 2=实体)")
|
||||||
|
private String intermediaryType;
|
||||||
|
}
|
||||||
@@ -1,48 +0,0 @@
|
|||||||
package com.ruoyi.ccdi.domain.excel;
|
|
||||||
|
|
||||||
import com.alibaba.excel.annotation.ExcelProperty;
|
|
||||||
import com.alibaba.excel.annotation.write.style.ColumnWidth;
|
|
||||||
import com.ruoyi.ccdi.utils.converter.IntermediaryStatusConverter;
|
|
||||||
import com.ruoyi.ccdi.utils.converter.IntermediaryTypeConverter;
|
|
||||||
import lombok.Data;
|
|
||||||
|
|
||||||
import java.io.Serial;
|
|
||||||
import java.io.Serializable;
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 中介人员黑名单Excel导入导出对象
|
|
||||||
*
|
|
||||||
* @author ruoyi
|
|
||||||
* @date 2026-01-27
|
|
||||||
*/
|
|
||||||
@Data
|
|
||||||
public class CcdiIntermediaryBlacklistExcel implements Serializable {
|
|
||||||
|
|
||||||
@Serial
|
|
||||||
private static final long serialVersionUID = 1L;
|
|
||||||
|
|
||||||
/** 姓名/机构名称 */
|
|
||||||
@ExcelProperty(value = "姓名/机构名称", index = 0)
|
|
||||||
@ColumnWidth(20)
|
|
||||||
private String name;
|
|
||||||
|
|
||||||
/** 证件号 */
|
|
||||||
@ExcelProperty(value = "证件号", index = 1)
|
|
||||||
@ColumnWidth(20)
|
|
||||||
private String certificateNo;
|
|
||||||
|
|
||||||
/** 中介类型 */
|
|
||||||
@ExcelProperty(value = "中介类型", converter = IntermediaryTypeConverter.class, index = 2)
|
|
||||||
@ColumnWidth(15)
|
|
||||||
private String intermediaryType;
|
|
||||||
|
|
||||||
/** 状态 */
|
|
||||||
@ExcelProperty(value = "状态", converter = IntermediaryStatusConverter.class, index = 3)
|
|
||||||
@ColumnWidth(10)
|
|
||||||
private String status;
|
|
||||||
|
|
||||||
/** 备注 */
|
|
||||||
@ExcelProperty(value = "备注", index = 4)
|
|
||||||
@ColumnWidth(30)
|
|
||||||
private String remark;
|
|
||||||
}
|
|
||||||
@@ -7,12 +7,13 @@ import lombok.Data;
|
|||||||
|
|
||||||
import java.io.Serial;
|
import java.io.Serial;
|
||||||
import java.io.Serializable;
|
import java.io.Serializable;
|
||||||
|
import java.util.Date;
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 机构中介黑名单Excel导入对象
|
* 实体中介Excel导入导出对象
|
||||||
*
|
*
|
||||||
* @author ruoyi
|
* @author ruoyi
|
||||||
* @date 2026-01-29
|
* @date 2026-02-04
|
||||||
*/
|
*/
|
||||||
@Data
|
@Data
|
||||||
public class CcdiIntermediaryEntityExcel implements Serializable {
|
public class CcdiIntermediaryEntityExcel implements Serializable {
|
||||||
@@ -20,77 +21,91 @@ public class CcdiIntermediaryEntityExcel implements Serializable {
|
|||||||
@Serial
|
@Serial
|
||||||
private static final long serialVersionUID = 1L;
|
private static final long serialVersionUID = 1L;
|
||||||
|
|
||||||
|
/** 机构名称 */
|
||||||
@ExcelProperty(value = "机构名称", index = 0)
|
@ExcelProperty(value = "机构名称", index = 0)
|
||||||
@ColumnWidth(25)
|
@ColumnWidth(30)
|
||||||
private String name;
|
private String enterpriseName;
|
||||||
|
|
||||||
|
/** 统一社会信用代码 */
|
||||||
@ExcelProperty(value = "统一社会信用代码", index = 1)
|
@ExcelProperty(value = "统一社会信用代码", index = 1)
|
||||||
@ColumnWidth(20)
|
@ColumnWidth(20)
|
||||||
private String corpCreditCode;
|
private String socialCreditCode;
|
||||||
|
|
||||||
|
/** 主体类型 */
|
||||||
@ExcelProperty(value = "主体类型", index = 2)
|
@ExcelProperty(value = "主体类型", index = 2)
|
||||||
@ColumnWidth(20)
|
@ColumnWidth(15)
|
||||||
@DictDropdown(dictType = "dpc_entity_type")
|
@DictDropdown(dictType = "ccdi_enterprise_type")
|
||||||
private String corpType;
|
private String enterpriseType;
|
||||||
|
|
||||||
|
/** 企业性质 */
|
||||||
@ExcelProperty(value = "企业性质", index = 3)
|
@ExcelProperty(value = "企业性质", index = 3)
|
||||||
@ColumnWidth(15)
|
@ColumnWidth(15)
|
||||||
@DictDropdown(dictType = "dpc_enterprise_nature")
|
@DictDropdown(dictType = "ccdi_enterprise_nature")
|
||||||
private String corpNature;
|
private String enterpriseNature;
|
||||||
|
|
||||||
|
/** 行业分类 */
|
||||||
@ExcelProperty(value = "行业分类", index = 4)
|
@ExcelProperty(value = "行业分类", index = 4)
|
||||||
@ColumnWidth(15)
|
@ColumnWidth(15)
|
||||||
private String corpIndustryCategory;
|
private String industryClass;
|
||||||
|
|
||||||
|
/** 所属行业 */
|
||||||
@ExcelProperty(value = "所属行业", index = 5)
|
@ExcelProperty(value = "所属行业", index = 5)
|
||||||
@ColumnWidth(15)
|
@ColumnWidth(15)
|
||||||
private String corpIndustry;
|
private String industryName;
|
||||||
|
|
||||||
|
/** 成立日期 */
|
||||||
@ExcelProperty(value = "成立日期", index = 6)
|
@ExcelProperty(value = "成立日期", index = 6)
|
||||||
@ColumnWidth(15)
|
@ColumnWidth(15)
|
||||||
private String corpEstablishDate;
|
private Date establishDate;
|
||||||
|
|
||||||
|
/** 注册地址 */
|
||||||
@ExcelProperty(value = "注册地址", index = 7)
|
@ExcelProperty(value = "注册地址", index = 7)
|
||||||
@ColumnWidth(40)
|
@ColumnWidth(40)
|
||||||
private String corpAddress;
|
private String registerAddress;
|
||||||
|
|
||||||
|
/** 法定代表人 */
|
||||||
@ExcelProperty(value = "法定代表人", index = 8)
|
@ExcelProperty(value = "法定代表人", index = 8)
|
||||||
@ColumnWidth(15)
|
@ColumnWidth(15)
|
||||||
private String corpLegalRep;
|
private String legalRepresentative;
|
||||||
|
|
||||||
|
/** 法定代表人证件类型 */
|
||||||
@ExcelProperty(value = "法定代表人证件类型", index = 9)
|
@ExcelProperty(value = "法定代表人证件类型", index = 9)
|
||||||
@ColumnWidth(20)
|
@ColumnWidth(20)
|
||||||
private String corpLegalCertType;
|
@DictDropdown(dictType = "ccdi_id_type")
|
||||||
|
private String legalCertType;
|
||||||
|
|
||||||
|
/** 法定代表人证件号码 */
|
||||||
@ExcelProperty(value = "法定代表人证件号码", index = 10)
|
@ExcelProperty(value = "法定代表人证件号码", index = 10)
|
||||||
@ColumnWidth(20)
|
@ColumnWidth(20)
|
||||||
private String corpLegalCertNo;
|
private String legalCertNo;
|
||||||
|
|
||||||
|
/** 股东1 */
|
||||||
@ExcelProperty(value = "股东1", index = 11)
|
@ExcelProperty(value = "股东1", index = 11)
|
||||||
@ColumnWidth(15)
|
@ColumnWidth(15)
|
||||||
private String corpShareholder1;
|
private String shareholder1;
|
||||||
|
|
||||||
|
/** 股东2 */
|
||||||
@ExcelProperty(value = "股东2", index = 12)
|
@ExcelProperty(value = "股东2", index = 12)
|
||||||
@ColumnWidth(15)
|
@ColumnWidth(15)
|
||||||
private String corpShareholder2;
|
private String shareholder2;
|
||||||
|
|
||||||
|
/** 股东3 */
|
||||||
@ExcelProperty(value = "股东3", index = 13)
|
@ExcelProperty(value = "股东3", index = 13)
|
||||||
@ColumnWidth(15)
|
@ColumnWidth(15)
|
||||||
private String corpShareholder3;
|
private String shareholder3;
|
||||||
|
|
||||||
|
/** 股东4 */
|
||||||
@ExcelProperty(value = "股东4", index = 14)
|
@ExcelProperty(value = "股东4", index = 14)
|
||||||
@ColumnWidth(15)
|
@ColumnWidth(15)
|
||||||
private String corpShareholder4;
|
private String shareholder4;
|
||||||
|
|
||||||
|
/** 股东5 */
|
||||||
@ExcelProperty(value = "股东5", index = 15)
|
@ExcelProperty(value = "股东5", index = 15)
|
||||||
@ColumnWidth(15)
|
@ColumnWidth(15)
|
||||||
private String corpShareholder5;
|
private String shareholder5;
|
||||||
|
|
||||||
|
/** 备注 */
|
||||||
@ExcelProperty(value = "备注", index = 16)
|
@ExcelProperty(value = "备注", index = 16)
|
||||||
@ColumnWidth(30)
|
@ColumnWidth(30)
|
||||||
private String remark;
|
private String remark;
|
||||||
|
|
||||||
// 以下字段不在 Excel 中显示，由系统自动设置
|
|
||||||
// private String status; // 默认：正常（0）
|
|
||||||
// private String dataSource; // 默认：批量导入（IMPORT）
|
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -9,10 +9,10 @@ import java.io.Serial;
|
|||||||
import java.io.Serializable;
|
import java.io.Serializable;
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 个人中介黑名单Excel导入对象
|
* 个人中介Excel导入导出对象
|
||||||
*
|
*
|
||||||
* @author ruoyi
|
* @author ruoyi
|
||||||
* @date 2026-01-29
|
* @date 2026-02-04
|
||||||
*/
|
*/
|
||||||
@Data
|
@Data
|
||||||
public class CcdiIntermediaryPersonExcel implements Serializable {
|
public class CcdiIntermediaryPersonExcel implements Serializable {
|
||||||
@@ -20,65 +20,89 @@ public class CcdiIntermediaryPersonExcel implements Serializable {
|
|||||||
@Serial
|
@Serial
|
||||||
private static final long serialVersionUID = 1L;
|
private static final long serialVersionUID = 1L;
|
||||||
|
|
||||||
|
/** 姓名 */
|
||||||
@ExcelProperty(value = "姓名", index = 0)
|
@ExcelProperty(value = "姓名", index = 0)
|
||||||
@ColumnWidth(15)
|
@ColumnWidth(15)
|
||||||
private String name;
|
private String name;
|
||||||
|
|
||||||
|
/** 人员类型 */
|
||||||
@ExcelProperty(value = "人员类型", index = 1)
|
@ExcelProperty(value = "人员类型", index = 1)
|
||||||
@ColumnWidth(15)
|
@ColumnWidth(15)
|
||||||
private String indivType;
|
@DictDropdown(dictType = "ccdi_person_type")
|
||||||
|
private String personType;
|
||||||
|
|
||||||
|
/** 人员子类型 */
|
||||||
@ExcelProperty(value = "人员子类型", index = 2)
|
@ExcelProperty(value = "人员子类型", index = 2)
|
||||||
@ColumnWidth(15)
|
@ColumnWidth(15)
|
||||||
private String indivSubType;
|
@DictDropdown(dictType = "ccdi_person_sub_type")
|
||||||
|
private String personSubType;
|
||||||
|
|
||||||
@ExcelProperty(value = "性别", index = 3)
|
/** 关系类型 */
|
||||||
|
@ExcelProperty(value = "关系类型", index = 3)
|
||||||
|
@ColumnWidth(15)
|
||||||
|
@DictDropdown(dictType = "ccdi_relation_type")
|
||||||
|
private String relationType;
|
||||||
|
|
||||||
|
/** 性别 */
|
||||||
|
@ExcelProperty(value = "性别", index = 4)
|
||||||
@ColumnWidth(10)
|
@ColumnWidth(10)
|
||||||
@DictDropdown(dictType = "dpc_indiv_gender")
|
@DictDropdown(dictType = "sys_user_sex")
|
||||||
private String indivGender;
|
private String gender;
|
||||||
|
|
||||||
@ExcelProperty(value = "证件类型", index = 4)
|
/** 证件类型 */
|
||||||
|
@ExcelProperty(value = "证件类型", index = 5)
|
||||||
@ColumnWidth(15)
|
@ColumnWidth(15)
|
||||||
@DictDropdown(dictType = "dpc_certificate_type")
|
@DictDropdown(dictType = "ccdi_id_type")
|
||||||
private String indivCertType;
|
private String idType;
|
||||||
|
|
||||||
@ExcelProperty(value = "证件号码", index = 5)
|
/** 证件号码 */
|
||||||
|
@ExcelProperty(value = "证件号码", index = 6)
|
||||||
@ColumnWidth(20)
|
@ColumnWidth(20)
|
||||||
private String certificateNo;
|
private String personId;
|
||||||
|
|
||||||
@ExcelProperty(value = "手机号码", index = 6)
|
/** 手机号码 */
|
||||||
|
@ExcelProperty(value = "手机号码", index = 7)
|
||||||
@ColumnWidth(15)
|
@ColumnWidth(15)
|
||||||
private String indivPhone;
|
private String mobile;
|
||||||
|
|
||||||
@ExcelProperty(value = "微信号", index = 7)
|
/** 微信号 */
|
||||||
|
@ExcelProperty(value = "微信号", index = 8)
|
||||||
@ColumnWidth(15)
|
@ColumnWidth(15)
|
||||||
private String indivWechat;
|
private String wechatNo;
|
||||||
|
|
||||||
@ExcelProperty(value = "联系地址", index = 8)
|
/** 联系地址 */
|
||||||
|
@ExcelProperty(value = "联系地址", index = 9)
|
||||||
@ColumnWidth(30)
|
@ColumnWidth(30)
|
||||||
private String indivAddress;
|
private String contactAddress;
|
||||||
|
|
||||||
@ExcelProperty(value = "所在公司", index = 9)
|
/** 所在公司 */
|
||||||
|
@ExcelProperty(value = "所在公司", index = 10)
|
||||||
@ColumnWidth(20)
|
@ColumnWidth(20)
|
||||||
private String indivCompany;
|
private String company;
|
||||||
|
|
||||||
@ExcelProperty(value = "职位", index = 10)
|
/** 企业统一信用码 */
|
||||||
|
@ExcelProperty(value = "企业统一信用码", index = 11)
|
||||||
|
@ColumnWidth(20)
|
||||||
|
private String socialCreditCode;
|
||||||
|
|
||||||
|
/** 职位 */
|
||||||
|
@ExcelProperty(value = "职位", index = 12)
|
||||||
@ColumnWidth(15)
|
@ColumnWidth(15)
|
||||||
private String indivPosition;
|
private String position;
|
||||||
|
|
||||||
@ExcelProperty(value = "关联人员ID", index = 11)
|
/** 关联人员ID */
|
||||||
|
@ExcelProperty(value = "关联人员ID", index = 13)
|
||||||
@ColumnWidth(15)
|
@ColumnWidth(15)
|
||||||
private String indivRelatedId;
|
private String relatedNumId;
|
||||||
|
|
||||||
@ExcelProperty(value = "关联关系", index = 12)
|
/** 关联关系 */
|
||||||
|
@ExcelProperty(value = "关联关系", index = 14)
|
||||||
@ColumnWidth(15)
|
@ColumnWidth(15)
|
||||||
private String indivRelation;
|
@DictDropdown(dictType = "ccdi_relation")
|
||||||
|
private String relation;
|
||||||
|
|
||||||
@ExcelProperty(value = "备注", index = 13)
|
/** 备注 */
|
||||||
|
@ExcelProperty(value = "备注", index = 15)
|
||||||
@ColumnWidth(30)
|
@ColumnWidth(30)
|
||||||
private String remark;
|
private String remark;
|
||||||
|
|
||||||
// 以下字段不在 Excel 中显示，由系统自动设置
|
|
||||||
// private String status; // 默认：正常（0）
|
|
||||||
// private String dataSource; // 默认：批量导入（IMPORT）
|
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -1,59 +0,0 @@
|
|||||||
package com.ruoyi.ccdi.domain.vo;
|
|
||||||
|
|
||||||
import com.fasterxml.jackson.annotation.JsonFormat;
|
|
||||||
import lombok.Data;
|
|
||||||
|
|
||||||
import java.io.Serial;
|
|
||||||
import java.io.Serializable;
|
|
||||||
import java.util.Date;
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 中介人员黑名单视图对象 VO
|
|
||||||
*
|
|
||||||
* @author ruoyi
|
|
||||||
* @date 2026-01-27
|
|
||||||
*/
|
|
||||||
@Data
|
|
||||||
public class CcdiIntermediaryBlacklistVO implements Serializable {
|
|
||||||
|
|
||||||
@Serial
|
|
||||||
private static final long serialVersionUID = 1L;
|
|
||||||
|
|
||||||
/** 中介ID */
|
|
||||||
private Long intermediaryId;
|
|
||||||
|
|
||||||
/** 姓名/机构名称 */
|
|
||||||
private String name;
|
|
||||||
|
|
||||||
/** 证件号 */
|
|
||||||
private String certificateNo;
|
|
||||||
|
|
||||||
/** 中介类型 */
|
|
||||||
private String intermediaryType;
|
|
||||||
|
|
||||||
/** 中介类型名称（用于前端显示） */
|
|
||||||
private String intermediaryTypeName;
|
|
||||||
|
|
||||||
/** 状态 */
|
|
||||||
private String status;
|
|
||||||
|
|
||||||
/** 状态名称（用于前端显示） */
|
|
||||||
private String statusName;
|
|
||||||
|
|
||||||
/** 备注 */
|
|
||||||
private String remark;
|
|
||||||
|
|
||||||
/** 创建者 */
|
|
||||||
private String createBy;
|
|
||||||
|
|
||||||
/** 创建时间 */
|
|
||||||
@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss")
|
|
||||||
private Date createTime;
|
|
||||||
|
|
||||||
/** 更新者 */
|
|
||||||
private String updateBy;
|
|
||||||
|
|
||||||
/** 更新时间 */
|
|
||||||
@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss")
|
|
||||||
private Date updateTime;
|
|
||||||
}
|
|
||||||
@@ -1,6 +1,7 @@
|
|||||||
package com.ruoyi.ccdi.domain.vo;
|
package com.ruoyi.ccdi.domain.vo;
|
||||||
|
|
||||||
import com.fasterxml.jackson.annotation.JsonFormat;
|
import com.fasterxml.jackson.annotation.JsonFormat;
|
||||||
|
import io.swagger.v3.oas.annotations.media.Schema;
|
||||||
import lombok.Data;
|
import lombok.Data;
|
||||||
|
|
||||||
import java.io.Serial;
|
import java.io.Serial;
|
||||||
@@ -8,119 +9,80 @@ import java.io.Serializable;
|
|||||||
import java.util.Date;
|
import java.util.Date;
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 机构中介黑名单详情 VO
|
* 实体中介详情VO
|
||||||
*
|
*
|
||||||
* @author ruoyi
|
* @author ruoyi
|
||||||
* @date 2026-01-29
|
* @date 2026-02-04
|
||||||
*/
|
*/
|
||||||
@Data
|
@Data
|
||||||
|
@Schema(description = "实体中介详情VO")
|
||||||
public class CcdiIntermediaryEntityDetailVO implements Serializable {
|
public class CcdiIntermediaryEntityDetailVO implements Serializable {
|
||||||
|
|
||||||
@Serial
|
@Serial
|
||||||
private static final long serialVersionUID = 1L;
|
private static final long serialVersionUID = 1L;
|
||||||
|
|
||||||
// ============================================================
|
@Schema(description = "统一社会信用代码")
|
||||||
// 核心字段
|
private String socialCreditCode;
|
||||||
// ============================================================
|
|
||||||
/** 中介ID */
|
|
||||||
private Long intermediaryId;
|
|
||||||
|
|
||||||
/** 机构名称 */
|
@Schema(description = "企业名称")
|
||||||
private String name;
|
private String enterpriseName;
|
||||||
|
|
||||||
/** 证件号码 */
|
@Schema(description = "企业类型")
|
||||||
private String certificateNo;
|
private String enterpriseType;
|
||||||
|
|
||||||
/** 中介类型 */
|
@Schema(description = "企业性质")
|
||||||
private String intermediaryType;
|
private String enterpriseNature;
|
||||||
|
|
||||||
/** 中介类型名称 */
|
@Schema(description = "行业分类")
|
||||||
private String intermediaryTypeName;
|
private String industryClass;
|
||||||
|
|
||||||
/** 状态 */
|
@Schema(description = "所属行业")
|
||||||
private String status;
|
private String industryName;
|
||||||
|
|
||||||
/** 状态名称 */
|
@Schema(description = "成立日期")
|
||||||
private String statusName;
|
@JsonFormat(pattern = "yyyy-MM-dd")
|
||||||
|
private Date establishDate;
|
||||||
|
|
||||||
/** 备注 */
|
@Schema(description = "注册地址")
|
||||||
private String remark;
|
private String registerAddress;
|
||||||
|
|
||||||
/** 数据来源 */
|
@Schema(description = "法定代表人")
|
||||||
|
private String legalRepresentative;
|
||||||
|
|
||||||
|
@Schema(description = "法定代表人证件类型")
|
||||||
|
private String legalCertType;
|
||||||
|
|
||||||
|
@Schema(description = "法定代表人证件号码")
|
||||||
|
private String legalCertNo;
|
||||||
|
|
||||||
|
@Schema(description = "股东1")
|
||||||
|
private String shareholder1;
|
||||||
|
|
||||||
|
@Schema(description = "股东2")
|
||||||
|
private String shareholder2;
|
||||||
|
|
||||||
|
@Schema(description = "股东3")
|
||||||
|
private String shareholder3;
|
||||||
|
|
||||||
|
@Schema(description = "股东4")
|
||||||
|
private String shareholder4;
|
||||||
|
|
||||||
|
@Schema(description = "股东5")
|
||||||
|
private String shareholder5;
|
||||||
|
|
||||||
|
@Schema(description = "风险等级")
|
||||||
|
private String riskLevel;
|
||||||
|
|
||||||
|
@Schema(description = "企业来源")
|
||||||
|
private String entSource;
|
||||||
|
|
||||||
|
@Schema(description = "数据来源")
|
||||||
private String dataSource;
|
private String dataSource;
|
||||||
|
|
||||||
/** 数据来源名称 */
|
@Schema(description = "备注")
|
||||||
private String dataSourceName;
|
private String remark;
|
||||||
|
|
||||||
// ============================================================
|
@Schema(description = "创建时间")
|
||||||
// 机构专属字段
|
|
||||||
// ============================================================
|
|
||||||
/** 统一社会信用代码 */
|
|
||||||
private String corpCreditCode;
|
|
||||||
|
|
||||||
/** 主体类型 */
|
|
||||||
private String corpType;
|
|
||||||
|
|
||||||
/** 主体类型名称 */
|
|
||||||
private String corpTypeName;
|
|
||||||
|
|
||||||
/** 企业性质 */
|
|
||||||
private String corpNature;
|
|
||||||
|
|
||||||
/** 企业性质名称 */
|
|
||||||
private String corpNatureName;
|
|
||||||
|
|
||||||
/** 行业分类 */
|
|
||||||
private String corpIndustryCategory;
|
|
||||||
|
|
||||||
/** 所属行业 */
|
|
||||||
private String corpIndustry;
|
|
||||||
|
|
||||||
/** 成立日期 */
|
|
||||||
@JsonFormat(pattern = "yyyy-MM-dd")
|
|
||||||
private Date corpEstablishDate;
|
|
||||||
|
|
||||||
/** 注册地址 */
|
|
||||||
private String corpAddress;
|
|
||||||
|
|
||||||
/** 法定代表人 */
|
|
||||||
private String corpLegalRep;
|
|
||||||
|
|
||||||
/** 法定代表人证件类型 */
|
|
||||||
private String corpLegalCertType;
|
|
||||||
|
|
||||||
/** 法定代表人证件号码 */
|
|
||||||
private String corpLegalCertNo;
|
|
||||||
|
|
||||||
/** 股东1 */
|
|
||||||
private String corpShareholder1;
|
|
||||||
|
|
||||||
/** 股东2 */
|
|
||||||
private String corpShareholder2;
|
|
||||||
|
|
||||||
/** 股东3 */
|
|
||||||
private String corpShareholder3;
|
|
||||||
|
|
||||||
/** 股东4 */
|
|
||||||
private String corpShareholder4;
|
|
||||||
|
|
||||||
/** 股东5 */
|
|
||||||
private String corpShareholder5;
|
|
||||||
|
|
||||||
// ============================================================
|
|
||||||
// 审计字段
|
|
||||||
// ============================================================
|
|
||||||
/** 创建者 */
|
|
||||||
private String createBy;
|
|
||||||
|
|
||||||
/** 创建时间 */
|
|
||||||
@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss")
|
@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss")
|
||||||
private Date createTime;
|
private Date createTime;
|
||||||
|
|
||||||
/** 更新者 */
|
|
||||||
private String updateBy;
|
|
||||||
|
|
||||||
/** 更新时间 */
|
|
||||||
@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss")
|
|
||||||
private Date updateTime;
|
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -1,6 +1,7 @@
|
|||||||
package com.ruoyi.ccdi.domain.vo;
|
package com.ruoyi.ccdi.domain.vo;
|
||||||
|
|
||||||
import com.fasterxml.jackson.annotation.JsonFormat;
|
import com.fasterxml.jackson.annotation.JsonFormat;
|
||||||
|
import io.swagger.v3.oas.annotations.media.Schema;
|
||||||
import lombok.Data;
|
import lombok.Data;
|
||||||
|
|
||||||
import java.io.Serial;
|
import java.io.Serial;
|
||||||
@@ -8,106 +9,67 @@ import java.io.Serializable;
|
|||||||
import java.util.Date;
|
import java.util.Date;
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 个人中介黑名单详情 VO
|
* 个人中介详情VO
|
||||||
*
|
*
|
||||||
* @author ruoyi
|
* @author ruoyi
|
||||||
* @date 2026-01-29
|
* @date 2026-02-04
|
||||||
*/
|
*/
|
||||||
@Data
|
@Data
|
||||||
|
@Schema(description = "个人中介详情VO")
|
||||||
public class CcdiIntermediaryPersonDetailVO implements Serializable {
|
public class CcdiIntermediaryPersonDetailVO implements Serializable {
|
||||||
|
|
||||||
@Serial
|
@Serial
|
||||||
private static final long serialVersionUID = 1L;
|
private static final long serialVersionUID = 1L;
|
||||||
|
|
||||||
// ============================================================
|
@Schema(description = "人员ID")
|
||||||
// 核心字段
|
private String bizId;
|
||||||
// ============================================================
|
|
||||||
/** 中介ID */
|
|
||||||
private Long intermediaryId;
|
|
||||||
|
|
||||||
/** 姓名 */
|
@Schema(description = "姓名")
|
||||||
private String name;
|
private String name;
|
||||||
|
|
||||||
/** 证件号码 */
|
@Schema(description = "人员类型")
|
||||||
private String certificateNo;
|
private String personType;
|
||||||
|
|
||||||
/** 中介类型 */
|
@Schema(description = "人员子类型")
|
||||||
private String intermediaryType;
|
private String personSubType;
|
||||||
|
|
||||||
/** 中介类型名称 */
|
@Schema(description = "性别")
|
||||||
private String intermediaryTypeName;
|
private String gender;
|
||||||
|
|
||||||
/** 状态 */
|
@Schema(description = "证件类型")
|
||||||
private String status;
|
private String idType;
|
||||||
|
|
||||||
/** 状态名称 */
|
@Schema(description = "证件号码")
|
||||||
private String statusName;
|
private String personId;
|
||||||
|
|
||||||
/** 备注 */
|
@Schema(description = "手机号码")
|
||||||
private String remark;
|
private String mobile;
|
||||||
|
|
||||||
/** 数据来源 */
|
@Schema(description = "微信号")
|
||||||
|
private String wechatNo;
|
||||||
|
|
||||||
|
@Schema(description = "联系地址")
|
||||||
|
private String contactAddress;
|
||||||
|
|
||||||
|
@Schema(description = "所在公司")
|
||||||
|
private String company;
|
||||||
|
|
||||||
|
@Schema(description = "职位")
|
||||||
|
private String position;
|
||||||
|
|
||||||
|
@Schema(description = "关联人员ID")
|
||||||
|
private String relatedNumId;
|
||||||
|
|
||||||
|
@Schema(description = "关联关系")
|
||||||
|
private String relationType;
|
||||||
|
|
||||||
|
@Schema(description = "数据来源")
|
||||||
private String dataSource;
|
private String dataSource;
|
||||||
|
|
||||||
/** 数据来源名称 */
|
@Schema(description = "备注")
|
||||||
private String dataSourceName;
|
private String remark;
|
||||||
|
|
||||||
// ============================================================
|
@Schema(description = "创建时间")
|
||||||
// 个人专属字段
|
|
||||||
// ============================================================
|
|
||||||
/** 人员类型 */
|
|
||||||
private String indivType;
|
|
||||||
|
|
||||||
/** 人员子类型 */
|
|
||||||
private String indivSubType;
|
|
||||||
|
|
||||||
/** 性别 */
|
|
||||||
private String indivGender;
|
|
||||||
|
|
||||||
/** 性别名称 */
|
|
||||||
private String indivGenderName;
|
|
||||||
|
|
||||||
/** 证件类型 */
|
|
||||||
private String indivCertType;
|
|
||||||
|
|
||||||
/** 证件类型名称 */
|
|
||||||
private String indivCertTypeName;
|
|
||||||
|
|
||||||
/** 手机号码 */
|
|
||||||
private String indivPhone;
|
|
||||||
|
|
||||||
/** 微信号 */
|
|
||||||
private String indivWechat;
|
|
||||||
|
|
||||||
/** 联系地址 */
|
|
||||||
private String indivAddress;
|
|
||||||
|
|
||||||
/** 所在公司 */
|
|
||||||
private String indivCompany;
|
|
||||||
|
|
||||||
/** 职位/职务 */
|
|
||||||
private String indivPosition;
|
|
||||||
|
|
||||||
/** 关联人员ID */
|
|
||||||
private String indivRelatedId;
|
|
||||||
|
|
||||||
/** 关联关系 */
|
|
||||||
private String indivRelation;
|
|
||||||
|
|
||||||
// ============================================================
|
|
||||||
// 审计字段
|
|
||||||
// ============================================================
|
|
||||||
/** 创建者 */
|
|
||||||
private String createBy;
|
|
||||||
|
|
||||||
/** 创建时间 */
|
|
||||||
@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss")
|
@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss")
|
||||||
private Date createTime;
|
private Date createTime;
|
||||||
|
|
||||||
/** 更新者 */
|
|
||||||
private String updateBy;
|
|
||||||
|
|
||||||
/** 更新时间 */
|
|
||||||
@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss")
|
|
||||||
private Date updateTime;
|
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -0,0 +1,48 @@
|
|||||||
|
package com.ruoyi.ccdi.domain.vo;
|
||||||
|
|
||||||
|
import com.fasterxml.jackson.annotation.JsonFormat;
|
||||||
|
import io.swagger.v3.oas.annotations.media.Schema;
|
||||||
|
import lombok.Data;
|
||||||
|
|
||||||
|
import java.io.Serial;
|
||||||
|
import java.io.Serializable;
|
||||||
|
import java.util.Date;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 中介统一列表VO
|
||||||
|
*
|
||||||
|
* @author ruoyi
|
||||||
|
* @date 2026-02-04
|
||||||
|
*/
|
||||||
|
@Data
|
||||||
|
@Schema(description = "中介统一列表VO")
|
||||||
|
public class CcdiIntermediaryVO implements Serializable {
|
||||||
|
|
||||||
|
@Serial
|
||||||
|
private static final long serialVersionUID = 1L;
|
||||||
|
|
||||||
|
@Schema(description = "ID")
|
||||||
|
private String id;
|
||||||
|
|
||||||
|
@Schema(description = "姓名/机构名称")
|
||||||
|
private String name;
|
||||||
|
|
||||||
|
@Schema(description = "证件号/统一社会信用代码")
|
||||||
|
private String certificateNo;
|
||||||
|
|
||||||
|
@Schema(description = "中介类型(1=个人, 2=实体)")
|
||||||
|
private String intermediaryType;
|
||||||
|
|
||||||
|
@Schema(description = "人员类型")
|
||||||
|
private String personType;
|
||||||
|
|
||||||
|
@Schema(description = "公司")
|
||||||
|
private String company;
|
||||||
|
|
||||||
|
@Schema(description = "数据来源")
|
||||||
|
private String dataSource;
|
||||||
|
|
||||||
|
@Schema(description = "创建时间")
|
||||||
|
@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss")
|
||||||
|
private Date createTime;
|
||||||
|
}
|
||||||
@@ -0,0 +1,33 @@
|
|||||||
|
package com.ruoyi.ccdi.mapper;
|
||||||
|
|
||||||
|
import com.baomidou.mybatisplus.core.mapper.BaseMapper;
|
||||||
|
import com.ruoyi.ccdi.domain.CcdiBizIntermediary;
|
||||||
|
import org.apache.ibatis.annotations.Mapper;
|
||||||
|
|
||||||
|
import java.util.List;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 个人中介Mapper接口
|
||||||
|
*
|
||||||
|
* @author ruoyi
|
||||||
|
* @date 2026-02-04
|
||||||
|
*/
|
||||||
|
@Mapper
|
||||||
|
public interface CcdiBizIntermediaryMapper extends BaseMapper<CcdiBizIntermediary> {
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 批量插入个人中介
|
||||||
|
*
|
||||||
|
* @param list 个人中介列表
|
||||||
|
* @return 插入行数
|
||||||
|
*/
|
||||||
|
int insertBatch(List<CcdiBizIntermediary> list);
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 批量更新个人中介
|
||||||
|
*
|
||||||
|
* @param list 个人中介列表
|
||||||
|
* @return 更新行数
|
||||||
|
*/
|
||||||
|
int updateBatch(List<CcdiBizIntermediary> list);
|
||||||
|
}
|
||||||
@@ -0,0 +1,33 @@
|
|||||||
|
package com.ruoyi.ccdi.mapper;
|
||||||
|
|
||||||
|
import com.baomidou.mybatisplus.core.mapper.BaseMapper;
|
||||||
|
import com.ruoyi.ccdi.domain.CcdiEnterpriseBaseInfo;
|
||||||
|
import org.apache.ibatis.annotations.Mapper;
|
||||||
|
|
||||||
|
import java.util.List;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 实体中介Mapper接口
|
||||||
|
*
|
||||||
|
* @author ruoyi
|
||||||
|
* @date 2026-02-04
|
||||||
|
*/
|
||||||
|
@Mapper
|
||||||
|
public interface CcdiEnterpriseBaseInfoMapper extends BaseMapper<CcdiEnterpriseBaseInfo> {
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 批量插入实体中介
|
||||||
|
*
|
||||||
|
* @param list 实体中介列表
|
||||||
|
* @return 插入行数
|
||||||
|
*/
|
||||||
|
int insertBatch(List<CcdiEnterpriseBaseInfo> list);
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 批量更新实体中介
|
||||||
|
*
|
||||||
|
* @param list 实体中介列表
|
||||||
|
* @return 更新行数
|
||||||
|
*/
|
||||||
|
int updateBatch(List<CcdiEnterpriseBaseInfo> list);
|
||||||
|
}
|
||||||
@@ -1,32 +0,0 @@
|
|||||||
package com.ruoyi.ccdi.mapper;
|
|
||||||
|
|
||||||
import com.baomidou.mybatisplus.core.mapper.BaseMapper;
|
|
||||||
import com.ruoyi.ccdi.domain.CcdiIntermediaryBlacklist;
|
|
||||||
import org.apache.ibatis.annotations.Param;
|
|
||||||
|
|
||||||
import java.util.List;
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 中介人员黑名单 数据层
|
|
||||||
*
|
|
||||||
* @author ruoyi
|
|
||||||
* @date 2026-01-27
|
|
||||||
*/
|
|
||||||
public interface CcdiIntermediaryBlacklistMapper extends BaseMapper<CcdiIntermediaryBlacklist> {
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 批量插入中介黑名单数据
|
|
||||||
*
|
|
||||||
* @param list 中介黑名单列表
|
|
||||||
* @return 插入行数
|
|
||||||
*/
|
|
||||||
int batchInsert(@Param("list") List<CcdiIntermediaryBlacklist> list);
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 批量更新中介黑名单数据
|
|
||||||
*
|
|
||||||
* @param list 中介黑名单列表
|
|
||||||
* @return 更新行数
|
|
||||||
*/
|
|
||||||
int batchUpdate(@Param("list") List<CcdiIntermediaryBlacklist> list);
|
|
||||||
}
|
|
||||||
@@ -1,148 +0,0 @@
|
|||||||
package com.ruoyi.ccdi.service;
|
|
||||||
|
|
||||||
import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
|
|
||||||
import com.ruoyi.ccdi.domain.CcdiIntermediaryBlacklist;
|
|
||||||
import com.ruoyi.ccdi.domain.dto.*;
|
|
||||||
import com.ruoyi.ccdi.domain.excel.CcdiIntermediaryBlacklistExcel;
|
|
||||||
import com.ruoyi.ccdi.domain.excel.CcdiIntermediaryEntityExcel;
|
|
||||||
import com.ruoyi.ccdi.domain.excel.CcdiIntermediaryPersonExcel;
|
|
||||||
import com.ruoyi.ccdi.domain.vo.CcdiIntermediaryBlacklistVO;
|
|
||||||
|
|
||||||
import java.util.List;
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 中介人员黑名单 服务层
|
|
||||||
*
|
|
||||||
* @author ruoyi
|
|
||||||
* @date 2026-01-27
|
|
||||||
*/
|
|
||||||
public interface ICcdiIntermediaryBlacklistService {
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 查询中介黑名单列表
|
|
||||||
*
|
|
||||||
* @param queryDTO 查询条件
|
|
||||||
* @return 中介黑名单集合
|
|
||||||
*/
|
|
||||||
List<CcdiIntermediaryBlacklistVO> selectIntermediaryList(CcdiIntermediaryBlacklistQueryDTO queryDTO);
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 分页查询中介黑名单列表
|
|
||||||
*
|
|
||||||
* @param page 分页对象
|
|
||||||
* @param queryDTO 查询条件
|
|
||||||
* @return 中介黑名单VO分页结果
|
|
||||||
*/
|
|
||||||
Page<CcdiIntermediaryBlacklistVO> selectIntermediaryPage(Page<CcdiIntermediaryBlacklist> page, CcdiIntermediaryBlacklistQueryDTO queryDTO);
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 查询中介黑名单列表（用于导出）
|
|
||||||
*
|
|
||||||
* @param queryDTO 查询条件
|
|
||||||
* @return 中介黑名单Excel实体集合
|
|
||||||
*/
|
|
||||||
List<CcdiIntermediaryBlacklistExcel> selectIntermediaryListForExport(CcdiIntermediaryBlacklistQueryDTO queryDTO);
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 查询中介黑名单详细
|
|
||||||
*
|
|
||||||
* @param intermediaryId 中介ID
|
|
||||||
* @return 中介黑名单VO
|
|
||||||
*/
|
|
||||||
CcdiIntermediaryBlacklistVO selectIntermediaryById(Long intermediaryId);
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 新增中介黑名单（通用接口，不推荐使用）
|
|
||||||
*
|
|
||||||
* @param addDTO 新增DTO
|
|
||||||
* @return 结果
|
|
||||||
* @deprecated 请使用 insertPersonIntermediary 或 insertEntityIntermediary 代替
|
|
||||||
*/
|
|
||||||
@Deprecated
|
|
||||||
int insertIntermediary(CcdiIntermediaryBlacklistAddDTO addDTO);
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 新增个人中介黑名单
|
|
||||||
*
|
|
||||||
* @param addDTO 个人中介新增DTO
|
|
||||||
* @return 结果
|
|
||||||
*/
|
|
||||||
int insertPersonIntermediary(CcdiIntermediaryPersonAddDTO addDTO);
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 新增机构中介黑名单
|
|
||||||
*
|
|
||||||
* @param addDTO 机构中介新增DTO
|
|
||||||
* @return 结果
|
|
||||||
*/
|
|
||||||
int insertEntityIntermediary(CcdiIntermediaryEntityAddDTO addDTO);
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 修改中介黑名单（通用接口，不推荐使用）
|
|
||||||
*
|
|
||||||
* @param editDTO 编辑DTO
|
|
||||||
* @return 结果
|
|
||||||
* @deprecated 请使用 updatePersonIntermediary 或 updateEntityIntermediary 代替
|
|
||||||
*/
|
|
||||||
@Deprecated
|
|
||||||
int updateIntermediary(CcdiIntermediaryBlacklistEditDTO editDTO);
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 修改个人中介黑名单
|
|
||||||
*
|
|
||||||
* @param editDTO 个人中介编辑DTO
|
|
||||||
* @return 结果
|
|
||||||
*/
|
|
||||||
int updatePersonIntermediary(CcdiIntermediaryPersonEditDTO editDTO);
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 修改机构中介黑名单
|
|
||||||
*
|
|
||||||
* @param editDTO 机构中介编辑DTO
|
|
||||||
* @return 结果
|
|
||||||
*/
|
|
||||||
int updateEntityIntermediary(CcdiIntermediaryEntityEditDTO editDTO);
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 批量删除中介黑名单
|
|
||||||
*
|
|
||||||
* @param intermediaryIds 需要删除的中介ID
|
|
||||||
* @return 结果
|
|
||||||
*/
|
|
||||||
int deleteIntermediaryByIds(Long[] intermediaryIds);
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 导入中介黑名单数据
|
|
||||||
*
|
|
||||||
* @param excelList Excel实体列表
|
|
||||||
* @param isUpdateSupport 是否更新支持
|
|
||||||
* @return 结果
|
|
||||||
*/
|
|
||||||
String importIntermediary(List<CcdiIntermediaryBlacklistExcel> excelList, Boolean isUpdateSupport);
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 根据中介类型获取详情（返回不同类型）
|
|
||||||
*
|
|
||||||
* @param intermediaryId 中介ID
|
|
||||||
* @return 个人返回 CcdiIntermediaryPersonDetailVO，机构返回 CcdiIntermediaryEntityDetailVO
|
|
||||||
*/
|
|
||||||
Object selectIntermediaryDetailById(Long intermediaryId);
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 导入个人中介数据
|
|
||||||
*
|
|
||||||
* @param excelList Excel实体列表
|
|
||||||
* @param isUpdateSupport 是否更新支持
|
|
||||||
* @return 结果
|
|
||||||
*/
|
|
||||||
String importPersonIntermediary(List<CcdiIntermediaryPersonExcel> excelList, Boolean isUpdateSupport);
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 导入机构中介数据
|
|
||||||
*
|
|
||||||
* @param excelList Excel实体列表
|
|
||||||
* @param isUpdateSupport 是否更新支持
|
|
||||||
* @return 结果
|
|
||||||
*/
|
|
||||||
String importEntityIntermediary(List<CcdiIntermediaryEntityExcel> excelList, Boolean isUpdateSupport);
|
|
||||||
}
|
|
||||||
@@ -0,0 +1,117 @@
|
|||||||
|
package com.ruoyi.ccdi.service;
|
||||||
|
|
||||||
|
import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
|
||||||
|
import com.ruoyi.ccdi.domain.dto.*;
|
||||||
|
import com.ruoyi.ccdi.domain.vo.CcdiIntermediaryEntityDetailVO;
|
||||||
|
import com.ruoyi.ccdi.domain.vo.CcdiIntermediaryPersonDetailVO;
|
||||||
|
import com.ruoyi.ccdi.domain.vo.CcdiIntermediaryVO;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 中介Service接口
|
||||||
|
*
|
||||||
|
* @author ruoyi
|
||||||
|
* @date 2026-02-04
|
||||||
|
*/
|
||||||
|
public interface ICcdiIntermediaryService {
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 分页查询中介列表
|
||||||
|
*
|
||||||
|
* @param page 分页对象
|
||||||
|
* @param queryDTO 查询条件
|
||||||
|
* @return 中介VO分页结果
|
||||||
|
*/
|
||||||
|
Page<CcdiIntermediaryVO> selectIntermediaryPage(Page<CcdiIntermediaryVO> page, CcdiIntermediaryQueryDTO queryDTO);
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 查询个人中介详情
|
||||||
|
*
|
||||||
|
* @param bizId 人员ID
|
||||||
|
* @return 个人中介详情VO
|
||||||
|
*/
|
||||||
|
CcdiIntermediaryPersonDetailVO selectIntermediaryPersonDetail(String bizId);
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 查询实体中介详情
|
||||||
|
*
|
||||||
|
* @param socialCreditCode 统一社会信用代码
|
||||||
|
* @return 实体中介详情VO
|
||||||
|
*/
|
||||||
|
CcdiIntermediaryEntityDetailVO selectIntermediaryEntityDetail(String socialCreditCode);
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 新增个人中介
|
||||||
|
*
|
||||||
|
* @param addDTO 新增DTO
|
||||||
|
* @return 结果
|
||||||
|
*/
|
||||||
|
int insertIntermediaryPerson(CcdiIntermediaryPersonAddDTO addDTO);
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 修改个人中介
|
||||||
|
*
|
||||||
|
* @param editDTO 编辑DTO
|
||||||
|
* @return 结果
|
||||||
|
*/
|
||||||
|
int updateIntermediaryPerson(CcdiIntermediaryPersonEditDTO editDTO);
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 新增实体中介
|
||||||
|
*
|
||||||
|
* @param addDTO 新增DTO
|
||||||
|
* @return 结果
|
||||||
|
*/
|
||||||
|
int insertIntermediaryEntity(CcdiIntermediaryEntityAddDTO addDTO);
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 修改实体中介
|
||||||
|
*
|
||||||
|
* @param editDTO 编辑DTO
|
||||||
|
* @return 结果
|
||||||
|
*/
|
||||||
|
int updateIntermediaryEntity(CcdiIntermediaryEntityEditDTO editDTO);
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 批量删除中介
|
||||||
|
*
|
||||||
|
* @param ids 需要删除的ID数组
|
||||||
|
* @return 结果
|
||||||
|
*/
|
||||||
|
int deleteIntermediaryByIds(String[] ids);
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 校验人员ID唯一性
|
||||||
|
*
|
||||||
|
* @param personId 人员ID
|
||||||
|
* @param bizId 排除的人员ID
|
||||||
|
* @return true=唯一, false=不唯一
|
||||||
|
*/
|
||||||
|
boolean checkPersonIdUnique(String personId, String bizId);
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 校验统一社会信用代码唯一性
|
||||||
|
*
|
||||||
|
* @param socialCreditCode 统一社会信用代码
|
||||||
|
* @param excludeId 排除的ID
|
||||||
|
* @return true=唯一, false=不唯一
|
||||||
|
*/
|
||||||
|
boolean checkSocialCreditCodeUnique(String socialCreditCode, String excludeId);
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 导入个人中介数据
|
||||||
|
*
|
||||||
|
* @param list Excel实体列表
|
||||||
|
* @param updateSupport 是否更新支持
|
||||||
|
* @return 结果
|
||||||
|
*/
|
||||||
|
String importIntermediaryPerson(java.util.List<com.ruoyi.ccdi.domain.excel.CcdiIntermediaryPersonExcel> list, boolean updateSupport);
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 导入实体中介数据
|
||||||
|
*
|
||||||
|
* @param list Excel实体列表
|
||||||
|
* @param updateSupport 是否更新支持
|
||||||
|
* @return 结果
|
||||||
|
*/
|
||||||
|
String importIntermediaryEntity(java.util.List<com.ruoyi.ccdi.domain.excel.CcdiIntermediaryEntityExcel> list, boolean updateSupport);
|
||||||
|
}
|
||||||
@@ -1,741 +0,0 @@
|
|||||||
package com.ruoyi.ccdi.service.impl;
|
|
||||||
|
|
||||||
import com.baomidou.mybatisplus.core.conditions.query.LambdaQueryWrapper;
|
|
||||||
import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
|
|
||||||
import com.ruoyi.ccdi.domain.CcdiIntermediaryBlacklist;
|
|
||||||
import com.ruoyi.ccdi.domain.dto.*;
|
|
||||||
import com.ruoyi.ccdi.domain.excel.CcdiIntermediaryBlacklistExcel;
|
|
||||||
import com.ruoyi.ccdi.domain.excel.CcdiIntermediaryEntityExcel;
|
|
||||||
import com.ruoyi.ccdi.domain.excel.CcdiIntermediaryPersonExcel;
|
|
||||||
import com.ruoyi.ccdi.domain.vo.CcdiIntermediaryBlacklistVO;
|
|
||||||
import com.ruoyi.ccdi.domain.vo.CcdiIntermediaryEntityDetailVO;
|
|
||||||
import com.ruoyi.ccdi.domain.vo.CcdiIntermediaryPersonDetailVO;
|
|
||||||
import com.ruoyi.ccdi.enums.DataSource;
|
|
||||||
import com.ruoyi.ccdi.enums.Gender;
|
|
||||||
import com.ruoyi.ccdi.enums.IntermediaryStatus;
|
|
||||||
import com.ruoyi.ccdi.enums.IntermediaryType;
|
|
||||||
import com.ruoyi.ccdi.mapper.CcdiIntermediaryBlacklistMapper;
|
|
||||||
import com.ruoyi.ccdi.service.ICcdiIntermediaryBlacklistService;
|
|
||||||
import com.ruoyi.common.utils.StringUtils;
|
|
||||||
import jakarta.annotation.Resource;
|
|
||||||
import org.springframework.beans.BeanUtils;
|
|
||||||
import org.springframework.stereotype.Service;
|
|
||||||
|
|
||||||
import java.text.SimpleDateFormat;
|
|
||||||
import java.util.*;
|
|
||||||
import java.util.stream.Collectors;
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 中介人员黑名单 服务层处理
|
|
||||||
*
|
|
||||||
* @author ruoyi
|
|
||||||
* @date 2026-01-27
|
|
||||||
*/
|
|
||||||
@Service
|
|
||||||
public class CcdiIntermediaryBlacklistServiceImpl implements ICcdiIntermediaryBlacklistService {
|
|
||||||
|
|
||||||
@Resource
|
|
||||||
private CcdiIntermediaryBlacklistMapper intermediaryMapper;
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 查询中介黑名单列表
|
|
||||||
*
|
|
||||||
* @param queryDTO 查询条件
|
|
||||||
* @return 中介黑名单集合
|
|
||||||
*/
|
|
||||||
@Override
|
|
||||||
public List<CcdiIntermediaryBlacklistVO> selectIntermediaryList(CcdiIntermediaryBlacklistQueryDTO queryDTO) {
|
|
||||||
LambdaQueryWrapper<CcdiIntermediaryBlacklist> wrapper = buildQueryWrapper(queryDTO);
|
|
||||||
List<CcdiIntermediaryBlacklist> list = intermediaryMapper.selectList(wrapper);
|
|
||||||
return list.stream().map(this::convertToVO).collect(Collectors.toList());
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 分页查询中介黑名单列表
|
|
||||||
*
|
|
||||||
* @param page 分页对象
|
|
||||||
* @param queryDTO 查询条件
|
|
||||||
* @return 中介黑名单VO分页结果
|
|
||||||
*/
|
|
||||||
@Override
|
|
||||||
public Page<CcdiIntermediaryBlacklistVO> selectIntermediaryPage(Page<CcdiIntermediaryBlacklist> page, CcdiIntermediaryBlacklistQueryDTO queryDTO) {
|
|
||||||
LambdaQueryWrapper<CcdiIntermediaryBlacklist> wrapper = buildQueryWrapper(queryDTO);
|
|
||||||
Page<CcdiIntermediaryBlacklist> resultPage = intermediaryMapper.selectPage(page, wrapper);
|
|
||||||
|
|
||||||
// 转换为VO
|
|
||||||
Page<CcdiIntermediaryBlacklistVO> voPage = new Page<>(resultPage.getCurrent(), resultPage.getSize(), resultPage.getTotal());
|
|
||||||
voPage.setRecords(resultPage.getRecords().stream().map(this::convertToVO).collect(Collectors.toList()));
|
|
||||||
voPage.setPages(resultPage.getPages());
|
|
||||||
|
|
||||||
return voPage;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 查询中介黑名单列表（用于导出）
|
|
||||||
*
|
|
||||||
* @param queryDTO 查询条件
|
|
||||||
* @return 中介黑名单Excel实体集合
|
|
||||||
*/
|
|
||||||
@Override
|
|
||||||
public List<CcdiIntermediaryBlacklistExcel> selectIntermediaryListForExport(CcdiIntermediaryBlacklistQueryDTO queryDTO) {
|
|
||||||
LambdaQueryWrapper<CcdiIntermediaryBlacklist> wrapper = buildQueryWrapper(queryDTO);
|
|
||||||
List<CcdiIntermediaryBlacklist> list = intermediaryMapper.selectList(wrapper);
|
|
||||||
return list.stream().map(entity -> {
|
|
||||||
CcdiIntermediaryBlacklistExcel excel = new CcdiIntermediaryBlacklistExcel();
|
|
||||||
BeanUtils.copyProperties(entity, excel);
|
|
||||||
return excel;
|
|
||||||
}).toList();
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 查询中介黑名单详细
|
|
||||||
*
|
|
||||||
* @param intermediaryId 中介ID
|
|
||||||
* @return 中介黑名单VO
|
|
||||||
*/
|
|
||||||
@Override
|
|
||||||
public CcdiIntermediaryBlacklistVO selectIntermediaryById(Long intermediaryId) {
|
|
||||||
CcdiIntermediaryBlacklist intermediary = intermediaryMapper.selectById(intermediaryId);
|
|
||||||
return convertToVO(intermediary);
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 新增中介黑名单
|
|
||||||
*
|
|
||||||
* @param addDTO 新增DTO
|
|
||||||
* @return 结果
|
|
||||||
*/
|
|
||||||
@Override
|
|
||||||
@Deprecated
|
|
||||||
public int insertIntermediary(CcdiIntermediaryBlacklistAddDTO addDTO) {
|
|
||||||
CcdiIntermediaryBlacklist intermediary = new CcdiIntermediaryBlacklist();
|
|
||||||
BeanUtils.copyProperties(addDTO, intermediary);
|
|
||||||
// 手动新增时，数据来源设置为 MANUAL
|
|
||||||
intermediary.setDataSource("MANUAL");
|
|
||||||
// 默认状态设置为正常
|
|
||||||
intermediary.setStatus("0");
|
|
||||||
return intermediaryMapper.insert(intermediary);
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 新增个人中介黑名单
|
|
||||||
*
|
|
||||||
* @param addDTO 个人中介新增DTO
|
|
||||||
* @return 结果
|
|
||||||
*/
|
|
||||||
@Override
|
|
||||||
public int insertPersonIntermediary(CcdiIntermediaryPersonAddDTO addDTO) {
|
|
||||||
CcdiIntermediaryBlacklist intermediary = new CcdiIntermediaryBlacklist();
|
|
||||||
BeanUtils.copyProperties(addDTO, intermediary);
|
|
||||||
// 设置中介类型为个人
|
|
||||||
intermediary.setIntermediaryType("1");
|
|
||||||
// 手动新增时，数据来源设置为 MANUAL
|
|
||||||
intermediary.setDataSource("MANUAL");
|
|
||||||
return intermediaryMapper.insert(intermediary);
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 新增机构中介黑名单
|
|
||||||
*
|
|
||||||
* @param addDTO 机构中介新增DTO
|
|
||||||
* @return 结果
|
|
||||||
*/
|
|
||||||
@Override
|
|
||||||
public int insertEntityIntermediary(CcdiIntermediaryEntityAddDTO addDTO) {
|
|
||||||
CcdiIntermediaryBlacklist intermediary = new CcdiIntermediaryBlacklist();
|
|
||||||
BeanUtils.copyProperties(addDTO, intermediary);
|
|
||||||
// 设置中介类型为机构
|
|
||||||
intermediary.setIntermediaryType("2");
|
|
||||||
// 证件号使用统一社会信用代码
|
|
||||||
intermediary.setCertificateNo(addDTO.getCorpCreditCode());
|
|
||||||
// 手动新增时，数据来源设置为 MANUAL
|
|
||||||
intermediary.setDataSource("MANUAL");
|
|
||||||
return intermediaryMapper.insert(intermediary);
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 修改中介黑名单
|
|
||||||
*
|
|
||||||
* @param editDTO 编辑DTO
|
|
||||||
* @return 结果
|
|
||||||
*/
|
|
||||||
@Override
|
|
||||||
@Deprecated
|
|
||||||
public int updateIntermediary(CcdiIntermediaryBlacklistEditDTO editDTO) {
|
|
||||||
CcdiIntermediaryBlacklist intermediary = new CcdiIntermediaryBlacklist();
|
|
||||||
BeanUtils.copyProperties(editDTO, intermediary);
|
|
||||||
return intermediaryMapper.updateById(intermediary);
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 修改个人中介黑名单
|
|
||||||
*
|
|
||||||
* @param editDTO 个人中介编辑DTO
|
|
||||||
* @return 结果
|
|
||||||
*/
|
|
||||||
@Override
|
|
||||||
public int updatePersonIntermediary(CcdiIntermediaryPersonEditDTO editDTO) {
|
|
||||||
CcdiIntermediaryBlacklist intermediary = new CcdiIntermediaryBlacklist();
|
|
||||||
BeanUtils.copyProperties(editDTO, intermediary);
|
|
||||||
// 设置中介类型为个人
|
|
||||||
intermediary.setIntermediaryType("1");
|
|
||||||
// 清空机构专属字段
|
|
||||||
clearEntityFields(intermediary);
|
|
||||||
return intermediaryMapper.updateById(intermediary);
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 修改机构中介黑名单
|
|
||||||
*
|
|
||||||
* @param editDTO 机构中介编辑DTO
|
|
||||||
* @return 结果
|
|
||||||
*/
|
|
||||||
@Override
|
|
||||||
public int updateEntityIntermediary(CcdiIntermediaryEntityEditDTO editDTO) {
|
|
||||||
CcdiIntermediaryBlacklist intermediary = new CcdiIntermediaryBlacklist();
|
|
||||||
BeanUtils.copyProperties(editDTO, intermediary);
|
|
||||||
// 设置中介类型为机构
|
|
||||||
intermediary.setIntermediaryType("2");
|
|
||||||
// 清空个人专属字段
|
|
||||||
clearPersonFields(intermediary);
|
|
||||||
return intermediaryMapper.updateById(intermediary);
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 清空个人专属字段
|
|
||||||
*/
|
|
||||||
private void clearPersonFields(CcdiIntermediaryBlacklist intermediary) {
|
|
||||||
intermediary.setIndivType(null);
|
|
||||||
intermediary.setIndivSubType(null);
|
|
||||||
intermediary.setIndivGender(null);
|
|
||||||
intermediary.setIndivCertType(null);
|
|
||||||
intermediary.setIndivPhone(null);
|
|
||||||
intermediary.setIndivWechat(null);
|
|
||||||
intermediary.setIndivAddress(null);
|
|
||||||
intermediary.setIndivCompany(null);
|
|
||||||
intermediary.setIndivPosition(null);
|
|
||||||
intermediary.setIndivRelatedId(null);
|
|
||||||
intermediary.setIndivRelation(null);
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 清空机构专属字段
|
|
||||||
*/
|
|
||||||
private void clearEntityFields(CcdiIntermediaryBlacklist intermediary) {
|
|
||||||
intermediary.setCorpCreditCode(null);
|
|
||||||
intermediary.setCorpType(null);
|
|
||||||
intermediary.setCorpNature(null);
|
|
||||||
intermediary.setCorpIndustryCategory(null);
|
|
||||||
intermediary.setCorpIndustry(null);
|
|
||||||
intermediary.setCorpEstablishDate(null);
|
|
||||||
intermediary.setCorpAddress(null);
|
|
||||||
intermediary.setCorpLegalRep(null);
|
|
||||||
intermediary.setCorpLegalCertType(null);
|
|
||||||
intermediary.setCorpLegalCertNo(null);
|
|
||||||
intermediary.setCorpShareholder1(null);
|
|
||||||
intermediary.setCorpShareholder2(null);
|
|
||||||
intermediary.setCorpShareholder3(null);
|
|
||||||
intermediary.setCorpShareholder4(null);
|
|
||||||
intermediary.setCorpShareholder5(null);
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 批量删除中介黑名单
|
|
||||||
*
|
|
||||||
* @param intermediaryIds 需要删除的中介ID
|
|
||||||
* @return 结果
|
|
||||||
*/
|
|
||||||
@Override
|
|
||||||
public int deleteIntermediaryByIds(Long[] intermediaryIds) {
|
|
||||||
return intermediaryMapper.deleteBatchIds(List.of(intermediaryIds));
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 导入中介黑名单数据
|
|
||||||
*
|
|
||||||
* @param excelList Excel实体列表
|
|
||||||
* @param isUpdateSupport 是否更新支持
|
|
||||||
* @return 结果
|
|
||||||
*/
|
|
||||||
@Override
|
|
||||||
public String importIntermediary(List<CcdiIntermediaryBlacklistExcel> excelList, Boolean isUpdateSupport) {
|
|
||||||
if (excelList == null || excelList.isEmpty()) {
|
|
||||||
return "至少需要一条数据";
|
|
||||||
}
|
|
||||||
|
|
||||||
int successNum = 0;
|
|
||||||
int failureNum = 0;
|
|
||||||
StringBuilder successMsg = new StringBuilder();
|
|
||||||
StringBuilder failureMsg = new StringBuilder();
|
|
||||||
|
|
||||||
for (CcdiIntermediaryBlacklistExcel excel : excelList) {
|
|
||||||
try {
|
|
||||||
// 转换为AddDTO
|
|
||||||
CcdiIntermediaryBlacklistAddDTO addDTO = new CcdiIntermediaryBlacklistAddDTO();
|
|
||||||
BeanUtils.copyProperties(excel, addDTO);
|
|
||||||
|
|
||||||
// 验证数据
|
|
||||||
validateIntermediaryData(addDTO);
|
|
||||||
|
|
||||||
CcdiIntermediaryBlacklist intermediary = new CcdiIntermediaryBlacklist();
|
|
||||||
BeanUtils.copyProperties(addDTO, intermediary);
|
|
||||||
|
|
||||||
intermediaryMapper.insert(intermediary);
|
|
||||||
successNum++;
|
|
||||||
successMsg.append("<br/>").append(successNum).append("、").append(addDTO.getName()).append(" 导入成功");
|
|
||||||
} catch (Exception e) {
|
|
||||||
failureNum++;
|
|
||||||
failureMsg.append("<br/>").append(failureNum).append("、").append(excel.getName()).append(" 导入失败：");
|
|
||||||
failureMsg.append(e.getMessage());
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
if (failureNum > 0) {
|
|
||||||
failureMsg.insert(0, "很抱歉，导入失败！共 " + failureNum + " 条数据格式不正确，错误如下：");
|
|
||||||
throw new RuntimeException(failureMsg.toString());
|
|
||||||
} else {
|
|
||||||
successMsg.insert(0, "恭喜您，数据已全部导入成功！共 " + successNum + " 条");
|
|
||||||
return successMsg.toString();
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 根据中介类型获取详情（返回不同类型）
|
|
||||||
*
|
|
||||||
* @param intermediaryId 中介ID
|
|
||||||
* @return 个人返回 CcdiIntermediaryPersonDetailVO，机构返回 CcdiIntermediaryEntityDetailVO
|
|
||||||
*/
|
|
||||||
@Override
|
|
||||||
public Object selectIntermediaryDetailById(Long intermediaryId) {
|
|
||||||
CcdiIntermediaryBlacklist intermediary = intermediaryMapper.selectById(intermediaryId);
|
|
||||||
if (intermediary == null) {
|
|
||||||
return null;
|
|
||||||
}
|
|
||||||
|
|
||||||
// 根据中介类型返回不同的 VO
|
|
||||||
if ("1".equals(intermediary.getIntermediaryType())) {
|
|
||||||
// 个人类型
|
|
||||||
return convertToPersonDetailVO(intermediary);
|
|
||||||
} else {
|
|
||||||
// 机构类型
|
|
||||||
return convertToEntityDetailVO(intermediary);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 导入个人中介数据（批量插入优化版）
|
|
||||||
*
|
|
||||||
* @param excelList Excel实体列表
|
|
||||||
* @param isUpdateSupport 是否更新支持
|
|
||||||
* @return 结果
|
|
||||||
*/
|
|
||||||
@Override
|
|
||||||
public String importPersonIntermediary(List<CcdiIntermediaryPersonExcel> excelList, Boolean isUpdateSupport) {
|
|
||||||
if (excelList == null || excelList.isEmpty()) {
|
|
||||||
return "至少需要一条数据";
|
|
||||||
}
|
|
||||||
|
|
||||||
// 批量处理：先验证所有数据
|
|
||||||
List<CcdiIntermediaryBlacklist> toInsertList = new ArrayList<>();
|
|
||||||
List<CcdiIntermediaryBlacklist> toUpdateList = new ArrayList<>();
|
|
||||||
List<String> errorMessages = new ArrayList<>();
|
|
||||||
|
|
||||||
// 批量查询已存在的记录（用于唯一性校验或更新支持）
|
|
||||||
Set<String> existingCertNos = new HashSet<>();
|
|
||||||
Map<String, Long> certNoToIdMap = new HashMap<>();
|
|
||||||
for (CcdiIntermediaryPersonExcel excel : excelList) {
|
|
||||||
if (StringUtils.isNotEmpty(excel.getCertificateNo())) {
|
|
||||||
existingCertNos.add(excel.getCertificateNo());
|
|
||||||
}
|
|
||||||
}
|
|
||||||
if (!existingCertNos.isEmpty()) {
|
|
||||||
LambdaQueryWrapper<CcdiIntermediaryBlacklist> wrapper = new LambdaQueryWrapper<>();
|
|
||||||
wrapper.eq(CcdiIntermediaryBlacklist::getIntermediaryType, "1")
|
|
||||||
.in(CcdiIntermediaryBlacklist::getCertificateNo, existingCertNos)
|
|
||||||
.select(CcdiIntermediaryBlacklist::getIntermediaryId, CcdiIntermediaryBlacklist::getCertificateNo);
|
|
||||||
List<CcdiIntermediaryBlacklist> existingList = intermediaryMapper.selectList(wrapper);
|
|
||||||
for (CcdiIntermediaryBlacklist existing : existingList) {
|
|
||||||
certNoToIdMap.put(existing.getCertificateNo(), existing.getIntermediaryId());
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// 如果不是更新模式，先进行唯一性校验
|
|
||||||
if (!isUpdateSupport) {
|
|
||||||
for (CcdiIntermediaryPersonExcel excel : excelList) {
|
|
||||||
if (StringUtils.isNotEmpty(excel.getCertificateNo()) && certNoToIdMap.containsKey(excel.getCertificateNo())) {
|
|
||||||
throw new RuntimeException("证件号 " + excel.getCertificateNo() + " 已存在，请勿重复导入");
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// 处理每条数据
|
|
||||||
for (int i = 0; i < excelList.size(); i++) {
|
|
||||||
CcdiIntermediaryPersonExcel excel = excelList.get(i);
|
|
||||||
try {
|
|
||||||
// 验证数据
|
|
||||||
validatePersonIntermediaryData(excel);
|
|
||||||
|
|
||||||
// 转换为实体
|
|
||||||
CcdiIntermediaryBlacklist intermediary = new CcdiIntermediaryBlacklist();
|
|
||||||
intermediary.setName(excel.getName());
|
|
||||||
intermediary.setCertificateNo(excel.getCertificateNo());
|
|
||||||
intermediary.setIntermediaryType("1");
|
|
||||||
intermediary.setStatus("0");
|
|
||||||
intermediary.setDataSource("IMPORT");
|
|
||||||
intermediary.setRemark(excel.getRemark());
|
|
||||||
|
|
||||||
// 个人专属字段
|
|
||||||
intermediary.setIndivType(excel.getIndivType());
|
|
||||||
intermediary.setIndivSubType(excel.getIndivSubType());
|
|
||||||
intermediary.setIndivGender(excel.getIndivGender());
|
|
||||||
intermediary.setIndivCertType(StringUtils.isNotEmpty(excel.getIndivCertType()) ? excel.getIndivCertType() : "身份证");
|
|
||||||
intermediary.setIndivPhone(excel.getIndivPhone());
|
|
||||||
intermediary.setIndivWechat(excel.getIndivWechat());
|
|
||||||
intermediary.setIndivAddress(excel.getIndivAddress());
|
|
||||||
intermediary.setIndivCompany(excel.getIndivCompany());
|
|
||||||
intermediary.setIndivPosition(excel.getIndivPosition());
|
|
||||||
intermediary.setIndivRelatedId(excel.getIndivRelatedId());
|
|
||||||
intermediary.setIndivRelation(excel.getIndivRelation());
|
|
||||||
|
|
||||||
// 检查是否需要更新
|
|
||||||
if (isUpdateSupport && StringUtils.isNotEmpty(excel.getCertificateNo()) && certNoToIdMap.containsKey(excel.getCertificateNo())) {
|
|
||||||
intermediary.setIntermediaryId(certNoToIdMap.get(excel.getCertificateNo()));
|
|
||||||
toUpdateList.add(intermediary);
|
|
||||||
} else {
|
|
||||||
toInsertList.add(intermediary);
|
|
||||||
}
|
|
||||||
} catch (Exception e) {
|
|
||||||
errorMessages.add("第" + (i + 1) + "行导入失败：" + e.getMessage());
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// 批量执行数据库操作
|
|
||||||
int successNum = 0;
|
|
||||||
int failureNum = errorMessages.size();
|
|
||||||
|
|
||||||
// 批量插入
|
|
||||||
if (!toInsertList.isEmpty()) {
|
|
||||||
intermediaryMapper.batchInsert(toInsertList);
|
|
||||||
successNum += toInsertList.size();
|
|
||||||
}
|
|
||||||
|
|
||||||
// 批量更新
|
|
||||||
if (!toUpdateList.isEmpty()) {
|
|
||||||
intermediaryMapper.batchUpdate(toUpdateList);
|
|
||||||
successNum += toUpdateList.size();
|
|
||||||
}
|
|
||||||
|
|
||||||
// 构建失败消息
|
|
||||||
StringBuilder failureMsg = new StringBuilder();
|
|
||||||
for (String error : errorMessages) {
|
|
||||||
failureMsg.append("<br/>").append(error);
|
|
||||||
}
|
|
||||||
|
|
||||||
// 返回结果
|
|
||||||
if (failureNum > 0) {
|
|
||||||
failureMsg.insert(0, "很抱歉，导入失败！共 " + failureNum + " 条数据格式不正确，错误如下：");
|
|
||||||
throw new RuntimeException(failureMsg.toString());
|
|
||||||
} else {
|
|
||||||
return "恭喜您，数据已全部导入成功！共 " + successNum + " 条";
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 导入机构中介数据（批量插入优化版）
|
|
||||||
*
|
|
||||||
* @param excelList Excel实体列表
|
|
||||||
* @param isUpdateSupport 是否更新支持
|
|
||||||
* @return 结果
|
|
||||||
*/
|
|
||||||
@Override
|
|
||||||
public String importEntityIntermediary(List<CcdiIntermediaryEntityExcel> excelList, Boolean isUpdateSupport) {
|
|
||||||
if (excelList == null || excelList.isEmpty()) {
|
|
||||||
return "至少需要一条数据";
|
|
||||||
}
|
|
||||||
|
|
||||||
// 批量处理：先验证所有数据
|
|
||||||
List<CcdiIntermediaryBlacklist> toInsertList = new ArrayList<>();
|
|
||||||
List<CcdiIntermediaryBlacklist> toUpdateList = new ArrayList<>();
|
|
||||||
List<String> errorMessages = new ArrayList<>();
|
|
||||||
|
|
||||||
// 批量查询已存在的记录（用于唯一性校验或更新支持）
|
|
||||||
Set<String> existingCreditCodes = new HashSet<>();
|
|
||||||
Map<String, Long> creditCodeToIdMap = new HashMap<>();
|
|
||||||
for (CcdiIntermediaryEntityExcel excel : excelList) {
|
|
||||||
if (StringUtils.isNotEmpty(excel.getCorpCreditCode())) {
|
|
||||||
existingCreditCodes.add(excel.getCorpCreditCode());
|
|
||||||
}
|
|
||||||
}
|
|
||||||
if (!existingCreditCodes.isEmpty()) {
|
|
||||||
LambdaQueryWrapper<CcdiIntermediaryBlacklist> wrapper = new LambdaQueryWrapper<>();
|
|
||||||
wrapper.eq(CcdiIntermediaryBlacklist::getIntermediaryType, "2")
|
|
||||||
.in(CcdiIntermediaryBlacklist::getCorpCreditCode, existingCreditCodes)
|
|
||||||
.select(CcdiIntermediaryBlacklist::getIntermediaryId, CcdiIntermediaryBlacklist::getCorpCreditCode);
|
|
||||||
List<CcdiIntermediaryBlacklist> existingList = intermediaryMapper.selectList(wrapper);
|
|
||||||
for (CcdiIntermediaryBlacklist existing : existingList) {
|
|
||||||
creditCodeToIdMap.put(existing.getCorpCreditCode(), existing.getIntermediaryId());
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// 如果不是更新模式，先进行唯一性校验
|
|
||||||
if (!isUpdateSupport) {
|
|
||||||
for (CcdiIntermediaryEntityExcel excel : excelList) {
|
|
||||||
if (StringUtils.isNotEmpty(excel.getCorpCreditCode()) && creditCodeToIdMap.containsKey(excel.getCorpCreditCode())) {
|
|
||||||
throw new RuntimeException("统一社会信用代码 " + excel.getCorpCreditCode() + " 已存在，请勿重复导入");
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd");
|
|
||||||
|
|
||||||
// 处理每条数据
|
|
||||||
for (int i = 0; i < excelList.size(); i++) {
|
|
||||||
CcdiIntermediaryEntityExcel excel = excelList.get(i);
|
|
||||||
try {
|
|
||||||
// 验证数据
|
|
||||||
validateEntityIntermediaryData(excel);
|
|
||||||
|
|
||||||
// 转换为实体
|
|
||||||
CcdiIntermediaryBlacklist intermediary = new CcdiIntermediaryBlacklist();
|
|
||||||
intermediary.setName(excel.getName());
|
|
||||||
// 对于机构中介，使用统一社会信用代码作为证件号
|
|
||||||
intermediary.setCertificateNo(excel.getCorpCreditCode());
|
|
||||||
intermediary.setIntermediaryType("2");
|
|
||||||
intermediary.setStatus("0");
|
|
||||||
intermediary.setDataSource("IMPORT");
|
|
||||||
intermediary.setRemark(excel.getRemark());
|
|
||||||
|
|
||||||
// 机构专属字段
|
|
||||||
intermediary.setCorpCreditCode(excel.getCorpCreditCode());
|
|
||||||
intermediary.setCorpType(excel.getCorpType());
|
|
||||||
intermediary.setCorpNature(excel.getCorpNature());
|
|
||||||
intermediary.setCorpIndustryCategory(excel.getCorpIndustryCategory());
|
|
||||||
intermediary.setCorpIndustry(excel.getCorpIndustry());
|
|
||||||
|
|
||||||
// 解析成立日期
|
|
||||||
if (StringUtils.isNotEmpty(excel.getCorpEstablishDate())) {
|
|
||||||
try {
|
|
||||||
intermediary.setCorpEstablishDate(sdf.parse(excel.getCorpEstablishDate()));
|
|
||||||
} catch (Exception e) {
|
|
||||||
// 忽略日期解析错误
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
intermediary.setCorpAddress(excel.getCorpAddress());
|
|
||||||
intermediary.setCorpLegalRep(excel.getCorpLegalRep());
|
|
||||||
intermediary.setCorpLegalCertType(excel.getCorpLegalCertType());
|
|
||||||
intermediary.setCorpLegalCertNo(excel.getCorpLegalCertNo());
|
|
||||||
intermediary.setCorpShareholder1(excel.getCorpShareholder1());
|
|
||||||
intermediary.setCorpShareholder2(excel.getCorpShareholder2());
|
|
||||||
intermediary.setCorpShareholder3(excel.getCorpShareholder3());
|
|
||||||
intermediary.setCorpShareholder4(excel.getCorpShareholder4());
|
|
||||||
intermediary.setCorpShareholder5(excel.getCorpShareholder5());
|
|
||||||
|
|
||||||
// 检查是否需要更新
|
|
||||||
if (isUpdateSupport && StringUtils.isNotEmpty(excel.getCorpCreditCode()) && creditCodeToIdMap.containsKey(excel.getCorpCreditCode())) {
|
|
||||||
intermediary.setIntermediaryId(creditCodeToIdMap.get(excel.getCorpCreditCode()));
|
|
||||||
toUpdateList.add(intermediary);
|
|
||||||
} else {
|
|
||||||
toInsertList.add(intermediary);
|
|
||||||
}
|
|
||||||
} catch (Exception e) {
|
|
||||||
errorMessages.add("第" + (i + 1) + "行导入失败：" + e.getMessage());
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// 批量执行数据库操作
|
|
||||||
int successNum = 0;
|
|
||||||
int failureNum = errorMessages.size();
|
|
||||||
|
|
||||||
// 批量插入
|
|
||||||
if (!toInsertList.isEmpty()) {
|
|
||||||
intermediaryMapper.batchInsert(toInsertList);
|
|
||||||
successNum += toInsertList.size();
|
|
||||||
}
|
|
||||||
|
|
||||||
// 批量更新
|
|
||||||
if (!toUpdateList.isEmpty()) {
|
|
||||||
intermediaryMapper.batchUpdate(toUpdateList);
|
|
||||||
successNum += toUpdateList.size();
|
|
||||||
}
|
|
||||||
|
|
||||||
// 构建失败消息
|
|
||||||
StringBuilder failureMsg = new StringBuilder();
|
|
||||||
for (String error : errorMessages) {
|
|
||||||
failureMsg.append("<br/>").append(error);
|
|
||||||
}
|
|
||||||
|
|
||||||
// 返回结果
|
|
||||||
if (failureNum > 0) {
|
|
||||||
failureMsg.insert(0, "很抱歉，导入失败！共 " + failureNum + " 条数据格式不正确，错误如下：");
|
|
||||||
throw new RuntimeException(failureMsg.toString());
|
|
||||||
} else {
|
|
||||||
return "恭喜您，数据已全部导入成功！共 " + successNum + " 条";
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 验证个人中介数据
|
|
||||||
*/
|
|
||||||
private void validatePersonIntermediaryData(CcdiIntermediaryPersonExcel excel) {
|
|
||||||
if (StringUtils.isEmpty(excel.getName())) {
|
|
||||||
throw new RuntimeException("姓名不能为空");
|
|
||||||
}
|
|
||||||
if (StringUtils.isEmpty(excel.getCertificateNo())) {
|
|
||||||
throw new RuntimeException("证件号码不能为空");
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 验证机构中介数据
|
|
||||||
*/
|
|
||||||
private void validateEntityIntermediaryData(CcdiIntermediaryEntityExcel excel) {
|
|
||||||
if (StringUtils.isEmpty(excel.getName())) {
|
|
||||||
throw new RuntimeException("机构名称不能为空");
|
|
||||||
}
|
|
||||||
// 验证统一社会信用代码不能为空（因为会用作 certificate_no 字段）
|
|
||||||
if (StringUtils.isEmpty(excel.getCorpCreditCode())) {
|
|
||||||
throw new RuntimeException("统一社会信用代码不能为空");
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 转换为个人详情 VO
|
|
||||||
*/
|
|
||||||
private CcdiIntermediaryPersonDetailVO convertToPersonDetailVO(CcdiIntermediaryBlacklist intermediary) {
|
|
||||||
if (intermediary == null) {
|
|
||||||
return null;
|
|
||||||
}
|
|
||||||
|
|
||||||
CcdiIntermediaryPersonDetailVO vo = new CcdiIntermediaryPersonDetailVO();
|
|
||||||
// 复制基础字段
|
|
||||||
vo.setIntermediaryId(intermediary.getIntermediaryId());
|
|
||||||
vo.setName(intermediary.getName());
|
|
||||||
vo.setCertificateNo(intermediary.getCertificateNo());
|
|
||||||
vo.setIntermediaryType(intermediary.getIntermediaryType());
|
|
||||||
vo.setStatus(intermediary.getStatus());
|
|
||||||
vo.setRemark(intermediary.getRemark());
|
|
||||||
vo.setDataSource(intermediary.getDataSource());
|
|
||||||
vo.setCreateBy(intermediary.getCreateBy());
|
|
||||||
vo.setCreateTime(intermediary.getCreateTime());
|
|
||||||
vo.setUpdateBy(intermediary.getUpdateBy());
|
|
||||||
vo.setUpdateTime(intermediary.getUpdateTime());
|
|
||||||
|
|
||||||
// 复制个人专属字段
|
|
||||||
vo.setIndivType(intermediary.getIndivType());
|
|
||||||
vo.setIndivSubType(intermediary.getIndivSubType());
|
|
||||||
vo.setIndivGender(intermediary.getIndivGender());
|
|
||||||
vo.setIndivCertType(intermediary.getIndivCertType());
|
|
||||||
vo.setIndivPhone(intermediary.getIndivPhone());
|
|
||||||
vo.setIndivWechat(intermediary.getIndivWechat());
|
|
||||||
vo.setIndivAddress(intermediary.getIndivAddress());
|
|
||||||
vo.setIndivCompany(intermediary.getIndivCompany());
|
|
||||||
vo.setIndivPosition(intermediary.getIndivPosition());
|
|
||||||
vo.setIndivRelatedId(intermediary.getIndivRelatedId());
|
|
||||||
vo.setIndivRelation(intermediary.getIndivRelation());
|
|
||||||
|
|
||||||
// 设置枚举类型的名称
|
|
||||||
vo.setIntermediaryTypeName(IntermediaryType.PERSON.getDesc());
|
|
||||||
vo.setStatusName(IntermediaryStatus.getDescByCode(intermediary.getStatus()));
|
|
||||||
vo.setDataSourceName(DataSource.getDescByCode(intermediary.getDataSource()));
|
|
||||||
vo.setIndivGenderName(Gender.getDescByCode(intermediary.getIndivGender()));
|
|
||||||
|
|
||||||
return vo;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 转换为机构详情 VO
|
|
||||||
*/
|
|
||||||
private CcdiIntermediaryEntityDetailVO convertToEntityDetailVO(CcdiIntermediaryBlacklist intermediary) {
|
|
||||||
if (intermediary == null) {
|
|
||||||
return null;
|
|
||||||
}
|
|
||||||
|
|
||||||
CcdiIntermediaryEntityDetailVO vo = new CcdiIntermediaryEntityDetailVO();
|
|
||||||
// 复制基础字段
|
|
||||||
vo.setIntermediaryId(intermediary.getIntermediaryId());
|
|
||||||
vo.setName(intermediary.getName());
|
|
||||||
vo.setCertificateNo(intermediary.getCertificateNo());
|
|
||||||
vo.setIntermediaryType(intermediary.getIntermediaryType());
|
|
||||||
vo.setStatus(intermediary.getStatus());
|
|
||||||
vo.setRemark(intermediary.getRemark());
|
|
||||||
vo.setDataSource(intermediary.getDataSource());
|
|
||||||
vo.setCreateBy(intermediary.getCreateBy());
|
|
||||||
vo.setCreateTime(intermediary.getCreateTime());
|
|
||||||
vo.setUpdateBy(intermediary.getUpdateBy());
|
|
||||||
vo.setUpdateTime(intermediary.getUpdateTime());
|
|
||||||
|
|
||||||
// 复制机构专属字段
|
|
||||||
vo.setCorpCreditCode(intermediary.getCorpCreditCode());
|
|
||||||
vo.setCorpType(intermediary.getCorpType());
|
|
||||||
vo.setCorpNature(intermediary.getCorpNature());
|
|
||||||
vo.setCorpIndustryCategory(intermediary.getCorpIndustryCategory());
|
|
||||||
vo.setCorpIndustry(intermediary.getCorpIndustry());
|
|
||||||
vo.setCorpEstablishDate(intermediary.getCorpEstablishDate());
|
|
||||||
vo.setCorpAddress(intermediary.getCorpAddress());
|
|
||||||
vo.setCorpLegalRep(intermediary.getCorpLegalRep());
|
|
||||||
vo.setCorpLegalCertType(intermediary.getCorpLegalCertType());
|
|
||||||
vo.setCorpLegalCertNo(intermediary.getCorpLegalCertNo());
|
|
||||||
vo.setCorpShareholder1(intermediary.getCorpShareholder1());
|
|
||||||
vo.setCorpShareholder2(intermediary.getCorpShareholder2());
|
|
||||||
vo.setCorpShareholder3(intermediary.getCorpShareholder3());
|
|
||||||
vo.setCorpShareholder4(intermediary.getCorpShareholder4());
|
|
||||||
vo.setCorpShareholder5(intermediary.getCorpShareholder5());
|
|
||||||
|
|
||||||
// 设置枚举类型的名称
|
|
||||||
vo.setIntermediaryTypeName(IntermediaryType.ENTITY.getDesc());
|
|
||||||
vo.setStatusName(IntermediaryStatus.getDescByCode(intermediary.getStatus()));
|
|
||||||
vo.setDataSourceName(DataSource.getDescByCode(intermediary.getDataSource()));
|
|
||||||
|
|
||||||
return vo;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 构建查询条件
|
|
||||||
*/
|
|
||||||
private LambdaQueryWrapper<CcdiIntermediaryBlacklist> buildQueryWrapper(CcdiIntermediaryBlacklistQueryDTO queryDTO) {
|
|
||||||
LambdaQueryWrapper<CcdiIntermediaryBlacklist> wrapper = new LambdaQueryWrapper<>();
|
|
||||||
wrapper.like(StringUtils.isNotEmpty(queryDTO.getName()), CcdiIntermediaryBlacklist::getName, queryDTO.getName())
|
|
||||||
.like(StringUtils.isNotEmpty(queryDTO.getCertificateNo()), CcdiIntermediaryBlacklist::getCertificateNo, queryDTO.getCertificateNo())
|
|
||||||
.eq(StringUtils.isNotEmpty(queryDTO.getIntermediaryType()), CcdiIntermediaryBlacklist::getIntermediaryType, queryDTO.getIntermediaryType())
|
|
||||||
.eq(StringUtils.isNotEmpty(queryDTO.getStatus()), CcdiIntermediaryBlacklist::getStatus, queryDTO.getStatus())
|
|
||||||
.orderByDesc(CcdiIntermediaryBlacklist::getCreateTime);
|
|
||||||
return wrapper;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 验证中介数据
|
|
||||||
*/
|
|
||||||
private void validateIntermediaryData(CcdiIntermediaryBlacklistAddDTO addDTO) {
|
|
||||||
// 验证必填字段
|
|
||||||
if (StringUtils.isEmpty(addDTO.getName())) {
|
|
||||||
throw new RuntimeException("姓名/机构名称不能为空");
|
|
||||||
}
|
|
||||||
if (StringUtils.isEmpty(addDTO.getIntermediaryType())) {
|
|
||||||
throw new RuntimeException("中介类型不能为空");
|
|
||||||
}
|
|
||||||
|
|
||||||
// 验证中介类型
|
|
||||||
if (!"1".equals(addDTO.getIntermediaryType()) && !"2".equals(addDTO.getIntermediaryType())) {
|
|
||||||
throw new RuntimeException("中介类型只能填写'个人'或'机构'");
|
|
||||||
}
|
|
||||||
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 转换为VO对象
|
|
||||||
*/
|
|
||||||
private CcdiIntermediaryBlacklistVO convertToVO(CcdiIntermediaryBlacklist intermediary) {
|
|
||||||
if (intermediary == null) {
|
|
||||||
return null;
|
|
||||||
}
|
|
||||||
|
|
||||||
CcdiIntermediaryBlacklistVO vo = new CcdiIntermediaryBlacklistVO();
|
|
||||||
BeanUtils.copyProperties(intermediary, vo);
|
|
||||||
|
|
||||||
vo.setIntermediaryTypeName(IntermediaryType.getDescByCode(intermediary.getIntermediaryType()));
|
|
||||||
vo.setStatusName(IntermediaryStatus.getDescByCode(intermediary.getStatus()));
|
|
||||||
|
|
||||||
return vo;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -0,0 +1,492 @@
|
|||||||
|
package com.ruoyi.ccdi.service.impl;
|
||||||
|
|
||||||
|
import com.baomidou.mybatisplus.core.conditions.query.LambdaQueryWrapper;
|
||||||
|
import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
|
||||||
|
import com.ruoyi.ccdi.domain.CcdiBizIntermediary;
|
||||||
|
import com.ruoyi.ccdi.domain.CcdiEnterpriseBaseInfo;
|
||||||
|
import com.ruoyi.ccdi.domain.dto.CcdiIntermediaryEntityAddDTO;
|
||||||
|
import com.ruoyi.ccdi.domain.dto.CcdiIntermediaryEntityEditDTO;
|
||||||
|
import com.ruoyi.ccdi.domain.dto.CcdiIntermediaryPersonAddDTO;
|
||||||
|
import com.ruoyi.ccdi.domain.dto.CcdiIntermediaryPersonEditDTO;
|
||||||
|
import com.ruoyi.ccdi.domain.dto.CcdiIntermediaryQueryDTO;
|
||||||
|
import com.ruoyi.ccdi.domain.excel.CcdiIntermediaryEntityExcel;
|
||||||
|
import com.ruoyi.ccdi.domain.excel.CcdiIntermediaryPersonExcel;
|
||||||
|
import com.ruoyi.ccdi.domain.vo.CcdiIntermediaryEntityDetailVO;
|
||||||
|
import com.ruoyi.ccdi.domain.vo.CcdiIntermediaryPersonDetailVO;
|
||||||
|
import com.ruoyi.ccdi.domain.vo.CcdiIntermediaryVO;
|
||||||
|
import com.ruoyi.ccdi.mapper.CcdiBizIntermediaryMapper;
|
||||||
|
import com.ruoyi.ccdi.mapper.CcdiEnterpriseBaseInfoMapper;
|
||||||
|
import com.ruoyi.ccdi.service.ICcdiIntermediaryService;
|
||||||
|
import com.ruoyi.common.utils.StringUtils;
|
||||||
|
import jakarta.annotation.Resource;
|
||||||
|
import org.springframework.beans.BeanUtils;
|
||||||
|
import org.springframework.stereotype.Service;
|
||||||
|
import org.springframework.transaction.annotation.Transactional;
|
||||||
|
|
||||||
|
import java.util.ArrayList;
|
||||||
|
import java.util.List;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 中介Service业务层处理
|
||||||
|
*
|
||||||
|
* @author ruoyi
|
||||||
|
* @date 2026-02-04
|
||||||
|
*/
|
||||||
|
@Service
|
||||||
|
public class CcdiIntermediaryServiceImpl implements ICcdiIntermediaryService {
|
||||||
|
|
||||||
|
@Resource
|
||||||
|
private CcdiBizIntermediaryMapper bizIntermediaryMapper;
|
||||||
|
|
||||||
|
@Resource
|
||||||
|
private CcdiEnterpriseBaseInfoMapper enterpriseBaseInfoMapper;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 分页查询中介列表
|
||||||
|
*
|
||||||
|
* @param page 分页对象
|
||||||
|
* @param queryDTO 查询条件
|
||||||
|
* @return 中介VO分页结果
|
||||||
|
*/
|
||||||
|
@Override
|
||||||
|
public Page<CcdiIntermediaryVO> selectIntermediaryPage(Page<CcdiIntermediaryVO> page, CcdiIntermediaryQueryDTO queryDTO) {
|
||||||
|
Page<CcdiIntermediaryVO> voPage = new Page<>(page.getCurrent(), page.getSize());
|
||||||
|
List<CcdiIntermediaryVO> list = new ArrayList<>();
|
||||||
|
|
||||||
|
// 查询个人中介
|
||||||
|
LambdaQueryWrapper<CcdiBizIntermediary> personWrapper = new LambdaQueryWrapper<>();
|
||||||
|
personWrapper.eq(CcdiBizIntermediary::getPersonType, "中介")
|
||||||
|
.like(StringUtils.isNotEmpty(queryDTO.getName()), CcdiBizIntermediary::getName, queryDTO.getName())
|
||||||
|
.like(StringUtils.isNotEmpty(queryDTO.getCertificateNo()), CcdiBizIntermediary::getPersonId, queryDTO.getCertificateNo());
|
||||||
|
|
||||||
|
List<CcdiBizIntermediary> personList = bizIntermediaryMapper.selectList(personWrapper);
|
||||||
|
for (CcdiBizIntermediary person : personList) {
|
||||||
|
CcdiIntermediaryVO vo = new CcdiIntermediaryVO();
|
||||||
|
vo.setId(person.getBizId());
|
||||||
|
vo.setName(person.getName());
|
||||||
|
vo.setCertificateNo(person.getPersonId());
|
||||||
|
vo.setIntermediaryType("1");
|
||||||
|
vo.setPersonType(person.getPersonType());
|
||||||
|
vo.setCompany(person.getCompany());
|
||||||
|
vo.setDataSource(person.getDataSource());
|
||||||
|
vo.setCreateTime(person.getCreateTime());
|
||||||
|
list.add(vo);
|
||||||
|
}
|
||||||
|
|
||||||
|
// 查询实体中介
|
||||||
|
LambdaQueryWrapper<CcdiEnterpriseBaseInfo> entityWrapper = new LambdaQueryWrapper<>();
|
||||||
|
entityWrapper.eq(CcdiEnterpriseBaseInfo::getRiskLevel, "1")
|
||||||
|
.eq(CcdiEnterpriseBaseInfo::getEntSource, "INTERMEDIARY")
|
||||||
|
.like(StringUtils.isNotEmpty(queryDTO.getName()), CcdiEnterpriseBaseInfo::getEnterpriseName, queryDTO.getName())
|
||||||
|
.like(StringUtils.isNotEmpty(queryDTO.getCertificateNo()), CcdiEnterpriseBaseInfo::getSocialCreditCode, queryDTO.getCertificateNo());
|
||||||
|
|
||||||
|
List<CcdiEnterpriseBaseInfo> entityList = enterpriseBaseInfoMapper.selectList(entityWrapper);
|
||||||
|
for (CcdiEnterpriseBaseInfo entity : entityList) {
|
||||||
|
CcdiIntermediaryVO vo = new CcdiIntermediaryVO();
|
||||||
|
vo.setId(entity.getSocialCreditCode());
|
||||||
|
vo.setName(entity.getEnterpriseName());
|
||||||
|
vo.setCertificateNo(entity.getSocialCreditCode());
|
||||||
|
vo.setIntermediaryType("2");
|
||||||
|
vo.setDataSource(entity.getDataSource());
|
||||||
|
vo.setCreateTime(entity.getCreateTime());
|
||||||
|
list.add(vo);
|
||||||
|
}
|
||||||
|
|
||||||
|
// 手动分页
|
||||||
|
int start = (int) ((voPage.getCurrent() - 1) * voPage.getSize());
|
||||||
|
int end = (int) Math.min(start + voPage.getSize(), list.size());
|
||||||
|
|
||||||
|
List<CcdiIntermediaryVO> pageList = new ArrayList<>();
|
||||||
|
if (start < list.size()) {
|
||||||
|
pageList = list.subList(start, end);
|
||||||
|
}
|
||||||
|
|
||||||
|
voPage.setRecords(pageList);
|
||||||
|
voPage.setTotal(list.size());
|
||||||
|
|
||||||
|
return voPage;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 查询个人中介详情
|
||||||
|
*
|
||||||
|
* @param bizId 人员ID
|
||||||
|
* @return 个人中介详情VO
|
||||||
|
*/
|
||||||
|
@Override
|
||||||
|
public CcdiIntermediaryPersonDetailVO selectIntermediaryPersonDetail(String bizId) {
|
||||||
|
CcdiBizIntermediary person = bizIntermediaryMapper.selectById(bizId);
|
||||||
|
if (person == null) {
|
||||||
|
return null;
|
||||||
|
}
|
||||||
|
|
||||||
|
CcdiIntermediaryPersonDetailVO vo = new CcdiIntermediaryPersonDetailVO();
|
||||||
|
BeanUtils.copyProperties(person, vo);
|
||||||
|
return vo;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 查询实体中介详情
|
||||||
|
*
|
||||||
|
* @param socialCreditCode 统一社会信用代码
|
||||||
|
* @return 实体中介详情VO
|
||||||
|
*/
|
||||||
|
@Override
|
||||||
|
public CcdiIntermediaryEntityDetailVO selectIntermediaryEntityDetail(String socialCreditCode) {
|
||||||
|
CcdiEnterpriseBaseInfo entity = enterpriseBaseInfoMapper.selectById(socialCreditCode);
|
||||||
|
if (entity == null) {
|
||||||
|
return null;
|
||||||
|
}
|
||||||
|
|
||||||
|
CcdiIntermediaryEntityDetailVO vo = new CcdiIntermediaryEntityDetailVO();
|
||||||
|
BeanUtils.copyProperties(entity, vo);
|
||||||
|
return vo;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 新增个人中介
|
||||||
|
*
|
||||||
|
* @param addDTO 新增DTO
|
||||||
|
* @return 结果
|
||||||
|
*/
|
||||||
|
@Override
|
||||||
|
@Transactional
|
||||||
|
public int insertIntermediaryPerson(CcdiIntermediaryPersonAddDTO addDTO) {
|
||||||
|
// 检查人员ID唯一性
|
||||||
|
if (!checkPersonIdUnique(addDTO.getPersonId(), null)) {
|
||||||
|
throw new RuntimeException("该证件号已存在");
|
||||||
|
}
|
||||||
|
|
||||||
|
CcdiBizIntermediary person = new CcdiBizIntermediary();
|
||||||
|
BeanUtils.copyProperties(addDTO, person);
|
||||||
|
person.setPersonType("中介");
|
||||||
|
person.setDataSource("MANUAL");
|
||||||
|
|
||||||
|
return bizIntermediaryMapper.insert(person);
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 修改个人中介
|
||||||
|
*
|
||||||
|
* @param editDTO 编辑DTO
|
||||||
|
* @return 结果
|
||||||
|
*/
|
||||||
|
@Override
|
||||||
|
@Transactional
|
||||||
|
public int updateIntermediaryPerson(CcdiIntermediaryPersonEditDTO editDTO) {
|
||||||
|
// 检查人员ID唯一性（排除自己）
|
||||||
|
if (StringUtils.isNotEmpty(editDTO.getPersonId())) {
|
||||||
|
if (!checkPersonIdUnique(editDTO.getPersonId(), editDTO.getBizId())) {
|
||||||
|
throw new RuntimeException("该证件号已存在");
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
CcdiBizIntermediary person = new CcdiBizIntermediary();
|
||||||
|
BeanUtils.copyProperties(editDTO, person);
|
||||||
|
|
||||||
|
return bizIntermediaryMapper.updateById(person);
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 新增实体中介
|
||||||
|
*
|
||||||
|
* @param addDTO 新增DTO
|
||||||
|
* @return 结果
|
||||||
|
*/
|
||||||
|
@Override
|
||||||
|
@Transactional
|
||||||
|
public int insertIntermediaryEntity(CcdiIntermediaryEntityAddDTO addDTO) {
|
||||||
|
// 检查统一社会信用代码唯一性
|
||||||
|
if (StringUtils.isNotEmpty(addDTO.getSocialCreditCode())) {
|
||||||
|
if (!checkSocialCreditCodeUnique(addDTO.getSocialCreditCode(), null)) {
|
||||||
|
throw new RuntimeException("该统一社会信用代码已存在");
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
CcdiEnterpriseBaseInfo entity = new CcdiEnterpriseBaseInfo();
|
||||||
|
BeanUtils.copyProperties(addDTO, entity);
|
||||||
|
entity.setRiskLevel("1");
|
||||||
|
entity.setEntSource("INTERMEDIARY");
|
||||||
|
entity.setDataSource("MANUAL");
|
||||||
|
|
||||||
|
return enterpriseBaseInfoMapper.insert(entity);
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 修改实体中介
|
||||||
|
*
|
||||||
|
* @param editDTO 编辑DTO
|
||||||
|
* @return 结果
|
||||||
|
*/
|
||||||
|
@Override
|
||||||
|
@Transactional
|
||||||
|
public int updateIntermediaryEntity(CcdiIntermediaryEntityEditDTO editDTO) {
|
||||||
|
CcdiEnterpriseBaseInfo entity = new CcdiEnterpriseBaseInfo();
|
||||||
|
BeanUtils.copyProperties(editDTO, entity);
|
||||||
|
|
||||||
|
return enterpriseBaseInfoMapper.updateById(entity);
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 批量删除中介
|
||||||
|
*
|
||||||
|
* @param ids 需要删除的ID数组
|
||||||
|
* @return 结果
|
||||||
|
*/
|
||||||
|
@Override
|
||||||
|
@Transactional
|
||||||
|
public int deleteIntermediaryByIds(String[] ids) {
|
||||||
|
int count = 0;
|
||||||
|
for (String id : ids) {
|
||||||
|
// 判断是个人还是实体（个人ID长度较长，实体统一社会信用代码18位）
|
||||||
|
if (id.length() > 18) {
|
||||||
|
// 个人中介
|
||||||
|
count += bizIntermediaryMapper.deleteById(id);
|
||||||
|
} else {
|
||||||
|
// 实体中介
|
||||||
|
count += enterpriseBaseInfoMapper.deleteById(id);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
return count;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 校验人员ID唯一性
|
||||||
|
*
|
||||||
|
* @param personId 人员ID
|
||||||
|
* @param bizId 排除的人员ID
|
||||||
|
* @return true=唯一, false=不唯一
|
||||||
|
*/
|
||||||
|
@Override
|
||||||
|
public boolean checkPersonIdUnique(String personId, String bizId) {
|
||||||
|
LambdaQueryWrapper<CcdiBizIntermediary> wrapper = new LambdaQueryWrapper<>();
|
||||||
|
wrapper.eq(CcdiBizIntermediary::getPersonId, personId);
|
||||||
|
if (StringUtils.isNotEmpty(bizId)) {
|
||||||
|
wrapper.ne(CcdiBizIntermediary::getBizId, bizId);
|
||||||
|
}
|
||||||
|
return bizIntermediaryMapper.selectCount(wrapper) == 0;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 校验统一社会信用代码唯一性
|
||||||
|
*
|
||||||
|
* @param socialCreditCode 统一社会信用代码
|
||||||
|
* @param excludeId 排除的ID
|
||||||
|
* @return true=唯一, false=不唯一
|
||||||
|
*/
|
||||||
|
@Override
|
||||||
|
public boolean checkSocialCreditCodeUnique(String socialCreditCode, String excludeId) {
|
||||||
|
LambdaQueryWrapper<CcdiEnterpriseBaseInfo> wrapper = new LambdaQueryWrapper<>();
|
||||||
|
wrapper.eq(CcdiEnterpriseBaseInfo::getSocialCreditCode, socialCreditCode);
|
||||||
|
if (StringUtils.isNotEmpty(excludeId)) {
|
||||||
|
wrapper.ne(CcdiEnterpriseBaseInfo::getSocialCreditCode, excludeId);
|
||||||
|
}
|
||||||
|
return enterpriseBaseInfoMapper.selectCount(wrapper) == 0;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 导入个人中介数据（批量操作）
|
||||||
|
*
|
||||||
|
* @param list Excel实体列表
|
||||||
|
* @param updateSupport 是否更新支持
|
||||||
|
* @return 结果
|
||||||
|
*/
|
||||||
|
@Override
|
||||||
|
@Transactional
|
||||||
|
public String importIntermediaryPerson(List<CcdiIntermediaryPersonExcel> list, boolean updateSupport) {
|
||||||
|
if (StringUtils.isNull(list) || list.isEmpty()) {
|
||||||
|
return "至少需要一条数据";
|
||||||
|
}
|
||||||
|
|
||||||
|
int successNum = 0;
|
||||||
|
int failureNum = 0;
|
||||||
|
StringBuilder successMsg = new StringBuilder();
|
||||||
|
StringBuilder failureMsg = new StringBuilder();
|
||||||
|
|
||||||
|
// 待插入和更新的列表
|
||||||
|
List<CcdiBizIntermediary> insertList = new ArrayList<>();
|
||||||
|
List<CcdiBizIntermediary> updateList = new ArrayList<>();
|
||||||
|
List<String> personIds = new ArrayList<>();
|
||||||
|
|
||||||
|
// 第一轮：数据验证和分类
|
||||||
|
for (int i = 0; i < list.size(); i++) {
|
||||||
|
try {
|
||||||
|
CcdiIntermediaryPersonExcel excel = list.get(i);
|
||||||
|
|
||||||
|
// 验证数据
|
||||||
|
if (StringUtils.isEmpty(excel.getName())) {
|
||||||
|
throw new RuntimeException("姓名不能为空");
|
||||||
|
}
|
||||||
|
if (StringUtils.isEmpty(excel.getPersonId())) {
|
||||||
|
throw new RuntimeException("证件号码不能为空");
|
||||||
|
}
|
||||||
|
|
||||||
|
// 转换为实体
|
||||||
|
CcdiBizIntermediary person = new CcdiBizIntermediary();
|
||||||
|
BeanUtils.copyProperties(excel, person);
|
||||||
|
person.setPersonType("中介");
|
||||||
|
person.setDataSource("IMPORT");
|
||||||
|
|
||||||
|
personIds.add(excel.getPersonId());
|
||||||
|
|
||||||
|
// 检查唯一性
|
||||||
|
if (!checkPersonIdUnique(excel.getPersonId(), null)) {
|
||||||
|
if (updateSupport) {
|
||||||
|
// 需要更新，暂时加入更新列表
|
||||||
|
updateList.add(person);
|
||||||
|
} else {
|
||||||
|
throw new RuntimeException("该证件号已存在");
|
||||||
|
}
|
||||||
|
} else {
|
||||||
|
// 新数据，加入插入列表
|
||||||
|
insertList.add(person);
|
||||||
|
}
|
||||||
|
|
||||||
|
successNum++;
|
||||||
|
successMsg.append("<br/>").append(successNum).append("、").append(excel.getName()).append(" 导入成功");
|
||||||
|
} catch (Exception e) {
|
||||||
|
failureNum++;
|
||||||
|
failureMsg.append("<br/>").append(failureNum).append("、").append(list.get(i).getName()).append(" 导入失败：");
|
||||||
|
failureMsg.append(e.getMessage());
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
if (failureNum > 0) {
|
||||||
|
failureMsg.insert(0, "很抱歉，导入失败！共 " + failureNum + " 条数据格式不正确，错误如下：");
|
||||||
|
throw new RuntimeException(failureMsg.toString());
|
||||||
|
}
|
||||||
|
|
||||||
|
// 第二轮：批量处理
|
||||||
|
try {
|
||||||
|
// 批量插入新记录
|
||||||
|
if (!insertList.isEmpty()) {
|
||||||
|
bizIntermediaryMapper.insertBatch(insertList);
|
||||||
|
}
|
||||||
|
|
||||||
|
// 批量更新已存在的记录
|
||||||
|
if (!updateList.isEmpty()) {
|
||||||
|
// 查询已存在记录的bizId
|
||||||
|
LambdaQueryWrapper<CcdiBizIntermediary> wrapper = new LambdaQueryWrapper<>();
|
||||||
|
wrapper.in(CcdiBizIntermediary::getPersonId, personIds);
|
||||||
|
List<CcdiBizIntermediary> existingList = bizIntermediaryMapper.selectList(wrapper);
|
||||||
|
|
||||||
|
// 建立personId到bizId的映射
|
||||||
|
java.util.Map<String, String> personIdToBizIdMap = new java.util.HashMap<>();
|
||||||
|
for (CcdiBizIntermediary existing : existingList) {
|
||||||
|
personIdToBizIdMap.put(existing.getPersonId(), existing.getBizId());
|
||||||
|
}
|
||||||
|
|
||||||
|
// 设置bizId到更新列表
|
||||||
|
for (CcdiBizIntermediary person : updateList) {
|
||||||
|
String bizId = personIdToBizIdMap.get(person.getPersonId());
|
||||||
|
if (bizId != null) {
|
||||||
|
person.setBizId(bizId);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// 批量更新
|
||||||
|
bizIntermediaryMapper.updateBatch(updateList);
|
||||||
|
}
|
||||||
|
|
||||||
|
successMsg.insert(0, "恭喜您，数据已全部导入成功！共 " + successNum + " 条");
|
||||||
|
return successMsg.toString();
|
||||||
|
} catch (Exception e) {
|
||||||
|
throw new RuntimeException("批量操作失败：" + e.getMessage());
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 导入实体中介数据（批量操作）
|
||||||
|
*
|
||||||
|
* @param list Excel实体列表
|
||||||
|
* @param updateSupport 是否更新支持
|
||||||
|
* @return 结果
|
||||||
|
*/
|
||||||
|
@Override
|
||||||
|
@Transactional
|
||||||
|
public String importIntermediaryEntity(List<CcdiIntermediaryEntityExcel> list, boolean updateSupport) {
|
||||||
|
if (StringUtils.isNull(list) || list.isEmpty()) {
|
||||||
|
return "至少需要一条数据";
|
||||||
|
}
|
||||||
|
|
||||||
|
int successNum = 0;
|
||||||
|
int failureNum = 0;
|
||||||
|
StringBuilder successMsg = new StringBuilder();
|
||||||
|
StringBuilder failureMsg = new StringBuilder();
|
||||||
|
|
||||||
|
// 待插入和更新的列表
|
||||||
|
List<CcdiEnterpriseBaseInfo> insertList = new ArrayList<>();
|
||||||
|
List<CcdiEnterpriseBaseInfo> updateList = new ArrayList<>();
|
||||||
|
List<String> socialCreditCodes = new ArrayList<>();
|
||||||
|
|
||||||
|
// 第一轮：数据验证和分类
|
||||||
|
for (int i = 0; i < list.size(); i++) {
|
||||||
|
try {
|
||||||
|
CcdiIntermediaryEntityExcel excel = list.get(i);
|
||||||
|
|
||||||
|
// 验证数据
|
||||||
|
if (StringUtils.isEmpty(excel.getEnterpriseName())) {
|
||||||
|
throw new RuntimeException("机构名称不能为空");
|
||||||
|
}
|
||||||
|
|
||||||
|
// 转换为实体
|
||||||
|
CcdiEnterpriseBaseInfo entity = new CcdiEnterpriseBaseInfo();
|
||||||
|
BeanUtils.copyProperties(excel, entity);
|
||||||
|
entity.setRiskLevel("1");
|
||||||
|
entity.setEntSource("INTERMEDIARY");
|
||||||
|
entity.setDataSource("IMPORT");
|
||||||
|
|
||||||
|
// 检查唯一性
|
||||||
|
if (StringUtils.isNotEmpty(excel.getSocialCreditCode())) {
|
||||||
|
socialCreditCodes.add(excel.getSocialCreditCode());
|
||||||
|
|
||||||
|
if (!checkSocialCreditCodeUnique(excel.getSocialCreditCode(), null)) {
|
||||||
|
if (updateSupport) {
|
||||||
|
// 需要更新，加入更新列表
|
||||||
|
updateList.add(entity);
|
||||||
|
} else {
|
||||||
|
throw new RuntimeException("该统一社会信用代码已存在");
|
||||||
|
}
|
||||||
|
} else {
|
||||||
|
// 新数据，加入插入列表
|
||||||
|
insertList.add(entity);
|
||||||
|
}
|
||||||
|
} else {
|
||||||
|
// 没有统一社会信用代码，直接加入插入列表
|
||||||
|
insertList.add(entity);
|
||||||
|
}
|
||||||
|
|
||||||
|
successNum++;
|
||||||
|
successMsg.append("<br/>").append(successNum).append("、").append(excel.getEnterpriseName()).append(" 导入成功");
|
||||||
|
} catch (Exception e) {
|
||||||
|
failureNum++;
|
||||||
|
failureMsg.append("<br/>").append(failureNum).append("、").append(list.get(i).getEnterpriseName()).append(" 导入失败：");
|
||||||
|
failureMsg.append(e.getMessage());
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
if (failureNum > 0) {
|
||||||
|
failureMsg.insert(0, "很抱歉，导入失败！共 " + failureNum + " 条数据格式不正确，错误如下：");
|
||||||
|
throw new RuntimeException(failureMsg.toString());
|
||||||
|
}
|
||||||
|
|
||||||
|
// 第二轮：批量处理
|
||||||
|
try {
|
||||||
|
// 批量插入新记录
|
||||||
|
if (!insertList.isEmpty()) {
|
||||||
|
enterpriseBaseInfoMapper.insertBatch(insertList);
|
||||||
|
}
|
||||||
|
|
||||||
|
// 批量更新已存在的记录
|
||||||
|
if (!updateList.isEmpty()) {
|
||||||
|
// 批量更新（socialCreditCode已在实体中）
|
||||||
|
enterpriseBaseInfoMapper.updateBatch(updateList);
|
||||||
|
}
|
||||||
|
|
||||||
|
successMsg.insert(0, "恭喜您，数据已全部导入成功！共 " + successNum + " 条");
|
||||||
|
return successMsg.toString();
|
||||||
|
} catch (Exception e) {
|
||||||
|
throw new RuntimeException("批量操作失败：" + e.getMessage());
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -1,65 +0,0 @@
|
|||||||
package com.ruoyi.ccdi.utils.converter;
|
|
||||||
|
|
||||||
import com.alibaba.excel.converters.Converter;
|
|
||||||
import com.alibaba.excel.enums.CellDataTypeEnum;
|
|
||||||
import com.alibaba.excel.metadata.GlobalConfiguration;
|
|
||||||
import com.alibaba.excel.metadata.data.ReadCellData;
|
|
||||||
import com.alibaba.excel.metadata.data.WriteCellData;
|
|
||||||
import com.alibaba.excel.metadata.property.ExcelContentProperty;
|
|
||||||
|
|
||||||
import java.util.HashMap;
|
|
||||||
import java.util.Map;
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 员工状态转换器
|
|
||||||
* 0=在职, 1=离职
|
|
||||||
*
|
|
||||||
* @author ruoyi
|
|
||||||
*/
|
|
||||||
public class EmployeeStatusConverter implements Converter<String> {
|
|
||||||
|
|
||||||
private static final Map<String, String> CODE_TO_DESC = new HashMap<>();
|
|
||||||
private static final Map<String, String> DESC_TO_CODE = new HashMap<>();
|
|
||||||
|
|
||||||
static {
|
|
||||||
CODE_TO_DESC.put("0", "在职");
|
|
||||||
CODE_TO_DESC.put("1", "离职");
|
|
||||||
DESC_TO_CODE.put("在职", "0");
|
|
||||||
DESC_TO_CODE.put("离职", "1");
|
|
||||||
}
|
|
||||||
|
|
||||||
@Override
|
|
||||||
public Class<?> supportJavaTypeKey() {
|
|
||||||
return String.class;
|
|
||||||
}
|
|
||||||
|
|
||||||
@Override
|
|
||||||
public CellDataTypeEnum supportExcelTypeKey() {
|
|
||||||
return CellDataTypeEnum.STRING;
|
|
||||||
}
|
|
||||||
|
|
||||||
@Override
|
|
||||||
public String convertToJavaData(ReadCellData<?> cellData, ExcelContentProperty contentProperty,
|
|
||||||
GlobalConfiguration globalConfiguration) {
|
|
||||||
String value = cellData.getStringValue();
|
|
||||||
if (value == null) {
|
|
||||||
return null;
|
|
||||||
}
|
|
||||||
// 支持中文和代码两种格式
|
|
||||||
if (DESC_TO_CODE.containsKey(value)) {
|
|
||||||
return DESC_TO_CODE.get(value);
|
|
||||||
}
|
|
||||||
// 如果是纯数字，直接返回
|
|
||||||
if (value.matches("\\d")) {
|
|
||||||
return value;
|
|
||||||
}
|
|
||||||
throw new IllegalArgumentException("无效的员工状态: " + value + ", 请使用: 在职/离职 或 0/1");
|
|
||||||
}
|
|
||||||
|
|
||||||
@Override
|
|
||||||
public WriteCellData<?> convertToExcelData(String value, ExcelContentProperty contentProperty,
|
|
||||||
GlobalConfiguration globalConfiguration) {
|
|
||||||
String desc = CODE_TO_DESC.getOrDefault(value, value);
|
|
||||||
return new WriteCellData<>(desc);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -1,47 +0,0 @@
|
|||||||
package com.ruoyi.ccdi.utils.handler;
|
|
||||||
|
|
||||||
import com.alibaba.excel.write.handler.SheetWriteHandler;
|
|
||||||
import com.alibaba.excel.write.metadata.holder.WriteSheetHolder;
|
|
||||||
import com.alibaba.excel.write.metadata.holder.WriteWorkbookHolder;
|
|
||||||
import org.apache.poi.ss.usermodel.DataValidation;
|
|
||||||
import org.apache.poi.ss.usermodel.DataValidationHelper;
|
|
||||||
import org.apache.poi.ss.usermodel.Sheet;
|
|
||||||
import org.apache.poi.ss.usermodel.Workbook;
|
|
||||||
import org.apache.poi.ss.util.CellRangeAddressList;
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 员工状态下拉框处理器
|
|
||||||
*
|
|
||||||
* @author ruoyi
|
|
||||||
*/
|
|
||||||
public class EmployeeStatusSheetWriteHandler implements SheetWriteHandler {
|
|
||||||
|
|
||||||
@Override
|
|
||||||
public void afterSheetCreate(WriteWorkbookHolder writeWorkbookHolder, WriteSheetHolder writeSheetHolder) {
|
|
||||||
Sheet sheet = writeSheetHolder.getSheet();
|
|
||||||
Workbook workbook = writeWorkbookHolder.getWorkbook();
|
|
||||||
DataValidationHelper helper = sheet.getDataValidationHelper();
|
|
||||||
|
|
||||||
// 创建下拉框数据列表
|
|
||||||
String[] statusList = {"在职", "离职"};
|
|
||||||
|
|
||||||
// 设置状态下拉框，从第2行开始（第1行是表头），第7列（状态列，索引为6）
|
|
||||||
CellRangeAddressList addressList = new CellRangeAddressList(1, 10000, 6, 6);
|
|
||||||
|
|
||||||
// 创建显式列表约束
|
|
||||||
DataValidation validation = helper.createValidation(
|
|
||||||
helper.createExplicitListConstraint(statusList),
|
|
||||||
addressList
|
|
||||||
);
|
|
||||||
|
|
||||||
// 设置提示信息
|
|
||||||
validation.createPromptBox("状态选择", "请选择员工状态：在职或离职");
|
|
||||||
validation.setShowPromptBox(true);
|
|
||||||
|
|
||||||
// 设置错误提示
|
|
||||||
validation.createErrorBox("状态错误", "请从下拉框中选择有效的状态值！");
|
|
||||||
validation.setShowErrorBox(true);
|
|
||||||
|
|
||||||
sheet.addValidationData(validation);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -0,0 +1,55 @@
|
|||||||
|
<?xml version="1.0" encoding="UTF-8" ?>
|
||||||
|
<!DOCTYPE mapper
|
||||||
|
PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
|
||||||
|
"http://mybatis.org/dtd/mybatis-3-mapper.dtd">
|
||||||
|
<mapper namespace="com.ruoyi.ccdi.mapper.CcdiBizIntermediaryMapper">
|
||||||
|
|
||||||
|
<!-- 批量插入个人中介 -->
|
||||||
|
<insert id="insertBatch" parameterType="java.util.List">
|
||||||
|
INSERT INTO ccdi_biz_intermediary (
|
||||||
|
biz_id, person_type, person_sub_type, relation_type,
|
||||||
|
name, gender, id_type, person_id, mobile, wechat_no,
|
||||||
|
contact_address, company, social_credit_code, position,
|
||||||
|
related_num_id, data_source, remark,
|
||||||
|
created_by, updated_by, create_time, update_time
|
||||||
|
) VALUES
|
||||||
|
<foreach collection="list" item="item" separator=",">
|
||||||
|
(
|
||||||
|
#{item.bizId}, #{item.personType}, #{item.personSubType}, #{item.relationType},
|
||||||
|
#{item.name}, #{item.gender}, #{item.idType}, #{item.personId}, #{item.mobile}, #{item.wechatNo},
|
||||||
|
#{item.contactAddress}, #{item.company}, #{item.socialCreditCode}, #{item.position},
|
||||||
|
#{item.relatedNumId}, #{item.dataSource}, #{item.remark},
|
||||||
|
#{item.createdBy}, #{item.updatedBy}, #{item.createTime}, #{item.updateTime}
|
||||||
|
)
|
||||||
|
</foreach>
|
||||||
|
</insert>
|
||||||
|
|
||||||
|
<!-- 批量更新个人中介 -->
|
||||||
|
<update id="updateBatch" parameterType="java.util.List">
|
||||||
|
<foreach collection="list" item="item" separator=";">
|
||||||
|
UPDATE ccdi_biz_intermediary
|
||||||
|
<set>
|
||||||
|
<if test="item.personType != null">person_type = #{item.personType},</if>
|
||||||
|
<if test="item.personSubType != null">person_sub_type = #{item.personSubType},</if>
|
||||||
|
<if test="item.relationType != null">relation_type = #{item.relationType},</if>
|
||||||
|
<if test="item.name != null and item.name != ''">name = #{item.name},</if>
|
||||||
|
<if test="item.gender != null">gender = #{item.gender},</if>
|
||||||
|
<if test="item.idType != null">id_type = #{item.idType},</if>
|
||||||
|
<if test="item.personId != null and item.personId != ''">person_id = #{item.personId},</if>
|
||||||
|
<if test="item.mobile != null">mobile = #{item.mobile},</if>
|
||||||
|
<if test="item.wechatNo != null">wechat_no = #{item.wechatNo},</if>
|
||||||
|
<if test="item.contactAddress != null">contact_address = #{item.contactAddress},</if>
|
||||||
|
<if test="item.company != null">company = #{item.company},</if>
|
||||||
|
<if test="item.socialCreditCode != null">social_credit_code = #{item.socialCreditCode},</if>
|
||||||
|
<if test="item.position != null">position = #{item.position},</if>
|
||||||
|
<if test="item.relatedNumId != null">related_num_id = #{item.relatedNumId},</if>
|
||||||
|
<if test="item.dataSource != null">data_source = #{item.dataSource},</if>
|
||||||
|
<if test="item.remark != null">remark = #{item.remark},</if>
|
||||||
|
<if test="item.updatedBy != null">updated_by = #{item.updatedBy},</if>
|
||||||
|
update_time = #{item.updateTime}
|
||||||
|
</set>
|
||||||
|
WHERE biz_id = #{item.bizId}
|
||||||
|
</foreach>
|
||||||
|
</update>
|
||||||
|
|
||||||
|
</mapper>
|
||||||
@@ -0,0 +1,60 @@
|
|||||||
|
<?xml version="1.0" encoding="UTF-8" ?>
|
||||||
|
<!DOCTYPE mapper
|
||||||
|
PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
|
||||||
|
"http://mybatis.org/dtd/mybatis-3-mapper.dtd">
|
||||||
|
<mapper namespace="com.ruoyi.ccdi.mapper.CcdiEnterpriseBaseInfoMapper">
|
||||||
|
|
||||||
|
<!-- 批量插入实体中介 -->
|
||||||
|
<insert id="insertBatch" parameterType="java.util.List">
|
||||||
|
INSERT INTO ccdi_enterprise_base_info (
|
||||||
|
social_credit_code, enterprise_name, enterprise_type, enterprise_nature,
|
||||||
|
industry_class, industry_name, establish_date, register_address,
|
||||||
|
legal_representative, legal_cert_type, legal_cert_no,
|
||||||
|
shareholder1, shareholder2, shareholder3, shareholder4, shareholder5,
|
||||||
|
status, risk_level, ent_source, data_source,
|
||||||
|
created_by, updated_by, create_time, update_time
|
||||||
|
) VALUES
|
||||||
|
<foreach collection="list" item="item" separator=",">
|
||||||
|
(
|
||||||
|
#{item.socialCreditCode}, #{item.enterpriseName}, #{item.enterpriseType}, #{item.enterpriseNature},
|
||||||
|
#{item.industryClass}, #{item.industryName}, #{item.establishDate}, #{item.registerAddress},
|
||||||
|
#{item.legalRepresentative}, #{item.legalCertType}, #{item.legalCertNo},
|
||||||
|
#{item.shareholder1}, #{item.shareholder2}, #{item.shareholder3}, #{item.shareholder4}, #{item.shareholder5},
|
||||||
|
#{item.status}, #{item.riskLevel}, #{item.entSource}, #{item.dataSource},
|
||||||
|
#{item.createdBy}, #{item.updatedBy}, #{item.createTime}, #{item.updateTime}
|
||||||
|
)
|
||||||
|
</foreach>
|
||||||
|
</insert>
|
||||||
|
|
||||||
|
<!-- 批量更新实体中介 -->
|
||||||
|
<update id="updateBatch" parameterType="java.util.List">
|
||||||
|
<foreach collection="list" item="item" separator=";">
|
||||||
|
UPDATE ccdi_enterprise_base_info
|
||||||
|
<set>
|
||||||
|
<if test="item.enterpriseName != null and item.enterpriseName != ''">enterprise_name = #{item.enterpriseName},</if>
|
||||||
|
<if test="item.enterpriseType != null">enterprise_type = #{item.enterpriseType},</if>
|
||||||
|
<if test="item.enterpriseNature != null">enterprise_nature = #{item.enterpriseNature},</if>
|
||||||
|
<if test="item.industryClass != null">industry_class = #{item.industryClass},</if>
|
||||||
|
<if test="item.industryName != null">industry_name = #{item.industryName},</if>
|
||||||
|
<if test="item.establishDate != null">establish_date = #{item.establishDate},</if>
|
||||||
|
<if test="item.registerAddress != null">register_address = #{item.registerAddress},</if>
|
||||||
|
<if test="item.legalRepresentative != null">legal_representative = #{item.legalRepresentative},</if>
|
||||||
|
<if test="item.legalCertType != null">legal_cert_type = #{item.legalCertType},</if>
|
||||||
|
<if test="item.legalCertNo != null">legal_cert_no = #{item.legalCertNo},</if>
|
||||||
|
<if test="item.shareholder1 != null">shareholder1 = #{item.shareholder1},</if>
|
||||||
|
<if test="item.shareholder2 != null">shareholder2 = #{item.shareholder2},</if>
|
||||||
|
<if test="item.shareholder3 != null">shareholder3 = #{item.shareholder3},</if>
|
||||||
|
<if test="item.shareholder4 != null">shareholder4 = #{item.shareholder4},</if>
|
||||||
|
<if test="item.shareholder5 != null">shareholder5 = #{item.shareholder5},</if>
|
||||||
|
<if test="item.status != null">status = #{item.status},</if>
|
||||||
|
<if test="item.riskLevel != null">risk_level = #{item.riskLevel},</if>
|
||||||
|
<if test="item.entSource != null">ent_source = #{item.entSource},</if>
|
||||||
|
<if test="item.dataSource != null">data_source = #{item.dataSource},</if>
|
||||||
|
<if test="item.updatedBy != null">updated_by = #{item.updatedBy},</if>
|
||||||
|
update_time = #{item.updateTime}
|
||||||
|
</set>
|
||||||
|
WHERE social_credit_code = #{item.socialCreditCode}
|
||||||
|
</foreach>
|
||||||
|
</update>
|
||||||
|
|
||||||
|
</mapper>
|
||||||
@@ -1,134 +0,0 @@
|
|||||||
<?xml version="1.0" encoding="UTF-8" ?>
|
|
||||||
<!DOCTYPE mapper
|
|
||||||
PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
|
|
||||||
"http://mybatis.org/dtd/mybatis-3-mapper.dtd">
|
|
||||||
<mapper namespace="com.ruoyi.ccdi.mapper.CcdiIntermediaryBlacklistMapper">
|
|
||||||
|
|
||||||
<!-- 批量插入中介黑名单数据 -->
|
|
||||||
<insert id="batchInsert" parameterType="java.util.List">
|
|
||||||
INSERT INTO ccdi_intermediary_blacklist (
|
|
||||||
name,
|
|
||||||
certificate_no,
|
|
||||||
intermediary_type,
|
|
||||||
status,
|
|
||||||
remark,
|
|
||||||
indiv_type,
|
|
||||||
indiv_sub_type,
|
|
||||||
indiv_gender,
|
|
||||||
indiv_cert_type,
|
|
||||||
indiv_phone,
|
|
||||||
indiv_wechat,
|
|
||||||
indiv_address,
|
|
||||||
indiv_company,
|
|
||||||
indiv_position,
|
|
||||||
indiv_related_id,
|
|
||||||
indiv_relation,
|
|
||||||
corp_credit_code,
|
|
||||||
corp_type,
|
|
||||||
corp_nature,
|
|
||||||
corp_industry_category,
|
|
||||||
corp_industry,
|
|
||||||
corp_establish_date,
|
|
||||||
corp_address,
|
|
||||||
corp_legal_rep,
|
|
||||||
corp_legal_cert_type,
|
|
||||||
corp_legal_cert_no,
|
|
||||||
corp_shareholder_1,
|
|
||||||
corp_shareholder_2,
|
|
||||||
corp_shareholder_3,
|
|
||||||
corp_shareholder_4,
|
|
||||||
corp_shareholder_5,
|
|
||||||
data_source,
|
|
||||||
create_by,
|
|
||||||
create_time,
|
|
||||||
update_by,
|
|
||||||
update_time
|
|
||||||
) VALUES
|
|
||||||
<foreach collection="list" item="item" separator=",">
|
|
||||||
(
|
|
||||||
#{item.name},
|
|
||||||
#{item.certificateNo},
|
|
||||||
#{item.intermediaryType},
|
|
||||||
#{item.status},
|
|
||||||
#{item.remark},
|
|
||||||
#{item.indivType},
|
|
||||||
#{item.indivSubType},
|
|
||||||
#{item.indivGender},
|
|
||||||
#{item.indivCertType},
|
|
||||||
#{item.indivPhone},
|
|
||||||
#{item.indivWechat},
|
|
||||||
#{item.indivAddress},
|
|
||||||
#{item.indivCompany},
|
|
||||||
#{item.indivPosition},
|
|
||||||
#{item.indivRelatedId},
|
|
||||||
#{item.indivRelation},
|
|
||||||
#{item.corpCreditCode},
|
|
||||||
#{item.corpType},
|
|
||||||
#{item.corpNature},
|
|
||||||
#{item.corpIndustryCategory},
|
|
||||||
#{item.corpIndustry},
|
|
||||||
#{item.corpEstablishDate},
|
|
||||||
#{item.corpAddress},
|
|
||||||
#{item.corpLegalRep},
|
|
||||||
#{item.corpLegalCertType},
|
|
||||||
#{item.corpLegalCertNo},
|
|
||||||
#{item.corpShareholder1},
|
|
||||||
#{item.corpShareholder2},
|
|
||||||
#{item.corpShareholder3},
|
|
||||||
#{item.corpShareholder4},
|
|
||||||
#{item.corpShareholder5},
|
|
||||||
#{item.dataSource},
|
|
||||||
#{item.createBy},
|
|
||||||
#{item.createTime},
|
|
||||||
#{item.updateBy},
|
|
||||||
#{item.updateTime}
|
|
||||||
)
|
|
||||||
</foreach>
|
|
||||||
</insert>
|
|
||||||
|
|
||||||
<!-- 批量更新中介黑名单数据 -->
|
|
||||||
<update id="batchUpdate" parameterType="java.util.List">
|
|
||||||
<foreach collection="list" item="item" separator=";">
|
|
||||||
UPDATE ccdi_intermediary_blacklist
|
|
||||||
<set>
|
|
||||||
<if test="item.name != null">name = #{item.name},</if>
|
|
||||||
<if test="item.certificateNo != null">certificate_no = #{item.certificateNo},</if>
|
|
||||||
<if test="item.intermediaryType != null">intermediary_type = #{item.intermediaryType},</if>
|
|
||||||
<if test="item.status != null">status = #{item.status},</if>
|
|
||||||
<if test="item.remark != null">remark = #{item.remark},</if>
|
|
||||||
<if test="item.indivType != null">indiv_type = #{item.indivType},</if>
|
|
||||||
<if test="item.indivSubType != null">indiv_sub_type = #{item.indivSubType},</if>
|
|
||||||
<if test="item.indivGender != null">indiv_gender = #{item.indivGender},</if>
|
|
||||||
<if test="item.indivCertType != null">indiv_cert_type = #{item.indivCertType},</if>
|
|
||||||
<if test="item.indivPhone != null">indiv_phone = #{item.indivPhone},</if>
|
|
||||||
<if test="item.indivWechat != null">indiv_wechat = #{item.indivWechat},</if>
|
|
||||||
<if test="item.indivAddress != null">indiv_address = #{item.indivAddress},</if>
|
|
||||||
<if test="item.indivCompany != null">indiv_company = #{item.indivCompany},</if>
|
|
||||||
<if test="item.indivPosition != null">indiv_position = #{item.indivPosition},</if>
|
|
||||||
<if test="item.indivRelatedId != null">indiv_related_id = #{item.indivRelatedId},</if>
|
|
||||||
<if test="item.indivRelation != null">indiv_relation = #{item.indivRelation},</if>
|
|
||||||
<if test="item.corpCreditCode != null">corp_credit_code = #{item.corpCreditCode},</if>
|
|
||||||
<if test="item.corpType != null">corp_type = #{item.corpType},</if>
|
|
||||||
<if test="item.corpNature != null">corp_nature = #{item.corpNature},</if>
|
|
||||||
<if test="item.corpIndustryCategory != null">corp_industry_category = #{item.corpIndustryCategory},</if>
|
|
||||||
<if test="item.corpIndustry != null">corp_industry = #{item.corpIndustry},</if>
|
|
||||||
<if test="item.corpEstablishDate != null">corp_establish_date = #{item.corpEstablishDate},</if>
|
|
||||||
<if test="item.corpAddress != null">corp_address = #{item.corpAddress},</if>
|
|
||||||
<if test="item.corpLegalRep != null">corp_legal_rep = #{item.corpLegalRep},</if>
|
|
||||||
<if test="item.corpLegalCertType != null">corp_legal_cert_type = #{item.corpLegalCertType},</if>
|
|
||||||
<if test="item.corpLegalCertNo != null">corp_legal_cert_no = #{item.corpLegalCertNo},</if>
|
|
||||||
<if test="item.corpShareholder1 != null">corp_shareholder_1 = #{item.corpShareholder1},</if>
|
|
||||||
<if test="item.corpShareholder2 != null">corp_shareholder_2 = #{item.corpShareholder2},</if>
|
|
||||||
<if test="item.corpShareholder3 != null">corp_shareholder_3 = #{item.corpShareholder3},</if>
|
|
||||||
<if test="item.corpShareholder4 != null">corp_shareholder_4 = #{item.corpShareholder4},</if>
|
|
||||||
<if test="item.corpShareholder5 != null">corp_shareholder_5 = #{item.corpShareholder5},</if>
|
|
||||||
<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}
|
|
||||||
</set>
|
|
||||||
WHERE intermediary_id = #{item.intermediaryId}
|
|
||||||
</foreach>
|
|
||||||
</update>
|
|
||||||
|
|
||||||
</mapper>
|
|
||||||
@@ -0,0 +1,60 @@
|
|||||||
|
<?xml version="1.0" encoding="UTF-8" ?>
|
||||||
|
<!DOCTYPE mapper
|
||||||
|
PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
|
||||||
|
"http://mybatis.org/dtd/mybatis-3-mapper.dtd">
|
||||||
|
<mapper namespace="com.ruoyi.ccdi.mapper.CcdiBizIntermediaryMapper">
|
||||||
|
|
||||||
|
<!--
|
||||||
|
统一列表联合查询
|
||||||
|
使用UNION ALL联合查询个人中介和实体中介
|
||||||
|
支持按中介类型、姓名、证件号筛选
|
||||||
|
-->
|
||||||
|
<select id="selectIntermediaryList" resultType="com.ruoyi.ccdi.domain.vo.CcdiIntermediaryVO">
|
||||||
|
<!-- 查询个人中介 -->
|
||||||
|
SELECT
|
||||||
|
biz_id as id,
|
||||||
|
name,
|
||||||
|
person_id as certificate_no,
|
||||||
|
'1' as intermediary_type,
|
||||||
|
person_type,
|
||||||
|
company,
|
||||||
|
data_source,
|
||||||
|
create_time
|
||||||
|
FROM ccdi_biz_intermediary
|
||||||
|
WHERE person_type = '中介'
|
||||||
|
<if test="intermediaryType == null or intermediaryType == '1'">
|
||||||
|
<if test="name != null and name != ''">
|
||||||
|
AND name LIKE CONCAT('%', #{name}, '%')
|
||||||
|
</if>
|
||||||
|
<if test="certificateNo != null and certificateNo != ''">
|
||||||
|
AND person_id = #{certificateNo}
|
||||||
|
</if>
|
||||||
|
</if>
|
||||||
|
|
||||||
|
UNION ALL
|
||||||
|
|
||||||
|
<!-- 查询实体中介 -->
|
||||||
|
SELECT
|
||||||
|
social_credit_code as id,
|
||||||
|
enterprise_name as name,
|
||||||
|
social_credit_code as certificate_no,
|
||||||
|
'2' as intermediary_type,
|
||||||
|
'实体' as person_type,
|
||||||
|
enterprise_name as company,
|
||||||
|
data_source,
|
||||||
|
create_time
|
||||||
|
FROM ccdi_enterprise_base_info
|
||||||
|
WHERE risk_level = '1' AND ent_source = 'INTERMEDIARY'
|
||||||
|
<if test="intermediaryType == null or intermediaryType == '2'">
|
||||||
|
<if test="name != null and name != ''">
|
||||||
|
AND enterprise_name LIKE CONCAT('%', #{name}, '%')
|
||||||
|
</if>
|
||||||
|
<if test="certificateNo != null and certificateNo != ''">
|
||||||
|
AND social_credit_code = #{certificateNo}
|
||||||
|
</if>
|
||||||
|
</if>
|
||||||
|
|
||||||
|
ORDER BY create_time DESC
|
||||||
|
</select>
|
||||||
|
|
||||||
|
</mapper>
|
||||||
@@ -1,5 +1,5 @@
|
|||||||
# 页面标题
|
# 页面标题
|
||||||
VUE_APP_TITLE = 若依管理系统
|
VUE_APP_TITLE = 纪检初核系统
|
||||||
|
|
||||||
# 开发环境配置
|
# 开发环境配置
|
||||||
ENV = 'development'
|
ENV = 'development'
|
||||||
|
|||||||
@@ -1,5 +1,5 @@
|
|||||||
# 页面标题
|
# 页面标题
|
||||||
VUE_APP_TITLE = 若依管理系统
|
VUE_APP_TITLE = 纪检初核系统
|
||||||
|
|
||||||
# 生产环境配置
|
# 生产环境配置
|
||||||
ENV = 'production'
|
ENV = 'production'
|
||||||
|
|||||||
@@ -1,5 +1,5 @@
|
|||||||
# 页面标题
|
# 页面标题
|
||||||
VUE_APP_TITLE = 若依管理系统
|
VUE_APP_TITLE = 纪检初核系统
|
||||||
|
|
||||||
BABEL_ENV = production
|
BABEL_ENV = production
|
||||||
|
|
||||||
|
|||||||
@@ -96,6 +96,12 @@
|
|||||||
icon="el-icon-s-data"
|
icon="el-icon-s-data"
|
||||||
@click="handleEnter(scope.row)"
|
@click="handleEnter(scope.row)"
|
||||||
>进入项目</el-button>
|
>进入项目</el-button>
|
||||||
|
<el-button
|
||||||
|
size="mini"
|
||||||
|
type="text"
|
||||||
|
icon="el-icon-refresh"
|
||||||
|
@click="handleReAnalyze(scope.row)"
|
||||||
|
>重新分析</el-button>
|
||||||
</template>
|
</template>
|
||||||
|
|
||||||
<!-- 已完成项目 -->
|
<!-- 已完成项目 -->
|
||||||
|
|||||||
@@ -7,7 +7,7 @@ function resolve(dir) {
|
|||||||
|
|
||||||
const CompressionPlugin = require('compression-webpack-plugin')
|
const CompressionPlugin = require('compression-webpack-plugin')
|
||||||
|
|
||||||
const name = process.env.VUE_APP_TITLE || '若依管理系统' // 网页标题
|
const name = process.env.VUE_APP_TITLE || '纪检初核系统' // 网页标题
|
||||||
|
|
||||||
const baseUrl = 'http://localhost:8080' // 后端接口
|
const baseUrl = 'http://localhost:8080' // 后端接口
|
||||||
|
|
||||||
|
|||||||
246
sql/menu-intermediary.sql
Normal file
246
sql/menu-intermediary.sql
Normal file
@@ -0,0 +1,246 @@
|
|||||||
|
-- =====================================================
|
||||||
|
-- 中介黑名单管理菜单SQL
|
||||||
|
-- 功能: 为中介黑名单管理模块创建菜单和权限配置
|
||||||
|
-- 版本: 2.0
|
||||||
|
-- 日期: 2026-02-04
|
||||||
|
-- =====================================================
|
||||||
|
|
||||||
|
-- 1. 创建主菜单 (中介黑名单)
|
||||||
|
-- 父级菜单: 2000 (业务管理, 请根据实际情况调整)
|
||||||
|
-- 菜单类型: M (目录)
|
||||||
|
INSERT INTO sys_menu (menu_name, parent_id, order_num, path, component, query, perms, icon, menu_type, status, visible, create_by, create_time, update_by, update_time, remark)
|
||||||
|
VALUES (
|
||||||
|
'中介黑名单',
|
||||||
|
2000,
|
||||||
|
5,
|
||||||
|
'intermediary',
|
||||||
|
NULL,
|
||||||
|
NULL,
|
||||||
|
NULL,
|
||||||
|
'peoples',
|
||||||
|
'M',
|
||||||
|
'0',
|
||||||
|
'0',
|
||||||
|
'admin',
|
||||||
|
NOW(),
|
||||||
|
'',
|
||||||
|
NULL,
|
||||||
|
'中介黑名单管理目录'
|
||||||
|
);
|
||||||
|
|
||||||
|
-- 获取刚插入的菜单ID
|
||||||
|
SET @menu_id = LAST_INSERT_ID();
|
||||||
|
|
||||||
|
-- 2. 创建子菜单 (中介黑名单管理)
|
||||||
|
-- 菜单类型: C (菜单)
|
||||||
|
INSERT INTO sys_menu (menu_name, parent_id, order_num, path, component, query, perms, icon, menu_type, status, visible, create_by, create_time, update_by, update_time, remark)
|
||||||
|
VALUES (
|
||||||
|
'中介管理',
|
||||||
|
@menu_id,
|
||||||
|
1,
|
||||||
|
'intermediaryIndex',
|
||||||
|
'ccdi/intermediary/index',
|
||||||
|
NULL,
|
||||||
|
NULL,
|
||||||
|
'user',
|
||||||
|
'C',
|
||||||
|
'0',
|
||||||
|
'0',
|
||||||
|
'admin',
|
||||||
|
NOW(),
|
||||||
|
'',
|
||||||
|
NULL,
|
||||||
|
'中介黑名单管理菜单'
|
||||||
|
);
|
||||||
|
|
||||||
|
SET @intermediary_menu_id = LAST_INSERT_ID();
|
||||||
|
|
||||||
|
-- 3. 创建按钮权限
|
||||||
|
-- 查询权限
|
||||||
|
INSERT INTO sys_menu (menu_name, parent_id, order_num, path, component, query, perms, icon, menu_type, status, visible, create_by, create_time, update_by, update_time, remark)
|
||||||
|
VALUES (
|
||||||
|
'中介查询',
|
||||||
|
@intermediary_menu_id,
|
||||||
|
1,
|
||||||
|
'',
|
||||||
|
NULL,
|
||||||
|
NULL,
|
||||||
|
'ccdi:intermediary:query',
|
||||||
|
'#',
|
||||||
|
'F',
|
||||||
|
'0',
|
||||||
|
'0',
|
||||||
|
'admin',
|
||||||
|
NOW(),
|
||||||
|
'',
|
||||||
|
NULL,
|
||||||
|
''
|
||||||
|
);
|
||||||
|
|
||||||
|
-- 列表权限
|
||||||
|
INSERT INTO sys_menu (menu_name, parent_id, order_num, path, component, query, perms, icon, menu_type, status, visible, create_by, create_time, update_by, update_time, remark)
|
||||||
|
VALUES (
|
||||||
|
'中介列表',
|
||||||
|
@intermediary_menu_id,
|
||||||
|
2,
|
||||||
|
'',
|
||||||
|
NULL,
|
||||||
|
NULL,
|
||||||
|
'ccdi:intermediary:list',
|
||||||
|
'#',
|
||||||
|
'F',
|
||||||
|
'0',
|
||||||
|
'0',
|
||||||
|
'admin',
|
||||||
|
NOW(),
|
||||||
|
'',
|
||||||
|
NULL,
|
||||||
|
''
|
||||||
|
);
|
||||||
|
|
||||||
|
-- 新增权限
|
||||||
|
INSERT INTO sys_menu (menu_name, parent_id, order_num, path, component, query, perms, icon, menu_type, status, visible, create_by, create_time, update_by, update_time, remark)
|
||||||
|
VALUES (
|
||||||
|
'中介新增',
|
||||||
|
@intermediary_menu_id,
|
||||||
|
3,
|
||||||
|
'',
|
||||||
|
NULL,
|
||||||
|
NULL,
|
||||||
|
'ccdi:intermediary:add',
|
||||||
|
'#',
|
||||||
|
'F',
|
||||||
|
'0',
|
||||||
|
'0',
|
||||||
|
'admin',
|
||||||
|
NOW(),
|
||||||
|
'',
|
||||||
|
NULL,
|
||||||
|
''
|
||||||
|
);
|
||||||
|
|
||||||
|
-- 修改权限
|
||||||
|
INSERT INTO sys_menu (menu_name, parent_id, order_num, path, component, query, perms, icon, menu_type, status, visible, create_by, create_time, update_by, update_time, remark)
|
||||||
|
VALUES (
|
||||||
|
'中介修改',
|
||||||
|
@intermediary_menu_id,
|
||||||
|
4,
|
||||||
|
'',
|
||||||
|
NULL,
|
||||||
|
NULL,
|
||||||
|
'ccdi:intermediary:edit',
|
||||||
|
'#',
|
||||||
|
'F',
|
||||||
|
'0',
|
||||||
|
'0',
|
||||||
|
'admin',
|
||||||
|
NOW(),
|
||||||
|
'',
|
||||||
|
NULL,
|
||||||
|
''
|
||||||
|
);
|
||||||
|
|
||||||
|
-- 删除权限
|
||||||
|
INSERT INTO sys_menu (menu_name, parent_id, order_num, path, component, query, perms, icon, menu_type, status, visible, create_by, create_time, update_by, update_time, remark)
|
||||||
|
VALUES (
|
||||||
|
'中介删除',
|
||||||
|
@intermediary_menu_id,
|
||||||
|
5,
|
||||||
|
'',
|
||||||
|
NULL,
|
||||||
|
NULL,
|
||||||
|
'ccdi:intermediary:remove',
|
||||||
|
'#',
|
||||||
|
'F',
|
||||||
|
'0',
|
||||||
|
'0',
|
||||||
|
'admin',
|
||||||
|
NOW(),
|
||||||
|
'',
|
||||||
|
NULL,
|
||||||
|
''
|
||||||
|
);
|
||||||
|
|
||||||
|
-- 导出权限
|
||||||
|
INSERT INTO sys_menu (menu_name, parent_id, order_num, path, component, query, perms, icon, menu_type, status, visible, create_by, create_time, update_by, update_time, remark)
|
||||||
|
VALUES (
|
||||||
|
'中介导出',
|
||||||
|
@intermediary_menu_id,
|
||||||
|
6,
|
||||||
|
'',
|
||||||
|
NULL,
|
||||||
|
NULL,
|
||||||
|
'ccdi:intermediary:export',
|
||||||
|
'#',
|
||||||
|
'F',
|
||||||
|
'0',
|
||||||
|
'0',
|
||||||
|
'admin',
|
||||||
|
NOW(),
|
||||||
|
'',
|
||||||
|
NULL,
|
||||||
|
''
|
||||||
|
);
|
||||||
|
|
||||||
|
-- 导入权限
|
||||||
|
INSERT INTO sys_menu (menu_name, parent_id, order_num, path, component, query, perms, icon, menu_type, status, visible, create_by, create_time, update_by, update_time, remark)
|
||||||
|
VALUES (
|
||||||
|
'中介导入',
|
||||||
|
@intermediary_menu_id,
|
||||||
|
7,
|
||||||
|
'',
|
||||||
|
NULL,
|
||||||
|
NULL,
|
||||||
|
'ccdi:intermediary:import',
|
||||||
|
'#',
|
||||||
|
'F',
|
||||||
|
'0',
|
||||||
|
'0',
|
||||||
|
'admin',
|
||||||
|
NOW(),
|
||||||
|
'',
|
||||||
|
NULL,
|
||||||
|
''
|
||||||
|
);
|
||||||
|
|
||||||
|
-- =====================================================
|
||||||
|
-- 说明:
|
||||||
|
-- 1. 本SQL创建了完整的菜单结构:
|
||||||
|
-- - 一级菜单: 中介黑名单 (目录)
|
||||||
|
-- - 二级菜单: 中介管理 (菜单页面)
|
||||||
|
-- - 三级菜单: 各种按钮权限
|
||||||
|
--
|
||||||
|
-- 2. 权限标识:
|
||||||
|
-- - ccdi:intermediary:query (查询)
|
||||||
|
-- - ccdi:intermediary:list (列表)
|
||||||
|
-- - ccdi:intermediary:add (新增)
|
||||||
|
-- - ccdi:intermediary:edit (修改)
|
||||||
|
-- - ccdi:intermediary:remove (删除)
|
||||||
|
-- - ccdi:intermediary:export (导出)
|
||||||
|
-- - ccdi:intermediary:import (导入)
|
||||||
|
--
|
||||||
|
-- 3. 使用说明:
|
||||||
|
-- - 执行本SQL后,需要在角色管理中为相应角色分配权限
|
||||||
|
-- - 建议为admin角色分配所有权限
|
||||||
|
-- - 前端路由会根据权限自动显示菜单
|
||||||
|
--
|
||||||
|
-- 4. 注意事项:
|
||||||
|
-- - parent_id=2000 是业务管理的父级菜单,请根据实际情况调整
|
||||||
|
-- - 组件路径 'ccdi/intermediary/index' 需要与前端Vue组件路径一致
|
||||||
|
-- - 如果父级菜单不存在,需要先创建父级菜单或修改parent_id
|
||||||
|
-- =====================================================
|
||||||
|
|
||||||
|
-- 查询创建的菜单 (用于验证)
|
||||||
|
SELECT
|
||||||
|
menu_id AS '菜单ID',
|
||||||
|
menu_name AS '菜单名称',
|
||||||
|
parent_id AS '父级菜单ID',
|
||||||
|
order_num AS '显示顺序',
|
||||||
|
perms AS '权限标识',
|
||||||
|
menu_type AS '菜单类型',
|
||||||
|
status AS '状态',
|
||||||
|
visible AS '可见',
|
||||||
|
create_time AS '创建时间'
|
||||||
|
FROM sys_menu
|
||||||
|
WHERE menu_name LIKE '%中介%' OR perms LIKE '%intermediary%'
|
||||||
|
ORDER BY parent_id, order_num;
|
||||||
Reference in New Issue
Block a user