Настройка локальной разработки

Руководство по настройке Ring Platform для локальной разработки.

Что вам понадобится

Node.js 22, pnpm/npm и Git, установленные на вашем компьютере
PostgreSQL 16 + PostGIS (через Homebrew, Docker или нативную установку)
Редактор кода (рекомендуется VS Code)

Обзор настройки

Клонируйте репозиторий
Установите зависимости
Настройте переменные окружения из env.local.template
Настройте PostgreSQL и выполните миграции
Запустите сервер разработки

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

Необходимое программное обеспечение

Node.js 22 — Скачать с nodejs.org
npm 10+ или pnpm 9+ — Менеджер пакетов
Git — Контроль версий
PostgreSQL 16 с расширением PostGIS — Смотрите раздел настройки базы данных
VS Code — Рекомендуемое IDE

Дополнительные инструменты

Docker — Для контейнеризированного PostgreSQL (альтернатива установке через Homebrew)
Postman или Bruno — Тестирование API

Установка

1. Клонирование репозитория

2. Установка зависимостей

3. Конфигурация окружения

Скопируйте шаблон окружения:

Переменная DB_BACKEND_MODE является обязательной — платформа не запустится без неё. Для локальной разработки с PostgreSQL установите k8s-postgres-fcm.

Настройте ваш файл .env.local со следующими обязательными переменными:

Сгенерируйте AUTH_SECRET с помощью: npx @better-auth/cli secret

Полный список поддерживаемых переменных и их описания смотрите в Конфигурация окружения.

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

Вариант A: Docker (рекомендуется для локальной разработки)

Вариант B: Homebrew (macOS)

Для локальной разработки с несколькими клонами используйте скрипт инициализации infrastructure/postgres/bootstrap-brew-dev.sh. Смотрите infrastructure/postgres/MIGRATION-KINGDOM-MATRIX.md.

Выполнение миграций

Файлы миграций находятся в директории data/. Исполнитель миграций читает DB_BACKEND_MODE для выбора правильного адаптера. Для локального PostgreSQL (k8s-postgres-fcm) он применяет SQL-миграции из data/schema.sql и data/migrations/.

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

Приложение будет доступно по адресам:

Фронтенд: http://localhost:3000
API маршруты: http://localhost:3000/api/*
Проверка состояния: http://localhost:3000/api/health

Инструменты разработки

Горячая перезагрузка

Сервер разработки Next.js поддерживает горячую перезагрузку для:

React компонентов и Server Components
API маршрутов
Изменений Tailwind CSS
Файлов локализации (требуется перезапуск сервера для новых ключей)

Проверка типов

Линтинг

Структура проекта

Тестирование

Распространённые проблемы

Порт 3000 уже используется

Отказано в соединении с базой данных

Убедитесь, что PostgreSQL запущен: pg_isready
Проверьте значения .env.local для DB_HOST, DB_PORT, DB_USER, DB_PASSWORD
Убедитесь, что база данных ring_platform существует
Подтвердите, что DB_BACKEND_MODE установлен на k8s-postgres-fcm

Ошибки OAuth Auth.js

Убедитесь, что AUTH_GOOGLE_ID и AUTH_GOOGLE_SECRET указаны в .env.local
Проверьте, что http://localhost:3000 есть в разрешённых URI перенаправления консоли Google OAuth
Убедитесь, что AUTH_SECRET установлен и одинаков
Формат URL обратного вызова: http://localhost:3000/api/auth/callback/google

Firebase FCM не работает (необязательно)

Firebase используется только для push-уведомлений (FCM) в режиме k8s-postgres-fcm. Приложение будет работать без настроенного Firebase, но push-уведомления не будут доставляться. Настройте переменные AUTH_FIREBASE_* и NEXT_PUBLIC_FIREBASE_* при необходимости.

Следующие шаги

Конфигурация окружения — Полный справочник переменных окружения
Развёртывание — Развёртывание в production
Руководство по установке — Production установка
Структура кода — Организация кодовой базы
Рабочий процесс разработки — Git workflow и лучшие практики
Тестирование — Написание и запуск тестов

Нужна помощь? Проверьте руководство по устранению неполадок или присоединяйтесь к нашему Discord сообществу.

Настройка локальной разработки

Руководство по настройке Ring Platform для локальной разработки.

Что вам понадобится

Node.js 22, pnpm/npm и Git, установленные на вашем компьютере
PostgreSQL 16 + PostGIS (через Homebrew, Docker или нативную установку)
Редактор кода (рекомендуется VS Code)

Обзор настройки

Клонируйте репозиторий
Установите зависимости
Настройте переменные окружения из env.local.template
Настройте PostgreSQL и выполните миграции
Запустите сервер разработки

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

Необходимое программное обеспечение

