WMS_MAIN/test/app/schedule/notice_stock_remaining.test.js
liufumingren b5e5d4d588 feat(storeWarehouse,report,notice,order): 签约导出与代开户备注兜底、报表meta下线、入库完成通知与编码规范化
- storeWarehouse: 货主签约列表异步导出 export/exportTaskProgress(26列中文表头Excel+进度回写);openAccount 代开户未传 store_remask(或传空)时默认取公司全称前50字符填充,保证货主名称在列表/导出中始终有值

- report: 下线 report.meta(破坏性),窗口参数改由 definition.typeList、勾选字段经 definition.list 提供;报表投递目标货主状态放宽为 1/2(正常/审核中);reportDelivery 实体展示名称兼容下划线/驼峰并优雅回退 ID

- notice/order: 入库单完成通知货主(entry_order_completed,固定订阅回退链:收货组→售后组→仓库异常群);入库明细 itemId 规范化(非法值降级按 item_code 精确/归一化条码匹配,剥离中文后缀,多命中报错防错配);库存预警定时任务与 webhook 模型调整

- storage: 快捷直入/入库单基本信息等相关小改(inbound_direct_log、storage/entry、storage/inventory)

- docs: methods/system 0.3.62→0.3.63、openapi/qimen 同步,AI_METHOD_ROUTING 与 report-config-guide 同步,methods/changes/*.json 补变更记录
2026-08-31 17:17:48 +08:00

589 lines
17 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';
const assert = require('node:assert/strict');
const schedule = require('../../../app/schedule/notice_stock_remaining');
const CACHE_KEY_PREFIX = 'notice_stock_remaining_notified';
const LEGACY_CACHE_KEY = 'notice_stock_remaining_notified_list';
function createLogger() {
return {
info() {},
warn() {},
error() {},
debug() {},
};
}
function createSequelizeInstanceLikeRecord(values = {}, associations = {}) {
const dataValues = { ...values };
const includedValues = { ...associations };
const prototype = {
getDataValue(fieldName) {
if (Object.prototype.hasOwnProperty.call(dataValues, fieldName)) {
return dataValues[fieldName];
}
return includedValues[fieldName];
},
get(fieldName) {
return this.getDataValue(fieldName);
},
};
for (const fieldName of Object.keys(dataValues)) {
Object.defineProperty(prototype, fieldName, {
enumerable: false,
configurable: true,
get() {
return dataValues[fieldName];
},
});
}
for (const fieldName of Object.keys(includedValues)) {
Object.defineProperty(prototype, fieldName, {
enumerable: false,
configurable: true,
get() {
return includedValues[fieldName];
},
});
}
return Object.create(prototype);
}
function buildLocalDateKey(dateValue) {
const year = String(dateValue.getFullYear());
const month = String(dateValue.getMonth() + 1).padStart(2, '0');
const day = String(dateValue.getDate()).padStart(2, '0');
return `${year}${month}${day}`;
}
async function withFixedDate(fixedDate, handler) {
const OriginalDate = Date;
const fixedTime = fixedDate.getTime();
class FixedDate extends OriginalDate {
constructor(...args) {
if (args.length === 0) {
super(fixedTime);
return;
}
super(...args);
}
static now() {
return fixedTime;
}
}
Object.setPrototypeOf(FixedDate, OriginalDate);
FixedDate.parse = OriginalDate.parse.bind(OriginalDate);
FixedDate.UTC = OriginalDate.UTC.bind(OriginalDate);
global.Date = FixedDate;
try {
return await handler();
} finally {
global.Date = OriginalDate;
}
}
function createScheduleHarness(options = {}) {
const noticePayloads = [];
const cacheWrites = [];
const storageQueryOptions = [];
const cacheStore = new Map(Object.entries(options.cacheStore || {}));
const ctx = {
app: {
_noticeStockRemainingRunning: false,
Sequelize: {
Op: {
gt: Symbol('gt'),
in: Symbol('in'),
ne: Symbol('ne'),
lte: Symbol('lte'),
},
},
async getCacheAsync(cacheKey) {
return cacheStore.has(cacheKey) ? cacheStore.get(cacheKey) : null;
},
async setCacheAsync(cacheKey, data, ttl) {
cacheWrites.push({ cacheKey, data, ttl });
cacheStore.set(cacheKey, data);
},
formatDate(dateValue) {
return dateValue.toISOString();
},
},
logger: createLogger(),
model: {
StockWarehouse: {
async findAll() {
return options.stockRows || [];
},
},
Storage: {
async findAll(queryOptions) {
storageQueryOptions.push(queryOptions);
return options.storageRows || [];
},
},
Store: {},
LocationSpace: {},
},
service: {
systems: {
notice: {
async send(payload) {
noticePayloads.push(payload);
if (typeof options.sendHandler === 'function') {
return await options.sendHandler(payload);
}
return {
success: true,
};
},
},
},
},
};
if (options.useNoticeIndexSend) {
delete ctx.service.systems.notice.send;
ctx.service.systems.notice.index = {
async send(payload) {
noticePayloads.push(payload);
if (typeof options.sendHandler === 'function') {
return await options.sendHandler(payload);
}
return {
success: true,
};
},
};
}
return {
ctx,
noticePayloads,
cacheWrites,
cacheStore,
storageQueryOptions,
};
}
describe('test/app/schedule/notice_stock_remaining.test.js', () => {
it('should ignore legacy global cache and write back stock-day cache keys', async () => {
const fixedDate = new Date(2026, 3, 14, 9, 0, 0);
const { ctx, noticePayloads, cacheWrites } = createScheduleHarness({
cacheStore: {
[LEGACY_CACHE_KEY]: [ 'stock:2001' ],
},
stockRows: [
{
id: 2001,
item_code: 'SKU-2001',
item_name: '测试商品A',
store_id: 10,
warehouse_id: 20,
remaining_threshold_days: 7,
},
],
storageRows: [
{
id: 9001,
stock_id: 2001,
batch_no: 'BATCH-1',
warehouse_id: 20,
store_id: 10,
quantity: 5,
available_quantity: 5,
expiry_date: new Date(2026, 3, 16, 9, 0, 0),
inbound_time: new Date(2026, 3, 13, 9, 0, 0),
is_enabled: 1,
delete_at: null,
space: {
space_code: 'A-01',
custom_name: '一号位',
},
},
{
id: 9002,
stock_id: 2001,
batch_no: 'BATCH-2',
warehouse_id: 20,
store_id: 10,
quantity: 8,
available_quantity: 8,
expiry_date: new Date(2026, 3, 17, 9, 0, 0),
inbound_time: new Date(2026, 3, 12, 9, 0, 0),
is_enabled: 1,
delete_at: null,
space: {
space_code: 'A-02',
custom_name: '二号位',
},
},
],
});
await withFixedDate(fixedDate, async () => {
await schedule.task(ctx);
});
const dateKey = buildLocalDateKey(fixedDate);
const expectedCacheKey = `${CACHE_KEY_PREFIX}:stock:2001:${dateKey}`;
assert.equal(noticePayloads.length, 1);
assert.equal(noticePayloads[0].businessId, 2001);
assert.equal(noticePayloads[0].metadata.businessId, 2001);
assert.equal(noticePayloads[0].metadata.stockId, 2001);
assert.equal(noticePayloads[0].metadata.notifyKey, 'stock:2001');
assert.equal(noticePayloads[0].metadata.cacheKey, expectedCacheKey);
assert.ok(noticePayloads[0].content.includes('仓库ID:20'), '缺少仓库 ID 回退文案');
assert.ok(noticePayloads[0].content.includes('货主ID:10'), '缺少货主 ID 回退文案');
assert.ok(!noticePayloads[0].content.includes('undefined'), '正文不应出现 undefined');
assert.ok(!noticePayloads[0].content.includes('null'), '正文不应出现 null');
assert.equal(noticePayloads[0].metadata.warehouseName, '');
assert.equal(noticePayloads[0].metadata.storeName, '');
assert.equal(cacheWrites.length, 1);
assert.equal(cacheWrites[0].cacheKey, expectedCacheKey);
assert.deepEqual(cacheWrites[0].data, {
notifiedAt: fixedDate.toISOString(),
stockId: 2001,
notifyKey: 'stock:2001',
});
assert.equal(cacheWrites[0].ttl, 24 * 60 * 60);
assert.equal(ctx.app._noticeStockRemainingRunning, false);
});
it('should keep same-day dedupe per stock without extending other stocks', async () => {
const fixedDate = new Date(2026, 3, 14, 9, 0, 0);
const dateKey = buildLocalDateKey(fixedDate);
const cachedStockKey = `${CACHE_KEY_PREFIX}:stock:2001:${dateKey}`;
const otherStockKey = `${CACHE_KEY_PREFIX}:stock:2002:${dateKey}`;
const { ctx, noticePayloads, cacheWrites } = createScheduleHarness({
cacheStore: {
[cachedStockKey]: {
notifiedAt: fixedDate.toISOString(),
stockId: 2001,
notifyKey: 'stock:2001',
},
},
stockRows: [
{
id: 2001,
item_code: 'SKU-2001',
item_name: '测试商品A',
store_id: 10,
warehouse_id: 20,
remaining_threshold_days: 7,
},
{
id: 2002,
item_code: 'SKU-2002',
item_name: '测试商品B',
store_id: 10,
warehouse_id: 20,
remaining_threshold_days: 7,
},
],
storageRows: [
createSequelizeInstanceLikeRecord(
{
id: 9001,
stock_id: 2001,
batch_no: 'BATCH-1',
warehouse_id: 20,
store_id: 10,
quantity: 5,
available_quantity: 5,
expiry_date: new Date(2026, 3, 16, 9, 0, 0),
inbound_time: new Date(2026, 3, 13, 9, 0, 0),
is_enabled: 1,
delete_at: null,
},
{
space: createSequelizeInstanceLikeRecord({
space_code: 'A-01',
custom_name: '一号位',
}),
}
),
createSequelizeInstanceLikeRecord(
{
id: 9002,
stock_id: 2002,
batch_no: 'BATCH-2',
warehouse_id: 20,
store_id: 10,
quantity: 6,
available_quantity: 6,
expiry_date: new Date(2026, 3, 16, 9, 0, 0),
inbound_time: new Date(2026, 3, 13, 9, 0, 0),
is_enabled: 1,
delete_at: null,
},
{
space: createSequelizeInstanceLikeRecord({
space_code: 'B-01',
custom_name: '二号位',
}),
}
),
],
});
await withFixedDate(fixedDate, async () => {
await schedule.task(ctx);
});
assert.equal(noticePayloads.length, 1);
assert.equal(noticePayloads[0].businessId, 2002);
assert.equal(noticePayloads[0].metadata.stockId, 2002);
assert.equal(noticePayloads[0].metadata.notifyKey, 'stock:2002');
assert.equal(noticePayloads[0].metadata.cacheKey, otherStockKey);
assert.equal(cacheWrites.length, 1);
assert.equal(cacheWrites[0].cacheKey, otherStockKey);
assert.equal(ctx.app._noticeStockRemainingRunning, false);
});
it('should keep retrying when notice send reports failure', async () => {
const fixedDate = new Date(2026, 3, 14, 9, 0, 0);
const { ctx, noticePayloads, cacheWrites } = createScheduleHarness({
stockRows: [
{
id: 2001,
item_code: 'SKU-2001',
item_name: '测试商品A',
store_id: 10,
warehouse_id: 20,
remaining_threshold_days: 7,
},
],
storageRows: [
{
id: 9001,
stock_id: 2001,
batch_no: 'BATCH-1',
warehouse_id: 20,
store_id: 10,
quantity: 5,
available_quantity: 5,
expiry_date: new Date(2026, 3, 16, 9, 0, 0),
inbound_time: new Date(2026, 3, 13, 9, 0, 0),
is_enabled: 1,
delete_at: null,
space: {
space_code: 'A-01',
custom_name: '一号位',
},
},
],
sendHandler() {
return {
success: false,
};
},
});
await withFixedDate(fixedDate, async () => {
await schedule.task(ctx);
});
const dateKey = buildLocalDateKey(fixedDate);
const expectedCacheKey = `${CACHE_KEY_PREFIX}:stock:2001:${dateKey}`;
assert.equal(noticePayloads.length, 1);
assert.equal(cacheWrites.length, 0);
assert.equal(ctx.app._noticeStockRemainingRunning, false);
assert.equal(noticePayloads[0].metadata.cacheKey, expectedCacheKey);
});
it('should fallback to notice.index.send when notice.send is missing', async () => {
const fixedDate = new Date(2026, 3, 14, 9, 0, 0);
const { ctx, noticePayloads } = createScheduleHarness({
useNoticeIndexSend: true,
stockRows: [
{
id: 2001,
item_code: 'SKU-2001',
item_name: '测试商品A',
store_id: 10,
warehouse_id: 20,
remaining_threshold_days: 7,
},
],
storageRows: [
{
id: 9001,
stock_id: 2001,
batch_no: 'BATCH-1',
warehouse_id: 20,
store_id: 10,
quantity: 5,
available_quantity: 5,
expiry_date: new Date(2026, 3, 16, 9, 0, 0),
inbound_time: new Date(2026, 3, 13, 9, 0, 0),
is_enabled: 1,
delete_at: null,
space: {
space_code: 'A-01',
custom_name: '一号位',
},
},
],
});
await withFixedDate(fixedDate, async () => {
await schedule.task(ctx);
});
assert.equal(noticePayloads.length, 1);
assert.equal(noticePayloads[0].businessId, 2001);
assert.equal(noticePayloads[0].metadata.notifyKey, 'stock:2001');
assert.equal(ctx.app._noticeStockRemainingRunning, false);
});
it('should render warehouse/store names with IDs when associated records provide company_name', async () => {
const fixedDate = new Date(2026, 3, 14, 9, 0, 0);
const { ctx, noticePayloads } = createScheduleHarness({
stockRows: [
{
id: 2001,
item_code: 'SKU-2001',
item_name: '测试商品A',
store_id: 10,
warehouse_id: 20,
remaining_threshold_days: 7,
},
],
storageRows: [
createSequelizeInstanceLikeRecord(
{
id: 9001,
stock_id: 2001,
batch_no: 'BATCH-1',
warehouse_id: 20,
store_id: 10,
quantity: 5,
available_quantity: 5,
expiry_date: new Date(2026, 3, 16, 9, 0, 0),
inbound_time: new Date(2026, 3, 13, 9, 0, 0),
is_enabled: 1,
delete_at: null,
},
{
warehouse: createSequelizeInstanceLikeRecord({ company_name: '测试中心仓' }),
store: createSequelizeInstanceLikeRecord({ company_name: '测试货主公司' }),
space: createSequelizeInstanceLikeRecord({
space_code: 'A-01',
custom_name: '一号位',
}),
}
),
],
});
await withFixedDate(fixedDate, async () => {
await schedule.task(ctx);
});
assert.equal(noticePayloads.length, 1);
const noticePayload = noticePayloads[0];
assert.ok(noticePayload.content.includes('仓库:测试中心仓(ID:20)'), '正文应包含仓库名称与 ID');
assert.ok(noticePayload.content.includes('货主:测试货主公司(ID:10)'), '正文应包含货主名称与 ID');
assert.equal(noticePayload.subject.name, '仓库:测试中心仓(ID:20)');
assert.equal(noticePayload.metadata.warehouseName, '测试中心仓');
assert.equal(noticePayload.metadata.storeName, '测试货主公司');
});
it('should fallback to 未知 when both name and ID are missing', async () => {
const fixedDate = new Date(2026, 3, 14, 9, 0, 0);
const { ctx, noticePayloads } = createScheduleHarness({
stockRows: [
{
id: 2001,
item_code: 'SKU-2001',
item_name: '测试商品A',
remaining_threshold_days: 7,
},
],
storageRows: [
{
id: 9001,
stock_id: 2001,
batch_no: 'BATCH-1',
quantity: 5,
available_quantity: 5,
expiry_date: new Date(2026, 3, 16, 9, 0, 0),
inbound_time: new Date(2026, 3, 13, 9, 0, 0),
is_enabled: 1,
delete_at: null,
space: {
space_code: 'A-01',
custom_name: '一号位',
},
},
],
});
await withFixedDate(fixedDate, async () => {
await schedule.task(ctx);
});
assert.equal(noticePayloads.length, 1);
const noticePayload = noticePayloads[0];
assert.ok(noticePayload.content.includes('仓库ID:未知'), '仓库名称与 ID 缺失时应回退为未知');
assert.ok(noticePayload.content.includes('货主ID:未知'), '货主名称与 ID 缺失时应回退为未知');
assert.ok(!noticePayload.content.includes('undefined'), '正文不应出现 undefined');
assert.ok(!noticePayload.content.includes('null'), '正文不应出现 null');
assert.equal(noticePayload.subject.name, '仓库ID:未知');
});
it('should query storage with LEFT JOIN store associations for name resolution', async () => {
const fixedDate = new Date(2026, 3, 14, 9, 0, 0);
const { ctx, storageQueryOptions } = createScheduleHarness({
stockRows: [
{
id: 2001,
item_code: 'SKU-2001',
item_name: '测试商品A',
store_id: 10,
warehouse_id: 20,
remaining_threshold_days: 7,
},
],
storageRows: [],
});
await withFixedDate(fixedDate, async () => {
await schedule.task(ctx);
});
assert.equal(storageQueryOptions.length, 1);
const includeList = storageQueryOptions[0].include;
assert.ok(Array.isArray(includeList), '查询应包含 include 配置');
const warehouseInclude = includeList.find(entry => entry && entry.as === 'warehouse');
const storeInclude = includeList.find(entry => entry && entry.as === 'store');
assert.ok(warehouseInclude, '应包含 warehouse 关联');
assert.equal(warehouseInclude.required, false);
assert.deepEqual(warehouseInclude.attributes, [ 'company_name' ]);
assert.ok(storeInclude, '应包含 store 关联');
assert.equal(storeInclude.required, false);
assert.deepEqual(storeInclude.attributes, [ 'company_name' ]);
});
});