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.