|
|
|
@@ -9,7 +9,7 @@
|
|
|
|
|
## 1. 设计目标
|
|
|
|
|
|
|
|
|
|
- 让操作人员在一个页面完成任务监控、搜索和异常定位。
|
|
|
|
|
- “获取任务”“重新执行”和“重新上报”会产生外部后果；重新执行只允许单条采集任务，重新上报只重发既有 Outbox，并优先处理未发送事件。“删除”只软隐藏本地记录。
|
|
|
|
|
- “获取任务”“重新采集”“重新采购”和“重新上报”会产生外部后果；重新上报只重发既有 Outbox，并优先处理未发送事件。“删除”只软隐藏本地记录。
|
|
|
|
|
- 长任务状态始终可找到，不使用连续模态弹窗打断工作。
|
|
|
|
|
- 任务表格在数据增长后仍保持响应速度、稳定选择和可访问性。
|
|
|
|
|
- 界面只展示任务状态，不在 Qt 主线程执行 Admin 或手机自动化。
|
|
|
|
@@ -35,7 +35,7 @@
|
|
|
|
|
```text
|
|
|
|
|
┌─────────────────────────────────────────────────────────────┐
|
|
|
|
|
│ PDD 任务 │
|
|
|
|
|
│ [自动获取] [类型▼] [状态▼] [关键词...] [搜索] [刷新] [全选] [反选] [已选0条] [重新执行] [重新上报] [删除] │
|
|
|
|
|
│ [自动获取] [类型▼] [状态▼] [关键词...] [搜索] [刷新] [全选] [反选] [已选0条] [重新上报] [重新采集] [重新采购] [删除] │
|
|
|
|
|
├─────────────────────────────────────────────────────────────┤
|
|
|
|
|
│ 选择 │ 类型 │ 商品标题 │ 颜色 │ 尺码 │ 价格 │ 数量 │ 状态 │ 更新时间 │
|
|
|
|
|
│ │
|
|
|
|
@@ -86,19 +86,18 @@
|
|
|
|
|
### 4.3 刷新、全选、反选与批量操作
|
|
|
|
|
|
|
|
|
|
- “刷新”紧邻“搜索”右侧，只重新读取本地任务列表，不请求 Admin，也不操作手机。
|
|
|
|
|
- 页面右侧显示“全选”“反选”和“已选 N 条”，之后依次是“重新执行”“重新上报”“删除”。
|
|
|
|
|
- 页面右侧显示“全选”“反选”和“已选 N 条”，之后依次是“重新上报”“重新采集”“重新采购”“删除”。
|
|
|
|
|
- “全选”和“反选”只作用于当前筛选条件下已经加载的真实任务行，空白占位行不参与。全选后新领取或继续增量加载的任务默认不勾选，防止批量操作范围在用户不知情时扩大。
|
|
|
|
|
- 没有真实任务，或正在重新执行、重新上报、删除时，禁用“全选”和“反选”。
|
|
|
|
|
- “重新执行”只在恰好勾选一条任务时启用；多选不允许批量操作手机。
|
|
|
|
|
- 点击后先校验任务，再显示明确的“重新采集”确认弹窗。弹窗显示任务编号、商品标题，并说明新结果会覆盖 Client 和 Admin 的当前采集数据。“暂不重新采集”是默认聚焦的安全操作，点击该按钮、按 `Escape` 或关闭弹窗都不得启动任务。
|
|
|
|
|
- 勾选一条或多条任务后可以点击“重新采集”或“重新采购”。点击后先批量预检，再显示可执行、类型过滤和安全阻止数量；“取消”默认聚焦，点击、按 `Escape` 或关闭弹窗都不得启动任务。
|
|
|
|
|
- 用户确认后，工作线程必须先检查已保存 Android 设备的实际连接状态，再重置任务和创建执行记录。检查失败时保留原任务状态、采集结果和执行历史。
|
|
|
|
|
- 允许重新采集已经结束或处于“等待重试”的采集任务。采购、执行中、结果待提交、仍有未发送 Outbox 或自动获取忙碌时必须阻止，并用中文说明原因。
|
|
|
|
|
- 重新采集只处理采集任务，重新采购只处理采购任务，另一类型计入过滤数量。执行中、结果待提交、仍有未发送 Outbox、已经排队或自动获取忙碌时必须阻止，并用中文说明原因。
|
|
|
|
|
- 确认后只执行选中的稳定任务编号，不领取新任务，不先处理其他任务或 Outbox。
|
|
|
|
|
- 重新采集在工作线程运行。执行期间禁用“获取任务”，“重新执行”变为可点击的“停止重新采集”。
|
|
|
|
|
- 点击停止后按钮显示“正在停止…”并禁用重复点击；底部明确说明正在等待手机当前操作结束。uiautomator2/ADB 的单次调用返回后，采集在下一个安全检查点停止；不得强制结束工作线程。
|
|
|
|
|
- 重新采集的前置校验警告和后台错误 `InfoBar` 都显示在软件窗口顶部水平居中，并有可见的“关闭提示”按钮；提示 5 秒后自动关闭，同一时间只保留一条，新提示替换旧提示。
|
|
|
|
|
- 每次重新采集创建新的执行记录和幂等键；当前结果更新，旧结果保存在历史执行记录中。
|
|
|
|
|
- 采购任务始终不能通过“重新执行”入口启动；需要处理时由自动获取的安全恢复流程决定。
|
|
|
|
|
- 重新采购逐条串行执行。任一任务未形成“执行、核单、上报”成功闭环时立即停止剩余队列。历史上任何一次执行已有 `irreversible_action_at` 的任务永久禁止重新采购，只能只读核单。
|
|
|
|
|
- “等待重试”当前没有倒计时。自动获取因可恢复采集错误停止时，底部状态显示
|
|
|
|
|
“重试已暂停”，并提示选择任务点击“重新执行”或重新启动获取任务。
|
|
|
|
|
- “重新上报”作用于当前已经加载并勾选的任务。执行前显示任务数量，并明确说明不会重新采集、采购或操作手机。
|
|
|
|
@@ -411,7 +410,7 @@ self.show_recoverable_error(
|
|
|
|
|
|
|
|
|
|
## 10. 键盘与无障碍
|
|
|
|
|
|
|
|
|
|
- Tab 顺序：自动获取 → 类型 → 状态 → 关键词 → 搜索 → 刷新 → 全选 → 反选 → 重新执行 → 重新上报 → 删除 → 表格 → 状态区可操作项。
|
|
|
|
|
- Tab 顺序：自动获取 → 类型 → 状态 → 关键词 → 搜索 → 刷新 → 全选 → 反选 → 重新上报 → 重新采集 → 重新采购 → 删除 → 表格 → 状态区可操作项。
|
|
|
|
|
- `Ctrl+F` 聚焦关键词，Enter 打开当前行详情。不绑定 `F5`——界面上没有需要刷新的远端数据。
|
|
|
|
|
- 仅图标按钮必须设置准确的无障碍名称和工具提示。
|
|
|
|
|
- 表单具有可见标签，占位符不能替代标签。
|
|
|
|
|
chengma