Running Diary 🏃♀️
Running Diary는 단순한 거리와 페이스 기록을 넘어, 러닝 당시의 컨디션과 경험까지 함께 저장하는 러닝 기록 iOS 앱입니다.
HealthKit 자동 연동으로 러닝 데이터를 손쉽게 불러오고, 통증 부위·수면·메모 등의 컨디션을 기록하여 러닝과 몸 상태의 상관관계를 분석할 수 있습니다. 날씨 자동 조회로 환경 요인도 함께 추적하며, 월별 캘린더로 장기 패턴을 한눈에 파악할 수 있습니다.
주요 기능
HealthKit 자동 연동으로 손쉬운 기록
HealthKit에서 러닝 데이터(거리, 페이스, 심박수, 케이던스, 경로)를 자동으로 불러와 수동 입력 없이 빠르게 기록을 관리할 수 있습니다.
컨디션 기록으로 부상 예방
통증 부위, 주법, 수면 시간, 메모 등을 기록하여 러닝과 컨디션의 상관관계를 파악하고 부상 패턴을 분석할 수 있습니다.
환경 요인 추적
러닝 경로를 기반으로 당시 날씨(온도, 습도, 풍속)를 자동 조회하여 환경이 기록에 미치는 영향을 함께 분석합니다.
장기 패턴 파악
무한 스크롤 캘린더와 월별 총 거리 통계로 러닝 습관과 성장 추세를 장기적으로 확인할 수 있습니다.
앱 스크린샷
스크린샷은 screenshots.pro를 사용하여 제작되었습니다.
화면 흐름도
graph TD
subgraph " "
A("<img src='fastlane/screenshots/ko/1.png' width='200' alt='화면 1'><br><b>캘린더/메인</b>")
end
subgraph " "
B("<img src='fastlane/screenshots/ko/2.png' width='200' alt='화면 2'><br><b>일자별 기록</b>")
end
subgraph " "
C("<img src='fastlane/screenshots/ko/4.png' width='200' alt='화면 4'><br><b>기록 추가</b>")
end
A -- "일자 선택" --> B
B -- "추가하기" --> C
C -- "저장" --> B
style A fill:#fff,stroke:#ddd,stroke-width:1px,rx:10,ry:10
style B fill:#fff,stroke:#ddd,stroke-width:1px,rx:10,ry:10
style C fill:#fff,stroke:#ddd,stroke-width:1px,rx:10,ry:10
프로젝트 구조 (Project Structure)
RunDiary
├── RunDiary # 메인 앱 타겟 (UI, Feature 조합)
│ ├── Sources # 앱 엔트리 포인트 및 메인 소스
│ └── Resources # 에셋, Info.plist 등
├── Dependencies # 기능별 모듈 (SPM)
│ ├── CommonFoundation # 공통 유틸리티, 익스텐션
│ ├── Models # 데이터 모델 (Domain Entities)
│ ├── HealthKitService # HealthKit 연동 서비스
│ ├── WeatherKitService # 날씨 정보 조회 서비스
│ ├── PersistencesService # SwiftData 저장소
│ └── DependencyProxy # 모듈 간 의존성 관리
기술 구현 현황
아키텍처 & 패턴
- ✅ TCA 아키텍처: State-Action-Reducer 패턴으로 예측 가능한 상태 관리
- ✅ Repository 패턴: 데이터 접근 추상화로 도메인과 퍼시스턴스 분리
- ✅ 의존성 주입: TCA Dependency 시스템으로 테스트 용이성 확보
데이터 & 통합
- ✅ SwiftData 퍼시스턴스: CRUD 작업 완전 구현, 트랜잭션 관리
- ✅ HealthKit 통합: 거리, 페이스, 심박수, 케이던스, 경로 데이터 수집
- ✅ MapKit 통합: 러닝 경로 지도 시각화 (Polyline)
- ✅ WeatherKit 통합: 온도, 습도, 풍속 자동 조회
성능 & 최적화
- ✅ 월 단위 데이터 캐싱: 불필요한 DB/네트워크 조회 방지
- ✅ 병렬 데이터 조회: HealthKit + SwiftData 동시 조회로 성능 개선
- ✅ 캘린더 무한 스크롤: Lazy Loading으로 효율적인 데이터 로드
품질
- ✅ Swift Testing + TCA TestStore: 주요 Feature 및 Client 테스트 커버리지
- ✅ 3개 언어 로컬라이제이션: 한국어, 영어, 일본어
- ✅ GitHub Actions CI/CD: 자동 빌드 및 테스트
기술 스택
핵심
- SwiftUI: 선언적 UI 프레임워크
- TCA (The Composable Architecture): 단방향 데이터 흐름과 합성 가능한 아키텍처
- Swift Concurrency: async/await 기반 비동기 처리
데이터 & 위치
- SwiftData: 퍼시스턴스 프레임워크
- MapKit: 지도 및 경로 렌더링
통합
- HealthKit: 러닝 데이터 수집
- WeatherKit: 날씨 정보 조회
개발 도구
- Swift Testing: 테스트 프레임워크
- SwiftLint: 코드 스타일 검사 (
brew install swiftlint 필요, 검사는 ./Scripts/swiftlint.sh)
- GitHub Actions: CI/CD
- HorizonCalendar: 캘린더 UI
📚 더 자세한 문서 (Documentation)
이 프로젝트의 상세한 기술 내용은 GitHub Wiki에서 확인할 수 있습니다.
협업
Git 워크플로우, 커밋/PR 규칙, 개발 가이드라인은 CONTRIBUTING.md를 참고하세요.
