# 就业一湛通服务平台 - 新增模块开发记录

> 开发日期：2026-06-03
> 模块：见习岗位管理、见习人员管理、公益性岗位管理、岗位推荐
> 参考模块：重点关注人员管理（focuspersonnel）

---

## 一、模块总览

| 模块 | 包路径 | 数据库表 | API路径 | 查询方式 | 菜单位置 |
|------|--------|----------|---------|----------|----------|
| 见习岗位管理 | internshippost | internship_post | /internshipPost | QueryGenerator | 见习管理 > 见习岗位管理 |
| 见习人员管理 | internshippersonnel | internship_personnel | /internshipPersonnel | 视图查询 | 见习管理 > 见习人员管理 |
| 公益性岗位管理 | welfarepost | welfare_post | /welfarePost | QueryGenerator | 公益性岗位管理 |
| 岗位推荐 | jobrecommend | job_recommend | /jobRecommend | 视图查询 | 岗位推荐 |

---

## 二、数据库表结构

### 2.1 INTERNSHIP_POST（见习岗位）

| 字段名 | 类型 | 说明 |
|--------|------|------|
| ID | VARCHAR(36) PK | 主键ID |
| ENTERPRISE_ID | VARCHAR(36) | 关联企业ID |
| COMPANY_NAME | VARCHAR(200) | 单位名称 |
| COMPANY_NATURE | VARCHAR(50) | 单位性质 |
| WORK_LOCATION | VARCHAR(200) | 工作地点行政区划 |
| DETAILED_ADDRESS | VARCHAR(500) | 详细工作地址 |
| CONTACT_PERSON | VARCHAR(100) | 联系人 |
| CONTACT_PHONE | VARCHAR(20) | 联系电话 |
| WORK_EMAIL | VARCHAR(100) | 工作邮箱 |
| POST_NAME | VARCHAR(200) | 见习岗位名称 |
| IDENTITY_REQUIREMENT | VARCHAR(200) | 身份要求 |
| INTERNSHIP_PERIOD | VARCHAR(50) | 见习期限 |
| INTERNSHIP_SUBSIDY | VARCHAR(50) | 见习补助 |
| INTERNSHIP_COUNT | INTEGER | 见习人数 |
| INTERNSHIP_REQUIREMENT | TEXT | 见习要求 |
| APPLY_METHOD | VARCHAR(50) | 报名方式 |
| APPLY_DEADLINE | DATE | 报名截止日期 |
| RETAIN_SALARY | VARCHAR(50) | 留用月薪 |
| RETAIN_BENEFITS | VARCHAR(500) | 留用福利 |
| PUBLISH_STATUS | VARCHAR(10) | 发布状态（0未发布/1已发布） |
| PUBLISHER | VARCHAR(50) | 发布人 |
| PUBLISH_ORG | VARCHAR(50) | 发布机构 |
| PUBLISH_TIME | DATETIME | 发布时间 |
| APPLY_STATUS | VARCHAR(10) | 报名状态（01报名中/02人员已满） |

### 2.2 INTERNSHIP_PERSONNEL（见习人员）

| 字段名 | 类型 | 说明 |
|--------|------|------|
| ID | VARCHAR(36) PK | 主键ID |
| PERSONAL_ID | VARCHAR(36) | 关联个人信息ID |
| INTERNSHIP_POST_ID | VARCHAR(36) | 关联见习岗位ID |
| INTERNSHIP_STATUS | VARCHAR(50) | 见习状态 |
| START_DATE | DATE | 见习开始日期 |
| END_DATE | DATE | 见习结束日期 |
| AUDIT_STATUS | VARCHAR(50) | 审核状态 |
| AUDIT_OPINION | VARCHAR(500) | 审核意见 |

> 个人信息（姓名、性别、联系电话等）通过视图 v_internship_personnel_list 关联 personal_info 获取

### 2.3 WELFARE_POST（公益性岗位）

| 字段名 | 类型 | 说明 |
|--------|------|------|
| ID | VARCHAR(36) PK | 主键ID |
| ENTERPRISE_ID | VARCHAR(36) | 关联企业ID |
| COMPANY_NAME | VARCHAR(200) | 用人单位名称 |
| POST_NAME | VARCHAR(200) | 岗位名称 |
| POST_TYPE | VARCHAR(50) | 岗位类型 |
| WORK_LOCATION | VARCHAR(200) | 工作地点 |
| DETAILED_ADDRESS | VARCHAR(500) | 详细地址 |
| RECRUIT_COUNT | INTEGER | 招聘人数 |
| PLACED_COUNT | INTEGER | 已安置人数 |
| SUBSIDY_STANDARD | VARCHAR(50) | 补贴标准 |
| SUBSIDY_PERIOD | VARCHAR(50) | 补贴期限 |
| SOCIAL_SECURITY_SUBSIDY | VARCHAR(50) | 社保补贴 |
| POST_DESC | TEXT | 岗位描述 |
| POST_REQUIREMENT | TEXT | 岗位要求 |
| APPLY_METHOD | VARCHAR(50) | 报名方式 |
| APPLY_DEADLINE | DATE | 报名截止日期 |
| PUBLISH_STATUS | VARCHAR(10) | 发布状态 |
| POST_STATUS | VARCHAR(10) | 岗位状态 |
| PUBLISHER | VARCHAR(50) | 发布人 |
| PUBLISH_ORG | VARCHAR(50) | 发布机构 |
| PUBLISH_TIME | DATETIME | 发布时间 |

