feat(game): 添加成绩明细功能模块

- 创建 GameScoreDetail 实体类，包含明细主键、关联主表ID、轮次序号、原始成绩、失误次数等字段
- 实现 GameScoreDetailBo 业务对象，添加数据验证规则和分组校验
- 开发 GameScoreDetailController 控制器，提供增删改查和导出功能接口
- 集成 GameScoreDetailMapper 数据访问层，基于 BaseMapperPlus 扩展
- 设计 GameScoreDetailVo 视图对象，支持 Excel 导出功能
- 实现 GameScoreDetailService 业务逻辑层，包含分页查询、条件筛选等服务
- 配置 MyBatis XML 映射文件，完成数据库操作配置

ruoyi-modules/ruoyi-game-event/src/main/java/org/dromara/system/controller/GameScoreDetailController.java

@@ -0,0 +1,105 @@
+package org.dromara.system.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.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.system.domain.vo.GameScoreDetailVo;
+import org.dromara.system.domain.bo.GameScoreDetailBo;
+import org.dromara.system.service.IGameScoreDetailService;
+import org.dromara.common.mybatis.core.page.TableDataInfo;
+
+/**
+ * 成绩明细
+ *
+ * @author z
+ * @date 2026-05-08
+ */
+@Validated
+@RequiredArgsConstructor
+@RestController
+@RequestMapping("/system/scoreDetail")
+public class GameScoreDetailController extends BaseController {
+
+    private final IGameScoreDetailService gameScoreDetailService;
+
+    /**
+     * 查询成绩明细列表
+     */
+    @SaCheckPermission("system:scoreDetail:list")
+    @GetMapping("/list")
+    public TableDataInfo<GameScoreDetailVo> list(GameScoreDetailBo bo, PageQuery pageQuery) {
+        return gameScoreDetailService.queryPageList(bo, pageQuery);
+    }
+
+    /**
+     * 导出成绩明细列表
+     */
+    @SaCheckPermission("system:scoreDetail:export")
+    @Log(title = "成绩明细", businessType = BusinessType.EXPORT)
+    @PostMapping("/export")
+    public void export(GameScoreDetailBo bo, HttpServletResponse response) {
+        List<GameScoreDetailVo> list = gameScoreDetailService.queryList(bo);
+        ExcelUtil.exportExcel(list, "成绩明细", GameScoreDetailVo.class, response);
+    }
+
+    /**
+     * 获取成绩明细详细信息
+     *
+     * @param detailId 主键
+     */
+    @SaCheckPermission("system:scoreDetail:query")
+    @GetMapping("/{detailId}")
+    public R<GameScoreDetailVo> getInfo(@NotNull(message = "主键不能为空")
+                                     @PathVariable Long detailId) {
+        return R.ok(gameScoreDetailService.queryById(detailId));
+    }
+
+    /**
+     * 新增成绩明细
+     */
+    @SaCheckPermission("system:scoreDetail:add")
+    @Log(title = "成绩明细", businessType = BusinessType.INSERT)
+    @RepeatSubmit()
+    @PostMapping()
+    public R<Void> add(@Validated(AddGroup.class) @RequestBody GameScoreDetailBo bo) {
+        return toAjax(gameScoreDetailService.insertByBo(bo));
+    }
+
+    /**
+     * 修改成绩明细
+     */
+    @SaCheckPermission("system:scoreDetail:edit")
+    @Log(title = "成绩明细", businessType = BusinessType.UPDATE)
+    @RepeatSubmit()
+    @PutMapping()
+    public R<Void> edit(@Validated(EditGroup.class) @RequestBody GameScoreDetailBo bo) {
+        return toAjax(gameScoreDetailService.updateByBo(bo));
+    }
+
+    /**
+     * 删除成绩明细
+     *
+     * @param detailIds 主键串
+     */
+    @SaCheckPermission("system:scoreDetail:remove")
+    @Log(title = "成绩明细", businessType = BusinessType.DELETE)
+    @DeleteMapping("/{detailIds}")
+    public R<Void> remove(@NotEmpty(message = "主键不能为空")
+                          @PathVariable Long[] detailIds) {
+        return toAjax(gameScoreDetailService.deleteWithValidByIds(List.of(detailIds), true));
+    }
+}

ruoyi-modules/ruoyi-game-event/src/main/java/org/dromara/system/domain/GameScoreDetail.java

