feat(business): 添加手牌历史记录功能

- 新增 HandHistory 和 PlayerHandHistory 模型- 实现手牌历史记录的 CRUD 接口和服务
- 添加动作解析工具类 ActionParserUtils- 实现分页查询和导出功能

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

@@ -0,0 +1,126 @@
+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.HandHistoryBo;
+import org.dromara.business.domain.vo.HandHistoryVo;
+import org.dromara.business.service.IHandHistoryService;
+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-07-18
+ */
+@Validated
+@RequiredArgsConstructor
+@RestController
+@RequestMapping("/business/history")
+public class HandHistoryController extends BaseController {
+
+    private final IHandHistoryService handHistoryService;
+
+    /**
+     * 查询【请填写功能名称】列表
+     */
+    @SaCheckPermission("business:history:list")
+    @GetMapping("/list")
+    public TableDataInfo<HandHistoryVo> list(HandHistoryBo bo, PageQuery pageQuery) {
+        return handHistoryService.queryPageList(bo, pageQuery);
+    }
+
+    /**
+     * 导出【请填写功能名称】列表
+     */
+    @SaCheckPermission("business:history:export")
+    @Log(title = "【请填写功能名称】", businessType = BusinessType.EXPORT)
+    @PostMapping("/export")
+    public void export(HandHistoryBo bo, HttpServletResponse response) {
+        List<HandHistoryVo> list = handHistoryService.queryList(bo);
+        ExcelUtil.exportExcel(list, "【请填写功能名称】", HandHistoryVo.class, response);
+    }
+
+    /**
+     * 获取【请填写功能名称】详细信息
+     *
+     * @param id 主键
+     */
+    @SaCheckPermission("business:history:query")
+    @GetMapping("/{id}")
+    public R<HandHistoryVo> getInfo(@NotNull(message = "主键不能为空")
+                                     @PathVariable Long id) {
+        return R.ok(handHistoryService.queryById(id));
+    }
+
+    /**
+     * 新增【请填写功能名称】
+     */
+    @SaCheckPermission("business:history:add")
+    @Log(title = "【请填写功能名称】", businessType = BusinessType.INSERT)
+    @RepeatSubmit()
+    @PostMapping()
+    public R<Void> add(@Validated(AddGroup.class) @RequestBody HandHistoryBo bo) {
+        return toAjax(handHistoryService.insertByBo(bo));
+    }
+
+    /**
+     * 修改【请填写功能名称】
+     */
+    @SaCheckPermission("business:history:edit")
+    @Log(title = "【请填写功能名称】", businessType = BusinessType.UPDATE)
+    @RepeatSubmit()
+    @PutMapping()
+    public R<Void> edit(@Validated(EditGroup.class) @RequestBody HandHistoryBo bo) {
+        return toAjax(handHistoryService.updateByBo(bo));
+    }
+
+    /**
+     * 删除【请填写功能名称】
+     *
+     * @param ids 主键串
+     */
+    @SaCheckPermission("business:history:remove")
+    @Log(title = "【请填写功能名称】", businessType = BusinessType.DELETE)
+    @DeleteMapping("/{ids}")
+    public R<Void> remove(@NotEmpty(message = "主键不能为空")
+                          @PathVariable Long[] ids) {
+        return toAjax(handHistoryService.deleteWithValidByIds(List.of(ids), true));
+    }
+
+
+    /**
+     * 查询桌次
+     */
+    @SaCheckPermission("business:history:selectAllHandZhuoCi")
+    @Log(title = "【查询桌次】")
+    @PostMapping("/selectAllHandZhuoCi")
+    public R<List<HandHistoryVo>> selectAllHandZhuoCi(HandHistoryBo bo) {
+        return R.ok(handHistoryService.selectAllHandZhuoCi(bo));
+    }
+
+
+
+    @SaCheckPermission("business:history:getPlayHistoryInfo")
+    @Log(title = "【查询对局记录】")
+    @PostMapping("/getPlayHistoryInfo")
+    public TableDataInfo<HandHistoryVo> getPlayHistoryInfo(HandHistoryBo bo, PageQuery pageQuery) {
+       return handHistoryService.getPlayHistoryInfo(bo,pageQuery);
+    }
+
+}

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

