feat(jd): 京东数据库货号系统生成——行号即货号(2026-11-15 用户口径「系统自行生成货号,不用之前的货号;从 1 开始递增或随机数(唯一)」):新落库行 item_num 在回传落库后由 reassignItemNums 刷成行号(CONVERT(id, CHAR)——全局唯一、从 1 递增、行不变货号就不变,零并发竞争);upsertBatch 的 UPDATE 段摘掉 item_num 覆盖(重爬命中已有行不得把系统货号刷回京东原值,绊线钉住);锁定行(manual_locked=1)不刷——人工编辑过的货号优先;京东原货号仍在 attr_json 属性区留档溯源。存量行随下一次同店铺重爬刷成行号(item_num != id 命中);如需立即生效可对存量跑一次同款 UPDATE(发版窗口决定)。判据:SyncServiceTest +3(落库后刷写被调/整批被保护不刷/UPDATE 段不覆盖+刷写排除锁定行的 XML 绊线);SqlLayeringConventionTest 账本 162→163 逐笔记名。同笔修存量红:CompanyIdParamGoesThroughReadScopeTest 的 ProductCategory 子串锚剥除 JdProductCategoryVo 字样(京东商品库自己的类目下拉 VO 与全平台共享表无关,子串撞车把整个 AdminJdProductController 误拖进消费者清单;剥字样非整行排除——同行真引用 ProductCategoryEntity 照样命中,护栏意图不削弱)。后端整量 5,610 例 0 失败全绿;编辑抽屉货号 label 注明「系统生成=行号,可改」

This commit is contained in:
2026-11-15 19:03:40 +08:00
parent dea9891e19
commit 84a4bc38b5
7 changed files with 97 additions and 6 deletions
@@ -32,6 +32,14 @@ public interface JdProductMapper extends BaseMapper<JdProductEntity> {
*/
int upsertBatch(@Param("rows") List<JdProductEntity> rows);
/**
* 货号系统生成(2026-11-15 用户口径「系统自行生成货号,不用之前的货号」):
* 本任务落库的行 {@code item_num = 行号}(全局唯一、从 1 递增;行不变货号不变,
* 重爬命中已有行时货号稳定)。幂等:已等于行号的行不重复写;{@code manual_locked=1}
* 的行不动(人工编辑过的人工值优先)。京东原货号只在 attr_json 属性区留档。
*/
int reassignItemNums(@Param("companyId") Long companyId, @Param("taskId") Long taskId);
/**
* 后管只读页总数(Phase 5,v1.4):与 {@link #selectProductPage} 同一过滤面
* (公司/店铺名/商品编码/标题关键词/类目/分组/同步起止,全部 SQL 侧下推,
@@ -145,6 +145,10 @@ public class JdResultIngestService {
int protectedSkipped = filterProtectedRows(companyId, rows, pendingImages, pendingSkus);
if (!rows.isEmpty()) {
jdProductMapper.upsertBatch(rows);
// 货号系统生成(2026-11-15 用户口径「系统自行生成货号,不用之前的货号」):
// 行号即货号,落库后按本任务刷一次(幂等——已等于行号的行不重复写;
// 锁定行不动)。重爬命中已有行时 UPDATE 段不覆盖 item_num,货号保持稳定。
jdProductMapper.reassignItemNums(companyId, taskId);
} else {
log.info("[{}] 整批行都被人工编辑锁/删除忽略保护,本次不落库 taskId={} skipped={}",
LOG_TAG, taskId, protectedSkipped);
@@ -38,7 +38,9 @@
task_id = VALUES(task_id),
shop_name = VALUES(shop_name),
sku_id = VALUES(sku_id),
item_num = VALUES(item_num),
<!-- 货号不进 UPDATE 段(2026-11-15 用户口径「系统自行生成货号,不用之前的货号」):
货号=行号(reassignItemNums 在落库后刷写,全局唯一、从 1 递增,行不变货号就不变),
重爬命中已有行时不得把系统货号刷回京东原值。 -->
sku_count = VALUES(sku_count),
health_score = VALUES(health_score),
title = VALUES(title),
@@ -60,6 +62,21 @@
synced_at = CURRENT_TIMESTAMP
</insert>
<!-- 货号系统生成(2026-11-15 用户口径「我们系统自行生成货号 排序 不用之前的货号;
从 1 开始递增或者随机数(唯一)」):行号即货号——全局唯一、从 1 递增、天然零竞争,
行不变货号就不变(重爬命中已有行时货号稳定)。只在商品行落库后按本任务刷一次:
新插入行的 item_num 是京东原值(暂存),刷成行号;已等于行号的行不重复写(幂等);
manual_locked=1 的行不动(人工编辑过货号的人工值优先)。京东原货号仍在 attr_json
的「货号」属性行留档(京麦原文随属性区同步),主字段货号一律系统形状。 -->
<update id="reassignItemNums">
UPDATE biz_jd_product
SET item_num = CONVERT(id, CHAR)
WHERE company_id = #{companyId}
AND task_id = #{taskId}
AND manual_locked = 0
AND (item_num IS NULL OR item_num = '' OR item_num != CONVERT(id, CHAR))
</update>
<!-- 覆盖清理候选行(重爬覆盖语义,2026-11-15):本任务成功收尾后,同一公司同一批店铺里
不是本任务写、且所属任务已不在在飞(PENDING/RUNNING 不删——同店铺并发两单先收尾的
单不得抹掉仍在跑的单的行,后收尾的单会在自己的收尾时清)的商品行。