{"id":22631325,"url":"https://github.com/thefoxkd/telelog","last_synced_at":"2026-01-28T06:15:58.132Z","repository":{"id":265957246,"uuid":"896964757","full_name":"TheFoxKD/TeleLog","owner":"TheFoxKD","description":"🔐 TeleLog: Clean Django app for Telegram OAuth authentication | One-click Telegram login, secure token auth \u0026 real-time user status updates | Ready to use with Docker 🐳","archived":false,"fork":false,"pushed_at":"2024-12-02T11:33:03.000Z","size":10610,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-29T04:19:32.670Z","etag":null,"topics":["auth","django","postgresql","python","redis","telegram-bot-api"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/TheFoxKD.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-12-01T18:26:54.000Z","updated_at":"2025-01-21T08:56:23.000Z","dependencies_parsed_at":"2024-12-01T19:41:18.185Z","dependency_job_id":null,"html_url":"https://github.com/TheFoxKD/TeleLog","commit_stats":null,"previous_names":["thefoxkd/telelog"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TheFoxKD%2FTeleLog","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TheFoxKD%2FTeleLog/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TheFoxKD%2FTeleLog/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TheFoxKD%2FTeleLog/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/TheFoxKD","download_url":"https://codeload.github.com/TheFoxKD/TeleLog/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":249185181,"owners_count":21226530,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["auth","django","postgresql","python","redis","telegram-bot-api"],"created_at":"2024-12-09T02:08:28.000Z","updated_at":"2026-01-28T06:15:53.111Z","avatar_url":"https://github.com/TheFoxKD.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# TeleLog - Telegram Authentication System\n\n[![Python Version](https://img.shields.io/badge/python-3.12-blue.svg)](https://python.org)\n[![Django Version](https://img.shields.io/badge/django-5.1-green.svg)](https://www.djangoproject.com)\n[![Code style: ruff](https://img.shields.io/badge/code%20style-ruff-000000.svg)](https://github.com/astral-sh/ruff)\n[![Tests](https://github.com/TheFoxKD/TeleLog/actions/workflows/ci.yml/badge.svg)](https://github.com/TheFoxKD/TeleLog/actions/workflows/ci.yml)\n[![Coverage Status](https://coveralls.io/repos/github/TheFoxKD/TeleLog/badge.svg?branch=main)](https://coveralls.io/github/TheFoxKD/TeleLog?branch=main)\n\n### 👨‍💻 Разработчик\n\n**Денис 🦊**\n\n[![GitHub](https://img.shields.io/badge/GitHub-TheFoxKD-181717?style=flat\u0026logo=github)](https://github.com/TheFoxKD)\n[![Telegram](https://img.shields.io/badge/Telegram-@TheFoxDK-2CA5E0?style=flat\u0026logo=telegram)](https://t.me/TheFoxDK)\n[![Email](https://img.shields.io/badge/Email-krishtopadenis@gmail.com-D14836?style=flat\u0026logo=gmail)](mailto:krishtopadenis@gmail.com)\n\nTeleLog - это система аутентификации через Telegram для Django проектов. Проект позволяет пользователям легко и\nбезопасно входить на сайт через свой Telegram аккаунт.\n\n## 🎥 Демонстрация\n\nhttps://github.com/user-attachments/assets/d4307ea9-315d-4978-8366-13712b688e5c\n\n## 📸 Скриншоты\n\n### Страница авторизации\n\n![Auth Screen](https://raw.githubusercontent.com/TheFoxKD/TeleLog/main/assets/TeleLogScreenAuth.jpg)\n\n### Telegram бот с токеном в URL\n\n![Telegram Bot Screen with Token](https://raw.githubusercontent.com/TheFoxKD/TeleLog/main/assets/TeleLogScreenAuthBotWithStartComandAndTokenInUrl.jpg)\n\n### Успешная авторизация в боте\n\n![Telegram Success Screen](https://raw.githubusercontent.com/TheFoxKD/TeleLog/main/assets/TeleLogScreenTelegramSuccess.jpg)\n\n### Неуспешная авторизация в боте\n\n![Telegram Error Screen](https://raw.githubusercontent.com/TheFoxKD/TeleLog/main/assets/TeleLogScreenTelegramError.jpg)\n\n### Панель управления\n\n![Dashboard Screen](https://raw.githubusercontent.com/TheFoxKD/TeleLog/main/assets/TeleLogScreenDashboard.jpg)\n\n## 🚀 Особенности\n\n- 🔐 Безопасная аутентификация через Telegram\n- ⚡ Асинхронная обработка запросов\n- 🔄 Real-time обновление статуса авторизации\n- 🎨 Современный UI с Tailwind CSS\n- 🐳 Docker для разработки\n- ✅ Полное тестовое покрытие\n\n## 🛠 Технический стек\n\n- Python 3.12+\n- Django 5.0+\n- python-telegram-bot 21.0+\n- Redis (кэширование токенов)\n- PostgreSQL\n- Docker \u0026 Docker Compose\n- uv (управление зависимостями)\n- ruff (форматирование)\n- Pytest (тестирование)\n\n## 📦 Установка\n\n1. Клонируйте репозиторий:\n\n```bash\ngit clone https://github.com/TheFoxKD/telelog.git\ncd telelog\n```\n\n2. Создайте .env файлы:\n\n```bash\nmkdir -p .envs/dev\ncp .envs/dev/.django.example .envs/dev/.django\n```\n\n3. Настройте Telegram бота:\n\n- Создайте бота через [@BotFather](https://t.me/BotFather)\n- Добавьте токен в `.envs/dev/.django`:\n\n```bash\nTELEGRAM_BOT_TOKEN='your-token'\nTELEGRAM_BOT_USERNAME='your-bot-username'\n```\n\n4. Запустите через Docker:\n\n```bash\ndocker-compose -f docker-compose.dev.yml up --build\n```\n\n5. Запустите миграции:\n\n```bash\ndocker-compose -f docker-compose.dev.yml run --rm django python manage.py migrate\n```\n\n## 🧪 Тестирование и покрытие кода\n\n```bash\n# Запуск тестов с покрытием\ndocker-compose -f docker-compose.dev.yml run --rm django pytest --cov=src\n\n# Генерация HTML отчета\ndocker-compose -f docker-compose.dev.yml run --rm django pytest --cov=src --cov-report=html\n\n# Отчет в консоли\ndocker-compose -f docker-compose.dev.yml run --rm django pytest --cov=src --cov-report=term-missing\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthefoxkd%2Ftelelog","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fthefoxkd%2Ftelelog","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthefoxkd%2Ftelelog/lists"}