67 lines
3.4 KiB
Markdown
67 lines
3.4 KiB
Markdown
# 61 Admin：优化顺运宝同步反馈与记录刷新交互
|
||
|
||
- 类型：需求
|
||
- 父级大工单：#14
|
||
- 所属 MVP / 版本：#15 / MVP
|
||
- 状态：已完成
|
||
- 日期：2026-08-09
|
||
- Gitea 工单：http://ilaer.eicp.net:8418/chengma/cmautobuy/issues/61
|
||
|
||
## 背景与目标
|
||
|
||
顺运宝同步是后台长任务，操作员需要立即知道点击已经生效，并避免重复发起。
|
||
同步记录弹窗此前没有刷新入口，只能手工刷新整个 SYB 页面；弹窗底部的页码和
|
||
翻页组件也需要收敛为统一的右侧操作区。
|
||
|
||
## 最终方案
|
||
|
||
- 同步表单有效提交后，原生 JavaScript 立即把按钮变成禁用的“同步中…”，并设置
|
||
`aria-busy`；页面重新渲染时，当前进程仍在同步也保持相同状态。
|
||
- 服务端同步互斥继续作为最终保护。旧页面或多窗口重复请求时，统一提示“同步
|
||
正在进行，请耐心等待，请勿重复点击”。成功启动只在状态条反馈，不增加需要
|
||
手工关闭的确认弹窗。
|
||
- 同步记录弹窗增加“刷新记录”按钮。点击后按钮显示“刷新中…”并禁用，再通过
|
||
普通 GET 重新加载；URL 保留当前历史页码、订单号、日期范围和 `history=1`，
|
||
因此返回后弹窗自动重开。
|
||
- 刷新、当前页、翻页和关闭控件统一放在弹窗底部右侧，窄宽度时允许换行。
|
||
- 不自动轮询，不增加新 API，不改变同步业务和数据库。
|
||
- 实现与建单方案一致。根据 `ui-ux-pro-max` 的长任务反馈规则，加载状态在点击后
|
||
立即出现，成功反馈不阻塞操作，重复操作仍由服务端保护。
|
||
|
||
## 改了哪些
|
||
|
||
- `admin/handler/web/others.go`：传递当前同步状态、统一重复提交提示、生成记录刷新
|
||
URL。
|
||
- `admin/templates/syb/list.html`：增加同步按钮运行态、记录刷新按钮并调整底部顺序。
|
||
- `admin/static/js/app.js`：增加同步提交和记录刷新的即时加载反馈。
|
||
- `admin/static/css/app.css`：记录弹窗底部右对齐并支持换行。
|
||
- `admin/handler/web/others_test.go`、`admin/main_test.go`：覆盖刷新 URL、运行态按钮和
|
||
页面提示。
|
||
- `docs/admin/05-ui-specification.md`：固化长任务反馈和同步记录刷新规则。
|
||
|
||
## 验收结果
|
||
|
||
| 验收标准 | 结果 |
|
||
|---|---|
|
||
| 有效提交后同步按钮立即显示“同步中…”并禁用 | 通过 |
|
||
| 页面检测到同步任务时渲染禁用的“同步中…”按钮 | 通过 |
|
||
| 服务端重复请求提示统一且互斥保护保留 | 通过 |
|
||
| 成功启动不增加需要手工关闭的确认弹窗 | 通过 |
|
||
| 记录刷新按钮有“刷新中…”状态并防重复点击 | 通过 |
|
||
| 刷新保持弹窗、当前历史页码和筛选条件 | 通过 |
|
||
| 弹窗底部操作统一右对齐并允许窄屏换行 | 通过 |
|
||
| 未增加轮询、接口、数据库或同步业务变更 | 通过 |
|
||
|
||
## 测试
|
||
|
||
- 执行的命令：在 `admin/` 目录执行
|
||
`$env:GOTOOLCHAIN="go1.23.0"; go build ./...; go test ./... -count=1; go vet ./...; Remove-Item Env:GOTOOLCHAIN`
|
||
- 结果：构建通过；全部 Go 测试通过；`go vet`、`git diff --check` 和
|
||
`node --check static/js/app.js` 通过。
|
||
- **没验证到的部分**：未使用真实顺运宝运行长任务；未在人工浏览器中确认按钮
|
||
视觉状态和不同窗口宽度下的实际对齐效果。
|
||
|
||
## 相关提交
|
||
|
||
- `3fd863d` 优化顺运宝同步反馈与记录刷新
|