Сервис группового подбора СТЕ по их характеристикам

by one-zero-eight

💡 Идея

Проект представляет собой систему автоматической агрегации СТЕ (Стандартных Торговых Единиц) по карточкам продуктов, использующую машинное обучение и векторный поиск. Цель проекта — автоматически группировать похожие СТЕ в карточки продуктов, используя эмбеддинги, кластеризацию и семантический поиск.

🔧 Стек

🚀 Как запустить проект

Нужно установить Docker & Docker Compose

1. Задайте настройки окружения в .env:

   # Linux \ MacOS
   cp .env.example .env

2. Соберите и запустите все сервисы:

   docker compose up --build -d
   # Иногда на устройстве нужно писать "docker-compose" вместо "docker compose" 

Backend будет доступен по адресу http://localhost/api, а frontend на http://localhost.

🧩 Компоненты

Название	Описание	Дополнительная информация
Frontend	React интерфейс для управления СТЕ и агрегациями	📄 frontend/README.md
Backend	FastAPI backend с REST API, интеграция с Qdrant и ML моделями	📄 backend/README.md
ML	Модули машинного обучения для кластеризации и поиска СТЕ	📁 machine-learning/

📋 Основные возможности

Сервис умеет:

• обрабатывать и анализировать предоставленные данные о СТЕ, включая характеристики товаров;
• выбирать значимые характеристики для каждой категории товаров, по которым целесообразно проводить агрегацию;
• осуществлять группировку СТЕ по значимым характеристикам;
• на основе пользовательского запроса возвращать агрегированные СТЕ по значимым характеристикам;
• позволять пользователю вручную редактировать, добавлять, удалять или изменять связанные товары;
• ставить оценку агрегации;
• сохранять агрегацию или перегенерировать её по запросу пользователя.

👥 Команда

one-zero-eight team

Мембер	Вклад
belyakova-anna (лид)	Data Science
dantetemplar	Backend + Data Science
dofi4ka	Backend + Deployment
Mikis	Frontend
thexayotbe	Frontend

---