- 新增退回收到登记表 wms_return_received 及模型、建表迁移 - 新增扫码登记/列表/详情/删除接口(systemMethods + systems 分层) - 退回收到联动:标记运单 is_back、完结拦截工单、订单退回状态、操作记录 - 新增权限 527/528/529 + 菜单 530,授权仓库/客服角色 - 解除拦截不再清除 is_back(由退回收货流程单独管理) - 同步 API 文档、method 路由速查
233 lines
12 KiB
Markdown
233 lines
12 KiB
Markdown
# AI 方法路由速查(WMS)
|
||
|
||
本文用于让 AI/开发者快速理解入口路由与 method 到代码文件的映射关系。
|
||
|
||
## 1. 入口定义(router 风格)
|
||
|
||
当前路由定义见 `app/router.js`:
|
||
- `POST /qimen` -> 奇门开发接口入口
|
||
- `POST /system` -> Web 端与 PDA 端统一业务入口
|
||
|
||
注意:当前代码中 `/qimen` 与 `/system` 都是 `POST` 路由。
|
||
|
||
## 2. /system 入口说明(统一 Web + PDA)
|
||
|
||
调用链:
|
||
1. `app/router.js` -> `controller.home.system`
|
||
2. `app/controller/home.js` 的 `system()` 读取 `ctx.query.method`
|
||
3. `app/service/system.js` 的 `callMethod(className, actionName, requestData, authHeader)`
|
||
4. 从 `ctx.service.systemMethods` 中按 method 分段下钻并执行目标函数
|
||
|
||
参数规则(system):
|
||
- 必填 query: `method`, `v`, `timestamp`
|
||
- 认证头:可传 `Authorization`
|
||
- 请求体:JSON(`system()` 中按 JSON 解析)
|
||
|
||
外部请求示例:
|
||
|
||
```text
|
||
POST http://127.0.0.1:6060/system?method=print.getComputerPrinter&v=1.0×tamp=1773386721
|
||
```
|
||
|
||
示例 body(按业务方法需要):
|
||
|
||
```json
|
||
{
|
||
"id": 10001
|
||
}
|
||
```
|
||
|
||
## 3. /qimen 入口说明(奇门开发接口)
|
||
|
||
调用链:
|
||
1. `app/router.js` -> `controller.home.qimen`
|
||
2. `app/controller/home.js` 的 `qimen()` 读取 `ctx.query.method`
|
||
3. `app/service/qimen.js` 的 `callMethod(className, actionName, xmlData, ...)`
|
||
4. 从 `ctx.service.qimenMethods` 中按 method 分段下钻并执行目标函数
|
||
|
||
参数规则(qimen):
|
||
- 必填 query: `app_key`, `method`, `v`, `format`, `sign_method`, `sign`, `timestamp`
|
||
- 请求体:XML(`qimen()` 中按 XML 解析)
|
||
|
||
## 4. method 指向规则(核心)
|
||
|
||
统一规则:
|
||
- `method` 最后一段是函数名(actionName)
|
||
- 前面部分是 service 路径(className)
|
||
- service 路径按 `.` 拆分后,对应到 `app/service/systemMethods` 或 `app/service/qimenMethods` 的目录层级
|
||
|
||
### 4.1 /system 示例
|
||
|
||
1) `method=print.getComputerPrinter`
|
||
- service 路径:`print`
|
||
- 函数名:`getComputerPrinter`
|
||
- 对应文件:`app/service/systemMethods/print.js`
|
||
- 对应方法:`getComputerPrinter(data)`
|
||
|
||
2) `method=setting.printTemplate.list`
|
||
- service 路径:`setting.printTemplate`
|
||
- 函数名:`list`
|
||
- 对应文件:`app/service/systemMethods/setting/printTemplate.js`
|
||
- 对应方法:`list(data)`
|
||
|
||
3) `method=printer.station.list`
|
||
- service 路径:`printer.station`
|
||
- 函数名:`list`
|
||
- 对应文件:`app/service/systemMethods/printer/station.js`
|
||
- 对应方法:`list()`
|
||
|
||
### 4.2 /qimen 示例
|
||
|
||
1) `method=deliveryorder.xxx`
|
||
- service 路径:`deliveryorder`
|
||
- 对应文件:`app/service/qimenMethods/deliveryorder.js`
|
||
|
||
2) `method=taobao.qimen.service.xxx`
|
||
- service 路径:`taobao.qimen.service`
|
||
- 对应文件:`app/service/qimenMethods/taobao/qimen/service.js`
|
||
|
||
## 5. AI 快速定位建议
|
||
|
||
当收到 `method=aaa.bbb.ccc` 时,优先按以下步骤定位:
|
||
1. 判定入口:`/system` 还是 `/qimen`
|
||
2. 取最后一段 `ccc` 作为函数名
|
||
3. 其余部分 `aaa.bbb` 作为 service 路径
|
||
4. 在对应 methods 目录查找文件并确认类方法是否存在
|
||
|
||
可用检索命令示例:
|
||
|
||
```powershell
|
||
rg "getComputerPrinter|class PrintService" app/service/systemMethods
|
||
rg "class .*Service|module.exports" app/service/qimenMethods
|
||
```
|
||
## 后续所有的method新增变更全部需要维护到下方
|
||
|
||
|
||
## method结束
|
||
|
||
## 6. 全量 Service Method 能力清单(自动扫描)
|
||
|
||
维护说明:
|
||
- 扫描范围:app/service/**/*.js
|
||
- 本节内容由脚本生成,新增/修改 service 后请同步刷新。
|
||
- 刷新命令:node .\script\tmp-gen-service-method-inventory.cjs
|
||
- 临时清单输出:temp/tmp-service-method-inventory.md
|
||
|
||
<!-- SERVICE_METHOD_INVENTORY:BEGIN -->
|
||
自动生成时间: 2026-03-22T15:27:37.958Z
|
||
|
||
扫描范围: app/service/**/*.js
|
||
文件数: 50
|
||
|
||
- app/service/api.js (1)
|
||
- callMethod
|
||
- app/service/apiMethods/test.js (4)
|
||
- entryorderConfirm, playbackRequest, fibonacci, fibonacciRecursive
|
||
- app/service/dispatcher.js (3)
|
||
- buildMap, getMethodMap, invoke
|
||
- app/service/main.js (11)
|
||
- success, fail, normalizeDate, setInfo, getInfo, findQimenAppWithContract, queryFromDatabase, checkAuth, checkApiPermission, setUserContext, systemInit
|
||
- app/service/pda.js (3)
|
||
- callMethod, validateParams, saveLog
|
||
- app/service/qimen.js (12)
|
||
- validateApi, getErpName, parseXmlToArray, cleanXmlString, callMethod, formatResponse, xmlResponse, buildXmlNode, escapeXml, saveQimenLog, saveQimenLogResult, saveQimenLogBody
|
||
- app/service/qimenMethods/deliveryorder.js (3)
|
||
- query, create, batchcreate
|
||
- app/service/qimenMethods/entryorder.js (2)
|
||
- create, query
|
||
- app/service/qimenMethods/inventory.js (1)
|
||
- query
|
||
- app/service/qimenMethods/order.js (2)
|
||
- cancel, pending
|
||
- app/service/qimenMethods/returnorder.js (2)
|
||
- create, query
|
||
- app/service/qimenMethods/singleitem.js (2)
|
||
- synchronize, query
|
||
- app/service/qimenMethods/stockout.js (2)
|
||
- create, query
|
||
- app/service/qimenMethods/taobao/qimen/service.js (1)
|
||
- heartbeat
|
||
- app/service/system.js (4)
|
||
- callMethod, validateParams, validateRequestContext, saveLog
|
||
- app/service/systemMethods/config.js (1)
|
||
- list
|
||
- app/service/systemMethods/dashboard.js (6)
|
||
- storeStats, warehouseStats, hot_order_rank, express_ratio, platform_distribution, order_trend
|
||
- app/service/systemMethods/index.js (13)
|
||
- fastWhereTree, loadStores, getCOSUploadConfig, getImages, uploadSuccessNotify, ReferenceFile, getMessageDetail, getI18nMessage, putI18nCollect, extractModule, tryAutoTranslateNewKeys, searchSpace, getExpressList
|
||
- app/service/systemMethods/order.js (11)
|
||
- getWarehouseId, getOrderModels, applyDateRange, buildWhere, parseDateTime, list, detail, listItems, stats, updateStatus, updateDeliveryTime
|
||
- app/service/systemMethods/print.js (3)
|
||
- send, sendToComputer, log
|
||
- app/service/systemMethods/printer/station.js (1)
|
||
- list
|
||
- app/service/systemMethods/returnReceived.js (4)
|
||
- create, list, detail, delete
|
||
- app/service/systemMethods/setting/printTemplate.js (3)
|
||
- list, save, listTemplatesByType
|
||
- app/service/systemMethods/stock.js (21)
|
||
- stockWarehouse, getProhibitedType, getInfo, saveWarehouseStock, createWarehouseStock, getBarcodes, saveWarehouseStockBarcode, getStoreStocks, bindItem, unbindItem, checkItemCodeUnique, queryStockLogs, handleBatchDelete, deleteUnit, deleteProhibited, handleBatchChange, getStockUnits, getUnitList, createProhibited, createUnit, search
|
||
- app/service/systemMethods/storage/receiving.js (13)
|
||
- getReceivingList, getReceivingDetail, batchCancelReceiving, create, addItem, removeItem, saveReceiving, get, addDetail, deleteDetail, detailChange, cancel, completeReceiving
|
||
- app/service/systemMethods/storage/direct_inbound.js (4)
|
||
- getItems, addItem, commit, removeItem
|
||
- app/service/systemMethods/store.js (6)
|
||
- createStore, createWarehouse, joinStore, joinWarehouse, getStoreRoles, auditApply
|
||
- app/service/systemMethods/user.js (5)
|
||
- login, logout, info, changeRole, register
|
||
- app/service/systemMethods/warehouse.js (20)
|
||
- getWarehouseZones, getWarehouseTree, getChildren, create, update, delete, detail, checkBarcodeUnique, toggleActive, getPath, createRack, getPickPath, updateRackPosition, recalculatePickPath, updateNeighbors, getAreaRacks, getSpacesByRack, createRackWithSpaces, getSpaceInfo, updateSpaceInfo
|
||
- app/service/systems/account_platform.js (11)
|
||
- getActiveInclude, getPrimaryRoleBinding, formatActiveContext, switchActiveRole, getActiveRoleByPlatform, getMultiplePlatformActiveRoles, getAllPlatformActives, clearPlatformActive, clearPlatformCache, getAvailableRoles, getCurrentContext
|
||
- app/service/systems/auth/user.js (21)
|
||
- login, ID, changeRole, info, getRoles, findById, setUserCache, getAvatarByEmployeeId, clearUserCache, clearRelatedCache, getPermissions, getMenus, convertToRoutes, findUserByIdentifier, checkUserStatus, verifyPassword, encryptPassword, generateSalt, updateLastLoginTime, ensurePlatformActiveRole, register
|
||
- app/service/systems/delivery_order.js (7)
|
||
- addOrder, generateItemsHash, calculateCRC32, prepareOrderData, addOrderLines, safeParseFloat, addOrderToQueue
|
||
- app/service/systems/entry_order.js (9)
|
||
- addOrder, getLineCount, received, success, fail, tryCreateEntryOrder, addItems, qimenEntryorderConfirm, entryorderConfirm
|
||
- app/service/systems/inbound_direct_log.js (4)
|
||
- getItems, addItem, commit, removeItem
|
||
- app/service/systems/fast_where.js (13)
|
||
- buildTree, getTreeByType, buildSubTree, getWithChildrenByType, getAllChildren, getByType, getGroups, getChildrenByPid, getTreeChildrenByPid, create, update, findById, delete
|
||
- app/service/systems/file.js (2)
|
||
- getImages, ReferenceFile
|
||
- app/service/systems/location_space.js (16)
|
||
- create, batchCreate, list, detail, update, delete, toggleStatus, updateStatus, findAvailableSpaces, findByCode, findByBarcode, getWarehouseStats, getZoneStats, validateAllocation, validateTransferOut, _validateReferences
|
||
- app/service/systems/location_zone.js (22)
|
||
- getWarehouseLevelZones, getZoneTreeByWarehouse, getChildrenByZoneId, isLeafNode, createZone, validateBasicFields, validateByZoneType, validateParentElement, validateZoneOverlap, isOverlap, generateZoneCodeByType, getDefaultColorByType, getZoneTypeText, updateZone, deleteZone, checkZoneOverlap, getZoneDetail, toggleZoneActive, getZonePath, generateSpacesForRack, getSpaceInfo, checkBarcodeUnique
|
||
- app/service/systems/location.js (10)
|
||
- createRackWithSpaces, _generateSpacesForRack, _calculateAreaRackOrder, _calculatePickPathForWarehouse, _updateSpacePickSequence, _calculatePickPriority, updateRackPosition, getPickPath, updateNeighborRelations, _findNeighborRacks
|
||
- app/service/systems/notification.js (1)
|
||
- send
|
||
- app/service/systems/operation_log.js (4)
|
||
- createOperationLog, queryStockLogs, queryOrderLogs, getMessageDetail
|
||
- app/service/systems/platform.js (6)
|
||
- checkPlatformExists, getPlatformInfo, clearPlatformCache, getPlatformSettingDetail, batchCheckPlatforms, createPlatformSetting
|
||
- app/service/systems/polo_api.js (6)
|
||
- getJsonDatas, getJsonData, getSignText, md5Encrypt, _formatDate, _formatPickupDate
|
||
- app/service/systems/print/index.js (2)
|
||
- sendToComputer, test
|
||
- app/service/systems/qimen_query.js (6)
|
||
- send, replaceXmlTagsWithString, addSign, getQueryParams, generateUrlWithParams, sendRequest
|
||
- app/service/systems/return_received.js (12)
|
||
- create, list, detail, delete, createBusinessError, _findByIdChecked, _enrichReturn, _resolveStoreRemark, _buildListWhere, _resolveConditionValue, _extractConditionValue, _buildListOrder
|
||
- app/service/systems/setting/print_template.js (14)
|
||
- listTemplatesByType, getTree, getTemplatesByType, save, getBusinessTypesAndItem, getGroupedPrintItems, getTableConfigs, clearBusinessTypesCache, getXmlByTemplate, buildXmlFromElements, renderElement, computeItemStyle, computeTableItemStyle, renderTable
|
||
- app/service/systems/sign.js (10)
|
||
- Constants, toXml, signTopRequest, verifyTopRequest, verifyAndExtractParams, generateSignedParams, encryptHMAC, encryptHMACSHA256, encryptMD5, byte2hex
|
||
- app/service/systems/space.js (1)
|
||
- searchSpace
|
||
- app/service/systems/stock_store.js (34)
|
||
- create, initQimenStockData, convertToQimenFormat, getItemInfoWithCache, getItemStorages, _calculateCacheTTL, clearItemStorageCache, lockItemStorages, ID, inbound, outbound, checkAndCreateWarehouseStock, getWarehouseStock, buildSequelizeCondition, processConditionValue, formatDate, isEmptyValue, getProhibitedType, getBarcodes, handleBatchChange, saveWarehouseStockBarcode, getStoreStocks, bindItem, unbindItem, getInfo, saveWarehouseStock, createWarehouseStock, validateSaveParams, stockLog, checkItemCodeUnique, handleBatchDelete, deleteUnit, deleteProhibited, search
|
||
- app/service/systems/storage/index.js (1)
|
||
- index
|
||
- app/service/systems/storage/receiving.js (16)
|
||
- getReceivingList, getReceivingDetail, batchCancelReceiving, isEmptyValue, buildSequelizeCondition, processConditionValue, create, get, addDetail, updateDetail, getStockStoreInfo, updateReceivingStats, deleteDetail, detailChange, invalid, completeReceiving
|
||
- app/service/systems/store.js (14)
|
||
- getStoreName, getStoreRemaskName, createStore, createWarehouse, joinStore, joinWarehouse, ensureEmployeeRoleBinding, assignAdminRoleToCreator, generateJoinToken, sendNotification, sendNotificationToAdmins, getStoreRoles, auditApply, loadStores
|
||
- app/service/systems/upload.js (14)
|
||
- initCOS, getUploadParams, hash_hmac, validateFileInfo, generateFileName, parseSizeToBytes, formatFileSize, getFrontendConfig, uploadFile, validateFile, uploadSuccessNotify, getMimeType, createFileReference, handleUploadCallback
|
||
<!-- SERVICE_METHOD_INVENTORY:END -->
|
||
|
||
|