WMS_MAIN/test/app/service/systems/storage.receiving.report.test.js
2026-04-09 15:45:14 +08:00

582 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 ReceivingService = require('../../../../app/service/systems/storage/receiving');
function createService() {
const excelCalls = [];
const noticeCalls = [];
const ctx = {
app: {
config: {},
Sequelize: {
Op: {},
},
},
user: {
store_id: 2001,
store_name: '测试仓库',
},
logger: {
info() {},
warn() {},
error() {},
},
service: {
systems: {
excel: {
async generateAndUpload(options) {
excelCalls.push(options);
const fileUrl = `https://cdn.example.com/${options.filename}`;
return {
fileKey: options.filename,
key: options.filename,
filename: options.filename,
url: fileUrl,
fileUrl,
};
},
},
notice: {
async send(options) {
noticeCalls.push(options);
return {
success: true,
data: {
matchedHookCount: 1,
sentCount: 1,
failedCount: 0,
},
};
},
},
},
},
};
const service = new ReceivingService(ctx);
return {
service,
excelCalls,
noticeCalls,
};
}
function createCompleteReceivingService({
uploadShouldFail = false,
detailOverrides = {},
itemImages,
} = {}) {
const steps = [];
const noticeCalls = [];
const transaction = {
LOCK: {
UPDATE: 'UPDATE',
},
finished: false,
async commit() {
this.finished = 'commit';
steps.push('commit');
},
async rollback() {
this.finished = 'rollback';
steps.push('rollback');
},
};
const detailRecord = {
id: 501,
system_product_id: 90001,
product_name: '测试商品A',
barcode: 'SKU-001',
actual_quantity: 8,
weight: 12,
...detailOverrides,
};
const defaultItemImages = [{
business_id: 501,
file_id: 7001,
file: {
file_url: 'https://example.com/item-501.png',
},
}];
const ctx = {
app: {
config: {},
Sequelize: {
Op: {
in: 'in',
},
},
},
user: {
store_id: 2001,
store_name: '测试仓库',
employees_id: 9001,
employees_name: '测试员',
},
logger: {
info() {},
warn() {},
error() {},
},
model: {
async transaction() {
return transaction;
},
Receiving: {
async findOne() {
return {
id: 123,
warehouse_id: 2001,
store_id: 3001,
store_name: '测试货主',
receiving_number: 'RCV202604040001',
status: 'receiving',
remark: '',
details: [ detailRecord ],
};
},
async update() {
return [ 1 ];
},
},
FileReference: {
async findAll({ where }) {
if (where.business_type === 'receivingItem') {
return Array.isArray(itemImages) ? itemImages : defaultItemImages;
}
return [];
},
},
},
};
const service = new ReceivingService(ctx);
service.sendCompletionNotice = async options => {
steps.push(options.completionReport ? 'notice:file' : 'notice:text');
noticeCalls.push(options);
return {
success: true,
};
};
service.uploadCompletionExcelReport = async () => {
steps.push('excel');
if (uploadShouldFail) {
throw new Error('upload failed');
}
return {
fileKey: '收货完成_RCV202604040001.xlsx',
url: 'https://cdn.example.com/收货完成_RCV202604040001.xlsx',
};
};
return {
service,
steps,
noticeCalls,
};
}
function createReceivingSnapshot(deliveryMethod) {
return {
id: 123,
receiving_number: 'RCV202604040001',
warehouse_id: 2001,
store_id: 3001,
store_name: '测试货主',
delivery_method: deliveryMethod,
license_plate: '粤A12345',
tracking_number: 'YT123456789',
total_boxes: 3,
total_pallets: 1,
remark: '完成收货测试',
receiving_end_time: new Date('2026-04-04T12:30:00Z'),
details: [
{
id: 501,
product_name: '测试商品A',
system_product_id: 9001,
barcode: 'SKU-001',
actual_quantity: 8,
weight: 12,
},
],
};
}
describe('test/app/service/systems/storage.receiving.report.test.js', () => {
it('should build and upload completion excel in a single sheet with one preview column', async () => {
const { service, excelCalls } = createService();
const result = await service.uploadCompletionExcelReport({
receiving: {
id: 123,
receiving_number: 'RCV202604040001',
store_name: '测试货主',
warehouse_id: 2001,
delivery_method: 'truck',
license_plate: '粤A12345',
tracking_number: 'YT123456789',
total_boxes: 3,
total_pallets: 1,
remark: '完成收货测试',
receiving_end_time: new Date('2026-04-04T12:30:00Z'),
details: [
{
id: 501,
product_name: '测试商品A',
system_product_id: 9001,
barcode: 'SKU-001',
actual_quantity: 8,
weight: 12,
},
],
},
operator: {
employees_name: '测试员',
},
stats: {
total_details: 1,
matched_details: 1,
unmatched_details: 0,
total_quantity: 8,
},
detailImageMap: new Map([
[ '501', [
{ url: 'https://example.com/image-1.png' },
{ url: 'https://example.com/image-2.png' },
]],
]),
receivingImages: [
{ url: 'https://example.com/main-image.png' },
],
});
assert.equal(excelCalls.length, 1);
const [ options ] = excelCalls;
assert.equal(options.filename, '收货完成_RCV202604040001.xlsx');
assert.ok(String(options.dir || '').includes('receiving/completed'));
assert.equal(options.expireDays, 90);
assert.ok(Array.isArray(options.sheets));
assert.equal(options.sheets.length, 1);
const [ sheet ] = options.sheets;
assert.equal(sheet.name, '收货清单');
assert.ok(Array.isArray(sheet.rows));
assert.equal(sheet.skipHeader, true);
const receivingNumberRow = sheet.rows.find(item => Array.isArray(item) && item[0] === '收货单号');
assert.ok(receivingNumberRow, '应在主表区域包含收货单号行');
const deliveryMethodRow = sheet.rows.find(item => Array.isArray(item) && item[0] === '来货方式');
assert.ok(deliveryMethodRow, '应在主表区域包含来货方式行');
assert.equal(deliveryMethodRow[1], '货车');
const summaryImageRow = sheet.rows.find(item => Array.isArray(item) && item[0] === '收货图片');
assert.ok(summaryImageRow, '应在主表区域包含收货图片行');
assert.match(String(summaryImageRow[1]?.text || summaryImageRow[1] || ''), /main-image/);
const detailHeaderRow = sheet.rows.find(item => Array.isArray(item) && item[0] === '序号' && item[1] === '商品名称');
assert.ok(detailHeaderRow, '明细表头应出现在下方明细区开始处');
const detailRow = sheet.rows.find(item => Array.isArray(item) && item[1] === '测试商品A');
assert.ok(detailRow, '应在单 sheet 中包含明细行');
assert.match(String(detailRow[11]?.text || detailRow[11] || ''), /image-1\.png/);
assert.equal(detailRow[10], '');
assert.ok(Array.isArray(sheet.styledRows));
assert.ok(sheet.styledRows.some(item => item && item.style && item.style.font && item.style.font.bold), '应包含表头加粗样式');
assert.ok(Array.isArray(sheet.embeddedImages));
assert.equal(sheet.embeddedImages.length, 3);
assert.equal(result.url, 'https://cdn.example.com/收货完成_RCV202604040001.xlsx');
});
it('should send receiving completed notice with the unified event payload', async () => {
const { service, noticeCalls } = createService();
const result = await service.sendCompletionNotice({
receiving: {
id: 123,
receiving_number: 'RCV202604040001',
warehouse_id: 2001,
store_id: 3001,
store_name: '测试货主',
},
operator: {
employees_name: '测试员',
},
stats: {
total_details: 1,
matched_details: 1,
unmatched_details: 0,
total_quantity: 8,
},
completionReport: {
fileKey: '收货完成_RCV202604040001.xlsx',
url: 'https://cdn.example.com/收货完成_RCV202604040001.xlsx',
},
});
assert.equal(noticeCalls.length, 1);
const [ options ] = noticeCalls;
assert.equal(Number(options.warehouseId), 2001);
assert.equal(Number(options.storeId), 3001);
assert.equal(options.businessName, 'receiving');
assert.equal(options.event, 'receiving_completed');
assert.equal(options.messageType, 'file');
assert.equal(options.url, 'https://cdn.example.com/收货完成_RCV202604040001.xlsx');
assert.equal(options.subject.id, 2001);
assert.equal(options.subject.name, '测试仓库');
assert.match(String(options.content || ''), /收货单号:RCV202604040001 已完成/);
assert.equal(result.success, true);
});
it('should show only license plate for truck in notice content and report main rows', async () => {
const { service, excelCalls, noticeCalls } = createService();
const receiving = createReceivingSnapshot('truck');
await service.sendCompletionNotice({
receiving,
operator: {
employees_name: '测试员',
},
stats: {
total_details: 1,
matched_details: 1,
unmatched_details: 0,
total_quantity: 8,
},
});
await service.uploadCompletionExcelReport({
receiving,
operator: {
employees_name: '测试员',
},
stats: {
total_details: 1,
matched_details: 1,
unmatched_details: 0,
total_quantity: 8,
},
detailImageMap: new Map(),
receivingImages: [],
});
assert.equal(noticeCalls.length, 1);
assert.match(String(noticeCalls[0].content || ''), /车牌号:粤A12345/);
assert.ok(!String(noticeCalls[0].content || '').includes('物流单号'));
assert.equal(excelCalls.length, 1);
const [ sheet ] = excelCalls[0].sheets;
const labels = sheet.rows.filter(Array.isArray).map(item => String(item[0] || ''));
assert.ok(labels.includes('车牌号'));
assert.ok(!labels.includes('物流单号'));
});
it('should show only tracking number for express in notice content and report main rows', async () => {
const { service, excelCalls, noticeCalls } = createService();
const receiving = createReceivingSnapshot('express');
await service.sendCompletionNotice({
receiving,
operator: {
employees_name: '测试员',
},
stats: {
total_details: 1,
matched_details: 1,
unmatched_details: 0,
total_quantity: 8,
},
});
await service.uploadCompletionExcelReport({
receiving,
operator: {
employees_name: '测试员',
},
stats: {
total_details: 1,
matched_details: 1,
unmatched_details: 0,
total_quantity: 8,
},
detailImageMap: new Map(),
receivingImages: [],
});
assert.equal(noticeCalls.length, 1);
assert.match(String(noticeCalls[0].content || ''), /物流单号:YT123456789/);
assert.ok(!String(noticeCalls[0].content || '').includes('车牌号'));
assert.equal(excelCalls.length, 1);
const [ sheet ] = excelCalls[0].sheets;
const labels = sheet.rows.filter(Array.isArray).map(item => String(item[0] || ''));
assert.ok(labels.includes('物流单号'));
assert.ok(!labels.includes('车牌号'));
});
it('should hide both contact fields for other delivery methods', async () => {
const { service, excelCalls, noticeCalls } = createService();
const receiving = createReceivingSnapshot('other');
await service.sendCompletionNotice({
receiving,
operator: {
employees_name: '测试员',
},
stats: {
total_details: 1,
matched_details: 1,
unmatched_details: 0,
total_quantity: 8,
},
});
await service.uploadCompletionExcelReport({
receiving,
operator: {
employees_name: '测试员',
},
stats: {
total_details: 1,
matched_details: 1,
unmatched_details: 0,
total_quantity: 8,
},
detailImageMap: new Map(),
receivingImages: [],
});
assert.equal(noticeCalls.length, 1);
assert.ok(!String(noticeCalls[0].content || '').includes('车牌号'));
assert.ok(!String(noticeCalls[0].content || '').includes('物流单号'));
assert.equal(excelCalls.length, 1);
const [ sheet ] = excelCalls[0].sheets;
const labels = sheet.rows.filter(Array.isArray).map(item => String(item[0] || ''));
assert.ok(!labels.includes('车牌号'));
assert.ok(!labels.includes('物流单号'));
});
it('should support nested notice.index service shape from Egg loader', async () => {
const noticeCalls = [];
const ctx = {
app: {
config: {},
Sequelize: {
Op: {},
},
},
user: {
store_id: 2001,
store_name: '测试仓库',
},
logger: {
info() {},
warn() {},
error() {},
},
service: {
systems: {
notice: {
index: {
async send(options) {
noticeCalls.push(options);
return {
success: true,
message: 'ok',
data: {
matchedHookCount: 1,
sentCount: 1,
failedCount: 0,
},
};
},
},
},
},
},
};
const service = new ReceivingService(ctx);
const result = await service.sendCompletionNotice({
receiving: {
id: 123,
receiving_number: 'RCV202604040001',
warehouse_id: 2001,
store_id: 3001,
},
operator: {
employees_name: '测试员',
},
stats: {
total_details: 1,
matched_details: 1,
unmatched_details: 0,
total_quantity: 8,
},
});
assert.equal(noticeCalls.length, 1);
assert.equal(result.success, true);
assert.equal(result.message, 'ok');
});
it('should trigger text notice before excel and then send file notice after upload succeeds', async () => {
const { service, steps, noticeCalls } = createCompleteReceivingService();
const result = await service.completeReceiving({ id: 123 });
await Promise.resolve();
await Promise.resolve();
assert.equal(result.success, true);
assert.deepEqual(steps, [ 'commit', 'notice:text', 'excel', 'notice:file' ]);
assert.equal(noticeCalls.length, 2);
assert.equal(noticeCalls[0].completionReport ?? null, null);
assert.equal(Number(noticeCalls[0].receiving.store_id), 3001);
assert.equal(noticeCalls[1].completionReport.url, 'https://cdn.example.com/收货完成_RCV202604040001.xlsx');
});
it('should only send text notice when completion excel generation fails', async () => {
const { service, steps, noticeCalls } = createCompleteReceivingService({ uploadShouldFail: true });
const result = await service.completeReceiving({ id: 123 });
await Promise.resolve();
await Promise.resolve();
assert.equal(result.success, true);
assert.equal(result.data.completion_report, null);
assert.deepEqual(steps, [ 'commit', 'notice:text', 'excel' ]);
assert.equal(noticeCalls.length, 1);
assert.equal(noticeCalls[0].completionReport ?? null, null);
assert.equal(Number(noticeCalls[0].receiving.store_id), 3001);
});
it('should still complete and notify when detail has no matched product or completeness fields', async () => {
const { service, steps, noticeCalls } = createCompleteReceivingService({
detailOverrides: {
system_product_id: null,
barcode: '',
weight: 0,
actual_quantity: 1,
},
itemImages: [],
});
const result = await service.completeReceiving({ id: 123 });
await Promise.resolve();
await Promise.resolve();
assert.equal(result.success, true);
assert.deepEqual(steps, [ 'commit', 'notice:text', 'excel', 'notice:file' ]);
assert.equal(noticeCalls.length, 2);
assert.equal(Number(result.data.stats.matched_details), 0);
assert.equal(Number(result.data.stats.unmatched_details), 1);
});
});