WMS_MAIN/test/app/service/openapiMethods/order.cancel.test.js
liufumingren d725e7e457 feat(openapi): 出站回调命名与报文改奇门同层级
- 回调 method 由 snake_case 事件名改为 模块.动作:entryorder.confirm / entryorder.match / deliveryorder.confirm / stockout.confirm / deliveryorder.cancel(原 order.cancel 与入站方法同名,改名避免 callback_url 误指向 /openapi 时被路由到取消单据接口)。

- 时间戳统一为秒级(String(Math.floor(Date.now()/1000))),与 /openapi 入站 ±600 秒时效校验及回调调试页一致。

- 报文体由 { event, data, metadata } 改为奇门同层级 { request: {...} }(移除 metadata,事件标识只靠 query 的 method);入库类回调与奇门侧共用同一份报文组装。

- deliveryorder.confirm 改为逐单发送(仅同步成功的订单);stockout.confirm 直接复用 buildStockoutConfirmDataInternal 结果。

- 修复 entryorder.match 死代码:绑定成功且本次新建绑定时回传,重复触发不重复通知,回传失败不影响绑定。

- 调试页 /docs/api/openapi/callback-test 按真实报文预填;新增出站回调文档页 /docs/api/openapi_callback 及入口链接。

- script/update-api-doc.cjs 支持 spec.newDoc 新建文档与 docMeta.description(附单测)。

- 文档:methods/openapi_callback.json、AI_METHOD_ROUTING.md 5.6 节、docs/openapi-callback-events.md、docs/api-doc-update-workflow.md 等。
2026-09-13 02:24:37 +08:00

180 lines
4.4 KiB
JavaScript
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

'use strict';
const assert = require('node:assert/strict');
const OpenapiOrderService = require('../../../../app/service/openapiMethods/order');
/**
* 创建 openapi order.cancel 测试桩(纯桩,不访问真实数据库)。
*
* @param {Object} [options] 可选配置。
* @param {Function} [options.onSendByAppKey] OpenAPI 回调桩实现。
* @param {Object} [options.existingOrder] 已存在订单记录(raw)。
* @return {Object} 服务实例与回调调用记录。
*/
function createHarness(options = {}) {
const callbackCalls = [];
const ctx = {
app: {
config: {},
Sequelize: {
Op: {
ne: Symbol('ne'),
},
},
},
model: {
async transaction() {
return {
LOCK: { UPDATE: Symbol('UPDATE') },
async rollback() {
return undefined;
},
async commit() {
return undefined;
},
};
},
OrderDeliveryFactory: {
async getCurrentModel() {
return {
async findOne() {
return {
...(options.existingOrder || {
id: 9001,
delivery_order_code: 'DO-CANCEL-1',
warehouse_id: 100000,
store_id: 1000000,
pick_status: 'none',
print_status: 'none',
wave_id: 0,
inspection_status: 'none',
weighing_weight: 0,
intercept_time: null,
}),
async update() {
return [ 1 ];
},
};
},
async update() {
return [ 1 ];
},
};
},
},
OrderItemsFactory: {
async getCurrentModel() {
return {
async findAll() {
return [];
},
};
},
},
Picking: {
async findAll() {
return [];
},
},
OperationLog: {
async create() {
return {};
},
},
},
service: {
openapi: {
callback: {
async sendByAppKey(callOptions) {
callbackCalls.push(callOptions);
if (typeof options.onSendByAppKey === 'function') {
return await options.onSendByAppKey(callOptions);
}
return { success: true };
},
},
},
systemMethods: {
order: {
wave: {
async deleteOrderWaveIndexByOrderIds() {
return undefined;
},
async replaceOrderWaveIndexByWaveIds() {
return undefined;
},
},
},
},
systems: {
afterSale: {
async createInterceptWorkOrdersAndNotify() {
return undefined;
},
},
},
},
user: {},
logger: {
info() {},
warn() {},
error() {},
},
};
const service = new OpenapiOrderService(ctx);
service.setInfo(1000000, 100000, 'APP-KEY-C', null, 'WH-100');
return { service, callbackCalls };
}
describe('test/app/service/openapiMethods/order.cancel.test.js', () => {
it('取消成功应发送 deliveryorder.cancel 回调,request.deliveryOrder 按约定组装', async () => {
const { service, callbackCalls } = createHarness();
const result = await service.cancel({
body: {
orderCode: ' DO-CANCEL-1 ',
orderType: 'jyck',
},
query: {},
});
assert.equal(result.flag, 'success');
assert.equal(callbackCalls.length, 1);
const call = callbackCalls[0];
assert.equal(call.event, 'deliveryorder.cancel');
assert.equal(call.appKey, 'APP-KEY-C');
assert.equal(call.data, undefined);
assert.equal(call.metadata, undefined);
assert.deepEqual(call.request, {
deliveryOrder: {
deliveryOrderCode: 'DO-CANCEL-1',
orderType: 'JYCK',
status: 'CANCELED',
},
});
});
it('回调发送失败不应影响取消主流程(fire-and-forget)', async () => {
const { service } = createHarness({
onSendByAppKey() {
throw new Error('callback down');
},
});
const result = await service.cancel({
body: {
orderCode: 'DO-CANCEL-1',
orderType: 'JYCK',
},
query: {},
});
assert.equal(result.flag, 'success');
});
});