# nbcamp-prplz/naeilburgercamp architecture

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

- Interactive diagram: https://gitdiagram.com/nbcamp-prplz/naeilburgercamp
- Repository: https://github.com/nbcamp-prplz/naeilburgercamp

## Overview

##### Project Type and Purpose
- **Type**: Native iOS application (mobile client)
- **Purpose**: Clone-coding a hamburger-shop ordering app with category-based menu browsing, real-time cart and order processing, multi-language support, and dark-mode compatibility.
- **Architectural Style**: Clean Architecture with MVVM-influenced Presentation layer and reactive data-flow via RxSwift.

##### File Structure Analysis
- Top-level layers (under `NaeilBurgerCamp/`):
- **Application**: App & Scene lifecycle hooks (AppDelegate, SceneDelegate)
- **Data**: DTOs, FirestoreService, Repositories (MenuRepository, OrderRepository)
- **Domain**: Business Entities (Cart, MenuItem, Order, Category) and UseCases (MenuUseCase, OrderUseCase)
- **Presentation**:
– Launch (LaunchScreen storyboard)
– Main (MVVM: ViewControllers, ViewModels, Cells, Subviews)
- **Resource**: Assets, Fonts, Localizable strings, Info.plist
- **Utility**: Extensions and ImageLoader (caching actor + NSCache)
- Key config/build files: `NaeilBurgerCamp.xcodeproj`, `.gitignore`, GitHub issue/PR templates.

