모셔용 (MSDragon)

프로젝트 개요

부모님의 체력·건강·취향을 반영해 여행 코스와 동선을 자동 추천하는 서비스입니다. 자녀가 부모님 프로필을 입력하면 한국관광공사 TourAPI 기반으로 코스를 추천하고, 여행 중에는 주변 화장실·병원·카페와 AI 대화를 제공하며, 여행 후에는 부모님 피드백을 모아 효도 리포트를 만듭니다. 팀 메가족에서 백엔드 전체를 맡아 14개 도메인, 60여 개 API를 설계했습니다.

담당 업무 · 기여

• 도메인·API 설계: auth·family·parentprofile·trip·pledge·feedback·report·supportfacility·chat·home·notification 등 14개 도메인, 60여 개 REST API를 설계하고 Swagger와 도메인별 문서(docs/api)로 관리했습니다.
• 소셜 로그인·인증: 카카오·애플 OAuth 로그인, JWT 액세스/리프레시 토큰, 회원 탈퇴 시 소셜 연결 해제(Apple revoke·Kakao unlink)를 구현했습니다.
• 추천 코스 생성: TourAPI 무장애 여행 서비스로 장소 후보를 조회하고, 부모 프로필 스냅샷으로 적합도를 점수화해 일자별 코스를 생성합니다. 외부 데이터가 바뀌어도 코스가 유지되도록 장소 스냅샷을 저장합니다.
• 경로 최적화: Tmap 경유지 순서 최적화 API로 일자별 동선을 계산합니다. 사용자가 시작·도착점을 정하지 않으므로 모든 조합을 조회해 최단 경로를 고르고, 방문지가 바뀐 일자의 캐시만 무효화합니다.
• 여행 모드: 공중화장실 공공데이터 CSV를 적재하고, 병원·약국·카페는 Tmap POI로 실시간 조회합니다. OpenAI Responses API로 여행 중 AI 대화를 제공하고 세션·메시지를 저장합니다.
• 가족 기능: 가족 코드 발급·매칭, 여행 10계명 서명과 PDF 생성, 부모 피드백 수집과 효도 리포트 집계, FCM 푸시(서명 요청 등 이벤트 알림)를 구현했습니다.
• 인프라·운영: Docker 멀티스테이지 빌드, docker-compose(PostgreSQL 17·nginx), GitHub Actions로 테스트 후 EC2에 자동 배포하는 파이프라인을 구성했습니다.
• AI 에이전트 하네스: AGENTS.md와 도메인·API·DB 문서 체계를 만들어 AI 코딩 에이전트와 협업하는 개발 방식을 정착시켰습니다. 컨트롤러 테스트 28개로 정책을 검증합니다.

성과 · 개선

• TourAPI 후보 조회와 프로필 점수화, Tmap 경로 최적화를 결합한 추천 코스 파이프라인을 단독으로 완성했습니다.
• 14개 도메인·60여 개 API를 문서 기반으로 설계하고 컨트롤러 테스트로 정책을 고정해, 앱 팀이 문서만 보고 연동할 수 있게 했습니다.
• GitHub Actions → EC2 자동 배포로 매 머지마다 테스트와 배포가 이어지는 운영 구조를 만들었습니다.