# vpatel95/mesapp architecture

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

- Interactive diagram: https://gitdiagram.com/vpatel95/mesapp
- Repository: https://github.com/vpatel95/mesapp

## Overview

##### Project Type and Purpose
- Type: Full‐stack web application
- Purpose: Real-time messaging (personal & group chat) with search functionality
- Key technologies: Laravel (PHP MVC framework), MySQL (Eloquent ORM), Vue.js (client), Pusher (real-time broadcasting), Elasticsearch (search engine)

##### Main Components
a. Client Side
– Browser (HTML/CSS/JavaScript)
– Vue.js components (resources/assets/js/components)
– Axios or built-in JS libs to call REST endpoints and subscribe to Pusher channels
b. Web/API Server
– Laravel application (routes, controllers, middleware)
– MVC layers:
- Controllers (ChatController, SearchController, Auth controllers, etc.)
- Models (User, Message, Chat, GroupChat, etc.)
- Views (Blade templates in resources/views)
– Repository pattern for Messages & Users (DatabaseMessageRepository, ElasticsearchMessageRepository)
– Console commands (ReindexMessages, ReindexUsers)
– Event system (MessageSent event → Broadcast via Pusher)
c. Data Stores
– MySQL database (primary message/user storage)
– Elasticsearch cluster (secondary index for search)
– File storage (local disk for downloads in storage/downloads)
d. External/Infrastructure Services
– Pusher (BROADCAST_DRIVER) for WebSocket/real-time push notifications
– NPM/Webpack (assets build pipeline via webpack.mix.js)
– Queue/Jobs (if configured; default Laravel queue)

##### Relationships & Data Flows
- User action in browser → HTTP(s) request to Laravel routes (web.php/api.php)
- ChatController → writes to MySQL via Eloquent or MessageRepository → triggers MessageSent event
- Event → broadcast to Pusher → pushes to all subscribed clients
- Clients listen on Pusher channels → update UI in real time
- Search request → SearchController calls ElasticsearchMessageRepository → returns results
- Console commands (artisan reindex:messages/users) → read from MySQL → write into Elasticsearch
- Static assets (CSS/JS) served from public/ directory

