🐍 Python Portfolio — Станислав Смирнов

Портфолио учебных и практических проектов по направлению Python Backend Development.

Здесь собраны проекты, демонстрирующие работу с REST API, базами данных, ORM, асинхронным Python, фоновыми задачами, внешними API, Telegram-ботами, тестированием, CI и проектированием архитектуры программных систем.

---

🏆 Ключевые проекты

1. 🍳 Cookbook API

📁 cookbook-api

Асинхронный REST API для управления рецептами и ингредиентами на FastAPI.

Ключевые особенности:

• ✅ FastAPI REST API
• ✅ Async SQLAlchemy
• ✅ SQLite + aiosqlite
• ✅ Dependency Injection
• ✅ Pydantic validation
• ✅ связи между рецептами и ингредиентами
• ✅ selectinload для оптимизации ORM-запросов
• ✅ автоматический счётчик просмотров
• ✅ сортировка рецептов по популярности и времени приготовления
• ✅ Swagger / OpenAPI
• ✅ интеграционные тесты на pytest
• ✅ GitHub Actions CI
• ✅ flake8, black, isort, mypy

Стек: FastAPI, SQLAlchemy Async, SQLite, aiosqlite, Pydantic, pytest, GitHub Actions

---

2. 🚗 Parking API

📁 parking-api

REST API на Flask для управления клиентами, парковками и парковочными сессиями.

Ключевые особенности:

• ✅ Application Factory
• ✅ Flask-SQLAlchemy
• ✅ SQLAlchemy ORM
• ✅ регистрация клиентов
• ✅ создание парковочных зон
• ✅ контроль свободных мест
• ✅ регистрация заезда и выезда
• ✅ проверка наличия банковской карты при выезде
• ✅ фиксация времени парковочной сессии
• ✅ интеграционные тесты на pytest
• ✅ Factory Boy и Faker
• ✅ изолированная SQLite-база для тестирования

Стек: Flask, Flask-SQLAlchemy, SQLAlchemy, SQLite, pytest, Factory Boy, Faker

---

3. 🤖 Recipe Telegram Bot

📁 recipe-telegram-bot

Итоговый проект курса «Основы Python».

Telegram-бот для поиска рецептов через внешний API с поддержкой русского и английского языков и сохранением истории запросов.

Ключевые особенности:

• ✅ поиск рецептов по названию
• ✅ поиск по ингредиентам
• ✅ интеграция с TheMealDB API
• ✅ поддержка RU / EN
• ✅ FSM для управления состояниями пользователя
• ✅ inline- и reply-клавиатуры
• ✅ хранение истории запросов
• ✅ Peewee ORM
• ✅ SQLite
• ✅ модульная структура проекта

Стек: Python, pyTelegramBotAPI, Peewee ORM, SQLite, Requests, TheMealDB API

---

4. 🖼️ Image Processing Service

📁 image-processing-service

Сервис асинхронной обработки изображений и выполнения фоновых задач.

Ключевые особенности:

• ✅ Celery + Redis
• ✅ асинхронная обработка изображений
• ✅ групповые фоновые задачи
• ✅ Celery Beat
• ✅ Flower для мониторинга
• ✅ обработка изображений через Pillow
• ✅ создание ZIP-архивов
• ✅ отправка результатов по email
• ✅ подписка и отписка пользователей
• ✅ тестирование API

Стек: Flask, Celery, Redis, Flower, Pillow, SQLAlchemy, SMTP

---

5. 🏗️ SportTogether — архитектура программного обеспечения

🔗 sport-together-architecture

Архитектурный проект глобального спортивного приложения, выполненный в рамках финальной работы курса «Архитектор программного обеспечения».

Проект охватывает полный цикл проектирования архитектурного решения: от анализа требований и стейкхолдеров до архитектурных решений, рисков, стоимости владения и подготовки материалов для защиты.

Ключевые особенности:

• ✅ бизнес-цели и функциональные требования
• ✅ анализ стейкхолдеров
• ✅ концептуальная архитектура
• ✅ критические бизнес-сценарии
• ✅ атрибуты качества
• ✅ нефункциональные требования
• ✅ Architecture Decision Records (ADR)
• ✅ сценарии использования
• ✅ архитектурные представления
• ✅ архитектурные диаграммы
• ✅ анализ рисков и компромиссов
• ✅ расчёт стоимости владения
• ✅ план поэтапной реализации
• ✅ презентация архитектурного решения

Артефакты: ADR, NFR, архитектурные диаграммы, сценарии использования, анализ рисков, расчёт стоимости владения, презентация

---

6. 🔄 File Sync Service

📁 file-sync-service

Сервис синхронизации локальной папки с Яндекс Диском через REST API.

Ключевые особенности:

• ✅ рекурсивный обход файлов и вложенных папок
• ✅ загрузка новых и обновление изменённых файлов
• ✅ удаление облачных файлов и папок, отсутствующих локально
• ✅ периодическая синхронизация с настраиваемым интервалом
• ✅ конфигурация через .env, логирование и обработка ошибок
• ✅ разделение приложения, бизнес-логики и инфраструктуры

Стек: Python, Requests, python-dotenv, Loguru, Яндекс Диск API

---

7. 🐦 Twitter Clone Backend

🔗 twitter-clone-backend

Учебный backend корпоративного сервиса микроблогов — итоговый проект Python Advanced.

Ключевые особенности:

