部分dto、vo

This commit is contained in:
2025-12-05 11:05:27 +08:00
parent 9a3547b70b
commit 917e9a517a
42 changed files with 2803 additions and 67 deletions

View File

@@ -0,0 +1,9 @@
package org.xyzh.api.workcase;
/**
* 工单服务接口
* 用于客服工单管理
*/
public interface WorkcaseService {
}

View File

@@ -0,0 +1,71 @@
package org.xyzh.api.workcase.dto;
import lombok.Data;
import lombok.EqualsAndHashCode;
import org.xyzh.common.dto.BaseDTO;
import io.swagger.v3.oas.annotations.media.Schema;
import com.alibaba.fastjson2.annotation.JSONField;
import com.fasterxml.jackson.databind.JsonNode;
import java.util.Date;
import java.util.List;
/**
* 会话DTO
* 用于创建和更新会话
*/
@Data
@EqualsAndHashCode(callSuper = true)
@Schema(description = "会话DTO")
public class TbConversationDTO extends BaseDTO {
private static final long serialVersionUID = 1L;
@Schema(description = "会话ID更新时需要")
private String conversationId;
@Schema(description = "客户ID")
private String customerId;
@Schema(description = "会话类型ai-AI客服/human-人工客服/transfer-转接", defaultValue = "ai")
private String conversationType;
@Schema(description = "渠道wechat-微信/web-网页/app-应用/phone-电话", defaultValue = "wechat")
private String channel;
@Schema(description = "智能体ID或客服人员ID")
private String agentId;
@Schema(description = "座席类型ai-AI/human-人工", defaultValue = "ai")
private String agentType;
@Schema(description = "会话开始时间", format = "date-time")
@JSONField(format = "yyyy-MM-dd HH:mm:ss")
private Date sessionStartTime;
@Schema(description = "会话结束时间", format = "date-time")
@JSONField(format = "yyyy-MM-dd HH:mm:ss")
private Date sessionEndTime;
@Schema(description = "会话时长(秒)")
private Integer durationSeconds;
@Schema(description = "消息数量", defaultValue = "0")
private Integer messageCount;
@Schema(description = "会话状态active-进行中/closed-已结束/transferred-已转接/timeout-超时", defaultValue = "active")
private String conversationStatus;
@Schema(description = "满意度评分1-5星")
private Integer satisfactionRating;
@Schema(description = "满意度反馈")
private String satisfactionFeedback;
@Schema(description = "会话摘要AI生成")
private String summary;
@Schema(description = "会话标签")
private List<String> tags;
@Schema(description = "会话元数据")
private JsonNode metadata;
}

View File

@@ -0,0 +1,91 @@
package org.xyzh.api.workcase.dto;
import lombok.Data;
import lombok.EqualsAndHashCode;
import org.xyzh.common.dto.BaseDTO;
import io.swagger.v3.oas.annotations.media.Schema;
import com.alibaba.fastjson2.annotation.JSONField;
import java.math.BigDecimal;
import java.util.Date;
import java.util.List;
/**
* 客户信息DTO
* 用于创建和更新客户信息
*/
@Data
@EqualsAndHashCode(callSuper = true)
@Schema(description = "客户信息DTO")
public class TbCustomerDTO extends BaseDTO {
private static final long serialVersionUID = 1L;
@Schema(description = "客户ID更新时需要")
private String customerId;
@Schema(description = "客户编号")
private String customerNo;
@Schema(description = "客户姓名")
private String customerName;
@Schema(description = "客户类型individual-个人/enterprise-企业", defaultValue = "individual")
private String customerType;
@Schema(description = "公司名称")
private String companyName;
@Schema(description = "电话")
private String phone;
@Schema(description = "邮箱")
private String email;
@Schema(description = "微信OpenID")
private String wechatOpenid;
@Schema(description = "微信UnionID")
private String wechatUnionid;
@Schema(description = "头像URL")
private String avatar;
@Schema(description = "性别0-未知/1-男/2-女", defaultValue = "0")
private Integer gender;
@Schema(description = "地址")
private String address;
@Schema(description = "客户等级vip/important/normal/potential", defaultValue = "normal")
private String customerLevel;
@Schema(description = "客户来源wechat-微信/web-网站/phone-电话/referral-推荐")
private String customerSource;
@Schema(description = "客户标签数组")
private List<String> tags;
@Schema(description = "备注")
private String notes;
@Schema(description = "CRM系统客户ID")
private String crmCustomerId;
@Schema(description = "最后联系时间", format = "date-time")
@JSONField(format = "yyyy-MM-dd HH:mm:ss")
private Date lastContactTime;
@Schema(description = "咨询总次数", defaultValue = "0")
private Integer totalConsultations;
@Schema(description = "订单总数", defaultValue = "0")
private Integer totalOrders;
@Schema(description = "总消费金额", defaultValue = "0")
private BigDecimal totalAmount;
@Schema(description = "满意度评分1-5")
private BigDecimal satisfactionScore;
@Schema(description = "状态active-活跃/inactive-非活跃/blacklist-黑名单", defaultValue = "active")
private String status;
}

