WayToEarth는 “단순 러닝 앱”을 넘어, 달린 거리 → 가상 여정 진행 → 스탬프/엠블럼 획득 → AI 러닝 분석 → 크루와 함께 달리기 까지 하나의 경험으로 묶은 스마트 러닝 플랫폼입니다.

사용자는 지루한 운동 기록이 아니라 이야기가 있는 여정, 의미 있는 성취, 함께 달리는 경험을 얻게 됩니다.

• 혼자 뛰면 지루하고 동기부여 부족
• 단순 거리/시간 기록 중심 → 재미 없음
• 소셜 기능·커뮤니티가 약함
• 개인화된 조언 부족

• 여정 기반 러닝: 달린 거리로 가상 코스를 여행
• 스탬프·엠블럼 게임화로 지속성 확보
• 크루 + 실시간 채팅으로 동기부여
• AI 러닝 분석/페이스 코치로 개인화된 피드백 제공

• GPS 기반 실시간 러닝 추적
• 워치 연동(Wear OS)
• 칼만 필터링으로 GPS 노이즈 제거
• 실시간 페이스/거리/고도/정확도 계산

• 실제 거리 → 가상 여정 진행
• Landmark 스토리 확인
• 자동 스탬프 획득
• 방명록 기능

• 크루 생성/가입/관리
• 실시간 채팅(WebSocket)
• 크루 랭킹 & 성장률
• 크루 MVP 자동 선정

• GPT 기반 페이스/러닝 분석
• 최근 5회 평균 페이스 기반 코칭
• 요일/거리/패턴 기반 트렌드 분석

• Mobile App (React Native)
• Wear OS App (Kotlin)
• Backend API (Spring Boot)
• OpenAI 기반 AI 분석 서버
• AWS 기반 인프라 (EC2 · ALB · RDS · ElastiCache · S3 · CloudFront)

• 사용자가 모바일 앱(App) 또는 Wear OS에서 요청을 보냅니다.

• 모든 요청은 HTTPS 기반으로 전송됩니다.
• Route53이 도메인(waytoearth.cloud)을 라우팅합니다.
• ACM(SSL)이 인증서를 적용하여 암호화된 통신을 유지합니다.
• 요청은 ALB(Application Load Balancer)로 전달됩니다.

• ALB는 서버 상태를 확인하고 트래픽을 EC2 Blue(8080) / Green(8081) 인스턴스 중 하나로 분산합니다.

• Spring Boot 애플리케이션이 핵심 비즈니스 로직을 처리합니다.
• 데이터 조회/저장, 인증, AI 분석, 크루 기능 처리 등이 이 레이어에서 수행됩니다.

• RDS(MariaDB) → 사용자, 러닝 기록, 크루, 여정, 피드 등 모든 핵심 서비스 데이터를 저장합니다.
• ElastiCache(Redis) → Refresh Token, 블랙리스트, 랭킹, 캐싱, 세션 등 빠른 처리와 성능을 최적화합니다.

• 프로필 이미지, 피드 이미지, 방명록 이미지 등은 CloudFront CDN을 통해 빠르게 전송됩니다.
• 캐시가 없으면 CloudFront가 S3 원본에서 파일을 조회합니다.
• 업로드는 Presigned URL 기반으로 클라이언트 → S3 직접 업로드 방식입니다.

• FCM → 러닝 알림, 크루 알림, 피드 반응 등 실시간 푸시 메시지를 전송합니다.
• OpenAI API → 러닝 데이터 기반 AI 분석 및 코칭을 생성합니다.

• 모든 처리가 완료되면 EC2 → ALB → HTTPS → App 순으로 사용자에게 응답이 반환됩니다.

• 3초 간격 위치 업데이트
• Kalman 2D 필터로 GPS 오차 보정
• 정지 상태 감지(10초 윈도우)
• 듀얼 컬러 경로 렌더링 (완료/미완료 구간)
• 워치 연동 + Session ID 기반 데이터 통합

• Journey → Route → Landmark 3계층 구조
• Landmark 도달 시 스탬프 자동 지급
• 유니크 스탬프 보장 로직
• 거리 기반 진행률 계산

• Presigned URL로 이미지 업로드
• 피드 삭제 시 S3 이미지 자동 삭제
• 좋아요 낙관적 락 처리