• ✅ REST API на FastAPI и авторизация по API-ключу
• ✅ публикация и удаление твитов, лайки, подписки и лента
• ✅ загрузка изображений с проверкой содержимого и прав доступа
• ✅ PostgreSQL, SQLAlchemy и миграции Alembic
• ✅ запуск через Docker Compose, Nginx и готовый интерфейс Vue
• ✅ тесты API на pytest, проверки Ruff и Swagger / OpenAPI

Стек: Python, FastAPI, SQLAlchemy, PostgreSQL, Alembic, Docker Compose, Nginx, pytest, Ruff

---

8. 📊 Django CRM

🔗 django-crm

Веб-приложение для учёта услуг, рекламных кампаний, потенциальных и активных клиентов, а также контрактов.

Ключевые особенности:

• ✅ авторизация на стандартных средствах Django
• ✅ разделы услуг, рекламных кампаний, лидов, контрактов и активных клиентов
• ✅ перевод лида в активного клиента
• ✅ роли оператора, маркетолога и менеджера
• ✅ статистика рекламных кампаний и отношение дохода по контрактам к рекламному бюджету
• ✅ PostgreSQL и запуск через Docker Compose

Стек: Python, Django, PostgreSQL, Docker Compose

---

🛠️ Технологический стек

Категория	Технологии
Язык	Python
Web / API	FastAPI, Flask, Django
Базы данных	SQLite, PostgreSQL
ORM	SQLAlchemy, Flask-SQLAlchemy, Peewee
Асинхронность	Async SQLAlchemy, aiosqlite
Фоновые задачи	Celery, Redis, Celery Beat
Тестирование	pytest, TestClient, Factory Boy, Faker
Code Quality	flake8, black, isort, mypy, Ruff
CI	GitHub Actions
Telegram	pyTelegramBotAPI
Внешние API	REST API, TheMealDB, Яндекс Диск API
Миграции БД	Alembic
Контейнеризация	Docker, Docker Compose, Nginx
Архитектура	ADR, NFR, архитектурные диаграммы, анализ рисков
Инструменты	Git, GitHub, Linux, SSH, VS Code

---

📂 Структура репозитория

python-portfolio/
├── .github/
│   └── workflows/
│       └── cookbook-ci.yml
│
├── certificates/
│   └── README.md
│
├── cookbook-api/
│   └── README.md
│
├── parking-api/
│   └── README.md
│
├── file-sync-service/
│   └── README.md
│
├── image-processing-service/
│   └── README.md
│
├── recipe-telegram-bot/
│   └── README.md
│
├── .gitignore
└── README.md

Каждый backend-проект содержит собственный README с описанием возможностей, архитектуры, структуры проекта и инструкциями по запуску.

Проект Twitter Clone Backend расположен в отдельном репозитории:

github.com/Sarmagon/twitter-clone-backend

Проект Django CRM расположен в отдельном репозитории:

github.com/Sarmagon/django-crm

Архитектурный проект SportTogether расположен в отдельном репозитории:

github.com/Sarmagon/sport-together-architecture

---

⚙️ Continuous Integration

Для проекта Cookbook API настроен GitHub Actions workflow:

.github/workflows/cookbook-ci.yml

При изменениях проекта cookbook-api или самого workflow автоматически выполняются:

• pytest
• flake8
• black
• isort
• mypy

CI запускается для:

cookbook-api/**
.github/workflows/cookbook-ci.yml

Это позволяет автоматически проверять тесты, форматирование, импорты и типизацию кода.

---

🎓 Сертификаты

Курс	Сертификат	Дата
Skillbox — Основы Python. Часть 1	№ SKB0469958	10.02.2026
Skillbox — Основы Python. Часть 2	№ SKB0487169	02.05.2026
GeekBrains / Skillbox Holding — Python-разработчик	№ 2835512	17.06.2026
Skillbox — Архитектор программного обеспечения	№ SKB0505176	22.09.2026
Skillbox — Python Advanced	№ SKB0506025	24.09.2026

Дополнительная информация находится в каталоге certificates.

---

👨‍💻 Об авторе

Станислав Смирнов

📍 Москва, Россия

💻 Python Backend Developer / Junior Backend Developer

🎓 Продолжаю обучение Python и Django

Имею многолетний опыт работы в технической сфере, включая эксплуатацию информационных систем и руководящую работу.

Параллельно с основной профессиональной деятельностью развиваюсь в направлении Backend-разработки на Python и архитектуры программных систем.

В учебных и практических проектах работаю с:

• Python
• REST API
• FastAPI и Flask
• SQLAlchemy и ORM
• асинхронным Python
• SQLite и PostgreSQL
• Docker и Docker Compose
• pytest
• Celery и Redis
• GitHub Actions
• Telegram Bot API
• внешними REST API
• Git и Linux
• проектированием архитектуры
• ADR и NFR
• анализом архитектурных рисков

Ищу возможность развиваться как Junior Python Backend Developer и применять полученные знания в реальных проектах.

---

📞 Контакты

• 📧 Email: stasus.sv@mail.ru
• ✈️ Telegram: @Sarmagon
• 💼 GitHub: github.com/Sarmagon

---

🚀 В развитии

• Python
• REST API
• Flask
• FastAPI
• SQLAlchemy ORM
• Async SQLAlchemy
• pytest
• Celery + Redis
• GitHub Actions
• Telegram Bot API
• основы проектирования архитектуры ПО
• ADR и NFR
• Django
• PostgreSQL
• Docker
• автоматическое развёртывание приложений
• микросервисная архитектура
• RabbitMQ

---

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

Last updated: September 2026