# muhammadahmad522/agrivision architecture

> Architecture diagram of the GitHub repository muhammadahmad522/agrivision, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-03-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/muhammadahmad522/agrivision
- Repository: https://github.com/muhammadahmad522/agrivision

## Overview

##### Project type & purpose (from README + tree)
**AgriVision** is a **native iOS application (Swift)** for **precision agriculture**. The codebase strongly suggests:
- **Presentation layer using MVVM** (`ViewModels/` + `Views/`)
- **Coordinator-based navigation** (`Core/Navigation/*Coordinator.swift`)
- A **data abstraction layer** (`Data/Protocols/AgriDataService.swift`) with a current **mock repository implementation** (`Data/Repositories/MockAgriDataRepository.swift`)
- Features currently centered on **Splash**, **Onboarding**, and **Dashboard** (likely showing sensor readings)

##### App entry / lifecycle
- `AppDelegate.swift`
- `SceneDelegate.swift`
- `Info.plist`

##### Core (shared infrastructure)
`Core/Config/`

`Core/Navigation/`
- `Coordinator.swift` (base abstraction)
- `AppCoordinator.swift` (top-level coordinator; sets root flow)
- `OnboardingCoordinator.swift` (manages onboarding navigation)

These are **cross-feature** building blocks.

##### Data layer (service abstractions + repositories)
`Data/Models/`
- `SensorReading.swift` → core data entity shown in the dashboard

`Data/Protocols/`
- `AgriDataService.swift` → **important seam**: everything above depends on this protocol, not on concrete repositories

`Data/Repositories/`
- `MockAgriDataRepository.swift` → current implementation (in-memory / fake data)

##### Feature modules (vertical slices)
`Features/Splash/Views/SplashView.swift`

`Features/Onboarding/`
- `Models/OnboardingPage.swift`
- `ViewModels/OnboardingViewModel.swift`
- `Views/OnboardingView.swift`
- `Views/backgroundWave.swift` (UI component)

`Features/Dashboard/`
- `ViewModels/DashboardViewModel.swift`
- `Views/DashboardView.swift`

These are your primary “feature” containers.

##### Static resources
- `Assets.xcassets/*` and `assets/images/*`
These are not “runtime services” but should appear as a supporting dependency for UI.

##### iOS System
→ `AppDelegate/SceneDelegate`
→ `AppCoordinator`
##### `AppCoordinator`
→ decides initial route: **Splash** → **Onboarding** → **Dashboard** (typical flow given modules)

##### MVVM data flow inside each feature
For **Dashboard** (same pattern for onboarding if needed):
- `DashboardView` → binds to / observes → `DashboardViewModel`
- `DashboardViewModel` → calls → `AgriDataService` (protocol)
- `AgriDataService` → implemented by → `MockAgriDataRepository`
- `MockAgriDataRepository` → returns → `[SensorReading]`
- `DashboardViewModel` → exposes state → `DashboardView` updates

Represent:

##### Models as shared contracts
- `SensorReading` is shared between Data and Feature layers.
- `OnboardingPage` is feature-local (Onboarding-only).

##### External systems (explicitly show “current vs intended”)
There is no concrete network/client in the tree, but the presence of `AgriDataService` implies a future swap from mock to real.
- `MockAgriDataRepository` (current)
This is valuable because it clarifies the intended extensibility of the architecture.

##### Coordinator pattern
- Centralized navigation in `Core/Navigation`
- Feature views are navigated-to rather than self-navigating

##### MVVM
- `Views/` are UI and binding
- `ViewModels/` are state + business/UI logic

##### Dependency inversion via protocol
- `AgriDataService` protocol decouples view models from repositories

**Goal:** What is AgriVision and who/what interacts with it?
- “Farmer / User”
- “AgriVision iOS App”
- “(Optional) Sensor/IoT Platform / Backend (future or assumed)”
- User interacts with app
- App reads sensor data (currently mocked; future backend)

**Goal:** runtime deployable units.
- iOS Device
- AgriVision App Process
- iOS Frameworks (UIKit/SwiftUI as applicable)
- External (future): Backend/IoT Gateway

