Backend Architecture (FastAPI PostgreSQL) markdown Copy Edit

Backend Architecture — FastAPI + PostgreSQL

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

• FastAPI — быстрый Python фреймворк для API.
• PostgreSQL — реляционная база данных.
• SQLAlchemy — ORM для работы с БД.
• Pydantic — валидация данных и сериализация.
• Alembic — миграции базы данных.
• JWT — авторизация и аутентификация.

2. Структура проекта

app/ api/ # Маршруты API core/ # Настройки, конфигурация models/ # SQLAlchemy модели schemas/ # Pydantic схемы services/ # Логика (работа с БД, бизнес-правила) db/ # Подключение и миграции tests/ # Тесты

3. Поток данных

1. Клиент (Next.js) отправляет запрос к API (REST или GraphQL).
2. FastAPI принимает запрос, проверяет авторизацию (JWT).
3. Сервисный слой обрабатывает данные и обращается к базе через SQLAlchemy.
4. Ответ возвращается в формате JSON.
5. Pydantic гарантирует валидацию и правильный формат.

4. Принципы

• Чистая архитектура — разделяем слои (API, сервисы, модели).
• DRY — без дублирования кода.
• Testable — легко тестировать каждый слой.