From 707474d13cb5456f83f49e8f8062b230cf404db4 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=EB=B0=95=EC=84=B1=EC=98=81?= Date: Wed, 1 Oct 2025 12:13:25 +0900 Subject: [PATCH] =?UTF-8?q?java=20doc=20=EC=A3=BC=EC=84=9D=20=EC=B6=94?= =?UTF-8?q?=EA=B0=80?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../CrdnRegistAndViewController.java | 8 +-- .../main/controller/CrdnRelevyController.java | 11 +-- .../main/mapper/CrdnRelevyMapper.java | 28 +++++--- .../main/service/CrdnRelevyService.java | 8 ++- .../impl/CrdnImpltTaskServiceImpl.java | 35 ++++++++++ .../impl/CrdnLevyPrvntcServiceImpl.java | 70 ++++++++++++++++++- .../service/impl/CrdnRelevyServiceImpl.java | 16 ++++- 7 files changed, 152 insertions(+), 24 deletions(-) diff --git a/src/main/java/go/kr/project/crdn/crndRegistAndView/main/controller/CrdnRegistAndViewController.java b/src/main/java/go/kr/project/crdn/crndRegistAndView/main/controller/CrdnRegistAndViewController.java index 0ee7022..9563e80 100644 --- a/src/main/java/go/kr/project/crdn/crndRegistAndView/main/controller/CrdnRegistAndViewController.java +++ b/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 = { diff --git a/src/main/java/go/kr/project/crdn/crndRegistAndView/main/controller/CrdnRelevyController.java b/src/main/java/go/kr/project/crdn/crndRegistAndView/main/controller/CrdnRelevyController.java index a104ab6..3eaa31d 100644 --- a/src/main/java/go/kr/project/crdn/crndRegistAndView/main/controller/CrdnRelevyController.java +++ b/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 = "재부과 정보를 저장하고 새로운 단속 건을 생성합니다.") diff --git a/src/main/java/go/kr/project/crdn/crndRegistAndView/main/mapper/CrdnRelevyMapper.java b/src/main/java/go/kr/project/crdn/crndRegistAndView/main/mapper/CrdnRelevyMapper.java index 1a1b080..9a6e0ee 100644 --- a/src/main/java/go/kr/project/crdn/crndRegistAndView/main/mapper/CrdnRelevyMapper.java +++ b/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(); diff --git a/src/main/java/go/kr/project/crdn/crndRegistAndView/main/service/CrdnRelevyService.java b/src/main/java/go/kr/project/crdn/crndRegistAndView/main/service/CrdnRelevyService.java index 2588f9d..1439637 100644 --- a/src/main/java/go/kr/project/crdn/crndRegistAndView/main/service/CrdnRelevyService.java +++ b/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); /** diff --git a/src/main/java/go/kr/project/crdn/crndRegistAndView/main/service/impl/CrdnImpltTaskServiceImpl.java b/src/main/java/go/kr/project/crdn/crndRegistAndView/main/service/impl/CrdnImpltTaskServiceImpl.java index 01c8dfb..6681b05 100644 --- a/src/main/java/go/kr/project/crdn/crndRegistAndView/main/service/impl/CrdnImpltTaskServiceImpl.java +++ b/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 selectImpltTrprInfoList(CrdnImpltTaskVO vo) { return crdnImpltTaskMapper.selectImpltTrprInfoList(vo); } + /** + * 이행 대상자 정보를 등록한다. + * @param vo 등록할 이행 대상자 정보 + * @return 등록된 행의 수 + */ @Override public int insertImpltTrprInfo(CrdnImpltTrprInfoVO vo) { // 시퀀스 생성 및 세션 정보 설정 diff --git a/src/main/java/go/kr/project/crdn/crndRegistAndView/main/service/impl/CrdnLevyPrvntcServiceImpl.java b/src/main/java/go/kr/project/crdn/crndRegistAndView/main/service/impl/CrdnLevyPrvntcServiceImpl.java index 0ef9d9b..c7d4ac5 100644 --- a/src/main/java/go/kr/project/crdn/crndRegistAndView/main/service/impl/CrdnLevyPrvntcServiceImpl.java +++ b/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 selectActInfoList(LevyPrvntcActInfoVO vo) { // 중요로직: 행위정보 목록을 조회한 후, 각 항목에 대해 '면적 - 조치면적'을 계산하여 'calcArea' 필드에 설정합니다. @@ -72,16 +79,31 @@ public class CrdnLevyPrvntcServiceImpl extends EgovAbstractServiceImpl implement return actInfoList; } + /** + * 모든 산정요율2 정보를 조회한다. + * @param vo 조회 조건 + * @return 산정요율2 정보 목록 + */ @Override public List getAllCmpttnRt2(CrdnCmpttnRt2VO vo) { return crdnLevyPrvntcMapper.getAllCmpttnRt2(vo); } + /** + * 가감산 요율 목록을 조회한다. + * @param vo 조회 조건 + * @return 가감산 요율 목록 + */ @Override public List 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 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 diff --git a/src/main/java/go/kr/project/crdn/crndRegistAndView/main/service/impl/CrdnRelevyServiceImpl.java b/src/main/java/go/kr/project/crdn/crndRegistAndView/main/service/impl/CrdnRelevyServiceImpl.java index 91199d1..6dcb55b 100644 --- a/src/main/java/go/kr/project/crdn/crndRegistAndView/main/service/impl/CrdnRelevyServiceImpl.java +++ b/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; // 년월 정보 추출