🌾 Exportum Bot

Telegram-бот для торговли зерновыми культурами нового поколения

Автоматизация зерновой торговли с интеграцией Google Sheets, парсингом цен и управлением сделками

Возможности • Установка • Использование • Технологии • Документация

---

📋 О проекте

Exportum Bot — это комплексное решение для автоматизации торговли зерновыми культурами через Telegram. Бот объединяет фермеров, трейдеров, логистические компании и экспедиторов на единой платформе, обеспечивая прозрачность сделок и автоматизацию рутинных процессов.

🎯 Основная идея

Создать экосистему, где:

• 🌾 Фермеры быстро находят покупателей для своей продукции
• 💼 Трейдеры получают актуальные предложения и цены
• 🚚 Логисты находят заказы на перевозку
• 📊 Все участники имеют доступ к реальным ценам рынка

---

✨ Возможности

👥 Управление пользователями ✅ Регистрация с полными реквизитами ✅ Роли: Фермер, Трейдер, Логист, Экспедитор ✅ Профили компаний с ИНН, КПП, ОГРН ✅ Контактная информация и реквизиты ✅ История операций каждого пользователя 🌾 Управление партиями ✅ Создание партий зерна (тип, объем, цена) ✅ Редактирование параметров ✅ Удаление и архивация ✅ Поиск по критериям ✅ Статусы партий (активна, в сделке, продана) 🔄 Автоматический матчинг ✅ Умный поиск совпадений ✅ Уведомления о подходящих партиях ✅ Рекомендации на основе истории ✅ Фильтрация по параметрам

💰 Парсинг цен ✅ Российские цены (ikar.ru) ✅ FOB цены (zol.ru) ✅ CBoT котировки ✅ Автообновление каждые 6 часов ✅ История цен и графики 📰 Новости рынка ✅ Автоматический парсинг новостей ✅ Фильтры по темам ✅ Push-уведомления о важных событиях ✅ Архив новостей 📊 Интеграция Google Sheets ✅ Синхронизация данных ✅ Отчеты в реальном времени ✅ Экспорт сделок и партий ✅ Аналитика по пользователям 🚚 Логистика ✅ Заявки на перевозку ✅ Калькулятор стоимости ✅ Отслеживание статуса ✅ Документооборот 📄 Управление сделками ✅ Создание сделок между участниками ✅ Документы (контракты, спецификации) ✅ Статусы и этапы сделки ✅ История платежей

---

🛠️ Технологии

Основной стек

Дополнительные технологии

---

📚 Детальный список библиотек

Библиотека	Версия	Назначение
aiogram	3.0+	Асинхронный фреймворк для Telegram Bot API
gspread	5.0+	Работа с Google Sheets
oauth2client	4.1+	Авторизация Google API
beautifulsoup4	4.12+	Парсинг веб-страниц
requests	2.31+	HTTP-запросы для парсинга
pandas	2.0+	Обработка и анализ данных
python-dotenv	1.0+	Управление переменными окружения
apscheduler	3.10+	Планировщик задач

---

📦 Установка

✅ Требования

🐍 Python 3.10+ Современная версия Python	🤖 Telegram Bot Token От @BotFather
☁️ Google Cloud Project С включенным Google Sheets API	📊 Google Account Для работы со Sheets

---