feat(business): 添加配牌记录功能

- 新增配牌记录相关实体类、控制器、服务接口及其实现类
- 添加配牌记录的增删查改功能
- 实现查询最新配牌记录的方法
- 在 Redis 中缓存最新配牌记录

ruoyi-modules/ruoyi-system/src/main/java/org/dromara/business/controller/BusinessCardToolsController.java

@@ -0,0 +1,115 @@
+package org.dromara.business.controller;
+
+import java.util.List;
+
+import lombok.RequiredArgsConstructor;
+import jakarta.servlet.http.HttpServletResponse;
+import jakarta.validation.constraints.*;
+import cn.dev33.satoken.annotation.SaCheckPermission;
+import org.dromara.business.domain.bo.BusinessCardToolsBo;
+import org.dromara.business.domain.vo.BusinessCardToolsVo;
+import org.dromara.business.service.IBusinessCardToolsService;
+import org.springframework.web.bind.annotation.*;
+import org.springframework.validation.annotation.Validated;
+import org.dromara.common.idempotent.annotation.RepeatSubmit;
+import org.dromara.common.log.annotation.Log;
+import org.dromara.common.web.core.BaseController;
+import org.dromara.common.mybatis.core.page.PageQuery;
+import org.dromara.common.core.domain.R;
+import org.dromara.common.core.validate.AddGroup;
+import org.dromara.common.core.validate.EditGroup;
+import org.dromara.common.log.enums.BusinessType;
+import org.dromara.common.excel.utils.ExcelUtil;
+import org.dromara.common.mybatis.core.page.TableDataInfo;
+
+/**
+ * 配牌记录
+ *
+ * @author Lion Li
+ * @date 2025-08-27
+ */
+@Validated
+@RequiredArgsConstructor
+@RestController
+@RequestMapping("/business/cardTools")
+public class BusinessCardToolsController extends BaseController {
+
+    private final IBusinessCardToolsService businessCardToolsService;
+
+    /**
+     * 查询配牌记录列表
+     */
+    @SaCheckPermission("business:cardTools:list")
+    @GetMapping("/list")
+    public TableDataInfo<BusinessCardToolsVo> list(BusinessCardToolsBo bo, PageQuery pageQuery) {
+        return businessCardToolsService.queryPageList(bo, pageQuery);
+    }
+
+    /**
+     * 导出配牌记录列表
+     */
+    @SaCheckPermission("business:cardTools:export")
+    @Log(title = "配牌记录", businessType = BusinessType.EXPORT)
+    @PostMapping("/export")
+    public void export(BusinessCardToolsBo bo, HttpServletResponse response) {
+        List<BusinessCardToolsVo> list = businessCardToolsService.queryList(bo);
+        ExcelUtil.exportExcel(list, "配牌记录", BusinessCardToolsVo.class, response);
+    }
+
+    /**
+     * 获取配牌记录详细信息
+     *
+     * @param id 主键
+     */
+    @SaCheckPermission("business:cardTools:query")
+    @GetMapping("/{id}")
+    public R<BusinessCardToolsVo> getInfo(@NotNull(message = "主键不能为空")
+                                     @PathVariable Long id) {
+        return R.ok(businessCardToolsService.queryById(id));
+    }
+
+    /**
+     * 新增配牌记录
+     */
+    @SaCheckPermission("business:cardTools:add")
+    @Log(title = "配牌记录", businessType = BusinessType.INSERT)
+    @RepeatSubmit()
+    @PostMapping()
+    public R<Void> add(@Validated(AddGroup.class) @RequestBody BusinessCardToolsBo bo) {
+        return toAjax(businessCardToolsService.insertByBo(bo));
+    }
+
+    /**
+     * 修改配牌记录
+     */
+    @SaCheckPermission("business:cardTools:edit")
+    @Log(title = "配牌记录", businessType = BusinessType.UPDATE)
+    @RepeatSubmit()
+    @PutMapping()
+    public R<Void> edit(@Validated(EditGroup.class) @RequestBody BusinessCardToolsBo bo) {
+        return toAjax(businessCardToolsService.updateByBo(bo));
+    }
+
+    /**
+     * 删除配牌记录
+     *
+     * @param ids 主键串
+     */
+    @SaCheckPermission("business:cardTools:remove")
+    @Log(title = "配牌记录", businessType = BusinessType.DELETE)
+    @DeleteMapping("/{ids}")
+    public R<Void> remove(@NotEmpty(message = "主键不能为空")
+                          @PathVariable Long[] ids) {
+        return toAjax(businessCardToolsService.deleteWithValidByIds(List.of(ids), true));
+    }
+
+    /**
+     * 查询最新配牌记录
+     */
+    @SaCheckPermission("business:cardTools:selectBusinessCardToolsMaxNew")
+    @GetMapping("/selectBusinessCardToolsMaxNew")
+    public R<BusinessCardToolsVo> selectBusinessCardToolsMaxNew() {
+        return R.ok(businessCardToolsService.selectBusinessCardToolsMaxNew());
+    }
+
+}

