# tamasa111/my-chat-app architecture

> Architecture diagram of the GitHub repository tamasa111/my-chat-app, 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/tamasa111/my-chat-app
- Repository: https://github.com/tamasa111/my-chat-app

## Overview

This is a JavaFX desktop chat client, Spring Boot WebSocket/HTTP server, and shared Java message protocol. Users log in, connect over STOMP, exchange group or peer messages, view presence and history, and upload files over HTTP. The server handles messages and presence, persists message and user data, and provides user administration. The README establishes the three-part product; sampled code and the source index support the internal links shown. Some server wiring and configuration were not sampled, so uncertain links are omitted.

Main entry points: [`chat-client/src/main/java/com/chatapp/client/controller/ChatController.java`](https://github.com/tamasa111/my-chat-app/blob/main/chat-client/src/main/java/com/chatapp/client/controller/ChatController.java) (Chat UI), [`chat-server/src/main/java/com/chatapp/server/service/MessageService.java`](https://github.com/tamasa111/my-chat-app/blob/main/chat-server/src/main/java/com/chatapp/server/service/MessageService.java) (Message Service), [`chat-server/src/main/java/com/chatapp/server/websocket/ChatWebSocketHandler.java`](https://github.com/tamasa111/my-chat-app/blob/main/chat-server/src/main/java/com/chatapp/server/websocket/ChatWebSocketHandler.java) (WebSocket Handler), [`chat-server/src/main/java/com/chatapp/server/service/UserService.java`](https://github.com/tamasa111/my-chat-app/blob/main/chat-server/src/main/java/com/chatapp/server/service/UserService.java) (User Service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Desktop Client"]
  node_clientapp["JavaFX Application"]
  node_login["Login Controller"]
  node_chatui["Chat UI"]
  node_messageitem["Message Views<br/>[MessageItem.java]"]
  node_stompclient["STOMP Client"]
  node_wsclient["WebSocket Transport"]
end

subgraph group_protocol["Shared Protocol"]
  node_protocol["Message DTOs<br/>[ChatMessage.java]"]
  node_serializer["Message Serializer"]
end

subgraph group_realtime["Realtime Chat"]
  node_wsserver["WebSocket Handler"]
  node_presence["Presence and Dispatch"]
  node_chatapi["Chat HTTP API"]
end

subgraph group_domain["Chat Services"]
  node_messages["Message Service"]
  node_files["File Storage"]
  node_messageentity["Message Entity<br/>[Message.java]"]
  node_messagerepo["Message Repository"]
  node_sqlite[("SQLite Database<br/>[SqliteConfig.java]")]
end

subgraph group_admin["User Administration"]
  node_userapi["User API"]
  node_useradmin["User Management UI"]
  node_users["User Service<br/>[UserService.java]"]
  node_userrepo["User Repository"]
  node_userentity["User Entity<br/>[User.java]"]
end

node_user(("Chat User"))

node_user -->|"uses"| node_clientapp
node_clientapp -->|"loads"| node_login
node_clientapp -->|"loads"| node_chatui
node_chatui -->|"sends and receives"| node_stompclient
node_chatui -->|"renders"| node_messageitem
node_stompclient -->|"creates transport"| node_wsclient
node_chatui -->|"uses messages"| node_protocol
node_stompclient -->|"sends and receives"| node_protocol
node_wsserver -->|"handles messages"| node_protocol
node_user -->|"chats over WebSocket"| node_wsserver
node_wsserver -->|"uses presence"| node_presence
node_wsserver -->|"handles chat"| node_messages
node_chatapi -->|"uses history"| node_messages
node_chatapi -->|"stores uploads"| node_files
node_chatui -->|"uploads over HTTP"| node_chatapi
node_messages -->|"reads and writes"| node_messagerepo
node_messages -->|"deletes expired files"| node_files
node_messages -->|"maps messages"| node_messageentity
node_messagerepo -->|"persists"| node_messageentity
node_userapi -->|"queries users"| node_users
node_useradmin -->|"manages users"| node_users
node_users -->|"reads and writes"| node_userrepo
node_users -->|"manages records"| node_userentity
node_userrepo -->|"persists"| node_userentity
node_serializer -->|"serializes"| node_protocol

click node_clientapp "https://github.com/tamasa111/my-chat-app/blob/main/chat-client/src/main/java/com/chatapp/client/ChatClientApplication.java"
click node_login "https://github.com/tamasa111/my-chat-app/blob/main/chat-client/src/main/java/com/chatapp/client/controller/LoginController.java"
click node_chatui "https://github.com/tamasa111/my-chat-app/blob/main/chat-client/src/main/java/com/chatapp/client/controller/ChatController.java"
click node_messageitem "https://github.com/tamasa111/my-chat-app/blob/main/chat-client/src/main/java/com/chatapp/client/model/MessageItem.java"
click node_stompclient "https://github.com/tamasa111/my-chat-app/blob/main/chat-client/src/main/java/com/chatapp/client/network/ChatStompClient.java"
click node_wsclient "https://github.com/tamasa111/my-chat-app/blob/main/chat-client/src/main/java/com/chatapp/client/network/ChatWebSocketClient.java"
click node_protocol "https://github.com/tamasa111/my-chat-app/blob/main/chat-common/src/main/java/com/chatapp/common/model/ChatMessage.java"
click node_serializer "https://github.com/tamasa111/my-chat-app/blob/main/chat-common/src/main/java/com/chatapp/common/MessageSerializer.java"
click node_wsserver "https://github.com/tamasa111/my-chat-app/blob/main/chat-server/src/main/java/com/chatapp/server/websocket/ChatWebSocketHandler.java"
click node_presence "https://github.com/tamasa111/my-chat-app/blob/main/chat-server/src/main/java/com/chatapp/server/service/ChatPresenceService.java"
click node_chatapi "https://github.com/tamasa111/my-chat-app/blob/main/chat-server/src/main/java/com/chatapp/server/controller/ChatApiController.java"
click node_messages "https://github.com/tamasa111/my-chat-app/blob/main/chat-server/src/main/java/com/chatapp/server/service/MessageService.java"
click node_files "https://github.com/tamasa111/my-chat-app/blob/main/chat-server/src/main/java/com/chatapp/server/service/FileStorageService.java"
click node_messageentity "https://github.com/tamasa111/my-chat-app/blob/main/chat-server/src/main/java/com/chatapp/server/model/Message.java"
click node_messagerepo "https://github.com/tamasa111/my-chat-app/blob/main/chat-server/src/main/java/com/chatapp/server/repository/MessageRepository.java"
click node_sqlite "https://github.com/tamasa111/my-chat-app/blob/main/chat-server/src/main/java/com/chatapp/server/config/SqliteConfig.java"
click node_userapi "https://github.com/tamasa111/my-chat-app/blob/main/chat-server/src/main/java/com/chatapp/server/controller/UserApiController.java"
click node_useradmin "https://github.com/tamasa111/my-chat-app/blob/main/chat-server/src/main/java/com/chatapp/server/controller/UserManagementController.java"
click node_users "https://github.com/tamasa111/my-chat-app/blob/main/chat-server/src/main/java/com/chatapp/server/service/UserService.java"
click node_userrepo "https://github.com/tamasa111/my-chat-app/blob/main/chat-server/src/main/java/com/chatapp/server/repository/UserRepository.java"
click node_userentity "https://github.com/tamasa111/my-chat-app/blob/main/chat-server/src/main/java/com/chatapp/server/model/User.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_clientapp,node_login,node_chatui,node_messageitem,node_stompclient,node_wsclient,node_user toneBlue
class node_protocol,node_serializer toneAmber
class node_wsserver,node_presence,node_chatapi toneMint
class node_messages,node_files,node_messageentity,node_messagerepo,node_sqlite toneRose
class node_userapi,node_useradmin,node_users,node_userrepo,node_userentity toneIndigo
```

## Components

### Desktop Client

- [JavaFX Application](https://github.com/tamasa111/my-chat-app/blob/main/chat-client/src/main/java/com/chatapp/client/ChatClientApplication.java): `chat-client/src/main/java/com/chatapp/client/ChatClientApplication.java`
- [Login Controller](https://github.com/tamasa111/my-chat-app/blob/main/chat-client/src/main/java/com/chatapp/client/controller/LoginController.java): `chat-client/src/main/java/com/chatapp/client/controller/LoginController.java`
- [Chat UI](https://github.com/tamasa111/my-chat-app/blob/main/chat-client/src/main/java/com/chatapp/client/controller/ChatController.java): `chat-client/src/main/java/com/chatapp/client/controller/ChatController.java`
- [Message Views](https://github.com/tamasa111/my-chat-app/blob/main/chat-client/src/main/java/com/chatapp/client/model/MessageItem.java): `chat-client/src/main/java/com/chatapp/client/model/MessageItem.java`
- [STOMP Client](https://github.com/tamasa111/my-chat-app/blob/main/chat-client/src/main/java/com/chatapp/client/network/ChatStompClient.java): `chat-client/src/main/java/com/chatapp/client/network/ChatStompClient.java`
- [WebSocket Transport](https://github.com/tamasa111/my-chat-app/blob/main/chat-client/src/main/java/com/chatapp/client/network/ChatWebSocketClient.java): `chat-client/src/main/java/com/chatapp/client/network/ChatWebSocketClient.java`

### Shared Protocol

- [Message DTOs](https://github.com/tamasa111/my-chat-app/blob/main/chat-common/src/main/java/com/chatapp/common/model/ChatMessage.java): `chat-common/src/main/java/com/chatapp/common/model/ChatMessage.java`
- [Message Serializer](https://github.com/tamasa111/my-chat-app/blob/main/chat-common/src/main/java/com/chatapp/common/MessageSerializer.java): `chat-common/src/main/java/com/chatapp/common/MessageSerializer.java`

### Realtime Chat

- [WebSocket Handler](https://github.com/tamasa111/my-chat-app/blob/main/chat-server/src/main/java/com/chatapp/server/websocket/ChatWebSocketHandler.java): `chat-server/src/main/java/com/chatapp/server/websocket/ChatWebSocketHandler.java`
- [Presence and Dispatch](https://github.com/tamasa111/my-chat-app/blob/main/chat-server/src/main/java/com/chatapp/server/service/ChatPresenceService.java): `chat-server/src/main/java/com/chatapp/server/service/ChatPresenceService.java`
- [Chat HTTP API](https://github.com/tamasa111/my-chat-app/blob/main/chat-server/src/main/java/com/chatapp/server/controller/ChatApiController.java): `chat-server/src/main/java/com/chatapp/server/controller/ChatApiController.java`

### Chat Services

- [Message Service](https://github.com/tamasa111/my-chat-app/blob/main/chat-server/src/main/java/com/chatapp/server/service/MessageService.java): `chat-server/src/main/java/com/chatapp/server/service/MessageService.java`
- [File Storage](https://github.com/tamasa111/my-chat-app/blob/main/chat-server/src/main/java/com/chatapp/server/service/FileStorageService.java): `chat-server/src/main/java/com/chatapp/server/service/FileStorageService.java`
- [Message Entity](https://github.com/tamasa111/my-chat-app/blob/main/chat-server/src/main/java/com/chatapp/server/model/Message.java): `chat-server/src/main/java/com/chatapp/server/model/Message.java`
- [Message Repository](https://github.com/tamasa111/my-chat-app/blob/main/chat-server/src/main/java/com/chatapp/server/repository/MessageRepository.java): `chat-server/src/main/java/com/chatapp/server/repository/MessageRepository.java`
- [SQLite Database](https://github.com/tamasa111/my-chat-app/blob/main/chat-server/src/main/java/com/chatapp/server/config/SqliteConfig.java): `chat-server/src/main/java/com/chatapp/server/config/SqliteConfig.java`

### User Administration

- [User API](https://github.com/tamasa111/my-chat-app/blob/main/chat-server/src/main/java/com/chatapp/server/controller/UserApiController.java): `chat-server/src/main/java/com/chatapp/server/controller/UserApiController.java`
- [User Management UI](https://github.com/tamasa111/my-chat-app/blob/main/chat-server/src/main/java/com/chatapp/server/controller/UserManagementController.java): `chat-server/src/main/java/com/chatapp/server/controller/UserManagementController.java`
- [User Service](https://github.com/tamasa111/my-chat-app/blob/main/chat-server/src/main/java/com/chatapp/server/service/UserService.java): `chat-server/src/main/java/com/chatapp/server/service/UserService.java`
- [User Repository](https://github.com/tamasa111/my-chat-app/blob/main/chat-server/src/main/java/com/chatapp/server/repository/UserRepository.java): `chat-server/src/main/java/com/chatapp/server/repository/UserRepository.java`
- [User Entity](https://github.com/tamasa111/my-chat-app/blob/main/chat-server/src/main/java/com/chatapp/server/model/User.java): `chat-server/src/main/java/com/chatapp/server/model/User.java`

### Other components

- **Chat User**

## Connections

- Chat User → JavaFX Application: uses (evidence: `README.md`)
- JavaFX Application → Login Controller: loads (evidence: `chat-client/src/main/java/com/chatapp/client/ChatClientApplication.java`)
- JavaFX Application → Chat UI: loads (evidence: `chat-client/src/main/java/com/chatapp/client/ChatClientApplication.java`)
- Chat UI → STOMP Client: sends and receives (evidence: `chat-client/src/main/java/com/chatapp/client/controller/ChatController.java`)
- Chat UI → Message Views: renders (evidence: `chat-client/src/main/java/com/chatapp/client/controller/ChatController.java`)
- STOMP Client → WebSocket Transport: creates transport (evidence: `chat-client/src/main/java/com/chatapp/client/network/ChatStompClient.java`)
- Chat UI → Message DTOs: uses messages (evidence: `chat-client/src/main/java/com/chatapp/client/controller/ChatController.java`)
- STOMP Client → Message DTOs: sends and receives (evidence: `chat-client/src/main/java/com/chatapp/client/network/ChatStompClient.java`)
- WebSocket Handler → Message DTOs: handles messages (evidence: `chat-server/src/main/java/com/chatapp/server/websocket/ChatWebSocketHandler.java`)
- Chat User → WebSocket Handler: chats over WebSocket (evidence: `README.md`)
- WebSocket Handler → Presence and Dispatch: uses presence (evidence: `chat-server/src/main/java/com/chatapp/server/websocket/ChatWebSocketHandler.java`)
- WebSocket Handler → Message Service: handles chat (evidence: `chat-server/src/main/java/com/chatapp/server/websocket/ChatWebSocketHandler.java`)
- Chat HTTP API → Message Service: uses history (evidence: `chat-server/src/main/java/com/chatapp/server/controller/ChatApiController.java`)
- Chat HTTP API → File Storage: stores uploads (evidence: `chat-server/src/main/java/com/chatapp/server/controller/ChatApiController.java`)
- Chat UI → Chat HTTP API: uploads over HTTP (evidence: `chat-client/src/main/java/com/chatapp/client/controller/ChatController.java`)
- Message Service → Message Repository: reads and writes (evidence: `chat-server/src/main/java/com/chatapp/server/service/MessageService.java`)
- Message Service → File Storage: deletes expired files (evidence: `chat-server/src/main/java/com/chatapp/server/service/MessageService.java`)
- Message Service → Message Entity: maps messages (evidence: `chat-server/src/main/java/com/chatapp/server/service/MessageService.java`)
- Message Repository → Message Entity: persists (evidence: `chat-server/src/main/java/com/chatapp/server/repository/MessageRepository.java`)
- User API → User Service: queries users (evidence: `chat-server/src/main/java/com/chatapp/server/controller/UserApiController.java`)
- User Management UI → User Service: manages users (evidence: `chat-server/src/main/java/com/chatapp/server/controller/UserManagementController.java`)
- User Service → User Repository: reads and writes (evidence: `chat-server/src/main/java/com/chatapp/server/service/UserService.java`)
- User Service → User Entity: manages records (evidence: `chat-server/src/main/java/com/chatapp/server/service/UserService.java`)
- User Repository → User Entity: persists (evidence: `chat-server/src/main/java/com/chatapp/server/repository/UserRepository.java`)
- Message Serializer → Message DTOs: serializes (evidence: `chat-common/src/main/java/com/chatapp/common/MessageSerializer.java`)
