> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bedolagam.ru/llms.txt
> Use this file to discover all available pages before exploring further.

# Статистика продаж

> Аналитический дашборд продаж с 6 вкладками: сводка, триалы, продажи, продления, доп. услуги, пополнения

## Обзор

Дашборд статистики продаж доступен в **админ-панели Cabinet** и предоставляет комплексную аналитику по всем финансовым потокам сервиса. Данные загружаются через 6 API-эндпоинтов и визуализируются с помощью интерактивных графиков.

<CardGroup cols={3}>
  <Card title="6 вкладок аналитики" icon="chart-pie">
    Сводка, триалы, продажи, продления, доп. услуги, пополнения
  </Card>

  <Card title="Гибкие периоды" icon="calendar">
    Пресеты (7, 30, 90 дней, всё время) или произвольный диапазон дат
  </Card>

  <Card title="Интерактивные графики" icon="chart-area">
    Area, Bar, Donut, Multi-series — на базе Recharts
  </Card>
</CardGroup>

## Доступ

Требуется разрешение `stats:read`. По умолчанию доступно всем администраторам.

Путь в Cabinet: **Админ-панель → Статистика продаж**

## Выбор периода

Вверху страницы — селектор периода, общий для всех вкладок:

| Пресет           | Описание                                     |
| ---------------- | -------------------------------------------- |
| **7 дней**       | Последняя неделя                             |
| **30 дней**      | Последний месяц (по умолчанию)               |
| **90 дней**      | Последний квартал                            |
| **Всё время**    | С начала работы сервиса                      |
| **Произвольный** | Выбор дат через date picker (макс. 730 дней) |

## Вкладка: Сводка

Верхнеуровневые метрики за выбранный период:

| Метрика                    | Описание                                      |
| -------------------------- | --------------------------------------------- |
| **Общий доход**            | Сумма депозитов реальными платёжными методами |
| **Активные подписки**      | Текущие оплаченные подписки                   |
| **Активные триалы**        | Текущие триальные подписки                    |
| **Новые триалы**           | Триалы, созданные в периоде                   |
| **Конверсия триал→оплата** | Процент конвертированных триалов              |
| **Продления**              | Повторные покупки существующих пользователей  |
| **Доход от доп. услуг**    | Доход от покупки трафика                      |

## Вкладка: Триалы

Аналитика триальных подписок и регистраций.

### Карточки

| Метрика             | Описание                                |
| ------------------- | --------------------------------------- |
| Всего триалов       | Количество выданных триалов             |
| Регистрации         | Все регистрации пользователей в периоде |
| Конверсия           | Процент конвертированных триалов        |
| Средний срок триала | Среднее количество дней до конверсии    |

### Графики

* **По провайдеру** — столбчатая диаграмма: распределение триалов по способу регистрации (Telegram, Google, Yandex, Discord, VK, email)
* **Регистрации и триалы по дням** — двухсерийный area chart: ежедневные регистрации пользователей vs выданные триалы

## Вкладка: Продажи

Статистика продаж подписок (без триалов).

### Карточки

| Метрика      | Описание                       |
| ------------ | ------------------------------ |
| Всего продаж | Количество оплаченных подписок |
| Средний чек  | Средняя стоимость подписки     |
| Топ тариф    | Самый популярный тариф         |

### Графики

* **По тарифам** — столбчатая диаграмма: количество продаж на тариф
* **По периоду подписки** — donut chart: распределение по длительности (30, 90, 180, 365 дней)
* **Ежедневный доход** — area chart: сумма платежей по дням
* **Продажи по тарифам по дням** — multi-series area chart: ежедневная разбивка по тарифам с легендой

## Вкладка: Продления

Анализ повторных покупок существующих пользователей.

### Карточки

| Метрика            | Описание                                           |
| ------------------ | -------------------------------------------------- |
| Продления          | Общее количество                                   |
| Доход от продлений | Сумма в валюте                                     |
| Процент продлений  | Доля продлений от всех покупок                     |
| Текущий период     | Количество и доход за период                       |
| Предыдущий период  | Количество и доход за прошлый аналогичный период   |
| Изменение          | Абсолютное и процентное с индикатором тренда (↑↓→) |

### Графики

* **Продления по дням** — area chart: ежедневные продления

## Вкладка: Доп. услуги

Статистика покупок дополнительного трафика и устройств.

<Note>
  Начиная с v3.29.0, покупки устройств и трафика корректно отображаются в статистике. Ранее такие покупки (ручные и автоматические) создавали транзакции с типом `WITHDRAWAL` вместо `SUBSCRIPTION_PAYMENT`, из-за чего не попадали во вкладку «Доп. услуги». Теперь все покупки устройств и трафика создают транзакции с типом `SUBSCRIPTION_PAYMENT` и учитываются в статистике.
</Note>

### Карточки

| Метрика            | Описание                          |
| ------------------ | --------------------------------- |
| Покупки трафика    | Общее количество                  |
| Всего ГБ           | Суммарный докупленный трафик      |
| Доход от трафика   | Сумма в валюте                    |
| Покупки устройств  | Количество покупок доп. устройств |
| Доход от устройств | Сумма от покупок устройств        |

### Графики

* **По пакетам** — столбчатая диаграмма: распределение по размеру пакета (5 GB, 10 GB, и т.д.)
* **Покупки по дням** — двухсерийный area chart: ежедневные покупки трафика vs покупки устройств

## Вкладка: Пополнения

Аналитика депозитов по всем платёжным системам.

### Карточки

| Метрика          | Описание                   |
| ---------------- | -------------------------- |
| Всего пополнений | Общее количество депозитов |
| Общая сумма      | Суммарный объём пополнений |
| Средний чек      | Средний размер пополнения  |

### Графики

* **По способу оплаты** — столбчатая диаграмма: суммы пополнений в разбивке по платёжным системам (YooKassa, CryptoBot, Telegram Stars, и др.)
* **Пополнения по дням** — area chart: ежедневная динамика пополнений
* **Пополнения по дням по платёжкам** — multi-series area chart: ежедневная разбивка по платёжным системам с легендой и форматированием валюты в тултипах

## API эндпоинты

Все эндпоинты находятся по пути `/cabinet/admin/stats/sales/` и требуют JWT-авторизации с разрешением `stats:read`.

| Эндпоинт             | Описание              |
| -------------------- | --------------------- |
| `GET /summary`       | Сводные метрики       |
| `GET /trials`        | Статистика триалов    |
| `GET /subscriptions` | Статистика продаж     |
| `GET /renewals`      | Статистика продлений  |
| `GET /addons`        | Статистика доп. услуг |
| `GET /deposits`      | Статистика пополнений |

### Параметры запроса

| Параметр     | Тип      | Описание                                 |
| ------------ | -------- | ---------------------------------------- |
| `days`       | `int`    | Пресет периода: 7, 30, 90, 0 (всё время) |
| `start_date` | `string` | Начало периода (ISO формат)              |
| `end_date`   | `string` | Конец периода (ISO формат)               |

<Note>
  Если указаны `start_date` и `end_date`, параметр `days` игнорируется. Максимальный диапазон — 730 дней.
</Note>