@@ -0,0 +1,106 @@
+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.PlayerHandHistoryBo;
+import org.dromara.business.domain.vo.PlayerHandHistoryVo;
+import org.dromara.business.service.IPlayerHandHistoryService;
+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-07-18
+ */
+@Validated
+@RequiredArgsConstructor
+@RestController
+@RequestMapping("/business/handHistory")
+public class PlayerHandHistoryController extends BaseController {
+
+    private final IPlayerHandHistoryService playerHandHistoryService;
+
+    /**
+     * 查询【请填写功能名称】列表
+     */
+    @SaCheckPermission("business:handHistory:list")
+    @GetMapping("/list")
+    public TableDataInfo<PlayerHandHistoryVo> list(PlayerHandHistoryBo bo, PageQuery pageQuery) {
+        return playerHandHistoryService.queryPageList(bo, pageQuery);
+    }
+
+    /**
+     * 导出【请填写功能名称】列表
+     */
+    @SaCheckPermission("business:handHistory:export")
+    @Log(title = "【请填写功能名称】", businessType = BusinessType.EXPORT)
+    @PostMapping("/export")
+    public void export(PlayerHandHistoryBo bo, HttpServletResponse response) {
+        List<PlayerHandHistoryVo> list = playerHandHistoryService.queryList(bo);
+        ExcelUtil.exportExcel(list, "【请填写功能名称】", PlayerHandHistoryVo.class, response);
+    }
+
+    /**
+     * 获取【请填写功能名称】详细信息
+     *
+     * @param playerId 主键
+     */
+    @SaCheckPermission("business:handHistory:query")
+    @GetMapping("/{playerId}")
+    public R<PlayerHandHistoryVo> getInfo(@NotNull(message = "主键不能为空")
+                                     @PathVariable Long playerId) {
+        return R.ok(playerHandHistoryService.queryById(playerId));
+    }
+
+    /**
+     * 新增【请填写功能名称】
+     */
+    @SaCheckPermission("business:handHistory:add")
+    @Log(title = "【请填写功能名称】", businessType = BusinessType.INSERT)
+    @RepeatSubmit()
+    @PostMapping()
+    public R<Void> add(@Validated(AddGroup.class) @RequestBody PlayerHandHistoryBo bo) {
+        return toAjax(playerHandHistoryService.insertByBo(bo));
+    }
+
+    /**
+     * 修改【请填写功能名称】
+     */
+    @SaCheckPermission("business:handHistory:edit")
+    @Log(title = "【请填写功能名称】", businessType = BusinessType.UPDATE)
+    @RepeatSubmit()
+    @PutMapping()
+    public R<Void> edit(@Validated(EditGroup.class) @RequestBody PlayerHandHistoryBo bo) {
+        return toAjax(playerHandHistoryService.updateByBo(bo));
+    }
+
+    /**
+     * 删除【请填写功能名称】
+     *
+     * @param playerIds 主键串
+     */
+    @SaCheckPermission("business:handHistory:remove")
+    @Log(title = "【请填写功能名称】", businessType = BusinessType.DELETE)
+    @DeleteMapping("/{playerIds}")
+    public R<Void> remove(@NotEmpty(message = "主键不能为空")
+                          @PathVariable Long[] playerIds) {
+        return toAjax(playerHandHistoryService.deleteWithValidByIds(List.of(playerIds), true));
+    }
+}

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

@@ -0,0 +1,77 @@
+package org.dromara.business.domain;
+import com.baomidou.mybatisplus.annotation.*;
+import lombok.Data;
+import java.util.Date;
+import java.io.Serial;
+
+/**
+ * 【请填写功能名称】对象 hand_history
+ *
+ * @author Lion Li
+ * @date 2025-07-18
+ */
+@Data
+@TableName("hand_history")
+public class HandHistory {
+
+    @Serial
+    private static final long serialVersionUID = 1L;
+
+    /**
+     *
+     */
+    @TableId(value = "id")
+    private Long id;
+
+    /**
+     *
+     */
+    private String handId;
+
+    /**
+     *
+     */
+    private Long tournamentId;
+
+    /**
+     *
+     */
+    private String involvedPlayers;
+
+    /**
+     *
+     */
+    private Long handNumber;
+
+    /**
+     *
+     */
+    private String boardCards;
+
+    /**
+     *
+     */
+    private Long totalPot;
+
+    /**
+     *
+     */
+    private Date handStartTime;
+
+    /**
+     *
+     */
+    private Date handEndTime;
+
+    /**
+     *
+     */
+    private String handDetails;
+
+    /**
+     *
+     */
+    private Date createdAt;
+
+
+}

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

@@ -0,0 +1,31 @@
+package org.dromara.business.domain;
+
+import com.baomidou.mybatisplus.annotation.*;
+import lombok.Data;
+import java.io.Serial;
+
+/**
+ * 【请填写功能名称】对象 player_hand_history
+ *
+ * @author Lion Li
+ * @date 2025-07-18
+ */
+@Data
+@TableName("player_hand_history")
+public class PlayerHandHistory {
+
+    @Serial
+    private static final long serialVersionUID = 1L;
+
+    /**
+     *
+     */
+    private Long playerId;
+
+    /**
+     *
+     */
+    private Long handHistoryId;
+
+
+}

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

