Browse Source
- 新增优惠券状态管理相关实体类字段和方法 - 实现优惠券状态自动更新和手动更新功能- 添加优惠券适用范围验证逻辑 - 新增优惠券状态查询和统计接口 - 优化数据库索引和查询性能main
13 changed files with 1681 additions and 14 deletions
@ -0,0 +1,173 @@ |
|||
# 优惠券状态管理页面错误修复总结 |
|||
|
|||
## 🐛 发现的问题 |
|||
|
|||
### 1. 代码结构错误 |
|||
**位置**: `ShopUserCouponController.java` 第70-84行 |
|||
**问题**: for循环结构不完整，缺少循环体的闭合大括号 |
|||
```java |
|||
// 错误的代码结构 |
|||
for (ShopUserCoupon userCoupon : userCouponList) { |
|||
couponStatusService.checkAndUpdateCouponStatus(userCoupon); |
|||
} |
|||
ShopCoupon coupon = couponService.getById(userCoupon.getCouponId()); // 这行代码在循环外 |
|||
``` |
|||
|
|||
### 2. 实体类字段缺失 |
|||
**位置**: `ShopCouponApplyItem.java` |
|||
**问题**: 缺少 `goodsId` 和 `categoryId` 字段，导致优惠券适用范围验证失败 |
|||
|
|||
### 3. 服务依赖注入缺失 |
|||
**位置**: `ShopUserCouponController.java` |
|||
**问题**: 缺少 `CouponStatusService` 的注入 |
|||
|
|||
## ✅ 修复内容 |
|||
|
|||
### 1. 修复控制器代码结构 |
|||
```java |
|||
// 修复后的正确代码 |
|||
for (ShopUserCoupon userCoupon : userCouponList) { |
|||
// 使用新的状态管理服务检查和更新状态 |
|||
couponStatusService.checkAndUpdateCouponStatus(userCoupon); |
|||
|
|||
ShopCoupon coupon = couponService.getById(userCoupon.getCouponId()); |
|||
coupon.setCouponApplyCateList(couponApplyCateService.list( |
|||
new LambdaQueryWrapper<ShopCouponApplyCate>() |
|||
.eq(ShopCouponApplyCate::getCouponId, userCoupon.getCouponId()) |
|||
)); |
|||
coupon.setCouponApplyItemList(couponApplyItemService.list( |
|||
new LambdaQueryWrapper<ShopCouponApplyItem>() |
|||
.eq(ShopCouponApplyItem::getCouponId, userCoupon.getCouponId()) |
|||
)); |
|||
userCoupon.setCouponItem(coupon); |
|||
} |
|||
``` |
|||
|
|||
### 2. 完善实体类字段 |
|||
在 `ShopCouponApplyItem.java` 中添加了必要的字段： |
|||
```java |
|||
@Schema(description = "优惠券ID") |
|||
private Integer couponId; |
|||
|
|||
@Schema(description = "商品ID") |
|||
private Integer goodsId; |
|||
|
|||
@Schema(description = "分类ID") |
|||
private Integer categoryId; |
|||
|
|||
@Schema(description = "类型(1商品 2分类)") |
|||
private Integer type; |
|||
``` |
|||
|
|||
### 3. 添加服务依赖注入 |
|||
在 `ShopUserCouponController.java` 中添加： |
|||
```java |
|||
@Resource |
|||
private CouponStatusService couponStatusService; |
|||
``` |
|||
|
|||
### 4. 优化适用范围验证逻辑 |
|||
在 `CouponStatusServiceImpl.java` 中改进了验证逻辑： |
|||
```java |
|||
private boolean validateApplyRange(ShopUserCoupon userCoupon, List<Integer> goodsIds) { |
|||
if (userCoupon.getApplyRange() == null || userCoupon.getApplyRange() == ShopUserCoupon.APPLY_ALL) { |
|||
return true; // 全部商品适用 |
|||
} |
|||
|
|||
if (userCoupon.getApplyRange() == ShopUserCoupon.APPLY_GOODS) { |
|||
// 指定商品适用 |
|||
List<ShopCouponApplyItem> applyItems = shopCouponApplyItemService.list( |
|||
new LambdaQueryWrapper<ShopCouponApplyItem>() |
|||
.eq(ShopCouponApplyItem::getCouponId, userCoupon.getCouponId()) |
|||
.eq(ShopCouponApplyItem::getType, 1) // 类型1表示商品 |
|||
.isNotNull(ShopCouponApplyItem::getGoodsId) |
|||
); |
|||
|
|||
List<Integer> applicableGoodsIds = applyItems.stream() |
|||
.map(ShopCouponApplyItem::getGoodsId) |
|||
.filter(goodsId -> goodsId != null) |
|||
.collect(Collectors.toList()); |
|||
|
|||
return goodsIds.stream().anyMatch(applicableGoodsIds::contains); |
|||
} |
|||
|
|||
if (userCoupon.getApplyRange() == ShopUserCoupon.APPLY_CATEGORY) { |
|||
// 指定分类适用 - 暂时返回true，实际项目中需要实现商品分类查询逻辑 |
|||
log.debug("分类适用范围验证暂未实现，默认通过"); |
|||
return true; |
|||
} |
|||
|
|||
return true; |
|||
} |
|||
``` |
|||
|
|||
## 🔧 修复的文件列表 |
|||
|
|||
1. **src/main/java/com/gxwebsoft/shop/controller/ShopUserCouponController.java** |
|||
- 修复了for循环结构错误 |
|||
- 添加了CouponStatusService依赖注入 |
|||
- 集成了新的状态管理功能 |
|||
|
|||
2. **src/main/java/com/gxwebsoft/shop/entity/ShopCouponApplyItem.java** |
|||
- 添加了goodsId字段 |
|||
- 添加了categoryId字段 |
|||
- 完善了字段注释 |
|||
|
|||
3. **src/main/java/com/gxwebsoft/shop/service/impl/CouponStatusServiceImpl.java** |
|||
- 优化了适用范围验证逻辑 |
|||
- 添加了空值检查 |
|||
- 改进了错误处理 |
|||
|
|||
## 🧪 测试验证 |
|||
|
|||
创建了测试类 `CouponStatusServiceTest.java` 来验证： |
|||
- 优惠券状态常量定义 |
|||
- 状态判断方法 |
|||
- 状态更新方法 |
|||
- 批量过期处理功能 |
|||
|
|||
## 📋 后续建议 |
|||
|
|||
### 1. 数据库字段同步 |
|||
确保数据库表 `shop_coupon_apply_item` 包含以下字段： |
|||
```sql |
|||
ALTER TABLE shop_coupon_apply_item |
|||
ADD COLUMN goods_id INT COMMENT '商品ID', |
|||
ADD COLUMN category_id INT COMMENT '分类ID'; |
|||
``` |
|||
|
|||
### 2. 完善分类适用范围验证 |
|||
需要实现商品分类查询逻辑，建议： |
|||
- 创建商品分类查询服务 |
|||
- 根据商品ID查询所属分类 |
|||
- 验证分类是否在优惠券适用范围内 |
|||
|
|||
### 3. 添加单元测试 |
|||
- 为所有新增的方法添加单元测试 |
|||
- 测试各种边界情况 |
|||
- 确保异常处理正确 |
|||
|
|||
### 4. 性能优化 |
|||
- 考虑添加缓存减少数据库查询 |
|||
- 批量处理大量优惠券状态更新 |
|||
- 优化查询条件和索引 |
|||
|
|||
## ✅ 修复验证 |
|||
|
|||
修复完成后，以下功能应该正常工作： |
|||
|
|||
1. **优惠券列表查询** - 不再出现编译错误 |
|||
2. **状态自动更新** - 过期优惠券自动标记 |
|||
3. **适用范围验证** - 商品范围验证正常 |
|||
4. **API接口调用** - 所有新增接口可正常访问 |
|||
5. **定时任务执行** - 过期处理任务正常运行 |
|||
|
|||
## 🚀 部署建议 |
|||
|
|||
1. **备份数据库** - 在部署前备份现有数据 |
|||
2. **执行SQL脚本** - 运行数据库优化脚本 |
|||
3. **重启应用** - 确保所有新功能生效 |
|||
4. **监控日志** - 观察定时任务和API调用日志 |
|||
5. **功能测试** - 验证所有优惠券功能正常 |
|||
|
|||
修复完成！现在优惠券状态管理功能应该可以正常使用了。 |
|||
@ -0,0 +1,281 @@ |
|||
# 优惠券状态管理功能说明 |
|||
|
|||
## 📋 功能概述 |
|||
|
|||
本功能实现了完整的优惠券状态管理系统，包括可用、已使用、过期三种状态的自动管理和API接口。 |
|||
|
|||
## 🎯 核心功能 |
|||
|
|||
### 1. 状态管理 |
|||
- **可用状态 (STATUS_UNUSED = 0)**: 优惠券未使用且未过期 |
|||
- **已使用状态 (STATUS_USED = 1)**: 优惠券已在订单中使用 |
|||
- **已过期状态 (STATUS_EXPIRED = 2)**: 优惠券已过期 |
|||
|
|||
### 2. 自动状态更新 |
|||
- 定时任务自动检测和更新过期优惠券 |
|||
- 查询时实时检查优惠券状态 |
|||
- 订单使用时自动更新状态 |
|||
|
|||
### 3. 状态验证 |
|||
- 订单使用前验证优惠券可用性 |
|||
- 检查最低消费金额限制 |
|||
- 验证适用商品范围 |
|||
|
|||
## 🔧 API接口 |
|||
|
|||
### 用户优惠券查询 |
|||
|
|||
#### 获取可用优惠券 |
|||
```http |
|||
GET /api/shop/user-coupon/my/available |
|||
``` |
|||
|
|||
#### 获取已使用优惠券 |
|||
```http |
|||
GET /api/shop/user-coupon/my/used |
|||
``` |
|||
|
|||
#### 获取已过期优惠券 |
|||
```http |
|||
GET /api/shop/user-coupon/my/expired |
|||
``` |
|||
|
|||
#### 获取优惠券统计 |
|||
```http |
|||
GET /api/shop/user-coupon/my/statistics |
|||
``` |
|||
|
|||
### 优惠券状态管理 |
|||
|
|||
#### 验证优惠券可用性 |
|||
```http |
|||
POST /api/shop/coupon-status/validate |
|||
Content-Type: application/json |
|||
|
|||
{ |
|||
"userCouponId": 1, |
|||
"totalAmount": 150.00, |
|||
"goodsIds": [1, 2, 3] |
|||
} |
|||
``` |
|||
|
|||
#### 使用优惠券 |
|||
```http |
|||
POST /api/shop/coupon-status/use |
|||
Content-Type: application/x-www-form-urlencoded |
|||
|
|||
userCouponId=1&orderId=123&orderNo=ORDER123456 |
|||
``` |
|||
|
|||
#### 退还优惠券 |
|||
```http |
|||
POST /api/shop/coupon-status/return/123 |
|||
``` |
|||
|
|||
## 💻 代码使用示例 |
|||
|
|||
### 1. 检查优惠券状态 |
|||
```java |
|||
@Autowired |
|||
private CouponStatusService couponStatusService; |
|||
|
|||
// 获取用户可用优惠券 |
|||
List<ShopUserCoupon> availableCoupons = couponStatusService.getAvailableCoupons(userId); |
|||
|
|||
// 检查优惠券是否可用 |
|||
ShopUserCoupon coupon = shopUserCouponService.getById(couponId); |
|||
if (coupon.isAvailable()) { |
|||
// 优惠券可用 |
|||
} |
|||
``` |
|||
|
|||
### 2. 使用优惠券 |
|||
```java |
|||
// 验证优惠券 |
|||
CouponValidationResult result = couponStatusService.validateCouponForOrder( |
|||
userCouponId, totalAmount, goodsIds); |
|||
|
|||
if (result.isValid()) { |
|||
// 使用优惠券 |
|||
boolean success = couponStatusService.useCoupon(userCouponId, orderId, orderNo); |
|||
} |
|||
``` |
|||
|
|||
### 3. 实体类便捷方法 |
|||
```java |
|||
ShopUserCoupon userCoupon = shopUserCouponService.getById(id); |
|||
|
|||
// 判断状态 |
|||
boolean available = userCoupon.isAvailable(); // 是否可用 |
|||
boolean used = userCoupon.isUsed(); // 是否已使用 |
|||
boolean expired = userCoupon.isExpired(); // 是否已过期 |
|||
|
|||
// 获取状态描述 |
|||
String statusDesc = userCoupon.getStatusDesc(); // "可使用"、"已使用"、"已过期" |
|||
|
|||
// 标记为已使用 |
|||
userCoupon.markAsUsed(orderId, orderNo); |
|||
|
|||
// 标记为已过期 |
|||
userCoupon.markAsExpired(); |
|||
``` |
|||
|
|||
## ⏰ 定时任务 |
|||
|
|||
### 过期优惠券处理 |
|||
- **执行时间**: 每天凌晨2点（生产环境） |
|||
- **功能**: 自动将过期的优惠券状态更新为已过期 |
|||
- **配置**: `coupon.expire.cron` |
|||
|
|||
### 每小时状态检查（可选） |
|||
- **执行时间**: 每小时整点 |
|||
- **功能**: 及时发现和处理刚过期的优惠券 |
|||
- **环境**: 仅生产环境执行 |
|||
|
|||
## 🗄️ 数据库优化 |
|||
|
|||
### 索引优化 |
|||
```sql |
|||
-- 用户优惠券状态查询索引 |
|||
CREATE INDEX idx_user_coupon_status ON shop_user_coupon(user_id, status, expire_time); |
|||
|
|||
-- 过期优惠券查询索引 |
|||
CREATE INDEX idx_user_coupon_expire ON shop_user_coupon(expire_time) WHERE status = 0; |
|||
|
|||
-- 订单优惠券查询索引 |
|||
CREATE INDEX idx_user_coupon_order ON shop_user_coupon(order_id) WHERE status = 1; |
|||
``` |
|||
|
|||
### 视图简化查询 |
|||
```sql |
|||
-- 用户可用优惠券视图 |
|||
CREATE VIEW v_user_available_coupons AS |
|||
SELECT uc.*, c.name as coupon_name |
|||
FROM shop_user_coupon uc |
|||
LEFT JOIN shop_coupon c ON uc.coupon_id = c.id |
|||
WHERE uc.deleted = 0; |
|||
``` |
|||
|
|||
## 📊 状态统计 |
|||
|
|||
### 优惠券状态分布 |
|||
```sql |
|||
SELECT |
|||
status, |
|||
CASE |
|||
WHEN status = 0 THEN '未使用' |
|||
WHEN status = 1 THEN '已使用' |
|||
WHEN status = 2 THEN '已过期' |
|||
END as status_name, |
|||
COUNT(*) as count |
|||
FROM shop_user_coupon |
|||
WHERE deleted = 0 |
|||
GROUP BY status; |
|||
``` |
|||
|
|||
### 使用率统计 |
|||
```sql |
|||
SELECT |
|||
DATE(create_time) as date, |
|||
COUNT(*) as issued_count, |
|||
SUM(CASE WHEN status = 1 THEN 1 ELSE 0 END) as used_count, |
|||
ROUND(SUM(CASE WHEN status = 1 THEN 1 ELSE 0 END) * 100.0 / COUNT(*), 2) as usage_rate |
|||
FROM shop_user_coupon |
|||
WHERE deleted = 0 |
|||
GROUP BY DATE(create_time); |
|||
``` |
|||
|
|||
## 🔧 配置说明 |
|||
|
|||
### application.yml 配置 |
|||
```yaml |
|||
# 优惠券配置 |
|||
coupon: |
|||
expire: |
|||
# 定时任务执行时间 |
|||
cron: "0 0 2 * * ?" # 每天凌晨2点 |
|||
status: |
|||
# 是否启用自动状态更新 |
|||
auto-update: true |
|||
# 批量处理大小 |
|||
batch-size: 1000 |
|||
``` |
|||
|
|||
## 🚀 部署步骤 |
|||
|
|||
### 1. 执行数据库脚本 |
|||
```bash |
|||
mysql -u root -p < src/main/resources/sql/coupon_status_optimization.sql |
|||
``` |
|||
|
|||
### 2. 更新应用配置 |
|||
确保 `application.yml` 中包含优惠券相关配置。 |
|||
|
|||
### 3. 重启应用 |
|||
重启应用以加载新的功能和定时任务。 |
|||
|
|||
### 4. 验证功能 |
|||
- 访问 API 文档: `http://localhost:9200/doc.html` |
|||
- 测试优惠券状态查询接口 |
|||
- 检查定时任务日志 |
|||
|
|||
## 🐛 故障排查 |
|||
|
|||
### 常见问题 |
|||
|
|||
1. **定时任务不执行** |
|||
- 检查 `@EnableScheduling` 注解 |
|||
- 确认 cron 表达式正确 |
|||
- 查看应用日志 |
|||
|
|||
2. **状态更新不及时** |
|||
- 检查数据库索引 |
|||
- 确认事务配置 |
|||
- 查看错误日志 |
|||
|
|||
3. **性能问题** |
|||
- 检查数据库索引是否生效 |
|||
- 优化查询条件 |
|||
- 考虑分页查询 |
|||
|
|||
### 日志监控 |
|||
```bash |
|||
# 查看定时任务日志 |
|||
grep "过期优惠券处理" logs/application.log |
|||
|
|||
# 查看状态更新日志 |
|||
grep "更新优惠券状态" logs/application.log |
|||
``` |
|||
|
|||
## 📈 性能优化建议 |
|||
|
|||
1. **数据库层面** |
|||
- 添加必要的索引 |
|||
- 定期清理过期数据 |
|||
- 使用分区表（大数据量时） |
|||
|
|||
2. **应用层面** |
|||
- 使用缓存减少数据库查询 |
|||
- 批量处理状态更新 |
|||
- 异步处理非关键操作 |
|||
|
|||
3. **监控告警** |
|||
- 监控优惠券使用率 |
|||
- 设置过期优惠券数量告警 |
|||
- 监控定时任务执行状态 |
|||
|
|||
## 🔄 后续扩展 |
|||
|
|||
1. **消息通知** |
|||
- 优惠券即将过期提醒 |
|||
- 优惠券使用成功通知 |
|||
|
|||
2. **数据分析** |
|||
- 优惠券使用趋势分析 |
|||
- 用户行为分析 |
|||
- ROI 计算 |
|||
|
|||
3. **高级功能** |
|||
- 优惠券组合使用 |
|||
- 动态优惠券推荐 |
|||
- A/B 测试支持 |
|||
@ -0,0 +1,189 @@ |
|||
package com.gxwebsoft.shop.controller; |
|||
|
|||
import com.gxwebsoft.common.core.web.ApiResult; |
|||
import com.gxwebsoft.common.core.web.BaseController; |
|||
import com.gxwebsoft.shop.entity.ShopUserCoupon; |
|||
import com.gxwebsoft.shop.service.CouponStatusService; |
|||
import com.gxwebsoft.shop.service.CouponStatusService.CouponStatusResult; |
|||
import com.gxwebsoft.shop.service.CouponStatusService.CouponValidationResult; |
|||
import io.swagger.v3.oas.annotations.Operation; |
|||
import io.swagger.v3.oas.annotations.Parameter; |
|||
import io.swagger.v3.oas.annotations.tags.Tag; |
|||
import lombok.extern.slf4j.Slf4j; |
|||
import org.springframework.beans.factory.annotation.Autowired; |
|||
import org.springframework.security.access.prepost.PreAuthorize; |
|||
import org.springframework.web.bind.annotation.*; |
|||
|
|||
import java.math.BigDecimal; |
|||
import java.util.List; |
|||
|
|||
/** |
|||
* 优惠券状态管理控制器 |
|||
* |
|||
* @author WebSoft |
|||
* @since 2025-01-15 |
|||
*/ |
|||
@Slf4j |
|||
@Tag(name = "优惠券状态管理") |
|||
@RestController |
|||
@RequestMapping("/api/shop/coupon-status") |
|||
public class CouponStatusController extends BaseController { |
|||
|
|||
@Autowired |
|||
private CouponStatusService couponStatusService; |
|||
|
|||
@Operation(summary = "获取当前用户可用优惠券") |
|||
@GetMapping("/available") |
|||
public ApiResult<List<ShopUserCoupon>> getAvailableCoupons() { |
|||
try { |
|||
List<ShopUserCoupon> coupons = couponStatusService.getAvailableCoupons(getLoginUserId()); |
|||
return success("获取成功", coupons); |
|||
} catch (Exception e) { |
|||
log.error("获取可用优惠券失败", e); |
|||
return fail("获取失败",null); |
|||
} |
|||
} |
|||
|
|||
@Operation(summary = "获取当前用户已使用优惠券") |
|||
@GetMapping("/used") |
|||
public ApiResult<List<ShopUserCoupon>> getUsedCoupons() { |
|||
try { |
|||
List<ShopUserCoupon> coupons = couponStatusService.getUsedCoupons(getLoginUserId()); |
|||
return success("获取成功", coupons); |
|||
} catch (Exception e) { |
|||
log.error("获取已使用优惠券失败", e); |
|||
return fail("获取失败",null); |
|||
} |
|||
} |
|||
|
|||
@Operation(summary = "获取当前用户已过期优惠券") |
|||
@GetMapping("/expired") |
|||
public ApiResult<List<ShopUserCoupon>> getExpiredCoupons() { |
|||
try { |
|||
List<ShopUserCoupon> coupons = couponStatusService.getExpiredCoupons(getLoginUserId()); |
|||
return success("获取成功", coupons); |
|||
} catch (Exception e) { |
|||
log.error("获取已过期优惠券失败", e); |
|||
return fail("获取失败",null); |
|||
} |
|||
} |
|||
|
|||
@Operation(summary = "获取当前用户所有优惠券（按状态分类）") |
|||
@GetMapping("/all-grouped") |
|||
public ApiResult<CouponStatusResult> getAllCouponsGrouped() { |
|||
try { |
|||
CouponStatusResult result = couponStatusService.getUserCouponsGroupByStatus(getLoginUserId()); |
|||
return success("获取成功", result); |
|||
} catch (Exception e) { |
|||
log.error("获取优惠券分类失败", e); |
|||
return fail("获取失败",null); |
|||
} |
|||
} |
|||
|
|||
@Operation(summary = "验证优惠券是否可用于订单") |
|||
@PostMapping("/validate") |
|||
public ApiResult<CouponValidationResult> validateCouponForOrder( |
|||
@Parameter(description = "用户优惠券ID") @RequestParam Long userCouponId, |
|||
@Parameter(description = "订单总金额") @RequestParam BigDecimal totalAmount, |
|||
@Parameter(description = "商品ID列表") @RequestBody List<Integer> goodsIds) { |
|||
try { |
|||
CouponValidationResult result = couponStatusService.validateCouponForOrder( |
|||
userCouponId, totalAmount, goodsIds); |
|||
return success(result.getMessage(), result); |
|||
} catch (Exception e) { |
|||
log.error("验证优惠券失败", e); |
|||
return fail("验证失败",null); |
|||
} |
|||
} |
|||
|
|||
@Operation(summary = "使用优惠券") |
|||
@PostMapping("/use") |
|||
public ApiResult<?> useCoupon( |
|||
@Parameter(description = "用户优惠券ID") @RequestParam Long userCouponId, |
|||
@Parameter(description = "订单ID") @RequestParam Integer orderId, |
|||
@Parameter(description = "订单号") @RequestParam String orderNo) { |
|||
try { |
|||
boolean success = couponStatusService.useCoupon(userCouponId, orderId, orderNo); |
|||
if (success) { |
|||
return success("使用成功"); |
|||
} else { |
|||
return fail("使用失败"); |
|||
} |
|||
} catch (Exception e) { |
|||
log.error("使用优惠券失败", e); |
|||
return fail("使用失败"); |
|||
} |
|||
} |
|||
|
|||
@Operation(summary = "退还优惠券（订单取消时）") |
|||
@PostMapping("/return/{orderId}") |
|||
public ApiResult<?> returnCoupon( |
|||
@Parameter(description = "订单ID") @PathVariable Integer orderId) { |
|||
try { |
|||
boolean success = couponStatusService.returnCoupon(orderId); |
|||
if (success) { |
|||
return success("退还成功"); |
|||
} else { |
|||
return fail("退还失败"); |
|||
} |
|||
} catch (Exception e) { |
|||
log.error("退还优惠券失败", e); |
|||
return fail("退还失败"); |
|||
} |
|||
} |
|||
|
|||
@PreAuthorize("hasAuthority('shop:coupon:manage')") |
|||
@Operation(summary = "批量更新过期优惠券状态（管理员）") |
|||
@PostMapping("/update-expired") |
|||
public ApiResult<?> updateExpiredCoupons() { |
|||
try { |
|||
int updatedCount = couponStatusService.updateExpiredCoupons(); |
|||
return success("更新完成，共更新 " + updatedCount + " 张优惠券"); |
|||
} catch (Exception e) { |
|||
log.error("批量更新过期优惠券失败", e); |
|||
return fail("更新失败"); |
|||
} |
|||
} |
|||
|
|||
@Operation(summary = "获取优惠券状态统计") |
|||
@GetMapping("/statistics") |
|||
public ApiResult<CouponStatistics> getCouponStatistics() { |
|||
try { |
|||
CouponStatusResult result = couponStatusService.getUserCouponsGroupByStatus(getLoginUserId()); |
|||
|
|||
CouponStatistics statistics = new CouponStatistics(); |
|||
statistics.setAvailableCount(result.getAvailableCoupons().size()); |
|||
statistics.setUsedCount(result.getUsedCoupons().size()); |
|||
statistics.setExpiredCount(result.getExpiredCoupons().size()); |
|||
statistics.setTotalCount(result.getTotalCount()); |
|||
|
|||
return success("获取成功", statistics); |
|||
} catch (Exception e) { |
|||
log.error("获取优惠券统计失败", e); |
|||
return fail("获取失败",null); |
|||
} |
|||
} |
|||
|
|||
/** |
|||
* 优惠券统计信息 |
|||
*/ |
|||
public static class CouponStatistics { |
|||
private int availableCount; // 可用数量
|
|||
private int usedCount; // 已使用数量
|
|||
private int expiredCount; // 已过期数量
|
|||
private int totalCount; // 总数量
|
|||
|
|||
// Getters and Setters
|
|||
public int getAvailableCount() { return availableCount; } |
|||
public void setAvailableCount(int availableCount) { this.availableCount = availableCount; } |
|||
|
|||
public int getUsedCount() { return usedCount; } |
|||
public void setUsedCount(int usedCount) { this.usedCount = usedCount; } |
|||
|
|||
public int getExpiredCount() { return expiredCount; } |
|||
public void setExpiredCount(int expiredCount) { this.expiredCount = expiredCount; } |
|||
|
|||
public int getTotalCount() { return totalCount; } |
|||
public void setTotalCount(int totalCount) { this.totalCount = totalCount; } |
|||
} |
|||
} |
|||
@ -0,0 +1,154 @@ |
|||
package com.gxwebsoft.shop.service; |
|||
|
|||
import com.gxwebsoft.shop.entity.ShopUserCoupon; |
|||
|
|||
import java.util.List; |
|||
|
|||
/** |
|||
* 优惠券状态管理服务 |
|||
* |
|||
* @author WebSoft |
|||
* @since 2025-01-15 |
|||
*/ |
|||
public interface CouponStatusService { |
|||
|
|||
/** |
|||
* 获取用户可用的优惠券列表 |
|||
* |
|||
* @param userId 用户ID |
|||
* @return 可用优惠券列表 |
|||
*/ |
|||
List<ShopUserCoupon> getAvailableCoupons(Integer userId); |
|||
|
|||
/** |
|||
* 获取用户已使用的优惠券列表 |
|||
* |
|||
* @param userId 用户ID |
|||
* @return 已使用优惠券列表 |
|||
*/ |
|||
List<ShopUserCoupon> getUsedCoupons(Integer userId); |
|||
|
|||
/** |
|||
* 获取用户已过期的优惠券列表 |
|||
* |
|||
* @param userId 用户ID |
|||
* @return 已过期优惠券列表 |
|||
*/ |
|||
List<ShopUserCoupon> getExpiredCoupons(Integer userId); |
|||
|
|||
/** |
|||
* 获取用户所有优惠券并按状态分类 |
|||
* |
|||
* @param userId 用户ID |
|||
* @return 分类后的优惠券列表 |
|||
*/ |
|||
CouponStatusResult getUserCouponsGroupByStatus(Integer userId); |
|||
|
|||
/** |
|||
* 使用优惠券 |
|||
* |
|||
* @param userCouponId 用户优惠券ID |
|||
* @param orderId 订单ID |
|||
* @param orderNo 订单号 |
|||
* @return 是否成功 |
|||
*/ |
|||
boolean useCoupon(Long userCouponId, Integer orderId, String orderNo); |
|||
|
|||
/** |
|||
* 退还优惠券（订单取消时） |
|||
* |
|||
* @param orderId 订单ID |
|||
* @return 是否成功 |
|||
*/ |
|||
boolean returnCoupon(Integer orderId); |
|||
|
|||
/** |
|||
* 批量更新过期优惠券状态 |
|||
* |
|||
* @return 更新的数量 |
|||
*/ |
|||
int updateExpiredCoupons(); |
|||
|
|||
/** |
|||
* 检查并更新单个优惠券状态 |
|||
* |
|||
* @param userCoupon 用户优惠券 |
|||
* @return 是否状态发生变化 |
|||
*/ |
|||
boolean checkAndUpdateCouponStatus(ShopUserCoupon userCoupon); |
|||
|
|||
/** |
|||
* 验证优惠券是否可用于指定订单 |
|||
* |
|||
* @param userCouponId 用户优惠券ID |
|||
* @param totalAmount 订单总金额 |
|||
* @param goodsIds 商品ID列表 |
|||
* @return 验证结果 |
|||
*/ |
|||
CouponValidationResult validateCouponForOrder(Long userCouponId, |
|||
java.math.BigDecimal totalAmount, |
|||
List<Integer> goodsIds); |
|||
|
|||
/** |
|||
* 优惠券状态分类结果 |
|||
*/ |
|||
class CouponStatusResult { |
|||
private List<ShopUserCoupon> availableCoupons; // 可用优惠券
|
|||
private List<ShopUserCoupon> usedCoupons; // 已使用优惠券
|
|||
private List<ShopUserCoupon> expiredCoupons; // 已过期优惠券
|
|||
private int totalCount; // 总数量
|
|||
|
|||
// 构造函数
|
|||
public CouponStatusResult(List<ShopUserCoupon> availableCoupons, |
|||
List<ShopUserCoupon> usedCoupons, |
|||
List<ShopUserCoupon> expiredCoupons) { |
|||
this.availableCoupons = availableCoupons; |
|||
this.usedCoupons = usedCoupons; |
|||
this.expiredCoupons = expiredCoupons; |
|||
this.totalCount = availableCoupons.size() + usedCoupons.size() + expiredCoupons.size(); |
|||
} |
|||
|
|||
// Getters and Setters
|
|||
public List<ShopUserCoupon> getAvailableCoupons() { return availableCoupons; } |
|||
public void setAvailableCoupons(List<ShopUserCoupon> availableCoupons) { this.availableCoupons = availableCoupons; } |
|||
|
|||
public List<ShopUserCoupon> getUsedCoupons() { return usedCoupons; } |
|||
public void setUsedCoupons(List<ShopUserCoupon> usedCoupons) { this.usedCoupons = usedCoupons; } |
|||
|
|||
public List<ShopUserCoupon> getExpiredCoupons() { return expiredCoupons; } |
|||
public void setExpiredCoupons(List<ShopUserCoupon> expiredCoupons) { this.expiredCoupons = expiredCoupons; } |
|||
|
|||
public int getTotalCount() { return totalCount; } |
|||
public void setTotalCount(int totalCount) { this.totalCount = totalCount; } |
|||
} |
|||
|
|||
/** |
|||
* 优惠券验证结果 |
|||
*/ |
|||
class CouponValidationResult { |
|||
private boolean valid; // 是否有效
|
|||
private String message; // 验证消息
|
|||
private java.math.BigDecimal discountAmount; // 优惠金额
|
|||
|
|||
public CouponValidationResult(boolean valid, String message) { |
|||
this.valid = valid; |
|||
this.message = message; |
|||
} |
|||
|
|||
public CouponValidationResult(boolean valid, String message, java.math.BigDecimal discountAmount) { |
|||
this.valid = valid; |
|||
this.message = message; |
|||
this.discountAmount = discountAmount; |
|||
} |
|||
|
|||
// Getters and Setters
|
|||
public boolean isValid() { return valid; } |
|||
public void setValid(boolean valid) { this.valid = valid; } |
|||
|
|||
public String getMessage() { return message; } |
|||
public void setMessage(String message) { this.message = message; } |
|||
|
|||
public java.math.BigDecimal getDiscountAmount() { return discountAmount; } |
|||
public void setDiscountAmount(java.math.BigDecimal discountAmount) { this.discountAmount = discountAmount; } |
|||
} |
|||
} |
|||
@ -0,0 +1,325 @@ |
|||
package com.gxwebsoft.shop.service.impl; |
|||
|
|||
import com.baomidou.mybatisplus.core.conditions.query.LambdaQueryWrapper; |
|||
import com.baomidou.mybatisplus.core.conditions.update.LambdaUpdateWrapper; |
|||
import com.gxwebsoft.shop.entity.ShopUserCoupon; |
|||
import com.gxwebsoft.shop.entity.ShopCoupon; |
|||
import com.gxwebsoft.shop.entity.ShopCouponApplyItem; |
|||
import com.gxwebsoft.shop.service.CouponStatusService; |
|||
import com.gxwebsoft.shop.service.ShopUserCouponService; |
|||
import com.gxwebsoft.shop.service.ShopCouponService; |
|||
import com.gxwebsoft.shop.service.ShopCouponApplyItemService; |
|||
import lombok.extern.slf4j.Slf4j; |
|||
import org.springframework.beans.factory.annotation.Autowired; |
|||
import org.springframework.stereotype.Service; |
|||
import org.springframework.transaction.annotation.Transactional; |
|||
|
|||
import java.math.BigDecimal; |
|||
import java.time.LocalDateTime; |
|||
import java.util.List; |
|||
import java.util.stream.Collectors; |
|||
|
|||
/** |
|||
* 优惠券状态管理服务实现 |
|||
* |
|||
* @author WebSoft |
|||
* @since 2025-01-15 |
|||
*/ |
|||
@Slf4j |
|||
@Service |
|||
public class CouponStatusServiceImpl implements CouponStatusService { |
|||
|
|||
@Autowired |
|||
private ShopUserCouponService shopUserCouponService; |
|||
|
|||
@Autowired |
|||
private ShopCouponService shopCouponService; |
|||
|
|||
@Autowired |
|||
private ShopCouponApplyItemService shopCouponApplyItemService; |
|||
|
|||
@Override |
|||
public List<ShopUserCoupon> getAvailableCoupons(Integer userId) { |
|||
List<ShopUserCoupon> allCoupons = getUserCoupons(userId); |
|||
return allCoupons.stream() |
|||
.filter(ShopUserCoupon::isAvailable) |
|||
.collect(Collectors.toList()); |
|||
} |
|||
|
|||
@Override |
|||
public List<ShopUserCoupon> getUsedCoupons(Integer userId) { |
|||
return shopUserCouponService.list( |
|||
new LambdaQueryWrapper<ShopUserCoupon>() |
|||
.eq(ShopUserCoupon::getUserId, userId) |
|||
.eq(ShopUserCoupon::getStatus, ShopUserCoupon.STATUS_USED) |
|||
.orderByDesc(ShopUserCoupon::getUseTime) |
|||
); |
|||
} |
|||
|
|||
@Override |
|||
public List<ShopUserCoupon> getExpiredCoupons(Integer userId) { |
|||
// 先更新过期状态
|
|||
updateExpiredCouponsForUser(userId); |
|||
|
|||
return shopUserCouponService.list( |
|||
new LambdaQueryWrapper<ShopUserCoupon>() |
|||
.eq(ShopUserCoupon::getUserId, userId) |
|||
.eq(ShopUserCoupon::getStatus, ShopUserCoupon.STATUS_EXPIRED) |
|||
.orderByDesc(ShopUserCoupon::getEndTime) |
|||
); |
|||
} |
|||
|
|||
@Override |
|||
public CouponStatusResult getUserCouponsGroupByStatus(Integer userId) { |
|||
List<ShopUserCoupon> availableCoupons = getAvailableCoupons(userId); |
|||
List<ShopUserCoupon> usedCoupons = getUsedCoupons(userId); |
|||
List<ShopUserCoupon> expiredCoupons = getExpiredCoupons(userId); |
|||
|
|||
return new CouponStatusResult(availableCoupons, usedCoupons, expiredCoupons); |
|||
} |
|||
|
|||
@Override |
|||
@Transactional(rollbackFor = Exception.class) |
|||
public boolean useCoupon(Long userCouponId, Integer orderId, String orderNo) { |
|||
try { |
|||
ShopUserCoupon userCoupon = shopUserCouponService.getById(userCouponId); |
|||
if (userCoupon == null) { |
|||
log.warn("优惠券不存在: {}", userCouponId); |
|||
return false; |
|||
} |
|||
|
|||
if (!userCoupon.isAvailable()) { |
|||
log.warn("优惠券不可用: {}, 状态: {}", userCouponId, userCoupon.getStatusDesc()); |
|||
return false; |
|||
} |
|||
|
|||
// 标记为已使用
|
|||
userCoupon.markAsUsed(orderId, orderNo); |
|||
|
|||
return shopUserCouponService.updateById(userCoupon); |
|||
} catch (Exception e) { |
|||
log.error("使用优惠券失败: {}", userCouponId, e); |
|||
return false; |
|||
} |
|||
} |
|||
|
|||
@Override |
|||
@Transactional(rollbackFor = Exception.class) |
|||
public boolean returnCoupon(Integer orderId) { |
|||
try { |
|||
ShopUserCoupon userCoupon = shopUserCouponService.getOne( |
|||
new LambdaQueryWrapper<ShopUserCoupon>() |
|||
.eq(ShopUserCoupon::getOrderId, orderId) |
|||
.eq(ShopUserCoupon::getStatus, ShopUserCoupon.STATUS_USED) |
|||
); |
|||
|
|||
if (userCoupon == null) { |
|||
log.info("订单没有使用优惠券: {}", orderId); |
|||
return true; |
|||
} |
|||
|
|||
// 检查是否已过期
|
|||
if (userCoupon.isExpired()) { |
|||
log.warn("优惠券已过期，无法退还: {}", userCoupon.getId()); |
|||
return false; |
|||
} |
|||
|
|||
// 恢复为未使用状态
|
|||
userCoupon.setStatus(ShopUserCoupon.STATUS_UNUSED); |
|||
userCoupon.setIsUse(0); |
|||
userCoupon.setUseTime(null); |
|||
userCoupon.setOrderId(null); |
|||
userCoupon.setOrderNo(null); |
|||
|
|||
return shopUserCouponService.updateById(userCoupon); |
|||
} catch (Exception e) { |
|||
log.error("退还优惠券失败, 订单ID: {}", orderId, e); |
|||
return false; |
|||
} |
|||
} |
|||
|
|||
@Override |
|||
@Transactional(rollbackFor = Exception.class) |
|||
public int updateExpiredCoupons() { |
|||
try { |
|||
// 查询所有未使用且已过期的优惠券
|
|||
List<ShopUserCoupon> expiredCoupons = shopUserCouponService.list( |
|||
new LambdaQueryWrapper<ShopUserCoupon>() |
|||
.eq(ShopUserCoupon::getStatus, ShopUserCoupon.STATUS_UNUSED) |
|||
.lt(ShopUserCoupon::getEndTime, LocalDateTime.now()) |
|||
); |
|||
|
|||
if (expiredCoupons.isEmpty()) { |
|||
return 0; |
|||
} |
|||
|
|||
// 批量更新状态
|
|||
List<Long> expiredIds = expiredCoupons.stream() |
|||
.map(ShopUserCoupon::getId) |
|||
.collect(Collectors.toList()); |
|||
|
|||
boolean success = shopUserCouponService.update( |
|||
new LambdaUpdateWrapper<ShopUserCoupon>() |
|||
.in(ShopUserCoupon::getId, expiredIds) |
|||
.set(ShopUserCoupon::getStatus, ShopUserCoupon.STATUS_EXPIRED) |
|||
.set(ShopUserCoupon::getIsExpire, 1) |
|||
); |
|||
|
|||
int updatedCount = success ? expiredIds.size() : 0; |
|||
log.info("批量更新过期优惠券状态完成，更新数量: {}", updatedCount); |
|||
return updatedCount; |
|||
} catch (Exception e) { |
|||
log.error("批量更新过期优惠券状态失败", e); |
|||
return 0; |
|||
} |
|||
} |
|||
|
|||
@Override |
|||
public boolean checkAndUpdateCouponStatus(ShopUserCoupon userCoupon) { |
|||
if (userCoupon == null) { |
|||
return false; |
|||
} |
|||
|
|||
boolean statusChanged = false; |
|||
|
|||
// 检查是否过期
|
|||
if (userCoupon.getStatus() == ShopUserCoupon.STATUS_UNUSED && userCoupon.isExpired()) { |
|||
userCoupon.markAsExpired(); |
|||
statusChanged = true; |
|||
} |
|||
|
|||
// 如果状态发生变化，更新数据库
|
|||
if (statusChanged) { |
|||
try { |
|||
shopUserCouponService.updateById(userCoupon); |
|||
log.debug("更新优惠券状态: {} -> {}", userCoupon.getId(), userCoupon.getStatusDesc()); |
|||
} catch (Exception e) { |
|||
log.error("更新优惠券状态失败: {}", userCoupon.getId(), e); |
|||
return false; |
|||
} |
|||
} |
|||
|
|||
return statusChanged; |
|||
} |
|||
|
|||
@Override |
|||
public CouponValidationResult validateCouponForOrder(Long userCouponId, |
|||
BigDecimal totalAmount, |
|||
List<Integer> goodsIds) { |
|||
try { |
|||
ShopUserCoupon userCoupon = shopUserCouponService.getById(userCouponId); |
|||
if (userCoupon == null) { |
|||
return new CouponValidationResult(false, "优惠券不存在"); |
|||
} |
|||
|
|||
// 检查优惠券状态
|
|||
if (!userCoupon.isAvailable()) { |
|||
return new CouponValidationResult(false, "优惠券" + userCoupon.getStatusDesc()); |
|||
} |
|||
|
|||
// 检查最低消费金额
|
|||
if (userCoupon.getMinPrice() != null && |
|||
totalAmount.compareTo(userCoupon.getMinPrice()) < 0) { |
|||
return new CouponValidationResult(false, |
|||
String.format("订单金额不满足最低消费要求，需满%s元", userCoupon.getMinPrice())); |
|||
} |
|||
|
|||
// 检查适用范围
|
|||
if (!validateApplyRange(userCoupon, goodsIds)) { |
|||
return new CouponValidationResult(false, "优惠券不适用于当前商品"); |
|||
} |
|||
|
|||
// 计算优惠金额
|
|||
BigDecimal discountAmount = calculateDiscountAmount(userCoupon, totalAmount); |
|||
|
|||
return new CouponValidationResult(true, "优惠券可用", discountAmount); |
|||
} catch (Exception e) { |
|||
log.error("验证优惠券失败: {}", userCouponId, e); |
|||
return new CouponValidationResult(false, "验证优惠券时发生错误"); |
|||
} |
|||
} |
|||
|
|||
/** |
|||
* 获取用户所有优惠券 |
|||
*/ |
|||
private List<ShopUserCoupon> getUserCoupons(Integer userId) { |
|||
List<ShopUserCoupon> coupons = shopUserCouponService.list( |
|||
new LambdaQueryWrapper<ShopUserCoupon>() |
|||
.eq(ShopUserCoupon::getUserId, userId) |
|||
.orderByAsc(ShopUserCoupon::getEndTime) |
|||
); |
|||
|
|||
// 检查并更新状态
|
|||
coupons.forEach(this::checkAndUpdateCouponStatus); |
|||
|
|||
return coupons; |
|||
} |
|||
|
|||
/** |
|||
* 更新指定用户的过期优惠券 |
|||
*/ |
|||
private void updateExpiredCouponsForUser(Integer userId) { |
|||
try { |
|||
shopUserCouponService.update( |
|||
new LambdaUpdateWrapper<ShopUserCoupon>() |
|||
.eq(ShopUserCoupon::getUserId, userId) |
|||
.eq(ShopUserCoupon::getStatus, ShopUserCoupon.STATUS_UNUSED) |
|||
.lt(ShopUserCoupon::getEndTime, LocalDateTime.now()) |
|||
.set(ShopUserCoupon::getStatus, ShopUserCoupon.STATUS_EXPIRED) |
|||
.set(ShopUserCoupon::getIsExpire, 1) |
|||
); |
|||
} catch (Exception e) { |
|||
log.error("更新用户过期优惠券失败, userId: {}", userId, e); |
|||
} |
|||
} |
|||
|
|||
/** |
|||
* 验证优惠券适用范围 |
|||
*/ |
|||
private boolean validateApplyRange(ShopUserCoupon userCoupon, List<Integer> goodsIds) { |
|||
if (userCoupon.getApplyRange() == null || userCoupon.getApplyRange() == ShopUserCoupon.APPLY_ALL) { |
|||
return true; // 全部商品适用
|
|||
} |
|||
|
|||
if (userCoupon.getApplyRange() == ShopUserCoupon.APPLY_GOODS) { |
|||
// 指定商品适用
|
|||
List<ShopCouponApplyItem> applyItems = shopCouponApplyItemService.list( |
|||
new LambdaQueryWrapper<ShopCouponApplyItem>() |
|||
.eq(ShopCouponApplyItem::getCouponId, userCoupon.getCouponId()) |
|||
.eq(ShopCouponApplyItem::getType, 1) // 类型1表示商品
|
|||
.isNotNull(ShopCouponApplyItem::getGoodsId) |
|||
); |
|||
|
|||
List<Integer> applicableGoodsIds = applyItems.stream() |
|||
.map(ShopCouponApplyItem::getGoodsId) |
|||
.filter(goodsId -> goodsId != null) |
|||
.collect(Collectors.toList()); |
|||
|
|||
return goodsIds.stream().anyMatch(applicableGoodsIds::contains); |
|||
} |
|||
|
|||
if (userCoupon.getApplyRange() == ShopUserCoupon.APPLY_CATEGORY) { |
|||
// 指定分类适用 - 这里需要根据商品ID查询分类ID，然后验证
|
|||
// 暂时返回true，实际项目中需要实现商品分类查询逻辑
|
|||
log.debug("分类适用范围验证暂未实现，默认通过"); |
|||
return true; |
|||
} |
|||
|
|||
return true; |
|||
} |
|||
|
|||
/** |
|||
* 计算优惠金额 |
|||
*/ |
|||
private BigDecimal calculateDiscountAmount(ShopUserCoupon userCoupon, BigDecimal totalAmount) { |
|||
if (userCoupon.getType() == ShopUserCoupon.TYPE_REDUCE) { |
|||
// 满减券
|
|||
return userCoupon.getReducePrice(); |
|||
} else if (userCoupon.getType() == ShopUserCoupon.TYPE_DISCOUNT) { |
|||
// 折扣券
|
|||
BigDecimal discountRate = BigDecimal.valueOf(userCoupon.getDiscount()).divide(BigDecimal.valueOf(100)); |
|||
return totalAmount.multiply(BigDecimal.ONE.subtract(discountRate)); |
|||
} |
|||
return BigDecimal.ZERO; |
|||
} |
|||
} |
|||
@ -0,0 +1,86 @@ |
|||
package com.gxwebsoft.shop.task; |
|||
|
|||
import com.gxwebsoft.shop.service.CouponStatusService; |
|||
import lombok.extern.slf4j.Slf4j; |
|||
import org.springframework.beans.factory.annotation.Autowired; |
|||
import org.springframework.beans.factory.annotation.Value; |
|||
import org.springframework.scheduling.annotation.Scheduled; |
|||
import org.springframework.stereotype.Component; |
|||
|
|||
/** |
|||
* 优惠券过期处理定时任务 |
|||
* |
|||
* @author WebSoft |
|||
* @since 2025-01-15 |
|||
*/ |
|||
@Slf4j |
|||
@Component |
|||
public class CouponExpireTask { |
|||
|
|||
@Autowired |
|||
private CouponStatusService couponStatusService; |
|||
|
|||
@Value("${spring.profiles.active:dev}") |
|||
private String activeProfile; |
|||
|
|||
/** |
|||
* 每天凌晨2点执行过期优惠券处理 |
|||
* 生产环境：每天凌晨2点执行 |
|||
* 开发环境：每10分钟执行一次（用于测试） |
|||
*/ |
|||
@Scheduled(cron = "${coupon.expire.cron:0 0 2 * * ?}") |
|||
public void processExpiredCoupons() { |
|||
log.info("开始执行过期优惠券处理任务..."); |
|||
|
|||
try { |
|||
long startTime = System.currentTimeMillis(); |
|||
|
|||
// 批量更新过期优惠券状态
|
|||
int updatedCount = couponStatusService.updateExpiredCoupons(); |
|||
|
|||
long endTime = System.currentTimeMillis(); |
|||
long duration = endTime - startTime; |
|||
|
|||
log.info("过期优惠券处理任务完成，更新数量: {}，耗时: {}ms", updatedCount, duration); |
|||
|
|||
// 如果是开发环境，输出更详细的日志
|
|||
if ("dev".equals(activeProfile)) { |
|||
log.debug("开发环境 - 过期优惠券处理详情: 更新{}张优惠券", updatedCount); |
|||
} |
|||
|
|||
} catch (Exception e) { |
|||
log.error("过期优惠券处理任务执行失败", e); |
|||
} |
|||
} |
|||
|
|||
/** |
|||
* 每小时执行一次优惠券状态检查（可选） |
|||
* 用于及时发现和处理刚过期的优惠券 |
|||
*/ |
|||
@Scheduled(cron = "0 0 * * * ?") |
|||
public void hourlyExpiredCouponsCheck() { |
|||
// 只在生产环境执行
|
|||
if (!"prod".equals(activeProfile)) { |
|||
return; |
|||
} |
|||
|
|||
log.debug("执行每小时优惠券状态检查..."); |
|||
|
|||
try { |
|||
int updatedCount = couponStatusService.updateExpiredCoupons(); |
|||
if (updatedCount > 0) { |
|||
log.info("每小时检查发现并更新了 {} 张过期优惠券", updatedCount); |
|||
} |
|||
} catch (Exception e) { |
|||
log.error("每小时优惠券状态检查失败", e); |
|||
} |
|||
} |
|||
|
|||
/** |
|||
* 手动触发过期优惠券处理（用于测试） |
|||
*/ |
|||
public void manualProcessExpiredCoupons() { |
|||
log.info("手动触发过期优惠券处理任务..."); |
|||
processExpiredCoupons(); |
|||
} |
|||
} |
|||
@ -0,0 +1,194 @@ |
|||
-- 优惠券状态管理优化SQL脚本 |
|||
-- 作者: WebSoft |
|||
-- 日期: 2025-01-15 |
|||
-- 说明: 优化优惠券查询性能，添加必要的索引 |
|||
|
|||
-- ======================================== |
|||
-- 1. 添加索引优化查询性能 |
|||
-- ======================================== |
|||
|
|||
-- 用户优惠券表索引优化 |
|||
CREATE INDEX IF NOT EXISTS idx_user_coupon_status ON shop_user_coupon(user_id, status, expire_time); |
|||
CREATE INDEX IF NOT EXISTS idx_user_coupon_expire ON shop_user_coupon(expire_time) WHERE status = 0; |
|||
CREATE INDEX IF NOT EXISTS idx_user_coupon_order ON shop_user_coupon(order_id) WHERE status = 1; |
|||
|
|||
-- 优惠券模板表索引优化 |
|||
CREATE INDEX IF NOT EXISTS idx_coupon_status_expire ON shop_coupon(status, expire_type, end_time); |
|||
|
|||
-- ======================================== |
|||
-- 2. 统一状态字段（如果需要数据迁移） |
|||
-- ======================================== |
|||
|
|||
-- 检查现有数据的状态一致性 |
|||
SELECT |
|||
'状态一致性检查' as check_item, |
|||
COUNT(*) as total_count, |
|||
SUM(CASE WHEN status = 0 AND is_use = 0 AND is_expire = 0 THEN 1 ELSE 0 END) as available_count, |
|||
SUM(CASE WHEN status = 1 AND is_use = 1 THEN 1 ELSE 0 END) as used_count, |
|||
SUM(CASE WHEN status = 2 OR is_expire = 1 THEN 1 ELSE 0 END) as expired_count, |
|||
SUM(CASE WHEN |
|||
(status = 0 AND (is_use = 1 OR is_expire = 1)) OR |
|||
(status = 1 AND is_use = 0) OR |
|||
(status = 2 AND is_expire = 0) |
|||
THEN 1 ELSE 0 END) as inconsistent_count |
|||
FROM shop_user_coupon; |
|||
|
|||
-- 修复状态不一致的数据 |
|||
UPDATE shop_user_coupon |
|||
SET status = 1, is_use = 1 |
|||
WHERE status = 0 AND is_use = 1 AND is_expire = 0; |
|||
|
|||
UPDATE shop_user_coupon |
|||
SET status = 2, is_expire = 1 |
|||
WHERE status = 0 AND is_expire = 1; |
|||
|
|||
UPDATE shop_user_coupon |
|||
SET status = 2, is_expire = 1 |
|||
WHERE status IN (0, 1) AND end_time < NOW(); |
|||
|
|||
-- ======================================== |
|||
-- 3. 添加触发器自动更新过期状态（可选） |
|||
-- ======================================== |
|||
|
|||
DELIMITER $$ |
|||
|
|||
-- 创建触发器：在查询时自动检查过期状态 |
|||
CREATE TRIGGER IF NOT EXISTS tr_check_coupon_expire |
|||
BEFORE UPDATE ON shop_user_coupon |
|||
FOR EACH ROW |
|||
BEGIN |
|||
-- 如果是未使用状态且已过期，自动更新为过期状态 |
|||
IF NEW.status = 0 AND NEW.end_time < NOW() THEN |
|||
SET NEW.status = 2; |
|||
SET NEW.is_expire = 1; |
|||
END IF; |
|||
END$$ |
|||
|
|||
DELIMITER ; |
|||
|
|||
-- ======================================== |
|||
-- 4. 创建视图简化查询 |
|||
-- ======================================== |
|||
|
|||
-- 创建用户可用优惠券视图 |
|||
CREATE OR REPLACE VIEW v_user_available_coupons AS |
|||
SELECT |
|||
uc.*, |
|||
c.name as coupon_name, |
|||
c.description as coupon_description, |
|||
c.apply_range, |
|||
c.apply_range_config, |
|||
CASE |
|||
WHEN uc.end_time < NOW() THEN '已过期' |
|||
WHEN uc.status = 1 THEN '已使用' |
|||
WHEN uc.status = 0 THEN '可使用' |
|||
ELSE '未知状态' |
|||
END as status_desc |
|||
FROM shop_user_coupon uc |
|||
LEFT JOIN shop_coupon c ON uc.coupon_id = c.id |
|||
WHERE uc.deleted = 0; |
|||
|
|||
-- 创建优惠券统计视图 |
|||
CREATE OR REPLACE VIEW v_coupon_statistics AS |
|||
SELECT |
|||
user_id, |
|||
COUNT(*) as total_count, |
|||
SUM(CASE WHEN status = 0 AND end_time >= NOW() THEN 1 ELSE 0 END) as available_count, |
|||
SUM(CASE WHEN status = 1 THEN 1 ELSE 0 END) as used_count, |
|||
SUM(CASE WHEN status = 2 OR end_time < NOW() THEN 1 ELSE 0 END) as expired_count |
|||
FROM shop_user_coupon |
|||
WHERE deleted = 0 |
|||
GROUP BY user_id; |
|||
|
|||
-- ======================================== |
|||
-- 5. 存储过程：批量处理过期优惠券 |
|||
-- ======================================== |
|||
|
|||
DELIMITER $$ |
|||
|
|||
CREATE PROCEDURE IF NOT EXISTS sp_update_expired_coupons() |
|||
BEGIN |
|||
DECLARE done INT DEFAULT FALSE; |
|||
DECLARE update_count INT DEFAULT 0; |
|||
|
|||
-- 声明异常处理 |
|||
DECLARE CONTINUE HANDLER FOR SQLEXCEPTION |
|||
BEGIN |
|||
ROLLBACK; |
|||
RESIGNAL; |
|||
END; |
|||
|
|||
START TRANSACTION; |
|||
|
|||
-- 批量更新过期优惠券 |
|||
UPDATE shop_user_coupon |
|||
SET status = 2, is_expire = 1 |
|||
WHERE status = 0 |
|||
AND end_time < NOW() |
|||
AND deleted = 0; |
|||
|
|||
-- 获取更新数量 |
|||
SET update_count = ROW_COUNT(); |
|||
|
|||
COMMIT; |
|||
|
|||
-- 返回更新数量 |
|||
SELECT update_count as updated_count; |
|||
|
|||
END$$ |
|||
|
|||
DELIMITER ; |
|||
|
|||
-- ======================================== |
|||
-- 6. 性能监控查询 |
|||
-- ======================================== |
|||
|
|||
-- 查看优惠券状态分布 |
|||
SELECT |
|||
status, |
|||
CASE |
|||
WHEN status = 0 THEN '未使用' |
|||
WHEN status = 1 THEN '已使用' |
|||
WHEN status = 2 THEN '已过期' |
|||
ELSE '未知' |
|||
END as status_name, |
|||
COUNT(*) as count, |
|||
ROUND(COUNT(*) * 100.0 / (SELECT COUNT(*) FROM shop_user_coupon WHERE deleted = 0), 2) as percentage |
|||
FROM shop_user_coupon |
|||
WHERE deleted = 0 |
|||
GROUP BY status |
|||
ORDER BY status; |
|||
|
|||
-- 查看即将过期的优惠券（7天内） |
|||
SELECT |
|||
COUNT(*) as expiring_soon_count, |
|||
MIN(end_time) as earliest_expire_time, |
|||
MAX(end_time) as latest_expire_time |
|||
FROM shop_user_coupon |
|||
WHERE status = 0 |
|||
AND end_time BETWEEN NOW() AND DATE_ADD(NOW(), INTERVAL 7 DAY) |
|||
AND deleted = 0; |
|||
|
|||
-- 查看优惠券使用率统计 |
|||
SELECT |
|||
DATE(create_time) as date, |
|||
COUNT(*) as issued_count, |
|||
SUM(CASE WHEN status = 1 THEN 1 ELSE 0 END) as used_count, |
|||
ROUND(SUM(CASE WHEN status = 1 THEN 1 ELSE 0 END) * 100.0 / COUNT(*), 2) as usage_rate |
|||
FROM shop_user_coupon |
|||
WHERE deleted = 0 |
|||
AND create_time >= DATE_SUB(NOW(), INTERVAL 30 DAY) |
|||
GROUP BY DATE(create_time) |
|||
ORDER BY date DESC; |
|||
|
|||
-- ======================================== |
|||
-- 7. 清理和维护 |
|||
-- ======================================== |
|||
|
|||
-- 清理过期很久的优惠券记录（可选，谨慎使用） |
|||
-- DELETE FROM shop_user_coupon |
|||
-- WHERE status = 2 |
|||
-- AND end_time < DATE_SUB(NOW(), INTERVAL 1 YEAR) |
|||
-- AND deleted = 0; |
|||
|
|||
COMMIT; |
|||
@ -0,0 +1,113 @@ |
|||
package com.gxwebsoft.shop.service; |
|||
|
|||
import com.gxwebsoft.shop.entity.ShopUserCoupon; |
|||
import com.gxwebsoft.shop.service.CouponStatusService.CouponStatusResult; |
|||
import com.gxwebsoft.shop.service.CouponStatusService.CouponValidationResult; |
|||
import org.junit.jupiter.api.Test; |
|||
import org.springframework.beans.factory.annotation.Autowired; |
|||
import org.springframework.boot.test.context.SpringBootTest; |
|||
import org.springframework.test.context.ActiveProfiles; |
|||
|
|||
import java.math.BigDecimal; |
|||
import java.time.LocalDateTime; |
|||
import java.util.Arrays; |
|||
import java.util.List; |
|||
|
|||
import static org.junit.jupiter.api.Assertions.*; |
|||
|
|||
/** |
|||
* 优惠券状态管理服务测试 |
|||
* |
|||
* @author WebSoft |
|||
* @since 2025-01-15 |
|||
*/ |
|||
@SpringBootTest |
|||
@ActiveProfiles("dev") |
|||
public class CouponStatusServiceTest { |
|||
|
|||
@Autowired |
|||
private CouponStatusService couponStatusService; |
|||
|
|||
@Test |
|||
public void testCouponStatusConstants() { |
|||
// 测试状态常量
|
|||
assertEquals(0, ShopUserCoupon.STATUS_UNUSED); |
|||
assertEquals(1, ShopUserCoupon.STATUS_USED); |
|||
assertEquals(2, ShopUserCoupon.STATUS_EXPIRED); |
|||
|
|||
// 测试类型常量
|
|||
assertEquals(10, ShopUserCoupon.TYPE_REDUCE); |
|||
assertEquals(20, ShopUserCoupon.TYPE_DISCOUNT); |
|||
assertEquals(30, ShopUserCoupon.TYPE_FREE); |
|||
|
|||
// 测试适用范围常量
|
|||
assertEquals(10, ShopUserCoupon.APPLY_ALL); |
|||
assertEquals(20, ShopUserCoupon.APPLY_GOODS); |
|||
assertEquals(30, ShopUserCoupon.APPLY_CATEGORY); |
|||
} |
|||
|
|||
@Test |
|||
public void testCouponStatusMethods() { |
|||
// 创建测试优惠券
|
|||
ShopUserCoupon coupon = new ShopUserCoupon(); |
|||
coupon.setStatus(ShopUserCoupon.STATUS_UNUSED); |
|||
coupon.setEndTime(LocalDateTime.now().plusDays(7)); |
|||
|
|||
// 测试可用状态
|
|||
assertTrue(coupon.isAvailable()); |
|||
assertFalse(coupon.isUsed()); |
|||
assertFalse(coupon.isExpired()); |
|||
assertEquals("可使用", coupon.getStatusDesc()); |
|||
|
|||
// 测试已使用状态
|
|||
coupon.markAsUsed(123, "ORDER123"); |
|||
assertTrue(coupon.isUsed()); |
|||
assertFalse(coupon.isAvailable()); |
|||
assertEquals("已使用", coupon.getStatusDesc()); |
|||
assertEquals(Integer.valueOf(123), coupon.getOrderId()); |
|||
assertEquals("ORDER123", coupon.getOrderNo()); |
|||
|
|||
// 测试过期状态
|
|||
coupon.setStatus(ShopUserCoupon.STATUS_UNUSED); |
|||
coupon.setEndTime(LocalDateTime.now().minusDays(1)); |
|||
assertTrue(coupon.isExpired()); |
|||
assertFalse(coupon.isAvailable()); |
|||
assertEquals("已过期", coupon.getStatusDesc()); |
|||
} |
|||
|
|||
@Test |
|||
public void testValidateCouponForOrder() { |
|||
// 这个测试需要数据库中有实际的优惠券数据
|
|||
// 这里只是演示测试结构
|
|||
|
|||
List<Integer> goodsIds = Arrays.asList(1, 2, 3); |
|||
BigDecimal totalAmount = new BigDecimal("150.00"); |
|||
|
|||
// 注意：这个测试需要实际的优惠券ID，在真实环境中需要先创建测试数据
|
|||
// CouponValidationResult result = couponStatusService.validateCouponForOrder(1L, totalAmount, goodsIds);
|
|||
// assertNotNull(result);
|
|||
|
|||
System.out.println("优惠券验证测试需要实际的数据库数据"); |
|||
} |
|||
|
|||
@Test |
|||
public void testGetUserCouponsGroupByStatus() { |
|||
// 这个测试需要数据库中有实际的用户和优惠券数据
|
|||
// 这里只是演示测试结构
|
|||
|
|||
// 注意：这个测试需要实际的用户ID，在真实环境中需要先创建测试数据
|
|||
// CouponStatusResult result = couponStatusService.getUserCouponsGroupByStatus(1);
|
|||
// assertNotNull(result);
|
|||
// assertTrue(result.getTotalCount() >= 0);
|
|||
|
|||
System.out.println("用户优惠券分组测试需要实际的数据库数据"); |
|||
} |
|||
|
|||
@Test |
|||
public void testUpdateExpiredCoupons() { |
|||
// 测试批量更新过期优惠券
|
|||
int updatedCount = couponStatusService.updateExpiredCoupons(); |
|||
assertTrue(updatedCount >= 0); |
|||
System.out.println("更新了 " + updatedCount + " 张过期优惠券"); |
|||
} |
|||
} |
|||
Loading…
Reference in new issue