feat(mall): 添加mini装修页面模版功能

- 创建MallDiyMiniTemplatePage实体类定义数据库映射结构
- 实现IMallDiyMiniTemplatePageService接口提供业务方法
- 开发MallDiyMiniTemplatePageServiceImpl实现类处理业务逻辑
- 构建MallDiyMiniTemplatePageController控制器提供REST API
- 设计MallDiyMiniTemplatePageBo业务对象处理数据传输
- 创建MallDiyMiniTemplatePageVo视图对象用于数据展示
- 集成MallDiyMiniTemplatePageMapper数据访问层
- 添加XML映射文件支持MyBatis操作
- 实现分页查询、新增、修改、删除等基础CRUD功能

ruoyi-modules/ruoyi-mall/src/main/java/org/dromara/mall/controller/MallDiyMiniTemplatePageController.java

@@ -0,0 +1,103 @@
+package org.dromara.mall.controller;
+
+import jakarta.servlet.http.HttpServletResponse;
+import jakarta.validation.constraints.NotEmpty;
+import jakarta.validation.constraints.NotNull;
+import lombok.RequiredArgsConstructor;
+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.excel.utils.ExcelUtil;
+import org.dromara.common.idempotent.annotation.RepeatSubmit;
+import org.dromara.common.log.annotation.Log;
+import org.dromara.common.log.enums.BusinessType;
+import org.dromara.common.mybatis.core.page.PageQuery;
+import org.dromara.common.mybatis.core.page.TableDataInfo;
+import org.dromara.common.web.core.BaseController;
+import org.dromara.mall.domain.bo.MallDiyMiniTemplatePageBo;
+import org.dromara.mall.domain.bo.MallDiyPcTemplatePageBo;
+import org.dromara.mall.domain.vo.MallDiyMiniTemplatePageVo;
+import org.dromara.mall.domain.vo.MallDiyPcTemplatePageVo;
+import org.dromara.mall.service.IMallDiyMiniTemplatePageService;
+import org.dromara.mall.service.IMallDiyPcTemplatePageService;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.*;
+
+import java.util.List;
+
+/**
+ * mini装修页面模版
+ * 前端访问路由地址为:/mall/diyMiniTemplatePage
+ *
+ * @author LionLi
+ * @date 2026-03-07
+ */
+@Validated
+@RequiredArgsConstructor
+@RestController
+@RequestMapping("/diyMiniTemplatePage")
+public class MallDiyMiniTemplatePageController extends BaseController {
+
+    private final IMallDiyMiniTemplatePageService mallDiyMiniTemplatePageService;
+
+    /**
+     * 查询mini装修页面模版列表
+     */
+    @GetMapping("/list")
+    public TableDataInfo<MallDiyMiniTemplatePageVo> list(MallDiyMiniTemplatePageBo bo, PageQuery pageQuery) {
+        return mallDiyMiniTemplatePageService.queryPageList(bo, pageQuery);
+    }
+
+    /**
+     * 导出mini装修页面模版列表
+     */
+    @Log(title = "mini装修页面模版", businessType = BusinessType.EXPORT)
+    @PostMapping("/export")
+    public void export(MallDiyMiniTemplatePageBo bo, HttpServletResponse response) {
+        List<MallDiyMiniTemplatePageVo> list = mallDiyMiniTemplatePageService.queryList(bo);
+        ExcelUtil.exportExcel(list, "mini装修页面模版", MallDiyMiniTemplatePageVo.class, response);
+    }
+
+    /**
+     * 获取mini装修页面模版详细信息
+     *
+     * @param id 主键
+     */
+    @GetMapping("/{id}")
+    public R<MallDiyMiniTemplatePageVo> getInfo(@NotNull(message = "主键不能为空")
+                                                @PathVariable("id") Long id) {
+        return R.ok(mallDiyMiniTemplatePageService.queryById(id));
+    }
+
+    /**
+     * 新增mini装修页面模版
+     */
+    @Log(title = "mini装修页面模版", businessType = BusinessType.INSERT)
+    @RepeatSubmit()
+    @PostMapping()
+    public R<Void> add(@Validated(AddGroup.class) @RequestBody MallDiyMiniTemplatePageBo bo) {
+        return toAjax(mallDiyMiniTemplatePageService.insertByBo(bo));
+    }
+
+    /**
+     * 修改mini装修页面模版
+     */
+    @Log(title = "mini装修页面模版", businessType = BusinessType.UPDATE)
+    @RepeatSubmit()
+    @PutMapping()
+    public R<Void> edit(@Validated(EditGroup.class) @RequestBody MallDiyMiniTemplatePageBo bo) {
+        return toAjax(mallDiyMiniTemplatePageService.updateByBo(bo));
+    }
+
+    /**
+     * 删除mini装修页面模版
+     *
+     * @param ids 主键串
+     */
+    @Log(title = "mini装修页面模版", businessType = BusinessType.DELETE)
+    @DeleteMapping("/{ids}")
+    public R<Void> remove(@NotEmpty(message = "主键不能为空")
+                          @PathVariable("ids") Long[] ids) {
+        return toAjax(mallDiyMiniTemplatePageService.deleteWithValidByIds(List.of(ids), true));
+    }
+}

