彻底重构-4

This commit is contained in:
yml
2026-04-09 15:51:24 +08:00
parent 60054adcc4
commit 4c395103a9
28 changed files with 1917 additions and 404 deletions
-1
View File
@@ -590,7 +590,6 @@
"resolved": "https://registry.npmjs.org/pg/-/pg-8.20.0.tgz",
"integrity": "sha512-ldhMxz2r8fl/6QkXnBD3CR9/xg694oT6DZQ2s6c/RI28OjtSOpxnPrUCGOBJ46RCUxcWdx3p6kw/xnDHjKvaRA==",
"license": "MIT",
"peer": true,
"dependencies": {
"pg-connection-string": "^2.12.0",
"pg-pool": "^3.13.0",
+1
View File
@@ -7,6 +7,7 @@
"browser:install": "playwright install chromium",
"browser:install:linux": "playwright install --with-deps chromium",
"cleanup:dev-data": "node scripts/cleanup-dev-data.js",
"seed:dev-data": "node scripts/seed-dev-data.js",
"db:migrate": "node src/db/migrate.js",
"dev": "node --watch-path=src --watch-path=config --watch-preserve-output src/index.js",
"start": "node src/index.js"
+512
View File
@@ -0,0 +1,512 @@
#!/usr/bin/env node
import process from 'node:process'
import { runtimeConfig } from '../src/config/runtime.js'
import { closeDb, query } from '../src/db/client.js'
import { runDatabaseMigrations } from '../src/db/migrate.js'
import { updateClaimToken } from '../src/repositories/claim-token-repo.js'
import { getFulfillmentProfileByKey, upsertSkuFulfillmentBinding } from '../src/repositories/fulfillment-profile-repo.js'
import { createInventoryItems, releaseReservedInventoryItem } from '../src/repositories/inventory-repo.js'
import { getTaskById, updateTask } from '../src/repositories/task-repo.js'
import { ensureFulfillmentCatalogBootstrapped } from '../src/services/bootstrap/fulfillment-bootstrap-service.js'
import { completeAdminTaskManualDispatch } from '../src/services/admin/admin-service.js'
import { upsertOrderFromWebhook } from '../src/services/order/order-service.js'
import { addHours, nowIso } from '../src/utils/time.js'
const RESET_TABLES = [
'message_deliveries',
'tencent_browser_contexts',
'task_events',
'claim_tokens',
'task_inventory_bindings',
'fulfillment_tasks',
'order_items',
'orders',
'webhook_events',
'inventory_items',
]
const SEED_PROVIDER = 'seed'
const SEED_PLATFORM = 'sandbox'
const SEED_SHOP_ID = 'seed-shop'
const SEED_SHOP_NAME = 'Seed Sandbox Shop'
const options = parseArgs(process.argv.slice(2))
if (options.help) {
printHelp()
process.exit(0)
}
try {
printPreview()
if (!options.apply) {
console.log('\n当前为预览模式。确认后追加 `--apply`,需要清库时再加 `--reset`。')
process.exit(0)
}
await runDatabaseMigrations()
await ensureFulfillmentCatalogBootstrapped()
if (options.reset) {
await query(`TRUNCATE TABLE ${RESET_TABLES.join(', ')} RESTART IDENTITY CASCADE`)
console.log('\n已先清空测试业务数据。')
}
await ensureSeedBindings()
await createSeedInventory()
const manualPending = await seedScenario({
scenarioKey: 'manual_pending',
orderLabel: 'SEED-MANUAL-PENDING',
skuCode: 'seed-manual-pending',
skuName: '开发种子-人工履约待处理',
})
const manualCompleted = await seedScenario({
scenarioKey: 'manual_completed',
orderLabel: 'SEED-MANUAL-COMPLETED',
skuCode: 'seed-manual-completed',
skuName: '开发种子-人工履约已完成',
afterCreate: async (result) => {
const task = result.tasks[0]
if (!task) {
return null
}
await completeAdminTaskManualDispatch(task.id, {
outcome: 'delivered',
resultMessage: '开发种子数据:人工履约已完成',
deliveryReference: 'SEED-MANUAL-REF-001',
deliveredCredential: '开发种子数据:已通过人工渠道发放',
})
return getTaskById(task.id)
},
})
const claimReady = await seedScenario({
scenarioKey: 'claim_ready',
orderLabel: 'SEED-CLAIM-READY',
skuCode: 'seed-claim-ready',
skuName: '开发种子-领取兑换可用',
})
const claimClaimed = await seedScenario({
scenarioKey: 'claim_claimed',
orderLabel: 'SEED-CLAIM-CLAIMED',
skuCode: 'seed-claim-claimed',
skuName: '开发种子-已打开领取链接',
afterCreate: async (result) => applyClaimedState(result.tasks[0]),
})
const claimRoleConfirmed = await seedScenario({
scenarioKey: 'claim_role_confirmed',
orderLabel: 'SEED-CLAIM-ROLE',
skuCode: 'seed-claim-role-confirmed',
skuName: '开发种子-已确认角色',
afterCreate: async (result) => applyRoleConfirmedState(result.tasks[0]),
})
const claimRetryPending = await seedScenario({
scenarioKey: 'claim_retry_pending',
orderLabel: 'SEED-CLAIM-RETRY',
skuCode: 'seed-claim-retry',
skuName: '开发种子-等待重试',
afterCreate: async (result) => applyRetryPendingState(result.tasks[0]),
})
const claimExpired = await seedScenario({
scenarioKey: 'claim_expired',
orderLabel: 'SEED-CLAIM-EXPIRED',
skuCode: 'seed-claim-expired',
skuName: '开发种子-领取链接已过期',
afterCreate: async (result) => applyExpiredState(result.tasks[0]),
})
const claimWaitingInventory = await seedScenario({
scenarioKey: 'claim_waiting_inventory',
orderLabel: 'SEED-CLAIM-WAIT',
skuCode: 'seed-claim-wait',
skuName: '开发种子-等待库存',
})
printResultSummary([
manualPending,
manualCompleted,
claimReady,
claimClaimed,
claimRoleConfirmed,
claimRetryPending,
claimExpired,
claimWaitingInventory,
])
} catch (error) {
console.error('\n写入开发种子数据失败:', error instanceof Error ? error.message : String(error || '未知错误'))
process.exitCode = 1
} finally {
await closeDb()
}
async function ensureSeedBindings() {
const timestamp = nowIso()
const manualProfile = await getRequiredProfile('manual_review')
const claimProfile = await getRequiredProfile('tencent_claim_redeem')
const bindings = [
{ skuCode: 'seed-manual-pending', profileId: manualProfile.id, priority: 10 },
{ skuCode: 'seed-manual-completed', profileId: manualProfile.id, priority: 20 },
{ skuCode: 'seed-claim-ready', profileId: claimProfile.id, priority: 30 },
{ skuCode: 'seed-claim-claimed', profileId: claimProfile.id, priority: 40 },
{ skuCode: 'seed-claim-role-confirmed', profileId: claimProfile.id, priority: 50 },
{ skuCode: 'seed-claim-retry', profileId: claimProfile.id, priority: 60 },
{ skuCode: 'seed-claim-expired', profileId: claimProfile.id, priority: 70 },
{ skuCode: 'seed-claim-wait', profileId: claimProfile.id, priority: 80 },
]
for (const binding of bindings) {
await upsertSkuFulfillmentBinding({
skuCode: binding.skuCode,
provider: SEED_PROVIDER,
platform: SEED_PLATFORM,
shopId: SEED_SHOP_ID,
profileId: binding.profileId,
enabled: true,
priority: binding.priority,
configJson: JSON.stringify({
seededBy: 'scripts/seed-dev-data.js',
scenario: binding.skuCode,
}),
createdAt: timestamp,
updatedAt: timestamp,
})
}
}
async function createSeedInventory() {
const timestamp = nowIso()
await createInventoryItems([
{
skuCode: 'seed-claim-ready',
displayValue: 'SEED-CLAIM-CODE-READY-001',
batchNo: 'seed-20260409',
credentialType: 'tencent_code',
payload: {
code: 'SEED-CLAIM-CODE-READY-001',
scenario: 'claim_ready',
},
createdAt: timestamp,
updatedAt: timestamp,
},
{
skuCode: 'seed-claim-claimed',
displayValue: 'SEED-CLAIM-CODE-CLAIMED-001',
batchNo: 'seed-20260409',
credentialType: 'tencent_code',
payload: {
code: 'SEED-CLAIM-CODE-CLAIMED-001',
scenario: 'claim_claimed',
},
createdAt: timestamp,
updatedAt: timestamp,
},
{
skuCode: 'seed-claim-role-confirmed',
displayValue: 'SEED-CLAIM-CODE-ROLE-001',
batchNo: 'seed-20260409',
credentialType: 'tencent_code',
payload: {
code: 'SEED-CLAIM-CODE-ROLE-001',
scenario: 'claim_role_confirmed',
},
createdAt: timestamp,
updatedAt: timestamp,
},
{
skuCode: 'seed-claim-retry',
displayValue: 'SEED-CLAIM-CODE-RETRY-001',
batchNo: 'seed-20260409',
credentialType: 'tencent_code',
payload: {
code: 'SEED-CLAIM-CODE-RETRY-001',
scenario: 'claim_retry_pending',
},
createdAt: timestamp,
updatedAt: timestamp,
},
{
skuCode: 'seed-claim-expired',
displayValue: 'SEED-CLAIM-CODE-EXPIRED-001',
batchNo: 'seed-20260409',
credentialType: 'tencent_code',
payload: {
code: 'SEED-CLAIM-CODE-EXPIRED-001',
scenario: 'claim_expired',
},
createdAt: timestamp,
updatedAt: timestamp,
},
{
skuCode: 'seed-spare-available',
displayValue: 'SEED-SPARE-CODE-001',
batchNo: 'seed-20260409',
credentialType: 'tencent_code',
payload: {
code: 'SEED-SPARE-CODE-001',
scenario: 'spare_available',
},
createdAt: timestamp,
updatedAt: timestamp,
},
])
}
async function seedScenario({ scenarioKey, orderLabel, skuCode, skuName, afterCreate = null }) {
const result = await upsertOrderFromWebhook(buildSeedOrderEvent({
scenarioKey,
orderLabel,
skuCode,
skuName,
}))
const task = typeof afterCreate === 'function'
? await afterCreate(result)
: result.tasks[0] || null
return {
scenarioKey,
orderId: result.order.id,
platformOrderId: result.order.platform_order_id,
taskId: task?.id || null,
taskNo: task?.task_no || '',
taskStatus: task?.task_status || '',
deliveryStatus: task?.delivery_status || '',
inventoryStatus: task?.inventory_status || '',
inventoryItemId: Number(task?.primary_inventory_item_id || 0) || null,
claimTokenId: Number(task?.primary_claim_token_id || 0) || null,
executorKey: String(task?.executor_key || '').trim(),
}
}
async function applyClaimedState(task) {
if (!task) {
return null
}
const now = nowIso()
await updateTask(task.id, {
task_status: 'claimed',
user_action_status: 'claimed',
browser_session_id: `seed-browser-${task.id}`,
login_type: 'qq',
claimed_at: now,
updated_at: now,
last_error: '',
})
return getTaskById(task.id)
}
async function applyRoleConfirmedState(task) {
if (!task) {
return null
}
const claimedAt = addHours(nowIso(), -1)
const roleConfirmedAt = nowIso()
await updateTask(task.id, {
task_status: 'role_confirmed',
user_action_status: 'role_confirmed',
browser_session_id: `seed-browser-${task.id}`,
login_type: 'qq',
nickname: 'SeedHero',
role_id: 'seed-role-1001',
role_name: '开发角色-已确认',
area: 'seed-area',
partition_name: 'seed-partition',
claimed_at: claimedAt,
role_confirmed_at: roleConfirmedAt,
updated_at: roleConfirmedAt,
last_error: '',
})
return getTaskById(task.id)
}
async function applyRetryPendingState(task) {
if (!task) {
return null
}
const claimedAt = addHours(nowIso(), -2)
const roleConfirmedAt = addHours(nowIso(), -1)
const updatedAt = nowIso()
await updateTask(task.id, {
task_status: 'retry_pending',
delivery_status: 'pending',
inventory_status: 'reserved',
user_action_status: 'role_confirmed',
browser_session_id: `seed-browser-${task.id}`,
login_type: 'qq',
nickname: 'SeedRetryUser',
role_id: 'seed-role-retry',
role_name: '开发角色-待重试',
area: 'seed-area',
partition_name: 'seed-partition',
claimed_at: claimedAt,
role_confirmed_at: roleConfirmedAt,
attempt_count: 2,
last_error: '开发种子数据:模拟兑换失败,等待重试',
updated_at: updatedAt,
})
return getTaskById(task.id)
}
async function applyExpiredState(task) {
if (!task) {
return null
}
const now = nowIso()
if (task.primary_claim_token_id) {
await updateClaimToken(task.primary_claim_token_id, {
status: 'expired',
expired_at: addHours(now, -2),
updated_at: now,
})
}
if (task.primary_inventory_item_id) {
await releaseReservedInventoryItem(task.primary_inventory_item_id, now)
}
await updateTask(task.id, {
task_status: 'expired',
inventory_status: 'pending',
user_action_status: 'expired',
last_error: '领取链接已过期,预占库存项已释放',
updated_at: now,
})
return getTaskById(task.id)
}
function buildSeedOrderEvent({ scenarioKey, orderLabel, skuCode, skuName }) {
const timestamp = nowIso()
return {
provider: SEED_PROVIDER,
platform: SEED_PLATFORM,
shopId: SEED_SHOP_ID,
shopName: SEED_SHOP_NAME,
platformOrderId: orderLabel,
orderStatus: 'paid',
payStatus: 'paid',
buyerId: `${scenarioKey}-buyer`,
buyerName: `开发种子-${scenarioKey}`,
receiverContact: `seed+${scenarioKey}@example.com`,
totalAmount: 100,
currency: 'CNY',
paidAt: timestamp,
rawPayload: {
source: 'seed-dev-data',
scenarioKey,
platformOrderId: orderLabel,
},
items: [
{
skuCode,
skuName,
quantity: 1,
spec: {
title: skuName,
scenarioKey,
},
snapshot: {
title: skuName,
scenarioKey,
seeded: true,
},
},
],
}
}
async function getRequiredProfile(profileKey) {
const profile = await getFulfillmentProfileByKey(profileKey)
if (!profile) {
throw new Error(`缺少履约档案: ${profileKey}`)
}
return profile
}
function parseArgs(argv) {
return {
apply: argv.includes('--apply'),
reset: argv.includes('--reset'),
help: argv.includes('-h') || argv.includes('--help'),
}
}
function printHelp() {
console.log(`
用法:
node scripts/seed-dev-data.js [--apply] [--reset]
说明:
基于当前 PostgreSQL fulfillment schema 生成一组可重复验证的开发种子数据。
场景:
- manual_pending: 人工履约待处理
- manual_completed: 人工履约已完成
- claim_ready: 已预占库存并生成领取链接
- claim_claimed: 用户已打开领取链接
- claim_role_confirmed: 用户已确认角色
- claim_retry_pending: 自动履约失败等待重试
- claim_expired: 领取链接已过期
- claim_waiting_inventory: 等待库存
参数:
--apply 实际写入数据
--reset 写入前先清空测试业务数据
数据库连接:
${String(runtimeConfig.database?.url || '').trim() || '(未配置 DATABASE_URL)'}
`.trim())
}
function printPreview() {
console.log('准备生成开发种子数据:')
console.log('- manual_pending -> 人工履约待处理')
console.log('- manual_completed -> 人工履约已完成')
console.log('- claim_ready -> 领取兑换已就绪')
console.log('- claim_claimed -> 用户已打开领取链接')
console.log('- claim_role_confirmed -> 用户已确认角色')
console.log('- claim_retry_pending -> 自动履约失败等待重试')
console.log('- claim_expired -> 领取链接已过期')
console.log('- claim_waiting_inventory -> 等待库存')
console.log(`- database: ${String(runtimeConfig.database?.url || '').trim() || '(未配置 DATABASE_URL)'}`)
}
function printResultSummary(rows) {
console.log('\n开发种子数据已写入:')
for (const row of rows) {
console.log(`- ${row.scenarioKey}`)
console.log(` orderId=${row.orderId} platformOrderId=${row.platformOrderId}`)
console.log(` taskId=${row.taskId || '-'} taskNo=${row.taskNo || '-'} executor=${row.executorKey || '-'}`)
console.log(` taskStatus=${row.taskStatus || '-'} deliveryStatus=${row.deliveryStatus || '-'} inventoryStatus=${row.inventoryStatus || '-'}`)
console.log(` inventoryItemId=${row.inventoryItemId || '-'} claimTokenId=${row.claimTokenId || '-'}`)
}
console.log('\n建议验证入口:')
console.log('- `/api/v1/admin/orders?platformOrderId=SEED-`')
console.log('- `/api/v1/admin/tasks?taskNo=DT`')
console.log('- `/api/v1/admin/inventory`')
}
+1 -1
View File
@@ -16,7 +16,7 @@ import tencentRouter from './routes/tencent.js'
const app = express()
const port = Number(runtimeConfig.server.port || 3000)
runDatabaseMigrations()
await runDatabaseMigrations()
await ensureFulfillmentCatalogBootstrapped()
await ensureAdminUsersBootstrapped()
@@ -1,12 +1,11 @@
import { query, withTransaction } from '../db/client.js'
const CDK_SELECT = `
const INVENTORY_ITEM_SELECT = `
SELECT
ii.id,
ii.sku_code,
ii.batch_no,
ii.credential_type,
ii.display_value AS cdk_code,
ii.display_value,
ii.status,
ii.invalid_reason,
@@ -27,9 +26,9 @@ const CDK_SELECT = `
LEFT JOIN fulfillment_tasks ft ON ft.id = tib.task_id
`
export async function findFirstAvailableCdkBySkuCode(skuCode, credentialType = 'tencent_code') {
export async function findFirstAvailableInventoryItemBySkuCode(skuCode, credentialType = 'tencent_code') {
const result = await query(
`${CDK_SELECT}
`${INVENTORY_ITEM_SELECT}
WHERE ii.sku_code = $1 AND ii.credential_type = $2 AND ii.status = 'available'
ORDER BY ii.id ASC
LIMIT 1`,
@@ -39,7 +38,7 @@ export async function findFirstAvailableCdkBySkuCode(skuCode, credentialType = '
return result.rows[0] || null
}
export async function assignReservedCdk(cdkId, taskId, updatedAt, roleKey = 'primary_code') {
export async function assignReservedInventoryItem(inventoryItemId, taskId, updatedAt, roleKey = 'primary_code') {
return withTransaction(async (client) => {
const inventoryResult = await client.query(
`
@@ -48,11 +47,11 @@ export async function assignReservedCdk(cdkId, taskId, updatedAt, roleKey = 'pri
WHERE id = $2 AND status = 'available'
RETURNING id
`,
[updatedAt, Number(cdkId)],
[updatedAt, Number(inventoryItemId)],
)
if (!inventoryResult.rows[0]) {
return getCdkById(cdkId)
return getInventoryItemById(inventoryItemId)
}
await client.query(
@@ -70,25 +69,25 @@ export async function assignReservedCdk(cdkId, taskId, updatedAt, roleKey = 'pri
ON CONFLICT (task_id, role_key, inventory_item_id) DO UPDATE
SET binding_status = 'reserved', updated_at = EXCLUDED.updated_at, released_at = NULL
`,
[Number(taskId), Number(cdkId), roleKey, updatedAt],
[Number(taskId), Number(inventoryItemId), roleKey, updatedAt],
)
return getCdkById(cdkId)
return getInventoryItemById(inventoryItemId)
})
}
export async function getCdkById(cdkId) {
export async function getInventoryItemById(inventoryItemId) {
const result = await query(
`${CDK_SELECT}
`${INVENTORY_ITEM_SELECT}
WHERE ii.id = $1
LIMIT 1`,
[Number(cdkId)],
[Number(inventoryItemId)],
)
return result.rows[0] || null
}
export async function markCdkDelivered(cdkId, deliveredAt) {
export async function markInventoryItemDelivered(inventoryItemId, deliveredAt) {
return withTransaction(async (client) => {
await client.query(
`
@@ -96,7 +95,7 @@ export async function markCdkDelivered(cdkId, deliveredAt) {
SET status = 'consumed', consumed_at = $1, updated_at = $1
WHERE id = $2
`,
[deliveredAt, Number(cdkId)],
[deliveredAt, Number(inventoryItemId)],
)
await client.query(
@@ -105,14 +104,14 @@ export async function markCdkDelivered(cdkId, deliveredAt) {
SET binding_status = 'consumed', consumed_at = $1, updated_at = $1
WHERE inventory_item_id = $2 AND binding_status = 'reserved'
`,
[deliveredAt, Number(cdkId)],
[deliveredAt, Number(inventoryItemId)],
)
return getCdkById(cdkId)
return getInventoryItemById(inventoryItemId)
})
}
export async function listCdks({
export async function listInventoryItems({
page = 1,
pageSize = 20,
skuCode = '',
@@ -147,7 +146,7 @@ export async function listCdks({
params.push(pageSize)
params.push(offset)
const itemsResult = await query(
`${CDK_SELECT}
`${INVENTORY_ITEM_SELECT}
${whereClause}
ORDER BY ii.id DESC
LIMIT $${params.length - 1} OFFSET $${params.length}`,
@@ -160,12 +159,12 @@ export async function listCdks({
}
}
export async function createCdks(rows) {
export async function createInventoryItems(rows) {
let created = 0
for (const row of rows) {
const payloadJson = JSON.stringify(row.payload || { code: row.cdkCode })
const displayValue = String(row.cdkCode || row.displayValue || '').trim()
const payloadJson = JSON.stringify(row.payload || { code: row.displayValue })
const displayValue = String(row.displayValue || '').trim()
const result = await query(
`
INSERT INTO inventory_items (
@@ -203,7 +202,7 @@ export async function createCdks(rows) {
return created
}
export async function releaseReservedCdk(cdkId, updatedAt) {
export async function releaseReservedInventoryItem(inventoryItemId, updatedAt) {
return withTransaction(async (client) => {
await client.query(
`
@@ -211,7 +210,7 @@ export async function releaseReservedCdk(cdkId, updatedAt) {
SET binding_status = 'released', released_at = $1, updated_at = $1
WHERE inventory_item_id = $2 AND binding_status = 'reserved'
`,
[updatedAt, Number(cdkId)],
[updatedAt, Number(inventoryItemId)],
)
await client.query(
@@ -220,14 +219,14 @@ export async function releaseReservedCdk(cdkId, updatedAt) {
SET status = 'available', updated_at = $1
WHERE id = $2 AND status = 'reserved'
`,
[updatedAt, Number(cdkId)],
[updatedAt, Number(inventoryItemId)],
)
return getCdkById(cdkId)
return getInventoryItemById(inventoryItemId)
})
}
export async function invalidateCdk(cdkId, invalidReason, updatedAt) {
export async function invalidateInventoryItem(inventoryItemId, invalidReason, updatedAt) {
const result = await query(
`
UPDATE inventory_items
@@ -235,12 +234,12 @@ export async function invalidateCdk(cdkId, invalidReason, updatedAt) {
WHERE id = $3 AND status = 'available'
RETURNING id
`,
[invalidReason, updatedAt, Number(cdkId)],
[invalidReason, updatedAt, Number(inventoryItemId)],
)
if (!result.rows[0]) {
return getCdkById(cdkId)
return getInventoryItemById(inventoryItemId)
}
return getCdkById(cdkId)
return getInventoryItemById(inventoryItemId)
}
@@ -0,0 +1,38 @@
import { query } from '../db/client.js'
export async function createTaskEvent(taskId, eventType, payload = {}, createdAt) {
const result = await query(
`
INSERT INTO task_events (
task_id,
event_type,
payload_json,
created_at
) VALUES ($1, $2, $3::jsonb, $4)
RETURNING *
`,
[
Number(taskId),
String(eventType || '').trim(),
JSON.stringify(payload || {}),
createdAt,
],
)
return result.rows[0] || null
}
export async function listTaskEventsByTaskId(taskId, { limit = 20 } = {}) {
const result = await query(
`
SELECT *
FROM task_events
WHERE task_id = $1
ORDER BY created_at DESC, id DESC
LIMIT $2
`,
[Number(taskId), Math.max(1, Number(limit || 20))],
)
return result.rows
}
@@ -0,0 +1,93 @@
import { query } from '../db/client.js'
export async function listTaskInventoryBindingsByTaskId(taskId) {
const result = await query(
`
SELECT
tib.id,
tib.task_id,
tib.inventory_item_id,
tib.role_key,
tib.quantity,
tib.binding_status,
tib.consumed_at,
tib.released_at,
tib.metadata_json,
tib.created_at,
tib.updated_at,
ii.sku_code,
ii.batch_no,
ii.credential_type,
ii.display_value,
ii.status AS inventory_item_status,
ii.invalid_reason
FROM task_inventory_bindings tib
JOIN inventory_items ii ON ii.id = tib.inventory_item_id
WHERE tib.task_id = $1
ORDER BY tib.id ASC
`,
[Number(taskId)],
)
return result.rows
}
export async function getTaskInventoryBindingById(bindingId) {
const result = await query(
`
SELECT
tib.id,
tib.task_id,
tib.inventory_item_id,
tib.role_key,
tib.quantity,
tib.binding_status,
tib.consumed_at,
tib.released_at,
tib.metadata_json,
tib.created_at,
tib.updated_at,
ii.sku_code,
ii.batch_no,
ii.credential_type,
ii.display_value,
ii.status AS inventory_item_status,
ii.invalid_reason
FROM task_inventory_bindings tib
JOIN inventory_items ii ON ii.id = tib.inventory_item_id
WHERE tib.id = $1
LIMIT 1
`,
[Number(bindingId)],
)
return result.rows[0] || null
}
export async function listTaskInventoryBindingSummariesByTaskIds(taskIds = []) {
const normalizedTaskIds = Array.from(new Set((Array.isArray(taskIds) ? taskIds : [])
.map((value) => Number(value))
.filter((value) => Number.isFinite(value) && value > 0)))
if (normalizedTaskIds.length === 0) {
return []
}
const result = await query(
`
SELECT
tib.task_id,
COUNT(*)::int AS total_binding_count,
COUNT(*) FILTER (WHERE tib.binding_status = 'reserved')::int AS reserved_binding_count,
COUNT(*) FILTER (WHERE tib.binding_status = 'consumed')::int AS consumed_binding_count,
COUNT(*) FILTER (WHERE tib.binding_status = 'released')::int AS released_binding_count,
ARRAY_AGG(DISTINCT tib.role_key ORDER BY tib.role_key) AS role_keys
FROM task_inventory_bindings tib
WHERE tib.task_id = ANY($1::bigint[])
GROUP BY tib.task_id
`,
[normalizedTaskIds],
)
return result.rows
}
+13 -9
View File
@@ -129,7 +129,7 @@ export async function createTask(input) {
await upsertTencentBrowserContextWithClient(client, taskId, input.tencentContext, input.createdAt)
}
return getTaskById(taskId)
return getTaskByIdWithExecutor(client.query.bind(client), taskId)
})
}
@@ -202,18 +202,12 @@ export async function updateTask(taskId, patch) {
}, patch.updated_at || current.updated_at)
}
return getTaskById(taskId)
return getTaskByIdWithExecutor(client.query.bind(client), taskId)
})
}
export async function getTaskById(taskId) {
const result = await query(
`${buildTaskSelect()}
WHERE ft.id = $1
LIMIT 1`,
[Number(taskId)],
)
return result.rows[0] || null
return getTaskByIdWithExecutor(query, taskId)
}
export async function findTaskByClaimTokenId(claimTokenId) {
@@ -399,6 +393,16 @@ async function upsertTencentBrowserContextWithClient(client, taskId, patch = {},
)
}
async function getTaskByIdWithExecutor(executor, taskId) {
const result = await executor(
`${buildTaskSelect()}
WHERE ft.id = $1
LIMIT 1`,
[Number(taskId)],
)
return result.rows[0] || null
}
function containsTencentPatch(patch = {}) {
return [
'browser_session_id',
+2 -2
View File
@@ -2,8 +2,8 @@ import { Router } from 'express'
import authRouter from './admin/auth.js'
import auditLogsRouter from './admin/audit-logs.js'
import cdksRouter from './admin/cdks.js'
import dashboardRouter from './admin/dashboard.js'
import inventoryRouter from './admin/inventory.js'
import ordersRouter from './admin/orders.js'
import platformConfigRouter from './admin/platform-config.js'
import { requireAdminSession } from './admin/shared.js'
@@ -22,7 +22,7 @@ router.use(auditLogsRouter)
router.use(platformConfigRouter)
router.use(ordersRouter)
router.use(tasksRouter)
router.use(cdksRouter)
router.use(inventoryRouter)
router.use(webhookEventsRouter)
router.use((req, res) => {
-79
View File
@@ -1,79 +0,0 @@
import { Router } from 'express'
import {
createAdminCdk,
getAdminCdks,
importAdminCdks,
invalidateAdminCdk,
releaseAdminInventoryCdk,
} from '../../services/admin/admin-service.js'
import { createJsonHandler, requireAdminRoles } from './shared.js'
const router = Router()
router.get('/cdks', createJsonHandler(
(req) => getAdminCdks(req.query),
{
successMessage: 'ok',
errorMessage: '读取 CDK 列表失败',
scope: '[admin/cdks]',
},
))
router.post('/cdks', createJsonHandler(
(req) => createAdminCdk(req.body),
{
successMessage: 'CDK 已新增',
errorMessage: '新增 CDK 失败',
scope: '[admin/cdks]',
},
))
router.post('/cdks/import', createJsonHandler(
(req) => importAdminCdks(req.body),
{
successMessage: '导入完成',
errorMessage: '导入 CDK 失败',
scope: '[admin/cdks/import]',
},
))
router.post('/cdks/:cdkId/release', requireAdminRoles(['admin']), createJsonHandler(
(req) => releaseAdminInventoryCdk(req.params.cdkId),
{
successMessage: 'CDK 已释放',
errorMessage: '释放库存 CDK 失败',
scope: '[admin/cdks/:cdkId/release]',
audit: (req, data) => ({
action: 'inventory_cdk_released',
targetType: 'cdk',
targetId: String(req.params.cdkId),
data: {
cdkId: data.cdk?.cdkId,
skuCode: data.cdk?.skuCode,
cdkCode: data.cdk?.cdkCode,
},
}),
},
))
router.post('/cdks/:cdkId/invalidate', requireAdminRoles(['admin']), createJsonHandler(
(req) => invalidateAdminCdk(req.params.cdkId, req.body),
{
successMessage: 'CDK 已作废',
errorMessage: '作废 CDK 失败',
scope: '[admin/cdks/:cdkId/invalidate]',
audit: (req, data) => ({
action: 'inventory_cdk_invalidated',
targetType: 'cdk',
targetId: String(req.params.cdkId),
data: {
cdkId: data.cdk?.cdkId,
skuCode: data.cdk?.skuCode,
invalidReason: data.cdk?.invalidReason,
},
}),
},
))
export default router
@@ -0,0 +1,79 @@
import { Router } from 'express'
import {
createAdminInventoryItem,
getAdminInventoryItems,
importAdminInventoryItems,
invalidateAdminInventoryItem,
releaseAdminInventoryItem,
} from '../../services/admin/admin-service.js'
import { createJsonHandler, requireAdminRoles } from './shared.js'
const router = Router()
router.get('/inventory', createJsonHandler(
(req) => getAdminInventoryItems(req.query),
{
successMessage: 'ok',
errorMessage: '读取库存列表失败',
scope: '[admin/inventory]',
},
))
router.post('/inventory', createJsonHandler(
(req) => createAdminInventoryItem(req.body),
{
successMessage: '库存项已新增',
errorMessage: '新增库存项失败',
scope: '[admin/inventory]',
},
))
router.post('/inventory/import', createJsonHandler(
(req) => importAdminInventoryItems(req.body),
{
successMessage: '导入完成',
errorMessage: '导入库存凭据失败',
scope: '[admin/inventory/import]',
},
))
router.post('/inventory/:inventoryItemId/release', requireAdminRoles(['admin']), createJsonHandler(
(req) => releaseAdminInventoryItem(req.params.inventoryItemId),
{
successMessage: '库存项已释放',
errorMessage: '释放库存项失败',
scope: '[admin/inventory/:inventoryItemId/release]',
audit: (req, data) => ({
action: 'inventory_item_released',
targetType: 'inventory_item',
targetId: String(req.params.inventoryItemId),
data: {
inventoryItemId: data.inventoryItem?.inventoryItemId,
skuCode: data.inventoryItem?.skuCode,
displayValue: data.inventoryItem?.displayValue,
},
}),
},
))
router.post('/inventory/:inventoryItemId/invalidate', requireAdminRoles(['admin']), createJsonHandler(
(req) => invalidateAdminInventoryItem(req.params.inventoryItemId, req.body),
{
successMessage: '库存项已作废',
errorMessage: '作废库存项失败',
scope: '[admin/inventory/:inventoryItemId/invalidate]',
audit: (req, data) => ({
action: 'inventory_item_invalidated',
targetType: 'inventory_item',
targetId: String(req.params.inventoryItemId),
data: {
inventoryItemId: data.inventoryItem?.inventoryItemId,
skuCode: data.inventoryItem?.skuCode,
invalidReason: data.inventoryItem?.invalidReason,
},
}),
},
))
export default router
+51 -8
View File
@@ -2,12 +2,14 @@ import { Router } from 'express'
import {
closeAdminTask,
completeAdminTaskManualDispatch,
getAdminTaskDetail,
getAdminTaskScreenshotPath,
getAdminTasks,
markAdminTaskManualReview,
regenerateAdminTaskClaimLink,
releaseAdminTaskCdk,
releaseAdminTaskInventoryBinding,
releaseAdminTaskInventory,
retryAdminTask,
} from '../../services/admin/admin-service.js'
import { createFileHandler, createJsonHandler, requireAdminRoles } from './shared.js'
@@ -49,14 +51,14 @@ router.post('/tasks/:taskId/retry', createJsonHandler(
},
))
router.post('/tasks/:taskId/release-cdk', requireAdminRoles(['admin']), createJsonHandler(
(req) => releaseAdminTaskCdk(req.params.taskId),
router.post('/tasks/:taskId/release-inventory', requireAdminRoles(['admin']), createJsonHandler(
(req) => releaseAdminTaskInventory(req.params.taskId),
{
successMessage: 'CDK 已释放',
errorMessage: '释放 CDK 失败',
scope: '[admin/tasks/:taskId/release-cdk]',
successMessage: '库存凭据已释放',
errorMessage: '释放库存凭据失败',
scope: '[admin/tasks/:taskId/release-inventory]',
audit: (req, data) => ({
action: 'task_release_cdk',
action: 'task_release_inventory',
targetType: 'task',
targetId: String(req.params.taskId),
data: {
@@ -68,6 +70,26 @@ router.post('/tasks/:taskId/release-cdk', requireAdminRoles(['admin']), createJs
},
))
router.post('/tasks/:taskId/inventory-bindings/:bindingId/release', requireAdminRoles(['admin']), createJsonHandler(
(req) => releaseAdminTaskInventoryBinding(req.params.taskId, req.params.bindingId),
{
successMessage: '库存绑定已释放',
errorMessage: '释放库存绑定失败',
scope: '[admin/tasks/:taskId/inventory-bindings/:bindingId/release]',
audit: (req, data) => ({
action: 'task_release_inventory_binding',
targetType: 'task_inventory_binding',
targetId: String(req.params.bindingId),
data: {
taskId: data.task.taskId,
taskNo: data.task.taskNo,
bindingId: data.bindingId,
inventoryItemId: data.inventoryItemId,
},
}),
},
))
router.post('/tasks/:taskId/regenerate-claim-link', requireAdminRoles(['admin']), createJsonHandler(
(req) => regenerateAdminTaskClaimLink(req.params.taskId),
{
@@ -81,7 +103,7 @@ router.post('/tasks/:taskId/regenerate-claim-link', requireAdminRoles(['admin'])
data: {
taskId: data.task.taskId,
taskNo: data.task.taskNo,
claimTokenId: data.task.claimTokenId,
primaryClaimTokenId: data.task.primaryClaimTokenId,
},
}),
},
@@ -125,4 +147,25 @@ router.post('/tasks/:taskId/mark-manual-review', requireAdminRoles(['admin']), c
},
))
router.post('/tasks/:taskId/complete-manual-dispatch', requireAdminRoles(['admin']), createJsonHandler(
(req) => completeAdminTaskManualDispatch(req.params.taskId, req.body, req.adminSession),
{
successMessage: '人工履约结果已回写',
errorMessage: '回写人工履约结果失败',
scope: '[admin/tasks/:taskId/complete-manual-dispatch]',
audit: (req, data) => ({
action: 'task_complete_manual_dispatch',
targetType: 'task',
targetId: String(req.params.taskId),
data: {
taskId: data.task.taskId,
taskNo: data.task.taskNo,
outcome: data.outcome,
deliveryStatus: data.task.deliveryStatus,
resultCode: data.task.resultCode,
},
}),
},
))
export default router
+446 -90
View File
@@ -8,15 +8,28 @@ import {
saveAgisoShopConfigMap,
} from '../platforms/agiso/shop-config-service.js'
import { getClaimTokenById, updateClaimToken } from '../../repositories/claim-token-repo.js'
import { createCdks, getCdkById, invalidateCdk, listCdks, releaseReservedCdk } from '../../repositories/cdk-repo.js'
import {
createInventoryItems,
getInventoryItemById,
invalidateInventoryItem,
listInventoryItems,
markInventoryItemDelivered,
releaseReservedInventoryItem,
} from '../../repositories/inventory-repo.js'
import { listOrderItemsByOrderId } from '../../repositories/order-item-repo.js'
import { getOrderById, listOrders } from '../../repositories/order-repo.js'
import { getTaskById, listTasks, listTasksByOrderId, updateTask } from '../../repositories/task-repo.js'
import {
getTaskInventoryBindingById,
listTaskInventoryBindingsByTaskId,
listTaskInventoryBindingSummariesByTaskIds,
} from '../../repositories/task-inventory-binding-repo.js'
import { createTaskEvent, listTaskEventsByTaskId } from '../../repositories/task-event-repo.js'
import { getWebhookEventById, listWebhookEvents, listWebhookEventsByOrderId } from '../../repositories/webhook-event-repo.js'
import { createHttpError } from '../../utils/http.js'
import { formatFenToAmount, normalizeFen, parseAmountToFen } from '../../utils/money.js'
import { nowIso } from '../../utils/time.js'
import { reserveCdkForTask } from '../order/cdk-service.js'
import { reserveInventoryForTask } from '../order/inventory-service.js'
import { replayAgisoTradeWebhookEvent } from '../order/webhook-service.js'
import { normalizeDateQuery, normalizePage, normalizePageSize, safeParseJson } from './admin-query-utils.js'
@@ -102,6 +115,7 @@ export async function getAdminOrderDetail(orderId) {
listTasksByOrderId(order.id),
listWebhookEventsByOrderId(order.id),
])
const taskBindingSummaryMap = await getTaskBindingSummaryMap(tasks.map((task) => task.id))
const itemSummary = summarizeOrderItems(items)
return {
@@ -125,7 +139,7 @@ export async function getAdminOrderDetail(orderId) {
updatedAt: order.updated_at,
itemSummary,
rawPayload: safeParseJson(order.raw_payload_json),
bindingSummary: buildOrderBindingSummary(tasks),
bindingSummary: buildOrderBindingSummary(tasks, taskBindingSummaryMap),
},
items: items.map((item) => ({
orderItemId: item.id,
@@ -136,7 +150,7 @@ export async function getAdminOrderDetail(orderId) {
deliveryMode: resolveOrderItemDeliveryMode(tasks, item.id),
spec: safeParseJson(item.spec_json),
})),
tasks: tasks.map(mapAdminTaskSummary),
tasks: tasks.map((task) => mapAdminTaskSummary(task, getTaskBindingSummary(taskBindingSummaryMap, task.id))),
webhookEvents: webhookEvents.map((event) => ({
eventId: event.id,
provider: event.provider || 'agiso',
@@ -167,9 +181,10 @@ export async function getAdminTasks(query = {}) {
dateFrom: normalizeDateQuery(query.dateFrom),
dateTo: normalizeDateQuery(query.dateTo, true),
})
const taskBindingSummaryMap = await getTaskBindingSummaryMap(items.map((item) => item.id))
return {
items: items.map(mapAdminTaskListItem),
items: items.map((item) => mapAdminTaskListItem(item, getTaskBindingSummary(taskBindingSummaryMap, item.id))),
pagination: { page, pageSize, total },
}
}
@@ -184,22 +199,27 @@ export async function getAdminTaskDetail(taskId) {
})
}
const [order, claimToken, cdk] = await Promise.all([
const [order, claimToken, inventoryItem, taskEvents, inventoryBindings] = await Promise.all([
getOrderById(task.order_id),
getTaskPrimaryClaimTokenId(task) ? getClaimTokenById(getTaskPrimaryClaimTokenId(task)) : Promise.resolve(null),
getTaskPrimaryInventoryItemId(task) ? getCdkById(getTaskPrimaryInventoryItemId(task)) : Promise.resolve(null),
getTaskPrimaryInventoryItemId(task) ? getInventoryItemById(getTaskPrimaryInventoryItemId(task)) : Promise.resolve(null),
listTaskEventsByTaskId(task.id),
listTaskInventoryBindingsByTaskId(task.id),
])
const orderItems = order ? await listOrderItemsByOrderId(order.id) : []
const orderItem = orderItems.find((item) => item.id === task.order_item_id) || null
const taskContext = parseTaskContext(task)
const taskBindingSummary = createTaskBindingSummaryFromBindings(inventoryBindings)
const mappedInventoryBindings = inventoryBindings.map((binding) => mapAdminTaskInventoryBinding(binding, task))
return {
task: mapAdminTaskListItem({
...task,
sku_code: orderItem?.sku_code || '',
sku_name: orderItem?.sku_name || '',
cdk_code: cdk?.cdk_code || '',
inventory_display_value: inventoryItem?.display_value || '',
claim_token: claimToken?.token || '',
}),
}, taskBindingSummary),
order: order
? {
orderId: order.id,
@@ -222,29 +242,34 @@ export async function getAdminTaskDetail(taskId) {
: null,
claimToken: claimToken
? {
claimTokenId: claimToken.id,
primaryClaimTokenId: claimToken.id,
token: claimToken.token,
status: claimToken.status,
expiredAt: claimToken.expired_at,
}
: null,
cdk: cdk
inventory: inventoryItem
? {
cdkId: cdk.id,
skuCode: cdk.sku_code,
batchNo: cdk.batch_no,
cdkCode: cdk.cdk_code,
status: cdk.status,
inventoryItemId: inventoryItem.id,
skuCode: inventoryItem.sku_code,
batchNo: inventoryItem.batch_no,
credentialType: inventoryItem.credential_type || 'tencent_code',
displayValue: inventoryItem.display_value,
status: inventoryItem.status,
}
: null,
inventoryBindings: mappedInventoryBindings,
artifacts: safeParseJson(task.artifacts_json),
screenshotUrl: task.screenshot_path ? `/api/v1/admin/tasks/${task.id}/screenshot` : '',
manualDispatch: mapManualDispatchContext(taskContext.manualDispatch),
events: taskEvents.map(mapAdminTaskEvent),
operations: {
canRetry: ['retry_pending', 'manual_review', 'waiting_inventory'].includes(task.task_status),
canReleaseCdk: Boolean(getTaskPrimaryInventoryItemId(task) && ['link_generated', 'retry_pending', 'manual_review', 'waiting_inventory', 'closed'].includes(task.task_status)),
canRegenerateClaimLink: ['link_generated', 'claimed', 'role_confirmed', 'retry_pending', 'manual_review'].includes(task.task_status),
canRetry: !isManualDispatchTask(task) && ['retry_pending', 'manual_review', 'waiting_inventory'].includes(task.task_status),
canReleaseInventory: mappedInventoryBindings.some((binding) => binding.canRelease),
canRegenerateClaimLink: !isManualDispatchTask(task) && ['link_generated', 'claimed', 'role_confirmed', 'retry_pending', 'manual_review'].includes(task.task_status),
canClose: !['redeemed', 'closed'].includes(task.task_status),
canMarkManualReview: !['redeemed', 'closed', 'manual_review'].includes(task.task_status),
canCompleteManualDispatch: isManualDispatchTask(task) && !['redeemed', 'closed'].includes(task.task_status),
},
}
}
@@ -262,10 +287,10 @@ export async function getAdminTaskScreenshotPath(taskId) {
return task.screenshot_path
}
export async function getAdminCdks(query = {}) {
export async function getAdminInventoryItems(query = {}) {
const page = normalizePage(query.page)
const pageSize = normalizePageSize(query.pageSize)
const { items, total } = await listCdks({
const { items, total } = await listInventoryItems({
page,
pageSize,
skuCode: String(query.skuCode || '').trim(),
@@ -274,29 +299,29 @@ export async function getAdminCdks(query = {}) {
})
return {
items: await Promise.all(items.map((item) => mapAdminCdkListItem(item))),
items: await Promise.all(items.map((item) => mapAdminInventoryListItem(item))),
pagination: { page, pageSize, total },
}
}
export async function createAdminCdk(payload = {}) {
export async function createAdminInventoryItem(payload = {}) {
const skuCode = String(payload.skuCode || '').trim()
const cdkCode = String(payload.cdkCode || '').trim()
const displayValue = String(payload.displayValue || '').trim()
const batchNo = String(payload.batchNo || '').trim()
const credentialType = String(payload.credentialType || 'tencent_code').trim() || 'tencent_code'
if (!skuCode || !cdkCode) {
throw createHttpError('缺少 skuCode 或 cdkCode', {
if (!skuCode || !displayValue) {
throw createHttpError('缺少 skuCode 或 displayValue', {
statusCode: 400,
errorCode: 'admin_cdk_create_invalid',
errorCode: 'admin_inventory_create_invalid',
})
}
const now = nowIso()
const created = await createCdks([
const created = await createInventoryItems([
{
skuCode,
cdkCode,
displayValue,
batchNo,
credentialType,
createdAt: now,
@@ -305,31 +330,31 @@ export async function createAdminCdk(payload = {}) {
])
if (created === 0) {
throw createHttpError('CDK 已存在,不能重复新增', {
throw createHttpError('库存凭据已存在,不能重复新增', {
statusCode: 409,
errorCode: 'admin_cdk_duplicate',
errorCode: 'admin_inventory_duplicate',
})
}
const { items } = await listCdks({
const { items } = await listInventoryItems({
page: 1,
pageSize: 1,
skuCode,
})
const createdItem = items.find((item) => item.cdk_code === cdkCode) || null
const createdItem = items.find((item) => item.display_value === displayValue) || null
return {
cdk: createdItem ? await mapAdminCdkListItem(createdItem) : null,
inventoryItem: createdItem ? await mapAdminInventoryListItem(createdItem) : null,
}
}
export async function importAdminCdks(payload = {}) {
const rows = normalizeCdkImportRows(payload)
export async function importAdminInventoryItems(payload = {}) {
const rows = normalizeInventoryImportRows(payload)
if (rows.length === 0) {
throw createHttpError('没有可导入的 CDK 数据', {
throw createHttpError('没有可导入的库存凭据数据', {
statusCode: 400,
errorCode: 'admin_cdk_import_empty',
errorCode: 'admin_inventory_import_empty',
})
}
@@ -337,13 +362,13 @@ export async function importAdminCdks(payload = {}) {
const normalizedRows = rows.map((row) => ({
skuCode: row.skuCode,
batchNo: row.batchNo,
cdkCode: row.cdkCode,
displayValue: row.displayValue,
credentialType: row.credentialType,
createdAt: now,
updatedAt: now,
}))
const created = await createCdks(normalizedRows)
const created = await createInventoryItems(normalizedRows)
return {
total: normalizedRows.length,
@@ -352,38 +377,38 @@ export async function importAdminCdks(payload = {}) {
}
}
export async function releaseAdminInventoryCdk(cdkId) {
const cdk = await getRequiredCdk(cdkId)
export async function releaseAdminInventoryItem(inventoryItemId) {
const inventoryItem = await getRequiredInventoryItem(inventoryItemId)
if (cdk.status !== 'reserved') {
throw createHttpError('当前 CDK 不是预占状态,不能释放', {
if (inventoryItem.status !== 'reserved') {
throw createHttpError('当前库存项不是预占状态,不能释放', {
statusCode: 409,
errorCode: 'admin_cdk_release_not_allowed',
errorCode: 'admin_inventory_release_not_allowed',
})
}
const updated = await releaseReservedCdk(cdk.id, nowIso())
const updated = await releaseReservedInventoryItem(inventoryItem.id, nowIso())
return {
cdk: await mapAdminCdkListItem(updated),
inventoryItem: await mapAdminInventoryListItem(updated),
}
}
export async function invalidateAdminCdk(cdkId, payload = {}) {
const cdk = await getRequiredCdk(cdkId)
export async function invalidateAdminInventoryItem(inventoryItemId, payload = {}) {
const inventoryItem = await getRequiredInventoryItem(inventoryItemId)
if (cdk.status !== 'available') {
throw createHttpError('只有可用 CDK 才能作废,请先释放预占', {
if (inventoryItem.status !== 'available') {
throw createHttpError('只有可用库存项才能作废,请先释放预占', {
statusCode: 409,
errorCode: 'admin_cdk_invalidate_not_allowed',
errorCode: 'admin_inventory_invalidate_not_allowed',
})
}
const reason = String(payload.reason || '').trim() || '后台手动作废'
const updated = await invalidateCdk(cdk.id, reason, nowIso())
const updated = await invalidateInventoryItem(inventoryItem.id, reason, nowIso())
return {
cdk: await mapAdminCdkListItem(updated),
inventoryItem: await mapAdminInventoryListItem(updated),
}
}
@@ -560,6 +585,13 @@ export async function retryAdminTask(taskId) {
const task = await getRequiredTask(taskId)
const now = nowIso()
if (isManualDispatchTask(task)) {
throw createHttpError('人工履约任务不能走自动重试,请在详情页直接回写人工履约结果', {
statusCode: 409,
errorCode: 'admin_task_manual_dispatch_retry_not_allowed',
})
}
if (!['retry_pending', 'manual_review', 'waiting_inventory'].includes(task.task_status)) {
throw createHttpError('当前任务状态不允许重试', {
statusCode: 409,
@@ -580,7 +612,7 @@ export async function retryAdminTask(taskId) {
let token = ''
if (!reservedInventoryItemId) {
const reserved = await reserveCdkForTask({
const reserved = await reserveInventoryForTask({
skuCode: orderItem?.sku_code || '',
taskId: task.id,
credentialType: primaryRequirement?.credentialType || 'tencent_code',
@@ -589,7 +621,7 @@ export async function retryAdminTask(taskId) {
if (!reserved) {
nextStatus = 'waiting_inventory'
lastError = '库存不足,等待可用 CDK'
lastError = '库存不足,等待可用库存凭据'
} else {
reservedInventoryItemId = reserved.id
}
@@ -624,29 +656,29 @@ export async function retryAdminTask(taskId) {
return payload
}
export async function releaseAdminTaskCdk(taskId) {
export async function releaseAdminTaskInventory(taskId) {
const task = await getRequiredTask(taskId)
const primaryInventoryItemId = getTaskPrimaryInventoryItemId(task)
if (!primaryInventoryItemId) {
throw createHttpError('当前任务没有预占 CDK', {
throw createHttpError('当前任务没有预占库存项', {
statusCode: 409,
errorCode: 'admin_task_no_reserved_cdk',
errorCode: 'admin_task_no_reserved_inventory',
})
}
if (task.task_status === 'redeemed') {
throw createHttpError('已兑换任务不能释放 CDK', {
throw createHttpError('已兑换任务不能释放库存项', {
statusCode: 409,
errorCode: 'admin_task_release_not_allowed',
})
}
await releaseReservedCdk(primaryInventoryItemId, nowIso())
await releaseReservedInventoryItem(primaryInventoryItemId, nowIso())
const updatedTask = await updateTask(task.id, {
task_status: 'waiting_inventory',
inventory_status: 'pending',
last_error: '已手动释放预占 CDK',
last_error: '已手动释放预占库存项',
updated_at: nowIso(),
})
@@ -655,10 +687,84 @@ export async function releaseAdminTaskCdk(taskId) {
}
}
export async function releaseAdminTaskInventoryBinding(taskId, bindingId) {
const task = await getRequiredTask(taskId)
const binding = await getTaskInventoryBindingById(Number(bindingId))
if (!binding || Number(binding.task_id) !== Number(task.id)) {
throw createHttpError('任务库存绑定不存在', {
statusCode: 404,
errorCode: 'admin_task_inventory_binding_not_found',
})
}
if (String(binding.binding_status || '').trim() !== 'reserved') {
throw createHttpError('当前库存绑定不是预占状态,不能释放', {
statusCode: 409,
errorCode: 'admin_task_inventory_binding_release_not_allowed',
})
}
if (task.task_status === 'redeemed') {
throw createHttpError('已兑换任务不能释放库存绑定', {
statusCode: 409,
errorCode: 'admin_task_release_not_allowed',
})
}
const now = nowIso()
await releaseReservedInventoryItem(binding.inventory_item_id, now)
const remainingBindings = await listTaskInventoryBindingsByTaskId(task.id)
const activeBindings = remainingBindings.filter((item) => ['reserved', 'consumed'].includes(String(item.binding_status || '').trim()))
const hasReservedBindings = activeBindings.some((item) => String(item.binding_status || '').trim() === 'reserved')
const hasConsumedBindings = activeBindings.some((item) => String(item.binding_status || '').trim() === 'consumed')
const nextInventoryStatus = hasReservedBindings ? 'reserved' : (hasConsumedBindings ? 'consumed' : 'pending')
const nextTaskStatus = !activeBindings.length && !['closed', 'expired'].includes(String(task.task_status || '').trim())
? 'waiting_inventory'
: task.task_status
if (!hasReservedBindings) {
const primaryClaimTokenId = getTaskPrimaryClaimTokenId(task)
if (primaryClaimTokenId) {
await updateClaimToken(primaryClaimTokenId, {
status: 'revoked',
updated_at: now,
})
}
}
const updatedTask = await updateTask(task.id, {
task_status: nextTaskStatus,
inventory_status: nextInventoryStatus,
last_error: !activeBindings.length ? '已手动释放预占库存绑定' : (task.last_error || ''),
updated_at: now,
})
await createTaskEvent(task.id, 'inventory_binding_released', {
bindingId: Number(binding.id),
inventoryItemId: Number(binding.inventory_item_id),
roleKey: String(binding.role_key || '').trim(),
}, now)
return {
task: mapTaskActionPayload(updatedTask),
bindingId: Number(binding.id),
inventoryItemId: Number(binding.inventory_item_id),
}
}
export async function regenerateAdminTaskClaimLink(taskId) {
const task = await getRequiredTask(taskId)
const primaryClaimTokenId = getTaskPrimaryClaimTokenId(task)
if (isManualDispatchTask(task)) {
throw createHttpError('人工履约任务不需要领取链接,请直接回写人工履约结果', {
statusCode: 409,
errorCode: 'admin_task_manual_dispatch_claim_not_allowed',
})
}
if (['redeemed', 'closed'].includes(task.task_status)) {
throw createHttpError('当前任务状态不允许重新生成领取链接', {
statusCode: 409,
@@ -715,6 +821,7 @@ export async function markAdminTaskManualReview(taskId) {
const task = await getRequiredTask(taskId)
const updatedTask = await updateTask(task.id, {
task_status: 'manual_review',
delivery_status: task.delivery_status || 'pending',
last_error: task.last_error || '已转人工处理',
updated_at: nowIso(),
})
@@ -724,7 +831,88 @@ export async function markAdminTaskManualReview(taskId) {
}
}
function mapAdminTaskSummary(task) {
export async function completeAdminTaskManualDispatch(taskId, payload = {}, session = null) {
const task = await getRequiredTask(taskId)
if (!isManualDispatchTask(task)) {
throw createHttpError('当前任务不是人工履约任务', {
statusCode: 409,
errorCode: 'admin_task_not_manual_dispatch',
})
}
if (['redeemed', 'closed'].includes(task.task_status)) {
throw createHttpError('当前任务已经完结,不能重复回写人工履约结果', {
statusCode: 409,
errorCode: 'admin_task_manual_dispatch_already_completed',
})
}
const now = nowIso()
const outcome = normalizeManualDispatchOutcome(payload.outcome)
const resultMessage = String(payload.resultMessage || '').trim()
const deliveryReference = String(payload.deliveryReference || '').trim()
const deliveredCredential = String(payload.deliveredCredential || '').trim()
const context = parseTaskContext(task)
const inventoryItemId = getTaskPrimaryInventoryItemId(task)
const resultCode = outcome === 'failed' ? 'manual_dispatch_failed' : 'manual_dispatch_delivered'
const fallbackMessage = outcome === 'failed' ? '人工履约失败' : '人工履约已完成'
const nextTaskStatus = outcome === 'failed' ? 'closed' : 'redeemed'
const nextDeliveryStatus = outcome === 'failed' ? 'failed' : 'delivered'
const nextInventoryStatus = outcome === 'delivered' && inventoryItemId
? 'consumed'
: task.inventory_status || 'not_required'
const manualDispatch = {
outcome,
deliveryReference,
deliveredCredential,
resultMessage: resultMessage || fallbackMessage,
completedAt: now,
completedBy: session
? {
userId: Number(session.userId || 0),
username: String(session.username || ''),
role: String(session.role || ''),
}
: null,
}
if (outcome === 'delivered' && inventoryItemId) {
await markInventoryItemDelivered(inventoryItemId, now)
}
const updatedTask = await updateTask(task.id, {
task_status: nextTaskStatus,
inventory_status: nextInventoryStatus,
delivery_status: nextDeliveryStatus,
result_code: resultCode,
result_message: resultMessage || fallbackMessage,
user_action_status: 'not_required',
last_error: outcome === 'failed' ? (resultMessage || fallbackMessage) : '',
redeemed_at: outcome === 'delivered' ? now : task.redeemed_at || null,
context_json: JSON.stringify({
...context,
manualDispatch,
}),
updated_at: now,
})
await createTaskEvent(task.id, 'manual_dispatch_completed', {
outcome,
resultCode,
resultMessage: resultMessage || fallbackMessage,
deliveryReference,
deliveredCredentialMasked: maskCode(deliveredCredential),
completedBy: manualDispatch.completedBy,
}, now)
return {
outcome,
task: mapTaskActionPayload(updatedTask),
}
}
function mapAdminTaskSummary(task, bindingSummary = createEmptyTaskBindingSummary()) {
const binding = buildTaskBindingState(task)
return {
@@ -740,6 +928,7 @@ function mapAdminTaskSummary(task) {
redeemedAt: task.redeemed_at,
lastError: task.last_error,
retryCount: getTaskRetryCount(task),
bindingSummary,
createdAt: task.created_at,
updatedAt: task.updated_at,
}
@@ -883,17 +1072,17 @@ async function mapAdminWebhookEvent(item, { includeRaw = false } = {}) {
}
}
async function mapAdminCdkListItem(item) {
async function mapAdminInventoryListItem(item) {
const task = item.reserved_by_task_id ? await getTaskById(item.reserved_by_task_id) : null
const order = task?.order_id ? await getOrderById(task.order_id) : null
const binding = buildTaskBindingState(task)
return {
cdkId: item.id,
inventoryItemId: item.id,
skuCode: item.sku_code,
batchNo: item.batch_no,
cdkCode: item.cdk_code,
credentialType: item.credential_type || 'tencent_code',
displayValue: item.display_value,
status: item.status,
reservedByTaskId: item.reserved_by_task_id,
reservedByTaskNo: task?.task_no || '',
@@ -909,15 +1098,17 @@ async function mapAdminCdkListItem(item) {
function mapTaskActionPayload(task) {
const inventoryItemId = getTaskPrimaryInventoryItemId(task)
const claimTokenId = getTaskPrimaryClaimTokenId(task)
const primaryClaimTokenId = getTaskPrimaryClaimTokenId(task)
return {
taskId: task.id,
taskNo: task.task_no,
status: task.task_status,
deliveryStatus: task.delivery_status,
resultCode: task.result_code,
resultMessage: task.result_message,
inventoryItemId,
claimTokenId,
reservedCdkId: inventoryItemId,
primaryClaimTokenId,
lastError: task.last_error,
updatedAt: task.updated_at,
}
@@ -936,20 +1127,20 @@ async function getRequiredTask(taskId) {
return task
}
async function getRequiredCdk(cdkId) {
const cdk = await getCdkById(Number(cdkId))
async function getRequiredInventoryItem(inventoryItemId) {
const inventoryItem = await getInventoryItemById(Number(inventoryItemId))
if (!cdk) {
throw createHttpError('CDK 不存在', {
if (!inventoryItem) {
throw createHttpError('库存项不存在', {
statusCode: 404,
errorCode: 'admin_cdk_not_found',
errorCode: 'admin_inventory_not_found',
})
}
return cdk
return inventoryItem
}
function mapAdminTaskListItem(task) {
function mapAdminTaskListItem(task, bindingSummary = createEmptyTaskBindingSummary()) {
const binding = buildTaskBindingState(task)
return {
@@ -959,6 +1150,10 @@ function mapAdminTaskListItem(task) {
skuCode: task.sku_code || '',
skuName: task.sku_name || '',
status: task.task_status,
executorKey: task.executor_key || '',
deliveryStatus: task.delivery_status || '',
resultCode: task.result_code || '',
resultMessage: task.result_message || '',
systemBindingStatus: binding.systemBindingStatus,
userBindingStatus: binding.userBindingStatus,
loginType: task.login_type,
@@ -969,21 +1164,120 @@ function mapAdminTaskListItem(task) {
roleConfirmedAt: task.role_confirmed_at,
redeemedAt: task.redeemed_at,
retryCount: getTaskRetryCount(task),
bindingSummary,
lastError: task.last_error,
createdAt: task.created_at,
updatedAt: task.updated_at,
reservedCdkCodeMasked: maskCode(task.primary_inventory_display_value),
inventoryDisplayMasked: maskCode(task.primary_inventory_display_value),
inventoryCredentialType: String(task.primary_inventory_credential_type || '').trim(),
claimToken: task.primary_claim_token || task.claim_token || '',
screenshotPath: task.screenshot_path || '',
}
}
function mapAdminTaskEvent(event) {
const payload = safeParseJson(event.payload_json)
return {
eventId: event.id,
eventType: String(event.event_type || '').trim(),
payload: normalizeRecord(payload),
createdAt: event.created_at,
}
}
function createEmptyTaskBindingSummary() {
return {
totalBindingCount: 0,
reservedBindingCount: 0,
consumedBindingCount: 0,
releasedBindingCount: 0,
roleKeys: [],
}
}
async function getTaskBindingSummaryMap(taskIds = []) {
const rows = await listTaskInventoryBindingSummariesByTaskIds(taskIds)
const output = new Map()
for (const row of rows) {
output.set(Number(row.task_id), {
totalBindingCount: Number(row.total_binding_count || 0),
reservedBindingCount: Number(row.reserved_binding_count || 0),
consumedBindingCount: Number(row.consumed_binding_count || 0),
releasedBindingCount: Number(row.released_binding_count || 0),
roleKeys: Array.isArray(row.role_keys)
? row.role_keys.map((value) => String(value || '').trim()).filter(Boolean)
: [],
})
}
return output
}
function getTaskBindingSummary(summaryMap, taskId) {
return summaryMap.get(Number(taskId)) || createEmptyTaskBindingSummary()
}
function createTaskBindingSummaryFromBindings(bindings = []) {
const normalizedBindings = Array.isArray(bindings) ? bindings : []
const roleKeys = Array.from(new Set(normalizedBindings
.map((binding) => String(binding?.role_key || '').trim())
.filter(Boolean)))
return {
totalBindingCount: normalizedBindings.length,
reservedBindingCount: normalizedBindings.filter((binding) => String(binding?.binding_status || '') === 'reserved').length,
consumedBindingCount: normalizedBindings.filter((binding) => String(binding?.binding_status || '') === 'consumed').length,
releasedBindingCount: normalizedBindings.filter((binding) => String(binding?.binding_status || '') === 'released').length,
roleKeys,
}
}
function mapAdminTaskInventoryBinding(binding, task) {
const metadata = safeParseJson(binding.metadata_json)
return {
bindingId: binding.id,
inventoryItemId: binding.inventory_item_id,
roleKey: String(binding.role_key || '').trim(),
quantity: Math.max(1, Number(binding.quantity || 1)),
bindingStatus: String(binding.binding_status || '').trim(),
inventoryStatus: String(binding.inventory_item_status || '').trim(),
skuCode: String(binding.sku_code || '').trim(),
batchNo: String(binding.batch_no || '').trim(),
credentialType: String(binding.credential_type || 'tencent_code').trim() || 'tencent_code',
displayValue: String(binding.display_value || '').trim(),
invalidReason: String(binding.invalid_reason || '').trim(),
consumedAt: binding.consumed_at || null,
releasedAt: binding.released_at || null,
createdAt: binding.created_at,
updatedAt: binding.updated_at,
metadata: normalizeRecord(metadata),
isPrimary: Number(binding.inventory_item_id || 0) === getTaskPrimaryInventoryItemId(task),
canRelease: canReleaseTaskInventoryBinding(task, binding),
}
}
function canReleaseTaskInventoryBinding(task, binding) {
if (!task || !binding) {
return false
}
if (String(binding.binding_status || '').trim() !== 'reserved') {
return false
}
return !['redeemed', 'expired'].includes(String(task.task_status || '').trim())
}
async function mapAdminOrderListItem(item) {
const [tasks, orderItems] = await Promise.all([
listTasksByOrderId(item.id),
listOrderItemsByOrderId(item.id),
])
const bindingSummary = buildOrderBindingSummary(tasks)
const taskBindingSummaryMap = await getTaskBindingSummaryMap(tasks.map((task) => task.id))
const bindingSummary = buildOrderBindingSummary(tasks, taskBindingSummaryMap)
const itemSummary = summarizeOrderItems(orderItems)
return {
@@ -1012,6 +1306,10 @@ async function mapAdminOrderListItem(item) {
userBindingStatus: bindingSummary.userBindingStatus,
systemBoundTaskCount: bindingSummary.systemBoundTaskCount,
completedBindingTaskCount: bindingSummary.completedBindingTaskCount,
totalBindingCount: bindingSummary.totalBindingCount,
reservedBindingCount: bindingSummary.reservedBindingCount,
consumedBindingCount: bindingSummary.consumedBindingCount,
releasedBindingCount: bindingSummary.releasedBindingCount,
}
}
@@ -1070,12 +1368,17 @@ function resolveOrderItemDeliveryMode(tasks, orderItemId) {
return String(task.executor_key || '').trim()
}
function buildOrderBindingSummary(tasks) {
function buildOrderBindingSummary(tasks, taskBindingSummaryMap = new Map()) {
const normalizedTasks = Array.isArray(tasks) ? tasks : []
const totalTaskCount = normalizedTasks.length
const taskBindings = normalizedTasks.map((task) => buildTaskBindingState(task))
const systemBoundTaskCount = normalizedTasks.filter((task) => isTaskSystemBound(task)).length
const completedBindingTaskCount = normalizedTasks.filter((task) => String(task?.task_status || '') === 'redeemed').length
const bindingSummaries = normalizedTasks.map((task) => getTaskBindingSummary(taskBindingSummaryMap, task.id))
const totalBindingCount = bindingSummaries.reduce((sum, item) => sum + item.totalBindingCount, 0)
const reservedBindingCount = bindingSummaries.reduce((sum, item) => sum + item.reservedBindingCount, 0)
const consumedBindingCount = bindingSummaries.reduce((sum, item) => sum + item.consumedBindingCount, 0)
const releasedBindingCount = bindingSummaries.reduce((sum, item) => sum + item.releasedBindingCount, 0)
let systemBindingStatus = 'pending_binding'
let userBindingStatus = 'not_started'
@@ -1085,6 +1388,10 @@ function buildOrderBindingSummary(tasks) {
totalTaskCount,
systemBoundTaskCount,
completedBindingTaskCount,
totalBindingCount,
reservedBindingCount,
consumedBindingCount,
releasedBindingCount,
systemBindingStatus,
userBindingStatus,
}
@@ -1112,6 +1419,10 @@ function buildOrderBindingSummary(tasks) {
totalTaskCount,
systemBoundTaskCount,
completedBindingTaskCount,
totalBindingCount,
reservedBindingCount,
consumedBindingCount,
releasedBindingCount,
systemBindingStatus,
userBindingStatus,
}
@@ -1187,13 +1498,58 @@ function isTaskSystemBound(task) {
}
function parseTaskContext(task) {
const value = task?.context_json
if (!value) {
return {}
}
if (typeof value === 'object') {
return value
}
try {
return JSON.parse(String(task?.context_json || '{}'))
return JSON.parse(String(value || '{}'))
} catch {
return {}
}
}
function mapManualDispatchContext(value) {
if (!value || typeof value !== 'object') {
return null
}
return {
outcome: String(value.outcome || '').trim(),
deliveryReference: String(value.deliveryReference || '').trim(),
deliveredCredential: String(value.deliveredCredential || '').trim(),
resultMessage: String(value.resultMessage || '').trim(),
completedAt: value.completedAt || null,
completedBy: value.completedBy && typeof value.completedBy === 'object'
? {
userId: Number(value.completedBy.userId || 0) || 0,
username: String(value.completedBy.username || '').trim(),
role: String(value.completedBy.role || '').trim(),
}
: null,
}
}
function normalizeManualDispatchOutcome(value) {
const normalized = String(value || '').trim().toLowerCase()
if (normalized === 'failed') {
return 'failed'
}
return 'delivered'
}
function isManualDispatchTask(task) {
return String(task?.executor_key || '').trim() === 'manual_dispatch'
}
function getTaskPrimaryInventoryItemId(task) {
const value = Number(task?.primary_inventory_item_id || 0)
return Number.isFinite(value) && value > 0 ? value : null
@@ -1233,7 +1589,7 @@ function resolveDisplayShopName(provider, shopId, shopName) {
return normalizedShopId
}
function normalizeCdkImportRows(payload) {
function normalizeInventoryImportRows(payload) {
const rows = []
const directRows = Array.isArray(payload.rows) ? payload.rows : []
const bulkCodes = Array.isArray(payload.codes) ? payload.codes : []
@@ -1241,15 +1597,15 @@ function normalizeCdkImportRows(payload) {
if (directRows.length > 0) {
for (const row of directRows) {
const skuCode = String(row?.skuCode || '').trim()
const cdkCode = String(row?.cdkCode || '').trim()
const displayValue = String(row?.displayValue || '').trim()
const batchNo = String(row?.batchNo || '').trim()
const credentialType = String(row?.credentialType || payload.credentialType || 'tencent_code').trim() || 'tencent_code'
if (!skuCode || !cdkCode) {
if (!skuCode || !displayValue) {
continue
}
rows.push({ skuCode, cdkCode, batchNo, credentialType })
rows.push({ skuCode, displayValue, batchNo, credentialType })
}
}
@@ -1261,16 +1617,16 @@ function normalizeCdkImportRows(payload) {
if (!skuCode) {
throw createHttpError('批量导入时缺少 skuCode', {
statusCode: 400,
errorCode: 'admin_cdk_import_missing_sku',
errorCode: 'admin_inventory_import_missing_sku',
})
}
for (const code of bulkCodes) {
const cdkCode = String(code || '').trim()
if (!cdkCode) {
for (const rawValue of bulkCodes) {
const displayValue = String(rawValue || '').trim()
if (!displayValue) {
continue
}
rows.push({ skuCode, cdkCode, batchNo, credentialType })
rows.push({ skuCode, displayValue, batchNo, credentialType })
}
}
@@ -1282,7 +1638,7 @@ function dedupeRows(rows) {
const output = []
for (const row of rows) {
const key = `${row.skuCode}::${row.credentialType || 'tencent_code'}::${row.cdkCode}`
const key = `${row.skuCode}::${row.credentialType || 'tencent_code'}::${row.displayValue}`
if (seen.has(key)) {
continue
}
@@ -9,7 +9,11 @@ import { findClaimTokenByToken, updateClaimToken } from '../../repositories/clai
import { getOrderById } from '../../repositories/order-repo.js'
import { getOrderItemById } from '../../repositories/order-item-repo.js'
import { findTaskByClaimTokenId, updateTask } from '../../repositories/task-repo.js'
import { getCdkById, markCdkDelivered, releaseReservedCdk } from '../../repositories/cdk-repo.js'
import {
getInventoryItemById,
markInventoryItemDelivered,
releaseReservedInventoryItem,
} from '../../repositories/inventory-repo.js'
import { buildClaimUrl } from './claim-service.js'
import { createHttpError } from '../../utils/http.js'
import { formatFenToAmount, normalizeFen } from '../../utils/money.js'
@@ -151,12 +155,14 @@ export async function redeemClaimTask(token) {
})
}
const cdk = context.task.primary_inventory_item_id ? await getCdkById(context.task.primary_inventory_item_id) : null
const inventoryItem = context.task.primary_inventory_item_id
? await getInventoryItemById(context.task.primary_inventory_item_id)
: null
if (!cdk || !String(cdk.cdk_code || '').trim()) {
throw createHttpError('当前任务没有可用的预占 CDK', {
if (!inventoryItem || !String(inventoryItem.display_value || '').trim()) {
throw createHttpError('当前任务没有可用的预占库存凭据', {
statusCode: 409,
errorCode: 'claim_cdk_not_reserved',
errorCode: 'claim_inventory_not_reserved',
})
}
@@ -169,7 +175,7 @@ export async function redeemClaimTask(token) {
try {
const session = await redeemTencentBrowserSession(context.task.browser_session_id, {
code: cdk.cdk_code,
code: inventoryItem.display_value,
})
const finalRedeem = session.redeem?.final?.redeem || null
const updatedTask = await updateTask(context.task.id, {
@@ -185,7 +191,7 @@ export async function redeemClaimTask(token) {
last_error: '',
})
await markCdkDelivered(cdk.id, nowIso())
await markInventoryItemDelivered(inventoryItem.id, nowIso())
return buildClaimDetailPayload({
claimToken: context.claimToken,
@@ -312,14 +318,14 @@ async function expireClaimContext(claimToken, task) {
if (!CLAIM_TERMINAL_STATUSES.has(String(task.task_status || '')) && task.task_status !== 'redeemed') {
if (task.primary_inventory_item_id) {
await releaseReservedCdk(task.primary_inventory_item_id, now)
await releaseReservedInventoryItem(task.primary_inventory_item_id, now)
}
nextTask = await updateTask(task.id, {
task_status: 'expired',
inventory_status: 'pending',
user_action_status: 'expired',
last_error: '领取链接已过期,预占 CDK 已释放',
last_error: '领取链接已过期,预占库存项已释放',
updated_at: now,
})
}
@@ -1,33 +0,0 @@
import { assignReservedCdk, findFirstAvailableCdkBySkuCode, releaseReservedCdk } from '../../repositories/cdk-repo.js'
import { nowIso } from '../../utils/time.js'
export async function reserveCdkForTask({ skuCode, taskId, credentialType = 'tencent_code', roleKey = 'primary_code' }) {
if (!skuCode) {
return null
}
const available = await findFirstAvailableCdkBySkuCode(skuCode, credentialType)
if (!available) {
return null
}
return assignReservedCdk(available.id, taskId, nowIso(), roleKey)
}
export async function releaseReservedCdks(cdkIds = [], updatedAt = nowIso()) {
const released = []
for (const cdkId of cdkIds) {
if (!cdkId) {
continue
}
const item = await releaseReservedCdk(cdkId, updatedAt)
if (item) {
released.push(item)
}
}
return released
}
@@ -4,7 +4,7 @@ import {
listFulfillmentProfileRequirements,
resolveFulfillmentBinding,
} from '../../repositories/fulfillment-profile-repo.js'
import { reserveCdkForTask } from './cdk-service.js'
import { reserveInventoryForTask } from './inventory-service.js'
import { createTaskClaimToken } from '../claim/claim-service.js'
import { nowIso } from '../../utils/time.js'
import { randomId } from '../../utils/random.js'
@@ -125,7 +125,7 @@ async function preparePaidTask(task) {
if (!task.skuCode) {
return updateTask(task.id, {
task_status: 'manual_review',
last_error: '未匹配到 SKU,无法为任务分配 CDK',
last_error: '未匹配到 SKU,无法为任务分配库存凭据',
updated_at: now,
})
}
@@ -146,7 +146,7 @@ async function preparePaidTask(task) {
})
}
const reserved = await reserveCdkForTask({
const reserved = await reserveInventoryForTask({
skuCode: task.skuCode,
taskId: task.id,
credentialType: primaryRequirement.credentialType,
@@ -157,7 +157,7 @@ async function preparePaidTask(task) {
return updateTask(task.id, {
task_status: 'waiting_inventory',
inventory_status: 'pending',
last_error: '库存不足,等待可用 CDK',
last_error: '库存不足,等待可用库存凭据',
updated_at: now,
})
}
@@ -188,8 +188,18 @@ function resolvePaidTaskStatus(profile) {
}
function parseTaskContext(task) {
const value = task?.context_json
if (!value) {
return {}
}
if (typeof value === 'object') {
return value
}
try {
return JSON.parse(String(task?.context_json || '{}'))
return JSON.parse(String(value || '{}'))
} catch {
return {}
}
@@ -0,0 +1,37 @@
import {
assignReservedInventoryItem,
findFirstAvailableInventoryItemBySkuCode,
releaseReservedInventoryItem,
} from '../../repositories/inventory-repo.js'
import { nowIso } from '../../utils/time.js'
export async function reserveInventoryForTask({ skuCode, taskId, credentialType = 'tencent_code', roleKey = 'primary_code' }) {
if (!skuCode) {
return null
}
const available = await findFirstAvailableInventoryItemBySkuCode(skuCode, credentialType)
if (!available) {
return null
}
return assignReservedInventoryItem(available.id, taskId, nowIso(), roleKey)
}
export async function releaseReservedInventoryItems(inventoryItemIds = [], updatedAt = nowIso()) {
const released = []
for (const inventoryItemId of inventoryItemIds) {
if (!inventoryItemId) {
continue
}
const item = await releaseReservedInventoryItem(inventoryItemId, updatedAt)
if (item) {
released.push(item)
}
}
return released
}
+5 -1
View File
@@ -62,7 +62,11 @@ const router = createRouter({
},
{
path: 'cdks',
component: () => import('@/views/admin/AdminCdksView.vue'),
redirect: '/admin/inventory',
},
{
path: 'inventory',
component: () => import('@/views/admin/AdminInventoryView.vue'),
},
{
path: 'webhook-events',
+29 -13
View File
@@ -3,8 +3,8 @@ import type {
AdminAgisoObservedShopItem,
AdminAgisoShopConfigItem,
AdminAuditLogItem,
AdminInventoryItemListItem,
AdminTaskActionResponse,
AdminCdkListItem,
AdminDashboardSummary,
AdminLoginResponse,
AdminOrderDetail,
@@ -98,8 +98,12 @@ export function retryAdminTask(taskId: number | string) {
return apiPost<AdminTaskActionResponse>(`/api/v1/admin/tasks/${taskId}/retry`, {})
}
export function releaseAdminTaskCdk(taskId: number | string) {
return apiPost<AdminTaskActionResponse>(`/api/v1/admin/tasks/${taskId}/release-cdk`, {})
export function releaseAdminTaskInventory(taskId: number | string) {
return apiPost<AdminTaskActionResponse>(`/api/v1/admin/tasks/${taskId}/release-inventory`, {})
}
export function releaseAdminTaskInventoryBinding(taskId: number | string, bindingId: number | string) {
return apiPost<AdminTaskActionResponse>(`/api/v1/admin/tasks/${taskId}/inventory-bindings/${bindingId}/release`, {})
}
export function regenerateAdminTaskClaimLink(taskId: number | string) {
@@ -117,24 +121,36 @@ export function markAdminTaskManualReview(taskId: number | string) {
return apiPost<AdminTaskActionResponse>(`/api/v1/admin/tasks/${taskId}/mark-manual-review`, {})
}
export function fetchAdminCdks(params?: Record<string, unknown>) {
return apiGet<{ items: AdminCdkListItem[]; pagination: AdminPagination }>('/api/v1/admin/cdks', params)
export function completeAdminTaskManualDispatch(
taskId: number | string,
payload: {
outcome: 'delivered' | 'failed'
resultMessage?: string
deliveryReference?: string
deliveredCredential?: string
},
) {
return apiPost<AdminTaskActionResponse>(`/api/v1/admin/tasks/${taskId}/complete-manual-dispatch`, payload)
}
export function importAdminCdks(payload: Record<string, unknown>) {
return apiPost<{ total: number; created: number; duplicated: number }>('/api/v1/admin/cdks/import', payload)
export function fetchAdminInventoryItems(params?: Record<string, unknown>) {
return apiGet<{ items: AdminInventoryItemListItem[]; pagination: AdminPagination }>('/api/v1/admin/inventory', params)
}
export function createAdminCdk(payload: Record<string, unknown>) {
return apiPost<{ cdk: AdminCdkListItem | null }>('/api/v1/admin/cdks', payload)
export function importAdminInventoryItems(payload: Record<string, unknown>) {
return apiPost<{ total: number; created: number; duplicated: number }>('/api/v1/admin/inventory/import', payload)
}
export function releaseAdminInventoryCdk(cdkId: number | string) {
return apiPost<{ cdk: AdminCdkListItem | null }>(`/api/v1/admin/cdks/${cdkId}/release`, {})
export function createAdminInventoryItem(payload: Record<string, unknown>) {
return apiPost<{ inventoryItem: AdminInventoryItemListItem | null }>('/api/v1/admin/inventory', payload)
}
export function invalidateAdminCdk(cdkId: number | string, payload?: Record<string, unknown>) {
return apiPost<{ cdk: AdminCdkListItem | null }>(`/api/v1/admin/cdks/${cdkId}/invalidate`, payload || {})
export function releaseAdminInventoryItem(inventoryItemId: number | string) {
return apiPost<{ inventoryItem: AdminInventoryItemListItem | null }>(`/api/v1/admin/inventory/${inventoryItemId}/release`, {})
}
export function invalidateAdminInventoryItem(inventoryItemId: number | string, payload?: Record<string, unknown>) {
return apiPost<{ inventoryItem: AdminInventoryItemListItem | null }>(`/api/v1/admin/inventory/${inventoryItemId}/invalidate`, payload || {})
}
export function fetchAdminWebhookEvents(params?: Record<string, unknown>) {
+86 -18
View File
@@ -78,6 +78,26 @@ export interface AdminDashboardSummary {
skuWithInventory: number
}
export interface AdminTaskBindingSummary {
totalBindingCount: number
reservedBindingCount: number
consumedBindingCount: number
releasedBindingCount: number
roleKeys: string[]
}
export interface AdminOrderBindingSummary {
totalTaskCount: number
systemBoundTaskCount: number
completedBindingTaskCount: number
totalBindingCount: number
reservedBindingCount: number
consumedBindingCount: number
releasedBindingCount: number
systemBindingStatus: string
userBindingStatus: string
}
export interface AdminOrderListItem {
orderId: number
provider: string
@@ -104,6 +124,10 @@ export interface AdminOrderListItem {
userBindingStatus: string
systemBoundTaskCount: number
completedBindingTaskCount: number
totalBindingCount: number
reservedBindingCount: number
consumedBindingCount: number
releasedBindingCount: number
}
export interface AdminTaskListItem {
@@ -113,6 +137,10 @@ export interface AdminTaskListItem {
skuCode: string
skuName: string
status: string
executorKey: string
deliveryStatus: string
resultCode: string
resultMessage: string
systemBindingStatus: string
userBindingStatus: string
loginType: string
@@ -123,20 +151,23 @@ export interface AdminTaskListItem {
roleConfirmedAt: string | null
redeemedAt: string | null
retryCount: number
bindingSummary: AdminTaskBindingSummary
lastError: string
createdAt: string
updatedAt: string
reservedCdkCodeMasked: string
inventoryDisplayMasked: string
inventoryCredentialType: string
claimToken: string
screenshotPath: string
}
export interface AdminTaskOperations {
canRetry: boolean
canReleaseCdk: boolean
canReleaseInventory: boolean
canRegenerateClaimLink: boolean
canClose: boolean
canMarkManualReview: boolean
canCompleteManualDispatch: boolean
}
export interface AdminTaskActionResponse {
@@ -144,9 +175,11 @@ export interface AdminTaskActionResponse {
taskId: number
taskNo: string
status: string
deliveryStatus: string
resultCode: string
resultMessage: string
inventoryItemId: number | null
claimTokenId: number | null
reservedCdkId?: number | null
primaryClaimTokenId: number | null
lastError: string
updatedAt: string
}
@@ -175,13 +208,7 @@ export interface AdminOrderDetail {
updatedAt: string
itemSummary: string
rawPayload: Record<string, unknown>
bindingSummary: {
totalTaskCount: number
systemBoundTaskCount: number
completedBindingTaskCount: number
systemBindingStatus: string
userBindingStatus: string
}
bindingSummary: AdminOrderBindingSummary
}
items: Array<{
orderItemId: number
@@ -205,6 +232,7 @@ export interface AdminOrderDetail {
redeemedAt: string | null
lastError: string
retryCount: number
bindingSummary: AdminTaskBindingSummary
createdAt: string
updatedAt: string
}>
@@ -238,28 +266,68 @@ export interface AdminTaskDetail {
quantity: number
}
claimToken: null | {
claimTokenId: number
primaryClaimTokenId: number
token: string
status: string
expiredAt: string
}
cdk: null | {
cdkId: number
inventory: null | {
inventoryItemId: number
skuCode: string
batchNo: string
cdkCode: string
credentialType: string
displayValue: string
status: string
}
inventoryBindings: Array<{
bindingId: number
inventoryItemId: number
roleKey: string
quantity: number
bindingStatus: string
inventoryStatus: string
skuCode: string
batchNo: string
credentialType: string
displayValue: string
invalidReason: string
consumedAt: string | null
releasedAt: string | null
createdAt: string
updatedAt: string
metadata: Record<string, unknown>
isPrimary: boolean
canRelease: boolean
}>
artifacts: Record<string, unknown>
screenshotUrl: string
manualDispatch: null | {
outcome: string
deliveryReference: string
deliveredCredential: string
resultMessage: string
completedAt: string | null
completedBy: null | {
userId: number
username: string
role: string
}
}
events: Array<{
eventId: number
eventType: string
payload: Record<string, unknown>
createdAt: string
}>
operations: AdminTaskOperations
}
export interface AdminCdkListItem {
cdkId: number
export interface AdminInventoryItemListItem {
inventoryItemId: number
skuCode: string
batchNo: string
cdkCode: string
credentialType: string
displayValue: string
status: string
reservedByTaskId: number | null
reservedByTaskNo: string
+16 -4
View File
@@ -21,12 +21,14 @@ export function formatAuditAction(action: string) {
admin_user_role_updated: '修改用户角色',
admin_user_status_updated: '修改用户状态',
admin_user_password_reset: '重置用户密码',
task_release_cdk: '释放任务 CDK',
task_release_inventory: '释放任务库存',
task_release_inventory_binding: '释放任务库存绑定',
task_regenerate_claim_link: '重发领取链接',
task_closed: '关闭任务',
task_mark_manual_review: '转人工处理',
inventory_cdk_released: '释放库存 CDK',
inventory_cdk_invalidated: '作废库存 CDK',
task_complete_manual_dispatch: '完成人工履约',
inventory_item_released: '释放库存项',
inventory_item_invalidated: '作废库存项',
webhook_replayed: '重放 Webhook',
platform_shop_config_updated: '更新店铺配置',
}
@@ -38,10 +40,20 @@ export function formatAuditTargetType(targetType: string) {
const labelMap: Record<string, string> = {
admin_user: '后台用户',
task: '交付任务',
cdk: 'CDK 库存',
task_inventory_binding: '任务库存绑定',
inventory_item: '库存项',
webhook_event: 'Webhook 事件',
platform_config: '平台配置',
}
return formatStatusWithRaw(targetType, labelMap)
}
export function formatTaskEventType(eventType: string) {
const labelMap: Record<string, string> = {
manual_dispatch_completed: '人工履约已回写',
inventory_binding_released: '库存绑定已释放',
}
return formatStatusWithRaw(eventType, labelMap)
}
+5 -5
View File
@@ -23,7 +23,7 @@ export const adminTaskStatusOptions = [
{ label: '已关闭', value: 'closed' },
]
export const adminCdkStatusOptions = [
export const adminInventoryStatusOptions = [
{ label: '全部', value: '' },
{ label: '可用', value: 'available' },
{ label: '已预占', value: 'reserved' },
@@ -55,12 +55,12 @@ export const adminAuditActionOptions = [
{ label: '修改用户角色', value: 'admin_user_role_updated' },
{ label: '修改用户状态', value: 'admin_user_status_updated' },
{ label: '重置用户密码', value: 'admin_user_password_reset' },
{ label: '释放任务 CDK', value: 'task_release_cdk' },
{ label: '释放任务库存', value: 'task_release_inventory' },
{ label: '重发领取链接', value: 'task_regenerate_claim_link' },
{ label: '关闭任务', value: 'task_closed' },
{ label: '转人工处理', value: 'task_mark_manual_review' },
{ label: '释放库存 CDK', value: 'inventory_cdk_released' },
{ label: '作废库存 CDK', value: 'inventory_cdk_invalidated' },
{ label: '释放库存', value: 'inventory_item_released' },
{ label: '作废库存', value: 'inventory_item_invalidated' },
{ label: '重放 Webhook', value: 'webhook_replayed' },
]
@@ -68,6 +68,6 @@ export const adminAuditTargetTypeOptions = [
{ label: '全部', value: '' },
{ label: '后台用户', value: 'admin_user' },
{ label: '交付任务', value: 'task' },
{ label: 'CDK 库存', value: 'cdk' },
{ label: '库存', value: 'inventory_item' },
{ label: 'Webhook 事件', value: 'webhook_event' },
]
@@ -4,10 +4,10 @@ import { ElMessage, ElMessageBox } from 'element-plus'
import AdminPaginationBar from '@/components/admin/AdminPaginationBar.vue'
import AdminStatusTag from '@/components/admin/AdminStatusTag.vue'
import { createAdminCdk, fetchAdminCdks, importAdminCdks, invalidateAdminCdk, releaseAdminInventoryCdk } from '@/services/admin'
import type { AdminCdkListItem, AdminPagination } from '@/types/admin'
import { createAdminInventoryItem, fetchAdminInventoryItems, importAdminInventoryItems, invalidateAdminInventoryItem, releaseAdminInventoryItem } from '@/services/admin'
import type { AdminInventoryItemListItem, AdminPagination } from '@/types/admin'
import { hasAdminRole } from '@/utils/admin-auth'
import { adminCdkStatusOptions } from '@/utils/admin-options'
import { adminInventoryStatusOptions } from '@/utils/admin-options'
const loading = ref(true)
const importing = ref(false)
@@ -18,20 +18,20 @@ const skuCode = ref('')
const status = ref('')
const batchNo = ref('')
const bulkText = ref('')
const singleCdkCode = ref('')
const items = ref<AdminCdkListItem[]>([])
const singleDisplayValue = ref('')
const items = ref<AdminInventoryItemListItem[]>([])
const pagination = ref<AdminPagination>({
page: 1,
pageSize: 20,
total: 0,
})
async function loadCdks(page = pagination.value.page) {
async function loadInventoryItems(page = pagination.value.page) {
loading.value = true
errorMessage.value = ''
try {
const response = await fetchAdminCdks({
const response = await fetchAdminInventoryItems({
page,
pageSize: pagination.value.pageSize,
skuCode: skuCode.value.trim(),
@@ -41,32 +41,32 @@ async function loadCdks(page = pagination.value.page) {
items.value = response.data.items
pagination.value = response.data.pagination
} catch (error) {
errorMessage.value = error instanceof Error ? error.message : '读取 CDK 列表失败'
errorMessage.value = error instanceof Error ? error.message : '读取库存列表失败'
} finally {
loading.value = false
}
}
async function submitCreate() {
if (!skuCode.value.trim() || !singleCdkCode.value.trim()) {
ElMessage.error('请填写 SKU 和单条 CDK')
if (!skuCode.value.trim() || !singleDisplayValue.value.trim()) {
ElMessage.error('请填写 SKU 和库存凭据')
return
}
creating.value = true
try {
await createAdminCdk({
await createAdminInventoryItem({
skuCode: skuCode.value.trim(),
batchNo: batchNo.value.trim(),
cdkCode: singleCdkCode.value.trim(),
displayValue: singleDisplayValue.value.trim(),
})
ElMessage.success('CDK 已新增')
singleCdkCode.value = ''
await loadCdks()
ElMessage.success('库存项已新增')
singleDisplayValue.value = ''
await loadInventoryItems()
} catch (error) {
ElMessage.error(error instanceof Error ? error.message : '新增 CDK 失败')
ElMessage.error(error instanceof Error ? error.message : '新增库存项失败')
} finally {
creating.value = false
}
@@ -79,14 +79,14 @@ async function submitImport() {
.filter(Boolean)
if (!skuCode.value.trim() || codes.length === 0) {
ElMessage.error('请填写 SKU 并输入至少一条 CDK')
ElMessage.error('请填写 SKU 并输入至少一条库存凭据')
return
}
importing.value = true
try {
const response = await importAdminCdks({
const response = await importAdminInventoryItems({
skuCode: skuCode.value.trim(),
batchNo: batchNo.value.trim(),
codes,
@@ -94,7 +94,7 @@ async function submitImport() {
ElMessage.success(`导入完成,新增 ${response.data.created}`)
bulkText.value = ''
await loadCdks()
await loadInventoryItems()
} catch (error) {
ElMessage.error(error instanceof Error ? error.message : '导入失败')
} finally {
@@ -102,7 +102,7 @@ async function submitImport() {
}
}
async function runRowAction(cdkId: number, action: () => Promise<unknown>, successMessage: string, confirmText: string) {
async function runRowAction(inventoryItemId: number, action: () => Promise<unknown>, successMessage: string, confirmText: string) {
try {
await ElMessageBox.confirm(confirmText, '确认操作', {
type: 'warning',
@@ -113,12 +113,12 @@ async function runRowAction(cdkId: number, action: () => Promise<unknown>, succe
return
}
actionLoadingId.value = cdkId
actionLoadingId.value = inventoryItemId
try {
await action()
ElMessage.success(successMessage)
await loadCdks()
await loadInventoryItems()
} catch (error) {
ElMessage.error(error instanceof Error ? error.message : '操作失败')
} finally {
@@ -126,15 +126,15 @@ async function runRowAction(cdkId: number, action: () => Promise<unknown>, succe
}
}
onMounted(loadCdks)
onMounted(loadInventoryItems)
</script>
<template>
<section class="admin-panel">
<header class="panel-header">
<div>
<h1>CDK 管理</h1>
<p>查看库存快速新增 CDK并处理预占或失效库存</p>
<h1>库存管理</h1>
<p>查看库存快速新增凭据并处理预占或失效库存</p>
</div>
</header>
@@ -142,28 +142,28 @@ onMounted(loadCdks)
<div class="form-row">
<input v-model="skuCode" class="text-input" placeholder="SKU,例如 dnf-cdk-a" />
<select v-model="status" class="text-input select-input">
<option v-for="option in adminCdkStatusOptions" :key="option.value" :value="option.value">
<option v-for="option in adminInventoryStatusOptions" :key="option.value" :value="option.value">
{{ option.label }}
</option>
</select>
<input v-model="batchNo" class="text-input" placeholder="批次号筛选/导入批次号" />
<el-button round @click="() => loadCdks()">查询列表</el-button>
<el-button round @click="() => loadInventoryItems()">查询列表</el-button>
</div>
<div class="form-row form-row-top">
<input v-model="singleCdkCode" class="text-input" placeholder="单条新增 CDK" />
<input v-model="singleDisplayValue" class="text-input" placeholder="单条新增库存凭据" />
<el-button :loading="creating" round type="success" @click="submitCreate">单条新增</el-button>
<el-button :loading="importing" round type="primary" @click="submitImport">批量导入</el-button>
</div>
<textarea
v-model="bulkText"
class="text-area"
placeholder="每行一个 CDK"
placeholder="每行一个库存凭据"
/>
</section>
<p v-if="errorMessage" class="error-copy">{{ errorMessage }}</p>
<div v-if="loading" class="empty-block">CDK 列表加载中</div>
<div v-if="loading" class="empty-block">库存列表加载中</div>
<div v-else class="table-card">
<table class="data-table">
@@ -176,13 +176,13 @@ onMounted(loadCdks)
<th>订单号</th>
<th>预占任务</th>
<th>失效原因</th>
<th>CDK</th>
<th>凭据内容</th>
<th>操作</th>
</tr>
</thead>
<tbody>
<tr v-for="item in items" :key="item.cdkId">
<td>{{ item.cdkId }}</td>
<tr v-for="item in items" :key="item.inventoryItemId">
<td>{{ item.inventoryItemId }}</td>
<td>{{ item.skuCode }}</td>
<td>{{ item.batchNo || '-' }}</td>
<td>
@@ -195,23 +195,23 @@ onMounted(loadCdks)
<td>{{ item.platformOrderId || '-' }}</td>
<td>{{ item.reservedByTaskNo || item.reservedByTaskId || '-' }}</td>
<td>{{ item.invalidReason || '-' }}</td>
<td>{{ item.cdkCode }}</td>
<td>{{ item.displayValue }}</td>
<td>
<div class="action-stack">
<el-button
v-if="hasAdminRole('admin') && item.status === 'reserved'"
:loading="actionLoadingId === item.cdkId"
:loading="actionLoadingId === item.inventoryItemId"
link
@click="runRowAction(item.cdkId, () => releaseAdminInventoryCdk(item.cdkId), 'CDK 已释放', `确认释放 CDK ${item.cdkCode} 吗?`)"
@click="runRowAction(item.inventoryItemId, () => releaseAdminInventoryItem(item.inventoryItemId), '库存项已释放', `确认释放库存凭据 ${item.displayValue} 吗?`)"
>
释放
</el-button>
<el-button
v-if="hasAdminRole('admin') && item.status === 'available'"
:loading="actionLoadingId === item.cdkId"
:loading="actionLoadingId === item.inventoryItemId"
link
type="danger"
@click="runRowAction(item.cdkId, () => invalidateAdminCdk(item.cdkId, { reason: '后台手动作废' }), 'CDK 已作废', `确认作废 CDK ${item.cdkCode} 吗?作废后不会再参与分配。`)"
@click="runRowAction(item.inventoryItemId, () => invalidateAdminInventoryItem(item.inventoryItemId, { reason: '后台手动作废' }), '库存项已作废', `确认作废库存凭据 ${item.displayValue} 吗?作废后不会再参与分配。`)"
>
作废
</el-button>
@@ -225,7 +225,7 @@ onMounted(loadCdks)
:page-size="pagination.pageSize"
:total="pagination.total"
:loading="loading"
@change="loadCdks"
@change="loadInventoryItems"
/>
</div>
</section>
@@ -14,7 +14,7 @@ const navItems = computed(() => {
{ to: '/admin/dashboard', label: '概览' },
{ to: '/admin/orders', label: '订单' },
{ to: '/admin/tasks', label: '任务' },
{ to: '/admin/cdks', label: 'CDK' },
{ to: '/admin/inventory', label: '库存' },
{ to: '/admin/webhook-events', label: 'Webhook' },
]
@@ -36,6 +36,15 @@ function formatSpecSummary(spec: Record<string, unknown>) {
return entries.length > 0 ? entries.join(' | ') : '-'
}
function formatBindingRoleSummary(roleKeys: string[]) {
return Array.isArray(roleKeys) && roleKeys.length > 0 ? roleKeys.join(' / ') : '-'
}
function formatTaskBindingCountSummary(task: AdminOrderDetail['tasks'][number]) {
const summary = task.bindingSummary
return `${summary.totalBindingCount} 条 · 预占 ${summary.reservedBindingCount} · 已消费 ${summary.consumedBindingCount} · 已释放 ${summary.releasedBindingCount}`
}
</script>
<template>
@@ -91,6 +100,11 @@ function formatSpecSummary(spec: Record<string, unknown>) {
<strong>{{ detail.order.bindingSummary.completedBindingTaskCount }}/{{ detail.order.bindingSummary.totalTaskCount }} 完整绑定</strong>
<small>{{ detail.order.bindingSummary.systemBoundTaskCount }}/{{ detail.order.bindingSummary.totalTaskCount }} 系统绑定</small>
</article>
<article class="info-tile">
<span>库存绑定</span>
<strong>{{ detail.order.bindingSummary.totalBindingCount }} 条绑定记录</strong>
<small>预占 {{ detail.order.bindingSummary.reservedBindingCount }} · 已消费 {{ detail.order.bindingSummary.consumedBindingCount }} · 已释放 {{ detail.order.bindingSummary.releasedBindingCount }}</small>
</article>
</div>
<table class="meta-table">
@@ -137,6 +151,7 @@ function formatSpecSummary(spec: Record<string, unknown>) {
<th>状态</th>
<th>系统绑定</th>
<th>完整绑定</th>
<th>库存绑定</th>
<th>登录方式</th>
<th>错误</th>
</tr>
@@ -149,6 +164,10 @@ function formatSpecSummary(spec: Record<string, unknown>) {
<td><AdminStatusTag :status="task.status" /></td>
<td><AdminStatusTag :status="task.systemBindingStatus" /></td>
<td><AdminStatusTag :status="task.userBindingStatus" /></td>
<td>
<div>{{ formatTaskBindingCountSummary(task) }}</div>
<div class="binding-copy">角色 {{ formatBindingRoleSummary(task.bindingSummary.roleKeys) }}</div>
</td>
<td>{{ task.loginType || '-' }}</td>
<td>{{ task.lastError || '-' }}</td>
</tr>
@@ -248,6 +267,11 @@ function formatSpecSummary(spec: Record<string, unknown>) {
.info-tile strong {
color: #1d3555;
}
.binding-copy {
margin-top: 6px;
color: #64748b;
font-size: 12px;
}
.meta-table,
.data-table { width: 100%; border-collapse: collapse; }
.meta-table th,
@@ -1,20 +1,22 @@
<script setup lang="ts">
import { onBeforeUnmount, onMounted, ref } from 'vue'
import { onBeforeUnmount, onMounted, reactive, ref } from 'vue'
import { useRoute } from 'vue-router'
import { ElMessage, ElMessageBox } from 'element-plus'
import AdminStatusTag from '@/components/admin/AdminStatusTag.vue'
import {
closeAdminTask,
completeAdminTaskManualDispatch,
fetchAdminTaskScreenshot,
fetchAdminTaskDetail,
markAdminTaskManualReview,
regenerateAdminTaskClaimLink,
releaseAdminTaskCdk,
releaseAdminTaskInventoryBinding,
retryAdminTask,
} from '@/services/admin'
import type { AdminTaskActionResponse, AdminTaskDetail } from '@/types/admin'
import { hasAdminRole } from '@/utils/admin-auth'
import { formatTaskEventType } from '@/utils/admin-display'
import { formatAdminDateTime } from '@/utils/admin-time'
const route = useRoute()
@@ -24,6 +26,11 @@ const errorMessage = ref('')
const detail = ref<AdminTaskDetail | null>(null)
const lastClaimUrl = ref('')
const screenshotPreviewUrl = ref('')
const manualDispatchForm = reactive({
deliveryReference: '',
deliveredCredential: '',
resultMessage: '',
})
async function loadDetail() {
loading.value = true
@@ -32,6 +39,7 @@ async function loadDetail() {
try {
const response = await fetchAdminTaskDetail(String(route.params.taskId || ''))
detail.value = response.data
syncManualDispatchForm(response.data)
await loadScreenshotPreview(response.data)
} catch (error) {
errorMessage.value = error instanceof Error ? error.message : '读取任务详情失败'
@@ -93,6 +101,49 @@ function clearScreenshotPreview() {
}
}
function syncManualDispatchForm(taskDetail: AdminTaskDetail) {
manualDispatchForm.deliveryReference = taskDetail.manualDispatch?.deliveryReference || ''
manualDispatchForm.deliveredCredential = taskDetail.manualDispatch?.deliveredCredential || ''
manualDispatchForm.resultMessage = taskDetail.manualDispatch?.resultMessage || taskDetail.task.resultMessage || ''
}
async function submitManualDispatch(outcome: 'delivered' | 'failed') {
if (!detail.value) {
return
}
const actionLabel = outcome === 'failed' ? '标记履约失败' : '标记已完成履约'
const confirmText = outcome === 'failed'
? `确认把任务 ${detail.value.task.taskNo} 回写为人工履约失败吗?这会把任务直接收口并保留失败原因。`
: `确认把任务 ${detail.value.task.taskNo} 回写为人工履约完成吗?这会把任务直接标记为已发放。`
await runAction(
() => completeAdminTaskManualDispatch(detail.value!.task.taskId, {
outcome,
resultMessage: manualDispatchForm.resultMessage,
deliveryReference: manualDispatchForm.deliveryReference,
deliveredCredential: manualDispatchForm.deliveredCredential,
}),
actionLabel,
confirmText,
)
}
function formatTaskEventPayload(payload: Record<string, unknown>) {
const parts = [
payload.outcome ? `结果 ${payload.outcome}` : '',
payload.resultCode ? `代码 ${payload.resultCode}` : '',
payload.resultMessage ? `说明 ${payload.resultMessage}` : '',
payload.deliveryReference ? `单号 ${payload.deliveryReference}` : '',
].filter(Boolean)
if (parts.length > 0) {
return parts.join(' · ')
}
return JSON.stringify(payload || {})
}
onMounted(loadDetail)
onBeforeUnmount(clearScreenshotPreview)
</script>
@@ -113,6 +164,7 @@ onBeforeUnmount(clearScreenshotPreview)
<section class="info-card">
<h2>{{ detail.task.taskNo }}</h2>
<p>状态<AdminStatusTag :status="detail.task.status" /> · 订单{{ detail.order?.platformOrderId || '-' }}</p>
<p>执行器{{ detail.task.executorKey || '-' }} · 履约<AdminStatusTag :status="detail.task.deliveryStatus" /></p>
<p>系统绑定<AdminStatusTag :status="detail.task.systemBindingStatus" /> · 完整绑定<AdminStatusTag :status="detail.task.userBindingStatus" /></p>
<p>角色{{ detail.task.roleName || '-' }} / {{ detail.task.roleId || '-' }}</p>
<p>最后错误{{ detail.task.lastError || '-' }}</p>
@@ -129,15 +181,6 @@ onBeforeUnmount(clearScreenshotPreview)
>
重试任务
</el-button>
<el-button
v-if="hasAdminRole('admin')"
:disabled="!detail.operations.canReleaseCdk"
:loading="actionLoading"
round
@click="runAction(() => releaseAdminTaskCdk(detail!.task.taskId), 'CDK 已释放', `确认释放任务 ${detail!.task.taskNo} 当前预占的 CDK 吗?`)"
>
释放 CDK
</el-button>
<el-button
v-if="hasAdminRole('admin')"
:disabled="!detail.operations.canRegenerateClaimLink"
@@ -156,6 +199,25 @@ onBeforeUnmount(clearScreenshotPreview)
>
转人工
</el-button>
<el-button
v-if="hasAdminRole('admin') && detail.operations.canCompleteManualDispatch"
:loading="actionLoading"
round
type="success"
@click="submitManualDispatch('delivered')"
>
人工完成
</el-button>
<el-button
v-if="hasAdminRole('admin') && detail.operations.canCompleteManualDispatch"
:loading="actionLoading"
round
type="danger"
plain
@click="submitManualDispatch('failed')"
>
履约失败
</el-button>
<el-button
v-if="hasAdminRole('admin')"
:disabled="!detail.operations.canClose"
@@ -174,8 +236,13 @@ onBeforeUnmount(clearScreenshotPreview)
<tbody>
<tr><th>商品</th><td>{{ detail.orderItem?.skuName || '-' }}</td></tr>
<tr><th>SKU</th><td>{{ detail.orderItem?.skuCode || '-' }}</td></tr>
<tr><th>预占 CDK</th><td>{{ detail.cdk?.cdkCode || '-' }}</td></tr>
<tr><th>CDK 状态</th><td><AdminStatusTag :status="detail.cdk?.status || ''" /></td></tr>
<tr><th>任务执行器</th><td>{{ detail.task.executorKey || '-' }}</td></tr>
<tr><th>履约状态</th><td><AdminStatusTag :status="detail.task.deliveryStatus || ''" /></td></tr>
<tr><th>结果代码</th><td>{{ detail.task.resultCode || '-' }}</td></tr>
<tr><th>结果说明</th><td>{{ detail.task.resultMessage || '-' }}</td></tr>
<tr><th>库存凭据</th><td>{{ detail.inventory?.displayValue || '-' }}</td></tr>
<tr><th>凭据类型</th><td>{{ detail.inventory?.credentialType || '-' }}</td></tr>
<tr><th>库存状态</th><td><AdminStatusTag :status="detail.inventory?.status || ''" /></td></tr>
<tr><th>Claim Token</th><td>{{ detail.claimToken?.token || '-' }}</td></tr>
<tr><th>Token 状态</th><td><AdminStatusTag :status="detail.claimToken?.status || ''" /></td></tr>
<tr><th>Token 过期</th><td>{{ formatAdminDateTime(detail.claimToken?.expiredAt) }}</td></tr>
@@ -188,6 +255,129 @@ onBeforeUnmount(clearScreenshotPreview)
</table>
</section>
<section class="table-card">
<h3>库存绑定</h3>
<p class="section-copy">这里展示任务当前和历史绑定过的库存项便于核对多库存任务的真实履约轨迹</p>
<table class="data-table">
<thead>
<tr>
<th>绑定</th>
<th>角色</th>
<th>库存项</th>
<th>状态</th>
<th>凭据内容</th>
<th>时间</th>
<th>操作</th>
</tr>
</thead>
<tbody>
<tr v-if="detail.inventoryBindings.length === 0">
<td colspan="7" class="table-empty">当前任务还没有库存绑定记录</td>
</tr>
<tr v-for="binding in detail.inventoryBindings" :key="binding.bindingId">
<td>
<div>#{{ binding.bindingId }}</div>
<div v-if="binding.isPrimary" class="binding-primary">主库存项</div>
</td>
<td>
<div>{{ binding.roleKey || '-' }}</div>
<div class="binding-meta">数量 {{ binding.quantity }}</div>
</td>
<td>
<div>ID {{ binding.inventoryItemId }}</div>
<div>{{ binding.skuCode || '-' }}</div>
<div class="binding-meta">{{ binding.credentialType || '-' }} · {{ binding.batchNo || '无批次' }}</div>
</td>
<td>
<div class="status-stack">
<AdminStatusTag :status="binding.bindingStatus" />
<AdminStatusTag :status="binding.inventoryStatus" />
</div>
<div v-if="binding.invalidReason" class="binding-meta">作废原因{{ binding.invalidReason }}</div>
</td>
<td>{{ binding.displayValue || '-' }}</td>
<td>
<div>绑定 {{ formatAdminDateTime(binding.createdAt) }}</div>
<div class="binding-meta">消费 {{ formatAdminDateTime(binding.consumedAt) }}</div>
<div class="binding-meta">释放 {{ formatAdminDateTime(binding.releasedAt) }}</div>
</td>
<td>
<el-button
v-if="hasAdminRole('admin') && binding.canRelease"
:loading="actionLoading"
link
@click="runAction(
() => releaseAdminTaskInventoryBinding(detail!.task.taskId, binding.bindingId),
'库存绑定已释放',
`确认释放绑定 #${binding.bindingId} 对应的库存项 ${binding.displayValue || binding.inventoryItemId} 吗?`
)"
>
释放绑定
</el-button>
<span v-else class="binding-meta">-</span>
</td>
</tr>
</tbody>
</table>
</section>
<section v-if="detail.task.executorKey === 'manual_dispatch'" class="table-card">
<h3>人工履约回写</h3>
<div class="manual-grid">
<label class="field-block">
<span>外部流水 / 单号</span>
<el-input
v-model="manualDispatchForm.deliveryReference"
maxlength="120"
placeholder="例如快递单号、平台消息回执号"
/>
</label>
<label class="field-block">
<span>已交付内容</span>
<el-input
v-model="manualDispatchForm.deliveredCredential"
maxlength="500"
placeholder="可填写人工发送的卡密、链接或关键信息"
type="textarea"
:rows="3"
/>
</label>
<label class="field-block">
<span>处理备注</span>
<el-input
v-model="manualDispatchForm.resultMessage"
maxlength="500"
placeholder="说明实际履约结果,失败时建议写清原因"
type="textarea"
:rows="4"
/>
</label>
</div>
<p class="manual-hint">回写后会直接更新任务终态不再走旧式领取链接流程</p>
<div v-if="detail.manualDispatch" class="manual-summary">
<p>最近回写<AdminStatusTag :status="detail.manualDispatch.outcome || detail.task.deliveryStatus" /> · {{ formatAdminDateTime(detail.manualDispatch.completedAt) }}</p>
<p>处理人{{ detail.manualDispatch.completedBy?.username || '-' }} / {{ detail.manualDispatch.completedBy?.role || '-' }}</p>
<p>流水号{{ detail.manualDispatch.deliveryReference || '-' }}</p>
<p>交付内容{{ detail.manualDispatch.deliveredCredential || '-' }}</p>
<p>备注{{ detail.manualDispatch.resultMessage || '-' }}</p>
</div>
</section>
<section v-if="detail.events.length > 0" class="table-card">
<h3>任务事件</h3>
<table class="data-table">
<tbody>
<tr v-for="event in detail.events" :key="event.eventId">
<th>{{ formatTaskEventType(event.eventType) }}</th>
<td>
<div class="event-copy">{{ formatTaskEventPayload(event.payload) }}</div>
<div class="event-time">{{ formatAdminDateTime(event.createdAt) }}</div>
</td>
</tr>
</tbody>
</table>
</section>
<section v-if="detail.screenshotUrl" class="table-card">
<h3>结果截图</h3>
<p v-if="!screenshotPreviewUrl" class="screenshot-empty">截图加载中或当前不可读取</p>
@@ -208,9 +398,22 @@ onBeforeUnmount(clearScreenshotPreview)
.error-copy { color: #b42318; }
.action-row { display: flex; flex-wrap: wrap; gap: 12px; }
.table-card h3 { margin: 0 0 12px; color: #1d3555; }
.section-copy { margin: 0 0 12px; color: #64748b; }
.data-table { width: 100%; border-collapse: collapse; }
.data-table th,.data-table td { padding: 12px 10px; text-align: left; border-bottom: 1px solid rgba(86,108,138,.08); }
.data-table th { width: 160px; color: #64748b; }
.status-stack { display: flex; flex-wrap: wrap; gap: 8px; }
.table-empty { text-align: center; color: #64748b; }
.binding-primary { margin-top: 4px; color: #0f766e; font-size: 12px; font-weight: 600; }
.binding-meta { margin-top: 4px; color: #64748b; font-size: 12px; }
.manual-grid { display: grid; gap: 14px; }
.field-block { display: grid; gap: 8px; color: #1d3555; font-weight: 600; }
.manual-hint { margin: 14px 0 0; color: #64748b; }
.manual-summary { margin-top: 16px; padding: 14px; border-radius: 16px; background: rgba(248,250,252,.9); }
.manual-summary p { margin: 0 0 8px; color: #334155; }
.manual-summary p:last-child { margin-bottom: 0; }
.event-copy { color: #334155; }
.event-time { margin-top: 6px; color: #64748b; font-size: 12px; }
.screenshot-link { display: inline-block; margin-bottom: 12px; color: #175cd3; text-decoration: none; }
.screenshot-empty { margin: 0 0 12px; color: #64748b; }
.screenshot-preview {
@@ -9,7 +9,6 @@ import {
fetchAdminTasks,
markAdminTaskManualReview,
regenerateAdminTaskClaimLink,
releaseAdminTaskCdk,
retryAdminTask,
} from '@/services/admin'
import type { AdminPagination, AdminTaskActionResponse, AdminTaskListItem } from '@/types/admin'
@@ -34,7 +33,7 @@ const pagination = ref<AdminPagination>({
total: 0,
})
type AdminTaskActionKey = 'retry' | 'regenerate_claim_link' | 'release_cdk' | 'manual_review' | 'close'
type AdminTaskActionKey = 'retry' | 'regenerate_claim_link' | 'manual_review' | 'close'
async function loadTasks(page = pagination.value.page) {
loading.value = true
@@ -60,6 +59,21 @@ async function loadTasks(page = pagination.value.page) {
}
}
function formatBindingRoles(item: AdminTaskListItem) {
const roles = item.bindingSummary.roleKeys
if (!Array.isArray(roles) || roles.length === 0) {
return '无绑定角色'
}
return roles.join(' / ')
}
function formatBindingCountSummary(item: AdminTaskListItem) {
const summary = item.bindingSummary
return `${summary.totalBindingCount} 条 · 预占 ${summary.reservedBindingCount} · 已消费 ${summary.consumedBindingCount} · 已释放 ${summary.releasedBindingCount}`
}
function closeActionMenu() {
openedActionTaskId.value = null
}
@@ -139,16 +153,6 @@ function handleActionCommand(command: `${AdminTaskActionKey}:${number}`) {
return
}
if (actionKey === 'release_cdk') {
void runAction(
item.taskId,
() => releaseAdminTaskCdk(item.taskId),
'CDK 已释放',
`确认释放任务 ${item.taskNo} 当前预占的 CDK 吗?`,
)
return
}
if (actionKey === 'manual_review') {
void runAction(
item.taskId,
@@ -173,7 +177,7 @@ function handleActionCommand(command: `${AdminTaskActionKey}:${number}`) {
<header class="panel-header">
<div>
<h1>交付任务</h1>
<p>查看交付状态角色识别预占 CDK 和错误信息</p>
<p>查看交付状态角色识别库存凭据分配和错误信息</p>
</div>
</header>
@@ -212,7 +216,7 @@ function handleActionCommand(command: `${AdminTaskActionKey}:${number}`) {
<tr>
<th>任务信息</th>
<th>任务进度</th>
<th>商品 / CDK</th>
<th>商品 / 凭据</th>
<th>角色绑定</th>
<th>错误</th>
<th>操作</th>
@@ -249,7 +253,15 @@ function handleActionCommand(command: `${AdminTaskActionKey}:${number}`) {
<div class="goods-cell">
<span class="goods-title" :title="item.skuName || item.skuCode">{{ item.skuName || item.skuCode }}</span>
<span class="goods-subline">SKU {{ item.skuCode || '-' }}</span>
<span class="goods-subline" :title="item.reservedCdkCodeMasked || '-'">CDK {{ item.reservedCdkCodeMasked || '-' }}</span>
<span class="goods-subline" :title="item.inventoryDisplayMasked || '-'">
凭据 {{ item.inventoryDisplayMasked || '-' }}
</span>
<span class="goods-subline" :title="formatBindingRoles(item)">
绑定 {{ formatBindingRoles(item) }}
</span>
<span class="goods-subline goods-subline-strong" :title="formatBindingCountSummary(item)">
{{ formatBindingCountSummary(item) }}
</span>
</div>
</td>
<td>
@@ -265,6 +277,7 @@ function handleActionCommand(command: `${AdminTaskActionKey}:${number}`) {
<td>
<div class="action-cell">
<el-button
:disabled="item.executorKey === 'manual_dispatch' || !['retry_pending', 'manual_review', 'waiting_inventory'].includes(item.status)"
:loading="actionLoadingId === item.taskId"
class="primary-action"
plain
@@ -283,12 +296,14 @@ function handleActionCommand(command: `${AdminTaskActionKey}:${number}`) {
<span class="dropdown-icon">{{ openedActionTaskId === item.taskId ? '▴' : '▾' }}</span>
</el-button>
<div v-if="openedActionTaskId === item.taskId" class="more-action-menu">
<button class="menu-action-button" type="button" @click="handleActionCommand(`regenerate_claim_link:${item.taskId}`)">
<button
v-if="item.executorKey !== 'manual_dispatch'"
class="menu-action-button"
type="button"
@click="handleActionCommand(`regenerate_claim_link:${item.taskId}`)"
>
重发链接
</button>
<button class="menu-action-button" type="button" @click="handleActionCommand(`release_cdk:${item.taskId}`)">
释放 CDK
</button>
<button class="menu-action-button" type="button" @click="handleActionCommand(`manual_review:${item.taskId}`)">
转人工
</button>
@@ -450,6 +465,11 @@ function handleActionCommand(command: `${AdminTaskActionKey}:${number}`) {
color: #98a2b3;
}
.goods-subline-strong {
color: #1d3555;
font-weight: 600;
}
.cell-error {
display: -webkit-box;
overflow: hidden;
+126 -25
View File
@@ -21,7 +21,8 @@
- 新 schema 已经使用 `fulfillment_* / inventory_items / task_inventory_bindings`
- 核心 service 主链路已经开始直接使用“主 token / 主库存绑定”语义
- 边角脚本、前端命名和少量后台返回结构仍处于过渡期
- admin/public 资源名已经切到 `inventory`
- 剩余工作主要集中在“多库存绑定能力上浮”和“测试/种子数据体系化”
## 当前真实架构
@@ -51,7 +52,7 @@
### 1. 通用履约模型已经落库
当前迁移文件已经不再围绕旧式单 CDK 模型设计,而是引入了:
当前迁移文件已经不再围绕旧式单库存码模型设计,而是引入了:
- `fulfillment_profiles`
- `fulfillment_profile_requirements`
@@ -88,7 +89,7 @@
- users
- orders
- tasks
- cdks
- inventory
- webhook-events
- platform-config
@@ -105,44 +106,144 @@
另外,`claimed_at / role_confirmed_at / redeemed_at` 这些任务时间字段现在也已真正通过 repository 落库,不再只是 service 层表面传值。
### 5. 本地 Docker 开发栈已经重新打通
当前开发 Compose 已改为:
- `postgres` 提供开发数据库
- backend 通过 `DATABASE_URL` 连接 PostgreSQL
- 启动时自动执行 migration 与 bootstrap
这轮还顺手修掉了一个启动顺序问题:
- 之前 backend 启动时没有等待 migration 完成,就先执行 fulfillment catalog bootstrap
- 现已改为先 `await runDatabaseMigrations()`,再继续后续初始化
本地验证结果:
- `docker compose -f docker-compose.dev.yml` 可拉起 `postgres / backend / frontend / web`
- `/health` 可正常返回
- admin 登录可用
- `GET /api/v1/admin/tasks` 已能正常鉴权并返回结果
### 6. `manual_dispatch` 已具备完整人工履约闭环
当前 `manual_dispatch` 不再只是把任务停在 `manual_review`,而是已经补齐成新的正式履约路径:
- paid 后的人工履约任务会进入 `manual_review`
- admin 新增 `POST /api/v1/admin/tasks/:taskId/complete-manual-dispatch`
- 支持把人工履约结果明确回写为 `delivered``failed`
- 结果会写入 `task_status / delivery_status / result_code / result_message / context_json`
- 如果任务绑定了库存凭据,人工完成时也会同步把库存置为 consumed
- `task_events` 已开始记录人工履约完成事件
同时,人工履约任务已经不再允许误走旧自动链路:
- 不再允许对 `manual_dispatch` 执行自动重试
- 不再允许为 `manual_dispatch` 重新生成领取链接
- admin 详情页已补上人工履约回写表单与结果展示
### 7. admin 任务接口开始去除旧 `CDK` 过渡命名
这一轮继续把任务侧接口往新模型对齐:
- 任务释放入口已改为 `release-inventory`
- 任务 action payload 不再返回 `reservedCdkId`
- 主领取 token 字段统一为 `primaryClaimTokenId`
- 前端任务详情/列表不再依赖 `reservedCdkCodeMasked``cdk` 兼容对象
当前任务管理界面已经优先使用:
- `inventoryItemId`
- `inventory.displayValue`
- `inventory.credentialType`
- `primaryClaimTokenId`
### 8. admin 库存管理域已经切到 `inventory` 资源名
这一轮把库存管理域的外层入口也继续切到新模型:
- 后端 admin API 已从 `/api/v1/admin/cdks` 切到 `/api/v1/admin/inventory`
- 前端后台路由已从 `/admin/cdks` 切到 `/admin/inventory`
- 库存管理页面、导航、审计 action、targetType 已统一改为库存项语义
- 库存列表返回结构已改为 `inventoryItemId / displayValue / credentialType`
现在从 URL、页面和 admin payload 角度,库存域已经不再把资源本身暴露成旧 `cdk` 名称。
### 9. 后端内部 `cdk` 命名主链路已经收口到 `inventory`
这轮已经把后端主链路里的历史命名继续清理掉:
- `repositories/cdk-repo.js` 已收口为 `repositories/inventory-repo.js`
- `services/order/cdk-service.js` 已收口为 `services/order/inventory-service.js`
- admin / claim / delivery 主链路已改用 `getInventoryItemById / reserveInventoryForTask / releaseReservedInventoryItem` 等命名
- 任务错误文案已统一改成“库存项 / 库存凭据”语义
现在 `apps/backend/src` 主干里已经不再保留旧 `cdk-*` 仓储与服务文件名。
### 10. 开发种子数据入口已经补上
这轮已经补上新的开发数据入口,不再只能靠手工 webhook 或临时 SQL 验证:
- 新增 `apps/backend/scripts/seed-dev-data.js`
- 新增 `npm run seed:dev-data`
- 支持 `--apply --reset` 先清库再重建固定场景
- 当前已覆盖:
- `manual_pending`
- `manual_completed`
- `claim_ready`
- `claim_claimed`
- `claim_role_confirmed`
- `claim_retry_pending`
- `claim_expired`
- `claim_waiting_inventory`
这意味着后续继续改任务列表、订单详情、履约编排时,已经有一套可重复验证的最小场景。
## 当前未完成部分
### 1. 新 schema 和部分 service 仍然错位
当前最主要的问题不是“没功能”,而是“新数据模型已经落地,但应用层还没有完全跟上”。
典型现象:
- 前后端接口命名还留着一部分旧 CDK 心智
- 局部 service 仍需要继续统一 async/await 与新仓库接口写法
### 2. 多凭据任务能力还没有完全上浮到应用层
### 1. 多凭据任务能力还没有完全上浮到应用层
底层已经支持一个任务绑定多个库存项,但上层展示和操作仍偏向:
- 一个任务只看一个预占 CDK
- 虽然 admin 任务详情已经开始返回并展示 `inventoryBindings`
- 任务列表和订单详情已经开始展示绑定摘要计数
- 但列表操作入口和大部分应用编排仍主要围绕一个主库存项
- 一个任务只暴露一个领取 token
- 后台仍以单库存项视角管理任务
- 后台操作还没有按“绑定集合”粒度设计
### 3. 手动发货 profile 还没有形成完整闭环
### 2. 测试数据初始化还不够体系化
当前模型和 bootstrap 已有 `manual_dispatch` 方向,但完整的手动履约执行链路还没有完全落到 service、admin 操作和结果回写上
虽然已经明确“测试数据可丢弃”,也已经有 PostgreSQL 清库脚本和基础 seed 脚本,但当前场景库仍然偏薄
### 4. repository 与 admin API 之间仍有一层过渡期命名
还缺:
虽然内部主链路已经开始使用 `primary_*` 字段,但部分 admin 返回 payload 仍保留 `reservedCdkId / claimTokenId` 这样的旧命名,以避免前端同时大面积改动。
- `redeeming / redeemed with screenshot / claim token revoked` 等更靠近真实自动化结果的场景
- 更接近真实订单组合的多任务、多数量、多库存绑定样本
### 3. 任务状态与库存绑定状态仍可进一步解耦
当前虽然已经有 `task_status / delivery_status / inventory_status / task_inventory_bindings` 四套状态,但 admin 视角仍以“任务主状态”为中心:
- 详情页已经开始展示库存绑定集合
- 任务列表和订单详情已经开始展示绑定摘要
- 但订单列表、任务操作入口还没有把多库存绑定事件完整展开
- `manual_dispatch` 与自动领取任务共用的列表状态摘要还比较粗
- 订单编排层还没有把“多库存、多步骤”履约任务展开成更清晰的应用层对象
## 现在最该继续做的事
1. 让 admin 层完全对齐新的 `fulfillment_tasks / inventory_items` 语义
2. 把“单个 reserved CDK”心智继续升级为“任务库存绑定”
3. `manual_review / manual_dispatch` 从 profile 扩展成完整可执行链路
4. 补一套基于 PostgreSQL 和新 schema 的清库/种子数据脚本
1. 把“单个主库存项”心智继续升级为“任务库存绑定集合”
2. 让 admin 层逐步暴露多库存绑定、多履约步骤的真实状态
3. 在现有 seed 基础上继续扩充更多任务状态和编排场景
4. 继续把订单列表和任务操作入口也切到绑定集合视角
当前这件事已经完成一半
当前这件事已经继续往前走了一步
- 旧 SQLite 思路的 `scripts/cleanup-dev-data.js` 已经替换为基于 PostgreSQL 新 schema 的清库脚本
- 但种子数据脚本还没补,bootstrap 目前主要负责 profile/catalog,不负责完整测试数据生成
- admin 任务详情已开始暴露并展示 `task_inventory_bindings` 集合
- admin 任务列表和订单详情已开始消费绑定摘要计数
- `scripts/seed-dev-data.js` 已扩展到 claim 主流程多状态样本,bootstrap 仍然只负责 profile/catalog,不负责完整业务测试数据生成
## 文档说明