Life-is-a-Summer-Vacation

저장소: octxxiii/Life-is-a-Summer-Vacation

인생은 여름방학 (Life is a Summer Vacation)

여름방학을 게임보이 포켓몬 느낌으로 옮긴,
포모도로 타이머 + 곤충 수집 게임입니다.

• TIMER: 포모도로 타이머.
  • 집중을 끝까지 채우면 알 → 애벌레 → 번데기 → 성충으로 진화합니다.
  • 오버타임과 스트릭을 쌓을수록 **희귀한 벌레(사마귀, 호랑나비, 장수풍뎅이 등)**를 만날 확률이 올라갑니다.
• MAP: GitHub 잔디처럼 보이는 Safari Zone 맵.
  • 날짜별 집중 시간에 따라 풀숲의 농도가 달라집니다.
  • 타일을 누르면 그날 잡은 벌레를 도감 스타일 시트로 확인할 수 있습니다.
• DEX: 포켓몬 도감 느낌의 벌레 도감 화면.
  • 지금까지 등장 가능한 모든 종을 No.001부터 순서대로 보여주고,
  • 잡은 횟수와 최고 오버타임을 함께 기록합니다.
• CAMP: 캠프/설정 화면.
  • 사운드, 진동, 포커스 길이 조정,
  • iCloud/Drive 백업 및 복원, 진행도 초기화 등을 할 수 있습니다.

주요 기술 스택

• Flutter 3 / Dart 3
• 상태 관리: Riverpod
• 로컬 스토리지: SharedPreferences + JSON 스냅샷
• 네비게이션: go_router

개발용 실행 방법

cd "c:\dev\workspace\x\Life is a Summer Vacation"
flutter run -d windows

지원 대상:

• Windows (데스크톱)
• Android (USB 디버깅 허용 후 flutter run -d <deviceId>)
• Chrome / Edge (웹, -d chrome 또는 -d edge)

디버그 모드 전용 기능

• 도감 미리보기: 디버그 빌드에서는 Safari Zone 바닥의 도감 시트와 DEX 화면에서
  아직 잡지 못한 벌레도 ??? 상태로 모두 확인할 수 있습니다.

폴더 구조 개요

• lib/app – 라우터, 테마, 공통 설정
• lib/features/timer – 타이머, 세션, 타이머 상태 관리
• lib/features/evolution – 진화 규칙, 벌레 종 정의, 도감 화면
• lib/features/safari_zone – 맵, 날짜별 풀숲 그리드, 하루별 도감 시트
• lib/features/settings – CAMP(설정) 화면