Preparing Ring content
Preparing Ring content
Preparing Ring content
Фильтруйте эту страницу вкладками Основатель / Разработчик в боковой панели документации. Основатели узнают почему listings остаются свежими; разработчики получают модули, события и точки расширения.
Когда кто-то создаёт, редактирует или удаляет opportunity или entity на PostgreSQL-primary Ring-клоне, пользователи ожидают, что marketplace и directory обновятся сразу, без ночного reindex job. Ring координирует три лёгких шага на каждой мутации.
| Шаг | Что видят пользователи | Что происходит под капотом |
|---|---|---|
| 1. Cache bust | Страницы списков перестают показывать устаревшие карточки | revalidateTag очищает role-scoped list caches |
| 2. Page refresh | URL деталей и хабов показывают новые данные при следующей навигации | 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 разрушают доверие быстрее, чем отсутствующая фича.
Участник публикует контракт: одобренные listings появляются на /opportunities, подписчики получают Tunnel-уведомления.
Верифицированная entity обновляет showcase: страницы профиля и публичный directory обновляются без вмешательства ops.
Новые opportunities запускают matcher-пайплайны; свежие cache tags гарантируют, что match-карточки ссылаются на актуальные поля budget и deadline.
Prerequisite: channel subscribe SSOT и publishToChannel vs publishToUserTunnel.
Deep-dive: брокер TunnelHub и матрица publish/subscribe фич.
Depends-on: JSONB-коллекции, синхронизируемые этим пайплайном.
Same-workflow: browse feed гидрируется из list APIs и silent Tunnel inserts.
Фильтруйте эту страницу вкладками Основатель / Разработчик в боковой панели документации. Основатели узнают почему listings остаются свежими; разработчики получают модули, события и точки расширения.
Когда кто-то создаёт, редактирует или удаляет opportunity или entity на PostgreSQL-primary Ring-клоне, пользователи ожидают, что marketplace и directory обновятся сразу, без ночного reindex job. Ring координирует три лёгких шага на каждой мутации.
| Шаг | Что видят пользователи | Что происходит под капотом |
|---|---|---|
| 1. Cache bust | Страницы списков перестают показывать устаревшие карточки | revalidateTag очищает role-scoped list caches |
| 2. Page refresh | URL деталей и хабов показывают новые данные при следующей навигации | 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 разрушают доверие быстрее, чем отсутствующая фича.
Участник публикует контракт: одобренные listings появляются на /opportunities, подписчики получают Tunnel-уведомления.
Верифицированная entity обновляет showcase: страницы профиля и публичный directory обновляются без вмешательства ops.
Новые opportunities запускают matcher-пайплайны; свежие cache tags гарантируют, что match-карточки ссылаются на актуальные поля budget и deadline.
Prerequisite: channel subscribe SSOT и publishToChannel vs publishToUserTunnel.
Deep-dive: брокер TunnelHub и матрица publish/subscribe фич.
Depends-on: JSONB-коллекции, синхронизируемые этим пайплайном.
Same-workflow: browse feed гидрируется из list APIs и silent Tunnel inserts.
Фильтруйте эту страницу вкладками Основатель / Разработчик в боковой панели документации. Основатели узнают почему listings остаются свежими; разработчики получают модули, события и точки расширения.
Когда кто-то создаёт, редактирует или удаляет opportunity или entity на PostgreSQL-primary Ring-клоне, пользователи ожидают, что marketplace и directory обновятся сразу, без ночного reindex job. Ring координирует три лёгких шага на каждой мутации.
| Шаг | Что видят пользователи | Что происходит под капотом |
|---|---|---|
| 1. Cache bust | Страницы списков перестают показывать устаревшие карточки | revalidateTag очищает role-scoped list caches |
| 2. Page refresh | URL деталей и хабов показывают новые данные при следующей навигации | 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 разрушают доверие быстрее, чем отсутствующая фича.
Участник публикует контракт: одобренные listings появляются на /opportunities, подписчики получают Tunnel-уведомления.
Верифицированная entity обновляет showcase: страницы профиля и публичный directory обновляются без вмешательства ops.
Новые opportunities запускают matcher-пайплайны; свежие cache tags гарантируют, что match-карточки ссылаются на актуальные поля budget и deadline.
Prerequisite: channel subscribe SSOT и publishToChannel vs publishToUserTunnel.
Deep-dive: брокер TunnelHub и матрица publish/subscribe фич.
Depends-on: JSONB-коллекции, синхронизируемые этим пайплайном.
Same-workflow: browse feed гидрируется из list APIs и silent Tunnel inserts.
DB_BACKEND_MODE.features/opportunities/lib/opportunity-mutation-sync.ts |
create-opportunity, update-opportunity, delete-opportunity, auto-approval-service |
| Entities | features/entities/lib/entity-mutation-sync.ts | create-entity, update-entity, delete-entity, moderation + KYC hooks |
Подключайте topic listeners через useTunnelChannel. Production-хуки разбирают payload syncDiscovery через lib/discovery/parse-discovery-tunnel-message.ts ({ id, event } + message.event вроде entity:created).
| Канал | Hook | UI wiring |
|---|---|---|
opportunities | hooks/use-realtime-opportunities.ts | Browse: opportunities.tsx (silent subscribe). Detail: opportunity-details.tsx (по-прежнему показывает live-updates bar). Create snippets включают creator { id, name, avatar }, чтобы live-вставленные карточки не были «Private User». |
entities | hooks/use-realtime-entities.ts | features/entities/components/entities.tsx: deletes splice локально; create/update soft-reload cursor feed |
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/add | One-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.tsfeatures/entities/lib/entity-db-mapper.tsLegacy Firestore converters под lib/converters/*-converter.ts применяются только когда DB_BACKEND_MODE=firebase-full.
Same-workflow: REST surface + post-mutation hooks для opportunities.
DB_BACKEND_MODE.features/opportunities/lib/opportunity-mutation-sync.ts |
create-opportunity, update-opportunity, delete-opportunity, auto-approval-service |
| Entities | features/entities/lib/entity-mutation-sync.ts | create-entity, update-entity, delete-entity, moderation + KYC hooks |
Подключайте topic listeners через useTunnelChannel. Production-хуки разбирают payload syncDiscovery через lib/discovery/parse-discovery-tunnel-message.ts ({ id, event } + message.event вроде entity:created).
| Канал | Hook | UI wiring |
|---|---|---|
opportunities | hooks/use-realtime-opportunities.ts | Browse: opportunities.tsx (silent subscribe). Detail: opportunity-details.tsx (по-прежнему показывает live-updates bar). Create snippets включают creator { id, name, avatar }, чтобы live-вставленные карточки не были «Private User». |
entities | hooks/use-realtime-entities.ts | features/entities/components/entities.tsx: deletes splice локально; create/update soft-reload cursor feed |
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/add | One-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.tsfeatures/entities/lib/entity-db-mapper.tsLegacy Firestore converters под lib/converters/*-converter.ts применяются только когда DB_BACKEND_MODE=firebase-full.
Same-workflow: REST surface + post-mutation hooks для opportunities.
DB_BACKEND_MODE.features/opportunities/lib/opportunity-mutation-sync.ts |
create-opportunity, update-opportunity, delete-opportunity, auto-approval-service |
| Entities | features/entities/lib/entity-mutation-sync.ts | create-entity, update-entity, delete-entity, moderation + KYC hooks |
Подключайте topic listeners через useTunnelChannel. Production-хуки разбирают payload syncDiscovery через lib/discovery/parse-discovery-tunnel-message.ts ({ id, event } + message.event вроде entity:created).
| Канал | Hook | UI wiring |
|---|---|---|
opportunities | hooks/use-realtime-opportunities.ts | Browse: opportunities.tsx (silent subscribe). Detail: opportunity-details.tsx (по-прежнему показывает live-updates bar). Create snippets включают creator { id, name, avatar }, чтобы live-вставленные карточки не были «Private User». |
entities | hooks/use-realtime-entities.ts | features/entities/components/entities.tsx: deletes splice локально; create/update soft-reload cursor feed |
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/add | One-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.tsfeatures/entities/lib/entity-db-mapper.tsLegacy Firestore converters под lib/converters/*-converter.ts применяются только когда DB_BACKEND_MODE=firebase-full.
Same-workflow: REST surface + post-mutation hooks для opportunities.