**Проблема:**
- Реферальные API падали в dev режиме из-за хардкода DB подключения
- Невозможно было запустить на локальном сервере без доступа к production БД
**Решение:**
- Вынесены DB credentials в ENV переменные:
- DB_HOST, DB_USER, DB_PASSWORD, DB_NAME
- Добавлена проверка isDbConfigured в API endpoints
- Mock ответы для dev режима (когда DB не настроена)
**Изменения:**
- .env.example: добавлены DB переменные
- .env.local: пустые DB переменные (dev mode)
- /api/referral/track: graceful fallback без DB
- /api/referral/stats: mock данные без DB
**Результат:**
- ✅ Dev сервер работает без production DB
- ✅ Production будет использовать DB из ENV
- ✅ Логи предупреждают о dev режиме
- ✅ Реферальная система опциональна для разработки
**База данных:**
- Создана таблица referrals в MariaDB (193.168.175.128)
- Поля: username, referrer_username, referral_count, bonus_days_earned
- Foreign keys к users таблице с CASCADE/SET NULL
**API Endpoints:**
- POST /api/referral/track - отслеживание новых рефералов
- Автоматический расчёт бонусов: +7 дней за каждого
- Milestone bonus: +30 дней за каждые 5 рефералов
- Обновление expire даты реферера в users таблице
- GET /api/referral/stats?username=xxx - статистика
- Возвращает количество рефералов, бонусные дни
- Список приглашённых пользователей со статусами
**Интеграция:**
- POST /api/create-user принимает referrerId параметр
- Автоматический вызов /api/referral/track после создания юзера
- Параметр ref из URL при активации trial
**UI:**
- /app/referral/page.tsx - страница статистики
- 3 KPI карточки: рефералов, бонусных дней, milestone
- Реферальная ссылка с кнопкой копирования
- Список приглашённых юзеров с иконками статуса
- Инфоблок о механике начисления бонусов
**ReferralModal обновлён:**
- Добавлена кнопка «Моя статистика» → /referral
- Перенос Share/Copy кнопок на второй/третий план
**Зависимости:**
- mysql2@3.16.3 - для подключения к MariaDB
**Логика бонусов:**
- +7 дней за каждого успешного реферала
- +30 дней бонус за каждые 5 рефералов (milestone)
- Автоматическое обновление expire поля в users таблице
- Сохранение всех бонусов в bonus_days_earned
- Заменены все хардкоды umbrix_bot на process.env.NEXT_PUBLIC_TELEGRAM_BOT_USERNAME
- Fallback на Dorod_vps_bot если ENV не задана
- Теперь реферальные ссылки динамически генерируются: t.me/${botUsername}?start=ref_${userId}
- Обновлено 3 места: shareReferralLink(), ReferralModal props, onCopy callback
- Выбор устройства (💻 Компьютер / 📱 Телефон)
- Проверка наличия приложения
- Выбор локаций для Extended тарифа (3 из списка)
- Показ ссылки/QR кода
- Автоматическое открытие после активации Trial
- Прогресс бар для отслеживания шагов
