docs: document batch collection tasks for issue 45
QiuSW
@@ -21,7 +21,7 @@ GET /api/admin/v1/pdd-products/{productId}
|
||||
|
||||
新增请求只提交 `requestId` 和 `url`。服务端规范化 URL、提取 `goods_id`；无法提取时返回 `PDD_GOODS_ID_INVALID`，已存在时返回 `PDD_PRODUCT_EXISTS` 和现有商品 ID。编辑请求完整提交 URL、标题、店铺、数字销量/评价、状态和 `specs`；人工保存覆盖当前值，但不改变已有任务快照。
|
||||
|
||||
`specs` 是维度数组。维度包含非空 `name`、`role`（`color` / `size` / `other`）和非空 `values`；规格值包含 `name`、`selectable`，只有颜色值允许包含非负整数分 `priceCent`。列表支持 `keyword` 搜索 goods_id、标题或店铺，并支持 `status` 筛选。商品状态为 `pending`、`active`、`disabled`。
|
||||
`specs` 是维度数组。维度包含非空 `name`、`role`（`color` / `size` / `other`）和非空 `values`；规格值包含 `name`、`selectable`，只有颜色值允许包含非负整数分 `priceCent`。列表支持 `keyword` 搜索 goods_id、标题或店铺，并支持 `status` 筛选。商品状态为 `pending`、`active`、`disabled`。列表项另返回 `collectionSelectable`、可选的 `collectionDisabledReason` 和 `activeCollectionTaskId`，供当前页批量选择；服务端提交时仍必须重新校验。
|
||||
|
||||
Android 提交结果的契约不增加字段：服务端在保存任务结果的同一事务更新 PDD 商品最新档案。`completed` 全量覆盖，`completed_partial` 合并明确获得的数据，`failed` 不更新；人工 `disabled` 状态不会被采集自动改回 `active`。
|
||||
|
||||
@@ -106,6 +106,7 @@ Android 的 `pddProductDetailV1` 采集器执行以下固定流程：
|
||||
|
||||
```http
|
||||
POST /api/admin/v1/collection-tasks
|
||||
POST /api/admin/v1/collection-tasks/batch
|
||||
GET /api/admin/v1/collection-tasks
|
||||
GET /api/admin/v1/collection-tasks/{taskId}
|
||||
POST /api/admin/v1/collection-tasks/{taskId}/reset
|
||||
@@ -125,6 +126,21 @@ DELETE /api/admin/v1/collection-tasks/{taskId}
|
||||
|
||||
服务端在事务中复制当前 `url`、`goods_id` 和完整规则内容到任务。同一商品已有 `pending` 或 `running` 任务时返回 `PDD_PRODUCT_TASK_ACTIVE`。
|
||||
|
||||
批量创建请求：
|
||||
|
||||
```json
|
||||
{
|
||||
"requestId": "batch-uuid",
|
||||
"pddProductIds": [1, 2, 3],
|
||||
"ruleId": 2,
|
||||
"deviceId": null
|
||||
}
|
||||
```
|
||||
|
||||
`pddProductIds` 必须包含 1～100 个不重复的有效 ID。一个批次统一使用当前规则和可选设备；每个商品独立调用单任务创建事务并固化自己的 URL、goods_id、规则和设备快照。批次 `requestId` 与商品 ID 派生稳定的逐项创建标识，同一请求重放返回原任务，不重复创建。
|
||||
|
||||
HTTP 200 响应返回 `successCount`、`failureCount` 和按请求顺序排列的 `items`。成功项包含 `pddProductId`、`success: true`、`taskId` 和可选 `replayed`；失败项包含 `success: false`、稳定 `code` 和普通人可理解的 `message`。商品已停用返回 `PDD_PRODUCT_DISABLED`，活动任务冲突返回 `PDD_PRODUCT_TASK_ACTIVE`。逐项失败不回滚其它成功项；请求 JSON、批次 UUID、重复商品或数量上限无效时整体返回 `INVALID_REQUEST`。
|
||||
|
||||
重置只允许 `completed`、`completed_partial` 或 `failed`：
|
||||
|
||||
- 保留 `pddProductId`、`deviceId`、`urlSnapshot`、`goodsIdSnapshot`、`ruleId` 和 `ruleSnapshot`。
|
||||
|
||||
@@ -2,7 +2,7 @@
|
||||
|
||||
## 当前范围
|
||||
|
||||
当前已实施范围包含 PDD 商品最新档案、规则、采集任务、Android 执行和结构化结果。顺云宝、Shopee、采购、批量任务、规则发布流程、全局停机和实时屏幕仍由独立工单推进。
|
||||
当前已实施范围包含 PDD 商品最新档案、规则、单个及批量采集任务、Android 执行和结构化结果。顺云宝、Shopee、采购、规则发布流程、全局停机和实时屏幕仍由独立工单推进。
|
||||
|
||||
## PDD 商品
|
||||
|
||||
@@ -42,6 +42,12 @@
|
||||
- `completed`、`completed_partial`、`failed` 可以重置；`running` 禁止重置和删除。
|
||||
- 重置保留原 URL、goods_id、规则和设备快照，在一个事务中删除旧规格/SKU、清空结果和错误，并恢复为 `pending`。
|
||||
- 任务自身结果仍只在任务详情查看；任务完成后会按完整/部分完成规则更新 PDD 商品最新档案，商品页不替代任务结果审计。
|
||||
- PDD 商品列表批量操作只选择当前页，最多 100 个商品；每个商品仍创建一个独立采集任务。
|
||||
- 已停用、没有可用采集规则或已有 `pending/running` 任务的商品不能勾选，并显示普通人可理解的原因。
|
||||
- 一批商品统一选择一个规则和一个可选设备；设备留空时仍由空闲设备领取。服务端提交时逐商品重新校验。
|
||||
- 批量创建按商品分别执行现有单任务事务，允许部分成功；失败项返回稳定错误码和可读原因，不回滚已成功任务。
|
||||
- 批次 `requestId` 为每个商品派生稳定的创建请求标识，同一批次重放不会重复创建任务。
|
||||
- 批量采集不创建采购任务、PDD 订单或支付动作。
|
||||
|
||||
## 采集字段
|
||||
|
||||
|
||||
+2
-2
@@ -39,7 +39,7 @@
|
||||
|
||||
## 后续商品与采购设计工单
|
||||
|
||||
以下工单保持商品域与采购域解耦。#31 PDD 商品原型已确认并进入代码待验收；#32 采购原型及采购实施继续遵守各自门禁，不得把采购能力混入 #31。
|
||||
以下工单保持商品域与采购域解耦。#31 PDD 商品档案已验收；#45 批量采集入口已实施并等待验收。#32 采购原型及采购实施继续遵守各自门禁，不得把采购能力混入采集功能。
|
||||
|
||||
| 顺序 | 工单 | 交付项 | 主要依赖 / 门禁 |
|
||||
|---|---|---|---|
|
||||
@@ -55,7 +55,7 @@
|
||||
| T38 | [#40](https://git.ilapage.cn/OPC/goauto/issues/40) | Shopee 商品档案、PDD 关联与规格映射 | #31；商品域独立于采购任务 |
|
||||
| T39 | [#41](https://git.ilapage.cn/OPC/goauto/issues/41) | SYB 货运单商品导入与 Shopee 信息提取 | #40；源数据域独立于采购任务 |
|
||||
| T40 | [#42](https://git.ilapage.cn/OPC/goauto/issues/42) | Android 采购演练规则与持久执行基线 | #33、#34；只演练，不改地址、不创建订单 |
|
||||
| T43 | [#45](https://git.ilapage.cn/OPC/goauto/issues/45) | Admin PDD 商品列表多选与批量采集任务创建 | #31 已验收；下一张采集域工单 |
|
||||
| T43 | [#45](https://git.ilapage.cn/OPC/goauto/issues/45) | Admin PDD 商品列表多选与批量采集任务创建 | 已实施，等待用户验收 |
|
||||
|
||||
推荐依赖顺序：#31、#40、#41 完成商品域 → #33、#34 建立采购契约和服务端状态机 → #42 完成不下单演练 → #35 管理端人工处理 → #36 高风险真实订单动作 → #37、#38 物流闭环 → #39 真机总验收。
|
||||
|
||||
|
||||
+1
-1
@@ -58,4 +58,4 @@
|
||||
|
||||
当前采集 MVP 的 T01～T22 和 T24 已完成实现并由用户验收；T08 只读实时屏幕已延期。T23、T25～T28 的一加真机增强、假售罄恢复、浏览器重开恢复和端口配置已经实现，其中部分工单仍等待用户验收。T24 的规格遍历已在一加和三星真机复核；三星未识别评价数量的问题由用户确认暂不处理。
|
||||
|
||||
#31 PDD 商品档案原型、数据库、API、Admin 页面和采集结果写回已于 2026-08-17 通过用户验收；#45 是下一张采集域工单，独立实现 PDD 商品列表多选和批量创建采集任务。#32 采购闭环原型及后续采购工单仍按各自门禁推进。采购永不支付，真实地址修改和创建订单属于必须再次人工确认的高风险范围。
|
||||
#31 PDD 商品档案原型、数据库、API、Admin 页面和采集结果写回已于 2026-08-17 通过用户验收；#45 已按确认原型实现 PDD 商品列表当前页多选、禁用原因、批量确认、逐商品幂等创建和部分失败结果，当前等待用户验收。#32 采购闭环原型及后续采购工单仍按各自门禁推进。采购永不支付，真实地址修改和创建订单属于必须再次人工确认的高风险范围。
|
||||
|
||||
Reference in New Issue
Block a user