v2.46change journal

POP-SPOT v2.46 — 날짜 보강 대상 선정 — 입구가 막혀 나머지에 도달하지 못하던 문제

김동현127
#백엔드#프론트엔드#회고#트러블슈팅
v2.46 릴리즈에 포함된 Git 기록을 빠짐없이 펼친 기술 기록이다. 전문 용어는 바로 풀어 쓰고, 바뀐 모든 코드 줄을 Before → After로 비교했다.

먼저 쉽게 설명하면

날짜 보강 대상 선정 — 입구가 막혀 나머지에 도달하지 못하던 문제 작업이 중심이다. 이 릴리즈는 눈에 보이는 결과뿐 아니라 그 결과를 만든 파일과 코드까지 모두 추적했다.

읽는 법

  • Before는 바뀌기 전 줄이다.
  • After는 바뀐 뒤 줄이다.
  • ‘해당 코드 없음’은 새로 추가했거나 완전히 지운 구간이라는 뜻이다.
  • 영상·이미지처럼 글자로 비교할 수 없는 파일은 Git의 추가·수정·삭제 상태로 기록했다.
  • Git 기준 범위

  • 릴리즈: v2.46
  • 기준 날짜: 2026-07-28
  • 커밋: 5개
  • 파일 변경 기록: 15개
  • 추가한 줄: 788줄
  • 삭제한 줄: 135줄
  • 검증 ID: e268bd0e0097427c253147a463f8c7cffa5d37db058823107656a52687ebf24d
  • 기준 커밋: 217002f286b8

  • 커밋 f9227e6 — feat(수집): 날짜 추출 정확도 — 글 작성일 전달 · 부분 날짜 지침 · 성적 측정변경 파일 1

    GitHub에서 이 커밋 보기

    쉬운 설명: 날짜 추출 정확도 — 글 작성일 전달 · 부분 날짜 지침 · 성적 측정 작업이다.

    바꾼 이유: v2.45 에서 날짜 없는 팝업을 버리기 시작했으니, 이제 못 뽑는 양 자체를 줄여야 한다.

    파일 수: 1개이다.


    파일 1. popspot-backend/src/main/java/com/example/popspotbackend/service/crawler/PopupNormalizationService.java

    파일 전체 문맥

    조각만 보면 알기 어려운 코드를 파일 처음부터 끝까지 보여 준다. 초록은 추가·수정, 빨강은 삭제된 줄이다.

    커밋 cff24c6 — chore(수집): 검색어 중복 51개·노이즈 11개 정리 — 487 → 424변경 파일 1

    GitHub에서 이 커밋 보기

    쉬운 설명: 검색어 중복 51개·노이즈 11개 정리 — 487 → 424 작업이다.

    바꾼 이유: v2.45 에서 날짜·좌표 없는 팝업을 버리기 시작해 수집량이 줄어든다. 그 손실을 메우려면 새 검색어를 추가하는 것보다 지금 돌고 있는 것 중 헛도는 것을 걷어내는 편이 확실하다 — 회차당 상한 (max-keywords-per-run, 운영 100)이 있어 목록을 늘려도 하루 처리량은 그대로이고 한 바퀴 도는 기간만 길어진다.

    파일 수: 1개이다.


    파일 1. popspot-backend/src/main/java/com/example/popspotbackend/service/crawler/PopupCrawlOrchestrator.java

    파일 전체 문맥

    조각만 보면 알기 어려운 코드를 파일 처음부터 끝까지 보여 준다. 초록은 추가·수정, 빨강은 삭제된 줄이다.

    커밋 8952f78 — style(백엔드): 포매터 줄바꿈 정리 — 기능 변화 없음변경 파일 6

    GitHub에서 이 커밋 보기

    쉬운 설명: 포매터 줄바꿈 정리 — 기능 변화 없음 작업이다.

    바꾼 이유: 커밋 제목에 적힌 문제를 해결하기 위해 코드를 바꿨다.

    파일 수: 6개이다.


    파일 1. popspot-backend/src/main/java/com/example/popspotbackend/controller/VisitController.java

    파일 전체 문맥

    조각만 보면 알기 어려운 코드를 파일 처음부터 끝까지 보여 준다. 초록은 추가·수정, 빨강은 삭제된 줄이다.

    파일 2. popspot-backend/src/main/java/com/example/popspotbackend/entity/VisitLog.java

    파일 전체 문맥

    조각만 보면 알기 어려운 코드를 파일 처음부터 끝까지 보여 준다. 초록은 추가·수정, 빨강은 삭제된 줄이다.

    파일 3. popspot-backend/src/main/java/com/example/popspotbackend/service/crawler/PopupCrawlOrchestrator.java

    파일 전체 문맥

    조각만 보면 알기 어려운 코드를 파일 처음부터 끝까지 보여 준다. 초록은 추가·수정, 빨강은 삭제된 줄이다.

    파일 4. popspot-backend/src/main/java/com/example/popspotbackend/service/crawler/PopupNormalizationService.java

    파일 전체 문맥

    조각만 보면 알기 어려운 코드를 파일 처음부터 끝까지 보여 준다. 초록은 추가·수정, 빨강은 삭제된 줄이다.

    파일 5. popspot-backend/src/main/java/com/example/popspotbackend/service/geocoding/GeocodingUnavailableException.java

    파일 전체 문맥

    조각만 보면 알기 어려운 코드를 파일 처음부터 끝까지 보여 준다. 초록은 추가·수정, 빨강은 삭제된 줄이다.

    파일 6. popspot-backend/src/main/java/com/example/popspotbackend/service/geocoding/KakaoGeocodingService.java

    파일 전체 문맥

    조각만 보면 알기 어려운 코드를 파일 처음부터 끝까지 보여 준다. 초록은 추가·수정, 빨강은 삭제된 줄이다.

    커밋 f49a8c5 — feat(수집): 원본 글 본문에서 팝업 기간 2차 보강변경 파일 5

    GitHub에서 이 커밋 보기

    쉬운 설명: 원본 글 본문에서 팝업 기간 2차 보강 작업이다.

    바꾼 이유: 측정 결과가 방향을 정해줬다. 날짜를 못 뽑은 34건 중 24건(71%)이 "검색 요약문에 기간이 아예 없어서" 였다. 프롬프트로는 없는 정보를 만들 수 없어, 결손분만 골라 원본 글을 한 번 더 읽는다.

    파일 수: 5개이다.


    파일 1. popspot-backend/src/main/java/com/example/popspotbackend/controller/PopupAdminReviewController.java

    파일 전체 문맥

    조각만 보면 알기 어려운 코드를 파일 처음부터 끝까지 보여 준다. 초록은 추가·수정, 빨강은 삭제된 줄이다.

    파일 2. popspot-backend/src/main/java/com/example/popspotbackend/service/crawler/PopupBodyDateExtractor.java

    파일 전체 문맥

    조각만 보면 알기 어려운 코드를 파일 처음부터 끝까지 보여 준다. 초록은 추가·수정, 빨강은 삭제된 줄이다.

    파일 3. popspot-backend/src/main/java/com/example/popspotbackend/service/crawler/PopupCrawlScheduler.java

    파일 전체 문맥

    조각만 보면 알기 어려운 코드를 파일 처음부터 끝까지 보여 준다. 초록은 추가·수정, 빨강은 삭제된 줄이다.

    파일 4. popspot-backend/src/main/java/com/example/popspotbackend/service/crawler/PopupDateBackfillService.java

    파일 전체 문맥

    조각만 보면 알기 어려운 코드를 파일 처음부터 끝까지 보여 준다. 초록은 추가·수정, 빨강은 삭제된 줄이다.

    파일 5. popspot-backend/src/main/java/com/example/popspotbackend/service/crawler/SourceBodyFetcher.java

    파일 전체 문맥

    조각만 보면 알기 어려운 코드를 파일 처음부터 끝까지 보여 준다. 초록은 추가·수정, 빨강은 삭제된 줄이다.

    커밋 217002f — fix(수집): 날짜 보강 대상 선정 — 입구가 막혀 나머지에 도달하지 못하던 문제변경 파일 2

    GitHub에서 이 커밋 보기

    쉬운 설명: 날짜 보강 대상 선정 — 입구가 막혀 나머지에 도달하지 못하던 문제 작업이다.

    바꾼 이유: 첫 실전 실행에서 두 가지가 드러났다.

    파일 수: 2개이다.


    파일 1. popspot-backend/src/main/java/com/example/popspotbackend/repository/PopupStoreRepository.java

    파일 전체 문맥

    조각만 보면 알기 어려운 코드를 파일 처음부터 끝까지 보여 준다. 초록은 추가·수정, 빨강은 삭제된 줄이다.

    파일 2. popspot-backend/src/main/java/com/example/popspotbackend/service/crawler/PopupDateBackfillService.java

    파일 전체 문맥

    조각만 보면 알기 어려운 코드를 파일 처음부터 끝까지 보여 준다. 초록은 추가·수정, 빨강은 삭제된 줄이다.

    공유XLinkedIn

    댓글