Admin：采集采购列表展示 PDD 店铺和客户端名称 #158

New Issue

2026-08-11T15:43:44+08:00

ila commented

2026-08-11 15:43:44 +08:00

基本信息

类型：需求
父级大工单：#14
所属 MVP / 版本：#15 / Admin 六模块统一列表体验
阶段：采集采购任务可读性
状态：待验收

要解决什么

采集采购列表目前没有展示 PDD 店铺；“客户端”列直接显示 tasks.assigned_client 客户端 ID。采购员难以快速核对采购来源店铺，也难以用人工设置的客户端名称判断由哪台设备执行。

做什么 / 不做什么

做：采集采购列表在“目标”后增加“PDD 店铺”列，采集和采购任务统一从当前未删除的 pdd_products.shop_name 展示；缺失时显示 —。
做：客户端列优先显示当前 clients.name；名称为空或客户端记录不存在时回退显示稳定客户端 ID；未分配继续显示 —。
做：长店铺名和客户端名称省略显示并通过 title 查看全文；任务详情同步显示 PDD 店铺、客户端名称和客户端 ID。
不做：不把店铺或客户端名称冗余写入 tasks；不增加店铺筛选；不改变任务创建、领取、状态、分页统计、Client 接口或数据库结构。

怎么做

admin/repository/task.go：任务列表已有 pdd_products 关联，在查询中补取 p.shop_name；增加 clients 左连接获取名称。新增详情展示上下文查询，统一返回 PDD 店铺和客户端名称，关联缺失时保留任务中的客户端 ID。
admin/service/task.go：列表视图增加 PDD 店铺、客户端名称和客户端 ID；集中处理 — 与名称回退规则。详情视图增加 PDD 店铺、客户端名称和客户端 ID。
admin/templates/task/list.html：在目标后增加 PDD 店铺列；店铺和客户端单元格使用截断样式及 title，同步修正空状态列数。
admin/templates/task/detail_modal.html：分别显示客户端名称、客户端 ID 和 PDD 店铺，避免名称重复时无法确认设备。
补充 repository/service/template 回归测试并更新 docs/admin/05-ui-specification.md。

验收标准

采集任务和采购任务均按 pdd_goods_id 显示当前 PDD 店铺，缺失显示 —。
已分配任务优先显示客户端名称；名称缺失或客户端已删除时回退客户端 ID；未分配显示 —。
列表长文本不会撑破表格，可通过 title 查看完整店铺和客户端名称。
任务详情分别显示 PDD 店铺、客户端名称和客户端 ID。
客户端重命名后页面显示新名称，但任务仍以原客户端 ID 关联；重复名称可在详情中用 ID 区分。
任务筛选、分页、统计、权限和删除行为保持不变。
不修改数据库结构和 Admin/Client 接口。
Go 1.23.0 的 build、test、vet 通过。

怎么验证

从 admin/ 执行：

$env:GOTOOLCHAIN="go1.23.0"
go test ./... -count=1
go build ./...
go vet ./...
Remove-Item Env:GOTOOLCHAIN

浏览器人工验证：准备有店铺/无店铺、客户端有名称/名称为空/记录已删除/未分配的任务，核对列表和详情；在 1366×768 下确认表格横向滚动且长文本不破坏布局。

风险和回退

风险：客户端名称可重复或变更；详情始终保留稳定客户端 ID，列表关联失败时回退 ID。
风险：PDD 商品软删除或尚未采集时无法取得店铺；明确显示 —，不从任务结果 JSON 猜测。
回退：撤销查询字段、视图字段和模板列即可，不涉及迁移或业务数据回滚。

实施记录

