feat: 改为移动端用户一键签到

docs/app-outdoor-fair-h5-api.md

@@ -1,4 +1,4 @@
-# 户外招聘会企业 H5 公共接口
+# 户外招聘会公共接口
 
 基础路径：`/app/outdoor-fair`
 
@@ -42,9 +42,25 @@
 
 **请求路径：** `/{fairId}`
 
-返回 `fair` 和 `fairH5Url`。
+返回 `fair`、参会企业 `companies` 和 `fairH5Url`。登录用户对应的 `fair.checkedIn` 表示当前用户是否已在本场招聘会签到。
 
-## 4. 后台参会企业二维码入口
+## 4. 移动端用户一键签到
+
+**请求方式：** `POST`
+
+**请求路径：** `/check-in`
+
+**请求头：** 需要移动端登录态 `Authorization`。
+
+**请求参数：**
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| fairId | Long | 是 | 招聘会 ID |
+
+接口从当前登录用户读取姓名、手机号和地址，签到记录关联 `app_user.user_id`，不再接受前端传入的姓名和手机号。招聘会开始后，同一用户在同一场招聘会只能签到一次。
+
+## 5. 后台参会企业二维码入口
 
 后台接口 `GET /cms/outdoor-fair/{fairId}/companies` 的每行企业现在额外返回：
 
@@ -57,7 +73,7 @@
 
 也可以调用 `GET /cms/outdoor-fair/{fairId}/companies/{companyId}/qrcode` 单独获取某个参会企业的二维码内容。
 
-## 5. 已提供的静态 H5
+## 6. 已提供的静态 H5
 
 | 页面 | 说明 |
 | --- | --- |