# matrecode/tradesegment architecture

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

- Interactive diagram: https://gitdiagram.com/matrecode/tradesegment
- Repository: https://github.com/matrecode/tradesegment

## Overview

##### Project type and purpose
- This is a native iOS mobile trading application built in Swift using SwiftUI.
- Purpose: Provide users with registration/login (via Firebase Auth) and an “Engage” section for trading activities (bids, orders, portfolio, watchlist, profile, home tab).

##### File structure
- Top-level:
- TradeSegmentApp.swift (entry point)
- AppCoordinator.swift (root navigation)
- Apply/ (onboarding flows: Login, Register, Home)
- Engage/ (main app flows: HomeTab, Bids, Orders, Portfolio, Profile, Watchlist)
- SharedComponents/ (reusable UI elements & utilities)
- Tests (unit/UI)
- Patterns:
- MVVM: every view (e.g., LoginView.swift) has a corresponding ViewModel.swift.
- Coordinator: each feature folder has a Coordinator.swift and Route/Protocol definitions.
- Modular feature separation: “Apply” vs. “Engage” flows.

##### README for additional insights
- Confirms MVVM + Coordinator pattern.
- SwiftUI for UI; Firebase Authentication for user auth.
- Key features: Login & Register via Firebase.

##### Detailed breakdown of components
- TradeSegmentApp.swift (entry)
- AppCoordinator
- Apply Flow:
- LoginCoordinator → LoginView ← LoginViewModel → AuthService (Firebase)
- RegisterCoordinator → RegisterView …
- HomeCoordinator → HomeView ← HomeViewModel
- Engage Flow: repeat for each sub-module
- SharedComponents (PrimaryButton, FloatingTextField, ListItem, etc.) used by all Views
- Firebase Authentication as the only backend dependency

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Entry and Root
    TradeSegmentApp["TradeSegmentApp"]:::app
    AppCoordinator["AppCoordinator"]:::coord

    TradeSegmentApp -->|launches| AppCoordinator

    %% Apply Module
    subgraph "Apply Module"
        direction TB
        subgraph "Login Flow"
            direction TB
            LoginCoordinator["LoginCoordinator"]:::coord
            LoginView["LoginView"]:::view
            LoginViewModel["LoginViewModel"]:::vm
            LoginCoordinator -->|instantiates| LoginView
            LoginView -->|binds to| LoginViewModel
            LoginViewModel -->|calls auth| AuthService
        end
        subgraph "Register Flow"
            direction TB
            RegisterCoordinator["RegisterCoordinator"]:::coord
            RegisterView["RegisterView"]:::view
            RegisterViewModel["RegisterViewModel"]:::vm
            RegisterCoordinator -->|instantiates| RegisterView
            RegisterView -->|binds to| RegisterViewModel
            RegisterViewModel -->|calls auth| AuthService
        end
        subgraph "Home (Onboarding) Flow"
            direction TB
            HomeCoordinator["HomeCoordinator"]:::coord
            HomeView["HomeView"]:::view
            HomeViewModel["HomeViewModel"]:::vm
            HomeCoordinator -->|instantiates| HomeView
            HomeView -->|binds to| HomeViewModel
        end
        AppCoordinator -->|onboarding| LoginCoordinator
        AppCoordinator -->|onboarding| RegisterCoordinator
        AppCoordinator -->|onboarding| HomeCoordinator
    end

    %% Engage Module
    subgraph "Engage Module"
        direction TB
        subgraph "HomeTab"
            direction TB
            HomeTabCoordinator["HomeTabCoordinator"]:::coord
            HomeTabView["HomeTabView"]:::view
            HomeTabViewModel["HomeTabViewModel"]:::vm
            HomeTabCoordinator -->|instantiates| HomeTabView
            HomeTabView -->|binds to| HomeTabViewModel
        end
        subgraph "Bids"
            direction TB
            BidsCoordinator["BidsCoordinator"]:::coord
            BidsView["BidsView"]:::view
            BidsViewModel["BidsViewModel"]:::vm
            BidsCoordinator -->|instantiates| BidsView
            BidsView -->|binds to| BidsViewModel
        end
        subgraph "Orders"
            direction TB
            OrdersCoordinator["OrdersCoordinator"]:::coord
            OrdersView["OrdersView"]:::view
            OrdersViewModel["OrdersViewModel"]:::vm
            OrdersCoordinator -->|instantiates| OrdersView
            OrdersView -->|binds to| OrdersViewModel
        end
        subgraph "Portfolio"
            direction TB
            PortfolioCoordinator["PortfolioCoordinator"]:::coord
            PortfolioView["PortfolioView"]:::view
            PortfolioViewModel["PortfolioViewModel"]:::vm
            PortfolioCoordinator -->|instantiates| PortfolioView
            PortfolioView -->|binds to| PortfolioViewModel
        end
        subgraph "Profile"
            direction TB
            ProfileCoordinator["ProfileCoordinator"]:::coord
            ProfileView["ProfileView"]:::view
            ProfileViewModel["ProfileViewModel"]:::vm
            ProfileCoordinator -->|instantiates| ProfileView
            ProfileView -->|binds to| ProfileViewModel
        end
        subgraph "Watchlist"
            direction TB
            WatchlistCoordinator["WatchlistCoordinator"]:::coord
            WatchlistView["WatchlistView"]:::view
            WatchlistViewModel["WatchlistViewModel"]:::vm
            WatchlistCoordinator -->|instantiates| WatchlistView
            WatchlistView -->|binds to| WatchlistViewModel
        end
        AppCoordinator -->|main flow| HomeTabCoordinator
        AppCoordinator -->|main flow| BidsCoordinator
        AppCoordinator -->|main flow| OrdersCoordinator
        AppCoordinator -->|main flow| PortfolioCoordinator
        AppCoordinator -->|main flow| ProfileCoordinator
        AppCoordinator -->|main flow| WatchlistCoordinator
    end

    %% Shared Components
    subgraph "SharedComponents"
        direction TB
        PrimaryButton["PrimaryButton"]:::view
        FloatingTextField["FloatingTextField"]:::view
        ListItem["ListItem"]:::view
        StockItem["StockItem"]:::view
        DesclaimerView["DesclaimerView"]:::view
        UIApplicationExt["UIApplication+Extension"]:::view
        AuthResult["AuthResult"]:::service
        NavigationModifier["NavigationDestinationModifier"]:::service
        WebView["WebView"]:::service
    end

    %% External Service
    AuthService["Firebase Authentication"]:::service

    %% Styles
    classDef app fill:#f9f,stroke:#333,stroke-width:1px
    classDef coord fill:#f96,stroke:#333,stroke-width:1px
    classDef view fill:#ccf,stroke:#333,stroke-width:1px
    classDef vm fill:#9f9,stroke:#333,stroke-width:1px
    classDef service fill:#ccc,stroke:#333,stroke-width:1px

    %% Click Events
    click TradeSegmentApp "https://github.com/matrecode/tradesegment/blob/develop/TradeSegment/TradeSegmentApp.swift"
    click AppCoordinator "https://github.com/matrecode/tradesegment/blob/develop/TradeSegment/AppCoordinator.swift"
    click LoginCoordinator "https://github.com/matrecode/tradesegment/blob/develop/TradeSegment/Apply/Login/LoginCoordinator.swift"
    click LoginView "https://github.com/matrecode/tradesegment/blob/develop/TradeSegment/Apply/Login/LoginView.swift"
    click LoginViewModel "https://github.com/matrecode/tradesegment/blob/develop/TradeSegment/Apply/Login/LoginViewModel.swift"
    click RegisterCoordinator "https://github.com/matrecode/tradesegment/blob/develop/TradeSegment/Apply/Register/RegisterCoordinator.swift"
    click RegisterView "https://github.com/matrecode/tradesegment/blob/develop/TradeSegment/Apply/Register/RegisterView.swift"
    click RegisterViewModel "https://github.com/matrecode/tradesegment/blob/develop/TradeSegment/Apply/Register/RegisterViewModel.swift"
    click HomeCoordinator "https://github.com/matrecode/tradesegment/blob/develop/TradeSegment/Apply/Home/HomeCoordinator.swift"
    click HomeView "https://github.com/matrecode/tradesegment/blob/develop/TradeSegment/Apply/Home/HomeView.swift"
    click HomeViewModel "https://github.com/matrecode/tradesegment/blob/develop/TradeSegment/Apply/Home/HomeViewModel.swift"
    click HomeTabCoordinator "https://github.com/matrecode/tradesegment/blob/develop/TradeSegment/Engage/HomeTab/HomeTabCoordinator.swift"
    click HomeTabView "https://github.com/matrecode/tradesegment/blob/develop/TradeSegment/Engage/HomeTab/HomeTabView.swift"
    click HomeTabViewModel "https://github.com/matrecode/tradesegment/blob/develop/TradeSegment/Engage/HomeTab/HomeTabViewModel.swift"
    click BidsCoordinator "https://github.com/matrecode/tradesegment/blob/develop/TradeSegment/Engage/Bids/BidsCoordinator.swift"
    click BidsView "https://github.com/matrecode/tradesegment/blob/develop/TradeSegment/Engage/Bids/BidsView.swift"
    click BidsViewModel "https://github.com/matrecode/tradesegment/blob/develop/TradeSegment/Engage/Bids/BidsViewModel.swift"
    click OrdersCoordinator "https://github.com/matrecode/tradesegment/blob/develop/TradeSegment/Engage/Orders/OrdersCoordinator.swift"
    click OrdersView "https://github.com/matrecode/tradesegment/blob/develop/TradeSegment/Engage/Orders/OrdersView.swift"
    click OrdersViewModel "https://github.com/matrecode/tradesegment/blob/develop/TradeSegment/Engage/Orders/OrdersViewModel.swift"
    click PortfolioCoordinator "https://github.com/matrecode/tradesegment/blob/develop/TradeSegment/Engage/Portfolio/PortfolioCoordinator.swift"
    click PortfolioView "https://github.com/matrecode/tradesegment/blob/develop/TradeSegment/Engage/Portfolio/PortfolioView.swift"
    click PortfolioViewModel "https://github.com/matrecode/tradesegment/blob/develop/TradeSegment/Engage/Portfolio/PortfolioViewModel.swift"
    click ProfileCoordinator "https://github.com/matrecode/tradesegment/blob/develop/TradeSegment/Engage/Profile/ProfileCoordinator.swift"
    click ProfileView "https://github.com/matrecode/tradesegment/blob/develop/TradeSegment/Engage/Profile/ProfileView.swift"
    click ProfileViewModel "https://github.com/matrecode/tradesegment/blob/develop/TradeSegment/Engage/Profile/ProfileViewModel.swift"
    click WatchlistCoordinator "https://github.com/matrecode/tradesegment/blob/develop/TradeSegment/Engage/Watchlist/WatchlistCoordinator.swift"
    click WatchlistView "https://github.com/matrecode/tradesegment/blob/develop/TradeSegment/Engage/Watchlist/WatchlistView.swift"
    click WatchlistViewModel "https://github.com/matrecode/tradesegment/blob/develop/TradeSegment/Engage/Watchlist/WatchlistViewModel.swift"
    click PrimaryButton "https://github.com/matrecode/tradesegment/blob/develop/TradeSegment/SharedComponents/Buttons/PrimaryButton.swift"
    click FloatingTextField "https://github.com/matrecode/tradesegment/blob/develop/TradeSegment/SharedComponents/TextField/FloatingTextField.swift"
    click ListItem "https://github.com/matrecode/tradesegment/blob/develop/TradeSegment/SharedComponents/ListItem/ListItem.swift"
    click StockItem "https://github.com/matrecode/tradesegment/blob/develop/TradeSegment/SharedComponents/ListItem/StockItem.swift"
    click DesclaimerView "https://github.com/matrecode/tradesegment/blob/develop/TradeSegment/SharedComponents/Common/DesclaimerView.swift"
    click UIApplicationExt "https://github.com/matrecode/tradesegment/blob/develop/TradeSegment/SharedComponents/Common/UIApplication+Extension.swift"
    click AuthResult "https://github.com/matrecode/tradesegment/blob/develop/TradeSegment/SharedComponents/Utils/AuthResult.swift"
    click NavigationModifier "https://github.com/matrecode/tradesegment/blob/develop/TradeSegment/SharedComponents/Utils/NavigationDestinationModifier.swift"
    click WebView "https://github.com/matrecode/tradesegment/blob/develop/TradeSegment/SharedComponents/Utils/WebView.swift"
```
