forked from mtusi2026/mtusi2026lab2
55 lines
6.6 KiB
Markdown
55 lines
6.6 KiB
Markdown
# Отчёт — лабораторная 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.
|