Уведомления

ONREZA отправляет уведомления о важных событиях: деплоях, ошибках, биллинге и безопасности. Вы можете настроить каналы доставки и фильтры для каждой категории.

Архитектура системы уведомлений

Система уведомлений построена по многослойной архитектуре с чётким разделением ответственности:

┌─────────────────────────────────────────────────────────────┐
│                    Presentation Layer                        │
│  (Inbox UI, Email Templates, Telegram Messages)             │
├─────────────────────────────────────────────────────────────┤
│                    Delivery Layer                            │
│  (Email Service, SSE Stream, Telegram Bot)                  │
├─────────────────────────────────────────────────────────────┤
│                    Processing Layer                          │
│  (Priority Router, Channel Filter, Quiet Hours Handler)     │
├─────────────────────────────────────────────────────────────┤
│                    Core Layer                                │
│  (Event Bus, Type Registry, Strict Typing)                  │
├─────────────────────────────────────────────────────────────┤
│                    Source Layer                              │
│  (Deployment, Health, Billing, Security Events)             │
└─────────────────────────────────────────────────────────────┘

Описание слоёв

Слой	Назначение	Компоненты
Source	Генерация событий	Deployment events, Health checks, Billing triggers, Security monitors
Core	Типизация и маршрутизация	Event Bus, NotificationEvent<T> types, Strict type guards
Processing	Фильтрация и приоритизация	Priority evaluator, Channel selector, Quiet hours checker
Delivery	Отправка в каналы	Email sender, SSE broadcaster, Telegram client
Presentation	Отображение пользователю	Inbox UI, Email templates, Telegram markdown

Совет

Система использует strict typing — все события имеют строго определённые TypeScript интерфейсы без использования Record<string, unknown>.

Каналы доставки

Email

Уведомления на почту, привязанную к аккаунту:

• HTML письма с брендированным дизайном
• Категорийные шаблоны (деплои, биллинг, безопасность)
• Приоритетные индикаторы (иконки для critical/high)

In-App

Уведомления внутри платформы:

• Real-time доставка через SSE
• Inbox с историей уведомлений
• Индикатор непрочитанных (blue dot)
• Архивация и удаление

Telegram

Уведомления в Telegram через бота ONREZA:

• Мгновенная доставка
• Поддержка форматирования (жирный, ссылки)
• Кнопки быстрых действий

Заметка

Канал Telegram доступен только для пользователей, вошедших через Telegram. При входе через Telegram канал включается автоматически вместо Email.

Категории уведомлений

Категория	Описание	Примеры
Deployment	События деплоев	Сборка завершена, деплой live, ошибка
Health	Здоровье приложений	Health check failed, восстановление
Billing	Платежи и подписки	Оплата прошла, лимит превышен
Security	Безопасность аккаунта	Новый вход, подозрительная активность, API ключи
System	Системные события	Плановые работы, новые функции

События Security

Событие	Приоритет	Описание
security.new_login	Normal	Новый вход в аккаунт
security.suspicious_activity	Critical	Подозрительная активность обнаружена
security.api_key_created	Normal	Создан новый API ключ
security.api_key_revoked	High	API ключ отозван
security.api_key_expired	High	API ключ истёк
security.api_key_expiring_soon	Normal	API ключ истекает через 7 дней
security.password_changed	Critical	Пароль аккаунта изменён
security.mfa_enabled	Normal	Двухфакторная аутентификация включена
security.mfa_disabled	Critical	Двухфакторная аутентификация отключена

Приоритеты

Система использует 4 уровня приоритета для классификации важности уведомлений:

Приоритет	Значение	Описание	Поведение
CRITICAL	0	Критические события	Всегда отправляются на все каналы, игнорируют quiet hours
HIGH	1	Важные события	Отправляются даже в quiet hours (кроме email), требуют внимания
NORMAL	2	Стандартные события	Отправляются согласно настройкам пользователя
LOW	3	Информационные	Могут быть отфильтрованы, не требуют немедленного действия

// Strict typing для приоритетов
enum NotificationPriority {
  CRITICAL = 0,
  HIGH = 1,
  NORMAL = 2,
  LOW = 3,
}

Заметка

Critical уведомления (ошибки сборки, подозрительная активность, изменение пароля) всегда доставляются независимо от ваших настроек.

Настройка каналов

Account → Settings → Notifications → Channels

1. Выберите канал

   Email, In-App или Telegram (если доступен)

2. Включите/выключите

   Toggle для активации канала

3. Сохраните

   Изменения применяются сразу

Осторожно

Отключение всех каналов не рекомендуется — вы можете пропустить критически важные уведомления.

Настройка по категориям

Account → Settings → Notifications → Preferences

Для каждой категории можно настроить:

Настройка	Описание
Каналы	Какие каналы использовать для этой категории
Минимальный приоритет	Отправлять только уведомления с приоритетом >=
Quiet Hours	Время, когда email не отправляется (только In-App)

Пример настройки

Deployment:
  Каналы: Email, In-App
  Мин. приоритет: NORMAL
  Quiet Hours: 22:00 - 08:00

Billing:
  Каналы: Email, In-App
  Мин. приоритет: NORMAL
  Quiet Hours: —