View File

@@ -0,0 +1,103 @@
package org.xyzh.api.workcase.dto;
import lombok.Data;
import lombok.EqualsAndHashCode;
import org.xyzh.common.dto.BaseDTO;
import io.swagger.v3.oas.annotations.media.Schema;
import com.alibaba.fastjson2.annotation.JSONField;
import com.fasterxml.jackson.databind.JsonNode;
import java.util.Date;
import java.util.List;
/**
* 工单DTO
* 用于创建和更新工单
*/
@Data
@EqualsAndHashCode(callSuper = true)
@Schema(description = "工单DTO")
public class TbTicketDTO extends BaseDTO {
private static final long serialVersionUID = 1L;
@Schema(description = "工单ID更新时需要")
private String ticketId;
@Schema(description = "工单编号")
private String ticketNo;
@Schema(description = "客户ID")
private String customerId;
@Schema(description = "关联会话ID")
private String conversationId;
@Schema(description = "工单类型consultation-咨询/complaint-投诉/suggestion-建议/repair-维修/installation-安装/other-其他")
private String ticketType;
@Schema(description = "工单分类")
private String ticketCategory;
@Schema(description = "优先级urgent-紧急/high-高/normal-普通/low-低", defaultValue = "normal")
private String priority;
@Schema(description = "工单标题")
private String title;
@Schema(description = "问题描述")
private String description;
@Schema(description = "附件ID数组")
private List<String> attachments;
@Schema(description = "工单来源ai-AI生成/manual-人工创建/system-系统自动", defaultValue = "ai")
private String ticketSource;
@Schema(description = "分配给(处理人)")
private String assignedTo;
@Schema(description = "分配部门")
private String assignedDept;
@Schema(description = "工单状态pending-待处理/processing-处理中/resolved-已解决/closed-已关闭/cancelled-已取消", defaultValue = "pending")
private String ticketStatus;
@Schema(description = "解决方案")
private String resolution;
@Schema(description = "解决时间", format = "date-time")
@JSONField(format = "yyyy-MM-dd HH:mm:ss")
private Date resolutionTime;
@Schema(description = "关闭时间", format = "date-time")
@JSONField(format = "yyyy-MM-dd HH:mm:ss")
private Date closeTime;
@Schema(description = "首次响应时间", format = "date-time")
@JSONField(format = "yyyy-MM-dd HH:mm:ss")
private Date responseTime;
@Schema(description = "SLA截止时间", format = "date-time")
@JSONField(format = "yyyy-MM-dd HH:mm:ss")
private Date slaDeadline;
@Schema(description = "是否逾期", defaultValue = "false")
private Boolean isOverdue;
@Schema(description = "客户评分1-5星")
private Integer customerRating;
@Schema(description = "客户反馈")
private String customerFeedback;
@Schema(description = "CRM系统工单ID")
private String crmTicketId;
@Schema(description = "同步状态pending-待同步/synced-已同步/failed-失败", defaultValue = "pending")
private String syncStatus;
@Schema(description = "工单标签")
private List<String> tags;
@Schema(description = "工单元数据")
private JsonNode metadata;
}

View File

