Browse Source

test(yqn): 新增只读联调探针 YqnReadOnlyProbeTest

运去哪之前只有单元测试(RecordingTransport 打桩),没有真机验证。补一个
只读探针,默认跳过,需显式开启:

  mvn -pl warehouse-sdk-yqn -DfailIfNoTests=false \
      -Dyqn.probe=true -Dyqn.probe.token=<x-api-key> \
      -Dyqn.probe.providerWarehouseId=RF_NY_US \
      -Dtest=YqnReadOnlyProbeTest test

覆盖 7 个查询接口:
- GET  /v1/warehouse/findAll                      仓库目录(不依赖单号)
- GET  /v2/sysCarrierGroup/getCarrierGroupList    物流产品(验 GET+query 参数)
- GET  /v2/inventory/get_inventory_by_page        库存(验分页与下划线字段名)
- POST /v1/warehouse/operation/costs/detail       结算明细(需 saleOrderNo)
- POST /v1/saleOrder/findOne                      出库详情(需 outboundOrderNo)
- POST /v1/inbound/getInboundPlanInfo             入库计划(需 inboundOrderNo)
- POST /v3/saleReturn/getInboundPlanInfo          退货计划(需 returnOrderNo)
- GET  api/v2/orderShipment/track/{no}            轨迹(需 trackingNo)

**不碰任何写接口**:下单 / 建入库 / 建调拨 / 建退货 / 销毁都会真实创建单据,
没有测试环境,一律不跑(遵守 feedback-no-live-write-tests)。

安全:
- 凭据只走系统属性,不入库
- 输出打印 token 掩码(前 4 + 后 2),不打印完整 token
- 只打印字段摘要,不打印完整报文(可能含 PII)

异常只打印不抛出,一次跑完便于对照真实报文。全量 162 个测试通过。

Co-Authored-By: Claude <noreply@anthropic.com>
feature/supplier-lingxing
chenchuchuan 1 week ago
parent
commit
38db00cd4d
  1. 297
      warehouse-sdk-yqn/src/test/java/common/ecommerce/yqn/probe/YqnReadOnlyProbeTest.java

297
warehouse-sdk-yqn/src/test/java/common/ecommerce/yqn/probe/YqnReadOnlyProbeTest.java

