wuzhen update招生就业

This commit is contained in:
“wuzhen” committed 2026-04-02 10:49:59 +08:00
1 parent 7e122d76dd
commit e5c6fd7a24
55 files changed
+3563 -2397

No files matched your search

+2
View File
@@ -73,6 +73,8 @@
## 企业信息管理API
[企业信息管理API](./企业信息管理API.md) - 包含企业基本信息管理、招聘岗位管理(含子表CRUD)、招聘简章PDF生成(单个/批量)、Excel导入功能(支持企业+岗位一体化导入)。
**重大更新(2026-03-30)**:企业信息新增企业简介、办公电话、官网字段;整合岗位管理;新增简章PDF生成和导入功能。
[统计报表API](./统计报表API.md) - 包含各类统计数据查询接口。
+502 -397
View File
@@ -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导入功能 |