ВозможностиОрганизации
Документация
    Ring Platform

    Децентрализованное самостроящееся будущее

    Войти
    Организации
    Возможности
    Магазин
    Документация
    Концепции платформы
    RING ЭкономикаSonoratek LLCГлобальное влияниеAI встречает Web3
    Начать
    Быстрый стартКалькуляторДорожная карта
    Конфиденциальность|Контакты
    v1.106.29|Sonoratek LLC

    Documentation

    Концепции, ценность и типичные сценарии клонирования — меньше кода.

    Добро пожаловать в Ring
    Краткий справочник
    С чего начать
    Предварительные требования
    Установка
    Первый успех
    Следующие шаги
    Функции
    Store
    Склад и остатки
    Управление вендорами
    Комиссии и расчёты
    Членство и кредиты
    SubscriptionConductor
    PaymentConductor
    Ring Oracle
    Интеграция платежей
    Интеграция WayForPay
    Web3 Кошелек
    WalletConductor
    Реферальные коды (Refcodes)
    Шторка страницы
    NFT Exhibition Marketplace
    Система Стейкинга Токенов
    Организации
    Возможности
    AI Matcher
    Messaging
    Peer Games
    News
    Блоги участников
    Система Резервирования Имён Пользователей
    Научный редактор
    Уведомления
    Push-уведомления через FCM (Ring)
    Email AI-CRM
    Ring Mailer и RingdomX Mail
    Протокол Tunnel
    Authentication
    Безопасность и соответствие
    Система локалей
    Мобильный Опыт
    Паттерны Оптимизации Производительности
    Примеры
    Quick Start
    Базовая настройка
    White Label
    Custom Branding
    Интеграция Web3
    Реальные Проекты
    Advanced Features
    Кастомизация
    Быстрый старт — ваш первый клон Ring
    Руководство по кастомизации
    Vertical Presets (SSOT)
    Руководство по Ringization
    Branding
    Темы оформления
    Features
    Localization
    Настройка токеномики
    Интеграция платёжного шлюза
    Референсные деплои Ring
    Конфигурация проекта
    Публичные переменные окружения
    Секреты Order Lab
    Project ID WalletConnect (Reown Cloud)
    Поддерживаемые сервисы
    Вики NODUS (знания проекта)
    Плейбук конфигурации
    Web3
    Token launch jurisdictions
    Кошелёк
    Советы по безопасности кошелька
    Интеграции
    Ethereum-кошельки (Wagmi v3)
    Развёртывание
    Развёртывание на собственном сервере
    Vercel
    Docker
    Конфигурация Окружения
    Мониторинг и аналитика
    Оптимизация производительности
    Резервное копирование и восстановление
    Архитектура
    Data Model
    Security
    Real Time
    Discovery Mutation Sync
    Архитектура PaymentConductor
    Wallet Conductor
    Архитектура News Kingdom
    Бекенд Сервисы
    Интеграция Firebase
    Разработка
    Ring MCP Server
    OSS и enterprise

    Быстрый вход (CTO · аудиторы · агенты)

    Приветствие — миссия и аудитории
    Краткий справочник
    С чего начать
    Архитектура и Auth.js
    Режимы бэкенда и базы данных (DB_BACKEND_MODE)
    Self-hosted
    Ring MCP Tools
    Ring MCP Server
    Token economics
    Token launch jurisdictions
    Деплой (Docker · k8s)
    Безопасность и соответствие требованиям
    ringdom.org — база LegioX
    Исходный код — лицензия MIT (GitHub)

    Documentation

    Концепции, ценность и типичные сценарии клонирования — меньше кода.

    Добро пожаловать в Ring
    Краткий справочник
    С чего начать
    Предварительные требования
    Установка
    Первый успех
    Следующие шаги
    Функции
    Store
    Склад и остатки
    Управление вендорами
    Комиссии и расчёты
    Членство и кредиты
    SubscriptionConductor
    PaymentConductor
    Ring Oracle
    Интеграция платежей
    Интеграция WayForPay
    Web3 Кошелек
    WalletConductor
    Реферальные коды (Refcodes)
    Шторка страницы
    NFT Exhibition Marketplace
    Система Стейкинга Токенов
    Организации
    Возможности
    AI Matcher
    Messaging
    Peer Games
    News
    Блоги участников
    Система Резервирования Имён Пользователей
    Научный редактор
    Уведомления
    Push-уведомления через FCM (Ring)
    Email AI-CRM
    Ring Mailer и RingdomX Mail
    Протокол Tunnel
    Authentication
    Безопасность и соответствие
    Система локалей
    Мобильный Опыт
    Паттерны Оптимизации Производительности
    Примеры
    Quick Start
    Базовая настройка
    White Label
    Custom Branding
    Интеграция Web3
    Реальные Проекты
    Advanced Features
    Кастомизация
    Быстрый старт — ваш первый клон Ring
    Руководство по кастомизации
    Vertical Presets (SSOT)
    Руководство по Ringization
    Branding
    Темы оформления
    Features
    Localization
    Настройка токеномики
    Интеграция платёжного шлюза
    Референсные деплои Ring
    Конфигурация проекта
    Публичные переменные окружения
    Секреты Order Lab
    Project ID WalletConnect (Reown Cloud)
    Поддерживаемые сервисы
    Вики NODUS (знания проекта)
    Плейбук конфигурации
    Web3
    Token launch jurisdictions
    Кошелёк
    Советы по безопасности кошелька
    Интеграции
    Ethereum-кошельки (Wagmi v3)
    Развёртывание
    Развёртывание на собственном сервере
    Vercel
    Docker
    Конфигурация Окружения
    Мониторинг и аналитика
    Оптимизация производительности
    Резервное копирование и восстановление
    Архитектура
    Data Model
    Security
    Real Time
    Discovery Mutation Sync
    Архитектура PaymentConductor
    Wallet Conductor
    Архитектура News Kingdom
    Бекенд Сервисы
    Интеграция Firebase
    Разработка
    Ring MCP Server
    OSS и enterprise

    Быстрый вход (CTO · аудиторы · агенты)

    Приветствие — миссия и аудитории
    Краткий справочник
    С чего начать
    Архитектура и Auth.js
    Режимы бэкенда и базы данных (DB_BACKEND_MODE)
    Self-hosted
    Ring MCP Tools
    Ring MCP Server
    Token economics
    Token launch jurisdictions
    Деплой (Docker · k8s)
    Безопасность и соответствие требованиям
    ringdom.org — база LegioX
    Исходный код — лицензия MIT (GitHub)

    Documentation

    Концепции, ценность и типичные сценарии клонирования — меньше кода.

    Добро пожаловать в Ring
    Краткий справочник
    С чего начать
    Предварительные требования
    Установка
    Первый успех
    Следующие шаги
    Функции
    Store
    Склад и остатки
    Управление вендорами
    Комиссии и расчёты
    Членство и кредиты
    SubscriptionConductor
    PaymentConductor
    Ring Oracle
    Интеграция платежей
    Интеграция WayForPay
    Web3 Кошелек
    WalletConductor
    Реферальные коды (Refcodes)
    Шторка страницы
    NFT Exhibition Marketplace
    Система Стейкинга Токенов
    Организации
    Возможности
    AI Matcher
    Messaging
    Peer Games
    News
    Блоги участников
    Система Резервирования Имён Пользователей
    Научный редактор
    Уведомления
    Push-уведомления через FCM (Ring)
    Email AI-CRM
    Ring Mailer и RingdomX Mail
    Протокол Tunnel
    Authentication
    Безопасность и соответствие
    Система локалей
    Мобильный Опыт
    Паттерны Оптимизации Производительности
    Примеры
    Quick Start
    Базовая настройка
    White Label
    Custom Branding
    Интеграция Web3
    Реальные Проекты
    Advanced Features
    Кастомизация
    Быстрый старт — ваш первый клон Ring
    Руководство по кастомизации
    Vertical Presets (SSOT)
    Руководство по Ringization
    Branding
    Темы оформления
    Features
    Localization
    Настройка токеномики
    Интеграция платёжного шлюза
    Референсные деплои Ring
    Конфигурация проекта
    Публичные переменные окружения
    Секреты Order Lab
    Project ID WalletConnect (Reown Cloud)
    Поддерживаемые сервисы
    Вики NODUS (знания проекта)
    Плейбук конфигурации
    Web3
    Token launch jurisdictions
    Кошелёк
    Советы по безопасности кошелька
    Интеграции
    Ethereum-кошельки (Wagmi v3)
    Развёртывание
    Развёртывание на собственном сервере
    Vercel
    Docker
    Конфигурация Окружения
    Мониторинг и аналитика
    Оптимизация производительности
    Резервное копирование и восстановление
    Архитектура
    Data Model
    Security
    Real Time
    Discovery Mutation Sync
    Архитектура PaymentConductor
    Wallet Conductor
    Архитектура News Kingdom
    Бекенд Сервисы
    Интеграция Firebase
    Разработка
    Ring MCP Server
    OSS и enterprise

    Быстрый вход (CTO · аудиторы · агенты)

    Приветствие — миссия и аудитории
    Краткий справочник
    С чего начать
    Архитектура и Auth.js
    Режимы бэкенда и базы данных (DB_BACKEND_MODE)
    Self-hosted
    Ring MCP Tools
    Ring MCP Server
    Token economics
    Token launch jurisdictions
    Деплой (Docker · k8s)
    Безопасность и соответствие требованиям
    ringdom.org — база LegioX
    Исходный код — лицензия MIT (GitHub)
    Ring Logo

    Loading documentation...

    Preparing Ring content

    Ring Logo

    Loading documentation...

    Preparing Ring content

    Ring Logo

    Loading documentation...

    Preparing Ring content

    Уведомления

    Ring сообщает участникам о новых возможностях, сообщениях, приглашениях в организации, событиях кошелька, звонках и вызовах в играх. Каждое уведомление хранится один раз и доставляется по каналам, которые разрешил участник: ящик в приложении, push, email или SMS. Участники управляют этими каналами в настройках, включая окно тихих часов, которое теперь действительно отключает push и SMS ночью.

    Используйте вкладки Founder / Developer в боковой панели документации, чтобы отфильтровать эту страницу. Настройка push (сертификат Firebase, VAPID, главный экран iOS) описана на странице Push Notifications (FCM).

    Статус (2026-10-26): Тихие часы применяются на сервере. «Отметить все прочитанными» выполняется одним SQL-обновлением и больше не падает по тайм-ауту на больших ящиках. Открытая страница уведомлений применяет живые события ящика на месте вместо показа устаревших строк.

    РаньшеСейчас
    Тихие часы сохранялись в настройках, но push всё равно приходилиPUSH и SMS отбрасываются внутри окна, если уведомление не срочное
    «Отметить все прочитанными» выбирало до 1000 строк и обновляло их по однойОдин массовый UPDATE отмечает все непрочитанные строки и возвращает их количество
    После отметки всех прочитанными список ещё показывал старые непрочитанныеЛента перезагружается после успеха, а живые события read_all её очищают
    Клиенты long-poll прерывали каждый пустой опрос через 15 секундТайм-аут long-poll составляет 30 секунд, больше 20-секундного удержания на сервере

    Почему это важно для вашего сообщества

    Уведомления возвращают участников. Слишком мало, и возможности остаются без ответа; слишком много в 3 часа ночи, и участники отключают push навсегда. Тихие часы позволяют оставить push включённым и не просыпаться, а срочное переопределение сохраняет работу таких вещей, как оповещение о входящем звонке.

    Доставка push

    Push в Chrome, Android и на главном экране iOS, одна доставка на устройство.

    Сообщения

    Сообщения чата, звонки и приглашения в игры создают типизированные уведомления.

    Возможности

    AI Matcher уведомляет участников, подходящих под новое объявление.

    Типичные сценарии

    • Участник задаёт тихие часы с 22:00 до 08:00 по киевскому времени. Уведомление о совпадении, созданное в 23:30, всё равно попадает в ящик в приложении и на email, но телефон не вибрирует от push. Утром колокольчик показывает его как непрочитанное.

    Проверенные типы уведомлений (частично)

    ТипНазначение
    OPPORTUNITYНовые возможности и заявки
    MESSAGEНовые сообщения и разговоры
    ENTITYОбновления организаций и приглашения
    SYSTEMОбъявления платформы
    WALLETУведомления о транзакциях и балансе
    GAME_REQUEST, GAME_UPDATEDВызовы в играх и обновления сессий. См. Peer Games
    CALL_INVITEВходящий звонок WebRTC, когда вкладка адресата скрыта или закрыта

    Определение каналов

    Related documentation

    Push Notifications with FCM (Ring-Powered)

    Подробно: рассылка FCM и Web Push на каждое устройство.

    Notifications API

    Тот же процесс: REST-маршруты и payload настроек, включая quietHours.

    Tunnel Protocol

    Зависит от: живой рассылки ящика по каналам notifications.

    WebRTC Calls & STUNner TURN

    См. также: CALL_INVITE использует канал PUSH.

    Real-Time Messaging

    1. Документация
    2. /Функции
    3. /Уведомления

    Обновлено 26 окт. 2026 г.5 мин прослушивания

    Уведомления

    Ring сообщает участникам о новых возможностях, сообщениях, приглашениях в организации, событиях кошелька, звонках и вызовах в играх. Каждое уведомление хранится один раз и доставляется по каналам, которые разрешил участник: ящик в приложении, push, email или SMS. Участники управляют этими каналами в настройках, включая окно тихих часов, которое теперь действительно отключает push и SMS ночью.

    Используйте вкладки Founder / Developer в боковой панели документации, чтобы отфильтровать эту страницу. Настройка push (сертификат Firebase, VAPID, главный экран iOS) описана на странице Push Notifications (FCM).

    Статус (2026-10-26): Тихие часы применяются на сервере. «Отметить все прочитанными» выполняется одним SQL-обновлением и больше не падает по тайм-ауту на больших ящиках. Открытая страница уведомлений применяет живые события ящика на месте вместо показа устаревших строк.

    РаньшеСейчас
    Тихие часы сохранялись в настройках, но push всё равно приходилиPUSH и SMS отбрасываются внутри окна, если уведомление не срочное
    «Отметить все прочитанными» выбирало до 1000 строк и обновляло их по однойОдин массовый UPDATE отмечает все непрочитанные строки и возвращает их количество
    После отметки всех прочитанными список ещё показывал старые непрочитанныеЛента перезагружается после успеха, а живые события read_all её очищают
    Клиенты long-poll прерывали каждый пустой опрос через 15 секундТайм-аут long-poll составляет 30 секунд, больше 20-секундного удержания на сервере

    Почему это важно для вашего сообщества

    Уведомления возвращают участников. Слишком мало, и возможности остаются без ответа; слишком много в 3 часа ночи, и участники отключают push навсегда. Тихие часы позволяют оставить push включённым и не просыпаться, а срочное переопределение сохраняет работу таких вещей, как оповещение о входящем звонке.

    Доставка push

    Push в Chrome, Android и на главном экране iOS, одна доставка на устройство.

    Сообщения

    Сообщения чата, звонки и приглашения в игры создают типизированные уведомления.

    Возможности

    AI Matcher уведомляет участников, подходящих под новое объявление.

    Типичные сценарии

    • Участник задаёт тихие часы с 22:00 до 08:00 по киевскому времени. Уведомление о совпадении, созданное в 23:30, всё равно попадает в ящик в приложении и на email, но телефон не вибрирует от push. Утром колокольчик показывает его как непрочитанное.

    Проверенные типы уведомлений (частично)

    ТипНазначение
    OPPORTUNITYНовые возможности и заявки
    MESSAGEНовые сообщения и разговоры
    ENTITYОбновления организаций и приглашения
    SYSTEMОбъявления платформы
    WALLETУведомления о транзакциях и балансе
    GAME_REQUEST, GAME_UPDATEDВызовы в играх и обновления сессий. См. Peer Games
    CALL_INVITEВходящий звонок WebRTC, когда вкладка адресата скрыта или закрыта

    Определение каналов

    Related documentation

    Push Notifications with FCM (Ring-Powered)

    Подробно: рассылка FCM и Web Push на каждое устройство.

    Notifications API

    Тот же процесс: REST-маршруты и payload настроек, включая quietHours.

    Tunnel Protocol

    Зависит от: живой рассылки ящика по каналам notifications.

    WebRTC Calls & STUNner TURN

    См. также: CALL_INVITE использует канал PUSH.

    Real-Time Messaging

    1. Документация
    2. /Функции
    3. /Уведомления

    Обновлено 26 окт. 2026 г.5 мин прослушивания

    Уведомления

    Ring сообщает участникам о новых возможностях, сообщениях, приглашениях в организации, событиях кошелька, звонках и вызовах в играх. Каждое уведомление хранится один раз и доставляется по каналам, которые разрешил участник: ящик в приложении, push, email или SMS. Участники управляют этими каналами в настройках, включая окно тихих часов, которое теперь действительно отключает push и SMS ночью.

    Используйте вкладки Founder / Developer в боковой панели документации, чтобы отфильтровать эту страницу. Настройка push (сертификат Firebase, VAPID, главный экран iOS) описана на странице Push Notifications (FCM).

    Статус (2026-10-26): Тихие часы применяются на сервере. «Отметить все прочитанными» выполняется одним SQL-обновлением и больше не падает по тайм-ауту на больших ящиках. Открытая страница уведомлений применяет живые события ящика на месте вместо показа устаревших строк.

    РаньшеСейчас
    Тихие часы сохранялись в настройках, но push всё равно приходилиPUSH и SMS отбрасываются внутри окна, если уведомление не срочное
    «Отметить все прочитанными» выбирало до 1000 строк и обновляло их по однойОдин массовый UPDATE отмечает все непрочитанные строки и возвращает их количество
    После отметки всех прочитанными список ещё показывал старые непрочитанныеЛента перезагружается после успеха, а живые события read_all её очищают
    Клиенты long-poll прерывали каждый пустой опрос через 15 секундТайм-аут long-poll составляет 30 секунд, больше 20-секундного удержания на сервере

    Почему это важно для вашего сообщества

    Уведомления возвращают участников. Слишком мало, и возможности остаются без ответа; слишком много в 3 часа ночи, и участники отключают push навсегда. Тихие часы позволяют оставить push включённым и не просыпаться, а срочное переопределение сохраняет работу таких вещей, как оповещение о входящем звонке.

    Доставка push

    Push в Chrome, Android и на главном экране iOS, одна доставка на устройство.

    Сообщения

    Сообщения чата, звонки и приглашения в игры создают типизированные уведомления.

    Возможности

    AI Matcher уведомляет участников, подходящих под новое объявление.

    Типичные сценарии

    • Участник задаёт тихие часы с 22:00 до 08:00 по киевскому времени. Уведомление о совпадении, созданное в 23:30, всё равно попадает в ящик в приложении и на email, но телефон не вибрирует от push. Утром колокольчик показывает его как непрочитанное.

    Проверенные типы уведомлений (частично)

    ТипНазначение
    OPPORTUNITYНовые возможности и заявки
    MESSAGEНовые сообщения и разговоры
    ENTITYОбновления организаций и приглашения
    SYSTEMОбъявления платформы
    WALLETУведомления о транзакциях и балансе
    GAME_REQUEST, GAME_UPDATEDВызовы в играх и обновления сессий. См. Peer Games
    CALL_INVITEВходящий звонок WebRTC, когда вкладка адресата скрыта или закрыта

    Определение каналов

    Related documentation

    Push Notifications with FCM (Ring-Powered)

    Подробно: рассылка FCM и Web Push на каждое устройство.

    Notifications API

    Тот же процесс: REST-маршруты и payload настроек, включая quietHours.

    Tunnel Protocol

    Зависит от: живой рассылки ящика по каналам notifications.

    WebRTC Calls & STUNner TURN

    См. также: CALL_INVITE использует канал PUSH.

    Real-Time Messaging

    1. Документация
    2. /Функции
    3. /Уведомления

    Обновлено 26 окт. 2026 г.5 мин прослушивания

  1. Занятой продавец с тысячами непрочитанных нажимает «Отметить все прочитанными». Это выполняется одним запросом, и список сразу очищается.
  2. Открыты две вкладки. Прочтение уведомления в одной вкладке отмечает его прочитанным в другой без обновления.
  3. Как одно уведомление доходит до участника

    createNotification в features/notifications/services/notification-service.ts один раз загружает настройки пользователя, затем вызывает determineChannels(requested, preferences, priority) из features/notifications/lib/determine-channels.ts. Доставки строятся из этого списка, поэтому отключённый PUSH никогда не доходит до FCM.

    ШагПравило
    Нет строки настроекIN_APP всегда, плюс PUSH, если его запросил вызывающий
    Сохранённые настройкиУчитываются отказы channels.push и inApp
    Тихие часыsuppressQuietChannels убирает PUSH и SMS, когда isWithinQuietHours равно true, а приоритет не URGENT. IN_APP и EMAIL остаются

    Контракт тихих часов

    Настройки хранят quietHours: { enabled, startTime, endTime, timezone } со временем в формате HH:mm.

    • Текущее время переводится в IANA timezone участника (запасной вариант UTC).
    • Время окончания не включается. Начало позже конца, например 22:00 до 08:00, означает ночное окно.
    • При ошибке проверка открыта: выключено, отсутствующее или некорректное время, одинаковые начало и конец или нечитаемая зона означают «не тихо».
    • Приоритет по умолчанию NORMAL, если вызывающий его не указал. Отправляйте URGENT для всего, что должно прерывать.

    Ящик и состояние прочтения

    ЧастьПутьПоведение
    HTTP отметки всех прочитаннымиapp/api/notifications/read-allВызывает markAllNotificationsAsRead
    Массовое обновлениеnotification-service.tsОдин UPDATE notifications ... WHERE data->>'user_id' = $1 AND data->>'read_at' IS NULL через getSharedPgPool, затем публикует количество непрочитанных
    Живое обновлениеfeatures/notifications/lib/apply-inbox-to-feed.tsПрименяет payload туннеля notification, read, read_all и delete к строкам на экране с учётом активного фильтра типа
    UI спискаfeatures/notifications/components/notification-list.tsxИспользует applyInboxToFeed для живых событий и перезагружает курсорную ленту после отметки всех прочитанными

    Массовое обновление использует сырой SQL на JSONB-таблице notifications, поэтому работает на бэкендах PostgreSQL (k8s-postgres-fcm, supabase-fcm).

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

    • В приложении: Tunnel notifications:inbox и UI колокольчика. На long polling в стиле Vercel lib/tunnel/config.ts задаёт тайм-аут клиента 30 секунд, потому что /api/tunnel/poll удерживает пустые опросы до 20 секунд.
    • Push: токены FCM (fcm_tokens) плюс RFC Web Push (push_subscriptions). См. Push Notifications (FCM).
    • Email и SMS: в зависимости от настроек там, где подключено.

    Частые вопросы

    Влияние

    Теряют ли участники уведомления во время тихих часов?

    Нет. Пропускаются только push и SMS. Уведомление всё равно сохраняется, показывается в ящике и отправляется по email, если email включён.

    Миграция

    Нужна ли миграция для массовой отметки прочитанными?

    Нет. Используется существующая таблица notifications. Старые клоны на firebase-full не должны полагаться на этот путь.

    Эксплуатация

    Почему push пришёл ночью?

    Проверьте, сохранил ли участник тихие часы с корректной зоной и использовал ли отправитель приоритет URGENT, который по замыслу обходит окно.

    См. также: интерактивные оповещения, создающие типизированные уведомления.

    Page Curtain

    См. также: другая подсказка на странице, которую видят участники, со своими правилами закрытия.

  4. Занятой продавец с тысячами непрочитанных нажимает «Отметить все прочитанными». Это выполняется одним запросом, и список сразу очищается.
  5. Открыты две вкладки. Прочтение уведомления в одной вкладке отмечает его прочитанным в другой без обновления.
  6. Как одно уведомление доходит до участника

    createNotification в features/notifications/services/notification-service.ts один раз загружает настройки пользователя, затем вызывает determineChannels(requested, preferences, priority) из features/notifications/lib/determine-channels.ts. Доставки строятся из этого списка, поэтому отключённый PUSH никогда не доходит до FCM.

    ШагПравило
    Нет строки настроекIN_APP всегда, плюс PUSH, если его запросил вызывающий
    Сохранённые настройкиУчитываются отказы channels.push и inApp
    Тихие часыsuppressQuietChannels убирает PUSH и SMS, когда isWithinQuietHours равно true, а приоритет не URGENT. IN_APP и EMAIL остаются

    Контракт тихих часов

    Настройки хранят quietHours: { enabled, startTime, endTime, timezone } со временем в формате HH:mm.

    • Текущее время переводится в IANA timezone участника (запасной вариант UTC).
    • Время окончания не включается. Начало позже конца, например 22:00 до 08:00, означает ночное окно.
    • При ошибке проверка открыта: выключено, отсутствующее или некорректное время, одинаковые начало и конец или нечитаемая зона означают «не тихо».
    • Приоритет по умолчанию NORMAL, если вызывающий его не указал. Отправляйте URGENT для всего, что должно прерывать.

    Ящик и состояние прочтения

    ЧастьПутьПоведение
    HTTP отметки всех прочитаннымиapp/api/notifications/read-allВызывает markAllNotificationsAsRead
    Массовое обновлениеnotification-service.tsОдин UPDATE notifications ... WHERE data->>'user_id' = $1 AND data->>'read_at' IS NULL через getSharedPgPool, затем публикует количество непрочитанных
    Живое обновлениеfeatures/notifications/lib/apply-inbox-to-feed.tsПрименяет payload туннеля notification, read, read_all и delete к строкам на экране с учётом активного фильтра типа
    UI спискаfeatures/notifications/components/notification-list.tsxИспользует applyInboxToFeed для живых событий и перезагружает курсорную ленту после отметки всех прочитанными

    Массовое обновление использует сырой SQL на JSONB-таблице notifications, поэтому работает на бэкендах PostgreSQL (k8s-postgres-fcm, supabase-fcm).

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

    • В приложении: Tunnel notifications:inbox и UI колокольчика. На long polling в стиле Vercel lib/tunnel/config.ts задаёт тайм-аут клиента 30 секунд, потому что /api/tunnel/poll удерживает пустые опросы до 20 секунд.
    • Push: токены FCM (fcm_tokens) плюс RFC Web Push (push_subscriptions). См. Push Notifications (FCM).
    • Email и SMS: в зависимости от настроек там, где подключено.

    Частые вопросы

    Влияние

    Теряют ли участники уведомления во время тихих часов?

    Нет. Пропускаются только push и SMS. Уведомление всё равно сохраняется, показывается в ящике и отправляется по email, если email включён.

    Миграция

    Нужна ли миграция для массовой отметки прочитанными?

    Нет. Используется существующая таблица notifications. Старые клоны на firebase-full не должны полагаться на этот путь.

    Эксплуатация

    Почему push пришёл ночью?

    Проверьте, сохранил ли участник тихие часы с корректной зоной и использовал ли отправитель приоритет URGENT, который по замыслу обходит окно.

    См. также: интерактивные оповещения, создающие типизированные уведомления.

    Page Curtain

    См. также: другая подсказка на странице, которую видят участники, со своими правилами закрытия.

  7. Занятой продавец с тысячами непрочитанных нажимает «Отметить все прочитанными». Это выполняется одним запросом, и список сразу очищается.
  8. Открыты две вкладки. Прочтение уведомления в одной вкладке отмечает его прочитанным в другой без обновления.
  9. Как одно уведомление доходит до участника

    createNotification в features/notifications/services/notification-service.ts один раз загружает настройки пользователя, затем вызывает determineChannels(requested, preferences, priority) из features/notifications/lib/determine-channels.ts. Доставки строятся из этого списка, поэтому отключённый PUSH никогда не доходит до FCM.

    ШагПравило
    Нет строки настроекIN_APP всегда, плюс PUSH, если его запросил вызывающий
    Сохранённые настройкиУчитываются отказы channels.push и inApp
    Тихие часыsuppressQuietChannels убирает PUSH и SMS, когда isWithinQuietHours равно true, а приоритет не URGENT. IN_APP и EMAIL остаются

    Контракт тихих часов

    Настройки хранят quietHours: { enabled, startTime, endTime, timezone } со временем в формате HH:mm.

    • Текущее время переводится в IANA timezone участника (запасной вариант UTC).
    • Время окончания не включается. Начало позже конца, например 22:00 до 08:00, означает ночное окно.
    • При ошибке проверка открыта: выключено, отсутствующее или некорректное время, одинаковые начало и конец или нечитаемая зона означают «не тихо».
    • Приоритет по умолчанию NORMAL, если вызывающий его не указал. Отправляйте URGENT для всего, что должно прерывать.

    Ящик и состояние прочтения

    ЧастьПутьПоведение
    HTTP отметки всех прочитаннымиapp/api/notifications/read-allВызывает markAllNotificationsAsRead
    Массовое обновлениеnotification-service.tsОдин UPDATE notifications ... WHERE data->>'user_id' = $1 AND data->>'read_at' IS NULL через getSharedPgPool, затем публикует количество непрочитанных
    Живое обновлениеfeatures/notifications/lib/apply-inbox-to-feed.tsПрименяет payload туннеля notification, read, read_all и delete к строкам на экране с учётом активного фильтра типа
    UI спискаfeatures/notifications/components/notification-list.tsxИспользует applyInboxToFeed для живых событий и перезагружает курсорную ленту после отметки всех прочитанными

    Массовое обновление использует сырой SQL на JSONB-таблице notifications, поэтому работает на бэкендах PostgreSQL (k8s-postgres-fcm, supabase-fcm).

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

    • В приложении: Tunnel notifications:inbox и UI колокольчика. На long polling в стиле Vercel lib/tunnel/config.ts задаёт тайм-аут клиента 30 секунд, потому что /api/tunnel/poll удерживает пустые опросы до 20 секунд.
    • Push: токены FCM (fcm_tokens) плюс RFC Web Push (push_subscriptions). См. Push Notifications (FCM).
    • Email и SMS: в зависимости от настроек там, где подключено.

    Частые вопросы

    Влияние

    Теряют ли участники уведомления во время тихих часов?

    Нет. Пропускаются только push и SMS. Уведомление всё равно сохраняется, показывается в ящике и отправляется по email, если email включён.

    Миграция

    Нужна ли миграция для массовой отметки прочитанными?

    Нет. Используется существующая таблица notifications. Старые клоны на firebase-full не должны полагаться на этот путь.

    Эксплуатация

    Почему push пришёл ночью?

    Проверьте, сохранил ли участник тихие часы с корректной зоной и использовал ли отправитель приоритет URGENT, который по замыслу обходит окно.

    См. также: интерактивные оповещения, создающие типизированные уведомления.

    Page Curtain

    См. также: другая подсказка на странице, которую видят участники, со своими правилами закрытия.