# nimastic/qnow-intuitionv8-hackathon-2022 architecture

> Architecture diagram of the GitHub repository nimastic/qnow-intuitionv8-hackathon-2022, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2024-12-31). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/nimastic/qnow-intuitionv8-hackathon-2022
- Repository: https://github.com/nimastic/qnow-intuitionv8-hackathon-2022

## Overview

##### High-Level Architecture Overview

a) Presentation Layer (Top)
- Screens/views (booking_confirmation, filter_functions, loading_page)
- GetX state management integration
- Controllers for each screen
- Bindings for dependency injection

b) Core Layer (Middle)
- Utils and Helpers
- Network Infrastructure
- Error Handling
- Common Widgets

c) Data Layer (Bottom)
- API Client
- Models
- Local Storage (Shared Preferences)
- Network Repository

##### Component Relationships

**User Interface ↔ GetX Controllers ↔ Repository ↔ API Client/Local Storage**

##### Detailed Component Breakdown

- Blue: UI Components
- Green: Business Logic (Controllers)
- Yellow: Data Management
- Gray: Core Utilities

##### Specific Elements

Frontend (UI Layer):
- Presentation screens (booking_confirmation_screen, filter_functions_screen, loading_page_screen)
- Theme management (app_decoration.dart, app_style.dart)
- Asset management (fonts, images)

Core Services:
- Network info service
- Error handling (exceptions.dart, failures.dart)
- Utilities (color_constant, image_constant, math_utils)
- Common widgets (common_network_image, paginated_list_view)

Data Management:
- API Client
- Model classes
- Shared Preferences integration
- Cached network image handling

Platform-Specific:
- Android configuration
- iOS configuration

##### Key Architectural Patterns to Highlight

- GetX Pattern for state management
- Repository Pattern for data handling
- Dependency Injection through bindings
- Clean Architecture principles

##### External Integrations

Connections to:
- Network services
- Local storage
- Image caching system
- Platform-specific implementations

##### External Services Layer

Use these symbols:
- Rectangles: Components
- Diamonds: Decision points

## Diagram (Mermaid)

