☀️ 오늘 어때?

현재 온도에 맞는 옷을 추천해주는 날씨 기반 서비스 앱입니다.
현재 날씨 및 온도, 시간대별/일별 예보를 제공하고, 온도에 적합한 옷을 시각적으로 제안합니다.

🚀 목표

Jetpack Compose 기반 Android 앱으로 Android App Architecture를 적용해 UI, Domain, Data Layer를 명확히 분리하고, 단방향 데이터 흐름(Unidirectional Data Flow)을 유지하는 구조를 설계합니다.

⚒️ 기술 스택

• Kotlin
• Jetpack Compose
• Coil
• Room (로컬 캐시)
• OpenWeather API (날씨 데이터)
• OpenAI API (프롬프트 + DALL·E 이미지 생성)

🏗️ 아키텍처 설계

본 프로젝트는 Clean Architecture 원칙에 따라 구성되어 있으며, 계층 간 책임 분리와 테스트 용이성을 최우선으로 고려하였습니다.

1. 설계 철학

• 단방향 흐름
  View → ViewModel → UseCase → Repository → DataSource
  데이터는 항상 한 방향으로 흐르며, 각 계층은 하위 계층의 내부 구현을 알지 못합니다.

• 관심사 분리 (SoC)
  각 계층은 다음과 같은 역할만을 수행합니다:

  | Layer | 역할 | |---------|---------------------------| | UI | 화면 표현 및 사용자 상호작용 | | Domain | 비즈니스 로직, 정책 결정 | | Data | 실제 데이터 제공 (API, DB 등) |

• 의존성 역전 (DIP)
  Domain 계층은 Data 계층의 구체 구현이 아닌 추상 인터페이스에만 의존합니다.
  의존성은 수동으로 생성자에 명시적으로 주입합니다 (Manual DI).

2. 계층별 구조 및 구성요소

UI Layer

• 책임: 사용자 이벤트 수신 및 ViewModel 상태 구독
• 구성
  • Screen: Jetpack Compose 기반 UI
  • ViewModel: 상태(State) 관리 및 이벤트 처리
  • UiState: 화면 상태 표현 (sealed class)

Domain Layer

• 책임: 앱의 핵심 로직을 담당하며 외부에 독립적
• 구성
  • UseCase: 단일 기능 단위의 비즈니스 로직
  • Repository Interface: 추상화된 데이터 접근 인터페이스
  • Entity: 순수 데이터 모델

Data Layer

• 책임: 외부 데이터 소스로부터 실제 데이터 수집 및 가공
• 구성
  • RepositoryImpl: Domain의 Repository를 구현
  • RemoteDataSource: OpenWeather, OpenAI 등 외부 API 호출
  • LocalDataSource: Room 기반 로컬 저장소
  • DTO: 외부 응답 Entity

3. 의존성 흐름

UI → Domain → Data
UI는 Domain만 알며, Domain은 Data 계층에 추상적으로만 의존합니다.
수동 DI 방식을 사용하여 앱 초기 구동 시 모든 의존성을 명시적으로 연결합니다.

🕶️ 주요 기능

1. 현재 날씨 정보 조회
   OpenWeather API를 통해 현재 위치 기반의 날씨와 예보 정보를 가져옵니다.
2. 온도 기반 의상 이미지 추천
   현재 온도에 맞는 옷차림을 자연어로 구성한 후, OpenAI DALL·E를 통해 이미지를 생성하여 사용자에게 시각적으로 제안합니다.
3. 시간대별/일별 날씨 예보
   시간별 기온 변화와 요일별 날씨 요약을 UI에 시각적으로 표시합니다.