Loading documentation...
Preparing Ring content
Концепції, цінність і типові сценарії
Концепції, цінність і типові сценарії
Preparing Ring content
Preparing Ring content
Preparing Ring content
Використовуйте вкладки Founder / Developer у бічній панелі, щоб відфільтрувати цю сторінку. Користувацькі сценарії рендеряться на /membership; ця стаття документує рівні, ціни та платіжні рейки.
Членство — як клон Ring розрізняє рівні спільноти та монетизує доступ. Драбина ролей — SSOT (features/auth/user-role.ts), ціноутворення апгрейду керується конфігом (lib/membership/pricing.ts), і кожен платіж — картка, кредитний баланс, PayPal або нативний токен — проходить через PaymentConductor.
| Role | Meaning |
|---|---|
visitor | Не автентифікований, лише перегляд |
subscriber | Платний базовий підписник — базовий доступ до спільноти |
member | Підвищений статус із ширшим доступом |
confidential | Доступ до конфіденційних ресурсів |
admin | Адмін платформи |
superadmin | Адмін платформи найвищого рівня |
Апгрейди переводять користувача з subscriber → member. Конфіг рівня confidential явно вимагає роль confidential.
membership.ring.memberUpgradeAmount), річний дає 20% знижки від monthly × 12, а живі котирування йдуть через desk oracle, щоб сума рахунку збігалася з котируванням.MEMBERSHIP_DESK_CREDIT_HINT_MIN) UI підказує обмін на Token Desk замість купівлі кредиту.membership.ring і конфіг рівня member у ring-config.json.Deep-dive: кредитний реєстр і двоставковий SSOT, у який осідають платежі за членство.
Depends-on: картка, PayPal і токен-рейки всі йдуть через PaymentConductor.
Same-workflow: життєвий цикл поновлення та обробка скасування.
See-also: як credit_balance і реєстр підписок живуть у JSONB-схемі.
Використовуйте вкладки Founder / Developer у бічній панелі, щоб відфільтрувати цю сторінку. Користувацькі сценарії рендеряться на /membership; ця стаття документує рівні, ціни та платіжні рейки.
Членство — як клон Ring розрізняє рівні спільноти та монетизує доступ. Драбина ролей — SSOT (features/auth/user-role.ts), ціноутворення апгрейду керується конфігом (lib/membership/pricing.ts), і кожен платіж — картка, кредитний баланс, PayPal або нативний токен — проходить через PaymentConductor.
| Role | Meaning |
|---|---|
visitor | Не автентифікований, лише перегляд |
subscriber | Платний базовий підписник — базовий доступ до спільноти |
member | Підвищений статус із ширшим доступом |
confidential | Доступ до конфіденційних ресурсів |
admin | Адмін платформи |
superadmin | Адмін платформи найвищого рівня |
Апгрейди переводять користувача з subscriber → member. Конфіг рівня confidential явно вимагає роль confidential.
membership.ring.memberUpgradeAmount), річний дає 20% знижки від monthly × 12, а живі котирування йдуть через desk oracle, щоб сума рахунку збігалася з котируванням.MEMBERSHIP_DESK_CREDIT_HINT_MIN) UI підказує обмін на Token Desk замість купівлі кредиту.membership.ring і конфіг рівня member у ring-config.json.Deep-dive: кредитний реєстр і двоставковий SSOT, у який осідають платежі за членство.
Depends-on: картка, PayPal і токен-рейки всі йдуть через PaymentConductor.
Same-workflow: життєвий цикл поновлення та обробка скасування.
See-also: як credit_balance і реєстр підписок живуть у JSONB-схемі.
Використовуйте вкладки Founder / Developer у бічній панелі, щоб відфільтрувати цю сторінку. Користувацькі сценарії рендеряться на /membership; ця стаття документує рівні, ціни та платіжні рейки.
Членство — як клон Ring розрізняє рівні спільноти та монетизує доступ. Драбина ролей — SSOT (features/auth/user-role.ts), ціноутворення апгрейду керується конфігом (lib/membership/pricing.ts), і кожен платіж — картка, кредитний баланс, PayPal або нативний токен — проходить через PaymentConductor.
| Role | Meaning |
|---|---|
visitor | Не автентифікований, лише перегляд |
subscriber | Платний базовий підписник — базовий доступ до спільноти |
member | Підвищений статус із ширшим доступом |
confidential | Доступ до конфіденційних ресурсів |
admin | Адмін платформи |
superadmin | Адмін платформи найвищого рівня |
Апгрейди переводять користувача з subscriber → member. Конфіг рівня confidential явно вимагає роль confidential.
membership.ring.memberUpgradeAmount), річний дає 20% знижки від monthly × 12, а живі котирування йдуть через desk oracle, щоб сума рахунку збігалася з котируванням.MEMBERSHIP_DESK_CREDIT_HINT_MIN) UI підказує обмін на Token Desk замість купівлі кредиту.membership.ring і конфіг рівня member у ring-config.json.Deep-dive: кредитний реєстр і двоставковий SSOT, у який осідають платежі за членство.
Depends-on: картка, PayPal і токен-рейки всі йдуть через PaymentConductor.
Same-workflow: життєвий цикл поновлення та обробка скасування.
See-also: як credit_balance і реєстр підписок живуть у JSONB-схемі.
| Methods |
|---|
| Purpose |
|---|
/api/membership/payment/card | POST, GET | Картковий checkout для членства |
/api/membership/payment/credit | POST, GET | Шлях оплати з кредитного балансу |
/api/membership/payment/paypal | POST, GET | Checkout через PayPal |
/api/membership/payment/token | POST, GET | Оплата нативним токеном |
/api/membership/subscription/create | POST | Створити підписку |
/api/membership/subscription/status | GET | Прочитати статус підписки |
/api/membership/subscription/cancel | POST, GET | Скасувати підписку |
Куди потрапляють гроші
Платні апгрейди пишуться в реєстр підписок (subscription_ledger) — провайдер credit_balance позначає поновлення, оплачені кредитом (next_payment_due індексується в data/schema.sql). Сам кредит живе в записі користувача (users.data.credit_balance), а wallet-транзакції слугують аудитом (features/wallet/services/credit-balance-service.ts).
Білінгові періоди
MembershipBillingPeriod = 'monthly' | 'yearly'. Річна вартість = annualUpgradeAmount, якщо задано, інакше monthly × 12 × 0.8 (знижка 20%). Форма рівня: MemberTierConfig { amount, currency, description, duration }.
| Methods |
|---|
| Purpose |
|---|
/api/membership/payment/card | POST, GET | Картковий checkout для членства |
/api/membership/payment/credit | POST, GET | Шлях оплати з кредитного балансу |
/api/membership/payment/paypal | POST, GET | Checkout через PayPal |
/api/membership/payment/token | POST, GET | Оплата нативним токеном |
/api/membership/subscription/create | POST | Створити підписку |
/api/membership/subscription/status | GET | Прочитати статус підписки |
/api/membership/subscription/cancel | POST, GET | Скасувати підписку |
Куди потрапляють гроші
Платні апгрейди пишуться в реєстр підписок (subscription_ledger) — провайдер credit_balance позначає поновлення, оплачені кредитом (next_payment_due індексується в data/schema.sql). Сам кредит живе в записі користувача (users.data.credit_balance), а wallet-транзакції слугують аудитом (features/wallet/services/credit-balance-service.ts).
Білінгові періоди
MembershipBillingPeriod = 'monthly' | 'yearly'. Річна вартість = annualUpgradeAmount, якщо задано, інакше monthly × 12 × 0.8 (знижка 20%). Форма рівня: MemberTierConfig { amount, currency, description, duration }.
| Methods |
|---|
| Purpose |
|---|
/api/membership/payment/card | POST, GET | Картковий checkout для членства |
/api/membership/payment/credit | POST, GET | Шлях оплати з кредитного балансу |
/api/membership/payment/paypal | POST, GET | Checkout через PayPal |
/api/membership/payment/token | POST, GET | Оплата нативним токеном |
/api/membership/subscription/create | POST | Створити підписку |
/api/membership/subscription/status | GET | Прочитати статус підписки |
/api/membership/subscription/cancel | POST, GET | Скасувати підписку |
Куди потрапляють гроші
Платні апгрейди пишуться в реєстр підписок (subscription_ledger) — провайдер credit_balance позначає поновлення, оплачені кредитом (next_payment_due індексується в data/schema.sql). Сам кредит живе в записі користувача (users.data.credit_balance), а wallet-транзакції слугують аудитом (features/wallet/services/credit-balance-service.ts).
Білінгові періоди
MembershipBillingPeriod = 'monthly' | 'yearly'. Річна вартість = annualUpgradeAmount, якщо задано, інакше monthly × 12 × 0.8 (знижка 20%). Форма рівня: MemberTierConfig { amount, currency, description, duration }.