@@ -0,0 +1,73 @@
+package org.dromara.system.domain;
+
+import org.dromara.common.tenant.core.TenantEntity;
+import com.baomidou.mybatisplus.annotation.*;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import java.math.BigDecimal;
+
+import java.io.Serial;
+
+/**
+ * 成绩明细对象 game_score_detail
+ *
+ * @author z
+ * @date 2026-05-08
+ */
+@Data
+@EqualsAndHashCode(callSuper = true)
+@TableName("game_score_detail")
+public class GameScoreDetail extends TenantEntity {
+
+    @Serial
+    private static final long serialVersionUID = 1L;
+
+    /**
+     * 明细主键
+     */
+    @TableId(value = "detail_id")
+    private Long detailId;
+
+    /**
+     * 关联主表score_id
+     */
+    private Long scoreId;
+
+    /**
+     * 轮次/尝试序号(如1,2,3表示第1,2,3次)
+     */
+    private Integer attemptIndex;
+
+    /**
+     * 单次原始成绩
+     */
+    private BigDecimal performanceValue;
+
+    /**
+     * 单次失误次数A
+     */
+    private Integer faultA;
+
+    /**
+     * 单次失误次数B
+     */
+    private Integer faultB;
+
+    /**
+     * 是否有效(0有效 1犯规/无效)
+     */
+    private String isValid;
+
+    /**
+     * 单次备注(如：踩线)
+     */
+    private String remark;
+
+    /**
+     * 删除标志（0代表存在 1代表删除）
+     */
+    @TableLogic
+    private String delFlag;
+
+
+}

ruoyi-modules/ruoyi-game-event/src/main/java/org/dromara/system/domain/bo/GameScoreDetailBo.java

@@ -0,0 +1,70 @@
+package org.dromara.system.domain.bo;
+
+import org.dromara.system.domain.GameScoreDetail;
+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.math.BigDecimal;
+
+/**
+ * 成绩明细业务对象 game_score_detail
+ *
+ * @author z
+ * @date 2026-05-08
+ */
+@Data
+@EqualsAndHashCode(callSuper = true)
+@AutoMapper(target = GameScoreDetail.class, reverseConvertGenerate = false)
+public class GameScoreDetailBo extends BaseEntity {
+
+    /**
+     * 明细主键
+     */
+    private Long detailId;
+
+    /**
+     * 关联主表score_id
+     */
+    private Long scoreId;
+
+    /**
+     * 轮次/尝试序号(如1,2,3表示第1,2,3次)
+     */
+    private Integer attemptIndex;
+
+    /**
+     * 单次原始成绩
+     */
+    @NotNull(message = "单次原始成绩不能为空", groups = { AddGroup.class, EditGroup.class })
+    private BigDecimal performanceValue;
+
+    /**
+     * 单次失误次数A
+     */
+    @NotNull(message = "单次失误次数A不能为空", groups = { AddGroup.class, EditGroup.class })
+    private Integer faultA;
+
+    /**
+     * 单次失误次数B
+     */
+    @NotNull(message = "单次失误次数B不能为空", groups = { AddGroup.class, EditGroup.class })
+    private Integer faultB;
+
+    /**
+     * 是否有效(0有效 1犯规/无效)
+     */
+    @NotBlank(message = "是否有效(0有效 1犯规/无效)不能为空", groups = { AddGroup.class, EditGroup.class })
+    private String isValid;
+
+    /**
+     * 单次备注(如：踩线)
+     */
+    @NotBlank(message = "单次备注(如：踩线)不能为空", groups = { AddGroup.class, EditGroup.class })
+    private String remark;
+
+
+}

ruoyi-modules/ruoyi-game-event/src/main/java/org/dromara/system/domain/vo/GameScoreDetailVo.java

