Corp/docs/guides/REALTIME_MIGRATION_GUIDE.md

Миграция на архитектуру Realtime

Что изменилось

Создано новое Django-приложение realtime, которое объединяет всю WebSocket логику в одном месте.

Было (старая архитектура)

communications/
├── user_consumer.py    # WebSocket для чатов
└── routing.py          # /ws/

notifications/
├── consumers.py        # WebSocket для уведомлений
└── routing.py          # /ws/notifications/

Проблемы:

• 2 WebSocket соединения на пользователя
• Дублирование функциональности уведомлений
• WebSocket логика смешана с бизнес-логикой приложений

Стало (новая архитектура)

realtime/
├── consumers.py        # UserConsumer - универсальный
├── routing.py          # /ws/
└── README.md           # Документация

communications/
└── models.py, views.py, signals.py  # Только бизнес-логика

notifications/
└── models.py, views.py, signals.py  # Только бизнес-логика

Преимущества:

• ✅ Одно WebSocket соединение для всего
• ✅ Чистая архитектура (транспорт отделен от бизнес-логики)
• ✅ Легко расширять новыми real-time фичами
• ✅ Ping interval 20 секунд (было 30)

Что НЕ меняется

• URL остается тот же: ws://corp.robotail.local/ws/
• Frontend код не требует изменений (API совместимо)
• Базы данных не затронуты (нет миграций)
• Nginx конфигурация не меняется

Инструкции для сервера

1. Получить обновления

cd ~/EUSRR
git pull origin master

2. Проверить изменения

# Должны появиться новые файлы
ls -la backend/realtime/
# Должен показать: consumers.py, routing.py, README.md и др.

# Проверить settings.py
grep -A 30 "INSTALLED_APPS" backend/eusrr_backend/settings.py | grep realtime
# Должно показать: "realtime.apps.RealtimeConfig",

# Проверить asgi.py
grep "realtime" backend/eusrr_backend/asgi.py
# Должно показать: from realtime.routing import websocket_urlpatterns

3. Перезапустить приложение

# Остановить Gunicorn
sudo systemctl stop gunicorn

# Проверить что процессы остановлены
ps aux | grep gunicorn

# Запустить снова
sudo systemctl start gunicorn

# Проверить статус
sudo systemctl status gunicorn

# Проверить логи
sudo journalctl -u gunicorn -n 50 -f

4. Проверка работы

Проверка WebSocket соединений

# Смотреть логи в реальном времени
sudo tail -f /var/log/nginx/access.log | grep ws

# Должны появляться записи при подключении пользователей:
# "GET /ws/ HTTP/1.1" 101

Проверка в браузере (DevTools)

1. Открыть страницу с чатом
2. F12 → Network → WS
3. Должно быть одно соединение: ws://corp.robotail.local/ws/
4. В Messages должны приходить ping каждые 20 секунд:

   {"type": "ping", "timestamp": "..."}
   

5. Откат (если что-то пошло не так)

# Вернуться к предыдущему коммиту
cd ~/EUSRR
git log --oneline -5  # найти хеш коммита до изменений
git checkout <хеш-предыдущего-коммита>

# Перезапустить
sudo systemctl restart gunicorn

Мониторинг

Логи для отладки

# Все логи Gunicorn
sudo journalctl -u gunicorn -n 100

# Только ошибки
sudo journalctl -u gunicorn -p err -n 50

# WebSocket connections
sudo journalctl -u gunicorn | grep "UserWS"

# Пример успешного подключения:
# [UserWS] User 10 connected, subscribed to 7 chats

Метрики успешной миграции

• ✅ WebSocket подключается (статус 101 в Nginx logs)
• ✅ Ping приходит каждые 20 секунд
• ✅ Сообщения в чатах отправляются и получаются
• ✅ Уведомления приходят в real-time
• ✅ Нет ошибок в journalctl -u gunicorn

FAQ

В чем разница для пользователей?

Никакой! Пользователи не заметят изменений, все работает так же.

Почему ping стал 20 секунд вместо 30?

Более частые ping повышают стабильность соединения на некоторых сетях/прокси.

Можно ли удалить старые файлы?

Пока нет! Файлы communications/user_consumer.py и notifications/consumers.py оставлены для совместимости. Удалим их в следующем релизе после тестирования.

Где посмотреть новую документацию?

backend/realtime/README.md - полная документация по WebSocket API

Контакты

При проблемах:

1. Проверить логи: sudo journalctl -u gunicorn -n 100
2. Проверить Nginx: sudo nginx -t && sudo systemctl status nginx
3. Откатиться на предыдущую версию (см. раздел "Откат")