대카(Dae-Car) 🚗

대학생을 위한 카풀 및 택시 셰어 플랫폼

📋 프로젝트 개요

대카(Dae-Car)는 대학생들이 안전하고 편리하게 이동할 수 있도록 도와주는 카풀 및 택시 셰어 서비스입니다. 대학생 인증을 통해 안전한 플랫폼을 제공하며, 실시간 채팅과 위치 추적 기능을 통해 편리한 이동 경험을 제공합니다.

✨ 주요 기능

🎓 대학생 인증

• 대학생 이메일 인증
• 운전자 면허증 OCR 인증
• 차량 번호판 OCR 인증

🚗 카풀 서비스

• 카풀 방 생성 및 참여
• 실시간 채팅
• 위치 기반 매칭

🚕 택시 셰어 서비스

• 택시 셰어 방 생성 및 참여
• 비용 분할 계산
• 실시간 추적

💬 실시간 커뮤니케이션

• WebSocket 기반 실시간 채팅
• 채팅방 관리
• 메시지 히스토리

🛠 기술 스택

Frontend

• Next.js 15.2.4 - React 프레임워크
• TypeScript - 타입 안전성
• Tailwind CSS - 스타일링
• shadcn/ui - UI 컴포넌트 라이브러리

UI/UX

• Radix UI - 접근성 우선 컴포넌트
• Framer Motion - 애니메이션
• Lucide React - 아이콘

상태 관리 & API

• React Hook Form - 폼 관리
• Zod - 스키마 검증
• Axios - HTTP 클라이언트

실시간 통신

• STOMP.js - WebSocket 통신
• SockJS - WebSocket 폴백

개발 도구

• ESLint - 코드 린팅
• PostCSS - CSS 처리
• Autoprefixer - CSS 벤더 프리픽스

📁 프로젝트 구조

2025_CHUNGNAM_TEAM_3_FE/
├── app/                     # Next.js 앱 라우터
│   ├── auth/               # 대학생 인증 페이지
│   ├── carpool/            # 카풀 관련 페이지
│   ├── Taxi/               # 택시 셰어 관련 페이지
│   ├── driver-auth/        # 운전자 인증 페이지
│   ├── driver/             # 운전자 페이지
│   ├── join/               # 회원가입 페이지
│   ├── login/              # 로그인 페이지
│   └── main/               # 메인 페이지
├── components/             # 재사용 가능한 컴포넌트
│   ├── ui/                 # shadcn/ui 컴포넌트
│   └── layout/             # 레이아웃 컴포넌트
├── lib/                    # 유틸리티 및 API
│   ├── api/                # API 관련 코드
│   └── hooks/              # 커스텀 훅
├── types/                  # TypeScript 타입 정의
└── public/                 # 정적 파일

🚀 시작하기

필수 요구사항

• Node.js >= 18
• npm >= 9

설치 및 실행

1. 저장소 클론

   git clone https://github.com/2025-CHUNGNAM-TEAM-3/2025_CHUNGNAM_TEAM_3_FE.git
   cd 2025_CHUNGNAM_TEAM_3_FE

2. 의존성 설치

   npm install
   # 또는
   yarn install

3. 개발 서버 실행

   npm run dev
   # 또는
   yarn dev

4. 브라우저에서 확인

   http://localhost:3000
   

빌드 및 배포

# 프로덕션 빌드
npm run build

# 프로덕션 서버 실행
npm run start

# 코드 린팅
npm run lint

📱 주요 화면

메인 화면

• 대카 로고 및 대학생 인증 버튼
• 간단하고 직관적인 UI

인증 화면

• 대학생 이메일 인증
• 운전자 면허증 OCR 인증
• 차량 번호판 OCR 인증

서비스 화면

• 카풀/택시 방 목록 및 생성
• 실시간 채팅
• 위치 추적 및 결제

🔧 개발 환경 설정

VS Code 확장 프로그램 권장

• ES7+ React/Redux/React-Native snippets
• Tailwind CSS IntelliSense
• TypeScript Importer
• Prettier - Code formatter

코드 스타일

• Prettier를 사용한 코드 포맷팅
• ESLint를 사용한 코드 품질 관리
• Tailwind CSS를 사용한 일관된 스타일링

🤝 기여하기

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

📄 라이선스

© 2025 DAECAR. All rights reserved.

👥 팀

2025 충남톤 Team 3

• Frontend Development Team

---

안전하고 편리한 대학생 이동 서비스, 대카와 함께하세요! 🚗