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
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
+67 -13
View File
@@ -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 客户端列表模块