Files
mtusi2026lab2/REPORT.md

3.5 KiB

Автор: Фараджев Рауф Эльман оглы Группа: БПИ2303 Целевая оценка: 3 Трек 5: не заявлен.

Что реализовано и что перенесено: Из собственной лабораторной 1 перенесены концепции HTTP-обработчиков, валидации входных данных, унифицированный формат JSON-ошибок и логика курсорной пагинации. In-memory хранилище полностью заменено на PostgreSQL. Реализовано на стеке Golang (фреймворк Gin, ORM GORM). Добавлены: хеширование паролей (bcrypt), аутентификация при создании сессии через Basic Auth, защита бизнес-эндпоинтов через Bearer-токены с абсолютным сроком действия (TTL), а также корректный отзыв сессий (logout). Запуск осуществляется через Docker Compose с использованием именованного volume для сохранения данных PostgreSQL.

Команды запуска из чистого clone: docker compose down -v docker compose up -d --build

Ожидание инициализации БД (~15 секунд)

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

Результаты проверок:

  • Smoke-тест публичного API (lab2 public API scenario) — PASS.
  • Корректная обработка ошибок валидации (400 Bad Request при некорректных limit/cursor).
  • Успешная пагинация с возвратом null для next_cursor на последней странице.
  • Сохранение данных и сессий при перезапуске контейнеров (благодаря Docker volume).

Отчёт: файл REPORT.md в корне репозитория.

Ограничения / известные особенности:

  • Реализован обязательный минимум для оценки 3.
  • Redis и кэширование не используются.
  • Стенд предназначен для локального запуска. Один экземпляр PostgreSQL без репликации.
  • Межстраничный snapshot истории (serializable isolation для пагинации) не реализован.
  • Физическое удаление истёкших сессий из БД требует периодического запуска (не реализовано в фоне).

Источники и использование ИИ: Контракт задания (OpenAPI), документация Golang, Gin, GORM, PostgreSQL и RFC 7617. ИИ-ассистент использовался для рефакторинга кода с Python на Golang, отладки процессов сборки Docker-образов (устранение проблем с кэшированием и версиями Go), а также для форматирования данного описания.

Весь обязательный минимум текущей и предыдущих работ сохранён. Контракт и публичные тесты не ослаблены. Сценарии отказов воспроизведены. Секреты находятся вне Git.