ruoyi-modules/ruoyi-mall/src/main/java/org/dromara/mall/domain/MallDiyMiniTemplatePage.java

@@ -0,0 +1,72 @@
+package org.dromara.mall.domain;
+
+import com.baomidou.mybatisplus.annotation.TableId;
+import com.baomidou.mybatisplus.annotation.TableName;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import org.dromara.common.tenant.core.TenantEntity;
+
+import java.io.Serial;
+
+/**
+ * pc装修页面模版对象 mall_diy_pc_template_page
+ *
+ * @author LionLi
+ * @date 2026-03-07
+ */
+@Data
+@EqualsAndHashCode(callSuper = true)
+@TableName("mall_diy_mini_template_page")
+public class MallDiyMiniTemplatePage extends TenantEntity {
+
+    @Serial
+    private static final long serialVersionUID = 1L;
+
+    /**
+     * 装修页面编号
+     */
+    @TableId(value = "id")
+    private Long id;
+
+    /**
+     * 页面名称
+     */
+    private String name;
+
+    /**
+     * 站点id
+     */
+    private Long siteId;
+
+    /**
+     * 客户id
+     */
+    private Long clientId;
+
+    /**
+     * 页面类型 1首页 2个人中心 3商品详情
+     */
+    private String type;
+
+    /**
+     * 备注
+     */
+    private String remark;
+
+    /**
+     * 预览图，多个逗号分隔
+     */
+    private String previewPicUrls;
+
+    /**
+     * 页面属性，JSON 格式
+     */
+    private String property;
+
+    /**
+     * 是否首页
+     */
+    private Long isHome;
+
+
+}

ruoyi-modules/ruoyi-mall/src/main/java/org/dromara/mall/domain/bo/MallDiyMiniTemplatePageBo.java

@@ -0,0 +1,67 @@
+package org.dromara.mall.domain.bo;
+
+import io.github.linpeilie.annotations.AutoMapper;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import org.dromara.common.mybatis.core.domain.BaseEntity;
+import org.dromara.mall.domain.MallDiyMiniTemplatePage;
+import org.dromara.mall.domain.MallDiyPcTemplatePage;
+
+/**
+ * pc装修页面模版业务对象 mall_diy_pc_template_page
+ *
+ * @author LionLi
+ * @date 2026-03-07
+ */
+@Data
+@EqualsAndHashCode(callSuper = true)
+@AutoMapper(target = MallDiyMiniTemplatePage.class, reverseConvertGenerate = false)
+public class MallDiyMiniTemplatePageBo extends BaseEntity {
+
+    /**
+     * 装修页面编号
+     */
+    private Long id;
+
+    /**
+     * 页面名称
+     */
+    private String name;
+
+    /**
+     * 站点id
+     */
+    private Long siteId;
+
+    /**
+     * 客户id
+     */
+    private Long clientId;
+
+    /**
+     * 页面类型 1首页 2个人中心 3商品详情
+     */
+    private String type;
+
+    /**
+     * 备注
+     */
+    private String remark;
+
+    /**
+     * 预览图，多个逗号分隔
+     */
+    private String previewPicUrls;
+
+    /**
+     * 页面属性，JSON 格式
+     */
+    private String property;
+
+    /**
+     * 是否首页
+     */
+    private Long isHome;
+
+
+}

