'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 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); // 拉取商家订单(含明细),明细按店铺商品绑定关系写入系统商品关联 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); };