WebSocket Chat Application

Современное веб-приложение для чата в реальном времени, построенное на Spring Boot с использованием WebSocket технологий.

🚀 Описание проекта

Это полнофункциональное чат-приложение, которое обеспечивает:

• Публичное общение - отправка сообщений всем участникам чата
• Приватные сообщения - индивидуальная переписка между пользователями
• Уведомления в реальном времени - мгновенные оповещения о присоединении/выходе пользователей
• Динамический список участников - отображение всех активных пользователей
• Современный веб-интерфейс - отзывчивый дизайн с интуитивным управлением

🛠 Технологический стек

Backend

• Spring Boot 3.1.3 - основной фреймворк приложения
• Spring WebSocket - для двусторонней связи в реальном времени
• STOMP Protocol - протокол обмена сообщениями поверх WebSocket
• Lombok - для уменьшения boilerplate кода
• Maven 3.9.9 - система сборки и управления зависимостями

Frontend

• HTML5 - структура веб-страниц
• CSS3 - стилизация и адаптивный дизайн
• Vanilla JavaScript (ES6+) - клиентская логика
• STOMP.js 7.0.0 - JavaScript клиент для STOMP протокола
• Thymeleaf - серверный шаблонизатор

Архитектурные решения

• MVC Pattern - разделение логики на Model-View-Controller
• Record Classes (Java 14+) - неизменяемые структуры данных
• Service Layer - бизнес-логика в отдельном слое
• Event-Driven Architecture - обработка подключений/отключений через события

📁 Структура проекта

src/
├── main/
│   ├── java/kg/attractor/websockets/
│   │   ├── config/
│   │   │   └── WebSocketConfig.java          # Конфигурация WebSocket
│   │   ├── controller/
│   │   │   ├── ChatController.java           # Контроллер чата
│   │   │   └── WebController.java            # Веб-контроллер
│   │   ├── enums/
│   │   │   └── Action.java                   # Типы действий пользователей
│   │   ├── model/
│   │   │   ├── Message.java                  # Модель сообщения
│   │   │   └── User.java                     # Модель пользователя
│   │   ├── services/
│   │   │   └── MemberStore.java              # Сервис управления участниками
│   │   └── WebSocketsApplication.java        # Главный класс приложения
│   └── resources/
│       ├── static/
│       │   ├── app.js                        # Клиентская JavaScript логика
│       │   └── style.css                     # Стили приложения
│       ├── templates/
│       │   └── index.html                    # Главная страница
│       └── application.properties            # Конфигурация приложения

⚙️ Ключевые функции

Подключение к чату

• Валидация имени пользователя (только буквы и цифры)
• Уникальная идентификация пользователей через UUID
• Автоматическое уведомление о новых участниках

Обмен сообщениями

• Публичные сообщения: видны всем участникам чата
• Приватные сообщения: доставляются только конкретному получателю
• Временные метки для всех сообщений
• Визуальное разделение приватных и публичных сообщений

Управление соединениями

• Автоматическая очистка при отключении пользователей
• Обработка непредвиденных разрывов соединения
• Динамическое обновление списка активных пользователей

🚦 Запуск приложения

Предварительные требования

• Java 17 или выше
• Maven 3.6+

Локальный запуск

1. Клонирование репозитория

git clone <repository-url>
cd websockets-chat

2. Запуск через Maven

./mvnw spring-boot:run

3. Альтернативный запуск

./mvnw clean package
java -jar target/SpringBootWebSockets-0.0.1.jar

4. Открытие в браузере

http://localhost:8080

🏗 Архитектурные особенности

WebSocket Конфигурация

• Message Broker: простой брокер для топиков /topic и /user
• Application Prefix: /app для маршрутизации сообщений
• User-specific destinations: индивидуальные каналы для приватных сообщений

Модель данных

• User: неизменяемый record с id, serialId и username
• Message: содержит пользователя, получателя, контент и тип действия
• Action enum: определяет типы событий (JOINED, LEFT, NEW_MESSAGE, etc.)

Управление состоянием

• In-memory хранение активных пользователей
• Thread-safe операции через статический список
• Автоматическая нумерация пользователей для UI

🎯 Особенности реализации

• Безопасность типов: использование современных Java features (Records, Optional)
• Реактивность: полностью асинхронная обработка сообщений
• Масштабируемость: возможность легкого расширения функциональности
• Производительность: минимальные накладные расходы благодаря STOMP протоколу

📈 Возможности развития

• Интеграция с базой данных для персистентности
• Аутентификация и авторизация пользователей
• Групповые чаты и каналы
• Загрузка файлов и медиа
• Push-уведомления
• Мобильное приложение

---

Разработано с использованием современных веб-технологий для создания высокопроизводительного чата в реальном времени.