```mermaid
graph TB
    subgraph Presentation
        UI_Screens["UI Screens"]
        BookingScreen["Booking Screen"]
        FilterScreen["Filter Screen"]
        LoadingScreen["Loading Screen"]
        UI_Screens --> BookingScreen & FilterScreen & LoadingScreen
    end

    subgraph Controllers
        BookingController["Booking Controller"]
        LoadingController["Loading Controller"]
        InitialBindings["Initial Bindings"]
    end

    subgraph Core
        NetworkInfra["Network Infrastructure"]
        ErrorHandling["Error Handling"]
        CommonWidgets["Common Widgets"]
        Utils["Utilities"]
    end

    subgraph Theme
        AppDecoration["App Decoration"]
        AppStyle["App Style"]
    end

    subgraph Data
        APIClient["API Client"]
        Models["Models"]
        LocalStorage["Local Storage"]
    end

    subgraph Assets
        Fonts["Fonts"]
        Images["Images"]
    end

    subgraph Platform
        Android["Android Config"]
        iOS["iOS Config"]
    end

    subgraph CoreUtils
        ColorConst["Color Constants"]
        ImageConst["Image Constants"]
        MathUtils["Math Utils"]
        ProgressDialog["Progress Dialog"]
    end

    UI_Screens --> Controllers
    Controllers --> Core
    Controllers --> Data
    UI_Screens --> Theme
    UI_Screens --> Assets
    Core --> Data
    Core --> CoreUtils
    Data --> Platform

    %% Click events for component mapping
    click UI_Screens "https://github.com/Nimastic/QNow-iNTUitionv8-Hackathon-2022/tree/main/logs/lib/presentation/"
    click BookingScreen "https://github.com/Nimastic/QNow-iNTUitionv8-Hackathon-2022/tree/main/logs/lib/presentation/booking_confirmation_screen/"
    click FilterScreen "https://github.com/Nimastic/QNow-iNTUitionv8-Hackathon-2022/tree/main/logs/lib/presentation/filter_functions_screen/"
    click LoadingScreen "https://github.com/Nimastic/QNow-iNTUitionv8-Hackathon-2022/tree/main/logs/lib/presentation/loading_page_screen/"
    click BookingController "https://github.com/Nimastic/QNow-iNTUitionv8-Hackathon-2022/blob/main/logs/lib/presentation/booking_confirmation_screen/controller/booking_confirmation_controller.dart"
    click LoadingController "https://github.com/Nimastic/QNow-iNTUitionv8-Hackathon-2022/blob/main/logs/lib/presentation/loading_page_screen/controller/loading_page_controller.dart"
    click InitialBindings "https://github.com/Nimastic/QNow-iNTUitionv8-Hackathon-2022/blob/main/logs/lib/core/utils/initial_bindings.dart"
    click NetworkInfra "https://github.com/Nimastic/QNow-iNTUitionv8-Hackathon-2022/blob/main/logs/lib/core/network/network_info.dart"
    click ErrorHandling "https://github.com/Nimastic/QNow-iNTUitionv8-Hackathon-2022/tree/main/logs/lib/core/errors/"
    click CommonWidgets "https://github.com/Nimastic/QNow-iNTUitionv8-Hackathon-2022/tree/main/logs/lib/core/widgets/"
    click Utils "https://github.com/Nimastic/QNow-iNTUitionv8-Hackathon-2022/tree/main/logs/lib/core/utils/"
    click APIClient "https://github.com/Nimastic/QNow-iNTUitionv8-Hackathon-2022/blob/main/logs/lib/data/apiClient/api_client.dart"
    click Models "https://github.com/Nimastic/QNow-iNTUitionv8-Hackathon-2022/tree/main/logs/lib/data/models/"
    click LocalStorage "https://github.com/Nimastic/QNow-iNTUitionv8-Hackathon-2022/blob/main/logs/lib/core/utils/pref_utils.dart"
    click AppDecoration "https://github.com/Nimastic/QNow-iNTUitionv8-Hackathon-2022/blob/main/logs/lib/theme/app_decoration.dart"
    click AppStyle "https://github.com/Nimastic/QNow-iNTUitionv8-Hackathon-2022/blob/main/logs/lib/theme/app_style.dart"
    click Fonts "https://github.com/Nimastic/QNow-iNTUitionv8-Hackathon-2022/tree/main/assets/fonts/"
    click Images "https://github.com/Nimastic/QNow-iNTUitionv8-Hackathon-2022/tree/main/assets/images/"
    click Android "https://github.com/Nimastic/QNow-iNTUitionv8-Hackathon-2022/tree/main/android/"
    click iOS "https://github.com/Nimastic/QNow-iNTUitionv8-Hackathon-2022/tree/main/ios/"
    click ColorConst "https://github.com/Nimastic/QNow-iNTUitionv8-Hackathon-2022/blob/main/logs/lib/core/utils/color_constant.dart"
    click ImageConst "https://github.com/Nimastic/QNow-iNTUitionv8-Hackathon-2022/blob/main/logs/lib/core/utils/image_constant.dart"
    click MathUtils "https://github.com/Nimastic/QNow-iNTUitionv8-Hackathon-2022/blob/main/logs/lib/core/utils/math_utils.dart"
    click ProgressDialog "https://github.com/Nimastic/QNow-iNTUitionv8-Hackathon-2022/blob/main/logs/lib/core/utils/progress_dialog_utils.dart"

    classDef presentation fill:#a8e6cf
    classDef controller fill:#dcedc1
    classDef core fill:#ffd3b6
    classDef theme fill:#ffaaa5
    classDef data fill:#ff8b94
    classDef assets fill:#e8e8e8
    classDef platform fill:#d8d8d8
    classDef utils fill:#c8c8c8

    class UI_Screens,BookingScreen,FilterScreen,LoadingScreen presentation
    class BookingController,LoadingController,InitialBindings controller
    class NetworkInfra,ErrorHandling,CommonWidgets,Utils core
    class AppDecoration,AppStyle theme
    class APIClient,Models,LocalStorage data
    class Fonts,Images assets
    class Android,iOS platform
    class ColorConst,ImageConst,MathUtils,ProgressDialog utils
```
