Bot Polya - Telegram-бот для учета рабочего времени

Telegram-бот для учета рабочего времени с автоматическим экспортом в Google Sheets.

📋 Описание

Bot Polya (версия 3.0) - это Telegram-бот для команды, работающей на полях и складах. Бот позволяет:

• Регистрировать отработанные часы
• Указывать место работы и вид деятельности
• Просматривать статистику
• Автоматически экспортировать данные в Google Sheets

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

Для работников:

• 🚜 Учет работы - регистрация отработанных часов:
  • Выбор места работы (поля, склад)
  • Вид работы (техника, ручной труд)
  • Дата (сегодня, вчера, позавчера и до -4 дней)
  • Количество часов
• 📊 Статистика - просмотр своих отчетов
• 📝 Перепись - списки работников по локациям и видам работ
• ✏️ Изменение имени - обновление своих данных

Для администраторов:

• ⚙️ Админ-панель:
  • Добавление/удаление видов работ
  • Добавление/удаление локаций
  • 📤 Экспорт в Google Sheets - автоматическая выгрузка отчетов

Google Sheets интеграция:

• Автоматический экспорт по расписанию (cron)
• Месячные таблицы (отдельная таблица для каждого месяца)
• Защита от дублирования данных
• Формат таблицы: Дата | Фамилия Имя | Место работы | Вид работы | Часы

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

Требования

• Python 3.8+
• Telegram Bot Token (от @BotFather)
• Google Cloud Project с включенным Google Sheets API
• VPS сервер (опционально)

Установка

Локальная установка

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

git clone https://github.com/sunnuls/terra_telegram-bot.git
cd terra_telegram-bot

2. Установите зависимости:

pip install -r requirements.txt

3. Создайте файл .env на основе env_template.txt:

cp env_template.txt .env

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

TELEGRAM_TOKEN=ваш_токен_бота
ADMIN_IDS=123456789,987654321
OAUTH_CLIENT_JSON=oauth_client.json
DRIVE_FOLDER_ID=ваш_folder_id

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

python bot_polya.py

Развертывание на VPS

Смотрите подробное руководство: QUICK_START_VPS.md

Автоматическая установка на Ubuntu/Debian:

chmod +x install.sh
./install.sh

📚 Документация

• CHANGELOG.md - История изменений
• DEPLOYMENT_GUIDE.md - Руководство по развертыванию
• GOOGLE_SHEETS_SETUP.md - Настройка интеграции с Google Sheets
• QUICK_START_VPS.md - Быстрый старт на VPS
• QUICK_START_EXPORT.md - Настройка экспорта в Google Sheets

🔧 Технологии

• aiogram 3.x - фреймворк для Telegram-ботов
• SQLite - база данных
• Google Sheets API - экспорт отчетов
• APScheduler - планировщик задач
• Docker - контейнеризация (опционально)

📊 Структура базы данных

• users - пользователи
• reports - отчеты о работе
• activities - виды работ
• locations - локации
• google_exports - история экспорта
• monthly_sheets - месячные таблицы Google Sheets

🐛 Решение проблем

Бот не отвечает

Проверьте:

# Статус службы (если на VPS)
systemctl status bot_polya

# Логи
journalctl -u bot_polya -n 50

# Или запустите вручную для диагностики
python bot_polya.py

Проблемы с Google Sheets

Смотрите: GOOGLE_SHEETS_SETUP.md

📝 Лицензия

MIT License - свободное использование с указанием авторства.

🤝 Контакты

• GitHub: @sunnuls
• Repository: terra_telegram-bot

📈 Версии

v3.0 (текущая)

• ✅ Экспорт в Google Sheets
• ✅ Автоматическое создание месячных таблиц
• ✅ Планировщик задач (cron)
• ✅ Защита от дублирования данных

v2.3

• ✅ Исправлены админ-функции
• ✅ Улучшен выбор дат

v2.2

• ✅ Упрощен выбор склада

v2.1

• ✅ Функция перерегистрации/изменения имени

---

⭐ Если проект оказался полезен, поставьте звезду на GitHub!