How dyuvaraj148-ai/real-time-chat-application works
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: ClientHandler.java Routing and delivery · ClientConnection.java TCP connection · MidController.java Chat controller · HomeController.java Home UI
Components 27
Desktop client
- Home UI
src/client/controller/HomeController.java - People and groups
src/client/controller/LeftController.java - Chat controller
src/client/controller/MidController.java - Media panel
src/client/controller/RightController.java - Message handling
src/client/controller/mid/MessageHandler.java - Message rendering
src/client/controller/mid/UIMessageHandler.java - File transfer
src/client/controller/mid/FileHandler.java - Media playback
src/client/controller/mid/MediaHandler.java - Voice recording
src/client/controller/mid/VoiceRecordHandler.java - Message search
src/client/controller/right/SearchMessageHandler.java - TCP connection
src/client/ClientConnection.java
Socket server
- Server startup
src/server/ServerMain.java - Routing and delivery
src/server/ClientHandler.java - Message workflows
src/server/service/MessageService.java - User persistence
src/server/dao/UserDAO.java - Message persistence
src/server/dao/MessageDao.java - File persistence
src/server/dao/FileDao.java - Group persistence
src/server/dao/GroupDao.java - Group message store
src/server/dao/GroupMessageDao.java
Shared protocol
- Wire frames
src/common/Frame.java - Frame encoding
src/common/FrameIO.java - Protocol operations
src/common/MessageType.java - Chat data models
src/common/Message.java
Data and integrations
- MySQL
- Smart reply API
- Local media stream
src/client/media/InMemoryMediaServer.java
Other components
- Chat user
Connections 34
- Chat user → Home UI: uses
README.md - Home UI → People and groups: initializes
src/client/controller/HomeController.java - Home UI → Chat controller: initializes
src/client/controller/HomeController.java - Home UI → Media panel: binds
src/client/controller/HomeController.java - People and groups → TCP connection: requests data
src/client/controller/LeftController.java - Chat controller → Message handling: delegates to
src/client/controller/MidController.java - Chat controller → File transfer: delegates to
src/client/controller/MidController.java - Chat controller → Media playback: delegates to
src/client/controller/MidController.java - Chat controller → Voice recording: delegates to
src/client/controller/MidController.java - Message handling → Message rendering: uses
src/client/controller/mid/MessageHandler.java - Media panel → TCP connection: requests downloads
src/client/controller/RightController.java - Media panel → Message search: supports search
- Message search → TCP connection: searches via
- Message handling → TCP connection: sends messages
README.md - File transfer → TCP connection: sends file frames
README.md - TCP connection → Wire frames: creates frames
src/client/ClientConnection.java - TCP connection → Frame encoding: encodes frames
src/client/ClientConnection.java - Wire frames → Protocol operations: uses types
src/common/Frame.java - TCP connection → Routing and delivery: communicates over TCP
README.md - Server startup → Routing and delivery: spawns handlers
README.md - Routing and delivery → Message persistence: routes and persists
src/server/ClientHandler.java - Routing and delivery → User persistence: authenticates users
src/server/ClientHandler.java - Routing and delivery → File persistence: stores file metadata
src/server/ClientHandler.java - Routing and delivery → Group persistence: manages groups
src/server/ClientHandler.java - Routing and delivery → Group message store: stores group messages
src/server/ClientHandler.java - Message workflows → Message persistence: deletes messages
src/server/service/MessageService.java - Message workflows → File persistence: deletes file records
src/server/service/MessageService.java - User persistence → MySQL: reads and writes
README.md - Message persistence → MySQL: reads and writes
- File persistence → MySQL: reads and writes
- Routing and delivery → Smart reply API: requests suggestions
README.md - Media playback → Local media stream: streams media
- Routing and delivery → Chat data models: routes model data
src/server/ClientHandler.java - Message persistence → Chat data models: maps messages
src/server/dao/MessageDao.java