WMS_MAIN/test/app/controller/qimen.deliveryorder.reviewFlow.test.js
2026-04-17 19:21:57 +08:00

433 lines
17 KiB
JavaScript

'use strict';
const assert = require('node:assert/strict');
const crypto = require('node:crypto');
const {
getAuthToken,
invokeSystemMethod,
invokeQimenMethod,
} = require('../../support/system_method_client');
const EXTRA_HEADERS = {
platform: 'web',
project: 'all',
};
const FIXED_RELATION = {
storeId: 1000000,
warehouseId: 100000,
};
const FALLBACK_ROLE_IDS = [ 4, 6, 30 ];
/**
* 将字符串转义为 XML 安全文本。
* @param {string|number|null|undefined} value 待转义值。
* @return {string} 转义后的 XML 文本。
*/
function escapeXml(value) {
return String(value === null || value === undefined ? '' : value).replace(/[<>&'\"]/g, character => {
switch (character) {
case '<':
return '&lt;';
case '>':
return '&gt;';
case '&':
return '&amp;';
case '\'':
return '&apos;';
case '"':
return '&quot;';
default:
return character;
}
});
}
/**
* 从候选列表中挑选固定测试签约关系。
* @param {Array<object>} relations 签约关系列表。
* @return {object|null} 固定测试关系。
*/
function pickFixedTestRelation(relations) {
if (!Array.isArray(relations)) {
return null;
}
return relations.find(item => Number(item.store_id) === FIXED_RELATION.storeId
&& Number(item.warehouse_id) === FIXED_RELATION.warehouseId) || null;
}
/**
* 从接口配置列表中挑选一个已启用的 QM_WMS 配置。
* @param {Array<object>} configs 接口配置列表。
* @return {object|null} 可用奇门配置。
*/
function pickEnabledQimenConfig(configs) {
if (!Array.isArray(configs)) {
return null;
}
return configs.find(item => Number(item.is_enabled) === 1
&& (item.interface_category === 'QM_WMS' || item.interface_type?.interface_category === 'QM_WMS')) || null;
}
/**
* 从库存搜索结果中挑选一个可用 SKU。
* @param {Array<object>} stocks 库存搜索结果。
* @return {object|null} 可用 SKU。
*/
function pickUsableStock(stocks) {
if (!Array.isArray(stocks)) {
return null;
}
const resolveAvailableQuantity = item => {
const directAvailableFields = [
item?.available_quantity,
item?.availableQuantity,
item?.available,
];
for (const value of directAvailableFields) {
const numeric = Number(value);
if (Number.isFinite(numeric) && numeric > 0) {
return numeric;
}
}
const quantity = Number(item?.quantity);
const lockedQuantity = Number(item?.locked_quantity ?? item?.lockedQuantity ?? item?.lockQuantity);
if (Number.isFinite(quantity) && quantity > 0) {
const resolvedLocked = Number.isFinite(lockedQuantity) ? lockedQuantity : 0;
return Math.max(0, quantity - resolvedLocked);
}
const storageList = Array.isArray(item?.storage) ? item.storage : [];
for (const storageItem of storageList) {
const storageAvailable = Number(storageItem?.available_quantity ?? storageItem?.availableQuantity ?? storageItem?.available);
if (Number.isFinite(storageAvailable) && storageAvailable > 0) {
return storageAvailable;
}
const storageQuantity = Number(storageItem?.quantity);
const storageLocked = Number(storageItem?.locked_quantity ?? storageItem?.lockedQuantity);
if (Number.isFinite(storageQuantity) && storageQuantity > 0) {
const resolvedStorageLocked = Number.isFinite(storageLocked) ? storageLocked : 0;
const available = Math.max(0, storageQuantity - resolvedStorageLocked);
if (available > 0) {
return available;
}
}
}
return 0;
};
return stocks.find(item => resolveAvailableQuantity(item) > 0) || null;
}
/**
* 构建待审核订单的 XML 请求体。
* @param {Object} payload 请求参数。
* @return {string} XML 请求体。
*/
function buildDeliveryOrderXml(payload) {
const { deliveryOrderCode, warehouseCode, stock, planQty, orderType, receiverInfo } = payload;
return `<?xml version="1.0" encoding="UTF-8"?>
<request>
<deliveryOrder>
<deliveryOrderCode>${escapeXml(deliveryOrderCode)}</deliveryOrderCode>
<sourcePlatformCode>TAOBAO</sourcePlatformCode>
<sourcePlatformName>淘宝</sourcePlatformName>
<warehouseCode>${escapeXml(warehouseCode)}</warehouseCode>
<orderType>${escapeXml(orderType)}</orderType>
<receiverInfo>
<name>${escapeXml(receiverInfo.name)}</name>
<mobile>${escapeXml(receiverInfo.mobile)}</mobile>
<province>${escapeXml(receiverInfo.province)}</province>
<city>${escapeXml(receiverInfo.city)}</city>
<area>${escapeXml(receiverInfo.area)}</area>
<town>${escapeXml(receiverInfo.town)}</town>
<detailAddress>${escapeXml(receiverInfo.detailAddress)}</detailAddress>
<zipCode>${escapeXml(receiverInfo.zipCode)}</zipCode>
</receiverInfo>
</deliveryOrder>
<orderLines>
<orderLine>
<itemId>${escapeXml(stock.id)}</itemId>
<itemCode>${escapeXml(stock.item_code)}</itemCode>
<itemName>${escapeXml(stock.item_name)}</itemName>
<planQty>${escapeXml(planQty)}</planQty>
<orderLineNo>1</orderLineNo>
</orderLine>
</orderLines>
</request>`;
}
/**
* 切换到可访问仓库订单和库存接口的仓库角色。
* @param {string} token 当前登录 token。
* @return {Promise<{token: string, roleId: number}|null>} 切换结果。
*/
async function switchToWarehouseRole(token) {
const infoRes = await invokeSystemMethod('user.info', {}, token, EXTRA_HEADERS);
assert.equal(infoRes.status, 200, `user.info HTTP 状态异常: ${JSON.stringify(infoRes.body)}`);
assert.equal(infoRes.body.flag, 'success', `user.info 返回失败: ${JSON.stringify(infoRes.body)}`);
assert.equal(infoRes.body.code, 200, `user.info code 异常: ${JSON.stringify(infoRes.body)}`);
const employees = Array.isArray(infoRes.body?.data?.employees) ? infoRes.body.data.employees : [];
const candidateRoleIds = [
...new Set([
...employees
.filter(item => item && item.role_type === 'warehouse' && Number(item.id))
.map(item => Number(item.id)),
...FALLBACK_ROLE_IDS,
].filter(Boolean)),
];
for (const roleId of candidateRoleIds) {
const changeRes = await invokeSystemMethod('user.changeRole', {
roleId,
}, token, EXTRA_HEADERS);
if (changeRes.status !== 200 || changeRes.body?.flag !== 'success' || Number(changeRes.body?.code) !== 200) {
continue;
}
const switchedToken = changeRes.body?.data?.token || token;
const relationProbeRes = await invokeSystemMethod('storeWarehouse.store.list', {
page: 1,
page_size: 50,
}, switchedToken, EXTRA_HEADERS);
const stockProbeRes = await invokeSystemMethod('stock.warehouse.search', {
keyword: '',
store_id: FIXED_RELATION.storeId,
with_stock: true,
is_batch: false,
}, switchedToken, EXTRA_HEADERS);
if (relationProbeRes.status === 200
&& relationProbeRes.body?.flag === 'success'
&& Number(relationProbeRes.body?.code) === 200
&& pickFixedTestRelation(relationProbeRes.body?.data?.list)
&& stockProbeRes.status === 200
&& stockProbeRes.body?.flag === 'success'
&& Number(stockProbeRes.body?.code) === 200) {
return {
token: switchedToken,
roleId,
};
}
}
return null;
}
describe('test/app/controller/qimen.deliveryorder.reviewFlow.test.js', () => {
it('should create, review and move a delivery order through the real qimen flow', async function() {
const auth = await getAuthToken({ forceLogin: true });
const switched = await switchToWarehouseRole(auth.token);
if (!switched) {
this.skip();
return;
}
let relation = null;
let qimenConfig = null;
let stock = null;
let originalPolicyConfig = null;
let contractId = null;
const deliveryOrderCode = `QIMEN_REVIEW_${Date.now()}_${crypto.randomBytes(4).toString('hex').toUpperCase()}`;
try {
const relationListRes = await invokeSystemMethod('storeWarehouse.store.list', {
page: 1,
page_size: 50,
}, switched.token, EXTRA_HEADERS);
assert.equal(relationListRes.status, 200, `查询签约关系列表 HTTP 状态异常: ${JSON.stringify(relationListRes.body)}`);
assert.equal(relationListRes.body.flag, 'success', `查询签约关系列表失败: ${JSON.stringify(relationListRes.body)}`);
assert.equal(Number(relationListRes.body.code), 200, `查询签约关系列表 code 异常: ${JSON.stringify(relationListRes.body)}`);
relation = pickFixedTestRelation(relationListRes.body?.data?.list);
if (!relation) {
this.skip();
return;
}
contractId = Number(relation.id || 0);
originalPolicyConfig = relation.policy_config && typeof relation.policy_config === 'object'
? { ...relation.policy_config }
: null;
if (!originalPolicyConfig) {
this.skip();
return;
}
const apiConfigRes = await invokeSystemMethod('storeWarehouse.store.listApiConfig', {
id: contractId,
}, switched.token, EXTRA_HEADERS);
assert.equal(apiConfigRes.status, 200, `查询接口配置列表 HTTP 状态异常: ${JSON.stringify(apiConfigRes.body)}`);
assert.equal(apiConfigRes.body.flag, 'success', `查询接口配置列表失败: ${JSON.stringify(apiConfigRes.body)}`);
assert.equal(Number(apiConfigRes.body.code), 200, `查询接口配置列表 code 异常: ${JSON.stringify(apiConfigRes.body)}`);
qimenConfig = pickEnabledQimenConfig(apiConfigRes.body?.data?.list);
if (!qimenConfig
|| !String(qimenConfig.qimen_app_key || '').trim()
|| !String(qimenConfig.qimen_customer_id || '').trim()
|| !String(qimenConfig.qimen_warehouse_code || '').trim()) {
this.skip();
return;
}
const stockSearchRes = await invokeSystemMethod('stock.warehouse.search', {
keyword: '',
store_id: FIXED_RELATION.storeId,
with_stock: true,
is_batch: false,
}, switched.token, EXTRA_HEADERS);
assert.equal(stockSearchRes.status, 200, `查询库存搜索 HTTP 状态异常: ${JSON.stringify(stockSearchRes.body)}`);
assert.equal(stockSearchRes.body.flag, 'success', `查询库存搜索失败: ${JSON.stringify(stockSearchRes.body)}`);
assert.equal(Number(stockSearchRes.body.code), 200, `查询库存搜索 code 异常: ${JSON.stringify(stockSearchRes.body)}`);
stock = pickUsableStock(stockSearchRes.body?.data?.data || stockSearchRes.body?.data?.list || []);
if (!stock) {
this.skip();
return;
}
const nextPolicyConfig = {
...originalPolicyConfig,
need_order_approval: 1,
};
const savePolicyRes = await invokeSystemMethod('storeWarehouse.store.savePolicyConfig', {
id: contractId,
policy_config: nextPolicyConfig,
}, switched.token, EXTRA_HEADERS);
assert.equal(savePolicyRes.status, 200, `临时设置审核策略 HTTP 状态异常: ${JSON.stringify(savePolicyRes.body)}`);
assert.equal(savePolicyRes.body.flag, 'success', `临时设置审核策略失败: ${JSON.stringify(savePolicyRes.body)}`);
assert.equal(Number(savePolicyRes.body.code), 200, `临时设置审核策略 code 异常: ${JSON.stringify(savePolicyRes.body)}`);
assert.equal(Number(savePolicyRes.body?.data?.policy_config?.need_order_approval || 0), 1, '临时策略必须把 need_order_approval 置为 1');
const receiverInfo = {
name: '自动化测试收件人',
mobile: '13800138000',
province: '广东省',
city: '广州市',
area: '黄埔区',
town: '知识城街道',
detailAddress: `自动化测试地址 ${deliveryOrderCode}`,
zipCode: '510000',
};
const requestXml = buildDeliveryOrderXml({
deliveryOrderCode,
warehouseCode: String(qimenConfig.qimen_warehouse_code || '').trim(),
stock,
planQty: 1,
orderType: 'JYCK',
receiverInfo,
});
const createRes = await invokeQimenMethod('deliveryorder.create', requestXml, {
appKey: String(qimenConfig.qimen_app_key || '').trim(),
customerId: String(qimenConfig.qimen_customer_id || '').trim(),
contentType: 'application/xml',
format: 'xml',
signMethod: 'md5',
});
assert.equal(createRes.status, 200, `qimen 创建待审核订单 HTTP 状态异常: ${createRes.body}`);
const createResponse = createRes.parsed?.response || createRes.parsed || {};
assert.equal(String(createResponse.flag || ''), 'success', `qimen 创建待审核订单失败。请求 XML:\n${requestXml}\n响应原文:\n${createRes.body}`);
assert.match(String(createRes.body || ''), /deliveryOrderId|createTime|success/i, `qimen 创建响应缺少预期字段。请求 XML:\n${requestXml}\n响应原文:\n${createRes.body}`);
const reviewListRes = await invokeSystemMethod('order.reviewOrder.list', {
pagination: {
page: 1,
pageSize: 20,
},
where: {
delivery_order_code: deliveryOrderCode,
},
}, switched.token, EXTRA_HEADERS);
assert.equal(reviewListRes.status, 200, `待审核列表 HTTP 状态异常: ${JSON.stringify(reviewListRes.body)}`);
assert.equal(reviewListRes.body.flag, 'success', `待审核列表查询失败: ${JSON.stringify(reviewListRes.body)}`);
assert.equal(Number(reviewListRes.body.code), 200, `待审核列表 code 异常: ${JSON.stringify(reviewListRes.body)}`);
const reviewItems = Array.isArray(reviewListRes.body?.data?.list) ? reviewListRes.body.data.list : [];
const createdReviewOrder = reviewItems.find(item => String(item.delivery_order_code) === deliveryOrderCode);
assert.ok(createdReviewOrder, `待审核列表未命中刚创建的订单。响应原文: ${JSON.stringify(reviewListRes.body)}`);
assert.equal(Number(createdReviewOrder.step), 0, `新建订单应处于待审核 step=0。响应原文: ${JSON.stringify(reviewListRes.body)}`);
const reviewActionRes = await invokeSystemMethod('order.reviewOrder.reviewOrder', {
ids: [ Number(createdReviewOrder.id) ],
}, switched.token, EXTRA_HEADERS);
assert.equal(reviewActionRes.status, 200, `审核接口 HTTP 状态异常: ${JSON.stringify(reviewActionRes.body)}`);
assert.equal(reviewActionRes.body.flag, 'success', `审核接口调用失败: ${JSON.stringify(reviewActionRes.body)}`);
assert.equal(Number(reviewActionRes.body.code), 200, `审核接口 code 异常: ${JSON.stringify(reviewActionRes.body)}`);
assert.equal(Number(reviewActionRes.body?.data?.step), 1, `审核后订单 step 应变为 1。响应原文: ${JSON.stringify(reviewActionRes.body)}`);
const pendingListRes = await invokeSystemMethod('order.pendingOrder.list', {
pagination: {
page: 1,
pageSize: 20,
},
where: {
delivery_order_code: deliveryOrderCode,
},
}, switched.token, EXTRA_HEADERS);
assert.equal(pendingListRes.status, 200, `待处理列表 HTTP 状态异常: ${JSON.stringify(pendingListRes.body)}`);
assert.equal(pendingListRes.body.flag, 'success', `待处理列表查询失败: ${JSON.stringify(pendingListRes.body)}`);
assert.equal(Number(pendingListRes.body.code), 200, `待处理列表 code 异常: ${JSON.stringify(pendingListRes.body)}`);
const pendingItems = Array.isArray(pendingListRes.body?.data?.list) ? pendingListRes.body.data.list : [];
const pendingOrder = pendingItems.find(item => String(item.delivery_order_code) === deliveryOrderCode);
assert.ok(pendingOrder, `待处理列表未命中已审核订单。响应原文: ${JSON.stringify(pendingListRes.body)}`);
assert.ok([ 1, 2 ].includes(Number(pendingOrder.step)), `审核后订单 step 应处于待处理范围。响应原文: ${JSON.stringify(pendingListRes.body)}`);
const reviewAfterRes = await invokeSystemMethod('order.reviewOrder.list', {
pagination: {
page: 1,
pageSize: 20,
},
where: {
delivery_order_code: deliveryOrderCode,
},
}, switched.token, EXTRA_HEADERS);
assert.equal(reviewAfterRes.status, 200, `复查待审核列表 HTTP 状态异常: ${JSON.stringify(reviewAfterRes.body)}`);
assert.equal(reviewAfterRes.body.flag, 'success', `复查待审核列表失败: ${JSON.stringify(reviewAfterRes.body)}`);
assert.equal(Number(reviewAfterRes.body.code), 200, `复查待审核列表 code 异常: ${JSON.stringify(reviewAfterRes.body)}`);
const reviewAfterItems = Array.isArray(reviewAfterRes.body?.data?.list) ? reviewAfterRes.body.data.list : [];
const reviewAfterOrder = reviewAfterItems.find(item => String(item.delivery_order_code) === deliveryOrderCode);
assert.equal(reviewAfterOrder, undefined, `审核完成后不应再命中待审核列表。响应原文: ${JSON.stringify(reviewAfterRes.body)}`);
} finally {
if (contractId && originalPolicyConfig) {
const restoreRes = await invokeSystemMethod('storeWarehouse.store.savePolicyConfig', {
id: contractId,
policy_config: originalPolicyConfig,
}, switched.token, EXTRA_HEADERS);
assert.equal(restoreRes.status, 200, `恢复原 policy_config 的 HTTP 状态异常: ${JSON.stringify(restoreRes.body)}`);
assert.equal(restoreRes.body.flag, 'success', `恢复原 policy_config 失败: ${JSON.stringify(restoreRes.body)}`);
assert.equal(Number(restoreRes.body.code), 200, `恢复原 policy_config code 异常: ${JSON.stringify(restoreRes.body)}`);
}
}
});
});