Базовая настройка

Это руководство описывает минимальную локальную настройку Ring Platform. Это самый быстрый способ увидеть работающий экземпляр после клонирования репозитория.

Предварительные требования

Node.js 20+, PostgreSQL 16 и Git. Полный перечень требований описан в Руководстве по установке.

Что вы получаете

Работающий экземпляр Ring Platform с:

PostgreSQL как база данных приложения (режим k8s-postgres-fcm)
Auth.js v5 аутентификация с Google OAuth входом
Управление сущностями — создание и управление организациями
Маркетплейс возможностей — публикация и поиск объявлений
Уведомления в реальном времени через WebSocket туннель

Платформа работает на http://localhost:3000. Для базовой локальной работы не требуются облачные сервисы.

Дальнейшие шаги после настройки

После проверки локального экземпляра см. Локальная настройка для white-label кастомизации, флагов функций и расширенной конфигурации. Для продакшн-развертывания см. Конфигурация среды.

Пошаговая настройка

Клонирование и установка

bash


git clone https://github.com/connectplatform/ring.git
cd ring
npm install

Настройка среды

Скопируйте шаблон и отредактируйте необходимые переменные:

Как минимум, установите в .env.local:

Генерация AUTH_SECRET

Auth.js v5 может сгенерировать секрет автоматически при первом запуске. Или используйте npx auth secret для явной генерации. Подход openssl rand -hex 32 не требуется.

Полная справка переменных — в Конфигурация среды. Для локальной разработки рекомендуется AUTH_TRUST_HOST=true.

Настройка базы данных

Запустите PostgreSQL и создайте базу данных:

Примените схему и миграции:

Или используйте скрипт установки, который выполняет настройку базы данных:

См. Установка > Настройка PostgreSQL для дополнительных вариантов.

Запуск сервера разработки

Пользовательский server.ts запускает Next.js 16 с WebSocket туннелем на порту 3000.

Проверка

Ожидаемый ответ: {"status":"ok","timestamp":"..."}

Откройте http://localhost:3000/login для тестирования входа через Google OAuth.

Ключевые файлы

Файл	Назначение
`auth.ts`	Конфигурация Auth.js v5 — провайдеры, колбэки, стратегия JWT сессии
`lib/database/DatabaseService.ts`	Унифицированная абстракция базы данных (PostgreSQL или Firestore)
`lib/firebase-admin.server.ts`	Firebase Admin SDK для FCM push (только серверная часть)
`public/firebase-messaging-sw.js`	Сервис-воркер с Firebase клиентским SDK для push-уведомлений
`lib/tunnel/`	Транспорт реального времени через WebSocket
`data/schema.sql`	Схема PostgreSQL v4

Нет lib/firebase.ts

Ring Platform не имеет клиентского файла инициализации lib/firebase.ts. Клиентский Firebase SDK загружается исключительно внутри сервис-воркера (public/firebase-messaging-sw.js) через CDN importScripts(). Клиентского объекта firebaseConfig не существует. Серверный Firebase Admin использует lib/firebase-admin.server.ts с явными учетными данными сервисного аккаунта.

Технологический стек

Компонент	Версия / Провайдер
Framework	Next.js 16 App Router
UI	React 19
Auth	Auth.js v5 (`auth()` / `useSession()`)
Database	PostgreSQL 16 + PostGIS (или Firestore через `DB_BACKEND_MODE=firebase-full`)
Push	Firebase Cloud Messaging (серверный Admin SDK, клиентский сервис-воркер)
Payments	WayForPay (серверная HMAC верификация)
Locales	`next-intl`, поддерживаемые языки: en, uk, ru

Устранение неполадок

"FETCH_FAILED" или ошибки подключения к базе данных

Убедитесь, что PostgreSQL запущен и учетные данные в .env.local совпадают:

Google OAuth не работает

