Skip to content

T2-GlobalNomad/GlobalNomad

Repository files navigation

GlobalNomad



0. Getting Started

$ npm run dev
$ npm run build
$ npm run


1. Project Overview

  • 프로젝트 이름: GlobalNomad
  • 프로젝트 기간: 2025.03.10 ~ 2025.04.17
  • 프로젝트 설명: 취미활동 참여 및 주최 서비스


2. Team Members

남기연 박준환 이승환 윤혜림 장보배 정혜연
남기연 박준환 이승환 윤혜림 장보배 정혜연
FE FE FE FE FE FE
GitHub GitHub GitHub GitHub GitHub GitHub
로그인, 로그아웃 체험 상세 페이지 메인페이지 내 프로필 - 예약한 체험 관리 내 프로필 - 내가 등록한 체험 관리 내 프로필 - 내 정보, 내 체험 예약 관리, 알림


3. Key Features

  • 회원가입:

    • 회원가입 시 DB에 유저정보가 등록됩니다.
  • 로그인:

    • 사용자 인증 정보를 통해 로그인합니다.
  • 체험 목록 페이지:

    • 사용자들이 등록한 체험들을 확인할 수 있습니다.
    • 체험을 클릭하면 상세페이지로 이동합니다.
  • 체험 상세 페이지:

    • 체험 정보 및 리뷰를 확인할 수 있습니다.
    • 시간, 인원, 날짜에 맞춰 체험을 신청할 수 있습니다.
  • 내 프로필:

    • 내 정보
      • 내 프로필을 수정할 수 있습니다.
    • 예약 내역
      • 내가 신청한 체험을 확인할 수 있습니다.
      • 신청 내용에 대한 업데이트(승인, 완료, 거절)를 확인할 수 있습니다.
    • 내 체험
      • 내가 등록한 체험을 확인할 수 있습니다.
      • 등록한 체험을 수정하거나 삭제할 수 있습니다.
    • 내 체험 관리
      • 내가 등록한 체험을 확인할 수 있습니다.
      • 체험에 때른 캘린더로, 받은 신청을 관리할 수 있습니다.


4. Technology Stack

  • Language
HTML5 HTML5
CSS3 CSS3
Javascript Javascript
Typescript Typescript

  • Library & Framework
React React 19.0.0
Next.js Next.js 15.2.11
Css_modules StyledComponents 6.7.1
React-query React query 5.67.3
Vervel Vercel 41.4.0

  • 협업 툴
Prittier Prittier
ESLint ESLint
Storybook ESLint
JSDoc JSDoc
Git git
Notion Notion
Figma Figma
Discord Discord

5. Project Structure **미완

GLOBALNOMAD/
├── .github/                    # GitHub 관련 파일 (예: 워크플로우, 이슈 템플릿)
├── .next/                      # Next.js 빌드 결과물
├── .storybook/                 # Storybook 설정 및 구성 파일
├── node_modules/               # npm 패키지 모듈 저장소
├── public/                     # 정적 파일 저장소 (예: 이미지, 폰트)
├── src/                        # 소스 코드 디렉토리
│   ├── api/                    # API 요청 관련 함수들
│   ├── app/                    # Next.js App Router 구조
│   │   ├── (auth)/             # 인증 관련 페이지 및 기능
│   │   ├── activities/         # 액티비티 상세 페이지
│   │   │   └── [id]/           # 액티비티 개별 상세 (동적 라우팅)
│   │   ├── landingComponents/  # 랜딩 페이지 관련 컴포넌트 모음
│   │   ├── myactivities/       # 내 활동 페이지
│   │   ├── mynotification/     # 알림 관련 페이지
│   │   ├── mypage/             # 마이페이지
│   │   ├── myreservation/      # 예약 관련 페이지
│   │   └── postMyActivity/     # 액티비티 등록 페이지
│   ├── utils/                  # 공통 유틸리티 함수들
│   ├── ClientLayout.tsx        # 클라이언트 전용 레이아웃 컴포넌트
│   ├── layout.tsx              # 루트 레벨 레이아웃 설정
│   ├── not-found.module.css    # 404 페이지 전용 스타일
│   ├── not-found.tsx           # 404 페이지 컴포넌트
│   └── page.tsx                # 루트 메인 페이지
├── components/                 # 프로젝트 전역 재사용 컴포넌트
├── constants/                  # 상수 정의 파일 모음
├── hooks/                      # 커스텀 훅 모음
├── lib/                        # 외부 라이브러리, 헬퍼 함수 모음
├── stores/                     # 상태관리 (예: Zustand, Redux 등)
├── stories/                    # Storybook 스토리 파일
├── styles/                     # 글로벌 스타일 파일 (CSS, SCSS)
├── types/                      # TypeScript 타입 정의
├── utils/                      # 유틸리티 함수 (src/utils와 다를 경우 확인 필요)
├── .env.local                  # 로컬 환경 변수 파일
├── .gitignore                  # Git 추적 제외 설정
├── .prettierrc                 # Prettier 코드 포맷 설정
├── eslint.config.mjs           # ESLint 설정 파일
├── next-env.d.ts               # Next.js 타입 정의 파일
├── next.config.ts              # Next.js 설정 파일
├── package-lock.json           # 의존성 버전 고정 파일
├── package.json                # 프로젝트 의존성 및 스크립트 설정
├── postcss.config.mjs          # PostCSS 설정 파일
├── README.md                   # 프로젝트 개요 및 설명
├── tsconfig.json               # TypeScript 설정 파일
└── vitest.config.ts            # Vitest 테스트 설정 파일




6. Development Workflow

브랜치 전략 (Branch Strategy)

  • Main Branch

    • 배포 가능한 상태의 코드를 유지합니다.
    • 모든 배포는 이 브랜치에서 이루어집니다.
  • features Branch

    • 최종 배포 브랜치 전, 마지막 점검 브랜치입니다.
    • 컨플릭 해결 및 테스트 코드 작성 후 배포 브랜치로 병합합니다.
  • 페이지/이슈번호/세부작업내용 (ex. signin/30/validation)

    • 가장 하위 개발 브랜치입니다.
    • 모든 기능 개발은 이 브랜치에서 이루어집니다.


커밋 태그

  • feat: 새로운 기능을 추가할 때 사용합니다.
    • 예: feat: add login functionality
  • fix: 버그를 수정할 때 사용합니다.
    • 예: fix: correct issue with user registration
  • docs: 문서와 관련된 변경사항 (README.md, API 문서 등).
    • 예: docs: update API documentation
  • style: 코드의 스타일(포맷팅, 세미콜론 누락 등) 변경으로, 기능적 변화는 없는 경우.
    • 예: style: format code to improve readability
  • refactor: 코드 리팩토링 (기능 변경 없이 코드 구조 개선).
    • 예: refactor: simplify user validation logic
  • test: 테스트 코드의 추가 또는 수정.
    • 예: test: add tests for authentication module
  • chore: 빌드, 도구 설정 등 기능적이지 않은 변경사항.
    • 예: chore: update dependencies
  • perf: 성능 개선 관련 변경사항.
    • 예: perf: optimize database query performance
  • build: 빌드 시스템이나 외부 종속성에 영향을 미치는 변경사항.
    • 예: build: update webpack configuration
  • revert: 이전 커밋을 되돌릴 때 사용합니다.
    • 예: revert: revert commit abc123
  • hotfix: 긴급하게 버그를 수정할 때 사용합니다.
    • 예: hotfix: fix critical login issue


About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 6