ЭВОСИНК (EvoSync)

Сервис автоматической синхронизации товарного каталога из Эвотор в ВКонтакте.

Возможности

• Подключение аккаунта Эвотор через OAuth
• Подключение сообщества ВКонтакте через токен
• Фильтрация по магазинам, группам и товарам (включить/исключить)
• Автоматическая фоновая синхронизация по расписанию
• Создание, обновление и удаление товаров в ВК-магазине
• Личный кабинет с веб-интерфейсом
• Просмотр закешированного каталога товаров

Стек технологий

• Backend: FastAPI, SQLAlchemy ORM, Alembic
• База данных: MariaDB (драйвер pymysql)
• Шаблоны: Jinja2 (интерфейс на русском языке)
• Аутентификация: Cookie-сессии, bcrypt
• Деплой: Docker Compose

Быстрый старт

Требования

• Docker и Docker Compose
• MariaDB/MySQL (можно использовать хост-машину или отдельный контейнер)

Настройка

1. Скопируйте файл переменных окружения:

cp .env.example .env

2. Отредактируйте .env:

# База данных
DATABASE_URL=mysql+pymysql://evosync:evosync@db:3306/evosync

# Безопасность (обязательно измените в production)
SECRET_KEY=your-random-secret-key-here

# URL приложения (используется в OAuth-редиректах)
BASE_URL=https://your-domain.ru

# Эвотор
EVOTOR_APP_ID=your-evotor-app-id
EVOTOR_WEBHOOK_SECRET=your-webhook-secret

# Для отдельного MySQL-контейнера (опционально)
DB_ROOT_PASSWORD=rootpass
DB_NAME=evosync
DB_USER=evosync
DB_PASSWORD=evosync

3. Запустите сервис:

docker compose up -d

Приложение будет доступно по адресу http://localhost:8080.

При старте контейнер автоматически применяет миграции базы данных (alembic upgrade head).

Переменные окружения

Переменная	Обязательно	По умолчанию	Описание
DATABASE_URL	Да	—	MySQL connection string (pymysql)
SECRET_KEY	Да	change-me-in-production	Ключ для подписи сессий
BASE_URL	Да	http://localhost:8080	Публичный URL (для OAuth-callback)
EVOTOR_APP_ID	Да	—	ID приложения Эвотор
EVOTOR_WEBHOOK_SECRET	Да	—	Секрет для верификации вебхуков Эвотор
VK_API_VERSION	Нет	5.131	Версия VK API
VK_DEFAULT_PHOTO_PATH	Нет	/app/default_product.png	Путь к изображению товара по умолчанию
JIVOSITE_WIDGET_ID	Нет	—	ID виджета Jivosite (онлайн-чат)
SYNC_INTERVAL_SECONDS	Нет	3600	Интервал синхронизации (сек)
CATALOG_REFRESH_INTERVAL_SECONDS	Нет	3600	Интервал обновления каталога (сек)
HEALTH_CHECK_INTERVAL_SECONDS	Нет	600	Интервал проверки соединений (сек)

Структура проекта

evo-sync/
├── web/
│   ├── main.py              # FastAPI-приложение, регистрация роутеров, фоновые задачи
│   ├── config.py            # Настройки из переменных окружения (pydantic-settings)
│   ├── models.py            # SQLAlchemy-модели (User, EvotorConnection, VkConnection, ...)
│   ├── database.py          # Движок и сессия SQLAlchemy
│   ├── auth.py              # Хеширование паролей, работа с сессиями
│   ├── schemas.py           # Pydantic-схемы для форм
│   ├── sync_engine.py       # Фоновый движок синхронизации (Эвотор → ВК)
│   ├── routes/
│   │   ├── auth.py          # Регистрация, вход, выход, подтверждение email
│   │   ├── profile.py       # Профиль пользователя
│   │   ├── reset.py         # Сброс пароля
│   │   ├── evotor.py        # OAuth-подключение Эвотор
│   │   ├── vk.py            # Подключение ВКонтакте (ввод токена)
│   │   ├── connections.py   # Обзор всех подключений
│   │   ├── sync.py          # Настройка и управление синхронизацией
│   │   └── catalog.py       # Просмотр закешированного каталога
│   ├── templates/           # Jinja2-шаблоны (русский интерфейс)
│   └── migrations/          # Alembic-миграции
├── Dockerfile.web           # Docker-образ веб-приложения (Python 3.12-slim)
├── docker-compose.yml       # Оркестрация сервисов
├── docker-entrypoint.sh     # Скрипт запуска контейнера
├── alembic.ini              # Конфигурация миграций
├── requirements.txt         # Python-зависимости
└── .env.example             # Шаблон переменных окружения

Модели базы данных

Модель	Таблица	Назначение
User	users	Аккаунт пользователя
EvotorConnection	evotor_connections	OAuth-токен Эвотор
VkConnection	vk_connections	Токен сообщества ВКонтакте
SyncConfig	sync_configs	Настройки синхронизации пользователя
SyncFilter	sync_filters	Фильтры по магазинам/группам/товарам
CachedStore	cached_stores	Кеш магазинов Эвотор
CachedGroup	cached_groups	Кеш групп товаров Эвотор
CachedProduct	cached_products	Кеш товаров Эвотор + статус синхронизации

Как работает синхронизация

1. По расписанию (каждые SYNC_INTERVAL_SECONDS секунд) запускается sync_engine.run_sync()
2. Для каждого пользователя с активным SyncConfig и подключёнными Эвотор и ВК:
   • Загружаются товары и группы из Эвотор API
   • Применяются фильтры (включить/исключить магазины, группы, товары)
   • Загружаются текущие товары и альбомы из ВК
   • Создаются/обновляются/удаляются альбомы и товары в ВК-магазине
   • В БД обновляется поле synced_at у синхронизированных товаров

Особенности:

• Товары на развес (единицы измерения в граммах) получают скорректированную цену (×10)
• Совпадение товаров ВК и Эвотор происходит по нормализованному названию
• Товары с allow_to_sell=false не синхронизируются в ВК

Разработка

Для локальной разработки с горячей перезагрузкой кода папка ./web монтируется в контейнер как volume. После изменения Python-файлов uvicorn перезапустится автоматически.

Создание новой миграции:

docker compose exec web alembic revision --autogenerate -m "описание изменений"

Применение миграций вручную:

docker compose exec web alembic upgrade head