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 | 🟡 Bug — w naprawie | Obsługa Klienta |
| 6 | Brak widocznych wiadomości wysłanych w panelu | 🟡 Bug — w naprawie | Obsługa Klienta |
| 7 | Brak weryfikacji hasła SMTP | 🟡 Bug — w naprawie | Poczta |
| 8 | Dwa cenniki przy wystawianiu (koszt + wysyłka) | 🟢 Funkcja — w realizacji | Oferty |
| 9 | Brak filtrowania wątków po opiekunach | 🟡 Bug — w naprawie | Obsługa Klienta |
| 10 | Załączniki do zgłoszeń — brak widoczności | 🟡 Bug — w naprawie | 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 | ✅ Dostarczone (opcjonalne) | Monitoring |
| 28 | Oferty — widoczność wystawionych produktów | 🟢 Funkcja — w realizacji | Oferty |
Legenda statusów:
- ✅ Dostarczone — funkcja działa, wymaga jedynie zapoznania się z opisem.
- 🟢 W realizacji — uznana funkcja w finałowym sprincie wdrożenia (przed rozliczeniem końcowym).
- 🟡 Bug — błąd w naprawie w finałowym sprincie.
- 🟠 Częściowe — część zakresu zrealizowana; zakres uzupełniający opisany w odpowiedniej sekcji.
- ⚪ Poza zakresem oferty — element nieujęty w pierwotnej ofercie z 13 stycznia; opisana ścieżka realizacji w trybie odrębnym.
#5 — Brak widocznej odpowiedzi na email¶
🟡 W naprawie. Wiadomości wysłane z panelu do email (np. test gmail → gmail) nie pojawiają się w historii wątku. Powód: panel obecnie nie pobiera kopii własnych wysyłek z folderu Wysłane przez IMAP. Naprawa: pobieranie Sent Mail + korelacja po Message-ID.
→ Pełen opis i powiązanie z #6: Obsługa Klienta — zgłoszenie #5
#6 — Brak widocznych wiadomości wysłanych w panelu¶
🟡 W naprawie. To samo zjawisko co #5, ale dla wiadomości wysyłanych przez API platform (Allegro itp.). Naprawa: zapis każdej udanej wysyłki do cs_messages natychmiast po sukcesie API, by wątek odświeżał się bez czekania na powtórny pull z platformy.
→ Pełen opis: Obsługa Klienta — zgłoszenie #6
#7 — Brak weryfikacji hasła SMTP¶
🟡 W naprawie. Aktualnie dodanie skrzynki email z błędnym hasłem skutkuje pomyślnym zapisem konta. Naprawa: w momencie dodawania konta panel próbuje zalogować się do SMTP z podanym hasłem; jeśli SMTP AUTH zwróci błąd, formularz blokuje zapis i wyświetla komunikat o błędnym haśle.
→ Pełen opis: Poczta — zgłoszenie #7
#8 — Dwa cenniki przy wystawianiu¶
🟢 W realizacji. Aktualnie reguła cenowa obsługuje pojedynczy price_id × mnożnik. W ramach finałowego sprintu rozszerzenie do (price_id_1 + price_id_2) × mnożnik na każdym koncie każdej platformy — pozwala oddzielić koszt produktu od kosztu wysyłki kartonu.
→ Pełen opis: Oferty — zgłoszenie #8
#9 — Brak filtrowania wątków po opiekunach¶
🟡 W naprawie. Po przypisaniu skrzynek do opiekunów, pracownicy nadal widzą wszystkie wątki. Naprawa: dodanie filtra assigned_user_id w widoku wątków + domyślne ustawienie tego filtra na zalogowanego użytkownika (każdy widzi tylko swoje skrzynki, ze świadomą opcją „pokaż wszystkie").
→ Pełen opis: Obsługa Klienta — zgłoszenie #9
#10 — Załączniki do zgłoszeń¶
🟡 W naprawie. Załączniki (zdjęcia, dokumenty) z wiadomości platformowych nie są wyświetlane w wątku. Naprawa: pobieranie URL załącznika z API platformy + renderowanie inline w widoku wątku (jak w Hubercie).
Komentarz właściciela („czy Claude będzie odpowiadał na zgłoszenia, jak formułować zgłoszenia, jakie logi załączać"): tak — Claude (autonomiczny agent AI) w trakcie sprintu finałowego analizuje każde zgłoszenie i proponuje poprawkę kodu zanim wykonawca odpowie. Najlepszy format zgłoszenia: opis problemu + konkretny scenariusz odtworzenia + screen lub link do strony panelu, na której wystąpił. Logi z Windmilla pomagają wtedy, gdy zgłoszenie dotyczy automatu (np. „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 skonfigurowana — pod adresem bramka.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 host-dad, c) konfiguracja w panelu bramki, 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¶
✅ Dostarczone (opcjonalne). Paperless-ngx (host-mom) — system zarządzania dokumentami z OCR. To osobne narzędzie ze swoim interfejsem i bazą (jak Vaultwarden). Pozwala skanować, indeksować i wyszukiwać dokumenty po treści.
Bezpieczeństwo: dokumenty w wolumenie kontenera Paperless na host-mom; backup codziennie 03:30 do B2; dostęp tylko zalogowany użytkownik panelu (Caddy auth + reverse-proxy). Logowanie: paperless.aiofactory.pl.
→ Pełen opis: Monitoring — Paperless
#28 — Widoczność wystawionych produktów¶
🟢 W realizacji. Aktualny przepływ wymaga kolejności: platforma → rodzina → widok. Zmiana: dodanie filtra „Wszystkie produkty" (jako pseudo-rodzina) który wyświetla wszystkie wystawione na danej platformie produkty bez konieczności wyboru rodziny. Odfiltrowane zostaną produkty bez TAG-u rodziny (ok. 602 starych rekordów BL = śmieci). Filtr trafi też do Katalogu produktów.
Wybrana opcja: Opcja 2 ze zgłoszenia (filtr na liście, najszybsza w implementacji, najczystsza w UX).
→ Pełen opis: Oferty — zgłoszenie #28