fix(dispatch): preview selected driver master license before saving

src/modules/overseas-warehouse/components/DispatchWorkflowDialog.layout.test.ts

@@ -4,6 +4,7 @@ import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest'
 import DispatchWorkflowDialog from './DispatchWorkflowDialog.vue'
 import DispatchEvidenceFiles from './DispatchEvidenceFiles.vue'
 import DispatchResourceFields from './DispatchResourceFields.vue'
+import { downloadDriverLicense } from '@/modules/overseas-master-data'
 import { blankVehicleMaintenance } from '../dispatchVehicleMaintenance'
 import AppDialog from '@/shared/components/AppDialog.vue'
 import LoadErrorState from '@/shared/components/LoadErrorState.vue'
@@ -16,7 +17,7 @@ const identity = vi.hoisted(() => ({ id: '' }))
 const can = vi.hoisted(() => vi.fn((_code: string) => true))
 vi.mock('@/core/auth/auth', () => ({ useAuthStore: () => ({ user: identity }) }))
 vi.mock('@/core/access/accessPreview', () => ({ useAccessPreviewStore: () => ({ can }) }))
-vi.mock('@/modules/overseas-master-data', () => ({ listVehicles: vi.fn(), listDrivers: vi.fn(), overseasMasterDataPermissions: { vehicleList: 'vehicle:list', driverList: 'driver:list' } }))
+vi.mock('@/modules/overseas-master-data', () => ({ listVehicles: vi.fn(), listDrivers: vi.fn(), downloadDriverLicense: vi.fn(), overseasMasterDataPermissions: { vehicleList: 'vehicle:list', driverList: 'driver:list' } }))
 vi.mock('../api/dispatches', () => ({ getDispatch: vi.fn(), getDispatchItems: vi.fn(), getDispatchRoute: vi.fn(), reorderDispatchRoute: vi.fn(), removeDispatchItem: vi.fn(), getDispatchLoading: vi.fn(), getDispatchCommand: vi.fn(), listDispatches: vi.fn(), listDispatchCandidates: vi.fn(), completeDispatchLoading: vi.fn(), reviewDispatch: vi.fn(), reviewDispatchLoading: vi.fn(), returnDispatchToReview: vi.fn(), cancelDispatch: vi.fn(), updateDispatch: vi.fn(), addDispatchCargo: vi.fn(), submitDispatchReview: vi.fn(), getDispatchEvidence: vi.fn(), getDispatchEvidenceContent: vi.fn(), uploadDispatchEvidence: vi.fn() }))
 
 enableAutoUnmount(afterEach)
@@ -53,6 +54,31 @@ async function render(action: DispatchAction, operation?: 'ROUTE', files = false
 function field(wrapper: Pick<VueWrapper, 'findAllComponents'>, label: string) { return wrapper.findAllComponents({ name: 'ElFormItem' }).find(item => item.props('label') === label)! }
 
 describe('dispatch workflow native layout', () => {
+  it('previews the selected master license without treating it as a trip upload and clears it on driver change', async () => {
+    vi.mocked(downloadDriverLicense).mockResolvedValue(new Blob(['png'], { type: 'image/png' }))
+    const { dialog } = await render('EDIT')
+    const fields = dialog.findComponent(DispatchResourceFields)
+    const selected = { ...resources().driver, mode: 'MASTER' as const, driverId: '22', evidence: { ...resources().driver.evidence!, fileIds: [], photoFileIds: [], masterLicenseFileId: '33' } }
+    fields.vm.$emit('update:driver', selected); await flushPromises()
+    const license = () => dialog.findAllComponents(DispatchEvidenceFiles).find(item => item.props('kind') === 'DRIVER')!
+    expect(license().find('img').attributes('alt')).toBe('驾驶证照片：驾驶证照片')
+    expect(downloadDriverLicense).toHaveBeenCalledExactlyOnceWith('22', '33')
+    expect(license().props('modelValue')).toEqual([])
+    expect(license().text()).not.toContain('移除引用')
+    expect(api.getDispatchEvidence).not.toHaveBeenCalledWith('PC/1', 'DRIVER', '33')
+    fields.vm.$emit('update:driver', { ...selected, driverId: '23', evidence: { ...selected.evidence, masterLicenseFileId: null } }); await flushPromises()
+    expect(license().find('img').exists()).toBe(false)
+    expect(license().text()).toContain('暂无照片')
+  })
+  it('reads an already frozen master license through the dispatch permission without a new driver directory request', async () => {
+    const saved = resources()
+    saved.driver = { ...saved.driver, mode: 'MASTER', driverId: '22', evidence: { ...saved.driver.evidence!, fileIds: ['33'], masterLicenseFileId: '33' } }
+    const { dialog } = await render('EDIT', undefined, false, { vehicleInfo: saved })
+    const license = dialog.findAllComponents(DispatchEvidenceFiles).find(item => item.props('kind') === 'DRIVER')!
+    expect(license.findAll('img')).toHaveLength(1)
+    expect(api.getDispatchEvidence).toHaveBeenCalledWith('PC/1', 'DRIVER', '33')
+    expect(downloadDriverLicense).not.toHaveBeenCalled()
+  })
   it('brings ten orders at one destination into one appointment input with confirmed time and all shipments', async () => {
     const initial = detail(), shipmentNumbers = Array.from({ length: 10 }, (_, index) => `SHIP-${index}`)
     const appointment = { batchKey: null, batchNo: null, customerId: null, appointmentNo: 'ISA-ONE', destinationKey: 'FBA:ONT8', destinationWarehouseCode: 'ONT8', status: 'SUCCESS', confirmedAt: '2026-10-25T17:00:00Z', blockReason: null, shipmentNumbers }
@@ -172,7 +198,7 @@ describe('dispatch workflow native layout', () => {
     expect(dialog.get('[aria-label="本车审核依据"] h3').text()).toBe('车辆与货物')
     expect(dialog.get('[aria-label="本车审核依据"]').text()).toContain('联系电话')
     expect(dialog.get('[aria-label="排车与预约"]').findAll('input')).toHaveLength(0)
-    const photos = dialog.get('[aria-label="审核照片"]').findAllComponents(DispatchEvidenceFiles)
+    const photos = dialog.findAllComponents(DispatchEvidenceFiles)
     expect(photos.map(photo => photo.props('label'))).toEqual(['车辆图片', '司机照片', '驾驶证照片'])
     expect(photos.every(photo => photo.props('readonly'))).toBe(true)
     expect(dialog.get('[aria-label="操作原因与意见"] h3').text()).toBe('审核意见')