fix(finance): 收敛内部 SKU 履约路由与载体状态
统一内部 SKU 与渠道主/兜底解析,禁止并列主渠道。 运营指定渠道改为先创建真实载体,失败保持明确 pending。 历史缺载体、多载体冲突和自动发货兜底统一由管道修复。 迁移人工配置与旧 sku_code 规则,补充严格预检和集成测试。
This commit is contained in:
@@ -0,0 +1,61 @@
|
||||
import type { FulfillmentChannel } from './channel-types.js'
|
||||
|
||||
type JsonObject = Record<string, unknown>
|
||||
|
||||
export type InternalSkuResolverInput = {
|
||||
manualSkuKey?: unknown
|
||||
skuCode?: unknown
|
||||
skuName?: unknown
|
||||
spec?: unknown
|
||||
snapshot?: unknown
|
||||
}
|
||||
|
||||
function asObject(value: unknown): JsonObject {
|
||||
return value && typeof value === 'object' && !Array.isArray(value) ? (value as JsonObject) : {}
|
||||
}
|
||||
|
||||
export function normalizeInternalSku(value: unknown): string {
|
||||
return String(value ?? '').trim()
|
||||
}
|
||||
|
||||
export function containsCjk(value: string): boolean {
|
||||
return /[\u4e00-\u9fa5]/.test(value)
|
||||
}
|
||||
|
||||
/**
|
||||
* 内部 SKU 的唯一解析口径。
|
||||
*
|
||||
* 1. 入口显式写入的 snapshot.internalSku 最权威;
|
||||
* 2. 旧数据优先使用中文键,避免纯数字平台码压过中文 skuNick/sku_name;
|
||||
* 3. 没有中文时按生成列的历史顺序回退。
|
||||
*/
|
||||
export function resolveInternalSkuKey(input: InternalSkuResolverInput): string {
|
||||
const snapshot = asObject(input.snapshot)
|
||||
const spec = asObject(input.spec)
|
||||
const explicit = normalizeInternalSku(snapshot.internalSku)
|
||||
if (explicit) return explicit
|
||||
|
||||
const manual = normalizeInternalSku(input.manualSkuKey)
|
||||
const skuNick = normalizeInternalSku(spec.skuNick)
|
||||
const outSkuSn = normalizeInternalSku(spec.outSkuSn)
|
||||
const skuCode = normalizeInternalSku(input.skuCode)
|
||||
const skuName = normalizeInternalSku(input.skuName)
|
||||
|
||||
return (
|
||||
[manual, skuNick, outSkuSn, skuName].find((value) => value && containsCjk(value)) ||
|
||||
[manual, skuNick, outSkuSn, skuCode, skuName].find(Boolean) ||
|
||||
''
|
||||
)
|
||||
}
|
||||
|
||||
/** 渠道选择里使用的稳定顺序,仅用于同优先级时生成诊断,不用于静默改渠道。 */
|
||||
export const INTERNAL_SKU_CHANNEL_ORDER: readonly FulfillmentChannel[] = [
|
||||
'affiliate_dash',
|
||||
'work_order',
|
||||
'third_party_voucher',
|
||||
'manual',
|
||||
]
|
||||
|
||||
export function compareFulfillmentChannel(a: FulfillmentChannel, b: FulfillmentChannel): number {
|
||||
return INTERNAL_SKU_CHANNEL_ORDER.indexOf(a) - INTERNAL_SKU_CHANNEL_ORDER.indexOf(b)
|
||||
}
|
||||
Reference in New Issue
Block a user