oms/backend/app/service/shopAreaSync.js
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

306 lines
12 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 Service = require('egg').Service;
/** 单页拉取的商家数量(店管家商家列表上限 200) */
const MERCHANT_PAGE_SIZE = 200;
/** 最多翻页次数:防止平台返回异常总数时死循环 */
const MAX_MERCHANT_PAGES = 50;
/** 店铺类型:外部打单平台商家 */
const SHOP_TYPE_EXTERNAL = 2;
/** 平台登录态失效的报错特征(各分区接口统一返回「登录信息过期」/token is invalid) */
const SESSION_EXPIRED_RE = /登录信息过期|登录已失效|token is invalid|未登录|缺少 token/i;
/** 商家已不在合作列表时写入店铺 extra 的原因(前端据此提示) */
const AUTO_DISABLED_REASON = '店铺已不在打单平台合作列表(可能已解绑或停用),系统已自动禁用';
/**
* 店铺「所在区」同步服务
*
* 店管家把每个商家挂在若干个分区(`DbAreas[]`,页面上叫「所在区」)下,拉单要靠这份声明
* 决定查哪些分区库。商家可能被平台迁移分区或解绑,声明过期会让拉单漏单/报错,因此需要定期刷新:
* 1. 同一账号下所有店铺共享一份商家列表,一次拉取只请求平台一次(定时任务里按账号去重);
* 2. 拉到的商家原样写回 shops.external_data(FxUserId、DbAreas 等拉单必需字段);
* 3. 商家已不在合作列表(解绑/删除/停用)时把店铺自动禁用,之后自动拉单与一键拉单都会跳过
* (两条链路都只取 status=1 的店铺),需人工把状态改回启用才会恢复。
*/
class ShopAreaSyncService extends Service {
/**
* 刷新某账号下全部店铺的「所在区」等信息
* @param {Object} account 账号实例(需 include platform)
* @param {Object} [options] 选项
* @param {boolean} [options.disableMissing] 商家已不在合作列表时是否自动禁用店铺(默认 true)
* @return {Promise<Object>} 刷新结果统计
*/
async refreshAccount(account, options = {}) {
const { ctx } = this;
const disableMissing = options.disableMissing !== false;
const platformService = ctx.service.externalPrintOrder.createPlatformService(account);
const merchants = await this.fetchMerchants(platformService);
const merchantMap = new Map();
for (const item of merchants) {
const externalId = String((item && item.external_id) || '').trim();
if (externalId) merchantMap.set(externalId, item);
}
const shops = await ctx.model.Shop.findAll({
where: { external_print_account_id: account.id, type: SHOP_TYPE_EXTERNAL },
order: [[ 'id', 'ASC' ]],
});
const now = new Date();
const result = {
account_id: Number(account.id),
merchants: merchants.length,
shops: shops.length,
updated: 0,
disabled: [],
missing: [],
restored: [],
// 平台重新授权/换绑后商家ID会变(店铺存的 external_data.Id 失效),按名称唯一命中时自动重新绑定
rebound: [],
voided: 0,
};
// 第一轮:按商家ID精确绑定(平台没变的情况)
const pending = [];
const usedIds = new Set();
for (const shop of shops) {
const externalId = this.resolveExternalId(shop);
const merchant = externalId ? merchantMap.get(externalId) : null;
if (merchant) {
usedIds.add(externalId);
await this.applyMerchant(shop, merchant, now, result);
} else {
pending.push(shop);
}
}
// 第二轮:ID 失效的店铺按名称唯一匹配重新绑定,避免「商家明明还在、只是换了ID」被当成已解绑
for (const shop of pending) {
const merchant = this.matchMerchantByName(shop, merchants, usedIds);
if (merchant) {
const externalId = String(merchant.external_id || '');
usedIds.add(externalId);
await this.applyMerchant(shop, merchant, now, result);
result.rebound.push({ id: Number(shop.id), code: shop.code, name: shop.name, external_id: externalId });
continue;
}
await this.markMissing(shop, now, { disableMissing, result });
}
if (result.rebound.length) {
ctx.logger.warn(
'[shopAreaSync] 账号 %s 有 %d 个店铺的商家ID已变化,已按名称重新绑定:%s',
account.id,
result.rebound.length,
result.rebound.map(item => `${item.id}(${item.name}) → 商家 ${item.external_id}`).join('、')
);
}
if (result.disabled.length) {
ctx.logger.warn(
'[shopAreaSync] 账号 %s 有 %d 个店铺已不在平台合作列表,自动禁用:%s',
account.id,
result.disabled.length,
result.disabled.map(item => `${item.id}(${item.name})`).join('、')
);
}
if (result.restored.length) {
ctx.logger.info(
'[shopAreaSync] 账号 %s 有 %d 个店铺重新出现在平台合作列表(保持禁用,等待人工启用):%s',
account.id,
result.restored.length,
result.restored.map(item => `${item.id}(${item.name})`).join('、')
);
}
return result;
}
/**
* 拉取账号下全部商家(分页汇总)
* @param {Object} platformService 平台服务实例
* @return {Promise<Array>} 商家列表(统一结构)
*/
async fetchMerchants(platformService) {
try {
return await this.pullAllMerchants(platformService);
} catch (err) {
// 会话过期时重新登录一次再拉,避免定时任务因为登录态失效整天刷不到分区
const expired = SESSION_EXPIRED_RE.test(String((err && err.message) || ''));
if (!expired || typeof platformService.loginByPassword !== 'function') throw err;
this.ctx.logger.warn('[shopAreaSync] 刷新店铺所在区时登录态失效,重新登录后重试:%s', err.message);
await platformService.loginByPassword();
return await this.pullAllMerchants(platformService);
}
}
/**
* 逐页拉取商家列表
* @param {Object} platformService 平台服务实例
* @return {Promise<Array>} 商家列表
*/
async pullAllMerchants(platformService) {
const all = [];
for (let pageIndex = 1; pageIndex <= MAX_MERCHANT_PAGES; pageIndex++) {
const page = await platformService.listShops({ pageIndex, pageSize: MERCHANT_PAGE_SIZE });
const list = Array.isArray(page && page.list) ? page.list : [];
all.push(...list);
const total = Number(page && page.total) || all.length;
if (!list.length || all.length >= total) break;
}
return all;
}
/**
* 按店铺名称唯一匹配平台商家(ID 失效时的补救)
*
* 平台重新授权/换绑后商家ID会变,但商家名称通常不变(如「13668975305(意洁)」)。
* 只有在「名称包含店铺名」的候选**唯一**、且该商家还没被别的店铺占用时才返回,
* 避免同名多商家时绑错。
* @param {Object} shop 店铺实例
* @param {Array<Object>} merchants 平台商家列表
* @param {Set<string>} usedIds 已被其它店铺占用的商家ID
* @return {Object|null} 命中的商家
*/
matchMerchantByName(shop, merchants, usedIds) {
const name = String((shop && shop.name) || '').trim();
if (!name) return null;
const candidates = (merchants || []).filter(item => {
const externalId = String((item && item.external_id) || '').trim();
if (!externalId || (usedIds && usedIds.has(externalId))) return false;
const raw = (item && item.raw) || {};
// 平台把商家名放在不同字段里(NickName 常是账号手机号),逐个字段比,别被第一个非空值挡住
const names = [
raw.ShopName,
raw.AgentShopName,
raw.SelfShopName,
raw.Name,
raw.NickName,
item && item.name,
]
.map(value => String(value == null ? '' : value).trim())
.filter(Boolean);
return names.some(value => value === name || value.includes(name));
});
if (candidates.length !== 1) return null;
return candidates[0];
}
/**
* 店铺在平台的商家ID:优先取 external_data.Id,缺失时按编码(平台-账号-商家ID)兜底解析
* @param {Object} shop 店铺实例
* @return {string} 商家ID,取不到返回空串
*/
resolveExternalId(shop) {
const data = shop.external_data || {};
if (data.Id != null && data.Id !== '') return String(data.Id);
const code = String(shop.code || '');
const index = code.lastIndexOf('-');
return index >= 0 ? code.slice(index + 1) : '';
}
/**
* 商家仍在合作列表:写回最新商家结构(含分区声明),并清掉「已解绑」标记
* @param {Object} shop 店铺实例
* @param {Object} merchant 平台商家(统一结构,raw 为原始结构)
* @param {Date} now 本次刷新时间
* @param {Object} result 累计统计
* @return {Promise<void>} 无返回值
*/
async applyMerchant(shop, merchant, now, result) {
const nextExternalData = merchant.raw || merchant;
const changed = JSON.stringify(shop.external_data || {}) !== JSON.stringify(nextExternalData);
const extra = { ...(shop.extra || {}) };
if (changed) shop.external_data = nextExternalData;
extra.area_synced_at = now;
if (extra.area_missing) delete extra.area_missing;
if (extra.auto_disabled) {
// 商家回到合作列表:只记录提示,是否启用由人工决定(自动启用可能与人工停用的意图冲突)
delete extra.auto_disabled;
extra.area_restored_at = now;
if (Number(shop.status) !== 1) {
shop.last_order_sync_msg = '店铺已重新出现在打单平台合作列表,可手动启用后继续拉单';
}
result.restored.push({ id: Number(shop.id), code: shop.code, name: shop.name });
}
shop.extra = extra;
await shop.save();
if (changed) result.updated++;
}
/**
* 商家已不在合作列表:标记 + (启用中时)自动禁用
* @param {Object} shop 店铺实例
* @param {Date} now 本次刷新时间
* @param {Object} params 参数
* @param {boolean} params.disableMissing 是否自动禁用
* @param {Object} params.result 累计统计
* @return {Promise<void>} 无返回值
*/
async markMissing(shop, now, { disableMissing, result }) {
const { ctx } = this;
const extra = { ...(shop.extra || {}) };
const item = { id: Number(shop.id), code: shop.code, name: shop.name };
extra.area_synced_at = now;
extra.area_missing = true;
result.missing.push(item);
const justDisabled = disableMissing && Number(shop.status) === 1;
if (justDisabled) {
shop.status = 0;
extra.auto_disabled = { at: now, reason: AUTO_DISABLED_REASON };
}
shop.extra = extra;
await shop.save();
if (!justDisabled) return;
// 禁用后无法取号:立即作废该店铺的待审核订单,避免继续审核/取号时报错(启用后自动恢复)
let voided = 0;
try {
const guarded = await ctx.service.shopOrderGuard.voidPendingOrders(shop);
voided = guarded.count;
} catch (err) {
ctx.logger.warn('[shopAreaSync] 店铺 %s 作废待审核订单失败:%s', shop.id, err.message);
}
result.voided += voided;
result.disabled.push(item);
await shop.update({
last_order_sync_msg:
`${AUTO_DISABLED_REASON};改回启用后会继续拉单` +
(voided ? `(已作废待审核订单 ${voided} 单,启用后自动恢复)` : ''),
});
}
/**
* 账号下店铺最近一次刷新「所在区」的时间(同账号一次拉取会写全部店铺,取最大值)
* @param {Array} shops 账号下的店铺实例
* @return {Date|null} 最近刷新时间
*/
lastSyncedAt(shops) {
let latest = null;
for (const shop of shops) {
const at = shop.extra && shop.extra.area_synced_at;
if (!at) return null;
const time = new Date(at).getTime();
if (Number.isNaN(time)) return null;
if (!latest || time > latest.getTime()) latest = new Date(time);
}
return latest;
}
}
module.exports = ShopAreaSyncService;