cat_time_bot

Текущая версия

v0.6.5-alpha -> Скачать

Список всех изменений: Ссылка.

⚠️ Статус проекта: MVP / В разработке > Обратите внимание: сам проект и данное README находятся в стадии активной разработки. На текущий момент бот запущен и функционирует в формате минимально жизнеспособного продукта (MVP).

О проекте

Cat Time Bot - это Telegram-бот, предназначенный для учета времени и организации рабочего процесса. Главная задача проекта - автоматизация трекинга активности пользователей с возможностью последующего экспорта собранных данных в формате Excel через панель управления Django Admin. Бот сочетает в себе инструменты для повышения продуктивности с элементами игрофикации, помогая оптимизировать рабочий день.

Преимущества

• 🤖 Автоматизация учета: Систематизация контроля рабочего времени для минимизации рутинных задач.
• 🛠️ Администрирование и экспорт: Централизованное управление данными и быстрая генерация отчетов через интегрированную панель Django Admin.
• 🌦️ Метеорологическая сводка: Встроенный модуль прогноза погоды с предоставлением актуальных данных (температура, влажность, атмосферное давление и направление ветра).
• 🐾 Пользовательский интерфейс и вовлеченность: Тематическая стилизация взаимодействия с использованием специализированных эмодзи и отправкой изображений котов для поддержания позитивного пользовательского опыта.

Технологии

• Python 3.12
• Django 6
• django-import-export
• python-telegram-bot
• aiohttp (для асинхронных HTTP-запросов)
• APScheduler (для планирования задач)

Инструкция

• Клонируйте проект на свой компьютер:

git clone git@github.com:hydrospirt/cat_time_bot.git

• Установите и активируйте виртуальное окружение c Python 3.12

cd ./src/ &&
py -3.12 -m venv venv

• Для Windows:

source venv/Scripts/Activate

• Для Linux

source venv/bin/activate

• Установите зависимости из файла requirements.txt

python3 -m pip install --upgrade pip
pip install -r requirements.txt

• Создайте переменные окружения в основной папке проекта "cat_time_bot"

touch .env

• Добавьте ваши данные в файл .env

DEBUG=False
ALLOWED_HOSTS=127.0.0.1,localhost
SECRET_KEY=Секретный код Django
TELEGRAM_BOT_TOKEN=Секретный токен @BotFather
TRUSTED_ORIGINS=http://127.0.0.1,http://localhost и тд.
OPENWEATHER_API_KEY=ключ от API например: 1a2b3c4d5e6f7g8h
TELEGRAM_GROUP_CHAT_ID=ИД канала например: -1001234517895

Инструкции для запуска на localhost

• Запустить скрипт:

chmod +x setup.sh

./setup.sh

• Запустить сервер и перейти:

python3 manage.py runserver

• Запустить Telegram бота:

python3 manage.py start_bot

Проект разрабатывали:

Эдуард Гумен	Python-разработчик	Cтраница GitHub

Лицензия

Пожалуйста, ознакомьтесь с MIT license