【DAOP-1.0】服务商维护

【功能点】新增接口

+package com.csbr.qingcloud.portal.controller;
+
+import com.csbr.cloud.common.response.CommonRes;
+import csbr.cloud.entity.annotation.SystemLog;
+import csbr.cloud.entity.domain.base.vo.PageListVO;
+import com.csbr.cloud.workflow.domain.dto.callback.BizCallbackDTO;
+import com.csbr.qingcloud.portal.domain.vo.ServicerMaintainQueryVO;
+import com.csbr.qingcloud.portal.domain.vo.ServicerMaintainRQVO;
+import com.csbr.qingcloud.portal.domain.vo.ServicerMaintainRSVO;
+import com.csbr.qingcloud.portal.service.ServicerMaintainService;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.Parameter;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.annotation.Resource;
+import jakarta.validation.Valid;
+import org.springframework.web.bind.annotation.*;
+
+import java.util.List;
+
+/**
+ * @program: D:/git/ms-data-circulation-portal-service
+ * @description: 服务商维护-控制器
+ * @author: xcq
+ * @create: 2024-12-31 18:49
+ **/
+@RestController
+@RequestMapping("/servicer-maintain")
+@Tag(name = "服务商维护-控制器")
+public class ServicerMaintainController {
+    
+    @Resource
+    private ServicerMaintainService servicerMaintainService;
+    
+    //region 基本操作
+
+    @PostMapping("/save")
+    @SystemLog(value = "服务商维护-新增")
+    @Operation(summary = "服务商维护-新增")
+    public CommonRes<Boolean> saveServicerMaintain(@RequestBody @Valid ServicerMaintainRQVO vo) {
+        servicerMaintainService.saveServicerMaintain(vo);
+        return CommonRes.success(true);
+    }
+
+    @PutMapping("/update")
+    @SystemLog(value = "服务商维护-修改")
+    @Operation(summary = "服务商维护-修改")
+    public CommonRes<Boolean> updateServicerMaintain(@RequestBody @Valid ServicerMaintainRQVO vo) {
+        servicerMaintainService.updateServicerMaintain(vo);
+        return CommonRes.success(true);
+    }
+    
+    @DeleteMapping("/delete")
+    @SystemLog(value = "服务商维护-批量删除")
+    @Operation(summary = "服务商维护-批量删除")
+    public CommonRes<Boolean> removeByGuids(@RequestBody List<String> guids) {
+        servicerMaintainService.removeByGuids(guids);
+        return CommonRes.success(true);
+    }
+
+    @PostMapping("/page-list")
+    @SystemLog(value = "服务商维护-分页")
+    @Operation(summary = "服务商维护-分页")
+    public CommonRes<PageListVO<ServicerMaintainRSVO>> pageList(@RequestBody @Valid ServicerMaintainQueryVO queryVO) {
+        PageListVO<ServicerMaintainRSVO> pageVO = servicerMaintainService.pageList(queryVO);
+        return CommonRes.success(pageVO);
+     }
+     
+    @GetMapping("/detail")
+    @SystemLog(value = "服务商维护-详情")
+    @Operation(
+            summary = "服务商维护-详情",
+            parameters = {
+                    @Parameter(name = "guid", description = "服务商维护唯一标识", required = true)}
+    )
+    public CommonRes<ServicerMaintainRSVO> getServicerMaintainDetail(@RequestParam String guid) {
+        ServicerMaintainRSVO vo = servicerMaintainService.getServicerMaintainDetail(guid);
+        return CommonRes.success(vo);
+    }
+
+    @PostMapping("/flow-call-back")
+    @SystemLog(value = "服务商维护-流程结束后进行业务回调")
+    @Operation(summary = "服务商维护-流程结束后进行业务回调", hidden = true)
+    public CommonRes<Boolean> flowCallBack(@RequestBody @Valid BizCallbackDTO dto) {
+        servicerMaintainService.flowCallBack(dto);
+        return CommonRes.success(true);
+    }
+    
+    //endregion
+    
+}