ruoyi-modules/ruoyi-mall/src/main/java/org/dromara/mall/domain/vo/MallDiyMiniTemplatePageVo.java

@@ -0,0 +1,83 @@
+package org.dromara.mall.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.mall.domain.MallDiyMiniTemplatePage;
+import org.dromara.mall.domain.MallDiyPcTemplatePage;
+
+import java.io.Serial;
+import java.io.Serializable;
+
+
+/**
+ * pc装修页面模版视图对象 mall_diy_mini_template_page
+ *
+ * @author LionLi
+ * @date 2026-03-07
+ */
+@Data
+@ExcelIgnoreUnannotated
+@AutoMapper(target = MallDiyMiniTemplatePage.class)
+public class MallDiyMiniTemplatePageVo implements Serializable {
+
+    @Serial
+    private static final long serialVersionUID = 1L;
+
+    /**
+     * 装修页面编号
+     */
+    @ExcelProperty(value = "装修页面编号")
+    private Long id;
+
+    /**
+     * 页面名称
+     */
+    @ExcelProperty(value = "页面名称")
+    private String name;
+
+    /**
+     * 站点id
+     */
+    @ExcelProperty(value = "站点id")
+    private Long siteId;
+
+    /**
+     * 客户id
+     */
+    @ExcelProperty(value = "客户id")
+    private Long clientId;
+
+    /**
+     * 页面类型 1首页 2个人中心 3商品详情
+     */
+    @ExcelProperty(value = "页面类型 1首页 2个人中心 3商品详情")
+    private String type;
+
+    /**
+     * 备注
+     */
+    @ExcelProperty(value = "备注")
+    private String remark;
+
+    /**
+     * 预览图，多个逗号分隔
+     */
+    @ExcelProperty(value = "预览图，多个逗号分隔")
+    private String previewPicUrls;
+
+    /**
+     * 页面属性，JSON 格式
+     */
+    @ExcelProperty(value = "页面属性，JSON 格式")
+    private String property;
+
+    /**
+     * 是否首页
+     */
+    @ExcelProperty(value = "是否首页")
+    private Long isHome;
+
+
+}

ruoyi-modules/ruoyi-mall/src/main/java/org/dromara/mall/mapper/MallDiyMiniTemplatePageMapper.java

@@ -0,0 +1,17 @@
+package org.dromara.mall.mapper;
+
+import org.dromara.common.mybatis.core.mapper.BaseMapperPlus;
+import org.dromara.mall.domain.MallDiyMiniTemplatePage;
+import org.dromara.mall.domain.MallDiyPcTemplatePage;
+import org.dromara.mall.domain.vo.MallDiyMiniTemplatePageVo;
+import org.dromara.mall.domain.vo.MallDiyPcTemplatePageVo;
+
+/**
+ * pc装修页面模版Mapper接口
+ *
+ * @author LionLi
+ * @date 2026-03-07
+ */
+public interface MallDiyMiniTemplatePageMapper extends BaseMapperPlus<MallDiyMiniTemplatePage, MallDiyMiniTemplatePageVo> {
+
+}

ruoyi-modules/ruoyi-mall/src/main/java/org/dromara/mall/service/IMallDiyMiniTemplatePageService.java

