# 就业援助模块（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账号登录系统，验证菜单和功能