**Goal:** reflect the code modules.
- **App Lifecycle**
- AppDelegate
- SceneDelegate
- **Navigation (Core/Navigation)**
- AppCoordinator
- OnboardingCoordinator
- Coordinator (base)
- **Features**
- SplashView
- OnboardingView / OnboardingViewModel / OnboardingPage / backgroundWave
- DashboardView / DashboardViewModel
- **Data Layer**
- AgriDataService (protocol)
- MockAgriDataRepository (implementation)
- SensorReading (model)
- **Resources**
- Assets.xcassets / images

- SceneDelegate → AppCoordinator
- AppCoordinator → (SplashView, OnboardingCoordinator, DashboardView)
- OnboardingCoordinator → OnboardingView
- DashboardView ↔ DashboardViewModel (binding/state)
- DashboardViewModel → AgriDataService
- MockAgriDataRepository ──implements──▶ AgriDataService
- MockAgriDataRepository → SensorReading

**Goal:** capture the most important runtime behavior.
Sequence:
DashboardView → DashboardViewModel → AgriDataService → MockAgriDataRepository → returns [SensorReading] → ViewModel updates state → View refreshes.

##### Labeling
- Use **exact class/file names** from the repo for credibility:
- `AppCoordinator`, `OnboardingCoordinator`, `DashboardViewModel`, etc.
- A subtitle for responsibility:
- “AppCoordinator — selects initial flow”
- “AgriDataService — data access abstraction”
- “MockAgriDataRepository — stubbed sensor readings”

- “MVVM per feature”
- “Coordinator pattern for navigation”
- “Repository behind AgriDataService protocol; mock implementation currently used”

#### 7) Practical “don’t overthink it” decomposition for this repo (max components, still accurate)

**Lifecycle**
- AppDelegate
- SceneDelegate

**Navigation**
- Coordinator (protocol/base)
- AppCoordinator
- OnboardingCoordinator

**Splash**
- SplashView

**Onboarding**
- OnboardingView
- OnboardingViewModel
- OnboardingPage
- backgroundWave (UI component)

**Dashboard**
- DashboardView
- DashboardViewModel

**Data**
- AgriDataService (protocol)
- MockAgriDataRepository
- SensorReading

**Shared UI Config**
- UIConstants

**Resources**
- Assets.xcassets
- assets/images

## Diagram (Mermaid)

