마라톤 대회 일정 - 모바일 최적화 서비스

프로젝트 개요

기존 마라톤 대회 일정 사이트(http://marathon.pe.kr/index_calendar.html)를 모바일에 최적화하여 제공하는 SpringBoot 기반 웹 애플리케이션입니다.

주요 기능

• 📱 모바일 최적화된 반응형 UI/UX
• 🔍 다양한 조건으로 마라톤 대회 검색
  • 종목별 필터 (풀코스, 하프, 10K, 5K, 기타)
  • 요일별 필터
  • 접수상태별 필터 (접수중, 접수완료, 접수예정)
  • 지역별 필터 (전국 17개 시도)
  • 년도/월별 필터
• 🏃‍♂️ 실시간 대회 정보 제공
• 📅 대회 일정 캘린더 뷰
• 🔗 대회 접수 링크 연결
• 💾 PWA 지원 (앱 설치 가능)

기술 스택

• Backend: Spring Boot 3.2.0, JPA/Hibernate
• Frontend: Thymeleaf, HTML5, CSS3, JavaScript
• Database: H2 (개발), PostgreSQL (운영)
• Build Tool: Gradle 8.4
• Deployment: Docker, CloudType.io

로컬 실행 방법

사전 요구사항

• Java 17 이상
• Gradle 8.x 이상 (또는 Gradle Wrapper 사용)

실행 단계

# 저장소 클론
git clone [repository-url]
cd marathon-mobile-app

# 애플리케이션 실행
./gradlew bootRun

애플리케이션이 실행되면 http://localhost:8080 에서 확인할 수 있습니다.

Gradle 명령어

# 프로젝트 빌드
./gradlew build

# 애플리케이션 실행
./gradlew bootRun

# 테스트 실행
./gradlew test

# JAR 파일 생성
./gradlew bootJar

Docker로 실행

# Docker 이미지 빌드
docker build -t marathon-mobile-app .

# 컨테이너 실행
docker run -p 8080:8080 marathon-mobile-app

CloudType.io 배포

1. GitHub에 소스코드 푸시
2. CloudType.io에서 새 프로젝트 생성
3. GitHub 저장소 연결
4. 빌드팩: Java 선택
5. 빌드 명령: ./gradlew bootJar
6. 실행 명령: java -jar build/libs/marathon-mobile-app.jar
7. 포트: 8080 설정
8. 자동 배포 완료

환경 변수 설정 (운영 환경)

# 데이터베이스 설정 (PostgreSQL 사용시)
SPRING_DATASOURCE_URL=jdbc:postgresql://[host]:[port]/[database]
SPRING_DATASOURCE_USERNAME=[username]
SPRING_DATASOURCE_PASSWORD=[password]

# 프로파일 설정
SPRING_PROFILES_ACTIVE=prod

API 엔드포인트

• GET / - 메인 페이지
• GET /api/events - 마라톤 이벤트 API (JSON)
  • 쿼리 파라미터: category, dayOfWeek, registrationStatus, region, year, month

프로젝트 구조

src/
├── main/
│   ├── java/com/marathon/app/
│   │   ├── MarathonMobileApplication.java
│   │   ├── controller/
│   │   │   └── MarathonController.java
│   │   ├── model/
│   │   │   ├── MarathonEvent.java
│   │   │   └── MarathonEventRepository.java
│   │   ├── service/
│   │   │   ├── MarathonEventService.java
│   │   │   └── MarathonCrawlerService.java
│   │   └── config/
│   │       └── DataInitializer.java
│   └── resources/
│       ├── templates/
│       │   └── index.html
│       ├── static/
│       │   ├── css/style.css
│       │   ├── js/app.js
│       │   └── manifest.json
│       └── application.properties
└── test/
    └── java/com/marathon/app/

build.gradle          # Gradle 빌드 설정
settings.gradle       # Gradle 프로젝트 설정
gradle/               # Gradle Wrapper 파일들
gradlew              # Gradle Wrapper 실행 스크립트 (Unix)

특징

• 모바일 퍼스트: 모바일 환경에 최적화된 UI/UX
• 반응형 디자인: 다양한 화면 크기에 적응
• Progressive Web App: 앱 설치 및 오프라인 지원
• 실시간 데이터: 자동 크롤링으로 최신 정보 제공
• 사용자 친화적: 직관적인 필터링 및 검색 기능

개발 계획

• 실제 마라톤 사이트 크롤링 구현
• 사용자 즐겨찾기 기능
• 푸시 알림 기능
• 대회 후기 및 평점 시스템
• 카카오맵/네이버맵 연동

라이센스

MIT License

기여 방법

1. Fork the repository
2. Create a feature branch
3. Commit your changes
4. Push to the branch
5. Create a Pull Request

문의

이슈나 개선사항이 있으시면 GitHub Issues를 통해 문의해주세요.