Desktop-приложение на Python для автоматизации публикации объявлений на Bazoš.sk

Техническое задание на первый этап / MVP

Проект: Desktop-приложение на Python для автоматизации публикации объявлений на Bazoš.sk
Технологии: Python, Playwright, PySide/PyQt, SQLite/PostgreSQL, Excel import/export
Стоимость первого этапа: 30 000 грн
Срок выполнения: 10–14 рабочих дней после предоставления тестовых аккаунтов, прокси и примеров товаров.

---

### 1. Цель первого этапа

Разработать минимально рабочую desktop-версию приложения под Windows, которая позволит:

— импортировать товары из Excel;
— работать с несколькими аккаунтами Bazoš;
— привязывать к каждому аккаунту отдельный proxy;
— использовать отдельный Playwright-профиль для каждого аккаунта;
— выполнять вход в аккаунт Bazoš.sk;
— публиковать объявления на Bazoš.sk в одной категории — “ноутбуки”;
— загружать фото из локальных папок;
— сохранять ссылку на опубликованное объявление;
— отображать базовые статусы и ошибки в интерфейсе.

Первый MVP нужен для проверки полного базового цикла:
Excel → товар → аккаунт/proxy/profile → публикация на Bazoš.sk → фото → ссылка → статус.

---

### 2. Что входит в первый MVP

#### 2.1 Desktop-приложение под Windows

Разработка простого desktop-приложения с GUI:

— запуск приложения на Windows;
— простой интерфейс без сложной аналитики;
— базовые разделы: товары, аккаунты, очередь/процесс, ошибки/логи;
— кнопки запуска/остановки базового процесса;
— отображение текущего статуса обработки.

---

#### 2.2 Excel-импорт

Реализация Excel-шаблона для товаров.

Ориентировочные поля:

— название товара;
— описание;
— цена;
— город/регион;
— телефон/контакт;
— категория;
— путь к папке с фото;
— аккаунт для публикации;
— статус;
— ссылка на опубликованное объявление;
— комментарий/ошибка.

Разработчик предоставляет базовый Excel-шаблон. После согласования он используется для импорта товаров в приложение.

---

#### 2.3 Работа с фото

— для каждого товара используется отдельная локальная папка с фото;
— приложение берёт фото из указанного пути;
— фото загружаются при создании объявления на Bazoš.sk.

---

#### 2.4 Аккаунты, proxy и профили

В первом MVP реализуется:

— добавление нескольких аккаунтов Bazoš;
— хранение данных аккаунтов в локальной базе;
— привязка proxy к аккаунту;
— схема: 1 аккаунт = 1 proxy = 1 отдельный Playwright-профиль;
— отдельная браузерная сессия для каждого аккаунта.

---

#### 2.5 Публикация объявлений на Bazoš.sk

В рамках первого MVP реализуется публикация:

— только на Bazoš.sk;
— только в одной категории — “ноутбуки”;
— с заполнением основных полей объявления;
— с загрузкой фото;
— с сохранением ссылки на опубликованное объявление;
— с обновлением статуса товара в приложении.

---

#### 2.6 Статусы и логирование

В MVP будут базовые статусы:

— pending;
— in_progress;
— published;
— error.

Также будет базовое логирование:

— успешная публикация;
— ошибка входа;
— ошибка proxy;
— ошибка публикации;
— ошибка загрузки фото;
— ситуация, когда требуется ручное действие.

---

#### 2.7 Ручная пауза при SMS-подтверждении

Если Bazoš просит повторную SMS-верификацию аккаунта:

— приложение не пытается обходить подтверждение;
— процесс по этому аккаунту ставится на паузу;
— пользователь вручную проходит подтверждение;
— после этого работу можно продолжить.

---

#### 2.8 Архитектура под Bazoš.sk и Bazoš.cz

В первом MVP полноценная публикация делается только для Bazoš.sk, но архитектура сразу закладывается под дальнейшее расширение на Bazoš.cz.

То есть:

— основная логика приложения отделяется от логики конкретного сайта;
— селекторы, URL, категории и поля выносятся в отдельный слой;
— Bazoš.cz в дальнейшем можно будет добавить отдельным модулем без переписывания ядра приложения.

---

### 3. Что не входит в первый MVP

В первый этап не входит:

— полноценная поддержка Bazoš.cz;
— публикация в нескольких категориях;
— автоматическая перепубликация/поднятие объявлений;
— настройка интервала ротации 1–7 дней;
— sold/delete-логика;
— контроль лимита 50 активных объявлений на аккаунт;

Дополнительно фиксируем по первому этапу:

— сохранение browser profile/session: приложение должно сохранять Playwright-профили между перезапусками Windows и самого приложения, чтобы не выполнять логин заново каждый раз, если сессия на Bazoš остаётся активной;

— сохранение ссылок: ссылки на опубликованные объявления сохраняются локально в базе и остаются доступными после перезапуска приложения;

— очередь не теряет товары при ошибке: если публикация завершилась ошибкой, товар получает статус error, ошибка записывается в лог, но сам товар не удаляется и может быть повторно запущен;

— ручной выбор аккаунта: в Excel/интерфейсе предусматривается возможность указать аккаунт, с которого нужно публиковать конкретный товар;

— остановка/продолжение очереди: базовая возможность остановить и продолжить обработку без потери текущего состояния входит в MVP;

— переносимость проекта: приложение, база, профили и конфиги не должны быть жёстко привязаны к моему ПК, серверу или Windows-пользователю. Проект должен быть переносимым при корректном переносе папки приложения/базы/профилей и настройке окружения;

— передача материалов: после завершения этапа передаются .exe, исходный код, репозиторий/архив проекта, Excel-шаблон, README и инструкция по запуску/сборке;

— период исправления багов: после сдачи MVP предусматривается короткий период на исправление багов и недочётов, которые относятся именно к согласованному ТЗ первого этапа. Не новые функции, а именно исправления в рамках MVP.

Результат первого этапа: рабочее Windows-приложение с GUI, Excel-импортом, несколькими аккаунтами/proxy, отдельными Playwright-профилями, публикацией на Bazoš.sk в категории “ноутбуки”, загрузкой фото, сохранением ссылок, базовыми статусами, логами, ручной паузой при SMS-подтверждении и архитектурой под дальнейшее расширение на Bazoš.cz.