|
@@ -1,65 +0,0 @@
|
|
|
-# 乐跑功能改造联调说明（2026-04-30）
|
|
|
|
|
-
|
|
|
|
|
-本文用于前端联调，覆盖本次后端新增的绑定审计、乐跑记录类型/公开 ID、首页弹窗公告接口。
|
|
|
|
|
-
|
|
|
|
|
-## 1) 乐跑记录接口变更
|
|
|
|
|
-
|
|
|
|
|
-- `GET /Lepao/Records`
|
|
|
|
|
- - 新增字段：`public_id`、`run_mode`（`manual` / `auto`）
|
|
|
|
|
- - 不再返回 `id`（用户侧）
|
|
|
|
|
-- `GET /Lepao/GetRecordDetail`
|
|
|
|
|
- - 优先参数：`public_id`
|
|
|
|
|
- - 兼容参数：`id`（仅过渡期）
|
|
|
|
|
- - 返回含 `public_id`、`run_mode`
|
|
|
|
|
-- `GET /Admin/Lepao/Records`
|
|
|
|
|
- - 新增字段：`public_id`、`run_mode`
|
|
|
|
|
-- `GET /Admin/Lepao/GetRecordDetail`
|
|
|
|
|
- - 支持 `public_id`，兼容 `id`
|
|
|
|
|
- - 返回含 `public_id`、`run_mode`
|
|
|
|
|
-
|
|
|
|
|
-## 2) 绑定/解绑审计接口
|
|
|
|
|
-
|
|
|
|
|
-- 用户侧（本人相关）
|
|
|
|
|
- - `GET /Lepao/BindAudit/List`
|
|
|
|
|
- - 参数：`uuid` `session` `pagesize` `current`，可选 `student_num` `queryTime[]`
|
|
|
|
|
- - 说明：工单/管理员等解绑在该接口统一映射为 `系统解绑`
|
|
|
|
|
-- 管理员账号行内查看
|
|
|
|
|
- - `GET /Admin/Lepao/BindAudit/ByAccount`
|
|
|
|
|
- - 参数：`uuid` `session` `student_num` `pagesize` `current`，可选 `queryTime[]`
|
|
|
|
|
-- 管理员全局审计页
|
|
|
|
|
- - `GET /Admin/Lepao/BindAudit/List`
|
|
|
|
|
- - 参数：`uuid` `session` `pagesize` `current`
|
|
|
|
|
- - 可选筛选：`student_num` `owner_uuid` `operator_uuid` `action` `source` `queryTime[]`
|
|
|
|
|
-
|
|
|
|
|
-## 3) 首页弹窗公告接口
|
|
|
|
|
-
|
|
|
|
|
-- 用户侧
|
|
|
|
|
- - `GET /Popup/Unread`
|
|
|
|
|
- - 参数：`uuid` `session`，可选 `limit`
|
|
|
|
|
- - 说明：当公告 `repeat_show=1` 时，即使该用户已读，后续进入站点仍会继续展示
|
|
|
|
|
- - `POST /Popup/MarkRead`
|
|
|
|
|
- - body：`uuid` `session` `popup_id`
|
|
|
|
|
-- 管理员侧
|
|
|
|
|
- - `GET /Admin/Popup/List`（列表）
|
|
|
|
|
- - 参数：`uuid` `session` `pagesize` `current`，可选 `title` `is_active`
|
|
|
|
|
- - `POST /Admin/Popup`（新增）
|
|
|
|
|
- - body：`uuid` `session` `title` `content_html`，可选 `priority` `is_active` `repeat_show` `start_at` `end_at`
|
|
|
|
|
- - `PUT /Admin/Popup`（编辑）
|
|
|
|
|
- - body：`uuid` `session` `id`，其余字段按需提交
|
|
|
|
|
- - `DELETE /Admin/Popup`（删除）
|
|
|
|
|
- - body：`uuid` `session` `id`
|
|
|
|
|
- - `GET /Admin/Popup/ReadList`（已读用户）
|
|
|
|
|
- - 参数：`uuid` `session` `popup_id` `pagesize` `current`，可选 `keyword`
|
|
|
|
|
-
|
|
|
|
|
-## 4) 字段说明
|
|
|
|
|
-
|
|
|
|
|
-- `run_mode`
|
|
|
|
|
- - `manual`：用户单次乐跑触发
|
|
|
|
|
- - `auto`：定时/补跑/队列触发
|
|
|
|
|
-- 审计 `action`
|
|
|
|
|
- - `platform_bind` / `platform_unbind` / `bot_bind` / `bot_unbind`
|
|
|
|
|
-- 审计 `source`
|
|
|
|
|
- - `user_api` / `admin_api` / `service_api` / `mcp_qq` / `mcp_work_order`
|
|
|
|
|
-- 弹窗 `repeat_show`
|
|
|
|
|
- - `1`：连续展示（已读后再次进入仍展示）
|
|
|
|
|
- - `0`：默认逻辑（已读后不再展示）
|
|
|