Node.js 22 — Скачать с nodejs.org
npm 10+ или pnpm 9+ — Менеджер пакетов
Git — Контроль версий
PostgreSQL 16 с расширением PostGIS — Смотрите раздел настройки базы данных
VS Code — Рекомендуемое IDE

Дополнительные инструменты

Docker — Для контейнеризированного PostgreSQL (альтернатива установке через Homebrew)
Postman или Bruno — Тестирование API

Установка

1. Клонирование репозитория

2. Установка зависимостей

3. Конфигурация окружения

Скопируйте шаблон окружения:

Настройте ваш файл .env.local со следующими обязательными переменными:

Сгенерируйте AUTH_SECRET с помощью: npx @better-auth/cli secret

Полный список поддерживаемых переменных и их описания смотрите в Конфигурация окружения.

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

Вариант A: Docker (рекомендуется для локальной разработки)

Вариант B: Homebrew (macOS)

Выполнение миграций

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

Приложение будет доступно по адресам:

Фронтенд: http://localhost:3000
API маршруты: http://localhost:3000/api/*
Проверка состояния: http://localhost:3000/api/health

Инструменты разработки

Горячая перезагрузка

Сервер разработки Next.js поддерживает горячую перезагрузку для:

React компонентов и Server Components
API маршрутов
Изменений Tailwind CSS
Файлов локализации (требуется перезапуск сервера для новых ключей)

Проверка типов

Линтинг

Структура проекта

Тестирование

Распространённые проблемы

Порт 3000 уже используется

Отказано в соединении с базой данных

Убедитесь, что PostgreSQL запущен: pg_isready
Проверьте значения .env.local для DB_HOST, DB_PORT, DB_USER, DB_PASSWORD
Убедитесь, что база данных ring_platform существует
Подтвердите, что DB_BACKEND_MODE установлен на k8s-postgres-fcm

Ошибки OAuth Auth.js

Убедитесь, что AUTH_GOOGLE_ID и AUTH_GOOGLE_SECRET указаны в .env.local
Проверьте, что http://localhost:3000 есть в разрешённых URI перенаправления консоли Google OAuth
Убедитесь, что AUTH_SECRET установлен и одинаков
Формат URL обратного вызова: http://localhost:3000/api/auth/callback/google

Firebase FCM не работает (необязательно)

Следующие шаги

Конфигурация окружения — Полный справочник переменных окружения
Развёртывание — Развёртывание в production
Руководство по установке — Production установка
Структура кода — Организация кодовой базы
Рабочий процесс разработки — Git workflow и лучшие практики
Тестирование — Написание и запуск тестов

Нужна помощь? Проверьте руководство по устранению неполадок или присоединяйтесь к нашему Discord сообществу.

Настройка локальной разработки

Руководство по настройке Ring Platform для локальной разработки.

Что вам понадобится

Node.js 22, pnpm/npm и Git, установленные на вашем компьютере
PostgreSQL 16 + PostGIS (через Homebrew, Docker или нативную установку)
Редактор кода (рекомендуется VS Code)

Обзор настройки

Клонируйте репозиторий
Установите зависимости
Настройте переменные окружения из env.local.template
Настройте PostgreSQL и выполните миграции
Запустите сервер разработки

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

Необходимое программное обеспечение

Node.js 22 — Скачать с nodejs.org
npm 10+ или pnpm 9+ — Менеджер пакетов
Git — Контроль версий
PostgreSQL 16 с расширением PostGIS — Смотрите раздел настройки базы данных
VS Code — Рекомендуемое IDE

Дополнительные инструменты

Docker — Для контейнеризированного PostgreSQL (альтернатива установке через Homebrew)
Postman или Bruno — Тестирование API

Установка

1. Клонирование репозитория

2. Установка зависимостей

3. Конфигурация окружения

Скопируйте шаблон окружения:

Настройте ваш файл .env.local со следующими обязательными переменными:

Сгенерируйте AUTH_SECRET с помощью: npx @better-auth/cli secret

Полный список поддерживаемых переменных и их описания смотрите в Конфигурация окружения.

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

Вариант A: Docker (рекомендуется для локальной разработки)

Вариант B: Homebrew (macOS)

Выполнение миграций

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

Приложение будет доступно по адресам:

Фронтенд: http://localhost:3000
API маршруты: http://localhost:3000/api/*
Проверка состояния: http://localhost:3000/api/health

Инструменты разработки

Горячая перезагрузка

Сервер разработки Next.js поддерживает горячую перезагрузку для:

React компонентов и Server Components
API маршрутов
Изменений Tailwind CSS
Файлов локализации (требуется перезапуск сервера для новых ключей)

Проверка типов

Линтинг

Структура проекта

Тестирование

Распространённые проблемы

Порт 3000 уже используется

Отказано в соединении с базой данных

Убедитесь, что PostgreSQL запущен: pg_isready
Проверьте значения .env.local для DB_HOST, DB_PORT, DB_USER, DB_PASSWORD
Убедитесь, что база данных ring_platform существует
Подтвердите, что DB_BACKEND_MODE установлен на k8s-postgres-fcm

