chore(scripts): 新增库存差异核对报表脚本并忽略导出文件

scripts/stock_diff_report.js 只读查询生产库,输出 库存差异核对_YYYYMMDD-HHmm.xlsx;.gitignore 按 库存差异核对_*.xlsx 忽略带时间戳的导出文件。
This commit is contained in:
liufumingren 2026-10-28 23:08:07 +08:00
parent cc9af9a4bf
commit 9d86c3f149
2 changed files with 308 additions and 0 deletions

2
.gitignore vendored
View File

@ -49,3 +49,5 @@ nginx-upstream-local.conf
# frpc binary (installed on demand by script/frp/frp-install.ps1)
script/frp/*.exe
# 库存差异核对导出(scripts/stock_diff_report.js 生成,文件名带时间戳)
库存差异核对_*.xlsx

View File

@ -0,0 +1,306 @@
'use strict';
/**
* 生成"库存差异核对"xlsx(生产库只读查询)。
* 输出:项目根目录 库存差异核对_YYYYMMDD-HHmm.xlsx
*/
const path = require('node:path');
const mysql = require('mysql2/promise');
const ExcelJS = require('exceljs');
const cfgModule = require(path.join(__dirname, '..', 'database', 'config.js'));
const cfg = cfgModule && cfgModule.production ? cfgModule.production : cfgModule;
const fmt = d => {
if (!d) return '';
const dt = d instanceof Date ? d : new Date(d);
const p = n => String(n).padStart(2, '0');
return `${dt.getFullYear()}-${p(dt.getMonth() + 1)}-${p(dt.getDate())} ${p(dt.getHours())}:${p(dt.getMinutes())}:${p(dt.getSeconds())}`;
};
const num = v => Number(v || 0);
async function main() {
const conn = await mysql.createConnection({
host: cfg.host,
port: cfg.port,
user: cfg.username || cfg.user,
password: cfg.password,
database: cfg.database,
dateStrings: true,
multipleStatements: false,
});
console.log('[1/6] 查询差异 SKU 明细...');
const [ stocks ] = await conn.query(`
SELECT sw.id AS stock_id, sw.warehouse_id, sw.store_id, sw.item_code, sw.item_name,
sw.quantity AS sw_quantity, sw.locked_quantity AS sw_locked,
COALESCE(SUM(st.quantity), 0) AS st_quantity,
COALESCE(SUM(st.locked_quantity), 0) AS st_locked,
COALESCE(SUM(st.available_quantity), 0) AS st_available,
COALESCE(SUM(st.intercept_locked_quantity), 0) AS st_intercept,
COUNT(st.id) AS st_rows
FROM wms_stock_warehouse sw
LEFT JOIN wms_storage st ON st.stock_id = sw.id AND st.delete_at IS NULL
WHERE sw.delete_at IS NULL
GROUP BY sw.id, sw.warehouse_id, sw.store_id, sw.item_code, sw.item_name, sw.quantity, sw.locked_quantity
HAVING COALESCE(SUM(st.quantity), 0) <> sw.quantity
ORDER BY (COALESCE(SUM(st.quantity), 0) - sw.quantity) DESC
`);
console.log(` 差异 SKU: ${stocks.length}`);
const ids = stocks.map(s => s.stock_id);
if (!ids.length) {
console.log('无差异,退出');
await conn.end();
return;
}
const idList = ids.join(',');
console.log('[2/6] 查询库位流水汇总...');
const [ stAgg ] = await conn.query(`
SELECT stock_id,
SUM(CASE WHEN transaction_type = 'INBOUND' THEN quantity ELSE 0 END) AS st_in,
SUM(CASE WHEN transaction_type = 'OUTBOUND' THEN quantity ELSE 0 END) AS st_out,
SUM(CASE WHEN transaction_type = 'INBOUND' AND order_type = 'INTERCEPT_LOCK' THEN quantity ELSE 0 END) AS intercept_return_in,
SUM(CASE WHEN transaction_type = 'LOCK' AND order_type = 'INTERCEPT_LOCK' THEN quantity ELSE 0 END) AS intercept_lock_qty,
SUM(CASE WHEN order_type = 'INTERCEPT_GAP' THEN quantity ELSE 0 END) AS gap_qty
FROM wms_storage_transaction
WHERE stock_id IN (${idList})
GROUP BY stock_id
`);
console.log('[3/6] 查询 SKU 流水汇总...');
const [ swAgg ] = await conn.query(`
SELECT stock_id,
SUM(CASE WHEN transaction_type = 'INBOUND' THEN quantity ELSE 0 END) AS sw_in,
SUM(CASE WHEN transaction_type = 'OUTBOUND' THEN quantity ELSE 0 END) AS sw_out
FROM wms_stock_transaction
WHERE stock_id IN (${idList})
GROUP BY stock_id
`);
console.log('[4/6] 查询拦截/GAP 单据明细...');
const [ interceptRows ] = await conn.query(`
SELECT id, stock_id, transaction_type, order_type, order_no, order_id, storage_id, quantity,
before_intercept_locked_quantity, after_intercept_locked_quantity, created_at, remark
FROM wms_storage_transaction
WHERE stock_id IN (${idList}) AND order_type IN ('INTERCEPT_LOCK', 'INTERCEPT_GAP')
ORDER BY stock_id, created_at
`);
console.log(` 拦截/GAP 流水: ${interceptRows.length}`);
console.log('[5/6] 查询"SKU 已出库但无拣货完成记录"的单据...');
const [ noPickRows ] = await conn.query(`
SELECT t.stock_id, t.order_id, MIN(t.order_no) AS order_no, SUM(t.quantity) AS qty,
MIN(t.created_at) AS first_at, MAX(t.created_at) AS last_at
FROM wms_stock_transaction t
WHERE t.stock_id IN (${idList}) AND t.transaction_type = 'OUTBOUND'
AND NOT EXISTS (
SELECT 1 FROM wms_picking p
WHERE p.order_id = t.order_id AND p.status IN ('fin', 'fin_compensated')
)
GROUP BY t.stock_id, t.order_id
ORDER BY t.stock_id, first_at
`);
console.log(` 疑似少扣单据: ${noPickRows.length}`);
console.log('[6/6] 生成 xlsx...');
const stMap = new Map(stAgg.map(r => [ r.stock_id, r ]));
const swMap = new Map(swAgg.map(r => [ r.stock_id, r ]));
const noPickMap = new Map();
for (const r of noPickRows) {
const cur = noPickMap.get(r.stock_id) || { cnt: 0, qty: 0 };
cur.cnt += 1;
cur.qty += num(r.qty);
noPickMap.set(r.stock_id, cur);
}
const interceptByStock = new Map();
for (const r of interceptRows) {
const arr = interceptByStock.get(r.stock_id) || [];
arr.push(r);
interceptByStock.set(r.stock_id, arr);
}
const wb = new ExcelJS.Workbook();
wb.creator = 'WMS 库存差异核对';
wb.created = new Date();
const headerFill = { type: 'pattern', pattern: 'solid', fgColor: { argb: 'FF1F4E79' } };
const headerFont = { color: { argb: 'FFFFFFFF' }, bold: true };
const styleHeader = ws => {
const row = ws.getRow(1);
row.font = headerFont;
row.fill = headerFill;
row.alignment = { vertical: 'middle', horizontal: 'center' };
row.height = 22;
ws.views = [{ state: 'frozen', ySplit: 1 }];
};
// ── Sheet1 差异汇总 ──
const ws1 = wb.addWorksheet('差异汇总');
ws1.columns = [
{ header: '序号', key: 'no', width: 6 },
{ header: '仓库ID', key: 'warehouse_id', width: 11 },
{ header: '货主ID', key: 'store_id', width: 11 },
{ header: 'SKU(stock_id)', key: 'stock_id', width: 12 },
{ header: '商品编码', key: 'item_code', width: 18 },
{ header: '商品名称', key: 'item_name', width: 30 },
{ header: 'SKU库存', key: 'sw_quantity', width: 11 },
{ header: 'SKU锁定', key: 'sw_locked', width: 10 },
{ header: '库位数量合计', key: 'st_quantity', width: 14 },
{ header: '库位可用', key: 'st_available', width: 11 },
{ header: '库位锁定', key: 'st_locked', width: 11 },
{ header: '库位拦截锁定', key: 'st_intercept', width: 14 },
{ header: '库位记录数', key: 'st_rows', width: 11 },
{ header: '差额(库位-SKU)', key: 'diff', width: 15 },
{ header: '库位入库合计', key: 'st_in', width: 14 },
{ header: '库位出库合计', key: 'st_out', width: 14 },
{ header: 'SKU入库合计', key: 'sw_in', width: 13 },
{ header: 'SKU出库合计', key: 'sw_out', width: 13 },
{ header: '拦截实物返还(件)', key: 'intercept_return_in', width: 17 },
{ header: '拦截锁定(件)', key: 'intercept_lock_qty', width: 14 },
{ header: 'GAP挂账(件)', key: 'gap_qty', width: 13 },
{ header: '无拣货完成记录的出库单数', key: 'nopick_cnt', width: 18 },
{ header: '无拣货完成记录出库数量', key: 'nopick_qty', width: 18 },
{ header: '建议冲正方向', key: 'suggest_dir', width: 22 },
{ header: '建议冲正数量', key: 'suggest_qty', width: 14 },
{ header: '备注', key: 'note', width: 46 },
];
styleHeader(ws1);
stocks.forEach((s, i) => {
const st = stMap.get(s.stock_id) || {};
const sw = swMap.get(s.stock_id) || {};
const nop = noPickMap.get(s.stock_id) || { cnt: 0, qty: 0 };
const diff = num(s.st_quantity) - num(s.sw_quantity);
const notes = [];
if (num(st.intercept_return_in) > 0) notes.push(`含拦截已拣货实物返还 ${num(st.intercept_return_in)} 件`);
if (nop.cnt > 0) notes.push(`含 ${nop.cnt} 张 SKU 已出库但无拣货完成记录的单据(${nop.qty} 件)`);
if (num(st.gap_qty) !== 0) notes.push(`GAP 差异对账挂账 ${num(st.gap_qty)} 件`);
if (num(s.st_intercept) > 0) notes.push(`库位当前拦截锁定 ${num(s.st_intercept)} 件`);
ws1.addRow({
no: i + 1,
warehouse_id: s.warehouse_id,
store_id: s.store_id,
stock_id: s.stock_id,
item_code: s.item_code,
item_name: s.item_name,
sw_quantity: num(s.sw_quantity),
sw_locked: num(s.sw_locked),
st_quantity: num(s.st_quantity),
st_available: num(s.st_available),
st_locked: num(s.st_locked),
st_intercept: num(s.st_intercept),
st_rows: num(s.st_rows),
diff,
st_in: num(st.st_in),
st_out: num(st.st_out),
sw_in: num(sw.sw_in),
sw_out: num(sw.sw_out),
intercept_return_in: num(st.intercept_return_in),
intercept_lock_qty: num(st.intercept_lock_qty),
gap_qty: num(st.gap_qty),
nopick_cnt: nop.cnt,
nopick_qty: nop.qty,
suggest_dir: diff > 0 ? '库位多 → SKU 补 +' : 'SKU 多 → 库位核减 / SKU 核减',
suggest_qty: Math.abs(diff),
note: notes.join(';'),
});
});
ws1.autoFilter = { from: 'A1', to: `Z${ws1.rowCount}` };
ws1.getColumn('diff').numFmt = '#,##0;[Red]-#,##0';
// ── Sheet2 拦截/GAP 单据明细 ──
const ws2 = wb.addWorksheet('拦截与GAP单据明细');
ws2.columns = [
{ header: '库存流水ID', key: 'id', width: 12 },
{ header: 'SKU(stock_id)', key: 'stock_id', width: 12 },
{ header: '商品编码', key: 'item_code', width: 18 },
{ header: '库存记录ID', key: 'storage_id', width: 12 },
{ header: '流水类型', key: 'transaction_type', width: 11 },
{ header: '单据类型', key: 'order_type', width: 15 },
{ header: '单据号', key: 'order_no', width: 26 },
{ header: '单据ID', key: 'order_id', width: 11 },
{ header: '数量', key: 'quantity', width: 9 },
{ header: '拦截锁-前', key: 'before_intercept_locked_quantity', width: 12 },
{ header: '拦截锁-后', key: 'after_intercept_locked_quantity', width: 12 },
{ header: '发生时间', key: 'created_at', width: 20 },
{ header: '备注', key: 'remark', width: 40 },
];
styleHeader(ws2);
const codeMap = new Map(stocks.map(s => [ s.stock_id, s.item_code ]));
for (const r of interceptRows) {
ws2.addRow({
id: r.id,
stock_id: r.stock_id,
item_code: codeMap.get(r.stock_id) || '',
storage_id: r.storage_id,
transaction_type: r.transaction_type,
order_type: r.order_type,
order_no: r.order_no,
order_id: r.order_id,
quantity: num(r.quantity),
before_intercept_locked_quantity: r.before_intercept_locked_quantity === null ? '' : num(r.before_intercept_locked_quantity),
after_intercept_locked_quantity: r.after_intercept_locked_quantity === null ? '' : num(r.after_intercept_locked_quantity),
created_at: fmt(r.created_at),
remark: r.remark,
});
}
ws2.autoFilter = { from: 'A1', to: `M${ws2.rowCount}` };
// ── Sheet3 SKU 已出库但无有效拣货记录 ──
const ws3 = wb.addWorksheet('疑似少扣库位的出库单');
ws3.columns = [
{ header: 'SKU(stock_id)', key: 'stock_id', width: 12 },
{ header: '商品编码', key: 'item_code', width: 18 },
{ header: '发货单ID', key: 'order_id', width: 12 },
{ header: '平台/出库单号', key: 'order_no', width: 24 },
{ header: 'SKU出库数量', key: 'qty', width: 13 },
{ header: '出库时间', key: 'first_at', width: 20 },
];
styleHeader(ws3);
for (const r of noPickRows) {
ws3.addRow({
stock_id: r.stock_id,
item_code: codeMap.get(r.stock_id) || '',
order_id: r.order_id,
order_no: r.order_no,
qty: num(r.qty),
first_at: fmt(r.first_at),
});
}
ws3.autoFilter = { from: 'A1', to: `F${ws3.rowCount}` };
// ── Sheet4 说明 ──
const ws4 = wb.addWorksheet('口径说明与冲正建议');
ws4.columns = [{ header: '项目', key: 'k', width: 26 }, { header: '说明', key: 'v', width: 110 }];
styleHeader(ws4);
[
[ '数据来源', '生产库 wms(只读):wms_stock_warehouse / wms_storage / wms_storage_transaction / wms_stock_transaction / wms_picking' ],
[ '生成时间', fmt(new Date()) ],
[ '差异口径', '差额 = SUM(wms_storage.quantity) − wms_stock_warehouse.quantity(仅统计 delete_at IS NULL 的库位记录)' ],
[ '差异 SKU 数', String(stocks.length) ],
[ '已识别成因一', '拦截确认「已拣货实物返还」只加库位(INBOUND/INTERCEPT_LOCK)并加拦截锁,SKU 侧出库扣减不回补 → 库位比 SKU 多' ],
[ '已识别成因二', 'SKU 侧「订单出库」(stock_store.outbound)已扣,但库位侧从未拣货完成扣减(拣货行 pending/软删/不存在)→ 库位比 SKU 多' ],
[ '已识别成因三', 'GAP 差异对账挂账(INTERCEPT_GAP)会把差额以拦截锁定形式挂在库位上,冲正时需一并释放' ],
[ '冲正方向判定', '库位数量 > SKU:实物多则 SKU 补 +差额;账实已发出则核减库位数量(并释放对应拦截锁)' ],
[ '冲正前必查', '1) 该 SKU 是否有未完成拣货/在途拦截;2) 库位拦截锁定是否需要在冲正后释放;3) 冲正流水需留痕(transaction_type/remark)' ],
[ '相关代码位置', 'app/service/systems/order_async.js:709(order 出库只扣 SKU)、app/service/systems/stock_store.js:1209(outbound)、app/service/systems/order_storage_allocation.js:2668(拦截实物返还)、app/service/systems/pick.js:2404(拣货完成扣库位)' ],
].forEach(([ k, v ]) => ws4.addRow({ k, v }));
ws4.getColumn('v').alignment = { wrapText: true, vertical: 'top' };
const ts = new Date();
const p = n => String(n).padStart(2, '0');
const fileName = `库存差异核对_${ts.getFullYear()}${p(ts.getMonth() + 1)}${p(ts.getDate())}-${p(ts.getHours())}${p(ts.getMinutes())}.xlsx`;
const outPath = path.join(__dirname, '..', fileName);
await wb.xlsx.writeFile(outPath);
console.log(`\n已生成: ${outPath}`);
console.log(`汇总 ${stocks.length} 行 / 拦截明细 ${interceptRows.length} 行 / 疑似少扣单据 ${noPickRows.length} 行`);
await conn.end();
}
main().catch(err => {
console.error('生成失败:', err && err.message);
console.error(err && err.stack);
process.exit(1);
});