- 回调 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 等。
52 lines
2.1 KiB
JavaScript
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 应为秒级');
|
|
});
|
|
});
|