@@ -0,0 +1,81 @@
+package org.dromara.system.domain.vo;
+
+import java.math.BigDecimal;
+import org.dromara.system.domain.GameScoreDetail;
+import cn.idev.excel.annotation.ExcelIgnoreUnannotated;
+import cn.idev.excel.annotation.ExcelProperty;
+import org.dromara.common.excel.annotation.ExcelDictFormat;
+import org.dromara.common.excel.convert.ExcelDictConvert;
+import io.github.linpeilie.annotations.AutoMapper;
+import lombok.Data;
+
+import java.io.Serial;
+import java.io.Serializable;
+import java.util.Date;
+
+
+
+/**
+ * 成绩明细视图对象 game_score_detail
+ *
+ * @author z
+ * @date 2026-05-08
+ */
+@Data
+@ExcelIgnoreUnannotated
+@AutoMapper(target = GameScoreDetail.class)
+public class GameScoreDetailVo implements Serializable {
+
+    @Serial
+    private static final long serialVersionUID = 1L;
+
+    /**
+     * 明细主键
+     */
+    @ExcelProperty(value = "明细主键")
+    private Long detailId;
+
+    /**
+     * 关联主表score_id
+     */
+    @ExcelProperty(value = "关联主表score_id")
+    private Long scoreId;
+
+    /**
+     * 轮次/尝试序号(如1,2,3表示第1,2,3次)
+     */
+    @ExcelProperty(value = "轮次/尝试序号(如1,2,3表示第1,2,3次)")
+    private Integer attemptIndex;
+
+    /**
+     * 单次原始成绩
+     */
+    @ExcelProperty(value = "单次原始成绩")
+    private BigDecimal performanceValue;
+
+    /**
+     * 单次失误次数A
+     */
+    @ExcelProperty(value = "单次失误次数A")
+    private Integer faultA;
+
+    /**
+     * 单次失误次数B
+     */
+    @ExcelProperty(value = "单次失误次数B")
+    private Integer faultB;
+
+    /**
+     * 是否有效(0有效 1犯规/无效)
+     */
+    @ExcelProperty(value = "是否有效(0有效 1犯规/无效)")
+    private String isValid;
+
+    /**
+     * 单次备注(如：踩线)
+     */
+    @ExcelProperty(value = "单次备注(如：踩线)")
+    private String remark;
+
+
+}

ruoyi-modules/ruoyi-game-event/src/main/java/org/dromara/system/mapper/GameScoreDetailMapper.java

@@ -0,0 +1,15 @@
+package org.dromara.system.mapper;
+
+import org.dromara.system.domain.GameScoreDetail;
+import org.dromara.system.domain.vo.GameScoreDetailVo;
+import org.dromara.common.mybatis.core.mapper.BaseMapperPlus;
+
+/**
+ * 成绩明细Mapper接口
+ *
+ * @author z
+ * @date 2026-05-08
+ */
+public interface GameScoreDetailMapper extends BaseMapperPlus<GameScoreDetail, GameScoreDetailVo> {
+
+}

ruoyi-modules/ruoyi-game-event/src/main/java/org/dromara/system/service/IGameScoreDetailService.java

@@ -0,0 +1,68 @@
+package org.dromara.system.service;
+
+import org.dromara.system.domain.vo.GameScoreDetailVo;
+import org.dromara.system.domain.bo.GameScoreDetailBo;
+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 z
+ * @date 2026-05-08
+ */
+public interface IGameScoreDetailService {
+
+    /**
+     * 查询成绩明细
+     *
+     * @param detailId 主键
+     * @return 成绩明细
+     */
+    GameScoreDetailVo queryById(Long detailId);
+
+    /**
+     * 分页查询成绩明细列表
+     *
+     * @param bo        查询条件
+     * @param pageQuery 分页参数
+     * @return 成绩明细分页列表
+     */
+    TableDataInfo<GameScoreDetailVo> queryPageList(GameScoreDetailBo bo, PageQuery pageQuery);
+
+    /**
+     * 查询符合条件的成绩明细列表
+     *
+     * @param bo 查询条件
+     * @return 成绩明细列表
+     */
+    List<GameScoreDetailVo> queryList(GameScoreDetailBo bo);
+
+    /**
+     * 新增成绩明细
+     *
+     * @param bo 成绩明细
+     * @return 是否新增成功
+     */
+    Boolean insertByBo(GameScoreDetailBo bo);
+
+    /**
+     * 修改成绩明细
+     *
+     * @param bo 成绩明细
+     * @return 是否修改成功
+     */
+    Boolean updateByBo(GameScoreDetailBo bo);
+
+    /**
+     * 校验并批量删除成绩明细信息
+     *
+     * @param ids     待删除的主键集合
+     * @param isValid 是否进行有效性校验
+     * @return 是否删除成功
+     */
+    Boolean deleteWithValidByIds(Collection<Long> ids, Boolean isValid);
+}

ruoyi-modules/ruoyi-game-event/src/main/java/org/dromara/system/service/impl/GameScoreDetailServiceImpl.java