+package com.csbr.qingcloud.portal.domain.vo;
+
+import com.csbr.cloud.workflow.domain.dto.appove.FlowBizGuidQueryDTO;
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.EqualsAndHashCode;
+import lombok.Data;
+import java.util.Date;
+import java.util.List;
+
+/**
+ * @program: D:/git/ms-data-circulation-portal-service
+ * @description: 服务商维护查询参数
+ * @author: xcq
+ * @create: 2024-12-31 18:49
+ **/
+@EqualsAndHashCode(callSuper = true)
+@Data
+@Schema(title = "服务商维护查询参数")
+public class ServicerMaintainQueryVO extends FlowBizGuidQueryDTO {
+    
+    /**
+     * 业务审批状态【N 草稿中，A 审批中，Y 已通过，R 驳回，C 已撤销，D 已废弃】
+     */
+    @Schema(description = "业务审批状态【N 草稿中，A 审批中，Y 已通过，R 驳回，C 已撤销，D 已废弃】")
+    private String bizApproveState;
+
+    /******** 自定义扩展 *****/
+    
+    /**
+     * 数据唯一标识【List集合】
+     */
+    @Schema(description = "数据唯一标识", hidden = true)
+    private List<String> guidList;
+    
+    /**
+     * 是否调用查询的判断
+     */
+    @Schema(description = "是否调用查询的判断", hidden = true)
+    private Boolean isNeedQuery;
+    
+}

+package com.csbr.qingcloud.portal.domain.vo;
+
+import com.csbr.cloud.workflow.domain.vo.appove.FlowRQBaseVO;
+import io.swagger.v3.oas.annotations.media.Schema;
+import com.fasterxml.jackson.annotation.JsonFormat;
+import lombok.Data;
+import java.util.Date;
+
+/**
+ * @program: D:/git/ms-data-circulation-portal-service
+ * @description: 服务商维护新增、修改参数
+ * @author: xcq
+ * @create: 2024-12-31 18:49
+ **/
+@Data
+@Schema(title = "服务商维护新增、修改参数")
+public class ServicerMaintainRQVO extends FlowRQBaseVO {
+    
+    /**
+     * 企业唯一标识
+     */
+    @Schema(description = "企业唯一标识")
+    private String tenantGuid;
+    
+    /**
+     * 公司名称
+     */
+    @Schema(description = "公司名称")
+    private String tenantName;
+    
+    /**
+     * 企业类型【选择平台字典【公司类型】的选项】
+     */
+    @Schema(description = "企业类型【选择平台字典【公司类型】的选项】")
+    private String tenantType;
+    
+    /**
+     * 提交时间
+     */
+    @Schema(description = "提交时间")
+    @JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss", timezone = "GMT+8")
+    private Date submitTime;
+    
+    /**
+     * 联系人
+     */
+    @Schema(description = "联系人")
+    private String contacts;
+    
+    /**
+     * 联系人电话
+     */
+    @Schema(description = "联系人电话")
+    private String contactTel;
+    
+    /**
+     * 业务审批状态【N 草稿中，A 审批中，Y 已通过，R 驳回，C 已撤销，D 已废弃； 默认 N】
+     */
+    @Schema(description = "业务审批状态【N 草稿中，A 审批中，Y 已通过，R 驳回，C 已撤销，D 已废弃； 默认 N】")
+    private String bizApproveState;
+    
+    /**
+     * 能否继续合作【Y 能；N 不能；】
+     */
+    @Schema(description = "能否继续合作【Y 能；N 不能；】")
+    private String canContinueCollaborate;
+    
+    /**
+     * 维护信息
+     */
+    @Schema(description = "维护信息")
+    private String maintainJson;
+    
+    /******** 库表存储属性 需处理 *****/
+    
+    /******** 自定义扩展 *****/
+    
+    /******** 子对象 *****/
+    
+}

