Skip to content

Notifications

Доставка уведомлений пользователям. MVP: email через SMTP, domain events из NATS, per-user preferences.

Порты

ПортНазначение
8103HTTP REST (PM2)
18103Docker host
  • БД: notifications_db
  • Gateway: /proxy/notifications/

Назначение

  • CRUD SMTP-подключений (пароли at-rest, ENCRYPTION_KEY)
  • Файловые шаблоны (templates/, HTML + subject)
  • POST /api/v1/send → 202 + async NATS notifications.send
  • Каталог типов уведомлений + user prefs (вкл/выкл по типу)
  • Domain subscriber: NATS subject → prefs → email

API

Admin / user JWT. S2S: POST /api/v1/send с Service token.

Swagger: /swagger/index.html

Domain events (примеры)

SubjectТип уведомления
user.createdidentity.welcome
spaces.sharedspace.invited
tasks.*assigned / status / watcher
command_request.*approval flow
job.changedjob completed / failed
messaging.comment.createdcomment.mention, comment.reply
guard.incident.createdsecurity.dlp_incident
ai.chat.dlp.warningsecurity.dlp_warning

Полный список — в subscriber и каталоге notifytypes.

Env

ПеременнаяНазначение
AUTH_SERVICE_URLРезолв email пользователя
ENCRYPTION_KEYSMTP-пароли at-rest
TEMPLATES_DIR./templates
WEB_BASE_URLСсылки в письмах

UI

  • Admin: Settings → Notifications (SMTP, templates, alerts)
  • User: User settings → Notifications (prefs)