# dyuvaraj148-ai/real-time-chat-application architecture

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

- Interactive diagram: https://gitdiagram.com/dyuvaraj148-ai/real-time-chat-application
- Repository: https://github.com/dyuvaraj148-ai/real-time-chat-application

## Overview

Social Chat App is a JavaFX desktop messaging system. Users authenticate, choose a person or group, exchange messages, and can search history or send files and voice notes; the TCP server routes traffic, queues messages for offline recipients, and persists chat data. Group management and smart replies are additional capabilities. The map reflects README-described flows and source-index references; unsampled implementation details are not expanded, and optional FastAPI integration is shown separately.

Main entry points: [`src/server/ClientHandler.java`](https://github.com/dyuvaraj148-ai/real-time-chat-application/blob/main/src/server/ClientHandler.java) (Routing and delivery), [`src/client/ClientConnection.java`](https://github.com/dyuvaraj148-ai/real-time-chat-application/blob/main/src/client/ClientConnection.java) (TCP connection), [`src/client/controller/MidController.java`](https://github.com/dyuvaraj148-ai/real-time-chat-application/blob/main/src/client/controller/MidController.java) (Chat controller), [`src/client/controller/HomeController.java`](https://github.com/dyuvaraj148-ai/real-time-chat-application/blob/main/src/client/controller/HomeController.java) (Home UI)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Desktop client"]
  node_home["Home UI"]
  node_sidebar["People and groups"]
  node_chat["Chat controller<br/>[MidController.java]"]
  node_rightpanel["Media panel"]
  node_messages["Message handling"]
  node_ui_messages["Message rendering"]
  node_files["File transfer<br/>[FileHandler.java]"]
  node_media["Media playback<br/>[MediaHandler.java]"]
  node_voice["Voice recording"]
  node_search["Message search"]
  node_connection["TCP connection"]
end

subgraph group_server["Socket server"]
  node_servermain["Server startup<br/>[ServerMain.java]"]
  node_handler["Routing and delivery<br/>[ClientHandler.java]"]
  node_msgservice["Message workflows"]
  node_userdao["User persistence<br/>[UserDAO.java]"]
  node_msgdao["Message persistence<br/>[MessageDao.java]"]
  node_filedao["File persistence<br/>[FileDao.java]"]
  node_groupdao["Group persistence<br/>[GroupDao.java]"]
  node_groupmsgdao["Group message store"]
end

subgraph group_shared["Shared protocol"]
  node_frame["Wire frames<br/>[Frame.java]"]
  node_frameio["Frame encoding<br/>[FrameIO.java]"]
  node_types["Protocol operations<br/>[MessageType.java]"]
  node_models["Chat data models<br/>[Message.java]"]
end

subgraph group_integrations["Data and integrations"]
  node_mysql[("MySQL")]
  node_fastapi["Smart reply API"]
  node_media_server["Local media stream"]
end

node_user(("Chat user"))

node_user -->|"uses"| node_home
node_home -->|"initializes"| node_sidebar
node_home -->|"initializes"| node_chat
node_home -->|"binds"| node_rightpanel
node_sidebar -->|"requests data"| node_connection
node_chat -->|"delegates to"| node_messages
node_chat -->|"delegates to"| node_files
node_chat -->|"delegates to"| node_media
node_chat -.->|"delegates to"| node_voice
node_messages -->|"uses"| node_ui_messages
node_rightpanel -->|"requests downloads"| node_connection
node_rightpanel -.->|"supports search"| node_search
node_search -.->|"searches via"| node_connection
node_messages -->|"sends messages"| node_connection
node_files -->|"sends file frames"| node_connection
node_connection -->|"creates frames"| node_frame
node_connection -->|"encodes frames"| node_frameio
node_frame -->|"uses types"| node_types
node_connection -->|"communicates over TCP"| node_handler
node_servermain -->|"spawns handlers"| node_handler
node_handler -->|"routes and persists"| node_msgdao
node_handler -->|"authenticates users"| node_userdao
node_handler -->|"stores file metadata"| node_filedao
node_handler -->|"manages groups"| node_groupdao
node_handler -->|"stores group messages"| node_groupmsgdao
node_msgservice -->|"deletes messages"| node_msgdao
node_msgservice -->|"deletes file records"| node_filedao
node_userdao -->|"reads and writes"| node_mysql
node_msgdao -.->|"reads and writes"| node_mysql
node_filedao -.->|"reads and writes"| node_mysql
node_handler -->|"requests suggestions"| node_fastapi
node_media -.->|"streams media"| node_media_server
node_handler -->|"routes model data"| node_models
node_msgdao -->|"maps messages"| node_models

click node_home "https://github.com/dyuvaraj148-ai/real-time-chat-application/blob/main/src/client/controller/HomeController.java"
click node_sidebar "https://github.com/dyuvaraj148-ai/real-time-chat-application/blob/main/src/client/controller/LeftController.java"
click node_chat "https://github.com/dyuvaraj148-ai/real-time-chat-application/blob/main/src/client/controller/MidController.java"
click node_rightpanel "https://github.com/dyuvaraj148-ai/real-time-chat-application/blob/main/src/client/controller/RightController.java"
click node_messages "https://github.com/dyuvaraj148-ai/real-time-chat-application/blob/main/src/client/controller/mid/MessageHandler.java"
click node_ui_messages "https://github.com/dyuvaraj148-ai/real-time-chat-application/blob/main/src/client/controller/mid/UIMessageHandler.java"
click node_files "https://github.com/dyuvaraj148-ai/real-time-chat-application/blob/main/src/client/controller/mid/FileHandler.java"
click node_media "https://github.com/dyuvaraj148-ai/real-time-chat-application/blob/main/src/client/controller/mid/MediaHandler.java"
click node_voice "https://github.com/dyuvaraj148-ai/real-time-chat-application/blob/main/src/client/controller/mid/VoiceRecordHandler.java"
click node_search "https://github.com/dyuvaraj148-ai/real-time-chat-application/blob/main/src/client/controller/right/SearchMessageHandler.java"
click node_connection "https://github.com/dyuvaraj148-ai/real-time-chat-application/blob/main/src/client/ClientConnection.java"
click node_servermain "https://github.com/dyuvaraj148-ai/real-time-chat-application/blob/main/src/server/ServerMain.java"
click node_handler "https://github.com/dyuvaraj148-ai/real-time-chat-application/blob/main/src/server/ClientHandler.java"
click node_msgservice "https://github.com/dyuvaraj148-ai/real-time-chat-application/blob/main/src/server/service/MessageService.java"
click node_userdao "https://github.com/dyuvaraj148-ai/real-time-chat-application/blob/main/src/server/dao/UserDAO.java"
click node_msgdao "https://github.com/dyuvaraj148-ai/real-time-chat-application/blob/main/src/server/dao/MessageDao.java"
click node_filedao "https://github.com/dyuvaraj148-ai/real-time-chat-application/blob/main/src/server/dao/FileDao.java"
click node_groupdao "https://github.com/dyuvaraj148-ai/real-time-chat-application/blob/main/src/server/dao/GroupDao.java"
click node_groupmsgdao "https://github.com/dyuvaraj148-ai/real-time-chat-application/blob/main/src/server/dao/GroupMessageDao.java"
click node_frame "https://github.com/dyuvaraj148-ai/real-time-chat-application/blob/main/src/common/Frame.java"
click node_frameio "https://github.com/dyuvaraj148-ai/real-time-chat-application/blob/main/src/common/FrameIO.java"
click node_types "https://github.com/dyuvaraj148-ai/real-time-chat-application/blob/main/src/common/MessageType.java"
click node_models "https://github.com/dyuvaraj148-ai/real-time-chat-application/blob/main/src/common/Message.java"
click node_media_server "https://github.com/dyuvaraj148-ai/real-time-chat-application/blob/main/src/client/media/InMemoryMediaServer.java"

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_home,node_sidebar,node_chat,node_rightpanel,node_messages,node_ui_messages,node_files,node_media,node_voice,node_search,node_connection,node_user toneBlue
class node_servermain,node_handler,node_msgservice,node_userdao,node_msgdao,node_filedao,node_groupdao,node_groupmsgdao toneAmber
class node_frame,node_frameio,node_types,node_models toneMint
class node_mysql,node_fastapi,node_media_server toneRose
```

## Components

### Desktop client

- [Home UI](https://github.com/dyuvaraj148-ai/real-time-chat-application/blob/main/src/client/controller/HomeController.java): `src/client/controller/HomeController.java`
- [People and groups](https://github.com/dyuvaraj148-ai/real-time-chat-application/blob/main/src/client/controller/LeftController.java): `src/client/controller/LeftController.java`
- [Chat controller](https://github.com/dyuvaraj148-ai/real-time-chat-application/blob/main/src/client/controller/MidController.java): `src/client/controller/MidController.java`
- [Media panel](https://github.com/dyuvaraj148-ai/real-time-chat-application/blob/main/src/client/controller/RightController.java): `src/client/controller/RightController.java`
- [Message handling](https://github.com/dyuvaraj148-ai/real-time-chat-application/blob/main/src/client/controller/mid/MessageHandler.java): `src/client/controller/mid/MessageHandler.java`
- [Message rendering](https://github.com/dyuvaraj148-ai/real-time-chat-application/blob/main/src/client/controller/mid/UIMessageHandler.java): `src/client/controller/mid/UIMessageHandler.java`
- [File transfer](https://github.com/dyuvaraj148-ai/real-time-chat-application/blob/main/src/client/controller/mid/FileHandler.java): `src/client/controller/mid/FileHandler.java`
- [Media playback](https://github.com/dyuvaraj148-ai/real-time-chat-application/blob/main/src/client/controller/mid/MediaHandler.java): `src/client/controller/mid/MediaHandler.java`
- [Voice recording](https://github.com/dyuvaraj148-ai/real-time-chat-application/blob/main/src/client/controller/mid/VoiceRecordHandler.java): `src/client/controller/mid/VoiceRecordHandler.java`
- [Message search](https://github.com/dyuvaraj148-ai/real-time-chat-application/blob/main/src/client/controller/right/SearchMessageHandler.java): `src/client/controller/right/SearchMessageHandler.java`
- [TCP connection](https://github.com/dyuvaraj148-ai/real-time-chat-application/blob/main/src/client/ClientConnection.java): `src/client/ClientConnection.java`

### Socket server

- [Server startup](https://github.com/dyuvaraj148-ai/real-time-chat-application/blob/main/src/server/ServerMain.java): `src/server/ServerMain.java`
- [Routing and delivery](https://github.com/dyuvaraj148-ai/real-time-chat-application/blob/main/src/server/ClientHandler.java): `src/server/ClientHandler.java`
- [Message workflows](https://github.com/dyuvaraj148-ai/real-time-chat-application/blob/main/src/server/service/MessageService.java): `src/server/service/MessageService.java`
- [User persistence](https://github.com/dyuvaraj148-ai/real-time-chat-application/blob/main/src/server/dao/UserDAO.java): `src/server/dao/UserDAO.java`
- [Message persistence](https://github.com/dyuvaraj148-ai/real-time-chat-application/blob/main/src/server/dao/MessageDao.java): `src/server/dao/MessageDao.java`
- [File persistence](https://github.com/dyuvaraj148-ai/real-time-chat-application/blob/main/src/server/dao/FileDao.java): `src/server/dao/FileDao.java`
- [Group persistence](https://github.com/dyuvaraj148-ai/real-time-chat-application/blob/main/src/server/dao/GroupDao.java): `src/server/dao/GroupDao.java`
- [Group message store](https://github.com/dyuvaraj148-ai/real-time-chat-application/blob/main/src/server/dao/GroupMessageDao.java): `src/server/dao/GroupMessageDao.java`

### Shared protocol

- [Wire frames](https://github.com/dyuvaraj148-ai/real-time-chat-application/blob/main/src/common/Frame.java): `src/common/Frame.java`
- [Frame encoding](https://github.com/dyuvaraj148-ai/real-time-chat-application/blob/main/src/common/FrameIO.java): `src/common/FrameIO.java`
- [Protocol operations](https://github.com/dyuvaraj148-ai/real-time-chat-application/blob/main/src/common/MessageType.java): `src/common/MessageType.java`
- [Chat data models](https://github.com/dyuvaraj148-ai/real-time-chat-application/blob/main/src/common/Message.java): `src/common/Message.java`

### Data and integrations

- **MySQL**
- **Smart reply API**
- [Local media stream](https://github.com/dyuvaraj148-ai/real-time-chat-application/blob/main/src/client/media/InMemoryMediaServer.java): `src/client/media/InMemoryMediaServer.java`

### Other components

- **Chat user**

## Connections

- Chat user → Home UI: uses (evidence: `README.md`)
- Home UI → People and groups: initializes (evidence: `src/client/controller/HomeController.java`)
- Home UI → Chat controller: initializes (evidence: `src/client/controller/HomeController.java`)
- Home UI → Media panel: binds (evidence: `src/client/controller/HomeController.java`)
- People and groups → TCP connection: requests data (evidence: `src/client/controller/LeftController.java`)
- Chat controller → Message handling: delegates to (evidence: `src/client/controller/MidController.java`)
- Chat controller → File transfer: delegates to (evidence: `src/client/controller/MidController.java`)
- Chat controller → Media playback: delegates to (evidence: `src/client/controller/MidController.java`)
- Chat controller → Voice recording: delegates to (evidence: `src/client/controller/MidController.java`)
- Message handling → Message rendering: uses (evidence: `src/client/controller/mid/MessageHandler.java`)
- Media panel → TCP connection: requests downloads (evidence: `src/client/controller/RightController.java`)
- Media panel → Message search: supports search
- Message search → TCP connection: searches via
- Message handling → TCP connection: sends messages (evidence: `README.md`)
- File transfer → TCP connection: sends file frames (evidence: `README.md`)
- TCP connection → Wire frames: creates frames (evidence: `src/client/ClientConnection.java`)
- TCP connection → Frame encoding: encodes frames (evidence: `src/client/ClientConnection.java`)
- Wire frames → Protocol operations: uses types (evidence: `src/common/Frame.java`)
- TCP connection → Routing and delivery: communicates over TCP (evidence: `README.md`)
- Server startup → Routing and delivery: spawns handlers (evidence: `README.md`)
- Routing and delivery → Message persistence: routes and persists (evidence: `src/server/ClientHandler.java`)
- Routing and delivery → User persistence: authenticates users (evidence: `src/server/ClientHandler.java`)
- Routing and delivery → File persistence: stores file metadata (evidence: `src/server/ClientHandler.java`)
- Routing and delivery → Group persistence: manages groups (evidence: `src/server/ClientHandler.java`)
- Routing and delivery → Group message store: stores group messages (evidence: `src/server/ClientHandler.java`)
- Message workflows → Message persistence: deletes messages (evidence: `src/server/service/MessageService.java`)
- Message workflows → File persistence: deletes file records (evidence: `src/server/service/MessageService.java`)
- User persistence → MySQL: reads and writes (evidence: `README.md`)
- Message persistence → MySQL: reads and writes
- File persistence → MySQL: reads and writes
- Routing and delivery → Smart reply API: requests suggestions (evidence: `README.md`)
- Media playback → Local media stream: streams media
- Routing and delivery → Chat data models: routes model data (evidence: `src/server/ClientHandler.java`)
- Message persistence → Chat data models: maps messages (evidence: `src/server/dao/MessageDao.java`)
