Spring Boot 70 파일 와일드카드 import 제거 + Spotless · 거대 메서드 분해 — POP-SPOT v1.4 백엔드 클린코드

// v1.4 — popspot-backend/build.gradle 에 Spotless 도입
plugins {
    id 'com.diffplug.spotless' version '6.25.0'
//  ^^^^^^^^^^^^^^^^^^^^^^^^^^         ^^^^^^^^
//  Gradle 플러그인 ID                  버전 고정 — 파이프라인 재현성 확보
}

spotless {
    java {
//      ^^^^ java 소스셋에만 규칙 적용. groovy/kotlin 에도 각각 설정 가능
        googleJavaFormat('1.22.0').aosp()
//      ^^^^^^^^^^^^^^^^ ^^^^^^^^  ^^^^^^
//      |                |         |
//      |                |         +-- AOSP 변형: 4칸 인덱트 (기본은 2칸)
//      |                |             100 컸럼 한계 — 개인 노트북에서 한 눈에 들어오는 폭
//      |                +-- google-java-format 버전 (포맷 규칙 버전도 고정)
//      +-- Google 의 공식 자바 포맷. PR 마다 "탭/스페이스 다르다" 싸움 종결
        removeUnusedImports()
//      ^^^^^^^^^^^^^^^^^^^^^ 실제로 안 쓰는 import 자동 제거
//                            IDE 의 "unused import warning" 에만 의존하지 않아도 됨
        endWithNewline()
//      ^^^^^^^^^^^^^^^^ 파일 끝에 개행문자 강제 — POSIX 표준. git diff 노이즈 제거
    }
}

// v1.4 — ./gradlew check 시 spotlessCheck 가 먼저 돌아감
tasks.named('check') { dependsOn 'spotlessCheck' }
//          ^^^^^^^                ^^^^^^^^^^^^^
//          |                       |
//          |                       +-- 포맷 위반 있으면 빌드 실패 → PR 머지 차단
//          +-- gradle 표준 검증 태스크. CI 에서 자동 호출됨
// 수정 하려면 ./gradlew spotlessApply 실행 → 그림 자동 수정

// v1.3 까지 — 매직 넘버 그대로 노출
if (attempts >= 5) lockAccount();
//              ^ 이 5 가 무슨 뜻인지 다른 개발자가 알 방법 없음
//                  - 로그인 최대 시도 5회?
//                  - 재시도 지연 5초?
//                  - 고정 세션 5분?
//                  고치고 싶을 때 grep 으로 '5' 찾으면 수백 결과

// v1.4 — 이름 있는 상수로 추출
private static final int MAX_LOGIN_ATTEMPTS_PER_MINUTE = 5;
//      ^^^^^^^^^^^^     ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
//      |                |
//      |                +-- 대문자 스네이크 — 자바 관습상 상수와 필드 구분
//      +-- final 은 JVM 이 관련 최적화 적용. static 은 인스턴스당 복제 안 됨

if (attempts >= MAX_LOGIN_ATTEMPTS_PER_MINUTE) lockAccount();
//              ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ 읽으면서 의미 해석이 같이 일어남
//                                            이제 조건을 읽으면 입력 값과 의도가 한꺼번에 드러남

// v1.3 까지 — runOnce() 한 메서드 안에 단계가 전부 섬여 있음 (약 130줄)
public void runOnce() {
    // 검색 호출 ... 30 줄          ← Naver/Kakao Search API 둘을 순차 호출
    // 정규화 ... 25 줄             ← Groq 프롬프트 컴파일 후 답변 JSON 파싱
    // 중복 제거 ... 15 줄           ← 제목·주소·날짜 같은 건 하나로
    // Geocoding ... 20 줄          ← 주소를 lat/lng 로 변환 (Kakao Local API)
    // DB 저장 ... 25 줄             ← confidence 계산 + 조건 충족 시 INSERT
    // 로그 ... 15 줄                ← 로그 기록·메트릭 업데이트
    // 문제: 한 단계가 실패했을 때 제쳐두고 다음 단계로 가기 어려움 (조기 탈출 return 이 불편)
}

// v1.4 — 명명된 6개 단계로 분해. 메서드 1개 → 7개
public void runOnce() {
    var rawResults      = collectRawSnippets();
//  ^^^   ^^^^^^^^^^      ^^^^^^^^^^^^^^^^^^^
//  |     |               |
//  |     |               +-- 1단계: 원시 검색 결과 수집 (List<RawSnippet>)
//  |     +-- 단계 이름이 변수명으로 이어짐 → 디버깅 시 변수 값을 보면 단계 의미가 바로 드러남
//  +-- Java 10+ var. 타입 추론 — 점용 타입을 적아 가독성 우선

    var normalized      = normalize(rawResults);
//                                  ^^^^^^^^^^   2단계: 앞 단계 결과 그대로 넘김
//                                                Groq 정규화. List<NormalizedPopup>
    var deduplicated    = removeDuplicates(normalized);
//                       ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^   3단계: 해시(title+address+date) 기준 중복 제거
    var withCoordinates = geocode(deduplicated);
//                       ^^^^^^^^^^^^^^^^^^^^^   4단계: Kakao Local 로 lat/lng 채움
    var saved           = persistWithConfidence(withCoordinates);
//                       ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^   5단계: confidence ≥0.8 이면 게시
    logRunSummary(saved);
//  ^^^^^^^^^^^^^                                                   6단계: 수집 요약을 admin 로그로 남김
}
// 결과: 한 단계만 따로 테스트 가능·단계 당 평균 25줄 안판·각 메서드 IDE outline 에서 본문처럼 읽힘