Loading documentation...
Preparing Ring content
Концепції, цінність і типові сценарії
Концепції, цінність і типові сценарії
Preparing Ring content
Preparing Ring content
Preparing Ring content
Запустіть 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 | — 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 | — 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 | — 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.
npm run devRING_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
npm run devRING_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
npm run devRING_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