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