Проверьте Google Cloud Console — добавьте http://localhost:3000 в Authorized JavaScript origins
Добавьте http://localhost:3000/api/auth/callback/google в Authorized redirect URIs
Убедитесь, что AUTH_GOOGLE_ID и AUTH_GOOGLE_SECRET указаны в .env.local

Ошибки секрета аутентификации

Убедитесь, что AUTH_SECRET установлен в .env.local. Сгенерируйте с помощью:

Затем скопируйте результат в AUTH_SECRET.

Дальнейшие шаги

Руководство по установке — полная настройка со скриптом установки и расширенной конфигурацией базы данных
Локальная настройка — white-label конфигурация, флаги функций и рабочий процесс разработки
Конфигурация среды — справка всех переменных среды
Расширенные возможности — AI-матчер, верификация, PaymentConductor и другое

Базовая настройка

Предварительные требования

Node.js 20+, PostgreSQL 16 и Git. Полный перечень требований описан в Руководстве по установке.

Что вы получаете

Работающий экземпляр Ring Platform с:

PostgreSQL как база данных приложения (режим k8s-postgres-fcm)
Auth.js v5 аутентификация с Google OAuth входом
Управление сущностями — создание и управление организациями
Маркетплейс возможностей — публикация и поиск объявлений
Уведомления в реальном времени через WebSocket туннель

Платформа работает на http://localhost:3000. Для базовой локальной работы не требуются облачные сервисы.

Дальнейшие шаги после настройки

Пошаговая настройка

Клонирование и установка

bash


git clone https://github.com/connectplatform/ring.git
cd ring
npm install

Настройка среды

Скопируйте шаблон и отредактируйте необходимые переменные:

Как минимум, установите в .env.local:

Генерация AUTH_SECRET

Полная справка переменных — в Конфигурация среды. Для локальной разработки рекомендуется AUTH_TRUST_HOST=true.

Настройка базы данных

Запустите PostgreSQL и создайте базу данных:

Примените схему и миграции:

Или используйте скрипт установки, который выполняет настройку базы данных:

См. Установка > Настройка PostgreSQL для дополнительных вариантов.

Запуск сервера разработки

Пользовательский server.ts запускает Next.js 16 с WebSocket туннелем на порту 3000.

Проверка

Ожидаемый ответ: {"status":"ok","timestamp":"..."}

Откройте http://localhost:3000/login для тестирования входа через Google OAuth.

Ключевые файлы

Файл	Назначение
`auth.ts`	Конфигурация Auth.js v5 — провайдеры, колбэки, стратегия JWT сессии
`lib/database/DatabaseService.ts`	Унифицированная абстракция базы данных (PostgreSQL или Firestore)
`lib/firebase-admin.server.ts`	Firebase Admin SDK для FCM push (только серверная часть)
`public/firebase-messaging-sw.js`	Сервис-воркер с Firebase клиентским SDK для push-уведомлений
`lib/tunnel/`	Транспорт реального времени через WebSocket
`data/schema.sql`	Схема PostgreSQL v4

Нет lib/firebase.ts

Технологический стек

Компонент	Версия / Провайдер
Framework	Next.js 16 App Router
UI	React 19
Auth	Auth.js v5 (`auth()` / `useSession()`)
Database	PostgreSQL 16 + PostGIS (или Firestore через `DB_BACKEND_MODE=firebase-full`)
Push	Firebase Cloud Messaging (серверный Admin SDK, клиентский сервис-воркер)
Payments	WayForPay (серверная HMAC верификация)
Locales	`next-intl`, поддерживаемые языки: en, uk, ru

Устранение неполадок

"FETCH_FAILED" или ошибки подключения к базе данных

Убедитесь, что PostgreSQL запущен и учетные данные в .env.local совпадают:

Google OAuth не работает

Проверьте Google Cloud Console — добавьте http://localhost:3000 в Authorized JavaScript origins
Добавьте http://localhost:3000/api/auth/callback/google в Authorized redirect URIs
Убедитесь, что AUTH_GOOGLE_ID и AUTH_GOOGLE_SECRET указаны в .env.local