##### Architectural Patterns & Principles
- MVC (separation of concerns: controllers–models–views)
- Repository Pattern (abstract DB vs. Elasticsearch access)
- Event-Driven / Publish-Subscribe (Laravel Events + Pusher)
- Single Page App-ish behavior (Vue components for chat UI)
- Build Pipeline (Webpack + Laravel Mix)

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Frontend Layer
    subgraph "Frontend Layer"
        direction TB
        Browser["Browser\n(HTML/CSS/JS)"]:::frontend
        VueComponents["Vue.js Components\n(resources/assets/js/components)"]:::frontend
        Axios["AJAX / Pusher Subscribe"]:::frontend
    end

    Browser -->|"uses"| VueComponents
    Browser -->|"HTTP Requests / Pusher events"| Axios

    click VueComponents "https://github.com/vpatel95/mesapp/tree/master/resources/assets/js/components"

    %% Build Pipeline
    subgraph "Build Pipeline"
        direction TB
        NPM["npm / package.json"]:::build
        Webpack["webpack.mix.js"]:::build
        Assets["public/js & public/css"]:::build
    end

    NPM --> Webpack --> Assets --> Browser

    click NPM "https://github.com/vpatel95/mesapp/blob/master/package.json"
    click Webpack "https://github.com/vpatel95/mesapp/blob/master/webpack.mix.js"

    %% Backend Layer
    subgraph "Backend Layer"
        direction TB
        Kernel["HTTP Kernel\n(app/Http/Kernel.php)"]:::backend
        Middleware["Middleware\n(app/Http/Middleware)"]:::backend
        Routes["Routes\n(routes/web.php, api.php, channels.php, console.php)"]:::backend
        Controllers["Controllers"]:::backend
        Models["Models"]:::backend
        Repositories["Repositories\n(Message & User)"]:::backend
        Events["Events & Providers"]:::backend
        ConsoleCmds["Console Commands\n(Reindexing)"]:::backend
    end

    Axios -->|"HTTP"| Kernel
    Kernel --> Middleware --> Routes --> Controllers

    Controllers --> Repositories
    Controllers --> Events

    ConsoleCmds --> Repositories

    click Kernel "https://github.com/vpatel95/mesapp/blob/master/app/Http/Kernel.php"
    click Middleware "https://github.com/vpatel95/mesapp/blob/master/app/Http/Middleware/EncryptCookies.php"
    click Middleware "https://github.com/vpatel95/mesapp/blob/master/app/Http/Middleware/VerifyCsrfToken.php"
    click Middleware "https://github.com/vpatel95/mesapp/blob/master/app/Http/Middleware/RedirectIfAuthenticated.php"
    click Middleware "https://github.com/vpatel95/mesapp/blob/master/app/Http/Middleware/TrimStrings.php"
    click Middleware "https://github.com/vpatel95/mesapp/blob/master/app/Http/Middleware/TrustProxies.php"
    click Routes "https://github.com/vpatel95/mesapp/blob/master/routes/web.php"
    click Routes "https://github.com/vpatel95/mesapp/blob/master/routes/api.php"
    click Routes "https://github.com/vpatel95/mesapp/blob/master/routes/channels.php"
    click Routes "https://github.com/vpatel95/mesapp/blob/master/routes/console.php"

    %% Controllers detail
    subgraph "Controllers"
        direction TB
        AuthCtrl["Auth Controllers\n(Login, Register, Password)"]:::backend
        ChatCtrl["ChatController"]:::backend
        SearchCtrl["SearchController"]:::backend
        DownloadCtrl["DownloadController"]:::backend
        HomeCtrl["HomeController"]:::backend
    end

    Controllers --> AuthCtrl
    Controllers --> ChatCtrl
    Controllers --> SearchCtrl
    Controllers --> DownloadCtrl
    Controllers --> HomeCtrl

    click AuthCtrl "https://github.com/vpatel95/mesapp/blob/master/app/Http/Controllers/Auth/LoginController.php"
    click AuthCtrl "https://github.com/vpatel95/mesapp/blob/master/app/Http/Controllers/Auth/RegisterController.php"
    click AuthCtrl "https://github.com/vpatel95/mesapp/blob/master/app/Http/Controllers/Auth/ForgotPasswordController.php"
    click AuthCtrl "https://github.com/vpatel95/mesapp/blob/master/app/Http/Controllers/Auth/ResetPasswordController.php"
    click ChatCtrl "https://github.com/vpatel95/mesapp/blob/master/app/Http/Controllers/ChatController.php"
    click SearchCtrl "https://github.com/vpatel95/mesapp/blob/master/app/Http/Controllers/SearchController.php"
    click DownloadCtrl "https://github.com/vpatel95/mesapp/blob/master/app/Http/Controllers/DownloadController.php"
    click HomeCtrl "https://github.com/vpatel95/mesapp/blob/master/app/Http/Controllers/HomeController.php"

    %% Models and Repositories detail
    subgraph "Models & Repositories"
        direction TB
        UserModel["User\n(app/User.php)"]:::backend
        MessageModel["Message\n(app/Message.php)"]:::backend
        ChatModel["Chat, GroupChat, PersonalChat, GroupMember\n(app/Chat*.php)"]:::backend
        MessageRepo["MessageRepo\n(Database & Elasticsearch)"]:::backend
        UserRepo["UserRepo\n(Database & Elasticsearch)"]:::backend
    end

    Models --> UserModel
    Models --> MessageModel
    Models --> ChatModel
    Repositories --> MessageRepo
    Repositories --> UserRepo

    click UserModel "https://github.com/vpatel95/mesapp/blob/master/app/User.php"
    click MessageModel "https://github.com/vpatel95/mesapp/blob/master/app/Message.php"
    click ChatModel "https://github.com/vpatel95/mesapp/blob/master/app/Chat.php"
    click ChatModel "https://github.com/vpatel95/mesapp/blob/master/app/GroupChat.php"
    click ChatModel "https://github.com/vpatel95/mesapp/blob/master/app/PersonalChat.php"
    click ChatModel "https://github.com/vpatel95/mesapp/blob/master/app/GroupMember.php"
    click MessageRepo "https://github.com/vpatel95/mesapp/blob/master/app/Message/DatabaseMessageRepository.php"
    click MessageRepo "https://github.com/vpatel95/mesapp/blob/master/app/Message/ElasticsearchMessageRepository.php"
    click MessageRepo "https://github.com/vpatel95/mesapp/blob/master/app/Message/MessageRepository.php"
    click UserRepo "https://github.com/vpatel95/mesapp/blob/master/app/Users/DatabaseUserRepository.php"
    click UserRepo "https://github.com/vpatel95/mesapp/blob/master/app/Users/ElasticsearchUserRepository.php"
    click UserRepo "https://github.com/vpatel95/mesapp/blob/master/app/Users/UserRepository.php"

    Events --> EventSent["MessageSent Event\n(app/Events/MessageSent.php)"]:::backend
    Events --> Providers["Broadcast & EventServiceProviders"]:::backend

    click EventSent "https://github.com/vpatel95/mesapp/blob/master/app/Events/MessageSent.php"
    click Providers "https://github.com/vpatel95/mesapp/blob/master/app/Providers/BroadcastServiceProvider.php"
    click Providers "https://github.com/vpatel95/mesapp/blob/master/app/Providers/EventServiceProvider.php"
    click Providers "https://github.com/vpatel95/mesapp/blob/master/app/Providers/AppServiceProvider.php"

    click ConsoleCmds "https://github.com/vpatel95/mesapp/blob/master/app/Console/Commands/ReindexMessages.php"
    click ConsoleCmds "https://github.com/vpatel95/mesapp/blob/master/app/Console/Commands/ReindexUsers.php"
    click ConsoleCmds "https://github.com/vpatel95/mesapp/blob/master/app/Console/Kernel.php"

    %% Search Traits
    ElasticsearchTrait["Elasticsearch Observer & Searchable Trait\n(app/Search)"]:::backend
    Repositories --> ElasticsearchTrait
    click ElasticsearchTrait "https://github.com/vpatel95/mesapp/blob/master/app/Search/ElasticsearchObserver.php"
    click ElasticsearchTrait "https://github.com/vpatel95/mesapp/blob/master/app/Search/Searchable.php"

    %% Data & External Services
    subgraph "Data & Services"
        direction TB
        MySQL["MySQL\n(Relational DB)"]:::data
        ES["Elasticsearch\n(Search Engine)"]:::data
        FileStorage["File Storage\n(storage/downloads)"]:::data
        Pusher["Pusher\n(Real-time)"]:::external
        Env[".env / config"]:::external
    end

    Repositories --> MySQL
    Repositories --> ES
    Controllers --> FileStorage
    Events --> Pusher
    Kernel --> Env
    Routes --> Env

    ConsoleCmds --> MySQL --> ES

    click MySQL "https://github.com/vpatel95/mesapp/blob/master/config/database.php"
    click FileStorage "https://github.com/vpatel95/mesapp/tree/master/storage/downloads"
    click Pusher "https://github.com/vpatel95/mesapp/blob/master/config/broadcasting.php"
    click Env "https://github.com/vpatel95/mesapp/blob/master/.env.example"

    %% Search Flow
    SearchCtrl -->|"query"| ES -->|"results"| SearchCtrl

    %% Real-time Flow
    ChatCtrl --> MySQL --> EventSent -->|"broadcast"| Pusher --> Browser

    %% Styles
    classDef frontend fill:#ccf,stroke:#339,stroke-width:1px
    classDef backend fill:#cceeff,stroke:#339,stroke-width:1px
    classDef data fill:#ffe0b3,stroke:#994d00,stroke-width:1px
    classDef external fill:#e0ccff,stroke:#660099,stroke-width:1px
    classDef build fill:#eeeeee,stroke:#666666,stroke-width:1px
```
