wkc/ccdi
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

变更项目缩写

Browse Source
This commit is contained in:
wkc
2026-01-30 14:15:21 +08:00
parent e99b05acc2
commit 29a2e60ee1
107 changed files with 1134 additions and 990 deletions
Download Patch File Download Diff File Expand all files Collapse all files

150
openspec/changes/enhance-intermediary-with-detailed-fields/design.md
View File

@@ -2,7 +2,7 @@
## 数据库设计
### 表扩展：dpc_intermediary_blacklist
### 表扩展：ccdi_intermediary_blacklist
在现有表基础上添加以下字段：
@@ -10,47 +10,47 @@
-- ============================================================
-- 个人类型字段 (以 indiv_ 前缀标识，individual 缩写)
-- ============================================================
ALTER TABLE dpc_intermediary_blacklist ADD COLUMN `indiv_type` VARCHAR(30) DEFAULT NULL COMMENT '人员类型（中介、职业背债人、房产中介等）';
ALTER TABLE dpc_intermediary_blacklist ADD COLUMN `indiv_sub_type` VARCHAR(50) DEFAULT NULL COMMENT '人员子类型（本人、配偶等）';
ALTER TABLE dpc_intermediary_blacklist ADD COLUMN `indiv_gender` CHAR(1) DEFAULT NULL COMMENT '性别（M男 F女 O其他）';
ALTER TABLE dpc_intermediary_blacklist ADD COLUMN `indiv_cert_type` VARCHAR(30) DEFAULT '身份证' COMMENT '证件类型';
ALTER TABLE dpc_intermediary_blacklist ADD COLUMN `indiv_phone` VARCHAR(20) DEFAULT NULL COMMENT '手机号码（加密存储）';
ALTER TABLE dpc_intermediary_blacklist ADD COLUMN `indiv_wechat` VARCHAR(50) DEFAULT NULL COMMENT '微信号';
ALTER TABLE dpc_intermediary_blacklist ADD COLUMN `indiv_address` VARCHAR(200) DEFAULT NULL COMMENT '联系地址';
ALTER TABLE dpc_intermediary_blacklist ADD COLUMN `indiv_company` VARCHAR(100) DEFAULT NULL COMMENT '所在公司';
ALTER TABLE dpc_intermediary_blacklist ADD COLUMN `indiv_position` VARCHAR(100) DEFAULT NULL COMMENT '职位/职务';
ALTER TABLE dpc_intermediary_blacklist ADD COLUMN `indiv_related_id` VARCHAR(20) DEFAULT NULL COMMENT '关联人员ID';
ALTER TABLE dpc_intermediary_blacklist ADD COLUMN `indiv_relation` VARCHAR(50) DEFAULT NULL COMMENT '关联关系';
ALTER TABLE ccdi_intermediary_blacklist ADD COLUMN `indiv_type` VARCHAR(30) DEFAULT NULL COMMENT '人员类型（中介、职业背债人、房产中介等）';
ALTER TABLE ccdi_intermediary_blacklist ADD COLUMN `indiv_sub_type` VARCHAR(50) DEFAULT NULL COMMENT '人员子类型（本人、配偶等）';
ALTER TABLE ccdi_intermediary_blacklist ADD COLUMN `indiv_gender` CHAR(1) DEFAULT NULL COMMENT '性别（M男 F女 O其他）';
ALTER TABLE ccdi_intermediary_blacklist ADD COLUMN `indiv_cert_type` VARCHAR(30) DEFAULT '身份证' COMMENT '证件类型';
ALTER TABLE ccdi_intermediary_blacklist ADD COLUMN `indiv_phone` VARCHAR(20) DEFAULT NULL COMMENT '手机号码（加密存储）';
ALTER TABLE ccdi_intermediary_blacklist ADD COLUMN `indiv_wechat` VARCHAR(50) DEFAULT NULL COMMENT '微信号';
ALTER TABLE ccdi_intermediary_blacklist ADD COLUMN `indiv_address` VARCHAR(200) DEFAULT NULL COMMENT '联系地址';
ALTER TABLE ccdi_intermediary_blacklist ADD COLUMN `indiv_company` VARCHAR(100) DEFAULT NULL COMMENT '所在公司';
ALTER TABLE ccdi_intermediary_blacklist ADD COLUMN `indiv_position` VARCHAR(100) DEFAULT NULL COMMENT '职位/职务';
ALTER TABLE ccdi_intermediary_blacklist ADD COLUMN `indiv_related_id` VARCHAR(20) DEFAULT NULL COMMENT '关联人员ID';
ALTER TABLE ccdi_intermediary_blacklist ADD COLUMN `indiv_relation` VARCHAR(50) DEFAULT NULL COMMENT '关联关系';
-- ============================================================
-- 机构类型字段 (以 corp_ 前缀标识，corporation 缩写)
-- ============================================================
ALTER TABLE dpc_intermediary_blacklist ADD COLUMN `corp_credit_code` VARCHAR(18) DEFAULT NULL COMMENT '统一社会信用代码';
ALTER TABLE dpc_intermediary_blacklist ADD COLUMN `corp_type` VARCHAR(50) DEFAULT NULL COMMENT '主体类型（有限责任公司、股份有限公司等）';
ALTER TABLE dpc_intermediary_blacklist ADD COLUMN `corp_nature` VARCHAR(50) DEFAULT NULL COMMENT '企业性质（国企、民企、外企等）';
ALTER TABLE dpc_intermediary_blacklist ADD COLUMN `corp_industry_category` VARCHAR(100) DEFAULT NULL COMMENT '行业分类';
ALTER TABLE dpc_intermediary_blacklist ADD COLUMN `corp_industry` VARCHAR(100) DEFAULT NULL COMMENT '所属行业';
ALTER TABLE dpc_intermediary_blacklist ADD COLUMN `corp_establish_date` DATE DEFAULT NULL COMMENT '成立日期';
ALTER TABLE dpc_intermediary_blacklist ADD COLUMN `corp_address` VARCHAR(500) DEFAULT NULL COMMENT '注册地址';
ALTER TABLE dpc_intermediary_blacklist ADD COLUMN `corp_legal_rep` VARCHAR(50) DEFAULT NULL COMMENT '法定代表人';
ALTER TABLE dpc_intermediary_blacklist ADD COLUMN `corp_legal_cert_type` VARCHAR(30) DEFAULT NULL COMMENT '法定代表人证件类型';
ALTER TABLE dpc_intermediary_blacklist ADD COLUMN `corp_legal_cert_no` VARCHAR(30) DEFAULT NULL COMMENT '法定代表人证件号码';
ALTER TABLE dpc_intermediary_blacklist ADD COLUMN `corp_shareholder_1` VARCHAR(30) DEFAULT NULL COMMENT '股东1';
ALTER TABLE dpc_intermediary_blacklist ADD COLUMN `corp_shareholder_2` VARCHAR(30) DEFAULT NULL COMMENT '股东2';
ALTER TABLE dpc_intermediary_blacklist ADD COLUMN `corp_shareholder_3` VARCHAR(30) DEFAULT NULL COMMENT '股东3';
ALTER TABLE dpc_intermediary_blacklist ADD COLUMN `corp_shareholder_4` VARCHAR(30) DEFAULT NULL COMMENT '股东4';
ALTER TABLE dpc_intermediary_blacklist ADD COLUMN `corp_shareholder_5` VARCHAR(30) DEFAULT NULL COMMENT '股东5';
ALTER TABLE ccdi_intermediary_blacklist ADD COLUMN `corp_credit_code` VARCHAR(18) DEFAULT NULL COMMENT '统一社会信用代码';
ALTER TABLE ccdi_intermediary_blacklist ADD COLUMN `corp_type` VARCHAR(50) DEFAULT NULL COMMENT '主体类型（有限责任公司、股份有限公司等）';
ALTER TABLE ccdi_intermediary_blacklist ADD COLUMN `corp_nature` VARCHAR(50) DEFAULT NULL COMMENT '企业性质（国企、民企、外企等）';
ALTER TABLE ccdi_intermediary_blacklist ADD COLUMN `corp_industry_category` VARCHAR(100) DEFAULT NULL COMMENT '行业分类';
ALTER TABLE ccdi_intermediary_blacklist ADD COLUMN `corp_industry` VARCHAR(100) DEFAULT NULL COMMENT '所属行业';
ALTER TABLE ccdi_intermediary_blacklist ADD COLUMN `corp_establish_date` DATE DEFAULT NULL COMMENT '成立日期';
ALTER TABLE ccdi_intermediary_blacklist ADD COLUMN `corp_address` VARCHAR(500) DEFAULT NULL COMMENT '注册地址';
ALTER TABLE ccdi_intermediary_blacklist ADD COLUMN `corp_legal_rep` VARCHAR(50) DEFAULT NULL COMMENT '法定代表人';
ALTER TABLE ccdi_intermediary_blacklist ADD COLUMN `corp_legal_cert_type` VARCHAR(30) DEFAULT NULL COMMENT '法定代表人证件类型';
ALTER TABLE ccdi_intermediary_blacklist ADD COLUMN `corp_legal_cert_no` VARCHAR(30) DEFAULT NULL COMMENT '法定代表人证件号码';
ALTER TABLE ccdi_intermediary_blacklist ADD COLUMN `corp_shareholder_1` VARCHAR(30) DEFAULT NULL COMMENT '股东1';
ALTER TABLE ccdi_intermediary_blacklist ADD COLUMN `corp_shareholder_2` VARCHAR(30) DEFAULT NULL COMMENT '股东2';
ALTER TABLE ccdi_intermediary_blacklist ADD COLUMN `corp_shareholder_3` VARCHAR(30) DEFAULT NULL COMMENT '股东3';
ALTER TABLE ccdi_intermediary_blacklist ADD COLUMN `corp_shareholder_4` VARCHAR(30) DEFAULT NULL COMMENT '股东4';
ALTER TABLE ccdi_intermediary_blacklist ADD COLUMN `corp_shareholder_5` VARCHAR(30) DEFAULT NULL COMMENT '股东5';
-- ============================================================
-- 通用字段
-- ============================================================
ALTER TABLE dpc_intermediary_blacklist ADD COLUMN `data_source` VARCHAR(30) DEFAULT 'MANUAL' COMMENT '数据来源（MANUAL手动录入 SYSTEM系统同步 IMPORT批量导入 API接口获取）';
ALTER TABLE ccdi_intermediary_blacklist ADD COLUMN `data_source` VARCHAR(30) DEFAULT 'MANUAL' COMMENT '数据来源（MANUAL手动录入 SYSTEM系统同步 IMPORT批量导入 API接口获取）';
```
### 完整表结构
```sql
CREATE TABLE `dpc_intermediary_blacklist` (
CREATE TABLE `ccdi_intermediary_blacklist` (
`intermediary_id` BIGINT NOT NULL AUTO_INCREMENT COMMENT '中介ID',
-- ============================================================
@@ -163,31 +163,31 @@ CREATE TABLE `dpc_intermediary_blacklist` (
ruoyi-dpc/
├── src/main/java/com/ruoyi/dpc/
│ ├── controller/
│ │ └── DpcIntermediaryBlacklistController.java (修改)
│ │ └── CcdiIntermediaryBlacklistController.java (修改)
│ ├── domain/
│ │ ├── DpcIntermediaryBlacklist.java (修改 - 添加新字段)
│ │ ├── CcdiIntermediaryBlacklist.java (修改 - 添加新字段)
│ │ ├── dto/
│ │ │ ├── DpcIntermediaryBlacklistAddDTO.java (保留 - 兼容)
│ │ │ ├── DpcIntermediaryBlacklistEditDTO.java (保留 - 兼容)
│ │ │ ├── DpcIntermediaryBlacklistQueryDTO.java (保留)
│ │ │ ├── DpcIntermediaryPersonAddDTO.java (新增)
│ │ │ └── DpcIntermediaryEntityAddDTO.java (新增)
│ │ │ ├── CcdiIntermediaryBlacklistAddDTO.java (保留 - 兼容)
│ │ │ ├── CcdiIntermediaryBlacklistEditDTO.java (保留 - 兼容)
│ │ │ ├── CcdiIntermediaryBlacklistQueryDTO.java (保留)
│ │ │ ├── CcdiIntermediaryPersonAddDTO.java (新增)
│ │ │ └── CcdiIntermediaryEntityAddDTO.java (新增)
│ │ ├── vo/
│ │ │ ├── DpcIntermediaryBlacklistVO.java (保留 - 列表用)
│ │ │ ├── DpcIntermediaryPersonDetailVO.java (新增)
│ │ │ └── DpcIntermediaryEntityDetailVO.java (新增)
│ │ │ ├── CcdiIntermediaryBlacklistVO.java (保留 - 列表用)
│ │ │ ├── CcdiIntermediaryPersonDetailVO.java (新增)
│ │ │ └── CcdiIntermediaryEntityDetailVO.java (新增)
│ │ └── excel/
│ │ ├── DpcIntermediaryBlacklistExcel.java (保留 - 通用模板)
│ │ ├── DpcIntermediaryPersonExcel.java (新增)
│ │ └── DpcIntermediaryEntityExcel.java (新增)
│ │ ├── CcdiIntermediaryBlacklistExcel.java (保留 - 通用模板)
│ │ ├── CcdiIntermediaryPersonExcel.java (新增)
│ │ └── CcdiIntermediaryEntityExcel.java (新增)
│ ├── mapper/
│ │ └── DpcIntermediaryBlacklistMapper.java
│ │ └── CcdiIntermediaryBlacklistMapper.java
│ └── service/
│ ├── IDpcIntermediaryBlacklistService.java (修改接口)
│ ├── ICcdiIntermediaryBlacklistService.java (修改接口)
│ └── impl/
│ └── DpcIntermediaryBlacklistServiceImpl.java (修改实现)
│ └── CcdiIntermediaryBlacklistServiceImpl.java (修改实现)
└── src/main/resources/mapper/dpc/
└── DpcIntermediaryBlacklistMapper.xml
└── CcdiIntermediaryBlacklistMapper.xml
```
### Controller 层设计
@@ -197,7 +197,7 @@ ruoyi-dpc/
```java
@RestController
@RequestMapping("/dpc/intermediary")
public class DpcIntermediaryBlacklistController extends BaseController {
public class CcdiIntermediaryBlacklistController extends BaseController {
// ... 现有接口保持不变 ...
@@ -209,7 +209,7 @@ public class DpcIntermediaryBlacklistController extends BaseController {
public void importPersonTemplate(HttpServletResponse response) {
EasyExcelUtil.importTemplateWithDictDropdown(
response,
DpcIntermediaryPersonExcel.class,
CcdiIntermediaryPersonExcel.class,
"个人中介黑名单"
);
}
@@ -222,7 +222,7 @@ public class DpcIntermediaryBlacklistController extends BaseController {
public void importEntityTemplate(HttpServletResponse response) {
EasyExcelUtil.importTemplateWithDictDropdown(
response,
DpcIntermediaryEntityExcel.class,
CcdiIntermediaryEntityExcel.class,
"机构中介黑名单"
);
}
@@ -235,8 +235,8 @@ public class DpcIntermediaryBlacklistController extends BaseController {
@Log(title = "中介黑名单", businessType = BusinessType.IMPORT)
@PostMapping("/importPersonData")
public AjaxResult importPersonData(MultipartFile file, boolean updateSupport) throws Exception {
List<DpcIntermediaryPersonExcel> list = EasyExcelUtil.importExcel(
file.getInputStream(), DpcIntermediaryPersonExcel.class);
List<CcdiIntermediaryPersonExcel> list = EasyExcelUtil.importExcel(
file.getInputStream(), CcdiIntermediaryPersonExcel.class);
String message = intermediaryService.importPersonIntermediary(list, updateSupport);
return success(message);
}
@@ -249,8 +249,8 @@ public class DpcIntermediaryBlacklistController extends BaseController {
@Log(title = "中介黑名单", businessType = BusinessType.IMPORT)
@PostMapping("/importEntityData")
public AjaxResult importEntityData(MultipartFile file, boolean updateSupport) throws Exception {
List<DpcIntermediaryEntityExcel> list = EasyExcelUtil.importExcel(
file.getInputStream(), DpcIntermediaryEntityExcel.class);
List<CcdiIntermediaryEntityExcel> list = EasyExcelUtil.importExcel(
file.getInputStream(), CcdiIntermediaryEntityExcel.class);
String message = intermediaryService.importEntityIntermediary(list, updateSupport);
return success(message);
}
@@ -262,7 +262,7 @@ public class DpcIntermediaryBlacklistController extends BaseController {
**接口扩展：**
```java
public interface IDpcIntermediaryBlacklistService {
public interface ICcdiIntermediaryBlacklistService {
// ... 现有方法保持不变 ...
@@ -274,12 +274,12 @@ public interface IDpcIntermediaryBlacklistService {
/**
* 导入个人中介数据
*/
String importPersonIntermediary(List<DpcIntermediaryPersonExcel> list, boolean isUpdateSupport);
String importPersonIntermediary(List<CcdiIntermediaryPersonExcel> list, boolean isUpdateSupport);
/**
* 导入机构中介数据
*/
String importEntityIntermediary(List<DpcIntermediaryEntityExcel> list, boolean isUpdateSupport);
String importEntityIntermediary(List<CcdiIntermediaryEntityExcel> list, boolean isUpdateSupport);
}
```
@@ -293,7 +293,7 @@ public interface IDpcIntermediaryBlacklistService {
```java
@Data
public class DpcIntermediaryPersonExcel implements Serializable {
public class CcdiIntermediaryPersonExcel implements Serializable {
@Serial
private static final long serialVersionUID = 1L;
@@ -312,12 +312,12 @@ public class DpcIntermediaryPersonExcel implements Serializable {
@ExcelProperty(value = "性别", index = 3)
@ColumnWidth(10)
@DictDropdown(dictType = "dpc_indiv_gender")
@DictDropdown(dictType = "ccdi_indiv_gender")
private String indivGender; // 对应 indiv_gender，字典下拉框：男/女/其他
@ExcelProperty(value = "证件类型", index = 4)
@ColumnWidth(15)
@DictDropdown(dictType = "dpc_certificate_type")
@DictDropdown(dictType = "ccdi_certificate_type")
private String indivCertType; // 对应 indiv_cert_type，字典下拉框：身份证/护照/港澳通行证/台胞证/军官证
@ExcelProperty(value = "证件号码", index = 5)
@@ -366,7 +366,7 @@ public class DpcIntermediaryPersonExcel implements Serializable {
```java
@Data
public class DpcIntermediaryEntityExcel implements Serializable {
public class CcdiIntermediaryEntityExcel implements Serializable {
@Serial
private static final long serialVersionUID = 1L;
@@ -381,12 +381,12 @@ public class DpcIntermediaryEntityExcel implements Serializable {
@ExcelProperty(value = "主体类型", index = 2)
@ColumnWidth(20)
@DictDropdown(dictType = "dpc_entity_type")
@DictDropdown(dictType = "ccdi_entity_type")
private String corpType; // 对应 corp_type，字典下拉框：有限责任公司/股份有限公司/合伙企业/个体工商户/外资企业
@ExcelProperty(value = "企业性质", index = 3)
@ColumnWidth(15)
@DictDropdown(dictType = "dpc_enterprise_nature")
@DictDropdown(dictType = "ccdi_enterprise_nature")
private String corpNature; // 对应 corp_nature，字典下拉框：国企/民企/外企/合资/其他
@ExcelProperty(value = "行业分类", index = 4)
@@ -453,7 +453,7 @@ public class DpcIntermediaryEntityExcel implements Serializable {
```java
@Data
public class DpcIntermediaryPersonDetailVO implements Serializable {
public class CcdiIntermediaryPersonDetailVO implements Serializable {
// 核心字段
private Long intermediaryId;
@@ -492,7 +492,7 @@ public class DpcIntermediaryPersonDetailVO implements Serializable {
```java
@Data
public class DpcIntermediaryEntityDetailVO implements Serializable {
public class CcdiIntermediaryEntityDetailVO implements Serializable {
// 核心字段
private Long intermediaryId;
@@ -541,14 +541,14 @@ public class DpcIntermediaryEntityDetailVO implements Serializable {
| 列名 | 下拉框选项 | 说明 |
|------|-----------|------|
| 性别 | 男, 女, 其他 | 对应值：M, F, O |
| 证件类型 | 身份证, 护照, 港澳通行证, 台胞证, 军官证 | 从字典 dpc_certificate_type 加载 |
| 证件类型 | 身份证, 护照, 港澳通行证, 台胞证, 军官证 | 从字典 ccdi_certificate_type 加载 |
#### 机构中介模板下拉框
| 列名 | 下拉框选项 | 说明 |
|------|-----------|------|
| 主体类型 | 有限责任公司, 股份有限公司, 合伙企业, 个体工商户, 外资企业 | 从字典 dpc_entity_type 加载 |
| 企业性质 | 国企, 民企, 外企, 合资, 其他 | 从字典 dpc_enterprise_nature 加载 |
| 主体类型 | 有限责任公司, 股份有限公司, 合伙企业, 个体工商户, 外资企业 | 从字典 ccdi_entity_type 加载 |
| 企业性质 | 国企, 民企, 外企, 合资, 其他 | 从字典 ccdi_enterprise_nature 加载 |
**注意**：
- **状态字段**：不在 Excel 模板中显示，导入时默认设置为"正常"（0）
@@ -610,7 +610,7 @@ public class DpcIntermediaryEntityDetailVO implements Serializable {
## 字典数据设计
### 人员类型（dpc_person_type）
### 人员类型（ccdi_person_type）
| 字典值 | 字典标签 | 排序 | 状态 |
|-------|---------|-----|------|
@@ -618,7 +618,7 @@ public class DpcIntermediaryEntityDetailVO implements Serializable {
| 职业背债人 | 职业背债人 | 2 | 正常 |
| 房产中介 | 房产中介 | 3 | 正常 |
### 人员子类型（dpc_person_sub_type）
### 人员子类型（ccdi_person_sub_type）
| 字典值 | 字典标签 | 排序 | 状态 |
|-------|---------|-----|------|
@@ -627,7 +627,7 @@ public class DpcIntermediaryEntityDetailVO implements Serializable {
| 子女 | 子女 | 3 | 正常 |
| 其他 | 其他 | 9 | 正常 |
### 证件类型（dpc_certificate_type）
### 证件类型（ccdi_certificate_type）
| 字典值 | 字典标签 | 排序 | 状态 |
|-------|---------|-----|------|
@@ -637,7 +637,7 @@ public class DpcIntermediaryEntityDetailVO implements Serializable {
| 台胞证 | 台胞证 | 4 | 正常 |
| 军官证 | 军官证 | 5 | 正常 |
### 主体类型（dpc_entity_type）
### 主体类型（ccdi_entity_type）
| 字典值 | 字典标签 | 排序 | 状态 |
|-------|---------|-----|------|
@@ -647,7 +647,7 @@ public class DpcIntermediaryEntityDetailVO implements Serializable {
| 个体工商户 | 个体工商户 | 4 | 正常 |
| 外资企业 | 外资企业 | 5 | 正常 |
### 企业性质（dpc_enterprise_nature）
### 企业性质（ccdi_enterprise_nature）
| 字典值 | 字典标签 | 排序 | 状态 |
|-------|---------|-----|------|
@@ -657,7 +657,7 @@ public class DpcIntermediaryEntityDetailVO implements Serializable {
| 合资 | 合资 | 4 | 正常 |
| 其他 | 其他 | 9 | 正常 |
### 数据来源（dpc_data_source）
### 数据来源（ccdi_data_source）
| 字典值 | 字典标签 | 排序 | 状态 |
|-------|---------|-----|------|
@@ -685,14 +685,14 @@ public class DpcIntermediaryEntityDetailVO implements Serializable {
// 生成个人中介模板（带字典下拉框）
EasyExcelUtil.importTemplateWithDictDropdown(
response,
DpcIntermediaryPersonExcel.class,
CcdiIntermediaryPersonExcel.class,
"个人中介黑名单"
);
// 生成机构中介模板（带字典下拉框）
EasyExcelUtil.importTemplateWithDictDropdown(
response,
DpcIntermediaryEntityExcel.class,
CcdiIntermediaryEntityExcel.class,
"机构中介黑名单"
);
```

12
openspec/changes/enhance-intermediary-with-detailed-fields/proposal.md
View File

@@ -94,11 +94,11 @@
## Impact
### 后端影响
- **数据库**：扩展 `dpc_intermediary_blacklist` 表，添加约30个新字段
- **实体类**：`DpcIntermediaryBlacklist` 添加新字段属性
- **DTO**：创建 `DpcIntermediaryPersonAddDTO` 和 `DpcIntermediaryEntityAddDTO`
- **VO**：创建 `DpcIntermediaryPersonDetailVO` 和 `DpcIntermediaryEntityDetailVO`
- **Excel**：创建 `DpcIntermediaryPersonExcel` 和 `DpcIntermediaryEntityExcel`
- **数据库**：扩展 `ccdi_intermediary_blacklist` 表，添加约30个新字段
- **实体类**：`CcdiIntermediaryBlacklist` 添加新字段属性
- **DTO**：创建 `CcdiIntermediaryPersonAddDTO` 和 `CcdiIntermediaryEntityAddDTO`
- **VO**：创建 `CcdiIntermediaryPersonDetailVO` 和 `CcdiIntermediaryEntityDetailVO`
- **Excel**：创建 `CcdiIntermediaryPersonExcel` 和 `CcdiIntermediaryEntityExcel`
- **Controller**：添加两个模板下载接口，修改详情接口
- **Service**：扩展导入逻辑，支持不同类型的模板
@@ -110,7 +110,7 @@
- 扩展现有表，添加新字段（默认允许 NULL，保持向后兼容）
## Dependencies
- 依赖现有 `dpc_intermediary_blacklist` 表和基础功能
- 依赖现有 `ccdi_intermediary_blacklist` 表和基础功能
- 依赖 EasyExcel 进行 Excel 导入导出
## Related Changes

6
openspec/changes/enhance-intermediary-with-detailed-fields/specs/intermediary-detailed-fields/spec.md
View File

@@ -97,8 +97,8 @@
**Given** 用户调用详情接口，只提供中介ID
**When** 系统查询到该中介记录
**Then** 系统应根据中介类型自动返回对应类型的 VO
**And** 个人类型返回 DpcIntermediaryPersonDetailVO
**And** 机构类型返回 DpcIntermediaryEntityDetailVO
**And** 个人类型返回 CcdiIntermediaryPersonDetailVO
**And** 机构类型返回 CcdiIntermediaryEntityDetailVO
### Requirement: 保持现有功能兼容性
所有新增功能必须保持现有接口和功能的正常运行。
@@ -170,7 +170,7 @@
- `excel-import-export` (Excel 导入导出基础功能)
### Dependencies
- 依赖现有 `dpc_intermediary_blacklist` 表结构
- 依赖现有 `ccdi_intermediary_blacklist` 表结构
- 依赖 EasyExcel 工具类
- 依赖现有权限控制体系

52
openspec/changes/enhance-intermediary-with-detailed-fields/tasks.md
View File

@@ -13,7 +13,7 @@
- [ ] 编写 ALTER TABLE 语句，添加机构类型字段（15个字段）
- [ ] 编写 ALTER TABLE 语句，添加通用字段（1个字段：data_source）
- [ ] 添加必要的索引（idx_credit_code, idx_phone_number）
- [ ] 将 SQL 脚本保存到 `sql/` 目录，命名格式：`dpc_intermediary_enhance_YYYYMMDD.sql`
- [ ] 将 SQL 脚本保存到 `sql/` 目录，命名格式：`ccdi_intermediary_enhance_YYYYMMDD.sql`
**验证方式**：SQL 语法检查，确保所有字段正确添加
@@ -27,7 +27,7 @@
- [ ] 确认所有字段添加成功且类型正确
- [ ] 确认索引创建成功
**验证方式**：DESCRIBE dpc_intermediary_blacklist; SHOW INDEX FROM dpc_intermediary_blacklist;
**验证方式**：DESCRIBE ccdi_intermediary_blacklist; SHOW INDEX FROM ccdi_intermediary_blacklist;
**依赖**：任务 1.1
@@ -35,7 +35,7 @@
### 阶段二：后端实体类和 DTO/VO 更新
#### 任务 2.1：更新实体类 DpcIntermediaryBlacklist
#### 任务 2.1：更新实体类 CcdiIntermediaryBlacklist
- [ ] 添加个人类型字段属性（11个）
- [ ] 添加机构类型字段属性（15个）
- [ ] 添加通用字段属性（1个：dataSource）
@@ -49,7 +49,7 @@
---
#### 任务 2.2：创建个人中介 DTO
- [ ] 创建 `DpcIntermediaryPersonAddDTO.java`
- [ ] 创建 `CcdiIntermediaryPersonAddDTO.java`
- [ ] 添加个人专属字段
- [ ] 添加适当的验证注解（@NotBlank, @Size 等）
- [ ] 实现 Serializable 接口
@@ -61,7 +61,7 @@
---
#### 任务 2.3：创建机构中介 DTO
- [ ] 创建 `DpcIntermediaryEntityAddDTO.java`
- [ ] 创建 `CcdiIntermediaryEntityAddDTO.java`
- [ ] 添加机构专属字段
- [ ] 添加适当的验证注解
- [ ] 实现 Serializable 接口
@@ -73,7 +73,7 @@
---
#### 任务 2.4：创建个人详情 VO
- [ ] 创建 `DpcIntermediaryPersonDetailVO.java`
- [ ] 创建 `CcdiIntermediaryPersonDetailVO.java`
- [ ] 包含核心字段 + 个人专属字段
- [ ] 添加关联字段名称（如 genderName, certificateTypeName）
- [ ] 添加审计字段
@@ -86,7 +86,7 @@
---
#### 任务 2.5：创建机构详情 VO
- [ ] 创建 `DpcIntermediaryEntityDetailVO.java`
- [ ] 创建 `CcdiIntermediaryEntityDetailVO.java`
- [ ] 包含核心字段 + 机构专属字段
- [ ] 添加关联字段名称
- [ ] 添加审计字段
@@ -101,14 +101,14 @@
### 阶段三：Excel 类创建
#### 任务 3.1：创建个人中介 Excel 类
- [ ] 创建 `DpcIntermediaryPersonExcel.java`
- [ ] 创建 `CcdiIntermediaryPersonExcel.java`
- [ ] 使用 @ExcelProperty 注解定义 Excel 列
- [ ] 使用 @ColumnWidth 注解设置列宽
- [ ] 字段顺序：姓名 -> 人员类型 -> ... -> 备注（共14列）
- [ ] **不在模板中显示**：状态、数据来源字段（由系统自动设置）
- [ ] **添加字典下拉框注解**：
- `@DictDropdown(dictType = "dpc_indiv_gender")` - 性别字段
- `@DictDropdown(dictType = "dpc_certificate_type")` - 证件类型字段
- `@DictDropdown(dictType = "ccdi_indiv_gender")` - 性别字段
- `@DictDropdown(dictType = "ccdi_certificate_type")` - 证件类型字段
**验证方式**：编译通过，Excel 注解正确
@@ -117,14 +117,14 @@
---
#### 任务 3.2：创建机构中介 Excel 类
- [ ] 创建 `DpcIntermediaryEntityExcel.java`
- [ ] 创建 `CcdiIntermediaryEntityExcel.java`
- [ ] 使用 @ExcelProperty 注解定义 Excel 列
- [ ] 使用 @ColumnWidth 注解设置列宽
- [ ] 字段顺序：机构名称 -> 统一社会信用代码 -> ... -> 备注（共17列）
- [ ] **不在模板中显示**：状态、数据来源字段（由系统自动设置）
- [ ] **添加字典下拉框注解**：
- `@DictDropdown(dictType = "dpc_entity_type")` - 主体类型字段
- `@DictDropdown(dictType = "dpc_enterprise_nature")` - 企业性质字段
- `@DictDropdown(dictType = "ccdi_entity_type")` - 主体类型字段
- `@DictDropdown(dictType = "ccdi_enterprise_nature")` - 企业性质字段
**验证方式**：编译通过，Excel 注解正确
@@ -135,10 +135,10 @@
### 阶段四：Service 层实现
#### 任务 4.1：扩展 Service 接口
- [ ] 在 `IDpcIntermediaryBlacklistService` 中添加新方法：
- [ ] 在 `ICcdiIntermediaryBlacklistService` 中添加新方法：
- `Object selectIntermediaryDetailById(Long intermediaryId)`
- `String importPersonIntermediary(List<DpcIntermediaryPersonExcel> list, boolean isUpdateSupport)`
- `String importEntityIntermediary(List<DpcIntermediaryEntityExcel> list, boolean isUpdateSupport)`
- `String importPersonIntermediary(List<CcdiIntermediaryPersonExcel> list, boolean isUpdateSupport)`
- `String importEntityIntermediary(List<CcdiIntermediaryEntityExcel> list, boolean isUpdateSupport)`
**验证方式**：编译通过，接口方法签名正确
@@ -147,10 +147,10 @@
---
#### 任务 4.2：实现详情查询方法
- [ ] 在 `DpcIntermediaryBlacklistServiceImpl` 中实现 `selectIntermediaryDetailById`
- [ ] 在 `CcdiIntermediaryBlacklistServiceImpl` 中实现 `selectIntermediaryDetailById`
- [ ] 根据中介类型返回不同的 VO
- [ ] 个人类型返回 `DpcIntermediaryPersonDetailVO`
- [ ] 机构类型返回 `DpcIntermediaryEntityDetailVO`
- [ ] 个人类型返回 `CcdiIntermediaryPersonDetailVO`
- [ ] 机构类型返回 `CcdiIntermediaryEntityDetailVO`
- [ ] 填充关联字段名称（字典转换）
**验证方式**：单元测试验证不同类型返回正确的 VO
@@ -234,13 +234,13 @@
### 阶段六：字典数据配置
#### 任务 6.1：创建字典数据 SQL 脚本
- [ ] 添加人员类型字典（dpc_person_type）
- [ ] 添加人员子类型字典（dpc_person_sub_type）
- [ ] **添加性别字典（dpc_indiv_gender）** - 用于个人中介下拉框
- [ ] **添加证件类型字典（dpc_certificate_type）** - 用于个人中介下拉框
- [ ] **添加主体类型字典（dpc_entity_type）** - 用于机构中介下拉框
- [ ] **添加企业性质字典（dpc_enterprise_nature）** - 用于机构中介下拉框
- [ ] 添加数据来源字典（dpc_data_source）
- [ ] 添加人员类型字典（ccdi_person_type）
- [ ] 添加人员子类型字典（ccdi_person_sub_type）
- [ ] **添加性别字典（ccdi_indiv_gender）** - 用于个人中介下拉框
- [ ] **添加证件类型字典（ccdi_certificate_type）** - 用于个人中介下拉框
- [ ] **添加主体类型字典（ccdi_entity_type）** - 用于机构中介下拉框
- [ ] **添加企业性质字典（ccdi_enterprise_nature）** - 用于机构中介下拉框
- [ ] 添加数据来源字典（ccdi_data_source）
- [ ] 将 SQL 脚本保存到 `sql/` 目录
**验证方式**：SQL 语法检查