# Change: 添加员工信息维护功能 ## Why 当前系统缺少员工信息管理能力,员工基础信息(姓名、柜员号、所属机构、身份证、电话、入职时间)以及员工亲属关系信息需要通过系统进行维护。这导致: 1. 员工信息分散管理,缺乏统一的数据源 2. 亲属关系信息无法与员工信息关联管理 3. 数据录入效率低,无法批量导入导出 为解决上述问题,需要添加员工信息维护功能,支持员工及其亲属信息的增删改查、批量导入导出。 ## What Changes ### 新增功能 - 员工信息管理:支持员工的新增、编辑、删除、查询 - 员工信息导入导出:支持 Excel 批量导入导出员工数据 - 员工亲属管理:支持在员工信息中维护亲属关系 ### 数据模型 **员工主表 (ccdi_employee)** - 员工ID (主键) - 姓名 - 柜员号 (唯一约束) - 所属机构号 - 身份证号 (唯一约束) - 电话 - 入职时间 - 状态 (0=在职, 1=离职) - 审计字段(创建者、创建时间、更新者、更新时间) **员工亲属表 (ccdi_employee_relative)** - 亲属ID (主键) - 员工ID (外键) - 亲属姓名 - 亲属身份证号 - 亲属手机号 - 与员工关系 - 审计字段 ### API 接口 - `POST /dpc/employee` - 新增员工 - `PUT /dpc/employee` - 编辑员工 - `DELETE /dpc/employee/{ids}` - 删除员工 - `GET /dpc/employee/list` - 查询员工列表 - `GET /dpc/employee/{id}` - 获取员工详情 - `POST /dpc/employee/export` - 导出员工信息 - `POST /dpc/employee/importTemplate` - 下载导入模板 - `POST /dpc/employee/importData` - 导入员工信息 ## Impact ### 影响的规范 (Affected Specs) - 新增规范: `employee-info` (员工信息管理) ### 影响的代码 (Affected Code) - **新增模块**: `ruoyi-dpc` (DPC业务模块) - `com.ruoyi.dpc.domain.CcdiEmployee` - 员工实体(使用 @Data 注解) - `com.ruoyi.dpc.domain.CcdiEmployeeRelative` - 亲属实体(使用 @Data 注解) - `com.ruoyi.dpc.domain.dto.*` - DTO类(统一使用 @Data 注解) - `com.ruoyi.dpc.domain.vo.*` - VO类(统一使用 @Data 注解) - `com.ruoyi.dpc.controller.CcdiEmployeeController` - 控制器 - `com.ruoyi.dpc.service.*` - 服务层 - `com.ruoyi.dpc.mapper.*` - 数据访问层(继承 MyBatis Plus BaseMapper) - **技术实现**: - 简单 CRUD 操作使用 MyBatis Plus BaseMapper 方法 - 复杂查询(如多表关联)使用 XML 映射文件 - **数据库**: 新增表 - `ccdi_employee` - 员工信息表 - `ccdi_employee_relative` - 员工亲属表 - `sys_dict_type` - 字典类型表(员工状态、亲属关系) - **菜单系统**: (将在前端开发阶段处理) - 本次不涉及菜单数据的创建 - 前端开发时需在 `sys_menu` 表中插入菜单及权限数据 - **前端**: (本次提案仅涉及后端接口) - 前端页面开发时需要同步配置菜单数据 ### 非破坏性变更 (Non-Breaking) 此变更为纯新增功能,不影响现有系统行为。