---
title: "Ласкаво просимо до Ring"
description: "Ring Platform — це безкоштовна, відкрита white-label платформа, що з’єднує людей з релевантними можливостями завдяки AI-підбору та сповіщенням у директ-повідомленнях. Самостійно розгорніть з GitHub або отримайте керований клон на ringdom.org."
locale: "uk"
---
# Ласкаво просимо до платформи Ring

> **Info**
> Використовуйте вкладки **Засновник** / **Розробник** у боковому меню документації, щоб фільтрувати цю сторінку для своєї аудиторії. Атрибут `audience` у frontmatter керує вмістом на сторінці; видимість у боковому меню визначається через `lib/docs/audience-curated-docs.ts`.

Ring Platform — це **безкоштовна, відкрита white-label платформа** для з’єднання людей із можливостями, що їм підходять — через AI-підбір та повідомлення у директ — замість прокручування списків вручну. Один код, ваш бренд, ваш домен, ваша галузь.

Ring — це мій внесок у мир та децентралізоване інформаційне багатство. 100% безкоштовно і з відкритим кодом, завжди доступний на [connectplatform/ring](https://github.com/connectplatform/ring). Це повнофункціональна, клонована цифрова платформа: підбір, месенджер, контакти, web3-гаманець, токени, магазин і багато іншого — щоб ви могли керувати справою просто з месенджеру. Якщо Ring стане повсюдним — AI-підбір забезпечить процвітання через достаток релевантних виборів.

## Шлюз: передати, підібрати, сповістити

Ring змінює звичний принцип роботи можливостей. Замість пасивної бази, де оголошення чекають на пошук, Ring **активно шукає збіги і сповіщає** тих, кому це підходить — саме тоді, коли з’являється релевантна нагода.

| Раніше | Еквівалент у Ring |
|--------|-------------------|
| Створення оголошення й чекання пошуківців | Додаєте можливість → Matcher оцінює кандидатів → сповіщає найкращих |
| Ви шукаєте в «мертвому» каталозі | Збіг сам приходить до вас як сповіщення |
| Лише «пропозиції» (односпрямовано) | Двосторонні можливості: «пропозиція» та «запит» |
| Непрозоре ранжування | Вісім прозорих факторів + гнучкий `scoreThreshold` |

### Як працює система оцінки

Matcher оцінює кожного кандидата за **8 факторами** (`MatchFactors` у `lib/ai/types.ts`, кожен 0–100): `skillMatch`, `experienceMatch`, `industryMatch`, `locationMatch`, `budgetMatch`, `availabilityMatch`, `careerMatch`, `cultureMatch`. Сповіщення пояснюють *чому* ви підходите — не більше **160 символів** (довші тексти від LLM обрізаються у `MatchingService`).

Початкові налаштування — у `ring-config.json → matcher`, їх можна змінювати для кожного клону окремо: `scoreThreshold` **0.7**, `maxMatches` **10**, `autoApprove` **false**. Діапазони якості (висока ≥80 / середня 60–79 / низька <60) — це аналітичні сигнали, а не формальна гарантія точності.

### For founders

## Чим важливий Ring для вашого клону

Ring — це **white-label кодова база**: ви розгортаєте власну брендовану платформу, зберігаючи всіх користувачів, всі дані і бренд — без повторної розробки маркетплейсу, підбору, обміну повідомленнями, платежів та авторизації з нуля.

- **Запускайте нішеву платформу, а не універсальний застосунок.** Вмикайте лише потрібні вашій спільноті модулі.
- **Розвивайтесь завдяки підбору, а не пошуку.** Члени спільноти отримують сповіщення, щойно з’являється релевантна можливість.
- **Володійте відносинами.** Ваш домен, ваш регіон, ваш платіжний провайдер, ваші правила.
- **Без оплати за користувачів.** Повний доступ до коду, розміщення скрізь.

### Почніть тут

  
- **[Запустіть свій клон](/docs/customization/quick-start.md)** — OSS-інсталяція або керований хостинг Ringdom

  
- **[Дивіться живі клони](/docs/customization/success-stories.md)** — Реальні розгортання Ring у різних галузях

  
- **[Зрозумійте підбір](/docs/features/opportunities.md)** — Алгоритм підбору з 8-ма факторами

  
- **[Монетизація](/docs/features/store.md)** — Магазин, платежі, підписки

### Реальні клони (приклади розгортання)

Це робочі клони у "Імперії" Ringdom — ви можете переглянути їх та оцінити платформу для свого проекту. Повний перелік з деталями — у [Еталонних клонів Ring](/docs/customization/success-stories.md).

| Клон | Галузь |
|------|--------|
| **ring-greenfood-live** | Сільськогосподарський мультивендорний ринок |
| **ring-vikka-ua** | Регіональні новини (Черкаси, Україна) |
| **ring-zemna-ai** | Наукові публікації + чат із агентом |
| **ring-petfriend-app** | Карта маркета місць для домашніх тварин |
| **ring-ring-ck-ua** | IT-можливості Черкащини |
| **ring-wellness-gov-ua** | Охорона здоров'я / громадські сервіси (UA) |
| **ring-subiworx-com** | Автосервіси Subaru (Темпе, США) |
| **ring-ringdom-org** | Головна імперії + маркетплейс робочих можливостей |

### For developers

## Що саме ви інтегруєте

Ring — застосунок на **Next.js 16 + React 19** (App Router) із **Auth.js v5**, **Tailwind 4** та сервером на **PostgreSQL**. Головне публічне репо: [connectplatform/ring](https://github.com/connectplatform/ring).

| Шар | Артефакт | Примітки |
|-----|----------|----------|
| Ідентичність клону | `ring-config.json` | Брендинг, фічі, домени (`ring-config.template.json`) |
| Секрети + бекенд | `.env.local` | `DB_BACKEND_MODE`, `AUTH_*`, Firebase FCM, цільовий деплой |
| Дані платформи | PostgreSQL `ring_platform` | `data/schema.sql` + міграції |
| Авторизація | Auth.js v5 (`auth.ts`) | `AUTH_SECRET`, OAuth провайдер |
| Dev-режим | `server.ts` | `npm run dev` — WSS, якщо `RING_DEPLOY_TARGET=self-hosted` |

### Запустити локальний клон

**Клонування та інсталяція**

{`git clone https://github.com/connectplatform/ring.git
cd ring
./install.sh`}

`install.sh` копіює `env.local.template` → `.env.local`, створює `ring-config.json` (якщо відсутній), генерує `AUTH_SECRET` та запускає `npm install`.

**Застосуйте схему та запускайте**

{`npm run dev`}

Схема (`data/schema.sql`) накочується на локальний PostgreSQL 16, далі — smoke-тест. Типовий бекенд: `DB_BACKEND_MODE=k8s-postgres-fcm` (дані у PostgreSQL, FCM через Firebase Admin — якщо налаштовано).

Повний покроковий старт — у [Посібнику з початку роботи](/docs/getting-started.md): залежності, міграції, перша перевірка.

### Сервіси й модулі

Архітектура платформи — це не моноліт, а окремі сервіс-модулі за чіткими контрактами:

- **Можливості + Matcher** — `lib/ai/matcher.ts`, `OpportunityMatchingService` ([Детальніше](/docs/features/opportunities.md))
- **DatabaseService** — `lib/database/DatabaseService.ts`, контракт `{ success, data, error }` ([Архітектура](/docs/architecture.md))
- **Платежі** — PaymentConductor, вебхуки `/api/payments/*/webhook` ([PaymentConductor](/docs/features/payment-conductor.md))
- **Сповіщення** — `notification-service`, фільтри блоків ([Сповіщення](/docs/features/notifications.md))

Весь спектр — досліджуйте через наступний експлорер функцій.

## Екосистема функцій

## Як отримати власний Ring

Два справжні шляхи — одна кодова база:

| Шлях | Оптимально коли | Що ви отримуєте |
|------|----------------|-----------------|
| **OSS self-host** | Маєте власну інфраструктуру (ноутбук, VPS, k3s) | Повний код + `install.sh` ([Швидкий старт](/docs/customization/quick-start.md)) |
| **Ringdom managed** | Бажаєте щоб k8s, DNS та ops покривала команда | Керований клон, замовлення через [ringdom.org](https://ringdom.org) |

## Дотичні матеріали

  
- [getting-started/index](/docs/getting-started/index.md) — Наступний крок: локальне розгортання, міграції, перевірка.

  
- [customization/quick-start](/docs/customization/quick-start.md) — Той самий воркфлоу: оберіть між OSS або Ringdom-managed — і запустіть власний Ring.

  
- [features/opportunities](/docs/features/opportunities.md) — Глибше: Matcher з 8 факторами, дводоменні можливості та цикл 🔁 підбір-сповіщення.

  
- [customization/success-stories](/docs/customization/success-stories.md) — Дивіться також: галерея реальних клонів Ring із публічними посиланнями.