Pierwsze kroki¶

Ten dokument prowadzi Cię przez pierwsze logowanie do panelu, opisuje wszystkie pozycje menu po lewej stronie oraz tłumaczy terminologię, którą zobaczysz w interfejsie. Czytaj go raz — kiedy dostajesz dostęp do systemu po raz pierwszy. Później wracaj punktowo do sekcji Słowniczek gdy spotkasz nieznane pojęcie.

Krótko

Adres panelu: panel.aiofactory.pl
Logujesz się emailem i hasłem (oba dostarczone osobno — w Bitwardenie pod panel-aio / login-operator).
Po zalogowaniu menu po lewej stronie podzielone jest na 4 grupy: Start, Automatyzacje, Marketplace, Infrastruktura.

Pierwsze logowanie¶

1. Wejście na stronę¶

Otwórz w przeglądarce adres panel.aiofactory.pl. Strona przekieruje Cię na ekran logowania, jeśli nie masz aktywnej sesji.

Zobaczysz formularz z dwoma polami:

Email — adres służbowy, na który dostałeś zaproszenie. Domyślnie kończy się na @aiofactory.pl lub @buyspace.pl.
Hasło — pierwsze tymczasowe hasło dostarczone osobno (Bitwarden, folder panel-aio).

Wpisz dane i kliknij Zaloguj się. Jeżeli logowanie się nie powiedzie, panel pokaże komunikat „Logowanie nie powiodło się" — sprawdź wielkie/małe litery i spację na końcu hasła.

Dostęp z zewnątrz biura

Panel jest publiczny — działa z dowolnej sieci, nie potrzebujesz VPN-u. Jeśli jednak chcesz dostać się do wewnętrznych narzędzi administracyjnych (Beszel, Backrest, Forgejo), zainstaluj klienta Netbird — szczegóły w Inwentarzu Usług.

2. Zmiana hasła¶

Tymczasowe hasło zmień w pierwszym dniu pracy. Procedura zmiany jest jednorazowa:

Otwórz w nowej karcie webmail SOGo: mail.aiofactory.pl/SOGo/.
Zaloguj się tym samym emailem i hasłem co w panelu (konta są wspólne).
W górnym prawym rogu kliknij ikonkę użytkownika → Preferencje → Hasło.
Wprowadź stare i nowe hasło (min. 12 znaków, mieszanka liter/cyfr/symboli) → Zapisz.
Wróć do panelu, kliknij Wyloguj (na samym dole menu po lewej) i zaloguj się nowym hasłem.

Hasło panelu = hasło poczty

Konta operatora w panelu i konta pocztowe Mailcow to ten sam zasób. Zmieniając hasło w SOGo, zmieniasz też hasło logowania do panel.aiofactory.pl. Nie istnieje osobny formularz „zmień hasło panelu" — celowo, by nie utrzymywać dwóch oddzielnych haseł.

3. Pierwszy widok — strona Start¶

Po zalogowaniu trafisz na stronę Start (panel.aiofactory.pl/). Zobaczysz:

