# aryanjangra-code/chat-app-backend architecture

> Architecture diagram of the GitHub repository aryanjangra-code/chat-app-backend, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-16). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/aryanjangra-code/chat-app-backend
- Repository: https://github.com/aryanjangra-code/chat-app-backend

## Overview

GroupChat is an Express and Socket.IO backend for accounts, group rooms, direct messages, and real-time chat, backed by MongoDB. The main workflow is account signup or login, authenticated room discovery and membership, then message-history access over HTTP or live messaging over Socket.IO. Room membership checks protect both paths; socket events also cover reactions, edits, deletion, typing, and presence. The README documents the API and persistence choices; sampled source supports the route and socket relationships shown below, while unsampled database details are not expanded.

Main entry points: [`routes/rooms.js`](https://github.com/aryanjangra-code/chat-app-backend/blob/main/routes/rooms.js) (Room routes), [`socket/socketHandler.js`](https://github.com/aryanjangra-code/chat-app-backend/blob/main/socket/socketHandler.js) (Socket event handler), [`server.js`](https://github.com/aryanjangra-code/chat-app-backend/blob/main/server.js) (HTTP and socket server), [`routes/auth.js`](https://github.com/aryanjangra-code/chat-app-backend/blob/main/routes/auth.js) (Account routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_http["HTTP API"]
  node_auth_routes["Account routes<br/>[auth.js]"]
  node_room_routes["Room routes<br/>[rooms.js]"]
end

subgraph group_realtime["Live chat"]
  node_socket_handler["Socket event handler<br/>[socketHandler.js]"]
end

subgraph group_domain["Domain and access"]
  node_auth_middleware["Token authentication<br/>[auth.js]"]
  node_validation["Input validation<br/>[validation.js]"]
  node_room_access["Room membership check<br/>[roomAccess.js]"]
  node_user_model["User records<br/>[User.js]"]
  node_room_model["Room records<br/>[Room.js]"]
  node_message_model["Message records<br/>[Message.js]"]
end

subgraph group_runtime["Runtime and persistence"]
  node_server["HTTP and socket server<br/>[server.js]"]
  node_db_config["Database connection<br/>[db.js]"]
end

node_client(("Chat client"))
node_mongo[("MongoDB")]

node_client -->|"sends API requests"| node_server
node_client -->|"sends chat events"| node_socket_handler
node_server -->|"mounts routes"| node_auth_routes
node_server -->|"mounts routes"| node_room_routes
node_server -->|"initializes sockets"| node_socket_handler
node_server -->|"connects database"| node_db_config
node_auth_routes -->|"reads and writes users"| node_user_model
node_auth_routes -->|"protects profile routes"| node_auth_middleware
node_auth_routes -->|"normalizes usernames"| node_validation
node_room_routes -->|"protects room routes"| node_auth_middleware
node_room_routes -->|"reads and writes rooms"| node_room_model
node_room_routes -->|"reads history"| node_message_model
node_room_routes -->|"looks up DM user"| node_user_model
node_room_routes -->|"checks membership"| node_room_access
node_room_routes -->|"parses pagination"| node_validation
node_socket_handler -->|"verifies socket token"| node_auth_middleware
node_socket_handler -->|"checks membership"| node_room_access
node_socket_handler -->|"updates presence"| node_user_model
node_socket_handler -->|"checks and updates rooms"| node_room_model
node_socket_handler -->|"creates and updates messages"| node_message_model
node_db_config -->|"connects through Mongoose"| node_mongo

click node_server "https://github.com/aryanjangra-code/chat-app-backend/blob/main/server.js"
click node_auth_routes "https://github.com/aryanjangra-code/chat-app-backend/blob/main/routes/auth.js"
click node_room_routes "https://github.com/aryanjangra-code/chat-app-backend/blob/main/routes/rooms.js"
click node_auth_middleware "https://github.com/aryanjangra-code/chat-app-backend/blob/main/middleware/auth.js"
click node_validation "https://github.com/aryanjangra-code/chat-app-backend/blob/main/utils/validation.js"
click node_room_access "https://github.com/aryanjangra-code/chat-app-backend/blob/main/utils/roomAccess.js"
click node_socket_handler "https://github.com/aryanjangra-code/chat-app-backend/blob/main/socket/socketHandler.js"
click node_user_model "https://github.com/aryanjangra-code/chat-app-backend/blob/main/models/User.js"
click node_room_model "https://github.com/aryanjangra-code/chat-app-backend/blob/main/models/Room.js"
click node_message_model "https://github.com/aryanjangra-code/chat-app-backend/blob/main/models/Message.js"
click node_db_config "https://github.com/aryanjangra-code/chat-app-backend/blob/main/config/db.js"

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_auth_routes,node_room_routes,node_client toneBlue
class node_socket_handler,node_mongo toneAmber
class node_auth_middleware,node_validation,node_room_access,node_user_model,node_room_model,node_message_model toneMint
class node_server,node_db_config toneRose
```

## Components

### HTTP API

- [Account routes](https://github.com/aryanjangra-code/chat-app-backend/blob/main/routes/auth.js): `routes/auth.js`
- [Room routes](https://github.com/aryanjangra-code/chat-app-backend/blob/main/routes/rooms.js): `routes/rooms.js`

### Live chat

- [Socket event handler](https://github.com/aryanjangra-code/chat-app-backend/blob/main/socket/socketHandler.js): `socket/socketHandler.js`

### Domain and access

- [Token authentication](https://github.com/aryanjangra-code/chat-app-backend/blob/main/middleware/auth.js): `middleware/auth.js`
- [Input validation](https://github.com/aryanjangra-code/chat-app-backend/blob/main/utils/validation.js): `utils/validation.js`
- [Room membership check](https://github.com/aryanjangra-code/chat-app-backend/blob/main/utils/roomAccess.js): `utils/roomAccess.js`
- [User records](https://github.com/aryanjangra-code/chat-app-backend/blob/main/models/User.js): `models/User.js`
- [Room records](https://github.com/aryanjangra-code/chat-app-backend/blob/main/models/Room.js): `models/Room.js`
- [Message records](https://github.com/aryanjangra-code/chat-app-backend/blob/main/models/Message.js): `models/Message.js`

### Runtime and persistence

- [HTTP and socket server](https://github.com/aryanjangra-code/chat-app-backend/blob/main/server.js): `server.js`
- [Database connection](https://github.com/aryanjangra-code/chat-app-backend/blob/main/config/db.js): `config/db.js`

### Other components

- **Chat client**
- **MongoDB**

## Connections

- Chat client → HTTP and socket server: sends API requests (evidence: `README.md`)
- Chat client → Socket event handler: sends chat events (evidence: `README.md`)
- HTTP and socket server → Account routes: mounts routes (evidence: `server.js`)
- HTTP and socket server → Room routes: mounts routes (evidence: `server.js`)
- HTTP and socket server → Socket event handler: initializes sockets (evidence: `server.js`)
- HTTP and socket server → Database connection: connects database (evidence: `server.js`)
- Account routes → User records: reads and writes users (evidence: `routes/auth.js`)
- Account routes → Token authentication: protects profile routes (evidence: `routes/auth.js`)
- Account routes → Input validation: normalizes usernames (evidence: `routes/auth.js`)
- Room routes → Token authentication: protects room routes (evidence: `routes/rooms.js`)
- Room routes → Room records: reads and writes rooms (evidence: `routes/rooms.js`)
- Room routes → Message records: reads history (evidence: `routes/rooms.js`)
- Room routes → User records: looks up DM user (evidence: `routes/rooms.js`)
- Room routes → Room membership check: checks membership (evidence: `routes/rooms.js`)
- Room routes → Input validation: parses pagination (evidence: `routes/rooms.js`)
- Socket event handler → Token authentication: verifies socket token (evidence: `socket/socketHandler.js`)
- Socket event handler → Room membership check: checks membership (evidence: `socket/socketHandler.js`)
- Socket event handler → User records: updates presence (evidence: `socket/socketHandler.js`)
- Socket event handler → Room records: checks and updates rooms (evidence: `socket/socketHandler.js`)
- Socket event handler → Message records: creates and updates messages (evidence: `socket/socketHandler.js`)
- Database connection → MongoDB: connects through Mongoose (evidence: `README.md`)
