# 重点关注人员管理（3.2.1）- 需求与现有实现对比分析

## 分析日期：2026-06-04

## 一、需求文档来源
- `湛江市人力资源和社会保障局智慧人社运营运维（2025-2027年）项目需求规格说明书-就业一湛通服务平台.docx`
- 章节：3.2.1 重点关注人员管理

## 二、现有实现文件结构

### 后端 (jeecg-module-zjrs)
```
src/main/java/org/jeecg/modules/zjrs/focuspersonnel/
├── controller/FocusPersonnelController.java      # REST控制器
├── entity/
│   ├── FocusPersonnel.java                        # 实体类（表：focus_personnel）
│   └── FocusPersonnelPageVo.java                  # 列表页VO（含个人信息字段）
├── mapper/
│   ├── FocusPersonnelMapper.java                  # Mapper接口
│   └── xml/FocusPersonnelMapper.xml                # SQL映射（查询视图v_focus_personnel_list）
├── service/
│   ├── IFocusPersonnelService.java                 # 服务接口
│   └── impl/FocusPersonnelServiceImpl.java         # 服务实现
```

### 前端 (jeecgboot-vue3)
```
src/views/focuspersonnel/
├── FocusPersonnelList.vue                          # 列表页面
├── FocusPersonnel.data.ts                          # 表格列配置
├── FocusPersonnel.api.ts                           # API接口
├── components/
│   ├── FocusPersonnelForm.vue                      # 表单组件
│   └── FocusPersonnelModal.vue                     # 弹窗组件
```

### SQL脚本
```
flyway/sql/mysql/V20260603_1__menu_insert_FocusPersonnel.sql  # 菜单权限SQL
```

## 三、需求与实现逐项对比

### 3.1 列表字段

| 需求字段 | 现有实现 | 状态 |
|---------|---------|:----:|
| 姓名 | ✅ `fullName` | ✅ |
| 性别 | ✅ `gender` | ✅ |
| 年龄 | ✅ `age` | ✅ |
| 学历 | ✅ `education` | ✅ |
| 户口所在地 | ✅ `householdLocation` | ✅ |
| 现居住地 | ✅ `currentResidence` | ✅ |
| 求职人员类别 | ✅ `jobSeekerCategory` | ✅ |
| 联系电话 | ✅ `contactPhone` | ✅ |
| 求职状态 | ✅ `jobSearchStatus` | ✅ |
| 人员大类标签 | ✅ `majorTag` | ✅ |
| 人员小类标签 | ✅ `minorTag` | ✅ |
| 自定义标签 | ✅ `customTag` | ✅ |

**列表字段已全部实现。**

### 3.2 查询条件

| 需求查询字段 | 现有实现 | 状态 |
|-------------|---------|:----:|
| 姓名 | ✅ | ✅ |
| 性别 | ✅ | ✅ |
| 学历 | ✅ | ✅ |
| 户口所在地 | ❌ 未实现 | ❌ |
| 现居住地 | ❌ 未实现 | ❌ |
| 年龄 | ❌ 未实现 | ❌ |
| 人员大类标签 | ✅ | ✅ |
| 人员小类标签 | ❌ 未实现 | ❌ |
| 自定义标签 | ❌ 未实现 | ❌ |
| 就业状态 | ✅（求职状态） | ✅ |

**查询条件缺少：户口所在地、现居住地、年龄、人员小类标签、自定义标签，需补充。**

### 3.3 支持功能

| 需求功能 | 现有实现 | 状态 | 说明 |
|---------|---------|:----:|------|
| 刷新生成 | ❌ 完全未实现 | ❌ | 需点击刷新按钮自动生成/更新重点关注人员数据 |
| 新增 | ✅ | ✅ | |
| 导出 | ✅ | ✅ | |
| 查看/详情 | ⚠️ 部分实现 | ⚠️ | 现有详情仅显示4个字段(personalId, majorTag, minorTag, customTag)，需求要求显示30个完整个人信息字段 |
| 自定义标签 | ⚠️ 部分实现 | ⚠️ | 基础文本输入，需求要求"勾选数据添加自定义标签（支持多选）" |
| 消息推送 | ❌ 完全未实现 | ❌ | 需新建消息推送功能 |
| 岗位推送 | ❌ 完全未实现 | ❌ | 需新建岗位推送功能 |
| 服务跟进 | ❌ 完全未实现 | ❌ | 需新建服务跟进记录功能 |

