feat(tenant-balance): 新增提现站内信通知功能

在提现流程中，向租户联系人发送站内信通知，模板码 tx-001，携带提现金额参数。

keyboard-server/src/main/java/com/yolo/keyboard/controller/admin/tenantbalance/TenantBalanceController.java

@@ -126,6 +126,14 @@ public class TenantBalanceController {
         return success(BeanUtils.toBean(tenantBalancePage, TenantBalanceRespVO.class));
     }
 
+    @PostMapping("/withdraw")
+    @Operation(summary = "租户提现")
+    @PreAuthorize("@ss.hasPermission('system:tenant-balance:withdraw')")
+    public CommonResult<Boolean> withdraw(@Valid @RequestBody TenantBalanceWithdrawReqVO withdrawReqVO) {
+        tenantBalanceService.withdraw(withdrawReqVO);
+        return success(true);
+    }
+
 
     // ==================== 子表（租户积分记录） ====================
 

keyboard-server/src/main/java/com/yolo/keyboard/controller/admin/tenantbalance/vo/TenantBalancePageReqVO.java

@@ -1,6 +1,8 @@
 package com.yolo.keyboard.controller.admin.tenantbalance.vo;
 
 import lombok.*;
+
+import java.math.BigDecimal;
 import java.util.*;
 import io.swagger.v3.oas.annotations.media.Schema;
 import com.yolo.keyboard.framework.common.pojo.PageParam;
@@ -23,5 +25,6 @@ public class TenantBalancePageReqVO extends PageParam {
     private LocalDateTime updatedAt;
 
 
-
+    @Schema(description = "冻结金额")
+    private BigDecimal frozenAmt;
 }

keyboard-server/src/main/java/com/yolo/keyboard/controller/admin/tenantbalance/vo/TenantBalanceRespVO.java

@@ -2,6 +2,8 @@ package com.yolo.keyboard.controller.admin.tenantbalance.vo;
 
 import io.swagger.v3.oas.annotations.media.Schema;
 import lombok.*;
+
+import java.math.BigDecimal;
 import java.util.*;
 import org.springframework.format.annotation.DateTimeFormat;
 import java.time.LocalDateTime;
@@ -28,5 +30,6 @@ public class TenantBalanceRespVO {
     @ExcelProperty("更新时间")
     private LocalDateTime updatedAt;
 
-
+    @Schema(description = "冻结金额")
+    private BigDecimal frozenAmt;
 }

keyboard-server/src/main/java/com/yolo/keyboard/controller/admin/tenantbalance/vo/TenantBalanceSaveReqVO.java

@@ -2,6 +2,8 @@ package com.yolo.keyboard.controller.admin.tenantbalance.vo;
 
 import io.swagger.v3.oas.annotations.media.Schema;
 import lombok.*;
+
+import java.math.BigDecimal;
 import java.util.*;
 import jakarta.validation.constraints.*;
 import org.springframework.format.annotation.DateTimeFormat;
@@ -26,5 +28,7 @@ public class TenantBalanceSaveReqVO {
     @NotNull(message = "更新时间不能为空")
     private LocalDateTime updatedAt;
 
+    @Schema(description = "冻结金额")
+    private BigDecimal frozenAmt;
 
 }

keyboard-server/src/main/java/com/yolo/keyboard/controller/admin/tenantbalance/vo/TenantBalanceWithdrawReqVO.java

@@ -0,0 +1,50 @@
+package com.yolo.keyboard.controller.admin.tenantbalance.vo;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.DecimalMin;
+import jakarta.validation.constraints.NotEmpty;
+import jakarta.validation.constraints.NotNull;
+import lombok.Data;
+
+import java.math.BigDecimal;
+
+/**
+ * 管理后台 - 租户余额提现 Request VO
+ */
+@Schema(description = "管理后台 - 租户余额提现 Request VO")
+@Data
+public class TenantBalanceWithdrawReqVO {
+
+    @Schema(description = "提现金额", requiredMode = Schema.RequiredMode.REQUIRED, example = "1000")
+    @NotNull(message = "提现金额不能为空")
+    @DecimalMin(value = "0.01", message = "提现金额必须大于0")
+    private BigDecimal amount;
+
+    @Schema(description = "打款渠道：BANK/ALIPAY/WECHAT", requiredMode = Schema.RequiredMode.REQUIRED, example = "BANK")
+    @NotEmpty(message = "打款渠道不能为空")
+    private String payChannel;
+
+    @Schema(description = "收款方类型：PERSON（个人）/COMPANY（企业）", requiredMode = Schema.RequiredMode.REQUIRED, example = "PERSON")
+    @NotEmpty(message = "收款方类型不能为空")
+    private String payeeType;
+
+    @Schema(description = "收款人姓名或公司名称", requiredMode = Schema.RequiredMode.REQUIRED, example = "张三")
+    @NotEmpty(message = "收款人姓名不能为空")
+    private String payeeName;
+
+    @Schema(description = "收款账号（银行卡/支付宝等）", requiredMode = Schema.RequiredMode.REQUIRED, example = "6222021234567890123")
+    @NotEmpty(message = "收款账号不能为空")
+    private String payeeAccount;
+
+    @Schema(description = "收款银行名称（银行渠道必填）", example = "中国工商银行")
+    private String payeeBankName;
+
+    @Schema(description = "银行编码", example = "ICBC")
+    private String payeeBankCode;
+
+    @Schema(description = "银行支行名称", example = "北京分行朝阳支行")
+    private String payeeBankBranch;
+
+    @Schema(description = "备注", example = "提现备注")
+    private String remark;
+}

keyboard-server/src/main/java/com/yolo/keyboard/controller/admin/tenantwithdraworder/KeyboardTenantWithdrawOrderController.java

