Files
mtusi2026lab2/REPORT.md
T

3.3 KiB
Raw Blame History

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

  • Автор, группа: Евпраксина Эльвира БПИ2304
  • Целевая оценка; 3
  • Commit/PR: TODO после публикации
  • Использованные источники, библиотеки и помощь ИИ: FastAPI, PostgreSQL, Argon2id, Docker Compose.

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

  1. Создать файлы секретов в папке secrets:
    • pg_password.txt (случайный пароль).
    • database_url.txt (postgresql://messenger:ПАРОЛЬ@postgres:5432/messenger). Оба файла должны быть в кодировке UTF-8 (без BOM).
  2. Запуск: docker compose up -d --build
  3. Дождаться статуса healthy у контейнеров (docker compose ps).
  4. Тест API: python tests\smoke.py --base-url http://localhost:8080
  5. Тест сохранности: python tests\resilience.py --mode persistence --action-script scripts/restart.bat --base-url http://localhost:8080
  6. Остановка: docker compose down. Удаление данных: docker compose down -v.

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

  • API: Python 3.12, FastAPI, Uvicorn.
  • БД: PostgreSQL 16.4. Таблицы: users, chats, chat_members, messages, sessions. Настроены PK, FK и каскадное удаление.
  • Аутентификация: Пароли хешируются с помощью Argon2id (argon2-cffi). Сессии хранятся в PostgreSQL (opaque Bearer токен, TTL 3600 секунд).
  • Пагинация: Keyset cursor на основе (created_at, id). Запрашивается limit + 1 запись для проверки наличия следующей страницы.
  • Изменения с lab1: Добавлен password при регистрации, вход через Basic, защищенные методы через Bearer вместо X-User-Id.
  • Переменные: DATABASE_URL_FILE указывает на файл с паролем (Docker secrets).

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

Критерий README Команда/сценарий Наблюдаемый результат Файл доказательства
Публичный smoke python tests\smoke.py --base-url http://localhost:8080 PASS: lab2 public API scenario Скриншот терминала
Сохранность данных python tests\resilience.py --mode persistence --action-script scripts/restart.bat ... PASS: persistence preserved confirmed data Скриншот терминала
Таблицы и ключи migrations/001_init.sql Созданы таблицы с FK и ограничениями Файл миграции
Безопасность сессий Тест в smoke.py 401 Unauthorized при неверном пароле и отзыве Логи API

Ограничения и следующие шаги

  • Приложение запускается в единственном экземпляре, балансировка нагрузки не реализована (требуется на оценку 4).
  • Redis/Valkey не используется, сессии хранятся в PostgreSQL.