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 у корені репозиторію.