6.6 KiB
Отчёт — лабораторная 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.