# rahul8639/ezyeats architecture

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

- Interactive diagram: https://gitdiagram.com/rahul8639/ezyeats
- Repository: https://github.com/rahul8639/ezyeats

## Overview

##### Project type and purpose
- EzyEats is a native Android application (no separate backend code in this repo).
- Purpose: allow users to register/login, select university, browse restaurants & menus, build a cart, place orders, view order success, manage wallets, and (for admins) view a dashboard.

##### File structure
- Top‐level “app” module with a standard Android Gradle layout:
- src/main/java/com/example/ezyeatsapplication/ → Activities (SplashActivity, LoginActivity, RegistrationActivity, SelectUniversity, PlaceYourOrderActivity, OrderSucceessActivity, RestaurantMenuActivity, AdminPannel, DashBoard) and Fragments (HomeFragment, MenuFragment, CartFragment, WalletFragment)
- adapters/ → RecyclerView adapters (RestaurantListAdapter, MenuListAdapter, PlaceYourOrderAdapter)
- model/ → POJOs (RestaurantModel, Menu, Hours) and business objects (CartItem)
- NetworkUtil.java → single entry point for all HTTP / REST / Firebase calls
- src/main/res/raw/restaurent.json → local data source for restaurants
- google-services.json → Firebase integration
- Resource directories (layouts, drawables, fonts, values) define the UI templates and styles.

##### Key insights from README
- No hidden microservices; “just pull the code and build apk.”
- Implicit Firebase dependency (google-services.json) and local JSON data.

