feat(tenant-commission): 新增租户内购分成管理后台接口

This commit is contained in:
2025-12-30 14:30:15 +08:00
parent eb4b615ed6
commit baf38df6c3
9 changed files with 484 additions and 0 deletions

View File

@@ -0,0 +1,104 @@
package com.yolo.keyboard.controller.admin.tenantcommission;
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.tenantcommission.vo.*;
import com.yolo.keyboard.dal.dataobject.tenantcommission.KeyboardTenantCommissionDO;
import com.yolo.keyboard.service.tenantcommission.KeyboardTenantCommissionService;
@Tag(name = "管理后台 - 租户内购分成记录")
@RestController
@RequestMapping("/keyboard/tenant-commission")
@Validated
public class KeyboardTenantCommissionController {
@Resource
private KeyboardTenantCommissionService tenantCommissionService;
@PostMapping("/create")
@Operation(summary = "创建租户内购分成记录")
@PreAuthorize("@ss.hasPermission('keyboard:tenant-commission:create')")
public CommonResult<Long> createTenantCommission(@Valid @RequestBody KeyboardTenantCommissionSaveReqVO createReqVO) {
return success(tenantCommissionService.createTenantCommission(createReqVO));
}
@PutMapping("/update")
@Operation(summary = "更新租户内购分成记录")
@PreAuthorize("@ss.hasPermission('keyboard:tenant-commission:update')")
public CommonResult<Boolean> updateTenantCommission(@Valid @RequestBody KeyboardTenantCommissionSaveReqVO updateReqVO) {
tenantCommissionService.updateTenantCommission(updateReqVO);
return success(true);
}
@DeleteMapping("/delete")
@Operation(summary = "删除租户内购分成记录")
@Parameter(name = "id", description = "编号", required = true)
@PreAuthorize("@ss.hasPermission('keyboard:tenant-commission:delete')")
public CommonResult<Boolean> deleteTenantCommission(@RequestParam("id") Long id) {
tenantCommissionService.deleteTenantCommission(id);
return success(true);
}
@DeleteMapping("/delete-list")
@Parameter(name = "ids", description = "编号", required = true)
@Operation(summary = "批量删除租户内购分成记录")
@PreAuthorize("@ss.hasPermission('keyboard:tenant-commission:delete')")
public CommonResult<Boolean> deleteTenantCommissionList(@RequestParam("ids") List<Long> ids) {
tenantCommissionService.deleteTenantCommissionListByIds(ids);
return success(true);
}
@GetMapping("/get")
@Operation(summary = "获得租户内购分成记录")
@Parameter(name = "id", description = "编号", required = true, example = "1024")
@PreAuthorize("@ss.hasPermission('keyboard:tenant-commission:query')")
public CommonResult<KeyboardTenantCommissionRespVO> getTenantCommission(@RequestParam("id") Long id) {
KeyboardTenantCommissionDO tenantCommission = tenantCommissionService.getTenantCommission(id);
return success(BeanUtils.toBean(tenantCommission, KeyboardTenantCommissionRespVO.class));
}
@GetMapping("/page")
@Operation(summary = "获得租户内购分成记录分页")
@PreAuthorize("@ss.hasPermission('keyboard:tenant-commission:query')")
public CommonResult<PageResult<KeyboardTenantCommissionRespVO>> getTenantCommissionPage(@Valid KeyboardTenantCommissionPageReqVO pageReqVO) {
PageResult<KeyboardTenantCommissionDO> pageResult = tenantCommissionService.getTenantCommissionPage(pageReqVO);
return success(BeanUtils.toBean(pageResult, KeyboardTenantCommissionRespVO.class));
}
@GetMapping("/export-excel")
@Operation(summary = "导出租户内购分成记录 Excel")
@PreAuthorize("@ss.hasPermission('keyboard:tenant-commission:export')")
@ApiAccessLog(operateType = EXPORT)
public void exportTenantCommissionExcel(@Valid KeyboardTenantCommissionPageReqVO pageReqVO,
HttpServletResponse response) throws IOException {
pageReqVO.setPageSize(PageParam.PAGE_SIZE_NONE);
List<KeyboardTenantCommissionDO> list = tenantCommissionService.getTenantCommissionPage(pageReqVO).getList();
// 导出 Excel
ExcelUtils.write(response, "租户内购分成记录.xls", "数据", KeyboardTenantCommissionRespVO.class,
BeanUtils.toBean(list, KeyboardTenantCommissionRespVO.class));
}
}

View File

