From abe6d3f6681b29623f9e01a7e9bf3a0119a600e2 Mon Sep 17 00:00:00 2001 From: liufumingren Date: Mon, 10 Aug 2026 04:40:36 +0800 Subject: [PATCH] =?UTF-8?q?feat(afterSale):=20=E5=94=AE=E5=90=8E=E6=A8=A1?= =?UTF-8?q?=E5=9D=97V2=20-=20=E5=B7=A5=E5=8D=95=E5=85=A5=E5=8F=A3=E3=80=81?= =?UTF-8?q?=E5=8F=91=E8=B5=B7=E5=94=AE=E5=90=8E=E3=80=81=E8=AE=A2=E5=8D=95?= =?UTF-8?q?=E5=BF=AB=E9=80=9F=E6=90=9C=E7=B4=A2?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 新增售后API层(afterSale.workList/detail/create/update/transfer/handleWorkOrder/registerClaim/export/workCount/quickSearch) - 消息中心改为工单入口(/workorder),支持ScanBox+UpperTable筛选列表 - Navbar工单角标(每60s轮询afterSale.workCount) - 新增发起售后单弹窗(关联单据按类型动态切换、货主下拉、订单快速搜索) - 订单搜索使用order.deliveryOrder.quickSearch跨表联合搜索 - DocSearchPicker通用单据搜索组件 - 售后明细页增加附件上传(handleWorkOrder/registerClaim) - 移除已废弃的workOrder页面、下载入口、LangSelect图标 - 修复where字段camelCase/snake_case不一致问题 --- new3.code-workspace | 8 +- src/api/afterSale/index.ts | 334 +++++++ .../order.deliveryOrder/orderdeliveryOrder.ts | 17 +- src/components/LangSelect/index.vue | 5 - src/layout/component/Navbar.vue | 60 +- src/router/index.ts | 6 +- src/views/afterSale/detail/index.vue | 842 ++++++++++++++++++ src/views/afterSale/list/afterSale-config.ts | 264 ++++++ src/views/afterSale/list/index.vue | 716 +++++++++++++++ .../components/CreateAfterSaleDialog.vue | 391 ++++++++ .../message/components/DocSearchPicker.vue | 197 ++++ src/views/message/index.vue | 376 +++++++- 12 files changed, 3186 insertions(+), 30 deletions(-) create mode 100644 src/api/afterSale/index.ts create mode 100644 src/views/afterSale/detail/index.vue create mode 100644 src/views/afterSale/list/afterSale-config.ts create mode 100644 src/views/afterSale/list/index.vue create mode 100644 src/views/message/components/CreateAfterSaleDialog.vue create mode 100644 src/views/message/components/DocSearchPicker.vue diff --git a/new3.code-workspace b/new3.code-workspace index 876a1499..644fa1a4 100644 --- a/new3.code-workspace +++ b/new3.code-workspace @@ -1,8 +1,12 @@ { "folders": [ { - "path": "." + "path": ".", + "name": "WEB (WMS前端)" } ], - "settings": {} + "settings": { + "git.autoRepositoryDetection": "subFolders", + "git.repositoryScanMaxDepth": 1 + } } \ No newline at end of file diff --git a/src/api/afterSale/index.ts b/src/api/afterSale/index.ts new file mode 100644 index 00000000..87e58597 --- /dev/null +++ b/src/api/afterSale/index.ts @@ -0,0 +1,334 @@ +import request from '@/utils/request' + +const v = '1.0' + +// ============================================================ +// 售后模块 V2 API +// ============================================================ + +// ==================== 类型定义 ==================== + +/** 售后类型 */ +export type AfterSaleType = 'order' | 'receiving' | 'entry' | 'stockout' + +/** 售后状态 */ +export type AfterSaleStatus = 'pending' | 'processing' | 'completed' | 'closed' | 'cancelled' + +/** 角色组 */ +export type AfterSaleRoleGroup = 'customer_service' | 'warehouse' | 'finance' + +/** 理赔状态 */ +export type ClaimStatus = 'pending' | 'reviewing' | 'approved' | 'paid' | 'monthly' | 'rejected' + +/** 步骤状态: 0=待开始 1=进行中 2=已完成 3=已跳过 */ +export type StepStatus = 0 | 1 | 2 | 3 + +/** 售后单对象 */ +export interface AfterSale { + id: number + warehouse_id: number + store_id: number | null + after_sale_no: string + type: AfterSaleType + sub_type: string + status: AfterSaleStatus + priority: number + title: string + description: string | null + creator_id: number + inbox_message_id: number | null + role_group: AfterSaleRoleGroup | null + resolution: string | null + resolved_at: string | null + + // 仓库理赔 + claim_needed: 0 | 1 + claim_amount: number | null + claim_status: ClaimStatus | null + + // 运方理赔 + carrier_claim_needed: 0 | 1 + carrier_claim_amount: number | null + carrier_claim_status: ClaimStatus | null + + // 关联单据 + waybill_id: number | null + waybill_no: string | null + order_delivery_id: number | null + order_delivery_no: string | null + entry_order_id: number | null + entry_order_no: string | null + order_stockout_id: number | null + order_stockout_no: string | null + receiving_id: number | null + receiving_no: string | null + + created_at: string + updated_at: string +} + +/** 售后步骤对象 */ +export interface AfterSaleStep { + id: number + after_sale_id: number + step_status: StepStatus + operator_id: number | null + operator_snapshot: string | null + action: string | null + remark: string | null + started_at: string | null + completed_at: string | null + created_at: string + attachments: FileReference[] +} + +/** 文件引用 */ +export interface FileReference { + file_id: number + file_name?: string + file_url?: string +} + +// ==================== 请求参数类型 ==================== + +/** 列表查询参数 */ +export interface AfterSaleListParams { + pagination?: { page?: number; pageSize?: number } + where?: Record + sort?: { sortField?: string; sortOrder?: 'asc' | 'desc' | 'ASC' | 'DESC' } +} + +/** 创建售后单参数 */ +export interface AfterSaleCreateParams { + type: AfterSaleType + sub_type: string + title: string + description?: string + priority?: number + store_id?: number + waybill_id?: number + order_id?: number + order_delivery_no?: string + entry_order_id?: number + entry_order_no?: string + order_stockout_id?: number + order_stockout_no?: string + receiving_id?: number + receiving_no?: string +} + +/** 更新售后单参数 */ +export interface AfterSaleUpdateParams extends Partial { + id: number +} + +/** 转单参数 */ +export interface AfterSaleTransferParams { + id: number + role_group: AfterSaleRoleGroup + remark?: string +} + +/** 处理工单参数 */ +export interface AfterSaleHandleWorkOrderParams { + id: number + action: string + status?: AfterSaleStatus + remark?: string + attachment_ids?: number[] +} + +/** 登记理赔参数 */ +export interface AfterSaleRegisterClaimParams { + id: number + // 仓库理赔 + claim_needed?: 0 | 1 + claim_amount?: number + claim_status?: ClaimStatus + // 运方理赔 + carrier_claim_needed?: 0 | 1 + carrier_claim_amount?: number + carrier_claim_status?: ClaimStatus + // 步骤 + action: string + remark?: string + attachment_ids?: number[] +} + +/** 导出参数 */ +export interface AfterSaleExportParams { + where?: Record + sort?: { sortField?: string; sortOrder?: 'asc' | 'desc' } +} + +/** 导出进度查询参数 */ +export interface AfterSaleExportTaskProgressParams { + task_id: string +} + +// ==================== API 方法 ==================== + +/** 2.1 工作列表 afterSale.workList */ +export function afterSaleWorkList(data: AfterSaleListParams = {}) { + return request({ + url: '/system', + method: 'post', + params: { + method: 'afterSale.workList', + v, + timestamp: Date.now() + }, + data, + isSystemApi: true + } as any) +} + +/** 2.2 审计列表 afterSale.auditList */ +export function afterSaleAuditList(data: AfterSaleListParams = {}) { + return request({ + url: '/system', + method: 'post', + params: { + method: 'afterSale.auditList', + v, + timestamp: Date.now() + }, + data, + isSystemApi: true + } as any) +} + +/** 2.3 售后明细 afterSale.detail */ +export function afterSaleDetail(id: number) { + return request({ + url: '/system', + method: 'post', + params: { + method: 'afterSale.detail', + v, + timestamp: Date.now() + }, + data: { id }, + isSystemApi: true + } as any) +} + +/** 2.4 创建售后单 afterSale.create */ +export function afterSaleCreate(data: AfterSaleCreateParams) { + return request({ + url: '/system', + method: 'post', + params: { + method: 'afterSale.create', + v, + timestamp: Date.now() + }, + data, + isSystemApi: true + } as any) +} + +/** 2.5 更新售后单 afterSale.update */ +export function afterSaleUpdate(data: AfterSaleUpdateParams) { + return request({ + url: '/system', + method: 'post', + params: { + method: 'afterSale.update', + v, + timestamp: Date.now() + }, + data, + isSystemApi: true + } as any) +} + +/** 2.6 转单 afterSale.transfer */ +export function afterSaleTransfer(data: AfterSaleTransferParams) { + return request({ + url: '/system', + method: 'post', + params: { + method: 'afterSale.transfer', + v, + timestamp: Date.now() + }, + data, + isSystemApi: true + } as any) +} + +/** 2.7 处理工单 afterSale.handleWorkOrder */ +export function afterSaleHandleWorkOrder(data: AfterSaleHandleWorkOrderParams) { + return request({ + url: '/system', + method: 'post', + params: { + method: 'afterSale.handleWorkOrder', + v, + timestamp: Date.now() + }, + data, + isSystemApi: true + } as any) +} + +/** 2.8 登记理赔 afterSale.registerClaim */ +export function afterSaleRegisterClaim(data: AfterSaleRegisterClaimParams) { + return request({ + url: '/system', + method: 'post', + params: { + method: 'afterSale.registerClaim', + v, + timestamp: Date.now() + }, + data, + isSystemApi: true + } as any) +} + +/** 2.9 导出 afterSale.export */ +export function afterSaleExport(data: AfterSaleExportParams = {}) { + return request({ + url: '/system', + method: 'post', + params: { + method: 'afterSale.export', + v, + timestamp: Date.now() + }, + data, + isSystemApi: true + } as any) +} + +/** 2.10 导出进度 afterSale.exportTaskProgress */ +export function afterSaleExportTaskProgress(data: AfterSaleExportTaskProgressParams) { + return request({ + url: '/system', + method: 'post', + params: { + method: 'afterSale.exportTaskProgress', + v, + timestamp: Date.now() + }, + data, + isSystemApi: true + } as any) +} + +/** 2.11 角标快速查询 afterSale.workCount */ +export function afterSaleWorkCount(): Promise { + return request({ + url: '/system', + method: 'post', + params: { + method: 'afterSale.workCount', + v, + timestamp: Date.now() + }, + data: {}, + isSystemApi: true + } as any) +} diff --git a/src/api/order.deliveryOrder/orderdeliveryOrder.ts b/src/api/order.deliveryOrder/orderdeliveryOrder.ts index 7051ba20..769bd05c 100644 --- a/src/api/order.deliveryOrder/orderdeliveryOrder.ts +++ b/src/api/order.deliveryOrder/orderdeliveryOrder.ts @@ -233,7 +233,22 @@ export function orderDeliveryOrderDetail(data: DeliveryOrderDetailParams): Promi } as any) } +export function orderDeliveryOrderQuickSearch(keyword: string): Promise { + return request({ + url: '/system', + method: 'post', + params: { + method: 'order.deliveryOrder.quickSearch', + v, + timestamp: Date.now() + }, + data: { keyword }, + isSystemApi: true + } as any) +} + export const orderDeliveryOrder = { list: orderDeliveryOrderList, - detail: orderDeliveryOrderDetail + detail: orderDeliveryOrderDetail, + quickSearch: orderDeliveryOrderQuickSearch, } diff --git a/src/components/LangSelect/index.vue b/src/components/LangSelect/index.vue index 83dc4f0e..a4ab08f0 100644 --- a/src/components/LangSelect/index.vue +++ b/src/components/LangSelect/index.vue @@ -1,7 +1,6 @@