feat: Add matters logic

.gitignore

@@ -41,4 +41,4 @@ rebel.xml
 target/
 !.mvn/wrapper/maven-wrapper.jar
 
-
+Temp/

ruoyi-modules/ruoyi-business/src/main/java/org/dromara/business/matters_list/domain/MattersList.java

@@ -0,0 +1,134 @@
+package org.dromara.business.matters_list.domain;
+
+import cn.hutool.core.bean.BeanUtil;
+import cn.hutool.core.bean.copier.CopyOptions;
+import com.baomidou.mybatisplus.annotation.IdType;
+import com.baomidou.mybatisplus.annotation.TableField;
+import com.baomidou.mybatisplus.annotation.TableId;
+import com.baomidou.mybatisplus.annotation.TableName;
+import com.baomidou.mybatisplus.extension.handlers.JacksonTypeHandler;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+import org.dromara.business.domain.BaseDomain;
+import org.dromara.business.matters_list.service.dto.MattersListAdd;
+
+import java.util.List;
+
+/**
+ * Maritime Safety Administration Illegal Matters List Entity
+ * 海事局违法事项清单实体类
+ *
+ * @author system
+ * @since 2024-01-01
+ */
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+@EqualsAndHashCode(callSuper = true)
+@TableName(value = "msaiin_illegal_matters_list", autoResultMap = true)
+public class MattersList extends BaseDomain {
+
+    /**
+     * Primary key ID
+     * 主键ID
+     */
+    @TableId(value = "id", type = IdType.AUTO)
+    private Long id;
+
+    /**
+     * Matter number (auto-generated)
+     * 事项编号（自动生成）
+     */
+    @TableField("matter_no")
+    private String matterNo;
+
+    /**
+     * Matter name
+     * 事项名称
+     */
+    @TableField("matter_name")
+    private String matterName;
+
+    /**
+     * Legal basis
+     * 法律依据
+     */
+    @TableField("legal_basis")
+    private String legalBasis;
+
+    /**
+     * Penalty basis
+     * 处罚依据
+     */
+    @TableField("penalty_basis")
+    private String penaltyBasis;
+
+    /**
+     * Violation behavior
+     * 违法行为
+     */
+    @TableField("violation_behavior")
+    private String violationBehavior;
+
+    /**
+     * Penalty standard
+     * 处罚标准
+     */
+    @TableField("penalty_standard")
+    private String penaltyStandard;
+
+    /**
+     * Report standard
+     * 通报标准
+     */
+    @TableField("report_standard")
+    private String reportStandard;
+
+    /**
+     * Issuing department IDs (JSON array for single/multiple selection)
+     * 发出单位ID列表（JSON数组，支持单选和多选）
+     * Format: ["dept_id_1", "dept_id_2"] or ["dept_id_1"]
+     */
+    @TableField(value = "send_dept_ids", typeHandler = JacksonTypeHandler.class)
+    private List<String> sendDeptIds;
+
+    /**
+     * Handling proposal
+     * 处理建议
+     */
+    @TableField("handle_proposal")
+    private String handleProposal;
+
+    /**
+     * Remarks
+     * 备注
+     */
+    @TableField("remarks")
+    private String remarks;
+
+    /**
+     * Status (0: inactive, 1: active)
+     * 状态（0：停用，1：启用）
+     */
+    @TableField("status")
+    private Integer status;
+
+    /**
+     * Sort order
+     * 排序
+     */
+    @TableField("sort_order")
+    private Integer sortOrder;
+
+    public void copy(MattersList source) {
+        BeanUtil.copyProperties(source, this, CopyOptions.create().setIgnoreNullValue(true));
+    }
+
+    public void copy(MattersListAdd source) {
+        BeanUtil.copyProperties(source, this, CopyOptions.create().setIgnoreNullValue(true));
+    }
+}

ruoyi-modules/ruoyi-business/src/main/java/org/dromara/business/matters_list/rest/MattersListController.java