@@ -0,0 +1,104 @@
+package com.yolo.keyboard.controller.admin.tenantwithdraworder;
+
+import org.springframework.web.bind.annotation.*;
+import jakarta.annotation.Resource;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.security.access.prepost.PreAuthorize;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import io.swagger.v3.oas.annotations.Parameter;
+import io.swagger.v3.oas.annotations.Operation;
+
+import jakarta.validation.constraints.*;
+import jakarta.validation.*;
+import jakarta.servlet.http.*;
+import java.util.*;
+import java.io.IOException;
+
+import com.yolo.keyboard.framework.common.pojo.PageParam;
+import com.yolo.keyboard.framework.common.pojo.PageResult;
+import com.yolo.keyboard.framework.common.pojo.CommonResult;
+import com.yolo.keyboard.framework.common.util.object.BeanUtils;
+import static com.yolo.keyboard.framework.common.pojo.CommonResult.success;
+
+import com.yolo.keyboard.framework.excel.core.util.ExcelUtils;
+
+import com.yolo.keyboard.framework.apilog.core.annotation.ApiAccessLog;
+import static com.yolo.keyboard.framework.apilog.core.enums.OperateTypeEnum.*;
+
+import com.yolo.keyboard.controller.admin.tenantwithdraworder.vo.*;
+import com.yolo.keyboard.dal.dataobject.tenantwithdraworder.KeyboardTenantWithdrawOrderDO;
+import com.yolo.keyboard.service.tenantwithdraworder.KeyboardTenantWithdrawOrderService;
+
+@Tag(name = "管理后台 - 租户提现订单表（申请-审核-打款-完成/失败）")
+@RestController
+@RequestMapping("/keyboard/tenant-withdraw-order")
+@Validated
+public class KeyboardTenantWithdrawOrderController {
+
+    @Resource
+    private KeyboardTenantWithdrawOrderService tenantWithdrawOrderService;
+
+    @PostMapping("/create")
+    @Operation(summary = "创建租户提现订单表（申请-审核-打款-完成/失败）")
+    @PreAuthorize("@ss.hasPermission('keyboard:tenant-withdraw-order:create')")
+    public CommonResult<Long> createTenantWithdrawOrder(@Valid @RequestBody KeyboardTenantWithdrawOrderSaveReqVO createReqVO) {
+        return success(tenantWithdrawOrderService.createTenantWithdrawOrder(createReqVO));
+    }
+
+    @PutMapping("/update")
+    @Operation(summary = "更新租户提现订单表（申请-审核-打款-完成/失败）")
+    @PreAuthorize("@ss.hasPermission('keyboard:tenant-withdraw-order:update')")
+    public CommonResult<Boolean> updateTenantWithdrawOrder(@Valid @RequestBody KeyboardTenantWithdrawOrderSaveReqVO updateReqVO) {
+        tenantWithdrawOrderService.updateTenantWithdrawOrder(updateReqVO);
+        return success(true);
+    }
+
+    @DeleteMapping("/delete")
+    @Operation(summary = "删除租户提现订单表（申请-审核-打款-完成/失败）")
+    @Parameter(name = "id", description = "编号", required = true)
+    @PreAuthorize("@ss.hasPermission('keyboard:tenant-withdraw-order:delete')")
+    public CommonResult<Boolean> deleteTenantWithdrawOrder(@RequestParam("id") Long id) {
+        tenantWithdrawOrderService.deleteTenantWithdrawOrder(id);
+        return success(true);
+    }
+
+    @DeleteMapping("/delete-list")
+    @Parameter(name = "ids", description = "编号", required = true)
+    @Operation(summary = "批量删除租户提现订单表（申请-审核-打款-完成/失败）")
+                @PreAuthorize("@ss.hasPermission('keyboard:tenant-withdraw-order:delete')")
+    public CommonResult<Boolean> deleteTenantWithdrawOrderList(@RequestParam("ids") List<Long> ids) {
+        tenantWithdrawOrderService.deleteTenantWithdrawOrderListByIds(ids);
+        return success(true);
+    }
+
+    @GetMapping("/get")
+    @Operation(summary = "获得租户提现订单表（申请-审核-打款-完成/失败）")
+    @Parameter(name = "id", description = "编号", required = true, example = "1024")
+    @PreAuthorize("@ss.hasPermission('keyboard:tenant-withdraw-order:query')")
+    public CommonResult<KeyboardTenantWithdrawOrderRespVO> getTenantWithdrawOrder(@RequestParam("id") Long id) {
+        KeyboardTenantWithdrawOrderDO tenantWithdrawOrder = tenantWithdrawOrderService.getTenantWithdrawOrder(id);
+        return success(BeanUtils.toBean(tenantWithdrawOrder, KeyboardTenantWithdrawOrderRespVO.class));
+    }
+
+    @GetMapping("/page")
+    @Operation(summary = "获得租户提现订单表（申请-审核-打款-完成/失败）分页")
+    @PreAuthorize("@ss.hasPermission('keyboard:tenant-withdraw-order:query')")
+    public CommonResult<PageResult<KeyboardTenantWithdrawOrderRespVO>> getTenantWithdrawOrderPage(@Valid KeyboardTenantWithdrawOrderPageReqVO pageReqVO) {
+        PageResult<KeyboardTenantWithdrawOrderDO> pageResult = tenantWithdrawOrderService.getTenantWithdrawOrderPage(pageReqVO);
+        return success(BeanUtils.toBean(pageResult, KeyboardTenantWithdrawOrderRespVO.class));
+    }
+
+    @GetMapping("/export-excel")
+    @Operation(summary = "导出租户提现订单表（申请-审核-打款-完成/失败） Excel")
+    @PreAuthorize("@ss.hasPermission('keyboard:tenant-withdraw-order:export')")
+    @ApiAccessLog(operateType = EXPORT)
+    public void exportTenantWithdrawOrderExcel(@Valid KeyboardTenantWithdrawOrderPageReqVO pageReqVO,
+              HttpServletResponse response) throws IOException {
+        pageReqVO.setPageSize(PageParam.PAGE_SIZE_NONE);
+        List<KeyboardTenantWithdrawOrderDO> list = tenantWithdrawOrderService.getTenantWithdrawOrderPage(pageReqVO).getList();
+        // 导出 Excel
+        ExcelUtils.write(response, "租户提现订单表（申请-审核-打款-完成/失败）.xls", "数据", KeyboardTenantWithdrawOrderRespVO.class,
+                        BeanUtils.toBean(list, KeyboardTenantWithdrawOrderRespVO.class));
+    }
+
+}

keyboard-server/src/main/java/com/yolo/keyboard/controller/admin/tenantwithdraworder/vo/KeyboardTenantWithdrawOrderPageReqVO.java

@@ -0,0 +1,114 @@
+package com.yolo.keyboard.controller.admin.tenantwithdraworder.vo;
+
+import lombok.*;
+import java.util.*;
+import io.swagger.v3.oas.annotations.media.Schema;
+import com.yolo.keyboard.framework.common.pojo.PageParam;
+import org.springframework.format.annotation.DateTimeFormat;
+import java.time.LocalDateTime;
+
+import static com.yolo.keyboard.framework.common.util.date.DateUtils.FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND;
+
+@Schema(description = "管理后台 - 租户提现订单表（申请-审核-打款-完成/失败）分页 Request VO")
+@Data
+public class KeyboardTenantWithdrawOrderPageReqVO extends PageParam {
+
+    @Schema(description = "提现单号（业务唯一）")
+    private String withdrawNo;
+
+    @Schema(description = "业务幂等号（防重复提交）")
+    private String bizNo;
+
+    @Schema(description = "币种（默认 CNY）")
+    private String currency;
+
+    @Schema(description = "提现申请金额（单位：分）")
+    private Long amount;
+
+    @Schema(description = "手续费金额（单位：分）")
+    private Long feeAmount;
+
+    @Schema(description = "实际到账金额（单位：分 = amount - fee_amount）")
+    private Long actualAmount;
+
+    @Schema(description = "打款渠道：BANK/ALIPAY/WECHAT/PAYPAL 等")
+    private String payChannel;
+
+    @Schema(description = "收款方类型：PERSON（个人）/COMPANY（企业）", example = "1")
+    private String payeeType;
+
+    @Schema(description = "收款人姓名或公司名称（快照）", example = "张三")
+    private String payeeName;
+
+    @Schema(description = "收款账号（银行卡/支付宝等，建议加密或脱敏）", example = "5425")
+    private String payeeAccount;
+
+    @Schema(description = "收款银行名称", example = "芋艿")
+    private String payeeBankName;
+
+    @Schema(description = "银行编码（可选）")
+    private String payeeBankCode;
+
+    @Schema(description = "银行支行名称（可选）")
+    private String payeeBankBranch;
+
+    @Schema(description = "提现状态：APPLIED/APPROVED/REJECTED/PAYING/PAID/FAILED/CANCELED", example = "1")
+    private String status;
+
+    @Schema(description = "审核状态：PENDING/PASSED/REJECTED", example = "1")
+    private String auditStatus;
+
+    @Schema(description = "拒绝原因或打款失败原因", example = "不香")
+    private String reason;
+
+    @Schema(description = "提现申请时间")
+    @DateTimeFormat(pattern = FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND)
+    private LocalDateTime[] applyTime;
+
+    @Schema(description = "审核完成时间")
+    @DateTimeFormat(pattern = FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND)
+    private LocalDateTime[] auditTime;
+
+    @Schema(description = "发起打款时间（请求第三方）")
+    @DateTimeFormat(pattern = FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND)
+    private LocalDateTime[] payTime;
+
+    @Schema(description = "打款成功时间（第三方确认）")
+    @DateTimeFormat(pattern = FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND)
+    private LocalDateTime[] paidTime;
+
+    @Schema(description = "业务终态时间（成功/失败/取消）")
+    @DateTimeFormat(pattern = FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND)
+    private LocalDateTime[] finishTime;
+
+    @Schema(description = "打款批次号（内部使用）")
+    private String payerBatchNo;
+
+    @Schema(description = "第三方打款交易号/流水号（对账用）")
+    private String channelTradeNo;
+
+    @Schema(description = "第三方返回的原始报文（用于排查）")
+    private Object channelRaw;
+
+    @Schema(description = "关联余额流水ID（冻结/扣减/返还）", example = "30641")
+    private Long balanceTxnId;
+
+    @Schema(description = "乐观锁版本号")
+    private Integer version;
+
+    @Schema(description = "提现申请人ID", example = "6858")
+    private Long creatorId;
+
+    @Schema(description = "审核人ID", example = "15039")
+    private Long auditorId;
+
+    @Schema(description = "打款操作人ID", example = "8850")
+    private Long payerId;
+
+    @Schema(description = "创建时间")
+    private LocalDateTime createdAt;
+
+    @Schema(description = "更新时间")
+    private LocalDateTime updatedAt;
+
+}