Ошибки секрета аутентификации

Убедитесь, что AUTH_SECRET установлен в .env.local. Сгенерируйте с помощью:

Затем скопируйте результат в AUTH_SECRET.

Дальнейшие шаги

Руководство по установке — полная настройка со скриптом установки и расширенной конфигурацией базы данных
Локальная настройка — white-label конфигурация, флаги функций и рабочий процесс разработки
Конфигурация среды — справка всех переменных среды
Расширенные возможности — AI-матчер, верификация, PaymentConductor и другое

Базовая настройка

Предварительные требования

Node.js 20+, PostgreSQL 16 и Git. Полный перечень требований описан в Руководстве по установке.

Что вы получаете

Работающий экземпляр Ring Platform с:

PostgreSQL как база данных приложения (режим k8s-postgres-fcm)
Auth.js v5 аутентификация с Google OAuth входом
Управление сущностями — создание и управление организациями
Маркетплейс возможностей — публикация и поиск объявлений
Уведомления в реальном времени через WebSocket туннель

Платформа работает на http://localhost:3000. Для базовой локальной работы не требуются облачные сервисы.

Дальнейшие шаги после настройки

Пошаговая настройка

Клонирование и установка

bash


git clone https://github.com/connectplatform/ring.git
cd ring
npm install

Настройка среды

Скопируйте шаблон и отредактируйте необходимые переменные:

Как минимум, установите в .env.local:

Генерация AUTH_SECRET

Полная справка переменных — в Конфигурация среды. Для локальной разработки рекомендуется AUTH_TRUST_HOST=true.

Настройка базы данных

Запустите PostgreSQL и создайте базу данных:

Примените схему и миграции:

Или используйте скрипт установки, который выполняет настройку базы данных:

См. Установка > Настройка PostgreSQL для дополнительных вариантов.

Запуск сервера разработки

Пользовательский server.ts запускает Next.js 16 с WebSocket туннелем на порту 3000.

Проверка

Ожидаемый ответ: {"status":"ok","timestamp":"..."}

Откройте http://localhost:3000/login для тестирования входа через Google OAuth.

Ключевые файлы

Файл	Назначение
`auth.ts`	Конфигурация Auth.js v5 — провайдеры, колбэки, стратегия JWT сессии
`lib/database/DatabaseService.ts`	Унифицированная абстракция базы данных (PostgreSQL или Firestore)
`lib/firebase-admin.server.ts`	Firebase Admin SDK для FCM push (только серверная часть)
`public/firebase-messaging-sw.js`	Сервис-воркер с Firebase клиентским SDK для push-уведомлений
`lib/tunnel/`	Транспорт реального времени через WebSocket
`data/schema.sql`	Схема PostgreSQL v4

Нет lib/firebase.ts

Технологический стек

Компонент	Версия / Провайдер
Framework	Next.js 16 App Router
UI	React 19
Auth	Auth.js v5 (`auth()` / `useSession()`)
Database	PostgreSQL 16 + PostGIS (или Firestore через `DB_BACKEND_MODE=firebase-full`)
Push	Firebase Cloud Messaging (серверный Admin SDK, клиентский сервис-воркер)
Payments	WayForPay (серверная HMAC верификация)
Locales	`next-intl`, поддерживаемые языки: en, uk, ru

Устранение неполадок

"FETCH_FAILED" или ошибки подключения к базе данных

Убедитесь, что PostgreSQL запущен и учетные данные в .env.local совпадают:

Google OAuth не работает

Проверьте Google Cloud Console — добавьте http://localhost:3000 в Authorized JavaScript origins
Добавьте http://localhost:3000/api/auth/callback/google в Authorized redirect URIs
Убедитесь, что AUTH_GOOGLE_ID и AUTH_GOOGLE_SECRET указаны в .env.local

