oms/backend/app/lib/orderReceiver.js
liufumingren 6c03a20364 feat(backend): 订单状态分表、WMS 推送与归档
- 新增 order_index 索引表 + 6 张同构状态表(待审核/异常/委外中/配送/已作废/已取消)与历史表,
  订单 ID 全局唯一,状态由业务事务推动:审核、驳回、取消、作废、恢复、归档
- 明细表 order_status_items、收件人文本智能解析、批量切换仓库/店铺并刷新快照
- WMS deliveryorder.create 推送(单条/批量)、推送失败定时重试、订单归档定时任务
- 迁移:建表、旧发货单数据迁入新表、菜单合并与迁移记录清理
- routes / swagger contract 补充订单状态接口

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-10-30 23:06:18 +08:00

41 lines
1.4 KiB
JavaScript
Raw Permalink 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';
/**
* 订单收件人信息校验(与发货单口径一致,见 app/controller/orderDelivery.js#validateReceiver)
* - 必填:姓名 / 省 / 市 / 区 / 街道(镇)
* - 电话(tel)与手机(mobile)至少填写一个
*/
/** 收件人必填字段(对齐取号硬依赖) */
const RECEIVER_REQUIRED_FIELDS = [
[ 'name', '收件人姓名' ],
[ 'province', '省份' ],
[ 'city', '城市' ],
[ 'area', '区县' ],
[ 'town', '街道/镇' ],
];
/**
* 校验收件人信息
* @param {Object} data 待校验数据(可为记录现值 + 本次变更合并后的结果)
* @return {String} 错误信息,校验通过返回空串
*/
function validateReceiver(data) {
const source = data || {};
// 老单据的收件人姓名可能落在 receiver 列上(新表核心字段),合并判断
const merged = { ...source, name: source.name || source.receiver };
for (const [ key, label ] of RECEIVER_REQUIRED_FIELDS) {
const value = merged[key] == null ? '' : String(merged[key]).trim();
if (!value) return `收件人信息不完整:${label}为必填项`;
}
const tel = merged.tel == null ? '' : String(merged.tel).trim();
const mobile = merged.mobile == null ? '' : String(merged.mobile).trim();
if (!tel && !mobile) return '收件人信息不完整:电话(tel)与手机(mobile)至少填写一个';
return '';
}
module.exports = {
RECEIVER_REQUIRED_FIELDS,
validateReceiver,
};