For AI agents: fetch the complete documentation index at /llms.txt, the full documentation corpus at /llms-full.txt, the agent skill at /skill.md, or this page as Markdown at /ru/docs/tanstack/notifications.md (or send Accept: text/markdown).
Уведомления
Внутрипродуктовые оповещения, пользовательские настройки и объявления администратора.
Прохождение для начинающих
Предварительные требования: прочтите два приведенных ниже руководства для начинающих, завершите локальную веб-настройку и откройте этот монорепозиторий в корневой папке вашего редактора. Веб-настройки принадлежат apps/web-tanstack/.env.local; TanStack Start не читает корень .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/; проверьте точные исходные файлы, указанные здесь; список файлов и проверки перед редактированием; сохранять права собственности на рабочую область и секреты, доступные только серверу; и покажу вам разницу. Сообщите ему желаемое поведение, поля ввода и вывода, разрешенные роли, ожидаемые успехи и ошибки, а также тестовую учетную запись, поставщика или устройство. Используйте выборочные значения; никогда не вставляйте настоящий секрет.
Используйте конвейер событий продукта
notification-events.ts сопоставляет выставление счетов, бюджет, приглашения, членство и события подключенной учетной записи с локализованными копиями и планами доставки для каждого участника. Клиенты API и приложений читают уведомления рабочей области, в которой выполнен вход; предпочтения контролируют подходящие каналы.
Некоторые события намеренно остаются в приложении. Например, сбои обновления подключенной учетной записи не должны раскрывать сведения о токене или вызывать нежелательную электронную почту.
Уважайте предпочтения получателя
Используйте существующий планировщик доставки, настройки по умолчанию и параметры исключения участников вместо того, чтобы самостоятельно отправлять сообщение каждому участнику. Транзакционная электронная почта по-прежнему использует настроенного поставщика и записывает собственный результат доставки.
Проверьте получателей и укажите
Проверьте отключенное предпочтение, исключенного актера, удаленного участника, поведение непрочитанного/прочитанного и другое рабочее пространство. Обеспечьте доступность динамических обновлений и проверяйте локализованные сообщения.
Настройка и конфигурация
Сервис уведомлений (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 уведомлений вне критического пути запроса.