# ihtasham42/social-media-app architecture

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

- Interactive diagram: https://gitdiagram.com/ihtasham42/social-media-app
- Repository: https://github.com/ihtasham42/social-media-app

## Overview

##### Project Type and Purpose
- PostIt is a full-stack social media web application built on the MERN stack (MongoDB, Express, React, Node.js) with real-time messaging via Socket.io.
- It provides CRUD operations on posts and comments, user authentication with JWT, live private messaging, infinite scrolling, search, and nested comments.

##### File Structure for Architectural Components
- Top-level:
- client/ — React single-page application (frontend)
- controllers/, models/, routes/, middleware/ — Express MVC layers (backend)
- server.js & socketServer.js — HTTP and WebSocket entrypoints
- util/ — shared utilities (filtering, pagination)
- client/src/api/ — wrappers for REST endpoints
- client/src/components/ — UI components and view containers
- client/src/helpers/ — client-side auth and socket initialization
- models/ — Mongoose schemas (User, Post, Comment, Message, etc.)
- controllers/ — business logic for each resource
- routes/ — Express routers mapping HTTP methods to controllers
- middleware/auth.js — JWT authentication guard

##### Extract Insights from the README
- Confirms RESTful API design plus Socket.io for real-time messaging.
- Emphasizes key features: Posts, Comments, Likes, Profiles, Real-time Chat, Infinite scroll, Profanity filtering, JWT security.

##### Main System Components
a. Frontend (React SPA)
- UI views, state management, API clients, WebSocket client
- Serves static assets and communicates with backend over HTTP and WS
b. Backend HTTP API (Express)
- Routes → Controllers → Models → MongoDB
- JWT authentication middleware, profanity filtering, pagination
c. Real-time Messaging Server (Socket.io)
- socketServer.js manages WebSocket connections, authentication, message events
- Integrates with MongoDB to persist Conversations & Messages
d. Database (MongoDB Atlas)
- Collections: users, posts, comments, likes, messages, conversations, follows
- Accessed via Mongoose ODM
e. External Services
- MongoDB Atlas cluster
- Optional: hosting platform (Heroku)

##### Relationships and Data Flows
- User → logs in via React → sends credentials to Express → JWT returned
- React → API calls (GET/POST/PUT/DELETE) → Express routes → Controller → Mongoose queries → MongoDB
- React → connects to Socket.io → authenticated via JWT → real-time message exchange → persistence
- UI reacts to API & socket events to update views

##### Architectural Patterns
- MVC on the server side (Routes-Controllers-Models)
- Layered architecture: Presentation (React), Application (API & WebSocket), Data (MongoDB)
- RESTful endpoints for resource operations
- Event-driven real-time messaging for chat via WebSocket
- Shared utility modules for filtering and pagination

## Diagram (Mermaid)

