task-76(ASIN 数据中心): 实现最低价 ASIN 导入与删除导入

POST /api/admin/skip-price-asins/import、/delete-import(file+group_id 必填) 启动 + GET 进度轮询, 复用新增通用导入进度模型(含 deletedCount), 8 个契约测试。
2026-09-05 16:12:47 +08:00
parent 43c7c03aee
commit d9b1b980ca
3 changed files with 230 additions and 0 deletions
@@ -0,0 +1,101 @@
+/** ASIN 中心导入/轮询通用模型（任务 76）：启动结果、Excel 校验与导入进度归一(含 deletedCount)，纯逻辑。 */
+import { unwrap } from '../../api/envelope.ts'
+
+export const EXCEL_IMPORT_ALLOWED_EXT = /\.(xlsx|xls)$/i
+
+/** 是否为允许导入的 Excel 文件。 */
+export function isAllowedExcelImportFile(fileName: unknown): boolean {
+  return typeof fileName === 'string' && EXCEL_IMPORT_ALLOWED_EXT.test(fileName.trim())
+}
+
+/** 解包导入启动结果并取回 importId；缺省抛可读错误。 */
+export function parseImportStart(payload: unknown): string {
+  const data = unwrap<unknown>(payload)
+  const record = data && typeof data === 'object' ? (data as Record<string, unknown>) : null
+  const importId = typeof record?.importId === 'string' ? record.importId.trim() : ''
+  if (!importId) throw new Error('导入任务响应异常：缺少任务 ID')
+  return importId
+}
+
+export type ImportStatus = 'pending' | 'running' | 'success' | 'failed'
+
+export interface ImportProgress {
+  status: ImportStatus
+  totalRows: number
+  processedRows: number
+  asinCount: number
+  insertedCount: number
+  deletedCount: number
+  skippedCount: number
+  errorMessage?: string
+}
+
+function intOrZero(value: unknown): number {
+  return typeof value === 'number' && Number.isFinite(value) ? Math.floor(value) : 0
+}
+
+/** 归一化导入进度负载；缺省按未开始(pending)处理，未知状态不改。 */
+export function parseImportProgress(payload: unknown): ImportProgress {
+  const data = unwrap<unknown>(payload)
+  const record = data && typeof data === 'object' ? (data as Record<string, unknown>) : null
+  const rawStatus = typeof record?.status === 'string' ? record.status.trim().toLowerCase() : ''
+  const status: ImportStatus =
+    rawStatus === 'running' || rawStatus === 'success' || rawStatus === 'failed' || rawStatus === 'pending'
+      ? rawStatus
+      : 'pending'
+  const progress: ImportProgress = {
+    status,
+    totalRows: intOrZero(record?.totalRows),
+    processedRows: intOrZero(record?.processedRows),
+    asinCount: intOrZero(record?.asinCount),
+    insertedCount: intOrZero(record?.insertedCount),
+    deletedCount: intOrZero(record?.deletedCount),
+    skippedCount: intOrZero(record?.skippedCount),
+  }
+  const errorMessage =
+    typeof record?.errorMessage === 'string' && record.errorMessage.trim()
+      ? record.errorMessage.trim()
+      : undefined
+  if (errorMessage) progress.errorMessage = errorMessage
+  return progress
+}
+
+/** 是否到达终态(success/failed)。 */
+export function importFinished(progress: Pick<ImportProgress, 'status'>): boolean {
+  return progress.status === 'success' || progress.status === 'failed'
+}
+
+/** 是否成功完成。 */
+export function importSucceeded(progress: Pick<ImportProgress, 'status'>): boolean {
+  return progress.status === 'success'
+}
+
+/** 导入添加结果文案。 */
+export function importOutcomeText(progress: ImportProgress): string {
+  switch (progress.status) {
+    case 'running':
+      return `导入处理中：已处理 ${progress.processedRows}/${progress.totalRows} 行`
+    case 'success':
+      return `导入完成：处理 ${progress.insertedCount} 条，跳过 ${progress.skippedCount} 条`
+    case 'failed':
+      return progress.errorMessage ? `导入失败：${progress.errorMessage}` : '导入失败，请重试'
+    case 'pending':
+    default:
+      return '等待导入任务开始…'
+  }
+}
+
+/** 导入删除结果文案。 */
+export function deleteOutcomeText(progress: ImportProgress): string {
+  switch (progress.status) {
+    case 'running':
+      return `删除处理中：已处理 ${progress.processedRows}/${progress.totalRows} 行`
+    case 'success':
+      return `删除完成：删除 ${progress.deletedCount} 条，跳过 ${progress.skippedCount} 条`
+    case 'failed':
+      return progress.errorMessage ? `删除失败：${progress.errorMessage}` : '删除失败，请重试'
+    case 'pending':
+    default:
+      return '等待删除任务开始…'
+  }
+}
@@ -0,0 +1,44 @@
+/** 最低价 ASIN 导入添加/删除适配（任务 76）：multipart POST /import、/delete-import(file+group_id 必填) 及进度轮询。 */
+import { http } from '@/api/http'
+import { parseImportProgress, parseImportStart, type ImportProgress } from './import-progress-model'
+
+export const SKIP_PRICE_IMPORT_ENDPOINT = '/api/admin/skip-price-asins/import'
+export const SKIP_PRICE_DELETE_IMPORT_ENDPOINT = '/api/admin/skip-price-asins/delete-import'
+
+function requireGroupId(groupId: number): number {
+  if (typeof groupId !== 'number' || !Number.isFinite(groupId) || groupId < 1) {
+    throw new Error('请选择分组后再导入')
+  }
+  return Math.floor(groupId)
+}
+
+function importForm(file: File, groupId: number): FormData {
+  const form = new FormData()
+  form.append('file', file, file.name)
+  form.append('group_id', String(requireGroupId(groupId)))
+  return form
+}
+
+/** 启动导入添加（后端 group_id 必填）。 */
+export async function startSkipPriceImport(file: File, groupId: number): Promise<string> {
+  const { data } = await http.post<unknown>(SKIP_PRICE_IMPORT_ENDPOINT, importForm(file, groupId))
+  return parseImportStart(data)
+}
+
+/** 查询导入添加进度：GET /import/{importId}。 */
+export async function fetchSkipPriceImportProgress(importId: string): Promise<ImportProgress> {
+  const { data } = await http.get<unknown>(`${SKIP_PRICE_IMPORT_ENDPOINT}/${importId}`)
+  return parseImportProgress(data)
+}
+
+/** 启动导入删除（后端 group_id 必填）。 */
+export async function startSkipPriceDeleteImport(file: File, groupId: number): Promise<string> {
+  const { data } = await http.post<unknown>(SKIP_PRICE_DELETE_IMPORT_ENDPOINT, importForm(file, groupId))
+  return parseImportStart(data)
+}
+
+/** 查询导入删除进度：GET /delete-import/{importId}。 */
+export async function fetchSkipPriceDeleteImportProgress(importId: string): Promise<ImportProgress> {
+  const { data } = await http.get<unknown>(`${SKIP_PRICE_DELETE_IMPORT_ENDPOINT}/${importId}`)
+  return parseImportProgress(data)
+}