# Проект CRUD API для пользователей и постов

Это FastAPI приложение предоставляет REST API для управления пользователями и постами с использованием базы данных PostgreSQL.

## Эндпоинты

### Пользователи

- **POST /users/**  
  Создает нового пользователя на основе предоставленных данных.  
  Тело запроса: `{"name": "string", "email": "string", "password": "string"}`  
  Ответ: `{"id": int, "name": "string", "email": "string"}`

- **GET /users/**  
  Возвращает список всех пользователей.

- **GET /users/{user_id}**  
  Возвращает информацию о пользователе по его ID.

- **PUT /users/{user_id}**  
  Обновляет данные пользователя по его ID.  
  Тело запроса: `{"name": "string", "email": "string", "password": "string"}`

- **DELETE /users/{user_id}**  
  Удаляет пользователя по его ID.

### Посты

- **POST /posts/**  
  Создает новый пост на основе предоставленных данных.  
  Тело запроса: `{"title": "string", "content": "string", "user_id": int}`  
  Ответ: `{"id": int, "title": "string", "content": "string", "user_id": int}`

- **GET /posts/**  
  Возвращает список всех постов.

- **GET /posts/{post_id}**  
  Возвращает информацию о посте по его ID.

- **PUT /posts/{post_id}**  
  Обновляет данные поста по его ID.  
  Тело запроса: `{"title": "string", "content": "string", "user_id": int}`

## Запуск

1. Установите зависимости: `pip install fastapi sqlalchemy psycopg2-binary uvicorn`
2. Настройте базу данных в `database.py`
3. При необходимости задайте постоянный ключ шифрования: `set ENCRYPTION_KEY=<key>` (Windows PowerShell) или `export ENCRYPTION_KEY=<key>` (Linux/macOS)
4. Запустите приложение: `uvicorn main:app --reload`

> По умолчанию приложение сохранит сгенерированный ключ в файле `encryption.key` рядом с `utils.py`.
> Если этот файл удалён или ключ изменён, ранее зашифрованные email-адреса перестанут раскрываться.

## Безопасность и журналирование

- **Хэширование паролей**: Пароли пользователей хэшируются с использованием bcrypt.
- **Шифрование данных**: Email пользователей шифруется в базе данных с использованием Fernet (AES).
- **Защита от SQL-инъекций**: Все запросы параметризованы через SQLAlchemy.
- **Журналирование**: Действия пользователей логируются (создание, обновление и т.д.).

## Структура проекта

- `main.py`: Основное приложение FastAPI с эндпоинтами и журналированием
- `crud.py`: Функции для работы с базой данных
- `models.py`: Модели SQLAlchemy для таблиц
- `schemas.py`: Pydantic схемы для валидации данных
- `database.py`: Настройки подключения к базе данных
- `utils.py`: Утилиты для хэширования и шифрования
- `test_main.py`: Тесты для API и базы данных

## Тестирование

Для запуска тестов установите pytest: `pip install pytest`

Запустите тесты: `pytest test_main.py`

Тесты включают:
- Проверку доступности базы данных
- CRUD операции для пользователей и постов
- Очистку тестовой базы данных