🎮 오늘도 망함 (Degrowth Diary)

나쁜 습관을 기록하면 몬스터가 생기는 역설적 자기계발 앱

📖 프로젝트 소개

오늘도 망함은 "망한 것도 기록이다"라는 철학으로 시작된 습관 추적 앱입니다.

완벽한 자기계발 앱에 지친 당신을 위해, 실패와 실수를 정직하게 기록하면 귀여운(?) 몬스터를 수집할 수 있습니다. 부끄러운 습관도 인정하는 것이 변화의 첫걸음입니다.

🎯 핵심 컨셉

• 역발상 게이미피케이션: 나쁜 습관 → 몬스터 획득 → 컬렉션 동기부여
• 낮은 진입 장벽: "괜찮았어요" 버튼으로 부담 없이 체크인
• 희귀 몬스터 시스템: 특정 시간대/요일에만 등장하는 한정 몬스터
• 긍정적 피드백: 몬스터가 격려해주는 따뜻한 세계관

✨ 주요 기능

🦖 몬스터 컬렉션

• 진화 시스템: 같은 실수를 반복하면 몬스터가 진화
• 희귀도 등급: Common → Rare → Epic → Legendary
• 속성 시스템: 식습관, 수면, 운동, 소비, 생산성 카테고리별 몬스터
• 한정 몬스터: 시간대/요일 조건부 등장 (예: 심야 배달 고블린, 금요일 폭식 드래곤)

📝 습관 기록

• 데일리 체크인: 오늘 어땠는지 간단히 기록
• 카테고리 선택: 5가지 주요 생활 영역
• 심각도 측정: 1~5단계로 실수의 정도 표시
• 메모 기능: 상황과 감정 기록

📊 통계 & 성장

• 연속 기록일: 앱 사용 스트릭 (나쁜 습관이 아닌 기록 습관)
• 카테고리별 분석: 어떤 영역에서 자주 실수하는지 시각화
• 도감 완성도: 전체 몬스터 중 보유 현황

🎨 UI/UX

• 다크 테마: 던전 느낌의 몰입감 있는 디자인
• 몬스터 서식지: 메인 화면에서 몬스터와 상호작용
• 오늘의 특별 몬스터: 현재 획득 가능한 희귀 몬스터 힌트

🛠️ 기술 스택

Frontend

• Flutter 3.x: Cross-platform UI framework
• Riverpod: State management & Dependency Injection
• GoRouter: Declarative routing
• Freezed: Immutable data classes

Backend

• Firebase Authentication: Google 소셜 로그인
• Cloud Firestore: NoSQL 실시간 데이터베이스
• Firebase Storage: 이미지 저장 (향후)
• Cloud Functions: 서버리스 백엔드 로직 (향후)

Architecture

• Clean Architecture: Domain/Data/Presentation 레이어 분리
• Repository Pattern: 데이터 소스 추상화
• Entity-Model 분리: 순수 비즈니스 로직과 Firebase 구현체 분리

📁 프로젝트 구조

lib/
├── app/                    # 앱 설정 (라우팅, 테마 등)
├── core/                   # 공통 코드
│   ├── constants/          # 상수 (색상, 텍스트, 샘플 데이터)
│   └── errors/             # 에러 처리
├── domain/                 # 비즈니스 로직 (Firebase 독립)
│   ├── entities/           # 순수 데이터 클래스
│   └── repositories/       # 추상 인터페이스
├── data/                   # 데이터 레이어
│   ├── models/             # DTO (JSON 직렬화)
│   ├── firebase/           # Firebase 구현체
│   └── local/              # Hive 로컬 캐시 (향후)
├── providers/              # Riverpod 상태 관리
└── presentation/           # UI 레이어
    ├── screens/            # 화면별 폴더
    └── widgets/            # 공통 위젯

아키텍처 다이어그램

┌─────────────────────────────────────┐
│  Presentation (Widgets)             │
├─────────────────────────────────────┤
│  Providers (Riverpod State)         │
├─────────────────────────────────────┤
│  Domain (Entities + Interfaces)     │  ← Firebase 독립 계층
├─────────────────────────────────────┤
│  Data (Firebase 구현체)             │
└─────────────────────────────────────┘

