# 자동차 과태료 비교 로직 정리

## 개요

### 중요 사항
- ⚠️ **순서가 중요합니다!**
- 조건에 걸리는 순간 다음 차량번호 비교를 진행합니다.

### 로직 변경 사항

#### 변경 전
- 하나의 API를 호출해서 비교 로직 진행

#### 변경 후
1. **기본 호출**: `TB_CAR_FFNLG_TRGT.검사일` 기준으로 API 호출 (기본정보 + 갑부정보)
2. **추가 호출**: 각 비교 로직마다 필요한 API 추가 호출
   - 차량기본정보
   - 갑부정보
   - 기본정보 + 갑부정보

**예시**: 이첩-2의 경우, `(TB_CAR_FFNLG_TRGT.검사종료일자 + 115일)` 기준으로 차량기본정보 API 추가 호출

---

## 비교 로직 상세

### 1. 상품용 검증 [차량기본정보 필요]

#### 조건
1. `TB_CAR_FFNLG_TRGT.검사일` 기준 API 호출
2. `api.MBER_NM like '%상품용%'`
3. 갑부 상세(LedgerRecord) 리스트에서 다음 조건 확인:
   ```
   (List.CHG_YMD between TB_CAR_FFNLG_TRGT.유효기간만료일 and TB_CAR_FFNLG_TRGT.검사종료일자)
   AND
   (List.CHANGE_JOB_SE_CODE = '11')  -- 명의이전 코드
   ```

#### 처리 결과
- **TB_CAR_FFNLG_TRGT.비고**: `"[상품용] 갑부정보"`

---

### 2. 이첩-1 [차량등록원부(갑) 필요]

#### 조건
1. `TB_CAR_FFNLG_TRGT.검사일` 기준 API 호출
2. 법정동코드 불일치 검증

#### 검증 로직 (Java)

```java
/**
 * 이첩 조건1: 법정동코드 불일치
 * 사용본거지법정동코드 앞 4자리 != 사용자 조직코드 앞 4자리
 */
private boolean checkTransferCondition1_LegalDongMismatch(
    BasicResponse.Record basicInfo,
    String userId,
    String vhclno
) {
    String useStrnghldLegaldongCode = basicInfo.getUseStrnghldLegaldongCode();

    // 법정동코드 유효성 검사
    if (useStrnghldLegaldongCode == null || useStrnghldLegaldongCode.length() < 4) {
        log.debug("[이첩][조건1] 법정동코드 없음. 차량번호: {}", vhclno);
        return false;
    }

    // 사용자 정보 조회
    SystemUserVO userInfo = userMapper.selectUser(userId);
    if (userInfo == null || userInfo.getOrgCd() == null) {
        log.debug("[이첩][조건1] 사용자 정보 없음. 사용자ID: {}", userId);
        return false;
    }

    // 법정동코드 앞 4자리 vs 사용자 조직코드 앞 4자리 비교
    String legalDong4 = useStrnghldLegaldongCode.substring(0, 4);
    String userOrgCd = userInfo.getOrgCd();
    String userOrg4 = userOrgCd.length() >= 4 ? userOrgCd.substring(0, 4) : userOrgCd;

    if (legalDong4.equals(userOrg4)) {
        log.debug("[이첩][조건1] 법정동코드 일치. 차량번호: {}, 법정동: {}, 조직: {}",
                vhclno, legalDong4, userOrg4);
        return false;
    }

    log.info("[이첩][조건1] 법정동코드 불일치! 차량번호: {}, 법정동: {}, 조직: {}",
            vhclno, legalDong4, userOrg4);
    return true;
}
```

#### 처리 결과
- **TB_CAR_FFNLG_TRGT.비고**: `"서울시 용산구 / 이경호, 검사일사용본거지, [검사대상, 사용자 조직코드 앞 4자리 및 법정동명]"`

---

### 3. 이첩-2 [차량기본정보 필요]

#### 조건
1. `TB_CAR_FFNLG_TRGT.DAYCNT` (textFile 일수) > 115
2. **검사일 기준** API 호출
3. **(검사종료일자 + 115일) 기준** API 호출 (추가)
4. 2번 API와 3번 API의 자동차기본정보 비교
   - **사용본거지법정동코드 앞 4자리**가 다를 경우

#### 처리 결과
- **TB_CAR_FFNLG_TRGT.비고**: `"전라남도 순천시 / 김정대, 115일 도래지, [2개의 API 법정동코드 및 법정동명]"`

---

## 데이터 흐름도

```
TB_CAR_FFNLG_TRGT (과태료 대상)
    ↓
검사일 기준 API 호출 (기본정보 + 갑부정보)
    ↓
┌─────────────┬─────────────┬─────────────┐
│   상품용    │   이첩-1    │   이첩-2    │
│  검증 로직  │  검증 로직  │  검증 로직  │
└─────────────┴─────────────┴─────────────┘
    ↓             ↓             ↓
조건 만족 시 비고 업데이트 → 다음 차량번호 처리
```

---

## 핵심 필드 매핑

| 테이블 | 필드명 | 설명 |
|--------|--------|------|
| TB_CAR_FFNLG_TRGT | 검사일 | API 호출 기준일 (기본) |
| TB_CAR_FFNLG_TRGT | 검사종료일자 | 이첩-2에서 +115일 계산에 사용 |
| TB_CAR_FFNLG_TRGT | 유효기간만료일 | 상품용 검증 기간 시작일 |
| TB_CAR_FFNLG_TRGT | DAYCNT | 일수 (이첩-2 조건) |
| TB_CAR_FFNLG_TRGT | 비고 | 검증 결과 저장 |
| API 기본정보 | MBER_NM | 회원명 (상품용 검증) |
| API 기본정보 | useStrnghldLegaldongCode | 사용본거지법정동코드 (이첩 검증) |
| API 갑부 상세 | CHG_YMD | 변경일자 (상품용 기간 검증) |
| API 갑부 상세 | CHANGE_JOB_SE_CODE | 변경작업구분코드 (명의이전: 11) |
| 사용자 정보 | OrgCd | 조직코드 (이첩-1 검증) |

---

## 주의사항

1. **순차 처리**: 각 차량번호는 조건에 걸리는 즉시 다음 차량번호로 넘어갑니다.
2. **API 호출 최적화**: 기본적으로 검사일 기준 API를 호출하고, 필요시에만 추가 호출합니다.
3. **로그 기록**: 각 검증 단계마다 상세 로그를 남겨 추적 가능하도록 합니다.
4. **에러 처리**: API 호출 실패 또는 데이터 부재 시 적절한 에러 처리가 필요합니다.