@ -0,0 +1,297 @@
package common.ecommerce.yqn.probe;
import common.ecommerce.http.JacksonJsonCodec;
import common.ecommerce.http.OkHttpTransport;
import common.ecommerce.shared.error.ChannelException;
import common.ecommerce.shared.spi.ChannelSecret;
import common.ecommerce.warehouse.enums.WarehouseProvider;
import common.ecommerce.warehouse.sdk.WarehouseConnection;
import common.ecommerce.warehouse.sdk.WarehouseContext;
import common.ecommerce.yqn.YqnConstants;
import common.ecommerce.yqn.adapter.YqnAdapter;
import org.junit.jupiter.api.Assumptions;
import org.junit.jupiter.api.Test;
import org.junit.jupiter.api.condition.EnabledIfSystemProperty;
import java.time.Clock;
/**
* 运去哪<b>只读</b>探针:核对已对接接口的真实出入参。
*
* <p>默认跳过,用 {@code -Dyqn.probe=true} 显式开启;凭据走系统属性,
* <b>真实 token 不入库</b>:</p>
*
* <pre>
* mvn -pl warehouse-sdk-yqn -DfailIfNoTests=false \
* -Dyqn.probe=true \
* -Dyqn.probe.token=你的x-api-key \
* -Dyqn.probe.warehouseCode=RF_NY_US \
* -Dtest=YqnReadOnlyProbeTest test
* </pre>
*
* <p><b>只跑查询类接口</b>:出库 / 入库 / 调拨 / 退货 / 销毁的下单类接口会真实创建单据,
* 没有测试环境,一律不碰(见 feedback-no-live-write-tests)。</p>
*
* <p>输出只打印字段名与取值摘要,不打印完整报文(可能含 PII)。</p>
*/
@EnabledIfSystemProperty(named = "yqn.probe", matches = "true")
class YqnReadOnlyProbeTest {
// 真实凭据不入库:本地跑探针时用 -Dyqn.probe.token=...
private static final String TOKEN = System.getProperty("yqn.probe.token", "");
private static final String BASE_URL = opt("yqn.probe.baseUrl", YqnConstants.PR_BASE_URL);
private static final String AUX_URL = opt("yqn.probe.auxBaseUrl", YqnConstants.AUX_BASE_URL_PR);
private static final String WAREHOUSE_CODE = opt("yqn.probe.warehouseCode", "YQN-PROBE");
private static final String PROVIDER_WAREHOUSE = opt("yqn.probe.providerWarehouseId", "");
private static WarehouseContext ctx() {
return WarehouseContext.of(WAREHOUSE_CODE, WarehouseProvider.YQN,
PROVIDER_WAREHOUSE.isEmpty() ? null : PROVIDER_WAREHOUSE,
WarehouseConnection.of(BASE_URL, AUX_URL,
ChannelSecret.builder().appSecret(TOKEN).build()),
"probe-" + System.currentTimeMillis(), Clock.systemUTC());
}
private static YqnAdapter adapter() {
return new YqnAdapter(new OkHttpTransport("common-ecommerce-yqn-probe"),
new JacksonJsonCodec());
}
/** 仓库目录:不依赖任何单号,最容易验通。 */
@Test
void probeWarehouseDirectory() {
assumeToken();
run("GET /v1/warehouse/findAll", () -> {
java.util.List<common.ecommerce.warehouse.model.WarehouseInfo> list =
adapter().warehouses(ctx());
System.out.println("[warehouses] 返回 " + list.size() + " 个仓");
for (int i = 0; i < Math.min(list.size(), 5); i++) {
common.ecommerce.warehouse.model.WarehouseInfo w = list.get(i);
System.out.println(" [" + i + "] code=" + w.warehouseCode()
+ " name=" + w.name()
+ " country=" + w.country()
+ " city=" + w.city());
}
});
}
/** 物流产品:验证「GET 但参数写在 query」这条路是否被仓方接受。 */
@Test
void probeLogisticsProducts() {
assumeToken();
run("GET /v2/sysCarrierGroup/getCarrierGroupList", () -> {
java.util.List<common.ecommerce.warehouse.model.LogisticsProduct> list =
adapter().products(ctx(), PROVIDER_WAREHOUSE.isEmpty() ? null : PROVIDER_WAREHOUSE);
System.out.println("[products] 返回 " + list.size() + " 个物流产品");
for (int i = 0; i < Math.min(list.size(), 5); i++) {
common.ecommerce.warehouse.model.LogisticsProduct p = list.get(i);
System.out.println(" [" + i + "] code=" + p.logisticsProductCode()
+ " name=" + p.logisticsProductName()
+ " crossCountry=" + p.crossCountry());
}
});
}
/** 库存查询:验证分页结构与字段名(下划线风格)。 */
@Test
void probeInventory() {
assumeToken();
run("GET /v2/inventory/get_inventory_by_page", () -> {
common.ecommerce.warehouse.model.InventoryQuery query =
common.ecommerce.warehouse.model.InventoryQuery.builder()
.pageSize(5).build();
common.ecommerce.shared.support.Page<common.ecommerce.warehouse.model.InventorySnapshot> page =
adapter().query(ctx(), query);
System.out.println("[inventory] 返回 " + page.size()
+ " 条, 游标=" + page.nextCursor());
for (common.ecommerce.warehouse.model.InventorySnapshot s : page.items()) {
System.out.println(" sku=" + s.providerSku()
+ " avail=" + s.available()
+ " onHand=" + s.onHand()
+ " type=" + s.inventoryType()
+ " asOf=" + s.asOfUtc());
}
});
}
/** 结算明细:需要单号,没有就跳过。 */
@Test
void probeFeeDetail() {
assumeToken();
String saleOrderNo = System.getProperty("yqn.probe.saleOrderNo", "");
Assumptions.assumeTrue(!saleOrderNo.trim().isEmpty(),
"未提供 -Dyqn.probe.saleOrderNo,跳过结算明细探针");
run("POST /v1/warehouse/operation/costs/detail", () -> {
java.util.List<common.ecommerce.warehouse.model.BillingDocument> list =
adapter().settlements(ctx(),
common.ecommerce.warehouse.model.FeeQuery.builder()
.saleOrderNo(saleOrderNo).build());
System.out.println("[fees] 返回 " + list.size() + " 条");
for (common.ecommerce.warehouse.model.BillingDocument d : list) {
System.out.println(" name=" + d.feeName()
+ " type=" + d.feeType()
+ " amount=" + d.amount()
+ " estimated=" + d.estimated()
+ " settledAt=" + d.settledAt());
}
});
}
/** 出库单详情:只查,不下单。 */
@Test
void probeOutboundDetail() {
assumeToken();
String orderNo = System.getProperty("yqn.probe.outboundOrderNo", "");
Assumptions.assumeTrue(!orderNo.trim().isEmpty(),
"未提供 -Dyqn.probe.outboundOrderNo,跳过出库详情探针");
run("POST /v1/saleOrder/findOne", () -> {
common.ecommerce.warehouse.model.OutboundOrder order =
adapter().get(ctx(),
common.ecommerce.warehouse.model.OutboundRef.ofRequestNo(orderNo));
if (order == null) {
System.out.println("[outbound] 未找到该单");
return;
}
System.out.println("[outbound] status=" + order.status()
+ " rawStatus=" + order.rawStatus()
+ " tracking=" + order.trackingNumber()
+ " carrierCode=" + order.carrierCode()
+ " paidAt=" + order.paidAt()
+ " shippedAt=" + order.shippedAt());
System.out.println(" 行数=" + order.lines().size()
+ " 附件数=" + order.attachments().size()
+ " SN数=" + order.serialNumbers().size()
+ " signatureRequired=" + order.signatureRequired()
+ " insured=" + order.insured());
for (common.ecommerce.warehouse.model.OutboundLine l : order.lines()) {
System.out.println(" line sku=" + l.providerSku()
+ " qty=" + l.quantity()
+ " totalAmount=" + l.totalAmount()
+ " batchNos=" + l.batchNos()
+ " ordIds=" + l.platformOrderItemIds());
}
for (common.ecommerce.warehouse.model.WarehouseAttachment a : order.attachments()) {
System.out.println(" attach type=" + a.type() + " name=" + a.name() + " url=" + a.url());
}
});
}
/** 入库计划查询:只查,不创建。 */
@Test
void probeInboundPlan() {
assumeToken();
String orderNo = System.getProperty("yqn.probe.inboundOrderNo", "");
Assumptions.assumeTrue(!orderNo.trim().isEmpty(),
"未提供 -Dyqn.probe.inboundOrderNo,跳过入库计划探针");
run("POST /v1/inbound/getInboundPlanInfo", () -> {
common.ecommerce.warehouse.model.InboundOrder order =
adapter().get(ctx(), orderNo);
if (order == null) {
System.out.println("[inbound] 未找到该单");
return;
}
System.out.println("[inbound] status=" + order.status()
+ " planned=" + order.plannedQuantity()
+ " packed=" + order.packedQuantity()
+ " received=" + order.receivedQuantity()
+ " boxes=" + order.boxCount()
+ " containers=" + order.containers().size());
for (common.ecommerce.warehouse.model.InboundOrderBatch b : order.batches()) {
System.out.println(" batch phase=" + b.phase() + " carton=" + b.cartonNo()
+ " qty=" + b.quantity() + " invType=" + b.inventoryType());
}
});
}
/** 退货计划查询:验证明细行 id(API 77 的操作键)能否拿到。 */
@Test
void probeReturnPlan() {
assumeToken();
String orderNo = System.getProperty("yqn.probe.returnOrderNo", "");
Assumptions.assumeTrue(!orderNo.trim().isEmpty(),
"未提供 -Dyqn.probe.returnOrderNo,跳过退货计划探针");
run("POST /v3/saleReturn/getInboundPlanInfo", () -> {
common.ecommerce.warehouse.model.WarehouseReturn ret =
adapter().getReturn(ctx(), orderNo);
if (ret == null) {
System.out.println("[return] 未找到该单");
return;
}
System.out.println("[return] status=" + ret.status()
+ " rawStatus=" + ret.rawStatus()
+ " inspected=" + ret.inspectedQuantity()
+ " lines=" + ret.lines().size());
for (common.ecommerce.warehouse.model.WarehouseReturn.ReturnLine l : ret.lines()) {
System.out.println(" line id=" + l.lineId()
+ " sku=" + l.providerSku()
+ " qty=" + l.quantity()
+ " suggested=" + l.suggestedDisposition());
}
});
}
/** 物流轨迹:需要运单号。 */
@Test
void probeTracking() {
assumeToken();
String trackingNo = System.getProperty("yqn.probe.trackingNo", "");
Assumptions.assumeTrue(!trackingNo.trim().isEmpty(),
"未提供 -Dyqn.probe.trackingNo,跳过轨迹探针");
run("GET /api/v2/orderShipment/track/{trackingNo}", () -> {
common.ecommerce.warehouse.model.TrackingInfo info =
adapter().trackShipment(ctx(), trackingNo);
System.out.println("[tracking] status=" + info.status()
+ " carrier=" + info.carrier()
+ " signedBy=" + info.signedBy()
+ " events=" + info.events().size()
+ " parcelWeightG=" + info.parcelWeightGrams()
+ " parcelLenCm=" + info.parcelLengthCm()
+ " guaranteedDelivery=" + info.guaranteedDeliveryDate());
});
}
// ---------------------------------------------------------------- helpers
private static void assumeToken() {
Assumptions.assumeTrue(!TOKEN.trim().isEmpty(),
"未提供 -Dyqn.probe.token,跳过运去哪探针");
}
/** 探针异常只打印不抛出,方便一次跑完并对照真实报文。 */
private static void run(String api, Runnable r) {
System.out.println("\n================ yqn / " + api + " ================");
System.out.println("[probe] baseUrl=" + BASE_URL + " auxUrl=" + AUX_URL
+ " warehouse=" + WAREHOUSE_CODE + " token=" + mask());
try {
r.run();
System.out.println("[OK] " + api);
} catch (RuntimeException e) {
String msg = e.getMessage() == null ? e.getClass().getSimpleName() : e.getMessage();
System.out.println("[ERROR] " + e.getClass().getSimpleName() + ": "
+ (msg.length() <= 300 ? msg : msg.substring(0, 300) + "…"));
if (e instanceof ChannelException) {
ChannelException ce = (ChannelException) e;
System.out.println(" platformCode=" + ce.platformCode()
+ " platformRequestId=" + ce.platformRequestId()
+ " retryable=" + ce.retryable());
}
}
}
private static String mask() {
if (TOKEN.length() <= 6) {
return "***";
}
return TOKEN.substring(0, 4) + "***"
+ TOKEN.substring(TOKEN.length() - 2);
}
private static String opt(String name, String fallback) {
String value = System.getProperty(name, "");
if (value == null) {
return fallback;
}
String trimmed = value.trim();
return trimmed.isEmpty() ? fallback : trimmed;
}
}
Loading…
Cancel
Save