From 4d9fbd6e779d7faff3695d7657a0cd3438f1f26c Mon Sep 17 00:00:00 2001 From: Redsandyg Date: Mon, 2 Jun 2025 13:06:39 +0300 Subject: [PATCH] =?UTF-8?q?=D0=94=D0=BE=D0=B1=D0=B0=D0=B2=D0=BB=D0=B5?= =?UTF-8?q?=D0=BD=20=D0=B4=D0=BE=D0=BA=D1=83=D0=BC=D0=B5=D0=BD=D1=82=20PRD?= =?UTF-8?q?.md=20=D1=81=20=D0=BE=D0=BF=D0=B8=D1=81=D0=B0=D0=BD=D0=B8=D0=B5?= =?UTF-8?q?=D0=BC=20=D0=BF=D0=BB=D0=B0=D1=82=D1=84=D0=BE=D1=80=D0=BC=D1=8B?= =?UTF-8?q?=20Premium=20Partner,=20=D0=B2=D0=BA=D0=BB=D1=8E=D1=87=D0=B0?= =?UTF-8?q?=D1=8F=20=D1=82=D0=B5=D1=85=D0=BD=D0=BE=D0=BB=D0=BE=D0=B3=D0=B8?= =?UTF-8?q?=D1=87=D0=B5=D1=81=D0=BA=D0=B8=D0=B9=20=D1=81=D1=82=D0=B5=D0=BA?= =?UTF-8?q?,=20=D0=BE=D1=81=D0=BD=D0=BE=D0=B2=D0=BD=D1=8B=D0=B5=20=D1=8D?= =?UTF-8?q?=D0=BA=D1=80=D0=B0=D0=BD=D1=8B=20=D0=B8=20=D1=84=D1=83=D0=BD?= =?UTF-8?q?=D0=BA=D1=86=D0=B8=D0=BE=D0=BD=D0=B0=D0=BB,=20=D0=B4=D0=B8?= =?UTF-8?q?=D0=B7=D0=B0=D0=B9=D0=BD,=20API=20=D0=B8=20=D0=B1=D0=B5=D0=B7?= =?UTF-8?q?=D0=BE=D0=BF=D0=B0=D1=81=D0=BD=D0=BE=D1=81=D1=82=D1=8C.?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- PRD.md | 181 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 181 insertions(+) create mode 100644 PRD.md 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.