281 lines
15 KiB
TypeScript
281 lines
15 KiB
TypeScript
import { beforeEach, describe, expect, it, vi } from 'vitest'
|
|
import { flushPromises, mount } from '@vue/test-utils'
|
|
import ElementPlus, { ElMessageBox } from 'element-plus'
|
|
import AppDialog from '@/shared/components/AppDialog.vue'
|
|
import { ApiResponseError } from '@/shared/api/http'
|
|
import type { ContainerCustomsStatus, ContainerCustomsView, DeclarationBatch, ClearanceResultType } from '../api/platformContainerCustoms'
|
|
|
|
const api = vi.hoisted(() => ({
|
|
get: vi.fn(),
|
|
start: vi.fn(),
|
|
completeAllBuy: vi.fn(),
|
|
sendToBroker: vi.fn(),
|
|
getDeclarationBatches: vi.fn(),
|
|
upload: vi.fn(),
|
|
downloadSource: vi.fn(),
|
|
downloadReceipt: vi.fn(),
|
|
downloadFinal: vi.fn(),
|
|
recordResult: vi.fn(),
|
|
}))
|
|
|
|
vi.mock('../api/platformContainerCustoms', () => ({
|
|
getContainerCustoms: api.get,
|
|
startContainerCustoms: api.start,
|
|
completeAllBuyContainerCustoms: api.completeAllBuy,
|
|
uploadContainerCustomsReceipt: api.upload,
|
|
downloadContainerCustomsDocument: api.downloadSource,
|
|
downloadContainerCustomsReceipt: api.downloadReceipt,
|
|
downloadContainerCustomsFinal: api.downloadFinal,
|
|
submitContainerCustomsToBroker: vi.fn(),
|
|
sendContainerCustomsToBroker: api.sendToBroker,
|
|
getDeclarationBatches: api.getDeclarationBatches,
|
|
recordClearanceResult: api.recordResult,
|
|
}))
|
|
vi.mock('@/modules/downloads', () => ({ createPlatformExportTask: vi.fn() }))
|
|
|
|
import ContainerCustomsPanel from './ContainerCustomsPanel.vue'
|
|
|
|
function customs(status: ContainerCustomsStatus, hasCompletion = false): ContainerCustomsView {
|
|
return {
|
|
aggregateId: '2092438843630391401', loadingPlanId: '2092438843630391402', containerBookingId: '2092438843630391403',
|
|
planNo: 'LP-1', cabinetNo: 'MCR08290001', containerNo: 'MSCU-1', status, hasActualCargo: true, version: 3, taxRefundCount: 1, coveredTaxRefundCount: 1, actualBoxCount: 12,
|
|
inbounds: [{ inboundId: '2092438843630391404', orderId: '2092438843630391405', orderNo: 'O-1', inboundCode: 'RK-1', tenantId: '2092438843630391406', customerName: '客户一', taxMode: 'TAX_REFUND', covered: true }],
|
|
documents: [{
|
|
documentId: '2092438843630391407', tenantId: '2092438843630391406',
|
|
source: { fileId: '2092438843630391408', fileName: '客户退税资料.pdf', fileHash: 'source-hash', sizeBytes: 12, version: 2, uploadedAt: '2026-08-29T10:00:00' },
|
|
inboundIds: ['2092438843630391404'], inboundCodes: ['RK-1'], frozen: true,
|
|
receipt: hasCompletion ? { fileId: '2092438843630391409', fileName: '报关行回执.pdf', fileHash: 'receipt-hash', sizeBytes: 13, version: 1, uploadedAt: '2026-08-29T11:00:00' } : null,
|
|
finalDocument: hasCompletion ? { fileId: '2092438843630391410', fileName: '真实报关完税文件.pdf', fileHash: 'final-hash', sizeBytes: 14, version: 1, uploadedAt: '2026-08-29T12:00:00' } : null,
|
|
confirmationHistory: hasCompletion ? [{ id: '2092438843630391411', receiptVersion: 1, action: 'CONFIRM', reason: null, operatorName: '客户一', createdAt: '2026-08-29T11:15:00' }] : [],
|
|
}],
|
|
brokerSubmission: hasCompletion ? { id: '2092438843630391412', customsContainerId: '2092438843630391401', loadingPlanId: '2092438843630391402', batchNo: 'BS-20260829-001', status: 'SENT', sourceVersion: 3, sentByName: '平台员', sentAt: '2026-08-29T10:45:00', version: 1 } : null,
|
|
startedAt: status === 'DECLARING' || status === 'COMPLETED' ? '2026-08-29T10:30:00' : null,
|
|
completedAt: status === 'COMPLETED' ? '2026-08-29T11:30:00' : null,
|
|
}
|
|
}
|
|
|
|
async function render(status: ContainerCustomsStatus, canManage = true, hasCompletion = false) {
|
|
api.get.mockResolvedValue(customs(status, hasCompletion))
|
|
const wrapper = mount(ContainerCustomsPanel, {
|
|
props: { loadingPlanId: '2092438843630391402', canList: true, canManage, departureState: 'WAITING_OTHER_GATES' },
|
|
global: { plugins: [ElementPlus] },
|
|
})
|
|
await flushPromises()
|
|
return wrapper
|
|
}
|
|
|
|
function buttonTexts(wrapper: Awaited<ReturnType<typeof render>>) {
|
|
return wrapper.findAll('button').map((button) => button.text())
|
|
}
|
|
|
|
describe('ContainerCustomsPanel', () => {
|
|
beforeEach(() => {
|
|
vi.clearAllMocks()
|
|
api.getDeclarationBatches.mockResolvedValue([])
|
|
api.downloadSource.mockResolvedValue(new Blob(['source']))
|
|
api.downloadReceipt.mockResolvedValue(new Blob(['receipt']))
|
|
api.downloadFinal.mockResolvedValue(new Blob(['final']))
|
|
Object.defineProperty(URL, 'createObjectURL', { configurable: true, value: vi.fn(() => 'blob:customs-file') })
|
|
Object.defineProperty(URL, 'revokeObjectURL', { configurable: true, value: vi.fn() })
|
|
vi.spyOn(HTMLAnchorElement.prototype, 'click').mockImplementation(() => undefined)
|
|
})
|
|
|
|
it('保留其他原因必填与批次版本，统一窗口确认后仍提交原始结果', async () => {
|
|
const batch: DeclarationBatch = {
|
|
id: '101', customsContainerId: '102', loadingPlanId: '2092438843630391402',
|
|
batchNo: 'DEC-TEST-001', status: 'SUBMITTED', sourceVersion: 3,
|
|
customsEntryNo: 'ENTRY-001', version: 7, submittedAt: null,
|
|
submittedByName: null, acknowledgedAt: null, acknowledgedByName: null, remark: null, results: [],
|
|
}
|
|
api.getDeclarationBatches.mockResolvedValue([batch])
|
|
api.get.mockResolvedValue({ ...customs('DECLARING', true), brokerSubmittedAt: '2026-10-19T09:00:00' })
|
|
const wrapper = mount(ContainerCustomsPanel, {
|
|
props: { loadingPlanId: batch.loadingPlanId, canList: true, canManage: true, departureState: 'WAITING_OTHER_GATES' },
|
|
global: { plugins: [ElementPlus] },
|
|
})
|
|
await flushPromises()
|
|
await wrapper.findAll('button').find(button => button.text() === '标记海关异常/结果')!.trigger('click')
|
|
const state = (wrapper.vm.$ as unknown as { setupState: {
|
|
clearanceBatch: DeclarationBatch; clearanceResultType: ClearanceResultType; clearanceRemark: string; clearanceDialogVisible: boolean
|
|
} }).setupState
|
|
state.clearanceResultType = 'OTHER'
|
|
await flushPromises()
|
|
const dialog = wrapper.getComponent(AppDialog)
|
|
expect(dialog.props('title')).toBe('标记海关异常/结果 · DEC-TEST-001')
|
|
expect(dialog.props('lockWhileSubmitting')).toBe(false)
|
|
dialog.vm.$emit('confirm')
|
|
await flushPromises()
|
|
expect(api.recordResult).not.toHaveBeenCalled()
|
|
state.clearanceRemark = ' 已核实海关通知 '
|
|
dialog.vm.$emit('confirm')
|
|
await flushPromises()
|
|
expect(api.recordResult).toHaveBeenCalledWith(batch, 'OTHER', '已核实海关通知')
|
|
expect(dialog.props('modelValue')).toBe(false)
|
|
wrapper.unmount()
|
|
})
|
|
|
|
it('开始报关确认显示柜次号，取消不会冻结资料或调用开始接口', async () => {
|
|
const confirm = vi.spyOn(ElMessageBox, 'confirm').mockRejectedValueOnce('cancel')
|
|
const wrapper = await render('READY_TO_START')
|
|
await wrapper.findAll('button').find(button => button.text() === '开始报关')!.trigger('click')
|
|
await flushPromises()
|
|
expect(confirm).toHaveBeenCalledWith(expect.any(String), '开始整柜报关 · MCR08290001', expect.objectContaining({ customClass: 'admin-density-confirm' }))
|
|
expect(api.start).not.toHaveBeenCalled()
|
|
confirm.mockRestore()
|
|
wrapper.unmount()
|
|
})
|
|
|
|
it('renders all customs result reasons in Chinese with the recorded remarks', async () => {
|
|
const reasons: Array<[ClearanceResultType, string]> = [
|
|
['INSPECTION', '查验'], ['SUPPLEMENT_REQUIRED', '补资料'],
|
|
['DETAINED', '扣货'], ['RELEASED', '放行'], ['OTHER', '其他'],
|
|
]
|
|
const batch: DeclarationBatch = {
|
|
id: '101', customsContainerId: '102', loadingPlanId: '2092438843630391402',
|
|
batchNo: 'DEC-TEST-001', status: 'RESULT_PENDING', sourceVersion: 1,
|
|
customsEntryNo: 'ENTRY-TEST-001', version: 1, submittedAt: null,
|
|
submittedByName: null, acknowledgedAt: null, acknowledgedByName: null, remark: null,
|
|
results: reasons.map(([resultType], index) => ({
|
|
id: String(200 + index), declarationBatchId: '101', customsContainerId: '102',
|
|
resultType, resultStatus: 'OPEN', customsEntryNo: 'ENTRY-TEST-001',
|
|
occurredAt: '2026-09-29T10:00:00', resolution: `人工备注${index}`,
|
|
evidenceFileId: null, recordedByName: '操作员', recordedAt: '2026-09-29T10:00:00',
|
|
previousResultId: null,
|
|
})),
|
|
}
|
|
api.getDeclarationBatches.mockResolvedValue([batch])
|
|
api.get.mockResolvedValue({ ...customs('COMPLETED', true), brokerSubmittedAt: '2026-09-29T09:00:00' })
|
|
const wrapper = mount(ContainerCustomsPanel, {
|
|
props: { loadingPlanId: batch.loadingPlanId, canList: true, canManage: false, departureState: 'WAITING_OTHER_GATES' },
|
|
global: { plugins: [ElementPlus] },
|
|
})
|
|
await flushPromises()
|
|
const rows = wrapper.findAll('.declaration-result-row')
|
|
expect(rows).toHaveLength(reasons.length)
|
|
for (const [index, [code, label]] of reasons.entries()) {
|
|
expect(rows[index]!.text()).toContain(label)
|
|
expect(rows[index]!.text()).toContain(`人工备注${index}`)
|
|
expect(rows[index]!.text()).not.toContain(code)
|
|
expect(rows[index]!.find('button').exists()).toBe(false)
|
|
}
|
|
wrapper.unmount()
|
|
})
|
|
|
|
it('keeps READY_TO_START read-only while exposing source file name and download', async () => {
|
|
const wrapper = await render('READY_TO_START')
|
|
expect(wrapper.text()).toContain('开始报关')
|
|
expect(wrapper.find('[aria-label="报关概况"]').exists()).toBe(false)
|
|
expect(wrapper.text()).toContain('客户退税资料.pdf')
|
|
expect(wrapper.text()).toContain('客户退税资料')
|
|
expect(wrapper.text()).toContain('报关行回执')
|
|
expect(wrapper.text()).not.toContain('客户报关资料')
|
|
expect(wrapper.find('[aria-label="下载客户退税资料 客户退税资料.pdf"]').exists()).toBe(true)
|
|
expect(buttonTexts(wrapper)).not.toContain('上传报关行回执')
|
|
expect(buttonTexts(wrapper)).not.toContain('覆盖报关行回执')
|
|
expect(buttonTexts(wrapper)).not.toContain('提交')
|
|
})
|
|
|
|
it('shows a successful empty state and hides customs actions when the completed plan has no actual cargo', async () => {
|
|
api.get.mockResolvedValue({ ...customs('READY_TO_START'), hasActualCargo: false, taxRefundCount: 0, coveredTaxRefundCount: 0, actualBoxCount: 0, inbounds: [], documents: [] })
|
|
const wrapper = mount(ContainerCustomsPanel, {
|
|
props: { loadingPlanId: '2092438843630391402', canList: true, canManage: true, departureState: 'WAITING_OTHER_GATES' },
|
|
global: { plugins: [ElementPlus] },
|
|
})
|
|
await flushPromises()
|
|
|
|
expect(wrapper.text()).toContain('当前装柜计划没有实际装柜货物，无需报关')
|
|
expect(wrapper.text()).toContain('无需报关')
|
|
expect(buttonTexts(wrapper)).not.toContain('开始报关')
|
|
expect(buttonTexts(wrapper)).not.toContain('导出买单 XLSX')
|
|
})
|
|
|
|
it('shows a pending state instead of an error before loading is completed', async () => {
|
|
api.get.mockResolvedValue(null)
|
|
const wrapper = mount(ContainerCustomsPanel, {
|
|
props: { loadingPlanId: '2097922185010147329', canList: true, canManage: false, departureState: 'WAITING_OTHER_GATES' },
|
|
global: { plugins: [ElementPlus] },
|
|
})
|
|
await flushPromises()
|
|
|
|
expect(wrapper.text()).toContain('当前装柜计划尚未完成，完成装柜后可处理报关')
|
|
expect(wrapper.text()).not.toContain('整柜报关加载失败')
|
|
})
|
|
|
|
it('allows completion upload and overwrite only while DECLARING with manage permission', async () => {
|
|
let wrapper = await render('DECLARING', true, false)
|
|
expect(wrapper.text()).toContain('首次发送报关行')
|
|
expect(wrapper.text()).toContain('首次发送后上传回执')
|
|
expect(buttonTexts(wrapper)).not.toContain('上传报关行回执')
|
|
wrapper.unmount()
|
|
|
|
wrapper = await render('DECLARING', true, true)
|
|
expect(wrapper.text()).toContain('发送报关行执行')
|
|
expect(wrapper.text()).toContain('覆盖报关行回执')
|
|
expect(wrapper.text()).toContain('报关行回执.pdf')
|
|
expect(wrapper.text()).toContain('真实报关完税文件.pdf')
|
|
expect(wrapper.text()).toContain('确认 · 2026/8/29 11:15:00 · 客户一')
|
|
wrapper.unmount()
|
|
|
|
wrapper = await render('DECLARING', false, true)
|
|
expect(wrapper.text()).toContain('只读')
|
|
expect(buttonTexts(wrapper)).not.toContain('上传报关行回执')
|
|
expect(buttonTexts(wrapper)).not.toContain('覆盖报关行回执')
|
|
expect(buttonTexts(wrapper)).not.toContain('提交')
|
|
})
|
|
|
|
it('loads declaration batches during DECLARING after broker execution was sent', async () => {
|
|
const value = { ...customs('DECLARING', true), brokerSubmittedAt: '2026-08-29T11:20:00' }
|
|
api.get.mockResolvedValue(value)
|
|
const wrapper = mount(ContainerCustomsPanel, {
|
|
props: { loadingPlanId: '2092438843630391402', canList: true, canManage: true, departureState: 'WAITING_OTHER_GATES' },
|
|
global: { plugins: [ElementPlus] },
|
|
})
|
|
await flushPromises()
|
|
expect(api.getDeclarationBatches).toHaveBeenCalledWith('2092438843630391402')
|
|
wrapper.unmount()
|
|
})
|
|
|
|
it('keeps COMPLETED strictly read-only with both files visible and downloadable', async () => {
|
|
const wrapper = await render('COMPLETED', true, true)
|
|
expect(wrapper.text()).toContain('客户退税资料.pdf')
|
|
expect(wrapper.text()).toContain('报关行回执.pdf')
|
|
expect(wrapper.text()).toContain('真实报关完税文件.pdf')
|
|
expect(wrapper.text()).toContain('报关已完成，待其他离仓条件')
|
|
expect(buttonTexts(wrapper)).not.toContain('上传报关行回执')
|
|
expect(buttonTexts(wrapper)).not.toContain('覆盖报关行回执')
|
|
expect(buttonTexts(wrapper)).not.toContain('提交')
|
|
})
|
|
|
|
it('routes source and completion downloads independently by the long document id and original names', async () => {
|
|
const wrapper = await render('COMPLETED', false, true)
|
|
await wrapper.get('[aria-label="下载客户退税资料 客户退税资料.pdf"]').trigger('click')
|
|
await flushPromises()
|
|
expect(api.downloadSource).toHaveBeenCalledWith('2092438843630391407')
|
|
expect(api.downloadReceipt).not.toHaveBeenCalled()
|
|
|
|
await wrapper.get('[aria-label="下载报关行回执 报关行回执.pdf"]').trigger('click')
|
|
await flushPromises()
|
|
expect(api.downloadReceipt).toHaveBeenCalledWith('2092438843630391407')
|
|
await wrapper.get('[aria-label="下载报关完税文件 真实报关完税文件.pdf"]').trigger('click')
|
|
await flushPromises()
|
|
expect(api.downloadFinal).toHaveBeenCalledWith('2092438843630391407')
|
|
expect(HTMLAnchorElement.prototype.click).toHaveBeenCalledTimes(3)
|
|
expect(URL.createObjectURL).toHaveBeenCalledTimes(3)
|
|
expect(URL.revokeObjectURL).toHaveBeenCalledWith('blob:customs-file')
|
|
})
|
|
|
|
it('preserves backend error code, request id and trace id when one download fails', async () => {
|
|
api.downloadSource.mockRejectedValueOnce(new ApiResponseError('文件不可用', 'CUSTOMS_FILE_404', 404, undefined, 'request-customs-download', 'trace-customs-download'))
|
|
const wrapper = await render('COMPLETED', false, true)
|
|
|
|
await wrapper.get('[aria-label="下载客户退税资料 客户退税资料.pdf"]').trigger('click')
|
|
await flushPromises()
|
|
|
|
expect(wrapper.text()).toContain('文件不可用')
|
|
expect(wrapper.text()).toContain('CUSTOMS_FILE_404')
|
|
expect(wrapper.text()).toContain('request-customs-download')
|
|
expect(wrapper.text()).toContain('trace-customs-download')
|
|
expect(api.downloadReceipt).not.toHaveBeenCalled()
|
|
})
|
|
})
|