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

- 添加资金日记账相关实体类、Mapper、Service、Controller
- 实现资金日记账的增删改查功能
- 添加资金日记账的导出功能

klp-wms/src/main/java/com/klp/controller/WmsJournalController.java

@@ -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));
+    }
+}

klp-wms/src/main/java/com/klp/domain/WmsJournal.java

@@ -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;
+
+}

klp-wms/src/main/java/com/klp/domain/WmsJournalEntry.java

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

klp-wms/src/main/java/com/klp/domain/bo/WmsJournalBo.java

@@ -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;
+
+
+}

klp-wms/src/main/java/com/klp/domain/vo/WmsJournalVo.java

@@ -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;
+
+
+}

klp-wms/src/main/java/com/klp/mapper/WmsJournalMapper.java

@@ -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> {
+
+}

klp-wms/src/main/java/com/klp/service/IWmsJournalService.java

@@ -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);
+}

klp-wms/src/main/java/com/klp/service/impl/WmsJournalServiceImpl.java

@@ -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;
+    }
+}

klp-wms/src/main/resources/mapper/klp/WmsJournalMapper.xml

@@ -0,0 +1,25 @@
+<?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.WmsJournalMapper">
+
+    <resultMap type="com.klp.domain.WmsJournal" id="WmsJournalResult">
+        <result property="journalId" column="journal_id"/>
+        <result property="journalDate" column="journal_date"/>
+        <result property="summary" column="summary"/>
+        <result property="transType" column="trans_type"/>
+        <result property="counterpart" column="counterpart"/>
+        <result property="incomeAmount" column="income_amount"/>
+        <result property="expenseAmount" column="expense_amount"/>
+        <result property="balanceAmount" column="balance_amount"/>
+        <result property="remark" column="remark"/>
+        <result property="createBy" column="create_by"/>
+        <result property="createTime" column="create_time"/>
+        <result property="updateBy" column="update_by"/>
+        <result property="updateTime" column="update_time"/>
+        <result property="delFlag" column="del_flag"/>
+    </resultMap>
+
+
+</mapper>