状态：待验收
实现提交：df1287f feat: 展示任务PDD店铺和客户端名称 (#158)
归档提交：2f18501 docs: 归档任务 #158
归档文档：docs/task/158-admin任务展示pdd店铺和客户端名称.md
实际实现与建单方案一致：名称只做当前档案关联展示，任务仍保留稳定 ID；没有数据库和接口变更。

测试结果

Go 1.23.0 针对性 service/repository/template 测试：通过。
Go 1.23.0 go build ./...：通过。
Go 1.23.0 go test ./... -count=1：通过。
Go 1.23.0 go vet ./...：通过。
已覆盖客户端改名后显示当前名称，以及 PDD 商品/客户端关联缺失时的占位和 ID 回退。
未验证：真实浏览器 1366×768 下特别长店铺名和客户端名称的视觉效果；模板测试已覆盖截断、完整 title 和列数。

## 基本信息 - 类型：需求 - 父级大工单：#14 - 所属 MVP / 版本：#15 / Admin 六模块统一列表体验 - 阶段：采集采购任务可读性 - 状态：待验收 ## 要解决什么采集采购列表目前没有展示 PDD 店铺；“客户端”列直接显示 `tasks.assigned_client` 客户端 ID。采购员难以快速核对采购来源店铺，也难以用人工设置的客户端名称判断由哪台设备执行。 ## 做什么 / 不做什么 - 做：采集采购列表在“目标”后增加“PDD 店铺”列，采集和采购任务统一从当前未删除的 `pdd_products.shop_name` 展示；缺失时显示 `—`。 - 做：客户端列优先显示当前 `clients.name`；名称为空或客户端记录不存在时回退显示稳定客户端 ID；未分配继续显示 `—`。 - 做：长店铺名和客户端名称省略显示并通过 `title` 查看全文；任务详情同步显示 PDD 店铺、客户端名称和客户端 ID。 - 不做：不把店铺或客户端名称冗余写入 `tasks`；不增加店铺筛选；不改变任务创建、领取、状态、分页统计、Client 接口或数据库结构。 ## 怎么做 - `admin/repository/task.go`：任务列表已有 `pdd_products` 关联，在查询中补取 `p.shop_name`；增加 `clients` 左连接获取名称。新增详情展示上下文查询，统一返回 PDD 店铺和客户端名称，关联缺失时保留任务中的客户端 ID。 - `admin/service/task.go`：列表视图增加 PDD 店铺、客户端名称和客户端 ID；集中处理 `—` 与名称回退规则。详情视图增加 PDD 店铺、客户端名称和客户端 ID。 - `admin/templates/task/list.html`：在目标后增加 PDD 店铺列；店铺和客户端单元格使用截断样式及 `title`，同步修正空状态列数。 - `admin/templates/task/detail_modal.html`：分别显示客户端名称、客户端 ID 和 PDD 店铺，避免名称重复时无法确认设备。 - 补充 repository/service/template 回归测试并更新 `docs/admin/05-ui-specification.md`。 ## 验收标准 - [x] 采集任务和采购任务均按 `pdd_goods_id` 显示当前 PDD 店铺，缺失显示 `—`。 - [x] 已分配任务优先显示客户端名称；名称缺失或客户端已删除时回退客户端 ID；未分配显示 `—`。 - [x] 列表长文本不会撑破表格，可通过 `title` 查看完整店铺和客户端名称。 - [x] 任务详情分别显示 PDD 店铺、客户端名称和客户端 ID。 - [x] 客户端重命名后页面显示新名称，但任务仍以原客户端 ID 关联；重复名称可在详情中用 ID 区分。 - [x] 任务筛选、分页、统计、权限和删除行为保持不变。 - [x] 不修改数据库结构和 Admin/Client 接口。 - [x] Go 1.23.0 的 build、test、vet 通过。 ## 怎么验证从 `admin/` 执行： ```powershell $env:GOTOOLCHAIN="go1.23.0" go test ./... -count=1 go build ./... go vet ./... Remove-Item Env:GOTOOLCHAIN ``` 浏览器人工验证：准备有店铺/无店铺、客户端有名称/名称为空/记录已删除/未分配的任务，核对列表和详情；在 1366×768 下确认表格横向滚动且长文本不破坏布局。 ## 风险和回退 - 风险：客户端名称可重复或变更；详情始终保留稳定客户端 ID，列表关联失败时回退 ID。 - 风险：PDD 商品软删除或尚未采集时无法取得店铺；明确显示 `—`，不从任务结果 JSON 猜测。 - 回退：撤销查询字段、视图字段和模板列即可，不涉及迁移或业务数据回滚。 ## 实施记录 - 状态：待验收 - 实现提交：`df1287f` `feat: 展示任务PDD店铺和客户端名称 (#158)` - 归档提交：`2f18501` `docs: 归档任务 #158` - 归档文档：`docs/task/158-admin任务展示pdd店铺和客户端名称.md` - 实际实现与建单方案一致：名称只做当前档案关联展示，任务仍保留稳定 ID；没有数据库和接口变更。 ## 测试结果 - Go 1.23.0 针对性 service/repository/template 测试：通过。 - Go 1.23.0 `go build ./...`：通过。 - Go 1.23.0 `go test ./... -count=1`：通过。 - Go 1.23.0 `go vet ./...`：通过。 - 已覆盖客户端改名后显示当前名称，以及 PDD 商品/客户端关联缺失时的占位和 ID 回退。 - 未验证：真实浏览器 1366×768 下特别长店铺名和客户端名称的视觉效果；模板测试已覆盖截断、完整 title 和列数。

ila referenced this issue

2026-08-11 15:43:57 +08:00

[Epic] Admin 采集采购管理端 #14

ila referenced this issue

2026-08-11 15:43:59 +08:00

[MVP] Admin 四模块可用闭环 #15

ila commented

2026-08-12 10:32:14 +08:00