veilix.app/docs/stages/stage-1h-referral.md

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

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

## 1. Цель

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

## 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` на 5 языках; список приглашений в админке.

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

Этап 1g готов.

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

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