feat(business): 添加充值商品管理功能

- 新增充值商品相关的数据模型、业务对象、控制器、服务实现和映射文件
- 实现了充值商品的增删查改、分页查询和导出功能
- 集成了道具关联查询和数据校验逻辑

ruoyi-modules/ruoyi-system/src/main/java/org/dromara/business/controller/RechargeProductsController.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.RechargeProductsBo;
+import org.dromara.business.domain.vo.RechargeProductsVo;
+import org.dromara.business.service.IRechargeProductsService;
+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-13
+ */
+@Validated
+@RequiredArgsConstructor
+@RestController
+@RequestMapping("/business/products")
+public class RechargeProductsController extends BaseController {
+
+    private final IRechargeProductsService rechargeProductsService;
+
+    /**
+     * 查询充值商品列表
+     */
+    @SaCheckPermission("business:products:list")
+    @GetMapping("/list")
+    public TableDataInfo<RechargeProductsVo> list(RechargeProductsBo bo, PageQuery pageQuery) {
+        return rechargeProductsService.queryPageList(bo, pageQuery);
+    }
+
+    /**
+     * 导出充值商品列表
+     */
+    @SaCheckPermission("business:products:export")
+    @Log(title = "充值商品", businessType = BusinessType.EXPORT)
+    @PostMapping("/export")
+    public void export(RechargeProductsBo bo, HttpServletResponse response) {
+        List<RechargeProductsVo> list = rechargeProductsService.queryList(bo);
+        ExcelUtil.exportExcel(list, "充值商品", RechargeProductsVo.class, response);
+    }
+
+    /**
+     * 获取充值商品详细信息
+     *
+     * @param id 主键
+     */
+    @SaCheckPermission("business:products:query")
+    @GetMapping("/{id}")
+    public R<RechargeProductsVo> getInfo(@NotNull(message = "主键不能为空")
+                                     @PathVariable Long id) {
+        return R.ok(rechargeProductsService.queryById(id));
+    }
+
+    /**
+     * 新增充值商品
+     */
+    @SaCheckPermission("business:products:add")
+    @Log(title = "充值商品", businessType = BusinessType.INSERT)
+    @RepeatSubmit()
+    @PostMapping()
+    public R<Void> add(@Validated(AddGroup.class) @RequestBody RechargeProductsBo bo) {
+        return toAjax(rechargeProductsService.insertByBo(bo));
+    }
+
+    /**
+     * 修改充值商品
+     */
+    @SaCheckPermission("business:products:edit")
+    @Log(title = "充值商品", businessType = BusinessType.UPDATE)
+    @RepeatSubmit()
+    @PutMapping()
+    public R<Void> edit(@Validated(EditGroup.class) @RequestBody RechargeProductsBo bo) {
+        return toAjax(rechargeProductsService.updateByBo(bo));
+    }
+
+    /**
+     * 删除充值商品
+     *
+     * @param ids 主键串
+     */
+    @SaCheckPermission("business:products:remove")
+    @Log(title = "充值商品", businessType = BusinessType.DELETE)
+    @DeleteMapping("/{ids}")
+    public R<Void> remove(@NotEmpty(message = "主键不能为空")
+                          @PathVariable Long[] ids) {
+        return toAjax(rechargeProductsService.deleteWithValidByIds(List.of(ids), true));
+    }
+
+}

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

@@ -0,0 +1,63 @@
+package org.dromara.business.domain;
+
+import com.baomidou.mybatisplus.annotation.*;
+import lombok.Data;
+import java.util.Date;
+import java.io.Serial;
+
+/**
+ * 充值商品对象 recharge_products
+ *
+ * @author Lion Li
+ * @date 2025-08-13
+ */
+@Data
+@TableName("recharge_products")
+public class RechargeProducts {
+
+    @Serial
+    private static final long serialVersionUID = 1L;
+
+    /**
+     * 主键ID
+     */
+    @TableId(value = "id")
+    private Long id;
+
+    /**
+     * 充值商品名
+     */
+    private String productName;
+
+    /**
+     * 价格
+     */
+    private Long productPrice;
+
+    /**
+     * 说明
+     */
+    private String description;
+
+    /**
+     * 关联道具
+     */
+    private String relatedItemId;
+
+    /**
+     * 道具值
+     */
+    private Long quantity;
+
+    /**
+     * 创建时间
+     */
+    private Date createdAt;
+
+    /**
+     * 更新时间
+     */
+    private Date updatedAt;
+
+
+}

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