@@ -0,0 +1,62 @@
+package org.dromara.business.matters_list.rest;
+
+import io.swagger.annotations.Api;
+import io.swagger.annotations.ApiOperation;
+import lombok.AllArgsConstructor;
+import org.dromara.business.matters_list.domain.MattersList;
+import org.dromara.business.matters_list.service.MattersListService;
+import org.dromara.business.matters_list.service.dto.MattersListAdd;
+import org.dromara.business.matters_list.service.dto.MattersListDto;
+import org.dromara.business.matters_list.service.dto.MattersListQueryCriteria;
+import org.dromara.business.domain.PageResult;
+import org.springframework.data.domain.Pageable;
+import org.springframework.http.HttpStatus;
+import org.springframework.http.ResponseEntity;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.*;
+
+import java.util.Arrays;
+
+/**
+ * Matters List Controller
+ * 通报事项清单控制器
+ *
+ * @author abai
+ * @date 2025-01-07
+ */
+@AllArgsConstructor
+@Api(tags = "通报事项清单管理")
+@RestController
+@RequestMapping("/api/mattersList")
+public class MattersListController {
+
+    private final MattersListService mattersListService;
+
+    @GetMapping
+    @ApiOperation("分页查询通报事项清单数据")
+    public ResponseEntity<PageResult<MattersListDto>> getMattersLists(MattersListQueryCriteria criteria, Pageable pageable) {
+        return new ResponseEntity<>(mattersListService.queryAll(criteria, pageable), HttpStatus.OK);
+    }
+
+    @PostMapping
+    @ApiOperation("新增通报事项清单数据")
+    public ResponseEntity<Object> create(@Validated @RequestBody MattersListAdd resources) {
+        MattersList mattersList = MattersList.builder().build();
+        mattersList.copy(resources);
+        return new ResponseEntity<>(mattersListService.saveOrUpdateMattersList(mattersList), HttpStatus.CREATED);
+    }
+
+    @PutMapping
+    @ApiOperation("修改通报事项清单数据")
+    public ResponseEntity<Object> update(@Validated @RequestBody MattersList resources) {
+        mattersListService.saveOrUpdateMattersList(resources);
+        return new ResponseEntity<>(HttpStatus.NO_CONTENT);
+    }
+
+    @ApiOperation("删除通报事项清单数据")
+    @DeleteMapping
+    public ResponseEntity<Object> deleteAll(@RequestBody Long[] ids) {
+        mattersListService.removeByIds(Arrays.asList(ids));
+        return new ResponseEntity<>(HttpStatus.OK);
+    }
+}

ruoyi-modules/ruoyi-business/src/main/java/org/dromara/business/matters_list/service/MattersListService.java

@@ -0,0 +1,82 @@
+package org.dromara.business.matters_list.service;
+
+import org.dromara.business.common.service.BaseService;
+import org.dromara.business.domain.PageResult;
+import org.dromara.business.matters_list.domain.MattersList;
+import org.dromara.business.matters_list.service.dto.MattersListDto;
+import org.dromara.business.matters_list.service.dto.MattersListQueryCriteria;
+import org.springframework.data.domain.Pageable;
+
+import java.util.List;
+
+/**
+ * Maritime Safety Administration Illegal Matters List Service Interface
+ * 海事局违法事项清单服务接口
+ *
+ * @author system
+ * @since 2024-01-01
+ */
+public interface MattersListService extends BaseService<MattersList> {
+
+    /**
+     * Query data with pagination
+     * 查询数据分页
+     *
+     * @param criteria 条件
+     * @param pageable 分页参数
+     * @return PageResult<MattersListDto>
+     */
+    PageResult<MattersListDto> queryAll(MattersListQueryCriteria criteria, Pageable pageable);
+
+    /**
+     * Query all data without pagination
+     * 查询所有数据不分页
+     *
+     * @param criteria 条件参数
+     * @return List<MattersListDto>
+     */
+    List<MattersListDto> queryAll(MattersListQueryCriteria criteria);
+
+    /**
+     * Add or update data
+     * 添加或修改数据
+     *
+     * @param resources 数据对象
+     * @return MattersList
+     */
+    MattersList saveOrUpdateMattersList(MattersList resources);
+
+    /**
+     * Delete by ID
+     * 根据ID删除
+     *
+     * @param id 主键ID
+     */
+    void deleteById(Long id);
+
+    /**
+     * Batch delete by IDs
+     * 批量删除
+     *
+     * @param ids 主键ID列表
+     */
+    void deleteByIds(List<Long> ids);
+
+    /**
+     * Get by ID
+     * 根据ID获取详情
+     *
+     * @param id 主键ID
+     * @return MattersListDto
+     */
+    MattersListDto getById(Long id);
+
+    /**
+     * Update status
+     * 更新状态
+     *
+     * @param id 主键ID
+     * @param status 状态值
+     */
+    void updateStatus(Long id, Integer status);
+}

