改造变更登记增减代码注释

amos-boot-system-tzs/amos-boot-module-jg/amos-boot-module-jg-api/src/main/java/com/yeejoin/amos/boot/module/jg/api/service/IJgChangeRegistrationReformService.java

@@ -19,12 +19,64 @@ import java.util.Map;
  * @date 2023-12-20
  */
 public interface IJgChangeRegistrationReformService {
+    /**
+     *
+     * @param dto
+     * @param page
+     * @param roleIds
+     * @return
+     */
     Page<Map<String, Object>> getList(JgChangeRegistrationReformDto dto, Page<Map<String, Object>> page, List<String> roleIds);
+
+    /**
+     * @deprecated 保存数据-根据入参判断是暂存还是执行流程
+     * @param map
+     * @return
+     */
     List<Map<String, Object>> save(JSONObject map);
+
+    /**
+     * @deprecated 根据流程执行情况推动工作流或者
+     * @param instanceId
+     * @param jgChangeRegistrationReform
+     * @param operate
+     * @param processTaskDTO
+     */
     void updateExecuteIds(String instanceId, JgChangeRegistrationReform jgChangeRegistrationReform, String operate, ProcessTaskDTO processTaskDTO);
+
+    /**
+     * @deprecated 流程执行
+     * @param id
+     * @param instanceId
+     * @param operate
+     * @param comment
+     */
     void flowExecute(Long id, String instanceId, String operate, String comment);
+
+    /**
+     * @deprecated 根据流程id执行撤回操作
+     * @param instanceId
+     */
     void withdraw(String instanceId);
+
+    /**
+     * @deprecated 根据id批量删除数据
+     * @param ids
+     */
     void deleteBatch(List<Long> ids);
+
+    /**
+     * @deprecated 根据当前的数据id获取详情
+     * @param currentDocumentId
+     * @param equipId
+     * @return
+     */
     Map<String, Object> getDetail(String currentDocumentId, String equipId);
+
+    /**
+     * @deprecated 根据当前的数据id导出使用登记证
+     * @param sequenceNbr
+     * @param response
+     */
     void exportUseRegistrationCertificate(String sequenceNbr, HttpServletResponse response);
 }

amos-boot-system-tzs/amos-boot-module-jg/amos-boot-module-jg-biz/src/main/java/com/yeejoin/amos/boot/module/jg/biz/service/impl/JgChangeRegistrationReformServiceImpl.java

@@ -32,7 +32,6 @@ import org.springframework.beans.BeanUtils;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.transaction.annotation.Transactional;
 import org.springframework.util.ObjectUtils;
-import org.springframework.util.StringUtils;
 import org.typroject.tyboot.core.foundation.context.RequestContext;
 import org.typroject.tyboot.core.foundation.utils.ValidationUtil;
 import org.typroject.tyboot.core.rdbms.service.BaseService;
@@ -108,18 +107,18 @@ public class JgChangeRegistrationReformServiceImpl extends BaseService<JgChangeR
     @Autowired
     private JgChangeRegistrationNameEqMapper jgChangeRegistrationNameEqMapper;
 
-    /**
-     * 分页查询
+    /***
+     * @deprecated  根据查询调教获取分页对象
+     * @param dto 查询的dto对象
+     * @param page 分页对象
+     * @param roleIds 当前登陆人的角色id值
+     * @return
      */
     public Page<Map<String, Object>> getList(JgChangeRegistrationReformDto dto, Page<Map<String, Object>> page, List<String> roleIds) {
         Page<Map<String, Object>> listPage = this.baseMapper.getListPage(page, dto, roleIds);
         return listPage;
     }
 
-    public Page<Map<String, Object>> getEquipList(Page<Map<String, Object>> page, String factoryNum, String equList, String equCategory) {
-        return this.baseMapper.getEquipListPage(page, factoryNum, equList, equCategory);
-    }
-
     @Transactional
     public List<Map<String, Object>> save(JSONObject map) {
         ReginParams reginParams = JSONObject.parseObject(redisUtils.get(RedisKey.buildReginKey(RequestContext.getExeUserId(), RequestContext.getToken())).toString(), ReginParams.class);
@@ -653,8 +652,7 @@ public class JgChangeRegistrationReformServiceImpl extends BaseService<JgChangeR
     }
 
     /**
-     * 参数为监管码
-     *
+     * @deprecated 根据监管码或者新的使用登记编码
      * @param supervisoryCode
      * @return
      */
@@ -892,7 +890,12 @@ public class JgChangeRegistrationReformServiceImpl extends BaseService<JgChangeR
         return taskMessageDto;
     }
 
-
+    /**
+     * @deprecated 根据流程执行情况获取下一步执行公司code用于工作流过滤人员
+     * @param operate
+     * @param jgChangeRegistrationReform
+     * @return
+     */
     private String getNextUserOrgCode(String operate, JgChangeRegistrationReform jgChangeRegistrationReform) {
         if ("0".equals(operate)) {
             // 执行通过节点，单位code为接收机构单位信息