TeleLog - Telegram Authentication System

👨‍💻 Разработчик

Денис 🦊

TeleLog - это система аутентификации через Telegram для Django проектов. Проект позволяет пользователям легко и безопасно входить на сайт через свой Telegram аккаунт.

🎥 Демонстрация

TeleLogVideo.mp4

📸 Скриншоты

Страница авторизации

Telegram бот с токеном в URL

Успешная авторизация в боте

Неуспешная авторизация в боте

Панель управления

🚀 Особенности

• 🔐 Безопасная аутентификация через Telegram
• ⚡ Асинхронная обработка запросов
• 🔄 Real-time обновление статуса авторизации
• 🎨 Современный UI с Tailwind CSS
• 🐳 Docker для разработки
• ✅ Полное тестовое покрытие

🛠 Технический стек

• Python 3.12+
• Django 5.0+
• python-telegram-bot 21.0+
• Redis (кэширование токенов)
• PostgreSQL
• Docker & Docker Compose
• uv (управление зависимостями)
• ruff (форматирование)
• Pytest (тестирование)

📦 Установка

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

git clone https://github.com/TheFoxKD/telelog.git
cd telelog

2. Создайте .env файлы:

mkdir -p .envs/dev
cp .envs/dev/.django.example .envs/dev/.django

3. Настройте Telegram бота:

• Создайте бота через @BotFather
• Добавьте токен в .envs/dev/.django:

TELEGRAM_BOT_TOKEN='your-token'
TELEGRAM_BOT_USERNAME='your-bot-username'

4. Запустите через Docker:

docker-compose -f docker-compose.dev.yml up --build

5. Запустите миграции:

docker-compose -f docker-compose.dev.yml run --rm django python manage.py migrate

🧪 Тестирование и покрытие кода

# Запуск тестов с покрытием
docker-compose -f docker-compose.dev.yml run --rm django pytest --cov=src

# Генерация HTML отчета
docker-compose -f docker-compose.dev.yml run --rm django pytest --cov=src --cov-report=html

# Отчет в консоли
docker-compose -f docker-compose.dev.yml run --rm django pytest --cov=src --cov-report=term-missing