Ring Platform Logo

    Loading Documentation Hub...

    Scanning documentation library

    Documentation

    Вітаємо — місія та аудиторії

    Ласкаво просимо до Ring Platform - Врата між Людством та Квантовим Світом

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

    Ласкаво просимо до Ring Platform — Врата між Людством і Квантовим Світом

    Початок роботи

    Індекс
    Передумови
    Встановлення
    Міграції бази даних
    Валідація першого успіху
    Усунення несправностей
    Next Steps

    Архітектура

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

    Функції

    Індекс
    Authentication
    Email AI-CRM
    Сутності
    Можливості
    Повідомлення
    Notifications
    Push-сповіщення через FCM (Ring)
    Web3 Гаманець
    Магазин
    Ring ERP

    API-інтерфейс

    Індекс
    Аутентифікація
    Email AI-CRM API
    Entities
    Можливості
    API повідомлень
    API повідомлень
    Гаманець
    API магазину

    CLI

    Ring CLI (лише enterprise)

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

    Індекс
    Брендування
    Функції
    Локалізація
    Теми
    Компоненти

    Розгортання

    Index
    Self-hosted розгортання
    Vercel
    Docker
    Environment
    Моніторинг та аналітика
    Оптимізація продуктивності
    Резервне копіювання та відновлення

    Розробка

    Розробка
    Локальне налаштування
    Структура коду
    Community tooling
    Ring MCP Server
    Генеративні зображення (ImageConductor)
    Автономна редакція (Grok)
    OSS vs enterprise

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

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

    Приклади

    Приклади
    Швидкий старт
    Автентифікація
    Email AI-CRM — туторіал
    Інтеграція API
    Інтеграція Web3
    Білий лейбл
    Реальні приклади

    Інтеграції

    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 Platform — Врата між Людством і Квантовим Світом

    Початок роботи

    Індекс
    Передумови
    Встановлення
    Міграції бази даних
    Валідація першого успіху
    Усунення несправностей
    Next Steps

    Архітектура

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

    Функції

    Індекс
    Authentication
    Email AI-CRM
    Сутності
    Можливості
    Повідомлення
    Notifications
    Push-сповіщення через FCM (Ring)

    API-інтерфейс

    Індекс
    Аутентифікація
    Email AI-CRM API
    Entities
    Можливості
    API повідомлень
    API повідомлень
    Гаманець
    API магазину

    CLI

    Ring CLI (лише enterprise)

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

    Індекс
    Брендування
    Функції
    Локалізація
    Теми
    Компоненти

    Розгортання

    Index
    Self-hosted розгортання
    Vercel
    Docker
    Environment
    Моніторинг та аналітика
    Оптимізація продуктивності
    Резервне копіювання та відновлення

    Розробка

    Розробка
    Локальне налаштування
    Структура коду
    Community tooling
    Ring MCP Server
    Генеративні зображення (ImageConductor)
    Автономна редакція (Grok)
    OSS vs enterprise

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

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

    Приклади

    Приклади
    Швидкий старт
    Автентифікація
    Email AI-CRM — туторіал
    Інтеграція API
    Інтеграція Web3
    Білий лейбл
    Реальні приклади

    Інтеграції

    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 Platform — Врата між Людством і Квантовим Світом

    Початок роботи

    Індекс
    Передумови
    Встановлення
    Міграції бази даних
    Валідація першого успіху
    Усунення несправностей
    Next Steps

    Архітектура

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

    Функції

    Індекс
    Authentication
    Email AI-CRM
    Сутності
    Можливості
    Повідомлення
    Notifications
    Push-сповіщення через FCM (Ring)

    API-інтерфейс

    Індекс
    Аутентифікація
    Email AI-CRM API
    Entities
    Можливості
    API повідомлень
    API повідомлень
    Гаманець
    API магазину

    CLI

    Ring CLI (лише enterprise)

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

    Індекс
    Брендування
    Функції
    Локалізація
    Теми
    Компоненти

    Розгортання

    Index
    Self-hosted розгортання
    Vercel
    Docker
    Environment
    Моніторинг та аналітика
    Оптимізація продуктивності
    Резервне копіювання та відновлення

    Розробка

    Розробка
    Локальне налаштування
    Структура коду
    Community tooling
    Ring MCP Server
    Генеративні зображення (ImageConductor)
    Автономна редакція (Grok)
    OSS vs enterprise

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

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

    Приклади

    Приклади
    Швидкий старт
    Автентифікація
    Email AI-CRM — туторіал
    Інтеграція API
    Інтеграція Web3
    Білий лейбл
    Реальні приклади

    Інтеграції

    Ethereum гаманці (Wagmi v3)

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

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

    Передумови

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

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

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

    2

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

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

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

    3

    Валідація OAuth

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

    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

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

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

    2

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

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

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

    3

    Валідація OAuth

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

    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

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

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

    2

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

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

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

    3

    Валідація OAuth

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

    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 для підтримки.

    Склад і залишки
    Керування вендорами
    Комісії та розрахунки
    Реферальні коди (Refcodes)
    Інтеграція платежів
    PaymentConductor
    Інтеграція WayForPay
    Модуль Новин - Цифровий Газетний Досвід
    Блоги учасників
    Науковий редактор
    Система локалей
    Безпека та відповідність
    NFT Маркетплейс
    Система Стейкінга Токенів
    Паттерни Оптимізації Продуктивності
    Мобільний Досвід
    API адміністратора
    Найкращі практики
    Workflow
    Code Style
    Performance
    Тестування
    Розгортання
    Налагодження
    Співпраця
    Приклади API
    ringdom.org — база LegioX
    Код — ліцензія MIT (GitHub)
    Proxy та інтернаціоналізація
    Real Time
    Security
    Web3 Гаманець
    Магазин
    Ring ERP
    Склад і залишки
    Керування вендорами
    Комісії та розрахунки
    Реферальні коди (Refcodes)
    Інтеграція платежів
    PaymentConductor
    Інтеграція WayForPay
    Модуль Новин - Цифровий Газетний Досвід
    Блоги учасників
    Науковий редактор
    Система локалей
    Безпека та відповідність
    NFT Маркетплейс
    Система Стейкінга Токенів
    Паттерни Оптимізації Продуктивності
    Мобільний Досвід
    API адміністратора
    Найкращі практики
    Workflow
    Code Style
    Performance
    Тестування
    Розгортання
    Налагодження
    Співпраця
    Приклади API
    ringdom.org — база LegioX
    Код — ліцензія MIT (GitHub)
    Proxy та інтернаціоналізація
    Real Time
    Security
    Web3 Гаманець
    Магазин
    Ring ERP
    Склад і залишки
    Керування вендорами
    Комісії та розрахунки
    Реферальні коди (Refcodes)
    Інтеграція платежів
    PaymentConductor
    Інтеграція WayForPay
    Модуль Новин - Цифровий Газетний Досвід
    Блоги учасників
    Науковий редактор
    Система локалей
    Безпека та відповідність
    NFT Маркетплейс
    Система Стейкінга Токенів
    Паттерни Оптимізації Продуктивності
    Мобільний Досвід
    API адміністратора
    Найкращі практики
    Workflow
    Code Style
    Performance
    Тестування
    Розгортання
    Налагодження
    Співпраця
    Приклади API
    ringdom.org — база LegioX
    Код — ліцензія MIT (GitHub)
    Назад
    Назад
    Назад