Добавлен документ PRD.md с описанием платформы Premium Partner, включая технологический стек, основные экраны и функционал, дизайн, API и безопасность.

2025-06-02 13:06:39 +03:00 · 2025-06-02 13:06:39 +03:00 · 4d9fbd6e77
commit 4d9fbd6e77
parent 00f5ecfb9c
1 changed files with 181 additions and 0 deletions
--- a/PRD.md
+++ 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.