Files
veilix.app/docs/stages/stage-1h-referral.md
andreypr207andClaude Opus 5.5 515acfb69d Документация: этапы по фазам, решения D-026…D-033
- Новый порядок этапов (D-026): фаза 1 — концепт на dev без внешних
  сервисов (1b сайт, 1c вход, 1d ключи, 1e счёт и демо-оплата,
  1f демо-выдача, 1g продления, 1h рефералы); фаза 2 — Telegram;
  фаза 3 — ALTCHA, ЮKassa, почта, Twenty, Chatwoot, Umami, выдача
  через API и публичный запуск; фаза 4 — звёзды и эквайринги.
- Решения: демо-оплата по списку IP (D-027), выдача ключей через
  адаптер manual/demo/api (D-028), страницы сайта из блоков Payload
  (D-029), пересборка через revalidatePath (D-030), RU-адрес у mass
  (D-031), счётчик свободных серверов (D-032), переводы на 5 языков
  в каждом этапе (D-033).
- Тексты описывают работающий продукт; Вейликс — выделенный IP на
  общем сервере; Telegram поддержки — @veilix_support; сроки ответа
  не обещаем; VPN-серверы не ведут журналов.
- Ссылки на этапы во всех документах, Q-12 решён (ЮKassa для RUB),
  R-19 (библиотеки для headless Chromium) сделано.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-22 03:48:10 +02:00

2.2 KiB

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

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

1. Цель

«Приведите друга — вы оба получите по месяцу в подарок» по правилам 04-billing.md, раздел 11. Бонус — дни срока ключа, а не деньги (D-025). Этим этапом заканчивается концепт: дальше он проверяется на 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, раздел 7).
  7. Шаблон referral_reward на 5 языках; список приглашений в админке.

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

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

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

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