@@ -0,0 +1,69 @@
+package org.dromara.business.domain.bo;
+
+import org.dromara.business.domain.RechargeProducts;
+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;
+
+/**
+ * 充值商品业务对象 recharge_products
+ *
+ * @author Lion Li
+ * @date 2025-08-13
+ */
+@Data
+@EqualsAndHashCode(callSuper = true)
+@AutoMapper(target = RechargeProducts.class, reverseConvertGenerate = false)
+public class RechargeProductsBo extends BaseEntity {
+
+    /**
+     * 主键ID
+     */
+    @NotNull(message = "主键ID不能为空", groups = { EditGroup.class })
+    private Long id;
+
+    /**
+     * 充值商品名
+     */
+    @NotBlank(message = "充值商品名不能为空", groups = { AddGroup.class, EditGroup.class })
+    private String productName;
+
+    /**
+     * 价格
+     */
+    @NotNull(message = "价格不能为空", groups = { AddGroup.class, EditGroup.class })
+    private Long productPrice;
+
+    /**
+     * 说明
+     */
+    private String description;
+
+    /**
+     * 关联道具
+     */
+    private String relatedItemId;
+
+    /**
+     * 道具值
+     */
+    @NotNull(message = "道具值不能为空", groups = { AddGroup.class, EditGroup.class })
+    private Long quantity;
+
+    /**
+     * 创建时间
+     */
+    private Date createdAt;
+
+    /**
+     * 更新时间
+     */
+    private Date updatedAt;
+
+
+}

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

@@ -0,0 +1,83 @@
+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.RechargeProducts;
+
+import java.io.Serial;
+import java.io.Serializable;
+
+
+
+
+/**
+ * 充值商品视图对象 recharge_products
+ *
+ * @author Lion Li
+ * @date 2025-08-13
+ */
+@Data
+@ExcelIgnoreUnannotated
+@AutoMapper(target = RechargeProducts.class)
+public class RechargeProductsVo implements Serializable {
+
+    @Serial
+    private static final long serialVersionUID = 1L;
+
+    /**
+     * 主键ID
+     */
+    @ExcelProperty(value = "主键ID")
+    private Long id;
+
+    /**
+     * 充值商品名
+     */
+    @ExcelProperty(value = "充值商品名")
+    private String productName;
+
+    /**
+     * 价格
+     */
+    @ExcelProperty(value = "价格")
+    private Long productPrice;
+
+    /**
+     * 说明
+     */
+    @ExcelProperty(value = "说明")
+    private String description;
+
+    /**
+     * 关联道具
+     */
+    @ExcelProperty(value = "关联道具")
+    private String relatedItemId;
+
+    /**
+     * 道具值
+     */
+    @ExcelProperty(value = "道具值")
+    private Long quantity;
+
+    /**
+     * 创建时间
+     */
+    @ExcelProperty(value = "创建时间")
+    private Date createdAt;
+
+    /**
+     * 更新时间
+     */
+    @ExcelProperty(value = "更新时间")
+    private Date updatedAt;
+
+    /**
+     * 道具名称
+     */
+    private String itemsName;
+
+}

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

@@ -0,0 +1,45 @@
+package org.dromara.business.mapper;
+
+import com.baomidou.dynamic.datasource.annotation.DS;
+import com.baomidou.mybatisplus.annotation.InterceptorIgnore;
+import com.baomidou.mybatisplus.core.conditions.Wrapper;
+import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
+import org.apache.ibatis.annotations.Param;
+import org.dromara.business.domain.RechargeProducts;
+import org.dromara.business.domain.vo.RechargeProductsVo;
+import org.dromara.common.mybatis.core.mapper.BaseMapperPlus;
+
+import java.util.Collection;
+import java.util.List;
+
+/**
+ * 充值商品Mapper接口
+ *
+ * @author Lion Li
+ * @date 2025-08-13
+ */
+@DS("mysql2")
+public interface RechargeProductsMapper extends BaseMapperPlus<RechargeProducts, RechargeProductsVo> {
+
+    @InterceptorIgnore(tenantLine = "true")
+    Page<RechargeProductsVo> selectRechargeProductsAll(@Param("page") Page<RechargeProducts> page, @Param("ew") Wrapper<RechargeProducts> wrapper);
+
+    @InterceptorIgnore(tenantLine = "true")
+    int insertRechargeProducts(RechargeProducts rechargeProducts);
+
+    @InterceptorIgnore(tenantLine = "true")
+    int updateRechargeProducts(RechargeProducts rechargeProducts);
+
+    @InterceptorIgnore(tenantLine = "true")
+    int deleteRechargeProductsById(@Param("ids") Collection<Long> ids);
+
+    @InterceptorIgnore(tenantLine = "true")
+    RechargeProductsVo selectRechargeProductsById(Long id);
+
+
+    @InterceptorIgnore(tenantLine = "true")
+    List<RechargeProductsVo> selectExportRechargeProductsAll(@Param("ew") Wrapper<RechargeProducts> wrapper);
+
+
+
+}

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

