🧊 얼공 (IceStudy) - 얼음공부법 집중 타이머

"얼음이 녹을 때까지, 집중."

---

소개

얼공은 SNS에서 유행하는 얼음공부법을 앱으로 구현한 학습 집중 타이머입니다.

남은 시간을 보여주지 않고, 얼음이 녹는 애니메이션만으로 집중을 유도합니다. 컵 사이즈를 고르면 랜덤 시간이 설정되고, 얼음이 다 녹으면 공부 끝!

주요 기능

1. 랜덤 타이머

남은 시간은 비밀. 얼음이 다 녹을 때까지 집중하세요.

• 컵 사이즈(Tall/Grande/Venti)에 따라 랜덤 시간 설정
• 남은 시간/퍼센트 일절 비공개
• 얼음이 녹는 것만 보고 집중

2. 얼음 녹는 애니메이션

컵마다 녹는 속도가 달라요. Grande는 천천히, Venti는 더~ 천천히.

• 43개 얼음 블록이 8레이어로 자연스럽게 녹음
• 컵 사이즈별 비선형 이징 커브 적용
• 아래부터 물이 차오르는 시각적 피드백

3. 주간 대시보드

이번 주에 녹인 물을 양동이에 담아보세요.

• 유리 양동이에 채워지는 물양으로 공부량 시각화
• 주간 슬라이드 전환으로 과거 기록 확인
• 목표량 초과 시 특별한 변화

4. 캘린더

한 달간의 공부 기록을 한눈에.

• 월별 일일 공부시간 + 물양 기록
• 농도로 공부량 시각화

5. 프로필 통계

녹인 얼음 수, 총 물양, 총 공부시간을 한눈에.

• 전체 통계 요약
• 주간 바 차트 (스크린타임 스타일)

6. 부가 기능

집중을 도와주는 작은 기능들.

• 백색소음 / 빗소리 / 숲소리 (AVAudioEngine)
• 집중모드 (화면 꺼짐 방지)
• 타이머 결과 공유 (인스타 카드)
• 위젯 지원 (이번 주 물양 확인)

프로젝트 구조

iOS

IceStudy/
├── App/
│ └── IceStudyApp.swift # @main 엔트리
│
├── Models/
│ ├── CupSize.swift # 컵 사이즈 enum (Tall/Grande/Venti)
│ └── TemperatureZone.swift # 온도 기반 물양 계산
│
├── ViewModels/
│ ├── AuthViewModel.swift # 인증 상태 관리
│ └── TimerViewModel.swift # 타이머 로직 + 백그라운드 보정
│
├── Views/
│ ├── Splash/
│ │ └── SplashView.swift # 스플래시 (2초)
│ ├── Onboarding/
│ │ └── OnboardingView.swift # 최초 1회 온보딩
│ ├── Auth/
│ │ ├── LoginView.swift # Apple 로그인 + 이메일
│ │ ├── SignUpView.swift # 회원가입
│ │ └── NicknameSetupView.swift # 닉네임 설정
│ ├── Home/
│ │ ├── HomeView.swift # 주간 대시보드 + 양동이
│ │ └── CalendarView.swift # 월별 캘린더
│ ├── Timer/
│ │ ├── IceTimerFlowView.swift # 상태 기반 화면 전환
│ │ ├── CupSelectionView.swift # 컵 선택 (3카드)
│ │ ├── TimerRunningView.swift # 타이머 실행 화면
│ │ ├── TimerResultView.swift # 완료/포기 결과
│ │ └── IceMeltingView.swift # 얼음 녹는 애니메이션
│ ├── Profile/
│ │ ├── ProfileView.swift # 프로필 통계
│ │ ├── WeeklyChartView.swift # 주간 바 차트
│ │ └── SettingsView.swift # 설정 (닉네임/비밀번호/���퇴)
│ └── Components/
│ ├── MainTabView.swift # 3탭 (양동이/얼음/마이)
│ ├── LogoHeaderView.swift # 로고 헤더
│ ├── PrimaryButton.swift # 공통 버튼
│ └── GlassCupShape.swift # 유리컵 커스텀 Shape
│
├── Network/
│ ├── TokenStorage.swift # Keychain 기반 JWT 저장
│ ├── APIError.swift # 에러 타입
│ ├── DTO/ # AuthDTO, SessionDTO, StatsDTO
│ ├── API/ # Moya TargetType (Auth/Session/Stats/User)
│ └── Service/ # API 서비스 레이어
│
├── Services/
│ ├── LocationService.swift # 위치 요청 (CLLocationManager)
│ ├── WeatherService.swift # 온도 조회 (Open-Meteo)
│ └── WhiteNoiseService.swift # 백색소음/빗소리/숲소리
│
└── Utils/
├── Constants.swift # AppColor, AppFont
├── NotificationManager.swift # 푸시 알림 관리
└── WidgetData.swift # 위젯 데이터 공유
IceStudyWidget/ # 위젯 Extension
├── IceStudyWidget.swift # 위젯 UI + Timeline
└── IceStudyWidgetBundle.swift # Widget Bundle

