부과예고 로직 추적용 주석 추가

src/main/webapp/WEB-INF/views/crdn/crndRegistAndView/main/crdnLevyPrvntc/levyPrvntcPopup.jsp

@@ -79,6 +79,130 @@
 │    - 모든 행위정보 완료 시 자동 합산                                         │
 └─────────────────────────────────────────────────────────────────────────────┘
 
+■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■
+
+■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■
+■ 데이터베이스 테이블 및 컬럼 상세 정보 (쿼리 조회 기준)
+■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■
+
+■ 1. 건물기준시가액 (bldgNewPrcCrtrAmt)
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+• 조회 테이블: tb_bldg_new_prc_crtr_amt (건물신축가격기준액)
+• 매칭 조건:
+  - YR = t1.CRDN_YR (단속연도)
+  - NO = SUBSTRING(용도지수코드,1,1) (용도지수 첫자리 번호)
+• 주요 컬럼:
+  - BLDG_NEW_PRC_CRTR_AMT: 건물신축가격기준액 (DECIMAL(13))
+  - BDST_USG: 건축물용도 (VARCHAR(60))
+• 저장위치: tb_levy_info.BLDG_CRTR_MPRC_AMT / BLDG_NEW_PRC_CRTR_AMT_NO
+
+■ 2. 구조지수 (strctIdx)
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+• 조회 테이블: tb_strct_idx (구조지수)
+• 주요 컬럼:
+  - STRCT_IDX_CD: 구조지수코드 (VARCHAR(3)) [PK]
+  - STRCT_IDX: 구조지수값 (DECIMAL(10,2))
+  - STRCT_NM: 구조명 (VARCHAR(100))
+  - RDVLRT_CN_YR_CNT: 잔가율내용연도수 (DECIMAL(2))
+  - LAST_YR_RDVLRT: 최종연도잔가율 (DECIMAL(4,2))
+  - DPRT: 감가상각률 (DECIMAL(4,4))
+• 추가 계산용 컬럼:
+  - BSCS_CSTRN_Y_BDST_CMPTTN_RT: 기초공사Y건축물산정비율
+  - BSCS_CSTRN_N_BDST_CMPTTN_RT: 기초공사N건축물산정비율
+  - DUP_ETBLDG_BDST_CMPTTN_RT: 복측증축건축물산정비율
+• 저장위치: tb_levy_info.STRCT_IDX_CD / STRCT_IDX
+
+■ 3. 용도지수 (usgIdx)
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+• 조회 테이블: tb_usg_idx (용도지수)
+• 주요 컬럼:
+  - USG_IDX_CD: 용도지수코드 (VARCHAR(5)) [PK]
+  - USG_IDX: 용도지수값 (DECIMAL(10,2))
+  - USG_NM: 용도명 (VARCHAR(300))
+  - MAIN_USG_NM: 주요용도명 (VARCHAR(100))
+  - LWR_USG_NM: 하위용도명 (VARCHAR(100))
+• 저장위치: tb_levy_info.USG_IDX_CD / USG_IDX
+
+■ 4. 위치지수 (pstnIdx)
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+• 조회 테이블: tb_pstn_idx (위치지수)
+• 매칭 조건: 공시지가(OALP) BETWEEN 시작가격 AND 종료가격 (범위 매칭)
+• 주요 컬럼:
+  - PSTN_IDX_NO: 위치지수번호 (VARCHAR(2)) [PK]
+  - PSTN_IDX: 위치지수값 (DECIMAL(10,2))
+  - BLDG_ANX_LAND_BGNG_PRC: 건물부속토지시작가격 (DECIMAL)
+  - BLDG_ANX_LAND_END_PRC: 건물부속토지종료가격 (DECIMAL)
+• 저장위치: tb_levy_info.PSTN_IDX_NO / PSTN_IDX
+
+■ 5. 경과년수별잔가율 (elpsYrRdvlrt)
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+• 계산 방식: 동적 계산 (구조지수의 감가상각 정보 활용)
+• 관련 테이블:
+  - tb_strct_idx: 감가상각률(DPRT), 잔가율내용연도수(RDVLRT_CN_YR_CNT), 최종연도잔가율(LAST_YR_RDVLRT)
+  - tb_act_info: 행위시작일자(ACT_BGNG_YMD)
+  - tb_crdn: 단속연도(CRDN_YR)
+• 계산 공식:
+  - 경과년수 = CAST(단속연도 as SIGNED) - CAST(SUBSTRING(행위시작일자,1,4) as SIGNED)
+  - IF 경과년수 >= 잔가율내용연도수 THEN 최종연도잔가율
+  - ELSE 1 - (경과년수 × 감가상각률)
+• 저장위치: tb_levy_info.ELPS_YR_RDVLRT
+
+■ 6. 기초공사율 (bscsCstrnRt)
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+• 계산 방식: 구조지수 테이블의 기초공사 관련 비율 조회
+• 관련 테이블: tb_strct_idx
+• 계산용 컬럼:
+  - BSCS_CSTRN_Y_BDST_CMPTTN_RT: 기초공사 있음(Y) 건축물산정비율
+  - BSCS_CSTRN_N_BDST_CMPTTN_RT: 기초공사 없음(N) 건축물산정비율
+• 선택 방식: 기초공사구분코드(bscsCstrnSeCd)에 따라 해당 비율 적용
+• 저장위치: tb_levy_info.BSCS_CSTRN_SE_CD / BSCS_CSTRN_RT
+
+■ 7. 가감산시행령률 (adsbmtnEnfcRt)
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+• 기본값: 100 (고정값)
+• 관련 테이블: tb_adsbmtn_rt (가감산율)
+• 주요 컬럼:
+  - ADSBMTN_RT_CD: 가감산율코드
+  - ADSBMTN_RT_SE_CD: 가감산율구분코드 ('01':가산, '02':감산)
+  - ADSBMTN_RT: 가감산율
+• 계산 방식: (100 + 가산율 - 감산율) 형태로 적용
+• 저장위치: tb_levy_info.ADSBMTN_ENFC_RT
+
+■ 8. 산정률 (cmpttnRt)
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+• 조회 테이블: tb_act_type (행위유형)
+• 매칭 조건: ACT_TYPE_CD = 행위정보.행위유형코드
+• 주요 컬럼:
+  - ACT_TYPE_CD: 행위유형코드 (VARCHAR(3)) [PK]
+  - CMPTTN_RT: 산정률 (DECIMAL(3))
+  - VLTN_BDST: 위반건축물 (VARCHAR(100))
+• 저장위치: tb_levy_info.CMPTTN_RT_CD / CMPTTN_RT
+
+■ 9. 산정률2 (cmpttnRt2)
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+• 조회 테이블: tb_cmpttn_rt_2 (산정률2)
+• 조회 조건: USE_YN = 'Y' (사용중인 항목만)
+• 주요 컬럼:
+  - CMPTTN_RT_2_CD: 산정률2코드
+  - CMPTTN_RT_2: 산정률2값 (DECIMAL(3))
+  - VLTN_MTTR: 위반사항
+  - USE_YN: 사용여부
+• 저장위치: tb_levy_info.CMPTTN_RT_2_CD / CMPTTN_RT_2
+
+■ 10. 추가 관련 테이블
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+• tb_levy_info: 모든 계산 결과의 최종 저장소 (스냅샷 방식)
+• tb_act_info: 행위정보 (행위시작일자, 행위유형코드, 위반면적 등)
+• tb_pstn_info: 위치정보 (공시지가 OALP)
+• tb_crdn: 단속정보 (단속연도, 단속번호)
+
+■ 계산 흐름 요약
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+1. 기준 데이터 조회: 단속연도, 용도지수, 공시지가 기준으로 각종 마스터 테이블 JOIN
+2. 동적 계산: 경과년수별잔가율만 단속연도와 행위시작연도 차이로 실시간 계산
+3. 스냅샷 저장: 계산된 모든 값을 tb_levy_info에 저장하여 데이터 변경에 무관하게 복원 가능
+4. 이행강제금: 모든 행위정보별 부과총액 합계로 최종 산출
+
 ■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■
 -->