DeXun/klp-oa
9
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

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

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

108
klp-crm/src/main/java/com/klp/crm/domain/bo/CrmSalesReportBo.java Normal file
View File

@@ -0,0 +1,108 @@
package com.klp.crm.domain.bo;
import java.util.Date;
import java.util.List;
import com.fasterxml.jackson.annotation.JsonFormat;
import com.klp.common.core.validate.AddGroup;
import com.klp.common.core.validate.EditGroup;
import lombok.Data;
import lombok.EqualsAndHashCode;
import javax.validation.constraints.*;
/**
* 销售报表查询业务对象
*
* @author klp
* @date 2025-12-29
*/
@Data
@EqualsAndHashCode(callSuper = false)
public class CrmSalesReportBo {
/**
* 开始时间
*/
@JsonFormat(pattern = "yyyy-MM-dd")
private Date startTime;
/**
* 结束时间
*/
@JsonFormat(pattern = "yyyy-MM-dd")
private Date endTime;
/**
* 销售员列表
*/
private List<String> salesmanList;
/**
* 客户ID列表
*/
private List<String> customerIdList;
/**
* 客户等级列表
*/
private List<String> customerLevelList;
/**
* 行业列表
*/
private List<String> industryList;
/**
* 订单状态列表
*/
private List<Long> orderStatusList;
/**
* 财务状态列表
*/
private List<Long> financeStatusList;
/**
* 订单类型列表
*/
private List<Long> orderTypeList;
/**
* 最小订单金额
*/
private java.math.BigDecimal minOrderAmount;
/**
* 最大订单金额
*/
private java.math.BigDecimal maxOrderAmount;
/**
* 是否包含异议订单
*/
private Boolean includeObjectionOrders;
/**
* 是否只查询有未结款的订单
*/
private Boolean onlyUnpaidOrders;
/**
* 公司名称关键字
*/
private String companyNameKeyword;
/**
* 订单编号关键字
*/
private String orderCodeKeyword;
/**
* 排序字段
*/
private String orderBy;
/**
* 排序方向 ASC/DESC
*/
private String sortDirection;
}

287
klp-crm/src/main/java/com/klp/crm/domain/vo/CrmSalesReportVo.java Normal file
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;
}
}