From 0ffe290a211229788cb73328cfd386956fb04554 Mon Sep 17 00:00:00 2001 From: liufumingren Date: Mon, 27 Apr 2026 15:57:29 +0800 Subject: [PATCH] chore: commit all current workspace changes --- .github/agents/文档.agent.md | 1 + .github/agents/调度.agent.md | 2 +- app.js | 5 +- app/controller/docs.js | 468 +++- app/controller/openapi.js | 56 + app/extend/application.js | 28 + app/lib/api_sign.js | 193 ++ app/lib/file_writer.js | 79 +- app/lib/order_delivery_selfcheck.js | 19 - app/lib/polo_api_client.js | 73 +- app/lib/qimen_client.js | 216 ++ app/model/express.js | 14 +- app/model/express_interface.js | 56 +- app/model/express_platform.js | 75 - app/model/express_setting.js | 11 +- app/model/notification_webhook.js | 1 + app/model/operation_log.js | 7 +- app/model/order_delivery.js | 66 +- app/model/order_delivery_factory.js | 21 +- app/model/order_delivery_table_schema.js | 4 +- app/model/order_express.js | 27 +- app/model/order_items_factory.js | 2 +- app/model/platform.js | 55 +- app/model/store_warehouse.js | 97 +- .../store_warehouse_print_quantity_log.js | 11 +- app/router.js | 3 + app/service/apiMethods/test.js | 4 +- app/service/openapi.js | 238 +++ app/service/openapiMethods/index.js | 35 + app/service/openapiMethods/ping.js | 23 + app/service/systemMethods/index.js | 28 +- app/service/systemMethods/order/base.js | 89 +- .../systemMethods/order/expectionOrder.js | 68 +- app/service/systemMethods/order/index.js | 38 +- .../systemMethods/order/pendingOrder.js | 1045 ++++++++- .../systemMethods/order/storageAllocation.js | 46 +- app/service/systemMethods/setting/express.js | 75 +- .../systemMethods/setting/expressInterface.js | 26 +- app/service/systemMethods/setting/platform.js | 53 +- app/service/systems/api_sign.js | 144 ++ app/service/systems/delivery_order.js | 235 +- app/service/systems/entry_order.js | 4 +- app/service/systems/express.js | 1599 +++++++++++++- app/service/systems/express_platform.js | 580 +++++ app/service/systems/operation_log.js | 151 +- app/service/systems/order_async.js | 1122 ++++++++++ .../systems/order_delivery_migration.js | 12 +- .../systems/order_pending_exception.js | 25 + .../systems/order_storage_allocation.js | 1431 ++++++++++++- app/service/systems/platform.js | 156 +- app/service/systems/polo_api.js | 18 + app/service/systems/print/printData.js | 25 + app/service/systems/qimen_query.js | 192 +- app/service/systems/setting/express.js | 248 ++- .../systems/setting/expressInterface.js | 399 +++- app/service/systems/setting/platform.js | 194 +- app/service/systems/stock_store.js | 204 +- app/service/systems/storage/index.js | 105 +- app/service/systems/storage/receiving.js | 256 ++- app/service/systems/store_warehouse.js | 95 + app/service/systems/upload.js | 14 +- config/config.default.js | 1 + ...0-add-deleted-at-to-wms-express-setting.js | 63 + ...dd-weight-type-to-order-delivery-tables.js | 108 + ...ag-to-longtext-on-order-delivery-tables.js | 93 + ...ce-order-codes-to-order-delivery-tables.js | 107 + docs/file-writer.md | 3 + methods/changes/openapi.json | 63 + methods/changes/system.json | 1705 ++++++++------- methods/openapi.json | 160 ++ methods/system.json | 1884 ++++++++++++++++- .../file-writer/.write-window-counter-3.json | 2 +- .../qimen-logs-MINGREN-worker-p4496-0001.log | 2 - ...en-logs-MINGREN-worker-p4496-0001.log.done | 7 - .../qimen-logs-MINGREN-worker-p38224-0001.log | 1 - ...n-logs-MINGREN-worker-p38224-0001.log.done | 7 - .../qimen-logs-MINGREN-worker-p41276-0001.log | 4 - .../qimen-logs-MINGREN-worker-p42648-0001.log | 1 - ...n-logs-MINGREN-worker-p42648-0001.log.done | 7 - .../qimen-logs-MINGREN-worker-p35616-0001.log | 1 + temp_calculate_sign.js | 59 + temp_check_json.js | 16 +- temp_count_brackets.js | 32 +- temp_debug_headers.js | 10 +- temp_find_headers_close.js | 28 +- temp_find_missing_commas.js | 2 +- temp_find_objsep.js | 2 +- temp_find_trailing_commas.js | 2 +- temp_rebuild_system_json.js | 54 +- test/app/controller/docs.test.js | 38 + test/app/controller/openapi.test.js | 326 +++ .../system.order.namespaced.test.js | 2 + .../system.order.reviewOrder.test.js | 2 + .../system.setting.storeWarehouse.test.js | 4 + test/app/extend/application.cache.test.js | 36 + test/app/lib/api_sign.test.js | 131 ++ test/app/lib/file_writer.test.js | 87 + test/app/lib/order_delivery_selfcheck.test.js | 24 - test/app/lib/qimen_client.test.js | 92 + .../order_delivery_factory_selfcheck.test.js | 225 +- test/app/service/openapi.test.js | 300 +++ .../systemMethods/order.base.step.test.js | 5 + .../pendingOrder.allocateExpressCode.test.js | 171 ++ .../pendingOrder.allocateStorage.test.js | 165 ++ .../order/queryOrderLogs.test.js | 71 + .../order/storageAllocation.test.js | 53 +- .../systemMethods/setting/express.test.js | 57 + .../setting/expressInterface.test.js | 53 +- .../systemMethods/setting/platform.test.js | 20 +- test/app/service/systems/api_sign.test.js | 181 ++ .../systems/delivery_order.addOrder.test.js | 241 +++ .../delivery_order.auditStatus.test.js | 72 +- .../systems/express.async_dispatch.test.js | 264 +++ .../express.createWaybillCode.balance.test.js | 909 ++++++++ test/app/service/systems/express.test.js | 356 +++- .../systems/express_platform.polyapi.test.js | 429 ++++ .../operation_log.queryOrderLogs.test.js | 109 + .../systems/order_async.syncOrderIds.test.js | 905 ++++++++ .../systems/order_delivery_migration.test.js | 42 +- .../systems/order_pending_exception.test.js | 84 + .../systems/order_storage_allocation.test.js | 273 ++- test/app/service/systems/platform.test.js | 129 +- .../service/systems/setting/express.test.js | 127 +- .../systems/setting/expressInterface.test.js | 346 ++- .../service/systems/setting/platform.test.js | 77 +- ...8-1954-business_key数组语义回归测试报告.md | 40 + 126 files changed, 19463 insertions(+), 1974 deletions(-) create mode 100644 app/controller/openapi.js create mode 100644 app/lib/api_sign.js delete mode 100644 app/lib/order_delivery_selfcheck.js create mode 100644 app/lib/qimen_client.js delete mode 100644 app/model/express_platform.js create mode 100644 app/service/openapi.js create mode 100644 app/service/openapiMethods/index.js create mode 100644 app/service/openapiMethods/ping.js create mode 100644 app/service/systems/api_sign.js create mode 100644 app/service/systems/express_platform.js create mode 100644 app/service/systems/order_async.js create mode 100644 app/service/systems/print/printData.js create mode 100644 database/migrations/20260417153000-add-deleted-at-to-wms-express-setting.js create mode 100644 database/migrations/20260419102000-add-weight-type-to-order-delivery-tables.js create mode 100644 database/migrations/20260420101000-alter-order-flag-to-longtext-on-order-delivery-tables.js create mode 100644 database/migrations/20260420112000-add-source-order-codes-to-order-delivery-tables.js create mode 100644 methods/changes/openapi.json create mode 100644 methods/openapi.json delete mode 100644 runtime/file-writer/qimen-logs/2026/04/10/qimen-logs-MINGREN-worker-p4496-0001.log delete mode 100644 runtime/file-writer/qimen-logs/2026/04/10/qimen-logs-MINGREN-worker-p4496-0001.log.done delete mode 100644 runtime/file-writer/qimen-logs/2026/04/12/qimen-logs-MINGREN-worker-p38224-0001.log delete mode 100644 runtime/file-writer/qimen-logs/2026/04/12/qimen-logs-MINGREN-worker-p38224-0001.log.done delete mode 100644 runtime/file-writer/qimen-logs/2026/04/12/qimen-logs-MINGREN-worker-p41276-0001.log delete mode 100644 runtime/file-writer/qimen-logs/2026/04/12/qimen-logs-MINGREN-worker-p42648-0001.log delete mode 100644 runtime/file-writer/qimen-logs/2026/04/12/qimen-logs-MINGREN-worker-p42648-0001.log.done create mode 100644 runtime/file-writer/qimen-logs/2026/04/26/qimen-logs-MINGREN-worker-p35616-0001.log create mode 100644 temp_calculate_sign.js create mode 100644 test/app/controller/openapi.test.js create mode 100644 test/app/lib/api_sign.test.js delete mode 100644 test/app/lib/order_delivery_selfcheck.test.js create mode 100644 test/app/lib/qimen_client.test.js create mode 100644 test/app/service/openapi.test.js create mode 100644 test/app/service/systemMethods/order/pendingOrder.allocateExpressCode.test.js create mode 100644 test/app/service/systemMethods/order/pendingOrder.allocateStorage.test.js create mode 100644 test/app/service/systemMethods/order/queryOrderLogs.test.js create mode 100644 test/app/service/systems/api_sign.test.js create mode 100644 test/app/service/systems/delivery_order.addOrder.test.js create mode 100644 test/app/service/systems/express.async_dispatch.test.js create mode 100644 test/app/service/systems/express.createWaybillCode.balance.test.js create mode 100644 test/app/service/systems/express_platform.polyapi.test.js create mode 100644 test/app/service/systems/operation_log.queryOrderLogs.test.js create mode 100644 test/app/service/systems/order_async.syncOrderIds.test.js create mode 100644 test_reports/pass/20260418-1954-business_key数组语义回归测试报告.md diff --git a/.github/agents/文档.agent.md b/.github/agents/文档.agent.md index 7ca1a5e..6f37e86 100644 --- a/.github/agents/文档.agent.md +++ b/.github/agents/文档.agent.md @@ -63,6 +63,7 @@ node .\script\tmp-struct-system-params.cjs ## 推荐工作流 1. 先定位代码真实实现与调用链 +2. 在temp/apiDoc/目录下先备份对应的时间的json文档方便后续对比和回档,自动归档人工回档都在这个目录下进行 2. 如 system 入参结构变化,可先执行 `node .\script\tmp-struct-system-params.cjs` 3. 按 `docs/api-doc-update-workflow.md` 生成固定 spec JSON 4. 先执行 `npm run doc:api:update -- --spec= --dry-run` diff --git a/.github/agents/调度.agent.md b/.github/agents/调度.agent.md index c669667..82a1f3c 100644 --- a/.github/agents/调度.agent.md +++ b/.github/agents/调度.agent.md @@ -3,7 +3,7 @@ name: wms-dispatcher-agent description: "Use when the user asks about 任务委派、任务分派、调度、router、triage、多领域排障、不确定该找哪个 agent,或需要把问题分给 数据库/Redis/发布/开发/测试/文档 等模块。专用于 WMS 任务分诊与委派。" argument-hint: "描述你的目标或问题,例如:帮我判断这是数据库、测试还是缓存问题并分派、这个线上异常该交给谁处理。" tools: ['read', 'search', 'agent', 'todo'] -model: GPT-5.4 mini (copilot) +model: Claude Opus 4.6 (copilot) --- # WMS 调度代理(`wms-dispatcher-agent`) diff --git a/app.js b/app.js index 2a567d4..94f2416 100644 --- a/app.js +++ b/app.js @@ -1,7 +1,7 @@ // app.js const path = require('path'); const LocalFileWriter = require('./app/lib/file_writer'); -const ensureOrderDeliverySelfCheck = require('./app/lib/order_delivery_selfcheck'); +const QimenClient = require('./app/lib/qimen_client'); /** * 挂载应用级扩展能力。 @@ -13,8 +13,10 @@ module.exports = app => { global.APP_ROOT = path.resolve(__dirname, './'); app.appRoot = global.APP_ROOT; app.fileWriter = new LocalFileWriter(app); + app.qimenClient = new QimenClient(app); app.logger.info('✅ Application 扩展能力已加载'); app.logger.info('✅ fileWriter 已挂载到 app.fileWriter'); + app.logger.info('✅ qimenClient 已挂载到 app.qimenClient'); // 初始化工厂 app.beforeStart(async () => { const OrderDeliveryFactory = require('./app/model/order_delivery_factory'); @@ -32,7 +34,6 @@ module.exports = app => { app.OrderItemsFactory = OrderItemsFactory(app); app.model.OrderItemsFactory = app.OrderItemsFactory; app.logger.info('✅ 工厂类初始化完成'); - // await ensureOrderDeliverySelfCheck(app); } catch (error) { app.logger.error('❌ 工厂类初始化失败:', error); } diff --git a/app/controller/docs.js b/app/controller/docs.js index b0a247d..3958a9e 100644 --- a/app/controller/docs.js +++ b/app/controller/docs.js @@ -443,6 +443,28 @@ function normalizeGroups(docData) { return []; } +/** + * 解析文档对应的统一入口路径,优先使用文档内声明的 http.path。 + * @param {object} docData 文档 JSON 数据。 + * @return {string} 统一入口路径。 + */ +function resolveDocEntryPath(docData) { + const httpPath = String(docData?.http?.path || '').trim(); + if (httpPath.startsWith('/')) { + return httpPath; + } + + if (docData?.module === 'qimen') { + return '/qimen'; + } + + if (docData?.module === 'gateway') { + return '/internal/v1/gateway'; + } + + return '/system'; +} + /** * 渲染键值表格。 * @param {Array} items 数据项列表。 @@ -512,9 +534,14 @@ function renderMethodCard(item, entryPath, moduleName) { const methodName = item.method || item.name || 'unknown'; const description = item.description || ''; const isQimen = moduleName === 'qimen'; + const isOpenapi = moduleName === 'openapi'; const queryHint = isQimen ? 'app_key=xxx&method=...&v=2.0&format=json&sign_method=md5&sign=xxx×tamp=1700000000' - : `method=${methodName}&v=1.0×tamp=1700000000`; + : isOpenapi + ? `app_key=&method=${methodName}&v=1.0×tamp=1700000000` + : `method=${methodName}&v=1.0×tamp=1700000000`; + const queryLabel = isOpenapi ? 'Query 参数(自动生成)' : 'Query 参数'; + const queryReadonlyAttr = isOpenapi ? ' readonly data-auto-generated="true" aria-label="自动生成"' : ''; return `
@@ -584,8 +611,13 @@ function renderMethodCard(item, entryPath, moduleName) {
在线调试
- - + + + + ${isOpenapi ? ` + + + ` : ''} @@ -1043,8 +1075,11 @@ function renderHtmlPage({