- 出入库记录(库存流水):新增 stock_records 表/模型/只读接口(列表 + 业务动作选项)与「出入库记录」菜单; 库存变动统一收敛到 app/utils/stockRecord.js#applyStockChange,与流水写入同事务(含变动前后总/锁定/可用数量) - 发货单:审核(1→2) 按明细锁定库存、发货确认(3→4) 扣减、推送失败退回/驳回/取消/作废释放(新增 stock_locked 列); 恢复(9→1) 时曾推送过的单据换号(WMS 取消后原单号仍被占用,沿用旧号重推会被判「订单已存在」) - 出库单:新增快递(express_code/express_name)、收件人(receiver_*) 与多运单号(express_codes) 字段; 推送报文补齐 logisticsCode/receiverInfo;新增出库单推送服务与定时任务 - 快递:多运单号回填、仓库快递映射(warehouse_express_mappings) 与快递字典补录等迁移 - 契约:补充出入库记录、出库单快递/收件人等定义(swagger.json 为本地生成、不入库)
59 lines
2.0 KiB
JavaScript
59 lines
2.0 KiB
JavaScript
'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,
|
||
};
|