[#432] 제휴 상세 시트 카카오맵/네이버지도 연결

[Hrepay]

🔗 연결된 이슈

Resolved #432

✨ 주요 작업사항

• 제휴 상세 시트 UI 개편
  • 타이포그래피를 디자인 시스템 시맨틱 폰트로 교체 (식당명 header2, 분류 body2, 날짜 caption2, 제휴 정보 body3)
  • 하단에 카카오맵/네이버지도 버튼 바 추가 (좌우 반반 + 세로 구분선)
  • 위로 스와이프 시 large로 확장 지원, 확장 시 버튼 바는 시트 하단 고정
  • iOS 26 Liquid Glass 시트 위에서 보이도록 구분선 대비 보정 (gray200 → gray300)
• 지도 앱 연결 3단 폴백 구조
  • 1차: 서버 제공 kakaoMapUrl/naverMapUrl 사용 - 카카오는 URL에서 place id 추출해 앱 스킴(kakaomap://place?id=) 연결, 네이버는 naver.me 유니버설 링크로 앱/웹 자동 분기
  • 2차(URL 없을 때): 카카오 로컬 API로 가게명+좌표 매칭해 place id 조회 (KakaoLocalService 신규), 네이버는 정제된 상호명으로 nmap://search
  • 3차(매칭 실패): 좌표 핀 표시
• DTO 및 설정
  • PartnershipDTO에 naverMapUrl/kakaoMapUrl 옵셔널 필드 추가 (PROD 서버 미반영 상태에서도 디코딩 안전)
  • LSApplicationQueriesSchemes에 kakaomap/nmap 추가, Info.plist에 KAKAO REST API KEY 주입 설정
  • TextLiteral + 4개 언어 Localizable.strings에 버튼 문구 추가
• 버그 수정
  • 내 제휴 모드로 시작 시 전체(All) 탭에 마커가 안 뜨던 문제 수정 (전체 데이터 미로드 상태에서 빈 캐시 필터링하던 버그)
• 기타
  • 카카오맵/네이버지도 로고 SVG 에셋 추가 (EATSSUDesign)
  • 실기기 테스트용 Mock 데이터 추가 (#if DEBUG 전용, 서버 응답이 비었을 때만 주입)

🔍 리뷰어에게 (선택)

• v3.2.8 (41) 테플에서 확인 가능합니다.
• 카카오 로컬 API 사용을 위해 로컬 Secrets/Debug.xcconfig·Release.xcconfig에 KAKAO_REST_API_KEY 추가가 필요합니다 (값은 따로 노션에 업데이트 해놓겠습니다). 키가 없어도 빌드/동작은 되고, 서버 URL이 없는 가게만 좌표 핀으로 폴백됩니다.
• 카카오 개발자 콘솔에서 EAT-SSU 앱의 카카오맵(로컬) 서비스 활성화를 완료해둔 상태입니다.

[gemini-code-assist]

Summary of Changes

Hello, I'm Gemini Code Assist¹! I'm currently reviewing this pull request and will post my feedback shortly. In the meantime, here's a summary to help you and other reviewers quickly get up to speed!

이 PR은 제휴 상세 시트의 UI를 개선하고 카카오맵 및 네이버지도 앱 연결 기능을 도입하여 사용자 편의성을 강화했습니다. 지도 앱 연결 시 서버 URL이 없는 경우에도 로컬 API 검색과 좌표 핀 표시를 통해 원활한 이동을 지원하도록 설계되었습니다. 또한, 디자인 시스템의 폰트 적용과 디버깅을 위한 Mock 데이터 추가를 통해 개발 효율성과 사용자 경험을 동시에 개선했습니다.

Highlights

• UI 개편: 제휴 상세 시트의 타이포그래피를 디자인 시스템 시맨틱 폰트로 교체하고, 하단에 카카오맵/네이버지도 연결 버튼 바를 추가했습니다.
• 지도 앱 연결 폴백 로직: 서버 URL 우선 사용, 실패 시 카카오 로컬 API 검색, 최종적으로 좌표 핀 표시로 이어지는 3단계 폴백 구조를 구현했습니다.
• 데이터 및 설정: PartnershipDTO에 지도 URL 필드를 추가하고, Info.plist 및 Project.swift에 필요한 스킴과 API 키 설정을 반영했습니다.
• 버그 수정 및 테스트 지원: 내 제휴 모드에서 마커가 표시되지 않던 버그를 수정하고, 디버깅을 위한 Mock 데이터를 추가했습니다.

New Features

🧠 You can now enable Memory (public preview) to help Gemini Code Assist learn from your team's feedback. This makes future code reviews more consistent and personalized to your project's style. Click here to enable Memory in your admin console.

Using Gemini Code Assist

The full guide for Gemini Code Assist can be found on our documentation page, here are some quick tips.

Invoking Gemini

You can request assistance from Gemini at any point by creating a comment using either /gemini <command> or @gemini-code-assist <command>. Below is a summary of the supported commands on the current page.

Feature	Command	Description
Code Review	/gemini review	Performs a code review for the current pull request in its current state.
Pull Request Summary	/gemini summary	Provides a summary of the current pull request in its current state.
Comment	@gemini-code-assist	Responds in comments when explicitly tagged, both in pull request comments and review comments.
Help	/gemini help	Displays a list of available commands.

Customization

To customize the Gemini Code Assist for GitHub experience, repository maintainers can create a configuration file and/or provide a custom code review style guide (such as PEP-8 for Python) by creating and adding files to a .gemini/ folder in the base of the repository. Detailed instructions can be found here.

Limitations & Feedback

Gemini Code Assist may make mistakes. Please leave feedback on any instances where its feedback is incorrect or counterproductive. You can react with 👍 and 👎 on @gemini-code-assist comments. If you're interested in giving your feedback about your experience with Gemini Code Assist for GitHub and other Google products, sign up here.

---

지도 앱 연결 길을 찾는 즐거움 제휴점 찾기

Footnotes

1. Review the Privacy Notices, Generative AI Prohibited Use Policy, Terms of Service, and learn how to configure Gemini Code Assist in GitHub here. Gemini can make mistakes, so double check it and use code with caution. ↩

[gemini-code-assist]

Code Review

이번 PR은 제휴점 상세 정보에서 카카오맵 및 네이버 지도 앱/웹으로 연동할 수 있는 기능을 추가합니다. 이를 위해 카카오 로컬 API를 호출하는 KakaoLocalService를 도입하고, 상세 시트 뷰에 지도 이동 버튼을 추가하였으며, 다국어 번역 및 프로젝트 설정을 업데이트했습니다. 리뷰어는 바텀시트가 표시되기 전에 view.safeAreaInsets가 .zero로 반환되어 높이 계산이 잘못될 수 있는 문제를 지적하며 Key Window의 safeAreaInsets를 활용하도록 제안했습니다. 또한, 지도 앱 연동 시 가게 이름이나 검색어에 특수문자가 포함될 경우 URL 경로가 깨질 수 있으므로 인코딩 시 허용할 문자 세트를 안전하게 제한할 것을 권장했습니다.

Important

The consumer version of Gemini Code Assist on GitHub is being sunset. Starting June 18, 2026, new organization installations will be blocked, and all code review activity will officially cease on July 17, 2026.
For more details on the timeline and next steps, please review the Help Documentation.