@@ -0,0 +1,108 @@
package org.xyzh.api.workcase.vo;
import lombok.Data;
import lombok.EqualsAndHashCode;
import org.xyzh.common.vo.BaseVO;
import io.swagger.v3.oas.annotations.media.Schema;
import com.alibaba.fastjson2.annotation.JSONField;
import com.fasterxml.jackson.databind.JsonNode;
import java.util.Date;
import java.util.List;
/**
* 会话VO
* 用于前端展示会话信息
*/
@Data
@EqualsAndHashCode(callSuper = true)
@Schema(description = "会话VO")
public class ConversationVO extends BaseVO {
private static final long serialVersionUID = 1L;
@Schema(description = "会话ID")
private String conversationId;
@Schema(description = "客户ID")
private String customerId;
@Schema(description = "客户姓名")
private String customerName;
@Schema(description = "客户头像")
private String customerAvatar;
@Schema(description = "会话类型")
private String conversationType;
@Schema(description = "会话类型名称")
private String conversationTypeName;
@Schema(description = "渠道")
private String channel;
@Schema(description = "渠道名称")
private String channelName;
@Schema(description = "智能体ID或客服人员ID")
private String agentId;
@Schema(description = "座席名称")
private String agentName;
@Schema(description = "座席类型")
private String agentType;
@Schema(description = "座席类型名称")
private String agentTypeName;
@Schema(description = "会话开始时间", format = "date-time")
@JSONField(format = "yyyy-MM-dd HH:mm:ss")
private Date sessionStartTime;
@Schema(description = "会话结束时间", format = "date-time")
@JSONField(format = "yyyy-MM-dd HH:mm:ss")
private Date sessionEndTime;
@Schema(description = "会话时长(秒)")
private Integer durationSeconds;
@Schema(description = "会话时长格式化显示")
private String durationFormatted;
@Schema(description = "消息数量")
private Integer messageCount;
@Schema(description = "会话状态")
private String conversationStatus;
@Schema(description = "会话状态名称")
private String conversationStatusName;
@Schema(description = "会话状态颜色")
private String statusColor;
@Schema(description = "满意度评分1-5星")
private Integer satisfactionRating;
@Schema(description = "满意度反馈")
private String satisfactionFeedback;
@Schema(description = "会话摘要")
private String summary;
@Schema(description = "会话标签")
private List<String> tags;
@Schema(description = "会话元数据")
private JsonNode metadata;
@Schema(description = "最后一条消息内容")
private String lastMessageContent;
@Schema(description = "最后一条消息时间", format = "date-time")
@JSONField(format = "yyyy-MM-dd HH:mm:ss")
private Date lastMessageTime;
@Schema(description = "创建者姓名")
private String creatorName;
}

View File

@@ -0,0 +1,112 @@
package org.xyzh.api.workcase.vo;
import lombok.Data;
import lombok.EqualsAndHashCode;
import org.xyzh.common.vo.BaseVO;
import io.swagger.v3.oas.annotations.media.Schema;
import com.alibaba.fastjson2.annotation.JSONField;
import java.math.BigDecimal;
import java.util.Date;
import java.util.List;
/**
* 客户信息VO
* 用于前端展示客户信息
*/
@Data
@EqualsAndHashCode(callSuper = true)
@Schema(description = "客户信息VO")
public class CustomerVO extends BaseVO {
private static final long serialVersionUID = 1L;
@Schema(description = "客户ID")
private String customerId;
@Schema(description = "客户编号")
private String customerNo;
@Schema(description = "客户姓名")
private String customerName;
@Schema(description = "客户类型")
private String customerType;
@Schema(description = "客户类型名称")
private String customerTypeName;
@Schema(description = "公司名称")
private String companyName;
@Schema(description = "电话")
private String phone;
@Schema(description = "邮箱")
private String email;
@Schema(description = "微信OpenID")
private String wechatOpenid;
@Schema(description = "头像URL")
private String avatar;
@Schema(description = "性别")
private Integer gender;
@Schema(description = "性别名称")
private String genderName;
@Schema(description = "地址")
private String address;
@Schema(description = "客户等级")
private String customerLevel;
@Schema(description = "客户等级名称")
private String customerLevelName;
@Schema(description = "客户来源")
private String customerSource;
@Schema(description = "客户来源名称")
private String customerSourceName;
@Schema(description = "客户标签")
private List<String> tags;
@Schema(description = "备注")
private String notes;
@Schema(description = "CRM系统客户ID")
private String crmCustomerId;
@Schema(description = "最后联系时间", format = "date-time")
@JSONField(format = "yyyy-MM-dd HH:mm:ss")
private Date lastContactTime;
@Schema(description = "咨询总次数")
private Integer totalConsultations;
@Schema(description = "订单总数")
private Integer totalOrders;
@Schema(description = "总消费金额")
private BigDecimal totalAmount;
@Schema(description = "满意度评分")
private BigDecimal satisfactionScore;
@Schema(description = "状态")
private String status;
@Schema(description = "状态名称")
private String statusName;
@Schema(description = "状态颜色")
private String statusColor;
@Schema(description = "创建者姓名")
private String creatorName;
@Schema(description = "更新者姓名")
private String updaterName;
}

View File

