ВозможностиОрганизации
Документация
    Ring Platform

    Децентрализованное самостроящееся будущее

    Войти
    Организации
    Возможности
    Магазин
    Документация
    Концепции платформы
    RING ЭкономикаSonoratek LLCГлобальное влияниеAI встречает Web3
    Начать
    Быстрый стартКалькуляторДорожная карта
    Конфиденциальность|Контакты
    v1.104.17|Sonoratek LLC

    Documentation

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

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

    Loading documentation...

    Preparing Ring content

    Ring Logo

    Loading documentation...

    Preparing Ring content

    Ring Logo

    Loading documentation...

    Preparing Ring content

    Реферальные коды (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
    1. Документация
    2. /Функции
    3. /Реферальные коды (Refcodes)
    Обновлено 10 июн. 2026 г.2 мин прослушивания
    1. Документация
    2. /Функции
    3. /Реферальные коды (Refcodes)
    Обновлено 10 июн. 2026 г.2 мин прослушивания
    1. Документация
    2. /Функции
    3. /Реферальные коды (Refcodes)
    Обновлено 10 июн. 2026 г.2 мин прослушивания