[Fix] 로드맵 장소 중복 문제 해결

[iamb0ttle]

1. 개요

• 관련 이슈: [Feat] 로드맵 skeleton 생성 시 Google Places 중복 후보 억제 #107
• 로드맵 생성 시 동일 place_id가 여러 슬롯/일자에 반복 배정되는 문제를 줄입니다.

2. 작업 내용

• finalize 단계에서 place_id 기준 전역 중복 제거를 추가했습니다.
• 중복 후보밖에 남지 않은 경우에도 가능한 대체 후보를 우선 선택하도록 했습니다.
• skeleton 생성 및 복구 프롬프트에 동일 place_id 중복 금지 지시를 추가했습니다.
• 관련 단위 테스트를 추가해 날짜를 넘어가는 중복 재사용 케이스를 검증했습니다.

3. AI 사용 및 검증

• AI가 생성한 코드 포함
• 100% 수동 작성
• 검증 방법: git diff --check
• 테스트: 현재 셸 환경에 uv/pytest가 없어 자동 테스트는 실행하지 못했습니다.

4. 스크린샷

• 해당 없음

5. 체크리스트

• uv run pre-commit run --all-files를 실행했는가?
• 관련 테스트를 실행했는가? (현재 환경에서는 실행 불가)
• 불필요한 print나 디버그 코드를 제거했는가?

Summary by CodeRabbit

릴리스 노트

• 버그 수정

  • 루트 계획 시 여러 날짜와 슬롯에서 동일한 장소가 중복으로 추천되는 문제를 개선했습니다. 시스템이 더 다양한 장소를 선택하도록 로직을 강화했으며, 필요시에만 대체 장소를 사용하게 됩니다.

• 테스트

  • 중복 제거 기능의 안정성을 검증하는 새로운 테스트가 추가되었습니다.

[coderabbitai]

개요

이 변경사항은 Google Places API 후보를 사용할 때 선택된 장소에 대한 중복 제거 로직을 구현합니다. place_id를 기반으로 생성된 키를 사용하여 슬롯 간 중복을 방지하고, 프롬프트에 제약 조건을 추가하며, 테스트를 확장합니다.

변경 사항

Cohort / File(s)	요약
최종화 로직 중복 제거 app/graph/roadmap/nodes/finalize.py	_prepare_final_context의 장소 선택 로직을 수정하여 place_id(또는 정규화된 이름 + 주소)를 기반으로 한 키를 사용해 선택된 장소를 중복 제거합니다. _select_place_in_region 함수를 수정하여 선택된 장소, 중복 제거 키, 대체 사용 여부 플래그를 반환하고, route_dedupe 작업 로그를 생성합니다.
스켈레톤 생성 프롬프트 업데이트 app/graph/roadmap/nodes/skeleton.py	초기 스켈레톤 생성 및 JSON 수리 프롬프트에 Google Place API 후보를 사용할 때 동일한 place_id를 다른 슬롯 및 날짜에 재사용하지 않도록 하는 제약 조건을 추가합니다.
교차 일자 중복 제거 테스트 tests/test_roadmap_generation_simplified_pipeline.py	_prepare_final_context의 교차 일자 중복 제거를 검증하는 새로운 테스트를 추가하고, 기존 세그먼트 프롬프트 테스트를 확장하여 시스템 및 사용자 메시지의 "동일 place_id" 제약 조건 참조를 검증합니다.

추정 코드 리뷰 노력

🎯 3 (Moderate) | ⏱️ ~20 분

관련 이슈

• [Feat] 로드맵 skeleton 생성 시 Google Places 중복 후보 억제 #107: 이번 변경사항은 트립 전체 Google Place 중복 제거를 구현하며, finalize.py의 중복 제거 키 및 재사용 추적, skeleton.py의 프롬프트 업데이트, 테스트 추가 등 요청된 모든 변경사항과 직접 일치합니다.

관련 PR

• [Feat] Mock 기반 로드맵 생성 전체 워크플로우 구현 #23: 이 PR의 최종 문맥 준비 및 장소 선택 동작 수정이 PR #23에서 도입된 synthesize_final_roadmap/_prepare_final_context와 동일한 기능을 직접 수정합니다.
• [Fix] 폴백 체인에서 지역 필터 해제 시 다른 도시/국가 장소가 일정에 포함되는 버그 수정 #66: 두 PR 모두 app/graph/roadmap/nodes/finalize.py의 _select_place_in_region 선택 로직 및 선택된 장소 처리 방식을 수정합니다.

제안 레이블

bug

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check name	Status	Explanation	Resolution
Docstring Coverage	⚠️ Warning	Docstring coverage is 40.00% which is insufficient. The required threshold is 80.00%.	Write docstrings for the functions missing them to satisfy the coverage threshold.

✅ Passed checks (4 passed)

Check name	Status	Explanation
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Title check	✅ Passed	The title '[Fix] 로드맵 장소 중복 문제 해결' accurately summarizes the main objective of the pull request, which is to fix duplicate roadmap places issue.
Description check	✅ Passed	풀 리퀘스트 설명이 필요한 모든 섹션을 포함하고 있으며, 구체적인 작업 내용과 검증 방법이 명시되어 있습니다.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

📝 Generate docstrings

• Create stacked PR
• Commit on current branch

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch feat/roadmap-dedupe-place-results

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[coderabbitai]

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents

Verify each finding against the current code and only fix it if needed.

Inline comments:
In `@app/graph/roadmap/nodes/finalize.py`:
- Around line 73-95: The loop currently forces truthiness of place_key which
skips candidates with place_key=None and can return an already-used key as
fallback; update the checks that currently read "if place_key and place_key not
in used_place_keys" (the early-return condition and the similar check before
assigning fallback_place) to instead test membership only (e.g., "if place_key
not in used_place_keys") so candidates with None keys are considered as
fallback, and change the final duplicate flag expression "bool(fallback_key and
fallback_key in used_place_keys)" to "bool(fallback_key in used_place_keys)" so
the returned boolean correctly reflects whether the fallback_key is already
used; locate these changes around uses of _place_dedupe_key, used_place_keys,
region_bbox.contains, and the fallback_place/fallback_key logic.

🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

• Push a commit to this branch (recommended)
• Create a new PR with the fixes

---

ℹ️ Review info

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 3c556347-e729-413d-ae9d-139ca75b1a0e

📥 Commits

Reviewing files that changed from the base of the PR and between 4b1bbd5 and 66d591b.

📒 Files selected for processing (3)

• app/graph/roadmap/nodes/finalize.py
• app/graph/roadmap/nodes/skeleton.py
• tests/test_roadmap_generation_simplified_pipeline.py