a. Components
- Presentation Layer (UI) – Activities & Fragments
- Adapter Layer – Adapters translating models ↔ RecyclerViews
- Data Layer – Models and Cart logic
- Network Layer – NetworkUtil wrapping Firebase/REST calls
- Data Stores – Local JSON (raw), Firebase Auth & Database
- External Services – Firebase (Auth, Realtime/Firestore)
b. Relationships & Interactions
- User taps UI (Activity or Fragment) → calls Adapter or direct method
- UI/Fragment invokes NetworkUtil for remote calls OR reads local JSON
- NetworkUtil ↔ Firebase (Auth, DB) or hits REST endpoints
- Data (models) flows back up to Adapters → UI updates
- Cart operations held in memory (CartItem) and optionally persisted (SharedPrefs or Firebase)
c. Architectural patterns & principles
- A simple MVC/MVP–style: Activities/Fragments (Controller/View) talk directly to NetworkUtil (Model)
- Separation of concerns: UI, data adapters, data models, network
d. Technologies & frameworks
- Android SDK (Activities, Fragments, RecyclerView)
- Firebase (authentication, database)
- JSON parsing (Gson or built-in)
- Gradle (build.gradle.kts)

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Auth Flow
    subgraph "Auth Flow"
        SA["SplashActivity"]:::ui
        LA["LoginActivity"]:::ui
        RA["RegistrationActivity"]:::ui
        SU["SelectUniversity"]:::ui
    end

    %% Browsing Flow
    subgraph "Browsing Flow"
        HF["HomeFragment"]:::ui
        RMA["RestaurantMenuActivity"]:::ui
        MF["MenuFragment"]:::ui
        PYA["PlaceYourOrderActivity"]:::ui
    end

    %% Cart & Checkout Flow
    subgraph "Cart & Checkout Flow"
        CF["CartFragment"]:::ui
        OSA["OrderSucceessActivity"]:::ui
    end

    %% Admin Flow
    subgraph "Admin Flow"
        AP["AdminPannel"]:::ui
        DBA["DashBoard"]:::ui
    end

    %% Adapter Layer
    subgraph "Adapter Layer"
        RLA["RestaurantListAdapter"]:::adapter
        MLA["MenuListAdapter"]:::adapter
        POA["PlaceYourOrderAdapter"]:::adapter
    end

    %% Data Layer
    subgraph "Models & Data Layer"
        RM["RestaurantModel"]:::model
        MN["Menu"]:::model
        HR["Hours"]:::model
        CI["CartItem"]:::model
    end

    %% Network Layer
    NU["NetworkUtil"]:::network

    %% Data Stores & External
    RJS["restaurent.json"]:::datastore
    GSG["google-services.json"]:::datastore
    FA["Firebase Auth"]:::external
    FD["Firebase Database"]:::external

    %% Interactions
    SA -->|"launch"| LA
    LA -->|"Auth.signIn"| NU
    RA -->|"Auth.register"| NU
    SU -->|"Auth.selectUniversity"| NU

    HF -->|"bind restaurants"| RLA
    RMA -->|"bind menu"| MLA
    MF -->|"select item"| PYA
    PYA -->|"build cart"| POA
    CF -->|"checkout"| NU
    CF -->|"view cart"| POA
    OSA -->|"order success"| CF
    AP -->|"view stats"| NU
    DBA -->|"dashboard data"| NU

    %% UI to Network
    SA -->|"init data"| NU
    HF -->|"GET restaurants"| NU
    CF -->|"POST order"| NU

    %% Network to DataStores
    NU -->|"parse JSON"| RJS
    NU -->|"read config"| GSG
    NU -->|"Auth.signIn"| FA
    NU -->|"read/write"| FD

    %% Adapters to Models
    RLA -->|"use data"| RM
    MLA -->|"use data"| MN
    POA -->|"use data"| CI

    %% Models to UI (data flow)
    RM -->|"render list"| HF
    MN -->|"render menu"| MF
    CI -->|"display items"| CF

    %% Click Events
    click SA "https://github.com/rahul8639/ezyeats/blob/master/app/src/main/java/com/example/ezyeatsapplication/SplashActivity.java"
    click LA "https://github.com/rahul8639/ezyeats/blob/master/app/src/main/java/com/example/ezyeatsapplication/LoginActivity.java"
    click RA "https://github.com/rahul8639/ezyeats/blob/master/app/src/main/java/com/example/ezyeatsapplication/RegistrationActivity.java"
    click SU "https://github.com/rahul8639/ezyeats/blob/master/app/src/main/java/com/example/ezyeatsapplication/SelectUniversity.java"
    click PYA "https://github.com/rahul8639/ezyeats/blob/master/app/src/main/java/com/example/ezyeatsapplication/PlaceYourOrderActivity.java"
    click OSA "https://github.com/rahul8639/ezyeats/blob/master/app/src/main/java/com/example/ezyeatsapplication/OrderSucceessActivity.java"
    click RMA "https://github.com/rahul8639/ezyeats/blob/master/app/src/main/java/com/example/ezyeatsapplication/RestaurantMenuActivity.java"
    click AP "https://github.com/rahul8639/ezyeats/blob/master/app/src/main/java/com/example/ezyeatsapplication/AdminPannel.java"
    click DBA "https://github.com/rahul8639/ezyeats/blob/master/app/src/main/java/com/example/ezyeatsapplication/DashBoard.java"
    click HF "https://github.com/rahul8639/ezyeats/blob/master/app/src/main/java/com/example/ezyeatsapplication/HomeFragment.java"
    click MF "https://github.com/rahul8639/ezyeats/blob/master/app/src/main/java/com/example/ezyeatsapplication/MenuFragment.java"
    click CF "https://github.com/rahul8639/ezyeats/blob/master/app/src/main/java/com/example/ezyeatsapplication/CartFragment.java"
    click MLA "https://github.com/rahul8639/ezyeats/blob/master/app/src/main/java/com/example/ezyeatsapplication/adapters/MenuListAdapter.java"
    click RLA "https://github.com/rahul8639/ezyeats/blob/master/app/src/main/java/com/example/ezyeatsapplication/adapters/RestaurantListAdapter.java"
    click POA "https://github.com/rahul8639/ezyeats/blob/master/app/src/main/java/com/example/ezyeatsapplication/adapters/PlaceYourOrderAdapter.java"
    click RM "https://github.com/rahul8639/ezyeats/blob/master/app/src/main/java/com/example/ezyeatsapplication/model/RestaurantModel.java"
    click MN "https://github.com/rahul8639/ezyeats/blob/master/app/src/main/java/com/example/ezyeatsapplication/model/Menu.java"
    click HR "https://github.com/rahul8639/ezyeats/blob/master/app/src/main/java/com/example/ezyeatsapplication/model/Hours.java"
    click CI "https://github.com/rahul8639/ezyeats/blob/master/app/src/main/java/com/example/ezyeatsapplication/CartItem.java"
    click NU "https://github.com/rahul8639/ezyeats/blob/master/app/src/main/java/com/example/ezyeatsapplication/NetworkUtil.java"
    click RJS "https://github.com/rahul8639/ezyeats/blob/master/app/src/main/res/raw/restaurent.json"
    click GSG "https://github.com/rahul8639/ezyeats/blob/master/app/google-services.json"

    %% Styles
    classDef ui fill:#ADD8E6,stroke:#333,stroke-width:1px
    classDef adapter fill:#90EE90,stroke:#333,stroke-width:1px
    classDef model fill:#98FB98,stroke:#333,stroke-width:1px
    classDef network fill:#FFA500,stroke:#333,stroke-width:1px
    classDef datastore fill:#D3D3D3,stroke:#333,stroke-width:1px
    classDef external fill:#D3D3D3,stroke-dasharray: 5 5,stroke:#333,stroke-width:1px
```
