外部系统调用 OMS /openapi 的请求与返回一直有写 callback_logs, 但没有任何查询入口,WMS 侧排查「回调有没有到、报了什么」只能翻服务器日志。 - 新增 GET /api/callback-logs:按主体隔离,支持仓库/接口配置/方法/app_key/ 结果/IP/关键词/时间范围过滤 + 分页 - 补 contract schema(callbackLogItem / callbackLogPage / callbackLogListResponse) - 外部接口页新增「回调日志」tab:展开可看请求参数、请求报文、返回报文、 异常信息、来源IP 与 app_key,并支持按当前仓库导出 Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
300 lines
31 KiB
JavaScript
300 lines
31 KiB
JavaScript
'use strict';
|
||
|
||
/**
|
||
* @param {Egg.Application} app - egg application
|
||
*/
|
||
module.exports = app => {
|
||
// 集团权限门禁:所在公司权限访问这些接口会被拒绝
|
||
const groupScope = app.middleware.groupScope;
|
||
const { router, controller } = app;
|
||
const jwtAuth = app.middleware.jwtAuth();
|
||
const principalCheck = app.middleware.principalCheck;
|
||
|
||
router.get('/', controller.home.index);
|
||
|
||
// 注册、登录、邮箱验证码接口无需鉴权
|
||
router.post('/api/auth/email-code', controller.auth.sendEmailCode);
|
||
// 邮箱验证码登录:发送登录验证码 + 校验验证码直接登录(公开接口,无需登录)
|
||
router.post('/api/auth/email-login/code', controller.auth.sendLoginCode);
|
||
router.post('/api/auth/email-login', controller.auth.loginByEmailCode);
|
||
// 忘记密码:发送 4 位重置验证码 + 校验验证码重置密码(公开接口,无需登录)
|
||
router.post('/api/auth/reset-password/code', controller.auth.sendResetCode);
|
||
router.post('/api/auth/reset-password', controller.auth.resetPasswordByCode);
|
||
router.post('/api/auth/register', controller.auth.register);
|
||
router.post('/api/auth/login', controller.auth.login);
|
||
// 以下接口需要登录:请求头 Authorization: Bearer <token>
|
||
router.get('/api/auth/profile', jwtAuth, controller.auth.profile);
|
||
// 自助服务:修改当前登录用户自己的资料与密码,所有登录账号均可访问
|
||
router.put('/api/auth/profile', jwtAuth, controller.auth.updateProfile);
|
||
router.put('/api/auth/password', jwtAuth, controller.auth.changePassword);
|
||
|
||
// 微信网关(公众号扫码):登录无需鉴权,绑定 / 解绑需登录
|
||
router.get('/api/auth/wechat/enabled', controller.wechatAuth.enabled);
|
||
router.post('/api/auth/wechat/login/code', controller.wechatAuth.createLoginCode);
|
||
router.get('/api/auth/wechat/login/status', controller.wechatAuth.loginStatus);
|
||
router.post('/api/auth/wechat/bind/code', jwtAuth, controller.wechatAuth.createBindCode);
|
||
router.get('/api/auth/wechat/bind/status', jwtAuth, controller.wechatAuth.bindStatus);
|
||
router.get('/api/auth/wechat/bind', jwtAuth, controller.wechatAuth.bindInfo);
|
||
router.delete('/api/auth/wechat/bind', jwtAuth, controller.wechatAuth.unbind);
|
||
// 微信网关扫码结果通知:由网关服务端回调,按签名校验(不用 JWT)
|
||
router.post('/api/wx/notify', controller.wechatAuth.notify);
|
||
|
||
// 菜单树需在 /api/menus/:id 之前注册,避免 tree 被当作 id 匹配
|
||
router.get('/api/menus/tree', jwtAuth, controller.menu.tree);
|
||
// 订单状态/外部 WMS 状态回写:按订单所属主体做跨主体隔离
|
||
router.put('/api/orders/:id/status', jwtAuth, principalCheck({ model: 'Order' }), controller.order.updateStatus);
|
||
router.put('/api/orders/:id/wms-status', jwtAuth, principalCheck({ model: 'Order' }), controller.order.updateWmsStatus);
|
||
router.put('/api/users/:id/password', jwtAuth, controller.user.resetPassword);
|
||
|
||
// RESTful 资源路由:index / show / create / update / destroy(均需鉴权)
|
||
router.resources('users', '/api/users', jwtAuth, controller.user);
|
||
// 头部主体切换下拉(带缓存),需在 /api/principals/:id 之前注册,避免 options 被当作 id 匹配
|
||
router.get('/api/principals/options', jwtAuth, controller.principal.options);
|
||
// 当前账号在主体下的权限范围(集团权限 / 所在公司权限),供前端收窄操作入口
|
||
router.get('/api/access/context', jwtAuth, controller.access.context);
|
||
// 管理端主体列表(不缓存,保证分页与筛选实时)
|
||
router.resources('principals', '/api/principals', jwtAuth, controller.principal);
|
||
// 组织架构 → 下属公司:按当前主体隔离(列表/新增取入参主体,详情/更新/删除按记录所属主体鉴权)
|
||
// select 需在 resources 之前注册,避免被 /:id 误匹配
|
||
router.get('/api/principal-subsidiaries/select', jwtAuth, principalCheck(), controller.principalSubsidiary.select);
|
||
router.resources('principalSubsidiaries', '/api/principal-subsidiaries', jwtAuth, principalCheck({ model: 'PrincipalSubsidiary' }), controller.principalSubsidiary);
|
||
// 员工微信绑定:拉取绑定码 / 轮询结果 / 解绑,需在 resources 之前注册,避免被 /:id 误匹配
|
||
router.post('/api/principal-users/:id/wechat/bind-code', jwtAuth, principalCheck({ model: 'PrincipalUser' }), controller.principalUser.wechatBindCode);
|
||
router.get('/api/principal-users/:id/wechat/bind-status', jwtAuth, principalCheck({ model: 'PrincipalUser' }), controller.principalUser.wechatBindStatus);
|
||
router.delete('/api/principal-users/:id/wechat/bind', jwtAuth, principalCheck({ model: 'PrincipalUser' }), controller.principalUser.wechatUnbind);
|
||
// 主体用户关联:需校验主体绑定关系
|
||
router.resources('principalUsers', '/api/principal-users', jwtAuth, principalCheck({ model: 'PrincipalUser' }), controller.principalUser);
|
||
// 权限管理:权限表(按菜单分类,每个菜单含集团全部/所在公司两种权限)
|
||
// menus / sync 需在 resources 之前注册,避免被 /:id 误匹配
|
||
router.get('/api/permissions/menus', jwtAuth, controller.permission.menus);
|
||
router.post('/api/permissions/sync', jwtAuth, controller.permission.sync);
|
||
router.resources('permissions', '/api/permissions', jwtAuth, controller.permission);
|
||
// 角色组:选项需在 resources 之前注册;系统预设角色后端只读
|
||
router.get('/api/roles/options', jwtAuth, controller.role.options);
|
||
router.resources('roles', '/api/roles', jwtAuth, controller.role);
|
||
// 邀请开通主体账号:创建新用户(随机密码)并绑定到指定主体
|
||
router.post('/api/principal-users/invite', jwtAuth, principalCheck({ model: 'PrincipalUser' }), controller.principalUser.invite);
|
||
// 商品快速搜索(聚合:商品编码/货品编码/条码/商品名称),需在 resources('products') 之前注册避免被 :id 误匹配
|
||
router.get('/api/products/search', jwtAuth, principalCheck({ model: 'Product' }), controller.product.search);
|
||
// 订单(状态分表):索引表 order_index(订单 ID 全局唯一 + current_table/current_status)
|
||
// + 6 张同构状态表(待审核/异常/委外中/配送/已作废/已取消)+ 历史表;页面按状态分视图,状态由业务事务推动
|
||
router.get('/api/order-status/list', jwtAuth, principalCheck(), controller.orderStatus.index);
|
||
router.get('/api/order-status/filters', jwtAuth, principalCheck(), controller.orderStatus.filters);
|
||
// 新建订单:写入索引表(取全局唯一 id)与待审核表;带 items 时为发货单口径创建(明细落 order_status_items)
|
||
router.post('/api/order-status', jwtAuth, principalCheck(), controller.orderStatus.create);
|
||
// 收件人文本智能识别(与老发货单同一能力)
|
||
router.post('/api/order-status/parse-receiver', jwtAuth, controller.orderStatus.parseReceiver);
|
||
// 商品明细:查询 / 整体保存(仅待审核、异常可维护)
|
||
router.get('/api/order-status/items', jwtAuth, principalCheck(), controller.orderStatus.items);
|
||
router.post('/api/order-status/items', jwtAuth, principalCheck(), controller.orderStatus.saveItems);
|
||
// 状态流转专用动作需在 /:id 之前注册,避免被误匹配:
|
||
// 审核(待审核/异常 → 委外中,含锁定库存)/ 推送外部标记 / 转回待审核 / 归档到历史
|
||
router.post('/api/order-status/audit', jwtAuth, principalCheck(), controller.orderStatus.audit);
|
||
router.post('/api/order-status/push', jwtAuth, principalCheck(), controller.orderStatus.push);
|
||
router.post('/api/order-status/return-to-pending', jwtAuth, principalCheck(), controller.orderStatus.returnToPending);
|
||
router.post('/api/order-status/archive', jwtAuth, principalCheck(), controller.orderStatus.archive);
|
||
// 侧路流转:驳回(换号+释放库存)/ 取消 / 作废 / 恢复
|
||
router.post('/api/order-status/reject', jwtAuth, principalCheck(), controller.orderStatus.reject);
|
||
router.post('/api/order-status/cancel', jwtAuth, principalCheck(), controller.orderStatus.cancel);
|
||
router.post('/api/order-status/void', jwtAuth, principalCheck(), controller.orderStatus.voidOrder);
|
||
router.post('/api/order-status/restore', jwtAuth, principalCheck(), controller.orderStatus.restore);
|
||
// 推送仓库(WMS deliveryorder.create):单条 / 批量
|
||
router.post('/api/order-status/push-wms', jwtAuth, principalCheck(), controller.orderStatus.pushWmsBatch);
|
||
// 批量切换仓库 / 修改待审核订单快递(同步刷新快照)
|
||
router.post('/api/order-status/change-warehouse', jwtAuth, principalCheck(), controller.orderStatus.changeWarehouse);
|
||
router.post('/api/order-status/change-logistics', jwtAuth, principalCheck(), controller.orderStatus.changeLogistics);
|
||
// 订单详情 / 编辑 / 删除(删除仅限待审核、异常、已取消)/ 推送仓库(单条)
|
||
router.get('/api/order-status/:id', jwtAuth, principalCheck(), controller.orderStatus.show);
|
||
router.put('/api/order-status/:id', jwtAuth, principalCheck(), controller.orderStatus.update);
|
||
router.delete('/api/order-status/:id', jwtAuth, principalCheck(), controller.orderStatus.destroy);
|
||
router.post('/api/order-status/:id/push-wms', jwtAuth, principalCheck(), controller.orderStatus.pushWms);
|
||
|
||
// 外部打单平台同步发货(配送后把发货结果同步回店管家):数量统计 / 批量重试
|
||
router.get('/api/external-send/counts', jwtAuth, principalCheck(), groupScope(), controller.externalSendSync.counts);
|
||
router.post('/api/external-send/retry', jwtAuth, principalCheck(), groupScope(), controller.externalSendSync.retry);
|
||
|
||
// 以下资源均归属某个主体,需做主体校验与数据隔离,防止跨主体操作
|
||
// 商品批量导入:模板下载与导入接口需在 resources 之前注册,避免被 /:id 误匹配
|
||
router.get('/api/products/import-template', jwtAuth, principalCheck(), controller.product.importTemplate);
|
||
router.post('/api/products/import', jwtAuth, principalCheck(), controller.product.importProducts);
|
||
router.resources('products', '/api/products', jwtAuth, principalCheck({ model: 'Product' }), controller.product);
|
||
router.resources('comboProducts', '/api/combo-products', jwtAuth, principalCheck({ model: 'ComboProduct' }), controller.comboProduct);
|
||
router.resources('menus', '/api/menus', jwtAuth, controller.menu);
|
||
router.resources('principalExternalApis', '/api/principal-external-apis', jwtAuth, principalCheck({ model: 'PrincipalExternalApi' }), controller.principalExternalApi);
|
||
// 仓库(仅基础信息)与仓库接口配置(一个仓库可有多条接口配置)
|
||
router.get('/api/warehouses/select', jwtAuth, principalCheck({ model: 'Warehouse' }), controller.warehouse.select);
|
||
// 仓库下的商品(是否已推送到该仓库):需在 resources('warehouses') 之前注册,避免 /products 被当作 :id
|
||
router.get('/api/warehouses/:id/products', jwtAuth, principalCheck({ model: 'Warehouse' }), controller.warehouseProduct.index);
|
||
// 仓库商品推送(商品资料推送到仓库 WMS):需在 resources('warehouses') 之前注册
|
||
router.post('/api/warehouses/:id/products/push', jwtAuth, principalCheck({ model: 'Warehouse' }), controller.warehouseProduct.push);
|
||
// 仓库商品 WMS 库存查询(按已推送商品的 WMS itemId 批量查询库存数量):需在 resources('warehouses') 之前注册
|
||
router.post('/api/warehouses/:id/products/wms-inventory', jwtAuth, principalCheck({ model: 'Warehouse' }), controller.warehouseProduct.wmsInventory);
|
||
// 库存同步:用外部 WMS 库存覆盖系统库存(差异以完成的出入库单平衡)
|
||
router.post('/api/warehouses/:id/inventory/sync', jwtAuth, principalCheck({ model: 'Warehouse' }), controller.warehouseProduct.syncInventory);
|
||
// 仓库维护仅集团权限可用(所在公司权限只读:列表/详情放行,写操作拒绝)
|
||
router.resources('warehouses', '/api/warehouses', jwtAuth, principalCheck({ model: 'Warehouse' }), groupScope({ allowGet: true }), controller.warehouse);
|
||
// 仓库接口配置项:定义(硬编码)与配置项值分开维护,需在 resources('warehouse-apis') 之前注册
|
||
// 接口配置、快递映射、调用日志均属于集团权限范围
|
||
router.get('/api/warehouse-api-fields', jwtAuth, principalCheck(), groupScope(), controller.warehouseApiField.index);
|
||
router.get('/api/warehouse-apis/:id/fields', jwtAuth, principalCheck({ model: 'WarehouseApi' }), groupScope(), controller.warehouseApiField.show);
|
||
router.put('/api/warehouse-apis/:id/fields', jwtAuth, principalCheck({ model: 'WarehouseApi' }), groupScope(), controller.warehouseApiField.update);
|
||
// 接口连通性测试(index.ping),需在 resources('warehouseApis') 之前注册
|
||
router.post('/api/warehouse-apis/:id/test', jwtAuth, principalCheck({ model: 'WarehouseApi' }), groupScope(), controller.warehouseApi.test);
|
||
router.resources('warehouseApis', '/api/warehouse-apis', jwtAuth, principalCheck({ model: 'WarehouseApi' }), groupScope(), controller.warehouseApi);
|
||
// 对外 API 调用日志(OMS → 外部 WMS 的请求记录),按主体隔离(principal_id 由前端拦截器注入 query)
|
||
router.get('/api/outbound-logs', jwtAuth, principalCheck(), groupScope(), controller.apiOutboundLog.index);
|
||
// 对外回调日志(外部系统 → OMS /openapi 的请求与返回),排查「回调有没有到、报了什么」
|
||
router.get('/api/callback-logs', jwtAuth, principalCheck(), groupScope(), controller.callbackLog.index);
|
||
// 订单整单解析需在 resources('orders') 之前注册,避免被 /api/orders/:id 误匹配
|
||
router.post('/api/orders/:id/parse-items', jwtAuth, principalCheck({ model: 'Order' }), controller.order.parseItems);
|
||
router.resources('orders', '/api/orders', jwtAuth, principalCheck({ model: 'Order' }), controller.order);
|
||
// 订单明细(订单副表):详情解析需在 resources('orderItems') 之前注册
|
||
router.post('/api/order-items/:id/parse', jwtAuth, principalCheck({ model: 'OrderItem' }), controller.orderItem.parse);
|
||
router.resources('orderItems', '/api/order-items', jwtAuth, principalCheck({ model: 'OrderItem' }), controller.orderItem);
|
||
// 店铺与店铺商品(采集的商品可绑定到系统商品或组合商品)
|
||
// 数据库店铺(type=3)的连接与表/字段映射配置:需在 resources('shops') 之前注册,避免 /database-config 被当成 :id
|
||
router.get('/api/shops/:id/database-config', jwtAuth, principalCheck({ model: 'Shop' }), controller.shopDatabase.show);
|
||
router.put('/api/shops/:id/database-config', jwtAuth, principalCheck({ model: 'Shop' }), controller.shopDatabase.save);
|
||
router.post('/api/shops/:id/database-config/test', jwtAuth, principalCheck({ model: 'Shop' }), controller.shopDatabase.test);
|
||
router.post('/api/shops/:id/database-config/connect', jwtAuth, principalCheck({ model: 'Shop' }), controller.shopDatabase.connect);
|
||
router.get('/api/shops/:id/database-config/tables', jwtAuth, principalCheck({ model: 'Shop' }), controller.shopDatabase.tables);
|
||
router.get('/api/shops/:id/database-config/columns', jwtAuth, principalCheck({ model: 'Shop' }), controller.shopDatabase.columns);
|
||
// 数据库店铺拉取(服务端连客户库):店铺商品 / 订单
|
||
router.post('/api/shops/:id/database-config/pull-products', jwtAuth, principalCheck({ model: 'Shop' }), controller.shopDatabase.pullProducts);
|
||
router.post('/api/shops/:id/database-config/pull-orders', jwtAuth, principalCheck({ model: 'Shop' }), controller.shopDatabase.pullOrders);
|
||
// 店铺默认发货仓库:单独维护(外部打单平台店铺的所在公司权限也可配置),需在 resources('shops') 之前注册
|
||
router.put('/api/shops/:id/default-warehouse', jwtAuth, principalCheck({ model: 'Shop' }), controller.shop.setDefaultWarehouse);
|
||
// 刷新店铺「所在区」(重新拉取所属打单账号的商家列表,写回分区声明;商家已解绑则自动禁用店铺)
|
||
router.post('/api/shops/:id/refresh-area', jwtAuth, principalCheck({ model: 'Shop' }), controller.shop.refreshArea);
|
||
router.resources('shops', '/api/shops', jwtAuth, principalCheck({ model: 'Shop' }), controller.shop);
|
||
// 店铺商品完全来自平台采集:不提供手工新增 / 编辑 / 删除,只保留查询与绑定;
|
||
// 同步商品时平台已不存在的商品会自动移除
|
||
router.get('/api/shop-products', jwtAuth, principalCheck({ model: 'ShopProduct' }), controller.shopProduct.index);
|
||
// 批量绑定需在 /:id 路由之前注册,避免 batch-bind 被当成 :id
|
||
router.post('/api/shop-products/batch-bind', jwtAuth, principalCheck({ model: 'ShopProduct' }), controller.shopProduct.batchBind);
|
||
router.get('/api/shop-products/:id', jwtAuth, principalCheck({ model: 'ShopProduct' }), controller.shopProduct.show);
|
||
router.post('/api/shop-products/:id/bind', jwtAuth, principalCheck({ model: 'ShopProduct' }), controller.shopProduct.bind);
|
||
// 操作日志:店铺商品 / 系统商品 / 组合商品的历史操作记录(页面底部面板按对象查询)
|
||
router.get('/api/operation-logs', jwtAuth, principalCheck(), controller.operationLog.index);
|
||
// 外部打单平台:平台基础资料由开发者维护(只读查询);打单账号归属主体,在「店铺管理」下维护
|
||
// 打单平台相关接口(平台资料、账号、商家导入、快递接口)均属于集团权限范围
|
||
router.get('/api/external-print-platforms', jwtAuth, groupScope(), controller.externalPrintPlatform.index);
|
||
// 账号登录态检查 / 登录(需在 resources 之前注册,避免被 /:id 误匹配)
|
||
router.post('/api/external-print-accounts/:id/check', jwtAuth, principalCheck({ model: 'ExternalPrintAccount' }), groupScope(), controller.externalPrintAccount.check);
|
||
router.post('/api/external-print-accounts/:id/login', jwtAuth, principalCheck({ model: 'ExternalPrintAccount' }), groupScope(), controller.externalPrintAccount.login);
|
||
// 平台侧店铺(商家)列表与创建到 OMS 店铺(前端按账号ID调用,后端按平台服务分发)
|
||
router.get('/api/external-print-accounts/:id/merchants', jwtAuth, principalCheck({ model: 'ExternalPrintAccount' }), groupScope(), controller.externalPrintAccount.merchants);
|
||
router.post('/api/external-print-accounts/:id/shops', jwtAuth, principalCheck({ model: 'ExternalPrintAccount' }), groupScope(), controller.externalPrintAccount.createShops);
|
||
// 刷新账号下店铺「所在区」:一次拉取账号全部商家(同账号多店铺共享),商家已解绑的店铺自动禁用
|
||
router.post('/api/external-print-accounts/:id/refresh-shops-area', jwtAuth, principalCheck({ model: 'ExternalPrintAccount' }), groupScope(), controller.externalPrintAccount.refreshShopAreas);
|
||
// 同步商家店铺商品(按商家分区逐域名拉取全量快照后写入店铺商品表)
|
||
router.post('/api/external-print-accounts/:id/shops/:shopId/sync-products', jwtAuth, principalCheck({ model: 'ExternalPrintAccount' }), controller.externalPrintAccount.syncShopProducts);
|
||
// 按平台商品ID单独补拉(订单明细匹配不到店铺商品时使用,不做下架处理)
|
||
router.post('/api/external-print-accounts/:id/shops/:shopId/pull-products', jwtAuth, principalCheck({ model: 'ExternalPrintAccount' }), groupScope(), controller.externalPrintAccount.pullShopProducts);
|
||
// 拉取商家订单(含明细),明细按店铺商品绑定关系写入系统商品关联
|
||
router.post('/api/external-print-accounts/:id/shops/:shopId/sync-orders', jwtAuth, principalCheck({ model: 'ExternalPrintAccount' }), controller.externalPrintAccount.syncShopOrders);
|
||
// 快递接口(面单模板):查看读取已落库数据,手动同步全量拉取;保存绑定的快递编码,明细单独请求平台接口
|
||
router.get('/api/external-print-accounts/:id/express-interfaces', jwtAuth, principalCheck({ model: 'ExternalPrintAccount' }), groupScope(), controller.externalPrintExpressInterface.index);
|
||
router.post('/api/external-print-accounts/:id/sync-express-interfaces', jwtAuth, principalCheck({ model: 'ExternalPrintAccount' }), groupScope(), controller.externalPrintExpressInterface.sync);
|
||
router.put('/api/external-print-accounts/:id/express-interfaces', jwtAuth, principalCheck({ model: 'ExternalPrintAccount' }), groupScope(), controller.externalPrintExpressInterface.saveSettings);
|
||
router.get('/api/external-print-accounts/:id/express-interfaces/:interfaceId/detail', jwtAuth, principalCheck({ model: 'ExternalPrintAccount' }), groupScope(), controller.externalPrintExpressInterface.detail);
|
||
router.resources('externalPrintAccounts', '/api/external-print-accounts', jwtAuth, principalCheck({ model: 'ExternalPrintAccount' }), groupScope(), controller.externalPrintAccount);
|
||
// 出入库单与明细(明细共用 stock_items 表,以 bill_type 区分:1入库 2出库)
|
||
// 单据状态由业务事务推动(审核/推送/完成/驳回/作废/取消/恢复),不提供直接修改状态的接口
|
||
// 状态流转(按序校验):审核 / 推送 / 完成 / 取消 / 恢复 / 作废,需在 resources 之前注册避免被 :id 误匹配
|
||
router.post('/api/inbound-orders/:id/audit', jwtAuth, principalCheck({ model: 'InboundOrder' }), controller.inboundOrder.audit);
|
||
router.post('/api/inbound-orders/:id/push', jwtAuth, principalCheck({ model: 'InboundOrder' }), controller.inboundOrder.push);
|
||
router.post('/api/inbound-orders/:id/complete', jwtAuth, principalCheck({ model: 'InboundOrder' }), controller.inboundOrder.complete);
|
||
router.post('/api/inbound-orders/:id/cancel', jwtAuth, principalCheck({ model: 'InboundOrder' }), controller.inboundOrder.cancel);
|
||
router.post('/api/inbound-orders/:id/restore', jwtAuth, principalCheck({ model: 'InboundOrder' }), controller.inboundOrder.restore);
|
||
// 作废:已审核(2) 的单据只能作废(禁止删除),记录作废人/时间/原因
|
||
router.post('/api/inbound-orders/:id/void', jwtAuth, principalCheck({ model: 'InboundOrder' }), controller.inboundOrder.voidOrder);
|
||
// 驳回:已审核(2)/已推送(3) 且未完成,驳回后回到待处理(1);已推送的先走接口取消外部单据
|
||
router.post('/api/inbound-orders/:id/reject', jwtAuth, principalCheck({ model: 'InboundOrder' }), controller.inboundOrder.reject);
|
||
router.post('/api/outbound-orders/:id/audit', jwtAuth, principalCheck({ model: 'OutboundOrder' }), controller.outboundOrder.audit);
|
||
router.post('/api/outbound-orders/:id/push', jwtAuth, principalCheck({ model: 'OutboundOrder' }), controller.outboundOrder.push);
|
||
router.post('/api/outbound-orders/:id/complete', jwtAuth, principalCheck({ model: 'OutboundOrder' }), controller.outboundOrder.complete);
|
||
router.post('/api/outbound-orders/:id/cancel', jwtAuth, principalCheck({ model: 'OutboundOrder' }), controller.outboundOrder.cancel);
|
||
router.post('/api/outbound-orders/:id/restore', jwtAuth, principalCheck({ model: 'OutboundOrder' }), controller.outboundOrder.restore);
|
||
router.post('/api/outbound-orders/:id/void', jwtAuth, principalCheck({ model: 'OutboundOrder' }), controller.outboundOrder.voidOrder);
|
||
// 驳回:已审核(2)/已推送(3) 且未完成,驳回后回到待处理(1);已推送的先走接口取消外部单据
|
||
router.post('/api/outbound-orders/:id/reject', jwtAuth, principalCheck({ model: 'OutboundOrder' }), controller.outboundOrder.reject);
|
||
router.resources('inboundOrders', '/api/inbound-orders', jwtAuth, principalCheck({ model: 'InboundOrder' }), controller.inboundOrder);
|
||
router.resources('outboundOrders', '/api/outbound-orders', jwtAuth, principalCheck({ model: 'OutboundOrder' }), controller.outboundOrder);
|
||
router.resources('stockItems', '/api/stock-items', jwtAuth, principalCheck({ model: 'StockItem' }), controller.stockItem);
|
||
// 出入库记录(库存流水):只读列表 + 业务动作选项(下拉),按主体隔离;记录由业务事务写入,不提供增删改接口
|
||
router.get('/api/stock-records/biz-types', jwtAuth, principalCheck(), controller.stockRecord.bizTypes);
|
||
router.get('/api/stock-records', jwtAuth, principalCheck(), controller.stockRecord.index);
|
||
// 仪表盘报表(只读聚合:概览/单据状态/趋势/库存 Top/最近流水),按主体隔离(principal_id 由前端拦截器注入 query)
|
||
router.get('/api/dashboard/report', jwtAuth, principalCheck(), controller.dashboard.report);
|
||
// 快递公司字典(通用字典,不区分主体):下拉需在 resources 之前注册,避免 /select 被当作 :id
|
||
router.get('/api/express-companies/select', jwtAuth, controller.expressCompany.select);
|
||
router.resources('expressCompanies', '/api/express-companies', jwtAuth, controller.expressCompany);
|
||
// 自定义快递编码(全局字典):订单选快递 / 快递接口绑定共用;options 需在 resources 之前注册
|
||
router.get('/api/custom-express-codes/options', jwtAuth, controller.customExpressCode.options);
|
||
router.resources('customExpressCodes', '/api/custom-express-codes', jwtAuth, controller.customExpressCode);
|
||
|
||
// 商品属性字典(分类/品牌/单位,按主体隔离):下拉需在 resources 之前注册,避免 /select 被当作 :id
|
||
router.get('/api/product-categories/select', jwtAuth, principalCheck({ model: 'ProductCategory' }), controller.productCategory.select);
|
||
router.resources('productCategories', '/api/product-categories', jwtAuth, principalCheck({ model: 'ProductCategory' }), controller.productCategory);
|
||
router.get('/api/product-brands/select', jwtAuth, principalCheck({ model: 'ProductBrand' }), controller.productBrand.select);
|
||
router.resources('productBrands', '/api/product-brands', jwtAuth, principalCheck({ model: 'ProductBrand' }), controller.productBrand);
|
||
router.get('/api/product-units/select', jwtAuth, principalCheck({ model: 'ProductUnit' }), controller.productUnit.select);
|
||
router.resources('productUnits', '/api/product-units', jwtAuth, principalCheck({ model: 'ProductUnit' }), controller.productUnit);
|
||
|
||
// 仓库快递映射(外部传入的自定义快递编码 → OMS 默认快递编码,按仓库维度;供回传解析与「外部仓库」页配置)
|
||
// 仓库快递映射(按主体隔离):属于仓库/接口配置维护,仅集团权限可用
|
||
router.resources('warehouseExpressMappings', '/api/warehouse-express-mappings', jwtAuth, principalCheck({ model: 'WarehouseExpressMapping' }), app.middleware.groupScope(), controller.warehouseExpressMapping);
|
||
|
||
// 收件人信息智能识别(通用能力,仅需登录):需在 resources 之前注册,避免被 /:id 误匹配
|
||
router.post('/api/order-deliveries/parse-receiver', jwtAuth, controller.orderDelivery.parseReceiver);
|
||
|
||
// 批量切换发货仓库(按勾选 ids 或筛选条件;dry_run=true 仅预览影响范围)
|
||
router.post('/api/order-deliveries/change-warehouse', jwtAuth, principalCheck({ model: 'OrderDelivery' }), controller.orderDelivery.changeWarehouse);
|
||
|
||
// 批量设置所属店铺(shopNick 取店铺名称;dry_run=true 仅预览影响范围)
|
||
router.post('/api/order-deliveries/change-shop', jwtAuth, principalCheck({ model: 'OrderDelivery' }), controller.orderDelivery.changeShop);
|
||
// 发货单(订单):字段口径对齐 WMS 发货单(wms_order_delivery)与奇门 deliveryOrder,独立于出库单
|
||
// 状态流转专用动作需在 resources 之前注册,避免被 /api/order-deliveries/:id 误匹配
|
||
router.post('/api/order-deliveries/audit-batch', jwtAuth, principalCheck({ model: 'OrderDelivery' }), controller.orderDelivery.auditBatch);
|
||
router.post('/api/order-deliveries/push-batch', jwtAuth, principalCheck({ model: 'OrderDelivery' }), controller.orderDelivery.pushBatch);
|
||
router.post('/api/order-deliveries/:id/audit', jwtAuth, principalCheck({ model: 'OrderDelivery' }), controller.orderDelivery.audit);
|
||
router.post('/api/order-deliveries/:id/push', jwtAuth, principalCheck({ model: 'OrderDelivery' }), controller.orderDelivery.push);
|
||
router.post('/api/order-deliveries/:id/reject', jwtAuth, principalCheck({ model: 'OrderDelivery' }), controller.orderDelivery.reject);
|
||
router.post('/api/order-deliveries/:id/cancel', jwtAuth, principalCheck({ model: 'OrderDelivery' }), controller.orderDelivery.cancel);
|
||
router.post('/api/order-deliveries/:id/restore', jwtAuth, principalCheck({ model: 'OrderDelivery' }), controller.orderDelivery.restore);
|
||
router.post('/api/order-deliveries/:id/void', jwtAuth, principalCheck({ model: 'OrderDelivery' }), controller.orderDelivery.voidOrder);
|
||
router.resources('orderDeliveries', '/api/order-deliveries', jwtAuth, principalCheck({ model: 'OrderDelivery' }), controller.orderDelivery);
|
||
// 发货单明细(子表商品明细,对应奇门 orderLines):明细锁定校验在控制器内按单据状态判断
|
||
router.resources('orderDeliveryItems', '/api/order-delivery-items', jwtAuth, principalCheck({ model: 'OrderDeliveryItem' }), controller.orderDeliveryItem);
|
||
|
||
// 导出任务(全局任务池):提交即返回任务ID,定时任务逐个处理,前端轮询进度,完成后触发下载
|
||
// 文件按 年/月/日 分目录存储;列表/提交按主体隔离,详情/下载按任务所属主体鉴权
|
||
router.get('/api/export-tasks/types', jwtAuth, controller.exportTask.types);
|
||
router.post('/api/export-tasks', jwtAuth, principalCheck(), controller.exportTask.submit);
|
||
router.get('/api/export-tasks', jwtAuth, principalCheck(), controller.exportTask.index);
|
||
router.get('/api/export-tasks/:id', jwtAuth, principalCheck({ model: 'ExportTask' }), controller.exportTask.progress);
|
||
router.get('/api/export-tasks/:id/download', jwtAuth, principalCheck({ model: 'ExportTask' }), controller.exportTask.download);
|
||
|
||
// 拉单任务(异步任务池):一键拉取外部打单平台店铺订单,定时任务逐店执行,前端轮询进度
|
||
// 注意:/running 必须在 /:id 之前注册,避免被当成任务ID
|
||
router.post('/api/order-sync-tasks', jwtAuth, principalCheck(), controller.orderSyncTask.submit);
|
||
router.get('/api/order-sync-tasks', jwtAuth, principalCheck(), controller.orderSyncTask.index);
|
||
router.get('/api/order-sync-tasks/running', jwtAuth, principalCheck(), controller.orderSyncTask.running);
|
||
router.get('/api/order-sync-tasks/:id', jwtAuth, principalCheck({ model: 'OrderSyncTask' }), controller.orderSyncTask.progress);
|
||
|
||
// 文件资源:check/upload 需登录并按主体隔离;raw 为公开读取(URL 含内容 hash,不可枚举)
|
||
// raw 通配路由需在 resources('files') 之前注册,避免被 /api/files/:id 误匹配
|
||
router.post('/api/files/check', jwtAuth, principalCheck(), controller.file.check);
|
||
router.post('/api/files/upload', jwtAuth, principalCheck(), controller.file.upload);
|
||
router.get('/api/files/raw/(.*)', controller.file.raw);
|
||
router.resources('files', '/api/files', jwtAuth, principalCheck({ model: 'File' }), controller.file);
|
||
|
||
// WMS 出站通知回调(公开接口,无需登录):按 app_key 校验仓库接口配置 + MD5 签名校验
|
||
router.post('/wms/notify', controller.wmsNotify.handle);
|
||
|
||
// 对外通用回调接口(公开接口,无需登录):外部系统以 method/app_key/v/timestamp/sign 调用,
|
||
// 按 app_key 定位仓库接口配置与仓库后按 method 分发;协议与 WMS /openapi 对齐,已暴露 index.ping
|
||
router.post('/openapi', controller.openapi.index);
|
||
};
|