BoxBox

F1 팬들을 위한 종합 모바일 애플리케이션

📱 앱 소개

BoxBox은 포뮬러 원 팬들을 위해 만들어진 종합적인 iOS 애플리케이션입니다. 최신 F1 뉴스, 레이스 일정, 드라이버 및 팀 순위, 상품 정보 등 다양한 기능을 제공합니다.

✨ 주요 기능

🏁 뉴스

• 최신 F1 관련 뉴스 및 소식
• 실시간 업데이트

🏎️ 레이스

• 레이스 일정 및 세션 정보
• 서킷 상세 정보
• 레이스 결과 확인

🏆 순위

• 드라이버 챔피언십 순위
• 팀 챔피언십 순위
• 실시간 순위 업데이트

🛍️ 상품

• F1 공식 상품
• 팀 및 드라이버 관련 용품

👤 프로필

• Google 계정으로 로그인
• 개인화된 사용자 경험
• 즐겨찾기 기능

🛠 기술 스택

• 프레임워크: SwiftUI
• 데이터베이스: SwiftData
• 인증: Firebase Auth, Google Sign-In
• 이미지 처리: SDWebImageSwiftUI
• 아키텍처: MVVM 패턴

📋 요구사항

• iOS 17.0+
• Xcode 15.0+

🚀 설치 및 실행

1. 이 저장소를 클론합니다:

git clone [repository-url]

2. Xcode에서 프로젝트를 엽니다:

open F1App.xcodeproj

3. GoogleService-Info.plist 파일을 프로젝트에 추가합니다.

4. 시뮬레이터나 실제 기기에서 앱을 실행합니다.

📁 프로젝트 구조

F1App/
├── F1App/
│   ├── Components/          # 재사용 가능한 컴포넌트
│   ├── Models/              # 데이터 모델
│   │   ├── Auth/           # 인증 관련 모델
│   │   ├── Circuit/        # 서킷 모델
│   │   ├── Driver/         # 드라이버 모델
│   │   ├── News/           # 뉴스 모델
│   │   ├── Result/         # 레이스 결과 모델
│   │   ├── Session/        # 세션 모델
│   │   └── Team/           # 팀 모델
│   ├── Utils/              # 유틸리티 클래스
│   ├── Views/              # 뷰 컴포넌트
│   │   ├── News/           # 뉴스 관련 뷰
│   │   ├── Profile/        # 프로필 관련 뷰
│   │   ├── Race/           # 레이스 관련 뷰
│   │   ├── Standing/       # 순위 관련 뷰
│   │   └── Store/          # 상점 관련 뷰
│   ├── ContentView.swift   # 메인 탭 뷰
│   ├── F1AppApp.swift      # 앱 엔트리 포인트
│   └── SplashView.swift    # 스플래시 화면
├── F1AppTests/             # 단위 테스트
└── F1AppUITests/           # UI 테스트

🔧 설정

Firebase 설정

1. Firebase 콘솔에서 새 프로젝트를 생성합니다.
2. iOS 앱을 추가하고 번들 ID를 설정합니다.
3. GoogleService-Info.plist 파일을 다운로드하여 프로젝트에 추가합니다.
4. Authentication에서 Google Sign-In을 활성화합니다.

📱 화면 구성

앱은 5개의 메인 탭으로 구성됩니다:

1. 뉴스: 최신 F1 소식과 뉴스
2. 레이스: 레이스 일정과 서킷 정보
3. 순위: 드라이버와 팀 순위
4. 상품: F1 공식 상품
5. 프로필: 사용자 정보 및 설정

🤝 기여

이 프로젝트에 기여하고 싶으시다면:

1. 프로젝트를 포크합니다
2. 기능 브랜치를 생성합니다 (git checkout -b feature/AmazingFeature)
3. 변경사항을 커밋합니다 (git commit -m 'Add some AmazingFeature')
4. 브랜치에 푸시합니다 (git push origin feature/AmazingFeature)
5. Pull Request를 생성합니다

📄 라이선스

이 프로젝트는 MIT 라이선스 하에 배포됩니다. 자세한 내용은 LICENSE 파일을 참조하세요.

📞 연락처

프로젝트 관련 문의사항이 있으시면 이석민으로 연락주세요.

---

개발자: 이석민
버전: 1.0.0
최종 업데이트: 2025년 11월