Browse Source

docs(lingxing): 标注快速出库为写操作,验证阶段禁止调用

领星无测试环境,出库会真实改变数据:
- LingxingApi.FAST_OUTBOUND 注释标明写操作,禁止验证
- MultiPlatformOutboundSource 类注释与 submit 方法注释同步标注
- FAST_OUTBOUND_RESULT 注明只读、可安全验证

约定已记入项目记忆:领星验证只做查询。

Co-Authored-By: Claude <noreply@anthropic.com>
feature/supplier-lingxing
chenchuchuan 2 weeks ago
parent
commit
8596e34936
  1. 8
      lingxing/src/main/java/common/ecommerce/lingxing/LingxingApi.java
  2. 5
      lingxing/src/main/java/common/ecommerce/lingxing/platform/multiplatform/outbound/MultiPlatformOutboundSource.java

8
lingxing/src/main/java/common/ecommerce/lingxing/LingxingApi.java

@ -88,10 +88,14 @@ public enum LingxingApi {
/** 亚马逊结算中心交易明细。POST,offset/length 分页,上限 10000。 */ /** 亚马逊结算中心交易明细。POST,offset/length 分页,上限 10000。 */
SETTLEMENT_TRANSACTION_LIST("/bd/sp/api/open/settlement/transaction/detail/list", 10), SETTLEMENT_TRANSACTION_LIST("/bd/sp/api/open/settlement/transaction/detail/list", 10),
/** 快速出库(创建异步出库任务)。POST,qps 10,多平台通用。 */ /**
* 快速出库(创建异步出库任务)。POST,qps 10,多平台通用。
*
* <p><b>写操作</b>:会改变领星侧数据。领星无测试环境,禁止在验证阶段调用。</p>
*/
FAST_OUTBOUND("/pb/mp/order/v2/fastOutbound", 10), FAST_OUTBOUND("/pb/mp/order/v2/fastOutbound", 10),
/** 快速出库结果查询。POST,qps 10,多平台通用。 */ /** 快速出库结果查询。POST,qps 10,多平台通用。只读,可安全验证。 */
FAST_OUTBOUND_RESULT("/pb/mp/order/v2/getFastOutboundResult", 10), FAST_OUTBOUND_RESULT("/pb/mp/order/v2/getFastOutboundResult", 10),
/** 多平台订单列表;当前实现使用的跨平台接口。 */ /** 多平台订单列表;当前实现使用的跨平台接口。 */

5
lingxing/src/main/java/common/ecommerce/lingxing/platform/multiplatform/outbound/MultiPlatformOutboundSource.java

@ -27,6 +27,10 @@ import java.util.Map;
* </ul> * </ul>
* *
* <p>两个接口的令牌桶都是 10 req/s。</p> * <p>两个接口的令牌桶都是 10 req/s。</p>
*
* <p><b>验证限制</b>:{@link #submit} 会真实创建出库任务、改变领星数据,
* 而领星没有测试环境,因此<b>不得</b>用于联调验证;
* {@link #results} 是只读查询,可安全调用。</p>
*/ */
public final class MultiPlatformOutboundSource implements LingxingOutboundSource { public final class MultiPlatformOutboundSource implements LingxingOutboundSource {
@ -36,6 +40,7 @@ public final class MultiPlatformOutboundSource implements LingxingOutboundSource
private static final String OP_SUBMIT = "outbound.submit"; private static final String OP_SUBMIT = "outbound.submit";
private static final String OP_RESULTS = "outbound.results"; private static final String OP_RESULTS = "outbound.results";
/** 提交出库任务。<b>写操作</b>,会改变领星数据,验证阶段禁止调用。 */
@Override @Override
public boolean submit(LingxingCall call, List<OutboundPackage> packages) { public boolean submit(LingxingCall call, List<OutboundPackage> packages) {
if (packages == null || packages.isEmpty()) { if (packages == null || packages.isEmpty()) {

Loading…
Cancel
Save