Next.js를 기반으로 사용자들에게 가까운 병원과 약국 검색 기능을 제공하고, 정보를 나눌 수 있는 커뮤니티 사이트입니다.
2025년 3월 21일 ~ 2025년 4월 4일 (총 2주)
➕ 카카오 로컬 API 및 공공 데이터 API (병원 및 약국 정보)
- 병원 및 약국 정보 검색 시 지도를 기준으로 주변 병원 또는 약국을 검색합니다.
- 내 위치 정보 제공 동의 또는 내 주변 찾기 버튼을 눌러 주소를 입력 시, 주변 병원 및 약국을 자동 검색합니다.
- 필터 기능을 활용하여 더 먼거리 또는 영업 시간 및 일자에 따라 필터링할 수 있습니다.
- 지도에서 검색한 병원 및 약국 카드 또는 맵의 마커를 클릭하여 상세 페이지에서 확인할 수 있습니다.
- 장소에 하트를 좋아요를 등록할 수 있습니다.
- 댓글 또는 답글을 작성하고 내 댓글을 제거 및 수정할 수 있습니다.
- 이메일과 비밀번호를 이용한 회원가입이 가능합니다.
- 이메일로 로그인 하는 경우 이메일 인증 페이지로 이동합니다. (현재는 SMTP 설정 해제하여 이메일 인증 기능 비활성화)
- 구글 및 카카오 OAuth 로그인/회원가입 기능을 제공합니다.
- 문제 발생
- 검색 실행 시
geoLocation값이undefined - 이로 인해,
useInfiniteQuery의enabled조건이 충족되지 않아 검색 쿼리가 실행되지 않음
- 해결 방법
mapRef.current가 초기 마운트 시점에는null로 설정되었고,useEffect를 트리거 하지 않음 (useEffect에 deps를 설정하지 않고 마운트 시에 실행되도록 하는 경우 타이밍으로 인해mapRef.current가 null이 됨)- 이로 인해
map.setRef(mapRef.current)가 호출되지 않아zustand에 카카오 맵ref가 등록되지 않아서 기존 코드가 실행되지 않았던 것을 확인함 - 따라서,
mapRef.current값을 마운트 즉시 Map의 ref가 할당되는 정확한 시점에setMapRef를 실행하도록 콜백 ref를 사용한 코드로 수정
- 코드 비교
- 적용 전
// SearchBar.tsx
const handleSubmitSearchInput = (
e: React.MouseEvent | Reacat.KeyboardEvent,
) => {
const isKeyBoardEvent = "key" in e;
if (isKeyBoardEvent && e.key !== "Enter") return;
setIsSearchMode(true);
if (map.ref) {
const cetner = map.ref.getCenter();
setGeoLocation({ lat: cetner.getLat(), lng: cetner.getLng() });
}
setFilterGroupos("query", searchValue.trim());
setSearchValue("");
}
// KakaoMap.tsx
useEffect(() => {
if (mapRef.current) {
map.setRef(mapRef.current);
}
}, [mapRef.current]);
...
<Map cetner={map.center} ref={mapRef} className="h-full w-full">- 적용 후
// SearchBar.tsx
const handleSubmitSearchInput = (
e: React.MouseEvent | Reacat.KeyboardEvent,
) => {
const isKeyBoardEvent = "key" in e;
if (isKeyBoardEvent && e.key !== "Enter") return;
setIsSearchMode(true);
if (map.ref) {
const cetner = map.ref.getCenter();
setGeoLocation({ lat: cetner.getLat(), lng: cetner.getLng() });
}
setFilterGroupos("query", searchValue.trim());
setSearchValue("");
}
// KakaoMap.tsx
const setMapRef = useCallback(
(element: kakao.maps.Map | null) => {
if (element && element !== map.ref) {
map.setRef(element);
}
},
[map.ref]
);
...
<Map cetner={map.center} ref={setMapRef} className="h-full w-full">- 개선된 점
- 초기 검색 시
geoLocation값이 누락되는 문제는mapRef의 초기화 타이밍 문제였기 때문에, 콜백 ref로 안전하게 등록하여 해결함 - 무한 루프는 동일 ref 여부를 검사해 방지하여 첫 검색 시도 시 문제 없이 렌더링 및 api 요청이 발생함을 확인함
- 문제 발생
- 배포 시 병원 및 약국 세부 정보 API (공공 데이터) 요청에 에러가 생겨 데이터가 지도에 나타나지 않는 것을 확인
- 해결 방법
- main 브랜치 배포 환경에서 Response를 직접 확인하는 코드를 작성하지 않아 Preview에서 코드를 수정하여 확인
- CORS 문제임을 확인하고
next.config.ts의rewrites를 활용하여 내부적인 proxy를 이용하기로 결정
- 코드 비교
- 적용 전
// 요청 부분 api 코드
const res = await fetch(
`${process.env.NEXT_PUBLIC_DATA_HOSPITAL_BASE_URL}/getHsptlMdcncListInfoInqire?${query}`,
);- 적용 이후
// 요청 부분 api 코드
const res = await fetch(
`/api/public-data/hospital/getHsptlMdcncListInfoInqire?${query}`,
);
// next.config.ts
const nextConfig: NextConfig = {
/* config options here */
async rewrites() {
return [
{
source: "/api/public-data/hospital/:path*",
destination: `${process.env.NEXT_PUBLIC_DATA_HOSPITAL_BASE_URL}/:path*`,
},
{
source: "/api/public-data/pharmacy/:path*",
destination: `${process.env.NEXT_PUBLIC_DATA_PHARMACY_BASE_URL}/:path*`,
},
];
},
};📦 root/
├── .github/ # GitHub 관련 설정 (템플릿 등)
│
├── app/ # Next.js App Router 폴더
│ └── _ui/
│ ├── layout/ # 레이아웃 관련 컴포넌트
│ └── shared/ # 공통 UI 컴포넌트
│
│ └── (admin)/ # 관리자 페이지 관련 라우팅 (미구현)
│ └── admin
│ └── page.tsx
│
│ └── (pages)/ # 일반 사용자 페이지 라우팅
│ └── (main)/ # 메인 페이지
│ ├── _ui/ # 메인 페이지에서 사용되는 UI 컴포넌트
│ └── page.tsx
│ └── detail/[id] # 상세 페이지
│ ├── _ui/ # 상세 페이지에서 사용되는 UI 컴포넌트
│ └── page.tsx
│ └── board # 자유 게시판 (미구현)
│ └── page.tsx
│ └── emergency # 응급실 페이지 (미구현)
│ └── page.tsx
│
│ └── (users)/ # 사용자 정보 관련 페이지 라우팅
│ └── auth # 로그인,회원가입 관련
│ ├── _ui/
│ ├── callback/ # OAuth redirect 처리 페이지
│ ├── signin/
│ ├── signup/
│ └── verify-email/
│ └── mypage # 내 정보 페이지 (미구현)
│ └── page.tsx
│
│ └── api/ # API Route 핸들러 (클라이언트에서 사용)
│ ├── auth/ # 회원 관련
│ └── place/ # 장소 관련
│
│
│ ├── favicon.ico # 파비콘
│ ├── globals.css # 전역 스타일
│ ├── layout.tsx # 루트 레이아웃
│ ├── loading.tsx # 페이지 로딩 상태
│ ├── not-found.tsx # 404 페이지
│ └── providers.tsx # 글로벌 Provider 설정
│
├── components/ # 재사용 가능한 컴포넌트들
│
├── constants/ # 상수 정의 (예: 경로, 색상 등)
│
├── hooks/ # 커스텀 훅
│
├── lib/
│ ├── api/ # API 호출 관련 유틸 (RSC에서 사용)
│ ├── queries/ # React Query 또는 DB 쿼리 관리
│ ├── supabase/ # Supabase 관련 로직
│ ├── ui/ # UI 관련 유틸
│ └── utils.ts # shadcn/ui 유틸 (자동설치)
│
├── public/ # 정적 파일 (이미지 등)
│
├── stores/ # 전역 상태 관리 (예: Zustand)
│ └── useGeoLocation.ts
│
├── utils/ # 일반 유틸리티 함수
│
├── .env.local # 환경 변수 파일
├── .gitignore # Git 제외 설정
├── ...
- 좌측 상단 로고 클릭 시 메인 페이지로 이동
- 우측 상단 메뉴에서 원하는 페이지로 이동 가능
- 로그인 유뮤에 따라 UI 전환
- 로그인 X
- 로그인 페이지로 이동할 수 있는 아이콘 표시
- 로그인 O
- 유저 프로필 이미지로 변환
- 유저 프로필 클릭 시 로그아웃 및 마이페이지 이동 버튼 드롭다운
- 로그인 X
- 기능 설명
- 사이트 접속 시 위치 정보 제공 동의 여부 확인
- 동의 한 경우
- 위치 값이 정확하지 않은 경우 (accuracy > 100), 위치 정보 제공에 동의하지 않은 경우와 동일하게 동작
- 현재 위치를 기준으로 반경 1km 이내의 10개 병원 및 약국 정보 확인 (최대 45개 까지 확인 가능)
- 또한, 필터 기능을 사용하여 검색 거리 또는 영업 시간 필터링 가능
- 동의 하지 않은 경우
- 내 주변 찾기 버튼을 눌러 내 주소를 찾아서 선택
- 또는, 검색 창에 병원 이름 또는 내과 등의 분류를 입력하여 지도 중심 주변 1km 이내 장소 정보 검색
- 마찬가지로, 필터 기능 사용 가능
- UI 구성
- 병원 및 약국의 마커가 있는 지도 (kakao map 사용)
- 검색 입력
- 주변 검색 필터 및 내 위치 정보 입력 모달 트리거 버튼
- 병원 및 약국의 목록
- 기능 설명
- 병원 상세 정보와 댓글 리스트를 SSR로 제공
- URL의 쿼리 값을 기준으로 재 검색 (카카오 로컬 API 한계)
- 검색된 정보와 id를 비교하고 id가 잘못된 경우 invalid 페이지로 리다이렉트
- 병원 및 약국 상세 정보 페이지
- 로그인한 사용자에 제한하여 병원 및 약국 리뷰 작성 및 좋아요 기능 제공
- UI 구성
- 병원 및 약국의 마커가 있는 지도 (kakao map 사용)
- 병원 및 약국의 상세 정보 (좋아요, 공유 기능 포함)
- 댓글 입력 폼
- 댓글 리스트
- 기능 설명
- 이메일을 활용한 로그인 및 회원가입 기능 제공
- 이메일을 활용하여 회원가입 시 verify-email 페이지로 이동 (현재는 이동은 하지만 실제로 인증 메일을 전송하지 않음)
- 구글, 카카오 OAuth를 활용한 로그인 및 회원가입 기능 제공
- 로그인에 성공한 경우 메인 페이지로 이동
- UI 구성
- 회원가입 및 로그인 폼
- verify-email 페이지



