FastAPI

Зачем для UCP. FastAPI — механика Python-биндинга UCP-сервиса, как Spring для Java: без понимания Depends, Pydantic, async, сессий и безопасности нельзя осознанно писать Handler-ы и интегрировать инфраструктуру на Python. Часть пути продукт-инженера.

Раздел разбит на 11 статей. Можно читать подряд (фундамент → конкурентность и сквозная логика → данные и безопасность → эксплуатация) или точечно.

Фундамент

1. Структура приложения и конфигурация — FastAPI(), APIRouter, lifespan, pydantic-settings, раскладка проекта.
2. Dependency Injection: Depends — дерево зависимостей, yield-зависимости, переопределение в тестах.
3. Роутинг и обработка запросов — path operations, параметры, response_model, статус-коды.
4. Pydantic: валидация и сериализация — модели v2, валидаторы, ошибки, модели запроса и ответа.

Конкурентность и сквозная логика

5. Async и конкурентность — async def vs def, threadpool, async-клиенты, ловушки event loop.
6. Middleware и обработка ошибок — middleware, обработчики исключений, сквозная логика.
7. Фоновые задачи и расписание — BackgroundTasks и его границы, внешняя очередь/планировщик.

Данные и безопасность

8. Персистентность: SQLAlchemy + Alembic — async-сессии, транзакции, миграции.
9. Безопасность — OAuth2, JWT, зависимости-как-guards, scopes.

Эксплуатация

10. Тестирование — TestClient/httpx, pytest, фикстуры, переопределение зависимостей.
11. Наблюдаемость — логи, OpenTelemetry, метрики, health-checks.

Связанное

• Продукт-инженер — карта специализаций и путь.
• Use Case Pattern (обзор) — методология, которую реализует этот стек.