RunningDiary

🏃‍♂️ Running Diary

가입 없이 이용하는 개인 러닝 기록 앱

📱 앱 소개

Running Diary는 개인정보 보호를 최우선으로 하는 러닝 기록 앱입니다. 회원가입 없이 바로 사용할 수 있으며, 모든 데이터는 사용자의 기기 내부에만 안전하게 저장됩니다.

✨ 주요 특징

🔒 완전한 개인정보 보호: 모든 데이터는 기기 내부 저장
🚀 즉시 시작: 회원가입 없이 바로 사용 가능
📍 정확한 GPS 추적: 실시간 러닝 경로 및 통계 제공
📊 상세한 분석: 러닝 기록 및 통계 시각화
🗓️ 캘린더 뷰: 날짜별 러닝 기록 관리
🌤️ 날씨 정보: 러닝 시 날씨 정보 제공
💭 러닝 일기: 컨디션과 메모 기록
🗺️ 경로 시각화: 러닝 경로를 지도에 표시

🎯 핵심 기능

🏃‍♂️ 러닝 추적

실시간 GPS 추적: 정확한 위치 기반 거리 측정
자동 페이스 계산: 분/km 단위 실시간 페이스 표시
칼로리 소모량: 러닝 중 칼로리 소모량 계산
구간별 기록: 랩 타임 및 구간별 성과 분석

📊 통계 및 분석

주간/월간/연간 통계: 기간별 러닝 성과 분석
총 거리 및 시간: 누적 러닝 기록
평균 페이스: 전체 기간 평균 성과
개인 기록: 최고 기록 및 개선 추이

🗓️ 기록 관리

캘린더 뷰: 날짜별 러닝 기록 확인
상세 기록: 각 러닝 세션의 상세 정보
러닝 일기: 컨디션 및 메모 기록
경로 시각화: 카카오맵 기반 러닝 경로 표시

🔒 개인정보 보호

기기 내 저장: 모든 데이터는 기기 내부에만 저장
외부 전송 없음: 서버로 데이터 전송하지 않음
암호화 저장: SQLite 데이터베이스로 안전한 저장
완전 삭제: 언제든지 모든 데이터 삭제 가능

🛠️ 기술 스택

Frontend

Flutter 3.19.0: 크로스 플랫폼 모바일 앱 개발
Dart 3.3.0: 프로그래밍 언어
Provider: 상태 관리
Material Design: UI/UX 디자인

Backend & Database

SQLite: 로컬 데이터베이스
SQLiteStorageAdapter: 데이터 저장 어댑터
DatabaseService: 데이터베이스 관리 서비스

Location & Maps

Geolocator: GPS 위치 추적
Kakao Maps: 네이티브 지도 서비스
LocationService: 위치 서비스 관리
PermissionService: 권한 관리

Advertising

Google AdMob: 광고 수익화
AdService: 광고 서비스 관리

Weather

WeatherService: 날씨 정보 API 연동

📱 스크린샷

홈 화면

러닝 시작 버튼
최근 기록 목록
간단한 통계 정보

러닝 화면

실시간 러닝 정보
페이스, 거리, 시간 표시
일시정지/재개/종료 기능

기록 상세 화면

러닝 경로 지도
상세 통계 정보
러닝 일기 작성

통계 화면

기간별 통계 차트
성과 분석 그래프
개인 기록 관리

설정 화면

개인정보 보호 정책
앱 정보 및 문의
데이터 관리

🚀 시작하기

시스템 요구사항

iOS: iOS 15.2 이상
Android: Android 6.0 (API level 23) 이상
Flutter: 3.19.0 이상
Dart: 3.3.0 이상

설치 및 실행

저장소 클론

git clone https://github.com/your-username/running-diary.git
cd running-diary

의존성 설치
```
flutter pub get
```
iOS 설정 (iOS 개발 시)
```
cd ios
pod install
cd ..
```
앱 실행
```
flutter run
```

권한 설정

앱 사용을 위해 다음 권한이 필요합니다:

위치 권한: 러닝 경로 추적을 위해 필요
백그라운드 위치 권한: 러닝 중 앱이 백그라운드에 있을 때도 추적

📋 기능 상세

러닝 추적 시스템

