# berrrchik/cocktailfinder-swiftapp architecture

> Architecture diagram of the GitHub repository berrrchik/cocktailfinder-swiftapp, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-04-28). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/berrrchik/cocktailfinder-swiftapp
- Repository: https://github.com/berrrchik/cocktailfinder-swiftapp

## Overview

##### Project Type and Purpose
- Mobile client application (iOS app) using SwiftUI and MVVM
- Purpose: allow users to search, view, favorite and filter cocktail recipes by consuming TheCocktailDB REST API, with offline caching and persistence of favorites

##### High-Level Architecture Components
- Presentation Layer
– Views (SwiftUI): SearchView, RecipeView, FavoriteCoctailsView, FilterView, RandomCocktailView, CocktailCardView, StateView components
- Presentation Logic
– ViewModels (Combine): SearchViewModel, FilterViewModel, RecipeViewModel, RandomCocktailViewModel, CocktailCardViewModel, FavoritesViewModel
- Domain Model
– Model structs: Cocktail, FilterCategory, FilterOption
- Services Layer
– APIService: handles HTTP requests to TheCocktailDB API via URLSession and JSON decoding
– CocktailCacheService: in-memory or on-disk caching of popular/random cocktails
– FavoritesService: persistence of favorite cocktails in UserDefaults
- External Dependencies
– TheCocktailDB API (external REST service)
– SDWebImageSwiftUI (asynchronous image loading)
- Local Storage
– UserDefaults (favorites), optional on-disk cache for images/data

##### Relationships and Data Flow
1. User taps UI in a View → ViewModel receives action
2. ViewModel invokes Services (APIService or FavoritesService/CocktailCacheService)
3. Service makes network call or reads/writes UserDefaults
4. Service returns data (Combine publisher or callback) → ViewModel processes and publishes state
5. View observes ViewModel’s published properties → updates UI
6. Image loading flows from URL through SDWebImageSwiftUI to Image view

