feat(wms): 添加奖金模板管理功能

- 创建奖金模板实体类WmsBonusTemplate,包含模板ID、名称、内容等字段
- 定义奖金模板业务对象WmsBonusTemplateBo和视图对象WmsBonusTemplateVo
- 实现IWmsBonusTemplateService接口及WmsBonusTemplateServiceImpl业务逻辑
- 开发WmsBonusTemplateController控制器提供REST API接口
- 配置WmsBonusTemplateMapper数据库映射及XML映射文件
- 实现奖金模板的增删改查、分页查询及Excel导出功能
- 添加数据校验、日志记录和重复提交防护机制
This commit is contained in:
2026-05-08 17:20:54 +08:00
parent d248b0e585
commit 35d5582ada
8 changed files with 428 additions and 0 deletions

View File

@@ -0,0 +1,99 @@
package com.klp.controller;
import java.util.List;
import java.util.Arrays;
import lombok.RequiredArgsConstructor;
import javax.servlet.http.HttpServletResponse;
import javax.validation.constraints.*;
import org.springframework.web.bind.annotation.*;
import org.springframework.validation.annotation.Validated;
import com.klp.common.annotation.RepeatSubmit;
import com.klp.common.annotation.Log;
import com.klp.common.core.controller.BaseController;
import com.klp.common.core.domain.PageQuery;
import com.klp.common.core.domain.R;
import com.klp.common.core.validate.AddGroup;
import com.klp.common.core.validate.EditGroup;
import com.klp.common.enums.BusinessType;
import com.klp.common.utils.poi.ExcelUtil;
import com.klp.domain.vo.WmsBonusTemplateVo;
import com.klp.domain.bo.WmsBonusTemplateBo;
import com.klp.service.IWmsBonusTemplateService;
import com.klp.common.core.page.TableDataInfo;
/**
* 奖金模板
*
* @author klp
* @date 2026-05-08
*/
@Validated
@RequiredArgsConstructor
@RestController
@RequestMapping("/wms/bonusTemplate")
public class WmsBonusTemplateController extends BaseController {
private final IWmsBonusTemplateService iWmsBonusTemplateService;
/**
* 查询奖金模板列表
*/
@GetMapping("/list")
public TableDataInfo<WmsBonusTemplateVo> list(WmsBonusTemplateBo bo, PageQuery pageQuery) {
return iWmsBonusTemplateService.queryPageList(bo, pageQuery);
}
/**
* 导出奖金模板列表
*/
@Log(title = "奖金模板", businessType = BusinessType.EXPORT)
@PostMapping("/export")
public void export(WmsBonusTemplateBo bo, HttpServletResponse response) {
List<WmsBonusTemplateVo> list = iWmsBonusTemplateService.queryList(bo);
ExcelUtil.exportExcel(list, "奖金模板", WmsBonusTemplateVo.class, response);
}
/**
* 获取奖金模板详细信息
*
* @param templateId 主键
*/
@GetMapping("/{templateId}")
public R<WmsBonusTemplateVo> getInfo(@NotNull(message = "主键不能为空")
@PathVariable Long templateId) {
return R.ok(iWmsBonusTemplateService.queryById(templateId));
}
/**
* 新增奖金模板
*/
@Log(title = "奖金模板", businessType = BusinessType.INSERT)
@RepeatSubmit()
@PostMapping()
public R<Void> add(@Validated(AddGroup.class) @RequestBody WmsBonusTemplateBo bo) {
return toAjax(iWmsBonusTemplateService.insertByBo(bo));
}
/**
* 修改奖金模板
*/
@Log(title = "奖金模板", businessType = BusinessType.UPDATE)
@RepeatSubmit()
@PutMapping()
public R<Void> edit(@Validated(EditGroup.class) @RequestBody WmsBonusTemplateBo bo) {
return toAjax(iWmsBonusTemplateService.updateByBo(bo));
}
/**
* 删除奖金模板
*
* @param templateIds 主键串
*/
@Log(title = "奖金模板", businessType = BusinessType.DELETE)
@DeleteMapping("/{templateIds}")
public R<Void> remove(@NotEmpty(message = "主键不能为空")
@PathVariable Long[] templateIds) {
return toAjax(iWmsBonusTemplateService.deleteWithValidByIds(Arrays.asList(templateIds), true));
}
}

View File

