Documentation

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

    Ласкаво просимо до Ring
    Швидкий довідник
    Початок роботи
    Передумови
    Встановлення
    Валідація першого успіху
    Наступні кроки
    Функції
    Магазин
    Склад і залишки
    Керування вендорами
    Комісії та розрахунки
    SubscriptionConductor
    PaymentConductor
    Інтеграція платежів
    Інтеграція WayForPay
    Web3 Гаманець
    Реферальні коди (Refcodes)
    NFT Exhibition Marketplace
    Система Стейкінга Токенів
    Сутності
    Можливості
    Повідомлення
    Модуль Новин - Цифровий Газетний Досвід
    Блоги учасників
    Система Резервування Імен Користувачів
    Науковий редактор
    Notifications
    Push-сповіщення через FCM (Ring)
    Email AI-CRM
    Протокол Tunnel
    Authentication
    Безпека та відповідність
    Система локалей
    Мобільний Досвід
    Паттерни Оптимізації Продуктивності
    Приклади
    Швидкий старт
    Білий лейбл
    Інтеграція Web3
    Реальні приклади
    Кастомізація
    Швидкий старт — ваш перший клон Ring
    Повний посібник налаштування
    Брендування
    Теми
    Функції
    Локалізація
    Налаштування токеноміки
    Інтеграція платіжних шлюзів
    Еталонні деплої Ring
    Web3
    Token launch jurisdictions
    Інтеграції
    Ethereum гаманці (Wagmi v3)
    Розгортання
    Self-hosted розгортання
    Vercel
    Docker
    Конфігурація Середовища
    Моніторинг та аналітика
    Оптимізація продуктивності
    Резервне копіювання та відновлення
    Архітектура
    Data Model
    Security
    Real Time
    Архітектура PaymentConductor
    Розробка
    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
    Інтеграція платежів
    Інтеграція WayForPay
    Web3 Гаманець
    Реферальні коди (Refcodes)
    NFT Exhibition Marketplace
    Система Стейкінга Токенів
    Сутності
    Можливості
    Повідомлення
    Модуль Новин - Цифровий Газетний Досвід
    Блоги учасників
    Система Резервування Імен Користувачів
    Науковий редактор
    Notifications
    Push-сповіщення через FCM (Ring)
    Email AI-CRM
    Протокол Tunnel
    Authentication
    Безпека та відповідність
    Система локалей
    Мобільний Досвід
    Паттерни Оптимізації Продуктивності
    Приклади
    Швидкий старт
    Білий лейбл
    Інтеграція Web3
    Реальні приклади
    Кастомізація
    Швидкий старт — ваш перший клон Ring
    Повний посібник налаштування
    Брендування
    Теми
    Функції
    Локалізація
    Налаштування токеноміки
    Інтеграція платіжних шлюзів
    Еталонні деплої Ring
    Web3
    Token launch jurisdictions
    Інтеграції
    Ethereum гаманці (Wagmi v3)
    Розгортання
    Self-hosted розгортання
    Vercel
    Docker
    Конфігурація Середовища
    Моніторинг та аналітика
    Оптимізація продуктивності
    Резервне копіювання та відновлення
    Архітектура
    Data Model
    Security
    Real Time
    Архітектура PaymentConductor
    Розробка
    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
    Інтеграція платежів
    Інтеграція WayForPay
    Web3 Гаманець
    Реферальні коди (Refcodes)
    NFT Exhibition Marketplace
    Система Стейкінга Токенів
    Сутності
    Можливості
    Повідомлення
    Модуль Новин - Цифровий Газетний Досвід
    Блоги учасників
    Система Резервування Імен Користувачів
    Науковий редактор
    Notifications
    Push-сповіщення через FCM (Ring)
    Email AI-CRM
    Протокол Tunnel
    Authentication
    Безпека та відповідність
    Система локалей
    Мобільний Досвід
    Паттерни Оптимізації Продуктивності
    Приклади
    Швидкий старт
    Білий лейбл
    Інтеграція Web3
    Реальні приклади
    Кастомізація
    Швидкий старт — ваш перший клон Ring
    Повний посібник налаштування
    Брендування
    Теми
    Функції
    Локалізація
    Налаштування токеноміки
    Інтеграція платіжних шлюзів
    Еталонні деплої Ring
    Web3
    Token launch jurisdictions
    Інтеграції
    Ethereum гаманці (Wagmi v3)
    Розгортання
    Self-hosted розгортання
    Vercel
    Docker
    Конфігурація Середовища
    Моніторинг та аналітика
    Оптимізація продуктивності
    Резервне копіювання та відновлення
    Архітектура
    Data Model
    Security
    Real Time
    Архітектура PaymentConductor
    Розробка
    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)
    1. Документація
    2. /Початок роботи
    3. /Передумови

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

    Ring Platform Logo

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

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

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

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

    Ring Platform Logo

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

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

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

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

    Ring Platform Logo

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

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

    Передумови

    Цей всебічний посібник охоплює всі вимоги для налаштування платформи 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 для підтримки.