> For the complete documentation index, see [llms.txt](https://amber-metaverse.gitbook.io/trend-arena/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://amber-metaverse.gitbook.io/trend-arena/produkt/onboarding.md).

# Onboarding & User Flow

Дата обновления: 2026-03-27

***

## Текущее состояние

| Что                                 | Статус     |
| ----------------------------------- | ---------- |
| Регистрация через Telegram          | ✅ Работает |
| Стартовые 20 USDT                   | ✅ Работает |
| Квесты секция 1-3                   | ✅ Работает |
| Daily Streak (базовый)              | ✅ Работает |
| Туториалы (базовый + промежуточный) | ✅ Работает |
| Joyride-туры по экранам             | ✅ Работает |
| Deeplinks (реферал, лига, экран)    | ✅ Работает |

**Проблема:** 75% не делают первый своп. D1 = 12%. 94% свопают только после 24ч. First-session UX не конвертирует.

***

## Приоритеты доработки

### P1 — Первый своп (конверсия 23% → 35%)

Сейчас: юзер попадает на Hot Seat, видит короля, не понимает что делать. 75% уходят без свопа.

| Задача                                  | Описание                                                                           | Сложность |
| --------------------------------------- | ---------------------------------------------------------------------------------- | --------- |
| **Авто-рекомендация токена**            | При первом входе — popup с горячим токеном и кнопкой "Купить $5" (3 тапа до свопа) | Низкая    |
| **Visual celebration**                  | Конфетти + звук + "+$X" при первом прибыльном свопе                                | Низкая    |
| **"Сделай первый своп — получи 10 AC"** | A/B тест: popup-баннер для тех кто не свопнул за 5 минут                           | Низкая    |
| **Трекинг воронки**                     | Screen visit funnel — откуда уходят до первого свопа                               | Низкая    |

***

### P2 — Стрик (D1 retention 12% → 25%)

Стрик работает, но юзеры не чувствуют его ценность.

| Задача                          | Описание                                                                                                                                                       | Сложность |
| ------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------- |
| **Уведомление о первом стрике** | После обучения — toast вверху экрана ("Стрик 1 день! Вернись завтра!"). Ощущение что что-то дали. Вариант B: модальное окно сразу после первого этапа обучения | Низкая    |
| **Награда каждый 7-й день**     | x2-x3 AC или бокс. В календаре стрика — "сундучок" на 7-м дне, прогресс-бар до него                                                                            | Низкая    |
| **Визуальное усиление**         | Огонёк растёт с длиной стрика (маленький → большое пламя). Цвет меняется. На лидерборде виден другим                                                           | Средняя   |
| **Предупреждение о потере**     | Push / in-app: "Стрик 23 дня сгорит!" — акцент на то что потеряешь                                                                                             | Низкая    |
| **Совместные стрики**           | До 3 человек. Все должны зайти — иначе ломается у всех. Аватарки + кто зашёл/не зашёл. Бонус +N AC                                                             | Средняя   |

***

### P3 — Виральность через боксы

| Задача                      | Описание                                                       | Сложность |
| --------------------------- | -------------------------------------------------------------- | --------- |
| **"Кончились AC" → инвайт** | Нажал "Крутить" без AC → модалка "Пригласи друзей — получи AC" | Низкая    |
| **Триггеры по свапам**      | После 5 / 25 / 50 свапов — та же модалка с растущим бонусом    | Низкая    |

***

## Как работает сейчас (референс)

### Регистрация

1. Пользователь открывает Telegram Mini App
2. LoadingScreen → Telegram auth → `registerUser()` (POST `/api/auth/telegram`)
3. Автоматически: создание кошелька, 20 USDT + ETH на газ
4. Первый экран: Hot Seat (или deeplink-экран)

### Deeplinks

| Параметр                   | Пример          | Действие              |
| -------------------------- | --------------- | --------------------- |
| `ref=123`                  | Реферальный код | Привязка к реферeру   |
| `league=ABC`               | ID лиги         | Автовступление в лигу |
| `ref=123_league=ABC`       | Комбо           | Реферал + лига        |
| `screen=profile&tab=tasks` | Навигация       | Конкретный экран      |
| `screen=token&addr=0x...`  | Токен           | Карточка токена       |

### Туториалы

| Уровень       | Формат                                | Награда         | Требование    |
| ------------- | ------------------------------------- | --------------- | ------------- |
| Базовый       | Видео \~2 мин + квиз 5 вопросов (4/5) | 10 AC + 15 USDT | —             |
| Промежуточный | Видео + квиз 4 вопроса (3/4)          | 10 AC           | Базовый       |
| Продвинутый   | Coming Soon                           | 20 AC           | Промежуточный |

Joyride-туры: автоматические подсказки при первом посещении экрана (Portfolio, Arena, Swap, Token, Profile, Hot Seat). Можно пропустить.

***

## Квесты

### Секция 1: Онбординг (доступна сразу)

| Задание             | AC     | USDT   |
| ------------------- | ------ | ------ |
| Базовый туториал    | 10     | 15     |
| Первый своп         | 10     | 15     |
| 3 свопа             | 10     | 15     |
| Подписка TG группа  | 5      | 10     |
| Подписка TG канал   | 5      | 10     |
| Подписка X          | 5      | 10     |
| **Бонус за секцию** | **50** | **20** |
| **Итого**           | **95** | **95** |

### Секция 2: Активный пользователь

| Задание                   | AC     | USDT |
| ------------------------- | ------ | ---- |
| Промежуточный туториал    | 10     | —    |
| Прибыль >10% на 1 монете  | 10     | —    |
| Прибыль >10% на 3 монетах | 30     | —    |
| Прибыль >10% на 7 монетах | 50     | —    |
| Друг сделал первый своп   | 40     | —    |
| Друг прошёл туториал      | 5      | —    |
| Голос за удаление фразы   | 5      | 10   |
| Голос за добавление фразы | 5      | 10   |
| **Бонус за секцию**       | **50** | —    |

### Секция 3: Профессионал

| Задание                       | AC     |
| ----------------------------- | ------ |
| Продвинутый туториал (скоро)  | 20     |
| Прибыль >25% на 3 монетах     | 20     |
| Прибыль >25% на 5 монетах     | 40     |
| 3 друга сделали первый своп   | 100    |
| 3 друга прошли туториал       | 20     |
| 20 друзей сделали первый своп | 250    |
| **Бонус за секцию**           | **50** |

***

## Daily Streak

| Параметр          | Значение                                    |
| ----------------- | ------------------------------------------- |
| Старт             | День регистрации = День 1                   |
| Ежедневно         | 5 AC                                        |
| Каждый 7-й день   | **увеличенная награда** (x2-x3 AC или бокс) |
| Timezone          | Привязка к часовому поясу юзера             |
| Streak Freeze     | 10-15 AC, автоактивация при пропуске        |
| Streak Repair     | 25 AC или 3 свопа за 24ч (окно 48ч)         |
| Совместные стрики | До 3 человек, бонус +N AC                   |

**Визуал:**

* 7-дневный календарь с "сундучком" на 7-м дне
* Огонёк растёт с длиной стрика
* На лидерборде виден другим

***

## Реферальный путь

1. Юзер открывает ссылку `t.me/TrendArenaBot/app?startapp=ref=USERID`
2. Регистрация с привязкой к рефереру (L1 + L2)
3. Первый своп → реферер получает 40 AC
4. Туториал → реферер получает 5 AC
5. Далее: реферер получает 50% от комиссий свопов (USDT)
6. Если в ссылке `league=` → автовступление

***

## Таймлайн первого дня

```
ОТКРЫТИЕ
  │
  ├─ Telegram auth + регистрация
  ├─ [Фон] 20 USDT на кошелёк
  │
  ▼
HOT SEAT (первый экран)
  │
  ├─ Popup: горячий токен + "Купить $5" ← НОВОЕ (P1)
  ├─ Первый своп → Task #2 (+10 AC, +15 USDT)
  ├─ Visual celebration: конфетти ← НОВОЕ (P1)
  ├─ Toast: "Стрик 1 день!" ← НОВОЕ (P2)
  │
  ▼
ТУТОРИАЛ + КВЕСТЫ
  │
  ├─ Базовый туториал → Task #1 (+10 AC, +15 USDT)
  ├─ Подписки TG/X → Tasks #4-6
  ├─ Ещё 2 свопа → Task #3
  ├─ Секция 1 завершена → бонус (+50 AC, +20 USDT)
  │
  ▼
ИТОГО ДЕНЬ 1:
  ├─ ~115 USDT (20 стартовых + 95 квесты)
  ├─ 95 AC
  ├─ 3+ свопа
  └─ Стрик = 1, toast "Вернись завтра!"
```

***

## Что открыто / что закрыто

**Открыто с первого дня:** все экраны (Arena, Portfolio, Hot Seat, Swap), все задания секции 1, лиги, реферальная ссылка, лидерборд.

**Закрыто:** промежуточный туториал (нужен базовый), продвинутый (coming soon).

***

## Связанные документы

* [FeaturePlan.md](/trend-arena/strategiya/featureplan.md) — план развития (боксы, стрики, статусы)
* [Achievements.md](/trend-arena/produkt/achievements.md) — 96 ачивок
* [Strategy-RealWorld-Connection.md](/trend-arena/strategiya/strategy-realworld-connection.md) — стратегия связи с реальным миром
* [Ideas.md](/trend-arena/strategiya/ideas.md) — полный каталог идей (57 фич)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://amber-metaverse.gitbook.io/trend-arena/produkt/onboarding.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.