Powitanie (np. „Dzień dobry, Imię.") — pora dnia rozpoznawana automatycznie.
Kafelki skrótów pogrupowane w 3 sekcje (Automatyzacje, Marketplace, Infrastruktura) — każdy kafelek to skrót do najczęściej używanych modułów.

Strona Start jest edytowalnym pulpitem startowym — punkt wejścia. Pełną nawigację znajdziesz po lewej stronie w pasku bocznym (sidebar).

4. Wylogowanie¶

Przycisk Wyloguj jest na samym dole paska bocznego (ikona drzwi z strzałką). Kliknięcie kończy sesję natychmiast — następne wejście na panel.aiofactory.pl znów pokaże ekran logowania.

Sesja wygasa po 30 dniach bezczynności

Domyślny czas życia ciasteczka sesji to 30 dni. Po tym okresie panel poprosi o ponowne logowanie nawet jeśli nie wylogowałeś się ręcznie.

Pasek boczny po lewej stronie panelu jest podzielony na 4 grupy (każda z własnym nagłówkiem). Poniżej każda pozycja menu z jednolinijkowym opisem i odsyłaczem do pełnej dokumentacji w tym serwisie.

Grupa: Start¶

Punkt wejścia, niezależny od marketplace'ów i automatyzacji.

Pozycja	Co robi	Pełna dokumentacja
Start	Pulpit startowy z kafelkami skrótów; powitanie	(ten dokument)
Roadmap	Tabelaryczny stan realizacji oferty z 13.01.2026 — co zostało zrobione, co odroczone	Roadmap — stan realizacji
Ważne kontakty	Lista osób kluczowych dla projektu (właściciel, dostawcy zewnętrzni, wsparcie)	— (strona wewnętrzna panelu)

Grupa: Automatyzacje¶

Narzędzia operatorskie napędzane silnikiem automatyzacji w tle. Każde to osobny moduł zbudowany pod konkretny proces firmowy.

Pozycja	Co robi	Pełna dokumentacja
Tekstylia	Zamówienia tkanin, katalog producentów, generowanie listy zakupowej	Automatyzacje
Imiona psów	Generator etykiet z imionami psów (do naklejek na produkty)	Pupprint — Naklejki z imionami psów
Podaj kolor	Lista zamówień Allegro w stanie „podaj kolor" — pomoc operatora w wyborze koloru z wątku	Zgłoszenia #22, #23 — Imiona i Kolory
Kampania mailowa	Wysyłka newsletterów i kampanii mailowych (przez Listmonk)	Poczta — Listmonk
Social	Planowanie i publikacja postów Social Media (FB / IG / LinkedIn / TikTok / X) — przez Postiz	Postiz (Social Media)

Grupa: Marketplace¶

Wszystko związane ze sprzedażą na platformach: konfiguracja, katalog produktów, wystawianie ofert, obsługa klienta.

Pozycja	Co robi	Pełna dokumentacja
Konfiguracja	Ustawienia platform (Allegro, Amazon, eBay, Erli, Joom, Temu) i kont email do obsługi klienta	Oferty i Listingi
Katalog	Spis produktów zsynchronizowanych z BaseLinkerem (źródło prawdy o asortymencie)	Oferty i Listingi
Oferty	Wystawianie produktów na 7 platformach z poziomu jednego widoku	Oferty i Listingi
Obsługa klienta	Centralna skrzynka zgłoszeń ze wszystkich platform i email — z scenariuszami CS	Obsługa Klienta

Historia marketplace — dostępna z poziomu logów

Sekcja Historia (logi synchronizacji, przebiegi scenariuszy, kolejka błędów DLQ, otwarte zgłoszenia w Forgejo) nie ma swojej pozycji w pasku bocznym — jest dostępna z każdej strony Marketplace przez przycisk „Historia" w nagłówku albo bezpośrednio pod adresem panel.aiofactory.pl/marketplace/history.

Grupa: Infrastruktura¶

Status techniczny systemu — szybki podgląd usług, logi i (dla administratora) zarządzanie kontami.

Pozycja	Co robi	Pełna dokumentacja
Usługi	Szybkie linki do wewnętrznych narzędzi (Postiz, Listmonk, Backrest, Beszel, Forgejo, Mailcow)	Inwentarz Usług
Logi	Przebiegi automatyzacji + zgłoszenia z Forgejo otwierane bezpośrednio z błędów	Monitoring i Backupy
Użytkownicy (tylko admin)	Dodawanie / usuwanie kont pracowników, nadawanie ról	— (strona wewnętrzna panelu)

Pozycja „Użytkownicy" widoczna tylko dla superadministratora

Konta zwykłych operatorów nie zobaczą tej pozycji w menu — interfejs sam ją ukrywa. Jeśli potrzebujesz dodać nowego pracownika, poproś właściciela.

Stopka paska bocznego¶

Pozycja	Co robi
Wyloguj	Kończy sesję i przekierowuje na ekran logowania

Słowniczek¶

Terminy, które zobaczysz w interfejsie panelu — w prostym języku.

Automatyzacja: Zadanie wykonywane przez panel bez Twojego udziału w tle (np. co godzinę pobiera nowe wiadomości z Allegro). Niektóre automatyzacje uruchamiasz ręcznie przyciskiem (np. „Wystaw ofertę"), inne chodzą cyklicznie. Wszystkie automatyzacje napędza ten sam silnik w tle — nie musisz wiedzieć który.
Scenariusz: Konkretna sekwencja kroków, którą panel wykonuje w odpowiedzi na zdarzenie — np. „gdy klient napisze wiadomość zawierającą słowo «paragon», utwórz zgłoszenie w grupie Faktury". Scenariusze CS edytujesz w module Obsługa Klienta w zakładce Scenariusze — wizualnym edytorem przeciągania bloczków.
Rodzina (TAG): Grupa produktów dzielących wspólny szablon oferty (zdjęcia, tytuł bazowy, opis, ceny). Przykład: jeden TAG „Bluza Husky" zawiera 24 warianty rozmiar/kolor — wystawiając rodzinę, panel tworzy 24 oferty na każdej platformie. Pojęcie TAG używane wymiennie z Rodzina.
Wariant: Pojedyncza pozycja w rodzinie — konkretny rozmiar i kolor. Każdy wariant ma swój SKU (kod produktu) i własny stan magazynowy w BaseLinkerze.
Katalog produktów: Lista wszystkich produktów aktualnie utrzymywanych w systemie — synchronizowana cyklicznie z BaseLinkera. To źródło prawdy o tym, co masz na stanie. Panel sam nie zarządza magazynem — tylko go odczytuje z BaseLinkera.
Wystawienie (oferta, listing): Pojedyncza oferta produktu na konkretnej platformie. Przykład: ten sam produkt może mieć 7 wystawień (Allegro PL + Amazon DE + eBay UK + …). Każde wystawienie ma własny status na danej platformie (aktywne / zakończone / odrzucone).
Synchronizacja: Proces, w którym panel dogania zmianami zewnętrzny system (BaseLinker, Allegro, Mailcow) — pobiera nowe dane lub wysyła zmiany. Przykład: synchronizacja katalogu BaseLinker oznacza, że panel pobiera świeżą listę produktów. Synchronizacja może być automatyczna (cykliczna w tle) lub ręczna (klikasz przycisk „Synchronizuj teraz").
Marketplace (platforma sprzedażowa): Zewnętrzny serwis, na którym sprzedajesz: Allegro, Amazon, eBay, Erli, Joom, Temu, WooCommerce (Twój sklep buyspace.pl). Panel zarządza wszystkimi z poziomu jednego interfejsu — nie musisz logować się osobno do każdej platformy.
BaseLinker: Zewnętrzny system magazynowy + integrator zamówień, używany przez właściciela od lat. Pełni rolę źródła prawdy dla katalogu produktów i stanów magazynowych. Panel czyta z BaseLinkera (synchronizacja katalogu) i zapisuje do BaseLinkera (zamówienia z platform). Nie zastępujemy BaseLinkera — współpracujemy z nim.
Subiekt (Subiekt Nexo / GT): Program księgowo-magazynowy InsERT, który właściciel używa do ostatecznego rozliczenia zamówień (faktury, dokumenty WZ). BaseLinker integruje się z Subiektem — panel nie integruje się bezpośrednio (decyzja w ofercie z 13.01.2026, str. 4).
Posejdon: Wewnętrzna nazwa mostu Subiekt → BaseLinker — programu w tle, który automatycznie eksportuje dane z Subiekta do BaseLinkera. Szczegóły: Sklepy — Posejdon.
Obsługa Klienta (CS — Customer Service): Moduł panelu, który zbiera wiadomości ze wszystkich platform i email w jednym widoku zgłoszeń. Operator odpowiada bez przełączania się między systemami. Patrz Obsługa Klienta.
Zgłoszenie (issue, ticket): Pojedyncza sprawa od klienta — może to być wiadomość z Allegro, email z reklamacją, pytanie z eBay. Każde zgłoszenie ma status (Nowe / W toku / Zamknięte), opiekuna i historię odpowiedzi.
Logi / Przebiegi: Zapis działania automatyzacji — co zrobiła, kiedy, czy się udało, jaki był błąd. Logi przeglądasz w Infrastruktura → Logi. Każdy przebieg automatyzacji ma swój wpis.
Kolejka błędów (DLQ — Dead-Letter Queue): Lista automatyzacji, które się nie udały i wymagają interwencji. Panel próbuje sam ponowić — jeśli kilka razy się nie uda, sprawa trafia do DLQ. Przeglądasz pod panel.aiofactory.pl/marketplace/history/dlq.
Forgejo: Wewnętrzny system zgłaszania błędów i propozycji — dostępny pod git.aiofactory.pl. Tam zgłaszasz nowe pomysły lub bugi do wykonawcy w fazie utrzymania (maj–sierpień 2026). Przeglądasz też status istniejących zgłoszeń.
Mailcow: System poczty firmowej (mail.aiofactory.pl). Korzystasz z niego przez webmail SOGo lub przez program pocztowy (Outlook, Thunderbird) — IMAP/SMTP. Patrz Poczta.
Listmonk: Narzędzie do wysyłki mailingu masowego (newslettery, kampanie do klientów). Otwierasz go z modułu Automatyzacje → Kampania mailowa w panelu albo bezpośrednio na listmonk.aiofactory.pl.
Postiz: Narzędzie do planowania postów Social Media (FB / IG / LinkedIn / TikTok / X). Otwierasz z modułu Automatyzacje → Social lub bezpośrednio na postiz.aiofactory.pl.
Bramka SMS (TextBee): Wysyłka wiadomości SMS przez fizyczną kartę SIM — używana przez panel do np. powiadomień o zamówieniu. Wymaga włożenia karty SIM Play do modemu USB podłączonego do serwera. Patrz Poczta — bramka SMS.
Beszel: System monitoringu zdrowia serwerów (CPU / RAM / dysk / czas pracy). Otwierasz pod beszel.aiofactory.pl. Daje sygnał gdy coś się psuje.
Backrest: Interfejs zarządzania backupami (kopiami zapasowymi). Pokazuje co się ostatnio zbackupowało, czy backupy są aktualne, daje przywracanie z konkretnej daty. Adres: backrest.aiofactory.pl. Patrz Monitoring.
Netbird: Sieć VPN administracyjna — instalujesz klienta na laptopie i dostajesz dostęp do narzędzi wewnętrznych (Beszel, Backrest, Forgejo) tak jakbyś był w biurze. Adres serwera: netbird.aiofactory.pl.
SOPS / age: Mechanizm szyfrowania sekretów (haseł, kluczy API) w repozytorium kodu. Klucz age to plik, którym odszyfrowujesz sekrety; trzymaj go bezpiecznie w Bitwardenie pod panel-aio / sops-age-key. Bez tego klucza odzyskanie haseł jest niemożliwe — patrz Inwentarz Usług — Sekrety.
Bitwarden: Magazyn haseł firmowy (cloud, poza naszą infrastrukturą). Wszystkie hasła administracyjne, klucze API platform i klucz age znajdziesz w folderze panel-aio.
Konfiguracja → Konta e-mail: Sekcja w Marketplace → Konfiguracja, gdzie podpinasz skrzynki Mailcow lub Gmail do modułu Obsługi Klienta. Każde konto raz skonfigurowane → wiadomości z niego wpadają jako zgłoszenia.
Superadmin / operator / pracownik: Trzy poziomy uprawnień. Superadmin widzi wszystko i zarządza użytkownikami. Operator ma dostęp do wszystkich modułów oprócz zarządzania kontami. Pracownik to zwykły użytkownik z ograniczonym widokiem (tylko zgłoszenia jemu przypisane).

Co dalej¶

Chcesz zrobić	Idź do
Wystawić pierwszy produkt na platformach	Oferty i Listingi → Jak korzystać
Odpowiadać na wiadomości od klientów	Obsługa Klienta → Jak korzystać
Zobaczyć status backupów	Monitoring i Backupy
Zgłosić bug / pomysł	`git.aiofactory.pl` (Forgejo)
Sprawdzić co już działa, a co odroczone	Roadmap — stan realizacji
Zobaczyć pełny zakres umowy	Podsumowanie Prac

Brakuje czegoś w tej dokumentacji?

Jeśli spotkasz w panelu termin lub przycisk, którego nie rozumiesz — zgłoś to w Forgejo z etykietą „dokumentacja". Słowniczek powyżej będzie rozszerzany.