Files
mtusi2026lab2/.github/pull_request_template.md
T

3.0 KiB

Лабораторная 2

Автор / группа: Евпраксина Эльвира БПИ2304 Целевая оценка (3/4/5): 3 Трек 5, если заявлен: Не заявлен

Что реализовано и что перенесено: Реализован API на Python 3.12 (FastAPI + Uvicorn). Данные перенесены в PostgreSQL (users, chats, chat_members, messages, sessions). Добавлена версионируемая миграция 001_init.sql. Пароли хешируются через Argon2id. Реализована выдача opaque Bearer-сессий с TTL, сохранение сессий в БД переживает рестарт. Обновлена пагинация сообщений (keyset cursor на created_at и id).

Команды запуска из чистого clone:

  1. Создать в папке secrets файлы (в кодировке UTF-8): pg_password.txt (пароль) и database_url.txt (postgresql://messenger:ПАРОЛЬ@postgres:5432/messenger).
  2. Выполнить docker compose up -d --build.
  3. Дождаться статуса (healthy).
  4. Запустить python tests/smoke.py --base-url http://localhost:8080.

Результаты проверок и ссылка на REPORT.md:

  • smoke.py -> PASS: lab2 public API scenario; infrastructure and grading evidence remain separate.
  • resilience.py (с кастомным скриптом scripts/restart.bat для Windows) -> PASS: persistence preserved confirmed data and existing session.
  • Подробный отчет находится в файле REPORT.md.

Ограничения / известные ошибки: Оценка 3. Не реализован Redis/Valkey (сессии в PostgreSQL). Нет балансировщика (требуется для лабы 3). Проверка сохранности на Windows выполнена через .bat обертку из-за специфики subprocess и chmod в NTFS.

Источники и использование ИИ: Официальная документация FastAPI, PostgreSQL, psycopg3, argon2-cffi. Использование ИИ: помощь в написании boilerplate-кода подключения к БД, настройке Docker Compose и обхода багов пагинации.

  • Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами.
  • Контракт и публичные тесты не ослаблены.
  • make check и make test выполнены; приложен реальный вывод.
  • Сценарии отказов/безопасности своего уровня воспроизведены.
  • Все секреты и приватные ключи находятся вне Git; отчёт не содержит tokens.
  • README задания сохранён, REPORT.md содержит инструкцию именно моего решения.