Швидкий старт: Ваше перше клонування Ring
Орієнтовний час: 30 хвилин | Передумови: Git, Node.js 18+, базові знання командного рядка
Цей посібник проведе вас від нуля до розгорнутої платформи Ring. Наприкінці у вас буде власна брендована платформа, що працює в продакшені.
Перед початком
Що вам знадобиться:
- Git встановлений
- Node.js 18 або вище
- Редактор коду (рекомендується VS Code)
- Опціонально: Docker для контейнерного розгортання
Що ви отримаєте:
- Повнофункціональну платформу Ring
- 20+ інтегрованих модулів
- ШІ-підсилений підбір можливостей
- Багатовендорний ринок
- Гаманець з підтримкою токенів RING
- Продакшен-готове розгортання
Крок 1: Клонувати репозиторій
Відкрийте термінал та клонуйте платформу Ring:
git clone https://github.com/connectplatform/ring-platform.git
cd ring-platformВстановіть залежності:
npm installЗапустіть сервер розробки:
npm run devВідкрийте http://localhost:3000 у браузері. Ви маєте побачити вашу платформу Ring, що працює локально!
Крок 2: Базова конфігурація
Створіть файл середовища:
Скопіюйте приклад файлу середовища:
# cp .env.example .env.localНалаштуйте вашу платформу:
Відредагуйте .env.local з вашими налаштуваннями:
Назва вашої платформи Ваш домен (для продакшену) Виберіть вашу базу даних (почніть з Firebase для простоти)
NEXT_PUBLIC_APP_NAME="Моя платформа Ring"
NEXT_PUBLIC_APP_URL="https://myplatform.com"
DATABASE_MODE=firebase_onlyНалаштуйте аутентифікацію:
Для швидкого прототипування Ring постачається з попередньо налаштованою аутентифікацією Google. Додайте ваші облікові дані OAuth Google до .env.local:
GOOGLE_CLIENT_SECRET=your_google_client_secretКрок 3: Налаштувати брендинг
Оновіть назву та опис платформи:
Відредагуйте lib/config/site.ts:
name: "Назва моєї платформи",
description: "Вирішуємо [ваша місія] колективно за допомогою сили ШІ",
url: "https://myplatform.com",
}Налаштуйте кольори та тему:
Відредагуйте tailwind.config.js для відповідності вашому бренду:
extend: {
colors: {
primary: {
50: '#your-brand-color-50',
// ... додайте кольори вашого бренду
}
}
}
}Додайте ваш логотип:
Замініть файли логотипів у директорії public/:
logo.svg- основний логотипfavicon.ico- фавікон браузера
Крок 4: Розгорнути в продакшен
Виберіть метод розгортання:
Варіант A: Vercel (Рекомендовано для початківців)
npm i -g vercel
vercel --prodВаріант B: Docker
docker build -t my-ring-platform .
docker run -p 3000:3000 my-ring-platformВаріант C: Традиційне хостинг
npm run build
npm startНалаштуйте продакшен-середовище:
Встановіть змінні продакшен-середовища у вашому провайдері хостингу:
NODE_ENV=productionNEXT_PUBLIC_APP_URL=https://yourdomain.com- Рядки з'єднання з базою даних
Налаштуйте домен:
Направте ваш домен до розгортання та оновіть DNS-записи за потреби.
Крок 5: Увімкнути основні функції
Увімкніть реєстрацію користувачів:
Ring постачається з аутентифікацією, готовою до використання. Користувачі можуть реєструватися за допомогою Google чи email.
Налаштуйте ваші перші типи організацій:
Перейдіть до /admin/entities, щоб налаштувати типи організацій, які використовуватимуть вашу платформу (компанії, кооперативи, некомерційні організації тощо)
Налаштуйте категорії можливостей:
Визначте типи можливостей, які ваші користувачі можуть публікувати (проекти, партнерства, послуги тощо.)
Увімкніть функції ринку:
Налаштуйте категорії магазину та методи оплати для вашого ринку.
Крок 6: Запустити!
Перевірте, що все працює:
- Аутентифікація користувачів та вхід ✓
- Створення організацій та можливостей ✓
- Публікація на ринку ✓
- Базова навігація ✓
Запросіть ваших перших користувачів:
Поділіться URL вашої платформи та розпочніть будувати спільноту.
Моніторте та оптимізуйте:
Використовуйте вбудовану аналітику Ring для відстеження використання та оптимізації платформи.
Що далі?
Вітаємо! У вас тепер є продакшен-платформа Ring. Ось ваші наступні кроки:
Негайно (Тиждень 1)
- Запросіть 5-10 користувачів для зворотного зв'язку
- Налаштуйте решту елементів брендингу
- Налаштуйте обробку платежів
- Налаштуйте вподобання підбору ШІ
Короткостроково (Місяць 1)
- Повний посібник налаштування для розширеного брендингу
- Міграція бази даних якщо вам потрібен PostgreSQL
- Налаштування економіки токенів для власного токена RING
- Інтеграція платежів для монетизації
Довгостроково (Місяці 2-6)
- Налаштування ШІ для спеціалізованого підбору
- Багатотenant розгортання для масштабу
- Розробка власних модулів
- Розширені інтеграції
Потрібна допомога?
- Заблукали? Перевірте наш посібник з усунення несправностей
- Спільнота Приєднуйтеся до нашої спільноти розробників
- Професійна допомога Опублікуйте на можливостях налаштування Ring
Професійна порада: Починайте просто, потім додавайте складність. Більшість успішних розгортань Ring починаються з основних функцій та поступово вмикають розширені модулі зі зростанням їхньої спільноти.