MathLab

🧮 GoMath - 게이미피케이션 수학 학습 앱

듀오링고 스타일의 게이미피케이션을 적용한 재미있는 수학 학습 모바일 앱입니다. 매일 짧은 시간 동안 꾸준히 수학을 학습하며 동기를 유지할 수 있도록 설계되었습니다.

🌐 데모

웹 버전: https://chatgptkrguide.github.io/MathLab/

✨ 주요 기능

📚 학습 시스템

레벨 테스트: 초기 진단 평가로 사용자 실력 파악
적응형 학습: AI 기반 난이도 조절 및 취약 영역 집중 학습
다양한 문제 유형: 객관식, 드래그 앤 드롭, 단답형
단계별 힌트: 막힐 때 단계별 도움말 제공

🎮 게이미피케이션

경험치(XP) 시스템: 문제를 풀면서 XP 획득
연속 학습 스트릭: 매일 학습하여 스트릭 유지
레벨 시스템: Bronze → Silver → Gold → Diamond
업적 뱃지: 다양한 학습 성취 뱃지
리그 경쟁: 주간 리그 시스템으로 친구들과 경쟁

📊 학습 관리

일일 목표: 개인 맞춤형 일일 XP 목표 설정
학습 통계: 상세한 학습 진행 상황 및 통계
오답 노트: 틀린 문제 자동 저장 및 복습
학습 리마인더: 알림을 통한 학습 습관 형성

🛠 기술 스택

Frontend

Framework: Flutter 3.27.1 (크로스 플랫폼)
상태관리: Riverpod 2.4.9
로컬 저장: SharedPreferences, Hive
애니메이션: Lottie, Confetti

Backend & Authentication

인증: Firebase Authentication
소셜 로그인: Google, Kakao, Apple Sign-in
데이터베이스: Local Storage (향후 PostgreSQL + Redis)

주요 라이브러리

dependencies:
  flutter_riverpod: ^2.4.9      # 상태 관리
  shared_preferences: ^2.2.2     # 로컬 저장
  lottie: ^2.7.0                 # 애니메이션
  confetti: ^0.7.0               # 축하 효과
  firebase_core: ^3.10.0         # Firebase
  firebase_auth: ^5.3.4          # 인증
  google_sign_in: ^6.2.1         # Google 로그인
  kakao_flutter_sdk: ^1.9.5      # Kakao 로그인
  sign_in_with_apple: ^6.1.3     # Apple 로그인

📱 지원 플랫폼

✅ iOS (iPhone, iPad)
✅ Android (스마트폰, 태블릿)
✅ Web (데스크톱 브라우저)
🚧 macOS (개발 중)
🚧 Windows (개발 중)

🚀 시작하기

요구사항

Flutter SDK 3.27.1 이상
Dart 3.5.0 이상
Android Studio / Xcode (모바일 빌드용)

설치 및 실행

저장소 클론

git clone https://github.com/chatgptkrguide/MathLab.git
cd MathLab

의존성 설치
```
flutter pub get
```

앱 실행

# iOS
flutter run -d ios

# Android
flutter run -d android

# Web
flutter run -d chrome

빌드

# Android APK
flutter build apk --release

# iOS (macOS 필요)
flutter build ios --release

# Web
flutter build web --release

📖 커리큘럼

기초 과정

사칙연산 (덧셈, 뺄셈, 곱셈, 나눗셈)
분수와 소수
비와 비율

중급 과정

대수 (방정식, 부등식, 함수)
기하 (도형, 각도, 면적, 부피)
통계와 확률

고급 과정 (예정)

미적분 (극한, 미분, 적분)
선형대수
고급 통계

🎨 디자인 시스템

프로젝트는 Figma 디자인 시스템을 기반으로 구축되었습니다.

색상: 밝고 친근한 GoMath 브랜드 색상 팔레트
타이포그래피: 가독성 중심의 폰트 계층 구조
애니메이션: 부드럽고 자연스러운 전환 효과
레이아웃: 모바일 우선 반응형 디자인

자세한 내용은 DESIGN_GUIDE.md를 참조하세요.

📂 프로젝트 구조

lib/
├── app/                    # 앱 설정 및 라우팅
├── data/
│   ├── models/            # 데이터 모델
│   ├── providers/         # Riverpod 상태 관리
│   └── services/          # API 및 저장소 서비스
├── features/              # 기능별 화면
│   ├── auth/             # 인증
│   ├── home/             # 홈 화면
│   ├── lessons/          # 레슨
│   ├── problem/          # 문제 풀이
│   ├── profile/          # 프로필
│   └── ...
├── shared/
│   ├── constants/        # 상수 (색상, 스타일 등)
│   ├── widgets/          # 공통 위젯
│   ├── utils/            # 유틸리티
│   └── themes/           # 테마
└── main.dart             # 앱 진입점

🎯 로드맵

Phase 1 (MVP) - ✅ 완료

Phase 2 - 🚧 진행 중

백엔드 API 구축
실시간 데이터 동기화
친구 시스템
그룹 학습 기능

Phase 3 - 📋 계획

AI 튜터 모드
오프라인 모드
부모 모드 (자녀 학습 추적)
다국어 지원

🤝 기여하기

기여를 환영합니다! 다음 단계를 따라주세요:

Fork the Project
Create your Feature Branch (git checkout -b feature/AmazingFeature)
Commit your Changes (git commit -m 'Add some AmazingFeature')
Push to the Branch (git push origin feature/AmazingFeature)
Open a Pull Request

📄 라이선스

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

📞 문의

프로젝트 관련 문의사항은 Issues에 등록해 주세요.

Made with ❤️ by GoMath Team

🤖 Enhanced with Claude Code