ruoyi-modules/ruoyi-business/src/main/java/org/dromara/business/matters_list/service/dto/MattersListAdd.java

@@ -0,0 +1,105 @@
+package org.dromara.business.matters_list.service.dto;
+
+import io.swagger.annotations.ApiModelProperty;
+import lombok.Data;
+
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.NotNull;
+import java.util.List;
+
+/**
+ * Maritime Safety Administration Illegal Matters List Add/Update DTO
+ * 海事局违法事项清单新增/修改DTO
+ *
+ * @author system
+ * @since 2024-01-01
+ */
+@Data
+public class MattersListAdd {
+
+    /**
+     * Primary key ID (for update)
+     * 主键ID（修改时使用）
+     */
+    @ApiModelProperty(value = "主键ID", name = "id")
+    private Long id;
+
+    /**
+     * Matter name
+     * 事项名称
+     */
+    @ApiModelProperty(value = "事项名称", name = "matterName", required = true)
+    @NotBlank(message = "事项名称不能为空")
+    private String matterName;
+
+    /**
+     * Legal basis
+     * 法律依据
+     */
+    @ApiModelProperty(value = "法律依据", name = "legalBasis")
+    private String legalBasis;
+
+    /**
+     * Penalty basis
+     * 处罚依据
+     */
+    @ApiModelProperty(value = "处罚依据", name = "penaltyBasis")
+    private String penaltyBasis;
+
+    /**
+     * Violation behavior
+     * 违法行为
+     */
+    @ApiModelProperty(value = "违法行为", name = "violationBehavior")
+    private String violationBehavior;
+
+    /**
+     * Penalty standard
+     * 处罚标准
+     */
+    @ApiModelProperty(value = "处罚标准", name = "penaltyStandard")
+    private String penaltyStandard;
+
+    /**
+     * Report standard
+     * 通报标准
+     */
+    @ApiModelProperty(value = "通报标准", name = "reportStandard")
+    private String reportStandard;
+
+    /**
+     * Issuing department IDs (JSON array for single/multiple selection)
+     * 发出单位ID列表（JSON数组，支持单选和多选）
+     */
+    @ApiModelProperty(value = "发出单位ID列表", name = "sendDeptIds")
+    private List<String> sendDeptIds;
+
+    /**
+     * Handling proposal
+     * 处理建议
+     */
+    @ApiModelProperty(value = "处理建议", name = "handleProposal")
+    private String handleProposal;
+
+    /**
+     * Remarks
+     * 备注
+     */
+    @ApiModelProperty(value = "备注", name = "remarks")
+    private String remarks;
+
+    /**
+     * Status (0: inactive, 1: active)
+     * 状态（0：停用，1：启用）
+     */
+    @ApiModelProperty(value = "状态", name = "status")
+    @NotNull(message = "状态不能为空")
+    private Integer status;
+
+    /**
+     * Sort order
+     * 排序
+     */
+    @ApiModelProperty(value = "排序", name = "sortOrder")
+    private Integer sortOrder;
+}

ruoyi-modules/ruoyi-business/src/main/java/org/dromara/business/matters_list/service/dto/MattersListDto.java