실시간 GPS 추적 → 거리 계산 → 페이스 계산 → 통계 업데이트

데이터 저장 구조

RunningRecord
├── 기본 정보 (ID, 시작/종료 시간, 거리, 시간)
├── 통계 정보 (평균 페이스, 칼로리)
├── 경로 정보 (GPS 좌표 배열)
└── 랩 기록 (구간별 성과)

개인정보 보호 체계

사용자 기기 → SQLite 암호화 저장 → 외부 전송 없음 → 완전 삭제 가능

🎨 UI/UX 특징

디자인 원칙

직관적 사용성: 누구나 쉽게 사용할 수 있는 인터페이스
시각적 피드백: 러닝 중 실시간 정보 표시
일관성: 전체 앱에서 일관된 디자인 언어
접근성: 다양한 사용자를 고려한 접근성

색상 테마

주요 색상: 노란색 (#FFB300)
보조 색상: 네이비 블루 (#2E3A59)
배경 색상: 크림색 (#FFF8E1)
텍스트 색상: 다크 그레이 (#5D6B7A)

🔧 개발 정보

프로젝트 구조

lib/
├── main.dart                 # 앱 진입점
├── models/                   # 데이터 모델
├── providers/                # 상태 관리
├── screens/                  # 화면 UI
├── services/                 # 비즈니스 로직
├── utils/                    # 유틸리티
└── widgets/                  # 재사용 가능한 위젯

주요 패키지

dependencies:
  flutter: ^3.19.0
  provider: ^6.1.1
  geolocator: ^10.1.0
  google_mobile_ads: ^4.0.0
  sqflite: ^2.3.0
  path: ^1.8.3

📈 성능 최적화

메모리 관리

효율적인 상태 관리로 메모리 사용량 최적화
불필요한 위젯 리빌드 방지
이미지 및 리소스 최적화

배터리 최적화

GPS 사용 최적화로 배터리 소모 최소화
백그라운드 처리 효율화
불필요한 네트워크 요청 최소화

🔒 개인정보 보호

데이터 수집 범위

위치 정보: 러닝 경로 추적을 위한 GPS 좌표
러닝 기록: 거리, 시간, 페이스, 경로 데이터
기기 정보: 앱 사용을 위한 기본 기기 정보

보호 조치

모든 데이터는 사용자 기기 내부에만 저장
외부 서버로 데이터 전송하지 않음
위치 정보는 러닝 중에만 수집
데이터 암호화 저장 (SQLite 데이터베이스)

사용자 권리

언제든지 모든 데이터 삭제 가능
설정 > 데이터 삭제 메뉴에서 일괄 삭제
개별 기록 삭제 가능

📞 문의 및 지원

개발자 정보

개발자: Donghyung Lee
개발사: PuppyPaw
이메일: puppypaw2508201@gmail.com

문의 가능한 내용

앱 사용 관련 문의
버그 리포트
기능 제안
개인정보 관련 문의
기타 문의사항

답변 시간

일반 문의: 1-2일 내
개인정보 관련: 3일 내
긴급 문의: 24시간 내

📄 라이선스

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

🤝 기여하기

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

이 저장소를 포크합니다
새로운 기능 브랜치를 생성합니다 (git checkout -b feature/amazing-feature)
변경사항을 커밋합니다 (git commit -m 'Add some amazing feature')
브랜치에 푸시합니다 (git push origin feature/amazing-feature)
Pull Request를 생성합니다

📝 변경 이력

v1.0.0 (2025-08-15)

🎉 초기 릴리스
🏃‍♂️ 기본 러닝 추적 기능
📊 통계 및 분석 기능
🗓️ 캘린더 뷰
🔒 개인정보 보호 정책
📱 iOS 및 Android 지원

🙏 감사의 말

Flutter 팀: 훌륭한 크로스 플랫폼 프레임워크 제공
Kakao: 네이티브 지도 서비스 제공
Google: AdMob 광고 플랫폼 제공
오픈소스 커뮤니티: 다양한 패키지 및 라이브러리 제공

Running Diary와 함께 건강한 러닝 라이프를 시작하세요! 🏃‍♂️✨

“가입 없이, 안전하게, 편리하게”