2 Commits

Author SHA1 Message Date
liufumingren
f47d8ccdec fix(pull): 声明分区过期时补查其它域名 + 商家ID失效按名称重绑
用户现象:意洁点「拉取订单」0 单,但店管家 UI(精选-二区)有单;「同步商品」
同样 0 条,而「按商品ID补拉」能拿到 —— 说明不是没有数据,是**全量拉取只查了店铺
声明的域名/分区声明**(external_data.DbAreas)里那几块,声明过期就永远拉不到。

- dgj.listOrders:声明域名一单都没拉到(且没有平台已发货登记)时,补查账号其它域名
  (FALLBACK_PRODUCT_HOSTS 里未声明的),命中记入 supplementHosts 并 warn;
  「按商品ID补拉」本来就是这个兜底策略,现在全量拉取也一致
- dgj.listProducts:声明域名一个商品都没有时同样补查其它域名
- externalPrintOrder:新增 buildSupplementHint —— 靠补查才拉到单时提示
  「店铺声明的分区 X 没拉到单,已自动补查 Y 并拉到 N 单;建议刷新店铺所在区/商家」
- shopAreaSync:商家ID在平台已不存在时,先按店铺名称在商家列表里找**唯一**候选并
  重新绑定(rebound,写 warn 日志);同名多候选/已被别的店铺占用/无名称时不猜,
  保持原有「标记已解绑并自动禁用」逻辑
  → 修掉「重新授权/换绑后商家ID变了,店铺被当成已解绑而禁用,拉单一律 0」

验证:
- 单测 shopAreaSync.test.js(唯一命中 / 同名多候选 / 已占用 / 空名称)、
  pullOrderHint.test.js 补 3 例(补查提示与边界),test/app/lib 73 passing
- 真实库:把意洁店铺的 extId 改坏后 refreshAccount → 按名称重绑回 3966847、
  FxUserId 恢复 953516、状态未被禁用;再刷新 5 个店铺 missing/disabled 均为空;
  声明域名只保留 toutiao 时应能靠补查把抖店 6 单拉回来(已单测覆盖提示口径)

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-07 19:40:33 +08:00
liufumingren
3a4eebb71d feat(shop): 店铺所在区刷新与解绑自动禁用,禁用时作废待审核订单
- 新增 shopAreaSync:按账号拉一次商家列表(同账号多店铺共享,PageSize=200 翻页),
  把最新商家结构(FxUserId、分区声明 DbAreas)写回 shops.external_data;
  商家已不在合作列表时自动把店铺置为禁用,并写明原因
- 手动刷新入口:POST /api/shops/{id}/refresh-area(货主权限)、
  POST /api/external-print-accounts/{id}/refresh-shops-area(集团权限)
- 新增定时任务 refreshExternalShopAreas:每小时巡检,按账号 6 小时刷新一次
  (DGJ_AREA_REFRESH_HOURS 可调),自动禁用店铺后不再参与自动拉单与一键拉单
- 新增 shopOrderGuard:店铺禁用立即作废该店铺待审核订单
  (void_reason 前缀「店铺已禁用,暂停处理」),重新启用时只恢复因此暂停的订单;
  禁用店铺再拉单直接拒绝,避免又拉回待审核单
- externalPrintOrder 待审核单核对改用 LogicOrderId 批量回读(50 单/批,最多 300 单)
- orderStatus.restore 支持显式 principalId,供无登录态的系统任务调用
- 前端:店铺列表新增「所在区」列与行内/详情「刷新所在区」按钮,
  系统自动禁用的店铺状态带原因提示,启停与刷新后提示作废/恢复了多少订单
- 文档:新增 §4.2.2「所在区」刷新、§4.2.3 店铺禁用/启用与待审核订单
  (原 LastWaybillCode 小节顺延为 §4.2.4,WMS 对接文档引用同步)

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-07 00:19:02 +08:00