Inteligentny system zarządzania zamówieniami

Cel: Opracowanie systemu odpornego na awarie do przyjmowania zamówień (E-commerce Bot) z logiką ochrony przed kolizjami danych. Wymóg: system ma działać jako Maszyna Stanów (automat skończony), dynamicznie dostosowując interfejs do dostępności produktów w bazie oraz zapewniając "czystość" danych wejściowych jeszcze przed etapem przetwarzania przez menedżera.

Mój wkład / rozwiązanie: Zaprojektowano i wdrożono architekturę "Architektura Świadoma Stanu" opartą na n8n, która zarządza cyklem życia użytkownika od logowania do finalizacji transakcji. Zastosowano podejście Low-Code + Custom JS do obejścia ograniczeń standardowych węzłów.

1. Architektura "Gatekeeper" (Zarządzanie sesjami):

Silnik logiki i kontrola współbieżności: Zrealizowano rygorystyczny algorytm "Face Control" (Logika Węzła Przełączającego). System sprawdza bazę danych pod kątem istniejących transakcji (statusy "Oczekujące", "Czekanie na płatność") przed rozpoczęciem nowego procesu. To uniemożliwia tworzenie duplikatów i "śmieciowych" zapisów.

Resetowanie sesji i czyszczenie: Wdrożono mechanizm wymuszonego resetowania zawieszonych sesji (force_cancel), co pozwala użytkownikowi samodzielnie rozwiązywać konflikty stanów bez kontaktu z pomocą techniczną.

2. Dynamiczny frontend (UI Telegram):

Interfejs generowany w formacie JSON: Zamiast twardego kodowania przycisków zrealizowano dynamiczne generowanie menu (Węzeł Kod JavaScript). Bot wysyła zapytanie do bazy danych magazynowej (n8n Table/Airtable), otrzymuje aktualny katalog produktów i "w locie" renderuje klawiaturę. To pozwala na dodawanie produktów (/add) bez ponownego uruchamiania bota.

Surowe żądania HTTP: Aby obejść ograniczenia standardowych węzłów n8n i wyeliminować błędy UI, wykorzystano bezpośrednie zapytania POST do Telegram API. To zapewniło stabilną pracę złożonych obiektów reply_markup oraz poprawne przesyłanie danych callback.

3. Integralność danych i walidacja:

Inteligentne parsowanie: Kombinacja wyrażeń regularnych (RegEx) i operatorów warunkowych do walidacji wejścia (na przykład, rozróżnienie kwoty "200" od telefonu "050...").

Blokowanie bazy danych: Wykorzystanie atomowych aktualizacji wierszy według unikalnych ID (a nie według ChatID), co rozwiązało problem nadpisywania danych przy jednoczesnej pracy kilku operatorów lub instancji.

Rezultat: Stworzono autonomiczny system sprzedaży, który nie wymaga nadzoru technicznego:

Baza danych bez konfliktów: Liczba zduplikowanych lub błędnych zamówień została zredukowana do 0 dzięki logice zarządzania stanem.

Skalowalność: Dodawanie nowych pozycji towarowych zajmuje sekundy dzięki komendom administracyjnym, automatycznie aktualizując interfejs u wszystkich użytkowników.

Doświadczenie użytkownika: System sam "prowadzi" klienta, blokując nielogiczne działania i oferując kontekstowe scenariusze wyjścia z błędów.

#n8n #JavaScript #ArchitekturaBackendowa #ZarządzanieStanem #TelegramBotAPI #AutomatyzacjaECommerce #ObsługaBłędów #ProjektowanieBazyDanych