cmautobuy/docs/task/19-admin-采集采购页.md

19 Admin 采集采购页，采集与采购统一展示

• 类型：需求（界面）
• 父级大工单：#14
• 所属 MVP / 版本：#15 / MVP
• 关联：#18（缺陷暴露于该工单交付后）
• 状态：验收通过
• 日期：2026-08-07
• Gitea 工单：#19

背景与目标

tasks 是一张表，用 task_type 区分采集和采购。但原来的「采购任务」页 是骨架——var rows []gin.H 从不查库，页面永远为空；TODO 写的还是 只查 task_type = 'purchase'。

所以 #18 建出来的采集任务在界面上哪儿都看不到。用户实际遇到的场景： 在 PDD 商品页勾选商品、点「创建采集任务」，然后采购任务页什么都没有。 查证时库里确实有 2 条 collect 任务，assigned_client 为 NULL、状态 pending。

collect_status 只能告诉你「这个商品采到没有」，看不出任务本身怎么了： 被谁领走了、什么时候领的、失败在哪一步。

最终方案

模块名「采集采购」

用户指定。直接点出这一页装的是哪两类任务，比泛称「任务」更能让操作员 一眼知道点进去看什么。

路由 /tasks 和 objectName 不变——改路由会让已有书签和文档里的 链接全失效，而这一项没有任何收益。

列不按类型并列，用「目标」概括

两种任务的业务字段完全不同：采购有订单号、颜色尺码、数量、价格上限， 采集只有 PDD 链接。并列会让采集任务行一半是空列。

☐ │ COL-8020a8729f111c15 │ 采集 │ PDD 737116531267                │ 待分配 │ —
☐ │ PUR-001              │ 采购 │ SO-001 · M/黑色 · 2件 · ≤¥42.00 │ 待分配 │ —

目标列所需字段全在 tasks 表上，不需要 join。采集任务 join pdd_products 取标题作为增强，join 不到或商品已软删除时退回显示 pdd_goods_id。

[必须] 拼接逻辑在 service 层组装成一个字符串，模板只负责显示。 散在模板里没人维护得住。

统计与列表共用同一个筛选条件

[必须] 统计跟随当前筛选。分开写两条 SQL 的话，总有一天会忘了给统计 也加条件，数字和表格对不上，操作员会以为页面坏了。

实现把筛选条件的拼装抽成共用函数，两边必然一致。

无主任务显示 —

#17 之后采集任务默认无主（assigned_client IS NULL），这一列会大量为空。 [必须] 显示 —，不是空白也不是 <nil>。

详情弹窗只读

采购专有字段（数量、价格上限、目标规格）在采集任务的弹窗里整段不出现， 不显示空行。改派、重试、取消是后续工单，本工单不做。

复用 #18 的弹窗机制（data-detail-url 那套服务端渲染片段）—— 该机制本来就是通用的，app.js 无需改动。

与建单方案的差异

1. 模块名从「任务」改成「采集采购」（工单实施前已按用户要求修改工单正文并记录理由）。
2. 删掉了初版加的 HasAnyTasks / CountAllTasks 查询。 无筛选且结果为空， 按定义就等价于「从来没有过任务」，多一次查询是冗余。IsFiltered 一个字段 就能驱动两种空状态文案。
3. app.js 未改动，虽然在工单的预计文件表里。#18 的弹窗机制是通用的。
4. 增加 IsWarn（failed / manual_review 行标黄），与 PDD 页已有约定一致。 工单未要求，属于视觉一致性。
5. 额外更新了模块计数（见下）。

改了哪些

• admin/repository/task.go：TaskFilter / TaskListRow / ListTasks / CountTasksByStatus（与列表共用筛选拼装）/ DeleteTasks。
• admin/service/task.go：新建。类型与状态文案、目标列组装、 ListTasksView / StatusLine / GetTaskDetail / DeleteTasks。
• admin/service/task_test.go：新建，25 个用例。
• admin/handler/web/others.go：TaskList / TaskDetail / TaskDelete 真实实现。
• admin/handler/web/web.go：GET /tasks/detail 路由。
• admin/templates/task/list.html：重写。
• admin/templates/task/detail_modal.html：新建。
• admin/templates/partials/header.html：导航改「采集采购」。
• admin/static/css/app.css：折叠结果块样式。
• docs/admin/01-requirements.md §4 / §4.4、05-ui-specification.md §7：重写。

