Files
Govor/docs/signalr/presencehub.md
T

34 lines
2.4 KiB
Markdown

---
description: SignalR hub for managing user online presence and notifications.
icon: wifi
---
# PresenceHub — online и offline
Подключение: /hubs/presence. Требуется роль User/Admin.
Публичных команд у хаба нет. На подключении сервер добавляет connectionId в OnlineUserStore и группу userId. Первая связь пользователя вызывает событие UserOnline; отключение последней — UserOffline.
| Событие | Payload |
| ----------- | ----------------- |
| UserOnline | Guid пользователя |
| UserOffline | Guid пользователя |
Получатели определяются IUserNotificationScopeService. Несколько соединений одного пользователя учитываются отдельно.
## Ограничения
OnlineUserStore хранится в памяти одного процесса. Перезапуск теряет состояние; несколько серверов не согласованы. Online означает наличие соединения этого хаба, не доступность устройства для push.
PresenceHub не сохраняет lastSeen в БД при отключении. Для него есть отдельный HTTP ping; нужна единая политика обновления lastSeen.
Для первоначального экрана получайте доступные данные профиля/друзей; события только изменяют локальный cache. После reconnect перечитайте состояние. HTTP /api/online/status сейчас сломан из-за отсутствующих зависимостей.
Обработчики должны быть зарегистрированы до StartAsync. Не используйте события присутствия как гарантированный журнал активности.
***
Проверено по исходникам на 03.10.2026, commit `4603be9`. Описано текущее поведение; сервер с БД и Firebase в рамках диагностики не запускался.
Источник: [Govor.API/Hubs/PresenceHub.cs](https://github.com/Govor-team/Govor/blob/4603be9f714135e0af72d505d17f3d1709834bea/Govor.API/Hubs/PresenceHub.cs).