Ошибки секрета аутентификации

Убедитесь, что AUTH_SECRET установлен в .env.local. Сгенерируйте с помощью:

Затем скопируйте результат в AUTH_SECRET.

Дальнейшие шаги

Руководство по установке — полная настройка со скриптом установки и расширенной конфигурацией базы данных
Локальная настройка — white-label конфигурация, флаги функций и рабочий процесс разработки
Конфигурация среды — справка всех переменных среды
Расширенные возможности — AI-матчер, верификация, PaymentConductor и другое

bash


# Database backend (required)
DB_BACKEND_MODE=k8s-postgres-fcm

# Auth.js secret (required)
AUTH_SECRET=your-secret

# Database connection (required for k8s-postgres-fcm)
DB_HOST=localhost
DB_PORT=5432
DB_NAME=ring_platform
DB_USER=ring_user
DB_PASSWORD=ring_password_2024

# Google OAuth (required for sign-in)
AUTH_GOOGLE_ID=your-client-id
AUTH_GOOGLE_SECRET=your-client-secret

bash


export DATABASE_URL="postgresql://ring_user:ring_password_2024@localhost:5432/ring_platform"
psql "$DATABASE_URL" -f data/schema.sql
psql "$DATABASE_URL" -f data/migrations/002_news_content_schema.sql
psql "$DATABASE_URL" -f data/migrations/003_news_kingdom_upgrade.sql
psql "$DATABASE_URL" -f data/migrations/004_payment_transactions.sql

bash


# Database backend (required)
DB_BACKEND_MODE=k8s-postgres-fcm

# Auth.js secret (required)
AUTH_SECRET=your-secret

# Database connection (required for k8s-postgres-fcm)
DB_HOST=localhost
DB_PORT=5432
DB_NAME=ring_platform
DB_USER=ring_user
DB_PASSWORD=ring_password_2024

# Google OAuth (required for sign-in)
AUTH_GOOGLE_ID=your-client-id
AUTH_GOOGLE_SECRET=your-client-secret

bash


export DATABASE_URL="postgresql://ring_user:ring_password_2024@localhost:5432/ring_platform"
psql "$DATABASE_URL" -f data/schema.sql
psql "$DATABASE_URL" -f data/migrations/002_news_content_schema.sql
psql "$DATABASE_URL" -f data/migrations/003_news_kingdom_upgrade.sql
psql "$DATABASE_URL" -f data/migrations/004_payment_transactions.sql

bash


# Database backend (required)
DB_BACKEND_MODE=k8s-postgres-fcm

# Auth.js secret (required)
AUTH_SECRET=your-secret

# Database connection (required for k8s-postgres-fcm)
DB_HOST=localhost
DB_PORT=5432
DB_NAME=ring_platform
DB_USER=ring_user
DB_PASSWORD=ring_password_2024

# Google OAuth (required for sign-in)
AUTH_GOOGLE_ID=your-client-id
AUTH_GOOGLE_SECRET=your-client-secret

bash


export DATABASE_URL="postgresql://ring_user:ring_password_2024@localhost:5432/ring_platform"
psql "$DATABASE_URL" -f data/schema.sql
psql "$DATABASE_URL" -f data/migrations/002_news_content_schema.sql
psql "$DATABASE_URL" -f data/migrations/003_news_kingdom_upgrade.sql
psql "$DATABASE_URL" -f data/migrations/004_payment_transactions.sql

Documentation

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

Documentation

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

Documentation

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

Loading documentation...

Documentation

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

Loading documentation...

Documentation

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

Loading documentation...

Documentation

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

Loading documentation...

Loading documentation...

Loading documentation...

Базовая настройка

Что вы получаете

Дальнейшие шаги после настройки

Базовая настройка

Что вы получаете

Дальнейшие шаги после настройки

Базовая настройка

Что вы получаете

Дальнейшие шаги после настройки