XEMO TRADING AI BOT - Автоматизированная воронка и торговые AI-сигналы

Разработка автоматизированной B2C-воронки и AI-сигналов. Проект демонстрирует сложную интеграцию Telegram-бота с API брокера через безопасные вебхуки (postbacks) и управление поэтапным онбордингом.

Архитектура и Стек:
Backend: Python 3.12, Aiogram 3.25. (Telegram API), FastAPI (API & Webhooks).
База данных: PostgreSQL (Async) + SQLAlchemy (Async ORM).
Состояние и Локализации: MemoryStorage (FSM), aiogram_i18n (Fluent .ftl файлы).
Развертывание: Ubuntu (Linux), systemd.

Ключевые модули:
Postback Receiver: Защищенный FastAPI-эндпоинт для мгновенной асинхронной обработки статусов от брокера (регистрация, внесение депозита) и обновления прав пользователя.
Smart User Flow: Автоматическая генерация партнерских deep-links (с трекингом sub_id1 через TG ID) и модуль "Умного охранника" для проверки обязательных подписок.
Dynamic Media Manager: Система "горячей" подмены визуального контента и текстов в зависимости от выбранной локализации (RU/EN). По умолчанию реализован принудительный английский старт для глобального охвата.
Clean Chat UX: Автоматическое удаление предыдущих сообщений/инструкций при переходе на новый этап воронки (через сохранение ID сообщений в FSM).

Особенности реализации:
Архитектура построена по принципу разделения логики (отдельно Telegram-клиент, отдельно REST API приемник). Реализован строгий уровень безопасности: доступ к API защищен кастомным Security Key для исключения подделки финансовых транзакций (фейковых депозитов). Написан кастомный Maintenance Middleware для режима технического обслуживания - бесшовное обновление бота без системных ошибок для конечного пользователя. Масштабируемость базы данных гарантируется использованием пула асинхронных сессий.