🧭 GlobalNomad - 다양한 체험을 예약하는 플랫폼

🗂 목차

🧭 소개

GlobalNomad는 사용자가 직접 체험을 등록하고,
다른 사용자가 해당 체험을 예약할 수 있는 양방향 체험 예약 플랫폼입니다.

지도 및 캘린더 SDK를 활용하여 체험 위치와 예약 가능 일정을 직관적으로 확인할 수 있으며,
복잡한 UI 흐름과 상태 관리를 통해 실무 수준의 사용자 경험을 제공합니다.

🎯 프로젝트 주제

🧩 선정 배경

🚀 배포 링크

GlobalNomad 바로가기

👥 팀 소개

🧑‍💻 역할 분담

🧑‍💻 박광민

🧑‍💻 김보경

🧑‍💻 맹은빈

🧑‍💻 이찬호

📚 기술 스택

언어

프레임워크

패키지 매니저

스타일링

코드 포맷팅

상태 관리

API 통신

지도 API

협업 도구

인프라

🛠️ 주요 기능

📁 디렉토리 구조

src/
├── actions/ # 서버 액션 함수 정의
├── apis/ # API 호출 관련 함수 모음
├── app/ # Next.js 13 App Router 기반 라우트
│ ├── (non-header)/ # 헤더가 필요 없는 페이지 폴더
│ │ ├── 페이지폴더/
│ │ └── 페이지폴더/
│ ├── (with-header)/ # 헤더가 필요한 페이지 폴더
│ │ ├── 페이지폴더/
│ │ └── 페이지폴더/
│ ├── api/ # Next.js API 라우트
│ ├── globals.css # 글로벌 스타일
│ ├── layout.tsx # 루트 레이아웃
│ ├── loading.tsx # 전역 로딩 UI
│ ├── not-found.tsx # 404 페이지
│ └── error.tsx # 에러 페이지
├── components/ # 재사용 가능한 공통 컴포넌트
├── constants/ # 상수 정의 (예: 옵션 리스트, URL 등)
├── contexts/ # 전역 Context 정의 (예: 테마, 모달 등)
├── hooks/ # 커스텀 훅
├── lib/ # 유틸성 함수 및 외부 라이브러리 설정
├── stores/ # Zustand 등 전역 상태 관리
├── types/ # 전역 TypeScript 타입 정의
├── ui/ # 디자인 시스템 기반 UI 컴포넌트
└── utils/ # 공통 유틸 함수

🛠️ 컨벤션

🖊️ Git Flow

📂 폴더/파일명 네이밍 컨벤션

🌿 브랜치 네이밍 컨벤션

🧐 커밋 메시지 타입 (Commit Type)