'use strict'; /** * 回传平台店铺(shops 表:淘宝/抖音等)的同步状态口径(唯一来源) * * 用途:发货单(order_deliveries)完成后,把发货结果(运单号/发货状态等)回传平台店铺。 * 本阶段只落字段与状态机基线(迁移 20260915001500),实际回传链路(OMS → 平台)尚未实现, * 枚举供后续 service / schedule 与前端复用,避免各处再写一份数字。 * 落库字段:order_deliveries.shop_sync_status / shop_sync_retry_count(均为系统托管,接口不可传) * 注:入库单(inbound_orders)与出库单(outbound_orders)**不使用**该口径 —— * 入库单的库存由 OMS 侧自行管理、不涉及平台店铺回传。 */ const SHOP_SYNC_STATUS = { PENDING: 0, SYNCING: 1, SUCCESS: 2, FAILED: 3, }; /** 状态 → 中文标签 */ const SHOP_SYNC_STATUS_LABELS = { [SHOP_SYNC_STATUS.PENDING]: '未同步', [SHOP_SYNC_STATUS.SYNCING]: '同步中', [SHOP_SYNC_STATUS.SUCCESS]: '同步成功', [SHOP_SYNC_STATUS.FAILED]: '同步失败', }; /** 枚举列表(下拉/提示用,按状态值升序) */ const SHOP_SYNC_STATUS_LIST = Object.keys(SHOP_SYNC_STATUS_LABELS) .map(value => Number(value)) .sort((a, b) => a - b) .map(value => ({ value, label: SHOP_SYNC_STATUS_LABELS[value] })); /** * 判断是否为合法的同步状态值 * @param {*} value 原值 * @return {Boolean} 合法返回 true */ function isValidShopSyncStatus(value) { return Object.prototype.hasOwnProperty.call(SHOP_SYNC_STATUS_LABELS, Number(value)); } /** * 归一化同步状态值(非法值回退「未同步(0)」) * @param {*} value 原值 * @return {Number} 合法状态值 */ function normalizeShopSyncStatus(value) { return isValidShopSyncStatus(value) ? Number(value) : SHOP_SYNC_STATUS.PENDING; } module.exports = { SHOP_SYNC_STATUS, SHOP_SYNC_STATUS_LABELS, SHOP_SYNC_STATUS_LIST, isValidShopSyncStatus, normalizeShopSyncStatus, };