### 2.4 JOB_RECOMMEND（岗位推荐）

| 字段名 | 类型 | 说明 |
|--------|------|------|
| ID | VARCHAR(36) PK | 主键ID |
| PERSONAL_ID | VARCHAR(36) | 关联个人信息ID |
| POST_ID | VARCHAR(36) | 关联岗位ID |
| RECOMMEND_TYPE | VARCHAR(20) | 推荐类型 |
| RECOMMEND_OPINION | VARCHAR(500) | 推荐意见 |
| RECOMMEND_STATUS | VARCHAR(20) | 推荐状态 |

> 个人信息和岗位信息通过视图 v_job_recommend_list 关联获取

---

## 三、视图定义

### 3.1 v_internship_personnel_list（见习人员列表视图）

关联 internship_personnel + personal_info + internship_post，提供姓名、性别、联系电话、学历、证件号码、见习岗位名称、见习单位名称等字段。

SQL文件：`.docs/sql/见习人员视图.sql`

### 3.2 v_job_recommend_list（岗位推荐列表视图）

关联 job_recommend + personal_info + post_info + enterprise_info，提供姓名、性别、联系电话、学历、岗位名称、工作地点、单位名称等字段。

SQL文件：`.docs/sql/岗位推荐视图.sql`

---

## 四、菜单层级

```
就业一湛通服务平台
  ├── 信息智能匹配推送（sort_no: 1.80）
  │     └── 重点关注人员管理
  ├── 见习管理（sort_no: 1.90, id: 178060100000030）
  │     ├── 见习岗位管理（id: 178060100000031）
  │     └── 见习人员管理（id: 178060100000032）
  ├── 公益性岗位管理（sort_no: 2.00, id: 178060100000040）
  │     └── 公益性岗位管理（id: 178060100000041）
  └── 岗位推荐（sort_no: 2.10, id: 178060100000050）
        └── 岗位推荐（id: 178060100000051）
```

---

## 五、文件清单

### 5.1 SQL脚本

| 文件 | 说明 |
|------|------|
| `.docs/sql/见习岗位信息.sql` | INTERNSHIP_POST建表SQL |
| `.docs/sql/见习人员信息.sql` | INTERNSHIP_PERSONNEL建表SQL |
| `.docs/sql/公益性岗位信息.sql` | WELFARE_POST建表SQL |
| `.docs/sql/岗位推荐信息.sql` | JOB_RECOMMEND建表SQL |
| `.docs/sql/见习人员视图.sql` | v_internship_personnel_list视图SQL |
| `.docs/sql/岗位推荐视图.sql` | v_job_recommend_list视图SQL |

### 5.2 Flyway脚本

| 文件 | 说明 |
|------|------|
| `V20260603_5__menu_insert_InternshipPost.sql` | 见习管理+见习岗位管理菜单权限 |
| `V20260603_6__menu_insert_InternshipPersonnel.sql` | 见习人员管理菜单权限 |
| `V20260603_7__menu_insert_WelfarePost.sql` | 公益性岗位管理菜单权限 |
| `V20260603_8__menu_insert_JobRecommend.sql` | 岗位推荐菜单权限 |

### 5.3 后端文件

| 模块 | 文件数 | 包路径 |
|------|--------|--------|
| 见习岗位管理 | 6 | org.jeecg.modules.zjrs.internshippost |
| 见习人员管理 | 7（含PageVo） | org.jeecg.modules.zjrs.internshippersonnel |
| 公益性岗位管理 | 6 | org.jeecg.modules.zjrs.welfarepost |
| 岗位推荐 | 7（含PageVo） | org.jeecg.modules.zjrs.jobrecommend |

### 5.4 前端文件

| 模块 | 文件数 | 目录路径 |
|------|--------|----------|
| 见习岗位管理 | 5 | views/internshippost/ |
| 见习人员管理 | 5 | views/internshippersonnel/ |
| 公益性岗位管理 | 5 | views/welfarepost/ |
| 岗位推荐 | 5 | views/jobrecommend/ |

---

## 六、部署说明

按以下顺序执行：

1. 执行建表SQL（4个表）：见习岗位信息.sql → 见习人员信息.sql → 公益性岗位信息.sql → 岗位推荐信息.sql
2. 执行视图SQL（2个视图）：见习人员视图.sql → 岗位推荐视图.sql
3. 重新编译部署后端服务（Flyway自动执行V5~V8菜单权限SQL）
4. 重新构建部署前端服务
5. 使用admin账号登录系统，验证菜单和功能

---

## 七、技术要点

1. **查询方式**：见习岗位和公益性岗位使用 QueryGenerator 标准模式（表字段完整，无需JOIN）；见习人员和岗位推荐使用视图查询模式（需关联个人信息和岗位信息）
2. **视图查询**：Mapper XML 中 `SELECT * FROM 视图名`，避免JOIN语法
3. **下拉框**：使用 `<a-select>` 硬编码选项（发布状态、报名状态、见习状态等），与数据库存储的文本值匹配
4. **组件导入**：使用 `j-dict-select-tag` 时必须 `import JDictSelectTag`
5. **达梦兼容**：SQL不使用反引号，INSERT每行一条