Данила Аринов

Junior-разработчик — OpenAPI и документация

+7 901 431-82-98 · teivrim@gmail.com · Telegram @Smishnyavko · github.com/TeivrimOriginal · Портфолио · LinkedIn

О себе

Документация генерируется из кода, а не ведётся отдельно: схемы запросов и ответов разделены, OpenAPI 3.1 отдаётся из коробки. В двух сервисах суммарно 294 теста — спецификация не разъезжается с поведением.

Опыт работы

Фриланс — заказы на Kwork Python · 2022 — н.в.

Telegram-боты, парсеры сайтов, REST API, интеграции внешних API, автоматизация по ТЗ заказчиков; kwork.ru/user/teivrim.

Проекты

anime-sync-api — REST API каталога аниме FastAPI · PostgreSQL 16 · Alembic · GIN

Асинхронный стек: FastAPI, SQLAlchemy 2.0 (asyncpg), Pydantic v2, httpx. Схемы запросов и ответов разделены.
Три таблицы с внешними ключами и CHECK-ограничениями; UNIQUE (source, external_id) — внешний id уникален в пределах источника, потому что у AniList и Jikan нумерация разная.
Полнотекстовый поиск на tsvector с индексом GIN по названию, оригинальному названию и жанрам. Выражение индекса и выражение запроса вынесены в одну константу, чтобы они не разошлись.
Синхронизация с AniList (GraphQL) и Jikan (REST) на httpx: идемпотентный апсерт без дублей и журнал прогонов — отказ внешнего API пишется в базу, а не роняет запрос.
Список с фильтрами, пагинацией и полнотекстовым поиском; размер страницы ограничен сверху, чтобы нельзя было вытащить всю таблицу одним запросом.

TaskHub API — сервис управления задачами FastAPI · PostgreSQL 17.4 · Celery · Redis

Асинхронный сервис на FastAPI и SQLAlchemy 2.0: asyncpg, Pydantic v2, разделение схем запросов и ответов, OpenAPI 3.1 из коробки.
Аутентификация JWT с ротацией refresh-токенов и RBAC: роли проверяются на уровне зависимости, доступ к эндпоинту нельзя получить без проверки прав.
Фоновые задачи на Celery, Redis как брокер и кэш; задачи выполняются синхронно при CELERY_TASK_ALWAYS_EAGER, поэтому тесты не зависят от воркера.

Навыки

HTTP и API: REST, коды ответов, идемпотентность, JWT с ротацией refresh, RBAC, CORS, фильтрация, пагинация, OpenAPI 3.1, WebSocket Тесты: pytest, pytest-asyncio, httpx ASGITransport, фикстуры, моки внешних API, Allure, Selenium 4, покрытие с ветвлениями CI и качество: GitHub Actions, ruff, mypy strict, pre-commit, gitleaks, clippy -D warnings Python: FastAPI, SQLAlchemy 2.0 async, Pydantic v2, httpx, typing, dataclasses, itertools

Дополнительно

Разделение схем запроса и ответа экономит больше всего: иначе ответ начинает влиять на валидацию входа. Английский — чтение технической документации. Открытый код: 12 активных публичных репозиториев, у каждого проекта тесты и CI.