fix: 商品卡在「采集中」无法恢复 (#24)

MarkCollecting 原本只在 pending/failed 时成功,而全库只有客户端提交结果
才会把 collecting 改走。客户端离线、崩溃、任务被删都是常态——一旦发生,
这个商品就永久报废,界面上没有任何入口能救,只能改数据库。

改成 collecting 超过 15 分钟视为已超时,允许重新创建采集任务。

判定在读取那一刻现算,仍是同一条原子 UPDATE,不加后台清理协程:
后台扫要处理"扫到一半客户端正好提交了"的竞态,本项目已经在并发上
栽过两次,能不引入并发就不引入。

15 分钟写成有名字的常量并注明理由:采集本身几十秒到两分钟,加上排队
等客户端来领。宁可短也不要长——采集是只读的,多采一次没有副作用,
而卡死的代价是商品永久报废。

已知取舍:超时后老任务还在队列里,客户端上线可能两个都领走、采两次。
可接受(只读,后一次覆盖前一次),已写进代码注释和 03-data-model.md,
免得后来人当成 bug 去"修"成加锁或加租约——租约和心跳是被明确移除的设计。

时间比较用字符串,依赖 NowISO 产出定宽 UTC。已在 NowISO 上加注释:
改成带时区偏移的本地时间会让这个比较静默失效,不报错但判断全错。

界面两处:超时的显示「采集中(超时)」,否则操作员盯着「采集中」
不知道它已经死了;跳过原因按正在采集/已采集/已删除分类计数,
一个都没建成时告诉操作员还要等多久。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
chengma
2026-08-07 14:42:54 +08:00
co-authored by Claude Opus 5
parent ec7705fd17
commit e40ce5a13c
7 changed files with 498 additions and 58 deletions
+4 -7
View File
@@ -113,19 +113,16 @@ func (h *Handler) PddCollect(c *gin.Context) {
return
}
created, skipped, err := service.CreatePddCollectTasks(h.db, ids)
result, err := service.CreatePddCollectTasks(h.db, ids)
if err != nil {
fail(c, http.StatusInternalServerError,
"创建采集任务失败:"+err.Error()+"。这一批任务整体没有创建,可以直接重试。")
return
}
msg := fmt.Sprintf("已创建 %d 个采集任务,等待客户端领取", created)
if skipped > 0 {
// 跳过了几个必须说出来,否则操作员会以为都建上了,等半天没动静
msg += fmt.Sprintf("(跳过 %d 个采集中或已删除的)", skipped)
}
h.pddRedirect(c, msg)
// 跳过原因分类、"还要等多久"的措辞都是业务规则,交给 service 算,
// 这里只负责把结果接过来发给操作员,见 service.FormatCollectTaskMessage。
h.pddRedirect(c, service.FormatCollectTaskMessage(result))
}
// PddDelete 批量软删除。