6 Commits

Author SHA1 Message Date
liufumingren
498543b9d7 perf(external-send): 控制回传平台的请求量,避免被判刷单
全部回读订单行在批量场景会被平台当成高频访问,补齐三处节流:

- syncPending:同批相邻两单之间留 EXTERNAL_SEND_INTERVAL_MS(默认 300ms)
- resolveTraceId:按账号缓存,批量内只调一次 getUserInfo(原来每单一次)
- dgj.resolveTraceId():实例级缓存 5 分钟的 traceId,
  取号(fetchWaybillNo)与重打(waybillPrintData)改用它,批量取号不再逐单 getUserInfo

配合上一版的「快照拼报文」,发货每单只有 1 次 POST,不再回读订单行。

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-07 08:14:12 +08:00
liufumingren
bcca0075be feat(external-send): 发货回传改用本地快照拼报文,不再回读平台订单行
拉单时已把平台整行存进 orders.external_data(实测 113 字段,含 PathFlowCode /
ShippingType / OrderTags / SubOrders[].OrderItemId 这些状态表没有的内部字段),
发货报文其实就是这一行,所以没必要再回读平台。

- 新增 lib/dgjSendRow.js#buildSendRow:快照(静态内部字段)
  + 状态表(收件人/平台单号/运单号,可能晚于快照更新)
  + 最近一次成功取号记录(WaybillCodeId / Pid / ExpressCpCode / CreateDate)
  拼成订单行;PrintState/ExpressPrintTime 用取号记录覆盖(快照里恒为 0/空)
- externalSendSync.resolveSendRow:快照可用就不访问平台;缺快照(历史单)才回读兜底
- dgj 暴露 buildSendOrder 静态方法,供脚本/单测复用同一口径

实测(本地真实单 dgj-10000279877231):拼出的 Orders[0] 覆盖抓包全部 47 个关键字段
(163 个顶层键),面单块含 WaybillCodeId=10000298258339、Pid=ced304e7c1ffd618_0_1。

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-07 08:12:54 +08:00
liufumingren
01ab1ccdab fix(external-send): 发货回传改用 /NewOrder/OnlineSend 并按抓包补全报文
生产报错「店管家发货同步失败:请先勾选要发货的订单」= 平台没把提交的 Orders 当成有效选中项。

实测对比(2026-11-07):
- 空 Orders          → 「当前选中的订单都不是待发货状态,已取消发货」
- 我们的旧报文        → 「请先勾选要发货的订单」
- 抓包页面真实请求:`POST /NewOrder/OnlineSend`(不是 OnlineSendBatch),
  顶层带 TemplateId / ExpressCompanyId / ExcludeOrders / RequestBatchNumber,
  Orders[0] 带整行模型(ShopId、PlatformTypeName、UpFxUserId≠FxUserId、OrderTags、
  ShippingType 加密串、ExpressPrintTime、WaybillCodes、Items、OrderItemStrList 等)

改动:
- ONLINE_SEND_PATH 改为 /NewOrder/OnlineSend
- 新增 buildSendOrder:按抓包字段组装 Orders[i];再补 TemplateId/ExpressCompanyId 等顶层参数
- externalSendSync 把模板 ID / 快递公司ID / 快递编码传给 sendOrders
- 响应改为「整包 Success + Data.Orders[] 逐单结果」判定:
  逐单 IsSuccess=false 时,除「不是待发货状态/已发货/已取消/已关闭」(幂等)外都算失败

实测:新报文被平台接受(整包 Success=true, ErrorCode=200),
测试单返回逐单 ErrorMessage「订单不是待发货状态,请检查」(该单 08:06 已在平台手工发货),
按幂等口径视为已同步。

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-07 08:09:56 +08:00
liufumingren
6ffe7cc889 fix(waybill): 1688 分销单换算后按原始平台回读订单(域名回退)
平台换算只用于「选对模板」,订单行仍留在店管家原始平台分区,域名必须按
extend_props.original_platform_code 推导,否则会用错域名被判「平台已查不到」。

- fetchWaybillNo:新增 originalPlatformCode,用原始平台算订单域名;waybillGet 从 extend_props 透传
- fetchRowsForVerify:拉单核对/自动作废按原始平台选域名,并给候选行补 extend_props
- checkPlatformFinished:审核前已发货校验按原始平台选域名
- externalSendSync.resolveTarget:发货回传 PlatformType 优先按原始平台

实测同一条 1688 分销单:fxali 命中(ErpState=waitsellersend),fxdd 查不到。

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-07 05:44:57 +08:00
liufumingren
e49c25cd19 feat: 主体停用后下拉置灰不可切换、数据只读、定时任务跳过
- principalCheck 中间件加载主体状态:停用主体只放行读请求(GET/HEAD/OPTIONS)与导出任务提交,
  其余写操作(新建/编辑/推送/删除)一律 403「主体已停用,仅可查看与导出」
- 可选主体列表包含停用主体并按「启用优先」排序;/api/auth/profile 返回 status/disabled
- 顶栏主体下拉显示「xxx(已停用)」且不可选择;当前主体停用时在顶栏下方显示只读提示条
- 定时任务跳过停用主体:自动拉单、订单推送 WMS、发货推送、出库推送、发货结果回传平台、一键拉单任务
- 主体自身的 GET/PUT 未加主体状态校验,运维仍可通过接口重新启用

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-05 23:31:45 +08:00
liufumingren
e1e3bb638f feat(order): 拉单任务、外部发货同步与取号记录
- 拉单任务:新增 order_sync_tasks 异步任务池,按店铺逐店拉取外部打单平台订单,前端轮询进度
- 外部发货同步:配送后把发货结果同步回店管家,提供数量统计与批量重试(externalSendSync)
- 取号:新增 waybill_fetch_records 记录取号过程,外部快递接口补充菜鸟授权信息
- 补齐相关迁移、订单页同步入口/状态展示,并新增对接说明文档

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-04 20:53:35 +08:00