🤖 Telegram AI Bot для управления зарплатами

Умный Telegram бот для автоматического расчета зарплат, анализа продаж и обработки голосовых команд с интеграцией OpenAI ChatGPT.

🚀 Быстрый старт

На текущем компьютере (где разрабатывался проект):

1. Инициализируйте Git репозиторий:

cd telegram_ai_bot
git init
git add .
git commit -m "Initial commit: telegram_ai_bot project"

2. Создайте репозиторий на GitHub и загрузите код:

git remote add origin https://github.com/your-username/telegram_ai_bot.git
git branch -M main
git push -u origin main

На новом компьютере:

1. Клонируйте репозиторий:

git clone https://github.com/your-username/telegram_ai_bot.git
cd telegram_ai_bot

2. Создайте виртуальное окружение и установите зависимости:

python -m venv venv

# Windows:
venv\Scripts\activate
pip install -r requirements.txt

# Linux/Mac:
source venv/bin/activate
pip install -r requirements.txt

3. Настройте переменные окружения:

# Windows:
copy env.example .env

# Linux/Mac:
cp env.example .env

4. Заполните токены в файле .env:

TELEGRAM_BOT_TOKEN=ваш_токен_бота
OPENAI_API_KEY=ваш_ключ_openai
EXCEL_FILE_NAME=Alseit.xlsx

5. Запустите бота:

python bot.py

🔑 Получение токенов

Telegram Bot Token:

1. Напишите @BotFather в Telegram
2. Создайте нового бота командой /newbot
3. Скопируйте полученный токен

OpenAI API Key:

1. Перейдите на https://platform.openai.com/api-keys
2. Создайте новый API ключ
3. Скопируйте ключ

Важно: Без OpenAI API бот будет работать, но AI функции будут недоступны

Проверка установки

После установки зависимостей проверьте, что все пакеты установлены корректно:

pip list

Должны быть установлены следующие пакеты:

• python-telegram-bot==20.7
• pandas==2.1.4
• numpy>=1.26.0
• openpyxl==3.1.2
• python-dotenv==1.0.0
• openai>=1.0.0

Использование

1. Убедитесь, что виртуальное окружение активировано (если используете):

# В начале строки должно быть (venv)
(venv) PS C:\path\to\project>

2. Запустите бота:

python bot.py

2. В Telegram используйте команды:
   • /start - начать работу с ботом
   • /update - обновить зарплаты и рассчитать бонусы
   • /analyze - полный AI анализ данных (требует OpenAI API)
   • /insights - быстрые инсайты по продажам
   • /edit - редактировать данные в Excel через AI (требует OpenAI API)
   • /help - справка по командам

Функции

Основные функции

• Автоматический расчет НДС (16%)
• Расчет стоимости доставки (пэй/магазин)
• Расчет бонусов менеджеров (5%)
• Расчет бонусов ROP сотрудников (1%)
• Создание сводки по бонусам в Excel
• Сохранение результатов в Excel файл

AI Анализ данных (ChatGPT)

• Полный анализ продаж и производительности
• Анализ эффективности менеджеров и ROP сотрудников
• Выявление трендов и паттернов в данных
• Рекомендации по улучшению показателей
• Быстрые инсайты по ключевым метрикам

AI Редактирование Excel (ChatGPT)

• Редактирование данных через естественный язык
• Автоматический поиск записей по номеру заказа или товару
• Изменение количества, цен и других параметров
• Автоматический пересчет сумм при изменении количества
• Сохранение изменений в исходный Excel файл

Примеры команд редактирования:

• /edit заказ номер #2 вместо двух котлов взял один
• /edit изменить количество товара 'котлы' в заказе 5 с 3 на 1
• /edit обновить цену товара 'радиатор' в заказе 1 на 50000

Структура проекта

telegram_ai_bot/
├── venv/                    # Виртуальное окружение (создается автоматически)
├── bot.py                   # Основной файл бота
├── salary_update.py         # Модуль для обновления зарплат
├── chatgpt_analyzer.py      # Модуль для AI анализа данных
├── requirements.txt         # Зависимости проекта
├── README.md               # Документация
├── Alseit.xlsx            # Excel файл с данными
└── .env                    # Переменные окружения (создать вручную)

Структура Excel файла

• Лист "продажи" - исходные данные о продажах
• Лист "зарплата" - обновленные данные с окладами и бонусами
• Лист "сводка_бонусов" - итоговая таблица с суммами бонусов

Примечания

• Виртуальное окружение: Рекомендуется использовать виртуальное окружение для изоляции зависимостей проекта
• Python версия: Проект протестирован с Python 3.12
• Зависимости: Все необходимые пакеты указаны в requirements.txt
• OpenAI API: Для полного функционала требуется API ключ от OpenAI
• Безопасность: Не коммитьте файл .env в репозиторий - он содержит чувствительные данные
• Производительность: AI анализ может занимать несколько секунд в зависимости от размера данных