# Отчёт — лабораторная 2 Каменский Андрей Игоревич, БПИ2301. Целевая оценка — **4**, трек на 5 не выполнял. Изменения пока локальные, PR не создан. ## Запуск Нужны Docker с Compose и Python 3.9+ для публичных проверок. Образы: Python 3.13.0, PostgreSQL 16.6, Redis 7.4.2; зависимости закреплены в requirements.txt. ```sh 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](evidence/lab2-checks.txt) | | Полный restart API, PostgreSQL и Redis | StartedAt изменился у всех; прежний токен читает прежние данные | [persistence](evidence/lab2-persistence.txt) | | Миграции с нуля, повтор upgrade и alembic check | Схема создаётся, повтор не меняет данные | [alembic](evidence/lab2-alembic.txt) | | Rollback создания чата | FK-ошибка откатывает чат и участников | [database](evidence/lab2-database.txt) | | 6 регистраций одного username | Один 201, пять 409 | [verification](evidence/lab2-verification.txt) | | Неверный пароль, logout, TTL=2 | Отказ во входе; отозванный/истёкший токен получает 401 | [verification](evidence/lab2-verification.txt) | | Кэш и отказы Redis/PostgreSQL | Профиль восстанавливается при промахе; при отказах — ограниченные 503 без обхода авторизации | [verification](evidence/lab2-verification.txt) | | 10 клиентов × 10 сообщений | Прочитано 100 уникальных сообщений без потерь | [verification](evidence/lab2-verification.txt) | | Некорректные поля, JSON и курсоры | Запросы отклоняются; чужие данные не раскрываются | [negative](evidence/lab2-negative.txt) | ## Индекс и ограничения На 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](evidence/lab2-database.txt). Проверки выполнены на 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.