НовиниДовідник
navigation.mainNav.messages
    Digital Cherkasy

    Децентралізоване самобудівне майбутнє

    Увійти
    Новини
    Довідник
    Маркетплейс
    navigation.mainNav.opportunities
    navigation.mainNav.messages
    Конфіденційність|Контакти
    v1.104.2|Sonoratek LLC

    Documentation

    Концепції, цінність і типові сценарії

    Швидкий вхід (CTO · аудитори · агенти)

    Вітаємо — місія та аудиторії
    Швидкий довідник
    Початок роботи
    Архітектура та Auth.js
    Режими бекенду та БД (DB_BACKEND_MODE)
    Self-hosted
    Ring MCP Tools
    Ring MCP Server
    Token economics
    Token launch jurisdictions
    Деплой (Docker · k8s)
    Безпека та відповідність
    GitHub — connectplatform/ring
    Код — ліцензія MIT (GitHub)

    Documentation

    Концепції, цінність і типові сценарії

    Швидкий вхід (CTO · аудитори · агенти)

    Вітаємо — місія та аудиторії
    Швидкий довідник
    Початок роботи
    Архітектура та Auth.js
    Режими бекенду та БД (DB_BACKEND_MODE)
    Self-hosted
    Ring MCP Tools
    Ring MCP Server
    Token economics
    Token launch jurisdictions
    Деплой (Docker · k8s)
    Безпека та відповідність
    GitHub — connectplatform/ring
    Код — ліцензія MIT (GitHub)

    Documentation

    Концепції, цінність і типові сценарії

    Швидкий вхід (CTO · аудитори · агенти)

    Вітаємо — місія та аудиторії
    Швидкий довідник
    Початок роботи
    Архітектура та Auth.js
    Режими бекенду та БД (DB_BACKEND_MODE)
    Self-hosted
    Ring MCP Tools
    Ring MCP Server
    Token economics
    Token launch jurisdictions
    Деплой (Docker · k8s)
    Безпека та відповідність
    GitHub — connectplatform/ring
    Код — ліцензія MIT (GitHub)
    Логотип Digital Cherkasy

    Завантаження документації...

    Підготовка контенту платформи Ring

    Логотип Digital Cherkasy

    Завантаження документації...

    Підготовка контенту платформи Ring

    Логотип Digital Cherkasy

    Завантаження документації...

    Підготовка контенту платформи Ring

    Протокол Tunnel

    Realtime-шар Ring Platform: inbox на користувача (сповіщення, баланс) і topic-канали (чат, discovery, matcher).

    • Сервер: server.ts — Next.js + native WSS (/api/tunnel/ws) при RING_DEPLOY_TARGET=k8s|self-hosted
    • Брокер: lib/tunnel/hub/ → InMemoryTunnelHub (+ Postgres fan-out decorator коли увімкнено)
    • Клієнт: TunnelProvider / useTunnelChannel → WSS → SSE → poll
    • Reconnect: NativeWsClient — backoff, heartbeat watchdog (force-close без pong), kick на online / visibilitychange

    Маршрути API

    МаршрутМетодПризначення
    /api/tunnel/wsWSNative WebSocket (k8s/self-hosted)
    /api/tunnel/sseGETSSE-потік
    /api/tunnel/tokenPOSTJWT для tunnel auth
    /api/tunnel/pollGET/POSTLong-polling fallback

    Конфігурація

    Повний гід (founder + developer) — англійська версія. Smoke multi-replica (тимчасово): bash scripts/ci/smoke-tunnel-postgres-fanout.sh.

    1. Документація
    2. /Features
    3. /Протокол Tunnel
    Оновлено 7 серп. 2026 р.1 хв прослуховування

    Протокол Tunnel

    Realtime-шар Ring Platform: inbox на користувача (сповіщення, баланс) і topic-канали (чат, discovery, matcher).

    • Сервер: server.ts — Next.js + native WSS (/api/tunnel/ws) при RING_DEPLOY_TARGET=k8s|self-hosted
    • Брокер: lib/tunnel/hub/ → InMemoryTunnelHub (+ Postgres fan-out decorator коли увімкнено)
    • Клієнт: TunnelProvider / useTunnelChannel → WSS → SSE → poll
    • Reconnect: NativeWsClient — backoff, heartbeat watchdog (force-close без pong), kick на online / visibilitychange

    Маршрути API

    МаршрутМетодПризначення
    /api/tunnel/wsWSNative WebSocket (k8s/self-hosted)
    /api/tunnel/sseGETSSE-потік
    /api/tunnel/tokenPOSTJWT для tunnel auth
    /api/tunnel/pollGET/POSTLong-polling fallback

    Конфігурація

    Повний гід (founder + developer) — англійська версія. Smoke multi-replica (тимчасово): bash scripts/ci/smoke-tunnel-postgres-fanout.sh.

    1. Документація
    2. /Features
    3. /Протокол Tunnel
    Оновлено 7 серп. 2026 р.1 хв прослуховування

    Протокол Tunnel

    Realtime-шар Ring Platform: inbox на користувача (сповіщення, баланс) і topic-канали (чат, discovery, matcher).

    • Сервер: server.ts — Next.js + native WSS (/api/tunnel/ws) при RING_DEPLOY_TARGET=k8s|self-hosted
    • Брокер: lib/tunnel/hub/ → InMemoryTunnelHub (+ Postgres fan-out decorator коли увімкнено)
    • Клієнт: TunnelProvider / useTunnelChannel → WSS → SSE → poll
    • Reconnect: NativeWsClient — backoff, heartbeat watchdog (force-close без pong), kick на online / visibilitychange

    Маршрути API

    МаршрутМетодПризначення
    /api/tunnel/wsWSNative WebSocket (k8s/self-hosted)
    /api/tunnel/sseGETSSE-потік
    /api/tunnel/tokenPOSTJWT для tunnel auth
    /api/tunnel/pollGET/POSTLong-polling fallback

    Конфігурація

    Повний гід (founder + developer) — англійська версія. Smoke multi-replica (тимчасово): bash scripts/ci/smoke-tunnel-postgres-fanout.sh.

    1. Документація
    2. /Features
    3. /Протокол Tunnel
    Оновлено 7 серп. 2026 р.1 хв прослуховування
    bash
    
RING_DEPLOY_TARGET=k8s
NEXT_PUBLIC_RING_DEPLOY_TARGET=k8s
# На однонодовому k3s-or: replicas=1 + TUNNEL_POSTGRES_FANOUT=disabled
# TUNNEL_POSTGRES_FANOUT=enabled  # лише з headroom для ≥2 подів
    bash
    
RING_DEPLOY_TARGET=k8s
NEXT_PUBLIC_RING_DEPLOY_TARGET=k8s
# На однонодовому k3s-or: replicas=1 + TUNNEL_POSTGRES_FANOUT=disabled
# TUNNEL_POSTGRES_FANOUT=enabled  # лише з headroom для ≥2 подів
    bash
    
RING_DEPLOY_TARGET=k8s
NEXT_PUBLIC_RING_DEPLOY_TARGET=k8s
# На однонодовому k3s-or: replicas=1 + TUNNEL_POSTGRES_FANOUT=disabled
# TUNNEL_POSTGRES_FANOUT=enabled  # лише з headroom для ≥2 подів