• WebSocket 기반 실시간 채팅
• ConcurrentHashMap으로 세션 관리
• N+1 해결 위한 Fetch Join
• 월간/주간 통계·랭킹

• GPT-4o-mini 기반 러닝 분석
• 트렌드 분석
• 페이스 코치

• React Native + TypeScript
• Expo / EAS Build
• Tanstack Query
• react-native-maps
• Expo-Location
• Firebase FCM
• WebSocket

• Spring Boot 3
• Spring Security (JWT)
• QueryDSL
• JPA & Hibernate
• Redis (Token & Cache)
• S3 / CloudFront
• WebSocket (STOMP)
• Swagger(OpenAPI)

• AWS EC2 · ALB · RDS · ElastiCache
• S3 / CloudFront
• GitHub Actions CI/CD
• Docker Blue/Green Deploy

• User 중심의 도메인
• Running, Journey, Crew, Feed 다중 연관
• Emblem/Stamp 체계적 설계
• FeedLike, CrewMember, UserProgress 등 N:M 다수

 Layered Architecture + Domain-Driven Design 혼합
  - 계층형 아키텍처로 명확한 책임 분리
  - 각 계층 내부는 도메인별 패키지로 구성

  ### 디렉터리 구조

  📁 src/main/java/com/waytoearth/
  ├── 📁 controller/v1/     # Presentation Layer
  │   ├── auth/             # 도메인별 API 엔드포인트
  │   ├── user/
  │   ├── running/
  │   ├── crew/
  │   └── ...
  │
  ├── 📁 service/           # Business Logic Layer
  │   ├── auth/
  │   ├── user/
  │   ├── running/
  │   └── ...
  │
  ├── 📁 repository/        # Data Access Layer
  │   ├── auth/
  │   ├── user/
  │   └── ...
  │
  ├── 📁 entity/            # Domain Model
  │   ├── auth/
  │   ├── user/
  │   ├── enums/
  │   └── ...
  │
  ├── 📁 dto/               # Data Transfer Objects
  │   ├── request/
  │   └── response/
  │
  └── 📁 config/            # Infrastructure
      ├── security/         # JWT, Spring Security
      ├── awsS3/
      ├── firebase/
      └── ...

주요 도메인: Auth(카카오 로그인), User, Running, Crew, Journey, Feed, Emblem, Notification

📁 WayToEarth_FE/
│
├── App.tsx                    # 앱 진입점
├── assets/                    # 이미지, 폰트
├── contexts/                  # 전역 컨텍스트 (Auth, Weather 등)
├── hooks/                     # 커스텀 훅
├── utils/                     # API 클라이언트, 공용 유틸
├── types/                     # TypeScript 타입 정의
├── navigation/                # 네비게이션 설정
├── styles/                    # 글로벌 스타일
├── scripts/                   # 빌드/유틸 스크립트
├── android/                   # Android 네이티브 구성
│
└── src/
    ├── app/
    │   ├── layout/            # 상단바/하단바 레이아웃
    │   └── screens/           # Main.tsx 등 주요 화면
    │
    └── features/              # 기능 중심 폴더링 (핵심)
        ├── auth/              # 로그인/회원가입
        ├── onboarding/        # 온보딩
        ├── crew/              # 크루 기능
        ├── running/           # 러닝 트래킹
        ├── journey/           # 여정/테마
        ├── landmark/          # 랜드마크/스탬프
        ├── feed/              # 피드
        ├── guestbook/         # 방명록
        ├── records/           # 러닝 기록/통계
        └── profile/           # 프로필/내 계정

BE,Infra	Full Stack	FE
홍성민(팀장)	이평강	정진호
한림대학교	한림대학교	한림대학교
빅데이터전공	빅데이터전공	콘텐츠IT전공
@hskhsmm	@leepg038292	@wjdwlsgh

본 프로젝트는 Apache License 2.0을 따릅니다.

Copyright 2025 WayToEarth

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.

WayToEarth는 러닝 · 여정 · 커뮤니티 · AI를 결합한 새로운 형태의 러닝 플랫폼입니다.

우리는 단순 운동 관리가 아니라 러닝을 하나의 여정으로 만드는 경험을 만들고자 합니다.

앞으로도 더 확장성과 안정성 있는 서비스로 발전할 예정입니다.