Ring Platform Logo

    Loading Documentation Hub...

    Scanning documentation library

    Documentation

    Приветствие — миссия и аудитории

    Добро пожаловать в Ring Platform

    Хаб библиотеки

    Документация платформы Ring

    Начало работы

    Индекс
    Предварительные требования
    Установка
    Миграции базы данных
    Первый успех
    Устранение неполадок
    Next Steps

    Архитектура

    Обзор архитектуры
    Режимы бэкенда и базы данных
    Data Model
    Архитектура Аутентификации
    Архитектура Email AI-CRM
    Архитектура PaymentConductor
    Архитектура Refcodes
    Архитектура News Kingdom
    Proxy и интернационализация
    Real Time
    Security

    Функции

    Index
    Authentication
    Email AI-CRM
    Entities
    Opportunities
    Messaging
    Notifications
    Push-уведомления через FCM (Ring)
    Web3 Кошелек
    Store
    Ring ERP
    Склад и остатки

    API-интерфейс

    Index
    Аутентификация
    Email AI-CRM API
    Сущности
    Opportunities
    Messaging
    Notifications
    Wallet
    Store

    CLI

    Ring CLI (только enterprise)

    Кастомизация

    Index
    Branding
    Features
    Localization
    Themes
    Components

    Развёртывание

    Index
    Self-hosted развёртывание
    Vercel
    Docker
    Environment
    Monitoring
    Оптимизация производительности
    Backup

    Разработка

    Index
    Local Setup
    Code Structure
    Community tooling
    Ring MCP Server
    Генеративные изображения (ImageConductor)
    Автономная редакция (Grok)
    OSS vs enterprise

    Дорожная карта

    Дорожная карта платформы (техническая)

    Примеры

    Index
    Quick Start
    Authentication
    Email AI-CRM — туториал
    Api Integration
    Интеграция Web3
    White Label
    Реальные Проекты

    Интеграции

    Ethereum-кошельки (Wagmi v3)

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

    Хаб библиотеки
    Приветствие — миссия и аудитории
    Начало работы
    Архитектура и Auth.js
    Режимы бэкенда и БД (DB_BACKEND_MODE)
    Self-hosted
    Ring MCP
    Деплой (Docker · k8s)
    Безопасность и комплаенс
    Ring Platform Logo

    Loading Documentation Hub...

    Scanning documentation library

    Documentation

    Приветствие — миссия и аудитории

    Добро пожаловать в Ring Platform

    Хаб библиотеки

    Документация платформы Ring

    Начало работы

    Индекс
    Предварительные требования
    Установка
    Миграции базы данных
    Первый успех
    Устранение неполадок
    Next Steps

    Архитектура

    Обзор архитектуры
    Режимы бэкенда и базы данных
    Data Model
    Архитектура Аутентификации
    Архитектура Email AI-CRM
    Архитектура PaymentConductor
    Архитектура Refcodes
    Архитектура News Kingdom

    Функции

    Index
    Authentication
    Email AI-CRM
    Entities
    Opportunities
    Messaging
    Notifications
    Push-уведомления через FCM (Ring)

    API-интерфейс

    Index
    Аутентификация
    Email AI-CRM API
    Сущности
    Opportunities
    Messaging
    Notifications
    Wallet
    Store

    CLI

    Ring CLI (только enterprise)

    Кастомизация

    Index
    Branding
    Features
    Localization
    Themes
    Components

    Развёртывание

    Index
    Self-hosted развёртывание
    Vercel
    Docker
    Environment
    Monitoring
    Оптимизация производительности
    Backup

    Разработка

    Index
    Local Setup
    Code Structure
    Community tooling
    Ring MCP Server
    Генеративные изображения (ImageConductor)
    Автономная редакция (Grok)
    OSS vs enterprise

    Дорожная карта

    Дорожная карта платформы (техническая)

    Примеры

    Index
    Quick Start
    Authentication
    Email AI-CRM — туториал
    Api Integration
    Интеграция Web3
    White Label
    Реальные Проекты

    Интеграции

    Ethereum-кошельки (Wagmi v3)

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

    Хаб библиотеки
    Приветствие — миссия и аудитории
    Начало работы
    Архитектура и Auth.js
    Режимы бэкенда и БД (DB_BACKEND_MODE)
    Self-hosted
    Ring MCP
    Деплой (Docker · k8s)
    Безопасность и комплаенс
    Ring Platform Logo

    Loading Documentation Hub...

    Scanning documentation library

    Documentation

    Приветствие — миссия и аудитории

    Добро пожаловать в Ring Platform

    Хаб библиотеки

    Документация платформы Ring

    Начало работы

    Индекс
    Предварительные требования
    Установка
    Миграции базы данных
    Первый успех
    Устранение неполадок
    Next Steps

    Архитектура

    Обзор архитектуры
    Режимы бэкенда и базы данных
    Data Model
    Архитектура Аутентификации
    Архитектура Email AI-CRM
    Архитектура PaymentConductor
    Архитектура Refcodes
    Архитектура News Kingdom

    Функции

    Index
    Authentication
    Email AI-CRM
    Entities
    Opportunities
    Messaging
    Notifications
    Push-уведомления через FCM (Ring)

    API-интерфейс

    Index
    Аутентификация
    Email AI-CRM API
    Сущности
    Opportunities
    Messaging
    Notifications
    Wallet
    Store

    CLI

    Ring CLI (только enterprise)

    Кастомизация

    Index
    Branding
    Features
    Localization
    Themes
    Components

    Развёртывание

    Index
    Self-hosted развёртывание
    Vercel
    Docker
    Environment
    Monitoring
    Оптимизация производительности
    Backup

    Разработка

    Index
    Local Setup
    Code Structure
    Community tooling
    Ring MCP Server
    Генеративные изображения (ImageConductor)
    Автономная редакция (Grok)
    OSS vs enterprise

    Дорожная карта

    Дорожная карта платформы (техническая)

    Примеры

    Index
    Quick Start
    Authentication
    Email AI-CRM — туториал
    Api Integration
    Интеграция Web3
    White Label
    Реальные Проекты

    Интеграции

    Ethereum-кошельки (Wagmi v3)

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

    Хаб библиотеки
    Приветствие — миссия и аудитории
    Начало работы
    Архитектура и Auth.js
    Режимы бэкенда и БД (DB_BACKEND_MODE)
    Self-hosted
    Ring MCP
    Деплой (Docker · k8s)
    Безопасность и комплаенс

    Authentication System

    Auth.js v5 multi-provider authentication with magic links, OAuth providers, crypto wallets, and GDPR compliance.

    Модель защиты v1.6.0

    СлойРоль
    proxy.tsПерезапись локали + optimistic redirect на ROUTES.LOGIN(locale)
    (authenticated)/[locale]/layout.tsxawait auth() — каноничный gate сессии
    (admin)/[locale]/layout.tsxПроверка роли (ADMIN/SUPERADMIN)
    API routesauth() в каждом handler

    OAuth: /api/auth/* исключено из intl middleware. См. Proxy и intl.

    Overview

    Ring Platform uses Auth.js v5 to provide seamless authentication across multiple providers while maintaining security and user privacy.

    Authentication Providers

    Magic Links

    • Passwordless Authentication - Email-based secure login
    • One-click Access - No password required
    • Secure Tokens - Time-limited access tokens
    • GDPR Compliant - Privacy-first approach

    OAuth Providers

    • Google - Primary OAuth provider for web and mobile
    • Apple - iOS/macOS native integration with Sign in with Apple
    • GitHub - Developer-focused authentication
    • Discord - Community platform integration

    Интеграция входа через Apple

    Платформа Ring поддерживает бесшовную интеграцию Sign in with Apple с использованием Auth.js v5.

    Необходимые условия

    Перед настройкой входа через Apple убедитесь, что у вас есть:

    1. Аккаунт разработчика Apple - Платный аккаунт разработчика ($99/год)
    2. App ID - Зарегистрированный идентификатор приложения (например, com.yourcompany.yourapp)
    3. Service ID - Для веб-аутентификации (например, com.yourcompany.auth)
    4. Приватный ключ - Сгенерированный в портале разработчика Apple
    5. Team ID - Из вашего аккаунта разработчика Apple
    Настройка в Apple Developer Portal
    1. Создание App ID:

      • Перейдите в Certificates, Identifiers & Profiles
      • Нажмите + → Выберите App IDs
      • Зарегистрируйте приложение с bundle ID (например, com.sonoratek.ring)
      • Включите возможность Sign in with Apple
    2. Создание Service ID:

      • В разделе Identifiers → Нажмите + → Выберите Services IDs
      • Создайте service ID (например, com.sonoratek.ring-auth)
      • Включите Sign in with Apple
      • Настройте Return URLs (URL-адреса обратного вызова вашего приложения)
    3. Генерация приватного ключа:

      • Перейдите в Keys → Нажмите +
      • Назовите ключ (например, "Auth Key for Ring Platform")
      • Включите Sign in with Apple
      • Выберите ваш App ID
      • Скачайте файл приватного ключа .p8 (храните в безопасности!)
    Конфигурация окружения

    Добавьте эти переменные в ваш .env.local:

    Конфигурация входа через Apple

    Генерация JWT

    Apple требует JWT, подписанный вашим приватным ключом. Используйте этот скрипт Node.js:

    Конфигурация Auth.js v5

    Вход через Apple автоматически настраивается в вашем auth.config.ts:

    Использование в компонентах
    Особенности пользовательского опыта
    • Одно касание аутентификации на устройствах Apple
    • Ориентированность на приватность - Нет сбора email без согласия пользователя
    • Безопасный обмен токенами - Валидация на стороне сервера
    • Связывание аккаунтов - Подключение к существующим аккаунтам
    • Кросс-платформенная поддержка - Работает на веб и мобильных
    Меры безопасности
    • Защита приватного ключа - Никогда не коммитьте файлы .p8 в систему контроля версий
    • Истечение JWT - Перегенерируйте токены каждые 6 месяцев
    • Изоляция окружений - Используйте разные ключи для dev/staging/production
    • Аудит логирования - Отслеживайте события аутентификации
    • Ограничение частоты запросов - Защита от злоупотреблений
    Устранение неполадок

    Распространенные проблемы:

    • "Invalid client" ошибка: Проверьте, что AUTH_APPLE_ID соответствует вашему Service ID
    • "Invalid JWT" ошибка: Проверьте генерацию JWT и срок действия
    • "Domain verification failed": Убедитесь, что return URLs правильно настроены
    • "Key not found" ошибка: Проверьте доступность и корректность приватного ключа

    Советы по отладке:

    • Проверьте логи сервера для детальных сообщений об ошибках
    • Проверьте структуру полезной нагрузки JWT и подпись
    • Тестируйте с инструментами разработчика Apple
    • Убедитесь в правильной верификации домена в Apple Developer portal

    Crypto Wallets

    • MetaMask - Ethereum wallet authentication
    • WalletConnect - Multi-wallet support
    • Coinbase Wallet - Mainstream crypto wallet
    • Trust Wallet - Mobile-first wallet integration

    Implementation

    Authentication Setup

    Role-Based Access

    // Check user role


    Complete authentication documentation coming soon.

    Authentication System

    Auth.js v5 multi-provider authentication with magic links, OAuth providers, crypto wallets, and GDPR compliance.

    Модель защиты v1.6.0

    СлойРоль
    proxy.tsПерезапись локали + optimistic redirect на ROUTES.LOGIN(locale)
    (authenticated)/[locale]/layout.tsxawait auth() — каноничный gate сессии
    (admin)/[locale]/layout.tsxПроверка роли (ADMIN/SUPERADMIN)
    API routesauth() в каждом handler

    OAuth: /api/auth/* исключено из intl middleware. См. Proxy и intl.

    Overview

    Ring Platform uses Auth.js v5 to provide seamless authentication across multiple providers while maintaining security and user privacy.

    Authentication Providers

    Magic Links

    • Passwordless Authentication - Email-based secure login
    • One-click Access - No password required
    • Secure Tokens - Time-limited access tokens
    • GDPR Compliant - Privacy-first approach

    OAuth Providers

    • Google - Primary OAuth provider for web and mobile
    • Apple - iOS/macOS native integration with Sign in with Apple
    • GitHub - Developer-focused authentication
    • Discord - Community platform integration

    Интеграция входа через Apple

    Платформа Ring поддерживает бесшовную интеграцию Sign in with Apple с использованием Auth.js v5.

    Необходимые условия

    Перед настройкой входа через Apple убедитесь, что у вас есть:

    1. Аккаунт разработчика Apple - Платный аккаунт разработчика ($99/год)
    2. App ID - Зарегистрированный идентификатор приложения (например, com.yourcompany.yourapp)
    3. Service ID - Для веб-аутентификации (например, com.yourcompany.auth)
    4. Приватный ключ - Сгенерированный в портале разработчика Apple
    5. Team ID - Из вашего аккаунта разработчика Apple
    Настройка в Apple Developer Portal
    1. Создание App ID:

      • Перейдите в Certificates, Identifiers & Profiles
      • Нажмите + → Выберите App IDs
      • Зарегистрируйте приложение с bundle ID (например, com.sonoratek.ring)
      • Включите возможность Sign in with Apple
    2. Создание Service ID:

      • В разделе Identifiers → Нажмите + → Выберите Services IDs
      • Создайте service ID (например, com.sonoratek.ring-auth)
      • Включите Sign in with Apple
      • Настройте Return URLs (URL-адреса обратного вызова вашего приложения)
    3. Генерация приватного ключа:

      • Перейдите в Keys → Нажмите +
      • Назовите ключ (например, "Auth Key for Ring Platform")
      • Включите Sign in with Apple
      • Выберите ваш App ID
      • Скачайте файл приватного ключа .p8 (храните в безопасности!)
    Конфигурация окружения

    Добавьте эти переменные в ваш .env.local:

    Конфигурация входа через Apple

    Генерация JWT

    Apple требует JWT, подписанный вашим приватным ключом. Используйте этот скрипт Node.js:

    Конфигурация Auth.js v5

    Вход через Apple автоматически настраивается в вашем auth.config.ts:

    Использование в компонентах
    Особенности пользовательского опыта
    • Одно касание аутентификации на устройствах Apple
    • Ориентированность на приватность - Нет сбора email без согласия пользователя
    • Безопасный обмен токенами - Валидация на стороне сервера
    • Связывание аккаунтов - Подключение к существующим аккаунтам
    • Кросс-платформенная поддержка - Работает на веб и мобильных
    Меры безопасности
    • Защита приватного ключа - Никогда не коммитьте файлы .p8 в систему контроля версий
    • Истечение JWT - Перегенерируйте токены каждые 6 месяцев
    • Изоляция окружений - Используйте разные ключи для dev/staging/production
    • Аудит логирования - Отслеживайте события аутентификации
    • Ограничение частоты запросов - Защита от злоупотреблений
    Устранение неполадок

    Распространенные проблемы:

    • "Invalid client" ошибка: Проверьте, что AUTH_APPLE_ID соответствует вашему Service ID
    • "Invalid JWT" ошибка: Проверьте генерацию JWT и срок действия
    • "Domain verification failed": Убедитесь, что return URLs правильно настроены
    • "Key not found" ошибка: Проверьте доступность и корректность приватного ключа

    Советы по отладке:

    • Проверьте логи сервера для детальных сообщений об ошибках
    • Проверьте структуру полезной нагрузки JWT и подпись
    • Тестируйте с инструментами разработчика Apple
    • Убедитесь в правильной верификации домена в Apple Developer portal

    Crypto Wallets

    • MetaMask - Ethereum wallet authentication
    • WalletConnect - Multi-wallet support
    • Coinbase Wallet - Mainstream crypto wallet
    • Trust Wallet - Mobile-first wallet integration

    Implementation

    Authentication Setup

    Role-Based Access

    // Check user role


    Complete authentication documentation coming soon.

    Authentication System

    Auth.js v5 multi-provider authentication with magic links, OAuth providers, crypto wallets, and GDPR compliance.

    Модель защиты v1.6.0

    СлойРоль
    proxy.tsПерезапись локали + optimistic redirect на ROUTES.LOGIN(locale)
    (authenticated)/[locale]/layout.tsxawait auth() — каноничный gate сессии
    (admin)/[locale]/layout.tsxПроверка роли (ADMIN/SUPERADMIN)
    API routesauth() в каждом handler

    OAuth: /api/auth/* исключено из intl middleware. См. Proxy и intl.

    Overview

    Ring Platform uses Auth.js v5 to provide seamless authentication across multiple providers while maintaining security and user privacy.

    Authentication Providers

    Magic Links

    • Passwordless Authentication - Email-based secure login
    • One-click Access - No password required
    • Secure Tokens - Time-limited access tokens
    • GDPR Compliant - Privacy-first approach

    OAuth Providers

    • Google - Primary OAuth provider for web and mobile
    • Apple - iOS/macOS native integration with Sign in with Apple
    • GitHub - Developer-focused authentication
    • Discord - Community platform integration

    Интеграция входа через Apple

    Платформа Ring поддерживает бесшовную интеграцию Sign in with Apple с использованием Auth.js v5.

    Необходимые условия

    Перед настройкой входа через Apple убедитесь, что у вас есть:

    1. Аккаунт разработчика Apple - Платный аккаунт разработчика ($99/год)
    2. App ID - Зарегистрированный идентификатор приложения (например, com.yourcompany.yourapp)
    3. Service ID - Для веб-аутентификации (например, com.yourcompany.auth)
    4. Приватный ключ - Сгенерированный в портале разработчика Apple
    5. Team ID - Из вашего аккаунта разработчика Apple
    Настройка в Apple Developer Portal
    1. Создание App ID:

      • Перейдите в Certificates, Identifiers & Profiles
      • Нажмите + → Выберите App IDs
      • Зарегистрируйте приложение с bundle ID (например, com.sonoratek.ring)
      • Включите возможность Sign in with Apple
    2. Создание Service ID:

      • В разделе Identifiers → Нажмите + → Выберите Services IDs
      • Создайте service ID (например, com.sonoratek.ring-auth)
      • Включите Sign in with Apple
      • Настройте Return URLs (URL-адреса обратного вызова вашего приложения)
    3. Генерация приватного ключа:

      • Перейдите в Keys → Нажмите +
      • Назовите ключ (например, "Auth Key for Ring Platform")
      • Включите Sign in with Apple
      • Выберите ваш App ID
      • Скачайте файл приватного ключа .p8 (храните в безопасности!)
    Конфигурация окружения

    Добавьте эти переменные в ваш .env.local:

    Конфигурация входа через Apple

    Генерация JWT

    Apple требует JWT, подписанный вашим приватным ключом. Используйте этот скрипт Node.js:

    Конфигурация Auth.js v5

    Вход через Apple автоматически настраивается в вашем auth.config.ts:

    Использование в компонентах
    Особенности пользовательского опыта
    • Одно касание аутентификации на устройствах Apple
    • Ориентированность на приватность - Нет сбора email без согласия пользователя
    • Безопасный обмен токенами - Валидация на стороне сервера
    • Связывание аккаунтов - Подключение к существующим аккаунтам
    • Кросс-платформенная поддержка - Работает на веб и мобильных
    Меры безопасности
    • Защита приватного ключа - Никогда не коммитьте файлы .p8 в систему контроля версий
    • Истечение JWT - Перегенерируйте токены каждые 6 месяцев
    • Изоляция окружений - Используйте разные ключи для dev/staging/production
    • Аудит логирования - Отслеживайте события аутентификации
    • Ограничение частоты запросов - Защита от злоупотреблений
    Устранение неполадок

    Распространенные проблемы:

    • "Invalid client" ошибка: Проверьте, что AUTH_APPLE_ID соответствует вашему Service ID
    • "Invalid JWT" ошибка: Проверьте генерацию JWT и срок действия
    • "Domain verification failed": Убедитесь, что return URLs правильно настроены
    • "Key not found" ошибка: Проверьте доступность и корректность приватного ключа

    Советы по отладке:

    • Проверьте логи сервера для детальных сообщений об ошибках
    • Проверьте структуру полезной нагрузки JWT и подпись
    • Тестируйте с инструментами разработчика Apple
    • Убедитесь в правильной верификации домена в Apple Developer portal

    Crypto Wallets

    • MetaMask - Ethereum wallet authentication
    • WalletConnect - Multi-wallet support
    • Coinbase Wallet - Mainstream crypto wallet
    • Trust Wallet - Mobile-first wallet integration

    Implementation

    Authentication Setup

    Role-Based Access

    // Check user role


    Complete authentication documentation coming soon.

    Управление вендорами
    Комиссии и расчёты
    Реферальные коды (Refcodes)
    Интеграция платежей
    PaymentConductor
    Интеграция WayForPay
    Модуль Новостей - Цифровой Газетный Опыт
    Блоги участников
    Научный редактор
    Система локалей
    Безопасность и соответствие
    NFT Маркетплейс
    Система Стейкинга Токенов
    Паттерны Оптимизации Производительности
    Мобильный Опыт
    Администрирование
    Best Practices
    Workflow
    Code Style
    Performance
    Testing
    Deployment
    Debugging
    Contributing
    Api Examples
    ringdom.org — база LegioX
    Исходники — лицензия MIT (GitHub)
    Proxy и интернационализация
    Real Time
    Security
    Web3 Кошелек
    Store
    Ring ERP
    Склад и остатки
    Управление вендорами
    Комиссии и расчёты
    Реферальные коды (Refcodes)
    Интеграция платежей
    PaymentConductor
    Интеграция WayForPay
    Модуль Новостей - Цифровой Газетный Опыт
    Блоги участников
    Научный редактор
    Система локалей
    Безопасность и соответствие
    NFT Маркетплейс
    Система Стейкинга Токенов
    Паттерны Оптимизации Производительности
    Мобильный Опыт
    Администрирование
    Best Practices
    Workflow
    Code Style
    Performance
    Testing
    Deployment
    Debugging
    Contributing
    Api Examples
    ringdom.org — база LegioX
    Исходники — лицензия MIT (GitHub)
    Proxy и интернационализация
    Real Time
    Security
    Web3 Кошелек
    Store
    Ring ERP
    Склад и остатки
    Управление вендорами
    Комиссии и расчёты
    Реферальные коды (Refcodes)
    Интеграция платежей
    PaymentConductor
    Интеграция WayForPay
    Модуль Новостей - Цифровой Газетный Опыт
    Блоги участников
    Научный редактор
    Система локалей
    Безопасность и соответствие
    NFT Маркетплейс
    Система Стейкинга Токенов
    Паттерны Оптимизации Производительности
    Мобильный Опыт
    Администрирование
    Best Practices
    Workflow
    Code Style
    Performance
    Testing
    Deployment
    Debugging
    Contributing
    Api Examples
    ringdom.org — база LegioX
    Исходники — лицензия MIT (GitHub)
    Назад
    Назад
    Назад