From dd2f47c59cdbe7db5362c0bb1597256ce7ac9c0d Mon Sep 17 00:00:00 2001 From: liufumingren Date: Thu, 24 Sep 2026 03:20:19 +0800 Subject: [PATCH] =?UTF-8?q?docs(agent):=20wms-doc-agent=20=E8=A7=84?= =?UTF-8?q?=E5=88=99=E5=8D=87=E7=BA=A7=E4=B8=BA=20system.json=20=E5=BA=93?= =?UTF-8?q?=E8=A1=A8=E5=8C=96=E7=BB=B4=E6=8A=A4=EF=BC=88method-doc=20?= =?UTF-8?q?=E8=84=9A=E6=9C=AC=E5=B7=A5=E4=BD=9C=E6=B5=81=20+=20=E5=87=BD?= =?UTF-8?q?=E6=95=B0=E6=B8=85=E5=8D=95=E5=90=8C=E6=AD=A5=EF=BC=89?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .cursor/agents/wms-doc-agent.md | 13 ++++++-- .github/agents/文档.agent.md | 14 +++++--- AI_METHOD_ROUTING.md | 58 +++++++++++++++++++-------------- AI_TOOLBOX.md | 2 +- 4 files changed, 55 insertions(+), 32 deletions(-) diff --git a/.cursor/agents/wms-doc-agent.md b/.cursor/agents/wms-doc-agent.md index f047f74..90dfb17 100644 --- a/.cursor/agents/wms-doc-agent.md +++ b/.cursor/agents/wms-doc-agent.md @@ -38,10 +38,17 @@ is_background: false - 公共请求头变化 - 鉴权方式变化 - 每次 API 接口变更(新增 / 修改 / 删除 method、参数、响应、错误码、header、鉴权等)后,除了更新 `methods/*.json` / `docs/*.md`,**还必须追加一条变更记录到对应的 `methods/changes/.json` 数组** - - 默认禁止直接手写 `methods/*.json` / `methods/changes/*.json`,必须先按 `docs/api-doc-update-workflow.md` 生成固定 spec,再执行 `npm run doc:api:update -- --spec=` - - 正式写入前必须先执行 `npm run doc:api:update -- --spec= --dry-run` + - **system.json 已库表化维护(2026-09-23)**:维护源为 `wms_api_method_doc`(方法表)+ `wms_method_doc_meta`(文档元信息),`methods/system.json` 是导出产物(docs 页面仍读该文件) + - 新建:`node script/method-doc-create.cjs --method --module <模块> --group <分组名> --description "说明" [--login 1] [--auth 0] [--params @p.json] [--response @r.json] [--errors @e.json] [--headers @h.json] [--bump]` + - 更新:`node script/method-doc-update.cjs --method [--description ...] [--login 1|0] [--auth 1|0] [--status 1|0] [--params @p.json] ... [--bump]` + - 查询:`node script/method-doc-get.cjs --method `;列表:`node script/method-doc-list.cjs [--module <模块>] [--search <关键词>]` + - 下线/删除:`node script/method-doc-delete.cjs --method --yes [--hard] [--bump]`(默认软删 status=0,导出时排除;--hard 真删) + - JSON 字段(headers/params/response/errors)支持内联 JSON 或 `@文件路径` + - **改完库必须回写文件**:`node script/method-doc-export.cjs`(原子写入 methods/system.json);首次使用先 `node script/method-doc-import.cjs` 全量导入 + - 生产库操作加 `--env production`(慎用) + - 变更记录仍走原流程:先按 `docs/api-doc-update-workflow.md` 生成固定 spec,再执行 `npm run doc:api:update -- --spec=`,写入前先执行 `--dry-run`;禁止直接手写 `methods/changes/*.json` - 修补 JSON 文件时必须强校验 JSON 格式正确性,确保不会引入无法解析的问题 - - `methods/*.json` 仍是 SSOT,`methods/changes/*.json` 仅记录差异历史 + - `wms_api_method_doc` 是维护源,`methods/system.json` 是导出产物,`methods/changes/*.json` 仅记录差异历史 - 变更记录建议字段至少包含:`version`、`date`、`summary`、`methods`、`notes` 5. 如 system 入参有变化,可执行: diff --git a/.github/agents/文档.agent.md b/.github/agents/文档.agent.md index cf6a18f..83dea7b 100644 --- a/.github/agents/文档.agent.md +++ b/.github/agents/文档.agent.md @@ -38,11 +38,17 @@ model: DeepSeek V4 Pro (deepseek) - 公共请求头变化 - 鉴权方式变化 - 每次 API 接口变更(新增 / 修改 / 删除 method、参数、响应、错误码、header、鉴权等)后,除了更新 `methods/*.json`,**还必须追加一条变更记录到对应的 `methods/changes/.json` 数组** - - 明确禁止直接手动编辑或提交 `methods/*.json` 与 `methods/changes/*.json` 文件。 - - 任何 PR 中直接修改这类文件的变更将被视为违规并可能被退回。所有对 methods JSON 的写入必须通过脚本完成,命令为 `npm run doc:api:update -- --spec=`(不可绕过)。 - - 正式写入前**必须**先执行 `npm run doc:api:update -- --spec= --dry-run` 进行验证;dry-run 不做写入,仅输出差异和校验结果。 + - **system.json 已库表化维护(2026-09-23)**:维护源为 `wms_api_method_doc`(方法表)+ `wms_method_doc_meta`(文档元信息),`methods/system.json` 是导出产物(docs 页面仍读该文件) + - 新建:`node script/method-doc-create.cjs --method --module <模块> --group <分组名> --description "说明" [--login 1] [--auth 0] [--params @p.json] [--response @r.json] [--errors @e.json] [--headers @h.json] [--bump]` + - 更新:`node script/method-doc-update.cjs --method [--description ...] [--login 1|0] [--auth 1|0] [--status 1|0] [--params @p.json] ... [--bump]` + - 查询:`node script/method-doc-get.cjs --method `;列表:`node script/method-doc-list.cjs [--module <模块>] [--search <关键词>]` + - 下线/删除:`node script/method-doc-delete.cjs --method --yes [--hard] [--bump]`(默认软删 status=0,导出时排除;--hard 真删) + - JSON 字段(headers/params/response/errors)支持内联 JSON 或 `@文件路径` + - **改完库必须回写文件**:`node script/method-doc-export.cjs`(原子写入 methods/system.json);首次使用先 `node script/method-doc-import.cjs` 全量导入 + - 生产库操作加 `--env production`(慎用) + - 变更记录仍走原流程(不可绕过):先按 `docs/api-doc-update-workflow.md` 生成固定 spec,`npm run doc:api:update -- --spec=` 写入前先执行 `--dry-run` 验证;禁止直接手写 `methods/changes/*.json` - 修补 JSON 文件时必须强校验 JSON 格式正确性,确保不会引入无法解析或破坏结构的问题 - - `methods/*.json` 仍是 SSOT,`methods/changes/*.json` 仅记录差异历史 + - `wms_api_method_doc` 是维护源,`methods/system.json` 是导出产物,`methods/changes/*.json` 仅记录差异历史 - 变更记录建议字段至少包含:`version`、`date`、`summary`、`methods`、`notes` 5. 如 system 入参有变化,可执行: diff --git a/AI_METHOD_ROUTING.md b/AI_METHOD_ROUTING.md index 4e5032b..775f6cf 100644 --- a/AI_METHOD_ROUTING.md +++ b/AI_METHOD_ROUTING.md @@ -305,10 +305,10 @@ rg "class .*Service|module.exports" app/service/qimenMethods - 临时清单输出:temp/tmp-service-method-inventory.md -自动生成时间: 2026-09-20T17:48:36.671Z +自动生成时间: 2026-09-23T17:34:46.974Z 扫描范围: app/service/**/*.js -文件数: 216 +文件数: 219 - app/service/api.js (1) - callMethod @@ -406,14 +406,14 @@ rg "class .*Service|module.exports" app/service/qimenMethods - list, create, update, delete, search - app/service/systemMethods/config.js (1) - list -- app/service/systemMethods/dashboard.js (17) - - storeStats, storeSideStoreStats, queryWarehouseStats, mergeStoreStats, emptyStoreStats, warehouseStats, hot_order_rank, express_ratio, storeSideExpressRatio, queryWarehouseExpressRatio, mergeChartData, formatChartData, emptyChartData, platform_distribution, storeSidePlatformDistribution, queryWarehousePlatformDistribution, order_trend -- app/service/systemMethods/frontConfig.js (1) - - getByDomain +- app/service/systemMethods/dashboard.js (28) + - storeStats, storeSideStoreStats, queryWarehouseStats, mergeStoreStats, emptyStoreStats, warehouseStats, hot_order_rank, storeSideHotOrderRank, queryWarehouseHotOrderRank, queryHotOrderRankWindowRows, buildHotOrderRankMap, buildHotOrderRankKeyFilter, mergeHotOrderRank, loadHotOrderRankStockInfo, resolveHotOrderRankProduct, maskHotOrderRankName, formatHotOrderRank, emptyHotOrderRank, express_ratio, storeSideExpressRatio, queryWarehouseExpressRatio, mergeChartData, formatChartData, emptyChartData, platform_distribution, storeSidePlatformDistribution, queryWarehousePlatformDistribution, order_trend +- app/service/systemMethods/frontConfig.js (9) + - getFrontConfigService, getByDomain, getInfo, getCert, saveInfo, saveCert, setDomain, getDomain, checkDomain - app/service/systemMethods/inbox.js (14) - group, message, v2, after_sales, bindCode, groupList, groupQuickList, groupMembers, groupDisable, groupUpdate, groupReset, groupMessages, retry, reply -- app/service/systemMethods/index.js (58) - - fastWhereTree, loadStores, loadWarehouses, loadExpressInterfaces, getCOSUploadConfig, getImages, uploadSuccessNotify, recognizeLicensePlate, ReferenceFile, getMessageDetail, test, getI18nMessage, putI18nCollect, extractModule, tryAutoTranslateNewKeys, searchSpace, searchSpaces, listInterfaceTypes, getLocationTypeList, getQimenAppList, getExpressList, getExpressProductTypeList, getPlatformList, getPrintPlatformList, ensureShopPrintPlatformExists, buildShopPrintPlatformInclude, getShopList, requestPddWaybillSearch, requestPddStdTemplates, requestTbWaybillSearch, requestTbCainiaoStdTemplates, requestPolyStdTemplates, getShopExpressList, getCainiaoStfTemplates, normalizeTemplatePlatformCode, normalizeTemplateExpressCode, getExpressPlatformFieldName, getTemplateAllowedExpressCodeSet, filterPrintPlatformTemplateResponseData, getPrintPlatformTemplateCacheKey, requestPrintPlatformTemplateList, resolvePddTemplateWpCodeCandidates, requestPddTemplateSourceList, getPrintPlatformTemplateList, isPlatformOauthReservationDuplicateError, getPlatformOauthReservationCodePrefix, hasPlatformOauthReservationCodePrefix, normalizePlatformOauthReservationCode, generatePlatformOauthReservationCode, createPlatformOauthReservation, getPlatformOauthLink, listenPlatformOauthBind, loginToIm, polyapiAuthorizeUrl, toOrder, getWorkbenchBindCode, LoginWorkbenchByCode, queryUserByToken +- app/service/systemMethods/index.js (59) + - fastWhereTree, loadStores, loadWarehouses, loadExpressInterfaces, getCOSUploadConfig, getImages, uploadSuccessNotify, recognizeLicensePlate, ReferenceFile, getMessageDetail, test, getI18nMessage, putI18nCollect, extractModule, tryAutoTranslateNewKeys, searchSpace, searchSpaces, listInterfaceTypes, getLocationTypeList, getQimenAppList, getExpressList, getExpressProductTypeList, getPlatformList, getPrintPlatformList, ensureShopPrintPlatformExists, buildShopPrintPlatformInclude, getShopList, requestPddWaybillSearch, requestPddStdTemplates, requestTbWaybillSearch, requestTbCainiaoStdTemplates, requestPolyStdTemplates, getShopExpressList, getCainiaoStfTemplates, normalizeTemplatePlatformCode, normalizeTemplateExpressCode, getExpressPlatformFieldName, getTemplateAllowedExpressCodeSet, filterPrintPlatformTemplateResponseData, getPrintPlatformTemplateCacheKey, requestPrintPlatformTemplateList, resolvePddTemplateWpCodeCandidates, requestPddTemplateSourceList, getPrintPlatformTemplateList, isPlatformOauthReservationDuplicateError, getPlatformOauthReservationCodePrefix, hasPlatformOauthReservationCodePrefix, normalizePlatformOauthReservationCode, generatePlatformOauthReservationCode, createPlatformOauthReservation, getPlatformOauthLink, listenPlatformOauthBind, loginToIm, polyapiAuthorizeUrl, toOrder, getWorkbenchBindCode, LoginWorkbenchByCode, queryUserByToken, parseWechatBadgeCode - app/service/systemMethods/order/archiveOrder.js (2) - list, detail - app/service/systemMethods/order/base.js (56) @@ -432,8 +432,8 @@ rg "class .*Service|module.exports" app/service/qimenMethods - list, manualOutboundOrder - app/service/systemMethods/order/packing.js (11) - list, get, setEndTime, forceRecord, export, exportTaskProgress, generateExportTaskId, normalizeExportTaskId, getExportTaskCacheKey, setExportTaskProgress, getExportTaskProgress -- app/service/systemMethods/order/pendingOrder.js (40) - - list, detail, reverseReviewOrder, assertOrdersWithoutWaybill, syncWavesAfterReverseReview, allocateStorage, allocateStorageProgress, normalizeAllocateStorageTaskProgress, normalizeAllocateStorageTaskCount, normalizeAllocateStorageTaskCounts, normalizeAllocateStorageRequestId, getAllocateStorageTaskCacheKey, setAllocateStorageTaskProgress, getAllocateStorageTaskProgress, getAllocateExpressTaskCacheKey, normalizeAllocateExpressTaskId, setAllocateExpressTaskProgress, getAllocateExpressTaskProgress, getSyncOrderIdsTaskCacheKey, normalizeSyncOrderIdsRequestId, setSyncOrderIdsTaskProgress, getSyncOrderIdsTaskProgress, cancelAllocateStorage, syncOrderIds, syncOrderIdsProgress, allocateExpressCode, allocateExpressCodeTaskProgress, markPendingOutboundOrder, cancelOrder, normalizePendingOutboundOrderIds, normalizePendingCancelOrderIds, isCancelablePendingOrder, updateOrderPlatform, updateOrderExpress, updateAddress, updateRemark, cloneOrder, parseAddress, parseAddressLocal, catch +- app/service/systemMethods/order/pendingOrder.js (90) + - list, detail, reverseReviewOrder, assertOrdersWithoutWaybill, syncWavesAfterReverseReview, allocateStorage, allocateStorageProgress, normalizeAllocateStorageTaskProgress, normalizeAllocateStorageTaskCount, normalizeAllocateStorageTaskCounts, normalizeAllocateStorageRequestId, getAllocateStorageTaskCacheKey, setAllocateStorageTaskProgress, getAllocateStorageTaskProgress, getAllocateExpressTaskCacheKey, normalizeAllocateExpressTaskId, setAllocateExpressTaskProgress, getAllocateExpressTaskProgress, getSyncOrderIdsTaskCacheKey, normalizeSyncOrderIdsRequestId, setSyncOrderIdsTaskProgress, getSyncOrderIdsTaskProgress, cancelAllocateStorage, syncOrderIds, syncOrderIdsProgress, allocateExpressCode, allocateExpressCodeTaskProgress, markPendingOutboundOrder, cancelOrder, normalizePendingOutboundOrderIds, normalizePendingCancelOrderIds, isCancelablePendingOrder, updateOrderPlatform, updateOrderExpress, updateAddress, updateRemark, cloneOrder, parseAddress, parseAddressLocal, createOrder, downloadCreateTemplate, normalizeIdsInput, batchIntercept, batchInterceptTaskProgress, generateBatchInterceptTaskId, normalizeBatchInterceptTaskId, normalizeBatchInterceptOrderIds, getBatchInterceptTaskCacheKey, setBatchInterceptTaskProgress, getBatchInterceptTaskProgress, runBatchInterceptTask, batchLock, batchLockTaskProgress, generateBatchLockTaskId, normalizeBatchLockTaskId, normalizeBatchLockOrderIds, getBatchLockTaskCacheKey, setBatchLockTaskProgress, getBatchLockTaskProgress, runBatchLockTask, batchUnlock, batchUnlockTaskProgress, generateBatchUnlockTaskId, normalizeBatchUnlockTaskId, normalizeBatchUnlockOrderIds, getBatchUnlockTaskCacheKey, setBatchUnlockTaskProgress, getBatchUnlockTaskProgress, runBatchUnlockTask, batchUnintercept, batchUninterceptTaskProgress, generateBatchUninterceptTaskId, normalizeBatchUninterceptTaskId, normalizeBatchUninterceptOrderIds, getBatchUninterceptTaskCacheKey, setBatchUninterceptTaskProgress, getBatchUninterceptTaskProgress, runBatchUninterceptTask, manualWaybill, releaseCreationLockForCancel, UNIQUE, allocateSubOrderNumber, writeAllocateSubOrderErrorFlag, writeAllocateSubOrderLog, allocateSubOrderNumberProgress, getAllocateSubOrderTaskCacheKey, setAllocateSubOrderTaskProgress, getAllocateSubOrderTaskProgress, buildSubOrderDetails, batchMarkPrinted - app/service/systemMethods/order/print.js (4) - getWavePlatformPrintData, getOrderPrintData, getPrintDataByWaybillCodes, unlockWavePlatformPrintDataByGroup - app/service/systemMethods/order/recheckOrder.js (60) @@ -490,8 +490,8 @@ rg "class .*Service|module.exports" app/service/qimenMethods - callSystemRole, list, permission, add, delete, update - app/service/systemMethods/setting/store_warehouse.js (0) - -- app/service/systemMethods/setting/warehouse.js (6) - - getSettings, getFieldMeta, saveSettings, getFrontConfig, saveFrontConfig, saveFrontCert +- app/service/systemMethods/setting/warehouse.js (4) + - getSettings, getFieldMeta, saveSettings, getweChatApp - app/service/systemMethods/shops.js (6) - callShopsSystem, list, add, del, edit, GetAuthorizeSessionKey - app/service/systemMethods/stock/combo.js (0) @@ -538,6 +538,8 @@ rg "class .*Service|module.exports" app/service/qimenMethods - getWarehouseZones, getWarehouseTree, getChildren, create, update, delete, detail, checkBarcodeUnique, toggleActive, getPath, getPickPath, updateRackPosition, recalculatePickPath, updateNeighbors, getAreaRacks, getSpacesByRack, createRackWithSpaces, getSpaceInfo, updateSpaceInfo, getBatchFieldValue, hasBatchField, normalizeBatchString, getCurrentWarehouseCode, batchUpdateSpaceInfo, exportRackSpaces - app/service/systemMethods/waybill/warehouse.js (9) - list, detail, export, exportTaskProgress, generateExportTaskId, normalizeExportTaskId, getExportTaskCacheKey, setExportTaskProgress, getExportTaskProgress +- app/service/systemMethods/wechat.js (21) + - getMyLoginCode, getAuthUrl, loginByCode, bindUser, bindByEmployee, getUserAgreementText, getUserAgreement, setUserAgreement, getAgreementVersion, pushLoginCode, queryauth, wxaauth, getAuthorizerInfo, registerMiniprogram, updateInfo, uploadHeadimg, getTemplateList, commit, getTrialQRCode, submitAudit, userList - app/service/systemMethods/workbench.js (17) - list, detail, create, update, delete, business, bindCamera, bind, getWorkbenchInfo, resetLoginCode, removeMember, bindMember, packOrder, finishPack, sendWeight, queryOrder, getWorkbenchCount - app/service/systems/account_platform.js (11) @@ -550,8 +552,8 @@ rg "class .*Service|module.exports" app/service/qimenMethods - generateAppKey, generateAppSecret, getDefaultInterfaceTypeId, list, create, update, delete, regenerateSecret - app/service/systems/auth/role_permission.js (7) - normalizeTypeFilter, normalizePermissionSet, toApiPermissionIds, serializePermissionSet, getPermissionIdsForRoles, assignPermissions, removePermissionsFromAllRoles -- app/service/systems/auth/user.js (66) - - getMenuTypeWhereByPlatform, getCurrentAccountId, getWechatBindCacheKey, getWechatBindCodeCacheKey, getWechatBindScanCacheKey, getWechatLoginClientCacheKey, getWechatLoginCodeCacheKey, getWechatLoginEventChannel, createWechatBindCodeCandidate, createUniqueSixCode, createWechatBindCode, createWechatLoginCode, createWechatLoginClientCode, parseWechatBindCode, formatBindWechatData, formatLoginWechatData, getRemainingSecondsByExpiresAt, setWechatBindCache, setWechatBindCodeCache, setWechatBindScanCache, getWechatBindScanCache, setWechatLoginClientCache, setWechatLoginCodeCache, findYe4sBindingByAccountId, getWechatBindEventChannel, getWechatLongPollTimeoutMs, shouldUseWechatBindLongPoll, publishWechatBindEvent, waitForWechatBindEvent, refreshWechatBindState, login, loginByYe4sCode, waitForLoginCodeRefresh, isTransientWechatLoginError, extractYe4sUserIdFromLoginEvent, waitForWechatLoginEvent, loginByYe4sUserId, tryBuildWechatLoginTokenFromState, refreshWechatLoginState, getLoginWechatCode, getBindWechatCode, getBindWechatCodeByAccountId, getUserByTempCode, bindAccountByTempCode, unbindWechat, unbindWechatByAccountId, buildLoginResult, changeRole, info, getRoles, findById, setUserCache, getAvatarByEmployeeId, clearUserCache, clearRelatedCache, getPermissions, getMenus, convertToRoutes, findUserByIdentifier, checkUserStatus, verifyPassword, encryptPassword, generateSalt, updateLastLoginTime, ensurePlatformActiveRole, register +- app/service/systems/auth/user.js (67) + - getMenuTypeWhereByPlatform, getCurrentAccountId, getWechatBindCacheKey, getWechatBindCodeCacheKey, getWechatBindScanCacheKey, getWechatLoginClientCacheKey, getWechatLoginCodeCacheKey, getWechatLoginEventChannel, createWechatBindCodeCandidate, createUniqueSixCode, createWechatBindCode, createWechatLoginCode, createWechatLoginClientCode, parseWechatBindCode, formatBindWechatData, formatLoginWechatData, getRemainingSecondsByExpiresAt, setWechatBindCache, setWechatBindCodeCache, setWechatBindScanCache, getWechatBindScanCache, setWechatLoginClientCache, setWechatLoginCodeCache, findYe4sBindingByAccountId, getWechatBindEventChannel, getWechatLongPollTimeoutMs, shouldUseWechatBindLongPoll, publishWechatBindEvent, publishWechatLoginEvent, waitForWechatBindEvent, refreshWechatBindState, login, loginByYe4sCode, waitForLoginCodeRefresh, isTransientWechatLoginError, extractYe4sUserIdFromLoginEvent, waitForWechatLoginEvent, loginByYe4sUserId, tryBuildWechatLoginTokenFromState, refreshWechatLoginState, getLoginWechatCode, getBindWechatCode, getBindWechatCodeByAccountId, getUserByTempCode, bindAccountByTempCode, unbindWechat, unbindWechatByAccountId, buildLoginResult, changeRole, info, getRoles, findById, setUserCache, getAvatarByEmployeeId, clearUserCache, clearRelatedCache, getPermissions, getMenus, convertToRoutes, findUserByIdentifier, checkUserStatus, verifyPassword, encryptPassword, generateSalt, updateLastLoginTime, ensurePlatformActiveRole, register - app/service/systems/camera.js (12) - list, detail, create, update, setOsd, _findCameraForControl, _assertPtzSuccess, ptzControl, ptzStop, ptzPresetGoto, ptzPresetSet, delete - app/service/systems/cameraServer.js (5) @@ -574,6 +576,8 @@ rg "class .*Service|module.exports" app/service/qimenMethods - buildTree, getTreeByType, buildSubTree, getWithChildrenByType, getAllChildren, getByType, getGroups, getChildrenByPid, getTreeChildrenByPid, create, update, findById, delete - app/service/systems/file.js (2) - getImages, ReferenceFile +- app/service/systems/frontConfig.js (42) + - createError, getCurrentWarehouseId, deleteCacheByKey, normalizeText, normalizeTheme, assertDomainUnique, getRecordField, sanitizeErrorText, getDomainVerifyConfig, getCnameTarget, buildDomainVerifyCode, parseTxtAnswerData, extractTxtValuesFromAnswers, resolveTxtByDoh, resolveTxtBySystem, resolveTxtValues, verifyDomainRecord, isUnknownColumnError, findVerifiedDomainRecord, verifyPendingDomains, buildInfoOutput, buildCertOutput, getInfo, getCert, getDomain, setDomain, checkDomain, buildDomainOutput, describeDomainStatus, getDomainCacheKey, buildPublicOutput, clearDomainCache, getByDomain, normalizePem, parseCertPem, assertCertValid, collectCertNames, certCoversDomain, validateKeyPem, assertWarehouseSubject, saveInfo, saveCert - app/service/systems/inbound_direct_log.js (15) - getItems, _addSingleItem, _bindReceivingDetail, addItem, removeItem, commit, notifyEntryOrderCompleted, _queryCompletedEntryItems, _buildCompletedItemLines, buildEntryOrderConfirmRequest, _sendOpenApiCallback, operationLog, qimenEntrySync, _syncReceivingStorageStatus, _applyReceivingStockOccupancy - app/service/systems/inbox/group.js (11) @@ -600,8 +604,8 @@ rg "class .*Service|module.exports" app/service/qimenMethods - buildOperationLogData, buildBusinessLogWhere, formatOperationLogRows, createOperationLog, createOperationLogs, queryLogsByBusinessType, queryStockLogs, queryOrderLogs, queryAllOrderLogs, queryAllLogsByBusinessType, queryReceivingLogs, queryEntryOrderLogs, queryStockoutLogs, getMessageDetail - app/service/systems/order_async.js (9) - finalizeSuccessfulQimenSync, syncQmOrders, syncManualOrders, flushDeferredOrderSyncNotices, syncApiOrders, syncStockoutOrders, buildStockoutConfirmRequest, notifyStockoutExternal, resolveOpenApiAppByStore -- app/service/systems/order_auto_outbound.js (7) - - getEnabledAutoOutboundWarehouses, normalizeSubjectConfigForAutoOutbound, buildAutoOutboundWhere, findAutoOutboundOrders, findOrderIdsWithWeigh, processWarehouseAutoOutbound, executeAutoOutbound +- app/service/systems/order_auto_outbound.js (12) + - getEnabledAutoOutboundWarehouses, normalizeSubjectConfigForAutoOutbound, buildAutoOutboundWhere, findAutoOutboundOrders, Date, buildSameDayOutboundCutoffUtc, resolveSameDayTime, resolveSameDayReleaseTime, buildSameDayReleaseUtc, findOrderIdsWithWeigh, processWarehouseAutoOutbound, executeAutoOutbound - app/service/systems/order_delivery_archive.js (17) - getArchiveDefaults, buildArchiveOptions, NOW, buildArchiveThresholds, normalizeWarehouseIds, listDispatchWarehouseIds, getArchiveModels, buildCandidateWhere, buildQueryOptions, buildHistoryOrderRow, buildHistoryItemRow, getArchiveErrorInfo, rollbackQuietly, archiveDispatchBatch, archiveDispatchOrdersForWarehouse, resolveFailureCursor, archiveDispatchOrdersToHistory - app/service/systems/order_delivery_migration.js (15) @@ -644,8 +648,8 @@ rg "class .*Service|module.exports" app/service/qimenMethods - qimenClient, send, sendRequest - app/service/systems/receiving_entry_match.js (29) - matchAfterEntryCompleted, _bindEntryOrderReceiving, bindEntryOrderReceiving, _bindReceivingsWithStorageSync, _bindOneReceivingAndSyncStorage, max, _syncReceivingStorageByEntryItems, _parseLedgerMap, _serializeLedgerMap, min, _buildLegacyBaselineLedger, _bindingAllocationByStock, _recalcReceivingStorageStatus, _reconcileEntryReceivedQuantity, recordLedgerAllocation, setLedgerAllocation, rollbackEntryOrderBindings, _rollbackOneBindingStorage, _getRecentReceivingOrders, _findReceivingByRemark, _compareDetails, _queryEntryOrderLines, buildEntryOrderConfirmRequest, _sendCallback, _sendQimenCallback, _sendOpenApiCallback, _markReceivingPartialStorage, _commitBinding, unbindEntryOrderReceiving -- app/service/systems/receiving_pending_notice.js (14) - - getWarehouseNoticeConfigs, findPendingReceivings, groupByStore, buildRowLine, formatDateOnly, buildTemplateVariables, buildContent, resolveNoticeSendMethod, sendPendingNotice, notifyWarehouse, getRedisClient, acquireDailyLock, releaseDailyLock, execute +- app/service/systems/receiving_pending_notice.js (16) + - getMemoryDailyLocks, getWarehouseNoticeConfigs, findPendingReceivings, groupByStore, buildRowLine, formatDateOnly, buildTemplateVariables, buildContent, resolveNoticeSendMethod, sendPendingNotice, sendCustomerServiceFallback, notifyWarehouse, getRedisClient, acquireDailyLock, releaseDailyLock, execute - app/service/systems/report.js (17) - getDefinition, parseFieldsField, definitionToView, resolveTypeEntry, resolveQuerier, listRegisteredTypes, validateTypeFields, resolveOrderedFields, Date, buildFilename, buildWorkbookSheets, generate, generateBuffer, saveDefinition, findDefinitionById, listDefinitions, deleteDefinition - app/service/systems/report/queries/index.js (0) @@ -656,8 +660,8 @@ rg "class .*Service|module.exports" app/service/qimenMethods - - app/service/systems/reportDelivery.js (29) - normalizeScheduleTimes, parseJsonArray, readJsonArray, readJsonObject, normalizeNotifyTemplate, normalizePlanName, normalizeNotifyGroupIds, normalizeNotifyMemberIds, validateNotifyGroupExists, savePlan, copyPlan, planToView, listPlans, listLogs, hitTimePoints, bizDateOfTrigger, bizDateOfTimePoint, resolveStoreWarehouse, markDelivered, markFailed, markExporting, buildMessageContent, resolveNotifyGroups, Date, deliverByChannel, sendNotifyIfConfigured, processOne, parseScheduleTimes, dispatch -- app/service/systems/return_received.js (18) - - createBusinessError, create, notifyPending, _handleInterceptAfterSale, _updateOrderInterceptStatus, list, exportList, _generateExportExcel, detail, delete, _findByIdChecked, _enrichReturn, _resolveStoreRemark, _resolveStoreRemarkMap, _buildListWhere, _resolveConditionValue, _extractConditionValue, _buildListOrder +- app/service/systems/return_received.js (19) + - createBusinessError, create, _isUrgentReturnQuery, notifyPending, _handleInterceptAfterSale, _updateOrderInterceptStatus, list, exportList, _generateExportExcel, detail, delete, _findByIdChecked, _enrichReturn, _resolveStoreRemark, _resolveStoreRemarkMap, _buildListWhere, _resolveConditionValue, _extractConditionValue, _buildListOrder - app/service/systems/return_unpack.js (50) - _getRecordingComputerId, _buildVideoUrl, createBusinessError, create, transferByWaybills, addDetail, updateDetail, removeDetail, cancel, _resolveSubmitEndTime, submit, _notifyUnpacked, forceRecord, list, detailList, videoList, exportUnpack, _resolveStoreNameMap, _resolveExpressNameMap, _extractDetailColor, detail, _buildWaybillMatch, _findWaybillFlexible, queryByWaybill, _resolveWarehouseName, _resolveStoreIdByWaybill, _resolveReturnOrderInfo, delete, _insertMainWithRetry, _transferOneWaybill, _backfillDetailsFromOrder, _countDetails, _resolveReturnReceivedId, _buildTransferDetailRows, _findByIdChecked, _assertUnpacking, _findDetailChecked, _recalcMain, _enrichRow, _flattenVideos, _enrichDetailsWithStock, _resolveStoreRemark, VALUES, _generateUnpackNo, _buildListWhere, _buildDetailListWhere, _buildVideoListWhere, _buildVideoListOrder, _resolveConditionValue, _buildListOrder - app/service/systems/return_waybill.js (12) @@ -682,8 +686,8 @@ rg "class .*Service|module.exports" app/service/qimenMethods - createError, getCurrentStoreId, getCurrentEmployeeId, toPositiveNumber, getEmployee, normalizeRoleIds, findAssignableRoles, clearEmployeeCache, getCurrentEmployeeRoleIds, collectDescendantRoleIds, buildRolePermissionMap, buildRoleTree, normalizeStoreScope, isRoleVisibleInScope, normalizePermissionIds, normalizePid, getManageableRole, validatePermissionSet, replaceRolePermissions, clearRoleUsersCache, list, permission, add, delete, update - app/service/systems/setting/store_warehouse.js (35) - createError, getCurrentStoreId, getCurrentAccountId, toPositiveNumber, normalizePage, normalizeStatusFlag, normalizeAuthStatus, normalizeNonNegativeInteger, normalizeText, normalizeDate, normalizeSignAction, normalizeTempCode, getTempCodeCacheKey, createTempCode, pickRemaskField, resolveRemaskValue, buildCurrentRemaskPatch, requireCurrentRemaskPatch, saveTempSignPayload, getTempSignPayload, clearTempSignPayload, buildTempSignView, getCurrentSubject, getCounterparty, buildListWhere, getRelationIncludes, resolvePairIds, serializeRelation, findScopedRelation, list, sign, trimContract, confirmSign, rename, unbind -- app/service/systems/setting/warehouse.js (30) - - getDefaultCodeFieldOptionsMap, normalizeWaveStrategyVersion, normalizeSubjectConfigInternalFields, sanitizeSubjectConfigForOutput, createError, getCurrentWarehouseId, deleteCacheByKey, clearWarehouseSettingCache, getFieldMeta, getSettings, validateDefaultLocation, saveSettings, normalizeFrontConfigText, normalizeFrontConfigTheme, assertFrontConfigDomainUnique, buildFrontConfigOutput, getFrontConfig, getFrontConfigDomainCacheKey, buildFrontConfigPublicOutput, clearFrontConfigDomainCache, getFrontConfigByDomain, normalizeFrontConfigPem, parseFrontConfigCertPem, assertFrontConfigCertValid, collectFrontConfigCertNames, frontConfigCertCoversDomain, validateFrontConfigKeyPem, assertFrontConfigWarehouseSubject, saveFrontConfig, saveFrontCert +- app/service/systems/setting/warehouse.js (13) + - getDefaultCodeFieldOptionsMap, normalizeWaveStrategyVersion, normalizeSubjectConfigInternalFields, sanitizeSubjectConfigForOutput, createError, getCurrentWarehouseId, deleteCacheByKey, clearWarehouseSettingCache, getFieldMeta, getSettings, validateDefaultLocation, saveSettings, getWechatApp - app/service/systems/shops.js (20) - generatePendingShopName, createError, getCurrentWarehouseId, normalizeText, normalizeInteger, ensureShopPrintPlatformExists, getListWhereSpecialFieldMap, buildListWhere, normalizePagination, buildShopPrintPlatformInclude, formatShopRow, list, ensureShopNameUnique, add, findShopById, del, edit, generateAuthorizeRandomCode, createOrReuseAuthorizeReservation, getAuthorizeSessionKey - app/service/systems/sign.js (10) @@ -722,8 +726,8 @@ rg "class .*Service|module.exports" app/service/qimenMethods - normalizeSubjectConfigInput, validateStoreData, checkCompanyNameExists, findByAccountId, findAllEnabled, findAllWarehouses, getStoreName, getStoreRemaskName, createStore, createWarehouse, joinStore, joinWarehouse, ensureEmployeeRoleBinding, assignAdminRoleToCreator, generateJoinToken, sendNotification, sendNotificationToAdmins, getStoreRoles, auditApply, loadStores, loadWarehouses, bindCode - app/service/systems/system_log.js (3) - findCleanupBoundaryId, deleteSystemLogsBatch, cleanupExpiredSystemLogs -- app/service/systems/upload.js (18) - - getTencentCloudConfig, getCosConfig, initCOS, getUploadParams, hash_hmac, generatePolicyAndSignature, resolveUploadMaxSizeBytes, validateFileInfo, generateFileName, parseSizeToBytes, formatFileSize, getFrontendConfig, uploadFile, validateFile, uploadSuccessNotify, getMimeType, createFileReference, handleUploadCallback +- app/service/systems/upload.js (19) + - getTencentCloudConfig, getCosConfig, initCOS, getUploadParams, hash_hmac, generatePolicyAndSignature, resolveUploadMaxSizeBytes, validateFileInfo, generateFileName, parseSizeToBytes, formatFileSize, getFrontendConfig, uploadFile, uploadBuffer, validateFile, uploadSuccessNotify, getMimeType, createFileReference, handleUploadCallback - app/service/systems/video_record_request.js (15) - _getRecordingComputer, _isComputerOnline, _resetVideoRecords, _withinReuseWindow, _markFailed, requestPackVideo, requestUnpackVideo, requestFor, syncByVideos, settleStatuses, notifyResults, queryPackVideo, _buildResultMessage, _notifyManualHandling, _replyResult - app/service/systems/warehouseNotify.js (7) @@ -732,6 +736,8 @@ rg "class .*Service|module.exports" app/service/qimenMethods - closeFinishedWaves, normalizeConfirmIntervalMs, readEmptyConfirmState, writeEmptyConfirmState - app/service/systems/waybill.js (5) - toOrder, list, detail, export, buildWaybillExportFile +- app/service/systems/wechat.js (35) + - getAuthUrl, getAccountInfoSync, resolveWechatApp, loginByCode, getMyLoginCode, bindUser, buildBindResult, bindByEmployee, getUserAgreementText, getUserAgreement, setUserAgreement, findWarehouseWechatApp, findLatestAgreementVersion, getAgreementVersion, cleanupUnusedAgreementVersions, pushLoginCode, queryauth, wxaauth, resolveBodyMedia, resolveMediaValue, downloadFromUrl, resolveMediaFilename, registerMiniprogram, updateInfo, buildHeadimgKey, uploadHeadimg, getTemplateList, hasFuncScope, buildAuthorizerPatch, getAuthorizerInfo, commit, submitAudit, buildTrialQrCodeKey, getTrialQRCode, userList - app/service/systems/workbench.js (73) - list, detail, create, update, delete, bindCamera, business, _loadPackCtx, _countWaveOrders, _countWaveOrdersCached, SUM, _sumWaveItemsTotal, _sumWaveItemsTotalCached, _getWaveOrderIds, Set, _buildPackChangeSummary, _writePackOperationLog, _updateOrderPackStatus, _packOrder, resolvePackTaskEndTime, _finishPack, _resetPackOsd, _sendWeight, _writeWeighOpLog, _aggregateWaveItems, _fetchWaveItemsSummary, _fetchOrderItemsDetail, _queryOrder, generatePackCtxKey, getWorkbenchPackCtxCacheKey, getWorkbenchBindClientCacheKey, getWorkbenchBindCodeCacheKey, getWorkbenchTokenCacheKey, generateRandomChars, generateWorkbenchToken, generateWorkbenchLoginCode, normalizeWorkbenchBindCode, generateUniqueWorkbenchLoginCode, createUniqueWorkbenchClientCode, createUniqueWorkbenchBindCode, buildWorkbenchBindState, getWorkbenchBindRemainingSeconds, setWorkbenchBindState, createWorkbenchBindSession, refreshWorkbenchBindCode, formatWorkbenchBindData, waitForWorkbenchBindComplete, getWorkbenchBindCode, formatWorkbenchTokenInfo, listWorkbenchMembers, listCurrentPackTasks, buildCurrentPackingInfo, invalidateWorkbenchTokenCacheByWorkbenchId, buildWorkbenchTokenInfo, bindWorkbench, getWorkbenchInfoByToken, _round2, _formatPackCountTime, buildWorkbenchPackCountTimeRange, getWorkbenchCountByToken, loginWorkbenchByCode, resetLoginCode, clearExpiredWorkbenchTokens, resolveWorkbenchContext, resolveWorkbenchByToken, packOrderByToken, finishPackByToken, sendWeightByToken, queryOrderByToken, normalizeWorkbenchMemberIds, _finishAllPackTasksByMemberLogout, removeWorkbenchMember, bindWorkbenchMember - app/service/warehouse.js (7) @@ -792,6 +798,10 @@ rg "class .*Service|module.exports" app/service/qimenMethods + + + + diff --git a/AI_TOOLBOX.md b/AI_TOOLBOX.md index 3a849df..36e13f6 100644 --- a/AI_TOOLBOX.md +++ b/AI_TOOLBOX.md @@ -146,7 +146,7 @@ Redis 相关能力文档已统一移交给 `wms-redis-agent`。 - 测试相关问题:写单元测试、补回归、接口验证、TDD、验证修复、审查 mock / 断言 - 统一转给 `wms-test-agent` 处理 -- 文档相关问题:API 文档、README、`methods/system.json`、`docs/*.md`、使用说明 +- 文档相关问题:API 文档、README、`methods/system.json`(已库表化:`wms_api_method_doc` + `script/method-doc-*.cjs` 维护并导出回写)、`docs/*.md`、使用说明 - 统一转给 `wms-doc-agent` 处理 - 不确定该用哪个 agent,或问题横跨数据库 / Redis / 发布 / 代码 / 测试 / 文档