WMS_MAIN/app/router.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

74 lines
2.6 KiB
JavaScript

/**
* @param {Egg.Application} app - egg application
*/
module.exports = app => {
const { router, controller } = app;
router.get('/', controller.home.index);
router.get('/auth/platformOauthCallback', controller.home.platformOauthCallback);
router.get('/auth/platformOauthBind', controller.home.platformOauthBind);
router.get('/query/pddCode/:code', controller.home.queryPddCode);
// 内部网关接口
router.post('/internal/v1/gateway', controller.gateway.internal);
// 奇门接口
router.post('/qimen', controller.home.qimen);
// 系统接口 PDA/WEB 统一入口
router.post('/system', controller.home.system);
// 仅开发环境可访问的内部api文档
if (app.config.env === 'local') {
// api文档相关
router.get('/api/docs', controller.docs.list);
router.get('/api/docs/:docName/raw', controller.docs.raw);
router.get('/api/docs/:docName/changes', controller.docs.changes);
router.get('/api/docs/:docName', controller.docs.detail);
// 独立 docs 目录挂载 — 首页
router.get('/docs', controller.docs.docsIndex);
}
// OpenAPI 文档 — 所有环境均可访问,必须在通配路由之前注册
router.get('/docs/api/openapi', controller.docs.openapi);
// Warehouse 开放 API 文档 — 所有环境均可访问
router.get('/docs/api/warehouse', controller.docs.warehouse);
// OpenAPI 回调测试 — 所有环境均可访问的独立调试页面
router.get('/docs/api/openapi/callback-test', controller.openapiCallback.testPage);
// OpenAPI 出站回调文档 — 所有环境均可访问
router.get('/docs/api/openapi_callback', controller.docs.openapiCallbackEvents);
// 仅开发环境可访问的 docs 通配路由(静态文件),必须在 /docs/api/openapi 之后注册
if (app.config.env === 'local') {
router.get('/docs/:relPath(.*)', controller.docs.docsFile);
}
// OpenAPI 入口
router.post('/openapi', controller.openapi.index);
// 仓库 OpenAPI 入口
router.post('/warehouse', controller.warehouse.index);
// 打印模板
router.get('/template/xml/:id', controller.template.xml);
// 打印自定义区模板(抖音面单等)
router.get('/mb/douyin1.xml', controller.template.douyinCustomArea);
// 打印台设置
router.get('/auth/printSetting/:code', controller.auth.printerSetting);
router.post('/auth/printSetting/', controller.auth.printerSetting);
// 临时 fileWriter 消费入口
router.get('/__temp/file-writer/consume', controller.tempFileWriter.consume);
// 测试接口
router.get('/testSendData', controller.home.testSendData);
// IM交互入口
router.post('/im', controller.im.index);
};