flins_info

О проекте

flins — это набор примеров тестовых вопросов и заданий для подготовки к техническим собеседованиям по Python. Проект помогает разработчикам практиковаться и улучшать навыки решения типичных задач, которые часто встречаются на технических интервью.

Основные возможности

📝 Сборник вопросов и заданий для технических вопросов по Python
🤖 Telegram-бот с удобным интерфейсом для тренировки
🚀 REST API для интеграции с другими системами
⚙️ Web-панель администратора для управления контентом

Telegram-бот и навигация

Telegram-бот предоставляет удобный интерфейс для тренировки вопросов прямо в мессенджере.

Основные команды бота:

Команда	Описание
`/start`	Начать работу с ботом

Функциональность бота

Главное меню

Интерактивные кнопки для навигации
Быстрый доступ к основным функциям

Режим тренировки

Пошаговое прохождение вопросов
Возможность просмотра ответов
Навигация между вопросами (следующий вопрос/предыдущий вопрос)

Работа с категориями

Выбор интересующей категории вопросов

Быстрая тренировка

Функция получения 5 случайных вопросов
Идеально для коротких сессий повторения
Вопросы из разных категорий для комплексной проверки

Бот идеально подходит для регулярной практики “на ходу” и позволяет эффективно готовиться к собеседованиям в любое удобное время.

Стек технологий

Backend: FastAPI, Uvicorn, SQLAlchemy ORM
Database: PostgreSQL, asyncpg, Alembic (миграции)
Telegram Integration: python-telegram-bot / aiogram
DevOps: Docker, Docker Compose
Security: JWT, Passlib, Bcrypt
Testing: Pytest, pytest-asyncio
Admin Panel: SQLAdmin
Code Quality: Ruff, Loguru

Интерфейсы взаимодействия

1. REST API

Основной интерфейс для работы с вопросами и ответами
Документация доступна по адресу /docs (Swagger UI)
Альтернативная документация: /redoc (ReDoc)
Возможность получения 5 случайных вопросов для быстрого тестирования

2. Telegram Bot

Удобный интерфейс для тренировки прямо в Telegram
Команды для навигации по вопросам
Функция запроса 5 случайных вопросов для тренировки

3. Web Admin Panel

SQLAdmin интерфейс для управления вопросами и категориями
Доступ по адресу /admin
Управление пользователями и данными

Конфигурация переменных окружения

Локальная разработка (.env файл)

# Database
DATABASE_URL=postgresql+asyncpg://user:password@db:5432/postgres_db
POSTGRES_DB=postgres_db
POSTGRES_USER=postgres_user
POSTGRES_PASSWORD=your_secure_password
POSTGRES_HOST=db
POSTGRES_PORT=5432

# Security
SECRET_KEY=your_secret_key_here
ALGORITHM=HS256

# Telegram Bot
TELEGRAM_BOT_TOKEN=your_telegram_bot_token
TELEGRAM_ADMIN_ID=your_telegram_user_id

# Admin Accounts
ADMIN1_EMAIL=admin1@example.com
ADMIN2_EMAIL=admin2@example.com
ADMIN_PASSWORD=secure_admin_password

Production переменные (GitHub Secrets)

В GitHub Actions для CI/CD добавить Secrets:

DOCKER_PASSWORD - пароль от Docker Hub
DOCKER_USERNAME - логин от Docker Hub
HOST - IP-адрес или домен сервера для деплоя (например: 123.123.123.123)
SSH_KEY - приватный SSH-ключ для подключения к серверу
SSH_PASSPHRASE - парольная фраза для SSH-ключа
TELEGRAM_TO - ID чата Telegram для уведомлений о деплое
TELEGRAM_TO2- ID чата Telegram для уведомлений о деплое
USER - имя пользователя для SSH-подключения к серверу

Шаг 1: Подготовка сервера

Обновление пакетов и установка Docker

# Обновите список пакетов
sudo apt update
sudo apt upgrade -y

# Установите curl (если не установлен)
sudo apt install -y curl

# Загрузите скрипт установки Docker
curl -fSL https://get.docker.com -o get-docker.sh

# Запустите скрипт установки
sudo sh ./get-docker.sh

# Установите Docker Compose plugin
sudo apt install -y docker-compose-plugin

# Удалите скрипт (опционально)
rm get-docker.sh

Подготовка файлов конфигурации

# Скопируйте пример env файла
cp .env.example .env

# Откройте файл для редактирования
nano .env

Шаг 2: Конфигурация Nginx

Установка Nginx (если не установлен)

sudo apt install -y nginx

Создание конфиг-файла для вашего домена

# Создайте новый конфиг файл, пример представлен ниже
sudo nano /etc/nginx/sites-available/

Развертывание с Nginx (Reverse Proxy)

Скопируйте на сервер 3 файла:

docker-compose.yml
.env (предварительно заполненный)
nginx.conf

Запустите команду:

docker-compose up -d

Важно: В текущей конфигурации приложение работает только по HTTP. Для production использования с HTTPS потребуется дополнительная настройка SSL сертификатов.

server {
    listen 80;
    server_name yourdomain.com;

    location / {
        proxy_pass http://127.0.0.1:8000;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }

    location /admin {
        proxy_pass http://127.0.0.1:8000/admin;
        proxy_set_header Host $host;
    }
}

Проверка работоспособности

# API доступен
curl http://your-server:8000/docs

# Telegram Bot получает обновления
# (убедитесь, что firewall пропускает исходящие HTTP запросы)

# Admin панель
http://your-server:8000/admin