feat: edit collaboration remarks across order loading

src/modules/loading-lists/api/platformLoadingLists.test.ts

@@ -9,7 +9,7 @@ import {
   preparePalletLabels,
   printPalletLabels,
   updatePreloadTransport,
-  updateLoadingItemWarehouseRemark,
+  updateLoadingItemRemarks,
 } from './platformLoadingLists'
 
 const preloadSummary = {
@@ -53,7 +53,7 @@ const detail = {
     customerName: '测试客户', customsTaxMode: 'TAX_REFUND', taxRefundFlag: true, inboundCode: 'RK001', skuCode: 'SKU001', destinationWarehouse: 'ONT8', chineseName: '产品', englishName: null,
     goodsImageUrl: null, unitType: 'SEALED_PALLET', palletId: 9007199254740993n, palletNo: 'PLT-001', indivisible: true, packageCount: 2, palletCount: 1, grossWeightKg: 10, netWeightKg: 9, volumeCbm: 1,
     dimensionalWeightKg: 2, unitsPerPackage: 10, fbaTrackingNo: null, shipmentNo: null, shippingMark: null,
-    internalRemark: null, customerRemark: null, warehouseRemark: null, loadSequence: 1, frozenAt: null,
+    internalRemark: null, customerRemark: null, warehouseRemark: null, customerServiceRemark: null, loadSequence: 1, frozenAt: null,
   }],
   histories: [{ historyId: 21, itemId: 11, operationId: 'transport-21', actionType: 'UPDATE_TRANSPORT', fromStatus: 'LOADING', toStatus: 'LOADING', beforeSnapshot: null, afterSnapshot: null, operatorId: 22, operatorName: '操作员', operationReason: '调整', occurredAt: '2026-08-10T11:00:00' }],
 }
@@ -108,18 +108,20 @@ describe('platform loading lists API', () => {
     expect(loaded.summary.status).toBe('COMPLETED')
   })
 
-  it('updates one item warehouse remark with both optimistic-lock versions and operation id', async () => {
-    const patch = vi.spyOn(http, 'patch').mockResolvedValue({ code: '200', message: 'ok', data: { id: 100, version: 4, items: [{ id: 11, warehouseRemark: '装柜时注意外箱', version: 5 }] } })
-    const result = await updateLoadingItemWarehouseRemark('100', '11', {
+  it('updates one item editable remarks with both optimistic-lock versions and operation id', async () => {
+    const patch = vi.spyOn(http, 'patch').mockResolvedValue({ code: '200', message: 'ok', data: { id: 100, version: 4, items: [{ id: 11, internalRemark: '内部', warehouseRemark: '装柜时注意外箱', customerServiceRemark: '客服', version: 5 }] } })
+    const result = await updateLoadingItemRemarks('100', '11', {
+      internalRemark: '内部',
       warehouseRemark: '装柜时注意外箱',
+      customerServiceRemark: '客服',
       expectedPlanVersion: 3,
       expectedItemVersion: 4,
       operationId: 'warehouse-remark-1',
     })
 
     expect(patch).toHaveBeenCalledWith(
-      '/platform/v1/first-leg/smart-loading/plans/100/items/11/warehouse-remark',
-      { warehouseRemark: '装柜时注意外箱', expectedPlanVersion: 3, expectedItemVersion: 4, operationId: 'warehouse-remark-1' },
+      '/platform/v1/first-leg/smart-loading/plans/100/items/11/remarks',
+      { internalRemark: '内部', warehouseRemark: '装柜时注意外箱', customerServiceRemark: '客服', expectedPlanVersion: 3, expectedItemVersion: 4, operationId: 'warehouse-remark-1' },
     )
     expect(result).toMatchObject({ id: '100', version: 4, items: [{ id: '11', version: 5, warehouseRemark: '装柜时注意外箱' }] })
   })

src/modules/loading-lists/api/platformLoadingLists.ts

@@ -111,6 +111,7 @@ export interface LoadingItem {
   internalRemark: string | null
   customerRemark: string | null
   warehouseRemark: string | null
+  customerServiceRemark: string | null
   loadSequence: number
   frozenAt: string | null
 }
@@ -161,17 +162,19 @@ export interface TransportUpdateRequest {
   operationReason: string | null
 }
 
-export interface WarehouseRemarkUpdateRequest {
+export interface LoadingItemRemarksUpdateRequest {
+  internalRemark: string | null
   warehouseRemark: string | null
+  customerServiceRemark: string | null
   expectedPlanVersion: number
   expectedItemVersion: number
   operationId: string
 }
 
-export interface WarehouseRemarkUpdateResponse {
+export interface LoadingItemRemarksUpdateResponse {
   id: string
   version: number
-  items: Array<{ id: string; version: number; warehouseRemark: string | null }>
+  items: Array<{ id: string; version: number; internalRemark: string | null; warehouseRemark: string | null; customerServiceRemark: string | null }>
 }
 
 export interface PreloadConfirmationResponse {
@@ -342,9 +345,9 @@ export async function updatePreloadTransport(planId: string, warehouseId: string
   }
 }
 
-export async function updateLoadingItemWarehouseRemark(planId: string, itemId: string, request: WarehouseRemarkUpdateRequest) {
-  const response = await http.patch<ApiEnvelope<WarehouseRemarkUpdateResponse>, ApiEnvelope<WarehouseRemarkUpdateResponse>>(
-    `${basePath}/smart-loading/plans/${encodeURIComponent(planId)}/items/${encodeURIComponent(itemId)}/warehouse-remark`,
+export async function updateLoadingItemRemarks(planId: string, itemId: string, request: LoadingItemRemarksUpdateRequest) {
+  const response = await http.patch<ApiEnvelope<LoadingItemRemarksUpdateResponse>, ApiEnvelope<LoadingItemRemarksUpdateResponse>>(
+    `${basePath}/smart-loading/plans/${encodeURIComponent(planId)}/items/${encodeURIComponent(itemId)}/remarks`,
     request,
   )
   const result = unwrapApiResponse(response)