Files
mtusi2026lab2-fork/REPORT.md
2026-10-30 11:07:02 +03:00

5.0 KiB
Raw Permalink Blame History

Запуск из чистого clone

cp .env.example .env
docker compose --env-file .env config --quiet
docker compose --env-file .env up -d --build
curl http://localhost:8080/health/ready
make test
make test-grade4

Для повторной проверки сохранности:

chmod +x scripts/restart.sh
make test-persistence ACTION_SCRIPT=scripts/restart.sh

Для остановки без удаления данных:

docker compose --env-file .env down

Намеренное удаление учебных данных выполняется отдельно и осознанно командой docker compose down -v.

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

Spring Boot API работает от имени непривилегированного пользователя 10001. PostgreSQL является источником истины для таблиц users, chats, chat_members и messages. Flyway применяет версионируемую миграцию V1__messenger.sql при старте. Создание чата и участников выполняется одной @Transactional операцией; уникальность username дополнительно гарантируется ограничением PostgreSQL.

Пароль при регистрации не возвращается и хранится как SCrypt-хеш. POST /api/v1/auth/sessions принимает только Basic username:password, создаёт случайный 256-битный opaque Bearer-токен и сохраняет его в Redis с TTL SESSION_TTL_SECONDS. Redis включён с AOF и named volume, поэтому действующие сессии переживают проверяемый рестарт. Logout удаляет ключ сессии. Бизнес-endpoint используют только Bearer; X-User-Id игнорируется.

История использует keyset-запрос по (chat_id, created_at, id) с индексом idx_messages_chat_created_id. Страница получает limit + 1 строк, а cursor кодируется и подписывается HMAC. PostgreSQL ограничен пулом из 4 соединений; socketTimeout и statement_timeout ограничены 1 секундой, а серверный deadline DB-операции — 2 секундами. При недоступности PostgreSQL или Redis API возвращает ограниченную ошибку 503 unavailable.

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

Критерий Команда/сценарий Наблюдаемый результат Доказательство
Контракт и структура make check PASS
Публичный API make test BASE_URL=http://localhost:8080 PASS: lab2 public API scenario
Сохранность make test-persistence ACTION_SCRIPT=scripts/restart.sh PASS: data and existing session preserved
Basic/Bearer, logout, rollback, race make test-grade4 PASS: собственный Python-тест
Истечение TTL SESSION_TTL_SECONDS=2 docker compose --env-file .env up -d --force-recreate api + make test-grade4-expiry PASS: expired session returns 401 student-tests/lab2.py
Недоступность Redis make test-grade4-redis PASS: API returns 503 student-tests/lab2.py
Недоступность PostgreSQL make test-grade4-postgres PASS: API returns 503 student-tests/lab2.py
PostgreSQL history index EXPLAIN (ANALYZE, BUFFERS) для запроса истории на 10 000 синтетических сообщениях Index Scan using idx_messages_chat_created_id, 50 строк за 0.084 ms evidence/index-explain.txt
Непривилегированный контейнер docker compose ps, docker exec ... id -u UID 10001 Dockerfile

Собственные проверки

student-tests/lab2.py проверяет неверный пароль и Basic challenge, запрет Basic на бизнес-запросах, игнорирование X-User-Id, rollback неудачного создания чата, гонку десяти регистраций одинакового username, logout, короткий TTL и ответы 503 при остановке Redis или PostgreSQL.

Ограничения

Это учебный локальный стенд с синтетическими данными. TLS, балансировщик и несколько API-реплик относятся к следующим лабораторным. Redis используется только для сессий; PostgreSQL остаётся источником истины предметных данных. make load показывает closed-loop HTTP-метрики и не является полноценным capacity benchmark.