Высокопроизводительное и архитектурно чистое REST API ядро, спроектированное по принципам Clean Architecture. Проект полностью контейнеризирован и оптимизирован для мгновенного локального развертывания или продакшен-деплоя. Этот шаблон разработан как универсальный Enterprise-фундамент (Система управления пользователями) для кастомных CRM, маркетплейсов, мобильных бэкендов и SaaS-платформ, что исключает необходимость писать базовую логику с нуля.
Архитектурные особенности и технологии
1. Clean Architecture: Четкое распределение ответственности. Бизнес-модели SQLAlchemy вынесены в корень бэкенда, CRUD-логика изолирована в паттерне Repository, а валидация данных возложена на схемы Pydantic v2. Это исключает кашу в коде и упрощает масштабирование.
2. Безопасность на UUID v7: Все сущности в базе данных используют современные, упорядоченные по времени идентификаторы UUID v7. Это защищает систему от перебора инкрементных ID (1, 2, 3), скрывает реальный объем данных от конкурентов и ускоряет индексацию в PostgreSQL по сравнению со старыми UUID v4.
3. Продвинутая ролевая модель доступа: Реализовано жесткое разграничение прав (Администратор / Автор / Пользователь) через зависимости FastAPI. Защита роутов работает на уровне авторизации JWT Bearer.
4. Автоматизация развертывания (CI/CD Ready): Встроенный контейнерный скрипт автоматизирует деплой. При старте контейнера Docker самостоятельно контролирует доступность PostgreSQL, автоматически накатывает пошаговые миграции Alembic и запускает скрипт сидирования базы данных для автоматического создания или обновления прав суперадмина.
5. Нативная спецификация API: Документация Swagger UI и ReDoc генерируется автоматически на основе типов Python и схем Pydantic. Пути REST-эндпоинтов обеспечивают бесконфликтную генерацию фронтенд-типов через Orval/OpenAPI-codegen.
6. Оптимизация запросов (N+1 Fixed): Все связанные сущности загружаются через жадное загрузку (joinedload) на уровне репозиториев. Это снижает нагрузку на СУБД, устраняет ошибки detached instance при работе многопроцессных воркеров Uvicorn на проде и сокращает время ответа API.
Доступная спецификация эндпоинтов
Архитектурные особенности и технологии
1. Clean Architecture: Четкое распределение ответственности. Бизнес-модели SQLAlchemy вынесены в корень бэкенда, CRUD-логика изолирована в паттерне Repository, а валидация данных возложена на схемы Pydantic v2. Это исключает кашу в коде и упрощает масштабирование.
2. Безопасность на UUID v7: Все сущности в базе данных используют современные, упорядоченные по времени идентификаторы UUID v7. Это защищает систему от перебора инкрементных ID (1, 2, 3), скрывает реальный объем данных от конкурентов и ускоряет индексацию в PostgreSQL по сравнению со старыми UUID v4.
3. Продвинутая ролевая модель доступа: Реализовано жесткое разграничение прав (Администратор / Автор / Пользователь) через зависимости FastAPI. Защита роутов работает на уровне авторизации JWT Bearer.
4. Автоматизация развертывания (CI/CD Ready): Встроенный контейнерный скрипт автоматизирует деплой. При старте контейнера Docker самостоятельно контролирует доступность PostgreSQL, автоматически накатывает пошаговые миграции Alembic и запускает скрипт сидирования базы данных для автоматического создания или обновления прав суперадмина.
5. Нативная спецификация API: Документация Swagger UI и ReDoc генерируется автоматически на основе типов Python и схем Pydantic. Пути REST-эндпоинтов обеспечивают бесконфликтную генерацию фронтенд-типов через Orval/OpenAPI-codegen.
6. Оптимизация запросов (N+1 Fixed): Все связанные сущности загружаются через жадное загрузку (joinedload) на уровне репозиториев. Это снижает нагрузку на СУБД, устраняет ошибки detached instance при работе многопроцессных воркеров Uvicorn на проде и сокращает время ответа API.
Доступная спецификация эндпоинтов