의존성 규칙: 상위 → 하위만 참조 가능 (역방향 금지)

🚀 Getting Started

사전 요구사항

• Flutter SDK 3.x 이상
• Dart 3.x 이상
• Firebase 프로젝트 설정
• Android Studio / VS Code

설치 및 실행

# 1. 저장소 클론
git clone https://github.com/yourusername/degrowth-diary.git
cd degrowth-diary

# 2. 의존성 설치
flutter pub get

# 3. Firebase 설정
# - Firebase Console에서 프로젝트 생성
# - google-services.json (Android)
# - GoogleService-Info.plist (iOS)
# 파일들을 각각 android/app, ios/Runner에 추가

# 4. 실행
flutter run

# 5. 특정 플랫폼 실행
flutter run -d chrome       # 웹
flutter run -d android      # 안드로이드
flutter run -d ios          # iOS

코드 생성 (Freezed/JSON)

flutter pub run build_runner build --delete-conflicting-outputs

📱 화면 구성

화면	설명	상태
🏠 홈	몬스터 서식지 + 데일리 체크인	✅ 완료
📝 기록하기	습관 기록 플로우	✅ 완료
📖 도감	몬스터 컬렉션	✅ 완료
📊 통계	카테고리별 분석	✅ 완료
📜 히스토리	과거 기록 조회	✅ 완료
⚙️ 설정	프로필, 알림, 계정	✅ 완료
🏆 업적	도전과제 시스템	✅ 완료

🗺️ 로드맵

Phase 1: MVP (현재)

• 기본 인증 (Google Login)
• 습관 기록 CRUD
• 몬스터 해금 시스템
• 희귀 몬스터 (시간/요일 조건)
• 데일리 체크인

Phase 2: 캐릭터 세계관 (진행 중)

• 몬스터 일러스트 에셋 적용
• 서식지 배경 디자인
• 몬스터 애니메이션
• 사운드 효과

Phase 3: 소셜 기능

• 친구 시스템
• 월간 리포트 카드 (SNS 공유용)
• 몬스터 교환 기능

Phase 4: 고도화

• 푸시 알림 (특별 몬스터 등장 알림)
• 주간 도전 과제
• 커뮤니티 피드
• 다국어 지원

🤝 기여하기

기여는 언제나 환영합니다! 다음 절차를 따라주세요:

1. 이 저장소를 Fork합니다
2. Feature 브랜치를 생성합니다 (git checkout -b feature/AmazingFeature)
3. 변경사항을 커밋합니다 (git commit -m 'feat: Add some AmazingFeature')
4. 브랜치에 Push합니다 (git push origin feature/AmazingFeature)
5. Pull Request를 생성합니다

커밋 컨벤션

Conventional Commits 스타일을 따릅니다:

• feat: 새로운 기능
• fix: 버그 수정
• docs: 문서 변경
• style: 코드 스타일 (포맷팅 등)
• refactor: 리팩토링
• test: 테스트 추가/수정
• chore: 빌드/설정 변경

📄 라이선스

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

📞 연락처

프로젝트 관련 문의나 제안사항이 있으시면 언제든지 연락주세요!

• Issues: GitHub Issues
• Discussions: GitHub Discussions

🙏 감사의 말

이 프로젝트는 다음 오픈소스 프로젝트들의 영감을 받았습니다:

• Flutter - 크로스 플랫폼 UI 프레임워크
• Riverpod - 강력한 상태관리 솔루션
• Firebase - 백엔드 인프라

---

오늘도 망했다면, 기록하세요. 몬스터가 기다립니다. 🦖

Made with ❤️ and 🍕 (야식)

---

📚 참고 문서

프로젝트 상세 문서는 docs/ 폴더를 참고하세요:

• 프로젝트 개요
• 기능 정의
• 기술 스택
• 아키텍처
• 데이터 스키마

Sources:

• Flutterando README Template
• Flutter Boilerplate README
• How to Create an Effective Flutter README
• Awesome README Examples