# sumit-22/shopping-cart architecture

> Architecture diagram of the GitHub repository sumit-22/shopping-cart, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-08-28). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/sumit-22/shopping-cart
- Repository: https://github.com/sumit-22/shopping-cart

## Overview

##### Project Type & Purpose
- BlinkShop is an Android e-commerce mobile application built in Kotlin, following the MVVM (Model-View-ViewModel) architecture.
- It provides user and admin modules, authentication (Firebase Auth), product browsing, cart management (Room DB), payment integration (Razorpay), real-time order tracking (Firestore + Google Maps), and push notifications (FCM).

##### Key File-Structure Insights
- Top-level “app” module: Android Gradle module with source under src/main
- activity/ & fragments/: UI screens (XML + Kotlin)
- adapters/: RecyclerView adapters for lists
- viewmodels/: AuthViewModel & userViewModel for LiveData & UI logic
- api/: Retrofit ApiInterface & ApiUtilities for network calls
- roomdb/: Room entities, DAO, Database for offline cart
- models/: Data classes for Firestore/JSON mapping
- auth/, delivery/, deliverydash/: Feature-specific UI logic
- Utils, Constants, NotificationService, FCMTokencallback: cross-cutting utilities
- Configuration: google-services.json (Firebase), proguard, Gradle scripts.

a. UI Layer
- Activities & Fragments (Home, Auth, Cart, Orders, Delivery Dash)
- Layout XML resources
b. ViewModel Layer
- AuthViewModel, userViewModel exposing LiveData to UI
c. Repository / Data Layer
- Retrofit (ApiInterface → REST endpoints)
- Firebase Firestore / Firebase Auth
- Room DB (CartProductsDatabase)
- SharedPreferences (Utils)
d. Services & External Systems
- Firebase Cloud Messaging (NotificationService)
- Razorpay SDK (Payment processing)
- Google Maps API (Real-time location)
e. Models
- Domain objects (Product, Orders, Users, DeliveryPartner)

##### Relationships & Data Flow
- UI → observes → ViewModel
- ViewModel → calls → Repository methods
- Repository → either:
- fetch/write → Firestore/Firebase Auth
- perform → Retrofit network operations
- query → Room DB
- External events (FCM pushes) → NotificationService → triggers UI updates
- Payment flow: UI initiates → Razorpay SDK → payment callback → ViewModel updates Firestore

##### Architectural Patterns & Principles
- MVVM separation: UI vs business logic vs data
- Repository pattern: abstracting data sources
- Single-source-of-truth: Room + Firestore sync
- Dependency inversion via interfaces (ApiInterface, DAOs)

