【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.EnterpriseQueryVO;
+import com.csbr.qingcloud.portal.domain.vo.EnterpriseRQVO;
+import com.csbr.qingcloud.portal.domain.vo.EnterpriseRSVO;
+import com.csbr.qingcloud.portal.service.EnterpriseService;
+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-26 16:18
+ **/
+@RestController
+@RequestMapping("/enterprise")
+@Tag(name = "企业信息-控制器")
+public class EnterpriseController {
+    
+    @Resource
+    private EnterpriseService enterpriseService;
+    
+    //region 基本操作
+
+    @PostMapping("/save")
+    @SystemLog(value = "企业信息-新增")
+    @Operation(summary = "企业信息-新增")
+    public CommonRes<Boolean> saveEnterprise(@RequestBody @Valid EnterpriseRQVO vo) {
+        enterpriseService.saveEnterprise(vo);
+        return CommonRes.success(true);
+    }
+
+    @PutMapping("/update")
+    @SystemLog(value = "企业信息-修改")
+    @Operation(summary = "企业信息-修改")
+    public CommonRes<Boolean> updateEnterprise(@RequestBody @Valid EnterpriseRQVO vo) {
+        enterpriseService.updateEnterprise(vo);
+        return CommonRes.success(true);
+    }
+    
+    @DeleteMapping("/delete")
+    @SystemLog(value = "企业信息-批量删除")
+    @Operation(summary = "企业信息-批量删除")
+    public CommonRes<Boolean> removeByGuids(@RequestBody List<String> guids) {
+        enterpriseService.removeByGuids(guids);
+        return CommonRes.success(true);
+    }
+
+    @PostMapping("/page-list")
+    @SystemLog(value = "企业信息-分页")
+    @Operation(summary = "企业信息-分页")
+    public CommonRes<PageListVO<EnterpriseRSVO>> pageList(@RequestBody @Valid EnterpriseQueryVO queryVO) {
+        PageListVO<EnterpriseRSVO> pageVO = enterpriseService.pageList(queryVO);
+        return CommonRes.success(pageVO);
+     }
+     
+    @GetMapping("/detail")
+    @SystemLog(value = "企业信息-详情")
+    @Operation(
+            summary = "企业信息-详情",
+            parameters = {
+                    @Parameter(name = "guid", description = "企业信息唯一标识", required = true)}
+    )
+    public CommonRes<EnterpriseRSVO> getEnterpriseDetail(@RequestParam String guid) {
+        EnterpriseRSVO vo = enterpriseService.getEnterpriseDetail(guid);
+        return CommonRes.success(vo);
+    }
+
+    @PostMapping("/flow-call-back")
+    @SystemLog(value = "企业信息-流程结束后进行业务回调")
+    @Operation(summary = "企业信息-流程结束后进行业务回调", hidden = true)
+    public CommonRes<Boolean> flowCallBack(@RequestBody @Valid BizCallbackDTO dto) {
+        enterpriseService.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.math.BigDecimal;
+import java.util.Date;
+import java.util.List;
+
+/**
+ * @program: D:/git/ms-data-circulation-portal-service
+ * @description: 企业信息查询参数
+ * @author: xcq
+ * @create: 2024-12-26 16:18
+ **/
+@EqualsAndHashCode(callSuper = true)
+@Data
+@Schema(title = "企业信息查询参数")
+public class EnterpriseQueryVO 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.math.BigDecimal;
+import java.util.Date;
+
+/**
+ * @program: D:/git/ms-data-circulation-portal-service
+ * @description: 企业信息新增、修改参数
+ * @author: xcq
+ * @create: 2024-12-26 16:18
+ **/
+@Data
+@Schema(title = "企业信息新增、修改参数")
+public class EnterpriseRQVO extends FlowRQBaseVO {
+    
+    /**
+     * 公司名称
+     */
+    @Schema(description = "公司名称")
+    private String tenantName;
+    
+    /**
+     * 统一社会信用代码
+     */
+    @Schema(description = "统一社会信用代码")
+    private String socialCreditCode;
+    
+    /**
+     * 企业类型【选择平台字典【公司类型】的选项】
+     */
+    @Schema(description = "企业类型【选择平台字典【公司类型】的选项】")
+    private String tenantType;
+    
+    /**
+     * 注册日期
+     */
+    @Schema(description = "注册日期")
+    @JsonFormat(pattern = "yyyy-MM-dd", timezone = "GMT+8")
+    private Date registrationDate;
+    
+    /**
+     * 注册资本【(万元)】
+     */
+    @Schema(description = "注册资本【(万元)】")
+    private BigDecimal registeredCapital;
+    
+    /**
+     * 税号
+     */
+    @Schema(description = "税号")
+    private String bankTaxNo;
+    
+    /**
+     * 省
+     */
+    @Schema(description = "省")
+    private String province;
+    
+    /**
+     * 市
+     */
+    @Schema(description = "市")
+    private String city;
+    
+    /**
+     * 区
+     */
+    @Schema(description = "区")
+    private String district;
+    
+    /**
+     * 营业期限【1 长期有效；2 自定义】
+     */
+    @Schema(description = "营业期限【1 长期有效；2 自定义】")
+    private String businessLicenseTerm;
+    
+    /**
+     * 营业开始日期
+     */
+    @Schema(description = "营业开始日期")
+    @JsonFormat(pattern = "yyyy-MM-dd", timezone = "GMT+8")
+    private Date businessLicenseStartDate;
+    
+    /**
+     * 营业结束日期
+     */
+    @Schema(description = "营业结束日期")
+    @JsonFormat(pattern = "yyyy-MM-dd", timezone = "GMT+8")
+    private Date businessLicenseEndDate;
+    
+    /**
+     * 营业执照
+     */
+    @Schema(description = "营业执照")
+    private String businessLicenseJson;
+    
+    /**
+     * 营业执照经营范围
+     */
+    @Schema(description = "营业执照经营范围")
+    private String businessLicenseScope;
+    
+    /**
+     * 公司法人
+     */
+    @Schema(description = "公司法人")
+    private String juridicalPerson;
+    
+    /**
+     * 法人证件类型
+     */
+    @Schema(description = "法人证件类型")
+    private String juridicalPersonIdType;
+    
+    /**
+     * 法人证件号
+     */
+    @Schema(description = "法人证件号")
+    private String juridicalPersonId;
+    
+    /**
+     * 法人证件照
+     */
+    @Schema(description = "法人证件照")
+    private String juridicalPersonIdPhotoJson;
+    
+    /**
+     * 登录账号
+     */
+    @Schema(description = "登录账号")
+    private String logonUser;
+    
+    /**
+     * 联系人
+     */
+    @Schema(description = "联系人")
+    private String contacts;
+    
+    /**
+     * 联系人电话
+     */
+    @Schema(description = "联系人电话")
+    private String contactTel;
+    
+    /**
+     * 管理员证件号
+     */
+    @Schema(description = "管理员证件号")
+    private String managerPersonId;
+    
+    /**
+     * 管理员证件照
+     */
+    @Schema(description = "管理员证件照")
+    private String managerPersonIdPhotoJson;
+    
+    /**
+     * 授权委托书
+     */
+    @Schema(description = "授权委托书")
+    private String authorizationLetter;
+    
+    /**
+     * 业务审批状态【N 草稿中，A 审批中，Y 已通过，R 驳回，C 已撤销，D 已废弃； 默认 N】
+     */
+    @Schema(description = "业务审批状态【N 草稿中，A 审批中，Y 已通过，R 驳回，C 已撤销，D 已废弃； 默认 N】")
+    private String bizApproveState;
+    
+    /******** 库表存储属性 需处理 *****/
+    
+    /******** 自定义扩展 *****/
+    
+    /******** 子对象 *****/
+    
+}

+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.math.BigDecimal;
+import java.util.Date;
+
+/**
+ * @program: D:/git/ms-data-circulation-portal-service
+ * @description: 企业信息返回参数
+ * @author: xcq
+ * @create: 2024-12-26 16:18
+ **/
+@Data
+@Schema(title = "企业信息返回参数")
+public class EnterpriseRSVO {
+    
+    /**
+     * 系统唯一标识
+     */
+    @Schema(description = "系统唯一标识")
+    private String guid;
+    
+    /**
+     * 公司名称
+     */
+    @Schema(description = "公司名称")
+    private String tenantName;
+    
+    /**
+     * 统一社会信用代码
+     */
+    @Schema(description = "统一社会信用代码")
+    private String socialCreditCode;
+    
+    /**
+     * 企业类型【选择平台字典【公司类型】的选项】
+     */
+    @Schema(description = "企业类型【选择平台字典【公司类型】的选项】")
+    private String tenantType;
+    
+    /**
+     * 注册日期
+     */
+    @Schema(description = "注册日期")
+    @JsonFormat(pattern = "yyyy-MM-dd", timezone = "GMT+8")
+    private Date registrationDate;
+    
+    /**
+     * 注册资本【(万元)】
+     */
+    @Schema(description = "注册资本【(万元)】")
+    private BigDecimal registeredCapital;
+    
+    /**
+     * 税号
+     */
+    @Schema(description = "税号")
+    private String bankTaxNo;
+    
+    /**
+     * 省
+     */
+    @Schema(description = "省")
+    private String province;
+    
+    /**
+     * 市
+     */
+    @Schema(description = "市")
+    private String city;
+    
+    /**
+     * 区
+     */
+    @Schema(description = "区")
+    private String district;
+    
+    /**
+     * 营业期限【1 长期有效；2 自定义】
+     */
+    @Schema(description = "营业期限【1 长期有效；2 自定义】")
+    private String businessLicenseTerm;
+    
+    /**
+     * 营业开始日期
+     */
+    @Schema(description = "营业开始日期")
+    @JsonFormat(pattern = "yyyy-MM-dd", timezone = "GMT+8")
+    private Date businessLicenseStartDate;
+    
+    /**
+     * 营业结束日期
+     */
+    @Schema(description = "营业结束日期")
+    @JsonFormat(pattern = "yyyy-MM-dd", timezone = "GMT+8")
+    private Date businessLicenseEndDate;
+    
+    /**
+     * 营业执照
+     */
+    @Schema(description = "营业执照")
+    private String businessLicenseJson;
+    
+    /**
+     * 营业执照经营范围
+     */
+    @Schema(description = "营业执照经营范围")
+    private String businessLicenseScope;
+    
+    /**
+     * 公司法人
+     */
+    @Schema(description = "公司法人")
+    private String juridicalPerson;
+    
+    /**
+     * 法人证件类型
+     */
+    @Schema(description = "法人证件类型")
+    private String juridicalPersonIdType;
+    
+    /**
+     * 法人证件号
+     */
+    @Schema(description = "法人证件号")
+    private String juridicalPersonId;
+    
+    /**
+     * 法人证件照
+     */
+    @Schema(description = "法人证件照")
+    private String juridicalPersonIdPhotoJson;
+    
+    /**
+     * 登录账号
+     */
+    @Schema(description = "登录账号")
+    private String logonUser;
+    
+    /**
+     * 联系人
+     */
+    @Schema(description = "联系人")
+    private String contacts;
+    
+    /**
+     * 联系人电话
+     */
+    @Schema(description = "联系人电话")
+    private String contactTel;
+    
+    /**
+     * 管理员证件号
+     */
+    @Schema(description = "管理员证件号")
+    private String managerPersonId;
+    
+    /**
+     * 管理员证件照
+     */
+    @Schema(description = "管理员证件照")
+    private String managerPersonIdPhotoJson;
+    
+    /**
+     * 授权委托书
+     */
+    @Schema(description = "授权委托书")
+    private String authorizationLetter;
+    
+    /**
+     * 业务审批状态【N 草稿中，A 审批中，Y 已通过，R 驳回，C 已撤销，D 已废弃； 默认 N】
+     */
+    @Schema(description = "业务审批状态【N 草稿中，A 审批中，Y 已通过，R 驳回，C 已撤销，D 已废弃； 默认 N】")
+    private String bizApproveState;
+    
+    /******** 库表存储属性 需处理 *****/
+    
+    /******** 自定义扩展 *****/
+    
+    /**
+     * 审批信息
+     */
+    @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.math.BigDecimal;
+import java.util.Date;
+
+/**
+ * @program: D:/git/ms-data-circulation-portal-service
+ * @description: 企业信息实体
+ * @author: xcq
+ * @create: 2024-12-26 16:18
+ **/
+@Data
+@EqualsAndHashCode(callSuper = true)
+@Accessors(chain = true)
+@Name("企业信息")
+public class MfEnterprise extends BaseDO {
+    
+    /**
+    * 公司名称
+    */
+    @Name("公司名称")
+    private String tenantName;
+    
+    /**
+    * 统一社会信用代码
+    */
+    @Name("统一社会信用代码")
+    private String socialCreditCode;
+    
+    /**
+    * 企业类型【选择平台字典【公司类型】的选项】
+    */
+    @Name("企业类型【选择平台字典【公司类型】的选项】")
+    private String tenantType;
+    
+    /**
+    * 注册日期
+    */
+    @Name("注册日期")
+    private Date registrationDate;
+    
+    /**
+    * 注册资本【(万元)】
+    */
+    @Name("注册资本【(万元)】")
+    private BigDecimal registeredCapital;
+    
+    /**
+    * 税号
+    */
+    @Name("税号")
+    private String bankTaxNo;
+    
+    /**
+    * 省
+    */
+    @Name("省")
+    private String province;
+    
+    /**
+    * 市
+    */
+    @Name("市")
+    private String city;
+    
+    /**
+    * 区
+    */
+    @Name("区")
+    private String district;
+    
+    /**
+    * 营业期限【1 长期有效；2 自定义】
+    */
+    @Name("营业期限【1 长期有效；2 自定义】")
+    private String businessLicenseTerm;
+    
+    /**
+    * 营业开始日期
+    */
+    @Name("营业开始日期")
+    private Date businessLicenseStartDate;
+    
+    /**
+    * 营业结束日期
+    */
+    @Name("营业结束日期")
+    private Date businessLicenseEndDate;
+    
+    /**
+    * 营业执照
+    */
+    @Name("营业执照")
+    @TableField(updateStrategy = FieldStrategy.ALWAYS)
+    private String businessLicenseJson;
+    
+    /**
+    * 营业执照经营范围
+    */
+    @Name("营业执照经营范围")
+    private String businessLicenseScope;
+    
+    /**
+    * 公司法人
+    */
+    @Name("公司法人")
+    private String juridicalPerson;
+    
+    /**
+    * 法人证件类型
+    */
+    @Name("法人证件类型")
+    private String juridicalPersonIdType;
+    
+    /**
+    * 法人证件号
+    */
+    @Name("法人证件号")
+    private String juridicalPersonId;
+    
+    /**
+    * 法人证件照
+    */
+    @Name("法人证件照")
+    @TableField(updateStrategy = FieldStrategy.ALWAYS)
+    private String juridicalPersonIdPhotoJson;
+    
+    /**
+    * 登录账号
+    */
+    @Name("登录账号")
+    private String logonUser;
+    
+    /**
+    * 联系人
+    */
+    @Name("联系人")
+    private String contacts;
+    
+    /**
+    * 联系人电话
+    */
+    @Name("联系人电话")
+    private String contactTel;
+    
+    /**
+    * 管理员证件号
+    */
+    @Name("管理员证件号")
+    private String managerPersonId;
+    
+    /**
+    * 管理员证件照
+    */
+    @Name("管理员证件照")
+    @TableField(updateStrategy = FieldStrategy.ALWAYS)
+    private String managerPersonIdPhotoJson;
+    
+    /**
+    * 授权委托书
+    */
+    @Name("授权委托书")
+    private String authorizationLetter;
+    
+    /**
+    * 业务审批状态【N 草稿中，A 审批中，Y 已通过，R 驳回，C 已撤销，D 已废弃； 默认 N】
+    */
+    @Name("业务审批状态【N 草稿中，A 审批中，Y 已通过，R 驳回，C 已撤销，D 已废弃； 默认 N】")
+    private String bizApproveState;
+
+}

+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.MfEnterprise;
+
+/**
+ * @program: D:/git/ms-data-circulation-portal-service
+ * @description: 企业信息 Mapper 接口
+ * @author: xcq
+ * @create: 2024-12-26 16:18
+ **/
+@Mapper
+public interface MfEnterpriseMapper extends BaseMapper<MfEnterprise> {
+    
+}

+package com.csbr.qingcloud.portal.mybatis.service;
+
+import com.csbr.cloud.base.service.CsbrService;
+import com.csbr.qingcloud.portal.mybatis.entity.MfEnterprise;
+
+/**
+ * @program: D:/git/ms-data-circulation-portal-service
+ * @description: 企业信息逻辑层接口
+ * @author: xcq
+ * @create: 2024-12-26 16:18
+ **/
+public interface MfEnterpriseService extends CsbrService<MfEnterprise> {
+    
+}

+package com.csbr.qingcloud.portal.mybatis.service.impl;
+
+import com.csbr.cloud.mybatis.service.impl.CsbrServiceImpl;
+import com.csbr.qingcloud.portal.mybatis.mapper.MfEnterpriseMapper;
+import com.csbr.qingcloud.portal.mybatis.entity.MfEnterprise;
+import com.csbr.qingcloud.portal.mybatis.service.MfEnterpriseService;
+import jakarta.annotation.Resource;
+import org.springframework.stereotype.Service;
+
+/**
+ * @program: D:/git/ms-data-circulation-portal-service
+ * @description: 企业信息逻辑层接口实现
+ * @author: xcq
+ * @create: 2024-12-26 16:18
+ **/
+@Service
+public class MfEnterpriseServiceImpl extends CsbrServiceImpl<MfEnterpriseMapper, MfEnterprise> implements MfEnterpriseService {
+
+    @Resource
+    private MfEnterpriseMapper mfEnterpriseMapper;
+    
+}

+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.EnterpriseQueryVO;
+import com.csbr.qingcloud.portal.domain.vo.EnterpriseRSVO;
+
+import java.util.List;
+
+/**
+ * @program: D:/git/ms-data-circulation-portal-service
+ * @description: 企业信息业务逻辑接口
+ * @author: xcq
+ * @create: 2024-12-26 16:18
+ **/
+public interface EnterpriseService {
+
+    /**
+     * 企业信息分页查询
+     * @author xcq
+     * @date 2024-12-26 16:18
+     * @param queryVO
+     * @return com.csbr.cloud.mybatis.entity.PageListVO<com.csbr.qingcloud.portal.domain.vo.EnterpriseRSVO>
+     */
+    PageListVO<EnterpriseRSVO> pageList(EnterpriseQueryVO queryVO);
+
+    /**
+     * 企业信息获取详情数据
+     * @author xcq
+     * @date 2024-12-26 16:18
+     * @param guid
+     * @return com.csbr.qingcloud.portal.domain.vo.EnterpriseRSVO
+     */
+    EnterpriseRSVO getEnterpriseDetail(String guid);
+
+    /**
+     * 企业信息数据新增
+     * @author xcq
+     * @date 2024-12-26 16:18
+     * @param flowBaseVO
+     * @return void
+     */
+    void saveEnterprise(FlowRQBaseVO flowBaseVO);
+
+    /**
+     * 企业信息数据修改
+     * @author xcq
+     * @date 2024-12-26 16:18
+     * @param flowBaseVO
+     * @return void
+     */
+    void updateEnterprise(FlowRQBaseVO flowBaseVO);
+
+    /**
+     * 企业信息数据删除、并有相关的处理操作
+     * @author xcq
+     * @date 2024-12-26 16:18
+     * @param guids
+     * @return void
+     */
+    void removeByGuids(List<String> guids);
+    
+    /**
+     * 流程结束后进行业务回调
+     * @author xcq
+     * @date 2024-12-26 16:18
+     * @param dto
+     * @return void
+     */
+    void flowCallBack(BizCallbackDTO dto);
+    
+}