WMS_MAIN/script/stock-check-goods-summary-verify.cjs
liufumingren 562f63f18e feat(stock.check): 商品视图按商品汇总、账面按静态标记取值、静态盘点锁定缓存与库存操作拦截
盘点作业数据(workData / workDataDetail)
- workData goods 视图按 stock_id 汇总为一行(同商品多库位明细合并):行级账面=各库位之和,
  作业记录跨明细按库位合并,locations 每项补 detail_id/snapshot_quantity,行级不再返回 detail_id。
- workDataDetail 商品分支改为 id + stock_id 钻取,返回 summary(汇总)+ rows(按库位分行:
  明细ID/库位ID/账面快照/当前账面/实盘/差异);兼容传商品范围 detail_id。
- 账面取值按任务 is_static 区分:静态盘点取明细快照(冻结基准),普通盘点取当前 wms_storage;
  新增 storage_quantity / is_static / book_source 字段,差异统一为「实盘 - system_quantity」。
- report 的 detail_id 改为可选:商品行可只传 id + stock_id + space_id,服务端按库位明细反查。

静态盘点(is_static)
- wms_stock_check 新增 is_static(TINYINT(1) DEFAULT 0,迁移 20261028010000);create 支持 is_static
  (仅商品盘点有效,库位盘点恒 0);静态定式 pattern=static 创建的任务自动置 1。
- 新增公共查询 stock.check.staticLockList:返回 is_static=1 且 approved/checking 任务的商品集合,
  按仓库缓存(TTL 300s、状态流转先递增代次再重建、回源前后代次校验防脏读、空集合也缓存、
  进程内 singleflight 防击穿),并提供 isStockStaticLocked / getStaticLockConflict 供内部判断。
- 审核通过时刷新商品明细账面快照(快照基准=开始盘点时点),finish 立即释放锁定并返回 released_stock_ids。
- 库存操作拦截:分配储位命中锁定商品时按「库存不足」同流程将该订单标记失败(storage_status=error +
  order_flag),同批次其它订单继续;移库(transferLocation / transferByProduct)命中锁定直接 400。

其他
- 新增开发环境实测脚本 script/stock-check-goods-summary-verify.cjs。
- 测试:stock_check.test.js 覆盖汇总/钻取/静态标记/锁定缓存/账面口径;新增 static_lock_guard.test.js
  覆盖分配与移库拦截;methods/system.json 与 changes 更新至 0.3.318。

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-10-28 07:22:44 +08:00

183 lines
8.0 KiB
JavaScript
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