@@ -0,0 +1,60 @@
package com.yolo.keyboard.controller.admin.tenantcommission.vo;
import lombok.*;
import java.util.*;
import io.swagger.v3.oas.annotations.media.Schema;
import com.yolo.keyboard.framework.common.pojo.PageParam;
import java.math.BigDecimal;
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 KeyboardTenantCommissionPageReqVO extends PageParam {
@Schema(description = "内购记录ID", example = "20900")
private Integer purchaseRecordId;
@Schema(description = "内购交易ID", example = "30383")
private String transactionId;
@Schema(description = "被邀请用户ID购买用户", example = "2447")
private Integer inviteeUserId;
@Schema(description = "邀请人用户ID", example = "1012")
private Long inviterUserId;
@Schema(description = "内购金额")
private BigDecimal purchaseAmount;
@Schema(description = "分成比例")
private BigDecimal commissionRate;
@Schema(description = "分成金额")
private BigDecimal commissionAmount;
@Schema(description = "状态PENDING-待结算SETTLED-已结算REFUNDED-已退款", example = "2")
private String status;
@Schema(description = "内购时间")
@DateTimeFormat(pattern = FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND)
private LocalDateTime[] purchaseTime;
@Schema(description = "结算时间")
private LocalDateTime settledAt;
@Schema(description = "关联的余额交易记录ID", example = "29131")
private Long balanceTransactionId;
@Schema(description = "创建时间")
private LocalDateTime createdAt;
@Schema(description = "更新时间")
private LocalDateTime updatedAt;
@Schema(description = "备注", example = "随便")
private String remark;
}

View File

@@ -0,0 +1,76 @@
package com.yolo.keyboard.controller.admin.tenantcommission.vo;
import io.swagger.v3.oas.annotations.media.Schema;
import lombok.*;
import java.util.*;
import java.math.BigDecimal;
import org.springframework.format.annotation.DateTimeFormat;
import java.time.LocalDateTime;
import cn.idev.excel.annotation.*;
@Schema(description = "管理后台 - 租户内购分成记录 Response VO")
@Data
@ExcelIgnoreUnannotated
public class KeyboardTenantCommissionRespVO {
@Schema(description = "主键", requiredMode = Schema.RequiredMode.REQUIRED, example = "3144")
@ExcelProperty("主键")
private Long id;
@Schema(description = "内购记录ID", requiredMode = Schema.RequiredMode.REQUIRED, example = "20900")
@ExcelProperty("内购记录ID")
private Integer purchaseRecordId;
@Schema(description = "内购交易ID", example = "30383")
@ExcelProperty("内购交易ID")
private String transactionId;
@Schema(description = "被邀请用户ID购买用户", example = "2447")
@ExcelProperty("被邀请用户ID购买用户")
private Integer inviteeUserId;
@Schema(description = "邀请人用户ID", example = "1012")
@ExcelProperty("邀请人用户ID")
private Long inviterUserId;
@Schema(description = "内购金额")
@ExcelProperty("内购金额")
private BigDecimal purchaseAmount;
@Schema(description = "分成比例")
@ExcelProperty("分成比例")
private BigDecimal commissionRate;
@Schema(description = "分成金额")
@ExcelProperty("分成金额")
private BigDecimal commissionAmount;
@Schema(description = "状态PENDING-待结算SETTLED-已结算REFUNDED-已退款", example = "2")
@ExcelProperty("状态PENDING-待结算SETTLED-已结算REFUNDED-已退款")
private String status;
@Schema(description = "内购时间")
@ExcelProperty("内购时间")
private LocalDateTime purchaseTime;
@Schema(description = "结算时间")
@ExcelProperty("结算时间")
private LocalDateTime settledAt;
@Schema(description = "关联的余额交易记录ID", example = "29131")
@ExcelProperty("关联的余额交易记录ID")
private Long balanceTransactionId;
@Schema(description = "创建时间")
@ExcelProperty("创建时间")
private LocalDateTime createdAt;
@Schema(description = "更新时间")
@ExcelProperty("更新时间")
private LocalDateTime updatedAt;
@Schema(description = "备注", example = "随便")
@ExcelProperty("备注")
private String remark;
}

View File

