Scanning documentation library
Scanning documentation library
Scanning documentation library
Модуль 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-chain | UUPS ReferralRewards — payReferral |
pending_approval; внутренний кредит → мгновенный mint (если minter настроен).| Маршрут | Доступ | Назначение |
|---|---|---|
/refcodes | Авторизованный | Коды, ссылки, история наград |
/admin/refcodes | Админ | Approve/reject, mint |
POST /api/refcodes/track | Публичный | Счётчик visits |
GET /api/cron/refcodes-mint | Cron + CRON_SECRET | Очередь approved → mint |
Ссылка: {APP_URL}?ref={CODE}.
proxy.ts — cookies из ?ref=.POST /api/store/orders — атрибуция + guards.settlements, referral_rewards.onMembershipPaid если есть referredBy.| Миграция | Таблицы |
|---|---|
005_refcodes_schema.sql | refcodes, referral_rewards |
007_settlements_schema.sql | settlements, erp_sales_assists, … |
./scripts/apply-erp-migrations-dev.sh # dev: 005 + 007Dev DB: ring_platform на ring-postgres-dev.
| Переменная | Описание |
|---|---|
REFERRAL_MINTER_PRIVATE_KEY | Operator wallet (mint) |
REFERRAL_REWARDS_ADDRESS | UUPS proxy |
REFERRAL_REWARD_TOKEN_ADDRESS | ERC20 награды |
CRON_SECRET | Bearer для /api/cron/refcodes-mint |
REFERRAL_REWARD_PERCENT | Fallback % (по умолч. 5) |
Runbook on-chain: REFERRAL-ONCHAIN-OPS.md в корне репозитория.
Модуль 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-chain | UUPS ReferralRewards — payReferral |
pending_approval; внутренний кредит → мгновенный mint (если minter настроен).| Маршрут | Доступ | Назначение |
|---|---|---|
/refcodes | Авторизованный | Коды, ссылки, история наград |
/admin/refcodes | Админ | Approve/reject, mint |
POST /api/refcodes/track | Публичный | Счётчик visits |
GET /api/cron/refcodes-mint | Cron + CRON_SECRET | Очередь approved → mint |
Ссылка: {APP_URL}?ref={CODE}.
proxy.ts — cookies из ?ref=.POST /api/store/orders — атрибуция + guards.settlements, referral_rewards.onMembershipPaid если есть referredBy.| Миграция | Таблицы |
|---|---|
005_refcodes_schema.sql | refcodes, referral_rewards |
007_settlements_schema.sql | settlements, erp_sales_assists, … |
./scripts/apply-erp-migrations-dev.sh # dev: 005 + 007Dev DB: ring_platform на ring-postgres-dev.
| Переменная | Описание |
|---|---|
REFERRAL_MINTER_PRIVATE_KEY | Operator wallet (mint) |
REFERRAL_REWARDS_ADDRESS | UUPS proxy |
REFERRAL_REWARD_TOKEN_ADDRESS | ERC20 награды |
CRON_SECRET | Bearer для /api/cron/refcodes-mint |
REFERRAL_REWARD_PERCENT | Fallback % (по умолч. 5) |
Runbook on-chain: REFERRAL-ONCHAIN-OPS.md в корне репозитория.
Модуль 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-chain | UUPS ReferralRewards — payReferral |
pending_approval; внутренний кредит → мгновенный mint (если minter настроен).| Маршрут | Доступ | Назначение |
|---|---|---|
/refcodes | Авторизованный | Коды, ссылки, история наград |
/admin/refcodes | Админ | Approve/reject, mint |
POST /api/refcodes/track | Публичный | Счётчик visits |
GET /api/cron/refcodes-mint | Cron + CRON_SECRET | Очередь approved → mint |
Ссылка: {APP_URL}?ref={CODE}.
proxy.ts — cookies из ?ref=.POST /api/store/orders — атрибуция + guards.settlements, referral_rewards.onMembershipPaid если есть referredBy.| Миграция | Таблицы |
|---|---|
005_refcodes_schema.sql | refcodes, referral_rewards |
007_settlements_schema.sql | settlements, erp_sales_assists, … |
./scripts/apply-erp-migrations-dev.sh # dev: 005 + 007Dev DB: ring_platform на ring-postgres-dev.
| Переменная | Описание |
|---|---|
REFERRAL_MINTER_PRIVATE_KEY | Operator wallet (mint) |
REFERRAL_REWARDS_ADDRESS | UUPS proxy |
REFERRAL_REWARD_TOKEN_ADDRESS | ERC20 награды |
CRON_SECRET | Bearer для /api/cron/refcodes-mint |
REFERRAL_REWARD_PERCENT | Fallback % (по умолч. 5) |
Runbook on-chain: REFERRAL-ONCHAIN-OPS.md в корне репозитория.