# mooaaz-shaabaan/saree3 architecture

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

- Interactive diagram: https://gitdiagram.com/mooaaz-shaabaan/saree3
- Repository: https://github.com/mooaaz-shaabaan/saree3

## Overview

##### Project type and purpose
- This is a cross-platform Flutter mobile/desktop/web application (“saree3”).
- It follows a layered architecture:
– Presentation (UI screens & widgets)
– State management (BLoC/Cubit)
– Data & Service layer (API calls, Firebase integration)
– Models & constants

##### File structure
- Top-level platform folders: android/, ios/, web/, linux/, macos/, windows/
→ These embed the Flutter engine on each platform.
- lib/: The Dart app itself, subdivided into:
– presentation/: UI (screens & widgets)
– bussines_logic/: state management using Cubits and States (Bloc pattern)
– services/: HTTP/Firebase service classes (e.g., api_product_services.dart)
– data/: data layer for login & signup
– model/: data models (restaurant, cart_item, address, user, etc.)
– constants/: app constants & providers injection
– main.dart: app entrypoint
- assets/: fonts, images, mapStyle.json
- firebase.json & lib/firebase_options.dart: Firebase config

##### Pull additional insights from README
- README is generic (“A new Flutter project.”).

##### Main components
a. Platform Shells
– Android, iOS, Web, Windows, macOS, Linux
– All host the Flutter Engine, which in turn runs the Dart app.
b. Flutter Engine & Embedder
c. Application Layers (in the Dart VM)
1. Presentation Layer
- lib/presentation/screens (Splash, Auth, Home, Cart, Maps, Profile)
- lib/presentation/widgets (UI components)
2. State Management Layer
- lib/bussines_logic/*
- Multiple Cubit modules: AuthCubit, LoginCubit, CartCubit, AddressCubit, etc.
3. Service & Data Layer
- lib/services/api_product_services.dart
- lib/data/login&signUp.dart
- Firebase integration (lib/firebase_options.dart)
4. Domain Models & Constants
- lib/model/* (address_model, cart_item, restaurant_model, etc.)
- lib/constants/constants.dart & providers.dart
d. External Services
– RESTful backend API (pointed to by api_product_services)
– Firebase services (Auth, Firestore, Analytics, etc.)
– Google Maps API (mapStyle.json suggests map styling)

##### Relationships and data flow
- UI widget (presentation) dispatches events to a specific Cubit (business_logic).
- Cubit processes the event, may read/update a domain model, then calls a Service/Data function.
- Service layer issues HTTP or Firebase calls to external services.
- External API/Firebase returns data → service layer parses into domain models → Cubit emits new state → UI rebuilds.

##### Architectural patterns & principles
- Layered architecture (separation of concerns).
- BLoC/Cubit pattern for state management.
- Dependency injection via providers.dart.
- Clean domain models in lib/model.
- Assets and platform-specific configurations isolated under respective folders.

##### Capturing the essential details
- Call out key services (e.g., “lib/services/api_product_services.dart → REST API endpoint”).

## Diagram (Mermaid)

```mermaid
graph TD
    %% Platform Layer
    subgraph "Platform Shells"
        direction TB
        Android["Android"]:::platform
        iOS["iOS"]:::platform
        Web["Web"]:::platform
        Linux["Linux"]:::platform
        macOS["macOS"]:::platform
        Windows["Windows"]:::platform
    end

    %% Engine
    Engine["Flutter Engine + Embedder"]:::engine

    %% Entry Point
    Main["main.dart"]:::engine

    %% Application Layers
    subgraph "Presentation Layer" 
        direction TB
        Screens["Screens\n(lib/presentation/screens/)"]:::presentation
        Widgets["Widgets\n(lib/presentation/widgets/)"]:::presentation
    end

    subgraph "State Management (Cubits)" 
        direction TB
        AddressCubit["AddressCubit"]:::state
        AuthCubit["AuthCubit"]:::state
        CartCubit["CartCubit"]:::state
        DataUserCubit["DataUserCubit"]:::state
        FavoriteCubit["FavoriteCubit"]:::state
        LoginCubit["LoginCubit"]:::state
        MapsOrderCubit["MapsOrderCubit"]:::state
        SearchCubit["SearchCubit"]:::state
        SignUpCubit["SignUpCubit"]:::state
        TrackingOrderMapCubit["TrackingOrderMapCubit"]:::state
        UserMapsCubit["UserMapsCubit"]:::state
        VerifyCubit["VerifyCubit"]:::state
    end

    subgraph "Service & Data Layer"
        direction TB
        APIService["API Product Services"]:::service
        AuthData["Login & Signup Data"]:::service
        FirebaseConfig["Firebase Configuration"]:::service
    end

    subgraph "Domain Models & Constants"
        direction TB
        AddressModel["Address Model"]:::model
        CartItemModel["Cart Item Model"]:::model
        DriverModel["Driver Model"]:::model
        PopularFoodModel["Popular Food Model"]:::model
        ProductModel["Product Model"]:::model
        RestaurantModel["Restaurant Model"]:::model
        RestaurantRating["Restaurant Rating Model"]:::model
        Constants["Constants"]:::model
        Providers["Providers"]:::model
    end

    subgraph "External Services"
        direction TB
        RESTAPI["RESTful API"]:::external
        FirebaseSvc["Firebase Services"]:::external
        GoogleMaps["Google Maps API"]:::external
    end

    %% Flow
    Android --> Engine
    iOS --> Engine
    Web --> Engine
    Linux --> Engine
    macOS --> Engine
    Windows --> Engine

    Engine --> Main
    Main --> Screens
    Main --> Widgets

    Screens --> AddressCubit
    Widgets --> AddressCubit

    AddressCubit --> APIService
    AuthCubit --> AuthData
    CartCubit --> APIService
    DataUserCubit --> AuthData
    FavoriteCubit --> APIService
    LoginCubit --> AuthData
    MapsOrderCubit --> APIService
    SearchCubit --> APIService
    SignUpCubit --> AuthData
    TrackingOrderMapCubit --> APIService
    UserMapsCubit --> APIService
    VerifyCubit --> AuthData

    APIService --> RESTAPI
    AuthData --> FirebaseSvc
    FirebaseConfig --> FirebaseSvc

    RESTAPI --> APIService
    FirebaseSvc --> AuthData

    APIService --> ProductModel
    AuthData --> ProductModel

    ProductModel --> Constants
    ProductModel --> Providers

    %% Click Events
    click Android "https://github.com/mooaaz-shaabaan/saree3/tree/main/android/"
    click iOS "https://github.com/mooaaz-shaabaan/saree3/tree/main/ios/"
    click Web "https://github.com/mooaaz-shaabaan/saree3/tree/main/web/"
    click Linux "https://github.com/mooaaz-shaabaan/saree3/tree/main/linux/"
    click macOS "https://github.com/mooaaz-shaabaan/saree3/tree/main/macos/"
    click Windows "https://github.com/mooaaz-shaabaan/saree3/tree/main/windows/"

    click Screens "https://github.com/mooaaz-shaabaan/saree3/tree/main/lib/presentation/screens/"
    click Widgets "https://github.com/mooaaz-shaabaan/saree3/tree/main/lib/presentation/widgets/"

    click AddressCubit "https://github.com/mooaaz-shaabaan/saree3/blob/main/lib/bussines_logic/address/address_cubit.dart"
    click AuthCubit "https://github.com/mooaaz-shaabaan/saree3/blob/main/lib/bussines_logic/auth/auth_logic.dart"
    click CartCubit "https://github.com/mooaaz-shaabaan/saree3/blob/main/lib/bussines_logic/cart/cart_logic.dart"
    click DataUserCubit "https://github.com/mooaaz-shaabaan/saree3/blob/main/lib/bussines_logic/data_user/data_user_cubit.dart"
    click FavoriteCubit "https://github.com/mooaaz-shaabaan/saree3/blob/main/lib/bussines_logic/favorite/favorite_cubit.dart"
    click LoginCubit "https://github.com/mooaaz-shaabaan/saree3/blob/main/lib/bussines_logic/login/login_cubit.dart"
    click MapsOrderCubit "https://github.com/mooaaz-shaabaan/saree3/blob/main/lib/bussines_logic/maps_order/maps_order_cubit.dart"
    click SearchCubit "https://github.com/mooaaz-shaabaan/saree3/blob/main/lib/bussines_logic/serach/search_cubit.dart"
    click SignUpCubit "https://github.com/mooaaz-shaabaan/saree3/blob/main/lib/bussines_logic/signUp/signup_cubit.dart"
    click TrackingOrderMapCubit "https://github.com/mooaaz-shaabaan/saree3/blob/main/lib/bussines_logic/tracking_order_map/tracking_order_map_cubit.dart"
    click UserMapsCubit "https://github.com/mooaaz-shaabaan/saree3/blob/main/lib/bussines_logic/user_maps/user_maps_cubit.dart"
    click VerifyCubit "https://github.com/mooaaz-shaabaan/saree3/blob/main/lib/bussines_logic/verify/verify_cubit.dart"

    click APIService "https://github.com/mooaaz-shaabaan/saree3/blob/main/lib/services/api_proudct_services.dart"
    click AuthData "https://github.com/mooaaz-shaabaan/saree3/blob/main/lib/data/login&signUp.dart"
    click FirebaseConfig "https://github.com/mooaaz-shaabaan/saree3/blob/main/lib/firebase_options.dart"

    click AddressModel "https://github.com/mooaaz-shaabaan/saree3/blob/main/lib/model/address/address_model.dart"
    click CartItemModel "https://github.com/mooaaz-shaabaan/saree3/blob/main/lib/model/cart_item.dart"
    click DriverModel "https://github.com/mooaaz-shaabaan/saree3/blob/main/lib/model/driverModel.dart"
    click PopularFoodModel "https://github.com/mooaaz-shaabaan/saree3/blob/main/lib/model/popularFoodModel.dart"
    click ProductModel "https://github.com/mooaaz-shaabaan/saree3/blob/main/lib/model/prodact_model.dart"
    click RestaurantModel "https://github.com/mooaaz-shaabaan/saree3/blob/main/lib/model/restaurant/restaurant_model.dart"
    click RestaurantRating "https://github.com/mooaaz-shaabaan/saree3/blob/main/lib/model/restaurant/restaurant_rating.dart"
    click Constants "https://github.com/mooaaz-shaabaan/saree3/blob/main/lib/constants/constants.dart"
    click Providers "https://github.com/mooaaz-shaabaan/saree3/blob/main/lib/constants/providers.dart"

    click Main "https://github.com/mooaaz-shaabaan/saree3/blob/main/lib/main.dart"
    click FirebaseConfig "https://github.com/mooaaz-shaabaan/saree3/blob/main/firebase.json"

    %% Styles
    classDef platform fill:#E0FFFF,stroke:#000
    classDef engine fill:#D3D3D3,stroke:#000
    classDef presentation fill:#ADD8E6,stroke:#000
    classDef state fill:#90EE90,stroke:#000
    classDef service fill:#FFFF99,stroke:#000
    classDef model fill:#FFA500,stroke:#000
    classDef external fill:#FFCCCC,stroke:#000
```
