'use strict'; const MAX_DECIMAL_DIGITS = 20; /** * 将分表用的仓库 ID 规范为纯十进制数字串(与 wms_store.id / BIGINT 一致)。 * @param {*} value 待规范化的仓库 ID。 * @return {string} 规范化后的仓库 ID 字符串。 */ function normalizeWarehouseShardId(value) { if (value === null || value === undefined || value === '') { throw new Error('warehouse_id 不能为空'); } if (typeof value === 'object') { throw new Error('warehouse_id 必须为数字'); } const s = String(value).trim(); if (!/^\d+$/.test(s)) { throw new Error('warehouse_id 必须为数字'); } if (s === '0') { throw new Error('warehouse_id 非法'); } if (s.length > MAX_DECIMAL_DIGITS) { throw new Error('warehouse_id 超出范围'); } return s; } /** * 校验 wms_store 中存在对应 ID 且主体为仓库(project = warehouse)。 * @param {import('egg').Application} app 应用实例。 * @param {string} warehouseIdStr normalizeWarehouseShardId 的返回值。 * @return {Promise} */ async function assertWarehouseStoreSubject(app, warehouseIdStr) { if (!app.model || !app.model.Store) { return; } const row = await app.model.Store.findOne({ where: { id: warehouseIdStr, project: 'warehouse', }, attributes: [ 'id' ], paranoid: true, }); if (!row) { throw new Error(`仓库主体不存在或非仓库类型(wms_store.project 须为 warehouse): ${warehouseIdStr}`); } } function validatedSetFor(app) { if (!app._shardWarehouseIdsValidated) { app._shardWarehouseIdsValidated = new Set(); } return app._shardWarehouseIdsValidated; } /** * 规范化并校验仓库分表 ID。 * @param {import('egg').Application} app 应用实例。 * @param {*} raw 原始仓库 ID。 * @return {Promise} 规范化并校验后的仓库 ID 字符串。 */ async function ensureShardWarehouseId(app, raw) { const idStr = normalizeWarehouseShardId(raw); const validatedSet = validatedSetFor(app); if (validatedSet.has(idStr)) { return idStr; } await assertWarehouseStoreSubject(app, idStr); validatedSet.add(idStr); return idStr; } /** * 清理进程内「已校验仓库主体」缓存(例如单测或手动 clear 动态模型缓存时)。 * @param {import('egg').Application} app 应用实例。 * @return {void} */ function clearShardWarehouseValidationCache(app) { if (app && app._shardWarehouseIdsValidated) { app._shardWarehouseIdsValidated.clear(); } } module.exports = { normalizeWarehouseShardId, assertWarehouseStoreSubject, ensureShardWarehouseId, clearShardWarehouseValidationCache, };