Files
mtusi2026lab2-fork/REPORT.md

4.6 KiB
Raw Permalink Blame History

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

  • Автор и группа — Samodurov Nikita, bpi2303
  • Целевая оценка — 4
  • Источники — материалы и контракт курса.
  • Использование ИИ — консультации и проверки ИИ.

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

Нужны Docker Engine с Compose v2 и Python 3.9+ на хосте. Контейнер использует Python 3.13.5. По умолчанию API доступен на http://127.0.0.1:8080. При занятом порте задайте PUBLIC_PORT и соответствующий BASE_URL. Команда setup создаёт локальные .env и secrets/.

python scripts/setup.py
make check
docker compose config --quiet
docker compose build migrate
docker compose up -d --wait
make test
make test-persistence ACTION_SCRIPT=scripts/restart.sh
python student-tests/check_dependencies.py
docker compose exec -T db psql -U messenger -d messenger < student-tests/explain.sql
docker compose down

В Windows PowerShell используйте следующие проверки после запуска стенда. Перед проверками установите $env:PYTHONUTF8 = '1'.

python scripts/check_contract.py
python tests/smoke.py
python tests/resilience.py --mode persistence --action-script scripts/restart.cmd
python student-tests/check_dependencies.py
Get-Content student-tests/explain.sql -Raw | docker compose exec -T db psql -U messenger -d messenger

Для полной валидации контракта установите requirements-dev.txt в отдельное окружение и выполните python scripts/validate_openapi.py. Команда docker compose down оставляет именованные тома. Для намеренного сброса учебных данных выполните docker compose down -v.

Архитектура

Из ЛР 1 перенесены HTTP-обработчик, проверки полей, логика доступа и курсорная пагинация. Стенд состоит из API, PostgreSQL и Redis. Пароли хешируются scrypt с индивидуальной солью. В PostgreSQL хранится SHA-256 от случайного 256-битного токена. Срок сессии проверяется по часам PostgreSQL. Заголовок X-User-Id не участвует в аутентификации.

Уникальность username обеспечивает индекс PostgreSQL. Чат и его участники записываются в одной транзакции. Внешние ключи не допускают участников вне списка пользователей и сообщения от пользователя вне чата. SQL использует параметры. Пул ограничен восемью соединениями на процесс, ожидание свободного соединения ограничено 1,5 с, выполнение SQL — 3 с.

PostgreSQL остаётся источником истины. После проверки сессии запрос к /users/me может взять неизменяемый профиль из Redis с TTL 300 с. При задержке свыше 350 мс API читает профиль из PostgreSQL. Очередь кэша ограничена четырьмя операциями. Изменение профиля не входит в API этой работы.

История использует составной индекс (chat_id, created_at, id) и курсор по паре (created_at, id). Подпись курсора проверяется общим ключом из secrets. Между страницами возможны конкурентные вставки, поэтому обход не фиксирует снимок истории. Поздно закоммиченная запись с ключом до курсора видна при новом обходе.

Проверки

Результаты локального Docker-стенда и команды приведены в evidence/local-checks.txt.

Ограничения

При остановке PostgreSQL защищённый API недоступен. При отключении Redis профили читаются из PostgreSQL. Рестарт сохраняет данные и активные сессии при сохранённом томе pgdata.