keyboard-server/src/main/java/com/yolo/keyboard/controller/admin/tenantwithdraworder/vo/KeyboardTenantWithdrawOrderRespVO.java

@@ -0,0 +1,145 @@
+package com.yolo.keyboard.controller.admin.tenantwithdraworder.vo;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.*;
+
+import java.math.BigDecimal;
+import java.util.*;
+import org.springframework.format.annotation.DateTimeFormat;
+import java.time.LocalDateTime;
+import cn.idev.excel.annotation.*;
+
+@Schema(description = "管理后台 - 租户提现订单表（申请-审核-打款-完成/失败） Response VO")
+@Data
+@ExcelIgnoreUnannotated
+public class KeyboardTenantWithdrawOrderRespVO {
+
+    @Schema(description = "主键", requiredMode = Schema.RequiredMode.REQUIRED, example = "20442")
+    @ExcelProperty("主键")
+    private Long id;
+
+    @Schema(description = "提现单号（业务唯一）", requiredMode = Schema.RequiredMode.REQUIRED)
+    @ExcelProperty("提现单号（业务唯一）")
+    private String withdrawNo;
+
+    @Schema(description = "业务幂等号（防重复提交）")
+    @ExcelProperty("业务幂等号（防重复提交）")
+    private String bizNo;
+
+    @Schema(description = "币种（默认 CNY）", requiredMode = Schema.RequiredMode.REQUIRED)
+    @ExcelProperty("币种（默认 CNY）")
+    private String currency;
+
+    @Schema(description = "提现申请金额（单位：元）", requiredMode = Schema.RequiredMode.REQUIRED)
+    @ExcelProperty("提现申请金额（单位：元）")
+    private BigDecimal amount;
+
+    @Schema(description = "手续费金额（单位：元）", requiredMode = Schema.RequiredMode.REQUIRED)
+    @ExcelProperty("手续费金额（单位：元）")
+    private BigDecimal feeAmount;
+
+    @Schema(description = "实际到账金额（单位：元 = amount - fee_amount）", requiredMode = Schema.RequiredMode.REQUIRED)
+    @ExcelProperty("实际到账金额（单位：元 = amount - fee_amount）")
+    private BigDecimal actualAmount;
+
+    @Schema(description = "打款渠道：BANK/ALIPAY/WECHAT/PAYPAL 等", requiredMode = Schema.RequiredMode.REQUIRED)
+    @ExcelProperty("打款渠道：BANK/ALIPAY/WECHAT/PAYPAL 等")
+    private String payChannel;
+
+    @Schema(description = "收款方类型：PERSON（个人）/COMPANY（企业）", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    @ExcelProperty("收款方类型：PERSON（个人）/COMPANY（企业）")
+    private String payeeType;
+
+    @Schema(description = "收款人姓名或公司名称（快照）", example = "张三")
+    @ExcelProperty("收款人姓名或公司名称（快照）")
+    private String payeeName;
+
+    @Schema(description = "收款账号（银行卡/支付宝等，建议加密或脱敏）", example = "5425")
+    @ExcelProperty("收款账号（银行卡/支付宝等，建议加密或脱敏）")
+    private String payeeAccount;
+
+    @Schema(description = "收款银行名称", example = "芋艿")
+    @ExcelProperty("收款银行名称")
+    private String payeeBankName;
+
+    @Schema(description = "银行编码（可选）")
+    @ExcelProperty("银行编码（可选）")
+    private String payeeBankCode;
+
+    @Schema(description = "银行支行名称（可选）")
+    @ExcelProperty("银行支行名称（可选）")
+    private String payeeBankBranch;
+
+    @Schema(description = "提现状态：APPLIED/APPROVED/REJECTED/PAYING/PAID/FAILED/CANCELED", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    @ExcelProperty("提现状态：APPLIED/APPROVED/REJECTED/PAYING/PAID/FAILED/CANCELED")
+    private String status;
+
+    @Schema(description = "审核状态：PENDING/PASSED/REJECTED", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    @ExcelProperty("审核状态：PENDING/PASSED/REJECTED")
+    private String auditStatus;
+
+    @Schema(description = "拒绝原因或打款失败原因", example = "不香")
+    @ExcelProperty("拒绝原因或打款失败原因")
+    private String reason;
+
+    @Schema(description = "提现申请时间", requiredMode = Schema.RequiredMode.REQUIRED)
+    @ExcelProperty("提现申请时间")
+    private LocalDateTime applyTime;
+
+    @Schema(description = "审核完成时间")
+    @ExcelProperty("审核完成时间")
+    private LocalDateTime auditTime;
+
+    @Schema(description = "发起打款时间（请求第三方）")
+    @ExcelProperty("发起打款时间（请求第三方）")
+    private LocalDateTime payTime;
+
+    @Schema(description = "打款成功时间（第三方确认）")
+    @ExcelProperty("打款成功时间（第三方确认）")
+    private LocalDateTime paidTime;
+
+    @Schema(description = "业务终态时间（成功/失败/取消）")
+    @ExcelProperty("业务终态时间（成功/失败/取消）")
+    private LocalDateTime finishTime;
+
+    @Schema(description = "打款批次号（内部使用）")
+    @ExcelProperty("打款批次号（内部使用）")
+    private String payerBatchNo;
+
+    @Schema(description = "第三方打款交易号/流水号（对账用）")
+    @ExcelProperty("第三方打款交易号/流水号（对账用）")
+    private String channelTradeNo;
+
+    @Schema(description = "第三方返回的原始报文（用于排查）")
+    @ExcelProperty("第三方返回的原始报文（用于排查）")
+    private Object channelRaw;
+
+    @Schema(description = "关联余额流水ID（冻结/扣减/返还）", example = "30641")
+    @ExcelProperty("关联余额流水ID（冻结/扣减/返还）")
+    private Long balanceTxnId;
+
+    @Schema(description = "乐观锁版本号", requiredMode = Schema.RequiredMode.REQUIRED)
+    @ExcelProperty("乐观锁版本号")
+    private Integer version;
+
+    @Schema(description = "提现申请人ID", example = "6858")
+    @ExcelProperty("提现申请人ID")
+    private Long creatorId;
+
+    @Schema(description = "审核人ID", example = "15039")
+    @ExcelProperty("审核人ID")
+    private Long auditorId;
+
+    @Schema(description = "打款操作人ID", example = "8850")
+    @ExcelProperty("打款操作人ID")
+    private Long payerId;
+
+    @Schema(description = "创建时间", requiredMode = Schema.RequiredMode.REQUIRED)
+    @ExcelProperty("创建时间")
+    private LocalDateTime createdAt;
+
+    @Schema(description = "更新时间", requiredMode = Schema.RequiredMode.REQUIRED)
+    @ExcelProperty("更新时间")
+    private LocalDateTime updatedAt;
+
+}

keyboard-server/src/main/java/com/yolo/keyboard/controller/admin/tenantwithdraworder/vo/KeyboardTenantWithdrawOrderSaveReqVO.java

@@ -0,0 +1,125 @@
+package com.yolo.keyboard.controller.admin.tenantwithdraworder.vo;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.*;
+
+import java.math.BigDecimal;
+import java.util.*;
+import jakarta.validation.constraints.*;
+import org.springframework.format.annotation.DateTimeFormat;
+import java.time.LocalDateTime;
+
+@Schema(description = "管理后台 - 租户提现订单表（申请-审核-打款-完成/失败）新增/修改 Request VO")
+@Data
+public class KeyboardTenantWithdrawOrderSaveReqVO {
+
+    @Schema(description = "主键", requiredMode = Schema.RequiredMode.REQUIRED, example = "20442")
+    private Long id;
+
+    @Schema(description = "提现单号（业务唯一）", requiredMode = Schema.RequiredMode.REQUIRED)
+    @NotEmpty(message = "提现单号（业务唯一）不能为空")
+    private String withdrawNo;
+
+    @Schema(description = "业务幂等号（防重复提交）")
+    private String bizNo;
+
+    @Schema(description = "币种（默认 CNY）", requiredMode = Schema.RequiredMode.REQUIRED)
+    @NotEmpty(message = "币种（默认 CNY）不能为空")
+    private String currency;
+
+    @Schema(description = "提现申请金额（单位：元）", requiredMode = Schema.RequiredMode.REQUIRED)
+    @NotNull(message = "提现申请金额不能为空")
+    private BigDecimal amount;
+
+    @Schema(description = "手续费金额（单位：元）", requiredMode = Schema.RequiredMode.REQUIRED)
+    @NotNull(message = "手续费金额不能为空")
+    private BigDecimal feeAmount;
+
+    @Schema(description = "实际到账金额（单位：元 = amount - fee_amount）", requiredMode = Schema.RequiredMode.REQUIRED)
+    @NotNull(message = "实际到账金额不能为空")
+    private BigDecimal actualAmount;
+
+    @Schema(description = "打款渠道：BANK/ALIPAY/WECHAT/PAYPAL 等", requiredMode = Schema.RequiredMode.REQUIRED)
+    @NotEmpty(message = "打款渠道：BANK/ALIPAY/WECHAT/PAYPAL 等不能为空")
+    private String payChannel;
+
+    @Schema(description = "收款方类型：PERSON（个人）/COMPANY（企业）", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    @NotEmpty(message = "收款方类型：PERSON（个人）/COMPANY（企业）不能为空")
+    private String payeeType;
+
+    @Schema(description = "收款人姓名或公司名称（快照）", example = "张三")
+    private String payeeName;
+
+    @Schema(description = "收款账号（银行卡/支付宝等，建议加密或脱敏）", example = "5425")
+    private String payeeAccount;
+
+    @Schema(description = "收款银行名称", example = "芋艿")
+    private String payeeBankName;
+
+    @Schema(description = "银行编码（可选）")
+    private String payeeBankCode;
+
+    @Schema(description = "银行支行名称（可选）")
+    private String payeeBankBranch;
+
+    @Schema(description = "提现状态：APPLIED/APPROVED/REJECTED/PAYING/PAID/FAILED/CANCELED", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    @NotEmpty(message = "提现状态：APPLIED/APPROVED/REJECTED/PAYING/PAID/FAILED/CANCELED不能为空")
+    private String status;
+
+    @Schema(description = "审核状态：PENDING/PASSED/REJECTED", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    @NotEmpty(message = "审核状态：PENDING/PASSED/REJECTED不能为空")
+    private String auditStatus;
+
+    @Schema(description = "拒绝原因或打款失败原因", example = "不香")
+    private String reason;
+
+    @Schema(description = "提现申请时间", requiredMode = Schema.RequiredMode.REQUIRED)
+    @NotNull(message = "提现申请时间不能为空")
+    private LocalDateTime applyTime;
+
+    @Schema(description = "审核完成时间")
+    private LocalDateTime auditTime;
+
+    @Schema(description = "发起打款时间（请求第三方）")
+    private LocalDateTime payTime;
+
+    @Schema(description = "打款成功时间（第三方确认）")
+    private LocalDateTime paidTime;
+
+    @Schema(description = "业务终态时间（成功/失败/取消）")
+    private LocalDateTime finishTime;
+
+    @Schema(description = "打款批次号（内部使用）")
+    private String payerBatchNo;
+
+    @Schema(description = "第三方打款交易号/流水号（对账用）")
+    private String channelTradeNo;
+
+    @Schema(description = "第三方返回的原始报文（用于排查）")
+    private Object channelRaw;
+
+    @Schema(description = "关联余额流水ID（冻结/扣减/返还）", example = "30641")
+    private Long balanceTxnId;
+
+    @Schema(description = "乐观锁版本号", requiredMode = Schema.RequiredMode.REQUIRED)
+    @NotNull(message = "乐观锁版本号不能为空")
+    private Integer version;
+
+    @Schema(description = "提现申请人ID", example = "6858")
+    private Long creatorId;
+
+    @Schema(description = "审核人ID", example = "15039")
+    private Long auditorId;
+
+    @Schema(description = "打款操作人ID", example = "8850")
+    private Long payerId;
+
+    @Schema(description = "创建时间", requiredMode = Schema.RequiredMode.REQUIRED)
+    @NotNull(message = "创建时间不能为空")
+    private LocalDateTime createdAt;
+
+    @Schema(description = "更新时间", requiredMode = Schema.RequiredMode.REQUIRED)
+    @NotNull(message = "更新时间不能为空")
+    private LocalDateTime updatedAt;
+
+}

keyboard-server/src/main/java/com/yolo/keyboard/dal/dataobject/tenantbalance/TenantBalanceDO.java

@@ -44,5 +44,9 @@ public class TenantBalanceDO extends BaseDO {
      */
     private LocalDateTime updatedAt;
 
+    /**
+     * 冻结金额
+     */
+    private BigDecimal frozenAmt;
 
 }

keyboard-server/src/main/java/com/yolo/keyboard/dal/dataobject/tenantwithdraworder/KeyboardTenantWithdrawOrderDO.java

@@ -0,0 +1,165 @@
+package com.yolo.keyboard.dal.dataobject.tenantwithdraworder;
+
+import com.yolo.keyboard.framework.tenant.core.aop.TenantIgnore;
+import lombok.*;
+
+import java.math.BigDecimal;
+import java.util.*;
+import java.time.LocalDateTime;
+import java.time.LocalDateTime;
+import java.time.LocalDateTime;
+import java.time.LocalDateTime;
+import java.time.LocalDateTime;
+import java.time.LocalDateTime;
+import java.time.LocalDateTime;
+import com.baomidou.mybatisplus.annotation.*;
+import com.yolo.keyboard.framework.mybatis.core.dataobject.BaseDO;
+
+/**
+ * 租户提现订单表（申请-审核-打款-完成/失败） DO
+ *
+ * @author ziin
+ */
+@TableName("system_tenant_withdraw_order")
+@KeySequence("system_tenant_withdraw_order_seq") // 用于 Oracle、PostgreSQL、Kingbase、DB2、H2 数据库的主键自增。如果是 MySQL 等数据库，可不写。
+@Data
+@ToString(callSuper = true)
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+@TenantIgnore
+public class KeyboardTenantWithdrawOrderDO {
+
+    /**
+     * 主键
+     */
+    @TableId
+    private Long id;
+    /**
+     * 提现单号（业务唯一）
+     */
+    private String withdrawNo;
+    /**
+     * 业务幂等号（防重复提交）
+     */
+    private String bizNo;
+    /**
+     * 币种（默认 CNY）
+     */
+    private String currency;
+    /**
+     * 提现申请金额（单位：元）
+     */
+    private BigDecimal amount;
+    /**
+     * 手续费金额（单位：元）
+     */
+    private BigDecimal feeAmount;
+    /**
+     * 实际到账金额（单位：元 = amount - fee_amount）
+     */
+    private BigDecimal actualAmount;
+    /**
+     * 打款渠道：BANK/ALIPAY/WECHAT/PAYPAL 等
+     */
+    private String payChannel;
+    /**
+     * 收款方类型：PERSON（个人）/COMPANY（企业）
+     */
+    private String payeeType;
+    /**
+     * 收款人姓名或公司名称（快照）
+     */
+    private String payeeName;
+    /**
+     * 收款账号（银行卡/支付宝等，建议加密或脱敏）
+     */
+    private String payeeAccount;
+    /**
+     * 收款银行名称
+     */
+    private String payeeBankName;
+    /**
+     * 银行编码（可选）
+     */
+    private String payeeBankCode;
+    /**
+     * 银行支行名称（可选）
+     */
+    private String payeeBankBranch;
+    /**
+     * 提现状态：APPLIED/APPROVED/REJECTED/PAYING/PAID/FAILED/CANCELED
+     */
+    private String status;
+    /**
+     * 审核状态：PENDING/PASSED/REJECTED
+     */
+    private String auditStatus;
+    /**
+     * 拒绝原因或打款失败原因
+     */
+    private String reason;
+    /**
+     * 提现申请时间
+     */
+    private LocalDateTime applyTime;
+    /**
+     * 审核完成时间
+     */
+    private LocalDateTime auditTime;
+    /**
+     * 发起打款时间（请求第三方）
+     */
+    private LocalDateTime payTime;
+    /**
+     * 打款成功时间（第三方确认）
+     */
+    private LocalDateTime paidTime;
+    /**
+     * 业务终态时间（成功/失败/取消）
+     */
+    private LocalDateTime finishTime;
+    /**
+     * 打款批次号（内部使用）
+     */
+    private String payerBatchNo;
+    /**
+     * 第三方打款交易号/流水号（对账用）
+     */
+    private String channelTradeNo;
+    /**
+     * 第三方返回的原始报文（用于排查）
+     */
+    private Object channelRaw;
+    /**
+     * 关联余额流水ID（冻结/扣减/返还）
+     */
+    private Long balanceTxnId;
+    /**
+     * 乐观锁版本号
+     */
+    @Version
+    private Integer version;
+    /**
+     * 提现申请人ID
+     */
+    private Long creatorId;
+    /**
+     * 审核人ID
+     */
+    private Long auditorId;
+    /**
+     * 打款操作人ID
+     */
+    private Long payerId;
+    /**
+     * 创建时间
+     */
+    private LocalDateTime createdAt;
+    /**
+     * 更新时间
+     */
+    private LocalDateTime updatedAt;
+
+    private Long tenantId;
+}

keyboard-server/src/main/java/com/yolo/keyboard/dal/mysql/tenantwithdraworder/KeyboardTenantWithdrawOrderMapper.java

@@ -0,0 +1,56 @@
+package com.yolo.keyboard.dal.mysql.tenantwithdraworder;
+
+import java.util.*;
+
+import com.yolo.keyboard.framework.common.pojo.PageResult;
+import com.yolo.keyboard.framework.mybatis.core.query.LambdaQueryWrapperX;
+import com.yolo.keyboard.framework.mybatis.core.mapper.BaseMapperX;
+import com.yolo.keyboard.dal.dataobject.tenantwithdraworder.KeyboardTenantWithdrawOrderDO;
+import org.apache.ibatis.annotations.Mapper;
+import com.yolo.keyboard.controller.admin.tenantwithdraworder.vo.*;
+
+/**
+ * 租户提现订单表（申请-审核-打款-完成/失败） Mapper
+ *
+ * @author ziin
+ */
+@Mapper
+public interface KeyboardTenantWithdrawOrderMapper extends BaseMapperX<KeyboardTenantWithdrawOrderDO> {
+
+    default PageResult<KeyboardTenantWithdrawOrderDO> selectPage(KeyboardTenantWithdrawOrderPageReqVO reqVO) {
+        return selectPage(reqVO, new LambdaQueryWrapperX<KeyboardTenantWithdrawOrderDO>()
+                .eqIfPresent(KeyboardTenantWithdrawOrderDO::getWithdrawNo, reqVO.getWithdrawNo())
+                .eqIfPresent(KeyboardTenantWithdrawOrderDO::getBizNo, reqVO.getBizNo())
+                .eqIfPresent(KeyboardTenantWithdrawOrderDO::getCurrency, reqVO.getCurrency())
+                .eqIfPresent(KeyboardTenantWithdrawOrderDO::getAmount, reqVO.getAmount())
+                .eqIfPresent(KeyboardTenantWithdrawOrderDO::getFeeAmount, reqVO.getFeeAmount())
+                .eqIfPresent(KeyboardTenantWithdrawOrderDO::getActualAmount, reqVO.getActualAmount())
+                .eqIfPresent(KeyboardTenantWithdrawOrderDO::getPayChannel, reqVO.getPayChannel())
+                .eqIfPresent(KeyboardTenantWithdrawOrderDO::getPayeeType, reqVO.getPayeeType())
+                .likeIfPresent(KeyboardTenantWithdrawOrderDO::getPayeeName, reqVO.getPayeeName())
+                .eqIfPresent(KeyboardTenantWithdrawOrderDO::getPayeeAccount, reqVO.getPayeeAccount())
+                .likeIfPresent(KeyboardTenantWithdrawOrderDO::getPayeeBankName, reqVO.getPayeeBankName())
+                .eqIfPresent(KeyboardTenantWithdrawOrderDO::getPayeeBankCode, reqVO.getPayeeBankCode())
+                .eqIfPresent(KeyboardTenantWithdrawOrderDO::getPayeeBankBranch, reqVO.getPayeeBankBranch())
+                .eqIfPresent(KeyboardTenantWithdrawOrderDO::getStatus, reqVO.getStatus())
+                .eqIfPresent(KeyboardTenantWithdrawOrderDO::getAuditStatus, reqVO.getAuditStatus())
+                .eqIfPresent(KeyboardTenantWithdrawOrderDO::getReason, reqVO.getReason())
+                .betweenIfPresent(KeyboardTenantWithdrawOrderDO::getApplyTime, reqVO.getApplyTime())
+                .betweenIfPresent(KeyboardTenantWithdrawOrderDO::getAuditTime, reqVO.getAuditTime())
+                .betweenIfPresent(KeyboardTenantWithdrawOrderDO::getPayTime, reqVO.getPayTime())
+                .betweenIfPresent(KeyboardTenantWithdrawOrderDO::getPaidTime, reqVO.getPaidTime())
+                .betweenIfPresent(KeyboardTenantWithdrawOrderDO::getFinishTime, reqVO.getFinishTime())
+                .eqIfPresent(KeyboardTenantWithdrawOrderDO::getPayerBatchNo, reqVO.getPayerBatchNo())
+                .eqIfPresent(KeyboardTenantWithdrawOrderDO::getChannelTradeNo, reqVO.getChannelTradeNo())
+                .eqIfPresent(KeyboardTenantWithdrawOrderDO::getChannelRaw, reqVO.getChannelRaw())
+                .eqIfPresent(KeyboardTenantWithdrawOrderDO::getBalanceTxnId, reqVO.getBalanceTxnId())
+                .eqIfPresent(KeyboardTenantWithdrawOrderDO::getVersion, reqVO.getVersion())
+                .eqIfPresent(KeyboardTenantWithdrawOrderDO::getCreatorId, reqVO.getCreatorId())
+                .eqIfPresent(KeyboardTenantWithdrawOrderDO::getAuditorId, reqVO.getAuditorId())
+                .eqIfPresent(KeyboardTenantWithdrawOrderDO::getPayerId, reqVO.getPayerId())
+                .eqIfPresent(KeyboardTenantWithdrawOrderDO::getCreatedAt, reqVO.getCreatedAt())
+                .eqIfPresent(KeyboardTenantWithdrawOrderDO::getUpdatedAt, reqVO.getUpdatedAt())
+                .orderByDesc(KeyboardTenantWithdrawOrderDO::getId));
+    }
+
+}

keyboard-server/src/main/java/com/yolo/keyboard/service/tenantbalance/TenantBalanceService.java

@@ -129,5 +129,11 @@ public interface TenantBalanceService {
      */
     TenantBalanceTransactionDO getTenantBalanceTransaction(Long id);
 
+    /**
+     * 租户提现
+     *
+     * @param withdrawReqVO 提现信息
+     */
+    void withdraw(@Valid TenantBalanceWithdrawReqVO withdrawReqVO);
 
 }

keyboard-server/src/main/java/com/yolo/keyboard/service/tenantbalance/TenantBalanceServiceImpl.java

@@ -1,11 +1,17 @@
 package com.yolo.keyboard.service.tenantbalance;
 
 import cn.hutool.core.collection.CollUtil;
+import cn.hutool.json.JSONUtil;
 import com.yolo.keyboard.dal.dataobject.tenantbalancetransaction.TenantBalanceTransactionDO;
+import com.yolo.keyboard.dal.dataobject.tenantwithdraworder.KeyboardTenantWithdrawOrderDO;
 import com.yolo.keyboard.dal.mysql.tenantbalancetransaction.TenantBalanceTransactionMapper;
+import com.yolo.keyboard.dal.mysql.tenantwithdraworder.KeyboardTenantWithdrawOrderMapper;
 import com.yolo.keyboard.framework.common.util.collection.CollectionUtils;
 import com.yolo.keyboard.framework.mybatis.core.query.LambdaQueryWrapperX;
 import com.yolo.keyboard.framework.tenant.core.context.TenantContextHolder;
+import com.yolo.keyboard.module.infra.api.config.ConfigApi;
+import com.yolo.keyboard.module.system.api.notify.NotifyMessageSendApi;
+import com.yolo.keyboard.module.system.api.notify.dto.NotifySendSingleToUserReqDTO;
 import com.yolo.keyboard.utils.BizNoGenerator;
 import org.springframework.stereotype.Service;
 import jakarta.annotation.Resource;
@@ -13,6 +19,8 @@ import org.springframework.validation.annotation.Validated;
 import org.springframework.transaction.annotation.Transactional;
 
 import java.math.BigDecimal;
+import java.time.LocalDate;
+import java.time.LocalDateTime;
 import java.util.*;
 import com.yolo.keyboard.controller.admin.tenantbalance.vo.*;
 import com.yolo.keyboard.dal.dataobject.tenantbalance.TenantBalanceDO;
@@ -27,8 +35,7 @@ import com.yolo.keyboard.module.system.dal.mysql.tenant.TenantMapper;
 import static com.yolo.keyboard.framework.common.exception.util.ServiceExceptionUtil.exception;
 import static com.yolo.keyboard.framework.common.util.collection.CollectionUtils.convertList;
 import static com.yolo.keyboard.framework.common.util.collection.CollectionUtils.diffList;
-import static com.yolo.keyboard.module.infra.enums.ErrorCodeConstants.TENANT_BALANCE_NOT_EXISTS;
-import static com.yolo.keyboard.module.infra.enums.ErrorCodeConstants.TENANT_BALANCE_TRANSACTION_NOT_EXISTS;
+import static com.yolo.keyboard.module.infra.enums.ErrorCodeConstants.*;
 
 /**
  * 租户余额 Service 实现类
@@ -48,6 +55,18 @@ public class TenantBalanceServiceImpl implements TenantBalanceService {
     @Resource
     private TenantMapper tenantMapper;
 
+    @Resource
+    private ConfigApi configApi;
+
+    @Resource
+    private KeyboardTenantWithdrawOrderMapper tenantWithdrawOrderMapper;
+
+    @Resource
+    private NotifyMessageSendApi notifyMessageSendApi;
+
+    private static final String WITHDRAW_DAYS_CONFIG_KEY = "WITHDRAW-DAYS";
+    private static final String WITHDRAW_NOTIFY_TEMPLATE_CODE = "tx-001";
+
     @Override
     public Long createTenantBalance(TenantBalanceSaveReqVO createReqVO) {
         // 插入
@@ -211,5 +230,142 @@ public class TenantBalanceServiceImpl implements TenantBalanceService {
         tenantBalanceTransactionMapper.deleteByTenantIds(tenantIds);
     }
 
+    @Override
+    @Transactional
+    public void withdraw(TenantBalanceWithdrawReqVO withdrawReqVO) {
+        // 1. 校验是否在提现日期范围内
+        validateWithdrawDate();
+
+        // 2. 获取当前租户的余额记录
+        Long tenantId = TenantContextHolder.getRequiredTenantId();
+        TenantBalanceDO balance = tenantBalanceMapper.selectById(tenantId);
+        if (balance == null) {
+            throw exception(TENANT_BALANCE_NOT_EXISTS);
+        }
+
+        // 3. 校验可用余额是否充足（可用余额 = 余额 - 冻结金额）
+        BigDecimal withdrawAmount = withdrawReqVO.getAmount();
+        BigDecimal frozenAmt = balance.getFrozenAmt() != null ? balance.getFrozenAmt() : BigDecimal.ZERO;
+        BigDecimal availableBalance = balance.getBalance().subtract(frozenAmt);
+        if (availableBalance.compareTo(withdrawAmount) < 0) {
+            throw exception(TENANT_BALANCE_WITHDRAW_INSUFFICIENT);
+        }
+
+        // 4. 扣减余额并增加冻结金额
+        BigDecimal newBalance = balance.getBalance().subtract(withdrawAmount);
+        BigDecimal newFrozenAmt = frozenAmt.add(withdrawAmount);
+        balance.setBalance(newBalance);
+        balance.setFrozenAmt(newFrozenAmt);
+        int updateCount = tenantBalanceMapper.updateById(balance);
+        if (updateCount == 0) {
+            throw exception(TENANT_BALANCE_NOT_EXISTS);
+        }
+
+        // 5. 生成提现单号
+        String withdrawNo = BizNoGenerator.generate("WD");
+        String bizNo = BizNoGenerator.generate("BIZ");
+
+        // 6. 创建冻结交易记录
+        TenantBalanceTransactionDO transaction = TenantBalanceTransactionDO.builder()
+                .bizNo(bizNo)
+                    .points(withdrawAmount.negate()) // 冻结金额（负数表示冻结扣减）
+                .balance(newBalance) // 扣减后的余额
+                .tenantId(tenantId)
+                .type("FREEZE")
+                .description("提现冻结")
+                .remark(withdrawReqVO.getRemark())
+                .operatorId(tenantId)
+                .build();
+        tenantBalanceTransactionMapper.insert(transaction);
+
+        // 7. 创建提现申请订单
+        LocalDateTime now = LocalDateTime.now();
+        KeyboardTenantWithdrawOrderDO withdrawOrder = KeyboardTenantWithdrawOrderDO.builder()
+                .withdrawNo(withdrawNo)
+                .bizNo(bizNo)
+                .tenantId(tenantId)
+                .currency("CNY")
+                .amount(withdrawAmount) // 直接存储 BigDecimal
+                .feeAmount(BigDecimal.ZERO) // 手续费暂时为0
+                .actualAmount(withdrawAmount) // 实际到账金额
+                // 收款信息
+                .payChannel(withdrawReqVO.getPayChannel())
+                .payeeType(withdrawReqVO.getPayeeType())
+                .payeeName(withdrawReqVO.getPayeeName())
+                .payeeAccount(withdrawReqVO.getPayeeAccount())
+                .payeeBankName(withdrawReqVO.getPayeeBankName())
+                .payeeBankCode(withdrawReqVO.getPayeeBankCode())
+                .payeeBankBranch(withdrawReqVO.getPayeeBankBranch())
+                // 状态
+                .status("APPLIED") // 申请中
+                .auditStatus("PENDING") // 待审核
+                .applyTime(now)
+                .balanceTxnId(transaction.getId()) // 关联冻结交易记录
+                .creatorId(tenantId)
+                .createdAt(now)
+                .updatedAt(now)
+                .build();
+        tenantWithdrawOrderMapper.insert(withdrawOrder);
+
+        // 8. 发送站内信通知
+        sendWithdrawNotify(tenantId, withdrawAmount);
+    }
+
+    /**
+     * 发送提现站内信通知
+     *
+     * @param tenantId       租户ID
+     * @param withdrawAmount 提现金额
+     */
+    private void sendWithdrawNotify(Long tenantId, BigDecimal withdrawAmount) {
+        // 获取租户信息，找到联系人用户ID
+        TenantDO tenant = tenantMapper.selectById(tenantId);
+        if (tenant == null || tenant.getContactUserId() == null) {
+            return;
+        }
+
+        // 构建站内信请求
+        NotifySendSingleToUserReqDTO reqDTO = new NotifySendSingleToUserReqDTO();
+        reqDTO.setUserId(tenant.getContactUserId());
+        reqDTO.setTemplateCode(WITHDRAW_NOTIFY_TEMPLATE_CODE);
+        reqDTO.setTemplateParams(Map.of("amount", withdrawAmount.toPlainString()));
+
+        // 发送站内信
+        notifyMessageSendApi.sendSingleMessageToAdmin(reqDTO);
+    }
+
+    /**
+     * 校验是否在提现日期范围内
+     * 配置格式：{"start": 25, "days": 6}
+     * 表示每月从第 start 天开始，连续 days 天可以提现（不允许跨月）
+     */
+    private void validateWithdrawDate() {
+        // 获取提现日期配置
+        String configValue = configApi.getConfigValueByKey(WITHDRAW_DAYS_CONFIG_KEY);
+        if (configValue == null || configValue.isEmpty()) {
+            throw exception(TENANT_BALANCE_WITHDRAW_CONFIG_NOT_EXISTS);
+        }
+
+        // 解析配置
+        cn.hutool.json.JSONObject config = JSONUtil.parseObj(configValue);
+        int startDay = config.getInt("start");
+        int days = config.getInt("days");
+
+        // 获取当前日期
+        LocalDate today = LocalDate.now();
+        int currentDay = today.getDayOfMonth();
+        int lastDayOfMonth = today.lengthOfMonth();
+
+        // 计算提现日期范围（不允许跨月，endDay 最大为当月最后一天）
+        int endDay = Math.min(startDay + days - 1, lastDayOfMonth);
+
+        // 判断当前日期是否在 [startDay, endDay] 范围内
+        boolean isInRange = currentDay >= startDay && currentDay <= endDay;
+
+        if (!isInRange) {
+            throw exception(TENANT_BALANCE_WITHDRAW_NOT_IN_DATE);
+        }
+    }
+
 
 }

keyboard-server/src/main/java/com/yolo/keyboard/service/tenantwithdraworder/KeyboardTenantWithdrawOrderService.java

@@ -0,0 +1,62 @@
+package com.yolo.keyboard.service.tenantwithdraworder;
+
+import java.util.*;
+import jakarta.validation.*;
+import com.yolo.keyboard.controller.admin.tenantwithdraworder.vo.*;
+import com.yolo.keyboard.dal.dataobject.tenantwithdraworder.KeyboardTenantWithdrawOrderDO;
+import com.yolo.keyboard.framework.common.pojo.PageResult;
+import com.yolo.keyboard.framework.common.pojo.PageParam;
+
+/**
+ * 租户提现订单表（申请-审核-打款-完成/失败） Service 接口
+ *
+ * @author ziin
+ */
+public interface KeyboardTenantWithdrawOrderService {
+
+    /**
+     * 创建租户提现订单表（申请-审核-打款-完成/失败）
+     *
+     * @param createReqVO 创建信息
+     * @return 编号
+     */
+    Long createTenantWithdrawOrder(@Valid KeyboardTenantWithdrawOrderSaveReqVO createReqVO);
+
+    /**
+     * 更新租户提现订单表（申请-审核-打款-完成/失败）
+     *
+     * @param updateReqVO 更新信息
+     */
+    void updateTenantWithdrawOrder(@Valid KeyboardTenantWithdrawOrderSaveReqVO updateReqVO);
+
+    /**
+     * 删除租户提现订单表（申请-审核-打款-完成/失败）
+     *
+     * @param id 编号
+     */
+    void deleteTenantWithdrawOrder(Long id);
+
+    /**
+    * 批量删除租户提现订单表（申请-审核-打款-完成/失败）
+    *
+    * @param ids 编号
+    */
+    void deleteTenantWithdrawOrderListByIds(List<Long> ids);
+
+    /**
+     * 获得租户提现订单表（申请-审核-打款-完成/失败）
+     *
+     * @param id 编号
+     * @return 租户提现订单表（申请-审核-打款-完成/失败）
+     */
+    KeyboardTenantWithdrawOrderDO getTenantWithdrawOrder(Long id);
+
+    /**
+     * 获得租户提现订单表（申请-审核-打款-完成/失败）分页
+     *
+     * @param pageReqVO 分页查询
+     * @return 租户提现订单表（申请-审核-打款-完成/失败）分页
+     */
+    PageResult<KeyboardTenantWithdrawOrderDO> getTenantWithdrawOrderPage(KeyboardTenantWithdrawOrderPageReqVO pageReqVO);
+
+}

keyboard-server/src/main/java/com/yolo/keyboard/service/tenantwithdraworder/KeyboardTenantWithdrawOrderServiceImpl.java

@@ -0,0 +1,85 @@
+package com.yolo.keyboard.service.tenantwithdraworder;
+
+import cn.hutool.core.collection.CollUtil;
+import org.springframework.stereotype.Service;
+import jakarta.annotation.Resource;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.transaction.annotation.Transactional;
+
+import java.util.*;
+import com.yolo.keyboard.controller.admin.tenantwithdraworder.vo.*;
+import com.yolo.keyboard.dal.dataobject.tenantwithdraworder.KeyboardTenantWithdrawOrderDO;
+import com.yolo.keyboard.framework.common.pojo.PageResult;
+import com.yolo.keyboard.framework.common.pojo.PageParam;
+import com.yolo.keyboard.framework.common.util.object.BeanUtils;
+
+import com.yolo.keyboard.dal.mysql.tenantwithdraworder.KeyboardTenantWithdrawOrderMapper;
+
+import static com.yolo.keyboard.framework.common.exception.util.ServiceExceptionUtil.exception;
+import static com.yolo.keyboard.framework.common.util.collection.CollectionUtils.convertList;
+import static com.yolo.keyboard.framework.common.util.collection.CollectionUtils.diffList;
+import static com.yolo.keyboard.module.infra.enums.ErrorCodeConstants.TENANT_WITHDRAW_ORDER_NOT_EXISTS;
+
+/**
+ * 租户提现订单表（申请-审核-打款-完成/失败） Service 实现类
+ *
+ * @author ziin
+ */
+@Service
+@Validated
+public class KeyboardTenantWithdrawOrderServiceImpl implements KeyboardTenantWithdrawOrderService {
+
+    @Resource
+    private KeyboardTenantWithdrawOrderMapper tenantWithdrawOrderMapper;
+
+    @Override
+    public Long createTenantWithdrawOrder(KeyboardTenantWithdrawOrderSaveReqVO createReqVO) {
+        // 插入
+        KeyboardTenantWithdrawOrderDO tenantWithdrawOrder = BeanUtils.toBean(createReqVO, KeyboardTenantWithdrawOrderDO.class);
+        tenantWithdrawOrderMapper.insert(tenantWithdrawOrder);
+
+        // 返回
+        return tenantWithdrawOrder.getId();
+    }
+
+    @Override
+    public void updateTenantWithdrawOrder(KeyboardTenantWithdrawOrderSaveReqVO updateReqVO) {
+        // 校验存在
+        validateTenantWithdrawOrderExists(updateReqVO.getId());
+        // 更新
+        KeyboardTenantWithdrawOrderDO updateObj = BeanUtils.toBean(updateReqVO, KeyboardTenantWithdrawOrderDO.class);
+        tenantWithdrawOrderMapper.updateById(updateObj);
+    }
+
+    @Override
+    public void deleteTenantWithdrawOrder(Long id) {
+        // 校验存在
+        validateTenantWithdrawOrderExists(id);
+        // 删除
+        tenantWithdrawOrderMapper.deleteById(id);
+    }
+
+    @Override
+        public void deleteTenantWithdrawOrderListByIds(List<Long> ids) {
+        // 删除
+        tenantWithdrawOrderMapper.deleteByIds(ids);
+        }
+
+
+    private void validateTenantWithdrawOrderExists(Long id) {
+        if (tenantWithdrawOrderMapper.selectById(id) == null) {
+            throw exception(TENANT_WITHDRAW_ORDER_NOT_EXISTS);
+        }
+    }
+
+    @Override
+    public KeyboardTenantWithdrawOrderDO getTenantWithdrawOrder(Long id) {
+        return tenantWithdrawOrderMapper.selectById(id);
+    }
+
+    @Override
+    public PageResult<KeyboardTenantWithdrawOrderDO> getTenantWithdrawOrderPage(KeyboardTenantWithdrawOrderPageReqVO pageReqVO) {
+        return tenantWithdrawOrderMapper.selectPage(pageReqVO);
+    }
+
+}

keyboard-server/src/main/resources/mapper/tenantwithdraworder/KeyboardTenantWithdrawOrderMapper.xml

@@ -0,0 +1,12 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" "http://mybatis.org/dtd/mybatis-3-mapper.dtd">
+<mapper namespace="com.yolo.keyboard.dal.mysql.tenantwithdraworder.KeyboardTenantWithdrawOrderMapper">
+
+    <!--
+        一般情况下，尽可能使用 Mapper 进行 CRUD 增删改查即可。
+        无法满足的场景，例如说多表关联查询，才使用 XML 编写 SQL。
+        代码生成器暂时只生成 Mapper XML 文件本身，更多推荐 MybatisX 快速开发插件来生成查询。
+        文档可见：https://www.iocoder.cn/MyBatis/x-plugins/
+     -->
+
+</mapper>

yolo-module-infra/src/main/java/com/yolo/keyboard/module/infra/enums/ErrorCodeConstants.java

@@ -87,6 +87,10 @@ public interface ErrorCodeConstants {
     ErrorCode USER_THEMES_NOT_EXISTS = new ErrorCode(1_001_202_013, "用户主题不存在");
     ErrorCode TENANT_BALANCE_NOT_EXISTS = new ErrorCode(1_001_202_014, "租户余额不存在");
     ErrorCode TENANT_BALANCE_TRANSACTION_NOT_EXISTS = new ErrorCode(1_001_202_015, "租户积分记录不存在");
+    ErrorCode TENANT_BALANCE_WITHDRAW_NOT_IN_DATE = new ErrorCode(1_001_202_016, "当前不在提现日期范围内");
+    ErrorCode TENANT_BALANCE_WITHDRAW_INSUFFICIENT = new ErrorCode(1_001_202_017, "余额不足，无法提现");
+    ErrorCode TENANT_BALANCE_WITHDRAW_CONFIG_NOT_EXISTS = new ErrorCode(1_001_202_018, "提现配置不存在");
+    ErrorCode TENANT_WITHDRAW_ORDER_NOT_EXISTS = new ErrorCode(1_001_202_019, "租户提现订单表（申请-审核-打款-完成/失败）不存在");
 
 
 }