---
title: "Добро пожаловать в Ring"
description: "Ring Platform — это бесплатная, открытая, брендируемая платформа, которая с помощью ИИ-подбора и уведомлений в директ-сообщениях объединяет людей с подходящими возможностями. Самостоятельный хостинг с GitHub или управляемый клон на ringdom.org."
locale: "ru"
---
# Добро пожаловать на платформу Ring

> **Info**
> Используйте вкладки **Учредитель** / **Разработчик** в боковом меню документации, чтобы фильтровать эту страницу. Поле `audience` во frontmatter управляет контентом на странице; видимость в боковом меню настраивается в `lib/docs/audience-curated-docs.ts`.

Ring Platform — это **бесплатная, открытая, брендируемая платформа**, которая помогает людям находить подходящие возможности через ИИ-подбор и уведомления в директ-сообщениях, а не бесконечный просмотр каталога объявлений. Одна кодовая база, ваш бренд, ваш домен, ваша ниша.

  Ring — мой вклад в мир и децентрализованное изобилие. Она полностью бесплатна и с открытым исходным кодом на [connectplatform/ring](https://github.com/connectplatform/ring). Это полнофункциональная цифровая платформа, которую можно клонировать: подборщик, мессенджер, контакты, web3-кошелёк, токен-контракты, магазин и другое — чтобы вы могли управлять своим бизнесом прямо из любимого мессенджера. Если Ring распространится повсеместно, ИИ-подборщик обеспечит благополучие всех благодаря множеству реально подходящих вариантов.

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

Ring переворачивает традиционный подход к возможностям с ног на голову: вместо пассивной базы, где публикации ждут поиска, Ring **активно находит совпадения и уведомляет** подходящих людей — когда появляется подходящее совпадение.

| Было | В Ring |
|----------|-----------------|
| Разместить объявление и надеяться, что кто-то найдёт | Опубликовать возможность → Подборщик оценивает кандидатов → уведомления лучшим |
| Искать в “мертвом” каталоге | Совпадение приходит к вам в уведомлении |
| Только офферы (односторонне) | Двунаправленные возможности: `offer` и `request` |
| Неявная ранжировка | Восемь оцениваемых факторов + настраиваемый `scoreThreshold` |

### Как оценивается совпадение

Подборщик оценивает каждого кандидата по **8 факторам** (`MatchFactors` в `lib/ai/types.ts`, каждый от 0 до 100): `skillMatch`, `experienceMatch`, `industryMatch`, `locationMatch`, `budgetMatch`, `availabilityMatch`, `careerMatch`, `cultureMatch`. В уведомлениях объясняется, *почему* что-то подошло — в **≤160 символах** (`MatchingService` усечёт длинный текст LLM).

Значения по умолчанию берутся из `ring-config.json → matcher` и настраиваются под клон, а не на уровне всей экосистемы: `scoreThreshold` **0.7**, `maxMatches` **10**, `autoApprove` **false**. Диапазоны качества (высокое ≥80 / среднее 60–79 / низкое <60) служат сигналами для аналитики, а не гарантией точности.

### For founders

## Почему это важно для вашего клона

Ring — это **кодовая база white-label**: вы запускаете собственную платформу под вашим брендом и управляете пользователями, данными и правилами — не создавая заново маркетплейс, подбор, сообщения, платежи и авторизацию.

- **Запускайте вертикальную платформу, а не обычное приложение.** Включайте только те модули, которые нужны вашему сообществу.
- **Растите через подбор, а не через поиск.** Участники получают уведомления о релевантных возможностях мгновенно.
- **Контролируйте отношения с аудиторией.** Ваш домен, ваш регион, ваш платёжный провайдер, ваши правила.
- **Без лицензирования “за пользователя”.** Полный доступ к коду, размещение где угодно.

### Начните здесь

  
- **[Запустите свой клон](/docs/customization/quick-start.md)** — Установите через install.sh или выберите управляемый хостинг Ringdom

  
- **[Посмотрите живые клоны](/docs/customization/success-stories.md)** — Реальные внедрения Ring в разных направлениях

  
- **[Поймите механику подбора](/docs/features/opportunities.md)** — Цикл 8-факторного подборщика Matcher

  
- **[Заработайте деньги](/docs/features/store.md)** — Магазин, оплаты и подписки

### Пример клонированных внедрений (реальные, действующие клоны)

Это настоящие клоны Ring в империи Ringdom — посетите их, чтобы оценить платформу для своего продукта. Полный список с деталями по модулям в [Reference Ring deployments](/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** | Медицина / государство (Украина) |
| **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`) |
| Секреты и backend | `.env.local` | `DB_BACKEND_MODE`, `AUTH_*`, Firebase FCM, цель деплоя |
| Данные приложения | PostgreSQL `ring_platform` | `data/schema.sql` + миграции клонов |
| Авторизация | Auth.js v5 (`auth.ts`) | `AUTH_SECRET` + OAuth-провайдер |
| Режим разработки | `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, затем проверьте запуск. По умолчанию используется `DB_BACKEND_MODE=k8s-postgres-fcm` (PostgreSQL для данных, Firebase Admin — только для FCM-уведомлений при настройке).

Подробный гид по быстрой установке с трекингом времени доступен в [Getting Started](/docs/getting-started.md) — пошаговая установка, требования, миграции и первое успешное включение.

### Проверенные модули и сервисы

Платформа построена вокруг документированных фичей и сервисов, а не монолитом:

- **Возможности + подбор** — `lib/ai/matcher.ts`, `OpportunityMatchingService` ([Возможности](/docs/features/opportunities.md))
- **DatabaseService** — `lib/database/DatabaseService.ts`, контракт `{ success, data, error }` ([Архитектура](/docs/architecture.md))
- **Payments** — PaymentConductor, стандартные вебхуки по адресу `/api/payments/*/webhook` ([PaymentConductor](/docs/features/payment-conductor.md))
- **Notifications** — `notification-service`, фильтры по сущностям ([Уведомления](/docs/features/notifications.md))

Исследуйте остальные возможности ниже в “Исследователе фич”.

## Экосистема возможностей

## Получить свой Ring

Два реальных варианта, одна кодовая база:

| Путь | Когда выбирается | Что вы получаете |
|------|-----------|---------|
| **OSS self-host** | Если управляете своей инфраструктурой (ноутбук, VPS, k3s) | Полный исходный код + `install.sh` ([Быстрый старт](/docs/customization/quick-start.md)) |
| **Ringdom managed** | Если хотите, чтобы всё администрирование (k8s, DNS, оперирование) взяли на себя | Управляемый клон с [ringdom.org](https://ringdom.org) |

## Связанная документация

  
- [getting-started/index](/docs/getting-started/index.md) — Следующий шаг: локальный запуск клона с помощью install.sh, миграций схемы и проверки успешного старта.

  
- [customization/quick-start](/docs/customization/quick-start.md) — Общие шаги: выберите самостоятельный хостинг или управление от Ringdom, чтобы запустить собственный Ring.

  
- [features/opportunities](/docs/features/opportunities.md) — Детальный разбор: 8-факторный подбор, двуаспектные офферы/запросы и цикл создать → подобрать → уведомить.

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