@@ -0,0 +1,72 @@
+package org.dromara.mall.service;
+
+import com.baomidou.mybatisplus.extension.service.IService;
+import org.dromara.common.mybatis.core.page.PageQuery;
+import org.dromara.common.mybatis.core.page.TableDataInfo;
+import org.dromara.mall.domain.MallDiyMiniTemplatePage;
+import org.dromara.mall.domain.bo.MallDiyMiniTemplatePageBo;
+import org.dromara.mall.domain.bo.MallDiyPcTemplatePageBo;
+import org.dromara.mall.domain.vo.MallDiyMiniTemplatePageVo;
+import org.dromara.mall.domain.vo.MallDiyPcTemplatePageVo;
+
+import java.util.Collection;
+import java.util.List;
+
+/**
+ * pc装修页面模版Service接口
+ *
+ * @author LionLi
+ * @date 2026-03-07
+ */
+public interface IMallDiyMiniTemplatePageService extends IService<MallDiyMiniTemplatePage> {
+
+    /**
+     * 查询mini装修页面模版
+     *
+     * @param id 主键
+     * @return pc装修页面模版
+     */
+    MallDiyMiniTemplatePageVo queryById(Long id);
+
+    /**
+     * 分页查询mini装修页面模版列表
+     *
+     * @param bo        查询条件
+     * @param pageQuery 分页参数
+     * @return pc装修页面模版分页列表
+     */
+    TableDataInfo<MallDiyMiniTemplatePageVo> queryPageList(MallDiyMiniTemplatePageBo bo, PageQuery pageQuery);
+
+    /**
+     * 查询符合条件的mini装修页面模版列表
+     *
+     * @param bo 查询条件
+     * @return pc装修页面模版列表
+     */
+    List<MallDiyMiniTemplatePageVo> queryList(MallDiyMiniTemplatePageBo bo);
+
+    /**
+     * 新增mini装修页面模版
+     *
+     * @param bo mini装修页面模版
+     * @return 是否新增成功
+     */
+    Boolean insertByBo(MallDiyMiniTemplatePageBo bo);
+
+    /**
+     * 修改mini装修页面模版
+     *
+     * @param bo mini装修页面模版
+     * @return 是否修改成功
+     */
+    Boolean updateByBo(MallDiyMiniTemplatePageBo bo);
+
+    /**
+     * 校验并批量删除mini装修页面模版信息
+     *
+     * @param ids     待删除的主键集合
+     * @param isValid 是否进行有效性校验
+     * @return 是否删除成功
+     */
+    Boolean deleteWithValidByIds(Collection<Long> ids, Boolean isValid);
+}

ruoyi-modules/ruoyi-mall/src/main/java/org/dromara/mall/service/impl/MallDiyMiniTemplatePageServiceImpl.java