@@ -0,0 +1,92 @@
+package org.dromara.business.domain.bo;
+
+import org.dromara.business.domain.HandHistory;
+import org.dromara.common.mybatis.core.domain.BaseEntity;
+import org.dromara.common.core.validate.AddGroup;
+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;
+/**
+ * 【请填写功能名称】业务对象 hand_history
+ *
+ * @author Lion Li
+ * @date 2025-07-18
+ */
+@Data
+@EqualsAndHashCode(callSuper = true)
+@AutoMapper(target = HandHistory.class, reverseConvertGenerate = false)
+public class HandHistoryBo extends BaseEntity {
+
+    /**
+     *
+     */
+    // @NotNull(message = "不能为空", groups = { EditGroup.class })
+    private Long id;
+
+    /**
+     *
+     */
+    // @NotBlank(message = "不能为空", groups = { AddGroup.class, EditGroup.class })
+    private String handId;
+
+    /**
+     *
+     */
+    //@NotNull(message = "不能为空", groups = { AddGroup.class, EditGroup.class })
+    private Long tournamentId;
+
+    /**
+     *
+     */
+    //@NotBlank(message = "不能为空", groups = { AddGroup.class, EditGroup.class })
+    private String involvedPlayers;
+
+    /**
+     *
+     */
+    //@NotNull(message = "不能为空", groups = { AddGroup.class, EditGroup.class })
+    private Long handNumber;
+
+    /**
+     *
+     */
+    private String boardCards;
+
+    /**
+     *
+     */
+    //@NotNull(message = "不能为空", groups = { AddGroup.class, EditGroup.class })
+    private Long totalPot;
+
+    /**
+     *
+     */
+    //@NotNull(message = "不能为空", groups = { AddGroup.class, EditGroup.class })
+    private Date handStartTime;
+
+    /**
+     *
+     */
+    private Date handEndTime;
+
+    /**
+     *
+     */
+    //@NotBlank(message = "不能为空", groups = { AddGroup.class, EditGroup.class })
+    private String handDetails;
+
+    /**
+     *
+     */
+    //@NotNull(message = "不能为空", groups = { AddGroup.class, EditGroup.class })
+    private Date createdAt;
+
+
+    private Long playerId;
+
+    private Long historyId;
+
+}

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

@@ -0,0 +1,36 @@
+package org.dromara.business.domain.bo;
+
+import org.dromara.business.domain.PlayerHandHistory;
+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.*;
+
+/**
+ * 【请填写功能名称】业务对象 player_hand_history
+ *
+ * @author Lion Li
+ * @date 2025-07-18
+ */
+@Data
+@EqualsAndHashCode(callSuper = true)
+@AutoMapper(target = PlayerHandHistory.class, reverseConvertGenerate = false)
+public class PlayerHandHistoryBo extends BaseEntity {
+
+    /**
+     *
+     */
+    @NotNull(message = "不能为空", groups = { EditGroup.class })
+    private Long playerId;
+
+    /**
+     *
+     */
+    @NotNull(message = "不能为空", groups = { EditGroup.class })
+    private Long handHistoryId;
+
+
+}

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

@@ -0,0 +1,15 @@
+package org.dromara.business.domain.vo;
+
+import lombok.Data;
+
+@Data
+public class ActionVo {
+
+    private String stage;
+    private String action;
+    private Long playerId;
+    private int addAmount;
+    private int seatNumber;
+
+
+}

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

@@ -0,0 +1,101 @@
+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.HandHistory;
+
+import java.io.Serial;
+import java.io.Serializable;
+
+
+
+/**
+ * 【请填写功能名称】视图对象 hand_history
+ *
+ * @author Lion Li
+ * @date 2025-07-18
+ */
+@Data
+@ExcelIgnoreUnannotated
+@AutoMapper(target = HandHistory.class)
+public class HandHistoryVo implements Serializable {
+
+    @Serial
+    private static final long serialVersionUID = 1L;
+
+    /**
+     *
+     */
+    @ExcelProperty(value = "")
+    private Long id;
+
+    /**
+     *
+     */
+    @ExcelProperty(value = "")
+    private String handId;
+
+    /**
+     *
+     */
+    @ExcelProperty(value = "")
+    private Long tournamentId;
+
+    /**
+     *
+     */
+    @ExcelProperty(value = "")
+    private String involvedPlayers;
+
+    /**
+     *
+     */
+    @ExcelProperty(value = "")
+    private Long handNumber;
+
+    /**
+     *
+     */
+    @ExcelProperty(value = "")
+    private String boardCards;
+
+    /**
+     *
+     */
+    @ExcelProperty(value = "")
+    private Long totalPot;
+
+    /**
+     *
+     */
+    @ExcelProperty(value = "")
+    private Date handStartTime;
+
+    /**
+     *
+     */
+    @ExcelProperty(value = "")
+    private Date handEndTime;
+
+    /**
+     *
+     */
+    @ExcelProperty(value = "")
+    private String handDetails;
+
+    /**
+     *
+     */
+    @ExcelProperty(value = "")
+    private Date createdAt;
+
+    /**
+     * 操作内容
+     */
+    private String operateText;
+
+
+}

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

