439 lines
19 KiB
TypeScript
439 lines
19 KiB
TypeScript
import ElementPlus, { ElMessage, ElMessageBox } from 'element-plus'
|
||
import { createPinia, setActivePinia } from 'pinia'
|
||
import { enableAutoUnmount, flushPromises, mount } from '@vue/test-utils'
|
||
import { afterAll, afterEach, beforeEach, describe, expect, it, vi } from 'vitest'
|
||
import { ApiResponseError } from '@/shared/api/http'
|
||
import { useAuthStore } from '@/core/auth/auth'
|
||
import { useAccessPreviewStore } from '@/core/access/accessPreview'
|
||
import {
|
||
downloadInboundMeasurementImage,
|
||
createManualCartonScan,
|
||
getInboundMeasurement,
|
||
saveInboundMeasurementDraft,
|
||
submitInboundMeasurement,
|
||
updateConfirmedPackageCount,
|
||
} from './api'
|
||
import type { InboundMeasurementDetail } from './types'
|
||
import InboundMeasurementPanel from './InboundMeasurementPanel.vue'
|
||
|
||
vi.mock('./api', () => ({
|
||
createManualCartonScan: vi.fn(),
|
||
downloadInboundMeasurementImage: vi.fn(),
|
||
getInboundMeasurement: vi.fn(),
|
||
saveInboundMeasurementDraft: vi.fn(),
|
||
submitInboundMeasurement: vi.fn(),
|
||
updateConfirmedPackageCount: vi.fn(),
|
||
}))
|
||
|
||
class ResizeObserverStub implements ResizeObserver {
|
||
observe() {}
|
||
unobserve() {}
|
||
disconnect() {}
|
||
}
|
||
|
||
function createMemoryStorage(): Storage {
|
||
const values = new Map<string, string>()
|
||
return {
|
||
get length() { return values.size },
|
||
clear: () => values.clear(),
|
||
getItem: (key) => values.get(key) ?? null,
|
||
key: (index) => [...values.keys()][index] ?? null,
|
||
removeItem: (key) => values.delete(key),
|
||
setItem: (key, value) => values.set(key, value),
|
||
}
|
||
}
|
||
|
||
function measurement(overrides: Partial<InboundMeasurementDetail> = {}): InboundMeasurementDetail {
|
||
return {
|
||
inboundId: '7001',
|
||
inboundCode: 'RK202608040001',
|
||
companyName: '测试企业',
|
||
channelCode: 'SEA-FBA',
|
||
channelName: '美西海运',
|
||
processStatus: 'MEASURING',
|
||
measureReviewStatus: null,
|
||
recommendedPalletType: 'STANDARD',
|
||
reviewReason: null,
|
||
reviewerId: null,
|
||
reviewerName: null,
|
||
measurementId: '9001',
|
||
sourceType: 'THIRD_PARTY',
|
||
measurementStatus: 'RECEIVED',
|
||
version: 2,
|
||
originalDocumentNo: 'DOC-001',
|
||
originalGrossWeightKg: 118.5,
|
||
originalVolumeCbm: 0.8,
|
||
originalPackageCount: 10,
|
||
actualPackageCount: 10,
|
||
actualGrossWeightKg: 120,
|
||
actualNetWeightKg: 110,
|
||
actualVolumeCbm: 0.6,
|
||
volumeWeightKg: 100.2,
|
||
actualGoodsName: '蓝牙音箱',
|
||
items: [{
|
||
id: '9101',
|
||
boxCode: 'RK202608040001#10-1',
|
||
itemNo: '001',
|
||
boxSpecification: '50×40×30cm',
|
||
packageCount: 10,
|
||
lengthCm: 50,
|
||
widthCm: 40,
|
||
heightCm: 30,
|
||
girthCm: 190,
|
||
unitWeightKg: 12,
|
||
unitVolumeCbm: 0.06,
|
||
totalWeightKg: 120,
|
||
totalVolumeCbm: 0.6,
|
||
volumeWeightKg: 100.2,
|
||
intelligentImageFileId: '88001',
|
||
machineNo: 'MJ20210327',
|
||
measuredAt: '2026-08-04T10:30:00+08:00',
|
||
overLimitWarning: null,
|
||
outerLengthCm: null,
|
||
outerWidthCm: null,
|
||
outerHeightCm: null,
|
||
remark: '设备自动回传',
|
||
}],
|
||
weightResults: [],
|
||
...overrides,
|
||
}
|
||
}
|
||
|
||
async function mountPanel(permissions = [
|
||
'platform:firstleg:inbound:measure:view',
|
||
'platform:firstleg:inbound:measure:edit',
|
||
'platform:firstleg:inbound:measure:manual-entry',
|
||
'platform:firstleg:inbound:measure:submit',
|
||
]) {
|
||
const pinia = createPinia()
|
||
setActivePinia(pinia)
|
||
const auth = useAuthStore()
|
||
auth.token = 'token'
|
||
auth.permissions = permissions
|
||
useAccessPreviewStore().initializeAfterLogin()
|
||
const wrapper = mount(InboundMeasurementPanel, {
|
||
props: { customerId: '10001', inboundId: '7001' },
|
||
attachTo: document.body,
|
||
global: { plugins: [pinia, ElementPlus] },
|
||
})
|
||
await flushPromises()
|
||
return wrapper
|
||
}
|
||
|
||
enableAutoUnmount(afterEach)
|
||
afterAll(() => vi.unstubAllGlobals())
|
||
|
||
describe('InboundMeasurementPanel', () => {
|
||
beforeEach(() => {
|
||
vi.stubGlobal('ResizeObserver', ResizeObserverStub)
|
||
vi.stubGlobal('localStorage', createMemoryStorage())
|
||
vi.stubGlobal('sessionStorage', createMemoryStorage())
|
||
document.body.innerHTML = ''
|
||
vi.mocked(getInboundMeasurement).mockReset().mockResolvedValue(measurement())
|
||
vi.mocked(updateConfirmedPackageCount).mockReset().mockResolvedValue({
|
||
measurementId: '9001', measurementVersion: 3, itemId: '9101',
|
||
boxCode: 'RK202608040001#10-1', confirmedPackageCount: 10,
|
||
})
|
||
vi.mocked(saveInboundMeasurementDraft).mockReset().mockResolvedValue({ measurementId: '9001', version: 3, status: 'DRAFT' })
|
||
vi.mocked(submitInboundMeasurement).mockReset().mockResolvedValue({
|
||
measurementId: '9001', version: 2, processStatus: 'MEASURE_PENDING', measureReviewStatus: 'PENDING',
|
||
recommendedPalletType: 'STANDARD', feeId: null, feeNo: null, feeStatus: null,
|
||
})
|
||
vi.mocked(createManualCartonScan).mockReset().mockResolvedValue({
|
||
measurementId: '9001', measurementVersion: 3, itemId: '9102', boxCode: 'RK202608040001#10-2',
|
||
confirmedPackageCount: 1,
|
||
})
|
||
vi.spyOn(ElMessageBox, 'confirm').mockResolvedValue(undefined as never)
|
||
})
|
||
|
||
it('loads third-party facts and renders server-calculated values separately', async () => {
|
||
const wrapper = await mountPanel()
|
||
|
||
expect(getInboundMeasurement).toHaveBeenCalledWith('10001', '7001')
|
||
expect(wrapper.text()).toContain('RK202608040001')
|
||
expect(wrapper.find('.measurement-table').text()).toContain('0.6')
|
||
expect(wrapper.find('.measurement-table').text()).not.toContain('周长')
|
||
await wrapper.find('.el-table__expand-icon').trigger('click')
|
||
await flushPromises()
|
||
expect(wrapper.text()).toContain('箱规周长')
|
||
expect(wrapper.text()).toContain('190 cm')
|
||
expect(wrapper.text()).toContain('MJ20210327')
|
||
expect(wrapper.text()).toContain('2026-08-04 10:30:00+08:00')
|
||
expect(wrapper.find('button[aria-label="预览测量图片"]').exists()).toBe(true)
|
||
})
|
||
|
||
it('opens the manual carton entry form in an editable measurement state', async () => {
|
||
const wrapper = await mountPanel()
|
||
const button = wrapper.findAll('button').find((candidate) => candidate.text().includes('手动录入箱规'))
|
||
expect(button?.attributes('disabled')).toBeUndefined()
|
||
await button?.trigger('click')
|
||
expect(wrapper.text()).toContain('手动录入箱规')
|
||
|
||
expect(document.body.textContent).toContain('箱号')
|
||
expect(document.body.textContent).toContain('测量长（cm）')
|
||
expect(document.body.textContent).toContain('测量图片')
|
||
expect(document.body.textContent).toContain('保存箱规')
|
||
})
|
||
|
||
it('does not expose manual carton entry without its dedicated permission', async () => {
|
||
const wrapper = await mountPanel([
|
||
'platform:firstleg:inbound:measure:view',
|
||
'platform:firstleg:inbound:measure:edit',
|
||
'platform:firstleg:inbound:measure:submit',
|
||
])
|
||
|
||
expect(wrapper.text()).not.toContain('手动录入箱规')
|
||
})
|
||
|
||
it('does not expose unknown measurement source codes', async () => {
|
||
vi.mocked(getInboundMeasurement).mockResolvedValueOnce(measurement({ sourceType: 'LEGACY_DEVICE' }))
|
||
|
||
const wrapper = await mountPanel()
|
||
|
||
expect(wrapper.text()).toContain('未知来源')
|
||
expect(wrapper.text()).not.toContain('LEGACY_DEVICE')
|
||
})
|
||
|
||
it('keeps key totals compact and shows declaration information without another disclosure card', async () => {
|
||
const wrapper = await mountPanel()
|
||
const text = wrapper.text()
|
||
|
||
expect(text).toContain('实测箱数')
|
||
expect(text).toContain('货物重量')
|
||
expect(text).toContain('总体积')
|
||
expect(text).toContain('材积重')
|
||
expect(text).toContain('申报信息')
|
||
expect(text).toContain('箱规明细')
|
||
expect(text).not.toContain('租户')
|
||
expect(text).not.toContain('数据版本')
|
||
|
||
expect(wrapper.find('.measurement-table').exists()).toBe(true)
|
||
expect(wrapper.find('.measurement-item').exists()).toBe(false)
|
||
expect(wrapper.find('.measurement-table').text()).not.toContain('周长')
|
||
const source = await import('./InboundMeasurementPanel.vue?raw').then((module) => module.default)
|
||
expect(source).toContain('<section class="measurement-declaration"')
|
||
expect(source).not.toContain('<el-collapse-item name="declaration"')
|
||
expect(source).toContain('grid-template-columns: repeat(4, minmax(0, 1fr))')
|
||
expect(source).toContain('.measurement-data-grid { display: grid; grid-template-columns: repeat(5, minmax(0, 1fr));')
|
||
expect(source).toContain('.measurement-table { width: 100%; font-size: 12px; }')
|
||
expect(source).toContain('.measurement-data-grid :deep(.el-input__wrapper)')
|
||
expect(source).toContain('defineExpose({ saveDraft, submitForReview, updateActualWeights, mayMaintain, maySubmit, saving, submitting, canEdit, canSubmit, isDirty })')
|
||
})
|
||
|
||
it('renders customer declaration facts as plain read-only values', async () => {
|
||
const wrapper = await mountPanel()
|
||
const declaration = wrapper.find('.measurement-declaration')
|
||
|
||
expect(declaration.text()).toContain('申报箱数')
|
||
expect(declaration.text()).toContain('10')
|
||
expect(declaration.text()).toContain('申报毛重（kg）')
|
||
expect(declaration.text()).toContain('118.5')
|
||
expect(declaration.text()).toContain('申报体积（m³）')
|
||
expect(declaration.text()).toContain('0.8')
|
||
expect(declaration.text()).toContain('原单据号码')
|
||
expect(declaration.text()).toContain('DOC-001')
|
||
expect(declaration.findAll('.measurement-readonly-field')).toHaveLength(4)
|
||
expect(declaration.findAll('input')).toHaveLength(1)
|
||
expect(declaration.find('.measurement-goods-name input').exists()).toBe(true)
|
||
})
|
||
|
||
it('shows all declaration fields as plain text when measurement is not editable', async () => {
|
||
vi.mocked(getInboundMeasurement).mockResolvedValueOnce(measurement({ processStatus: 'WAIT_SPLIT' }))
|
||
const wrapper = await mountPanel()
|
||
const declaration = wrapper.find('.measurement-declaration')
|
||
|
||
expect(declaration.find('input').exists()).toBe(false)
|
||
expect(declaration.text()).toContain('蓝牙音箱')
|
||
expect(declaration.findAll('.measurement-readonly-field')).toHaveLength(5)
|
||
})
|
||
|
||
it('saves the corrected actual goods name without overriding declaration facts', async () => {
|
||
const wrapper = await mountPanel()
|
||
await wrapper.find('.measurement-goods-name input').setValue('修正后的蓝牙音箱')
|
||
const save = wrapper.findAll('button').find((button) => button.text().includes('保存测量数据'))
|
||
await save?.trigger('click')
|
||
await flushPromises()
|
||
|
||
expect(saveInboundMeasurementDraft).toHaveBeenCalledWith('10001', '7001', expect.objectContaining({
|
||
measurementId: '9001',
|
||
version: 2,
|
||
actualGoodsName: '修正后的蓝牙音箱',
|
||
items: expect.any(Array),
|
||
}))
|
||
const payload = vi.mocked(saveInboundMeasurementDraft).mock.calls[0]?.[2]
|
||
expect(payload).not.toHaveProperty('originalDocumentNo')
|
||
expect(payload).not.toHaveProperty('originalGrossWeightKg')
|
||
expect(payload).not.toHaveProperty('originalVolumeCbm')
|
||
})
|
||
|
||
it('updates the server weight summary without discarding unsaved measurement edits', async () => {
|
||
const wrapper = await mountPanel()
|
||
const countInput = wrapper.find('.measurement-count-editor input')
|
||
await countInput.setValue('9')
|
||
|
||
wrapper.vm.updateActualWeights(125.75, 115.75)
|
||
await flushPromises()
|
||
|
||
expect(wrapper.find('.measurement-metrics').text()).toContain('125.75')
|
||
expect(wrapper.find('.measurement-metrics').text()).toContain('115.75')
|
||
expect((countInput.element as HTMLInputElement).value).toBe('9')
|
||
})
|
||
|
||
it('reuses the established first-leg detail surface and status patterns', async () => {
|
||
const wrapper = await mountPanel()
|
||
|
||
expect(wrapper.classes()).toContain('surface-panel')
|
||
expect(wrapper.find('.measurement-summary-header').exists()).toBe(true)
|
||
expect(wrapper.find('.measurement-summary-status').text()).toContain('测量中')
|
||
expect(wrapper.find('.measurement-summary-header').text()).not.toContain('RK202608040001')
|
||
expect(wrapper.find('.measurement-summary-header').text()).toContain('测试企业')
|
||
expect(wrapper.find('.measurement-summary-header').text()).toContain('美西海运')
|
||
})
|
||
|
||
it('saves only the changed confirmed package count with the current measurement version', async () => {
|
||
vi.mocked(updateConfirmedPackageCount).mockResolvedValueOnce({
|
||
measurementId: '9001', measurementVersion: 3, itemId: '9101',
|
||
boxCode: 'RK202608040001#10-1', confirmedPackageCount: 9,
|
||
})
|
||
const wrapper = await mountPanel()
|
||
const countInput = wrapper.find('.measurement-count-editor input')
|
||
await countInput?.setValue('9')
|
||
const save = wrapper.findAll('button').find((button) => button.text().includes('保存测量数据'))
|
||
await save?.trigger('click')
|
||
await flushPromises()
|
||
|
||
expect(updateConfirmedPackageCount).toHaveBeenCalledWith('10001', '7001', '9101', {
|
||
measurementVersion: 2,
|
||
confirmedPackageCount: 9,
|
||
})
|
||
})
|
||
|
||
it('preserves the edited form when the backend reports a version conflict', async () => {
|
||
vi.mocked(updateConfirmedPackageCount).mockRejectedValueOnce(
|
||
new ApiResponseError('数据版本已变化，请刷新后重试', 'A0409', 200, null, 'req-conflict', 'trace-conflict'),
|
||
)
|
||
const wrapper = await mountPanel()
|
||
const countInput = wrapper.find('.measurement-count-editor input')
|
||
await countInput?.setValue('9')
|
||
const save = wrapper.findAll('button').find((button) => button.text().includes('保存测量数据'))
|
||
await save?.trigger('click')
|
||
await flushPromises()
|
||
|
||
expect(wrapper.text()).toContain('数据版本已变化，当前修改尚未丢失')
|
||
expect(wrapper.text()).toContain('req-conflict')
|
||
expect((countInput?.element as HTMLInputElement).value).toBe('9')
|
||
expect(getInboundMeasurement).toHaveBeenCalledTimes(1)
|
||
})
|
||
|
||
it('shows a normal A0409 business reason instead of relabeling it as a version conflict', async () => {
|
||
const messageSpy = vi.spyOn(ElMessage, 'error')
|
||
vi.mocked(updateConfirmedPackageCount).mockRejectedValueOnce(
|
||
new ApiResponseError('该托盘已被占用，请重新选择', 'A0409', 409),
|
||
)
|
||
const wrapper = await mountPanel()
|
||
const countInput = wrapper.find('.measurement-count-editor input')
|
||
await countInput.setValue('9')
|
||
const save = wrapper.findAll('button').find((button) => button.text().includes('保存测量数据'))
|
||
await save?.trigger('click')
|
||
await flushPromises()
|
||
|
||
expect(messageSpy).toHaveBeenCalledWith(expect.objectContaining({
|
||
message: '该托盘已被占用，请重新选择',
|
||
showClose: true,
|
||
duration: 4500,
|
||
}))
|
||
expect(wrapper.text()).not.toContain('操作未完成')
|
||
expect(wrapper.text()).not.toContain('数据版本已变化，当前修改尚未丢失')
|
||
})
|
||
|
||
it('reports draft validation as a dismissible light message without a fixed page alert', async () => {
|
||
const messageSpy = vi.spyOn(ElMessage, 'warning')
|
||
vi.mocked(getInboundMeasurement).mockResolvedValueOnce(measurement({ items: [] }))
|
||
const wrapper = await mountPanel()
|
||
const save = wrapper.findAll('button').find((button) => button.text().includes('保存测量数据'))
|
||
await save?.trigger('click')
|
||
await flushPromises()
|
||
|
||
expect(messageSpy).toHaveBeenCalledWith(expect.objectContaining({
|
||
message: '请至少保留一条实际扫描箱测量记录',
|
||
showClose: true,
|
||
duration: 4500,
|
||
}))
|
||
expect(wrapper.text()).not.toContain('请修正测量草稿中的问题')
|
||
})
|
||
|
||
it('requires the dirty draft to be saved before submitting for review', async () => {
|
||
const wrapper = await mountPanel()
|
||
const countInput = wrapper.find('.measurement-count-editor input')
|
||
await countInput?.setValue('9')
|
||
const submit = wrapper.findAll('button').find((button) => button.text().includes('提交审核'))
|
||
await submit?.trigger('click')
|
||
await flushPromises()
|
||
|
||
expect(submitInboundMeasurement).not.toHaveBeenCalled()
|
||
expect(ElMessageBox.confirm).not.toHaveBeenCalled()
|
||
})
|
||
|
||
it('submits the saved version and emits changed after confirmation', async () => {
|
||
const wrapper = await mountPanel()
|
||
const submit = wrapper.findAll('button').find((button) => button.text().includes('提交审核'))
|
||
await submit?.trigger('click')
|
||
await flushPromises()
|
||
|
||
expect(ElMessageBox.confirm).toHaveBeenCalledWith(
|
||
expect.stringContaining('准备托盘与库位占用'),
|
||
'提交测量审核',
|
||
expect.objectContaining({ confirmButtonText: '确认提交' }),
|
||
)
|
||
expect(submitInboundMeasurement).toHaveBeenCalledWith('10001', '7001', { measurementId: '9001', version: 2 })
|
||
expect(wrapper.emitted('changed')).toHaveLength(1)
|
||
})
|
||
|
||
it('emits updated without closing the parent task after manual carton entry', async () => {
|
||
const wrapper = await mountPanel()
|
||
const source = await import('./InboundMeasurementPanel.vue?raw').then((module) => module.default)
|
||
expect(source).toContain("emit('updated')")
|
||
expect(wrapper.emitted('updated')).toBeUndefined()
|
||
})
|
||
|
||
it('blocks normal submission when confirmed box counts do not match the order total', async () => {
|
||
vi.mocked(getInboundMeasurement).mockResolvedValueOnce(measurement({ originalPackageCount: 12 }))
|
||
const wrapper = await mountPanel()
|
||
|
||
expect(wrapper.text()).not.toContain('确认箱数尚未与订单总箱数匹配')
|
||
const submit = wrapper.findAll('button').find((button) => button.text().includes('提交审核'))
|
||
expect(submit?.attributes('disabled')).toBeDefined()
|
||
expect(submitInboundMeasurement).not.toHaveBeenCalled()
|
||
})
|
||
|
||
it('keeps device facts read-only but allows manual count correction after submission', async () => {
|
||
vi.mocked(getInboundMeasurement).mockResolvedValueOnce(measurement({ processStatus: 'MEASURE_PENDING' }))
|
||
const wrapper = await mountPanel()
|
||
const countInput = wrapper.find('.measurement-count-editor input')
|
||
|
||
expect((countInput?.element as HTMLInputElement).matches(':disabled')).toBe(false)
|
||
expect(wrapper.findAll('button').find((button) => button.text().includes('保存测量数据'))?.attributes('disabled')).toBeUndefined()
|
||
expect(wrapper.findAll('button').find((button) => button.text().includes('提交审核'))?.attributes('disabled')).toBeDefined()
|
||
expect(vi.mocked(downloadInboundMeasurementImage)).not.toHaveBeenCalled()
|
||
})
|
||
|
||
it('clears the previous customer context before loading the next one', async () => {
|
||
const wrapper = await mountPanel()
|
||
vi.mocked(getInboundMeasurement).mockResolvedValueOnce(measurement({ inboundId: '7002', inboundCode: 'RK202608040002', companyName: '第二企业' }))
|
||
|
||
await wrapper.setProps({ customerId: '10002', inboundId: '7002' })
|
||
await flushPromises()
|
||
|
||
expect(getInboundMeasurement).toHaveBeenLastCalledWith('10002', '7002')
|
||
expect(wrapper.find('.measurement-summary-header').text()).toContain('第二企业')
|
||
expect(wrapper.find('.measurement-summary-header').text()).not.toContain('测试企业')
|
||
})
|
||
|
||
it('renders a permission-specific read-only state without requesting data', async () => {
|
||
const wrapper = await mountPanel([])
|
||
|
||
expect(wrapper.text()).toContain('无测量查看权限')
|
||
expect(getInboundMeasurement).not.toHaveBeenCalled()
|
||
})
|
||
})
|