@@ -0,0 +1,127 @@
+package org.dromara.business.matters_list.service.dto;
+
+import com.baomidou.mybatisplus.annotation.TableId;
+import io.swagger.annotations.ApiModelProperty;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import org.dromara.business.domain.BaseDomainDto;
+
+import java.util.List;
+
+/**
+ * Maritime Safety Administration Illegal Matters List DTO
+ * 海事局违法事项清单查询结果DTO
+ *
+ * @author system
+ * @since 2024-01-01
+ */
+@Data
+@EqualsAndHashCode(callSuper = true)
+public class MattersListDto extends BaseDomainDto {
+
+    /**
+     * Primary key ID
+     * 主键ID
+     */
+    @ApiModelProperty(value = "主键ID", name = "id")
+    @TableId
+    private Long id;
+
+    /**
+     * Matter number (auto-generated)
+     * 事项编号（自动生成）
+     */
+    @ApiModelProperty(value = "事项编号", name = "matterNo")
+    private String matterNo;
+
+    /**
+     * Matter name
+     * 事项名称
+     */
+    @ApiModelProperty(value = "事项名称", name = "matterName")
+    private String matterName;
+
+    /**
+     * Legal basis
+     * 法律依据
+     */
+    @ApiModelProperty(value = "法律依据", name = "legalBasis")
+    private String legalBasis;
+
+    /**
+     * Penalty basis
+     * 处罚依据
+     */
+    @ApiModelProperty(value = "处罚依据", name = "penaltyBasis")
+    private String penaltyBasis;
+
+    /**
+     * Violation behavior
+     * 违法行为
+     */
+    @ApiModelProperty(value = "违法行为", name = "violationBehavior")
+    private String violationBehavior;
+
+    /**
+     * Penalty standard
+     * 处罚标准
+     */
+    @ApiModelProperty(value = "处罚标准", name = "penaltyStandard")
+    private String penaltyStandard;
+
+    /**
+     * Report standard
+     * 通报标准
+     */
+    @ApiModelProperty(value = "通报标准", name = "reportStandard")
+    private String reportStandard;
+
+    /**
+     * Issuing department IDs (JSON array for single/multiple selection)
+     * 发出单位ID列表（JSON数组，支持单选和多选）
+     */
+    @ApiModelProperty(value = "发出单位ID列表", name = "sendDeptIds")
+    private List<String> sendDeptIds;
+
+    /**
+     * Issuing department names (for display)
+     * 发出单位名称列表（用于显示）
+     */
+    @ApiModelProperty(value = "发出单位名称列表", name = "sendDeptNames")
+    private List<String> sendDeptNames;
+
+    /**
+     * Handling proposal
+     * 处理建议
+     */
+    @ApiModelProperty(value = "处理建议", name = "handleProposal")
+    private String handleProposal;
+
+    /**
+     * Remarks
+     * 备注
+     */
+    @ApiModelProperty(value = "备注", name = "remarks")
+    private String remarks;
+
+    /**
+     * Status (0: inactive, 1: active)
+     * 状态（0：停用，1：启用）
+     */
+    @ApiModelProperty(value = "状态", name = "status")
+    private Integer status;
+
+    /**
+     * Status description
+     * 状态描述
+     */
+    @ApiModelProperty(value = "状态描述", name = "statusDesc")
+    private String statusDesc;
+
+    /**
+     * Sort order
+     * 排序
+     */
+    @ApiModelProperty(value = "排序", name = "sortOrder")
+    private Integer sortOrder;
+}

ruoyi-modules/ruoyi-business/src/main/java/org/dromara/business/matters_list/service/dto/MattersListQueryCriteria.java