### 3.4 详情页面字段

需求要求详情页面显示以下字段（关联个人信息表）：

| 序号 | 字段 | 现有实现 | 状态 |
|:----:|------|:--------:|:----:|
| 1 | 证件类型 | 仅在PersonalInfo表 | ❌ |
| 2 | 证件号码 | 仅在PersonalInfo表 | ❌ |
| 3 | 姓名 | 仅在列表VO | ❌（详情未展示） |
| 4 | 性别 | 同上 | ❌ |
| 5 | 出生日期 | 同上 | ❌ |
| 6 | 民族 | 同上 | ❌ |
| 7 | 国籍 | 同上 | ❌ |
| 8 | 婚姻状况 | 同上 | ❌ |
| 9 | 学历 | 同上 | ❌ |
| 10 | 毕业日期 | 同上 | ❌ |
| 11 | 毕业院校 | 同上 | ❌ |
| 12 | 专业 | 同上 | ❌ |
| 13 | 政治面貌 | 同上 | ❌ |
| 14 | 工作经验 | 同上 | ❌ |
| 15 | 户口性质 | 同上 | ❌ |
| 16 | 户口所在地 | 同上 | ❌ |
| 17 | 现居住地 | 同上 | ❌ |
| 18 | 现居住地址 | 同上 | ❌ |
| 19 | 求职人员类别 | 同上 | ❌ |
| 20 | 联系电话 | 同上 | ❌ |
| 21 | 邮箱 | 同上 | ❌ |
| 22 | QQ号码 | 同上 | ❌ |
| 23 | 微信号 | 同上 | ❌ |
| 24 | 是否留学人才 | 同上 | ❌ |
| 25 | 职业技能等级 | 同上 | ❌ |
| 26 | 求职状态 | 同上 | ❌ |
| 27 | 是否接受推荐职位 | 同上 | ❌ |
| 28 | 人员大类标签 | 在FocusPersonnel表 | ✅ |
| 29 | 人员小类标签 | 在FocusPersonnel表 | ✅ |
| 30 | 自定义标签 | 在FocusPersonnel表 | ✅ |

**详情字段严重缺失，需新增详情页面接口，从personal_info表关联查询完整信息。**

### 3.5 业务逻辑 - 刷新生成机制（完全未实现）

需求描述：
> 点击刷新按钮，系统自动生成或更新重点关注人员数据和判断已经生成的数据的有效性。数据来源于省一体化回流的个人信息数据库。

**需新建：**
1. 后端刷新接口：`POST /focusPersonnel/refresh`
2. 自动生成逻辑：从省一体化回流数据（personal_info表）筛选符合条件的重点关注人员
3. 前端刷新按钮及交互

### 3.6 业务逻辑 - 人员标签体系（部分实现）

#### 3.6.1 大类标签（需初始化字典）
需求值：就业困难人员、脱贫人员（注：见习人员已独立为见习人员管理模块，不在此处）
实体已有 `majorTag` 字段，字典 `focus_major_tag` 但未初始化数据。

**需补充：字典`focus_major_tag`的两个选项**

#### 3.6.2 小类标签（需初始化字典）
**见习人员小类：**
- 离校2年内未就业高校毕业生
- 16-24岁失业青年

**就业困难人员小类（13类）：**
1. 大龄失业人员（女≥40岁，男≥50岁）
2. 残疾人员
3. 享受最低生活保障待遇人员
4. 城镇"零就业家庭"人员
5. 农村零转移就业原建档立卡贫困家庭人员
6. 失地农民
7. 连续失业1年以上人员
8. 戒毒康复人员
9. 刑满释放人员
10. 精神障碍康复人员
11. 失业6个月以上的退役军人
12. 需赡养患重病直系亲属的人员
13. 省人民政府规定的其他人员

