README.md

Spowift 🎵

Spowift는 Spotify에서 제공하는 Web API 를 활용하여 오늘의 가장 핫한 곡, 아티스트 정보등 음악 관련 정보를 확인해 볼 수 있는 SwiftUI 앱입니다.
이 앱은 아키텍처와 패턴 그리고 다양한 기술들을 적용해보고 Best Practice를 찾기 위한 개인 프로젝트입니다.
Report bug · Request feature

• Screenshots
• Quick start
• Project Structure
  • Folder Structure
• Tools & Frameworks Used
• Development Environment
• License

Screenshots

Quick start

추후 내용 추가

Project Structure

Spowift는 Clean Architecture를 사용하며, 주로 네 가지 주요 계층으로 구분됩니다:

• Core: 확장 기능과 의존성 주입 코드와 같이 여러 계층 간에 공통적으로 사용되는 코드를 포함합니다.
• Data: 애플리케이션이 필요로 하는 데이터를 어디서 가져와야 할지, 그리고 데이터를 어떻게 처리해야 할지를 결정하는 '중개자' 역할을 합니다.
  이를 통해 나머지 레이어에서는 데이터가 어디서 오는지 신경 쓰지 않고도 데이터를 사용할 수 있게 됩니다. 현재는 REST API로 외부 데이터에만 접근하지만 추후 Core Data를 추가할 계획입니다.
• Domain: 애플리케이션의 비즈니스 로직을 처리하는 데 책임이 있는 UseCase(UC)를 포함합니다. UseCase는 사용자의 행동(ex. getArtistUC)에 기반하여 생성됩니다. Data Mapping을 통해 Presentation 레이어에서 사용될 Entity 데이터 모델도 포함합니다.
• Presentation: 화면을 그리는 레이어로 뷰와 유스 케이스 사이 상호작용을 처리하는 뷰모델도 포함됩니다.

Folder Structure

Tools & Frameworks Used

Tool	Used for
MVVM	뷰에서 로직을 분리하기 위한 아키텍처 디자인 패턴
Clean Architecture	계층을 나누고 관심사를 분리하여 높은 응집도 낮은 결합도로 안정성과 생산성을 높여줄 수 있는 아키텍쳐
Factory	Dependency Injection
Arkana	clientKey, SecretKey 로컬에 안전하게 저장
SpotifyAPI	Spotify 컨텐츠 요청
Keychain Access	Swift Keychain api를 쉽게 사용 할 수 있게 하는 래퍼 라이브러리

Development Environment

• Xcode 15.1
• Swift 5.9.2
• iOS Deployment Target 16.0

License

This project is licensed under the MIT License - see the LICENSE file for details