Aplikacja desktopowa w Pythonie do automatyzacji publikacji ogłoszeń na Bazoš.sk

Specyfikacja techniczna dla pierwszego etapu / MVP

Projekt: Aplikacja desktopowa w Pythonie do automatyzacji publikacji ogłoszeń na Bazoš.sk
Technologie: Python, Playwright, PySide/PyQt, SQLite/PostgreSQL, import/eksport Excela
Koszt pierwszego etapu: 30 000 UAH
Termin realizacji: 10–14 dni roboczych po dostarczeniu kont testowych, proxy i przykładów produktów.

---

### 1. Cel pierwszego etapu

Opracowanie minimalnej wersji roboczej aplikacji desktopowej na Windows, która umożliwi:

— importowanie produktów z Excela;
— pracę z wieloma kontami Bazoš;
— przypisanie do każdego konta osobnego proxy;
— używanie osobnego profilu Playwright dla każdego konta;
— logowanie się do konta Bazoš.sk;
— publikowanie ogłoszeń na Bazoš.sk w jednej kategorii — „laptopy”;
— ładowanie zdjęć z lokalnych folderów;
— zapisywanie linku do opublikowanego ogłoszenia;
— wyświetlanie podstawowych statusów i błędów w interfejsie.

Pierwsze MVP jest potrzebne do sprawdzenia pełnego podstawowego cyklu:
Excel → produkt → konto/proxy/profil → publikacja na Bazoš.sk → zdjęcie → link → status.

---

### 2. Co wchodzi w pierwszy MVP

#### 2.1 Aplikacja desktopowa na Windows

Opracowanie prostej aplikacji desktopowej z GUI:

— uruchamianie aplikacji na Windows;
— prosty interfejs bez skomplikowanej analityki;
— podstawowe sekcje: produkty, konta, kolejka/proces, błędy/logi;
— przyciski uruchamiania/zatrzymywania podstawowego procesu;
— wyświetlanie aktualnego statusu przetwarzania.

---

#### 2.2 Import Excela

Realizacja szablonu Excela dla produktów.

Orientacyjne pola:

— nazwa produktu;
— opis;
— cena;
— miasto/region;
— telefon/kontakt;
— kategoria;
— ścieżka do folderu ze zdjęciami;
— konto do publikacji;
— status;
— link do opublikowanego ogłoszenia;
— komentarz/błąd.

Programista dostarcza podstawowy szablon Excela. Po uzgodnieniu jest on używany do importu produktów do aplikacji.

---

#### 2.3 Praca ze zdjęciami

— dla każdego produktu używana jest osobna lokalna folder ze zdjęciami;
— aplikacja pobiera zdjęcia z podanej ścieżki;
— zdjęcia są ładowane podczas tworzenia ogłoszenia na Bazoš.sk.

---

#### 2.4 Konta, proxy i profile

W pierwszym MVP realizowane jest:

— dodawanie kilku kont Bazoš;
— przechowywanie danych kont w lokalnej bazie;
— przypisanie proxy do konta;
— schemat: 1 konto = 1 proxy = 1 osobny profil Playwright;
— osobna sesja przeglądarki dla każdego konta.

---

#### 2.5 Publikacja ogłoszeń na Bazoš.sk

W ramach pierwszego MVP realizowana jest publikacja:

— tylko na Bazoš.sk;
— tylko w jednej kategorii — „laptopy”;
— z wypełnieniem podstawowych pól ogłoszenia;
— z ładowaniem zdjęć;
— z zapisywaniem linku do opublikowanego ogłoszenia;
— z aktualizacją statusu produktu w aplikacji.

---

#### 2.6 Statusy i logowanie

W MVP będą podstawowe statusy:

— oczekujące;
— w trakcie;
— opublikowane;
— błąd.

Będzie również podstawowe logowanie:

— udana publikacja;
— błąd logowania;
— błąd proxy;
— błąd publikacji;
— błąd ładowania zdjęć;
— sytuacja, w której wymagane jest ręczne działanie.

---

#### 2.7 Ręczna pauza przy potwierdzeniu SMS

Jeśli Bazoš prosi o ponowną weryfikację SMS konta:

— aplikacja nie próbuje obejść potwierdzenia;
— proces dla tego konta jest wstrzymywany;
— użytkownik ręcznie przechodzi przez potwierdzenie;
— po tym można kontynuować pracę.

---

#### 2.8 Architektura pod Bazoš.sk i Bazoš.cz

W pierwszym MVP pełna publikacja realizowana jest tylko dla Bazoš.sk, ale architektura jest od razu przygotowana do dalszego rozszerzenia na Bazoš.cz.

To znaczy:

— główna logika aplikacji jest oddzielona od logiki konkretnej strony;
— selektory, URL, kategorie i pola są przenoszone do oddzielnej warstwy;
— Bazoš.cz w przyszłości można będzie dodać jako oddzielny moduł bez przepisywania rdzenia aplikacji.

---

### 3. Co nie wchodzi w pierwszy MVP

W pierwszy etap nie wchodzi:

— pełne wsparcie dla Bazoš.cz;
— publikacja w kilku kategoriach;
— automatyczna republika/wyciąganie ogłoszeń;
— ustawienie interwału rotacji 1–7 dni;
— logika sold/delete;
— kontrola limitu 50 aktywnych ogłoszeń na konto.

Dodatkowo ustalamy dla pierwszego etapu:

— zapisywanie profilu/sesji przeglądarki: aplikacja powinna zapisywać profile Playwright między restarami Windows i samej aplikacji, aby nie wykonywać logowania za każdym razem, jeśli sesja na Bazoš pozostaje aktywna;

— zapisywanie linków: linki do opublikowanych ogłoszeń są zapisywane lokalnie w bazie i pozostają dostępne po restarcie aplikacji;

— kolejka nie traci produktów przy błędzie: jeśli publikacja zakończyła się błędem, produkt otrzymuje status błąd, błąd jest zapisywany w logu, ale sam produkt nie jest usuwany i może być ponownie uruchomiony;

— ręczny wybór konta: w Excelu/interfejsie przewidziana jest możliwość wskazania konta, z którego należy publikować konkretne produkty;

— wstrzymanie/wznawianie kolejki: podstawowa możliwość zatrzymania i wznowienia przetwarzania bez utraty aktualnego stanu wchodzi w MVP;

— przenośność projektu: aplikacja, baza, profile i konfiguracje nie powinny być sztywno związane z moim komputerem, serwerem lub użytkownikiem Windows. Projekt powinien być przenośny przy poprawnym przeniesieniu folderu aplikacji/bazy/profili i skonfigurowaniu środowiska;

— przekazanie materiałów: po zakończeniu etapu przekazywane są .exe, kod źródłowy, repozytorium/archiwum projektu, szablon Excela, README i instrukcja uruchomienia/budowy;

— okres naprawy błędów: po oddaniu MVP przewidziany jest krótki okres na naprawę błędów i niedociągnięć, które dotyczą właśnie uzgodnionej specyfikacji pierwszego etapu. Nie nowe funkcje, a właśnie poprawki w ramach MVP.

Wynik pierwszego etapu: działająca aplikacja Windows z GUI, importem Excela, wieloma kontami/proxy, osobnymi profilami Playwright, publikacją na Bazoš.sk w kategorii „laptopy”, ładowaniem zdjęć, zapisywaniem linków, podstawowymi statusami, logami, ręczną pauzą przy potwierdzeniu SMS i architekturą pod dalsze rozszerzenie na Bazoš.cz.