**脱贫人员小类：**
- 脱贫不稳定户
- 边缘易致贫户
- 突发严重困难户

**需新建字典：`focus_minor_tag` 包含以上所有选项（不含见习人员小类，见习人员已独立管理）**

#### 3.6.3 自动分类判断逻辑（完全未实现）
需要编写复杂的业务逻辑来自动判断人员分类，特别是见习人员的判断：
- 离校2年内未就业高校毕业生：毕业日期+2年内+无社保+未就业
- 16-24岁失业青年：年龄16-24周岁+失业登记
- 优先级：同时符合时优先显示"离校2年内未就业高校毕业生"

### 3.7 消息推送（完全未实现）

**需新建：**
1. 数据库表 `focus_personnel_message`：消息主题、消息内容、推送人、推送时间、关联人员ID
2. 后端 CRUD + 推送接口
3. 前端消息推送弹窗/页面
4. 按钮权限

### 3.8 岗位推送（完全未实现）

**需新建：**
1. 岗位推送功能，可手动选择见习岗位推送给见习人员
2. 需关联 `internshippost`（见习岗位）模块
3. 前端岗位推送弹窗

### 3.9 服务跟进（完全未实现）

**需新建：**
1. 数据库表 `focus_personnel_service_follow`：姓名、服务内容、服务时间、服务人员、关联人员ID
2. 后端 CRUD 接口
3. 前端服务跟进列表弹窗/页面
4. 按钮权限

### 3.10 自定义标签功能增强（需完善）

需求要求：勾选数据添加自定义标签（支持多选）
现有：只是一个文本输入框

**需改进：**
1. 后端增加批量添加标签接口
2. 前端改为标签选择器，支持多选和新增标签
3. 可关联标签模块（`tag/PersonalTag`）

## 四、数据库表结构问题

| 项目 | 状态 | 说明 |
|------|:----:|------|
| `focus_personnel` 表 | ❌ 未找到CREATE语句 | 需补充建表SQL |
| `v_focus_personnel_list` 视图 | ❌ 未找到CREATE语句 | 需补充创建视图SQL |
| 字典`focus_major_tag` | ❌ 未初始化 | 需补充字典数据 |
| 字典`focus_minor_tag` | ❌ 未创建 | 需新建字典 |
| `service_follow` 表 | ❌ 未创建 | 需新建 |
| `message_push` 表 | ❌ 未创建 | 需新建 |

## 五、总结 - 需开发的功能列表

按优先级排序：

| 优先级 | 功能 | 工作量评估 |
|:------:|------|:----------:|
| P0 | 补充数据库表、视图、字典初始化SQL | 小 |
| P0 | 完善详情页面（关联personal_info查询30个字段） | 中 |
| P1 | 新增刷新生成按钮及后端接口 | 大（含分类逻辑） |
| P1 | 人员标签自动分类判断逻辑 | 大（复杂业务规则） |
| P1 | 完善查询条件（补充户口所在地、现居住地等5个条件） | 小 |
| P2 | 服务跟进功能（新建表+CRUD+前端） | 中 |
| P2 | 消息推送功能（新建表+CRUD+推送+前端） | 中 |
| P2 | 岗位推送功能（关联见习岗位模块） | 中 |
| P2 | 自定义标签功能增强（多选+批量操作） | 中 |
| P3 | 新增按钮权限（服务跟进、消息推送、岗位推送、刷新） | 小 |

## 六、相关数据模型关系

```
personal_info (个人信息表)
    ↑ 关联 (personalId)
focus_personnel (重点关注人员表)
    ├── focus_personnel_message (消息推送) [待新建]
    ├── focus_personnel_service_follow (服务跟进) [待新建]
    └── focus_personnel_job_push (岗位推送) [待新建]
        关联 internshippost (见习岗位)
```