##### Essential Elements to Capture
- All Activities/Fragments as entry points
- ViewModels mediating UI and data
- Multiple data sources (Firestore, REST API, Room)
- External integrations (FCM, Razorpay, Maps)
- Repository as the central abstraction layer

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% UI Layer
    subgraph "UI Layer" 
        direction TB
        AuthMainActivity["AuthMainActivity"]:::ui
        UsersMainActivity["UsersMainActivity"]:::ui
        DeliveryStatusActivity["DeliveryStatusActivity"]:::ui
        OrderPlaceActivity["OrderPlaceActivity"]:::ui
        deliveryActivity["deliveryActivity"]:::ui

        OTPFragment["OTPFragment"]:::ui
        SigninFragment["SigninFragment"]:::ui
        SplashFragment["SplashFragment"]:::ui

        HomeFragment["HomeFragment"]:::ui
        CategoryFragment["CategoryFragment"]:::ui
        productFragment["productFragment"]:::ui
        searchFragment["searchFragment"]:::ui
        OrdersFragment["OrdersFragment"]:::ui
        OrderDetailsFragment["OrderDetailsFragment"]:::ui
        ProfileFragment["ProfileFragment"]:::ui

        AvailableFragment["AvailableFragment"]:::ui
        DeliveredFragment["DeliveredFragment"]:::ui
        deliveryAuth["deliveryAuth"]:::ui
        deliverydashFragment["deliverydashFragment"]:::ui
    end

    %% ViewModel Layer
    subgraph "ViewModel Layer"
        direction TB
        AuthViewModel["AuthViewModel"]:::vm
        userViewModel["userViewModel"]:::vm
    end

    %% Repository / Data Layer
    subgraph "Repository / Data Layer"
        direction TB
        ApiInterface["ApiInterface"]:::data
        ApiUtilities["ApiUtilities"]:::data

        CartProductsDatabase[(CartProductsDatabase)]:::data
        CartProductsEntity["CartProducts entity"]:::data
        CartProductsDao["CartProductsDao"]:::data

        Models["Models (Product, Orders, Users, DeliveryPartner)"]:::data

        SharedPrefs["SharedPreferences (Utils)"]:::data
    end

    %% External Services
    subgraph "External Services"
        direction TB
        FirebaseAuth["Firebase Auth"]:::external
        Firestore["Firestore"]:::external
        FCM["Firebase Cloud Messaging"]:::external
        Razorpay["Razorpay SDK"]:::external
        GoogleMaps["Google Maps API"]:::external
    end

    %% Connections UI -> ViewModel
    AuthMainActivity -->|observes| AuthViewModel
    OTPFragment -->|observes| AuthViewModel
    SigninFragment -->|observes| AuthViewModel
    SplashFragment -->|observes| AuthViewModel

    UsersMainActivity -->|observes| userViewModel
    HomeFragment -->|observes| userViewModel
    CategoryFragment -->|observes| userViewModel
    productFragment -->|observes| userViewModel
    searchFragment -->|observes| userViewModel
    OrdersFragment -->|observes| userViewModel
    OrderDetailsFragment -->|observes| userViewModel
    ProfileFragment -->|observes| userViewModel

    DeliveryStatusActivity -->|observes| userViewModel
    OrderPlaceActivity -->|observes| userViewModel
    deliveryActivity -->|observes| userViewModel
    AvailableFragment -->|observes| userViewModel
    DeliveredFragment -->|observes| userViewModel
    deliveryAuth -->|observes| userViewModel
    deliverydashFragment -->|observes| userViewModel

    %% ViewModel -> Repository
    AuthViewModel -->|calls| ApiInterface
    AuthViewModel -->|calls| FirebaseAuth
    userViewModel -->|calls| ApiInterface
    userViewModel -->|calls| Firestore
    userViewModel -->|queries| CartProductsDatabase
    userViewModel -->|uses| SharedPrefs

    ApiInterface -->|utilizes| ApiUtilities
    CartProductsDatabase -->|contains| CartProductsEntity
    CartProductsDatabase -->|uses| CartProductsDao

    %% Repository -> External Services
    ApiInterface -->|REST calls| Razorpay
    ApiInterface -->|REST calls| GoogleMaps
    Firestore -->|syncs| CartProductsDatabase

    %% External events
    FCM -->|push events| NotificationService
    NotificationService["NotificationService"]:::external -->|updates UI| userViewModel

    %% Click Events UI
    click AuthMainActivity "https://github.com/sumit-22/shopping-cart/blob/master/app/src/main/java/com/example/blinkshop/activity/AuthMainActivity.kt"
    click UsersMainActivity "https://github.com/sumit-22/shopping-cart/blob/master/app/src/main/java/com/example/blinkshop/activity/UsersMainActivity.kt"
    click DeliveryStatusActivity "https://github.com/sumit-22/shopping-cart/blob/master/app/src/main/java/com/example/blinkshop/activity/DeliveryStatusActivity.kt"
    click OrderPlaceActivity "https://github.com/sumit-22/shopping-cart/blob/master/app/src/main/java/com/example/blinkshop/activity/OrderPlaceActivity.kt"
    click deliveryActivity "https://github.com/sumit-22/shopping-cart/blob/master/app/src/main/java/com/example/blinkshop/activity/deliveryActivity.kt"

    click OTPFragment "https://github.com/sumit-22/shopping-cart/blob/master/app/src/main/java/com/example/blinkshop/auth/OTPFragment.kt"
    click SigninFragment "https://github.com/sumit-22/shopping-cart/blob/master/app/src/main/java/com/example/blinkshop/auth/SigninFragment.kt"
    click SplashFragment "https://github.com/sumit-22/shopping-cart/blob/master/app/src/main/java/com/example/blinkshop/auth/SplashFragment.kt"

    click HomeFragment "https://github.com/sumit-22/shopping-cart/blob/master/app/src/main/java/com/example/blinkshop/fragments/HomeFragment.kt"
    click CategoryFragment "https://github.com/sumit-22/shopping-cart/blob/master/app/src/main/java/com/example/blinkshop/fragments/CategoryFragment.kt"
    click productFragment "https://github.com/sumit-22/shopping-cart/blob/master/app/src/main/java/com/example/blinkshop/fragments/productFragment.kt"
    click searchFragment "https://github.com/sumit-22/shopping-cart/blob/master/app/src/main/java/com/example/blinkshop/fragments/searchFragment.kt"
    click OrdersFragment "https://github.com/sumit-22/shopping-cart/blob/master/app/src/main/java/com/example/blinkshop/fragments/OrdersFragment.kt"
    click OrderDetailsFragment "https://github.com/sumit-22/shopping-cart/blob/master/app/src/main/java/com/example/blinkshop/fragments/OrderDetailsFragment.kt"
    click ProfileFragment "https://github.com/sumit-22/shopping-cart/blob/master/app/src/main/java/com/example/blinkshop/fragments/ProfileFragment.kt"

    click AvailableFragment "https://github.com/sumit-22/shopping-cart/blob/master/app/src/main/java/com/example/blinkshop/deliverydash/AvailableFragment.kt"
    click DeliveredFragment "https://github.com/sumit-22/shopping-cart/blob/master/app/src/main/java/com/example/blinkshop/deliverydash/DeliveredFragment.kt"
    click deliveryAuth "https://github.com/sumit-22/shopping-cart/blob/master/app/src/main/java/com/example/blinkshop/delivery/deliveryAuth.kt"
    click deliverydashFragment "https://github.com/sumit-22/shopping-cart/blob/master/app/src/main/java/com/example/blinkshop/delivery/deliverydashFragment.kt"

    %% Click Events ViewModel
    click AuthViewModel "https://github.com/sumit-22/shopping-cart/blob/master/app/src/main/java/com/example/blinkshop/viewmodels/AuthViewModel.kt"
    click userViewModel "https://github.com/sumit-22/shopping-cart/blob/master/app/src/main/java/com/example/blinkshop/viewmodels/userViewModel.kt"

    %% Click Events Repository/Data
    click ApiInterface "https://github.com/sumit-22/shopping-cart/blob/master/app/src/main/java/com/example/blinkshop/api/ApiInterface.kt"
    click ApiUtilities "https://github.com/sumit-22/shopping-cart/blob/master/app/src/main/java/com/example/blinkshop/api/ApiUtilities.kt"
    click CartProductsEntity "https://github.com/sumit-22/shopping-cart/blob/master/app/src/main/java/com/example/blinkshop/roomdb/CartProducts.kt"
    click CartProductsDao "https://github.com/sumit-22/shopping-cart/blob/master/app/src/main/java/com/example/blinkshop/roomdb/CartProductsDao.kt"
    click CartProductsDatabase "https://github.com/sumit-22/shopping-cart/blob/master/app/src/main/java/com/example/blinkshop/roomdb/CartProductsDatabase.kt"
    click Models "https://github.com/sumit-22/shopping-cart/tree/master/app/src/main/java/com/example/blinkshop/models/"

    click NotificationService "https://github.com/sumit-22/shopping-cart/blob/master/app/src/main/java/com/example/blinkshop/NotificationService.kt"

    click Constants "https://github.com/sumit-22/shopping-cart/blob/master/app/src/main/java/com/example/blinkshop/Constants.kt"
    click Utils "https://github.com/sumit-22/shopping-cart/blob/master/app/src/main/java/com/example/blinkshop/Utils.kt"
    click accessToken "https://github.com/sumit-22/shopping-cart/blob/master/app/src/main/java/com/example/blinkshop/accessToken.kt"

    %% Styles
    classDef ui fill:#cce5ff,stroke:#1f78b4,color:#000
    classDef vm fill:#d4edda,stroke:#28a745,color:#000
    classDef data fill:#ffe5b4,stroke:#ff8c00,color:#000
    classDef external fill:#e2e3e5,stroke:#6c757d,color:#000
```
