java doc 주석 추가

src/main/java/go/kr/project/crdn/crndRegistAndView/main/controller/CrdnRegistAndViewController.java

@@ -53,8 +53,9 @@ public class CrdnRegistAndViewController {
     private final CommonCodeService commonCodeService;
 
     /**
-     * 단속 목록 화면을 제공한다.
-     * @return 단속 목록 화면
+     * 단속 목록 화면을 제공하고, 검색 조건에 사용될 공통코드를 모델에 추가한다.
+     * @param model 뷰에 전달할 데이터를 담는 모델 객체
+     * @return 단속 목록 화면 경로
      */
     @GetMapping("/list.do")
     @Operation(summary = "단속 목록 화면", description = "단속 목록을 조회하는 화면을 제공합니다.")
@@ -291,7 +292,7 @@ public class CrdnRegistAndViewController {
      * 단속 상세 정보를 조회한다.
      * @param crdnYr 단속 연도
      * @param crdnNo 단속 번호
-     * @return 단속 상세 정보
+     * @return 조회된 단속 상세 정보 또는 오류 메시지를 담은 ResponseEntity 객체
      */
     @GetMapping("/selectOne.ajax")
     @Operation(summary = "단속 상세 조회", description = "특정 단속의 상세 정보를 조회합니다.")
@@ -321,7 +322,6 @@ public class CrdnRegistAndViewController {
      * @param crdnNo 단속 번호
      * @param crdnPrcsSttsCd 변경할 처리 상태 코드
      * @return 상태 업데이트 결과와 성공 상태를 담은 ResponseEntity 객체
-     * @throws Exception 업데이트 중 발생할 수 있는 예외
      */
     @Operation(summary = "단속 상태 업데이트", description = "단속의 처리 상태를 업데이트합니다.")
     @ApiResponses(value = {

src/main/java/go/kr/project/crdn/crndRegistAndView/main/controller/CrdnRelevyController.java

@@ -52,8 +52,11 @@ public class CrdnRelevyController {
 
     /**
      * 재부과 팝업 화면을 제공한다.
+     * @param srcCrdnYr 원본 단속 년도
+     * @param srcCrdnNo 원본 단속 번호
+     * @param mode 팝업 모드
      * @param model 모델
-     * @return 재부과 팝업 화면
+     * @return 재부과 팝업 화면 경로
      */
     @GetMapping("/relevyPopup.do")
     @Operation(summary = "재부과 팝업 화면", description = "재부과 등록을 위한 팝업 화면을 제공합니다.")
@@ -73,7 +76,7 @@ public class CrdnRelevyController {
      * 당해년도 재부과 중복 체크
      * @param crdnYr 단속 년도
      * @param crdnNo 단속 번호
-     * @return 당해년도 재부과 건수
+     * @return 중복된 재부과 정보가 담긴 ResponseEntity 객체
      */
     @GetMapping("/selectRelevyCheckOne.ajax")
     @Operation(summary = "당해년도 재부과 중복 체크", description = "해당 단속건이 당해년도 재부과를 이미 진행했는지 확인합니다.")
@@ -100,7 +103,7 @@ public class CrdnRelevyController {
      * 원본 단속 정보를 조회한다.
      * @param crdnYr 단속 년도
      * @param crdnNo 단속 번호
-     * @return 원본 단속 정보
+     * @return 원본 단속 정보가 담긴 ResponseEntity 객체
      */
     @GetMapping("/selectOrgCrdnInfo.ajax")
     @Operation(summary = "원본 단속 정보 조회", description = "재부과 대상이 되는 원본 단속 정보를 조회합니다.")
@@ -129,7 +132,7 @@ public class CrdnRelevyController {
     /**
      * 재부과를 저장한다.
      * @param relevyVO 재부과 정보
-     * @return 저장 결과
+     * @return 저장 결과가 담긴 ResponseEntity 객체
      */
     @PostMapping("/saveRelevy.ajax")
     @Operation(summary = "재부과 저장", description = "재부과 정보를 저장하고 새로운 단속 건을 생성합니다.")

src/main/java/go/kr/project/crdn/crndRegistAndView/main/mapper/CrdnRelevyMapper.java

@@ -22,10 +22,18 @@ import java.util.List;
 @Mapper
 public interface CrdnRelevyMapper {
 
-    // 재부과 대상 체크
+    /**
+     * 재부과 대상인지 확인한다.
+     * @param crdnRelevyVO 재부과 확인을 위한 정보
+     * @return 재부과 대상 정보
+     */
     CrdnRelevyVO selectRelevyCheckOne(CrdnRelevyVO crdnRelevyVO);
 
-    // 재부과 대상정보 조회
+    /**
+     * 재부과 대상 단속의 위치 정보를 조회한다.
+     * @param crdnRelevyVO 원본 단속 정보를 담은 VO
+     * @return 위치 정보
+     */
     CrdnRelevyVO selectCrdnPstnInfoOne(CrdnRelevyVO crdnRelevyVO);
 
     /**
@@ -44,8 +52,8 @@ public interface CrdnRelevyMapper {
     int insertCrdnBasicInfo(CrdnRelevyVO relevyVO);
 
     /**
-     * 신규 위치정보 ID.
-     * @return 신규 위치정보 ID.
+     * 다음 위치정보 ID를 조회한다. (seq_pstn_info_id)
+     * @return 신규 위치정보 ID
      */
     String selectNextPstnInfoId();
 
@@ -64,20 +72,20 @@ public interface CrdnRelevyMapper {
     int insertCrdnOwnrInfo(CrdnRelevyVO relevyVO);
 
     /**
-     * 신규 불법행위정보 ID.
-     * @return 신규 불법행위정보 ID.
+     * 다음 불법행위정보 ID를 조회한다. (seq_act_info_id)
+     * @return 신규 불법행위정보 ID
      */
     String selectNextActInfoId();
 
     /**
-     * 신규 조치 ID.
-     * @return 신규 조치 ID.
+     * 다음 조치정보 ID를 조회한다. (seq_actn_info_id)
+     * @return 신규 조치정보 ID
      */
     String selectNextActnInfoId();
 
     /**
-     * 신규 행위자 ID.
-     * @return 신규 행위자 ID.
+     * 다음 행위자정보 ID를 조회한다. (seq_actr_info_id)
+     * @return 신규 행위자정보 ID
      */
     String selectNextActrInfoId();
 

src/main/java/go/kr/project/crdn/crndRegistAndView/main/service/CrdnRelevyService.java

@@ -18,9 +18,11 @@ import java.util.Map;
  */
 public interface CrdnRelevyService {
 
-    /*
-    * 재부과 대상 원본 조회
-    * */
+    /**
+     * 재부과 대상 원본 단속 정보를 조회한다.
+     * @param crdnRelevyVO 원본 단속 정보(crdnYr, crdnNo)
+     * @return 원본 단속의 위치 및 소유자 정보
+     */
     CrdnRelevyVO selectCrdnPstnInfoOne(CrdnRelevyVO crdnRelevyVO);
 
     /**

src/main/java/go/kr/project/crdn/crndRegistAndView/main/service/impl/CrdnImpltTaskServiceImpl.java

@@ -49,6 +49,11 @@ public class CrdnImpltTaskServiceImpl extends EgovAbstractServiceImpl implements
 
     // ==================== 이행정보 관련 메서드 ====================
 
+    /**
+     * 이행정보 및 관련 이행 대상자 목록을 조회한다.
+     * @param vo 조회할 이행정보 조건 (crdnYr, crdnNo, impltTaskSeCd)
+     * @return 이행정보 및 이행 대상자 목록
+     */
     @Override
     public CrdnImpltTaskVO selectImpltInfo(CrdnImpltTaskVO vo) {
         log.debug("이행정보 조회 시작 - 단속연도: {}, 단속번호: {}, 이행업무구분코드: {}", 
@@ -76,6 +81,11 @@ public class CrdnImpltTaskServiceImpl extends EgovAbstractServiceImpl implements
         }
     }
 
+    /**
+     * 이행정보 및 관련 이행 대상자 목록을 등록한다.
+     * @param vo 등록할 이행정보
+     * @return 등록된 행의 수
+     */
     @Override
     @Transactional(rollbackFor = Exception.class)
     public int insertImpltInfo(CrdnImpltTaskVO vo) {
@@ -127,6 +137,11 @@ public class CrdnImpltTaskServiceImpl extends EgovAbstractServiceImpl implements
 
     }
 
+    /**
+     * 이행정보 및 관련 이행 대상자 목록을 수정한다.
+     * @param vo 수정할 이행정보
+     * @return 수정된 행의 수
+     */
     @Override
     @Transactional(rollbackFor = Exception.class)
     public int updateImpltInfo(CrdnImpltTaskVO vo) {
@@ -172,6 +187,11 @@ public class CrdnImpltTaskServiceImpl extends EgovAbstractServiceImpl implements
 
     }
 
+    /**
+     * 이행정보 및 관련 이행 대상자 목록을 삭제한다.
+     * @param vo 삭제할 이행정보
+     * @return 삭제된 행의 수
+     */
     @Override
     @Transactional(rollbackFor = Exception.class)
     public int deleteImpltInfo(CrdnImpltTaskVO vo) {
@@ -191,6 +211,11 @@ public class CrdnImpltTaskServiceImpl extends EgovAbstractServiceImpl implements
 
     }
 
+    /**
+     * 이행정보 존재 여부를 확인한다.
+     * @param vo 확인할 이행정보
+     * @return 존재하면 1, 아니면 0
+     */
     @Override
     public int selectImpltInfoExistsCount(CrdnImpltTaskVO vo) {
         return crdnImpltTaskMapper.selectImpltInfoExistsCount(vo);
@@ -198,11 +223,21 @@ public class CrdnImpltTaskServiceImpl extends EgovAbstractServiceImpl implements
 
     // ==================== 이행 대상자 정보 관련 메서드 ====================
 
+    /**
+     * 이행 대상자 정보 목록을 조회한다.
+     * @param vo 조회할 이행정보
+     * @return 이행 대상자 정보 목록
+     */
     @Override
     public List<CrdnImpltTrprInfoVO> selectImpltTrprInfoList(CrdnImpltTaskVO vo) {
         return crdnImpltTaskMapper.selectImpltTrprInfoList(vo);
     }
 
+    /**
+     * 이행 대상자 정보를 등록한다.
+     * @param vo 등록할 이행 대상자 정보
+     * @return 등록된 행의 수
+     */
     @Override
     public int insertImpltTrprInfo(CrdnImpltTrprInfoVO vo) {
         // 시퀀스 생성 및 세션 정보 설정

src/main/java/go/kr/project/crdn/crndRegistAndView/main/service/impl/CrdnLevyPrvntcServiceImpl.java

@@ -34,14 +34,21 @@ public class CrdnLevyPrvntcServiceImpl extends EgovAbstractServiceImpl implement
 
     private final CrdnLevyPrvntcMapper crdnLevyPrvntcMapper;
 
+    /**
+     * 부과 정보 최초 등록 여부를 확인한다.
+     * @param vo 확인할 부과 정보
+     * @return 최초 등록이면 1, 아니면 0
+     */
     @Override
     public int selectLevyInfoFirstCheck(CrdnLevyInfoVO vo){
         return crdnLevyPrvntcMapper.selectLevyInfoFirstCheck(vo);
     }
 
     /**
-     * 부과예고에 대한 행위정보 목록
-     * */
+     * 부과예고에 대한 행위정보 목록을 조회하고, 위반 면적을 계산한다.
+     * @param vo 조회할 행위정보 조건
+     * @return 계산된 위반 면적을 포함한 행위정보 목록
+     */
     @Override
     public List<LevyPrvntcActInfoVO> selectActInfoList(LevyPrvntcActInfoVO vo) {
         // 중요로직: 행위정보 목록을 조회한 후, 각 항목에 대해 '면적 - 조치면적'을 계산하여 'calcArea' 필드에 설정합니다.
@@ -72,16 +79,31 @@ public class CrdnLevyPrvntcServiceImpl extends EgovAbstractServiceImpl implement
         return actInfoList;
     }
 
+    /**
+     * 모든 산정요율2 정보를 조회한다.
+     * @param vo 조회 조건
+     * @return 산정요율2 정보 목록
+     */
     @Override
     public List<CrdnCmpttnRt2VO> getAllCmpttnRt2(CrdnCmpttnRt2VO vo) {
         return crdnLevyPrvntcMapper.getAllCmpttnRt2(vo);
     }
 
+    /**
+     * 가감산 요율 목록을 조회한다.
+     * @param vo 조회 조건
+     * @return 가감산 요율 목록
+     */
     @Override
     public List<CrdnAdsbmtnRtVO> selectAdsbmtnRtList(CrdnAdsbmtnRtVO vo) {
         return crdnLevyPrvntcMapper.selectAdsbmtnRtList(vo);
     }
 
+    /**
+     * 부과 정보를 등록한다.
+     * @param vo 등록할 부과 정보
+     * @return 등록된 행의 수
+     */
     @Override
     public int insertLevyInfo(CrdnLevyInfoVO vo) {
         log.debug("부과정보 신규 등록 서비스 호출: {}", vo);
@@ -104,6 +126,11 @@ public class CrdnLevyPrvntcServiceImpl extends EgovAbstractServiceImpl implement
         return result;
     }
 
+    /**
+     * 부과 정보를 수정한다.
+     * @param vo 수정할 부과 정보
+     * @return 수정된 행의 수
+     */
     @Override
     public int updateLevyInfo(CrdnLevyInfoVO vo) {
         log.debug("부과정보 수정 서비스 호출: {}", vo);
@@ -123,6 +150,11 @@ public class CrdnLevyPrvntcServiceImpl extends EgovAbstractServiceImpl implement
         return result;
     }
 
+    /**
+     * 부과 정보를 삭제한다.
+     * @param vo 삭제할 부과 정보
+     * @return 삭제된 행의 수
+     */
     @Override
     public int deleteLevyInfo(CrdnLevyInfoVO vo) {
         log.debug("부과정보 삭제 서비스 호출: {}", vo);
@@ -138,12 +170,24 @@ public class CrdnLevyPrvntcServiceImpl extends EgovAbstractServiceImpl implement
         return result;
     }
 
+    /**
+     * 행위정보 ID로 부과 정보를 조회한다.
+     * @param vo 조회할 부과 정보 (actInfoId)
+     * @return 부과 정보
+     */
     @Override
     public CrdnLevyInfoVO selectLevyInfoByActInfoId(CrdnLevyInfoVO vo) {
         log.debug("부과정보 조회 서비스 호출: {}", vo);
         return crdnLevyPrvntcMapper.selectLevyInfoByActInfoId(vo);
     }
 
+    /**
+     * 이행강제금액을 업데이트한다.
+     * @param crdnYr 단속연도
+     * @param crdnNo 단속번호
+     * @param impltTaskSeCd 이행과업구분
+     * @return 수정된 행의 수
+     */
     @Override
     public int updateImpltCpsrAmt(String crdnYr, String crdnNo, String impltTaskSeCd) {
         log.debug("부과총액 업데이트 서비스 호출 - 단속연도: {}, 단속번호: {}", crdnYr, crdnNo);
@@ -151,6 +195,13 @@ public class CrdnLevyPrvntcServiceImpl extends EgovAbstractServiceImpl implement
         return crdnLevyPrvntcMapper.updateImpltCpsrAmt(crdnYr, crdnNo, impltTaskSeCd);
     }
 
+    /**
+     * 이행강제금액을 null로 업데이트한다.
+     * @param crdnYr 단속연도
+     * @param crdnNo 단속번호
+     * @param impltTaskSeCd 이행과업구분
+     * @return 수정된 행의 수
+     */
     @Override
     public int updateImpltCpsrAmtToNull(String crdnYr, String crdnNo, String impltTaskSeCd) {
         log.debug("부과총액 null 처리 서비스 호출 - 단속연도: {}, 단속번호: {}", crdnYr, crdnNo);
@@ -158,11 +209,25 @@ public class CrdnLevyPrvntcServiceImpl extends EgovAbstractServiceImpl implement
         return crdnLevyPrvntcMapper.updateImpltCpsrAmtToNull(crdnYr, crdnNo, impltTaskSeCd);
     }
 
+    /**
+     * 특정 단속에 속한 모든 행위정보의 키 목록을 조회한다.
+     * @param crdnYr 단속연도
+     * @param crdnNo 단속번호
+     * @return 행위정보 ID 목록
+     */
     @Override
     public List<String> selectActInfoKeys(String crdnYr, String crdnNo) {
         return crdnLevyPrvntcMapper.selectActInfoKeys(crdnYr, crdnNo);
     }
 
+    /**
+     * 특정 행위정보에 대한 부과정보의 개수를 조회한다.
+     * @param crdnYr 단속연도
+     * @param crdnNo 단속번호
+     * @param actInfoId 행위정보 ID
+     * @param impltTaskSeCd 이행과업구분
+     * @return 부과정보 개수
+     */
     @Override
     public int countLevyInfoByActInfoId(String crdnYr, String crdnNo, String actInfoId, String impltTaskSeCd) {
         return crdnLevyPrvntcMapper.countLevyInfoByActInfoId(crdnYr, crdnNo, actInfoId, impltTaskSeCd);
@@ -172,6 +237,7 @@ public class CrdnLevyPrvntcServiceImpl extends EgovAbstractServiceImpl implement
      * 모든 행위정보에 대한 부과정보가 완료되었는지 확인
      * @param crdnYr 단속연도
      * @param crdnNo 단속번호
+     * @param impltTaskSeCd 이행과업구분
      * @return 모든 데이터 완료 여부
      */
     @Override

src/main/java/go/kr/project/crdn/crndRegistAndView/main/service/impl/CrdnRelevyServiceImpl.java

@@ -59,11 +59,21 @@ public class CrdnRelevyServiceImpl implements CrdnRelevyService {
     String atcnFileStorePath;
 
 
+    /**
+     * 재부과 대상 단속의 위치 정보를 조회한다.
+     * @param crdnRelevyVO 원본 단속 정보를 담은 VO
+     * @return 위치 정보
+     */
     @Override
     public CrdnRelevyVO selectCrdnPstnInfoOne(CrdnRelevyVO crdnRelevyVO) {
         return relevyMapper.selectCrdnPstnInfoOne(crdnRelevyVO);
     }
 
+    /**
+     * 해당 주소지에 동일 년도에 이미 부과된 단속이 있는지 확인한다.
+     * @param crdnRelevyVO 재부과 정보를 담은 VO
+     * @return 기부과된 단속 정보
+     */
     @Override
     public CrdnRelevyVO selectRelevyCheckOne(CrdnRelevyVO crdnRelevyVO) {
         return relevyMapper.selectRelevyCheckOne(crdnRelevyVO);
@@ -269,7 +279,11 @@ public class CrdnRelevyServiceImpl implements CrdnRelevyService {
         }
     }
 
-    // 행위사진, 조치사진 경로 추출
+    /**
+     * 사진 구분에 따라(행위사진/조치사진) 업로드할 디렉토리 경로를 생성한다.
+     * @param srcPhoto 사진 정보를 담은 VO
+     * @return 년월을 포함한 전체 업로드 경로
+     */
     private String generateUploadDirectoryPath(CrdnPhotoVO srcPhoto) {
         String uploadPath = atcFileStorePath;
         // 년월 정보 추출