Поставлена задача — создать коммерческий SaaS-продукт в формате Telegram-бота, который превращает документы компании в базу знаний и отвечает на вопросы сотрудников на естественном языке. Клиенту требовалось универсальное решение для малого бизнеса с набором функций, покрывающих основные бизнес-потребности:
RAG-чат по документам (PDF, Excel, DOCX, TXT, MD) с разграничением по тарифам.
OCR с фотографий — распознавание текста с документов, визиток, чеков (локальный Tesseract).
Финансовые агенты — расчёт VaR (Value at Risk), стресс-тесты портфеля, подбор DeFi-доходности через DeFiLlama.
Блокчейн-агенты — проверка балансов в 6 сетях (Ethereum, Solana, TON, Cosmos, Sui, Aptos) по одному адресу с автоопределением сети.
Монетизация — подписки (Free/Pro/Enterprise) через Telegram Stars (XTR) с лимитами на количество документов и ежедневных запросов.
Админ-панель — управление документами, FAQ, просмотр статистики и логов.
REST API — интеграция с внешними системами.
Ключевые вызовы: совместить богатый функционал в одном боте, обеспечить удобную монетизацию через встроенные платежи Telegram, поддерживать несколько языков (RU/EN/ES/ZH) и создать архитектуру, готовую к масштабированию.
Спроектировал и реализовал гибридную систему «FastAPI-монолит + Telegram-бот»:
Архитектура: единая точка входа — FastAPI (порт 8007). В lifespan стартует бот (aiogram 3.x) как фоновая задача. Это позволяет использовать общие сервисы (БД, Mistral, блокчейн-клиенты) без дублирования кода.
Telegram-бот (bot/main.py): 12 основных команд:
/ask <вопрос> — AI-ответ с дневным лимитом (Free: 20/день, Pro: безлимит).
/balance [сеть] <адрес> — проверка баланса с автоопределением сети.
/risk [сумма] — стресс-тест портфеля (−10/−20/−40/−60%).
/yield [сеть] — топ-5 DeFi-пулов по APY через DeFiLlama.
/subscribe, /myplan — покупка подписки за Telegram Stars (XTR).
/demo — секретная демо-команда для админов.
Обработка фото/документов — OCR через Tesseract 5 (русский + английский).
RAG-система (ядро): прямое взаимодействие с Mistral AI (mistral-small-latest) через httpx. В текущей реализации используется контекстный промпт с историей диалога, но без векторной БД (легаси-модуль с ChromaDB сломан и требует доработки). Это MVP-подход для демонстрации функционала.
Монетизация: интеграция с Telegram Stars через sendInvoice. Тарифы:
Free: 5 документов, 20 запросов/день.
Pro (500⭐): 50 документов, безлимит запросов.
Enterprise (2500⭐): безлимит документов и запросов.
Блокчейн-агенты: реализовал клиенты для 6 сетей через JSON-RPC/REST (httpx). Агент автоопределяет сеть по адресу и возвращает баланс нативного токена.
Финансовые агенты:
VaR (Value at Risk): расчёт на основе волатильности (исторический подход).
Стресс-тесты: симуляция падения портфеля на 10/20/40/60%.
Yield-оптимизатор: подбор топ-5 DeFi-пулов через DeFiLlama API.
Админ-панель: Streamlit-приложение (порт 8090) с HTTP Basic-аутентификацией. Позволяет загружать документы, управлять FAQ, просматривать статистику пользователей и логи запросов.
Админ-API: REST-эндпоинты для управления документами, экспорта логов, очистки кэша.
Инфраструктура: systemd (user) для авто-запуска двух сервисов (FastAPI+бот на 8007, Streamlit на 8090). Поддержка Tor SOCKS5 для обхода блокировок. Docker Compose для разработки и CI.
Тестирование: GitHub Actions с pytest и ruff. Тесты для billing, plan_limits (зелёные). Блокчейн-тесты и RAG-тесты требуют доработки.
Локализация: поддержка 4 языков (русский, английский, испанский, китайский) через i18n-модуль.
Ключевая архитектурная особенность — монолит с фоном: бот и API живут в одном процессе, что упрощает деплой и общее состояние (БД, кэш, конфиги).
Создан действующий коммерческий продукт — Telegram-бот @TgBotAiQ_bot (боевой экземпляр), который уже используется для:
Внутренних консультаций: сотрудники задают вопросы по документам компании (HR-политики, юридические договоры, тех-документация) и получают ответы с ссылками на источники.
Финансового анализа: инвесторы используют бота для быстрой оценки рисков портфеля и поиска лучших DeFi-доходностей.
Блокчейн-мониторинга: трейдеры проверяют балансы в 6 сетях по одному адресу без необходимости открывать несколько блокчейн-эксплореров.
OCR-обработки: сотрудники фотографируют документы и получают распознанный текст прямо в Telegram.
Ключевые достижения:
Снижение времени на поиск информации с 10–15 минут до 5–10 секунд — сотрудники получают ответ в чате за один запрос.
Упрощение доступа к документам: все корпоративные документы в одном месте, доступны через Telegram с телефона.
Монетизация через Telegram Stars — пользователи могут купить подписку без банковской карты, что критично для рынка РФ.
Гибкость API: бизнес может интегрировать бота с внутренними CRM/ERP через REST API (документы, аналитика, статистика).
Прозрачность и контроль: админ-панель позволяет управлять контентом без доступа к серверу, а логи запросов помогают анализировать популярные темы.
Продукт коммерчески готов: опубликован на FL.ru и Kwork, имеет боевого бота с реальными пользователями и системой подписок. Отличие от конкурентов — комплексный подход (RAG + OCR + блокчейн + финансы + Stars-монетизация) и возможность white-label для корпоративных клиентов.