반려견 산책 모임 서비스 '멍로드'

📌 OverView

💻 개요
반려견과 함께할 친구를 찾기 어려운 문제를 해결하기 위해, 반려견 보호자와 비반려인이 함께 산책 모임을 즐길 수 있는 커뮤니티 플랫폼입니다.
정기·번개 모임을 통해 꾸준한 산책 루틴과 신뢰 기반의 건강한 반려 문화 형성을 목표로 합니다.

📎 배포 링크
https://www.meong-road.site

🗓️ 개발 기간
2025.09.15 - 2025.11.04

🎥 시연 영상
https://drive.google.com/file/d/1LgqsgAKcneHQNsTeSZodP2tLIpFXGnyr/view?usp=drive_link

👩🏻‍💻Developers🧑🏻‍💻

👤 이름	이수빈	서웅덕	이한별	한상휘
🔗 GitHub	ddongguri-bing	sn14188	2hanbyeol1	Sangmwi

🚀 Tech Stack

IDE

Package Manager

Framework
  

Styling
     

State Manager

Server State Manager

Test
  

Code Quality/Git Hooks
     

Deploy
  

Collaboration Tool
     

Library

➕ MORE

Next.js 15(App Router)와 React 19 기반으로 구축한 프론트엔드 애플리케이션입니다.
TypeScript와 TailwindCSS 4를 사용하며, React Query와 MSW(Mock Service Worker)로 데이터 페칭과 API 모킹 환경을 제공합니다.

시작하기

pnpm install
pnpm dev

• 개발 서버는 기본적으로 http://localhost:3000 에서 실행됩니다.
• src/app/layout.tsx에서 React Query Provider와 MSW Provider가 초기화되므로, 실행과 동시에 모킹 API가 동작합니다.

주요 명령어

pnpm dev           # 개발 서버 실행
pnpm build         # 프로덕션 빌드 생성
pnpm start         # 빌드 결과 실행
pnpm test          # 전체 Jest 테스트 실행

프로젝트 구조

src/
  app/          # App Router 엔트리, 레이아웃, 페이지 및 전역 스타일
  assets/       # 폰트/이미지 자산 인덱스 파일
  components/   # 재사용 컴포넌트 엔트리(구현 예정)
  hooks/        # 커스텀 훅 엔트리(구현 예정)
  mocks/        # MSW 서버/워커 설정과 요청 핸들러
  providers/    # React Query, MSW 등 전역 Provider 컴포넌트
  store/        # Zustand 스토어 엔트리(구현 예정)
  utils/        # 공용 유틸 함수 (`cn` 등)

빌드 & 배포 파이프라인

• GitHub Actions 워크플로우
  • deploy-preview.yml: dev 브랜치 PR/머지 시 프리뷰 배포
  • deploy-production.yml: main 브랜치 PR/머지 시 프로덕션 배포
  • 공통 단계: Checkout → Node 20 & pnpm 세팅 → pnpm install --frozen-lockfile → pnpm test → Vercel CLI pull/build/deploy
• Vercel 설정
  • .vercel/project.json에 조직/프로젝트 ID 저장
  • vercel.json에서 Git 연동 배포 비활성화 → CI를 통한 수동 배포 흐름 유지