完善半自动真实履约链路及虎牙账号资料保存

This commit is contained in:
yml
2026-11-14 09:23:37 +08:00
parent 3ea5dd5ce4
commit 81a7721ee1
13 changed files with 662 additions and 31 deletions
@@ -18,6 +18,7 @@ import { assertValidClaimUid, normalizeClaimUid } from '../claim/claim-identity.
import { saveManualFulfillmentConfig } from '../cost-center/manual-fulfillment-config-service.js'
import {
assignFulfillmentChannelsWithExecutor,
attachFulfillmentConfigurations,
attachFulfillmentConfigurationsWithExecutor,
} from '../fulfillment/fulfillment-state-service.js'
import { containsCjk } from '../fulfillment/internal-sku-resolver.js'
@@ -31,12 +32,16 @@ import { nowIso } from '../../utils/time.js'
import { randomId } from '../../utils/random.js'
import { TASK_STATUS } from '../../domain/task-status.js'
import { ensureSemiAutoTasksForOrder } from '../semi-auto/semi-auto-task-service.js'
import { ensureSemiAutoTasksForOrderItems } from '../semi-auto/semi-auto-task-service.js'
import {
defaultSemiAutoConnectorMode,
isExternalSemiAutoConnectorConfigured,
type SemiAutoConnectorMode,
} from '../semi-auto/huya-connector-client.js'
import { assertDevMockEnabled, isDevMockEnabled } from './dev-mock-enabled.js'
import { upsertInternalSkuMapping } from '../fulfillment/internal-sku-mapping-service.js'
import { assignPendingOrderItemChannels } from '../fulfillment/channel-assign-service.js'
import { upsertOrderFromSource } from '../order/order-service.js'
export { assertDevMockEnabled, isDevMockEnabled }
@@ -83,6 +88,11 @@ export type DevMockSemiAutoResult = {
tips: string[]
}
export type DevSemiAutoIntegrationResult = DevMockSemiAutoResult & {
pipeline: 'order_service'
mappingId: number
}
export function getDevMockStatus() {
const enabled = isDevMockEnabled()
return {
@@ -521,6 +531,269 @@ export async function createSemiAutoMock(
}
}
/**
* 真实履约链路集成测试单。
*
* 订单必须通过正式 upsertOrderFromSource 入库,再走 SKU 映射、渠道判定和
* Carrier 补偿;不直接写 order/order_item/fulfillment。
*/
export async function createSemiAutoIntegrationMock(
input: {
platform?: unknown
orderNo?: unknown
skuName?: unknown
quantity?: unknown
pageTitle?: unknown
browserTargetUrl?: unknown
connectorMode?: unknown
} = {},
): Promise<DevSemiAutoIntegrationResult> {
assertDevMockEnabled()
const platform = normalizeMockSemiAutoPlatform(input.platform)
const suffix = `${Date.now()}_${Math.floor(Math.random() * 1_000_000)}`
const orderNo = String(
input.orderNo || `${platform === 'weibo' ? 'INTWB' : 'INTSA'}${suffix}`,
).trim()
const skuKey = normalizeMockSemiAutoSku(
input.skuName || `${platform === 'weibo' ? '微博' : '虎牙'}真实链路测试-${suffix}`,
platform,
)
const quantity = normalizeMockSemiAutoQuantity(input.quantity)
const connectorMode =
platform === 'weibo' ? 'embedded' : normalizeMockSemiAutoConnectorMode(input.connectorMode)
const provider = 'dev_integration'
const sourcePlatform = 'internal_test'
const shopId = 'dev-integration-shop'
const externalSkuCode = `INTEGRATION-${suffix}`
const pageTitle = String(
input.pageTitle || (platform === 'weibo' ? '微博账号登录授权' : '虎牙账号登录授权'),
)
.trim()
.slice(0, 60)
const browserTargetUrl = String(
input.browserTargetUrl ||
(platform === 'weibo' ? 'https://weibo.com/' : 'https://www.huya.com/'),
)
.trim()
.slice(0, 1000)
const existing = await findOrderByPlatformOrderId({
provider,
platform: sourcePlatform,
shopId,
platformOrderId: orderNo,
})
if (existing) {
throw createHttpError(`订单号已存在:${orderNo},请换一个或留空自动生成`, {
statusCode: 409,
errorCode: 'dev_integration_order_exists',
})
}
const config = await saveManualFulfillmentConfig({
skuKey,
enabled: true,
note: '开发集成测试:真实订单履约链路',
channels: [{ platformKey: 'fund_cash', creditQuantity: 100, enabled: true }],
semiAutoEnabled: true,
semiAutoPlatform: platform,
semiAutoConfig: {
pageTitle,
pageDescription: '真实入库链路测试订单:登录与 CK 获取使用当前 Connector。',
loginInstructions: '请使用本人账号完成登录授权,客服后续人工处理。',
loginMethods: ['sms', 'qr'],
browserTargets: [
{
key: platform,
label: platform === 'weibo' ? '微博' : '虎牙',
url: browserTargetUrl,
},
],
},
})
const configId = Number(config.id || 0)
if (!configId) {
throw createHttpError('创建真实链路人工配置失败', {
statusCode: 500,
errorCode: 'dev_integration_manual_config_failed',
})
}
const mappingId = await upsertInternalSkuMapping({
provider,
shopId,
matchType: 'sku_code',
matchValue: externalSkuCode,
internalSku: skuKey,
priority: 1000,
source: 'dev_integration',
note: `订单 ${orderNo}`,
})
const now = nowIso()
const upserted = await upsertOrderFromSource(
{
provider,
platform: sourcePlatform,
shopId,
shopName: '半自动真实链路测试店',
platformOrderId: orderNo,
orderStatus: 'paid',
payStatus: 'paid',
buyerId: `integration-buyer-${suffix}`,
buyerName: '集成测试客户',
receiverContact: '',
totalAmount: 100 * quantity,
currency: 'CNY',
rawPayload: {
source: 'dev_integration',
orderNo,
skuKey,
platform,
createdAt: now,
},
paidAt: now,
items: [
{
quantity,
skuCode: externalSkuCode,
skuName: skuKey,
spec: {},
snapshot: {
source: 'dev_integration',
semiAuto: { platform },
},
},
],
},
{ sourceLabel: 'dev_semi_auto_integration' },
)
if (upserted.ignored || !upserted.order) {
throw createHttpError(upserted.ignoreReason || '真实链路订单入库失败', {
statusCode: 500,
errorCode: 'dev_integration_order_failed',
})
}
const orderItemId = Number(upserted.orderItems[0]?.id || 0)
if (!orderItemId) {
throw createHttpError('真实链路订单项创建失败', {
statusCode: 500,
errorCode: 'dev_integration_order_item_failed',
})
}
await assignPendingOrderItemChannels({
orderItemIds: [orderItemId],
afterId: 0,
batchSize: 10,
maxBatches: 1,
})
const manualConfig = await query<{
config_id: number
canonical_product_id: number | null
}>(
`
SELECT cfg.id AS config_id, cfg.canonical_product_id
FROM v_order_item_current oi
JOIN manual_fulfillment_configs cfg
ON canonicalize_internal_sku(cfg.sku_key) = resolve_internal_sku(
oi.manual_sku_key, oi.sku_name, oi.sku_code
)
AND cfg.enabled = TRUE
WHERE oi.id = $1
AND oi.fulfillment_status = 'assigned'
AND oi.fulfillment_channel = 'manual'
LIMIT 1
`,
[orderItemId],
)
const manualConfigRow = manualConfig.rows[0]
if (!manualConfigRow) {
throw createHttpError('真实链路未匹配到已启用的 manual 配置', {
statusCode: 500,
errorCode: 'dev_integration_manual_config_missing',
})
}
await attachFulfillmentConfigurations({
mappings: [
{
orderItemId,
configId: Number(manualConfigRow.config_id),
...(manualConfigRow.canonical_product_id
? { canonicalProductId: Number(manualConfigRow.canonical_product_id) }
: {}),
},
],
expected: { status: 'assigned', channel: 'manual' },
onlyWhenConfigNull: true,
})
await ensureSemiAutoTasksForOrderItems([orderItemId])
const resolved = await query<{
fulfillment_id: number
fulfillment_channel: string
fulfillment_status: string
task_id: number
}>(
`
SELECT
f.id AS fulfillment_id,
f.channel AS fulfillment_channel,
f.status AS fulfillment_status,
task.id AS task_id
FROM fulfillments f
LEFT JOIN semi_auto_tasks task ON task.order_item_id = f.order_item_id
WHERE f.order_item_id = $1
LIMIT 1
`,
[orderItemId],
)
const row = resolved.rows[0]
if (
!row ||
row.fulfillment_channel !== 'manual' ||
row.fulfillment_status !== 'assigned' ||
!Number(row.task_id)
) {
throw createHttpError(
`真实链路未生成半自动任务:channel=${row?.fulfillment_channel || ''}, status=${row?.fulfillment_status || ''}, task=${row?.task_id || 0}`,
{ statusCode: 500, errorCode: 'dev_integration_semi_auto_task_failed' },
)
}
await query('UPDATE semi_auto_tasks SET connector_mode = $2, updated_at = NOW() WHERE id = $1', [
Number(row.task_id),
connectorMode,
])
const connectorConfigured =
connectorMode === 'external' ? isExternalSemiAutoConnectorConfigured() : true
return {
platform: 'semi_auto',
semiAutoPlatform: platform,
pipeline: 'order_service',
orderId: Number(upserted.order.id),
orderNo,
orderItemId,
fulfillmentId: Number(row.fulfillment_id),
configId,
taskId: Number(row.task_id),
skuKey,
connectorMode,
connectorConfigured,
mappingId,
customerPath: `/c/${encodeURIComponent(orderNo)}`,
adminPath: `/admin/semi-auto-tasks?keyword=${encodeURIComponent(orderNo)}`,
tips: [
'订单通过正式 upsertOrderFromSource 入库。',
'SKU 通过 internal_sku_mappings 解析,并按 sku_channel_routes 判定到 manual。',
'Carrier 补偿后生成正式 fulfillment 和 semi_auto_task。',
connectorConfigured
? '登录与 CK 获取使用当前 Connector。'
: '远程 Connector 未配置,请在后台任务中选择可用连接模式。',
],
}
}
function normalizeMockSemiAutoPlatform(value: unknown): 'huya' | 'weibo' {
return String(value || '')
.trim()