顺带清理（PDD 页加进来之后一直没跟上的模块计数）：

• admin/main.go 包注释、admin/AGENTS.md、admin/templates/partials/footer.html、 docs/README.md、docs/admin/00-getting-started.md（模块表补上缺失的 PDD 商品那一行）、02-architecture.md、06-quality-security.md。

验收结果

架构角色独立复跑的重点项：

检查	结果
页面同时显示采集和采购	通过
统计跟随筛选	通过（全部「共 2 条」→ 采集「共 1 条」→ 采购「共 1 条」→ 无结果「共 0 条」）
类型筛选 / 状态筛选 / 关键词	通过
目标列：采集显示 PDD 标识，采购显示订单号+规格+数量+价格上限	通过
价格显示 ¥42.00	通过
无主任务客户端列显示 —	通过
采购专有字段在采集弹窗整段隐藏	通过（采集弹窗「数量/价格上限/目标规格」各 0 次；采购弹窗各 1 次）
空状态分两种，筛无结果给「查看全部」入口	通过
导航与页面标题显示「采集采购」	通过
五个页面回归	全部 200
go vet / gofmt / go test	通过

测试

架构角色亲自执行（admin/ 目录）：

go vet ./...              无输出
gofmt -l .                无输出
go test ./... -count=1    ok repository 1.347s / ok service 3.208s

本工单新增 25 个用例。

端到端（curl，非真机）：

建 PDD 商品 → 建采集任务 → 手工插一条 purchase 任务

/tasks
  COL-8020a8729f111c15 | 采集 | PDD 737116531267                | 待分配 | —
  PUR-001              | 采购 | SO-001 · M/黑色 · 2件 · ≤¥42.00 | 待分配 | —
  共 2 条 · 待分配 2 · 待领取 0 · 已领取 0 · 成功 0 · 需人工 0 · 失败 0 · 已取消 0

/tasks?type=collect   → 只剩采集那行，共 1 条
/tasks?type=purchase  → 只剩采购那行，共 1 条
/tasks?type=purchase&status=cancelled
                      → 「当前筛选条件下没有任务。换个类型、状态或关键词再试。查看全部」
                         共 0 条

未验证到的部分：

• 浏览器里的真实交互：双击开弹窗、Esc 关闭、全选联动、删除二次确认， 只验证了服务端产出的 HTML，没有在真实浏览器里点过。
• 深色 / 浅色主题、1366×768、显示缩放下的表现未实测。
• 采购任务目前没有创建入口（属于顺运宝模块，未实现）， 验证用的 purchase 任务是手工插库的。真实创建路径未走过。
• 采购任务目标列的规格顺序按维度名排序（M/黑色），是确定的但与工单 示意图的 黑色/M 顺序不同。pdd_options 是裸 map 没有顺序信息， 按键名排序是合理兜底。

审查过程

打回两次，两次都是架构角色的检查指令给窄了，不是实现能力问题。

第一次： 模块名改了，但模块枚举没跟上——admin/main.go 包注释仍写 「采购任务」且漏了 PDD 商品；docs/admin/00-getting-started.md 的模块表 少了一整行 PDD 商品且写着「四个模块」（实现改了这张表的一行， 没注意到表本身已过期）。

第二次： 第一次打回时给的检查命令是 grep -rn "四个模块"， 但过期说法还有「四个页面」这个变体，实现照做无误，是命令太窄。 第二次不再给 grep 模式，直接列出 6 处确切行号，并明确点出 哪两处的「四个」是对的、不许改（pdd/list.html:5 的「和另外四个页面保持一致」、 以及归档文档——归档是历史记录，一律不改）。

按 CLAUDE.md §7.4，同一类问题打回两次就该怀疑要求本身。 第二次改成给确切清单而不是让实现去猜模式，一轮解决。

其中 docs/admin/06-quality-security.md 第 60、153 行最要紧： 它们是验证清单，写着「跑一遍四个页面断言 200」，照着做的人 只会测四个，PDD 页永远不在回归范围里。

遗留问题

1. 改派任务（01 §4.3 原有的 [建议] 项）顺延到后续工单。
2. 重试 / 取消任务未做。
3. 采购任务的创建入口属于顺运宝模块，尚未实现。
4. 浏览器实机交互和主题 / 缩放需人工过一遍。

相关提交

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