@@ -0,0 +1,45 @@
package com.klp.domain;
import com.baomidou.mybatisplus.annotation.*;
import com.klp.common.core.domain.BaseEntity;
import lombok.Data;
import lombok.EqualsAndHashCode;
/**
* 奖金模板对象 wms_bonus_template
*
* @author klp
* @date 2026-05-08
*/
@Data
@EqualsAndHashCode(callSuper = true)
@TableName("wms_bonus_template")
public class WmsBonusTemplate extends BaseEntity {
private static final long serialVersionUID=1L;
/**
* 主键ID
*/
@TableId(value = "template_id")
private Long templateId;
/**
* 模板名称
*/
private String templateName;
/**
* 模板内容
*/
private String templateContent;
/**
* 删除标志0=存在 2=删除)
*/
@TableLogic
private String delFlag;
/**
* 备注
*/
private String remark;
}

View File

@@ -0,0 +1,41 @@
package com.klp.domain.bo;
import com.klp.common.core.domain.BaseEntity;
import lombok.Data;
import lombok.EqualsAndHashCode;
import javax.validation.constraints.*;
/**
* 奖金模板业务对象 wms_bonus_template
*
* @author klp
* @date 2026-05-08
*/
@Data
@EqualsAndHashCode(callSuper = true)
public class WmsBonusTemplateBo extends BaseEntity {
/**
* 主键ID
*/
private Long templateId;
/**
* 模板名称
*/
private String templateName;
/**
* 模板内容
*/
private String templateContent;
/**
* 备注
*/
private String remark;
}

View File

@@ -0,0 +1,48 @@
package com.klp.domain.vo;
import com.alibaba.excel.annotation.ExcelIgnoreUnannotated;
import com.alibaba.excel.annotation.ExcelProperty;
import com.klp.common.annotation.ExcelDictFormat;
import com.klp.common.convert.ExcelDictConvert;
import com.klp.common.core.domain.BaseEntity;
import lombok.Data;
/**
* 奖金模板视图对象 wms_bonus_template
*
* @author klp
* @date 2026-05-08
*/
@Data
@ExcelIgnoreUnannotated
public class WmsBonusTemplateVo extends BaseEntity {
private static final long serialVersionUID = 1L;
/**
* 主键ID
*/
@ExcelProperty(value = "主键ID")
private Long templateId;
/**
* 模板名称
*/
@ExcelProperty(value = "模板名称")
private String templateName;
/**
* 模板内容
*/
@ExcelProperty(value = "模板内容")
private String templateContent;
/**
* 备注
*/
@ExcelProperty(value = "备注")
private String remark;
}

View File

@@ -0,0 +1,15 @@
package com.klp.mapper;
import com.klp.domain.WmsBonusTemplate;
import com.klp.domain.vo.WmsBonusTemplateVo;
import com.klp.common.core.mapper.BaseMapperPlus;
/**
* 奖金模板Mapper接口
*
* @author klp
* @date 2026-05-08
*/
public interface WmsBonusTemplateMapper extends BaseMapperPlus<WmsBonusTemplateMapper, WmsBonusTemplate, WmsBonusTemplateVo> {
}

View File

@@ -0,0 +1,49 @@
package com.klp.service;
import com.klp.domain.WmsBonusTemplate;
import com.klp.domain.vo.WmsBonusTemplateVo;
import com.klp.domain.bo.WmsBonusTemplateBo;
import com.klp.common.core.page.TableDataInfo;
import com.klp.common.core.domain.PageQuery;
import java.util.Collection;
import java.util.List;
/**
* 奖金模板Service接口
*
* @author klp
* @date 2026-05-08
*/
public interface IWmsBonusTemplateService {
/**
* 查询奖金模板
*/
WmsBonusTemplateVo queryById(Long templateId);
/**
* 查询奖金模板列表
*/
TableDataInfo<WmsBonusTemplateVo> queryPageList(WmsBonusTemplateBo bo, PageQuery pageQuery);
/**
* 查询奖金模板列表
*/
List<WmsBonusTemplateVo> queryList(WmsBonusTemplateBo bo);
/**
* 新增奖金模板
*/
Boolean insertByBo(WmsBonusTemplateBo bo);
/**
* 修改奖金模板
*/
Boolean updateByBo(WmsBonusTemplateBo bo);
/**
* 校验并批量删除奖金模板信息
*/
Boolean deleteWithValidByIds(Collection<Long> ids, Boolean isValid);
}

View File