+package com.csbr.qingcloud.portal.domain.vo;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import com.fasterxml.jackson.annotation.JsonFormat;
+import lombok.Data;
+import com.csbr.cloud.workflow.domain.vo.appove.BizApproveVO;
+import java.util.Date;
+
+/**
+ * @program: D:/git/ms-data-circulation-portal-service
+ * @description: 服务商维护返回参数
+ * @author: xcq
+ * @create: 2024-12-31 18:49
+ **/
+@Data
+@Schema(title = "服务商维护返回参数")
+public class ServicerMaintainRSVO {
+    
+    /**
+     * 系统唯一标识
+     */
+    @Schema(description = "系统唯一标识")
+    private String guid;
+    
+    /**
+     * 企业唯一标识
+     */
+    @Schema(description = "企业唯一标识")
+    private String tenantGuid;
+    
+    /**
+     * 公司名称
+     */
+    @Schema(description = "公司名称")
+    private String tenantName;
+    
+    /**
+     * 企业类型【选择平台字典【公司类型】的选项】
+     */
+    @Schema(description = "企业类型【选择平台字典【公司类型】的选项】")
+    private String tenantType;
+    
+    /**
+     * 提交时间
+     */
+    @Schema(description = "提交时间")
+    @JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss", timezone = "GMT+8")
+    private Date submitTime;
+    
+    /**
+     * 联系人
+     */
+    @Schema(description = "联系人")
+    private String contacts;
+    
+    /**
+     * 联系人电话
+     */
+    @Schema(description = "联系人电话")
+    private String contactTel;
+    
+    /**
+     * 业务审批状态【N 草稿中，A 审批中，Y 已通过，R 驳回，C 已撤销，D 已废弃； 默认 N】
+     */
+    @Schema(description = "业务审批状态【N 草稿中，A 审批中，Y 已通过，R 驳回，C 已撤销，D 已废弃； 默认 N】")
+    private String bizApproveState;
+    
+    /**
+     * 能否继续合作【Y 能；N 不能；】
+     */
+    @Schema(description = "能否继续合作【Y 能；N 不能；】")
+    private String canContinueCollaborate;
+    
+    /**
+     * 维护信息
+     */
+    @Schema(description = "维护信息")
+    private String maintainJson;
+    
+    /******** 库表存储属性 需处理 *****/
+    
+    /******** 自定义扩展 *****/
+    
+    /**
+     * 审批信息
+     */
+    @Schema(description = "审批信息")
+    private BizApproveVO approveVO;
+    
+    /******** 子对象 *****/
+    
+}

+package com.csbr.qingcloud.portal.mybatis.entity;
+
+import com.baomidou.mybatisplus.annotation.FieldStrategy;
+import com.baomidou.mybatisplus.annotation.TableField;
+import csbr.cloud.entity.domain.base.dao.BaseDO;
+import jdk.jfr.Name;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.experimental.Accessors;
+import java.util.Date;
+
+/**
+ * @program: D:/git/ms-data-circulation-portal-service
+ * @description: 服务商维护实体
+ * @author: xcq
+ * @create: 2024-12-31 18:49
+ **/
+@Data
+@EqualsAndHashCode(callSuper = true)
+@Accessors(chain = true)
+@Name("服务商维护")
+public class MfServicerMaintain extends BaseDO {
+    
+    /**
+    * 企业唯一标识
+    */
+    @Name("企业唯一标识")
+    private String tenantGuid;
+    
+    /**
+    * 公司名称
+    */
+    @Name("公司名称")
+    private String tenantName;
+    
+    /**
+    * 企业类型【选择平台字典【公司类型】的选项】
+    */
+    @Name("企业类型【选择平台字典【公司类型】的选项】")
+    private String tenantType;
+    
+    /**
+    * 提交时间
+    */
+    @Name("提交时间")
+    private Date submitTime;
+    
+    /**
+    * 联系人
+    */
+    @Name("联系人")
+    private String contacts;
+    
+    /**
+    * 联系人电话
+    */
+    @Name("联系人电话")
+    private String contactTel;
+    
+    /**
+    * 业务审批状态【N 草稿中，A 审批中，Y 已通过，R 驳回，C 已撤销，D 已废弃； 默认 N】
+    */
+    @Name("业务审批状态【N 草稿中，A 审批中，Y 已通过，R 驳回，C 已撤销，D 已废弃； 默认 N】")
+    private String bizApproveState;
+    
+    /**
+    * 能否继续合作【Y 能；N 不能；】
+    */
+    @Name("能否继续合作【Y 能；N 不能；】")
+    private String canContinueCollaborate;
+    
+    /**
+    * 维护信息
+    */
+    @Name("维护信息")
+    @TableField(updateStrategy = FieldStrategy.ALWAYS)
+    private String maintainJson;
+
+}

