> ## 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-эндпоинтов и визуализируются с помощью интерактивных графиков.

> **6 вкладок аналитики**
>
> Сводка, триалы, продажи, продления, доп. услуги, пополнения

> **Гибкие периоды**
>
> Пресеты (7, 30, 90 дней, всё время) или произвольный диапазон дат

> **Интерактивные графики**
>
> Area, Bar, Donut, Multi-series — на базе Recharts

## Доступ

Требуется разрешение `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` и учитываются в статистике.

### Карточки

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

### Графики

* **По пакетам** — столбчатая диаграмма: распределение по размеру пакета (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 дней.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.