chengma/cmautobuy
2
0
Fork 0
Code Issues 89 Pull Requests Actions Packages Projects Releases Wiki Activity

feat: 采集采购页，采集与采购统一展示 (#19)

Browse Source 
原来的采购任务页是骨架：var rows []gin.H 从不查库，页面永远为空；
TODO 写的还是只查 task_type = 'purchase'。所以 #18 建出来的采集任务
在界面上哪儿都看不到——用户点完「创建采集任务」只能盯着
collect_status 猜。

模块名定为「采集采购」（用户指定），直接点出这页装的是哪两类任务，
比泛称「任务」更能让人一眼知道点进去看什么。路由 /tasks 不变，
改路由会让已有书签和文档链接全失效，没有收益。

列不按类型并列——两种任务字段完全不同，并列会让采集任务行一半是空列。
改成固定列 + 一列「目标」把业务信息概括成一句话：
  采集  PDD 737116531267
  采购  SO-001 · M/黑色 · 2件 · ≤¥42.00
拼接逻辑在 service 层，模板只负责显示。

统计和列表共用同一个筛选条件拼装函数。分开写的话总有一天会忘了
给统计也加条件，数字和表格对不上，操作员会以为页面坏了。

无主任务的客户端列显示「—」。#17 之后采集任务默认无主，这列会大量为空。

详情弹窗只读，采购专有字段（数量、价格上限、目标规格）在采集任务里
整段不出现，不显示空行。复用 #18 的弹窗机制，app.js 无需改动。

顺带清掉 PDD 页加进来之后一直没跟上的模块计数：多处「四个模块/四个页面」
改成五个。其中 06-quality-security.md 那两处是验证清单，
照着做的人只会测四个页面，PDD 页永远不在回归范围里。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
chengma
2026-08-07 15:16:05 +08:00
co-authored by Claude Opus 5
parent c07fe56ac3
commit f0d7da37cf
18 changed files with 1423 additions and 79 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/admin/05-ui-specification.md
+83 -10
View File
@@ -19,7 +19,7 @@
```text
┌────────────────────────────────────────────────────────────┐
│ [导航] 蝦皮数据 │ PDD 商品 │ 顺运宝数据 │ 采购任务 │ 客户端 │
│ [导航] 蝦皮数据 │ PDD 商品 │ 顺运宝数据 │ 采集采购 │ 客户端 │
├────────────────────────────────────────────────────────────┤
│ 顶部工具条：[操作按钮…] [搜索框] [搜索] [删除] │
├────────────────────────────────────────────────────────────┤
@@ -373,20 +373,93 @@ Go 的 map 是无序的，不靠它定顺序的话，同一个商品每次刷新
`[必须]` 创建前弹出确认框，让操作员选**分配给哪个客户端**，并确认价格上限。
价格上限默认从 `pdd_data` 带出，可改，**不允许为空**。
## 7. 采购任务页
## 7. 采集采购页
工具条：`订单号 [____] [搜索] [删除]`
`tasks` 一张表用 `task_type` 区分采集和采购，本页把两种任务放在同一个
列表里显示，靠「目标」一列概括各自不同的业务信息，见
[01 需求](01-requirements.md) §4.4。
表格列：☐ / 订单号 / 商品标题 / 颜色 / 尺码 / 数量 / 价格上限 /
蝦皮ID / **分配客户端** / 状态 / 更新时间
`[必须]` 导航文字和页面标题都是「**采集采购**」，不是「任务」或「采购任务」。
- `[必须]` 颜色尺码显示的是 **PDD 侧**的规格（实际要买的），不是蝦皮的。
### 7.1 工具条
```text
[类型▾ 全部] [状态▾ 全部] 关键词[____________] [搜索] [删除]
```
- **类型**：全部 / 采集 / 采购。
- **状态**：全部 + 7 个状态，见 [01 需求](01-requirements.md) §6.2。
- **关键词**：同时匹配任务编号、订单号、PDD 商品 ID。
### 7.2 表格列
☐ / 任务编号 / 类型 / **目标** / 状态 / 客户端 / 更新时间
```text
☐ │ 任务编号 │ 类型 │ 目标 │ 状态 │ 客户端 │ 更新时间
☐ │ PDD-20260807-01 │ 采集 │ PDD 737116531267 │ 已领取 │ 办公室-01 │ 15:20
☐ │ PDD-20260807-02 │ 采购 │ SO-001 · 黑色/M · 2件 · ≤¥42.00 │ 待领取 │ — │ 15:22
```
- `[必须]` **目标列**：采集显示 `PDD <pdd_goods_id>`（能 join 到未删除商品
的标题时追加显示）；采购显示 `<order_no> · <颜色/尺码> · <数量>件 · ≤<价格上限>`。
拼接逻辑在 service 层组装成一个字符串，模板只负责显示。
- `[必须]` 价格上限显示成 `¥42.00`（分转元），底层存的是整数分。
- `[建议]` 提供"改派"操作，把任务分给别的客户端——
没有心跳，客户端挂了要靠人工改派。
- 状态含义见 [01 需求](01-requirements.md) §6.2。
- `[必须]` **客户端列**：无主任务显示 `—`，不是空白或 `<nil>`——#17 之后
采集任务默认无主，这一列会大量为空。
- `[必须]` 类型和状态都是文字，不能只靠颜色区分。
底部状态条显示各状态的条数统计。
### 7.3 详情弹窗（双击行打开）
`[必须]` **只读**。没有改派 / 重试 / 取消入口，那些是后续工单的范围。
弹窗内容：
```text
┌──────────────────────────────────────────────┐
│ 任务 PDD-20260807-01 │
├──────────────────────────────────────────────┤
│ 类型 采集 │
│ 状态 已领取 │
│ 分配客户端 办公室-01 │
│ 领取时间 2026-08-07 15:20:31 │
│ 完成时间 — │
├──────────────────────────────────────────────┤
│ 执行参数 │
│ PDD 链接 https://mobile.yangkeduo.com/... │
│ 目标规格 黑色 / M （采购任务才有） │
│ 数量 2 （采购任务才有） │
│ 价格上限 ¥42.00 （采购任务才有） │
├──────────────────────────────────────────────┤
│ 错误 │
│ 错误码 PDD_PAGE_TIMEOUT │
│ 错误说明 商品页加载超时 │
├──────────────────────────────────────────────┤
│ [关闭] │
└──────────────────────────────────────────────┘
```
- `[必须]` 采购专有字段（数量、价格上限、目标规格）在采集任务的弹窗里
**整段隐藏**，不显示空行。
- 错误段没有错误码/说明时整段不显示。
- `[建议]` `result_data`（Client 提交的完整结果）默认折叠，展开查看；
过长时截断显示。
### 7.4 删除
`[必须]` 批量删除要二次确认，写明"将删除 N 条，不可恢复"——`tasks` 表
没有软删除列，删了就是真删了。
### 7.5 底部状态条
```text
共 42 条 · 待分配 3 · 待领取 5 · 已领取 2 · 成功 30 · 需人工 1 · 失败 1 · 已取消 0
```
`[必须]` 统计要**跟随当前筛选**：筛了「采集」就只统计采集任务，
筛了某个状态统计也随之变化，否则数字和表格对不上，操作员会以为
页面出错。这一点跟 PDD 商品页不同——那边的统计是全局概览，
不受筛选影响；本页反过来是有意的，见 [01 需求](01-requirements.md) §4.4。
## 8. 客户端列表页