+package com.csbr.qingcloud.portal.mybatis.entity;
+
+import csbr.cloud.entity.domain.base.dao.BaseDO;
+import jdk.jfr.Name;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.experimental.Accessors;
+import java.util.Date;
+
+/**
+ * @program: D:/git/ms-data-circulation-portal-service
+ * @description: 服务商维护明细实体
+ * @author: xcq
+ * @create: 2024-12-31 18:52
+ **/
+@Data
+@EqualsAndHashCode(callSuper = true)
+@Accessors(chain = true)
+@Name("服务商维护明细")
+public class MfServicerMaintainDetail extends BaseDO {
+    
+    /**
+    * 企业唯一标识
+    */
+    @Name("企业唯一标识")
+    private String tenantGuid;
+    
+    /**
+    * 父唯一标识
+    */
+    @Name("父唯一标识")
+    private String parentGuid;
+    
+    /**
+    * 字典唯一标识
+    */
+    @Name("字典唯一标识")
+    private String dicGuid;
+    
+    /**
+    * 字典值
+    */
+    @Name("字典值")
+    private String dicValue;
+
+}

+package com.csbr.qingcloud.portal.mybatis.mapper;
+
+import com.baomidou.mybatisplus.core.mapper.BaseMapper;
+import org.apache.ibatis.annotations.Mapper;
+import com.csbr.qingcloud.portal.mybatis.entity.MfServicerMaintainDetail;
+
+/**
+ * @program: D:/git/ms-data-circulation-portal-service
+ * @description: 服务商维护明细 Mapper 接口
+ * @author: xcq
+ * @create: 2024-12-31 18:52
+ **/
+@Mapper
+public interface MfServicerMaintainDetailMapper extends BaseMapper<MfServicerMaintainDetail> {
+    
+}

+package com.csbr.qingcloud.portal.mybatis.mapper;
+
+import com.baomidou.mybatisplus.core.mapper.BaseMapper;
+import org.apache.ibatis.annotations.Mapper;
+import com.csbr.qingcloud.portal.mybatis.entity.MfServicerMaintain;
+
+/**
+ * @program: D:/git/ms-data-circulation-portal-service
+ * @description: 服务商维护 Mapper 接口
+ * @author: xcq
+ * @create: 2024-12-31 18:49
+ **/
+@Mapper
+public interface MfServicerMaintainMapper extends BaseMapper<MfServicerMaintain> {
+    
+}

+package com.csbr.qingcloud.portal.mybatis.service;
+
+import com.csbr.cloud.base.service.CsbrService;
+import com.csbr.qingcloud.portal.mybatis.entity.MfServicerMaintainDetail;
+
+/**
+ * @program: D:/git/ms-data-circulation-portal-service
+ * @description: 服务商维护明细逻辑层接口
+ * @author: xcq
+ * @create: 2024-12-31 18:52
+ **/
+public interface MfServicerMaintainDetailService extends CsbrService<MfServicerMaintainDetail> {
+    
+}

+package com.csbr.qingcloud.portal.mybatis.service;
+
+import com.csbr.cloud.base.service.CsbrService;
+import com.csbr.qingcloud.portal.mybatis.entity.MfServicerMaintain;
+
+/**
+ * @program: D:/git/ms-data-circulation-portal-service
+ * @description: 服务商维护逻辑层接口
+ * @author: xcq
+ * @create: 2024-12-31 18:49
+ **/
+public interface MfServicerMaintainService extends CsbrService<MfServicerMaintain> {
+    
+}

