Інтелектуальна система управління замовленнями

Мета: Розробити відмовостійку систему прийому замовлень (E-commerce Bot) з логікою захисту від колізій даних. Вимога: система має працювати як State Machine (кінцевий автомат), динамічно підлаштовувати інтерфейс під наявність товарів у базі та забезпечувати "чистоту" вхідних даних ще до етапу обробки менеджером.

Мій Внесок / Рішення: Спроектовано та впроваджено архітектуру "State-Aware Architecture" на базі n8n, яка керує життєвим циклом користувача від входу до фіналізації угоди. Використано підхід Low-Code + Custom JS для обходу обмежень стандартних вузлів.

1. Архітектура "Gatekeeper" (Управління сесіями):

Logic Engine & Concurrency Control: Реалізовано жорсткий алгоритм "Фейсконтролю" (Switch Node Logic). Система перевіряє базу даних на наявність незавершених транзакцій (статуси "Pending", "Payment Wait") перед стартом нового процесу. Це унеможливлює створення дублів та "сміттєвих" записів.

Session Reset & Cleanup: Впроваджено механізм примусового скидання завислих сесій (force_cancel), що дозволяє користувачу самостійно вирішувати конфлікти станів без звернення до підтримки.

2. Динамічний Frontend (Telegram UI):

JSON-Generated Interface: Замість хардкодингу кнопок реалізовано динамічну генерацію меню (JavaScript Code Node). Бот робить запит до складської бази даних (n8n Table/Airtable), отримує актуальний каталог товарів і "на льоту" рендерить клавіатуру. Це дозволяє додавати товари (/add) без перезавантаження бота.

Raw HTTP Requests: Для обходу обмежень стандартних нод n8n та усунення UI-глюків використано прямі POST-запити до Telegram API. Це забезпечило стабільну роботу складних об'єктів reply_markup та коректну передачу callback-даних.

3. Data Integrity & Validation (Цілісність даних):

Smart Parsing: Комбінація регулярних виразів (RegEx) та умовних операторів для валідації вводу (наприклад, розрізнення суми "200" від телефону "050...").

Database Locking: Використання атомарних оновлень рядків за унікальними ID (а не за ChatID), що вирішило проблему перезапису даних при одночасній роботі кількох операторів або інстансів.

Результат: Створено автономну систему продажів, яка не потребує технічного нагляду:

Zero-Conflict Database: Кількість дубльованих або помилкових замовлень зведена до 0 завдяки логіці state-management.

Scalability: Додавання нових товарних позицій займає секунди через адмін-команди, автоматично оновлюючи інтерфейс у всіх користувачів.

User Experience: Система сама "веде" клієнта, блокуючи нелогічні дії та пропонуючи контекстні сценарії виходу з помилок.

#n8n #JavaScript #BackendArchitecture #StateManagement #TelegramBotAPI #ECommerceAutomation #ErrorHandling #DatabaseDesign