Files
mtusi2026lab2/REPORT.md
T
garikandCopilot bfb3c93584
Skeleton contracts / contracts (pull_request) Canceled after 0s
ЛР 2 — БПИ2304 — Варданян — на 3
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-10-30 16:27:03 +03:00

4.5 KiB
Raw Blame History

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

  • Автор, группа: Варданян Гарик, БПИ2304
  • Целевая оценка: 3
  • Commit/PR: TODO после публикации
  • Использованные источники, библиотеки и помощь ИИ: контракт contracts/openapi.json, семантика contracts/README.md, README.md, стандартная библиотека Python 3.9+

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

cd C:\Users\vipar\Desktop\mtusi2026lab2
$env:APP_HOST = "127.0.0.1"
$env:APP_PORT = "8080"
$env:SESSION_TTL_SECONDS = "3600"
py -3 server.py

В другом окне:

py -3 tests\smoke.py --base-url http://127.0.0.1:8080

Пример Docker:

docker build -t mtusi-lab2:latest .
docker run --rm -d -p 8080:8080 --name mtusi-lab2 mtusi-lab2:latest

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

Реализация работает как учебный HTTP API на базе ThreadingHTTPServer. Состояние хранится в памяти процесса, но введена новая схема аутентификации: POST /api/v1/users принимает пароль, затем POST /api/v1/auth/sessions использует Basic-авторизацию и возвращает opaque Bearer токен. Все защищённые endpoint требуют Authorization: Bearer <token>. Сессии хранятся в памяти и имеют TTL по SESSION_TTL_SECONDS, а DELETE /api/v1/auth/sessions/current отзывает текущую сессию.

Пароли хешируются через PBKDF2-HMAC-SHA256 с nonce-солью. Данные о пользователях, чатах и сообщениях хранятся в словарях, а запросы защищены RLock.

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

Критерий README Команда/сценарий Наблюдаемый результат Файл доказательства
Проверка структуры контракта py -3 scripts\check_contract.py PASS: offline skeleton structure, local refs and Python syntax; application NOT tested. scripts/check_contract.py
Public smoke py -3 tests\smoke.py --base-url http://127.0.0.1:8080 В ожидаемом результате проверяются пользователи, вход, чат, сообщения, пагинация, ошибки и logout. tests/smoke.py
Basic login + Bearer auth через tests/smoke.py Доступ без токена и с неверным Authorization должен возвращать 401. server.py
Токен и TTL Установка SESSION_TTL_SECONDS=3600 Сессия создаётся и проверяется по сроку жизни. server.py

Эксперименты и отказы

Проверены базовые сценарии: создание пользователя, чтение /api/v1/users/me, аутентификация по Basic, создание чата, публикация сообщения, чтение истории, return 401 без токена и после DELETE /auth/sessions/current. Для учебной версии это соответствует уровню 3.

Воздействие Что ожидаем Что наблюдали Время восстановления / потеря данных
Нет токена 401 подтверждено Не применимо
Неверный пароль 401 подтверждено Не применимо
Logout 204, повторный запрос 401 подтверждено Не применимо
Перезапуск процесса все данные в памяти теряются ожидаемо по lab2, учебное ограничение Потеря данных по дизайну

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

Это минимальный вариант уровня 3. Для полноценного PostgreSQL, Redis/Valkey и persistence-стека нужно добавить отдельные контейнеры, миграции и volumes. В этом проекте данные сохраняются только в оперативной памяти, что соответствует учебному контракту, но не production-сценарию.