feat: 增加任务批量勾选和重新上报 (#89)
This commit is contained in:
@@ -9,7 +9,7 @@
|
||||
## 1. 设计目标
|
||||
|
||||
- 让操作人员在一个页面完成任务监控、搜索和异常定位。
|
||||
- “获取任务”和“重新执行”会产生外部后果;后者当前只允许重新采集,不允许采购。
|
||||
- “获取任务”“重新执行”和“重新上报”会产生外部后果;重新执行只允许单条采集任务,重新上报只重发既有结果 Outbox。
|
||||
- 长任务状态始终可找到,不使用连续模态弹窗打断工作。
|
||||
- 任务表格在数据增长后仍保持响应速度、稳定选择和可访问性。
|
||||
- 界面只展示任务状态,不在 Qt 主线程执行 Admin 或手机自动化。
|
||||
@@ -35,7 +35,7 @@
|
||||
```text
|
||||
┌─────────────────────────────────────────────────────────────┐
|
||||
│ PDD 任务 │
|
||||
│ [开始自动获取] [类型▼] [状态▼] [关键词...] [搜索] [刷新] [重新执行] │
|
||||
│ [开始自动获取] [类型▼] [状态▼] [关键词...] [搜索] [刷新] [已选0条] [重新执行] [重新上报] │
|
||||
├─────────────────────────────────────────────────────────────┤
|
||||
│ 类型 │ 商品标题 │ 颜色 │ 尺码 │ 价格 │ 数量 │ 状态 │ 更新时间 │详情│
|
||||
│ │
|
||||
@@ -83,10 +83,11 @@
|
||||
|
||||
筛选条件之间采用 AND。点击搜索或在关键词输入框按 Enter 执行本地数据库查询,不请求领取任务。活动筛选必须可见,筛选无结果时保留条件并提供清除入口。
|
||||
|
||||
### 4.3 刷新与重新执行
|
||||
### 4.3 刷新、重新执行与重新上报
|
||||
|
||||
- “刷新”只重新读取本地任务列表,不请求 Admin,也不操作手机。
|
||||
- “重新执行”位于刷新右侧;没有选中任务时禁用。
|
||||
- “刷新”紧邻“搜索”右侧,只重新读取本地任务列表,不请求 Admin,也不操作手机。
|
||||
- 页面右侧显示“已选 N 条”,“重新执行”后面是“重新上报”。
|
||||
- “重新执行”只在恰好勾选一条任务时启用;多选不允许批量操作手机。
|
||||
- 点击后先校验任务,再显示明确的“重新采集”确认弹窗。弹窗显示任务编号、商品标题,并说明新结果会覆盖 Client 和 Admin 的当前采集数据。“暂不重新采集”是默认聚焦的安全操作,点击该按钮、按 `Escape` 或关闭弹窗都不得启动任务。
|
||||
- 用户确认后,工作线程必须先检查已保存 Android 设备的实际连接状态,再重置任务和创建执行记录。检查失败时保留原任务状态、采集结果和执行历史。
|
||||
- 允许重新采集已经结束或处于“等待重试”的采集任务。采购、执行中、结果待提交、仍有未发送 Outbox 或自动获取忙碌时必须阻止,并用中文说明原因。
|
||||
@@ -98,6 +99,11 @@
|
||||
- 采购任务始终不能通过“重新执行”入口启动;需要处理时由自动获取的安全恢复流程决定。
|
||||
- “等待重试”当前没有倒计时。自动获取因可恢复采集错误停止时,底部状态显示
|
||||
“重试已暂停”,并提示选择任务点击“重新执行”或重新启动获取任务。
|
||||
- “重新上报”作用于当前已经加载并勾选的任务。执行前显示任务数量,并明确说明不会重新采集、采购或操作手机。
|
||||
- 重新上报只查找每条任务最新的 `collect_result` 或 `purchase_result` Outbox,使用原来的 `idempotency_key` 和 `payload_json`;不重新组装数据、不创建新 Outbox,也不发送 `task_failure`。
|
||||
- 重新上报不依赖 Android 设备,在独立工作线程中逐条提交。自动获取、重新执行或另一批上报运行时不得启动。
|
||||
- 批量完成后显示成功、失败和跳过数量。成功任务取消勾选;失败及没有结果 Outbox 的跳过任务保留勾选,方便继续处理。
|
||||
- 相同幂等键和相同内容只用于让 Admin 再次确认已接收,不代表创建新结果或覆盖 Admin 数据。
|
||||
|
||||
## 5. 任务表格
|
||||
|
||||
@@ -109,6 +115,7 @@
|
||||
|
||||
| 列 | 对齐 | 显示规则 |
|
||||
|---|---|---|
|
||||
| 选择 | 居中 | 行首复选框;占位空行不可勾选,身份使用 `remote_task_id` |
|
||||
| 任务类型 | 居中 | “采集”或“采购”,颜色只作辅助 |
|
||||
| 商品标题 | 左对齐、可伸展 | 空值显示“尚未获取标题”,截断时提供完整工具提示 |
|
||||
| 颜色 | 左对齐 | 无值显示 `—` |
|
||||
@@ -123,6 +130,8 @@
|
||||
|
||||
- 默认排序为 `updated_at DESC, id DESC`。
|
||||
- 排序、筛选和数据变化后以稳定任务编号恢复当前行。
|
||||
- 当前行和勾选集相互独立;点击复选框不打开详情,也不启动任何业务操作。
|
||||
- 勾选集使用 `remote_task_id` 保存。普通刷新保留仍存在的勾选,搜索条件变化清空勾选,避免操作被筛选隐藏的旧任务。
|
||||
- 初始加载有限批次,滚动时通过 `canFetchMore/fetchMore` 增量加载后续任务。
|
||||
- 单击非交互区域只设置当前行和选择。
|
||||
- 双击行、按 Enter 或点击“详情”执行相同的非破坏性详情命令。
|
||||
@@ -362,7 +371,7 @@ self.show_recoverable_error(
|
||||
|
||||
## 10. 键盘与无障碍
|
||||
|
||||
- Tab 顺序:自动获取 → 类型 → 状态 → 关键词 → 搜索 → 刷新 → 重新执行 → 表格 → 状态区可操作项。
|
||||
- Tab 顺序:自动获取 → 类型 → 状态 → 关键词 → 搜索 → 刷新 → 重新执行 → 重新上报 → 表格 → 状态区可操作项。
|
||||
- `Ctrl+F` 聚焦关键词,Enter 打开当前行详情。不绑定 `F5`——界面上没有需要刷新的远端数据。
|
||||
- 仅图标按钮必须设置准确的无障碍名称和工具提示。
|
||||
- 表单具有可见标签,占位符不能替代标签。
|
||||
|
||||
Reference in New Issue
Block a user