Security:
  Каналы: Email, In-App
  Мин. приоритет: LOW
  Quiet Hours: —

Health:
  Каналы: Email, In-App
  Мин. приоритет: HIGH
  Quiet Hours: —

Quiet Hours (Тихие часы)

Email уведомления не отправляются в указанный период:

• Время указывается в UTC
• In-App уведомления продолжают приходить
• CRITICAL уведомления игнорируют quiet hours

1. Откройте настройки категории
2. Включите “Quiet Hours”
3. Укажите время начала и конца
4. Сохраните

Inbox

В правом верхнем углу интерфейса находится иконка уведомлений:

• Blue dot — есть непрочитанные
• Число — количество непрочитанных

Возможности Inbox:

• Просмотр истории уведомлений
• Отметка как прочитанное (клик)
• Архивация (смахивание или кнопка)
• Удаление
• Переход по action URL

События деплоев

Событие	Приоритет	Описание
deployment.started	LOW	Деплой запущен
deployment.building	LOW	Сборка началась
deployment.build_success	LOW	Сборка успешна
deployment.build_failed	CRITICAL	Ошибка сборки
deployment.deploying	LOW	Развёртывание
deployment.live	NORMAL	Деплой активен
deployment.failed	CRITICAL	Ошибка деплоя
deployment.stopped	NORMAL	Деплой остановлен
deployment.rolled_back	NORMAL	Откат выполнен

События биллинга

Событие	Приоритет	Описание
billing.payment_succeeded	NORMAL	Платёж прошёл
billing.payment_failed	CRITICAL	Ошибка платежа
billing.invoice_created	LOW	Счёт создан
billing.invoice_paid	NORMAL	Счёт оплачен
billing.invoice_overdue	HIGH	Счёт просрочен
billing.trial_ending_soon	HIGH	Trial заканчивается
billing.trial_ended	HIGH	Trial закончился
billing.limit_approaching	NORMAL	Приближение к лимиту
billing.limit_exceeded	HIGH	Лимит превышен
billing.subscription_cancelled	NORMAL	Подписка отменена
billing.subscription_suspended	CRITICAL	Подписка приостановлена
billing.card_expiring_soon	HIGH	Карта скоро истечёт
billing.card_expired	CRITICAL	Карта истекла

События здоровья

Событие	Приоритет	Описание
health.check_failed	HIGH	Health check не прошёл
health.recovered	NORMAL	Приложение восстановлено
health.degraded	HIGH	Производительность деградировала
health.unavailable	CRITICAL	Приложение недоступно

Системные события

Событие	Приоритет	Описание
system.maintenance_scheduled	NORMAL	Плановые работы
system.feature_announcement	LOW	Новые функции

API

Получить уведомления

GET /v1/notifications?archived=false&limit=20

Query параметры:

• archived — true для архива, false для inbox
• unreadOnly — только непрочитанные
• category — фильтр по категории
• priority — фильтр по приоритету (CRITICAL, HIGH, NORMAL, LOW)
• limit, offset — пагинация

Проверить непрочитанные

GET /v1/notifications/has-unread

Возвращает { hasUnread: true/false } — используется для blue dot.

Пометить как прочитанное

POST /v1/notifications/:id/read

Архивировать

POST /v1/notifications/:id/archive

Архивировать все

POST /v1/notifications/archive-all

Удалить

DELETE /v1/notifications/:id

Настройки каналов

GET /v1/notifications/preferences
PUT /v1/notifications/preferences/channel
PUT /v1/notifications/preferences/category

Real-time уведомления

In-App уведомления доставляются мгновенно через SSE:

GET /v1/notifications/stream

Клиент автоматически подключается при загрузке страницы. При потере соединения — автоматическое переподключение.

Дефолтные настройки

При регистрации устанавливаются настройки в зависимости от способа входа:

Email регистрация:

Категория	Каналы	Мин. приоритет
Deployment	Email, In-App	NORMAL
Health	Email, In-App	HIGH
Billing	Email, In-App	NORMAL
Security	Email, In-App	LOW
System	Email, In-App	NORMAL

Telegram регистрация:

Категория	Каналы	Мин. приоритет
Deployment	Telegram, In-App	NORMAL
Health	Telegram, In-App	HIGH
Billing	Telegram, In-App	NORMAL
Security	Telegram, In-App	LOW
System	Telegram, In-App	NORMAL

Совет

Security имеет минимальный порог LOW — вы получите все уведомления о безопасности. Health имеет HIGH — только важные события мониторинга.

Troubleshooting

Не приходят email уведомления

1. Проверьте папку спам
2. Проверьте что канал Email включён
3. Проверьте настройки категории — возможно фильтр по приоритету
4. Проверьте quiet hours — возможно сейчас тихие часы

Не вижу уведомления в Inbox

1. Проверьте что канал In-App включён
2. Обновите страницу
3. Проверьте фильтр категорий в настройках

Слишком много уведомлений

1. Повысьте минимальный приоритет для шумных категорий
2. Отключите канал Email для информационных событий
3. Настройте quiet hours для ночного времени

См. также

• API Tokens — управление токенами
• Настройки — обзор настроек аккаунта