diff --git a/furniture-3d-system/prisma/migrations/20261116120000_add_supply_chain_external_freight_record/migration.sql b/furniture-3d-system/prisma/migrations/20261116120000_add_supply_chain_external_freight_record/migration.sql new file mode 100644 index 00000000..6a732a37 --- /dev/null +++ b/furniture-3d-system/prisma/migrations/20261116120000_add_supply_chain_external_freight_record/migration.sql @@ -0,0 +1,21 @@ +CREATE TABLE "SupplyChainExternalFreightRecord" ( + "id" TEXT NOT NULL, + "orderNo" TEXT NOT NULL, + "outboundQty" INTEGER NOT NULL, + "incomeAfterTaxRefund" DECIMAL(18, 4), + "estimatedFreight" DECIMAL(18, 4) NOT NULL, + "remark" TEXT NOT NULL DEFAULT '', + "sourceFileName" TEXT NOT NULL DEFAULT '', + "importedById" TEXT NOT NULL DEFAULT '', + "importedByName" TEXT NOT NULL DEFAULT '', + "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP, + "updatedAt" TIMESTAMP(3) NOT NULL, + + CONSTRAINT "SupplyChainExternalFreightRecord_pkey" PRIMARY KEY ("id") +); + +CREATE UNIQUE INDEX "SupplyChainExternalFreightRecord_orderNo_key" + ON "SupplyChainExternalFreightRecord"("orderNo"); + +CREATE INDEX "SCExternalFreight_createdAt_idx" + ON "SupplyChainExternalFreightRecord"("createdAt"); diff --git a/furniture-3d-system/prisma/migrations/20261116130000_add_external_freight_stat_month/migration.sql b/furniture-3d-system/prisma/migrations/20261116130000_add_external_freight_stat_month/migration.sql new file mode 100644 index 00000000..2d5f339a --- /dev/null +++ b/furniture-3d-system/prisma/migrations/20261116130000_add_external_freight_stat_month/migration.sql @@ -0,0 +1,5 @@ +ALTER TABLE "SupplyChainExternalFreightRecord" + ADD COLUMN IF NOT EXISTS "statMonth" VARCHAR(7) NOT NULL DEFAULT ''; + +CREATE INDEX IF NOT EXISTS "SCExternalFreight_statMonth_idx" + ON "SupplyChainExternalFreightRecord"("statMonth"); diff --git a/furniture-3d-system/prisma/migrations/20261116140000_rename_external_freight_ship_month/migration.sql b/furniture-3d-system/prisma/migrations/20261116140000_rename_external_freight_ship_month/migration.sql new file mode 100644 index 00000000..cd61f73d --- /dev/null +++ b/furniture-3d-system/prisma/migrations/20261116140000_rename_external_freight_ship_month/migration.sql @@ -0,0 +1,5 @@ +ALTER TABLE "SupplyChainExternalFreightRecord" + RENAME COLUMN "statMonth" TO "shipMonth"; + +ALTER INDEX "SCExternalFreight_statMonth_idx" + RENAME TO "SCExternalFreight_shipMonth_idx"; diff --git a/furniture-3d-system/prisma/schema.prisma b/furniture-3d-system/prisma/schema.prisma index 8493ffb3..0b0797c3 100644 --- a/furniture-3d-system/prisma/schema.prisma +++ b/furniture-3d-system/prisma/schema.prisma @@ -6415,6 +6415,25 @@ model SupplyChainExternalOrderCost { @@index([shopStyleCode], map: "SCExternalOrderCost_shopStyleCode_idx") } +/// 外贸货代费人工导入记录。订单号唯一,重复导入时覆盖更新。 +model SupplyChainExternalFreightRecord { + id String @id @default(cuid()) + shipMonth String @default("") @db.VarChar(7) + orderNo String @unique + outboundQty Int + incomeAfterTaxRefund Decimal? @db.Decimal(18, 4) + estimatedFreight Decimal @db.Decimal(18, 4) + remark String @default("") @db.Text + sourceFileName String @default("") + importedById String @default("") + importedByName String @default("") + createdAt DateTime @default(now()) + updatedAt DateTime @updatedAt + + @@index([shipMonth], map: "SCExternalFreight_shipMonth_idx") + @@index([createdAt], map: "SCExternalFreight_createdAt_idx") +} + /// 清货任务流转记录(提交 / 通过 / 驳回 / 调整 / 运营确认移除) model SupplyChainClearanceTaskEvent { id String @id @default(cuid()) diff --git a/furniture-3d-system/src/app/api/supply-chain/management/external-sales/clearance/route.ts b/furniture-3d-system/src/app/api/supply-chain/management/external-sales/clearance/route.ts new file mode 100644 index 00000000..1f8fccd2 --- /dev/null +++ b/furniture-3d-system/src/app/api/supply-chain/management/external-sales/clearance/route.ts @@ -0,0 +1,18 @@ +import { NextRequest } from 'next/server' +import { ErrorCode } from '@/server/core/errors' +import { handleRequest, jsonError, jsonSuccess } from '@/server/core/response' +import { externalClearancePriceService } from '@/server/services/external-clearance-price.service' +import { supplyChainPermissionSettingsService } from '@/server/services/supply-chain-permission-settings.service' + +export async function GET(request: NextRequest) { + return handleRequest(request, async (ctx) => { + const access = await supplyChainPermissionSettingsService.getUserAccess( + ctx.user, + 'managementBlankPage7', + ) + if (!access.view) { + return jsonError(ErrorCode.AUTH_PERMISSION_DENIED, '当前账号没有清货价查看权限', 403, ctx.requestId) + } + return jsonSuccess({ rows: await externalClearancePriceService.list() }, 200, ctx.requestId) + }, { requireAuth: true }) +} diff --git a/furniture-3d-system/src/app/api/supply-chain/management/external-sales/freight/import/route.ts b/furniture-3d-system/src/app/api/supply-chain/management/external-sales/freight/import/route.ts new file mode 100644 index 00000000..aed40b2c --- /dev/null +++ b/furniture-3d-system/src/app/api/supply-chain/management/external-sales/freight/import/route.ts @@ -0,0 +1,31 @@ +import { NextRequest } from 'next/server' +import { ErrorCode } from '@/server/core/errors' +import { handleRequest, jsonError, jsonSuccess } from '@/server/core/response' +import { supplyChainExternalFreightService } from '@/server/services/supply-chain-external-freight.service' +import { supplyChainPermissionSettingsService } from '@/server/services/supply-chain-permission-settings.service' + +export async function POST(request: NextRequest) { + return handleRequest(request, async (ctx) => { + const access = await supplyChainPermissionSettingsService.getUserAccess( + ctx.user, + 'managementBlankPage7', + ) + if (!access.edit) { + return jsonError(ErrorCode.AUTH_PERMISSION_DENIED, '当前账号没有外贸货代费导入权限', 403, ctx.requestId) + } + const form = await request.formData() + const file = form.get('file') + if (!(file instanceof File)) { + return jsonError(ErrorCode.VALIDATION_REQUIRED_FIELD, '请选择 Excel 文件', 400, ctx.requestId) + } + if (file.size > 10 * 1024 * 1024) { + return jsonError(ErrorCode.VALIDATION_OUT_OF_RANGE, 'Excel 文件不能超过 10MB', 400, ctx.requestId) + } + const result = await supplyChainExternalFreightService.importFile({ + fileName: file.name, + buffer: Buffer.from(await file.arrayBuffer()), + user: ctx.user, + }) + return jsonSuccess(result, 200, ctx.requestId) + }, { requireAuth: true }) +} diff --git a/furniture-3d-system/src/app/api/supply-chain/management/external-sales/freight/route.ts b/furniture-3d-system/src/app/api/supply-chain/management/external-sales/freight/route.ts new file mode 100644 index 00000000..bee37b00 --- /dev/null +++ b/furniture-3d-system/src/app/api/supply-chain/management/external-sales/freight/route.ts @@ -0,0 +1,18 @@ +import { NextRequest } from 'next/server' +import { ErrorCode } from '@/server/core/errors' +import { handleRequest, jsonError, jsonSuccess } from '@/server/core/response' +import { supplyChainExternalFreightService } from '@/server/services/supply-chain-external-freight.service' +import { supplyChainPermissionSettingsService } from '@/server/services/supply-chain-permission-settings.service' + +export async function GET(request: NextRequest) { + return handleRequest(request, async (ctx) => { + const access = await supplyChainPermissionSettingsService.getUserAccess( + ctx.user, + 'managementBlankPage7', + ) + if (!access.view) { + return jsonError(ErrorCode.AUTH_PERMISSION_DENIED, '当前账号没有外贸货代费查看权限', 403, ctx.requestId) + } + return jsonSuccess({ rows: await supplyChainExternalFreightService.list() }, 200, ctx.requestId) + }, { requireAuth: true }) +} diff --git a/furniture-3d-system/src/app/api/supply-chain/management/external-sales/freight/template/route.ts b/furniture-3d-system/src/app/api/supply-chain/management/external-sales/freight/template/route.ts new file mode 100644 index 00000000..638fd87f --- /dev/null +++ b/furniture-3d-system/src/app/api/supply-chain/management/external-sales/freight/template/route.ts @@ -0,0 +1,26 @@ +import { NextRequest, NextResponse } from 'next/server' +import { ErrorCode } from '@/server/core/errors' +import { handleRequest, jsonError } from '@/server/core/response' +import { supplyChainExternalFreightService } from '@/server/services/supply-chain-external-freight.service' +import { supplyChainPermissionSettingsService } from '@/server/services/supply-chain-permission-settings.service' + +export async function GET(request: NextRequest) { + return handleRequest(request, async (ctx) => { + const access = await supplyChainPermissionSettingsService.getUserAccess( + ctx.user, + 'managementBlankPage7', + ) + if (!access.view) { + return jsonError(ErrorCode.AUTH_PERMISSION_DENIED, '当前账号没有外贸货代费查看权限', 403, ctx.requestId) + } + const buffer = await supplyChainExternalFreightService.createTemplate() + return new NextResponse(buffer as unknown as BodyInit, { + status: 200, + headers: { + 'Content-Type': 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet', + 'Content-Disposition': `attachment; filename*=UTF-8''${encodeURIComponent('外贸货代费导入模板.xlsx')}`, + 'Cache-Control': 'no-store', + }, + }) + }, { requireAuth: true }) +} diff --git a/furniture-3d-system/src/app/api/supply-chain/management/external-sales/profit/route.ts b/furniture-3d-system/src/app/api/supply-chain/management/external-sales/profit/route.ts new file mode 100644 index 00000000..c1cec22d --- /dev/null +++ b/furniture-3d-system/src/app/api/supply-chain/management/external-sales/profit/route.ts @@ -0,0 +1,33 @@ +import { NextRequest } from 'next/server' +import { z } from 'zod' +import { ErrorCode } from '@/server/core/errors' +import { handleRequest, jsonError, jsonSuccess } from '@/server/core/response' +import { externalProfitService } from '@/server/services/external-profit.service' +import { supplyChainPermissionSettingsService } from '@/server/services/supply-chain-permission-settings.service' + +const querySchema = z.object({ + basis: z.enum(['cost', 'clearance']).default('cost'), +}) + +export async function GET(request: NextRequest) { + return handleRequest(request, async (ctx) => { + const access = await supplyChainPermissionSettingsService.getUserAccess( + ctx.user, + 'managementBlankPage7', + ) + if (!access.view) { + return jsonError(ErrorCode.AUTH_PERMISSION_DENIED, '当前账号没有毛利查看权限', 403, ctx.requestId) + } + const parsed = querySchema.safeParse({ + basis: request.nextUrl.searchParams.get('basis') ?? undefined, + }) + if (!parsed.success) { + return jsonError(ErrorCode.VALIDATION_INVALID_FORMAT, '毛利维度不正确', 400, ctx.requestId) + } + return jsonSuccess( + await externalProfitService.getData(parsed.data.basis), + 200, + ctx.requestId, + ) + }, { requireAuth: true }) +} diff --git a/furniture-3d-system/src/app/api/supply-chain/management/external-sales/route.ts b/furniture-3d-system/src/app/api/supply-chain/management/external-sales/route.ts new file mode 100644 index 00000000..c2a5fbaa --- /dev/null +++ b/furniture-3d-system/src/app/api/supply-chain/management/external-sales/route.ts @@ -0,0 +1,78 @@ +import { NextRequest } from 'next/server' +import { z } from 'zod' +import { + EXTERNAL_SALES_TARGET_SHOPS, + externalSalesDateSpan, + externalSalesMonthRange, + isExternalSalesDate, + parseExternalSalesDetailFilters, +} from '@/lib/external-sales' +import { ErrorCode } from '@/server/core/errors' +import { handleRequest, jsonError, jsonSuccess } from '@/server/core/response' +import { externalSalesService } from '@/server/services/external-sales.service' +import { supplyChainPermissionSettingsService } from '@/server/services/supply-chain-permission-settings.service' + +const querySchema = z.object({ + view: z.enum(['summary', 'detail', 'afterSale']).default('summary'), + dateFrom: z.string().trim().optional(), + dateTo: z.string().trim().optional(), + month: z.string().trim().optional(), + shopName: z.enum(EXTERNAL_SALES_TARGET_SHOPS).or(z.literal('')).optional(), + keyword: z.string().trim().max(200).optional(), + orderNo: z.string().trim().max(120).optional(), + itemCode: z.string().trim().max(120).optional(), + filters: z.string().trim().max(5_000).optional(), + page: z.coerce.number().int().min(1).default(1), + pageSize: z.coerce.number().int().min(1).max(200).default(50), +}) + +export async function GET(request: NextRequest) { + return handleRequest(request, async (ctx) => { + const access = await supplyChainPermissionSettingsService.getUserAccess(ctx.user, 'managementBlankPage7') + if (!access.view) { + return jsonError( + ErrorCode.AUTH_PERMISSION_DENIED, + '当前账号没有外销销量查看权限', + 403, + ctx.requestId, + ) + } + const parsed = querySchema.safeParse(Object.fromEntries(request.nextUrl.searchParams.entries())) + if (!parsed.success) { + return jsonError(ErrorCode.VALIDATION_INVALID_FORMAT, '外销销量查询参数不正确', 400, ctx.requestId) + } + const monthRange = parsed.data.view === 'summary' && parsed.data.month + ? externalSalesMonthRange(parsed.data.month) + : null + const dateFrom = monthRange?.dateFrom ?? parsed.data.dateFrom + const dateTo = monthRange?.dateTo ?? parsed.data.dateTo + if ((dateFrom && !isExternalSalesDate(dateFrom)) || (dateTo && !isExternalSalesDate(dateTo))) { + return jsonError(ErrorCode.VALIDATION_INVALID_FORMAT, '统计时间范围不正确', 400, ctx.requestId) + } + if (dateFrom && dateTo && !externalSalesDateSpan(dateFrom, dateTo)) { + return jsonError(ErrorCode.VALIDATION_INVALID_FORMAT, '统计时间范围不正确', 400, ctx.requestId) + } + if (parsed.data.month && !monthRange) { + return jsonError(ErrorCode.VALIDATION_INVALID_FORMAT, '统计月份不正确', 400, ctx.requestId) + } + const detailFilters = parsed.data.filters + ? parseExternalSalesDetailFilters(parsed.data.filters) + : {} + if (!detailFilters) { + return jsonError(ErrorCode.VALIDATION_INVALID_FORMAT, '明细筛选参数不正确', 400, ctx.requestId) + } + const data = await externalSalesService.getPage({ + view: parsed.data.view, + dateFrom, + dateTo, + shopName: parsed.data.shopName, + keyword: parsed.data.keyword, + orderNo: parsed.data.orderNo, + itemCode: parsed.data.itemCode, + detailFilters, + page: parsed.data.page, + pageSize: parsed.data.pageSize, + }) + return jsonSuccess(data, 200, ctx.requestId) + }, { requireAuth: true }) +} diff --git a/furniture-3d-system/src/app/supply-chain/config/supply-chain-menu.test.ts b/furniture-3d-system/src/app/supply-chain/config/supply-chain-menu.test.ts index 389b0c80..62d88906 100644 --- a/furniture-3d-system/src/app/supply-chain/config/supply-chain-menu.test.ts +++ b/furniture-3d-system/src/app/supply-chain/config/supply-chain-menu.test.ts @@ -157,6 +157,11 @@ describe('supply chain menu', () => { module: '经营管理', route: '/supply-chain/management/blank-pages/blank-page-6', }), + expect.objectContaining({ + label: '外销销量', + module: '经营管理', + route: '/supply-chain/management/blank-pages/blank-page-7', + }), ]), ) }) diff --git a/furniture-3d-system/src/app/supply-chain/config/supply-chain-menu.ts b/furniture-3d-system/src/app/supply-chain/config/supply-chain-menu.ts index aabeb83e..f22e3aa5 100644 --- a/furniture-3d-system/src/app/supply-chain/config/supply-chain-menu.ts +++ b/furniture-3d-system/src/app/supply-chain/config/supply-chain-menu.ts @@ -11,6 +11,7 @@ const BLANK_PAGE_TARGET_KEYS: Record = { 'blank-page-2': 'managementBlankPage2', 'blank-page-3': 'productSabc', 'blank-page-6': 'productSelection', + 'blank-page-7': 'managementBlankPage7', } export type SupplyChainMenuItem = { diff --git a/furniture-3d-system/src/app/supply-chain/layout.tsx b/furniture-3d-system/src/app/supply-chain/layout.tsx index 000f38a6..0cb6f5cd 100644 --- a/furniture-3d-system/src/app/supply-chain/layout.tsx +++ b/furniture-3d-system/src/app/supply-chain/layout.tsx @@ -25,7 +25,7 @@ export default async function SupplyChainRootLayout({ children }: { children: Re authUser, await supplyChainPermissionSettingsService.getVisibleTargetKeys(authUser), ) - const labelTargets: SupplyChainPermissionTargetKey[] = ['ownerConfig', 'limitManagement', 'managementBlankPage1', 'managementBlankPage2', 'productSabc'] + const labelTargets: SupplyChainPermissionTargetKey[] = ['ownerConfig', 'limitManagement', 'managementBlankPage1', 'managementBlankPage2', 'managementBlankPage7', 'productSabc'] const editableTabRoutes = process.env.NODE_ENV === 'production' ? [] : (await Promise.all( labelTargets.map(async (target) => { const access = await supplyChainPermissionSettingsService.getUserAccess(authUser, target) diff --git a/furniture-3d-system/src/app/supply-chain/management/blank-pages/ExternalClearancePricePanel.tsx b/furniture-3d-system/src/app/supply-chain/management/blank-pages/ExternalClearancePricePanel.tsx new file mode 100644 index 00000000..4bb9bf89 --- /dev/null +++ b/furniture-3d-system/src/app/supply-chain/management/blank-pages/ExternalClearancePricePanel.tsx @@ -0,0 +1,112 @@ +'use client' + +import { useEffect, useState } from 'react' +import { RefreshCw } from 'lucide-react' +import type { ExternalClearancePriceRow } from '@/lib/external-clearance-price' +import styles from './external-sales.module.css' + +async function responseJson(response: Response) { + const payload = await response.json().catch(() => null) as { + success?: boolean + data?: { rows?: ExternalClearancePriceRow[] } + error?: { message?: string } + } | null + if (!response.ok || !payload?.success) { + throw new Error(payload?.error?.message || '清货价加载失败') + } + return payload.data?.rows ?? [] +} + +function amount(value: number) { + return `¥${value.toLocaleString('zh-CN', { + minimumFractionDigits: 2, + maximumFractionDigits: 4, + })}` +} + +export function ExternalClearancePricePanel({ + onRowsChange, +}: { + onRowsChange: (rows: ExternalClearancePriceRow[]) => void +}) { + const [rows, setRows] = useState([]) + const [loading, setLoading] = useState(true) + const [error, setError] = useState('') + const [reloadKey, setReloadKey] = useState(0) + + useEffect(() => { + const controller = new AbortController() + void fetch('/api/supply-chain/management/external-sales/clearance', { + cache: 'no-store', + signal: controller.signal, + }) + .then(responseJson) + .then((nextRows) => { + setRows(nextRows) + onRowsChange(nextRows) + }) + .catch((cause) => { + if (cause instanceof DOMException && cause.name === 'AbortError') return + setError(cause instanceof Error ? cause.message : '清货价加载失败') + }) + .finally(() => { + if (!controller.signal.aborted) setLoading(false) + }) + return () => controller.abort() + }, [onRowsChange, reloadKey]) + + return ( +
+
+ 共 {rows.length.toLocaleString('zh-CN')} 个订单商品 + +
+ {error ?
{error}
: null} +
+ + + + + + + + + + + {rows.map((row) => ( + + + + + + + ))} + {!loading && rows.length === 0 ? ( + + + + ) : null} + {loading ? ( + + ) : null} + +
订单号商品编码成本价清货价
{row.orderNo}{row.itemCode}{amount(row.costPrice)} + {amount(row.clearancePrice)} +
+ 暂无清货价数据,请先在“清货 → 外采订单成本”中导入 +
正在读取清货价数据…
+
+
+ ) +} diff --git a/furniture-3d-system/src/app/supply-chain/management/blank-pages/ExternalFreightPanel.tsx b/furniture-3d-system/src/app/supply-chain/management/blank-pages/ExternalFreightPanel.tsx new file mode 100644 index 00000000..15ec17d6 --- /dev/null +++ b/furniture-3d-system/src/app/supply-chain/management/blank-pages/ExternalFreightPanel.tsx @@ -0,0 +1,303 @@ +'use client' + +import { useEffect, useRef, useState } from 'react' +import { Download, RefreshCw, Upload } from 'lucide-react' +import type { ExternalFreightRecordView } from '@/lib/external-freight' +import modalStyles from '../clearance/clearance-price-push.module.css' +import styles from './external-sales.module.css' + +async function responseJson(response: Response) { + const payload = await response.json().catch(() => null) as { + success?: boolean + data?: unknown + error?: { message?: string } + } | null + if (!response.ok || !payload?.success) { + throw new Error(payload?.error?.message || '请求失败') + } + return payload.data +} + +async function downloadResponse(response: Response, fallbackName: string) { + if (!response.ok) { + const payload = await response.json().catch(() => null) as { + error?: { message?: string } + } | null + throw new Error(payload?.error?.message || '下载失败') + } + const blob = await response.blob() + const url = URL.createObjectURL(blob) + const anchor = document.createElement('a') + anchor.href = url + const disposition = response.headers.get('Content-Disposition') ?? '' + const encodedName = disposition.match(/filename\*=UTF-8''([^;]+)/i)?.[1] + anchor.download = encodedName ? decodeURIComponent(encodedName) : fallbackName + document.body.appendChild(anchor) + anchor.click() + anchor.remove() + URL.revokeObjectURL(url) +} + +function numberText(value: number) { + return value.toLocaleString('zh-CN', { maximumFractionDigits: 0 }) +} + +function amountText(value: number | null) { + return value == null + ? '-' + : `¥${value.toLocaleString('zh-CN', { + minimumFractionDigits: 2, + maximumFractionDigits: 2, + })}` +} + +function shipMonthText(value: string) { + const match = /^(\d{4})-(\d{2})$/.exec(value) + return match ? `${match[1]}年${Number(match[2])}月` : value || '-' +} + +export function ExternalFreightPanel({ + onRowsChange, +}: { + onRowsChange: (rows: ExternalFreightRecordView[]) => void +}) { + const [rows, setRows] = useState([]) + const [loading, setLoading] = useState(true) + const [importing, setImporting] = useState(false) + const [importDialogOpen, setImportDialogOpen] = useState(false) + const [pendingFile, setPendingFile] = useState(null) + const [dialogError, setDialogError] = useState('') + const [downloadingTemplate, setDownloadingTemplate] = useState(false) + const [message, setMessage] = useState('') + const [error, setError] = useState('') + const [reloadKey, setReloadKey] = useState(0) + const fileRef = useRef(null) + + useEffect(() => { + const controller = new AbortController() + void fetch('/api/supply-chain/management/external-sales/freight', { + cache: 'no-store', + signal: controller.signal, + }) + .then(responseJson) + .then((payload) => { + const nextRows = (payload as { rows?: ExternalFreightRecordView[] } | null)?.rows ?? [] + setRows(nextRows) + onRowsChange(nextRows) + }) + .catch((cause) => { + if (cause instanceof DOMException && cause.name === 'AbortError') return + setError(cause instanceof Error ? cause.message : '货代费加载失败') + }) + .finally(() => { + if (!controller.signal.aborted) setLoading(false) + }) + return () => controller.abort() + }, [onRowsChange, reloadKey]) + + const downloadTemplate = async () => { + if (downloadingTemplate) return + setDownloadingTemplate(true) + setDialogError('') + setError('') + try { + await downloadResponse( + await fetch('/api/supply-chain/management/external-sales/freight/template', { + cache: 'no-store', + }), + '外贸货代费导入模板.xlsx', + ) + } catch (cause) { + const message = cause instanceof Error ? cause.message : '模板下载失败' + setDialogError(message) + setError(message) + } finally { + setDownloadingTemplate(false) + } + } + + const importFile = async (file: File) => { + if (importing) return + setImporting(true) + setError('') + setDialogError('') + setMessage('') + try { + const form = new FormData() + form.append('file', file) + const payload = await responseJson(await fetch( + '/api/supply-chain/management/external-sales/freight/import', + { method: 'POST', body: form }, + )) as { importedCount?: number } + setMessage(`已导入 ${numberText(payload?.importedCount ?? 0)} 个订单的货代费`) + setImportDialogOpen(false) + setPendingFile(null) + setLoading(true) + setReloadKey((value) => value + 1) + } catch (cause) { + setDialogError(cause instanceof Error ? cause.message : '导入失败') + } finally { + setImporting(false) + if (fileRef.current) fileRef.current.value = '' + } + } + + return ( +
+
+ 共 {numberText(rows.length)} 个订单 + + +
+ {importDialogOpen ? ( +
+
+
+

导入人工货代费

+ +
+
+
+ 导入说明 +

请先下载模板,按同款六列填写:发货月份、订单号、出库数量(以实际为准)、收入-减退税(CNY)、预估货运费(货代+海运)、备注。

+

发货月份按月填写,例如 2026年11月;模板第二行为示例,请替换或删除后导入。

+

订单号、出库数量和预估货运费为必填项,收入-减退税和备注为选填项。

+

重复导入同一订单号时,以最后一次导入内容覆盖更新。

+

工作表名称不限,首行表头与模板一致即可;单个文件最多 5000 行、不超过 10MB。

+
+ +
+ {dialogError ?
{dialogError}
: null} +
+ { + setDialogError('') + setPendingFile(event.target.files?.[0] ?? null) + }} + /> + + + {pendingFile?.name || '请选择需要上传并导入的 Excel 文件'} + + +
+
+ + + + {['发货月份', '订单号', '出库数量(以实际为准)', '收入-减退税(CNY)', '预估货运费(货代+海运)', '备注'].map((header) => ( + + ))} + + +
{header}
+
+
+
+ ) : null} + {message ?
{message}
: null} + {error ?
{error}
: null} +
+ + + + + + + + + + + + + {rows.map((row) => ( + + + + + + + + + ))} + {!loading && rows.length === 0 ? ( + + ) : null} + {loading ? ( + + ) : null} + +
发货月份订单号出库数量(以实际为准)收入-减退税(CNY)预估货运费(货代+海运)备注
{shipMonthText(row.shipMonth)}{row.orderNo}{numberText(row.outboundQty)}{amountText(row.incomeAfterTaxRefund)}{amountText(row.estimatedFreight)}{row.remark || '-'}
暂无货代费数据,请下载模板后人工导入
正在读取货代费数据…
+
+
+ ) +} diff --git a/furniture-3d-system/src/app/supply-chain/management/blank-pages/ExternalProfitPanel.tsx b/furniture-3d-system/src/app/supply-chain/management/blank-pages/ExternalProfitPanel.tsx new file mode 100644 index 00000000..397f8573 --- /dev/null +++ b/furniture-3d-system/src/app/supply-chain/management/blank-pages/ExternalProfitPanel.tsx @@ -0,0 +1,190 @@ +'use client' + +import { useEffect, useState } from 'react' +import { RefreshCw } from 'lucide-react' +import type { ExternalProfitBasis, ExternalProfitRow } from '@/lib/external-profit' +import styles from './external-sales.module.css' + +async function responseJson(response: Response) { + const payload = await response.json().catch(() => null) as { + success?: boolean + data?: { rows?: ExternalProfitRow[] } + error?: { message?: string } + } | null + if (!response.ok || !payload?.success) { + throw new Error(payload?.error?.message || '毛利数据加载失败') + } + return payload.data?.rows ?? [] +} + +function amount(value: number) { + return `¥${value.toLocaleString('zh-CN', { + minimumFractionDigits: 2, + maximumFractionDigits: 2, + })}` +} + +function monthText(value: string) { + return /^\d{4}-\d{2}$/.test(value) + ? `${value.slice(0, 4)}年${Number(value.slice(5, 7))}月` + : value +} + +export function ExternalProfitPanel({ + onRowsChange, +}: { + onRowsChange: (rows: ExternalProfitRow[]) => void +}) { + const [basis, setBasis] = useState('cost') + const [allRows, setAllRows] = useState([]) + const [rows, setRows] = useState([]) + const [selectedMonth, setSelectedMonth] = useState('') + const [loading, setLoading] = useState(true) + const [error, setError] = useState('') + const [reloadKey, setReloadKey] = useState(0) + + useEffect(() => { + const controller = new AbortController() + void fetch(`/api/supply-chain/management/external-sales/profit?basis=${basis}`, { + cache: 'no-store', + signal: controller.signal, + }) + .then(responseJson) + .then((nextRows) => { + const displayedRows = selectedMonth + ? nextRows.filter((row) => row.shipMonth === selectedMonth) + : nextRows + setAllRows(nextRows) + setRows(displayedRows) + onRowsChange(displayedRows) + }) + .catch((cause) => { + if (cause instanceof DOMException && cause.name === 'AbortError') return + setError(cause instanceof Error ? cause.message : '毛利数据加载失败') + }) + .finally(() => { + if (!controller.signal.aborted) setLoading(false) + }) + return () => controller.abort() + }, [basis, onRowsChange, reloadKey, selectedMonth]) + + return ( +
+
+
+ + +
+ + 成本调整、安装费暂无数据源,暂按 0 计算 + +
+ {error ?
{error}
: null} +
+ + + + + + + + + + + + + + + + + + + + + {rows.map((row) => ( + + + + + + + + + + + + + + + + + ))} + {!loading && rows.length === 0 ? ( + + ) : null} + {loading ? ( + + ) : null} + +
发货月份平台利润中心销售金额真实业绩采购成本成本调整总成本运费其他快递运费总运费安装费毛利额毛利率
{monthText(row.shipMonth)}{row.platform}{row.profitCenter}{amount(row.salesAmount)}{amount(row.realPerformance)}{amount(row.purchaseCost)}{amount(row.costAdjustment)}{amount(row.totalCost)}{amount(row.freight)}{amount(row.otherCourierFreight)}{amount(row.totalFreight)}{amount(row.installationFee)}{amount(row.grossProfit)} + {(row.grossMargin * 100).toFixed(2)}% +
暂无毛利数据
正在计算毛利数据…
+
+
+ ) +} diff --git a/furniture-3d-system/src/app/supply-chain/management/blank-pages/ExternalSalesView.test.tsx b/furniture-3d-system/src/app/supply-chain/management/blank-pages/ExternalSalesView.test.tsx new file mode 100644 index 00000000..8659c9ef --- /dev/null +++ b/furniture-3d-system/src/app/supply-chain/management/blank-pages/ExternalSalesView.test.tsx @@ -0,0 +1,539 @@ +import { fireEvent, render, screen, waitFor, within } from '@testing-library/react' +import { MANAGEMENT_BLANK_PAGES } from '@/lib/supply-chain-management-blank-pages' +import type { ExternalSalesDetailRow, ExternalSalesPage } from '@/lib/external-sales' +import { ExternalSalesView } from './ExternalSalesView' + +const definition = MANAGEMENT_BLANK_PAGES.find((page) => page.key === 'blank-page-7')! + +const shared = { + dateFrom: '2026-11-01', + dateTo: '2026-11-13', + shopName: '' as const, + generatedAt: '2026-11-13T10:00:00.000Z', + totals: { + orderCount: 1, + shipAmount: 10400, + shipQty: 260, + afterSaleCount: 1, + refundQty: 2, + refundAmount: 80, + goodsValue: 8514, + freight: 20, + clearanceGoodsValue: 11610, + }, +} + +const summaryData: ExternalSalesPage = { + ...shared, + view: 'summary', + rows: [{ + month: '2026-11', + orderNo: 'WM20261106132001PG', + shipAmount: 10400, + shipQty: 260, + afterSaleAmount: 80, + afterSaleQty: 2, + finalShipAmount: 10320, + finalShipQty: 258, + }], + pageInfo: { page: 1, pageSize: 50, total: 1, totalPages: 1 }, +} + +const detailData: ExternalSalesPage = { + ...shared, + view: 'detail', + detailColumnAvailability: { + shopSkuId: true, + shopItemId: true, + }, + rows: [{ + sourceType: 'QMCUST', + oId: '10113153', + oiId: '20261106001', + orderNo: 'WM20261106132001PG', + shopName: '阿里巴巴-外贸部欧伯娜导单专用店铺', + shippingCourier: '中铁物流', + trackingNo: '119033220001', + shipmentWeight: 40, + shippingUnitWeight: 0.2, + shippingWeight: 40, + freight: 20, + statsDate: '2026-11-06', + orderDate: '2026-11-06 11:11:01', + sendDate: '2026-11-07 15:23:02', + orderStatus: 'Sent', + itemStatus: '', + ownerName: '张三', + localItemId: '6926012', + skuId: 'CJ003166N68V01', + itemId: 'ITEM-001', + shopSkuId: 'SHOP-SKU-001', + shopItemId: 'SHOP-ITEM-001', + propertiesValue: '荷花白+原木色', + itemName: '款式一 100/50/41.2', + basePrice: 40, + price: 40, + qty: 260, + amount: 10400, + afterSaleAmount: 80, + afterSaleQty: 2, + finalShipAmount: 10320, + finalShipQty: 258, + orderPaidAmount: 10400, + outerOiId: 'OUTER-10113153', + costPrice: 33, + goodsValue: 8514, + clearancePrice: 45, + clearanceGoodsValue: 11610, + refundStatus: '', + refundQty: 0, + statusLabel: '已发货', + }], + pageInfo: { page: 1, pageSize: 50, total: 1, totalPages: 1 }, +} + +const afterSaleData: ExternalSalesPage = { + ...shared, + view: 'afterSale', + rows: [{ + asId: '阿里巴巴-外贸部欧伯娜导单专用店铺|2026-11-06|WM20261106132001PG|CJ003166N68V01', + outerAsId: 'AS-20261106-001', + orderNo: 'WM20261106132001PG', + shopName: '阿里巴巴-外贸部欧伯娜导单专用店铺', + asDate: '2026-11-06 16:20:00', + afterSaleStatus: 'WaitConfirm', + afterSaleType: '普通退货', + refundPhase: '售后', + goodsStatus: '已收到货', + creatorName: '张三', + questionType: '尺寸不符', + buyerApplyRefund: 80, + refundAmount: 80, + receiveRefund: 80, + confirmDate: '', + localItemId: '6926012', + skuId: 'CJ003166N68V01', + itemId: 'CJ003166', + shopSkuId: 'SHOP-SKU-001', + itemName: '款式一 100/50/41.2', + propertiesValue: '荷花白+原木色', + qty: 2, + returnedQty: 2, + amount: 80, + remark: '客户申请退货', + }], + pageInfo: { page: 1, pageSize: 50, total: 1, totalPages: 1 }, +} + +const freightData = { + rows: [{ + id: 'freight-1', + shipMonth: '2026-11', + orderNo: 'WM20260917FLD-MANILA-34', + outboundQty: 1394, + incomeAfterTaxRefund: null, + estimatedFreight: 6630, + remark: '', + sourceFileName: '外贸货代费.xlsx', + importedByName: '本地管理员', + createdAt: '2026-11-16T02:00:00.000Z', + updatedAt: '2026-11-16T02:00:00.000Z', + }], +} + +const clearanceData = { + rows: [{ + orderNo: 'WM-CLEARANCE-001', + itemCode: 'SKU-CLEARANCE-001', + costPrice: 18.5, + clearancePrice: 18.5, + }], +} + +function profitData(basis: 'cost' | 'clearance') { + return { + rows: [ + { + shipMonth: '2026-11', + platform: '外贸', + profitCenter: '外贸部', + salesAmount: 1000, + realPerformance: 1000, + purchaseCost: basis === 'cost' ? 500 : 600, + costAdjustment: 0, + totalCost: basis === 'cost' ? 500 : 600, + freight: 50, + otherCourierFreight: 100, + totalFreight: 150, + installationFee: 0, + grossProfit: basis === 'cost' ? 350 : 250, + grossMargin: (basis === 'cost' ? 350 : 250) / 1000, + }, + { + shipMonth: '2026-10', + platform: '外贸', + profitCenter: '外贸部', + salesAmount: 800, + realPerformance: 800, + purchaseCost: basis === 'cost' ? 400 : 450, + costAdjustment: 0, + totalCost: basis === 'cost' ? 400 : 450, + freight: 30, + otherCourierFreight: 20, + totalFreight: 50, + installationFee: 0, + grossProfit: basis === 'cost' ? 350 : 300, + grossMargin: (basis === 'cost' ? 350 : 300) / 800, + }, + ], + } +} + +function response(data: T) { + return { + ok: true, + status: 200, + json: async () => ({ success: true, data }), + } as unknown as Response +} + +beforeEach(() => { + window.localStorage.clear() + global.fetch = jest.fn(async (input: RequestInfo | URL) => { + const url = String(input) + if (url.endsWith('/external-sales/freight')) return response(freightData) + if (url.endsWith('/external-sales/clearance')) return response(clearanceData) + if (url.includes('/external-sales/profit')) { + return response(profitData(url.includes('basis=clearance') ? 'clearance' : 'cost')) + } + return response( + url.includes('view=afterSale') + ? afterSaleData + : url.includes('view=detail') + ? detailData + : summaryData, + ) + }) as unknown as typeof fetch +}) + +describe('外销销量', () => { + it('renders all requested subpages and the summary headers', async () => { + render() + + expect(screen.getByRole('tab', { name: '汇总' })).toHaveAttribute('aria-selected', 'true') + expect(screen.getByRole('tab', { name: '明细' })).toBeInTheDocument() + expect(screen.getByRole('tab', { name: '售后明细' })).toBeInTheDocument() + expect(screen.getByRole('tab', { name: '货代费' })).toBeInTheDocument() + expect(screen.getByRole('tab', { name: '清货价' })).toBeInTheDocument() + expect(screen.getByRole('tab', { name: '毛利' })).toBeInTheDocument() + expect(screen.getByRole('button', { name: '导出汇总' })).toBeInTheDocument() + expect(await screen.findByText('WM20261106132001PG')).toBeInTheDocument() + for (const header of [ + '月份', + '订单号', + '发货金额', + '发货数量', + '售后金额', + '售后数量', + '最终发货金额', + '最终发货数量', + ]) { + expect(screen.getByRole('columnheader', { name: header })).toBeInTheDocument() + } + expect(screen.getByRole('button', { name: '统计月份筛选' })).toBeInTheDocument() + expect(screen.getByRole('button', { name: '店铺名称筛选' })).toBeInTheDocument() + expect(screen.queryByRole('button', { name: '关键词筛选' })).not.toBeInTheDocument() + expect(screen.getAllByText('¥10,400.00').length).toBeGreaterThan(0) + expect(screen.getAllByText('260').length).toBeGreaterThan(0) + expect(screen.getByText('合计')).toBeInTheDocument() + expect(screen.getAllByText('¥80.00').length).toBeGreaterThan(0) + expect(screen.getAllByText('¥10,320.00').length).toBeGreaterThan(0) + expect(screen.getAllByText('258').length).toBeGreaterThan(0) + }) + + it('offers export on every external-sales tab', async () => { + render() + await screen.findByText('WM20261106132001PG') + + fireEvent.click(screen.getByRole('tab', { name: '明细' })) + await screen.findByText('CJ003166N68V01') + expect(screen.getByRole('button', { name: '导出明细' })).toBeInTheDocument() + fireEvent.click(screen.getByRole('tab', { name: '售后明细' })) + await screen.findByText('CJ003166N68V01') + expect(screen.getByRole('button', { name: '导出售后明细' })).toBeInTheDocument() + fireEvent.click(screen.getByRole('tab', { name: '货代费' })) + await screen.findByText('WM20260917FLD-MANILA-34') + expect(screen.getByRole('button', { name: '导出货代费' })).toBeInTheDocument() + fireEvent.click(screen.getByRole('tab', { name: '清货价' })) + await screen.findByText('WM-CLEARANCE-001') + expect(screen.getByRole('button', { name: '导出清货价' })).toBeInTheDocument() + fireEvent.click(screen.getByRole('tab', { name: '毛利' })) + await screen.findAllByText('外贸部') + expect(screen.getByRole('button', { name: '导出毛利' })).toBeInTheDocument() + }) + + it('loads shipped order details from the selected data tab', async () => { + render() + await screen.findByText('WM20261106132001PG') + + fireEvent.click(screen.getByRole('tab', { name: '明细' })) + + expect(await screen.findByText('CJ003166N68V01')).toBeInTheDocument() + expect(screen.getByRole('button', { name: '发货时间筛选' })).toBeInTheDocument() + expect(screen.getByRole('button', { name: '店铺名称筛选' })).toBeInTheDocument() + expect(screen.getByText('款式一 100/50/41.2')).toBeInTheDocument() + expect(screen.getByRole('columnheader', { name: '发货时间' })).toBeInTheDocument() + expect(screen.getByText('2026-11-07 15:23:02')).toBeInTheDocument() + expect(screen.queryByRole('columnheader', { name: '外部子订单号' })).not.toBeInTheDocument() + expect(screen.queryByRole('columnheader', { name: '基本售价(原价)' })).not.toBeInTheDocument() + expect(screen.queryByRole('columnheader', { name: '单价' })).not.toBeInTheDocument() + expect(screen.queryByRole('columnheader', { name: '子订单号' })).not.toBeInTheDocument() + expect(screen.queryByRole('columnheader', { name: '明细ID' })).not.toBeInTheDocument() + expect(screen.getByRole('columnheader', { name: '内部单号' })).toBeInTheDocument() + expect(screen.getByRole('columnheader', { name: '发货快递' })).toBeInTheDocument() + expect(screen.getByRole('columnheader', { name: '运单号' })).toBeInTheDocument() + expect(screen.getByRole('columnheader', { name: '售后金额' })).toBeInTheDocument() + expect(screen.getByRole('columnheader', { name: '售后数量' })).toBeInTheDocument() + expect(screen.getByRole('columnheader', { name: '最终发货金额' })).toBeInTheDocument() + expect(screen.getByRole('columnheader', { name: '最终发货数量' })).toBeInTheDocument() + expect(screen.getByRole('columnheader', { name: '成本' })).toBeInTheDocument() + expect(screen.getByRole('columnheader', { name: '货值' })).toBeInTheDocument() + expect(screen.getByRole('columnheader', { name: '清货价' })).toBeInTheDocument() + expect(screen.getByRole('columnheader', { name: '清货货值' })).toBeInTheDocument() + expect(screen.getByRole('columnheader', { name: '运费' })).toBeInTheDocument() + expect(screen.getByText('10113153')).toBeInTheDocument() + expect(screen.getByText('中铁物流')).toBeInTheDocument() + expect(screen.getByText('119033220001')).toBeInTheDocument() + expect(screen.getByText('¥33.00')).toBeInTheDocument() + expect(screen.getAllByText('¥8,514.00').length).toBeGreaterThan(0) + expect(screen.getAllByText('¥45.00').length).toBeGreaterThan(0) + expect(screen.getAllByText('¥11,610.00').length).toBeGreaterThan(0) + expect(screen.getAllByText('¥80.00').length).toBeGreaterThan(0) + expect(screen.getAllByText('¥10,320.00').length).toBeGreaterThan(0) + expect(screen.getAllByText('258').length).toBeGreaterThan(0) + expect(screen.getAllByText('¥20.00').length).toBeGreaterThan(0) + const totalRow = screen.getByText('合计').closest('tr') + expect(totalRow).not.toBeNull() + expect(within(totalRow!).getByText('¥10,320.00')).toBeInTheDocument() + expect(within(totalRow!).getByText('258')).toBeInTheDocument() + expect(within(totalRow!).getByText('¥8,514.00')).toBeInTheDocument() + expect(screen.getAllByText('已发货').length).toBeGreaterThan(0) + await waitFor(() => { + expect(global.fetch).toHaveBeenLastCalledWith( + expect.stringContaining('view=detail'), + expect.anything(), + ) + }) + }) + + it('hides shop code columns when all filtered rows are empty', async () => { + const emptyShopCodes: ExternalSalesPage = { + ...detailData, + detailColumnAvailability: { + shopSkuId: false, + shopItemId: false, + }, + rows: [{ + ...(detailData.rows[0] as ExternalSalesDetailRow), + shopSkuId: '', + shopItemId: '', + }], + } + global.fetch = jest.fn(async (input: RequestInfo | URL) => ( + response(String(input).includes('view=detail') ? emptyShopCodes : summaryData) + )) as unknown as typeof fetch + + render() + await screen.findByText('WM20261106132001PG') + fireEvent.click(screen.getByRole('tab', { name: '明细' })) + await screen.findByText('CJ003166N68V01') + + expect(screen.queryByRole('columnheader', { name: '店铺商品编码' })).not.toBeInTheDocument() + expect(screen.queryByRole('columnheader', { name: '店铺款式编码' })).not.toBeInTheDocument() + }) + + it('lets users configure detail filter fields and applies the selected field filters', async () => { + render() + await screen.findByText('WM20261106132001PG') + + fireEvent.click(screen.getByRole('tab', { name: '明细' })) + await screen.findByText('CJ003166N68V01') + + expect(screen.getByRole('button', { name: '订单号筛选' })).toBeInTheDocument() + expect(screen.getByRole('button', { name: '原始商品编码筛选' })).toBeInTheDocument() + expect(screen.queryByRole('button', { name: '内部单号筛选' })).not.toBeInTheDocument() + + fireEvent.click(screen.getByRole('button', { name: '明细筛选设置' })) + expect(screen.getByRole('dialog', { name: '明细筛选设置' })).toBeInTheDocument() + fireEvent.click(screen.getByRole('checkbox', { name: '启用内部单号筛选' })) + fireEvent.click(screen.getByRole('button', { name: '完成' })) + expect(screen.getByRole('button', { name: '内部单号筛选' })).toBeInTheDocument() + + fireEvent.click(screen.getByRole('button', { name: '订单号筛选' })) + fireEvent.change(screen.getByRole('textbox', { name: '筛选订单号' }), { + target: { value: 'WM20261106132001PG' }, + }) + fireEvent.click(screen.getByRole('button', { name: '应用订单号筛选' })) + fireEvent.click(screen.getByRole('button', { name: '内部单号筛选' })) + fireEvent.change(screen.getByRole('textbox', { name: '筛选内部单号' }), { + target: { value: '10113153' }, + }) + fireEvent.click(screen.getByRole('button', { name: '应用内部单号筛选' })) + fireEvent.click(screen.getByRole('button', { name: '原始商品编码筛选' })) + fireEvent.change(screen.getByRole('textbox', { name: '筛选原始商品编码' }), { + target: { value: 'CJ003166N68V01' }, + }) + fireEvent.click(screen.getByRole('button', { name: '应用原始商品编码筛选' })) + fireEvent.click(screen.getByRole('button', { name: '查询' })) + + await waitFor(() => { + const lastCall = String((global.fetch as jest.Mock).mock.calls.at(-1)?.[0]) + const filters = new URL(lastCall, 'http://localhost').searchParams.get('filters') + expect(JSON.parse(filters ?? '{}')).toEqual({ + orderNo: 'WM20261106132001PG', + internalOrderNo: '10113153', + skuId: 'CJ003166N68V01', + }) + }) + }) + + it('filters the monthly summary by a selected month', async () => { + render() + await screen.findByText('WM20261106132001PG') + + fireEvent.click(screen.getByRole('button', { name: '统计月份筛选' })) + fireEvent.change(screen.getByLabelText('筛选统计月份'), { target: { value: '2026-10' } }) + fireEvent.click(screen.getByRole('button', { name: '应用统计月份筛选' })) + fireEvent.click(screen.getByRole('button', { name: '查询' })) + + await waitFor(() => { + expect(global.fetch).toHaveBeenLastCalledWith( + expect.stringContaining('month=2026-10'), + expect.anything(), + ) + }) + }) + + it('loads after-sales only for the external order scope', async () => { + render() + await screen.findByText('WM20261106132001PG') + + fireEvent.click(screen.getByRole('tab', { name: '售后明细' })) + expect(await screen.findByText('CJ003166N68V01')).toBeInTheDocument() + expect(screen.getAllByText('阿里巴巴-外贸部欧伯娜导单专用店铺').length).toBeGreaterThan(0) + expect(screen.getByRole('columnheader', { name: '原订单号' })).toBeInTheDocument() + expect(screen.getByRole('columnheader', { name: '售后金额' })).toBeInTheDocument() + expect(screen.getByRole('columnheader', { name: '售后数量' })).toBeInTheDocument() + expect(screen.getByRole('button', { name: '售后日期筛选' })).toBeInTheDocument() + expect(screen.getByRole('button', { name: '店铺名称筛选' })).toBeInTheDocument() + expect(screen.getByRole('button', { name: '订单号筛选' })).toBeInTheDocument() + expect(screen.getByRole('button', { name: '商品编码筛选' })).toBeInTheDocument() + expect(screen.queryByRole('button', { name: '统计月份筛选' })).not.toBeInTheDocument() + await waitFor(() => { + const lastCall = String((global.fetch as jest.Mock).mock.calls.at(-1)?.[0]) + expect(lastCall).toContain('view=afterSale') + expect(lastCall).not.toContain('dateFrom=') + expect(lastCall).not.toContain('dateTo=') + expect(lastCall).not.toContain('month=') + expect(lastCall).not.toContain('shopName=') + }) + }) + + it('filters after-sales by date, shop, order number and item code', async () => { + render() + await screen.findByText('WM20261106132001PG') + fireEvent.click(screen.getByRole('tab', { name: '售后明细' })) + await screen.findByText('CJ003166N68V01') + + fireEvent.click(screen.getByRole('button', { name: '售后日期筛选' })) + fireEvent.change(screen.getByLabelText('筛选售后日期开始时间'), { + target: { value: '2026-11-01' }, + }) + fireEvent.change(screen.getByLabelText('筛选售后日期结束时间'), { + target: { value: '2026-11-30' }, + }) + fireEvent.click(screen.getByRole('button', { name: '应用售后日期筛选' })) + fireEvent.click(screen.getByRole('button', { name: '店铺名称筛选' })) + fireEvent.change(screen.getByLabelText('筛选店铺名称'), { + target: { value: '阿里巴巴-外贸部欧伯娜导单专用店铺' }, + }) + fireEvent.click(screen.getByRole('button', { name: '应用店铺名称筛选' })) + fireEvent.click(screen.getByRole('button', { name: '订单号筛选' })) + fireEvent.change(screen.getByLabelText('筛选订单号'), { + target: { value: 'WM20261106132001PG' }, + }) + fireEvent.click(screen.getByRole('button', { name: '应用订单号筛选' })) + fireEvent.click(screen.getByRole('button', { name: '商品编码筛选' })) + fireEvent.change(screen.getByLabelText('筛选商品编码'), { + target: { value: 'CJ003166N68V01' }, + }) + fireEvent.click(screen.getByRole('button', { name: '应用商品编码筛选' })) + fireEvent.click(screen.getByRole('button', { name: '查询' })) + + await waitFor(() => { + const lastCall = String((global.fetch as jest.Mock).mock.calls.at(-1)?.[0]) + expect(lastCall).toContain('dateFrom=2026-11-01') + expect(lastCall).toContain('dateTo=2026-11-30') + expect(lastCall).toContain('shopName=') + expect(lastCall).toContain('orderNo=WM20261106132001PG') + expect(lastCall).toContain('itemCode=CJ003166N68V01') + }) + }) + + it('loads the freight import workspace and clearance price data', async () => { + render() + await screen.findByText('WM20261106132001PG') + + fireEvent.click(screen.getByRole('tab', { name: '货代费' })) + expect(await screen.findByText('WM20260917FLD-MANILA-34')).toBeInTheDocument() + expect(screen.getByRole('columnheader', { name: '发货月份' })).toBeInTheDocument() + expect(screen.getByRole('columnheader', { name: '订单号' })).toBeInTheDocument() + expect(screen.getByRole('columnheader', { name: '出库数量(以实际为准)' })).toBeInTheDocument() + expect(screen.getByRole('columnheader', { name: '收入-减退税(CNY)' })).toBeInTheDocument() + expect(screen.getByRole('columnheader', { name: '预估货运费(货代+海运)' })).toBeInTheDocument() + expect(screen.getByRole('columnheader', { name: '备注' })).toBeInTheDocument() + expect(screen.queryByRole('button', { name: '下载模板' })).not.toBeInTheDocument() + expect(screen.getByRole('button', { name: '人工导入' })).toBeInTheDocument() + fireEvent.click(screen.getByRole('button', { name: '人工导入' })) + expect(screen.getByRole('dialog', { name: '导入人工货代费' })).toBeInTheDocument() + expect(screen.getByText('导入说明')).toBeInTheDocument() + expect(screen.getByRole('button', { name: '导入模板下载' })).toBeInTheDocument() + expect(screen.getByRole('button', { name: '浏览...' })).toBeInTheDocument() + expect(screen.getByRole('button', { name: '开始导入' })).toBeDisabled() + expect(screen.getByText('请选择需要上传并导入的 Excel 文件')).toBeInTheDocument() + expect(screen.getByText('2026年11月')).toBeInTheDocument() + fireEvent.click(screen.getByRole('button', { name: '关闭货代费导入' })) + fireEvent.click(screen.getByRole('tab', { name: '清货价' })) + expect(await screen.findByText('WM-CLEARANCE-001')).toBeInTheDocument() + expect(screen.getByRole('columnheader', { name: '商品编码' })).toBeInTheDocument() + expect(screen.getByRole('columnheader', { name: '成本价' })).toBeInTheDocument() + expect(screen.getByRole('columnheader', { name: '清货价' })).toBeInTheDocument() + expect(screen.getAllByText('¥18.50').length).toBe(2) + }) + + it('switches between cost-price and clearance-price profit dimensions', async () => { + render() + await screen.findByText('WM20261106132001PG') + fireEvent.click(screen.getByRole('tab', { name: '毛利' })) + + expect((await screen.findAllByText('外贸部')).length).toBeGreaterThan(0) + expect(screen.getByRole('columnheader', { name: '发货月份' })).toBeInTheDocument() + expect(screen.getByRole('columnheader', { name: '销售金额' })).toBeInTheDocument() + expect(screen.queryByRole('columnheader', { name: '退款金额' })).not.toBeInTheDocument() + expect(screen.getByRole('columnheader', { name: '真实业绩' })).toBeInTheDocument() + expect(screen.getByRole('columnheader', { name: '总成本' })).toBeInTheDocument() + expect(screen.getByRole('columnheader', { name: '其他快递运费' })).toBeInTheDocument() + expect(screen.getByRole('columnheader', { name: '毛利率' })).toBeInTheDocument() + expect(screen.getByRole('button', { name: '成本价维度' })).toHaveAttribute('aria-pressed', 'true') + expect(screen.getAllByText('¥500.00').length).toBeGreaterThan(0) + + fireEvent.change(screen.getByLabelText('毛利统计月份'), { target: { value: '2026-10' } }) + const profitTable = screen.getByRole('table') + expect(within(profitTable).getByText('2026年10月')).toBeInTheDocument() + expect(within(profitTable).queryByText('2026年11月')).not.toBeInTheDocument() + + fireEvent.click(screen.getByRole('button', { name: '清货价维度' })) + expect((await screen.findAllByText('¥450.00')).length).toBeGreaterThan(0) + expect(screen.getByRole('button', { name: '清货价维度' })).toHaveAttribute('aria-pressed', 'true') + }) +}) diff --git a/furniture-3d-system/src/app/supply-chain/management/blank-pages/ExternalSalesView.tsx b/furniture-3d-system/src/app/supply-chain/management/blank-pages/ExternalSalesView.tsx new file mode 100644 index 00000000..fbe60bdd --- /dev/null +++ b/furniture-3d-system/src/app/supply-chain/management/blank-pages/ExternalSalesView.tsx @@ -0,0 +1,1111 @@ +'use client' + +import { useCallback, useEffect, useRef, useState, type FormEvent } from 'react' +import { + BarChart3, + ChevronDown, + FileDown, + List, + RotateCcw, + Search, + SlidersHorizontal, + Tags, + TrendingUp, + Truck, +} from 'lucide-react' +import type { ManagementBlankPageDefinition } from '@/lib/supply-chain-management-blank-pages' +import { + EXTERNAL_SALES_DETAIL_FILTER_KEYS, + EXTERNAL_SALES_TARGET_SHOPS, + type ExternalSalesAfterSaleRow, + type ExternalSalesDetailRow, + type ExternalSalesDetailFilterKey, + type ExternalSalesDetailFilters, + type ExternalSalesPage, + type ExternalSalesSummaryRow, + type ExternalSalesTargetShop, + type ExternalSalesView as ExternalSalesDataView, +} from '@/lib/external-sales' +import { + createExternalSalesExportWorkbook, + type ExternalSalesExportView, +} from '@/lib/external-sales-export' +import type { ExternalFreightRecordView } from '@/lib/external-freight' +import type { ExternalClearancePriceRow } from '@/lib/external-clearance-price' +import type { ExternalProfitRow } from '@/lib/external-profit' +import { ClearanceFilterSettingsDrawer } from '../clearance/ClearanceFilterSettingsDrawer' +import { ExternalClearancePricePanel } from './ExternalClearancePricePanel' +import { ExternalFreightPanel } from './ExternalFreightPanel' +import { ExternalProfitPanel } from './ExternalProfitPanel' +import styles from './external-sales.module.css' + +type ExternalSalesTab = ExternalSalesDataView | 'freight' | 'clearance' | 'profit' + +type Filters = { + month: string + dateFrom: string + dateTo: string + shopName: ExternalSalesTargetShop | '' + orderNo: string + itemCode: string + detailFilters: ExternalSalesDetailFilters +} + +const EMPTY_FILTERS: Filters = { + month: '', + dateFrom: '', + dateTo: '', + shopName: '', + orderNo: '', + itemCode: '', + detailFilters: {}, +} + +const DETAIL_FILTER_FIELDS: Array<{ + key: ExternalSalesDetailFilterKey + label: string + group: string +}> = [ + { key: 'orderNo', label: '订单号', group: '明细' }, + { key: 'internalOrderNo', label: '内部单号', group: '明细' }, + { key: 'shippingCourier', label: '发货快递', group: '明细' }, + { key: 'trackingNo', label: '运单号', group: '明细' }, + { key: 'skuId', label: '原始商品编码', group: '明细' }, + { key: 'itemId', label: '款式编码', group: '明细' }, + { key: 'orderDate', label: '下单时间', group: '明细' }, +] + +const DEFAULT_DETAIL_FILTER_KEYS: ExternalSalesDetailFilterKey[] = [ + 'orderNo', + 'skuId', +] +const DETAIL_FILTER_FIELDS_STORAGE_KEY = 'supply-chain.external-sales.detail-filter-fields.v1' + +function buildExternalSalesQueryParams( + view: ExternalSalesDataView, + filters: Filters, + page: number, + pageSize: number, +) { + const params = new URLSearchParams({ + view, + page: String(page), + pageSize: String(pageSize), + }) + if (view === 'summary' && filters.month) params.set('month', filters.month) + if (view !== 'summary' && filters.dateFrom) params.set('dateFrom', filters.dateFrom) + if (view !== 'summary' && filters.dateTo) params.set('dateTo', filters.dateTo) + if (filters.shopName) params.set('shopName', filters.shopName) + if (view === 'afterSale') { + if (filters.orderNo.trim()) params.set('orderNo', filters.orderNo.trim()) + if (filters.itemCode.trim()) params.set('itemCode', filters.itemCode.trim()) + } else if (view === 'detail') { + const activeDetailFilters = Object.fromEntries( + Object.entries(filters.detailFilters) + .filter(([, value]) => value?.trim()), + ) + if (Object.keys(activeDetailFilters).length > 0) { + params.set('filters', JSON.stringify(activeDetailFilters)) + } + } + return params +} + +function useFilterPopover() { + const [open, setOpen] = useState(false) + const wrapRef = useRef(null) + + useEffect(() => { + if (!open) return + const closeOnOutsideClick = (event: MouseEvent) => { + if (!wrapRef.current?.contains(event.target as Node)) setOpen(false) + } + document.addEventListener('mousedown', closeOnOutsideClick) + return () => document.removeEventListener('mousedown', closeOnOutsideClick) + }, [open]) + + return { open, setOpen, wrapRef } +} + +function FilterTrigger({ + label, + value, + open, + onClick, +}: { + label: string + value: string + open: boolean + onClick: () => void +}) { + return ( + + ) +} + +function TextFilterSelect({ + label, + value, + onChange, +}: { + label: string + value: string + onChange: (value: string) => void +}) { + const { open, setOpen, wrapRef } = useFilterPopover() + const [draft, setDraft] = useState(value) + + const toggle = () => { + if (!open) setDraft(value) + setOpen((current) => !current) + } + + const apply = () => { + onChange(draft.trim()) + setOpen(false) + } + + return ( +
+ + {open ? ( +
+ setDraft(event.target.value)} + onKeyDown={(event) => { + if (event.key === 'Enter') { + event.preventDefault() + apply() + } + if (event.key === 'Escape') setOpen(false) + }} + /> +
+ + +
+
+ ) : null} +
+ ) +} + +function MonthFilterSelect({ + value, + onChange, +}: { + value: string + onChange: (value: string) => void +}) { + const { open, setOpen, wrapRef } = useFilterPopover() + const [draft, setDraft] = useState(value) + const toggle = () => { + if (!open) setDraft(value) + setOpen((current) => !current) + } + const apply = () => { + onChange(draft) + setOpen(false) + } + + return ( +
+ + {open ? ( +
+ setDraft(event.target.value)} + onKeyDown={(event) => { + if (event.key === 'Enter') { + event.preventDefault() + apply() + } + if (event.key === 'Escape') setOpen(false) + }} + /> +
+ + +
+
+ ) : null} +
+ ) +} + +function DateRangeFilterSelect({ + label, + dateFrom, + dateTo, + onChange, +}: { + label: string + dateFrom: string + dateTo: string + onChange: (dateFrom: string, dateTo: string) => void +}) { + const { open, setOpen, wrapRef } = useFilterPopover() + const [draftFrom, setDraftFrom] = useState(dateFrom) + const [draftTo, setDraftTo] = useState(dateTo) + const toggle = () => { + if (!open) { + setDraftFrom(dateFrom) + setDraftTo(dateTo) + } + setOpen((current) => !current) + } + const apply = () => { + onChange(draftFrom, draftTo) + setOpen(false) + } + const value = dateFrom || dateTo + ? `${dateFrom || '不限'} 至 ${dateTo || '不限'}` + : '' + + return ( +
+ + {open ? ( +
+
+ setDraftFrom(event.target.value)} + /> + 至 + setDraftTo(event.target.value)} + /> +
+
+ + +
+
+ ) : null} +
+ ) +} + +function ShopFilterSelect({ + value, + onChange, +}: { + value: ExternalSalesTargetShop | '' + onChange: (value: ExternalSalesTargetShop | '') => void +}) { + const { open, setOpen, wrapRef } = useFilterPopover() + const [draft, setDraft] = useState(value) + const toggle = () => { + if (!open) setDraft(value) + setOpen((current) => !current) + } + const apply = () => { + onChange(draft) + setOpen(false) + } + + return ( +
+ + {open ? ( +
+ +
+ + +
+
+ ) : null} +
+ ) +} + +const TABS: Array<{ + key: ExternalSalesTab + label: string + icon: typeof BarChart3 +}> = [ + { key: 'summary', label: '汇总', icon: BarChart3 }, + { key: 'detail', label: '明细', icon: List }, + { key: 'afterSale', label: '售后明细', icon: RotateCcw }, + { key: 'freight', label: '货代费', icon: Truck }, + { key: 'clearance', label: '清货价', icon: Tags }, + { key: 'profit', label: '毛利', icon: TrendingUp }, +] + +function isDataView(value: ExternalSalesTab): value is ExternalSalesDataView { + return value === 'summary' || value === 'detail' || value === 'afterSale' +} + +function formatNumber(value: number) { + return Number(value || 0).toLocaleString('zh-CN', { + minimumFractionDigits: 0, + maximumFractionDigits: 0, + }) +} + +function formatAmount(value: number) { + return `¥${Number(value || 0).toLocaleString('zh-CN', { + minimumFractionDigits: 2, + maximumFractionDigits: 2, + })}` +} + +function formatDateTime(value: string) { + if (!value) return '-' + return value.replace('T', ' ').slice(0, 19) +} + +function pageNumberList(current: number, total: number): Array { + if (total <= 7) return Array.from({ length: total }, (_, index) => index + 1) + const pages = Array.from(new Set([1, total, current - 1, current, current + 1])) + .filter((item) => item >= 1 && item <= total) + .sort((left, right) => left - right) + const result: Array = [] + let previous = 0 + for (const item of pages) { + if (previous && item - previous > 1) result.push('ellipsis') + result.push(item) + previous = item + } + return result +} + +async function readResponse(response: Response) { + const payload = await response.json().catch(() => null) + if (!response.ok || !payload?.success) { + throw new Error(payload?.error?.message || '外销销量数据加载失败') + } + return payload.data as ExternalSalesPage +} + +export function ExternalSalesView({ + definition, +}: { + definition: ManagementBlankPageDefinition +}) { + const [activeTab, setActiveTab] = useState('summary') + const [visibleDetailFilterKeys, setVisibleDetailFilterKeys] = useState( + DEFAULT_DETAIL_FILTER_KEYS, + ) + const [filterSettingsOpen, setFilterSettingsOpen] = useState(false) + const [filterSettingsHydrated, setFilterSettingsHydrated] = useState(false) + const [filterDraft, setFilterDraft] = useState(EMPTY_FILTERS) + const [filters, setFilters] = useState(EMPTY_FILTERS) + const [page, setPage] = useState(1) + const [reloadKey, setReloadKey] = useState(0) + const [data, setData] = useState(null) + const [loading, setLoading] = useState(true) + const [exporting, setExporting] = useState(false) + const [freightRows, setFreightRows] = useState([]) + const [clearanceRows, setClearanceRows] = useState([]) + const [profitRows, setProfitRows] = useState([]) + const [error, setError] = useState('') + + useEffect(() => { + const timer = window.setTimeout(() => { + try { + const saved: unknown = JSON.parse( + window.localStorage.getItem(DETAIL_FILTER_FIELDS_STORAGE_KEY) ?? 'null', + ) + if (Array.isArray(saved)) { + const allowed = new Set(EXTERNAL_SALES_DETAIL_FILTER_KEYS) + setVisibleDetailFilterKeys(Array.from(new Set(saved.filter( + (key): key is ExternalSalesDetailFilterKey => ( + typeof key === 'string' && allowed.has(key) + ), + )))) + } + } catch {} + setFilterSettingsHydrated(true) + }, 0) + return () => window.clearTimeout(timer) + }, []) + + useEffect(() => { + if (!filterSettingsHydrated) return + try { + window.localStorage.setItem( + DETAIL_FILTER_FIELDS_STORAGE_KEY, + JSON.stringify(visibleDetailFilterKeys), + ) + } catch {} + }, [filterSettingsHydrated, visibleDetailFilterKeys]) + + useEffect(() => { + if (!isDataView(activeTab)) return undefined + const controller = new AbortController() + const params = buildExternalSalesQueryParams(activeTab, filters, page, 50) + void fetch(`/api/supply-chain/management/external-sales?${params}`, { + cache: 'no-store', + signal: controller.signal, + }) + .then(readResponse) + .then((payload) => setData(payload)) + .catch((cause) => { + if (cause instanceof DOMException && cause.name === 'AbortError') return + setError(cause instanceof Error ? cause.message : '外销销量数据加载失败') + }) + .finally(() => { + if (!controller.signal.aborted) setLoading(false) + }) + return () => controller.abort() + }, [activeTab, filters, page, reloadKey]) + + const activeData = data?.view === activeTab ? data : null + const summaryRows = activeTab === 'summary' + ? activeData?.rows as ExternalSalesSummaryRow[] | undefined + : undefined + const detailRows = activeTab === 'detail' + ? activeData?.rows as ExternalSalesDetailRow[] | undefined + : undefined + const afterSaleRows = activeTab === 'afterSale' + ? activeData?.rows as ExternalSalesAfterSaleRow[] | undefined + : undefined + const showShopSkuId = activeData?.detailColumnAvailability?.shopSkuId ?? true + const showShopItemId = activeData?.detailColumnAvailability?.shopItemId ?? true + const detailColumnCount = 25 - (showShopSkuId ? 0 : 1) - (showShopItemId ? 0 : 1) + const pageNumbers = pageNumberList( + activeData?.pageInfo.page ?? 1, + activeData?.pageInfo.totalPages ?? 1, + ) + const detailFilterFields = DETAIL_FILTER_FIELDS.filter((field) => ( + visibleDetailFilterKeys.includes(field.key) + )) + + const switchTab = useCallback((nextTab: ExternalSalesTab) => { + if (nextTab === 'afterSale') { + setFilterDraft((current) => ({ ...current, month: '', dateFrom: '', dateTo: '' })) + setFilters((current) => ({ ...current, month: '', dateFrom: '', dateTo: '' })) + } + setLoading(isDataView(nextTab)) + setError('') + setActiveTab(nextTab) + setPage(1) + }, []) + + const changeVisibleDetailFilterKeys = (keys: string[]) => { + const allowed = new Set(EXTERNAL_SALES_DETAIL_FILTER_KEYS) + const nextKeys = Array.from(new Set(keys.filter( + (key): key is ExternalSalesDetailFilterKey => allowed.has(key), + ))) + const retainVisible = (current: ExternalSalesDetailFilters) => ( + Object.fromEntries(Object.entries(current).filter(([key]) => nextKeys.includes( + key as ExternalSalesDetailFilterKey, + ))) as ExternalSalesDetailFilters + ) + setVisibleDetailFilterKeys(nextKeys) + setFilterDraft((current) => ({ + ...current, + detailFilters: retainVisible(current.detailFilters), + })) + setFilters((current) => ({ + ...current, + detailFilters: retainVisible(current.detailFilters), + })) + setLoading(true) + setError('') + setPage(1) + setReloadKey((current) => current + 1) + } + + const submitFilters = (event: FormEvent) => { + event.preventDefault() + setLoading(true) + setError('') + setFilters({ ...filterDraft }) + setPage(1) + setReloadKey((current) => current + 1) + } + + const resetFilters = () => { + setFilterDraft(EMPTY_FILTERS) + setFilters(EMPTY_FILTERS) + setLoading(true) + setError('') + setPage(1) + setReloadKey((current) => current + 1) + } + + const changePage = (nextPage: number) => { + setLoading(true) + setError('') + setPage(nextPage) + } + + const exportCurrentTab = async () => { + const view = activeTab + setExporting(true) + setError('') + try { + const rows: unknown[] = [] + if (isDataView(view)) { + let currentPage = 1 + let totalPages = 1 + do { + const params = buildExternalSalesQueryParams(view, filters, currentPage, 200) + const response = await fetch(`/api/supply-chain/management/external-sales?${params}`, { + cache: 'no-store', + }) + const pageData = await readResponse(response) + rows.push(...pageData.rows) + totalPages = pageData.pageInfo.totalPages + currentPage += 1 + } while (currentPage <= totalPages) + } else if (view === 'freight') { + rows.push(...freightRows) + } else if (view === 'clearance') { + rows.push(...clearanceRows) + } else if (view === 'profit') { + rows.push(...profitRows) + } + const { bytes, fileName } = await createExternalSalesExportWorkbook({ + view: view as ExternalSalesExportView, + rows, + }) + const blob = new Blob([bytes], { + type: 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet', + }) + const url = URL.createObjectURL(blob) + const anchor = document.createElement('a') + anchor.href = url + anchor.download = fileName + anchor.style.display = 'none' + document.body.appendChild(anchor) + anchor.click() + anchor.remove() + window.setTimeout(() => URL.revokeObjectURL(url), 0) + } catch (cause) { + setError(cause instanceof Error ? cause.message : '导出失败') + } finally { + setExporting(false) + } + } + + return ( +
+
+
+

{definition.label}

+

+ {activeTab === 'afterSale' + ? '两家外贸店铺售后 · 不限时间 · 数据来源聚水潭外贸售后' + : activeTab === 'summary' + ? '两家外贸店铺 · 按月汇总已发货销量 · 可选择任意月份或不限月份' + : activeTab === 'profit' + ? '按发货月份计算成本价维度和清货价维度的外贸毛利' + : '两家外贸店铺 · 仅已发货 · 可选择任意发货时间或不限时间'} +

+
+
+ +
+ + {activeTab === 'afterSale' + ? '外贸售后' + : activeTab === 'freight' + ? '货代费' + : activeTab === 'clearance' + ? '清货价' + : activeTab === 'profit' + ? '毛利' + : '已发货'} + + {activeData?.generatedAt ? `更新于 ${formatDateTime(activeData.generatedAt)}` : '实时订单明细'} +
+
+
+ +
+ {TABS.map((tab) => { + const Icon = tab.icon + return ( + + ) + })} +
+ + {isDataView(activeTab) ? ( + <> +
+
+ 筛选 +
+ {activeTab === 'summary' ? ( + <> + setFilterDraft((current) => ({ ...current, month }))} + /> + setFilterDraft((current) => ({ ...current, shopName }))} + /> + + ) : activeTab === 'afterSale' ? ( + <> + setFilterDraft((current) => ({ + ...current, + dateFrom, + dateTo, + }))} + /> + setFilterDraft((current) => ({ ...current, shopName }))} + /> + setFilterDraft((current) => ({ ...current, orderNo }))} + /> + setFilterDraft((current) => ({ ...current, itemCode }))} + /> + + ) : ( + <> + setFilterDraft((current) => ({ + ...current, + dateFrom, + dateTo, + }))} + /> + setFilterDraft((current) => ({ ...current, shopName }))} + /> + {detailFilterFields.map((field) => ( + setFilterDraft((current) => ({ + ...current, + detailFilters: { + ...current.detailFilters, + [field.key]: value, + }, + }))} + /> + ))} + {detailFilterFields.length === 0 ? ( + + 暂无筛选项,请点击右侧筛选设置开启 + + ) : null} + + )} +
+
+
+ + {activeData + ? activeTab === 'afterSale' + ? `${formatNumber(activeData.totals.afterSaleCount)} 笔售后 · ${formatNumber(activeData.totals.refundQty)} 件 · ${formatAmount(activeData.totals.refundAmount)}` + : `${formatNumber(activeData.totals.orderCount)} 单 · 发货 ${formatAmount(activeData.totals.shipAmount)} / ${formatNumber(activeData.totals.shipQty)} 件 · 售后 ${formatAmount(activeData.totals.refundAmount)} / ${formatNumber(activeData.totals.refundQty)} 件` + : '正在读取'} + + {activeTab === 'detail' ? ( + + ) : null} + + +
+
+ + changeVisibleDetailFilterKeys(DEFAULT_DETAIL_FILTER_KEYS)} + onChange={changeVisibleDetailFilterKeys} + onClose={() => setFilterSettingsOpen(false)} + /> + + {error ?
{error}
: null} + +
+ {activeTab === 'summary' ? ( +
+ + + + + + + + + + + + + + + {summaryRows?.map((row) => ( + + + + + + + + + + + ))} + {!loading && summaryRows && summaryRows.length > 0 && activeData ? ( + + + + + + + + + + ) : null} + {!loading && summaryRows?.length === 0 ? ( + + ) : null} + {loading && !summaryRows ? ( + + ) : null} + +
月份订单号发货金额发货数量售后金额售后数量最终发货金额最终发货数量
{row.month}{row.orderNo}{formatAmount(row.shipAmount)}{formatNumber(row.shipQty)}{formatAmount(row.afterSaleAmount)}{formatNumber(row.afterSaleQty)} + {formatAmount(row.finalShipAmount)} + + {formatNumber(row.finalShipQty)} +
合计{formatAmount(activeData.totals.shipAmount)}{formatNumber(activeData.totals.shipQty)}{formatAmount(activeData.totals.refundAmount)}{formatNumber(activeData.totals.refundQty)} + {formatAmount(activeData.totals.shipAmount - activeData.totals.refundAmount)} + + {formatNumber(activeData.totals.shipQty - activeData.totals.refundQty)} +
暂无数据
正在读取已发货订单…
+
+ ) : activeTab === 'detail' ? ( +
+ + + + + + + + + + + + {showShopSkuId ? : null} + {showShopItemId ? : null} + + + + + + + + + + + + + + + + + + + {detailRows?.map((row) => ( + + + + + + + + + + {showShopSkuId ? : null} + {showShopItemId ? : null} + + + + + + + + + + + + + + + + + ))} + {!loading && detailRows && detailRows.length > 0 && activeData ? ( + + + + + + + + + + + + + + + ) : null} + {!loading && detailRows?.length === 0 ? ( + + ) : null} + {loading && !detailRows ? ( + + ) : null} + +
发货时间订单号内部单号发货快递运单号店铺名称原始商品编码款式编码店铺商品编码店铺款式编码商品名称属性发货数量发货金额售后金额售后数量最终发货金额最终发货数量成本货值清货价清货货值运费明细状态下单时间
{formatDateTime(row.sendDate)}{row.orderNo}{row.oId}{row.shippingCourier || '-'}{row.trackingNo || '-'}{row.shopName}{row.skuId}{row.itemId}{row.shopSkuId}{row.shopItemId}{row.itemName}{row.propertiesValue}{formatNumber(row.qty)}{formatAmount(row.amount)}{formatAmount(row.afterSaleAmount)}{formatNumber(row.afterSaleQty)} + {formatAmount(row.finalShipAmount)} + + {formatNumber(row.finalShipQty)} + {row.costPrice === null ? '-' : formatAmount(row.costPrice)}{row.goodsValue === null ? '-' : formatAmount(row.goodsValue)} + {row.clearancePrice === null ? '-' : formatAmount(row.clearancePrice)} + + {row.clearanceGoodsValue === null ? '-' : formatAmount(row.clearanceGoodsValue)} + + {row.freight === null ? '-' : formatAmount(row.freight)} + {row.statusLabel}{formatDateTime(row.orderDate)}
合计{formatNumber(activeData.totals.shipQty)}{formatAmount(activeData.totals.shipAmount)}{formatAmount(activeData.totals.refundAmount)}{formatNumber(activeData.totals.refundQty)} + {formatAmount(activeData.totals.shipAmount - activeData.totals.refundAmount)} + + {formatNumber(activeData.totals.shipQty - activeData.totals.refundQty)} + -{formatAmount(activeData.totals.goodsValue ?? 0)}- + {formatAmount(activeData.totals.clearanceGoodsValue ?? 0)} + + {formatAmount(activeData.totals.freight ?? 0)} + +
暂无数据
正在读取已发货订单明细…
+
+ ) : ( +
+ + + + + + + + + + + + + {afterSaleRows?.map((row) => ( + + + + + + + + + ))} + {!loading && afterSaleRows?.length === 0 ? ( + + ) : null} + {loading && !afterSaleRows ? ( + + ) : null} + +
售后日期店铺名称原订单号商品编码售后数量售后金额
{formatDateTime(row.asDate)}{row.shopName}{row.orderNo}{row.skuId || '-'}{formatNumber(row.qty)}{formatAmount(row.refundAmount)}
暂无外贸售后数据
正在读取外贸售后数据…
+
+ )} +
+ +
+ + 共 {formatNumber(activeData?.pageInfo.total ?? 0)} 条 + {activeTab === 'summary' && activeData ? ` · 汇总 ${formatNumber(activeData.totals.orderCount)} 单` : ''} + {activeTab === 'afterSale' && activeData ? ` · 售后 ${formatNumber(activeData.totals.afterSaleCount)} 笔` : ''} + +
+ + {pageNumbers.map((item, index) => item === 'ellipsis' ? ( + … + ) : ( + + ))} + +
+
+ + ) : activeTab === 'freight' ? ( + + ) : activeTab === 'clearance' ? ( + + ) : activeTab === 'profit' ? ( + + ) : ( +
+ {TABS.find((tab) => tab.key === activeTab)?.label} +

暂无数据

+
+ )} +
+ ) +} diff --git a/furniture-3d-system/src/app/supply-chain/management/blank-pages/[pageKey]/page.tsx b/furniture-3d-system/src/app/supply-chain/management/blank-pages/[pageKey]/page.tsx index 2e435bbc..3a71f2cc 100644 --- a/furniture-3d-system/src/app/supply-chain/management/blank-pages/[pageKey]/page.tsx +++ b/furniture-3d-system/src/app/supply-chain/management/blank-pages/[pageKey]/page.tsx @@ -5,6 +5,7 @@ import { supplyChainPermissionSettingsService } from '@/server/services/supply-c import { ManagementBlankPageView } from '../ManagementBlankPageView' import { ProductSabcView } from '../ProductSabcView' import { ProductSelectionView } from '../ProductSelectionView' +import { ExternalSalesView } from '../ExternalSalesView' export default async function ManagementBlankPage({ params }: { params: Promise<{ pageKey: string }> }) { const definition = getManagementBlankPage((await params).pageKey) @@ -38,6 +39,12 @@ export default async function ManagementBlankPage({ params }: { params: Promise< return } + if (definition.key === 'blank-page-7') { + const access = await supplyChainPermissionSettingsService.getUserAccess(authUser, 'managementBlankPage7') + if (!access.view) redirect('/supply-chain') + return + } + const access = await supplyChainPermissionSettingsService.getUserAccess( authUser, definition.key === 'blank-page-1' ? 'managementBlankPage1' : 'managementBlankPage2', diff --git a/furniture-3d-system/src/app/supply-chain/management/blank-pages/external-sales.module.css b/furniture-3d-system/src/app/supply-chain/management/blank-pages/external-sales.module.css new file mode 100644 index 00000000..c03b543a --- /dev/null +++ b/furniture-3d-system/src/app/supply-chain/management/blank-pages/external-sales.module.css @@ -0,0 +1,108 @@ +.page{display:flex;min-width:0;min-height:0;flex:1;flex-direction:column;overflow:hidden;background:var(--sc-bg);color:var(--sc-ink)} +.header{display:flex;flex:none;align-items:center;justify-content:space-between;gap:20px;border-bottom:1px solid var(--sc-border);background:var(--sc-surface);padding:13px 24px} +.header h1{margin:0;font-size:18px;font-weight:700} +.header p{margin:5px 0 0;color:var(--sc-muted);font-size:12px} +.headerActions{display:flex;flex:none;align-items:center;gap:12px} +.headerMeta{display:flex;flex:none;flex-direction:column;align-items:flex-end;gap:3px} +.headerMeta span{border-radius:999px;background:#ecfdf5;padding:3px 10px;color:#047857;font-size:12px;font-weight:600} +.headerMeta i{color:var(--sc-muted);font-size:11px;font-style:normal} +.tabs{display:flex;flex:none;gap:4px;overflow-x:auto;border-bottom:1px solid var(--sc-border);background:var(--sc-surface);padding:10px 24px} +.tabs button{display:inline-flex;height:34px;flex:none;align-items:center;gap:6px;border:1px solid transparent;border-radius:6px;background:transparent;padding:0 14px;color:#52525b;font-size:12px;font-family:inherit;cursor:pointer} +.tabs .tabActive{border-color:#d4d4d8;background:#fff;color:#18181b;box-shadow:0 1px 2px rgba(0,0,0,.06)} +.filters{display:flex;flex:none;flex-wrap:wrap;align-items:flex-end;gap:10px;padding:14px 24px 10px} +.filters label{display:flex;min-width:180px;flex:0 1 210px;flex-direction:column;gap:4px;color:var(--sc-muted);font-size:11px} +.filters .keyword{min-width:280px;flex:2 1 360px} +.filterHint{align-self:center;padding-bottom:8px;color:var(--sc-muted);font-size:11px} +.filters label>div{display:flex;height:34px;align-items:center;gap:7px;border:1px solid var(--sc-border);border-radius:5px;background:#fff;padding:0 9px} +.filters input,.filters select{box-sizing:border-box;height:34px;border:1px solid var(--sc-border);border-radius:5px;background:#fff;padding:0 9px;outline:0;color:var(--sc-ink);font-size:12px;font-family:inherit} +.filters label>div input{height:auto;flex:1;min-width:0;border:0;padding:0} +.filters input:focus,.filters select:focus,.filters label>div:focus-within{border-color:#93c5fd;box-shadow:0 0 0 2px #eff6ff} +.detailFilterBar{display:flex;min-width:0;flex:1 0 100%;align-items:flex-start;gap:13px;padding-top:2px} +.detailFilterLabel{flex:none;padding-top:12px;color:#a1a1aa;font-size:12px} +.detailFilterButtons{display:flex;min-width:0;flex:1;flex-wrap:wrap;gap:10px} +.detailFilterSelect{position:relative} +.detailFilterTrigger{display:flex;height:44px;min-width:82px;max-width:290px;align-items:center;justify-content:space-between;gap:12px;border:1px solid #d4d4d8;border-radius:8px;background:#fff;padding:0 16px;color:#3f3f46;font-size:14px;font-family:inherit;cursor:pointer} +.detailFilterTrigger>span{min-width:0;overflow:hidden;text-overflow:ellipsis;white-space:nowrap} +.detailFilterTrigger:hover{border-color:#a1a1aa} +.detailFilterTriggerActive{border-color:#52525b;background:#f4f4f5;font-weight:600} +.detailFilterPopover{position:absolute;top:50px;left:0;z-index:60;width:max(100%,250px);border:1px solid #d4d4d8;border-radius:7px;background:#fff;padding:9px;box-shadow:0 12px 30px rgba(24,24,27,.14)} +.detailFilterPopover input{width:100%;height:36px} +.detailFilterPopover select{box-sizing:border-box;width:100%;height:36px;border:1px solid #d4d4d8;border-radius:5px;background:#fff;padding:0 8px;color:#3f3f46;font-size:12px;font-family:inherit} +.dateFilterPopover{width:max(100%,390px)} +.detailFilterPopover>.dateFilterFields{display:flex;align-items:center;justify-content:flex-start;gap:6px;margin-top:0} +.dateFilterFields span{flex:none;color:#a1a1aa;font-size:11px} +.dateFilterFields input{width:145px!important} +.detailFilterPopover>div{display:flex;justify-content:flex-end;gap:7px;margin-top:8px} +.detailFilterPopover>div button{height:29px;border:1px solid #d4d4d8;border-radius:5px;background:#fff;padding:0 10px;color:#52525b;font-size:11px;font-family:inherit;cursor:pointer} +.detailFilterPopover>div button:last-child{border-color:#27272a;background:#27272a;color:#fff} +.dateRange{display:flex;min-width:300px;align-items:center;gap:7px;margin:0;border:0;padding:0} +.dateRange legend{margin-bottom:4px;color:var(--sc-muted);font-size:11px} +.dateRange span{color:var(--sc-muted);font-size:11px} +.filterActions{display:flex;flex:1 0 100%;align-items:center;justify-content:flex-end;gap:7px;color:var(--sc-muted);font-size:11px} +.filterActions>span{margin-right:5px;white-space:nowrap} +.primaryButton,.secondaryButton,.iconButton{display:inline-flex;height:34px;align-items:center;justify-content:center;gap:5px;border-radius:5px;padding:0 11px;font-size:12px;font-family:inherit;cursor:pointer} +.primaryButton{border:1px solid #27272a;background:#27272a;color:#fff} +.secondaryButton{border:1px solid #d4d4d8;background:#fff;color:#52525b} +.iconButton{width:34px;border:1px solid #d4d4d8;background:#fff;padding:0;color:#52525b} +.iconButton:hover{border-color:#a1a1aa;background:#fafafa} +.primaryButton:disabled,.secondaryButton:disabled{cursor:not-allowed;opacity:.45} +.error{margin:0 24px 8px;border:1px solid #fecaca;border-radius:5px;background:#fff7f7;padding:9px 12px;color:#b91c1c;font-size:12px} +.success{margin:0 24px 8px;border:1px solid #bbf7d0;border-radius:5px;background:#f0fdf4;padding:9px 12px;color:#15803d;font-size:12px} +.freightToolbar{display:flex;flex:none;align-items:center;justify-content:flex-end;gap:8px;padding:14px 24px 10px;color:var(--sc-muted);font-size:11px} +.freightToolbar>span{margin-right:auto} +.freightImportDialog{width:min(1180px,100%)} +.profitToolbar{display:flex;flex:none;align-items:center;gap:12px;padding:14px 24px 10px;color:var(--sc-muted);font-size:11px} +.profitToolbar>span{margin-left:auto} +.profitBasisTabs{display:inline-flex;gap:3px;padding:3px;border:1px solid #d4d4d8;border-radius:7px;background:#f4f4f5} +.profitBasisTabs button{height:30px;border:0;border-radius:5px;background:transparent;padding:0 14px;color:#52525b;font-size:12px;font-family:inherit;cursor:pointer} +.profitBasisTabs .profitBasisActive{background:#fff;color:#18181b;font-weight:700;box-shadow:0 1px 2px rgba(0,0,0,.08)} +.profitMonthFilter{display:flex;align-items:center;gap:7px;color:#52525b;font-size:12px} +.profitMonthFilter select{height:36px;min-width:150px;border:1px solid #d4d4d8;border-radius:7px;background:#fff;padding:0 10px;color:#3f3f46;font-size:12px;font-family:inherit} +.content{display:flex;min-height:0;flex:1;flex-direction:column} +.tableWrap{min-height:0;flex:1;overflow:auto;padding:0 24px} +.table{width:100%;border-collapse:separate;border-spacing:0;background:#fff;font-size:12px} +.summaryTable{min-width:980px} +.detailTable{min-width:2680px} +.afterSaleTable{min-width:980px} +.freightTable{min-width:1040px} +.clearancePriceTable{min-width:760px} +.clearancePriceCell{color:#b45309!important;font-weight:700} +.profitTable{min-width:1760px} +.profitValue{color:#047857!important;font-weight:700} +.table th{position:sticky;top:0;z-index:2;height:40px;border-bottom:1px solid #d4d4d8;background:#eef0ef;padding:0 11px;color:#52525b;font-size:11px;font-weight:600;text-align:left;white-space:nowrap} +.table td{height:44px;border-bottom:1px solid #f0f0f1;padding:7px 11px;color:#52525b;vertical-align:middle} +.table tbody tr:hover>td{background:#fafafa} +.table th.finalHeader{border-right:1px solid #fed7aa;border-left:1px solid #fed7aa;background:#fff1e6;color:#b45309} +.table td.finalCell{border-right:1px solid #fed7aa;border-left:1px solid #fed7aa;background:#fff8ed;color:#b45309;font-weight:700} +.table tbody tr:hover>td.finalCell{background:#fff2df} +.table th.freightHeader{background:#eff6ff;color:#1d4ed8} +.table td.freightCell{background:#f8fbff;color:#1d4ed8;font-weight:700} +.table tbody tr:hover>td.freightCell{background:#eff6ff} +.table th.clearanceHeader{background:#f0fdf4;color:#15803d} +.table td.clearanceCell{background:#f8fff9;color:#15803d;font-weight:700} +.table tbody tr:hover>td.clearanceCell{background:#f0fdf4} +.finalNegative{color:#b91c1c!important} +.table .totalRow>td{border-top:1px solid #d4d4d8;background:#f8fafc;color:#18181b;font-weight:700} +.table .totalRow>td.finalTotalCell{border-right:1px solid #fed7aa;border-left:1px solid #fed7aa;background:#fff1e6;color:#b45309} +.table .totalRow>td.freightCell{background:#eff6ff;color:#1d4ed8} +.table .totalRow>td.clearanceCell{background:#f0fdf4;color:#15803d} +.number{text-align:right!important;font-variant-numeric:tabular-nums;white-space:nowrap} +.code{color:#27272a!important;font-family:ui-monospace,SFMono-Regular,Menlo,monospace;font-size:11px;white-space:nowrap} +.nowrap{white-space:nowrap} +.shopCell{min-width:230px} +.nameCell{min-width:260px;max-width:340px;overflow:hidden;text-overflow:ellipsis;white-space:nowrap} +.propertiesCell{min-width:190px;max-width:260px;overflow:hidden;text-overflow:ellipsis;white-space:nowrap} +.reasonCell{min-width:180px;max-width:260px;overflow:hidden;text-overflow:ellipsis;white-space:nowrap} +.status{display:inline-flex;border-radius:999px;background:#ecfdf5;padding:3px 8px;color:#047857;font-size:10px;font-weight:600;white-space:nowrap} +.afterSaleType{display:inline-flex;border-radius:999px;background:#fff7ed;padding:3px 8px;color:#c2410c;font-size:10px;font-weight:600;white-space:nowrap} +.empty{height:220px!important;color:#a1a1aa!important;text-align:center} +.pagination{display:flex;flex:none;flex-wrap:wrap;align-items:center;justify-content:space-between;gap:12px;border-top:1px solid var(--sc-border);background:var(--sc-surface);padding:10px 24px;color:var(--sc-muted);font-size:11px} +.pagination>div{display:flex;align-items:center;gap:4px} +.pagination button{min-width:30px;height:28px;border:1px solid #d4d4d8;border-radius:5px;background:#fff;padding:0 8px;color:#52525b;font-size:11px;font-family:inherit;cursor:pointer} +.pagination button:disabled{cursor:not-allowed;opacity:.4} +.pagination .pageActive{border-color:#27272a!important;background:#27272a!important;color:#fff!important} +.pendingPanel{display:flex;min-height:320px;flex:1;flex-direction:column;align-items:center;justify-content:center;gap:8px;color:#a1a1aa} +.pendingPanel span{color:#52525b;font-size:13px;font-weight:600} +.pendingPanel p{margin:0;font-size:12px} +@media(max-width:1100px){.filterActions{justify-content:flex-start;flex-wrap:wrap}.header{align-items:flex-start}.headerMeta{align-items:flex-start}} +@media(max-width:760px){.header{flex-direction:column}.tabs,.filters,.tableWrap,.pagination{padding-right:14px;padding-left:14px}.detailFilterBar{flex-direction:column;gap:7px}.detailFilterLabel{padding-top:0}.detailFilterButtons{width:100%}.detailFilterPopover{width:min(280px,calc(100vw - 40px))}.dateFilterPopover{width:min(390px,calc(100vw - 28px))}.filterActions>span{white-space:normal}} diff --git a/furniture-3d-system/src/lib/external-clearance-price.test.ts b/furniture-3d-system/src/lib/external-clearance-price.test.ts new file mode 100644 index 00000000..1387a943 --- /dev/null +++ b/furniture-3d-system/src/lib/external-clearance-price.test.ts @@ -0,0 +1,50 @@ +import { buildExternalClearancePriceRows } from './external-clearance-price' + +describe('external clearance price', () => { + it('deduplicates order and item code and uses the latest cost price', () => { + const rows = buildExternalClearancePriceRows([ + { + onlineOrderNo: 'WM-001', + internalOrderNo: '', + productCode: 'SKU-001', + styleCode: '', + shopProductCode: '', + shopStyleCode: '', + costPrice: '18.50', + }, + { + onlineOrderNo: 'wm-001', + internalOrderNo: '', + productCode: 'sku-001', + styleCode: '', + shopProductCode: '', + shopStyleCode: '', + costPrice: '99', + }, + { + onlineOrderNo: '', + internalOrderNo: '10001', + productCode: '', + styleCode: 'STYLE-001', + shopProductCode: '', + shopStyleCode: '', + costPrice: 8, + }, + ]) + + expect(rows).toEqual([ + { + orderNo: '10001', + itemCode: 'STYLE-001', + costPrice: 8, + clearancePrice: 8, + }, + { + orderNo: 'WM-001', + itemCode: 'SKU-001', + costPrice: 18.5, + clearancePrice: 18.5, + }, + ]) + }) +}) diff --git a/furniture-3d-system/src/lib/external-clearance-price.ts b/furniture-3d-system/src/lib/external-clearance-price.ts new file mode 100644 index 00000000..e4a5a5ec --- /dev/null +++ b/furniture-3d-system/src/lib/external-clearance-price.ts @@ -0,0 +1,45 @@ +export type ExternalOrderCostSourceRow = { + onlineOrderNo: string + internalOrderNo: string + productCode: string + styleCode: string + shopProductCode: string + shopStyleCode: string + costPrice: number | string +} + +export type ExternalClearancePriceRow = { + orderNo: string + itemCode: string + costPrice: number + clearancePrice: number +} + +export function buildExternalClearancePriceRows( + rows: readonly ExternalOrderCostSourceRow[], +): ExternalClearancePriceRow[] { + const result: ExternalClearancePriceRow[] = [] + const seen = new Set() + for (const row of rows) { + const orderNo = row.onlineOrderNo.trim() || row.internalOrderNo.trim() + const itemCode = row.productCode.trim() + || row.styleCode.trim() + || row.shopProductCode.trim() + || row.shopStyleCode.trim() + const costPrice = Number(row.costPrice) + if (!orderNo || !itemCode || !Number.isFinite(costPrice)) continue + const key = `${orderNo.toUpperCase()}|${itemCode.toUpperCase()}` + if (seen.has(key)) continue + seen.add(key) + result.push({ + orderNo, + itemCode, + costPrice, + clearancePrice: costPrice, + }) + } + return result.sort((left, right) => ( + left.orderNo.localeCompare(right.orderNo, 'zh-CN') + || left.itemCode.localeCompare(right.itemCode, 'zh-CN') + )) +} diff --git a/furniture-3d-system/src/lib/external-freight.test.ts b/furniture-3d-system/src/lib/external-freight.test.ts new file mode 100644 index 00000000..05bf31c8 --- /dev/null +++ b/furniture-3d-system/src/lib/external-freight.test.ts @@ -0,0 +1,56 @@ +import ExcelJS from 'exceljs' +import { + createExternalFreightTemplate, + EXTERNAL_FREIGHT_HEADERS, + parseExternalFreightWorkbook, +} from './external-freight' + +async function workbookBuffer(rows: unknown[][]) { + const workbook = new ExcelJS.Workbook() + const sheet = workbook.addWorksheet('货代费') + for (const row of rows) sheet.addRow(row) + return Buffer.from(await workbook.xlsx.writeBuffer()) +} + +describe('external freight import', () => { + it('parses the screenshot headers and order values', async () => { + const rows = await parseExternalFreightWorkbook(await workbookBuffer([ + EXTERNAL_FREIGHT_HEADERS, + ['2026年11月', 'WM20260917FLD-MANILA-34', 1394, null, 6630, ''], + ])) + + expect(rows).toEqual([{ + rowNumber: 2, + shipMonth: '2026-11', + orderNo: 'WM20260917FLD-MANILA-34', + outboundQty: 1394, + incomeAfterTaxRefund: null, + estimatedFreight: 6630, + remark: '', + }]) + }) + + it('creates the downloadable template with the required headers', async () => { + const workbook = new ExcelJS.Workbook() + await workbook.xlsx.load(await createExternalFreightTemplate() as never) + const sheet = workbook.getWorksheet('货代费') + + expect(sheet?.getRow(1).values.slice(1)).toEqual([...EXTERNAL_FREIGHT_HEADERS]) + expect(sheet?.getRow(2).values.slice(1)).toEqual([ + '2026年11月', + 'WM20260917FLD-MANILA-34', + 1394, + undefined, + 6630, + '', + ]) + }) + + it('rejects duplicate order numbers in one file', async () => { + await expect(parseExternalFreightWorkbook(await workbookBuffer([ + EXTERNAL_FREIGHT_HEADERS, + ['2026年11月', 'WM-001', 1, 100, 20, ''], + ['2026年11月', 'wm-001', 2, 200, 30, ''], + ]))).rejects.toThrow('订单号重复') + }) +}) diff --git a/furniture-3d-system/src/lib/external-freight.ts b/furniture-3d-system/src/lib/external-freight.ts new file mode 100644 index 00000000..fe47afec --- /dev/null +++ b/furniture-3d-system/src/lib/external-freight.ts @@ -0,0 +1,240 @@ +import ExcelJS from 'exceljs' + +export const EXTERNAL_FREIGHT_HEADERS = [ + '发货月份', + '订单号', + '出库数量(以实际为准)', + '收入-减退税(CNY)', + '预估货运费(货代+海运)', + '备注', +] as const + +export type ExternalFreightImportRow = { + rowNumber: number + shipMonth: string + orderNo: string + outboundQty: number + incomeAfterTaxRefund: number | null + estimatedFreight: number + remark: string +} + +export type ExternalFreightRecordView = { + id: string + shipMonth: string + orderNo: string + outboundQty: number + incomeAfterTaxRefund: number | null + estimatedFreight: number + remark: string + sourceFileName: string + importedByName: string + createdAt: string + updatedAt: string +} + +function normalizedHeader(value: string) { + return value + .trim() + .replace(/\s+/g, '') + .replaceAll('(', '(') + .replaceAll(')', ')') +} + +function cellText(value: ExcelJS.CellValue, field: string) { + if (value == null) return '' + if (value instanceof Date) throw new Error(`${field}格式不正确`) + if (typeof value === 'object') { + if ('text' in value && typeof value.text === 'string') return value.text.trim() + if ('result' in value && value.result != null) return String(value.result).trim() + throw new Error(`${field}包含公式,请先粘贴为值`) + } + return String(value).trim() +} + +function requiredNumber( + value: ExcelJS.CellValue, + field: string, + options: { integer?: boolean; min?: number }, +) { + const text = cellText(value, field).replaceAll(',', '') + if (!text) throw new Error(`${field}不能为空`) + const parsed = Number(text) + if (!Number.isFinite(parsed) + || (options.integer && !Number.isInteger(parsed)) + || (options.min != null && parsed < options.min)) { + throw new Error(`${field}格式不正确`) + } + return parsed +} + +function optionalNumber(value: ExcelJS.CellValue, field: string) { + const text = cellText(value, field).replaceAll(',', '') + if (!text) return null + const parsed = Number(text) + if (!Number.isFinite(parsed)) throw new Error(`${field}格式不正确`) + return parsed +} + +function freightShipMonth(value: ExcelJS.CellValue) { + if (value instanceof Date) { + return `${value.getFullYear()}-${String(value.getMonth() + 1).padStart(2, '0')}` + } + const text = cellText(value, '发货月份').trim() + if (!text) throw new Error('发货月份不能为空') + const chinese = /^(\d{4})年(0?[1-9]|1[0-2])月$/.exec(text) + if (chinese) return `${chinese[1]}-${chinese[2].padStart(2, '0')}` + const separated = /^(\d{4})[-/.](\d{1,2})(?:[-/.]\d{1,2})?$/.exec(text) + if (separated && Number(separated[2]) >= 1 && Number(separated[2]) <= 12) { + return `${separated[1]}-${separated[2].padStart(2, '0')}` + } + throw new Error('发货月份格式不正确,请填写如 2026年11月 或 2026-11') +} + +export async function parseExternalFreightWorkbook( + buffer: Buffer, +): Promise { + const workbook = new ExcelJS.Workbook() + await workbook.xlsx.load(buffer as never) + let worksheet: ExcelJS.Worksheet | null = null + let columns = new Map() + const expected = new Map(EXTERNAL_FREIGHT_HEADERS.map((header) => [normalizedHeader(header), header])) + + for (const candidate of workbook.worksheets) { + const found = new Map() + candidate.getRow(1).eachCell((cell, columnNumber) => { + const normalized = normalizedHeader(cellText(cell.value, '抬头')) + const header = expected.get(normalized) + if (header) found.set(header, columnNumber) + }) + if (EXTERNAL_FREIGHT_HEADERS.every((header) => found.has(header))) { + worksheet = candidate + columns = found + break + } + } + if (!worksheet) { + throw new Error(`未找到内容匹配的导入模板,表头必须包含:${EXTERNAL_FREIGHT_HEADERS.join('、')}`) + } + + const rows: ExternalFreightImportRow[] = [] + const seenOrders = new Set() + worksheet.eachRow((row, rowNumber) => { + if (rowNumber === 1) return + const value = (header: typeof EXTERNAL_FREIGHT_HEADERS[number]) => ( + row.getCell(columns.get(header)!).value + ) + const shipMonthValue = value('发货月份') + const orderNo = cellText(value('订单号'), '订单号') + const outboundText = cellText(value('出库数量(以实际为准)'), '出库数量') + const incomeText = cellText(value('收入-减退税(CNY)'), '收入-减退税') + const freightText = cellText(value('预估货运费(货代+海运)'), '预估货运费') + const remark = cellText(value('备注'), '备注') + if (![ + cellText(shipMonthValue, '发货月份'), + orderNo, + outboundText, + incomeText, + freightText, + remark, + ].some(Boolean)) return + if (!orderNo) throw new Error(`第 ${rowNumber} 行订单号不能为空`) + const normalizedOrderNo = orderNo.toUpperCase() + if (seenOrders.has(normalizedOrderNo)) { + throw new Error(`第 ${rowNumber} 行订单号重复:${orderNo}`) + } + seenOrders.add(normalizedOrderNo) + try { + rows.push({ + rowNumber, + shipMonth: freightShipMonth(shipMonthValue), + orderNo, + outboundQty: requiredNumber(value('出库数量(以实际为准)'), '出库数量', { + integer: true, + min: 0, + }), + incomeAfterTaxRefund: optionalNumber(value('收入-减退税(CNY)'), '收入-减退税'), + estimatedFreight: requiredNumber(value('预估货运费(货代+海运)'), '预估货运费', { + min: 0, + }), + remark, + }) + } catch (error) { + throw new Error(`第 ${rowNumber} 行${error instanceof Error ? error.message : '数据格式不正确'}`) + } + }) + if (!rows.length) throw new Error('Excel 没有可导入的数据') + if (rows.length > 5_000) throw new Error('单个文件最多导入 5000 行') + return rows +} + +export async function createExternalFreightTemplate() { + const workbook = new ExcelJS.Workbook() + workbook.creator = '供应链中心 · 外销销量' + workbook.created = new Date() + const worksheet = workbook.addWorksheet('货代费', { + views: [{ state: 'frozen', ySplit: 1 }], + }) + worksheet.columns = [ + { header: '发货月份', key: 'shipMonth', width: 18 }, + { header: '订单号', key: 'orderNo', width: 32 }, + { header: '出库数量(以实际为准)', key: 'outboundQty', width: 24 }, + { header: '收入-减退税(CNY)', key: 'incomeAfterTaxRefund', width: 22 }, + { header: '预估货运费(货代+海运)', key: 'estimatedFreight', width: 28 }, + { header: '备注', key: 'remark', width: 24 }, + ] + const exampleRow = worksheet.addRow({ + shipMonth: '2026年11月', + orderNo: 'WM20260917FLD-MANILA-34', + outboundQty: 1394, + incomeAfterTaxRefund: null, + estimatedFreight: 6630, + remark: '', + }) + exampleRow.font = { color: { argb: 'FF6B7280' } } + exampleRow.getCell(5).fill = { + type: 'pattern', + pattern: 'solid', + fgColor: { argb: 'FFE2F0D9' }, + } + const headerRow = worksheet.getRow(1) + headerRow.height = 28 + headerRow.eachCell((cell) => { + cell.font = { bold: true } + cell.alignment = { vertical: 'middle', horizontal: 'center' } + cell.fill = { + type: 'pattern', + pattern: 'solid', + fgColor: { argb: 'FFF2F2F2' }, + } + cell.border = { + bottom: { style: 'thin', color: { argb: 'FFD9D9D9' } }, + } + }) + worksheet.getCell('E1').fill = { + type: 'pattern', + pattern: 'solid', + fgColor: { argb: 'FFE2F0D9' }, + } + worksheet.getColumn(1).numFmt = '@' + worksheet.getColumn(2).numFmt = '@' + worksheet.getColumn(3).numFmt = '0' + worksheet.getColumn(4).numFmt = '#,##0.00' + worksheet.getColumn(5).numFmt = '#,##0.00' + + const instructions = workbook.addWorksheet('填写说明') + instructions.columns = [{ width: 100 }] + for (const line of [ + '1、发货月份按月填写,例如 2026年11月;模板第二行为示例,请替换或删除后导入。', + '2、订单号、出库数量(以实际为准)、预估货运费(货代+海运)为必填项。', + '3、收入-减退税(CNY)和备注为选填项,收入-减退税允许填写负数。', + '4、重复导入同一订单号时,以最后一次导入内容覆盖更新。', + '5、单个文件最多 5000 行、不超过 10MB。', + '6、不要填写公式,请粘贴为值。', + ]) { + const row = instructions.addRow([line]) + row.alignment = { vertical: 'middle', wrapText: true } + row.height = 26 + } + return Buffer.from(await workbook.xlsx.writeBuffer()) +} diff --git a/furniture-3d-system/src/lib/external-profit.test.ts b/furniture-3d-system/src/lib/external-profit.test.ts new file mode 100644 index 00000000..321257a3 --- /dev/null +++ b/furniture-3d-system/src/lib/external-profit.test.ts @@ -0,0 +1,51 @@ +import { buildExternalProfitRows } from './external-profit' +import type { ExternalSalesDetailRow } from './external-sales' + +const saleRow = { + statsDate: '2026-11-10', + finalShipAmount: 1000, + afterSaleAmount: 100, + goodsValue: 500, + clearanceGoodsValue: 600, + freight: 50, +} as ExternalSalesDetailRow + +describe('external profit', () => { + it('calculates the cost-price dimension by shipment month', () => { + const rows = buildExternalProfitRows({ + basis: 'cost', + salesRows: [saleRow], + freightRows: [{ shipMonth: '2026-11', estimatedFreight: 100 }], + }) + + expect(rows[0]).toMatchObject({ + shipMonth: '2026-11', + platform: '外贸', + profitCenter: '外贸部', + salesAmount: 1000, + realPerformance: 1000, + purchaseCost: 500, + totalCost: 500, + freight: 50, + otherCourierFreight: 100, + totalFreight: 150, + grossProfit: 350, + grossMargin: 350 / 1000, + }) + }) + + it('uses clearance goods value in the clearance-price dimension', () => { + const rows = buildExternalProfitRows({ + basis: 'clearance', + salesRows: [saleRow], + freightRows: [{ shipMonth: '2026-11', estimatedFreight: 100 }], + }) + + expect(rows[0]).toMatchObject({ + purchaseCost: 600, + totalCost: 600, + grossProfit: 250, + grossMargin: 250 / 1000, + }) + }) +}) diff --git a/furniture-3d-system/src/lib/external-profit.ts b/furniture-3d-system/src/lib/external-profit.ts new file mode 100644 index 00000000..6d337fb6 --- /dev/null +++ b/furniture-3d-system/src/lib/external-profit.ts @@ -0,0 +1,96 @@ +import type { ExternalSalesDetailRow } from '@/lib/external-sales' + +export type ExternalProfitBasis = 'cost' | 'clearance' + +export type ExternalProfitFreightInput = { + shipMonth: string + estimatedFreight: number +} + +export type ExternalProfitRow = { + shipMonth: string + platform: '外贸' + profitCenter: '外贸部' + salesAmount: number + realPerformance: number + purchaseCost: number + costAdjustment: number + totalCost: number + freight: number + otherCourierFreight: number + totalFreight: number + installationFee: number + grossProfit: number + grossMargin: number +} + +function money(value: number) { + return Math.round(value * 100) / 100 +} + +export function buildExternalProfitRows(input: { + basis: ExternalProfitBasis + salesRows: readonly ExternalSalesDetailRow[] + freightRows: readonly ExternalProfitFreightInput[] +}): ExternalProfitRow[] { + const otherFreightByMonth = new Map() + for (const row of input.freightRows) { + otherFreightByMonth.set( + row.shipMonth, + (otherFreightByMonth.get(row.shipMonth) ?? 0) + row.estimatedFreight, + ) + } + + const grouped = new Map() + for (const row of input.salesRows) { + const month = row.statsDate.slice(0, 7) + const current = grouped.get(month) ?? { + salesAmount: 0, + purchaseCost: 0, + freight: 0, + } + current.salesAmount += row.finalShipAmount + current.purchaseCost += input.basis === 'clearance' + ? row.clearanceGoodsValue ?? 0 + : row.goodsValue ?? 0 + current.freight += row.freight ?? 0 + grouped.set(month, current) + } + + return [...grouped.entries()] + .map(([shipMonth, values]): ExternalProfitRow => { + const salesAmount = money(values.salesAmount) + const realPerformance = salesAmount + const purchaseCost = money(values.purchaseCost) + const costAdjustment = 0 + const totalCost = money(purchaseCost + costAdjustment) + const freight = money(values.freight) + const otherCourierFreight = money(otherFreightByMonth.get(shipMonth) ?? 0) + const totalFreight = money(freight + otherCourierFreight) + const installationFee = 0 + const grossProfit = money( + realPerformance - totalCost - totalFreight - installationFee, + ) + return { + shipMonth, + platform: '外贸', + profitCenter: '外贸部', + salesAmount, + realPerformance, + purchaseCost, + costAdjustment, + totalCost, + freight, + otherCourierFreight, + totalFreight, + installationFee, + grossProfit, + grossMargin: realPerformance === 0 ? 0 : grossProfit / realPerformance, + } + }) + .sort((left, right) => right.shipMonth.localeCompare(left.shipMonth)) +} diff --git a/furniture-3d-system/src/lib/external-sales-export.test.ts b/furniture-3d-system/src/lib/external-sales-export.test.ts new file mode 100644 index 00000000..45c9b787 --- /dev/null +++ b/furniture-3d-system/src/lib/external-sales-export.test.ts @@ -0,0 +1,187 @@ +import { + buildExternalSalesExportRows, + createExternalSalesExportWorkbook, +} from './external-sales-export' + +describe('external sales export', () => { + it('adds a summary total row', () => { + const rows = buildExternalSalesExportRows('summary', [ + { + month: '2026-10', + orderNo: 'WM-001', + shipAmount: 100, + shipQty: 2, + afterSaleAmount: 10, + afterSaleQty: 1, + finalShipAmount: 90, + finalShipQty: 1, + }, + { + month: '2026-10', + orderNo: 'WM-002', + shipAmount: 250.5, + shipQty: 3, + afterSaleAmount: 20, + afterSaleQty: 2, + finalShipAmount: 230.5, + finalShipQty: 1, + }, + ]) + + expect(rows.at(-1)).toEqual({ + 月份: '合计', + 订单号: '', + 发货金额: 350.5, + 发货数量: 5, + 售后金额: 30, + 售后数量: 3, + 最终发货金额: 320.5, + 最终发货数量: 2, + }) + }) + + it('keeps the visible detail fields in the exported rows', () => { + const rows = buildExternalSalesExportRows('detail', [{ + sendDate: '2026-10-17 16:56:22', + orderNo: 'WM-001', + oId: '9807341', + shippingCourier: '中铁物流', + trackingNo: '119033220001', + shopName: '外贸日常店铺', + skuId: 'SKU-001', + itemId: 'ITEM-001', + shopSkuId: 'SHOP-SKU-001', + shopItemId: 'SHOP-ITEM-001', + itemName: '测试商品', + propertiesValue: '原木色', + qty: 2, + amount: 100, + afterSaleAmount: 20, + afterSaleQty: 1, + finalShipAmount: 80, + finalShipQty: 1, + costPrice: 30, + goodsValue: 30, + clearancePrice: 35, + clearanceGoodsValue: 35, + freight: 12.5, + statusLabel: '已发货', + orderDate: '2026-10-16 10:00:00', + }]) + + expect(rows[0]).toMatchObject({ + 订单号: 'WM-001', + 内部单号: '9807341', + 成本: 30, + 货值: 30, + 清货价: 35, + 清货货值: 35, + 运费: 12.5, + '发货金额(已付)': 100, + 售后金额: 20, + 售后数量: 1, + 最终发货金额: 80, + 最终发货数量: 1, + 清货货值: 35, + 运费: 12.5, + }) + expect(rows.at(-1)).toMatchObject({ + 发货时间: '合计', + 发货数量: 2, + 售后数量: 1, + 最终发货数量: 1, + 货值: 30, + }) + }) + + it('omits empty shop code columns from detail exports', () => { + const rows = buildExternalSalesExportRows('detail', [{ + shopSkuId: '', + shopItemId: '', + }]) + + expect(rows[0]).not.toHaveProperty('店铺商品编码') + expect(rows[0]).not.toHaveProperty('店铺款式编码') + }) + + it('exports freight rows with the screenshot headers', () => { + const rows = buildExternalSalesExportRows('freight', [{ + shipMonth: '2026-11', + orderNo: 'WM-001', + outboundQty: 10, + incomeAfterTaxRefund: 100, + estimatedFreight: 20, + remark: '', + }]) + + expect(rows[0]).toEqual({ + 发货月份: '2026年11月', + 订单号: 'WM-001', + '出库数量(以实际为准)': 10, + '收入-减退税(CNY)': 100, + '预估货运费(货代+海运)': 20, + 备注: '', + }) + }) + + it('exports clearance price from external order cost rows', () => { + const rows = buildExternalSalesExportRows('clearance', [{ + orderNo: 'WM-001', + itemCode: 'SKU-001', + costPrice: 18.5, + clearancePrice: 18.5, + }]) + + expect(rows[0]).toEqual({ + 订单号: 'WM-001', + 商品编码: 'SKU-001', + 成本价: 18.5, + 清货价: 18.5, + }) + }) + + it('exports both profit dimensions with all requested headers', () => { + const rows = buildExternalSalesExportRows('profit', [{ + shipMonth: '2026-11', + platform: '外贸', + profitCenter: '外贸部', + salesAmount: 1000, + realPerformance: 1000, + purchaseCost: 500, + costAdjustment: 0, + totalCost: 500, + freight: 50, + otherCourierFreight: 100, + totalFreight: 150, + installationFee: 0, + grossProfit: 350, + grossMargin: 350 / 1000, + }]) + + expect(rows[0]).toMatchObject({ + 发货月份: '2026-11', + 平台: '外贸', + 利润中心: '外贸部', + 销售金额: 1000, + 真实业绩: 1000, + 采购成本: 500, + 总成本: 500, + 运费: 50, + 其他快递运费: 100, + 总运费: 150, + 毛利额: 350, + 毛利率: '35.00%', + }) + }) + + it('builds an xlsx workbook for an empty pending page', async () => { + const result = await createExternalSalesExportWorkbook({ + view: 'freight', + rows: [], + now: new Date('2026-11-16T02:03:04.000Z'), + }) + + expect(result.fileName).toMatch(/^外销销量-货代费-20261116-/) + expect(result.bytes.byteLength).toBeGreaterThan(0) + }) +}) diff --git a/furniture-3d-system/src/lib/external-sales-export.ts b/furniture-3d-system/src/lib/external-sales-export.ts new file mode 100644 index 00000000..7673e47c --- /dev/null +++ b/furniture-3d-system/src/lib/external-sales-export.ts @@ -0,0 +1,223 @@ +import type { + ExternalSalesAfterSaleRow, + ExternalSalesDetailRow, + ExternalSalesSummaryRow, +} from '@/lib/external-sales' +import type { ExternalFreightRecordView } from '@/lib/external-freight' +import type { ExternalClearancePriceRow } from '@/lib/external-clearance-price' +import type { ExternalProfitRow } from '@/lib/external-profit' + +export type ExternalSalesExportView = + | 'summary' + | 'detail' + | 'afterSale' + | 'freight' + | 'clearance' + | 'profit' + +type ExportCell = string | number +type ExportRow = Record + +const VIEW_LABELS: Record = { + summary: '汇总', + detail: '明细', + afterSale: '售后明细', + freight: '货代费', + clearance: '清货价', + profit: '毛利', +} + +function roundMoney(value: number) { + return Math.round(value * 100) / 100 +} + +export function buildExternalSalesExportRows( + view: ExternalSalesExportView, + rows: readonly unknown[], +): ExportRow[] { + if (view === 'summary') { + const summaryRows = rows as ExternalSalesSummaryRow[] + const data = summaryRows.map((row) => ({ + 月份: row.month, + 订单号: row.orderNo, + 发货金额: row.shipAmount, + 发货数量: row.shipQty, + 售后金额: row.afterSaleAmount, + 售后数量: row.afterSaleQty, + 最终发货金额: row.finalShipAmount, + 最终发货数量: row.finalShipQty, + })) + if (data.length === 0) return [] + return [...data, { + 月份: '合计', + 订单号: '', + 发货金额: roundMoney(data.reduce((sum, row) => sum + row.发货金额, 0)), + 发货数量: data.reduce((sum, row) => sum + row.发货数量, 0), + 售后金额: roundMoney(data.reduce((sum, row) => sum + row.售后金额, 0)), + 售后数量: data.reduce((sum, row) => sum + row.售后数量, 0), + 最终发货金额: roundMoney(data.reduce((sum, row) => sum + row.最终发货金额, 0)), + 最终发货数量: data.reduce((sum, row) => sum + row.最终发货数量, 0), + }] + } + + if (view === 'detail') { + const detailRows = rows as ExternalSalesDetailRow[] + const hasShopSkuId = detailRows.some((row) => row.shopSkuId.trim().length > 0) + const hasShopItemId = detailRows.some((row) => row.shopItemId.trim().length > 0) + const data: ExportRow[] = detailRows.map((row) => ({ + 发货时间: row.sendDate, + 订单号: row.orderNo, + 内部单号: row.oId, + 发货快递: row.shippingCourier, + 运单号: row.trackingNo, + 店铺名称: row.shopName, + 原始商品编码: row.skuId, + 款式编码: row.itemId, + ...(hasShopSkuId ? { 店铺商品编码: row.shopSkuId } : {}), + ...(hasShopItemId ? { 店铺款式编码: row.shopItemId } : {}), + 商品名称: row.itemName, + 属性: row.propertiesValue, + 发货数量: row.qty, + '发货金额(已付)': row.amount, + 售后金额: row.afterSaleAmount, + 售后数量: row.afterSaleQty, + 最终发货金额: row.finalShipAmount, + 最终发货数量: row.finalShipQty, + 成本: row.costPrice ?? '', + 货值: row.goodsValue ?? '', + 清货价: row.clearancePrice ?? '', + 清货货值: row.clearanceGoodsValue ?? '', + 运费: row.freight ?? '', + 明细状态: row.statusLabel, + 下单时间: row.orderDate, + })) + if (data.length === 0) return [] + return [...data, { + 发货时间: '合计', + 订单号: '', + 内部单号: '', + 发货快递: '', + 运单号: '', + 店铺名称: '', + 原始商品编码: '', + 款式编码: '', + ...(hasShopSkuId ? { 店铺商品编码: '' } : {}), + ...(hasShopItemId ? { 店铺款式编码: '' } : {}), + 商品名称: '', + 属性: '', + 发货数量: detailRows.reduce((sum, row) => sum + row.qty, 0), + '发货金额(已付)': roundMoney(detailRows.reduce((sum, row) => sum + row.amount, 0)), + 售后金额: roundMoney(detailRows.reduce((sum, row) => sum + row.afterSaleAmount, 0)), + 售后数量: detailRows.reduce((sum, row) => sum + row.afterSaleQty, 0), + 最终发货金额: roundMoney(detailRows.reduce((sum, row) => sum + row.finalShipAmount, 0)), + 最终发货数量: detailRows.reduce((sum, row) => sum + row.finalShipQty, 0), + 成本: '', + 货值: roundMoney(detailRows.reduce((sum, row) => sum + (row.goodsValue ?? 0), 0)), + 清货价: '', + 清货货值: roundMoney( + detailRows.reduce((sum, row) => sum + (row.clearanceGoodsValue ?? 0), 0), + ), + 运费: roundMoney(detailRows.reduce((sum, row) => sum + (row.freight ?? 0), 0)), + 明细状态: '', + 下单时间: '', + }] + } + + if (view === 'afterSale') { + return (rows as ExternalSalesAfterSaleRow[]).map((row) => ({ + 售后日期: row.asDate, + 店铺名称: row.shopName, + 原订单号: row.orderNo, + 商品编码: row.skuId, + 售后数量: row.qty, + 售后金额: row.refundAmount, + })) + } + + if (view === 'freight') { + return (rows as ExternalFreightRecordView[]).map((row) => ({ + 发货月份: /^\d{4}-\d{2}$/.test(row.shipMonth) + ? `${row.shipMonth.slice(0, 4)}年${Number(row.shipMonth.slice(5, 7))}月` + : row.shipMonth, + 订单号: row.orderNo, + '出库数量(以实际为准)': row.outboundQty, + '收入-减退税(CNY)': row.incomeAfterTaxRefund ?? '', + '预估货运费(货代+海运)': row.estimatedFreight, + 备注: row.remark, + })) + } + + if (view === 'clearance') { + return (rows as ExternalClearancePriceRow[]).map((row) => ({ + 订单号: row.orderNo, + 商品编码: row.itemCode, + 成本价: row.costPrice, + 清货价: row.clearancePrice, + })) + } + + if (view === 'profit') { + return (rows as ExternalProfitRow[]).map((row) => ({ + 发货月份: row.shipMonth, + 平台: row.platform, + 利润中心: row.profitCenter, + 销售金额: row.salesAmount, + 真实业绩: row.realPerformance, + 采购成本: row.purchaseCost, + 成本调整: row.costAdjustment, + 总成本: row.totalCost, + 运费: row.freight, + 其他快递运费: row.otherCourierFreight, + 总运费: row.totalFreight, + 安装费: row.installationFee, + 毛利额: row.grossProfit, + 毛利率: `${(row.grossMargin * 100).toFixed(2)}%`, + })) + } + + return [{ + 页面: VIEW_LABELS[view], + 数据状态: '暂无数据', + }] +} + +function exportTimestamp(value: Date) { + const parts = new Intl.DateTimeFormat('zh-CN', { + timeZone: 'Asia/Shanghai', + year: 'numeric', + month: '2-digit', + day: '2-digit', + hour: '2-digit', + minute: '2-digit', + second: '2-digit', + hour12: false, + }).formatToParts(value) + const part = (type: Intl.DateTimeFormatPartTypes) => ( + parts.find((item) => item.type === type)?.value ?? '' + ) + return `${part('year')}${part('month')}${part('day')}-${part('hour')}${part('minute')}${part('second')}` +} + +export async function createExternalSalesExportWorkbook(input: { + view: ExternalSalesExportView + rows: readonly unknown[] + now?: Date +}) { + const XLSX = await import('xlsx') + const exportRows = buildExternalSalesExportRows(input.view, input.rows) + const sheetRows = exportRows.length > 0 + ? exportRows + : [{ 页面: VIEW_LABELS[input.view], 数据状态: '暂无数据' }] + const worksheet = XLSX.utils.json_to_sheet(sheetRows) + const headers = Object.keys(sheetRows[0] ?? {}) + worksheet['!cols'] = headers.map((header) => ({ + wch: Math.min(42, Math.max(12, header.length * 2 + 2)), + })) + const workbook = XLSX.utils.book_new() + XLSX.utils.book_append_sheet(workbook, worksheet, VIEW_LABELS[input.view]) + const bytes = XLSX.write(workbook, { bookType: 'xlsx', type: 'array' }) as ArrayBuffer + return { + bytes, + fileName: `外销销量-${VIEW_LABELS[input.view]}-${exportTimestamp(input.now ?? new Date())}.xlsx`, + } +} diff --git a/furniture-3d-system/src/lib/external-sales.test.ts b/furniture-3d-system/src/lib/external-sales.test.ts new file mode 100644 index 00000000..0535a0ea --- /dev/null +++ b/furniture-3d-system/src/lib/external-sales.test.ts @@ -0,0 +1,338 @@ +import { + allocateExternalSalesPaidAmounts, + applyExternalSalesAfterSaleMetrics, + applyExternalSalesClearancePrices, + applyExternalSalesFreight, + buildExternalSalesDetailAfterSaleMetricsSql, + buildExternalSalesAfterSaleMetricsSql, + buildExternalSalesAfterSaleWhereSql, + buildExternalSalesSourceSql, + buildExternalSalesSummary, + buildExternalSalesWaybillFreightSql, + enrichExternalSalesItemCosts, + externalSalesMonthRange, + filterExternalSalesItems, + parseExternalSalesDetailFilters, + resolveExternalSalesTargetShop, + toExternalSalesDetailRows, + type ExternalSalesItemRow, +} from './external-sales' + +function item(overrides: Partial = {}): ExternalSalesItemRow { + return { + sourceType: 'QMCUST', + oId: '1', + oiId: '11', + orderNo: 'WM-001', + shopName: '外贸日常店铺', + shippingCourier: '', + trackingNo: '', + shipmentWeight: null, + shippingUnitWeight: null, + shippingWeight: null, + freight: null, + statsDate: '2026-11-06', + orderDate: '2026-11-06 10:00:00', + sendDate: '2026-11-07 11:00:00', + orderStatus: 'Sent', + itemStatus: '', + ownerName: '张三', + localItemId: '10', + skuId: 'SKU-001', + itemId: 'ITEM-001', + shopSkuId: 'SHOP-SKU-001', + shopItemId: 'SHOP-ITEM-001', + propertiesValue: '原木色', + itemName: '测试商品', + basePrice: 120, + price: 100, + qty: 2, + amount: 200, + afterSaleAmount: 0, + afterSaleQty: 0, + finalShipAmount: 200, + finalShipQty: 2, + orderPaidAmount: null, + outerOiId: 'OUTER-001', + costPrice: null, + goodsValue: null, + clearancePrice: null, + clearanceGoodsValue: null, + refundStatus: '', + refundQty: 0, + ...overrides, + } +} + +describe('external sales', () => { + it('normalizes underscore and hyphen shop-name variants', () => { + expect(resolveExternalSalesTargetShop('阿里巴巴_外贸部欧伯娜导单专用店铺')) + .toBe('阿里巴巴-外贸部欧伯娜导单专用店铺') + expect(resolveExternalSalesTargetShop(' 外贸日常店铺 ')).toBe('外贸日常店铺') + expect(resolveExternalSalesTargetShop('其他店铺')).toBeNull() + }) + + it('groups shipped lines by month and order number', () => { + const rows = buildExternalSalesSummary([ + item(), + item({ oiId: '12', qty: 1, amount: 100, skuId: 'SKU-002' }), + item({ oiId: '13', orderNo: 'WM-002', ownerName: '' }), + ], [{ + orderNo: 'wm-001', + afterSaleAmount: 80, + afterSaleQty: 2, + }]) + + expect(rows).toEqual([ + expect.objectContaining({ + month: '2026-11', + orderNo: 'WM-001', + shipAmount: 300, + shipQty: 3, + afterSaleAmount: 80, + afterSaleQty: 2, + }), + expect.objectContaining({ + orderNo: 'WM-002', + afterSaleAmount: 0, + afterSaleQty: 0, + }), + ]) + expect(toExternalSalesDetailRows([item()])[0]).toMatchObject({ + orderNo: 'WM-001', + statusLabel: '已发货', + }) + }) + + it('applies configurable detail filters to their specific fields', () => { + const rows = [ + item(), + item({ + oId: '2', + oiId: '12', + orderNo: 'WM-002', + skuId: 'SKU-002', + itemId: 'ITEM-002', + itemName: '另一件商品', + propertiesValue: '胡桃色', + }), + ] + + expect(filterExternalSalesItems(rows, '', { + skuId: 'SKU-002', + })).toEqual([expect.objectContaining({ orderNo: 'WM-002' })]) + expect(filterExternalSalesItems(rows, '', { + itemId: 'ITEM-001', + })).toEqual([expect.objectContaining({ orderNo: 'WM-001' })]) + expect(filterExternalSalesItems(rows, '', { + internalOrderNo: '2', + })).toEqual([expect.objectContaining({ orderNo: 'WM-002' })]) + expect(parseExternalSalesDetailFilters(JSON.stringify({ + orderNo: ' WM-001 ', + itemId: ' ITEM-001 ', + }))).toEqual({ + orderNo: 'WM-001', + itemId: 'ITEM-001', + }) + expect(parseExternalSalesDetailFilters(JSON.stringify({ unknown: 'x' }))).toBeNull() + }) + + it('enriches detail rows with archive cost and calculates goods value', () => { + const rows = enrichExternalSalesItemCosts([ + item({ skuId: 'sku-001', qty: 3 }), + item({ skuId: 'MISSING', qty: 5 }), + ], [{ + barcode: 'SKU-001', + costPrice: 12.5, + unitWeight: null, + }]) + + expect(rows[0]).toMatchObject({ + costPrice: 12.5, + goodsValue: 37.5, + }) + expect(rows[1]).toMatchObject({ + costPrice: null, + goodsValue: null, + }) + }) + + it('allocates each order paid amount across its detail rows', () => { + const rows = allocateExternalSalesPaidAmounts([ + item({ amount: 100, orderPaidAmount: 260 }), + item({ oiId: '12', amount: 300, orderPaidAmount: 260 }), + item({ oId: '2', amount: 88, orderPaidAmount: null }), + ]) + + expect(rows.map((row) => row.amount)).toEqual([65, 195, 88]) + }) + + it('matches after-sales by order number and item code and calculates final shipment', () => { + const rows = applyExternalSalesAfterSaleMetrics([ + item({ qty: 3, amount: 300, costPrice: 20 }), + item({ oiId: '12', qty: 1, amount: 100, costPrice: 20 }), + item({ skuId: 'SKU-OTHER', qty: 2, amount: 50, costPrice: 20 }), + ], [{ + orderNo: 'wm-001', + skuId: 'sku-001', + afterSaleAmount: 80, + afterSaleQty: 2, + }]) + + expect(rows[0]).toMatchObject({ + afterSaleAmount: 60, + afterSaleQty: 2, + finalShipAmount: 240, + finalShipQty: 1, + goodsValue: 20, + }) + expect(rows[1]).toMatchObject({ + afterSaleAmount: 20, + afterSaleQty: 0, + finalShipAmount: 80, + finalShipQty: 1, + goodsValue: 20, + }) + expect(rows[2]).toMatchObject({ + afterSaleAmount: 0, + afterSaleQty: 0, + finalShipAmount: 50, + finalShipQty: 2, + goodsValue: 40, + }) + const sql = buildExternalSalesDetailAfterSaleMetricsSql(['WM-001']) + expect(sql).toContain('h.so_id AS order_no, i.sku_id') + expect(sql).toContain('GROUP BY h.so_id, i.sku_id') + }) + + it('allocates waybill freight by detail weight and makes self-pickup free', () => { + const rows = applyExternalSalesFreight([ + item({ + oId: '1', + oiId: '11', + shippingCourier: '中铁物流', + trackingNo: 'WAYBILL-A', + shippingUnitWeight: 1, + qty: 2, + }), + item({ + oId: '1', + oiId: '12', + shippingCourier: '中铁物流', + trackingNo: 'WAYBILL-A', + shippingUnitWeight: 1, + qty: 2, + }), + item({ + oId: '2', + oiId: '21', + shippingCourier: '自提自送', + trackingNo: 'PICKUP-B', + shipmentWeight: 10, + qty: 3, + }), + ], [{ + trackingNo: 'WAYBILL-A', + freightCost: 20, + }]) + + expect(rows[0]).toMatchObject({ shippingWeight: 2, freight: 10 }) + expect(rows[1]).toMatchObject({ shippingWeight: 2, freight: 10 }) + expect(rows[2]).toMatchObject({ shippingWeight: 10, freight: 0 }) + + const sql = buildExternalSalesWaybillFreightSql(['WAYBILL-A']) + expect(sql).toContain('JianSun.dbo.fys_jstFreightCost') + expect(sql).toContain('freightCost') + expect(sql).toContain("IN (N'WAYBILL-A')") + }) + + it('uses clearance price by order and code and falls back to cost price', () => { + const rows = applyExternalSalesClearancePrices([ + item({ orderNo: 'WM-001', skuId: 'SKU-001', finalShipQty: 3, costPrice: 10 }), + item({ orderNo: 'WM-001', skuId: 'SKU-002', finalShipQty: 2, costPrice: 12 }), + ], [{ + orderNo: 'wm-001', + itemCode: 'sku-001', + costPrice: 20, + clearancePrice: 20, + }]) + + expect(rows[0]).toMatchObject({ + clearancePrice: 20, + clearanceGoodsValue: 60, + }) + expect(rows[1]).toMatchObject({ + clearancePrice: 12, + clearanceGoodsValue: 24, + }) + }) + + it('builds the two source queries with shipped-only filtering', () => { + const sql = buildExternalSalesSourceSql({ + dateFrom: '2026-11-01', + dateTo: '2026-11-13', + }) + + expect(sql).toContain('JianSun.dbo.jst_Orders') + expect(sql).toContain('JianSun.dbo.jst_orderitem') + expect(sql).toContain('JianSun.dbo.jst_qmcust_orderlist') + expect(sql).toContain('JianSun.dbo.jst_qmcust_orderlist_item') + expect(sql).toContain('阿里巴巴-外贸部欧伯娜导单专用店铺') + expect(sql).toContain('外贸日常店铺') + expect(sql).toContain("= N'SENT'") + expect(sql).toContain("<> N'REPLACED'") + expect(sql).toContain('ISNULL(i.qty, 0) > 0') + expect(sql).toContain('o.send_date >= CONVERT(datetime2') + expect(sql).toContain("CONVERT(varchar(10), o.send_date, 23) AS stats_date") + expect(sql).toContain('o.paid_amount') + expect(sql).toContain('o.logistics_company') + expect(sql).toContain('o.l_id') + expect(sql).toContain('o.weight AS shipment_weight') + expect(sql.length).toBeLessThan(8000) + + const unfiltered = buildExternalSalesSourceSql({ + sourceTypes: ['QMCUST'], + }) + expect(unfiltered).not.toContain('AND o.send_date >=') + expect(unfiltered).not.toContain('AND o.send_date <') + }) + + it('builds after-sale filters against Jushuitan external-store data', () => { + const whereSql = buildExternalSalesAfterSaleWhereSql({ + dateFrom: '2026-11-01', + dateTo: '2026-11-13', + shopName: '外贸日常店铺', + orderNo: 'WM20261106132001PG', + itemCode: 'CJ003166N68V01', + }) + expect(whereSql).toContain("h.shop_name IN (N'外贸日常店铺')") + expect(whereSql).toContain("h.as_date >= CONVERT(datetime2, '2026-11-01', 23)") + expect(whereSql).toContain("h.as_date < DATEADD(day, 1, CONVERT(datetime2, '2026-11-13', 23))") + expect(whereSql).toContain("h.so_id LIKE N'%WM20261106132001PG%'") + expect(whereSql).toContain("i.sku_id LIKE N'%CJ003166N68V01%'") + + const metricsSql = buildExternalSalesAfterSaleMetricsSql([ + 'wm261008LHCV', + 'wm261009LHCV', + ]) + expect(metricsSql).toContain('JianSun.dbo.jst_qmcust_refundlist') + expect(metricsSql).toContain('JianSun.dbo.jst_qmcust_refundlist_item') + expect(metricsSql).toContain('i.as_id = h.as_id') + expect(metricsSql).toContain('阿里巴巴-外贸部欧伯娜导单专用店铺') + expect(metricsSql).toContain('外贸日常店铺') + expect(metricsSql).toContain("h.so_id IN (N'wm261008LHCV', N'wm261009LHCV')") + expect(metricsSql).not.toContain('dwd_jst_refund_data_di') + }) + + it('converts a selected summary month to an inclusive month range', () => { + expect(externalSalesMonthRange('2026-10')).toEqual({ + dateFrom: '2026-10-01', + dateTo: '2026-10-31', + }) + expect(externalSalesMonthRange('2027-01')).toEqual({ + dateFrom: '2027-01-01', + dateTo: '2027-01-31', + }) + expect(externalSalesMonthRange('2026-13')).toBeNull() + }) +}) diff --git a/furniture-3d-system/src/lib/external-sales.ts b/furniture-3d-system/src/lib/external-sales.ts new file mode 100644 index 00000000..0b101686 --- /dev/null +++ b/furniture-3d-system/src/lib/external-sales.ts @@ -0,0 +1,854 @@ +import type { ExternalClearancePriceRow } from '@/lib/external-clearance-price' + +export const EXTERNAL_SALES_TARGET_SHOPS = [ + '阿里巴巴-外贸部欧伯娜导单专用店铺', + '外贸日常店铺', +] as const + +export type ExternalSalesTargetShop = (typeof EXTERNAL_SALES_TARGET_SHOPS)[number] +export type ExternalSalesView = 'summary' | 'detail' | 'afterSale' + +export const EXTERNAL_SALES_TARGET_SHOP_ALIASES: Record = { + '阿里巴巴-外贸部欧伯娜导单专用店铺': [ + '阿里巴巴-外贸部欧伯娜导单专用店铺', + '阿里巴巴_外贸部欧伯娜导单专用店铺', + ], + '外贸日常店铺': ['外贸日常店铺'], +} + +function externalSalesShopKey(value: string) { + return value.trim().replaceAll(/[_\-\s]/g, '').toUpperCase() +} + +export function resolveExternalSalesTargetShop(value: string): ExternalSalesTargetShop | null { + const key = externalSalesShopKey(value) + return EXTERNAL_SALES_TARGET_SHOPS.find((shop) => ( + EXTERNAL_SALES_TARGET_SHOP_ALIASES[shop].some((alias) => externalSalesShopKey(alias) === key) + )) ?? null +} + +export type ExternalSalesItemRow = { + sourceType: 'OTHER' | 'QMCUST' + oId: string + oiId: string + orderNo: string + shopName: ExternalSalesTargetShop + shippingCourier: string + trackingNo: string + shipmentWeight: number | null + shippingUnitWeight: number | null + shippingWeight: number | null + freight: number | null + statsDate: string + orderDate: string + sendDate: string + orderStatus: string + itemStatus: string + ownerName: string + localItemId: string + skuId: string + itemId: string + shopSkuId: string + shopItemId: string + propertiesValue: string + itemName: string + basePrice: number + price: number + qty: number + amount: number + afterSaleAmount: number + afterSaleQty: number + finalShipAmount: number + finalShipQty: number + orderPaidAmount: number | null + outerOiId: string + costPrice: number | null + goodsValue: number | null + clearancePrice: number | null + clearanceGoodsValue: number | null + refundStatus: string + refundQty: number +} + +export type ExternalSalesSummaryRow = { + month: string + orderNo: string + shipAmount: number + shipQty: number + afterSaleAmount: number + afterSaleQty: number + finalShipAmount: number + finalShipQty: number +} + +export type ExternalSalesDetailRow = ExternalSalesItemRow & { + statusLabel: '已发货' +} + +export type ExternalSalesAfterSaleRow = { + asId: string + outerAsId: string + orderNo: string + shopName: string + asDate: string + afterSaleStatus: string + afterSaleType: string + refundPhase: string + goodsStatus: string + creatorName: string + questionType: string + buyerApplyRefund: number + refundAmount: number + receiveRefund: number + confirmDate: string + localItemId: string + skuId: string + itemId: string + shopSkuId: string + itemName: string + propertiesValue: string + qty: number + returnedQty: number + amount: number + remark: string +} + +export type ExternalSalesAfterSaleMetric = { + orderNo: string + afterSaleAmount: number + afterSaleQty: number +} + +export type ExternalSalesDetailAfterSaleMetric = { + orderNo: string + skuId: string + afterSaleAmount: number + afterSaleQty: number +} + +export type ExternalSalesArchiveCost = { + barcode: string + costPrice: number | null + unitWeight: number | null +} + +export type ExternalSalesWaybillFreight = { + trackingNo: string + freightCost: number +} + +export const EXTERNAL_SALES_DETAIL_FILTER_KEYS = [ + 'orderNo', + 'internalOrderNo', + 'shippingCourier', + 'trackingNo', + 'skuId', + 'itemId', + 'orderDate', +] as const + +export type ExternalSalesDetailFilterKey = (typeof EXTERNAL_SALES_DETAIL_FILTER_KEYS)[number] +export type ExternalSalesDetailFilters = Partial> + +export type ExternalSalesPageInfo = { + page: number + pageSize: number + total: number + totalPages: number +} + +export type ExternalSalesPage = { + view: ExternalSalesView + dateFrom: string + dateTo: string + shopName: ExternalSalesTargetShop | '' + generatedAt: string + rows: ExternalSalesSummaryRow[] | ExternalSalesDetailRow[] | ExternalSalesAfterSaleRow[] + detailColumnAvailability?: { + shopSkuId: boolean + shopItemId: boolean + } + pageInfo: ExternalSalesPageInfo + totals: { + orderCount: number + shipAmount: number + shipQty: number + afterSaleCount: number + refundQty: number + refundAmount: number + goodsValue?: number + freight?: number + clearanceGoodsValue?: number + } +} + +const ISO_DATE_PATTERN = /^(\d{4})-(\d{2})-(\d{2})$/ + +export function isExternalSalesDate(value: string) { + const match = ISO_DATE_PATTERN.exec(value) + if (!match) return false + const date = new Date(`${value}T00:00:00.000Z`) + return !Number.isNaN(date.getTime()) && date.toISOString().slice(0, 10) === value +} + +export function externalSalesDateSpan(dateFrom: string, dateTo: string) { + if (!isExternalSalesDate(dateFrom) || !isExternalSalesDate(dateTo)) return null + const start = Date.parse(`${dateFrom}T00:00:00.000Z`) + const end = Date.parse(`${dateTo}T00:00:00.000Z`) + if (end < start) return null + return Math.floor((end - start) / 86_400_000) + 1 +} + +export function externalSalesMonthRange(month: string) { + const match = /^(\d{4})-(0[1-9]|1[0-2])$/.exec(month) + if (!match) return null + const year = Number(match[1]) + const monthIndex = Number(match[2]) - 1 + return { + dateFrom: new Date(Date.UTC(year, monthIndex, 1)).toISOString().slice(0, 10), + dateTo: new Date(Date.UTC(year, monthIndex + 1, 0)).toISOString().slice(0, 10), + } +} + +function sqlLiteral(value: string) { + return `N'${value.replaceAll("'", "''")}'` +} + +function sourceSelect(input: { + sourceType: 'OTHER' | 'QMCUST' + headerTable: string + itemTable: string + dateFrom?: string + dateTo?: string + shops: readonly string[] +}) { + return ` + SELECT TOP (50000) ${sqlLiteral(input.sourceType)} AS src, + o.o_id, i.oi_id, o.so_id, LTRIM(RTRIM(o.shop_name)) AS shop_name, + o.logistics_company, o.l_id, o.weight AS shipment_weight, + CONVERT(varchar(10), o.send_date, 23) AS stats_date, + CONVERT(varchar(19), o.order_date, 120) AS order_date, + CONVERT(varchar(19), o.send_date, 120) AS send_date, + o.status, i.item_status, o.creator_name, o.referrer_name, + i.sku_id, i.i_id, i.shop_sku_id, i.shop_i_id, i.properties_value, + i.name, i.base_price, i.price, i.qty, i.amount, o.paid_amount, i.outer_oi_id, + o.Id AS header_row_id, i.Id AS item_row_id + FROM JianSun.dbo.${input.headerTable} o + INNER JOIN JianSun.dbo.${input.itemTable} i ON i.o_id = o.o_id + WHERE LTRIM(RTRIM(ISNULL(o.shop_name, ''))) IN (${input.shops.map(sqlLiteral).join(', ')}) + ${input.dateFrom ? `AND o.send_date >= CONVERT(datetime2, '${input.dateFrom}', 23)` : ''} + ${input.dateTo ? `AND o.send_date < DATEADD(day, 1, CONVERT(datetime2, '${input.dateTo}', 23))` : ''} + AND ISNULL(i.qty, 0) > 0 + AND UPPER(LTRIM(RTRIM(ISNULL(i.item_status, '')))) <> N'REPLACED' + AND ( + UPPER(LTRIM(RTRIM(ISNULL(o.status, '')))) = N'SENT' + OR UPPER(LTRIM(RTRIM(ISNULL(i.item_status, '')))) IN (N'SENT', N'已发货') + )` +} + +export function buildExternalSalesSourceSql(input: { + dateFrom?: string + dateTo?: string + shopName?: ExternalSalesTargetShop | '' + sourceTypes?: readonly ('OTHER' | 'QMCUST')[] +}) { + if (input.dateFrom && input.dateTo && !externalSalesDateSpan(input.dateFrom, input.dateTo)) { + throw new Error('外贸销量统计时间范围不正确') + } + const shops = input.shopName ? [input.shopName] : EXTERNAL_SALES_TARGET_SHOPS + const sourceTypes = input.sourceTypes ?? ['OTHER', 'QMCUST'] + if (sourceTypes.length === 0) return '' + const selects: string[] = [] + if (sourceTypes.includes('OTHER')) { + selects.push(sourceSelect({ + sourceType: 'OTHER', + headerTable: 'jst_Orders', + itemTable: 'jst_orderitem', + dateFrom: input.dateFrom, + dateTo: input.dateTo, + shops, + })) + } + if (sourceTypes.includes('QMCUST')) { + selects.push(sourceSelect({ + sourceType: 'QMCUST', + headerTable: 'jst_qmcust_orderlist', + itemTable: 'jst_qmcust_orderlist_item', + dateFrom: input.dateFrom, + dateTo: input.dateTo, + shops, + })) + } + return ` +WITH allItems AS ( + ${selects.join('\n UNION ALL\n')} +) +SELECT * FROM allItems` +} + +export function buildExternalSalesAfterSaleWhereSql(input: { + dateFrom?: string + dateTo?: string + shopName?: ExternalSalesTargetShop | '' + keyword?: string + orderNo?: string + itemCode?: string +}) { + if (input.dateFrom && input.dateTo && !externalSalesDateSpan(input.dateFrom, input.dateTo)) { + throw new Error('外贸售后统计时间范围不正确') + } + const shops = input.shopName ? [input.shopName] : EXTERNAL_SALES_TARGET_SHOPS + const aliases = shops.flatMap((shop) => EXTERNAL_SALES_TARGET_SHOP_ALIASES[shop]) + const conditions = [ + `h.shop_name IN (${aliases.map(sqlLiteral).join(', ')})`, + ] + if (input.dateFrom) { + conditions.push(`h.as_date >= CONVERT(datetime2, '${input.dateFrom}', 23)`) + } + if (input.dateTo) { + conditions.push(`h.as_date < DATEADD(day, 1, CONVERT(datetime2, '${input.dateTo}', 23))`) + } + if (input.orderNo?.trim()) { + const orderNo = sqlLiteral(`%${input.orderNo.trim()}%`) + conditions.push(`( + h.so_id LIKE ${orderNo} + OR h.raw_so_id LIKE ${orderNo} + OR h.as_id LIKE ${orderNo} + OR h.outer_as_id LIKE ${orderNo} + )`) + } + if (input.itemCode?.trim()) { + const itemCode = sqlLiteral(`%${input.itemCode.trim()}%`) + conditions.push(`(i.sku_id LIKE ${itemCode} OR i.i_id LIKE ${itemCode} OR i.shop_sku_id LIKE ${itemCode})`) + } + if (input.keyword?.trim()) { + const keyword = sqlLiteral(`%${input.keyword.trim()}%`) + conditions.push(`( + h.outer_as_id LIKE ${keyword} + OR h.so_id LIKE ${keyword} + OR h.raw_so_id LIKE ${keyword} + OR h.shop_name LIKE ${keyword} + OR h.creator_name LIKE ${keyword} + OR i.sku_id LIKE ${keyword} + OR i.i_id LIKE ${keyword} + OR i.shop_sku_id LIKE ${keyword} + OR i.name LIKE ${keyword} + OR i.properties_value LIKE ${keyword} + )`) + } + return conditions.join('\n AND ') +} + +export function buildExternalSalesAfterSaleMetricsSql(orderNos: readonly string[]) { + const uniqueOrderNos = [...new Set(orderNos.map((value) => value.trim()).filter(Boolean))] + if (uniqueOrderNos.length === 0) return '' + if (uniqueOrderNos.length > 50) throw new Error('外贸售后订单单次最多查询 50 个编号') + return ` +SELECT h.so_id AS order_no, + SUM(TRY_CONVERT(decimal(18,4), ISNULL(i.amount, '0'))) AS after_sale_amount, + SUM(CAST(ISNULL(i.qty, 0) AS bigint)) AS after_sale_qty +FROM JianSun.dbo.jst_qmcust_refundlist h +INNER JOIN JianSun.dbo.jst_qmcust_refundlist_item i ON i.as_id = h.as_id +WHERE ${buildExternalSalesAfterSaleWhereSql({})} + AND h.so_id IN (${uniqueOrderNos.map(sqlLiteral).join(', ')}) +GROUP BY h.so_id` +} + +export function buildExternalSalesDetailAfterSaleMetricsSql(orderNos: readonly string[]) { + const uniqueOrderNos = [...new Set(orderNos.map((value) => value.trim()).filter(Boolean))] + if (uniqueOrderNos.length === 0) return '' + if (uniqueOrderNos.length > 50) throw new Error('外贸售后订单单次最多查询 50 个编号') + return ` +SELECT h.so_id AS order_no, i.sku_id, + SUM(TRY_CONVERT(decimal(18,4), ISNULL(i.amount, '0'))) AS after_sale_amount, + SUM(CAST(ISNULL(i.qty, 0) AS bigint)) AS after_sale_qty +FROM JianSun.dbo.jst_qmcust_refundlist h +INNER JOIN JianSun.dbo.jst_qmcust_refundlist_item i ON i.as_id = h.as_id +WHERE ${buildExternalSalesAfterSaleWhereSql({})} + AND h.so_id IN (${uniqueOrderNos.map(sqlLiteral).join(', ')}) +GROUP BY h.so_id, i.sku_id` +} + +export function buildExternalSalesWaybillFreightSql(trackingNos: readonly string[]) { + const uniqueTrackingNos = [...new Set( + trackingNos.map((value) => value.trim()).filter(Boolean), + )] + if (uniqueTrackingNos.length === 0) return '' + if (uniqueTrackingNos.length > 50) throw new Error('外贸运单号单次最多查询 50 个') + return ` +WITH ranked AS ( + SELECT + LTRIM(RTRIM(CAST(expressNo AS nvarchar(160)))) AS tracking_no, + TRY_CONVERT(decimal(18,4), freightCost) AS freight_cost, + ROW_NUMBER() OVER ( + PARTITION BY LTRIM(RTRIM(CAST(expressNo AS nvarchar(160)))) + ORDER BY updateTime DESC, Id DESC + ) AS row_rank + FROM JianSun.dbo.fys_jstFreightCost + WHERE LTRIM(RTRIM(CAST(ISNULL(expressNo, '') AS nvarchar(160)))) + IN (${uniqueTrackingNos.map(sqlLiteral).join(', ')}) +) +SELECT tracking_no, freight_cost +FROM ranked +WHERE row_rank = 1` +} + +export function enrichExternalSalesItemCosts( + rows: readonly ExternalSalesItemRow[], + archiveCosts: readonly ExternalSalesArchiveCost[], +) { + const costs = new Map(archiveCosts.map((item) => [ + item.barcode.trim().toUpperCase(), + item, + ])) + return rows.map((row): ExternalSalesItemRow => { + const archiveCost = costs.get(row.skuId.trim().toUpperCase()) + const costPrice = archiveCost?.costPrice ?? null + return { + ...row, + costPrice, + shippingUnitWeight: archiveCost?.unitWeight ?? null, + goodsValue: costPrice === null + ? null + : Math.round(costPrice * row.qty * 100) / 100, + } + }) +} + +export function allocateExternalSalesPaidAmounts( + rows: readonly ExternalSalesItemRow[], +) { + const groups = new Map() + for (const [index, row] of rows.entries()) { + const key = `${row.sourceType}|${row.oId}` + const indexes = groups.get(key) ?? [] + indexes.push(index) + groups.set(key, indexes) + } + + const allocated = rows.map((row) => ({ ...row })) + for (const indexes of groups.values()) { + const orderPaidAmount = rows[indexes[0]]?.orderPaidAmount + if (orderPaidAmount === null || orderPaidAmount === undefined) continue + const totalAmount = indexes.reduce((sum, index) => sum + rows[index].amount, 0) + const totalQty = indexes.reduce((sum, index) => sum + rows[index].qty, 0) + let assignedAmount = 0 + indexes.forEach((index, position) => { + const row = rows[index] + const ratio = totalAmount !== 0 + ? row.amount / totalAmount + : totalQty > 0 + ? row.qty / totalQty + : 1 / indexes.length + const amount = position === indexes.length - 1 + ? Math.round((orderPaidAmount - assignedAmount) * 100) / 100 + : Math.round(orderPaidAmount * ratio * 100) / 100 + allocated[index] = { + ...allocated[index], + amount, + } + assignedAmount = Math.round((assignedAmount + amount) * 100) / 100 + }) + } + return allocated +} + +function detailAfterSaleKey(orderNo: string, skuId: string) { + return `${orderNo.trim().toUpperCase()}|${skuId.trim().toUpperCase()}` +} + +export function applyExternalSalesAfterSaleMetrics( + rows: readonly ExternalSalesItemRow[], + metrics: readonly ExternalSalesDetailAfterSaleMetric[], +) { + const metricByKey = new Map() + for (const metric of metrics) { + const key = detailAfterSaleKey(metric.orderNo, metric.skuId) + const current = metricByKey.get(key) + metricByKey.set(key, { + orderNo: metric.orderNo, + skuId: metric.skuId, + afterSaleAmount: Math.round(((current?.afterSaleAmount ?? 0) + metric.afterSaleAmount) * 100) / 100, + afterSaleQty: (current?.afterSaleQty ?? 0) + metric.afterSaleQty, + }) + } + + const groups = new Map() + for (const [index, row] of rows.entries()) { + const key = detailAfterSaleKey(row.orderNo, row.skuId) + const indexes = groups.get(key) ?? [] + indexes.push(index) + groups.set(key, indexes) + } + + const result = rows.map((row) => ({ + ...row, + afterSaleAmount: 0, + afterSaleQty: 0, + finalShipAmount: row.amount, + finalShipQty: row.qty, + })) + + for (const [key, indexes] of groups) { + const metric = metricByKey.get(key) + if (!metric) continue + const totalQty = indexes.reduce((sum, index) => sum + rows[index].qty, 0) + const totalAmount = indexes.reduce((sum, index) => sum + rows[index].amount, 0) + const refundQtyShares = indexes.map((index) => ( + totalQty > 0 + ? metric.afterSaleQty * rows[index].qty / totalQty + : metric.afterSaleQty / indexes.length + )) + const roundedQtyShares = refundQtyShares.map((value) => Math.floor(value)) + let remainingQty = Math.max( + 0, + metric.afterSaleQty - roundedQtyShares.reduce((sum, value) => sum + value, 0), + ) + const remainderOrder = refundQtyShares + .map((value, position) => ({ position, remainder: value - Math.floor(value) })) + .sort((left, right) => right.remainder - left.remainder || left.position - right.position) + for (const item of remainderOrder) { + if (remainingQty <= 0) break + roundedQtyShares[item.position] += 1 + remainingQty -= 1 + } + + let assignedAmount = 0 + indexes.forEach((index, position) => { + const row = rows[index] + const amountRatio = totalAmount !== 0 + ? row.amount / totalAmount + : totalQty > 0 + ? row.qty / totalQty + : 1 / indexes.length + const allocatedAmount = position === indexes.length - 1 + ? Math.round((metric.afterSaleAmount - assignedAmount) * 100) / 100 + : Math.round(metric.afterSaleAmount * amountRatio * 100) / 100 + assignedAmount = Math.round((assignedAmount + allocatedAmount) * 100) / 100 + result[index] = { + ...result[index], + afterSaleAmount: allocatedAmount, + afterSaleQty: roundedQtyShares[position], + finalShipAmount: Math.round((row.amount - allocatedAmount) * 100) / 100, + finalShipQty: row.qty - roundedQtyShares[position], + } + }) + } + return result.map((row) => ({ + ...row, + goodsValue: row.costPrice === null + ? null + : Math.round(row.costPrice * row.finalShipQty * 100) / 100, + })) +} + +function rounded(value: number, digits = 2) { + const factor = 10 ** digits + return Math.round(value * factor) / factor +} + +export function applyExternalSalesFreight( + rows: readonly ExternalSalesItemRow[], + waybillFreight: readonly ExternalSalesWaybillFreight[], +) { + const freightByTrackingNo = new Map(waybillFreight.map((row) => [ + row.trackingNo.trim().toUpperCase(), + row.freightCost, + ])) + const result = rows.map((row) => ({ + ...row, + shippingWeight: null as number | null, + freight: null as number | null, + })) + + const orderGroups = new Map() + for (const [index, row] of rows.entries()) { + const key = `${row.sourceType}|${row.oId}` + const indexes = orderGroups.get(key) ?? [] + indexes.push(index) + orderGroups.set(key, indexes) + } + for (const indexes of orderGroups.values()) { + const totalQty = indexes.reduce((sum, index) => sum + rows[index].qty, 0) + const shipmentWeight = rows[indexes[0]]?.shipmentWeight + indexes.forEach((index, position) => { + const row = rows[index] + const shippingWeight = row.shippingUnitWeight !== null && row.shippingUnitWeight > 0 + ? row.shippingUnitWeight * row.qty + : shipmentWeight !== null && shipmentWeight > 0 && totalQty > 0 + ? position === indexes.length - 1 + ? shipmentWeight - indexes.slice(0, -1).reduce((sum, itemIndex) => ( + sum + (result[itemIndex].shippingWeight ?? 0) + ), 0) + : shipmentWeight * row.qty / totalQty + : null + result[index] = { + ...result[index], + shippingWeight: shippingWeight === null ? null : rounded(shippingWeight, 4), + } + }) + } + + const selfPickupIndexes: number[] = [] + const waybillGroups = new Map() + for (const [index, row] of rows.entries()) { + if (row.shippingCourier.includes('自提')) { + selfPickupIndexes.push(index) + continue + } + const trackingNo = row.trackingNo.trim().toUpperCase() + if (!trackingNo) continue + const indexes = waybillGroups.get(trackingNo) ?? [] + indexes.push(index) + waybillGroups.set(trackingNo, indexes) + } + for (const index of selfPickupIndexes) { + result[index] = { ...result[index], freight: 0 } + } + + for (const [trackingNo, indexes] of waybillGroups) { + const totalFreight = freightByTrackingNo.get(trackingNo) + if (totalFreight === undefined) continue + const allWeightsAvailable = indexes.every((index) => ( + (result[index].shippingWeight ?? 0) > 0 + )) + const weights = indexes.map((index) => ( + allWeightsAvailable + ? result[index].shippingWeight ?? 0 + : Math.max(0, rows[index].qty) + )) + const totalWeight = weights.reduce((sum, value) => sum + value, 0) + let assigned = 0 + indexes.forEach((index, position) => { + const weight = totalWeight > 0 ? weights[position] : 1 + const denominator = totalWeight > 0 ? totalWeight : indexes.length + const freight = position === indexes.length - 1 + ? rounded(totalFreight - assigned) + : rounded(totalFreight * weight / denominator) + result[index] = { ...result[index], freight } + assigned = rounded(assigned + freight) + }) + } + return result +} + +export function applyExternalSalesClearancePrices( + rows: readonly ExternalSalesItemRow[], + clearanceRows: readonly ExternalClearancePriceRow[], +) { + const clearanceByKey = new Map(clearanceRows.map((row) => [ + `${row.orderNo.trim().toUpperCase()}|${row.itemCode.trim().toUpperCase()}`, + row.clearancePrice, + ])) + return rows.map((row): ExternalSalesItemRow => { + const orderKey = row.orderNo.trim().toUpperCase() + const matchedPrice = [row.skuId, row.itemId, row.shopSkuId, row.shopItemId] + .map((code) => code.trim().toUpperCase()) + .filter(Boolean) + .map((code) => clearanceByKey.get(`${orderKey}|${code}`)) + .find((value) => value !== undefined) + const clearancePrice = matchedPrice ?? row.costPrice + return { + ...row, + clearancePrice, + clearanceGoodsValue: clearancePrice === null + ? null + : Math.round(clearancePrice * row.finalShipQty * 100) / 100, + } + }) +} + +export function parseExternalSalesDetailFilters(value: string): ExternalSalesDetailFilters | null { + try { + const parsed: unknown = JSON.parse(value) + if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed)) return null + const allowed = new Set(EXTERNAL_SALES_DETAIL_FILTER_KEYS) + const filters: ExternalSalesDetailFilters = {} + for (const [key, rawValue] of Object.entries(parsed)) { + if (!allowed.has(key) || typeof rawValue !== 'string' || rawValue.length > 200) return null + const normalized = rawValue.trim() + if (normalized) filters[key as ExternalSalesDetailFilterKey] = normalized + } + return filters + } catch { + return null + } +} + +function externalSalesDetailFieldValues( + row: ExternalSalesItemRow, + key: ExternalSalesDetailFilterKey, +) { + switch (key) { + case 'orderNo': return [row.orderNo] + case 'internalOrderNo': return [row.oId] + case 'shippingCourier': return [row.shippingCourier] + case 'trackingNo': return [row.trackingNo] + case 'skuId': return [row.skuId] + case 'itemId': return [row.itemId] + case 'orderDate': return [row.orderDate] + } +} + +export function filterExternalSalesItems( + rows: readonly ExternalSalesItemRow[], + keyword: string, + fieldFilters: ExternalSalesDetailFilters = {}, +) { + const needle = keyword.trim().toLocaleLowerCase('zh-CN') + const activeFieldFilters = Object.entries(fieldFilters).flatMap(([key, value]) => { + const normalized = value?.trim().toLocaleLowerCase('zh-CN') + return normalized + ? [[key as ExternalSalesDetailFilterKey, normalized] as const] + : [] + }) + if (!needle && activeFieldFilters.length === 0) return [...rows] + return rows.filter((row) => { + if (needle && ![ + row.orderNo, + row.oiId, + row.shopName, + row.skuId, + row.itemId, + row.shopSkuId, + row.shopItemId, + row.itemName, + row.propertiesValue, + ].some((value) => value.toLocaleLowerCase('zh-CN').includes(needle))) { + return false + } + return activeFieldFilters.every(([key, value]) => ( + externalSalesDetailFieldValues(row, key) + .some((candidate) => candidate.toLocaleLowerCase('zh-CN').includes(value)) + )) + }) +} + +export function filterExternalSalesAfterSaleRows( + rows: readonly ExternalSalesAfterSaleRow[], + keyword: string, +) { + const needle = keyword.trim().toLocaleLowerCase('zh-CN') + return rows + .filter((row) => !needle || [ + row.asId, + row.outerAsId, + row.orderNo, + row.shopName, + row.creatorName, + row.skuId, + row.shopSkuId, + row.itemName, + row.propertiesValue, + row.questionType, + ].some((value) => value.toLocaleLowerCase('zh-CN').includes(needle))) + .sort((left, right) => ( + right.asDate.localeCompare(left.asDate) + || right.asId.localeCompare(left.asId, 'zh-CN') + )) +} + +export function externalSalesAfterSaleStatusLabel(value: string) { + const normalized = value.trim() + const labels: Record = { + WaitConfirm: '待确认', + Confirmed: '已确认', + Cancelled: '已取消', + Rejected: '已拒绝', + Closed: '已关闭', + } + return labels[normalized] ?? (normalized || '-') +} + +export function buildExternalSalesSummary( + rows: readonly ExternalSalesItemRow[], + afterSaleMetrics: readonly ExternalSalesAfterSaleMetric[] = [], +): ExternalSalesSummaryRow[] { + const grouped = new Map() + const afterSaleMetricsByOrder = new Map() + for (const row of afterSaleMetrics) { + const key = row.orderNo.trim().toUpperCase() + const metric = afterSaleMetricsByOrder.get(key) ?? { afterSaleAmount: 0, afterSaleQty: 0 } + metric.afterSaleAmount += row.afterSaleAmount + metric.afterSaleQty += row.afterSaleQty + afterSaleMetricsByOrder.set(key, metric) + } + for (const row of rows) { + const month = row.statsDate.slice(0, 7) + const key = `${month}|${row.orderNo}` + const current = grouped.get(key) ?? { + month, + orderNo: row.orderNo, + shipAmount: 0, + shipQty: 0, + } + current.shipAmount += row.amount + current.shipQty += row.qty + grouped.set(key, current) + } + const latestMonthByOrder = new Map() + for (const row of grouped.values()) { + const orderKey = row.orderNo.trim().toUpperCase() + const current = latestMonthByOrder.get(orderKey) + if (!current || row.month > current) latestMonthByOrder.set(orderKey, row.month) + } + return [...grouped.values()] + .map((row) => { + const orderKey = row.orderNo.trim().toUpperCase() + const metric = latestMonthByOrder.get(orderKey) === row.month + ? afterSaleMetricsByOrder.get(orderKey) + : undefined + const afterSaleAmount = Math.round((metric?.afterSaleAmount ?? 0) * 100) / 100 + const afterSaleQty = metric?.afterSaleQty ?? 0 + const shipAmount = Math.round(row.shipAmount * 100) / 100 + return { + month: row.month, + orderNo: row.orderNo, + shipAmount, + shipQty: row.shipQty, + afterSaleAmount, + afterSaleQty, + finalShipAmount: Math.round((shipAmount - afterSaleAmount) * 100) / 100, + finalShipQty: row.shipQty - afterSaleQty, + } + }) + .sort((left, right) => ( + right.month.localeCompare(left.month) + || left.orderNo.localeCompare(right.orderNo, 'zh-CN') + )) +} + +export function toExternalSalesDetailRows(rows: readonly ExternalSalesItemRow[]): ExternalSalesDetailRow[] { + return rows + .map((row) => ({ + ...row, + statusLabel: '已发货' as const, + })) + .sort((left, right) => ( + right.orderDate.localeCompare(left.orderDate) + || right.oiId.localeCompare(left.oiId, 'zh-CN') + )) +} + +export function paginateExternalSales( + rows: readonly T[], + page: number, + pageSize: number, +): { rows: T[]; pageInfo: ExternalSalesPageInfo } { + const total = rows.length + const totalPages = Math.max(1, Math.ceil(total / pageSize)) + const current = Math.min(Math.max(1, Math.trunc(page)), totalPages) + const offset = (current - 1) * pageSize + return { + rows: rows.slice(offset, offset + pageSize), + pageInfo: { page: current, pageSize, total, totalPages }, + } +} diff --git a/furniture-3d-system/src/lib/supply-chain-management-blank-pages.test.ts b/furniture-3d-system/src/lib/supply-chain-management-blank-pages.test.ts index a5f58527..a71234c0 100644 --- a/furniture-3d-system/src/lib/supply-chain-management-blank-pages.test.ts +++ b/furniture-3d-system/src/lib/supply-chain-management-blank-pages.test.ts @@ -10,11 +10,14 @@ describe('经营管理空白页注册表', () => { '特殊备货&特殊入库流程监控', '商品SABC打标', '选品明细', + '外销销量', ]) expect(getManagementBlankPage('blank-page-2')?.route) .toBe('/supply-chain/management/blank-pages/blank-page-2') expect(getManagementBlankPage('blank-page-6')?.route) .toBe('/supply-chain/management/blank-pages/blank-page-6') + expect(getManagementBlankPage('blank-page-7')?.route) + .toBe('/supply-chain/management/blank-pages/blank-page-7') }) it('让未来新增的空白页路径自动继承同一权限范围', () => { diff --git a/furniture-3d-system/src/lib/supply-chain-management-blank-pages.ts b/furniture-3d-system/src/lib/supply-chain-management-blank-pages.ts index 326f4066..17879167 100644 --- a/furniture-3d-system/src/lib/supply-chain-management-blank-pages.ts +++ b/furniture-3d-system/src/lib/supply-chain-management-blank-pages.ts @@ -20,6 +20,11 @@ export const MANAGEMENT_BLANK_PAGES: readonly ManagementBlankPageDefinition[] = label: '选品明细', route: '/supply-chain/management/blank-pages/blank-page-6', }, + { + key: 'blank-page-7', + label: '外销销量', + route: '/supply-chain/management/blank-pages/blank-page-7', + }, ] export const MANAGEMENT_BLANK_PAGE_ROUTE_PREFIX = '/supply-chain/management/blank-pages/' diff --git a/furniture-3d-system/src/lib/supply-chain-page-permissions.test.ts b/furniture-3d-system/src/lib/supply-chain-page-permissions.test.ts index b620215e..8c125511 100644 --- a/furniture-3d-system/src/lib/supply-chain-page-permissions.test.ts +++ b/furniture-3d-system/src/lib/supply-chain-page-permissions.test.ts @@ -14,8 +14,8 @@ describe('independent supply-chain page permissions', () => { ]) it('gives every menu page its own target, route mapping and permission row', () => { - // 菜单页数量随功能迭代增长(新增「商品盘停管理」后为 33) - expect(pages).toHaveLength(33) + // 菜单页数量随功能迭代增长(新增「外销销量」后为 34) + expect(pages).toHaveLength(34) expect(new Set(pages.map((page) => page.targetKey)).size).toBe(pages.length) const matrixRows = PERMISSION_MATRIX_SECTIONS.find((section) => section.id === 'supply')!.groups.flatMap((group) => group.rows) for (const page of pages) { @@ -36,7 +36,7 @@ describe('independent supply-chain page permissions', () => { it('does not reuse old management or sample grants for the new nodes', () => { const overrides = { 'businessManagement:purchase:edit': true, 'newProductSampleProgress:purchase:edit': true } - for (const target of ['ownerConfig', 'limitManagement', 'productionStopDemands', 'logisticsArrivalSigningDuration', 'managementBlankPage1', 'managementBlankPage2', 'finishedProductProgress'] as const) { + for (const target of ['ownerConfig', 'limitManagement', 'productionStopDemands', 'logisticsArrivalSigningDuration', 'managementBlankPage1', 'managementBlankPage2', 'managementBlankPage7', 'finishedProductProgress'] as const) { expect(resolveSupplyChainPermissionAccess(overrides, target, ['purchase'])).toEqual({ view: false, download: false, edit: false }) } }) diff --git a/furniture-3d-system/src/lib/supply-chain-permission-paths.ts b/furniture-3d-system/src/lib/supply-chain-permission-paths.ts index 61578c58..df20c6e6 100644 --- a/furniture-3d-system/src/lib/supply-chain-permission-paths.ts +++ b/furniture-3d-system/src/lib/supply-chain-permission-paths.ts @@ -27,6 +27,7 @@ export function getSupplyChainPermissionTargetForPath(pathname: string): SupplyC } if (pathname === '/supply-chain/management/blank-pages/blank-page-1') return 'managementBlankPage1' as const if (pathname === '/supply-chain/management/blank-pages/blank-page-2') return 'managementBlankPage2' as const + if (pathname === '/supply-chain/management/blank-pages/blank-page-7') return 'managementBlankPage7' as const if (pathname === '/supply-chain/management/employee-hours') return 'employeeHours' as const if (pathname === '/supply-chain/management/logistics-arrival-signing-duration') return 'logisticsArrivalSigningDuration' as const if (pathname === '/supply-chain/management/order-not-dispatched') return 'orderNotDispatched' as const @@ -131,6 +132,17 @@ export function getSupplyChainApiPermissionRequirement(pathname: string, method: if (pathname.startsWith('/api/supply-chain/management/employee-hours')) { return { targetKey: 'employeeHours' as const, action: 'view' as const } } + if (pathname === '/api/supply-chain/management/external-sales/freight/import') { + return { targetKey: 'managementBlankPage7' as const, action: 'edit' as const } + } + if ( + pathname === '/api/supply-chain/management/external-sales' + || pathname.startsWith('/api/supply-chain/management/external-sales/freight') + || pathname.startsWith('/api/supply-chain/management/external-sales/clearance') + || pathname.startsWith('/api/supply-chain/management/external-sales/profit') + ) { + return { targetKey: 'managementBlankPage7' as const, action: 'view' as const } + } if (pathname.startsWith('/api/supply-chain/management/freight-config')) { return { targetKey: 'managementBlankPage1' as const, action: 'view' as const } } diff --git a/furniture-3d-system/src/lib/supply-chain-permission-targets.ts b/furniture-3d-system/src/lib/supply-chain-permission-targets.ts index add1efbd..2fba22db 100644 --- a/furniture-3d-system/src/lib/supply-chain-permission-targets.ts +++ b/furniture-3d-system/src/lib/supply-chain-permission-targets.ts @@ -126,6 +126,7 @@ export type SupplyChainPermissionTargetKey = | 'orderNotDispatched' | 'managementBlankPage1' | 'managementBlankPage2' + | 'managementBlankPage7' | 'finishedProductProgress' | 'employeeHours' | 'productArchive' @@ -258,6 +259,7 @@ export const SUPPLY_CHAIN_PERMISSION_TARGETS: SupplyChainPermissionTarget[] = [ { key: 'orderNotDispatched', label: '应发未发', description: '查看应发未发订单、超时原因、处理人与原始订单明细' }, { key: 'managementBlankPage1', label: '空白页 1', description: '经营管理空白页 1' }, { key: 'managementBlankPage2', label: '空白页 2', description: '经营管理空白页 2' }, + { key: 'managementBlankPage7', label: '外销销量', description: '外销销量查看、下载与维护' }, { key: 'finishedProductProgress', label: '成品进度明细', description: '成品进度查看、导出与维护' }, { key: 'employeeHours', label: '员工工时统计', description: '员工本人、部门或全公司数据范围单独设置' }, { key: 'productArchive', label: '产品全量档案', description: '商品、供应链和运营档案' }, @@ -386,6 +388,7 @@ export const SUPPLY_CHAIN_PERMISSION_TARGET_ROUTES: Partial< orderNotDispatched: '/supply-chain/management/order-not-dispatched', managementBlankPage1: '/supply-chain/management/blank-pages/blank-page-1', managementBlankPage2: '/supply-chain/management/blank-pages/blank-page-2', + managementBlankPage7: '/supply-chain/management/blank-pages/blank-page-7', finishedProductProgress: '/supply-chain/purchase/finished-product-progress', employeeHours: '/supply-chain/management/employee-hours', productArchive: '/supply-chain/database/product-archive', diff --git a/furniture-3d-system/src/server/repositories/external-clearance-price.repository.ts b/furniture-3d-system/src/server/repositories/external-clearance-price.repository.ts new file mode 100644 index 00000000..06b11814 --- /dev/null +++ b/furniture-3d-system/src/server/repositories/external-clearance-price.repository.ts @@ -0,0 +1,16 @@ +import { prisma } from '@/lib/prisma' + +export async function listExternalClearancePriceSourceRows() { + return prisma.supplyChainExternalOrderCost.findMany({ + select: { + onlineOrderNo: true, + internalOrderNo: true, + productCode: true, + styleCode: true, + shopProductCode: true, + shopStyleCode: true, + costPrice: true, + }, + orderBy: [{ createdAt: 'desc' }, { id: 'desc' }], + }) +} diff --git a/furniture-3d-system/src/server/repositories/external-sales-cost.repository.ts b/furniture-3d-system/src/server/repositories/external-sales-cost.repository.ts new file mode 100644 index 00000000..4bbd3497 --- /dev/null +++ b/furniture-3d-system/src/server/repositories/external-sales-cost.repository.ts @@ -0,0 +1,56 @@ +import { Prisma } from '@prisma/client' +import { prisma } from '@/lib/prisma' +import type { ExternalSalesArchiveCost } from '@/lib/external-sales' + +type ProductArchiveCostRow = { + barcode: string + costPrice: string | null + unitWeight: string | null +} + +function normalizedBarcodes(barcodes: readonly string[]) { + return Array.from(new Set( + barcodes.map((barcode) => barcode.trim().toUpperCase()).filter(Boolean), + )) +} + +export async function listExternalSalesArchiveCosts( + barcodes: readonly string[], +): Promise { + const normalized = normalizedBarcodes(barcodes) + const costs: ExternalSalesArchiveCost[] = [] + for (let offset = 0; offset < normalized.length; offset += 500) { + const chunk = normalized.slice(offset, offset + 500) + const rows = await prisma.$queryRaw(Prisma.sql` + SELECT + UPPER(BTRIM("barcode")) AS "barcode", + "costPrice" AS "costPrice", + "weight" AS "unitWeight" + FROM "SupplyChainProductArchive" + WHERE UPPER(BTRIM("barcode")) IN (${Prisma.join(chunk)}) + `) + for (const row of rows) { + const rawCostPrice = String(row.costPrice ?? '').replaceAll(',', '').trim() + const parsedCostPrice = rawCostPrice ? Number(rawCostPrice) : null + const costPrice = parsedCostPrice !== null + && Number.isFinite(parsedCostPrice) + && parsedCostPrice >= 0 + ? parsedCostPrice + : null + const rawUnitWeight = String(row.unitWeight ?? '').replaceAll(',', '').trim() + const parsedUnitWeight = rawUnitWeight ? Number(rawUnitWeight) : null + const unitWeight = parsedUnitWeight !== null + && Number.isFinite(parsedUnitWeight) + && parsedUnitWeight >= 0 + ? parsedUnitWeight + : null + if (costPrice === null && unitWeight === null) continue + costs.push({ + barcode: row.barcode.trim().toUpperCase(), + costPrice, + unitWeight, + }) + } + } + return costs +} diff --git a/furniture-3d-system/src/server/repositories/external-sales.repository.ts b/furniture-3d-system/src/server/repositories/external-sales.repository.ts new file mode 100644 index 00000000..dacbb897 --- /dev/null +++ b/furniture-3d-system/src/server/repositories/external-sales.repository.ts @@ -0,0 +1,327 @@ +import sql from 'mssql' +import { + allocateExternalSalesPaidAmounts, + buildExternalSalesDetailAfterSaleMetricsSql, + buildExternalSalesWaybillFreightSql, + buildExternalSalesAfterSaleMetricsSql, + buildExternalSalesAfterSaleWhereSql, + buildExternalSalesSourceSql, + resolveExternalSalesTargetShop, + type ExternalSalesAfterSaleRow, + type ExternalSalesAfterSaleMetric, + type ExternalSalesDetailAfterSaleMetric, + type ExternalSalesWaybillFreight, + type ExternalSalesItemRow, + type ExternalSalesTargetShop, +} from '@/lib/external-sales' + +type ExternalSalesSourcePoolGlobal = typeof globalThis & { + externalSalesSourcePool?: sql.ConnectionPool +} + +function requiredEnv(name: string) { + const value = process.env[name]?.trim() + if (!value) throw new Error(`Missing required environment variable: ${name}`) + return value +} + +function booleanEnv(name: string, fallback: boolean) { + const value = process.env[name]?.trim().toLowerCase() + return value ? value === 'true' || value === '1' : fallback +} + +function sourcePool() { + const globalForPool = globalThis as ExternalSalesSourcePoolGlobal + if (globalForPool.externalSalesSourcePool) return globalForPool.externalSalesSourcePool + const pool = new sql.ConnectionPool({ + server: requiredEnv('JST_REPORT_DB_HOST'), + port: Number(process.env.JST_REPORT_DB_PORT?.trim() || '1433'), + database: requiredEnv('JST_REPORT_DB_NAME'), + user: requiredEnv('JST_REPORT_DB_USER'), + password: requiredEnv('JST_REPORT_DB_PASSWORD'), + options: { + encrypt: booleanEnv('JST_REPORT_DB_ENCRYPT', true), + trustServerCertificate: booleanEnv('JST_REPORT_DB_TRUST_SERVER_CERTIFICATE', true), + readOnlyIntent: true, + appName: 'furniture-external-sales-readonly', + }, + pool: { min: 0, max: 2, idleTimeoutMillis: 60_000 }, + connectionTimeout: 20_000, + requestTimeout: 120_000, + }) + globalForPool.externalSalesSourcePool = pool + return pool +} + +function text(value: unknown) { + return String(value ?? '').trim() +} + +function dateTimeText(value: unknown) { + if (value instanceof Date) return value.toISOString().replace('T', ' ').slice(0, 19) + return text(value).replace('T', ' ').slice(0, 19) +} + +function numberValue(value: unknown) { + const parsed = Number(value) + return Number.isFinite(parsed) ? parsed : 0 +} + +function nullableNumberValue(value: unknown) { + if (value === null || value === undefined || String(value).trim() === '') return null + const parsed = Number(value) + return Number.isFinite(parsed) ? parsed : null +} + +function targetShop(value: unknown): ExternalSalesTargetShop | null { + return resolveExternalSalesTargetShop(text(value)) +} + +export async function listExternalSalesItems(input: { + dateFrom?: string + dateTo?: string + shopName?: ExternalSalesTargetShop | '' +}) { + const sourceSql = buildExternalSalesSourceSql({ + ...input, + sourceTypes: ['QMCUST'], + }) + const outerSql = `SELECT * FROM OPENQUERY([JianSun_Old], N'${sourceSql.replaceAll("'", "''")}')` + const pool = await sourcePool().connect() + const result = await pool.request().query>(outerSql) + const latest = new Map>() + for (const row of result.recordset) { + const key = `${text(row.src)}|${text(row.o_id)}|${text(row.oi_id)}` + const current = latest.get(key) + const rank = (candidate: Record) => [ + numberValue(candidate.header_row_id), + numberValue(candidate.item_row_id), + ] as const + const [headerRowId, itemRowId] = rank(row) + const [currentHeaderRowId, currentItemRowId] = current ? rank(current) : [-1, -1] + if (!current + || headerRowId > currentHeaderRowId + || (headerRowId === currentHeaderRowId && itemRowId > currentItemRowId)) { + latest.set(key, row) + } + } + const rows = [...latest.values()].flatMap((row): ExternalSalesItemRow[] => { + const shopName = targetShop(row.shop_name) + if (!shopName) return [] + return [{ + sourceType: text(row.src).toUpperCase() === 'QMCUST' ? 'QMCUST' : 'OTHER', + oId: text(row.o_id), + oiId: text(row.oi_id), + orderNo: text(row.so_id), + shopName, + shippingCourier: text(row.logistics_company), + trackingNo: text(row.l_id), + shipmentWeight: nullableNumberValue(row.shipment_weight), + shippingUnitWeight: null, + shippingWeight: null, + freight: null, + statsDate: text(row.stats_date), + orderDate: text(row.order_date), + sendDate: text(row.send_date), + orderStatus: text(row.status), + itemStatus: text(row.item_status), + ownerName: text(row.creator_name) || text(row.referrer_name), + localItemId: text(row.item_row_id), + skuId: text(row.sku_id), + itemId: text(row.i_id), + shopSkuId: text(row.shop_sku_id), + shopItemId: text(row.shop_i_id), + propertiesValue: text(row.properties_value), + itemName: text(row.name), + basePrice: numberValue(row.base_price), + price: numberValue(row.price), + qty: Math.max(0, Math.trunc(numberValue(row.qty))), + amount: numberValue(row.amount), + afterSaleAmount: 0, + afterSaleQty: 0, + finalShipAmount: numberValue(row.amount), + finalShipQty: Math.max(0, Math.trunc(numberValue(row.qty))), + orderPaidAmount: nullableNumberValue(row.paid_amount), + outerOiId: text(row.outer_oi_id), + costPrice: null, + goodsValue: null, + clearancePrice: null, + clearanceGoodsValue: null, + refundStatus: '', + refundQty: 0, + }] + }) + return allocateExternalSalesPaidAmounts(rows) +} + +function mapAfterSaleRow(row: Record): ExternalSalesAfterSaleRow[] { + const shopName = targetShop(row.shop_name) + const orderNo = text(row.so_id) || text(row.raw_so_id) + const asDate = dateTimeText(row.as_date) + if (!shopName || !orderNo || !asDate) return [] + const refundAmount = numberValue(row.item_amount) + const refundQty = Math.max(0, Math.trunc(numberValue(row.qty))) + return [{ + asId: `${text(row.as_id)}|${text(row.item_row_id)}`, + outerAsId: text(row.outer_as_id), + orderNo, + shopName, + asDate, + afterSaleStatus: text(row.status), + afterSaleType: text(row.type), + refundPhase: text(row.refund_phase), + goodsStatus: text(row.goods_status), + creatorName: text(row.creator_name), + questionType: text(row.question_type), + buyerApplyRefund: numberValue(row.buyer_apply_refund), + refundAmount, + receiveRefund: numberValue(row.buyer_receive_refund), + confirmDate: dateTimeText(row.confirm_date), + localItemId: text(row.item_row_id), + skuId: text(row.sku_id), + itemId: text(row.i_id), + shopSkuId: text(row.shop_sku_id), + itemName: text(row.item_name), + propertiesValue: text(row.properties_value), + qty: refundQty, + returnedQty: Math.max(0, Math.trunc(numberValue(row.returned_qty))), + amount: numberValue(row.item_amount), + remark: text(row.item_remark) || text(row.remark), + }] +} + +export async function getExternalSalesAfterSalePage(input: { + page: number + pageSize: number + keyword?: string + shopName?: ExternalSalesTargetShop | '' + dateFrom?: string + dateTo?: string + orderNo?: string + itemCode?: string +}) { + const where = buildExternalSalesAfterSaleWhereSql(input) + const offset = (input.page - 1) * input.pageSize + const pool = await sourcePool().connect() + const aggregateSql = ` +SELECT COUNT_BIG(*) AS row_count, + SUM(TRY_CONVERT(decimal(18,4), ISNULL(i.amount, '0'))) AS refund_amount, + SUM(CAST(ISNULL(i.qty, 0) AS bigint)) AS refund_qty +FROM JianSun.dbo.jst_qmcust_refundlist h +INNER JOIN JianSun.dbo.jst_qmcust_refundlist_item i ON i.as_id = h.as_id +WHERE ${where}` + const pageSql = ` +SELECT h.as_id, h.outer_as_id, h.so_id, h.raw_so_id, h.as_date, + h.status, h.type, h.shop_name, h.creator_name, h.question_type, + h.buyer_apply_refund, h.buyer_receive_refund, h.confirm_date, h.remark, + h.refund_phase, h.good_status, + i.asi_id AS item_row_id, i.sku_id, i.i_id, i.shop_sku_id, + i.name AS item_name, i.properties_value, i.qty, i.r_qty AS returned_qty, + TRY_CONVERT(decimal(18,4), ISNULL(i.amount, '0')) AS item_amount, + i.remark AS item_remark +FROM JianSun.dbo.jst_qmcust_refundlist h +INNER JOIN JianSun.dbo.jst_qmcust_refundlist_item i ON i.as_id = h.as_id +WHERE ${where} +ORDER BY h.as_date DESC, h.as_id DESC, i.asi_id DESC +OFFSET ${offset} ROWS FETCH NEXT ${input.pageSize} ROWS ONLY` + const [aggregate, page] = await Promise.all([ + pool.request().query>( + `SELECT * FROM OPENQUERY([JianSun_Old], N'${aggregateSql.replaceAll("'", "''")}')`, + ), + pool.request().query>( + `SELECT * FROM OPENQUERY([JianSun_Old], N'${pageSql.replaceAll("'", "''")}')`, + ), + ]) + const total = numberValue(aggregate.recordset[0]?.row_count) + const totalPages = Math.max(1, Math.ceil(total / input.pageSize)) + return { + rows: page.recordset.flatMap(mapAfterSaleRow), + pageInfo: { + page: Math.min(Math.max(1, input.page), totalPages), + pageSize: input.pageSize, + total, + totalPages, + }, + totals: { + afterSaleCount: total, + refundAmount: numberValue(aggregate.recordset[0]?.refund_amount), + refundQty: numberValue(aggregate.recordset[0]?.refund_qty), + }, + } +} + +export async function listExternalSalesAfterSaleMetrics(orderNos: readonly string[]) { + const uniqueOrderNos = [...new Set(orderNos.map((value) => value.trim()).filter(Boolean))] + if (uniqueOrderNos.length === 0) return [] as ExternalSalesAfterSaleMetric[] + const pool = await sourcePool().connect() + const chunks: string[][] = [] + for (let offset = 0; offset < uniqueOrderNos.length; offset += 50) { + chunks.push(uniqueOrderNos.slice(offset, offset + 50)) + } + const results = await Promise.all(chunks.map((chunk) => { + const sourceSql = buildExternalSalesAfterSaleMetricsSql(chunk) + return pool.request().query>( + `SELECT * FROM OPENQUERY([JianSun_Old], N'${sourceSql.replaceAll("'", "''")}')`, + ) + })) + return results.flatMap((result) => result.recordset.flatMap((row): ExternalSalesAfterSaleMetric[] => { + const orderNo = text(row.order_no) + if (!orderNo) return [] + return [{ + orderNo, + afterSaleAmount: numberValue(row.after_sale_amount), + afterSaleQty: Math.max(0, Math.trunc(numberValue(row.after_sale_qty))), + }] + })) +} + +export async function listExternalSalesDetailAfterSaleMetrics(orderNos: readonly string[]) { + const uniqueOrderNos = [...new Set(orderNos.map((value) => value.trim()).filter(Boolean))] + if (uniqueOrderNos.length === 0) return [] as ExternalSalesDetailAfterSaleMetric[] + const pool = await sourcePool().connect() + const chunks: string[][] = [] + for (let offset = 0; offset < uniqueOrderNos.length; offset += 50) { + chunks.push(uniqueOrderNos.slice(offset, offset + 50)) + } + const results = await Promise.all(chunks.map((chunk) => { + const sourceSql = buildExternalSalesDetailAfterSaleMetricsSql(chunk) + return pool.request().query>( + `SELECT * FROM OPENQUERY([JianSun_Old], N'${sourceSql.replaceAll("'", "''")}')`, + ) + })) + return results.flatMap((result) => result.recordset.flatMap((row): ExternalSalesDetailAfterSaleMetric[] => { + const orderNo = text(row.order_no) + const skuId = text(row.sku_id) + if (!orderNo || !skuId) return [] + return [{ + orderNo, + skuId, + afterSaleAmount: numberValue(row.after_sale_amount), + afterSaleQty: Math.max(0, Math.trunc(numberValue(row.after_sale_qty))), + }] + })) +} + +export async function listExternalSalesWaybillFreight(trackingNos: readonly string[]) { + const uniqueTrackingNos = [...new Set( + trackingNos.map((value) => value.trim()).filter(Boolean), + )] + if (uniqueTrackingNos.length === 0) return [] as ExternalSalesWaybillFreight[] + const pool = await sourcePool().connect() + const chunks: string[][] = [] + for (let offset = 0; offset < uniqueTrackingNos.length; offset += 50) { + chunks.push(uniqueTrackingNos.slice(offset, offset + 50)) + } + const results = await Promise.all(chunks.map((chunk) => { + const sourceSql = buildExternalSalesWaybillFreightSql(chunk) + return pool.request().query>( + `SELECT * FROM OPENQUERY([JianSun_Old], N'${sourceSql.replaceAll("'", "''")}')`, + ) + })) + return results.flatMap((result) => result.recordset.flatMap((row): ExternalSalesWaybillFreight[] => { + const trackingNo = text(row.tracking_no) + if (!trackingNo || row.freight_cost === null || row.freight_cost === undefined) return [] + const freightCost = numberValue(row.freight_cost) + return freightCost >= 0 ? [{ trackingNo, freightCost }] : [] + })) +} diff --git a/furniture-3d-system/src/server/repositories/supply-chain-external-freight.repository.ts b/furniture-3d-system/src/server/repositories/supply-chain-external-freight.repository.ts new file mode 100644 index 00000000..ef8e188f --- /dev/null +++ b/furniture-3d-system/src/server/repositories/supply-chain-external-freight.repository.ts @@ -0,0 +1,96 @@ +import { randomUUID } from 'node:crypto' +import { Prisma } from '@prisma/client' +import { prisma } from '@/lib/prisma' +import type { ExternalFreightImportRow } from '@/lib/external-freight' + +export type ExternalFreightRecordInput = ExternalFreightImportRow & { + sourceFileName: string + importedById: string + importedByName: string +} + +type ExternalFreightDatabaseRow = { + id: string + shipMonth: string + orderNo: string + outboundQty: number + incomeAfterTaxRefund: Prisma.Decimal | null + estimatedFreight: Prisma.Decimal + remark: string + sourceFileName: string + importedByName: string + createdAt: Date + updatedAt: Date +} + +class SupplyChainExternalFreightRepository { + async listAll() { + return prisma.$queryRaw(Prisma.sql` + SELECT + "id", + "shipMonth", + "orderNo", + "outboundQty", + "incomeAfterTaxRefund", + "estimatedFreight", + "remark", + "sourceFileName", + "importedByName", + "createdAt", + "updatedAt" + FROM "SupplyChainExternalFreightRecord" + ORDER BY "updatedAt" DESC, "orderNo" ASC + `) + } + + async upsertMany(rows: readonly ExternalFreightRecordInput[]) { + await prisma.$transaction(async (tx) => { + for (const row of rows) { + await tx.$executeRaw(Prisma.sql` + INSERT INTO "SupplyChainExternalFreightRecord" ( + "id", + "shipMonth", + "orderNo", + "outboundQty", + "incomeAfterTaxRefund", + "estimatedFreight", + "remark", + "sourceFileName", + "importedById", + "importedByName", + "createdAt", + "updatedAt" + ) + VALUES ( + ${randomUUID()}, + ${row.shipMonth}, + ${row.orderNo}, + ${row.outboundQty}, + ${row.incomeAfterTaxRefund}, + ${row.estimatedFreight}, + ${row.remark}, + ${row.sourceFileName}, + ${row.importedById}, + ${row.importedByName}, + CURRENT_TIMESTAMP, + CURRENT_TIMESTAMP + ) + ON CONFLICT ("orderNo") DO UPDATE SET + "shipMonth" = EXCLUDED."shipMonth", + "outboundQty" = EXCLUDED."outboundQty", + "incomeAfterTaxRefund" = EXCLUDED."incomeAfterTaxRefund", + "estimatedFreight" = EXCLUDED."estimatedFreight", + "remark" = EXCLUDED."remark", + "sourceFileName" = EXCLUDED."sourceFileName", + "importedById" = EXCLUDED."importedById", + "importedByName" = EXCLUDED."importedByName", + "updatedAt" = CURRENT_TIMESTAMP + `) + } + }, { maxWait: 10_000, timeout: 120_000 }) + return rows.length + } +} + +export const supplyChainExternalFreightRepository = + new SupplyChainExternalFreightRepository() diff --git a/furniture-3d-system/src/server/services/external-clearance-price.service.ts b/furniture-3d-system/src/server/services/external-clearance-price.service.ts new file mode 100644 index 00000000..cd0a36cd --- /dev/null +++ b/furniture-3d-system/src/server/services/external-clearance-price.service.ts @@ -0,0 +1,26 @@ +import { AppError, ErrorCode } from '@/server/core/errors' +import { buildExternalClearancePriceRows } from '@/lib/external-clearance-price' +import { listExternalClearancePriceSourceRows } from '@/server/repositories/external-clearance-price.repository' + +export const externalClearancePriceService = { + async list() { + try { + const rows = await listExternalClearancePriceSourceRows() + return buildExternalClearancePriceRows(rows.map((row) => ({ + onlineOrderNo: row.onlineOrderNo, + internalOrderNo: row.internalOrderNo, + productCode: row.productCode, + styleCode: row.styleCode, + shopProductCode: row.shopProductCode, + shopStyleCode: row.shopStyleCode, + costPrice: row.costPrice.toString(), + }))) + } catch (error) { + console.error('[external-clearance-price] list failed', error) + throw new AppError( + ErrorCode.SYSTEM_DATABASE, + '清货价数据读取失败,请稍后刷新重试', + ) + } + }, +} diff --git a/furniture-3d-system/src/server/services/external-profit.service.ts b/furniture-3d-system/src/server/services/external-profit.service.ts new file mode 100644 index 00000000..dc6029f1 --- /dev/null +++ b/furniture-3d-system/src/server/services/external-profit.service.ts @@ -0,0 +1,32 @@ +import { + buildExternalProfitRows, + type ExternalProfitBasis, +} from '@/lib/external-profit' +import type { ExternalSalesDetailRow } from '@/lib/external-sales' +import { externalSalesService } from '@/server/services/external-sales.service' +import { supplyChainExternalFreightService } from '@/server/services/supply-chain-external-freight.service' + +export const externalProfitService = { + async getData(basis: ExternalProfitBasis) { + const [salesPage, freightRows] = await Promise.all([ + externalSalesService.getPage({ + view: 'detail', + page: 1, + pageSize: 100_000, + }), + supplyChainExternalFreightService.list(), + ]) + return { + basis, + generatedAt: new Date().toISOString(), + rows: buildExternalProfitRows({ + basis, + salesRows: salesPage.rows as ExternalSalesDetailRow[], + freightRows: freightRows.map((row) => ({ + shipMonth: row.shipMonth, + estimatedFreight: row.estimatedFreight, + })), + }), + } + }, +} diff --git a/furniture-3d-system/src/server/services/external-sales.service.ts b/furniture-3d-system/src/server/services/external-sales.service.ts new file mode 100644 index 00000000..cfc0411e --- /dev/null +++ b/furniture-3d-system/src/server/services/external-sales.service.ts @@ -0,0 +1,198 @@ +import { AppError, ErrorCode } from '@/server/core/errors' +import { + EXTERNAL_SALES_TARGET_SHOPS, + applyExternalSalesAfterSaleMetrics, + applyExternalSalesClearancePrices, + applyExternalSalesFreight, + buildExternalSalesSummary, + enrichExternalSalesItemCosts, + externalSalesDateSpan, + filterExternalSalesItems, + paginateExternalSales, + toExternalSalesDetailRows, + type ExternalSalesItemRow, + type ExternalSalesPage, + type ExternalSalesDetailFilters, + type ExternalSalesTargetShop, + type ExternalSalesView, +} from '@/lib/external-sales' +import { + getExternalSalesAfterSalePage, + listExternalSalesAfterSaleMetrics, + listExternalSalesDetailAfterSaleMetrics, + listExternalSalesItems, + listExternalSalesWaybillFreight, +} from '@/server/repositories/external-sales.repository' +import { externalClearancePriceService } from '@/server/services/external-clearance-price.service' +import { listExternalSalesArchiveCosts } from '@/server/repositories/external-sales-cost.repository' + +const CACHE_TTL_MS = 5 * 60_000 +const cache = new Map() + +async function loadItems(input: { + dateFrom?: string + dateTo?: string + shopName: ExternalSalesTargetShop | '' +}) { + if (input.dateFrom && input.dateTo && !externalSalesDateSpan(input.dateFrom, input.dateTo)) { + throw new AppError(ErrorCode.VALIDATION_INVALID_FORMAT, '统计时间范围不正确') + } + const key = `${input.dateFrom || '*'}|${input.dateTo || '*'}|${input.shopName}` + const cached = cache.get(key) + if (cached && Date.now() - cached.fetchedAt < CACHE_TTL_MS) return cached + const rows = await listExternalSalesItems(input) + const result = { + fetchedAt: Date.now(), + generatedAt: new Date().toISOString(), + rows, + } + cache.set(key, result) + return result +} + +export const externalSalesService = { + async getPage(input: { + view: ExternalSalesView + dateFrom?: string + dateTo?: string + shopName?: ExternalSalesTargetShop | '' + keyword?: string + orderNo?: string + itemCode?: string + detailFilters?: ExternalSalesDetailFilters + page?: number + pageSize?: number + }): Promise { + const shopName = input.shopName && EXTERNAL_SALES_TARGET_SHOPS.includes(input.shopName) + ? input.shopName + : '' + if (input.view === 'afterSale') { + const source = await getExternalSalesAfterSalePage({ + page: input.page ?? 1, + pageSize: input.pageSize ?? 50, + keyword: input.keyword, + shopName, + dateFrom: input.dateFrom, + dateTo: input.dateTo, + orderNo: input.orderNo, + itemCode: input.itemCode, + }) + return { + view: input.view, + dateFrom: input.dateFrom || '', + dateTo: input.dateTo || '', + shopName, + generatedAt: new Date().toISOString(), + rows: source.rows, + pageInfo: source.pageInfo, + totals: { + orderCount: 0, + shipAmount: 0, + shipQty: 0, + afterSaleCount: source.totals.afterSaleCount, + refundQty: source.totals.refundQty, + refundAmount: source.totals.refundAmount, + }, + } + } + const source = await loadItems({ + dateFrom: input.dateFrom || '', + dateTo: input.dateTo || '', + shopName, + }) + const filtered = filterExternalSalesItems( + source.rows, + input.keyword ?? '', + input.view === 'detail' ? input.detailFilters : {}, + ) + const detailSource = input.view === 'detail' && filtered.length > 0 + ? await Promise.all([ + listExternalSalesArchiveCosts(filtered.map((row) => row.skuId)), + listExternalSalesDetailAfterSaleMetrics([ + ...new Set(filtered.map((row) => row.orderNo)), + ]), + listExternalSalesWaybillFreight([ + ...new Set(filtered.map((row) => row.trackingNo)), + ]), + externalClearancePriceService.list(), + ]).then(([archiveCosts, afterSaleMetrics, waybillFreight, clearancePrices]) => ( + applyExternalSalesClearancePrices( + applyExternalSalesFreight( + applyExternalSalesAfterSaleMetrics( + enrichExternalSalesItemCosts(filtered, archiveCosts), + afterSaleMetrics, + ), + waybillFreight, + ), + clearancePrices, + ) + )) + : filtered + const afterSaleMetrics = input.view === 'summary' + ? await listExternalSalesAfterSaleMetrics([...new Set(filtered.map((row) => row.orderNo))]) + : [] + const summaryRows = buildExternalSalesSummary(filtered, afterSaleMetrics) + const detailRows = toExternalSalesDetailRows(detailSource) + const detailTotals = input.view === 'detail' + ? { + shipAmount: Math.round(detailSource.reduce((sum, row) => sum + row.amount, 0) * 100) / 100, + shipQty: detailSource.reduce((sum, row) => sum + row.qty, 0), + afterSaleCount: detailSource.filter( + (row) => row.afterSaleAmount > 0 || row.afterSaleQty > 0, + ).length, + refundQty: detailSource.reduce((sum, row) => sum + row.afterSaleQty, 0), + refundAmount: Math.round( + detailSource.reduce((sum, row) => sum + row.afterSaleAmount, 0) * 100, + ) / 100, + goodsValue: Math.round( + detailSource.reduce((sum, row) => sum + (row.goodsValue ?? 0), 0) * 100, + ) / 100, + freight: Math.round( + detailSource.reduce((sum, row) => sum + (row.freight ?? 0), 0) * 100, + ) / 100, + clearanceGoodsValue: Math.round( + detailSource.reduce((sum, row) => sum + (row.clearanceGoodsValue ?? 0), 0) * 100, + ) / 100, + } + : null + const pageSize = input.pageSize ?? 50 + const paged = input.view === 'summary' + ? paginateExternalSales(summaryRows, input.page ?? 1, pageSize) + : paginateExternalSales(detailRows, input.page ?? 1, pageSize) + return { + view: input.view, + dateFrom: input.dateFrom || '', + dateTo: input.dateTo || '', + shopName, + generatedAt: source.generatedAt, + rows: paged.rows, + detailColumnAvailability: input.view === 'detail' + ? { + shopSkuId: filtered.some((row) => row.shopSkuId.trim().length > 0), + shopItemId: filtered.some((row) => row.shopItemId.trim().length > 0), + } + : undefined, + pageInfo: paged.pageInfo, + totals: { + orderCount: summaryRows.length, + shipAmount: detailTotals?.shipAmount ?? + Math.round(summaryRows.reduce((total, row) => total + row.shipAmount, 0) * 100) / 100, + shipQty: detailTotals?.shipQty ?? + summaryRows.reduce((total, row) => total + row.shipQty, 0), + afterSaleCount: detailTotals?.afterSaleCount ?? + summaryRows.filter((row) => row.afterSaleQty > 0).length, + refundQty: detailTotals?.refundQty ?? + summaryRows.reduce((total, row) => total + row.afterSaleQty, 0), + refundAmount: detailTotals?.refundAmount ?? + Math.round(summaryRows.reduce((total, row) => total + row.afterSaleAmount, 0) * 100) / 100, + goodsValue: detailTotals?.goodsValue, + freight: detailTotals?.freight, + clearanceGoodsValue: detailTotals?.clearanceGoodsValue, + }, + } + }, +} diff --git a/furniture-3d-system/src/server/services/supply-chain-external-freight.service.ts b/furniture-3d-system/src/server/services/supply-chain-external-freight.service.ts new file mode 100644 index 00000000..784c4da2 --- /dev/null +++ b/furniture-3d-system/src/server/services/supply-chain-external-freight.service.ts @@ -0,0 +1,90 @@ +import { AppError, ErrorCode } from '@/server/core/errors' +import type { AuthUser } from '@/server/core/types' +import { + createExternalFreightTemplate, + parseExternalFreightWorkbook, + type ExternalFreightRecordView, +} from '@/lib/external-freight' +import { + supplyChainExternalFreightRepository, + type ExternalFreightRecordInput, +} from '@/server/repositories/supply-chain-external-freight.repository' + +type Repository = Pick + +function number(value: unknown) { + return value == null ? null : Number(value) +} + +export class SupplyChainExternalFreightService { + constructor( + private readonly repository: Repository = supplyChainExternalFreightRepository, + ) {} + + async list(): Promise { + let rows + try { + rows = await this.repository.listAll() + } catch (error) { + console.error('[external-freight] list failed', error) + throw new AppError( + ErrorCode.SYSTEM_DATABASE, + '货代费数据读取失败,请稍后刷新重试', + ) + } + return rows.map((row) => ({ + id: row.id, + shipMonth: row.shipMonth, + orderNo: row.orderNo, + outboundQty: row.outboundQty, + incomeAfterTaxRefund: number(row.incomeAfterTaxRefund), + estimatedFreight: number(row.estimatedFreight) ?? 0, + remark: row.remark, + sourceFileName: row.sourceFileName, + importedByName: row.importedByName, + createdAt: row.createdAt.toISOString(), + updatedAt: row.updatedAt.toISOString(), + })) + } + + async importFile(input: { + fileName: string + buffer: Buffer + user: AuthUser + }) { + let parsed + try { + parsed = await parseExternalFreightWorkbook(input.buffer) + } catch (error) { + throw new AppError( + ErrorCode.VALIDATION_INVALID_FORMAT, + `${input.fileName}:${error instanceof Error ? error.message : '文件格式不正确'}`, + ) + } + const rows: ExternalFreightRecordInput[] = parsed.map((row) => ({ + ...row, + orderNo: row.orderNo.trim().toUpperCase(), + sourceFileName: input.fileName, + importedById: input.user.id, + importedByName: input.user.name, + })) + let importedCount + try { + importedCount = await this.repository.upsertMany(rows) + } catch (error) { + console.error('[external-freight] import failed', error) + throw new AppError( + ErrorCode.SYSTEM_DATABASE, + '货代费导入失败,请检查模板或稍后重试', + ) + } + return { importedCount, fileName: input.fileName } + } + + createTemplate() { + return createExternalFreightTemplate() + } +} + +export const supplyChainExternalFreightService = + new SupplyChainExternalFreightService()