This commit is contained in:
2026-08-04 21:01:39 +08:00
parent 88bd939170
commit 5cb1ca307d
77 changed files with 9914 additions and 131 deletions
@@ -0,0 +1,116 @@
import { beforeEach, describe, expect, it, vi } from 'vitest'
const mocks = vi.hoisted(() => ({
get: vi.fn(),
post: vi.fn(),
delete: vi.fn(),
}))
vi.mock('@/shared/api/http', () => ({
http: mocks,
unwrapApiResponse: <T>(response: { data: T }) => response.data,
}))
import {
createPlatformCarrierRateVersion,
getPlatformCarrierRate,
listPlatformCarrierRates,
retirePlatformCarrierRate,
} from './platformCarrierRates'
const payload = {
id: '9007199254740995',
tenantId: '10001',
rateCode: 'RATE-US-WEST',
rateVersion: 2,
originWarehouseId: '20001',
originWarehouseName: '义乌收货仓',
businessType: 'FBA_SEA',
channelCode: 'US-WEST-SEA',
carrierId: '30001',
carrierName: '示例船司',
destinationCode: 'ONT8',
chargeUnit: 'KG' as const,
unitPrice: 12.5,
currency: 'CNY',
additionalFee: 80,
effectiveFrom: '2026-08-01T00:00:00',
effectiveTo: null,
status: 'ACTIVE' as const,
remark: null,
createdBy: '10',
createdAt: '2026-08-01T10:00:00',
updatedBy: null,
updatedAt: null,
version: 1,
}
describe('platformCarrierRates api', () => {
beforeEach(() => vi.clearAllMocks())
it('queries the real carrier-rate path and keeps every long id as a string', async () => {
mocks.get.mockResolvedValue({ data: [payload] })
const result = await listPlatformCarrierRates({ customerId: ' 10001 ', rateCode: ' RATE-US ' })
expect(mocks.get).toHaveBeenCalledWith('/platform/v1/fba-pricing/carrier-rates', {
params: { tenantId: '10001', rateCode: 'RATE-US' },
})
expect(result[0]).toMatchObject({
id: '9007199254740995',
tenantId: '10001',
originWarehouseId: '20001',
carrierId: '30001',
})
})
it('omits the compatibility tenant parameter for an all-customer list query', async () => {
mocks.get.mockResolvedValue({ data: [payload] })
await listPlatformCarrierRates()
await listPlatformCarrierRates({ customerId: '', rateCode: ' ' })
expect(mocks.get).toHaveBeenNthCalledWith(1, '/platform/v1/fba-pricing/carrier-rates', { params: {} })
expect(mocks.get).toHaveBeenNthCalledWith(2, '/platform/v1/fba-pricing/carrier-rates', { params: {} })
})
it('loads a version detail with tenant scope', async () => {
mocks.get.mockResolvedValue({ data: payload })
await getPlatformCarrierRate('10001', '9001')
expect(mocks.get).toHaveBeenCalledWith('/platform/v1/fba-pricing/carrier-rates/9001', {
params: { tenantId: '10001' },
})
})
it('creates immutable versions and retires an active version', async () => {
mocks.post.mockResolvedValue({ data: payload })
mocks.delete.mockResolvedValue({ data: null })
const request = {
rateCode: 'RATE-US-WEST',
originWarehouseId: '20001',
originWarehouseName: '义乌收货仓',
businessType: 'FBA_SEA',
channelCode: 'US-WEST-SEA',
carrierId: '30001',
carrierName: '示例船司',
destinationCode: 'ONT8',
chargeUnit: 'KG' as const,
unitPrice: 12.5,
currency: 'CNY',
additionalFee: 80,
effectiveFrom: '2026-08-01T00:00:00',
effectiveTo: null,
remark: null,
}
await createPlatformCarrierRateVersion('10001', request)
await retirePlatformCarrierRate('10001', '9001')
expect(mocks.post).toHaveBeenCalledWith('/platform/v1/fba-pricing/carrier-rates/versions', request, {
params: { tenantId: '10001' },
})
expect(mocks.delete).toHaveBeenCalledWith('/platform/v1/fba-pricing/carrier-rates/9001', {
params: { tenantId: '10001' },
})
})
})
@@ -0,0 +1,124 @@
import { http, unwrapApiResponse, type ApiEnvelope } from '@/shared/api/http'
export type CarrierRateChargeUnit = 'KG' | 'CBM'
export type CarrierRateStatus = 'ACTIVE' | 'INACTIVE'
export interface PlatformCarrierRateResource {
id: string
tenantId: string
rateCode: string
rateVersion: number
originWarehouseId: string
originWarehouseName: string
businessType: string
channelCode: string
carrierId: string
carrierName: string
destinationCode: string
chargeUnit: CarrierRateChargeUnit
unitPrice: number
currency: string
additionalFee: number
effectiveFrom: string
effectiveTo: string | null
status: CarrierRateStatus
remark: string | null
createdBy: string | null
createdAt: string | null
updatedBy: string | null
updatedAt: string | null
version: number | null
}
interface PlatformCarrierRatePayload extends Omit<PlatformCarrierRateResource,
'id' | 'tenantId' | 'originWarehouseId' | 'carrierId' | 'createdBy' | 'updatedBy'> {
id: string | number
tenantId: string | number
originWarehouseId: string | number
carrierId: string | number
createdBy?: string | number | null
updatedBy?: string | number | null
}
export interface CreatePlatformCarrierRateVersionRequest {
rateCode: string
originWarehouseId: string
originWarehouseName: string
businessType: string
channelCode: string
carrierId: string
carrierName: string
destinationCode: string
chargeUnit: CarrierRateChargeUnit
unitPrice: number
currency: string
additionalFee: number
effectiveFrom: string
effectiveTo: string | null
remark: string | null
}
export interface PlatformCarrierRateQuery {
customerId?: string
rateCode?: string
}
const basePath = '/platform/v1/fba-pricing/carrier-rates'
function nullableId(value: string | number | null | undefined) {
return value == null ? null : String(value)
}
function normalizeCarrierRate(value: PlatformCarrierRatePayload): PlatformCarrierRateResource {
return {
...value,
id: String(value.id),
tenantId: String(value.tenantId),
originWarehouseId: String(value.originWarehouseId),
carrierId: String(value.carrierId),
createdBy: nullableId(value.createdBy),
updatedBy: nullableId(value.updatedBy),
effectiveTo: value.effectiveTo ?? null,
remark: value.remark ?? null,
createdAt: value.createdAt ?? null,
updatedAt: value.updatedAt ?? null,
version: value.version ?? null,
}
}
export async function listPlatformCarrierRates(query: PlatformCarrierRateQuery = {}) {
const customerId = query.customerId?.trim()
const rateCode = query.rateCode?.trim()
const response = await http.get<ApiEnvelope<PlatformCarrierRatePayload[]>, ApiEnvelope<PlatformCarrierRatePayload[]>>(
basePath,
{ params: { ...(customerId ? { tenantId: customerId } : {}), ...(rateCode ? { rateCode } : {}) } },
)
return unwrapApiResponse(response).map(normalizeCarrierRate)
}
export async function getPlatformCarrierRate(tenantId: string, id: string) {
const response = await http.get<ApiEnvelope<PlatformCarrierRatePayload>, ApiEnvelope<PlatformCarrierRatePayload>>(
`${basePath}/${id}`,
{ params: { tenantId } },
)
return normalizeCarrierRate(unwrapApiResponse(response))
}
export async function createPlatformCarrierRateVersion(
tenantId: string,
payload: CreatePlatformCarrierRateVersionRequest,
) {
const response = await http.post<ApiEnvelope<PlatformCarrierRatePayload>, ApiEnvelope<PlatformCarrierRatePayload>>(
`${basePath}/versions`,
payload,
{ params: { tenantId } },
)
return normalizeCarrierRate(unwrapApiResponse(response))
}
export async function retirePlatformCarrierRate(tenantId: string, id: string) {
const response = await http.delete<ApiEnvelope<null>, ApiEnvelope<null>>(`${basePath}/${id}`, {
params: { tenantId },
})
return unwrapApiResponse(response)
}
@@ -0,0 +1,98 @@
import { readFileSync } from 'node:fs'
import { join } from 'node:path'
import { describe, expect, it } from 'vitest'
const source = readFileSync(join(process.cwd(), 'src/modules/fba-pricing/carrier-rates/pages/CarrierRatesView.vue'), 'utf8')
const queryToolbarSource = readFileSync(join(process.cwd(), 'src/shared/components/QueryToolbar.vue'), 'utf8')
describe('CarrierRatesView source contract', () => {
it('keeps operation column first and covers every required business field', () => {
const customerColumn = "key: 'customer', label: '所属企业'"
const destinationColumn = "key: 'destinationCode', prop: 'destinationCode'"
expect(source.indexOf("key: 'actions'")).toBeLessThan(source.indexOf(customerColumn))
expect(source.indexOf(customerColumn)).toBeLessThan(source.indexOf(destinationColumn))
expect(source.indexOf(destinationColumn)).toBeLessThan(source.indexOf("key: 'rate'"))
for (const label of ['起运仓', '业务类型', '渠道编码', '船司', 'FBA 目的仓', '计费单位', '单价', '币种', '固定附加费', '有效期', '备注', '生效时间', '结束时间']) {
expect(source).toContain(label)
}
expect(source).toContain("placeholder: 'FBA 目的仓编码'")
expect(source).toContain("placeholder: '渠道编码'")
})
it('implements immutable version actions with exact backend permissions', () => {
expect(source).toContain("firstleg:fba-pricing:rate:edit")
expect(source).toContain('创建版本')
expect(source).toContain('新版本')
expect(source).toContain('停用')
expect(source).not.toContain('编辑价格')
})
it('keeps the customer company scope in the query toolbar without exposing tenant concepts', () => {
expect(source).toContain("key: 'customerId'")
expect(source.indexOf("key: 'customerId'")).toBeLessThan(source.indexOf("key: 'rateCode'"))
expect(source).toContain("'aria-label': '所属企业'")
expect(source).toContain('listPlatformTenants')
expect(source).toContain('loadedCustomerId')
expect(source).not.toContain('PlatformTenantSelector')
expect(source).not.toContain('selectedTenantId')
expect(source).not.toContain('租户')
})
it('uses semantic compact filter widths and keeps the customer selection empty by default', () => {
for (const field of [
"key: 'customerId',\n type: 'select',\n width: 280",
"key: 'rateCode', type: 'input', width: 220",
"key: 'destinationCode', type: 'input', width: 220",
"key: 'channelCode', type: 'input', width: 220",
"key: 'chargeUnit', type: 'select', width: 180",
"key: 'status', type: 'select', width: 160",
]) expect(source).toContain(field)
expect(source).toContain("customerId: ''")
expect(source).toContain("placeholder: customerLoadError.value ? '企业列表加载失败' : '全部客户'")
expect(source).not.toContain(':search-on-reset="false"')
expect(source).not.toContain('请先选择所属企业')
expect(source).not.toContain('请选择所属企业并查询价格数据')
expect(source).not.toContain('customers.value[0]')
})
it('loads all customers initially and after reset while preserving row scope for record actions', () => {
expect(source).toContain('void loadRateData()')
expect(source).toContain("listPlatformCarrierRates(customerId ? { customerId } : {})")
expect(source).toContain('loadRateData(customerId)')
expect(source).toContain('getPlatformCarrierRate(String(row.tenantId), row.id)')
expect(source).toContain('retirePlatformCarrierRate(String(row.tenantId), row.id)')
expect(source).toContain('customerLabel(detail.tenantId)')
})
it('inherits QueryToolbar wrapping and full-width mobile controls', () => {
expect(queryToolbarSource).toContain('flex-wrap: wrap')
expect(queryToolbarSource).toContain('@media (max-width: 720px)')
expect(queryToolbarSource).toContain('width: 100%')
expect(source).not.toContain('--query-field-width')
})
it('guards unsaved work, failures and narrow screens', () => {
expect(source).toContain('useUnsavedWorkRegistration')
expect(source).toContain('LoadErrorState')
expect(source).toContain('ApiErrorMeta')
expect(source).toContain('@media (max-width: 720px)')
})
it('reuses the first-leg order list primitives for status, empty state and pagination', () => {
expect(source).toContain("import StatusBadge from '@/shared/components/StatusBadge.vue'")
expect(source).toContain('<StatusBadge :status="statusLabel(')
expect(source).toContain('<template #empty><el-empty')
expect(source).toContain('<div class="business-page">')
expect(source).not.toContain('<QueryToolbar v-model="filters" class="surface-panel"')
expect(source).not.toContain('<template #pagination-left>')
expect(source).not.toContain('<el-tag')
})
it('does not create route or navigation ownership in the page task', () => {
expect(source).not.toContain('createRouter')
expect(source).not.toContain('adminNavigation')
for (const unsupportedCapability of ['导入', '导出', '全部船期', '参考时效', '最晚进仓时间']) {
expect(source).not.toContain(unsupportedCapability)
}
})
})
@@ -0,0 +1,641 @@
<script setup lang="ts">
import { computed, onMounted, reactive, ref, watch } from 'vue'
import { ElMessage, ElMessageBox, type FormInstance, type FormRules } from 'element-plus'
import { CalendarClock, Eye, Plus, Power, Ship, Warehouse } from '@lucide/vue'
import { useAccessPreviewStore } from '@/core/access/accessPreview'
import { useUnsavedWorkRegistration } from '@/core/unsaved-work/useUnsavedWorkRegistration'
import { listPlatformTenants, type PlatformTenantResource as PlatformCustomerResource } from '@/modules/iam'
import { listPlatformWarehouses, type PlatformWarehouseResource } from '@/modules/warehouses'
import { listPlatformPartners, type PlatformPartnerResource } from '@/modules/master-data'
import { getApiErrorDetails, type ApiErrorDetails } from '@/shared/api/http'
import ApiErrorMeta from '@/shared/components/ApiErrorMeta.vue'
import AppDrawer from '@/shared/components/AppDrawer.vue'
import DataTable, { type DataTableColumn } from '@/shared/components/DataTable.vue'
import LoadErrorState from '@/shared/components/LoadErrorState.vue'
import QueryToolbar, { type QueryField, type QueryModel } from '@/shared/components/QueryToolbar.vue'
import StatusBadge from '@/shared/components/StatusBadge.vue'
import {
createPlatformCarrierRateVersion,
getPlatformCarrierRate,
listPlatformCarrierRates,
retirePlatformCarrierRate,
type CarrierRateChargeUnit,
type CarrierRateStatus,
type CreatePlatformCarrierRateVersionRequest,
type PlatformCarrierRateResource,
} from '../api/platformCarrierRates'
type RateFilters = QueryModel & {
customerId: string
rateCode: string
destinationCode: string
channelCode: string
chargeUnit: CarrierRateChargeUnit | ''
status: CarrierRateStatus | ''
}
interface RateForm {
rateCode: string
originWarehouseId: string
businessType: string
channelCode: string
carrierId: string
destinationCode: string
chargeUnit: CarrierRateChargeUnit
unitPrice: number | null
currency: string
additionalFee: number | null
effectiveFrom: string
effectiveTo: string
remark: string
}
const access = useAccessPreviewStore()
const customers = ref<PlatformCustomerResource[]>([])
const customersLoading = ref(false)
const customerLoadError = ref<ApiErrorDetails | null>(null)
const loadedCustomerId = ref<string | null>(null)
const rows = ref<PlatformCarrierRateResource[]>([])
const warehouses = ref<PlatformWarehouseResource[]>([])
const carriers = ref<PlatformPartnerResource[]>([])
const loading = ref(false)
const masterDataLoading = ref(false)
const loadError = ref<ApiErrorDetails | null>(null)
const page = ref(1)
const pageSize = ref(20)
const editorOpen = ref(false)
const detailOpen = ref(false)
const detailLoading = ref(false)
const saving = ref(false)
const detail = ref<PlatformCarrierRateResource | null>(null)
const retiringIds = ref(new Set<string>())
const editorCustomerId = ref('')
const formRef = ref<FormInstance>()
let loadSequence = 0
let masterDataSequence = 0
const emptyForm = (): RateForm => ({
rateCode: '',
originWarehouseId: '',
businessType: '',
channelCode: '',
carrierId: '',
destinationCode: '',
chargeUnit: 'KG',
unitPrice: null,
currency: 'CNY',
additionalFee: 0,
effectiveFrom: '',
effectiveTo: '',
remark: '',
})
const form = reactive<RateForm>(emptyForm())
const editorLabel = computed(() => form.rateCode ? `创建 ${form.rateCode} 的新版本` : '新增船司 FBA 价格版本')
const requiredPermission = computed(() => 'firstleg:fba-pricing:rate:edit')
const { captureBaseline } = useUnsavedWorkRegistration({
key: 'carrier-rate-version-editor',
label: editorLabel,
isOpen: editorOpen,
model: form,
requiredPermission,
})
const filters = ref<RateFilters>({ customerId: '', rateCode: '', destinationCode: '', channelCode: '', chargeUnit: '', status: '' })
const appliedFilters = ref<RateFilters>({ ...filters.value })
const customerSwitchDisabled = computed(() => editorOpen.value || detailOpen.value || saving.value || detailLoading.value || retiringIds.value.size > 0)
const queryFields = computed<QueryField[]>(() => [
{
key: 'customerId',
type: 'select',
width: 280,
placeholder: customerLoadError.value ? '企业列表加载失败' : '全部客户',
props: { 'aria-label': '所属企业', filterable: true, disabled: customersLoading.value || Boolean(customerLoadError.value) || customerSwitchDisabled.value },
options: customers.value.map((customer) => ({ value: String(customer.id), label: `${customer.tenantName}(${customer.tenantCode || customer.id})` })),
},
{ key: 'rateCode', type: 'input', width: 220, placeholder: '价格编码', props: { 'aria-label': '价格编码' } },
{ key: 'destinationCode', type: 'input', width: 220, placeholder: 'FBA 目的仓编码', props: { 'aria-label': 'FBA 目的仓编码' } },
{ key: 'channelCode', type: 'input', width: 220, placeholder: '渠道编码', props: { 'aria-label': '渠道编码' } },
{
key: 'chargeUnit', type: 'select', width: 180, placeholder: '全部计费单位', props: { 'aria-label': '计费单位' }, options: [
{ label: 'KG', value: 'KG' },
{ label: 'CBM', value: 'CBM' },
],
},
{
key: 'status', type: 'select', width: 160, placeholder: '全部状态', props: { 'aria-label': '价格状态' }, options: [
{ label: '生效中', value: 'ACTIVE' },
{ label: '已停用', value: 'INACTIVE' },
],
},
])
const columns: DataTableColumn[] = [
{ key: 'actions', label: '操作', width: 230, fixed: 'left', slotName: 'actions' },
{ key: 'customer', label: '所属企业', minWidth: 200, slotName: 'customer' },
{ key: 'destinationCode', prop: 'destinationCode', label: 'FBA 目的仓', minWidth: 135 },
{ key: 'rate', label: '价格版本', minWidth: 180, slotName: 'rate' },
{ key: 'originWarehouseName', prop: 'originWarehouseName', label: '起运仓', minWidth: 170, showOverflowTooltip: true },
{ key: 'channelCode', prop: 'channelCode', label: '渠道编码', minWidth: 150, showOverflowTooltip: true },
{ key: 'carrier', label: '船司', minWidth: 170, slotName: 'carrier' },
{ key: 'businessType', prop: 'businessType', label: '业务类型', minWidth: 110 },
{ key: 'chargeUnit', prop: 'chargeUnit', label: '计费单位', width: 95 },
{ key: 'unitPrice', label: '单价', minWidth: 135, slotName: 'unitPrice' },
{ key: 'additionalFee', label: '固定附加费', minWidth: 135, slotName: 'additionalFee' },
{ key: 'currency', prop: 'currency', label: '币种', width: 80 },
{ key: 'period', label: '有效期', minWidth: 210, slotName: 'period' },
{ key: 'remark', prop: 'remark', label: '备注', minWidth: 190, showOverflowTooltip: true, formatter: (row: PlatformCarrierRateResource) => row.remark || '-' },
{ key: 'status', label: '状态', width: 90, slotName: 'status' },
{ key: 'updatedAt', label: '更新时间', minWidth: 150, formatter: (row: PlatformCarrierRateResource) => formatDateTime(row.updatedAt) },
]
const originWarehouses = computed(() => warehouses.value.filter((item) => item.status === 'ACTIVE' && item.warehouseType === 'DOMESTIC'))
const fbaWarehouses = computed(() => warehouses.value.filter((item) => item.status === 'ACTIVE' && item.warehouseType === 'FBA'))
const activeCarriers = computed(() => carriers.value.filter((item) => item.status === 'ACTIVE'))
const filteredRows = computed(() => rows.value.filter((row) => {
const code = appliedFilters.value.rateCode.trim().toLowerCase()
const destinationCode = appliedFilters.value.destinationCode.trim().toLowerCase()
const channelCode = appliedFilters.value.channelCode.trim().toLowerCase()
return (!code || row.rateCode.toLowerCase().includes(code))
&& (!destinationCode || row.destinationCode.toLowerCase().includes(destinationCode))
&& (!channelCode || row.channelCode.toLowerCase().includes(channelCode))
&& (!appliedFilters.value.chargeUnit || row.chargeUnit === appliedFilters.value.chargeUnit)
&& (!appliedFilters.value.status || row.status === appliedFilters.value.status)
}))
const pagedRows = computed(() => filteredRows.value.slice((page.value - 1) * pageSize.value, page.value * pageSize.value))
const activeCount = computed(() => rows.value.filter((row) => row.status === 'ACTIVE').length)
const loadErrorMessage = computed(() => loadError.value?.message || '')
function validateEffectiveTo(_rule: unknown, value: string, callback: (error?: Error) => void) {
if (!value || !form.effectiveFrom || new Date(value).getTime() > new Date(form.effectiveFrom).getTime()) callback()
else callback(new Error('结束时间必须晚于开始时间'))
}
const rules: FormRules<RateForm> = {
rateCode: [{ required: true, whitespace: true, message: '请输入价格编码', trigger: 'blur' }],
originWarehouseId: [{ required: true, message: '请选择起运仓', trigger: 'change' }],
businessType: [{ required: true, whitespace: true, message: '请输入业务类型', trigger: 'blur' }],
channelCode: [{ required: true, whitespace: true, message: '请输入渠道编码', trigger: 'blur' }],
carrierId: [{ required: true, message: '请选择船司', trigger: 'change' }],
destinationCode: [{ required: true, whitespace: true, message: '请选择或输入 FBA 目的仓编码', trigger: 'change' }],
chargeUnit: [{ required: true, message: '请选择计费单位', trigger: 'change' }],
unitPrice: [{ required: true, type: 'number', min: 0.000001, message: '单价必须大于 0', trigger: 'change' }],
currency: [
{ required: true, whitespace: true, message: '请输入币种', trigger: 'blur' },
{ pattern: /^[A-Z]{3}$/, message: '币种须为三个大写英文字母', trigger: 'blur' },
],
additionalFee: [{ required: true, type: 'number', min: 0, message: '附加费不能小于 0', trigger: 'change' }],
effectiveFrom: [{ required: true, message: '请选择生效时间', trigger: 'change' }],
effectiveTo: [{ validator: validateEffectiveTo, trigger: 'change' }],
}
watch(() => filters.value.customerId, (customerId) => {
if (customerId === loadedCustomerId.value) return
masterDataSequence += 1
warehouses.value = []
carriers.value = []
loadedCustomerId.value = null
page.value = 1
})
watch(
() => access.can('firstleg:fba-pricing:rate:edit'),
(canEdit) => {
if (canEdit || !editorOpen.value) return
editorOpen.value = false
Object.assign(form, emptyForm())
},
{ flush: 'sync' },
)
function formatDateTime(value: string | null | undefined) {
return value ? value.replace('T', ' ').slice(0, 16) : '-'
}
function formatMoney(value: number, currency: string) {
return `${currency} ${Number(value).toLocaleString('zh-CN', { minimumFractionDigits: 2, maximumFractionDigits: 4 })}`
}
function statusLabel(status: CarrierRateStatus) {
return status === 'ACTIVE' ? '启用' : '停用'
}
function customerLabel(customerId: string) {
const customer = customers.value.find((item) => String(item.id) === String(customerId))
return customer ? `${customer.tenantName}(${customer.tenantCode || '未设置编码'})` : '客户信息待加载'
}
function nullable(value: string) {
return value.trim() || null
}
async function loadCustomers() {
customersLoading.value = true
customerLoadError.value = null
try {
const records: PlatformCustomerResource[] = []
let currentPage = 1
let pages = 1
do {
const result = await listPlatformTenants({ page: currentPage, size: 200, status: 'ACTIVE' })
records.push(...result.records)
pages = Math.max(1, result.pages)
currentPage += 1
} while (currentPage <= pages)
customers.value = records
} catch (error) {
customers.value = []
customerLoadError.value = getApiErrorDetails(error, '企业列表加载失败,暂时无法按所属企业筛选或显示企业名称;价格列表仍可查询')
} finally {
customersLoading.value = false
}
}
async function loadRateData(customerId = filters.value.customerId) {
const sequence = ++loadSequence
loading.value = true
loadError.value = null
try {
const rateResult = await listPlatformCarrierRates(customerId ? { customerId } : {})
if (sequence !== loadSequence) return
rows.value = rateResult
} catch (error) {
if (sequence !== loadSequence) return
rows.value = []
loadError.value = getApiErrorDetails(error, '船司 FBA 价格加载失败,请稍后重试')
} finally {
if (sequence === loadSequence) {
loading.value = false
}
}
}
async function loadCustomerMasterData(customerId: string) {
if (!customerId) return false
const sequence = ++masterDataSequence
masterDataLoading.value = true
try {
const [warehouseResult, partnerResult] = await Promise.all([
listPlatformWarehouses(customerId, 1, 200),
listPlatformPartners(customerId, { page: 1, size: 200, type: 'CARRIER', status: 'ACTIVE' }),
])
if (sequence !== masterDataSequence) return false
warehouses.value = warehouseResult.records.map((item) => ({ ...item, id: String(item.id), tenantId: String(item.tenantId) }))
carriers.value = partnerResult.records.map((item) => ({ ...item, id: String(item.id), tenantId: String(item.tenantId), dataScopeId: String(item.dataScopeId) }))
loadedCustomerId.value = customerId
return true
} catch (error) {
if (sequence === masterDataSequence) {
warehouses.value = []
carriers.value = []
loadedCustomerId.value = null
ElMessage.error(getApiErrorDetails(error, '所属企业的仓库或船司资料加载失败').message)
}
return false
} finally {
if (sequence === masterDataSequence) masterDataLoading.value = false
}
}
async function applyQuery(model: QueryModel) {
const customerId = String(model.customerId || '')
appliedFilters.value = {
customerId,
rateCode: String(model.rateCode || ''),
destinationCode: String(model.destinationCode || ''),
channelCode: String(model.channelCode || ''),
chargeUnit: (model.chargeUnit || '') as CarrierRateChargeUnit | '',
status: (model.status || '') as CarrierRateStatus | '',
}
page.value = 1
await Promise.all([
loadRateData(customerId),
customerId && loadedCustomerId.value !== customerId ? loadCustomerMasterData(customerId) : Promise.resolve(true),
])
}
function resetQuery(model: QueryModel) {
appliedFilters.value = {
customerId: String(model.customerId || ''),
rateCode: String(model.rateCode || ''),
destinationCode: String(model.destinationCode || ''),
channelCode: String(model.channelCode || ''),
chargeUnit: (model.chargeUnit || '') as CarrierRateChargeUnit | '',
status: (model.status || '') as CarrierRateStatus | '',
}
page.value = 1
}
function resetForm(rate?: PlatformCarrierRateResource) {
Object.assign(form, emptyForm(), rate ? {
rateCode: rate.rateCode,
originWarehouseId: rate.originWarehouseId,
businessType: rate.businessType,
channelCode: rate.channelCode,
carrierId: rate.carrierId,
destinationCode: rate.destinationCode,
chargeUnit: rate.chargeUnit,
unitPrice: rate.unitPrice,
currency: rate.currency,
additionalFee: rate.additionalFee,
effectiveFrom: '',
effectiveTo: '',
remark: rate.remark || '',
} : {})
}
async function openCreate(rate?: PlatformCarrierRateResource) {
const customerId = String(rate?.tenantId || filters.value.customerId || '')
if (!customerId) {
ElMessage.warning('新增价格版本需要先选择所属企业')
return
}
if (loadedCustomerId.value !== customerId) {
const loaded = await loadCustomerMasterData(customerId)
if (!loaded) return
}
editorCustomerId.value = customerId
resetForm(rate)
captureBaseline()
editorOpen.value = true
requestAnimationFrame(() => formRef.value?.clearValidate())
}
async function openDetail(row: PlatformCarrierRateResource) {
detailOpen.value = true
detailLoading.value = true
detail.value = null
try {
detail.value = await getPlatformCarrierRate(String(row.tenantId), row.id)
} catch (error) {
const meta = getApiErrorDetails(error, '价格版本详情加载失败')
ElMessage.error(meta.requestId ? `${meta.message}(requestId: ${meta.requestId})` : meta.message)
detailOpen.value = false
} finally {
detailLoading.value = false
}
}
function selectedOriginWarehouse() {
return originWarehouses.value.find((item) => String(item.id) === form.originWarehouseId)
}
function selectedCarrier() {
return activeCarriers.value.find((item) => String(item.id) === form.carrierId)
}
function buildPayload(): CreatePlatformCarrierRateVersionRequest | null {
const warehouse = selectedOriginWarehouse()
const carrier = selectedCarrier()
if (!warehouse || !carrier || form.unitPrice == null || form.additionalFee == null) return null
return {
rateCode: form.rateCode.trim(),
originWarehouseId: String(warehouse.id),
originWarehouseName: warehouse.warehouseName,
businessType: form.businessType.trim(),
channelCode: form.channelCode.trim(),
carrierId: String(carrier.id),
carrierName: carrier.partnerName,
destinationCode: form.destinationCode.trim().toUpperCase(),
chargeUnit: form.chargeUnit,
unitPrice: form.unitPrice,
currency: form.currency.trim().toUpperCase(),
additionalFee: form.additionalFee,
effectiveFrom: form.effectiveFrom,
effectiveTo: nullable(form.effectiveTo),
remark: nullable(form.remark),
}
}
async function saveVersion() {
const customerId = editorCustomerId.value
if (!customerId) return
const valid = await formRef.value?.validate().catch(() => false)
if (!valid) return
const payload = buildPayload()
if (!payload) {
ElMessage.error('起运仓或船司主数据已变化,请重新选择')
return
}
saving.value = true
try {
await createPlatformCarrierRateVersion(customerId, payload)
editorOpen.value = false
ElMessage.success('船司 FBA 价格新版本已创建')
await loadRateData(filters.value.customerId)
} catch (error) {
const meta = getApiErrorDetails(error, '价格版本创建失败,请检查有效期和匹配维度后重试')
ElMessage.error(meta.requestId ? `${meta.message}(requestId: ${meta.requestId})` : meta.message)
} finally {
saving.value = false
}
}
async function retireRate(row: PlatformCarrierRateResource) {
try {
await ElMessageBox.confirm(
`停用“${row.rateCode} V${row.rateVersion}”后,新费用试算不会再匹配该版本,历史费用快照不受影响。`,
'停用价格版本',
{ type: 'warning', confirmButtonText: '确认停用', cancelButtonText: '取消' },
)
retiringIds.value = new Set(retiringIds.value).add(row.id)
await retirePlatformCarrierRate(String(row.tenantId), row.id)
ElMessage.success('价格版本已停用')
await loadRateData(filters.value.customerId)
} catch (error) {
if (error === 'cancel' || error === 'close') return
const meta = getApiErrorDetails(error, '价格版本停用失败,请重试')
ElMessage.error(meta.requestId ? `${meta.message}(requestId: ${meta.requestId})` : meta.message)
} finally {
const next = new Set(retiringIds.value)
next.delete(row.id)
retiringIds.value = next
}
}
function closeEditor() {
if (saving.value) return
editorOpen.value = false
}
onMounted(() => {
void loadCustomers()
void loadRateData()
})
</script>
<template>
<div class="business-page">
<QueryToolbar
v-model="filters"
ariaLabel="船司 FBA 价格筛选"
:fields="queryFields"
@search="applyQuery"
@reset="resetQuery"
/>
<el-alert v-if="customerLoadError" type="warning" :closable="false" show-icon role="alert">
<template #title><div class="api-error-alert-title"><span>{{ customerLoadError.message }}</span><ApiErrorMeta :details="customerLoadError" /></div></template>
<el-button link type="warning" @click="loadCustomers">重新加载企业列表</el-button>
</el-alert>
<LoadErrorState
v-if="loadError"
title="船司 FBA 价格加载失败"
:message="loadErrorMessage"
:loading="loading"
@retry="loadRateData()"
>
<template #details><ApiErrorMeta :details="loadError" /></template>
</LoadErrorState>
<section class="surface-panel table-panel" aria-live="polite">
<div class="panel-heading">
<div>
<h2>价格版本</h2>
<p>共 {{ rows.length }} 个版本 · {{ activeCount }} 个生效中</p>
</div>
<el-button
v-if="access.can('firstleg:fba-pricing:rate:edit')"
type="primary"
:disabled="!filters.customerId || masterDataLoading"
@click="openCreate()"
><Plus :size="16" />新增价格版本</el-button>
</div>
<DataTable
v-model:page="page"
v-model:page-size="pageSize"
:data="pagedRows"
:columns="columns"
:loading="loading"
:total="filteredRows.length"
:page-sizes="[10, 20, 50]"
row-key="id"
aria-label="船司 FBA 价格版本列表"
empty-text="暂无符合条件的价格版本"
>
<template #actions="{ row }">
<div class="table-actions">
<el-button link type="primary" @click="openDetail(row as PlatformCarrierRateResource)"><Eye :size="15" />详情</el-button>
<el-button
v-if="access.can('firstleg:fba-pricing:rate:edit')"
link
type="primary"
@click="openCreate(row as PlatformCarrierRateResource)"
><Plus :size="15" />新版本</el-button>
<el-button
v-if="access.can('firstleg:fba-pricing:rate:edit') && (row as PlatformCarrierRateResource).status === 'ACTIVE'"
link
type="danger"
:loading="retiringIds.has((row as PlatformCarrierRateResource).id)"
@click="retireRate(row as PlatformCarrierRateResource)"
><Power :size="15" />停用</el-button>
</div>
</template>
<template #customer="{ row }"><strong>{{ customerLabel(String((row as PlatformCarrierRateResource).tenantId)) }}</strong></template>
<template #rate="{ row }">
<div class="primary-cell"><strong>{{ (row as PlatformCarrierRateResource).rateCode }}</strong><span>版本 V{{ (row as PlatformCarrierRateResource).rateVersion }}</span></div>
</template>
<template #carrier="{ row }"><div class="primary-cell"><strong>{{ (row as PlatformCarrierRateResource).carrierName }}</strong><span>ID {{ (row as PlatformCarrierRateResource).carrierId }}</span></div></template>
<template #unitPrice="{ row }"><strong>{{ formatMoney((row as PlatformCarrierRateResource).unitPrice, (row as PlatformCarrierRateResource).currency) }}</strong></template>
<template #additionalFee="{ row }">{{ formatMoney((row as PlatformCarrierRateResource).additionalFee, (row as PlatformCarrierRateResource).currency) }}</template>
<template #period="{ row }"><div class="primary-cell"><strong>{{ formatDateTime((row as PlatformCarrierRateResource).effectiveFrom) }}</strong><span>至 {{ formatDateTime((row as PlatformCarrierRateResource).effectiveTo) }}</span></div></template>
<template #status="{ row }"><StatusBadge :status="statusLabel((row as PlatformCarrierRateResource).status)" /></template>
<template #empty><el-empty description="暂无符合条件的价格版本" /></template>
</DataTable>
</section>
<AppDrawer
v-model="editorOpen"
:title="editorLabel"
size="min(760px, 96vw)"
:confirm-loading="saving"
confirm-text="创建版本"
@confirm="saveVersion"
@cancel="closeEditor"
>
<el-alert type="info" :closable="false" show-icon class="version-note">
价格版本创建后不可原地修改。相同匹配维度的生效时间不得重叠;需要变价时,请创建新版本并停用旧版本。
</el-alert>
<el-form ref="formRef" :model="form" :rules="rules" label-position="top" class="drawer-form" :disabled="saving">
<section class="form-section">
<h3>版本与运输匹配</h3>
<div class="form-grid two-cols">
<el-form-item label="价格编码" prop="rateCode"><el-input v-model="form.rateCode" maxlength="50" placeholder="例如 FBA-US-WEST" /></el-form-item>
<el-form-item label="起运仓" prop="originWarehouseId">
<el-select v-model="form.originWarehouseId" filterable placeholder="请选择启用的国内收货仓" :loading="masterDataLoading">
<el-option v-for="warehouse in originWarehouses" :key="String(warehouse.id)" :label="`${warehouse.warehouseName}(${warehouse.warehouseCode})`" :value="String(warehouse.id)" />
</el-select>
</el-form-item>
<el-form-item label="业务类型" prop="businessType"><el-input v-model="form.businessType" maxlength="32" placeholder="请输入后端使用的业务类型" /></el-form-item>
<el-form-item label="渠道编码" prop="channelCode"><el-input v-model="form.channelCode" maxlength="64" placeholder="请输入渠道编码" /></el-form-item>
<el-form-item label="船司" prop="carrierId">
<el-select v-model="form.carrierId" filterable placeholder="请选择启用的承运商" :loading="masterDataLoading">
<el-option v-for="carrier in activeCarriers" :key="String(carrier.id)" :label="`${carrier.partnerName}(${carrier.partnerCode})`" :value="String(carrier.id)" />
</el-select>
</el-form-item>
<el-form-item label="FBA 目的仓" prop="destinationCode">
<el-select v-model="form.destinationCode" filterable allow-create default-first-option placeholder="选择或输入 FBA 仓编码">
<el-option v-for="warehouse in fbaWarehouses" :key="String(warehouse.id)" :label="`${warehouse.warehouseName}(${warehouse.warehouseCode})`" :value="warehouse.warehouseCode" />
</el-select>
</el-form-item>
</div>
</section>
<section class="form-section">
<h3>计费口径</h3>
<div class="form-grid two-cols">
<el-form-item label="计费单位" prop="chargeUnit"><el-segmented v-model="form.chargeUnit" :options="['KG', 'CBM']" /></el-form-item>
<el-form-item label="单价" prop="unitPrice"><el-input-number v-model="form.unitPrice" :min="0" :precision="4" :step="0.01" controls-position="right" /></el-form-item>
<el-form-item label="币种" prop="currency"><el-input v-model="form.currency" maxlength="3" placeholder="CNY" @input="form.currency = String($event).toUpperCase()" /></el-form-item>
<el-form-item label="固定附加费" prop="additionalFee"><el-input-number v-model="form.additionalFee" :min="0" :precision="2" :step="1" controls-position="right" /></el-form-item>
</div>
</section>
<section class="form-section">
<h3>有效期</h3>
<div class="form-grid two-cols">
<el-form-item label="生效时间" prop="effectiveFrom"><el-date-picker v-model="form.effectiveFrom" type="datetime" value-format="YYYY-MM-DDTHH:mm:ss" placeholder="选择生效时间" /></el-form-item>
<el-form-item label="结束时间" prop="effectiveTo"><el-date-picker v-model="form.effectiveTo" type="datetime" value-format="YYYY-MM-DDTHH:mm:ss" placeholder="留空表示长期有效" /></el-form-item>
</div>
<el-form-item label="备注"><el-input v-model="form.remark" type="textarea" :rows="3" maxlength="500" show-word-limit placeholder="记录版本适用说明或变更原因" /></el-form-item>
</section>
</el-form>
</AppDrawer>
<AppDrawer v-model="detailOpen" title="船司 FBA 价格详情" size="min(680px, 96vw)" :loading="detailLoading" :show-footer="false">
<div v-if="detail" class="detail-content">
<header class="detail-heading">
<div><strong>{{ detail.rateCode }}</strong><span>版本 V{{ detail.rateVersion }}</span></div>
<StatusBadge :status="statusLabel(detail.status)" />
</header>
<section class="detail-section"><h3><Warehouse :size="17" />运输匹配</h3><dl class="detail-grid"><div><dt>所属企业</dt><dd>{{ customerLabel(detail.tenantId) }}</dd></div><div><dt>起运仓</dt><dd>{{ detail.originWarehouseName }}</dd></div><div><dt>FBA 目的仓</dt><dd>{{ detail.destinationCode }}</dd></div><div><dt>业务类型</dt><dd>{{ detail.businessType }}</dd></div><div><dt>渠道编码</dt><dd>{{ detail.channelCode }}</dd></div><div><dt>船司</dt><dd>{{ detail.carrierName }}</dd></div><div><dt>船司 ID</dt><dd>{{ detail.carrierId }}</dd></div></dl></section>
<section class="detail-section"><h3><Ship :size="17" />计费口径</h3><dl class="detail-grid"><div><dt>计费单位</dt><dd>{{ detail.chargeUnit }}</dd></div><div><dt>币种</dt><dd>{{ detail.currency }}</dd></div><div><dt>单价</dt><dd>{{ formatMoney(detail.unitPrice, detail.currency) }}</dd></div><div><dt>固定附加费</dt><dd>{{ formatMoney(detail.additionalFee, detail.currency) }}</dd></div></dl></section>
<section class="detail-section"><h3><CalendarClock :size="17" />版本有效期</h3><dl class="detail-grid"><div><dt>生效时间</dt><dd>{{ formatDateTime(detail.effectiveFrom) }}</dd></div><div><dt>结束时间</dt><dd>{{ formatDateTime(detail.effectiveTo) }}</dd></div><div><dt>更新时间</dt><dd>{{ formatDateTime(detail.updatedAt) }}</dd></div><div><dt>记录版本</dt><dd>{{ detail.version ?? '-' }}</dd></div></dl><p v-if="detail.remark" class="detail-remark">{{ detail.remark }}</p></section>
</div>
</AppDrawer>
</div>
</template>
<style scoped>
.version-note { margin-bottom: 18px; }
.form-grid :deep(.el-select), .form-grid :deep(.el-date-editor), .form-grid :deep(.el-input-number), .form-grid :deep(.el-segmented) { width: 100%; }
.detail-content { display: grid; gap: 18px; }
.detail-heading { display: flex; align-items: flex-start; justify-content: space-between; gap: 16px; padding-bottom: 16px; border-bottom: 1px solid var(--el-border-color-lighter); }
.detail-heading > div { display: flex; min-width: 0; flex-direction: column; gap: 4px; }
.detail-heading strong { font-size: 18px; overflow-wrap: anywhere; }
.detail-heading span { color: var(--cc-muted); font-size: 12px; }
.detail-section { padding: 2px 0 8px; }
.detail-section h3 { display: flex; align-items: center; gap: 8px; margin: 0 0 14px; font-size: 14px; }
.detail-section h3 svg { color: var(--cc-primary); }
.detail-grid { display: grid; grid-template-columns: repeat(2, minmax(0, 1fr)); gap: 14px 24px; margin: 0; }
.detail-grid div { min-width: 0; }
.detail-grid dt { margin-bottom: 5px; color: var(--cc-muted); font-size: 12px; }
.detail-grid dd { margin: 0; font-size: 13px; line-height: 1.55; overflow-wrap: anywhere; }
.detail-remark { margin: 16px 0 0; padding: 12px 14px; border-radius: 10px; background: var(--el-fill-color-light); color: var(--el-text-color-regular); font-size: 13px; line-height: 1.65; white-space: pre-wrap; }
@media (max-width: 720px) {
.panel-heading .el-button { width: 100%; min-height: 44px; }
.detail-grid { grid-template-columns: 1fr; gap: 12px; }
}
</style>
@@ -0,0 +1,86 @@
import { readFileSync } from 'node:fs'
import { describe, expect, it } from 'vitest'
const source = readFileSync('src/modules/fba-pricing/customer-rules/CustomerRulesView.vue', 'utf8')
const queryToolbarSource = readFileSync('src/shared/components/QueryToolbar.vue', 'utf8')
describe('CustomerRulesView', () => {
it('keeps the operation column first and exposes version-only actions', () => {
const table = source.indexOf('const columns')
const operation = source.indexOf("label: '操作'", table)
const ruleCode = source.indexOf("label: '规则版本'", table)
expect(operation).toBeGreaterThan(0)
expect(operation).toBeLessThan(ruleCode)
expect(source).toContain('新建版本')
expect(source).toContain('停用规则')
expect(source).not.toContain('编辑规则')
})
it('covers customer scope, permission, unsaved work, error and responsive states', () => {
expect(source).not.toContain('PlatformTenantSelector')
expect(source).toContain("key: 'customerId'")
expect(source).toContain("'aria-label': '所属企业'")
expect(source).toContain('listPlatformTenants')
expect(source).toContain("firstleg:fba-pricing:rule:edit")
expect(source).toContain('useUnsavedWorkRegistration')
expect(source).toContain('LoadErrorState')
expect(source).toContain('detailError')
expect(source).toContain('@retry="retryDetail"')
expect(source).not.toContain('请选择客户')
expect(source).not.toContain('请选择所属企业')
expect(source).not.toContain('当前接口要求选择客户')
expect(source).not.toContain('租户')
expect(source).toContain('@media (max-width: 480px)')
})
it('uses compact semantic filter widths and keeps the customer filter empty by default', () => {
expect(source).toContain("customerId: '', ruleCode: '', customerName: '', chargeMode: '', status: ''")
expect(source).toContain("width: 280,\n placeholder: customerLoadError.value ? '客户列表加载失败' : '全部客户'")
expect(source).toContain("key: 'ruleCode', type: 'input', width: 220")
expect(source).toContain("key: 'customerName', type: 'input', width: 260")
expect(source).toContain("key: 'chargeMode', type: 'select', width: 180")
expect(source).toContain("key: 'status', type: 'select', width: 160")
expect(source).not.toContain('customers.value[0]')
})
it('resets to all customers, uses full-width mobile fields and allows an empty customer filter', () => {
expect(queryToolbarSource).toContain("for (const field of props.fields) next[field.key] = resetValue(field)")
expect(queryToolbarSource).toContain("if (field.type === 'select') return '全部'")
expect(queryToolbarSource).toContain('@media (max-width: 720px)')
expect(queryToolbarSource).toContain('{ width: 100%; }')
expect(source).not.toContain('if (!selectedCustomerId.value)')
expect(source).toContain('...(selectedCustomerId.value ? { tenantId: selectedCustomerId.value } : {})')
expect(source).toContain('void loadRules()')
expect(source).toContain("const tableEmptyText = '暂无符合筛选条件的客户计费规则'")
})
it('uses each record scope for single-rule actions', () => {
expect(source).toContain('getCustomerPricingRule(row.tenantId, row.id)')
expect(source).toContain('editorScopeCustomerId.value = source?.tenantId || selectedCustomerId.value')
expect(source).toContain('disableCustomerPricingRule(row.tenantId, row.id)')
})
it('renders the complete pricing rule contract', () => {
for (const label of ['适用客户', '业务类型', '计费方式', '税务模式', '换算系数', '舍入规则', '币种', '有效期']) {
expect(source).toContain(label)
}
expect(source).toContain('QueryToolbar')
expect(source).toContain('DataTable')
expect(source).toContain('AppDrawer')
})
it('matches the backend status and field constraints', () => {
expect(source).toContain("{ label: '已停用', value: 'INACTIVE' }")
expect(source).not.toContain("value: 'DISABLED'")
expect(source).toContain('maxlength="50"')
})
it('uses the mature admin list skeleton and grouped detail sections', () => {
expect(source).toContain('class="business-page customer-rules-page"')
expect(source).toContain('class="surface-panel table-panel"')
expect(source).toContain('class="panel-heading"')
for (const heading of ['规则归属', '计费口径', '版本有效期']) {
expect(source).toContain(`<h3>${heading}</h3>`)
}
})
})
@@ -0,0 +1,496 @@
<script setup lang="ts">
import { computed, nextTick, onMounted, reactive, ref, watch } from 'vue'
import { CircleSlash2, Eye, Plus } from '@lucide/vue'
import { ElMessage, ElMessageBox, type FormInstance, type FormRules } from 'element-plus'
import { listPlatformTenants, type PlatformTenantResource as PlatformCustomerContract } from '@/modules/iam'
import { useAccessPreviewStore } from '@/core/access/accessPreview'
import { useUnsavedWorkRegistration } from '@/core/unsaved-work/useUnsavedWorkRegistration'
import { getApiErrorDetails, type ApiErrorDetails } from '@/shared/api/http'
import LoadErrorState from '@/shared/components/LoadErrorState.vue'
import AppDrawer from '@/shared/components/AppDrawer.vue'
import DataTable, { type DataTableColumn } from '@/shared/components/DataTable.vue'
import QueryToolbar, { type QueryField, type QueryModel } from '@/shared/components/QueryToolbar.vue'
import {
createCustomerPricingRuleVersion,
disableCustomerPricingRule,
getCustomerPricingRule,
listCustomerPricingRules,
} from './api'
import type { CustomerPricingRule, CustomerRuleFormModel } from './types'
const access = useAccessPreviewStore()
const canEdit = computed(() => access.can('firstleg:fba-pricing:rule:edit'))
const customers = ref<Array<{ id: string; name: string; code: string }>>([])
const customerLoadError = ref<ApiErrorDetails | null>(null)
const rules = ref<CustomerPricingRule[]>([])
const loading = ref(false)
const error = ref<ApiErrorDetails | null>(null)
const detailVisible = ref(false)
const detailLoading = ref(false)
const detailError = ref<ApiErrorDetails | null>(null)
const selectedRule = ref<CustomerPricingRule | null>(null)
const editorVisible = ref(false)
const editorSaving = ref(false)
const editorForm = ref<FormInstance>()
const editorDirty = ref(false)
const editorScopeCustomerId = ref('')
const page = ref(1)
const pageSize = ref(20)
type RuleFilters = QueryModel & {
customerId: string
ruleCode: string
customerName: string
chargeMode: '' | 'KG' | 'CBM'
status: string
}
const filters = ref<RuleFilters>({ customerId: '', ruleCode: '', customerName: '', chargeMode: '', status: '' })
const appliedFilters = ref<RuleFilters>({ ...filters.value })
const selectedCustomerId = computed(() => appliedFilters.value.customerId)
const queryFields = computed<QueryField[]>(() => [
{
key: 'customerId',
type: 'select',
width: 280,
placeholder: customerLoadError.value ? '客户列表加载失败' : '全部客户',
props: { 'aria-label': '所属企业', filterable: true, disabled: Boolean(customerLoadError.value) },
options: customers.value.map((customer) => ({
value: customer.id,
label: `${customer.name}(${customer.code || customer.id})`,
})),
},
{ key: 'ruleCode', type: 'input', width: 220, placeholder: '规则编码' },
{ key: 'customerName', type: 'input', width: 260, placeholder: '客户名称' },
{
key: 'chargeMode', type: 'select', width: 180, placeholder: '全部计费方式', options: [
{ label: '按 KG', value: 'KG' },
{ label: '按 CBM', value: 'CBM' },
],
},
{
key: 'status', type: 'select', width: 160, placeholder: '全部状态', options: [
{ label: '生效中', value: 'ACTIVE' },
{ label: '已停用', value: 'INACTIVE' },
],
},
])
const columns: DataTableColumn[] = [
{ key: 'actions', label: '操作', width: 210, fixed: 'left', slotName: 'actions' },
{ key: 'rule', label: '规则版本', minWidth: 170, slotName: 'rule', showOverflowTooltip: true },
{ key: 'customer', label: '适用客户', minWidth: 190, slotName: 'customer', showOverflowTooltip: true },
{ key: 'businessType', prop: 'businessType', label: '业务类型', minWidth: 110, showOverflowTooltip: true },
{ key: 'chargeMode', label: '计费方式', width: 105, slotName: 'chargeMode' },
{ key: 'taxMode', label: '税务模式', width: 100, slotName: 'taxMode' },
{ key: 'conversionFactor', prop: 'conversionFactor', label: '换算系数', width: 105 },
{ key: 'rounding', label: '舍入规则', minWidth: 155, slotName: 'rounding' },
{ key: 'currency', prop: 'currency', label: '币种', width: 80 },
{ key: 'period', label: '有效期', minWidth: 225, slotName: 'period' },
{ key: 'status', label: '状态', width: 90, slotName: 'status' },
]
const filteredRules = computed(() => rules.value.filter((rule) => {
const customerName = appliedFilters.value.customerName.trim().toLowerCase()
return (!customerName || rule.customerName.toLowerCase().includes(customerName))
&& (!appliedFilters.value.chargeMode || rule.chargeMode === appliedFilters.value.chargeMode)
&& (!appliedFilters.value.status || rule.status === appliedFilters.value.status)
}))
const pagedRules = computed(() => filteredRules.value.slice((page.value - 1) * pageSize.value, page.value * pageSize.value))
const tableEmptyText = '暂无符合筛选条件的客户计费规则'
const emptyForm = (): CustomerRuleFormModel => ({
ruleCode: '',
customerId: '',
customerName: '',
businessType: 'FBA',
chargeMode: 'KG',
taxMode: 'TAX_INCLUDED',
conversionFactor: 167,
roundingScale: 3,
roundingMode: 'CEILING',
currency: 'CNY',
effectiveFrom: '',
effectiveTo: null,
remark: null,
})
const form = reactive<CustomerRuleFormModel>(emptyForm())
const formRules: FormRules<CustomerRuleFormModel> = {
ruleCode: [{ required: true, message: '请输入规则编码', trigger: 'blur' }],
customerId: [{ required: true, message: '请输入客户 ID', trigger: 'blur' }],
customerName: [{ required: true, message: '请输入客户名称', trigger: 'blur' }],
businessType: [{ required: true, message: '请输入业务类型', trigger: 'blur' }],
chargeMode: [{ required: true, message: '请选择计费方式', trigger: 'change' }],
taxMode: [{ required: true, message: '请选择税务模式', trigger: 'change' }],
conversionFactor: [{ required: true, message: '请输入大于 0 的换算系数', trigger: 'blur', type: 'number', min: 0.000001 }],
roundingScale: [{ required: true, message: '请选择保留位数', trigger: 'change', type: 'number', min: 0, max: 4 }],
roundingMode: [{ required: true, message: '请选择舍入方式', trigger: 'change' }],
currency: [{ required: true, message: '请选择币种', trigger: 'change' }],
effectiveFrom: [{ required: true, message: '请选择生效时间', trigger: 'change' }],
}
useUnsavedWorkRegistration({
key: 'customer-pricing-rule-version',
label: computed(() => '客户计费规则版本'),
isOpen: computed(() => editorVisible.value),
model: form,
requiredPermission: computed(() => 'firstleg:fba-pricing:rule:edit'),
})
watch(form, () => {
if (editorVisible.value) editorDirty.value = true
}, { deep: true })
async function loadCustomers() {
customerLoadError.value = null
try {
const records: PlatformCustomerContract[] = []
let currentPage = 1
let pages = 1
do {
const result = await listPlatformTenants({ page: currentPage, size: 200 })
records.push(...result.records)
pages = Math.max(1, result.pages)
currentPage += 1
} while (currentPage <= pages)
customers.value = records.map((customer) => ({
id: String(customer.id),
name: customer.tenantName,
code: customer.tenantCode,
}))
} catch (cause) {
customers.value = []
customerLoadError.value = getApiErrorDetails(cause, '客户列表加载失败')
}
}
async function loadRules() {
loading.value = true
error.value = null
try {
rules.value = await listCustomerPricingRules({
...(selectedCustomerId.value ? { tenantId: selectedCustomerId.value } : {}),
ruleCode: appliedFilters.value.ruleCode.trim(),
})
} catch (cause) {
error.value = getApiErrorDetails(cause, '客户计费规则加载失败')
} finally {
loading.value = false
}
}
function applyQuery(model: QueryModel) {
const nextCustomerId = String(model.customerId || '')
if (nextCustomerId !== selectedCustomerId.value) {
rules.value = []
selectedRule.value = null
detailVisible.value = false
detailError.value = null
editorVisible.value = false
editorDirty.value = false
error.value = null
}
appliedFilters.value = {
customerId: nextCustomerId,
ruleCode: String(model.ruleCode || ''),
customerName: String(model.customerName || ''),
chargeMode: (model.chargeMode || '') as RuleFilters['chargeMode'],
status: String(model.status || ''),
}
page.value = 1
void loadRules()
}
async function openDetail(row: CustomerPricingRule) {
detailVisible.value = true
detailLoading.value = true
detailError.value = null
selectedRule.value = row
try {
selectedRule.value = await getCustomerPricingRule(row.tenantId, row.id)
} catch (cause) {
detailError.value = getApiErrorDetails(cause, '规则详情加载失败')
} finally {
detailLoading.value = false
}
}
function retryDetail() {
if (selectedRule.value) void openDetail(selectedRule.value)
}
function asRule(row: unknown): CustomerPricingRule {
return row as CustomerPricingRule
}
function resetForm(source?: CustomerPricingRule) {
Object.assign(form, emptyForm(), source ? {
ruleCode: source.ruleCode,
customerId: source.customerId,
customerName: source.customerName,
businessType: source.businessType,
chargeMode: source.chargeMode,
taxMode: source.taxMode,
conversionFactor: source.conversionFactor,
roundingScale: source.roundingScale,
roundingMode: source.roundingMode,
currency: source.currency,
effectiveTo: source.effectiveTo,
remark: source.remark,
} : { customerId: selectedCustomerId.value })
}
async function openEditor(source?: CustomerPricingRule) {
editorScopeCustomerId.value = source?.tenantId || selectedCustomerId.value
resetForm(source)
editorDirty.value = false
editorVisible.value = true
await nextTick()
editorForm.value?.clearValidate()
}
async function closeEditor() {
if (editorDirty.value) {
try {
await ElMessageBox.confirm('尚有未保存的规则版本,确定放弃吗?', '放弃编辑', {
confirmButtonText: '放弃', cancelButtonText: '继续编辑', type: 'warning',
})
} catch {
editorVisible.value = true
return
}
}
editorVisible.value = false
editorDirty.value = false
}
async function beforeEditorClose(done: () => void) {
if (editorSaving.value) return
if (!editorDirty.value) {
done()
return
}
try {
await ElMessageBox.confirm('尚有未保存的规则版本,确定放弃吗?', '放弃编辑', {
confirmButtonText: '放弃', cancelButtonText: '继续编辑', type: 'warning',
})
editorDirty.value = false
done()
} catch {
editorVisible.value = true
}
}
async function saveVersion() {
if (!await editorForm.value?.validate()) return
editorSaving.value = true
try {
await createCustomerPricingRuleVersion(editorScopeCustomerId.value, {
...form,
ruleCode: form.ruleCode.trim(),
customerId: String(form.customerId),
customerName: form.customerName.trim(),
businessType: form.businessType.trim(),
effectiveTo: form.effectiveTo || null,
remark: form.remark?.trim() || null,
})
editorDirty.value = false
editorVisible.value = false
ElMessage.success('客户计费规则新版本已创建')
await loadRules()
} catch (cause) {
ElMessage.error(getApiErrorDetails(cause, '规则版本创建失败').message)
} finally {
editorSaving.value = false
}
}
async function disableRule(row: CustomerPricingRule) {
try {
await ElMessageBox.confirm(`停用规则“${row.ruleCode}”的当前版本?历史费用不会改变。`, '停用规则', {
confirmButtonText: '确认停用', cancelButtonText: '取消', type: 'warning',
})
await disableCustomerPricingRule(row.tenantId, row.id)
ElMessage.success('规则已停用')
await loadRules()
} catch (cause) {
if (cause === 'cancel' || cause === 'close') return
ElMessage.error(getApiErrorDetails(cause, '规则停用失败').message)
}
}
function formatDate(value: string | null) {
if (!value) return '长期有效'
return value.replace('T', ' ').slice(0, 16)
}
function modeLabel(mode: string) {
return mode === 'KG' ? '按 KG' : mode === 'CBM' ? '按 CBM' : mode
}
function taxLabel(mode: string) {
return mode === 'TAX_INCLUDED' ? '包税' : mode === 'TAX_EXCLUDED' ? '不包税' : mode
}
onMounted(() => {
access.initializeAfterLogin()
void loadCustomers()
void loadRules()
})
</script>
<template>
<div class="business-page customer-rules-page">
<QueryToolbar v-model="filters" class="surface-panel" ariaLabel="客户计费规则筛选" :fields="queryFields" @search="applyQuery" />
<LoadErrorState v-if="customerLoadError" title="客户列表加载失败" :message="customerLoadError.message" compact @retry="loadCustomers" />
<LoadErrorState v-if="error" title="客户计费规则加载失败" :message="error.message" @retry="loadRules" />
<section v-else class="surface-panel table-panel" aria-live="polite" :aria-busy="loading">
<div class="panel-heading">
<div>
<h2>客户计费规则</h2>
<p>按企业维护 FBA 的 KG / CBM 计费版本 · 共 {{ filteredRules.length }} 个规则版本</p>
</div>
<el-button v-if="canEdit" type="primary" :disabled="loading || !selectedCustomerId" @click="openEditor()">
<Plus :size="16" aria-hidden="true" />新建版本
</el-button>
</div>
<DataTable
v-model:page="page"
v-model:page-size="pageSize"
:data="pagedRules"
:columns="columns"
:loading="loading"
:total="filteredRules.length"
:page-sizes="[10, 20, 50]"
row-key="id"
:empty-text="tableEmptyText"
>
<template #actions="{ row }">
<div class="row-actions">
<el-button link type="primary" @click="openDetail(asRule(row))"><Eye :size="15" aria-hidden="true" />详情</el-button>
<el-button v-if="canEdit" link type="primary" @click="openEditor(asRule(row))"><Plus :size="15" aria-hidden="true" />新版本</el-button>
<el-button v-if="canEdit && row.status === 'ACTIVE'" link type="danger" @click="disableRule(asRule(row))"><CircleSlash2 :size="15" aria-hidden="true" />停用</el-button>
</div>
</template>
<template #rule="{ row }"><div class="primary-cell"><strong>{{ row.ruleCode }}</strong><small>版本 V{{ row.ruleVersion ?? '—' }}</small></div></template>
<template #customer="{ row }"><strong>{{ row.customerName }}</strong><small class="subline">ID {{ row.customerId }}</small></template>
<template #chargeMode="{ row }"><el-tag effect="plain">{{ modeLabel(row.chargeMode) }}</el-tag></template>
<template #taxMode="{ row }">{{ taxLabel(row.taxMode) }}</template>
<template #rounding="{ row }">保留 {{ row.roundingScale }} 位 · {{ row.roundingMode }}</template>
<template #period="{ row }"><span>{{ formatDate(row.effectiveFrom) }}</span><small class="subline">至 {{ formatDate(row.effectiveTo) }}</small></template>
<template #status="{ row }"><el-tag :type="row.status === 'ACTIVE' ? 'success' : 'info'" effect="light">{{ row.status === 'ACTIVE' ? '生效中' : '已停用' }}</el-tag></template>
<template #pagination-left>共 {{ filteredRules.length }} 个规则版本</template>
</DataTable>
</section>
<AppDrawer v-model="detailVisible" title="客户计费规则详情" size="min(600px, 94vw)" :loading="detailLoading" :show-footer="false">
<LoadErrorState v-if="detailError" title="规则详情加载失败" :message="detailError.message" compact @retry="retryDetail" />
<div v-else-if="selectedRule" class="rule-detail">
<section>
<h3>规则归属</h3>
<dl class="detail-grid">
<div><dt>规则编码</dt><dd>{{ selectedRule.ruleCode }}</dd></div>
<div><dt>规则版本</dt><dd>V{{ selectedRule.ruleVersion ?? '—' }}</dd></div>
<div><dt>适用客户</dt><dd>{{ selectedRule.customerName }}</dd></div>
<div><dt>客户 ID</dt><dd>{{ selectedRule.customerId }}</dd></div>
<div><dt>业务类型</dt><dd>{{ selectedRule.businessType }}</dd></div>
<div><dt>状态</dt><dd><el-tag :type="selectedRule.status === 'ACTIVE' ? 'success' : 'info'">{{ selectedRule.status === 'ACTIVE' ? '生效中' : '已停用' }}</el-tag></dd></div>
</dl>
</section>
<section>
<h3>计费口径</h3>
<dl class="detail-grid">
<div><dt>计费方式</dt><dd>{{ modeLabel(selectedRule.chargeMode) }}</dd></div>
<div><dt>税务模式</dt><dd>{{ taxLabel(selectedRule.taxMode) }}</dd></div>
<div><dt>换算系数</dt><dd>{{ selectedRule.conversionFactor }}</dd></div>
<div><dt>舍入规则</dt><dd>保留 {{ selectedRule.roundingScale }} 位,{{ selectedRule.roundingMode }}</dd></div>
<div><dt>币种</dt><dd>{{ selectedRule.currency }}</dd></div>
</dl>
</section>
<section>
<h3>版本有效期</h3>
<dl class="detail-grid">
<div><dt>生效时间</dt><dd>{{ formatDate(selectedRule.effectiveFrom) }}</dd></div>
<div><dt>失效时间</dt><dd>{{ formatDate(selectedRule.effectiveTo) }}</dd></div>
<div class="detail-wide"><dt>备注</dt><dd>{{ selectedRule.remark || '—' }}</dd></div>
</dl>
</section>
</div>
</AppDrawer>
<AppDrawer
v-model="editorVisible"
title="创建客户计费规则版本"
size="min(760px, 94vw)"
:confirm-loading="editorSaving"
confirm-text="创建版本"
:before-close="beforeEditorClose"
@confirm="saveVersion"
@cancel="closeEditor"
>
<el-form ref="editorForm" :model="form" :rules="formRules" label-position="top" class="rule-form">
<div class="form-section">
<h2>规则归属</h2>
<div class="form-grid">
<el-form-item label="规则编码" prop="ruleCode"><el-input v-model="form.ruleCode" maxlength="50" placeholder="例如 FBA-TAX-KG" /></el-form-item>
<el-form-item label="客户 ID" prop="customerId"><el-input v-model="form.customerId" /></el-form-item>
<el-form-item label="客户名称" prop="customerName"><el-input v-model="form.customerName" maxlength="128" /></el-form-item>
<el-form-item label="业务类型" prop="businessType"><el-input v-model="form.businessType" maxlength="32" /></el-form-item>
</div>
</div>
<div class="form-section">
<h2>计费口径</h2>
<div class="form-grid">
<el-form-item label="计费方式" prop="chargeMode"><el-segmented v-model="form.chargeMode" :options="[{ label: '按 KG', value: 'KG' }, { label: '按 CBM', value: 'CBM' }]" /></el-form-item>
<el-form-item label="税务模式" prop="taxMode"><el-select v-model="form.taxMode"><el-option label="包税" value="TAX_INCLUDED" /><el-option label="不包税" value="TAX_EXCLUDED" /></el-select></el-form-item>
<el-form-item label="换算系数" prop="conversionFactor"><el-input-number v-model="form.conversionFactor" :min="0.000001" :precision="6" :controls="false" /></el-form-item>
<el-form-item label="保留小数位" prop="roundingScale"><el-select v-model="form.roundingScale"><el-option v-for="scale in [0, 1, 2, 3, 4]" :key="scale" :label="`${scale} 位`" :value="scale" /></el-select></el-form-item>
<el-form-item label="舍入方式" prop="roundingMode"><el-select v-model="form.roundingMode"><el-option label="向上取整 CEILING" value="CEILING" /><el-option label="向上舍入 UP" value="UP" /><el-option label="向下舍入 DOWN" value="DOWN" /><el-option label="向下取整 FLOOR" value="FLOOR" /><el-option label="四舍五入 HALF_UP" value="HALF_UP" /><el-option label="五舍六入 HALF_DOWN" value="HALF_DOWN" /><el-option label="银行家舍入 HALF_EVEN" value="HALF_EVEN" /></el-select></el-form-item>
<el-form-item label="币种" prop="currency"><el-select v-model="form.currency" filterable allow-create default-first-option><el-option label="人民币 CNY" value="CNY" /><el-option label="美元 USD" value="USD" /></el-select></el-form-item>
</div>
</div>
<div class="form-section">
<h2>生效范围</h2>
<div class="form-grid">
<el-form-item label="生效时间" prop="effectiveFrom"><el-date-picker v-model="form.effectiveFrom" type="datetime" value-format="YYYY-MM-DDTHH:mm:ss" placeholder="选择生效时间" /></el-form-item>
<el-form-item label="失效时间"><el-date-picker v-model="form.effectiveTo" type="datetime" value-format="YYYY-MM-DDTHH:mm:ss" placeholder="不填表示长期有效" /></el-form-item>
<el-form-item label="备注" class="wide"><el-input v-model="form.remark" type="textarea" :rows="3" maxlength="500" show-word-limit /></el-form-item>
</div>
</div>
</el-form>
</AppDrawer>
</div>
</template>
<style scoped>
.customer-rules-page { min-width: 0; }
.row-actions .el-button { display: inline-flex; align-items: center; gap: 6px; }
.row-actions { display: flex; align-items: center; gap: 3px; white-space: nowrap; }
.primary-cell { display: flex; flex-direction: column; gap: 3px; }
.primary-cell small, .subline { display: block; margin-top: 3px; color: var(--cc-muted); font-size: 11px; line-height: 1.45; }
.rule-detail { display: grid; gap: 24px; }
.rule-detail section + section { padding-top: 22px; border-top: 1px solid var(--cc-border); }
.rule-detail h3 { margin: 0 0 14px; color: var(--cc-text); font-size: 15px; }
.detail-grid { display: grid; grid-template-columns: repeat(2, minmax(0, 1fr)); gap: 16px 24px; margin: 0; }
.detail-grid > div { min-width: 0; }
.detail-grid dt { margin-bottom: 5px; color: var(--cc-muted); font-size: 12px; }
.detail-grid dd { margin: 0; color: var(--cc-text); line-height: 1.55; overflow-wrap: anywhere; }
.detail-wide { grid-column: 1 / -1; }
.rule-form { display: grid; gap: 24px; }
.form-section { display: grid; gap: 14px; }
.form-section + .form-section { padding-top: 22px; border-top: 1px solid var(--cc-border); }
.form-section h2 { margin: 0; color: var(--cc-text); font-size: 16px; line-height: 1.4; }
.form-grid { display: grid; grid-template-columns: repeat(2, minmax(0, 1fr)); gap: 2px 20px; }
.wide { grid-column: 1 / -1; }
.form-grid :deep(.el-select), .form-grid :deep(.el-input-number), .form-grid :deep(.el-date-editor) { width: 100%; }
@media (max-width: 760px) {
.form-grid { grid-template-columns: 1fr; }
.wide { grid-column: auto; }
}
@media (max-width: 480px) {
.detail-grid { grid-template-columns: 1fr; }
.detail-wide { grid-column: auto; }
}
</style>
@@ -0,0 +1,82 @@
import { beforeEach, describe, expect, it, vi } from 'vitest'
const http = vi.hoisted(() => ({
get: vi.fn(),
post: vi.fn(),
delete: vi.fn(),
}))
vi.mock('@/shared/api/http', () => ({
http,
unwrapApiResponse: <T>(response: { data: T }) => response.data,
}))
import {
createCustomerPricingRuleVersion,
disableCustomerPricingRule,
getCustomerPricingRule,
listCustomerPricingRules,
} from './api'
const rawRule = {
id: 9007199254740993n.toString(),
tenantId: 10001,
ruleCode: 'FBA-TAX-KG',
customerId: 20002,
customerName: '测试企业',
businessType: 'FBA',
chargeMode: 'KG',
taxMode: 'TAX_INCLUDED',
conversionFactor: 167,
roundingScale: 3,
roundingMode: 'CEILING',
currency: 'CNY',
effectiveFrom: '2026-08-04T00:00:00',
effectiveTo: null,
ruleVersion: 1,
status: 'ACTIVE',
remark: null,
createdAt: null,
updatedAt: null,
}
describe('customer pricing rules api', () => {
beforeEach(() => vi.clearAllMocks())
it('omits an empty customer scope and rule code for the all-customer list', async () => {
http.get.mockResolvedValue({ data: [rawRule] })
await listCustomerPricingRules({ tenantId: ' ', ruleCode: ' ' })
expect(http.get).toHaveBeenCalledWith('/platform/v1/fba-pricing/customer-rules', { params: {} })
})
it('keeps every long id as a string and sends the real list query', async () => {
http.get.mockResolvedValue({ data: [rawRule] })
const result = await listCustomerPricingRules({ tenantId: '10001', ruleCode: ' FBA ' })
expect(http.get).toHaveBeenCalledWith('/platform/v1/fba-pricing/customer-rules', {
params: { tenantId: '10001', ruleCode: 'FBA' },
})
expect(result[0]).toMatchObject({ id: '9007199254740993', tenantId: '10001', customerId: '20002' })
})
it('uses detail, version creation and disable endpoints from the controller', async () => {
http.get.mockResolvedValue({ data: rawRule })
http.post.mockResolvedValue({ data: rawRule })
http.delete.mockResolvedValue({ data: null })
await getCustomerPricingRule('10001', '9')
await createCustomerPricingRuleVersion('10001', {
ruleCode: 'FBA-TAX-KG', customerId: '20002', customerName: '测试企业', businessType: 'FBA',
chargeMode: 'KG', taxMode: 'TAX_INCLUDED', conversionFactor: 167, roundingScale: 3,
roundingMode: 'CEILING', currency: 'CNY', effectiveFrom: '2026-08-04T00:00:00',
})
await disableCustomerPricingRule('10001', '9')
expect(http.get).toHaveBeenCalledWith('/platform/v1/fba-pricing/customer-rules/9', { params: { tenantId: '10001' } })
expect(http.post).toHaveBeenCalledWith('/platform/v1/fba-pricing/customer-rules/versions', expect.any(Object), { params: { tenantId: '10001' } })
expect(http.delete).toHaveBeenCalledWith('/platform/v1/fba-pricing/customer-rules/9', { params: { tenantId: '10001' } })
})
})
@@ -0,0 +1,59 @@
import { http, unwrapApiResponse, type ApiEnvelope } from '@/shared/api/http'
import type {
CreateCustomerRuleVersionRequest,
CustomerPricingRule,
CustomerRuleQuery,
} from './types'
type RawRule = Omit<CustomerPricingRule, 'id' | 'tenantId' | 'customerId'> & {
id: string | number
tenantId: string | number
customerId: string | number
}
function normalizeRule(rule: RawRule): CustomerPricingRule {
return {
...rule,
id: String(rule.id),
tenantId: String(rule.tenantId),
customerId: String(rule.customerId),
}
}
export async function listCustomerPricingRules(query: CustomerRuleQuery): Promise<CustomerPricingRule[]> {
const tenantId = query.tenantId?.trim()
const ruleCode = query.ruleCode?.trim()
const response = await http.get<never, ApiEnvelope<RawRule[]>>('/platform/v1/fba-pricing/customer-rules', {
params: {
...(tenantId ? { tenantId } : {}),
...(ruleCode ? { ruleCode } : {}),
},
})
return unwrapApiResponse(response).map(normalizeRule)
}
export async function getCustomerPricingRule(tenantId: string, id: string): Promise<CustomerPricingRule> {
const response = await http.get<never, ApiEnvelope<RawRule>>(`/platform/v1/fba-pricing/customer-rules/${id}`, {
params: { tenantId },
})
return normalizeRule(unwrapApiResponse(response))
}
export async function createCustomerPricingRuleVersion(
tenantId: string,
request: CreateCustomerRuleVersionRequest,
): Promise<CustomerPricingRule> {
const response = await http.post<never, ApiEnvelope<RawRule>>(
'/platform/v1/fba-pricing/customer-rules/versions',
request,
{ params: { tenantId } },
)
return normalizeRule(unwrapApiResponse(response))
}
export async function disableCustomerPricingRule(tenantId: string, id: string): Promise<void> {
const response = await http.delete<never, ApiEnvelope<unknown>>(`/platform/v1/fba-pricing/customer-rules/${id}`, {
params: { tenantId },
})
unwrapApiResponse(response)
}
@@ -0,0 +1,49 @@
export type CustomerRuleChargeMode = 'KG' | 'CBM'
export type CustomerRuleStatus = 'ACTIVE' | 'INACTIVE' | string
export interface CustomerPricingRule {
id: string
tenantId: string
ruleCode: string
customerId: string
customerName: string
businessType: string
chargeMode: CustomerRuleChargeMode
taxMode: string
conversionFactor: number
roundingScale: number
roundingMode: string
currency: string
effectiveFrom: string
effectiveTo: string | null
ruleVersion: number | null
status: CustomerRuleStatus
remark: string | null
createdAt: string | null
updatedAt: string | null
}
export interface CustomerRuleQuery {
tenantId?: string
ruleCode?: string
}
export interface CreateCustomerRuleVersionRequest {
ruleCode: string
customerId: string
customerName: string
businessType: string
chargeMode: CustomerRuleChargeMode
taxMode: string
conversionFactor: number
roundingScale: number
roundingMode: string
currency: string
effectiveFrom: string
effectiveTo?: string | null
remark?: string | null
}
export interface CustomerRuleFormModel extends CreateCustomerRuleVersionRequest {
customerId: string
}
+24
View File
@@ -0,0 +1,24 @@
import type { RouteRecordRaw } from 'vue-router'
export const fbaPricingRoutes = [
{
path: 'first-leg-pricing/customer-rules',
name: 'fba-customer-rules',
component: () => import('./customer-rules/CustomerRulesView.vue'),
meta: {
title: '客户计费规则',
description: '维护 FBA 客户计费规则和生效版本',
permission: 'firstleg:fba-pricing:rule:view',
},
},
{
path: 'first-leg-pricing/carrier-rates',
name: 'fba-carrier-rates',
component: () => import('./carrier-rates/pages/CarrierRatesView.vue'),
meta: {
title: '船司 FBA 价格',
description: '维护起运仓、船司和 FBA 目的仓价格版本',
permission: 'firstleg:fba-pricing:rate:view',
},
},
] satisfies RouteRecordRaw[]