Skip to content

Repository files navigation

강원도 여행, 더 쉽고 편리하게!   




📌 프로젝트 개요

GangwonGo는 강원도 여행을 더 쉽고, 더 편리하게 만들기 위해 탄생한 올인원 강원도 관광 웹서비스입니다.

  • 기간 : 2025.01.17 ~ 2025.02.07
  • 주요 기능
    1) 섬세한 조건별 검색과 필터링을 통해 원하는 맞춤 정보만 딱! 다양한 검색 기능
    2) 여행의 즐거움을 나누는 커뮤니티 공간
    3) 나만의 여행 히스토리 관리를 관리할 수 있는 마이페이지 공간



🎯 프로젝트 목표

강원도 여행의 불편함을 해결하고, 더 쉽고 편리한 여행 경험을 제공합니다.

🔍 Problem 💡 Solution
강원도 관광 정보를 한 번에 찾기 어려움 ✅ 강원도 여행 정보를 한 곳에서 통합 제공
여행지에 대한 정보를 한눈에 찾기 어려움 ✅ 세분화된 카테고리로 관광지 정보 제공
강원도 여행자 간 커뮤니티 공간의 부족함 ✅ 여행 동행 모집 커뮤니티 기능 제공



👥 팀원 소개

김지우 성도형 최윤서 👑 최지혜
@erase0250 @DohyoungSeong @cj2174 @jihye-c



⚙️ 주요 기능

1️⃣ 관광정보 검색 : 관심사 별로 다양한 필터링 기능 제공

2️⃣ 커뮤니티 : 여행 동행자 모집 글 작성과 참여 기능

3️⃣ 마이페이지 : 찜한 장소 및 다녀온 장소 저장·확인



🛠️ 기술 스택

Frontend

Backend

버전 관리 및 협업 도구

개발 환경 및 도구



⭐️ 서버 실행 방법

개발 서버 실행:

npm run dev

의존성 설치

  • tailwind 관련 의존성 설치
npm install @headlessui/react @heroicons/react
  • 부트스트랩 icons 설치
npm i bootstrap-icons
  • Pretendard font 설치
npm i pretendard
  • Swiper 설치
npm i swiper



🚀 Git 컨벤션

타입 설명
Feat 새로운 기능 추가
Fix 버그 수정
Docs 문서 수정 (README, 문서 변경 등)
Style 코드 포맷팅, 세미콜론 누락 등 코드 변경 없음
Refactor 코드 리팩토링 (기능 변경 없이 코드 개선)
Test 테스트 코드 추가 및 리팩토링 테스트 코드 작성
Chore 패키지 매니저 수정, 기타 변경 (ex. .gitignore)
Design CSS 등 사용자 UI 디자인 변경
Comment 필요한 주석 추가 및 변경
Rename 파일 또는 폴더명 수정 및 이동
Remove 파일 삭제 작업
!BREAKING CHANGE 커다란 API 변경 (호환성 깨지는 변경)
!HOTFIX 긴급한 버그 수정



📁 폴더 구조

├─public # 정적 파일 (이미지, 아이콘, 애니메이션 등)
│  ├─animation                    # 애니메이션 파일 (JSON 포맷)
│  ├─icons                        # 아이콘 파일 (SVG)
│  └─images                       # 이미지 파일 (사용자 프로필 사진, 배너 등)
│
└─src                             # 소스 코드
    ├─app                          # 페이지 및 레이아웃 관련
    │  ├─add-data                  # 데이터 추가 페이지
    │  ├─api                       # API 라우트 (MongoDB 연동 등)
    │  │  ├─places                 # 여행지 관련 API
    │  ├─auth                      # 인증 관련 페이지 (로그인, 회원가입)
    │  │  ├─login                  # 로그인 페이지
    │  │  ├─signup                 # 회원가입 페이지
    │  ├─community                 # 커뮤니티 관련 페이지 (게시판, 글 작성 등)
    │  │  ├─admin                  # 커뮤니티 관리 페이지
    │  │  ├─edit                   # 게시글 수정 페이지
    │  │  ├─post                   # 게시글 상세 페이지
    │  │  ├─write                  # 게시글 작성 페이지
    │  │  └─page.tsx               # 커뮤니티 메인 페이지
    │  ├─explore                   # 여행지 관련 페이지
    │  │  ├─concert                # 공연 관련 페이지
    │  │  ├─festival               # 축제 관련 페이지
    │  │  ├─leisure                # 레저 활동 관련 페이지
    │  │  ├─places                 # 음식점/숙소 페이지
    │  │  ├─travel                 # 관광지 페이지
    │  ├─mypage                    # 마이페이지
    │  │  ├─favorites              # 찜한여행지 페이지
    │  │  ├─mypost                 # 사용자가 작성한 게시글 페이지
    │  │  ├─visited                # 다녀온 여행지 페이지
    │  │  ├─page.tsx               # 마이페이지 메인
    │  └─layout.tsx                # 전체 페이지 레이아웃
    │
    ├─components                   # 재사용 가능한 컴포넌트
    │  ├─Leisure                    # 레저 관련 컴포넌트
    │  ├─common                     # 공통 컴포넌트 (버튼, 모달 등)
    │  ├─festival                   # 축제/공연/행사 관련 컴포넌트
    │  ├─main                        # 메인 관련 컴포넌트
    │  ├─places                      # 음식점/숙소 관련 컴포넌트
    │  ├─travel                      # 관광지 관련 컴포넌트
    │
    ├─constants                     # 상수 값 관리
    │  ├─apiEndpoints.ts             # API 엔드포인트 상수
    │  ├─routes.ts                   # 라우트 경로 상수
    │
    ├─hooks                         # 커스텀 훅
    │  ├─useAuth.ts                  # 사용자 인증 관련 훅
    │  ├─useFilter.ts                # 필터링 로직 훅
    │  ├─useNavigateToDetail.ts      # 상세 페이지 이동 관련 훅
    │
    ├─store                         # 전역 상태 관리
    │  ├─authStore.ts                # 사용자 인증 상태 관리
    │
    ├─styles                        # 스타일 관련
    │  ├─globals.css                 # 전역 스타일
    │  ├─header.module.css           # 헤더 스타일
    │  ├─placeDetail.module.css      # 음식점/숙소 상세 스타일
    │
    ├─types                         # TypeScript 타입 정의
    │  ├─types.ts                    # 공통 타입 정의
    │
    └─utils                         # 유틸리티 함수들
        ├─api.ts                    # API 요청 함수
        ├─authapi.ts                 # 인증 관련 API 요청 함수
        ├─channelapi.ts              # 채널 관련 API 요청 함수
        ├─cookie.ts                  # 쿠키 관련 유틸 함수
        ├─storage.ts                 # 로컬 스토리지 관련 함수
        ├─validation.ts              # 입력 값 검증 함수

This is a Next.js project bootstrapped with [create-next-app] (https://nextjs.org/docs/app/api-reference/cli/create-next-app).

About

No description, website, or topics provided.

Resources

Stars

1 star

Watchers

1 watching

Forks

Releases

Packages

Used by

Contributors

Languages