Skip to content

safe-driving-idea-festival/Safe_Driving_Flutter

Repository files navigation

📱 안전 운전 🚀

License GitHub stars GitHub forks GitHub issues GitHub pull requests GitHub last commit

Dart Flutter

📋 목차


소개

Safe Driving Flutter App은 운전자의 주행 습관을 분석하고, 실시간 피드백과 교육 콘텐츠를 통해 안전 운전 문화를 확산시키기 위한 애플리케이션입니다. 이 앱은 운전 중 부주의나 위험 행동을 줄이고, 올바른 주행 습관을 자연스럽게 형성하도록 돕습니다.

초보 운전자부터 숙련된 운전자까지 모두를 대상으로 하며, 플러터(Flutter) 기반으로 제작되어 안드로이드와 iOS 모두에서 원활히 작동합니다. 핵심 기술로는 Dart, Flutter 프레임워크, 그리고 위치 서비스·데이터 분석·충돌 감지 등의 외부 API 연동이 포함됩니다.

이 앱의 가장 큰 특징은 실질적인 운전 보조 기능과 재미있는 학습 요소를 결합했다는 점입니다. 단순한 안전운전 보조 앱이 아닌, 즐겁게 참여할 수 있는 교육적 플랫폼을 지향합니다.


✨ 주요 기능

  • 🎯 실시간 피드백 — 과속, 급제동, 주행 중 휴대폰 사용 등을 즉시 감지하고 알림 제공
  • 최적화 성능 — 배터리 소모를 최소화하고 원활한 성능 유지
  • 🔒 데이터 보안 — 개인 정보 암호화 및 익명 처리로 안전한 데이터 관리
  • 🎨 직관적인 UI/UX — 보기 쉽고 조작하기 편리한 인터페이스
  • 📱 크로스 플랫폼 지원 — Android와 iOS 모두 완벽 지원
  • 🛠️ 사용자 맞춤 설정 — 알림 민감도, 주행 경고 기준 등을 개인별로 조정 가능

🚀 빠른 시작

3단계로 바로 실행하기:

git clone https://github.com/safe-driving-idea-festival/Safe_Driving_Flutter.git
cd Safe_Driving_Flutter
flutter pub get && flutter run

📦 설치 방법

필수 조건

  • Flutter SDK
  • Dart SDK
  • Android Studio 또는 Xcode (에뮬레이터/실기기 실행용)

설치 절차

  1. Flutter가 설치되어 있는지 확인합니다. 설치가 필요하다면 Flutter 공식 가이드를 참고하세요.

  2. 저장소를 클론합니다.

git clone https://github.com/safe-driving-idea-festival/Safe_Driving_Flutter.git
cd Safe_Driving_Flutter
  1. 의존성 패키지를 설치합니다.
flutter pub get
  1. 앱을 실행합니다.
flutter run

💻 사용 방법

앱 실행 후, 위치 접근 권한을 허용하면 자동으로 운전 패턴을 감지하고 실시간 피드백을 제공합니다.

설정 메뉴에서 과속·급제동 감도 및 알림 설정을 자유롭게 변경할 수 있습니다.


⚙️ 환경 설정

환경 변수 설정

루트 디렉터리에 .env 파일을 생성합니다.

API_KEY=your_api_key_here
DATABASE_URL=your_database_url

앱 설정 예시 (config.dart)

class AppConfig {
  static const String appName = "Safe Driving App";
  static const double sensitivityLevel = 0.8;
}

📁 프로젝트 구조

Safe_Driving_Flutter/
├── android/              # Android 전용 코드
├── ios/                  # iOS 전용 코드
├── lib/                  # Flutter 앱 소스 코드
│   ├── main.dart           # 앱 진입점
│   ├── models/             # 데이터 모델
│   ├── widgets/            # 공용 위젯
│   ├── screens/            # 주요 화면
│   ├── services/           # API 및 백엔드 통신 로직
│   └── utils/              # 유틸리티 함수
├── test/                 # 테스트 코드
├── pubspec.yaml          # Flutter 설정 파일
└── README.md             # 프로젝트 설명 문서

🤝 기여하기

기여를 환영합니다! 자세한 내용은 기여 가이드(CONTRIBUTING.md) 파일을 참고해주세요.

빠른 기여 절차

  1. 🍴 저장소 포크
  2. 🌟 새 브랜치 생성 (git checkout -b feature/AmazingFeature)
  3. ✅ 변경사항 커밋 (git commit -m 'Add AmazingFeature')
  4. 📤 브랜치 푸시 (git push origin feature/AmazingFeature)
  5. 🔃 Pull Request 생성

개발 환경 설정

git clone https://github.com/yourusername/Safe_Driving_Flutter.git
flutter pub get
git checkout -b feature/your-feature-name
flutter test
git commit -m "Description of changes"
git push origin feature/your-feature-name

코드 스타일 가이드

  • 기존 코드 스타일을 유지합니다.
  • 커밋 전 flutter analyze를 실행합니다.
  • 새로운 기능 추가 시 테스트를 포함합니다.
  • 문서(README 등)도 함께 업데이트해주세요.

🚀 배포

앱스토어 및 구글플레이 배포 가이드는 추후 추가될 예정입니다.


❓ FAQ

Q. 실시간 피드백의 정확도는 어느 정도인가요? A. 기기 센서 및 GPS 신호 세기에 따라 정확도가 달라질 수 있습니다.


📄 라이선스

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

요약

  • ✅ 상업적 사용 가능
  • ✅ 수정 및 배포 가능
  • ✅ 개인적 사용 가능
  • ❌ 책임 보장 없음
  • ❌ 보증 없음

💬 지원


📚 사용된 주요 라이브러리:

About

졸음 운전, 주시 태만을 위한 AI를 활용한 어플리케이션

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages