'use strict'; /** * 订单分表跨表查询共享工具。 * * 订单按仓库分表且按生命周期流转于多张物理表之间: * current(待出库)→ dispatch(配送)→ history(历史归档),另有 outsourced(外包)。 * 各分表唯一索引均为 (delivery_order_code, store_id, warehouse_id),跨表间约束独立。 * 任何"按单号判断订单是否存在/可用"的场景都必须跨表遍历,否则会误判 * (如订单已流转到 dispatch 后,仅查 current 会返回"未找到订单",诱导调用方重推)。 * * 注意事项: * - 分表模型首次获取可能执行 DDL(隐式提交),因此必须在事务外调用 preloadOrderModels * 完成模型预取,再在事务内用 findOrderAcrossTables 查询; * - findOrderByCodeAcrossTables 内部会预取模型,仅适用于非事务场景。 */ /** 默认跨表查找顺序:current → dispatch → history → outsourced。 */ const TABLE_TYPE_ORDER = [ 'current', 'dispatch', 'history', 'outsourced' ]; /** 表位 → OrderDeliveryFactory 模型获取方法名。 */ const MODEL_GETTER_BY_TYPE = { current: 'getCurrentModel', dispatch: 'getDispatchModel', history: 'getHistoryModel', outsourced: 'getOutsourcedModel', }; /** * 预取订单分表模型。 * 必须在事务外调用:模型首次获取可能执行 DDL(隐式提交)。 * * @param {Object} ctx egg ctx。 * @param {string|number} warehouseId 仓库ID(分表后缀)。 * @param {string[]} [tableTypes] 需要预取的表位,默认四表。 * @return {Promise} 表位 → 模型 的映射(缺失模型不会出现在结果中)。 */ async function preloadOrderModels(ctx, warehouseId, tableTypes = TABLE_TYPE_ORDER) { const factory = ctx && ctx.model && ctx.model.OrderDeliveryFactory; if (!factory) { throw new Error('OrderDeliveryFactory 不可用,无法跨表查询订单'); } const models = {}; for (const tableType of tableTypes) { const getter = MODEL_GETTER_BY_TYPE[tableType]; if (!getter || typeof factory[getter] !== 'function') { continue; } const model = await factory[getter](warehouseId); if (model && typeof model.findOne === 'function') { models[tableType] = model; } } return models; } /** * 跨表按条件查找订单,按 tableTypes 顺序命中即停。 * * @param {Object} models preloadOrderModels 返回的表位 → 模型映射。 * @param {Object} where 查询条件(findOne where,例如 delivery_order_code + store_id + warehouse_id)。 * @param {Object} [options] 可选配置。 * @param {string[]} [options.tableTypes] 查找表位顺序,默认四表。 * @param {Object} [options.findOptions] 透传给 findOne 的其余选项(transaction/lock/attributes 等)。 * @return {Promise<{ order: Object|null, location: string|null }>} 命中订单与所在表位;未命中 order=null。 */ async function findOrderAcrossTables(models, where, options = {}) { const { tableTypes = TABLE_TYPE_ORDER, findOptions = {} } = options; for (const tableType of tableTypes) { const model = models && models[tableType]; if (!model || typeof model.findOne !== 'function') { continue; } const order = await model.findOne({ where, ...findOptions, }); if (order) { return { order, location: tableType }; } } return { order: null, location: null }; } /** * 便捷入口:预取模型后按条件跨表查找(仅限非事务场景)。 * 事务内请使用 preloadOrderModels + findOrderAcrossTables。 * * @param {Object} ctx egg ctx。 * @param {string|number} warehouseId 仓库ID。 * @param {Object} where 查询条件。 * @param {Object} [options] 同 findOrderAcrossTables 的 options,另支持 tableTypes 用于预取过滤。 * @return {Promise<{ order: Object|null, location: string|null }>} 命中订单与所在表位;未命中 order 为 null。 */ async function findOrderByCodeAcrossTables(ctx, warehouseId, where, options = {}) { const models = await preloadOrderModels(ctx, warehouseId, options.tableTypes); return findOrderAcrossTables(models, where, options); } module.exports = { TABLE_TYPE_ORDER, preloadOrderModels, findOrderAcrossTables, findOrderByCodeAcrossTables, };