见习岗位管理与见习人员管理模块开发记录

开发日期

2026-06-03

模块概述

本次开发实现了"见习岗位管理"和"见习人员管理"两个模块的完整后端+前端代码，参考 FocusPersonnel 模块的代码模式。

一、见习岗位管理（InternshipPost）

1.1 后端代码

文件	路径	说明
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自动构建查询条件

关键设计：

/list 接口使用 QueryGenerator 自动构建查询条件（不需要自定义queryPageList）
权限前缀：internship_post
实体类使用 @TableId(type = IdType.ASSIGN_ID)

1.2 前端代码

文件	路径	说明
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/	弹窗组件

关键设计：

查询区域：单位名称(输入框)、工作地点(输入框)、见习岗位(输入框)、发布状态(a-select: 0未发布/1已发布)、报名状态(a-select: 01报名中/02人员已满)
表单分两个卡片：卡片1-见习单位信息、卡片2-见习岗位信息
身份要求使用 a-checkbox-group（高校毕业生/失业青年/脱贫家庭青年），存储为逗号分隔字符串
单位性质使用 a-select 硬编码选项（国有企业/民营企业/外资企业/事业单位/社会团体）
报名方式使用 a-select 硬编码选项（网上报名/现场报名）
报名截止日期使用 a-date-picker 日期选择器

1.3 Flyway菜单SQL

文件	路径
V20260603_5__menu_insert_InternshipPost.sql	flyway/sql/mysql/

菜单结构：

一级菜单"见习管理"：id=178060100000030
二级菜单"见习岗位管理"：id=178060100000031
按钮权限：add(1780601000000311), edit(1780601000000312), delete(1780601000000313), deleteBatch(1780601000000314), exportXls(1780601000000315), importExcel(1780601000000316)
角色授权：ID从1780601000000317开始

二、见习人员管理（InternshipPersonnel）

2.1 后端代码

文件	路径	说明
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模式

关键设计：

/list 接口使用 queryPageList（参考FocusPersonnelController），从视图v_internship_personnel_list查询
查询参数：fullName(模糊)、internshipStatus(精确)、auditStatus(精确)、postName(模糊)、companyName(模糊)
权限前缀：internship_personnel
排序：ORDER BY id DESC

2.2 前端代码

文件	路径	说明
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/	弹窗组件

关键设计：

查询区域：姓名(输入框)、见习状态(a-select: 见习中/已期满/已退出)、审核状态(a-select: 待审核/已通过/未通过)、见习单位(输入框)、见习岗位(输入框)
表单字段：关联个人信息(personalId输入框)、关联见习岗位(internshipPostId输入框)、见习状态(下拉框)、见习开始日期(日期选择器)、见习结束日期(日期选择器)、审核状态(下拉框)、审核意见(文本域)

2.3 Flyway菜单SQL

文件	路径
V20260603_6__menu_insert_InternshipPersonnel.sql	flyway/sql/mysql/

菜单结构：

二级菜单"见习人员管理"：id=178060100000032，parent_id=178060100000030(见习管理)
按钮权限：add(1780601000000321), edit(1780601000000322), delete(1780601000000323), deleteBatch(1780601000000324), exportXls(1780601000000325), importExcel(1780601000000326)
角色授权：ID从1780601000000327开始

三、注意事项

所有Java注释使用中文
Flyway SQL不使用反引号（达梦数据库兼容）
见习岗位模块的/list接口使用标准QueryGenerator模式（不需要视图）
见习人员模块的/list接口使用queryPageList模式（从视图v_internship_personnel_list查询）
实体类使用 @TableId(type = IdType.ASSIGN_ID)
Controller 继承 JeecgController
前端表单下拉框使用 a-select 硬编码选项
Flyway SQL中INSERT语句每行一个，不使用多行VALUES
见习岗位表单的身份要求使用 a-checkbox-group，存储为逗号分隔字符串