55 lines
3.8 KiB
Markdown
55 lines
3.8 KiB
Markdown
# AutoMarket (OzonGuard)
|
||
|
||
**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**
|
||
|
||
## Основной функционал
|
||
|
||
- **Настройки Интеграций:** Единый интерфейс для ввода и хранения API ключей всех 10 площадок. Больше не нужно копаться в .env файлах.
|
||
- **Управление кейсами (жалобами):** Создание универсальных жалоб (кейсов) с указанием маркетплейса, ссылок на карточку нарушителя и его артикула.
|
||
- **Прикрепление доказательств:** Загрузка изображений и PDF в качестве доказательной базы.
|
||
- **Статусы кейсов:** Отслеживание статусов: *Новый*, *Подготовлен*, *Отправлен*, *Закрыт*.
|
||
- **Умный поиск:** Поиск по артикулу и фильтрация по площадке или статусу.
|
||
|
||
## Технологический стек
|
||
|
||
- **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`).
|
||
3. Выполните скрипт инициализации из корневой директории:
|
||
```bash
|
||
bash init.sh
|
||
```
|
||
|
||
**Что делает скрипт `init.sh`:**
|
||
- Проверяет наличие Python 3 и создает виртуальное окружение `venv`.
|
||
- Устанавливает Python-зависимости из файла `backend/requirements.txt`.
|
||
- Инициализирует базу данных с помощью файла `db/init.sql` (если настроен `.env`).
|
||
- Запускает локальный Flask-сервер на порту `5000`.
|
||
|
||
## Структура репозитория
|
||
|
||
- `/frontend/` — статические файлы пользовательского интерфейса (страницы, стили, логика на JS).
|
||
- `/backend/` — серверная часть на Flask (точка входа `app.py`, обработка маршрутов API в `routes/`).
|
||
- `/db/` — SQL-скрипты для инициализации таблиц базы данных.
|
||
- `init.sh` — стартовый скрипт для быстрого развертывания проекта.
|