Files
2026-11-05 17:31:01 +03:00

11 KiB
Raw Permalink Blame History

Отчёт — лабораторная 2

  • Автор, группа: Бондаренко Мария Максимовна, БПИ2302
  • Целевая оценка: 4

Команды запуска и тестов

  1. Создание локального окружения и секретов (.env): cp .env.example .env

  2. Сборка и запуск сервисов: docker compose --env-file .env up -d --build

  3. Ожидание готовности: Приложение будет доступно после того, как все контейнеры перейдут в состояние healthy.

  4. Запуск публичных тестов: Базовый smoke-тест (проверка соответствия OpenAPI) python3 tests/smoke.py --base-url http://localhost:8080 Тест сохранности данных при перезапуске stack python3 tests/resilience.py --mode persistence --action-script scripts/restart.bat --base-url http://localhost:8080

  5. Остановка и очистка: Безопасная остановка без удаления данных: docker compose down Полный сброс тестовых данных (удаление volumes): docker compose down --volumes

Архитектура и решения

Схема процессов и хранилищ +-----------------------+ | FastAPI Application | | (Container) | +-----------+-----------+ | +-------------------------+-------------------------+ | | v v +-------------------+ +-------------------+ | PostgreSQL | | Redis | | (Container) | | (Container) | | - Users | | - Sessions | | - Chats | | (Key: | | - Chat Members | | session: | | - Messages | | TTL: 3600s) | +-------------------+ +-------------------+

Источник истины и роль Redis

PostgreSQL -- реляционный источник истины для пользователей, структуры чатов, членства и текстов сообщений Redis 7 -- хранилище оперативных сессий с авто-истечением по TTL. Сессии хранятся по ключу session: со значением user_id. Для обеспечения сохранности сессий при перезапуске сервисов в compose.yaml включена RDB-персистентность (redis-server --save 60 1) и подключен persistent volume redisdata.

Транзакционные границы и безопасность

Атомарность: Создание чатов и привязка участников выполняются в единой SQL-транзакции (conn.commit() при успехе, conn.rollback() при ошибке). Для предотвращения гонки при регистрации одинакового username используется обработка исключения psycopg2.errors.UniqueViolation с откатом транзакции (rollback). Хеширование паролей: Использован KDF bcrypt с генерацией соли для предотвращения утечки незашифрованных паролей Безопасные запросы: Все SQL-запросы параметризованы (используются кортежи %s), что исключает возможность SQL-инъекций Миграции: Файл migrations/init.sql монтируется в /docker-entrypoint-initdb.d/init.sql контейнера PostgreSQL для чистой инициализации структуры БД при старте. Дополнительно init_db() в Python обеспечивает идемпотентный fallback. Таблица sessions была удалена из PostgreSQL, так как на оценку 4 источником истины для сессий является Redis

Оптимизация пагинации сообщений

В запросе GET /api/v1/chats/{chat_id}/messages реализован курсорный подход на уровне SQL: SELECT id, chat_id, sender_id, text, created_at FROM messages WHERE chat_id = %s AND (created_at, id) > (%s, %s) ORDER BY created_at ASC, id ASC LIMIT %s; Пагинация опирается на составной индекс idx_messages_chat_pagination (chat_id, created_at, id), исключая необходимость полного сканирования таблицы

Доказательство эффективности индекса (EXPLAIN ANALYZE)

Для проверки пагинации было сгенерировано 10 000 сообщений. Запрос второй страницы (с курсором) показывает, что используется Index Scan, база читает ровно 50 строк (LIMIT) и не тратит время на полную сортировку таблицы.

Проверка: docker compose exec postgres psql -U postgres -d messenger

INSERT INTO users (id, username, display_name, password_hash, created_at) VALUES ('11111111-1111-1111-1111-111111111111', 'testuser', 'Test', 'hash', NOW());

