feat: implement backend core with repricing logic, case management, and multi-service architecture

This commit is contained in:
2026-05-13 00:28:13 +03:00
parent 38f3199c33
commit d9aae5b85e
15 changed files with 596 additions and 90 deletions

View File

@@ -1,83 +1,65 @@
# 🚀 AutoMarket Ultimate Marketplace SaaS Platform
**AutoMarket** — это комплексная экосистема для профессиональных продавцов на маркетплейсах (Ozon, Wildberries и др.), объединяющая в себе инструменты защиты контента, финансовой аналитики, SEO-мониторинга и автоматизации клиентского сервиса с помощью искусственного интеллекта.
**AutoMarket** — это ультимативная экосистема для профессиональных селлеров, которая автоматизирует 90% рутины: от генерации контента и защиты авторских прав до динамического ценообразования и глубокой аналитики конкурентов.
---
## 💎 Ключевые возможности
### 1. 🤖 AI Assistant & Content Factory
* **Умный генератор карточек:** Создание полноценного контента (описание, ТТХ, SEO-теги) по одному лишь названию товара.
* **ИИ-Фото Промпты:** Генерация детальных заданий для нейросетей (Midjourney/DALL-E) для создания идеальных изображений товара.
* **Авто-претензии:** Генерация юридически грамотных жалоб на нарушителей.
* **Умный ответчик:** Автоматическая генерация ответов на отзывы покупателей.
* **Умный генератор карточек:** Создание контента (описание, ТТХ, SEO) по названию товара.
* **Deep Insight:** ИИ-анализ конкурентов. Сравнение карточек, поиск слабых мест и разработка стратегии захвата рынка.
* **ИИ-Фото Промпты:** Задания для нейросетей (Midjourney/DALL-E) для создания идеального фотоконтента.
* **Авто-ответчик и Претензии:** Генерация ответов на отзывы и юридических жалоб на нарушителей.
### 2. 📊 Multi-account Dashboard
* Единое окно управления для неограниченного количества магазинов и юридических лиц.
* Агрегированная статистика продаж, выручки и состояния API-подключений в реальном времени.
### 2. 🏷️ Авто-репрайзер (Dynamic Pricing)
* **Борьба за BuyBox:** Автоматическое изменение цены для удержания лидерства в поиске.
* **Защита маржи:** Установка Min/Max цены, ниже которой система не опустится.
* **Стратегии:** "На 1₽ дешевле конкурента" или "Следование за минимальной ценой".
### 3. 📈 SEO Мониторинг позиций
* Отслеживание позиций товаров по ключевым словам в поиске маркетплейсов.
* Интерактивные графики динамики позиций с инвертированной шкалой (ТОП-1 всегда сверху).
### 3. 📉 Умная аналитика и Прогноз
* **Inventory Forecasting:** Прогноз обнуления остатков (Out-of-Stock) с цветовой индикацией критических уровней.
* **SEO Tracker:** Мониторинг позиций в поиске по ключевым словам с историческими графиками.
* **P&L Калькулятор:** Детальный расчет чистой прибыли, ROI и маржинальности.
### 4. 🛡️ Защита контента (Image Matching)
* Вычисление визуальных отпечатков (pHash) для ваших фотографий.
* Автоматический поиск визуальных клонов и дубликатов вашего контента у конкурентов.
* Бесшовная подача жалобы на найденного нарушителя в один клик.
* **Visual Fingerprinting:** Поиск визуальных клонов ваших фото с помощью алгоритма pHash.
* **Авто-жалобы:** Подача претензий нарушителям в один клик.
### 5. 💰 Финансовый калькулятор (Unit Economics)
* Детальный расчет чистой прибыли, маржинальности и ROI.
* Учет комиссий маркетплейса, налогов (УСН), логистики и рекламных расходов (ДРР).
### 5. 👥 Командный доступ (Enterprise Ready)
* **Ролевая модель:** Admin, Manager, Viewer.
* **Multi-user:** Возможность добавления сотрудников в общую компанию с ограничением прав доступа.
### 6. 📑 Генерация отчетов
* Экспорт данных в CSV.
* Генерация профессиональных PDF-претензий с поддержкой кириллицы для отправки в поддержку маркетплейса.
---
## 🎨 Дизайн и интерфейс
* **Premium Dark Mode:** Элегантная темная тема для комфортной работы.
* **Glassmorphism:** Современный "стеклянный" интерфейс с эффектами размытия и неоновыми акцентами.
* **Real-time Notifications:** Мгновенные уведомления через WebSockets (Socket.io) при обнаружении новых событий.
* **Lucide Icons:** Использование современной библиотеки иконок для интуитивной навигации.
### 6. 🤖 Telegram-бот "Директор магазина"
* **Мобильный офис:** Команды `/stats`, `/oos`, `/reviews` и `/cases` для управления бизнесом прямо из Telegram.
* **Real-time Push:** Мгновенные уведомления о новых событиях и критических остатках.
---
## 🛠 Технологический стек
* **Backend:** Python (Flask), Flask-SocketIO (Real-time), Flasgger (Swagger/OpenAPI).
* **Frontend:** Vanilla JS, Chart.js (Графики), Lucide (Иконки).
* **Database:** PostgreSQL.
* **AI:** Google Gemini 1.5 Flash API.
* **DevOps:** Docker, Docker Compose.
* **Backend:** Python (Flask), Socket.io, telebot (Telegram API).
* **Frontend:** Vanilla JS + Chart.js + Lucide Icons + Glassmorphism UI.
* **Database:** PostgreSQL (с поддержкой RBAC и Multi-tenancy).
* **AI:** Google Gemini 1.5 Flash.
* **Security:** JWT (с ролью и ID компании), Bcrypt, Audit Logging.
---
## 🚀 Быстрый запуск
### 1. Требования
* Установленный Docker и Docker Compose.
* API ключ Google AI Studio (для работы ИИ).
### 2. Настройка окружения
Создайте файл `backend/.env` и заполните его:
### 1. Настройка .env
```env
DATABASE_URL=postgresql://user:pass@host.docker.internal:5432/automarket
JWT_SECRET=your_super_secret_key
JWT_SECRET=your_secret
GEMINI_API_KEY=your_gemini_key
TELEGRAM_BOT_TOKEN=your_bot_token
TELEGRAM_CHAT_ID=your_chat_id
GEMINI_API_KEY=your_gemini_api_key
```
### 3. Запуск через Docker
### 2. Запуск
```bash
docker-compose up --build
python backend/bot.py # Запуск Telegram-бота
```
После запуска:
* Frontend: `http://localhost:8080`
* Backend API: `http://localhost:5000`
* Swagger Docs: `http://localhost:5000/api/docs`
---
## 📜 Аудит и Безопасность
Проект включает встроенную систему **Audit Log**, которая фиксирует все важные действия пользователя (вход, создание/удаление объектов, финансовые расчеты) для обеспечения полной прозрачности и безопасности бизнеса.
* **Web UI:** `http://localhost:8080`
* **API Docs:** `http://localhost:5000/api/docs`