+package com.csbr.qingcloud.portal.mybatis.service.impl;
+
+import com.csbr.cloud.mybatis.service.impl.CsbrServiceImpl;
+import com.csbr.qingcloud.portal.mybatis.mapper.MfServicerMaintainDetailMapper;
+import com.csbr.qingcloud.portal.mybatis.entity.MfServicerMaintainDetail;
+import com.csbr.qingcloud.portal.mybatis.service.MfServicerMaintainDetailService;
+import jakarta.annotation.Resource;
+import org.springframework.stereotype.Service;
+
+/**
+ * @program: D:/git/ms-data-circulation-portal-service
+ * @description: 服务商维护明细逻辑层接口实现
+ * @author: xcq
+ * @create: 2024-12-31 18:52
+ **/
+@Service
+public class MfServicerMaintainDetailServiceImpl extends CsbrServiceImpl<MfServicerMaintainDetailMapper, MfServicerMaintainDetail> implements MfServicerMaintainDetailService {
+
+    @Resource
+    private MfServicerMaintainDetailMapper mfServicerMaintainDetailMapper;
+    
+}

+package com.csbr.qingcloud.portal.mybatis.service.impl;
+
+import com.csbr.cloud.mybatis.service.impl.CsbrServiceImpl;
+import com.csbr.qingcloud.portal.mybatis.mapper.MfServicerMaintainMapper;
+import com.csbr.qingcloud.portal.mybatis.entity.MfServicerMaintain;
+import com.csbr.qingcloud.portal.mybatis.service.MfServicerMaintainService;
+import jakarta.annotation.Resource;
+import org.springframework.stereotype.Service;
+
+/**
+ * @program: D:/git/ms-data-circulation-portal-service
+ * @description: 服务商维护逻辑层接口实现
+ * @author: xcq
+ * @create: 2024-12-31 18:49
+ **/
+@Service
+public class MfServicerMaintainServiceImpl extends CsbrServiceImpl<MfServicerMaintainMapper, MfServicerMaintain> implements MfServicerMaintainService {
+
+    @Resource
+    private MfServicerMaintainMapper mfServicerMaintainMapper;
+    
+}

+package com.csbr.qingcloud.portal.service;
+
+import csbr.cloud.entity.domain.base.vo.PageListVO;
+import com.csbr.cloud.workflow.domain.dto.callback.BizCallbackDTO;
+import com.csbr.cloud.workflow.domain.vo.appove.FlowRQBaseVO;
+import com.csbr.qingcloud.portal.domain.vo.ServicerMaintainQueryVO;
+import com.csbr.qingcloud.portal.domain.vo.ServicerMaintainRSVO;
+
+import java.util.List;
+
+/**
+ * @program: D:/git/ms-data-circulation-portal-service
+ * @description: 服务商维护业务逻辑接口
+ * @author: xcq
+ * @create: 2024-12-31 18:49
+ **/
+public interface ServicerMaintainService {
+
+    /**
+     * 服务商维护分页查询
+     * @author xcq
+     * @date 2024-12-31 18:49
+     * @param queryVO
+     * @return com.csbr.cloud.mybatis.entity.PageListVO<com.csbr.qingcloud.portal.domain.vo.ServicerMaintainRSVO>
+     */
+    PageListVO<ServicerMaintainRSVO> pageList(ServicerMaintainQueryVO queryVO);
+
+    /**
+     * 服务商维护获取详情数据
+     * @author xcq
+     * @date 2024-12-31 18:49
+     * @param guid
+     * @return com.csbr.qingcloud.portal.domain.vo.ServicerMaintainRSVO
+     */
+    ServicerMaintainRSVO getServicerMaintainDetail(String guid);
+
+    /**
+     * 服务商维护数据新增
+     * @author xcq
+     * @date 2024-12-31 18:49
+     * @param flowBaseVO
+     * @return void
+     */
+    void saveServicerMaintain(FlowRQBaseVO flowBaseVO);
+
+    /**
+     * 服务商维护数据修改
+     * @author xcq
+     * @date 2024-12-31 18:49
+     * @param flowBaseVO
+     * @return void
+     */
+    void updateServicerMaintain(FlowRQBaseVO flowBaseVO);
+
+    /**
+     * 服务商维护数据删除、并有相关的处理操作
+     * @author xcq
+     * @date 2024-12-31 18:49
+     * @param guids
+     * @return void
+     */
+    void removeByGuids(List<String> guids);
+    
+    /**
+     * 流程结束后进行业务回调
+     * @author xcq
+     * @date 2024-12-31 18:49
+     * @param dto
+     * @return void
+     */
+    void flowCallBack(BizCallbackDTO dto);
+    
+}