ruoyi-modules/ruoyi-system/src/main/java/org/dromara/business/domain/BusinessCardTools.java

@@ -0,0 +1,48 @@
+package org.dromara.business.domain;
+
+import com.baomidou.mybatisplus.annotation.*;
+import lombok.Data;
+import java.util.Date;
+import java.io.Serial;
+
+/**
+ * 配牌记录对象 business_card_tools
+ *
+ * @author Lion Li
+ * @date 2025-08-27
+ */
+@Data
+@TableName("business_card_tools")
+public class BusinessCardTools {
+
+    @Serial
+    private static final long serialVersionUID = 1L;
+
+    /**
+     * 配牌记录ID
+     */
+    @TableId(value = "id")
+    private Long id;
+
+    /**
+     * 操作人
+     */
+    private String operateName;
+
+    /**
+     * 整副牌内容
+     */
+    private String content;
+
+    /**
+     * 创建时间
+     */
+    private Date createAt;
+
+    /**
+     * 更新时间
+     */
+    private Date updateAt;
+
+
+}

ruoyi-modules/ruoyi-system/src/main/java/org/dromara/business/domain/bo/BusinessCardToolsBo.java

@@ -0,0 +1,50 @@
+package org.dromara.business.domain.bo;
+
+import org.dromara.business.domain.BusinessCardTools;
+import org.dromara.common.mybatis.core.domain.BaseEntity;
+import org.dromara.common.core.validate.EditGroup;
+import io.github.linpeilie.annotations.AutoMapper;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import jakarta.validation.constraints.*;
+import java.util.Date;
+
+/**
+ * 配牌记录业务对象 business_card_tools
+ *
+ * @author Lion Li
+ * @date 2025-08-27
+ */
+@Data
+@EqualsAndHashCode(callSuper = true)
+@AutoMapper(target = BusinessCardTools.class, reverseConvertGenerate = false)
+public class BusinessCardToolsBo extends BaseEntity {
+
+    /**
+     * 配牌记录ID
+     */
+    @NotNull(message = "配牌记录ID不能为空", groups = { EditGroup.class })
+    private Long id;
+
+    /**
+     * 操作人
+     */
+    private String operateName;
+
+    /**
+     * 整副牌内容
+     */
+    private String content;
+
+    /**
+     * 创建时间
+     */
+    private Date createAt;
+
+    /**
+     * 更新时间
+     */
+    private Date updateAt;
+
+
+}

ruoyi-modules/ruoyi-system/src/main/java/org/dromara/business/domain/vo/BusinessCardToolsVo.java

