feat: 采集采购页，采集与采购统一展示 (#19)
原来的采购任务页是骨架：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
@@ -92,17 +92,18 @@ go run .
|
||||
|
||||
## 4. 你应该看到什么
|
||||
|
||||
左边（或顶部）是四个模块的导航：
|
||||
左边（或顶部）是五个模块的导航：
|
||||
|
||||
| 模块 | 干什么的 |
|
||||
|---|---|
|
||||
| 蝦皮数据 | 导入蝦皮商品报表，填 PDD 链接，发起采集 |
|
||||
| PDD 商品 | 维护拼多多商品档案，发起采集，查看采回来的规格价格。这个页面不依赖蝦皮和顺运宝的任何数据，单独就能跑通"建商品 → 建采集任务 → 领走执行 → 提交结果 → 显示已采集"这条闭环，见 [05 界面规范](05-ui-specification.md) §5 |
|
||||
| 顺运宝数据 | 同步货运单，匹配规格，生成采购任务 |
|
||||
| 采购任务 | 看任务执行到哪一步了 |
|
||||
| 采集采购 | 看采集和采购任务执行到哪一步了 |
|
||||
| 客户端列表 | 看哪些客户端在干活 |
|
||||
|
||||
每个页面都是同一个结构：**上面工具条 / 中间表格 / 下面状态条**。
|
||||
四个页面长得像是故意的，见 [05 界面规范](05-ui-specification.md)。
|
||||
五个页面长得像是故意的，见 [05 界面规范](05-ui-specification.md)。
|
||||
|
||||
## 5. 常见报错
|
||||
|
||||
|
||||
@@ -72,7 +72,7 @@ PDD 商品页 ──────→ PDD 商品表
|
||||
| 1 | 蝦皮数据 | 商品档案、PDD 链接、发起采集 |
|
||||
| 2 | PDD 商品 | PDD 商品档案、发起采集、查看采回来的规格价格 |
|
||||
| 3 | 顺运宝数据 | 货运单、规格匹配、生成采购任务 |
|
||||
| 4 | 采购任务 | 执行进度跟踪 |
|
||||
| 4 | 采集采购 | 采集任务和采购任务的执行进度跟踪 |
|
||||
| 5 | 客户端列表 | 客户端注册与状态 |
|
||||
|
||||
五个模块**统一使用三段式页面布局**：顶部工具条 / 中间带勾选的表格 / 底部状态条。
|
||||
@@ -209,26 +209,80 @@ PDD 商品之所以单独一个模块，是因为它在数据上就是**独立
|
||||
|
||||
**底部状态条：** 最近同步时间、待匹配条数。
|
||||
|
||||
### 4.4 采购任务模块
|
||||
### 4.4 采集采购模块
|
||||
|
||||
**顶部工具条：** 订单号搜索框、搜索按钮、删除按钮。
|
||||
`tasks` 是**一张表**，用 `task_type` 区分采集和采购。这个模块把两种任务
|
||||
放在同一个列表里显示——分开成两个页面的话，采集任务建出来了，
|
||||
操作员却只能盯着 PDD 商品的 `collect_status` 猜任务本身怎么样了
|
||||
（被谁领了、领了多久、失败在哪一步），完全看不出任务这一层的信息。
|
||||
|
||||
`[必须]` 名字是「**采集采购**」，不是「任务」。它直接点出这一页装的是
|
||||
哪两类任务，比泛称「任务」更能让操作员一眼知道点进去看什么。
|
||||
|
||||
`[必须]` 路由 `/tasks` 不变，避免已有的书签和文档链接失效。
|
||||
|
||||
**顶部工具条：**
|
||||
|
||||
```text
|
||||
[类型▾ 全部] [状态▾ 全部] 关键词[____________] [搜索] [删除]
|
||||
```
|
||||
|
||||
- **类型**：全部 / 采集 / 采购。
|
||||
- **状态**：全部 + 7 个状态，见 §6.2。
|
||||
- **关键词**：同时匹配任务编号、订单号、PDD 商品 ID。
|
||||
|
||||
`[必须]` 筛选比搜索更常用：这个页面最常被问的问题是"有没有卡住的任务"，
|
||||
不是"订单 SO-001 怎么样了"，所以类型和状态筛选要放在最前面。
|
||||
|
||||
**中间表格：**
|
||||
|
||||
两种任务的业务字段完全不同——采购有订单号/颜色尺码/数量/价格上限，
|
||||
采集只有 PDD 链接。并列显示的话采集任务行会有一半是空列，
|
||||
所以改成固定列 + 一列「目标」概括业务信息：
|
||||
|
||||
| 列 | 说明 |
|
||||
|---|---|
|
||||
| 勾选 | 支持批量删除 |
|
||||
| 订单号 | |
|
||||
| 商品标题 | |
|
||||
| 颜色 / 尺码 | **PDD 侧**的规格，不是蝦皮的 |
|
||||
| 数量 | |
|
||||
| 价格上限 | 人民币分，见 §7 |
|
||||
| 蝦皮 ID | |
|
||||
| 分配客户端 | 可改派 |
|
||||
| 状态 | 见 §6 |
|
||||
| 更新时间 | |
|
||||
| 任务编号 | `task_id` |
|
||||
| 类型 | 采集 / 采购，文字，不能只靠颜色 |
|
||||
| **目标** | 采集：`PDD <pdd_goods_id>`（能 join 到未删除的商品标题时追加显示）；采购：`<order_no> · <颜色/尺码> · <数量>件 · ≤<价格上限>` |
|
||||
| 状态 | 中文，7 个取值见 §6.2 |
|
||||
| 客户端 | `assigned_client`；**无主任务显示 `—`**（#17 之后采集任务默认无主，这一列会大量为空） |
|
||||
| 更新时间 | 本地时区 |
|
||||
|
||||
**底部状态条：** 各状态的任务条数统计。
|
||||
`[必须]` 目标列所需字段全在 `tasks` 表上（`pdd_goods_id` / `order_no` /
|
||||
`pdd_options` / `quantity` / `max_price_cent`），不需要 join。
|
||||
|
||||
`[建议]` 采集任务的目标 join `pdd_products` 取标题显示更友好，
|
||||
但 join 不到或商品已软删除时必须退回只显示 `pdd_goods_id`，不能空着。
|
||||
|
||||
`[必须]` 目标列的拼接逻辑在 service 层组装成一个字符串，模板只负责显示——
|
||||
散在模板里没人维护得住。
|
||||
|
||||
`[必须]` 价格上限显示成 `¥42.00`，底层是整数分。
|
||||
|
||||
**双击行打开详情弹窗：**
|
||||
|
||||
`[必须]` **只读**。改派 / 重试 / 取消是后续工单的范围，本页不提供入口。
|
||||
|
||||
弹窗显示：类型、状态、分配客户端、领取时间、完成时间；执行参数
|
||||
（PDD 链接，采购任务额外显示目标规格、数量、价格上限）；错误信息
|
||||
（错误码、错误说明，没有错误时不显示这一段）。
|
||||
|
||||
`[必须]` 采购专有字段（数量、价格上限、目标规格）在采集任务的弹窗里
|
||||
**整段隐藏**，不显示空行。
|
||||
|
||||
`[建议]` `result_data`（Client 提交的完整结果）默认折叠，提供展开查看；
|
||||
过长时截断显示。
|
||||
|
||||
**底部状态条：**
|
||||
|
||||
```text
|
||||
共 42 条 · 待分配 3 · 待领取 5 · 已领取 2 · 成功 30 · 需人工 1 · 失败 1 · 已取消 0
|
||||
```
|
||||
|
||||
`[必须]` 统计要**跟随当前筛选**。筛了「采集」就只统计采集任务，
|
||||
否则数字和表格对不上，操作员会以为页面出错。
|
||||
|
||||
### 4.5 客户端列表模块
|
||||
|
||||
|
||||
@@ -55,7 +55,7 @@ admin/
|
||||
├── go.mod
|
||||
├── config/ 端口、路径、超时
|
||||
├── handler/
|
||||
│ ├── web/ 四个模块的页面
|
||||
│ ├── web/ 五个模块的页面
|
||||
│ │ ├── shopee.go
|
||||
│ │ ├── syb.go
|
||||
│ │ ├── task.go
|
||||
@@ -104,8 +104,8 @@ templates/
|
||||
└── statusbar.html 底部状态条
|
||||
```
|
||||
|
||||
`[必须]` 三段式布局做成 `partials/` 里的公共片段，四个模块复用。
|
||||
**不要每个页面复制一份**——改一次样式要改四个地方，必然改漏。
|
||||
`[必须]` 三段式布局做成 `partials/` 里的公共片段，五个模块复用。
|
||||
**不要每个页面复制一份**——改一次样式要改五个地方，必然改漏。
|
||||
|
||||
`[必须]` 模板输出走 `html/template` 的自动转义。
|
||||
**禁止用 `template.HTML` 包裹用户可控的内容**（商品名、订单号都是外部来的）。
|
||||
|
||||
@@ -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. 客户端列表页
|
||||
|
||||
|
||||
@@ -57,7 +57,7 @@
|
||||
### 2.3 页面测试
|
||||
|
||||
- `go vet ./...` 无告警；
|
||||
- 所有模板能正常渲染（起服务跑一遍四个页面，断言 200）；
|
||||
- 所有模板能正常渲染（起服务跑一遍五个页面，断言 200）；
|
||||
- 空数据、少量数据、大量数据三种情况；
|
||||
- 批量删除的二次确认存在；
|
||||
- 校验失败时输入不丢。
|
||||
@@ -150,7 +150,7 @@
|
||||
| 1 | 依赖版本已固定 | `go.mod` / `go.sum` 已提交，`go mod verify` 通过 | 开发者 |
|
||||
| 2 | `go vet ./...` 无告警 | | 开发者 |
|
||||
| 3 | `go test ./...` 全绿 | 不允许有跳过而未说明的用例 | 开发者 |
|
||||
| 4 | 四个页面能正常打开 | 起服务跑一遍 | 开发者 |
|
||||
| 4 | 五个页面能正常打开 | 起服务跑一遍 | 开发者 |
|
||||
| 5 | 样本导入条数正确 | 导入参考样本（需向项目负责人索取，放 `raw_data/`），应得 5195 商品 + 6092 SKU | 开发者 |
|
||||
| 6 | 数据库从上一版本迁移成功 | 拿旧 `admin.db` 副本启动新版本，人工数据不丢 | 开发者 |
|
||||
| 7 | 契约测试通过 | [04 §9 清单](04-client-api.md)逐条 | 开发者 |
|
||||
|
||||
Reference in New Issue
Block a user