企业报名招聘会
This commit is contained in:
152
docs/app-company-job-fair-signup-api.md
Normal file
152
docs/app-company-job-fair-signup-api.md
Normal file
@@ -0,0 +1,152 @@
|
||||
# 企业报名招聘会接口文档
|
||||
|
||||
## 企业报名招聘会并填写岗位
|
||||
|
||||
**接口地址：** `POST /app/fair/company/signUp`
|
||||
|
||||
**接口说明：** 企业用户报名公共招聘会（PublicJobFair），同时填写参会岗位信息
|
||||
|
||||
**请求头：**
|
||||
```
|
||||
Authorization: Bearer {token}
|
||||
Content-Type: application/json
|
||||
```
|
||||
|
||||
**请求参数（Body JSON）：**
|
||||
|
||||
| 参数名 | 类型 | 必填 | 说明 |
|
||||
|--------|------|------|------|
|
||||
| jobFairId | String | 是 | 招聘会ID |
|
||||
| jobList | Array | 是 | 岗位列表 |
|
||||
|
||||
**岗位对象（jobList中的元素）字段：**
|
||||
|
||||
| 参数名 | 类型 | 必填 | 说明 |
|
||||
|--------|------|------|------|
|
||||
| jobTitle | String | 是 | 职位名称 |
|
||||
| minSalary | Long | 否 | 最小薪资（元） |
|
||||
| maxSalary | Long | 否 | 最大薪资（元） |
|
||||
| education | String | 否 | 学历要求（对应字典education） |
|
||||
| experience | String | 否 | 工作经验要求（对应字典experience） |
|
||||
| vacancies | Long | 否 | 招聘人数 |
|
||||
| jobLocation | String | 否 | 岗位区划 |
|
||||
| jobAddress | String | 否 | 工作地点 |
|
||||
| description | String | 否 | 岗位描述 |
|
||||
| jobCategory | String | 否 | 岗位分类 |
|
||||
| type | String | 否 | 类型（0常规岗位 1就业见习岗位 2实习实训岗位 3社区实践岗位 4零工） |
|
||||
|
||||
**请求示例：**
|
||||
|
||||
```json
|
||||
{
|
||||
"jobFairId": "1",
|
||||
"jobList": [
|
||||
{
|
||||
"jobTitle": "Java开发工程师",
|
||||
"minSalary": 8000,
|
||||
"maxSalary": 15000,
|
||||
"education": "本科",
|
||||
"experience": "1-3年",
|
||||
"vacancies": 5,
|
||||
"jobLocation": "石河子市",
|
||||
"jobAddress": "石河子市北四路",
|
||||
"description": "负责公司核心系统开发",
|
||||
"type": "0"
|
||||
},
|
||||
{
|
||||
"jobTitle": "前端开发工程师",
|
||||
"minSalary": 7000,
|
||||
"maxSalary": 12000,
|
||||
"education": "大专",
|
||||
"experience": "1年以下",
|
||||
"vacancies": 3,
|
||||
"jobAddress": "石河子市北四路",
|
||||
"description": "负责公司前端页面开发",
|
||||
"type": "0"
|
||||
}
|
||||
]
|
||||
}
|
||||
```
|
||||
|
||||
**响应参数：**
|
||||
|
||||
| 参数名 | 类型 | 说明 |
|
||||
|--------|------|------|
|
||||
| code | Number | 状态码，200 表示成功 |
|
||||
| msg | String | 提示信息 |
|
||||
| data | Number | 成功创建的岗位数量 |
|
||||
|
||||
**响应示例（成功）：**
|
||||
|
||||
```json
|
||||
{
|
||||
"code": 200,
|
||||
"msg": "报名成功",
|
||||
"data": 2
|
||||
}
|
||||
```
|
||||
|
||||
**错误响应示例：**
|
||||
|
||||
```json
|
||||
{
|
||||
"code": 500,
|
||||
"msg": "仅企业用户可报名招聘会"
|
||||
}
|
||||
```
|
||||
|
||||
```json
|
||||
{
|
||||
"code": 500,
|
||||
"msg": "您的企业已报名该招聘会，请勿重复报名"
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## cURL 测试示例
|
||||
|
||||
```bash
|
||||
curl -X POST http://localhost:9091/app/fair/company/signUp \
|
||||
-H "Content-Type: application/json" \
|
||||
-H "Authorization: Bearer {your_token}" \
|
||||
-d '{
|
||||
"jobFairId": "1",
|
||||
"jobList": [
|
||||
{
|
||||
"jobTitle": "Java开发工程师",
|
||||
"minSalary": 8000,
|
||||
"maxSalary": 15000,
|
||||
"education": "本科",
|
||||
"experience": "1-3年",
|
||||
"vacancies": 5,
|
||||
"jobAddress": "石河子市北四路",
|
||||
"description": "负责公司核心系统开发"
|
||||
}
|
||||
]
|
||||
}'
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 业务逻辑说明
|
||||
|
||||
1. 校验当前用户是否为企业用户（is_company_user=0）
|
||||
2. 通过用户的 idCard（企业信用代码）查询企业信息
|
||||
3. 检查企业是否已报名该招聘会（查询 public_job_fair_company 表）
|
||||
4. 创建企业-招聘会关联记录（public_job_fair_company 表）
|
||||
5. 批量插入岗位信息（job 表）
|
||||
6. 创建岗位-招聘会关联记录（public_job_fair_job 表）
|
||||
|
||||
## 数据表关系
|
||||
|
||||
```
|
||||
public_job_fair (招聘会主表)
|
||||
│
|
||||
├── public_job_fair_company (企业关联表)
|
||||
│ └── company_id → company 表
|
||||
│
|
||||
└── public_job_fair_job (岗位关联表)
|
||||
├── job_id → job 表
|
||||
└── company_id → company 表
|
||||
```
|
||||
156
docs/app-company-login-register-api.md
Normal file
156
docs/app-company-login-register-api.md
Normal file
@@ -0,0 +1,156 @@
|
||||
# 企业用户登录注册二合一接口文档
|
||||
|
||||
## 接口说明
|
||||
|
||||
**接口地址：** `POST /app/company/loginOrRegister`
|
||||
|
||||
**接口说明：**
|
||||
- 根据手机号查询企业用户，存在则登录，不存在则注册
|
||||
- 登录时只需传手机号和密码
|
||||
- 注册时需额外传企业信用代码和企业名称
|
||||
- 注册时会根据企业信用代码判断企业是否已注册
|
||||
|
||||
---
|
||||
|
||||
## 请求参数（Body JSON）
|
||||
|
||||
| 参数名 | 类型 | 必填 | 说明 |
|
||||
|--------|------|------|------|
|
||||
| username | String | 是 | 手机号码 |
|
||||
| password | String | 是 | 登录密码 |
|
||||
| companyCode | String | 注册时必填 | 企业信用代码（统一社会信用代码） |
|
||||
| companyName | String | 注册时必填 | 企业名称 |
|
||||
|
||||
---
|
||||
|
||||
## 登录场景
|
||||
|
||||
**请求示例：**
|
||||
|
||||
```json
|
||||
{
|
||||
"username": "13800138000",
|
||||
"password": "123456"
|
||||
}
|
||||
```
|
||||
|
||||
**响应示例（登录成功）：**
|
||||
|
||||
```json
|
||||
{
|
||||
"code": 200,
|
||||
"msg": "操作成功",
|
||||
"token": "eyJhbGciOiJIUzUxMiJ9...",
|
||||
"isNewUser": false,
|
||||
"companyCode": "91110000MA00ABCD1X",
|
||||
"companyName": "北京某某科技有限公司"
|
||||
}
|
||||
```
|
||||
|
||||
**错误响应：**
|
||||
|
||||
```json
|
||||
{
|
||||
"code": 500,
|
||||
"msg": "密码错误，请重新输入!"
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 注册场景
|
||||
|
||||
**请求示例：**
|
||||
|
||||
```json
|
||||
{
|
||||
"username": "13800138000",
|
||||
"password": "123456",
|
||||
"companyCode": "91110000MA00ABCD1X",
|
||||
"companyName": "北京某某科技有限公司"
|
||||
}
|
||||
```
|
||||
|
||||
**响应示例（注册成功）：**
|
||||
|
||||
```json
|
||||
{
|
||||
"code": 200,
|
||||
"msg": "注册成功!",
|
||||
"token": "eyJhbGciOiJIUzUxMiJ9...",
|
||||
"isNewUser": true,
|
||||
"companyCode": "91110000MA00ABCD1X",
|
||||
"companyName": "北京某某科技有限公司"
|
||||
}
|
||||
```
|
||||
|
||||
**错误响应（企业已注册）：**
|
||||
|
||||
```json
|
||||
{
|
||||
"code": 500,
|
||||
"msg": "该企业已注册，请联系企业管理员加入组织!"
|
||||
}
|
||||
```
|
||||
|
||||
**错误响应（缺少企业信息）：**
|
||||
|
||||
```json
|
||||
{
|
||||
"code": 500,
|
||||
"msg": "企业信用代码不能为空!"
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 响应参数
|
||||
|
||||
| 参数名 | 类型 | 说明 |
|
||||
|--------|------|------|
|
||||
| code | Number | 状态码，200 表示成功 |
|
||||
| msg | String | 提示信息 |
|
||||
| token | String | 登录令牌 |
|
||||
| isNewUser | Boolean | 是否新用户（true=注册，false=登录） |
|
||||
| companyCode | String | 企业信用代码 |
|
||||
| companyName | String | 企业名称 |
|
||||
|
||||
---
|
||||
|
||||
## cURL 测试示例
|
||||
|
||||
**登录（已注册用户）：**
|
||||
|
||||
```bash
|
||||
curl -X POST http://localhost:8080/app/company/loginOrRegister \
|
||||
-H "Content-Type: application/json" \
|
||||
-d '{"username":"13800138000","password":"123456"}'
|
||||
```
|
||||
|
||||
**注册（新用户）：**
|
||||
|
||||
```bash
|
||||
curl -X POST http://localhost:8080/app/company/loginOrRegister \
|
||||
-H "Content-Type: application/json" \
|
||||
-d '{"username":"13800138000","password":"123456","companyCode":"91110000MA00ABCD1X","companyName":"北京某某科技有限公司"}'
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 业务逻辑流程
|
||||
|
||||
```
|
||||
1. 根据手机号 + is_company_user=0 查询 app_user
|
||||
│
|
||||
├── 用户存在 → 校验密码 → 登录成功（isNewUser=false）
|
||||
│
|
||||
└── 用户不存在 → 检查是否传了 companyCode/companyName
|
||||
│
|
||||
├── 未传 → 返回错误"企业信用代码不能为空!"
|
||||
│
|
||||
└── 已传 → 根据 companyCode 查询 company 表
|
||||
│
|
||||
├── 企业已存在 → 返回错误"该企业已注册，请联系企业管理员加入组织!"
|
||||
│
|
||||
└── 企业不存在 → 创建 company + app_user → 注册成功（isNewUser=true）
|
||||
```
|
||||
Reference in New Issue
Block a user