efir-api-server/README.md

# Эфир

**Эфир** — это лёгкий и быстрый мессенджер на Go с поддержкой реального времени. Серверная часть написана с нуля, использует WebSocket для мгновенной доставки сообщений и AES-256-GCM для шифрования.

## Основные возможности

- 🔐 **JWT-аутентификация** — безопасный вход и регистрация
- 💬 **Личные чаты 1-1** — общение напрямую
- 👥 **Групповые чаты** — беседы с несколькими участниками
- ⚡ **WebSocket** — сообщения приходят мгновенно без перезагрузки страницы
- 🔒 **Шифрование сообщений** — все сообщения хранятся в БД в зашифрованном виде (AES-256-GCM)
- 📎 **Загрузка файлов** — отправка изображений и документов
- 👑 **Ролевая модель** — обычные пользователи и глобальный администратор
- 📦 **SQLite** — не требует отдельного сервера БД, легко заменяется на PostgreSQL
- 💾 **Низкое потребление ресурсов** — около 3-5 МБ оперативной памяти в простое

## Как это работает

Клиент подключается к API-серверу через HTTP для обычных операций (регистрация, создание чатов, загрузка файлов) и через WebSocket для обмена сообщениями в реальном времени. Все сообщения перед сохранением в базу данных шифруются, а при отправке расшифровываются сервером и передаются клиенту.

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

- **Go 1.25** — основной язык
- **Chi** — маршрутизация HTTP-запросов
- **Gorilla WebSocket** — WebSocket соединения
- **SQLite** — встраиваемая база данных
- **JWT** — аутентификация
- **bcrypt** — хэширование паролей
- **AES-256-GCM** — шифрование сообщений

## Быстрый старт

1. Скопируйте `.env.example` в `.env` и настройте переменные окружения
2. Запустите сервер: `go run cmd/server/main.go`
3. Сервер будет доступен на порту, указанном в конфиге (по умолчанию 8080)

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

Проект организован по принципу чистой архитектуры: обработчики (handlers) → сервисы (services) → репозитории (repositories). Это позволяет легко заменять компоненты, например, переходить с SQLite на PostgreSQL без изменения бизнес-логики.

- `cmd/server` — точка входа, запуск сервера
- `internal/api` — HTTP-обработчики, middleware и утилиты для ответов
- `internal/service` — бизнес-логика (регистрация, чаты, сообщения)
- `internal/repository` — работа с базой данных (интерфейсы + реализация для SQLite)
- `internal/websocket` — WebSocket Hub, управление подключениями и комнатами
- `internal/crypto` — шифрование и расшифровка сообщений
- `internal/models` — структуры данных
- `migrations` — SQL-миграции для инициализации базы данных

## API

Основные эндпоинты:
- `POST /api/register` — регистрация нового пользователя
- `POST /api/login` — вход, получение JWT-токена
- `GET /api/me` — информация о текущем пользователе
- `GET /api/users?q=` — поиск пользователей по логину
- `POST /api/chats/private` — создание личного чата
- `POST /api/chats/group` — создание группового чата
- `GET /api/chats` — список всех чатов пользователя
- `GET /api/chats/{id}/messages` — история сообщений в чате
- `GET /ws?token=` — WebSocket подключение для обмена сообщениями

## Деплой

Сервер легко деплоится на Linux. Достаточно собрать бинарник под целевую платформу:

```bash
GOOS=linux GOARCH=amd64 CGO_ENABLED=0 go build -o bin/efir-linux cmd/server/main.go
```

Затем запустить его через systemd или Docker. Для работы WebSocket рекомендуется использовать Nginx в качестве reverse proxy.

## Состояние проекта

Проект полностью работоспособен и готов к использованию для личных целей или небольших команд. Реализованы все базовые функции мессенджера. В планах — улучшение фронтенда и добавление push-уведомлений.