# 乐跑功能改造联调说明（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`：默认逻辑（已读后不再展示）