> ## Documentation Index
> Fetch the complete documentation index at: https://supastack.dev/llms.txt
> Use this file to discover all available pages before exploring further.
> For the full documentation corpus in one file, fetch: https://supastack.dev/llms-full.txt

# Уведомления

Внутрипродуктовые оповещения, пользовательские настройки и объявления администратора.

## Прохождение для начинающих

Предварительные требования: прочтите два приведенных ниже руководства для начинающих, завершите локальную веб-настройку и откройте этот монорепозиторий в корневой папке вашего редактора. Веб-настройки принадлежат `apps/web/.env.local`; Next.js не читает корень `.env`. `/dashboard` в поддельном режиме по умолчанию представляет собой демонстрацию без базы данных; `/auth` требуется перенесенная база данных.

Вкратце: рабочее пространство — это отдельные пользователи, данные и настройки одной команды. Сервер является доверенным сервером; не допускайте попадания ключей провайдера в код браузера и телефона. Миграция — это изменение версии базы данных, при котором создаются или обновляются таблицы. Модель ИИ — это механизм, который отвечает; Каталог моделей — это список доступных идентификаторов моделей и цен на сервере. Поставщик — это внешняя служба, такая как служба искусственного интеллекта, электронной почты или службы выставления счетов. Право — это грант, который позволяет рабочей области использовать функцию. Вебхук — это сообщение, которое одна служба отправляет на URL другой службы.

1. Войдите в систему как участник тестирования и откройте «Настройки» → «Уведомления», чтобы просмотреть доступные настройки канала.

2. Используйте двух участников тестирования в одной рабочей области и инициируйте локальное тестовое событие, например приглашение, с помощью `EMAIL_PROVIDER=local`.

3. Убедитесь, что только соответствующие критериям участники и включенные каналы получают уведомление в приложении или локальном почтовом ящике. Не отправляйте тестовые сообщения реальным участникам.

Для пользовательского кода начните с предоставленного `prompts/README.md` и скопируйте ближайшее приглашение: `prompts/new-app-screen.md` для экрана приложения или `prompts/new-landing-page.md` для общедоступной страницы. Для работы с сервером, базой данных или провайдером дайте своему агенту кодирования задание из этого руководства и попросите его прочитать `AGENTS.md`, `.ai/PROJECT_CONTEXT.md` и соответствующие зеркала `.ai/`; проверьте точные исходные файлы, указанные здесь; список файлов и проверки перед редактированием; сохранять права собственности на рабочую область и секреты, доступные только серверу; и покажу вам разницу. Сообщите ему желаемое поведение, поля ввода и вывода, разрешенные роли, ожидаемые успехи и ошибки, а также тестовую учетную запись, поставщика или устройство. Используйте выборочные значения; никогда не вставляйте настоящий секрет.

[Прежде чем начать](https://supastack.dev/ru/docs/web/before-you-start.md)

[Основные сведения о терминале](https://supastack.dev/ru/docs/web/terminal-basics.md)

[Локальная веб-настройка](https://supastack.dev/ru/docs/web/ship-in-5-minutes.md)

[Подсказки агента и память проекта](https://supastack.dev/ru/docs/web/agents.md)


## Используйте конвейер событий продукта

`notification-events.ts` сопоставляет выставление счетов, бюджет, приглашения, членство и события подключенной учетной записи с локализованными копиями и планами доставки для каждого участника. Клиенты API и приложений читают уведомления рабочей области, в которой выполнен вход; предпочтения контролируют подходящие каналы.

Некоторые события намеренно остаются в приложении. Например, сбои обновления подключенной учетной записи не должны раскрывать сведения о токене или вызывать нежелательную электронную почту.


## Уважайте предпочтения получателя

Используйте существующий планировщик доставки, настройки по умолчанию и параметры исключения участников вместо того, чтобы самостоятельно отправлять сообщение каждому участнику. Транзакционная электронная почта по-прежнему использует настроенного поставщика и записывает собственный результат доставки.


## Проверьте получателей и укажите

Проверьте отключенное предпочтение, исключенного актера, удаленного участника, поведение непрочитанного/прочитанного и другое рабочее пространство. Обеспечьте доступность динамических обновлений и проверяйте локализованные сообщения.

[Доставка по электронной почте](https://supastack.dev/ru/docs/modules/email.md)

[Словари уведомлений](https://supastack.dev/ru/docs/web/i18n.md)


## Настройка и конфигурация

Сервис уведомлений (notification-service.ts) хранит записи in-app со scope пространства; GET /api/notifications перечисляет их для вошедшего участника, а маршрут mark-read обновляет состояние. Пользовательские флаги предпочтений управляют категориями вроде обновлений продукта и предупреждений безопасности.

Участники управляют предпочтениями в /settings/notifications. Платформенные объявления создаются через announcement-actions и доставляются тем же конвейером.

```
GET   /api/notifications
PATCH /api/notifications   (mark-read)

Emitted on mutations, e.g.:
  member.left
  member.role_changed
```


## Рабочий процесс внедрения

Эмитируйте уведомление после успешной мутации — никогда до фиксации записи. Держите полезные нагрузки структурированными (тип, пространство, ссылки), чтобы интерфейс мог рендерить и маршрутизировать их без парсинга прозы.

Проверяйте флаг предпочтения перед доставкой отключаемой категории; уведомления, важные для безопасности (новая сессия, смена ключей), должны оставаться обязательными.


## Проверка и устранение неполадок

Проверьте, что отключённое предпочтение подавляет доставку, что mark-read сохраняется между сессиями, что другое пространство не может перечислить записи и что объявления доходят до предполагаемых участников. По мере роста объёма держите fan-out уведомлений вне критического пути запроса.


## Вперёд

[Аккаунт и безопасность](https://supastack.dev/ru/docs/web/account.md)