cmshoppe/docs/tasks/T-667.md

id, title, status, phase, deps, created

id	title	status	phase	deps	created
T-667	历史批次默认架上商品与移除状态重检入口	TODO	7	T-662a T-662d T-666	2026-07-20

T-667 历史批次默认架上商品与移除状态重检入口

问题 / 背景

T-662a 于 2026-07-18 16:34:37（本地时间）首次上线商品状态字段。此前导入的历史批次没有 product_status 快照；T-666 要求用户逐条打开历史商品详情页补检，几百条记录会带来明显等待和额外操作负担。产品决定：商品状态功能上线前创建、且状态为空的历史批次，默认按架上商品处理，以便继续生成和更新；不再提供用户手动状态重检入口。

方案

• 定义稳定的商品状态功能上线时间常量 2026-07-18T16:34:37。db.init_db() 每次启动执行幂等迁移：仅对未软删除批次中 batches.created_at 早于该时间，且 tasks.product_status 为 NULL 或空白的记录写入 normal。
• 同时写 product_status_note=历史批次默认按架上商品处理（未实时检测），保留 product_status_at=NULL，避免把默认值伪装为实时页面检测；更新 updated_at。已有 normal/unlisted/reviewing/unknown 均不得覆盖，功能上线后创建的批次也不得自动迁移。
• 移除①「重新检测商品状态」按钮、确认框、活动计时、专用 Worker、编辑器入口、run_type=status_recheck 运行日志及只为该入口添加的 GUI/测试/文档说明。常规①采集仍照现有流程实时检测并保存状态，新批次不受影响。
• ③继续只允许 product_status=normal 更新。历史默认记录因已迁移为 normal 可进入既有更新内容预检；不再显示“尚未检测商品状态”或引导用户点击重检。真实已保存的 unknown 仍显示「状态未知」并保持拦截。

验收标准

• 启动或 db.init_db() 后，状态功能上线时间前的活动批次中 NULL/空状态任务变为 normal，备注为历史默认语义，product_status_at 仍为空；重复初始化不重复改写。
• 上线时间等于或晚于阈值的 NULL/空状态任务不迁移，已有四类状态也不覆盖，软删除批次不迁移。
• ③历史默认 normal 记录可按原有标题/封面完整性规则进入更新；已保存 unknown 仍按「状态未知」阻断。
• ①不再显示「重新检测商品状态」，运行中控件状态、采集活动计时、回写逻辑和正常采集不回归。
• 不打开 Chrome、不访问商品详情页、不新增 AI 调用、不修改 Excel、不更新线上商品。

测试与文档

• tests/test_db.py 覆盖历史迁移范围、幂等、边界时间、已有状态及软删除批次保护。
• tests/test_product_status.py、tests/test_gui.py 覆盖③历史默认正常可更新、真实 unknown 仍阻断，以及①重检入口移除。
• 更新 docs/routes.md、docs/04-architecture.md、docs/api.md；T-666 保留完成记录并标明已被本任务替代。

验证

py -3.10 -m unittest discover -s tests
py -3.10 -m ruff check app tests main.py
py -3.10 -m compileall app main.py
git diff --check

非目标

• 不把功能上线后创建的缺失状态任务自动视为正常。
• 不覆盖已确认的未上架、审核中、状态未知或正常快照。
• 不为历史迁移新增确认弹窗、状态强制更新开关或详情页批量检测。

执行记录

• 待实现。