partner-next/PRD.md

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.