liufumingren 16d5f18fa1 feat(openapi): interface_type_id=2 强制合约注入 + 全链路 store_id 防护
核心改动:
- openapi.js: 新增 resolveOpenapiContract 强制合约解析(required:true JOIN),
  dispatchOpenapiMethod 统一注入上下文(setInfo)
- 5个 openapiMethods: 移除重复 resolveAppInfo, 统一使用 this.getInfo()
- deliveryorder/entryorder/stockout: findByPk(itemId) 后增加 store_id 一致性校验

安全修复:
- 修复 itemId 路径跨货主越权漏洞(FindByPk 无 store_id 过滤)
- deliveryorder/inventory/singleitem 查询补全 store_id 过滤
- 合约缺失返回 403 而非穿透业务层

测试覆盖: 9方法×3层防护(合约/注入/过滤)全部通过集成测试
2026-07-15 00:10:40 +08:00

146 lines
5.2 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 MainService = require('../main');
/**
* OpenAPI 入库单服务。
* 对外提供入库单的创建与查询能力,通过 openapi 通道对接外部系统。
*/
class OpenapiEntryorderService extends MainService {
/**
* 创建入库单。
* 上下文(storeId/warehouseId/appKey/warehouseCode)已由 dispatchOpenapiMethod 统一注入。
* 接收外部系统的入库单数据,校验后通过底层 entryOrder 服务完成入库单创建。
* @param {Object} payload 调用参数。
* @param {Object} payload.body 请求体数据,包含 entryOrder(入库单信息)和 orderLines(明细行)。
* @param {Object} payload.query 请求 query 数据。
* @return {Promise<Object>} 创建结果,成功时返回 entryOrderId、entryOrderCode、status 和 createTime。
*/
async create(payload = {}) {
const { body = {} } = payload;
const { entryOrder, orderLines } = body;
if (!entryOrder || !entryOrder.entryOrderCode) {
return this.fail('entryOrder.entryOrderCode 参数缺失');
}
if (!orderLines || !orderLines.orderLine) {
return this.fail('orderLines.orderLine 参数缺失');
}
// 字段映射:OpenAPI 风格字段名 → 底层 tryCreateEntryOrder 期望的字段名
const mappedEntryOrder = {
entryOrderCode: entryOrder.entryOrderCode,
orderType: entryOrder.entryOrderType || entryOrder.orderType || 'SCRK',
expectStartTime: entryOrder.expectedArriveTime || entryOrder.expectStartTime || '',
expectEndTime: entryOrder.expectEndTime || '',
supplierCode: entryOrder.supplierCode || '',
supplierName: entryOrder.supplierName || '',
warehouseCode: entryOrder.warehouseCode || '',
ownerCode: entryOrder.ownerCode || '',
remark: entryOrder.remark || '',
totalOrderLines: entryOrder.totalOrderLines || 0,
operateTime: entryOrder.operateTime || '',
operatorName: entryOrder.operatorName || '',
orderCreateTime: entryOrder.orderCreateTime || entryOrder.createTime || '',
logisticsCode: entryOrder.logisticsCode || '',
logisticsName: entryOrder.logisticsName || '',
expressCode: entryOrder.expressCode || '',
relatedOrders: entryOrder.relatedOrders || undefined,
};
try {
const data = {
request: {
entryOrder: mappedEntryOrder,
orderLines,
},
};
const res = await this.ctx.service.systems.entryOrder.addOrder(
data,
this.getInfo(),
'API'
);
if (res.success) {
return this.success(res.message, {
createTime: this.app.formatDate(new Date()),
entryOrderId: res.data.entryOrderId,
entryOrderCode: res.data.entryOrderCode,
status: res.data.status,
});
}
return this.fail(res.message, { createTime: this.app.formatDate(new Date()) });
} catch (error) {
return this.fail(`创建入库单失败: ${error.message}`);
}
}
/**
* 查询入库单。
* 上下文(storeId/warehouseId)已由 dispatchOpenapiMethod 统一注入。
* 根据入库单号查询入库单详情,包括基本信息与商品明细。
* @param {Object} payload 调用参数。
* @param {Object} payload.body 请求体数据,需包含 entryOrderCode(入库单号)。
* @param {Object} payload.query 请求 query 数据。
* @return {Promise<Object>} 查询结果,成功时返回入库单详情。
*/
async query(payload = {}) {
const { body = {} } = payload;
const { entryOrderCode } = body;
if (!entryOrderCode) {
return this.fail('entryOrderCode 参数缺失');
}
try {
const { storeId, warehouseId, warehouseCode } = this.getInfo();
const order = await this.ctx.service.systems.entryOrder.findByOrderCode(
entryOrderCode,
warehouseId,
storeId
);
if (!order) {
return this.fail('未找到入库单');
}
const orderLines = (order.items || []).map(item => ({
itemId: item.stock_id,
itemCode: (item.stock && item.stock.item_code) || '',
itemName: (item.stock && item.stock.item_name) || '',
planQty: item.count,
actualQty: item.actual_qty || 0,
inventoryType: item.inventory_type || 'ZP',
orderLineNo: item.order_line_no || '',
remark: item.remark || '',
}));
return this.success('查询成功', {
entryOrderCode: order.entry_order_code,
entryOrderId: order.id,
status: order.order_status,
entryOrderType: order.order_type || 'SCRK',
expectedArriveTime: order.expected_arrive_time || '',
supplierCode: order.supplier_code || '',
supplierName: order.supplier_name || '',
remark: order.remark || '',
createTime: order.created_at || '',
operateTime: order.updated_at || '',
operatorName: order.operator_name || '',
warehouseCode: order.warehouse_code || warehouseCode,
ownerCode: order.store_code || '',
totalOrderLines: order.total_order_lines || 0,
orderLines,
});
} catch (error) {
return this.fail(`查询入库单失败: ${error.message}`);
}
}
}
module.exports = OpenapiEntryorderService;