feat(product-suite): clarify primary image sorting

docs/tasks/T-688.md

@@ -3,7 +3,7 @@ id: T-688
 title: 商品套图主图拖拽排序反馈与拉取保护
 phase: 7
 deps: [T-631, T-658b]
-status: TODO
+status: DONE
 created: 2026-07-22
 ---
 
@@ -52,4 +52,9 @@ created: 2026-07-22
 
 ## 执行记录
 
-- 待实施。
+- 2026-07-22 完成。
+- `ProductOriginalList` 增加独立的内部排序开关；拉取蝦皮主图期间保留外部文件拖入、预览和其它界面操作，但关闭内部拖拽、落点指示和排序信号接收，并以中文 tooltip 提示等待拉取完成。
+- 商品原图第1张继续作为业务主图，现以「主图」文字、粗体和语义色标识；每张图片和列表 tooltip 明确说明拖到第一位即可设为主图。事务排序成功后状态栏提示“已更新商品原图顺序，第一张图片为主图”。
+- `reorder_originals()` 对生成中和拉取中的迟到排序信号防御性拒绝，并刷新数据库顺序；排序只影响以后新建的 job，既有 `source_asset_id/reference_asset_ids` 快照不变。
+- 已同步 `docs/04-architecture.md` 与 `docs/routes.md`，新增/更新 GUI 测试覆盖主图反馈、排序持久化、拉取锁定、直接调用防御与恢复排序。
+- 验证通过：`py -3.10 -m unittest tests.test_product_suite tests.test_product_suite_gui`（78项）、`py -3.10 -m unittest tests.test_image_studio`（24项）、`py -3.10 -m unittest discover -s tests`（669项）、`py -3.10 -m ruff check app tests main.py`、`py -3.10 -m compileall app main.py`、`git diff --check`。离屏 PySide6 输出字体目录/插件告警，但无测试失败。