@@ -0,0 +1,68 @@
+package org.dromara.business.service;
+
+import org.dromara.business.domain.bo.RechargeProductsBo;
+import org.dromara.business.domain.vo.RechargeProductsVo;
+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-13
+ */
+public interface IRechargeProductsService {
+
+    /**
+     * 查询充值商品
+     *
+     * @param id 主键
+     * @return 充值商品
+     */
+    RechargeProductsVo queryById(Long id);
+
+    /**
+     * 分页查询充值商品列表
+     *
+     * @param bo        查询条件
+     * @param pageQuery 分页参数
+     * @return 充值商品分页列表
+     */
+    TableDataInfo<RechargeProductsVo> queryPageList(RechargeProductsBo bo, PageQuery pageQuery);
+
+    /**
+     * 查询符合条件的充值商品列表
+     *
+     * @param bo 查询条件
+     * @return 充值商品列表
+     */
+    List<RechargeProductsVo> queryList(RechargeProductsBo bo);
+
+    /**
+     * 新增充值商品
+     *
+     * @param bo 充值商品
+     * @return 是否新增成功
+     */
+    Boolean insertByBo(RechargeProductsBo bo);
+
+    /**
+     * 修改充值商品
+     *
+     * @param bo 充值商品
+     * @return 是否修改成功
+     */
+    Boolean updateByBo(RechargeProductsBo 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/RechargeProductsServiceImpl.java

@@ -0,0 +1,147 @@
+package org.dromara.business.service.impl;
+
+import org.dromara.business.domain.RechargeProducts;
+import org.dromara.business.domain.bo.RechargeProductsBo;
+import org.dromara.business.domain.vo.ItemsVo;
+import org.dromara.business.domain.vo.RechargeProductsVo;
+import org.dromara.business.mapper.ItemsMapper;
+import org.dromara.business.mapper.RechargeProductsMapper;
+import org.dromara.business.service.IRechargeProductsService;
+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.List;
+import java.util.Map;
+import java.util.Collection;
+
+/**
+ * 充值商品Service业务层处理
+ *
+ * @author Lion Li
+ * @date 2025-08-13
+ */
+@Slf4j
+@RequiredArgsConstructor
+@Service
+public class RechargeProductsServiceImpl implements IRechargeProductsService {
+
+    private final RechargeProductsMapper baseMapper;
+
+    private final ItemsMapper itemsMapper;
+
+    /**
+     * 查询充值商品
+     *
+     * @param id 主键
+     * @return 充值商品
+     */
+    @Override
+    public RechargeProductsVo queryById(Long id){
+        return baseMapper.selectRechargeProductsById(id);
+    }
+
+    /**
+     * 分页查询充值商品列表
+     *
+     * @param bo        查询条件
+     * @param pageQuery 分页参数
+     * @return 充值商品分页列表
+     */
+    @Override
+    public TableDataInfo<RechargeProductsVo> queryPageList(RechargeProductsBo bo, PageQuery pageQuery) {
+        LambdaQueryWrapper<RechargeProducts> lqw = buildQueryWrapper(bo);
+        Page<RechargeProductsVo> result = baseMapper.selectRechargeProductsAll(pageQuery.build(), lqw);
+        List<RechargeProductsVo> rechargeProductsVos = result.getRecords();
+        for (RechargeProductsVo record : rechargeProductsVos) {
+            ItemsVo itemsVo = itemsMapper.selectVoByIdInfo(Long.valueOf(record.getRelatedItemId()));
+            record.setItemsName(itemsVo.getName());
+        }
+        return TableDataInfo.build(result);
+    }
+
+    /**
+     * 查询符合条件的充值商品列表
+     *
+     * @param bo 查询条件
+     * @return 充值商品列表
+     */
+    @Override
+    public List<RechargeProductsVo> queryList(RechargeProductsBo bo) {
+        LambdaQueryWrapper<RechargeProducts> lqw = buildQueryWrapper(bo);
+        return baseMapper.selectExportRechargeProductsAll(lqw);
+    }
+
+    private LambdaQueryWrapper<RechargeProducts> buildQueryWrapper(RechargeProductsBo bo) {
+        Map<String, Object> params = bo.getParams();
+        LambdaQueryWrapper<RechargeProducts> lqw = Wrappers.lambdaQuery();
+        lqw.orderByAsc(RechargeProducts::getId);
+        lqw.like(StringUtils.isNotBlank(bo.getProductName()), RechargeProducts::getProductName, bo.getProductName());
+        lqw.eq(bo.getProductPrice() != null, RechargeProducts::getProductPrice, bo.getProductPrice());
+        lqw.eq(StringUtils.isNotBlank(bo.getDescription()), RechargeProducts::getDescription, bo.getDescription());
+        lqw.eq(StringUtils.isNotBlank(bo.getRelatedItemId()), RechargeProducts::getRelatedItemId, bo.getRelatedItemId());
+        lqw.eq(bo.getQuantity() != null, RechargeProducts::getQuantity, bo.getQuantity());
+        lqw.eq(bo.getCreatedAt() != null, RechargeProducts::getCreatedAt, bo.getCreatedAt());
+        lqw.eq(bo.getUpdatedAt() != null, RechargeProducts::getUpdatedAt, bo.getUpdatedAt());
+        return lqw;
+    }
+
+    /**
+     * 新增充值商品
+     *
+     * @param bo 充值商品
+     * @return 是否新增成功
+     */
+    @Override
+    public Boolean insertByBo(RechargeProductsBo bo) {
+        RechargeProducts add = MapstructUtils.convert(bo, RechargeProducts.class);
+        validEntityBeforeSave(add);
+        boolean flag = baseMapper.insertRechargeProducts(add) > 0;
+        if (flag) {
+            bo.setId(add.getId());
+        }
+        return flag;
+    }
+
+    /**
+     * 修改充值商品
+     *
+     * @param bo 充值商品
+     * @return 是否修改成功
+     */
+    @Override
+    public Boolean updateByBo(RechargeProductsBo bo) {
+        RechargeProducts update = MapstructUtils.convert(bo, RechargeProducts.class);
+        validEntityBeforeSave(update);
+        return baseMapper.updateRechargeProducts(update) > 0;
+    }
+
+    /**
+     * 保存前的数据校验
+     */
+    private void validEntityBeforeSave(RechargeProducts entity){
+        //TODO 做一些数据校验,如唯一约束
+    }
+
+    /**
+     * 校验并批量删除充值商品信息
+     *
+     * @param ids     待删除的主键集合
+     * @param isValid 是否进行有效性校验
+     * @return 是否删除成功
+     */
+    @Override
+    public Boolean deleteWithValidByIds(Collection<Long> ids, Boolean isValid) {
+        if(isValid){
+            //TODO 做一些业务上的校验,判断是否需要校验
+        }
+        return baseMapper.deleteRechargeProductsById(ids) > 0;
+    }
+}

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

@@ -0,0 +1,94 @@
+<?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.RechargeProductsMapper">
+
+
+    <insert id="insertRechargeProducts" useGeneratedKeys="true" keyProperty="id">
+        INSERT INTO recharge_products
+        <trim prefix="(" suffix=")" suffixOverrides=",">
+            <if test="productName != null">product_name,</if>
+            <if test="productPrice != null">product_price,</if>
+            <if test="description != null">description,</if>
+            <if test="relatedItemId != null">related_item_id,</if>
+            <if test="quantity != null">quantity,</if>
+        </trim>
+        <trim prefix="VALUES (" suffix=")" suffixOverrides=",">
+            <if test="productName != null">#{productName},</if>
+            <if test="productPrice != null">#{productPrice},</if>
+            <if test="description != null">#{description},</if>
+            <if test="relatedItemId != null">#{relatedItemId},</if>
+            <if test="quantity != null">#{quantity},</if>
+        </trim>
+    </insert>
+
+    <update id="updateRechargeProducts">
+        UPDATE recharge_products
+        <set>
+            <if test="productName != null">product_name = #{productName},</if>
+            <if test="productPrice != null">product_price = #{productPrice},</if>
+            <if test="description != null">description = #{description},</if>
+            <if test="relatedItemId != null">related_item_id = #{relatedItemId},</if>
+            <if test="quantity != null">quantity = #{quantity},</if>
+        </set>
+        WHERE id = #{id}
+    </update>
+
+
+    <select id="selectRechargeProductsById" resultType="org.dromara.business.domain.vo.RechargeProductsVo">
+        SELECT
+            id,
+            product_name,
+            product_price,
+            description,
+            related_item_id,
+            quantity,
+            created_at,
+            updated_at
+        FROM recharge_products
+        WHERE id = #{id}
+    </select>
+
+    <select id="selectRechargeProductsAll" resultType="org.dromara.business.domain.vo.RechargeProductsVo">
+        SELECT
+            id,
+            product_name,
+            product_price,
+            description,
+            related_item_id,
+            quantity,
+            created_at,
+            updated_at
+        FROM recharge_products ${ew.customSqlSegment}
+    </select>
+
+
+    <select id="selectExportRechargeProductsAll" resultType="org.dromara.business.domain.vo.RechargeProductsVo">
+        SELECT
+            id,
+            product_name,
+            product_price,
+            description,
+            related_item_id,
+            quantity,
+            created_at,
+            updated_at
+        FROM recharge_products
+    </select>
+
+
+
+    <delete id="deleteRechargeProductsById">
+        DELETE FROM recharge_products
+        <where>
+            id IN
+            <foreach item="id" collection="ids" open="(" separator="," close=")">
+                <if test="id > 0">
+                    #{id}
+                </if>
+            </foreach>
+        </where>
+    </delete>
+
+</mapper>