Documentation

    Концепции, ценность и типичные сценарии клонирования — меньше кода.

    Добро пожаловать в Ring Platform
    Краткий справочник
    С чего начать
    Предварительные требования
    Установка
    Первый успех
    Следующие шаги
    Функции
    Store
    Склад и остатки
    Управление вендорами
    Комиссии и расчёты
    SubscriptionConductor
    PaymentConductor
    Интеграция платежей
    Интеграция WayForPay
    Web3 Кошелек
    Реферальные коды (Refcodes)
    NFT Exhibition Marketplace
    Система Стейкинга Токенов
    Entities
    Opportunities
    Messaging
    Модуль Новостей - Цифровой Газетный Опыт
    Блоги участников
    Система Резервирования Имён Пользователей
    Научный редактор
    Notifications
    Push-уведомления через FCM (Ring)
    Email AI-CRM
    Протокол Tunnel
    Authentication
    Безопасность и соответствие
    Система локалей
    Мобильный Опыт
    Паттерны Оптимизации Производительности
    Примеры
    Quick Start
    White Label
    Интеграция Web3
    Реальные Проекты
    Кастомизация
    Branding
    Темы оформления
    Features
    Localization
    Настройка токеномики
    Web3
    Token launch jurisdictions
    Интеграции
    Ethereum-кошельки (Wagmi v3)
    Развёртывание
    Self-hosted развёртывание
    Vercel
    Docker
    Конфигурация Окружения
    Monitoring
    Оптимизация производительности
    Backup
    Архитектура
    Data Model
    Security
    Real Time
    Архитектура PaymentConductor
    Разработка
    Ring MCP Server

    Быстрый вход (CTO · аудиторы · агенты)

    Приветствие — миссия и аудитории
    Краткий справочник
    С чего начать
    Архитектура и Auth.js
    Режимы бэкенда и базы данных (DB_BACKEND_MODE)
    Self-hosted
    Ring MCP Tools
    Ring MCP Server
    Token economics
    Token launch jurisdictions
    Деплой (Docker · k8s)
    Безопасность и соответствие требованиям
    ringdom.org — база LegioX
    Исходный код — лицензия MIT (GitHub)

    Documentation

    Концепции, ценность и типичные сценарии клонирования — меньше кода.

    Добро пожаловать в Ring Platform
    Краткий справочник
    С чего начать
    Предварительные требования
    Установка
    Первый успех
    Следующие шаги
    Функции
    Store
    Склад и остатки
    Управление вендорами
    Комиссии и расчёты
    SubscriptionConductor
    PaymentConductor
    Интеграция платежей
    Интеграция WayForPay
    Web3 Кошелек
    Реферальные коды (Refcodes)
    NFT Exhibition Marketplace
    Система Стейкинга Токенов
    Entities
    Opportunities
    Messaging
    Модуль Новостей - Цифровой Газетный Опыт
    Блоги участников
    Система Резервирования Имён Пользователей
    Научный редактор
    Notifications
    Push-уведомления через FCM (Ring)
    Email AI-CRM
    Протокол Tunnel
    Authentication
    Безопасность и соответствие
    Система локалей
    Мобильный Опыт
    Паттерны Оптимизации Производительности
    Примеры
    Quick Start
    White Label
    Интеграция Web3
    Реальные Проекты
    Кастомизация
    Branding
    Темы оформления
    Features
    Localization
    Настройка токеномики
    Web3
    Token launch jurisdictions
    Интеграции
    Ethereum-кошельки (Wagmi v3)
    Развёртывание
    Self-hosted развёртывание
    Vercel
    Docker
    Конфигурация Окружения
    Monitoring
    Оптимизация производительности
    Backup
    Архитектура
    Data Model
    Security
    Real Time
    Архитектура PaymentConductor
    Разработка
    Ring MCP Server

    Быстрый вход (CTO · аудиторы · агенты)

    Приветствие — миссия и аудитории
    Краткий справочник
    С чего начать
    Архитектура и Auth.js
    Режимы бэкенда и базы данных (DB_BACKEND_MODE)
    Self-hosted
    Ring MCP Tools
    Ring MCP Server
    Token economics
    Token launch jurisdictions
    Деплой (Docker · k8s)
    Безопасность и соответствие требованиям
    ringdom.org — база LegioX
    Исходный код — лицензия MIT (GitHub)

    Documentation

    Концепции, ценность и типичные сценарии клонирования — меньше кода.

    Добро пожаловать в Ring Platform
    Краткий справочник
    С чего начать
    Предварительные требования
    Установка
    Первый успех
    Следующие шаги
    Функции
    Store
    Склад и остатки
    Управление вендорами
    Комиссии и расчёты
    SubscriptionConductor
    PaymentConductor
    Интеграция платежей
    Интеграция WayForPay
    Web3 Кошелек
    Реферальные коды (Refcodes)
    NFT Exhibition Marketplace
    Система Стейкинга Токенов
    Entities
    Opportunities
    Messaging
    Модуль Новостей - Цифровой Газетный Опыт
    Блоги участников
    Система Резервирования Имён Пользователей
    Научный редактор
    Notifications
    Push-уведомления через FCM (Ring)
    Email AI-CRM
    Протокол Tunnel
    Authentication
    Безопасность и соответствие
    Система локалей
    Мобильный Опыт
    Паттерны Оптимизации Производительности
    Примеры
    Quick Start
    White Label
    Интеграция Web3
    Реальные Проекты
    Кастомизация
    Branding
    Темы оформления
    Features
    Localization
    Настройка токеномики
    Web3
    Token launch jurisdictions
    Интеграции
    Ethereum-кошельки (Wagmi v3)
    Развёртывание
    Self-hosted развёртывание
    Vercel
    Docker
    Конфигурация Окружения
    Monitoring
    Оптимизация производительности
    Backup
    Архитектура
    Data Model
    Security
    Real Time
    Архитектура PaymentConductor
    Разработка
    Ring MCP Server

    Быстрый вход (CTO · аудиторы · агенты)

    Приветствие — миссия и аудитории
    Краткий справочник
    С чего начать
    Архитектура и Auth.js
    Режимы бэкенда и базы данных (DB_BACKEND_MODE)
    Self-hosted
    Ring MCP Tools
    Ring MCP Server
    Token economics
    Token launch jurisdictions
    Деплой (Docker · k8s)
    Безопасность и соответствие требованиям
    ringdom.org — база LegioX
    Исходный код — лицензия MIT (GitHub)
    1. Документация
    2. /Функции
    3. /Реферальные коды (Refcodes)
    Обновлено 10 июн. 2026 г.2 мин прослушивания
    Ring Platform Logo

    Завантаження документації...

    Підготовка контенту платформи Ring

    1. Документация
    2. /Функции
    3. /Реферальные коды (Refcodes)
    Обновлено 10 июн. 2026 г.2 мин прослушивания
    Ring Platform Logo

    Завантаження документації...

    Підготовка контенту платформи Ring

    1. Документация
    2. /Функции
    3. /Реферальные коды (Refcodes)
    Обновлено 10 июн. 2026 г.2 мин прослушивания
    Ring Platform Logo

    Завантаження документації...

    Підготовка контенту платформи Ring

    Реферальные коды (Refcodes)

    Модуль refcodes превращает Ring Platform в реферальный движок роста: каждый подключённый кошелёк получает код, первая оплаченная покупка атрибутируется рефереру, награда фиксируется в PostgreSQL и (при настройке) минтится on-chain.

    EN canonical: полные диаграммы, контракт, deploy и таблицы env — Referral Codes (EN) · Архитектура refcodes

    Обзор

    СлойОтветственность
    Атрибуция?ref=CODE → cookies ring_ref + ring_ref_visible (30 дней)
    Регистрацияusers.data.referredBy при первом входе
    CheckoutПоля referralCode, referrerUserId, referrerWallet в заказе
    ERPТа же иерархия % комиссии, что и в комиссиях ERP
    LedgerТаблица referral_rewards
    On-chainUUPS ReferralRewards — payReferral

    Бизнес-правила

    • Один код на кошелёк (8 символов).
    • Только первая оплаченная покупка покупателя.
    • Без self-referral (user ID или общий кошелёк).
    • WayForPay → pending_approval; внутренний кредит → мгновенный mint (если minter настроен).

    Маршруты и API

    МаршрутДоступНазначение
    /refcodesАвторизованныйКоды, ссылки, история наград
    /admin/refcodesАдминApprove/reject, mint
    POST /api/refcodes/trackПубличныйСчётчик visits
    GET /api/cron/refcodes-mintCron + CRON_SECRETОчередь approved → mint

    Ссылка: {APP_URL}?ref={CODE}.

    Поток оплаты

    1. proxy.ts — cookies из ?ref=.
    2. POST /api/store/orders — атрибуция + guards.
    3. WayForPay или credit → stock, settlements, referral_rewards.
    4. Членство WayForPay → onMembershipPaid если есть referredBy.

    База данных

    МиграцияТаблицы
    005_refcodes_schema.sqlrefcodes, referral_rewards
    007_settlements_schema.sqlsettlements, erp_sales_assists, …

    Dev DB: ring_platform на ring-postgres-dev.

    Переменные окружения (ключевые)

    ПеременнаяОписание
    REFERRAL_MINTER_PRIVATE_KEYOperator wallet (mint)
    REFERRAL_REWARDS_ADDRESSUUPS proxy
    REFERRAL_REWARD_TOKEN_ADDRESSERC20 награды
    CRON_SECRETBearer для /api/cron/refcodes-mint
    REFERRAL_REWARD_PERCENTFallback % (по умолч. 5)

    Runbook on-chain: REFERRAL-ONCHAIN-OPS.md в корне репозитория.

    Связанное

    • Ring ERP — комиссии
    • Магазин
    • PaymentConductor

    Реферальные коды (Refcodes)

    Модуль refcodes превращает Ring Platform в реферальный движок роста: каждый подключённый кошелёк получает код, первая оплаченная покупка атрибутируется рефереру, награда фиксируется в PostgreSQL и (при настройке) минтится on-chain.

    EN canonical: полные диаграммы, контракт, deploy и таблицы env — Referral Codes (EN) · Архитектура refcodes

    Обзор

    СлойОтветственность
    Атрибуция?ref=CODE → cookies ring_ref + ring_ref_visible (30 дней)
    Регистрацияusers.data.referredBy при первом входе
    CheckoutПоля referralCode, referrerUserId, referrerWallet в заказе
    ERPТа же иерархия % комиссии, что и в комиссиях ERP
    LedgerТаблица referral_rewards
    On-chainUUPS ReferralRewards — payReferral

    Бизнес-правила

    • Один код на кошелёк (8 символов).
    • Только первая оплаченная покупка покупателя.
    • Без self-referral (user ID или общий кошелёк).
    • WayForPay → pending_approval; внутренний кредит → мгновенный mint (если minter настроен).

    Маршруты и API

    МаршрутДоступНазначение
    /refcodesАвторизованныйКоды, ссылки, история наград
    /admin/refcodesАдминApprove/reject, mint
    POST /api/refcodes/trackПубличныйСчётчик visits
    GET /api/cron/refcodes-mintCron + CRON_SECRETОчередь approved → mint

    Ссылка: {APP_URL}?ref={CODE}.

    Поток оплаты

    1. proxy.ts — cookies из ?ref=.
    2. POST /api/store/orders — атрибуция + guards.
    3. WayForPay или credit → stock, settlements, referral_rewards.
    4. Членство WayForPay → onMembershipPaid если есть referredBy.

    База данных

    МиграцияТаблицы
    005_refcodes_schema.sqlrefcodes, referral_rewards
    007_settlements_schema.sqlsettlements, erp_sales_assists, …

    Dev DB: ring_platform на ring-postgres-dev.

    Переменные окружения (ключевые)

    ПеременнаяОписание
    REFERRAL_MINTER_PRIVATE_KEYOperator wallet (mint)
    REFERRAL_REWARDS_ADDRESSUUPS proxy
    REFERRAL_REWARD_TOKEN_ADDRESSERC20 награды
    CRON_SECRETBearer для /api/cron/refcodes-mint
    REFERRAL_REWARD_PERCENTFallback % (по умолч. 5)

    Runbook on-chain: REFERRAL-ONCHAIN-OPS.md в корне репозитория.

    Связанное

    • Ring ERP — комиссии
    • Магазин
    • PaymentConductor

    Реферальные коды (Refcodes)

    Модуль refcodes превращает Ring Platform в реферальный движок роста: каждый подключённый кошелёк получает код, первая оплаченная покупка атрибутируется рефереру, награда фиксируется в PostgreSQL и (при настройке) минтится on-chain.

    EN canonical: полные диаграммы, контракт, deploy и таблицы env — Referral Codes (EN) · Архитектура refcodes

    Обзор

    СлойОтветственность
    Атрибуция?ref=CODE → cookies ring_ref + ring_ref_visible (30 дней)
    Регистрацияusers.data.referredBy при первом входе
    CheckoutПоля referralCode, referrerUserId, referrerWallet в заказе
    ERPТа же иерархия % комиссии, что и в комиссиях ERP
    LedgerТаблица referral_rewards
    On-chainUUPS ReferralRewards — payReferral

    Бизнес-правила

    • Один код на кошелёк (8 символов).
    • Только первая оплаченная покупка покупателя.
    • Без self-referral (user ID или общий кошелёк).
    • WayForPay → pending_approval; внутренний кредит → мгновенный mint (если minter настроен).

    Маршруты и API

    МаршрутДоступНазначение
    /refcodesАвторизованныйКоды, ссылки, история наград
    /admin/refcodesАдминApprove/reject, mint
    POST /api/refcodes/trackПубличныйСчётчик visits
    GET /api/cron/refcodes-mintCron + CRON_SECRETОчередь approved → mint

    Ссылка: {APP_URL}?ref={CODE}.

    Поток оплаты

    1. proxy.ts — cookies из ?ref=.
    2. POST /api/store/orders — атрибуция + guards.
    3. WayForPay или credit → stock, settlements, referral_rewards.
    4. Членство WayForPay → onMembershipPaid если есть referredBy.

    База данных

    МиграцияТаблицы
    005_refcodes_schema.sqlrefcodes, referral_rewards
    007_settlements_schema.sqlsettlements, erp_sales_assists, …

    Dev DB: ring_platform на ring-postgres-dev.

    Переменные окружения (ключевые)

    ПеременнаяОписание
    REFERRAL_MINTER_PRIVATE_KEYOperator wallet (mint)
    REFERRAL_REWARDS_ADDRESSUUPS proxy
    REFERRAL_REWARD_TOKEN_ADDRESSERC20 награды
    CRON_SECRETBearer для /api/cron/refcodes-mint
    REFERRAL_REWARD_PERCENTFallback % (по умолч. 5)

    Runbook on-chain: REFERRAL-ONCHAIN-OPS.md в корне репозитория.

    Связанное

    • Ring ERP — комиссии
    • Магазин
    • PaymentConductor
    bash
    
./scripts/apply-erp-migrations-dev.sh   # dev: 005 + 007
    bash
    
./scripts/apply-erp-migrations-dev.sh   # dev: 005 + 007
    bash
    
./scripts/apply-erp-migrations-dev.sh   # dev: 005 + 007