WMS_MAIN/test/app/controller/openapiCallback.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

52 lines
2.1 KiB
JavaScript

'use strict';
const assert = require('node:assert/strict');
const OpenapiCallbackController = require('../../../app/controller/openapiCallback');
/**
* 创建回调调试页控制器纯桩实例。
* @return {Object} 控制器实例(含 ctx 桩)。
*/
function createController() {
const controller = Object.create(OpenapiCallbackController.prototype);
controller.ctx = { type: null, body: null };
return controller;
}
describe('test/app/controller/openapiCallback.test.js', () => {
it('调试页应输出完整报文体模板(奇门同层级 { request },可编辑)', async () => {
const controller = createController();
await controller.testPage();
assert.equal(controller.ctx.type, 'text/html; charset=utf-8');
assert.ok(typeof controller.ctx.body === 'string', '应返回 HTML 字符串');
const html = controller.ctx.body;
// 文案与出站回调文档入口链接
assert.ok(html.includes('完整报文体(奇门同层级 { request },与真实回调一致,可编辑)'), '应包含完整报文体标签文案');
assert.ok(html.includes('/docs/api/openapi_callback'), '应包含出站回调文档入口链接');
// 事件切换时自动填充 { request } 一层包装结构(奇门同层级)
assert.ok(html.includes('request: found.request || {}'), '模板应包含 request 字段');
assert.ok(!html.includes('event: found.name'), '模板不应再包含 event 外层字段');
assert.ok(!html.includes('data: found.sampleData'), '模板不应再包含 data 外层字段');
assert.ok(!html.includes('metadata: found.metadata'), '模板不应再包含 metadata 外层字段');
// 注册表 5 个事件名均注入页面
for (const name of [
'entryorder.confirm',
'entryorder.match',
'deliveryorder.confirm',
'stockout.confirm',
'deliveryorder.cancel',
]) {
assert.ok(html.includes(name), `页面应包含事件名 ${name}`);
}
// 页面仍为秒级时间戳(与发送侧统一)
assert.ok(html.includes('Math.floor(Date.now() / 1000)'), '调试页 timestamp 应为秒级');
});
});