INSERT INTO chats (id, title, created_at) VALUES ('22222222-2222-2222-2222-222222222222', 'Test Chat', NOW());

INSERT INTO messages (id, chat_id, sender_id, text, created_at)
SELECT 
    gen_random_uuid(), 
    '22222222-2222-2222-2222-222222222222', 
    '11111111-1111-1111-1111-111111111111', 
    'Message ' || i, 
    NOW() + (i || ' seconds')::interval
FROM generate_series(1, 10000) AS i;

SET enable_bitmapscan = off;

Вывод в консоли: Limit (cost=0.28..16.34 rows=3 width=572) (actual time=0.018..0.025 rows=50 loops=1) Buffers: shared hit=3 -> Index Scan using idx_messages_chat_pagination on messages (cost=0.28..16.34 rows=3 width=572) (actual time=0.017..0.022 rows=50 loops=1) Index Cond: ((chat_id = '22222222-2222-2222-2222-222222222222'::uuid) AND (ROW(created_at, id) > ROW('2026-11-05 13:00:00+00'::timestamp with time zone, '00000000-0000-0000-0000-000000000000'::uuid))) Buffers: shared hit=3 Planning: Buffers: shared hit=22 Planning Time: 0.272 ms Execution Time: 0.085 ms (9 rows)

Вывод: время выполнения составило 0.085 мс, прочитано всего 3 страницы буферов, что доказывает отсутствие полного сканирования таблицы

Доказательства критериев

Критерий README Команда/сценарий Наблюдаемый результат Файл доказательства
Публичный smoke python3 tests/smoke.py --base-url http://localhost:8080 PASS: lab2 public API scenario; infrastructure and grading evidence remain separate. Логи терминала
Сохранение данных python3 tests/resilience.py --mode persistence --action-script scripts/restart.bat --base-url http://localhost:8080 (Для сред Linux/Mac предусмотрен эквивалентный скрипт scripts/restart.sh) PASS: persistence preserved confirmed data and existing session. Hook scope needs operator evidence. scripts/restart.bat / restart.sh
Использование Redis для сессий Проверка ключей через docker compose exec redis redis-cli keys "session:*" Ключи сессий присутствуют в Redis с корректным TTL app.py, compose.yaml
Изоляция чужих чатов tests/smoke.py (запрос GET /api/v1/chats/{id} чужим пользователем) Возвращается статус 404 not_found без раскрытия факта существования app.py (get_chat)
Обработка ошибок валидации Запрос с некорректными полями / незаполненными строками Возвращается 400 invalid_request с заголовком X-Request-Id app.py (validation_exception_handler)
Обработка недоступности Redis Остановка контейнера redis (docker compose stop redis) /health/ready возвращает 503, бизнес-эндпоинты не пускают анонимов app.py (health_ready, get_current_user_from_token)

Эксперименты и отказы

Воздействие Что ожидаем Что наблюдали Время восстановления / потеря данных
docker compose restart (в рамках test-persistence) Сохранение пользователей, сообщений в Postgres и сессий в Redis. Все запросы со старым Bearer-токеном продолжают успешно работать. 0 сек потери данных, восстановление ~4-5 сек (время старта контейнеров)
Неверный пароль при входе 401 Unauthorized с заголовком WWW-Authenticate: Basic ... Возвращен 401 и корректный challenge header Мгновенно (0 сек)
Отключение контейнера Redis Приложение определяет падение зависимости на /health/ready и блокирует доступ с ошибкой 503 GET /health/ready вернул 503 Database or Redis unavailable Восстановление происходит автоматически при старте Redis

Ограничения и следующие шаги

В текущей реализации соединение с PostgreSQL создается на каждый запрос (psycopg2.connect), а не через пул соединений. Для production следует использовать psycopg2.pool или ORM Redis настроен с базовым RDB-снапшотом (раз в 60 секунд). При аппаратном сбое возможна потеря сессий, созданных за последнюю минуту