feat: implement backend API clients for multi-marketplace integration and frontend service layer

This commit is contained in:
2026-05-12 13:16:14 +03:00
parent 6974af486a
commit ee39a3d83b
65 changed files with 2501 additions and 33 deletions

View File

@@ -1,26 +1,40 @@
# OzonGuard (AutoMarket)
# AutoMarket (OzonGuard)
**OzonGuard** — это веб-приложение для быстрой подготовки, управления и отправки жалоб в службу поддержки маркетплейса Ozon на нарушителей (например, на копирование карточек товаров, нарушения интеллектуальной собственности и т.д.).
**AutoMarket** — это универсальное веб-приложение для интеграции, управления и автоматизации процессов сразу на 10 маркетплейсах. Система позволяет хранить ключи API, быстро подготавливать жалобы на нарушителей и гибко расширять функционал.
## Поддерживаемые Маркетплейсы
1. **Ozon**
2. **Wildberries**
3. **Yandex Market**
4. **Magnit Market**
5. **MegaMarket**
6. **AliExpress (AE Platform)**
7. **Avito**
8. **Lamoda**
9. **Lemana PRO (Леруа Мерлен)**
10. **Flowwow**
## Основной функционал
- **Управление кейсами:** Создание новых жалоб (кейсов) с указанием ссылок на карточку нарушителя, его артикула и вашего артикула.
- **Прикрепление доказательств:** Возможность загрузки файлов (изображений и PDF-документов) в качестве доказательной базы.
- **Статусы кейсов:** Отслеживание процесса работы над жалобой по статусам: *Новый*, *Подготовлен*, *Отправлен*, *Закрыт*.
- **Поиск и фильтрация:** Удобный поиск по артикулу или ссылке, а также фильтрация списка по текущему статусу жалобы.
- **Настройки Интеграций:** Единый интерфейс для ввода и хранения API ключей всех 10 площадок. Больше не нужно копаться в .env файлах.
- **Управление кейсами (жалобами):** Создание универсальных жалоб (кейсов) с указанием маркетплейса, ссылок на карточку нарушителя и его артикула.
- **Прикрепление доказательств:** Загрузка изображений и PDF в качестве доказательной базы.
- **Статусы кейсов:** Отслеживание статусов: *Новый*, *Подготовлен*, *Отправлен*, *Закрыт*.
- **Умный поиск:** Поиск по артикулу и фильтрация по площадке или статусу.
## Технологический стек
- **Frontend:** HTML5, CSS3, Vanilla JavaScript (без использования тяжеловесных фреймворков).
- **Backend:** Python 3.9+, Flask, Werkzeug.
- **Frontend:** HTML5, CSS3, Vanilla JavaScript (с красивым дизайном Glassmorphism).
- **Backend:** Python 3.9+, Flask.
- **База данных:** PostgreSQL.
- **SDK:** 10 независимых, отказоустойчивых Python библиотек для каждого маркетплейса (включая автоматические ретраи, OAuth, JWT и Exponential Backoff).
## Установка и запуск (Linux/macOS)
В проекте предусмотрен bash-скрипт `init.sh` для автоматической настройки окружения.
1. Убедитесь, что у вас установлены Python 3.9+ и PostgreSQL (`psql`).
2. При необходимости настройте подключение к БД в файле `backend/.env` (переменная `DATABASE_URL=postgresql://user:password@localhost:5432/dbname`).
2. Настройте подключение к БД в файле `backend/.env` (переменная `DATABASE_URL=postgresql://user:password@localhost:5432/dbname`).
3. Выполните скрипт инициализации из корневой директории:
```bash
bash init.sh