5 Commits

Author SHA1 Message Date
wkc
5d13f7cd01 参数配置 2026-02-25 16:56:04 +08:00
wkc
1437989d5b style: 使用 import 导入替代全限定类名
将代码中的全限定类名改为使用 import 语句导入,提升代码可读性
2026-02-25 06:34:22 +08:00
wkc
859d52bf96 fix: 修复遗漏的全限定类名引用
将 4 处使用旧包名的全限定类名更新为新包名 com.ruoyi.info.collection
2026-02-24 17:25:58 +08:00
wkc
1cd87d2695 refactor: 重命名 ruoyi-ccdi 模块为 ruoyi-info-collection
- Maven 模块从 ruoyi-ccdi 重命名为 ruoyi-info-collection
- Java 包名从 com.ruoyi.ccdi 改为 com.ruoyi.info.collection
- MyBatis XML 命名空间同步更新
- 保留数据库表名、API URL、权限标识中的 ccdi 前缀
- 更新项目文档中的模块引用
2026-02-24 17:12:11 +08:00
wkc
b126b43e2c 添加nas部署配置
优化md
2026-02-24 16:10:27 +08:00
218 changed files with 1904 additions and 5597 deletions

View File

@@ -108,7 +108,11 @@
"Skill(mcp-mysql-correct-db)",
"Bash(git diff:*)",
"Bash(git pull:*)",
"Bash(git merge:*)"
"Bash(git merge:*)",
"mcp__chrome-devtools-mcp__take_snapshot",
"mcp__chrome-devtools-mcp__fill",
"mcp__chrome-devtools-mcp__click",
"mcp__chrome-devtools-mcp__take_screenshot"
]
},
"enabledMcpjsonServers": [

715
CLAUDE.md
View File

@@ -1,327 +1,528 @@
# CLAUDE.md
## 分析
- 在进行需求分析类型的任务时,自动开启深度思考模式,输入 “think more”、“think a lot”、“think harder” 或 “think longer” 触发更深层的思考
- 在进行需求分析与分解任务时,按照不同的模块分为不同的文件,创建模块名的文件夹并将对应文件保存在文件夹中,然后对模块的功能文件进行继续分解
- 在使用/openspec:proposal时自动开启深度思考模式输入 “think more”、“think a lot”、“think harder” 或 “think longer” 触发更深层的思考
- 在执行/openspec:apply后使用code-simplifier 进行代码精简
- 在分析生成需求文档时每次都需要在doc目录下新建文件夹并以需求内容为命名
## Communication
- 永远使用简体中文进行思考和对话
## Documentation
- 编写 .md 文档时,也要用中文
- 所有生成的文档都放在项目根目录下的doc文件中。
## 数据库规范
- 新建表时,需要加上项目英文名首字母集合
## Coding
### Java Code Style
- 新建模块命名方式为项目英文名首字母集合+主要功能
- 新的功能代码与若依框架自带的代码分离新建模块controller层也要放在新建模块中
- 使用 `@Data` 注解保证代码的简洁
- 尽量使用 MyBatis Plus 进行 CRUD 操作(版本 3.5.10Spring Boot 3 适配版)
- 服务层中的使用@Resource注释,替代@Autowired
- 实体类不继承BaseEntity单独添加审计字段
- 完成后端代码controller层代码生成测试后在项目文件目录下生成API文档
- 接口传参需要使用单独的DTO不可以与entity混用
- 需要单独的VO类不可以与entity混用
- 审计字段通过添加注释的方式实现自动插入
- 简单的crud操作通过mybatis plus的方法实现复杂的操作通过xml中写sql和mapper映射实现
- 控制层所有接口需要正确的添加注释确保在swagger-ui中正确展示。控制层中任何接口发生变动及时同步到doc中的接口文档中
- 控制层分页接口使用mybatis plus page不要使用若依框架的分页
### 前端代码
- 在添加页面和组件后,注意与数据库中菜单表进行联动修改
- 前端组件代码需要组件化,复杂的组件需要进行拆分为单独的文件
## 运行
- 使用mcp:ccdi_intermediary_blacklist进行数据库相关操作
- 不要在命令行中启动后端进行测试
- 测试方式为生成可执行的测试脚本
- 测试脚本在运行完成后需要保存所有接口输出并生成测试用例报告
- /login/test接口可以传入username和password获取token用于测试验证接口的功能。
用于测试的账号username: admin password admin123
- swagger-ui的地址为/swagger-ui/index.html
- 在向doc文件夹添加文件时需要分门别类添加根据
This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
## Project Overview
## 快速参考
This is a **discipline preliminary check system** built on the **RuoYi (若依) v3.9.1** rapid development framework. It is an enterprise-grade management system using a front-end/back-end separated architecture.
**启动项目:**
- 后端: `mvn spring-boot:run` 或运行 `ry.bat`
- 前端: `cd ruoyi-ui && npm run dev`
### Technology Stack
**访问地址:**
- 前端: http://localhost:80
- 后端: http://localhost:8080
- Swagger: http://localhost:8080/swagger-ui/index.html
- Druid 监控: http://localhost:8080/druid/ (ruoyi/123456)
**Backend:**
- Spring Boot 3.5.8
- Spring Security + JWT (authentication)
- MyBatis 3.0.5 (ORM)
- MySQL 8.2.0
- Redis (caching)
- Quartz 2.5.2 (scheduled tasks)
- SpringDoc 2.8.14 (API documentation)
- Java 17
**Frontend:**
- Vue 2.6.12
- Element UI 2.15.14
- Vuex 3.6.0 (state management)
- Vue Router 3.4.9
- Axios 0.28.1
## Common Commands
### Backend (Maven)
**测试账号:**
- 用户名: `admin`
- 密码: `admin123`
**获取 Token:**
```bash
# Compile the project
mvn clean compile
# Run the application (development)
mvn spring-boot:run
# Package for deployment
mvn clean package
# Run using startup scripts
./ry.bat # Windows
./ry.sh start # Linux/Mac
POST http://localhost:8080/login/test?username=admin&password=admin123
```
### Frontend (npm)
---
## 项目概述
**纪检初核系统** - 基于 **若依管理系统 v3.9.1** 构建的企业级前后端分离管理系统,用于员工异常行为风险识别。
### 技术栈版本
| 后端技术 | 版本 | 前端技术 | 版本 |
|-----------------------------|--------|------------|---------|
| Spring Boot | 3.5.8 | Vue.js | 2.6.12 |
| Java | 17 | Element UI | 2.15.14 |
| MyBatis Spring Boot Starter | 3.0.5 | Vuex | 3.6.0 |
| MySQL Connector | 8.2.0 | Vue Router | 3.4.9 |
| SpringDoc OpenAPI | 2.8.14 | Axios | 0.28.1 |
| EasyExcel | 3.3.4 | ECharts | 5.4.0 |
| Quartz | 2.5.2 | Sass | 1.32.13 |
---
## 常用命令
### 后端 (Maven)
```bash
# 编译项目
mvn clean compile
# 运行应用 (开发环境)
mvn spring-boot:run
# 打包部署
mvn clean package
# Windows 启动
ry.bat
# Linux/Mac 启动
./ry.sh start
```
### 前端 (npm)
```bash
cd ruoyi-ui
# Install dependencies
npm install
# 安装依赖 (推荐使用国内镜像)
npm install --registry=https://registry.npmmirror.com
# Development server (runs on port 80 by default)
# 开发服务器 (端口 80)
npm run dev
# Production build
# 生产构建
npm run build:prod
# Staging build
npm run build:stage
# Preview production build
# 预览生产构建
npm run preview
```
### Database Initialization
### 数据库初始化
```bash
# Main database schema
# 初始化若依框架基础表
mysql -u root -p < sql/ry_20250522.sql
# Quartz scheduler tables
# 初始化定时任务表
mysql -u root -p < sql/quartz.sql
# 导入业务表(根据需要执行)
mysql -u root -p ccdi < sql/dpc_employee.sql
mysql -u root -p ccdi < sql/dpc_intermediary_blacklist.sql
# ... 其他业务表脚本
```
## Project Architecture
**注意:**
- 业务表脚本文件名以 `ccdi_``dpc_` 开头
- 部分脚本包含菜单数据,需要按顺序执行
- 数据库需要先创建(数据库名: `ccdi`
### Module Structure
---
## 模块架构
```
discipline-prelim-check/
├── ruoyi-admin/ # Main application entry point
├── ruoyi-framework/ # Core framework (Security, config, filters)
├── ruoyi-system/ # System management (Users, Roles, Menus, Depts)
├── ruoyi-common/ # Common utilities (annotations, utils, constants)
├── ruoyi-quartz/ # Scheduled task management
├── ruoyi-generator/ # Code generator (CRUD scaffolding)
├── ruoyi-ui/ # Frontend Vue application
├── sql/ # Database scripts
├── bin/ # Startup scripts
── openspec/ # OpenSpec specification workflow
ccdi/
├── ruoyi-admin/ # 主应用入口 (Spring Boot 启动类)
├── ruoyi-framework/ # 核心框架 (Security, Config, Filters)
├── ruoyi-system/ # 系统管理 (Users, Roles, Menus, Depts)
├── ruoyi-common/ # 通用工具 (annotations, utils, constants)
├── ruoyi-quartz/ # 定时任务
├── ruoyi-generator/ # 代码生成器
├── ruoyi-info-collection/ # 【核心业务模块】信息采集
├── ruoyi-ui/ # 前端 Vue 应用
├── sql/ # 数据库脚本
── bin/ # 启动脚本
└── doc/ # 项目文档
```
### Backend Architecture: MVC + Modular Design
The backend follows a standard MVC pattern with modular separation:
### 模块依赖关系
```
Controller Layer (ruoyi-admin/web/controller/)
├── common/ # Common controllers (captcha, file upload)
├── monitor/ # Monitoring controllers (cache, server, logs)
├── system/ # System management (users, roles, menus)
└── tool/ # Tools (code generator, swagger)
Service Layer (ruoyi-system/service/)
├── ISysUserService.java
├── ISysRoleService.java
└── ...
Mapper Layer (ruoyi-system/mapper/)
├── SysUserMapper.java
├── SysRoleMapper.java
└── ...
Domain Layer (ruoyi-system/domain/)
├── SysUser.java # Entity
├── vo/ # Value objects
└── ...
ruoyi-admin (启动模块)
├── ruoyi-framework (核心安全配置)
├── ruoyi-system (系统核心业务)
├── ruoyi-common (共享工具)
├── ruoyi-quartz (定时任务)
├── ruoyi-generator (代码生成)
└── ruoyi-info-collection (信息采集模块)
└── 依赖 ruoyi-common
```
### Frontend Architecture: Vue SPA
**添加新业务模块:**
1. 在根目录 `pom.xml``<modules>` 中添加新模块
2. 在新模块的 `pom.xml` 中添加对 `ruoyi-common` 的依赖
3.`ruoyi-admin/pom.xml` 中添加对新模块的依赖
4. 在新模块中按照分层规范创建 controller/service/mapper/domain 包
### ruoyi-info-collection 业务模块 (核心)
自定义业务模块,包含以下核心功能:
| 功能 | Controller | 实体类 |
|----------|---------------------------------------|-----------------------------|
| 员工基础信息 | CcdiBaseStaffController | CcdiBaseStaff |
| 中介黑名单 | CcdiIntermediaryController | CcdiBizIntermediary |
| 员工家庭关系 | CcdiStaffFmyRelationController | CcdiStaffFmyRelation |
| 员工企业关系 | CcdiStaffEnterpriseRelationController | CcdiStaffEnterpriseRelation |
| 信贷客户家庭关系 | CcdiCustFmyRelationController | CcdiCustFmyRelation |
| 信贷客户企业关系 | CcdiCustEnterpriseRelationController | CcdiCustEnterpriseRelation |
| 员工调动记录 | CcdiStaffTransferController | CcdiStaffTransfer |
| 员工招聘记录 | CcdiStaffRecruitmentController | CcdiStaffRecruitment |
| 采购交易 | CcdiPurchaseTransactionController | CcdiPurchaseTransaction |
**分层结构:**
- Controller: `ruoyi-info-collection/src/main/java/com/ruoyi/info/collection/controller/`
- Service: `ruoyi-info-collection/src/main/java/com/ruoyi/info/collection/service/`
- Mapper: `ruoyi-info-collection/src/main/java/com/ruoyi/info/collection/mapper/`
- Domain: `ruoyi-info-collection/src/main/java/com/ruoyi/info/collection/domain/`
- dto/: 数据传输对象
- vo/: 视图对象
- excel/: Excel导入导出实体
- XML映射: `ruoyi-info-collection/src/main/resources/mapper/info/collection/`
---
## 后端开发规范
### 通用规范
- **新模块命名**: 项目英文名首字母集合 + 主要功能 (如 `ruoyi-info-collection`)
- **代码分离**: 新功能代码与若依框架自带代码分离Controller 放在新模块中
- **审计字段**: 实体类不继承 BaseEntity单独添加审计字段通过注释实现自动插入
### Java 代码风格
```java
// 使用 @Data 注解
@Data
public class CcdiBaseStaff {
// 审计字段通过注释实现自动插入
/** 创建者 */
private String createBy;
/** 创建时间 */
private Date createTime;
/** 更新者 */
private String updateBy;
/** 更新时间 */
private Date updateTime;
}
// 服务层使用 @Resource 注入
@Resource
private ICcdiBaseStaffService baseStaffService;
```
### 分层规范
- **Controller**: 所有接口添加 Swagger 注释,分页使用 MyBatis Plus Page
- **Service**: 简单 CRUD 用 MyBatis Plus 方法,复杂操作在 XML 写 SQL
- **DTO/VO**: 接口传参使用独立 DTO返回使用独立 VO不与 entity 混用
- **Mapper**: 简单操作继承 BaseMapper复杂操作在 XML 中定义
### 禁止事项
- **禁止使用全限定类名**: 必须使用 `import` 语句导入类,不要在代码中使用 `java.util.List` 这样的全限定名
- **禁止使用 `extends ServiceImpl<>`**: Service 接口和实现类分离定义
- **禁止 Entity 混用**: DTO、VO、Excel 类必须独立,不与 Entity 混用
- **禁止缺少 `@Resource`**: Service 注入必须使用 `@Resource` 注解
### API 响应格式
```java
// 成功
AjaxResult.success("操作成功", data);
// 错误
AjaxResult.error("操作失败");
// 分页
Page<CcdiBaseStaff> page = new Page<>(pageNum, pageSize);
IPage<CcdiBaseStaff> result = baseStaffMapper.selectPage(page, queryWrapper);
return AjaxResult.success(result);
```
---
## 前端开发规范
### 目录结构
```
ruoyi-ui/src/
├── api/ # API request definitions
├── assets/ # Static resources (images, styles)
├── components/ # Reusable components
├── layout/ # Main layout (Sidebar, Navbar, TagsView)
├── router/ # Vue Router configuration
├── store/ # Vuex state management
├── utils/ # Utility functions
── views/ # Page components organized by feature
│ ├── dashboard/
│ ├── monitor/
│ ├── system/
│ └── tool/
└── permission.js # Permission directives
├── api/ # API 请求定义 (与后端 Controller 对应)
├── views/ # 页面组件 (按功能模块组织)
├── ccdiBaseStaff/
│ ├── ccdiIntermediary/
│ └── ...
├── components/ # 可复用组件 (复杂组件需拆分)
├── router/ # 路由配置
── store/ # Vuex 状态管理
```
### Module Dependencies
```
ruoyi-admin (startup module)
↓ depends on
ruoyi-framework (core security & config)
ruoyi-system (system core business)
ruoyi-common (shared utilities)
ruoyi-quartz (scheduled tasks)
ruoyi-generator (code generation)
```
## Key Development Patterns
### Code Generation Workflow
RuoYi provides a powerful code generator for rapid CRUD development:
1. **Create database table** - Design your table schema
2. **Import table** - Use System Tools → Code Generation → Import
3. **Configure** - Edit table info, generate info (module, function name, etc.)
4. **Generate code** - Download the generated zip
5. **Copy files** - Extract to appropriate directories:
- Backend: `ruoyi-admin/web/controller/`, service, mapper files
- Frontend: `ruoyi-ui/src/views/`, `ruoyi-ui/src/api/`
### Permission System
The permission system uses **Role-Menu-Button** hierarchy:
- **Menus**: Define navigation items and route permissions
- **Roles**: Assign menu permissions to roles
- **Users**: Assign roles to users
- **Data Permissions**: Control data scope (all, custom, department, etc.)
Permission keys in code use format: `system:user:edit`, `system:user:remove`, etc.
### API Response Format
All API responses use `AjaxResult` wrapper:
```java
// Success
AjaxResult.success("操作成功", data);
// Error
AjaxResult.error("操作失败");
// Custom
AjaxResult.put("key", value);
```
### Frontend API Calls
API calls are defined in `ruoyi-ui/src/api/`:
### API 调用示例
```javascript
import request from '@/utils/request'
export function listUser(query) {
export function listStaff(query) {
return request({
url: '/system/user/list',
url: '/ccdi/baseStaff/list',
method: 'get',
params: query
})
}
```
export function addUser(data) {
return request({
url: '/system/user',
method: 'post',
data: data
})
### 菜单联动
添加页面和组件后,需要同步修改数据库中的菜单表 (`sys_menu`)。
---
## 特殊功能
### 异步导入
支持大数据量异步 Excel 导入,通过 taskId 查询导入状态:
```java
@PostMapping("/import")
public AjaxResult asyncImport(@RequestParam("file") MultipartFile file) {
String taskId = asyncImportService.startImport(file);
return AjaxResult.success("导入任务已启动", taskId);
}
@GetMapping("/import/status/{taskId}")
public AjaxResult getImportStatus(@PathVariable String taskId) {
return AjaxResult.success(asyncImportService.getStatus(taskId));
}
```
## OpenSpec Workflow
**导入流程:**
1. 前端上传 Excel 文件
2. 后端异步处理,返回 taskId
3. 前端轮询 `/import/status/{taskId}` 获取导入进度
4. 导入完成后,可获取成功/失败数据统计
This project uses **OpenSpec** for specification-driven development. Always reference `openspec/AGENTS.md` when:
**导入结果处理:**
- 只返回导入失败的数据(含失败原因)
- 成功数据不返回,减少响应体积
- 支持批量插入,提高性能
- Planning or proposing new features
- Making breaking changes
- Modifying architecture
- Handling ambiguous requirements
### EasyExcel 字典下拉框
### Key OpenSpec Commands
导入模板支持字典下拉框配置,提升数据录入准确性。使用 `DictDropdownWriteHandler` 实现。
### 权限控制
基于 Spring Security + JWT 的角色菜单权限系统:
- 权限格式: `system:user:edit`, `ccdi:staff:list`
- 数据权限: 支持全部、自定义、部门等范围
---
## 测试与验证
### 测试账号
- **用户名**: `admin`
- **密码**: `admin123`
### 登录获取 Token
```bash
# List active changes
openspec list
# List all specifications
openspec list --specs
# View details
openspec show [change-id or spec-id]
# Validate changes
openspec validate [change-id] --strict --no-interactive
# Archive completed changes
openspec archive <change-id>
# 登录接口
POST /login/test?username=admin&password=admin123
```
### When to Create Proposals
### API 文档
**Create proposal for:**
- New features or capabilities
- Breaking changes (API, schema)
- Architecture changes
- Performance optimizations that change behavior
- **Swagger UI**: `/swagger-ui/index.html`
- **API Docs**: `/v3/api-docs`
**Skip proposal for:**
- Bug fixes (restoring intended behavior)
- Typos, formatting, comments
- Non-breaking dependency updates
- Configuration changes
### 测试规范
## Configuration Notes
- 不在命令行启动后端进行测试
- 生成可执行的测试脚本进行验证
- 测试完成后保存接口输出并生成测试用例报告
- **Default Admin**: `admin/admin123`
- **Backend Port**: 8080
- **Frontend Dev Port**: 80
- **API Base Path**: Configured in `ruoyi-ui/vue.config.js` proxy
- **Database Config**: `ruoyi-admin/src/main/resources/application.yml`
### 开发调试技巧
## Important File Locations
**使用 Swagger 测试接口:**
1. 访问 `/swagger-ui/index.html`
2. 点击接口展开详情
3. 点击 "Try it out" 进行测试
4. 填写参数后点击 "Execute" 执行
| Purpose | Location |
|---------|----------|
| Main application entry | [ruoyi-admin/src/main/java/com/ruoyi/RuoYiApplication.java](ruoyi-admin/src/main/java/com/ruoyi/RuoYiApplication.java) |
| Security configuration | [ruoyi-framework/src/main/java/com/ruoyi/framework/config/SecurityConfig.java](ruoyi-framework/src/main/java/com/ruoyi/framework/config/SecurityConfig.java) |
| Database config | [ruoyi-admin/src/main/resources/application.yml](ruoyi-admin/src/main/resources/application.yml) |
| MyBatis mappers | [ruoyi-system/src/main/resources/mapper/system/](ruoyi-system/src/main/resources/mapper/system/) |
| Vue router | [ruoyi-ui/src/router/index.js](ruoyi-ui/src/router/index.js) |
| Vuex store | [ruoyi-ui/src/store/](ruoyi-ui/src/store/) |
**查看 SQL 执行日志:**
-`application.yml` 中设置日志级别: `com.ruoyi: debug`
- 使用 Druid 监控台查看慢 SQL
**前端代理配置:**
前端开发服务器通过代理转发请求到后端:
- 前端地址: `http://localhost:80`
- 后端地址: `http://localhost:8080`
- 代理配置文件: `ruoyi-ui/vue.config.js`
---
## 配置说明
| 配置项 | 值 |
|---------|-------------------|
| 后端端口 | 8080 |
| 前端开发端口 | 80 |
| 默认管理员 | admin/admin123 |
| JWT 有效期 | 30 分钟 |
| 文件上传限制 | 单文件 10MB, 总计 20MB |
### 配置文件位置
| 配置 | 路径 |
|----------|------------------------------------------------------|
| 主配置 | `ruoyi-admin/src/main/resources/application.yml` |
| 开发环境 | `ruoyi-admin/src/main/resources/application-dev.yml` |
| 数据库连接 | `application-dev.yml` |
| Redis 配置 | `application-dev.yml` |
### 数据源配置
项目使用 Druid 连接池,支持主从分离(默认关闭从库):
- **数据库连接**: `jdbc:mysql://host:3306/ccdi`
- **初始连接数**: 5
- **最小连接数**: 10
- **最大连接数**: 20
- **慢 SQL 记录**: 超过 1000ms 的 SQL 会被记录
### Redis 配置
- **默认端口**: 6379
- **数据库索引**: 0
- **连接超时**: 10s
### Druid 监控台
访问地址: `http://localhost:8080/druid/`
- 用户名: `ruoyi`
- 密码: `123456`
用于监控 SQL 执行情况、连接池状态等。
---
## 重要文件路径
| 用途 | 路径 |
|---------------|--------------------------------------------------------------------------------|
| 应用入口 | `ruoyi-admin/src/main/java/com/ruoyi/RuoYiApplication.java` |
| 安全配置 | `ruoyi-framework/src/main/java/com/ruoyi/framework/config/SecurityConfig.java` |
| 业务 Controller | `ruoyi-info-collection/src/main/java/com/ruoyi/info/collection/controller/` |
| 业务 Mapper XML | `ruoyi-info-collection/src/main/resources/mapper/info/collection/` |
| Vue 路由 | `ruoyi-ui/src/router/index.js` |
| Vuex Store | `ruoyi-ui/src/store/` |
| 前端 API | `ruoyi-ui/src/api/` |
---
## 数据库规范
- **新建表名**: 需要加上项目英文名首字母集合前缀 `ccdi_` (如 `ccdi_base_staff`)
---
## 文档管理
- **文档语言**: 使用简体中文编写 .md 文档
- **文档目录**: 所有生成的文档放在 `doc/` 目录下,按类型分类
- **需求分析**: 在 `doc/` 目录下新建文件夹,以需求内容命名
### doc 目录结构
```
doc/
├── api-docs/ # API 文档
├── database/ # 数据库相关
├── design/ # 设计文档
├── implementation/ # 实施文档
├── requirements/ # 需求文档
└── test-scripts/ # 测试脚本
```
---
## OpenSpec 工作流
项目使用 OpenSpec 进行规范驱动开发,参考 `openspec/AGENTS.md`
### 何时创建 Proposal
**需要创建:**
- 新功能或能力
- 破坏性变更 (API, 数据库结构)
- 架构变更
- 改变行为的性能优化
**无需创建:**
- Bug 修复 (恢复预期行为)
- 拼写错误、格式、注释
- 非破坏性依赖更新
- 配置变更
---
## 沟通规范
- 永远使用简体中文进行思考和对话
---
## 常见问题排查
### 数据库连接失败
**检查项:**
1. 确认 MySQL 服务已启动
2. 检查 `application-dev.yml` 中的数据库连接配置
3. 确认数据库用户名和密码正确
4. 检查数据库是否已创建(数据库名: `ccdi`
### Redis 连接失败
**检查项:**
1. 确认 Redis 服务已启动
2. 检查 `application-dev.yml` 中的 Redis 配置
3. 如果 Redis 不需要密码,将 `password` 配置注释掉
### 前端无法访问后端接口
**检查项:**
1. 确认后端已启动(端口 8080
2. 检查前端代理配置(`ruoyi-ui/vue.config.js`
3. 确认后端接口路径正确(查看 Controller 的 `@RequestMapping`
### 导入功能无响应
**检查项:**
1. 检查文件大小是否超过限制(默认 10MB
2. 查看后端日志是否有异常
3. 确认 Excel 模板格式正确
4. 检查必填字段是否为空
---
## MyBatis Plus 分页使用
```java
// Controller 层
@GetMapping("/list")
public TableDataInfo list(QueryDTO queryDTO) {
PageDomain pageDomain = TableSupport.buildPageRequest();
Page<VO> page = new Page<>(pageDomain.getPageNum(), pageDomain.getPageSize());
Page<VO> result = service.selectPage(page, queryDTO);
return getDataTable(result.getRecords(), result.getTotal());
}
// Service 层
Page<VO> selectPage(Page<VO> page, QueryDTO queryDTO);
// Mapper 层 (使用 XML)
<select id="selectPage" resultType="VO">
SELECT * FROM table_name
<where>
<if test="queryDTO.name != null">
AND name LIKE CONCAT('%', #{queryDTO.name}, '%')
</if>
</where>
</select>
```

View File

@@ -72,7 +72,7 @@ SHOW INDEX FROM ccdi_base_staff WHERE Key_name = 'idx_id_card';
2026-02-11
### 执行内容
修改文件: `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/domain/vo/CcdiStaffEnterpriseRelationVO.java`
修改文件: `ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/domain/vo/CcdiStaffEnterpriseRelationVO.java`
添加字段:
```java
@@ -98,7 +98,7 @@ private String personName;
2026-02-11
### 执行内容
修改文件: `ruoyi-ccdi/src/main/resources/mapper/ccdi/CcdiStaffEnterpriseRelationMapper.xml`
修改文件: `ruoyi-info-collection/src/main/resources/mapper/ccdi/CcdiStaffEnterpriseRelationMapper.xml`
#### 1. 更新ResultMap
添加字段映射:
@@ -134,7 +134,7 @@ LEFT JOIN ccdi_base_staff bs ON ser.person_id = bs.id_card
2026-02-11
### 执行内容
修改文件: `ruoyi-ccdi/src/main/resources/mapper/ccdi/CcdiStaffEnterpriseRelationMapper.xml`
修改文件: `ruoyi-info-collection/src/main/resources/mapper/ccdi/CcdiStaffEnterpriseRelationMapper.xml`
更新selectRelationById查询:
```xml

View File

@@ -7,7 +7,7 @@
2026-02-09
## 实现位置
- 文件: `D:\ccdi\ccdi\ruoyi-ccdi\src\main\java\com\ruoyi\ccdi\service\impl\CcdiEmployeeImportServiceImpl.java`
- 文件: `D:\ccdi\ccdi\ruoyi-info-collection\src\main\java\com\ruoyi\ccdi\service\impl\CcdiEmployeeImportServiceImpl.java`
- 方法: `importEmployeeAsync` (第43-126行)
## 核心功能

View File

@@ -20,7 +20,7 @@ Error updating database. Cause: java.sql.SQLIntegrityConstraintViolationExceptio
### 1. 代码修改
**文件**[CcdiIntermediaryBlacklistServiceImpl.java](d:\discipline-prelim-check\discipline-prelim-check\ruoyi-ccdi\src\main\java\com\ruoyi\dpc\service\impl\CcdiIntermediaryBlacklistServiceImpl.java)
**文件**[CcdiIntermediaryBlacklistServiceImpl.java](d:\discipline-prelim-check\discipline-prelim-check\ruoyi-info-collection\src\main\java\com\ruoyi\dpc\service\impl\CcdiIntermediaryBlacklistServiceImpl.java)
**修改位置**:第 390-394 行
@@ -44,7 +44,7 @@ intermediary.setIntermediaryType("2");
### 2. 验证逻辑增强
**文件**[CcdiIntermediaryBlacklistServiceImpl.java](d:\discipline-prelim-check\discipline-prelim-check\ruoyi-ccdi\src\main\java\com\ruoyi\dpc\service\impl\CcdiIntermediaryBlacklistServiceImpl.java)
**文件**[CcdiIntermediaryBlacklistServiceImpl.java](d:\discipline-prelim-check\discipline-prelim-check\ruoyi-info-collection\src\main\java\com\ruoyi\dpc\service\impl\CcdiIntermediaryBlacklistServiceImpl.java)
**修改位置**:第 484-488 行
@@ -72,7 +72,7 @@ private void validateEntityIntermediaryData(CcdiIntermediaryEntityExcel excel) {
### 3. 批量更新 XML 配置优化
**文件**[CcdiIntermediaryBlacklistMapper.xml](d:\discipline-prelim-check\discipline-prelim-check\ruoyi-ccdi\src\main\resources\mapper\dpc\CcdiIntermediaryBlacklistMapper.xml)
**文件**[CcdiIntermediaryBlacklistMapper.xml](d:\discipline-prelim-check\discipline-prelim-check\ruoyi-info-collection\src\main\resources\mapper\dpc\CcdiIntermediaryBlacklistMapper.xml)
**修改位置**:第 125-127 行
@@ -151,8 +151,8 @@ WHERE intermediary_type = '2' AND certificate_no IS NULL AND corp_credit_code IS
## 修改文件列表
1. [CcdiIntermediaryBlacklistServiceImpl.java](d:\discipline-prelim-check\discipline-prelim-check\ruoyi-ccdi\src\main\java\com\ruoyi\dpc\service\impl\CcdiIntermediaryBlacklistServiceImpl.java) - 服务层实现
2. [CcdiIntermediaryBlacklistMapper.xml](d:\discipline-prelim-check\discipline-prelim-check\ruoyi-ccdi\src\main\resources\mapper\dpc\CcdiIntermediaryBlacklistMapper.xml) - MyBatis 映射文件
1. [CcdiIntermediaryBlacklistServiceImpl.java](d:\discipline-prelim-check\discipline-prelim-check\ruoyi-info-collection\src\main\java\com\ruoyi\dpc\service\impl\CcdiIntermediaryBlacklistServiceImpl.java) - 服务层实现
2. [CcdiIntermediaryBlacklistMapper.xml](d:\discipline-prelim-check\discipline-prelim-check\ruoyi-info-collection\src\main\resources\mapper\dpc\CcdiIntermediaryBlacklistMapper.xml) - MyBatis 映射文件
3. [test_import_fix.py](d:\discipline-prelim-check\discipline-prelim-check\doc\test-data\test_import_fix.py) - 测试脚本
## 版本历史

View File

@@ -5,7 +5,7 @@
## 审查范围
- 前端:`ruoyi-ui/src/views/ccdiStaffEnterpriseRelation/index.vue`
- 后端:`ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/` 相关文件
- 后端:`ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/` 相关文件
## 严重问题(必须立即修复)

View File

@@ -360,20 +360,20 @@ VALUES
| 类型 | 文件路径 |
|------|---------|
| Controller | `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/controller/CcdiStaffEnterpriseRelationController.java` |
| Service接口 | `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/service/ICcdiStaffEnterpriseRelationService.java` |
| Service实现 | `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/service/impl/CcdiStaffEnterpriseRelationServiceImpl.java` |
| ImportService接口 | `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/service/ICcdiStaffEnterpriseRelationImportService.java` |
| ImportService实现 | `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/service/impl/CcdiStaffEnterpriseRelationImportServiceImpl.java` |
| Mapper接口 | `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/mapper/CcdiStaffEnterpriseRelationMapper.java` |
| Mapper XML | `ruoyi-ccdi/src/main/resources/mapper/ccdi/CcdiStaffEnterpriseRelationMapper.xml` |
| Entity | `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/domain/CcdiStaffEnterpriseRelation.java` |
| DTO (Add) | `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/domain/dto/CcdiStaffEnterpriseRelationAddDTO.java` |
| DTO (Edit) | `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/domain/dto/CcdiStaffEnterpriseRelationEditDTO.java` |
| DTO (Query) | `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/domain/dto/CcdiStaffEnterpriseRelationQueryDTO.java` |
| VO | `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/domain/vo/CcdiStaffEnterpriseRelationVO.java` |
| Excel | `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/domain/excel/CcdiStaffEnterpriseRelationExcel.java` |
| ImportFailureVO | `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/domain/vo/StaffEnterpriseRelationImportFailureVO.java` |
| Controller | `ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/controller/CcdiStaffEnterpriseRelationController.java` |
| Service接口 | `ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/service/ICcdiStaffEnterpriseRelationService.java` |
| Service实现 | `ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/service/impl/CcdiStaffEnterpriseRelationServiceImpl.java` |
| ImportService接口 | `ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/service/ICcdiStaffEnterpriseRelationImportService.java` |
| ImportService实现 | `ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/service/impl/CcdiStaffEnterpriseRelationImportServiceImpl.java` |
| Mapper接口 | `ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/mapper/CcdiStaffEnterpriseRelationMapper.java` |
| Mapper XML | `ruoyi-info-collection/src/main/resources/mapper/ccdi/CcdiStaffEnterpriseRelationMapper.xml` |
| Entity | `ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/domain/CcdiStaffEnterpriseRelation.java` |
| DTO (Add) | `ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/domain/dto/CcdiStaffEnterpriseRelationAddDTO.java` |
| DTO (Edit) | `ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/domain/dto/CcdiStaffEnterpriseRelationEditDTO.java` |
| DTO (Query) | `ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/domain/dto/CcdiStaffEnterpriseRelationQueryDTO.java` |
| VO | `ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/domain/vo/CcdiStaffEnterpriseRelationVO.java` |
| Excel | `ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/domain/excel/CcdiStaffEnterpriseRelationExcel.java` |
| ImportFailureVO | `ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/domain/vo/StaffEnterpriseRelationImportFailureVO.java` |
---

View File

@@ -67,7 +67,7 @@
### 修复1后端强制设置默认状态
**修改文件:** `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/service/impl/CcdiStaffEnterpriseRelationServiceImpl.java`
**修改文件:** `ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/service/impl/CcdiStaffEnterpriseRelationServiceImpl.java`
**修改内容:**
```java
@@ -144,7 +144,7 @@ dicts: ['ccdi_relation_status', 'ccdi_data_source'],
### 修改文件清单
1. `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/service/impl/CcdiStaffEnterpriseRelationServiceImpl.java`
1. `ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/service/impl/CcdiStaffEnterpriseRelationServiceImpl.java`
2. `ruoyi-ui/src/views/ccdiStaffEnterpriseRelation/index.vue`
### 数据库变更

View File

@@ -258,7 +258,7 @@ python doc/test-data/intermediary/test_import_performance.py
## 相关文件
### 后端文件
- `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/service/impl/CcdiIntermediaryServiceImpl.java:245-488`
- `ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/service/impl/CcdiIntermediaryServiceImpl.java:245-488`
### 数据库表
- `ccdi_biz_intermediary` - 个人中介表

View File

@@ -482,8 +482,8 @@ handleImportComplete(statusResult) {
### 相关文件
- **前端组件:** `ruoyi-ui/src/views/ccdiEmployee/index.vue`
- **API定义:** `ruoyi-ui/src/api/ccdiEmployee.js`
- **后端VO:** `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/domain/vo/ImportStatusVO.java`
- **后端Controller:** `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/controller/CcdiEmployeeController.java`
- **后端VO:** `ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/domain/vo/ImportStatusVO.java`
- **后端Controller:** `ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/controller/CcdiEmployeeController.java`
### 测试文件
- **浏览器测试:** `doc/员工导入状态持久化功能测试.html`

View File

@@ -0,0 +1,93 @@
# ruoyi-ccdi 模块重命名设计文档
## 概述
`ruoyi-ccdi` 模块重命名为 `ruoyi-info-collection`,以更清晰地表达"信息采集"功能,同时保持与其他功能模块的命名一致性。
## 设计决策
### 方案选择:混合命名(方案 A
| 项目 | 当前命名 | 目标命名 |
|-----|---------|---------|
| Maven 模块 | `ruoyi-ccdi` | `ruoyi-info-collection` |
| Java 包名 | `com.ruoyi.ccdi` | `com.ruoyi.info.collection` |
| 数据库表 | `ccdi_*` | `ccdi_*` (保持不变) |
| API URL | `/ccdi/*` | `/ccdi/*` (保持不变) |
| 权限标识 | `ccdi:*:*` | `ccdi:*:*` (保持不变) |
| 前端文件 | `ccdi*` | `ccdi*` (保持不变) |
### 选择理由
1. **模块名和包名**:更清晰表达"信息采集"功能
2. **保留 ccdi 前缀**:在 URL、表名、前端避免破坏性变更
3. **数据库不变**:无需迁移数据,降低风险
4. **API 不变**:前端调用无需修改
## 修改清单
### 1. Maven 模块重命名
| 文件 | 修改内容 |
|-----|---------|
| `pom.xml` (根目录) | `<module>ruoyi-ccdi</module>``<module>ruoyi-info-collection</module>` |
| `pom.xml` (根目录) | `<artifactId>ruoyi-ccdi</artifactId>``<artifactId>ruoyi-info-collection</artifactId>` |
| `ruoyi-ccdi/pom.xml` | 目录重命名为 `ruoyi-info-collection/``<artifactId>` 同步修改 |
| `ruoyi-admin/pom.xml` | `<artifactId>ruoyi-ccdi</artifactId>``<artifactId>ruoyi-info-collection</artifactId>` |
### 2. Java 包名重命名
- **目录结构**`com/ruoyi/ccdi/``com/ruoyi/info/collection/`
- **涉及文件**:约 100+ 个 Java 文件
- **修改内容**
- 所有 `package com.ruoyi.ccdi``package com.ruoyi.info.collection`
- 所有 `import com.ruoyi.ccdi.*``import com.ruoyi.info.collection.*`
### 3. MyBatis XML 命名空间
- **涉及文件**11 个 Mapper XML 文件
- **修改内容**:命名空间从 `com.ruoyi.ccdi.mapper.*` 改为 `com.ruoyi.info.collection.mapper.*`
### 4. 项目文档修改
- **涉及文件**`doc/` 目录下约 135 个文件
- **修改内容**:将 `ruoyi-ccdi` 模块引用改为 `ruoyi-info-collection`
## 不修改的内容
- 数据库表名 (`ccdi_*`)
- 数据库名 (`ccdi`)
- API URL 路径 (`/ccdi/*`)
- 权限标识 (`ccdi:*:*`)
- 前端 API 文件和视图目录
- 菜单配置数据
## 执行步骤
1. 重命名模块目录 `ruoyi-ccdi/``ruoyi-info-collection/`
2. 修改 Maven 配置文件
3. 批量修改 Java 包名
4. 修改 MyBatis XML 命名空间
5. 更新项目文档
6. 验证编译 `mvn clean compile`
## 风险评估
- **风险等级**:中
- **主要风险**:包名修改涉及大量文件,可能遗漏
- **缓解措施**
- 使用 IDE 的重构功能
- 编译验证确保无遗漏
- 执行单元测试
## 验收标准
1. Maven 编译成功 (`mvn clean compile`)
2. 所有 Java 文件包名正确
3. MyBatis XML 命名空间正确
4. 文档中模块名称已更新
---
**设计日期**2026-02-24
**设计状态**:已批准

View File

@@ -0,0 +1,331 @@
# ruoyi-ccdi 模块重命名实施计划
> **For Claude:** REQUIRED SUB-SKILL: Use superpowers:executing-plans to implement this plan task-by-task.
**Goal:** 将 ruoyi-ccdi 模块重命名为 ruoyi-info-collection同时将 Java 包名从 com.ruoyi.ccdi 改为 com.ruoyi.info.collection
**Architecture:** Maven 模块重命名 + Java 包结构重组 + MyBatis XML 命名空间更新。保留数据库表名、API URL、权限标识和前端文件中的 ccdi 前缀不变。
**Tech Stack:** Maven, Java 17, MyBatis Plus, Spring Boot 3
---
## Task 1: 重命名模块目录
**Files:**
- Rename: `ruoyi-ccdi/``ruoyi-info-collection/`
**Step 1: 使用 git mv 重命名目录**
```bash
git mv ruoyi-ccdi ruoyi-info-collection
```
**Step 2: 验证目录已重命名**
Run: `ls -la | grep ruoyi-info-collection`
Expected: 显示 `ruoyi-info-collection` 目录
---
## Task 2: 修改根 pom.xml 模块声明
**Files:**
- Modify: `pom.xml`
**Step 1: 修改 module 声明**
找到 `<module>ruoyi-ccdi</module>` 并修改为:
```xml
<module>ruoyi-info-collection</module>
```
**Step 2: 修改 dependencyManagement 中的 artifactId**
找到 ruoyi-ccdi 的依赖声明并修改为:
```xml
<!-- 信息采集模块-->
<dependency>
<groupId>com.ruoyi</groupId>
<artifactId>ruoyi-info-collection</artifactId>
<version>${ruoyi.version}</version>
</dependency>
```
**Step 3: 验证修改**
Run: `grep -n "ruoyi-info-collection" pom.xml`
Expected: 显示 2 处匹配module 和 dependency
---
## Task 3: 修改 ruoyi-info-collection 模块 pom.xml
**Files:**
- Modify: `ruoyi-info-collection/pom.xml`
**Step 1: 修改 artifactId 和 description**
```xml
<artifactId>ruoyi-info-collection</artifactId>
<description>信息采集模块</description>
```
**Step 2: 验证修改**
Run: `grep -n "artifactId" ruoyi-info-collection/pom.xml | head -1`
Expected: `<artifactId>ruoyi-info-collection</artifactId>`
---
## Task 4: 修改 ruoyi-admin 的依赖声明
**Files:**
- Modify: `ruoyi-admin/pom.xml`
**Step 1: 修改依赖 artifactId**
找到 ruoyi-ccdi 依赖并修改为:
```xml
<!-- 信息采集模块-->
<dependency>
<groupId>com.ruoyi</groupId>
<artifactId>ruoyi-info-collection</artifactId>
</dependency>
```
**Step 2: 验证修改**
Run: `grep -n "ruoyi-info-collection" ruoyi-admin/pom.xml`
Expected: 显示 1 处匹配
---
## Task 5: 创建新的包目录结构
**Files:**
- Create: `ruoyi-info-collection/src/main/java/com/ruoyi/info/collection/`
- Create: `ruoyi-info-collection/src/main/resources/mapper/info/collection/`
**Step 1: 创建 Java 包目录**
```bash
mkdir -p ruoyi-info-collection/src/main/java/com/ruoyi/info/collection
```
**Step 2: 创建 MyBatis mapper 目录**
```bash
mkdir -p ruoyi-info-collection/src/main/resources/mapper/info/collection
```
**Step 3: 验证目录创建**
Run: `ls -la ruoyi-info-collection/src/main/java/com/ruoyi/info/`
Expected: 显示 `collection` 目录
---
## Task 6: 移动 Java 源码到新包结构
**Files:**
- Move: `ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/*``ruoyi-info-collection/src/main/java/com/ruoyi/info/collection/`
**Step 1: 移动所有子目录**
```bash
cd ruoyi-info-collection/src/main/java/com/ruoyi
mv ccdi/* info/collection/
```
**Step 2: 删除旧目录**
```bash
rm -rf ccdi
```
**Step 3: 验证新结构**
Run: `ls ruoyi-info-collection/src/main/java/com/ruoyi/info/collection/`
Expected: 显示 controller, domain, enums, mapper, service, utils 等目录
---
## Task 7: 批量修改 Java 文件包名声明
**Files:**
- Modify: `ruoyi-info-collection/src/main/java/com/ruoyi/info/collection/**/*.java` (约 100+ 文件)
**Step 1: 批量替换 package 声明**
```bash
find ruoyi-info-collection/src/main/java -name "*.java" -exec sed -i 's/package com\.ruoyi\.ccdi/package com.ruoyi.info.collection/g' {} +
```
**Step 2: 批量替换 import 语句**
```bash
find ruoyi-info-collection/src/main/java -name "*.java" -exec sed -i 's/import com\.ruoyi\.ccdi/import com.ruoyi.info.collection/g' {} +
```
**Step 3: 验证包名修改**
Run: `grep -r "package com.ruoyi.ccdi" ruoyi-info-collection/src/main/java/`
Expected: 无输出(所有旧的包名已替换)
---
## Task 8: 移动 MyBatis XML 文件
**Files:**
- Move: `ruoyi-info-collection/src/main/resources/mapper/ccdi/*``ruoyi-info-collection/src/main/resources/mapper/info/collection/`
**Step 1: 移动 XML 文件**
```bash
cd ruoyi-info-collection/src/main/resources/mapper
mkdir -p info/collection
mv ccdi/* info/collection/
rm -rf ccdi
```
**Step 2: 验证文件移动**
Run: `ls ruoyi-info-collection/src/main/resources/mapper/info/collection/`
Expected: 显示 11 个 XML 文件
---
## Task 9: 修改 MyBatis XML 命名空间
**Files:**
- Modify: `ruoyi-info-collection/src/main/resources/mapper/info/collection/*.xml` (11 文件)
**Step 1: 批量替换命名空间**
```bash
find ruoyi-info-collection/src/main/resources/mapper -name "*.xml" -exec sed -i 's/com\.ruoyi\.ccdi/com.ruoyi.info.collection/g' {} +
```
**Step 2: 验证命名空间修改**
Run: `grep -r "com.ruoyi.ccdi" ruoyi-info-collection/src/main/resources/mapper/`
Expected: 无输出(所有旧的命名空间已替换)
---
## Task 10: 更新 CLAUDE.md 项目文档
**Files:**
- Modify: `CLAUDE.md`
**Step 1: 更新模块架构描述**
将所有 `ruoyi-ccdi` 引用改为 `ruoyi-info-collection`,包括:
- 模块架构图
- 模块依赖关系
- ruoyi-ccdi 业务模块描述
- 重要文件路径
**Step 2: 验证修改**
Run: `grep "ruoyi-ccdi" CLAUDE.md`
Expected: 无输出(所有引用已更新)
---
## Task 11: 更新 doc 目录下的文档
**Files:**
- Modify: `doc/**/*.md` (约 135 文件)
**Step 1: 批量替换模块名引用**
```bash
find doc -name "*.md" -exec sed -i 's/ruoyi-ccdi/ruoyi-info-collection/g' {} +
```
**Step 2: 验证修改**
Run: `grep -r "ruoyi-ccdi" doc/`
Expected: 仅在设计文档中保留历史记录
---
## Task 12: 验证 Maven 编译
**Files:**
- None (验证步骤)
**Step 1: 清理并编译**
```bash
mvn clean compile
```
Expected: BUILD SUCCESS
**Step 2: 如果编译失败,检查错误**
常见的编译错误:
- 遗漏的 import 语句
- 遗漏的包名声明
- MyBatis XML 命名空间不匹配
---
## Task 13: 提交更改
**Files:**
- None (Git 操作)
**Step 1: 查看更改**
```bash
git status
git diff --stat
```
**Step 2: 添加所有更改**
```bash
git add -A
```
**Step 3: 提交**
```bash
git commit -m "$(cat <<'EOF'
refactor: 重命名 ruoyi-ccdi 模块为 ruoyi-info-collection
- Maven 模块从 ruoyi-ccdi 重命名为 ruoyi-info-collection
- Java 包名从 com.ruoyi.ccdi 改为 com.ruoyi.info.collection
- MyBatis XML 命名空间同步更新
- 保留数据库表名、API URL、权限标识中的 ccdi 前缀
- 更新项目文档中的模块引用
EOF
)"
```
---
## 验收清单
- [ ] 模块目录已重命名为 `ruoyi-info-collection`
- [ ] 所有 pom.xml 中的 artifactId 已更新
- [ ] Java 包结构已重组为 `com.ruoyi.info.collection`
- [ ] 所有 Java 文件的 package 声明已更新
- [ ] 所有 Java 文件的 import 语句已更新
- [ ] MyBatis XML 文件已移动到新目录
- [ ] MyBatis XML 命名空间已更新
- [ ] 项目文档已更新
- [ ] Maven 编译成功
- [ ] 更改已提交到 Git
---
**计划日期**: 2026-02-24
**预计任务数**: 13

View File

@@ -80,7 +80,7 @@ CREATE TABLE `ccdi_staff_recruitment` (
### 3.1 模块结构
```
ruoyi-ccdi/
ruoyi-info-collection/
├── domain/
│ ├── CcdiStaffRecruitment.java # 实体类
│ ├── dto/

View File

@@ -391,5 +391,5 @@ Element UI 的 MessageBox 组件有较高的CSS优先级必须使用 `!import
### 8.2 相关文件
- 前端组件: `ruoyi-ui/src/views/ccdiEmployee/index.vue`
- 后端服务: `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/service/impl/CcdiEmployeeServiceImpl.java`
- 后端服务: `ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/service/impl/CcdiEmployeeServiceImpl.java`
- API文档: `doc/api/ccdiEmployee.md`

View File

@@ -13,7 +13,7 @@
## Task 1: 创建个人中介Entity实体类
**Files:**
- Create: `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/domain/CcdiBizIntermediary.java`
- Create: `ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/domain/CcdiBizIntermediary.java`
**Step 1: 创建CcdiBizIntermediary实体类**
@@ -116,7 +116,7 @@ public class CcdiBizIntermediary implements Serializable {
**Step 2: 提交代码**
```bash
git add ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/domain/CcdiBizIntermediary.java
git add ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/domain/CcdiBizIntermediary.java
git commit -m "feat: 添加个人中介实体类CcdiBizIntermediary"
```
@@ -125,7 +125,7 @@ git commit -m "feat: 添加个人中介实体类CcdiBizIntermediary"
## Task 2: 创建实体中介Entity实体类
**Files:**
- Create: `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/domain/CcdiEnterpriseBaseInfo.java`
- Create: `ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/domain/CcdiEnterpriseBaseInfo.java`
**Step 1: 创建CcdiEnterpriseBaseInfo实体类**
@@ -234,7 +234,7 @@ public class CcdiEnterpriseBaseInfo implements Serializable {
**Step 2: 提交代码**
```bash
git add ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/domain/CcdiEnterpriseBaseInfo.java
git add ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/domain/CcdiEnterpriseBaseInfo.java
git commit -m "feat: 添加实体中介实体类CcdiEnterpriseBaseInfo"
```
@@ -243,8 +243,8 @@ git commit -m "feat: 添加实体中介实体类CcdiEnterpriseBaseInfo"
## Task 3: 创建个人中介DTO
**Files:**
- Create: `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/domain/dto/CcdiIntermediaryPersonAddDTO.java`
- Create: `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/domain/dto/CcdiIntermediaryPersonEditDTO.java`
- Create: `ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/domain/dto/CcdiIntermediaryPersonAddDTO.java`
- Create: `ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/domain/dto/CcdiIntermediaryPersonEditDTO.java`
**Step 1: 创建个人中介新增DTO**
@@ -465,8 +465,8 @@ public class CcdiIntermediaryPersonEditDTO implements Serializable {
**Step 3: 提交代码**
```bash
git add ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/domain/dto/CcdiIntermediaryPersonAddDTO.java
git add ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/domain/dto/CcdiIntermediaryPersonEditDTO.java
git add ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/domain/dto/CcdiIntermediaryPersonAddDTO.java
git add ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/domain/dto/CcdiIntermediaryPersonEditDTO.java
git commit -m "feat: 添加个人中介DTO类"
```
@@ -475,8 +475,8 @@ git commit -m "feat: 添加个人中介DTO类"
## Task 4: 创建实体中介DTO
**Files:**
- Create: `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/domain/dto/CcdiIntermediaryEntityAddDTO.java`
- Create: `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/domain/dto/CcdiIntermediaryEntityEditDTO.java`
- Create: `ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/domain/dto/CcdiIntermediaryEntityAddDTO.java`
- Create: `ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/domain/dto/CcdiIntermediaryEntityEditDTO.java`
**Step 1: 创建实体中介新增DTO**
@@ -709,8 +709,8 @@ public class CcdiIntermediaryEntityEditDTO implements Serializable {
**Step 3: 提交代码**
```bash
git add ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/domain/dto/CcdiIntermediaryEntityAddDTO.java
git add ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/domain/dto/CcdiIntermediaryEntityEditDTO.java
git add ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/domain/dto/CcdiIntermediaryEntityAddDTO.java
git add ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/domain/dto/CcdiIntermediaryEntityEditDTO.java
git commit -m "feat: 添加实体中介DTO类"
```
@@ -719,10 +719,10 @@ git commit -m "feat: 添加实体中介DTO类"
## Task 5: 创建查询DTO和统一VO
**Files:**
- Create: `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/domain/dto/CcdiIntermediaryQueryDTO.java`
- Create: `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/domain/vo/CcdiIntermediaryVO.java`
- Create: `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/domain/vo/CcdiIntermediaryPersonDetailVO.java`
- Create: `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/domain/vo/CcdiIntermediaryEntityDetailVO.java`
- Create: `ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/domain/dto/CcdiIntermediaryQueryDTO.java`
- Create: `ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/domain/vo/CcdiIntermediaryVO.java`
- Create: `ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/domain/vo/CcdiIntermediaryPersonDetailVO.java`
- Create: `ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/domain/vo/CcdiIntermediaryEntityDetailVO.java`
**Step 1: 创建查询DTO**
@@ -999,10 +999,10 @@ public class CcdiIntermediaryEntityDetailVO implements Serializable {
**Step 5: 提交代码**
```bash
git add ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/domain/dto/CcdiIntermediaryQueryDTO.java
git add ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/domain/vo/CcdiIntermediaryVO.java
git add ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/domain/vo/CcdiIntermediaryPersonDetailVO.java
git add ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/domain/vo/CcdiIntermediaryEntityDetailVO.java
git add ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/domain/dto/CcdiIntermediaryQueryDTO.java
git add ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/domain/vo/CcdiIntermediaryVO.java
git add ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/domain/vo/CcdiIntermediaryPersonDetailVO.java
git add ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/domain/vo/CcdiIntermediaryEntityDetailVO.java
git commit -m "feat: 添加中介查询DTO和VO类"
```
@@ -1011,9 +1011,9 @@ git commit -m "feat: 添加中介查询DTO和VO类"
## Task 6: 创建Mapper接口
**Files:**
- Create: `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/mapper/CcdiBizIntermediaryMapper.java`
- Create: `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/mapper/CcdiEnterpriseBaseInfoMapper.java`
- Create: `ruoyi-ccdi/src/main/resources/mapper/ccdi/CcdiIntermediaryMapper.xml`
- Create: `ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/mapper/CcdiBizIntermediaryMapper.java`
- Create: `ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/mapper/CcdiEnterpriseBaseInfoMapper.java`
- Create: `ruoyi-info-collection/src/main/resources/mapper/ccdi/CcdiIntermediaryMapper.xml`
**Step 1: 创建个人中介Mapper接口**
@@ -1121,9 +1121,9 @@ PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
**Step 4: 提交代码**
```bash
git add ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/mapper/CcdiBizIntermediaryMapper.java
git add ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/mapper/CcdiEnterpriseBaseInfoMapper.java
git add ruoyi-ccdi/src/main/resources/mapper/ccdi/CcdiIntermediaryMapper.xml
git add ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/mapper/CcdiBizIntermediaryMapper.java
git add ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/mapper/CcdiEnterpriseBaseInfoMapper.java
git add ruoyi-info-collection/src/main/resources/mapper/ccdi/CcdiIntermediaryMapper.xml
git commit -m "feat: 添加中介Mapper接口和XML映射"
```
@@ -1132,8 +1132,8 @@ git commit -m "feat: 添加中介Mapper接口和XML映射"
## Task 7: 创建Service接口和实现类
**Files:**
- Create: `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/service/ICcdiIntermediaryService.java`
- Create: `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/service/impl/CcdiIntermediaryServiceImpl.java`
- Create: `ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/service/ICcdiIntermediaryService.java`
- Create: `ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/service/impl/CcdiIntermediaryServiceImpl.java`
**Step 1: 创建Service接口**
@@ -1316,7 +1316,7 @@ public class CcdiIntermediaryServiceImpl implements ICcdiIntermediaryService {
**Step 3: 提交Service框架**
```bash
git add ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/service/
git add ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/service/
git commit -m "feat: 添加中介Service接口和实现类框架"
```
@@ -1325,8 +1325,8 @@ git commit -m "feat: 添加中介Service接口和实现类框架"
## Task 8: 创建Excel导入导出类
**Files:**
- Create: `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/domain/excel/CcdiIntermediaryPersonExcel.java`
- Create: `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/domain/excel/CcdiIntermediaryEntityExcel.java`
- Create: `ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/domain/excel/CcdiIntermediaryPersonExcel.java`
- Create: `ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/domain/excel/CcdiIntermediaryEntityExcel.java`
**Step 1: 创建个人中介Excel类**
@@ -1518,7 +1518,7 @@ public class CcdiIntermediaryEntityExcel implements Serializable {
**Step 3: 提交Excel类**
```bash
git add ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/domain/excel/
git add ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/domain/excel/
git commit -m "feat: 添加中介Excel导入导出类"
```
@@ -1527,7 +1527,7 @@ git commit -m "feat: 添加中介Excel导入导出类"
## Task 9: 创建Controller控制器
**Files:**
- Create: `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/controller/CcdiIntermediaryController.java`
- Create: `ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/controller/CcdiIntermediaryController.java`
**Step 1: 创建CcdiIntermediaryController**
@@ -1723,7 +1723,7 @@ public class CcdiIntermediaryController extends BaseController {
**Step 2: 提交Controller**
```bash
git add ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/controller/CcdiIntermediaryController.java
git add ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/controller/CcdiIntermediaryController.java
git commit -m "feat: 添加中介黑名单Controller"
```
@@ -1732,7 +1732,7 @@ git commit -m "feat: 添加中介黑名单Controller"
## Task 10: 补充Service实现类的完整代码
**Files:**
- Complete: `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/service/impl/CcdiIntermediaryServiceImpl.java`
- Complete: `ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/service/impl/CcdiIntermediaryServiceImpl.java`
完整的Service实现需要包含所有业务逻辑方法包括
- UNION联合查询的分页实现
@@ -1745,7 +1745,7 @@ git commit -m "feat: 添加中介黑名单Controller"
**Step 1: 提交完整的Service实现**
```bash
git add ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/service/impl/CcdiIntermediaryServiceImpl.java
git add ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/service/impl/CcdiIntermediaryServiceImpl.java
git commit -m "feat: 完善中介Service实现类"
```

View File

@@ -13,7 +13,7 @@
### 2.1 修复实体类字段映射
**文件:** `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/domain/CcdiBizIntermediary.java`
**文件:** `ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/domain/CcdiBizIntermediary.java`
**修改内容:**
1. 删除了不存在的 `relationTypeField` 字段第70行
@@ -31,7 +31,7 @@ private String dataSource;
### 2.2 创建联合查询Mapper接口
**新增文件:** `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/mapper/CcdiIntermediaryMapper.java`
**新增文件:** `ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/mapper/CcdiIntermediaryMapper.java`
**功能:**
- 定义联合查询方法 `selectIntermediaryList()`
@@ -40,7 +40,7 @@ private String dataSource;
### 2.3 创建MyBatis XML Mapper
**新增文件:** `ruoyi-ccdi/src/main/resources/mapper/ccdi/CcdiIntermediaryMapper.xml`
**新增文件:** `ruoyi-info-collection/src/main/resources/mapper/ccdi/CcdiIntermediaryMapper.xml`
**SQL设计策略**
@@ -69,7 +69,7 @@ private String dataSource;
### 2.4 优化Service层实现
**文件:** `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/service/impl/CcdiIntermediaryServiceImpl.java`
**文件:** `ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/service/impl/CcdiIntermediaryServiceImpl.java`
**修改内容:**
@@ -84,7 +84,7 @@ private String dataSource;
### 2.5 扩展查询DTO
**文件:** `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/domain/dto/CcdiIntermediaryQueryDTO.java`
**文件:** `ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/domain/dto/CcdiIntermediaryQueryDTO.java`
**新增字段:**
```java
@@ -144,17 +144,17 @@ OFFSET #{pageNum} * #{pageSize}
## 五、文件清单
### 修改的文件
1. `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/domain/CcdiBizIntermediary.java` - 删除冗余字段,修复字段映射
2. `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/service/impl/CcdiIntermediaryServiceImpl.java` - 重构查询逻辑
3. `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/domain/dto/CcdiIntermediaryQueryDTO.java` - 添加分页参数
1. `ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/domain/CcdiBizIntermediary.java` - 删除冗余字段,修复字段映射
2. `ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/service/impl/CcdiIntermediaryServiceImpl.java` - 重构查询逻辑
3. `ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/domain/dto/CcdiIntermediaryQueryDTO.java` - 添加分页参数
### 新增的文件
1. `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/mapper/CcdiIntermediaryMapper.java` - 联合查询Mapper接口
2. `ruoyi-ccdi/src/main/resources/mapper/ccdi/CcdiIntermediaryMapper.xml` - MyBatis XML Mapper
1. `ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/mapper/CcdiIntermediaryMapper.java` - 联合查询Mapper接口
2. `ruoyi-info-collection/src/main/resources/mapper/ccdi/CcdiIntermediaryMapper.xml` - MyBatis XML Mapper
3. `doc/test/scripts/test_union_query.sh` - 测试脚本
### 删除的文件
1. `ruoyi-ccdi/src/main/resources/mapper/ccdi/CcdiIntermediaryMapper.xml` - 旧的错误配置
1. `ruoyi-info-collection/src/main/resources/mapper/ccdi/CcdiIntermediaryMapper.xml` - 旧的错误配置
## 六、优势总结
@@ -204,7 +204,7 @@ chmod +x test_union_query.sh
如果新实现出现问题可以通过Git回滚到之前的版本
```bash
git checkout HEAD~1 -- ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/service/impl/CcdiIntermediaryServiceImpl.java
git checkout HEAD~1 -- ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/service/impl/CcdiIntermediaryServiceImpl.java
```
删除新增的Mapper文件即可恢复原状。

View File

@@ -48,7 +48,7 @@ Page<CcdiEmployeeVO> selectEmployeePageWithDept(@Param("page") Page<CcdiEmployee
### 3.2 核心改动
#### 1. Mapper接口方法签名
**文件:** `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/mapper/CcdiIntermediaryMapper.java`
**文件:** `ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/mapper/CcdiIntermediaryMapper.java`
**修改前:**
```java
@@ -71,7 +71,7 @@ Page<CcdiIntermediaryVO> selectIntermediaryList(
- 删除了单独的count查询方法
#### 2. XML Mapper文件
**文件:** `ruoyi-ccdi/src/main/resources/mapper/ccdi/CcdiIntermediaryMapper.xml`
**文件:** `ruoyi-info-collection/src/main/resources/mapper/ccdi/CcdiIntermediaryMapper.xml`
**修改前v2.0**
```xml
@@ -125,7 +125,7 @@ Page<CcdiIntermediaryVO> selectIntermediaryList(
- MyBatis Plus分页插件会自动在ORDER BY后面注入分页SQL
#### 3. Service层实现
**文件:** `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/service/impl/CcdiIntermediaryServiceImpl.java`
**文件:** `ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/service/impl/CcdiIntermediaryServiceImpl.java`
**修改前v2.0**
```java
@@ -162,7 +162,7 @@ public Page<CcdiIntermediaryVO> selectIntermediaryPage(Page<CcdiIntermediaryVO>
- 无需手动计算分页参数
#### 4. QueryDTO清理
**文件:** `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/domain/dto/CcdiIntermediaryQueryDTO.java`
**文件:** `ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/domain/dto/CcdiIntermediaryQueryDTO.java`
**删除字段:**
```java
@@ -237,11 +237,11 @@ mapper.selectList(page, queryDTO);
## 五、文件清单
### 修改的文件
1. `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/domain/CcdiBizIntermediary.java` - 删除冗余字段,修复字段映射
2. `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/domain/dto/CcdiIntermediaryQueryDTO.java` - 删除分页参数
3. `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/mapper/CcdiIntermediaryMapper.java` - 修改方法签名
4. `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/service/impl/CcdiIntermediaryServiceImpl.java` - 简化分页逻辑
5. `ruoyi-ccdi/src/main/resources/mapper/ccdi/CcdiIntermediaryMapper.xml` - 重写SQL结构
1. `ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/domain/CcdiBizIntermediary.java` - 删除冗余字段,修复字段映射
2. `ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/domain/dto/CcdiIntermediaryQueryDTO.java` - 删除分页参数
3. `ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/mapper/CcdiIntermediaryMapper.java` - 修改方法签名
4. `ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/service/impl/CcdiIntermediaryServiceImpl.java` - 简化分页逻辑
5. `ruoyi-info-collection/src/main/resources/mapper/ccdi/CcdiIntermediaryMapper.xml` - 重写SQL结构
### 新增的文件
1. `doc/test/scripts/test_union_query_mybatis_plus.sh` - 测试脚本

View File

@@ -17,7 +17,7 @@
### Task 1.1:添加批量删除方法到 Mapper 接口
**文件:**
- 修改:`ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/mapper/CcdiEmployeeMapper.java`
- 修改:`ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/mapper/CcdiEmployeeMapper.java`
**Step 1: 在 Mapper 接口中添加方法声明**
@@ -40,7 +40,7 @@ int deleteBatchByIdCard(@Param("list") List<String> idCards);
**Step 3: 提交**
```bash
git add ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/mapper/CcdiEmployeeMapper.java
git add ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/mapper/CcdiEmployeeMapper.java
git commit -m "feat(employee): 添加批量删除方法声明"
```
@@ -49,7 +49,7 @@ git commit -m "feat(employee): 添加批量删除方法声明"
### Task 1.2:在 Mapper XML 中实现批量删除 SQL
**文件:**
- 修改:`ruoyi-ccdi/src/main/resources/mapper/ccdi/CcdiEmployeeMapper.xml`
- 修改:`ruoyi-info-collection/src/main/resources/mapper/ccdi/CcdiEmployeeMapper.xml`
**Step 1: 在 XML 文件中添加删除 SQL**
@@ -73,7 +73,7 @@ git commit -m "feat(employee): 添加批量删除方法声明"
**Step 3: 提交**
```bash
git add ruoyi-ccdi/src/main/resources/mapper/ccdi/CcdiEmployeeMapper.xml
git add ruoyi-info-collection/src/main/resources/mapper/ccdi/CcdiEmployeeMapper.xml
git commit -m "feat(employee): 实现批量删除SQL"
```
@@ -84,7 +84,7 @@ git commit -m "feat(employee): 实现批量删除SQL"
- [x] **已完成** (commit: ebe4fd7)
**文件:**
- 修改:`ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/service/impl/CcdiEmployeeServiceImpl.java`
- 修改:`ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/service/impl/CcdiEmployeeServiceImpl.java`
- 目标方法:`importEmployee` (第 172-311 行)
**Step 1: 备份原方法**
@@ -183,7 +183,7 @@ public String importEmployee(List<CcdiEmployeeExcel> excelList, Boolean isUpdate
**Step 3: 提交**
```bash
git add ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/service/impl/CcdiEmployeeServiceImpl.java
git add ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/service/impl/CcdiEmployeeServiceImpl.java
git commit -m "refactor(employee): 重构导入方法为先删后插模式"
```
@@ -369,7 +369,7 @@ cd D:\ccdi\ccdi
- [x] **已完成** (commit: ba8eedc)
**文件:**
- 修改:`ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/mapper/CcdiBizIntermediaryMapper.java`
- 修改:`ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/mapper/CcdiBizIntermediaryMapper.java`
**Step 1: 在 Mapper 接口中添加方法声明**
@@ -386,7 +386,7 @@ int deleteBatchByPersonId(@Param("list") List<String> personIds);
**Step 2: 提交**
```bash
git add ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/mapper/CcdiBizIntermediaryMapper.java
git add ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/mapper/CcdiBizIntermediaryMapper.java
git commit -m "feat(intermediary): 添加个人批量删除方法声明"
```
@@ -395,7 +395,7 @@ git commit -m "feat(intermediary): 添加个人批量删除方法声明"
### Task 2.2:在 Mapper XML 中实现批量删除 SQL
**文件:**
- 修改:`ruoyi-ccdi/src/main/resources/mapper/ccdi/CcdiBizIntermediaryMapper.xml`
- 修改:`ruoyi-info-collection/src/main/resources/mapper/ccdi/CcdiBizIntermediaryMapper.xml`
**Step 1: 在 XML 文件中添加删除 SQL**
@@ -413,7 +413,7 @@ git commit -m "feat(intermediary): 添加个人批量删除方法声明"
**Step 2: 提交**
```bash
git add ruoyi-ccdi/src/main/resources/mapper/ccdi/CcdiBizIntermediaryMapper.xml
git add ruoyi-info-collection/src/main/resources/mapper/ccdi/CcdiBizIntermediaryMapper.xml
git commit -m "feat(intermediary): 实现个人批量删除SQL"
```
@@ -422,7 +422,7 @@ git commit -m "feat(intermediary): 实现个人批量删除SQL"
### Task 2.3:重构中介库个人导入方法
**文件:**
- 修改:`ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/service/impl/CcdiIntermediaryServiceImpl.java`
- 修改:`ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/service/impl/CcdiIntermediaryServiceImpl.java`
- 目标方法:`importIntermediaryPerson`
**Step 1: 找到 `importIntermediaryPerson` 方法**
@@ -511,7 +511,7 @@ public String importIntermediaryPerson(List<CcdiIntermediaryPersonExcel> excelLi
**Step 3: 提交**
```bash
git add ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/service/impl/CcdiIntermediaryServiceImpl.java
git add ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/service/impl/CcdiIntermediaryServiceImpl.java
git commit -m "refactor(intermediary): 重构个人导入方法为先删后插模式"
```
@@ -522,7 +522,7 @@ git commit -m "refactor(intermediary): 重构个人导入方法为先删后插
### Task 3.1:添加批量删除方法到 Mapper 接口
**文件:**
- 修改:`ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/mapper/CcdiEnterpriseBaseInfoMapper.java`
- 修改:`ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/mapper/CcdiEnterpriseBaseInfoMapper.java`
**Step 1: 在 Mapper 接口中添加方法声明**
@@ -539,7 +539,7 @@ int deleteBatchBySocialCreditCode(@Param("list") List<String> socialCreditCodes)
**Step 2: 提交**
```bash
git add ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/mapper/CcdiEnterpriseBaseInfoMapper.java
git add ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/mapper/CcdiEnterpriseBaseInfoMapper.java
git commit -m "feat(intermediary): 添加实体批量删除方法声明"
```
@@ -548,7 +548,7 @@ git commit -m "feat(intermediary): 添加实体批量删除方法声明"
### Task 3.2:在 Mapper XML 中实现批量删除 SQL
**文件:**
- 修改:`ruoyi-ccdi/src/main/resources/mapper/ccdi/CcdiEnterpriseBaseInfoMapper.xml`
- 修改:`ruoyi-info-collection/src/main/resources/mapper/ccdi/CcdiEnterpriseBaseInfoMapper.xml`
**Step 1: 在 XML 文件中添加删除 SQL**
@@ -566,7 +566,7 @@ git commit -m "feat(intermediary): 添加实体批量删除方法声明"
**Step 2: 提交**
```bash
git add ruoyi-ccdi/src/main/resources/mapper/ccdi/CcdiEnterpriseBaseInfoMapper.xml
git add ruoyi-info-collection/src/main/resources/mapper/ccdi/CcdiEnterpriseBaseInfoMapper.xml
git commit -m "feat(intermediary): 实现实体批量删除SQL"
```
@@ -575,7 +575,7 @@ git commit -m "feat(intermediary): 实现实体批量删除SQL"
### Task 3.3:重构中介库实体导入方法
**文件:**
- 修改:`ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/service/impl/CcdiIntermediaryServiceImpl.java`
- 修改:`ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/service/impl/CcdiIntermediaryServiceImpl.java`
- 目标方法:`importIntermediaryEntity`
**Step 1: 找到 `importIntermediaryEntity` 方法**
@@ -664,7 +664,7 @@ public String importIntermediaryEntity(List<CcdiIntermediaryEntityExcel> excelLi
**Step 3: 提交**
```bash
git add ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/service/impl/CcdiIntermediaryServiceImpl.java
git add ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/service/impl/CcdiIntermediaryServiceImpl.java
git commit -m "refactor(intermediary): 重构实体导入方法为先删后插模式"
```
@@ -675,7 +675,7 @@ git commit -m "refactor(intermediary): 重构实体导入方法为先删后插
### Task 4.1:添加批量删除方法到 Mapper 接口
**文件:**
- 修改:`ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/mapper/CcdiStaffRecruitmentMapper.java`
- 修改:`ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/mapper/CcdiStaffRecruitmentMapper.java`
**Step 1: 在 Mapper 接口中添加方法声明**
@@ -692,7 +692,7 @@ int deleteBatchByRecruitId(@Param("list") List<String> recruitIds);
**Step 2: 提交**
```bash
git add ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/mapper/CcdiStaffRecruitmentMapper.java
git add ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/mapper/CcdiStaffRecruitmentMapper.java
git commit -m "feat(recruitment): 添加批量删除方法声明"
```
@@ -701,7 +701,7 @@ git commit -m "feat(recruitment): 添加批量删除方法声明"
### Task 4.2:在 Mapper XML 中实现批量删除 SQL
**文件:**
- 修改:`ruoyi-ccdi/src/main/resources/mapper/ccdi/CcdiStaffRecruitmentMapper.xml`
- 修改:`ruoyi-info-collection/src/main/resources/mapper/ccdi/CcdiStaffRecruitmentMapper.xml`
**Step 1: 在 XML 文件中添加删除 SQL**
@@ -719,7 +719,7 @@ git commit -m "feat(recruitment): 添加批量删除方法声明"
**Step 2: 提交**
```bash
git add ruoyi-ccdi/src/main/resources/mapper/ccdi/CcdiStaffRecruitmentMapper.xml
git add ruoyi-info-collection/src/main/resources/mapper/ccdi/CcdiStaffRecruitmentMapper.xml
git commit -m "feat(recruitment): 实现批量删除SQL"
```
@@ -728,7 +728,7 @@ git commit -m "feat(recruitment): 实现批量删除SQL"
### Task 4.3:重构招聘信息导入方法
**文件:**
- 修改:`ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/service/impl/CcdiStaffRecruitmentServiceImpl.java`
- 修改:`ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/service/impl/CcdiStaffRecruitmentServiceImpl.java`
- 目标方法:`importRecruitment`
**Step 1: 找到 `importRecruitment` 方法**
@@ -817,7 +817,7 @@ public String importRecruitment(List<CcdiStaffRecruitmentExcel> excelList, Boole
**Step 3: 提交**
```bash
git add ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/service/impl/CcdiStaffRecruitmentServiceImpl.java
git add ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/service/impl/CcdiStaffRecruitmentServiceImpl.java
git commit -m "refactor(recruitment): 重构导入方法为先删后插模式"
```

View File

@@ -383,23 +383,23 @@ public String importXxx(List<XxxExcel> excelList, Boolean isUpdateSupport) {
### 5.1 修改文件清单11 个文件)
#### 员工信息管理模块
1. `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/mapper/CcdiEmployeeMapper.java`
2. `ruoyi-ccdi/src/main/resources/mapper/ccdi/CcdiEmployeeMapper.xml`
3. `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/service/impl/CcdiEmployeeServiceImpl.java`
1. `ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/mapper/CcdiEmployeeMapper.java`
2. `ruoyi-info-collection/src/main/resources/mapper/ccdi/CcdiEmployeeMapper.xml`
3. `ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/service/impl/CcdiEmployeeServiceImpl.java`
#### 中介库管理模块(个人和实体)
4. `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/mapper/CcdiBizIntermediaryMapper.java`
5. `ruoyi-ccdi/src/main/resources/mapper/ccdi/CcdiBizIntermediaryMapper.xml`
6. `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/mapper/CcdiEnterpriseBaseInfoMapper.java`
7. `ruoyi-ccdi/src/main/resources/mapper/ccdi/CcdiEnterpriseBaseInfoMapper.xml`
8. `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/service/impl/CcdiIntermediaryServiceImpl.java`
4. `ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/mapper/CcdiBizIntermediaryMapper.java`
5. `ruoyi-info-collection/src/main/resources/mapper/ccdi/CcdiBizIntermediaryMapper.xml`
6. `ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/mapper/CcdiEnterpriseBaseInfoMapper.java`
7. `ruoyi-info-collection/src/main/resources/mapper/ccdi/CcdiEnterpriseBaseInfoMapper.xml`
8. `ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/service/impl/CcdiIntermediaryServiceImpl.java`
- 修改 `importIntermediaryPerson` 方法
- 修改 `importIntermediaryEntity` 方法
#### 员工招聘信息管理模块
9. `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/mapper/CcdiStaffRecruitmentMapper.java`
10. `ruoyi-ccdi/src/main/resources/mapper/ccdi/CcdiStaffRecruitmentMapper.xml`
11. `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/service/impl/CcdiStaffRecruitmentServiceImpl.java`
9. `ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/mapper/CcdiStaffRecruitmentMapper.java`
10. `ruoyi-info-collection/src/main/resources/mapper/ccdi/CcdiStaffRecruitmentMapper.xml`
11. `ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/service/impl/CcdiStaffRecruitmentServiceImpl.java`
### 5.2 实施步骤

View File

@@ -34,7 +34,7 @@
#### 1. 实体层
```
ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/
ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/
├── domain/
│ ├── CcdiPurchaseTransaction.java # 实体类 (36字段)
│ ├── dto/
@@ -50,7 +50,7 @@ ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/
#### 2. 持久层
```
ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/
ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/
├── mapper/
│ ├── CcdiPurchaseTransactionMapper.java # Mapper接口
│ └── resources/mapper/ccdi/
@@ -59,7 +59,7 @@ ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/
#### 3. 服务层
```
ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/
ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/
├── service/
│ ├── ICcdiPurchaseTransactionService.java # Service接口
│ ├── ICcdiPurchaseTransactionImportService.java # 异步导入Service接口
@@ -70,7 +70,7 @@ ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/
#### 4. 控制层
```
ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/
ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/
└── controller/
└── CcdiPurchaseTransactionController.java # REST Controller (10接口)
```
@@ -159,14 +159,14 @@ WHERE menu_name = '采购交易管理';
#### 方式A: 已有代码跳过 (推荐)
```bash
# 代码已存在于项目目录中,无需额外操作
cd ruoyi-ccdi
cd ruoyi-info-collection
mvn clean compile # 验证编译
```
#### 方式B: 从Git拉取
```bash
git pull origin dev
cd ruoyi-ccdi
cd ruoyi-info-collection
mvn clean compile
```
@@ -586,8 +586,8 @@ redis-cli KEYS "import:purchaseTransaction:*"
- 查看Redis状态: `redis-cli monitor`
**关键文件位置**:
- Controller: `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/controller/CcdiPurchaseTransactionController.java`
- 异步Service: `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/service/impl/CcdiPurchaseTransactionImportServiceImpl.java`
- Controller: `ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/controller/CcdiPurchaseTransactionController.java`
- 异步Service: `ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/service/impl/CcdiPurchaseTransactionImportServiceImpl.java`
- 前端页面: `ruoyi-ui/src/views/ccdiPurchaseTransaction/index.vue`
---

View File

@@ -407,8 +407,8 @@ redisTemplate.expire(statusKey, 7, TimeUnit.DAYS);
- 验证清单: `doc/plans/2026-02-06-ccdi_purchase_transaction-verification.md`
**关键文件**:
- 后端Controller: `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/controller/CcdiPurchaseTransactionController.java`
- 异步Service: `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/service/impl/CcdiPurchaseTransactionImportServiceImpl.java`
- 后端Controller: `ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/controller/CcdiPurchaseTransactionController.java`
- 异步Service: `ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/service/impl/CcdiPurchaseTransactionImportServiceImpl.java`
- 前端页面: `ruoyi-ui/src/views/ccdiPurchaseTransaction/index.vue`
**测试账号**:

View File

@@ -16,8 +16,8 @@
## 前置条件
### 参考文档
- 员工招聘信息模块: `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/**/CcdiStaffRecruitment*`
- 员工异步导入实现: `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/service/impl/CcdiEmployeeImportServiceImpl.java`
- 员工招聘信息模块: `ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/**/CcdiStaffRecruitment*`
- 员工异步导入实现: `ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/service/impl/CcdiEmployeeImportServiceImpl.java`
- 数据库表定义: `doc/docs/ccdi_purchase_transaction.csv`
### 数据库表结构
@@ -98,7 +98,7 @@ git commit -m "feat: 添加员工采购交易信息表"
## Task 2: 创建实体类
**Files:**
- Create: `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/domain/CcdiPurchaseTransaction.java`
- Create: `ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/domain/CcdiPurchaseTransaction.java`
**Step 1: 创建实体类**
@@ -247,7 +247,7 @@ public class CcdiPurchaseTransaction implements Serializable {
**Step 2: 验证编译**
```bash
cd ruoyi-ccdi
cd ruoyi-info-collection
mvn compile -pl . -am
```
@@ -256,7 +256,7 @@ Expected: 编译成功,无错误
**Step 3: Commit**
```bash
git add ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/domain/CcdiPurchaseTransaction.java
git add ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/domain/CcdiPurchaseTransaction.java
git commit -m "feat: 添加采购交易信息实体类"
```
@@ -265,7 +265,7 @@ git commit -m "feat: 添加采购交易信息实体类"
## Task 3: 创建查询DTO
**Files:**
- Create: `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/domain/dto/CcdiPurchaseTransactionQueryDTO.java`
- Create: `ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/domain/dto/CcdiPurchaseTransactionQueryDTO.java`
**Step 1: 创建查询DTO**
@@ -324,7 +324,7 @@ public class CcdiPurchaseTransactionQueryDTO implements Serializable {
**Step 2: Commit**
```bash
git add ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/domain/dto/CcdiPurchaseTransactionQueryDTO.java
git add ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/domain/dto/CcdiPurchaseTransactionQueryDTO.java
git commit -m "feat: 添加采购交易查询DTO"
```
@@ -333,7 +333,7 @@ git commit -m "feat: 添加采购交易查询DTO"
## Task 4: 创建新增DTO
**Files:**
- Create: `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/domain/dto/CcdiPurchaseTransactionAddDTO.java`
- Create: `ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/domain/dto/CcdiPurchaseTransactionAddDTO.java`
**Step 1: 创建新增DTO包含验证注解**
@@ -505,7 +505,7 @@ public class CcdiPurchaseTransactionAddDTO implements Serializable {
**Step 2: Commit**
```bash
git add ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/domain/dto/CcdiPurchaseTransactionAddDTO.java
git add ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/domain/dto/CcdiPurchaseTransactionAddDTO.java
git commit -m "feat: 添加采购交易新增DTO"
```
@@ -514,7 +514,7 @@ git commit -m "feat: 添加采购交易新增DTO"
## Task 5: 创建编辑DTO
**Files:**
- Create: `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/domain/dto/CcdiPurchaseTransactionEditDTO.java`
- Create: `ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/domain/dto/CcdiPurchaseTransactionEditDTO.java`
**Step 1: 创建编辑DTO**
@@ -523,7 +523,7 @@ git commit -m "feat: 添加采购交易新增DTO"
**Step 2: Commit**
```bash
git add ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/domain/dto/CcdiPurchaseTransactionEditDTO.java
git add ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/domain/dto/CcdiPurchaseTransactionEditDTO.java
git commit -m "feat: 添加采购交易编辑DTO"
```
@@ -532,7 +532,7 @@ git commit -m "feat: 添加采购交易编辑DTO"
## Task 6: 创建VO类
**Files:**
- Create: `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/domain/vo/CcdiPurchaseTransactionVO.java`
- Create: `ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/domain/vo/CcdiPurchaseTransactionVO.java`
**Step 1: 创建VO类**
@@ -686,7 +686,7 @@ public class CcdiPurchaseTransactionVO implements Serializable {
**Step 2: Commit**
```bash
git add ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/domain/vo/CcdiPurchaseTransactionVO.java
git add ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/domain/vo/CcdiPurchaseTransactionVO.java
git commit -m "feat: 添加采购交易VO类"
```
@@ -695,7 +695,7 @@ git commit -m "feat: 添加采购交易VO类"
## Task 7: 创建Excel导入导出类
**Files:**
- Create: `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/domain/excel/CcdiPurchaseTransactionExcel.java`
- Create: `ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/domain/excel/CcdiPurchaseTransactionExcel.java`
**Step 1: 创建Excel类**
@@ -704,7 +704,7 @@ git commit -m "feat: 添加采购交易VO类"
**Step 2: Commit**
```bash
git add ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/domain/excel/CcdiPurchaseTransactionExcel.java
git add ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/domain/excel/CcdiPurchaseTransactionExcel.java
git commit -m "feat: 添加采购交易Excel类"
```
@@ -713,7 +713,7 @@ git commit -m "feat: 添加采购交易Excel类"
## Task 8: 创建Mapper接口
**Files:**
- Create: `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/mapper/CcdiPurchaseTransactionMapper.java`
- Create: `ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/mapper/CcdiPurchaseTransactionMapper.java`
**Step 1: 创建Mapper接口**
@@ -763,7 +763,7 @@ public interface CcdiPurchaseTransactionMapper extends BaseMapper<CcdiPurchaseTr
**Step 2: Commit**
```bash
git add ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/mapper/CcdiPurchaseTransactionMapper.java
git add ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/mapper/CcdiPurchaseTransactionMapper.java
git commit -m "feat: 添加采购交易Mapper接口"
```
@@ -772,7 +772,7 @@ git commit -m "feat: 添加采购交易Mapper接口"
## Task 9: 创建Mapper XML文件
**Files:**
- Create: `ruoyi-ccdi/src/main/resources/mapper/ccdi/CcdiPurchaseTransactionMapper.xml`
- Create: `ruoyi-info-collection/src/main/resources/mapper/ccdi/CcdiPurchaseTransactionMapper.xml`
**Step 1: 创建XML映射文件**
@@ -785,7 +785,7 @@ git commit -m "feat: 添加采购交易Mapper接口"
**Step 2: Commit**
```bash
git add ruoyi-ccdi/src/main/resources/mapper/ccdi/CcdiPurchaseTransactionMapper.xml
git add ruoyi-info-collection/src/main/resources/mapper/ccdi/CcdiPurchaseTransactionMapper.xml
git commit -m "feat: 添加采购交易Mapper XML"
```
@@ -794,7 +794,7 @@ git commit -m "feat: 添加采购交易Mapper XML"
## Task 10: 创建Service接口
**Files:**
- Create: `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/service/ICcdiPurchaseTransactionService.java`
- Create: `ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/service/ICcdiPurchaseTransactionService.java`
**Step 1: 创建Service接口**
@@ -811,7 +811,7 @@ git commit -m "feat: 添加采购交易Mapper XML"
**Step 2: Commit**
```bash
git add ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/service/ICcdiPurchaseTransactionService.java
git add ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/service/ICcdiPurchaseTransactionService.java
git commit -m "feat: 添加采购交易Service接口"
```
@@ -820,7 +820,7 @@ git commit -m "feat: 添加采购交易Service接口"
## Task 11: 创建异步导入Service接口
**Files:**
- Create: `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/service/ICcdiPurchaseTransactionImportService.java`
- Create: `ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/service/ICcdiPurchaseTransactionImportService.java`
**Step 1: 创建异步导入Service接口**
@@ -832,7 +832,7 @@ git commit -m "feat: 添加采购交易Service接口"
**Step 2: Commit**
```bash
git add ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/service/ICcdiPurchaseTransactionImportService.java
git add ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/service/ICcdiPurchaseTransactionImportService.java
git commit -m "feat: 添加采购交易异步导入Service接口"
```
@@ -841,7 +841,7 @@ git commit -m "feat: 添加采购交易异步导入Service接口"
## Task 12: 创建Service实现类
**Files:**
- Create: `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/service/impl/CcdiPurchaseTransactionServiceImpl.java`
- Create: `ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/service/impl/CcdiPurchaseTransactionServiceImpl.java`
**Step 1: 创建Service实现**
@@ -850,7 +850,7 @@ git commit -m "feat: 添加采购交易异步导入Service接口"
**Step 2: Commit**
```bash
git add ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/service/impl/CcdiPurchaseTransactionServiceImpl.java
git add ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/service/impl/CcdiPurchaseTransactionServiceImpl.java
git commit -m "feat: 添加采购交易Service实现"
```
@@ -859,7 +859,7 @@ git commit -m "feat: 添加采购交易Service实现"
## Task 13: 创建异步导入Service实现类
**Files:**
- Create: `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/service/impl/CcdiPurchaseTransactionImportServiceImpl.java`
- Create: `ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/service/impl/CcdiPurchaseTransactionImportServiceImpl.java`
**Step 1: 创建异步导入实现**
@@ -874,7 +874,7 @@ git commit -m "feat: 添加采购交易Service实现"
**Step 2: Commit**
```bash
git add ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/service/impl/CcdiPurchaseTransactionImportServiceImpl.java
git add ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/service/impl/CcdiPurchaseTransactionImportServiceImpl.java
git commit -m "feat: 添加采购交易异步导入Service实现"
```
@@ -883,7 +883,7 @@ git commit -m "feat: 添加采购交易异步导入Service实现"
## Task 14: 创建Controller控制器
**Files:**
- Create: `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/controller/CcdiPurchaseTransactionController.java`
- Create: `ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/controller/CcdiPurchaseTransactionController.java`
**Step 1: 创建Controller**
@@ -904,7 +904,7 @@ git commit -m "feat: 添加采购交易异步导入Service实现"
**Step 2: Commit**
```bash
git add ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/controller/CcdiPurchaseTransactionController.java
git add ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/controller/CcdiPurchaseTransactionController.java
git commit -m "feat: 添加采购交易Controller"
```
@@ -1204,7 +1204,7 @@ git commit -m "feat: 完成采购交易信息管理功能开发"
## 参考文件
- 员工招聘信息模块: `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/**/CcdiStaffRecruitment*`
- 员工异步导入: `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/service/impl/CcdiEmployeeImportServiceImpl.java`
- 员工招聘信息模块: `ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/**/CcdiStaffRecruitment*`
- 员工异步导入: `ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/service/impl/CcdiEmployeeImportServiceImpl.java`
- 前端页面: `ruoyi-ui/src/views/ccdiStaffRecruitment/index.vue`
- 测试脚本: `test/test_employee_api.ps1`

View File

@@ -725,15 +725,15 @@ import:employee:{taskId}:failures # 失败记录列表
### C. 相关文件清单
**后端**:
- `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/config/AsyncConfig.java`
- `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/domain/vo/ImportResultVO.java`
- `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/domain/vo/ImportStatusVO.java`
- `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/domain/vo/ImportFailureVO.java`
- `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/service/ICcdiEmployeeService.java`
- `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/service/impl/CcdiEmployeeServiceImpl.java`
- `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/mapper/CcdiEmployeeMapper.java`
- `ruoyi-ccdi/src/main/resources/mapper/ccdi/CcdiEmployeeMapper.xml`
- `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/controller/CcdiEmployeeController.java`
- `ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/config/AsyncConfig.java`
- `ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/domain/vo/ImportResultVO.java`
- `ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/domain/vo/ImportStatusVO.java`
- `ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/domain/vo/ImportFailureVO.java`
- `ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/service/ICcdiEmployeeService.java`
- `ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/service/impl/CcdiEmployeeServiceImpl.java`
- `ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/mapper/CcdiEmployeeMapper.java`
- `ruoyi-info-collection/src/main/resources/mapper/ccdi/CcdiEmployeeMapper.xml`
- `ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/controller/CcdiEmployeeController.java`
**前端**:
- `ruoyi-ui/src/api/ccdiEmployee.js`

View File

@@ -15,7 +15,7 @@
**目标:** 创建异步配置类,设置专用线程池处理导入任务
**文件:**
- 创建: `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/config/AsyncConfig.java`
- 创建: `ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/config/AsyncConfig.java`
**步骤 1: 创建AsyncConfig配置类**
@@ -72,7 +72,7 @@ public class AsyncConfig {
**步骤 3: 提交配置**
```bash
git add ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/config/AsyncConfig.java
git add ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/config/AsyncConfig.java
git commit -m "feat: 添加异步配置类,配置导入任务专用线程池"
```
@@ -83,9 +83,9 @@ git commit -m "feat: 添加异步配置类,配置导入任务专用线程池"
**目标:** 创建导入结果、状态和失败记录的VO类
**文件:**
- 创建: `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/domain/vo/ImportResultVO.java`
- 创建: `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/domain/vo/ImportStatusVO.java`
- 创建: `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/domain/vo/ImportFailureVO.java`
- 创建: `ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/domain/vo/ImportResultVO.java`
- 创建: `ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/domain/vo/ImportStatusVO.java`
- 创建: `ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/domain/vo/ImportFailureVO.java`
**步骤 1: 创建ImportResultVO**
@@ -207,7 +207,7 @@ public class ImportFailureVO {
**步骤 4: 提交VO类**
```bash
git add ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/domain/vo/
git add ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/domain/vo/
git commit -m "feat: 添加导入相关VO类(ImportResultVO, ImportStatusVO, ImportFailureVO)"
```
@@ -270,8 +270,8 @@ git commit -m "feat: 添加员工表柜员号唯一索引,支持批量更新"
**目标:** 在Mapper接口和XML中添加批量查询和批量插入更新的方法
**文件:**
- 修改: `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/mapper/CcdiEmployeeMapper.java`
- 修改: `ruoyi-ccdi/src/main/resources/mapper/ccdi/CcdiEmployeeMapper.xml`
- 修改: `ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/mapper/CcdiEmployeeMapper.java`
- 修改: `ruoyi-info-collection/src/main/resources/mapper/ccdi/CcdiEmployeeMapper.xml`
**步骤 1: 在Mapper接口中添加方法**
@@ -319,8 +319,8 @@ int insertOrUpdateBatch(@Param("list") List<CcdiEmployee> list);
**步骤 3: 提交Mapper变更**
```bash
git add ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/mapper/CcdiEmployeeMapper.java
git add ruoyi-ccdi/src/main/resources/mapper/ccdi/CcdiEmployeeMapper.xml
git add ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/mapper/CcdiEmployeeMapper.java
git add ruoyi-info-collection/src/main/resources/mapper/ccdi/CcdiEmployeeMapper.xml
git commit -m "feat: 添加批量插入或更新员工信息方法"
```
@@ -331,8 +331,8 @@ git commit -m "feat: 添加批量插入或更新员工信息方法"
**目标:** 实现异步导入逻辑,包括数据分类、批量操作、Redis存储
**文件:**
- 修改: `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/service/ICcdiEmployeeService.java`
- 修改: `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/service/impl/CcdiEmployeeServiceImpl.java`
- 修改: `ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/service/ICcdiEmployeeService.java`
- 修改: `ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/service/impl/CcdiEmployeeServiceImpl.java`
**步骤 1: 在Service接口中添加方法声明**
@@ -625,7 +625,7 @@ public List<ImportFailureVO> getImportFailures(String taskId) {
**步骤 6: 提交Service层代码**
```bash
git add ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/service/
git add ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/service/
git commit -m "feat: 实现员工信息异步导入服务"
```
@@ -636,7 +636,7 @@ git commit -m "feat: 实现员工信息异步导入服务"
**目标:** 修改导入接口为异步,添加状态查询和失败记录查询接口
**文件:**
- 修改: `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/controller/CcdiEmployeeController.java`
- 修改: `ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/controller/CcdiEmployeeController.java`
**步骤 1: 添加Resource注入**
@@ -722,7 +722,7 @@ public TableDataInfo getImportFailures(
**步骤 5: 提交Controller变更**
```bash
git add ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/controller/CcdiEmployeeController.java
git add ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/controller/CcdiEmployeeController.java
git commit -m "feat: 修改导入接口为异步,添加状态和失败记录查询接口"
```
@@ -1411,15 +1411,15 @@ git push origin v1.x.x
### A. 相关文件清单
**后端:**
- `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/config/AsyncConfig.java`
- `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/domain/vo/ImportResultVO.java`
- `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/domain/vo/ImportStatusVO.java`
- `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/domain/vo/ImportFailureVO.java`
- `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/service/ICcdiEmployeeService.java`
- `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/service/impl/CcdiEmployeeServiceImpl.java`
- `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/mapper/CcdiEmployeeMapper.java`
- `ruoyi-ccdi/src/main/resources/mapper/ccdi/CcdiEmployeeMapper.xml`
- `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/controller/CcdiEmployeeController.java`
- `ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/config/AsyncConfig.java`
- `ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/domain/vo/ImportResultVO.java`
- `ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/domain/vo/ImportStatusVO.java`
- `ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/domain/vo/ImportFailureVO.java`
- `ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/service/ICcdiEmployeeService.java`
- `ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/service/impl/CcdiEmployeeServiceImpl.java`
- `ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/mapper/CcdiEmployeeMapper.java`
- `ruoyi-info-collection/src/main/resources/mapper/ccdi/CcdiEmployeeMapper.xml`
- `ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/controller/CcdiEmployeeController.java`
**前端:**
- `ruoyi-ui/src/api/ccdiEmployee.js`

View File

@@ -869,19 +869,19 @@ private void updateImportStatus(String taskType, String taskId, String status, I
| 文件路径 | 说明 |
|---------|------|
| `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/domain/vo/IntermediaryPersonImportFailureVO.java` | 个人中介导入失败记录VO |
| `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/domain/vo/IntermediaryEntityImportFailureVO.java` | 实体中介导入失败记录VO |
| `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/service/ICcdiIntermediaryPersonImportService.java` | 个人中介异步导入Service接口 |
| `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/service/ICcdiIntermediaryEntityImportService.java` | 实体中介异步导入Service接口 |
| `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/service/impl/CcdiIntermediaryPersonImportServiceImpl.java` | 个人中介异步导入Service实现 |
| `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/service/impl/CcdiIntermediaryEntityImportServiceImpl.java` | 实体中介异步导入Service实现 |
| `ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/domain/vo/IntermediaryPersonImportFailureVO.java` | 个人中介导入失败记录VO |
| `ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/domain/vo/IntermediaryEntityImportFailureVO.java` | 实体中介导入失败记录VO |
| `ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/service/ICcdiIntermediaryPersonImportService.java` | 个人中介异步导入Service接口 |
| `ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/service/ICcdiIntermediaryEntityImportService.java` | 实体中介异步导入Service接口 |
| `ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/service/impl/CcdiIntermediaryPersonImportServiceImpl.java` | 个人中介异步导入Service实现 |
| `ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/service/impl/CcdiIntermediaryEntityImportServiceImpl.java` | 实体中介异步导入Service实现 |
| `test/test_intermediary_import.py` | 测试脚本 |
### 5.2 修改文件
| 文件路径 | 修改内容 |
|---------|---------|
| `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/controller/CcdiIntermediaryController.java` | 修改导入接口,添加状态查询和失败记录查询接口(个人+实体共6个接口) |
| `ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/controller/CcdiIntermediaryController.java` | 修改导入接口,添加状态查询和失败记录查询接口(个人+实体共6个接口) |
| `ruoyi-ui/src/api/ccdiIntermediary.js` | 添加导入状态和失败记录查询API(4个新方法) |
| `ruoyi-ui/src/views/ccdiIntermediary/index.vue` | 添加轮询逻辑、失败记录UI(两套独立组件) |
| `doc/api/ccdi_intermediary_api.md` | 更新API文档(新增导入相关接口文档) |
@@ -904,20 +904,20 @@ private void updateImportStatus(String taskType, String taskId, String status, I
#### 步骤1: 创建失败记录VO类
**文件:**
- `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/domain/vo/IntermediaryPersonImportFailureVO.java`
- `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/domain/vo/IntermediaryEntityImportFailureVO.java`
- `ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/domain/vo/IntermediaryPersonImportFailureVO.java`
- `ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/domain/vo/IntermediaryEntityImportFailureVO.java`
#### 步骤2: 创建Service接口
**文件:**
- `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/service/ICcdiIntermediaryPersonImportService.java`
- `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/service/ICcdiIntermediaryEntityImportService.java`
- `ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/service/ICcdiIntermediaryPersonImportService.java`
- `ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/service/ICcdiIntermediaryEntityImportService.java`
#### 步骤3: 实现Service
**文件:**
- `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/service/impl/CcdiIntermediaryPersonImportServiceImpl.java`
- `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/service/impl/CcdiIntermediaryEntityImportServiceImpl.java`
- `ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/service/impl/CcdiIntermediaryPersonImportServiceImpl.java`
- `ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/service/impl/CcdiIntermediaryEntityImportServiceImpl.java`
**操作:**
- 实现`ICcdiIntermediaryPersonImportService`接口
@@ -931,7 +931,7 @@ private void updateImportStatus(String taskType, String taskId, String status, I
#### 步骤4: 修改Controller
**文件:**
- `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/controller/CcdiIntermediaryController.java`
- `ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/controller/CcdiIntermediaryController.java`
**操作:**
- 注入两个导入Service

View File

@@ -14,8 +14,8 @@
**参考资料:**
- 设计文档: `doc/plans/2026-02-06-intermediary-async-import-design.md`
- 员工导入实现: `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/service/impl/CcdiEmployeeImportServiceImpl.java`
- 招聘导入实现: `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/service/impl/CcdiStaffRecruitmentImportServiceImpl.java`
- 员工导入实现: `ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/service/impl/CcdiEmployeeImportServiceImpl.java`
- 招聘导入实现: `ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/service/impl/CcdiStaffRecruitmentImportServiceImpl.java`
**关键依赖:**
- `ImportResultVO` - 导入结果VO(已存在,复用)
@@ -32,7 +32,7 @@
## Task 1: 创建个人中介导入失败记录VO
**文件:**
- Create: `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/domain/vo/IntermediaryPersonImportFailureVO.java`
- Create: `ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/domain/vo/IntermediaryPersonImportFailureVO.java`
**Step 1: 创建VO类**
@@ -84,13 +84,13 @@ public class IntermediaryPersonImportFailureVO implements Serializable {
**Step 2: 编译验证**
Run: `mvn compile -pl ruoyi-ccdi`
Run: `mvn compile -pl ruoyi-info-collection`
Expected: BUILD SUCCESS
**Step 3: 提交**
```bash
git add ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/domain/vo/IntermediaryPersonImportFailureVO.java
git add ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/domain/vo/IntermediaryPersonImportFailureVO.java
git commit -m "feat: 添加个人中介导入失败记录VO"
```
@@ -99,7 +99,7 @@ git commit -m "feat: 添加个人中介导入失败记录VO"
## Task 2: 创建实体中介导入失败记录VO
**文件:**
- Create: `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/domain/vo/IntermediaryEntityImportFailureVO.java`
- Create: `ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/domain/vo/IntermediaryEntityImportFailureVO.java`
**Step 1: 创建VO类**
@@ -152,13 +152,13 @@ public class IntermediaryEntityImportFailureVO implements Serializable {
**Step 2: 编译验证**
Run: `mvn compile -pl ruoyi-ccdi`
Run: `mvn compile -pl ruoyi-info-collection`
Expected: BUILD SUCCESS
**Step 3: 提交**
```bash
git add ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/domain/vo/IntermediaryEntityImportFailureVO.java
git add ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/domain/vo/IntermediaryEntityImportFailureVO.java
git commit -m "feat: 添加实体中介导入失败记录VO"
```
@@ -167,7 +167,7 @@ git commit -m "feat: 添加实体中介导入失败记录VO"
## Task 3: 创建个人中介导入Service接口
**文件:**
- Create: `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/service/ICcdiIntermediaryPersonImportService.java`
- Create: `ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/service/ICcdiIntermediaryPersonImportService.java`
**Step 1: 创建Service接口**
@@ -222,13 +222,13 @@ public interface ICcdiIntermediaryPersonImportService {
**Step 2: 编译验证**
Run: `mvn compile -pl ruoyi-ccdi`
Run: `mvn compile -pl ruoyi-info-collection`
Expected: BUILD SUCCESS
**Step 3: 提交**
```bash
git add ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/service/ICcdiIntermediaryPersonImportService.java
git add ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/service/ICcdiIntermediaryPersonImportService.java
git commit -m "feat: 添加个人中介异步导入Service接口"
```
@@ -237,7 +237,7 @@ git commit -m "feat: 添加个人中介异步导入Service接口"
## Task 4: 创建实体中介导入Service接口
**文件:**
- Create: `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/service/ICcdiIntermediaryEntityImportService.java`
- Create: `ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/service/ICcdiIntermediaryEntityImportService.java`
**Step 1: 创建Service接口**
@@ -292,13 +292,13 @@ public interface ICcdiIntermediaryEntityImportService {
**Step 2: 编译验证**
Run: `mvn compile -pl ruoyi-ccdi`
Run: `mvn compile -pl ruoyi-info-collection`
Expected: BUILD SUCCESS
**Step 3: 提交**
```bash
git add ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/service/ICcdiIntermediaryEntityImportService.java
git add ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/service/ICcdiIntermediaryEntityImportService.java
git commit -m "feat: 添加实体中介异步导入Service接口"
```
@@ -307,7 +307,7 @@ git commit -m "feat: 添加实体中介异步导入Service接口"
## Task 5: 实现个人中介异步导入Service
**文件:**
- Create: `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/service/impl/CcdiIntermediaryPersonImportServiceImpl.java`
- Create: `ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/service/impl/CcdiIntermediaryPersonImportServiceImpl.java`
**Step 1: 创建Service实现类**
@@ -515,13 +515,13 @@ public class CcdiIntermediaryPersonImportServiceImpl implements ICcdiIntermediar
**Step 2: 编译验证**
Run: `mvn compile -pl ruoyi-ccdi`
Run: `mvn compile -pl ruoyi-info-collection`
Expected: BUILD SUCCESS
**Step 3: 提交**
```bash
git add ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/service/impl/CcdiIntermediaryPersonImportServiceImpl.java
git add ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/service/impl/CcdiIntermediaryPersonImportServiceImpl.java
git commit -m "feat: 实现个人中介异步导入Service"
```
@@ -530,7 +530,7 @@ git commit -m "feat: 实现个人中介异步导入Service"
## Task 6: 实现实体中介异步导入Service
**文件:**
- Create: `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/service/impl/CcdiIntermediaryEntityImportServiceImpl.java`
- Create: `ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/service/impl/CcdiIntermediaryEntityImportServiceImpl.java`
**Step 1: 创建Service实现类**
@@ -737,13 +737,13 @@ public class CcdiIntermediaryEntityImportServiceImpl implements ICcdiIntermediar
**Step 2: 编译验证**
Run: `mvn compile -pl ruoyi-ccdi`
Run: `mvn compile -pl ruoyi-info-collection`
Expected: BUILD SUCCESS
**Step 3: 提交**
```bash
git add ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/service/impl/CcdiIntermediaryEntityImportServiceImpl.java
git add ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/service/impl/CcdiIntermediaryEntityImportServiceImpl.java
git commit -m "feat: 实现实体中介异步导入Service"
```
@@ -752,7 +752,7 @@ git commit -m "feat: 实现实体中介异步导入Service"
## Task 7: 修改Controller - 注入Service和添加辅助方法
**文件:**
- Modify: `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/controller/CcdiIntermediaryController.java`
- Modify: `ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/controller/CcdiIntermediaryController.java`
**Step 1: 添加导入Service注入**
@@ -801,13 +801,13 @@ private RedisTemplate<String, Object> redisTemplate;
**Step 4: 编译验证**
Run: `mvn compile -pl ruoyi-ccdi`
Run: `mvn compile -pl ruoyi-info-collection`
Expected: BUILD SUCCESS
**Step 5: 提交**
```bash
git add ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/controller/CcdiIntermediaryController.java
git add ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/controller/CcdiIntermediaryController.java
git commit -m "feat: Controller添加导入Service注入和辅助方法"
```
@@ -816,7 +816,7 @@ git commit -m "feat: Controller添加导入Service注入和辅助方法"
## Task 8: 修改Controller - 改造个人中介导入接口为异步
**文件:**
- Modify: `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/controller/CcdiIntermediaryController.java`
- Modify: `ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/controller/CcdiIntermediaryController.java`
**Step 1: 修改importPersonData方法**
@@ -865,13 +865,13 @@ public AjaxResult importPersonData(MultipartFile file,
**Step 2: 编译验证**
Run: `mvn compile -pl ruoyi-ccdi`
Run: `mvn compile -pl ruoyi-info-collection`
Expected: BUILD SUCCESS
**Step 3: 提交**
```bash
git add ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/controller/CcdiIntermediaryController.java
git add ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/controller/CcdiIntermediaryController.java
git commit -m "feat: 改造个人中介导入接口为异步"
```
@@ -880,7 +880,7 @@ git commit -m "feat: 改造个人中介导入接口为异步"
## Task 9: 修改Controller - 添加个人中介状态查询接口
**文件:**
- Modify: `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/controller/CcdiIntermediaryController.java`
- Modify: `ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/controller/CcdiIntermediaryController.java`
**Step 1: 添加getPersonImportStatus方法**
@@ -903,13 +903,13 @@ public AjaxResult getPersonImportStatus(@PathVariable String taskId) {
**Step 2: 编译验证**
Run: `mvn compile -pl ruoyi-ccdi`
Run: `mvn compile -pl ruoyi-info-collection`
Expected: BUILD SUCCESS
**Step 3: 提交**
```bash
git add ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/controller/CcdiIntermediaryController.java
git add ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/controller/CcdiIntermediaryController.java
git commit -m "feat: 添加个人中介导入状态查询接口"
```
@@ -918,7 +918,7 @@ git commit -m "feat: 添加个人中介导入状态查询接口"
## Task 10: 修改Controller - 添加个人中介失败记录查询接口
**文件:**
- Modify: `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/controller/CcdiIntermediaryController.java`
- Modify: `ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/controller/CcdiIntermediaryController.java`
**Step 1: 添加getPersonImportFailures方法**
@@ -949,13 +949,13 @@ public TableDataInfo getPersonImportFailures(
**Step 2: 编译验证**
Run: `mvn compile -pl ruoyi-ccdi`
Run: `mvn compile -pl ruoyi-info-collection`
Expected: BUILD SUCCESS
**Step 3: 提交**
```bash
git add ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/controller/CcdiIntermediaryController.java
git add ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/controller/CcdiIntermediaryController.java
git commit -m "feat: 添加个人中介导入失败记录查询接口"
```
@@ -964,7 +964,7 @@ git commit -m "feat: 添加个人中介导入失败记录查询接口"
## Task 11: 修改Controller - 改造实体中介导入接口为异步
**文件:**
- Modify: `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/controller/CcdiIntermediaryController.java`
- Modify: `ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/controller/CcdiIntermediaryController.java`
**Step 1: 修改importEntityData方法**
@@ -1013,13 +1013,13 @@ public AjaxResult importEntityData(MultipartFile file,
**Step 2: 编译验证**
Run: `mvn compile -pl ruoyi-ccdi`
Run: `mvn compile -pl ruoyi-info-collection`
Expected: BUILD SUCCESS
**Step 3: 提交**
```bash
git add ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/controller/CcdiIntermediaryController.java
git add ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/controller/CcdiIntermediaryController.java
git commit -m "feat: 改造实体中介导入接口为异步"
```
@@ -1028,7 +1028,7 @@ git commit -m "feat: 改造实体中介导入接口为异步"
## Task 12: 修改Controller - 添加实体中介状态查询接口
**文件:**
- Modify: `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/controller/CcdiIntermediaryController.java`
- Modify: `ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/controller/CcdiIntermediaryController.java`
**Step 1: 添加getEntityImportStatus方法**
@@ -1051,13 +1051,13 @@ public AjaxResult getEntityImportStatus(@PathVariable String taskId) {
**Step 2: 编译验证**
Run: `mvn compile -pl ruoyi-ccdi`
Run: `mvn compile -pl ruoyi-info-collection`
Expected: BUILD SUCCESS
**Step 3: 提交**
```bash
git add ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/controller/CcdiIntermediaryController.java
git add ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/controller/CcdiIntermediaryController.java
git commit -m "feat: 添加实体中介导入状态查询接口"
```
@@ -1066,7 +1066,7 @@ git commit -m "feat: 添加实体中介导入状态查询接口"
## Task 13: 修改Controller - 添加实体中介失败记录查询接口
**文件:**
- Modify: `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/controller/CcdiIntermediaryController.java`
- Modify: `ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/controller/CcdiIntermediaryController.java`
**Step 1: 添加getEntityImportFailures方法**
@@ -1097,13 +1097,13 @@ public TableDataInfo getEntityImportFailures(
**Step 2: 编译验证**
Run: `mvn compile -pl ruoyi-ccdi`
Run: `mvn compile -pl ruoyi-info-collection`
Expected: BUILD SUCCESS
**Step 3: 提交**
```bash
git add ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/controller/CcdiIntermediaryController.java
git add ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/controller/CcdiIntermediaryController.java
git commit -m "feat: 添加实体中介导入失败记录查询接口"
```
@@ -1924,7 +1924,7 @@ git commit -m "test: 添加中介导入测试脚本"
**Step 1: 编译后端**
Run: `mvn clean compile -pl ruoyi-ccdi`
Run: `mvn clean compile -pl ruoyi-info-collection`
Expected: BUILD SUCCESS
**Step 2: 检查前端语法**

View File

@@ -695,7 +695,7 @@ methods: {
#### 步骤1: 创建VO类
**文件:**
- `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/domain/vo/RecruitmentImportFailureVO.java`
- `ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/domain/vo/RecruitmentImportFailureVO.java`
**操作:**
- 创建`RecruitmentImportFailureVO`
@@ -705,7 +705,7 @@ methods: {
#### 步骤2: 创建Service接口
**文件:**
- `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/service/ICcdiStaffRecruitmentImportService.java`
- `ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/service/ICcdiStaffRecruitmentImportService.java`
**操作:**
- 创建Service接口
@@ -714,7 +714,7 @@ methods: {
#### 步骤3: 实现Service
**文件:**
- `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/service/impl/CcdiStaffRecruitmentImportServiceImpl.java`
- `ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/service/impl/CcdiStaffRecruitmentImportServiceImpl.java`
**操作:**
- 实现`ICcdiStaffRecruitmentImportService`接口
@@ -727,7 +727,7 @@ methods: {
#### 步骤4: 修改Controller
**文件:**
- `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/controller/CcdiStaffRecruitmentController.java`
- `ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/controller/CcdiStaffRecruitmentController.java`
**操作:**
- 注入`ICcdiStaffRecruitmentImportService`
@@ -807,16 +807,16 @@ git commit -m "feat: 实现招聘信息异步导入功能"
| 文件路径 | 说明 |
|---------|------|
| `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/domain/vo/RecruitmentImportFailureVO.java` | 招聘信息导入失败记录VO |
| `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/service/ICcdiStaffRecruitmentImportService.java` | 招聘信息异步导入Service接口 |
| `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/service/impl/CcdiStaffRecruitmentImportServiceImpl.java` | 招聘信息异步导入Service实现 |
| `ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/domain/vo/RecruitmentImportFailureVO.java` | 招聘信息导入失败记录VO |
| `ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/service/ICcdiStaffRecruitmentImportService.java` | 招聘信息异步导入Service接口 |
| `ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/service/impl/CcdiStaffRecruitmentImportServiceImpl.java` | 招聘信息异步导入Service实现 |
| `test/test_recruitment_import.py` | 测试脚本 |
### 7.2 修改文件
| 文件路径 | 修改内容 |
|---------|---------|
| `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/controller/CcdiStaffRecruitmentController.java` | 修改导入接口,添加状态查询和失败记录查询接口 |
| `ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/controller/CcdiStaffRecruitmentController.java` | 修改导入接口,添加状态查询和失败记录查询接口 |
| `ruoyi-ui/src/api/ccdiStaffRecruitment.js` | 添加导入状态和失败记录查询API |
| `ruoyi-ui/src/views/ccdiStaffRecruitment/index.vue` | 添加轮询逻辑和失败记录UI |
| `doc/api/ccdi_staff_recruitment_api.md` | 更新API文档 |

View File

@@ -60,7 +60,7 @@ ALTER TABLE cdi_biz_intermediary ADD UNIQUE KEY uk_person_id (person_id);
### Task 1: 添加个人中介批量导入方法接口
**文件:**
- 修改: `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/mapper/CcdiBizIntermediaryMapper.java`
- 修改: `ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/mapper/CcdiBizIntermediaryMapper.java`
**Step 1: 添加方法签名到接口**
@@ -81,7 +81,7 @@ void importPersonBatch(@Param("list") List<CcdiBizIntermediary> list);
```bash
cd .worktrees/intermediary-import-upsert
mvn compile -pl ruoyi-ccdi -am
mvn compile -pl ruoyi-info-collection -am
```
预期: 编译成功,无错误
@@ -89,7 +89,7 @@ mvn compile -pl ruoyi-ccdi -am
**Step 3: 提交**
```bash
git add ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/mapper/CcdiBizIntermediaryMapper.java
git add ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/mapper/CcdiBizIntermediaryMapper.java
git commit -m "feat: 添加个人中介批量导入方法签名
添加importPersonBatch方法到Mapper接口,用于支持ON DUPLICATE KEY UPDATE的批量导入操作。
@@ -102,7 +102,7 @@ Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>"
### Task 2: 实现个人中介批量导入SQL
**文件:**
- 修改: `ruoyi-ccdi/src/main/resources/mapper/ccdi/CcdiBizIntermediaryMapper.xml`
- 修改: `ruoyi-info-collection/src/main/resources/mapper/ccdi/CcdiBizIntermediaryMapper.xml`
**Step 1: 在XML文件中添加SQL实现**
@@ -137,7 +137,7 @@ Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>"
```bash
# 检查XML格式是否正确
xmllint --noout ruoyi-ccdi/src/main/resources/mapper/ccdi/CcdiBizIntermediaryMapper.xml
xmllint --noout ruoyi-info-collection/src/main/resources/mapper/ccdi/CcdiBizIntermediaryMapper.xml
```
预期: 无输出表示格式正确
@@ -145,7 +145,7 @@ xmllint --noout ruoyi-ccdi/src/main/resources/mapper/ccdi/CcdiBizIntermediaryMap
**Step 3: 验证编译**
```bash
mvn compile -pl ruoyi-ccdi -am
mvn compile -pl ruoyi-info-collection -am
```
预期: 编译成功
@@ -153,7 +153,7 @@ mvn compile -pl ruoyi-ccdi -am
**Step 4: 提交**
```bash
git add ruoyi-ccdi/src/main/resources/mapper/ccdi/CcdiBizIntermediaryMapper.xml
git add ruoyi-info-collection/src/main/resources/mapper/ccdi/CcdiBizIntermediaryMapper.xml
git commit -m "feat: 实现个人中介批量导入ON DUPLICATE KEY UPDATE SQL
使用INSERT ... ON DUPLICATE KEY UPDATE实现单次SQL完成插入或更新操作。
@@ -169,7 +169,7 @@ Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>"
### Task 3: 添加实体中介批量导入方法接口
**文件:**
- 修改: `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/mapper/CcdiEnterpriseBaseInfoMapper.java`
- 修改: `ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/mapper/CcdiEnterpriseBaseInfoMapper.java`
**Step 1: 添加方法签名到接口**
@@ -185,13 +185,13 @@ void importEntityBatch(@Param("list") List<CcdiEnterpriseBaseInfo> list);
**Step 2: 验证编译**
```bash
mvn compile -pl ruoyi-ccdi -am
mvn compile -pl ruoyi-info-collection -am
```
**Step 3: 提交**
```bash
git add ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/mapper/CcdiEnterpriseBaseInfoMapper.java
git add ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/mapper/CcdiEnterpriseBaseInfoMapper.java
git commit -m "feat: 添加实体中介批量导入方法签名
添加importEntityBatch方法到Mapper接口。
@@ -204,7 +204,7 @@ Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>"
### Task 4: 实现实体中介批量导入SQL
**文件:**
- 修改: `ruoyi-ccdi/src/main/resources/mapper/ccdi/CcdiEnterpriseBaseInfoMapper.xml`
- 修改: `ruoyi-info-collection/src/main/resources/mapper/ccdi/CcdiEnterpriseBaseInfoMapper.xml`
**Step 1: 在XML文件中添加SQL实现**
@@ -237,19 +237,19 @@ Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>"
**Step 2: 验证XML语法**
```bash
xmllint --noout ruoyi-ccdi/src/main/resources/mapper/ccdi/CcdiEnterpriseBaseInfoMapper.xml
xmllint --noout ruoyi-info-collection/src/main/resources/mapper/ccdi/CcdiEnterpriseBaseInfoMapper.xml
```
**Step 3: 验证编译**
```bash
mvn compile -pl ruoyi-ccdi -am
mvn compile -pl ruoyi-info-collection -am
```
**Step 4: 提交**
```bash
git add ruoyi-ccdi/src/main/resources/mapper/ccdi/CcdiEnterpriseBaseInfoMapper.xml
git add ruoyi-info-collection/src/main/resources/mapper/ccdi/CcdiEnterpriseBaseInfoMapper.xml
git commit -m "feat: 实现实体中介批量导入ON DUPLICATE KEY UPDATE SQL
使用INSERT ... ON DUPLICATE KEY UPDATE实现单次SQL完成插入或更新操作。
@@ -266,7 +266,7 @@ Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>"
### Task 5: 重构个人中介导入Service - 更新模式
**文件:**
- 修改: `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/service/impl/CcdiIntermediaryPersonImportServiceImpl.java`
- 修改: `ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/service/impl/CcdiIntermediaryPersonImportServiceImpl.java`
**Step 1: 修改 importPersonAsync 方法的核心导入逻辑**
@@ -361,13 +361,13 @@ private CcdiIntermediaryPersonExcel convertToExcel(CcdiBizIntermediary entity) {
**Step 4: 验证编译**
```bash
mvn compile -pl ruoyi-ccdi -am
mvn compile -pl ruoyi-info-collection -am
```
**Step 5: 提交**
```bash
git add ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/service/impl/CcdiIntermediaryPersonImportServiceImpl.java
git add ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/service/impl/CcdiIntermediaryPersonImportServiceImpl.java
git commit -m "refactor: 重构个人中介导入Service使用ON DUPLICATE KEY UPDATE
主要变更:
@@ -384,7 +384,7 @@ Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>"
### Task 6: 重构实体中介导入Service - 更新模式
**文件:**
- 修改: `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/service/impl/CcdiIntermediaryEntityImportServiceImpl.java`
- 修改: `ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/service/impl/CcdiIntermediaryEntityImportServiceImpl.java`
**Step 1: 修改 importEntityAsync 方法的核心导入逻辑**
@@ -475,13 +475,13 @@ private CcdiIntermediaryEntityExcel convertToExcel(CcdiEnterpriseBaseInfo entity
**Step 4: 验证编译**
```bash
mvn compile -pl ruoyi-ccdi -am
mvn compile -pl ruoyi-info-collection -am
```
**Step 5: 提交**
```bash
git add ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/service/impl/CcdiIntermediaryEntityImportServiceImpl.java
git add ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/service/impl/CcdiIntermediaryEntityImportServiceImpl.java
git commit -m "refactor: 重构实体中介导入Service使用ON DUPLICATE KEY UPDATE
与个人中介导入保持一致的实现方式。
@@ -496,7 +496,7 @@ Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>"
### Task 7: 编写个人中介导入单元测试
**文件:**
- 创建: `ruoyi-ccdi/src/test/java/com/ruoyi/ccdi/mapper/CcdiBizIntermediaryMapperTest.java`
- 创建: `ruoyi-info-collection/src/test/java/com/ruoyi/ccdi/mapper/CcdiBizIntermediaryMapperTest.java`
**Step 1: 创建测试类**
@@ -643,7 +643,7 @@ class CcdiBizIntermediaryMapperTest {
**Step 2: 运行测试**
```bash
mvn test -pl ruoyi-ccdi -Dtest=CcdiBizIntermediaryMapperTest
mvn test -pl ruoyi-info-collection -Dtest=CcdiBizIntermediaryMapperTest
```
预期: 所有测试通过 (3 tests, 0 failures)
@@ -651,7 +651,7 @@ mvn test -pl ruoyi-ccdi -Dtest=CcdiBizIntermediaryMapperTest
**Step 3: 提交**
```bash
git add ruoyi-ccdi/src/test/java/com/ruoyi/ccdi/mapper/CcdiBizIntermediaryMapperTest.java
git add ruoyi-info-collection/src/test/java/com/ruoyi/ccdi/mapper/CcdiBizIntermediaryMapperTest.java
git commit -m "test: 添加个人中介批量导入单元测试
覆盖场景:
@@ -668,7 +668,7 @@ Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>"
### Task 8: 编写实体中介导入单元测试
**文件:**
- 创建: `ruoyi-ccdi/src/test/java/com/ruoyi/ccdi/mapper/CcdiEnterpriseBaseInfoMapperTest.java`
- 创建: `ruoyi-info-collection/src/test/java/com/ruoyi/ccdi/mapper/CcdiEnterpriseBaseInfoMapperTest.java`
**Step 1: 创建测试类**
@@ -797,7 +797,7 @@ class CcdiEnterpriseBaseInfoMapperTest {
**Step 2: 运行测试**
```bash
mvn test -pl ruoyi-ccdi -Dtest=CcdiEnterpriseBaseInfoMapperTest
mvn test -pl ruoyi-info-collection -Dtest=CcdiEnterpriseBaseInfoMapperTest
```
预期: 所有测试通过
@@ -805,7 +805,7 @@ mvn test -pl ruoyi-ccdi -Dtest=CcdiEnterpriseBaseInfoMapperTest
**Step 3: 提交**
```bash
git add ruoyi-ccdi/src/test/java/com/ruoyi/ccdi/mapper/CcdiEnterpriseBaseInfoMapperTest.java
git add ruoyi-info-collection/src/test/java/com/ruoyi/ccdi/mapper/CcdiEnterpriseBaseInfoMapperTest.java
git commit -m "test: 添加实体中介批量导入单元测试
覆盖场景与个人中介测试一致。
@@ -818,7 +818,7 @@ Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>"
### Task 9: 集成测试 - 使用真实Excel文件
**文件:**
- 创建: `ruoyi-ccdi/src/test/java/com/ruoyi/ccdi/service/CcdiIntermediaryImportIntegrationTest.java`
- 创建: `ruoyi-info-collection/src/test/java/com/ruoyi/ccdi/service/CcdiIntermediaryImportIntegrationTest.java`
**Step 1: 创建集成测试**
@@ -927,13 +927,13 @@ class CcdiIntermediaryImportIntegrationTest {
**Step 2: 运行集成测试**
```bash
mvn test -pl ruoyi-ccdi -Dtest=CcdiIntermediaryImportIntegrationTest
mvn test -pl ruoyi-info-collection -Dtest=CcdiIntermediaryImportIntegrationTest
```
**Step 3: 提交**
```bash
git add ruoyi-ccdi/src/test/java/com/ruoyi/ccdi/service/CcdiIntermediaryImportIntegrationTest.java
git add ruoyi-info-collection/src/test/java/com/ruoyi/ccdi/service/CcdiIntermediaryImportIntegrationTest.java
git commit -m "test: 添加中介导入集成测试
测试端到端的导入流程,包括:
@@ -1011,7 +1011,7 @@ Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>"
```bash
cd .worktrees/intermediary-import-upsert
mvn test -pl ruoyi-ccdi
mvn test -pl ruoyi-info-collection
```
预期: 所有测试通过,包括新增的测试和现有的回归测试
@@ -1019,10 +1019,10 @@ mvn test -pl ruoyi-ccdi
**Step 2: 检查测试覆盖率(可选)**
```bash
mvn jacoco:report -pl ruoyi-ccdi
mvn jacoco:report -pl ruoyi-info-collection
```
查看覆盖率报告: `ruoyi-ccdi/target/site/jacoco/index.html`
查看覆盖率报告: `ruoyi-info-collection/target/site/jacoco/index.html`
**Step 3: 记录测试结果**
@@ -1082,7 +1082,7 @@ Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>"
```bash
# 运行代码检查(如果项目配置了checkstyle或spotbugs)
mvn checkstyle:check -pl ruoyi-ccdi
mvn checkstyle:check -pl ruoyi-info-collection
```
**Step 2: 检查未使用的导入**
@@ -1096,7 +1096,7 @@ mvn checkstyle:check -pl ruoyi-ccdi
**Step 4: 最终构建验证**
```bash
mvn clean package -pl ruoyi-ccdi -am -DskipTests
mvn clean package -pl ruoyi-info-collection -am -DskipTests
```
预期: 构建成功,生成jar文件
@@ -1174,10 +1174,10 @@ Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>"
### 影响范围
**影响的模块:**
- `ruoyi-ccdi/mapper/CcdiBizIntermediaryMapper`
- `ruoyi-ccdi/mapper/CcdiEnterpriseBaseInfoMapper`
- `ruoyi-ccdi/service/impl/CcdiIntermediaryPersonImportServiceImpl`
- `ruoyi-ccdi/service/impl/CcdiIntermediaryEntityImportServiceImpl`
- `ruoyi-info-collection/mapper/CcdiBizIntermediaryMapper`
- `ruoyi-info-collection/mapper/CcdiEnterpriseBaseInfoMapper`
- `ruoyi-info-collection/service/impl/CcdiIntermediaryPersonImportServiceImpl`
- `ruoyi-info-collection/service/impl/CcdiIntermediaryEntityImportServiceImpl`
**不影响:**
- Controller层 (无变更)
@@ -1318,7 +1318,7 @@ git worktree remove .worktrees/intermediary-import-upsert
**实施完成后,请在worktree中运行:**
```bash
mvn clean package -pl ruoyi-ccdi -am
mvn clean package -pl ruoyi-info-collection -am
```
验证构建成功后,即可合并分支或创建Pull Request。

View File

@@ -21,7 +21,7 @@
修改 `CcdiPurchaseTransactionExcel.java`,将数值字段类型从 String 改为 BigDecimal
**修改文件**:
- `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/domain/excel/CcdiPurchaseTransactionExcel.java:52-82`
- `ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/domain/excel/CcdiPurchaseTransactionExcel.java:52-82`
**修改内容**:
```java
@@ -59,7 +59,7 @@ private BigDecimal bidAmount;
4. 使用 `getDataTable()` 方法返回分页格式
**修改文件**:
- `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/controller/CcdiPurchaseTransactionController.java:173-196`
- `ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/controller/CcdiPurchaseTransactionController.java:173-196`
**修改内容**:
```java
@@ -197,11 +197,11 @@ protected TableDataInfo getDataTable(List<?> list, long total) {
## 附录:相关文件
### 修改的文件
1. `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/domain/excel/CcdiPurchaseTransactionExcel.java`
2. `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/controller/CcdiPurchaseTransactionController.java`
1. `ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/domain/excel/CcdiPurchaseTransactionExcel.java`
2. `ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/controller/CcdiPurchaseTransactionController.java`
### 参考文件
1. `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/controller/CcdiEmployeeController.java` (员工信息管理,作为参考)
1. `ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/controller/CcdiEmployeeController.java` (员工信息管理,作为参考)
### 测试文件
1. `doc/test-data/purchase_transaction/generate-test-data.js` (测试数据生成脚本)

View File

@@ -268,7 +268,7 @@ Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
```bash
cd D:\ccdi\ccdi\.worktrees\intermediary-import-upsert
mvn compile -pl ruoyi-ccdi -am -q
mvn compile -pl ruoyi-info-collection -am -q
```
**结果:** ✅ 编译成功,无错误无警告

View File

@@ -130,7 +130,7 @@ Controller解析Excel
#### 文件1: CcdiIntermediaryServiceImpl.java
**路径**: `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/service/impl/CcdiIntermediaryServiceImpl.java`
**路径**: `ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/service/impl/CcdiIntermediaryServiceImpl.java`
**需要添加的依赖注入**:
```java
@@ -200,7 +200,7 @@ public String importIntermediaryPerson(List<CcdiIntermediaryPersonExcel> list,
#### 文件2: CcdiIntermediaryController.java
**路径**: `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/controller/CcdiIntermediaryController.java`
**路径**: `ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/controller/CcdiIntermediaryController.java`
**需要添加的依赖注入**:
```java
@@ -614,7 +614,7 @@ ab -n 100 -c 10 -T "multipart/form-data; boundary=----WebKitFormBoundary" \
2. **编译打包**
```bash
# 后端
cd ruoyi-ccdi
cd ruoyi-info-collection
mvn clean package
# 前端

View File

@@ -528,7 +528,7 @@ CREATE TABLE ccdi_transaction_category (
### 3.1 后端模块划分
```
ruoyi-ccdi/ (新建模块)
ruoyi-info-collection/ (新建模块)
├── controller/
│ ├── CcdiProjectController.java # 项目管理
│ ├── CcdiDataUploadController.java # 数据上传

View File

@@ -8,7 +8,7 @@
### CcdiStaffEnterpriseRelationVO.java
文件位置: `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/domain/vo/CcdiStaffEnterpriseRelationVO.java`
文件位置: `ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/domain/vo/CcdiStaffEnterpriseRelationVO.java`
| 检查项 | 状态 | 说明 |
|--------|------|------|
@@ -29,7 +29,7 @@ private String personName;
### CcdiStaffEnterpriseRelationMapper.xml
文件位置: `ruoyi-ccdi/src/main/resources/mapper/ccdi/CcdiStaffEnterpriseRelationMapper.xml`
文件位置: `ruoyi-info-collection/src/main/resources/mapper/ccdi/CcdiStaffEnterpriseRelationMapper.xml`
| 检查项 | 状态 | 说明 |
|--------|------|------|
@@ -295,8 +295,8 @@ eec2f8c feat(staff-enterprise-relation): Task 6完成后端编译验证
### 文件变更统计
**后端文件:**
- `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/domain/vo/CcdiStaffEnterpriseRelationVO.java` (添加personName字段)
- `ruoyi-ccdi/src/main/resources/mapper/ccdi/CcdiStaffEnterpriseRelationMapper.xml` (添加LEFT JOIN和ResultMap映射)
- `ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/domain/vo/CcdiStaffEnterpriseRelationVO.java` (添加personName字段)
- `ruoyi-info-collection/src/main/resources/mapper/ccdi/CcdiStaffEnterpriseRelationMapper.xml` (添加LEFT JOIN和ResultMap映射)
**前端文件:**
- `ruoyi-ui/src/views/ccdiStaffEnterpriseRelation/index.vue` (添加员工姓名列)

View File

@@ -3,7 +3,7 @@
**审查日期:** 2026-02-11
**审查人:** Code Review Agent
**修复提交:** af7ec6f43dc1c8a80fe23cb5a437eef27ea5002d
**审查文件:** `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/service/impl/CcdiStaffEnterpriseRelationImportServiceImpl.java`
**审查文件:** `ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/service/impl/CcdiStaffEnterpriseRelationImportServiceImpl.java`
---

View File

@@ -30,7 +30,7 @@
```bash
# 在采购交易导入服务中搜索身份证号存在性检查
grep -n "CcdiBaseStaff\|existingPersonIds\|身份证.*存在" \
ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/service/impl/CcdiPurchaseTransactionImportServiceImpl.java
ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/service/impl/CcdiPurchaseTransactionImportServiceImpl.java
# 结果No matches found
```
@@ -251,4 +251,4 @@ if (!addDTO.getPersonId().matches("^[1-9]\\d{5}(18|19|20)\\d{2}(0[1-9]|1[0-2])(0
- [员工实体关系信息维护功能设计文档](../design/staff-enterprise-relation/员工实体关系信息维护功能设计文档.md)
- [2026-02-11 员工实体关系导入代码审查报告(修复后复审)](./2026-02-11-staff-relation-import-fix-review.md)
- [采购交易管理功能实现](../../ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/service/impl/CcdiPurchaseTransactionImportServiceImpl.java)
- [采购交易管理功能实现](../../ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/service/impl/CcdiPurchaseTransactionImportServiceImpl.java)

View File

@@ -374,12 +374,12 @@ ccdi_base_staff.name → 映射为 VO.personName
### 8.1 项目内参考实现
1. **员工亲属关系模块** (正确实现):
- 文件: `ruoyi-ccdi/src/main/resources/mapper/ccdi/CcdiStaffFmyRelationMapper.xml`
- 文件: `ruoyi-info-collection/src/main/resources/mapper/ccdi/CcdiStaffFmyRelationMapper.xml`
- 提交: 历史提交记录
- 特点: 完整实现personName字段的查询和映射
2. **员工调动模块** (正确实现):
- 文件: `ruoyi-ccdi/src/main/resources/mapper/ccdi/CcdiStaffTransferMapper.xml`
- 文件: `ruoyi-info-collection/src/main/resources/mapper/ccdi/CcdiStaffTransferMapper.xml`
- 特点: 类似的staffName字段实现
### 8.2 数据库文档

Binary file not shown.

After

Width:  |  Height:  |  Size: 52 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 41 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 54 KiB

View File

View File

@@ -129,7 +129,7 @@ doc/数据库文档/员工调动记录/04_add_unique_index.sql
### Java源码
```
ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/
ruoyi-info-collection/src/main/java/com/ruoyi/ccdi/
├── domain/dto/
│ └── TransferUniqueKey.java [新增]
├── mapper/

View File

@@ -34,7 +34,7 @@
### 2. 后端代码 ✓
**文件位置**: `D:\ccdi\ccdi\ruoyi-ccdi\src\main\java\com\ruoyi\ccdi\`
**文件位置**: `D:\ccdi\ccdi\ruoyi-info-collection\src\main\java\com\ruoyi\ccdi\`
#### 2.1 实体类 (1个)
- `CcdiStaffTransfer.java` - 员工调动记录实体

File diff suppressed because it is too large Load Diff

File diff suppressed because it is too large Load Diff

View File

@@ -1,962 +0,0 @@
# 信贷客户家庭关系维护功能实施计划
> **For Claude:** REQUIRED SUB-SKILL: Use superpowers:executing-plans to implement this plan task-by-task.
**目标:** 开发信贷客户家庭关系维护功能实现对信贷客户家庭成员信息的完整CRUD操作
**架构:** 完全复用员工亲属关系维护功能的实现逻辑,创建独立模块 `CustFamilyRelation`,新建独立表 `ccdi_cust_fmy_relation`
**技术栈:** Spring Boot 3.5.8 + MyBatis Plus 3.5.10 + Vue 2.6.12 + Element UI 2.15.14 + EasyExcel + Redis
---
## 前置准备
### Task 0: 创建数据库表
**Files:**
- Create: `sql/ccdi_cust_fmy_relation.sql`
**Step 1: 创建建表SQL文件**
```sql
-- 信贷客户家庭关系表
CREATE TABLE `ccdi_cust_fmy_relation` (
`id` BIGINT NOT NULL AUTO_INCREMENT COMMENT '主键ID',
`person_id` VARCHAR(50) NOT NULL COMMENT '信贷客户身份证号',
`relation_type` VARCHAR(50) NOT NULL COMMENT '关系类型',
`relation_name` VARCHAR(100) NOT NULL COMMENT '关系人姓名',
`gender` CHAR(1) DEFAULT NULL COMMENT '性别M-男F-女O-其他',
`birth_date` DATE DEFAULT NULL COMMENT '关系人出生日期',
`relation_cert_type` VARCHAR(50) NOT NULL COMMENT '证件类型',
`relation_cert_no` VARCHAR(50) NOT NULL COMMENT '证件号码',
`mobile_phone1` VARCHAR(20) DEFAULT NULL COMMENT '手机号码1',
`mobile_phone2` VARCHAR(20) DEFAULT NULL COMMENT '手机号码2',
`wechat_no1` VARCHAR(50) DEFAULT NULL COMMENT '微信名称1',
`wechat_no2` VARCHAR(50) DEFAULT NULL COMMENT '微信名称2',
`wechat_no3` VARCHAR(50) DEFAULT NULL COMMENT '微信名称3',
`contact_address` VARCHAR(500) DEFAULT NULL COMMENT '详细联系地址',
`relation_desc` VARCHAR(500) DEFAULT NULL COMMENT '关系详细描述',
`status` INT NOT NULL DEFAULT 1 COMMENT '状态0-无效1-有效',
`effective_date` DATETIME DEFAULT NULL COMMENT '关系生效日期',
`invalid_date` DATETIME DEFAULT NULL COMMENT '关系失效日期',
`remark` TEXT COMMENT '备注信息',
`data_source` VARCHAR(50) DEFAULT NULL COMMENT '数据来源MANUAL-手动录入IMPORT-批量导入',
`is_emp_family` TINYINT(1) NOT NULL DEFAULT 0 COMMENT '是否是员工的家庭关系0-否',
`is_cust_family` TINYINT(1) NOT NULL DEFAULT 1 COMMENT '是否是信贷客户的家庭关系1-是',
`created_by` VARCHAR(50) NOT NULL COMMENT '记录创建人',
`updated_by` VARCHAR(50) DEFAULT NULL COMMENT '记录更新人',
`create_time` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '记录创建时间',
`update_time` DATETIME DEFAULT NULL ON UPDATE CURRENT_TIMESTAMP COMMENT '记录更新时间',
PRIMARY KEY (`id`),
KEY `idx_person_id` (`person_id`),
KEY `idx_relation_cert_no` (`relation_cert_no`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='信贷客户家庭关系表';
```
**Step 2: 执行SQL创建表**
Run: 连接数据库并执行 `sql/ccdi_cust_fmy_relation.sql`
Expected: 表创建成功
**Step 3: Commit**
```bash
git add sql/ccdi_cust_fmy_relation.sql
git commit -m "feat: 创建信贷客户家庭关系表"
```
---
## 后端开发
### Task 1: 创建实体类
**Files:**
- Create: `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/domain/CcdiCustFmyRelation.java`
- Reference: `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/domain/CcdiStaffFmyRelation.java:1-108`
**Step 1: 创建实体类**
复制 `CcdiStaffFmyRelation.java`,修改以下内容:
- 类名: `CcdiCustFmyRelation`
- 注释: `信贷客户家庭关系对象 ccdi_cust_fmy_relation`
- 表名: `@TableName("ccdi_cust_fmy_relation")`
- JavaDoc: 全部替换"员工"为"信贷客户"
```java
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_cust_fmy_relation
*
* @author ruoyi
* @date 2026-02-11
*/
@Data
@TableName("ccdi_cust_fmy_relation")
public class CcdiCustFmyRelation implements Serializable {
@Serial
private static final long serialVersionUID = 1L;
/** 主键ID */
@TableId(type = IdType.AUTO)
private Long id;
/** 信贷客户身份证号 */
private String personId;
/** 关系类型 */
private String relationType;
/** 关系人姓名 */
private String relationName;
/** 性别M-男F-女O-其他 */
private String gender;
/** 出生日期 */
private Date birthDate;
/** 关系人证件类型 */
private String relationCertType;
/** 关系人证件号码 */
private String relationCertNo;
/** 手机号码1 */
private String mobilePhone1;
/** 手机号码2 */
private String mobilePhone2;
/** 微信名称1 */
private String wechatNo1;
/** 微信名称2 */
private String wechatNo2;
/** 微信名称3 */
private String wechatNo3;
/** 详细联系地址 */
private String contactAddress;
/** 关系详细描述 */
private String relationDesc;
/** 状态0-无效1-有效 */
private Integer status;
/** 生效日期 */
private Date effectiveDate;
/** 失效日期 */
private Date invalidDate;
/** 备注 */
private String remark;
/** 数据来源MANUAL-手工录入IMPORT-导入 */
private String dataSource;
/** 是否是员工亲属0-否 */
private Boolean isEmpFamily;
/** 是否是客户亲属1-是 */
private Boolean isCustFamily;
/** 创建时间 */
@TableField(fill = FieldFill.INSERT)
private Date createTime;
/** 更新时间 */
@TableField(fill = FieldFill.INSERT_UPDATE)
private Date updateTime;
/** 创建人 */
@TableField(fill = FieldFill.INSERT)
private String createdBy;
/** 更新人 */
@TableField(fill = FieldFill.INSERT_UPDATE)
private String updatedBy;
}
```
**Step 2: Compile**
Run: `mvn compile -pl ruoyi-ccdi`
Expected: BUILD SUCCESS
**Step 3: Commit**
```bash
git add ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/domain/CcdiCustFmyRelation.java
git commit -m "feat: 添加信贷客户家庭关系实体类"
```
---
### Task 2: 创建DTO类
**Files:**
- Create: `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/domain/dto/CcdiCustFmyRelationAddDTO.java`
- Create: `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/domain/dto/CcdiCustFmyRelationEditDTO.java`
- Create: `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/domain/dto/CcdiCustFmyRelationQueryDTO.java`
- Reference: `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/domain/dto/CcdiStaffFmyRelationAddDTO.java`
**Step 1: 创建AddDTO**
复制 `CcdiStaffFmyRelationAddDTO.java`,修改:
- 类名: `CcdiCustFmyRelationAddDTO`
- 注释中"员工" → "信贷客户"
- personId字段注释: `@Schema(description = "信贷客户身份证号")`
- 验证消息: "员工身份证号" → "信贷客户身份证号"
**Step 2: 创建EditDTO**
复制 `CcdiStaffFmyRelationEditDTO.java`,修改:
- 类名: `CcdiCustFmyRelationEditDTO`
- 注释中"员工" → "信贷客户"
- 添加 `id` 字段和 `@NotNull` 验证
**Step 3: 创建QueryDTO简化版**
```java
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-11
*/
@Data
@Schema(description = "信贷客户家庭关系查询")
public class CcdiCustFmyRelationQueryDTO implements Serializable {
@Serial
private static final long serialVersionUID = 1L;
/** 信贷客户身份证号 */
@Schema(description = "信贷客户身份证号")
private String personId;
/** 关系类型 */
@Schema(description = "关系类型")
private String relationType;
/** 关系人姓名 */
@Schema(description = "关系人姓名")
private String relationName;
}
```
**Step 4: Compile**
Run: `mvn compile -pl ruoyi-ccdi`
Expected: BUILD SUCCESS
**Step 5: Commit**
```bash
git add ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/domain/dto/
git commit -m "feat: 添加信贷客户家庭关系DTO类"
```
---
### Task 3: 创建VO类
**Files:**
- Create: `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/domain/vo/CcdiCustFmyRelationVO.java`
- Create: `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/domain/vo/CustFmyRelationImportFailureVO.java`
- Reference: `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/domain/vo/CcdiStaffFmyRelationVO.java`
**Step 1: 创建主VO**
复制 `CcdiStaffFmyRelationVO.java`,修改:
- 类名: `CcdiCustFmyRelationVO`
- 移除 `personName` 字段(不关联其他表)
- 注释中"员工" → "信贷客户"
**Step 2: 创建导入失败VO**
复制 `StaffFmyRelationImportFailureVO.java`,修改:
- 类名: `CustFmyRelationImportFailureVO`
- 注释中"员工" → "信贷客户"
**Step 3: Compile**
Run: `mvn compile -pl ruoyi-ccdi`
Expected: BUILD SUCCESS
**Step 4: Commit**
```bash
git add ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/domain/vo/
git commit -m "feat: 添加信贷客户家庭关系VO类"
```
---
### Task 4: 创建Excel类
**Files:**
- Create: `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/domain/excel/CcdiCustFmyRelationExcel.java`
- Reference: `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/domain/excel/CcdiStaffFmyRelationExcel.java`
**Step 1: 创建Excel类**
复制 `CcdiStaffFmyRelationExcel.java`,修改:
- 类名: `CcdiCustFmyRelationExcel`
- 注释: `信贷客户家庭关系Excel导入导出对象`
- personId字段: `@ExcelProperty(value = "信贷客户身份证号*", index = 0)`
- 其他保持不变
**Step 2: Compile**
Run: `mvn compile -pl ruoyi-ccdi`
Expected: BUILD SUCCESS
**Step 3: Commit**
```bash
git add ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/domain/excel/CcdiCustFmyRelationExcel.java
git commit -m "feat: 添加信贷客户家庭关系Excel类"
```
---
### Task 5: 创建Mapper接口
**Files:**
- Create: `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/mapper/CcdiCustFmyRelationMapper.java`
- Reference: `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/mapper/CcdiStaffFmyRelationMapper.java`
**Step 1: 创建Mapper接口**
复制 `CcdiStaffFmyRelationMapper.java`,修改:
- 包名和导入: 全部 `Staff``Cust`
- 类名: `CcdiCustFmyRelationMapper`
- 泛型: `CcdiCustFmyRelation`
- DTO: `CcdiCustFmyRelationQueryDTO`
- VO: `CcdiCustFmyRelationVO`
- 方法注释: "员工" → "信贷客户"
**Step 2: Compile**
Run: `mvn compile -pl ruoyi-ccdi`
Expected: BUILD SUCCESS
**Step 3: Commit**
```bash
git add ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/mapper/CcdiCustFmyRelationMapper.java
git commit -m "feat: 添加信贷客户家庭关系Mapper接口"
```
---
### Task 6: 创建Mapper XML映射
**Files:**
- Create: `ruoyi-ccdi/src/main/resources/mapper/ccdi/CcdiCustFmyRelationMapper.xml`
- Reference: `ruoyi-ccdi/src/main/resources/mapper/ccdi/CcdiStaffFmyRelationMapper.xml`
**Step 1: 创建XML映射文件**
复制 `CcdiStaffFmyRelationMapper.xml`,修改:
- namespace: `com.ruoyi.ccdi.mapper.CcdiCustFmyRelationMapper`
- resultMap: `CcdiCustFmyRelationVOResult`
- type: `com.ruoyi.ccdi.domain.vo.CcdiCustFmyRelationVO`
- 表名: `ccdi_cust_fmy_relation`
- **移除 LEFT JOIN**(不关联员工表)
- WHERE条件: `r.is_cust_family = 1`
- **移除 personName 相关字段**
```xml
<!-- 关键修改移除LEFT JOIN和person_name -->
<select id="selectRelationPage" resultMap="CcdiCustFmyRelationVOResult">
SELECT
r.id, r.person_id, r.relation_type, r.relation_name,
r.gender, r.birth_date, r.relation_cert_type, r.relation_cert_no,
r.mobile_phone1, r.mobile_phone2, r.wechat_no1, r.wechat_no2, r.wechat_no3,
r.contact_address, r.relation_desc, r.effective_date, r.invalid_date,
r.status, r.remark, r.data_source, r.is_emp_family, r.is_cust_family,
r.created_by, r.create_time, r.updated_by, r.update_time
FROM ccdi_cust_fmy_relation r
<where>
r.is_cust_family = 1
<if test="query.personId != null and query.personId != ''">
AND r.person_id = #{query.personId}
</if>
<if test="query.relationType != null and query.relationType != ''">
AND r.relation_type = #{query.relationType}
</if>
<if test="query.relationName != null and query.relationName != ''">
AND r.relation_name LIKE CONCAT('%', #{query.relationName}, '%')
</if>
</where>
ORDER BY r.create_time DESC
</select>
```
- selectExistingRelations: `is_cust_family = 1`
**Step 2: Compile**
Run: `mvn compile -pl ruoyi-ccdi`
Expected: BUILD SUCCESS
**Step 3: Commit**
```bash
git add ruoyi-ccdi/src/main/resources/mapper/ccdi/CcdiCustFmyRelationMapper.xml
git commit -m "feat: 添加信贷客户家庭关系Mapper XML映射"
```
---
### Task 7: 创建Service接口
**Files:**
- Create: `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/service/ICcdiCustFmyRelationService.java`
- Create: `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/service/ICcdiCustFmyRelationImportService.java`
- Reference: `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/service/ICcdiStaffFmyRelationService.java`
**Step 1: 创建主Service接口**
复制 `ICcdiStaffFmyRelationService.java`,修改:
- 接口名: `ICcdiCustFmyRelationService`
- 泛型: `CcdiCustFmyRelationVO`, `CcdiCustFmyRelationQueryDTO`, `CcdiCustFmyRelationAddDTO`, `CcdiCustFmyRelationEditDTO`, `CcdiCustFmyRelationExcel`
**Step 2: 创建导入Service接口**
复制 `ICcdiStaffFmyRelationImportService.java`,修改:
- 接口名: `ICcdiCustFmyRelationImportService`
- 泛型: `CcdiCustFmyRelationExcel`, `CustFmyRelationImportFailureVO`
**Step 3: Compile**
Run: `mvn compile -pl ruoyi-ccdi`
Expected: BUILD SUCCESS
**Step 4: Commit**
```bash
git add ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/service/
git commit -m "feat: 添加信贷客户家庭关系Service接口"
```
---
### Task 8: 创建Service实现类
**Files:**
- Create: `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/service/impl/CcdiCustFmyRelationServiceImpl.java`
- Create: `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/service/impl/CcdiCustFmyRelationImportServiceImpl.java`
- Reference: `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/service/impl/CcdiStaffFmyRelationServiceImpl.java`
**Step 1: 创建主Service实现类**
复制 `CcdiStaffFmyRelationServiceImpl.java`,修改:
- 类名: `CcdiCustFmyRelationServiceImpl`
- Mapper注入: `CcdiCustFmyRelationMapper`
- ImportService注入: `ICcdiCustFmyRelationImportService`
- 泛型: `CcdiCustFmyRelationVO`, `CcdiCustFmyRelationQueryDTO`
- **关键修改**:
- `relation.setIsEmpFamily(false);`
- `relation.setIsCustFamily(true);`
- Redis Key: `import:custFmyRelation:`
**Step 2: 创建导入Service实现类**
复制 `CcdiStaffFmyRelationImportServiceImpl.java`,修改:
- 类名: `CcdiCustFmyRelationImportServiceImpl`
- Mapper注入: `CcdiCustFmyRelationMapper`
- 泛型: `CcdiCustFmyRelationExcel`, `CustFmyRelationImportFailureVO`
- Redis Key: `import:custFmyRelation:`
- 错误消息: "信贷客户身份证号"
**Step 3: Compile**
Run: `mvn compile -pl ruoyi-ccdi`
Expected: BUILD SUCCESS
**Step 4: Commit**
```bash
git add ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/service/impl/
git commit -m "feat: 添加信贷客户家庭关系Service实现类"
```
---
### Task 9: 创建Controller
**Files:**
- Create: `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/controller/CcdiCustFmyRelationController.java`
- Reference: `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/controller/CcdiStaffFmyRelationController.java`
**Step 1: 创建Controller**
复制 `CcdiStaffFmyRelationController.java`,修改:
- 类名: `CcdiCustFmyRelationController`
- Tag: `@Tag(name = "信贷客户家庭关系管理")`
- RequestMapping: `/ccdi/custFmyRelation`
- Service注入: `ICcdiCustFmyRelationService`, `ICcdiCustFmyRelationImportService`
- DTO/VO: 对应的 `CcdiCust...` 类型
- 权限标识: `ccdi:custFmyRelation:*`
- 注释: "员工" → "信贷客户"
**Step 2: Compile**
Run: `mvn compile -pl ruoyi-ccdi`
Expected: BUILD SUCCESS
**Step 3: Commit**
```bash
git add ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/controller/CcdiCustFmyRelationController.java
git commit -m "feat: 添加信贷客户家庭关系Controller"
```
---
## 前端开发
### Task 10: 创建API接口文件
**Files:**
- Create: `ruoyi-ui/src/api/ccdiCustFmyRelation.js`
- Reference: `ruoyi-ui/src/api/ccdiStaffFmyRelation.js`
**Step 1: 创建API文件**
复制 `ccdiStaffFmyRelation.js`,修改:
- url路径: `/ccdi/custFmyRelation`
- 移除 `getStaffList` 方法(不需要)
```javascript
import request from '@/utils/request'
// 查询信贷客户家庭关系列表
export function listRelation(query) {
return request({
url: '/ccdi/custFmyRelation/list',
method: 'get',
params: query
})
}
// 查询信贷客户家庭关系详细
export function getRelation(id) {
return request({
url: '/ccdi/custFmyRelation/' + id,
method: 'get'
})
}
// 新增信贷客户家庭关系
export function addRelation(data) {
return request({
url: '/ccdi/custFmyRelation',
method: 'post',
data: data
})
}
// 修改信贷客户家庭关系
export function updateRelation(data) {
return request({
url: '/ccdi/custFmyRelation',
method: 'put',
data: data
})
}
// 删除信贷客户家庭关系
export function delRelation(ids) {
return request({
url: '/ccdi/custFmyRelation/' + ids,
method: 'delete'
})
}
// 导出信贷客户家庭关系
export function exportRelation(query) {
return request({
url: '/ccdi/custFmyRelation/export',
method: 'post',
params: query
})
}
// 下载导入模板
export function importTemplate() {
return request({
url: '/ccdi/custFmyRelation/importTemplate',
method: 'post'
})
}
// 导入信贷客户家庭关系
export function importData(file) {
const formData = new FormData()
formData.append('file', file)
return request({
url: '/ccdi/custFmyRelation/importData',
method: 'post',
data: formData
})
}
// 查询导入状态
export function getImportStatus(taskId) {
return request({
url: '/ccdi/custFmyRelation/importStatus/' + taskId,
method: 'get'
})
}
// 查询导入失败记录
export function getImportFailures(taskId, pageNum, pageSize) {
return request({
url: '/ccdi/custFmyRelation/importFailures/' + taskId,
method: 'get',
params: { pageNum, pageSize }
})
}
```
**Step 2: Commit**
```bash
git add ruoyi-ui/src/api/ccdiCustFmyRelation.js
git commit -m "feat: 添加信贷客户家庭关系API接口"
```
---
### Task 11: 创建主页面组件
**Files:**
- Create: `ruoyi-ui/src/views/ccdiCustFmyRelation/index.vue`
- Reference: `ruoyi-ui/src/views/ccdiStaffFmyRelation/index.vue`
**Step 1: 创建页面组件**
复制 `ccdiStaffFmyRelation/index.vue`,修改:
1. **查询条件**(简化版):
```vue
<!-- 移除员工姓名输入框只保留personIdrelationTyperelationName -->
<el-form-item label="信贷客户身份证号" prop="personId">
<el-input
v-model="queryParams.personId"
placeholder="请输入信贷客户身份证号"
clearable
style="width: 240px"
@keyup.enter.native="handleQuery"
/>
</el-form-item>
<el-form-item label="关系类型" prop="relationType">
<el-select v-model="queryParams.relationType" placeholder="请选择关系类型" clearable style="width: 240px">
<el-option
v-for="dict in dict.type.ccdi_relation_type"
:key="dict.value"
:label="dict.label"
:value="dict.value"
/>
</el-select>
</el-form-item>
<el-form-item label="关系人姓名" prop="relationName">
<el-input
v-model="queryParams.relationName"
placeholder="请输入关系人姓名"
clearable
style="width: 240px"
@keyup.enter.native="handleQuery"
/>
</el-form-item>
<!-- 移除状态下拉框 -->
```
2. **列表列**移除personName
```vue
<el-table-column label="信贷客户身份证号" align="center" prop="personId" width="180"/>
<!-- 移除员工姓名列 -->
```
3. **表单**(使用普通输入框):
```vue
<!-- 信贷客户身份证号改为普通输入框不使用远程搜索 -->
<el-form-item label="信贷客户身份证号" prop="personId">
<el-input
v-model="form.personId"
placeholder="请输入信贷客户身份证号"
:disabled="!isAdd"
maxlength="18"
/>
</el-form-item>
```
4. **权限标识**:全部 `staffFmyRelation``custFmyRelation`
5. **导入localStorage**
```javascript
const STORAGE_KEY = 'cust_fmy_relation_import_last_task';
```
6. **字典类型**
```vue
<dict-tag :options="dict.type.ccdi_relation_type" :value="scope.row.relationType"/>
<dict-tag :options="dict.type.ccdi_indiv_gender" :value="scope.row.gender"/>
```
**Step 2: Commit**
```bash
git add ruoyi-ui/src/views/ccdiCustFmyRelation/index.vue
git commit -m "feat: 添加信贷客户家庭关系页面组件"
```
---
## 系统配置
### Task 12: 创建菜单权限SQL
**Files:**
- Create: `sql/ccdi_cust_fmy_relation_menu.sql`
- Reference: `sql/ccdi_staff_fmy_relation_menu.sql`
**Step 1: 创建菜单SQL**
```sql
-- 信贷客户家庭关系菜单
INSERT INTO sys_menu (menu_name, parent_id, order_num, path, component, is_frame, is_cache, menu_type, visible, status, perms, icon, create_by, create_time, update_by, update_time, remark)
VALUES
('信贷客户家庭关系', (SELECT menu_id FROM sys_menu WHERE menu_name = '信息维护' LIMIT 1), 5, 'custFmyRelation', 'ccdiCustFmyRelation/index', 1, 0, 'C', '0', '0', 'ccdi:custFmyRelation:list', 'peoples', 'admin', NOW(), '', NULL, '信贷客户家庭关系菜单');
-- 获取刚插入的菜单ID
SET @parent_id = LAST_INSERT_ID();
-- 添加按钮权限
INSERT INTO sys_menu (menu_name, parent_id, order_num, path, component, is_frame, is_cache, menu_type, visible, status, perms, icon, create_by, create_time, update_by, update_time, remark) VALUES
('信贷客户家庭关系查询', @parent_id, 1, '#', '', 1, 0, 'F', '0', '0', 'ccdi:custFmyRelation:query', '#', 'admin', NOW(), '', NULL, ''),
('信贷客户家庭关系新增', @parent_id, 2, '#', '', 1, 0, 'F', '0', '0', 'ccdi:custFmyRelation:add', '#', 'admin', NOW(), '', NULL, ''),
('信贷客户家庭关系修改', @parent_id, 3, '#', '', 1, 0, 'F', '0', '0', 'ccdi:custFmyRelation:edit', '#', 'admin', NOW(), '', NULL, ''),
('信贷客户家庭关系删除', @parent_id, 4, '#', '', 1, 0, 'F', '0', '0', 'ccdi:custFmyRelation:remove', '#', 'admin', NOW(), '', NULL, ''),
('信贷客户家庭关系导出', @parent_id, 5, '#', '', 1, 0, 'F', '0', '0', 'ccdi:custFmyRelation:export', '#', 'admin', NOW(), '', NULL, ''),
('信贷客户家庭关系导入', @parent_id, 6, '#', '', 1, 0, 'F', '0', '0', 'ccdi:custFmyRelation:import', '#', 'admin', NOW(), '', NULL, '');
```
**Step 2: Commit**
```bash
git add sql/ccdi_cust_fmy_relation_menu.sql
git commit -m "feat: 添加信贷客户家庭关系菜单权限"
```
---
### Task 13: 配置字典数据
**Files:**
- Modify: 通过系统管理界面配置
**Step 1: 确认字典存在**
登录系统 → 系统管理 → 字典管理,确认以下字典类型已存在:
- `ccdi_relation_type`:关系类型
- `ccdi_indiv_gender`:性别
- `ccdi_certificate_type`:证件类型
如不存在,参考员工亲属关系的字典数据添加。
---
## 测试验证
### Task 14: 后端接口测试
**Files:**
- Create: `doc/reviews/cust-fmy-relation-api-test.md`
**Step 1: 启动后端服务**
Run: `mvn spring-boot:run -pl ruoyi-admin`
Expected: 服务启动成功,访问 http://localhost:8080/swagger-ui/index.html
**Step 2: 测试登录获取token**
Run:
```bash
curl -X POST "http://localhost:8080/login" \
-H "Content-Type: application/json" \
-d '{"username":"admin","password":"admin123"}'
```
Expected: 返回token
**Step 3: 测试查询列表接口**
Run:
```bash
curl -X GET "http://localhost:8080/ccdi/custFmyRelation/list?pageNum=1&pageSize=10" \
-H "Authorization: Bearer <token>"
```
Expected: 返回空列表(无数据)
**Step 4: 测试新增接口**
Run:
```bash
curl -X POST "http://localhost:8080/ccdi/custFmyRelation" \
-H "Authorization: Bearer <token>" \
-H "Content-Type: application/json" \
-d '{
"personId": "110101199001011234",
"relationType": "配偶",
"relationName": "张三",
"gender": "M",
"relationCertType": "身份证",
"relationCertNo": "110101199001015678"
}'
```
Expected: 返回成功
**Step 5: 测试查询详情接口**
Run:
```bash
curl -X GET "http://localhost:8080/ccdi/custFmyRelation/1" \
-H "Authorization: Bearer <token>"
```
Expected: 返回刚插入的记录
---
### Task 15: 前端功能测试
**Step 1: 启动前端服务**
Run: `cd ruoyi-ui && npm run dev`
Expected: 服务启动成功,访问 http://localhost
**Step 2: 登录系统**
用户名: admin
密码: admin123
**Step 3: 导航到信贷客户家庭关系页面**
路径: 信息维护 → 信贷客户家庭关系
**Step 4: 测试新增功能**
1. 点击"新增"按钮
2. 填写表单:
- 信贷客户身份证号: `110101199001011234`
- 关系类型: `配偶`
- 关系人姓名: `张三`
- 性别: `男`
- 证件类型: `身份证`
- 证件号码: `110101199001015678`
3. 点击"确定"
Expected: 新增成功,列表显示新记录
**Step 5: 测试编辑功能**
1. 点击"编辑"按钮
2. 修改关系人姓名为 `张三丰`
3. 点击"确定"
Expected: 修改成功,列表显示更新
**Step 6: 测试删除功能**
1. 勾选记录
2. 点击"删除"按钮
3. 确认删除
Expected: 删除成功,列表不再显示该记录
**Step 7: 测试导出功能**
1. 添加几条测试数据
2. 点击"导出"按钮
Expected: 下载Excel文件数据正确
**Step 8: 测试导入功能**
1. 点击"导入"按钮
2. 下载模板
3. 填写数据后上传
4. 等待异步导入完成
Expected: 导入成功,显示结果通知
---
### Task 16: API文档生成
**Step 1: 访问Swagger文档**
URL: http://localhost:8080/swagger-ui/index.html
Expected: 看到"信贷客户家庭关系管理"分组,所有接口正常显示
**Step 2: 导出API文档**
使用 Swagger 导出功能,保存到: `doc/api-docs/cust-fmy-relation-api.md`
---
## 完成检查清单
- [ ] 数据库表创建成功
- [ ] 后端所有类编译通过
- [ ] Controller所有接口在Swagger正常显示
- [ ] 前端页面正常加载
- [ ] 增删改查功能正常
- [ ] 导入导出功能正常
- [ ] 权限控制生效
- [ ] 字典数据正确显示
- [ ] 测试文档完整
---
## 预期结果
完成后,系统将具备以下功能:
1. **信贷客户家庭关系管理页面**
- 列表展示(分页)
- 简化查询(身份证号、关系类型、关系人姓名)
- 新增/编辑/删除/详情
2. **导入导出功能**
- 带字典下拉框的Excel模板
- 异步导入,实时状态查询
- 失败记录查看
3. **权限控制**
- 完整的CRUD权限
- 按钮级权限控制
4. **数据隔离**
- 独立表 `ccdi_cust_fmy_relation`
- `is_cust_family = 1`

View File

@@ -1,373 +0,0 @@
# 信贷客户家庭关系导入功能对齐方案
## 概述
本文档描述了如何将**信贷客户家庭关系**功能的导入实现完全对齐到**员工亲属关系**的成熟模式。
**参考模板**: `CcdiStaffEnterpriseRelationImportServiceImpl`
**修改对象**: `CcdiCustFmyRelationImportServiceImpl`
## 设计目标
1. 提升代码质量和可维护性
2. 优化性能,避免 N+1 查询问题
3. 改善用户体验,提供详细的导入进度和状态反馈
4. 统一日志记录和错误处理机制
## 架构调整
### 1. 引入导入工具类
复用 `ImportLogUtils` 进行统一的日志记录:
- 导入开始/结束日志
- 批量查询日志
- 进度跟踪日志
- 验证错误日志
- 批量操作日志
### 2. Redis 状态管理升级
**现状**: 简单 String 值存储状态
```
"COMPLETED:10:5"
```
**优化**: Hash 结构存储详细状态
```java
{
"taskId": "uuid",
"status": "SUCCESS" | "PARTIAL_SUCCESS" | "PROCESSING",
"totalCount": 100,
"successCount": 95,
"failureCount": 5,
"progress": 100,
"startTime": 1234567890,
"endTime": 1234567900,
"message": "成功95条,失败5条"
}
```
- 过期时间: 7 天
- 失败记录: 单独 Key, JSON 序列化, 7 天过期
### 3. 批量查询优化
**实现 `batchExistsByCombinations` 方法**:
- 提取所有 `person_id + relation_type + relation_cert_no` 组合
- 一次性批量查询已存在的组合
- 避免循环查询导致的 N+1 问题
### 4. 导入结果封装
创建/复用统一的 VO:
- `ImportStatusVO`: 导入状态详情
- `ImportResultVO`: 导入提交结果
- `CustFmyRelationImportFailureVO`: 失败记录详情
## 数据验证逻辑
### 唯一性检查
**优化前**: 每条记录单独查询
```java
for (excel : excels) {
CcdiCustFmyRelation existing = mapper.selectExistingRelations(...);
// N 次数据库查询
}
```
**优化后**: 批量查询
```java
Set<String> existingCombinations = getExistingCombinations(excels);
// 1 次数据库查询
for (excel : excels) {
String combination = excel.getPersonId() + "|" + ...;
if (existingCombinations.contains(combination)) {
throw new RuntimeException("该关系已存在");
}
}
```
### Excel 内部重复检查
```java
Set<String> processedCombinations = new HashSet<>();
for (excel : excels) {
String combination = ...;
if (processedCombinations.contains(combination)) {
throw new RuntimeException("该关系在导入文件中重复");
}
processedCombinations.add(combination);
}
```
### 验证规则
**必填字段**:
- 信贷客户身份证号
- 关系类型
- 关系人姓名
- 关系人证件类型
- 关系人证件号码
**格式验证**:
- 身份证号: 18位有效格式
- 证件号码: 根据证件类型验证
**长度限制**:
- 关系人姓名: ≤ 50
- 关系类型: ≤ 20
- 证件号码: ≤ 50
## 批量操作优化
### 分批插入策略
```java
private void saveBatch(List<CcdiCustFmyRelation> list, int batchSize) {
for (int i = 0; i < list.size(); i += batchSize) {
int end = Math.min(i + batchSize, list.size());
List<CcdiCustFmyRelation> subList = list.subList(i, end);
mapper.insertBatch(subList);
}
}
// 调用: 每 500 条为一批
saveBatch(newRecords, 500);
```
### 批量操作日志
```
开始批量插入: 总批次数=5, 每批大小=500
批量插入完成: 成功=2500, 耗时=1234ms
```
## 失败记录处理
### 失败记录数据结构
```java
public class CustFmyRelationImportFailureVO {
private Integer rowNum; // Excel 行号
private String personId; // 信贷客户身份证号
private String relationType; // 关系类型
private String relationName; // 关系人姓名
private String errorMessage; // 错误消息
}
```
### Redis 存储优化
**Key**: `import:custFmyRelation:{taskId}:failures`
**序列化**: JSON
**过期时间**: 7 天
**反序列化**:
```java
return JSON.parseArray(
JSON.toJSONString(failuresObj),
CustFmyRelationImportFailureVO.class
);
```
## Controller 层调整
### 导入接口
```java
@PostMapping("/importData")
public AjaxResult importData(@RequestParam("file") MultipartFile file) {
List<CcdiCustFmyRelationExcel> excels =
EasyExcelUtil.importExcel(file.getInputStream(), ...);
if (excels == null || excels.isEmpty()) {
return error("至少需要一条数据");
}
String taskId = relationService.importRelations(excels);
ImportResultVO result = new ImportResultVO();
result.setTaskId(taskId);
result.setStatus("PROCESSING");
result.setMessage("导入任务已提交,正在后台处理");
return AjaxResult.success("导入任务已提交,正在后台处理", result);
}
```
### 导入状态查询
```java
@GetMapping("/importStatus/{taskId}")
public AjaxResult getImportStatus(@PathVariable String taskId) {
ImportStatusVO statusVO = relationImportService.getImportStatus(taskId);
return success(statusVO);
}
```
### 失败记录查询
```java
@GetMapping("/importFailures/{taskId}")
public TableDataInfo getImportFailures(
@PathVariable String taskId,
@RequestParam(defaultValue = "1") Integer pageNum,
@RequestParam(defaultValue = "10") Integer pageSize
) {
List<CustFmyRelationImportFailureVO> failures =
relationImportService.getImportFailures(taskId);
// 手动分页
int fromIndex = (pageNum - 1) * pageSize;
int toIndex = Math.min(fromIndex + pageSize, failures.size());
if (fromIndex >= failures.size()) {
return getDataTable(new ArrayList<>(), failures.size());
}
List<CustFmyRelationImportFailureVO> pageData =
failures.subList(fromIndex, toIndex);
return getDataTable(pageData, failures.size());
}
```
## 导入模板改进
### 使用字典下拉框
```java
@PostMapping("/importTemplate")
public void importTemplate(HttpServletResponse response) {
EasyExcelUtil.importTemplateWithDictDropdown(
response,
CcdiCustFmyRelationExcel.class,
"信贷客户家庭关系"
);
}
```
### Excel 实体注解增强
```java
@DictDropdown(type = "ccdi_relation_type")
private String relationType;
@DictDropdown(type = "ccdi_cert_type")
private String relationCertType;
```
## 修改文件清单
### 1. Service 层
- `CcdiCustFmyRelationImportServiceImpl.java` - 核心导入逻辑重构
- `CcdiCustFmyRelationServiceImpl.java` - 导入入口方法调整
### 2. Controller 层
- `CcdiCustFmyRelationController.java` - 接口返回值优化
### 3. Mapper 层
- `CcdiCustFmyRelationMapper.java` - 添加批量查询方法
- Mapper XML - 实现批量查询 SQL
### 4. VO 类
- 检查/创建 `ImportStatusVO.java`
- 检查/创建 `ImportResultVO.java`
- 优化 `CustFmyRelationImportFailureVO.java`
### 5. Excel 实体
- `CcdiCustFmyRelationExcel.java` - 添加字典注解
### 6. 工具类
- 复用 `ImportLogUtils.java`
- 复用 `EasyExcelUtil.java`
## 关键代码片段
### Mapper 批量查询
```java
// Mapper 接口
List<String> batchExistsByCombinations(
@Param("combinations") List<String> combinations
);
// XML 实现
<select id="batchExistsByCombinations" resultType="string">
SELECT CONCAT(person_id, '|', relation_type, '|', relation_cert_no)
FROM ccdi_cust_fmy_relation
WHERE CONCAT(person_id, '|', relation_type, '|', relation_cert_no) IN
<foreach collection="combinations" item="combo" open="(" separator="," close=")">
#{combo}
</foreach>
</select>
```
### 异步导入方法
```java
@Async
@Transactional(rollbackFor = Exception.class)
public void importRelationsAsync(
List<CcdiCustFmyRelationExcel> excels,
String taskId,
String userName // 新增参数,用于审计
) {
// 实现逻辑...
}
```
## 实施步骤
1. **添加 Mapper 批量查询方法**
- 在 Mapper 接口添加 `batchExistsByCombinations`
- 在 XML 实现 SQL
2. **重构 ImportServiceImpl**
- 引入 `ImportLogUtils`
- 实现批量查询逻辑
- 添加 Excel 内部重复检查
- 优化 Redis 状态管理
- 改进失败记录存储
3. **创建/优化 VO 类**
- 检查并复用已有的 `ImportStatusVO`
- 检查并复用已有的 `ImportResultVO`
- 优化失败记录 VO
4. **调整 Controller**
- 修改导入接口返回值
- 优化状态查询接口
- 优化失败记录查询接口
5. **更新 Excel 实体**
- 添加 `@DictDropdown` 注解
6. **测试验证**
- 单元测试
- 集成测试
- 性能对比测试
## 预期效果
### 性能提升
- 批量查询: 从 N 次减少到 1 次
- 导入 1000 条数据预计提升 50-70%
### 用户体验
- 实时进度反馈
- 详细的错误信息
- 清晰的成功/失败统计
### 代码质量
- 统一的日志记录
- 完善的错误处理
- 更好的可维护性
## 创建日期
2026-02-11

View File

@@ -201,10 +201,10 @@
<version>${ruoyi.version}</version>
</dependency>
<!-- 纪检初核系统模块-->
<!-- 信息采集模块-->
<dependency>
<groupId>com.ruoyi</groupId>
<artifactId>ruoyi-ccdi</artifactId>
<artifactId>ruoyi-info-collection</artifactId>
<version>${ruoyi.version}</version>
</dependency>
@@ -218,7 +218,7 @@
<module>ruoyi-quartz</module>
<module>ruoyi-generator</module>
<module>ruoyi-common</module>
<module>ruoyi-ccdi</module>
<module>ruoyi-info-collection</module>
</modules>
<packaging>pom</packaging>

View File

@@ -54,10 +54,10 @@
<artifactId>ruoyi-generator</artifactId>
</dependency>
<!-- 纪检初核系统模块-->
<!-- 信息采集模块-->
<dependency>
<groupId>com.ruoyi</groupId>
<artifactId>ruoyi-ccdi</artifactId>
<artifactId>ruoyi-info-collection</artifactId>
</dependency>
</dependencies>

View File

@@ -0,0 +1,103 @@
# 开发环境配置
server:
# 服务器的HTTP端口默认为8080
port: 8080
servlet:
# 应用的访问路径
context-path: /
tomcat:
# tomcat的URI编码
uri-encoding: UTF-8
# 连接数满后的排队数默认为100
accept-count: 1000
threads:
# tomcat最大线程数默认为200
max: 800
# Tomcat启动初始化的线程数默认值10
min-spare: 100
# 数据源配置
spring:
datasource:
type: com.alibaba.druid.pool.DruidDataSource
driverClassName: com.mysql.cj.jdbc.Driver
druid:
# 主库数据源
master:
url: jdbc:mysql://192.168.0.111:40627/ccdi?useUnicode=true&characterEncoding=UTF-8&zeroDateTimeBehavior=convertToNull&useSSL=true&serverTimezone=GMT%2B8
username: root
password: Kfcx@1234
# 从库数据源
slave:
# 从数据源开关/默认关闭
enabled: false
url:
username:
password:
# 初始连接数
initialSize: 5
# 最小连接池数量
minIdle: 10
# 最大连接池数量
maxActive: 20
# 配置获取连接等待超时的时间
maxWait: 60000
# 配置连接超时时间
connectTimeout: 30000
# 配置网络超时时间
socketTimeout: 60000
# 配置间隔多久才进行一次检测,检测需要关闭的空闲连接,单位是毫秒
timeBetweenEvictionRunsMillis: 60000
# 配置一个连接在池中最小生存的时间,单位是毫秒
minEvictableIdleTimeMillis: 300000
# 配置一个连接在池中最大生存的时间,单位是毫秒
maxEvictableIdleTimeMillis: 900000
# 配置检测连接是否有效
validationQuery: SELECT 1 FROM DUAL
testWhileIdle: true
testOnBorrow: false
testOnReturn: false
webStatFilter:
enabled: true
statViewServlet:
enabled: true
# 设置白名单,不填则允许所有访问
allow:
url-pattern: /druid/*
# 控制台管理用户名和密码
login-username: ruoyi
login-password: 123456
filter:
stat:
enabled: true
# 慢SQL记录
log-slow-sql: true
slow-sql-millis: 1000
merge-sql: true
wall:
config:
multi-statement-allow: true
data:
# redis 配置
redis:
# 地址
host: 192.168.0.111
# 端口默认为6379
port: 44565
# 数据库索引
database: 0
# 密码
password: Kfcx@1234
# 连接超时时间
timeout: 10s
lettuce:
pool:
# 连接池中的最小空闲连接
min-idle: 0
# 连接池中的最大空闲连接
max-idle: 8
# 连接池的最大数据库连接数
max-active: 8
# #连接池最大阻塞等待时间(使用负值表示没有限制)
max-wait: -1ms

View File

@@ -83,11 +83,6 @@ springdoc:
enabled: true
path: /swagger-ui.html
tags-sorter: alpha
group-configs:
- group: 'default'
display-name: '纪检模块'
paths-to-match: '/**'
packages-to-scan: com.ruoyi.dpc.controller
# 防盗链配置
referer:

View File

@@ -9,10 +9,10 @@
</parent>
<modelVersion>4.0.0</modelVersion>
<artifactId>ruoyi-ccdi</artifactId>
<artifactId>ruoyi-info-collection</artifactId>
<description>
纪检初核系统模块
信息采集模块
</description>
<dependencies>

View File

@@ -1,6 +1,6 @@
package com.ruoyi.ccdi.annotation;
package com.ruoyi.info.collection.annotation;
import com.ruoyi.ccdi.validation.EnumValidator;
import com.ruoyi.info.collection.validation.EnumValidator;
import jakarta.validation.Constraint;
import jakarta.validation.Payload;

View File

@@ -1,14 +1,14 @@
package com.ruoyi.ccdi.controller;
package com.ruoyi.info.collection.controller;
import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import com.ruoyi.ccdi.domain.dto.CcdiBaseStaffAddDTO;
import com.ruoyi.ccdi.domain.dto.CcdiBaseStaffEditDTO;
import com.ruoyi.ccdi.domain.dto.CcdiBaseStaffQueryDTO;
import com.ruoyi.ccdi.domain.excel.CcdiBaseStaffExcel;
import com.ruoyi.ccdi.domain.vo.*;
import com.ruoyi.ccdi.service.ICcdiBaseStaffImportService;
import com.ruoyi.ccdi.service.ICcdiBaseStaffService;
import com.ruoyi.ccdi.utils.EasyExcelUtil;
import com.ruoyi.info.collection.domain.dto.CcdiBaseStaffAddDTO;
import com.ruoyi.info.collection.domain.dto.CcdiBaseStaffEditDTO;
import com.ruoyi.info.collection.domain.dto.CcdiBaseStaffQueryDTO;
import com.ruoyi.info.collection.domain.excel.CcdiBaseStaffExcel;
import com.ruoyi.info.collection.domain.vo.*;
import com.ruoyi.info.collection.service.ICcdiBaseStaffImportService;
import com.ruoyi.info.collection.service.ICcdiBaseStaffService;
import com.ruoyi.info.collection.utils.EasyExcelUtil;
import com.ruoyi.common.annotation.Log;
import com.ruoyi.common.core.controller.BaseController;
import com.ruoyi.common.core.domain.AjaxResult;

View File

@@ -1,17 +1,17 @@
package com.ruoyi.ccdi.controller;
package com.ruoyi.info.collection.controller;
import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import com.ruoyi.ccdi.domain.dto.CcdiCustEnterpriseRelationAddDTO;
import com.ruoyi.ccdi.domain.dto.CcdiCustEnterpriseRelationEditDTO;
import com.ruoyi.ccdi.domain.dto.CcdiCustEnterpriseRelationQueryDTO;
import com.ruoyi.ccdi.domain.excel.CcdiCustEnterpriseRelationExcel;
import com.ruoyi.ccdi.domain.vo.CcdiCustEnterpriseRelationVO;
import com.ruoyi.ccdi.domain.vo.CustEnterpriseRelationImportFailureVO;
import com.ruoyi.ccdi.domain.vo.ImportResultVO;
import com.ruoyi.ccdi.domain.vo.ImportStatusVO;
import com.ruoyi.ccdi.service.ICcdiCustEnterpriseRelationImportService;
import com.ruoyi.ccdi.service.ICcdiCustEnterpriseRelationService;
import com.ruoyi.ccdi.utils.EasyExcelUtil;
import com.ruoyi.info.collection.domain.dto.CcdiCustEnterpriseRelationAddDTO;
import com.ruoyi.info.collection.domain.dto.CcdiCustEnterpriseRelationEditDTO;
import com.ruoyi.info.collection.domain.dto.CcdiCustEnterpriseRelationQueryDTO;
import com.ruoyi.info.collection.domain.excel.CcdiCustEnterpriseRelationExcel;
import com.ruoyi.info.collection.domain.vo.CcdiCustEnterpriseRelationVO;
import com.ruoyi.info.collection.domain.vo.CustEnterpriseRelationImportFailureVO;
import com.ruoyi.info.collection.domain.vo.ImportResultVO;
import com.ruoyi.info.collection.domain.vo.ImportStatusVO;
import com.ruoyi.info.collection.service.ICcdiCustEnterpriseRelationImportService;
import com.ruoyi.info.collection.service.ICcdiCustEnterpriseRelationService;
import com.ruoyi.info.collection.utils.EasyExcelUtil;
import com.ruoyi.common.annotation.Log;
import com.ruoyi.common.core.controller.BaseController;
import com.ruoyi.common.core.domain.AjaxResult;

View File

@@ -1,17 +1,17 @@
package com.ruoyi.ccdi.controller;
package com.ruoyi.info.collection.controller;
import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import com.ruoyi.ccdi.domain.dto.CcdiCustFmyRelationAddDTO;
import com.ruoyi.ccdi.domain.dto.CcdiCustFmyRelationEditDTO;
import com.ruoyi.ccdi.domain.dto.CcdiCustFmyRelationQueryDTO;
import com.ruoyi.ccdi.domain.excel.CcdiCustFmyRelationExcel;
import com.ruoyi.ccdi.domain.vo.CcdiCustFmyRelationVO;
import com.ruoyi.ccdi.domain.vo.CustFmyRelationImportFailureVO;
import com.ruoyi.ccdi.domain.vo.ImportResultVO;
import com.ruoyi.ccdi.domain.vo.ImportStatusVO;
import com.ruoyi.ccdi.service.ICcdiCustFmyRelationImportService;
import com.ruoyi.ccdi.service.ICcdiCustFmyRelationService;
import com.ruoyi.ccdi.utils.EasyExcelUtil;
import com.ruoyi.info.collection.domain.dto.CcdiCustFmyRelationAddDTO;
import com.ruoyi.info.collection.domain.dto.CcdiCustFmyRelationEditDTO;
import com.ruoyi.info.collection.domain.dto.CcdiCustFmyRelationQueryDTO;
import com.ruoyi.info.collection.domain.excel.CcdiCustFmyRelationExcel;
import com.ruoyi.info.collection.domain.vo.CcdiCustFmyRelationVO;
import com.ruoyi.info.collection.domain.vo.CustFmyRelationImportFailureVO;
import com.ruoyi.info.collection.domain.vo.ImportResultVO;
import com.ruoyi.info.collection.domain.vo.ImportStatusVO;
import com.ruoyi.info.collection.service.ICcdiCustFmyRelationImportService;
import com.ruoyi.info.collection.service.ICcdiCustFmyRelationService;
import com.ruoyi.info.collection.utils.EasyExcelUtil;
import com.ruoyi.common.annotation.Log;
import com.ruoyi.common.core.controller.BaseController;
import com.ruoyi.common.core.domain.AjaxResult;

View File

@@ -1,7 +1,7 @@
package com.ruoyi.ccdi.controller;
package com.ruoyi.info.collection.controller;
import com.ruoyi.ccdi.domain.vo.EnumOptionVO;
import com.ruoyi.ccdi.enums.*;
import com.ruoyi.info.collection.domain.vo.EnumOptionVO;
import com.ruoyi.info.collection.enums.*;
import com.ruoyi.common.core.domain.AjaxResult;
import io.swagger.v3.oas.annotations.Operation;
import io.swagger.v3.oas.annotations.tags.Tag;

View File

@@ -1,14 +1,14 @@
package com.ruoyi.ccdi.controller;
package com.ruoyi.info.collection.controller;
import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import com.ruoyi.ccdi.domain.dto.*;
import com.ruoyi.ccdi.domain.excel.CcdiIntermediaryEntityExcel;
import com.ruoyi.ccdi.domain.excel.CcdiIntermediaryPersonExcel;
import com.ruoyi.ccdi.domain.vo.*;
import com.ruoyi.ccdi.service.ICcdiIntermediaryEntityImportService;
import com.ruoyi.ccdi.service.ICcdiIntermediaryPersonImportService;
import com.ruoyi.ccdi.service.ICcdiIntermediaryService;
import com.ruoyi.ccdi.utils.EasyExcelUtil;
import com.ruoyi.info.collection.domain.dto.*;
import com.ruoyi.info.collection.domain.excel.CcdiIntermediaryEntityExcel;
import com.ruoyi.info.collection.domain.excel.CcdiIntermediaryPersonExcel;
import com.ruoyi.info.collection.domain.vo.*;
import com.ruoyi.info.collection.service.ICcdiIntermediaryEntityImportService;
import com.ruoyi.info.collection.service.ICcdiIntermediaryPersonImportService;
import com.ruoyi.info.collection.service.ICcdiIntermediaryService;
import com.ruoyi.info.collection.utils.EasyExcelUtil;
import com.ruoyi.common.annotation.Log;
import com.ruoyi.common.core.controller.BaseController;
import com.ruoyi.common.core.domain.AjaxResult;

View File

@@ -1,17 +1,17 @@
package com.ruoyi.ccdi.controller;
package com.ruoyi.info.collection.controller;
import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import com.ruoyi.ccdi.domain.dto.CcdiPurchaseTransactionAddDTO;
import com.ruoyi.ccdi.domain.dto.CcdiPurchaseTransactionEditDTO;
import com.ruoyi.ccdi.domain.dto.CcdiPurchaseTransactionQueryDTO;
import com.ruoyi.ccdi.domain.excel.CcdiPurchaseTransactionExcel;
import com.ruoyi.ccdi.domain.vo.CcdiPurchaseTransactionVO;
import com.ruoyi.ccdi.domain.vo.ImportResultVO;
import com.ruoyi.ccdi.domain.vo.ImportStatusVO;
import com.ruoyi.ccdi.domain.vo.PurchaseTransactionImportFailureVO;
import com.ruoyi.ccdi.service.ICcdiPurchaseTransactionImportService;
import com.ruoyi.ccdi.service.ICcdiPurchaseTransactionService;
import com.ruoyi.ccdi.utils.EasyExcelUtil;
import com.ruoyi.info.collection.domain.dto.CcdiPurchaseTransactionAddDTO;
import com.ruoyi.info.collection.domain.dto.CcdiPurchaseTransactionEditDTO;
import com.ruoyi.info.collection.domain.dto.CcdiPurchaseTransactionQueryDTO;
import com.ruoyi.info.collection.domain.excel.CcdiPurchaseTransactionExcel;
import com.ruoyi.info.collection.domain.vo.CcdiPurchaseTransactionVO;
import com.ruoyi.info.collection.domain.vo.ImportResultVO;
import com.ruoyi.info.collection.domain.vo.ImportStatusVO;
import com.ruoyi.info.collection.domain.vo.PurchaseTransactionImportFailureVO;
import com.ruoyi.info.collection.service.ICcdiPurchaseTransactionImportService;
import com.ruoyi.info.collection.service.ICcdiPurchaseTransactionService;
import com.ruoyi.info.collection.utils.EasyExcelUtil;
import com.ruoyi.common.annotation.Log;
import com.ruoyi.common.core.controller.BaseController;
import com.ruoyi.common.core.domain.AjaxResult;

View File

@@ -1,17 +1,17 @@
package com.ruoyi.ccdi.controller;
package com.ruoyi.info.collection.controller;
import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import com.ruoyi.ccdi.domain.dto.CcdiStaffEnterpriseRelationAddDTO;
import com.ruoyi.ccdi.domain.dto.CcdiStaffEnterpriseRelationEditDTO;
import com.ruoyi.ccdi.domain.dto.CcdiStaffEnterpriseRelationQueryDTO;
import com.ruoyi.ccdi.domain.excel.CcdiStaffEnterpriseRelationExcel;
import com.ruoyi.ccdi.domain.vo.CcdiStaffEnterpriseRelationVO;
import com.ruoyi.ccdi.domain.vo.ImportResultVO;
import com.ruoyi.ccdi.domain.vo.ImportStatusVO;
import com.ruoyi.ccdi.domain.vo.StaffEnterpriseRelationImportFailureVO;
import com.ruoyi.ccdi.service.ICcdiStaffEnterpriseRelationImportService;
import com.ruoyi.ccdi.service.ICcdiStaffEnterpriseRelationService;
import com.ruoyi.ccdi.utils.EasyExcelUtil;
import com.ruoyi.info.collection.domain.dto.CcdiStaffEnterpriseRelationAddDTO;
import com.ruoyi.info.collection.domain.dto.CcdiStaffEnterpriseRelationEditDTO;
import com.ruoyi.info.collection.domain.dto.CcdiStaffEnterpriseRelationQueryDTO;
import com.ruoyi.info.collection.domain.excel.CcdiStaffEnterpriseRelationExcel;
import com.ruoyi.info.collection.domain.vo.CcdiStaffEnterpriseRelationVO;
import com.ruoyi.info.collection.domain.vo.ImportResultVO;
import com.ruoyi.info.collection.domain.vo.ImportStatusVO;
import com.ruoyi.info.collection.domain.vo.StaffEnterpriseRelationImportFailureVO;
import com.ruoyi.info.collection.service.ICcdiStaffEnterpriseRelationImportService;
import com.ruoyi.info.collection.service.ICcdiStaffEnterpriseRelationService;
import com.ruoyi.info.collection.utils.EasyExcelUtil;
import com.ruoyi.common.annotation.Log;
import com.ruoyi.common.core.controller.BaseController;
import com.ruoyi.common.core.domain.AjaxResult;

View File

@@ -1,17 +1,17 @@
package com.ruoyi.ccdi.controller;
package com.ruoyi.info.collection.controller;
import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import com.ruoyi.ccdi.domain.dto.CcdiStaffFmyRelationAddDTO;
import com.ruoyi.ccdi.domain.dto.CcdiStaffFmyRelationEditDTO;
import com.ruoyi.ccdi.domain.dto.CcdiStaffFmyRelationQueryDTO;
import com.ruoyi.ccdi.domain.excel.CcdiStaffFmyRelationExcel;
import com.ruoyi.ccdi.domain.vo.CcdiStaffFmyRelationVO;
import com.ruoyi.ccdi.domain.vo.ImportResultVO;
import com.ruoyi.ccdi.domain.vo.ImportStatusVO;
import com.ruoyi.ccdi.domain.vo.StaffFmyRelationImportFailureVO;
import com.ruoyi.ccdi.service.ICcdiStaffFmyRelationImportService;
import com.ruoyi.ccdi.service.ICcdiStaffFmyRelationService;
import com.ruoyi.ccdi.utils.EasyExcelUtil;
import com.ruoyi.info.collection.domain.dto.CcdiStaffFmyRelationAddDTO;
import com.ruoyi.info.collection.domain.dto.CcdiStaffFmyRelationEditDTO;
import com.ruoyi.info.collection.domain.dto.CcdiStaffFmyRelationQueryDTO;
import com.ruoyi.info.collection.domain.excel.CcdiStaffFmyRelationExcel;
import com.ruoyi.info.collection.domain.vo.CcdiStaffFmyRelationVO;
import com.ruoyi.info.collection.domain.vo.ImportResultVO;
import com.ruoyi.info.collection.domain.vo.ImportStatusVO;
import com.ruoyi.info.collection.domain.vo.StaffFmyRelationImportFailureVO;
import com.ruoyi.info.collection.service.ICcdiStaffFmyRelationImportService;
import com.ruoyi.info.collection.service.ICcdiStaffFmyRelationService;
import com.ruoyi.info.collection.utils.EasyExcelUtil;
import com.ruoyi.common.annotation.Log;
import com.ruoyi.common.core.controller.BaseController;
import com.ruoyi.common.core.domain.AjaxResult;

View File

@@ -1,17 +1,17 @@
package com.ruoyi.ccdi.controller;
package com.ruoyi.info.collection.controller;
import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import com.ruoyi.ccdi.domain.dto.CcdiStaffRecruitmentAddDTO;
import com.ruoyi.ccdi.domain.dto.CcdiStaffRecruitmentEditDTO;
import com.ruoyi.ccdi.domain.dto.CcdiStaffRecruitmentQueryDTO;
import com.ruoyi.ccdi.domain.excel.CcdiStaffRecruitmentExcel;
import com.ruoyi.ccdi.domain.vo.CcdiStaffRecruitmentVO;
import com.ruoyi.ccdi.domain.vo.ImportResultVO;
import com.ruoyi.ccdi.domain.vo.ImportStatusVO;
import com.ruoyi.ccdi.domain.vo.RecruitmentImportFailureVO;
import com.ruoyi.ccdi.service.ICcdiStaffRecruitmentImportService;
import com.ruoyi.ccdi.service.ICcdiStaffRecruitmentService;
import com.ruoyi.ccdi.utils.EasyExcelUtil;
import com.ruoyi.info.collection.domain.dto.CcdiStaffRecruitmentAddDTO;
import com.ruoyi.info.collection.domain.dto.CcdiStaffRecruitmentEditDTO;
import com.ruoyi.info.collection.domain.dto.CcdiStaffRecruitmentQueryDTO;
import com.ruoyi.info.collection.domain.excel.CcdiStaffRecruitmentExcel;
import com.ruoyi.info.collection.domain.vo.CcdiStaffRecruitmentVO;
import com.ruoyi.info.collection.domain.vo.ImportResultVO;
import com.ruoyi.info.collection.domain.vo.ImportStatusVO;
import com.ruoyi.info.collection.domain.vo.RecruitmentImportFailureVO;
import com.ruoyi.info.collection.service.ICcdiStaffRecruitmentImportService;
import com.ruoyi.info.collection.service.ICcdiStaffRecruitmentService;
import com.ruoyi.info.collection.utils.EasyExcelUtil;
import com.ruoyi.common.annotation.Log;
import com.ruoyi.common.core.controller.BaseController;
import com.ruoyi.common.core.domain.AjaxResult;

View File

@@ -1,17 +1,17 @@
package com.ruoyi.ccdi.controller;
package com.ruoyi.info.collection.controller;
import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import com.ruoyi.ccdi.domain.dto.CcdiStaffTransferAddDTO;
import com.ruoyi.ccdi.domain.dto.CcdiStaffTransferEditDTO;
import com.ruoyi.ccdi.domain.dto.CcdiStaffTransferQueryDTO;
import com.ruoyi.ccdi.domain.excel.CcdiStaffTransferExcel;
import com.ruoyi.ccdi.domain.vo.CcdiStaffTransferVO;
import com.ruoyi.ccdi.domain.vo.ImportResultVO;
import com.ruoyi.ccdi.domain.vo.ImportStatusVO;
import com.ruoyi.ccdi.domain.vo.StaffTransferImportFailureVO;
import com.ruoyi.ccdi.service.ICcdiStaffTransferImportService;
import com.ruoyi.ccdi.service.ICcdiStaffTransferService;
import com.ruoyi.ccdi.utils.EasyExcelUtil;
import com.ruoyi.info.collection.domain.dto.CcdiStaffTransferAddDTO;
import com.ruoyi.info.collection.domain.dto.CcdiStaffTransferEditDTO;
import com.ruoyi.info.collection.domain.dto.CcdiStaffTransferQueryDTO;
import com.ruoyi.info.collection.domain.excel.CcdiStaffTransferExcel;
import com.ruoyi.info.collection.domain.vo.CcdiStaffTransferVO;
import com.ruoyi.info.collection.domain.vo.ImportResultVO;
import com.ruoyi.info.collection.domain.vo.ImportStatusVO;
import com.ruoyi.info.collection.domain.vo.StaffTransferImportFailureVO;
import com.ruoyi.info.collection.service.ICcdiStaffTransferImportService;
import com.ruoyi.info.collection.service.ICcdiStaffTransferService;
import com.ruoyi.info.collection.utils.EasyExcelUtil;
import com.ruoyi.common.annotation.Log;
import com.ruoyi.common.core.controller.BaseController;
import com.ruoyi.common.core.domain.AjaxResult;

View File

@@ -1,4 +1,4 @@
package com.ruoyi.ccdi.domain;
package com.ruoyi.info.collection.domain;
import com.baomidou.mybatisplus.annotation.*;
import lombok.Data;

View File

@@ -1,4 +1,4 @@
package com.ruoyi.ccdi.domain;
package com.ruoyi.info.collection.domain;
import com.baomidou.mybatisplus.annotation.*;
import lombok.Data;

View File

@@ -1,4 +1,4 @@
package com.ruoyi.ccdi.domain;
package com.ruoyi.info.collection.domain;
import com.baomidou.mybatisplus.annotation.*;
import io.swagger.v3.oas.annotations.media.Schema;

View File

@@ -1,4 +1,4 @@
package com.ruoyi.ccdi.domain;
package com.ruoyi.info.collection.domain;
import com.baomidou.mybatisplus.annotation.FieldFill;
import com.baomidou.mybatisplus.annotation.IdType;

View File

@@ -1,4 +1,4 @@
package com.ruoyi.ccdi.domain;
package com.ruoyi.info.collection.domain;
import com.baomidou.mybatisplus.annotation.*;
import lombok.Data;

View File

@@ -1,4 +1,4 @@
package com.ruoyi.ccdi.domain;
package com.ruoyi.info.collection.domain;
import com.baomidou.mybatisplus.annotation.FieldFill;
import com.baomidou.mybatisplus.annotation.IdType;

View File

@@ -1,4 +1,4 @@
package com.ruoyi.ccdi.domain;
package com.ruoyi.info.collection.domain;
import com.baomidou.mybatisplus.annotation.*;
import io.swagger.v3.oas.annotations.media.Schema;

View File

@@ -1,4 +1,4 @@
package com.ruoyi.ccdi.domain;
package com.ruoyi.info.collection.domain;
import com.baomidou.mybatisplus.annotation.FieldFill;
import com.baomidou.mybatisplus.annotation.IdType;

View File

@@ -1,4 +1,4 @@
package com.ruoyi.ccdi.domain;
package com.ruoyi.info.collection.domain;
import com.baomidou.mybatisplus.annotation.FieldFill;
import com.baomidou.mybatisplus.annotation.IdType;

View File

@@ -1,4 +1,4 @@
package com.ruoyi.ccdi.domain;
package com.ruoyi.info.collection.domain;
import com.baomidou.mybatisplus.annotation.*;
import lombok.Data;

View File

@@ -1,4 +1,4 @@
package com.ruoyi.ccdi.domain.dto;
package com.ruoyi.info.collection.domain.dto;
import jakarta.validation.constraints.NotBlank;
import jakarta.validation.constraints.NotNull;

View File

@@ -1,4 +1,4 @@
package com.ruoyi.ccdi.domain.dto;
package com.ruoyi.info.collection.domain.dto;
import jakarta.validation.constraints.NotBlank;
import jakarta.validation.constraints.NotNull;

View File

@@ -1,4 +1,4 @@
package com.ruoyi.ccdi.domain.dto;
package com.ruoyi.info.collection.domain.dto;
import lombok.Data;

View File

@@ -1,4 +1,4 @@
package com.ruoyi.ccdi.domain.dto;
package com.ruoyi.info.collection.domain.dto;
import io.swagger.v3.oas.annotations.media.Schema;
import jakarta.validation.constraints.NotBlank;

View File

@@ -1,4 +1,4 @@
package com.ruoyi.ccdi.domain.dto;
package com.ruoyi.info.collection.domain.dto;
import io.swagger.v3.oas.annotations.media.Schema;
import jakarta.validation.constraints.NotBlank;

View File

@@ -1,4 +1,4 @@
package com.ruoyi.ccdi.domain.dto;
package com.ruoyi.info.collection.domain.dto;
import io.swagger.v3.oas.annotations.media.Schema;
import lombok.Data;

View File

@@ -1,4 +1,4 @@
package com.ruoyi.ccdi.domain.dto;
package com.ruoyi.info.collection.domain.dto;
import com.fasterxml.jackson.annotation.JsonFormat;
import io.swagger.v3.oas.annotations.media.Schema;

View File

@@ -1,4 +1,4 @@
package com.ruoyi.ccdi.domain.dto;
package com.ruoyi.info.collection.domain.dto;
import com.fasterxml.jackson.annotation.JsonFormat;
import io.swagger.v3.oas.annotations.media.Schema;

View File

@@ -1,4 +1,4 @@
package com.ruoyi.ccdi.domain.dto;
package com.ruoyi.info.collection.domain.dto;
import com.fasterxml.jackson.annotation.JsonFormat;
import io.swagger.v3.oas.annotations.media.Schema;

View File

@@ -1,4 +1,4 @@
package com.ruoyi.ccdi.domain.dto;
package com.ruoyi.info.collection.domain.dto;
import io.swagger.v3.oas.annotations.media.Schema;
import jakarta.validation.constraints.NotBlank;

View File

@@ -1,4 +1,4 @@
package com.ruoyi.ccdi.domain.dto;
package com.ruoyi.info.collection.domain.dto;
import io.swagger.v3.oas.annotations.media.Schema;
import jakarta.validation.constraints.NotBlank;

View File

@@ -1,4 +1,4 @@
package com.ruoyi.ccdi.domain.dto;
package com.ruoyi.info.collection.domain.dto;
import io.swagger.v3.oas.annotations.media.Schema;
import jakarta.validation.constraints.NotBlank;

View File

@@ -1,4 +1,4 @@
package com.ruoyi.ccdi.domain.dto;
package com.ruoyi.info.collection.domain.dto;
import io.swagger.v3.oas.annotations.media.Schema;
import jakarta.validation.constraints.NotBlank;

View File

@@ -1,4 +1,4 @@
package com.ruoyi.ccdi.domain.dto;
package com.ruoyi.info.collection.domain.dto;
import io.swagger.v3.oas.annotations.media.Schema;
import lombok.Data;

View File

@@ -1,4 +1,4 @@
package com.ruoyi.ccdi.domain.dto;
package com.ruoyi.info.collection.domain.dto;
import com.fasterxml.jackson.annotation.JsonFormat;
import io.swagger.v3.oas.annotations.media.Schema;

View File

@@ -1,4 +1,4 @@
package com.ruoyi.ccdi.domain.dto;
package com.ruoyi.info.collection.domain.dto;
import com.fasterxml.jackson.annotation.JsonFormat;
import io.swagger.v3.oas.annotations.media.Schema;

View File

@@ -1,4 +1,4 @@
package com.ruoyi.ccdi.domain.dto;
package com.ruoyi.info.collection.domain.dto;
import com.fasterxml.jackson.annotation.JsonFormat;
import io.swagger.v3.oas.annotations.media.Schema;

View File

@@ -1,4 +1,4 @@
package com.ruoyi.ccdi.domain.dto;
package com.ruoyi.info.collection.domain.dto;
import io.swagger.v3.oas.annotations.media.Schema;
import jakarta.validation.constraints.NotBlank;

View File

@@ -1,4 +1,4 @@
package com.ruoyi.ccdi.domain.dto;
package com.ruoyi.info.collection.domain.dto;
import io.swagger.v3.oas.annotations.media.Schema;
import jakarta.validation.constraints.NotBlank;

View File

@@ -1,4 +1,4 @@
package com.ruoyi.ccdi.domain.dto;
package com.ruoyi.info.collection.domain.dto;
import io.swagger.v3.oas.annotations.media.Schema;
import lombok.Data;

View File

@@ -1,4 +1,4 @@
package com.ruoyi.ccdi.domain.dto;
package com.ruoyi.info.collection.domain.dto;
import com.fasterxml.jackson.annotation.JsonFormat;
import io.swagger.v3.oas.annotations.media.Schema;

View File

@@ -1,4 +1,4 @@
package com.ruoyi.ccdi.domain.dto;
package com.ruoyi.info.collection.domain.dto;
import com.fasterxml.jackson.annotation.JsonFormat;
import io.swagger.v3.oas.annotations.media.Schema;

View File

@@ -1,4 +1,4 @@
package com.ruoyi.ccdi.domain.dto;
package com.ruoyi.info.collection.domain.dto;
import com.fasterxml.jackson.annotation.JsonFormat;
import io.swagger.v3.oas.annotations.media.Schema;

View File

@@ -1,7 +1,7 @@
package com.ruoyi.ccdi.domain.dto;
package com.ruoyi.info.collection.domain.dto;
import com.ruoyi.ccdi.annotation.EnumValid;
import com.ruoyi.ccdi.enums.AdmitStatus;
import com.ruoyi.info.collection.annotation.EnumValid;
import com.ruoyi.info.collection.enums.AdmitStatus;
import jakarta.validation.constraints.NotBlank;
import jakarta.validation.constraints.Pattern;
import jakarta.validation.constraints.Size;

View File

@@ -1,7 +1,7 @@
package com.ruoyi.ccdi.domain.dto;
package com.ruoyi.info.collection.domain.dto;
import com.ruoyi.ccdi.annotation.EnumValid;
import com.ruoyi.ccdi.enums.AdmitStatus;
import com.ruoyi.info.collection.annotation.EnumValid;
import com.ruoyi.info.collection.enums.AdmitStatus;
import jakarta.validation.constraints.NotBlank;
import jakarta.validation.constraints.NotNull;
import jakarta.validation.constraints.Pattern;

View File

@@ -1,4 +1,4 @@
package com.ruoyi.ccdi.domain.dto;
package com.ruoyi.info.collection.domain.dto;
import lombok.Data;

View File

@@ -1,4 +1,4 @@
package com.ruoyi.ccdi.domain.dto;
package com.ruoyi.info.collection.domain.dto;
import com.fasterxml.jackson.annotation.JsonFormat;
import io.swagger.v3.oas.annotations.media.Schema;

View File

@@ -1,4 +1,4 @@
package com.ruoyi.ccdi.domain.dto;
package com.ruoyi.info.collection.domain.dto;
import com.fasterxml.jackson.annotation.JsonFormat;
import io.swagger.v3.oas.annotations.media.Schema;

Some files were not shown because too many files have changed in this diff Show More