feat(crm): 添加销售报表功能模块

- 新增销售报表查询业务对象CrmSalesReportBo,支持多种查询条件
- 创建销售报表控制器CrmSalesReportController,提供汇总数据、订单明细、统计分析等接口
- 实现销售报表数据访问层CrmSalesReportMapper,包含销售汇总、订单明细、销售员统计等查询
- 开发销售报表服务层ICrmSalesReportService及其实现类,处理报表数据逻辑
- 设计销售报表视图对象CrmSalesReportVo,包含汇总信息、订单明细、统计分析等数据结构
- 集成Excel导出功能,支持订单明细、销售员统计、客户等级统计、行业统计的数据导出
- 实现多维度统计分析,包括销售员业绩、客户等级分布、行业分布等统计功能
This commit is contained in:
2025-12-29 10:05:05 +08:00
parent 96b6e844d9
commit 11c21f2a33
7 changed files with 954 additions and 0 deletions

View File

@@ -0,0 +1,287 @@
package com.klp.crm.domain.vo;
import java.math.BigDecimal;
import java.util.Date;
import java.util.List;
import com.fasterxml.jackson.annotation.JsonFormat;
import com.alibaba.excel.annotation.ExcelIgnoreUnannotated;
import com.alibaba.excel.annotation.ExcelProperty;
import lombok.Data;
/**
* 销售报表视图对象
*
* @author klp
* @date 2025-12-29
*/
@Data
@ExcelIgnoreUnannotated
public class CrmSalesReportVo {
private static final long serialVersionUID = 1L;
/**
* 销售汇总信息
*/
private SalesSummary salesSummary;
/**
* 订单明细列表
*/
private List<OrderDetail> orderDetails;
/**
* 销售汇总内部类
*/
@Data
public static class SalesSummary {
/**
* 总订单数
*/
@ExcelProperty(value = "总订单数")
private Integer totalOrderCount;
/**
* 总销售金额
*/
@ExcelProperty(value = "总销售金额")
private BigDecimal totalSalesAmount;
/**
* 已完成订单数
*/
@ExcelProperty(value = "已完成订单数")
private Integer completedOrderCount;
/**
* 已完成销售金额
*/
@ExcelProperty(value = "已完成销售金额")
private BigDecimal completedSalesAmount;
/**
* 未结款总金额
*/
@ExcelProperty(value = "未结款总金额")
private BigDecimal totalUnpaidAmount;
/**
* 平均订单金额
*/
@ExcelProperty(value = "平均订单金额")
private BigDecimal avgOrderAmount;
/**
* 销售员统计
*/
private List<SalesmanStat> salesmanStats;
/**
* 客户等级统计
*/
private List<CustomerLevelStat> customerLevelStats;
/**
* 行业统计
*/
private List<IndustryStat> industryStats;
}
/**
* 订单明细内部类
*/
@Data
public static class OrderDetail {
/**
* 订单ID
*/
private String orderId;
/**
* 订单编号
*/
@ExcelProperty(value = "订单编号")
private String orderCode;
/**
* 客户编码
*/
@ExcelProperty(value = "客户编码")
private String customerCode;
/**
* 公司名称
*/
@ExcelProperty(value = "公司名称")
private String companyName;
/**
* 联系人
*/
@ExcelProperty(value = "联系人")
private String contactPerson;
/**
* 客户等级
*/
@ExcelProperty(value = "客户等级")
private String customerLevel;
/**
* 所属行业
*/
@ExcelProperty(value = "所属行业")
private String industry;
/**
* 订单金额
*/
@ExcelProperty(value = "订单金额")
private BigDecimal orderAmount;
/**
* 销售员
*/
@ExcelProperty(value = "销售员")
private String salesman;
/**
* 交货日期
*/
@ExcelProperty(value = "交货日期")
@JsonFormat(pattern = "yyyy-MM-dd")
private Date deliveryDate;
/**
* 订单状态
*/
@ExcelProperty(value = "订单状态")
private Long orderStatus;
/**
* 财务状态
*/
@ExcelProperty(value = "财务状态")
private Long financeStatus;
/**
* 未结款金额
*/
@ExcelProperty(value = "未结款金额")
private BigDecimal unpaidAmount;
/**
* 创建时间
*/
@ExcelProperty(value = "创建时间")
@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss")
private Date createTime;
/**
* 产品明细数量
*/
@ExcelProperty(value = "产品明细数量")
private Integer itemCount;
/**
* 异议数量
*/
@ExcelProperty(value = "异议数量")
private Integer objectionCount;
}
/**
* 销售员统计内部类
*/
@Data
public static class SalesmanStat {
/**
* 销售员
*/
@ExcelProperty(value = "销售员")
private String salesman;
/**
* 订单数量
*/
@ExcelProperty(value = "订单数量")
private Integer orderCount;
/**
* 销售金额
*/
@ExcelProperty(value = "销售金额")
private BigDecimal salesAmount;
/**
* 占比
*/
@ExcelProperty(value = "占比(%)")
private BigDecimal percentage;
}
/**
* 客户等级统计内部类
*/
@Data
public static class CustomerLevelStat {
/**
* 客户等级
*/
@ExcelProperty(value = "客户等级")
private String customerLevel;
/**
* 客户数量
*/
@ExcelProperty(value = "客户数量")
private Integer customerCount;
/**
* 订单数量
*/
@ExcelProperty(value = "订单数量")
private Integer orderCount;
/**
* 销售金额
*/
@ExcelProperty(value = "销售金额")
private BigDecimal salesAmount;
}
/**
* 行业统计内部类
*/
@Data
public static class IndustryStat {
/**
* 行业
*/
@ExcelProperty(value = "行业")
private String industry;
/**
* 客户数量
*/
@ExcelProperty(value = "客户数量")
private Integer customerCount;
/**
* 订单数量
*/
@ExcelProperty(value = "订单数量")
private Integer orderCount;
/**
* 销售金额
*/
@ExcelProperty(value = "销售金额")
private BigDecimal salesAmount;
}
}