@@ -0,0 +1,59 @@
+package org.dromara.business.domain.vo;
+
+import java.util.Date;
+import cn.idev.excel.annotation.ExcelIgnoreUnannotated;
+import cn.idev.excel.annotation.ExcelProperty;
+import io.github.linpeilie.annotations.AutoMapper;
+import lombok.Data;
+import org.dromara.business.domain.BusinessCardTools;
+
+import java.io.Serial;
+import java.io.Serializable;
+
+
+/**
+ * 配牌记录视图对象 business_card_tools
+ *
+ * @author Lion Li
+ * @date 2025-08-27
+ */
+@Data
+@ExcelIgnoreUnannotated
+@AutoMapper(target = BusinessCardTools.class)
+public class BusinessCardToolsVo implements Serializable {
+
+    @Serial
+    private static final long serialVersionUID = 1L;
+
+    /**
+     * 配牌记录ID
+     */
+    @ExcelProperty(value = "配牌记录ID")
+    private Long id;
+
+    /**
+     * 操作人
+     */
+    @ExcelProperty(value = "操作人")
+    private String operateName;
+
+    /**
+     * 整副牌内容
+     */
+    @ExcelProperty(value = "整副牌内容")
+    private String content;
+
+    /**
+     * 创建时间
+     */
+    @ExcelProperty(value = "创建时间")
+    private Date createAt;
+
+    /**
+     * 更新时间
+     */
+    @ExcelProperty(value = "更新时间")
+    private Date updateAt;
+
+
+}

ruoyi-modules/ruoyi-system/src/main/java/org/dromara/business/mapper/BusinessCardToolsMapper.java

@@ -0,0 +1,26 @@
+package org.dromara.business.mapper;
+
+import com.baomidou.dynamic.datasource.annotation.DS;
+import com.baomidou.mybatisplus.annotation.InterceptorIgnore;
+import org.dromara.business.domain.BusinessCardTools;
+import org.dromara.business.domain.vo.BusinessCardToolsVo;
+import org.dromara.common.mybatis.core.mapper.BaseMapperPlus;
+
+/**
+ * 配牌记录Mapper接口
+ *
+ * @author Lion Li
+ * @date 2025-08-27
+ */
+@DS("mysql2")
+public interface BusinessCardToolsMapper extends BaseMapperPlus<BusinessCardTools, BusinessCardToolsVo> {
+
+    @InterceptorIgnore(tenantLine = "true")
+    int insertBusinessCardTools(BusinessCardTools businessCardTools);
+
+    @InterceptorIgnore(tenantLine = "true")
+    BusinessCardToolsVo selectBusinessCardToolsMaxById();
+
+
+
+}

ruoyi-modules/ruoyi-system/src/main/java/org/dromara/business/service/IBusinessCardToolsService.java

@@ -0,0 +1,78 @@
+package org.dromara.business.service;
+
+import org.dromara.business.domain.bo.BusinessCardToolsBo;
+import org.dromara.business.domain.vo.BusinessCardToolsVo;
+import org.dromara.common.mybatis.core.page.TableDataInfo;
+import org.dromara.common.mybatis.core.page.PageQuery;
+
+import java.util.Collection;
+import java.util.List;
+
+/**
+ * 配牌记录Service接口
+ *
+ * @author Lion Li
+ * @date 2025-08-27
+ */
+public interface IBusinessCardToolsService {
+
+    /**
+     * 查询配牌记录
+     *
+     * @param id 主键
+     * @return 配牌记录
+     */
+    BusinessCardToolsVo queryById(Long id);
+
+    /**
+     * 分页查询配牌记录列表
+     *
+     * @param bo        查询条件
+     * @param pageQuery 分页参数
+     * @return 配牌记录分页列表
+     */
+    TableDataInfo<BusinessCardToolsVo> queryPageList(BusinessCardToolsBo bo, PageQuery pageQuery);
+
+    /**
+     * 查询符合条件的配牌记录列表
+     *
+     * @param bo 查询条件
+     * @return 配牌记录列表
+     */
+    List<BusinessCardToolsVo> queryList(BusinessCardToolsBo bo);
+
+    /**
+     * 新增配牌记录
+     *
+     * @param bo 配牌记录
+     * @return 是否新增成功
+     */
+    Boolean insertByBo(BusinessCardToolsBo bo);
+
+    /**
+     * 修改配牌记录
+     *
+     * @param bo 配牌记录
+     * @return 是否修改成功
+     */
+    Boolean updateByBo(BusinessCardToolsBo bo);
+
+    /**
+     * 校验并批量删除配牌记录信息
+     *
+     * @param ids     待删除的主键集合
+     * @param isValid 是否进行有效性校验
+     * @return 是否删除成功
+     */
+    Boolean deleteWithValidByIds(Collection<Long> ids, Boolean isValid);
+
+
+    /**
+     * 查询最新配牌记录
+     *
+     * @param id 主键
+     * @return 配牌记录
+     */
+    BusinessCardToolsVo selectBusinessCardToolsMaxNew();
+
+}