@@ -0,0 +1,59 @@
package org.xyzh.api.workcase.vo;
import lombok.Data;
import lombok.EqualsAndHashCode;
import org.xyzh.common.vo.BaseVO;
import io.swagger.v3.oas.annotations.media.Schema;
import com.alibaba.fastjson2.annotation.JSONField;
import java.util.Date;
/**
* 工单列表VO
* 用于前端列表展示(简化版)
*/
@Data
@EqualsAndHashCode(callSuper = true)
@Schema(description = "工单列表VO")
public class TicketListVO extends BaseVO {
private static final long serialVersionUID = 1L;
@Schema(description = "工单ID")
private String ticketId;
@Schema(description = "工单编号")
private String ticketNo;
@Schema(description = "客户姓名")
private String customerName;
@Schema(description = "工单标题")
private String title;
@Schema(description = "工单类型名称")
private String ticketTypeName;
@Schema(description = "优先级")
private String priority;
@Schema(description = "优先级名称")
private String priorityName;
@Schema(description = "工单状态")
private String ticketStatus;
@Schema(description = "工单状态名称")
private String ticketStatusName;
@Schema(description = "处理人姓名")
private String assignedToName;
@Schema(description = "SLA截止时间", format = "date-time")
@JSONField(format = "yyyy-MM-dd HH:mm:ss")
private Date slaDeadline;
@Schema(description = "是否逾期", defaultValue = "false")
private Boolean isOverdue;
@Schema(description = "创建者姓名")
private String creatorName;
}

View File

@@ -0,0 +1,151 @@
package org.xyzh.api.workcase.vo;
import lombok.Data;
import lombok.EqualsAndHashCode;
import org.xyzh.common.vo.BaseVO;
import io.swagger.v3.oas.annotations.media.Schema;
import com.alibaba.fastjson2.annotation.JSONField;
import com.fasterxml.jackson.databind.JsonNode;
import java.util.Date;
import java.util.List;
/**
* 工单VO
* 用于前端展示工单信息
*/
@Data
@EqualsAndHashCode(callSuper = true)
@Schema(description = "工单VO")
public class TicketVO extends BaseVO {
private static final long serialVersionUID = 1L;
@Schema(description = "工单ID")
private String ticketId;
@Schema(description = "工单编号")
private String ticketNo;
@Schema(description = "客户ID")
private String customerId;
@Schema(description = "客户姓名")
private String customerName;
@Schema(description = "客户电话")
private String customerPhone;
@Schema(description = "关联会话ID")
private String conversationId;
@Schema(description = "工单类型")
private String ticketType;
@Schema(description = "工单类型名称")
private String ticketTypeName;
@Schema(description = "工单分类")
private String ticketCategory;
@Schema(description = "优先级")
private String priority;
@Schema(description = "优先级名称")
private String priorityName;
@Schema(description = "优先级颜色")
private String priorityColor;
@Schema(description = "工单标题")
private String title;
@Schema(description = "问题描述")
private String description;
@Schema(description = "附件ID数组")
private List<String> attachments;
@Schema(description = "附件数量")
private Integer attachmentCount;
@Schema(description = "工单来源")
private String ticketSource;
@Schema(description = "工单来源名称")
private String ticketSourceName;
@Schema(description = "分配给处理人ID")
private String assignedTo;
@Schema(description = "处理人姓名")
private String assignedToName;
@Schema(description = "分配部门")
private String assignedDept;
@Schema(description = "分配部门名称")
private String assignedDeptName;
@Schema(description = "工单状态")
private String ticketStatus;
@Schema(description = "工单状态名称")
private String ticketStatusName;
@Schema(description = "工单状态颜色")
private String statusColor;
@Schema(description = "解决方案")
private String resolution;
@Schema(description = "解决时间", format = "date-time")
@JSONField(format = "yyyy-MM-dd HH:mm:ss")
private Date resolutionTime;
@Schema(description = "关闭时间", format = "date-time")
@JSONField(format = "yyyy-MM-dd HH:mm:ss")
private Date closeTime;
@Schema(description = "首次响应时间", format = "date-time")
@JSONField(format = "yyyy-MM-dd HH:mm:ss")
private Date responseTime;
@Schema(description = "SLA截止时间", format = "date-time")
@JSONField(format = "yyyy-MM-dd HH:mm:ss")
private Date slaDeadline;
@Schema(description = "是否逾期", defaultValue = "false")
private Boolean isOverdue;
@Schema(description = "距离SLA截止的剩余时间分钟")
private Integer slaRemainingMinutes;
@Schema(description = "客户评分1-5星")
private Integer customerRating;
@Schema(description = "客户反馈")
private String customerFeedback;
@Schema(description = "CRM系统工单ID")
private String crmTicketId;
@Schema(description = "同步状态")
private String syncStatus;
@Schema(description = "同步状态名称")
private String syncStatusName;
@Schema(description = "工单标签")
private List<String> tags;
@Schema(description = "工单元数据")
private JsonNode metadata;
@Schema(description = "处理记录数量")
private Integer logCount;
@Schema(description = "创建者姓名")
private String creatorName;
@Schema(description = "更新者姓名")
private String updaterName;
}