Backend

icestudy-api/
└── src/main/java/com/icestudy/
├── config/
│ ├── SecurityConfig.java # Spring Security 설정
│ ├── JwtProvider.java # JWT 생성/검증
│ ├── JwtAuthenticationFilter.java # 인증 필터
│ ├── SwaggerConfig.java # API 문서
│ └── ScheduleConfig.java # 스케줄링
│
├── domain/
│ ├── auth/ # 인증 (이메일 + Apple)
│ │ ├── AuthController.java
│ │ ├── AuthService.java
│ │ ├── AppleTokenVerifier.java
│ │ └── dto/
│ ├── user/ # 유저 관리
│ │ ├── UserController.java
│ │ ├── UserService.java
│ │ └── dto/
│ ├── session/ # 공부 세션
│ │ ├── SessionController.java
│ │ ├── SessionService.java
│ │ ├── WaterCalculator.java # 물양 계산 로직
│ │ └── dto/
│ └── stats/ # 통계
│ ├── StatsController.java
│ ├── StatsService.java
│ └── dto/
│
└── global/
├── common/ApiResponse.java # 공통 응답 래퍼
└── exception/ # 예외 처리

기술 스택

iOS

항목	기술
UI	SwiftUI
아키텍처	MVVM
최소 버전	iOS 17+
네트워크	Moya + async/await
인증	Sign in with Apple + JWT
저장소	Keychain (토큰) + UserDefaults (설정)
위젯	WidgetKit + App Group
패키지 매니저	SPM

Backend

항목	기술
프레임워크	Spring Boot 3.5.0
언어	Java 17
DB	MySQL 8.x
ORM	Spring Data JPA
인증	JWT (Access + Refresh Token)
문서	Swagger (springdoc-openapi)
배포	Railway (Docker)

API Endpoints

Method	Path	설명
POST	/api/auth/signup	회원가입
POST	/api/auth/login	이메일 로그인
POST	/api/auth/apple	Apple 로그인
POST	/api/auth/refresh	토큰 갱신
POST	/api/sessions	세션 생성
PATCH	/api/sessions/{id}/complete	세션 완료
PATCH	/api/sessions/{id}/abort	세션 포기
GET	/api/stats/weekly	주간 통계
GET	/api/stats/calendar	월간 캘린더
GET	/api/stats/profile	프로필 통계
GET	/api/users/me	내 정보 조회
PATCH	/api/users/me	내 정보 수정

컵 사이즈

사이즈	시간 범위	최대 물양	설명
Tall	30분 ~ 1시간 30분	355ml	가벼운 공부
Grande	1시간 30분 ~ 3시간	473ml	집중 공부
Venti	2시간 ~ 4시간	591ml	깊은 공부

앱 다운로드

개발 정보

• 1인 개발 프로젝트
• iOS: SwiftUI + Moya (SPM)
• Backend: Spring Boot + MySQL (Railway 배포)

라이선스

이 프로젝트는 개인 프로젝트로, 무단 복제 및 배포를 금합니다.