2026-06-03
本次开发实现了"见习岗位管理"和"见习人员管理"两个模块的完整后端+前端代码,参考 FocusPersonnel 模块的代码模式。
| 文件 | 路径 | 说明 |
|---|---|---|
| InternshipPost.java | org.jeecg.modules.zjrs.internshippost.entity | 实体类,@TableName("internship_post"),包含22个字段 |
| InternshipPostMapper.java | org.jeecg.modules.zjrs.internshippost.mapper | Mapper接口,继承BaseMapper |
| InternshipPostMapper.xml | org.jeecg.modules.zjrs.internshippost.mapper.xml | Mapper XML,基础配置(此表不需要JOIN) |
| IInternshipPostService.java | org.jeecg.modules.zjrs.internshippost.service | Service接口,继承IService |
| InternshipPostServiceImpl.java | org.jeecg.modules.zjrs.internshippost.service.impl | Service实现类 |
| InternshipPostController.java | org.jeecg.modules.zjrs.internshippost.controller | Controller,使用QueryGenerator自动构建查询条件 |
关键设计:
| 文件 | 路径 | 说明 |
|---|---|---|
| InternshipPost.api.ts | views/internshippost/ | API定义,基础路径 /internshipPost |
| InternshipPost.data.ts | views/internshippost/ | 列定义和高级查询配置 |
| InternshipPostList.vue | views/internshippost/ | 列表页面 |
| InternshipPostForm.vue | views/internshippost/components/ | 表单组件,分两个卡片区域 |
| InternshipPostModal.vue | views/internshippost/components/ | 弹窗组件 |
关键设计:
| 文件 | 路径 |
|---|---|
| V20260603_5__menu_insert_InternshipPost.sql | flyway/sql/mysql/ |
菜单结构:
| 文件 | 路径 | 说明 |
|---|---|---|
| InternshipPersonnel.java | org.jeecg.modules.zjrs.internshippersonnel.entity | 实体类,@TableName("internship_personnel"),只包含表自身字段 |
| InternshipPersonnelPageVo.java | org.jeecg.modules.zjrs.internshippersonnel.entity | 列表VO,映射视图v_internship_personnel_list字段 |
| InternshipPersonnelMapper.java | org.jeecg.modules.zjrs.internshippersonnel.mapper | Mapper接口,添加queryPageList方法 |
| InternshipPersonnelMapper.xml | org.jeecg.modules.zjrs.internshippersonnel.mapper.xml | queryPageList从视图查询,支持5个查询参数 |
| IInternshipPersonnelService.java | org.jeecg.modules.zjrs.internshippersonnel.service | Service接口,添加queryPageList方法 |
| InternshipPersonnelServiceImpl.java | org.jeecg.modules.zjrs.internshippersonnel.service.impl | Service实现类 |
| InternshipPersonnelController.java | org.jeecg.modules.zjrs.internshippersonnel.controller | Controller,/list使用queryPageList模式 |
关键设计:
| 文件 | 路径 | 说明 |
|---|---|---|
| InternshipPersonnel.api.ts | views/internshippersonnel/ | API定义,基础路径 /internshipPersonnel |
| InternshipPersonnel.data.ts | views/internshippersonnel/ | 列定义和高级查询配置 |
| InternshipPersonnelList.vue | views/internshippersonnel/ | 列表页面 |
| InternshipPersonnelForm.vue | views/internshippersonnel/components/ | 表单组件 |
| InternshipPersonnelModal.vue | views/internshippersonnel/components/ | 弹窗组件 |
关键设计:
| 文件 | 路径 |
|---|---|
| V20260603_6__menu_insert_InternshipPersonnel.sql | flyway/sql/mysql/ |
菜单结构:
| 文件 | 路径 | 说明 |
|---|---|---|
| InternshipPersonnel.api.ts | views/internshippersonnel/ | 新增queryDetailById、listCustomTags、listCustomTagsPage、addCustomTagItem、deleteCustomTagItem、updateCustomTagItem、batchUpdateCustomTag、listServiceFollow、addServiceFollow、editServiceFollow、deleteServiceFollow等API函数 |
| 文件 | 路径 | 说明 |
|---|---|---|
| InternshipPersonnelDetail.vue | views/internshippersonnel/components/ | 见习人员详情组件,参照FocusPersonnelDetail改造 |
| InternshipPersonnelServiceFollowList.vue | views/internshippersonnel/components/ | 见习人员服务跟进列表组件,参照FocusPersonnelServiceFollowList改造 |
/internshipPersonnel/queryDetailById 而非 /focusPersonnel/queryDetailByIdinternship_custom_tag 而非 focus_custom_taginternship-personnel-detail 而非 focus-personnel-detail/internshipPersonnelServiceFollow/* 而非 /focusPersonnelServiceFollow/*internshipPersonnelId 而非 focusPersonnelId../InternshipPersonnel.api 导入internship_personnel:serviceFollow参照重点关注人员模块(FocusPersonnel),对见习人员管理后端进行完整改造:
| 文件 | 路径 | 说明 |
|---|---|---|
| InternshipPersonnelDetailVo.java | internshippersonnel/entity | 详情VO,含个人信息全部字段+见习岗位信息 |
| InternshipPersonnelServiceFollow.java | internshippersonnel/entity | 服务跟进记录实体类,@TableName("internship_personnel_service_follow") |
| InternshipPersonnelServiceFollowMapper.java | internshippersonnel/mapper | 服务跟进Mapper接口 |
| IInternshipPersonnelServiceFollowService.java | internshippersonnel/service | 服务跟进Service接口 |
| InternshipPersonnelServiceFollowServiceImpl.java | internshippersonnel/service/impl | 服务跟进Service实现类 |
| InternshipPersonnelServiceFollowController.java | internshippersonnel/controller | 服务跟进Controller,权限:internship_personnel:serviceFollow |
| 文件 | 修改内容 |
|---|---|
| InternshipPersonnel.java | 新增 customTag 字段(自定义标签,@Dict(dicCode="internship_custom_tag")) |
| InternshipPersonnelPageVo.java | 新增 customTag 字段 |
| InternshipPersonnelMapper.java | 新增 queryDetailById 方法 |
| InternshipPersonnelMapper.xml | 新增 queryDetailById SQL(关联personal_info+internship_post三表查询) |
| IInternshipPersonnelService.java | 新增 queryDetailById、listCustomTags、queryCustomTagPage、addCustomTagItem、deleteCustomTagItem、updateCustomTagItem、batchUpdateCustomTag 方法 |
| InternshipPersonnelServiceImpl.java | 实现上述所有新增方法,自定义标签字典编码:internship_custom_tag |
| InternshipPersonnelController.java | 新增 queryDetailById、listCustomTags、listCustomTagsPage、addCustomTagItem、deleteCustomTagItem、batchUpdateCustomTag、updateCustomTagItem 接口 |
| 文件 | 修改内容 |
|---|---|
| InternshipPersonnel.api.ts | 新增11个API函数(详情查询+自定义标签管理+服务跟进CRUD) |
| InternshipPersonnel.data.ts | 新增序号列和自定义标签列 |
| InternshipPersonnelList.vue | 新增查看/服务跟进按钮、批量标签弹窗、字典翻译、服务跟进弹窗 |
| InternshipPersonnelModal.vue | 区分详情/编辑模式,详情模式显示InternshipPersonnelDetail |
| 文件 | 路径 | 说明 |
|---|---|---|
| 见习人员字典.sql | .docs/sql/ | 初始化 internship_minor_tag(见习人员小类标签)和 internship_custom_tag(自定义标签)字典 |
| 见习人员服务跟进表.sql | .docs/sql/ | 创建 INTERNSHIP_PERSONNEL_SERVICE_FOLLOW 表 |
| 见习人员表新增自定义标签字段.sql | .docs/sql/ | ALTER TABLE internship_personnel ADD custom_tag |
| 见习人员视图.sql | .docs/sql/ | 更新视图,新增 custom_tag 字段 |
| V20260604_2__menu_insert_InternshipPersonnelServiceFollow.sql | flyway/sql/mysql/ | 服务跟进按钮权限+角色授权 |
| V20260604_3__init_internship_personnel_dict.sql | flyway/sql/mysql/ | 见习人员字典数据初始化 |
.docs/sql/见习人员服务跟进表.sql.docs/sql/见习人员表新增自定义标签字段.sql.docs/sql/见习人员视图.sql(DROP后CREATE)V20260604_2(菜单权限)和 V20260604_3(字典数据)完全参照重点关注人员模块(FocusPersonnel)实现见习人员管理,两个模块功能一致,只有业务字段差异。
| 文件 | 修改内容 |
|---|---|
| InternshipPersonnel.java | 新增 majorTag(@Dict dicCode="internship_major_tag")、minorTag(@Dict dicCode="internship_minor_tag")、customTag 字段 |
| InternshipPersonnelPageVo.java | 新增 majorTag、minorTag、age、householdLocation、currentResidence、jobSeekerCategory、jobSearchStatus、customTag 字段 |
| InternshipPersonnelDetailVo.java | 新增 majorTag、minorTag 字段 + 个人信息全部字段 + 见习岗位信息 |
| InternshipPersonnelMapper.java | 新增 queryDetailById、countPersonnelByCustomTag、updatePersonnelCustomTagName 方法 |
| InternshipPersonnelMapper.xml | queryPageList 新增10个查询条件;新增 queryDetailById(三表JOIN)、countPersonnelByCustomTag、updatePersonnelCustomTagName SQL |
| InternshipPersonnelServiceImpl.java | deleteCustomTagItem 添加标签绑定检查;updateCustomTagItem 添加标签名同步逻辑;字典编码常量 CUSTOM_TAG_DICT_CODE |
| InternshipPersonnelController.java | list接口新增10个查询参数;新增 queryDetailById、自定义标签管理接口 |
| 文件 | 修改内容 |
|---|---|
| InternshipPersonnelList.vue | 完全重写,参照FocusPersonnelList:去掉新增/编辑/删除按钮,操作栏改为3个直接按钮(查看、岗位推送、服务跟进),添加导出按钮,使用useDict加载3个字典,bodyCell插槽字典翻译,批量标签弹窗,服务跟进弹窗 |
| InternshipPersonnel.api.ts | 新增11个API函数 |
| InternshipPersonnel.data.ts | 新增列:序号、年龄、户口所在地、现居住地、求职人员类别、求职状态、人员大类标签、人员小类标签、自定义标签 |
| InternshipPersonnelModal.vue | 区分详情/编辑模式,详情显示InternshipPersonnelDetail,编辑显示InternshipPersonnelForm |
| InternshipPersonnelForm.vue | 新增 majorTag/minorTag(JDictSelectTag)、customTag 字段 |
| 文件 | 说明 |
|---|---|
| InternshipPersonnelDetail.vue | 见习人员详情组件 |
| InternshipPersonnelServiceFollowList.vue | 服务跟进列表组件 |
| InternshipPersonnelServiceFollow.java | 服务跟进实体类 |
| InternshipPersonnelServiceFollowController.java | 服务跟进Controller |
| 文件 | 说明 |
|---|---|
| V20260604_2__menu_insert_InternshipPersonnelServiceFollow.sql | 服务跟进按钮权限+角色授权 |
| V20260604_3__init_internship_personnel_dict.sql | 初始化3个字典到sys_dict/sys_dict_item |
| V20260604_7__migrate_internship_tags_to_dictionary_item.sql | 字典数据迁移到DICTIONARY_ITEM表(useDict从该表加载) |
[22018] Fail to cast string (-6111)TIMESTAMPDIFF(YEAR, birth_date, CURDATE()) 是MySQL函数,达梦不支持FLOOR(MONTHS_BETWEEN(CURRENT_DATE, birth_date) / 12)COMMENT 关键字,达梦不支持CREATE TABLE + COMMENT ON COLUMN 单独语句CURDATE() 是MySQL函数CURRENT_DATE由于Flyway可能已记录失败状态,以下SQL需要手动在数据库中执行:
.docs/sql/见习人员管理_全部重建.sql(DROP并重建所有表+视图+测试数据)完全参照重点关注人员模块,修复见习人员管理的6个问题:
| 序号 | 问题描述 | 修复方案 | 涉及文件 |
|---|---|---|---|
| 1 | 见习人员的标签应该和重点关注人员一样数据库用数字保存 | V20260604_7脚本改为直接INSERT数字Value的字典项;全部重建脚本测试数据改为数字 | V20260604_7__migrate_internship_tags_to_dictionary_item.sql、见习人员管理_全部重建.sql |
| 2 | 添加8条自定义标签数据到数据库给见习人员使用 | V20260604_7脚本中添加8条internship_custom_tag字典项(零就业家庭/低保家庭/残疾人员/长期失业/特困人员/刑满释放/社会救助/优抚对象) | V20260604_7__migrate_internship_tags_to_dictionary_item.sql |
| 3 | 见习人员管理缺少导出功能 | 前端导出按钮和exportConfig已存在,后端exportXls接口已存在,权限已配置(internship_personnel:exportXls),确认代码层面完整 | InternshipPersonnelList.vue、InternshipPersonnelController.java |
| 4 | 见习人员管理服务跟进缺失新增服务跟进数据按钮 | 修复权限判断:getPermList → getPermCodeList(参照重点关注人员) | InternshipPersonnelServiceFollowList.vue |
| 5 | 搜索条件无效果 | 1. beforeFetch改为同步函数并显式return params;2. 性别搜索值从"男性"/"女性"改为"1"/"2"(与数据库存储一致);3. 简化后端性别SQL条件 | InternshipPersonnelList.vue、InternshipPersonnelMapper.xml |
| 6 | 列表性别显示有问题,有的显示数字 | 添加genderMap映射 + bodyCell插槽翻译性别字段 | InternshipPersonnelList.vue |
InternshipPersonnelList.vue
beforeFetch 从 async 改为同步函数,显式 return params(避免useListPage包装逻辑中返回值被忽略的问题)<a-select-option value="1">男性</a-select-option> / <a-select-option value="2">女性</a-select-option>(与数据库数字存储格式一致)genderMap 映射和 bodyCell 插槽性别翻译(兼容数字和文本两种格式)FocusPersonnelList.vue(同步修复)
genderMap 映射和 bodyCell 插槽性别翻译beforeFetch 从 async 改为同步函数InternshipPersonnelServiceFollowList.vue
permissionStore.getPermList 改为 permissionStore.getPermCodeList(参照重点关注人员)InternshipPersonnelMapper.xml
CASE WHEN 兼容逻辑简化为 AND gender = #{params.gender}(前端已传数字值)InternshipPersonnelServiceImpl.java
deleteCustomTagItem 方法:改用 item.getValue() 数字值去 countPersonnelByCustomTag 检查绑定(因为custom_tag列存储数字值)updateCustomTagItem 方法:移除 updatePersonnelCustomTagName 调用(标签重命名只改Name,数字Value不变,无需同步更新custom_tag列)FocusPersonnelServiceImpl.java(同步修复)
deleteCustomTagItem 方法:同上,改用数字值检查绑定updateCustomTagItem 方法:同上,移除 updatePersonnelCustomTagName 调用V20260604_7__cleanup_old_sys_dict_tags.sql 重命名为 V20260604_10__cleanup_old_sys_dict_tags.sql(避免与迁移脚本版本号冲突)见习人员与重点关注人员的标签存储格式统一为数字值:
major_tag 列存储数字(如 '1'),前端通过 useDict('internship_major_tag') 翻译显示minor_tag 列存储数字(如 '1', '2'),前端通过 useDict('internship_minor_tag') 翻译显示custom_tag 列存储逗号分隔的数字(如 '1,3,5'),前端通过 useDict('internship_custom_tag') 翻译显示DICTIONARY_ITEM 表中,Value 字段为 Integer 类型(1, 2, 3...),Name 字段为显示文本| 序号 | 问题描述 | 修复方案 | 涉及文件 |
|---|---|---|---|
| 1 | 导出按钮和服务跟进新增按钮不显示 | 权限ID冲突:V20260604_2脚本中服务跟进权限ID 1780601000000327 与V20260603_6脚本中角色授权ID冲突,导致服务跟进权限未插入成功。修改权限ID为 1780601000000340,并补充导出权限角色授权 |
V20260604_2__menu_insert_InternshipPersonnelServiceFollow.sql |
| 2 | 列表求职状态显示数字 | 数据库 job_search_status 字段存储数字(1-6),需通过 useDict('JobSeekerStatus') 翻译显示。搜索下拉也改为字典选项 |
InternshipPersonnelList.vue、FocusPersonnelList.vue |
| 3 | 自定义标签已设置但页面不显示 | 原因同问题2,标签值是数字,需通过 getDictText 翻译。已确认翻译逻辑正确,需确保字典数据已插入数据库 |
确认DICTIONARY_ITEM表数据 |
| 4 | 自定义标签样式与人员大类/小类不一致 | 统一使用 <a-tag> 组件:大类蓝色(blue)、小类绿色(green)、自定义橙色(orange) |
InternshipPersonnelList.vue、FocusPersonnelList.vue |
V20260604_2__menu_insert_InternshipPersonnelServiceFollow.sql
1780601000000327 改为 1780601000000340(避免与V20260603_6中角色授权ID冲突)1780601000000334 改为 1780601000000341internship_personnel:exportXls 的角色授权(使用NOT EXISTS防重复)SELECT ... FROM DUAL WHERE NOT EXISTS 格式(幂等执行)InternshipPersonnelList.vue
useDict 增加 'JobSeekerStatus' 字典编码jobSearchStatusOptions 计算属性(从字典加载求职状态选项)jobSearchStatus 翻译(getDictText('JobSeekerStatus', text))majorTag 用 <a-tag color="blue">,minorTag 用 <a-tag color="green">,customTag 用 <a-tag color="orange">-FocusPersonnelList.vue(同步修复)
.docs/sql/修复见习人员权限数据.sql(修复导出按钮和服务跟进新增按钮不显示的问题)DICTIONARY_ITEM 表中 JobSeekerStatus 字典数据已存在(参考 .docs/sql/数据字典数据插入.sql)internship_major_tag、internship_minor_tag、internship_custom_tag 字典数据已存在(参考 V20260604_7 脚本)| 序号 | 问题描述 | 修复方案 | 涉及文件 |
|---|---|---|---|
| 1 | 标签样式不应该用tag组件,应该和列表普通文本一样 | 列表bodyCell中标签改为纯文本显示(与重点关注人员一致),详情页保留tag样式 | InternshipPersonnelList.vue、FocusPersonnelList.vue |
| 2 | 导出和新增按钮不显示 | 根本原因是数据库权限数据冲突,创建独立修复SQL脚本 | .docs/sql/修复见习人员权限数据.sql |
| 3 | 详情页自定义标签不显示 | 详情页header区域自定义标签缺少字典翻译(直接显示数字) | InternshipPersonnelDetail.vue、FocusPersonnelDetail.vue |
经过深入对比重点关注人员的实现,找到了导出按钮和服务跟进新增按钮不显示的根本原因:
后端 SysPermissionController 构建 codeList 时,过滤条件为 status = "1":
List<String> codeList = metaList.stream()
.filter((permission) -> CommonConstant.MENU_TYPE_2.equals(permission.getMenuType())
&& CommonConstant.STATUS_1.equals(permission.getStatus()))
.collect(...);
但 V20260603_6 插入的见习人员权限 status = NULL,V20260604_9 只修复了重点关注人员的status,遗漏了见习人员。
status = NULL → "1".equals(null) → false → 权限码被排除 → 前端 v-auth 指令从DOM移除按钮| 文件 | 修改内容 |
|---|---|
| V20260605_1__fix_internship_personnel_permission_status.sql | 新建flyway脚本,修复见习人员所有按钮权限的status=NULL问题 |
| .docs/sql/修复见习人员权限数据.sql | 重写为综合修复SQL,包含4个部分:权限status修复、ID冲突修复、字典数据保障、旧数据清理 |
| 部分 | 修复内容 | 解决的问题 |
|---|---|---|
| 第一部分 | UPDATE sys_permission SET status=1 WHERE perms LIKE 'internship_personnel:%' | 导出按钮和服务跟进新增按钮不显示(根本原因) |
| 第二部分 | 清理ID冲突 + 插入服务跟进权限(status=1) + 角色授权 | 服务跟进权限ID冲突导致数据不完整 |
| 第三部分 | 确保DICTIONARY/DICTIONARY_ITEM字典数据存在 | 自定义标签不显示(V20260604_7可能未成功执行) |
| 第四部分 | 清理sys_dict/sys_dict_item中的旧数据 | 避免旧字典数据干扰 |
| 第五部分 | 验证修复结果 | 确认所有修复生效 |
.docs/sql/修复见习人员权限数据.sql根本原因:jobSeekerCategory 字段在数据库中存储数字1-10,对应 JobSeekerCategory 字典(DICTIONARY_ITEM表),但前端列表和详情页都没有做字典翻译。重点关注人员也有同样的问题。个人信息模块(PersonalInfoList.vue)已正确实现。
修复方案:在useDict中加载JobSeekerCategory字典,bodyCell和详情页中添加翻译。
| 文件 | 修改内容 |
|---|---|
| InternshipPersonnelList.vue | useDict增加JobSeekerCategory,bodyCell增加jobSeekerCategory翻译 |
| FocusPersonnelList.vue | useDict增加JobSeekerCategory,bodyCell增加jobSeekerCategory翻译 |
| InternshipPersonnelDetail.vue | useDict增加JobSeekerCategory,求职人员类别字段添加getDictText翻译 |
| FocusPersonnelDetail.vue | useDict增加JobSeekerCategory,求职人员类别字段添加getDictText翻译 |
根本原因:DICTIONARY/DICTIONARY_ITEM表中可能缺少字典数据。V20260604_7脚本可能因之前的CAST错误未成功执行,且数据字典数据插入.sql使用了双引号(达梦不兼容)。
修复方案:在综合修复SQL中增加JobSeekerCategory和JobSeekerStatus字典数据保障。
| 文件 | 修改内容 |
|---|---|
| .docs/sql/修复见习人员权限数据.sql | 增加3.5节JobSeekerCategory字典数据、3.6节JobSeekerStatus字典数据 |
根本原因:后端详情查询遗漏了 custom_tag 字段。
InternshipPersonnelDetailVo 缺少 customTag 字段InternshipPersonnelMapper.xml 的 queryDetailById SQL 遗漏了 ip.custom_tag AS customTagFocusPersonnelDetailVo 和 FocusPersonnelMapper.xml 都有 customTag 字段,见习人员遗漏了修复方案:参照重点关注人员,补全缺失的字段和SQL。
| 文件 | 修改内容 |
|---|---|
| InternshipPersonnelDetailVo.java | 添加 customTag 字段(在 minorTag 之后) |
| InternshipPersonnelMapper.xml | queryDetailById SQL 添加 ip.custom_tag AS customTag |