- 期初数量改由本地快照表 daily_inventory_snapshot 提供(上一业务日期末), 每日 01:30 定时任务落库,接口侧缺失时补写兜底,逐日自动滚动 - 新增 dailyInventorySnapshotDb / dailyInventorySnapshotJob 与手动补跑脚本 - dailyInventoryBaseline 瘦身为纯仓库映射,去掉所有硬编码业务数值 - 12 个流水列因业务库缺单据表返回空值,前端灰底显示「—」 - 修复 qty 全为 0 的仓库期末显示 null 的缺陷 - 新增 docs/库存流水单据表需求.md 给 DBA
123 lines
4.1 KiB
JavaScript
123 lines
4.1 KiB
JavaScript
'use strict';
|
||
|
||
/**
|
||
* 每日库存快照任务
|
||
*
|
||
* 业务库没有按天的历史库存结存表,「期初数量」无法回溯。
|
||
* 本任务每天定时把 26 个仓库的实时库存落一份到本地快照表 daily_inventory_snapshot,
|
||
* 使「今日期初 = 上一业务日期末」能够自动滚动。
|
||
*
|
||
* 默认 01:30 执行(报表库 01:00 跑批之后)。可用环境变量覆盖:
|
||
* DAILY_INVENTORY_SNAPSHOT_ENABLED=false 关闭
|
||
* DAILY_INVENTORY_SNAPSHOT_CRON='30 1 * * *'
|
||
*/
|
||
const cron = require('node-cron');
|
||
const cloudDb = require('../config/cloudDatabase');
|
||
const snapshotDb = require('../config/dailyInventorySnapshotDb');
|
||
const { DAILY_INVENTORY_BASELINE } = require('../config/dailyInventoryBaseline');
|
||
|
||
let running = false;
|
||
let timer = null;
|
||
|
||
const JOB_ENABLED = String(process.env.DAILY_INVENTORY_SNAPSHOT_ENABLED || 'true').toLowerCase() !== 'false';
|
||
const JOB_CRON = process.env.DAILY_INVENTORY_SNAPSHOT_CRON || '30 1 * * *';
|
||
|
||
/** 业务日 = 库存快照库最新日期(报表库每日凌晨跑批,标注 T-1) */
|
||
async function resolveBizDate() {
|
||
const rows = await cloudDb.query(
|
||
`SELECT MAX(CONVERT(VARCHAR(10), date, 23)) AS d FROM rpt.pm_stockMonitor`
|
||
);
|
||
return rows[0]?.d || null;
|
||
}
|
||
|
||
function buildInClause(values, prefix) {
|
||
const params = {};
|
||
const clause = values
|
||
.map((v, i) => {
|
||
params[`${prefix}${i}`] = v;
|
||
return `@${prefix}${i}`;
|
||
})
|
||
.join(',');
|
||
return { clause, params };
|
||
}
|
||
|
||
async function syncOnce(trigger = 'cron') {
|
||
if (running) {
|
||
console.log(`[DailyInventorySnapshot] 上一次任务未结束,跳过 trigger=${trigger}`);
|
||
return { success: false, skipped: true, reason: 'already_running' };
|
||
}
|
||
running = true;
|
||
const startedAt = Date.now();
|
||
try {
|
||
const bizDate = await resolveBizDate();
|
||
if (!bizDate) {
|
||
console.log('[DailyInventorySnapshot] 未取到业务日,跳过');
|
||
return { success: false, skipped: true, reason: 'no_biz_date' };
|
||
}
|
||
|
||
const whs = DAILY_INVENTORY_BASELINE.filter((b) => b.wmsCoId != null);
|
||
const { clause, params } = buildInClause(whs.map((b) => b.wmsCoId), 'w');
|
||
const rows = await cloudDb.query(
|
||
`SELECT i.wms_co_id AS wmsCoId,
|
||
ISNULL(SUM(CAST(i.qty AS DECIMAL(18,2))), 0) AS closingQty,
|
||
SUM(CASE WHEN ABS(ISNULL(i.qty, 0)) > 0.0001 THEN 1 ELSE 0 END) AS skuCount,
|
||
MAX(i.modified) AS takenAt
|
||
FROM rpt.jst_inventoryInfo i
|
||
WHERE i.wms_co_id IN (${clause})
|
||
GROUP BY i.wms_co_id`,
|
||
params,
|
||
{ requestTimeout: 120000 }
|
||
);
|
||
|
||
const m = new Map(rows.map((r) => [String(r.wmsCoId), r]));
|
||
const payload = whs.map((b) => {
|
||
const r = m.get(String(b.wmsCoId));
|
||
return {
|
||
wmsCoId: b.wmsCoId,
|
||
warehouse: b.warehouse,
|
||
dbWarehouse: b.dbWarehouse,
|
||
closingQty: Number(r?.closingQty ?? 0),
|
||
skuCount: Number(r?.skuCount ?? 0),
|
||
takenAt: r?.takenAt ? new Date(r.takenAt) : null,
|
||
};
|
||
});
|
||
|
||
const n = await snapshotDb.upsertSnapshot(bizDate, payload);
|
||
console.log(`[DailyInventorySnapshot] 业务日 ${bizDate} 写入 ${n}/${whs.length} 仓,耗时 ${Date.now() - startedAt}ms`);
|
||
return { success: true, bizDate, count: n };
|
||
} catch (error) {
|
||
console.error('[DailyInventorySnapshot] 执行失败:', error.message);
|
||
return { success: false, error: error.message };
|
||
} finally {
|
||
running = false;
|
||
}
|
||
}
|
||
|
||
function startDailyInventorySnapshotScheduler() {
|
||
if (!JOB_ENABLED) {
|
||
console.log('[DailyInventorySnapshot] 已通过环境变量关闭');
|
||
return null;
|
||
}
|
||
if (timer) return timer;
|
||
if (!cron.validate(JOB_CRON)) {
|
||
console.error(`[DailyInventorySnapshot] cron 表达式非法: ${JOB_CRON}`);
|
||
return null;
|
||
}
|
||
timer = cron.schedule(JOB_CRON, () => { syncOnce('cron'); }, { timezone: 'Asia/Shanghai' });
|
||
console.log(`[DailyInventorySnapshot] 已启动,cron=${JOB_CRON} (Asia/Shanghai)`);
|
||
return timer;
|
||
}
|
||
|
||
function stopDailyInventorySnapshotScheduler() {
|
||
if (timer) {
|
||
timer.stop();
|
||
timer = null;
|
||
}
|
||
}
|
||
|
||
module.exports = {
|
||
syncOnce,
|
||
startDailyInventorySnapshotScheduler,
|
||
stopDailyInventorySnapshotScheduler,
|
||
};
|