docs/stages/stage-1g-referral.md

# Этап 1g. Реферальная программа

Статус: не начат.

## 1. Цель

«Приведите друга — вы оба получите по месяцу в подарок» по правилам [04-billing.md](../04-billing.md), раздел 11. Бонус — дни срока ключа, а не деньги ([D-025](../decisions/D-025-referral-days.md)).

## 2. Входит

1. Реферальные коды пользователей.
2. Маршрут `my.<домен>/r/<код>`: cookie `vx_ref` на 60 дней и переход на сайт бренда.
3. Привязка при регистрации; коллекция `referrals`.
4. Бонус обоим после первой оплаты заказа `new_key` приглашённого: дни к ключам через `key-extensions`; статус `review` при совпадении хэша IP.
5. Число дней бонуса в `sites` (`referralBonusDays`).
6. Страница `/referral` по макету: приглашено, начислено месяцев, ожидает; ссылка с копированием; приглашённые с замаскированной почтой. Условия под ссылкой — про дни, а не про списание ([07-frontend.md](../07-frontend.md), раздел 7).
7. Шаблон `referral_reward` на RU и EN; список приглашений в админке.

## 3. Перед стартом

Q-19 — крайние случаи бонуса днями.

## 4. Готово, когда

1. A делится ссылкой → B регистрируется → B оплачивает первый заказ → к ключу B и к последнему ключу A добавлено по 30 дней.
2. У A нет подходящего ключа — дни добавляются к следующему ключу A.
3. Самоприглашение с того же IP попадает в `review`.
4. Ссылка другого бренда не засчитывается.
Этап 0: документация и макеты 2026-10-21 03:30:38 +02:00			`# Этап 1g. Реферальная программа`

			`Статус: не начат.`

			`## 1. Цель`

Документация: решения Q-02, Q-08, Q-09, Q-16; реферальный бонус днями 2026-10-21 16:00:32 +02:00			`«Приведите друга — вы оба получите по месяцу в подарок» по правилам [04-billing.md](../04-billing.md), раздел 11. Бонус — дни срока ключа, а не деньги ([D-025](../decisions/D-025-referral-days.md)).`
Этап 0: документация и макеты 2026-10-21 03:30:38 +02:00
			`## 2. Входит`

			`1. Реферальные коды пользователей.`
			2. Маршрут `my.<домен>/r/<код>`: cookie `vx_ref` на 60 дней и переход на сайт бренда.
			3. Привязка при регистрации; коллекция `referrals`.
Документация: решения Q-02, Q-08, Q-09, Q-16; реферальный бонус днями 2026-10-21 16:00:32 +02:00			4. Бонус обоим после первой оплаты заказа `new_key` приглашённого: дни к ключам через `key-extensions`; статус `review` при совпадении хэша IP.
			5. Число дней бонуса в `sites` (`referralBonusDays`).
			6. Страница `/referral` по макету: приглашено, начислено месяцев, ожидает; ссылка с копированием; приглашённые с замаскированной почтой. Условия под ссылкой — про дни, а не про списание ([07-frontend.md](../07-frontend.md), раздел 7).
Этап 0: документация и макеты 2026-10-21 03:30:38 +02:00			7. Шаблон `referral_reward` на RU и EN; список приглашений в админке.

Документация: решения Q-02, Q-08, Q-09, Q-16; реферальный бонус днями 2026-10-21 16:00:32 +02:00			`## 3. Перед стартом`
Этап 0: документация и макеты 2026-10-21 03:30:38 +02:00
Документация: решения Q-02, Q-08, Q-09, Q-16; реферальный бонус днями 2026-10-21 16:00:32 +02:00			`Q-19 — крайние случаи бонуса днями.`

			`## 4. Готово, когда`

			`1. A делится ссылкой → B регистрируется → B оплачивает первый заказ → к ключу B и к последнему ключу A добавлено по 30 дней.`
			`2. У A нет подходящего ключа — дни добавляются к следующему ключу A.`
			3. Самоприглашение с того же IP попадает в `review`.
			`4. Ссылка другого бренда не засчитывается.`