# ashutosh0203/chatappbackend architecture

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

- Interactive diagram: https://gitdiagram.com/ashutosh0203/chatappbackend
- Repository: https://github.com/ashutosh0203/chatappbackend

## Overview

This repository implements a chat application as three services: user/account, real-time chat, and OTP email delivery. The main user workflow requests an email OTP, verifies it to obtain an account token, then uses authenticated chat endpoints to create conversations and send or retrieve messages; Socket.IO distributes live events. Chat can also look up user details through the user service. Source excerpts support the route, controller, queue, and socket relationships; database connection implementations and several configuration modules were not excerpted, so their internal wiring is not inferred.

Main entry points: [`user/src/controllers/user.ts`](https://github.com/ashutosh0203/chatappbackend/blob/main/user/src/controllers/user.ts) (Account workflows), [`chat/src/controllers/chat.ts`](https://github.com/ashutosh0203/chatappbackend/blob/main/chat/src/controllers/chat.ts) (Chat workflows), [`user/src/routes/user.ts`](https://github.com/ashutosh0203/chatappbackend/blob/main/user/src/routes/user.ts) (Account routes), [`chat/src/routes/chat.ts`](https://github.com/ashutosh0203/chatappbackend/blob/main/chat/src/routes/chat.ts) (Chat routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_accounts["Accounts and identity"]
  node_user_routes["Account routes<br/>[user.ts]"]
  node_user_auth["Token authentication<br/>[isAuth.ts]"]
  node_user_controller["Account workflows<br/>[user.ts]"]
  node_user_model["User records<br/>[User.ts]"]
  node_user_token["Token generation<br/>[generateToken.ts]"]
  node_user_service["User lookup API<br/>[user.ts]"]
end

subgraph group_messaging["Chat and realtime"]
  node_chat_routes["Chat routes<br/>[chat.ts]"]
  node_chat_auth["Chat token auth<br/>[isAuth.ts]"]
  node_chat_controller["Chat workflows<br/>[chat.ts]"]
  node_chat_model["Conversation records<br/>[Chat.ts]"]
  node_message_model["Message records<br/>[Messages.ts]"]
  node_image_upload["Image upload<br/>[mutler.ts]"]
  node_socket_server["Realtime socket server<br/>[socket.ts]"]
end

subgraph group_delivery["OTP delivery"]
  node_rabbit_publisher["Queue publisher<br/>[rabbitmq.ts]"]
  node_mail_consumer["OTP mail consumer<br/>[consumer.ts]"]
  node_mail_entry["Mail service entry<br/>[index.ts]"]
end

subgraph group_infrastructure["State and integrations"]
  node_user_db_config["User DB connection<br/>[db.ts]"]
  node_redis[("OTP and rate limits")]
  node_rabbitmq["RabbitMQ"]
  node_smtp["SMTP email"]
  node_cloudinary["Image storage<br/>[cloudinary.ts]"]
  node_chat_db_config["Chat DB connection<br/>[db.ts]"]
  node_mongo[("MongoDB")]
end

node_client(("Chat client"))

node_client -->|"requests accounts"| node_user_routes
node_user_routes -->|"guards routes"| node_user_auth
node_user_routes -->|"dispatches"| node_user_controller
node_user_controller -->|"reads and writes"| node_user_model
node_user_controller -->|"generates tokens"| node_user_token
node_user_controller -->|"stores OTPs"| node_redis
node_user_controller -->|"publishes OTP"| node_rabbit_publisher
node_user_auth -->|"uses user type"| node_user_model
node_user_routes -.->|"returns responses"| node_client
node_user_db_config -.->|"connects"| node_mongo
node_chat_routes -->|"guards routes"| node_chat_auth
node_chat_routes -->|"dispatches"| node_chat_controller
node_chat_routes -->|"processes images"| node_image_upload
node_chat_controller -->|"reads and writes"| node_chat_model
node_chat_controller -->|"reads and writes"| node_message_model
node_chat_controller -->|"emits events"| node_socket_server
node_chat_controller -->|"fetches profiles"| node_user_service
node_image_upload -->|"uploads images"| node_cloudinary
node_chat_db_config -.->|"connects"| node_mongo
node_client -->|"requests chats"| node_chat_routes
node_client -.->|"opens socket"| node_socket_server
node_rabbit_publisher -->|"publishes messages"| node_rabbitmq
node_mail_entry -->|"starts consumer"| node_mail_consumer
node_mail_consumer -->|"consumes messages"| node_rabbitmq
node_mail_consumer -->|"sends email"| node_smtp
node_user_service -.->|"returns profile"| node_client

click node_user_routes "https://github.com/ashutosh0203/chatappbackend/blob/main/user/src/routes/user.ts"
click node_user_auth "https://github.com/ashutosh0203/chatappbackend/blob/main/user/src/middleware/isAuth.ts"
click node_user_controller "https://github.com/ashutosh0203/chatappbackend/blob/main/user/src/controllers/user.ts"
click node_user_model "https://github.com/ashutosh0203/chatappbackend/blob/main/user/src/model/User.ts"
click node_user_db_config "https://github.com/ashutosh0203/chatappbackend/blob/main/user/src/config/db.ts"
click node_user_token "https://github.com/ashutosh0203/chatappbackend/blob/main/user/src/config/generateToken.ts"
click node_rabbit_publisher "https://github.com/ashutosh0203/chatappbackend/blob/main/user/src/config/rabbitmq.ts"
click node_mail_consumer "https://github.com/ashutosh0203/chatappbackend/blob/main/mail/src/consumer.ts"
click node_mail_entry "https://github.com/ashutosh0203/chatappbackend/blob/main/mail/src/index.ts"
click node_chat_routes "https://github.com/ashutosh0203/chatappbackend/blob/main/chat/src/routes/chat.ts"
click node_chat_auth "https://github.com/ashutosh0203/chatappbackend/blob/main/chat/src/middlewares/isAuth.ts"
click node_chat_controller "https://github.com/ashutosh0203/chatappbackend/blob/main/chat/src/controllers/chat.ts"
click node_chat_model "https://github.com/ashutosh0203/chatappbackend/blob/main/chat/src/models/Chat.ts"
click node_message_model "https://github.com/ashutosh0203/chatappbackend/blob/main/chat/src/models/Messages.ts"
click node_image_upload "https://github.com/ashutosh0203/chatappbackend/blob/main/chat/src/middlewares/mutler.ts"
click node_cloudinary "https://github.com/ashutosh0203/chatappbackend/blob/main/chat/src/config/cloudinary.ts"
click node_socket_server "https://github.com/ashutosh0203/chatappbackend/blob/main/chat/src/config/socket.ts"
click node_chat_db_config "https://github.com/ashutosh0203/chatappbackend/blob/main/chat/src/config/db.ts"
click node_user_service "https://github.com/ashutosh0203/chatappbackend/blob/main/user/src/controllers/user.ts"

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_user_routes,node_user_auth,node_user_controller,node_user_model,node_user_token,node_user_service,node_client toneBlue
class node_chat_routes,node_chat_auth,node_chat_controller,node_chat_model,node_message_model,node_image_upload,node_socket_server toneAmber
class node_rabbit_publisher,node_mail_consumer,node_mail_entry toneMint
class node_user_db_config,node_redis,node_rabbitmq,node_smtp,node_cloudinary,node_chat_db_config,node_mongo toneRose
```

## Components

### Accounts and identity

- [Account routes](https://github.com/ashutosh0203/chatappbackend/blob/main/user/src/routes/user.ts): `user/src/routes/user.ts`
- [Token authentication](https://github.com/ashutosh0203/chatappbackend/blob/main/user/src/middleware/isAuth.ts): `user/src/middleware/isAuth.ts`
- [Account workflows](https://github.com/ashutosh0203/chatappbackend/blob/main/user/src/controllers/user.ts): `user/src/controllers/user.ts`
- [User records](https://github.com/ashutosh0203/chatappbackend/blob/main/user/src/model/User.ts): `user/src/model/User.ts`
- [Token generation](https://github.com/ashutosh0203/chatappbackend/blob/main/user/src/config/generateToken.ts): `user/src/config/generateToken.ts`
- [User lookup API](https://github.com/ashutosh0203/chatappbackend/blob/main/user/src/controllers/user.ts): `user/src/controllers/user.ts`

### Chat and realtime

- [Chat routes](https://github.com/ashutosh0203/chatappbackend/blob/main/chat/src/routes/chat.ts): `chat/src/routes/chat.ts`
- [Chat token auth](https://github.com/ashutosh0203/chatappbackend/blob/main/chat/src/middlewares/isAuth.ts): `chat/src/middlewares/isAuth.ts`
- [Chat workflows](https://github.com/ashutosh0203/chatappbackend/blob/main/chat/src/controllers/chat.ts): `chat/src/controllers/chat.ts`
- [Conversation records](https://github.com/ashutosh0203/chatappbackend/blob/main/chat/src/models/Chat.ts): `chat/src/models/Chat.ts`
- [Message records](https://github.com/ashutosh0203/chatappbackend/blob/main/chat/src/models/Messages.ts): `chat/src/models/Messages.ts`
- [Image upload](https://github.com/ashutosh0203/chatappbackend/blob/main/chat/src/middlewares/mutler.ts): `chat/src/middlewares/mutler.ts`
- [Realtime socket server](https://github.com/ashutosh0203/chatappbackend/blob/main/chat/src/config/socket.ts): `chat/src/config/socket.ts`

### OTP delivery

- [Queue publisher](https://github.com/ashutosh0203/chatappbackend/blob/main/user/src/config/rabbitmq.ts): `user/src/config/rabbitmq.ts`
- [OTP mail consumer](https://github.com/ashutosh0203/chatappbackend/blob/main/mail/src/consumer.ts): `mail/src/consumer.ts`
- [Mail service entry](https://github.com/ashutosh0203/chatappbackend/blob/main/mail/src/index.ts): `mail/src/index.ts`

### State and integrations

- [User DB connection](https://github.com/ashutosh0203/chatappbackend/blob/main/user/src/config/db.ts): `user/src/config/db.ts`
- **OTP and rate limits**
- **RabbitMQ**
- **SMTP email**
- [Image storage](https://github.com/ashutosh0203/chatappbackend/blob/main/chat/src/config/cloudinary.ts): `chat/src/config/cloudinary.ts`
- [Chat DB connection](https://github.com/ashutosh0203/chatappbackend/blob/main/chat/src/config/db.ts): `chat/src/config/db.ts`
- **MongoDB**

### Other components

- **Chat client**

## Connections

- Chat client → Account routes: requests accounts
- Account routes → Token authentication: guards routes (evidence: `user/src/routes/user.ts`)
- Account routes → Account workflows: dispatches (evidence: `user/src/routes/user.ts`)
- Account workflows → User records: reads and writes (evidence: `user/src/controllers/user.ts`)
- Account workflows → Token generation: generates tokens (evidence: `user/src/controllers/user.ts`)
- Account workflows → OTP and rate limits: stores OTPs (evidence: `user/src/controllers/user.ts`)
- Account workflows → Queue publisher: publishes OTP (evidence: `user/src/controllers/user.ts`)
- Token authentication → User records: uses user type (evidence: `user/src/middleware/isAuth.ts`)
- Account routes → Chat client: returns responses
- User DB connection → MongoDB: connects
- Chat routes → Chat token auth: guards routes (evidence: `chat/src/routes/chat.ts`)
- Chat routes → Chat workflows: dispatches (evidence: `chat/src/routes/chat.ts`)
- Chat routes → Image upload: processes images (evidence: `chat/src/routes/chat.ts`)
- Chat workflows → Conversation records: reads and writes (evidence: `chat/src/controllers/chat.ts`)
- Chat workflows → Message records: reads and writes (evidence: `chat/src/controllers/chat.ts`)
- Chat workflows → Realtime socket server: emits events (evidence: `chat/src/controllers/chat.ts`)
- Chat workflows → User lookup API: fetches profiles (evidence: `chat/src/controllers/chat.ts`)
- Image upload → Image storage: uploads images (evidence: `chat/src/middlewares/mutler.ts`)
- Chat DB connection → MongoDB: connects
- Chat client → Chat routes: requests chats
- Chat client → Realtime socket server: opens socket
- Queue publisher → RabbitMQ: publishes messages (evidence: `user/src/config/rabbitmq.ts`)
- Mail service entry → OTP mail consumer: starts consumer (evidence: `mail/src/index.ts`)
- OTP mail consumer → RabbitMQ: consumes messages (evidence: `mail/src/consumer.ts`)
- OTP mail consumer → SMTP email: sends email (evidence: `mail/src/consumer.ts`)
- User lookup API → Chat client: returns profile