@@ -0,0 +1,112 @@
+package org.dromara.business.matters_list.service.dto;
+
+import io.swagger.annotations.ApiModelProperty;
+import lombok.Data;
+import org.dromara.business.annotation.Query;
+
+/**
+ * Maritime Safety Administration Illegal Matters List Query Criteria
+ * 海事局违法事项清单查询条件DTO
+ *
+ * @author system
+ * @since 2024-01-01
+ */
+@Data
+public class MattersListQueryCriteria {
+
+    /**
+     * Matter number (exact match)
+     * 事项编号（精确匹配）
+     */
+    @ApiModelProperty(value = "事项编号", name = "matterNo")
+    @Query(type = Query.Type.EQUAL)
+    private String matterNo;
+
+    /**
+     * Matter name (fuzzy match)
+     * 事项名称（模糊匹配）
+     */
+    @ApiModelProperty(value = "事项名称", name = "matterName")
+    @Query(type = Query.Type.INNER_LIKE)
+    private String matterName;
+
+    /**
+     * Legal basis (fuzzy match)
+     * 法律依据（模糊匹配）
+     */
+    @ApiModelProperty(value = "法律依据", name = "legalBasis")
+    @Query(type = Query.Type.INNER_LIKE)
+    private String legalBasis;
+
+    /**
+     * Penalty basis (fuzzy match)
+     * 处罚依据（模糊匹配）
+     */
+    @ApiModelProperty(value = "处罚依据", name = "penaltyBasis")
+    @Query(type = Query.Type.INNER_LIKE)
+    private String penaltyBasis;
+
+    /**
+     * Violation behavior (fuzzy match)
+     * 违法行为（模糊匹配）
+     */
+    @ApiModelProperty(value = "违法行为", name = "violationBehavior")
+    @Query(type = Query.Type.INNER_LIKE)
+    private String violationBehavior;
+
+    /**
+     * Penalty standard (fuzzy match)
+     * 处罚标准（模糊匹配）
+     */
+    @ApiModelProperty(value = "处罚标准", name = "penaltyStandard")
+    @Query(type = Query.Type.INNER_LIKE)
+    private String penaltyStandard;
+
+    /**
+     * Report standard (fuzzy match)
+     * 通报标准（模糊匹配）
+     */
+    @ApiModelProperty(value = "通报标准", name = "reportStandard")
+    @Query(type = Query.Type.INNER_LIKE)
+    private String reportStandard;
+
+    /**
+     * Issuing department ID (exact match)
+     * 发出单位ID（精确匹配）
+     */
+    @ApiModelProperty(value = "发出单位ID", name = "sendDeptId")
+    @Query(type = Query.Type.EQUAL)
+    private String sendDeptId;
+
+    /**
+     * Handling proposal (fuzzy match)
+     * 处理建议（模糊匹配）
+     */
+    @ApiModelProperty(value = "处理建议", name = "handleProposal")
+    @Query(type = Query.Type.INNER_LIKE)
+    private String handleProposal;
+
+    /**
+     * Status (exact match)
+     * 状态（精确匹配）
+     */
+    @ApiModelProperty(value = "状态", name = "status")
+    @Query(type = Query.Type.EQUAL)
+    private Integer status;
+
+    /**
+     * Create time range start
+     * 创建时间范围开始
+     */
+    @ApiModelProperty(value = "创建时间开始", name = "createTimeStart")
+    @Query(type = Query.Type.GREATER_THAN, propName = "createTime")
+    private String createTimeStart;
+
+    /**
+     * Create time range end
+     * 创建时间范围结束
+     */
+    @ApiModelProperty(value = "创建时间结束", name = "createTimeEnd")
+    @Query(type = Query.Type.LESS_THAN, propName = "createTime")
+    private String createTimeEnd;
+}

ruoyi-modules/ruoyi-business/src/main/java/org/dromara/business/matters_list/service/impl/MattersListServiceImpl.java

