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.

83 lines
2.5 KiB

refactor(warehouse): 枚举下沉 core + 平台枚举分层映射 枚举原来散在各模型内部(OutboundStatus 嵌在 OutboundOrder 里、DealMethod 嵌在 ReturnCommand 里),且直接带仓方的数字码,导致 core 知道运去哪的协议值。改成两层: - 底层枚举(warehouse-sdk-core/enums):只含 SDK 自编稳定 code + 中文名, 不认识任何仓的码值。code 从 10 起按 10 递增、只追加不重排,落库用。 - 平台枚举(warehouse-sdk-yqn/enums):带仓方原始码,toCore() 映射到底层。 运去哪出库状态是自由文本(无码表),按关键字收敛;其余按文档码表 1:1。 Mapper 里 9 个散落的 switch 全部删除,改为一行 of(raw).toCore()。 顺带修两处会误导下游的问题: - OutboundStatus 缺 UNKNOWN,认不出的状态被兜底成 SUBMITTED(已下发)。 补 UNKNOWN(0, rank=-1),认不出归它;对应测试断言一并修正, 新增 unknownStatusIsNotGuessed 覆盖 null / 空串 / 未知值。 - InboundOrder / TransferOrder / WarehouseReturn / BillingDocument 缺 sourceProvider,rawStatus 无法解释(同一数字在不同仓含义不同)。补上字段, 运去哪的 Mapper 全部标注 YQN。 落库契约写进 WarehouseSink:rawStatus 必须与 sourceProvider 成对保存, 它是映射调整后唯一能重跑、修正历史数据的依据。 删除 WarehouseEnum 接口——在该规模下各枚举自带 code()/label()/ofCode() 足够, 不引入额外抽象。合并 ReturnDisposition 到 ReturnProcessDisposition(后者加 UNKNOWN),退货只保留「预约预报」与「检验后决定」两套语义。 Co-Authored-By: Claude <noreply@anthropic.com>
2 weeks ago
package common.ecommerce.yqn.enums;
import common.ecommerce.warehouse.enums.TransferStatus;
/**
* 运去哪调拨单状态(API 139 的 {@code transferOutboundPlanStatus})。
*
* <p>码表来自接口文档,1:1 对应;未知码归 {@link #UNKNOWN},不猜。</p>
*/
public enum YqnTransferStatus {
/** 0 草稿。 */
DRAFT(0, TransferStatus.DRAFT),
/** 3 已驳回。 */
REJECTED(3, TransferStatus.REJECTED),
/** 5 待审核。 */
PENDING_REVIEW(5, TransferStatus.PENDING_REVIEW),
/** 6 审核中。 */
REVIEWING(6, TransferStatus.REVIEWING),
/** 7 审核通过。 */
APPROVED(7, TransferStatus.APPROVED),
/** 8 待确认。 */
PENDING_CONFIRM(8, TransferStatus.PENDING_CONFIRM),
/** 9 待备货。 */
PENDING_PICKING(9, TransferStatus.PENDING_PICKING),
/** 10 待出库。 */
PENDING_OUTBOUND(10, TransferStatus.PENDING_OUTBOUND),
/** 15 出库中。 */
OUTBOUNDING(15, TransferStatus.OUTBOUNDING),
/** 20 待入库。 */
PENDING_INBOUND(20, TransferStatus.PENDING_INBOUND),
/** 25 入库中。 */
INBOUNDING(25, TransferStatus.INBOUNDING),
/** 70 已完成。 */
COMPLETED(70, TransferStatus.COMPLETED),
/** 90 已关闭。 */
CLOSED(90, TransferStatus.CLOSED),
/** 100 取消中。 */
CANCELLING(100, TransferStatus.CANCELLING),
/** 110 已取消。 */
CANCELLED(110, TransferStatus.CANCELLED),
/** 120 取消异常。 */
CANCEL_EXCEPTION(120, TransferStatus.CANCEL_EXCEPTION),
/** 无法识别。 */
UNKNOWN(null, TransferStatus.UNKNOWN);
private final Integer rawCode;
private final TransferStatus core;
YqnTransferStatus(Integer rawCode, TransferStatus core) {
this.rawCode = rawCode;
this.core = core;
}
/** 运去哪的状态码;null 表示无法识别。 */
public Integer rawCode() {
return rawCode;
}
/** 对应的底层状态。 */
public TransferStatus toCore() {
return core;
}
/** 运去哪状态码 → 平台枚举。 */
public static YqnTransferStatus of(Integer rawStatus) {
if (rawStatus == null) {
return UNKNOWN;
}
for (YqnTransferStatus v : values()) {
if (rawStatus.equals(v.rawCode)) {
return v;
}
}
return UNKNOWN;
}
/** 运去哪状态码 → 底层状态。 */
public static TransferStatus toCore(Integer rawStatus) {
return of(rawStatus).toCore();
}
}