@@ -0,0 +1,111 @@
package com.klp.service.impl;
import cn.hutool.core.bean.BeanUtil;
import com.klp.common.core.page.TableDataInfo;
import com.klp.common.core.domain.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 com.klp.common.utils.StringUtils;
import lombok.RequiredArgsConstructor;
import org.springframework.stereotype.Service;
import com.klp.domain.bo.WmsBonusTemplateBo;
import com.klp.domain.vo.WmsBonusTemplateVo;
import com.klp.domain.WmsBonusTemplate;
import com.klp.mapper.WmsBonusTemplateMapper;
import com.klp.service.IWmsBonusTemplateService;
import java.util.List;
import java.util.Map;
import java.util.Collection;
/**
* 奖金模板Service业务层处理
*
* @author klp
* @date 2026-05-08
*/
@RequiredArgsConstructor
@Service
public class WmsBonusTemplateServiceImpl implements IWmsBonusTemplateService {
private final WmsBonusTemplateMapper baseMapper;
/**
* 查询奖金模板
*/
@Override
public WmsBonusTemplateVo queryById(Long templateId){
return baseMapper.selectVoById(templateId);
}
/**
* 查询奖金模板列表
*/
@Override
public TableDataInfo<WmsBonusTemplateVo> queryPageList(WmsBonusTemplateBo bo, PageQuery pageQuery) {
LambdaQueryWrapper<WmsBonusTemplate> lqw = buildQueryWrapper(bo);
Page<WmsBonusTemplateVo> result = baseMapper.selectVoPage(pageQuery.build(), lqw);
return TableDataInfo.build(result);
}
/**
* 查询奖金模板列表
*/
@Override
public List<WmsBonusTemplateVo> queryList(WmsBonusTemplateBo bo) {
LambdaQueryWrapper<WmsBonusTemplate> lqw = buildQueryWrapper(bo);
return baseMapper.selectVoList(lqw);
}
private LambdaQueryWrapper<WmsBonusTemplate> buildQueryWrapper(WmsBonusTemplateBo bo) {
Map<String, Object> params = bo.getParams();
LambdaQueryWrapper<WmsBonusTemplate> lqw = Wrappers.lambdaQuery();
lqw.like(StringUtils.isNotBlank(bo.getTemplateName()), WmsBonusTemplate::getTemplateName, bo.getTemplateName());
lqw.eq(StringUtils.isNotBlank(bo.getTemplateContent()), WmsBonusTemplate::getTemplateContent, bo.getTemplateContent());
lqw.eq(StringUtils.isNotBlank(bo.getCreateBy()), WmsBonusTemplate::getCreateBy, bo.getCreateBy());
return lqw;
}
/**
* 新增奖金模板
*/
@Override
public Boolean insertByBo(WmsBonusTemplateBo bo) {
WmsBonusTemplate add = BeanUtil.toBean(bo, WmsBonusTemplate.class);
validEntityBeforeSave(add);
boolean flag = baseMapper.insert(add) > 0;
if (flag) {
bo.setTemplateId(add.getTemplateId());
}
return flag;
}
/**
* 修改奖金模板
*/
@Override
public Boolean updateByBo(WmsBonusTemplateBo bo) {
WmsBonusTemplate update = BeanUtil.toBean(bo, WmsBonusTemplate.class);
validEntityBeforeSave(update);
return baseMapper.updateById(update) > 0;
}
/**
* 保存前的数据校验
*/
private void validEntityBeforeSave(WmsBonusTemplate entity){
//TODO 做一些数据校验,如唯一约束
}
/**
* 批量删除奖金模板
*/
@Override
public Boolean deleteWithValidByIds(Collection<Long> ids, Boolean isValid) {
if(isValid){
//TODO 做一些业务上的校验,判断是否需要校验
}
return baseMapper.deleteBatchIds(ids) > 0;
}
}

View File

@@ -0,0 +1,20 @@
<?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="com.klp.mapper.WmsBonusTemplateMapper">
<resultMap type="com.klp.domain.WmsBonusTemplate" id="WmsBonusTemplateResult">
<result property="templateId" column="template_id"/>
<result property="templateName" column="template_name"/>
<result property="templateContent" column="template_content"/>
<result property="createBy" column="create_by"/>
<result property="updateBy" column="update_by"/>
<result property="createTime" column="create_time"/>
<result property="updateTime" column="update_time"/>
<result property="delFlag" column="del_flag"/>
<result property="remark" column="remark"/>
</resultMap>
</mapper>