You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

102 lines
3.7 KiB

package common.ecommerce.hengjian.adapter;
import common.ecommerce.hengjian.HengjianConstants;
import common.ecommerce.http.JacksonJsonCodec;
import common.ecommerce.shared.spi.ChannelSecret;
import common.ecommerce.shared.testkit.RecordingTransport;
import common.ecommerce.warehouse.enums.WarehouseProvider;
import common.ecommerce.warehouse.error.WarehouseUnsupportedCapabilityException;
import common.ecommerce.warehouse.model.OutboundRef;
import common.ecommerce.warehouse.sdk.WarehouseConnection;
import common.ecommerce.warehouse.sdk.WarehouseSdk;
import common.ecommerce.warehouse.spi.WarehouseAccount;
import common.ecommerce.warehouse.testkit.InMemoryWarehouses;
import org.junit.jupiter.api.Test;
import java.time.Clock;
import java.time.Instant;
import java.time.ZoneOffset;
import static org.junit.jupiter.api.Assertions.assertEquals;
import static org.junit.jupiter.api.Assertions.assertThrows;
import static org.junit.jupiter.api.Assertions.assertTrue;
/**
* 恒健适配器门面契约:注册后能按 provider 解析,未实现的能力显式拒绝。
*/
class HengjianAdapterTest {
private static final Clock CLOCK = Clock.fixed(Instant.parse("2026-11-12T00:00:00Z"), ZoneOffset.UTC);
private static final String WH = "HJ-EFCA";
private static WarehouseAccount account() {
return WarehouseAccount.builder()
.warehouseCode(WH)
.provider(WarehouseProvider.HENGJIAN.name())
.providerWarehouseId("EFCA")
.credentialRef("kms://test/hengjian")
.timeZone("America/Los_Angeles")
.build();
}
private static WarehouseSdk sdk() {
return WarehouseSdk.builder()
.warehouseRepository(new InMemoryWarehouses().put(account()))
.clock(CLOCK)
.register(new HengjianAdapterFactory())
.build();
}
private static WarehouseConnection conn() {
return WarehouseConnection.of(HengjianConstants.TEST_BASE_URL,
ChannelSecret.builder().appSecret("token-1").build());
}
@Test
void registersAndResolves() {
WarehouseSdk sdk = sdk();
assertTrue(sdk.capabilities(WH).supports(
common.ecommerce.warehouse.enums.WarehouseCapability.DIRECTORY));
assertTrue(sdk.capabilities(WH).supports(
common.ecommerce.warehouse.enums.WarehouseCapability.LOGISTICS_PRODUCT));
}
/**
* 出库的五个方法(下单 / 查询 / 预判 / 取消 / 包裹)都已接入,
* 门面能力检查放行 {@code OUTBOUND},不经能力位拒绝。
*/
@Test
void outboundCapabilityIsFullyWired() {
WarehouseSdk sdk = sdk();
assertTrue(sdk.capabilities(WH).supports(
common.ecommerce.warehouse.enums.WarehouseCapability.OUTBOUND));
}
feat(hengjian): 对接库存查询 / 批量分页 / 库存变动流水 三个接口真机均确认存在(无 token 时返回各自的 Unauthorized 文案, 与 404 对照组可区分)。 按 SKU 查 /v1/inventory/getInventory、批量分页 /v2/inventory/get_inventory_by_page - 恒健有两个库存接口且能力不同,统一模型只有一个 query(),按条件分流: 给 providerSkus 走按 SKU(不分页),只给 warehouseCodes 走分页 - 两个都给 → 拒绝(恒健无此接口);都不给 → 拒绝(不退化成整仓全量); 给 updatedAfter / inventoryType / includeZeroStock → 拒绝(不支持) - 分页接口 rows 上限 500(文档明写),超过拒绝不截断 - 字段名两套:字段表写 snake_case、示例写 camelCase,DTO 用 @JsonAlias 同时接住 - data 形状两套:对象(含 content)与数组,用 JsonNode 判形状后分流 - updatedAt 缺失时报错而非填 EPOCH——快照时间是对账对齐依据 - syncStrategy = FULL_PULL_DIFF:两个接口都没有增量入参 库存变动流水 /v1/inventory/task/query - 真机确认 skus / beginDateTime / endDateTime 必填,缺项回 MethodArgumentNotValidException - 日期跨度按「含首尾」口径算:10-01~10-30 合法(30 天),10-01~10-31 非法 - rows 上限 100(文档明写) - 新增 core 模型 InventoryMovement / InventoryMovementQuery / queryMovements() - changeQty 按原值保留不转符号;单据类型与变动方向保留仓方原文不归一 - 单行缺 sku / createTime 时跳过该行而非整页失败 验证:mvn test 全量通过,恒健 203 个用例(+23)通过。 Co-Authored-By: Claude Code <noreply@anthropic.com>
6 days ago
/** 入库 / 退货仍未接入:门面按能力位直接拒绝。 */
@Test
void undeclaredCapabilityIsRejected() {
WarehouseSdk sdk = sdk();
assertThrows(WarehouseUnsupportedCapabilityException.class,
feat(hengjian): 对接库存查询 / 批量分页 / 库存变动流水 三个接口真机均确认存在(无 token 时返回各自的 Unauthorized 文案, 与 404 对照组可区分)。 按 SKU 查 /v1/inventory/getInventory、批量分页 /v2/inventory/get_inventory_by_page - 恒健有两个库存接口且能力不同,统一模型只有一个 query(),按条件分流: 给 providerSkus 走按 SKU(不分页),只给 warehouseCodes 走分页 - 两个都给 → 拒绝(恒健无此接口);都不给 → 拒绝(不退化成整仓全量); 给 updatedAfter / inventoryType / includeZeroStock → 拒绝(不支持) - 分页接口 rows 上限 500(文档明写),超过拒绝不截断 - 字段名两套:字段表写 snake_case、示例写 camelCase,DTO 用 @JsonAlias 同时接住 - data 形状两套:对象(含 content)与数组,用 JsonNode 判形状后分流 - updatedAt 缺失时报错而非填 EPOCH——快照时间是对账对齐依据 - syncStrategy = FULL_PULL_DIFF:两个接口都没有增量入参 库存变动流水 /v1/inventory/task/query - 真机确认 skus / beginDateTime / endDateTime 必填,缺项回 MethodArgumentNotValidException - 日期跨度按「含首尾」口径算:10-01~10-30 合法(30 天),10-01~10-31 非法 - rows 上限 100(文档明写) - 新增 core 模型 InventoryMovement / InventoryMovementQuery / queryMovements() - changeQty 按原值保留不转符号;单据类型与变动方向保留仓方原文不归一 - 单行缺 sku / createTime 时跳过该行而非整页失败 验证:mvn test 全量通过,恒健 203 个用例(+23)通过。 Co-Authored-By: Claude Code <noreply@anthropic.com>
6 days ago
() -> sdk.warehouses(WH, conn()).inbound().get("IB-1"));
}
/** 能力矩阵查询本身可用(不触发真实 API)。 */
@Test
void capabilityQueryIsOffline() {
HengjianAdapter adapter = new HengjianAdapter(RecordingTransport.create(), new JacksonJsonCodec());
feat(hengjian): 对接库存查询 / 批量分页 / 库存变动流水 三个接口真机均确认存在(无 token 时返回各自的 Unauthorized 文案, 与 404 对照组可区分)。 按 SKU 查 /v1/inventory/getInventory、批量分页 /v2/inventory/get_inventory_by_page - 恒健有两个库存接口且能力不同,统一模型只有一个 query(),按条件分流: 给 providerSkus 走按 SKU(不分页),只给 warehouseCodes 走分页 - 两个都给 → 拒绝(恒健无此接口);都不给 → 拒绝(不退化成整仓全量); 给 updatedAfter / inventoryType / includeZeroStock → 拒绝(不支持) - 分页接口 rows 上限 500(文档明写),超过拒绝不截断 - 字段名两套:字段表写 snake_case、示例写 camelCase,DTO 用 @JsonAlias 同时接住 - data 形状两套:对象(含 content)与数组,用 JsonNode 判形状后分流 - updatedAt 缺失时报错而非填 EPOCH——快照时间是对账对齐依据 - syncStrategy = FULL_PULL_DIFF:两个接口都没有增量入参 库存变动流水 /v1/inventory/task/query - 真机确认 skus / beginDateTime / endDateTime 必填,缺项回 MethodArgumentNotValidException - 日期跨度按「含首尾」口径算:10-01~10-30 合法(30 天),10-01~10-31 非法 - rows 上限 100(文档明写) - 新增 core 模型 InventoryMovement / InventoryMovementQuery / queryMovements() - changeQty 按原值保留不转符号;单据类型与变动方向保留仓方原文不归一 - 单行缺 sku / createTime 时跳过该行而非整页失败 验证:mvn test 全量通过,恒健 203 个用例(+23)通过。 Co-Authored-By: Claude Code <noreply@anthropic.com>
6 days ago
// 库存已接入;入库 / 退货仍是未接状态
assertTrue(!adapter.capabilities().contains(
feat(hengjian): 对接库存查询 / 批量分页 / 库存变动流水 三个接口真机均确认存在(无 token 时返回各自的 Unauthorized 文案, 与 404 对照组可区分)。 按 SKU 查 /v1/inventory/getInventory、批量分页 /v2/inventory/get_inventory_by_page - 恒健有两个库存接口且能力不同,统一模型只有一个 query(),按条件分流: 给 providerSkus 走按 SKU(不分页),只给 warehouseCodes 走分页 - 两个都给 → 拒绝(恒健无此接口);都不给 → 拒绝(不退化成整仓全量); 给 updatedAfter / inventoryType / includeZeroStock → 拒绝(不支持) - 分页接口 rows 上限 500(文档明写),超过拒绝不截断 - 字段名两套:字段表写 snake_case、示例写 camelCase,DTO 用 @JsonAlias 同时接住 - data 形状两套:对象(含 content)与数组,用 JsonNode 判形状后分流 - updatedAt 缺失时报错而非填 EPOCH——快照时间是对账对齐依据 - syncStrategy = FULL_PULL_DIFF:两个接口都没有增量入参 库存变动流水 /v1/inventory/task/query - 真机确认 skus / beginDateTime / endDateTime 必填,缺项回 MethodArgumentNotValidException - 日期跨度按「含首尾」口径算:10-01~10-30 合法(30 天),10-01~10-31 非法 - rows 上限 100(文档明写) - 新增 core 模型 InventoryMovement / InventoryMovementQuery / queryMovements() - changeQty 按原值保留不转符号;单据类型与变动方向保留仓方原文不归一 - 单行缺 sku / createTime 时跳过该行而非整页失败 验证:mvn test 全量通过,恒健 203 个用例(+23)通过。 Co-Authored-By: Claude Code <noreply@anthropic.com>
6 days ago
common.ecommerce.warehouse.enums.WarehouseCapability.INBOUND));
}
@Test
void providerEnumIsRegistered() {
assertEquals("恒健", WarehouseProvider.HENGJIAN.label());
assertEquals(50, WarehouseProvider.HENGJIAN.code());
}
}