ВозможностиОрганизации
Документация
    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


    title: Discovery Mutation Sync description: Как Ring сохраняет свежесть listings opportunity и entity после каждого изменения: cache, SSR и realtime для основателей и интеграторов last_modified: "2026-10-16" audience: both

    Discovery Mutation Sync

    Фильтруйте эту страницу вкладками Основатель / Разработчик в боковой панели документации. Основатели узнают почему listings остаются свежими; разработчики получают модули, события и точки расширения.

    Когда кто-то создаёт, редактирует или удаляет opportunity или entity на PostgreSQL-primary Ring-клоне, пользователи ожидают, что marketplace и directory обновятся сразу, без ночного reindex job. Ring координирует три лёгких шага на каждой мутации.

    Модель свежести из трёх шагов

    ШагЧто видят пользователиЧто происходит под капотом
    1. Cache bustСтраницы списков перестают показывать устаревшие карточкиrevalidateTag очищает role-scoped list caches
    2. Page refreshURL деталей и хабов показывают новые данные при следующей навигацииrevalidatePath инвалидирует App Router SSR
    3. Realtime pingОткрытые вкладки обновляются без ручной перезагрузкиTunnel публикует события opportunity:* / entity:*. Browse /opportunities подписывается молча (useRealtimeOpportunities); старая полоса «Live Updates Active / via websocket» убрана из списка. Detail (opportunity-details.tsx) по-прежнему показывает эту полосу.

    На Postgres-primary клонах строка базы и есть поисковый индекс. Отдельной таблицы Elasticsearch пересобирать не нужно: discovery-запросы читают JSONB напрямую (Модель данных).

    Почему это важно основателям

    Directory (entities) и marketplace of needs (opportunities) вашего клона: ядро цикла, вокруг которого большинство rings монетизируются. Устаревшие listings разрушают доверие быстрее, чем отсутствующая фича.

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

    Job board

    Участник публикует контракт: одобренные listings появляются на /opportunities, подписчики получают Tunnel-уведомления.

    Vendor directory

    Верифицированная entity обновляет showcase: страницы профиля и публичный directory обновляются без вмешательства ops.

    Follow-up AI matcher

    Новые opportunities запускают matcher-пайплайны; свежие cache tags гарантируют, что match-карточки ссылаются на актуальные поля budget и deadline.

    Архитектура

    Пайплайн sync после мутации

    Общий Tunnel-хелпер

    lib/discovery/sync-discovery.ts: только realtime fan-out (cache + paths живут в domain wrappers):

    КаналTunnel-события
    opportunitiesopportunity:created, opportunity:updated, opportunity:deleted
    entitiesentity:created, entity:updated, entity:deleted

    Domain wrappers

    РесурсМодульВызывается из
    Opportunities

    Связанная документация

    Related documentation

    Tunnel Protocol

    Prerequisite: channel subscribe SSOT и publishToChannel vs publishToUserTunnel.

    Real Time

    Deep-dive: брокер TunnelHub и матрица publish/subscribe фич.

    Data Model

    Depends-on: JSONB-коллекции, синхронизируемые этим пайплайном.

    Opportunities

    Same-workflow: browse feed гидрируется из list APIs и silent Tunnel inserts.

    Opportunities API

    1. Документация
    2. /Архитектура
    3. /Discovery Mutation Sync

    4 мин прослушивания


    title: Discovery Mutation Sync description: Как Ring сохраняет свежесть listings opportunity и entity после каждого изменения: cache, SSR и realtime для основателей и интеграторов last_modified: "2026-10-16" audience: both

    Discovery Mutation Sync

    Фильтруйте эту страницу вкладками Основатель / Разработчик в боковой панели документации. Основатели узнают почему listings остаются свежими; разработчики получают модули, события и точки расширения.

    Когда кто-то создаёт, редактирует или удаляет opportunity или entity на PostgreSQL-primary Ring-клоне, пользователи ожидают, что marketplace и directory обновятся сразу, без ночного reindex job. Ring координирует три лёгких шага на каждой мутации.

    Модель свежести из трёх шагов

    ШагЧто видят пользователиЧто происходит под капотом
    1. Cache bustСтраницы списков перестают показывать устаревшие карточкиrevalidateTag очищает role-scoped list caches
    2. Page refreshURL деталей и хабов показывают новые данные при следующей навигацииrevalidatePath инвалидирует App Router SSR
    3. Realtime pingОткрытые вкладки обновляются без ручной перезагрузкиTunnel публикует события opportunity:* / entity:*. Browse /opportunities подписывается молча (useRealtimeOpportunities); старая полоса «Live Updates Active / via websocket» убрана из списка. Detail (opportunity-details.tsx) по-прежнему показывает эту полосу.

    На Postgres-primary клонах строка базы и есть поисковый индекс. Отдельной таблицы Elasticsearch пересобирать не нужно: discovery-запросы читают JSONB напрямую (Модель данных).

    Почему это важно основателям

    Directory (entities) и marketplace of needs (opportunities) вашего клона: ядро цикла, вокруг которого большинство rings монетизируются. Устаревшие listings разрушают доверие быстрее, чем отсутствующая фича.

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

    Job board

    Участник публикует контракт: одобренные listings появляются на /opportunities, подписчики получают Tunnel-уведомления.

    Vendor directory

    Верифицированная entity обновляет showcase: страницы профиля и публичный directory обновляются без вмешательства ops.

    Follow-up AI matcher

    Новые opportunities запускают matcher-пайплайны; свежие cache tags гарантируют, что match-карточки ссылаются на актуальные поля budget и deadline.

    Архитектура

    Пайплайн sync после мутации

    Общий Tunnel-хелпер

    lib/discovery/sync-discovery.ts: только realtime fan-out (cache + paths живут в domain wrappers):

    КаналTunnel-события
    opportunitiesopportunity:created, opportunity:updated, opportunity:deleted
    entitiesentity:created, entity:updated, entity:deleted

    Domain wrappers

    РесурсМодульВызывается из
    Opportunities

    Связанная документация

    Related documentation

    Tunnel Protocol

    Prerequisite: channel subscribe SSOT и publishToChannel vs publishToUserTunnel.

    Real Time

    Deep-dive: брокер TunnelHub и матрица publish/subscribe фич.

    Data Model

    Depends-on: JSONB-коллекции, синхронизируемые этим пайплайном.

    Opportunities

    Same-workflow: browse feed гидрируется из list APIs и silent Tunnel inserts.

    Opportunities API

    1. Документация
    2. /Архитектура
    3. /Discovery Mutation Sync

    4 мин прослушивания


    title: Discovery Mutation Sync description: Как Ring сохраняет свежесть listings opportunity и entity после каждого изменения: cache, SSR и realtime для основателей и интеграторов last_modified: "2026-10-16" audience: both

    Discovery Mutation Sync

    Фильтруйте эту страницу вкладками Основатель / Разработчик в боковой панели документации. Основатели узнают почему listings остаются свежими; разработчики получают модули, события и точки расширения.

    Когда кто-то создаёт, редактирует или удаляет opportunity или entity на PostgreSQL-primary Ring-клоне, пользователи ожидают, что marketplace и directory обновятся сразу, без ночного reindex job. Ring координирует три лёгких шага на каждой мутации.

    Модель свежести из трёх шагов

    ШагЧто видят пользователиЧто происходит под капотом
    1. Cache bustСтраницы списков перестают показывать устаревшие карточкиrevalidateTag очищает role-scoped list caches
    2. Page refreshURL деталей и хабов показывают новые данные при следующей навигацииrevalidatePath инвалидирует App Router SSR
    3. Realtime pingОткрытые вкладки обновляются без ручной перезагрузкиTunnel публикует события opportunity:* / entity:*. Browse /opportunities подписывается молча (useRealtimeOpportunities); старая полоса «Live Updates Active / via websocket» убрана из списка. Detail (opportunity-details.tsx) по-прежнему показывает эту полосу.

    На Postgres-primary клонах строка базы и есть поисковый индекс. Отдельной таблицы Elasticsearch пересобирать не нужно: discovery-запросы читают JSONB напрямую (Модель данных).

    Почему это важно основателям

    Directory (entities) и marketplace of needs (opportunities) вашего клона: ядро цикла, вокруг которого большинство rings монетизируются. Устаревшие listings разрушают доверие быстрее, чем отсутствующая фича.

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

    Job board

    Участник публикует контракт: одобренные listings появляются на /opportunities, подписчики получают Tunnel-уведомления.

    Vendor directory

    Верифицированная entity обновляет showcase: страницы профиля и публичный directory обновляются без вмешательства ops.

    Follow-up AI matcher

    Новые opportunities запускают matcher-пайплайны; свежие cache tags гарантируют, что match-карточки ссылаются на актуальные поля budget и deadline.

    Архитектура

    Пайплайн sync после мутации

    Общий Tunnel-хелпер

    lib/discovery/sync-discovery.ts: только realtime fan-out (cache + paths живут в domain wrappers):

    КаналTunnel-события
    opportunitiesopportunity:created, opportunity:updated, opportunity:deleted
    entitiesentity:created, entity:updated, entity:deleted

    Domain wrappers

    РесурсМодульВызывается из
    Opportunities

    Связанная документация

    Related documentation

    Tunnel Protocol

    Prerequisite: channel subscribe SSOT и publishToChannel vs publishToUserTunnel.

    Real Time

    Deep-dive: брокер TunnelHub и матрица publish/subscribe фич.

    Data Model

    Depends-on: JSONB-коллекции, синхронизируемые этим пайплайном.

    Opportunities

    Same-workflow: browse feed гидрируется из list APIs и silent Tunnel inserts.

    Opportunities API

    1. Документация
    2. /Архитектура
    3. /Discovery Mutation Sync

    4 мин прослушивания

    Moderation workflow

    Потоки approve/reject админа вызывают тот же sync: смены статуса ведут себя как updates для подписчиков канала.

    Ожидания оператора

    • Нет ручного reindex CLI для стандартного CRUD: если списки выглядят устаревшими, сначала проверьте Tunnel transport и DB_BACKEND_MODE.
    • Confidential-тиры делят list cache tags; path revalidation минимизирована для узких аудиторий (см. таблицу разработчика ниже).
    • Maps / graph views (Ringdom Maps) сегодня отдельное хранилище: entity CRUD не обновляет map nodes автоматически.
    features/opportunities/lib/opportunity-mutation-sync.ts
    create-opportunity, update-opportunity, delete-opportunity, auto-approval-service
    Entitiesfeatures/entities/lib/entity-mutation-sync.tscreate-entity, update-entity, delete-entity, moderation + KYC hooks
    1. 1

      После любой мутации opportunity

    2. 2

      После любой мутации entity

    3. 3

      Подписка на клиенте

      Подключайте topic listeners через useTunnelChannel. Production-хуки разбирают payload syncDiscovery через lib/discovery/parse-discovery-tunnel-message.ts ({ id, event } + message.event вроде entity:created).

      КаналHookUI wiring
      opportunitieshooks/use-realtime-opportunities.tsBrowse: opportunities.tsx (silent subscribe). Detail: opportunity-details.tsx (по-прежнему показывает live-updates bar). Create snippets включают creator { id, name, avatar }, чтобы live-вставленные карточки не были «Private User».
      entitieshooks/use-realtime-entities.tsfeatures/entities/components/entities.tsx: deletes splice локально; create/update soft-reload cursor feed

      См. Realtime transport и Tunnel protocol.

    Ревалидируемые пути

    Opportunities

    • /[locale]/opportunities
    • /[locale]/opportunities/[id]
    • /[locale]/opportunities/my
    • /opportunities (при create / status change)

    Entities

    • /[locale]/entities
    • /[locale]/entities/[id]
    • /[locale]/entities/my
    • /entities (при create / status change)

    Пути, намеренно пропущенные

    ПутьПричина
    /[locale]/entities/addOne-shot форма; redirect после create
    /[locale]/entities/status/...Payment callbacks: не связаны с CRUD discovery
    /[locale]/confidential/entitiesДостаточно tag invalidation; избегает лишнего path churn
    Ringdom Maps nodesОтдельное graph store: не подключено к entity list caches

    Маппинг строк

    Чтения мапят строки DatabaseService через:

    • features/opportunities/lib/opportunity-db-mapper.ts
    • features/entities/lib/entity-db-mapper.ts

    Legacy Firestore converters под lib/converters/*-converter.ts применяются только когда DB_BACKEND_MODE=firebase-full.

    Same-workflow: REST surface + post-mutation hooks для opportunities.

    Entities

    Same-workflow: REST surface + post-mutation hooks для entities.

    Moderation workflow

    Потоки approve/reject админа вызывают тот же sync: смены статуса ведут себя как updates для подписчиков канала.

    Ожидания оператора

    • Нет ручного reindex CLI для стандартного CRUD: если списки выглядят устаревшими, сначала проверьте Tunnel transport и DB_BACKEND_MODE.
    • Confidential-тиры делят list cache tags; path revalidation минимизирована для узких аудиторий (см. таблицу разработчика ниже).
    • Maps / graph views (Ringdom Maps) сегодня отдельное хранилище: entity CRUD не обновляет map nodes автоматически.
    features/opportunities/lib/opportunity-mutation-sync.ts
    create-opportunity, update-opportunity, delete-opportunity, auto-approval-service
    Entitiesfeatures/entities/lib/entity-mutation-sync.tscreate-entity, update-entity, delete-entity, moderation + KYC hooks
    1. 1

      После любой мутации opportunity

    2. 2

      После любой мутации entity

    3. 3

      Подписка на клиенте

      Подключайте topic listeners через useTunnelChannel. Production-хуки разбирают payload syncDiscovery через lib/discovery/parse-discovery-tunnel-message.ts ({ id, event } + message.event вроде entity:created).

      КаналHookUI wiring
      opportunitieshooks/use-realtime-opportunities.tsBrowse: opportunities.tsx (silent subscribe). Detail: opportunity-details.tsx (по-прежнему показывает live-updates bar). Create snippets включают creator { id, name, avatar }, чтобы live-вставленные карточки не были «Private User».
      entitieshooks/use-realtime-entities.tsfeatures/entities/components/entities.tsx: deletes splice локально; create/update soft-reload cursor feed

      См. Realtime transport и Tunnel protocol.

    Ревалидируемые пути

    Opportunities

    • /[locale]/opportunities
    • /[locale]/opportunities/[id]
    • /[locale]/opportunities/my
    • /opportunities (при create / status change)

    Entities

    • /[locale]/entities
    • /[locale]/entities/[id]
    • /[locale]/entities/my
    • /entities (при create / status change)

    Пути, намеренно пропущенные

    ПутьПричина
    /[locale]/entities/addOne-shot форма; redirect после create
    /[locale]/entities/status/...Payment callbacks: не связаны с CRUD discovery
    /[locale]/confidential/entitiesДостаточно tag invalidation; избегает лишнего path churn
    Ringdom Maps nodesОтдельное graph store: не подключено к entity list caches

    Маппинг строк

    Чтения мапят строки DatabaseService через:

    • features/opportunities/lib/opportunity-db-mapper.ts
    • features/entities/lib/entity-db-mapper.ts

    Legacy Firestore converters под lib/converters/*-converter.ts применяются только когда DB_BACKEND_MODE=firebase-full.

    Same-workflow: REST surface + post-mutation hooks для opportunities.

    Entities

    Same-workflow: REST surface + post-mutation hooks для entities.

    Moderation workflow

    Потоки approve/reject админа вызывают тот же sync: смены статуса ведут себя как updates для подписчиков канала.

    Ожидания оператора

    • Нет ручного reindex CLI для стандартного CRUD: если списки выглядят устаревшими, сначала проверьте Tunnel transport и DB_BACKEND_MODE.
    • Confidential-тиры делят list cache tags; path revalidation минимизирована для узких аудиторий (см. таблицу разработчика ниже).
    • Maps / graph views (Ringdom Maps) сегодня отдельное хранилище: entity CRUD не обновляет map nodes автоматически.
    features/opportunities/lib/opportunity-mutation-sync.ts
    create-opportunity, update-opportunity, delete-opportunity, auto-approval-service
    Entitiesfeatures/entities/lib/entity-mutation-sync.tscreate-entity, update-entity, delete-entity, moderation + KYC hooks
    1. 1

      После любой мутации opportunity

    2. 2

      После любой мутации entity

    3. 3

      Подписка на клиенте

      Подключайте topic listeners через useTunnelChannel. Production-хуки разбирают payload syncDiscovery через lib/discovery/parse-discovery-tunnel-message.ts ({ id, event } + message.event вроде entity:created).

      КаналHookUI wiring
      opportunitieshooks/use-realtime-opportunities.tsBrowse: opportunities.tsx (silent subscribe). Detail: opportunity-details.tsx (по-прежнему показывает live-updates bar). Create snippets включают creator { id, name, avatar }, чтобы live-вставленные карточки не были «Private User».
      entitieshooks/use-realtime-entities.tsfeatures/entities/components/entities.tsx: deletes splice локально; create/update soft-reload cursor feed

      См. Realtime transport и Tunnel protocol.

    Ревалидируемые пути

    Opportunities

    • /[locale]/opportunities
    • /[locale]/opportunities/[id]
    • /[locale]/opportunities/my
    • /opportunities (при create / status change)

    Entities

    • /[locale]/entities
    • /[locale]/entities/[id]
    • /[locale]/entities/my
    • /entities (при create / status change)

    Пути, намеренно пропущенные

    ПутьПричина
    /[locale]/entities/addOne-shot форма; redirect после create
    /[locale]/entities/status/...Payment callbacks: не связаны с CRUD discovery
    /[locale]/confidential/entitiesДостаточно tag invalidation; избегает лишнего path churn
    Ringdom Maps nodesОтдельное graph store: не подключено к entity list caches

    Маппинг строк

    Чтения мапят строки DatabaseService через:

    • features/opportunities/lib/opportunity-db-mapper.ts
    • features/entities/lib/entity-db-mapper.ts

    Legacy Firestore converters под lib/converters/*-converter.ts применяются только когда DB_BACKEND_MODE=firebase-full.

    Same-workflow: REST surface + post-mutation hooks для opportunities.

    Entities

    Same-workflow: REST surface + post-mutation hooks для entities.