@@ -0,0 +1,42 @@
+package org.dromara.business.domain.vo;
+
+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.PlayerHandHistory;
+
+import java.io.Serial;
+import java.io.Serializable;
+
+
+
+/**
+ * 【请填写功能名称】视图对象 player_hand_history
+ *
+ * @author Lion Li
+ * @date 2025-07-18
+ */
+@Data
+@ExcelIgnoreUnannotated
+@AutoMapper(target = PlayerHandHistory.class)
+public class PlayerHandHistoryVo implements Serializable {
+
+    @Serial
+    private static final long serialVersionUID = 1L;
+
+    /**
+     *
+     */
+    @ExcelProperty(value = "")
+    private Long playerId;
+
+    /**
+     *
+     */
+    @ExcelProperty(value = "")
+    private Long handHistoryId;
+
+
+}

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

@@ -0,0 +1,27 @@
+package org.dromara.business.mapper;
+
+import com.baomidou.dynamic.datasource.annotation.DS;
+import com.baomidou.mybatisplus.annotation.InterceptorIgnore;
+import org.apache.ibatis.annotations.Param;
+import org.dromara.business.domain.HandHistory;
+import org.dromara.business.domain.vo.HandHistoryVo;
+import org.dromara.common.mybatis.core.mapper.BaseMapperPlus;
+
+import java.util.List;
+
+/**
+ * 【请填写功能名称】Mapper接口
+ *
+ * @author Lion Li
+ * @date 2025-07-18
+ */
+@DS("mysql2")
+public interface HandHistoryMapper extends BaseMapperPlus<HandHistory, HandHistoryVo> {
+
+     @InterceptorIgnore(tenantLine = "true")
+     HandHistoryVo selectAllHandHistory(@Param("tournamentId") Long tournamentId,@Param("historyId") Long historyId);
+
+     @InterceptorIgnore(tenantLine = "true")
+     List<HandHistoryVo> selectAllHandZhuoCi(@Param("tournamentId") Long tournamentId,@Param("playerId") Long playerId);
+
+}

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

@@ -0,0 +1,15 @@
+package org.dromara.business.mapper;
+
+import org.dromara.business.domain.PlayerHandHistory;
+import org.dromara.business.domain.vo.PlayerHandHistoryVo;
+import org.dromara.common.mybatis.core.mapper.BaseMapperPlus;
+
+/**
+ * 【请填写功能名称】Mapper接口
+ *
+ * @author Lion Li
+ * @date 2025-07-18
+ */
+public interface PlayerHandHistoryMapper extends BaseMapperPlus<PlayerHandHistory, PlayerHandHistoryVo> {
+
+}

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

@@ -0,0 +1,80 @@
+package org.dromara.business.service;
+
+import org.dromara.business.domain.bo.HandHistoryBo;
+import org.dromara.business.domain.vo.HandHistoryVo;
+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-07-18
+ */
+public interface IHandHistoryService {
+
+    /**
+     * 查询【请填写功能名称】
+     *
+     * @param id 主键
+     * @return 【请填写功能名称】
+     */
+    HandHistoryVo queryById(Long id);
+
+    /**
+     * 分页查询【请填写功能名称】列表
+     *
+     * @param bo        查询条件
+     * @param pageQuery 分页参数
+     * @return 【请填写功能名称】分页列表
+     */
+    TableDataInfo<HandHistoryVo> queryPageList(HandHistoryBo bo, PageQuery pageQuery);
+
+    /**
+     * 查询符合条件的【请填写功能名称】列表
+     *
+     * @param bo 查询条件
+     * @return 【请填写功能名称】列表
+     */
+    List<HandHistoryVo> queryList(HandHistoryBo bo);
+
+    /**
+     * 新增【请填写功能名称】
+     *
+     * @param bo 【请填写功能名称】
+     * @return 是否新增成功
+     */
+    Boolean insertByBo(HandHistoryBo bo);
+
+    /**
+     * 修改【请填写功能名称】
+     *
+     * @param bo 【请填写功能名称】
+     * @return 是否修改成功
+     */
+    Boolean updateByBo(HandHistoryBo bo);
+
+    /**
+     * 校验并批量删除【请填写功能名称】信息
+     *
+     * @param ids     待删除的主键集合
+     * @param isValid 是否进行有效性校验
+     * @return 是否删除成功
+     */
+    Boolean deleteWithValidByIds(Collection<Long> ids, Boolean isValid);
+
+    TableDataInfo<HandHistoryVo> getPlayHistoryInfo(HandHistoryBo bo, PageQuery pageQuery);
+
+    /**
+     * 查询桌次
+     * @param bo
+     * @return
+     */
+    List<HandHistoryVo> selectAllHandZhuoCi(HandHistoryBo bo);
+
+
+
+}

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

