优化构架

This commit is contained in:
2026-08-03 18:49:18 +08:00
parent 1241d11c01
commit 44c33a6280
133 changed files with 651 additions and 603 deletions
@@ -0,0 +1,72 @@
import { beforeEach, describe, expect, it, vi } from 'vitest'
import { http } from '@/shared/api/http'
import {
acceptPlatformFirstLegOrder,
addPlatformFirstLegOrderNote,
approvePlatformFirstLegOrder,
cancelPlatformFirstLegOrder,
completePlatformFirstLegOrder,
getPlatformFirstLegOrder,
listPlatformFirstLegOrders,
startPlatformFirstLegOrder,
updatePlatformFirstLegOrderExpress,
} from './platformFirstLegOrders'
vi.mock('@/shared/api/http', () => ({
http: { get: vi.fn(), post: vi.fn(), put: vi.fn() },
unwrapApiResponse: <T>(response: { data: T }) => response.data,
}))
describe('platform first-leg order API', () => {
beforeEach(() => {
vi.mocked(http.get).mockReset()
vi.mocked(http.post).mockReset()
vi.mocked(http.put).mockReset()
})
it('queries a tenant-scoped order page with server pagination and filters', async () => {
const page = { records: [], page: 2, size: 20, total: 0, pages: 0 }
vi.mocked(http.get).mockResolvedValue({ code: '200', message: 'success', data: page })
await expect(listPlatformFirstLegOrders('10001', {
keyword: 'FL2026', status: 'SUBMITTED', createdFrom: '2026-07-01T00:00:00', createdTo: '2026-07-31T23:59:59', page: 2, size: 20,
})).resolves.toEqual(page)
expect(http.get).toHaveBeenCalledWith('/platform/v1/orders/first-leg', {
params: {
tenantId: '10001', keyword: 'FL2026', status: 'SUBMITTED', createdFrom: '2026-07-01T00:00:00', createdTo: '2026-07-31T23:59:59', page: 2, size: 20,
},
})
})
it('uses the platform lifecycle routes and target tenant query parameter', async () => {
vi.mocked(http.get).mockResolvedValue({ code: '200', message: 'success', data: { order: {} } })
vi.mocked(http.post).mockResolvedValue({ code: '200', message: 'success', data: null })
await getPlatformFirstLegOrder('10001', '90001')
await approvePlatformFirstLegOrder('10001', '90001')
await acceptPlatformFirstLegOrder('10001', '90001')
await startPlatformFirstLegOrder('10001', '90001')
await completePlatformFirstLegOrder('10001', '90001')
await cancelPlatformFirstLegOrder('10001', '90001', '客户取消')
await addPlatformFirstLegOrderNote('10001', '90001', '已联系客户确认')
expect(http.get).toHaveBeenCalledWith('/platform/v1/orders/first-leg/90001', { params: { tenantId: '10001' } })
expect(http.post).toHaveBeenNthCalledWith(1, '/platform/v1/orders/first-leg/90001/approve', undefined, { params: { tenantId: '10001' } })
expect(http.post).toHaveBeenNthCalledWith(2, '/platform/v1/orders/first-leg/90001/accept', undefined, { params: { tenantId: '10001' } })
expect(http.post).toHaveBeenNthCalledWith(3, '/platform/v1/orders/first-leg/90001/start', undefined, { params: { tenantId: '10001' } })
expect(http.post).toHaveBeenNthCalledWith(4, '/platform/v1/orders/first-leg/90001/complete', undefined, { params: { tenantId: '10001' } })
expect(http.post).toHaveBeenNthCalledWith(5, '/platform/v1/orders/first-leg/90001/cancel', { reason: '客户取消' }, { params: { tenantId: '10001' } })
expect(http.post).toHaveBeenNthCalledWith(6, '/platform/v1/orders/first-leg/90001/internal-notes', { content: '已联系客户确认' }, { params: { tenantId: '10001' } })
})
it('writes the backend express contract as names, not a guessed master-data ID', async () => {
vi.mocked(http.put).mockResolvedValue({ code: '200', message: 'success', data: null })
await updatePlatformFirstLegOrderExpress('10001', '90001', { expressCompany: '顺丰速运', expressTrackingNo: 'SF123456' })
expect(http.put).toHaveBeenCalledWith(
'/platform/v1/orders/first-leg/90001/express',
{ expressCompany: '顺丰速运', expressTrackingNo: 'SF123456' },
{ params: { tenantId: '10001' } },
)
})
})
@@ -0,0 +1,171 @@
import { http, unwrapApiResponse, type ApiEnvelope } from '@/shared/api/http'
export type PlatformFirstLegOrderStatus =
| 'DRAFT'
| 'SUBMITTED'
| 'APPROVED'
| 'ACCEPTED'
| 'REJECTED'
| 'CANCELLED'
| 'PROCESSING'
| 'COMPLETED'
export interface PlatformFirstLegOrderResource {
id: number | string
tenantId: number | string
orderNo: string | null
customerId: number | string | null
customerName: string
status: PlatformFirstLegOrderStatus
transportMode: 'SEA' | 'AIR' | 'RAIL' | 'TRUCK'
tradeTerm: string | null
destinationCountryCode: string
destinationWarehouseId: number | string | null
destinationWarehouseName: string
expectedShipDate: string | null
customerRemark: string | null
pickupMethod: string
receivingWarehouseId: number | string
receivingWarehouseName: string
receivingWarehouseAddress: string | null
receivingTime: string | null
channelCode: string
channelName: string
taxMode: string
containerMode: string | null
customsInspection: boolean | null
destinationType: string
amazonWarehouseCode: string | null
shipmentId: string | null
referenceId: string | null
expressCompany: string | null
expressTrackingNo: string | null
createdAt: string
updatedAt: string
}
export interface PlatformFirstLegCargoResource {
id: number | string
itemNo: number
cargoName: string
cargoNameEn: string | null
packageType: string
packageCount: number
grossWeightKg: number
volumeCbm: number
totalQuantity: number | null
cargoRemark: string | null
}
export interface PlatformFirstLegPartyResource {
id: number | string
partyType: 'SENDER' | 'RECEIVER' | string
companyName: string
contactName: string
phone: string
email: string | null
countryCode: string
province: string | null
city: string
district: string | null
addressLine: string
postalCode: string | null
}
export interface PlatformOrderStatusHistoryResource {
id: number | string
fromStatus: PlatformFirstLegOrderStatus | null
toStatus: PlatformFirstLegOrderStatus
action: string
reason: string | null
operatorName: string | null
occurredAt: string
}
export interface PlatformOrderInternalNoteResource {
id: number | string
content: string
createdAt: string
createdBy: number | string | null
}
export interface PlatformFirstLegOrderDetailResource {
order: PlatformFirstLegOrderResource
cargoes: PlatformFirstLegCargoResource[]
parties: PlatformFirstLegPartyResource[]
internalNotes: PlatformOrderInternalNoteResource[]
statusHistory: PlatformOrderStatusHistoryResource[]
}
export interface PlatformFirstLegOrderPageResource {
records: PlatformFirstLegOrderResource[]
page: number
size: number
total: number
pages: number
}
export interface PlatformFirstLegOrderQuery {
keyword?: string
status?: PlatformFirstLegOrderStatus
customerId?: string
destinationWarehouseId?: string
createdFrom?: string
createdTo?: string
page: number
size: number
}
async function getData<T>(path: string, params?: Record<string, unknown>) {
const response = await http.get<ApiEnvelope<T>, ApiEnvelope<T>>(path, { params })
return unwrapApiResponse(response)
}
async function postData<T>(path: string, body?: unknown, params?: Record<string, unknown>) {
const response = await http.post<ApiEnvelope<T>, ApiEnvelope<T>>(path, body, { params })
return unwrapApiResponse(response)
}
export function listPlatformFirstLegOrders(tenantId: string, query: PlatformFirstLegOrderQuery) {
return getData<PlatformFirstLegOrderPageResource>('/platform/v1/orders/first-leg', { tenantId, ...query })
}
export function getPlatformFirstLegOrder(tenantId: string, orderId: string) {
return getData<PlatformFirstLegOrderDetailResource>(`/platform/v1/orders/first-leg/${orderId}`, { tenantId })
}
export function approvePlatformFirstLegOrder(tenantId: string, orderId: string) {
return postData<void>(`/platform/v1/orders/first-leg/${orderId}/approve`, undefined, { tenantId })
}
export function acceptPlatformFirstLegOrder(tenantId: string, orderId: string) {
return postData<void>(`/platform/v1/orders/first-leg/${orderId}/accept`, undefined, { tenantId })
}
export function startPlatformFirstLegOrder(tenantId: string, orderId: string) {
return postData<void>(`/platform/v1/orders/first-leg/${orderId}/start`, undefined, { tenantId })
}
export function completePlatformFirstLegOrder(tenantId: string, orderId: string) {
return postData<void>(`/platform/v1/orders/first-leg/${orderId}/complete`, undefined, { tenantId })
}
export function cancelPlatformFirstLegOrder(tenantId: string, orderId: string, reason: string) {
return postData<void>(`/platform/v1/orders/first-leg/${orderId}/cancel`, { reason }, { tenantId })
}
export function addPlatformFirstLegOrderNote(tenantId: string, orderId: string, content: string) {
return postData<number | string>(`/platform/v1/orders/first-leg/${orderId}/internal-notes`, { content }, { tenantId })
}
export function updatePlatformFirstLegOrderExpress(
tenantId: string,
orderId: string,
payload: { expressCompany: string; expressTrackingNo: string },
) {
return http.put<ApiEnvelope<void>, ApiEnvelope<void>>(
`/platform/v1/orders/first-leg/${orderId}/express`,
payload,
{ params: { tenantId } },
).then(unwrapApiResponse)
}