@@ -0,0 +1,61 @@
package com.yolo.keyboard.controller.admin.tenantcommission.vo;
import io.swagger.v3.oas.annotations.media.Schema;
import lombok.*;
import java.util.*;
import jakarta.validation.constraints.*;
import java.math.BigDecimal;
import org.springframework.format.annotation.DateTimeFormat;
import java.time.LocalDateTime;
@Schema(description = "管理后台 - 租户内购分成记录新增/修改 Request VO")
@Data
public class KeyboardTenantCommissionSaveReqVO {
@Schema(description = "主键", requiredMode = Schema.RequiredMode.REQUIRED, example = "3144")
private Long id;
@Schema(description = "内购记录ID", requiredMode = Schema.RequiredMode.REQUIRED, example = "20900")
@NotNull(message = "内购记录ID不能为空")
private Integer purchaseRecordId;
@Schema(description = "内购交易ID", example = "30383")
private String transactionId;
@Schema(description = "被邀请用户ID购买用户", example = "2447")
private Integer inviteeUserId;
@Schema(description = "邀请人用户ID", example = "1012")
private Long inviterUserId;
@Schema(description = "内购金额")
private BigDecimal purchaseAmount;
@Schema(description = "分成比例")
private BigDecimal commissionRate;
@Schema(description = "分成金额")
private BigDecimal commissionAmount;
@Schema(description = "状态PENDING-待结算SETTLED-已结算REFUNDED-已退款", example = "2")
private String status;
@Schema(description = "内购时间")
private LocalDateTime purchaseTime;
@Schema(description = "结算时间")
private LocalDateTime settledAt;
@Schema(description = "关联的余额交易记录ID", example = "29131")
private Long balanceTransactionId;
@Schema(description = "创建时间")
private LocalDateTime createdAt;
@Schema(description = "更新时间")
private LocalDateTime updatedAt;
@Schema(description = "备注", example = "随便")
private String remark;
}

View File

@@ -1,7 +1,10 @@
package com.yolo.keyboard.dal.mysql.tenantcommission;
import com.yolo.keyboard.controller.admin.tenantcommission.vo.KeyboardTenantCommissionPageReqVO;
import com.yolo.keyboard.dal.dataobject.tenantcommission.KeyboardTenantCommissionDO;
import com.yolo.keyboard.framework.common.pojo.PageResult;
import com.yolo.keyboard.framework.mybatis.core.mapper.BaseMapperX;
import com.yolo.keyboard.framework.mybatis.core.query.LambdaQueryWrapperX;
import org.apache.ibatis.annotations.Mapper;
/**
@@ -25,4 +28,24 @@ public interface KeyboardTenantCommissionMapper extends BaseMapperX<KeyboardTena
default KeyboardTenantCommissionDO selectByPurchaseRecordId(Integer purchaseRecordId) {
return selectOne(KeyboardTenantCommissionDO::getPurchaseRecordId, purchaseRecordId);
}
default PageResult<KeyboardTenantCommissionDO> selectPage(KeyboardTenantCommissionPageReqVO reqVO) {
return selectPage(reqVO, new LambdaQueryWrapperX<KeyboardTenantCommissionDO>()
.eqIfPresent(KeyboardTenantCommissionDO::getPurchaseRecordId, reqVO.getPurchaseRecordId())
.eqIfPresent(KeyboardTenantCommissionDO::getTransactionId, reqVO.getTransactionId())
.eqIfPresent(KeyboardTenantCommissionDO::getInviteeUserId, reqVO.getInviteeUserId())
.eqIfPresent(KeyboardTenantCommissionDO::getInviterUserId, reqVO.getInviterUserId())
.eqIfPresent(KeyboardTenantCommissionDO::getPurchaseAmount, reqVO.getPurchaseAmount())
.eqIfPresent(KeyboardTenantCommissionDO::getCommissionRate, reqVO.getCommissionRate())
.eqIfPresent(KeyboardTenantCommissionDO::getCommissionAmount, reqVO.getCommissionAmount())
.eqIfPresent(KeyboardTenantCommissionDO::getStatus, reqVO.getStatus())
.betweenIfPresent(KeyboardTenantCommissionDO::getPurchaseTime, reqVO.getPurchaseTime())
.eqIfPresent(KeyboardTenantCommissionDO::getSettledAt, reqVO.getSettledAt())
.eqIfPresent(KeyboardTenantCommissionDO::getBalanceTransactionId, reqVO.getBalanceTransactionId())
.eqIfPresent(KeyboardTenantCommissionDO::getCreatedAt, reqVO.getCreatedAt())
.eqIfPresent(KeyboardTenantCommissionDO::getUpdatedAt, reqVO.getUpdatedAt())
.eqIfPresent(KeyboardTenantCommissionDO::getRemark, reqVO.getRemark())
.orderByDesc(KeyboardTenantCommissionDO::getId));
}
}

View File

@@ -0,0 +1,62 @@
package com.yolo.keyboard.service.tenantcommission;
import java.util.*;
import jakarta.validation.*;
import com.yolo.keyboard.controller.admin.tenantcommission.vo.*;
import com.yolo.keyboard.dal.dataobject.tenantcommission.KeyboardTenantCommissionDO;
import com.yolo.keyboard.framework.common.pojo.PageResult;
import com.yolo.keyboard.framework.common.pojo.PageParam;
/**
* 租户内购分成记录 Service 接口
*
* @author ziin
*/
public interface KeyboardTenantCommissionService {
/**
* 创建租户内购分成记录
*
* @param createReqVO 创建信息
* @return 编号
*/
Long createTenantCommission(@Valid KeyboardTenantCommissionSaveReqVO createReqVO);
/**
* 更新租户内购分成记录
*
* @param updateReqVO 更新信息
*/
void updateTenantCommission(@Valid KeyboardTenantCommissionSaveReqVO updateReqVO);
/**
* 删除租户内购分成记录
*
* @param id 编号
*/
void deleteTenantCommission(Long id);
/**
* 批量删除租户内购分成记录
*
* @param ids 编号
*/
void deleteTenantCommissionListByIds(List<Long> ids);
/**
* 获得租户内购分成记录
*
* @param id 编号
* @return 租户内购分成记录
*/
KeyboardTenantCommissionDO getTenantCommission(Long id);
/**
* 获得租户内购分成记录分页
*
* @param pageReqVO 分页查询
* @return 租户内购分成记录分页
*/
PageResult<KeyboardTenantCommissionDO> getTenantCommissionPage(KeyboardTenantCommissionPageReqVO pageReqVO);
}

