feat(用户): 添加已使用余额字段并实现订单和退款逻辑

在用户表中添加 use_balance 字段用于记录已使用余额
修改订单和退款审批服务，在扣款和退款时同步更新该字段

agileboot-domain/src/main/java/com/agileboot/domain/qywx/user/db/QyUserEntity.java

@@ -148,6 +148,10 @@ public class QyUserEntity extends BaseEntity<QyUserEntity> {
     @TableField("balance")
     private BigDecimal balance;
 
+    @ApiModelProperty("已使用用户余额")
+    @TableField("use_balance")
+    private BigDecimal useBalance;
+
     @ApiModelProperty("系统角色id")
     @TableField("sys_role_id")
     private Long sysRoleId;

agileboot-domain/src/main/java/com/agileboot/domain/qywx/user/dto/QyUserDTO.java

@@ -106,6 +106,9 @@ public class QyUserDTO {
     @ExcelColumn(name = "用户余额")
     private BigDecimal balance;
 
+    @ExcelColumn(name = "已使用用户余额")
+    private BigDecimal useBalance;
+
     @ExcelColumn(name = "系统角色ID")
     private Long sysRoleId;
 

agileboot-domain/src/main/java/com/agileboot/domain/shop/approval/ReturnApprovalApplicationService.java

@@ -192,6 +192,7 @@ public class ReturnApprovalApplicationService {
                 QyUserEntity qyUser = userService.getUserByUserId(userid, WeixinConstants.corpid);
                 if (null != qyUser) {
                     qyUser.setBalance(qyUser.getBalance().add(command.getReturnAmount()));
+                    qyUser.setUseBalance(qyUser.getUseBalance().subtract(command.getReturnAmount()));
                 }
                 userService.updateById(qyUser);
             } catch (Exception e) {

agileboot-domain/src/main/java/com/agileboot/domain/shop/order/OrderApplicationService.java

@@ -192,6 +192,7 @@ public class OrderApplicationService {
                 throw new ApiException(ErrorCode.Client.COMMON_REQUEST_PARAMETERS_INVALID, "余额不足");
             } else {
                 qyUser.setBalance(qyUser.getBalance().subtract(orderModel.getTotalAmount()));
+                qyUser.setUseBalance(qyUser.getUseBalance().add(orderModel.getTotalAmount()));
                 userService.updateById(qyUser);
             }
             // 金额转换（元转分）并四舍五入

sql/20250520_goods.sql

@@ -4,4 +4,8 @@ AFTER `goods_detail`;
 
 ALTER TABLE `qy_user` 
 ADD COLUMN `sys_role_id` BIGINT DEFAULT NULL COMMENT '系统角色id'
+AFTER `balance`;
+
+ALTER TABLE `qy_user` 
+ADD COLUMN `use_balance` decimal(15,2) NOT NULL DEFAULT '0.00' COMMENT '已使用用户余额'
 AFTER `balance`;