@@ -0,0 +1,68 @@
+package org.dromara.business.service;
+
+import org.dromara.business.domain.bo.PlayerHandHistoryBo;
+import org.dromara.business.domain.vo.PlayerHandHistoryVo;
+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-07-18
+ */
+public interface IPlayerHandHistoryService {
+
+    /**
+     * 查询【请填写功能名称】
+     *
+     * @param playerId 主键
+     * @return 【请填写功能名称】
+     */
+    PlayerHandHistoryVo queryById(Long playerId);
+
+    /**
+     * 分页查询【请填写功能名称】列表
+     *
+     * @param bo        查询条件
+     * @param pageQuery 分页参数
+     * @return 【请填写功能名称】分页列表
+     */
+    TableDataInfo<PlayerHandHistoryVo> queryPageList(PlayerHandHistoryBo bo, PageQuery pageQuery);
+
+    /**
+     * 查询符合条件的【请填写功能名称】列表
+     *
+     * @param bo 查询条件
+     * @return 【请填写功能名称】列表
+     */
+    List<PlayerHandHistoryVo> queryList(PlayerHandHistoryBo bo);
+
+    /**
+     * 新增【请填写功能名称】
+     *
+     * @param bo 【请填写功能名称】
+     * @return 是否新增成功
+     */
+    Boolean insertByBo(PlayerHandHistoryBo bo);
+
+    /**
+     * 修改【请填写功能名称】
+     *
+     * @param bo 【请填写功能名称】
+     * @return 是否修改成功
+     */
+    Boolean updateByBo(PlayerHandHistoryBo bo);
+
+    /**
+     * 校验并批量删除【请填写功能名称】信息
+     *
+     * @param ids     待删除的主键集合
+     * @param isValid 是否进行有效性校验
+     * @return 是否删除成功
+     */
+    Boolean deleteWithValidByIds(Collection<Long> ids, Boolean isValid);
+}

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