@@ -0,0 +1,128 @@
+package org.dromara.business.matters_list.service.impl;
+
+import com.baomidou.mybatisplus.core.conditions.query.LambdaQueryWrapper;
+import com.baomidou.mybatisplus.core.conditions.query.QueryWrapper;
+import com.github.pagehelper.PageInfo;
+import lombok.extern.slf4j.Slf4j;
+import org.apache.commons.collections4.CollectionUtils;
+import org.dromara.business.common.service.impl.BaseServiceImpl;
+import org.dromara.business.common.utils.BusinessUtil;
+import org.dromara.business.common.utils.QueryHelpPlus;
+import org.dromara.business.constants.BusinessConstants;
+import org.dromara.business.matters_list.domain.MattersList;
+import org.dromara.business.matters_list.service.MattersListService;
+import org.dromara.business.matters_list.service.dto.MattersListDto;
+import org.dromara.business.matters_list.service.dto.MattersListQueryCriteria;
+import org.dromara.business.matters_list.service.mapper.MattersListMapper;
+import org.dromara.business.domain.PageResult;
+import org.dromara.business.dozer.service.IGenerator;
+import org.dromara.business.enums.ErrorEnums;
+import org.dromara.business.exception.BusinessException;
+import org.springframework.data.domain.Pageable;
+import org.springframework.stereotype.Service;
+import org.springframework.transaction.annotation.Transactional;
+
+import java.util.List;
+
+/**
+ * Matters List Service Implementation
+ * 通报事项清单服务实现类
+ *
+ * @author abai
+ * @date 2025-01-07
+ */
+@Slf4j
+@Service
+public class MattersListServiceImpl extends BaseServiceImpl<MattersListMapper, MattersList> implements MattersListService {
+
+    private final IGenerator generator;
+
+    public MattersListServiceImpl(IGenerator generator) {
+        this.generator = generator;
+    }
+
+    @Override
+    public PageResult<MattersListDto> queryAll(MattersListQueryCriteria criteria, Pageable pageable) {
+        getPage(pageable);
+        PageInfo<MattersListDto> page = new PageInfo<>(queryAll(criteria));
+        return generator.convertPageInfo(page, MattersListDto.class);
+    }
+
+    @Override
+    public List<MattersListDto> queryAll(MattersListQueryCriteria criteria) {
+        QueryWrapper wrapper = QueryHelpPlus.getPredicate(MattersList.class, criteria);
+        wrapper.orderByDesc("create_time");
+        return baseMapper.selectList(wrapper);
+    }
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    public MattersList saveOrUpdateMattersList(MattersList resources) {
+        // 检查唯一性
+        unique(resources);
+        // 新增或更新
+        if (resources.getId() == null) {
+            // 保存数据
+            save(resources);
+        } else {
+            // 更新数据
+            updateById(resources);
+        }
+        return resources;
+    }
+
+    @Override
+    public MattersListDto getById(Long id) {
+        MattersList entity = baseMapper.selectById(id);
+        return entity != null ? generator.convert(entity, MattersListDto.class) : null;
+    }
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    public void deleteById(Long id) {
+        baseMapper.deleteById(id);
+    }
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    public void deleteByIds(List<Long> ids) {
+        baseMapper.deleteBatchIds(ids);
+    }
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    public void updateStatus(Long id, Integer status) {
+        MattersList entity = new MattersList();
+        entity.setId(id);
+        entity.setStatus(status);
+        baseMapper.updateById(entity);
+    }
+
+    /**
+     * 判断数据是否唯一
+     */
+    private void unique(MattersList resources) {
+        // 事项编号唯一性检查
+        String matterNo = resources.getMatterNo();
+        if (matterNo != null && !matterNo.trim().isEmpty()) {
+            MattersListDto existing = this.queryByMatterNo(matterNo);
+            if (existing != null) {
+                if (resources.getId() == null || !resources.getId().equals(existing.getId())) {
+                    throw new BusinessException(String.format("事项编号%s已存在", matterNo));
+                }
+            }
+        }
+    }
+
+    public MattersListDto queryByMatterNo(String matterNo) {
+        List<MattersList> mattersList = baseMapper.selectList(new LambdaQueryWrapper<MattersList>()
+                .eq(MattersList::getMatterNo, matterNo));
+        if (CollectionUtils.isNotEmpty(mattersList)) {
+            if (mattersList.size() > 1) {
+                throw new BusinessException(String.format("事项编号%s有多条信息", matterNo));
+            }
+            return generator.convert(mattersList.get(0), MattersListDto.class);
+        }
+        return null;
+    }
+}

ruoyi-modules/ruoyi-business/src/main/java/org/dromara/business/matters_list/service/mapper/MattersListMapper.java

@@ -0,0 +1,15 @@
+package org.dromara.business.matters_list.service.mapper;
+
+import org.dromara.business.common.mapper.CoreMapper;
+import org.dromara.business.matters_list.domain.MattersList;
+
+/**
+ * Maritime Safety Administration Illegal Matters List Mapper Interface
+ * 海事局违法事项清单数据访问层接口
+ *
+ * @author system
+ * @since 2024-01-01
+ */
+public interface MattersListMapper extends CoreMapper<MattersList> {
+
+}