##### Architectural Patterns and Design Principles
- MVVM: clear separation of UI (View), presentation logic (ViewModel), and data (Model + Services)
- Single responsibility: each Service handles one concern (network, caching, favorites)
- Dependency injection (pass APIService into ViewModels)
- Reactive data flow via Combine

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Presentation Layer
    subgraph "Presentation Layer"
        direction TB
        SV["SearchView"]:::ui
        RV["RecipeView"]:::ui
        FV["FavoriteCoctailsView"]:::ui
        FIV["FilterView"]:::ui
        RCV["RandomCocktailView"]:::ui
        CCV["CocktailCardView"]:::ui
        STV["StateView"]:::ui
    end

    %% Presentation Logic
    subgraph "Presentation Logic"
        direction TB
        SVM["SearchViewModel"]:::viewmodel
        RVM["RecipeViewModel"]:::viewmodel
        FVM["FilterViewModel"]:::viewmodel
        RCVM["RandomCocktailViewModel"]:::viewmodel
        CCVM["CocktailCardViewModel"]:::viewmodel
        FavVM["FavoritesViewModel"]:::viewmodel
    end

    %% Services Layer
    subgraph "Services Layer"
        direction TB
        API["APIService"]:::service
        Cache["CocktailCacheService"]:::service
        FavSvc["FavoritesService"]:::service
    end

    %% Domain Model
    subgraph "Domain Model"
        direction TB
        M1["Cocktail"]:::model
        M2["FilterCategory"]:::model
        M3["FilterOption"]:::model
    end

    %% External Dependencies & Storage
    subgraph "External & Storage"
        direction TB
        APIEXT["TheCocktailDB API"]:::external
        UD["UserDefaults"]:::storage
        SD["SDWebImageSwiftUI"]:::external
    end

    %% Connections: View to ViewModel
    SV -->|"userAction()"| SVM
    RV -->|"loadRecipe()"| RVM
    FV -->|"viewFavorites()"| FavVM
    FIV -->|"applyFilter()"| FVM
    RCV -->|"fetchRandom()"| RCVM
    CCV -->|"displayCard()"| CCVM
    CCV -->|"loadState()"| STV

    %% ViewModel to Services
    SVM -->|"fetchCocktails()"| API
    FVM -->|"fetchFilters()"| API
    RVM -->|"fetchCocktailDetails()"| API
    RCVM -->|"fetchRandomCocktail()"| API
    CCVM -->|"cacheLookup()"| Cache
    FavVM -->|"saveFavorite()"| FavSvc
    FavVM -->|"loadFavorites()"| FavSvc

    %% Services to External/Storage
    API -->|"HTTP Request"| APIEXT
    Cache -->|"cacheData"| UD
    FavSvc -->|"read/write"| UD

    %% Image loading path
    CCV -->|"loadImage()"| SD
    SD -->|"networkFetch"| APIEXT

    %% Services to Domain Model
    API -->|"decode JSON"| M1
    API -->|"decode JSON"| M2
    API -->|"decode JSON"| M3

    %% Domain Model to ViewModels (data flow)
    M1 -->|"Cocktail data"| SVM
    M1 -->|"Cocktail data"| RVM
    M1 -->|"Cocktail data"| RCVM
    M2 -->|"Filter data"| FVM
    M3 -->|"Filter data"| FVM

    %% Click Events
    click SV "https://github.com/berrrchik/cocktailfinder-swiftapp/blob/main/CocktailFinder-SwiftApp/View/SearchView.swift"
    click RV "https://github.com/berrrchik/cocktailfinder-swiftapp/blob/main/CocktailFinder-SwiftApp/View/RecipeView.swift"
    click FV "https://github.com/berrrchik/cocktailfinder-swiftapp/blob/main/CocktailFinder-SwiftApp/View/FavoriteCoctailsView.swift"
    click FIV "https://github.com/berrrchik/cocktailfinder-swiftapp/blob/main/CocktailFinder-SwiftApp/View/FilterView.swift"
    click RCV "https://github.com/berrrchik/cocktailfinder-swiftapp/blob/main/CocktailFinder-SwiftApp/View/RandomCocktailView.swift"
    click CCV "https://github.com/berrrchik/cocktailfinder-swiftapp/blob/main/CocktailFinder-SwiftApp/View/CocktailCardView.swift"
    click STV "https://github.com/berrrchik/cocktailfinder-swiftapp/blob/main/CocktailFinder-SwiftApp/View/Components/StateView.swift"
    click SVM "https://github.com/berrrchik/cocktailfinder-swiftapp/blob/main/CocktailFinder-SwiftApp/ViewModel/SearchViewModel.swift"
    click RVM "https://github.com/berrrchik/cocktailfinder-swiftapp/blob/main/CocktailFinder-SwiftApp/ViewModel/RecipeViewModel.swift"
    click FVM "https://github.com/berrrchik/cocktailfinder-swiftapp/blob/main/CocktailFinder-SwiftApp/ViewModel/FilterViewModel.swift"
    click RCVM "https://github.com/berrrchik/cocktailfinder-swiftapp/blob/main/CocktailFinder-SwiftApp/ViewModel/RandomCocktailViewModel.swift"
    click CCVM "https://github.com/berrrchik/cocktailfinder-swiftapp/blob/main/CocktailFinder-SwiftApp/ViewModel/CocktailCardViewModel.swift"
    click FavVM "https://github.com/berrrchik/cocktailfinder-swiftapp/blob/main/CocktailFinder-SwiftApp/ViewModel/FavoritesViewModel.swift"
    click M1 "https://github.com/berrrchik/cocktailfinder-swiftapp/blob/main/CocktailFinder-SwiftApp/Model/Cocktail.swift"
    click M2 "https://github.com/berrrchik/cocktailfinder-swiftapp/blob/main/CocktailFinder-SwiftApp/Model/FilterCategory.swift"
    click M3 "https://github.com/berrrchik/cocktailfinder-swiftapp/blob/main/CocktailFinder-SwiftApp/Model/FilterOption.swift"
    click API "https://github.com/berrrchik/cocktailfinder-swiftapp/blob/main/CocktailFinder-SwiftApp/Services/APIService.swift"
    click Cache "https://github.com/berrrchik/cocktailfinder-swiftapp/blob/main/CocktailFinder-SwiftApp/Services/CocktailCacheService.swift"
    click FavSvc "https://github.com/berrrchik/cocktailfinder-swiftapp/blob/main/CocktailFinder-SwiftApp/Services/FavoritesService.swift"

    %% Styles
    classDef ui fill:#D6EAF8,stroke:#1B4F72,stroke-width:2px
    classDef viewmodel fill:#FCF3CF,stroke:#7D6608,stroke-width:2px
    classDef service fill:#D5F5E3,stroke:#1E8449,stroke-width:2px,stroke-dasharray: 5 5
    classDef model fill:#FADBD8,stroke:#78281F,stroke-width:2px
    classDef storage fill:#EBDEF0,stroke:#512E5F,stroke-width:2px,stroke-dasharray: 2 2
    classDef external fill:#F2F3F4,stroke:#566573,stroke-width:2px,stroke-dasharray: 4 2
```