##### Insights from README
- **Tech Stack**: Swift, UIKit, SnapKit, UICollectionView Compositional Layout, DiffableDataSource, RxSwift, Firestore
- **UX Goals**: Intuitive flows, responsiveness, real-time updates

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Client Layers and External
    subgraph "UI Layer" 
        direction TB
        UIC1["MainViewController"]:::ui
        UIC2["Section (enum)"]:::ui
        UIC3["CategoryCell"]:::ui
        UIC4["MenuItemCell"]:::ui
        UIC5["CartItemCell"]:::ui
        UIC6["CartSectionHeader"]:::ui
        UIC7["MenuItemSectionFooter"]:::ui
        UIC8["PlaceOrderView"]:::ui
    end

    subgraph "Presentation Layer" 
        direction TB
        PM["MainViewModel"]:::presentation
    end

    subgraph "Domain Layer" 
        direction TB
        DEnt1["Cart"]:::domain
        DEnt2["Category"]:::domain
        DEnt3["MenuItem"]:::domain
        DEnt4["Order"]:::domain
        DUC1["MenuUseCase"]:::domain
        DUC2["OrderUseCase"]:::domain
    end

    subgraph "Data Layer"
        direction TB
        DTO1["FSCategory"]:::data
        DTO2["FSMenuItem"]:::data
        DTO3["FSOrder"]:::data
        DTO4["FSTypes"]:::data
        Repo1["MenuRepository"]:::data
        Repo2["OrderRepository"]:::data
        FS["FirestoreService"]:::service
        FE["FSError"]:::data
    end

    subgraph "Utility Modules"
        direction TB
        IM1["ExpiryDateStore"]:::util
        IM2["OngoingTaskStore"]:::util
        IM3["ImageLoader"]:::util
        EXT["Extensions"]:::util
    end

    subgraph "Resource Layer"
        direction TB
        R1["Assets.xcassets"]:::resource
        R2["Font"]:::resource
        R3["Localizable.strings (en/ja/ko)"]:::resource
        R4["Info.plist"]:::resource
        LS["LaunchScreen"]:::resource
    end

    FSDB["Firebase Firestore"]:::external

    %% Application Layer separate
    subgraph "Application Layer"
        direction TB
        APP1["AppDelegate"]:::app
        APP2["SceneDelegate"]:::app
    end

    %% Data Flow
    UIC1 -->|user events| PM
    UIC3 -->|display data| UIC1
    PM -->|calls| DUC1
    PM -->|calls| DUC2
    DUC1 -->|uses| Repo1
    DUC2 -->|uses| Repo2
    Repo1 -->|maps DTOs| FS
    Repo2 -->|maps DTOs| FS
    FS -->|network| FSDB
    FSDB -->|real-time updates| FS
    FS -->|callbacks| Repo1
    FS -->|callbacks| Repo2
    Repo1 -->|entities| DEnt1
    Repo1 -->|entities| DEnt2
    Repo1 -->|entities| DEnt3
    Repo2 -->|entities| DEnt4
    DEnt1 -->|domain model| PM
    DEnt2 -->|domain model| PM
    DEnt3 -->|domain model| PM
    DEnt4 -->|domain model| PM

    %% Utility and Resource usage
    UIC1 -->|layout| R1
    UIC1 -->|strings| R3
    UIC1 -->|theming| R4
    UIC1 -->|load image| IM3
    IM3 --> EXT

    APP1 --> PM
    APP2 --> PM

    %% Launch screen
    APP2 --> LS

    %% Click Events
    click UIC1 "https://github.com/nbcamp-prplz/naeilburgercamp/blob/dev/NaeilBurgerCamp/NaeilBurgerCamp/Presentation/Main/MainViewController.swift"
    click PM "https://github.com/nbcamp-prplz/naeilburgercamp/blob/dev/NaeilBurgerCamp/NaeilBurgerCamp/Presentation/Main/MainViewModel.swift"
    click UIC2 "https://github.com/nbcamp-prplz/naeilburgercamp/blob/dev/NaeilBurgerCamp/NaeilBurgerCamp/Presentation/Main/Section.swift"
    click UIC3 "https://github.com/nbcamp-prplz/naeilburgercamp/blob/dev/NaeilBurgerCamp/NaeilBurgerCamp/Presentation/Main/Subview/Cell/CategoryCell.swift"
    click UIC4 "https://github.com/nbcamp-prplz/naeilburgercamp/blob/dev/NaeilBurgerCamp/NaeilBurgerCamp/Presentation/Main/Subview/Cell/MenuItemCell.swift"
    click UIC5 "https://github.com/nbcamp-prplz/naeilburgercamp/blob/dev/NaeilBurgerCamp/NaeilBurgerCamp/Presentation/Main/Subview/Cell/CartItemCell.swift"
    click UIC6 "https://github.com/nbcamp-prplz/naeilburgercamp/blob/dev/NaeilBurgerCamp/NaeilBurgerCamp/Presentation/Main/Subview/Supplementary/CartSectionHeader.swift"
    click UIC7 "https://github.com/nbcamp-prplz/naeilburgercamp/blob/dev/NaeilBurgerCamp/NaeilBurgerCamp/Presentation/Main/Subview/Supplementary/MenuItemSectionFooter.swift"
    click UIC8 "https://github.com/nbcamp-prplz/naeilburgercamp/blob/dev/NaeilBurgerCamp/NaeilBurgerCamp/Presentation/Main/Subview/PlaceOrderView.swift"
    click LS "https://github.com/nbcamp-prplz/naeilburgercamp/blob/dev/NaeilBurgerCamp/NaeilBurgerCamp/Presentation/Launch/Base.lproj/LaunchScreen.storyboard"
    click DEnt1 "https://github.com/nbcamp-prplz/naeilburgercamp/blob/dev/NaeilBurgerCamp/NaeilBurgerCamp/Domain/Entity/Cart.swift"
    click DEnt2 "https://github.com/nbcamp-prplz/naeilburgercamp/blob/dev/NaeilBurgerCamp/NaeilBurgerCamp/Domain/Entity/Category.swift"
    click DEnt3 "https://github.com/nbcamp-prplz/naeilburgercamp/blob/dev/NaeilBurgerCamp/NaeilBurgerCamp/Domain/Entity/MenuItem.swift"
    click DEnt4 "https://github.com/nbcamp-prplz/naeilburgercamp/blob/dev/NaeilBurgerCamp/NaeilBurgerCamp/Domain/Entity/Order.swift"
    click DUC1 "https://github.com/nbcamp-prplz/naeilburgercamp/blob/dev/NaeilBurgerCamp/NaeilBurgerCamp/Domain/UseCase/MenuUseCase.swift"
    click DUC2 "https://github.com/nbcamp-prplz/naeilburgercamp/blob/dev/NaeilBurgerCamp/NaeilBurgerCamp/Domain/UseCase/OrderUseCase.swift"
    click DTO1 "https://github.com/nbcamp-prplz/naeilburgercamp/blob/dev/NaeilBurgerCamp/NaeilBurgerCamp/Data/DTO/FSCategory.swift"
    click DTO2 "https://github.com/nbcamp-prplz/naeilburgercamp/blob/dev/NaeilBurgerCamp/NaeilBurgerCamp/Data/DTO/FSMenuItem.swift"
    click DTO3 "https://github.com/nbcamp-prplz/naeilburgercamp/blob/dev/NaeilBurgerCamp/NaeilBurgerCamp/Data/DTO/FSOrder.swift"
    click DTO4 "https://github.com/nbcamp-prplz/naeilburgercamp/blob/dev/NaeilBurgerCamp/NaeilBurgerCamp/Data/DTO/FSTypes.swift"
    click Repo1 "https://github.com/nbcamp-prplz/naeilburgercamp/blob/dev/NaeilBurgerCamp/NaeilBurgerCamp/Data/Repository/MenuRepository.swift"
    click Repo2 "https://github.com/nbcamp-prplz/naeilburgercamp/blob/dev/NaeilBurgerCamp/NaeilBurgerCamp/Data/Repository/OrderRepository.swift"
    click FS "https://github.com/nbcamp-prplz/naeilburgercamp/blob/dev/NaeilBurgerCamp/NaeilBurgerCamp/Data/FirestoreService.swift"
    click FE "https://github.com/nbcamp-prplz/naeilburgercamp/blob/dev/NaeilBurgerCamp/NaeilBurgerCamp/Data/FSError.swift"
    click IM1 "https://github.com/nbcamp-prplz/naeilburgercamp/blob/dev/NaeilBurgerCamp/NaeilBurgerCamp/Utility/ImageLoader/ExpiryDateStore.swift"
    click IM2 "https://github.com/nbcamp-prplz/naeilburgercamp/blob/dev/NaeilBurgerCamp/NaeilBurgerCamp/Utility/ImageLoader/OngoingTaskStore.swift"
    click IM3 "https://github.com/nbcamp-prplz/naeilburgercamp/blob/dev/NaeilBurgerCamp/NaeilBurgerCamp/Utility/ImageLoader/ImageLoader.swift"
    click EXT "https://github.com/nbcamp-prplz/naeilburgercamp/tree/dev/NaeilBurgerCamp/NaeilBurgerCamp/Utility/Extensions"
    click R1 "https://github.com/nbcamp-prplz/naeilburgercamp/blob/dev/NaeilBurgerCamp/NaeilBurgerCamp/Resource/Assets.xcassets"
    click R2 "https://github.com/nbcamp-prplz/naeilburgercamp/tree/dev/NaeilBurgerCamp/NaeilBurgerCamp/Resource/Font"
    click R3 "https://github.com/nbcamp-prplz/naeilburgercamp/blob/dev/NaeilBurgerCamp/NaeilBurgerCamp/Resource/Localizable/en.lproj/Localizable.strings"
    click R4 "https://github.com/nbcamp-prplz/naeilburgercamp/blob/dev/NaeilBurgerCamp/NaeilBurgerCamp/Resource/Info.plist"

    %% Styles
    classDef ui fill:#D6EAF8,stroke:#3498DB
    classDef presentation fill:#D5F5E3,stroke:#27AE60
    classDef domain fill:#FCF3CF,stroke:#F1C40F
    classDef data fill:#FADBD8,stroke:#E74C3C
    classDef service fill:#FADBD8,stroke:#C0392B,stroke-dasharray: 5 5
    classDef util fill:#F2F3F4,stroke:#95A5A6
    classDef resource fill:#FCF3CF,stroke:#F39C12
    classDef app fill:#EBDEF0,stroke:#8E44AD
    classDef external fill:#F5B7B1,stroke:#C0392B,stroke-width:2px

    %% RxSwift reactive stream arrows
    PM -.->|RxSwift streams| DUC1
    PM -.->|RxSwift streams| DUC2
    DUC1 -.->|observable| PM
    DUC2 -.->|observable| PM
```