@@ -0,0 +1,186 @@
+package org.dromara.business.service.impl;
+
+import com.fasterxml.jackson.databind.JsonNode;
+import com.fasterxml.jackson.databind.ObjectMapper;
+import org.dromara.business.domain.HandHistory;
+import org.dromara.business.domain.bo.HandHistoryBo;
+import org.dromara.business.domain.vo.ActionVo;
+import org.dromara.business.domain.vo.HandHistoryVo;
+import org.dromara.business.mapper.HandHistoryMapper;
+import org.dromara.business.service.IHandHistoryService;
+import org.dromara.business.utils.ActionParserUtils;
+import org.dromara.business.utils.PageUtils;
+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.springframework.stereotype.Service;
+
+
+import java.util.ArrayList;
+import java.util.List;
+import java.util.Map;
+import java.util.Collection;
+
+/**
+ * 【请填写功能名称】Service业务层处理
+ *
+ * @author Lion Li
+ * @date 2025-07-18
+ */
+@Slf4j
+@RequiredArgsConstructor
+@Service
+public class HandHistoryServiceImpl implements IHandHistoryService {
+
+    private final HandHistoryMapper baseMapper;
+
+    /**
+     * 查询【请填写功能名称】
+     *
+     * @param id 主键
+     * @return 【请填写功能名称】
+     */
+    @Override
+    public HandHistoryVo queryById(Long id){
+        return baseMapper.selectVoById(id);
+    }
+
+    /**
+     * 分页查询【请填写功能名称】列表
+     *
+     * @param bo        查询条件
+     * @param pageQuery 分页参数
+     * @return 【请填写功能名称】分页列表
+     */
+    @Override
+    public TableDataInfo<HandHistoryVo> queryPageList(HandHistoryBo bo, PageQuery pageQuery) {
+        LambdaQueryWrapper<HandHistory> lqw = buildQueryWrapper(bo);
+        Page<HandHistoryVo> result = baseMapper.selectVoPage(pageQuery.build(), lqw);
+        return TableDataInfo.build(result);
+    }
+
+    /**
+     * 查询符合条件的【请填写功能名称】列表
+     *
+     * @param bo 查询条件
+     * @return 【请填写功能名称】列表
+     */
+    @Override
+    public List<HandHistoryVo> queryList(HandHistoryBo bo) {
+        LambdaQueryWrapper<HandHistory> lqw = buildQueryWrapper(bo);
+        return baseMapper.selectVoList(lqw);
+    }
+
+    private LambdaQueryWrapper<HandHistory> buildQueryWrapper(HandHistoryBo bo) {
+        Map<String, Object> params = bo.getParams();
+        LambdaQueryWrapper<HandHistory> lqw = Wrappers.lambdaQuery();
+        lqw.orderByAsc(HandHistory::getId);
+        lqw.eq(StringUtils.isNotBlank(bo.getHandId()), HandHistory::getHandId, bo.getHandId());
+        lqw.eq(bo.getTournamentId() != null, HandHistory::getTournamentId, bo.getTournamentId());
+        lqw.eq(StringUtils.isNotBlank(bo.getInvolvedPlayers()), HandHistory::getInvolvedPlayers, bo.getInvolvedPlayers());
+        lqw.eq(bo.getHandNumber() != null, HandHistory::getHandNumber, bo.getHandNumber());
+        lqw.eq(StringUtils.isNotBlank(bo.getBoardCards()), HandHistory::getBoardCards, bo.getBoardCards());
+        lqw.eq(bo.getTotalPot() != null, HandHistory::getTotalPot, bo.getTotalPot());
+        lqw.eq(bo.getHandStartTime() != null, HandHistory::getHandStartTime, bo.getHandStartTime());
+        lqw.eq(bo.getHandEndTime() != null, HandHistory::getHandEndTime, bo.getHandEndTime());
+        lqw.eq(StringUtils.isNotBlank(bo.getHandDetails()), HandHistory::getHandDetails, bo.getHandDetails());
+        lqw.eq(bo.getCreatedAt() != null, HandHistory::getCreatedAt, bo.getCreatedAt());
+        return lqw;
+    }
+
+    /**
+     * 新增【请填写功能名称】
+     *
+     * @param bo 【请填写功能名称】
+     * @return 是否新增成功
+     */
+    @Override
+    public Boolean insertByBo(HandHistoryBo bo) {
+        HandHistory add = MapstructUtils.convert(bo, HandHistory.class);
+        validEntityBeforeSave(add);
+        boolean flag = baseMapper.insert(add) > 0;
+        if (flag) {
+            bo.setId(add.getId());
+        }
+        return flag;
+    }
+
+    /**
+     * 修改【请填写功能名称】
+     *
+     * @param bo 【请填写功能名称】
+     * @return 是否修改成功
+     */
+    @Override
+    public Boolean updateByBo(HandHistoryBo bo) {
+        HandHistory update = MapstructUtils.convert(bo, HandHistory.class);
+        validEntityBeforeSave(update);
+        return baseMapper.updateById(update) > 0;
+    }
+
+    /**
+     * 保存前的数据校验
+     */
+    private void validEntityBeforeSave(HandHistory 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  TableDataInfo<HandHistoryVo> getPlayHistoryInfo(HandHistoryBo bo, PageQuery pageQuery) {
+
+        HandHistoryVo handHistoryVo = baseMapper.selectAllHandHistory(bo.getTournamentId(), bo.getHistoryId());
+        if(handHistoryVo!=null){
+            //过程操作记录
+            String handDetails = handHistoryVo.getHandDetails();
+            try {
+                List<String> actionsToChineseList = ActionParserUtils.parseActionsToChineseList(handDetails);
+                List<HandHistoryVo> handHistoryVoList=new ArrayList<>();
+                for (String s : actionsToChineseList) {
+                    HandHistoryVo handHistoryVo1 = new HandHistoryVo();
+                    handHistoryVo1.setOperateText(s);
+                    handHistoryVoList.add(handHistoryVo1);
+                }
+
+                // 调用分页方法
+                TableDataInfo<HandHistoryVo> pageInfo = PageUtils.toTablePage(handHistoryVoList, pageQuery.getPageNum(), pageQuery.getPageSize());
+
+                return pageInfo;
+
+            }catch (Exception e){
+                e.printStackTrace();
+            }
+        }
+         return new TableDataInfo<>();
+   }
+
+    @Override
+    public List<HandHistoryVo> selectAllHandZhuoCi(HandHistoryBo bo) {
+         return baseMapper.selectAllHandZhuoCi(bo.getTournamentId(),bo.getPlayerId());
+    }
+
+
+}

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

@@ -0,0 +1,133 @@
+package org.dromara.business.service.impl;
+
+import org.dromara.business.domain.PlayerHandHistory;
+import org.dromara.business.domain.bo.PlayerHandHistoryBo;
+import org.dromara.business.domain.vo.PlayerHandHistoryVo;
+import org.dromara.business.mapper.PlayerHandHistoryMapper;
+import org.dromara.business.service.IPlayerHandHistoryService;
+import org.dromara.common.core.utils.MapstructUtils;
+
+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.springframework.stereotype.Service;
+
+
+import java.util.List;
+import java.util.Map;
+import java.util.Collection;
+
+/**
+ * 【请填写功能名称】Service业务层处理
+ *
+ * @author Lion Li
+ * @date 2025-07-18
+ */
+@Slf4j
+@RequiredArgsConstructor
+@Service
+public class PlayerHandHistoryServiceImpl implements IPlayerHandHistoryService {
+
+    private final PlayerHandHistoryMapper baseMapper;
+
+    /**
+     * 查询【请填写功能名称】
+     *
+     * @param playerId 主键
+     * @return 【请填写功能名称】
+     */
+    @Override
+    public PlayerHandHistoryVo queryById(Long playerId){
+        return baseMapper.selectVoById(playerId);
+    }
+
+    /**
+     * 分页查询【请填写功能名称】列表
+     *
+     * @param bo        查询条件
+     * @param pageQuery 分页参数
+     * @return 【请填写功能名称】分页列表
+     */
+    @Override
+    public TableDataInfo<PlayerHandHistoryVo> queryPageList(PlayerHandHistoryBo bo, PageQuery pageQuery) {
+        LambdaQueryWrapper<PlayerHandHistory> lqw = buildQueryWrapper(bo);
+        Page<PlayerHandHistoryVo> result = baseMapper.selectVoPage(pageQuery.build(), lqw);
+        return TableDataInfo.build(result);
+    }
+
+    /**
+     * 查询符合条件的【请填写功能名称】列表
+     *
+     * @param bo 查询条件
+     * @return 【请填写功能名称】列表
+     */
+    @Override
+    public List<PlayerHandHistoryVo> queryList(PlayerHandHistoryBo bo) {
+        LambdaQueryWrapper<PlayerHandHistory> lqw = buildQueryWrapper(bo);
+        return baseMapper.selectVoList(lqw);
+    }
+
+    private LambdaQueryWrapper<PlayerHandHistory> buildQueryWrapper(PlayerHandHistoryBo bo) {
+        Map<String, Object> params = bo.getParams();
+        LambdaQueryWrapper<PlayerHandHistory> lqw = Wrappers.lambdaQuery();
+        lqw.orderByAsc(PlayerHandHistory::getPlayerId);
+        lqw.orderByAsc(PlayerHandHistory::getHandHistoryId);
+        return lqw;
+    }
+
+    /**
+     * 新增【请填写功能名称】
+     *
+     * @param bo 【请填写功能名称】
+     * @return 是否新增成功
+     */
+    @Override
+    public Boolean insertByBo(PlayerHandHistoryBo bo) {
+        PlayerHandHistory add = MapstructUtils.convert(bo, PlayerHandHistory.class);
+        validEntityBeforeSave(add);
+        boolean flag = baseMapper.insert(add) > 0;
+        if (flag) {
+            bo.setPlayerId(add.getPlayerId());
+        }
+        return flag;
+    }
+
+    /**
+     * 修改【请填写功能名称】
+     *
+     * @param bo 【请填写功能名称】
+     * @return 是否修改成功
+     */
+    @Override
+    public Boolean updateByBo(PlayerHandHistoryBo bo) {
+        PlayerHandHistory update = MapstructUtils.convert(bo, PlayerHandHistory.class);
+        validEntityBeforeSave(update);
+        return baseMapper.updateById(update) > 0;
+    }
+
+    /**
+     * 保存前的数据校验
+     */
+    private void validEntityBeforeSave(PlayerHandHistory entity){
+        //TODO 做一些数据校验,如唯一约束
+    }
+
+    /**
+     * 校验并批量删除【请填写功能名称】信息
+     *
+     * @param ids     待删除的主键集合
+     * @param isValid 是否进行有效性校验
+     * @return 是否删除成功
+     */
+    @Override
+    public Boolean deleteWithValidByIds(Collection<Long> ids, Boolean isValid) {
+        if(isValid){
+            //TODO 做一些业务上的校验,判断是否需要校验
+        }
+        return baseMapper.deleteByIds(ids) > 0;
+    }
+}

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

@@ -0,0 +1,77 @@
+package org.dromara.business.utils;
+
+import com.fasterxml.jackson.databind.JsonNode;
+import com.fasterxml.jackson.databind.ObjectMapper;
+
+import java.util.ArrayList;
+import java.util.HashMap;
+import java.util.List;
+import java.util.Map;
+
+public class ActionParserUtils {
+
+
+    // 阶段映射
+    private static final Map<String, String> STAGE_MAP = Map.of(
+        "PREFLOP", "翻牌前",
+        "FLOP", "翻牌后",
+        "TURN", "转牌",
+        "RIVER", "河牌"
+    );
+
+    // 操作映射
+    private static final Map<String, String> ACTION_MAP = Map.of(
+        "FOLD", "弃牌",
+        "CHECK", "过牌",
+        "CALL", "跟注",
+        "RAISE", "加注",
+        "ALL_IN", "全压"
+    );
+
+    /**
+     * 将 JSON 中的 actions 解析为中文描述的列表
+     */
+    public static List<String> parseActionsToChineseList(String json) throws Exception {
+        ObjectMapper mapper = new ObjectMapper();
+        JsonNode rootNode = mapper.readTree(json);
+
+        // 构建 playerId -> name 映射
+        Map<Integer, String> playerMap = new HashMap<>();
+        JsonNode playersNode = rootNode.get("players");
+        if (playersNode != null && playersNode.isArray()) {
+            for (JsonNode playerNode : playersNode) {
+                int id = playerNode.get("id").asInt();
+                String name = playerNode.get("name").asText();
+                playerMap.put(id, name);
+            }
+        }
+
+        List<String> chineseActions = new ArrayList<>();
+        JsonNode actionsNode = rootNode.get("actions");
+
+        if (actionsNode != null && actionsNode.isArray()) {
+            for (JsonNode actionNode : actionsNode) {
+                String stageKey = actionNode.get("stage").asText();
+                String stage = STAGE_MAP.getOrDefault(stageKey, "未知阶段");
+
+                String actionKey = actionNode.get("action").asText();
+                String action = ACTION_MAP.getOrDefault(actionKey, "未知操作");
+
+                int playerId = actionNode.get("playerId").asInt();
+                int addAmount = actionNode.get("addAmount").asInt();
+                int seatNumber = actionNode.get("seatNumber").asInt();
+                String playerName = playerMap.getOrDefault(playerId, "未知玩家");
+
+                String desc = String.format("[%s] 玩家 %s（座位%d）%s，加注金额为 %d",
+                    stage, playerName, seatNumber, action, addAmount);
+
+                chineseActions.add(desc);
+            }
+        }
+
+        return chineseActions;
+    }
+
+
+
+}

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

@@ -0,0 +1,33 @@
+package org.dromara.business.utils;
+
+import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
+import org.dromara.common.mybatis.core.page.TableDataInfo;
+
+import java.util.List;
+
+public class PageUtils {
+
+    /**
+     * 将 List<T> 分页处理，返回 TableDataInfo<T>
+     */
+    public static <T> TableDataInfo<T> toTablePage(List<T> dataList, int pageNum, int pageSize) {
+        // 构造分页对象
+        Page<T> page = new Page<>(pageNum, pageSize);
+        // 总记录数
+        page.setTotal(dataList.size());
+
+        // 计算分页数据
+        int fromIndex = (pageNum - 1) * pageSize;
+        int toIndex = Math.min(fromIndex + pageSize, dataList.size());
+        List<T> pageList = dataList.subList(fromIndex, toIndex);
+
+        // 设置分页结果
+        page.setRecords(pageList);
+
+        // 返回表格数据对象
+        return TableDataInfo.build(page);
+    }
+
+
+
+}

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

@@ -0,0 +1,33 @@
+<?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.HandHistoryMapper">
+
+
+    <select id="selectAllHandHistory" resultType="org.dromara.business.domain.vo.HandHistoryVo">
+        SELECT
+            id,
+            hand_id,
+            tournament_id,
+            involved_players,
+            hand_number,
+            board_cards,
+            total_pot,
+            hand_start_time,
+            hand_end_time,
+            hand_details,
+            created_at
+        FROM hand_history  where tournament_id=#{tournamentId} AND id=#{historyId}
+    </select>
+
+
+    <select id="selectAllHandZhuoCi" resultType="org.dromara.business.domain.vo.HandHistoryVo">
+        select * from  hand_history where id in (
+            select  hand_history_id from    player_hand_history where player_id=#{playerId}
+        )  and  tournament_id=#{tournamentId}   ORDER BY created_at asc
+    </select>
+
+
+
+</mapper>

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

@@ -0,0 +1,7 @@
+<?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.PlayerHandHistoryMapper">
+
+</mapper>