diff --git a/PRD.md b/PRD.md new file mode 100644 index 0000000..d0a4a37 --- /dev/null +++ b/PRD.md @@ -0,0 +1,181 @@ +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.