182 lines
5.1 KiB
Markdown
182 lines
5.1 KiB
Markdown
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.
|