Merge branch 'refs/heads/dev' into test

zt-module-base/zt-module-base-api/src/main/java/com/zt/plat/module/tmpltp/enums/ErrorCodeConstants.java

@@ -5,6 +5,7 @@ import com.zt.plat.framework.common.exception.ErrorCode;
 public interface ErrorCodeConstants {
 
     // ========== 示例模块 1-001-000-000 ==========
+    //模块 base 错误码区间[1-027-000-000 ~1-028-000-000)
     ErrorCode TMPL_TP_NOT_EXISTS = new ErrorCode(1_027_000_500, "模板分类不存在");
     ErrorCode TMPL_FLD_NOT_EXISTS = new ErrorCode(1_027_000_501, "模板字段不存在");
     ErrorCode TMPL_FLD_CODE_EXISTS = new ErrorCode(1_027_000_502, "字段编码已存在");

zt-module-base/zt-module-base-server/src/main/java/com/zt/plat/module/base/controller/admin/base/vo/AccountPageReqVO.java

@@ -1,7 +1,9 @@
 package com.zt.plat.module.base.controller.admin.base.vo;
 
+import com.alibaba.excel.annotation.ExcelProperty;
 import com.zt.plat.framework.common.pojo.PageParam;
 import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotEmpty;
 import lombok.Data;
 import org.springframework.format.annotation.DateTimeFormat;
 
@@ -41,4 +43,10 @@ public class AccountPageReqVO extends PageParam {
     @Schema(description = "客商公司名称")
     private String customerName;
 
+    @Schema(description = "地址")
+    private String address;
+
+    @Schema(description = "电话")
+    private String phone;
+
 }

zt-module-base/zt-module-base-server/src/main/java/com/zt/plat/module/base/controller/admin/base/vo/AccountRespVO.java

@@ -52,4 +52,12 @@ public class AccountRespVO {
     @ExcelProperty("客商公司名称")
     private String customerName;
 
+    @Schema(description = "地址")
+    @ExcelProperty("地址")
+    private String address;
+
+    @Schema(description = "电话")
+    @ExcelProperty("电话")
+    private String phone;
+
 }

zt-module-base/zt-module-base-server/src/main/java/com/zt/plat/module/base/controller/admin/base/vo/AccountSaveReqVO.java

@@ -33,7 +33,6 @@ public class AccountSaveReqVO {
     private String taxNumber;
 
     @Schema(description = "是否启用")
-    @ExcelProperty("是否启用")
     private String isEnable;
 
     @Schema(description = "客商公司编码", requiredMode = Schema.RequiredMode.REQUIRED)
@@ -43,4 +42,10 @@ public class AccountSaveReqVO {
     @Schema(description = "客商公司名称", requiredMode = Schema.RequiredMode.REQUIRED)
     @NotEmpty(message = "客商公司名称不能为空")
     private String customerName;
+
+    @Schema(description = "地址")
+    private String address;
+
+    @Schema(description = "电话")
+    private String phone;
 }

zt-module-base/zt-module-base-server/src/main/java/com/zt/plat/module/base/controller/admin/base/vo/CompanyRelativityPageReqVO.java

@@ -32,7 +32,7 @@ public class CompanyRelativityPageReqVO extends PageParam {
     @Schema(description = "负责人")
     private String manager;
 
-    @Schema(description = "部门来源")
+    @Schema(description = "部门来源(字典编码：sply_cpn_rel_sts)(1:外部部门;2:同步部门;)", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
     private String departmentSource;
 
 }

zt-module-base/zt-module-base-server/src/main/java/com/zt/plat/module/base/dal/dataobject/base/AccountDO.java

@@ -2,6 +2,7 @@ package com.zt.plat.module.base.dal.dataobject.base;
 
 import com.baomidou.mybatisplus.annotation.*;
 import com.zt.plat.framework.mybatis.core.dataobject.BusinessBaseDO;
+import io.swagger.v3.oas.annotations.media.Schema;
 import lombok.*;
 /**
 * 账户条款 DO
@@ -102,4 +103,10 @@ public class AccountDO extends BusinessBaseDO {
     @TableField("UPDATER_NAME")
     private String updaterName;
 
+    @TableField("ADDRESS")
+    private String address;
+
+    @TableField("PHONE")
+    private String phone;
+
 }

zt-module-base/zt-module-base-server/src/main/java/com/zt/plat/module/base/dal/mysql/base/AccountMapper.java

@@ -19,6 +19,8 @@ public interface AccountMapper extends BaseMapperX<AccountDO> {
         return selectPage(reqVO, new LambdaQueryWrapperX<AccountDO>()
                 .eqIfPresent(AccountDO::getType, reqVO.getType())
                 .likeIfPresent(AccountDO::getAccountName, reqVO.getAccountName())
+                .likeIfPresent(AccountDO::getAddress, reqVO.getAddress())
+                .likeIfPresent(AccountDO::getPhone, reqVO.getPhone())
                 .eqIfPresent(AccountDO::getBankAccount, reqVO.getBankAccount())
                 .eqIfPresent(AccountDO::getCustomerName, reqVO.getCustomerName())
                 .eqIfPresent(AccountDO::getCustomerNumber, reqVO.getCustomerNumber())

zt-module-base/zt-module-base-server/src/main/java/com/zt/plat/module/base/service/tmpltp/TemplateInstanceDataService.java

@@ -80,6 +80,12 @@ public interface TemplateInstanceDataService {
      */
     boolean clearTemplateInstanceData(String instanceId,List<Long> valIds);
 
+    /**
+     * 批量创建实例字段值
+     *
+     * @param createReqVOS 创建参数
+     * @return 实例字段值
+     */
     List<TemplateInstanceDataRespVO>  createBatchTemplateInstanceData(List<TemplateInstanceDataSaveReqVO> createReqVOS);
 
 }

zt-module-base/zt-module-base-server/src/main/java/com/zt/plat/module/base/service/tmpltp/TemplateInstanceItemService.java

@@ -63,5 +63,11 @@ public interface TemplateInstanceItemService {
      */
     PageResult<TemplateInstanceItemDO> getTemplateInstanceItemPage(@Valid TemplateInstanceItemPageReqVO pageReqVO);
 
+    /**
+    * 批量创建实例条款值
+    *
+    * @param createReqVOS 创建信息
+    * @return 批量创建结果
+    */
     List<TemplateInstanceItemRespVO> createBatchTemplateInstanceItem(@Valid List<TemplateInstanceItemSaveReqVO> createReqVOS);
 }

zt-module-base/zt-module-base-server/src/main/java/com/zt/plat/module/base/service/tmpltp/TemplateInstanceService.java

@@ -61,10 +61,26 @@ public interface TemplateInstanceService {
      */
     PageResult<TemplateInstanceDO> getTemplateInstancePage(TemplateInstancePageReqVO pageReqVO);
 
+    /**
+     * 通过实例id获得部门
+     *
+     * @param instanId
+     * @return 获取部门
+     */
     List<String> getDeptByInstanId(Long instanId);
 
+    /**
+     * 发布模板实例
+     *
+     * @param publishReqVOS 发布参数
+     */
     void publishTemplateInstance(List<PublishTemplateInstanceReqVO> publishReqVOS);
 
+    /**
+     * 获取模板实例详情
+     *
+     * @param templateInstanceRespVO 模板实例详情
+     */
     void getDetailedInfo(TemplateInstanceRespVO templateInstanceRespVO);
     /**
      * 获得模板实例分页排除停用状态的
@@ -74,17 +90,49 @@ public interface TemplateInstanceService {
      */
     PageResult<TemplateInstanceDO> listExcludingDisabled(@Valid TemplateInstancePageReqVO pageReqVO);
 
+    /**
+     * 停用启用
+     *
+     * @param reqVO 停用启用参数
+     */
     void setDisableOrEnable(@Valid DisableEnableReqVO reqVO);
 
+    /**
+     * 创建版本
+     *
+     * @param id 模版实例id
+     * @return 创建结果
+     */
     TemplateInstanceRespVO createVersion(@Valid @NotEmpty(message = "模版实例id不能为空") String id);
 
+    /**
+     * 获取版本
+     *
+     * @param id 模版实例id
+     * @return 获取结果
+     */
     Map<String, Object> getVersion(String id);
 
+    /**
+     * 通过模版编码获取模版实例
+     *
+     * @param cdg 模版编码
+     * @return 获取结果
+     */
     List<TemplateInstanceRespVO> listByCdg(String cdg);
 //
 //    Map<String, Object> saveFile(MultipartFile file, String id);
 
+    /**
+     * 通过实例id，更新文件对象
+     * @param id params
+     *
+     */
     void updateTemplateInstanceFileUrlByInstanceId(@Valid @NotEmpty(message = "模版实例id不能为空") String id, @Valid @NotEmpty(message = "文件参数不能为空") String params);
-
+    /**
+     * 获取字段和条款详情
+     * @param id 模版实例id
+     * @return 获取结果
+     */
     FieldAndClauseRespVO getFieldAndClauseDetail(@Valid @NotEmpty(message = "模版实例id不能为空") String id);
 }