Files
2026-10-22 18:10:52 +03:00

6.6 KiB
Raw Permalink Blame History

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

Каменский Андрей Игоревич, БПИ2301. Целевая оценка — 4, трек на 5 не выполнял. Изменения пока локальные, PR не создан.

Запуск

Нужны Docker с Compose и Python 3.9+ для публичных проверок. Образы: Python 3.13.0, PostgreSQL 16.6, Redis 7.4.2; зависимости закреплены в requirements.txt.

cp compose.env.example .env
# В .env задать POSTGRES_PASSWORD.
docker compose up -d --build --wait
make check
make test
make test-persistence ACTION_SCRIPT=scripts/restart.sh

API и Swagger: http://localhost:8080/docs. Если порт занят, нужно экспортировать APP_PORT=8081 и передать тестам BASE_URL=http://localhost:8081. Миграции Alembic выполняет сервис migration до старта API. Повторный запуск миграций безопасен.

Для проверки OpenAPI: установить requirements-dev.txt и выполнить make validate. Остановка с сохранением данных — docker compose down; намеренный сброс учебных данных — docker compose down --volumes.

Что сделал

Сохранил структуру прошлой лабы: роутеры → сервисы → репозитории, DTO на dataclass. Данные из памяти перенёс в PostgreSQL через SQLAlchemy. Таблицы users, chats, chat_members и messages имеют ключи, ограничения и индексы. Схема версионируется Alembic, текущая ревизия — 003. Чат и участники создаются одной транзакцией, COMMIT выполняется до ответа 201.

Пароли хешируются Argon2id. Вход — Basic без тела, остальные запросы — Bearer. Redis хранит сессии с абсолютным expiry и TTL, logout удаляет ключ. Профили кэшируются отдельно на 60 секунд; история читается из PostgreSQL. Сессии и данные переживают restart благодаря именованным volumes и Redis AOF с appendfsync always.

Настройки находятся в AppSettings. Пул PostgreSQL — 10 соединений без overflow, таймауты — 5 секунд; Redis — 10 соединений, connect/read timeout по 0.3 секунды. Секреты передаются через исключённый из Git .env. Исходный .env.example оставлен как в задании; для реализации используется compose.env.example.

Проверки

Основные проверки сделаны до переноса кода из mtusi2026lab1; поэтому это имя встречается в логах. В новом репозитории отдельно прошли сборка и публичный smoke на 8081. Контракт и исходные тесты не менялись; дополнительные тестовые файлы не переносились.

Проверка Результат Evidence
make check validate test Публичный сценарий пройден checks
Полный restart API, PostgreSQL и Redis StartedAt изменился у всех; прежний токен читает прежние данные persistence
Миграции с нуля, повтор upgrade и alembic check Схема создаётся, повтор не меняет данные alembic
Rollback создания чата FK-ошибка откатывает чат и участников database
6 регистраций одного username Один 201, пять 409 verification
Неверный пароль, logout, TTL=2 Отказ во входе; отозванный/истёкший токен получает 401 verification
Кэш и отказы Redis/PostgreSQL Профиль восстанавливается при промахе; при отказах — ограниченные 503 без обхода авторизации verification
10 клиентов × 10 сообщений Прочитано 100 уникальных сообщений без потерь verification
Некорректные поля, JSON и курсоры Запросы отклоняются; чужие данные не раскрываются negative

Индекс и ограничения

На 10000 сообщениях проверил глубокую страницу истории через EXPLAIN (ANALYZE, BUFFERS). Запрос использует курсор (created_at,id) и LIMIT, индекс — (chat_id,created_at,id). PostgreSQL прочитал 51 строку для страницы из 50: Index Scan, shared hit=9, Execution Time=0.017 ms. Исследовательские данные откатил. Вывод — database.

Проверки выполнены на ARM64/macOS, Docker 28.5.1 и Compose 2.40.0. Docker доступно 10 CPU и около 7.65 GiB RAM; отдельных квот контейнерам не задавал. Это локальная функциональная проверка: RPS, p95/p99 и время восстановления отдельно не измерял.

Стенд учебный: один экземпляр каждого сервиса, локальный HTTP, нет HA, backup/restore и защиты от перебора. Потеря volumes не покрывается обычным restart. При недоступном Redis нельзя подтвердить сессию; без PostgreSQL недоступны чаты, но прогретый профиль может читаться из Redis. Между страницами нет общего snapshot, а запрос, авторизованный до logout, может завершиться.

Источники: задание, contracts/README.md, OpenAPI и документация FastAPI, SQLAlchemy, Alembic, Redis и argon2-cffi.