# koppuladurgaprasad/messagex architecture

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

- Interactive diagram: https://gitdiagram.com/koppuladurgaprasad/messagex
- Repository: https://github.com/koppuladurgaprasad/messagex

## Overview

MessageX is a full-stack real-time messaging product. Users enter through the React client, authenticate by phone OTP, then manage chats, send messages and media, update statuses and profiles, and make one-to-one calls. The backend exposes REST and STOMP/WebSocket endpoints, applies service-layer behavior, and persists domain records through repositories. The README documents major capabilities and integrations; sampled code confirms selected chat, message, WebSocket, and call paths, but many backend implementations were not sampled, so those links rely on the README.

Main entry points: [`messageX_frontend/src/api`](https://github.com/koppuladurgaprasad/messagex/tree/main/messageX_frontend/src/api) (Client APIs), [`messageX_Backend/src/main/java/com/messageX/Repository`](https://github.com/koppuladurgaprasad/messagex/tree/main/messageX_Backend/src/main/java/com/messageX/Repository) (JPA repositories), [`messageX_frontend/src/App.jsx`](https://github.com/koppuladurgaprasad/messagex/blob/main/messageX_frontend/src/App.jsx) (Application routes), [`messageX_frontend/src/Pages/Chat/Chat.jsx`](https://github.com/koppuladurgaprasad/messagex/blob/main/messageX_frontend/src/Pages/Chat/Chat.jsx) (Chat workspace)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["React client"]
  node_spa["Application routes<br/>[App.jsx]"]
  node_chatui["Chat workspace<br/>[Chat.jsx]"]
  node_chatwindow["Chat window<br/>[ChatWindow.jsx]"]
  node_frontendapi["Client APIs"]
end

subgraph group_identity["Identity and profile"]
  node_authui["OTP login<br/>[LoginModal.jsx]"]
  node_authbackend["Authentication service"]
  node_profile["Profile and users<br/>[Profile.jsx]"]
  node_userbackend["User service"]
end

subgraph group_conversation["Chats and messaging"]
  node_chatbackend["Chat management"]
  node_messagebackend["Message API"]
  node_wsbackend["Realtime messaging"]
  node_chatservice["Chat service<br/>[ChatService.java]"]
  node_messageservice["Message service"]
end

subgraph group_engagement["Status and calls"]
  node_statusui["Status updates<br/>[Status.jsx]"]
  node_statusbackend["Status service<br/>[StatusService.java]"]
  node_callmanager["Call coordination<br/>[callManager.js]"]
  node_webrtc["WebRTC media<br/>[webRTC.js]"]
  node_callbackend["Call management"]
end

subgraph group_platform["Backend and persistence"]
  node_repositories["JPA repositories"]
  node_domain["Domain records"]
end

node_user(("User"))
node_twilio["Twilio SMS"]
node_cloudinary["Cloudinary media"]
node_postgres[("PostgreSQL")]

node_user -->|"uses"| node_spa
node_spa -.->|"routes to"| node_authui
node_spa -->|"routes to"| node_chatui
node_spa -->|"routes to"| node_statusui
node_authui -.->|"authenticates through"| node_authbackend
node_authbackend -.->|"sends OTP"| node_twilio
node_profile -.->|"uses"| node_frontendapi
node_frontendapi -.->|"calls REST APIs"| node_userbackend
node_chatui -->|"loads chats and messages"| node_frontendapi
node_chatui -->|"renders"| node_chatwindow
node_chatui -->|"coordinates calls"| node_callmanager
node_frontendapi -.->|"calls REST APIs"| node_chatbackend
node_frontendapi -.->|"calls REST APIs"| node_messagebackend
node_chatbackend -->|"delegates to"| node_chatservice
node_messagebackend -->|"delegates to"| node_messageservice
node_messagebackend -->|"uploads media"| node_cloudinary
node_chatwindow -.->|"exchanges messages"| node_wsbackend
node_wsbackend -->|"sends and edits"| node_messageservice
node_wsbackend -->|"leaves group"| node_chatservice
node_statusui -.->|"manages statuses"| node_statusbackend
node_callmanager -->|"manages peer media"| node_webrtc
node_callmanager -->|"calls lifecycle APIs"| node_frontendapi
node_callmanager -.->|"signals over STOMP"| node_wsbackend
node_callbackend -.->|"signals peer calls"| node_webrtc
node_chatservice -.->|"persists chat data"| node_repositories
node_messageservice -.->|"persists messages"| node_repositories
node_statusbackend -.->|"persists statuses"| node_repositories
node_userbackend -.->|"persists user data"| node_repositories
node_repositories -.->|"maps entities"| node_domain
node_repositories -.->|"reads and writes"| node_postgres

click node_spa "https://github.com/koppuladurgaprasad/messagex/blob/main/messageX_frontend/src/App.jsx"
click node_chatui "https://github.com/koppuladurgaprasad/messagex/blob/main/messageX_frontend/src/Pages/Chat/Chat.jsx"
click node_chatwindow "https://github.com/koppuladurgaprasad/messagex/blob/main/messageX_frontend/src/components/ChatWindow/ChatWindow.jsx"
click node_frontendapi "https://github.com/koppuladurgaprasad/messagex/tree/main/messageX_frontend/src/api"
click node_authui "https://github.com/koppuladurgaprasad/messagex/blob/main/messageX_frontend/src/Pages/Auth/LoginModal.jsx"
click node_authbackend "https://github.com/koppuladurgaprasad/messagex/tree/main/messageX_Backend/src/main/java/com/messageX/Service"
click node_profile "https://github.com/koppuladurgaprasad/messagex/blob/main/messageX_frontend/src/Pages/Profile/Profile.jsx"
click node_userbackend "https://github.com/koppuladurgaprasad/messagex/tree/main/messageX_Backend/src/main/java/com/messageX/Service"
click node_chatbackend "https://github.com/koppuladurgaprasad/messagex/blob/main/messageX_Backend/src/main/java/com/messageX/Controller/ChatController.java"
click node_messagebackend "https://github.com/koppuladurgaprasad/messagex/blob/main/messageX_Backend/src/main/java/com/messageX/Controller/MessageController.java"
click node_wsbackend "https://github.com/koppuladurgaprasad/messagex/blob/main/messageX_Backend/src/main/java/com/messageX/Controller/ChatWebSocketController.java"
click node_chatservice "https://github.com/koppuladurgaprasad/messagex/blob/main/messageX_Backend/src/main/java/com/messageX/Service/ChatService.java"
click node_messageservice "https://github.com/koppuladurgaprasad/messagex/blob/main/messageX_Backend/src/main/java/com/messageX/Service/MessageService.java"
click node_statusui "https://github.com/koppuladurgaprasad/messagex/blob/main/messageX_frontend/src/Pages/Status/Status.jsx"
click node_statusbackend "https://github.com/koppuladurgaprasad/messagex/blob/main/messageX_Backend/src/main/java/com/messageX/Service/StatusService.java"
click node_callmanager "https://github.com/koppuladurgaprasad/messagex/blob/main/messageX_frontend/src/api/callManager.js"
click node_webrtc "https://github.com/koppuladurgaprasad/messagex/blob/main/messageX_frontend/src/api/webRTC.js"
click node_callbackend "https://github.com/koppuladurgaprasad/messagex/blob/main/messageX_Backend/src/main/java/com/messageX/Controller/CallController.java"
click node_repositories "https://github.com/koppuladurgaprasad/messagex/tree/main/messageX_Backend/src/main/java/com/messageX/Repository"
click node_domain "https://github.com/koppuladurgaprasad/messagex/tree/main/messageX_Backend/src/main/java/com/messageX/Entity"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_spa,node_chatui,node_chatwindow,node_frontendapi,node_user toneBlue
class node_authui,node_authbackend,node_profile,node_userbackend,node_postgres toneAmber
class node_chatbackend,node_messagebackend,node_wsbackend,node_chatservice,node_messageservice toneMint
class node_statusui,node_statusbackend,node_callmanager,node_webrtc,node_callbackend toneRose
class node_repositories,node_domain,node_twilio,node_cloudinary toneIndigo
```

## Components

### React client

- [Application routes](https://github.com/koppuladurgaprasad/messagex/blob/main/messageX_frontend/src/App.jsx): `messageX_frontend/src/App.jsx`
- [Chat workspace](https://github.com/koppuladurgaprasad/messagex/blob/main/messageX_frontend/src/Pages/Chat/Chat.jsx): `messageX_frontend/src/Pages/Chat/Chat.jsx`
- [Chat window](https://github.com/koppuladurgaprasad/messagex/blob/main/messageX_frontend/src/components/ChatWindow/ChatWindow.jsx): `messageX_frontend/src/components/ChatWindow/ChatWindow.jsx`
- [Client APIs](https://github.com/koppuladurgaprasad/messagex/tree/main/messageX_frontend/src/api): `messageX_frontend/src/api`

### Identity and profile

- [OTP login](https://github.com/koppuladurgaprasad/messagex/blob/main/messageX_frontend/src/Pages/Auth/LoginModal.jsx): `messageX_frontend/src/Pages/Auth/LoginModal.jsx`
- [Authentication service](https://github.com/koppuladurgaprasad/messagex/tree/main/messageX_Backend/src/main/java/com/messageX/Service): `messageX_Backend/src/main/java/com/messageX/Service`
- [Profile and users](https://github.com/koppuladurgaprasad/messagex/blob/main/messageX_frontend/src/Pages/Profile/Profile.jsx): `messageX_frontend/src/Pages/Profile/Profile.jsx`
- [User service](https://github.com/koppuladurgaprasad/messagex/tree/main/messageX_Backend/src/main/java/com/messageX/Service): `messageX_Backend/src/main/java/com/messageX/Service`

### Chats and messaging

- [Chat management](https://github.com/koppuladurgaprasad/messagex/blob/main/messageX_Backend/src/main/java/com/messageX/Controller/ChatController.java): `messageX_Backend/src/main/java/com/messageX/Controller/ChatController.java`
- [Message API](https://github.com/koppuladurgaprasad/messagex/blob/main/messageX_Backend/src/main/java/com/messageX/Controller/MessageController.java): `messageX_Backend/src/main/java/com/messageX/Controller/MessageController.java`
- [Realtime messaging](https://github.com/koppuladurgaprasad/messagex/blob/main/messageX_Backend/src/main/java/com/messageX/Controller/ChatWebSocketController.java): `messageX_Backend/src/main/java/com/messageX/Controller/ChatWebSocketController.java`
- [Chat service](https://github.com/koppuladurgaprasad/messagex/blob/main/messageX_Backend/src/main/java/com/messageX/Service/ChatService.java): `messageX_Backend/src/main/java/com/messageX/Service/ChatService.java`
- [Message service](https://github.com/koppuladurgaprasad/messagex/blob/main/messageX_Backend/src/main/java/com/messageX/Service/MessageService.java): `messageX_Backend/src/main/java/com/messageX/Service/MessageService.java`

### Status and calls

- [Status updates](https://github.com/koppuladurgaprasad/messagex/blob/main/messageX_frontend/src/Pages/Status/Status.jsx): `messageX_frontend/src/Pages/Status/Status.jsx`
- [Status service](https://github.com/koppuladurgaprasad/messagex/blob/main/messageX_Backend/src/main/java/com/messageX/Service/StatusService.java): `messageX_Backend/src/main/java/com/messageX/Service/StatusService.java`
- [Call coordination](https://github.com/koppuladurgaprasad/messagex/blob/main/messageX_frontend/src/api/callManager.js): `messageX_frontend/src/api/callManager.js`
- [WebRTC media](https://github.com/koppuladurgaprasad/messagex/blob/main/messageX_frontend/src/api/webRTC.js): `messageX_frontend/src/api/webRTC.js`
- [Call management](https://github.com/koppuladurgaprasad/messagex/blob/main/messageX_Backend/src/main/java/com/messageX/Controller/CallController.java): `messageX_Backend/src/main/java/com/messageX/Controller/CallController.java`

### Backend and persistence

- [JPA repositories](https://github.com/koppuladurgaprasad/messagex/tree/main/messageX_Backend/src/main/java/com/messageX/Repository): `messageX_Backend/src/main/java/com/messageX/Repository`
- [Domain records](https://github.com/koppuladurgaprasad/messagex/tree/main/messageX_Backend/src/main/java/com/messageX/Entity): `messageX_Backend/src/main/java/com/messageX/Entity`

### Other components

- **User**
- **Twilio SMS**
- **Cloudinary media**
- **PostgreSQL**

## Connections

- User → Application routes: uses (evidence: `README.md`)
- Application routes → OTP login: routes to
- Application routes → Chat workspace: routes to (evidence: `messageX_frontend/src/App.jsx`)
- Application routes → Status updates: routes to (evidence: `messageX_frontend/src/App.jsx`)
- OTP login → Authentication service: authenticates through (evidence: `README.md`)
- Authentication service → Twilio SMS: sends OTP (evidence: `README.md`)
- Profile and users → Client APIs: uses
- Client APIs → User service: calls REST APIs (evidence: `README.md`)
- Chat workspace → Client APIs: loads chats and messages (evidence: `messageX_frontend/src/Pages/Chat/Chat.jsx`)
- Chat workspace → Chat window: renders (evidence: `messageX_frontend/src/Pages/Chat/Chat.jsx`)
- Chat workspace → Call coordination: coordinates calls (evidence: `messageX_frontend/src/Pages/Chat/Chat.jsx`)
- Client APIs → Chat management: calls REST APIs (evidence: `README.md`)
- Client APIs → Message API: calls REST APIs (evidence: `README.md`)
- Chat management → Chat service: delegates to (evidence: `messageX_Backend/src/main/java/com/messageX/Controller/ChatController.java`)
- Message API → Message service: delegates to (evidence: `messageX_Backend/src/main/java/com/messageX/Controller/MessageController.java`)
- Message API → Cloudinary media: uploads media (evidence: `messageX_Backend/src/main/java/com/messageX/Controller/MessageController.java`)
- Chat window → Realtime messaging: exchanges messages (evidence: `README.md`)
- Realtime messaging → Message service: sends and edits (evidence: `messageX_Backend/src/main/java/com/messageX/Controller/ChatWebSocketController.java`)
- Realtime messaging → Chat service: leaves group (evidence: `messageX_Backend/src/main/java/com/messageX/Controller/ChatWebSocketController.java`)
- Status updates → Status service: manages statuses (evidence: `README.md`)
- Call coordination → WebRTC media: manages peer media (evidence: `messageX_frontend/src/api/callManager.js`)
- Call coordination → Client APIs: calls lifecycle APIs (evidence: `messageX_frontend/src/api/callManager.js`)
- Call coordination → Realtime messaging: signals over STOMP (evidence: `README.md`)
- Call management → WebRTC media: signals peer calls (evidence: `README.md`)
- Chat service → JPA repositories: persists chat data (evidence: `README.md`)
- Message service → JPA repositories: persists messages (evidence: `README.md`)
- Status service → JPA repositories: persists statuses (evidence: `README.md`)
- User service → JPA repositories: persists user data (evidence: `README.md`)
- JPA repositories → Domain records: maps entities (evidence: `README.md`)
- JPA repositories → PostgreSQL: reads and writes (evidence: `README.md`)
