[feat] Extract and enrich multiple places from one caption

[KyungminPark-steck]

📖 배경

현재 processing-server는 Instagram caption에서 장소 정보를 단일 store_name/address로 추출하고, Kakao Local 검색 결과도 단일 selected_place 중심으로 저장한다.

하지만 하나의 caption 안에 여러 장소가 리스트 형태로 포함되는 게시물이 존재한다. 예를 들어 디저트 카페 추천 caption에서 플루밍, 누크녹, 예챠, 라뚜셩트, 코이크, 카페토요처럼 여러 place_name과 주소가 함께 제공된다.

또한 실제 caption에서는 상호명이 #플루밍처럼 hashtag 형태로 등장하는 경우도 있어, 기존 단일 추출 prompt만으로는 다중 장소와 hashtag 기반 상호명을 안정적으로 처리하기 어렵다.

🎯 목표

하나의 caption에서 여러 장소 후보를 추출하고, 각 장소를 Kakao Local API로 enrichment한 뒤, 선택 가능한 모든 Kakao 장소 결과를 DB/API 응답에 저장한다.

기존 단일 장소 caption과 기존 응답 필드는 가능한 유지하면서, 신규 다중 장소 필드를 추가한다.

🛠️ 구현 내용

• LLM extraction schema를 다중 장소 배열 중심으로 확장한다.
  • extraction_result.places에 전체 extracted place 목록을 저장한다.
  • 기존 store_name, address, store_name_evidence, address_evidence, certainty는 첫 번째 extracted place 기준 legacy 대표값으로 유지한다.
• extraction prompt를 구체화한다.
  • 번호 목록(❶, ❷, 1., 2. 등), 브랜드 정보, 매장 정보, 장소 정보 섹션을 인식한다.
  • place name line과 이어지는 주소 line을 pair로 묶는다.
  • 📍, 주소, 위치, 서울, 구, 동, 로, 길 등 주소 단서를 활용한다.
  • #플루밍처럼 hashtag가 실제 상호명인 경우 후보로 고려한다.
  • #서울카페, #연남카페, #맛집추천 같은 지역/카테고리/홍보성 hashtag는 상호명으로 추출하지 않는다.
• 각 extracted place에 대해 기존 Kakao Local 검색 정책을 동일하게 적용한다.
  • LLM address는 검색 힌트로만 사용한다.
  • 저장 장소 정보는 Kakao Local API 응답 기준으로 한다.
  • 주소가 다르다는 이유만으로 후보를 버리지 않는다.
  • kakao_min_place_confidence=0.7 기준을 유지한다.
  • 선택 가능한 후보만 place_candidates에 저장한다.
• 다중 선택 결과 저장을 위해 DB schema migration을 추가한다.
  • selected_places JSONB NOT NULL DEFAULT '[]'::jsonb
• API 응답 schema에 selected_places를 추가한다.
• 기존 selected_place는 legacy 대표값으로 유지한다.
  • 단일 caption에서는 기존 동작과 동일하게 selected 결과 1개를 담는다.
  • 다중 caption에서는 caption 등장 순서 기준 첫 번째 selected place를 담는다.
• Kakao 매칭 실패한 extracted place는 extraction_result.places에는 남기고, selected_places/place_candidates에는 저장하지 않는다.
• 단일 장소 caption 기존 테스트와 다중 장소 caption 신규 테스트를 함께 갱신한다.

⚠️ 고려사항

• DB schema 변경은 반드시 migration SQL로 추가한다.
• 기존 API 소비자가 selected_place 또는 extraction_result.store_name을 사용 중일 수 있으므로 해당 필드는 legacy 대표값으로 유지한다.
• 신규 다중 장소 소비자는 extraction_result.places와 selected_places를 사용해야 한다.
• 다중 caption에서는 Kakao Local API 호출 수가 extracted place 수만큼 증가하므로 extraction_max_candidates 제한을 적용한다.
• selected_place는 다중 결과의 전체 의미를 담지 못하므로, 다중 장소 처리는 selected_places를 authoritative field로 본다.

✅ 완료 조건

• 예시 caption에서 플루밍, 누크녹, 예챠, 라뚜셩트, 코이크, 카페토요가 모두 extraction_result.places에 추출된다.
• #상호명 형태의 hashtag가 실제 place name인 경우 추출 후보로 처리된다.
• 지역/카테고리/홍보성 hashtag는 place name으로 오추출하지 않는다.
• 각 extracted place에 대해 Kakao Local enrichment가 수행된다.
• confidence 기준을 통과한 Kakao 후보만 place_candidates에 저장된다.
• 매칭 성공한 장소들이 selected_places로 DB에 저장되고 API 응답에서 확인된다.
• 기존 selected_place는 legacy 대표값으로 유지된다.
• DB schema 변경이 migration SQL에 포함된다.
• 단일 장소 caption 기존 테스트와 다중 장소 caption 신규 테스트가 모두 통과한다.