zjrs-jeecgBoot/.docs/就业援助模块开发记录.md

就业援助模块（3.7）- 开发记录

开发日期：2026-06-09

一、任务说明

依据《需求规格说明书》第3.7节"就业援助"，开发"就业援助"模块，包含两个子模块：

• 3.7.1 初步符合条件人员 - 就业一湛通平台筛查出初步符合就业援助的人员名单
• 3.7.2 就业援助管理 - 省一体化平台回流或录入的就业援助人员数据管理

二、编码风格参考

参考已完成的模块：

• 重点关注人员管理（focuspersonnel）- 视图查询模式、页面VO、详情VO模式
• 见习人员管理（internshippersonnel）- 同上模式，扩展了更多关联字段

三、数据库

3.1 初步符合条件人员表（preliminary_eligible）

字段名	类型	说明
ID	VARCHAR(36) PK	主键ID
PERSONAL_ID	VARCHAR(36)	关联个人信息ID
APPLIED_AID	VARCHAR(10)	是否已申请援助（是/否）
LAST_NOTICE_TIME	DATETIME	最后通知时间
DATA_SOURCE	VARCHAR(50)	数据来源

3.2 就业援助管理表（employment_assistance）

字段名	类型	说明
ID	VARCHAR(36) PK	主键ID
PERSONAL_ID	VARCHAR(36)	关联个人信息ID
PROVINCE_RECORD_ID	VARCHAR(100)	省平台记录ID
APPLY_NUMBER	VARCHAR(100)	申请编号
AID_TYPE	VARCHAR(100)	援助认定类型
AID_STATUS	VARCHAR(100)	援助认定状态
LAST_NOTICE_TIME	DATETIME	最后通知时间

3.3 视图

• v_preliminary_eligible_list - 关联 preliminary_eligible + personal_info
• v_employment_assistance_list - 关联 employment_assistance + personal_info

四、文件清单

4.1 后端文件（jeecg-module-zjrs）

初步符合条件人员（preliminaryeligible）

文件路径	说明
entity/PreliminaryEligible.java	实体类
entity/PreliminaryEligiblePageVo.java	列表页VO
entity/PreliminaryEligibleDetailVo.java	详情VO（含个人信息全部字段）
mapper/PreliminaryEligibleMapper.java	Mapper接口
mapper/xml/PreliminaryEligibleMapper.xml	SQL映射（达梦兼容）
service/IPreliminaryEligibleService.java	服务接口
service/impl/PreliminaryEligibleServiceImpl.java	服务实现
controller/PreliminaryEligibleController.java	REST控制器

就业援助管理（employmentassistance）

文件路径	说明
entity/EmploymentAssistance.java	实体类
entity/EmploymentAssistancePageVo.java	列表页VO
entity/EmploymentAssistanceDetailVo.java	详情VO（含个人信息全部字段）
mapper/EmploymentAssistanceMapper.java	Mapper接口
mapper/xml/EmploymentAssistanceMapper.xml	SQL映射（达梦兼容）
service/IEmploymentAssistanceService.java	服务接口
service/impl/EmploymentAssistanceServiceImpl.java	服务实现
controller/EmploymentAssistanceController.java	REST控制器

4.2 前端文件（jeecgboot-vue3）

初步符合条件人员

文件路径	说明
PreliminaryEligibleList.vue	列表页面
PreliminaryEligible.data.ts	表格列配置
PreliminaryEligible.api.ts	API接口
components/PreliminaryEligibleDetail.vue	详情抽屉组件（含个人信息全部字段）
components/PreliminaryEligibleForm.vue	表单组件
components/PreliminaryEligibleModal.vue	弹窗组件

就业援助管理

文件路径	说明
EmploymentAssistanceList.vue	列表页面
EmploymentAssistance.data.ts	表格列配置
EmploymentAssistance.api.ts	API接口
components/EmploymentAssistanceDetail.vue	详情抽屉组件（含个人信息全部字段）
components/EmploymentAssistanceForm.vue	表单组件
components/EmploymentAssistanceModal.vue	弹窗组件

4.3 SQL脚本

文件	说明
docs/sql/就业援助-建表.sql	达梦建表SQL（含COMMENT注释）
docs/sql/初步符合条件人员视图.sql	v_preliminary_eligible_list视图
docs/sql/就业援助管理视图.sql	v_employment_assistance_list视图
docs/sql/就业援助-菜单权限.sql	菜单+按钮权限+角色授权SQL
flyway/sql/mysql/V20260609_2__menu_insert_EmploymentAssistance.sql	Flyway自动执行的菜单权限SQL

五、菜单层级

就业一湛通服务平台
  ...
  ├── 就业援助（sort_no: 2.20, id: 178060100000200）
  │     ├── 初步符合条件人员（sort_no: 1.00, id: 178060100000210）
  │     │     ├── 添加（preliminary_eligible:add）
  │     │     ├── 编辑（preliminary_eligible:edit）
  │     │     ├── 删除（preliminary_eligible:delete）
  │     │     ├── 批量删除（preliminary_eligible:deleteBatch）
  │     │     ├── 导出excel（preliminary_eligible:exportXls）
  │     │     └── 导入excel（preliminary_eligible:importExcel）
  │     └── 就业援助管理（sort_no: 2.00, id: 178060100000220）
  │           ├── 添加（employment_assistance:add）
  │           ├── 编辑（employment_assistance:edit）
  │           ├── 删除（employment_assistance:delete）
  │           ├── 批量删除（employment_assistance:deleteBatch）
  │           ├── 导出excel（employment_assistance:exportXls）
  │           └── 导入excel（employment_assistance:importExcel）

六、查询条件

初步符合条件人员

姓名、性别、学历、户口所在地、现居住地、年龄范围、求职状态、是否已申请援助

就业援助管理

姓名、户口所在地、援助认定类型、援助认定状态

七、部署说明

按以下顺序执行：

1. 执行建表SQL：就业援助-建表.sql
2. 执行视图SQL：初步符合条件人员视图.sql → 就业援助管理视图.sql
3. 重新编译部署后端服务（Flyway自动执行V20260609_2菜单权限SQL）
4. 重新构建部署前端服务
5. 使用admin账号登录系统，验证菜单和功能