- 回调 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 等。
180 lines
4.4 KiB
JavaScript
180 lines
4.4 KiB
JavaScript
'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');
|
||
});
|
||
});
|