Loading documentation...
Preparing Ring content
Концепції, цінність і типові сценарії
Концепції, цінність і типові сценарії
Preparing Ring content
Preparing Ring content
Preparing Ring content
Для керівників: Ring — white-label платформа: один код, багато брендованих деплоїв. Продакшен-кільця працюють на PostgreSQL-primary у Kubernetes, Firebase лише для push, платежі через PaymentConductor, локалізація без циклів редіректів авторизації.
Ring Platform v1.6.0 — багатотенантний Next.js застосунок з єдиним контрактом DatabaseService, конфігурованими платежами та опційним Web3/токенним шаром на клон. Ця сторінка — хаб архітектури; кожна тема має окрему глибоку статтю.
| Вимір | Підхід Ring |
|---|---|
| Застосунок | Next.js 16 App Router, React 19 Server Components, Tailwind 4 |
| Дані (продакшен) | DB_BACKEND_MODE=k8s-postgres-fcm — Postgres + PostGIS, JSONB-first |
| Автентифікація | Auth.js v5 — auth() на рівні layout, тонкий proxy.ts лише для локалі |
| Платежі | PaymentConductor — WayForPay, Stripe, ledger + webhooks |
| Realtime | TunnelHub — native WSS / SSE / poll; RING_DEPLOY_TARGET |
| Файли | Vercel Blob або сховище клону |
| Деплой | k3s (кільця ringdom.org) — не Vercel Postgres |
| Розширення | White-label env, portal config, токен-контракти на клон |
Матриця DB_BACKEND_MODE — Postgres vs Firebase vs Supabase, FCM-only Firebase
JSONB-first схема, PostGIS, контракт collections, міграції
Auth.js v5, JWT сесії, Postgres adapter, ролі
Тонкий proxy, auth у layout, localePrefix: as-needed
Checkout через PaymentConductor (fiat) або RING credit / on-chain підписку. Settlement і комісії — у PaymentConductor та store guides.
Публічні сторінки — next-intl. Документація та новини — файли docs/{locale}/. EN канонічний, якщо LOCALE-GAPS не позначає стислий UK/RU summary.
Форк репо, portal branding, режим БД, опційна токеноміка — White-label quick start, Token economics.
Базис v1.6.0: Postgres-primary + PaymentConductor + slim proxy + locale system. Почніть з Режимів бекенду, потім Environment.
DB_HYBRID_MODE ≠ DB_BACKEND_MODE. Для нових деплоїв використовуйте DB_BACKEND_MODE; legacy hybrid — на сторінці backend-modes.
Для керівників: Ring — white-label платформа: один код, багато брендованих деплоїв. Продакшен-кільця працюють на PostgreSQL-primary у Kubernetes, Firebase лише для push, платежі через PaymentConductor, локалізація без циклів редіректів авторизації.
Ring Platform v1.6.0 — багатотенантний Next.js застосунок з єдиним контрактом DatabaseService, конфігурованими платежами та опційним Web3/токенним шаром на клон. Ця сторінка — хаб архітектури; кожна тема має окрему глибоку статтю.
| Вимір | Підхід Ring |
|---|---|
| Застосунок | Next.js 16 App Router, React 19 Server Components, Tailwind 4 |
| Дані (продакшен) | DB_BACKEND_MODE=k8s-postgres-fcm — Postgres + PostGIS, JSONB-first |
| Автентифікація | Auth.js v5 — auth() на рівні layout, тонкий proxy.ts лише для локалі |
| Платежі | PaymentConductor — WayForPay, Stripe, ledger + webhooks |
| Realtime | TunnelHub — native WSS / SSE / poll; RING_DEPLOY_TARGET |
| Файли | Vercel Blob або сховище клону |
| Деплой | k3s (кільця ringdom.org) — не Vercel Postgres |
| Розширення | White-label env, portal config, токен-контракти на клон |
Матриця DB_BACKEND_MODE — Postgres vs Firebase vs Supabase, FCM-only Firebase
JSONB-first схема, PostGIS, контракт collections, міграції
Auth.js v5, JWT сесії, Postgres adapter, ролі
Тонкий proxy, auth у layout, localePrefix: as-needed
Checkout через PaymentConductor (fiat) або RING credit / on-chain підписку. Settlement і комісії — у PaymentConductor та store guides.
Публічні сторінки — next-intl. Документація та новини — файли docs/{locale}/. EN канонічний, якщо LOCALE-GAPS не позначає стислий UK/RU summary.
Форк репо, portal branding, режим БД, опційна токеноміка — White-label quick start, Token economics.
Базис v1.6.0: Postgres-primary + PaymentConductor + slim proxy + locale system. Почніть з Режимів бекенду, потім Environment.
DB_HYBRID_MODE ≠ DB_BACKEND_MODE. Для нових деплоїв використовуйте DB_BACKEND_MODE; legacy hybrid — на сторінці backend-modes.
Для керівників: Ring — white-label платформа: один код, багато брендованих деплоїв. Продакшен-кільця працюють на PostgreSQL-primary у Kubernetes, Firebase лише для push, платежі через PaymentConductor, локалізація без циклів редіректів авторизації.
Ring Platform v1.6.0 — багатотенантний Next.js застосунок з єдиним контрактом DatabaseService, конфігурованими платежами та опційним Web3/токенним шаром на клон. Ця сторінка — хаб архітектури; кожна тема має окрему глибоку статтю.
| Вимір | Підхід Ring |
|---|---|
| Застосунок | Next.js 16 App Router, React 19 Server Components, Tailwind 4 |
| Дані (продакшен) | DB_BACKEND_MODE=k8s-postgres-fcm — Postgres + PostGIS, JSONB-first |
| Автентифікація | Auth.js v5 — auth() на рівні layout, тонкий proxy.ts лише для локалі |
| Платежі | PaymentConductor — WayForPay, Stripe, ledger + webhooks |
| Realtime | TunnelHub — native WSS / SSE / poll; RING_DEPLOY_TARGET |
| Файли | Vercel Blob або сховище клону |
| Деплой | k3s (кільця ringdom.org) — не Vercel Postgres |
| Розширення | White-label env, portal config, токен-контракти на клон |
Матриця DB_BACKEND_MODE — Postgres vs Firebase vs Supabase, FCM-only Firebase
JSONB-first схема, PostGIS, контракт collections, міграції
Auth.js v5, JWT сесії, Postgres adapter, ролі
Тонкий proxy, auth у layout, localePrefix: as-needed
Checkout через PaymentConductor (fiat) або RING credit / on-chain підписку. Settlement і комісії — у PaymentConductor та store guides.
Публічні сторінки — next-intl. Документація та новини — файли docs/{locale}/. EN канонічний, якщо LOCALE-GAPS не позначає стислий UK/RU summary.
Форк репо, portal branding, режим БД, опційна токеноміка — White-label quick start, Token economics.
Базис v1.6.0: Postgres-primary + PaymentConductor + slim proxy + locale system. Почніть з Режимів бекенду, потім Environment.
DB_HYBRID_MODE ≠ DB_BACKEND_MODE. Для нових деплоїв використовуйте DB_BACKEND_MODE; legacy hybrid — на сторінці backend-modes.
Орієнтири в коді
| Тема | Де читати |
|---|---|
| Locale proxy | proxy.ts, lib/proxy-intl.ts |
| Auth enforcement | (authenticated)/[locale]/layout.tsx, auth.config.ts |
| Режим БД | lib/database/backend-mode-config.ts |
| Платежі | features/store/services/payment-conductor* |
| Схема SSOT | data/schema.sql |
Шари компонентів
Процесори, ledger payment_transactions, єдині webhooks
Орієнтири в коді
| Тема | Де читати |
|---|---|
| Locale proxy | proxy.ts, lib/proxy-intl.ts |
| Auth enforcement | (authenticated)/[locale]/layout.tsx, auth.config.ts |
| Режим БД | lib/database/backend-mode-config.ts |
| Платежі | features/store/services/payment-conductor* |
| Схема SSOT | data/schema.sql |
Шари компонентів
Процесори, ledger payment_transactions, єдині webhooks
Орієнтири в коді
| Тема | Де читати |
|---|---|
| Locale proxy | proxy.ts, lib/proxy-intl.ts |
| Auth enforcement | (authenticated)/[locale]/layout.tsx, auth.config.ts |
| Режим БД | lib/database/backend-mode-config.ts |
| Платежі | features/store/services/payment-conductor* |
| Схема SSOT | data/schema.sql |
Шари компонентів
Процесори, ledger payment_transactions, єдині webhooks