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

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

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

    Documentation

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

    Добро пожаловать в Ring
    Краткий справочник
    С чего начать
    Предварительные требования
    Установка
    Первый успех
    Следующие шаги
    Функции
    Store
    Склад и остатки
    Управление вендорами
    Комиссии и расчёты
    SubscriptionConductor
    PaymentConductor
    Интеграция платежей
    Интеграция WayForPay
    Web3 Кошелек
    Реферальные коды (Refcodes)
    NFT Exhibition Marketplace
    Система Стейкинга Токенов
    Entities
    Opportunities
    AI Matcher
    Real-Time Messaging
    Peer Games
    Модуль Новостей - Цифровой Газетный Опыт
    Блоги участников
    Система Резервирования Имён Пользователей
    Научный редактор
    Notifications
    Push-уведомления через FCM (Ring)
    Email AI-CRM
    Протокол 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)
    Развёртывание
    Self-hosted развёртывание
    Vercel
    Docker
    Конфигурация Окружения
    Мониторинг и аналитика
    Оптимизация производительности
    Резервное копирование и восстановление
    Архитектура
    Data Model
    Security
    Real Time
    Архитектура PaymentConductor
    Бекенд Сервисы
    Интеграция Firebase
    Разработка
    Ring MCP Server

    Быстрый вход (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
    Интеграция платежей
    Интеграция WayForPay
    Web3 Кошелек
    Реферальные коды (Refcodes)
    NFT Exhibition Marketplace
    Система Стейкинга Токенов
    Entities
    Opportunities
    AI Matcher
    Real-Time Messaging
    Peer Games
    Модуль Новостей - Цифровой Газетный Опыт
    Блоги участников
    Система Резервирования Имён Пользователей
    Научный редактор
    Notifications
    Push-уведомления через FCM (Ring)
    Email AI-CRM
    Протокол 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)
    Развёртывание
    Self-hosted развёртывание
    Vercel
    Docker
    Конфигурация Окружения
    Мониторинг и аналитика
    Оптимизация производительности
    Резервное копирование и восстановление
    Архитектура
    Data Model
    Security
    Real Time
    Архитектура PaymentConductor
    Бекенд Сервисы
    Интеграция Firebase
    Разработка
    Ring MCP Server

    Быстрый вход (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
    Интеграция платежей
    Интеграция WayForPay
    Web3 Кошелек
    Реферальные коды (Refcodes)
    NFT Exhibition Marketplace
    Система Стейкинга Токенов
    Entities
    Opportunities
    AI Matcher
    Real-Time Messaging
    Peer Games
    Модуль Новостей - Цифровой Газетный Опыт
    Блоги участников
    Система Резервирования Имён Пользователей
    Научный редактор
    Notifications
    Push-уведомления через FCM (Ring)
    Email AI-CRM
    Протокол 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)
    Развёртывание
    Self-hosted развёртывание
    Vercel
    Docker
    Конфигурация Окружения
    Мониторинг и аналитика
    Оптимизация производительности
    Резервное копирование и восстановление
    Архитектура
    Data Model
    Security
    Real Time
    Архитектура PaymentConductor
    Бекенд Сервисы
    Интеграция Firebase
    Разработка
    Ring MCP Server

    Быстрый вход (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

    Выбор бэкенда базы данных

    Кратко для руководства

    Production-клоны Ring используют DB_BACKEND_MODE=k8s-postgres-fcm — PostgreSQL для данных приложения, Firebase Admin только для FCM push, если настроен. Устаревший DATABASE_MODE удалён. Выберите режим до первого boot.

    Backend modes (architecture)

    Адаптеры, FCM vs Firestore, DB_HYBRID_MODE

    Database migrations

    Порядок schema.sql + kingdom-миграций

    Quick Start

    Первый клон с Postgres

    DB_BACKEND_MODE decision

    Три режима

    DB_BACKEND_MODEДанные приложенияFirestore как DB?Push
    k8s-postgres-fcmPostgreSQL (self-hosted, k3s, Docker)НетFCM + Apple при настройке
    supabase-fcmPostgreSQL на SupabaseНетТот же паттерн FCM
    firebase-fullПути FirestoreДаПолный стек Firebase

    Реализация: lib/database/backend-mode-config.ts, lib/database/DatabaseService.ts, lib/database/BackendSelector.ts.

    ConnectPlatform (connect-brand.com) — realtime collaboration, не адаптер DB_BACKEND_MODE. См. Tunnel protocol.

    Настройка по режимам

    Рекомендуемый default

    OSS self-host, k3s, handoff Ringdom, PaymentConductor, News Kingdom, data/schema.sql v4.

    1. 1

      Задайте режим и подключение в .env.local:

      Опционально: DB_POOL_SIZE, DB_TIMEOUT, DB_RETRIES.

    2. 2

      Поднимите PostgreSQL 14+ (локально рекомендуется 18) — Docker docker-compose.dev.yml, Homebrew-bootstrap или ваш кластер.

    3. 3

      Примените схему и миграции:

      Полный порядок: Database migrations.

    4. 4

      FCM (опционально): задайте NEXT_PUBLIC_FIREBASE_* + service account из env.local.template. Данные приложения остаются на Postgres.

    Что не использовать

    Legacy / invalidReplacement
    DATABASE_MODE=firebase_only / postgresql_onlyзначения DB_BACKEND_MODE выше
    npm run db:migrate / db:backup./scripts/run-migration.sh, pg_dump
    DB_HYBRID_MODE как основной переключательDB_BACKEND_MODE — см. страницу architecture

    Смена режима позже

    1. 1

      Экспортируйте данные из источника (Firestore export или pg_dump).

    2. 2

      Поднимите целевой Postgres; примените migrations.

    3. 3

      Обновите DB_BACKEND_MODE и секреты подключения на staging.

    4. 4

      Smoke-тест auth, store, payments, news перед cutover в production.

    Чеклист перед запуском (Postgres-primary):

    • DB_BACKEND_MODE задан — приложение стартует чисто
    • data/schema.sql + kingdom-миграции применены
    • Настроены бэкапы (pg_dump, CNPG, снимки провайдера)
    • Переменные FCM — только если нужен push
    • 004_payment_transactions.sql, если используете payments

    Environment config

    Группы секретов и переменные локалей

    Payment integration

    Требует Postgres ledger

    Quick Start (new clone)

    Один деплой на клиента — паттерн Ringdom

    1. Документация
    2. /Кастомизация
    3. /Выбор бэкенда базы данных
    Обновлено 12 июн. 2026 г.2 мин прослушивания

    Выбор бэкенда базы данных

    Кратко для руководства

    Production-клоны Ring используют DB_BACKEND_MODE=k8s-postgres-fcm — PostgreSQL для данных приложения, Firebase Admin только для FCM push, если настроен. Устаревший DATABASE_MODE удалён. Выберите режим до первого boot.

    Backend modes (architecture)

    Адаптеры, FCM vs Firestore, DB_HYBRID_MODE

    Database migrations

    Порядок schema.sql + kingdom-миграций

    Quick Start

    Первый клон с Postgres

    DB_BACKEND_MODE decision

    Три режима

    DB_BACKEND_MODEДанные приложенияFirestore как DB?Push
    k8s-postgres-fcmPostgreSQL (self-hosted, k3s, Docker)НетFCM + Apple при настройке
    supabase-fcmPostgreSQL на SupabaseНетТот же паттерн FCM
    firebase-fullПути FirestoreДаПолный стек Firebase

    Реализация: lib/database/backend-mode-config.ts, lib/database/DatabaseService.ts, lib/database/BackendSelector.ts.

    ConnectPlatform (connect-brand.com) — realtime collaboration, не адаптер DB_BACKEND_MODE. См. Tunnel protocol.

    Настройка по режимам

    Рекомендуемый default

    OSS self-host, k3s, handoff Ringdom, PaymentConductor, News Kingdom, data/schema.sql v4.

    1. 1

      Задайте режим и подключение в .env.local:

      Опционально: DB_POOL_SIZE, DB_TIMEOUT, DB_RETRIES.

    2. 2

      Поднимите PostgreSQL 14+ (локально рекомендуется 18) — Docker docker-compose.dev.yml, Homebrew-bootstrap или ваш кластер.

    3. 3

      Примените схему и миграции:

      Полный порядок: Database migrations.

    4. 4

      FCM (опционально): задайте NEXT_PUBLIC_FIREBASE_* + service account из env.local.template. Данные приложения остаются на Postgres.

    Что не использовать

    Legacy / invalidReplacement
    DATABASE_MODE=firebase_only / postgresql_onlyзначения DB_BACKEND_MODE выше
    npm run db:migrate / db:backup./scripts/run-migration.sh, pg_dump
    DB_HYBRID_MODE как основной переключательDB_BACKEND_MODE — см. страницу architecture

    Смена режима позже

    1. 1

      Экспортируйте данные из источника (Firestore export или pg_dump).

    2. 2

      Поднимите целевой Postgres; примените migrations.

    3. 3

      Обновите DB_BACKEND_MODE и секреты подключения на staging.

    4. 4

      Smoke-тест auth, store, payments, news перед cutover в production.

    Чеклист перед запуском (Postgres-primary):

    • DB_BACKEND_MODE задан — приложение стартует чисто
    • data/schema.sql + kingdom-миграции применены
    • Настроены бэкапы (pg_dump, CNPG, снимки провайдера)
    • Переменные FCM — только если нужен push
    • 004_payment_transactions.sql, если используете payments

    Environment config

    Группы секретов и переменные локалей

    Payment integration

    Требует Postgres ledger

    Quick Start (new clone)

    Один деплой на клиента — паттерн Ringdom

    1. Документация
    2. /Кастомизация
    3. /Выбор бэкенда базы данных
    Обновлено 12 июн. 2026 г.2 мин прослушивания

    Выбор бэкенда базы данных

    Кратко для руководства

    Production-клоны Ring используют DB_BACKEND_MODE=k8s-postgres-fcm — PostgreSQL для данных приложения, Firebase Admin только для FCM push, если настроен. Устаревший DATABASE_MODE удалён. Выберите режим до первого boot.

    Backend modes (architecture)

    Адаптеры, FCM vs Firestore, DB_HYBRID_MODE

    Database migrations

    Порядок schema.sql + kingdom-миграций

    Quick Start

    Первый клон с Postgres

    DB_BACKEND_MODE decision

    Три режима

    DB_BACKEND_MODEДанные приложенияFirestore как DB?Push
    k8s-postgres-fcmPostgreSQL (self-hosted, k3s, Docker)НетFCM + Apple при настройке
    supabase-fcmPostgreSQL на SupabaseНетТот же паттерн FCM
    firebase-fullПути FirestoreДаПолный стек Firebase

    Реализация: lib/database/backend-mode-config.ts, lib/database/DatabaseService.ts, lib/database/BackendSelector.ts.

    ConnectPlatform (connect-brand.com) — realtime collaboration, не адаптер DB_BACKEND_MODE. См. Tunnel protocol.

    Настройка по режимам

    Рекомендуемый default

    OSS self-host, k3s, handoff Ringdom, PaymentConductor, News Kingdom, data/schema.sql v4.

    1. 1

      Задайте режим и подключение в .env.local:

      Опционально: DB_POOL_SIZE, DB_TIMEOUT, DB_RETRIES.

    2. 2

      Поднимите PostgreSQL 14+ (локально рекомендуется 18) — Docker docker-compose.dev.yml, Homebrew-bootstrap или ваш кластер.

    3. 3

      Примените схему и миграции:

      Полный порядок: Database migrations.

    4. 4

      FCM (опционально): задайте NEXT_PUBLIC_FIREBASE_* + service account из env.local.template. Данные приложения остаются на Postgres.

    Что не использовать

    Legacy / invalidReplacement
    DATABASE_MODE=firebase_only / postgresql_onlyзначения DB_BACKEND_MODE выше
    npm run db:migrate / db:backup./scripts/run-migration.sh, pg_dump
    DB_HYBRID_MODE как основной переключательDB_BACKEND_MODE — см. страницу architecture

    Смена режима позже

    1. 1

      Экспортируйте данные из источника (Firestore export или pg_dump).

    2. 2

      Поднимите целевой Postgres; примените migrations.

    3. 3

      Обновите DB_BACKEND_MODE и секреты подключения на staging.

    4. 4

      Smoke-тест auth, store, payments, news перед cutover в production.

    Чеклист перед запуском (Postgres-primary):

    • DB_BACKEND_MODE задан — приложение стартует чисто
    • data/schema.sql + kingdom-миграции применены
    • Настроены бэкапы (pg_dump, CNPG, снимки провайдера)
    • Переменные FCM — только если нужен push
    • 004_payment_transactions.sql, если используете payments

    Environment config

    Группы секретов и переменные локалей

    Payment integration

    Требует Postgres ledger

    Quick Start (new clone)

    Один деплой на клиента — паттерн Ringdom

    1. Документация
    2. /Кастомизация
    3. /Выбор бэкенда базы данных
    Обновлено 12 июн. 2026 г.2 мин прослушивания