```mermaid
flowchart TD
  %% =======================
  %% System Context
  %% =======================
  subgraph "System Context"
    User["Farmer / User"]:::external
    iOS["iOS System (Device + OS)"]:::external
    FutureBackend["Future: Sensor/IoT Platform / Backend\n(HTTP / MQTT / BLE / IoT Gateway)"]:::future
  end

  %% =======================
  %% AgriVision iOS App
  %% =======================
  subgraph "AgriVision iOS App (Swift) — MVVM + Coordinator"
    direction TB

    %% ---- App Startup & Lifecycle ----
    subgraph "App Startup & Lifecycle"
      direction TB
      AppDelegate["AppDelegate\n(process start)"]:::lifecycle
      SceneDelegate["SceneDelegate\n(window/scene setup)"]:::lifecycle
      InfoPlist["Info.plist\n(app configuration)"]:::config
    end

    %% ---- Core: Shared UI Config ----
    subgraph "Core / Shared UI Configuration"
      direction TB
      Colors["Colors\n(shared palette)"]:::config
      UIConstants["UIConstants\n(layout constants)"]:::config
    end

    %% ---- Core: Navigation ----
    subgraph "Core / Navigation (Coordinator pattern)"
      direction TB
      CoordinatorBase["Coordinator\n(base abstraction)"]:::nav
      AppCoordinator["AppCoordinator\n(selects initial flow)"]:::nav
      OnboardingCoordinator["OnboardingCoordinator\n(onboarding navigation)"]:::nav
    end

    %% ---- Features ----
    subgraph "Features (Vertical Slices)"
      direction TB

      subgraph "Splash"
        direction TB
        SplashView["SplashView\n(launch/splash UI)"]:::view
      end

      subgraph "Onboarding (MVVM)"
        direction TB
        OnboardingView["OnboardingView\n(UI + binding)"]:::view
        OnboardingViewModel["OnboardingViewModel\n(state + UI logic)"]:::viewmodel
        OnboardingPage["OnboardingPage\n(feature model)"]:::model
        BackgroundWave["backgroundWave\n(UI component)"]:::view
      end

      subgraph "Dashboard (MVVM)"
        direction TB
        DashboardView["DashboardView\n(UI + binding)"]:::view
        DashboardViewModel["DashboardViewModel\n(state + data loading)"]:::viewmodel
      end
    end

    %% ---- Data Layer ----
    subgraph "Data Layer (Dependency inversion via protocol)"
      direction TB
      AgriDataService["AgriDataService\n(protocol abstraction)"]:::protocol
      MockAgriDataRepository["MockAgriDataRepository\n(current: fake/in-memory readings)"]:::repo
      FutureRealRepo["Future: RealAgriDataRepository\n(network/IoT implementation)"]:::future
      SensorReading["SensorReading\n(shared data model)"]:::model
    end

    %% ---- Static Resources ----
    subgraph "Static Resources"
      direction TB
      AssetsCatalog["Assets.xcassets\n(asset catalog)"]:::resource
      ImagesFolder["assets/images\nimage files"]:::resource
    end

    %% ---- Notes / Callouts ----
    subgraph "Architecture Notes"
      direction TB
      NoteMVVM["MVVM per feature:\nView ↔ ViewModel → Data Service"]:::note
      NoteCoord["Coordinator pattern:\nCentralized navigation orchestration"]:::note
      NoteDI["DI seam:\nViewModels depend on AgriDataService protocol"]:::note
    end
  end

  %% =======================
  %% Relationships
  %% =======================
  User -->|"interacts_with"| DashboardView
  User -->|"interacts_with"| OnboardingView

  iOS -->|"launches"| AppDelegate
  iOS -->|"creates_scene"| SceneDelegate

  AppDelegate -->|"configures"| InfoPlist
  SceneDelegate -->|"reads_config"| InfoPlist

  SceneDelegate -->|"starts_root_flow"| AppCoordinator

  CoordinatorBase -.->|"base_type"| AppCoordinator
  CoordinatorBase -.->|"base_type"| OnboardingCoordinator

  AppCoordinator -->|"navigates_to"| SplashView
  AppCoordinator -->|"routes_to"| OnboardingCoordinator
  AppCoordinator -->|"navigates_to"| DashboardView

  OnboardingCoordinator -->|"presents"| OnboardingView

  %% MVVM binding/state
  SplashView -.->|"uses_styles"| Colors
  SplashView -.->|"uses_constants"| UIConstants
  OnboardingView -.->|"uses_styles"| Colors
  OnboardingView -.->|"uses_constants"| UIConstants
  DashboardView -.->|"uses_styles"| Colors
  DashboardView -.->|"uses_constants"| UIConstants

  OnboardingView -->|"binds_to"| OnboardingViewModel
  OnboardingViewModel -->|"uses"| OnboardingPage
  OnboardingView -.->|"composes"| BackgroundWave

  DashboardView -->|"binds_to"| DashboardViewModel
  DashboardViewModel -.->|"depends_on"| AgriDataService

  %% Protocol implementations
  MockAgriDataRepository -.->|"implements"| AgriDataService
  FutureRealRepo -.->|"implements"| AgriDataService

  %% Data returns/state
  AgriDataService -->|"fetches"| MockAgriDataRepository
  MockAgriDataRepository -->|"returns_[SensorReading]"| SensorReading
  DashboardViewModel -->|"exposes_state_from"| SensorReading

  %% Future external connectivity
  FutureRealRepo -.->|"talks_to"| FutureBackend

  %% Resources usage
  SplashView -.->|"loads_assets"| AssetsCatalog
  OnboardingView -.->|"loads_assets"| AssetsCatalog
  DashboardView -.->|"loads_assets"| AssetsCatalog
  SplashView -.->|"loads_images"| ImagesFolder
  OnboardingView -.->|"loads_images"| ImagesFolder
  DashboardView -.->|"loads_images"| ImagesFolder

  %% Notes connections
  NoteMVVM -.->|"applies_to"| DashboardViewModel
  NoteMVVM -.->|"applies_to"| OnboardingViewModel
  NoteCoord -.->|"drives"| AppCoordinator
  NoteDI -.->|"boundary"| AgriDataService

  %% =======================
  %% Click events (from component_mapping)
  %% =======================
  click AppDelegate "https://github.com/muhammadahmad522/agrivision/blob/main/AgriVision/AppDelegate.swift"
  click SceneDelegate "https://github.com/muhammadahmad522/agrivision/blob/main/AgriVision/SceneDelegate.swift"
  click InfoPlist "https://github.com/muhammadahmad522/agrivision/blob/main/AgriVision/Info.plist"

  click Colors "https://github.com/muhammadahmad522/agrivision/blob/main/AgriVision/Core/Config/Colors.swift"
  click UIConstants "https://github.com/muhammadahmad522/agrivision/blob/main/AgriVision/Core/Config/UIConstants.swift"

  click CoordinatorBase "https://github.com/muhammadahmad522/agrivision/blob/main/AgriVision/Core/Navigation/Coordinator.swift"
  click AppCoordinator "https://github.com/muhammadahmad522/agrivision/blob/main/AgriVision/Core/Navigation/AppCoordinator.swift"
  click OnboardingCoordinator "https://github.com/muhammadahmad522/agrivision/blob/main/AgriVision/Core/Navigation/OnboardingCoordinator.swift"

  click SensorReading "https://github.com/muhammadahmad522/agrivision/blob/main/AgriVision/Data/Models/SensorReading.swift"
  click AgriDataService "https://github.com/muhammadahmad522/agrivision/blob/main/AgriVision/Data/Protocols/AgriDataService.swift"
  click MockAgriDataRepository "https://github.com/muhammadahmad522/agrivision/blob/main/AgriVision/Data/Repositories/MockAgriDataRepository.swift"

  click SplashView "https://github.com/muhammadahmad522/agrivision/blob/main/AgriVision/Features/Splash/Views/SplashView.swift"

  click OnboardingPage "https://github.com/muhammadahmad522/agrivision/blob/main/AgriVision/Features/Onboarding/Models/OnboardingPage.swift"
  click OnboardingViewModel "https://github.com/muhammadahmad522/agrivision/blob/main/AgriVision/Features/Onboarding/ViewModels/OnboardingViewModel.swift"
  click OnboardingView "https://github.com/muhammadahmad522/agrivision/blob/main/AgriVision/Features/Onboarding/Views/OnboardingView.swift"
  click BackgroundWave "https://github.com/muhammadahmad522/agrivision/blob/main/AgriVision/Features/Onboarding/Views/backgroundWave.swift"

  click DashboardViewModel "https://github.com/muhammadahmad522/agrivision/blob/main/AgriVision/Features/Dashboard/ViewModels/DashboardViewModel.swift"
  click DashboardView "https://github.com/muhammadahmad522/agrivision/blob/main/AgriVision/Features/Dashboard/Views/DashboardView.swift"

  click AssetsCatalog "https://github.com/muhammadahmad522/agrivision/blob/main/AgriVision/Assets.xcassets"
  click ImagesFolder "https://github.com/muhammadahmad522/agrivision/tree/main/AgriVision/assets/images"

  %% =======================
  %% Styles
  %% =======================
  classDef external fill:#0b1220,stroke:#93c5fd,stroke-width:1.5px,color:#e5e7eb
  classDef lifecycle fill:#0b2a4a,stroke:#60a5fa,stroke-width:1.5px,color:#eaf2ff
  classDef nav fill:#4c1d95,stroke:#c4b5fd,stroke-width:1.5px,color:#f5f3ff
  classDef view fill:#0b4f6c,stroke:#67e8f9,stroke-width:1.5px,color:#ecfeff
  classDef viewmodel fill:#5b21b6,stroke:#f0abfc,stroke-width:1.5px,color:#faf5ff
  classDef protocol fill:#14532d,stroke:#86efac,stroke-width:1.5px,color:#ecfdf5
  classDef repo fill:#166534,stroke:#4ade80,stroke-width:1.5px,color:#ecfdf5
  classDef model fill:#064e3b,stroke:#34d399,stroke-width:1.5px,color:#ecfdf5
  classDef resource fill:#374151,stroke:#9ca3af,stroke-width:1.5px,color:#f9fafb
  classDef future fill:#111827,stroke:#6b7280,stroke-dasharray: 6 4,stroke-width:1.5px,color:#e5e7eb
  classDef config fill:#1f2937,stroke:#fbbf24,stroke-width:1.5px,color:#fff7ed
  classDef note fill:#1f2937,stroke:#22c55e,stroke-dasharray: 4 3,stroke-width:1.5px,color:#ecfdf5
```
