1. Обзор

Платформа Premium Partner — это веб-дашборд для партнеров, позволяющий отслеживать рефералов, продажи, комиссионные и выплаты. Она дает аналитику по агентам, привлеченным клиентам и финансовым операциям.
2. Технологический стек

    Фронтенд: Next.js (на React)

    Бэкенд: FastAPI (Python)

    Стилизация: Стандартные стили React 


3. Основные экраны и функционал
3.1. /home — Дашборд
3.1.1. Ключевые метрики (крупные цифры)

    Общий доход (за все время и текущий период)

    Общие выплаты (за все время и текущий период)

    Количество активных рефералов

    Конверсия (продажи / рефералы)

    Ожидающие выплаты

3.1.2. Визуализация данных

    Графики (Chart.js, D3.js и аналоги):

        Динамика дохода (по дням/неделям/месяцам)

        Динамика выплат

        Сравнение рефералов и продаж

3.1.3. Последние продажи по рефералам (с пагинацией)

    Таблица с колонками:

        ID реферала

        Имя агента

        Сумма продажи

        Комиссия

        Дата

        Статус (Ожидает/Выплачено)

    Пагинация (10/25/50 на странице)

    Сортировка по дате/сумме

3.2. /stat — Статистика и аналитика
3.2.1. Список агентов

    Таблица с эффективностью агентов:

        ID агента

        Имя

        Всего рефералов

        Всего продаж

        Конверсия

        Общая комиссия

        Статус (Активен/Неактивен)

    Фильтры:

        Период (дата начала и конца)

        Статус агента

        Минимум/максимум рефералов/продаж

3.2.2. Список рефералов

    Таблица с деталями:

        ID реферала

        Имя клиента

        Дата привлечения

        Статус (Конвертирован/Ожидает)

        Сумма продажи (если конвертирован)

3.2.3. Список продаж

    Таблица всех продаж:

        ID продажи

        Имя клиента

        Имя агента

        Сумма продажи

        % комиссии

        Статус выплаты

3.2.4. Экспорт данных

    Выгрузка в CSV/Excel (агенты, рефералы, продажи).

3.3. /billing — Финансы
3.3.1. Текущий баланс

    Доступные средства (с разбивкой):

        Общий заработок

        Общие выплаты

        Ожидающие выплаты

3.3.2. История выплат

    Таблица завершенных транзакций:

        ID выплаты

        Сумма

        Дата

        Статус (Завершена/Ожидается/Ошибка)

        Способ выплаты (Банк/Крипто/Др.)

3.3.3. Запрос выплаты

    Форма для вывода средств:

        Сумма (с учетом лимита баланса)

        Выбор способа выплаты

        Подтверждение

4. Дизайн и цветовая схема

    Основные цвета: На основе синего React (#61DAFB) + дополнительные оттенки.

    Темная/светлая тема: Опционально.

    Адаптивность: Поддержка ПК и мобильных устройств.

    Навигация: Через бургер-меню (иконка-гамбургер, выпадающее меню с основными разделами).

    Загрузка: Skeleton-экраны при запросах.

    Ошибки: Четкие сообщения при проблемах с API.

5. API (бэкенд)
Эндпоинт	Метод	Описание
/api/dashboard	GET	Данные дашборда
/api/referrals	GET	Список рефералов (с пагинацией)
/api/agents	GET	Список агентов (с фильтрами)
/api/sales	GET	Список продаж
/api/payouts	GET	История выплат
/api/payouts/request	POST	Запрос выплаты
6. Безопасность и авторизация

    Аутентификация через JWT (логин/выход).

    Ролевая модель (Админ/Партнер).

    Ограничение запросов к API.