[NOOK-171] 장소 검색 및 Google 보충정보 흐름 개편

[dh1010a]

변경 내용

• OpenAI가 추출한 장소 단서를 카카오 우선으로 검색하고 이름·지역·주소 기반으로 후보를 점수화합니다.
• 신뢰도가 낮을 때만 검색어를 확장하거나 네이버 지역검색으로 검증합니다.
• 확정된 장소를 Google Places에서 이름·주소·거리로 다시 매칭하고 Place ID, 사진, 영업시간을 저장합니다.
• 장소 보충정보 저장 실패 시 FAILED 상태를 보장하고, 전용 bounded executor로 외부 호출 동시성을 제한합니다.

배경 및 원인

기존 흐름은 카카오·네이버·Google의 역할과 후보 선택 기준이 불명확했습니다. 또한 Google 사진을 정상 업로드한 뒤 영업시간 JSON 역직렬화가 실패하면 저장 트랜잭션이 롤백되어 사진도 함께 사라지고 상태가 PROCESSING에 머무를 수 있었습니다.

영향

• 공개 API 계약 변경 없음
• Prometheus 지표 변경 없음
• 배포 전 docs/tasks/NOOK-171/ddl/up.sql 적용 필요

검증

• ./gradlew clean check
• 제공된 Instagram 게시물로 로컬 E2E 검증
• 장소 15건 보충 작업 완료, Google 매칭 13건, 장소 사진 78장 및 영업시간 13건 저장

[chatgpt-codex-connector]

You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard.
To continue using code reviews, you can upgrade your account or add credits to your account and enable them for code reviews in your settings.