🚀 Pomocnik Allegro

🌍 Ustawienia Aplikacji

Zmiana numeru wersji aktualizuje datę w stopce.
Zależy od konfiguracji zadania CRON.
Oddzielone przecinkiem, ignorowane w alertach.
Oddzielone przecinkiem, decyduje o kolejności wyświetlania.

🛠️ Narzędzia Deweloperskie

Generuje kompletny plik code_snapshot.txt do celów diagnostycznych w głównym katalogu aplikacji.

Usuwa wszystkie aktywne alerty z bazy danych i resetuje historię wysłanych powiadomień. Użyj tego narzędzia, gdy chcesz "zacząć od nowa" po rozwiązaniu problemów.

Pobiera numery listów przewozowych z API Allegro (pickupy i waybills) i aktualizuje je w bazie danych zamówień. Proces automatycznie mapuje przesyłki na zamówienia i wypełnia puste pola tracking_number.

📊 Kategorie i Progi Alertów

🔌 Połączenia i Integracje

+ Dodaj lub odśwież
konto Allegro

🔔 Powiadomienia

✉️ E-mail (SMTP)

Konfiguracja serwera SMTP (host, port, użytkownik, hasło) jest zarządzana w pliku .env na serwerze.

🚀 OneSignal Push

Klucze OneSignal (App ID, API Key) są zarządzane w pliku .env na serwerze.

ℹ️ Informacje o Systemie

Poniżej znajduje się opis kluczowych, zautomatyzowanych procesów działających w tle. Użyj go jako punktu odniesienia do zrozumienia, jak aplikacja zarządza Twoimi ofertami i zamówieniami.

🤖 Główne procesy w tle (CRON)
📡 Dyspozytor Skanowania (`app:scan`)
Harmonogram:Co 10 minut.
Akcja:Sprawdza, które konta mają włączone skanowanie i zleca dla każdego z nich osobne zadanie (`scan-account`) do wykonania w tle. Na końcu zleca zadanie wysłania zbiorczego powiadomienia (`send-notifications`).
Status:Nieaktywny
⚙️ Proces Roboczy Kolejki (`app:queue:work`)
Harmonogram:Co minutę.
Akcja:Pobiera i wykonuje zadania zlecone przez inne procesy (np. skanowanie, wysyłka powiadomień, synchronizacja Sky-Shop). Jest to główny "silnik" wykonawczy aplikacji.
Status:Nieaktywny
📦 Automatyzacja Zamówień (`app:orders:process`)
Harmonogram:Co 5 minut.
Akcja:Uruchamia logikę automatyzacji dla zamówień Sky-Shop o statusie "Zatrzymane". Szczegóły poniżej.
Status:Nieaktywny
📝 Automatyczna Aktualizacja Treści (`app:content:update`)
Harmonogram:O 04:15 w każdy poniedziałek, środę i piątek.
Akcja:Znajduje wszystkie oferty z aktywną regułą automatyzacji treści i podmienia w nich dynamiczne tagi (np. `{{AKTUALNA_CENA}}`) na aktualne wartości, po czym zapisuje zmiany na Allegro.
Status:Ostrzeżenie
🛡️ Automatyzacje Ofert i Zamówień
Automatyzacja Zamówień Sky-Shop
Wyzwalacz:Zadanie CRON `app:orders:process` (co 5 min).
Cel:Zamówienia w Sky-Shop o statusie "Zatrzymane".
Akcje (Bezwzględne):
Zawsze: Scalanie zduplikowanych produktów w jednym zamówieniu. Zawsze: Jeśli zamówienie jest z `Polskie-CBD_PL` i ma nr przesyłki, status jest zmieniany na "Wysłane".
Akcje (Warunkowe):
Gdy przełącznik WŁĄCZONY: Jeśli zamówienie (nie z `Polskie-CBD_PL`) zawiera "zestaw", status jest zmieniany na "Do zrobienia" i trafia do Arkusza Google. Gdy przełącznik WŁĄCZONY: Jeśli to inne zamówienie (nie z `Polskie-CBD_PL` i nie zestaw), status jest zmieniany na "Oczekuje na realizację".
Automatyczna Obrona (Zmiana EAN)
Wyzwalacz:Wykrycie konkurencji podczas skanowania oferty.
Warunek:Opcja "Automatyczna zmiana EAN" musi być włączona dla danego konta w ustawieniach.
Akcja:System automatycznie zmienia EAN w ofercie na kolejny dostępny z puli zdefiniowanej w Katalogu Produktów, skutecznie "odpinając" ofertę od konkurencji.
Wykrywanie Przepięcia Oferty
Wyzwalacz:Wykrycie podczas skanowania, że `product.id` oferty różni się od ostatnio zapisanego.
Warunek:Zawsze aktywna, jest to mechanizm bezpieczeństwa.
Akcja:System generuje alert krytyczny `product_id_mismatch` i **natychmiast** inicjuje zmianę EAN (jeśli to możliwe), aby "uciec" z błędnie przypisanego produktu.
Masz niezapisane zmiany