View File

@@ -0,0 +1,84 @@
package com.yolo.keyboard.service.tenantcommission;
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.tenantcommission.vo.*;
import com.yolo.keyboard.dal.dataobject.tenantcommission.KeyboardTenantCommissionDO;
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.tenantcommission.KeyboardTenantCommissionMapper;
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_COMMISSION_NOT_EXISTS;
/**
* 租户内购分成记录 Service 实现类
*
* @author ziin
*/
@Service
@Validated
public class KeyboardTenantCommissionServiceImpl implements KeyboardTenantCommissionService {
@Resource
private KeyboardTenantCommissionMapper tenantCommissionMapper;
@Override
public Long createTenantCommission(KeyboardTenantCommissionSaveReqVO createReqVO) {
// 插入
KeyboardTenantCommissionDO tenantCommission = BeanUtils.toBean(createReqVO, KeyboardTenantCommissionDO.class);
tenantCommissionMapper.insert(tenantCommission);
// 返回
return tenantCommission.getId();
}
@Override
public void updateTenantCommission(KeyboardTenantCommissionSaveReqVO updateReqVO) {
// 校验存在
validateTenantCommissionExists(updateReqVO.getId());
// 更新
KeyboardTenantCommissionDO updateObj = BeanUtils.toBean(updateReqVO, KeyboardTenantCommissionDO.class);
tenantCommissionMapper.updateById(updateObj);
}
@Override
public void deleteTenantCommission(Long id) {
// 校验存在
validateTenantCommissionExists(id);
// 删除
tenantCommissionMapper.deleteById(id);
}
@Override
public void deleteTenantCommissionListByIds(List<Long> ids) {
// 删除
tenantCommissionMapper.deleteByIds(ids);
}
private void validateTenantCommissionExists(Long id) {
if (tenantCommissionMapper.selectById(id) == null) {
throw exception(TENANT_COMMISSION_NOT_EXISTS);
}
}
@Override
public KeyboardTenantCommissionDO getTenantCommission(Long id) {
return tenantCommissionMapper.selectById(id);
}
@Override
public PageResult<KeyboardTenantCommissionDO> getTenantCommissionPage(KeyboardTenantCommissionPageReqVO pageReqVO) {
return tenantCommissionMapper.selectPage(pageReqVO);
}
}

View File

@@ -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.module.keyboard.dal.mysql.tenantcommission.KeyboardTenantCommissionMapper">
<!--
一般情况下,尽可能使用 Mapper 进行 CRUD 增删改查即可。
无法满足的场景,例如说多表关联查询,才使用 XML 编写 SQL。
代码生成器暂时只生成 Mapper XML 文件本身,更多推荐 MybatisX 快速开发插件来生成查询。
文档可见https://www.iocoder.cn/MyBatis/x-plugins/
-->
</mapper>

View File

@@ -93,5 +93,7 @@ public interface ErrorCodeConstants {
ErrorCode TENANT_WITHDRAW_ORDER_NOT_EXISTS = new ErrorCode(1_001_202_019, "租户提现订单表(申请-审核-打款-完成/失败)不存在");
ErrorCode USER_INVITE_CODES_NOT_EXISTS = new ErrorCode(1_001_202_020, "用户生成的邀请码表,用于邀请新用户注册/安装并建立邀请关系不存在");
ErrorCode USER_INVITES_NOT_EXISTS = new ErrorCode(1_001_202_021, "用户邀请关系绑定台账表,记录新用户最终归属的邀请人不存在");
ErrorCode TENANT_COMMISSION_NOT_EXISTS = new ErrorCode(1_001_202_022, "租户内购分成记录不存在");
}