feat(finance): 内部 SKU 平台字段映射基础

- 新增 internal_sku_mappings，支持 provider/shop 级和全局映射 - 新增解析与 upsert 服务，priority/精确范围优先 - 新增纯数字内部 SKU 的中文映射回填脚本（默认 dry-run）
2026-11-02 13:49:31 +08:00
parent 652d501c2c
commit a501f9f2e0
3 changed files with 229 additions and 0 deletions
@@ -0,0 +1,84 @@
+/**
+ * 从 PDD 纯数字内部 SKU 的订单项回填中文映射（只读扫描 + 幂等写入）。
+ *
+ * 只处理 sku_name 含中文、sku_code 为纯数字的情况；
+ * 找不到中文名的纯数字码会列出来，等运营补映射。
+ *
+ * 用法：npx tsx scripts/backfill-internal-sku-mappings.ts [--apply]
+ */
+import { closeDb, query } from '../src/db/client.js'
+import { upsertInternalSkuMapping } from '../src/services/fulfillment/internal-sku-mapping-service.js'
+
+async function main() {
+  const apply = process.argv.includes('--apply')
+  const rows = await query<{
+    provider: string
+    shop_id: string
+    sku_code: string
+    sku_name: string
+    total: number
+  }>(
+    `
+      SELECT o.provider, o.shop_id, oi.sku_code, MIN(oi.sku_name) AS sku_name, count(*)::int AS total
+      FROM order_items oi
+      JOIN orders o ON o.id = oi.order_id
+      WHERE btrim(COALESCE(oi.manual_sku_key, '')) ~ '^[0-9]+$'
+        AND btrim(COALESCE(oi.sku_name, '')) ~ '[一-龥]'
+      GROUP BY 1, 2, 3
+      ORDER BY 5 DESC
+    `,
+  )
+  const unresolved = await query<{
+    provider: string
+    shop_id: string
+    sku_code: string
+    total: number
+  }>(
+    `
+      SELECT o.provider, o.shop_id, oi.sku_code, count(*)::int AS total
+      FROM order_items oi
+      JOIN orders o ON o.id = oi.order_id
+      WHERE btrim(COALESCE(oi.manual_sku_key, '')) ~ '^[0-9]+$'
+        AND btrim(COALESCE(oi.sku_name, '')) !~ '[一-龥]'
+      GROUP BY 1, 2, 3
+      ORDER BY 4 DESC
+    `,
+  )
+
+  let written = 0
+  for (const row of rows.rows) {
+    if (apply) {
+      await upsertInternalSkuMapping({
+        provider: row.provider,
+        shopId: row.shop_id,
+        matchType: 'sku_code',
+        matchValue: row.sku_code,
+        internalSku: row.sku_name,
+        priority: 100,
+        source: 'backfill',
+        note: `从 ${row.total} 条订单项回填`,
+      })
+    }
+    written += 1
+  }
+
+  console.log(
+    JSON.stringify(
+      {
+        apply,
+        canBackfill: rows.rows.length,
+        backfilled: written,
+        unresolved: unresolved.rows,
+      },
+      null,
+      2,
+    ),
+  )
+}
+
+main()
+  .catch((error) => {
+    console.error(error)
+    process.exitCode = 1
+  })
+  .finally(() => closeDb())