diff --git a/docs/task/165-修复顺运宝采集任务孤儿状态.md b/docs/task/165-修复顺运宝采集任务孤儿状态.md new file mode 100644 index 0000000..35dd59e --- /dev/null +++ b/docs/task/165-修复顺运宝采集任务孤儿状态.md @@ -0,0 +1,66 @@ +# 165 Admin:修复顺运宝采集中孤儿状态并建立任务来源关联 + +- 类型:缺陷 +- 父级大工单:#14 +- 所属 MVP / 版本:#15 / 当前 Admin 闭环 +- 状态:已完成 +- 日期:2026-08-11 +- Gitea 工单:http://ilaer.eicp.net:8418/chengma/cmautobuy/issues/165 + +## 背景与目标 + +顺运宝订单 `2608100A0SHGN5` 显示“PDD 采集中”,但采集采购模块不存在对应任务。 +生产数据确认 PDD 商品仍为 `collecting`、更新时间已超过 15 分钟,按顺运宝明细、 +订单号和 PDD 商品 ID 均查不到任务。目标是消除删除任务后的孤儿状态,提供明确恢复 +入口,并让从顺运宝创建的采集任务可以按全部来源订单反查。 + +## 最终方案 + +- 新增 MySQL v12 `task_syb_sources` 多对多关联表。顺运宝批量创建仍按 PDD 商品去重, + 但任务与全部来源明细在同一事务写入;历史任务不做不可靠的来源猜测回填。 +- 任务关键字搜索通过来源表匹配顺运宝订单号和明细 ID,列表与状态统计复用同一条件。 +- 删除采集任务前记录相关 PDD 商品;删除后若已无 `pending/assigned/claimed` 采集任务, + 在同一事务把仍为 `collecting` 的商品回收到 `pending`。有其他有效任务时保持不变。 +- 顺运宝上下文同时读取有效采集任务事实。`collecting` 超过 15 分钟、没有有效任务或 + 更新时间损坏时显示“PDD 采集中(超时)”,允许重新创建;正常进行中继续禁止重复。 +- `MarkCollecting` 和 `MarkRecollecting` 的原子条件同步支持“无有效任务”恢复,避免页面 + 提供恢复按钮但服务端仍按更新时间拒绝。 +- v12 迁移创建来源表、自检字段/索引/外键及级联规则,并把未删除且没有有效任务的 + 存量孤儿 `collecting` 安全回收到 `pending`。未执行生产迁移或部署。 + +## 改了哪些 + +- `admin/repository/mysql_db.go`:追加 MySQL v12、存量状态修复和完整形状自检。 +- `admin/repository/task.go`、`pdd.go`、`syb.go`:来源写入与搜索、删除状态回收、原子 + 重建条件和有效采集任务查询。 +- `admin/service/pdd.go`、`shopee_pdd.go`、`task.go`、`syb.go`:来源聚合、事务编排、 + 超时阶段和恢复能力。 +- `admin/templates/syb/detail_modal.html`:超时状态显示“重新创建采集任务”。 +- `admin/**/*_test.go`:覆盖来源去重与搜索、重复创建防护、孤儿恢复、删除回收和 v12 迁移。 +- `docs/admin/01-requirements.md`、`03-data-model.md`、`05-ui-specification.md`:同步稳定规则。 + +## 验收结果 + +| 验收标准 | 结果 | +|---|---| +| 同一 PDD 商品只建一条任务并保存全部顺运宝来源 | 通过(自动化用例已编写;真实 MySQL 执行环境未提供) | +| 按任一来源订单号或明细 ID 可搜索任务,统计与列表一致 | 通过(自动化用例已编写;真实 MySQL 执行环境未提供) | +| 删除最后有效采集任务回收状态,有其他任务时不回收 | 通过(自动化用例已编写;真实 MySQL 执行环境未提供) | +| 无任务、超时或损坏时间显示明确恢复状态并可重建 | 通过(阶段单测通过;数据库链路用例已编写) | +| 正常未超时且有有效任务时禁止重复创建 | 通过(自动化用例已编写;真实 MySQL 执行环境未提供) | +| MySQL v12 首次建库、v11 升级、重放和错误形状拒绝 | 未执行:缺少独立 MySQL 8.4 `_test` 库权限 | +| Client 四接口和 Admin 固定 Go 1.23 回归 | 通过;未修改 Client 接口契约 | + +## 测试 + +- 执行的命令:在 `admin/` 设置 `GOTOOLCHAIN=go1.23.0` 后执行 + `go test ./... -count=1`、`go build ./...`、`go vet ./...`,并执行 `git diff --check`。 +- 结果:全部通过;未引入新依赖,模板可以正常解析,代码提交为 `9e32898`。 +- **没验证到的部分**:未在真实 MySQL 8.4 `_test` 库执行数据库型测试。已尝试连接 + `autobuy_test`,但线上 `buy` 按安全规则只拥有生产 `autobuy` 权限;本机监听实例为 + MySQL 5.7,不符合项目要求。没有使用或清理生产 schema。尚未执行生产 v12 迁移、 + 部署和浏览器人工验收。 + +## 相关提交 + +- `9e32898` 修复顺运宝采集任务孤儿状态