ruoyi-modules/ruoyi-system/src/main/java/org/dromara/business/service/ITootsService.java

@@ -0,0 +1,79 @@
+package org.dromara.business.service;
+
+import org.dromara.business.domain.bo.ItemsUserBo;
+import org.dromara.business.domain.bo.UserBo;
+import org.dromara.business.domain.vo.UserVo;
+import org.dromara.common.mybatis.core.page.PageQuery;
+import org.dromara.common.mybatis.core.page.TableDataInfo;
+
+import java.util.Collection;
+import java.util.List;
+
+/**
+ * 【请填写功能名称】Service接口
+ *
+ * @author Lion Li
+ * @date 2025-06-26
+ */
+public interface ITootsService {
+
+    /**
+     * 查询【请填写功能名称】
+     *
+     * @param id 主键
+     * @return 【请填写功能名称】
+     */
+    UserVo queryById(Long id);
+
+    /**
+     * 分页查询【请填写功能名称】列表
+     *
+     * @param bo        查询条件
+     * @param pageQuery 分页参数
+     * @return 【请填写功能名称】分页列表
+     */
+    TableDataInfo<UserVo> queryPageList(UserBo bo, PageQuery pageQuery);
+
+    /**
+     * 查询符合条件的【请填写功能名称】列表
+     *
+     * @param bo 查询条件
+     * @return 【请填写功能名称】列表
+     */
+    List<UserVo> queryList(UserBo bo);
+
+    /**
+     * 新增【请填写功能名称】
+     *
+     * @param bo 【请填写功能名称】
+     * @return 是否新增成功
+     */
+    Boolean insertByBo(UserBo bo);
+
+    /**
+     * 修改【请填写功能名称】
+     *
+     * @param bo 【请填写功能名称】
+     * @return 是否修改成功
+     */
+    Boolean updateByBo(UserBo bo);
+
+    /**
+     * 校验并批量删除【请填写功能名称】信息
+     *
+     * @param ids     待删除的主键集合
+     * @param isValid 是否进行有效性校验
+     * @return 是否删除成功
+     */
+    Boolean deleteWithValidByIds(Collection<Long> ids, Boolean isValid);
+
+    /**
+     * 发送奖励道具
+     *
+     * @param bo
+     * @return
+     */
+    Boolean sendRewardToos(ItemsUserBo bo);
+
+
+}

ruoyi-modules/ruoyi-system/src/main/java/org/dromara/business/service/impl/BusinessCardToolsServiceImpl.java

