feat(wms): 新增资金日记账功能

- 添加资金日记账相关实体类、Mapper、Service、Controller
- 实现资金日记账的增删改查功能
- 添加资金日记账的导出功能
This commit is contained in:
JR
2025-08-13 11:48:12 +08:00
parent 13d24f5693
commit 8e3497b971
9 changed files with 521 additions and 1 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.WmsJournalVo;
import com.klp.domain.bo.WmsJournalBo;
import com.klp.service.IWmsJournalService;
import com.klp.common.core.page.TableDataInfo;
/**
* 资金日记账
*
* @author klp
* @date 2025-08-13
*/
@Validated
@RequiredArgsConstructor
@RestController
@RequestMapping("/klp/journal")
public class WmsJournalController extends BaseController {
private final IWmsJournalService iWmsJournalService;
/**
* 查询资金日记账列表
*/
@GetMapping("/list")
public TableDataInfo<WmsJournalVo> list(WmsJournalBo bo, PageQuery pageQuery) {
return iWmsJournalService.queryPageList(bo, pageQuery);
}
/**
* 导出资金日记账列表
*/
@Log(title = "资金日记账", businessType = BusinessType.EXPORT)
@PostMapping("/export")
public void export(WmsJournalBo bo, HttpServletResponse response) {
List<WmsJournalVo> list = iWmsJournalService.queryList(bo);
ExcelUtil.exportExcel(list, "资金日记账", WmsJournalVo.class, response);
}
/**
* 获取资金日记账详细信息
*
* @param journalId 主键
*/
@GetMapping("/{journalId}")
public R<WmsJournalVo> getInfo(@NotNull(message = "主键不能为空")
@PathVariable Long journalId) {
return R.ok(iWmsJournalService.queryById(journalId));
}
/**
* 新增资金日记账
*/
@Log(title = "资金日记账", businessType = BusinessType.INSERT)
@RepeatSubmit()
@PostMapping()
public R<Void> add(@Validated(AddGroup.class) @RequestBody WmsJournalBo bo) {
return toAjax(iWmsJournalService.insertByBo(bo));
}
/**
* 修改资金日记账
*/
@Log(title = "资金日记账", businessType = BusinessType.UPDATE)
@RepeatSubmit()
@PutMapping()
public R<Void> edit(@Validated(EditGroup.class) @RequestBody WmsJournalBo bo) {
return toAjax(iWmsJournalService.updateByBo(bo));
}
/**
* 删除资金日记账
*
* @param journalIds 主键串
*/
@Log(title = "资金日记账", businessType = BusinessType.DELETE)
@DeleteMapping("/{journalIds}")
public R<Void> remove(@NotEmpty(message = "主键不能为空")
@PathVariable Long[] journalIds) {
return toAjax(iWmsJournalService.deleteWithValidByIds(Arrays.asList(journalIds), true));
}
}

View File

@@ -0,0 +1,67 @@
package com.klp.domain;
import com.baomidou.mybatisplus.annotation.*;
import com.klp.common.core.domain.BaseEntity;
import lombok.Data;
import lombok.EqualsAndHashCode;
import java.math.BigDecimal;
import java.util.Date;
/**
* 资金日记账对象 wms_journal
*
* @author klp
* @date 2025-08-13
*/
@Data
@EqualsAndHashCode(callSuper = true)
@TableName("wms_journal")
public class WmsJournal extends BaseEntity {
private static final long serialVersionUID=1L;
/**
* 主键ID
*/
@TableId(value = "journal_id")
private Long journalId;
/**
* 日期
*/
private Date journalDate;
/**
* 摘要
*/
private String summary;
/**
* 收支类型
*/
private String transType;
/**
* 对方户名
*/
private String counterpart;
/**
* 收入金额
*/
private BigDecimal incomeAmount;
/**
* 支出金额
*/
private BigDecimal expenseAmount;
/**
* 余额
*/
private BigDecimal balanceAmount;
/**
* 备注
*/
private String remark;
/**
* 删除标志0正常 1删除
*/
@TableLogic
private Long delFlag;
}