@@ -0,0 +1,144 @@
+package org.dromara.mall.service.impl;
+
+import com.baomidou.mybatisplus.core.conditions.query.LambdaQueryWrapper;
+import com.baomidou.mybatisplus.core.toolkit.Wrappers;
+import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
+import com.baomidou.mybatisplus.extension.service.impl.ServiceImpl;
+import lombok.RequiredArgsConstructor;
+import lombok.extern.slf4j.Slf4j;
+import org.dromara.common.core.utils.MapstructUtils;
+import org.dromara.common.core.utils.StringUtils;
+import org.dromara.common.mybatis.core.page.PageQuery;
+import org.dromara.common.mybatis.core.page.TableDataInfo;
+import org.dromara.mall.domain.MallDiyMiniTemplatePage;
+import org.dromara.mall.domain.MallDiyPcTemplatePage;
+import org.dromara.mall.domain.bo.MallDiyMiniTemplatePageBo;
+import org.dromara.mall.domain.bo.MallDiyPcTemplatePageBo;
+import org.dromara.mall.domain.vo.MallDiyMiniTemplatePageVo;
+import org.dromara.mall.domain.vo.MallDiyPcTemplatePageVo;
+import org.dromara.mall.mapper.MallDiyMiniTemplatePageMapper;
+import org.dromara.mall.mapper.MallDiyPcTemplatePageMapper;
+import org.dromara.mall.service.IMallDiyMiniTemplatePageService;
+import org.dromara.mall.service.IMallDiyPcTemplatePageService;
+import org.springframework.stereotype.Service;
+
+import java.util.Collection;
+import java.util.List;
+import java.util.Map;
+
+/**
+ * mini装修页面模版Service业务层处理
+ *
+ * @author LionLi
+ * @date 2026-03-07
+ */
+@Slf4j
+@RequiredArgsConstructor
+@Service
+public class MallDiyMiniTemplatePageServiceImpl extends ServiceImpl<MallDiyMiniTemplatePageMapper, MallDiyMiniTemplatePage> implements IMallDiyMiniTemplatePageService {
+
+    private final MallDiyMiniTemplatePageMapper baseMapper;
+
+    /**
+     * 查询mini装修页面模版
+     *
+     * @param id 主键
+     * @return pc装修页面模版
+     */
+    @Override
+    public MallDiyMiniTemplatePageVo queryById(Long id) {
+        return baseMapper.selectVoById(id);
+    }
+
+    /**
+     * 分页查询mini装修页面模版列表
+     *
+     * @param bo        查询条件
+     * @param pageQuery 分页参数
+     * @return pc装修页面模版分页列表
+     */
+    @Override
+    public TableDataInfo<MallDiyMiniTemplatePageVo> queryPageList(MallDiyMiniTemplatePageBo bo, PageQuery pageQuery) {
+        LambdaQueryWrapper<MallDiyMiniTemplatePage> lqw = buildQueryWrapper(bo);
+        Page<MallDiyMiniTemplatePageVo> result = baseMapper.selectVoPage(pageQuery.build(), lqw);
+        return TableDataInfo.build(result);
+    }
+
+    /**
+     * 查询符合条件的mini装修页面模版列表
+     *
+     * @param bo 查询条件
+     * @return mini装修页面模版列表
+     */
+    @Override
+    public List<MallDiyMiniTemplatePageVo> queryList(MallDiyMiniTemplatePageBo bo) {
+        LambdaQueryWrapper<MallDiyMiniTemplatePage> lqw = buildQueryWrapper(bo);
+        return baseMapper.selectVoList(lqw);
+    }
+
+    private LambdaQueryWrapper<MallDiyMiniTemplatePage> buildQueryWrapper(MallDiyMiniTemplatePageBo bo) {
+        Map<String, Object> params = bo.getParams();
+        LambdaQueryWrapper<MallDiyMiniTemplatePage> lqw = Wrappers.lambdaQuery();
+        lqw.orderByAsc(MallDiyMiniTemplatePage::getId);
+        lqw.like(StringUtils.isNotBlank(bo.getName()), MallDiyMiniTemplatePage::getName, bo.getName());
+        lqw.eq(bo.getSiteId() != null, MallDiyMiniTemplatePage::getSiteId, bo.getSiteId());
+        lqw.eq(bo.getClientId() != null, MallDiyMiniTemplatePage::getClientId, bo.getClientId());
+        lqw.eq(StringUtils.isNotBlank(bo.getType()), MallDiyMiniTemplatePage::getType, bo.getType());
+        lqw.eq(StringUtils.isNotBlank(bo.getPreviewPicUrls()), MallDiyMiniTemplatePage::getPreviewPicUrls, bo.getPreviewPicUrls());
+        lqw.eq(StringUtils.isNotBlank(bo.getProperty()), MallDiyMiniTemplatePage::getProperty, bo.getProperty());
+        lqw.eq(bo.getIsHome() != null, MallDiyMiniTemplatePage::getIsHome, bo.getIsHome());
+        return lqw;
+    }
+
+    /**
+     * 新增mini装修页面模版
+     *
+     * @param bo mini装修页面模版
+     * @return 是否新增成功
+     */
+    @Override
+    public Boolean insertByBo(MallDiyMiniTemplatePageBo bo) {
+        MallDiyMiniTemplatePage add = MapstructUtils.convert(bo, MallDiyMiniTemplatePage.class);
+        validEntityBeforeSave(add);
+        boolean flag = baseMapper.insert(add) > 0;
+        if (flag) {
+            bo.setId(add.getId());
+        }
+        return flag;
+    }
+
+    /**
+     * 修改mini装修页面模版
+     *
+     * @param bo pc装修页面模版
+     * @return 是否修改成功
+     */
+    @Override
+    public Boolean updateByBo(MallDiyMiniTemplatePageBo bo) {
+        MallDiyMiniTemplatePage update = MapstructUtils.convert(bo, MallDiyMiniTemplatePage.class);
+        validEntityBeforeSave(update);
+        return baseMapper.updateById(update) > 0;
+    }
+
+    /**
+     * 保存前的数据校验
+     */
+    private void validEntityBeforeSave(MallDiyMiniTemplatePage entity) {
+        //TODO 做一些数据校验,如唯一约束
+    }
+
+    /**
+     * 校验并批量删除mini装修页面模版信息
+     *
+     * @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-mall/src/main/resources/mapper/mall/MallDiyMiniTemplatePageMapper.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.mall.mapper.MallDiyMiniTemplatePageMapper">
+
+</mapper>