# mayaalla/real-time-chatapp architecture

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

- Interactive diagram: https://gitdiagram.com/mayaalla/real-time-chatapp
- Repository: https://github.com/mayaalla/real-time-chatapp

## Overview

Real-Time-ChatApp is principally a chat backend: authenticated HTTP APIs manage accounts, conversations, messages, and uploads, while Socket.IO handlers support live messaging and presence-related events. The frontend excerpt is the unmodified React/Vite starter rather than a demonstrated chat client. The graph follows documented and indexed wiring; several realtime handlers and route internals were not excerpted, so those relationships are limited to what the index supports.

Main entry points: [`backend/src/realtime/index.ts`](https://github.com/mayaalla/real-time-chatapp/blob/main/backend/src/realtime/index.ts) (Socket.IO Server), [`backend/src/db/prisma.ts`](https://github.com/mayaalla/real-time-chatapp/blob/main/backend/src/db/prisma.ts) (PostgreSQL via Prisma), [`backend/src/app.ts`](https://github.com/mayaalla/real-time-chatapp/blob/main/backend/src/app.ts) (Express App), [`backend/src/modules/auth/auth.routes.ts`](https://github.com/mayaalla/real-time-chatapp/blob/main/backend/src/modules/auth/auth.routes.ts) (Auth Routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["HTTP API"]
  node_app["Express App<br/>[app.ts]"]
  node_auth_routes["Auth Routes<br/>[auth.routes.ts]"]
  node_users_routes["User Routes<br/>[users.routes.ts]"]
  node_convo_routes["Conversation Routes"]
  node_message_routes["Message Routes<br/>[messages.routes.ts]"]
  node_upload_routes["Upload Routes<br/>[uploads.routes.ts]"]
end

subgraph group_identity["Identity and Profiles"]
  node_auth_ctrl["Auth Controller<br/>[auth.controller.ts]"]
  node_auth_service["Auth Service<br/>[auth.service.ts]"]
  node_auth_schema["Auth Schemas<br/>[auth.schemas.ts]"]
  node_users_ctrl["User Controller"]
  node_users_service["User Service<br/>[users.service.ts]"]
end

subgraph group_chat["Conversation and Messaging"]
  node_convo_ctrl["Conversation Controller"]
  node_convo_service["Conversation Service"]
  node_message_ctrl["Message Controller"]
  node_message_service["Message Service"]
  node_upload_ctrl["Upload Controller"]
  node_upload_service["Upload Service<br/>[uploads.service.ts]"]
end

subgraph group_live["Realtime"]
  node_realtime["Socket.IO Server<br/>[index.ts]"]
  node_socket_auth["Socket Auth<br/>[socketAuth.ts]"]
  node_live_message["Live Messages<br/>[message.ts]"]
  node_presence["Presence Handler<br/>[presence.ts]"]
  node_receipts["Receipt Handler<br/>[receipts.ts]"]
  node_typing["Typing Handler<br/>[typing.ts]"]
  node_sync["Sync Handler<br/>[sync.ts]"]
end

subgraph group_infra["Runtime Infrastructure"]
  node_db[("PostgreSQL via Prisma<br/>[prisma.ts]")]
  node_redis[("Redis Client<br/>[client.ts]")]
  node_token["JWT Utilities<br/>[token.ts]"]
  node_env["Environment Config<br/>[env.ts]"]
end

node_client(("API Client"))

node_client -->|"sends requests"| node_app
node_app -->|"mounts"| node_auth_routes
node_app -->|"mounts"| node_users_routes
node_app -->|"mounts"| node_convo_routes
node_app -->|"mounts"| node_message_routes
node_app -->|"mounts"| node_upload_routes
node_auth_routes -->|"routes to"| node_auth_ctrl
node_auth_routes -->|"validates with"| node_auth_schema
node_auth_ctrl -->|"calls"| node_auth_service
node_auth_service -->|"reads and writes"| node_db
node_auth_service -->|"issues tokens"| node_token
node_users_routes -->|"routes to"| node_users_ctrl
node_users_ctrl -->|"calls"| node_users_service
node_users_service -->|"reads and writes"| node_db
node_convo_routes -->|"routes to"| node_convo_ctrl
node_convo_ctrl -->|"calls"| node_convo_service
node_convo_service -->|"reads and writes"| node_db
node_message_routes -->|"routes to"| node_message_ctrl
node_message_ctrl -->|"calls"| node_message_service
node_message_service -->|"reads and writes"| node_db
node_message_service -->|"resolves attachments"| node_upload_service
node_upload_routes -->|"routes to"| node_upload_ctrl
node_upload_ctrl -->|"calls"| node_upload_service
node_upload_service -->|"reads and writes"| node_db
node_realtime -->|"registers"| node_socket_auth
node_realtime -->|"registers"| node_live_message
node_realtime -->|"registers"| node_presence
node_realtime -->|"registers"| node_receipts
node_realtime -->|"registers"| node_typing
node_realtime -->|"registers"| node_sync
node_socket_auth -->|"verifies tokens"| node_token
node_live_message -->|"uses conversation logic"| node_convo_service
node_live_message -->|"reads and writes"| node_db
node_realtime -->|"uses client"| node_redis
node_db -->|"configures connection"| node_env
node_redis -->|"reads settings"| node_env
node_token -->|"reads secrets"| node_env

click node_app "https://github.com/mayaalla/real-time-chatapp/blob/main/backend/src/app.ts"
click node_auth_routes "https://github.com/mayaalla/real-time-chatapp/blob/main/backend/src/modules/auth/auth.routes.ts"
click node_auth_ctrl "https://github.com/mayaalla/real-time-chatapp/blob/main/backend/src/modules/auth/auth.controller.ts"
click node_auth_service "https://github.com/mayaalla/real-time-chatapp/blob/main/backend/src/modules/auth/auth.service.ts"
click node_auth_schema "https://github.com/mayaalla/real-time-chatapp/blob/main/backend/src/modules/auth/auth.schemas.ts"
click node_users_routes "https://github.com/mayaalla/real-time-chatapp/blob/main/backend/src/modules/users/users.routes.ts"
click node_users_ctrl "https://github.com/mayaalla/real-time-chatapp/blob/main/backend/src/modules/users/users.controller.ts"
click node_users_service "https://github.com/mayaalla/real-time-chatapp/blob/main/backend/src/modules/users/users.service.ts"
click node_convo_routes "https://github.com/mayaalla/real-time-chatapp/blob/main/backend/src/modules/conversations/conversations.routes.ts"
click node_convo_ctrl "https://github.com/mayaalla/real-time-chatapp/blob/main/backend/src/modules/conversations/conversations.controller.ts"
click node_convo_service "https://github.com/mayaalla/real-time-chatapp/blob/main/backend/src/modules/conversations/conversations.service.ts"
click node_message_routes "https://github.com/mayaalla/real-time-chatapp/blob/main/backend/src/modules/messages/messages.routes.ts"
click node_message_ctrl "https://github.com/mayaalla/real-time-chatapp/blob/main/backend/src/modules/messages/messages.controller.ts"
click node_message_service "https://github.com/mayaalla/real-time-chatapp/blob/main/backend/src/modules/messages/messages.service.ts"
click node_upload_routes "https://github.com/mayaalla/real-time-chatapp/blob/main/backend/src/modules/uploads/uploads.routes.ts"
click node_upload_ctrl "https://github.com/mayaalla/real-time-chatapp/blob/main/backend/src/modules/uploads/uploads.controller.ts"
click node_upload_service "https://github.com/mayaalla/real-time-chatapp/blob/main/backend/src/modules/uploads/uploads.service.ts"
click node_realtime "https://github.com/mayaalla/real-time-chatapp/blob/main/backend/src/realtime/index.ts"
click node_socket_auth "https://github.com/mayaalla/real-time-chatapp/blob/main/backend/src/realtime/middleware/socketAuth.ts"
click node_live_message "https://github.com/mayaalla/real-time-chatapp/blob/main/backend/src/realtime/handlers/message.ts"
click node_presence "https://github.com/mayaalla/real-time-chatapp/blob/main/backend/src/realtime/handlers/presence.ts"
click node_receipts "https://github.com/mayaalla/real-time-chatapp/blob/main/backend/src/realtime/handlers/receipts.ts"
click node_typing "https://github.com/mayaalla/real-time-chatapp/blob/main/backend/src/realtime/handlers/typing.ts"
click node_sync "https://github.com/mayaalla/real-time-chatapp/blob/main/backend/src/realtime/handlers/sync.ts"
click node_db "https://github.com/mayaalla/real-time-chatapp/blob/main/backend/src/db/prisma.ts"
click node_redis "https://github.com/mayaalla/real-time-chatapp/blob/main/backend/src/redis/client.ts"
click node_token "https://github.com/mayaalla/real-time-chatapp/blob/main/backend/src/utils/token.ts"
click node_env "https://github.com/mayaalla/real-time-chatapp/blob/main/backend/src/config/env.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_app,node_auth_routes,node_users_routes,node_convo_routes,node_message_routes,node_upload_routes,node_client toneBlue
class node_auth_ctrl,node_auth_service,node_auth_schema,node_users_ctrl,node_users_service toneAmber
class node_convo_ctrl,node_convo_service,node_message_ctrl,node_message_service,node_upload_ctrl,node_upload_service toneMint
class node_realtime,node_socket_auth,node_live_message,node_presence,node_receipts,node_typing,node_sync toneRose
class node_db,node_redis,node_token,node_env toneIndigo
```

## Components

### HTTP API

- [Express App](https://github.com/mayaalla/real-time-chatapp/blob/main/backend/src/app.ts): `backend/src/app.ts`
- [Auth Routes](https://github.com/mayaalla/real-time-chatapp/blob/main/backend/src/modules/auth/auth.routes.ts): `backend/src/modules/auth/auth.routes.ts`
- [User Routes](https://github.com/mayaalla/real-time-chatapp/blob/main/backend/src/modules/users/users.routes.ts): `backend/src/modules/users/users.routes.ts`
- [Conversation Routes](https://github.com/mayaalla/real-time-chatapp/blob/main/backend/src/modules/conversations/conversations.routes.ts): `backend/src/modules/conversations/conversations.routes.ts`
- [Message Routes](https://github.com/mayaalla/real-time-chatapp/blob/main/backend/src/modules/messages/messages.routes.ts): `backend/src/modules/messages/messages.routes.ts`
- [Upload Routes](https://github.com/mayaalla/real-time-chatapp/blob/main/backend/src/modules/uploads/uploads.routes.ts): `backend/src/modules/uploads/uploads.routes.ts`

### Identity and Profiles

- [Auth Controller](https://github.com/mayaalla/real-time-chatapp/blob/main/backend/src/modules/auth/auth.controller.ts): `backend/src/modules/auth/auth.controller.ts`
- [Auth Service](https://github.com/mayaalla/real-time-chatapp/blob/main/backend/src/modules/auth/auth.service.ts): `backend/src/modules/auth/auth.service.ts`
- [Auth Schemas](https://github.com/mayaalla/real-time-chatapp/blob/main/backend/src/modules/auth/auth.schemas.ts): `backend/src/modules/auth/auth.schemas.ts`
- [User Controller](https://github.com/mayaalla/real-time-chatapp/blob/main/backend/src/modules/users/users.controller.ts): `backend/src/modules/users/users.controller.ts`
- [User Service](https://github.com/mayaalla/real-time-chatapp/blob/main/backend/src/modules/users/users.service.ts): `backend/src/modules/users/users.service.ts`

### Conversation and Messaging

- [Conversation Controller](https://github.com/mayaalla/real-time-chatapp/blob/main/backend/src/modules/conversations/conversations.controller.ts): `backend/src/modules/conversations/conversations.controller.ts`
- [Conversation Service](https://github.com/mayaalla/real-time-chatapp/blob/main/backend/src/modules/conversations/conversations.service.ts): `backend/src/modules/conversations/conversations.service.ts`
- [Message Controller](https://github.com/mayaalla/real-time-chatapp/blob/main/backend/src/modules/messages/messages.controller.ts): `backend/src/modules/messages/messages.controller.ts`
- [Message Service](https://github.com/mayaalla/real-time-chatapp/blob/main/backend/src/modules/messages/messages.service.ts): `backend/src/modules/messages/messages.service.ts`
- [Upload Controller](https://github.com/mayaalla/real-time-chatapp/blob/main/backend/src/modules/uploads/uploads.controller.ts): `backend/src/modules/uploads/uploads.controller.ts`
- [Upload Service](https://github.com/mayaalla/real-time-chatapp/blob/main/backend/src/modules/uploads/uploads.service.ts): `backend/src/modules/uploads/uploads.service.ts`

### Realtime

- [Socket.IO Server](https://github.com/mayaalla/real-time-chatapp/blob/main/backend/src/realtime/index.ts): `backend/src/realtime/index.ts`
- [Socket Auth](https://github.com/mayaalla/real-time-chatapp/blob/main/backend/src/realtime/middleware/socketAuth.ts): `backend/src/realtime/middleware/socketAuth.ts`
- [Live Messages](https://github.com/mayaalla/real-time-chatapp/blob/main/backend/src/realtime/handlers/message.ts): `backend/src/realtime/handlers/message.ts`
- [Presence Handler](https://github.com/mayaalla/real-time-chatapp/blob/main/backend/src/realtime/handlers/presence.ts): `backend/src/realtime/handlers/presence.ts`
- [Receipt Handler](https://github.com/mayaalla/real-time-chatapp/blob/main/backend/src/realtime/handlers/receipts.ts): `backend/src/realtime/handlers/receipts.ts`
- [Typing Handler](https://github.com/mayaalla/real-time-chatapp/blob/main/backend/src/realtime/handlers/typing.ts): `backend/src/realtime/handlers/typing.ts`
- [Sync Handler](https://github.com/mayaalla/real-time-chatapp/blob/main/backend/src/realtime/handlers/sync.ts): `backend/src/realtime/handlers/sync.ts`

### Runtime Infrastructure

- [PostgreSQL via Prisma](https://github.com/mayaalla/real-time-chatapp/blob/main/backend/src/db/prisma.ts): `backend/src/db/prisma.ts`
- [Redis Client](https://github.com/mayaalla/real-time-chatapp/blob/main/backend/src/redis/client.ts): `backend/src/redis/client.ts`
- [JWT Utilities](https://github.com/mayaalla/real-time-chatapp/blob/main/backend/src/utils/token.ts): `backend/src/utils/token.ts`
- [Environment Config](https://github.com/mayaalla/real-time-chatapp/blob/main/backend/src/config/env.ts): `backend/src/config/env.ts`

### Other components

- **API Client**

## Connections

- API Client → Express App: sends requests (evidence: `backend/src/app.ts`)
- Express App → Auth Routes: mounts (evidence: `backend/src/app.ts`)
- Express App → User Routes: mounts (evidence: `backend/src/app.ts`)
- Express App → Conversation Routes: mounts (evidence: `backend/src/app.ts`)
- Express App → Message Routes: mounts (evidence: `backend/src/app.ts`)
- Express App → Upload Routes: mounts (evidence: `backend/src/app.ts`)
- Auth Routes → Auth Controller: routes to (evidence: `backend/src/modules/auth/auth.routes.ts`)
- Auth Routes → Auth Schemas: validates with (evidence: `backend/src/modules/auth/auth.routes.ts`)
- Auth Controller → Auth Service: calls (evidence: `backend/src/modules/auth/auth.controller.ts`)
- Auth Service → PostgreSQL via Prisma: reads and writes (evidence: `backend/src/modules/auth/auth.service.ts`)
- Auth Service → JWT Utilities: issues tokens (evidence: `backend/src/modules/auth/auth.service.ts`)
- User Routes → User Controller: routes to (evidence: `backend/src/modules/users/users.routes.ts`)
- User Controller → User Service: calls (evidence: `backend/src/modules/users/users.controller.ts`)
- User Service → PostgreSQL via Prisma: reads and writes (evidence: `backend/src/modules/users/users.service.ts`)
- Conversation Routes → Conversation Controller: routes to (evidence: `backend/src/modules/conversations/conversations.routes.ts`)
- Conversation Controller → Conversation Service: calls (evidence: `backend/src/modules/conversations/conversations.controller.ts`)
- Conversation Service → PostgreSQL via Prisma: reads and writes (evidence: `backend/src/modules/conversations/conversations.service.ts`)
- Message Routes → Message Controller: routes to (evidence: `backend/src/modules/messages/messages.routes.ts`)
- Message Controller → Message Service: calls (evidence: `backend/src/modules/messages/messages.controller.ts`)
- Message Service → PostgreSQL via Prisma: reads and writes (evidence: `backend/src/modules/messages/messages.service.ts`)
- Message Service → Upload Service: resolves attachments (evidence: `backend/src/modules/messages/messages.service.ts`)
- Upload Routes → Upload Controller: routes to (evidence: `backend/src/modules/uploads/uploads.routes.ts`)
- Upload Controller → Upload Service: calls (evidence: `backend/src/modules/uploads/uploads.controller.ts`)
- Upload Service → PostgreSQL via Prisma: reads and writes (evidence: `backend/src/modules/uploads/uploads.service.ts`)
- Socket.IO Server → Socket Auth: registers (evidence: `backend/src/realtime/index.ts`)
- Socket.IO Server → Live Messages: registers (evidence: `backend/src/realtime/index.ts`)
- Socket.IO Server → Presence Handler: registers (evidence: `backend/src/realtime/index.ts`)
- Socket.IO Server → Receipt Handler: registers (evidence: `backend/src/realtime/index.ts`)
- Socket.IO Server → Typing Handler: registers (evidence: `backend/src/realtime/index.ts`)
- Socket.IO Server → Sync Handler: registers (evidence: `backend/src/realtime/index.ts`)
- Socket Auth → JWT Utilities: verifies tokens (evidence: `backend/src/realtime/middleware/socketAuth.ts`)
- Live Messages → Conversation Service: uses conversation logic (evidence: `backend/src/realtime/handlers/message.ts`)
- Live Messages → PostgreSQL via Prisma: reads and writes (evidence: `backend/src/realtime/handlers/message.ts`)
- Socket.IO Server → Redis Client: uses client (evidence: `backend/src/realtime/index.ts`)
- PostgreSQL via Prisma → Environment Config: configures connection (evidence: `backend/src/db/prisma.ts`)
- Redis Client → Environment Config: reads settings (evidence: `backend/src/redis/client.ts`)
- JWT Utilities → Environment Config: reads secrets (evidence: `backend/src/utils/token.ts`)