@@ -0,0 +1,148 @@
+package org.dromara.business.service.impl;
+
+import org.dromara.business.domain.BusinessCardTools;
+import org.dromara.business.domain.bo.BusinessCardToolsBo;
+import org.dromara.business.domain.vo.BusinessCardToolsVo;
+import org.dromara.business.mapper.BusinessCardToolsMapper;
+import org.dromara.business.service.IBusinessCardToolsService;
+import org.dromara.business.utils.RedisKeys;
+import org.dromara.business.utils.RedisUtil;
+import org.dromara.common.core.utils.MapstructUtils;
+import org.dromara.common.core.utils.StringUtils;
+import org.dromara.common.mybatis.core.page.TableDataInfo;
+import org.dromara.common.mybatis.core.page.PageQuery;
+import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
+import com.baomidou.mybatisplus.core.conditions.query.LambdaQueryWrapper;
+import com.baomidou.mybatisplus.core.toolkit.Wrappers;
+import lombok.RequiredArgsConstructor;
+import lombok.extern.slf4j.Slf4j;
+import org.dromara.common.satoken.utils.LoginHelper;
+import org.springframework.beans.factory.annotation.Autowired;
+import org.springframework.stereotype.Service;
+import java.util.List;
+import java.util.Map;
+import java.util.Collection;
+
+/**
+ * 配牌记录Service业务层处理
+ *
+ * @author Lion Li
+ * @date 2025-08-27
+ */
+@Slf4j
+@RequiredArgsConstructor
+@Service
+public class BusinessCardToolsServiceImpl implements IBusinessCardToolsService {
+
+    private final BusinessCardToolsMapper baseMapper;
+
+    @Autowired
+    RedisUtil redisUtil;
+
+    /**
+     * 查询配牌记录
+     *
+     * @param id 主键
+     * @return 配牌记录
+     */
+    @Override
+    public BusinessCardToolsVo queryById(Long id){
+        return baseMapper.selectVoById(id);
+    }
+
+    /**
+     * 分页查询配牌记录列表
+     *
+     * @param bo        查询条件
+     * @param pageQuery 分页参数
+     * @return 配牌记录分页列表
+     */
+    @Override
+    public TableDataInfo<BusinessCardToolsVo> queryPageList(BusinessCardToolsBo bo, PageQuery pageQuery) {
+        LambdaQueryWrapper<BusinessCardTools> lqw = buildQueryWrapper(bo);
+        Page<BusinessCardToolsVo> result = baseMapper.selectVoPage(pageQuery.build(), lqw);
+        return TableDataInfo.build(result);
+    }
+
+    /**
+     * 查询符合条件的配牌记录列表
+     *
+     * @param bo 查询条件
+     * @return 配牌记录列表
+     */
+    @Override
+    public List<BusinessCardToolsVo> queryList(BusinessCardToolsBo bo) {
+        LambdaQueryWrapper<BusinessCardTools> lqw = buildQueryWrapper(bo);
+        return baseMapper.selectVoList(lqw);
+    }
+
+    private LambdaQueryWrapper<BusinessCardTools> buildQueryWrapper(BusinessCardToolsBo bo) {
+        Map<String, Object> params = bo.getParams();
+        LambdaQueryWrapper<BusinessCardTools> lqw = Wrappers.lambdaQuery();
+        lqw.orderByAsc(BusinessCardTools::getId);
+        lqw.like(StringUtils.isNotBlank(bo.getOperateName()), BusinessCardTools::getOperateName, bo.getOperateName());
+        lqw.eq(StringUtils.isNotBlank(bo.getContent()), BusinessCardTools::getContent, bo.getContent());
+        lqw.eq(bo.getCreateAt() != null, BusinessCardTools::getCreateAt, bo.getCreateAt());
+        lqw.eq(bo.getUpdateAt() != null, BusinessCardTools::getUpdateAt, bo.getUpdateAt());
+        return lqw;
+    }
+
+    /**
+     * 新增配牌记录
+     *
+     * @param bo 配牌记录
+     * @return 是否新增成功
+     */
+    @Override
+    public Boolean insertByBo(BusinessCardToolsBo bo) {
+        BusinessCardTools add = MapstructUtils.convert(bo, BusinessCardTools.class);
+        validEntityBeforeSave(add);
+        add.setOperateName(StringUtils.isEmpty(LoginHelper.getLoginUser().getUsername())?LoginHelper.getLoginUser().getNickname() : LoginHelper.getLoginUser().getUsername());
+        boolean flag = baseMapper.insertBusinessCardTools(add) > 0;
+        if (flag) {
+            redisUtil.set(RedisKeys.GAME_POKER_TEST_HANDS, bo.getContent(), 48*60*60*30); // 5分钟过期时间
+            bo.setId(add.getId());
+        }
+        return flag;
+    }
+
+    /**
+     * 修改配牌记录
+     *
+     * @param bo 配牌记录
+     * @return 是否修改成功
+     */
+    @Override
+    public Boolean updateByBo(BusinessCardToolsBo bo) {
+        BusinessCardTools update = MapstructUtils.convert(bo, BusinessCardTools.class);
+        validEntityBeforeSave(update);
+        return baseMapper.updateById(update) > 0;
+    }
+
+    /**
+     * 保存前的数据校验
+     */
+    private void validEntityBeforeSave(BusinessCardTools entity){
+        //TODO 做一些数据校验,如唯一约束
+    }
+
+    /**
+     * 校验并批量删除配牌记录信息
+     *
+     * @param ids     待删除的主键集合
+     * @param isValid 是否进行有效性校验
+     * @return 是否删除成功
+     */
+    @Override
+    public Boolean deleteWithValidByIds(Collection<Long> ids, Boolean isValid) {
+        if(isValid){
+            //TODO 做一些业务上的校验,判断是否需要校验
+        }
+        return baseMapper.deleteByIds(ids) > 0;
+    }
+
+    @Override
+    public BusinessCardToolsVo selectBusinessCardToolsMaxNew() {
+        return baseMapper.selectBusinessCardToolsMaxById();
+    }
+}