@@ -0,0 +1,137 @@
+package org.dromara.system.service.impl;
+
+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 org.dromara.system.domain.bo.GameScoreDetailBo;
+import org.dromara.system.domain.vo.GameScoreDetailVo;
+import org.dromara.system.domain.GameScoreDetail;
+import org.dromara.system.mapper.GameScoreDetailMapper;
+import org.dromara.system.service.IGameScoreDetailService;
+
+import java.util.List;
+import java.util.Map;
+import java.util.Collection;
+
+/**
+ * 成绩明细Service业务层处理
+ *
+ * @author z
+ * @date 2026-05-08
+ */
+@Slf4j
+@RequiredArgsConstructor
+@Service
+public class GameScoreDetailServiceImpl implements IGameScoreDetailService {
+
+    private final GameScoreDetailMapper baseMapper;
+
+    /**
+     * 查询成绩明细
+     *
+     * @param detailId 主键
+     * @return 成绩明细
+     */
+    @Override
+    public GameScoreDetailVo queryById(Long detailId){
+        return baseMapper.selectVoById(detailId);
+    }
+
+    /**
+     * 分页查询成绩明细列表
+     *
+     * @param bo        查询条件
+     * @param pageQuery 分页参数
+     * @return 成绩明细分页列表
+     */
+    @Override
+    public TableDataInfo<GameScoreDetailVo> queryPageList(GameScoreDetailBo bo, PageQuery pageQuery) {
+        LambdaQueryWrapper<GameScoreDetail> lqw = buildQueryWrapper(bo);
+        Page<GameScoreDetailVo> result = baseMapper.selectVoPage(pageQuery.build(), lqw);
+        return TableDataInfo.build(result);
+    }
+
+    /**
+     * 查询符合条件的成绩明细列表
+     *
+     * @param bo 查询条件
+     * @return 成绩明细列表
+     */
+    @Override
+    public List<GameScoreDetailVo> queryList(GameScoreDetailBo bo) {
+        LambdaQueryWrapper<GameScoreDetail> lqw = buildQueryWrapper(bo);
+        return baseMapper.selectVoList(lqw);
+    }
+
+    private LambdaQueryWrapper<GameScoreDetail> buildQueryWrapper(GameScoreDetailBo bo) {
+        Map<String, Object> params = bo.getParams();
+        LambdaQueryWrapper<GameScoreDetail> lqw = Wrappers.lambdaQuery();
+        lqw.orderByAsc(GameScoreDetail::getDetailId);
+        lqw.eq(bo.getScoreId() != null, GameScoreDetail::getScoreId, bo.getScoreId());
+        lqw.eq(bo.getAttemptIndex() != null, GameScoreDetail::getAttemptIndex, bo.getAttemptIndex());
+        lqw.eq(bo.getPerformanceValue() != null, GameScoreDetail::getPerformanceValue, bo.getPerformanceValue());
+        lqw.eq(bo.getFaultA() != null, GameScoreDetail::getFaultA, bo.getFaultA());
+        lqw.eq(bo.getFaultB() != null, GameScoreDetail::getFaultB, bo.getFaultB());
+        lqw.eq(StringUtils.isNotBlank(bo.getIsValid()), GameScoreDetail::getIsValid, bo.getIsValid());
+        return lqw;
+    }
+
+    /**
+     * 新增成绩明细
+     *
+     * @param bo 成绩明细
+     * @return 是否新增成功
+     */
+    @Override
+    public Boolean insertByBo(GameScoreDetailBo bo) {
+        GameScoreDetail add = MapstructUtils.convert(bo, GameScoreDetail.class);
+        validEntityBeforeSave(add);
+        boolean flag = baseMapper.insert(add) > 0;
+        if (flag) {
+            bo.setDetailId(add.getDetailId());
+        }
+        return flag;
+    }
+
+    /**
+     * 修改成绩明细
+     *
+     * @param bo 成绩明细
+     * @return 是否修改成功
+     */
+    @Override
+    public Boolean updateByBo(GameScoreDetailBo bo) {
+        GameScoreDetail update = MapstructUtils.convert(bo, GameScoreDetail.class);
+        validEntityBeforeSave(update);
+        return baseMapper.updateById(update) > 0;
+    }
+
+    /**
+     * 保存前的数据校验
+     */
+    private void validEntityBeforeSave(GameScoreDetail 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-game-event/src/main/resources/mapper/system/GameScoreDetailMapper.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.system.mapper.GameScoreDetailMapper">
+
+</mapper>