View File

@@ -7,7 +7,6 @@ import lombok.EqualsAndHashCode;
import java.math.BigDecimal;
import java.util.Date;
import com.fasterxml.jackson.annotation.JsonFormat;
/**
* 日记账凭证(宽松版)对象 wms_journal_entry

View File

@@ -0,0 +1,71 @@
package com.klp.domain.bo;
import com.klp.common.core.domain.BaseEntity;
import lombok.Data;
import lombok.EqualsAndHashCode;
import java.math.BigDecimal;
import java.util.Date;
import com.fasterxml.jackson.annotation.JsonFormat;
import org.springframework.format.annotation.DateTimeFormat;
/**
* 资金日记账业务对象 wms_journal
*
* @author klp
* @date 2025-08-13
*/
@Data
@EqualsAndHashCode(callSuper = true)
public class WmsJournalBo extends BaseEntity {
/**
* 主键ID
*/
private Long journalId;
/**
* 日期
*/
@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss", timezone = "GMT+8")
@DateTimeFormat(pattern = "yyyy-MM-dd HH:mm:ss")
private Date journalDate;
/**
* 摘要
*/
private String summary;
/**
* 收支类型
*/
private String transType;
/**
* 对方户名
*/
private String counterpart;
/**
* 收入金额
*/
private BigDecimal incomeAmount;
/**
* 支出金额
*/
private BigDecimal expenseAmount;
/**
* 余额
*/
private BigDecimal balanceAmount;
/**
* 备注
*/
private String remark;
}

View File

@@ -0,0 +1,81 @@
package com.klp.domain.vo;
import java.math.BigDecimal;
import java.util.Date;
import com.fasterxml.jackson.annotation.JsonFormat;
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 lombok.Data;
/**
* 资金日记账视图对象 wms_journal
*
* @author klp
* @date 2025-08-13
*/
@Data
@ExcelIgnoreUnannotated
public class WmsJournalVo {
private static final long serialVersionUID = 1L;
/**
* 主键ID
*/
@ExcelProperty(value = "主键ID")
private Long journalId;
/**
* 日期
*/
@ExcelProperty(value = "日期")
@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss", timezone = "GMT+8")
private Date journalDate;
/**
* 摘要
*/
@ExcelProperty(value = "摘要")
private String summary;
/**
* 收支类型
*/
@ExcelProperty(value = "收支类型")
private String transType;
/**
* 对方户名
*/
@ExcelProperty(value = "对方户名")
private String counterpart;
/**
* 收入金额
*/
@ExcelProperty(value = "收入金额")
private BigDecimal incomeAmount;
/**
* 支出金额
*/
@ExcelProperty(value = "支出金额")
private BigDecimal expenseAmount;
/**
* 余额
*/
@ExcelProperty(value = "余额")
private BigDecimal balanceAmount;
/**
* 备注
*/
@ExcelProperty(value = "备注")
private String remark;
}

View File

@@ -0,0 +1,15 @@
package com.klp.mapper;
import com.klp.domain.WmsJournal;
import com.klp.domain.vo.WmsJournalVo;
import com.klp.common.core.mapper.BaseMapperPlus;
/**
* 资金日记账Mapper接口
*
* @author klp
* @date 2025-08-13
*/
public interface WmsJournalMapper extends BaseMapperPlus<WmsJournalMapper, WmsJournal, WmsJournalVo> {
}

View File

@@ -0,0 +1,48 @@
package com.klp.service;
import com.klp.domain.vo.WmsJournalVo;
import com.klp.domain.bo.WmsJournalBo;
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 2025-08-13
*/
public interface IWmsJournalService {
/**
* 查询资金日记账
*/
WmsJournalVo queryById(Long journalId);
/**
* 查询资金日记账列表
*/
TableDataInfo<WmsJournalVo> queryPageList(WmsJournalBo bo, PageQuery pageQuery);
/**
* 查询资金日记账列表
*/
List<WmsJournalVo> queryList(WmsJournalBo bo);
/**
* 新增资金日记账
*/
Boolean insertByBo(WmsJournalBo bo);
/**
* 修改资金日记账
*/
Boolean updateByBo(WmsJournalBo bo);
/**
* 校验并批量删除资金日记账信息
*/
Boolean deleteWithValidByIds(Collection<Long> ids, Boolean isValid);
}

