МожливостіСутності
Документація
    Ring Platform

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

    Увійти
    Сутності
    Можливості
    Магазин
    Документація
    Концепції
    RING ЕкономікаSonoratek LLCГлобальний впливAI зустрічає Web3
    Розпочати
    Швидкий стартКалькуляторДорожня карта
    Конфіденційність|Контакти
    v1.104.17|Sonoratek LLC

    Documentation

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

    Ласкаво просимо до Ring
    Швидкий довідник
    Початок роботи
    Передумови
    Встановлення
    Валідація першого успіху
    Наступні кроки
    Функції
    Магазин
    Склад і залишки
    Керування вендорами
    Комісії та розрахунки
    SubscriptionConductor
    PaymentConductor
    Ring Oracle
    Інтеграція платежів
    Публічні пули та DAO-банки
    Інтеграція WayForPay
    Web3 Гаманець
    WalletConductor
    Партнерська та реферальна підтримка
    Реферальні коди (Refcodes)
    NFT Exhibition Marketplace
    Solana NFT Gates
    Система Стейкінга Токенів
    Лабораторія проєкту власника (Owner Project Lab)
    Сутності
    Можливості
    Повідомлення
    Завдання Ring
    WebRTC-дзвінки та STUNner TURN
    Ігри з друзями
    Модуль Новин - Цифровий Газетний Досвід
    Блоги учасників
    Сторінки публічного профілю
    Віджети профілю облікового запису
    Ring File Cabinet
    Система Резервування Імен Користувачів
    Науковий редактор
    Notifications
    Push-сповіщення через FCM (Ring)
    Email AI-CRM
    Ring Mailer і RingdomX Mail
    Протокол Tunnel
    VideoConductor
    MediaConductor
    Generative Gallery
    Authentication
    Безпека та відповідність
    Консоль адміністратора
    Адмінська Wiki
    Керування через Telegram
    Система локалей
    Мобільний Досвід
    Паттерни Оптимізації Продуктивності
    Приклади
    Швидкий старт
    Базове налаштування
    Білий лейбл
    Користувацьке брендування
    Інтеграція Web3
    Реальні приклади
    Розширені функції
    Кастомізація
    Швидкий старт — ваш перший клон Ring
    Повний посібник налаштування
    Вертикальні пресети (SSOT)
    Ringization playbook
    Брендування
    Теми
    Функції
    Локалізація
    Налаштування токеноміки
    Інтеграція платіжних шлюзів
    Еталонні деплої Ring
    Конфігурація
    Публічні змінні середовища
    Секрети Order Lab
    Project ID WalletConnect (Reown Cloud)
    Підтримувані сервіси
    Вікі NODUS (знання проєкту)
    Плейбук конфігурації
    Web3
    Token launch jurisdictions
    Гаманець
    Поради з безпеки гаманця
    Інтеграції
    Ethereum гаманці (Wagmi v3)
    RingFileBase (API об’єктного сховища)
    Ring CDN (edge RingFileBase)
    Розгортання
    Self-hosted розгортання
    Vercel
    Docker
    Конфігурація Середовища
    Моніторинг та Аналітика
    Оптимізація продуктивності
    Резервне копіювання і відновлення
    Архітектура
    Data Model
    Security
    Real Time
    Синхронізація discovery після мутацій
    Архітектура PaymentConductor
    Архітектура WalletConductor
    Бекенд Сервіси
    Інтеграція 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
    Швидкий довідник
    Початок роботи
    Передумови
    Встановлення
    Валідація першого успіху
    Наступні кроки
    Функції
    Магазин
    Склад і залишки
    Керування вендорами
    Комісії та розрахунки
    SubscriptionConductor
    PaymentConductor
    Ring Oracle
    Інтеграція платежів
    Публічні пули та DAO-банки
    Інтеграція WayForPay
    Web3 Гаманець
    WalletConductor
    Партнерська та реферальна підтримка
    Реферальні коди (Refcodes)
    NFT Exhibition Marketplace
    Solana NFT Gates
    Система Стейкінга Токенів
    Лабораторія проєкту власника (Owner Project Lab)
    Сутності
    Можливості
    Повідомлення
    Завдання Ring
    WebRTC-дзвінки та STUNner TURN
    Ігри з друзями
    Модуль Новин - Цифровий Газетний Досвід
    Блоги учасників
    Сторінки публічного профілю
    Віджети профілю облікового запису
    Ring File Cabinet
    Система Резервування Імен Користувачів
    Науковий редактор
    Notifications
    Push-сповіщення через FCM (Ring)
    Email AI-CRM
    Ring Mailer і RingdomX Mail
    Протокол Tunnel
    VideoConductor
    MediaConductor
    Generative Gallery
    Authentication
    Безпека та відповідність
    Консоль адміністратора
    Адмінська Wiki
    Керування через Telegram
    Система локалей
    Мобільний Досвід
    Паттерни Оптимізації Продуктивності
    Приклади
    Швидкий старт
    Базове налаштування
    Білий лейбл
    Користувацьке брендування
    Інтеграція Web3
    Реальні приклади
    Розширені функції
    Кастомізація
    Швидкий старт — ваш перший клон Ring
    Повний посібник налаштування
    Вертикальні пресети (SSOT)
    Ringization playbook
    Брендування
    Теми
    Функції
    Локалізація
    Налаштування токеноміки
    Інтеграція платіжних шлюзів
    Еталонні деплої Ring
    Конфігурація
    Публічні змінні середовища
    Секрети Order Lab
    Project ID WalletConnect (Reown Cloud)
    Підтримувані сервіси
    Вікі NODUS (знання проєкту)
    Плейбук конфігурації
    Web3
    Token launch jurisdictions
    Гаманець
    Поради з безпеки гаманця
    Інтеграції
    Ethereum гаманці (Wagmi v3)
    RingFileBase (API об’єктного сховища)
    Ring CDN (edge RingFileBase)
    Розгортання
    Self-hosted розгортання
    Vercel
    Docker
    Конфігурація Середовища
    Моніторинг та Аналітика
    Оптимізація продуктивності
    Резервне копіювання і відновлення
    Архітектура
    Data Model
    Security
    Real Time
    Синхронізація discovery після мутацій
    Архітектура PaymentConductor
    Архітектура WalletConductor
    Бекенд Сервіси
    Інтеграція 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
    Швидкий довідник
    Початок роботи
    Передумови
    Встановлення
    Валідація першого успіху
    Наступні кроки
    Функції
    Магазин
    Склад і залишки
    Керування вендорами
    Комісії та розрахунки
    SubscriptionConductor
    PaymentConductor
    Ring Oracle
    Інтеграція платежів
    Публічні пули та DAO-банки
    Інтеграція WayForPay
    Web3 Гаманець
    WalletConductor
    Партнерська та реферальна підтримка
    Реферальні коди (Refcodes)
    NFT Exhibition Marketplace
    Solana NFT Gates
    Система Стейкінга Токенів
    Лабораторія проєкту власника (Owner Project Lab)
    Сутності
    Можливості
    Повідомлення
    Завдання Ring
    WebRTC-дзвінки та STUNner TURN
    Ігри з друзями
    Модуль Новин - Цифровий Газетний Досвід
    Блоги учасників
    Сторінки публічного профілю
    Віджети профілю облікового запису
    Ring File Cabinet
    Система Резервування Імен Користувачів
    Науковий редактор
    Notifications
    Push-сповіщення через FCM (Ring)
    Email AI-CRM
    Ring Mailer і RingdomX Mail
    Протокол Tunnel
    VideoConductor
    MediaConductor
    Generative Gallery
    Authentication
    Безпека та відповідність
    Консоль адміністратора
    Адмінська Wiki
    Керування через Telegram
    Система локалей
    Мобільний Досвід
    Паттерни Оптимізації Продуктивності
    Приклади
    Швидкий старт
    Базове налаштування
    Білий лейбл
    Користувацьке брендування
    Інтеграція Web3
    Реальні приклади
    Розширені функції
    Кастомізація
    Швидкий старт — ваш перший клон Ring
    Повний посібник налаштування
    Вертикальні пресети (SSOT)
    Ringization playbook
    Брендування
    Теми
    Функції
    Локалізація
    Налаштування токеноміки
    Інтеграція платіжних шлюзів
    Еталонні деплої Ring
    Конфігурація
    Публічні змінні середовища
    Секрети Order Lab
    Project ID WalletConnect (Reown Cloud)
    Підтримувані сервіси
    Вікі NODUS (знання проєкту)
    Плейбук конфігурації
    Web3
    Token launch jurisdictions
    Гаманець
    Поради з безпеки гаманця
    Інтеграції
    Ethereum гаманці (Wagmi v3)
    RingFileBase (API об’єктного сховища)
    Ring CDN (edge RingFileBase)
    Розгортання
    Self-hosted розгортання
    Vercel
    Docker
    Конфігурація Середовища
    Моніторинг та Аналітика
    Оптимізація продуктивності
    Резервне копіювання і відновлення
    Архітектура
    Data Model
    Security
    Real Time
    Синхронізація discovery після мутацій
    Архітектура PaymentConductor
    Архітектура WalletConductor
    Бекенд Сервіси
    Інтеграція 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

    Передумови

    Цей всебічний посібник охоплює всі вимоги для налаштування платформи Ring для розробки та виробничого розгортання. Платформа Ring побудована із сучасними веб-технологіями та вимагає специфічних конфігурацій системи для оптимальної продуктивності.

    ⏱️ Орієнтовний час налаштування

    15-30 хвилин для повного налаштування залежно від вашого рівня досвіду та швидкості інтернет-з'єднання.

    🖥️ Системні вимоги

    Мінімальні вимоги до обладнання

    КомпонентРозробкаВиробництво
    CPU4 ядра (Intel i5/AMD Ryzen 5)8+ ядер (Intel i7/AMD Ryzen 7)
    RAM8GB16GB+
    Сховище10GB вільного місця50GB+ SSD
    Мережа10 Mbps100 Mbps+

    Підтримувані операційні системи

    • macOS: 12.0+ (Monterey або новіша)
    • Linux: Ubuntu 20.04+, CentOS 8+, Debian 11+
    • Windows: 10/11 з WSL2 (Windows Subsystem for Linux)
    • Docker: Для контейнеризованої розробки та розгортання
    Користувачі Windows

    Хоча платформа Ring працює на Windows з WSL2, ми рекомендуємо використовувати Linux або macOS для найкращого досвіду розробки. Деякі функції можуть мати обмежену підтримку Windows.

    🟢 Node.js & управління пакетами

    Необхідні версії

    Платформа Ring вимагає Node.js 18.17+ та npm 8.19+ (або еквівалентні менеджери пакетів).

    Перевірка поточних версій

    Рекомендоване налаштування

    Варіант 1: Node Version Manager (Рекомендовано)

    macOS/Linux з nvm: Встановлення nvm Перезавантаження терміналу або виконання: Встановлення та використання Node.js 18

    Windows з nvm-windows: Завантаження та встановлення з https://github.com/coreybutler/nvm-windows/releases Потім встановлення Node.js 18

    Варіант 2: Офіційні інсталятори

    Завантаження з nodejs.org та встановлення Node.js 18 LTS.

    Варіант 3: Менеджери пакетів

    macOS з Homebrew:

    Ubuntu/Debian:

    Конфігурація менеджера пакетів

    Конфігурація npm для кращої продуктивності Необов'язково: Використання yarn для швидших інсталяцій

    🗄️ Налаштування бази даних

    Платформа Ring підтримує кілька бекендів баз даних із PostgreSQL як основною рекомендацією.

    Варіант 1: PostgreSQL (Рекомендовано для виробництва)

    Налаштування для локальної розробки

    macOS з Homebrew: Створення бази даних

    Ubuntu/Debian: Запуск сервісу Створення бази даних

    Docker (кросплатформний): Запуск PostgreSQL у Docker Для постійних даних

    Варіанти PostgreSQL у хмарі

    • Supabase: Керований PostgreSQL з функціями реального часу
    • Neon: Серверний PostgreSQL
    • AWS RDS: Підприємницький хостинг PostgreSQL
    • Google Cloud SQL: Керований сервіс PostgreSQL
    • Azure Database: Пропозиція PostgreSQL від Microsoft

    Варіант 2: Firebase (Розробка/Легасі)

    Хоча Firebase все ще підтримується для сумісності, PostgreSQL настійно рекомендується для нових розгортань.

    🔐 Провайдери аутентифікації

    Платформа Ring використовує Auth.js v5 з кількома провайдерами OAuth для безпечної аутентифікації.

    Налаштування Google OAuth

    1. Створення проекту Google Cloud

      • Перейти до Google Cloud Console
      • Створити новий проект або вибрати існуючий
    2. Увімкнення Google+ API

      • Перейти до "APIs & Services" > "Library"
      • Знайти та увімкнути "Google+ API"
    3. Створення облікових даних OAuth

      • Перейти до "APIs & Services" > "Credentials"
      • Натиснути "Create Credentials" > "OAuth 2.0 Client IDs"
      • Обрати "Web application"
      • Додати авторизовані джерела:
        • http://localhost:3000 (розробка)
        • https://yourdomain.com (виробництво)
      • Додати авторизовані URI перенаправлення:
        • http://localhost:3000/api/auth/callback/google
        • https://yourdomain.com/api/auth/callback/google
    4. Отримання Client ID та Secret

      • Скопіювати Client ID та Client Secret

    Налаштування Sign-in з Apple (Необов'язково)

    Необхідно для iOS інтеграції додатку:

    1. Обліковий запис Apple Developer

      • Платний обліковий запис розробника ($99/рік)
      • Доступ до Apple Developer Portal
    2. Створення App ID

      • Certificates, Identifiers & Profiles > Identifiers
      • Створити новий App ID із можливістю Sign in with Apple
    3. Створення Service ID

      • Створити Services ID для веб-аутентифікації
      • Налаштувати повернення URL для вашого домену
    4. Створення приватного ключа

      • Створити новий ключ із можливістю Sign in with Apple
      • Завантажити файл .p8 (зберігати безпечно!)

    Додаткові провайдери OAuth (Необов'язкові)

    • GitHub: Аутентифікація для розробників
    • Discord: Інтеграція платформи спільноти
    • Twitter/X: Аутентифікація соціальних мереж

    🔑 Інтеграція гаманця Web3

    Для блокчейн-функцій, включаючи ринок NFT та операції з токенами RING.

    Налаштування MetaMask

    Встановлення розширення браузера MetaMask Відвідати: https://metamask.io/download/ Або встановити через менеджер пакетів macOS Linux Завантажити з офіційного веб-сайту

    Ключ шифрування гаманця

    Створіть безпечний ключ шифрування для операцій гаманця:

    Створення 256-бітного (32-байтового) шістнадцяткового ключа Приклад виводу: a1b2c3d4e5f678901234567890abcdef1234567890abcdef1234567890abcdef

    💰 Інтеграція оплати (WayForPay)

    Необхідно для оформлення замовлень у магазині та преміум-функцій.

    Налаштування облікового запису WayForPay

    1. Створення облікового запису продавця

      • Відвідати WayForPay
      • Зареєструватися як продавець
      • Завершити верифікацію KYC
    2. Отримання API облікових даних

      • Увійти до панелі продавця
      • Перейти до налаштувань API
      • Скопіювати Merchant Account та Secret Key
    3. Налаштування методів оплати

      • Увімкнути оплату картками
      • Налаштувати Apple Pay / Google Pay
      • Налаштувати підтримку валют (UAH, USD, EUR)

    🛠️ Інструменти розробки

    Основні інструменти

    Встановлення Git (якщо не встановлено) Встановлення залежностей розробки Необов'язково: Встановлення розширень VS Code - TypeScript and JavaScript Language Features - Tailwind CSS IntelliSense - Prettier - Code formatter - ESLint

    Рекомендоване налаштування IDE

    Visual Studio Code із цими розширеннями:

    • ms-vscode.vscode-typescript-next
    • bradlc.vscode-tailwindcss
    • esbenp.prettier-vscode
    • dbaeumer.vscode-eslint
    • ms-vscode.vscode-json

    Шаблон файлу середовища

    Створіть .env.local із наданого шаблону:

    🌐 Мережеві вимоги

    Розробка

    • Інтернет-з'єднання: Необхідне для встановлення пакетів та тестування OAuth
    • Локальні порти: 3000 (Next.js), 5432 (PostgreSQL)
    • Файрвол: Дозволити вихідні HTTPS-з'єднання

    Виробництво

    • SSL-сертифікат: Необхідний для HTTPS (Let's Encrypt рекомендується)
    • Домен: Користувацький домен рекомендується
    • CDN: Необов'язковий, але рекомендується для статичних ресурсів
    • WebSocket підтримка: Необхідна для функцій реального часу

    🔒 Міри безпеки

    Змінні середовища

    Ніколи не фіксувати конфіденційні дані в системі контролю версій:

    .env.local (розробка - зберігати локально) .env.production (виробництво - встановити через платформу розгортання) Ті ж змінні, але з виробничими значеннями

    Дозволи файлів

    Захистити файли середовища Захистити приватні ключі

    🧪 Контрольний список валідації

    Запустіть ці команди для перевірки налаштування:

    1. 1

      Валідація системи

      Перевірка Node.js та npm Перевірка системних ресурсів Перевірка мережевого з'єднання

    2. 2

      Валідація бази даних

      PostgreSQL: Перевірка з'єднання Або з Docker

      Firebase (якщо використовується): Перевірка CLI Firebase Вхід до Firebase

    3. 3

      Валідація OAuth

      Перевірка формату облікових даних Google OAuth Перевірка облікових даних Apple (якщо використовується) Перевірка доступності URL

    4. 4

      Валідація Web3

      Перевірка формату ключа шифрування гаманця Перевірка встановлення MetaMask (ручна) Відкрити браузер та перевірити розширення MetaMask

    🐛 Усунення поширених проблем

    Проблеми з версією Node.js

    Якщо ви бачите "Node.js version not supported"

    Проблеми з'єднання з базою даних

    PostgreSQL: Перевірка запуску PostgreSQL Скидання пароля PostgreSQL

    Firebase: Повторна аутентифікація Firebase Перевірка доступу до проекту

    Проблеми конфігурації OAuth

    Мережеві та файрвол проблеми

    Перевірка з'єднання з необхідними сервісами Перевірка дозволу DNS Перевірити на іншій мережі, якщо проблеми зберігаються

    📚 Наступні кроки

    Після виконання всіх передумов:

    1. Посібник встановлення - Клонувати та налаштувати проект
    2. Конфігурація середовища - Завершити налаштування .env.local
    3. Валідація першого успіху - Перевірити встановлення
    4. Робочий процес розробки - Почати робити внесок
    ✅ Готово до продовження

    Якщо всі валідації пройшли успішно, ви готові встановити платформу Ring! Перейдіть до Посібника встановлення для початку роботи.


    Потрібна допомога з налаштуванням? Приєднуйтеся до нашого Discord Community для підтримки.

    Передумови

    Цей всебічний посібник охоплює всі вимоги для налаштування платформи Ring для розробки та виробничого розгортання. Платформа Ring побудована із сучасними веб-технологіями та вимагає специфічних конфігурацій системи для оптимальної продуктивності.

    ⏱️ Орієнтовний час налаштування

    15-30 хвилин для повного налаштування залежно від вашого рівня досвіду та швидкості інтернет-з'єднання.

    🖥️ Системні вимоги

    Мінімальні вимоги до обладнання

    КомпонентРозробкаВиробництво
    CPU4 ядра (Intel i5/AMD Ryzen 5)8+ ядер (Intel i7/AMD Ryzen 7)
    RAM8GB16GB+
    Сховище10GB вільного місця50GB+ SSD
    Мережа10 Mbps100 Mbps+

    Підтримувані операційні системи

    • macOS: 12.0+ (Monterey або новіша)
    • Linux: Ubuntu 20.04+, CentOS 8+, Debian 11+
    • Windows: 10/11 з WSL2 (Windows Subsystem for Linux)
    • Docker: Для контейнеризованої розробки та розгортання
    Користувачі Windows

    Хоча платформа Ring працює на Windows з WSL2, ми рекомендуємо використовувати Linux або macOS для найкращого досвіду розробки. Деякі функції можуть мати обмежену підтримку Windows.

    🟢 Node.js & управління пакетами

    Необхідні версії

    Платформа Ring вимагає Node.js 18.17+ та npm 8.19+ (або еквівалентні менеджери пакетів).

    Перевірка поточних версій

    Рекомендоване налаштування

    Варіант 1: Node Version Manager (Рекомендовано)

    macOS/Linux з nvm: Встановлення nvm Перезавантаження терміналу або виконання: Встановлення та використання Node.js 18

    Windows з nvm-windows: Завантаження та встановлення з https://github.com/coreybutler/nvm-windows/releases Потім встановлення Node.js 18

    Варіант 2: Офіційні інсталятори

    Завантаження з nodejs.org та встановлення Node.js 18 LTS.

    Варіант 3: Менеджери пакетів

    macOS з Homebrew:

    Ubuntu/Debian:

    Конфігурація менеджера пакетів

    Конфігурація npm для кращої продуктивності Необов'язково: Використання yarn для швидших інсталяцій

    🗄️ Налаштування бази даних

    Платформа Ring підтримує кілька бекендів баз даних із PostgreSQL як основною рекомендацією.

    Варіант 1: PostgreSQL (Рекомендовано для виробництва)

    Налаштування для локальної розробки

    macOS з Homebrew: Створення бази даних

    Ubuntu/Debian: Запуск сервісу Створення бази даних

    Docker (кросплатформний): Запуск PostgreSQL у Docker Для постійних даних

    Варіанти PostgreSQL у хмарі

    • Supabase: Керований PostgreSQL з функціями реального часу
    • Neon: Серверний PostgreSQL
    • AWS RDS: Підприємницький хостинг PostgreSQL
    • Google Cloud SQL: Керований сервіс PostgreSQL
    • Azure Database: Пропозиція PostgreSQL від Microsoft

    Варіант 2: Firebase (Розробка/Легасі)

    Хоча Firebase все ще підтримується для сумісності, PostgreSQL настійно рекомендується для нових розгортань.

    🔐 Провайдери аутентифікації

    Платформа Ring використовує Auth.js v5 з кількома провайдерами OAuth для безпечної аутентифікації.

    Налаштування Google OAuth

    1. Створення проекту Google Cloud

      • Перейти до Google Cloud Console
      • Створити новий проект або вибрати існуючий
    2. Увімкнення Google+ API

      • Перейти до "APIs & Services" > "Library"
      • Знайти та увімкнути "Google+ API"
    3. Створення облікових даних OAuth

      • Перейти до "APIs & Services" > "Credentials"
      • Натиснути "Create Credentials" > "OAuth 2.0 Client IDs"
      • Обрати "Web application"
      • Додати авторизовані джерела:
        • http://localhost:3000 (розробка)
        • https://yourdomain.com (виробництво)
      • Додати авторизовані URI перенаправлення:
        • http://localhost:3000/api/auth/callback/google
        • https://yourdomain.com/api/auth/callback/google
    4. Отримання Client ID та Secret

      • Скопіювати Client ID та Client Secret

    Налаштування Sign-in з Apple (Необов'язково)

    Необхідно для iOS інтеграції додатку:

    1. Обліковий запис Apple Developer

      • Платний обліковий запис розробника ($99/рік)
      • Доступ до Apple Developer Portal
    2. Створення App ID

      • Certificates, Identifiers & Profiles > Identifiers
      • Створити новий App ID із можливістю Sign in with Apple
    3. Створення Service ID

      • Створити Services ID для веб-аутентифікації
      • Налаштувати повернення URL для вашого домену
    4. Створення приватного ключа

      • Створити новий ключ із можливістю Sign in with Apple
      • Завантажити файл .p8 (зберігати безпечно!)

    Додаткові провайдери OAuth (Необов'язкові)

    • GitHub: Аутентифікація для розробників
    • Discord: Інтеграція платформи спільноти
    • Twitter/X: Аутентифікація соціальних мереж

    🔑 Інтеграція гаманця Web3

    Для блокчейн-функцій, включаючи ринок NFT та операції з токенами RING.

    Налаштування MetaMask

    Встановлення розширення браузера MetaMask Відвідати: https://metamask.io/download/ Або встановити через менеджер пакетів macOS Linux Завантажити з офіційного веб-сайту

    Ключ шифрування гаманця

    Створіть безпечний ключ шифрування для операцій гаманця:

    Створення 256-бітного (32-байтового) шістнадцяткового ключа Приклад виводу: a1b2c3d4e5f678901234567890abcdef1234567890abcdef1234567890abcdef

    💰 Інтеграція оплати (WayForPay)

    Необхідно для оформлення замовлень у магазині та преміум-функцій.

    Налаштування облікового запису WayForPay

    1. Створення облікового запису продавця

      • Відвідати WayForPay
      • Зареєструватися як продавець
      • Завершити верифікацію KYC
    2. Отримання API облікових даних

      • Увійти до панелі продавця
      • Перейти до налаштувань API
      • Скопіювати Merchant Account та Secret Key
    3. Налаштування методів оплати

      • Увімкнути оплату картками
      • Налаштувати Apple Pay / Google Pay
      • Налаштувати підтримку валют (UAH, USD, EUR)

    🛠️ Інструменти розробки

    Основні інструменти

    Встановлення Git (якщо не встановлено) Встановлення залежностей розробки Необов'язково: Встановлення розширень VS Code - TypeScript and JavaScript Language Features - Tailwind CSS IntelliSense - Prettier - Code formatter - ESLint

    Рекомендоване налаштування IDE

    Visual Studio Code із цими розширеннями:

    • ms-vscode.vscode-typescript-next
    • bradlc.vscode-tailwindcss
    • esbenp.prettier-vscode
    • dbaeumer.vscode-eslint
    • ms-vscode.vscode-json

    Шаблон файлу середовища

    Створіть .env.local із наданого шаблону:

    🌐 Мережеві вимоги

    Розробка

    • Інтернет-з'єднання: Необхідне для встановлення пакетів та тестування OAuth
    • Локальні порти: 3000 (Next.js), 5432 (PostgreSQL)
    • Файрвол: Дозволити вихідні HTTPS-з'єднання

    Виробництво

    • SSL-сертифікат: Необхідний для HTTPS (Let's Encrypt рекомендується)
    • Домен: Користувацький домен рекомендується
    • CDN: Необов'язковий, але рекомендується для статичних ресурсів
    • WebSocket підтримка: Необхідна для функцій реального часу

    🔒 Міри безпеки

    Змінні середовища

    Ніколи не фіксувати конфіденційні дані в системі контролю версій:

    .env.local (розробка - зберігати локально) .env.production (виробництво - встановити через платформу розгортання) Ті ж змінні, але з виробничими значеннями

    Дозволи файлів

    Захистити файли середовища Захистити приватні ключі

    🧪 Контрольний список валідації

    Запустіть ці команди для перевірки налаштування:

    1. 1

      Валідація системи

      Перевірка Node.js та npm Перевірка системних ресурсів Перевірка мережевого з'єднання

    2. 2

      Валідація бази даних

      PostgreSQL: Перевірка з'єднання Або з Docker

      Firebase (якщо використовується): Перевірка CLI Firebase Вхід до Firebase

    3. 3

      Валідація OAuth

      Перевірка формату облікових даних Google OAuth Перевірка облікових даних Apple (якщо використовується) Перевірка доступності URL

    4. 4

      Валідація Web3

      Перевірка формату ключа шифрування гаманця Перевірка встановлення MetaMask (ручна) Відкрити браузер та перевірити розширення MetaMask

    🐛 Усунення поширених проблем

    Проблеми з версією Node.js

    Якщо ви бачите "Node.js version not supported"

    Проблеми з'єднання з базою даних

    PostgreSQL: Перевірка запуску PostgreSQL Скидання пароля PostgreSQL

    Firebase: Повторна аутентифікація Firebase Перевірка доступу до проекту

    Проблеми конфігурації OAuth

    Мережеві та файрвол проблеми

    Перевірка з'єднання з необхідними сервісами Перевірка дозволу DNS Перевірити на іншій мережі, якщо проблеми зберігаються

    📚 Наступні кроки

    Після виконання всіх передумов:

    1. Посібник встановлення - Клонувати та налаштувати проект
    2. Конфігурація середовища - Завершити налаштування .env.local
    3. Валідація першого успіху - Перевірити встановлення
    4. Робочий процес розробки - Почати робити внесок
    ✅ Готово до продовження

    Якщо всі валідації пройшли успішно, ви готові встановити платформу Ring! Перейдіть до Посібника встановлення для початку роботи.


    Потрібна допомога з налаштуванням? Приєднуйтеся до нашого Discord Community для підтримки.

    Передумови

    Цей всебічний посібник охоплює всі вимоги для налаштування платформи Ring для розробки та виробничого розгортання. Платформа Ring побудована із сучасними веб-технологіями та вимагає специфічних конфігурацій системи для оптимальної продуктивності.

    ⏱️ Орієнтовний час налаштування

    15-30 хвилин для повного налаштування залежно від вашого рівня досвіду та швидкості інтернет-з'єднання.

    🖥️ Системні вимоги

    Мінімальні вимоги до обладнання

    КомпонентРозробкаВиробництво
    CPU4 ядра (Intel i5/AMD Ryzen 5)8+ ядер (Intel i7/AMD Ryzen 7)
    RAM8GB16GB+
    Сховище10GB вільного місця50GB+ SSD
    Мережа10 Mbps100 Mbps+

    Підтримувані операційні системи

    • macOS: 12.0+ (Monterey або новіша)
    • Linux: Ubuntu 20.04+, CentOS 8+, Debian 11+
    • Windows: 10/11 з WSL2 (Windows Subsystem for Linux)
    • Docker: Для контейнеризованої розробки та розгортання
    Користувачі Windows

    Хоча платформа Ring працює на Windows з WSL2, ми рекомендуємо використовувати Linux або macOS для найкращого досвіду розробки. Деякі функції можуть мати обмежену підтримку Windows.

    🟢 Node.js & управління пакетами

    Необхідні версії

    Платформа Ring вимагає Node.js 18.17+ та npm 8.19+ (або еквівалентні менеджери пакетів).

    Перевірка поточних версій

    Рекомендоване налаштування

    Варіант 1: Node Version Manager (Рекомендовано)

    macOS/Linux з nvm: Встановлення nvm Перезавантаження терміналу або виконання: Встановлення та використання Node.js 18

    Windows з nvm-windows: Завантаження та встановлення з https://github.com/coreybutler/nvm-windows/releases Потім встановлення Node.js 18

    Варіант 2: Офіційні інсталятори

    Завантаження з nodejs.org та встановлення Node.js 18 LTS.

    Варіант 3: Менеджери пакетів

    macOS з Homebrew:

    Ubuntu/Debian:

    Конфігурація менеджера пакетів

    Конфігурація npm для кращої продуктивності Необов'язково: Використання yarn для швидших інсталяцій

    🗄️ Налаштування бази даних

    Платформа Ring підтримує кілька бекендів баз даних із PostgreSQL як основною рекомендацією.

    Варіант 1: PostgreSQL (Рекомендовано для виробництва)

    Налаштування для локальної розробки

    macOS з Homebrew: Створення бази даних

    Ubuntu/Debian: Запуск сервісу Створення бази даних

    Docker (кросплатформний): Запуск PostgreSQL у Docker Для постійних даних

    Варіанти PostgreSQL у хмарі

    • Supabase: Керований PostgreSQL з функціями реального часу
    • Neon: Серверний PostgreSQL
    • AWS RDS: Підприємницький хостинг PostgreSQL
    • Google Cloud SQL: Керований сервіс PostgreSQL
    • Azure Database: Пропозиція PostgreSQL від Microsoft

    Варіант 2: Firebase (Розробка/Легасі)

    Хоча Firebase все ще підтримується для сумісності, PostgreSQL настійно рекомендується для нових розгортань.

    🔐 Провайдери аутентифікації

    Платформа Ring використовує Auth.js v5 з кількома провайдерами OAuth для безпечної аутентифікації.

    Налаштування Google OAuth

    1. Створення проекту Google Cloud

      • Перейти до Google Cloud Console
      • Створити новий проект або вибрати існуючий
    2. Увімкнення Google+ API

      • Перейти до "APIs & Services" > "Library"
      • Знайти та увімкнути "Google+ API"
    3. Створення облікових даних OAuth

      • Перейти до "APIs & Services" > "Credentials"
      • Натиснути "Create Credentials" > "OAuth 2.0 Client IDs"
      • Обрати "Web application"
      • Додати авторизовані джерела:
        • http://localhost:3000 (розробка)
        • https://yourdomain.com (виробництво)
      • Додати авторизовані URI перенаправлення:
        • http://localhost:3000/api/auth/callback/google
        • https://yourdomain.com/api/auth/callback/google
    4. Отримання Client ID та Secret

      • Скопіювати Client ID та Client Secret

    Налаштування Sign-in з Apple (Необов'язково)

    Необхідно для iOS інтеграції додатку:

    1. Обліковий запис Apple Developer

      • Платний обліковий запис розробника ($99/рік)
      • Доступ до Apple Developer Portal
    2. Створення App ID

      • Certificates, Identifiers & Profiles > Identifiers
      • Створити новий App ID із можливістю Sign in with Apple
    3. Створення Service ID

      • Створити Services ID для веб-аутентифікації
      • Налаштувати повернення URL для вашого домену
    4. Створення приватного ключа

      • Створити новий ключ із можливістю Sign in with Apple
      • Завантажити файл .p8 (зберігати безпечно!)

    Додаткові провайдери OAuth (Необов'язкові)

    • GitHub: Аутентифікація для розробників
    • Discord: Інтеграція платформи спільноти
    • Twitter/X: Аутентифікація соціальних мереж

    🔑 Інтеграція гаманця Web3

    Для блокчейн-функцій, включаючи ринок NFT та операції з токенами RING.

    Налаштування MetaMask

    Встановлення розширення браузера MetaMask Відвідати: https://metamask.io/download/ Або встановити через менеджер пакетів macOS Linux Завантажити з офіційного веб-сайту

    Ключ шифрування гаманця

    Створіть безпечний ключ шифрування для операцій гаманця:

    Створення 256-бітного (32-байтового) шістнадцяткового ключа Приклад виводу: a1b2c3d4e5f678901234567890abcdef1234567890abcdef1234567890abcdef

    💰 Інтеграція оплати (WayForPay)

    Необхідно для оформлення замовлень у магазині та преміум-функцій.

    Налаштування облікового запису WayForPay

    1. Створення облікового запису продавця

      • Відвідати WayForPay
      • Зареєструватися як продавець
      • Завершити верифікацію KYC
    2. Отримання API облікових даних

      • Увійти до панелі продавця
      • Перейти до налаштувань API
      • Скопіювати Merchant Account та Secret Key
    3. Налаштування методів оплати

      • Увімкнути оплату картками
      • Налаштувати Apple Pay / Google Pay
      • Налаштувати підтримку валют (UAH, USD, EUR)

    🛠️ Інструменти розробки

    Основні інструменти

    Встановлення Git (якщо не встановлено) Встановлення залежностей розробки Необов'язково: Встановлення розширень VS Code - TypeScript and JavaScript Language Features - Tailwind CSS IntelliSense - Prettier - Code formatter - ESLint

    Рекомендоване налаштування IDE

    Visual Studio Code із цими розширеннями:

    • ms-vscode.vscode-typescript-next
    • bradlc.vscode-tailwindcss
    • esbenp.prettier-vscode
    • dbaeumer.vscode-eslint
    • ms-vscode.vscode-json

    Шаблон файлу середовища

    Створіть .env.local із наданого шаблону:

    🌐 Мережеві вимоги

    Розробка

    • Інтернет-з'єднання: Необхідне для встановлення пакетів та тестування OAuth
    • Локальні порти: 3000 (Next.js), 5432 (PostgreSQL)
    • Файрвол: Дозволити вихідні HTTPS-з'єднання

    Виробництво

    • SSL-сертифікат: Необхідний для HTTPS (Let's Encrypt рекомендується)
    • Домен: Користувацький домен рекомендується
    • CDN: Необов'язковий, але рекомендується для статичних ресурсів
    • WebSocket підтримка: Необхідна для функцій реального часу

    🔒 Міри безпеки

    Змінні середовища

    Ніколи не фіксувати конфіденційні дані в системі контролю версій:

    .env.local (розробка - зберігати локально) .env.production (виробництво - встановити через платформу розгортання) Ті ж змінні, але з виробничими значеннями

    Дозволи файлів

    Захистити файли середовища Захистити приватні ключі

    🧪 Контрольний список валідації

    Запустіть ці команди для перевірки налаштування:

    1. 1

      Валідація системи

      Перевірка Node.js та npm Перевірка системних ресурсів Перевірка мережевого з'єднання

    2. 2

      Валідація бази даних

      PostgreSQL: Перевірка з'єднання Або з Docker

      Firebase (якщо використовується): Перевірка CLI Firebase Вхід до Firebase

    3. 3

      Валідація OAuth

      Перевірка формату облікових даних Google OAuth Перевірка облікових даних Apple (якщо використовується) Перевірка доступності URL

    4. 4

      Валідація Web3

      Перевірка формату ключа шифрування гаманця Перевірка встановлення MetaMask (ручна) Відкрити браузер та перевірити розширення MetaMask

    🐛 Усунення поширених проблем

    Проблеми з версією Node.js

    Якщо ви бачите "Node.js version not supported"

    Проблеми з'єднання з базою даних

    PostgreSQL: Перевірка запуску PostgreSQL Скидання пароля PostgreSQL

    Firebase: Повторна аутентифікація Firebase Перевірка доступу до проекту

    Проблеми конфігурації OAuth

    Мережеві та файрвол проблеми

    Перевірка з'єднання з необхідними сервісами Перевірка дозволу DNS Перевірити на іншій мережі, якщо проблеми зберігаються

    📚 Наступні кроки

    Після виконання всіх передумов:

    1. Посібник встановлення - Клонувати та налаштувати проект
    2. Конфігурація середовища - Завершити налаштування .env.local
    3. Валідація першого успіху - Перевірити встановлення
    4. Робочий процес розробки - Почати робити внесок
    ✅ Готово до продовження

    Якщо всі валідації пройшли успішно, ви готові встановити платформу Ring! Перейдіть до Посібника встановлення для початку роботи.


    Потрібна допомога з налаштуванням? Приєднуйтеся до нашого Discord Community для підтримки.

    1. Документація
    2. /Початок роботи
    3. /Передумови

    Оновлено 16 жовт. 2025 р.6 хв прослуховування

    1. Документація
    2. /Початок роботи
    3. /Передумови

    Оновлено 16 жовт. 2025 р.6 хв прослуховування

    1. Документація
    2. /Початок роботи
    3. /Передумови

    Оновлено 16 жовт. 2025 р.6 хв прослуховування