Automatyzacje¶

Automatyzacja procesów biznesowych — przekazywanie zamówień, wyciąganie informacji z wiadomości klientów, aktualizacja BaseLinker, scenariusze obsługi klienta, planowanie postów społecznościowych.

Co zostało dostarczone¶

Windmill (zamiast N8N)¶

Silnik wykonawczy: Windmill (host-dad) — workflow engine z natywnym wsparciem dla Pythona i TypeScripta, harmonogramami, retry, dead-letter queue.

Zastąpił N8N — patrz #11.

Wbudowane skrypty i flowy obsługują:

Synchronizację katalogu BaseLinker do Convex.
Pobieranie ofert ze wszystkich 7 platform (refresh per-konto + scheduler).
Publikację ofert na platformach.
Klasyfikację wiadomości obsługi klienta (Claude AI).
Dyspozytor scenariuszy CS (uruchamiany co minutę).
Backupy kontenerów do B2 (Backrest).
Odświeżanie tokenów OAuth platform marketplace.
Wystawianie produktów na sklepach Woo.
Generowanie wpisów na Facebook (Postiz).

Wizualny edytor scenariuszy CS¶

Panel /cs/scenarios (TASK-142, TASK-171) zawiera wizualny edytor (Svelte Flow) w którym właściciel może samodzielnie tworzyć scenariusze automatyzacji obsługi klienta.

Dostępne node'y (18 typów):

Triggery: nowa wiadomość Allegro / eBay / Amazon / Erli / Joom / Temu / Woo / email IMAP.
Logika: filtr wartości, gałęzie warunkowe, oczekiwanie na czas (delay), oczekiwanie na zdarzenie.
AI: ekstrakcja danych z wiadomości (llm_extract), klasyfikacja kategorii.
Akcje: wysłanie odpowiedzi (send_reply), aktualizacja statusu, dodanie pola w BaseLinker, utworzenie ticketu, wykonanie szablonu.

Pełna instrukcja z przykładami: windmill/docs/support/authoring.md (rozwijana w ramach TASK-262.16).

Postiz (host-mom) — narzędzie do planowania i publikacji postów na Facebooku, Instagramie, LinkedInie, TikToku.

Cytat z roadmapy: „System do zarządzania wpisami na Social Mediach" — ✅ dostarczone.

Postiz to gotowe narzędzie zintegrowane jako osobna usługa. Logowanie: postiz.aiofactory.pl — szczegóły dostępu w sekcji Inwentarz Usług.

Pupprint — Naklejki z imionami psów¶

Status: ✅ Dostarczone.

Automatyzacja generująca arkusze A4 z naklejkami imion psów dla zamówień personalizowanych. Obsługuje dwa rozmiary kart (big/small), pełne i częściowe arkusze oraz rozdzielnik KINGDOG. Flow: f/automations/pupprint/generate_grid.flow/. Cron flush_expired_batches zamyka kolejki, których nie zamknięto ręcznie przez „Flush teraz" w dashboardzie.

Trial typografii (TASK-212): ✅ wykonano. Po zgłoszeniu właściciela testowano krój Cambria (proprietary Microsoft) — dostarczamy zamiennik Caladea-Bold (libre, metric-compatible z Cambrią) z trzech wariantów wielkości tekstu:

wariant	margines H × V	współczynnik wysokości	charakter
v1_cambria_baseline	6,0 × 5,0 mm	0,65	sam krój, wielkość ~obecna
v2_cambria_enlarged	4,0 × 3,0 mm	0,90	widocznie większy, 1 mm od kreskowanej ramki — rekomendowany
v3_cambria_max	3,0 × 2,5 mm	0,95	maksymalnie blisko ramki

Próbki PDF + PNG dla 7 kanonicznych przypadków (big/small × full/partial/empty + KINGDOG) leżą w repo pod lab/pupprint_preview/. Po wybraniu wariantu przez właściciela — promocja do skryptu produkcyjnego (zamiana stałych w windmill/f/automations/pupprint/generate_grid.flow/) odbędzie się w trybie bug-fix mode na zgłoszenie.

Znane zgłoszenia¶

Zgłoszenie #11 — Co z N8N¶

Status: ✅ Zastąpione przez Windmill.

Powód zmiany:

N8N w trakcie konfiguracji okazał się ograniczeniem dla zaplanowanego zakresu integracji. Główne problemy: brak deterministycznego retry dla scenariuszy z OAuth, słabe wsparcie typów dla pisanych własnoręcznie skryptów, problemy z wersjonowaniem flowów w git. Windmill rozwiązuje wszystkie trzy.

Co to oznacza dla właściciela:

„Ja nie jestem w stanie z tych narzędzi korzystać, jak coś nowego będę chciał dodać będę skazany tylko na Twój czas, którego raczej miał dla mnie nie będziesz." — zgłoszenie #11.

Odpowiedź: w panelu jest wizualny edytor scenariuszy (/cs/scenarios) który umożliwia tworzenie nowych automatyzacji obsługi klienta bez kodu. Edytor ma 18 typów node'ów obejmujących cały zakres scenariuszy CS opisanych w roadmapie.

Stan dokumentacji edytora:

Aktualnie: edytor w pełni działa, ale dokumentacja pisana w ramach TASK-262.16 (Phase B — CS scenario builder docs).
Po zakończeniu TASK-262.16: pełna instrukcja krok-po-kroku autorowania scenariuszy w windmill/docs/support/authoring.md, z przykładami end-to-end.

To gotowy element pakietu dokumentacji przekazującej projekt zgodnie z ofertą str. 7.

Scenariusze poza zakresem CS (np. masowy mailing, raporty Excel, automatyzacje magazynowe poza Baselinkerem) — wymagają edycji w samym Windmill (kod Python/TS). Tutaj rola właściciela się kończy; w razie potrzeby — przez Forgejo issue jako nowe zlecenie.

Status: ✅ Dostarczone.

Postiz w pełni działa. Patrz Postiz wyżej.

Pytanie z zgłoszenia: „a jak będę chciał coś prosto zautomatyzować to będę mógł odpalić w np n8n scenariusz?" — odpowiedź: dla scenariuszy obsługi klienta TAK, przez wizualny edytor /cs/scenarios. Dla automatyzacji Postiz zewnątrz CS — Postiz ma własne wbudowane templates i kalendarz; nie wymaga osobnego silnika.

Zgłoszenia #22, #23 — Imiona i Kolory¶

Status: 🟢 Dostępne (Scenariusze CS).

Obie automatyzacje są realizowalne w wizualnym edytorze scenariuszy CS:

Imiona psów (#22):

[Trigger: nowa wiadomość Allegro / Erli / mail]
  ↓
[Filtr: kategoria zamówienia = "personalizacja"]
  ↓
[llm_extract: wyciągnij imię psa z treści wiadomości]
  ↓
[baselinker_update_field: pole "imię_psa" = {{results.llm.name}}]
  ↓
[send_reply: szablon "Dziękujemy, imię {{name}} zostało dodane do zamówienia"]

Kolory (#23) — wariant z opóźnieniem:

[Trigger: jak wyżej]
  ↓
[llm_extract: wyciągnij kolor]
  ↓
[branch: czy klient potwierdził kolor?]
  ├── tak → [baselinker_update + send_reply]
  └── nie → [delay 2-3h]
                ↓
              [baselinker_update_field: domyślny kolor]

Każdy node llm_extract wywołuje Claude API z promptem skonfigurowanym w UI. Każdy baselinker_* używa skonfigurowanego konta Baselinker z Konfiguracji.

Aktualny status:

✅ Edytor i 18 node'ów — działa.
🟡 Dokumentacja w trakcie pisania (TASK-262.16).
🟡 Przykładowe scenariusze gotowe do importu — w trakcie.

Po skompletowaniu dokumentacji (TASK-262.16) właściciel może samodzielnie utworzyć scenariusz dla każdej platformy w czasie ok. 15 minut na scenariusz.

Architektura (techniczna)¶

Windmill workspaces: dev (host-dev) i prod (host-dad)
CLI: wmill sync push synchronizuje skrypty z repo (z windmill/wmill.yaml)
Tabele Convex: cs_scenarios, cs_issue_events, cs_issue_runs, cs_dead_letters
Scenariusze generowane do flowów Windmill: f/cs/scenarios/<slug>
Cron dyspozytora: 0 * * * * * (co minutę, f/cs/dispatcher.flow/)