FAQ — odpowiedzi na zgłoszenia¶
Każde otwarte zgłoszenie z Forgejo (git.aiofactory.pl/aio/panel/issues) ma w tej sekcji trwałą odpowiedź. Każdy punkt zawiera krótkie podsumowanie + link do pełnego opisu w odpowiedniej sekcji dokumentacji.
Spis zgłoszeń¶
| # | Tytuł | Status | Sekcja |
|---|---|---|---|
| 5 | Brak widocznej odpowiedzi na email | ✅ Naprawione | Obsługa Klienta |
| 6 | Brak widocznych wiadomości wysłanych w panelu | ✅ Naprawione | Obsługa Klienta |
| 7 | Brak weryfikacji hasła SMTP | ✅ Naprawione | Poczta |
| 8 | Dwa cenniki przy wystawianiu (koszt + wysyłka) | ✅ Dostarczone (Allegro 1:1; pozostałe 6 MP w kolejce) | Oferty |
| 9 | Brak filtrowania wątków po opiekunach | ✅ Naprawione | Obsługa Klienta |
| 10 | Załączniki do zgłoszeń — brak widoczności | 🟠 Częściowe (sent-msgs naprawione; full attachments deferred) | Obsługa Klienta |
| 11 | Sprawa N8N | ✅ Zastąpione Windmill | Automatyzacje |
| 12 | Host: son — 20 % | ✅ Wyjaśnione | Serwery |
| 13 | Serwery VPS | ✅ Wyjaśnione | Serwery |
| 14 | Bramka SMS — 100 % | ✅ Dostarczone | Poczta |
| 15 | Serwer Email | ✅ Dostarczone | Poczta |
| 16 | System monitoringu — 100 % | ✅ Dostarczone (Beszel) | Monitoring |
| 17 | Bazy danych pod strony | ✅ Dostarczone | Sklepy |
| 18 | System do zarządzania Social Media | ✅ Dostarczone (Postiz) | Automatyzacje |
| 19 | Baselinker 80 % / Subiekt 30 % | 🟠 Częściowe | Oferty |
| 20 | Amazon — brak na liście | 🟠 Częściowe (PL ✅, inne rynki ❌) | Oferty |
| 21 | System do wysyłania mailingu | ✅ Dostarczone (Listmonk) | Poczta |
| 22 | Automatyzacja wyciągania imion | 🟢 Dostępne (Scenariusze CS) | Automatyzacje |
| 23 | Automatyzacja wyciągania kolorów | 🟢 Dostępne (Scenariusze CS) | Automatyzacje |
| 24 | Moduł Obsługi Klienta — link do platformy | 🟠 Częściowe | Obsługa Klienta |
| 25 | BESZEL — do czego to jest | ✅ Wyjaśnione | Monitoring |
| 26 | Sklepy internetowe — nowe rynki | ⚪ Poza zakresem oferty | Sklepy |
| 27 | Paperless | ⚪ Opcjonalne — nie uruchomione | Monitoring |
| 28 | Oferty — widoczność wystawionych produktów | ✅ Dostarczone | Oferty |
Legenda statusów:
- ✅ Dostarczone / Naprawione — funkcja działa lub błąd naprawiony i wdrożony na produkcji.
- 🟠 Częściowe — główna część zrealizowana; uzupełnienia opisane w odpowiedniej sekcji.
- 🟡 W naprawie — bug zaakceptowany do najbliższego sprintu (bug-fix mode).
- 🟢 W realizacji — uznana funkcja w trakcie kodowania.
- ⚪ Poza zakresem oferty / Opcjonalne — element nieujęty w pierwotnej ofercie z 13 stycznia, lub przygotowany ale nie uruchomiony.
#5 — Brak widocznej odpowiedzi na email¶
✅ Naprawione (TASK-267 + TASK-316.03). Pobieracz IMAP teraz dociąga folder Wysłane obok skrzynki INBOX i scala je w jeden wątek. Lokalizacja Sent zweryfikowana dla polskich Gmaili ([Gmail]/Wysłane) i Mailcow (Wysłane / INBOX/Wysłane); dodatkowo wykrywanie folderu przez SPECIAL-USE \Sent. Wiadomości wychodzące mają w panelu znacznik „My" (niebieskie tło).
→ Pełen opis: Obsługa Klienta — zgłoszenie #5
#6 — Brak widocznych wiadomości wysłanych w panelu¶
✅ Naprawione (TASK-267 + TASK-316.03). Każda odpowiedź wysłana z panelu (Allegro / eBay / email) jest teraz wpisywana do wątku natychmiast po sukcesie API — wątek nie czeka na powtórny pull z platformy.
→ Pełen opis: Obsługa Klienta — zgłoszenie #6
#7 — Brak weryfikacji hasła SMTP¶
✅ Naprawione (TASK-268). Przy dodawaniu skrzynki panel próbuje teraz najpierw zalogować się przez SMTP z podanym hasłem; jeśli serwer odrzuci, formularz pokazuje konkretny błąd (np. „535 5.7.8 Username and Password not accepted") i NIE zapisuje konta w bazie. Walidacja używa tych samych hostów + portów co produkcyjny wysyłacz.
→ Pełen opis: Poczta — zgłoszenie #7
#8 — Dwa cenniki przy wystawianiu¶
✅ Dostarczone — częściowo wszędzie (TASK-269 + TASK-290). Reguła (cennik1 + cennik2) × mnożnik dostępna we wszystkich miejscach panelu, gdzie ustawiasz reguły cenowe (Allegro / eBay / Amazon / Erli / Joom / Temu / WooCommerce). Cennik2 jest opcjonalny ("Brak (×1 cennik)") — jeśli pominiesz, zachowujemy starą regułę cennik1 × mnożnik.
Allegro używa cennika2 1:1 po stronie serwerowej. Pozostałe 6 marketplace'ów odbiera wartość z UI i zapamięta ją na koncie, ale ich flowy serwerowe podpięte sukcesywnie w kolejnych sprintach (do tego czasu listują po starym cennik1 × wsp.).
→ Pełen opis: Oferty — zgłoszenie #8
#9 — Brak filtrowania wątków po opiekunach¶
✅ Naprawione (TASK-267 + TASK-316.04). Filtr „Moje (Imię Nazwisko)" pojawia się w obsłudze klienta i domyślnie pokazuje tylko zgłoszenia przypisane do zalogowanego opiekuna. Auto-przypisywanie naprawione: pobieracz emaili przekazuje account_id do reguł, więc reguły typu „skrzynka X → opiekun Y" działają na nowych zgłoszeniach.
→ Pełen opis: Obsługa Klienta — zgłoszenie #9
#10 — Załączniki do zgłoszeń¶
🟠 Częściowe. Dwie sprawy w jednym zgłoszeniu:
- ✅ Wiadomości wysłane / odebrane widoczne w wątku (TASK-267 + TASK-316.03 — patrz #5/#6).
- 🟡 Full inline rendering załączników (zdjęcia, PDF) — odroczone do bug-fix mode jako TASK-287. Aktualnie wątek pokazuje fakt obecności załącznika i nazwę pliku; pobranie wymaga otwarcia źródła w platformie / mailu.
Komentarz dot. obsługi zgłoszeń: Najlepszy format zgłoszenia w Forgejo: opis problemu + konkretny scenariusz odtworzenia + screen lub link do strony panelu. Logi z Windmilla pomagają tylko gdy zgłoszenie dotyczy automatu („nie wystawiło oferty"); dla błędów UI screen z konkretną akcją wystarczy.
→ Pełen opis: Obsługa Klienta — zgłoszenie #10
#11 — Co z N8N¶
✅ Zastąpione przez Windmill. N8N w trakcie konfiguracji okazał się ograniczeniem dla zaplanowanego zakresu integracji (brak deterministycznego retry dla OAuth, słabe wsparcie typów, problemy z wersjonowaniem flowów w git). Windmill rozwiązuje wszystkie trzy problemy.
Co z możliwością tworzenia własnych scenariuszy? W panelu jest wizualny edytor scenariuszy w /cs/scenarios — pozwala tworzyć automatyzacje obsługi klienta bez kodu, używając 18 typów node'ów. Edytor jest gotowy; pełna instrukcja autorowania jest pisana w ramach finałowego sprintu (windmill/docs/support/authoring.md, TASK-262.16). Po jej skompletowaniu utworzenie nowego scenariusza zajmuje ok. 15 minut.
→ Pełen opis: Automatyzacje — zgłoszenie #11
#12 — Host: son¶
✅ Wyjaśnione. host-son to trzeci serwer z architektury „3 lokalizacji" opisanej w ofercie (str. 2). Pełni rolę ostatniej linii obrony — uruchamiany w pełnej operacyjności tylko gdy host-mom + host-dad nie działają. Aktualne 20 % (sprzęt skonfigurowany, NixOS zainstalowany, podstawowa orkiestracja gotowa) to stan docelowy dla rezerwy — nie aktywnego węzła.
→ Pełen opis: Serwery — zgłoszenie #12
#13 — Serwery VPS¶
✅ Wyjaśnione. 80 % oznacza: konfiguracja vRack + IP failover OVH gotowa, pierwsza partia VPS-ów postawiona (PL, DE, FR), pozostałe kraje (IT, UK, CZ, ES, NL, BE, AT, CH) uruchamiane sukcesywnie w miarę dostępności i potrzeby biznesowej — zgodnie z ofertą str. 3 („sukcesywne uruchamianie kolejnych VPS-ów").
→ Pełen opis: Serwery — sieć VPS
#14 — Bramka SMS¶
✅ Dostarczone. Bramka SMS oparta o TextBee (host-mom, kontener services) — UI pod textbee.aiofactory.pl, API pod sms.aiofactory.pl. Pozwala wysyłać SMS-y z poziomu Windmill scriptów lub scenariuszy CS.
Numer Play do powiadomień: procedura wymaga: a) karta SIM Play z roamingiem SMS, b) modem (USB lub IP) podłączony do hosta, c) konfiguracja modemu w UI TextBee, d) dodanie endpointu w Konfiguracja → Bramka SMS w panelu. Procedura jest gotowa — wymaga tylko fizycznych elementów.
→ Pełen opis: Poczta — bramka SMS
#15 — Serwer Email¶
✅ Dostarczone. Mailcow (host-mom) — kompletny self-hosted serwer pocztowy z SMTP/IMAP/Webmail/DKIM/SPF/DMARC/antywirus/antyspam. Skonfigurowany, hardenowany, zintegrowany z Modułem Obsługi Klienta panelu.
→ Pełen opis: Poczta — Mailcow
#16 — System monitoringu¶
✅ Dostarczone. Beszel (host-mom) — monitoring zdrowia serwerów: CPU, RAM, dysk, sieć, status kontenerów Docker. Wykres trendów + alerty (email/SMS) gdy dysk > 80 % / RAM > 90 % / kontener stopped.
→ Pełen opis: Monitoring — Beszel
#17 — Bazy danych¶
✅ Dostarczone. Backup BaseLinker (pełny snapshot katalogu do Convex), backup baz Subiekta przez Backrest → B2, backup paneli i sklepów przez Backrest → B2 (codzienny, retencja 30 dni dziennych + 12 tygodniowych). Monitoring backupów ma dedykowany skrypt — alarmuje gdy snapshot starszy niż 25h.
→ Pełen opis: Monitoring — backupy
#18 — Social Media¶
✅ Dostarczone. Postiz (host-mom) — gotowe narzędzie do planowania i publikacji postów na Facebooku, Instagramie, LinkedIn, TikToku. Logowanie: postiz.aiofactory.pl. Nie wymaga osobnego silnika automatyzacji — Postiz ma wbudowane szablony i kalendarz publikacji.
→ Pełen opis: Automatyzacje — Postiz
#19 — Baselinker 80 % / Subiekt 30 %¶
🟠 Mieszane.
Baselinker — 100 %: ✅ pełna integracja zrealizowana — pobieranie katalogu, synchronizacja TAG-ami rodzin, wystawianie z dashboardu, snapshot/cache. Procent 80 % w roadmapie odzwierciedla starą definicję; aktualnie integracja jest pełna.
Subiekt — 30 %: ⚪ szkielet zrealizowany; finalizacja odroczona zgodnie z ofertą (str. 4) do migracji właściciela na Subiekt Nexo Pro v57+. Powód: nowy framework Nexo Pro wymaga przepisania konektora; chcemy uniknąć podwójnej pracy.
→ Pełen opis: Oferty — zgłoszenie #19
#20 — Amazon¶
🟠 Częściowe (PL ✅, inne rynki ❌).
✅ Amazon SP-API skonfigurowane i przetestowane (Amazon.PL).
❌ Każdy rynek Amazon (DE, FR, IT, ES, UK, NL, …) wymaga osobnego konta sprzedawcy po stronie Amazona — to nie jest decyzja techniczna, lecz polityka platformy. Po założeniu konta przez właściciela, podpięcie odbywa się standardową procedurą OAuth w panelu (Marketplace → Amazon → Dodaj konto).
To samo dotyczy odbierania wiadomości z Amazon — wsparcie jest, ale per-rynek osobno.
→ Pełen opis: Oferty — zgłoszenie #20
#21 — Mailing¶
✅ Dostarczone. Listmonk (host-mom) — open-source narzędzie do mailingu masowego, zintegrowane z Mailcow jako relay SMTP. Logowanie: listmonk.aiofactory.pl. Tworzenie listy → import kontaktów → szablon → kampania → wysyłka.
→ Pełen opis: Poczta — Listmonk
#22 — Imiona¶
🟢 Dostępne (Scenariusze CS). Wyciąganie imion psów z wiadomości platformowych i email jest realizowalne w wizualnym edytorze scenariuszy (/cs/scenarios):
[Trigger: nowa wiadomość Allegro/Erli/mail]
→ [llm_extract: imię psa z treści]
→ [baselinker_update_field: pole „imię_psa" = {{results.llm.name}}]
→ [send_reply: szablon potwierdzający]
Edytor i 18 node'ów działają; przykładowe scenariusze i instrukcja autorowania w trakcie pisania (TASK-262.16). Po skompletowaniu dokumentacji właściciel może utworzyć scenariusz w ok. 15 minut.
→ Pełen opis: Automatyzacje — zgłoszenia #22, #23
#23 — Kolory¶
🟢 Dostępne (Scenariusze CS). Identyczna ścieżka jak #22, z dodatkowym wariantem „opóźnienie 2-3 h":
[Trigger] → [llm_extract: kolor]
→ [branch: czy klient potwierdził kolor?]
├── tak → [baselinker_update + send_reply]
└── nie → [delay 2-3h] → [baselinker_update_field: domyślny kolor]
→ Pełen opis: Automatyzacje — zgłoszenia #22, #23
#24 — Obsługa Klienta — link do platformy¶
🟠 Częściowe.
Link zwrotny do platformy — częściowe rozwiązanie: dla każdej platformy istnieje deep-link na poziomie danych (source_url w tabeli cs_issues). Brakuje tylko wyświetlenia tego linku w UI wątku. Element finałowego sprintu.
Mark-as-read na platformie po odpowiedzi z panelu — zależy od wsparcia API każdej platformy z osobna:
- Allegro: ✅ wspiera — auto-mark on reply.
- Pozostałe (eBay / Amazon / Erli / Joom / Temu / WooCommerce): ❌ nie udostępniają tego endpointu publicznie. Bez API platformy mark-as-read nie da się wykonać programatycznie.
W praktyce: po odpowiedzi z panelu Allegro sam zdejmie status „nieprzeczytane"; dla pozostałych platformów punktacja systemu reakcji platformy pozostaje na rejestracji wysyłki odpowiedzi (co API udostępnia jako „reply sent" — większość platform akceptuje to jako reakcję).
→ Pełen opis: Obsługa Klienta — zgłoszenie #24
#25 — Beszel¶
✅ Wyjaśnione. Beszel = system monitoringu zdrowia serwerów. Pokazuje CPU, RAM, dysk, status kontenerów. Pozwala wyprzedzać awarie (np. zauważyć rosnące zużycie dysku zanim zabraknie miejsca).
→ Pełen opis: Monitoring — Beszel
#26 — Nowe rynki sklepów (DE / FR)¶
⚪ Poza zakresem oferty.
Pierwotna oferta (str. 2) obejmuje infrastrukturę pod multi-country sklepy (VPS, IP failover, vRack) — to zostało dostarczone.
Oferta (str. 4) wyłącza wprost WordPress / WooCommerce support: „nie świadczę supportu dla samego WordPressa/WooCommerce (np. edycja szablonów, wtyczki, zarządzanie treścią)". Stawianie nowej instancji WP per kraj i tłumaczenia mieszczą się w tym wyłączeniu.
Ścieżka realizacji nowych rynków: właściciel decyduje o szablonie / wyglądzie sklepu (samodzielnie lub z firmą zewnętrzną typu CasaDeniro). Po postawieniu sklepu po stronie partnera — wykonawca panelu podpina sklep do systemu w trybie bug-fix (50 % stawki, maj–sierpień) lub jako odrębne zlecenie po fazie utrzymania.
→ Pełen opis: Sklepy — zgłoszenie #26
#27 — Paperless¶
⚪ Opcjonalne — nie uruchomione w pierwotnym wdrożeniu. Paperless-ngx miał być opcjonalnym dodatkiem do panelu (oferta str. 6: „zautomatyzujemy proste procesy, które teraz trzymacie w Excelach"). W toku projektu właściciel nie zgłosił potrzeby aktywacji, więc nie zostało uruchomione. Konfiguracja przygotowana — uruchomienie wymaga jednego compose-file na host-mom; aktywacja ~30 min na żądanie właściciela.
→ Pełen opis: Monitoring — Paperless
#28 — Widoczność wystawionych produktów¶
✅ Dostarczone (TASK-270, Opcja 2). Po wybraniu platformy w sekcji OFERTY pojawia się dodatkowa pozycja na liście rodzin: „Wszystkie wystawione". Wybór tej pozycji pokazuje wszystkie produkty z TAGI rodziny (~1 516 sztuk), z pominięciem 602 produktów BEZ TAGI. Listing CTA i edycja rodziny są ukryte w tym widoku — to czysty przegląd „co już mam wystawione". Ten sam filtr działa w Katalogu produktów.
→ Pełen opis: Oferty — zgłoszenie #28