wuzhen update招生就业
This commit is contained in:
1 parent
7e122d76dd
commit
e5c6fd7a24
55 files changed
+3563
-2397
No files matched your search
@@ -73,6 +73,8 @@
|
||||
|
||||
## 企业信息管理API
|
||||
|
||||
[企业信息管理API](./企业信息管理API.md) - 包含企业基本信息管理、招聘岗位管理(含子表CRUD)、招聘简章PDF生成(单个/批量)、Excel导入功能(支持企业+岗位一体化导入)。
|
||||
**重大更新(2026-03-30)**:企业信息新增企业简介、办公电话、官网字段;整合岗位管理;新增简章PDF生成和导入功能。
|
||||
|
||||
[统计报表API](./统计报表API.md) - 包含各类统计数据查询接口。
|
||||
|
||||
|
||||
+502
-397
@@ -1,454 +1,559 @@
|
||||
# 企业信息管理API接口文档
|
||||
|
||||
> 文档创建人:admin
|
||||
> 创建日期:2023-07-05
|
||||
> 文档状态:创建中
|
||||
> 文档创建人:admin
|
||||
> 创建日期:2023-07-05
|
||||
> 更新日期:2026-03-30
|
||||
> 文档状态:已完成
|
||||
|
||||
## 1. 概述
|
||||
|
||||
本文档描述了企业信息管理模块的API接口设计。企业信息管理模块包含企业基本信息管理、招聘岗位管理以及招聘海报生成功能。
|
||||
本文档描述了企业信息管理模块的API接口设计。企业信息管理模块包含企业基本信息管理、招聘岗位管理以及招聘简章PDF生成功能。
|
||||
|
||||
**核心变更(2026-03-30)**:
|
||||
- 企业信息新增「企业简介」「办公电话」「官网」字段
|
||||
- 企业信息与岗位信息在新增/编辑时一体化处理
|
||||
- 新增招聘简章PDF生成功能(单个/批量)
|
||||
- 新增Excel导入功能(支持企业+岗位一次性导入)
|
||||
- 废弃原招聘海报管理、招聘岗位管理菜单(功能整合至本模块)
|
||||
|
||||
### 1.1 基础信息
|
||||
|
||||
- 接口基础路径:`/zsjy/enterprise`
|
||||
- 请求方式:`GET`、`POST`、`PUT`、`DELETE`
|
||||
- 认证方式:Bearer Token
|
||||
- 响应格式:统一响应格式
|
||||
| 项目 | 说明 |
|
||||
|------|------|
|
||||
| 接口基础路径 | `/zsjy/enterprise` |
|
||||
| 请求方式 | `GET`、`POST`、`PUT`、`DELETE` |
|
||||
| 认证方式 | Bearer Token |
|
||||
| 响应格式 | 统一响应格式 `R<T>`,列表分页用 `TableDataInfo<T>` |
|
||||
|
||||
### 1.2 数据结构
|
||||
|
||||
#### 1.2.1 企业信息 (EnterpriseVO)
|
||||
|
||||
| 字段 | 类型 | 说明 |
|
||||
|------|------|------|
|
||||
| id | Long | 企业ID |
|
||||
| enterpriseName | String | 企业名称 |
|
||||
| industry | String | 所属行业(字典值) |
|
||||
| industryName | String | 所属行业名称(字典标签) |
|
||||
| mainBusiness | String | 主营业务(兼容保留) |
|
||||
| enterpriseScale | String | 企业规模(字典值) |
|
||||
| enterpriseScaleName | String | 企业规模名称(字典标签) |
|
||||
| enterpriseIntro | String | **新增** 企业简介(≤1500字符,用于招聘简章) |
|
||||
| contactName | String | 联系人姓名 |
|
||||
| contactPhone | String | 联系电话 |
|
||||
| officePhone | String | **新增** 办公电话 |
|
||||
| email | String | 电子邮箱 |
|
||||
| website | String | **新增** 企业官网 |
|
||||
| address | String | 企业地址 |
|
||||
| status | String | 状态(0正常 1停用) |
|
||||
| remark | String | 备注(兼容保留) |
|
||||
| jobList | List\<EnterpriseJobVO\> | **新增** 岗位列表(用于招聘简章) |
|
||||
| jobCount | Integer | **新增** 岗位数量(列表展示用) |
|
||||
| createBy | Long | 创建者 |
|
||||
| createTime | Date | 创建时间 |
|
||||
| updateBy | Long | 更新者 |
|
||||
| updateTime | Date | 更新时间 |
|
||||
|
||||
#### 1.2.2 招聘岗位信息 (EnterpriseJobVO)
|
||||
|
||||
| 字段 | 类型 | 说明 |
|
||||
|------|------|------|
|
||||
| id | Long | 岗位ID |
|
||||
| enterpriseId | Long | 所属企业ID |
|
||||
| positionName | String | 岗位名称 |
|
||||
| requirements | String | **岗位要求**(用于招聘简章) |
|
||||
| benefits | String | **待遇**(用于招聘简章) |
|
||||
| status | String | 状态(0正常 1停用) |
|
||||
| createBy | Long | 创建者 |
|
||||
| createTime | Date | 创建时间 |
|
||||
| updateBy | Long | 更新者 |
|
||||
| updateTime | Date | 更新时间 |
|
||||
|
||||
#### 1.2.3 简章生成记录 (EnterpriseBrochureVO)
|
||||
|
||||
| 字段 | 类型 | 说明 |
|
||||
|------|------|------|
|
||||
| id | Long | 记录ID |
|
||||
| enterpriseId | Long | 企业ID |
|
||||
| enterpriseName | String | 企业名称(关联) |
|
||||
| brochurePath | String | PDF文件存储路径 |
|
||||
| fileName | String | 文件名称 |
|
||||
| fileSize | Long | 文件大小(字节) |
|
||||
| generateBy | Long | 生成人ID |
|
||||
| generateByName | String | 生成人姓名 |
|
||||
| generateTime | Date | 生成时间 |
|
||||
| createTime | Date | 创建时间 |
|
||||
|
||||
#### 1.2.4 企业导入模板 (ZsjyEnterpriseImportVo)
|
||||
|
||||
导入模板共19列(H~AC为岗位信息,最多支持6个岗位):
|
||||
|
||||
| 列 | 字段名 | 必填 | 说明 |
|
||||
|----|--------|------|------|
|
||||
| A | 企业名称 | 是 | 唯一性校验 |
|
||||
| B | 企业简介 | 否 | ≤1500字符 |
|
||||
| C | 企业地址 | 是 | — |
|
||||
| D | 联系人 | 是 | — |
|
||||
| E | 联系电话 | 是 | 手机号格式 |
|
||||
| F | 办公电话 | 否 | — |
|
||||
| G | 电子邮箱 | 是 | 邮箱格式 |
|
||||
| H | 招聘岗位1 | 否 | 岗位名称 |
|
||||
| I | 要求1 | 否 | 岗位要求 |
|
||||
| J | 待遇1 | 否 | 待遇信息 |
|
||||
| K | 招聘岗位2 | 否 | — |
|
||||
| L | 要求2 | 否 | — |
|
||||
| M | 待遇2 | 否 | — |
|
||||
| N | 招聘岗位3 | 否 | — |
|
||||
| O | 要求3 | 否 | — |
|
||||
| P | 待遇3 | 否 | — |
|
||||
| Q | 招聘岗位4 | 否 | — |
|
||||
| R | 要求4 | 否 | — |
|
||||
| S | 待遇4 | 否 | — |
|
||||
| T | 招聘岗位5 | 否 | — |
|
||||
| U | 要求5 | 否 | — |
|
||||
| V | 待遇5 | 否 | — |
|
||||
| W | 招聘岗位6 | 否 | — |
|
||||
| X | 要求6 | 否 | — |
|
||||
| Y | 待遇6 | 否 | — |
|
||||
|
||||
---
|
||||
|
||||
## 2. 接口详细说明
|
||||
|
||||
### 2.1 查询企业信息列表
|
||||
|
||||
**接口地址**:`GET /zsjy/enterprise/list`
|
||||
|
||||
**权限标识**:`zsjy:enterprise:list`
|
||||
|
||||
**请求参数**:
|
||||
|
||||
| 参数名 | 类型 | 必填 | 说明 |
|
||||
|--------|------|------|------|
|
||||
| enterpriseName | String | 否 | 企业名称(模糊查询) |
|
||||
| industry | String | 否 | 所属行业(字典值) |
|
||||
| enterpriseScale | String | 否 | 企业规模(字典值) |
|
||||
| status | String | 否 | 状态(0正常 1停用) |
|
||||
| contactName | String | 否 | 联系人(模糊查询) |
|
||||
| contactPhone | String | 否 | 联系电话(模糊查询) |
|
||||
| email | String | 否 | 邮箱(模糊查询) |
|
||||
| address | String | 否 | 地址(模糊查询) |
|
||||
| pageNum | Integer | 否 | 页码(默认1) |
|
||||
| pageSize | Integer | 否 | 每页条数(默认10) |
|
||||
|
||||
**响应示例**:
|
||||
|
||||
```json
|
||||
{
|
||||
"id": "企业ID,long型",
|
||||
"enterpriseName": "企业名称,字符串",
|
||||
"industry": "所属行业,字典值",
|
||||
"mainBusiness": "主营业务,字符串",
|
||||
"enterpriseScale": "企业规模,字典值",
|
||||
"contactName": "企业联系人姓名,字符串",
|
||||
"contactPhone": "联系电话,字符串",
|
||||
"email": "企业邮箱,字符串",
|
||||
"address": "企业地址,字符串",
|
||||
"status": "状态(0正常 1停用),字符",
|
||||
"remark": "备注,字符串",
|
||||
"createBy": "创建者,long型",
|
||||
"createTime": "创建时间,日期时间",
|
||||
"updateBy": "更新者,long型",
|
||||
"updateTime": "更新时间,日期时间"
|
||||
"code": 200,
|
||||
"msg": "操作成功",
|
||||
"total": 10,
|
||||
"rows": [
|
||||
{
|
||||
"id": 1,
|
||||
"enterpriseName": "杭州某某科技有限公司",
|
||||
"industry": "01",
|
||||
"industryName": "互联网",
|
||||
"enterpriseScale": "01",
|
||||
"enterpriseScaleName": "小型企业",
|
||||
"enterpriseIntro": "公司成立于2010年,专注于软件开发...",
|
||||
"contactName": "张三",
|
||||
"contactPhone": "13800138000",
|
||||
"officePhone": "0571-88888888",
|
||||
"email": "hr@example.com",
|
||||
"website": "https://www.example.com",
|
||||
"address": "浙江省杭州市西湖区xxx路xxx号",
|
||||
"status": "0",
|
||||
"jobCount": 3,
|
||||
"createTime": "2026-03-30 10:00:00"
|
||||
}
|
||||
]
|
||||
}
|
||||
```
|
||||
|
||||
#### 1.2.2 招聘岗位信息 (JobPositionVO)
|
||||
---
|
||||
|
||||
### 2.2 获取企业详细信息
|
||||
|
||||
**接口地址**:`GET /zsjy/enterprise/{id}`
|
||||
|
||||
**权限标识**:`zsjy:enterprise:query`
|
||||
|
||||
**路径参数**:
|
||||
|
||||
| 参数名 | 类型 | 必填 | 说明 |
|
||||
|--------|------|------|------|
|
||||
| id | Long | 是 | 企业ID |
|
||||
|
||||
**响应示例**:
|
||||
|
||||
```json
|
||||
{
|
||||
"id": "岗位ID,long型",
|
||||
"enterpriseId": "所属企业ID,long型",
|
||||
"enterpriseName": "所属企业名称,字符串",
|
||||
"positionName": "岗位名称,字符串",
|
||||
"workAddress": "工作地址,字符串",
|
||||
"workTime": "工作时间,字符串",
|
||||
"salary": "薪资,字符串",
|
||||
"requiredSkills": "所需技能,字符串",
|
||||
"startDate": "有效期开始日期,日期时间",
|
||||
"endDate": "有效期结束日期,日期时间",
|
||||
"isPermanent": "是否永久有效(0否 1是),整型",
|
||||
"status": "状态(0正常 1停用),字符",
|
||||
"remark": "备注,字符串",
|
||||
"createBy": "创建者,long型",
|
||||
"createTime": "创建时间,日期时间",
|
||||
"updateBy": "更新者,long型",
|
||||
"updateTime": "更新时间,日期时间"
|
||||
}
|
||||
```
|
||||
|
||||
#### 1.2.3 招聘海报 (RecruitmentPosterVO)
|
||||
|
||||
```json
|
||||
{
|
||||
"id": "海报ID,long型",
|
||||
"enterpriseId": "企业ID,long型",
|
||||
"enterpriseName": "企业名称,字符串",
|
||||
"positionId": "岗位ID,long型",
|
||||
"positionName": "岗位名称,字符串",
|
||||
"posterPath": "海报文件路径,字符串",
|
||||
"posterType": "海报类型(1企业海报 2岗位海报),字符",
|
||||
"createBy": "创建者,long型",
|
||||
"createTime": "创建时间,日期时间",
|
||||
"updateBy": "更新者,long型",
|
||||
"updateTime": "更新时间,日期时间"
|
||||
}
|
||||
```
|
||||
|
||||
## 2. 接口定义
|
||||
|
||||
### 2.1 企业信息管理接口
|
||||
|
||||
#### 2.1.1 获取企业列表
|
||||
|
||||
- **接口URL**:`/zsjy/enterprise/list`
|
||||
- **请求方式**:`GET`
|
||||
- **接口权限**:`zsjy:enterprise:list`
|
||||
- **请求参数**:
|
||||
|
||||
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | 备注 |
|
||||
|----------------|----------|----------|----------|----------|-------------------------|
|
||||
| pageNum | 页码 | query | 是 | int | 默认为1 |
|
||||
| pageSize | 每页数量 | query | 是 | int | 默认为10 |
|
||||
| enterpriseName | 企业名称 | query | 否 | string | 模糊匹配 |
|
||||
| industry | 所属行业 | query | 否 | string | 精确匹配,来自数据字典 |
|
||||
| status | 状态 | query | 否 | string | 0正常 1停用 |
|
||||
|
||||
- **响应参数**:
|
||||
|
||||
```json
|
||||
{
|
||||
"total": "总记录数",
|
||||
"rows": "企业列表数据,数组类型,每个元素为EnterpriseVO对象",
|
||||
"code": "状态码,200表示成功",
|
||||
"msg": "消息提示"
|
||||
}
|
||||
```
|
||||
|
||||
#### 2.1.2 获取企业详情
|
||||
|
||||
- **接口URL**:`/zsjy/enterprise/{id}`
|
||||
- **请求方式**:`GET`
|
||||
- **接口权限**:`zsjy:enterprise:query`
|
||||
- **请求参数**:
|
||||
|
||||
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | 备注 |
|
||||
|----------|----------|----------|----------|----------|------------|
|
||||
| id | 企业ID | path | 是 | long | 路径变量 |
|
||||
|
||||
- **响应参数**:
|
||||
|
||||
```json
|
||||
{
|
||||
"code": "状态码,200表示成功",
|
||||
"data": "企业详情数据,EnterpriseVO对象",
|
||||
"msg": "消息提示"
|
||||
}
|
||||
```
|
||||
|
||||
#### 2.1.3 新增企业信息
|
||||
|
||||
- **接口URL**:`/zsjy/enterprise`
|
||||
- **请求方式**:`POST`
|
||||
- **接口权限**:`zsjy:enterprise:add`
|
||||
- **请求参数**:EnterpriseVO对象(不含id、createBy、createTime、updateBy、updateTime字段)
|
||||
- **响应参数**:
|
||||
|
||||
```json
|
||||
{
|
||||
"code": "状态码,200表示成功",
|
||||
"msg": "消息提示"
|
||||
}
|
||||
```
|
||||
|
||||
#### 2.1.4 修改企业信息
|
||||
|
||||
- **接口URL**:`/zsjy/enterprise`
|
||||
- **请求方式**:`PUT`
|
||||
- **接口权限**:`zsjy:enterprise:edit`
|
||||
- **请求参数**:EnterpriseVO对象(必须包含id字段)
|
||||
- **响应参数**:
|
||||
|
||||
```json
|
||||
{
|
||||
"code": "状态码,200表示成功",
|
||||
"msg": "消息提示"
|
||||
}
|
||||
```
|
||||
|
||||
#### 2.1.5 删除企业信息
|
||||
|
||||
- **接口URL**:`/zsjy/enterprise/{ids}`
|
||||
- **请求方式**:`DELETE`
|
||||
- **接口权限**:`zsjy:enterprise:remove`
|
||||
- **请求参数**:
|
||||
|
||||
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | 备注 |
|
||||
|----------|-----------------------------|----------|----------|----------|-----------------------|
|
||||
| ids | 企业ID,多个以逗号分隔 | path | 是 | string | 例如:1 或 1,2,3 |
|
||||
|
||||
- **响应参数**:
|
||||
|
||||
```json
|
||||
{
|
||||
"code": "状态码,200表示成功",
|
||||
"msg": "消息提示"
|
||||
}
|
||||
```
|
||||
|
||||
### 2.2 招聘岗位管理接口
|
||||
|
||||
#### 2.2.1 获取岗位列表
|
||||
|
||||
- **接口URL**:`/zsjy/position/list`
|
||||
- **请求方式**:`GET`
|
||||
- **接口权限**:`zsjy:position:list`
|
||||
- **请求参数**:
|
||||
|
||||
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | 备注 |
|
||||
|--------------|--------------|----------|----------|----------|-------------------------|
|
||||
| pageNum | 页码 | query | 是 | int | 默认为1 |
|
||||
| pageSize | 每页数量 | query | 是 | int | 默认为10 |
|
||||
| enterpriseId | 企业ID | query | 否 | long | 精确匹配 |
|
||||
| positionName | 岗位名称 | query | 否 | string | 模糊匹配 |
|
||||
| status | 状态 | query | 否 | string | 0正常 1停用 |
|
||||
|
||||
- **响应参数**:
|
||||
|
||||
```json
|
||||
{
|
||||
"total": "总记录数",
|
||||
"rows": "岗位列表数据,数组类型,每个元素为JobPositionVO对象",
|
||||
"code": "状态码,200表示成功",
|
||||
"msg": "消息提示"
|
||||
}
|
||||
```
|
||||
|
||||
#### 2.2.2 获取岗位详情
|
||||
|
||||
- **接口URL**:`/zsjy/position/{id}`
|
||||
- **请求方式**:`GET`
|
||||
- **接口权限**:`zsjy:position:query`
|
||||
- **请求参数**:
|
||||
|
||||
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | 备注 |
|
||||
|----------|----------|----------|----------|----------|------------|
|
||||
| id | 岗位ID | path | 是 | long | 路径变量 |
|
||||
|
||||
- **响应参数**:
|
||||
|
||||
```json
|
||||
{
|
||||
"code": "状态码,200表示成功",
|
||||
"data": "岗位详情数据,JobPositionVO对象",
|
||||
"msg": "消息提示"
|
||||
}
|
||||
```
|
||||
|
||||
#### 2.2.3 新增招聘岗位
|
||||
|
||||
- **接口URL**:`/zsjy/position`
|
||||
- **请求方式**:`POST`
|
||||
- **接口权限**:`zsjy:position:add`
|
||||
- **请求参数**:JobPositionVO对象(不含id、createBy、createTime、updateBy、updateTime字段)
|
||||
- **响应参数**:
|
||||
|
||||
```json
|
||||
{
|
||||
"code": "状态码,200表示成功",
|
||||
"msg": "消息提示"
|
||||
}
|
||||
```
|
||||
|
||||
#### 2.2.4 修改招聘岗位
|
||||
|
||||
- **接口URL**:`/zsjy/position`
|
||||
- **请求方式**:`PUT`
|
||||
- **接口权限**:`zsjy:position:edit`
|
||||
- **请求参数**:JobPositionVO对象(必须包含id字段)
|
||||
- **响应参数**:
|
||||
|
||||
```json
|
||||
{
|
||||
"code": "状态码,200表示成功",
|
||||
"msg": "消息提示"
|
||||
}
|
||||
```
|
||||
|
||||
#### 2.2.5 删除招聘岗位
|
||||
|
||||
- **接口URL**:`/zsjy/position/{ids}`
|
||||
- **请求方式**:`DELETE`
|
||||
- **接口权限**:`zsjy:position:remove`
|
||||
- **请求参数**:
|
||||
|
||||
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | 备注 |
|
||||
|----------|-----------------------------|----------|----------|----------|-----------------------|
|
||||
| ids | 岗位ID,多个以逗号分隔 | path | 是 | string | 例如:1 或 1,2,3 |
|
||||
|
||||
- **响应参数**:
|
||||
|
||||
```json
|
||||
{
|
||||
"code": "状态码,200表示成功",
|
||||
"msg": "消息提示"
|
||||
}
|
||||
```
|
||||
|
||||
#### 2.2.6 获取企业下的岗位列表
|
||||
|
||||
- **接口URL**:`/zsjy/position/enterprise/{enterpriseId}`
|
||||
- **请求方式**:`GET`
|
||||
- **接口权限**:`zsjy:position:list`
|
||||
- **请求参数**:
|
||||
|
||||
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | 备注 |
|
||||
|--------------|--------------|----------|----------|----------|-------------------------|
|
||||
| enterpriseId | 企业ID | path | 是 | long | 路径变量 |
|
||||
|
||||
- **响应参数**:
|
||||
|
||||
```json
|
||||
{
|
||||
"code": "状态码,200表示成功",
|
||||
"data": "岗位列表数据,数组类型,每个元素为JobPositionVO对象",
|
||||
"msg": "消息提示"
|
||||
}
|
||||
```
|
||||
|
||||
### 2.3 招聘海报管理接口
|
||||
|
||||
#### 2.3.1 生成企业招聘海报
|
||||
|
||||
- **接口URL**:`/zsjy/poster/enterprise/{enterpriseId}`
|
||||
- **请求方式**:`POST`
|
||||
- **接口权限**:`zsjy:poster:generate`
|
||||
- **请求参数**:
|
||||
|
||||
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | 备注 |
|
||||
|--------------|----------|----------|----------|----------|------------|
|
||||
| enterpriseId | 企业ID | path | 是 | long | 路径变量 |
|
||||
|
||||
- **响应参数**:
|
||||
|
||||
```json
|
||||
{
|
||||
"code": "状态码,200表示成功",
|
||||
"code": 200,
|
||||
"msg": "操作成功",
|
||||
"data": {
|
||||
"posterPath": "生成的海报文件路径",
|
||||
"posterId": "海报记录ID"
|
||||
},
|
||||
"msg": "消息提示"
|
||||
"id": 1,
|
||||
"enterpriseName": "杭州某某科技有限公司",
|
||||
"industry": "01",
|
||||
"enterpriseIntro": "公司成立于2010年...",
|
||||
"contactName": "张三",
|
||||
"contactPhone": "13800138000",
|
||||
"officePhone": "0571-88888888",
|
||||
"email": "hr@example.com",
|
||||
"website": "https://www.example.com",
|
||||
"address": "浙江省杭州市xxx路xxx号",
|
||||
"status": "0",
|
||||
"jobList": [
|
||||
{
|
||||
"id": 1,
|
||||
"enterpriseId": 1,
|
||||
"positionName": "前端开发工程师",
|
||||
"requirements": "1. 熟练掌握Vue3\n2. 熟悉TypeScript",
|
||||
"benefits": "薪资范围:8000-15000元/月\n提供五险一金",
|
||||
"status": "0"
|
||||
},
|
||||
{
|
||||
"id": 2,
|
||||
"enterpriseId": 1,
|
||||
"positionName": "后端开发工程师",
|
||||
"requirements": "1. 熟练掌握Java\n2. 熟悉Spring Boot",
|
||||
"benefits": "薪资范围:10000-20000元/月",
|
||||
"status": "0"
|
||||
}
|
||||
]
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
#### 2.3.2 生成岗位招聘海报
|
||||
---
|
||||
|
||||
- **接口URL**:`/zsjy/poster/position/{positionId}`
|
||||
- **请求方式**:`POST`
|
||||
- **接口权限**:`zsjy:poster:generate`
|
||||
- **请求参数**:
|
||||
### 2.3 新增企业信息
|
||||
|
||||
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | 备注 |
|
||||
|------------|----------|----------|----------|----------|------------|
|
||||
| positionId | 岗位ID | path | 是 | long | 路径变量 |
|
||||
**接口地址**:`POST /zsjy/enterprise`
|
||||
|
||||
- **响应参数**:
|
||||
**权限标识**:`zsjy:enterprise:add`
|
||||
|
||||
**请求体**:
|
||||
|
||||
```json
|
||||
{
|
||||
"code": "状态码,200表示成功",
|
||||
"enterpriseName": "杭州某某科技有限公司",
|
||||
"industry": "01",
|
||||
"enterpriseIntro": "公司成立于2010年,专注于软件开发...",
|
||||
"contactName": "张三",
|
||||
"contactPhone": "13800138000",
|
||||
"officePhone": "0571-88888888",
|
||||
"email": "hr@example.com",
|
||||
"website": "https://www.example.com",
|
||||
"address": "浙江省杭州市西湖区xxx路xxx号",
|
||||
"enterpriseScale": "01",
|
||||
"status": "0",
|
||||
"jobList": [
|
||||
{
|
||||
"positionName": "前端开发工程师",
|
||||
"requirements": "1. 熟练掌握Vue3\n2. 熟悉TypeScript",
|
||||
"benefits": "薪资范围:8000-15000元/月\n提供五险一金",
|
||||
"status": "0"
|
||||
},
|
||||
{
|
||||
"positionName": "后端开发工程师",
|
||||
"requirements": "1. 熟练掌握Java\n2. 熟悉Spring Boot",
|
||||
"benefits": "薪资范围:10000-20000元/月",
|
||||
"status": "0"
|
||||
}
|
||||
]
|
||||
}
|
||||
```
|
||||
|
||||
**响应示例**:
|
||||
|
||||
```json
|
||||
{
|
||||
"code": 200,
|
||||
"msg": "操作成功"
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 2.4 修改企业信息
|
||||
|
||||
**接口地址**:`PUT /zsjy/enterprise`
|
||||
|
||||
**权限标识**:`zsjy:enterprise:edit`
|
||||
|
||||
**说明**:编辑企业信息时,会先删除该企业下所有旧岗位,再批量插入新岗位列表。
|
||||
|
||||
**请求体**:同 2.3 新增
|
||||
|
||||
---
|
||||
|
||||
### 2.5 删除企业信息
|
||||
|
||||
**接口地址**:`DELETE /zsjy/enterprise/{ids}`
|
||||
|
||||
**权限标识**:`zsjy:enterprise:remove`
|
||||
|
||||
**路径参数**:
|
||||
|
||||
| 参数名 | 类型 | 必填 | 说明 |
|
||||
|--------|------|------|------|
|
||||
| ids | Long[] | 是 | 企业ID数组 |
|
||||
|
||||
**说明**:删除企业时会同时删除关联的岗位信息。
|
||||
|
||||
---
|
||||
|
||||
### 2.6 导出企业信息
|
||||
|
||||
**接口地址**:`POST /zsjy/enterprise/export`
|
||||
|
||||
**权限标识**:`zsjy:enterprise:export`
|
||||
|
||||
**请求参数**:同列表查询参数(用于条件导出)
|
||||
|
||||
**响应**:Excel文件流下载
|
||||
|
||||
---
|
||||
|
||||
### 2.7 下载导入模板
|
||||
|
||||
**接口地址**:`GET /zsjy/enterprise/importTemplate`
|
||||
|
||||
**权限标识**:无需权限
|
||||
|
||||
**响应**:Excel模板文件流下载,文件名:`enterprise_import_template.xlsx`
|
||||
|
||||
---
|
||||
|
||||
### 2.8 导入企业信息
|
||||
|
||||
**接口地址**:`POST /zsjy/enterprise/importData`
|
||||
|
||||
**权限标识**:`zsjy:enterprise:import`
|
||||
|
||||
**请求方式**:`multipart/form-data`
|
||||
|
||||
**表单参数**:
|
||||
|
||||
| 参数名 | 类型 | 必填 | 说明 |
|
||||
|--------|------|------|------|
|
||||
| file | File | 是 | Excel文件(.xlsx/.xls) |
|
||||
| updateSupport | Boolean | 否 | 是否支持更新(同名覆盖,默认false) |
|
||||
|
||||
**响应示例**:
|
||||
|
||||
```json
|
||||
{
|
||||
"code": 200,
|
||||
"msg": "恭喜您,数据已全部导入成功!共 5 条,数据如下:<br/>1、企业 xxx 导入成功"
|
||||
}
|
||||
```
|
||||
|
||||
**导入规则**:
|
||||
- 企业名称唯一,重复时根据 `updateSupport` 决定是跳过还是覆盖
|
||||
- 岗位按模板列顺序解析,岗位名称非空则创建一条岗位记录
|
||||
|
||||
---
|
||||
|
||||
### 2.9 生成招聘简章PDF(单个)
|
||||
|
||||
**接口地址**:`POST /zsjy/enterprise/brochure/{enterpriseId}`
|
||||
|
||||
**权限标识**:`zsjy:enterprise:brochure`
|
||||
|
||||
**路径参数**:
|
||||
|
||||
| 参数名 | 类型 | 必填 | 说明 |
|
||||
|--------|------|------|------|
|
||||
| enterpriseId | Long | 是 | 企业ID |
|
||||
|
||||
**响应示例**:
|
||||
|
||||
```json
|
||||
{
|
||||
"code": 200,
|
||||
"msg": "操作成功",
|
||||
"data": {
|
||||
"posterPath": "生成的海报文件路径",
|
||||
"posterId": "海报记录ID"
|
||||
},
|
||||
"msg": "消息提示"
|
||||
"id": 1,
|
||||
"enterpriseId": 1,
|
||||
"enterpriseName": "杭州某某科技有限公司",
|
||||
"brochurePath": "/app/uploadPath/enterprise-brochure/2026/03/30/xxx.pdf",
|
||||
"fileName": "杭州某某科技有限公司_1743300000000.pdf",
|
||||
"fileSize": 102400,
|
||||
"generateBy": 1,
|
||||
"generateByName": "admin",
|
||||
"generateTime": "2026-03-30 10:00:00"
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
#### 2.3.3 获取海报列表
|
||||
|
||||
- **接口URL**:`/zsjy/poster/list`
|
||||
- **请求方式**:`GET`
|
||||
- **接口权限**:`zsjy:poster:list`
|
||||
- **请求参数**:
|
||||
|
||||
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | 备注 |
|
||||
|--------------|--------------|----------|----------|----------|-----------------------------|
|
||||
| pageNum | 页码 | query | 是 | int | 默认为1 |
|
||||
| pageSize | 每页数量 | query | 是 | int | 默认为10 |
|
||||
| enterpriseId | 企业ID | query | 否 | long | 精确匹配 |
|
||||
| posterType | 海报类型 | query | 否 | string | 1企业海报 2岗位海报 |
|
||||
|
||||
- **响应参数**:
|
||||
**错误示例**(无岗位时):
|
||||
|
||||
```json
|
||||
{
|
||||
"total": "总记录数",
|
||||
"rows": "海报列表数据,数组类型,每个元素为RecruitmentPosterVO对象",
|
||||
"code": "状态码,200表示成功",
|
||||
"msg": "消息提示"
|
||||
"code": 500,
|
||||
"msg": "该企业下没有招聘岗位,无法生成简章"
|
||||
}
|
||||
```
|
||||
|
||||
#### 2.3.4 导出海报为图片
|
||||
---
|
||||
|
||||
- **接口URL**:`/zsjy/poster/export/image/{id}`
|
||||
- **请求方式**:`GET`
|
||||
- **接口权限**:`zsjy:poster:export`
|
||||
- **请求参数**:
|
||||
### 2.10 批量生成招聘简章PDF
|
||||
|
||||
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | 备注 |
|
||||
|----------|----------|----------|----------|----------|------------|
|
||||
| id | 海报ID | path | 是 | long | 路径变量 |
|
||||
**接口地址**:`POST /zsjy/enterprise/brochure/batch/{enterpriseIds}`
|
||||
|
||||
- **响应参数**:图片文件流
|
||||
**权限标识**:`zsjy:enterprise:brochure`
|
||||
|
||||
#### 2.3.5 导出海报为PDF
|
||||
**路径参数**:
|
||||
|
||||
- **接口URL**:`/zsjy/poster/export/pdf/{id}`
|
||||
- **请求方式**:`GET`
|
||||
- **接口权限**:`zsjy:poster:export`
|
||||
- **请求参数**:
|
||||
| 参数名 | 类型 | 必填 | 说明 |
|
||||
|--------|------|------|------|
|
||||
| enterpriseIds | String | 是 | 企业ID列表,逗号分隔,如:`1,2,3` |
|
||||
|
||||
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | 备注 |
|
||||
|----------|----------|----------|----------|----------|------------|
|
||||
| id | 海报ID | path | 是 | long | 路径变量 |
|
||||
**响应示例**:
|
||||
|
||||
- **响应参数**:PDF文件流
|
||||
```json
|
||||
{
|
||||
"code": 200,
|
||||
"msg": "操作成功",
|
||||
"data": [
|
||||
{
|
||||
"id": 1,
|
||||
"enterpriseId": 1,
|
||||
"enterpriseName": "杭州某某科技有限公司",
|
||||
"fileName": "杭州某某科技有限公司_xxx.pdf",
|
||||
"generateTime": "2026-03-30 10:00:00"
|
||||
}
|
||||
]
|
||||
}
|
||||
```
|
||||
|
||||
## 3. 数据字典
|
||||
---
|
||||
|
||||
### 3.1 企业规模 (zsjy_enterprise_scale)
|
||||
### 2.11 获取最新简章信息
|
||||
|
||||
| 字典值 | 字典名称 | 备注 |
|
||||
|--------|------------|------------|
|
||||
| 1-49 | 1-49人 | 小型企业 |
|
||||
| 50-99 | 50-99人 | |
|
||||
| 100-499| 100-499人 | 中型企业 |
|
||||
| 500-999| 500-999人 | |
|
||||
| 1000-4999| 1000-4999人 | 大型企业 |
|
||||
| 5000+ | 5000人以上 | 特大型企业 |
|
||||
**接口地址**:`GET /zsjy/enterprise/brochure/{enterpriseId}`
|
||||
|
||||
### 3.2 企业行业 (zsjy_enterprise_industry)
|
||||
**权限标识**:`zsjy:enterprise:query`
|
||||
|
||||
| 字典值 | 字典名称 |
|
||||
|--------|---------------------|
|
||||
| IT | 互联网/IT/电子/通信 |
|
||||
| FINANCE| 金融/银行/保险 |
|
||||
| EDUCATION | 教育/培训/科研 |
|
||||
| ESTATE | 房地产/建筑 |
|
||||
| MEDICAL| 医疗/健康 |
|
||||
| TRADE | 贸易/零售/物流 |
|
||||
| MANUFACTURING | 制造业 |
|
||||
| MEDIA | 文化/媒体/娱乐 |
|
||||
| ENERGY | 能源/环保 |
|
||||
| GOVERNMENT | 政府/非营利组织 |
|
||||
| OTHER | 其他行业 |
|
||||
**路径参数**:
|
||||
|
||||
### 3.3 岗位有效期类型 (zsjy_position_validity_type)
|
||||
| 参数名 | 类型 | 必填 | 说明 |
|
||||
|--------|------|------|------|
|
||||
| enterpriseId | Long | 是 | 企业ID |
|
||||
|
||||
| 字典值 | 字典名称 | 备注 |
|
||||
|--------|----------|----------------|
|
||||
| 1 | 永久有效 | 岗位永久有效 |
|
||||
| 0 | 日期区间 | 设置开始和结束日期|
|
||||
**响应示例**:同 2.9
|
||||
|
||||
## 4. 错误码
|
||||
---
|
||||
|
||||
| 错误码 | 描述 | 备注 |
|
||||
|--------|------------------------|----------------------------|
|
||||
| 200 | 操作成功 | |
|
||||
| 500 | 系统内部错误 | |
|
||||
| 401 | 未授权,请重新登录 | |
|
||||
| 403 | 权限不足,禁止访问 | |
|
||||
| 50001 | 企业信息不存在 | 查询或操作不存在的企业时 |
|
||||
| 50002 | 岗位信息不存在 | 查询或操作不存在的岗位时 |
|
||||
| 50003 | 海报生成失败 | 生成海报时发生错误 |
|
||||
| 50004 | 导出失败 | 导出海报为图片或PDF时失败 |
|
||||
| 50005 | 该企业下存在岗位,不能删除 | 删除有关联岗位的企业时 |
|
||||
### 2.12 下载招聘简章PDF(通过企业ID)
|
||||
|
||||
**接口地址**:`GET /zsjy/enterprise/brochure/download/{enterpriseId}`
|
||||
|
||||
**权限标识**:`zsjy:enterprise:brochure`
|
||||
|
||||
**路径参数**:
|
||||
|
||||
| 参数名 | 类型 | 必填 | 说明 |
|
||||
|--------|------|------|------|
|
||||
| enterpriseId | Long | 是 | 企业ID |
|
||||
|
||||
**响应**:PDF文件流,Content-Type: `application/pdf`
|
||||
|
||||
**文件名**:`招聘简章_{企业名称}.pdf`
|
||||
|
||||
---
|
||||
|
||||
### 2.13 下载招聘简章PDF(通过记录ID)
|
||||
|
||||
**接口地址**:`GET /zsjy/enterprise/brochure/downloadById/{id}`
|
||||
|
||||
**权限标识**:`zsjy:enterprise:brochure`
|
||||
|
||||
**路径参数**:
|
||||
|
||||
| 参数名 | 类型 | 必填 | 说明 |
|
||||
|--------|------|------|------|
|
||||
| id | Long | 是 | 简章记录ID |
|
||||
|
||||
**响应**:PDF文件流
|
||||
|
||||
---
|
||||
|
||||
## 3. 招聘简章PDF版式说明
|
||||
|
||||
生成的招聘简章PDF每家企业一份,结构如下:
|
||||
|
||||
```
|
||||
┌─────────────────────────────────────────┐
|
||||
│ 企业名称(大标题) │ ← 蓝色背景标题区
|
||||
└─────────────────────────────────────────┘
|
||||
|
||||
┌─────────────────────────────────────────┐
|
||||
│ 企业简介 │ ← 企业简介区块
|
||||
│ 公司成立于2010年,专注于软件开发... │
|
||||
└─────────────────────────────────────────┘
|
||||
|
||||
┌─────────────────────────────────────────┐
|
||||
│ 联系人 | 联系电话 | 办公电话 | 电子邮箱 │ ← 联系信息表格
|
||||
│ 企业地址:xxx路xxx号 │
|
||||
└─────────────────────────────────────────┘
|
||||
|
||||
┌─────────────────────────────────────────┐
|
||||
│ 招聘岗位 │ ← 岗位标题
|
||||
└─────────────────────────────────────────┘
|
||||
|
||||
┌─────────────────────────────────────────┐
|
||||
│ 岗位1名称 │ ← 岗位1
|
||||
│ 岗位要求:... │
|
||||
│ 待遇:... │
|
||||
└─────────────────────────────────────────┘
|
||||
|
||||
┌─────────────────────────────────────────┐
|
||||
│ 岗位2名称 │ ← 岗位2
|
||||
│ 岗位要求:... │
|
||||
│ 待遇:... │
|
||||
└─────────────────────────────────────────┘
|
||||
|
||||
... 更多岗位 ...
|
||||
|
||||
┌─────────────────────────────────────────┐
|
||||
│ 联系人: 张三 | 电话: 13800138000 │ ← 页脚联系信息
|
||||
│ 邮箱: hr@example.com | 地址: xxx │
|
||||
└─────────────────────────────────────────┘
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 4. 权限标识清单
|
||||
|
||||
| 权限标识 | 说明 |
|
||||
|---------|------|
|
||||
| zsjy:enterprise:list | 列表查询 |
|
||||
| zsjy:enterprise:query | 查看详情 |
|
||||
| zsjy:enterprise:add | 新增 |
|
||||
| zsjy:enterprise:edit | 修改(含岗位增删) |
|
||||
| zsjy:enterprise:remove | 删除 |
|
||||
| zsjy:enterprise:export | 导出 |
|
||||
| zsjy:enterprise:import | 导入 |
|
||||
| zsjy:enterprise:brochure | 生成简章 / 下载 |
|
||||
|
||||
---
|
||||
|
||||
## 5. 数据库表结构
|
||||
|
||||
| 表名 | 说明 |
|
||||
|------|------|
|
||||
| zsjy_enterprise | 企业信息表(改造:新增enterprise_intro、office_phone、website字段) |
|
||||
| zsjy_enterprise_job | 企业招聘岗位表(新建) |
|
||||
| zsjy_enterprise_brochure | 简章生成记录表(新建) |
|
||||
|
||||
---
|
||||
|
||||
## 6. 变更记录
|
||||
|
||||
| 日期 | 版本 | 变更内容 |
|
||||
|------|------|----------|
|
||||
| 2023-07-05 | v1.0 | 初始版本(企业基本信息CRUD) |
|
||||
| 2026-03-30 | v2.0 | 重大改造:新增岗位子表、招聘简章PDF生成、Excel导入功能 |
|
||||
Reference in new issue
Block a user