'use strict';
/**
* 开发环境实测脚本:盘点商品视图汇总 + workDataDetail 商品钻取 + report 免 detail_id。
*
* 直连本地开发库(config.local.js,127.0.0.1:3307),全程走 systemMethods 方法层(含统一 success 包装),
* 完整复现一条盘点到上报链路:
* 1. 取一个多库位库存商品(模拟同 stock_id 多条库位明细);
* 2. create → addDetail → submit → audit(approve);
* 3. report 只传 id + stock_id + space_id(不传 detail_id),验证反查明细;
* 4. workData(is_goods=true) 校验商品视图汇总(行级无 detail_id、locations 带 detail_id/snapshot_quantity);
* 5. workDataDetail(id + stock_id) 校验 summary + 按库位分行(明细ID/库位ID/账面快照/实盘/差异);
* 6. 交叉校验明细快照合计 = goods 行级账面 = summary 账面,分行实盘合计 = 行级实盘 = summary 实盘。
*
* 数据策略:脚本会在开发库新建一条盘点任务(单号 PD+日期+序号,标题以「实测_商品汇总_」开头)
* 作为核对样张保留,不做清理;不要在预发/生产库执行。
*
* 用法:node script/stock-check-goods-summary-verify.cjs
*/
const mm = require('egg-mock');
const WAREHOUSE_ID = 100000;
const CREATOR_ID = 4;
const CREATOR_NAME = '阿猫';
function log(title, payload) {
console.log(`\n===== ${title} =====`);
console.log(typeof payload === 'string' ? payload : JSON.stringify(payload, null, 2));
}
(async () => {
const app = mm.app({
baseDir: process.cwd(),
env: 'local',
clean: false,
cache: false,
});
await app.ready();
const ctx = app.createAnonymousContext();
ctx.user = { id: CREATOR_ID, store_id: WAREHOUSE_ID, employees_name: CREATOR_NAME };
const { Op, literal } = app.Sequelize;
const validSpaceSql = '(SELECT ls.id FROM wms_location_space ls '
+ 'JOIN wms_location_zone z ON z.id = ls.zone_id AND z.deleted_at IS NULL '
+ 'WHERE ls.deleted_at IS NULL)';
try {
// 1. 找一个在两个及以上有效库位都有库存的商品(模拟生产里同 stock_id 多库位明细的场景)
const storageRows = await ctx.model.Storage.findAll({
where: {
warehouse_id: WAREHOUSE_ID,
is_enabled: 1,
space_id: { [Op.in]: literal(validSpaceSql) },
},
attributes: [ 'stock_id', 'space_id', [ literal('SUM(available_quantity + locked_quantity)'), 'qty' ]],
group: [ 'stock_id', 'space_id' ],
raw: true,
});
const spacesByStock = new Map();
for (const row of storageRows) {
const stockId = Number(row.stock_id);
if (!spacesByStock.has(stockId)) {
spacesByStock.set(stockId, []);
}
spacesByStock.get(stockId).push(row);
}
const multiEntry = [ ...spacesByStock.entries() ]
.filter(([ , rows ]) => rows.length >= 2)
.sort((left, right) => left[0] - right[0])[0];
if (!multiEntry) {
throw new Error('开发库中未找到多库位库存商品,无法实测汇总口径');
}
const [ stockId, stockSpaces ] = multiEntry;
const stock = await ctx.model.StockWarehouse.findOne({ where: { id: stockId, warehouse_id: WAREHOUSE_ID }, raw: true });
log('1. 选中的多库位商品', {
stock_id: stockId,
item_code: stock.item_code,
item_name: stock.item_name,
store_id: stock.store_id,
spaces: stockSpaces.map(row => ({ space_id: Number(row.space_id), qty: Number(row.qty) })),
});
// 2. 创建任务 → 添加明细 → 提交 → 审核(走方法层,含 success 包装)
const created = await ctx.service.systemMethods.stock.check.create({
title: `实测_商品汇总_${Date.now()}`,
type: 'goods',
mode: 'open',
store_id: stock.store_id || undefined,
});
if (created.flag !== 'success') {
throw new Error(`create 失败: ${created.message}`);
}
const checkId = Number(created.data.id);
const added = await ctx.service.systemMethods.stock.check.addDetail({ id: checkId, stock_ids: [ stockId ] });
console.log(`\n2. 任务创建 ${created.data.check_no}(id=${checkId}),添加明细:added=${added.data.added} skipped=${added.data.skipped}`);
await ctx.service.systemMethods.stock.check.submit({ id: checkId });
const audited = await ctx.service.systemMethods.stock.check.audit({ id: checkId, action: 'approve' });
if (audited.flag !== 'success') {
throw new Error(`audit 失败: ${JSON.stringify(audited)}`);
}
const detailRows = await ctx.model.StockCheckDetail.findAll({
where: { check_id: checkId, scope_type: 'goods' },
order: [[ 'id', 'ASC' ]],
raw: true,
});
log('3. 明细行(商品按库位拆行,账面快照逐库位)', detailRows.map(row => ({
detail_id: Number(row.id),
stock_id: Number(row.stock_id),
location_id: Number(row.location_id),
location_code: row.location_code,
system_quantity: Number(row.system_quantity),
})));
// 4. report 免 detail_id:只传 id + stock_id + space_id(goods 汇总视图行不再带明细ID)
const reportTargets = detailRows.slice(0, 2);
for (const [ index, detailRow ] of reportTargets.entries()) {
const reported = await ctx.service.systemMethods.stock.check.report({
id: checkId,
stock_id: stockId,
space_id: Number(detailRow.location_id),
quantity: index === 0 ? 7 : 3,
});
log(`4.${index + 1} report 免 detail_id(space_id=${detailRow.location_id})`, {
flag: reported.flag,
code: reported.code,
message: reported.message,
resolved_detail_id: reported.data && reported.data.detail_id,
record: reported.data && {
id: reported.data.record.id,
detail_id: reported.data.record.detail_id,
stock_id: reported.data.record.stock_id,
location_id: reported.data.record.location_id,
location_code: reported.data.record.location_code,
quantity: reported.data.record.quantity,
},
});
}
// 5. workData goods 视图:一个商品一行,行级无 detail_id,locations 带 detail_id/snapshot_quantity
const workData = await ctx.service.systemMethods.stock.check.workData({ id: checkId, is_goods: true });
const goodsRow = workData.data.rows[0];
log('5. workData(is_goods=true) 商品视图行', {
view: workData.data.view,
total: workData.data.total,
row: goodsRow,
});
console.log(' → 行级是否含 detail_id:', Object.prototype.hasOwnProperty.call(goodsRow, 'detail_id'));
// 6. workDataDetail 商品钻取:id + stock_id → summary + rows
const drill = await ctx.service.systemMethods.stock.check.workDataDetail({ id: checkId, stock_id: stockId });
log('6. workDataDetail(id + stock_id) 商品钻取', {
flag: drill.flag,
data: drill.data,
});
// 7. 口径交叉校验
const snapshotTotal = detailRows.reduce((sum, row) => sum + Number(row.system_quantity), 0);
const rowsChecked = drill.data.rows.reduce((sum, row) => sum + Number(row.checked_quantity), 0);
log('7. 口径交叉校验', {
明细快照合计: snapshotTotal,
'goods 行级 system_quantity': goodsRow.system_quantity,
'goods 行级 checked_quantity': goodsRow.checked_quantity,
'drill.summary.system_quantity': drill.data.summary.system_quantity,
'drill.summary.checked_quantity': drill.data.summary.checked_quantity,
'drill.rows 实盘合计': rowsChecked,
'locations[].detail_id': goodsRow.locations.map(item => ({ code: item.location_code, detail_id: item.detail_id, snapshot: item.snapshot_quantity })),
一致: snapshotTotal === goodsRow.system_quantity
&& goodsRow.system_quantity === drill.data.summary.system_quantity
&& goodsRow.checked_quantity === drill.data.summary.checked_quantity
&& rowsChecked === drill.data.summary.checked_quantity,
});
} finally {
await app.close();
}
})().catch(error => {
console.error('实测失败:', error && error.stack || error);
process.exit(1);
});