diff --git a/app/service/systems/stock_check.js b/app/service/systems/stock_check.js index 678f1c4..963fa6b 100644 --- a/app/service/systems/stock_check.js +++ b/app/service/systems/stock_check.js @@ -4930,7 +4930,8 @@ class StockCheckService extends Service { * Sheet1「汇总和差异」——每商品一行(盘点单号/商品编码/商品名称/规格/账面数量(快照合计)/ * 盘点数量/差异数量/差异类型(盘盈|盘亏,未盘留空);未知商品(条码维度,无账面、差异=实盘=盘盈) * 追加在末尾; - * Sheet2「库位明细」——每商品每库位一行(库位编码/数量(实盘,未盘 0)/条码/商品名称)。 + * Sheet2「库位明细」——直接按作业记录(wms_stock_check_record)一行一条实际盘点记录 + * (库位编码/数量(实盘)/条码/商品名称;未知商品条码=扫描条码)。 * - 库位范围(scope_type=location):Sheet「盘点明细」——库位编码/商品编码/商品名称/盘点数量 * (作业记录口径,未知商品编码=扫描条码,空库位标记商品为空、数量 0)。 * 流式生成 Excel → COS 上传;通过 onProgress 回调实时推送进度。 @@ -5024,15 +5025,34 @@ class StockCheckService extends Service { } } + // 库位显示覆盖:自定义名称优先 → 自定义编码次之 → 最后才显示库位编码 + const locationDisplayMap = new Map(); + const recordLocationCodes = [ ...new Set(records + .map(record => String(record.location_code || '').trim()) + .filter(Boolean)) ]; + if (recordLocationCodes.length > 0) { + const spaceRows = await ctx.model.LocationSpace.findAll({ + where: { + warehouse_id: Number(warehouseId), + space_code: { [Op.in]: recordLocationCodes }, + }, + attributes: [ 'space_code', 'custom_name', 'custom_barcode' ], + raw: true, + }); + for (const spaceRow of spaceRows) { + locationDisplayMap.set(String(spaceRow.space_code || '').trim(), { + custom_name: String(spaceRow.custom_name || '').trim(), + custom_barcode: String(spaceRow.custom_barcode || '').trim(), + }); + } + } + const totalCount = isLocationScope ? records.length : goodsRows.reduce( (sum, row) => sum + 1 + (Array.isArray(row.unknown_items) ? row.unknown_items.length : 0), 0 - ) + goodsRows.reduce( - (sum, row) => sum + (Array.isArray(row.locations) ? row.locations.length : 0), - 0 - ); + ) + records.length; await reportProgress('running', 10, `正在导出盘点明细(共 ${totalCount} 行)...`, { totalCount, @@ -5046,6 +5066,7 @@ class StockCheckService extends Service { records, stockMap, barcodeMap, + locationDisplayMap, totalCount, onProgress, }); @@ -5063,6 +5084,26 @@ class StockCheckService extends Service { }; } + /** + * 库位编码显示覆盖:自定义名称优先 → 自定义编码(custom_barcode)次之 → 库位编码(space_code)兜底; + * 库位编码为空或无匹配库位时返回空/库位编码。 + * + * @param {string} locationCode 作业记录库位编码。 + * @param {Map} locationDisplayMap 库位编码 → { custom_name, custom_barcode } 映射。 + * @return {string} 显示用的库位文本。 + */ + _resolveLocationDisplayCode(locationCode, locationDisplayMap = new Map()) { + const code = String(locationCode || '').trim(); + if (!code) { + return ''; + } + const space = locationDisplayMap.get(code); + if (!space) { + return code; + } + return space.custom_name || space.custom_barcode || code; + } + /** * 生成盘点明细导出 Excel 并上传 COS(Sheet 结构随盘点范围变化,见 exportCheckDetail)。 * @@ -5073,6 +5114,7 @@ class StockCheckService extends Service { * @param {Array} params.records 作业记录原始行。 * @param {Map} params.stockMap 商品快照映射(库位范围用)。 * @param {Map} params.barcodeMap 商品条码映射(商品范围库位明细 sheet 用)。 + * @param {Map} params.locationDisplayMap 库位显示覆盖映射(库位编码 → { custom_name, custom_barcode })。 * @param {number} params.totalCount 总行数(进度计算用)。 * @param {Function} [params.onProgress] 进度回调。 * @return {Promise} { filename, fileKey, url, cdnUrl, cosUrl }。 @@ -5085,6 +5127,7 @@ class StockCheckService extends Service { records = [], stockMap = new Map(), barcodeMap = new Map(), + locationDisplayMap = new Map(), totalCount = 0, onProgress, } = params; @@ -5131,7 +5174,7 @@ class StockCheckService extends Service { const isUnknownGoods = !Number.isInteger(recordStockId) || recordStockId <= 0; const stock = stockMap.get(recordStockId) || {}; sheet.addRow([ - String(record.location_code || '').trim(), + this._resolveLocationDisplayCode(record.location_code, locationDisplayMap), record.is_empty ? '' : (isUnknownGoods ? String(record.barcode || '').trim() : (stock.item_code || '')), record.is_empty ? '' : (isUnknownGoods ? String(record.item_name || record.barcode || '').trim() : (stock.item_name || '')), record.is_empty ? 0 : (Number(record.quantity) || 0), @@ -5185,20 +5228,24 @@ class StockCheckService extends Service { ]).commit(); await reportRowProgress(); } - - // 库位明细:库位 / 数量(实盘,未盘 0)/ 条码 / 商品名称 - const stockId = Number(row.stock_id); - const barcode = barcodeMap.get(stockId) || ''; - for (const location of (Array.isArray(row.locations) ? row.locations : [])) { - locationSheet.addRow([ - location.location_code || '', - Number(location.quantity) || 0, - barcode, - row.item_name || '', - ]).commit(); - await reportRowProgress(); - } } + + // 库位明细:直接按作业记录(wms_stock_check_record)一行一条实际盘点记录 + const itemNameByStock = new Map(goodsRows + .filter(row => row.stock_id) + .map(row => [ Number(row.stock_id), row.item_name || '' ])); + for (const record of records) { + const recordStockId = Number(record.stock_id); + const isUnknownGoods = !Number.isInteger(recordStockId) || recordStockId <= 0; + locationSheet.addRow([ + this._resolveLocationDisplayCode(record.location_code, locationDisplayMap), + record.is_empty ? 0 : (Number(record.quantity) || 0), + record.is_empty ? '' : (isUnknownGoods ? String(record.barcode || '').trim() : (barcodeMap.get(recordStockId) || '')), + record.is_empty ? '' : (isUnknownGoods ? String(record.item_name || record.barcode || '').trim() : (itemNameByStock.get(recordStockId) || '')), + ]).commit(); + await reportRowProgress(); + } + summarySheet.commit(); locationSheet.commit(); } diff --git a/methods/changes/system.json b/methods/changes/system.json index feb68fa..077b94c 100644 --- a/methods/changes/system.json +++ b/methods/changes/system.json @@ -11,7 +11,7 @@ "接口:stock.check.exportDetail,入参 id(盘点任务ID,必填);异步执行,立即返回 task_id,进度查询复用 stock.check.exportTaskProgress。", "商品盘点固定两个 Sheet:Sheet1「汇总和差异」每商品一行(盘点单号/商品编码/商品名称/规格/账面数量(明细行 system_quantity 快照合计,提交审核时刷新)/盘点数量/差异数量/差异类型(盘盈|盘亏,无差异或未盘留空);未知商品追加在末尾(无账面、差异=实盘=盘盈);Sheet2「库位明细」每商品每库位一行(库位编码/数量(实盘,未盘 0)/条码(wms_stock_barcodes 第一条)/商品名称)。", "库位盘点:Sheet「盘点明细」作业记录口径(库位编码/商品编码/商品名称/盘点数量),未知商品编码=扫描条码、空库位标记商品为空数量 0。", - "迭代记录:首版按 mode 二选一(location 单 sheet / summary 两 sheet),用户纠正为商品盘点固定两 sheet(汇总和差异 + 库位明细精简列),mode 入参已移除。", + "迭代记录:首版按 mode 二选一(location 单 sheet / summary 两 sheet),用户纠正为商品盘点固定两 sheet(汇总和差异 + 库位明细精简列),mode 入参已移除;随后纠正「库位明细」按作业记录(wms_stock_check_record)一行一条实际盘点记录导出(不再按快照库位展开/合并无库位组);最后补充库位编码列显示覆盖(custom_name → custom_barcode → space_code)。", "代码依据:app/service/systems/stock_check.js#exportCheckDetail/#_generateAndUploadCheckDetailExcel(商品范围复用 result 的商品合并聚合;新增 StockBarcode 条码查询)/#_uploadExportExcelFile(原 _generateAndUploadStockCheckExcel 上传段抽为公共方法,两处导出一致复用)+ app/service/systemMethods/stock/check.js#exportDetail(ALL_METHOD_NAMES/_noNeedLog 已加入);回归测试 3 用例(商品两 sheet 回读断言/库位任务/方法层异步轮询至 success),stock_check 全量 235 用例通过、ESLint 0 错误。", "文档变更范围:methods/system.json 的 module=stock.check 分组新增 stock.check.exportDetail 一条(位于 stock.check.export 之后,分组由 24 条增至 25 条);根版本 0.3.260 → 0.3.261、updatedAt 保持 2026-10-10;methods/changes/system.json 新增本条(插入数组首位);其余 24 条 method 未改动。" ] diff --git a/methods/system.json b/methods/system.json index 41b4f6f..583bcb0 100644 --- a/methods/system.json +++ b/methods/system.json @@ -40453,7 +40453,7 @@ }, { "method": "stock.check.exportDetail", - "description": "提交盘点明细导出任务(异步,单任务,按盘点范围分流):商品范围任务(scope_type=goods)固定两个 Sheet——Sheet1「汇总和差异」(每商品一行,列:盘点单号/商品编码/商品名称/规格/账面数量(明细行 system_quantity 快照合计,提交审核时刷新)/盘点数量/差异数量/差异类型(盘盈|盘亏,无差异或未盘留空);未知商品(条码维度,无账面、差异=实盘=盘盈)追加在末尾)+ Sheet2「库位明细」(每商品每库位一行,列:库位编码/数量(实盘,未盘 0)/条码(wms_stock_barcodes 第一条)/商品名称);库位范围任务(scope_type=location)Sheet「盘点明细」(作业记录口径,列:库位编码/商品编码/商品名称/盘点数量;未知商品编码=扫描条码、空库位标记商品为空数量 0)。ExcelJS 流式生成后上传 COS;进度通过 Redis 缓存(key stock_check_export_task_*,TTL 1800 秒)追踪,立即返回任务ID;进度查询复用 stock.check.exportTaskProgress。", + "description": "提交盘点明细导出任务(异步,单任务,按盘点范围分流):商品范围任务(scope_type=goods)固定两个 Sheet——Sheet1「汇总和差异」(每商品一行,列:盘点单号/商品编码/商品名称/规格/账面数量(明细行 system_quantity 快照合计,提交审核时刷新)/盘点数量/差异数量/差异类型(盘盈|盘亏,无差异或未盘留空);未知商品(条码维度,无账面、差异=实盘=盘盈)追加在末尾)+ Sheet2「库位明细」(直接按作业记录 wms_stock_check_record 一行一条实际盘点记录,列:库位编码/数量(实盘)/条码(wms_stock_barcodes 第一条)/商品名称;未知商品条码=扫描条码);库位范围任务(scope_type=location)Sheet「盘点明细」(作业记录口径,列:库位编码/商品编码/商品名称/盘点数量;未知商品编码=扫描条码、空库位标记商品为空数量 0)。库位编码列显示覆盖(两 sheet 均生效):自定义名称(custom_name)优先 → 自定义编码(custom_barcode)次之 → 库位编码(space_code)兜底。ExcelJS 流式生成后上传 COS;进度通过 Redis 缓存(key stock_check_export_task_*,TTL 1800 秒)追踪,立即返回任务ID;进度查询复用 stock.check.exportTaskProgress。", "isNeedAuth": false, "isNeedLogin": true, "headers": [ @@ -40574,7 +40574,8 @@ "notes": [ "权限口径:随 ALL_METHOD_NAMES 免 API 权限(isNeedAuth=false)、免仓库有效期鉴权、必须登录(isNeedLogin=true);加入免日志清单 _noNeedLog。", "异步执行:查询任务/明细/作业记录 → 商品范围复用 result 的商品合并聚合(账面=明细行 system_quantity 快照、实盘=作业记录聚合)→ ExcelJS 流式写入 → COS 上传;进度缓存 Redis key stock_check_export_task_{taskId},TTL 1800 秒;进度查询复用 stock.check.exportTaskProgress(task_id 通用)。", - "商品盘点固定两个 Sheet:Sheet1「汇总和差异」每商品一行(账面=各库位快照合计、盘点=实盘合计、差异=盘点-账面,未盘商品盘点/差异留空;差异类型:正=盘盈、负=盘亏、无差异/未盘留空);未知商品(stock_id 为空按条码归组)无账面,追加在汇总末尾(差异=实盘=盘盈)。Sheet2「库位明细」每商品每库位一行(快照库位按明细 id 升序、仅作业记录存在的库位追加末尾),列仅库位编码/数量(实盘,未盘 0)/条码(wms_stock_barcodes 按 stock_id 第一条)/商品名称。", + "商品盘点固定两个 Sheet:Sheet1「汇总和差异」每商品一行(账面=各库位快照合计、盘点=实盘合计、差异=盘点-账面,未盘商品盘点/差异留空;差异类型:正=盘盈、负=盘亏、无差异/未盘留空);未知商品(stock_id 为空按条码归组)无账面,追加在汇总末尾(差异=实盘=盘盈)。Sheet2「库位明细」直接按作业记录(wms_stock_check_record)一行一条实际盘点记录,列仅库位编码/数量(实盘)/条码(wms_stock_barcodes 按 stock_id 第一条)/商品名称(未知商品条码=扫描条码)。", + "库位编码列显示覆盖(库位范围盘点明细 sheet 同样生效):自定义名称(custom_name)优先 → 自定义编码(custom_barcode)次之 → 库位编码(space_code)兜底;记录库位编码为空或查不到库位时按原库位编码(空则留空)。代码依据:app/service/systems/stock_check.js#_resolveLocationDisplayCode。", "库位范围任务:Sheet「盘点明细」作业记录口径(库位编码/商品编码/商品名称/盘点数量),已知商品编码名称从 wms_stock_warehouse 补齐、未知商品编码=扫描条码(barcode)、名称=上报名称快照;空库位标记记录商品编码为空、盘点数量 0;mode 入参忽略。", "代码依据:app/service/systems/stock_check.js#exportCheckDetail/#_generateAndUploadCheckDetailExcel/#_uploadExportExcelFile(原 _generateAndUploadStockCheckExcel 上传段抽为公共方法复用)+ app/service/systemMethods/stock/check.js#exportDetail。", "响应统一 data 层封装(2026-10-02 起):成功 { flag:\"success\", code:1, message:\"ok\", data:<业务数据整体>, timestamp };失败 { flag:\"failure\", code:<业务错误码>, message:<错误文案>, data:null, timestamp }。本方法业务数据整体位于 data 内,data 内字段口径与改造前一致(原顶层业务字段全部移入 data.children)。代码依据:app/service/systemMethods/stock/check.js#_call(23 个方法共用统一包装)+ app/lib/api_response.js#toSuccess(识别标准载荷后顶层补充 timestamp)。",