feat(phase-1): 京东数据库数据底座——V193~V196 迁移 + jd 模块实体/Mapper + 模块注册与 LOCAL 通道默认 + aiimage.jd 配置

This commit is contained in:
2026-11-14 03:08:32 +08:00
parent 334ed2cadd
commit a429191edd
24 changed files with 683 additions and 39 deletions
@@ -180,7 +180,13 @@ class MigratedSqlEquivalenceTest {
// 2026-11-11 卡片「删除」:1 条新写的 delete(谓词与按主管导出的 select
// 逐字同源)。delete 不计 select,故 XML_SELECT_TOTAL 保持 109
// (SqlLayeringConventionTest.XML_STATEMENT_TOTAL 同轮 155 → 156)。
"AppearancePatentCleanItemMapper#deleteSupervisorItems");
"AppearancePatentCleanItemMapper#deleteSupervisorItems",
// v1.4 京东数据库(2026-11-14,V193/V194 同窗):jd 模块首份起的两份 mapper,
// 各 1 条新写的 upsert(覆盖最新 uk_company_shop_code / 图片登记
// uk_product_image),注解时代没有原文可对撞,逐条点名留痕
//(SqlLayeringConventionTest.XML_STATEMENT_TOTAL 同轮 155 → 157)。
"JdProductMapper#upsertBatch",
"JdProductImageMapper#upsertBatch");
/** 账本 5 列:接口 / 方法 / @Select 种类 / 是否含常量插值 / 注解原文(Java 反转义后那条串)。 */
private static final int LEDGER_COLUMNS = 5;
@@ -108,7 +108,11 @@ class SqlLayeringConventionTest {
// 逐字同源)——delete 不计入该文件 XML_SELECT_TOTAL,只点名进 NOT_MIGRATED。
// 156 → 155:2026-11-11「ASIN 累计」(V191 同窗)把同步链的 deleteByResultId+insertBatch
// 两条合并成 1 条 upsertBatch(ON DUPLICATE KEY UPDATE,永不删除)——净减 1 条。
private static final int XML_STATEMENT_TOTAL = 155;
// 155 → 157:v1.4 京东数据库(V193/V194 同窗)jd 模块首份起的两份 XML 各 1 条写侧语句——
// JdProductMapper#upsertBatch(覆盖最新,uk_company_shop_code)+
// JdProductImageMapper#upsertBatch(图片登记,uk_product_image),全部新写,
// 同轮登记进 MigratedSqlEquivalenceTest.NOT_MIGRATED(该文件 XML_SELECT_TOTAL 不动:无 select)。
private static final int XML_STATEMENT_TOTAL = 157;
/**
* wrapper 里夹带函数级 SQL 的现状("这不是简单单表"的证据),文件名 → 条数:
@@ -43,7 +43,8 @@ class TaskModuleCoverageTest {
private static final Set<String> EXPECTED_MODULES = Set.of(
"PUBLISH", "DEDUPE", "SPLIT", "CONVERT", "DELETE_BRAND", "PRODUCT_RISK_RESOLVE",
"PRICE_TRACK", "SHOP_MATCH", "PATROL_DELETE", "QUERY_ASIN", "WITHDRAW",
"APPEARANCE_PATENT", "SIMILAR_ASIN", "COLLECT_DATA", "SHOP_DATA_CRAWL", "BRAND");
"APPEARANCE_PATENT", "SIMILAR_ASIN", "COLLECT_DATA", "SHOP_DATA_CRAWL", "BRAND",
"JD_SHOP_COLLECT");
@Test
void registryCoversEveryKnownModuleWithLabel() {
@@ -5,49 +5,48 @@ import com.nanri.aiimage.modules.task.model.CollectChannel;
import org.junit.jupiter.api.Test;
import java.util.List;
import java.util.Optional;
import java.util.Set;
import static org.junit.jupiter.api.Assertions.assertEquals;
import static org.junit.jupiter.api.Assertions.assertFalse;
import static org.junit.jupiter.api.Assertions.assertThrows;
import static org.junit.jupiter.api.Assertions.assertTrue;
/**
* v1.4 Phase 0 黄金测试:钉住 Phase 1 即将有意识改动的两个存量接缝的<b>当前</b>形状。
* v1.4 Phase 1 黄金测试:钉住 Phase 1 有意识翻转后的两个存量接缝的<b>新</b>形状。
*
* <p>判据来源:蓝图 {@code docs/ITERATION_PLAN.md} §2.2 影响面清单——
* ① {@code TaskModuleRegistry} 新增 {@code JD_SHOP_COLLECT} 注册行;
* ① {@code TaskModuleRegistry} 新增 {@code JD_SHOP_COLLECT} 注册行(17 模块);
* ② {@code CollectChannel.LOCAL_DEFAULT_MODULES} 加入 {@code JD_SHOP_COLLECT}
* (不加 = 默认 ONLINE = 任务被推给无紫鸟的 Linux worker,铁律 19 同形坑)。
*
* <p>本类钉的是「改动前」的事实;Phase 1 落地时必须<b>同轮更新</b>这三条断言并激活
* {@code JdChannelDefaultTest},让接缝翻转换成显式评审点。所有既有模块清单、
* LOCAL 默认形状已由 {@code TaskModuleCoverageTest} / {@code CollectChannelTest} 各自钉住,此处不重复。
* <p>本类 Phase 0 时钉的是「改动前」的事实(16 模块 / 默认 ONLINE / 无凭据登记,
* git 历史可考);Phase 1 落地后同轮改写为翻转后的形状,与 {@code JdChannelDefaultTest}
* 一起成为接缝的常驻判据。所有既有模块清单、LOCAL 默认形状已由
* {@code TaskModuleCoverageTest} / {@code CollectChannelTest} 各自钉住,此处不重复。
*/
class JdCollectChannelGoldenTest {
/** 当前注册表恰好 16 个模块且无京东:Phase 1 新增 JD_SHOP_COLLECT 必须同轮更新本清单。 */
/** Phase 1 起注册表 17 个模块且含京东:再增删模块必须同轮更新本清单。 */
@Test
void 京东模块当前未注册进任务模块注册表() {
void 京东模块已注册进任务模块注册表() {
Set<String> types = TaskModuleRegistry.moduleTypes();
assertEquals(16, types.size(), "Phase 1 新增 JD_SHOP_COLLECT 时更新为 17");
assertEquals(17, types.size(), "再增删模块时同轮更新本数(Phase 1 定格 17)");
assertTrue(types.containsAll(List.of("APPEARANCE_PATENT", "SIMILAR_ASIN", "SHOP_DATA_CRAWL",
"COLLECT_DATA", "PRICE_TRACK", "PUBLISH", "BRAND")), "既有清单形状漂移,先查别人改动");
assertFalse(types.contains("JD_SHOP_COLLECT"), "当前未注册;出现即有人在未登记蓝图的情况下动了注册表");
"COLLECT_DATA", "PRICE_TRACK", "PUBLISH", "BRAND", "JD_SHOP_COLLECT")), "既有清单形状漂移,先查别人改动");
}
/** 当前京东模块按 V183 语义默认 ONLINE:Phase 1 改为 LOCAL 时同轮更新本断言。 */
/** 京东模块默认 LOCAL(紫鸟只在本机):谁把它翻回 ONLINE 这里先红。 */
@Test
void 京东模块当前默认通道为ONLINE() {
assertFalse(CollectChannel.defaultFor("JD_SHOP_COLLECT").isLocal(),
"当前未加入 LOCAL 默认;Phase 1 翻转后本断言同步改为 isLocal()");
void 京东模块默认通道为LOCAL() {
assertTrue(CollectChannel.defaultFor("JD_SHOP_COLLECT").isLocal(),
"京东采集只能在本机 Windows + 紫鸟窗口执行(铁律 19 同形),翻回 ONLINE = 任务永不执行");
}
/** 当前京东模块无提交凭据要求:注册表对未注册类型按构造抛参。Phase 1 登记后本断言同轮更新。 */
/** 京东模块建单不需要用户凭据(Optional.empty()=登记过的结论「不需要」,不是漏填)。 */
@Test
void 京东模块当前无提交凭据登记() {
assertThrows(IllegalArgumentException.class,
() -> TaskModuleRegistry.submitSecretModuleOf("JD_SHOP_COLLECT"),
"未注册类型应按构造拒绝;Phase 1 注册后改断言为 Optional.empty()");
void 京东模块无提交凭据登记() {
assertEquals(Optional.empty(), TaskModuleRegistry.submitSecretModuleOf("JD_SHOP_COLLECT"),
"京东采集缺代理是「直连降级」不是注定失败(铁律 27 边界 c),登记过=不需要;要改先拍板");
}
}
@@ -1,6 +1,5 @@
package com.nanri.aiimage.modules.jd;
import org.junit.jupiter.api.Disabled;
import org.junit.jupiter.api.Test;
import java.io.IOException;
@@ -20,7 +19,6 @@ import static org.junit.jupiter.api.Assertions.assertTrue;
* Phase 1 写下的那一份形状——覆盖最新唯一键、归属列显式 NOT NULL(铁律 30)、
* 图片独立桶不落默认桶(铁律 17:默认桶整桶 7 天 ILM)、菜单每公司一行且不插授权行(V190 惯例)。
*/
@Disabled("Pending Phase 1: V193~V196 迁移与 aiimage.jd.* 配置落地后激活")
class JdSchemaContractTest {
private static final Path DB_DIR = Path.of("src", "main", "resources", "db");
@@ -13,9 +13,10 @@ import static org.junit.jupiter.api.Assertions.assertTrue;
/**
* V183 任务级采集通道的判据(建单写入、认领读取、脏值兜底)。
*
* <p>这里钉死的是「不登记=按模块默认」这条兼容线:外观专利/相似ASIN 读作本机,
* 其余模块读作线上,与 V183 之前 {@code AIIMAGE_COLLECT_LOCAL_*} 出厂值 {@code true} 等价。
* 一旦默认翻转,全部历史任务与未升级客户端的执行方会集体换边,所以逐条点名。
* <p>这里钉死的是「不登记=按模块默认」这条兼容线:外观专利/相似ASIN/京东店铺采集
* (v1.4 Phase 1 加入,紫鸟只在本机)读作本机,其余模块读作线上,与 V183 之前
* {@code AIIMAGE_COLLECT_LOCAL_*} 出厂值 {@code true} 等价。一旦默认翻转,
* 全部历史任务与未升级客户端的执行方会集体换边,所以逐条点名。
*/
class CollectChannelTest {
@@ -39,7 +40,8 @@ class CollectChannelTest {
@Test
void 本机默认模块清单与defaultFor同源() {
assertEquals(List.of(CollectRoutingProperties.MODULE_APPEARANCE_PATENT,
CollectRoutingProperties.MODULE_SIMILAR_ASIN), CollectChannel.localDefaultModuleTypes());
CollectRoutingProperties.MODULE_SIMILAR_ASIN,
CollectRoutingProperties.MODULE_JD_SHOP_COLLECT), CollectChannel.localDefaultModuleTypes());
for (String module : CollectChannel.localDefaultModuleTypes()) {
assertTrue(CollectChannel.defaultFor(module).isLocal(), module + " 在清单里却不被判本机");
}
@@ -1,6 +1,5 @@
package com.nanri.aiimage.modules.task.model;
import org.junit.jupiter.api.Disabled;
import org.junit.jupiter.api.Test;
import static org.junit.jupiter.api.Assertions.assertEquals;
@@ -11,13 +10,12 @@ import static org.junit.jupiter.api.Assertions.assertEquals;
* <p>蓝图为 {@code docs/ITERATION_PLAN.md} §4 Phase 1;判据即铁律 19 同形——
* {@code CollectChannel.LOCAL_DEFAULT_MODULES} 不加 {@code JD_SHOP_COLLECT},
* 取页 SQL 就会把它当 ONLINE 派给 Linux worker,而紫鸟只在客户端本机 ⇒ 任务永不执行。
* 当前形状(默认 ONLINE)由黄金测试 {@code JdCollectChannelGoldenTest} 钉住;
* Phase 1 加入 LOCAL 默认后移除本 @Disabled 并跑绿。
* 已于 Phase 1(2026-11-14)激活跑绿;翻转前的 ONLINE 形状由黄金测试
* {@code JdCollectChannelGoldenTest} 改写前记录(git 历史可考)。
*/
class JdChannelDefaultTest {
@Test
@Disabled("Pending Phase 1: CollectChannel.LOCAL_DEFAULT_MODULES 加入 JD_SHOP_COLLECT 后激活")
void 京东采集默认通道必须是LOCAL() {
assertEquals(CollectChannel.LOCAL, CollectChannel.defaultFor("JD_SHOP_COLLECT"));
}