4.5 KiB
Отчёт — лабораторная 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-сценарию.