Ошибки OAuth Auth.js

Убедитесь, что AUTH_GOOGLE_ID и AUTH_GOOGLE_SECRET указаны в .env.local
Проверьте, что http://localhost:3000 есть в разрешённых URI перенаправления консоли Google OAuth
Убедитесь, что AUTH_SECRET установлен и одинаков
Формат URL обратного вызова: http://localhost:3000/api/auth/callback/google

Firebase FCM не работает (необязательно)

Следующие шаги

Конфигурация окружения — Полный справочник переменных окружения
Развёртывание — Развёртывание в production
Руководство по установке — Production установка
Структура кода — Организация кодовой базы
Рабочий процесс разработки — Git workflow и лучшие практики
Тестирование — Написание и запуск тестов

Нужна помощь? Проверьте руководство по устранению неполадок или присоединяйтесь к нашему Discord сообществу.

text


ring-platform.org/
├── app/                  # Next.js 16 App Router
│   ├── (auth)/           # Страницы аутентификации (вход, регистрация)
│   ├── api/              # API маршруты
│   └── (public)/         # Публичные страницы
├── features/             # Модули функций
│   ├── news/             # Управление новостями
│   ├── entities/         # Управление сущностями
│   ├── opportunities/    # Система возможностей
│   └── wallet/           # Web3 кошелёк
├── lib/                  # Основные библиотеки
│   ├── database/         # Абстракция базы данных
│   │   ├── DatabaseService.ts
│   │   └── adapters/     # PostgreSQLAdapter, FirebaseAdapter
│   ├── firebase-admin.server.ts  # Firebase Admin (FCM только)
│   └── auth-adapter-singleton.ts # Выбор адаптера Auth.js
├── @actions/             # Серверные действия
├── data/                 # SQL миграции
├── infrastructure/       # Скрипты инициализации Postgres
├── public/               # Статические ресурсы, firebase-messaging-sw.js
├── locales/              # Файлы переводов i18n
├── env.local.template    # Единственный источник истины для переменных окружения
└── ring-config.json      # Конфигурация клона

text


ring-platform.org/
├── app/                  # Next.js 16 App Router
│   ├── (auth)/           # Страницы аутентификации (вход, регистрация)
│   ├── api/              # API маршруты
│   └── (public)/         # Публичные страницы
├── features/             # Модули функций
│   ├── news/             # Управление новостями
│   ├── entities/         # Управление сущностями
│   ├── opportunities/    # Система возможностей
│   └── wallet/           # Web3 кошелёк
├── lib/                  # Основные библиотеки
│   ├── database/         # Абстракция базы данных
│   │   ├── DatabaseService.ts
│   │   └── adapters/     # PostgreSQLAdapter, FirebaseAdapter
│   ├── firebase-admin.server.ts  # Firebase Admin (FCM только)
│   └── auth-adapter-singleton.ts # Выбор адаптера Auth.js
├── @actions/             # Серверные действия
├── data/                 # SQL миграции
├── infrastructure/       # Скрипты инициализации Postgres
├── public/               # Статические ресурсы, firebase-messaging-sw.js
├── locales/              # Файлы переводов i18n
├── env.local.template    # Единственный источник истины для переменных окружения
└── ring-config.json      # Конфигурация клона

text


ring-platform.org/
├── app/                  # Next.js 16 App Router
│   ├── (auth)/           # Страницы аутентификации (вход, регистрация)
│   ├── api/              # API маршруты
│   └── (public)/         # Публичные страницы
├── features/             # Модули функций
│   ├── news/             # Управление новостями
│   ├── entities/         # Управление сущностями
│   ├── opportunities/    # Система возможностей
│   └── wallet/           # Web3 кошелёк
├── lib/                  # Основные библиотеки
│   ├── database/         # Абстракция базы данных
│   │   ├── DatabaseService.ts
│   │   └── adapters/     # PostgreSQLAdapter, FirebaseAdapter
│   ├── firebase-admin.server.ts  # Firebase Admin (FCM только)
│   └── auth-adapter-singleton.ts # Выбор адаптера Auth.js
├── @actions/             # Серверные действия
├── data/                 # SQL миграции
├── infrastructure/       # Скрипты инициализации Postgres
├── public/               # Статические ресурсы, firebase-messaging-sw.js
├── locales/              # Файлы переводов i18n
├── env.local.template    # Единственный источник истины для переменных окружения
└── ring-config.json      # Конфигурация клона

Documentation

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

Documentation

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

Documentation

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

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

Documentation

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

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

Documentation

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

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

Documentation

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

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

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

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

Настройка локальной разработки

Что вам понадобится

Обзор настройки

Настройка локальной разработки

Что вам понадобится

Обзор настройки

Настройка локальной разработки

Что вам понадобится

Обзор настройки