抽离后台履约规则校验辅助逻辑

apps/backend/src/services/admin/admin-platform-config-service.js

@@ -76,7 +76,6 @@ import {
 import { getFulfillmentProfileByKey } from '../../repositories/fulfillment-profile-repo.js'
 import { createHttpError } from '../../utils/http.js'
 import { syncConfiguredFulfillmentBindings } from '../bootstrap/fulfillment-bootstrap-service.js'
-import { normalizeProductName } from '../order/product-match-service.js'
 import { resolveDisplayShopName } from './admin-read-shared-helpers.js'
 import {
   hasCloudtentaclesCredentialContextChanged,
@@ -90,13 +89,17 @@ import {
   normalizeFulfillmentLookupPayload,
   resolveFulfillmentLookupDetail,
 } from './admin-platform-config-fulfillment.js'
+import {
+  assertAdminFulfillmentBindingsInput,
+  buildAdminFulfillmentBindingUniqueKey,
+  normalizeAdminFulfillmentBindingItem,
+} from './admin-platform-config-validation.js'
 import {
   applyOptionalStringField,
   mapAdminAgisoMessagingDefaults,
   mapAdminAgisoShopConfigItem,
   mapAdminFulfillmentBindingConfigItem,
   mapAdminObservedProductItem,
-  resolveFulfillmentBindingMatchShopId,
 } from './admin-platform-config-domain.js'
 import {
   mapAdminCloudtentaclesSession,
@@ -845,111 +848,28 @@ export async function updateAdminFulfillmentBindingConfigs(
 }
 
 async function validateAdminFulfillmentBindingConfigs(bindings = []) {
-  if (!Array.isArray(bindings)) {
-    throw createHttpError('履约配置格式不正确', {
-      statusCode: 400,
-      errorCode: 'admin_fulfillment_bindings_invalid_payload',
-    })
-  }
+  assertAdminFulfillmentBindingsInput(bindings)
 
   const seenKeys = new Set()
   const kuaishouEticketSource = getKuaishouEticketSourceConfig()
   const normalizedBindings = []
 
   for (const [index, rawBinding] of bindings.entries()) {
-    if (!isPlainObject(rawBinding)) {
-      throw createHttpError(`第 ${index + 1} 条规则格式不正确`, {
-        statusCode: 400,
-        errorCode: 'admin_fulfillment_bindings_invalid_item',
-      })
-    }
+    const normalized = normalizeAdminFulfillmentBindingItem(rawBinding, {
+      index,
+      kuaishouEticketSource,
+      resolveKuaishouEticketShopConfig,
+    })
 
-    const provider = String(rawBinding.provider || 'agiso').trim() || 'agiso'
-    const platform = String(rawBinding.platform || '').trim()
-    let shopId = String(rawBinding.shopId || '').trim()
-    let shopName = String(rawBinding.shopName || '').trim()
-    const khhaoShopId = String(rawBinding.khhaoShopId || '').trim()
-    const skuCode = String(rawBinding.skuCode || '').trim()
-    const skuName = String(rawBinding.skuName || '').trim()
-    const profileKey = String(rawBinding.profileKey || '').trim() || 'manual_review'
-    const match = isPlainObject(rawBinding.match) ? rawBinding.match : {}
-    const externalItemId = String(match.externalItemId || '').trim()
-    const externalSkuCode = String(match.externalSkuCode || '').trim()
-    const externalSkuName = String(match.externalSkuName || '').trim()
-    const config = isPlainObject(rawBinding.config) ? { ...rawBinding.config } : {}
-
-    if (provider === 'khhao' && platform === 'kuaishou') {
-      if (!khhaoShopId) {
-        throw createHttpError(`第 ${index + 1} 条快手规则缺少 khhao 店铺 ID`, {
-          statusCode: 400,
-          errorCode: 'admin_fulfillment_bindings_missing_khhao_shop_id',
-        })
-      }
-
-      const matchedShop = resolveKuaishouEticketShopConfig(
-        {
-          shopId,
-          shopName,
-        },
-        kuaishouEticketSource,
-      )
-
-      if (!matchedShop?.shopId || !matchedShop?.kshopName) {
-        throw createHttpError(
-          `第 ${index + 1} 条快手规则的店铺未匹配到已配置的快手官方店铺，请先到“平台配置”补齐 Cookie 后再选择`,
-          {
-            statusCode: 400,
-            errorCode: 'admin_fulfillment_bindings_kuaishou_shop_not_configured',
-          },
-        )
-      }
-
-      shopId = String(matchedShop.shopId || '').trim()
-      shopName = String(matchedShop.kshopName || '').trim()
-      config.kuaishouShop = {
-        ...(isPlainObject(config.kuaishouShop) ? config.kuaishouShop : {}),
-        shopId,
-        shopName,
-        khhaoShopId,
-      }
-    }
-
-    if (!skuCode) {
-      throw createHttpError(`第 ${index + 1} 条规则缺少内部履约 SKU`, {
-        statusCode: 400,
-        errorCode: 'admin_fulfillment_bindings_missing_sku_code',
-      })
-    }
-
-    if (!externalItemId && !externalSkuCode && !externalSkuName) {
-      throw createHttpError(`第 ${index + 1} 条规则至少需要一种外部匹配条件`, {
-        statusCode: 400,
-        errorCode: 'admin_fulfillment_bindings_missing_match_condition',
-      })
-    }
-
-    const profile = await getFulfillmentProfileByKey(profileKey)
+    const profile = await getFulfillmentProfileByKey(normalized.profileKey)
     if (!profile) {
-      throw createHttpError(`第 ${index + 1} 条规则使用了不存在的履约方式: ${profileKey}`, {
+      throw createHttpError(`第 ${index + 1} 条规则使用了不存在的履约方式: ${normalized.profileKey}`, {
         statusCode: 400,
         errorCode: 'admin_fulfillment_bindings_invalid_profile_key',
       })
     }
 
-    const uniqueKey = [
-      provider,
-      platform,
-      resolveFulfillmentBindingMatchShopId({
-        provider,
-        platform,
-        shopId,
-        khhaoShopId,
-      }),
-      externalItemId,
-      externalSkuCode,
-      normalizeProductName(externalSkuName),
-      skuCode,
-    ].join('::')
+    const uniqueKey = buildAdminFulfillmentBindingUniqueKey(normalized)
 
     if (seenKeys.has(uniqueKey)) {
       throw createHttpError(`第 ${index + 1} 条规则与其它规则重复，请调整匹配条件或内部履约 SKU`, {
@@ -959,26 +879,7 @@ async function validateAdminFulfillmentBindingConfigs(bindings = []) {
     }
 
     seenKeys.add(uniqueKey)
-
-    normalizedBindings.push({
-      provider,
-      platform,
-      shopId,
-      shopName,
-      khhaoShopId,
-      skuCode,
-      skuName,
-      profileKey,
-      enabled: rawBinding.enabled !== false,
-      priority: rawBinding.priority,
-      config,
-      match: {
-        externalSkuCode,
-        externalItemId,
-        externalSkuName,
-        config: isPlainObject(match.config) ? match.config : {},
-      },
-    })
+    normalizedBindings.push(normalized)
   }
 
   return normalizedBindings