웨딩북 웹앱

웨딩북 전체 서비스를 한 사이트에 모은 웹과 앱 통합 사이트

기간
2025.04 ~ 2026.05
역할
프론트엔드 파트 리드, 웨딩홀 파트 전담
키워드
App Router, Turbopack, Zustand, React Query

프로젝트 개요

기존 웨딩북 포탈과 여러 사용자 서비스를 하나의 Next.js 플랫폼으로 통합한 프로젝트입니다. 초기에 Biome, axios, API 구조 같은 개발 기반을 정리했고, 웨딩홀 지도 검색을 전담했습니다. 웨딩홀 상세와 예약 화면은 처음 만든 뒤 다른 프론트엔드 개발자들과 함께 발전시켰습니다. 프론트엔드 팀원 3명을 이끄는 파트 리드로 코드 리뷰와 기술 스택 결정을 맡아 Biome 설정, 코드 컨벤션, 모듈 간 의존성 방향 규칙을 정했습니다.

주요 화면

1 / 9

주요 기능

  1. 웹과 앱 통합 서비스 화면

    웨딩북의 여러 서비스를 한 사이트에서 접근할 수 있게 구성하고, 웹과 앱(웹뷰) 양쪽에서 같은 화면을 사용합니다.

  2. 지도 기반 검색과 상세 이동

    사용자가 지도에서 웨딩홀을 탐색하고, 핀과 바텀시트 인터랙션을 거쳐 상세 페이지로 이동하는 검색 흐름을 제공합니다.

  3. 검색 노출과 공유를 고려한 상세 페이지

    상세 페이지에서 OG 메타, canonical, sitemap을 함께 관리해 검색 노출과 외부 공유에 필요한 정보를 제공합니다.

  4. 예약과 후속 서비스 연결

    웨딩홀 상세에서 방문예약과 문의로 이어지고, 모바일 청첩장과 몰 등 후속 서비스를 같은 웹앱에서 이용할 수 있습니다.

기술 스택

Next.js · TypeScript · Zustand · TanStack React Query · SCSS Modules · Biome · Playwright · Vitest · Firebase · Microsoft Clarity · Google Analytics

담당 범위와 결과

역할 · 프론트엔드 파트 리드, 웨딩홀 파트 전담

웨딩홀 탐색 흐름 구현

  • 목록과 상세 중심이던 웨딩홀 탐색을 지도, 핀, 바텀시트가 연결된 검색 흐름으로 확장했습니다.
  • 사용자가 원하는 영역에서 결과를 갱신하고, 목록과 상세 선택이 불필요한 재조회로 이어지지 않도록 정리했습니다.
  • Vitest와 Playwright를 직접 도입해, 지도 계산 로직은 단위 테스트로, 필터와 바텀시트 흐름은 E2E로 확인했습니다.

서버 렌더링과 브라우저 전용 코드의 경계

  • 카카오 지도 SDK는 동적으로 불러오고, 서버 렌더링 중에는 지도 컨트롤러가 없어도 화면이 깨지지 않도록 처리했습니다.
  • useSearchParams를 쓰는 페이지에 Suspense 경계를 두어 빌드 오류를 해결했습니다.

검색 노출과 운영 분석 기반 구축

  • 웨딩홀 상세의 SSR 메타데이터와 sitemap, robots를 직접 구축해 검색과 외부 공유에 필요한 기반을 마련했습니다.
  • 예약과 방문 신청이 여러 단계와 중첩 WebView를 오가는 구조라 자동 수집되는 page_view만으로는 각 단계의 진입과 완료를 일관되게 구분하기 어려웠고, 도메인별 GA 이벤트 설계를 주도해 각 단계의 진입과 완료를 구분해 볼 수 있게 했습니다.
  • Microsoft Clarity를 도입해 홈 CTA의 클릭 분포를 히트맵으로 볼 수 있게 했습니다.

이미지 로딩 부담 줄이기

  • 홈 배너와 카드 썸네일, 업체 상세와 마이페이지의 이미지 목록이 원본 대신 화면 용도에 맞는 폭으로 줄인 이미지를 받도록 리사이즈 URL을 적용했습니다.

운영 중 문제 해결

  • 토큰 재발급 요청이 같은 axios 인스턴스의 401 처리를 거치며 자기 자신의 재발급 완료를 기다리던 교착을 찾아, 재발급 요청만 인터셉터 밖으로 분리했습니다.
  • S3의 점검 설정 파일을 middleware 가장 앞단에서 확인해, 배포 없이 서비스 전체를 점검 화면으로 전환하는 점검 모드를 만들었습니다.
  • HTML은 매번 다시 확인하고 정적 파일은 길게 캐시하도록 캐시 정책을 나눠, 배포 후에도 새 화면을 바로 받도록 했습니다.
ASK ME기준 ·이 프로젝트 · 웨딩북 웹앱

프로젝트, 담당 범위, 기술적 판단을 물어보세요.

추천 질문

포트폴리오에 작성된 내용으로만 답합니다