ruoyi-modules/ruoyi-system/src/main/java/org/dromara/business/utils/RedisKeys.java

@@ -2,9 +2,12 @@ package org.dromara.business.utils;
 
 public class RedisKeys {
 
-    // 定义 key 模板
+    //排名
     private static final String TOURNAMENT_LEADERBOARD = "game:poker:tournament:%d:leaderboard";
 
+    //手牌 底牌
+    public static final String GAME_POKER_TEST_HANDS = "game:poker:test:hands";
+
     /**
      * 生成排行榜 key
      * @param tournamentId 比赛 ID
@@ -15,4 +18,5 @@ public class RedisKeys {
     }
 
 
+
 }

ruoyi-modules/ruoyi-system/src/main/java/org/dromara/business/utils/RedisUtil.java

@@ -20,7 +20,7 @@ public class RedisUtil {
     private final ObjectMapper objectMapper = new ObjectMapper();
 
     /**
-     * 设置缓存值 + 过期时间（分钟）
+     * 设置缓存值 + 过期时间（秒）
      */
     public boolean set(String key, Object value, long time) {
         try {

ruoyi-modules/ruoyi-system/src/main/resources/mapper/business/BusinessCardToolsMapper.xml

@@ -0,0 +1,39 @@
+<?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="org.dromara.business.mapper.BusinessCardToolsMapper">
+
+
+    <select id="selectBusinessCardToolsMaxById"   resultType="org.dromara.business.domain.vo.BusinessCardToolsVo">
+        SELECT
+            id,
+            operate_name,
+            content,
+            create_at,
+            update_at
+        FROM business_card_tools  order by  create_at desc  limit 1
+    </select>
+
+
+
+
+    <insert id="insertBusinessCardTools" useGeneratedKeys="true" keyProperty="id">
+        INSERT INTO business_card_tools
+        <trim prefix="(" suffix=")" suffixOverrides=",">
+            <if test="id != null">id,</if>
+            <if test="operateName != null and operateName != ''">operate_name,</if>
+            <if test="content != null and content != ''">content,</if>
+            <!-- 强制插入时间 -->
+            create_at,
+            update_at
+        </trim>
+        <trim prefix="VALUES (" suffix=")" suffixOverrides=",">
+            <if test="id != null">#{id},</if>
+            <if test="operateName != null and operateName != ''">#{operateName},</if>
+            <if test="content != null and content != ''">#{content},</if>
+            NOW(), NOW()
+        </trim>
+    </insert>
+
+</mapper>