```mermaid
graph TD
    %% Frontend Layer
    subgraph "Frontend (React SPA)"
        FEEntry["Index"]:::frontend
        FEApp["App Component"]:::frontend
        Views["UI Views"]:::frontend
        UIComp["UI Components"]:::frontend
        APIposts["API Client: posts.js"]:::frontend
        APIusers["API Client: users.js"]:::frontend
        APImessages["API Client: messages.js"]:::frontend
        AuthHelper["Auth Helper"]:::frontend
        SocketHelper["Socket Helper"]:::frontend
    end

    %% Backend HTTP API Layer
    subgraph "Express API Server"
        HTTPEntry["Server Entry"]:::backend
        AuthMid["JWT Auth Middleware"]:::backend
        subgraph "Routes"
            routesPosts["routes/posts.js"]:::backend
            routesUsers["routes/users.js"]:::backend
            routesComments["routes/comments.js"]:::backend
            routesMessages["routes/messages.js"]:::backend
        end
        subgraph "Controllers"
            ctrlPost["postControllers.js"]:::backend
            ctrlUser["userControllers.js"]:::backend
            ctrlComment["commentControllers.js"]:::backend
            ctrlMessage["messageController.js"]:::backend
        end
        subgraph "Models"
            modelPost["Post.js"]:::backend
            modelUser["User.js"]:::backend
            modelComment["Comment.js"]:::backend
            modelMessage["Message.js"]:::backend
            modelConversation["Conversation.js"]:::backend
            modelFollow["Follow.js"]:::backend
            modelLike["PostLike.js"]:::backend
        end
        subgraph "Utilities"
            utilFilter["filter.js"]:::backend
            utilPaginate["paginate.js"]:::backend
        end
    end

    %% Socket.io Layer
    subgraph "Socket.io Server"
        SocketEntry["Socket Entry"]:::backend
    end

    %% Database Layer
    Mongo["MongoDB Atlas"]:::database

    %% External Services
    Cloud["Hosting/Infra"]:::external

    %% Connections Frontend to Backend HTTP
    FEApp -->|"HTTP/REST"| HTTPEntry
    HTTPEntry --> AuthMid
    AuthMid --> routesPosts
    AuthMid --> routesUsers
    AuthMid --> routesComments
    AuthMid --> routesMessages
    routesPosts --> ctrlPost
    routesUsers --> ctrlUser
    routesComments --> ctrlComment
    routesMessages --> ctrlMessage
    ctrlPost --> modelPost
    ctrlUser --> modelUser
    ctrlComment --> modelComment
    ctrlMessage --> modelMessage
    modelPost --> Mongo
    modelUser --> Mongo
    modelComment --> Mongo
    modelMessage --> Mongo
    modelConversation --> Mongo
    modelFollow --> Mongo
    modelLike --> Mongo
    utilFilter --> ctrlPost
    utilFilter --> ctrlComment
    utilPaginate --> ctrlPost
    utilPaginate --> ctrlComment

    %% Connections Frontend Internal
    FEEntry --> FEApp
    FEApp --> Views
    FEApp --> UIComp
    FEApp --> APIposts
    FEApp --> APIusers
    FEApp --> APImessages
    FEApp --> AuthHelper
    FEApp --> SocketHelper

    %% Connections Frontend to Socket.io
    FEApp -->|"WebSocket"| SocketEntry
    SocketEntry --> Mongo

    %% External
    Cloud --> Mongo

    %% Click Events Frontend
    click FEEntry "https://github.com/ihtasham42/social-media-app/blob/master/client/src/index.js"
    click FEApp "https://github.com/ihtasham42/social-media-app/blob/master/client/src/App.js"
    click Views "https://github.com/ihtasham42/social-media-app/tree/master/client/src/components/views/"
    click UIComp "https://github.com/ihtasham42/social-media-app/tree/master/client/src/components/"
    click APIposts "https://github.com/ihtasham42/social-media-app/blob/master/client/src/api/posts.js"
    click APIusers "https://github.com/ihtasham42/social-media-app/blob/master/client/src/api/users.js"
    click APImessages "https://github.com/ihtasham42/social-media-app/blob/master/client/src/api/messages.js"
    click AuthHelper "https://github.com/ihtasham42/social-media-app/blob/master/client/src/helpers/authHelper.js"
    click SocketHelper "https://github.com/ihtasham42/social-media-app/blob/master/client/src/helpers/socketHelper.js"

    %% Click Events Backend
    click HTTPEntry "https://github.com/ihtasham42/social-media-app/blob/master/server.js"
    click SocketEntry "https://github.com/ihtasham42/social-media-app/blob/master/socketServer.js"
    click routesPosts "https://github.com/ihtasham42/social-media-app/blob/master/routes/posts.js"
    click routesUsers "https://github.com/ihtasham42/social-media-app/blob/master/routes/users.js"
    click routesComments "https://github.com/ihtasham42/social-media-app/blob/master/routes/comments.js"
    click routesMessages "https://github.com/ihtasham42/social-media-app/blob/master/routes/messages.js"
    click ctrlPost "https://github.com/ihtasham42/social-media-app/blob/master/controllers/postControllers.js"
    click ctrlUser "https://github.com/ihtasham42/social-media-app/blob/master/controllers/userControllers.js"
    click ctrlComment "https://github.com/ihtasham42/social-media-app/blob/master/controllers/commentControllers.js"
    click ctrlMessage "https://github.com/ihtasham42/social-media-app/blob/master/controllers/messageController.js"
    click modelPost "https://github.com/ihtasham42/social-media-app/blob/master/models/Post.js"
    click modelUser "https://github.com/ihtasham42/social-media-app/blob/master/models/User.js"
    click modelComment "https://github.com/ihtasham42/social-media-app/blob/master/models/Comment.js"
    click modelMessage "https://github.com/ihtasham42/social-media-app/blob/master/models/Message.js"
    click modelConversation "https://github.com/ihtasham42/social-media-app/blob/master/models/Conversation.js"
    click modelFollow "https://github.com/ihtasham42/social-media-app/blob/master/models/Follow.js"
    click modelLike "https://github.com/ihtasham42/social-media-app/blob/master/models/PostLike.js"
    click AuthMid "https://github.com/ihtasham42/social-media-app/blob/master/middleware/auth.js"
    click utilFilter "https://github.com/ihtasham42/social-media-app/blob/master/util/filter.js"
    click utilPaginate "https://github.com/ihtasham42/social-media-app/blob/master/util/paginate.js"

    %% Styles
    classDef frontend fill:#D6EAF8,stroke:#2980B9,stroke-width:2px
    classDef backend fill:#D5F5E3,stroke:#27AE60,stroke-width:2px
    classDef database fill:#FCF3CF,stroke:#F1C40F,stroke-width:2px
    classDef external fill:#E5E8E8,stroke:#95A5A6,stroke-width:2px
```
