- 出入库记录(库存流水):新增 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 为本地生成、不入库)
36 lines
1.3 KiB
JavaScript
36 lines
1.3 KiB
JavaScript
'use strict';
|
||
|
||
/**
|
||
* 出库单推送队列:每 30 秒扫描「已审核(2)」的单据并递交 WMS(stockout.create)
|
||
*
|
||
* 说明(与发货单 app/schedule/orderDeliveryPush.js 同口径):
|
||
* - 审核只入队(1→2),由本定时任务异步推送,避免集中审核时把对方服务打满
|
||
* - 单条失败处理见 app/service/outboundOrderPush.js:对方明确失败 / 库存锁定失败立即退回「待出库(1)」
|
||
* (并释放锁定库存、冲正外部单据);无响应/超时最多尝试 3 次(每次间隔 >= 20s),
|
||
* 仍未成功同样退回「待出库(1)」并释放锁定库存
|
||
* - 并发安全:服务层用 pushed_at 做乐观锁抢占,多 worker 下同一单只推一次
|
||
*/
|
||
module.exports = {
|
||
schedule: {
|
||
interval: '30s',
|
||
type: 'worker',
|
||
immediate: false,
|
||
disable: false,
|
||
},
|
||
|
||
/**
|
||
* 扫描并推送待推送出库单
|
||
* @param {Egg.Context} ctx egg context(定时任务上下文)
|
||
* @return {Promise<Object>} 本轮统计
|
||
*/
|
||
async task(ctx) {
|
||
const stat = await ctx.service.outboundOrderPush.processPending();
|
||
if (stat.scanned > 0) {
|
||
ctx.logger.info(
|
||
`[outbound-push] 本轮扫描 ${stat.scanned} 条:成功 ${stat.pushed},失败 ${stat.failed},待重试 ${stat.retry},跳过 ${stat.skipped}`
|
||
);
|
||
}
|
||
return stat;
|
||
},
|
||
};
|