View File

@@ -0,0 +1,115 @@
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.WmsJournalBo;
import com.klp.domain.vo.WmsJournalVo;
import com.klp.domain.WmsJournal;
import com.klp.mapper.WmsJournalMapper;
import com.klp.service.IWmsJournalService;
import java.util.List;
import java.util.Map;
import java.util.Collection;
/**
* 资金日记账Service业务层处理
*
* @author klp
* @date 2025-08-13
*/
@RequiredArgsConstructor
@Service
public class WmsJournalServiceImpl implements IWmsJournalService {
private final WmsJournalMapper baseMapper;
/**
* 查询资金日记账
*/
@Override
public WmsJournalVo queryById(Long journalId){
return baseMapper.selectVoById(journalId);
}
/**
* 查询资金日记账列表
*/
@Override
public TableDataInfo<WmsJournalVo> queryPageList(WmsJournalBo bo, PageQuery pageQuery) {
LambdaQueryWrapper<WmsJournal> lqw = buildQueryWrapper(bo);
Page<WmsJournalVo> result = baseMapper.selectVoPage(pageQuery.build(), lqw);
return TableDataInfo.build(result);
}
/**
* 查询资金日记账列表
*/
@Override
public List<WmsJournalVo> queryList(WmsJournalBo bo) {
LambdaQueryWrapper<WmsJournal> lqw = buildQueryWrapper(bo);
return baseMapper.selectVoList(lqw);
}
private LambdaQueryWrapper<WmsJournal> buildQueryWrapper(WmsJournalBo bo) {
Map<String, Object> params = bo.getParams();
LambdaQueryWrapper<WmsJournal> lqw = Wrappers.lambdaQuery();
lqw.eq(bo.getJournalDate() != null, WmsJournal::getJournalDate, bo.getJournalDate());
lqw.eq(StringUtils.isNotBlank(bo.getSummary()), WmsJournal::getSummary, bo.getSummary());
lqw.eq(StringUtils.isNotBlank(bo.getTransType()), WmsJournal::getTransType, bo.getTransType());
lqw.eq(StringUtils.isNotBlank(bo.getCounterpart()), WmsJournal::getCounterpart, bo.getCounterpart());
lqw.eq(bo.getIncomeAmount() != null, WmsJournal::getIncomeAmount, bo.getIncomeAmount());
lqw.eq(bo.getExpenseAmount() != null, WmsJournal::getExpenseAmount, bo.getExpenseAmount());
lqw.eq(bo.getBalanceAmount() != null, WmsJournal::getBalanceAmount, bo.getBalanceAmount());
return lqw;
}
/**
* 新增资金日记账
*/
@Override
public Boolean insertByBo(WmsJournalBo bo) {
WmsJournal add = BeanUtil.toBean(bo, WmsJournal.class);
validEntityBeforeSave(add);
boolean flag = baseMapper.insert(add) > 0;
if (flag) {
bo.setJournalId(add.getJournalId());
}
return flag;
}
/**
* 修改资金日记账
*/
@Override
public Boolean updateByBo(WmsJournalBo bo) {
WmsJournal update = BeanUtil.toBean(bo, WmsJournal.class);
validEntityBeforeSave(update);
return baseMapper.updateById(update) > 0;
}
/**
* 保存前的数据校验
*/
private void validEntityBeforeSave(WmsJournal entity){
//TODO 做一些数据校验,如唯一约束
}
/**
* 批量删除资金日记账
*/
@Override
public Boolean deleteWithValidByIds(Collection<Long> ids, Boolean isValid) {
if(isValid){
//TODO 做一些业务上的校验,判断是否需要校验
}
return baseMapper.deleteBatchIds(ids) > 0;
}
}