Завантаження документації...
Підготовка контенту платформи Ring
Концепции, ценность и типичные сценарии клонирования — меньше кода.
Концепции, ценность и типичные сценарии клонирования — меньше кода.
Підготовка контенту платформи Ring
Підготовка контенту платформи Ring
Підготовка контенту платформи Ring
Разверните white-label клон Ring Platform на своей машине. Этот хаб отражает реальный dev-flow из open-source дерева (connectplatform/ring) и ring-platform.org — community-портала для self-hosted энтузиастов.
| Путь | Время | Результат |
|---|---|---|
./install.sh --quick + существующий PostgreSQL | ~20–40 мин | Клон, зависимости, env — схему и OAuth ещё нужно добавить |
| Полный Postgres-primary bootstrap | 45–90 мин | Локальный стек как в production (k8s-postgres-fcm) |
Прототип (firebase-full) | ~15–30 мин | Только Firestore — без глубины ERP, News Kingdom, PaymentConductor |
Сначала видение? Добро пожаловать в Ring, затем вернитесь сюда.
Self-host с GitHub? Эта секция для вас. Turn-key хостинг Ringdom? Начните на ringdom.org — после handoff см. Руководство по кастомизации. Публичное OSS-дерево содержит install.sh; enterprise k8s/CLI остаётся за публичной границей (FEATURESET.md).
| Слой | Артефакт | Назначение |
|---|---|---|
| Идентичность клона | ring-config.json | Брендинг, feature flags, домены (ring-config.template.json) |
| Секреты и backend | .env.local | DB_BACKEND_MODE, AUTH_*, Firebase FCM, tunnel deploy target |
| Данные приложения | PostgreSQL ring_platform | data/schema.sql v4.0.1+ + kingdom migrations |
| Auth | Auth.js v5 (auth.ts) | AUTH_SECRET + минимум один OAuth-провайдер |
| Dev runtime | server.ts | npm run dev — Next.js 16 + React 19 + native WSS при |
Интерактивные пути с копируемыми командами — self-deploy с GitHub, LegioX-кастомизация или партнёрство Promptor.
Production и локальный dev используют DB_BACKEND_MODE=k8s-postgres-fcm — PostgreSQL для данных, Firebase Admin только для FCM push, если настроено.
Без инсталлятора — тот же результат, больше контроля:
Подробно: Установка.
Node.js 20+, железо, ОС, учётные записи Firebase/Google Cloud
Полные пути install, env, tunnel, типичные проблемы
schema.sql v4.0.1+, kingdom 002–011, матрица клонов
Smoke-test auth, entities, opportunities, API health
White-label checklist после первого boot
k8s-postgres-fcm vs supabase-fcm vs firebase-full
Структура проекта, тесты, Homebrew Postgres
BackendSelector, адаптеры, FCM vs Firestore
| Задача | Команда |
|---|---|
| One-command install | git clone … && ./install.sh --quick |
| Env wizard | npm run setup:env |
| Dev env script | ./scripts/setup-dev.sh |
| Apply migration | ./scripts/run-migration.sh data/schema.sql |
| Dev server | npm run dev |
| Type check | npm run type-check |
| Portal health | npm run portal:health |
| Repo install guide | INSTALL.md |
install.sh — первый bootstrap клона (config + npm install). setup-dev.sh — после клона, hardening env. npm run setup:env — интерактивный проход по существующему .env.local.
Разверните white-label клон Ring Platform на своей машине. Этот хаб отражает реальный dev-flow из open-source дерева (connectplatform/ring) и ring-platform.org — community-портала для self-hosted энтузиастов.
| Путь | Время | Результат |
|---|---|---|
./install.sh --quick + существующий PostgreSQL | ~20–40 мин | Клон, зависимости, env — схему и OAuth ещё нужно добавить |
| Полный Postgres-primary bootstrap | 45–90 мин | Локальный стек как в production (k8s-postgres-fcm) |
Прототип (firebase-full) | ~15–30 мин | Только Firestore — без глубины ERP, News Kingdom, PaymentConductor |
Сначала видение? Добро пожаловать в Ring, затем вернитесь сюда.
Self-host с GitHub? Эта секция для вас. Turn-key хостинг Ringdom? Начните на ringdom.org — после handoff см. Руководство по кастомизации. Публичное OSS-дерево содержит install.sh; enterprise k8s/CLI остаётся за публичной границей (FEATURESET.md).
| Слой | Артефакт | Назначение |
|---|---|---|
| Идентичность клона | ring-config.json | Брендинг, feature flags, домены (ring-config.template.json) |
| Секреты и backend | .env.local | DB_BACKEND_MODE, AUTH_*, Firebase FCM, tunnel deploy target |
| Данные приложения | PostgreSQL ring_platform | data/schema.sql v4.0.1+ + kingdom migrations |
| Auth | Auth.js v5 (auth.ts) | AUTH_SECRET + минимум один OAuth-провайдер |
| Dev runtime | server.ts | npm run dev — Next.js 16 + React 19 + native WSS при |
Интерактивные пути с копируемыми командами — self-deploy с GitHub, LegioX-кастомизация или партнёрство Promptor.
Production и локальный dev используют DB_BACKEND_MODE=k8s-postgres-fcm — PostgreSQL для данных, Firebase Admin только для FCM push, если настроено.
Без инсталлятора — тот же результат, больше контроля:
Подробно: Установка.
Node.js 20+, железо, ОС, учётные записи Firebase/Google Cloud
Полные пути install, env, tunnel, типичные проблемы
schema.sql v4.0.1+, kingdom 002–011, матрица клонов
Smoke-test auth, entities, opportunities, API health
White-label checklist после первого boot
k8s-postgres-fcm vs supabase-fcm vs firebase-full
Структура проекта, тесты, Homebrew Postgres
BackendSelector, адаптеры, FCM vs Firestore
| Задача | Команда |
|---|---|
| One-command install | git clone … && ./install.sh --quick |
| Env wizard | npm run setup:env |
| Dev env script | ./scripts/setup-dev.sh |
| Apply migration | ./scripts/run-migration.sh data/schema.sql |
| Dev server | npm run dev |
| Type check | npm run type-check |
| Portal health | npm run portal:health |
| Repo install guide | INSTALL.md |
install.sh — первый bootstrap клона (config + npm install). setup-dev.sh — после клона, hardening env. npm run setup:env — интерактивный проход по существующему .env.local.
Разверните white-label клон Ring Platform на своей машине. Этот хаб отражает реальный dev-flow из open-source дерева (connectplatform/ring) и ring-platform.org — community-портала для self-hosted энтузиастов.
| Путь | Время | Результат |
|---|---|---|
./install.sh --quick + существующий PostgreSQL | ~20–40 мин | Клон, зависимости, env — схему и OAuth ещё нужно добавить |
| Полный Postgres-primary bootstrap | 45–90 мин | Локальный стек как в production (k8s-postgres-fcm) |
Прототип (firebase-full) | ~15–30 мин | Только Firestore — без глубины ERP, News Kingdom, PaymentConductor |
Сначала видение? Добро пожаловать в Ring, затем вернитесь сюда.
Self-host с GitHub? Эта секция для вас. Turn-key хостинг Ringdom? Начните на ringdom.org — после handoff см. Руководство по кастомизации. Публичное OSS-дерево содержит install.sh; enterprise k8s/CLI остаётся за публичной границей (FEATURESET.md).
| Слой | Артефакт | Назначение |
|---|---|---|
| Идентичность клона | ring-config.json | Брендинг, feature flags, домены (ring-config.template.json) |
| Секреты и backend | .env.local | DB_BACKEND_MODE, AUTH_*, Firebase FCM, tunnel deploy target |
| Данные приложения | PostgreSQL ring_platform | data/schema.sql v4.0.1+ + kingdom migrations |
| Auth | Auth.js v5 (auth.ts) | AUTH_SECRET + минимум один OAuth-провайдер |
| Dev runtime | server.ts | npm run dev — Next.js 16 + React 19 + native WSS при |
Интерактивные пути с копируемыми командами — self-deploy с GitHub, LegioX-кастомизация или партнёрство Promptor.
Production и локальный dev используют DB_BACKEND_MODE=k8s-postgres-fcm — PostgreSQL для данных, Firebase Admin только для FCM push, если настроено.
Без инсталлятора — тот же результат, больше контроля:
Подробно: Установка.
Node.js 20+, железо, ОС, учётные записи Firebase/Google Cloud
Полные пути install, env, tunnel, типичные проблемы
schema.sql v4.0.1+, kingdom 002–011, матрица клонов
Smoke-test auth, entities, opportunities, API health
White-label checklist после первого boot
k8s-postgres-fcm vs supabase-fcm vs firebase-full
Структура проекта, тесты, Homebrew Postgres
BackendSelector, адаптеры, FCM vs Firestore
| Задача | Команда |
|---|---|
| One-command install | git clone … && ./install.sh --quick |
| Env wizard | npm run setup:env |
| Dev env script | ./scripts/setup-dev.sh |
| Apply migration | ./scripts/run-migration.sh data/schema.sql |
| Dev server | npm run dev |
| Type check | npm run type-check |
| Portal health | npm run portal:health |
| Repo install guide | INSTALL.md |
install.sh — первый bootstrap клона (config + npm install). setup-dev.sh — после клона, hardening env. npm run setup:env — интерактивный проход по существующему .env.local.
RING_DEPLOY_TARGET=self-hostedinstall.shinstall.sh v2.0 (см. INSTALL.md):
ring-config.json из шаблона (--clone-name для white-label slug)env.local.template → .env.local с AUTH_SECRET и WALLET_ENCRYPTION_KEYnpm installnext.config.mjs, docker-compose.yml, DockerfileФлаги: --quick, --clone-name my-ring, --verbose, --help.
Запустите Postgres 16+ и БД ring_platform (пользователь ring_user). Варианты:
docker compose -f docker-compose.dev.yml up -d postgres или ./infrastructure/postgres/bootstrap-brew-dev.shDB_HOST / DB_* в .env.localПолный порядок и матрица клонов: Миграции БД. Хелпер: ./scripts/run-migration.sh для контейнера ring-postgres-dev.
Минимум в .env.local:
Добавьте Google OAuth redirect: http://localhost:3000/api/auth/callback/google.
Интерактивный мастер: npm run setup:env или ./scripts/setup-dev.sh.
Ожидайте: Ready on http://localhost:3000 [self-hosted] и native WSS на /api/tunnel/ws.
Далее Первый успех — homepage, /login, entities/opportunities без ошибок адаптера БД. Опционально: npm run type-check, npm run portal:health.
Откройте http://localhost:3000. Брендинг в ring-config.json, далее Следующие шаги.
FETCH_FAILED, wallet bootstrap, OAuth redirects
RING_DEPLOY_TARGET=self-hostedinstall.shinstall.sh v2.0 (см. INSTALL.md):
ring-config.json из шаблона (--clone-name для white-label slug)env.local.template → .env.local с AUTH_SECRET и WALLET_ENCRYPTION_KEYnpm installnext.config.mjs, docker-compose.yml, DockerfileФлаги: --quick, --clone-name my-ring, --verbose, --help.
Запустите Postgres 16+ и БД ring_platform (пользователь ring_user). Варианты:
docker compose -f docker-compose.dev.yml up -d postgres или ./infrastructure/postgres/bootstrap-brew-dev.shDB_HOST / DB_* в .env.localПолный порядок и матрица клонов: Миграции БД. Хелпер: ./scripts/run-migration.sh для контейнера ring-postgres-dev.
Минимум в .env.local:
Добавьте Google OAuth redirect: http://localhost:3000/api/auth/callback/google.
Интерактивный мастер: npm run setup:env или ./scripts/setup-dev.sh.
Ожидайте: Ready on http://localhost:3000 [self-hosted] и native WSS на /api/tunnel/ws.
Далее Первый успех — homepage, /login, entities/opportunities без ошибок адаптера БД. Опционально: npm run type-check, npm run portal:health.
Откройте http://localhost:3000. Брендинг в ring-config.json, далее Следующие шаги.
FETCH_FAILED, wallet bootstrap, OAuth redirects
RING_DEPLOY_TARGET=self-hostedinstall.shinstall.sh v2.0 (см. INSTALL.md):
ring-config.json из шаблона (--clone-name для white-label slug)env.local.template → .env.local с AUTH_SECRET и WALLET_ENCRYPTION_KEYnpm installnext.config.mjs, docker-compose.yml, DockerfileФлаги: --quick, --clone-name my-ring, --verbose, --help.
Запустите Postgres 16+ и БД ring_platform (пользователь ring_user). Варианты:
docker compose -f docker-compose.dev.yml up -d postgres или ./infrastructure/postgres/bootstrap-brew-dev.shDB_HOST / DB_* в .env.localПолный порядок и матрица клонов: Миграции БД. Хелпер: ./scripts/run-migration.sh для контейнера ring-postgres-dev.
Минимум в .env.local:
Добавьте Google OAuth redirect: http://localhost:3000/api/auth/callback/google.
Интерактивный мастер: npm run setup:env или ./scripts/setup-dev.sh.
Ожидайте: Ready on http://localhost:3000 [self-hosted] и native WSS на /api/tunnel/ws.
Далее Первый успех — homepage, /login, entities/opportunities без ошибок адаптера БД. Опционально: npm run type-check, npm run portal:health.
Откройте http://localhost:3000. Брендинг в ring-config.json, далее Следующие шаги.
FETCH_FAILED, wallet bootstrap, OAuth redirects